@uns-kit/cli 2.0.20 → 2.0.22

package/templates/codegen/codegen.ts

@@ -1,15 +1,15 @@
-import type { CodegenConfig } from '@graphql-codegen/cli';
-import { ConfigFile } from '@uns-kit/core';
-
-const appConfig = await ConfigFile.loadConfig();
-
-const config: CodegenConfig = {
-  schema: appConfig.uns.graphql,
-  generates: {
-    'src/graphql/schema.ts': {
-      plugins: ['typescript', 'typescript-operations', 'typescript-resolvers'],
-    },
-  },
-};
-
-export default config;
+import type { CodegenConfig } from '@graphql-codegen/cli';
+import { ConfigFile } from '@uns-kit/core';
+
+const appConfig = await ConfigFile.loadConfig();
+
+const config: CodegenConfig = {
+  schema: appConfig.uns.graphql,
+  generates: {
+    'src/graphql/schema.ts': {
+      plugins: ['typescript', 'typescript-operations', 'typescript-resolvers'],
+    },
+  },
+};
+
+export default config;

package/templates/codegen/src/uns/uns-tags.ts

@@ -1 +1 @@
-export type UnsTags = string & {};
+export type UnsTags = string & {};

package/templates/codegen/src/uns/uns-topics.ts

@@ -1 +1 @@
-export type UnsTopics = string & {};
+export type UnsTopics = string & {};

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

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

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/AGENTS.md

@@ -1,23 +1,23 @@
-# Agent Onboarding (template)
-
-Pointers for AI/code-assist tools when working in this generated project.
-
-## What to read locally
-
-- `package.json` for scripts (`generate-uns-*`, `generate-codegen`, etc.).
-- `config.schema.json` for the app config shape; `processName` is required.
-- `src/examples/*.ts` for cron-driven publish patterns and description registration.
-- Installed docs (under `node_modules`):
-  - `@uns-kit/core/README.md`
-  - `@uns-kit/api/README.md` (if installed)
-  - `@uns-kit/cron/README.md` (if installed)
-  - `@uns-kit/temporal/README.md` (if installed)
-  - `@uns-kit/cli/README.md` (if installed)
-
-## Generators in this project
-
-- `pnpm run generate-uns-dictionary` -> updates `src/uns/uns-dictionary.generated.ts`
-- `pnpm run generate-uns-measurements` -> updates `src/uns/uns-measurements.generated.ts`
-- `pnpm run generate-uns-reference` -> runs both
-- `pnpm run generate-uns-topics-tags` -> refreshes topic/tag unions (requires GraphQL connectivity)
-- `pnpm run generate-codegen` -> GraphQL codegen (after configure-codegen)
+# Agent Onboarding (template)
+
+Pointers for AI/code-assist tools when working in this generated project.
+
+## What to read locally
+
+- `package.json` for scripts (`generate-uns-*`, `generate-codegen`, etc.).
+- `config.schema.json` for the app config shape; `processName` is required.
+- `src/examples/*.ts` for cron-driven publish patterns and description registration.
+- Installed docs (under `node_modules`):
+  - `@uns-kit/core/README.md`
+  - `@uns-kit/api/README.md` (if installed)
+  - `@uns-kit/cron/README.md` (if installed)
+  - `@uns-kit/temporal/README.md` (if installed)
+  - `@uns-kit/cli/README.md` (if installed)
+
+## Generators in this project
+
+- `pnpm run generate-uns-dictionary` -> updates `src/uns/uns-dictionary.generated.ts`
+- `pnpm run generate-uns-measurements` -> updates `src/uns/uns-measurements.generated.ts`
+- `pnpm run generate-uns-reference` -> runs both
+- `pnpm run generate-uns-topics-tags` -> refreshes topic/tag unions (requires GraphQL connectivity)
+- `pnpm run generate-codegen` -> GraphQL codegen (after configure-codegen)

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

