@fabricorg/platform 0.1.1 → 0.2.0

package/dist/privacy/index.d.cts

@@ -0,0 +1,77 @@
+declare const PLATFORM_PRIVACY_POLICY_VERSION = "fabric-platform-privacy-v1";
+type RedactionMethod = "nullify" | "mask" | "hash" | "tokenize" | "generalize" | "drop";
+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;
+}
+
+export { type AnalyticsDataContract, type AnalyticsDataContractSource, type AnalyticsEligibilityDecision, type AnonymizationContext, type AnonymizationFieldMetadata, type AnonymizationMetadata, type AnonymizationResult, type DataClassificationRule, PLATFORM_PRIVACY_POLICY_VERSION, type PlatformDataClass, type RedactionMethod, type RedactionRule, type RetentionRule };

package/dist/privacy/index.js

@@ -1,6 +1,3 @@
-// privacy/index.ts
-var PLATFORM_PRIVACY_POLICY_VERSION = "fabric-platform-privacy-v1";
-
-export { PLATFORM_PRIVACY_POLICY_VERSION };
+export { PLATFORM_PRIVACY_POLICY_VERSION } from '../chunk-N24NLCZ6.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/privacy/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../privacy/index.ts"],"names":[],"mappings":";AAAO,IAAM,+BAAA,GAAkC","file":"index.js","sourcesContent":["export const PLATFORM_PRIVACY_POLICY_VERSION = \"fabric-platform-privacy-v1\";\n\nexport type RedactionMethod = \"nullify\" | \"mask\" | \"hash\" | \"tokenize\" | \"generalize\" | \"drop\";\n\nexport type PlatformDataClass =\n\t| \"asset_event\"\n\t| \"read_model\"\n\t| \"raw_payload\"\n\t| \"evidence_packet\"\n\t| \"action_evidence\"\n\t| \"access_event\";\n\nexport interface RedactionRule {\n\tfieldPath: string;\n\tmethod: RedactionMethod;\n\treason: string;\n\tdataClass?: PlatformDataClass;\n}\n\nexport interface DataClassificationRule {\n\tfieldPath: string;\n\tclassification: string;\n\tcontainsDirectIdentifier?: boolean;\n\tcontainsSensitiveData?: boolean;\n}\n\nexport interface AnonymizationContext {\n\ttenantId: string;\n\tspaceId?: string | null;\n\tjobId: string;\n\treason: string;\n\tredactedAt?: Date;\n\tpolicyVersion?: string;\n}\n\nexport interface AnonymizationFieldMetadata {\n\tfieldPath: string;\n\tmethod: RedactionMethod;\n\tpolicyVersion: string;\n\tjobId: string;\n\tredactedAt: string;\n\treason: string;\n\tdataClass: PlatformDataClass;\n\tbeforeChecksum: string;\n}\n\nexport interface AnonymizationMetadata {\n\tredactionState: \"anonymized\";\n\tpolicyVersion: string;\n\tjobId: string;\n\tredactedAt: string;\n\treason: string;\n\tdataClass: PlatformDataClass;\n\tredactedFields: AnonymizationFieldMetadata[];\n\tpreservedSemantics: string[];\n}\n\nexport interface AnonymizationResult<TValue> {\n\tvalue: TValue;\n\tmetadata: AnonymizationMetadata;\n}\n\nexport interface AnalyticsDataContractSource {\n\tname: string;\n\tprivacyClass:\n\t\t| \"raw\"\n\t\t| \"operational_pii\"\n\t\t| \"tenant_scoped_tokenized\"\n\t\t| \"anonymized\"\n\t\t| \"aggregated\"\n\t\t| \"differentially_minimized\";\n\tcontainsDirectIdentifiers?: boolean;\n\tcontainsGloballyStablePersonTokens?: boolean;\n\tanonymizationPolicyVersion?: string;\n\tminimumGroupSize?: number;\n}\n\nexport interface AnalyticsDataContract {\n\tcontractId: string;\n\tstatus: \"draft\" | \"accepted\" | \"deprecated\";\n\tcrossTenant: boolean;\n\tacceptedBy?: string;\n\tacceptedAt?: string;\n\tadrReference?: string;\n\tsources: AnalyticsDataContractSource[];\n}\n\nexport interface AnalyticsEligibilityDecision {\n\teligible: boolean;\n\tpolicyVersion: string;\n\treasons: string[];\n}\n\nexport interface RetentionRule {\n\tdataClass: PlatformDataClass;\n\tretainForDays: number;\n\tafterRetention: \"delete\" | \"anonymize\" | \"archive\";\n\tlegalHoldExempt?: boolean;\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/projections/index.cjs

