@spine-event-engine/storage 2.0.0-snapshot.10

package/dist/entity/entity-history-storage.d.ts

@@ -0,0 +1,111 @@
+import type { Message } from "@bufbuild/protobuf";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { Event } from "@spine-event-engine/proto";
+import type { EntityRecord } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+/**
+ * Represents application-managed maintenance for retained entity state history.
+ */
+declare const entityStateHistoryState: unique symbol;
+declare const entityEventHistoryEntity: unique symbol;
+/**
+ * Defines retention maintenance for one entity state history.
+ */
+export interface EntityStateHistoryStorage<I, S extends Message> {
+    /**
+     * Brands the storage with its retained state type.
+     */
+    readonly [entityStateHistoryState]?: S;
+    /**
+     * Updates retained versioned states for one entity.
+     * @param entityId The entity whose history is trimmed.
+     * @param keepMostRecent The number of newest states to keep.
+     * @returns Completes when maintenance finishes.
+     */
+    trim(entityId: I, keepMostRecent: number): Promise<void>;
+    /**
+     * Removes states created strictly before the supplied time.
+     * @param olderThan The exclusive retention cutoff.
+     * @returns Completes when maintenance finishes.
+     */
+    truncate(olderThan: Timestamp): Promise<void>;
+}
+/**
+ * Application-managed maintenance for retained diagnostic entity events.
+ */
+export interface EntityEventStorage<I> {
+    /**
+     * Brands the storage with its retained entity identifier type.
+     */
+    readonly [entityEventHistoryEntity]?: I;
+    /**
+     * Removes events created strictly before the supplied time.
+     * @param olderThan The exclusive retention cutoff.
+     * @returns Completes when maintenance finishes.
+     */
+    truncate(olderThan: Timestamp): Promise<void>;
+}
+/**
+ * Internal state-history read and append seam used by repository implementations.
+ */
+export interface EntityStateHistoryPort<I, S extends Message> extends EntityStateHistoryStorage<I, S> {
+    /**
+     * Stores one versioned state-history record.
+     * @param record The state-history record to append.
+     * @returns Completes when the record is stored.
+     */
+    append(record: EntityRecord): Promise<void>;
+    /**
+     * Reads versioned states backward from an optional version.
+     * @param entityId The entity whose history is read.
+     * @param depth The maximum number of records to return.
+     * @param startingFromVersion The inclusive version at which to start.
+     * @returns The matching history records in reverse version order.
+     */
+    backward(entityId: I, depth: number, startingFromVersion?: bigint): Promise<readonly EntityRecord[]>;
+    /**
+     * Reads the state current at a specific time.
+     * @param entityId The entity whose state is read.
+     * @param time The point in time to inspect.
+     * @returns The state at that time, if retained.
+     */
+    stateAt(entityId: I, time: Timestamp): Promise<S | undefined>;
+    /**
+     * Closes the state-history storage.
+     */
+    close(): void;
+}
+/**
+ * Internal diagnostic event-history read and append seam used by repositories.
+ */
+export interface EntityEventHistoryPort<I> extends EntityEventStorage<I> {
+    /**
+     * Stores one diagnostic event-history record.
+     * @param record The event-history record to append.
+     * @returns Completes when the record is stored.
+     */
+    append(record: Event): Promise<void>;
+    /**
+     * Reads diagnostic events backward from an optional version.
+     * @param entityId The entity whose events are read.
+     * @param depth The maximum number of events to return.
+     * @param startingFromVersion The inclusive version at which to start.
+     * @returns The matching events in reverse version order.
+     */
+    backward(entityId: I, depth: number, startingFromVersion?: bigint): Promise<readonly Event[]>;
+    /**
+     * Closes the event-history storage.
+     */
+    close(): void;
+}
+/**
+ * Creates a history port that deliberately allocates no backing storage.
+ * @returns The disabled state-history port.
+ */
+export declare function disabledStateHistoryPort<I, S extends Message>(): EntityStateHistoryPort<I, S>;
+/**
+ * Creates a diagnostic event-history port that deliberately allocates no backing storage.
+ * @returns The disabled event-history port.
+ */
+export declare function disabledEventHistoryPort<I>(): EntityEventHistoryPort<I>;
+export {};
+//# sourceMappingURL=entity-history-storage.d.ts.map