@@ -1,69 +1,71 @@
-/**
- * Change this file according to your specifications and rename it to index.ts
- */
-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";
-import { UnsTopics } from "@uns-kit/core/uns/uns-topics.js";
-import { UnsPacket } from "@uns-kit/core/uns/uns-packet.js";
-import {
-  GeneratedObjectTypes,
-  GeneratedAttributes,
-  GeneratedAttributesByType,
-  GeneratedAttributeDescriptions,
-  GeneratedObjectTypeDescriptions,
-} from "../uns/uns-dictionary.generated.js";
-import { GeneratedPhysicalMeasurements } from "../uns/uns-measurements.generated.js";
-import { GeneratedAssets, resolveGeneratedAsset } from "../uns/uns-assets.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);
-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 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 topic: UnsTopics = "example/";
-    const asset = resolveGeneratedAsset("asset");
-    const assetDescription = "Sample asset";
-
-    const dataGroup = "sensor";
-
-    mqttOutput.publishMqttMessage({
-      topic,
-      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));
-    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, UnsEvents, getLogger } 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";
+import { UnsTopics } from "@uns-kit/core/uns/uns-topics.js";
+import { UnsPacket } from "@uns-kit/core/uns/uns-packet.js";
+import {
+  GeneratedObjectTypes,
+  GeneratedAttributes,
+  GeneratedAttributesByType,
+  GeneratedAttributeDescriptions,
+  GeneratedObjectTypeDescriptions,
+} from "../uns/uns-dictionary.generated.js";
+import { GeneratedPhysicalMeasurements } from "../uns/uns-measurements.generated.js";
+import { GeneratedAssets, resolveGeneratedAsset } from "../uns/uns-assets.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);
+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 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 topic: UnsTopics = "example/";
+    const asset = resolveGeneratedAsset("asset");
+    const assetDescription = "Sample asset";
+
+    const dataGroup = "sensor";
+
+    mqttOutput.publishMqttMessage({
+      topic,
+      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));
+    logger.error(`Error publishing message to MQTT: ${reason.message}`);
+    throw error;
+  }
+});

package/templates/default/.prettierignore

@@ -1,2 +1,2 @@
-dist
+dist
 node_modules

package/templates/default/.prettierrc

@@ -1,7 +1,7 @@
-{
-  "semi": true,
-  "singleQuote": true,
-  "tabWidth": 2,
-  "trailingComma": "all",
-  "printWidth": 140
-}
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "all",
+  "printWidth": 140
+}

package/templates/default/AGENTS.md

@@ -1,23 +1,23 @@
-# Agent Onboarding (template)
-
-Pointers for AI/code-assist tools when working in this generated project.
-
-## What to read locally
-
-- `package.json` for scripts (`generate-uns-*`, `generate-codegen`, etc.).
-- `config.schema.json` for the app config shape; `processName` is required.
-- `src/examples/*.ts` for idiomatic publishing (multi-attribute) and description registration.
-- Installed docs (under `node_modules`):
-  - `@uns-kit/core/README.md`
-  - `@uns-kit/api/README.md` (if installed)
-  - `@uns-kit/cron/README.md` (if installed)
-  - `@uns-kit/temporal/README.md` (if installed)
-  - `@uns-kit/cli/README.md` (if installed)
-
-## Generators in this project
-
-- `pnpm run generate-uns-dictionary` -> updates `src/uns/uns-dictionary.generated.ts`
-- `pnpm run generate-uns-measurements` -> updates `src/uns/uns-measurements.generated.ts`
-- `pnpm run generate-uns-reference` -> runs both
-- `pnpm run generate-uns-topics-tags` -> refreshes topic/tag unions (requires GraphQL connectivity)
-- `pnpm run generate-codegen` -> GraphQL codegen (after configure-codegen)
+# Agent Onboarding (template)
+
+Pointers for AI/code-assist tools when working in this generated project.
+
+## What to read locally
+
+- `package.json` for scripts (`generate-uns-*`, `generate-codegen`, etc.).
+- `config.schema.json` for the app config shape; `processName` is required.
+- `src/examples/*.ts` for idiomatic publishing (multi-attribute) and description registration.
+- Installed docs (under `node_modules`):
+  - `@uns-kit/core/README.md`
+  - `@uns-kit/api/README.md` (if installed)
+  - `@uns-kit/cron/README.md` (if installed)
+  - `@uns-kit/temporal/README.md` (if installed)
+  - `@uns-kit/cli/README.md` (if installed)
+
+## Generators in this project
+
+- `pnpm run generate-uns-dictionary` -> updates `src/uns/uns-dictionary.generated.ts`
+- `pnpm run generate-uns-measurements` -> updates `src/uns/uns-measurements.generated.ts`
+- `pnpm run generate-uns-reference` -> runs both
+- `pnpm run generate-uns-topics-tags` -> refreshes topic/tag unions (requires GraphQL connectivity)
+- `pnpm run generate-codegen` -> GraphQL codegen (after configure-codegen)

