@fabricorg/platform 1.9.0 → 1.10.1

package/dist/ids/index.cjs

@@ -1,24 +1,54 @@
-'use strict';
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region ids/index.ts
+const CROCKFORD_BASE32 = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+const FABRIC_ID_PREFIXES = {
+	assetEvent: "evt",
+	actionInvocation: "act",
+	policyEvaluation: "pol",
+	adapterInvocation: "adp",
+	adapterDeadLetterQueue: "dlq",
+	accessEvent: "acc",
+	projectionSnapshot: "psn",
+	complianceEvidencePacket: "cep"
+};
+const ID_REGEX = /^([a-z][a-z0-9]{1,7})_([0-9A-Z]{26})$/;
+function randomBase32(length) {
+	let output = "";
+	const randomValues = new Uint8Array(length);
+	globalThis.crypto.getRandomValues(randomValues);
+	for (const value of randomValues) output += CROCKFORD_BASE32[value % 32];
+	return output;
+}
+function createSortableRandomId() {
+	let timestamp = Date.now();
+	let encodedTime = "";
+	for (let index = 0; index < 10; index++) {
+		encodedTime = CROCKFORD_BASE32[timestamp % 32] + encodedTime;
+		timestamp = Math.floor(timestamp / 32);
+	}
+	return `${encodedTime}${randomBase32(16)}`;
+}
+function createFabricId(prefix) {
+	if (!/^[a-z][a-z0-9]{1,7}$/.test(prefix)) throw new Error(`Invalid Fabric ID prefix: ${prefix}`);
+	return `${prefix}_${createSortableRandomId()}`;
+}
+function isFabricId(id, prefix) {
+	const match = ID_REGEX.exec(id);
+	if (!match) return false;
+	return prefix ? match[1] === prefix : true;
+}
+function parseFabricId(id) {
+	const match = ID_REGEX.exec(id);
+	if (!match) return null;
+	return {
+		prefix: match[1],
+		ulid: match[2]
+	};
+}
+//#endregion
+exports.FABRIC_ID_PREFIXES = FABRIC_ID_PREFIXES;
+exports.createFabricId = createFabricId;
+exports.isFabricId = isFabricId;
+exports.parseFabricId = parseFabricId;
 