package/dist/entity/entity-history-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-history-storage.d.ts","sourceRoot":"","sources":["../../src/entity/entity-history-storage.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sEAAsE,CAAC;AAEzG;;GAEG;AACH,OAAO,CAAC,MAAM,uBAAuB,EAAE,OAAO,MAAM,CAAC;AACrD,OAAO,CAAC,MAAM,wBAAwB,EAAE,OAAO,MAAM,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,yBAAyB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IAG7D;;OAEG;IACH,QAAQ,CAAC,CAAC,uBAAuB,CAAC,CAAC,EAAE,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,IAAI,CAAC,QAAQ,EAAE,CAAC,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IAGnC;;OAEG;IACH,QAAQ,CAAC,CAAC,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC;IAExC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,CAAE,SAAQ,yBAAyB,CAC7F,CAAC,EACD,CAAC,CACF;IAGC;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5C;;;;;;OAMG;IACH,QAAQ,CACN,QAAQ,EAAE,CAAC,EACX,KAAK,EAAE,MAAM,EACb,mBAAmB,CAAC,EAAE,MAAM,GAC3B,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAEpC;;;;;OAKG;IACH,OAAO,CAAC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAE9D;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB,CAAC,CAAC,CAAE,SAAQ,kBAAkB,CAAC,CAAC,CAAC;IAGtE;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC,CAAC;IAE9F;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,KAAK,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAS7F;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,KAAK,sBAAsB,CAAC,CAAC,CAAC,CAOvE"}

package/dist/entity/entity-history-storage.js

@@ -0,0 +1,40 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+/**
+ * Creates a history port that deliberately allocates no backing storage.
+ * @returns The disabled state-history port.
+ */
+export function disabledStateHistoryPort() {
+    return {
+        append: () => Promise.reject(new Error("Entity state history is disabled.")),
+        backward: () => Promise.resolve(Object.freeze([])),
+        stateAt: () => Promise.resolve(undefined),
+        trim: () => Promise.resolve(),
+        truncate: () => Promise.resolve(),
+        close: () => undefined,
+    };
+}
+/**
+ * Creates a diagnostic event-history port that deliberately allocates no backing storage.
+ * @returns The disabled event-history port.
+ */
+export function disabledEventHistoryPort() {
+    return {
+        append: () => Promise.reject(new Error("Entity event history is disabled.")),
+        backward: () => Promise.resolve(Object.freeze([])),
+        truncate: () => Promise.resolve(),
+        close: () => undefined,
+    };
+}
+//# sourceMappingURL=entity-history-storage.js.map

package/dist/entity/entity-history-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-history-storage.js","sourceRoot":"","sources":["../../src/entity/entity-history-storage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkIH;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC5E,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC;QACzC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QAC7B,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QACjC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB;IACtC,OAAO;QACL,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;QAC5E,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAClD,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE;QACjC,KAAK,EAAE,GAAG,EAAE,CAAC,SAAS;KACvB,CAAC;AACJ,CAAC"}

package/dist/entity/entity-record.d.ts

@@ -0,0 +1,31 @@
+import type { EntityRecord } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+export type { EntityRecord } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import type { NormalizedQueryEntry } from "../query/query-execution.js";
+import type { NormalizedQueryPlan } from "../query/query-policy.js";
+/**
+ * Internal latest-state persistence port for one Entity identifier type.
+ */
+export interface EntityRecordStorage<I> {
+    /**
+     * Reads the latest JVM EntityRecord for an entity ID.
+     *
+     * @param id The entity ID to read.
+     * @returns The current EntityRecord, when present.
+     */
+    read(id: I): Promise<EntityRecord | undefined>;
+    /**
+     * Writes one JVM EntityRecord envelope.
+     *
+     * @param record The EntityRecord to persist.
+     * @returns A promise that resolves once the record is persisted.
+     */
+    write(record: EntityRecord): Promise<void>;
+    /**
+     * Reads normalized current records with provider materialized columns.
+     *
+     * @param plan The normalized current-record query plan.
+     * @returns Matching records and materialized columns.
+     */
+    query(plan: NormalizedQueryPlan<I>): Promise<readonly NormalizedQueryEntry<I, EntityRecord>[]>;
+}
+//# sourceMappingURL=entity-record.d.ts.map

