@norskvideo/ctl-dev-kit 0.2.107 → 0.2.109

package/create-product/cli.ts

@@ -5,6 +5,7 @@
 // so the bin runs under bun (the fleet's only runtime).
 import { existsSync, readdirSync } from "node:fs";
 import { parseArgs } from "node:util";
+import { createDemo, type DemoFeature } from "../create-demo/create-demo.ts";
 import { createDashboard } from "../dashboard/create-dashboard.ts";
 import { writeDashboardManifest } from "../dashboard/manifest.ts";
 import { createProduct, type ProductFeature, type ProductShape, type StudioLibrary } from "./create-product.ts";
@@ -13,6 +14,8 @@ const SHAPES: ProductShape[] = ["backend-turnkey", "turnkey"];
 
 const USAGE = `Usage:
   ctl-dev-kit create-product --name <name> [options] <dir>
+  ctl-dev-kit create-demo --name <name> [--with dashboard,components] [--user <user>] <dir>
+                                                    a customer demo: a Studio working dir installed into norsk-ctl
   ctl-dev-kit create-dashboard --name <name> <dir>   a fleet dashboard norsk-mgr hosts (a live runtime list)
   ctl-dev-kit dashboard-manifest <src> <dist>   write <dist>/dashboard.json from a fleet dashboard's calls
 
@@ -57,9 +60,13 @@ export function main(argv: string[]): void {
     newDashboard(rest);
     return;
   }
+  if (command === "create-demo") {
+    newDemo(rest);
+    return;
+  }
   if (command !== "create-product") {
     fail(
-      `unknown command ${JSON.stringify(command ?? "")} — the commands are create-product, create-dashboard and dashboard-manifest.`,
+      `unknown command ${JSON.stringify(command ?? "")} — the commands are create-product, create-demo, create-dashboard and dashboard-manifest.`,
     );
   }
   const { values, positionals } = parseArgs({
@@ -172,3 +179,34 @@ Next steps (also in its README):
   3. norsk-mgr dashboard register ${values.name} && norsk-mgr dashboard upload ${values.name} dashboard.tar
 `);
 }
+
+function newDemo(args: string[]): void {
+  const { values, positionals } = parseArgs({
+    args,
+    allowPositionals: true,
+    options: { name: { type: "string" }, with: { type: "string" }, user: { type: "string" } },
+  });
+  const dir = positionals[0];
+  if (!dir) fail("missing <dir>.");
+  if (!values.name) fail("missing --name.");
+  if (existsSync(dir) && readdirSync(dir).length > 0) fail(`${dir} exists and is not empty — refusing to overwrite.`);
+  const withFeatures = values.with
+    ?.split(",")
+    .map((f) => f.trim())
+    .filter(Boolean) as DemoFeature[] | undefined;
+  let files: string[];
+  try {
+    ({ files } = createDemo({ dir, name: values.name, user: values.user ?? process.env.USER ?? "me", withFeatures }));
+  } catch (err) {
+    fail(err instanceof Error ? err.message : String(err));
+  }
+  console.log(`Generated ${files.length} files into ${dir}.
+
+Next steps (also in the generated CLAUDE.md):
+  1. cd ${dir} && git init
+  2. cp ctl/site.example.env ctl/site.env && cp ctl/studio.example.env ctl/studio.env   # then fill them in
+  3. ctl/install.sh                     # build, stage the working dir, launch instance ${values.name} in norsk-ctl
+  4. scripts/test-feed.sh up            # a test picture into the SRT input
+  5. Replace the starter workflow in workdir/studio-save-files/${values.name}/ and ctl/push.sh after each change.
+`);
+}

package/create-product/features/components.ts

@@ -608,7 +608,10 @@ export function exampleSidecar(args: ExampleArgs): WorkflowComponent<ExampleConf
 `;
 }
 
-export function componentsFiles(ctx: ShapeContext): GeneratedFile[] {
+/** The components/ workspace alone — its build chain and the example node,
+ *  without the product glue componentsFiles adds. create-demo uses this: a demo
+ *  has no backend or shared/, and its build copies lib/ into the working dir. */
+export function componentsWorkspaceFiles(ctx: ShapeContext): GeneratedFile[] {
   return [
     { path: "components/package.json", content: packageJson(ctx) },
     { path: "components/tsconfig.json", content: TSCONFIG },
@@ -621,6 +624,12 @@ export function componentsFiles(ctx: ShapeContext): GeneratedFile[] {
     { path: "components/src/library/example/types.source.yaml", content: EXAMPLE_TYPES_YAML },
     { path: "components/src/library/example/info.ts", content: exampleInfoTs(ctx) },
     { path: "components/src/library/example/runtime.ts", content: EXAMPLE_RUNTIME_TS },
+  ];
+}
+
+export function componentsFiles(ctx: ShapeContext): GeneratedFile[] {
+  return [
+    ...componentsWorkspaceFiles(ctx),
     { path: "backend/src/lib/components.ts", content: BACKEND_LIB_COMPONENTS_TS },
     { path: "shared/src/workflow/example-config.ts", content: exampleConfigTs(ctx) },
   ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-dev-kit",
-  "version": "0.2.107",
+  "version": "0.2.109",
   "type": "module",
   "exports": {
     "./create-product": "./create-product/create-product.ts",