@causa/runtime-google 1.2.0 → 1.3.0

package/dist/spanner/index.d.ts

@@ -1,7 +1,7 @@
 export { SpannerColumn } from './column.decorator.js';
-export { SPANNER_SESSION_POOL_OPTIONS_FOR_CLOUD_FUNCTIONS, SPANNER_SESSION_POOL_OPTIONS_FOR_SERVICE, catchSpannerDatabaseErrors, getDefaultSpannerDatabaseForCloudFunction, } from './database.js';
+export { catchSpannerDatabaseErrors, getDefaultSpannerDatabaseForCloudFunction, SPANNER_SESSION_POOL_OPTIONS_FOR_CLOUD_FUNCTIONS, SPANNER_SESSION_POOL_OPTIONS_FOR_SERVICE, } from './database.js';
 export { SpannerEntityManager } from './entity-manager.js';
-export type { SpannerKey, SpannerReadOnlyTransaction, SpannerReadWriteTransaction, } from './entity-manager.js';
+export type { SpannerKey, SpannerReadOnlyTransaction, SpannerReadWriteTransaction, SqlStatement, } from './entity-manager.js';
 export * from './errors.js';
 export { SpannerHealthIndicator } from './healthcheck.js';
 export { SpannerModule } from './module.js';

package/dist/spanner/index.js

@@ -1,5 +1,5 @@
 export { SpannerColumn } from './column.decorator.js';
-export { SPANNER_SESSION_POOL_OPTIONS_FOR_CLOUD_FUNCTIONS, SPANNER_SESSION_POOL_OPTIONS_FOR_SERVICE, catchSpannerDatabaseErrors, getDefaultSpannerDatabaseForCloudFunction, } from './database.js';
+export { catchSpannerDatabaseErrors, getDefaultSpannerDatabaseForCloudFunction, SPANNER_SESSION_POOL_OPTIONS_FOR_CLOUD_FUNCTIONS, SPANNER_SESSION_POOL_OPTIONS_FOR_SERVICE, } from './database.js';
 export { SpannerEntityManager } from './entity-manager.js';
 export * from './errors.js';
 export { SpannerHealthIndicator } from './healthcheck.js';

package/dist/transaction/firestore-pubsub/readonly-state-transaction.d.ts

@@ -1,11 +1,21 @@
 import type { ReadOnlyStateTransaction, ReadOnlyTransactionOption } from '@causa/runtime';
 import type { Type } from '@nestjs/common';
 import { Transaction } from 'firebase-admin/firestore';
+import { type SoftDeletedFirestoreCollectionMetadata } from './soft-deleted-collection.decorator.js';
 import type { FirestoreCollectionResolver } from './types.js';
 /**
  * Option for a function that accepts a {@link FirestoreReadOnlyStateTransaction}.
  */
 export type FirestoreReadOnlyStateTransactionOption = ReadOnlyTransactionOption<FirestoreReadOnlyStateTransaction>;
+/**
+ * Information about soft-deletion for a given document.
+ */
+export type SoftDeleteInfo<T extends object> = Omit<SoftDeletedFirestoreCollectionMetadata, 'deletedDocumentsCollectionSuffix'> & {
+    /**
+     * The reference to the soft-deleted document.
+     */
+    ref: FirebaseFirestore.DocumentReference<T>;
+};
 /**
  * A {@link ReadOnlyStateTransaction} that uses Firestore for state storage.
  *
@@ -33,5 +43,14 @@ export declare class FirestoreReadOnlyStateTransaction implements ReadOnlyStateT
      * The resolver that provides the Firestore collections for a given document type.
      */
     collectionResolver: FirestoreCollectionResolver);
+    /**
+     * Returns the soft-delete information for a given document, if the document type supports soft-deletion.
+     *
+     * @param activeDocRef The reference to the active document.
+     * @param type The type of the document.
+     * @returns The soft-delete information for the document, or `null` if the document type does not support
+     *   soft-deletion.
+     */
+    protected getSoftDeleteInfo<T extends object>(activeDocRef: FirebaseFirestore.DocumentReference<T>, type: Type<T>): SoftDeleteInfo<T> | null;
     get<T extends object>(type: Type<T>, entity: Partial<T>): Promise<T | null>;
 }