package/dist/entity/entity-record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-record.d.ts","sourceRoot":"","sources":["../../src/entity/entity-record.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sEAAsE,CAAC;AACzG,YAAY,EAAE,YAAY,EAAE,MAAM,sEAAsE,CAAC;AACzG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;GAEG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC;IAGpC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAAC;IAE/C;;;;;OAKG;IACH,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE3C;;;;;OAKG;IACH,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,oBAAoB,CAAC,CAAC,EAAE,YAAY,CAAC,EAAE,CAAC,CAAC;CAChG"}

package/dist/entity/entity-record.js

@@ -0,0 +1,15 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+export {};
+//# sourceMappingURL=entity-record.js.map

package/dist/entity/entity-record.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-record.js","sourceRoot":"","sources":["../../src/entity/entity-record.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG"}

package/dist/entity/history-conformance.d.ts

@@ -0,0 +1,55 @@
+import { type Message } from "@bufbuild/protobuf";
+import { type StringValue } from "@bufbuild/protobuf/wkt";
+import type { EntityEventHistoryPort, EntityStateHistoryPort } from "./entity-history-storage.js";
+import type { EntityRecordStorage } from "./entity-record.js";
+import type { EntityStorageInput } from "../memory/in-memory-entity-history.js";
+/**
+ * Provides the current-record and state-history handles used by adapter conformance checks.
+ */
+export interface EntityStorageConformance<I, S extends Message> {
+    /**
+     * Stores current Entity records.
+     */
+    readonly current: EntityRecordStorage<I>;
+    /**
+     * Stores retained generated Entity records for state history.
+     */
+    readonly states: EntityStateHistoryPort<I, S>;
+    /**
+     * Stores retained generated diagnostic events.
+     */
+    readonly events: EntityEventHistoryPort<I>;
+    /**
+     * Closes provider-owned resources when needed.
+     */
+    close?(): void;
+}
+/**
+ * Creates a provider handle for the reusable current-record and state-history checks.
+ */
+export interface EntityHistoryConformanceAdapter {
+    /**
+     * Creates storage for the supplied Entity shape.
+     *
+     * @param input Defines the Entity storage scope and schemas.
+     * @returns The provider handle.
+     */
+    readonly create: (input: EntityStorageInput<string, StringValue>) => EntityStorageConformance<string, StringValue>;
+    /**
+     * Creates a reopened handle for the same Entity shape.
+     *
+     * @param input Defines the Entity storage scope and schemas.
+     * @returns The reopened provider handle.
+     */
+    readonly reopen: (input: EntityStorageInput<string, StringValue>) => EntityStorageConformance<string, StringValue>;
+}
+interface EntityHistoryConformanceChecks {
+    readonly checkCurrentQueries: (adapter: EntityHistoryConformanceAdapter) => Promise<void>;
+    readonly check: (adapter: EntityHistoryConformanceAdapter) => Promise<void>;
+}
+/**
+ * Runs provider-neutral current-record and generated state-history checks.
+ */
+export declare const EntityHistoryConformance: EntityHistoryConformanceChecks;
+export {};
+//# sourceMappingURL=history-conformance.d.ts.map

package/dist/entity/history-conformance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-conformance.d.ts","sourceRoot":"","sources":["../../src/entity/history-conformance.ts"],"names":[],"mappings":"AAcA,OAAO,EAA4C,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAKL,KAAK,WAAW,EACjB,MAAM,wBAAwB,CAAC;AAOhC,OAAO,KAAK,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAClG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAKhF;;GAEG;AACH,MAAM,WAAW,wBAAwB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO;IAG5D;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE9C;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC,CAAC,CAAC;IAE3C;;OAEG;IACH,KAAK,CAAC,IAAI,IAAI,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAG9C;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,CACf,KAAK,EAAE,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,KAC3C,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAEnD;;;;;OAKG;IACH,QAAQ,CAAC,MAAM,EAAE,CACf,KAAK,EAAE,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,KAC3C,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACpD;AAED,UAAU,8BAA8B;IACtC,QAAQ,CAAC,mBAAmB,EAAE,CAAC,OAAO,EAAE,+BAA+B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,QAAQ,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,+BAA+B,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7E;AAED;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,8BAuFrC,CAAC"}

package/dist/entity/history-conformance.js

