@unifyplane/logsdk 0.1.0

package/dist/esm/core/record_builder.js

@@ -0,0 +1,188 @@
+/// <reference path="../crypto-shim.d.ts" />
+import { createHash, randomUUID } from "crypto";
+import { getContextHash, getContextVersion } from "./context.js";
+import { monotonicNow } from "./clock.js";
+import { assertValidMessage, MESSAGE_MAX_LENGTH } from "./message_constraints.js";
+const RECORD_VERSION = "log.step.v1";
+const HASH_ALGORITHM = "sha256";
+export const message_constraints = {
+    maxLength: MESSAGE_MAX_LENGTH,
+    validate: assertValidMessage,
+};
+export function buildStepRecord(message, sequence, system, overrides = {}) {
+    const validatedMessage = message_constraints.validate(message);
+    validateSequence(sequence);
+    validateSystemOwnership(system);
+    const contextHash = getContextHash();
+    const contextVersion = getContextVersion();
+    const recordId = overrides.record_id ?? createRecordId();
+    const timestampUtc = overrides.timestamp_utc ?? new Date().toISOString();
+    const monotonicTime = overrides.monotonic_time ?? monotonicNow();
+    const baseRecord = {
+        record_version: RECORD_VERSION,
+        record_id: recordId,
+        sequence,
+        timestamp_utc: timestampUtc,
+        monotonic_time: monotonicTime,
+        institution: system.institution,
+        system_name: system.system_name,
+        system_type: system.system_type,
+        environment: system.environment,
+        system_version: system.system_version,
+        message: validatedMessage,
+        context_hash: contextHash,
+        context_version: contextVersion,
+    };
+    setOptionalField(baseRecord, "instance_id", system.instance_id);
+    setOptionalField(baseRecord, "trace_id", overrides.trace_id);
+    setOptionalField(baseRecord, "span_id", overrides.span_id);
+    setOptionalField(baseRecord, "parent_step_id", overrides.parent_step_id);
+    setOptionalField(baseRecord, "surface_type", overrides.surface_type);
+    setOptionalField(baseRecord, "surface_name", overrides.surface_name);
+    setOptionalField(baseRecord, "surface_instance", overrides.surface_instance);
+    setOptionalField(baseRecord, "source_file", overrides.source_file);
+    setOptionalField(baseRecord, "source_module", overrides.source_module);
+    setOptionalField(baseRecord, "source_function", overrides.source_function);
+    setOptionalField(baseRecord, "source_line", overrides.source_line);
+    setOptionalField(baseRecord, "message_code", overrides.message_code);
+    setOptionalField(baseRecord, "evidence_refs", overrides.evidence_refs);
+    const canonical = stableStringify(normalizeJsonValueOrdered(canonicalizeForHash(baseRecord), "$"));
+    const recordHash = createHash(HASH_ALGORITHM).update(canonical).digest("hex");
+    const record = {
+        ...baseRecord,
+        record_hash: recordHash,
+        hash_algorithm: HASH_ALGORITHM,
+    };
+    return deepFreeze(record);
+}
+function validateSequence(sequence) {
+    if (!Number.isInteger(sequence) || sequence < 0) {
+        throw new Error("Sequence must be a non-negative integer");
+    }
+}
+function validateSystemOwnership(system) {
+    const requiredFields = [
+        "institution",
+        "system_name",
+        "system_type",
+        "environment",
+        "system_version",
+    ];
+    for (const field of requiredFields) {
+        const value = system[field];
+        if (typeof value !== "string" || value.trim().length === 0) {
+            throw new Error(`Missing required system field: ${field}`);
+        }
+    }
+    if (system.instance_id !== undefined && typeof system.instance_id !== "string") {
+        throw new Error("instance_id must be a string when provided");
+    }
+}
+function createRecordId() {
+    return typeof randomUUID === "function"
+        ? randomUUID()
+        : createHash("sha256")
+            .update(`${Date.now()}-${Math.random()}`)
+            .digest("hex");
+}
+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 canonicalizeForHash(record) {
+    const ordered = {};
+    for (const field of HASH_FIELD_ORDER) {
+        const value = record[field];
+        if (value !== undefined) {
+            ordered[field] = normalizeJsonValueOrdered(value, `${String(field)}`);
+        }
+    }
+    return ordered;
+}
+function normalizeJsonValueOrdered(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) => normalizeJsonValueOrdered(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);
+        for (const key of keys) {
+            const next = obj[key];
+            if (next === undefined) {
+                throw new Error(`Undefined value at ${path}.${key}`);
+            }
+            result[key] = normalizeJsonValueOrdered(next, `${path}.${key}`);
+        }
+        return result;
+    }
+    throw new Error(`Unsupported type at ${path}`);
+}
+function stableStringify(value) {
+    return JSON.stringify(value);
+}
+function setOptionalField(record, key, value) {
+    if (value !== undefined) {
+        record[key] = value;
+    }
+}
+const HASH_FIELD_ORDER = [
+    "record_version",
+    "record_id",
+    "sequence",
+    "timestamp_utc",
+    "monotonic_time",
+    "institution",
+    "system_name",
+    "system_type",
+    "environment",
+    "system_version",
+    "instance_id",
+    "trace_id",
+    "span_id",
+    "parent_step_id",
+    "surface_type",
+    "surface_name",
+    "surface_instance",
+    "source_file",
+    "source_module",
+    "source_function",
+    "source_line",
+    "message",
+    "message_code",
+    "context_hash",
+    "context_version",
+    "evidence_refs",
+];
+//# sourceMappingURL=record_builder.js.map

