@spine-event-engine/storage-datastore 2.0.0-snapshot.22 → 2.0.0-snapshot.24

package/index.yaml

@@ -1 +1,24 @@
-indexes: []
+indexes:
+  - kind: spine_agent_history
+    properties:
+      - name: scope_digest
+      - name: order_key
+  - kind: spine_agent_history
+    properties:
+      - name: scope_digest
+      - name: category
+      - name: order_key
+  - kind: spine_agent_history
+    properties:
+      - name: scope_digest
+      - name: conversation_digest
+      - name: order_key
+  - kind: spine_agent_execution_head
+    properties:
+      - name: state_digest
+      - name: pending_key
+  - kind: spine_agent_execution
+    properties:
+      - name: scope_digest
+      - name: status
+      - name: order_key

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spine-event-engine/storage-datastore",
-  "version": "2.0.0-snapshot.22",
+  "version": "2.0.0-snapshot.24",
   "license": "Apache-2.0",
   "type": "module",
   "repository": {
@@ -28,13 +28,13 @@
   "dependencies": {
     "@bufbuild/protobuf": "2.12.1",
     "@google-cloud/datastore": "10.1.1",
-    "@spine-event-engine/core": "2.0.0-snapshot.22",
-    "@spine-event-engine/proto": "2.0.0-snapshot.22",
-    "@spine-event-engine/storage": "2.0.0-snapshot.22"
+    "@spine-event-engine/core": "2.0.0-snapshot.24",
+    "@spine-event-engine/proto": "2.0.0-snapshot.24",
+    "@spine-event-engine/storage": "2.0.0-snapshot.24"
   },
   "scripts": {
     "inventory:legacy": "node scripts/inventory-legacy-layout.mjs",
-    "test:emulator": "node scripts/verify-emulator-config.mjs && SPINE_TS_INBOX_PROVIDER=datastore pnpm --config.verify-deps-before-run=false exec vitest --root ../.. --config vitest.infrastructure.config.ts run packages/storage-datastore/test/datastore-emulator.test.ts packages/server/test/delivery/inbox-provider-cleanup.test.ts",
+    "test:emulator": "node scripts/verify-emulator-config.mjs && SPINE_TS_INBOX_PROVIDER=datastore pnpm --config.verify-deps-before-run=false exec vitest --root ../.. --config vitest.infrastructure.config.ts run packages/storage-datastore/test/datastore-emulator.test.ts packages/storage-datastore/test/datastore-agent-history.test.ts packages/storage-datastore/test/datastore-agent-execution.test.ts packages/server/test/delivery/inbox-provider-cleanup.test.ts",
     "test:cloud": "node scripts/verify-cloud-config.mjs && pnpm --config.verify-deps-before-run=false exec vitest --root ../.. --config vitest.infrastructure.config.ts run packages/storage-datastore/test/datastore-cloud.test.ts"
   }
 }

package/dist/datastore/delivery-cleanup.d.ts

@@ -1,31 +0,0 @@
-import type { Message } from "@bufbuild/protobuf";
-import { type DeliveryCleanupInput, type DeliveryCleanupStorage } from "@spine-event-engine/storage/provider";
-import type { RecordSpec, StorageContext } from "@spine-event-engine/storage";
-import { DatastoreRecordStorage } from "./record-storage.js";
-/**
- * Coordinates one fenced delivered Inbox deletion in Datastore.
- */
-export declare class DatastoreDeliveryCleanupStorage implements DeliveryCleanupStorage {
-    #private;
-    private readonly openStorage;
-    /**
-     * Creates a Datastore cleanup coordinator.
-     *
-     * @param openStorage Opens a record-storage handle for one record family.
-     */
-    constructor(openStorage: <I, R extends Message>(context: StorageContext, spec: RecordSpec<I, R>) => DatastoreRecordStorage<I, R>);
-    /**
-     * Removes an exact Inbox entity after validating its session entity in one transaction.
-     *
-     * @param input Describes the records and ownership predicate for deletion.
-     * @returns Whether the transaction deleted the exact Inbox entity.
-     */
-    remove<InboxId, InboxRecord extends Message, SessionId, SessionRecord extends Message>(input: DeliveryCleanupInput<InboxId, InboxRecord, SessionId, SessionRecord>): Promise<boolean>;
-    /**
-     * Closes this cleanup coordinator to further removal operations.
-     */
-    close(): void;
-    private static first;
-    private static active;
-}
-//# sourceMappingURL=delivery-cleanup.d.ts.map

