@streamfox/create-streamfox-plugin 0.3.0

package/dist/index.cjs

@@ -0,0 +1,459 @@
+#!/usr/bin/env node
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CAPABILITIES: () => CAPABILITIES,
+  DEFAULT_PRESET: () => DEFAULT_PRESET,
+  DEFAULT_SDK_VERSION: () => DEFAULT_SDK_VERSION,
+  scaffoldProject: () => scaffoldProject
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/scaffold.ts
+var import_promises = require("fs/promises");
+var import_node_path = __toESM(require("path"), 1);
+var CAPABILITIES = [
+  "catalog",
+  "meta",
+  "stream",
+  "subtitles",
+  "plugin_catalog"
+];
+var DEFAULT_PRESET = "meta";
+var DEFAULT_SDK_VERSION = "^0.2.0";
+function sortedCapabilities(values) {
+  const unique = Array.from(new Set(values));
+  return CAPABILITIES.filter((capability) => unique.includes(capability));
+}
+async function ensureTargetDoesNotExist(targetDir) {
+  try {
+    await (0, import_promises.access)(targetDir);
+    throw new Error(`Target directory already exists: ${targetDir}`);
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return;
+    }
+    throw error;
+  }
+}
+function makePackageJson(name, language, sdkVersion) {
+  const scripts = language === "ts" ? {
+    dev: "tsx watch src/server.ts",
+    build: "tsc -p tsconfig.json",
+    format: "prettier --write .",
+    "format:check": "prettier --check .",
+    start: "node dist/server.js",
+    test: "vitest run",
+    typecheck: "tsc --noEmit"
+  } : {
+    dev: "node --watch src/server.js",
+    build: 'echo "No build step for JavaScript template"',
+    format: "prettier --write .",
+    "format:check": "prettier --check .",
+    start: "node src/server.js",
+    test: "vitest run"
+  };
+  const normalizedScripts = {
+    ...scripts,
+    check: language === "ts" ? "npm run format:check && npm run typecheck && npm test && npm run build" : "npm run format:check && npm test && npm run build"
+  };
+  const packageJson = {
+    name,
+    version: "0.1.0",
+    private: true,
+    type: "module",
+    scripts: normalizedScripts,
+    dependencies: {
+      "@streamfox/plugin-sdk": sdkVersion
+    },
+    devDependencies: language === "ts" ? {
+      "@types/node": "^24.6.0",
+      prettier: "^3.6.2",
+      tsx: "^4.20.5",
+      typescript: "^5.9.2",
+      vitest: "^2.1.9"
+    } : {
+      prettier: "^3.6.2",
+      vitest: "^2.1.9"
+    }
+  };
+  return `${JSON.stringify(packageJson, null, 2)}
+`;
+}
+function resourceBlock(capability, advanced) {
+  switch (capability) {
+    case "catalog":
+      return `catalog: {
+      endpoints: [
+        {
+          id: "top",
+          name: "Top",
+          mediaTypes: ["movie"],
+          filters: [{ key: "genre", valueType: "string" }],
+        },
+      ],
+      handler: async () => ({
+        items: [],
+      }),
+    },`;
+    case "meta":
+      return `meta: {
+      mediaTypes: ["movie"],
+      includes: ["videos", "links"],
+      handler: async () => ({
+        item: ${advanced ? `{
+          summary: {
+            id: { namespace: "imdb", value: "tt1254207" },
+            mediaType: "movie",
+            title: "Big Buck Bunny",
+            links: [],
+          },
+          defaultVideoID: "main",
+          trailers: [{ transport: { kind: "youtube", id: "aqz-KE-bpKQ" } }],
+          videos: [
+            {
+              id: "main",
+              title: "Main",
+              streams: [{ transport: { kind: "http", url: "https://example.com/video.mp4" } }],
+            },
+          ],
+        }` : "null"},
+      }),
+    },`;
+    case "stream":
+      return `stream: {
+      mediaTypes: ["movie"],
+      supportedTransports: ${advanced ? `["http", "torrent", "usenet", "archive", "youtube"]` : `["http"]`},
+      handler: async () => ({
+        streams: [
+          {
+            transport: { kind: "http", url: "https://example.com/video.mp4", mode: "stream" },
+            hints: {
+              notWebReady: true,
+              proxyHeaders: { request: { "User-Agent": "StreamFox" } },
+            },
+          },
+${advanced ? `          {
+            transport: { kind: "torrent", infoHash: "abcdef", peerDiscovery: ["tracker:udp://tracker.example.com:80"] },
+            selection: { fileIndex: 0 },
+          },
+          {
+            transport: { kind: "usenet", nzbURL: "https://example.com/file.nzb", servers: ["nntps://user:pass@news.example.com:563/4"] },
+          },
+          {
+            transport: {
+              kind: "archive",
+              format: "zip",
+              files: [{ url: "https://example.com/archive.zip", bytes: 1024 }],
+            },
+            selection: { fileMustInclude: "movie.mkv" },
+          },
+` : ""}        ],
+      }),
+    },`;
+    case "subtitles":
+      return `subtitles: {
+      mediaTypes: ["movie", "episode"],
+      defaultLanguages: ["en"],
+      handler: async (request, { settings }) => {
+        const configuredLanguages = Array.isArray(settings.languages)
+          ? settings.languages
+          : [];
+        const languagePreferences =
+          configuredLanguages.length > 0 ? configuredLanguages : (request.languagePreferences ?? []);
+
+        void languagePreferences;
+        void settings.includeHI;
+
+        return {
+          subtitles: [],
+        };
+      },
+    },`;
+    case "plugin_catalog":
+      return `pluginCatalog: {
+      endpoints: [
+        {
+          id: "featured",
+          name: "Featured",
+          pluginKinds: ["catalog", "meta", "stream", "subtitles"],
+          tags: ["official"],
+        },
+      ],
+      handler: async () => ({
+        plugins: [
+          {
+            id: "com.example.recommended",
+            name: "Recommended",
+            version: "1.0.0",
+            pluginKinds: ["catalog", "meta"],
+            distribution: {
+              transport: "https",
+              manifestURL: "https://plugins.example.com/recommended/manifest",
+            },
+            manifestSnapshot: {
+              plugin: { id: "com.example.recommended" },
+            },
+          },
+        ],
+      }),
+    },`;
+    default:
+      return "";
+  }
+}
+function makeInstallBlock(preset) {
+  if (preset !== "subtitles") {
+    return "";
+  }
+  return `  install: {
+    configurationRequired: true,
+    title: "Subtitle Settings",
+    description: "Configure subtitle defaults before installing this plugin.",
+    fields: [
+      settings.multiSelect("languages", {
+        label: "Languages",
+        options: [
+          { label: "English", value: "en" },
+          { label: "Greek", value: "el" },
+          { label: "Spanish", value: "es" },
+        ],
+        defaultValue: ["en"],
+      }),
+      settings.checkbox("includeHI", {
+        label: "Include hearing impaired",
+        defaultValue: true,
+      }),
+    ],
+  },
+`;
+}
+function makePluginFile(name, preset, capabilities, advanced) {
+  const resources = capabilities.map((capability) => resourceBlock(capability, advanced)).join("\n    ");
+  const install = makeInstallBlock(preset);
+  const importSpec = install.length > 0 ? "definePlugin, settings" : "definePlugin";
+  const installBlock = install.length > 0 ? `${install}` : "";
+  return `import { ${importSpec} } from "@streamfox/plugin-sdk";
+
+export const plugin = definePlugin({
+  plugin: {
+    id: "com.example.${name}",
+    name: "${name}",
+    version: "0.1.0",
+    description: "Generated StreamFox plugin scaffold",
+  },
+${installBlock}  resources: {
+    ${resources}
+  },
+});
+`;
+}
+function makeServerFile(language) {
+  const pluginImport = language === "ts" ? "./plugin" : "./plugin.js";
+  return `import { serve } from "@streamfox/plugin-sdk";
+import { plugin } from "${pluginImport}";
+
+const { url, installURL, launchURL } = await serve(plugin, {
+  port: Number(process.env.PORT ?? 7000),
+  integration: {
+    installScheme: "streamfox",
+    launchBaseURL: "https://streamfox.app/#",
+    autoOpen: "none",
+  },
+});
+
+console.log("Plugin manifest:", url);
+console.log("Plugin installer deeplink:", installURL);
+console.log("Plugin launch URL:", launchURL);
+`;
+}
+function makeVitestFile(language) {
+  const pluginImport = language === "ts" ? "../src/plugin" : "../src/plugin.js";
+  return `import { describe, expect, it } from "vitest";
+import { createServer } from "@streamfox/plugin-sdk";
+import { plugin } from "${pluginImport}";
+
+describe("scaffold smoke", () => {
+  it("serves manifest and studio config", async () => {
+    const app = createServer(plugin, { frontend: false });
+
+    const manifestResponse = await app.request("/manifest");
+    expect(manifestResponse.status).toBe(200);
+
+    const studioResponse = await app.request("/studio-config");
+    expect(studioResponse.status).toBe(200);
+  });
+});
+`;
+}
+var tsConfig = `{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "declaration": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "types": ["node"]
+  },
+  "include": ["src"]
+}
+`;
+var prettierConfig = `{
+  "semi": true,
+  "singleQuote": false,
+  "trailingComma": "all"
+}
+`;
+var prettierIgnore = `dist
+node_modules
+.DS_Store
+`;
+function makeReadme(projectName, preset, capabilities, advanced) {
+  const capabilitiesList = capabilities.map((capability) => `- ${capability}`).join("\n");
+  const endpointForCapability = (capability) => {
+    switch (capability) {
+      case "catalog":
+        return "/catalog/:mediaType/:catalogID";
+      case "meta":
+        return "/meta/:mediaType/:itemID";
+      case "stream":
+        return "/stream/:mediaType/:itemID";
+      case "subtitles":
+        return "/subtitles/:mediaType/:itemID";
+      case "plugin_catalog":
+        return "/plugin_catalog/:catalogID/:pluginKind";
+      default:
+        return `/${capability}`;
+    }
+  };
+  const endpointLines = [
+    "- GET /manifest",
+    "- GET /studio-config",
+    ...capabilities.map(
+      (capability) => `- GET ${endpointForCapability(capability)}`
+    )
+  ].join("\n");
+  return `# ${projectName}
+
+Generated with create-streamfox-plugin.
+
+Preset: \`${preset}\`
+Advanced template: \`${advanced ? "enabled" : "disabled"}\`
+
+## Scripts
+
+- npm run dev
+- npm run build
+- npm run format
+- npm run start
+- npm run test
+
+## Implemented Capabilities
+
+${capabilitiesList}
+
+## Stream Model
+
+- Unified transport model via \`stream.transport\`
+- Capability declaration via \`resources.stream.supportedTransports\`
+- Optional selection controls via \`stream.selection\`
+
+## Endpoints
+
+${endpointLines}
+`;
+}
+async function scaffoldProject(options) {
+  const capabilities = sortedCapabilities([
+    options.preset,
+    ...options.extraCapabilities ?? []
+  ]);
+  const sdkVersion = (options.sdkVersion ?? DEFAULT_SDK_VERSION).trim() || DEFAULT_SDK_VERSION;
+  const advanced = options.advanced ?? false;
+  await ensureTargetDoesNotExist(options.targetDir);
+  const srcDir = import_node_path.default.join(options.targetDir, "src");
+  const testDir = import_node_path.default.join(options.targetDir, "test");
+  await (0, import_promises.mkdir)(srcDir, { recursive: true });
+  await (0, import_promises.mkdir)(testDir, { recursive: true });
+  await (0, import_promises.writeFile)(
+    import_node_path.default.join(options.targetDir, "package.json"),
+    makePackageJson(options.projectName, options.language, sdkVersion)
+  );
+  await (0, import_promises.writeFile)(
+    import_node_path.default.join(options.targetDir, ".prettierrc.json"),
+    prettierConfig
+  );
+  await (0, import_promises.writeFile)(
+    import_node_path.default.join(options.targetDir, ".prettierignore"),
+    prettierIgnore
+  );
+  await (0, import_promises.writeFile)(
+    import_node_path.default.join(options.targetDir, "README.md"),
+    makeReadme(options.projectName, options.preset, capabilities, advanced)
+  );
+  if (options.language === "ts") {
+    await (0, import_promises.writeFile)(import_node_path.default.join(options.targetDir, "tsconfig.json"), tsConfig);
+    await (0, import_promises.writeFile)(
+      import_node_path.default.join(srcDir, "plugin.ts"),
+      makePluginFile(
+        options.projectName,
+        options.preset,
+        capabilities,
+        advanced
+      )
+    );
+    await (0, import_promises.writeFile)(import_node_path.default.join(srcDir, "server.ts"), makeServerFile("ts"));
+    await (0, import_promises.writeFile)(import_node_path.default.join(testDir, "plugin.test.ts"), makeVitestFile("ts"));
+  } else {
+    await (0, import_promises.writeFile)(
+      import_node_path.default.join(srcDir, "plugin.js"),
+      makePluginFile(
+        options.projectName,
+        options.preset,
+        capabilities,
+        advanced
+      )
+    );
+    await (0, import_promises.writeFile)(import_node_path.default.join(srcDir, "server.js"), makeServerFile("js"));
+    await (0, import_promises.writeFile)(import_node_path.default.join(testDir, "plugin.test.js"), makeVitestFile("js"));
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CAPABILITIES,
+  DEFAULT_PRESET,
+  DEFAULT_SDK_VERSION,
+  scaffoldProject
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/scaffold.ts"],"sourcesContent":["export * from \"./scaffold\";\n","import { access, mkdir, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport const CAPABILITIES = [\n  \"catalog\",\n  \"meta\",\n  \"stream\",\n  \"subtitles\",\n  \"plugin_catalog\",\n] as const;\nexport type Capability = (typeof CAPABILITIES)[number];\nexport type Preset = Capability;\nexport type Language = \"ts\" | \"js\";\nexport const DEFAULT_PRESET: Preset = \"meta\";\nexport const DEFAULT_SDK_VERSION = \"^0.2.0\";\n\nexport interface ScaffoldOptions {\n  targetDir: string;\n  projectName: string;\n  language: Language;\n  preset: Preset;\n  advanced?: boolean;\n  extraCapabilities?: Capability[];\n  sdkVersion?: string;\n}\n\nfunction sortedCapabilities(values: Capability[]): Capability[] {\n  const unique = Array.from(new Set(values));\n  return CAPABILITIES.filter((capability) => unique.includes(capability));\n}\n\nasync function ensureTargetDoesNotExist(targetDir: string): Promise<void> {\n  try {\n    await access(targetDir);\n    throw new Error(`Target directory already exists: ${targetDir}`);\n  } catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") {\n      return;\n    }\n    throw error;\n  }\n}\n\nfunction makePackageJson(\n  name: string,\n  language: Language,\n  sdkVersion: string,\n): string {\n  const scripts =\n    language === \"ts\"\n      ? {\n          dev: \"tsx watch src/server.ts\",\n          build: \"tsc -p tsconfig.json\",\n          format: \"prettier --write .\",\n          \"format:check\": \"prettier --check .\",\n          start: \"node dist/server.js\",\n          test: \"vitest run\",\n          typecheck: \"tsc --noEmit\",\n        }\n      : {\n          dev: \"node --watch src/server.js\",\n          build: 'echo \"No build step for JavaScript template\"',\n          format: \"prettier --write .\",\n          \"format:check\": \"prettier --check .\",\n          start: \"node src/server.js\",\n          test: \"vitest run\",\n        };\n\n  const normalizedScripts = {\n    ...scripts,\n    check:\n      language === \"ts\"\n        ? \"npm run format:check && npm run typecheck && npm test && npm run build\"\n        : \"npm run format:check && npm test && npm run build\",\n  };\n\n  const packageJson = {\n    name,\n    version: \"0.1.0\",\n    private: true,\n    type: \"module\",\n    scripts: normalizedScripts,\n    dependencies: {\n      \"@streamfox/plugin-sdk\": sdkVersion,\n    },\n    devDependencies:\n      language === \"ts\"\n        ? {\n            \"@types/node\": \"^24.6.0\",\n            prettier: \"^3.6.2\",\n            tsx: \"^4.20.5\",\n            typescript: \"^5.9.2\",\n            vitest: \"^2.1.9\",\n          }\n        : {\n            prettier: \"^3.6.2\",\n            vitest: \"^2.1.9\",\n          },\n  };\n\n  return `${JSON.stringify(packageJson, null, 2)}\\n`;\n}\n\nfunction resourceBlock(capability: Capability, advanced: boolean): string {\n  switch (capability) {\n    case \"catalog\":\n      return `catalog: {\n      endpoints: [\n        {\n          id: \"top\",\n          name: \"Top\",\n          mediaTypes: [\"movie\"],\n          filters: [{ key: \"genre\", valueType: \"string\" }],\n        },\n      ],\n      handler: async () => ({\n        items: [],\n      }),\n    },`;\n    case \"meta\":\n      return `meta: {\n      mediaTypes: [\"movie\"],\n      includes: [\"videos\", \"links\"],\n      handler: async () => ({\n        item: ${\n          advanced\n            ? `{\n          summary: {\n            id: { namespace: \"imdb\", value: \"tt1254207\" },\n            mediaType: \"movie\",\n            title: \"Big Buck Bunny\",\n            links: [],\n          },\n          defaultVideoID: \"main\",\n          trailers: [{ transport: { kind: \"youtube\", id: \"aqz-KE-bpKQ\" } }],\n          videos: [\n            {\n              id: \"main\",\n              title: \"Main\",\n              streams: [{ transport: { kind: \"http\", url: \"https://example.com/video.mp4\" } }],\n            },\n          ],\n        }`\n            : \"null\"\n        },\n      }),\n    },`;\n    case \"stream\":\n      return `stream: {\n      mediaTypes: [\"movie\"],\n      supportedTransports: ${advanced ? `[\"http\", \"torrent\", \"usenet\", \"archive\", \"youtube\"]` : `[\"http\"]`},\n      handler: async () => ({\n        streams: [\n          {\n            transport: { kind: \"http\", url: \"https://example.com/video.mp4\", mode: \"stream\" },\n            hints: {\n              notWebReady: true,\n              proxyHeaders: { request: { \"User-Agent\": \"StreamFox\" } },\n            },\n          },\n${\n  advanced\n    ? `          {\n            transport: { kind: \"torrent\", infoHash: \"abcdef\", peerDiscovery: [\"tracker:udp://tracker.example.com:80\"] },\n            selection: { fileIndex: 0 },\n          },\n          {\n            transport: { kind: \"usenet\", nzbURL: \"https://example.com/file.nzb\", servers: [\"nntps://user:pass@news.example.com:563/4\"] },\n          },\n          {\n            transport: {\n              kind: \"archive\",\n              format: \"zip\",\n              files: [{ url: \"https://example.com/archive.zip\", bytes: 1024 }],\n            },\n            selection: { fileMustInclude: \"movie.mkv\" },\n          },\n`\n    : \"\"\n}        ],\n      }),\n    },`;\n    case \"subtitles\":\n      return `subtitles: {\n      mediaTypes: [\"movie\", \"episode\"],\n      defaultLanguages: [\"en\"],\n      handler: async (request, { settings }) => {\n        const configuredLanguages = Array.isArray(settings.languages)\n          ? settings.languages\n          : [];\n        const languagePreferences =\n          configuredLanguages.length > 0 ? configuredLanguages : (request.languagePreferences ?? []);\n\n        void languagePreferences;\n        void settings.includeHI;\n\n        return {\n          subtitles: [],\n        };\n      },\n    },`;\n    case \"plugin_catalog\":\n      return `pluginCatalog: {\n      endpoints: [\n        {\n          id: \"featured\",\n          name: \"Featured\",\n          pluginKinds: [\"catalog\", \"meta\", \"stream\", \"subtitles\"],\n          tags: [\"official\"],\n        },\n      ],\n      handler: async () => ({\n        plugins: [\n          {\n            id: \"com.example.recommended\",\n            name: \"Recommended\",\n            version: \"1.0.0\",\n            pluginKinds: [\"catalog\", \"meta\"],\n            distribution: {\n              transport: \"https\",\n              manifestURL: \"https://plugins.example.com/recommended/manifest\",\n            },\n            manifestSnapshot: {\n              plugin: { id: \"com.example.recommended\" },\n            },\n          },\n        ],\n      }),\n    },`;\n    default:\n      return \"\";\n  }\n}\n\nfunction makeInstallBlock(preset: Preset): string {\n  if (preset !== \"subtitles\") {\n    return \"\";\n  }\n\n  return `  install: {\n    configurationRequired: true,\n    title: \"Subtitle Settings\",\n    description: \"Configure subtitle defaults before installing this plugin.\",\n    fields: [\n      settings.multiSelect(\"languages\", {\n        label: \"Languages\",\n        options: [\n          { label: \"English\", value: \"en\" },\n          { label: \"Greek\", value: \"el\" },\n          { label: \"Spanish\", value: \"es\" },\n        ],\n        defaultValue: [\"en\"],\n      }),\n      settings.checkbox(\"includeHI\", {\n        label: \"Include hearing impaired\",\n        defaultValue: true,\n      }),\n    ],\n  },\n`;\n}\n\nfunction makePluginFile(\n  name: string,\n  preset: Preset,\n  capabilities: Capability[],\n  advanced: boolean,\n): string {\n  const resources = capabilities\n    .map((capability) => resourceBlock(capability, advanced))\n    .join(\"\\n    \");\n  const install = makeInstallBlock(preset);\n  const importSpec =\n    install.length > 0 ? \"definePlugin, settings\" : \"definePlugin\";\n  const installBlock = install.length > 0 ? `${install}` : \"\";\n\n  return `import { ${importSpec} } from \"@streamfox/plugin-sdk\";\n\nexport const plugin = definePlugin({\n  plugin: {\n    id: \"com.example.${name}\",\n    name: \"${name}\",\n    version: \"0.1.0\",\n    description: \"Generated StreamFox plugin scaffold\",\n  },\n${installBlock}  resources: {\n    ${resources}\n  },\n});\n`;\n}\n\nfunction makeServerFile(language: Language): string {\n  const pluginImport = language === \"ts\" ? \"./plugin\" : \"./plugin.js\";\n  return `import { serve } from \"@streamfox/plugin-sdk\";\nimport { plugin } from \"${pluginImport}\";\n\nconst { url, installURL, launchURL } = await serve(plugin, {\n  port: Number(process.env.PORT ?? 7000),\n  integration: {\n    installScheme: \"streamfox\",\n    launchBaseURL: \"https://streamfox.app/#\",\n    autoOpen: \"none\",\n  },\n});\n\nconsole.log(\"Plugin manifest:\", url);\nconsole.log(\"Plugin installer deeplink:\", installURL);\nconsole.log(\"Plugin launch URL:\", launchURL);\n`;\n}\n\nfunction makeVitestFile(language: Language): string {\n  const pluginImport = language === \"ts\" ? \"../src/plugin\" : \"../src/plugin.js\";\n  return `import { describe, expect, it } from \"vitest\";\nimport { createServer } from \"@streamfox/plugin-sdk\";\nimport { plugin } from \"${pluginImport}\";\n\ndescribe(\"scaffold smoke\", () => {\n  it(\"serves manifest and studio config\", async () => {\n    const app = createServer(plugin, { frontend: false });\n\n    const manifestResponse = await app.request(\"/manifest\");\n    expect(manifestResponse.status).toBe(200);\n\n    const studioResponse = await app.request(\"/studio-config\");\n    expect(studioResponse.status).toBe(200);\n  });\n});\n`;\n}\n\nconst tsConfig = `{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"Bundler\",\n    \"strict\": true,\n    \"declaration\": true,\n    \"outDir\": \"dist\",\n    \"rootDir\": \"src\",\n    \"types\": [\"node\"]\n  },\n  \"include\": [\"src\"]\n}\n`;\n\nconst prettierConfig = `{\n  \"semi\": true,\n  \"singleQuote\": false,\n  \"trailingComma\": \"all\"\n}\n`;\n\nconst prettierIgnore = `dist\nnode_modules\n.DS_Store\n`;\n\nfunction makeReadme(\n  projectName: string,\n  preset: Preset,\n  capabilities: Capability[],\n  advanced: boolean,\n): string {\n  const capabilitiesList = capabilities\n    .map((capability) => `- ${capability}`)\n    .join(\"\\n\");\n\n  const endpointForCapability = (capability: Capability): string => {\n    switch (capability) {\n      case \"catalog\":\n        return \"/catalog/:mediaType/:catalogID\";\n      case \"meta\":\n        return \"/meta/:mediaType/:itemID\";\n      case \"stream\":\n        return \"/stream/:mediaType/:itemID\";\n      case \"subtitles\":\n        return \"/subtitles/:mediaType/:itemID\";\n      case \"plugin_catalog\":\n        return \"/plugin_catalog/:catalogID/:pluginKind\";\n      default:\n        return `/${capability}`;\n    }\n  };\n\n  const endpointLines = [\n    \"- GET /manifest\",\n    \"- GET /studio-config\",\n    ...capabilities.map(\n      (capability) => `- GET ${endpointForCapability(capability)}`,\n    ),\n  ].join(\"\\n\");\n\n  return `# ${projectName}\n\nGenerated with create-streamfox-plugin.\n\nPreset: \\`${preset}\\`\nAdvanced template: \\`${advanced ? \"enabled\" : \"disabled\"}\\`\n\n## Scripts\n\n- npm run dev\n- npm run build\n- npm run format\n- npm run start\n- npm run test\n\n## Implemented Capabilities\n\n${capabilitiesList}\n\n## Stream Model\n\n- Unified transport model via \\`stream.transport\\`\n- Capability declaration via \\`resources.stream.supportedTransports\\`\n- Optional selection controls via \\`stream.selection\\`\n\n## Endpoints\n\n${endpointLines}\n`;\n}\n\nexport async function scaffoldProject(options: ScaffoldOptions): Promise<void> {\n  const capabilities = sortedCapabilities([\n    options.preset,\n    ...(options.extraCapabilities ?? []),\n  ]);\n  const sdkVersion =\n    (options.sdkVersion ?? DEFAULT_SDK_VERSION).trim() || DEFAULT_SDK_VERSION;\n  const advanced = options.advanced ?? false;\n\n  await ensureTargetDoesNotExist(options.targetDir);\n\n  const srcDir = path.join(options.targetDir, \"src\");\n  const testDir = path.join(options.targetDir, \"test\");\n\n  await mkdir(srcDir, { recursive: true });\n  await mkdir(testDir, { recursive: true });\n\n  await writeFile(\n    path.join(options.targetDir, \"package.json\"),\n    makePackageJson(options.projectName, options.language, sdkVersion),\n  );\n  await writeFile(\n    path.join(options.targetDir, \".prettierrc.json\"),\n    prettierConfig,\n  );\n  await writeFile(\n    path.join(options.targetDir, \".prettierignore\"),\n    prettierIgnore,\n  );\n  await writeFile(\n    path.join(options.targetDir, \"README.md\"),\n    makeReadme(options.projectName, options.preset, capabilities, advanced),\n  );\n\n  if (options.language === \"ts\") {\n    await writeFile(path.join(options.targetDir, \"tsconfig.json\"), tsConfig);\n    await writeFile(\n      path.join(srcDir, \"plugin.ts\"),\n      makePluginFile(\n        options.projectName,\n        options.preset,\n        capabilities,\n        advanced,\n      ),\n    );\n    await writeFile(path.join(srcDir, \"server.ts\"), makeServerFile(\"ts\"));\n    await writeFile(path.join(testDir, \"plugin.test.ts\"), makeVitestFile(\"ts\"));\n  } else {\n    await writeFile(\n      path.join(srcDir, \"plugin.js\"),\n      makePluginFile(\n        options.projectName,\n        options.preset,\n        capabilities,\n        advanced,\n      ),\n    );\n    await writeFile(path.join(srcDir, \"server.js\"), makeServerFile(\"js\"));\n    await writeFile(path.join(testDir, \"plugin.test.js\"), makeVitestFile(\"js\"));\n  }\n}\n"],"mappings":"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","names":["path"]}