package/dist/esm/core/record_builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_builder.js","sourceRoot":"","sources":["../../../src/core/record_builder.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAa,MAAM,cAAc,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAGlF,MAAM,cAAc,GAAG,aAAa,CAAC;AACrC,MAAM,cAAc,GAAG,QAAQ,CAAC;AAChC,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,SAAS,EAAE,kBAAkB;IAC7B,QAAQ,EAAE,kBAAkB;CAC7B,CAAC;AA+BF,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,QAAgB,EAChB,MAAuB,EACvB,YAAiC,EAAE;IAEnC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/D,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IAC3B,uBAAuB,CAAC,MAAM,CAAC,CAAC;IAEhC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,IAAI,cAAc,EAAE,CAAC;IACzD,MAAM,YAAY,GAAG,SAAS,CAAC,aAAa,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACzE,MAAM,aAAa,GAAG,SAAS,CAAC,cAAc,IAAI,YAAY,EAAE,CAAC;IAEjE,MAAM,UAAU,GAAuD;QACrE,cAAc,EAAE,cAAc;QAC9B,SAAS,EAAE,QAAQ;QACnB,QAAQ;QACR,aAAa,EAAE,YAAY;QAC3B,cAAc,EAAE,aAAa;QAC7B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,OAAO,EAAE,gBAAgB;QACzB,YAAY,EAAE,WAAW;QACzB,eAAe,EAAE,cAAc;KAChC,CAAC;IAEF,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC;IAChE,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC7D,gBAAgB,CAAC,UAAU,EAAE,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC,CAAC;IAC3D,gBAAgB,CAAC,UAAU,EAAE,gBAAgB,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IACzE,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACrE,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACrE,gBAAgB,CAAC,UAAU,EAAE,kBAAkB,EAAE,SAAS,CAAC,gBAAgB,CAAC,CAAC;IAC7E,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACnE,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IACvE,gBAAgB,CAAC,UAAU,EAAE,iBAAiB,EAAE,SAAS,CAAC,eAAe,CAAC,CAAC;IAC3E,gBAAgB,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACnE,gBAAgB,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,CAAC,YAAY,CAAC,CAAC;IACrE,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;IAEvE,MAAM,SAAS,GAAG,eAAe,CAC/B,yBAAyB,CAAC,mBAAmB,CAAC,UAAU,CAAC,EAAE,GAAG,CAAC,CAChE,CAAC;IACF,MAAM,UAAU,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9E,MAAM,MAAM,GAAe;QACzB,GAAG,UAAU;QACb,WAAW,EAAE,UAAU;QACvB,cAAc,EAAE,cAAc;KAC/B,CAAC;IAEF,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;IAC7D,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAuB;IACtD,MAAM,cAAc,GAAiC;QACnD,aAAa;QACb,aAAa;QACb,aAAa;QACb,aAAa;QACb,gBAAgB;KACjB,CAAC;IAEF,KAAK,MAAM,KAAK,IAAI,cAAc,EAAE,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,kCAAkC,KAAK,EAAE,CAAC,CAAC;QAC7D,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,OAAO,UAAU,KAAK,UAAU;QACrC,CAAC,CAAC,UAAU,EAAE;QACd,CAAC,CAAC,UAAU,CAAC,QAAQ,CAAC;aACjB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;aACxC,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED,SAAS,UAAU,CAAI,KAAQ;IAC7B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAErB,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,EAAE,CAAC;QAC/C,MAAM,KAAK,GAAI,KAAiC,CAAC,GAAG,CAAC,CAAC;QACtD,UAAU,CAAC,KAAK,CAAC,CAAC;IACpB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAA0D;IAE1D,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,KAAK,MAAM,KAAK,IAAI,gBAAgB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,CAAC,GAAG,yBAAyB,CAAC,KAAK,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACxE,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc,EAAE,IAAY;IAC7D,IACE,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,QAAQ;QACzB,OAAO,KAAK,KAAK,SAAS,EAC1B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC;IAC7B,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAC/B,yBAAyB,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,CACrD,CAAC;IACJ,CAAC;IAED,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,yBAAyB,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;QAED,MAAM,GAAG,GAAG,KAAgC,CAAC;QAC7C,MAAM,MAAM,GAA8B,EAAE,CAAC;QAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;gBACvB,MAAM,IAAI,KAAK,CAAC,sBAAsB,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,GAAG,yBAAyB,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,eAAe,CAAC,KAAgB;IACvC,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,gBAAgB,CACvB,MAA0D,EAC1D,GAAM,EACN,KAA4D;IAE5D,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACvB,MAAkC,CAAC,GAAG,CAAC,GAAG,KAAkB,CAAC;IAChE,CAAC;AACH,CAAC;AAED,MAAM,gBAAgB,GAElB;IACF,gBAAgB;IAChB,WAAW;IACX,UAAU;IACV,eAAe;IACf,gBAAgB;IAChB,aAAa;IACb,aAAa;IACb,aAAa;IACb,aAAa;IACb,gBAAgB;IAChB,aAAa;IACb,UAAU;IACV,SAAS;IACT,gBAAgB;IAChB,cAAc;IACd,cAAc;IACd,kBAAkB;IAClB,aAAa;IACb,eAAe;IACf,iBAAiB;IACjB,aAAa;IACb,SAAS;IACT,cAAc;IACd,cAAc;IACd,iBAAiB;IACjB,eAAe;CAChB,CAAC"}

