@uns-kit/cli 2.0.20 → 2.0.22

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,46 +1,46 @@
-{
-  "name": "__APP_NAME__",
-  "version": "0.0.0",
-  "private": true,
-  "description": "UNS application generated by @uns-kit/cli",
-  "type": "module",
-  "engines": {
-    "node": ">=22"
-  },
-  "files": [
-    "dist"
-  ],
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
-  "scripts": {
-    "clean": "rimraf dist tsconfig.tsbuildinfo",
-    "typecheck": "tsc --noEmit",
-    "build": "pnpm run clean && tsc -p tsconfig.json",
-    "dev": "tsx watch src/index.ts",
-    "start": "node dist/index.js",
-    "lint": "eslint src --ext .ts",
-    "lint:fix": "eslint src --ext .ts --fix",
-    "format": "prettier --write .",
-    "format:check": "prettier --check .",
-    "generate-config-schema": "node ./node_modules/@uns-kit/core/dist/tools/generate-config-schema.js",
-    "generate-codegen": "graphql-code-generator --require dotenv/config --config codegen.ts",
-    "generate-uns-metadata": "node ./node_modules/@uns-kit/core/dist/tools/refresh-uns.js",
-    "generate-uns-measurements": "node ./node_modules/@uns-kit/core/dist/tools/generate-uns-measurements.js --input uns-measurements.json --output src/uns/uns-measurements.generated.ts"
-  },
-  "dependencies": {
-    "@uns-kit/core": "__UNS_KIT_CORE_VERSION__",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "@types/node": "^22.19.1",
-    "eslint": "^9.39.2",
-    "prettier": "^3.8.0",
-    "rimraf": "^6.1.2",
-    "tsx": "^4.20.6",
-    "typescript": "^5.9.3"
-  }
-}
+{
+  "name": "__APP_NAME__",
+  "version": "0.0.0",
+  "private": true,
+  "description": "UNS application generated by @uns-kit/cli",
+  "type": "module",
+  "engines": {
+    "node": ">=22"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "clean": "rimraf dist tsconfig.tsbuildinfo",
+    "typecheck": "tsc --noEmit",
+    "build": "pnpm run clean && tsc -p tsconfig.json",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "generate-config-schema": "node ./node_modules/@uns-kit/core/dist/tools/generate-config-schema.js",
+    "generate-codegen": "graphql-code-generator --require dotenv/config --config codegen.ts",
+    "generate-uns-metadata": "node ./node_modules/@uns-kit/core/dist/tools/refresh-uns.js",
+    "generate-uns-measurements": "node ./node_modules/@uns-kit/core/dist/tools/generate-uns-measurements.js --input uns-measurements.json --output src/uns/uns-measurements.generated.ts"
+  },
+  "dependencies": {
+    "@uns-kit/core": "__UNS_KIT_CORE_VERSION__",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.1",
+    "eslint": "^9.39.2",
+    "prettier": "^3.8.0",
+    "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,84 +1,86 @@
-/**
- * Change this file according to your specifications and rename it to index.ts
- */
-import { UnsProxyProcess, ConfigFile, logger } from "@uns-kit/core";
-import { registerAttributeDescriptions, registerObjectTypeDescriptions } from "@uns-kit/core/uns/uns-dictionary-registry.js";
-import { GeneratedPhysicalMeasurements } from "../uns/uns-measurements.generated.js";
-import { UnsTopics } from "@uns-kit/core/uns/uns-topics.js";
-import {
-  GeneratedObjectTypes,
-  GeneratedAttributes,
-  GeneratedAttributesByType,
-  GeneratedObjectTypeDescriptions,
-} from "../uns/uns-dictionary.generated.js";
-import { GeneratedAssets, resolveGeneratedAsset } from "../uns/uns-assets.js";
-import type { ISO8601 } from "@uns-kit/core/uns/uns-interfaces.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();
-registerObjectTypeDescriptions(GeneratedObjectTypeDescriptions);
-
-/**
- * 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;
-      if (!countRaw || !timestampRaw || !sensorRaw) {
-        logger.warn(`Skipping malformed raw/data payload: ${event.message}`);
-        return;
-      }
-      const numberValue = Number.parseFloat(countRaw);
-      const eventDate = new Date(Number.parseInt(timestampRaw, 10));
-      const sensorValue = Number.parseFloat(sensorRaw);
-      const time: ISO8601 = eventDate.toISOString() as ISO8601;
-      const intervalStart: ISO8601 = new Date(eventDate.getTime() - 1000).toISOString() as ISO8601;
-      const intervalEnd: ISO8601 = eventDate.toISOString() as ISO8601;
-
-      const dataGroup = "sensor";
-
-      const topic: UnsTopics = "enterprise/site/area/line/";
-      const asset = resolveGeneratedAsset("asset");
-      const assetDescription = ""; // customize manually
-
-      mqttOutput.publishMqttMessage({
-        topic,
-        asset,
-        assetDescription,
-        objectType: GeneratedObjectTypes["energy-resource"],
-        objectId: "main",
-        attributes: [
-          {
-            attribute: GeneratedAttributesByType["energy-resource"]["current"],
-            data: { dataGroup, time, value: numberValue, uom: GeneratedPhysicalMeasurements.Ampere, intervalStart, intervalEnd },
-          },
-          {
-            attribute: GeneratedAttributes["voltage"],
-            data: { dataGroup, time, value: sensorValue, uom: GeneratedPhysicalMeasurements.Volt, intervalStart, intervalEnd },
-          },
-        ],
-      });
-    }
-  } 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, getLogger } from "@uns-kit/core";
+import { registerAttributeDescriptions, registerObjectTypeDescriptions } from "@uns-kit/core/uns/uns-dictionary-registry.js";
+import { GeneratedPhysicalMeasurements } from "../uns/uns-measurements.generated.js";
+import { UnsTopics } from "@uns-kit/core/uns/uns-topics.js";
+import {
+  GeneratedObjectTypes,
+  GeneratedAttributes,
+  GeneratedAttributesByType,
+  GeneratedObjectTypeDescriptions,
+} from "../uns/uns-dictionary.generated.js";
+import { GeneratedAssets, resolveGeneratedAsset } from "../uns/uns-assets.js";
+import type { ISO8601 } from "@uns-kit/core/uns/uns-interfaces.js";
+
+const logger = getLogger(import.meta.url);
+
+/**
+ * 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();
+registerObjectTypeDescriptions(GeneratedObjectTypeDescriptions);
+
+/**
+ * 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;
+      if (!countRaw || !timestampRaw || !sensorRaw) {
+        logger.warn(`Skipping malformed raw/data payload: ${event.message}`);
+        return;
+      }
+      const numberValue = Number.parseFloat(countRaw);
+      const eventDate = new Date(Number.parseInt(timestampRaw, 10));
+      const sensorValue = Number.parseFloat(sensorRaw);
+      const time: ISO8601 = eventDate.toISOString() as ISO8601;
+      const intervalStart: ISO8601 = new Date(eventDate.getTime() - 1000).toISOString() as ISO8601;
+      const intervalEnd: ISO8601 = eventDate.toISOString() as ISO8601;
+
+      const dataGroup = "sensor";
+
+      const topic: UnsTopics = "enterprise/site/area/line/";
+      const asset = resolveGeneratedAsset("asset");
+      const assetDescription = ""; // customize manually
+
+      mqttOutput.publishMqttMessage({
+        topic,
+        asset,
+        assetDescription,
+        objectType: GeneratedObjectTypes["energy-resource"],
+        objectId: "main",
+        attributes: [
+          {
+            attribute: GeneratedAttributesByType["energy-resource"]["current"],
+            data: { dataGroup, time, value: numberValue, uom: GeneratedPhysicalMeasurements.Ampere, intervalStart, intervalEnd },
+          },
+          {
+            attribute: GeneratedAttributes["voltage"],
+            data: { dataGroup, time, value: sensorValue, uom: GeneratedPhysicalMeasurements.Volt, intervalStart, intervalEnd },
+          },
+        ],
+      });
+    }
+  } catch (error) {
+    const reason = error instanceof Error ? error : new Error(String(error));
+    logger.error(`Error publishing message to MQTT: ${reason.message}`);
+    throw reason;
+  }
+});