package/dist/index.d.cts

@@ -0,0 +1,18 @@
+declare const CAPABILITIES: readonly ["catalog", "meta", "stream", "subtitles", "plugin_catalog"];
+type Capability = (typeof CAPABILITIES)[number];
+type Preset = Capability;
+type Language = "ts" | "js";
+declare const DEFAULT_PRESET: Preset;
+declare const DEFAULT_SDK_VERSION = "^0.2.0";
+interface ScaffoldOptions {
+    targetDir: string;
+    projectName: string;
+    language: Language;
+    preset: Preset;
+    advanced?: boolean;
+    extraCapabilities?: Capability[];
+    sdkVersion?: string;
+}
+declare function scaffoldProject(options: ScaffoldOptions): Promise<void>;
+
+export { CAPABILITIES, type Capability, DEFAULT_PRESET, DEFAULT_SDK_VERSION, type Language, type Preset, type ScaffoldOptions, scaffoldProject };

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+declare const CAPABILITIES: readonly ["catalog", "meta", "stream", "subtitles", "plugin_catalog"];
+type Capability = (typeof CAPABILITIES)[number];
+type Preset = Capability;
+type Language = "ts" | "js";
+declare const DEFAULT_PRESET: Preset;
+declare const DEFAULT_SDK_VERSION = "^0.2.0";
+interface ScaffoldOptions {
+    targetDir: string;
+    projectName: string;
+    language: Language;
+    preset: Preset;
+    advanced?: boolean;
+    extraCapabilities?: Capability[];
+    sdkVersion?: string;
+}
+declare function scaffoldProject(options: ScaffoldOptions): Promise<void>;
+
+export { CAPABILITIES, type Capability, DEFAULT_PRESET, DEFAULT_SDK_VERSION, type Language, type Preset, type ScaffoldOptions, scaffoldProject };