@uns-kit/cli 0.0.61 → 0.0.63

package/README.md

@@ -46,7 +46,8 @@ When `git` is available on your PATH the scaffold also initializes a fresh repos
 ## Commands
 
 - `uns-kit create <name>` – create a new UNS project in the specified directory.
-- `uns-kit configure [path] [features...]` – run multiple configure templates in sequence (`--all` applies every template).
+- `uns-kit configure [path] [features...]` – run multiple configure templates in sequence (`--all`, `--overwrite`).
+- `uns-kit configure-templates [path] [templates...]` – copy any template directory (`--all`, `--overwrite`).
 - `uns-kit configure-devops [path]` – add Azure DevOps tooling (dependencies, script, config) to an existing project.
 - `uns-kit configure-vscode [path]` – copy VS Code launch/workspace files into an existing project.
 - `uns-kit configure-codegen [path]` – scaffold GraphQL code generation and UNS refresh scripts.
@@ -65,7 +66,16 @@ uns-kit configure --all
 uns-kit configure ./apps/gateway devops vscode codegen
 ```
 
-Mix and match feature names after an optional target directory. Use `--all` to apply every available template in one shot.
+Mix and match feature names after an optional target directory. Use `--all` to apply every available template in one shot. Add `--overwrite` to refresh files from newer template versions.
+
+### Copy arbitrary templates
+
+Need a template that is not wired into a configure feature (or added in a newer release)? Use:
+
+```bash
+uns-kit configure-templates --all
+uns-kit configure-templates ./apps/gateway uns-dictionary uns-measurements --overwrite
+```
 
 ### Configure Azure DevOps
 
@@ -85,7 +95,7 @@ The command prompts for your Azure DevOps organization/project, ensures the remo
 uns-kit configure-vscode
 ```
 
-Copies `.vscode/launch.json` plus a baseline workspace file into the project. Existing files are never overwritten, making it safe to re-run after hand edits.
+Copies `.vscode/launch.json` plus a baseline workspace file into the project. Existing files are skipped unless you pass `--overwrite`.
 
 ### Configure GraphQL code generation
 
@@ -106,6 +116,7 @@ pnpm install
 ```
 
 Copies API-oriented examples (under `src/examples/`) and adds `@uns-kit/api` to your project dependencies.
+Use `--overwrite` to refresh the examples after updating `uns-kit`.
 
 ### Add cron-based scaffolding
 
@@ -115,6 +126,7 @@ pnpm install
 ```
 
 Adds cron-oriented example stubs and installs `@uns-kit/cron`.
+Use `--overwrite` to refresh the examples after updating `uns-kit`.
 
 ### Add Temporal scaffolding
 
@@ -124,6 +136,7 @@ pnpm install
 ```
 
 Copies Temporal example placeholders and installs `@uns-kit/temporal`.
+Use `--overwrite` to refresh the examples after updating `uns-kit`.
 
 ### Add Python gateway scaffolding
 
@@ -132,6 +145,7 @@ uns-kit configure-python
 ```
 
 Copies the Python gateway client template (examples, scripts, requirements, proto) into your project so you can iterate on the gRPC gateway from Python alongside your TypeScript project.
+Use `--overwrite` to refresh the examples after updating `uns-kit`.
 
 ### Extend the Config Schema
 

package/dist/index.js

@@ -24,9 +24,9 @@ async function main() {
         return;
     }
     if (command === "configure-config") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureConfigFiles(targetPath);
+            await configureConfigFiles(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -45,10 +45,21 @@ async function main() {
         }
         return;
     }
+    if (command === "configure-templates") {
+        const configureArgs = args.slice(1);
+        try {
+            await runConfigureTemplatesCommand(configureArgs);
+        }
+        catch (error) {
+            console.error(error.message);
+            process.exitCode = 1;
+        }
+        return;
+    }
     if (command === "configure-devops") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureDevops(targetPath);
