@unifyplane/logsdk 0.1.0

package/README.md

@@ -0,0 +1,18 @@
+# LogSDK
+
+System Type: pipeline
+
+## Runtime Scope
+
+LogSDK core is implemented for the Node.js/CommonJS runtime and depends on the Node standard library (fs, crypto, perf_hooks, etc.). Other runtimes (Python, JVM, browsers) must provide a compatible core that e the same canonical contracts, and thin adapters should bridge them into the canonical API surface described in docs/LogSDKFuntionalSpec.md.
+
+## Runtime & Tooling Declaration (Authoritative)
+
+- Runtime model: CommonJS | ESM
+- TypeScript module target: commonjs | NodeNext
+- JSON loading strategy: require() | ESM-compliant JSON loading
+- Test runner: jest | vitest | none
+- Build contract:
+  - `npm run build` MUST succeed
+  - `dist/` MUST be Node-executable without ts-node/tsx
+

package/contracts/repo.capabilities.json

@@ -0,0 +1,12 @@
+{
+  "repo_type": "sdk",
+  "system_type": "pipeline",
+  "contracts": {
+    "validators": false,
+    "authority": false,
+    "domain": false,
+    "schemas": false,
+    "constraints": false,
+    "specs": false
+  }
+}

package/contracts/repo.runtime.json

@@ -0,0 +1,49 @@
+{
+  "$schema": "./schemas/repo/repo.runtime.v1.schema.json",
+  "record_version": "repo.runtime.v1",
+
+  "repo_id": "unifyplane-logsdk",
+  "repo_role": "enterprise-substrate-logging",
+
+  "module_system": "esm",
+  "node_target": "node22",
+
+  "tsconfig_path": "tsconfig.json",
+
+  "dist_entry": "dist/index.js",
+
+  "json_strategy": "esm-import",
+
+  "ajv": {
+    "major": 8,
+    "draft": "2020-12",
+    "meta_loading": "explicit-file",
+    "allow_internal_refs": false
+  },
+
+  "build": {
+    "produces_dist": true,
+    "dist_required_artifacts": [
+      "schemas"
+    ]
+  },
+
+  "testing": {
+    "runtime_semantics": "dist",
+    "smoke_required": true
+  },
+
+  "dependency_policy": {
+    "mode": "workspace-allowed",
+    "workspace_root_required": true,
+    "sunset": {
+      "required_before_release": true,
+      "next_phase": "published-only",
+      "reason": "Enterprise substrate hardening"
+    }
+  },
+
+  "governance": {
+    "agent_override_allowed": false
+  }
+}

package/contracts/schemas/repo/repo.runtime.v1.schema.json

