skystream-cli 1.1.0 → 1.2.4

package/README.md

@@ -1,6 +1,6 @@
 # SkyStream CLI
 
-The official command-line toolkit for building, testing, and managing SkyStream (Gen 2) plugin repositories.
+The official command-line toolkit for deploying, testing, and managing SkyStream (Gen 2) plugin repositories.
 
 ## 🚀 Quick Start
 
@@ -23,21 +23,79 @@ cd my-universe
 skystream add "New Provider"
 ```
 
-### Build for Distribution
+### Deploy for Distribution
 
 ```bash
-skystream build -u https://my-cdn.com/repo
+skystream deploy -u https://my-cdn.com/repo
 ```
 
 ## 🛠 Commands
 
-| Command | Description |
-| --- | --- |
-| `init` | Initialize a Sky Gen 2 Repository project |
-| `add` | Add a new plugin to the repository |
-| `validate` | Validate all plugins in the repo |
-| `test` | Test a specific plugin in a mock runtime |
-| `build` | Bundle plugins and generate `repo.json` |
+### `init`
+Initialize a new Sky Gen 2 Repository project.
+
+**Usage:**
+```bash
+skystream init <project-name> --package-name <id> --plugin-name <name> [options]
+```
+
+**Options:**
+- `-p, --package-name <id>`: **(Required)** Unique Repository ID (e.g., `com.dev.stars`).
+- `-n, --plugin-name <name>`: **(Required)** First plugin name (e.g., `YTS`).
+- `-d, --description <desc>`: Repository description (Default: `SkyStream plugins repository`).
+- `-a, --author <author>`: Author name (Default: `Developer`).
+
+---
+
+### `add`
+Add a new Sky Gen 2 plugin to an existing repository.
+
+**Usage:**
+```bash
+skystream add <plugin-name> [options]
+```
+
+**Options:**
+- `-d, --description <desc>`: Plugin description.
+- `-a, --author <author>`: Author name.
+
+---
+
+### `validate`
+Validate all plugins in the repository (manifests and logic exports).
+
+**Usage:**
+```bash
+skystream validate
+```
+
+---
+
+### `test`
+Test a specific plugin in a mock runtime.
+
+**Usage:**
+```bash
+skystream test [options]
+```
+
+**Options:**
+- `-p, --path <path>`: Path to plugin folder (Default: `.`).
+- `-f, --function <name>`: Function to test (Default: `getHome`).
+- `-q, --query <query>`: Query string for functions like `search`.
+
+---
+
+### `deploy`
+Bundle all plugins and generate the `repo.json` index.
+
+**Usage:**
+```bash
+skystream deploy --url <url>
+```
+
+**Options:**
+- `-u, --url <url>`: **(Required)** Base hosting URL where the `.sky` files will be served (e.g., `https://raw.githubusercontent.com/USER/REPO/main`).
 
 ## 📖 Learn More
 Visit the [SkyStream Repository Specification](https://github.com/akashdh11/skystream) for more details.

package/dist/index.js

@@ -9,21 +9,21 @@ const program = new Command();
 program
     .name('skystream')
     .description('SkyStream Plugin Development Kit CLI (Sky Gen 2)')
-    .version('1.2.1');
+    .version('1.2.4');
 // Schemas
 const pluginSchema = z.object({
-    id: z.string().min(5).regex(/^[a-z0-9._-]+$/),
+    packageName: z.string().min(5).regex(/^[a-z0-9._-]+$/),
     name: z.string().min(1),
-    internalName: z.string().min(1).regex(/^[A-Z0-9]+$/),
     version: z.number().int().positive(),
     description: z.string().min(1),
+    baseUrl: z.string().url(),
     authors: z.array(z.string()).min(1),
     languages: z.array(z.string()).min(1),
     categories: z.array(z.string()).min(1),
 });
 const repoSchema = z.object({
     name: z.string().min(1),
-    id: z.string().min(3).regex(/^[a-z0-9._-]+$/),
+    packageName: z.string().min(3).regex(/^[a-z0-9._-]+$/),
     description: z.string().min(1),
     manifestVersion: z.number().int().positive(),
     pluginLists: z.array(z.string().url()),
@@ -55,12 +55,12 @@ const JS_TEMPLATE = `(function() {
                     "Trending": [
                         new MultimediaItem({ 
                             title: "Example Movie", 
-                            url: "https://site.com/movie", 
-                            posterUrl: "https://site.com/poster.jpg", 
+                            url: \`\${manifest.baseUrl}/movie\`, 
+                            posterUrl: \`\${manifest.baseUrl}/poster.jpg\`, 
                             type: "movie", // Valid types: movie, series, anime, livestream
-                            bannerUrl: "https://site.com/banner.jpg", // (optional)
+                            bannerUrl: \`\${manifest.baseUrl}/banner.jpg\`, // (optional)
                             description: "Plot summary here...", // (optional)
-                            headers: { "Referer": "https://site.com" } // (optional)
+                            headers: { "Referer": \`\${manifest.baseUrl}\` } // (optional)
                         })
                     ] 
                 } 
@@ -81,15 +81,15 @@ const JS_TEMPLATE = `(function() {
             cb({ 
                 success: true, 
                 data: [
-                    new MultimediaItem({ 
-                        title: "Example Movie", 
-                        url: "https://site.com/movie", 
-                        posterUrl: "https://site.com/poster.jpg", 
-                        type: "movie", // Valid types: movie, series, anime, livestream
-                        bannerUrl: "https://site.com/banner.jpg", // (optional)
-                        description: "Plot summary here...", // (optional)
-                        headers: { "Referer": "https://site.com" } // (optional)
-                    })
+                        new MultimediaItem({ 
+                            title: "Example Movie", 
+                            url: \`\${manifest.baseUrl}/movie\`, 
+                            posterUrl: \`\${manifest.baseUrl}/poster.jpg\`, 
+                            type: "movie", // Valid types: movie, series, anime, livestream
+                            bannerUrl: \`\${manifest.baseUrl}/banner.jpg\`, // (optional)
+                            description: "Plot summary here...", // (optional)
+                            headers: { "Referer": \`\${manifest.baseUrl}\` } // (optional)
+                        })
                 ] 
             });
         } catch (e) {
@@ -110,20 +110,20 @@ const JS_TEMPLATE = `(function() {
                 data: new MultimediaItem({
                     title: "Example Movie Full Details",
                     url: url,
-                    posterUrl: "https://site.com/poster.jpg",
+                    posterUrl: \`\${manifest.baseUrl}/poster.jpg\`,
                     type: "movie", // Valid types: movie, series, anime, livestream
-                    bannerUrl: "https://site.com/banner.jpg", // (optional)
+                    bannerUrl: \`\${manifest.baseUrl}/banner.jpg\`, // (optional)
                     description: "This is a detailed description of the movie.", // (optional)
-                    headers: { "Referer": "https://site.com" }, // (optional)
+                    headers: { "Referer": \`\${manifest.baseUrl}\` }, // (optional)
                     episodes: [
                         new Episode({ 
                             name: "Episode 1", 
-                            url: "https://site.com/watch/1", 
+                            url: \`\${manifest.baseUrl}/watch/1\`, 
                             season: 1, // (optional)
                             episode: 1, // (optional)
                             description: "Episode summary...", // (optional)
-                            posterUrl: "https://site.com/ep-poster.jpg", // (optional)
-                            headers: { "Referer": "https://site.com" } // (optional)
+                            posterUrl: \`\${manifest.baseUrl}/ep-poster.jpg\`, // (optional)
+                            headers: { "Referer": \`\${manifest.baseUrl}\` } // (optional)
                         })
                     ]
                 })
@@ -147,9 +147,9 @@ const JS_TEMPLATE = `(function() {
                     new StreamResult({ 
                         url: "https://test-streams.mux.dev/x36xhzz/x36xhzz.m3u8", 
                         quality: "1080p", // (optional)
-                        headers: { "Referer": "https://site.com" }, // (optional)
+                        headers: { "Referer": \`\${manifest.baseUrl}\` }, // (optional)
                         subtitles: [
-                            { url: "https://site.com/sub.vtt", label: "English", lang: "en" } // (optional)
+                            { url: \`\${manifest.baseUrl}/sub.vtt\`, label: "English", lang: "en" } // (optional)
                         ],
                         drmKid: "kid_value", // (optional)
                         drmKey: "key_value", // (optional)
@@ -228,21 +228,21 @@ jobs:
         with:
           node-version: '20'
 
-      - name: Build Repository
+      - name: Deploy Repository
         run: |
           npm install -g skystream-cli
-          skystream build -u https://raw.githubusercontent.com/\${{ github.repository }}
+          skystream deploy -u https://raw.githubusercontent.com/\${{ github.repository }}/main
 
       - name: Commit and Push changes
         run: |
           git config --global user.name "github-actions[bot]"
           git config --global user.email "github-actions[bot]@users.noreply.github.com"
           git add .
-          git commit -m "chore: automated build [skip ci]" || echo "No changes to commit"
+          git commit -m "chore: automated deploy [skip ci]" || echo "No changes to commit"
           git push
 `;
 async function updatePluginsJson(rootDir) {
-    // Logic removed: build command now handles dynamic generation in dist/
+    // Logic removed: deploy command now handles dynamic generation in dist/
 }
 program.command('init')
     .description('Initialize a Sky Gen 2 Repository project')
@@ -262,11 +262,11 @@ program.command('init')
     const projectSlug = projectName.toLowerCase().replace(/\s+/g, '-').replace(/[^a-z0-9-]/g, '');
     const repo = {
         name: projectName,
-        id: options.packageName,
+        packageName: options.packageName,
         description: options.description,
         manifestVersion: 1,
         pluginLists: [
-            `REPLACE_WITH_BASE_URL/plugins.json` // Placeholder for user to update
+            `https://raw.githubusercontent.com/USER_NAME/REPO_NAME/main/dist/plugins.json`
         ]
     };
     await fs.writeJson(path.join(rootDir, 'repo.json'), repo, { spaces: 2 });
@@ -282,10 +282,10 @@ program.command('init')
     const pluginDir = path.join(rootDir, pluginSlug);
     await fs.ensureDir(pluginDir);
     const pluginManifest = {
-        id: `${packageName}.${pluginSlug}`,
+        packageName: `${packageName}.${pluginSlug}`,
         name: pluginName,
-        internalName: pluginName.toUpperCase().replace(/\s+/g, ''),
         version: 1,
+        baseUrl: "https://example.com",
         description: `${pluginName} plugin (Sky Gen 2)`,
         authors: [options.author],
         languages: ["en"],
@@ -295,7 +295,7 @@ program.command('init')
     await fs.writeFile(path.join(pluginDir, 'plugin.js'), JS_TEMPLATE);
     console.log('\nSky Gen 2 Repository successfully initialized!');
     console.log(`Project Directory: ${rootDir}`);
-    console.log(`First Plugin ID: ${pluginManifest.id}`);
+    console.log(`First Plugin Package Name: ${pluginManifest.packageName}`);
 });
 program.command('add')
     .description('Add a new Sky Gen 2 plugin to the repository')
@@ -317,12 +317,12 @@ program.command('add')
         process.exit(1);
     }
     // Guess package-name from repo id
-    const packageName = repo.id;
+    const packageName = repo.packageName;
     const pluginManifest = {
-        id: `${packageName}.${pluginSlug}`,
+        packageName: `${packageName}.${pluginSlug}`,
         name: pluginName,
-        internalName: pluginName.toUpperCase().replace(/\s+/g, ''),
         version: 1,
+        baseUrl: "https://example.com",
         description: options.description || `${pluginName} plugin for ${repo.name}`,
         authors: [options.author || repo.author || "Developer"],
         languages: ["en"],
@@ -331,7 +331,7 @@ program.command('add')
     await fs.ensureDir(pluginDir);
     await fs.writeJson(path.join(pluginDir, 'plugin.json'), pluginManifest, { spaces: 2 });
     await fs.writeFile(path.join(pluginDir, 'plugin.js'), JS_TEMPLATE);
-    console.log(`✓ Added Plugin: ${pluginName} (ID: ${pluginManifest.id})`);
+    console.log(`✓ Added Plugin: ${pluginName} (Package: ${pluginManifest.packageName})`);
 });
 program.command('validate')
     .description('Validate all plugins in the repo')
@@ -346,13 +346,13 @@ program.command('validate')
             try {
                 const manifest = await fs.readJson(manifestPath);
                 pluginSchema.parse(manifest);
-                console.log(`✓ ${manifest.id}: Manifest OK`);
+                console.log(`✓ ${manifest.packageName}: Manifest OK`);
                 const js = await fs.readFile(path.join(itemPath, 'plugin.js'), 'utf8');
                 if (js.includes('globalThis.getHome = getHome')) {
-                    console.log(`✓ ${manifest.id}: Logic OK`);
+                    console.log(`✓ ${manifest.packageName}: Logic OK`);
                 }
                 else {
-                    console.warn(`! ${manifest.id}: Missing exports`);
+                    console.warn(`! ${manifest.packageName}: Missing exports`);
                 }
                 count++;
             }
@@ -377,7 +377,7 @@ program.command('test')
     const jsPath = path.join(pluginDir, 'plugin.js');
     const manifest = await fs.readJson(manifestPath);
     const jsContent = await fs.readFile(jsPath, 'utf8');
-    console.log(`\n--- Testing ${manifest.id} -> ${options.function} ---`);
+    console.log(`\n--- Testing ${manifest.packageName} -> ${options.function} ---`);
     const context = {
         manifest,
         console: { log: (...args) => console.log('  [JS]:', ...args), error: (...args) => console.error('  [JS ERR]:', ...args) },
@@ -416,8 +416,8 @@ program.command('test')
     else
         await fn(options.query, callback);
 });
-program.command('build')
-    .description('Build all plugins and repository index')
+program.command('deploy')
+    .description('Deploy all plugins and repository index')
     .requiredOption('-u, --url <url>', 'Base hosting URL for .sky files')
     .action(async (options) => {
     const rootDir = process.cwd();
@@ -438,7 +438,8 @@ program.command('build')
         const mPath = path.join(itemPath, 'plugin.json');
         if (await fs.pathExists(mPath) && (await fs.stat(itemPath)).isDirectory()) {
             const manifest = await fs.readJson(mPath);
-            const bundleName = `${manifest.id}.sky`;
+            const packageName = manifest.packageName || manifest.id || item;
+            const bundleName = `${packageName}.sky`;
             const outPath = path.join(distDir, bundleName);
             const arch = archiver('zip', { zlib: { level: 9 } });
             arch.pipe(fs.createWriteStream(outPath));
@@ -446,12 +447,11 @@ program.command('build')
             arch.file(path.join(itemPath, 'plugin.js'), { name: 'plugin.js' });
             await arch.finalize();
             catalog.push({ ...manifest, url: `${distUrl}/${bundleName}` });
-            console.log(`✓ Bundled ${manifest.id}`);
+            console.log(`✓ Bundled ${manifest.packageName}`);
         }
     }
     const finalRepo = {
         ...repo,
-        updatedAt: new Date().toISOString(),
         pluginLists: [`${distUrl}/plugins.json`]
     };
     await fs.writeJson(repoPath, finalRepo, { spaces: 2 });
@@ -468,7 +468,7 @@ program.command('build')
             console.log(`✓ Updated README.md with live URL`);
         }
     }
-    console.log(`\nBuild Complete. Assets generated in dist/`);
+    console.log(`\nDeployment Complete. Assets generated in dist/`);
     console.log(`\nYour Repo Link for the app:`);
     console.log(`> ${baseRaw}/repo.json`);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skystream-cli",
-  "version": "1.1.0",
+  "version": "1.2.4",
   "type": "module",
   "description": "SkyStream Plugin Development Kit & Repository Manager",
   "main": "dist/index.js",