@uns-kit/core 3.0.6 → 3.0.7

package/MIGRATIONS.md

@@ -9,6 +9,31 @@ Agents must inspect the application's existing ownership and shutdown flow
 before editing it. The examples below describe the intended behavior, not a
 mechanical search-and-replace operation.
 
+## 3.0.7 - Zod 4 configuration contracts
+
+Apply this migration when upgrading from `@uns-kit/core` `<3.0.7` to
+`>=3.0.7`.
+
+`@uns-kit/core` and `@uns-kit/database` now use Zod 4. Applications that own a
+`src/config/project.config.extension.ts` file must use the same Zod major at the
+schema-composition boundary. Update the application's direct `zod` dependency
+to `^4.4.3` before regenerating configuration artifacts.
+
+The UNS core and database schemas preserve their previous accepted inputs and
+defaults. The migration is nevertheless source-sensitive for applications that
+inspect Zod internals or use Zod-3-only type aliases. Replace those seams with
+the public Zod 4 API:
+
+- replace `z.AnyZodObject` with `z.ZodObject<z.ZodRawShape>`;
+- replace `z.ZodTypeAny` with `z.ZodType` where a broad schema type is needed;
+- read object keys through `.shape`, not `_def.shape()`;
+- pass both key and value schemas to `z.record(keySchema, valueSchema)`;
+- prefer object `.extend()` or shape spreading over deprecated `.merge()`.
+
+After updating the extension schema, run `pnpm run generate-config-schema` and
+check both `config.schema.json` and `src/config/app-config.ts`. Then run the
+application's typecheck and its existing configuration compatibility tests.
+
 ## 3.0.0 - MQTT table columns use named objects
 
 Apply this migration when upgrading from `@uns-kit/core` `<3.0.0` to
@@ -22,9 +47,7 @@ column directly addressable as, for example,
 Before:
 
 ```ts
-columns: [
-  { name: "power", type: "double", value: 42.1, uom: "kW" },
-]
+columns: [{ name: "power", type: "double", value: 42.1, uom: "kW" }];
 ```
 
 After:

package/dist/config/project.config.extension.d.ts

@@ -1,4 +1,4 @@
 import { z } from "zod";
-export declare const projectExtrasSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export declare const projectExtrasSchema: z.ZodObject<{}, z.core.$strip>;
 export type ProjectExtras = z.infer<typeof projectExtrasSchema>;
 //# sourceMappingURL=project.config.extension.d.ts.map

package/dist/config/project.config.extension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project.config.extension.d.ts","sourceRoot":"","sources":["../../src/config/project.config.extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB,gDAAe,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}
+{"version":3,"file":"project.config.extension.d.ts","sourceRoot":"","sources":["../../src/config/project.config.extension.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,mBAAmB,gCAAe,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAuEA,QAAA,MAAM,MAAM,0BAiBV,CAAC;AAEH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,4BAY3C;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAyEA,QAAA,MAAM,MAAM,0BAiBV,CAAC;AAEH,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,4BAU3C;AAED,eAAe,MAAM,CAAC"}

package/dist/logger.js

@@ -1,14 +1,15 @@
-import { createLogger, format, transports } from 'winston';
-import GelfTransport from 'winston-gelf';
-import os from 'os';
-import path from 'path';
-import fs from 'fs';
-import { fileURLToPath } from 'url';
-import { ConfigFile } from './config-file.js';
+/// <reference path="./types/winston-gelf.d.ts" />
+import fs from "fs";
+import os from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+import { createLogger, format, transports } from "winston";
+import GelfTransport from "winston-gelf";
+import { ConfigFile } from "./config-file.js";
 function loadPackageMeta() {
-    const packageJsonPath = path.join(process.cwd(), 'package.json');
+    const packageJsonPath = path.join(process.cwd(), "package.json");
     try {
-        const raw = fs.readFileSync(packageJsonPath, 'utf8');
+        const raw = fs.readFileSync(packageJsonPath, "utf8");
         const packageMeta = JSON.parse(raw);
         if (packageMeta.name || packageMeta.version) {
             return packageMeta;
@@ -30,54 +31,52 @@ function loadLoggingConfig() {
 const packageMeta = loadPackageMeta();
 const loggingConfig = loadLoggingConfig();
 const gelfMeta = {
-    service: packageMeta.name ?? 'unknown-service',
-    version: packageMeta.version ?? 'unknown',
-    environment: process.env.NODE_ENV || 'unknown',
-    hostname: os.hostname()
+    service: packageMeta.name ?? "unknown-service",
+    version: packageMeta.version ?? "unknown",
+    environment: process.env.NODE_ENV || "unknown",
+    hostname: os.hostname(),
 };
-const consoleFormat = format.combine(format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), format.errors({ stack: true }), format.splat(), format.json());
+const consoleFormat = format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.errors({ stack: true }), format.splat(), format.json());
 const loggerTransports = [
     new transports.Console({
-        format: consoleFormat
-    })
+        format: consoleFormat,
+    }),
 ];
 if (loggingConfig) {
     loggerTransports.push(new GelfTransport({
         format: format((info) => ({
             ...info,
-            ...gelfMeta
+            ...gelfMeta,
         }))(),
         gelfPro: {
             adapterName: loggingConfig.adapter,
             adapterOptions: {
                 host: loggingConfig.host,
-                port: loggingConfig.port
-            }
-        }
+                port: loggingConfig.port,
+            },
+        },
     }));
 }
 const logger = createLogger({
-    level: loggingConfig?.level ?? 'info',
-    format: format.combine(format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }), format.errors({ stack: true }), // Include stack trace
+    level: loggingConfig?.level ?? "info",
+    format: format.combine(format.timestamp({ format: "YYYY-MM-DD HH:mm:ss" }), format.errors({ stack: true }), // Include stack trace
     format.splat(), format.json()),
     transports: loggerTransports,
     exceptionHandlers: [
         new transports.Console({
-            format: consoleFormat
+            format: consoleFormat,
         }), // Log exceptions to console
         // Remove exception logging to file
         // new transports.File({ filename: 'logs/exceptions.log' })
-    ]
+    ],
 });
 export function getLogger(modulePath) {
-    const normalizedModulePath = modulePath.startsWith('file:')
-        ? fileURLToPath(modulePath)
-        : modulePath;
+    const normalizedModulePath = modulePath.startsWith("file:") ? fileURLToPath(modulePath) : modulePath;
     const relativePath = path.relative(process.cwd(), normalizedModulePath);
-    const withoutExt = relativePath.replace(/\.[^/.]+$/, '');
-    const dotted = withoutExt.split(path.sep).join('.');
+    const withoutExt = relativePath.replace(/\.[^/.]+$/, "");
+    const dotted = withoutExt.split(path.sep).join(".");
     return logger.child({
-        facility: dotted
+        facility: dotted,
     });
 }
 export default logger;

