@unisphere/nx 4.7.0 → 4.9.0

package/dist/generators/add-playground/add-playground.d.ts

@@ -0,0 +1,5 @@
+import { Tree } from '@nx/devkit';
+import { AddPlaygroundGeneratorSchema } from './schema';
+export declare function addPlaygroundGenerator(tree: Tree, options: AddPlaygroundGeneratorSchema): Promise<() => void>;
+export default addPlaygroundGenerator;
+//# sourceMappingURL=add-playground.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add-playground.d.ts","sourceRoot":"","sources":["../../../src/generators/add-playground/add-playground.ts"],"names":[],"mappings":"AAAA,OAAO,EAA8B,IAAI,EAAiB,MAAM,YAAY,CAAC;AAE7E,OAAO,EAAE,4BAA4B,EAAE,MAAM,UAAU,CAAC;AA6CxD,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,4BAA4B,uBAmDtC;AAED,eAAe,sBAAsB,CAAC"}

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

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addPlaygroundGenerator = addPlaygroundGenerator;
+const tslib_1 = require("tslib");
+const devkit_1 = require("@nx/devkit");
+const path = tslib_1.__importStar(require("path"));
+const utils_1 = require("../utils");
+const VALID_ENGINES = ['vanilla-ts', 'vanilla-js', 'react'];
+function validateOptions(options) {
+    if (!options.name || options.name.trim() === '') {
+        throw new Error(`Missing required option: 'name'\n` +
+            `  Description: The name of the playground to create\n` +
+            `  Type: string\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Example: nx g @unisphere/nx:add-playground --name=my-demo --engine=react`);
+    }
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9\-\s]*$/;
+    if (!namePattern.test(options.name)) {
+        throw new Error(`Invalid value '${options.name}' for option 'name'\n` +
+            `  Pattern: ^[a-zA-Z][a-zA-Z0-9\\-\\s]*$\n` +
+            `  Received: ${options.name}`);
+    }
+    if (!options.engine || !VALID_ENGINES.includes(options.engine)) {
+        throw new Error(`Invalid value '${options.engine}' for option 'engine'\n` +
+            `  Allowed values: ${VALID_ENGINES.join(', ')}\n` +
+            `  Example: nx g @unisphere/nx:add-playground --name=demo --engine=react`);
+    }
+    if (options.group) {
+        const groupPattern = /^[a-zA-Z0-9][a-zA-Z0-9\-_/]*$/;
+        if (!groupPattern.test(options.group)) {
+            throw new Error(`Invalid value '${options.group}' for option 'group'\n` +
+                `  Group path must contain only letters, numbers, hyphens, underscores, and forward slashes\n` +
+                `  Example: --group=getting-started or --group=advanced/hooks`);
+        }
+    }
+}
+async function addPlaygroundGenerator(tree, options) {
+    validateOptions(options);
+    // Ensure we're in a valid Unisphere workspace
+    (0, utils_1.validateUnisphereConfig)(tree);
+    const playgroundName = (0, devkit_1.names)(options.name).fileName;
+    const engine = options.engine;
+    // Build target path
+    const groupPath = options.group ? options.group.replace(/^\/|\/$/g, '') : '';
+    const targetDir = groupPath
+        ? `unisphere/playgrounds/${groupPath}/${playgroundName}`
+        : `unisphere/playgrounds/${playgroundName}`;
+    // Check if already exists
+    if (tree.exists(`${targetDir}/playground.json`)) {
+        throw new Error(`Playground already exists at "${targetDir}".\n` +
+            'Please choose a different name or remove the existing playground first.');
+    }
+    // Template variables
+    const templateVars = {
+        ...(0, utils_1.createNameTransforms)(playgroundName, 'playgroundName'),
+        tmpl: '',
+    };
+    // Generate files from engine-specific templates
+    (0, devkit_1.generateFiles)(tree, path.join(__dirname, 'templates', engine), targetDir, templateVars);
+    await (0, devkit_1.formatFiles)(tree);
+    return () => {
+        devkit_1.logger.info('');
+        devkit_1.logger.info('✅ Code playground created successfully!');
+        devkit_1.logger.info('');
+        devkit_1.logger.info(`📁 Location: ${targetDir}`);
+        devkit_1.logger.info(`🔧 Engine: ${engine}`);
+        if (groupPath) {
+            devkit_1.logger.info(`📂 Group: ${groupPath}`);
+        }
+        devkit_1.logger.info('');
+    };
+}
+exports.default = addPlaygroundGenerator;