@@ -0,0 +1,134 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "type": "object",
+  "required": [
+    "record_version",
+    "repo_id",
+    "repo_role",
+    "module_system",
+    "node_target",
+    "tsconfig_path",
+    "dist_entry",
+    "json_strategy",
+    "ajv"
+  ],
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "JSON Schema meta-schema reference (editor/tooling only)"
+    },
+    "$id": {
+      "type": "string",
+      "description": "Optional schema identifier"
+    },
+
+    "record_version": {
+      "type": "string",
+      "const": "repo.runtime.v1"
+    },
+
+    "repo_id": {
+      "type": "string"
+    },
+
+    "repo_role": {
+      "type": "string",
+      "minLength": 3,
+      "description": "Declarative runtime role; must not imply authority or governance unless explicitly intended"
+    },
+
+    "module_system": {
+      "type": "string",
+      "enum": ["cjs", "esm"]
+    },
+
+    "node_target": {
+      "type": "string"
+    },
+
+    "tsconfig_path": {
+      "type": "string"
+    },
+
+    "dist_entry": {
+      "type": "string"
+    },
+
+    "json_strategy": {
+      "type": "string",
+      "enum": ["cjs-require", "esm-import"]
+    },
+
+    "ajv": {
+      "type": "object",
+      "required": ["major", "draft", "meta_loading"],
+      "properties": {
+        "major": { "type": "number" },
+        "draft": { "type": "string" },
+        "meta_loading": { "type": "string" },
+        "allow_internal_refs": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+
+    "build": {
+      "type": "object",
+      "required": ["produces_dist"],
+      "properties": {
+        "produces_dist": { "type": "boolean" },
+        "dist_required_artifacts": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      },
+      "additionalProperties": false
+    },
+
+    "testing": {
+      "type": "object",
+      "required": ["runtime_semantics", "smoke_required"],
+      "properties": {
+        "runtime_semantics": {
+          "type": "string",
+          "enum": ["dist", "source"]
+        },
+        "smoke_required": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    },
+
+    "dependency_policy": {
+      "type": "object",
+      "required": ["mode"],
+      "properties": {
+        "mode": {
+          "type": "string",
+          "enum": ["workspace-allowed", "published-only"]
+        },
+        "workspace_root_required": {
+          "type": "boolean"
+        },
+        "sunset": {
+          "type": "object",
+          "required": ["required_before_release"],
+          "properties": {
+            "required_before_release": { "type": "boolean" },
+            "next_phase": { "type": "string" },
+            "reason": { "type": "string" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
+
+    "governance": {
+      "type": "object",
+      "properties": {
+        "agent_override_allowed": { "type": "boolean" }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/dist/core/clock.d.ts

@@ -0,0 +1,3 @@
+export declare function nowUtcIso(): string;
+export declare function monotonicNow(): number;
+//# sourceMappingURL=clock.d.ts.map

package/dist/core/clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.d.ts","sourceRoot":"","sources":["../../src/core/clock.ts"],"names":[],"mappings":"AAKA,wBAAgB,SAAS,IAAI,MAAM,CAElC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAerC"}

package/dist/core/clock.js

@@ -0,0 +1,21 @@
+let lastMonotonic = 0;
+const hasPerformance = typeof performance !== "undefined" && typeof performance.now === "function";
+const epochStart = Date.now();
+export function nowUtcIso() {
+    return new Date().toISOString();
+}
+export function monotonicNow() {
+    let current;
+    if (hasPerformance) {
+        current = epochStart + performance.now();
+    }
+    else {
+        current = Date.now();
+    }
+    if (current <= lastMonotonic) {
+        current = lastMonotonic + 1;
+    }
+    lastMonotonic = current;
+    return current;
+}
+//# sourceMappingURL=clock.js.map

package/dist/core/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/core/clock.ts"],"names":[],"mappings":"AAAA,IAAI,aAAa,GAAG,CAAC,CAAC;AACtB,MAAM,cAAc,GAClB,OAAO,WAAW,KAAK,WAAW,IAAI,OAAO,WAAW,CAAC,GAAG,KAAK,UAAU,CAAC;AAC9E,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AAE9B,MAAM,UAAU,SAAS;IACvB,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,IAAI,OAAe,CAAC;IAEpB,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO,GAAG,UAAU,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;IAED,IAAI,OAAO,IAAI,aAAa,EAAE,CAAC;QAC7B,OAAO,GAAG,aAAa,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,aAAa,GAAG,OAAO,CAAC;IACxB,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/context.d.ts

@@ -0,0 +1,10 @@
+type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonValue[] | {
+    [key: string]: JsonValue;
+};
+export declare function initContext(context: unknown, version?: string): void;
+export declare function getContextHash(): string;
+export declare function getContextVersion(): string;
+export declare function resetContextForTests(): void;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/core/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/core/context.ts"],"names":[],"mappings":"AAIA,KAAK,aAAa,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AACtD,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,SAAS,EAAE,GAAG;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,CAAC;AAkBnF,wBAAgB,WAAW,CACzB,OAAO,EAAE,OAAO,EAChB,OAAO,GAAE,MAAgC,GACxC,IAAI,CAiBN;AAED,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAK1C;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/dist/core/context.js

@@ -0,0 +1,100 @@
+/// <reference path="../crypto-shim.d.ts" />
+import { createHash } from "crypto";
+const DEFAULT_CONTEXT_VERSION = "log.context.v1";
+const state = {
+    value: {},
+    hash: "",
+    version: DEFAULT_CONTEXT_VERSION,
+    initialized: false,
+};
+export function initContext(context, version = DEFAULT_CONTEXT_VERSION) {
+    if (state.initialized) {
+        throw new Error("Context already initialized");
+    }
+    if (!context || typeof context !== "object" || Array.isArray(context)) {
+        throw new Error("Context must be a non-array object");
+    }
+    const normalized = normalizeJsonValue(context, "$");
+    const canonical = stableStringify(normalized);
+    const hash = createHash("sha256").update(canonical).digest("hex");
+    state.value = deepFreeze(normalized);
+    state.hash = hash;
+    state.version = version;
+    state.initialized = true;
+}
+export function getContextHash() {
+    if (!state.initialized) {
+        throw new Error("Context not initialized");
+    }
+    return state.hash;
+}
+export function getContextVersion() {
+    if (!state.initialized) {
+        throw new Error("Context not initialized");
+    }
+    return state.version;
+}
+export function resetContextForTests() {
+    state.value = {};
+    state.hash = "";
+    state.version = DEFAULT_CONTEXT_VERSION;
+    state.initialized = false;
+}
+function deepFreeze(value) {
+    if (!value || typeof value !== "object") {
+        return value;
+    }
+    if (Object.isFrozen(value)) {
+        return value;
+    }
+    Object.freeze(value);
+    for (const key of Object.keys(value)) {
+        const child = value[key];
+        deepFreeze(child);
+    }
+    if (Array.isArray(value)) {
+        for (const item of value) {
+            deepFreeze(item);
+        }
+    }
+    return value;
+}
+function normalizeJsonValue(value, path) {
+    if (value === null ||
+        typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (Array.isArray(value)) {
+        return value.map((item, index) => normalizeJsonValue(item, `${path}[${index}]`));
+    }
+    if (typeof value === "object") {
+        const proto = Object.getPrototypeOf(value);
+        if (proto !== Object.prototype && proto !== null) {
+            throw new Error(`Unsupported object at ${path}`);
+        }
+        const obj = value;
+        const result = {};
+        const keys = Object.keys(obj).sort();
+        for (const key of keys) {
+            const next = obj[key];
+            if (next === undefined) {
+                throw new Error(`Undefined value at ${path}.${key}`);
+            }
+            result[key] = normalizeJsonValue(next, `${path}.${key}`);
+        }
+        return result;
+    }
+    throw new Error(`Unsupported type at ${path}`);
+}
+function stableStringify(value) {
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=context.js.map

package/dist/core/context.js.map

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

package/dist/core/fanout.d.ts

@@ -0,0 +1,4 @@
+import type { SinkEntry, StepRecord } from "../sinks/sink_types.js";
+export type FanoutOutcome = "OK" | "DEGRADED" | "FAILED";
+export declare function fanout(record: StepRecord, sinks: ReadonlyArray<SinkEntry>): Promise<FanoutOutcome>;
+//# sourceMappingURL=fanout.d.ts.map

package/dist/core/fanout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.d.ts","sourceRoot":"","sources":["../../src/core/fanout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIpE,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEzD,wBAAsB,MAAM,CAC1B,MAAM,EAAE,UAAU,EAClB,KAAK,EAAE,aAAa,CAAC,SAAS,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC,CA4BxB"}

package/dist/core/fanout.js

@@ -0,0 +1,32 @@
+import { assertHasAuthoritativeSink } from "../validate/schema_guard.js";
+import { writeEmergencySpool } from "./spool.js";
+export async function fanout(record, sinks) {
+    assertHasAuthoritativeSink(sinks);
+    const frozenRecord = Object.isFrozen(record) ? record : Object.freeze(record);
+    let outcome = "OK";
+    let spooled = false;
+    for (const entry of sinks) {
+        try {
+            await entry.sink.emit(frozenRecord);
+        }
+        catch {
+            if (entry.sinkClass === "authoritative") {
+                if (!spooled) {
+                    try {
+                        await writeEmergencySpool(frozenRecord);
+                        outcome = "DEGRADED";
+                        spooled = true;
+                    }
+                    catch {
+                        outcome = "FAILED";
+                    }
+                }
+                if (outcome === "FAILED") {
+                    break;
+                }
+            }
+        }
+    }
+    return outcome;
+}
+//# sourceMappingURL=fanout.js.map

package/dist/core/fanout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fanout.js","sourceRoot":"","sources":["../../src/core/fanout.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAkB,EAClB,KAA+B;IAE/B,0BAA0B,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,OAAO,GAAkB,IAAI,CAAC;IAClC,IAAI,OAAO,GAAG,KAAK,CAAC;IAEpB,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,KAAK,CAAC,SAAS,KAAK,eAAe,EAAE,CAAC;gBACxC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,IAAI,CAAC;wBACH,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAC;wBACxC,OAAO,GAAG,UAAU,CAAC;wBACrB,OAAO,GAAG,IAAI,CAAC;oBACjB,CAAC;oBAAC,MAAM,CAAC;wBACP,OAAO,GAAG,QAAQ,CAAC;oBACrB,CAAC;gBACH,CAAC;gBACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;oBACzB,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/core/ids.d.ts

@@ -0,0 +1,6 @@
+export interface IdGenerator {
+    nextRecordId(): string;
+    nextSequence(): number;
+}
+export declare function createIdGenerator(instanceTag?: string): IdGenerator;
+//# sourceMappingURL=ids.d.ts.map

package/dist/core/ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.d.ts","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,YAAY,IAAI,MAAM,CAAC;IACvB,YAAY,IAAI,MAAM,CAAC;CACxB;AASD,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,CAoBnE"}

package/dist/core/ids.js

@@ -0,0 +1,27 @@
+import { monotonicNow } from "./clock.js";
+const processStart = Date.now().toString(36);
+let instanceCounter = 0;
+function sanitizeTag(tag) {
+    return tag.replace(/[^a-zA-Z0-9_-]/g, "").slice(0, 32);
+}
+export function createIdGenerator(instanceTag) {
+    const instanceId = ++instanceCounter;
+    let sequence = 0;
+    let localCounter = 0;
+    const tag = instanceTag ? sanitizeTag(instanceTag) : "";
+    return {
+        nextSequence() {
+            const current = sequence;
+            sequence += 1;
+            return current;
+        },
+        nextRecordId() {
+            localCounter += 1;
+            const timePart = Math.floor(monotonicNow()).toString(36);
+            const counterPart = localCounter.toString(36);
+            const tagPart = tag ? `_${tag}` : "";
+            return `rec_${processStart}_${instanceId}${tagPart}_${timePart}_${counterPart}`;
+        },
+    };
+}
+//# sourceMappingURL=ids.js.map

package/dist/core/ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ids.js","sourceRoot":"","sources":["../../src/core/ids.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAO1C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC7C,IAAI,eAAe,GAAG,CAAC,CAAC;AAExB,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,WAAoB;IACpD,MAAM,UAAU,GAAG,EAAE,eAAe,CAAC;IACrC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,GAAG,GAAG,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAExD,OAAO;QACL,YAAY;YACV,MAAM,OAAO,GAAG,QAAQ,CAAC;YACzB,QAAQ,IAAI,CAAC,CAAC;YACd,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,YAAY;YACV,YAAY,IAAI,CAAC,CAAC;YAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YACzD,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrC,OAAO,OAAO,YAAY,IAAI,UAAU,GAAG,OAAO,IAAI,QAAQ,IAAI,WAAW,EAAE,CAAC;QAClF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/message_constraints.d.ts

@@ -0,0 +1,4 @@
+declare const MESSAGE_MAX_LENGTH = 512;
+export declare function assertValidMessage(message: unknown): string;
+export { MESSAGE_MAX_LENGTH };
+//# sourceMappingURL=message_constraints.d.ts.map

package/dist/core/message_constraints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_constraints.d.ts","sourceRoot":"","sources":["../../src/core/message_constraints.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,kBAAkB,MAAM,CAAC;AAyC/B,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAsB3D;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/core/message_constraints.js

@@ -0,0 +1,53 @@
+const MESSAGE_MAX_LENGTH = 512;
+const BASE64_MIN_LENGTH = 80;
+function isJsonObjectOrArray(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return false;
+    }
+    const startsWithBrace = trimmed.startsWith("{") && trimmed.endsWith("}");
+    const startsWithBracket = trimmed.startsWith("[") && trimmed.endsWith("]");
+    if (!startsWithBrace && !startsWithBracket) {
+        return false;
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        return typeof parsed === "object" && parsed !== null;
+    }
+    catch {
+        return false;
+    }
+}
+function looksLikeBase64Blob(value) {
+    const trimmed = value.trim();
+    if (trimmed.length < BASE64_MIN_LENGTH) {
+        return false;
+    }
+    if (/\s/.test(trimmed)) {
+        return false;
+    }
+    if (/^[A-Za-z0-9+/=_-]+$/.test(trimmed)) {
+        return true;
+    }
+    return /[A-Za-z0-9+/=_-]{80,}/.test(trimmed);
+}
+export function assertValidMessage(message) {
+    if (typeof message !== "string") {
+        throw new Error("Message must be a string.");
+    }
+    if (message.length === 0) {
+        throw new Error("Message must not be empty.");
+    }
+    if (message.length > MESSAGE_MAX_LENGTH) {
+        throw new Error(`Message exceeds maximum length of ${MESSAGE_MAX_LENGTH}.`);
+    }
+    if (isJsonObjectOrArray(message)) {
+        throw new Error("Message must not be a JSON object or array.");
+    }
+    if (looksLikeBase64Blob(message)) {
+        throw new Error("Message must not contain base64-like payloads.");
+    }
+    return message;
+}
+export { MESSAGE_MAX_LENGTH };
+//# sourceMappingURL=message_constraints.js.map

package/dist/core/message_constraints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message_constraints.js","sourceRoot":"","sources":["../../src/core/message_constraints.ts"],"names":[],"mappings":"AAAA,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAC/B,MAAM,iBAAiB,GAAG,EAAE,CAAC;AAE7B,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,eAAe,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACzE,MAAM,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IAE3E,IAAI,CAAC,eAAe,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3C,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAa;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,CAAC,MAAM,GAAG,iBAAiB,EAAE,CAAC;QACvC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,uBAAuB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;QACxC,MAAM,IAAI,KAAK,CAAC,qCAAqC,kBAAkB,GAAG,CAAC,CAAC;IAC9E,CAAC;IAED,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}

package/dist/core/outcomes.d.ts

@@ -0,0 +1,5 @@
+export declare const OK: "OK";
+export declare const DEGRADED: "DEGRADED";
+export declare const FAILED: "FAILED";
+export type Outcome = typeof OK | typeof DEGRADED | typeof FAILED;
+//# sourceMappingURL=outcomes.d.ts.map

package/dist/core/outcomes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.d.ts","sourceRoot":"","sources":["../../src/core/outcomes.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,EAAE,EAAG,IAAa,CAAC;AAChC,eAAO,MAAM,QAAQ,EAAG,UAAmB,CAAC;AAC5C,eAAO,MAAM,MAAM,EAAG,QAAiB,CAAC;AAExC,MAAM,MAAM,OAAO,GAAG,OAAO,EAAE,GAAG,OAAO,QAAQ,GAAG,OAAO,MAAM,CAAC"}

package/dist/core/outcomes.js

@@ -0,0 +1,4 @@
+export const OK = "OK";
+export const DEGRADED = "DEGRADED";
+export const FAILED = "FAILED";
+//# sourceMappingURL=outcomes.js.map

package/dist/core/outcomes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcomes.js","sourceRoot":"","sources":["../../src/core/outcomes.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,EAAE,GAAG,IAAa,CAAC;AAChC,MAAM,CAAC,MAAM,QAAQ,GAAG,UAAmB,CAAC;AAC5C,MAAM,CAAC,MAAM,MAAM,GAAG,QAAiB,CAAC"}

package/dist/core/record_builder.d.ts

@@ -0,0 +1,34 @@
+import { assertValidMessage } from "./message_constraints.js";
+import type { StepRecord } from "./types.js";
+export declare const message_constraints: {
+    maxLength: number;
+    validate: typeof assertValidMessage;
+};
+export type EvidenceRef = string;
+export type SystemOwnership = {
+    institution: string;
+    system_name: string;
+    system_type: string;
+    environment: string;
+    system_version: string;
+    instance_id?: string;
+};
+export type StepRecordOverrides = {
+    record_id?: string;
+    timestamp_utc?: string;
+    monotonic_time?: number;
+    message_code?: string;
+    evidence_refs?: EvidenceRef[];
+    trace_id?: string;
+    span_id?: string;
+    parent_step_id?: string;
+    surface_type?: string;
+    surface_name?: string;
+    surface_instance?: string;
+    source_file?: string;
+    source_module?: string;
+    source_function?: string;
+    source_line?: number;
+};
+export declare function buildStepRecord(message: string, sequence: number, system: SystemOwnership, overrides?: StepRecordOverrides): StepRecord;
+//# sourceMappingURL=record_builder.d.ts.map

package/dist/core/record_builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_builder.d.ts","sourceRoot":"","sources":["../../src/core/record_builder.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,kBAAkB,EAAsB,MAAM,0BAA0B,CAAC;AAClF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI7C,eAAO,MAAM,mBAAmB;;;CAG/B,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC;AAEjC,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,WAAW,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,mBAAwB,GAClC,UAAU,CAsDZ"}