@@ -0,0 +1,12 @@
+'use strict';
+
+var chunkQ3WYIWCN_cjs = require('../chunk-Q3WYIWCN.cjs');
+
+
+
+Object.defineProperty(exports, "replayEvents", {
+  enumerable: true,
+  get: function () { return chunkQ3WYIWCN_cjs.replayEvents; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/projections/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/projections/index.d.cts

@@ -0,0 +1,52 @@
+interface ReplayableAssetEvent<Payload = unknown> {
+    id: string;
+    tenantId: string;
+    spaceId: string;
+    eventType: string;
+    subjectType: string;
+    subjectId: string;
+    payload: Payload;
+    sequence: number;
+    occurredAt: Date | string;
+    recordedAt: Date | string;
+    actionInvocationId: string;
+    correlationId: string;
+}
+interface ReplayScope {
+    tenantId: string;
+    spaceId: string;
+    subjectType?: string;
+    subjectId?: string;
+}
+interface ReplaySnapshot<State = unknown> {
+    snapshotData: State;
+    eventCursor?: string | null;
+    eventSequence?: number | null;
+}
+type ReplayWarningCode = "cursor_not_found" | "duplicate_event" | "missing_sequence" | "subject_scope_incomplete";
+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>;
+}
+interface ReplayEventsResult<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {
+    state: State;
+    appliedEvents: Event[];
+    warnings: ReplayWarning[];
+    eventCursor: string | null;
+    eventSequence: number;
+}
+declare function replayEvents<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent>({ events, scope, initialState, snapshot, applyEvent, }: ReplayEventsOptions<State, Event>): Promise<ReplayEventsResult<State, Event>>;
+
+export { type ReplayEventsOptions, type ReplayEventsResult, type ReplayScope, type ReplaySnapshot, type ReplayWarning, type ReplayWarningCode, type ReplayableAssetEvent, replayEvents };

package/dist/projections/index.js

@@ -1,181 +1,3 @@
-// projections/index.ts
-async function replayEvents({
-  events,
-  scope,
-  initialState,
-  snapshot,
-  applyEvent
-}) {
-  const warnings = [];
-  const scopedEvents = filterEventsByScope(await collectEvents(events), scope, warnings);
-  const orderedEvents = sortEvents(scopedEvents, isSubjectScoped(scope));
-  const uniqueEvents = removeDuplicateEvents(orderedEvents, warnings);
-  const resumableEvents = applyCursor(uniqueEvents, snapshot, isSubjectScoped(scope), warnings);
-  let state = snapshot?.snapshotData ?? initialState;
-  const appliedEvents = [];
-  let eventCursor = snapshot?.eventCursor ?? null;
-  let eventSequence = snapshot?.eventSequence ?? 0;
-  for (const event of resumableEvents) {
-    state = await applyEvent(state, event);
-    appliedEvents.push(event);
-    eventCursor = event.id;
-    eventSequence = event.sequence;
-  }
-  return {
-    state,
-    appliedEvents,
-    warnings,
-    eventCursor,
-    eventSequence
-  };
-}
-async function collectEvents(events) {
-  const collected = [];
-  if (Symbol.asyncIterator in events) {
-    for await (const event of events) {
-      collected.push(event);
-    }
-    return collected;
-  }
-  for (const event of events) {
-    collected.push(event);
-  }
-  return collected;
-}
-function filterEventsByScope(events, scope, warnings) {
-  if (scope.subjectType && !scope.subjectId || !scope.subjectType && scope.subjectId) {
-    warnings.push({
-      code: "subject_scope_incomplete",
-      message: "Both subjectType and subjectId are required for subject-scoped replay.",
-      subjectType: scope.subjectType,
-      subjectId: scope.subjectId
-    });
-  }
-  return events.filter((event) => {
-    if (event.tenantId !== scope.tenantId || event.spaceId !== scope.spaceId) {
-      return false;
-    }
-    if (scope.subjectType && event.subjectType !== scope.subjectType) {
-      return false;
-    }
-    if (scope.subjectId && event.subjectId !== scope.subjectId) {
-      return false;
-    }
-    return true;
-  });
-}
-function removeDuplicateEvents(events, warnings) {
-  const seenEventIds = /* @__PURE__ */ new Set();
-  const uniqueEvents = [];
-  for (const event of events) {
-    if (seenEventIds.has(event.id)) {
-      warnings.push({
-        code: "duplicate_event",
-        message: `Duplicate event ${event.id} ignored during replay.`,
-        eventId: event.id,
-        subjectType: event.subjectType,
-        subjectId: event.subjectId
-      });
-      continue;
-    }
-    seenEventIds.add(event.id);
-    uniqueEvents.push(event);
-  }
-  recordMissingSequenceWarnings(uniqueEvents, warnings);
-  return uniqueEvents;
-}
-function recordMissingSequenceWarnings(events, warnings) {
-  const lastSequenceBySubject = /* @__PURE__ */ new Map();
-  for (const event of events) {
-    const subjectKey = `${event.subjectType}:${event.subjectId}`;
-    const previousSequence = lastSequenceBySubject.get(subjectKey);
-    const expectedSequence = previousSequence === void 0 ? event.sequence : previousSequence + 1;
-    if (previousSequence !== void 0 && event.sequence > expectedSequence) {
-      warnings.push({
-        code: "missing_sequence",
-        message: `Missing event sequence for ${subjectKey}: expected ${expectedSequence}, received ${event.sequence}.`,
-        eventId: event.id,
-        subjectType: event.subjectType,
-        subjectId: event.subjectId,
-        expectedSequence,
-        actualSequence: event.sequence
-      });
-    }
-    lastSequenceBySubject.set(subjectKey, Math.max(previousSequence ?? event.sequence, event.sequence));
-  }
-}
-function applyCursor(events, snapshot, subjectScoped, warnings) {
-  const eventCursor = snapshot?.eventCursor;
-  if (eventCursor) {
-    const cursorIndex = events.findIndex((event) => event.id === eventCursor);
-    if (cursorIndex >= 0) {
-      return events.slice(cursorIndex + 1);
-    }
-    warnings.push({
-      code: "cursor_not_found",
-      message: `Snapshot cursor ${eventCursor} was not found in the scoped event stream.`,
-      eventId: eventCursor
-    });
-  }
-  if (subjectScoped && snapshot?.eventSequence !== void 0 && snapshot.eventSequence !== null) {
-    return events.filter((event) => event.sequence > snapshot.eventSequence);
-  }
-  return events;
-}
-function sortEvents(events, subjectScoped) {
-  return [...events].sort(
-    (first, second) => subjectScoped ? compareSubjectEvents(first, second) : compareGlobalEvents(first, second)
-  );
-}
-function compareSubjectEvents(first, second) {
-  return compareValues(
-    [first.sequence, toTimestamp(first.recordedAt), toTimestamp(first.occurredAt), first.id],
-    [second.sequence, toTimestamp(second.recordedAt), toTimestamp(second.occurredAt), second.id]
-  );
-}
-function compareGlobalEvents(first, second) {
-  return compareValues(
-    [
-      toTimestamp(first.recordedAt),
-      toTimestamp(first.occurredAt),
-      first.actionInvocationId,
-      first.correlationId,
-      first.subjectType,
-      first.subjectId,
-      first.sequence,
-      first.id
-    ],
-    [
-      toTimestamp(second.recordedAt),
-      toTimestamp(second.occurredAt),
-      second.actionInvocationId,
-      second.correlationId,
-      second.subjectType,
-      second.subjectId,
-      second.sequence,
-      second.id
-    ]
-  );
-}
-function compareValues(firstValues, secondValues) {
-  for (const [index, firstValue] of firstValues.entries()) {
-    const secondValue = secondValues[index];
-    if (firstValue < secondValue) {
-      return -1;
-    }
-    if (firstValue > secondValue) {
-      return 1;
-    }
-  }
-  return 0;
-}
-function isSubjectScoped(scope) {
-  return Boolean(scope.subjectType && scope.subjectId);
-}
-function toTimestamp(value) {
-  return value instanceof Date ? value.getTime() : new Date(value).getTime();
-}
-
-export { replayEvents };
+export { replayEvents } from '../chunk-JSTGOT6P.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/projections/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../projections/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["export interface ReplayableAssetEvent<Payload = unknown> {\n\tid: string;\n\ttenantId: string;\n\tspaceId: string;\n\teventType: string;\n\tsubjectType: string;\n\tsubjectId: string;\n\tpayload: Payload;\n\tsequence: number;\n\toccurredAt: Date | string;\n\trecordedAt: Date | string;\n\tactionInvocationId: string;\n\tcorrelationId: string;\n}\n\nexport interface ReplayScope {\n\ttenantId: string;\n\tspaceId: string;\n\tsubjectType?: string;\n\tsubjectId?: string;\n}\n\nexport interface ReplaySnapshot<State = unknown> {\n\tsnapshotData: State;\n\teventCursor?: string | null;\n\teventSequence?: number | null;\n}\n\nexport type ReplayWarningCode =\n\t| \"cursor_not_found\"\n\t| \"duplicate_event\"\n\t| \"missing_sequence\"\n\t| \"subject_scope_incomplete\";\n\nexport interface ReplayWarning {\n\tcode: ReplayWarningCode;\n\tmessage: string;\n\teventId?: string;\n\tsubjectType?: string;\n\tsubjectId?: string;\n\texpectedSequence?: number;\n\tactualSequence?: number;\n}\n\nexport interface ReplayEventsOptions<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {\n\tevents: Iterable<Event> | AsyncIterable<Event>;\n\tscope: ReplayScope;\n\tinitialState: State;\n\tsnapshot?: ReplaySnapshot<State> | null;\n\tapplyEvent: (state: State, event: Event) => State | Promise<State>;\n}\n\nexport interface ReplayEventsResult<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent> {\n\tstate: State;\n\tappliedEvents: Event[];\n\twarnings: ReplayWarning[];\n\teventCursor: string | null;\n\teventSequence: number;\n}\n\nexport async function replayEvents<State, Event extends ReplayableAssetEvent = ReplayableAssetEvent>({\n\tevents,\n\tscope,\n\tinitialState,\n\tsnapshot,\n\tapplyEvent,\n}: ReplayEventsOptions<State, Event>): Promise<ReplayEventsResult<State, Event>> {\n\tconst warnings: ReplayWarning[] = [];\n\tconst scopedEvents = filterEventsByScope(await collectEvents(events), scope, warnings);\n\tconst orderedEvents = sortEvents(scopedEvents, isSubjectScoped(scope));\n\tconst uniqueEvents = removeDuplicateEvents(orderedEvents, warnings);\n\tconst resumableEvents = applyCursor(uniqueEvents, snapshot, isSubjectScoped(scope), warnings);\n\n\tlet state = snapshot?.snapshotData ?? initialState;\n\tconst appliedEvents: Event[] = [];\n\tlet eventCursor = snapshot?.eventCursor ?? null;\n\tlet eventSequence = snapshot?.eventSequence ?? 0;\n\n\tfor (const event of resumableEvents) {\n\t\tstate = await applyEvent(state, event);\n\t\tappliedEvents.push(event);\n\t\teventCursor = event.id;\n\t\teventSequence = event.sequence;\n\t}\n\n\treturn {\n\t\tstate,\n\t\tappliedEvents,\n\t\twarnings,\n\t\teventCursor,\n\t\teventSequence,\n\t};\n}\n\nasync function collectEvents<Event extends ReplayableAssetEvent>(\n\tevents: Iterable<Event> | AsyncIterable<Event>,\n): Promise<Event[]> {\n\tconst collected: Event[] = [];\n\n\tif (Symbol.asyncIterator in events) {\n\t\tfor await (const event of events) {\n\t\t\tcollected.push(event);\n\t\t}\n\n\t\treturn collected;\n\t}\n\n\tfor (const event of events) {\n\t\tcollected.push(event);\n\t}\n\n\treturn collected;\n}\n\nfunction filterEventsByScope<Event extends ReplayableAssetEvent>(\n\tevents: Event[],\n\tscope: ReplayScope,\n\twarnings: ReplayWarning[],\n): Event[] {\n\tif ((scope.subjectType && !scope.subjectId) || (!scope.subjectType && scope.subjectId)) {\n\t\twarnings.push({\n\t\t\tcode: \"subject_scope_incomplete\",\n\t\t\tmessage: \"Both subjectType and subjectId are required for subject-scoped replay.\",\n\t\t\tsubjectType: scope.subjectType,\n\t\t\tsubjectId: scope.subjectId,\n\t\t});\n\t}\n\n\treturn events.filter((event) => {\n\t\tif (event.tenantId !== scope.tenantId || event.spaceId !== scope.spaceId) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (scope.subjectType && event.subjectType !== scope.subjectType) {\n\t\t\treturn false;\n\t\t}\n\n\t\tif (scope.subjectId && event.subjectId !== scope.subjectId) {\n\t\t\treturn false;\n\t\t}\n\n\t\treturn true;\n\t});\n}\n\nfunction removeDuplicateEvents<Event extends ReplayableAssetEvent>(\n\tevents: Event[],\n\twarnings: ReplayWarning[],\n): Event[] {\n\tconst seenEventIds = new Set<string>();\n\tconst uniqueEvents: Event[] = [];\n\n\tfor (const event of events) {\n\t\tif (seenEventIds.has(event.id)) {\n\t\t\twarnings.push({\n\t\t\t\tcode: \"duplicate_event\",\n\t\t\t\tmessage: `Duplicate event ${event.id} ignored during replay.`,\n\t\t\t\teventId: event.id,\n\t\t\t\tsubjectType: event.subjectType,\n\t\t\t\tsubjectId: event.subjectId,\n\t\t\t});\n\t\t\tcontinue;\n\t\t}\n\n\t\tseenEventIds.add(event.id);\n\t\tuniqueEvents.push(event);\n\t}\n\n\trecordMissingSequenceWarnings(uniqueEvents, warnings);\n\n\treturn uniqueEvents;\n}\n\nfunction recordMissingSequenceWarnings<Event extends ReplayableAssetEvent>(\n\tevents: Event[],\n\twarnings: ReplayWarning[],\n): void {\n\tconst lastSequenceBySubject = new Map<string, number>();\n\n\tfor (const event of events) {\n\t\tconst subjectKey = `${event.subjectType}:${event.subjectId}`;\n\t\tconst previousSequence = lastSequenceBySubject.get(subjectKey);\n\t\tconst expectedSequence = previousSequence === undefined ? event.sequence : previousSequence + 1;\n\n\t\tif (previousSequence !== undefined && event.sequence > expectedSequence) {\n\t\t\twarnings.push({\n\t\t\t\tcode: \"missing_sequence\",\n\t\t\t\tmessage: `Missing event sequence for ${subjectKey}: expected ${expectedSequence}, received ${event.sequence}.`,\n\t\t\t\teventId: event.id,\n\t\t\t\tsubjectType: event.subjectType,\n\t\t\t\tsubjectId: event.subjectId,\n\t\t\t\texpectedSequence,\n\t\t\t\tactualSequence: event.sequence,\n\t\t\t});\n\t\t}\n\n\t\tlastSequenceBySubject.set(subjectKey, Math.max(previousSequence ?? event.sequence, event.sequence));\n\t}\n}\n\nfunction applyCursor<Event extends ReplayableAssetEvent>(\n\tevents: Event[],\n\tsnapshot: ReplaySnapshot | null | undefined,\n\tsubjectScoped: boolean,\n\twarnings: ReplayWarning[],\n): Event[] {\n\tconst eventCursor = snapshot?.eventCursor;\n\n\tif (eventCursor) {\n\t\tconst cursorIndex = events.findIndex((event) => event.id === eventCursor);\n\n\t\tif (cursorIndex >= 0) {\n\t\t\treturn events.slice(cursorIndex + 1);\n\t\t}\n\n\t\twarnings.push({\n\t\t\tcode: \"cursor_not_found\",\n\t\t\tmessage: `Snapshot cursor ${eventCursor} was not found in the scoped event stream.`,\n\t\t\teventId: eventCursor,\n\t\t});\n\t}\n\n\tif (subjectScoped && snapshot?.eventSequence !== undefined && snapshot.eventSequence !== null) {\n\t\treturn events.filter((event) => event.sequence > snapshot.eventSequence!);\n\t}\n\n\treturn events;\n}\n\nfunction sortEvents<Event extends ReplayableAssetEvent>(events: Event[], subjectScoped: boolean): Event[] {\n\treturn [...events].sort((first, second) =>\n\t\tsubjectScoped ? compareSubjectEvents(first, second) : compareGlobalEvents(first, second),\n\t);\n}\n\nfunction compareSubjectEvents(first: ReplayableAssetEvent, second: ReplayableAssetEvent): number {\n\treturn compareValues(\n\t\t[first.sequence, toTimestamp(first.recordedAt), toTimestamp(first.occurredAt), first.id],\n\t\t[second.sequence, toTimestamp(second.recordedAt), toTimestamp(second.occurredAt), second.id],\n\t);\n}\n\nfunction compareGlobalEvents(first: ReplayableAssetEvent, second: ReplayableAssetEvent): number {\n\treturn compareValues(\n\t\t[\n\t\t\ttoTimestamp(first.recordedAt),\n\t\t\ttoTimestamp(first.occurredAt),\n\t\t\tfirst.actionInvocationId,\n\t\t\tfirst.correlationId,\n\t\t\tfirst.subjectType,\n\t\t\tfirst.subjectId,\n\t\t\tfirst.sequence,\n\t\t\tfirst.id,\n\t\t],\n\t\t[\n\t\t\ttoTimestamp(second.recordedAt),\n\t\t\ttoTimestamp(second.occurredAt),\n\t\t\tsecond.actionInvocationId,\n\t\t\tsecond.correlationId,\n\t\t\tsecond.subjectType,\n\t\t\tsecond.subjectId,\n\t\t\tsecond.sequence,\n\t\t\tsecond.id,\n\t\t],\n\t);\n}\n\nfunction compareValues(firstValues: Array<number | string>, secondValues: Array<number | string>): number {\n\tfor (const [index, firstValue] of firstValues.entries()) {\n\t\tconst secondValue = secondValues[index];\n\n\t\tif (firstValue < secondValue) {\n\t\t\treturn -1;\n\t\t}\n\n\t\tif (firstValue > secondValue) {\n\t\t\treturn 1;\n\t\t}\n\t}\n\n\treturn 0;\n}\n\nfunction isSubjectScoped(scope: ReplayScope): boolean {\n\treturn Boolean(scope.subjectType && scope.subjectId);\n}\n\nfunction toTimestamp(value: Date | string): number {\n\treturn value instanceof Date ? value.getTime() : new Date(value).getTime();\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/state-machines/index.cjs

@@ -0,0 +1,32 @@
+'use strict';
+
+var chunkGB2PSZ33_cjs = require('../chunk-GB2PSZ33.cjs');
+
+
+
+Object.defineProperty(exports, "getAllowedTransitions", {
+  enumerable: true,
+  get: function () { return chunkGB2PSZ33_cjs.getAllowedTransitions; }
+});
+Object.defineProperty(exports, "getEntityStateClass", {
+  enumerable: true,
+  get: function () { return chunkGB2PSZ33_cjs.getEntityStateClass; }
+});
+Object.defineProperty(exports, "registerStateMachine", {
+  enumerable: true,
+  get: function () { return chunkGB2PSZ33_cjs.registerStateMachine; }
+});
+Object.defineProperty(exports, "registerStateMachineIfMissing", {
+  enumerable: true,
+  get: function () { return chunkGB2PSZ33_cjs.registerStateMachineIfMissing; }
+});
+Object.defineProperty(exports, "resolveStateMachine", {
+  enumerable: true,
+  get: function () { return chunkGB2PSZ33_cjs.resolveStateMachine; }
+});
+Object.defineProperty(exports, "validateTransition", {
+  enumerable: true,
+  get: function () { return chunkGB2PSZ33_cjs.validateTransition; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/state-machines/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/state-machines/index.d.cts

@@ -0,0 +1,60 @@
+interface StateMachineDefinition {
+    entityType: string;
+    states: Record<string, StateDefinition>;
+    transitions: Array<{
+        from: string;
+        to: string;
+        causedByAction: string;
+        guard?: (ctx: TransitionContext) => boolean | Promise<boolean>;
+    }>;
+}
+type StateMachineDatabaseClient = any;
+interface TransitionContext<TDb = StateMachineDatabaseClient> {
+    entity: Record<string, unknown>;
+    actionInvocationId: string;
+    actorId: string;
+    parameters: unknown;
+    db: TDb;
+}
+/**
+ * Register a state-machine definition for an entity type.
+ * Throws if a definition for this entity type is already registered.
+ */
+declare function registerStateMachine(def: StateMachineDefinition): void;
+/**
+ * Register a state-machine definition only if one for this entity type
+ * is not already registered. Idempotent — safe to call multiple times.
+ */
+declare function registerStateMachineIfMissing(def: StateMachineDefinition): void;
+/**
+ * Resolve a previously registered state-machine definition by entity type.
+ */
+declare function resolveStateMachine(entityType: string): StateMachineDefinition | undefined;
+/**
+ * Validate whether a transition is allowed for the given entity type,
+ * from state, to state, and action ID.
+ */
+declare function validateTransition(entityType: string, from: string, to: string, actionId: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Get all allowed transitions from a given state for an entity type.
+ */
+declare function getAllowedTransitions(entityType: string, from: string): Array<{
+    to: string;
+    causedByAction: string;
+}>;
+/**
+ * Get the StateClass of a given state for an entity type.
+ */
+declare function getEntityStateClass(entityType: string, state: string): StateClass | undefined;
+
+type StateClass = "initial" | "active" | "action_required" | "waiting" | "terminal" | "exception";
+interface StateDefinition {
+    id: string;
+    label: string;
+    stateClass: StateClass;
+}
+
+export { type StateClass, type StateDefinition, type StateMachineDatabaseClient, type StateMachineDefinition, type TransitionContext, getAllowedTransitions, getEntityStateClass, registerStateMachine, registerStateMachineIfMissing, resolveStateMachine, validateTransition };

package/dist/state-machines/index.js

@@ -1,67 +1,3 @@
-// state-machines/engine.ts
-var registry = /* @__PURE__ */ new Map();
-function registerStateMachine(def) {
-  if (registry.has(def.entityType)) {
-    throw new Error(`State machine for entity type "${def.entityType}" is already registered.`);
-  }
-  registry.set(def.entityType, def);
-}
-function registerStateMachineIfMissing(def) {
-  if (!registry.has(def.entityType)) {
-    registerStateMachine(def);
-  }
-}
-function resolveStateMachine(entityType) {
-  return registry.get(entityType);
-}
-function validateTransition(entityType, from, to, actionId) {
-  const sm = registry.get(entityType);
-  if (!sm) {
-    return {
-      valid: false,
-      error: `No state machine registered for entity type "${entityType}".`
-    };
-  }
-  const fromDef = sm.states[from];
-  if (!fromDef) {
-    return {
-      valid: false,
-      error: `State "${from}" does not exist in state machine for entity type "${entityType}".`
-    };
-  }
-  const toDef = sm.states[to];
-  if (!toDef) {
-    return {
-      valid: false,
-      error: `State "${to}" does not exist in state machine for entity type "${entityType}".`
-    };
-  }
-  const transitionExists = sm.transitions.some(
-    (t) => t.from === from && t.to === to && t.causedByAction === actionId
-  );
-  if (!transitionExists) {
-    return {
-      valid: false,
-      error: `Transition from "${from}" to "${to}" via action "${actionId}" is not defined for entity type "${entityType}".`
-    };
-  }
-  return { valid: true };
-}
-function getAllowedTransitions(entityType, from) {
-  const sm = registry.get(entityType);
-  if (!sm) {
-    return [];
-  }
-  return sm.transitions.filter((t) => t.from === from).map((t) => ({ to: t.to, causedByAction: t.causedByAction }));
-}
-function getEntityStateClass(entityType, state) {
-  const sm = registry.get(entityType);
-  if (!sm) {
-    return void 0;
-  }
-  return sm.states[state]?.stateClass;
-}
-
-export { getAllowedTransitions, getEntityStateClass, registerStateMachine, registerStateMachineIfMissing, resolveStateMachine, validateTransition };
+export { getAllowedTransitions, getEntityStateClass, registerStateMachine, registerStateMachineIfMissing, resolveStateMachine, validateTransition } from '../chunk-3A6FU3KV.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/state-machines/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../state-machines/engine.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { StateClass, StateDefinition } from \"./index\";\n\nexport interface StateMachineDefinition {\n\tentityType: string;\n\tstates: Record<string, StateDefinition>;\n\ttransitions: Array<{\n\t\tfrom: string;\n\t\tto: string;\n\t\tcausedByAction: string;\n\t\tguard?: (ctx: TransitionContext) => boolean | Promise<boolean>;\n\t}>;\n}\n\nexport type StateMachineDatabaseClient = any;\n\nexport interface TransitionContext<TDb = StateMachineDatabaseClient> {\n\tentity: Record<string, unknown>;\n\tactionInvocationId: string;\n\tactorId: string;\n\tparameters: unknown;\n\tdb: TDb;\n}\n\nconst registry = new Map<string, StateMachineDefinition>();\n\n/**\n * Register a state-machine definition for an entity type.\n * Throws if a definition for this entity type is already registered.\n */\nexport function registerStateMachine(def: StateMachineDefinition): void {\n\tif (registry.has(def.entityType)) {\n\t\tthrow new Error(`State machine for entity type \"${def.entityType}\" is already registered.`);\n\t}\n\tregistry.set(def.entityType, def);\n}\n\n/**\n * Register a state-machine definition only if one for this entity type\n * is not already registered. Idempotent — safe to call multiple times.\n */\nexport function registerStateMachineIfMissing(def: StateMachineDefinition): void {\n\tif (!registry.has(def.entityType)) {\n\t\tregisterStateMachine(def);\n\t}\n}\n\n/**\n * Resolve a previously registered state-machine definition by entity type.\n */\nexport function resolveStateMachine(entityType: string): StateMachineDefinition | undefined {\n\treturn registry.get(entityType);\n}\n\n/**\n * Validate whether a transition is allowed for the given entity type,\n * from state, to state, and action ID.\n */\nexport function validateTransition(\n\tentityType: string,\n\tfrom: string,\n\tto: string,\n\tactionId: string,\n): { valid: boolean; error?: string } {\n\tconst sm = registry.get(entityType);\n\tif (!sm) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `No state machine registered for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\tconst fromDef = sm.states[from];\n\tif (!fromDef) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `State \"${from}\" does not exist in state machine for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\tconst toDef = sm.states[to];\n\tif (!toDef) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `State \"${to}\" does not exist in state machine for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\tconst transitionExists = sm.transitions.some(\n\t\t(t) => t.from === from && t.to === to && t.causedByAction === actionId,\n\t);\n\tif (!transitionExists) {\n\t\treturn {\n\t\t\tvalid: false,\n\t\t\terror: `Transition from \"${from}\" to \"${to}\" via action \"${actionId}\" is not defined for entity type \"${entityType}\".`,\n\t\t};\n\t}\n\n\treturn { valid: true };\n}\n\n/**\n * Get all allowed transitions from a given state for an entity type.\n */\nexport function getAllowedTransitions(\n\tentityType: string,\n\tfrom: string,\n): Array<{ to: string; causedByAction: string }> {\n\tconst sm = registry.get(entityType);\n\tif (!sm) {\n\t\treturn [];\n\t}\n\treturn sm.transitions\n\t\t.filter((t) => t.from === from)\n\t\t.map((t) => ({ to: t.to, causedByAction: t.causedByAction }));\n}\n\n/**\n * Get the StateClass of a given state for an entity type.\n */\nexport function getEntityStateClass(entityType: string, state: string): StateClass | undefined {\n\tconst sm = registry.get(entityType);\n\tif (!sm) {\n\t\treturn undefined;\n\t}\n\treturn sm.states[state]?.stateClass;\n}\n"]}
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/testing/index.cjs

@@ -0,0 +1,21 @@
+'use strict';
+
+var chunkYZKUEC2J_cjs = require('../chunk-YZKUEC2J.cjs');
+require('../chunk-NPVIFZQV.cjs');
+
+
+
+Object.defineProperty(exports, "createDeterministicIdFactory", {
+  enumerable: true,
+  get: function () { return chunkYZKUEC2J_cjs.createDeterministicIdFactory; }
+});
+Object.defineProperty(exports, "createFakeActionContext", {
+  enumerable: true,
+  get: function () { return chunkYZKUEC2J_cjs.createFakeActionContext; }
+});
+Object.defineProperty(exports, "createInMemoryAdapterRegistry", {
+  enumerable: true,
+  get: function () { return chunkYZKUEC2J_cjs.createInMemoryAdapterRegistry; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/testing/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}

package/dist/testing/index.d.cts

@@ -0,0 +1,19 @@
+import { AdapterRegistry } from '../adapters/index.cjs';
+import { ActorType, ActionContext } from '../actions/index.cjs';
+
+interface FakeActionContextOptions<TDb = Record<string, never>> {
+    actionInvocationId?: string;
+    tenantId?: string;
+    spaceId?: string;
+    actorId?: string;
+    actorType?: ActorType;
+    correlationId?: string;
+    causationId?: string;
+    db?: TDb;
+    services?: Record<string, unknown>;
+}
+declare function createFakeActionContext<TDb = Record<string, never>>(options?: FakeActionContextOptions<TDb>): ActionContext<TDb>;
+declare function createInMemoryAdapterRegistry(): AdapterRegistry;
+declare function createDeterministicIdFactory(prefix?: string): () => string;
+
+export { type FakeActionContextOptions, createDeterministicIdFactory, createFakeActionContext, createInMemoryAdapterRegistry };