@vyla-entertainment/sdk 1.0.0 → 1.2.0

package/.env.example

@@ -0,0 +1 @@
+TMDB_API_KEY=your_tmdb_api_key_here

package/.github/workflows/publish.yml

@@ -0,0 +1,38 @@
+name: Publish npm package
+
+on:
+  workflow_dispatch:
+
+permissions:
+  contents: write
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          registry-url: https://registry.npmjs.org/
+
+      - name: Configure git
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "41898282+github-actions[bot]@users.noreply.github.com"
+
+      - run: npm ci
+
+      - name: Bump version
+        run: |
+          npm version minor
+          git push --follow-tags
+
+      - name: Publish
+        run: npm publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_KEY }}

package/.gitlab-ci.yml

@@ -0,0 +1,22 @@
+stages:
+  - build
+  - test
+  - deploy
+  - publish
+
+publish:
+  stage: publish
+  image: node:22
+  rules:
+    - when: manual
+  before_script:
+    - git config user.name "gitlab-ci"
+    - git config user.email "gitlab-ci@$CI_SERVER_HOST"
+    - git remote set-url origin "https://oauth2:${GITLAB_PUSH_TOKEN}@${CI_SERVER_HOST}/${CI_PROJECT_PATH}.git"
+    - git checkout "$CI_COMMIT_BRANCH"
+  script:
+    - npm ci
+    - npm version minor
+    - git push origin HEAD:"$CI_COMMIT_BRANCH" --follow-tags
+    - echo "//registry.npmjs.org/:_authToken=${NPM_KEY}" > .npmrc
+    - npm publish

package/README.md