package/dist/esm/core/spool.js

@@ -0,0 +1,31 @@
+/// <reference path="../fs-shim.d.ts" />
+import { promises as fs } from "fs";
+import os from "os";
+import path from "path";
+const DEFAULT_SPOOL_NAME = "logsdk-emergency-spool.ndjson";
+function getSpoolPath() {
+    return (process.env.LOGSDK_EMERGENCY_SPOOL_PATH ??
+        path.join(os.tmpdir(), DEFAULT_SPOOL_NAME));
+}
+export function getEmergencySpoolPath() {
+    return getSpoolPath();
+}
+export async function writeEmergencySpool(record) {
+    const spoolPath = getSpoolPath();
+    const payload = `${JSON.stringify(record)}\n`;
+    const handle = await fs.open(spoolPath, "a");
+    try {
+        const result = await handle.write(payload, undefined, "utf8");
+        if (!result || typeof result.bytesWritten !== "number") {
+            throw new Error("Emergency spool write did not report bytes.");
+        }
+        if (result.bytesWritten !== payload.length) {
+            throw new Error("Emergency spool partial write detected.");
+        }
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+}
+//# sourceMappingURL=spool.js.map

package/dist/esm/core/spool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spool.js","sourceRoot":"","sources":["../../../src/core/spool.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAGxB,MAAM,kBAAkB,GAAG,+BAA+B,CAAC;AAE3D,SAAS,YAAY;IACnB,OAAO,CACL,OAAO,CAAC,GAAG,CAAC,2BAA2B;QACvC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAC3C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB;IACnC,OAAO,YAAY,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,MAAkB;IAC1D,MAAM,SAAS,GAAG,YAAY,EAAE,CAAC;IACjC,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC;IAC9C,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAE7C,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;QAE9D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QAED,IAAI,MAAM,CAAC,YAAY,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QAED,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACtB,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/esm/core/types.js

@@ -0,0 +1,4 @@
+// Internal core types for LogSDK v1.0
+// Types only: no runtime logic.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,gCAAgC"}

package/dist/esm/index.js

@@ -0,0 +1,52 @@
+import { initContext } from "./core/context.js";
+import { createIdGenerator } from "./core/ids.js";
+import { buildStepRecord } from "./core/record_builder.js";
+import { assertValidMessage } from "./core/message_constraints.js";
+import { fanout } from "./core/fanout.js";
+import { assertApiSurface } from "./validate/api_surface_guard.js";
+import { assertStepRecord } from "./validate/schema_guard.js";
+import { AUTHORITATIVE_FAILURE_SWALLOWED, CONTEXT_INJECTION_VIOLATION, PAYLOAD_EMBEDDING_VIOLATION, NonComplianceError, } from "./validate/noncompliance.js";
+export function initLogSDK(config) {
+    initContext(config.context);
+    const idGenerator = createIdGenerator(config.system.instance_id);
+    const sinks = [...config.sinks];
+    const api = {
+        async step(message) {
+            if (typeof message !== "string") {
+                if (message && typeof message === "object") {
+                    throw new NonComplianceError(CONTEXT_INJECTION_VIOLATION, "Per-step context injection is not allowed.");
+                }
+                throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, "Message must be a string.");
+            }
+            try {
+                assertValidMessage(message);
+            }
+            catch (error) {
+                throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, error instanceof Error ? error.message : "Invalid message content.");
+            }
+            const record = buildStepRecord(message, idGenerator.nextSequence(), config.system, {
+                record_id: idGenerator.nextRecordId(),
+            });
+            assertStepRecord(record);
+            const outcome = await fanout(record, sinks);
+            if (outcome === "FAILED") {
+                throw new NonComplianceError(AUTHORITATIVE_FAILURE_SWALLOWED, "Authoritative sink failed to emit.");
+            }
+        },
+        async flush() {
+            for (const entry of sinks) {
+                if (entry.sink.flush) {
+                    await entry.sink.flush();
+                }
+            }
+        },
+    };
+    assertApiSurface(api);
+    return api;
+}
+export function createLogger(config) {
+    return initLogSDK(config);
+}
+export { fileNdjsonSink } from "./sinks/file_ndjson.js";
+export { authoritativeNdjsonSink } from "./sinks/file_ndjson.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAmB,MAAM,0BAA0B,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACnE,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EACL,+BAA+B,EAC/B,2BAA2B,EAC3B,2BAA2B,EAC3B,kBAAkB,GACnB,MAAM,6BAA6B,CAAC;AA4BrC,MAAM,UAAU,UAAU,CAAC,MAAoB;IAC7C,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAE5B,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACjE,MAAM,KAAK,GAAG,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,GAAG,GAAW;QAClB,KAAK,CAAC,IAAI,CAAC,OAAe;YACxB,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAChC,IAAI,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAC3C,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,EAC3B,4CAA4C,CAC7C,CAAC;gBACJ,CAAC;gBAED,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,EAC3B,2BAA2B,CAC5B,CAAC;YACJ,CAAC;YAED,IAAI,CAAC;gBACH,kBAAkB,CAAC,OAAO,CAAC,CAAC;YAC9B,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,kBAAkB,CAC1B,2BAA2B,EAC3B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CACpE,CAAC;YACJ,CAAC;YAED,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,EAAE,WAAW,CAAC,YAAY,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE;gBACjF,SAAS,EAAE,WAAW,CAAC,YAAY,EAAE;aACtC,CAAC,CAAC;YAEH,gBAAgB,CAAC,MAAM,CAAC,CAAC;YAEzB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;YAC5C,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;gBACzB,MAAM,IAAI,kBAAkB,CAC1B,+BAA+B,EAC/B,oCAAoC,CACrC,CAAC;YACJ,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;gBAC1B,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;oBACrB,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;KACF,CAAC;IAEF,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/esm/sinks/file_ndjson.js

