feat: snapchat support

README.md

@@ -21,6 +21,7 @@ this list is not final and keeps expanding over time. if support for a service y
 | pinterest                      | ✅            | ✅         | ✅         | ➖         | ➖              |
 | reddit                         | ✅            | ✅         | ✅         | ❌         | ❌              |
 | rutube                         | ✅            | ✅         | ✅         | ✅         | ✅              |
+| snapchat stories & spotlights  | ✅            | ✅         | ✅         | ➖         | ➖              |
 | soundcloud                     | ➖            | ✅         | ➖         | ✅         | ✅              |
 | streamable                     | ✅            | ✅         | ✅         | ➖         | ➖              |
 | tiktok                         | ✅            | ✅         | ✅         | ❌         | ❌              |
@@ -44,6 +45,7 @@ this list is not final and keeps expanding over time. if support for a service y
 | instagram  | supports photos, videos, and stories. lets you pick what to save from multi-media posts.                             |
 | pinterest  | supports videos and stories.                                                                                         |
 | reddit     | supports gifs and videos.                                                                                            |
+| snapchat   | supports spotlights and stories. lets you pick what to save from stories.                                            |
 | soundcloud | supports private links.                                                                                              |
 | tiktok     | supports videos with or without watermark, images from slideshow without watermark, and full (original) audios.      |
 | twitter/x  | lets you pick what to save from multi-media posts. may not be 100% reliable due to current management.               |

src/modules/processing/match.js

@@ -25,6 +25,7 @@ import streamable from "./services/streamable.js";
 import twitch from "./services/twitch.js";
 import rutube from "./services/rutube.js";
 import dailymotion from "./services/dailymotion.js";