package/dist/generators/add-playground/schema.d.ts

@@ -0,0 +1,5 @@
+export interface AddPlaygroundGeneratorSchema {
+  name: string;
+  group?: string;
+  engine: 'vanilla-ts' | 'vanilla-js' | 'react';
+}

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

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://json-schema.org/schema",
+  "$id": "AddPlayground",
+  "title": "Add a code playground",
+  "description": "Scaffold a new code playground example",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Playground name (letters, numbers, hyphens, spaces)",
+      "pattern": "^[a-zA-Z][a-zA-Z0-9\\-\\s]*$"
+    },
+    "group": {
+      "type": "string",
+      "description": "Optional group path (e.g., 'getting-started' or 'advanced/hooks')"
+    },
+    "engine": {
+      "type": "string",
+      "description": "Template engine to use",
+      "oneOf": [
+        { "const": "vanilla-ts", "title": "Vanilla TypeScript" },
+        { "const": "vanilla-js", "title": "Vanilla JavaScript" },
+        { "const": "react", "title": "React (TSX)" }
+      ],
+      "default": "vanilla-ts"
+    }
+  },
+  "required": ["name", "engine"]
+}

package/dist/generators/add-playground/templates/react/playground.json.template

@@ -0,0 +1,9 @@
+{
+  "name": "<%= playgroundName__humanReadable %>",
+  "description": "",
+  "dependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "entry": "index.tsx"
+}

package/dist/generators/add-playground/templates/react/src/App.tsx.template

@@ -0,0 +1,5 @@
+import React from 'react';
+
+export function App() {
+  return <h1>Hello from <%= playgroundName__humanReadable %></h1>;
+}

package/dist/generators/add-playground/templates/react/src/index.html.template

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title><%= playgroundName__humanReadable %></title>
+</head>
+<body>
+  <div id="root"></div>
+  <script type="module" src="./index.tsx"></script>
+</body>
+</html>

package/dist/generators/add-playground/templates/react/src/index.tsx.template

@@ -0,0 +1,5 @@
+import React from 'react';
+import { createRoot } from 'react-dom/client';
+import { App } from './App';
+
+createRoot(document.getElementById('root')!).render(<App />);

package/dist/generators/add-playground/templates/vanilla-js/playground.json.template

@@ -0,0 +1,6 @@
+{
+  "name": "<%= playgroundName__humanReadable %>",
+  "description": "",
+  "dependencies": {},
+  "entry": "index.js"
+}

package/dist/generators/add-playground/templates/vanilla-js/src/index.html.template

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title><%= playgroundName__humanReadable %></title>
+</head>
+<body>
+  <div id="app"></div>
+  <script type="module" src="./index.js"></script>
+</body>
+</html>

package/dist/generators/add-playground/templates/vanilla-js/src/index.js.template

@@ -0,0 +1,2 @@
+const app = document.getElementById('app');
+app.innerHTML = '<h1>Hello from <%= playgroundName__humanReadable %></h1>';

package/dist/generators/add-playground/templates/vanilla-ts/playground.json.template

@@ -0,0 +1,6 @@
+{
+  "name": "<%= playgroundName__humanReadable %>",
+  "description": "",
+  "dependencies": {},
+  "entry": "index.ts"
+}

package/dist/generators/add-playground/templates/vanilla-ts/src/index.html.template

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+  <title><%= playgroundName__humanReadable %></title>
+</head>
+<body>
+  <div id="app"></div>
+  <script type="module" src="./index.ts"></script>
+</body>
+</html>

package/dist/generators/add-playground/templates/vanilla-ts/src/index.ts.template

@@ -0,0 +1,2 @@
+const app = document.getElementById('app')!;
+app.innerHTML = '<h1>Hello from <%= playgroundName__humanReadable %></h1>';

package/dist/migrations/4-8-0/restore-security-audit-step.d.ts