@@ -0,0 +1,29 @@
+import fs from "fs";
+import path from "path";
+export function fileNdjsonSink(pathOrOptions) {
+    const p = typeof pathOrOptions === "string" ? pathOrOptions : pathOrOptions.path;
+    const dir = path.dirname(p);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const sink = {
+        emit(record) {
+            fs.appendFileSync(p, JSON.stringify(record) + "\n", { encoding: "utf8" });
+        },
+    };
+    return { sink, sinkClass: "observability" };
+}
+export function authoritativeNdjsonSink(pathOrOptions) {
+    const p = typeof pathOrOptions === "string" ? pathOrOptions : pathOrOptions.path;
+    const dir = path.dirname(p);
+    if (!fs.existsSync(dir)) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+    const sink = {
+        emit(record) {
+            fs.appendFileSync(p, JSON.stringify(record) + "\n", { encoding: "utf8" });
+        },
+    };
+    return { sink, sinkClass: "authoritative" };
+}
+//# sourceMappingURL=file_ndjson.js.map

package/dist/esm/sinks/file_ndjson.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson.js","sourceRoot":"","sources":["../../../src/sinks/file_ndjson.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAexB,MAAM,UAAU,cAAc,CAAC,aAAwC;IACrE,MAAM,CAAC,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,GAAS;QACjB,IAAI,CAAC,MAA4B;YAC/B,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AAC9C,CAAC;AACD,MAAM,UAAU,uBAAuB,CAAC,aAAwC;IAC9E,MAAM,CAAC,GAAG,OAAO,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC;IACjF,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IACD,MAAM,IAAI,GAAS;QACjB,IAAI,CAAC,MAA4B;YAC/B,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;QAC5E,CAAC;KACF,CAAC;IACF,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,eAAe,EAAE,CAAC;AAC9C,CAAC"}