package/dist/transaction/firestore-pubsub/readonly-state-transaction.js

@@ -1,5 +1,6 @@
 import { Transaction } from 'firebase-admin/firestore';
-import { getReferenceForFirestoreDocument } from '../../firestore/index.js';
+import { getReferenceForFirestoreDocument, makeFirestoreDataConverter, } from '../../firestore/index.js';
+import { getSoftDeletedFirestoreCollectionMetadataForType, } from './soft-deleted-collection.decorator.js';
 /**
  * A {@link ReadOnlyStateTransaction} that uses Firestore for state storage.
  *
@@ -24,24 +25,44 @@ export class FirestoreReadOnlyStateTransaction {
         this.firestoreTransaction = firestoreTransaction;
         this.collectionResolver = collectionResolver;
     }
+    /**
+     * Returns the soft-delete information for a given document, if the document type supports soft-deletion.
+     *
+     * @param activeDocRef The reference to the active document.
+     * @param type The type of the document.
+     * @returns The soft-delete information for the document, or `null` if the document type does not support
+     *   soft-deletion.
+     */
+    getSoftDeleteInfo(activeDocRef, type) {
+        const softDeleteMetadata = getSoftDeletedFirestoreCollectionMetadataForType(type);
+        if (!softDeleteMetadata) {
+            return null;
+        }
+        const { deletedDocumentsCollectionSuffix: suffix, ...info } = softDeleteMetadata;
+        const softDeleteCollection = activeDocRef.firestore
+            .collection(`${activeDocRef.parent.path}${suffix}`)
+            .withConverter(makeFirestoreDataConverter(type));
+        const ref = softDeleteCollection.doc(activeDocRef.id);
+        return { ...info, ref };
+    }
     async get(type, entity) {
-        const { activeCollection, softDelete } = this.collectionResolver.getCollectionsForType(type);
+        const { activeCollection } = this.collectionResolver.getCollectionsForType(type);
         const activeDocRef = getReferenceForFirestoreDocument(activeCollection, entity, type);
         const activeSnapshot = await this.firestoreTransaction.get(activeDocRef);
         const activeDocument = activeSnapshot.data();
         if (activeDocument) {
             return activeDocument;
         }
-        if (!softDelete) {
+        const softDeleteInfo = this.getSoftDeleteInfo(activeDocRef, type);
+        if (!softDeleteInfo) {
             return null;
         }
-        const deletedDocRef = getReferenceForFirestoreDocument(softDelete.collection, entity, type);
-        const deletedSnapshot = await this.firestoreTransaction.get(deletedDocRef);
+        const deletedSnapshot = await this.firestoreTransaction.get(softDeleteInfo.ref);
         const deletedDocument = deletedSnapshot.data();
         if (!deletedDocument) {
             return null;
         }
-        delete deletedDocument[softDelete.expirationField];
+        delete deletedDocument[softDeleteInfo.expirationField];
         return deletedDocument;
     }
 }

package/dist/transaction/firestore-pubsub/state-transaction.js