package/dist/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { createLogger, format, transports } from 'winston';\nimport GelfTransport from 'winston-gelf'\nimport os from 'os'\nimport path from 'path'\nimport fs from 'fs'\nimport { fileURLToPath } from 'url';\nimport { ConfigFile } from './config-file.js'\n\nfunction loadPackageMeta(): { name?: string; version?: string } {\n  const packageJsonPath = path.join(process.cwd(), 'package.json')\n\n  try {\n    const raw = fs.readFileSync(packageJsonPath, 'utf8')\n    const packageMeta = JSON.parse(raw) as { name?: string; version?: string }\n    if (packageMeta.name || packageMeta.version) {\n      return packageMeta\n    }\n  } catch {\n    // Use unknown values when the application package metadata is unavailable.\n  }\n\n  return {}\n}\n\nfunction loadLoggingConfig() {\n  try {\n    return ConfigFile.loadRawConfig().logging\n  } catch {\n    return undefined\n  }\n}\n\nconst packageMeta = loadPackageMeta()\nconst loggingConfig = loadLoggingConfig()\nconst gelfMeta = {\n  service: packageMeta.name ?? 'unknown-service',\n  version: packageMeta.version ?? 'unknown',\n  environment: process.env.NODE_ENV || 'unknown',\n  hostname: os.hostname()\n}\nconst consoleFormat = format.combine(\n  format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),\n  format.errors({ stack: true }),\n  format.splat(),\n  format.json()\n)\n\nconst loggerTransports = [\n  new transports.Console({\n    format: consoleFormat\n  })\n]\n\nif (loggingConfig) {\n  loggerTransports.push(\n    new GelfTransport({\n      format: format((info) => ({\n        ...info,\n        ...gelfMeta\n      }))(),\n      gelfPro: {\n        adapterName: loggingConfig.adapter,\n        adapterOptions: {\n          host: loggingConfig.host,\n          port: loggingConfig.port\n        }\n      }\n    })\n  )\n}\n\nconst logger = createLogger({\n  level: loggingConfig?.level ?? 'info',\n\n  format: format.combine(\n    format.timestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),\n    format.errors({ stack: true }), // Include stack trace\n    format.splat(),\n    format.json()\n  ),\n  transports: loggerTransports,\n  exceptionHandlers: [\n    new transports.Console({\n      format: consoleFormat\n    }), // Log exceptions to console\n    // Remove exception logging to file\n    // new transports.File({ filename: 'logs/exceptions.log' })\n  ]\n});\n\nexport function getLogger(modulePath: string) {\n  const normalizedModulePath = modulePath.startsWith('file:')\n    ? fileURLToPath(modulePath)\n    : modulePath\n\n  const relativePath = path.relative(process.cwd(), normalizedModulePath)\n  const withoutExt = relativePath.replace(/\\.[^/.]+$/, '')\n  const dotted = withoutExt.split(path.sep).join('.')\n\n  return logger.child({\n    facility: dotted\n  })\n}\n\nexport default logger\n"]}
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"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","sourcesContent":["/// <reference path=\"./types/winston-gelf.d.ts\" />\nimport fs from \"fs\";\nimport os from \"os\";\nimport path from \"path\";\nimport { fileURLToPath } from \"url\";\nimport { createLogger, format, transports } from \"winston\";\nimport GelfTransport from \"winston-gelf\";\n\nimport { ConfigFile } from \"./config-file.js\";\n\nfunction loadPackageMeta(): { name?: string; version?: string } {\n  const packageJsonPath = path.join(process.cwd(), \"package.json\");\n\n  try {\n    const raw = fs.readFileSync(packageJsonPath, \"utf8\");\n    const packageMeta = JSON.parse(raw) as { name?: string; version?: string };\n    if (packageMeta.name || packageMeta.version) {\n      return packageMeta;\n    }\n  } catch {\n    // Use unknown values when the application package metadata is unavailable.\n  }\n\n  return {};\n}\n\nfunction loadLoggingConfig() {\n  try {\n    return ConfigFile.loadRawConfig().logging;\n  } catch {\n    return undefined;\n  }\n}\n\nconst packageMeta = loadPackageMeta();\nconst loggingConfig = loadLoggingConfig();\nconst gelfMeta = {\n  service: packageMeta.name ?? \"unknown-service\",\n  version: packageMeta.version ?? \"unknown\",\n  environment: process.env.NODE_ENV || \"unknown\",\n  hostname: os.hostname(),\n};\nconst consoleFormat = format.combine(\n  format.timestamp({ format: \"YYYY-MM-DD HH:mm:ss\" }),\n  format.errors({ stack: true }),\n  format.splat(),\n  format.json(),\n);\n\nconst loggerTransports = [\n  new transports.Console({\n    format: consoleFormat,\n  }),\n];\n\nif (loggingConfig) {\n  loggerTransports.push(\n    new GelfTransport({\n      format: format((info) => ({\n        ...info,\n        ...gelfMeta,\n      }))(),\n      gelfPro: {\n        adapterName: loggingConfig.adapter,\n        adapterOptions: {\n          host: loggingConfig.host,\n          port: loggingConfig.port,\n        },\n      },\n    }),\n  );\n}\n\nconst logger = createLogger({\n  level: loggingConfig?.level ?? \"info\",\n\n  format: format.combine(\n    format.timestamp({ format: \"YYYY-MM-DD HH:mm:ss\" }),\n    format.errors({ stack: true }), // Include stack trace\n    format.splat(),\n    format.json(),\n  ),\n  transports: loggerTransports,\n  exceptionHandlers: [\n    new transports.Console({\n      format: consoleFormat,\n    }), // Log exceptions to console\n    // Remove exception logging to file\n    // new transports.File({ filename: 'logs/exceptions.log' })\n  ],\n});\n\nexport function getLogger(modulePath: string) {\n  const normalizedModulePath = modulePath.startsWith(\"file:\") ? fileURLToPath(modulePath) : modulePath;\n\n  const relativePath = path.relative(process.cwd(), normalizedModulePath);\n  const withoutExt = relativePath.replace(/\\.[^/.]+$/, \"\");\n  const dotted = withoutExt.split(path.sep).join(\".\");\n\n  return logger.child({\n    facility: dotted,\n  });\n}\n\nexport default logger;\n"]}

package/dist/tools/generate-config-schema.js

@@ -1,15 +1,48 @@
 import fs from "node:fs";
 import path from "node:path";
 import { pathToFileURL } from "node:url";
-import { zodToJsonSchema } from "zod-to-json-schema";
-import { zodToTs, printNode, withGetType } from "zod-to-ts";
+import { z } from "zod";
+import { createAuxiliaryTypeStore, printNode, zodToTs } from "zod-to-ts";
 import { hostValueSchema } from "../uns-config/host-placeholders.js";
-import { secretValueSchema } from "../uns-config/secret-placeholders.js";
 import { composeConfigSchema } from "../uns-config/schema-tools.js";
+import { secretValueSchema } from "../uns-config/secret-placeholders.js";
 function write(filePath, data) {
     fs.mkdirSync(path.dirname(filePath), { recursive: true });
     fs.writeFileSync(filePath, data);
 }
+function normalizeLegacyJsonSchema(value) {
+    if (Array.isArray(value)) {
+        value.forEach(normalizeLegacyJsonSchema);
+        return;
+    }
+    if (!value || typeof value !== "object") {
+        return;
+    }
+    const schema = value;
+    Object.values(schema).forEach(normalizeLegacyJsonSchema);
+    if (schema.type === "number" && schema.multipleOf === 1) {
+        schema.type = "integer";
+        delete schema.multipleOf;
+    }
+    if (schema.format === "email") {
+        delete schema.pattern;
+    }
+    if (Array.isArray(schema.oneOf) && !schema.anyOf) {
+        schema.anyOf = schema.oneOf;
+        delete schema.oneOf;
+    }
+    if (Array.isArray(schema.anyOf)) {
+        const literalOptions = schema.anyOf;
+        const literalType = literalOptions[0]?.type;
+        if (literalOptions.length > 0 &&
+            typeof literalType === "string" &&
+            literalOptions.every((option) => option.type === literalType && Object.hasOwn(option, "const"))) {
+            schema.type = literalType;
+            schema.enum = literalOptions.map((option) => option.const);
+            delete schema.anyOf;
+        }
+    }
+}
 let tsLoaderReady = false;
 async function ensureTsLoader() {
     if (tsLoaderReady) {
@@ -19,7 +52,7 @@ async function ensureTsLoader() {
     try {
         await import("tsx/esm");
     }
-    catch (error) {
+    catch {
         throw new Error("Unable to load TypeScript project.config.extension. Install 'tsx' (e.g. pnpm add -D tsx) or provide a compiled JavaScript file.");
     }
 }
@@ -53,18 +86,40 @@ async function loadProjectExtrasSchema() {
 // Keep placeholder-backed values as plain strings in the generated TypeScript typings so
 // consuming code reflects the resolved shapes while the JSON schema still exposes full unions.
 const renderAsString = (typescript) => typescript.factory.createKeywordTypeNode(typescript.SyntaxKind.StringKeyword);
-for (const schema of [hostValueSchema, secretValueSchema]) {
-    withGetType(schema, renderAsString);
-}
+const typeOverrides = new Map();
+typeOverrides.set(hostValueSchema, renderAsString);
+typeOverrides.set(secretValueSchema, renderAsString);
 const { unsCoreSchema } = await import("../uns-config/uns-core-schema.js");
 const projectExtrasSchema = await loadProjectExtrasSchema();
 const baseSchema = composeConfigSchema(unsCoreSchema, projectExtrasSchema).strict();
 // 1) JSON Schema for VS Code $schema
-const jsonSchema = zodToJsonSchema(baseSchema, "AppConfig");
+const generatedJsonSchema = z.toJSONSchema(baseSchema, {
+    io: "input",
+    reused: "inline",
+    target: "draft-07",
+});
+normalizeLegacyJsonSchema(generatedJsonSchema);
+const { $schema, definitions: reusedDefinitions, ...appConfigDefinition } = generatedJsonSchema;
+const jsonSchema = {
+    $ref: "#/definitions/AppConfig",
+    definitions: {
+        AppConfig: appConfigDefinition,
+        ...(reusedDefinitions ?? {}),
+    },
+    $schema,
+};
 write(path.resolve("config.schema.json"), JSON.stringify(jsonSchema, null, 2));
 // 2) TypeScript `export type AppConfig = {...}`
-const { node } = zodToTs(baseSchema, "AppConfig");
-const interfaceBody = printNode(node);
+const auxiliaryTypeStore = createAuxiliaryTypeStore();
+const { node } = zodToTs(baseSchema, {
+    auxiliaryTypeStore,
+    io: "input",
+    overrides: typeOverrides,
+});
+const interfaceBody = printNode(node)
+    .replace(/^\s*\[x: string\]: never;\n/gm, "")
+    .replace(/\[key: string\]:/g, "[x: string]:");
+const auxiliaryTypes = [...auxiliaryTypeStore.definitions.values()].map((definition) => printNode(definition.node)).join("\n");
 let shouldAugment = true;
 try {
     const pkgJsonPath = path.resolve(process.cwd(), "package.json");
@@ -81,7 +136,8 @@ catch {
 const augmentationBlock = shouldAugment
     ? `\n\ntype GeneratedProjectAppConfig = ProjectAppConfig;\ntype GeneratedAppConfig = AppConfig;\n\ndeclare module "@uns-kit/core/config/app-config.js" {\n  interface ProjectAppConfig extends GeneratedProjectAppConfig {}\n  interface AppConfig extends GeneratedAppConfig {}\n}\n`
     : "\n";
-const tsContent = `/* Auto-generated. Do not edit by hand. */\nexport interface ProjectAppConfig ${interfaceBody}\n\nexport interface AppConfig extends ProjectAppConfig {}${augmentationBlock}`;
+const auxiliaryPreamble = auxiliaryTypes ? `${auxiliaryTypes}\n\n` : "";
+const tsContent = `/* Auto-generated. Do not edit by hand. */\n${auxiliaryPreamble}export interface ProjectAppConfig ${interfaceBody}\n\nexport interface AppConfig extends ProjectAppConfig {}${augmentationBlock}`;
 write(path.resolve("./src/config/app-config.ts"), tsContent);
 console.log("Generated config.schema.json and updated src/config/app-config.ts");
 //# sourceMappingURL=generate-config-schema.js.map

package/dist/tools/generate-config-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"generate-config-schema.js","sourceRoot":"","sources":["../../src/tools/generate-config-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG5D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAEpE,SAAS,KAAK,CAAC,QAAgB,EAAE,IAAY;IAC3C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,KAAK,UAAU,cAAc;IAC3B,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO;IACT,CAAC;IACD,aAAa,GAAG,IAAI,CAAC;IACrB,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CACb,iIAAiI,CAClI,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,uBAAuB;IACpC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,qCAAqC,CAAC,CAAC;IAChF,MAAM,UAAU,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAEtE,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QACvD,IAAI,CAAC;YACH,IAAI,QAAQ,KAAK,KAAK,IAAI,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,MAAM,EAAE,CAAC;gBACrE,MAAM,cAAc,EAAE,CAAC;YACzB,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC;YAC3D,IAAI,MAAM,EAAE,mBAAmB,EAAE,CAAC;gBAChC,OAAO,MAAM,CAAC,mBAAqC,CAAC;YACtD,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,WAAW,SAAS,wCAAwC,CAAC,CAAC;QAChF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACtE,MAAM,IAAI,KAAK,CAAC,+CAA+C,SAAS,MAAM,MAAM,EAAE,CAAC,CAAC;QAC1F,CAAC;IACH,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;IACzE,OAAO,UAAU,CAAC,mBAAqC,CAAC;AAC1D,CAAC;AAED,yFAAyF;AACzF,+FAA+F;AAC/F,MAAM,cAAc,GAAG,CAAC,UAAe,EAAE,EAAE,CACzC,UAAU,CAAC,OAAO,CAAC,qBAAqB,CAAC,UAAU,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;AAEhF,KAAK,MAAM,MAAM,IAAI,CAAC,eAAe,EAAE,iBAAiB,CAAC,EAAE,CAAC;IAC1D,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,kCAAkC,CAAC,CAAC;AAC3E,MAAM,mBAAmB,GAAG,MAAM,uBAAuB,EAAE,CAAC;AAC5D,MAAM,UAAU,GAAG,mBAAmB,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,MAAM,EAAE,CAAC;AAEpF,qCAAqC;AACrC,MAAM,UAAU,GAAG,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/E,gDAAgD;AAChD,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;AAClD,MAAM,aAAa,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAEtC,IAAI,aAAa,GAAG,IAAI,CAAC;AACzB,IAAI,CAAC;IACH,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,cAAc,CAAC,CAAC;IAChE,IAAI,EAAE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7D,IAAI,GAAG,EAAE,IAAI,KAAK,eAAe,EAAE,CAAC;YAClC,aAAa,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;AACH,CAAC;AAAC,MAAM,CAAC;IACP,aAAa,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,iBAAiB,GAAG,aAAa;IACrC,CAAC,CAAC,oRAAoR;IACtR,CAAC,CAAC,IAAI,CAAC;AAET,MAAM,SAAS,GAAG,iFAAiF,aAAa,6DAA6D,iBAAiB,EAAE,CAAC;AAEjM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,4BAA4B,CAAC,EAAE,SAAS,CAAC,CAAC;AAE7D,OAAO,CAAC,GAAG,CAAC,mEAAmE,CAAC,CAAC","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { zodToJsonSchema } from \"zod-to-json-schema\";\nimport { zodToTs, printNode, withGetType } from \"zod-to-ts\";\nimport { z } from \"zod\";\n\nimport { hostValueSchema } from \"../uns-config/host-placeholders.js\";\nimport { secretValueSchema } from \"../uns-config/secret-placeholders.js\";\nimport { composeConfigSchema } from \"../uns-config/schema-tools.js\";\n\nfunction write(filePath: string, data: string) {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  fs.writeFileSync(filePath, data);\n}\n\nlet tsLoaderReady = false;\n\nasync function ensureTsLoader(): Promise<void> {\n  if (tsLoaderReady) {\n    return;\n  }\n  tsLoaderReady = true;\n  try {\n    await import(\"tsx/esm\");\n  } catch (error) {\n    throw new Error(\n      \"Unable to load TypeScript project.config.extension. Install 'tsx' (e.g. pnpm add -D tsx) or provide a compiled JavaScript file.\",\n    );\n  }\n}\n\nasync function loadProjectExtrasSchema(): Promise<z.AnyZodObject> {\n  const base = path.resolve(process.cwd(), \"src/config/project.config.extension\");\n  const extensions = [\"\", \".ts\", \".mts\", \".tsx\", \".js\", \".mjs\", \".cjs\"];\n\n  for (const ext of extensions) {\n    const candidate = ext ? `${base}${ext}` : base;\n    if (!fs.existsSync(candidate)) {\n      continue;\n    }\n\n    const lowerExt = path.extname(candidate).toLowerCase();\n    try {\n      if (lowerExt === \".ts\" || lowerExt === \".mts\" || lowerExt === \".tsx\") {\n        await ensureTsLoader();\n      }\n\n      const module = await import(pathToFileURL(candidate).href);\n      if (module?.projectExtrasSchema) {\n        return module.projectExtrasSchema as z.AnyZodObject;\n      }\n\n      throw new Error(`Module '${candidate}' does not export projectExtrasSchema.`);\n    } catch (error) {\n      const reason = error instanceof Error ? error.message : String(error);\n      throw new Error(`Failed to load project config extension at '${candidate}': ${reason}`);\n    }\n  }\n\n  const coreModule = await import(\"../config/project.config.extension.js\");\n  return coreModule.projectExtrasSchema as z.AnyZodObject;\n}\n\n// Keep placeholder-backed values as plain strings in the generated TypeScript typings so\n// consuming code reflects the resolved shapes while the JSON schema still exposes full unions.\nconst renderAsString = (typescript: any) =>\n  typescript.factory.createKeywordTypeNode(typescript.SyntaxKind.StringKeyword);\n\nfor (const schema of [hostValueSchema, secretValueSchema]) {\n  withGetType(schema, renderAsString);\n}\n\nconst { unsCoreSchema } = await import(\"../uns-config/uns-core-schema.js\");\nconst projectExtrasSchema = await loadProjectExtrasSchema();\nconst baseSchema = composeConfigSchema(unsCoreSchema, projectExtrasSchema).strict();\n\n// 1) JSON Schema for VS Code $schema\nconst jsonSchema = zodToJsonSchema(baseSchema, \"AppConfig\");\nwrite(path.resolve(\"config.schema.json\"), JSON.stringify(jsonSchema, null, 2));\n\n// 2) TypeScript `export type AppConfig = {...}`\nconst { node } = zodToTs(baseSchema, \"AppConfig\");\nconst interfaceBody = printNode(node);\n\nlet shouldAugment = true;\ntry {\n  const pkgJsonPath = path.resolve(process.cwd(), \"package.json\");\n  if (fs.existsSync(pkgJsonPath)) {\n    const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, \"utf8\"));\n    if (pkg?.name === \"@uns-kit/core\") {\n      shouldAugment = false;\n    }\n  }\n} catch {\n  shouldAugment = true;\n}\n\nconst augmentationBlock = shouldAugment\n  ? `\\n\\ntype GeneratedProjectAppConfig = ProjectAppConfig;\\ntype GeneratedAppConfig = AppConfig;\\n\\ndeclare module \"@uns-kit/core/config/app-config.js\" {\\n  interface ProjectAppConfig extends GeneratedProjectAppConfig {}\\n  interface AppConfig extends GeneratedAppConfig {}\\n}\\n`\n  : \"\\n\";\n\nconst tsContent = `/* Auto-generated. Do not edit by hand. */\\nexport interface ProjectAppConfig ${interfaceBody}\\n\\nexport interface AppConfig extends ProjectAppConfig {}${augmentationBlock}`;\n\nwrite(path.resolve(\"./src/config/app-config.ts\"), tsContent);\n\nconsole.log(\"Generated config.schema.json and updated src/config/app-config.ts\");\n"]}
+{"version":3,"file":"generate-config-schema.js","sourceRoot":"","sources":["../../src/tools/generate-config-schema.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport { z } from \"zod\";\nimport { type TypeOverrideMap, createAuxiliaryTypeStore, printNode, zodToTs } from \"zod-to-ts\";\n\nimport { hostValueSchema } from \"../uns-config/host-placeholders.js\";\nimport { type ConfigObjectSchema, composeConfigSchema } from \"../uns-config/schema-tools.js\";\nimport { secretValueSchema } from \"../uns-config/secret-placeholders.js\";\n\nfunction write(filePath: string, data: string) {\n  fs.mkdirSync(path.dirname(filePath), { recursive: true });\n  fs.writeFileSync(filePath, data);\n}\n\ntype JsonSchemaRecord = Record<string, unknown>;\n\nfunction normalizeLegacyJsonSchema(value: unknown): void {\n  if (Array.isArray(value)) {\n    value.forEach(normalizeLegacyJsonSchema);\n    return;\n  }\n  if (!value || typeof value !== \"object\") {\n    return;\n  }\n\n  const schema = value as JsonSchemaRecord;\n  Object.values(schema).forEach(normalizeLegacyJsonSchema);\n\n  if (schema.type === \"number\" && schema.multipleOf === 1) {\n    schema.type = \"integer\";\n    delete schema.multipleOf;\n  }\n  if (schema.format === \"email\") {\n    delete schema.pattern;\n  }\n  if (Array.isArray(schema.oneOf) && !schema.anyOf) {\n    schema.anyOf = schema.oneOf;\n    delete schema.oneOf;\n  }\n\n  if (Array.isArray(schema.anyOf)) {\n    const literalOptions = schema.anyOf as JsonSchemaRecord[];\n    const literalType = literalOptions[0]?.type;\n    if (\n      literalOptions.length > 0 &&\n      typeof literalType === \"string\" &&\n      literalOptions.every((option) => option.type === literalType && Object.hasOwn(option, \"const\"))\n    ) {\n      schema.type = literalType;\n      schema.enum = literalOptions.map((option) => option.const);\n      delete schema.anyOf;\n    }\n  }\n}\n\nlet tsLoaderReady = false;\n\nasync function ensureTsLoader(): Promise<void> {\n  if (tsLoaderReady) {\n    return;\n  }\n  tsLoaderReady = true;\n  try {\n    await import(\"tsx/esm\");\n  } catch {\n    throw new Error(\n      \"Unable to load TypeScript project.config.extension. Install 'tsx' (e.g. pnpm add -D tsx) or provide a compiled JavaScript file.\",\n    );\n  }\n}\n\nasync function loadProjectExtrasSchema(): Promise<ConfigObjectSchema> {\n  const base = path.resolve(process.cwd(), \"src/config/project.config.extension\");\n  const extensions = [\"\", \".ts\", \".mts\", \".tsx\", \".js\", \".mjs\", \".cjs\"];\n\n  for (const ext of extensions) {\n    const candidate = ext ? `${base}${ext}` : base;\n    if (!fs.existsSync(candidate)) {\n      continue;\n    }\n\n    const lowerExt = path.extname(candidate).toLowerCase();\n    try {\n      if (lowerExt === \".ts\" || lowerExt === \".mts\" || lowerExt === \".tsx\") {\n        await ensureTsLoader();\n      }\n\n      const module = await import(pathToFileURL(candidate).href);\n      if (module?.projectExtrasSchema) {\n        return module.projectExtrasSchema as ConfigObjectSchema;\n      }\n\n      throw new Error(`Module '${candidate}' does not export projectExtrasSchema.`);\n    } catch (error) {\n      const reason = error instanceof Error ? error.message : String(error);\n      throw new Error(`Failed to load project config extension at '${candidate}': ${reason}`);\n    }\n  }\n\n  const coreModule = await import(\"../config/project.config.extension.js\");\n  return coreModule.projectExtrasSchema as ConfigObjectSchema;\n}\n\n// Keep placeholder-backed values as plain strings in the generated TypeScript typings so\n// consuming code reflects the resolved shapes while the JSON schema still exposes full unions.\nconst renderAsString: TypeOverrideMap extends Map<unknown, infer TOverride> ? TOverride : never = (typescript) =>\n  typescript.factory.createKeywordTypeNode(typescript.SyntaxKind.StringKeyword);\n\nconst typeOverrides: TypeOverrideMap = new Map();\ntypeOverrides.set(hostValueSchema, renderAsString);\ntypeOverrides.set(secretValueSchema, renderAsString);\n\nconst { unsCoreSchema } = await import(\"../uns-config/uns-core-schema.js\");\nconst projectExtrasSchema = await loadProjectExtrasSchema();\nconst baseSchema = composeConfigSchema(unsCoreSchema, projectExtrasSchema).strict();\n\n// 1) JSON Schema for VS Code $schema\nconst generatedJsonSchema = z.toJSONSchema(baseSchema, {\n  io: \"input\",\n  reused: \"inline\",\n  target: \"draft-07\",\n});\nnormalizeLegacyJsonSchema(generatedJsonSchema);\nconst { $schema, definitions: reusedDefinitions, ...appConfigDefinition } = generatedJsonSchema;\nconst jsonSchema = {\n  $ref: \"#/definitions/AppConfig\",\n  definitions: {\n    AppConfig: appConfigDefinition,\n    ...((reusedDefinitions ?? {}) as Record<string, unknown>),\n  },\n  $schema,\n};\nwrite(path.resolve(\"config.schema.json\"), JSON.stringify(jsonSchema, null, 2));\n\n// 2) TypeScript `export type AppConfig = {...}`\nconst auxiliaryTypeStore = createAuxiliaryTypeStore();\nconst { node } = zodToTs(baseSchema, {\n  auxiliaryTypeStore,\n  io: \"input\",\n  overrides: typeOverrides,\n});\nconst interfaceBody = printNode(node)\n  .replace(/^\\s*\\[x: string\\]: never;\\n/gm, \"\")\n  .replace(/\\[key: string\\]:/g, \"[x: string]:\");\nconst auxiliaryTypes = [...auxiliaryTypeStore.definitions.values()].map((definition) => printNode(definition.node)).join(\"\\n\");\n\nlet shouldAugment = true;\ntry {\n  const pkgJsonPath = path.resolve(process.cwd(), \"package.json\");\n  if (fs.existsSync(pkgJsonPath)) {\n    const pkg = JSON.parse(fs.readFileSync(pkgJsonPath, \"utf8\"));\n    if (pkg?.name === \"@uns-kit/core\") {\n      shouldAugment = false;\n    }\n  }\n} catch {\n  shouldAugment = true;\n}\n\nconst augmentationBlock = shouldAugment\n  ? `\\n\\ntype GeneratedProjectAppConfig = ProjectAppConfig;\\ntype GeneratedAppConfig = AppConfig;\\n\\ndeclare module \"@uns-kit/core/config/app-config.js\" {\\n  interface ProjectAppConfig extends GeneratedProjectAppConfig {}\\n  interface AppConfig extends GeneratedAppConfig {}\\n}\\n`\n  : \"\\n\";\n\nconst auxiliaryPreamble = auxiliaryTypes ? `${auxiliaryTypes}\\n\\n` : \"\";\nconst tsContent = `/* Auto-generated. Do not edit by hand. */\\n${auxiliaryPreamble}export interface ProjectAppConfig ${interfaceBody}\\n\\nexport interface AppConfig extends ProjectAppConfig {}${augmentationBlock}`;\n\nwrite(path.resolve(\"./src/config/app-config.ts\"), tsContent);\n\nconsole.log(\"Generated config.schema.json and updated src/config/app-config.ts\");\n"]}

package/dist/uns/uns-attributes.d.ts

@@ -1,7 +1,7 @@
 import { GeneratedAttributes } from "./uns-dictionary.generated.js";
-export declare const knownUnsAttributes: ("status" | "level" | "active-energy-delivered" | "active-energy-received" | "alarm" | "assigned-to" | "authorization-level" | "availability" | "batch-number" | "conductivity" | "consumption" | "consumption-rate" | "cost" | "current" | "deviation" | "downtime" | "duration" | "end-time" | "energy" | "energy-consumption" | "fault-code" | "flow" | "frequency" | "hardness" | "inspection-result" | "instruction-url" | "last-refill" | "location" | "lot-id" | "maintenance-status" | "material-composition" | "material-type" | "operating-hours" | "operator-id" | "output-quantity" | "pass-fail" | "ph" | "planned-end" | "planned-start" | "power" | "presence" | "pressure" | "product-code" | "quantity" | "reactive-energy-delivered" | "reactive-energy-received" | "refill-required" | "revision" | "role" | "specification" | "speed" | "start-time" | "surface-defect" | "target-parameters" | "task-id" | "task-list" | "temperature" | "tensile-strength" | "total-flow" | "utilization" | "version-history" | "vibration" | "voltage" | "work-order-id")[];
+export declare const knownUnsAttributes: ("level" | "active-energy-delivered" | "active-energy-received" | "alarm" | "assigned-to" | "authorization-level" | "availability" | "batch-number" | "conductivity" | "consumption" | "consumption-rate" | "cost" | "current" | "deviation" | "downtime" | "duration" | "end-time" | "energy" | "energy-consumption" | "fault-code" | "flow" | "frequency" | "hardness" | "inspection-result" | "instruction-url" | "last-refill" | "location" | "lot-id" | "maintenance-status" | "material-composition" | "material-type" | "operating-hours" | "operator-id" | "output-quantity" | "pass-fail" | "ph" | "planned-end" | "planned-start" | "power" | "presence" | "pressure" | "product-code" | "quantity" | "reactive-energy-delivered" | "reactive-energy-received" | "refill-required" | "revision" | "role" | "specification" | "speed" | "start-time" | "status" | "surface-defect" | "target-parameters" | "task-id" | "task-list" | "temperature" | "tensile-strength" | "total-flow" | "utilization" | "version-history" | "vibration" | "voltage" | "work-order-id")[];
 export type KnownUnsAttributeName = typeof GeneratedAttributes[keyof typeof GeneratedAttributes];
 export type UnsAttribute = "" | KnownUnsAttributeName | (string & {});
-export declare const AttributeDescriptions: Record<"status" | "level" | "active-energy-delivered" | "active-energy-received" | "alarm" | "assigned-to" | "authorization-level" | "availability" | "batch-number" | "conductivity" | "consumption" | "consumption-rate" | "cost" | "current" | "deviation" | "downtime" | "duration" | "end-time" | "energy" | "energy-consumption" | "fault-code" | "flow" | "frequency" | "hardness" | "inspection-result" | "instruction-url" | "last-refill" | "location" | "lot-id" | "maintenance-status" | "material-composition" | "material-type" | "operating-hours" | "operator-id" | "output-quantity" | "pass-fail" | "ph" | "planned-end" | "planned-start" | "power" | "presence" | "pressure" | "product-code" | "quantity" | "reactive-energy-delivered" | "reactive-energy-received" | "refill-required" | "revision" | "role" | "specification" | "speed" | "start-time" | "surface-defect" | "target-parameters" | "task-id" | "task-list" | "temperature" | "tensile-strength" | "total-flow" | "utilization" | "version-history" | "vibration" | "voltage" | "work-order-id", string>;
+export declare const AttributeDescriptions: Record<"level" | "active-energy-delivered" | "active-energy-received" | "alarm" | "assigned-to" | "authorization-level" | "availability" | "batch-number" | "conductivity" | "consumption" | "consumption-rate" | "cost" | "current" | "deviation" | "downtime" | "duration" | "end-time" | "energy" | "energy-consumption" | "fault-code" | "flow" | "frequency" | "hardness" | "inspection-result" | "instruction-url" | "last-refill" | "location" | "lot-id" | "maintenance-status" | "material-composition" | "material-type" | "operating-hours" | "operator-id" | "output-quantity" | "pass-fail" | "ph" | "planned-end" | "planned-start" | "power" | "presence" | "pressure" | "product-code" | "quantity" | "reactive-energy-delivered" | "reactive-energy-received" | "refill-required" | "revision" | "role" | "specification" | "speed" | "start-time" | "status" | "surface-defect" | "target-parameters" | "task-id" | "task-list" | "temperature" | "tensile-strength" | "total-flow" | "utilization" | "version-history" | "vibration" | "voltage" | "work-order-id", string>;
 export declare function getAttributeDescription(name: string): string | undefined;
 //# sourceMappingURL=uns-attributes.d.ts.map

package/dist/uns/uns-interfaces.d.ts

@@ -11,7 +11,9 @@ export declare function isIOS8601Type(value: string): value is ISO8601;
 export type UnsAttribute = KnownUnsAttributeName | (string & {});
 export declare const valueTypes: readonly ["string", "number"];
 export type ValueTypeString = (typeof valueTypes)[number];
-export type ValueType = string | number;
+export type ScalarValueType = string | number;
+/** Scalar telemetry or a scalar array used by metadata such as relationship evidence. */
+export type ValueType = ScalarValueType | ScalarValueType[];
 export type CounterResetPolicy = "new-value" | "null" | "rollover" | (string & {});
 export type UnsAttributeSystemRole = "relationship-evidence" | "lifecycle-start" | "lifecycle-end" | "lifecycle-time-source" | (string & {});
 export type UnsRelationshipEndpoint = "source" | "target";
@@ -177,6 +179,8 @@ export interface IUnsExtendedData extends IUnsData {
     valueType: ValueTypeString;
 }
 export interface IUnsData {
+    /** Domain-specific evidence/context fields may accompany the canonical value. */
+    [key: string]: unknown;
     time: ISO8601;
     value: ValueType;
     /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */

package/dist/uns/uns-interfaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"uns-interfaces.d.ts","sourceRoot":"","sources":["../../src/uns/uns-interfaces.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"uns-interfaces.d.ts","sourceRoot":"","sources":["../../src/uns/uns-interfaces.ts"],"names":[],"mappings":"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"}

package/dist/uns/uns-interfaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"uns-interfaces.js","sourceRoot":"","sources":["../../src/uns/uns-interfaces.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,YAAY,GAAG,+CAA+C,CAAC;IACrE,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAID,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AA2CxD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,WAAW;IACX,cAAc;IACd,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;CACD,CAAC;AAEX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,qBAAqB,CAAC,CAAC;AACvE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAW3C,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAC9B,CAAC;AACJ,CAAC","sourcesContent":["import { UnsAttributeType } from \"../graphql/schema.js\";\nimport { MeasurementUnit } from \"./uns-measurements.js\";\nimport { UnsTags } from \"./uns-tags.js\";\nimport type { UnsObjectId, UnsObjectType } from \"./uns-object.js\";\nimport type { UnsAsset } from \"./uns-asset.js\";\nimport type { IMqttConnectProperties, IMqttPublishOptions, IMqttServerConfig, MqttProtocol } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport { UnsTopics } from \"./uns-topics.js\";\nimport { knownUnsAttributes, type KnownUnsAttributeName } from \"./uns-attributes.js\";\n\nexport type ISO8601 = `${number}-${string}-${string}T${string}:${string}:${string}.${string}Z`;\nexport function isIOS8601Type(value: string): value is ISO8601 {\n  const iso8601Regex = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/;\n  return iso8601Regex.test(value);\n}\n// Known attribute names (with IntelliSense) while still allowing arbitrary strings.\nexport type UnsAttribute = KnownUnsAttributeName | (string & {});\n\nexport const valueTypes = [\"string\", \"number\"] as const;\nexport type ValueTypeString = (typeof valueTypes)[number];\nexport type ValueType = string | number;\n\nexport type CounterResetPolicy = \"new-value\" | \"null\" | \"rollover\" | (string & {});\n\nexport type UnsAttributeSystemRole =\n  | \"relationship-evidence\"\n  | \"lifecycle-start\"\n  | \"lifecycle-end\"\n  | \"lifecycle-time-source\"\n  | (string & {});\n\nexport type UnsRelationshipEndpoint = \"source\" | \"target\";\n\nexport interface IUnsRelationshipEvidenceMetadata {\n  relationshipKey: string;\n  ownerEndpoint?: UnsRelationshipEndpoint;\n  valueEndpoint?: UnsRelationshipEndpoint;\n  /** Scalar values produce one edge; array values produce one edge per ObjectId value. */\n  sourceObjectType?: UnsObjectType | (string & {});\n  targetObjectType?: UnsObjectType | (string & {});\n  sourceObjectIdFrom?: string;\n  targetObjectIdFrom?: string;\n  observedAtFrom?: string;\n  status?: \"suggested\" | \"accepted\" | (string & {});\n  defaultStatus?: \"suggested\" | \"accepted\" | (string & {});\n}\n\nexport interface IUnsLifecycleMetadata {\n  timestampFrom?: \"value\" | \"packetTimestamp\" | (string & {});\n  startValues?: string[];\n  endValues?: string[];\n}\n\nexport interface IUnsTableColumnMetadata {\n  name: string;\n  valueType?: ValueTypeString | (string & {});\n  presentationKind?: string;\n  defaultAggregation?: string;\n  counterResetPolicy?: CounterResetPolicy;\n}\n\nexport const questDbPrimitiveTypes = [\n  \"boolean\",\n  \"ipv4\",\n  \"byte\",\n  \"short\",\n  \"char\",\n  \"int\",\n  \"float\",\n  \"symbol\",\n  \"varchar\",\n  \"string\",\n  \"long\",\n  \"date\",\n  \"timestamp\",\n  \"timestamp_ns\",\n  \"double\",\n  \"uuid\",\n  \"binary\",\n  \"long256\",\n] as const;\n\nconst questDbPrimitiveTypeSet = new Set<string>(questDbPrimitiveTypes);\nconst questDbGeohashRegex = /^geohash\\(\\d+[bc]\\)$/;\nconst questDbDecimalRegex = /^decimal\\(\\d+,\\d+\\)$/;\nconst questDbArrayRegex = /^array<[^>]+>$/;\n\nexport type QuestDbPrimitiveType = (typeof questDbPrimitiveTypes)[number];\n\n// Supported QuestDB column types for UNS tables.\nexport type QuestDbType =\n  | QuestDbPrimitiveType\n  | `geohash(${number}${\"b\" | \"c\"})`\n  | `decimal(${number},${number})`\n  | `array<${string}>`;\n\nexport function isQuestDbType(value: unknown): value is QuestDbType {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  if (questDbPrimitiveTypeSet.has(value)) {\n    return true;\n  }\n  return (\n    questDbGeohashRegex.test(value) ||\n    questDbDecimalRegex.test(value) ||\n    questDbArrayRegex.test(value)\n  );\n}\n\nexport interface IUnsParameters {\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  publishThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  publishConcurrency?: number; // Maximum concurrent outgoing publishes; default is 1\n  maxPendingPublishes?: number; // Maximum pending publishes across the API boundary and worker; default is unlimited\n  subscribeThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  rejectUnauthorized?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n  /**\n   * Default MQTT publish options applied to all outgoing messages\n   * (e.g., qos, retain, messageExpiryInterval).\n   */\n  defaultPublishOptions?: IMqttPublishOptions;\n}\n\nexport interface IUnsProcessParameters {\n  processName: string;\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  rejectUnauthorized?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n}\n\nexport interface UnsEvents {\n  // Emitters in MqttProxy, UnsMqttProxy\n  input: { topic: string; message: string, packet: any };\n  mqttProxyStatus: { event: string, value: number, uom: MeasurementUnit, statusTopic: string };\n  \n  // Emitters in MqttProxy\n  error: { code: number; message: string };\n  \n  // Emitters in UnsMqttProxy\n  mqttWorker: { command: string, instanceName: string; batchSize: number, referenceHash: string };\n\n  // Emitter in UnsCronProxy\n  cronEvent: { event?: string; cronExpression?: string };\n\n  // Emitters in UnsApiProxy\n  apiGetEvent: {req: any, res: any};\n  apiPostEvent: {req: any, res: any};\n  apiPutEvent: {req: any, res: any};\n  apiPatchEvent: {req: any, res: any};\n  apiDeleteEvent: {req: any, res: any};\n\n  // Emitters in UnsProxy\n  unsProxyProducedTopics: { producedTopics: ITopicObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiEndpoints: { producedApiEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedServiceEndpoints: { producedServiceEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedDataOfferEndpoints: { producedDataOfferEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiCatchAll: { producedCatchall: IApiCatchallMapping[], statusTopic: string };\n\n  // Emitters in UnsProxy / UnsApiProxy\n  unsProxyProducedDataCatalogOffers: { producedDataCatalogOffers: unknown[], statusTopic: string };\n}\n\nexport interface IUnsExtendedData extends IUnsData {\n  valueType: ValueTypeString;\n}\n\nexport interface IUnsData {\n  time: ISO8601;\n  value: ValueType;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  uom?: MeasurementUnit;\n  foreignEventKey?: string;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IUnsTableColumn {\n  type: QuestDbType;\n  value: string | number | boolean | null;\n  uom?: MeasurementUnit;\n}\n\n/** MQTT table columns keyed by their stable UNS/QuestDB column name. */\nexport type IUnsTableColumns = Record<string, IUnsTableColumn>;\n\nexport interface IUnsTable {\n  time: ISO8601;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  columns: IUnsTableColumns;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IMqttAttributeMessage {\n  attribute: UnsAttribute;\n  description?: string;\n  tags?: UnsTags[];\n  attributeNeedsPersistence?: boolean | null;\n  /** Optional controller/UI grouping hint for this ObjectId node; does not affect storage/table naming. */\n  virtualGroup?: string;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /**\n   * Operator-facing presentation hint. Use \"counter\" for cumulative counter\n   * state; delta/rate should be requested from Datahub history APIs.\n   */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  /**\n   * How the controller determines if this attribute is live or stale.\n   * Defaults to `\"interval\"` with the controller's default interval (~120s) when omitted.\n   *\n   * @example\n   * // Sensor publishing every 2 seconds:\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Status attribute publishing every 2 seconds (string values like \"HEATING\"):\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Material location with ENTERED/EXITED lifecycle:\n   * { validityMode: \"lifecycle\", lifecycleEndValue: \"EXITED\" }\n   *\n   * // Static configuration value:\n   * { validityMode: \"static\" }\n   */\n  validityMode?: ValidityMode;\n  /**\n   * Expected publish interval in milliseconds. Only meaningful for `validityMode: \"interval\"`.\n   * The controller marks the attribute as stale after ~2× this value without a heartbeat update.\n   * Ignored for `\"lifecycle\"` and `\"static\"` modes.\n   */\n  expectedIntervalMs?: number;\n  /**\n   * The string value that marks a lifecycle as completed. Only meaningful for `validityMode: \"lifecycle\"`.\n   * When the attribute's current value matches this, the controller considers the lifecycle done.\n   * Example: `\"EXITED\"` for a location attribute with ENTERED/EXITED events.\n   */\n  lifecycleEndValue?: string;\n}\n\ntype AttributePayload =\n  | { message: IUnsMessage; data?: never; table?: never; createdAt?: never; expiresAt?: never }\n  | { message?: never; data: IUnsData; table?: never; createdAt?: ISO8601; expiresAt?: ISO8601 }\n  | { message?: never; data?: never; table: IUnsTable; createdAt?: ISO8601; expiresAt?: ISO8601 };\n\nexport type IMqttAttributeEntry = IMqttAttributeMessage & AttributePayload;\n\nexport interface IMqttPublishRequest {\n  topic: UnsTopics;\n  asset: UnsAsset;\n  assetDescription?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  attributes: IMqttAttributeEntry | IMqttAttributeEntry[];\n}\n\n// This interface represents a packet for a UNS system\nexport interface IUnsPacket {\n  // The message object of the packet\n  message: IUnsExtendedMessage;\n  \n  // The HMAC signature of the message\n  messageSignature?: string;\n\n  // Automatically calculated interval between two packets in ms\n  interval?: number;\n\n  // Current library version\n  readonly version: string;\n\n  // Autogenerated sequence number\n  sequenceId?: number;\n}\n\nexport interface IUnsPackatParameters {\n\n}\n\nexport interface IUnsMessage {\n    data?: IUnsData;\n    table?: IUnsTable;\n    expiresAt?: ISO8601;\n    createdAt?: ISO8601;\n}\n\nexport interface IUnsExtendedMessage extends IUnsMessage {\n  data?: IUnsExtendedData;\n}\n\n/**\n * Controls how the controller determines whether an attribute is live or stale.\n *\n * - `\"interval\"` — Attribute publishes periodically. Stale if no heartbeat within ~2× the expected interval.\n *   Use with `expectedIntervalMs`. Works for both numeric sensors (temperature every 2s)\n *   and string status attributes (status every 2s). Example:\n *   `{ validityMode: \"interval\", expectedIntervalMs: 2000 }`\n *\n * - `\"lifecycle\"` — Attribute represents a lifecycle with a start and end event.\n *   Use with `lifecycleEndValue` to mark the end state. Example: material location with \"ENTERED\" / \"EXITED\".\n *\n * - `\"static\"` — Attribute is set once and never changes (configuration, metadata). Always live.\n *\n * When omitted, defaults to `\"interval\"` with the controller's default interval (~120s).\n */\nexport type ValidityMode = \"interval\" | \"lifecycle\" | \"static\";\n\nexport interface ITopicObject {\n  timestamp: string;\n  attribute:string;\n  attributeType: UnsAttributeType;\n  topic:string;\n  description:string;\n  /** Storage/routing group observed on the latest data/table payload for this identity. */\n  dataGroup:string;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  tags:string[] | null;\n  attributeNeedsPersistence: boolean | null;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /** Operator-facing presentation hint, for example \"counter\" for cumulative counter state. */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  asset: UnsAsset;\n  assetDescription?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Liveliness validity mode — how the controller determines if this attribute is live/stale. */\n  validityMode?: ValidityMode;\n  /** For interval mode: expected publish interval in milliseconds (stale after ~2x this value). */\n  expectedIntervalMs?: number;\n  /** For lifecycle mode: the string value that marks the lifecycle as completed (e.g. \"EXITED\"). */\n  lifecycleEndValue?: string;\n}\n\n// API Interfaces below\nexport interface IApiObject {\n  timestamp: string;\n  attribute:string;\n  topic:string;\n  attributeType: UnsAttributeType;\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  apiDescription?: string; // Optional description for the API endpoint\n  apiHost: string; // Hostname of the service\n  apiEndpoint: string; // API endpoint for virtual topics\n  apiSwaggerEndpoint: string; // Swagger endpoint for API documentation\n  apiMethod: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\"; // HTTP method for API endpoint\n  apiQueryParams: QueryParamDef[]; // query parameters for the API endpoint\n  serviceApi?: Record<string, unknown> | null;\n  asset: UnsAsset;\n  objectType: UnsObjectType;\n  objectId: UnsObjectId;\n  controllerName?: string;\n  controllerHost?: string;\n  controllerPort?: string;\n  controllerPublicBase?: string;\n}\n\nexport interface IApiCatchallMapping {\n  topic: string;\n  apiBase: string;\n  apiBasePath: string;\n  swaggerPath: string;\n}\n\nexport interface QueryParamDef {\n  name: string;\n  type: \"string\" | \"number\" | \"boolean\";\n  required?: boolean;\n  description?: string;\n  /**\n   * Optional canonical chat alias used by assistant tooling.\n   * Typical values: from, to, limit, topic, timezone, summaryOnly.\n   */\n  chatCanonical?: string;\n  /**\n   * Optional default query value. Included in generated OpenAPI metadata.\n   */\n  defaultValue?: string | number | boolean;\n}\n\nexport interface ApiChatDefaults {\n  from?: string;\n  to?: string;\n  limit?: number;\n  topic?: string;\n  timezone?: string;\n  summaryOnly?: boolean;\n  [key: string]: string | number | boolean | undefined;\n}\n\nexport interface IApiProxyOptions {\n  jwtSecret?: string;\n  /**\n   * Public origin advertised for generated API endpoint metadata.\n   *\n   * Use a hostname or origin without a port (for example `127.0.0.1` or\n   * `http://service-name`) to keep the API server's actual listening port.\n   * An explicitly supplied port is preserved. Defaults to the machine's\n   * external IPv4 address for backwards compatibility.\n   */\n  publishedApiHost?: string;\n  jwks?: {\n    wellKnownJwksUrl: string;\n    activeKidUrl?: string;\n    cacheTtlMs?: number;\n    algorithms?: (\"RS256\" | \"RS384\" | \"RS512\")[];\n  };\n  /**\n   * Optional base prefixes to mount the API and swagger JSON under (e.g. \"/archiver-3\").\n   * Defaults to \"/api\" when not provided.\n   */\n  apiBasePath?: string;\n  swaggerBasePath?: string;\n  /**\n   * Skip mounting the default \"/api\" route. Useful when rebasing entirely under a custom prefix.\n   */\n  disableDefaultApiMount?: boolean;\n}\n\nexport interface IGetEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  queryParams?: QueryParamDef[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  /**\n   * Optional defaults consumed by chat tooling (published as OpenAPI vendor extension x-uns-chat.defaults).\n   */\n  chatDefaults?: ApiChatDefaults;\n}\n\nexport interface IPostEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  requestBody?: {\n    description?: string;\n    required?: boolean;\n    schema?: Record<string, unknown>;\n  };\n}\n\nexport interface IPutEndpointOptions extends IPostEndpointOptions {}\nexport interface IPatchEndpointOptions extends IPostEndpointOptions {}\nexport interface IDeleteEndpointOptions extends IPostEndpointOptions {}\n"]}
+{"version":3,"file":"uns-interfaces.js","sourceRoot":"","sources":["../../src/uns/uns-interfaces.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,MAAM,YAAY,GAAG,+CAA+C,CAAC;IACrE,OAAO,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAClC,CAAC;AAID,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAU,CAAC;AA6CxD,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,SAAS;IACT,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,OAAO;IACP,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,MAAM;IACN,MAAM;IACN,WAAW;IACX,cAAc;IACd,QAAQ;IACR,MAAM;IACN,QAAQ;IACR,SAAS;CACD,CAAC;AAEX,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,qBAAqB,CAAC,CAAC;AACvE,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AACnD,MAAM,iBAAiB,GAAG,gBAAgB,CAAC;AAW3C,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,uBAAuB,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,CACL,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC/B,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAC9B,CAAC;AACJ,CAAC","sourcesContent":["import { UnsAttributeType } from \"../graphql/schema.js\";\nimport { MeasurementUnit } from \"./uns-measurements.js\";\nimport { UnsTags } from \"./uns-tags.js\";\nimport type { UnsObjectId, UnsObjectType } from \"./uns-object.js\";\nimport type { UnsAsset } from \"./uns-asset.js\";\nimport type { IMqttConnectProperties, IMqttPublishOptions, IMqttServerConfig, MqttProtocol } from \"../uns-mqtt/mqtt-interfaces.js\";\nimport { UnsTopics } from \"./uns-topics.js\";\nimport { knownUnsAttributes, type KnownUnsAttributeName } from \"./uns-attributes.js\";\n\nexport type ISO8601 = `${number}-${string}-${string}T${string}:${string}:${string}.${string}Z`;\nexport function isIOS8601Type(value: string): value is ISO8601 {\n  const iso8601Regex = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$/;\n  return iso8601Regex.test(value);\n}\n// Known attribute names (with IntelliSense) while still allowing arbitrary strings.\nexport type UnsAttribute = KnownUnsAttributeName | (string & {});\n\nexport const valueTypes = [\"string\", \"number\"] as const;\nexport type ValueTypeString = (typeof valueTypes)[number];\nexport type ScalarValueType = string | number;\n/** Scalar telemetry or a scalar array used by metadata such as relationship evidence. */\nexport type ValueType = ScalarValueType | ScalarValueType[];\n\nexport type CounterResetPolicy = \"new-value\" | \"null\" | \"rollover\" | (string & {});\n\nexport type UnsAttributeSystemRole =\n  | \"relationship-evidence\"\n  | \"lifecycle-start\"\n  | \"lifecycle-end\"\n  | \"lifecycle-time-source\"\n  | (string & {});\n\nexport type UnsRelationshipEndpoint = \"source\" | \"target\";\n\nexport interface IUnsRelationshipEvidenceMetadata {\n  relationshipKey: string;\n  ownerEndpoint?: UnsRelationshipEndpoint;\n  valueEndpoint?: UnsRelationshipEndpoint;\n  /** Scalar values produce one edge; array values produce one edge per ObjectId value. */\n  sourceObjectType?: UnsObjectType | (string & {});\n  targetObjectType?: UnsObjectType | (string & {});\n  sourceObjectIdFrom?: string;\n  targetObjectIdFrom?: string;\n  observedAtFrom?: string;\n  status?: \"suggested\" | \"accepted\" | (string & {});\n  defaultStatus?: \"suggested\" | \"accepted\" | (string & {});\n}\n\nexport interface IUnsLifecycleMetadata {\n  timestampFrom?: \"value\" | \"packetTimestamp\" | (string & {});\n  startValues?: string[];\n  endValues?: string[];\n}\n\nexport interface IUnsTableColumnMetadata {\n  name: string;\n  valueType?: ValueTypeString | (string & {});\n  presentationKind?: string;\n  defaultAggregation?: string;\n  counterResetPolicy?: CounterResetPolicy;\n}\n\nexport const questDbPrimitiveTypes = [\n  \"boolean\",\n  \"ipv4\",\n  \"byte\",\n  \"short\",\n  \"char\",\n  \"int\",\n  \"float\",\n  \"symbol\",\n  \"varchar\",\n  \"string\",\n  \"long\",\n  \"date\",\n  \"timestamp\",\n  \"timestamp_ns\",\n  \"double\",\n  \"uuid\",\n  \"binary\",\n  \"long256\",\n] as const;\n\nconst questDbPrimitiveTypeSet = new Set<string>(questDbPrimitiveTypes);\nconst questDbGeohashRegex = /^geohash\\(\\d+[bc]\\)$/;\nconst questDbDecimalRegex = /^decimal\\(\\d+,\\d+\\)$/;\nconst questDbArrayRegex = /^array<[^>]+>$/;\n\nexport type QuestDbPrimitiveType = (typeof questDbPrimitiveTypes)[number];\n\n// Supported QuestDB column types for UNS tables.\nexport type QuestDbType =\n  | QuestDbPrimitiveType\n  | `geohash(${number}${\"b\" | \"c\"})`\n  | `decimal(${number},${number})`\n  | `array<${string}>`;\n\nexport function isQuestDbType(value: unknown): value is QuestDbType {\n  if (typeof value !== \"string\") {\n    return false;\n  }\n  if (questDbPrimitiveTypeSet.has(value)) {\n    return true;\n  }\n  return (\n    questDbGeohashRegex.test(value) ||\n    questDbDecimalRegex.test(value) ||\n    questDbArrayRegex.test(value)\n  );\n}\n\nexport interface IUnsParameters {\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  publishThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  publishConcurrency?: number; // Maximum concurrent outgoing publishes; default is 1\n  maxPendingPublishes?: number; // Maximum pending publishes across the API boundary and worker; default is unlimited\n  subscribeThrottlingDelay?: number; // Delay in milliseconds; default is 1ms\n  rejectUnauthorized?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n  /**\n   * Default MQTT publish options applied to all outgoing messages\n   * (e.g., qos, retain, messageExpiryInterval).\n   */\n  defaultPublishOptions?: IMqttPublishOptions;\n}\n\nexport interface IUnsProcessParameters {\n  processName: string;\n  mqttSubToTopics?: string | string[];\n  username?: string;\n  password?: string;\n  mqttSSL?: boolean;\n  clientId?: string;\n  hosts?: string[];\n  servers?: IMqttServerConfig[];\n  port?: number;\n  protocol?: MqttProtocol;\n  keepalive?: number;\n  clean?: boolean;\n  connectTimeout?: number;\n  reconnectPeriod?: number;\n  reconnectOnConnackError?: boolean;\n  resubscribe?: boolean;\n  queueQoSZero?: boolean;\n  rejectUnauthorized?: boolean;\n  properties?: IMqttConnectProperties;\n  ca?: string;\n  cert?: string;\n  key?: string;\n  servername?: string;\n}\n\nexport interface UnsEvents {\n  // Emitters in MqttProxy, UnsMqttProxy\n  input: { topic: string; message: string, packet: any };\n  mqttProxyStatus: { event: string, value: number, uom: MeasurementUnit, statusTopic: string };\n  \n  // Emitters in MqttProxy\n  error: { code: number; message: string };\n  \n  // Emitters in UnsMqttProxy\n  mqttWorker: { command: string, instanceName: string; batchSize: number, referenceHash: string };\n\n  // Emitter in UnsCronProxy\n  cronEvent: { event?: string; cronExpression?: string };\n\n  // Emitters in UnsApiProxy\n  apiGetEvent: {req: any, res: any};\n  apiPostEvent: {req: any, res: any};\n  apiPutEvent: {req: any, res: any};\n  apiPatchEvent: {req: any, res: any};\n  apiDeleteEvent: {req: any, res: any};\n\n  // Emitters in UnsProxy\n  unsProxyProducedTopics: { producedTopics: ITopicObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiEndpoints: { producedApiEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedServiceEndpoints: { producedServiceEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedDataOfferEndpoints: { producedDataOfferEndpoints: IApiObject[], statusTopic: string };\n\n  // Emitters in UnsProxy\n  unsProxyProducedApiCatchAll: { producedCatchall: IApiCatchallMapping[], statusTopic: string };\n\n  // Emitters in UnsProxy / UnsApiProxy\n  unsProxyProducedDataCatalogOffers: { producedDataCatalogOffers: unknown[], statusTopic: string };\n}\n\nexport interface IUnsExtendedData extends IUnsData {\n  valueType: ValueTypeString;\n}\n\nexport interface IUnsData {\n  /** Domain-specific evidence/context fields may accompany the canonical value. */\n  [key: string]: unknown;\n  time: ISO8601;\n  value: ValueType;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  uom?: MeasurementUnit;\n  foreignEventKey?: string;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IUnsTableColumn {\n  type: QuestDbType;\n  value: string | number | boolean | null;\n  uom?: MeasurementUnit;\n}\n\n/** MQTT table columns keyed by their stable UNS/QuestDB column name. */\nexport type IUnsTableColumns = Record<string, IUnsTableColumn>;\n\nexport interface IUnsTable {\n  time: ISO8601;\n  /** Storage/routing group for consumers such as archivers; not part of the UNS identity path. */\n  dataGroup?: string;\n  columns: IUnsTableColumns;\n  intervalStart?: ISO8601 | number;\n  intervalEnd?: ISO8601 | number;\n  windowStart?: ISO8601 | number;\n  windowEnd?: ISO8601 | number;\n  eventId?: string;\n  deleted?: boolean;\n  deletedAt?: ISO8601 | number;\n  lastSeen?: ISO8601 | number;\n}\n\nexport interface IMqttAttributeMessage {\n  attribute: UnsAttribute;\n  description?: string;\n  tags?: UnsTags[];\n  attributeNeedsPersistence?: boolean | null;\n  /** Optional controller/UI grouping hint for this ObjectId node; does not affect storage/table naming. */\n  virtualGroup?: string;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /**\n   * Operator-facing presentation hint. Use \"counter\" for cumulative counter\n   * state; delta/rate should be requested from Datahub history APIs.\n   */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  /**\n   * How the controller determines if this attribute is live or stale.\n   * Defaults to `\"interval\"` with the controller's default interval (~120s) when omitted.\n   *\n   * @example\n   * // Sensor publishing every 2 seconds:\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Status attribute publishing every 2 seconds (string values like \"HEATING\"):\n   * { validityMode: \"interval\", expectedIntervalMs: 2000 }\n   *\n   * // Material location with ENTERED/EXITED lifecycle:\n   * { validityMode: \"lifecycle\", lifecycleEndValue: \"EXITED\" }\n   *\n   * // Static configuration value:\n   * { validityMode: \"static\" }\n   */\n  validityMode?: ValidityMode;\n  /**\n   * Expected publish interval in milliseconds. Only meaningful for `validityMode: \"interval\"`.\n   * The controller marks the attribute as stale after ~2× this value without a heartbeat update.\n   * Ignored for `\"lifecycle\"` and `\"static\"` modes.\n   */\n  expectedIntervalMs?: number;\n  /**\n   * The string value that marks a lifecycle as completed. Only meaningful for `validityMode: \"lifecycle\"`.\n   * When the attribute's current value matches this, the controller considers the lifecycle done.\n   * Example: `\"EXITED\"` for a location attribute with ENTERED/EXITED events.\n   */\n  lifecycleEndValue?: string;\n}\n\ntype AttributePayload =\n  | { message: IUnsMessage; data?: never; table?: never; createdAt?: never; expiresAt?: never }\n  | { message?: never; data: IUnsData; table?: never; createdAt?: ISO8601; expiresAt?: ISO8601 }\n  | { message?: never; data?: never; table: IUnsTable; createdAt?: ISO8601; expiresAt?: ISO8601 };\n\nexport type IMqttAttributeEntry = IMqttAttributeMessage & AttributePayload;\n\nexport interface IMqttPublishRequest {\n  topic: UnsTopics;\n  asset: UnsAsset;\n  assetDescription?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  attributes: IMqttAttributeEntry | IMqttAttributeEntry[];\n}\n\n// This interface represents a packet for a UNS system\nexport interface IUnsPacket {\n  // The message object of the packet\n  message: IUnsExtendedMessage;\n  \n  // The HMAC signature of the message\n  messageSignature?: string;\n\n  // Automatically calculated interval between two packets in ms\n  interval?: number;\n\n  // Current library version\n  readonly version: string;\n\n  // Autogenerated sequence number\n  sequenceId?: number;\n}\n\nexport interface IUnsPackatParameters {\n\n}\n\nexport interface IUnsMessage {\n    data?: IUnsData;\n    table?: IUnsTable;\n    expiresAt?: ISO8601;\n    createdAt?: ISO8601;\n}\n\nexport interface IUnsExtendedMessage extends IUnsMessage {\n  data?: IUnsExtendedData;\n}\n\n/**\n * Controls how the controller determines whether an attribute is live or stale.\n *\n * - `\"interval\"` — Attribute publishes periodically. Stale if no heartbeat within ~2× the expected interval.\n *   Use with `expectedIntervalMs`. Works for both numeric sensors (temperature every 2s)\n *   and string status attributes (status every 2s). Example:\n *   `{ validityMode: \"interval\", expectedIntervalMs: 2000 }`\n *\n * - `\"lifecycle\"` — Attribute represents a lifecycle with a start and end event.\n *   Use with `lifecycleEndValue` to mark the end state. Example: material location with \"ENTERED\" / \"EXITED\".\n *\n * - `\"static\"` — Attribute is set once and never changes (configuration, metadata). Always live.\n *\n * When omitted, defaults to `\"interval\"` with the controller's default interval (~120s).\n */\nexport type ValidityMode = \"interval\" | \"lifecycle\" | \"static\";\n\nexport interface ITopicObject {\n  timestamp: string;\n  attribute:string;\n  attributeType: UnsAttributeType;\n  topic:string;\n  description:string;\n  /** Storage/routing group observed on the latest data/table payload for this identity. */\n  dataGroup:string;\n  /** Optional controller/UI grouping hint for ObjectId nodes; does not affect storage/table naming. */\n  virtualGroup?: string;\n  tags:string[] | null;\n  attributeNeedsPersistence: boolean | null;\n  /** Scalar value shape for schema/catalog consumers, for example \"number\" or \"string\". */\n  valueType?: ValueTypeString | (string & {});\n  /** Operator-facing presentation hint, for example \"counter\" for cumulative counter state. */\n  presentationKind?: string;\n  /** Preferred aggregation for sampled history views, for example \"last\". */\n  defaultAggregation?: string;\n  /** Reset handling hint for cumulative counters. Interpreted by Datahub APIs, not by the producer. */\n  counterResetPolicy?: CounterResetPolicy;\n  /** Field-level metadata for table columns that should behave as chartable series. */\n  tableColumns?: IUnsTableColumnMetadata[];\n  /** Optional schema-system role published into Datahub's attribute_schema.schema_json. */\n  systemRole?: UnsAttributeSystemRole;\n  /** Relationship materialization metadata for `systemRole: \"relationship-evidence\"`. */\n  relationshipEvidence?: IUnsRelationshipEvidenceMetadata;\n  /** Lifecycle metadata for lifecycle system roles. */\n  lifecycle?: IUnsLifecycleMetadata;\n  asset: UnsAsset;\n  assetDescription?: string;\n  objectType: UnsObjectType;\n  objectTypeDescription?: string;\n  objectId: UnsObjectId;\n  /** Liveliness validity mode — how the controller determines if this attribute is live/stale. */\n  validityMode?: ValidityMode;\n  /** For interval mode: expected publish interval in milliseconds (stale after ~2x this value). */\n  expectedIntervalMs?: number;\n  /** For lifecycle mode: the string value that marks the lifecycle as completed (e.g. \"EXITED\"). */\n  lifecycleEndValue?: string;\n}\n\n// API Interfaces below\nexport interface IApiObject {\n  timestamp: string;\n  attribute:string;\n  topic:string;\n  attributeType: UnsAttributeType;\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  apiDescription?: string; // Optional description for the API endpoint\n  apiHost: string; // Hostname of the service\n  apiEndpoint: string; // API endpoint for virtual topics\n  apiSwaggerEndpoint: string; // Swagger endpoint for API documentation\n  apiMethod: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\"; // HTTP method for API endpoint\n  apiQueryParams: QueryParamDef[]; // query parameters for the API endpoint\n  serviceApi?: Record<string, unknown> | null;\n  asset: UnsAsset;\n  objectType: UnsObjectType;\n  objectId: UnsObjectId;\n  controllerName?: string;\n  controllerHost?: string;\n  controllerPort?: string;\n  controllerPublicBase?: string;\n}\n\nexport interface IApiCatchallMapping {\n  topic: string;\n  apiBase: string;\n  apiBasePath: string;\n  swaggerPath: string;\n}\n\nexport interface QueryParamDef {\n  name: string;\n  type: \"string\" | \"number\" | \"boolean\";\n  required?: boolean;\n  description?: string;\n  /**\n   * Optional canonical chat alias used by assistant tooling.\n   * Typical values: from, to, limit, topic, timezone, summaryOnly.\n   */\n  chatCanonical?: string;\n  /**\n   * Optional default query value. Included in generated OpenAPI metadata.\n   */\n  defaultValue?: string | number | boolean;\n}\n\nexport interface ApiChatDefaults {\n  from?: string;\n  to?: string;\n  limit?: number;\n  topic?: string;\n  timezone?: string;\n  summaryOnly?: boolean;\n  [key: string]: string | number | boolean | undefined;\n}\n\nexport interface IApiProxyOptions {\n  jwtSecret?: string;\n  /**\n   * Public origin advertised for generated API endpoint metadata.\n   *\n   * Use a hostname or origin without a port (for example `127.0.0.1` or\n   * `http://service-name`) to keep the API server's actual listening port.\n   * An explicitly supplied port is preserved. Defaults to the machine's\n   * external IPv4 address for backwards compatibility.\n   */\n  publishedApiHost?: string;\n  jwks?: {\n    wellKnownJwksUrl: string;\n    activeKidUrl?: string;\n    cacheTtlMs?: number;\n    algorithms?: (\"RS256\" | \"RS384\" | \"RS512\")[];\n  };\n  /**\n   * Optional base prefixes to mount the API and swagger JSON under (e.g. \"/archiver-3\").\n   * Defaults to \"/api\" when not provided.\n   */\n  apiBasePath?: string;\n  swaggerBasePath?: string;\n  /**\n   * Skip mounting the default \"/api\" route. Useful when rebasing entirely under a custom prefix.\n   */\n  disableDefaultApiMount?: boolean;\n}\n\nexport interface IGetEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  queryParams?: QueryParamDef[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  /**\n   * Optional defaults consumed by chat tooling (published as OpenAPI vendor extension x-uns-chat.defaults).\n   */\n  chatDefaults?: ApiChatDefaults;\n}\n\nexport interface IPostEndpointOptions {\n  apiDescription?: string;\n  tags?: string[];\n  routeOnly?: boolean;\n  registryTopic?: \"api-endpoints\" | \"service-endpoints\" | \"data-offer-endpoints\";\n  serviceApi?: Record<string, unknown>;\n  requestBody?: {\n    description?: string;\n    required?: boolean;\n    schema?: Record<string, unknown>;\n  };\n}\n\nexport interface IPutEndpointOptions extends IPostEndpointOptions {}\nexport interface IPatchEndpointOptions extends IPostEndpointOptions {}\nexport interface IDeleteEndpointOptions extends IPostEndpointOptions {}\n"]}