package/dist/esm/sinks/file_ndjson_sink.js

@@ -0,0 +1,36 @@
+/// <reference path="../fs-shim.d.ts" />
+import { promises as fs } from "fs";
+export function createFileNdjsonSink(filePath) {
+    let closed = false;
+    return {
+        async emit(record) {
+            if (closed) {
+                throw new Error("File NDJSON sink is closed.");
+            }
+            const line = JSON.stringify(record);
+            const payload = `${line}\n`;
+            const handle = await fs.open(filePath, "a");
+            try {
+                const result = await handle.write(payload, undefined, "utf8");
+                if (!result || typeof result.bytesWritten !== "number") {
+                    throw new Error("File NDJSON sink write did not report bytes.");
+                }
+                if (result.bytesWritten !== payload.length) {
+                    throw new Error("File NDJSON sink partial write detected.");
+                }
+                await handle.sync();
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`File NDJSON sink write failed: ${message}`);
+            }
+            finally {
+                await handle.close();
+            }
+        },
+        async close() {
+            closed = true;
+        },
+    };
+}
+//# sourceMappingURL=file_ndjson_sink.js.map

package/dist/esm/sinks/file_ndjson_sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_ndjson_sink.js","sourceRoot":"","sources":["../../../src/sinks/file_ndjson_sink.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AAQpC,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,IAAI,MAAM,GAAG,KAAK,CAAC;IAEnB,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAkB;YAC3B,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjD,CAAC;YAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YACpC,MAAM,OAAO,GAAG,GAAG,IAAI,IAAI,CAAC;YAC5B,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;YAE5C,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;gBAC9D,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;oBACvD,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;gBAClE,CAAC;gBAED,IAAI,MAAM,CAAC,YAAY,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;oBAC3C,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;gBAC9D,CAAC;gBACD,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YACtB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,EAAE,CAAC,CAAC;YAC/D,CAAC;oBAAS,CAAC;gBACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;QACH,CAAC;QACD,KAAK,CAAC,KAAK;YACT,MAAM,GAAG,IAAI,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/sinks/sink_types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sink_types.js.map

