@norskvideo/ctl-product-template-schema 0.1.56 → 0.1.57

package/package.json

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

package/read.d.ts

@@ -1,5 +1,17 @@
 import type { ProductTemplateParameter } from "./index.js";
 import { type ProductTemplateManifest } from "./index.js";
+/** The NORSK_ prefix is platform-injected (runtime identity, allocated ports,
+ *  the licence path...); mgr already refuses an operator value for one, so a
+ *  product declaring one asks for a value nobody may give it.
+ *
+ *  WARN-ONLY FOR ONE RELEASE, then a refusal (a superRefine on
+ *  ProductTemplateParameterSchema.name). Release order: relay (its NORSK_IMAGE
+ *  parameter became MEDIA_IMAGE) and db-chanel (NORSK_CTL_URL became CTL_URL)
+ *  ship first, then ctl and mgr with this warning, then the refusal. The
+ *  callers log what this returns at import, refresh, upload and metadata
+ *  update; nothing re-validates stored templates at startup. */
+export declare const RESERVED_PARAMETER_PREFIX = "NORSK_";
+export declare function reservedParameterNameWarnings(parameters: readonly ProductTemplateParameter[]): string[];
 /**
  * Error taxonomy for product-template lifecycle issues. Codes cover both the
  * "store + extract" path (ctl's ProductTemplateService — extraction, manifest

package/read.js

@@ -9,6 +9,23 @@
 // mgr (which stores raw bytes for relay) does not — so compose presence is a
 // reported fact here, not a verdict.
 import { ParametersFileSchema, ProductTemplateManifestSchema } from "./index.js";
+/** The NORSK_ prefix is platform-injected (runtime identity, allocated ports,
+ *  the licence path...); mgr already refuses an operator value for one, so a
+ *  product declaring one asks for a value nobody may give it.
+ *
+ *  WARN-ONLY FOR ONE RELEASE, then a refusal (a superRefine on
+ *  ProductTemplateParameterSchema.name). Release order: relay (its NORSK_IMAGE
+ *  parameter became MEDIA_IMAGE) and db-chanel (NORSK_CTL_URL became CTL_URL)
+ *  ship first, then ctl and mgr with this warning, then the refusal. The
+ *  callers log what this returns at import, refresh, upload and metadata
+ *  update; nothing re-validates stored templates at startup. */
+export const RESERVED_PARAMETER_PREFIX = "NORSK_";
+export function reservedParameterNameWarnings(parameters) {
+    return parameters
+        .filter((p) => p.name.startsWith(RESERVED_PARAMETER_PREFIX))
+        .map((p) => `parameter '${p.name}' uses the reserved ${RESERVED_PARAMETER_PREFIX} prefix, which the platform sets; ` +
+        "rename it without the prefix. A later release refuses such templates");
+}
 /**
  * Error taxonomy for product-template lifecycle issues. Codes cover both the
  * "store + extract" path (ctl's ProductTemplateService — extraction, manifest