@norskvideo/ctl-sdk 0.1.43 → 0.1.44

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@norskvideo/ctl-sdk",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "type": "module",
   "exports": {
     ".": {

package/parsing.d.ts

@@ -6,4 +6,10 @@ export declare function parseSpec(raw: unknown, where: string, path: string): Pr
 export interface ProductsFile {
     products: ProductRegistration[];
 }
+/** The products file's schema version. Unstamped files are version 0 (every
+ *  file written so far); a file stamped with a higher version was written by
+ *  a newer norsk-ctl or norsk-mgr and is refused rather than misread, the
+ *  rule every other store follows. Bump when the shape changes and add the
+ *  migration at the store. */
+export declare const PRODUCTS_FILE_VERSION = 0;
 export declare function parseProductsFile(raw: unknown, path: string): ProductsFile;

package/parsing.js

@@ -60,9 +60,19 @@ function parseLicense(raw, where, path) {
     }
     throw new ProductsParseError(path, `${where}.license.mode must be 'byol' or 'marketplace'`);
 }
+/** The products file's schema version. Unstamped files are version 0 (every
+ *  file written so far); a file stamped with a higher version was written by
+ *  a newer norsk-ctl or norsk-mgr and is refused rather than misread, the
+ *  rule every other store follows. Bump when the shape changes and add the
+ *  migration at the store. */
+export const PRODUCTS_FILE_VERSION = 0;
 export function parseProductsFile(raw, path) {
     if (!isRecord(raw))
         throw new ProductsParseError(path, "file is not a YAML object");
+    if (typeof raw.version === "number" && raw.version > PRODUCTS_FILE_VERSION) {
+        throw new ProductsParseError(path, `is at version ${raw.version}, written by a newer norsk-ctl/norsk-mgr; this one understands up to ${PRODUCTS_FILE_VERSION}. ` +
+            "Run the newer one, or restore the pre-upgrade copy kept beside the file.");
+    }
     const products = raw.products;
     if (products === undefined)
         return { products: [] };