package/dist/esm/sinks/sink_types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sink_types.js","sourceRoot":"","sources":["../../../src/sinks/sink_types.ts"],"names":[],"mappings":""}

package/dist/esm/sinks/stdout_sink.js

@@ -0,0 +1,15 @@
+/// <reference path="../process-shim.d.ts" />
+export function createStdoutSink() {
+    return {
+        async emit(record) {
+            try {
+                const line = JSON.stringify(record);
+                process.stdout.write(`${line}\n`);
+            }
+            catch {
+                // Best-effort only: never throw.
+            }
+        },
+    };
+}
+//# sourceMappingURL=stdout_sink.js.map

package/dist/esm/sinks/stdout_sink.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdout_sink.js","sourceRoot":"","sources":["../../../src/sinks/stdout_sink.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAQ7C,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,MAAkB;YAC3B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;gBACpC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;YACpC,CAAC;YAAC,MAAM,CAAC;gBACP,iCAAiC;YACnC,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/esm/validate/api_surface_guard.js

@@ -0,0 +1,63 @@
+import { API_SURFACE_VIOLATION, NonComplianceError, } from "./noncompliance.js";
+const ALLOWED_SCOPES = ["request", "job", "component"];
+const FORBIDDEN_NAMES = new Set([
+    "withContext",
+    "ctx",
+    "meta",
+    "attributes",
+    "tags",
+    "labels",
+    "log",
+    "emit",
+    "metric",
+    "span",
+]);
+function assertFunction(value, name, arity) {
+    if (typeof value !== "function") {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, `${name} must be a function.`);
+    }
+    if (value.length !== arity) {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, `${name} must accept exactly ${arity} argument(s).`);
+    }
+}
+function assertChildScopePolicy(child) {
+    const candidate = child;
+    const allowedScopes = candidate.allowedScopes;
+    if (!Array.isArray(allowedScopes) || allowedScopes.length === 0) {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, "child() must declare allowedScopes to enforce scope union.");
+    }
+    for (const scope of allowedScopes) {
+        if (!ALLOWED_SCOPES.includes(scope)) {
+            throw new NonComplianceError(API_SURFACE_VIOLATION, `child() scope not allowed: ${String(scope)}.`);
+        }
+    }
+}
+export function assertApiSurface(surface) {
+    if (!surface || typeof surface !== "object") {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, "API surface must be an object.");
+    }
+    const api = surface;
+    const keys = Object.keys(api);
+    for (const key of keys) {
+        if (FORBIDDEN_NAMES.has(key)) {
+            throw new NonComplianceError(API_SURFACE_VIOLATION, `Forbidden API method detected: ${key}.`);
+        }
+    }
+    if (!("step" in api)) {
+        throw new NonComplianceError(API_SURFACE_VIOLATION, "API surface must expose step(message).");
+    }
+    assertFunction(api.step, "step", 1);
+    if ("flush" in api) {
+        assertFunction(api.flush, "flush", 0);
+    }
+    if ("child" in api) {
+        assertFunction(api.child, "child", 1);
+        assertChildScopePolicy(api.child);
+    }
+    for (const key of keys) {
+        if (key !== "step" && key !== "child" && key !== "flush") {
+            throw new NonComplianceError(API_SURFACE_VIOLATION, `Unexpected API export: ${key}.`);
+        }
+    }
+}
+//# sourceMappingURL=api_surface_guard.js.map