+            await configureDevops(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -57,9 +68,9 @@ async function main() {
         return;
     }
     if (command === "configure-vscode") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureVscode(targetPath);
+            await configureVscode(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -68,9 +79,9 @@ async function main() {
         return;
     }
     if (command === "configure-codegen") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureCodegen(targetPath);
+            await configureCodegen(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -79,9 +90,9 @@ async function main() {
         return;
     }
     if (command === "configure-api") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureApi(targetPath);
+            await configureApi(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -90,9 +101,9 @@ async function main() {
         return;
     }
     if (command === "configure-cron") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureCron(targetPath);
+            await configureCron(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -101,9 +112,9 @@ async function main() {
         return;
     }
     if (command === "configure-temporal") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureTemporal(targetPath);
+            await configureTemporal(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -112,9 +123,9 @@ async function main() {
         return;
     }
     if (command === "configure-python") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configurePython(targetPath);
+            await configurePython(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -123,9 +134,9 @@ async function main() {
         return;
     }
     if (command === "configure-uns-reference") {
-        const targetPath = args[1];
+        const { targetPath, overwrite } = parseTemplateCommandArgs(args.slice(1));
         try {
-            await configureUnsReference(targetPath);
+            await configureUnsReference(targetPath, { overwrite });
         }
         catch (error) {
             console.error(error.message);
@@ -158,7 +169,8 @@ function printHelp() {
         "\nUsage: uns-kit <command> [options]\n" +
         "\nCommands:\n" +
         "  create <name>           Scaffold a new UNS application\n" +
-        "  configure [dir] [features...] Configure multiple templates (--all for everything)\n" +
+        "  configure [dir] [features...] Configure multiple templates (--all, --overwrite)\n" +
+        "  configure-templates [dir] [templates...] Copy any template directory (--all, --overwrite)\n" +
         "  configure-config [dir]  Copy configuration example files\n" +
         "  configure-devops [dir]  Configure Azure DevOps tooling in an existing project\n" +
         "  configure-vscode [dir]  Add VS Code workspace configuration files\n" +
@@ -235,7 +247,7 @@ async function initGitRepository(targetDir) {
         return false;
     }
 }
-async function configureDevops(targetPath) {
+async function configureDevops(targetPath, options) {
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
     const packagePath = path.join(targetDir, "package.json");
     const configPath = path.join(targetDir, "config.json");
@@ -330,9 +342,16 @@ async function configureDevops(targetPath) {
         throw new Error("Azure Pipelines template is missing. Please ensure templates/azure-pipelines.yml exists.");
     }
     const pipelineTargetPath = path.join(targetDir, "azure-pipelines.yml");
+    const overwrite = !!options?.overwrite;
     let pipelineMessage = "";
     if (await fileExists(pipelineTargetPath)) {
-        pipelineMessage = "  azure-pipelines.yml already exists (skipped).";
+        if (overwrite) {
+            await copyFile(azurePipelineTemplatePath, pipelineTargetPath);
+            pipelineMessage = "  Overwrote azure-pipelines.yml pipeline definition.";
+        }
+        else {
+            pipelineMessage = "  azure-pipelines.yml already exists (skipped).";
+        }
     }
     else {
         await copyFile(azurePipelineTemplatePath, pipelineTargetPath);
@@ -362,7 +381,7 @@ async function configureDevops(targetPath) {
         console.log("  Existing package.json already contained required entries.");
     }
 }
-async function configureVscode(targetPath) {
+async function configureVscode(targetPath, options = {}) {
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
     const templateDir = path.resolve(__dirname, "../templates/vscode");
     try {
@@ -371,7 +390,7 @@ async function configureVscode(targetPath) {
     catch (error) {
         throw new Error("VS Code template directory is missing. Please ensure templates/vscode is available.");
     }
-    const { copied, skipped } = await copyTemplateDirectory(templateDir, targetDir, targetDir);
+    const { copied, skipped, overwritten } = await copyTemplateDirectory(templateDir, targetDir, targetDir, options);
     console.log("\nVS Code configuration files processed.");
     if (copied.length) {
         console.log("  Added:");
@@ -379,6 +398,12 @@ async function configureVscode(targetPath) {
             console.log(`    ${file}`);
         }
     }
+    if (overwritten.length) {
+        console.log("  Overwritten:");
+        for (const file of overwritten) {
+            console.log(`    ${file}`);
+        }
+    }
     if (skipped.length) {
         console.log("  Skipped (already exists):");
         for (const file of skipped) {
@@ -389,7 +414,7 @@ async function configureVscode(targetPath) {
         console.log("  No files were found in the VS Code template directory.");
     }
 }
-async function configureConfigFiles(targetPath) {
+async function configureConfigFiles(targetPath, options = {}) {
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
     const templateDir = path.resolve(__dirname, "../templates/config-files");
     try {
@@ -398,8 +423,8 @@ async function configureConfigFiles(targetPath) {
     catch (error) {
         throw new Error("Configuration template directory is missing. Please ensure templates/config-files is available.");
     }
-    const { copied, skipped } = await copyTemplateDirectory(templateDir, targetDir, targetDir);
-    const configFilesToAdjust = copied.filter((file) => {
+    const { copied, skipped, overwritten } = await copyTemplateDirectory(templateDir, targetDir, targetDir, options);
+    const configFilesToAdjust = [...copied, ...overwritten].filter((file) => {
         const filename = path.basename(file);
         return filename.toLowerCase().startsWith("config") && filename.toLowerCase().endsWith(".json");
     });
@@ -413,6 +438,12 @@ async function configureConfigFiles(targetPath) {
             console.log(`    ${file}`);
         }
     }
+    if (overwritten.length) {
+        console.log("  Overwritten:");
+        for (const file of overwritten) {
+            console.log(`    ${file}`);
+        }
+    }
     if (skipped.length) {
         console.log("  Skipped (already exists):");
         for (const file of skipped) {
@@ -436,7 +467,7 @@ async function applyConfigTemplatePlaceholders(targetDir, relativePaths) {
         await replaceConfigTemplatePlaceholders(absolutePath, replacements, packageName);
     }
 }
-async function configureCodegen(targetPath) {
+async function configureCodegen(targetPath, options = {}) {
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
     const templateDir = path.resolve(__dirname, "../templates/codegen");
     const packagePath = path.join(targetDir, "package.json");
@@ -457,7 +488,7 @@ async function configureCodegen(targetPath) {
         throw error;
     }
     const pkg = JSON.parse(pkgRaw);
-    const { copied, skipped } = await copyTemplateDirectory(templateDir, targetDir, targetDir);
+    const { copied, skipped, overwritten } = await copyTemplateDirectory(templateDir, targetDir, targetDir, options);
     const devDeps = (pkg.devDependencies ??= {});
     const deps = pkg.dependencies ?? {};
     const requiredDevDeps = {
@@ -499,6 +530,12 @@ async function configureCodegen(targetPath) {
             console.log(`    ${file}`);
         }
     }
+    if (overwritten.length) {
+        console.log("  Overwritten files:");
+        for (const file of overwritten) {
+            console.log(`    ${file}`);
+        }
+    }
     if (skipped.length) {
         console.log("  Skipped existing files:");
         for (const file of skipped) {
@@ -515,50 +552,56 @@ async function configureCodegen(targetPath) {
         console.log("  Existing package.json already contained required scripts and dependencies.");
     }
 }
-async function configureApi(targetPath) {
+async function configureApi(targetPath, options = {}) {
     await configurePlugin({
         targetPath,
         templateName: "api",
         dependencyName: "@uns-kit/api",
         dependencySpecifier: resolveUnsPackageSpecifier("@uns-kit/api", "../../uns-api/package.json"),
         label: "UNS API",
+        overwrite: options.overwrite,
     });
 }
-async function configureCron(targetPath) {
+async function configureCron(targetPath, options = {}) {
     await configurePlugin({
         targetPath,
         templateName: "cron",
         dependencyName: "@uns-kit/cron",
         dependencySpecifier: resolveUnsPackageSpecifier("@uns-kit/cron", "../../uns-cron/package.json"),
         label: "UNS cron",
+        overwrite: options.overwrite,
     });
 }
-async function configureTemporal(targetPath) {
+async function configureTemporal(targetPath, options = {}) {
     await configurePlugin({
         targetPath,
         templateName: "temporal",
         dependencyName: "@uns-kit/temporal",
         dependencySpecifier: resolveUnsPackageSpecifier("@uns-kit/temporal", "../../uns-temporal/package.json"),
         label: "UNS Temporal",
+        overwrite: options.overwrite,
     });
 }
-async function configurePython(targetPath) {
+async function configurePython(targetPath, options = {}) {
     await configurePlugin({
         targetPath,
         templateName: "python",
         label: "UNS Python client",
+        overwrite: options.overwrite,
     });
 }
-async function configureUnsReference(targetPath) {
+async function configureUnsReference(targetPath, options = {}) {
     await configurePlugin({
         targetPath,
         templateName: "uns-dictionary",
         label: "UNS dictionary (object/attribute metadata)",
+        overwrite: options.overwrite,
     });
     await configurePlugin({
         targetPath,
         templateName: "uns-measurements",
         label: "UNS measurements (units)",
+        overwrite: options.overwrite,
     });
 }
 const configureFeatureHandlers = {
@@ -585,7 +628,7 @@ const configureFeatureLabels = {
     "uns-reference": "UNS dictionaries (objects/attributes/measurements)",
 };
 async function runConfigureCommand(args) {
-    const { targetPath, features } = parseConfigureArgs(args);
+    const { targetPath, features, overwrite } = parseConfigureArgs(args);
     if (!features.length) {
         throw new Error("No features specified. Provide feature names or pass --all.");
     }
@@ -594,18 +637,128 @@ async function runConfigureCommand(args) {
     console.log(`Configuring ${featureSummary} in ${location}`);
     for (const feature of features) {
         const handler = configureFeatureHandlers[feature];
-        await handler(targetPath);
+        await handler(targetPath, { overwrite });
+    }
+}
+const DEFAULT_TEMPLATE_NAME = "default";
+async function listTemplateDirectories(templateRoot, options) {
+    const entries = await readdir(templateRoot, { withFileTypes: true });
+    return entries
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .filter((name) => options?.includeDefault ? true : name !== DEFAULT_TEMPLATE_NAME)
+        .sort();
+}
+function parseConfigureTemplatesArgs(args, availableTemplates) {
+    const templateMap = new Map(availableTemplates.map((name) => [name.toLowerCase(), name]));
+    const templateSet = new Set(templateMap.keys());
+    const templateNames = [];
+    const unknownTemplates = [];
+    let targetPath;
+    let overwrite = false;
+    let includeAll = false;
+    let expectDir = false;
+    for (let i = 0; i < args.length; i += 1) {
+        const arg = args[i];
+        if (expectDir) {
+            targetPath = arg;
+            expectDir = false;
+            continue;
+        }
+        if (arg === "--dir") {
+            expectDir = true;
+            continue;
+        }
+        if (arg === "--all") {
+            includeAll = true;
+            continue;
+        }
+        if (arg === "--overwrite" || arg === "--force") {
+            overwrite = true;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            throw new Error(`Unknown option ${arg}.`);
+        }
+        const normalized = arg.trim().toLowerCase();
+        const resolved = templateMap.get(normalized);
+        if (resolved) {
+            templateNames.push(resolved);
+            continue;
+        }
+        if (!targetPath && (includeAll || i < args.length - 1) && !templateSet.has(normalized)) {
+            targetPath = arg;
+            continue;
+        }
+        unknownTemplates.push(arg);
+    }
+    if (expectDir) {
+        throw new Error("Missing value for --dir.");
+    }
+    if (unknownTemplates.length) {
+        const available = availableTemplates.join(", ");
+        throw new Error(`Unknown template(s): ${unknownTemplates.join(", ")}. Available templates: ${available || "none"}.`);
+    }
+    return { targetPath, overwrite, includeAll, templateNames };
+}
+async function runConfigureTemplatesCommand(args) {
+    const templateRoot = path.resolve(__dirname, "../templates");
+    const availableTemplates = await listTemplateDirectories(templateRoot, { includeDefault: true });
+    const allTemplates = await listTemplateDirectories(templateRoot, { includeDefault: false });
+    const { targetPath, overwrite, includeAll, templateNames } = parseConfigureTemplatesArgs(args, availableTemplates);
+    const selectedTemplates = new Set();
+    if (includeAll) {
+        allTemplates.forEach((name) => selectedTemplates.add(name));
+    }
+    for (const name of templateNames) {
+        selectedTemplates.add(name);
+    }
+    if (!selectedTemplates.size) {
+        throw new Error("No templates specified. Provide template names or pass --all.");
+    }
+    const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
+    const sortedTemplates = Array.from(selectedTemplates).sort();
+    for (const templateName of sortedTemplates) {
+        const templateDir = path.resolve(templateRoot, templateName);
+        const { copied, skipped, overwritten } = await copyTemplateDirectory(templateDir, targetDir, targetDir, { overwrite });
+        console.log(`\nTemplate "${templateName}" processed.`);
+        if (copied.length) {
+            console.log("  Added:");
+            for (const file of copied) {
+                console.log(`    ${file}`);
+            }
+        }
+        if (overwritten.length) {
+            console.log("  Overwritten:");
+            for (const file of overwritten) {
+                console.log(`    ${file}`);
+            }
+        }
+        if (skipped.length) {
+            console.log("  Skipped (already exists):");
+            for (const file of skipped) {
+                console.log(`    ${file}`);
+            }
+        }
+        if (!copied.length && !overwritten.length && !skipped.length) {
+            console.log("  No template files were copied.");
+        }
     }
 }
 function parseConfigureArgs(args) {
     let targetPath;
     let includeAll = false;
+    let overwrite = false;
     const featureInputs = [];
     for (const arg of args) {
         if (arg === "--all") {
             includeAll = true;
             continue;
         }
+        if (arg === "--overwrite" || arg === "--force") {
+            overwrite = true;
+            continue;
+        }
         if (arg.startsWith("--")) {
             throw new Error(`Unknown option ${arg}.`);
         }
@@ -636,7 +789,26 @@ function parseConfigureArgs(args) {
     for (const input of featureInputs) {
         addFeature(resolveConfigureFeatureName(input));
     }
-    return { targetPath, features: featureOrder };
+    return { targetPath, features: featureOrder, overwrite };
+}
+function parseTemplateCommandArgs(args) {
+    let targetPath;
+    let overwrite = false;
+    for (const arg of args) {
+        if (arg === "--overwrite" || arg === "--force") {
+            overwrite = true;
+            continue;
+        }
+        if (arg.startsWith("--")) {
+            throw new Error(`Unknown option ${arg}.`);
+        }
+        if (!targetPath) {
+            targetPath = arg;
+            continue;
+        }
+        throw new Error(`Unexpected argument ${arg}.`);
+    }
+    return { targetPath, overwrite };
 }
 const configureFeatureAliases = {
     devops: "devops",
@@ -728,10 +900,11 @@ async function addGitRemote(dir, remoteName, remoteUrl) {
         throw new Error(`Failed to add git remote origin: ${error.message}`);
     }
 }
-async function copyTemplateDirectory(sourceDir, targetDir, targetRoot) {
+async function copyTemplateDirectory(sourceDir, targetDir, targetRoot, options = {}) {
     const entries = await readdir(sourceDir, { withFileTypes: true });
     const copied = [];
     const skipped = [];
+    const overwritten = [];
     for (const entry of entries) {
         const sourcePath = path.join(sourceDir, entry.name);
         const destinationName = entry.isFile() ? normalizeTemplateFilename(entry.name) : entry.name;
@@ -739,22 +912,29 @@ async function copyTemplateDirectory(sourceDir, targetDir, targetRoot) {
         const relativePath = path.relative(targetRoot, destinationPath) || destinationName;
         if (entry.isDirectory()) {
             await mkdir(destinationPath, { recursive: true });
-            const result = await copyTemplateDirectory(sourcePath, destinationPath, targetRoot);
+            const result = await copyTemplateDirectory(sourcePath, destinationPath, targetRoot, options);
             copied.push(...result.copied);
             skipped.push(...result.skipped);
+            overwritten.push(...result.overwritten);
             continue;
         }
         if (entry.isFile()) {
             await mkdir(path.dirname(destinationPath), { recursive: true });
             if (await fileExists(destinationPath)) {
-                skipped.push(relativePath);
+                if (options.overwrite) {
+                    await copyFile(sourcePath, destinationPath);
+                    overwritten.push(relativePath);
+                }
+                else {
+                    skipped.push(relativePath);
+                }
                 continue;
             }
             await copyFile(sourcePath, destinationPath);
             copied.push(relativePath);
         }
     }
-    return { copied, skipped };
+    return { copied, skipped, overwritten };
 }
 function normalizeTemplateFilename(filename) {
     if (filename === "gitignore" || filename === ".npmignore") {
@@ -763,7 +943,7 @@ function normalizeTemplateFilename(filename) {
     return filename;
 }
 async function configurePlugin(options) {
-    const { targetPath, templateName, dependencyName, dependencySpecifier, label } = options;
+    const { targetPath, templateName, dependencyName, dependencySpecifier, label, overwrite } = options;
     const targetDir = path.resolve(process.cwd(), targetPath ?? ".");
     const templateDir = path.resolve(__dirname, `../templates/${templateName}`);
     const packagePath = path.join(targetDir, "package.json");
@@ -784,7 +964,7 @@ async function configurePlugin(options) {
         throw error;
     }
     const pkg = JSON.parse(pkgRaw);
-    const { copied, skipped } = await copyTemplateDirectory(templateDir, targetDir, targetDir);
+    const { copied, skipped, overwritten } = await copyTemplateDirectory(templateDir, targetDir, targetDir, { overwrite });
     let pkgChanged = false;
     if (dependencyName && dependencySpecifier) {
         const deps = (pkg.dependencies ??= {});
@@ -803,13 +983,19 @@ async function configurePlugin(options) {
             console.log(`    ${file}`);
         }
     }
+    if (overwritten.length) {
+        console.log("  Overwritten files:");
+        for (const file of overwritten) {
+            console.log(`    ${file}`);
+        }
+    }
     if (skipped.length) {
         console.log("  Skipped existing files:");
         for (const file of skipped) {
             console.log(`    ${file}`);
         }
     }
-    if (!copied.length && !skipped.length) {
+    if (!copied.length && !overwritten.length && !skipped.length) {
         console.log("  No template files were copied.");
     }
     if (dependencyName && dependencySpecifier) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uns-kit/cli",
-  "version": "0.0.61",
+  "version": "0.0.63",
   "description": "Command line scaffolding tool for UNS applications",
   "type": "module",
   "license": "MIT",
@@ -26,13 +26,13 @@
   ],
   "dependencies": {
     "azure-devops-node-api": "^15.1.1",
-    "@uns-kit/core": "1.0.27"
+    "@uns-kit/core": "1.0.31"
   },
   "unsKitPackages": {
-    "@uns-kit/core": "1.0.27",
-    "@uns-kit/api": "0.0.19",
-    "@uns-kit/cron": "0.0.18",
-    "@uns-kit/temporal": "0.0.18"
+    "@uns-kit/core": "1.0.31",
+    "@uns-kit/api": "0.0.41",
+    "@uns-kit/cron": "0.0.40",
+    "@uns-kit/temporal": "0.0.40"
   },
   "scripts": {
     "build": "tsc -p tsconfig.build.json",

package/templates/cron/src/examples/cron-example.ts

@@ -1,16 +1,20 @@
 /**
  * Change this file according to your specifications and rename it to index.ts
  */
-import { UnsProxyProcess, ConfigFile, logger } from "@uns-kit/core";
-import type { IUnsMessage, UnsEvents } from "@uns-kit/core";
+import { UnsProxyProcess, ConfigFile, logger, UnsEvents } from "@uns-kit/core";
+import { registerAttributeDescriptions, registerObjectTypeDescriptions } from "@uns-kit/core/uns/uns-dictionary-registry.js";
 import "@uns-kit/cron";
-import { type UnsProxyProcessWithCron } from "@uns-kit/cron.js";
-import { UnsTags } from "../uns/uns-tags.js";
-import { UnsTopics } from "../uns/uns-topics.js";
-import { PhysicalMeasurements } from "@uns-kit/core/uns/uns-measurements.js";
+import { type UnsProxyProcessWithCron } from "@uns-kit/cron";
+import { UnsTopics } from "@uns-kit/core/uns/uns-topics.js";
 import { UnsPacket } from "@uns-kit/core/uns/uns-packet.js";
-import { ObjectTypes } from "@uns-kit/core/uns/uns-object.js";
-import { EquipmentAttributes } from "@uns-kit/core/uns/uns-attributes.js";
+import {
+  GeneratedObjectTypes,
+  GeneratedAttributes,
+  GeneratedAttributesByType,
+  GeneratedAttributeDescriptions,
+  GeneratedObjectTypeDescriptions,
+} from "./uns/uns-dictionary.generated.js";
+import { GeneratedPhysicalMeasurements } from "./uns/uns-measurements.generated.js";
 
 
 /**
@@ -19,12 +23,14 @@ import { EquipmentAttributes } from "@uns-kit/core/uns/uns-attributes.js";
  * In the development environment, you are responsible for creating and maintaining this file and its contents.
  */
 const config = await ConfigFile.loadConfig();
+registerObjectTypeDescriptions(GeneratedObjectTypeDescriptions);
+registerAttributeDescriptions(GeneratedAttributeDescriptions);
 
 /**
  * Connect to the output broker and create a crontab proxy
  */
 const unsProxyProcess = new UnsProxyProcess(config.infra.host!, {processName:config.uns.processName}) as UnsProxyProcessWithCron;;
-const mqttOutput = await unsProxyProcess.createUnsMqttProxy((config.output?.host)!, "templateUnsRttOutput", config.uns.instanceMode, config.uns.handover, { publishThrottlingDelay: 1000});
+const mqttOutput = await unsProxyProcess.createUnsMqttProxy((config.output?.host)!, "templateUnsRttOutput", config.uns.instanceMode!, config.uns.handover!, { publishThrottlingDelay: 1000});
 const cronInput = await unsProxyProcess.createCrontabProxy("* * * * * *");
 
 /**
@@ -35,20 +41,24 @@ cronInput.event.on("cronEvent", async (event: UnsEvents["cronEvent"]) => {
   try {
     const time = UnsPacket.formatToISO8601(new Date());
     const numberValue: number = 42;
-    const message: IUnsMessage = { data: { time, value: numberValue, uom: PhysicalMeasurements.MiliVolt } };
     const topic: UnsTopics = "example/";
-    const objectType = ObjectTypes.Equipment;
-    const objectId = "main";
-    const tags: UnsTags[] = [];
-    const packet = await UnsPacket.unsPacketFromUnsMessage(message);
+    const asset = "asset";
+    const assetDescription = "Sample asset";
+
+    const dataGroup = "sensor";
+
     mqttOutput.publishMqttMessage({
       topic,
-      attribute: EquipmentAttributes.MeasuredTemperature,
-      packet,
-      description: "Number value",
-      objectType,
-      objectId,
-      tags
+      asset,
+      assetDescription,
+      objectType: GeneratedObjectTypes.equipment,
+      objectId: "main",
+      attributes: [
+        {
+          attribute: GeneratedAttributesByType["energy-resource"]["current"],
+          data: { dataGroup, time, value: numberValue, uom: GeneratedPhysicalMeasurements.Ampere }
+        }
+      ],
     });
   } catch (error) {
     const reason = error instanceof Error ? error : new Error(String(error));

package/templates/default/README.md

@@ -32,6 +32,6 @@ Update `config.json` with your broker, UNS URLs, and credentials. The generated
 - Run `uns-kit configure-codegen` to scaffold GraphQL code generation and UNS refresh scripts.
 - Edit `uns-dictionary.json` (object types/attributes + descriptions) and run `pnpm run generate-uns-dictionary` to emit `src/uns/uns-dictionary.generated.ts` for IDE hints/metadata; publish calls will automatically fall back to these descriptions when you omit them.
 - Edit `uns-measurements.json` (units + descriptions) and run `pnpm run generate-uns-measurements` to emit `src/uns/uns-measurements.generated.ts` and feed measurement unit IntelliSense.
-- Run `uns-kit configure-api` / `configure-cron` / `configure-temporal` to pull in example stubs and install the matching UNS plugins.
+- Run `uns-kit configure-api` / `configure-cron` / `configure-temporal` to pull in example stubs and install the matching UNS plugins (add `--overwrite` to refresh templates).
 - Run `uns-kit configure-python` to copy the Python gateway client template (examples, scripts, proto).
 - Commit your new project and start building!

package/templates/default/config.json

@@ -11,13 +11,13 @@
     "password": "123"
   },
   "infra": {
-    "host": "localhost:1883"
+    "host": "localhost"
   },
   "output": {
-    "host": "localhost:1883"
+    "host": "localhost"
   },
   "input": {
-    "host": "localhost:1883"
+    "host": "localhost"
   },
   "devops": {
     "provider": "azure-devops",