@@ -0,0 +1,165 @@
+/*
+ * Copyright 2026, CodeMatters. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
+ * in compliance with the License. You may obtain a copy of the License at
+ *
+ * https://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software distributed under the License
+ * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
+ * or implied. See the License for the specific language governing permissions and limitations under
+ * the License.
+ */
+import { create, fromBinary, ScalarType, toBinary } from "@bufbuild/protobuf";
+import { AnySchema, StringValueSchema, TimestampSchema, } from "@bufbuild/protobuf/wkt";
+import { EntityRecordSchema, } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
+import { EventIdSchema, EventSchema, VersionSchema } from "@spine-event-engine/proto";
+import { RecordColumn } from "../record/record-column.js";
+import { ColumnTypes } from "../record/column-type.js";
+import { RecordSpec } from "../record/record-spec.js";
+/**
+ * Runs provider-neutral current-record and generated state-history checks.
+ */
+export const EntityHistoryConformance = Object.freeze({
+    // prettier-ignore
+    /**
+     * Checks the shared current-record behavior.
+     *
+     * @param adapter Supplies the provider under test.
+     * @returns Completes when the behavior is verified.
+     */
+    async checkCurrentQueries(adapter) {
+        const storage = adapter.create(EntityHistoryFixture.input());
+        try {
+            await storage.current.write(EntityHistoryFixture.record("task", "task", 3));
+            await storage.current.write(EntityHistoryFixture.record("later", "later", 4));
+            const queried = await storage.current.query({
+                predicate: { kind: "comparison", column: "value", operator: "equal", value: "later" },
+                order: [{ column: "value", direction: "asc" }],
+                limit: 1,
+                candidateLimit: 2,
+            });
+            const current = await storage.current.read("task");
+            EntityHistoryFixture.assert(current !== undefined, "current state must round-trip");
+            EntityHistoryFixture.assert(EntityHistoryFixture.state(current).value === "task", "current state must round-trip");
+            EntityHistoryFixture.assert(queried.length === 1 && queried[0]?.id === "later", "current queries must filter, order, and limit generated records");
+        }
+        finally {
+            storage.close?.();
+        }
+        const reopened = adapter.reopen(EntityHistoryFixture.input());
+        try {
+            EntityHistoryFixture.assert((await reopened.current.read("task")) !== undefined, "current record must survive reopen");
+        }
+        finally {
+            reopened.close?.();
+        }
+    },
+    /**
+     * Checks the generated state-history behavior.
+     *
+     * @param adapter Supplies the provider under test.
+     * @returns Completes when the behavior is verified.
+     */
+    async check(adapter) {
+        await EntityHistoryConformance.checkCurrentQueries(adapter);
+        const input = EntityHistoryFixture.input();
+        const storage = adapter.create(input);
+        try {
+            await storage.states.append(EntityHistoryFixture.record("task", "first", 1));
+            await storage.states.append(EntityHistoryFixture.record("task", "second", 2));
+            const backward = await storage.states.backward("task", 2);
+            const newest = backward[0];
+            const older = backward[1];
+            EntityHistoryFixture.assert(newest !== undefined &&
+                older !== undefined &&
+                EntityHistoryFixture.state(newest).value === "second" &&
+                EntityHistoryFixture.state(older).value === "first", "state history must return newest records first");
+            EntityHistoryFixture.assert((await storage.states.stateAt("task", create(TimestampSchema, { seconds: 1n })))?.value ===
+                "first", "state history must return the state at an inclusive timestamp");
+            const event = EntityHistoryFixture.event("event", "task", 2);
+            await storage.events.append(event);
+            EntityHistoryFixture.assert((await storage.events.backward("task", 1))[0]?.id?.value === "event", "event history must retain generated events");
+            await storage.events.truncate(create(TimestampSchema, { seconds: 3n }));
+            EntityHistoryFixture.assert((await storage.events.backward("task", 1)).length === 0, "event history truncation must remove older generated events");
+        }
+        finally {
+            storage.close?.();
+        }
+    },
+});
+const EntityHistoryFixture = Object.freeze({
+    input() {
+        const unpack = (id) => id.typeUrl.endsWith(`/${StringValueSchema.typeName}`)
+            ? fromBinary(StringValueSchema, id.value).value
+            : undefined;
+        const columns = [
+            new RecordColumn("value", ColumnTypes.scalar(ScalarType.STRING), (record) => EntityHistoryFixture.state(record).value),
+        ];
+        return {
+            context: { name: "EntityHistoryConformance", multitenant: false },
+            id: {
+                clone: (id) => id,
+                key: (id) => id,
+                pack: (id) => EntityHistoryFixture.pack(create(StringValueSchema, { value: id })),
+                unpack,
+            },
+            columns,
+            recordSpec: new RecordSpec({
+                sourceType: StringValueSchema,
+                recordType: EntityRecordSchema,
+                idKind: "string",
+                extractId: (record) => {
+                    if (record.entityId === undefined)
+                        throw new Error("EntityRecord requires entityId.");
+                    const id = unpack(record.entityId);
+                    if (id === undefined)
+                        throw new Error("EntityRecord has an incompatible ID.");
+                    return id;
+                },
+                columns,
+            }),
+            sourceType: StringValueSchema,
+            stateSchema: StringValueSchema,
+            stateHistory: true,
+            eventHistory: true,
+        };
+    },
+    record(id, state, version) {
+        return create(EntityRecordSchema, {
+            entityId: EntityHistoryFixture.pack(create(StringValueSchema, { value: id })),
+            state: EntityHistoryFixture.pack(create(StringValueSchema, { value: state })),
+            version: {
+                number: version,
+                timestamp: create(TimestampSchema, { seconds: BigInt(version) }),
+            },
+        });
+    },
+    pack(value) {
+        return create(AnySchema, {
+            typeUrl: `type.spine.io/${StringValueSchema.typeName}`,
+            value: toBinary(StringValueSchema, value),
+        });
+    },
+    state(record) {
+        if (record.state === undefined)
+            throw new Error("Entity record has no state.");
+        return fromBinary(StringValueSchema, record.state.value);
+    },
+    event(id, producer, version) {
+        return create(EventSchema, {
+            id: create(EventIdSchema, { value: id }),
+            context: {
+                producerId: EntityHistoryFixture.pack(create(StringValueSchema, { value: producer })),
+                timestamp: create(TimestampSchema, { seconds: BigInt(version) }),
+                version: create(VersionSchema, { number: version }),
+            },
+        });
+    },
+    assert(condition, message) {
+        if (!condition)
+            throw new Error(`Entity storage conformance failed: ${message}`);
+    },
+});
+//# sourceMappingURL=history-conformance.js.map

