@nifrajs/core 1.10.0 → 1.12.0

package/dist/causality.js

@@ -0,0 +1,380 @@
+/**
+ * Framework-neutral execution causality.
+ *
+ * Traces describe one synchronous/remote observation tree. Causality survives the durable seams a
+ * trace cannot: a command commits an outbox event, a workflow resumes tomorrow, a projection
+ * consumes that event, and reconciliation repairs drift. This module carries only bounded identity
+ * tokens and links; payloads, tenant identifiers, request URLs, and arbitrary attributes cannot enter
+ * the graph by construction.
+ */
+export class CausalityConflictError extends Error {
+    executionId;
+    node;
+    constructor(executionId, node) {
+        super(`causality conflict: ${node.kind}:${node.id} changed inside execution ${executionId}`);
+        this.executionId = executionId;
+        this.node = node;
+        this.name = "CausalityConflictError";
+    }
+}
+export class CausalityCapacityError extends Error {
+    maxRecords;
+    constructor(maxRecords) {
+        super(`causality store capacity exceeded (${maxRecords} records)`);
+        this.maxRecords = maxRecords;
+        this.name = "CausalityCapacityError";
+    }
+}
+export const CAUSALITY_EXECUTION_HEADER = "x-nifra-execution-id";
+export const CAUSALITY_KIND_HEADER = "x-nifra-causality-kind";
+export const CAUSALITY_NODE_HEADER = "x-nifra-causality-id";
+export const CAUSALITY_TRACE_HEADER = "x-nifra-causality-trace";
+const IDENTITY = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,127}$/;
+const KIND = /^[a-z][a-z0-9._-]{0,63}$/;
+const RELATION = /^[a-z][a-z0-9._-]{0,63}$/;
+const TRACE_ID = /^[0-9a-f]{32}$/;
+const SPAN_ID = /^[0-9a-f]{16}$/;
+const MAX_PARENTS = 16;
+const DEFAULT_TIMELINE_LIMIT = 100;
+const MAX_TIMELINE_LIMIT = 500;
+function identity(value, label) {
+    if (!IDENTITY.test(value)) {
+        throw new TypeError(`causality: ${label} must be a bounded identity token`);
+    }
+    return value;
+}
+function kind(value) {
+    if (!KIND.test(value))
+        throw new TypeError("causality: kind must be a bounded lowercase token");
+    return value;
+}
+function relation(value) {
+    if (!RELATION.test(value)) {
+        throw new TypeError("causality: relation must be a bounded lowercase token");
+    }
+    return value;
+}
+function timestamp(value) {
+    const at = value ?? Date.now();
+    if (!Number.isSafeInteger(at) || at < 0) {
+        throw new TypeError("causality: at must be a non-negative safe-integer epoch millisecond");
+    }
+    return at;
+}
+function trace(value) {
+    if (value === undefined)
+        return undefined;
+    if (!TRACE_ID.test(value.traceId) || !SPAN_ID.test(value.spanId)) {
+        throw new TypeError("causality: trace must contain lowercase W3C trace/span ids");
+    }
+    return Object.freeze({ traceId: value.traceId, spanId: value.spanId });
+}
+function ref(nodeKind, id) {
+    return Object.freeze({ kind: kind(nodeKind), id: identity(id, "node id") });
+}
+function recordOf(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+function onlyKeys(value, allowed) {
+    return Object.keys(value).every((key) => allowed.has(key));
+}
+function buildStep(executionId, current, parents, at, nodeTrace, propagatedTrace) {
+    const node = Object.freeze({
+        ...current,
+        at,
+        ...(nodeTrace === undefined ? {} : { trace: nodeTrace }),
+    });
+    const frozenParents = Object.freeze([...parents]);
+    const context = Object.freeze({
+        executionId,
+        current,
+        ...(propagatedTrace === undefined ? {} : { trace: propagatedTrace }),
+    });
+    const record = Object.freeze({ executionId, node, parents: frozenParents });
+    return Object.freeze({ context, record });
+}
+function normalizeRecord(input) {
+    const executionId = identity(input.executionId, "executionId");
+    if (input.parents.length > MAX_PARENTS) {
+        throw new RangeError(`causality: a record cannot have more than ${MAX_PARENTS} parents`);
+    }
+    const current = ref(input.node.kind, input.node.id);
+    const nodeTrace = trace(input.node.trace);
+    const parents = input.parents.map((parent) => Object.freeze({
+        ...ref(parent.kind, parent.id),
+        relation: relation(parent.relation),
+    }));
+    return Object.freeze({
+        executionId,
+        node: Object.freeze({
+            ...current,
+            at: timestamp(input.node.at),
+            ...(nodeTrace === undefined ? {} : { trace: nodeTrace }),
+        }),
+        parents: Object.freeze(parents),
+    });
+}
+/** Start a root execution node at an ingress boundary. */
+export function startCausality(nodeKind, id, options) {
+    const executionId = identity(options.executionId, "executionId");
+    const current = ref(nodeKind, id);
+    const nodeTrace = trace(options.trace);
+    return buildStep(executionId, current, [], timestamp(options.at), nodeTrace, nodeTrace);
+}
+/** Continue one execution from a single immediate parent. */
+export function continueCausality(parent, nodeKind, id, options = {}) {
+    return joinCausality([parent], nodeKind, id, options);
+}
+/** Join several immediate parents. Cross-execution joins fail closed. */
+export function joinCausality(parents, nodeKind, id, options = {}) {
+    if (parents.length === 0 || parents.length > MAX_PARENTS) {
+        throw new RangeError(`causality: parents must contain 1 to ${MAX_PARENTS} contexts`);
+    }
+    const executionId = identity(parents[0]?.executionId ?? "", "executionId");
+    if (parents.some((parent) => parent.executionId !== executionId)) {
+        throw new Error("causality: joined parents must belong to the same execution");
+    }
+    const edgeRelation = relation(options.relation ?? "caused");
+    const seen = new Set();
+    const incoming = [];
+    for (const parent of parents) {
+        const parentRef = ref(parent.current.kind, parent.current.id);
+        const key = `${parentRef.kind}\n${parentRef.id}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        incoming.push(Object.freeze({ ...parentRef, relation: edgeRelation }));
+    }
+    const current = ref(nodeKind, id);
+    const nodeTrace = trace(options.trace);
+    const propagatedTrace = nodeTrace ?? parents.find((parent) => parent.trace !== undefined)?.trace;
+    return buildStep(executionId, current, incoming, timestamp(options.at), nodeTrace, propagatedTrace);
+}
+const CONTEXT_FIELDS = new Set(["executionId", "current", "trace"]);
+const REF_FIELDS = new Set(["kind", "id"]);
+const TRACE_FIELDS = new Set(["traceId", "spanId"]);
+const RECORD_FIELDS = new Set(["executionId", "node", "parents"]);
+const NODE_FIELDS = new Set(["kind", "id", "at", "trace"]);
+const PARENT_FIELDS = new Set(["kind", "id", "relation"]);
+/** Parse an untrusted durable graph record. Unknown fields fail closed at every nesting level. */
+export function parseCausalityRecord(input) {
+    const value = recordOf(input);
+    if (value === undefined)
+        return { success: false, reason: "invalid" };
+    if (!onlyKeys(value, RECORD_FIELDS))
+        return { success: false, reason: "unknown-field" };
+    const node = recordOf(value.node);
+    if (node === undefined || !Array.isArray(value.parents)) {
+        return { success: false, reason: "incomplete" };
+    }
+    if (!onlyKeys(node, NODE_FIELDS))
+        return { success: false, reason: "unknown-field" };
+    const nodeTrace = value.node !== undefined && node.trace !== undefined ? recordOf(node.trace) : undefined;
+    if (node.trace !== undefined && nodeTrace === undefined) {
+        return { success: false, reason: "invalid" };
+    }
+    if (nodeTrace !== undefined && !onlyKeys(nodeTrace, TRACE_FIELDS)) {
+        return { success: false, reason: "unknown-field" };
+    }
+    const parents = [];
+    for (const rawParent of value.parents) {
+        const parent = recordOf(rawParent);
+        if (parent === undefined)
+            return { success: false, reason: "invalid" };
+        if (!onlyKeys(parent, PARENT_FIELDS))
+            return { success: false, reason: "unknown-field" };
+        if (typeof parent.kind !== "string" ||
+            typeof parent.id !== "string" ||
+            typeof parent.relation !== "string") {
+            return { success: false, reason: "incomplete" };
+        }
+        parents.push({ kind: parent.kind, id: parent.id, relation: parent.relation });
+    }
+    if (typeof value.executionId !== "string" ||
+        typeof node.kind !== "string" ||
+        typeof node.id !== "string" ||
+        typeof node.at !== "number" ||
+        (nodeTrace !== undefined &&
+            (typeof nodeTrace.traceId !== "string" || typeof nodeTrace.spanId !== "string"))) {
+        return { success: false, reason: "incomplete" };
+    }
+    try {
+        return {
+            success: true,
+            record: normalizeRecord({
+                executionId: value.executionId,
+                node: {
+                    kind: node.kind,
+                    id: node.id,
+                    at: node.at,
+                    ...(nodeTrace === undefined
+                        ? {}
+                        : {
+                            trace: { traceId: nodeTrace.traceId, spanId: nodeTrace.spanId },
+                        }),
+                },
+                parents,
+            }),
+        };
+    }
+    catch {
+        return { success: false, reason: "invalid" };
+    }
+}
+/** Parse an untrusted JSON causality context. Unknown fields fail closed so payloads cannot hitchhike. */
+export function parseCausalityContext(input) {
+    const value = recordOf(input);
+    if (value === undefined)
+        return { success: false, reason: "invalid" };
+    if (!onlyKeys(value, CONTEXT_FIELDS))
+        return { success: false, reason: "unknown-field" };
+    const current = recordOf(value.current);
+    if (current === undefined)
+        return { success: false, reason: "incomplete" };
+    if (!onlyKeys(current, REF_FIELDS))
+        return { success: false, reason: "unknown-field" };
+    const rawTrace = value.trace === undefined ? undefined : recordOf(value.trace);
+    if (value.trace !== undefined && rawTrace === undefined) {
+        return { success: false, reason: "invalid" };
+    }
+    if (rawTrace !== undefined && !onlyKeys(rawTrace, TRACE_FIELDS)) {
+        return { success: false, reason: "unknown-field" };
+    }
+    if (typeof value.executionId !== "string" ||
+        typeof current.kind !== "string" ||
+        typeof current.id !== "string" ||
+        (rawTrace !== undefined &&
+            (typeof rawTrace.traceId !== "string" || typeof rawTrace.spanId !== "string"))) {
+        return { success: false, reason: "incomplete" };
+    }
+    try {
+        const context = Object.freeze({
+            executionId: identity(value.executionId, "executionId"),
+            current: ref(current.kind, current.id),
+            ...(rawTrace === undefined
+                ? {}
+                : {
+                    trace: trace({
+                        traceId: rawTrace.traceId,
+                        spanId: rawTrace.spanId,
+                    }),
+                }),
+        });
+        return { success: true, context };
+    }
+    catch {
+        return { success: false, reason: "invalid" };
+    }
+}
+/** Serialize the propagation context into bounded HTTP headers. */
+export function causalityHeaders(context) {
+    const parsed = parseCausalityContext(context);
+    if (!parsed.success)
+        throw new TypeError(`causality: invalid context (${parsed.reason})`);
+    return Object.freeze({
+        [CAUSALITY_EXECUTION_HEADER]: parsed.context.executionId,
+        [CAUSALITY_KIND_HEADER]: parsed.context.current.kind,
+        [CAUSALITY_NODE_HEADER]: parsed.context.current.id,
+        ...(parsed.context.trace === undefined
+            ? {}
+            : {
+                [CAUSALITY_TRACE_HEADER]: `${parsed.context.trace.traceId}-${parsed.context.trace.spanId}`,
+            }),
+    });
+}
+/** Parse the public header convention without ever throwing on hostile input. */
+export function readCausalityHeaders(headers) {
+    const executionId = headers.get(CAUSALITY_EXECUTION_HEADER);
+    const nodeKind = headers.get(CAUSALITY_KIND_HEADER);
+    const nodeId = headers.get(CAUSALITY_NODE_HEADER);
+    const encodedTrace = headers.get(CAUSALITY_TRACE_HEADER);
+    if (executionId === null && nodeKind === null && nodeId === null && encodedTrace === null) {
+        return { success: false, reason: "missing" };
+    }
+    if (executionId === null || nodeKind === null || nodeId === null) {
+        return { success: false, reason: "incomplete" };
+    }
+    let decodedTrace;
+    if (encodedTrace !== null) {
+        const match = /^([0-9a-f]{32})-([0-9a-f]{16})$/.exec(encodedTrace);
+        if (match === null)
+            return { success: false, reason: "invalid" };
+        decodedTrace = { traceId: match[1], spanId: match[2] };
+    }
+    return parseCausalityContext({
+        executionId,
+        current: { kind: nodeKind, id: nodeId },
+        ...(decodedTrace === undefined ? {} : { trace: decodedTrace }),
+    });
+}
+const timelineCursor = (entry) => `${entry.record.node.at.toString(36)}:${entry.sequence.toString(36)}`;
+function timelineLimit(value) {
+    const limit = value ?? DEFAULT_TIMELINE_LIMIT;
+    if (!Number.isSafeInteger(limit) || limit < 1 || limit > MAX_TIMELINE_LIMIT) {
+        throw new RangeError(`causality: timeline limit must be an integer from 1 to ${MAX_TIMELINE_LIMIT}`);
+    }
+    return limit;
+}
+/** Bounded dev/test graph store. Production callers should provide a durable adapter. */
+export function createMemoryCausalityStore(options = {}) {
+    if (typeof process !== "undefined" &&
+        process.env.NODE_ENV === "production" &&
+        !options.allowInProduction) {
+        throw new Error("causality: the memory store is not durable; configure a production graph adapter");
+    }
+    const maxRecords = options.maxRecords ?? 10_000;
+    if (!Number.isSafeInteger(maxRecords) || maxRecords < 1) {
+        throw new RangeError("causality: maxRecords must be a positive safe integer");
+    }
+    const byNode = new Map();
+    const byExecution = new Map();
+    let sequence = 0;
+    return {
+        async record(input) {
+            const parsed = parseCausalityRecord(input);
+            if (!parsed.success)
+                throw new TypeError(`causality: invalid record (${parsed.reason})`);
+            const record = parsed.record;
+            const key = `${record.executionId}\n${record.node.kind}\n${record.node.id}`;
+            const canonical = JSON.stringify(record);
+            const prior = byNode.get(key);
+            if (prior !== undefined) {
+                if (prior.canonical !== canonical) {
+                    throw new CausalityConflictError(record.executionId, record.node);
+                }
+                return "duplicate";
+            }
+            if (byNode.size >= maxRecords)
+                throw new CausalityCapacityError(maxRecords);
+            const entry = Object.freeze({ sequence: sequence++, canonical, record });
+            byNode.set(key, entry);
+            const execution = byExecution.get(record.executionId) ?? [];
+            execution.push(entry);
+            byExecution.set(record.executionId, execution);
+            return "inserted";
+        },
+        async timeline(rawExecutionId, query = {}) {
+            const executionId = identity(rawExecutionId, "executionId");
+            const limit = timelineLimit(query.limit);
+            const entries = [...(byExecution.get(executionId) ?? [])].sort((left, right) => left.record.node.at - right.record.node.at || left.sequence - right.sequence);
+            let start = 0;
+            if (query.after !== undefined) {
+                const index = entries.findIndex((entry) => timelineCursor(entry) === query.after);
+                if (index < 0)
+                    throw new TypeError("causality: invalid timeline cursor");
+                start = index + 1;
+            }
+            const selected = entries.slice(start, start + limit);
+            const hasMore = start + selected.length < entries.length;
+            return Object.freeze({
+                items: Object.freeze(selected.map((entry) => Object.freeze({ cursor: timelineCursor(entry), record: entry.record }))),
+                ...(hasMore && selected.length > 0
+                    ? { nextCursor: timelineCursor(selected[selected.length - 1]) }
+                    : {}),
+            });
+        },
+    };
+}
+//# sourceMappingURL=causality.js.map

package/dist/causality.js.map

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

package/dist/classification.d.ts

@@ -8,6 +8,15 @@
  */
 /** Sensitivity of the data a response carries. Ordered `public` < `pii` < `secret`. */
 export type DataClassification = "public" | "pii" | "secret";
+/** Field paths use JSON Pointer segments; array items use a `*` segment. */
+export interface ResponseClassification {
+    readonly fields: Readonly<Record<string, DataClassification>>;
+    readonly max: DataClassification;
+}
+declare const CLASSIFICATION: unique symbol;
+export type ClassifiedSchema<S extends object> = S & {
+    readonly [CLASSIFICATION]: DataClassification;
+};
 /** Total order over classifications; higher = more sensitive. */
 export declare const DATA_CLASSIFICATION_RANK: Readonly<Record<DataClassification, number>>;
 /** Whether `value` is a known classification token. */
@@ -16,4 +25,15 @@ export declare function isDataClassification(value: unknown): value is DataClass
 export declare function maxClassification(values: Iterable<DataClassification>): DataClassification;
 /** True when `value` is at least as sensitive as `floor` (e.g. `classificationAtLeast(x, "pii")`). */
 export declare function classificationAtLeast(value: DataClassification, floor: DataClassification): boolean;
+/**
+ * Attach data-classification metadata without changing validation or inferred input/output types.
+ * For Nifra/TypeBox carriers the raw JSON Schema node is tagged too, so metadata survives composition
+ * through `t.object`, `t.array`, `t.optional`, and unions.
+ */
+export declare function classified<S extends object>(schema: S, classification: DataClassification): ClassifiedSchema<S>;
+/** Read field-level metadata from an introspectable response schema. Never invokes its validator. */
+export declare function reflectClassification(schema: unknown): ResponseClassification | undefined;
+/** Merge field metadata with an optional route-level sensitivity fallback. */
+export declare function routeClassification(responseSchema: unknown, fallback: DataClassification | undefined): ResponseClassification | undefined;
+export {};
 //# sourceMappingURL=classification.d.ts.map

package/dist/classification.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../src/classification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE5D,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAMjF,CAAA;AAID,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAM1F;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAET"}
+{"version":3,"file":"classification.d.ts","sourceRoot":"","sources":["../src/classification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,uFAAuF;AACvF,MAAM,MAAM,kBAAkB,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAA;AAE5D,4EAA4E;AAC5E,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAAA;IAC7D,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAA;CACjC;AAED,QAAA,MAAM,cAAc,eAA0C,CAAA;AAQ9D,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IACnD,QAAQ,CAAC,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAA;CAC9C,CAAA;AAED,iEAAiE;AACjE,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,MAAM,CAAC,CAMjF,CAAA;AAID,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAM1F;AAED,sGAAsG;AACtG,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAET;AAuBD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EACzC,MAAM,EAAE,CAAC,EACT,cAAc,EAAE,kBAAkB,GACjC,gBAAgB,CAAC,CAAC,CAAC,CAerB;AAiBD,qGAAqG;AACrG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,GAAG,SAAS,CA+CzF;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,OAAO,EACvB,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,sBAAsB,GAAG,SAAS,CAUpC"}

package/dist/classification.js

@@ -6,6 +6,8 @@
  * learns which routes emit regulated data, and the capability lockfile records it so a route that
  * *starts* returning PII flips the lockfile and forces a review.
  */
+const CLASSIFICATION = Symbol.for("nifra.data-classification");
+const JSON_SCHEMA_CLASSIFICATION = "x-nifra-classification";
 /** Total order over classifications; higher = more sensitive. */
 export const DATA_CLASSIFICATION_RANK = Object.freeze({
     public: 0,
@@ -30,4 +32,122 @@ export function maxClassification(values) {
 export function classificationAtLeast(value, floor) {
     return DATA_CLASSIFICATION_RANK[value] >= DATA_CLASSIFICATION_RANK[floor];
 }
+function cloneObject(value) {
+    return Object.create(Object.getPrototypeOf(value), Object.getOwnPropertyDescriptors(value));
+}
+function tagObject(value, classification) {
+    const clone = cloneObject(value);
+    Object.defineProperty(clone, CLASSIFICATION, {
+        configurable: false,
+        enumerable: true,
+        value: classification,
+        writable: false,
+    });
+    Object.defineProperty(clone, JSON_SCHEMA_CLASSIFICATION, {
+        configurable: true,
+        enumerable: true,
+        value: classification,
+        writable: true,
+    });
+    return clone;
+}
+/**
+ * Attach data-classification metadata without changing validation or inferred input/output types.
+ * For Nifra/TypeBox carriers the raw JSON Schema node is tagged too, so metadata survives composition
+ * through `t.object`, `t.array`, `t.optional`, and unions.
+ */
+export function classified(schema, classification) {
+    if (!isDataClassification(classification)) {
+        throw new TypeError(`classification: invalid tag ${JSON.stringify(classification)}`);
+    }
+    const clone = tagObject(schema, classification);
+    const raw = schema.jsonSchema;
+    if (raw !== null && typeof raw === "object") {
+        Object.defineProperty(clone, "jsonSchema", {
+            configurable: true,
+            enumerable: true,
+            value: tagObject(raw, classification),
+            writable: false,
+        });
+    }
+    return clone;
+}
+const recordOf = (value) => value !== null && typeof value === "object"
+    ? value
+    : undefined;
+const classificationOf = (value) => {
+    const record = recordOf(value);
+    const symbolValue = value?.[CLASSIFICATION];
+    if (isDataClassification(symbolValue))
+        return symbolValue;
+    const extension = record?.[JSON_SCHEMA_CLASSIFICATION];
+    return isDataClassification(extension) ? extension : undefined;
+};
+const pointerSegment = (value) => value.replaceAll("~", "~0").replaceAll("/", "~1");
+/** Read field-level metadata from an introspectable response schema. Never invokes its validator. */
+export function reflectClassification(schema) {
+    const carrier = recordOf(schema);
+    const raw = carrier !== undefined && "jsonSchema" in carrier ? carrier.jsonSchema : schema;
+    const fields = {};
+    const seen = new Set();
+    const all = [];
+    const record = (path, value) => {
+        const key = path === "" ? "$" : path;
+        const previous = fields[key];
+        fields[key] = previous === undefined ? value : maxClassification([previous, value]);
+        all.push(value);
+    };
+    const visit = (value, path) => {
+        const object = recordOf(value);
+        if (object === undefined)
+            return;
+        if (seen.has(object))
+            return;
+        seen.add(object);
+        const own = classificationOf(value);
+        if (own !== undefined)
+            record(path, own);
+        const properties = recordOf(object.properties);
+        if (properties !== undefined) {
+            for (const [name, child] of Object.entries(properties)) {
+                visit(child, `${path}/${pointerSegment(name)}`);
+            }
+        }
+        if (object.items !== undefined)
+            visit(object.items, `${path}/*`);
+        if (Array.isArray(object.prefixItems)) {
+            for (const [index, child] of object.prefixItems.entries())
+                visit(child, `${path}/${index}`);
+        }
+        if (object.additionalProperties !== undefined && object.additionalProperties !== false) {
+            visit(object.additionalProperties, `${path}/*`);
+        }
+        for (const key of ["allOf", "anyOf", "oneOf"]) {
+            const variants = object[key];
+            if (Array.isArray(variants))
+                for (const child of variants)
+                    visit(child, path);
+        }
+    };
+    visit(raw, "");
+    // A validation-only carrier can still carry a root tag even when it has no JSON Schema metadata.
+    const carrierTag = classificationOf(schema);
+    if (carrierTag !== undefined && all.length === 0)
+        record("", carrierTag);
+    if (all.length === 0)
+        return undefined;
+    return Object.freeze({ fields: Object.freeze(fields), max: maxClassification(all) });
+}
+/** Merge field metadata with an optional route-level sensitivity fallback. */
+export function routeClassification(responseSchema, fallback) {
+    const reflected = reflectClassification(responseSchema);
+    if (reflected === undefined && fallback === undefined)
+        return undefined;
+    return Object.freeze({
+        fields: reflected?.fields ?? Object.freeze({}),
+        max: fallback === undefined
+            ? reflected.max
+            : maxClassification([fallback, ...(reflected === undefined ? [] : [reflected.max])]),
+    });
+}
 //# sourceMappingURL=classification.js.map

package/dist/classification.js.map

@@ -1 +1 @@
-{"version":3,"file":"classification.js","sourceRoot":"","sources":["../src/classification.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,iEAAiE;AACjE,MAAM,CAAC,MAAM,wBAAwB,GAAiD,MAAM,CAAC,MAAM,CACjG;IACE,MAAM,EAAE,CAAC;IACT,GAAG,EAAE,CAAC;IACN,MAAM,EAAE,CAAC;CACV,CACF,CAAA;AAED,MAAM,eAAe,GAAG,MAAM,CAAC,IAAI,CAAC,wBAAwB,CAAkC,CAAA;AAE9F,uDAAuD;AACvD,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAK,eAAqC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC5F,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,MAAoC;IACpE,IAAI,GAAG,GAAuB,QAAQ,CAAA;IACtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,wBAAwB,CAAC,KAAK,CAAC,GAAG,wBAAwB,CAAC,GAAG,CAAC;YAAE,GAAG,GAAG,KAAK,CAAA;IAClF,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,sGAAsG;AACtG,MAAM,UAAU,qBAAqB,CACnC,KAAyB,EACzB,KAAyB;IAEzB,OAAO,wBAAwB,CAAC,KAAK,CAAC,IAAI,wBAAwB,CAAC,KAAK,CAAC,CAAA;AAC3E,CAAC"}
+{"version":3,"file":"classification.js","sourceRoot":"","sources":["../src/classification.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -8,7 +8,7 @@ export declare class FrameworkError extends Error {
     constructor(code: string, message: string);
 }
 /** Stable codes for boot-time (L2) route configuration failures. */
-export type RouteConfigErrorCode = "DUPLICATE_ROUTE" | "DUPLICATE_PARAM" | "PARAM_NAME_CONFLICT" | "INVALID_PATH" | "INVALID_PARAM_NAME" | "WILDCARD_NOT_LAST" | "INVALID_METHOD" | "INVALID_ASSURANCE";
+export type RouteConfigErrorCode = "DUPLICATE_ROUTE" | "DUPLICATE_PARAM" | "PARAM_NAME_CONFLICT" | "INVALID_PATH" | "INVALID_PARAM_NAME" | "WILDCARD_NOT_LAST" | "INVALID_METHOD" | "INVALID_ASSURANCE" | "INVALID_IDEMPOTENCY";
 /**
  * Thrown at route registration when a route is misconfigured. This is the
  * boot-time rejection layer: loud and early,

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,oBAAoB,GACpB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,CAAA;AAEvB;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAElD,SAAiB,IAAI,EAAE,oBAAoB,CAAA;gBAE/B,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAIxD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;gBAET,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAK1C;AAED,oEAAoE;AACpE,MAAM,MAAM,oBAAoB,GAC5B,iBAAiB,GACjB,iBAAiB,GACjB,qBAAqB,GACrB,cAAc,GACd,oBAAoB,GACpB,mBAAmB,GACnB,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,CAAA;AAEzB;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,cAAc;IAElD,SAAiB,IAAI,EAAE,oBAAoB,CAAA;gBAE/B,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM;CAIxD"}

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAQ;IAErB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAaD;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAIlD,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEpD;;;;GAIG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IAC9B,IAAI,CAAQ;IAErB,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,IAAI,cAAc,KAAK,OAAO,EAAE,CAAC,CAAA;QACvC,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAcD;;;;GAIG;AACH,MAAM,OAAO,gBAAiB,SAAQ,cAAc;IAIlD,YAAY,IAA0B,EAAE,OAAe;QACrD,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;IAChC,CAAC;CACF"}