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

package/index.d.ts

@@ -150,6 +150,16 @@ export declare const ProductTemplateMigrationSchema: z.ZodObject<{
     }>;
 }, z.core.$strip>;
 export type ProductTemplateMigration = z.infer<typeof ProductTemplateMigrationSchema>;
+export declare const PRODUCT_TEMPLATE_WORKLOAD_ROLES: readonly ["viewer", "operator", "builder"];
+export declare const ProductTemplateWorkloadSchema: z.ZodObject<{
+    role: z.ZodEnum<{
+        viewer: "viewer";
+        operator: "operator";
+        builder: "builder";
+    }>;
+    on: z.ZodLiteral<"product">;
+}, z.core.$strip>;
+export type ProductTemplateWorkload = z.infer<typeof ProductTemplateWorkloadSchema>;
 export declare const ProductTemplateManifestSchema: z.ZodObject<{
     productTemplateSchemaVersion: z.ZodLiteral<1>;
     productName: z.ZodString;
@@ -330,6 +340,14 @@ export declare const ProductTemplateManifestSchema: z.ZodObject<{
     hostTls: z.ZodOptional<z.ZodObject<{
         services: z.ZodArray<z.ZodString>;
     }, z.core.$strip>>;
+    workload: z.ZodOptional<z.ZodObject<{
+        role: z.ZodEnum<{
+            viewer: "viewer";
+            operator: "operator";
+            builder: "builder";
+        }>;
+        on: z.ZodLiteral<"product">;
+    }, z.core.$strip>>;
     migration: z.ZodOptional<z.ZodObject<{
         strategy: z.ZodEnum<{
             overlap: "overlap";
@@ -571,6 +589,14 @@ export declare const ProductTemplateMaterialsSchema: z.ZodObject<{
         hostTls: z.ZodOptional<z.ZodObject<{
             services: z.ZodArray<z.ZodString>;
         }, z.core.$strip>>;
+        workload: z.ZodOptional<z.ZodObject<{
+            role: z.ZodEnum<{
+                viewer: "viewer";
+                operator: "operator";
+                builder: "builder";
+            }>;
+            on: z.ZodLiteral<"product">;
+        }, z.core.$strip>>;
         migration: z.ZodOptional<z.ZodObject<{
             strategy: z.ZodEnum<{
                 overlap: "overlap";

package/index.js

@@ -319,6 +319,16 @@ export const ProductTemplateMigrationSchema = z
     }),
 })
     .meta({ id: "ProductTemplateMigration", outputId: "ProductTemplateMigration" });
+// The roles a template may declare for its instances' workload: at most
+// builder, since registering a template takes builder and that registration is
+// the consent. Built-in names only, whose meaning every host agrees on.
+export const PRODUCT_TEMPLATE_WORKLOAD_ROLES = ["viewer", "operator", "builder"];
+export const ProductTemplateWorkloadSchema = z
+    .object({
+    role: z.enum(PRODUCT_TEMPLATE_WORKLOAD_ROLES),
+    on: z.literal("product"),
+})
+    .meta({ id: "ProductTemplateWorkload", outputId: "ProductTemplateWorkload" });
 export const ProductTemplateManifestSchema = z
     .object({
     productTemplateSchemaVersion: z.literal(1),
@@ -371,6 +381,9 @@ export const ProductTemplateManifestSchema = z
     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.",
     }),
+    workload: ProductTemplateWorkloadSchema.optional().meta({
+        description: "The role each instance's own workload (`urn:norsk:workload:instance:<id>`) holds on its product (`product/<productName>`), granted when it launches, whoever launches it — for an instance that creates or manages its product's other instances (a capture launching recorders). At most `builder`: registering a template takes builder, and that registration is the consent. Absent = the workload holds nothing it was not passed at launch. An older ctl ignores it, and its instances hold nothing.",
+    }),
     migration: ProductTemplateMigrationSchema.optional().meta({
         description: "How a running instance may be moved between nodes. `strategy` is the strongest promise the product keeps: `overlap` (target started, then source stopped — both may produce briefly), `stopThenStart` (the default when absent — target prepared but not started, source stopped, target started), or `handover` (the job speaks the worker's migration socket and hands over at an exact position). A migrate request may down-grade to a safer strategy but never up-grade past the declaration. Only the manager reads this; the worker never does.",
     }),

package/package.json

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