package/dist/entity/history-conformance.js.map

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

package/dist/event/event-store.d.ts

@@ -0,0 +1,141 @@
+import type { Event, EventId, TenantId } from "@spine-event-engine/proto";
+import type { RecordQuery } from "../record/record-query.js";
+import { RecordSpec } from "../record/record-spec.js";
+import type { StorageContext } from "../storage/storage.js";
+import type { StorageFactory } from "../storage/storage-factory.js";
+/**
+ * Framework event store backed by record storage.
+ *
+ * Snapshots input events before queued work, rejects missing, blank, and
+ * duplicate IDs in one batch, and rejects IDs already stored for the same
+ * captured storage context.
+ */
+export declare class EventStore {
+    #private;
+    /**
+     * Creates an event store for one storage context.
+     *
+     * @param context Specifies the storage context.
+     * @param factory Creates the backing record storage.
+     */
+    constructor(context: EventStoreContext, factory: StorageFactory);
+    /**
+     * Returns whether this Event Store still accepts operations.
+     *
+     * @returns Returns true until this Event Store is closed.
+     */
+    isOpen(): boolean;
+    /**
+     * Closes this Event Store. Operation-selected storage handles close after use.
+     */
+    close(): void;
+    /**
+     * Validates that one generated Spine event can be appended without storing it.
+     *
+     * @param event Supplies the event to validate.
+     * @returns Completes when the event is accepted.
+     */
+    accept(event: Event): Promise<void>;
+    /**
+     * Accepts one event, runs caller acceptance, and appends using one captured
+     * storage context.
+     *
+     * @param event Supplies the event to accept.
+     * @param onAccepted Runs after uniqueness validation and before append.
+     * @returns Resolves to the appended event snapshot.
+     */
+    acceptThenAppend(event: Event, onAccepted: OnEventAccepted): Promise<Event>;
+    /**
+     * Writes one generated Spine event, rejecting missing, blank, or duplicate IDs.
+     *
+     * @param event Supplies the event to append.
+     * @returns Completes when the event is appended.
+     */
+    append(event: Event): Promise<void>;
+    /**
+     * Writes generated Spine events in order, rejecting missing, blank, or duplicate IDs.
+     *
+     * @param events Supplies the events to append.
+     * @returns Completes when the events are appended.
+     */
+    appendAll(events: Iterable<Event>): Promise<void>;
+    /**
+     * Writes generated Spine events and returns a one-shot rollback token.
+     *
+     * @param events Supplies the events to append.
+     * @returns Resolves to the rollback token for this append.
+     */
+    appendAllWithRollback(events: Iterable<Event>): Promise<EventRollback>;
+    /**
+     * Reads persisted events through the underlying record-storage query seam.
+     *
+     * @param query Specifies the record query.
+     * @returns Resolves to matching events.
+     */
+    read(query?: RecordQuery<EventId>): Promise<readonly Event[]>;
+    private appendUnique;
+    private deleteIds;
+    private checkUnique;
+    private requireOpen;
+}
+/**
+ * Selects Event Store tenancy before an event envelope supplies a tenant.
+ *
+ * Multitenant append operations may omit `tenantId` only because the complete
+ * tenant is then required in every stored event envelope. Reads require an
+ * explicitly selected tenant.
+ */
+export type EventStoreContext = {
+    /**
+     * Diagnostic Bounded Context name.
+     */
+    readonly name: string;
+    /**
+     * Selects the one unpartitioned storage boundary.
+     */
+    readonly multitenant: false;
+} | {
+    /**
+     * Diagnostic Bounded Context name.
+     */
+    readonly name: string;
+    /**
+     * Requires tenant selection for every storage operation.
+     */
+    readonly multitenant: true;
+    /**
+     * Selects a default complete tenant when an event does not carry one.
+     */
+    readonly tenantId?: TenantId;
+};
+/**
+ * Accepts an event after `EventStore` prechecks it and before append.
+ *
+ * @param event Supplies the validated event snapshot.
+ * @returns Completes after caller acceptance finishes.
+ */
+export type OnEventAccepted = (event: Event) => Promise<void> | void;
+/**
+ * One-shot rollback token scoped to one successful event-store append.
+ */
+export interface EventRollback {
+    /**
+     * Deletes the events appended by the operation that created this token.
+     * @returns Completes when the events are deleted.
+     */
+    rollback(): Promise<void>;
+}
+/**
+ * Provider-only coordination access for the Event Store context lock.
+ * @internal
+ */
+export declare const eventStoreAccess: {
+    readonly withLock: <T>(factory: StorageFactory, context: StorageContext, work: () => Promise<T>) => Promise<T>;
+};
+/**
+ * Provides the canonical event-store record layout to provider-only internals.
+ *
+ * @internal
+ */
+export declare const eventStoreRecordSpec: RecordSpec<EventId, Event>;
+//# sourceMappingURL=event-store.d.ts.map