@@ -11,34 +11,21 @@ npm install @vyla-entertainment/sdk
 pnpm install @vyla-entertainment/sdk
 ```
 
-## Usage
-Start by creating a VylaSDK element with your TMDB api key.
-```js
-import VylaSDK from "@vyla-entertainment/sdk";
-
-const sdk = new VylaSDK({
-    tmdbApiKey: ...
-});
-```
+View our full documentation at https://docs.vyla.cc/sdk
+
+# [DMCA](https://docs.vyla.cc/misc/dmca)
+
+If your source is listed here, I sincerely apologize. I understand that its inclusion may be costing you a lot of money, and that was never my intention. Please contact me as soon as possible, and I'll remove it ASAP.
+
+This is a small hobby project that I built for learning and personal interest, not for profit. I genuinely want to respect the wishes of source owners and will address any removal requests as quickly as I can.
 
-You can now use this to access Vyla's content.
-```js
-// Get sources
-// Args: excludeDisabled
-sdk.getSources(false); -> {key, timeout, label, ...}[]
+This project is developed and maintained by [Vyla Entertainment](https://github.com/vyla-entertainment) (@vyla-entertainment).
 
-// Get subtitles
-// Args: tmdb id, season?, episode?
-await sdk.getSubtitles('0000000', null, null); -> {label, file, type, source}[]
+Original work and core authorship:
 
-// Probe & test a source
-// Args: source key
-await sdk.probeSource('nebula'); -> {ok, ms}
+[@alwaysmesmerizingyou](https://gitlab.com/alwaysmesmerizingyou)
 
-// Probe & test all sources
-await sdk.probeAllSources(); -> {'key': {ok, ms}, ...}
+[@GavinGoGaming](https://github.com/GavinGoGaming)
 
-// Get HLS streams
-// Args: source key, tmdb id, season?, episode?, clientIP?
-await sdk.getStream('nebula', '0000000', null, null, null) -> {allUrls: {url, quality, label, ...}[]}
-```
+Full credits and acknowledgements:
+https://docs.vyla.cc/misc/credit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vyla-entertainment/sdk",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "scripts": {
     "test": "node test/index.js"
   },
@@ -11,13 +11,15 @@
       "email": "gavin@klash.dev"
     },
     {
-      "name": "EndOverdosing"
+      "name": "alwaysmesmerizingyou",
+      "email": "alwaysmesmerizingyou@gmail.com"
     }
   ],
   "license": "CC-BY-NC-4.0",
   "type": "module",
   "description": "Vyla's multi-provider stream scraper SDK",
   "main": "src/sdk.js",
+  "types": "src/sdk.d.ts",
   "directories": {
     "test": "test"
   },
@@ -28,4 +30,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/config.js

@@ -1,15 +1,11 @@
-export const SOURCES = [
-    {
-        key: '1embed',
-        label: '1Embed',
-        sourceFile: '1embed',
-        proxyParam: '1e',
-        timeout: 20000,
-        jitter: 500,
-        retries: 2,
-        multiUrl: true,
-    },
+// Currently active sources reported on 9:22:41 PM PST 7/30/2026
+
+// None Anime Tested: 936075
+// Anime Tested: 37854
+
+// Fshare/Fsonic Tested: 155 ( they don't have Michael )
 
+export const SOURCES = [
     {
         key: '123anime',
         label: '123Anime',
@@ -107,6 +103,18 @@ export const SOURCES = [
         },
     },
 
+    {
+        key: 'cinejoy',
+        label: 'Cinejoy',
+        sourceFile: 'cinejoy',
+        proxyParam: 'cj',
+        timeout: 30000,
+        jitter: 500,
+        retries: 1,
+        multiUrl: true,
+        skipProxy: true,
+    },
+
     {
         key: 'flaxmovies',
         label: 'FlaxMovies',
@@ -116,7 +124,7 @@ export const SOURCES = [
         jitter: 500,
         retries: 2,
         multiUrl: true,
-        disabled: true, // Temporarily disabled because their site is down, all streams are returning 403's
+        skipProxy: true,
         cdnHeaders: [{
             pattern: /flix2watch\.pro/i,
             headers: {
@@ -126,6 +134,18 @@ export const SOURCES = [
         },],
     },
 
+    {
+        key: 'frame',
+        label: 'Frame',
+        sourceFile: 'frame',
+        proxyParam: 'fr',
+        timeout: 25000,
+        jitter: 500,
+        retries: 2,
+        multiUrl: true,
+        skipProxy: true,
+    },
+
     {
         key: 'fsharetv',
         label: 'FShareTV',
@@ -142,18 +162,6 @@ export const SOURCES = [
         },
     },
 
-    {
-        key: 'goated',
-        label: 'Goated',
-        sourceFile: 'goated',
-        proxyParam: 'gt',
-        timeout: 25000,
-        jitter: 500,
-        retries: 2,
-        multiUrl: true,
-        skipProxy: true,
-    },
-
     {
         key: 'fsonic',
         label: 'Fsonic',
@@ -197,6 +205,17 @@ export const SOURCES = [
         retries: 1,
     },
 
+    {
+        key: 'lmscript',
+        label: 'LMScript',
+        sourceFile: 'lmscript',
+        proxyParam: 'lmsc',
+        timeout: 20000,
+        jitter: 500,
+        retries: 2,
+        multiUrl: true,
+    },
+
     {
         key: 'lookmovie',
         label: 'LookMovie',
@@ -234,62 +253,15 @@ export const SOURCES = [
     },
 
     {
-        key: 'nebula',
-        label: 'Nebula',
-        sourceFile: 'nebula',
-        proxyParam: 'nb',
+        key: 'peestream',
+        label: 'PeeStream',
+        sourceFile: 'peestream',
+        proxyParam: 'pee',
         timeout: 25000,
         jitter: 500,
-        retries: 1,
-        multiUrl: true,
-        skipProxy: true,
-    },
-
-    {
-        key: 'nekowatch-sub',
-        sourceFile: 'nekowatch',
-        label: 'NekoWatch (Sub)',
-        proxyParam: 'nwsub',
-        timeout: 30000,
-        jitter: 500,
-        retries: 2
-    },
-
-    {
-        key: 'nekowatch-dub',
-        sourceFile: 'nekowatch',
-        label: 'NekoWatch (Dub)',
-        proxyParam: 'nwdub',
-        timeout: 30000,
-        jitter: 500,
-        retries: 2
-    },
-
-    {
-        key: 'opstream',
-        label: 'OpStream',
-        sourceFile: 'opstream',
-        proxyParam: 'op',
-        timeout: 35000,
-        jitter: 500,
         retries: 2,
         multiUrl: true,
         skipProxy: true,
-        verifyHeaders: {
-            Referer: 'https://opstream.fun/',
-            Origin: 'https://opstream.fun',
-        },
-    },
-
-    {
-        key: 'peachify',
-        label: 'Peachify',
-        sourceFile: 'peachify',
-        proxyParam: 'pf',
-        timeout: 30000,
-        jitter: 500,
-        retries: 1,
-        multiUrl: true
     },
 
     {
@@ -313,6 +285,7 @@ export const SOURCES = [
         timeout: 20000,
         jitter: 500,
         retries: 2,
+        skipProxy: true
     },
 
     {
@@ -421,7 +394,8 @@ export const SOURCES = [
         jitter: 500,
         retries: 2,
         multiUrl: true,
-        skipProxy: true
+        skipProxy: true,
+        disabled: true, // Temporarily disabled because their site is down, embed website does not load
     },
 
     {
@@ -466,6 +440,17 @@ export const SOURCES = [
         multiUrl: true
     },
 
+    {
+        key: 'vidvault',
+        label: 'VidVault',
+        sourceFile: 'vidvault',
+        proxyParam: 'vv',
+        timeout: 25000,
+        jitter: 500,
+        retries: 2,
+        multiUrl: true,
+    },
+
     {
         key: 'vidzee',
         label: 'VidZee',
@@ -475,13 +460,13 @@ export const SOURCES = [
         sourcesTimeout: 10000,
         jitter: 400,
         retries: 3,
-        disabled: true, // Temporarily disabled because their site is down, all streams are returning 403's
         verifyHeaders: {
             Accept: '/',
             'Accept-Language': 'en-US,en;q=0.9',
             Referer: 'https://player.vidzee.wtf',
             Origin: 'https://player.vidzee.wtf',
         },
+        disabled: true // Disabled temporarily due to decryption issues
     },
 
     {
@@ -512,6 +497,7 @@ export const SOURCES = [
         retries: 2,
         skipProxy: true,
     },
+
 ];
 
 export const HEALTH_PROBE_ID = '155';

package/src/downloads/downloads.js

@@ -1,8 +1,12 @@
 import { getDownloads, getDownloadsTv } from "./sources/trendimovies.js";
 
 export async function fetchDownloads(id, s = null, e = null) {
-    const res = s != null && e != null
-        ? await getDownloadsTv(id, s, e)
-        : await getDownloads(id);
-    return res;
+    try {
+        const res = s != null && e != null
+            ? await getDownloadsTv(id, s, e)
+            : await getDownloads(id);
+        return res || [];
+    } catch {
+        return [];
+    }
 }

package/src/sdk.d.ts

@@ -0,0 +1,123 @@
+export interface SourceConfig {
+    key: string;
+    label: string;
+    sourceFile: string;
+    proxyParam: string;
+    timeout: number;
+    jitter: number;
+    retries: number;
+    multiUrl: boolean;
+    skipProxy?: boolean;
+    cdnHeaders?: {
+        pattern: RegExp;
+        headers: {
+            Referer: string;
+            Origin: string;
+        };
+    }[];
+    skipVerify?: boolean;
+    verifyHeaders?: boolean;
+    disabled?: boolean;
+    sourcesTimeout?: number;
+}
+export interface ProbeResult {
+    ok: boolean;
+    ms: number | null;
+}
+export interface StreamResult {
+    url: string;
+    headers: {
+        "User-Agent": string;
+        Referer: string;
+        Origin: string;
+        [key: string]: string;
+    };
+    server: string;
+    quality: string;
+    type: "mp4" | "hls";
+    skipVerify?: boolean;
+    skipProxy?: boolean;
+}
+
+export interface DownloadResult {
+    url: string;
+    quality: string;
+    size: number | null;
+    type: "mkv";
+    active: boolean;
+}
+export interface SubtitleResult {
+    label: string;
+    file: string;
+    type: "vtt" | "srt";
+    source: string;
+}
+
+export type ProbeAllResult = Record<string, ProbeResult>;
+
+export interface VylaSDKOptions {
+    tmdbApiKey?: string;
+}
+
+// Descriptions written with Claude.
+export default class VylaSDK {
+    tmdbApiKey?: string;
+
+    constructor(options?: VylaSDKOptions);
+
+    /**
+     * Get the list of configured sources.
+     * @param excludeDisabled If true, filters out disabled sources.
+     */
+    getSources(excludeDisabled?: boolean): SourceConfig[];
+
+    /**
+     * Probe all active (non-disabled) sources for availability.
+     */
+    probeAllSources(): Promise<ProbeAllResult>;
+
+    /**
+     * Probe a single source by key.
+     */
+    probeSource(key: string): Promise<ProbeResult>;
+
+    /**
+     * Get a playable stream for a given source/media id.
+     * @param key Source key
+     * @param id Media id (e.g. TMDB id)
+     * @param s Season number (for TV), or null for movies
+     * @param e Episode number (for TV), or null for movies
+     * @param clientIP Optional client IP for source-specific logic
+     */
+    getStream(
+        key: string,
+        id: string | number,
+        s?: number | null,
+        e?: number | null,
+        clientIP?: string | null
+    ): Promise<StreamResult | { allUrls: StreamResult[] }>;
+
+    /**
+     * Get subtitles for a movie or TV episode.
+     * @param id Media id
+     * @param s Season number (for TV), or null for movies
+     * @param e Episode number (for TV), or null for movies
+     */
+    getSubtitles(
+        id: string | number,
+        s?: number | null,
+        e?: number | null
+    ): Promise<SubtitleResult[]>;
+
+    /**
+     * Get download links for a movie or TV episode.
+     * @param id Media id
+     * @param s Season number (for TV), or null for movies
+     * @param e Episode number (for TV), or null for movies
+     */
+    getDownloads(
+        id: string | number,
+        s?: number | null,
+        e?: number | null
+    ): Promise<DownloadResult[]>;
+}

package/src/sources/anihq.js

@@ -2,15 +2,27 @@ import { getTmdbInfo, USER_AGENT } from '../utils/helpers.js';
 
 async function extractVoe(voeUrl) {
     try {
-        const res = await fetch(voeUrl, {
+        let res = await fetch(voeUrl, {
             headers: {
                 'User-Agent': USER_AGENT,
                 'Referer': 'https://anihq.cc/'
             }
         });
 
+        let html = await res.text();
+
+        const redirectMatch = html.match(/window\.location\.href\s*=\s*['"](https?:\/\/[^'"]+)['"]/);
+        if (redirectMatch) {
+            res = await fetch(redirectMatch[1], {
+                headers: {
+                    'User-Agent': USER_AGENT,
+                    'Referer': 'https://anihq.cc/'
+                }
+            });
+            html = await res.text();
+        }
+
         const mirrorUrl = res.url;
-        const html = await res.text();
 
         const scriptMatch = html.match(/<script type="application\/json">\["(.*?)"\]<\/script>/);
         if (!scriptMatch) return null;