package/dist/esm/validate/api_surface_guard.js.map

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

package/dist/esm/validate/noncompliance.js

@@ -0,0 +1,17 @@
+export const API_SURFACE_VIOLATION = "API_SURFACE_VIOLATION";
+export const CONTEXT_INJECTION_VIOLATION = "CONTEXT_INJECTION_VIOLATION";
+export const PAYLOAD_EMBEDDING_VIOLATION = "PAYLOAD_EMBEDDING_VIOLATION";
+export const CANONICAL_SCHEMA_VIOLATION = "CANONICAL_SCHEMA_VIOLATION";
+export const SINK_MUTATION_VIOLATION = "SINK_MUTATION_VIOLATION";
+export const NO_AUTHORITATIVE_SINK = "NO_AUTHORITATIVE_SINK";
+export const FANOUT_NONDETERMINISM = "FANOUT_NONDETERMINISM";
+export const AUTHORITATIVE_FAILURE_SWALLOWED = "AUTHORITATIVE_FAILURE_SWALLOWED";
+export const UNBOUNDED_BUFFER_RISK = "UNBOUNDED_BUFFER_RISK";
+export class NonComplianceError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+//# sourceMappingURL=noncompliance.js.map

package/dist/esm/validate/noncompliance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noncompliance.js","sourceRoot":"","sources":["../../../src/validate/noncompliance.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,2BAA2B,GACtC,6BAAsC,CAAC;AACzC,MAAM,CAAC,MAAM,2BAA2B,GACtC,6BAAsC,CAAC;AACzC,MAAM,CAAC,MAAM,0BAA0B,GACrC,4BAAqC,CAAC;AACxC,MAAM,CAAC,MAAM,uBAAuB,GAAG,yBAAkC,CAAC;AAC1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AACtE,MAAM,CAAC,MAAM,+BAA+B,GAC1C,iCAA0C,CAAC;AAC7C,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAgC,CAAC;AAatE,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAClC,IAAI,CAAoB;IAEjC,YAAY,IAAuB,EAAE,OAAe;QAClD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/esm/validate/schema_guard.js

