@norskvideo/ctl-product-template-schema 0.1.32 → 0.1.33

package/index.d.ts

@@ -59,6 +59,10 @@ export declare const ProductTemplateHostTlsSchema: z.ZodObject<{
     services: z.ZodArray<z.ZodString>;
 }, z.core.$strip>;
 export type ProductTemplateHostTls = z.infer<typeof ProductTemplateHostTlsSchema>;
+export declare const ProductTemplateWorkdirSchema: z.ZodObject<{
+    services: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ProductTemplateWorkdir = z.infer<typeof ProductTemplateWorkdirSchema>;
 export declare const ProductTemplateAcceleratorSchema: z.ZodEnum<{
     none: "none";
     nvidia: "nvidia";
@@ -320,6 +324,9 @@ export declare const ProductTemplateManifestSchema: z.ZodObject<{
             configPath: z.ZodString;
         }, z.core.$strict>]>>;
     }, z.core.$strict>>>;
+    workdir: z.ZodOptional<z.ZodObject<{
+        services: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
     hostTls: z.ZodOptional<z.ZodObject<{
         services: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
@@ -558,6 +565,9 @@ export declare const ProductTemplateMaterialsSchema: z.ZodObject<{
                 configPath: z.ZodString;
             }, z.core.$strict>]>>;
         }, z.core.$strict>>>;
+        workdir: z.ZodOptional<z.ZodObject<{
+            services: z.ZodArray<z.ZodString>;
+        }, z.core.$strip>>;
         hostTls: z.ZodOptional<z.ZodObject<{
             services: z.ZodArray<z.ZodString>;
         }, z.core.$strip>>;

package/index.js

@@ -204,6 +204,21 @@ export const ProductTemplateHostTlsSchema = z
     }),
 })
     .meta({ id: "ProductTemplateHostTls", outputId: "ProductTemplateHostTls" });
+// The instance working directory, handed to a product's own services. WHY THIS
+// EXISTS: it is the one per-instance store that survives a relaunch (a named
+// volume does not: relaunch tears down with `down -v`), and the runner mounts
+// it at /data only into media and studio. A product whose own service keeps
+// state -- a relay's state file and site key -- or writes files the engine must
+// read (assets, recordings) needs the same directory at the same path. A
+// product relying on it declares the runner capability `service-workdir`,
+// since an older runner would ignore the field and lose the state.
+export const ProductTemplateWorkdirSchema = z
+    .object({
+    services: z.array(z.string().min(1)).min(1).meta({
+        description: "Compose services that get the instance working directory, read-write at /data -- the same directory, at the same path, that media and studio have -- with NORSK_WORKDIR=/data. Each must be a service in the template's own compose.yml. It survives relaunch, restart and runner upgrade; only `instance delete --purge` removes it.",
+    }),
+})
+    .meta({ id: "ProductTemplateWorkdir", outputId: "ProductTemplateWorkdir" });
 // Placement requirements guidance (requirements-authoring.md). Each dimension
 // the placer reasons over — capacity (vCPUs), cores, GPU, capabilities, host
 // ports — is optionally declared with a `mode`:
@@ -350,6 +365,9 @@ export const ProductTemplateManifestSchema = z
         description: "Host-port bindings whose value rides a product-template parameter. Opt-in per launch via the param value: absent = closed, 'auto' = allocate a free port from `preferred`, number = use it. When opened the port is published as a managed host binding and surfaced to the containers via compose interpolation. Alongside the per-param scalars the runner sets NORSK_ALLOCATED_PORTS: a JSON object keyed by param, each value {port, protocol, service?}, describing every opened port ('{}' when none opted in; unset when nothing is declared) — so a product needing the allocation as data maps one var instead of folding scalars into JSON via interpolation.",
     }),
     logs: ProductTemplateLogsSchema.optional(),
+    workdir: ProductTemplateWorkdirSchema.optional().meta({
+        description: "Mount the instance working directory at /data into the named compose services, as media and studio always have it -- for a product's own service that keeps state across relaunch or shares files with the engine. Absent = not mounted. Declare the runner capability `service-workdir` alongside it.",
+    }),
     hostTls: ProductTemplateHostTlsSchema.optional().meta({
         description: "Mount the host's TLS certificate and key, read-only, into the named compose services — for a product that serves TLS itself. Copied per launch, so a rotated certificate is picked up on relaunch. Absent = nothing mounted.",
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-product-template-schema",
-  "version": "0.1.32",
+  "version": "0.1.33",
   "type": "module",
   "exports": {
     ".": {