@uns-kit/core 3.0.38 → 3.0.40

package/MIGRATIONS.md

@@ -9,6 +9,53 @@ 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.40 - Managed asynchronous MQTT input and bounded RAM output pressure
+
+When crossing `<3.0.40` to `>=3.0.40`, legacy input events and queue rejection
+remain unchanged. A consumer may opt into `managedInput: true`, then register
+exactly one `setInputHandler(async event => { ... })` before readiness. Await all
+publication/admitted work inside it. The worker advances its processed cursor only
+after completion; an application exception retains the original input and blocks
+automatic replay because external effects may be unknown.
+
+RAM publishers may combine a finite `maxPendingPublishes` with
+`publishBackpressure: { maxWaiting: 32 }`. Admission waits for capacity rather
+than raising the record bound. The waiter count is bounded too; it is not disk
+persistence, cancellation or permission to retry unknown effects. Persistent
+outboxes keep their own capacity policy and cannot select this RAM option.
+
+Managed input changes the semantic compatibility digest. Review an initial
+stop-before-start upgrade from an unmanaged input, then use matching peers for
+hot moves. Ordinary stop unsubscribes before draining accepted owned input; live
+handover retains its verified cutover cursor. A passive shadow is never activated
+by Stop. `installSignalHandlers({ retainOnFailure: true })` retains workers and
+pending work after an unconfirmed drain and allows a later signal to retry.
+Do not add a second signal owner or cache a failed application stop promise.
+The SDK announces cooperative-stop protocol1 only after installing its
+launch-bound handler. Upgrade to a Controller that honors this readiness and
+uses the shared `mqttCooperativeStopRequestSchema`; an older PM2 forced-stop
+deadline cannot be prevented by SDK signal handling. No Controller decision may
+depend on an application or profile name.
+See the [generic MQTT drain example](https://github.com/uns-openhub/uns-kit/blob/master/docs/mqtt-migration-drain.md#async-input-and-a-full-ram-publisher-3040).
+
+## 3.0.39 - Explicit read-only HTTP work during migration
+
+When crossing `<3.0.39` to `>=3.0.39`, existing handlers keep their conservative
+HTTP drain behavior. No MQTT format, ownership contract or Controller change is
+required. Applications that serve reads may opt in per handler using
+`await api.runReadOnlyRequest(res, async () => { /* complete the read */ })`.
+Declare the work before the first asynchronous step and await every admitted
+subtask inside the callback, including cancellation settlement. Use it only for
+work without external effects; neither GET nor POST establishes that property.
+
+A reader disconnect no longer poisons future drains for an opted-in handler,
+but drain still waits for actual handler completion, even after an early HTTP
+response. The helper does not cancel SQL, authorize access, retry a request or
+send a response. Keep application cancellation and error handling. An undeclared
+disconnect remains an unknown outcome and blocks handover. Do not wrap writes,
+publications or business mutations as reads to bypass that safeguard. See the
+[HTTP example](https://github.com/uns-openhub/uns-kit/blob/master/docs/mqtt-stateful-handover.md#http-readers-and-disconnects-3039).
+
 ## 3.0.38 - Bounded late-subscriber input boundary (format3)
 
 When crossing `<3.0.38` to `>=3.0.38`, non-opt-in applications keep their existing

package/dist/runtime/mqtt-drain.d.ts

@@ -3,6 +3,13 @@ import type { MqttPublishQueueStatus } from "../uns-mqtt/publish-queue-contract.
 /** Generic process-local handshake. The host supplies identity and durable receipts. */
 export declare const MQTT_DRAIN_HANDLER: unique symbol;
 export declare const MQTT_DRAIN_READY_EVENT = "uns-kit:mqtt-drain-ready";
+/** Launch-bound ordinary stop, sent by the authenticated host; never a forced stop. */
+export declare const MQTT_COOPERATIVE_STOP_TOPIC = "uns-kit:mqtt-stop:v1";
+export declare const mqttCooperativeStopRequestSchema: z.ZodObject<{
+    type: z.ZodLiteral<"uns-kit:mqtt-stop:v1">;
+    protocol: z.ZodLiteral<1>;
+    launchId: z.ZodString;
+}, z.core.$strict>;
 export declare const mqttDrainReceiptSchema: z.ZodObject<{
     protocol: z.ZodLiteral<1>;
     state: z.ZodLiteral<"drained">;

package/dist/runtime/mqtt-drain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mqtt-drain.d.ts","sourceRoot":"","sources":["../../src/runtime/mqtt-drain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,eAAsC,CAAC;AACtE,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,eAAO,MAAM,sBAAsB;;;;;kBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,eAAO,MAAM,yBAAyB;;kBAAoD,CAAC;AAC3F,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAa1E;AACD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,IAAI,IAAI,CAAC;IACtB,qBAAqB,IAAI,sBAAsB,GAAG,SAAS,CAAC;CAC7D;AAED,mFAAmF;AACnF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8B5B"}
+{"version":3,"file":"mqtt-drain.d.ts","sourceRoot":"","sources":["../../src/runtime/mqtt-drain.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,wFAAwF;AACxF,eAAO,MAAM,kBAAkB,eAAsC,CAAC;AACtE,eAAO,MAAM,sBAAsB,6BAA6B,CAAC;AACjE,uFAAuF;AACvF,eAAO,MAAM,2BAA2B,yBAAyB,CAAC;AAClE,eAAO,MAAM,gCAAgC;;;;kBAI3C,CAAC;AACH,eAAO,MAAM,sBAAsB;;;;;kBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AACtE,eAAO,MAAM,yBAAyB;;kBAAoD,CAAC;AAC3F,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS,CAa1E;AACD,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,aAAa,IAAI,IAAI,CAAC;IACtB,qBAAqB,IAAI,sBAAsB,GAAG,SAAS,CAAC;CAC7D;AAED,mFAAmF;AACnF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8B5B"}

package/dist/runtime/mqtt-drain.js

@@ -4,6 +4,13 @@ import path from "node:path";
 /** Generic process-local handshake. The host supplies identity and durable receipts. */
 export const MQTT_DRAIN_HANDLER = Symbol.for("uns-kit.mqtt-drain.v1");
 export const MQTT_DRAIN_READY_EVENT = "uns-kit:mqtt-drain-ready";
+/** Launch-bound ordinary stop, sent by the authenticated host; never a forced stop. */
+export const MQTT_COOPERATIVE_STOP_TOPIC = "uns-kit:mqtt-stop:v1";
+export const mqttCooperativeStopRequestSchema = z.strictObject({
+    type: z.literal(MQTT_COOPERATIVE_STOP_TOPIC),
+    protocol: z.literal(1),
+    launchId: z.string().min(1).max(512),
+});
 export const mqttDrainReceiptSchema = z.strictObject({
     protocol: z.literal(1),
     state: z.literal("drained"),

package/dist/runtime/mqtt-drain.js.map

@@ -1 +1 @@
-{"version":3,"file":"mqtt-drain.js","sourceRoot":"","sources":["../../src/runtime/mqtt-drain.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { MqttPublishQueueStatus } from \"../uns-mqtt/publish-queue-contract.js\";\n\n/** Generic process-local handshake. The host supplies identity and durable receipts. */\nexport const MQTT_DRAIN_HANDLER = Symbol.for(\"uns-kit.mqtt-drain.v1\");\nexport const MQTT_DRAIN_READY_EVENT = \"uns-kit:mqtt-drain-ready\";\nexport const mqttDrainReceiptSchema = z.strictObject({\n  protocol: z.literal(1),\n  state: z.literal(\"drained\"),\n  pendingRecords: z.literal(0),\n  outputs: z.number().int().min(0).max(64),\n});\nexport type MqttDrainReceipt = z.infer<typeof mqttDrainReceiptSchema>;\nexport const mqttDrainCapabilitySchema = z.strictObject({ protocolVersion: z.literal(1) });\nexport function readMqttDrainCapability(packageRoot: string): 1 | undefined {\n  const file = path.join(packageRoot, \"package.json\");\n  let stat: fs.Stats;\n  try { stat = fs.lstatSync(file); }\n  catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n    throw error;\n  }\n  if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 1048576) throw Error(\"Unsafe installed MQTT drain descriptor\");\n  const value = JSON.parse(fs.readFileSync(file, \"utf8\"))?.unsDatahub?.mqttDrain;\n  if (value === undefined) return undefined;\n  mqttDrainCapabilitySchema.parse(value);\n  return 1;\n}\nexport interface MqttDrainOutput {\n  flush(timeoutMs: number): Promise<void>;\n  sealPublishes(): void;\n  getPublishQueueStatus(): MqttPublishQueueStatus | undefined;\n}\n\n/** Quiesce before flushing. A timeout is a blocked attempt, never a clean exit. */\nexport async function drainMqttForMigration(options: {\n  quiesce(): Promise<void>;\n  finishAccepted(): Promise<void>;\n  outputs: readonly MqttDrainOutput[];\n  timeoutMs?: number;\n}): Promise<MqttDrainReceipt> {\n  const timeoutMs = options.timeoutMs ?? 30_000;\n  if (!Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 300_000 || options.outputs.length > 64)\n    throw Error(\"Invalid bounded MQTT migration drain\");\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const deadline = Date.now() + timeoutMs;\n  let expired = false;\n  const work = (async () => {\n    await options.quiesce();\n    await options.finishAccepted();\n    const remaining = deadline - Date.now();\n    if (remaining <= 0) throw Error(\"MQTT migration drain timed out; retain the original owner\");\n    await Promise.all(options.outputs.map(output => output.flush(remaining)));\n    for (const output of options.outputs) {\n      const status = output.getPublishQueueStatus();\n      if (status && (status.pendingRecords !== 0 || status.memoryRecords !== 0 || status.diskRecords !== 0 || status.inFlight || status.state === \"blocked\"))\n        throw Error(\"MQTT output is not confirmed empty; migration remains blocked\");\n    }\n    if (expired || Date.now() > deadline) throw Error(\"MQTT migration drain expired; outcome must be reconciled\");\n    // No await between the final checks and admission fences.\n    for (const output of options.outputs) output.sealPublishes();\n    return mqttDrainReceiptSchema.parse({ protocol: 1, state: \"drained\", pendingRecords: 0, outputs: options.outputs.length });\n  })();\n  try {\n    return await Promise.race([work, new Promise<never>((_, reject) => {\n      timer = setTimeout(() => { expired = true; reject(Error(\"MQTT migration drain timed out; pending work retained\")); }, timeoutMs);\n    })]);\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n"]}
+{"version":3,"file":"mqtt-drain.js","sourceRoot":"","sources":["../../src/runtime/mqtt-drain.ts"],"names":[],"mappings":"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","sourcesContent":["import { z } from \"zod\";\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport type { MqttPublishQueueStatus } from \"../uns-mqtt/publish-queue-contract.js\";\n\n/** Generic process-local handshake. The host supplies identity and durable receipts. */\nexport const MQTT_DRAIN_HANDLER = Symbol.for(\"uns-kit.mqtt-drain.v1\");\nexport const MQTT_DRAIN_READY_EVENT = \"uns-kit:mqtt-drain-ready\";\n/** Launch-bound ordinary stop, sent by the authenticated host; never a forced stop. */\nexport const MQTT_COOPERATIVE_STOP_TOPIC = \"uns-kit:mqtt-stop:v1\";\nexport const mqttCooperativeStopRequestSchema = z.strictObject({\n  type: z.literal(MQTT_COOPERATIVE_STOP_TOPIC),\n  protocol: z.literal(1),\n  launchId: z.string().min(1).max(512),\n});\nexport const mqttDrainReceiptSchema = z.strictObject({\n  protocol: z.literal(1),\n  state: z.literal(\"drained\"),\n  pendingRecords: z.literal(0),\n  outputs: z.number().int().min(0).max(64),\n});\nexport type MqttDrainReceipt = z.infer<typeof mqttDrainReceiptSchema>;\nexport const mqttDrainCapabilitySchema = z.strictObject({ protocolVersion: z.literal(1) });\nexport function readMqttDrainCapability(packageRoot: string): 1 | undefined {\n  const file = path.join(packageRoot, \"package.json\");\n  let stat: fs.Stats;\n  try { stat = fs.lstatSync(file); }\n  catch (error) {\n    if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return undefined;\n    throw error;\n  }\n  if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 1048576) throw Error(\"Unsafe installed MQTT drain descriptor\");\n  const value = JSON.parse(fs.readFileSync(file, \"utf8\"))?.unsDatahub?.mqttDrain;\n  if (value === undefined) return undefined;\n  mqttDrainCapabilitySchema.parse(value);\n  return 1;\n}\nexport interface MqttDrainOutput {\n  flush(timeoutMs: number): Promise<void>;\n  sealPublishes(): void;\n  getPublishQueueStatus(): MqttPublishQueueStatus | undefined;\n}\n\n/** Quiesce before flushing. A timeout is a blocked attempt, never a clean exit. */\nexport async function drainMqttForMigration(options: {\n  quiesce(): Promise<void>;\n  finishAccepted(): Promise<void>;\n  outputs: readonly MqttDrainOutput[];\n  timeoutMs?: number;\n}): Promise<MqttDrainReceipt> {\n  const timeoutMs = options.timeoutMs ?? 30_000;\n  if (!Number.isInteger(timeoutMs) || timeoutMs < 1 || timeoutMs > 300_000 || options.outputs.length > 64)\n    throw Error(\"Invalid bounded MQTT migration drain\");\n  let timer: ReturnType<typeof setTimeout> | undefined;\n  const deadline = Date.now() + timeoutMs;\n  let expired = false;\n  const work = (async () => {\n    await options.quiesce();\n    await options.finishAccepted();\n    const remaining = deadline - Date.now();\n    if (remaining <= 0) throw Error(\"MQTT migration drain timed out; retain the original owner\");\n    await Promise.all(options.outputs.map(output => output.flush(remaining)));\n    for (const output of options.outputs) {\n      const status = output.getPublishQueueStatus();\n      if (status && (status.pendingRecords !== 0 || status.memoryRecords !== 0 || status.diskRecords !== 0 || status.inFlight || status.state === \"blocked\"))\n        throw Error(\"MQTT output is not confirmed empty; migration remains blocked\");\n    }\n    if (expired || Date.now() > deadline) throw Error(\"MQTT migration drain expired; outcome must be reconciled\");\n    // No await between the final checks and admission fences.\n    for (const output of options.outputs) output.sealPublishes();\n    return mqttDrainReceiptSchema.parse({ protocol: 1, state: \"drained\", pendingRecords: 0, outputs: options.outputs.length });\n  })();\n  try {\n    return await Promise.race([work, new Promise<never>((_, reject) => {\n      timer = setTimeout(() => { expired = true; reject(Error(\"MQTT migration drain timed out; pending work retained\")); }, timeoutMs);\n    })]);\n  } finally {\n    if (timer) clearTimeout(timer);\n  }\n}\n"]}

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

@@ -61,6 +61,12 @@ export interface IUnsParameters {
     publishThrottlingDelay?: number;
     publishConcurrency?: number;
     maxPendingPublishes?: number;
+    /** Opt-in bounded waiting for RAM output admission instead of rejecting a full queue. */
+    publishBackpressure?: {
+        maxWaiting?: number;
+    };
+    /** Keep one input owned by the worker until setInputHandler's async work finishes. */
+    managedInput?: boolean;
     subscribeThrottlingDelay?: number;
     rejectUnauthorized?: boolean;
     clientId?: string;

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":"AAaA,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 type { MqttPublishQueueOptions } from \"../uns-mqtt/publish-queue-contract.js\";\nimport type { ApplicationHandoverState } from \"../runtime/application-handover-state.js\";\nimport type { HandoverShutdownHooks } from \"./handover-shutdown.js\";\nimport { 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  /** Stable semantic revision of calculation state; change when meaning/scaling changes. Required for correlated-v2. */\n  handoverStateContract?: string;\n  /** Optional MQTT output persistence; absence keeps issued queue behavior. */\n  publishQueue?: MqttPublishQueueOptions;\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  /** Wait for explicit application readiness before initial ownership. */\n  deferHandoverUntilReady?: boolean;\n  /** Optional bounded application RAM state transferred with the reviewed SDK handover. */\n  handoverState?: ApplicationHandoverState;\n  /** Optional application drain after a cooperative handover. Register before creating proxies. */\n  handoverShutdown?: HandoverShutdownHooks;\n  processName: string;\n  /**\n   * Optional controller-supplied correlation id for one cooperative handover.\n   * Older peers ignore it, so it must never be required for normal startup.\n   */\n  handoverId?: string;\n  /** Opt-in state-preserving MQTT handover. Requires matching SDK peers. */\n  handoverProtocol?: \"correlated-v1\" | \"correlated-v2\";\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; processedTail?: 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 type IAssetProviderIdentity = {\n  providerId: string;\n  externalSystem: string;\n  externalType: string;\n  externalId: string;\n};\n\nexport type IAssetIdentityPublicationMetadata =\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      /** Controller-issued stable Asset UUID. It identifies the Asset, not its current path. */\n      assetStableEntityId: string;\n      /** Optional operator-facing name; never used as an identity key. */\n      assetDisplayName?: string;\n      /** Short-lived controller-signed proof bound to this Asset UUID and exact candidate path. */\n      assetIdentityProof: string;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n      assetProviderIdentity: IAssetProviderIdentity;\n      /** Short-lived controller-signed proof bound to the provider identifier and exact candidate path. */\n      assetProviderIdentityProof: string;\n    };\n\nexport type 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} & IAssetIdentityPublicationMetadata;\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  /** Optional stable Asset UUID; accepted by the controller only with a valid publication proof. */\n  assetStableEntityId?: string;\n  /** Optional operator-facing name; never used as an identity key. */\n  assetDisplayName?: string;\n  /** Short-lived controller-signed evidence for this exact Asset path. */\n  assetIdentityProof?: string;\n  /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n  assetProviderIdentity?: IAssetProviderIdentity;\n  /** Short-lived controller-signed evidence for this provider identifier and exact Asset path. */\n  assetProviderIdentityProof?: 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":"AAaA,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 type { MqttPublishQueueOptions } from \"../uns-mqtt/publish-queue-contract.js\";\nimport type { ApplicationHandoverState } from \"../runtime/application-handover-state.js\";\nimport type { HandoverShutdownHooks } from \"./handover-shutdown.js\";\nimport { 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  /** Stable semantic revision of calculation state; change when meaning/scaling changes. Required for correlated-v2. */\n  handoverStateContract?: string;\n  /** Optional MQTT output persistence; absence keeps issued queue behavior. */\n  publishQueue?: MqttPublishQueueOptions;\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  /** Opt-in bounded waiting for RAM output admission instead of rejecting a full queue. */\n  publishBackpressure?: { maxWaiting?: number };\n  /** Keep one input owned by the worker until setInputHandler's async work finishes. */\n  managedInput?: boolean;\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  /** Wait for explicit application readiness before initial ownership. */\n  deferHandoverUntilReady?: boolean;\n  /** Optional bounded application RAM state transferred with the reviewed SDK handover. */\n  handoverState?: ApplicationHandoverState;\n  /** Optional application drain after a cooperative handover. Register before creating proxies. */\n  handoverShutdown?: HandoverShutdownHooks;\n  processName: string;\n  /**\n   * Optional controller-supplied correlation id for one cooperative handover.\n   * Older peers ignore it, so it must never be required for normal startup.\n   */\n  handoverId?: string;\n  /** Opt-in state-preserving MQTT handover. Requires matching SDK peers. */\n  handoverProtocol?: \"correlated-v1\" | \"correlated-v2\";\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; processedTail?: 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 type IAssetProviderIdentity = {\n  providerId: string;\n  externalSystem: string;\n  externalType: string;\n  externalId: string;\n};\n\nexport type IAssetIdentityPublicationMetadata =\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      /** Controller-issued stable Asset UUID. It identifies the Asset, not its current path. */\n      assetStableEntityId: string;\n      /** Optional operator-facing name; never used as an identity key. */\n      assetDisplayName?: string;\n      /** Short-lived controller-signed proof bound to this Asset UUID and exact candidate path. */\n      assetIdentityProof: string;\n      assetProviderIdentity?: never;\n      assetProviderIdentityProof?: never;\n    }\n  | {\n      assetStableEntityId?: never;\n      assetDisplayName?: never;\n      assetIdentityProof?: never;\n      /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n      assetProviderIdentity: IAssetProviderIdentity;\n      /** Short-lived controller-signed proof bound to the provider identifier and exact candidate path. */\n      assetProviderIdentityProof: string;\n    };\n\nexport type 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} & IAssetIdentityPublicationMetadata;\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  /** Optional stable Asset UUID; accepted by the controller only with a valid publication proof. */\n  assetStableEntityId?: string;\n  /** Optional operator-facing name; never used as an identity key. */\n  assetDisplayName?: string;\n  /** Short-lived controller-signed evidence for this exact Asset path. */\n  assetIdentityProof?: string;\n  /** Reviewed provider namespace plus external identifier for a provisional no-ID Asset. */\n  assetProviderIdentity?: IAssetProviderIdentity;\n  /** Short-lived controller-signed evidence for this provider identifier and exact Asset path. */\n  assetProviderIdentityProof?: 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"]}

package/dist/uns/uns-proxy-process.d.ts

@@ -30,6 +30,8 @@ declare class UnsProxyProcess {
     private statefulHandover;
     private applicationHandoverState?;
     private handoverReady;
+    private cooperativeStopHandler?;
+    private signalStopHandler?;
     private pendingHandover?;
     private readyToActivate;
     private markReady?;
@@ -79,7 +81,9 @@ declare class UnsProxyProcess {
     /** Call after application input handlers and shutdown hooks are prepared. */
     enableMigrationDrain(): void;
     /** Optional single signal owner for applications without their own cleanup handler. */
-    installSignalHandlers(): void;
+    installSignalHandlers(options?: {
+        retainOnFailure?: boolean;
+    }): void;
     /** Works without a Controller too; success means confirmed empty output and closed owners. */
     drainForMigration(timeoutMs?: number): Promise<MqttDrainReceipt>;
     /** Stop process timers, status publication and all owned MQTT proxies. */

package/dist/uns/uns-proxy-process.d.ts.map

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

package/dist/uns/uns-proxy-process.js

@@ -1,5 +1,5 @@
 import { validateApplicationHandoverContract } from "../runtime/application-handover-state.js";
-import { MQTT_DRAIN_HANDLER, MQTT_DRAIN_READY_EVENT, drainMqttForMigration } from "../runtime/mqtt-drain.js";
+import { MQTT_DRAIN_HANDLER, MQTT_DRAIN_READY_EVENT, mqttCooperativeStopRequestSchema, drainMqttForMigration } from "../runtime/mqtt-drain.js";
 import { randomBytes } from "crypto";
 import logger from "../logger.js";
 import MqttProxy from "../uns-mqtt/mqtt-proxy.js";
@@ -23,6 +23,8 @@ class UnsProxyProcess {
     statefulHandover = false;
     applicationHandoverState;
     handoverReady = true;
+    cooperativeStopHandler;
+    signalStopHandler;
     pendingHandover;
     readyToActivate = Promise.resolve();
     markReady;
@@ -277,18 +279,39 @@ class UnsProxyProcess {
             throw Error("One migration drain owner is allowed per process");
         this.migrationDrainHandler = () => this.drainForMigration();
         registry[MQTT_DRAIN_HANDLER] = this.migrationDrainHandler;
-        process.emit(MQTT_DRAIN_READY_EVENT, { protocol: 1, ...(this.statefulHandover ? { handoverProtocol: 2 } : {}) });
+        this.cooperativeStopHandler = message => {
+            const envelope = message;
+            const request = mqttCooperativeStopRequestSchema.safeParse(envelope?.type === "process:msg" ? envelope.data : undefined);
+            if (!request.success || request.data.launchId !== process.env["UNS_HANDOVER_LAUNCH_ID"])
+                return;
+            void this.drainForMigration().then(() => { process.channel?.unref(); }, error => {
+                logger.error(`${this.processName} - Cooperative stop unconfirmed; same owner and pending work retained.`, error);
+            });
+        };
+        process.on("message", this.cooperativeStopHandler);
+        process.emit(MQTT_DRAIN_READY_EVENT, { protocol: 1, cooperativeStopProtocol: 1, ...(this.statefulHandover ? { handoverProtocol: 2 } : {}) });
     }
     /** Optional single signal owner for applications without their own cleanup handler. */
-    installSignalHandlers() {
+    installSignalHandlers(options = {}) {
         if (this.signalCleanupInstalled)
             return;
         this.signalCleanupInstalled = true;
+        let stopping = false;
         const stop = () => {
-            void this.drainForMigration().then(() => process.exit(0), () => process.exit(1));
+            if (stopping)
+                return;
+            stopping = true;
+            void this.drainForMigration().then(() => process.exit(0), error => {
+                stopping = false;
+                if (!options.retainOnFailure)
+                    process.exit(1);
+                else
+                    logger.error(`${this.processName} - Stop unconfirmed; pending work retained. Retry after recovery.`, error);
+            });
         };
-        process.once("SIGINT", stop);
-        process.once("SIGTERM", stop);
+        this.signalStopHandler = stop;
+        process.on("SIGINT", stop);
+        process.on("SIGTERM", stop);
     }
     /** Works without a Controller too; success means confirmed empty output and closed owners. */
     drainForMigration(timeoutMs = this.handoverShutdown?.timeoutMs ?? 30_000) {
@@ -298,7 +321,7 @@ class UnsProxyProcess {
             const receipt = await drainMqttForMigration({
                 quiesce: async () => {
                     this.handoverShutdown?.onRelease?.();
-                    await Promise.all(this.unsMqttProxies.map(proxy => proxy.setSubscriberPassiveAndDrainQueue()));
+                    await Promise.all(this.unsMqttProxies.map(proxy => proxy.drainInputForStop()));
                 },
                 finishAccepted: async () => { await this.handoverShutdown?.drain(); },
                 outputs: this.unsMqttProxies,
@@ -383,6 +406,14 @@ class UnsProxyProcess {
                 delete registry[MQTT_DRAIN_HANDLER];
             process.channel?.unref();
         }
+        if (this.cooperativeStopHandler)
+            process.off("message", this.cooperativeStopHandler);
+        if (this.signalStopHandler) {
+            process.off("SIGINT", this.signalStopHandler);
+            process.off("SIGTERM", this.signalStopHandler);
+            this.signalStopHandler = undefined;
+            this.signalCleanupInstalled = false;
+        }
         logger.info(`${this.processName} - Shutdown complete.`);
     }
 }