@unisphere/nx 3.24.0 → 4.1.0

package/dist/generators/add-runtime/schema.json

@@ -7,50 +7,25 @@
     "name": {
       "type": "string",
       "description": "The name of the runtime to create",
-      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$",
-      "x-prompt": "What's the runtime name? (letters, numbers, dashes and spaces allowed)"
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
     },
     "consumer": {
       "type": "string",
       "description": "Is this runtime loaded from within the same experience or by an external consumer?",
-      "x-prompt": {
-        "message": "Is this runtime loaded from within the same experience or by an external consumer?",
-        "type": "list",
-        "items": [
-          {
-            "value": "external",
-            "label": "Loaded by an external consumer"
-          },
-          {
-            "value": "internal",
-            "label": "Loaded by another runtime or application within this experience"
-          }
-        ]
-      }
+      "enum": ["external", "internal"]
     },
     "dependencies": {
       "type": "array",
-      "description": "Select packages to install (use space to select, enter to confirm)",
+      "description": "Packages to install (react, ds, or mui)",
       "items": {
         "type": "string",
-        "enum": [
-          "react",
-          "ds",
-          "mui"
-        ]
+        "enum": ["react", "ds", "mui"]
       },
-      "default": [],
-      "x-prompt": {
-        "message": "Select dependencies to install (use space to select, enter to confirm):",
-        "type": "list",
-        "multiselect": true,
-        "items": [
-          {
-            "value": "react",
-            "label": "React - UI library for building components"
-          }          
-        ]
-      }
+      "default": []
+    },
+    "analyticsAppId": {
+      "type": "number",
+      "description": "Analytics app ID (optional, can be set later in runtime constructor)"
     }
   },
   "required": [

package/dist/generators/add-runtime/templates/new-runtime/src/lib/runtime.tsx.template

@@ -46,7 +46,7 @@ export class Runtime
 
     const analyticsAppId: null | number = <%= analyticsAppId ? analyticsAppId : 'null' %>;
     if (!analyticsAppId) {
-      this._logger.warn(`missing kaltura analytics app id, cannot register application to analytics service`)
+      this._logger.log(`missing kaltura analytics app id, skip application registration to analytics service`)
     } else {
       const service = this._options
         .getWorkspace()

package/dist/generators/add-visual/add-visual.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"add-visual.d.ts","sourceRoot":"","sources":["../../../src/generators/add-visual/add-visual.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAE,MAAM,YAAY,CAAC;AAsB9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAwbpD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,CAoFd;AAED,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"add-visual.d.ts","sourceRoot":"","sources":["../../../src/generators/add-visual/add-visual.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAE,MAAM,YAAY,CAAC;AAsB9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAmapD;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,GAAG,CAAC,CA2Fd;AAED,eAAe,kBAAkB,CAAC"}

package/dist/generators/add-visual/add-visual.js

@@ -7,53 +7,37 @@ const path = tslib_1.__importStar(require("path"));
 const ts_morph_1 = require("ts-morph");
 const utils_1 = require("../utils");
 const visual_utils_1 = require("./visual-utils");
-async function getEnquirerPrompt() {
-    const enquirer = await import('enquirer');
-    // Handle both CommonJS and ESM exports
-    return enquirer.prompt || enquirer.default?.prompt || enquirer;
-}
-async function promptForRuntimeName(availableRuntimes, existingRuntimeName) {
-    if (existingRuntimeName) {
-        return existingRuntimeName;
+function validateOptions(options) {
+    if (!options.runtimeName || options.runtimeName.trim() === '') {
+        throw new Error(`Missing required option: 'runtimeName'\n` +
+            `  Description: The name of the runtime to add the visual to\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-visual --runtimeName=my-runtime --visualName=my-visual`);
     }
-    const prompt = await getEnquirerPrompt();
-    const runtimeNames = Object.keys(availableRuntimes);
-    if (runtimeNames.length === 0) {
-        throw new Error('No runtimes found in .unisphere configuration.\n' +
-            'Please create a runtime first using: nx generate @unisphere/nx:add-runtime');
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.runtimeName)) {
+        throw new Error(`Invalid value '${options.runtimeName}' for option 'runtimeName'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.runtimeName}`);
     }
-    const runtimeChoices = runtimeNames.map(name => ({ name, message: name }));
-    const response = await prompt({
-        type: 'select',
-        name: 'runtimeName',
-        message: 'Select a runtime to add the visual to:',
-        choices: runtimeChoices,
-    });
-    return response.runtimeName;
-}
-async function promptForVisualName(existingVisualName) {
-    if (existingVisualName) {
-        return existingVisualName;
+    if (!options.visualName || options.visualName.trim() === '') {
+        throw new Error(`Missing required option: 'visualName'\n` +
+            `  Description: The name of the visual to create\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-visual --runtimeName=my-runtime --visualName=my-visual`);
     }
-    const prompt = await getEnquirerPrompt();
-    const response = await prompt({
-        type: 'input',
-        name: 'visualName',
-        message: 'What is the visual name?',
-    });
-    return response.visualName;
-}
-async function promptForIsSingleOccurrence(existingValue) {
-    if (existingValue !== undefined) {
-        return existingValue;
+    if (!namePattern.test(options.visualName)) {
+        throw new Error(`Invalid value '${options.visualName}' for option 'visualName'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.visualName}`);
+    }
+    if (options.isSingleOccurrence !== undefined && typeof options.isSingleOccurrence !== 'boolean') {
+        throw new Error(`Invalid value for option 'isSingleOccurrence'\n` +
+            `  Type: boolean\n` +
+            `  Received: ${options.isSingleOccurrence}`);
     }
-    const prompt = await getEnquirerPrompt();
-    const response = await prompt({
-        type: 'confirm',
-        name: 'isSingleOccurrence',
-        message: 'Is this visual limited to single occurrence?',
-    });
-    return response.isSingleOccurrence;
 }
 /**
  * Adds necessary imports (runtimeVisualSettings, runtimeVisualSchema) to the runtime file.
@@ -285,14 +269,22 @@ export const ${schemaName}: ValidatorSchema = {
  * Nx generator to create a new visual within a specified runtime.
  */
 async function addVisualGenerator(tree, options) {
+    validateOptions(options);
     // Validate and read .unisphere configuration first
     const unisphereConfig = (0, utils_1.validateUnisphereConfig)(tree);
-    // Prompt for runtime if not provided
-    const runtimeName = await promptForRuntimeName(unisphereConfig.runtimes, options.runtimeName);
-    // Prompt for visual name if not provided
-    const visualName = await promptForVisualName(options.visualName);
-    // Prompt for isSingleOccurrence if not provided
-    const isSingleOccurrence = await promptForIsSingleOccurrence(options.isSingleOccurrence);
+    // After validation, these are guaranteed to be strings
+    const runtimeName = options.runtimeName;
+    const visualName = options.visualName;
+    // Validate that the runtime exists
+    if (!unisphereConfig.runtimes[runtimeName]) {
+        const availableRuntimes = Object.keys(unisphereConfig.runtimes);
+        throw new Error(`Runtime '${runtimeName}' not found in .unisphere configuration.\n` +
+            (availableRuntimes.length > 0
+                ? `  Available runtimes: ${availableRuntimes.join(', ')}\n`
+                : `  No runtimes found. Please create a runtime first using: nx generate @unisphere/nx:add-runtime\n`) +
+            `  Example: nx g @unisphere/nx:add-visual --runtimeName=${availableRuntimes[0] || 'my-runtime'} --visualName=my-visual`);
+    }
+    const isSingleOccurrence = options.isSingleOccurrence ?? false;
     // Extract environment variables
     const widgetName = unisphereConfig.name;
     // Validate runtime existence and get source root path.

package/dist/generators/add-visual/schema.json

@@ -3,6 +3,22 @@
   "$id": "AddVisual",
   "title": "Add Visual Generator",
   "type": "object",
-  "properties": {},
-  "required": []
+  "properties": {
+    "runtimeName": {
+      "type": "string",
+      "description": "The name of the runtime to add the visual to",
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
+    },
+    "visualName": {
+      "type": "string",
+      "description": "The name of the visual to create",
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
+    },
+    "isSingleOccurrence": {
+      "type": "boolean",
+      "description": "Whether this visual is limited to single occurrence",
+      "default": false
+    }
+  },
+  "required": ["runtimeName", "visualName"]
 }

package/dist/generators/change-package-scope/change-package-scope.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-package-scope.d.ts","sourceRoot":"","sources":["../../../src/generators/change-package-scope/change-package-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,IAAI,EAIL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAiW7D,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,iCAAiC,iBAoH3C;AAED,eAAe,2BAA2B,CAAC"}
+{"version":3,"file":"change-package-scope.d.ts","sourceRoot":"","sources":["../../../src/generators/change-package-scope/change-package-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,IAAI,EAIL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,iCAAiC,EAAE,MAAM,UAAU,CAAC;AAwY7D,wBAAsB,2BAA2B,CAC/C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,iCAAiC,iBAuH3C;AAED,eAAe,2BAA2B,CAAC"}

package/dist/generators/change-package-scope/change-package-scope.js

@@ -23,6 +23,33 @@ const devkit_1 = require("@nx/devkit");
 const generators_1 = require("@nx/workspace/generators");
 const utils_1 = require("../utils");
 const utils_2 = require("./utils");
+function validateOptions(options) {
+    if (!options.packageJsonName || options.packageJsonName.trim() === '') {
+        throw new Error(`Missing required option: 'packageJsonName'\n` +
+            `  Description: The full package.json name\n` +
+            `  Type: string\n` +
+            `  Pattern: ^@[a-z0-9-]+/[a-z0-9-]+$\n` +
+            `  Example: nx g @unisphere/nx:change-package-scope --packageJsonName=@kaltura-corp/unisphere-my-package --newScope=kaltura-sdk`);
+    }
+    const namePattern = /^@[a-z0-9-]+\/[a-z0-9-]+$/;
+    if (!namePattern.test(options.packageJsonName)) {
+        throw new Error(`Invalid value '${options.packageJsonName}' for option 'packageJsonName'\n` +
+            `  Pattern: ^@[a-z0-9-]+/[a-z0-9-]+$\n` +
+            `  Received: ${options.packageJsonName}`);
+    }
+    if (!options.newScope) {
+        throw new Error(`Missing required option: 'newScope'\n` +
+            `  Description: The target scope for the package\n` +
+            `  Allowed values: unisphere, kaltura-corp, kaltura-sdk, kaltura-apps, kaltura-ui, local\n` +
+            `  Example: nx g @unisphere/nx:change-package-scope --packageJsonName=@kaltura-corp/unisphere-my-package --newScope=kaltura-sdk`);
+    }
+    const allowedScopes = ['unisphere', 'kaltura-corp', 'kaltura-sdk', 'kaltura-apps', 'kaltura-ui', 'local'];
+    if (!allowedScopes.includes(options.newScope)) {
+        throw new Error(`Invalid value '${options.newScope}' for option 'newScope'\n` +
+            `  Allowed values: ${allowedScopes.join(', ')}\n` +
+            `  Received: ${options.newScope}`);
+    }
+}
 /**
  * Finds a package in .unisphere config by matching the package.json name.
  * Extracts package information needed for scope change.
@@ -256,6 +283,8 @@ function escapeRegExp(string) {
     return string.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 async function changePackageScopeGenerator(tree, options) {
+    // Validate options
+    validateOptions(options);
     devkit_1.logger.info('');
     devkit_1.logger.info('🔄 Starting package scope change...');
     devkit_1.logger.info('');

package/dist/generators/change-package-scope/schema.json

@@ -7,14 +7,12 @@
     "packageJsonName": {
       "type": "string",
       "description": "The full package.json name (e.g., @kaltura-corp/unisphere-rtc-avatar)",
-      "pattern": "^@[a-z0-9-]+/[a-z0-9-]+$",
-      "x-prompt": "What is the full package.json name? (from the package's package.json)"
+      "pattern": "^@[a-z0-9-]+/[a-z0-9-]+$"
     },
     "newScope": {
       "type": "string",
       "description": "The target scope for the package",
-      "enum": ["unisphere", "kaltura-corp", "kaltura-sdk", "kaltura-apps", "kaltura-ui", "local"],
-      "x-prompt": "What scope should the package move to?"
+      "enum": ["unisphere", "kaltura-corp", "kaltura-sdk", "kaltura-apps", "kaltura-ui", "local"]
     }
   },
   "required": [

package/dist/generators/remove/remove.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/generators/remove/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,IAAI,EAKL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AAiRjD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,qBAAqB,iBAqF/B;AAED,eAAe,eAAe,CAAC"}
+{"version":3,"file":"remove.d.ts","sourceRoot":"","sources":["../../../src/generators/remove/remove.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EACL,IAAI,EAKL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AA6RjD,wBAAsB,eAAe,CACnC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,qBAAqB,iBAwF/B;AAED,eAAe,eAAe,CAAC"}

package/dist/generators/remove/remove.js

@@ -20,6 +20,15 @@ const generators_1 = require("@nx/workspace/generators");
 const utils_1 = require("../utils");
 const remove_utils_1 = require("./remove-utils");
 const VALID_ELEMENT_TYPES = ['package', 'runtime', 'application'];
+function validateOptions(options) {
+    if (!options.element || options.element.trim() === '') {
+        throw new Error(`Missing required option: 'element'\n` +
+            `  Description: The element to remove in format 'type:name'\n` +
+            `  Type: string\n` +
+            `  Format: type:name (e.g., runtime:admin, package:shared, application:my-app)\n` +
+            `  Example: nx g @unisphere/nx:remove runtime:admin`);
+    }
+}
 /**
  * Parse the element string in format "type:name"
  */
@@ -214,6 +223,8 @@ function removeFromPackageLock(tree, sourceRoot) {
     }
 }
 async function removeGenerator(tree, options) {
+    // Validate options
+    validateOptions(options);
     // Validate .unisphere exists
     (0, utils_1.validateUnisphereConfig)(tree);
     // Parse element string (format: "type:name")

package/dist/generators/remove/schema.json

@@ -25,8 +25,7 @@
       "$default": {
         "$source": "argv",
         "index": 0
-      },
-      "x-prompt": "Enter element to remove (format: type:name, e.g., runtime:admin):"
+      }
     },
     "forceRemove": {
       "type": "boolean",

package/dist/generators/rename-package/rename-package.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rename-package.d.ts","sourceRoot":"","sources":["../../../src/generators/rename-package/rename-package.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,IAAI,EAKL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AA6axD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,4BAA4B,iBA2GtC;AAED,eAAe,sBAAsB,CAAC"}
+{"version":3,"file":"rename-package.d.ts","sourceRoot":"","sources":["../../../src/generators/rename-package/rename-package.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EACL,IAAI,EAKL,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AA2cxD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,4BAA4B,iBA8GtC;AAED,eAAe,sBAAsB,CAAC"}

package/dist/generators/rename-package/rename-package.js

@@ -20,6 +20,27 @@ exports.renamePackageGenerator = renamePackageGenerator;
 const devkit_1 = require("@nx/devkit");
 const generators_1 = require("@nx/workspace/generators");
 const utils_1 = require("../utils");
+function validateOptions(options) {
+    if (!options.oldPackageName || options.oldPackageName.trim() === '') {
+        throw new Error(`Missing required option: 'oldPackageName'\n` +
+            `  Description: The current name of the package to rename\n` +
+            `  Type: string\n` +
+            `  Example: nx g @unisphere/nx:rename-package --oldPackageName=old-name --newPackageName=new-name`);
+    }
+    if (!options.newPackageName || options.newPackageName.trim() === '') {
+        throw new Error(`Missing required option: 'newPackageName'\n` +
+            `  Description: The new name for the package\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:rename-package --oldPackageName=old-name --newPackageName=new-name`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.newPackageName)) {
+        throw new Error(`Invalid value '${options.newPackageName}' for option 'newPackageName'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.newPackageName}`);
+    }
+}
 /**
  * Reserved package names that cannot be renamed.
  * These packages have special meaning in Unisphere and renaming them would break functionality.
@@ -330,6 +351,8 @@ function updatePackageLock(tree, oldPath, newPath) {
     }
 }
 async function renamePackageGenerator(tree, options) {
+    // Validate options
+    validateOptions(options);
     devkit_1.logger.info('');
     devkit_1.logger.info('🔄 Starting package rename...');
     devkit_1.logger.info('');

package/dist/generators/rename-package/schema.json

@@ -6,14 +6,12 @@
   "properties": {
     "oldPackageName": {
       "type": "string",
-      "description": "The current name of the package to rename",
-      "x-prompt": "What is the current package name?"
+      "description": "The current name of the package to rename"
     },
     "newPackageName": {
       "type": "string",
       "description": "The new name for the package",
-      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$",
-      "x-prompt": "What should the new package name be? (alphanumeric with dashes and spaces allowed)"
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
     }
   },
   "required": [

package/dist/generators/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './validation';
+//# sourceMappingURL=index.d.ts.map

package/dist/generators/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/generators/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC"}

package/dist/generators/utils/index.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./validation"), exports);

package/dist/generators/utils/validation.d.ts

@@ -0,0 +1,9 @@
+export interface ValidationConfig {
+    name: string;
+    description: string;
+    allowedValues?: string[];
+    pattern?: string;
+    type?: string;
+}
+export declare function validateRequired(options: Record<string, any>, config: ValidationConfig): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/generators/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/generators/utils/validation.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,MAAM,EAAE,gBAAgB,GACvB,IAAI,CAyCN"}

package/dist/generators/utils/validation.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateRequired = validateRequired;
+function validateRequired(options, config) {
+    const value = options[config.name];
+    // Check if value is missing
+    if (value === undefined || value === null || value === '') {
+        let message = `Missing required option: '${config.name}'\n`;
+        message += `  Description: ${config.description}\n`;
+        if (config.allowedValues) {
+            message += `  Allowed values: ${config.allowedValues.join(', ')}\n`;
+        }
+        if (config.type) {
+            message += `  Type: ${config.type}\n`;
+        }
+        if (config.pattern) {
+            message += `  Pattern: ${config.pattern}\n`;
+        }
+        throw new Error(message.trim());
+    }
+    // Check pattern if provided
+    if (config.pattern && typeof value === 'string') {
+        const regex = new RegExp(config.pattern);
+        if (!regex.test(value)) {
+            let message = `Invalid value '${value}' for option '${config.name}'\n`;
+            message += `  Pattern: ${config.pattern}\n`;
+            message += `  Received: ${value}`;
+            throw new Error(message);
+        }
+    }
+    // Check enum if provided
+    if (config.allowedValues && !config.allowedValues.includes(value)) {
+        let message = `Invalid value '${value}' for option '${config.name}'\n`;
+        message += `  Allowed values: ${config.allowedValues.join(', ')}\n`;
+        message += `  Received: ${value}`;
+        throw new Error(message);
+    }
+}

package/dist/migrations/3-24-0/add-server-runtimes-setup.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Migration: Add local runtimes setup
+ *
+ * For each local application (sourceRoot containing '/server'):
+ * 1. Creates setup-local-runtimes.ts with experience name from .unisphere
+ * 2. Imports and calls setupLocalRuntimes() in main.tsx
+ * 3. Adds LOCAL_RUNTIMES env var to webpack DefinePlugin
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=add-server-runtimes-setup.d.ts.map

package/dist/migrations/3-24-0/add-server-runtimes-setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-server-runtimes-setup.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-24-0/add-server-runtimes-setup.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAiC,MAAM,YAAY,CAAC;AA2GjE,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA4E9D"}

package/dist/migrations/3-24-0/add-server-runtimes-setup.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Migration: Add local runtimes setup
+ *
+ * For each local application (sourceRoot containing '/server'):
+ * 1. Creates setup-local-runtimes.ts with experience name from .unisphere
+ * 2. Imports and calls setupLocalRuntimes() in main.tsx
+ * 3. Adds LOCAL_RUNTIMES env var to webpack DefinePlugin
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const path_1 = require("path");
+function generateSetupLocalRuntimes(experienceName) {
+    return `export function setupLocalRuntimes() {
+  if (!process.env.LOCAL_RUNTIMES) return;
+
+  const runtimes: Record<string, { token: string; baseEnvName: string }> = {};
+  process.env.LOCAL_RUNTIMES.split(',').forEach((entry) => {
+    const [name, port] = entry.split('@');
+    if (name && port) {
+      runtimes[name] = { token: port, baseEnvName: '' };
+    }
+  });
+
+  const overrides = {
+    baseEnvName: '',
+    mode: 'integration',
+    options: { verbose: 'inherit' },
+    baseEnvScope: { core: 'inherit', presets: 'inherit' },
+    runtimes: {
+      '${experienceName}': runtimes,
+    },
+  };
+
+  (window as any).unisphereRuntimeOverrides = btoa(JSON.stringify(overrides));
+}
+`;
+}
+function addImportToMainTsx(content) {
+    const importLine = "import { setupLocalRuntimes } from './setup-local-runtimes';";
+    const callLine = 'setupLocalRuntimes();';
+    if (content.includes('setupLocalRuntimes')) {
+        return content;
+    }
+    // Find the last import statement
+    const lines = content.split('\n');
+    let lastImportIndex = -1;
+    for (let i = 0; i < lines.length; i++) {
+        if (lines[i].startsWith('import ')) {
+            lastImportIndex = i;
+        }
+    }
+    if (lastImportIndex === -1) {
+        // No imports found, add at the top
+        return `${importLine}\n\n${callLine}\n\n${content}`;
+    }
+    // Insert after the last import
+    lines.splice(lastImportIndex + 1, 0, importLine, '', callLine);
+    return lines.join('\n');
+}
+function addLocalRuntimesToDefinePlugin(content) {
+    const entry = "'process.env.LOCAL_RUNTIMES': JSON.stringify(process.env.LOCAL_RUNTIMES),";
+    if (content.includes('LOCAL_RUNTIMES')) {
+        return content;
+    }
+    // Find the DefinePlugin block and add before its closing })
+    const definePluginMatch = content.match(/new DefinePlugin\(\{/);
+    if (!definePluginMatch || definePluginMatch.index === undefined) {
+        return content;
+    }
+    // Find the closing }) of DefinePlugin
+    const startIndex = definePluginMatch.index;
+    let braceCount = 0;
+    let closingIndex = -1;
+    for (let i = startIndex; i < content.length; i++) {
+        if (content[i] === '{')
+            braceCount++;
+        if (content[i] === '}') {
+            braceCount--;
+            if (braceCount === 0) {
+                closingIndex = i;
+                break;
+            }
+        }
+    }
+    if (closingIndex === -1) {
+        return content;
+    }
+    const indent = '      ';
+    // Insert the new entry before the closing }
+    return content.substring(0, closingIndex).trimEnd() + '\n' +
+        `${indent}${entry}\n` +
+        '    ' + content.substring(closingIndex);
+}
+async function update(tree) {
+    devkit_1.logger.info('🔄 Adding local runtimes setup to local applications...');
+    if (!tree.exists('.unisphere')) {
+        devkit_1.logger.warn('⚠️ No .unisphere file found, skipping');
+        return;
+    }
+    const config = (0, devkit_1.readJson)(tree, '.unisphere');
+    const experienceName = `unisphere.${config.type}.${config.name}`;
+    const applications = config.elements?.applications;
+    if (!applications || Object.keys(applications).length === 0) {
+        devkit_1.logger.info('ℹ️ No applications found, skipping');
+        return;
+    }
+    let updatedCount = 0;
+    for (const [appName, appConfig] of Object.entries(applications)) {
+        const { sourceRoot } = appConfig;
+        // Only process server applications
+        if (!sourceRoot.includes('/server/')) {
+            devkit_1.logger.info(`ℹ️ ${appName}: Not a server application, local was already migrated. skipping`);
+            continue;
+        }
+        const setupFilePath = (0, path_1.join)(sourceRoot, 'src', 'setup-local-runtimes.ts');
+        const mainTsxPath = (0, path_1.join)(sourceRoot, 'src', 'main.tsx');
+        const webpackPath = (0, path_1.join)(sourceRoot, 'webpack.config.js');
+        // 1. Create setup-local-runtimes.ts
+        if (tree.exists(setupFilePath)) {
+            devkit_1.logger.info(`ℹ️ ${appName}: setup-local-runtimes.ts already exists, skipping`);
+        }
+        else {
+            tree.write(setupFilePath, generateSetupLocalRuntimes(experienceName));
+            devkit_1.logger.info(`✅ ${appName}: Created setup-local-runtimes.ts`);
+        }
+        // 2. Modify main.tsx
+        if (!tree.exists(mainTsxPath)) {
+            devkit_1.logger.warn(`⚠️ ${appName}: No main.tsx found, skipping`);
+            continue;
+        }
+        const mainContent = tree.read(mainTsxPath, 'utf-8') || '';
+        const updatedMain = addImportToMainTsx(mainContent);
+        if (updatedMain !== mainContent) {
+            tree.write(mainTsxPath, updatedMain);
+            devkit_1.logger.info(`✅ ${appName}: Added setupLocalRuntimes import to main.tsx`);
+        }
+        else {
+            devkit_1.logger.info(`ℹ️ ${appName}: main.tsx already has setupLocalRuntimes`);
+        }
+        // 3. Modify webpack.config.js
+        if (!tree.exists(webpackPath)) {
+            devkit_1.logger.warn(`⚠️ ${appName}: No webpack.config.js found, skipping`);
+            continue;
+        }
+        const webpackContent = tree.read(webpackPath, 'utf-8') || '';
+        const updatedWebpack = addLocalRuntimesToDefinePlugin(webpackContent);
+        if (updatedWebpack !== webpackContent) {
+            tree.write(webpackPath, updatedWebpack);
+            devkit_1.logger.info(`✅ ${appName}: Added LOCAL_RUNTIMES to DefinePlugin`);
+        }
+        else {
+            devkit_1.logger.info(`ℹ️ ${appName}: webpack.config.js already has LOCAL_RUNTIMES`);
+        }
+        updatedCount++;
+    }
+    await (0, devkit_1.formatFiles)(tree);
+    devkit_1.logger.info(`\n✅ Done: ${updatedCount} local application(s) updated with local runtimes setup (experience: ${experienceName})`);
+}

package/dist/migrations/3-24-0/remove-runtime-js-patch.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Remove outdated @unisphere+runtime-js patch file
+ *
+ * Removes any patches/@unisphere+runtime-js+{version}.patch file if it exists.
+ * Migration succeeds whether file exists or not.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=remove-runtime-js-patch.d.ts.map

package/dist/migrations/3-24-0/remove-runtime-js-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove-runtime-js-patch.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-24-0/remove-runtime-js-patch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAU,MAAM,YAAY,CAAC;AAE1C,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB9D"}