@spine-event-engine/storage-mysql 2.0.0-snapshot.24 → 2.0.0-snapshot.26

package/dist/mysql/agent-transaction.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent-transaction.js","sourceRoot":"","sources":["../../src/mysql/agent-transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IASb;IARnB,kBAAkB;IAElB;;;;OAIG;IACH,YACmB,WAGhB;QAHgB,gBAAW,GAAX,WAAW,CAG3B;IACA,CAAC;IAEJ;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,MAAyB,EACzB,IAAgD;QAEhD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACtE,IAAI,CAAC,aAAa;gBAChB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;YACjF,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,gBAAgB,CAC5B,UAA0B,EAC1B,MAAyB;QAEzB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,CAAC,KAAK,CACnC,4GAA4G,EAC5G,CAAC,MAAM,CAAC,CACT,CAAC;QACF,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,QAAQ,CAAC,CAC7F,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,iBAAiB,CAC7B,UAA0B,EAC1B,IAAgD;QAEhD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,gBAAgB,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;gBACtC,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC;gBAC1B,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACnD,IAAI,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACtD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACK,UAAU,CAAC,KAAc;QAC/B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACb,KAA4B,CAAC,IAAI,KAAK,kBAAkB,CAC1D,CAAC;IACJ,CAAC;CACF"}
+{"version":3,"file":"agent-transaction.js","sourceRoot":"","sources":["../../src/mysql/agent-transaction.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH;;GAEG;AACH,MAAM,OAAO,qBAAqB;IASb;IARnB,kBAAkB;IAElB;;;;OAIG;IACH,YACmB,WAGhB;QAHgB,gBAAW,GAAX,WAAW,CAG3B;IACA,CAAC;IAEJ;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,CACV,MAAyB,EACzB,IAAgD;QAEhD,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;YACtE,IAAI,CAAC,aAAa;gBAChB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;YACjF,OAAO,MAAM,IAAI,CAAC,iBAAiB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACxD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK,CAAC,MAAyB;QACnC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACpD,IAAI,CAAC;YACH,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACnF,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QACvC,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACK,KAAK,CAAC,gBAAgB,CAC5B,UAA0B,EAC1B,MAAyB;QAEzB,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,UAAU,CAAC,KAAK,CACnC,4GAA4G,EAC5G,CAAC,MAAM,CAAC,CACT,CAAC;QACF,OAAO,CACL,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE,WAAW,EAAE,KAAK,QAAQ,CAAC,CAC7F,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,iBAAiB,CAC7B,UAA0B,EAC1B,IAAgD;QAEhD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,gBAAgB,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;gBACtC,MAAM,UAAU,CAAC,MAAM,EAAE,CAAC;gBAC1B,OAAO,MAAM,CAAC;YAChB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,UAAU,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACnD,IAAI,OAAO,KAAK,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;oBAAE,SAAS;gBACtD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IAED;;;;;OAKG;IACK,UAAU,CAAC,KAAc;QAC/B,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACb,KAA4B,CAAC,IAAI,KAAK,kBAAkB,CAC1D,CAAC;IACJ,CAAC;CACF"}

package/dist/mysql/column-mapping.d.ts

@@ -14,6 +14,7 @@ export declare class MysqlColumnMapping implements ColumnMapping<unknown> {
     /**
      * Returns the conversion for one generated column type.
      *
+     * @typeParam V Protobuf column value type.
      * @param type The generated Protobuf column type.
      * @returns The JVM-compatible MySQL parameter conversion.
      */

package/dist/mysql/column-mapping.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"column-mapping.d.ts","sourceRoot":"","sources":["../../src/mysql/column-mapping.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAKrC;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa,CAAC,OAAO,CAAC;;IAG/D;;;;OAIG;gBACS,YAAY,GAAE,mBAA+C;IAMzE;;;;;OAKG;IACH,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC;IAoB/D;;;OAGG;IACH,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC;CAG3C"}
+{"version":3,"file":"column-mapping.d.ts","sourceRoot":"","sources":["../../src/mysql/column-mapping.ts"],"names":[],"mappings":"AAgBA,OAAO,EAA8B,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC3F,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AAKrC;;GAEG;AACH,qBAAa,kBAAmB,YAAW,aAAa,CAAC,OAAO,CAAC;;IAG/D;;;;OAIG;gBACS,YAAY,GAAE,mBAAgD;IAS1E;;;;;;OAMG;IACH,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC;IAoB/D;;;OAGG;IACH,MAAM,IAAI,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC;CAG3C"}

package/dist/mysql/column-mapping.js

@@ -12,7 +12,7 @@
  * the License.
  */
 import { ScalarType } from "@bufbuild/protobuf";
-import { StringifierRegistry } from "@spine-event-engine/core";
+import { defaultStringifierRegistry, StringifierRegistry } from "@spine-event-engine/core";
 const timestampType = "google.protobuf.Timestamp";
 const versionType = "spine.core.Version";
 /**
@@ -25,13 +25,17 @@ export class MysqlColumnMapping {
      *
      * @param stringifiers The schema-bound message stringifiers.
      */
-    constructor(stringifiers = new StringifierRegistry()) {
-        this.#stringifiers = new StringifierRegistry(stringifiers);
+    constructor(stringifiers = defaultStringifierRegistry) {
+        this.#stringifiers =
+            stringifiers === defaultStringifierRegistry
+                ? stringifiers
+                : new StringifierRegistry(stringifiers);
     }
     // prettier-ignore
     /**
      * Returns the conversion for one generated column type.
      *
+     * @typeParam V Protobuf column value type.
      * @param type The generated Protobuf column type.
      * @returns The JVM-compatible MySQL parameter conversion.
      */
@@ -62,6 +66,13 @@ export class MysqlColumnMapping {
     }
 }
 const MysqlMappings = Object.freeze({
+    /**
+     * Maps a scalar column to a MySQL parameter.
+     *
+     * @typeParam V Scalar value type.
+     * @param type Protobuf scalar kind.
+     * @returns The scalar conversion.
+     */
     scalar(type) {
         switch (type) {
             case ScalarType.STRING:
@@ -83,10 +94,22 @@ const MysqlMappings = Object.freeze({
                 throw new Error("Spine JVM JDBC does not support floating-point record columns.");
         }
     },
+    /**
+     * Converts a timestamp to epoch nanoseconds.
+     *
+     * @param value Protobuf timestamp value.
+     * @returns Epoch nanoseconds.
+     */
     timestamp(value) {
         const timestamp = value;
         return timestamp.seconds * 1000000000n + BigInt(timestamp.nanos);
     },
+    /**
+     * Converts a version to its integer number.
+     *
+     * @param value Protobuf version value.
+     * @returns Version number.
+     */
     version(value) {
         return value.number;
     },

package/dist/mysql/column-mapping.js.map

@@ -1 +1 @@
-{"version":3,"file":"column-mapping.js","sourceRoot":"","sources":["../../src/mysql/column-mapping.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAgB,MAAM,oBAAoB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAO/D,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAClD,MAAM,WAAW,GAAG,oBAAoB,CAAC;AAEzC;;GAEG;AACH,MAAM,OAAO,kBAAkB;IACpB,aAAa,CAAsB;IAE5C;;;;OAIG;IACH,YAAY,eAAoC,IAAI,mBAAmB,EAAE;QACvE,IAAI,CAAC,aAAa,GAAG,IAAI,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC7D,CAAC;IAED,kBAAkB;IAElB;;;;;OAKG;IACH,EAAE,CAAI,IAAyB;QAC7B,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,QAAQ;gBACX,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3C,KAAK,MAAM;gBACT,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;YAC1B,KAAK,SAAS;gBACZ,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,aAAa,EAAE,CAAC;oBAC5C,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBACnD,CAAC;gBACD,IAAI,IAAI,CAAC,OAAO,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;oBAC1C,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;gBACjD,CAAC;gBACD,OAAO,CAAC,KAAK,EAAE,EAAE,CACf,IAAI,CAAC,aAAa;qBACf,UAAU,CAAC,IAAI,CAAC,OAA8B,CAAC;qBAC/C,QAAQ,CAAC,KAAgB,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;IAC1B,CAAC;CACF;AAED,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,CAAI,IAAgB;QACxB,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,UAAU,CAAC,MAAM,CAAC;YACvB,KAAK,UAAU,CAAC,KAAK,CAAC;YACtB,KAAK,UAAU,CAAC,MAAM,CAAC;YACvB,KAAK,UAAU,CAAC,QAAQ,CAAC;YACzB,KAAK,UAAU,CAAC,MAAM,CAAC;YACvB,KAAK,UAAU,CAAC,OAAO,CAAC;YACxB,KAAK,UAAU,CAAC,KAAK,CAAC;YACtB,KAAK,UAAU,CAAC,MAAM,CAAC;YACvB,KAAK,UAAU,CAAC,QAAQ,CAAC;YACzB,KAAK,UAAU,CAAC,MAAM,CAAC;YACvB,KAAK,UAAU,CAAC,OAAO,CAAC;YACxB,KAAK,UAAU,CAAC,IAAI,CAAC;YACrB,KAAK,UAAU,CAAC,KAAK;gBACnB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC;YAC1B,KAAK,UAAU,CAAC,KAAK,CAAC;YACtB,KAAK,UAAU,CAAC,MAAM;gBACpB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAED,SAAS,CAAC,KAAc;QACtB,MAAM,SAAS,GAAG,KAA6D,CAAC;QAChF,OAAO,SAAS,CAAC,OAAO,GAAG,WAAc,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,CAAC,KAAc;QACpB,OAAQ,KAAqC,CAAC,MAAM,CAAC;IACvD,CAAC;CACF,CAAC,CAAC"}
+{"version":3,"file":"column-mapping.js","sourceRoot":"","sources":["../../src/mysql/column-mapping.ts"],"names":[],"mappings":"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"}

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

@@ -3,11 +3,9 @@ import type { Event } from "@spine-event-engine/proto";
 import type { EntityRecord } from "@spine-event-engine/proto/generated/spine/server/entity/entity_pb.js";
 import { RecordSpec } from "@spine-event-engine/storage";
 import { type EntityEventHistoryPort, type EntityRecordStorage, type EntityStateHistoryPort, type EntityStorageInput } from "@spine-event-engine/storage/provider";
-import { MysqlRecordStorage } from "./record-storage.js";
+import { MysqlRecordStorage, type OnPublicOperation } from "./record-storage.js";
 /**
-
  * Opens one MySQL record family for Entity storage.
-
  */
 interface OpenRecords {
     /**
@@ -59,7 +57,10 @@ export interface MysqlEntityStorageHandle<I, S extends Message> {
  */
 export declare class MysqlEntityStorage<I, S extends Message> implements MysqlEntityStorageHandle<I, S> {
     #private;
+    private readonly input;
+    private readonly open;
     private readonly onClose;
+    private readonly onAdmit;
     /**
      * Exposes current Entity records.
      */
@@ -67,19 +68,28 @@ export declare class MysqlEntityStorage<I, S extends Message> implements MysqlEn
     /**
      * Exposes Entity state history records.
      */
-    readonly states: EntityStateHistoryPort<I, S>;
+    states: EntityStateHistoryPort<I, S>;
     /**
      * Exposes Entity event history records.
      */
-    readonly events: EntityEventHistoryPort<I>;
+    events: EntityEventHistoryPort<I>;
     /**
      * Creates MySQL-backed Entity storage handles.
      *
      * @param input Configures the Entity storage families.
      * @param open Opens one record-family storage handle.
      * @param onClose Removes this Entity handle from its factory.
+     * @param lazy Whether optional families are acquired on first use.
+     * @param onAdmit Admits complete public Entity operations.
+     */
+    constructor(input: EntityStorageInput<I, S>, open: OpenRecords, onClose?: () => void, lazy?: boolean, onAdmit?: OnPublicOperation);
+    /**
+     * Acquires only missing requested history families, rolling back a failed upgrade.
+     *
+     * @param wantEvents Whether diagnostic Event history is required.
+     * @param wantStates Whether state history is required.
      */
-    constructor(input: EntityStorageInput<I, S>, open: OpenRecords, onClose?: () => void);
+    ensure(wantStates: boolean, wantEvents: boolean): void;
     /**
      * Returns whether this Entity storage handle accepts operations.
      *
@@ -118,6 +128,13 @@ export declare class MysqlEntityStorage<I, S extends Message> implements MysqlEn
      * @returns Current record when present.
      */
     readCurrentLocked(id: I): Promise<EntityRecord | undefined>;
+    /**
+     * Writes current state inside an already admitted Agent transaction.
+     *
+     * @param record Committed current Entity state.
+     * @returns Completion after the record write.
+     */
+    writeCurrentAdmitted(record: EntityRecord): Promise<void>;
     /**
      * Returns configured Entity history writers for the Agent transaction.
      *

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

@@ -1 +1 @@
-{"version":3,"file":"entity-history.d.ts","sourceRoot":"","sources":["../../src/mysql/entity-history.ts"],"names":[],"mappings":"AAcA,OAAO,EAAsB,KAAK,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEtE,OAAO,KAAK,EAAE,KAAK,EAAW,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sEAAsE,CAAC;AAKzG,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AACzD,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACxB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;;GAIG;AACH,UAAU,WAAW;IACnB;;;;;;;;OAQG;IAEH,CAAC,EAAE,EAAE,CAAC,SAAS,OAAO,EACpB,IAAI,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EACvB,KAAK,CAAC,EAAE,OAAO,6BAA6B,EAAE,YAAY,GACzD,kBAAkB,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;CAC9B;AAED;;;;;GAKG;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;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC;IAElB;;OAEG;IACH,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;GAKG;AACH,qBAAa,kBAAkB,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,CAAE,YAAW,wBAAwB,CAAC,CAAC,EAAE,CAAC,CAAC;;IAwD3F,OAAO,CAAC,QAAQ,CAAC,OAAO;IArD1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAuBzC;;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;IAS3C;;;;;;OAMG;gBAED,KAAK,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,EAC/B,IAAI,EAAE,WAAW,EACA,OAAO,GAAE,MAAM,IAAsB;IAcxD;;;;OAIG;IACH,MAAM,IAAI,OAAO;IAIjB;;OAEG;IACH,KAAK,IAAI,IAAI;IASb;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B;;;;OAIG;IACH,UAAU,IAAI,SAAS,MAAM,EAAE;IAQ/B;;;;;;;OAOG;IACH,cAAc,CAAC,CAAC,EACd,UAAU,EAAE,OAAO,gBAAgB,EAAE,cAAc,EACnD,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,CAAC,CAAC;IAYb;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAI3D;;;;OAIG;IACH,gBAAgB,IAAI;QAClB,oBAAoB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1D,yBAAyB,CAAC,MAAM,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KACzD;CAQF"}
+{"version":3,"file":"entity-history.d.ts","sourceRoot":"","sources":["../../src/mysql/entity-history.ts"],"names":[],"mappings":"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"}

package/dist/mysql/entity-history.js

@@ -11,7 +11,8 @@
  * or implied. See the License for the specific language governing permissions and limitations under
  * the License.
  */
-import { create, fromBinary } from "@bufbuild/protobuf";
+import { create } from "@bufbuild/protobuf";
+import { AnyPacker } from "@spine-event-engine/core";
 import { EntityStateKeySchema, } from "@spine-event-engine/proto/generated/spine/server/entity/state_key_pb.js";
 import { RecordSpec } from "@spine-event-engine/storage";
 import { eventHistorySpec, stateHistorySpec, } from "@spine-event-engine/storage/provider";
@@ -23,28 +24,25 @@ import { MysqlRecordStorage } from "./record-storage.js";
  * @typeParam S Entity state message type.
  */
 export class MysqlEntityStorage {
+    input;
+    open;
     onClose;
+    onAdmit;
     // prettier-ignore
     /**
      * Exposes current Entity records.
      */
     current;
     /**
-  
      * Current record-family handle.
-  
      */
     #current;
     /**
-  
      * Optional state-history handle.
-  
      */
     #states;
     /**
-  
      * Optional diagnostic-history handle.
-  
      */
     #events;
     /**
@@ -56,9 +54,7 @@ export class MysqlEntityStorage {
      */
     events;
     /**
-  
      * Whether this Entity storage accepts operations.
-  
      */
     #open = true;
     /**
@@ -67,19 +63,60 @@ export class MysqlEntityStorage {
      * @param input Configures the Entity storage families.
      * @param open Opens one record-family storage handle.
      * @param onClose Removes this Entity handle from its factory.
+     * @param lazy Whether optional families are acquired on first use.
+     * @param onAdmit Admits complete public Entity operations.
      */
-    constructor(input, open, onClose = () => undefined) {
+    constructor(input, open, onClose = () => undefined, lazy = false, onAdmit = (work) => work()) {
+        this.input = input;
+        this.open = open;
         this.onClose = onClose;
-        this.#current = new CurrentStorage(input, open(input.recordSpec));
+        this.onAdmit = onAdmit;
+        this.#current = new CurrentStorage(input, open(input.recordSpec), onAdmit);
         this.current = this.#current;
-        const states = input.stateHistory ? stateHistorySpec(input.stateSchema) : undefined;
-        const events = input.eventHistory ? eventHistorySpec(input.stateSchema) : undefined;
-        this.#states =
-            states === undefined ? undefined : new States(input, open(states.spec, states.group));
-        this.#events =
-            events === undefined ? undefined : new Events(input, open(events.spec, events.group));
-        this.states = this.#states ?? disabledStates();
-        this.events = this.#events ?? disabledEvents();
+        this.states = disabledStates(onAdmit);
+        this.events = disabledEvents(onAdmit);
+        if (!lazy)
+            this.ensure(Boolean(input.stateHistory), Boolean(input.eventHistory));
+    }
+    /**
+     * Acquires only missing requested history families, rolling back a failed upgrade.
+     *
+     * @param wantEvents Whether diagnostic Event history is required.
+     * @param wantStates Whether state history is required.
+     */
+    ensure(wantStates, wantEvents) {
+        if (!this.#open)
+            throw new Error("MySQL Entity storage is closed.");
+        let states;
+        let events;
+        try {
+            if (wantStates && this.#states === undefined) {
+                const layout = stateHistorySpec(this.input.stateSchema);
+                states = new States(this.input, this.open(layout.spec, layout.group), this.onAdmit);
+            }
+            if (wantEvents && this.#events === undefined) {
+                const layout = eventHistorySpec(this.input.stateSchema);
+                events = new Events(this.input, this.open(layout.spec, layout.group), this.onAdmit);
+            }
+            this.#states ??= states;
+            this.#events ??= events;
+            this.states = this.#states ?? disabledStates(this.onAdmit);
+            this.events = this.#events ?? disabledEvents(this.onAdmit);
+        }
+        catch (error) {
+            const failures = [];
+            for (const port of [states, events]) {
+                try {
+                    port?.close();
+                }
+                catch (cleanup) {
+                    failures.push(cleanup);
+                }
+            }
+            if (failures.length)
+                throw new AggregateError([error, ...failures], "MySQL family acquisition failed.");
+            throw error;
+        }
     }
     /**
      * Returns whether this Entity storage handle accepts operations.
@@ -96,10 +133,25 @@ export class MysqlEntityStorage {
         if (!this.#open)
             return;
         this.#open = false;
-        this.#current.close();
-        this.states.close();
-        this.events.close();
-        this.onClose();
+        const failures = [];
+        for (const port of [this.#current, this.#states, this.#events]) {
+            try {
+                port?.close();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+        }
+        try {
+            this.onClose();
+        }
+        catch (error) {
+            failures.push(error);
+        }
+        if (failures.length === 1)
+            throw failures[0];
+        if (failures.length)
+            throw new AggregateError(failures, "MySQL Entity storage close failed.");
     }
     /**
      * Prepares every Entity record-family table.
@@ -147,6 +199,15 @@ export class MysqlEntityStorage {
     readCurrentLocked(id) {
         return this.#current.readLocked(id);
     }
+    /**
+     * Writes current state inside an already admitted Agent transaction.
+     *
+     * @param record Committed current Entity state.
+     * @returns Completion after the record write.
+     */
+    writeCurrentAdmitted(record) {
+        return this.#current.writeAdmitted(record);
+    }
     /**
      * Returns configured Entity history writers for the Agent transaction.
      *
@@ -154,8 +215,8 @@ export class MysqlEntityStorage {
      */
     commitCapability() {
         return {
-            appendStateImmutable: (record) => this.#states?.append(record) ?? Promise.resolve(),
-            appendDiagnosticImmutable: (record) => this.#events?.append(record) ?? Promise.resolve(),
+            appendStateImmutable: (record) => this.#states?.appendAdmitted(record) ?? Promise.resolve(),
+            appendDiagnosticImmutable: (record) => this.#events?.appendAdmitted(record) ?? Promise.resolve(),
         };
     }
 }
@@ -168,15 +229,18 @@ export class MysqlEntityStorage {
 class CurrentStorage {
     input;
     records;
+    onAdmit;
     /**
      * Connects the Entity layout to its current-record handle.
      *
      * @param input Defines the Entity layout.
      * @param records Stores current Entity records.
+     * @param onAdmit Admits complete public current operations.
      */
-    constructor(input, records) {
+    constructor(input, records, onAdmit) {
         this.input = input;
         this.records = records;
+        this.onAdmit = onAdmit;
     }
     /**
      * Returns the current-record table name.
@@ -213,7 +277,7 @@ class CurrentStorage {
      * @returns The current record when present.
      */
     read(id) {
-        return this.records.read(id);
+        return this.onAdmit(() => this.records.read(id));
     }
     /**
      * Writes the current Entity record.
@@ -222,6 +286,15 @@ class CurrentStorage {
      * @returns Completion after the write.
      */
     write(record) {
+        return this.onAdmit(() => this.writeAdmitted(record));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param record Current Entity record.
+     * @returns Stored result.
+     */
+    writeAdmitted(record) {
         return this.records.write(record);
     }
     /**
@@ -231,6 +304,15 @@ class CurrentStorage {
      * @returns Matching records and mapped column values.
      */
     async query(plan) {
+        return this.onAdmit(() => this.queryAdmitted(plan));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param plan Normalized query.
+     * @returns Current records and columns.
+     */
+    async queryAdmitted(plan) {
         const entries = await this.records.queryPlanEntries(plan);
         return entries.map((entry) => {
             if (entry.record.entityId === undefined)
@@ -254,9 +336,7 @@ class CurrentStorage {
         return this.records.prepare();
     }
     /**
-  
      * Closes the current record handle.
-  
      */
     close() {
         this.records.close();
@@ -271,15 +351,18 @@ class CurrentStorage {
 class States {
     input;
     records;
+    onAdmit;
     /**
      * Connects the Entity layout to its state-history handle.
      *
      * @param input Defines the Entity ID and state schemas.
      * @param records Stores immutable state-history records.
+     * @param onAdmit Admits complete public state-history operations.
      */
-    constructor(input, records) {
+    constructor(input, records, onAdmit) {
         this.input = input;
         this.records = records;
+        this.onAdmit = onAdmit;
     }
     /**
      * Returns the state-history table name.
@@ -307,6 +390,15 @@ class States {
      * @returns Completion after insertion or identical retry.
      */
     append(record) {
+        return this.onAdmit(() => this.appendAdmitted(record));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param record Immutable state record.
+     * @returns Stored result.
+     */
+    appendAdmitted(record) {
         return this.records.writeImmutable(record);
     }
     /**
@@ -318,6 +410,17 @@ class States {
      * @returns Matching states in descending version order.
      */
     async backward(id, depth, startingFromVersion) {
+        return this.onAdmit(() => this.backwardAdmitted(id, depth, startingFromVersion));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param id Entity ID.
+     * @param depth Read limit.
+     * @param startingFromVersion Maximum version.
+     * @returns Retained states in reverse order.
+     */
+    async backwardAdmitted(id, depth, startingFromVersion) {
         const all = await this.records.query({ sort: [{ field: "version", direction: "desc" }] });
         return all
             .filter((record) => record.entityId !== undefined &&
@@ -334,7 +437,17 @@ class States {
      * @returns Decoded state when present.
      */
     async stateAt(id, time) {
-        const records = await this.backward(id, Number.MAX_SAFE_INTEGER);
+        return this.onAdmit(() => this.stateAtAdmitted(id, time));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param id Entity ID.
+     * @param time Inclusive timestamp.
+     * @returns State at the requested time.
+     */
+    async stateAtAdmitted(id, time) {
+        const records = await this.backwardAdmitted(id, Number.MAX_SAFE_INTEGER);
         const found = records.find((record) => {
             const timestamp = record.version?.timestamp;
             return (timestamp !== undefined &&
@@ -343,7 +456,7 @@ class States {
         });
         return found?.state === undefined
             ? undefined
-            : fromBinary(this.input.stateSchema, found.state.value);
+            : AnyPacker.unpack(found.state, this.input.stateSchema);
     }
     /**
      * Removes older states beyond the requested retained count.
@@ -353,7 +466,17 @@ class States {
      * @returns Completion after independent deletions.
      */
     async trim(id, keep) {
-        const records = await this.backward(id, Number.MAX_SAFE_INTEGER);
+        return this.onAdmit(() => this.trimAdmitted(id, keep));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param id Entity ID.
+     * @param keep Retained count.
+     * @returns Completion after older states are removed.
+     */
+    async trimAdmitted(id, keep) {
+        const records = await this.backwardAdmitted(id, Number.MAX_SAFE_INTEGER);
         for (const record of records.slice(keep)) {
             if (record.entityId !== undefined)
                 await this.records.delete(create(EntityStateKeySchema, {
@@ -369,6 +492,15 @@ class States {
      * @returns Completion after independent deletions.
      */
     async truncate(olderThan) {
+        return this.onAdmit(() => this.truncateAdmitted(olderThan));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param olderThan Exclusive cutoff.
+     * @returns Completion after truncation.
+     */
+    async truncateAdmitted(olderThan) {
         const all = await this.records.query();
         for (const record of all) {
             const timestamp = record.version?.timestamp;
@@ -383,9 +515,7 @@ class States {
         }
     }
     /**
-  
      * Closes the state-history handle.
-  
      */
     close() {
         this.records.close();
@@ -408,15 +538,18 @@ class States {
 class Events {
     input;
     records;
+    onAdmit;
     /**
      * Connects the Entity layout to its diagnostic-history handle.
      *
      * @param input Defines the Entity ID and state schemas.
      * @param records Stores immutable diagnostic Events.
+     * @param onAdmit Admits complete public Event-history operations.
      */
-    constructor(input, records) {
+    constructor(input, records, onAdmit) {
         this.input = input;
         this.records = records;
+        this.onAdmit = onAdmit;
     }
     /**
      * Returns the diagnostic Event-history table name.
@@ -444,6 +577,15 @@ class Events {
      * @returns Completion after insertion or identical retry.
      */
     append(record) {
+        return this.onAdmit(() => this.appendAdmitted(record));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param record Immutable diagnostic Event.
+     * @returns Stored result.
+     */
+    appendAdmitted(record) {
         return this.records.writeImmutable(record);
     }
     /**
@@ -455,6 +597,17 @@ class Events {
      * @returns Matching Events in descending version order.
      */
     async backward(id, depth, startingFromVersion) {
+        return this.onAdmit(() => this.backwardAdmitted(id, depth, startingFromVersion));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param id Producer ID.
+     * @param depth Read limit.
+     * @param startingFromVersion Maximum version.
+     * @returns Diagnostic Events in reverse order.
+     */
+    async backwardAdmitted(id, depth, startingFromVersion) {
         const all = await this.records.query({ sort: [{ field: "version", direction: "desc" }] });
         return all
             .filter((event) => event.context?.producerId !== undefined &&
@@ -470,6 +623,15 @@ class Events {
      * @returns Completion after independent deletions.
      */
     async truncate(olderThan) {
+        return this.onAdmit(() => this.truncateAdmitted(olderThan));
+    }
+    /**
+     * Executes an admitted provider operation.
+     *
+     * @param olderThan Exclusive cutoff.
+     * @returns Completion after truncation.
+     */
+    async truncateAdmitted(olderThan) {
         const all = await this.records.query();
         for (const event of all) {
             const timestamp = event.context?.timestamp;
@@ -481,9 +643,7 @@ class Events {
         }
     }
     /**
-  
      * Closes the diagnostic-history handle.
-  
      */
     close() {
         this.records.close();
@@ -502,15 +662,16 @@ class Events {
  *
  * @typeParam I Entity identifier type.
  * @typeParam S Entity state message type.
+ * @param onAdmit Admits public calls even when history is disabled.
  * @returns A disabled state-history port.
  */
-function disabledStates() {
+function disabledStates(onAdmit) {
     return {
-        append: () => Promise.reject(new Error("Entity state history is disabled.")),
-        backward: () => Promise.resolve([]),
-        stateAt: () => Promise.resolve(undefined),
-        trim: () => Promise.resolve(),
-        truncate: () => Promise.resolve(),
+        append: () => onAdmit(() => Promise.reject(new Error("Entity state history is disabled."))),
+        backward: () => onAdmit(() => Promise.resolve([])),
+        stateAt: () => onAdmit(() => Promise.resolve(undefined)),
+        trim: () => onAdmit(() => Promise.resolve()),
+        truncate: () => onAdmit(() => Promise.resolve()),
         close: () => undefined,
     };
 }
@@ -518,13 +679,14 @@ function disabledStates() {
  * Creates a rejecting diagnostic-history port when retention is disabled.
  *
  * @typeParam I Entity identifier type.
+ * @param onAdmit Admits public calls even when history is disabled.
  * @returns A disabled diagnostic-history port.
  */
-function disabledEvents() {
+function disabledEvents(onAdmit) {
     return {
-        append: () => Promise.reject(new Error("Entity event history is disabled.")),
-        backward: () => Promise.resolve([]),
-        truncate: () => Promise.resolve(),
+        append: () => onAdmit(() => Promise.reject(new Error("Entity event history is disabled."))),
+        backward: () => onAdmit(() => Promise.resolve([])),
+        truncate: () => onAdmit(() => Promise.resolve()),
         close: () => undefined,
     };
 }