@unisphere/nx 3.23.0 → 4.0.0

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-23-0/update-documentation-typedoc-plugins.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-documentation-typedoc-plugins.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-23-0/update-documentation-typedoc-plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAA4C,MAAM,YAAY,CAAC;AA6D5E,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA2H9D"}
+{"version":3,"file":"update-documentation-typedoc-plugins.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-23-0/update-documentation-typedoc-plugins.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,IAAI,EAA4C,MAAM,YAAY,CAAC;AA6D5E,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA8I9D"}

package/dist/migrations/3-23-0/update-documentation-typedoc-plugins.js

@@ -133,20 +133,35 @@ async function update(tree) {
             else {
                 devkit_1.logger.warn(`⚠️ ${configPath} not found, skipping config update`);
             }
-            // 4. Add discover-plugins script to package.json
+            // 4. Update package.json: add discover-plugins script, typedoc-plugin-markdown, webpack override
             const pkgPath = `${sitePath}/package.json`;
             if (tree.exists(pkgPath)) {
                 const pkg = (0, devkit_1.readJson)(tree, pkgPath);
+                let pkgChanged = false;
                 if (!pkg.scripts?.['discover-plugins']) {
                     pkg.scripts = pkg.scripts || {};
-                    pkg.scripts['discover-plugins'] =
-                        'node plugins/discover-typedoc-plugins.mjs';
-                    (0, devkit_1.writeJson)(tree, pkgPath, pkg);
+                    pkg.scripts['discover-plugins'] = 'node plugins/discover-typedoc-plugins.mjs';
+                    pkgChanged = true;
                     devkit_1.logger.info(`✅ Added discover-plugins script to ${pkgPath}`);
                 }
                 else {
                     devkit_1.logger.info(`ℹ️ discover-plugins script already exists in ${pkgPath}`);
                 }
+                if (!pkg.devDependencies?.['typedoc-plugin-markdown']) {
+                    pkg.devDependencies = pkg.devDependencies || {};
+                    pkg.devDependencies['typedoc-plugin-markdown'] = '^4.8.0';
+                    pkgChanged = true;
+                    devkit_1.logger.info(`✅ Added typedoc-plugin-markdown to ${pkgPath}`);
+                }
+                if (!pkg.overrides?.['webpack']) {
+                    pkg.overrides = pkg.overrides || {};
+                    pkg.overrides['webpack'] = '5.105.4';
+                    pkgChanged = true;
+                    devkit_1.logger.info(`✅ Added webpack override to ${pkgPath}`);
+                }
+                if (pkgChanged) {
+                    (0, devkit_1.writeJson)(tree, pkgPath, pkg);
+                }
             }
             createdCount++;
         }

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"}

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

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Removing outdated @unisphere+runtime-js patch file...');
+    const patchesDir = 'patches';
+    if (tree.exists(patchesDir)) {
+        const patchFiles = tree.children(patchesDir);
+        const runtimeJsPatch = patchFiles.find(file => file.startsWith('@unisphere+runtime-js+'));
+        if (runtimeJsPatch) {
+            const patchPath = `${patchesDir}/${runtimeJsPatch}`;
+            tree.delete(patchPath);
+            devkit_1.logger.info(`✅ Removed ${patchPath}`);
+        }
+        else {
+            devkit_1.logger.info('ℹ️ Patch file not found (already removed or never existed)');
+        }
+    }
+    else {
+        devkit_1.logger.info('ℹ️ Patches directory not found');
+    }
+}

package/dist/migrations/3-24-0/update-runtime-logger-call.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Migration: Update runtime logger call from warn to log
+ *
+ * Updates runtime.tsx files to change logger.warn to logger.log
+ * for the missing Kaltura analytics app id message.
+ */
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=update-runtime-logger-call.d.ts.map

package/dist/migrations/3-24-0/update-runtime-logger-call.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-runtime-logger-call.d.ts","sourceRoot":"","sources":["../../../src/migrations/3-24-0/update-runtime-logger-call.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAA6C,MAAM,YAAY,CAAC;AAE7E,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CA0C9D"}

package/dist/migrations/3-24-0/update-runtime-logger-call.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Migration: Update runtime logger call from warn to log
+ *
+ * Updates runtime.tsx files to change logger.warn to logger.log
+ * for the missing Kaltura analytics app id message.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+async function update(tree) {
+    devkit_1.logger.info('🔄 Updating runtime logger calls...');
+    const runtimesDir = 'unisphere/runtimes';
+    if (!tree.exists(runtimesDir)) {
+        devkit_1.logger.info('ℹ️ No runtimes directory found');
+        return;
+    }
+    let updatedCount = 0;
+    // Find all runtime.tsx files
+    (0, devkit_1.visitNotIgnoredFiles)(tree, runtimesDir, (filePath) => {
+        if (filePath.endsWith('/src/lib/runtime.tsx')) {
+            const content = tree.read(filePath, 'utf-8');
+            if (!content) {
+                return;
+            }
+            // Check if the old pattern exists
+            const oldPattern = 'this._logger.warn(`missing kaltura analytics app id, cannot register application to analytics service`)';
+            if (content.includes(oldPattern)) {
+                const newPattern = 'this._logger.log(`missing kaltura analytics app id, skip application registration to analytics service`)';
+                const updatedContent = content.replace(oldPattern, newPattern);
+                tree.write(filePath, updatedContent);
+                updatedCount++;
+                devkit_1.logger.info(`  ✅ Updated ${filePath}`);
+            }
+        }
+    });
+    if (updatedCount === 0) {
+        devkit_1.logger.info('ℹ️ No runtime files found with the old logger pattern');
+    }
+    else {
+        devkit_1.logger.info(`✅ Updated ${updatedCount} runtime file(s)`);
+    }
+    await (0, devkit_1.formatFiles)(tree);
+}

package/migrations.json

@@ -386,6 +386,30 @@
       "cli": {
         "postUpdateMessage": "✅ TypeDoc plugin auto-discovery added to documentation sites. Run 'npm run discover-plugins' inside any docs site to refresh plugins."
       }
+    },
+    "3-24-0-remove-runtime-js-patch": {
+      "version": "3.24.0",
+      "description": "Removes outdated @unisphere+runtime-js patch file",
+      "factory": "./dist/migrations/3-24-0/remove-runtime-js-patch.js",
+      "cli": {
+        "postUpdateMessage": "✅ Outdated @unisphere+runtime-js patch file removed"
+      }
+    },
+    "3-24-0-add-server-runtimes-setup": {
+      "version": "3.24.0",
+      "description": "Adds server runtimes setup to server applications for development overrides",
+      "factory": "./dist/migrations/3-24-0/add-server-runtimes-setup.js",
+      "cli": {
+        "postUpdateMessage": "✅ Server runtimes setup added to server applications"
+      }
+    },
+    "3-24-0-update-runtime-logger-call": {
+      "version": "3.24.0",
+      "description": "Updates runtime logger call from warn to log for missing analytics app id",
+      "factory": "./dist/migrations/3-24-0/update-runtime-logger-call.js",
+      "cli": {
+        "postUpdateMessage": "✅ Runtime logger calls updated"
+      }
     }
   },
   "packageJsonUpdates": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unisphere/nx",
-  "version": "3.23.0",
+  "version": "4.0.0",
   "private": false,
   "main": "./dist/index.js",
   "module": "./dist/index.js",