@@ -0,0 +1,3 @@
+import { Tree } from '@nx/devkit';
+export default function update(tree: Tree): Promise<void>;
+//# sourceMappingURL=restore-security-audit-step.d.ts.map

package/dist/migrations/4-8-0/restore-security-audit-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restore-security-audit-step.d.ts","sourceRoot":"","sources":["../../../src/migrations/4-8-0/restore-security-audit-step.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAU,MAAM,YAAY,CAAC;AAO1C,wBAA8B,MAAM,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiD9D"}

package/dist/migrations/4-8-0/restore-security-audit-step.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = update;
+const devkit_1 = require("@nx/devkit");
+const AUDIT_STEP = `      - name: Security Audit
+        run: npx unisphere tools audit
+        env:
+          KALTURA_JFROG_TOKEN: \${{ steps.setup-jfrog.outputs.oidc-token }}`;
+async function update(tree) {
+    const cicdPath = '.github/workflows/cicd.yml';
+    if (!tree.exists(cicdPath)) {
+        devkit_1.logger.warn('⚠️ No cicd.yml found, skipping');
+        return;
+    }
+    let content = tree.read(cicdPath, 'utf-8');
+    if (!content) {
+        devkit_1.logger.warn('⚠️ Could not read cicd.yml, skipping');
+        return;
+    }
+    const commentedPattern = /^[ \t]*#\s*- name: Security Audit\s*\n(?:[ \t]*#.*\n)*/m;
+    if (commentedPattern.test(content)) {
+        content = content.replace(commentedPattern, AUDIT_STEP + '\n');
+        tree.write(cicdPath, content);
+        devkit_1.logger.info('✅ Uncommented Security Audit step in cicd.yml');
+        return;
+    }
+    if (content.includes('Security Audit')) {
+        devkit_1.logger.info('ℹ️ Security Audit step already exists in cicd.yml');
+        return;
+    }
+    const installDepsMatch = content.match(/( *- name: Install Dependencies[ \t]*\n(?:.*\n)*?)([ \t]*- name: )/);
+    if (!installDepsMatch) {
+        devkit_1.logger.warn('⚠️ Could not find Install Dependencies step in cicd.yml');
+        throw new Error('Could not find Install Dependencies step in cicd.yml');
+    }
+    const insertIndex = installDepsMatch.index + installDepsMatch[1].length;
+    content =
+        content.slice(0, insertIndex) +
+            '\n' +
+            AUDIT_STEP +
+            '\n\n' +
+            content.slice(insertIndex);
+    tree.write(cicdPath, content);
+    devkit_1.logger.info('✅ Added Security Audit step to cicd.yml');
+}

package/generators.json

@@ -55,6 +55,11 @@
       "factory": "./dist/generators/internal-dev-runner/generator",
       "schema": "./dist/generators/internal-dev-runner/schema.json",
       "description": "Internal-dev-runner - Run a migration for testing purposes (dev only)"
+    },
+    "add-playground": {
+      "factory": "./dist/generators/add-playground/add-playground",
+      "schema": "./dist/generators/add-playground/schema.json",
+      "description": "Add a code playground example"
     }
   }
 }

package/migrations.json

@@ -450,6 +450,14 @@
       "cli": {
         "postUpdateMessage": "✅ GitHub documentation workflow added"
       }
+    },
+    "4-8-0-restore-security-audit-step": {
+      "version": "4.8.0",
+      "description": "Restores Security Audit step in cicd.yml if commented out or missing",
+      "factory": "./dist/migrations/4-8-0/restore-security-audit-step.js",
+      "cli": {
+        "postUpdateMessage": "✅ Security Audit step restored in cicd.yml"
+      }
     }
   },
   "packageJsonUpdates": {
@@ -772,6 +780,17 @@
           "alwaysAddToPackageJson": false
         }
       }
+    },
+    "4.8.0": {
+      "version": "4.8.0",
+      "cli": "nx",
+      "postUpdateMessage": "🎉 Migration to @unisphere/nx 4.8.0 completed successfully!",
+      "packages": {
+        "@unisphere/cli": {
+          "version": "5.2.0",
+          "alwaysAddToPackageJson": false
+        }
+      }
     }
   }
 }

package/package.json

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