+import snapchat from "./services/snapchat.js";
 
 export default async function(host, patternMatch, url, lang, obj) {
     assert(url instanceof URL);
@@ -158,6 +159,15 @@ export default async function(host, patternMatch, url, lang, obj) {
             case "dailymotion":
                 r = await dailymotion(patternMatch);
                 break;
+            case "snapchat":
+                r = await snapchat({
+                    url,
+                    username: patternMatch.username,
+                    storyId: patternMatch.storyId,
+                    spotlightId: patternMatch.spotlightId,
+                    shortLink: patternMatch.shortLink || false
+                });
+                break;
             default:
                 return apiJSON(0, { t: errorUnsupported(lang) });
         }

src/modules/processing/matchActionDecider.js

@@ -63,6 +63,7 @@ export default function(r, host, userFormat, isAudioOnly, lang, isAudioMuted, di
             switch (host) {
                 case "instagram":
                 case "twitter":
+                case "snapchat":
                     params = { picker: r.picker };
                     break;
                 case "douyin":
@@ -120,6 +121,7 @@ export default function(r, host, userFormat, isAudioOnly, lang, isAudioMuted, di
                 case "tumblr":
                 case "pinterest":
                 case "streamable":
+                case "snapchat":
                     responseType = 1;
                     break;
             }

src/modules/processing/services/snapchat.js

@@ -0,0 +1,82 @@
+import { genericUserAgent } from "../../config.js";
+
+const SPOTLIGHT_VIDEO_REGEX = /<link data-react-helmet="true" rel="preload" href="(https:\/\/cf-st\.sc-cdn\.net\/d\/[\w.?=]+&amp;uc=\d+)" as="video"\/>/;
+const NEXT_DATA_REGEX = /<script id="__NEXT_DATA__" type="application\/json">({.+})<\/script><\/body><\/html>$/;
+
+export default async function(obj) {
+    let link;
+    if (obj.url.hostname === 't.snapchat.com' && obj.shortLink) {
+        link = await fetch(`https://t.snapchat.com/${obj.shortLink}`, { redirect: "manual" }).then((r) => {
+            if (r.status === 303 && r.headers.get("location").startsWith("https://www.snapchat.com/")) {
+                return r.headers.get("location").split('?', 1)[0]
+            }
+        }).catch(() => {});
+    }
+
+    if (!link && obj.username && obj.storyId) {
+        link = `https://www.snapchat.com/add/${obj.username}/${obj.storyId}`
+    } if (!link && obj.username) {
+        link = `https://www.snapchat.com/add/${obj.username}`
+    } else if (!link && obj.spotlightId) {
+        link = `https://www.snapchat.com/spotlight/${obj.spotlightId}`
+    }
+
+    const path = new URL(link).pathname;
+
+    if (path.startsWith('/spotlight/')) {
+        const html = await fetch(link, {
+            headers: { "user-agent": genericUserAgent }
+        }).then((r) => { return r.text() }).catch(() => { return false });
+        if (!html) return { error: 'ErrorCouldntFetch' };
+
+        const id = path.split('/')[2];
+        const videoURL = html.match(SPOTLIGHT_VIDEO_REGEX)?.[1];
+        if (videoURL) return {
+            urls: videoURL,
+            filename: `snapchat_${id}.mp4`,
+            audioFilename: `snapchat_${id}_audio`
+        }
+    } else if (path.startsWith('/add/')) {
+        const html = await fetch(link, {
+            headers: { "user-agent": genericUserAgent }
+        }).then((r) => { return r.text() }).catch(() => { return false });
+        if (!html) return { error: 'ErrorCouldntFetch' };
+
+
+        const nextDataString = html.match(NEXT_DATA_REGEX)?.[1];
+        if (nextDataString) {
+            const data = JSON.parse(nextDataString);
+            const storyId = data.query.profileParams[1];
+
+            if (storyId && data.props.pageProps.story) {
+                const story = data.props.pageProps.story.snapList.find((snap) => snap.snapId.value === storyId);
+                if (story) {
+                    if (story.snapMediaType === 0)
+                        return {
+                            urls: story.snapUrls.mediaUrl,
+                            isPhoto: true
+                        }
+
+                    return {
+                        urls: story.snapUrls.mediaUrl,
+                        filename: `snapchat_${storyId}.mp4`,
+                        audioFilename: `snapchat_${storyId}_audio`
+                    }
+                }
+            }
+
+            const defaultStory = data.props.pageProps.curatedHighlights[0];
+            if (defaultStory)
+                return {
+                    picker: defaultStory.snapList.map((snap) => ({
+                        type: snap.snapMediaType === 0 ? "photo" : "video",
+                        url: snap.snapUrls.mediaUrl,
+                        thumb: snap.snapUrls.mediaPreviewUrl.value
+                    }))
+                }
+        }
+    }
+
+
+    return { error: 'ErrorCouldntFetch' };
+}

src/modules/processing/servicesConfig.json

@@ -116,6 +116,12 @@
             "alias": "dailymotion videos",
             "patterns": ["video/:id"],
             "enabled": true
+        },
+        "snapchat": {
+            "alias": "snapchat stories & spotlights",
+            "subdomains": ["t", "story"],
+            "patterns": [":shortLink", "spotlight/:spotlightId", "add/:username/:storyId", "u/:username/:storyId", "add/:username", "u/:username"],
+            "enabled": true
         }
     }
 }

src/modules/processing/servicesPatternTesters.js

@@ -25,6 +25,11 @@ export const testers = {
         (patternMatch.author?.length <= 255 && patternMatch.song?.length <= 255) 
         || patternMatch.shortLink?.length <= 32,
 
+    "snapchat": (patternMatch) =>
+        (patternMatch.username?.length <= 32 && (!patternMatch.storyId || patternMatch.storyId?.length <= 255)) 
+        || patternMatch.spotlightId?.length <= 255 
+        || patternMatch.shortLink?.length <= 16,
+
     "streamable": (patternMatch) =>
         patternMatch.id?.length === 6,
 

src/test/tests.json

@@ -1115,5 +1115,22 @@
             "code": 200,
             "status": "stream"
         }
+    }],
+    "snapchat": [{
+        "name": "spotlight",
+        "url": "https://www.snapchat.com/spotlight/W7_EDlXWTBiXAEEniNoMPwAAYdWxucG9pZmNqAY46j0a5AY46j0YbAAAAAQ",
+        "params": {},
+        "expected": {
+            "code": 200,
+            "status": "redirect"
+        }
+    }, {
+        "name": "shortlinked spotlight",
+        "url": "https://t.snapchat.com/4ZsiBLDi",
+        "params": {},
+        "expected": {
+            "code": 200,
+            "status": "redirect"
+        }
     }]
-}
+}