@uns-kit/cli 0.0.36 → 0.0.38

package/templates/config-files/config-localhost.json

@@ -1,27 +1,27 @@
-{
-  "uns": {
-    "graphql": "http://localhost:3200/graphql",
-    "rest": "http://localhost:3200/api",
-    "processName": "__APP_NAME__",
-    "instanceMode": "wait",
-    "handover": true,
-    "jwksWellKnownUrl": "http://localhost:3200/api/.well-known/jwks.json",
-    "kidWellKnownUrl": "http://localhost:3200/api/.well-known/kid",
-    "email": "user@example-org.com",
-    "password": "secret"
-  },
-  "infra": {
-    "host": "localhost:1883"
-  },
-  "output": {
-    "host": "localhost:1883"
-  },
-  "input": {
-    "host": "localhost:1883"
-  },
-  "devops": {
-    "provider": "azure-devops",
-    "organization": "example-org",
-    "project": "example-project"
-  }
+{
+  "uns": {
+    "graphql": "http://localhost:3200/graphql",
+    "rest": "http://localhost:3200/api",
+    "processName": "__APP_NAME__",
+    "instanceMode": "wait",
+    "handover": true,
+    "jwksWellKnownUrl": "http://localhost:3200/api/.well-known/jwks.json",
+    "kidWellKnownUrl": "http://localhost:3200/api/.well-known/kid",
+    "email": "user@example-org.com",
+    "password": "secret"
+  },
+  "infra": {
+    "host": "localhost:1883"
+  },
+  "output": {
+    "host": "localhost:1883"
+  },
+  "input": {
+    "host": "localhost:1883"
+  },
+  "devops": {
+    "provider": "azure-devops",
+    "organization": "example-org",
+    "project": "example-project"
+  }
 }

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

@@ -1,46 +1,46 @@
-/**
- * Change this file according to your specifications and rename it to index.ts
- */
-import { UnsProxyProcess, ConfigFile, logger } from "@uns-kit/core.js";
-import type { IUnsMessage, UnsEvents } from "@uns-kit/core.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 { UnsPacket } from "@uns-kit/core/uns/uns-packet.js";
-
-
-/**
- * Load the configuration from a file.
- * On the server, this file is provided by the `uns-datahub-controller`.
- * In the development environment, you are responsible for creating and maintaining this file and its contents.
- */
-const config = await ConfigFile.loadConfig();
-
-/**
- * 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 cronInput = await unsProxyProcess.createCrontabProxy("* * * * * *");
-
-/**
- * Event listener for cron events.
- * On each cron event, publish a message to the MQTT output broker.
- */
-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 tags: UnsTags[] = [];
-    const packet = await UnsPacket.unsPacketFromUnsMessage(message);
-    mqttOutput.publishMqttMessage({ topic, attribute: "data-number", packet, description: "Number value", tags });
-  } catch (error) {
-    const reason = error instanceof Error ? error : new Error(String(error));
-    logger.error(`Error publishing message to MQTT: ${reason.message}`);
-    throw error;
-  }
-});
+/**
+ * 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 "@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 { UnsPacket } from "@uns-kit/core/uns/uns-packet.js";
+
+
+/**
+ * Load the configuration from a file.
+ * On the server, this file is provided by the `uns-datahub-controller`.
+ * In the development environment, you are responsible for creating and maintaining this file and its contents.
+ */
+const config = await ConfigFile.loadConfig();
+
+/**
+ * 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 cronInput = await unsProxyProcess.createCrontabProxy("* * * * * *");
+
+/**
+ * Event listener for cron events.
+ * On each cron event, publish a message to the MQTT output broker.
+ */
+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 tags: UnsTags[] = [];
+    const packet = await UnsPacket.unsPacketFromUnsMessage(message);
+    mqttOutput.publishMqttMessage({ topic, attribute: "data-number", packet, description: "Number value", tags });
+  } catch (error) {
+    const reason = error instanceof Error ? error : new Error(String(error));
+    logger.error(`Error publishing message to MQTT: ${reason.message}`);
+    throw error;
+  }
+});

package/templates/default/README.md