package/dist/event/event-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-store.d.ts","sourceRoot":"","sources":["../../src/event/event-store.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAK1E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAEtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAGpE;;;;;;GAMG;AACH,qBAAa,UAAU;;IAKrB;;;;;OAKG;gBACS,OAAO,EAAE,iBAAiB,EAAE,OAAO,EAAE,cAAc;IAK/D;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC;;;;;;;OAOG;IACG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,eAAe,GAAG,OAAO,CAAC,KAAK,CAAC;IAUjF;;;;;OAKG;IACG,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAMzC;;;;;OAKG;IACG,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAQvD;;;;;OAKG;IACG,qBAAqB,CAAC,MAAM,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB5E;;;;;OAKG;IACG,IAAI,CAAC,KAAK,GAAE,WAAW,CAAC,OAAO,CAAM,GAAG,OAAO,CAAC,SAAS,KAAK,EAAE,CAAC;YAazD,YAAY;YAeZ,SAAS;YAeT,WAAW;IAczB,OAAO,CAAC,WAAW;CAGpB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;CAC7B,GACD;IAGE;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;IAE3B;;OAEG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC;CAC9B,CAAC;AAEN;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,aAAa;IAG5B;;;OAGG;IACH,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAuCD;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE;IAC7B,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,EACnB,OAAO,EAAE,cAAc,EACvB,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KACnB,OAAO,CAAC,CAAC,CAAC,CAAC;CAmBhB,CAAC;AA0KH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,UAAU,CAAC,OAAO,EAAE,KAAK,CAgB1D,CAAC"}