@uns-kit/core 2.0.45 → 2.0.48

package/dist/tools/sync-uns-metadata.js

@@ -0,0 +1,468 @@
+#!/usr/bin/env node
+import { access, readFile } from "node:fs/promises";
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { readTextFileIfExists, writeTextFileIfChanged } from "./file-utils.js";
+const isDirectExecution = process.argv[1]
+    ? import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href
+    : false;
+export async function main(argv = process.argv.slice(2)) {
+    const args = await parseArgs(argv);
+    if (args.help) {
+        printHelp();
+        return;
+    }
+    const target = await resolveSyncTarget(args);
+    const document = await fetchMetadataDocument(args.controllerUrl, args.token);
+    const selected = selectedSections(args);
+    const results = [];
+    if (selected.topics) {
+        results.push({
+            label: "Topics TS",
+            results: await updateGeneratedFiles(target.topicsGenerated, renderUnsTopicsTs(readStringArray(document.topics, "topics").map(normalizeTopicPath).filter(Boolean)), target.rootDir, args.dryRun),
+        });
+    }
+    if (selected.tags) {
+        results.push({
+            label: "Tags TS",
+            results: await updateGeneratedFiles(target.tagsGenerated, renderUnsTagsTs(readStringArray(document.tags, "tags")), target.rootDir, args.dryRun),
+        });
+    }
+    if (selected.assets) {
+        results.push({
+            label: "Assets TS",
+            results: await updateGeneratedFiles(target.assetsGenerated, renderUnsAssetsTs(readAssetEntries(document.assets)), target.rootDir, args.dryRun),
+        });
+    }
+    printSummary({
+        controllerUrl: args.controllerUrl,
+        dryRun: args.dryRun,
+        targetLabel: target.label,
+        targetRoot: target.rootDir,
+        results,
+    });
+}
+function selectedSections(args) {
+    const hasSpecificSelection = args.topicsOnly || args.tagsOnly || args.assetsOnly;
+    return {
+        topics: !hasSpecificSelection || args.topicsOnly,
+        tags: !hasSpecificSelection || args.tagsOnly,
+        assets: !hasSpecificSelection || args.assetsOnly,
+    };
+}
+async function getControllerUrlFromConfig() {
+    const configPath = path.join(process.cwd(), "config.json");
+    try {
+        const raw = await readFile(configPath, "utf8");
+        const config = JSON.parse(raw);
+        const restUrl = config.uns?.rest;
+        if (typeof restUrl === "string" && restUrl.trim()) {
+            return restUrl.endsWith("/api") ? restUrl.slice(0, -4) : restUrl;
+        }
+    }
+    catch (error) {
+        // Missing/invalid config.json is handled by the caller.
+    }
+    return undefined;
+}
+async function promptForToken() {
+    return new Promise((resolve) => {
+        const stdin = process.stdin;
+        const wasRaw = stdin.isRaw;
+        stdin.setRawMode(true);
+        stdin.resume();
+        process.stderr.write("Enter controller token: ");
+        let token = "";
+        stdin.on("data", onChar);
+        function onChar(char) {
+            const code = char[0];
+            if (code === 13 || code === 10) {
+                stdin.removeListener("data", onChar);
+                stdin.setRawMode(wasRaw ?? false);
+                stdin.pause();
+                process.stderr.write("\n");
+                resolve(token);
+                return;
+            }
+            if (code === 3) {
+                stdin.removeListener("data", onChar);
+                stdin.setRawMode(wasRaw ?? false);
+                process.stderr.write("\n");
+                process.exit(1);
+            }
+            if (code === 127 || code === 8) {
+                token = token.slice(0, -1);
+            }
+            else if (code >= 32) {
+                token += char.toString("utf8");
+            }
+        }
+    });
+}
+async function parseArgs(argv) {
+    let controllerUrl = process.env.UNS_CONTROLLER_URL?.trim() ?? "";
+    let token = process.env.UNS_CONTROLLER_TOKEN?.trim() ?? "";
+    let projectRoot = process.env.UNS_METADATA_PROJECT_ROOT?.trim() ||
+        process.env.UNS_SCHEMA_PROJECT_ROOT?.trim() ||
+        undefined;
+    let dryRun = false;
+    let topicsOnly = false;
+    let tagsOnly = false;
+    let assetsOnly = false;
+    let help = false;
+    for (let index = 0; index < argv.length; index += 1) {
+        const arg = argv[index];
+        if (arg === "--help" || arg === "-h") {
+            help = true;
+            continue;
+        }
+        if (arg === "--dry-run") {
+            dryRun = true;
+            continue;
+        }
+        if (arg === "--topics-only") {
+            topicsOnly = true;
+            continue;
+        }
+        if (arg === "--tags-only") {
+            tagsOnly = true;
+            continue;
+        }
+        if (arg === "--assets-only") {
+            assetsOnly = true;
+            continue;
+        }
+        if (arg === "--project-root") {
+            projectRoot = readRequiredValue(argv, ++index, "--project-root");
+            continue;
+        }
+        if (arg.startsWith("--project-root=")) {
+            projectRoot = arg.slice("--project-root=".length);
+            continue;
+        }
+        if (arg === "--controller-url") {
+            controllerUrl = readRequiredValue(argv, ++index, "--controller-url");
+            continue;
+        }
+        if (arg.startsWith("--controller-url=")) {
+            controllerUrl = arg.slice("--controller-url=".length);
+            continue;
+        }
+        if (arg === "--token") {
+            token = readRequiredValue(argv, ++index, "--token");
+            continue;
+        }
+        if (arg.startsWith("--token=")) {
+            token = arg.slice("--token=".length);
+            continue;
+        }
+        throw new Error(`Unknown argument: ${arg}`);
+    }
+    if (!controllerUrl) {
+        const configUrl = await getControllerUrlFromConfig();
+        if (configUrl) {
+            controllerUrl = configUrl;
+        }
+    }
+    if (!help) {
+        if (!controllerUrl) {
+            throw new Error("Missing controller URL. Use --controller-url, set UNS_CONTROLLER_URL, or provide config.json with uns.rest.");
+        }
+        if (!token) {
+            if (process.stdin.isTTY) {
+                token = await promptForToken();
+            }
+            if (!token) {
+                throw new Error("Missing controller token. Use --token, set UNS_CONTROLLER_TOKEN, or provide it interactively.");
+            }
+        }
+        if (token.toLowerCase().startsWith("bearer ")) {
+            token = token.slice(7).trim();
+        }
+        controllerUrl = normalizeControllerUrl(controllerUrl);
+        assertValidUrl(controllerUrl);
+    }
+    return {
+        controllerUrl,
+        token,
+        projectRoot,
+        dryRun,
+        topicsOnly,
+        tagsOnly,
+        assetsOnly,
+        help,
+    };
+}
+function readRequiredValue(argv, index, flag) {
+    const value = argv[index];
+    if (!value) {
+        throw new Error(`Missing value for ${flag}.`);
+    }
+    return value;
+}
+function assertValidUrl(value) {
+    try {
+        new URL(value);
+    }
+    catch (error) {
+        throw new Error(`Invalid controller URL "${value}". Expected an absolute URL such as http://localhost:3200.`);
+    }
+}
+function normalizeControllerUrl(value) {
+    return value.replace(/\/+$/, "").replace(/\/api$/i, "");
+}
+function printHelp() {
+    console.log(`Usage: tsx packages/uns-core/src/tools/sync-uns-metadata.ts [options]
+
+Pull UNS metadata from a controller REST export and refresh generated TypeScript
+topic, tag, and asset artifacts.
+
+Options:
+  --controller-url <url>   Controller base URL (env: UNS_CONTROLLER_URL, or config.json > uns.rest)
+  --token <token>          Bearer token with export:uns-reference scope (env: UNS_CONTROLLER_TOKEN)
+  --project-root <dir>     Write into a generated microservice project root (env: UNS_METADATA_PROJECT_ROOT or UNS_SCHEMA_PROJECT_ROOT).
+                           When omitted, the tool auto-detects a generated project from the current working directory
+                           and otherwise updates the uns-kit repo templates.
+  --dry-run                Report file changes without writing anything
+  --topics-only            Refresh only src/uns/uns-topics.ts
+  --tags-only              Refresh only src/uns/uns-tags.ts
+  --assets-only            Refresh only src/uns/uns-assets.ts
+  --help, -h               Show this help
+`);
+}
+async function resolveSyncTarget(args) {
+    if (args.projectRoot) {
+        return buildProjectTarget(path.resolve(process.cwd(), args.projectRoot));
+    }
+    const currentDir = process.cwd();
+    if (await looksLikeGeneratedProjectRoot(currentDir)) {
+        return buildProjectTarget(currentDir);
+    }
+    return buildRepoTarget(await findRepoRoot());
+}
+async function findRepoRoot() {
+    const currentDir = path.dirname(fileURLToPath(import.meta.url));
+    let probeDir = currentDir;
+    while (true) {
+        const packageJsonPath = path.join(probeDir, "package.json");
+        try {
+            const raw = await readFile(packageJsonPath, "utf8");
+            const pkg = JSON.parse(raw);
+            if (pkg.name === "@uns-kit/core") {
+                return path.resolve(probeDir, "../..");
+            }
+        }
+        catch (error) {
+            // Ignore missing package.json and continue walking upward.
+        }
+        const parentDir = path.dirname(probeDir);
+        if (parentDir === probeDir)
+            break;
+        probeDir = parentDir;
+    }
+    throw new Error("Could not locate the @uns-kit/core package directory from sync-uns-metadata.ts.");
+}
+function buildRepoTarget(repoRoot) {
+    return {
+        rootDir: repoRoot,
+        label: "uns-kit repo templates",
+        topicsGenerated: [
+            path.join(repoRoot, "packages/uns-core/src/uns/uns-topics.ts"),
+            path.join(repoRoot, "packages/uns-cli/templates/default/src/uns/uns-topics.ts"),
+        ],
+        tagsGenerated: [
+            path.join(repoRoot, "packages/uns-core/src/uns/uns-tags.ts"),
+            path.join(repoRoot, "packages/uns-cli/templates/default/src/uns/uns-tags.ts"),
+        ],
+        assetsGenerated: [path.join(repoRoot, "packages/uns-cli/templates/default/src/uns/uns-assets.ts")],
+    };
+}
+function buildProjectTarget(projectRoot) {
+    return {
+        rootDir: projectRoot,
+        label: "generated microservice project",
+        topicsGenerated: [path.join(projectRoot, "src/uns/uns-topics.ts")],
+        tagsGenerated: [path.join(projectRoot, "src/uns/uns-tags.ts")],
+        assetsGenerated: [path.join(projectRoot, "src/uns/uns-assets.ts")],
+    };
+}
+async function looksLikeGeneratedProjectRoot(rootDir) {
+    const [hasPackageJson, hasConfigJson, hasUnsDir] = await Promise.all([
+        pathExists(path.join(rootDir, "package.json")),
+        pathExists(path.join(rootDir, "config.json")),
+        pathExists(path.join(rootDir, "src/uns")),
+    ]);
+    return hasPackageJson && hasConfigJson && hasUnsDir;
+}
+async function pathExists(targetPath) {
+    try {
+        await access(targetPath);
+        return true;
+    }
+    catch (error) {
+        return false;
+    }
+}
+function buildControllerUrl(controllerUrl, relativePath) {
+    const base = new URL(controllerUrl);
+    if (!base.pathname.endsWith("/")) {
+        base.pathname = `${base.pathname}/`;
+    }
+    return new URL(relativePath, base);
+}
+async function fetchMetadataDocument(controllerUrl, token) {
+    const url = buildControllerUrl(controllerUrl, "api/schema/export/uns-metadata");
+    const document = await fetchJson(url, token, "UNS metadata");
+    if (!document || typeof document !== "object" || Array.isArray(document)) {
+        throw new Error(`Controller returned an invalid UNS metadata document from ${url.toString()}.`);
+    }
+    return document;
+}
+async function fetchJson(url, token, label) {
+    let response;
+    try {
+        response = await fetch(url, {
+            headers: {
+                Accept: "application/json",
+                Authorization: `Bearer ${token}`,
+            },
+        });
+    }
+    catch (error) {
+        throw new Error(`Network failure while fetching ${label} export from ${url.toString()}: ${error.message}`);
+    }
+    const text = await response.text();
+    if (!response.ok) {
+        throw new Error(formatHttpError(response, url, label, text));
+    }
+    try {
+        return JSON.parse(text);
+    }
+    catch (error) {
+        throw new Error(`Controller returned invalid JSON for the ${label} export from ${url.toString()}.`);
+    }
+}
+function formatHttpError(response, url, label, body) {
+    if (response.status === 401) {
+        return "Token is invalid or expired (401). Provide a valid token via --token, UNS_CONTROLLER_TOKEN, or the interactive prompt.";
+    }
+    if (response.status === 403) {
+        return `Forbidden (403) while fetching ${label} export from ${url.toString()}. The token must be admin or include export:uns-reference.`;
+    }
+    const detail = extractErrorDetail(body);
+    return `Failed to fetch ${label} export from ${url.toString()}: HTTP ${response.status}${detail ? ` - ${detail}` : ""}`;
+}
+function extractErrorDetail(body) {
+    const trimmed = body.trim();
+    if (!trimmed)
+        return "";
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (typeof parsed.error === "string" && parsed.error.trim())
+            return parsed.error.trim();
+        if (typeof parsed.message === "string" && parsed.message.trim())
+            return parsed.message.trim();
+    }
+    catch (error) {
+        // Fall through to plain text handling.
+    }
+    return trimmed.replace(/\s+/g, " ").slice(0, 200);
+}
+function readStringArray(value, label) {
+    if (!Array.isArray(value)) {
+        throw new Error(`UNS metadata export is missing a valid ${label} array.`);
+    }
+    return Array.from(new Set(value.filter((entry) => typeof entry === "string" && entry.trim().length > 0).map(entry => entry.trim()))).sort((left, right) => left.localeCompare(right));
+}
+function readAssetEntries(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error("UNS metadata export is missing a valid assets object.");
+    }
+    return Object.entries(value)
+        .map(([name, metadata]) => ({
+        name: name.trim(),
+        description: typeof metadata?.description === "string" && metadata.description.trim()
+            ? metadata.description.trim()
+            : null,
+    }))
+        .filter(entry => entry.name.length > 0)
+        .sort((left, right) => left.name.localeCompare(right.name));
+}
+function normalizeTopicPath(value) {
+    const normalized = value.trim().replace(/^\/+|\/+$/g, "");
+    return normalized ? `${normalized}/` : "";
+}
+export function renderUnsTopicsTs(topics) {
+    const uniqueTopics = Array.from(new Set(topics.map(normalizeTopicPath).filter(Boolean)))
+        .sort((left, right) => left.localeCompare(right));
+    const members = uniqueTopics.map(topic => `  | ${JSON.stringify(topic)}`).join("\n");
+    return `// Generated UNS topic union. Run \`pnpm run sync-uns-metadata\` to update.\nexport type UnsTopics =\n${members ? `${members}\n` : ""}  | (string & {});\n`;
+}
+export function renderUnsTagsTs(tags) {
+    const uniqueTags = Array.from(new Set(tags.map(tag => tag.trim()).filter(Boolean)))
+        .sort((left, right) => left.localeCompare(right));
+    const members = uniqueTags.map(tag => `  | ${JSON.stringify(tag)}`).join("\n");
+    return `// Generated UNS tag union. Run \`pnpm run sync-uns-metadata\` to update.\nexport type UnsTags =\n${members ? `${members}\n` : ""}  | (string & {});\n`;
+}
+export function renderUnsAssetsTs(assets) {
+    const entries = assets.length
+        ? assets.map((entry) => {
+            const comment = entry.description ? `  /** ${sanitizeComment(entry.description)} */\n` : "";
+            return `${comment}  ${JSON.stringify(entry.name)}: ${JSON.stringify(entry.name)},`;
+        }).join("\n")
+        : `  "asset": "asset",`;
+    const helpers = `
+export function resolveGeneratedAsset(name: keyof typeof GeneratedAssets): (typeof GeneratedAssets)[keyof typeof GeneratedAssets];
+export function resolveGeneratedAsset<T extends string>(name: T): (typeof GeneratedAssets)[keyof typeof GeneratedAssets] | T;
+export function resolveGeneratedAsset(name: string): string {
+  return (GeneratedAssets as Record<string, string>)[name] ?? name;
+}
+`;
+    return `// Generated UNS asset list. Run \`pnpm run sync-uns-metadata\` to update.\nexport const GeneratedAssets = {\n${entries}\n} as const;\nexport type GeneratedAssetName = typeof GeneratedAssets[keyof typeof GeneratedAssets];\n${helpers}`;
+}
+function sanitizeComment(text) {
+    return text.replace(/\*\//g, "*\\/");
+}
+async function updateGeneratedFiles(filePaths, content, rootDir, dryRun) {
+    return Promise.all(filePaths.map((filePath) => updateFile(filePath, content, rootDir, dryRun)));
+}
+async function updateFile(filePath, content, rootDir, dryRun) {
+    const current = await readTextFileIfExists(filePath);
+    const changed = current !== content;
+    const relativePath = path.relative(rootDir, filePath);
+    if (dryRun) {
+        console.log(`${changed ? "Would update" : "No change"} ${relativePath}`);
+        return { changed, relativePath };
+    }
+    if (!changed) {
+        console.log(`Unchanged ${relativePath}`);
+        return { changed: false, relativePath };
+    }
+    await writeTextFileIfChanged(filePath, content);
+    console.log(`Updated ${relativePath}`);
+    return { changed: true, relativePath };
+}
+function printSummary(summary) {
+    console.log("");
+    console.log(summary.dryRun ? "Dry-run summary" : "Sync summary");
+    console.log(`  Controller: ${summary.controllerUrl}`);
+    console.log(`  Target: ${summary.targetLabel}`);
+    console.log(`  Root: ${summary.targetRoot}`);
+    for (const entry of summary.results) {
+        console.log(`  ${entry.label}: ${renderGeneratedSummary(entry.results)}`);
+    }
+}
+function renderGeneratedSummary(results) {
+    if (!results.length)
+        return "none";
+    const changedCount = results.filter((result) => result.changed).length;
+    return `${changedCount}/${results.length} file${results.length === 1 ? "" : "s"} changed`;
+}
+if (isDirectExecution) {
+    main().catch((error) => {
+        console.error("Failed to sync UNS metadata:", error instanceof Error ? error.message : error);
+        process.exitCode = 1;
+    });
+}
+//# sourceMappingURL=sync-uns-metadata.js.map

package/dist/tools/sync-uns-metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-uns-metadata.js","sourceRoot":"","sources":["../../src/tools/sync-uns-metadata.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env node\nimport { access, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport process from \"node:process\";\nimport { fileURLToPath, pathToFileURL } from \"node:url\";\nimport { readTextFileIfExists, writeTextFileIfChanged } from \"./file-utils.js\";\n\ntype MetadataDocument = {\n  schemaVersion?: number;\n  topics?: unknown;\n  tags?: unknown;\n  assets?: unknown;\n};\n\ntype AssetMetadata = {\n  description?: unknown;\n};\n\ntype CliArgs = {\n  controllerUrl: string;\n  token: string;\n  projectRoot?: string;\n  dryRun: boolean;\n  topicsOnly: boolean;\n  tagsOnly: boolean;\n  assetsOnly: boolean;\n  help: boolean;\n};\n\ntype FileChangeResult = {\n  changed: boolean;\n  relativePath: string;\n};\n\ntype SyncTarget = {\n  rootDir: string;\n  label: string;\n  topicsGenerated: string[];\n  tagsGenerated: string[];\n  assetsGenerated: string[];\n};\n\nconst isDirectExecution = process.argv[1]\n  ? import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href\n  : false;\n\nexport async function main(argv = process.argv.slice(2)): Promise<void> {\n  const args = await parseArgs(argv);\n\n  if (args.help) {\n    printHelp();\n    return;\n  }\n\n  const target = await resolveSyncTarget(args);\n  const document = await fetchMetadataDocument(args.controllerUrl, args.token);\n  const selected = selectedSections(args);\n\n  const results: { label: string; results: FileChangeResult[] }[] = [];\n\n  if (selected.topics) {\n    results.push({\n      label: \"Topics TS\",\n      results: await updateGeneratedFiles(\n        target.topicsGenerated,\n        renderUnsTopicsTs(readStringArray(document.topics, \"topics\").map(normalizeTopicPath).filter(Boolean)),\n        target.rootDir,\n        args.dryRun,\n      ),\n    });\n  }\n\n  if (selected.tags) {\n    results.push({\n      label: \"Tags TS\",\n      results: await updateGeneratedFiles(\n        target.tagsGenerated,\n        renderUnsTagsTs(readStringArray(document.tags, \"tags\")),\n        target.rootDir,\n        args.dryRun,\n      ),\n    });\n  }\n\n  if (selected.assets) {\n    results.push({\n      label: \"Assets TS\",\n      results: await updateGeneratedFiles(\n        target.assetsGenerated,\n        renderUnsAssetsTs(readAssetEntries(document.assets)),\n        target.rootDir,\n        args.dryRun,\n      ),\n    });\n  }\n\n  printSummary({\n    controllerUrl: args.controllerUrl,\n    dryRun: args.dryRun,\n    targetLabel: target.label,\n    targetRoot: target.rootDir,\n    results,\n  });\n}\n\nfunction selectedSections(args: CliArgs): { topics: boolean; tags: boolean; assets: boolean } {\n  const hasSpecificSelection = args.topicsOnly || args.tagsOnly || args.assetsOnly;\n  return {\n    topics: !hasSpecificSelection || args.topicsOnly,\n    tags: !hasSpecificSelection || args.tagsOnly,\n    assets: !hasSpecificSelection || args.assetsOnly,\n  };\n}\n\nasync function getControllerUrlFromConfig(): Promise<string | undefined> {\n  const configPath = path.join(process.cwd(), \"config.json\");\n  try {\n    const raw = await readFile(configPath, \"utf8\");\n    const config = JSON.parse(raw) as Record<string, unknown>;\n    const restUrl = (config.uns as Record<string, unknown> | undefined)?.rest;\n    if (typeof restUrl === \"string\" && restUrl.trim()) {\n      return restUrl.endsWith(\"/api\") ? restUrl.slice(0, -4) : restUrl;\n    }\n  } catch (error) {\n    // Missing/invalid config.json is handled by the caller.\n  }\n  return undefined;\n}\n\nasync function promptForToken(): Promise<string> {\n  return new Promise((resolve) => {\n    const stdin = process.stdin;\n    const wasRaw = stdin.isRaw;\n\n    stdin.setRawMode(true);\n    stdin.resume();\n    process.stderr.write(\"Enter controller token: \");\n\n    let token = \"\";\n    stdin.on(\"data\", onChar);\n\n    function onChar(char: Buffer): void {\n      const code = char[0];\n      if (code === 13 || code === 10) {\n        stdin.removeListener(\"data\", onChar);\n        stdin.setRawMode(wasRaw ?? false);\n        stdin.pause();\n        process.stderr.write(\"\\n\");\n        resolve(token);\n        return;\n      }\n      if (code === 3) {\n        stdin.removeListener(\"data\", onChar);\n        stdin.setRawMode(wasRaw ?? false);\n        process.stderr.write(\"\\n\");\n        process.exit(1);\n      }\n      if (code === 127 || code === 8) {\n        token = token.slice(0, -1);\n      } else if (code >= 32) {\n        token += char.toString(\"utf8\");\n      }\n    }\n  });\n}\n\nasync function parseArgs(argv: string[]): Promise<CliArgs> {\n  let controllerUrl = process.env.UNS_CONTROLLER_URL?.trim() ?? \"\";\n  let token = process.env.UNS_CONTROLLER_TOKEN?.trim() ?? \"\";\n  let projectRoot =\n    process.env.UNS_METADATA_PROJECT_ROOT?.trim() ||\n    process.env.UNS_SCHEMA_PROJECT_ROOT?.trim() ||\n    undefined;\n  let dryRun = false;\n  let topicsOnly = false;\n  let tagsOnly = false;\n  let assetsOnly = false;\n  let help = false;\n\n  for (let index = 0; index < argv.length; index += 1) {\n    const arg = argv[index];\n\n    if (arg === \"--help\" || arg === \"-h\") {\n      help = true;\n      continue;\n    }\n    if (arg === \"--dry-run\") {\n      dryRun = true;\n      continue;\n    }\n    if (arg === \"--topics-only\") {\n      topicsOnly = true;\n      continue;\n    }\n    if (arg === \"--tags-only\") {\n      tagsOnly = true;\n      continue;\n    }\n    if (arg === \"--assets-only\") {\n      assetsOnly = true;\n      continue;\n    }\n    if (arg === \"--project-root\") {\n      projectRoot = readRequiredValue(argv, ++index, \"--project-root\");\n      continue;\n    }\n    if (arg.startsWith(\"--project-root=\")) {\n      projectRoot = arg.slice(\"--project-root=\".length);\n      continue;\n    }\n    if (arg === \"--controller-url\") {\n      controllerUrl = readRequiredValue(argv, ++index, \"--controller-url\");\n      continue;\n    }\n    if (arg.startsWith(\"--controller-url=\")) {\n      controllerUrl = arg.slice(\"--controller-url=\".length);\n      continue;\n    }\n    if (arg === \"--token\") {\n      token = readRequiredValue(argv, ++index, \"--token\");\n      continue;\n    }\n    if (arg.startsWith(\"--token=\")) {\n      token = arg.slice(\"--token=\".length);\n      continue;\n    }\n\n    throw new Error(`Unknown argument: ${arg}`);\n  }\n\n  if (!controllerUrl) {\n    const configUrl = await getControllerUrlFromConfig();\n    if (configUrl) {\n      controllerUrl = configUrl;\n    }\n  }\n\n  if (!help) {\n    if (!controllerUrl) {\n      throw new Error(\"Missing controller URL. Use --controller-url, set UNS_CONTROLLER_URL, or provide config.json with uns.rest.\");\n    }\n    if (!token) {\n      if (process.stdin.isTTY) {\n        token = await promptForToken();\n      }\n      if (!token) {\n        throw new Error(\"Missing controller token. Use --token, set UNS_CONTROLLER_TOKEN, or provide it interactively.\");\n      }\n    }\n    if (token.toLowerCase().startsWith(\"bearer \")) {\n      token = token.slice(7).trim();\n    }\n    controllerUrl = normalizeControllerUrl(controllerUrl);\n    assertValidUrl(controllerUrl);\n  }\n\n  return {\n    controllerUrl,\n    token,\n    projectRoot,\n    dryRun,\n    topicsOnly,\n    tagsOnly,\n    assetsOnly,\n    help,\n  };\n}\n\nfunction readRequiredValue(argv: string[], index: number, flag: string): string {\n  const value = argv[index];\n  if (!value) {\n    throw new Error(`Missing value for ${flag}.`);\n  }\n  return value;\n}\n\nfunction assertValidUrl(value: string): void {\n  try {\n    new URL(value);\n  } catch (error) {\n    throw new Error(`Invalid controller URL \"${value}\". Expected an absolute URL such as http://localhost:3200.`);\n  }\n}\n\nfunction normalizeControllerUrl(value: string): string {\n  return value.replace(/\\/+$/, \"\").replace(/\\/api$/i, \"\");\n}\n\nfunction printHelp(): void {\n  console.log(`Usage: tsx packages/uns-core/src/tools/sync-uns-metadata.ts [options]\n\nPull UNS metadata from a controller REST export and refresh generated TypeScript\ntopic, tag, and asset artifacts.\n\nOptions:\n  --controller-url <url>   Controller base URL (env: UNS_CONTROLLER_URL, or config.json > uns.rest)\n  --token <token>          Bearer token with export:uns-reference scope (env: UNS_CONTROLLER_TOKEN)\n  --project-root <dir>     Write into a generated microservice project root (env: UNS_METADATA_PROJECT_ROOT or UNS_SCHEMA_PROJECT_ROOT).\n                           When omitted, the tool auto-detects a generated project from the current working directory\n                           and otherwise updates the uns-kit repo templates.\n  --dry-run                Report file changes without writing anything\n  --topics-only            Refresh only src/uns/uns-topics.ts\n  --tags-only              Refresh only src/uns/uns-tags.ts\n  --assets-only            Refresh only src/uns/uns-assets.ts\n  --help, -h               Show this help\n`);\n}\n\nasync function resolveSyncTarget(args: CliArgs): Promise<SyncTarget> {\n  if (args.projectRoot) {\n    return buildProjectTarget(path.resolve(process.cwd(), args.projectRoot));\n  }\n\n  const currentDir = process.cwd();\n  if (await looksLikeGeneratedProjectRoot(currentDir)) {\n    return buildProjectTarget(currentDir);\n  }\n\n  return buildRepoTarget(await findRepoRoot());\n}\n\nasync function findRepoRoot(): Promise<string> {\n  const currentDir = path.dirname(fileURLToPath(import.meta.url));\n  let probeDir = currentDir;\n\n  while (true) {\n    const packageJsonPath = path.join(probeDir, \"package.json\");\n    try {\n      const raw = await readFile(packageJsonPath, \"utf8\");\n      const pkg = JSON.parse(raw) as { name?: string };\n      if (pkg.name === \"@uns-kit/core\") {\n        return path.resolve(probeDir, \"../..\");\n      }\n    } catch (error) {\n      // Ignore missing package.json and continue walking upward.\n    }\n\n    const parentDir = path.dirname(probeDir);\n    if (parentDir === probeDir) break;\n    probeDir = parentDir;\n  }\n\n  throw new Error(\"Could not locate the @uns-kit/core package directory from sync-uns-metadata.ts.\");\n}\n\nfunction buildRepoTarget(repoRoot: string): SyncTarget {\n  return {\n    rootDir: repoRoot,\n    label: \"uns-kit repo templates\",\n    topicsGenerated: [\n      path.join(repoRoot, \"packages/uns-core/src/uns/uns-topics.ts\"),\n      path.join(repoRoot, \"packages/uns-cli/templates/default/src/uns/uns-topics.ts\"),\n    ],\n    tagsGenerated: [\n      path.join(repoRoot, \"packages/uns-core/src/uns/uns-tags.ts\"),\n      path.join(repoRoot, \"packages/uns-cli/templates/default/src/uns/uns-tags.ts\"),\n    ],\n    assetsGenerated: [path.join(repoRoot, \"packages/uns-cli/templates/default/src/uns/uns-assets.ts\")],\n  };\n}\n\nfunction buildProjectTarget(projectRoot: string): SyncTarget {\n  return {\n    rootDir: projectRoot,\n    label: \"generated microservice project\",\n    topicsGenerated: [path.join(projectRoot, \"src/uns/uns-topics.ts\")],\n    tagsGenerated: [path.join(projectRoot, \"src/uns/uns-tags.ts\")],\n    assetsGenerated: [path.join(projectRoot, \"src/uns/uns-assets.ts\")],\n  };\n}\n\nasync function looksLikeGeneratedProjectRoot(rootDir: string): Promise<boolean> {\n  const [hasPackageJson, hasConfigJson, hasUnsDir] = await Promise.all([\n    pathExists(path.join(rootDir, \"package.json\")),\n    pathExists(path.join(rootDir, \"config.json\")),\n    pathExists(path.join(rootDir, \"src/uns\")),\n  ]);\n\n  return hasPackageJson && hasConfigJson && hasUnsDir;\n}\n\nasync function pathExists(targetPath: string): Promise<boolean> {\n  try {\n    await access(targetPath);\n    return true;\n  } catch (error) {\n    return false;\n  }\n}\n\nfunction buildControllerUrl(controllerUrl: string, relativePath: string): URL {\n  const base = new URL(controllerUrl);\n  if (!base.pathname.endsWith(\"/\")) {\n    base.pathname = `${base.pathname}/`;\n  }\n  return new URL(relativePath, base);\n}\n\nasync function fetchMetadataDocument(controllerUrl: string, token: string): Promise<MetadataDocument> {\n  const url = buildControllerUrl(controllerUrl, \"api/schema/export/uns-metadata\");\n  const document = await fetchJson(url, token, \"UNS metadata\");\n  if (!document || typeof document !== \"object\" || Array.isArray(document)) {\n    throw new Error(`Controller returned an invalid UNS metadata document from ${url.toString()}.`);\n  }\n  return document as MetadataDocument;\n}\n\nasync function fetchJson(url: URL, token: string, label: string): Promise<unknown> {\n  let response: Response;\n\n  try {\n    response = await fetch(url, {\n      headers: {\n        Accept: \"application/json\",\n        Authorization: `Bearer ${token}`,\n      },\n    });\n  } catch (error) {\n    throw new Error(`Network failure while fetching ${label} export from ${url.toString()}: ${(error as Error).message}`);\n  }\n\n  const text = await response.text();\n  if (!response.ok) {\n    throw new Error(formatHttpError(response, url, label, text));\n  }\n\n  try {\n    return JSON.parse(text);\n  } catch (error) {\n    throw new Error(`Controller returned invalid JSON for the ${label} export from ${url.toString()}.`);\n  }\n}\n\nfunction formatHttpError(response: Response, url: URL, label: string, body: string): string {\n  if (response.status === 401) {\n    return \"Token is invalid or expired (401). Provide a valid token via --token, UNS_CONTROLLER_TOKEN, or the interactive prompt.\";\n  }\n  if (response.status === 403) {\n    return `Forbidden (403) while fetching ${label} export from ${url.toString()}. The token must be admin or include export:uns-reference.`;\n  }\n\n  const detail = extractErrorDetail(body);\n  return `Failed to fetch ${label} export from ${url.toString()}: HTTP ${response.status}${detail ? ` - ${detail}` : \"\"}`;\n}\n\nfunction extractErrorDetail(body: string): string {\n  const trimmed = body.trim();\n  if (!trimmed) return \"\";\n\n  try {\n    const parsed = JSON.parse(trimmed) as { error?: unknown; message?: unknown };\n    if (typeof parsed.error === \"string\" && parsed.error.trim()) return parsed.error.trim();\n    if (typeof parsed.message === \"string\" && parsed.message.trim()) return parsed.message.trim();\n  } catch (error) {\n    // Fall through to plain text handling.\n  }\n\n  return trimmed.replace(/\\s+/g, \" \").slice(0, 200);\n}\n\nfunction readStringArray(value: unknown, label: string): string[] {\n  if (!Array.isArray(value)) {\n    throw new Error(`UNS metadata export is missing a valid ${label} array.`);\n  }\n  return Array.from(\n    new Set(value.filter((entry): entry is string => typeof entry === \"string\" && entry.trim().length > 0).map(entry => entry.trim())),\n  ).sort((left, right) => left.localeCompare(right));\n}\n\nfunction readAssetEntries(value: unknown): Array<{ name: string; description: string | null }> {\n  if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new Error(\"UNS metadata export is missing a valid assets object.\");\n  }\n\n  return Object.entries(value as Record<string, AssetMetadata>)\n    .map(([name, metadata]) => ({\n      name: name.trim(),\n      description: typeof metadata?.description === \"string\" && metadata.description.trim()\n        ? metadata.description.trim()\n        : null,\n    }))\n    .filter(entry => entry.name.length > 0)\n    .sort((left, right) => left.name.localeCompare(right.name));\n}\n\nfunction normalizeTopicPath(value: string): string {\n  const normalized = value.trim().replace(/^\\/+|\\/+$/g, \"\");\n  return normalized ? `${normalized}/` : \"\";\n}\n\nexport function renderUnsTopicsTs(topics: string[]): string {\n  const uniqueTopics = Array.from(new Set(topics.map(normalizeTopicPath).filter(Boolean)))\n    .sort((left, right) => left.localeCompare(right));\n  const members = uniqueTopics.map(topic => `  | ${JSON.stringify(topic)}`).join(\"\\n\");\n  return `// Generated UNS topic union. Run \\`pnpm run sync-uns-metadata\\` to update.\\nexport type UnsTopics =\\n${members ? `${members}\\n` : \"\"}  | (string & {});\\n`;\n}\n\nexport function renderUnsTagsTs(tags: string[]): string {\n  const uniqueTags = Array.from(new Set(tags.map(tag => tag.trim()).filter(Boolean)))\n    .sort((left, right) => left.localeCompare(right));\n  const members = uniqueTags.map(tag => `  | ${JSON.stringify(tag)}`).join(\"\\n\");\n  return `// Generated UNS tag union. Run \\`pnpm run sync-uns-metadata\\` to update.\\nexport type UnsTags =\\n${members ? `${members}\\n` : \"\"}  | (string & {});\\n`;\n}\n\nexport function renderUnsAssetsTs(assets: Array<{ name: string; description: string | null }>): string {\n  const entries = assets.length\n    ? assets.map((entry) => {\n        const comment = entry.description ? `  /** ${sanitizeComment(entry.description)} */\\n` : \"\";\n        return `${comment}  ${JSON.stringify(entry.name)}: ${JSON.stringify(entry.name)},`;\n      }).join(\"\\n\")\n    : `  \"asset\": \"asset\",`;\n\n  const helpers = `\nexport function resolveGeneratedAsset(name: keyof typeof GeneratedAssets): (typeof GeneratedAssets)[keyof typeof GeneratedAssets];\nexport function resolveGeneratedAsset<T extends string>(name: T): (typeof GeneratedAssets)[keyof typeof GeneratedAssets] | T;\nexport function resolveGeneratedAsset(name: string): string {\n  return (GeneratedAssets as Record<string, string>)[name] ?? name;\n}\n`;\n\n  return `// Generated UNS asset list. Run \\`pnpm run sync-uns-metadata\\` to update.\\nexport const GeneratedAssets = {\\n${entries}\\n} as const;\\nexport type GeneratedAssetName = typeof GeneratedAssets[keyof typeof GeneratedAssets];\\n${helpers}`;\n}\n\nfunction sanitizeComment(text: string): string {\n  return text.replace(/\\*\\//g, \"*\\\\/\");\n}\n\nasync function updateGeneratedFiles(\n  filePaths: string[],\n  content: string,\n  rootDir: string,\n  dryRun: boolean,\n): Promise<FileChangeResult[]> {\n  return Promise.all(filePaths.map((filePath) => updateFile(filePath, content, rootDir, dryRun)));\n}\n\nasync function updateFile(\n  filePath: string,\n  content: string,\n  rootDir: string,\n  dryRun: boolean,\n): Promise<FileChangeResult> {\n  const current = await readTextFileIfExists(filePath);\n  const changed = current !== content;\n  const relativePath = path.relative(rootDir, filePath);\n\n  if (dryRun) {\n    console.log(`${changed ? \"Would update\" : \"No change\"} ${relativePath}`);\n    return { changed, relativePath };\n  }\n\n  if (!changed) {\n    console.log(`Unchanged ${relativePath}`);\n    return { changed: false, relativePath };\n  }\n\n  await writeTextFileIfChanged(filePath, content);\n  console.log(`Updated ${relativePath}`);\n  return { changed: true, relativePath };\n}\n\nfunction printSummary(summary: {\n  controllerUrl: string;\n  targetLabel: string;\n  targetRoot: string;\n  dryRun: boolean;\n  results: { label: string; results: FileChangeResult[] }[];\n}): void {\n  console.log(\"\");\n  console.log(summary.dryRun ? \"Dry-run summary\" : \"Sync summary\");\n  console.log(`  Controller: ${summary.controllerUrl}`);\n  console.log(`  Target: ${summary.targetLabel}`);\n  console.log(`  Root: ${summary.targetRoot}`);\n  for (const entry of summary.results) {\n    console.log(`  ${entry.label}: ${renderGeneratedSummary(entry.results)}`);\n  }\n}\n\nfunction renderGeneratedSummary(results: FileChangeResult[]): string {\n  if (!results.length) return \"none\";\n  const changedCount = results.filter((result) => result.changed).length;\n  return `${changedCount}/${results.length} file${results.length === 1 ? \"\" : \"s\"} changed`;\n}\n\nif (isDirectExecution) {\n  main().catch((error) => {\n    console.error(\"Failed to sync UNS metadata:\", error instanceof Error ? error.message : error);\n    process.exitCode = 1;\n  });\n}\n"]}