@@ -1,30 +1,32 @@
-# __APP_NAME__
-
-Generated with `@uns-kit/cli`.
-
-## Scripts
-
-```bash
-pnpm run dev    # start the local development loop
-pnpm run build  # emit dist/ output
-pnpm run start  # run the compiled entrypoint
-pnpm run generate-config-schema  # regenerate config.schema.json and AppConfig augmentations
-pnpm run codegen            # regenerate typed GraphQL operations (after configure-codegen)
-pnpm run refresh-uns        # rebuild UNS topics/tags from the live schema
-```
-
-## Configuration
-
-Update `config.json` with your broker, UNS URLs, and credentials. The generated file contains sensible defaults for local development.
-
-## Next Steps
-
-- Install additional plugins: `pnpm add @uns-kit/api` etc.
-- Create MQTT proxies or Temporal workflows inside `src/index.ts`.
-- Extend `src/config/project.config.extension.ts` with project-specific sections and run `pnpm run generate-config-schema` (reload your editor's TS server afterward if completions lag).
-- Run `uns-kit configure-devops` to add the Azure DevOps pull-request tooling.
-- Run `uns-kit configure-vscode` to copy workspace/launch configuration for VS Code.
-- Run `uns-kit configure-codegen` to scaffold GraphQL code generation and UNS refresh scripts.
-- Run `uns-kit configure-api` / `configure-cron` / `configure-temporal` to pull in example stubs and install the matching UNS plugins.
-- Run `uns-kit configure-python` to copy the Python gateway client template (examples, scripts, proto).
-- Commit your new project and start building!
+# __APP_NAME__
+
+Generated with `@uns-kit/cli`.
+
+Requires Node.js 22+ and pnpm (see `packageManager` in package.json).
+
+## Scripts
+
+```bash
+pnpm run dev    # start the local development loop
+pnpm run build  # emit dist/ output
+pnpm run start  # run the compiled entrypoint
+pnpm run generate-config-schema  # regenerate config.schema.json and AppConfig augmentations
+pnpm run codegen            # regenerate typed GraphQL operations (after configure-codegen)
+pnpm run refresh-uns        # rebuild UNS topics/tags from the live schema
+```
+
+## Configuration
+
+Update `config.json` with your broker, UNS URLs, and credentials. The generated file contains sensible defaults for local development.
+
+## Next Steps
+
+- Install additional plugins: `pnpm add @uns-kit/api` etc.
+- Create MQTT proxies or Temporal workflows inside `src/index.ts`.
+- Extend `src/config/project.config.extension.ts` with project-specific sections and run `pnpm run generate-config-schema` (reload your editor's TS server afterward if completions lag).
+- Run `uns-kit configure-devops` to add the Azure DevOps pull-request tooling.
+- Run `uns-kit configure-vscode` to copy workspace/launch configuration for VS Code.
+- Run `uns-kit configure-codegen` to scaffold GraphQL code generation and UNS refresh scripts.
+- Run `uns-kit configure-api` / `configure-cron` / `configure-temporal` to pull in example stubs and install the matching UNS plugins.
+- 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

@@ -1,27 +1,27 @@
-{
-  "uns": {
-    "graphql": "http://localhost:3200/graphql",
-    "rest": "http://localhost:3200/api",
-    "processName": "__APP_NAME__",
-    "instanceMode": "wait",
-    "handover": true,
-    "jwksWellKnownUrl": "http://localhost:3200/api/.well-known/jwks.json",
-    "kidWellKnownUrl": "http://localhost:3200/api/.well-known/kid",
-    "email": "user@example-org.com",
-    "password": "secret"
-  },
-  "infra": {
-    "host": "localhost:1883"
-  },
-  "output": {
-    "host": "localhost:1883"
-  },
-  "input": {
-    "host": "localhost:1883"
-  },
-  "devops": {
-    "provider": "azure-devops",
-    "organization": "example-org",
-    "project": "example-project"
-  }
-}
+{
+  "uns": {
+    "graphql": "http://localhost:3200/graphql",
+    "rest": "http://localhost:3200/api",
+    "processName": "__APP_NAME__",
+    "instanceMode": "wait",
+    "handover": true,
+    "jwksWellKnownUrl": "http://localhost:3200/api/.well-known/jwks.json",
+    "kidWellKnownUrl": "http://localhost:3200/api/.well-known/kid",
+    "email": "user@example-org.com",
+    "password": "secret"
+  },
+  "infra": {
+    "host": "localhost:1883"
+  },
+  "output": {
+    "host": "localhost:1883"
+  },
+  "input": {
+    "host": "localhost:1883"
+  },
+  "devops": {
+    "provider": "azure-devops",
+    "organization": "example-org",
+    "project": "example-project"
+  }
+}

package/templates/default/gitignore

@@ -1,51 +1,51 @@
-# Dependencies
-node_modules/
-.pnpm-store/
-.pnpm/
-.pnp.cjs
-.pnp.loader.mjs
-
-# Build outputs
-build/
-dist/
-tmp/
-temp/
-*.tsbuildinfo
-
-# Logs & diagnostics
-logs/
-*.log
-npm-debug.log*
-yarn-debug.log*
-pnpm-debug.log*
-lerna-debug.log*
-
-# Test & coverage artifacts
-coverage/
-.nyc_output/
-.vitest/
-
-# Runtime queues & sandboxes
-publisherQueue/
-sandbox-*
-tmp-rtt
-.tmp-rtt
-
-# Environment & secrets
-.env
-.env.*
-!.env.example
-!.env.sample
-
-# UNS configuration overrides
-config*.json
-
-# Editor files & OS cruft
-.idea/
-.DS_Store
-Thumbs.db
-*.swp
-*.swo
-
-# Package managers
-package-lock.json
+# Dependencies
+node_modules/
+.pnpm-store/
+.pnpm/
+.pnp.cjs
+.pnp.loader.mjs
+
+# Build outputs
+build/
+dist/
+tmp/
+temp/
+*.tsbuildinfo
+
+# Logs & diagnostics
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+# Test & coverage artifacts
+coverage/
+.nyc_output/
+.vitest/
+
+# Runtime queues & sandboxes
+publisherQueue/
+sandbox-*
+tmp-rtt
+.tmp-rtt
+
+# Environment & secrets
+.env
+.env.*
+!.env.example
+!.env.sample
+
+# UNS configuration overrides
+config*.json
+
+# Editor files & OS cruft
+.idea/
+.DS_Store
+Thumbs.db
+*.swp
+*.swo
+
+# Package managers
+package-lock.json

package/templates/default/package.json

@@ -1,19 +1,38 @@
-{
-  "name": "__APP_NAME__",
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "typecheck": "tsc --noEmit",
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsx watch src/index.ts",
-    "generate-config-schema": "node ./node_modules/@uns-kit/core/dist/tools/generate-config-schema.js"
-  },
-  "dependencies": {
-    "@uns-kit/core": "__UNS_KIT_CORE_VERSION__",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "tsx": "^4.20.5",
-    "typescript": "^5.9.2"
-  }
-}
+{
+  "name": "__APP_NAME__",
+  "version": "0.0.0",
+  "private": true,
+  "description": "UNS application generated by @uns-kit/cli",
+  "type": "module",
+  "packageManager": "pnpm@9.12.1",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "typecheck": "tsc --noEmit",
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "generate-config-schema": "node ./node_modules/@uns-kit/core/dist/tools/generate-config-schema.js"
+  },
+  "dependencies": {
+    "@uns-kit/core": "__UNS_KIT_CORE_VERSION__",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.1",
+    "rimraf": "^6.1.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}

package/templates/default/src/config/project.config.extension.example

@@ -1,23 +1,23 @@
-import { z } from "zod";
-import { secretValueSchema } from "@uns-kit/core/uns-config/secret-placeholders.js";
-import { hostValueSchema } from "@uns-kit/core/uns-config/host-placeholders.js";
-
-// Extend this schema with project-specific configuration sections.
-export const projectExtrasSchema = z.object({
-  pg: z.object({
-    user: z.string().min(1, "pg.user is required"),
-    host: hostValueSchema,
-    port: z.number().int().positive().default(5432),
-    ssl: z.boolean().default(false),
-    database: z.string().min(1, "pg.database is required"),
-    isPoolConnection: z.boolean().default(false),
-    password: secretValueSchema.optional(),
-  }),
-
-  caddy: z.object({
-    adminUrl: z.string().url(),
-    proxyHost: z.string().url(),
-  }),
-});
-
-export type ProjectExtras = z.infer<typeof projectExtrasSchema>;
+import { z } from "zod";
+import { secretValueSchema } from "@uns-kit/core/uns-config/secret-placeholders.js";
+import { hostValueSchema } from "@uns-kit/core/uns-config/host-placeholders.js";
+
+// Extend this schema with project-specific configuration sections.
+export const projectExtrasSchema = z.object({
+  pg: z.object({
+    user: z.string().min(1, "pg.user is required"),
+    host: hostValueSchema,
+    port: z.number().int().positive().default(5432),
+    ssl: z.boolean().default(false),
+    database: z.string().min(1, "pg.database is required"),
+    isPoolConnection: z.boolean().default(false),
+    password: secretValueSchema.optional(),
+  }),
+
+  caddy: z.object({
+    adminUrl: z.string().url(),
+    proxyHost: z.string().url(),
+  }),
+});
+
+export type ProjectExtras = z.infer<typeof projectExtrasSchema>;

package/templates/default/src/config/project.config.extension.ts

@@ -1,6 +1,6 @@
-import { z } from "zod";
-
-// Extend this schema with project-specific configuration sections.
-export const projectExtrasSchema = z.object({});
-
-export type ProjectExtras = z.infer<typeof projectExtrasSchema>;
+import { z } from "zod";
+
+// Extend this schema with project-specific configuration sections.
+export const projectExtrasSchema = z.object({});
+
+export type ProjectExtras = z.infer<typeof projectExtrasSchema>;

package/templates/default/src/examples/data-example.ts

@@ -1,68 +1,68 @@
-/**
- * Change this file according to your specifications and rename it to index.ts
- */
-import { UnsProxyProcess, ConfigFile, logger, type IUnsMessage } from "@uns-kit/core.js";
-import { DataSizeMeasurements, PhysicalMeasurements } from "@uns-kit/core/uns/uns-measurements.js";
-import { UnsPacket } from "@uns-kit/core/uns/uns-packet.js";
-import { UnsTags } from "@uns-kit/core/uns/uns-tags.js";
-import { UnsTopics } from "@uns-kit/core/uns/uns-topics.js";
-
-/**
- * Load the configuration from a file.
- * On the server, this file is provided by the `uns-datahub-controller`.
- * In the development environment, you are responsible for creating and maintaining this file and its contents.
- */
-const config = await ConfigFile.loadConfig();
-
-/**
- * Connect to input and output brokers
- */
-const unsProxyProcess = new UnsProxyProcess(config.infra.host!, {processName: config.uns.processName!});
-const mqttInput = await unsProxyProcess.createUnsMqttProxy((config.input?.host)!, "templateUnsRttInput", config.uns.instanceMode!, config.uns.handover!, {
-  mqttSubToTopics: ["raw/#"],
-});
-const mqttOutput = await unsProxyProcess.createUnsMqttProxy((config.output?.host)!, "templateUnsRttOutput", config.uns.instanceMode!, config.uns.handover!, { publishThrottlingDelay: 1000});
-
-
-/**
- * Event listener for input events.
- * Transform an input message and publish it with publishMqttMessage function.
- */
-mqttInput.event.on("input", async (event) => {
-  try {
-    if (event.topic === "raw/data") {
-      const values = event.message.split(",");
-      const [countRaw, timestampRaw, sensorRaw] = values;
-      const numberValue = Number.parseFloat(countRaw);
-      const eventDate = new Date(Number.parseInt(timestampRaw, 10));
-      const sensorValue = Number.parseFloat(sensorRaw);
-      const time = UnsPacket.formatToISO8601(eventDate);
-
-      const dataGroup = "sensor";
-
-      const message: IUnsMessage = {
-        data: { dataGroup, time, value: numberValue, uom: PhysicalMeasurements.None },
-      };
-      const topic: UnsTopics = "example/";
-      const tags: UnsTags[] = [];
-      const packet = await UnsPacket.unsPacketFromUnsMessage(message);
-      mqttOutput.publishMqttMessage({ topic, attribute: "data-count", packet, description: "Counter", tags });
-
-      const sensorMessage: IUnsMessage = {
-        data: { dataGroup, time, value: sensorValue, uom: PhysicalMeasurements.Celsius },
-      };
-      const sensorPacket = await UnsPacket.unsPacketFromUnsMessage(sensorMessage);
-      mqttOutput.publishMqttMessage({
-        topic,
-        attribute: "data-sensor",
-        packet: sensorPacket,
-        description: "Simulated sensor value",
-        tags,
-      });
-    }
-  } catch (error) {
-    const reason = error instanceof Error ? error : new Error(String(error));
-    logger.error(`Error publishing message to MQTT: ${reason.message}`);
-    throw reason;
-  }
-});
+/**
+ * Change this file according to your specifications and rename it to index.ts
+ */
+import { UnsProxyProcess, ConfigFile, logger, type IUnsMessage } from "@uns-kit/core";
+import { DataSizeMeasurements, PhysicalMeasurements } from "@uns-kit/core/uns/uns-measurements.js";
+import { UnsPacket } from "@uns-kit/core/uns/uns-packet.js";
+import { UnsTags } from "@uns-kit/core/uns/uns-tags.js";
+import { UnsTopics } from "@uns-kit/core/uns/uns-topics.js";
+
+/**
+ * Load the configuration from a file.
+ * On the server, this file is provided by the `uns-datahub-controller`.
+ * In the development environment, you are responsible for creating and maintaining this file and its contents.
+ */
+const config = await ConfigFile.loadConfig();
+
+/**
+ * Connect to input and output brokers
+ */
+const unsProxyProcess = new UnsProxyProcess(config.infra.host!, {processName: config.uns.processName!});
+const mqttInput = await unsProxyProcess.createUnsMqttProxy((config.input?.host)!, "templateUnsRttInput", config.uns.instanceMode!, config.uns.handover!, {
+  mqttSubToTopics: ["raw/#"],
+});
+const mqttOutput = await unsProxyProcess.createUnsMqttProxy((config.output?.host)!, "templateUnsRttOutput", config.uns.instanceMode!, config.uns.handover!, { publishThrottlingDelay: 1000});
+
+
+/**
+ * Event listener for input events.
+ * Transform an input message and publish it with publishMqttMessage function.
+ */
+mqttInput.event.on("input", async (event) => {
+  try {
+    if (event.topic === "raw/data") {
+      const values = event.message.split(",");
+      const [countRaw, timestampRaw, sensorRaw] = values;
+      const numberValue = Number.parseFloat(countRaw);
+      const eventDate = new Date(Number.parseInt(timestampRaw, 10));
+      const sensorValue = Number.parseFloat(sensorRaw);
+      const time = UnsPacket.formatToISO8601(eventDate);
+
+      const dataGroup = "sensor";
+
+      const message: IUnsMessage = {
+        data: { dataGroup, time, value: numberValue, uom: PhysicalMeasurements.None },
+      };
+      const topic: UnsTopics = "example/";
+      const tags: UnsTags[] = [];
+      const packet = await UnsPacket.unsPacketFromUnsMessage(message);
+      mqttOutput.publishMqttMessage({ topic, attribute: "data-count", packet, description: "Counter", tags });
+
+      const sensorMessage: IUnsMessage = {
+        data: { dataGroup, time, value: sensorValue, uom: PhysicalMeasurements.Celsius },
+      };
+      const sensorPacket = await UnsPacket.unsPacketFromUnsMessage(sensorMessage);
+      mqttOutput.publishMqttMessage({
+        topic,
+        attribute: "data-sensor",
+        packet: sensorPacket,
+        description: "Simulated sensor value",
+        tags,
+      });
+    }
+  } catch (error) {
+    const reason = error instanceof Error ? error : new Error(String(error));
+    logger.error(`Error publishing message to MQTT: ${reason.message}`);
+    throw reason;
+  }
+});