package/dist/datastore/delivery-cleanup.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"delivery-cleanup.d.ts","sourceRoot":"","sources":["../../src/datastore/delivery-cleanup.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,sBAAsB,EAC5B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE9E,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;GAEG;AACH,qBAAa,+BAAgC,YAAW,sBAAsB;;IAS1E,OAAO,CAAC,QAAQ,CAAC,WAAW;IAN9B;;;;OAIG;gBAEgB,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,SAAS,OAAO,EACjD,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,KACnB,sBAAsB,CAAC,CAAC,EAAE,CAAC,CAAC;IAGnC;;;;;OAKG;IACG,MAAM,CAAC,OAAO,EAAE,WAAW,SAAS,OAAO,EAAE,SAAS,EAAE,aAAa,SAAS,OAAO,EACzF,KAAK,EAAE,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,GAC1E,OAAO,CAAC,OAAO,CAAC;IA8DnB;;OAEG;IACH,KAAK,IAAI,IAAI;IAGb,OAAO,CAAC,MAAM,CAAC,KAAK;IAQpB,OAAO,CAAC,MAAM,CAAC,MAAM;CAGtB"}

package/dist/datastore/delivery-cleanup.js

@@ -1,111 +0,0 @@
-/*
- * 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 { cleanupOperationActive, } from "@spine-event-engine/storage/provider";
-import { DatastoreRecordStorage } from "./record-storage.js";
-/**
- * Coordinates one fenced delivered Inbox deletion in Datastore.
- */
-export class DatastoreDeliveryCleanupStorage {
-    openStorage;
-    #open = true;
-    /**
-     * Creates a Datastore cleanup coordinator.
-     *
-     * @param openStorage Opens a record-storage handle for one record family.
-     */
-    constructor(openStorage) {
-        this.openStorage = openStorage;
-    }
-    /**
-     * Removes an exact Inbox entity after validating its session entity in one transaction.
-     *
-     * @param input Describes the records and ownership predicate for deletion.
-     * @returns Whether the transaction deleted the exact Inbox entity.
-     */
-    async remove(input) {
-        if (!this.#open)
-            throw new Error("Delivery cleanup storage is closed.");
-        if (!DatastoreDeliveryCleanupStorage.active(input))
-            return false;
-        const inbox = this.openStorage(input.context, input.inbox.spec);
-        const sessions = this.openStorage(input.context, input.session.spec);
-        const transaction = sessions.transaction();
-        try {
-            await transaction.run();
-            const sessionEntity = DatastoreDeliveryCleanupStorage.first(await transaction.get(sessions.transactionEntity(input.session.expected).key));
-            if (!DatastoreDeliveryCleanupStorage.active(input)) {
-                await transaction.rollback();
-                return false;
-            }
-            if (sessionEntity === undefined ||
-                !sessions.matchesTransactionEntity(sessionEntity, input.session.expected) ||
-                !input.session.isCurrent(sessions.decodeTransactionEntity(sessionEntity))) {
-                await transaction.rollback();
-                return false;
-            }
-            const expectedInbox = inbox.transactionEntity(input.inbox.expected);
-            const inboxEntity = DatastoreDeliveryCleanupStorage.first(await transaction.get(expectedInbox.key));
-            if (inboxEntity === undefined ||
-                !inbox.matchesTransactionEntity(inboxEntity, input.inbox.expected)) {
-                await transaction.rollback();
-                return false;
-            }
-            if (!input.session.isCurrent(sessions.decodeTransactionEntity(sessionEntity))) {
-                await transaction.rollback();
-                return false;
-            }
-            if (!DatastoreDeliveryCleanupStorage.active(input)) {
-                await transaction.rollback();
-                return false;
-            }
-            transaction.delete(expectedInbox.key);
-            if (!input.session.isCurrent(sessions.decodeTransactionEntity(sessionEntity))) {
-                await transaction.rollback();
-                return false;
-            }
-            if (!DatastoreDeliveryCleanupStorage.active(input)) {
-                await transaction.rollback();
-                return false;
-            }
-            await transaction.commit();
-            return true;
-        }
-        catch (error) {
-            await transaction.rollback().catch(() => undefined);
-            throw error;
-        }
-        finally {
-            inbox.close();
-            sessions.close();
-        }
-    }
-    /**
-     * Closes this cleanup coordinator to further removal operations.
-     */
-    close() {
-        this.#open = false;
-    }
-    static first(value) {
-        return Array.isArray(value) &&
-            value.length > 0 &&
-            typeof value[0] === "object" &&
-            value[0] !== null
-            ? value[0]
-            : undefined;
-    }
-    static active(input) {
-        return cleanupOperationActive(input.operation);
-    }
-}
-//# sourceMappingURL=delivery-cleanup.js.map

package/dist/datastore/delivery-cleanup.js.map

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