package/dist/tools/sync-uns-schema.js

@@ -211,6 +211,7 @@ async function parseArgs(argv) {
         if (token.toLowerCase().startsWith("bearer ")) {
             token = token.slice(7).trim();
         }
+        controllerUrl = normalizeControllerUrl(controllerUrl);
         assertValidUrl(controllerUrl);
     }
     return {
@@ -249,24 +250,27 @@ function assertValidUrl(value) {
         throw new Error(`Invalid controller URL "${value}". Expected an absolute URL such as http://localhost:3200.`);
     }
 }
+function normalizeControllerUrl(value) {
+    return value.replace(/\/+$/, "").replace(/\/api$/i, "");
+}
 function printHelp() {
-    console.log(`Usage: tsx packages/uns-core/src/tools/sync-uns-schema.ts [options]
-
-Pull the canonical UNS schema export from a controller and refresh the local
-JSON files plus generated TypeScript artifacts.
-
-Options:
-  --controller-url <url>   Controller base URL (env: UNS_CONTROLLER_URL, or config.json > uns.rest)
-  --token <token>          Bearer token for REST export (env: UNS_CONTROLLER_TOKEN)
-  --status <value>         Dictionary status filter: ${STATUS_VALUES.join("|")} (default: ${DEFAULT_STATUS}, env: UNS_SCHEMA_STATUS)
-  --project-root <dir>     Write into a generated microservice project root (env: UNS_SCHEMA_PROJECT_ROOT).
-                           When omitted, the tool auto-detects a generated project from the current working directory
-                           and otherwise updates the uns-kit repo templates.
-  --dry-run                Report file changes without writing anything
-  --dictionary-only        Sync only the UNS dictionary export
-  --measurements-only      Sync only the UNS measurements export
-  --skip-generate          Skip generated TypeScript refresh
-  --help, -h               Show this help
+    console.log(`Usage: tsx packages/uns-core/src/tools/sync-uns-schema.ts [options]
+
+Pull the canonical UNS schema export from a controller and refresh the local
+JSON files plus generated TypeScript artifacts.
+
+Options:
+  --controller-url <url>   Controller base URL (env: UNS_CONTROLLER_URL, or config.json > uns.rest)
+  --token <token>          Bearer token for REST export (env: UNS_CONTROLLER_TOKEN)
+  --status <value>         Dictionary status filter: ${STATUS_VALUES.join("|")} (default: ${DEFAULT_STATUS}, env: UNS_SCHEMA_STATUS)
+  --project-root <dir>     Write into a generated microservice project root (env: UNS_SCHEMA_PROJECT_ROOT).
+                           When omitted, the tool auto-detects a generated project from the current working directory
+                           and otherwise updates the uns-kit repo templates.
+  --dry-run                Report file changes without writing anything
+  --dictionary-only        Sync only the UNS dictionary export
+  --measurements-only      Sync only the UNS measurements export
+  --skip-generate          Skip generated TypeScript refresh
+  --help, -h               Show this help
 `);
 }
 async function findRepoRoot() {