package/templates/default/README.md

@@ -1,41 +1,41 @@
-# __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 generate-codegen            # regenerate typed GraphQL operations (after configure-codegen)
-pnpm run generate-uns-topics-tags  # rebuild UNS topics/tags from the live schema
-pnpm run generate-uns-dictionary  # generate typed object/attribute dictionary from uns-dictionary.json
-pnpm run generate-uns-measurements  # generate typed measurement units from uns-measurements.json
-pnpm run generate-uns-reference    # run both dictionary + measurements generators
-```
-
-## 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.
-- 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 (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!
-
-## Agent Onboarding (for AI/code-assist tools)
-
-For agent guidance, see the local [`AGENTS.md`](./AGENTS.md).
+# __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 generate-codegen            # regenerate typed GraphQL operations (after configure-codegen)
+pnpm run generate-uns-topics-tags  # rebuild UNS topics/tags from the live schema
+pnpm run generate-uns-dictionary  # generate typed object/attribute dictionary from uns-dictionary.json
+pnpm run generate-uns-measurements  # generate typed measurement units from uns-measurements.json
+pnpm run generate-uns-reference    # run both dictionary + measurements generators
+```
+
+## 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.
+- 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 (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!
+
+## Agent Onboarding (for AI/code-assist tools)
+
+For agent guidance, see the local [`AGENTS.md`](./AGENTS.md).

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.com",
-    "password": "123"
-  },
-  "infra": {
-    "host": "localhost"
-  },
-  "output": {
-    "host": "localhost"
-  },
-  "input": {
-    "host": "localhost"
-  },
-  "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.com",
+    "password": "123"
+  },
+  "infra": {
+    "host": "localhost"
+  },
+  "output": {
+    "host": "localhost"
+  },
+  "input": {
+    "host": "localhost"
+  },
+  "devops": {
+    "provider": "azure-devops",
+    "organization": "example-org",
+    "project": "example-project"
+  }
+}

package/templates/default/eslint.config.js

@@ -1,30 +1,30 @@
-// eslint.config.js
-
-import { defineConfig } from 'eslint/config';
-
-export default defineConfig([
-  // Apply to all source and test files
-  {
-    files: ['src/**/*', 'test/**/*'],
-    ignores: ['dist/', 'node_modules/'], // Folders to ignore
-    languageOptions: {
-      parserOptions: {
-        ecmaVersion: 'latest', // Use latest ECMAScript version
-        sourceType: 'module', // Enable ES modules
-      },
-    },
-    rules: {
-      semi: ['warn', 'always'],
-    },
-  },
-
-  // Override specifically for test files
-  {
-    files: ['test/**/*'],
-    rules: {
-      'no-console': 'off',
-    },
-  },
-
-  // Additional configurations can go here
-]);
+// eslint.config.js
+
+import { defineConfig } from 'eslint/config';
+
+export default defineConfig([
+  // Apply to all source and test files
+  {
+    files: ['src/**/*', 'test/**/*'],
+    ignores: ['dist/', 'node_modules/'], // Folders to ignore
+    languageOptions: {
+      parserOptions: {
+        ecmaVersion: 'latest', // Use latest ECMAScript version
+        sourceType: 'module', // Enable ES modules
+      },
+    },
+    rules: {
+      semi: ['warn', 'always'],
+    },
+  },
+
+  // Override specifically for test files
+  {
+    files: ['test/**/*'],
+    rules: {
+      'no-console': 'off',
+    },
+  },
+
+  // Additional configurations can go here
+]);