@@ -22,26 +22,26 @@ export class FirestoreStateTransaction extends FirestoreReadOnlyStateTransaction
     async delete(typeOrEntity, key) {
         const type = (key === undefined ? typeOrEntity.constructor : typeOrEntity);
         key ??= typeOrEntity;
-        const { activeCollection, softDelete } = this.collectionResolver.getCollectionsForType(type);
+        const { activeCollection } = this.collectionResolver.getCollectionsForType(type);
         const activeDocRef = getReferenceForFirestoreDocument(activeCollection, key, type);
         this.firestoreTransaction.delete(activeDocRef);
-        if (!softDelete) {
+        const softDeleteInfo = this.getSoftDeleteInfo(activeDocRef, type);
+        if (!softDeleteInfo) {
             return;
         }
-        const deletedDocRef = getReferenceForFirestoreDocument(softDelete.collection, key, type);
-        this.firestoreTransaction.delete(deletedDocRef);
+        this.firestoreTransaction.delete(softDeleteInfo.ref);
     }
     async set(entity) {
         const documentType = entity.constructor;
-        const { activeCollection, softDelete } = this.collectionResolver.getCollectionsForType(documentType);
+        const { activeCollection } = this.collectionResolver.getCollectionsForType(documentType);
         const activeDocRef = getReferenceForFirestoreDocument(activeCollection, entity);
-        if (!softDelete) {
+        const softDeleteInfo = this.getSoftDeleteInfo(activeDocRef, documentType);
+        if (!softDeleteInfo) {
             this.firestoreTransaction.set(activeDocRef, entity);
             return;
         }
-        const deletedDocRef = getReferenceForFirestoreDocument(softDelete.collection, entity);
+        const { ref: deletedDocRef, expirationDelay, expirationField, } = softDeleteInfo;
         if ('deletedAt' in entity && entity.deletedAt instanceof Date) {
-            const { expirationDelay, expirationField } = softDelete;
             const expiresAt = new Date(entity.deletedAt.getTime() + expirationDelay);
             const deletedDoc = plainToInstance(documentType, {
                 ...entity,

package/dist/transaction/firestore-pubsub/types.d.ts

@@ -12,6 +12,8 @@ export type FirestoreCollectionsForDocumentType<T> = {
     /**
      * Configuration about the soft-delete collection, where documents are stored when their `deletedAt` field is not
      * `null`. This can be `null` if the document type does not declare a soft-delete collection.
+     *
+     * @deprecated Use `SoftDeleteInfo` in `FirestoreReadOnlyStateTransaction.getSoftDeleteInfo` instead.
      */
     readonly softDelete: ({
         /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@causa/runtime-google",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "An extension to the Causa runtime SDK (`@causa/runtime`), providing Google-specific features.",
   "repository": {
     "type": "git",
@@ -32,11 +32,11 @@
     "test:cov": "npm run test -- --coverage"
   },
   "dependencies": {
-    "@causa/runtime": "^1.1.0",
+    "@causa/runtime": "^1.3.0",
     "@google-cloud/precise-date": "^5.0.0",
     "@google-cloud/pubsub": "^5.2.0",
-    "@google-cloud/spanner": "^8.2.1",
-    "@google-cloud/tasks": "^6.2.0",
+    "@google-cloud/spanner": "^8.2.2",
+    "@google-cloud/tasks": "^6.2.1",
     "@grpc/grpc-js": "^1.14.0",
     "@nestjs/common": "^11.1.6",
     "@nestjs/config": "^4.0.2",
@@ -49,7 +49,7 @@
     "firebase-admin": "^13.5.0",
     "jsonwebtoken": "^9.0.2",
     "passport-http-bearer": "^1.0.1",
-    "pino": "^9.12.0",
+    "pino": "^9.13.1",
     "reflect-metadata": "^0.2.2"
   },
   "devDependencies": {
@@ -59,21 +59,21 @@
     "@tsconfig/node22": "^22.0.2",
     "@types/jest": "^30.0.0",
     "@types/jsonwebtoken": "^9.0.10",
-    "@types/node": "^22.18.8",
+    "@types/node": "^22.18.11",
     "@types/passport-http-bearer": "^1.0.42",
     "@types/supertest": "^6.0.3",
     "@types/uuid": "^11.0.0",
     "dotenv": "^17.2.3",
-    "eslint": "^9.36.0",
+    "eslint": "^9.38.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
     "jest": "^30.2.0",
     "jest-extended": "^6.0.0",
-    "pino-pretty": "^13.1.1",
+    "pino-pretty": "^13.1.2",
     "rimraf": "^6.0.1",
     "supertest": "^7.1.4",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.45.0",
+    "typescript-eslint": "^8.46.1",
     "uuid": "^13.0.0"
   }
 }