-var chunkLZSE6QGQ_cjs = require('../chunk-LZSE6QGQ.cjs');
-
-
-
-Object.defineProperty(exports, "FABRIC_ID_PREFIXES", {
-  enumerable: true,
-  get: function () { return chunkLZSE6QGQ_cjs.FABRIC_ID_PREFIXES; }
-});
-Object.defineProperty(exports, "createFabricId", {
-  enumerable: true,
-  get: function () { return chunkLZSE6QGQ_cjs.createFabricId; }
-});
-Object.defineProperty(exports, "isFabricId", {
-  enumerable: true,
-  get: function () { return chunkLZSE6QGQ_cjs.isFabricId; }
-});
-Object.defineProperty(exports, "parseFabricId", {
-  enumerable: true,
-  get: function () { return chunkLZSE6QGQ_cjs.parseFabricId; }
-});
-//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/ids/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}
+{"version":3,"file":"index.cjs","names":[],"sources":["../../ids/index.ts"],"sourcesContent":["const CROCKFORD_BASE32 = \"0123456789ABCDEFGHJKMNPQRSTVWXYZ\";\n\nexport const FABRIC_ID_PREFIXES = {\n\tassetEvent: \"evt\",\n\tactionInvocation: \"act\",\n\tpolicyEvaluation: \"pol\",\n\tadapterInvocation: \"adp\",\n\tadapterDeadLetterQueue: \"dlq\",\n\taccessEvent: \"acc\",\n\tprojectionSnapshot: \"psn\",\n\tcomplianceEvidencePacket: \"cep\",\n} as const;\n\nexport type FabricIdPrefix = (typeof FABRIC_ID_PREFIXES)[keyof typeof FABRIC_ID_PREFIXES] | string;\n\nconst ID_REGEX = /^([a-z][a-z0-9]{1,7})_([0-9A-Z]{26})$/;\n\nfunction randomBase32(length: number): string {\n\tlet output = \"\";\n\tconst randomValues = new Uint8Array(length);\n\tglobalThis.crypto.getRandomValues(randomValues);\n\tfor (const value of randomValues) {\n\t\toutput += CROCKFORD_BASE32[value % CROCKFORD_BASE32.length];\n\t}\n\treturn output;\n}\n\nfunction createSortableRandomId(): string {\n\tlet timestamp = Date.now();\n\tlet encodedTime = \"\";\n\tfor (let index = 0; index < 10; index++) {\n\t\tencodedTime = CROCKFORD_BASE32[timestamp % 32] + encodedTime;\n\t\ttimestamp = Math.floor(timestamp / 32);\n\t}\n\treturn `${encodedTime}${randomBase32(16)}`;\n}\n\nexport function createFabricId(prefix: FabricIdPrefix): string {\n\tif (!/^[a-z][a-z0-9]{1,7}$/.test(prefix)) {\n\t\tthrow new Error(`Invalid Fabric ID prefix: ${prefix}`);\n\t}\n\treturn `${prefix}_${createSortableRandomId()}`;\n}\n\nexport function isFabricId(id: string, prefix?: FabricIdPrefix): boolean {\n\tconst match = ID_REGEX.exec(id);\n\tif (!match) {\n\t\treturn false;\n\t}\n\treturn prefix ? match[1] === prefix : true;\n}\n\nexport function parseFabricId(id: string): { prefix: string; ulid: string } | null {\n\tconst match = ID_REGEX.exec(id);\n\tif (!match) {\n\t\treturn null;\n\t}\n\treturn { prefix: match[1], ulid: match[2] };\n}\n"],"mappings":";;AAAA,MAAM,mBAAmB;AAEzB,MAAa,qBAAqB;CACjC,YAAY;CACZ,kBAAkB;CAClB,kBAAkB;CAClB,mBAAmB;CACnB,wBAAwB;CACxB,aAAa;CACb,oBAAoB;CACpB,0BAA0B;AAC3B;AAIA,MAAM,WAAW;AAEjB,SAAS,aAAa,QAAwB;CAC7C,IAAI,SAAS;CACb,MAAM,eAAe,IAAI,WAAW,MAAM;CAC1C,WAAW,OAAO,gBAAgB,YAAY;CAC9C,KAAK,MAAM,SAAS,cACnB,UAAU,iBAAiB,QAAQ;CAEpC,OAAO;AACR;AAEA,SAAS,yBAAiC;CACzC,IAAI,YAAY,KAAK,IAAI;CACzB,IAAI,cAAc;CAClB,KAAK,IAAI,QAAQ,GAAG,QAAQ,IAAI,SAAS;EACxC,cAAc,iBAAiB,YAAY,MAAM;EACjD,YAAY,KAAK,MAAM,YAAY,EAAE;CACtC;CACA,OAAO,GAAG,cAAc,aAAa,EAAE;AACxC;AAEA,SAAgB,eAAe,QAAgC;CAC9D,IAAI,CAAC,uBAAuB,KAAK,MAAM,GACtC,MAAM,IAAI,MAAM,6BAA6B,QAAQ;CAEtD,OAAO,GAAG,OAAO,GAAG,uBAAuB;AAC5C;AAEA,SAAgB,WAAW,IAAY,QAAkC;CACxE,MAAM,QAAQ,SAAS,KAAK,EAAE;CAC9B,IAAI,CAAC,OACJ,OAAO;CAER,OAAO,SAAS,MAAM,OAAO,SAAS;AACvC;AAEA,SAAgB,cAAc,IAAqD;CAClF,MAAM,QAAQ,SAAS,KAAK,EAAE;CAC9B,IAAI,CAAC,OACJ,OAAO;CAER,OAAO;EAAE,QAAQ,MAAM;EAAI,MAAM,MAAM;CAAG;AAC3C"}

package/dist/ids/index.d.cts