@@ -0,0 +1,151 @@
+import { assertValidMessage } from "../core/message_constraints.js";
+import { CANONICAL_SCHEMA_VIOLATION, CONTEXT_INJECTION_VIOLATION, NO_AUTHORITATIVE_SINK, PAYLOAD_EMBEDDING_VIOLATION, NonComplianceError, } from "./noncompliance.js";
+const REQUIRED_FIELDS = [
+    "record_version",
+    "record_id",
+    "sequence",
+    "timestamp_utc",
+    "monotonic_time",
+    "institution",
+    "system_name",
+    "system_type",
+    "environment",
+    "system_version",
+    "message",
+    "context_hash",
+    "context_version",
+    "record_hash",
+    "hash_algorithm",
+];
+const OPTIONAL_FIELDS = [
+    "instance_id",
+    "trace_id",
+    "span_id",
+    "parent_step_id",
+    "surface_type",
+    "surface_name",
+    "surface_instance",
+    "source_file",
+    "source_module",
+    "source_function",
+    "source_line",
+    "message_code",
+    "evidence_refs",
+];
+const ALLOWED_FIELDS = new Set([...REQUIRED_FIELDS, ...OPTIONAL_FIELDS]);
+const CONTEXT_FIELDS = ["context", "context_blob", "context_data", "context_value"];
+// Explicit type assertion for string keys from Object.keys(schema.properties)
+function asRecord(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "Step record must be a plain object.");
+    }
+    return value;
+}
+export function assertStepRecord(record) {
+    const candidate = asRecord(record);
+    if (!Object.isFrozen(candidate)) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "Step record must be immutable at emission time.");
+    }
+    for (const forbidden of CONTEXT_FIELDS) {
+        if (forbidden in candidate) {
+            throw new NonComplianceError(CONTEXT_INJECTION_VIOLATION, "Context must not be embedded in the step record.");
+        }
+    }
+    for (const key of Object.keys(candidate)) {
+        if (!ALLOWED_FIELDS.has(key)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `Unexpected field in step record: ${key}.`);
+        }
+    }
+    for (const field of REQUIRED_FIELDS) {
+        if (!(field in candidate)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `Missing required field: ${field}.`);
+        }
+    }
+    assertStringField(candidate, "record_version");
+    assertStringField(candidate, "record_id");
+    assertIntegerField(candidate, "sequence");
+    assertStringField(candidate, "timestamp_utc");
+    assertNumberField(candidate, "monotonic_time");
+    assertStringField(candidate, "institution");
+    assertStringField(candidate, "system_name");
+    assertStringField(candidate, "system_type");
+    assertStringField(candidate, "environment");
+    assertStringField(candidate, "system_version");
+    assertStringField(candidate, "context_hash");
+    assertStringField(candidate, "context_version");
+    assertStringField(candidate, "record_hash");
+    assertStringField(candidate, "hash_algorithm");
+    if (candidate.record_version !== "log.step.v1") {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "record_version must be log.step.v1.");
+    }
+    try {
+        assertValidMessage(candidate.message);
+    }
+    catch (error) {
+        throw new NonComplianceError(PAYLOAD_EMBEDDING_VIOLATION, error instanceof Error ? error.message : "Invalid message content.");
+    }
+    if (typeof candidate.timestamp_utc === "string") {
+        const parsed = Date.parse(candidate.timestamp_utc);
+        if (Number.isNaN(parsed)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "timestamp_utc must be a valid ISO-8601 string.");
+        }
+    }
+    assertOptionalStringField(candidate, "instance_id");
+    assertOptionalStringField(candidate, "trace_id");
+    assertOptionalStringField(candidate, "span_id");
+    assertOptionalStringField(candidate, "parent_step_id");
+    assertOptionalStringField(candidate, "surface_type");
+    assertOptionalStringField(candidate, "surface_name");
+    assertOptionalStringField(candidate, "surface_instance");
+    assertOptionalStringField(candidate, "source_file");
+    assertOptionalStringField(candidate, "source_module");
+    assertOptionalStringField(candidate, "source_function");
+    assertOptionalStringField(candidate, "message_code");
+    if ("source_line" in candidate && candidate.source_line !== undefined) {
+        assertNumberField(candidate, "source_line");
+    }
+    if ("evidence_refs" in candidate && candidate.evidence_refs !== undefined) {
+        if (!Array.isArray(candidate.evidence_refs)) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "evidence_refs must be an array of strings.");
+        }
+        for (const ref of candidate.evidence_refs) {
+            if (typeof ref !== "string" || ref.length === 0) {
+                throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, "evidence_refs must contain non-empty strings.");
+            }
+        }
+    }
+}
+// Explicit type assertion for string keys from Object.keys(schema.properties)
+export function assertHasAuthoritativeSink(sinks) {
+    const hasAuthoritative = sinks.some((entry) => entry.sinkClass === "authoritative");
+    if (!hasAuthoritative) {
+        throw new NonComplianceError(NO_AUTHORITATIVE_SINK, "At least one authoritative sink is required.");
+    }
+}
+function assertStringField(record, field) {
+    const value = record[field];
+    if (typeof value !== "string" || value.length === 0) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a non-empty string.`);
+    }
+}
+function assertOptionalStringField(record, field) {
+    if (field in record && record[field] !== undefined) {
+        const value = record[field];
+        if (typeof value !== "string" || value.length === 0) {
+            throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a non-empty string when provided.`);
+        }
+    }
+}
+function assertNumberField(record, field) {
+    const value = record[field];
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a finite number.`);
+    }
+}
+function assertIntegerField(record, field) {
+    const value = record[field];
+    if (typeof value !== "number" || !Number.isInteger(value) || value < 0) {
+        throw new NonComplianceError(CANONICAL_SCHEMA_VIOLATION, `${field} must be a non-negative integer.`);
+    }
+}
+//# sourceMappingURL=schema_guard.js.map