@@ -1,19 +1,19 @@
-declare const FABRIC_ID_PREFIXES: {
-    readonly assetEvent: "evt";
-    readonly actionInvocation: "act";
-    readonly policyEvaluation: "pol";
-    readonly adapterInvocation: "adp";
-    readonly adapterDeadLetterQueue: "dlq";
-    readonly accessEvent: "acc";
-    readonly projectionSnapshot: "psn";
-    readonly complianceEvidencePacket: "cep";
+//#region ids/index.d.ts
+export declare const FABRIC_ID_PREFIXES: {
+  readonly assetEvent: "evt";
+  readonly actionInvocation: "act";
+  readonly policyEvaluation: "pol";
+  readonly adapterInvocation: "adp";
+  readonly adapterDeadLetterQueue: "dlq";
+  readonly accessEvent: "acc";
+  readonly projectionSnapshot: "psn";
+  readonly complianceEvidencePacket: "cep";
 };
-type FabricIdPrefix = (typeof FABRIC_ID_PREFIXES)[keyof typeof FABRIC_ID_PREFIXES] | string;
-declare function createFabricId(prefix: FabricIdPrefix): string;
-declare function isFabricId(id: string, prefix?: FabricIdPrefix): boolean;
-declare function parseFabricId(id: string): {
-    prefix: string;
-    ulid: string;
+export type FabricIdPrefix = (typeof FABRIC_ID_PREFIXES)[keyof typeof FABRIC_ID_PREFIXES] | string;
+export declare function createFabricId(prefix: FabricIdPrefix): string;
+export declare function isFabricId(id: string, prefix?: FabricIdPrefix): boolean;
+export declare function parseFabricId(id: string): {
+  prefix: string;
+  ulid: string;
 } | null;
-
-export { FABRIC_ID_PREFIXES, type FabricIdPrefix, createFabricId, isFabricId, parseFabricId };
+//#endregion

package/dist/ids/index.d.ts

@@ -1,19 +1,19 @@
-declare const FABRIC_ID_PREFIXES: {
-    readonly assetEvent: "evt";
-    readonly actionInvocation: "act";
-    readonly policyEvaluation: "pol";
-    readonly adapterInvocation: "adp";
-    readonly adapterDeadLetterQueue: "dlq";
-    readonly accessEvent: "acc";
-    readonly projectionSnapshot: "psn";
-    readonly complianceEvidencePacket: "cep";
+//#region ids/index.d.ts
+export declare const FABRIC_ID_PREFIXES: {
+  readonly assetEvent: "evt";
+  readonly actionInvocation: "act";
+  readonly policyEvaluation: "pol";
+  readonly adapterInvocation: "adp";
+  readonly adapterDeadLetterQueue: "dlq";
+  readonly accessEvent: "acc";
+  readonly projectionSnapshot: "psn";
+  readonly complianceEvidencePacket: "cep";
 };
-type FabricIdPrefix = (typeof FABRIC_ID_PREFIXES)[keyof typeof FABRIC_ID_PREFIXES] | string;
-declare function createFabricId(prefix: FabricIdPrefix): string;
-declare function isFabricId(id: string, prefix?: FabricIdPrefix): boolean;
-declare function parseFabricId(id: string): {
-    prefix: string;
-    ulid: string;
+export type FabricIdPrefix = (typeof FABRIC_ID_PREFIXES)[keyof typeof FABRIC_ID_PREFIXES] | string;
+export declare function createFabricId(prefix: FabricIdPrefix): string;
+export declare function isFabricId(id: string, prefix?: FabricIdPrefix): boolean;
+export declare function parseFabricId(id: string): {
+  prefix: string;
+  ulid: string;
 } | null;
-
-export { FABRIC_ID_PREFIXES, type FabricIdPrefix, createFabricId, isFabricId, parseFabricId };
+//#endregion

package/dist/ids/index.js

@@ -1,3 +1,50 @@
-export { FABRIC_ID_PREFIXES, createFabricId, isFabricId, parseFabricId } from '../chunk-RALMUSOX.js';
-//# sourceMappingURL=index.js.map
+//#region ids/index.ts
+const CROCKFORD_BASE32 = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
+const FABRIC_ID_PREFIXES = {
+	assetEvent: "evt",
+	actionInvocation: "act",
+	policyEvaluation: "pol",
+	adapterInvocation: "adp",
+	adapterDeadLetterQueue: "dlq",
+	accessEvent: "acc",
+	projectionSnapshot: "psn",
+	complianceEvidencePacket: "cep"
+};
+const ID_REGEX = /^([a-z][a-z0-9]{1,7})_([0-9A-Z]{26})$/;
+function randomBase32(length) {
+	let output = "";
+	const randomValues = new Uint8Array(length);
+	globalThis.crypto.getRandomValues(randomValues);
+	for (const value of randomValues) output += CROCKFORD_BASE32[value % 32];
+	return output;
+}
+function createSortableRandomId() {
+	let timestamp = Date.now();
+	let encodedTime = "";
+	for (let index = 0; index < 10; index++) {
+		encodedTime = CROCKFORD_BASE32[timestamp % 32] + encodedTime;
+		timestamp = Math.floor(timestamp / 32);
+	}
+	return `${encodedTime}${randomBase32(16)}`;
+}
+function createFabricId(prefix) {
+	if (!/^[a-z][a-z0-9]{1,7}$/.test(prefix)) throw new Error(`Invalid Fabric ID prefix: ${prefix}`);
+	return `${prefix}_${createSortableRandomId()}`;
+}
+function isFabricId(id, prefix) {
+	const match = ID_REGEX.exec(id);
+	if (!match) return false;
+	return prefix ? match[1] === prefix : true;
+}
+function parseFabricId(id) {
+	const match = ID_REGEX.exec(id);
+	if (!match) return null;
+	return {
+		prefix: match[1],
+		ulid: match[2]
+	};
+}
+//#endregion
+export { FABRIC_ID_PREFIXES, createFabricId, isFabricId, parseFabricId };
+
 //# sourceMappingURL=index.js.map

package/dist/ids/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}
+{"version":3,"file":"index.js","names":[],"sources":["../../ids/index.ts"],"sourcesContent":["const CROCKFORD_BASE32 = \"0123456789ABCDEFGHJKMNPQRSTVWXYZ\";\n\nexport const FABRIC_ID_PREFIXES = {\n\tassetEvent: \"evt\",\n\tactionInvocation: \"act\",\n\tpolicyEvaluation: \"pol\",\n\tadapterInvocation: \"adp\",\n\tadapterDeadLetterQueue: \"dlq\",\n\taccessEvent: \"acc\",\n\tprojectionSnapshot: \"psn\",\n\tcomplianceEvidencePacket: \"cep\",\n} as const;\n\nexport type FabricIdPrefix = (typeof FABRIC_ID_PREFIXES)[keyof typeof FABRIC_ID_PREFIXES] | string;\n\nconst ID_REGEX = /^([a-z][a-z0-9]{1,7})_([0-9A-Z]{26})$/;\n\nfunction randomBase32(length: number): string {\n\tlet output = \"\";\n\tconst randomValues = new Uint8Array(length);\n\tglobalThis.crypto.getRandomValues(randomValues);\n\tfor (const value of randomValues) {\n\t\toutput += CROCKFORD_BASE32[value % CROCKFORD_BASE32.length];\n\t}\n\treturn output;\n}\n\nfunction createSortableRandomId(): string {\n\tlet timestamp = Date.now();\n\tlet encodedTime = \"\";\n\tfor (let index = 0; index < 10; index++) {\n\t\tencodedTime = CROCKFORD_BASE32[timestamp % 32] + encodedTime;\n\t\ttimestamp = Math.floor(timestamp / 32);\n\t}\n\treturn `${encodedTime}${randomBase32(16)}`;\n}\n\nexport function createFabricId(prefix: FabricIdPrefix): string {\n\tif (!/^[a-z][a-z0-9]{1,7}$/.test(prefix)) {\n\t\tthrow new Error(`Invalid Fabric ID prefix: ${prefix}`);\n\t}\n\treturn `${prefix}_${createSortableRandomId()}`;\n}\n\nexport function isFabricId(id: string, prefix?: FabricIdPrefix): boolean {\n\tconst match = ID_REGEX.exec(id);\n\tif (!match) {\n\t\treturn false;\n\t}\n\treturn prefix ? match[1] === prefix : true;\n}\n\nexport function parseFabricId(id: string): { prefix: string; ulid: string } | null {\n\tconst match = ID_REGEX.exec(id);\n\tif (!match) {\n\t\treturn null;\n\t}\n\treturn { prefix: match[1], ulid: match[2] };\n}\n"],"mappings":";AAAA,MAAM,mBAAmB;AAEzB,MAAa,qBAAqB;CACjC,YAAY;CACZ,kBAAkB;CAClB,kBAAkB;CAClB,mBAAmB;CACnB,wBAAwB;CACxB,aAAa;CACb,oBAAoB;CACpB,0BAA0B;AAC3B;AAIA,MAAM,WAAW;AAEjB,SAAS,aAAa,QAAwB;CAC7C,IAAI,SAAS;CACb,MAAM,eAAe,IAAI,WAAW,MAAM;CAC1C,WAAW,OAAO,gBAAgB,YAAY;CAC9C,KAAK,MAAM,SAAS,cACnB,UAAU,iBAAiB,QAAQ;CAEpC,OAAO;AACR;AAEA,SAAS,yBAAiC;CACzC,IAAI,YAAY,KAAK,IAAI;CACzB,IAAI,cAAc;CAClB,KAAK,IAAI,QAAQ,GAAG,QAAQ,IAAI,SAAS;EACxC,cAAc,iBAAiB,YAAY,MAAM;EACjD,YAAY,KAAK,MAAM,YAAY,EAAE;CACtC;CACA,OAAO,GAAG,cAAc,aAAa,EAAE;AACxC;AAEA,SAAgB,eAAe,QAAgC;CAC9D,IAAI,CAAC,uBAAuB,KAAK,MAAM,GACtC,MAAM,IAAI,MAAM,6BAA6B,QAAQ;CAEtD,OAAO,GAAG,OAAO,GAAG,uBAAuB;AAC5C;AAEA,SAAgB,WAAW,IAAY,QAAkC;CACxE,MAAM,QAAQ,SAAS,KAAK,EAAE;CAC9B,IAAI,CAAC,OACJ,OAAO;CAER,OAAO,SAAS,MAAM,OAAO,SAAS;AACvC;AAEA,SAAgB,cAAc,IAAqD;CAClF,MAAM,QAAQ,SAAS,KAAK,EAAE;CAC9B,IAAI,CAAC,OACJ,OAAO;CAER,OAAO;EAAE,QAAQ,MAAM;EAAI,MAAM,MAAM;CAAG;AAC3C"}

package/dist/index-9jasmw76.d.cts

@@ -0,0 +1,124 @@
+import { t as SurfaceDeclaration } from "./index-CIl1rYRv.cjs";
+import { o as PortableJsonSchema } from "./index-DZ4mnNb7.cjs";
+//#region projections/index.d.ts
+interface ReplayableAssetEvent<Payload = unknown> {
+  id: string;
+  tenantId: string;
+  spaceId: string;
+  eventType: string;
+  eventSchemaVersion?: number;
+  subjectType: string;
+  subjectId: string;
+  payload: Payload;
+  /**
+   * Monotonic ordering cursor for the tenant/space event ledger. It is not
+   * contiguous after a view filters event types or narrows to one subject.
+   */
+  sequence: number;
+  /** Optional contiguous sequence local to this subject. */
+  subjectSequence?: number;
+  occurredAt: Date | string;
+  recordedAt: Date | string;
+  actionInvocationId: string;
+  correlationId: string;
+}
+interface ViewEventConsumption {
+  eventType: string;
+  schemaVersions: number[];
+}
+interface ViewContract<State = unknown, Event extends ReplayableAssetEvent = ReplayableAssetEvent> extends SurfaceDeclaration {
+  /** Stable module-qualified logical identity, for example `orders/summary`. */
+  name: `${string}/${string}`;
+  version: string;
+  shape: PortableJsonSchema;
+  /** Optional JSON Schema for query parameters. Parameterized variants get isolated snapshots. */
+  parameterSchema?: PortableJsonSchema;
+  consumes: ViewEventConsumption[];
+  scope: "tenant-space";
+  snapshotVersion: number;
+  compatibleSnapshotVersions?: number[];
+  usage?: ViewUsageMetadata;
+  /** Required to transform any older compatible snapshot into the current state shape. */
+  upgradeSnapshot?: (data: unknown, fromVersion: number) => State | Promise<State>;
+  initialState: State;
+  applyEvent: (state: State, event: Event) => State | Promise<State>;
+}
+interface ViewUsageMetadata {
+  semanticRole?: string;
+  collection?: {
+    pagination: "cursor" | "offset" | "none";
+    filterSchema?: PortableJsonSchema;
+    sortFields?: string[];
+  };
+  freshness?: {
+    maximumAgeSeconds?: number;
+    offlineUsable?: boolean;
+  };
+  classification?: "public" | "internal" | "confidential" | "restricted";
+}
+declare function viewContractKey(view: Pick<ViewContract, "name" | "version">): string;
+interface ViewRegistry {
+  register(view: ViewContract): void;
+  registerIfMissing(view: ViewContract): void;
+  resolve(name: string, version: string): ViewContract | undefined;
+  keys(): string[];
+}
+declare function createViewRegistry(views?: readonly ViewContract[]): ViewRegistry;
+interface ReplayViewOptions<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {
+  view: ViewContract<State, Event>;
+  events: Iterable<Event> | AsyncIterable<Event>;
+  scope: ReplayScope;
+  snapshot?: (ReplaySnapshot<State> & {
+    snapshotVersion: number;
+  }) | null;
+  /**
+   * Set when the event source already applied the snapshot cursor and returns
+   * only later events. The snapshot still seeds state, but replay must not try
+   * to find its cursor in the supplied incremental stream.
+   */
+  eventsStartAfterSnapshot?: boolean;
+}
+declare function replayView<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent>({ view, events, scope, snapshot, eventsStartAfterSnapshot }: ReplayViewOptions<State, Event>): Promise<ReplayEventsResult<State, Event>>;
+interface ReplayScope {
+  tenantId: string;
+  spaceId: string;
+  subjectType?: string;
+  subjectId?: string;
+}
+interface ReplaySnapshot<State = unknown> {
+  snapshotData: State;
+  eventCursor?: string | null;
+  eventSequence?: number | null;
+  /** Per-subject high-water marks. Values prefer subjectSequence when supplied. */
+  subjectSequences?: Record<string, number>;
+}
+type ReplayWarningCode = "cursor_not_found" | "duplicate_event" | "missing_sequence" | "subject_scope_incomplete" | "unsupported_event_version";
+interface ReplayWarning {
+  code: ReplayWarningCode;
+  message: string;
+  eventId?: string;
+  subjectType?: string;
+  subjectId?: string;
+  expectedSequence?: number;
+  actualSequence?: number;
+}
+interface ReplayEventsOptions<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {
+  events: Iterable<Event> | AsyncIterable<Event>;
+  scope: ReplayScope;
+  initialState: State;
+  snapshot?: ReplaySnapshot<State> | null;
+  applyEvent: (state: State, event: Event) => State | Promise<State>;
+  /** The supplied stream begins after the snapshot checkpoint. */
+  eventsStartAfterSnapshot?: boolean;
+}
+interface ReplayEventsResult<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {
+  state: State;
+  appliedEvents: Event[];
+  warnings: ReplayWarning[];
+  eventCursor: string | null;
+  eventSequence: number;
+  subjectSequences: Record<string, number>;
+}
+declare function replayEvents<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent>({ events, scope, initialState, snapshot, applyEvent, eventsStartAfterSnapshot }: ReplayEventsOptions<State, Event>): Promise<ReplayEventsResult<State, Event>>;
+//#endregion
+export { ReplayViewOptions as a, ReplayableAssetEvent as c, ViewRegistry as d, ViewUsageMetadata as f, viewContractKey as g, replayView as h, ReplaySnapshot as i, ViewContract as l, replayEvents as m, ReplayEventsResult as n, ReplayWarning as o, createViewRegistry as p, ReplayScope as r, ReplayWarningCode as s, ReplayEventsOptions as t, ViewEventConsumption as u };

package/dist/index-BXpeFdk2.d.cts

@@ -0,0 +1,190 @@
+//#region privacy/engine.d.ts
+declare const ANONYMIZATION_POLICY_VERSION = "adr-026-platform-anonymization-v1";
+type JsonObject = Record<string, unknown>;
+interface AnonymizationFieldPolicy {
+  method: RedactionMethod;
+  match: "key" | "path";
+  value: string;
+}
+interface AnonymizationPolicy {
+  fields: readonly AnonymizationFieldPolicy[];
+  preservedSemantics?: readonly string[];
+}
+interface AssetEventLike {
+  id: string;
+  tenantId: string;
+  spaceId: string;
+  eventType: string;
+  subjectType: string;
+  subjectId: string;
+  actionInvocationId: string;
+  payload: unknown;
+  sequence: number;
+  occurredAt: Date;
+  recordedAt: Date;
+  correlationId: string;
+  causationId?: string | null;
+}
+interface EvidencePacketLike {
+  id: string;
+  packet: unknown;
+  redactionMetadata: unknown;
+  checksum: string;
+}
+interface AnonymizationLifecycleEvidence {
+  eventType: "AnonymizationApplied";
+  policyVersion: string;
+  jobId: string;
+  reason: string;
+  appliedAt: string;
+  tenantId: string;
+  spaceId: string | null;
+  counts: {
+    assetEvents: number;
+    readModels: number;
+    evidencePackets: number;
+    redactedFields: number;
+  };
+  records: Array<{
+    recordClass: PlatformDataClass;
+    recordId: string;
+    subjectType?: string;
+    subjectId?: string;
+    fieldManifest: Array<Pick<AnonymizationFieldMetadata, "fieldPath" | "method" | "beforeChecksum">>;
+  }>;
+  preservedSemantics: string[];
+}
+declare function stableChecksum(value: unknown): string;
+declare class FieldRedactor {
+  redactField(value: unknown, method: RedactionMethod, context: AnonymizationContext, path: string): unknown;
+  mask(value: unknown): string | null;
+  hash(value: unknown): string;
+  tokenize(value: unknown, context: AnonymizationContext, path: string): string;
+  generalize(value: unknown): unknown;
+}
+declare class AnonymizationEngine {
+  #private;
+  constructor(policy: AnonymizationPolicy);
+  anonymizeJsonValue<TValue>(value: TValue, context: AnonymizationContext, dataClass: PlatformDataClass): AnonymizationResult<TValue>;
+  anonymizeJsonValueAtPath<TValue>(value: TValue, context: AnonymizationContext, dataClass: PlatformDataClass, basePath: string): AnonymizationResult<TValue>;
+  anonymizeAssetEventPayload(event: AssetEventLike, context: AnonymizationContext): AnonymizationResult<unknown>;
+  anonymizeEvidencePacket(packet: EvidencePacketLike, context: AnonymizationContext): AnonymizationResult<Pick<EvidencePacketLike, "packet" | "redactionMetadata" | "checksum">>;
+  buildAnonymizationLifecycleEvidence(input: {
+    context: AnonymizationContext;
+    assetEvents?: Array<{
+      event: AssetEventLike;
+      metadata: AnonymizationMetadata;
+    }>;
+    readModels?: Array<{
+      modelKind: string;
+      record: JsonObject & {
+        id: string;
+      };
+      metadata: AnonymizationMetadata;
+    }>;
+    evidencePackets?: Array<{
+      packet: EvidencePacketLike;
+      metadata: AnonymizationMetadata;
+    }>;
+  }): AnonymizationLifecycleEvidence;
+}
+//#endregion
+//#region privacy/index.d.ts
+declare const PLATFORM_PRIVACY_POLICY_VERSION = "fabric-platform-privacy-v1";
+type RedactionMethod = "nullify" | "mask" | "hash" | "tokenize" | "generalize" | "drop";
+declare function anonymizeJsonValue<TValue>(value: TValue, context: AnonymizationContext, dataClass: PlatformDataClass, policy: AnonymizationPolicy): AnonymizationResult<TValue>;
+declare function anonymizeAssetEventPayload(event: AssetEventLike, context: AnonymizationContext, policy: AnonymizationPolicy): AnonymizationResult<unknown>;
+declare function anonymizeEvidencePacket(packet: EvidencePacketLike, context: AnonymizationContext, policy: AnonymizationPolicy): AnonymizationResult<Pick<EvidencePacketLike, "packet" | "redactionMetadata" | "checksum">>;
+declare function buildAnonymizationLifecycleEvidence(input: {
+  context: AnonymizationContext;
+  assetEvents?: Array<{
+    event: AssetEventLike;
+    metadata: AnonymizationMetadata;
+  }>;
+  readModels?: Array<{
+    modelKind: string;
+    record: Record<string, unknown> & {
+      id: string;
+    };
+    metadata: AnonymizationMetadata;
+  }>;
+  evidencePackets?: Array<{
+    packet: EvidencePacketLike;
+    metadata: AnonymizationMetadata;
+  }>;
+}, policy: AnonymizationPolicy): AnonymizationLifecycleEvidence;
+type PlatformDataClass = "asset_event" | "read_model" | "raw_payload" | "evidence_packet" | "action_evidence" | "access_event";
+interface RedactionRule {
+  fieldPath: string;
+  method: RedactionMethod;
+  reason: string;
+  dataClass?: PlatformDataClass;
+}
+interface DataClassificationRule {
+  fieldPath: string;
+  classification: string;
+  containsDirectIdentifier?: boolean;
+  containsSensitiveData?: boolean;
+}
+interface AnonymizationContext {
+  tenantId: string;
+  spaceId?: string | null;
+  jobId: string;
+  reason: string;
+  redactedAt?: Date;
+  policyVersion?: string;
+}
+interface AnonymizationFieldMetadata {
+  fieldPath: string;
+  method: RedactionMethod;
+  policyVersion: string;
+  jobId: string;
+  redactedAt: string;
+  reason: string;
+  dataClass: PlatformDataClass;
+  beforeChecksum: string;
+}
+interface AnonymizationMetadata {
+  redactionState: "anonymized";
+  policyVersion: string;
+  jobId: string;
+  redactedAt: string;
+  reason: string;
+  dataClass: PlatformDataClass;
+  redactedFields: AnonymizationFieldMetadata[];
+  preservedSemantics: string[];
+}
+interface AnonymizationResult<TValue> {
+  value: TValue;
+  metadata: AnonymizationMetadata;
+}
+interface AnalyticsDataContractSource {
+  name: string;
+  privacyClass: "raw" | "operational_pii" | "tenant_scoped_tokenized" | "anonymized" | "aggregated" | "differentially_minimized";
+  containsDirectIdentifiers?: boolean;
+  containsGloballyStablePersonTokens?: boolean;
+  anonymizationPolicyVersion?: string;
+  minimumGroupSize?: number;
+}
+interface AnalyticsDataContract {
+  contractId: string;
+  status: "draft" | "accepted" | "deprecated";
+  crossTenant: boolean;
+  acceptedBy?: string;
+  acceptedAt?: string;
+  adrReference?: string;
+  sources: AnalyticsDataContractSource[];
+}
+interface AnalyticsEligibilityDecision {
+  eligible: boolean;
+  policyVersion: string;
+  reasons: string[];
+}
+interface RetentionRule {
+  dataClass: PlatformDataClass;
+  retainForDays: number;
+  afterRetention: "delete" | "anonymize" | "archive";
+  legalHoldExempt?: boolean;
+}
+//#endregion
+export { AssetEventLike as C, stableChecksum as E, AnonymizationPolicy as S, FieldRedactor as T, buildAnonymizationLifecycleEvidence as _, AnonymizationFieldMetadata as a, AnonymizationFieldPolicy as b, DataClassificationRule as c, RedactionMethod as d, RedactionRule as f, anonymizeJsonValue as g, anonymizeEvidencePacket as h, AnonymizationContext as i, PLATFORM_PRIVACY_POLICY_VERSION as l, anonymizeAssetEventPayload as m, AnalyticsDataContractSource as n, AnonymizationMetadata as o, RetentionRule as p, AnalyticsEligibilityDecision as r, AnonymizationResult as s, AnalyticsDataContract as t, PlatformDataClass as u, ANONYMIZATION_POLICY_VERSION as v, EvidencePacketLike as w, AnonymizationLifecycleEvidence as x, AnonymizationEngine as y };