@causa/runtime-google 1.4.1 → 1.5.0

package/dist/spanner/entity-manager.d.ts

@@ -1,21 +1,8 @@
-import { Database, Snapshot, Transaction } from '@google-cloud/spanner';
-import { type Type as ParamType } from '@google-cloud/spanner/build/src/codec.js';
+import { Database } from '@google-cloud/spanner';
 import type { ExecuteSqlRequest, TimestampBounds } from '@google-cloud/spanner/build/src/transaction.js';
 import { type Type } from '@nestjs/common';
 import { SpannerTableCache } from './table-cache.js';
-import type { SpannerReadOnlyTransactionOption, SpannerReadWriteTransactionOption } from './types.js';
-/**
- * Any Spanner transaction that can be used for reading.
- */
-export type SpannerReadOnlyTransaction = Snapshot | Transaction;
-/**
- * A Spanner transaction that can be used for reading and writing.
- */
-export type SpannerReadWriteTransaction = Transaction;
-/**
- * A key for a Spanner row.
- */
-export type SpannerKey = (string | null)[];
+import type { SpannerKey, SpannerReadOnlyTransaction, SpannerReadOnlyTransactionOption, SpannerReadWriteTransaction, SpannerReadWriteTransactionOption, SqlParamType, SqlStatement } from './types.js';
 /**
  * Options for {@link SpannerEntityManager.snapshot}.
  */
@@ -33,23 +20,6 @@ export type SnapshotFunction<T> = (snapshot: SpannerReadOnlyTransaction) => Prom
  * A function that can be passed to the {@link SpannerEntityManager.transaction} method.
  */
 export type SpannerTransactionFunction<T> = (transaction: SpannerReadWriteTransaction) => Promise<T>;
-/**
- * A SQL statement run using {@link SpannerEntityManager.query}.
- */
-export type SqlStatement = {
-    /**
-     * The SQL statement to run.
-     */
-    sql: string;
-    /**
-     * The values for the parameters referenced in the statement.
-     */
-    params?: Record<string, any>;
-    /**
-     * The types of the parameters in the statement.
-     */
-    types?: Record<string, ParamType>;
-};
 /**
  * Options for {@link SpannerEntityManager.query}.
  */
@@ -312,15 +282,15 @@ export declare class SpannerEntityManager {
          */
         batchSize: number;
     }, statement: SqlStatement): AsyncIterable<T[]>;
-    static readonly ParamTypeFloat64Array: ParamType;
-    static readonly ParamTypeInt64Array: ParamType;
-    static readonly ParamTypeNumericArray: ParamType;
-    static readonly ParamTypeBoolArray: ParamType;
-    static readonly ParamTypeStringArray: ParamType;
-    static readonly ParamTypeBytesArray: ParamType;
-    static readonly ParamTypeJsonArray: ParamType;
-    static readonly ParamTypeTimestampArray: ParamType;
-    static readonly ParamTypeDateArray: ParamType;
+    static readonly ParamTypeFloat64Array: SqlParamType;
+    static readonly ParamTypeInt64Array: SqlParamType;
+    static readonly ParamTypeNumericArray: SqlParamType;
+    static readonly ParamTypeBoolArray: SqlParamType;
+    static readonly ParamTypeStringArray: SqlParamType;
+    static readonly ParamTypeBytesArray: SqlParamType;
+    static readonly ParamTypeJsonArray: SqlParamType;
+    static readonly ParamTypeTimestampArray: SqlParamType;
+    static readonly ParamTypeDateArray: SqlParamType;
     /**
      * Converts the given entity or array of entities to Spanner objects, grouping them by table name.
      *

package/dist/spanner/entity-manager.js

@@ -8,8 +8,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
 import { EntityNotFoundError } from '@causa/runtime';
-import { Database, Snapshot, Transaction } from '@google-cloud/spanner';
-import {} from '@google-cloud/spanner/build/src/codec.js';
+import { Database, Snapshot } from '@google-cloud/spanner';
 import { Injectable } from '@nestjs/common';
 import { copyInstanceWithMissingColumnsToNull, instanceToSpannerObject, spannerObjectToInstance, updateInstanceByColumn, } from './conversion.js';
 import { convertSpannerToEntityError } from './error-converter.js';
@@ -303,6 +302,10 @@ let SpannerEntityManager = class SpannerEntityManager {
                 jsonOptions: { wrapNumbers: entityType != null },
             });
             for await (const row of stream) {
+                // `undefined` may be sent by the `PartialResultStream` to test whether the consumer can accept more data.
+                if (row === undefined) {
+                    continue;
+                }
                 yield entityType ? spannerObjectToInstance(row, entityType) : row;
             }
         }

package/dist/spanner/index.d.ts

@@ -1,7 +1,6 @@
 export { SpannerColumn } from './column.decorator.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, SqlStatement, } from './entity-manager.js';
 export * from './errors.js';
 export { SpannerHealthIndicator } from './healthcheck.js';
 export { SpannerModule } from './module.js';

package/dist/spanner/table-cache.d.ts

@@ -1,5 +1,5 @@
 import type { Type } from '@nestjs/common';
-import type { SpannerKey } from './entity-manager.js';
+import type { SpannerKey } from './types.js';
 /**
  * A function that, given an entity, returns its primary key as a {@link SpannerKey}.
  */

package/dist/spanner/testing.js

@@ -24,20 +24,27 @@ function makeDatabaseParameters(options) {
  * @returns The database object.
  */
 export async function createDatabase(options = {}) {
-    const { name, sourceDatabaseName, instance } = makeDatabaseParameters(options);
-    const [databases] = await instance.getDatabases();
-    const existingDatabase = databases.find((d) => d.formattedName_.split('/').pop() === name);
-    await existingDatabase?.delete();
-    const [database, operation] = await instance.createDatabase(name);
-    await operation.promise();
+    const { name, sourceDatabaseName, instance, spanner } = makeDatabaseParameters(options);
+    const [{ formattedName_: parent }] = await instance.get();
+    const adminClient = spanner.getDatabaseAdminClient();
+    const [databases] = await adminClient.listDatabases({ parent });
+    const existingDatabase = databases.find((d) => d.name?.split('/').pop() === name);
+    if (existingDatabase) {
+        await adminClient.dropDatabase({ database: existingDatabase.name });
+    }
+    let extraStatements;
     if (sourceDatabaseName) {
         const sourceDatabase = instance.database(sourceDatabaseName);
-        const [schema] = await sourceDatabase.getSchema();
+        [extraStatements] = await sourceDatabase.getSchema();
         await sourceDatabase.close();
-        const [updateOperation] = await database.updateSchema(schema);
-        await updateOperation.promise();
     }
-    return database;
+    const [operation] = await adminClient.createDatabase({
+        parent,
+        createStatement: `CREATE DATABASE \`${name}\``,
+        extraStatements,
+    });
+    await operation.promise();
+    return instance.database(name);
 }
 /**
  * A {@link Fixture} that creates a temporary Spanner database and injects it into the NestJS application.

package/dist/spanner/types.d.ts

@@ -1,6 +1,19 @@
-import { protos } from '@google-cloud/spanner';
-import type { SpannerReadOnlyTransaction, SpannerReadWriteTransaction } from './entity-manager.js';
+import { protos, Snapshot, Transaction } from '@google-cloud/spanner';
+import type { Type } from '@google-cloud/spanner/build/src/codec.js';
+export type SqlParamType = Type;
 export declare const SpannerRequestPriority: typeof protos.google.spanner.v1.RequestOptions.Priority;
+/**
+ * A key for a Spanner row.
+ */
+export type SpannerKey = (string | null)[];
+/**
+ * Any Spanner transaction that can be used for reading.
+ */
+export type SpannerReadOnlyTransaction = Snapshot | Transaction;
+/**
+ * A Spanner transaction that can be used for reading and writing.
+ */
+export type SpannerReadWriteTransaction = Transaction;
 /**
  * Option for a function that accepts a Spanner read-only transaction.
  */
@@ -29,3 +42,28 @@ export type SpannerReadWriteTransactionOption = {
      */
     readonly tag?: string;
 };
+/**
+ * Parameters for a SQL statement run using `SpannerEntityManager.query`.
+ */
+export type SqlStatementParams = Record<string, any>;
+/**
+ * Types for parameters in a SQL statement run using `SpannerEntityManager.query`.
+ */
+export type SqlStatementTypes = Record<string, SqlParamType>;
+/**
+ * A SQL statement run using `SpannerEntityManager.query`.
+ */
+export type SqlStatement = {
+    /**
+     * The SQL statement to run.
+     */
+    sql: string;
+    /**
+     * The values for the parameters referenced in the statement.
+     */
+    params?: SqlStatementParams;
+    /**
+     * The types of the parameters in the statement.
+     */
+    types?: SqlStatementTypes;
+};

package/dist/spanner/types.js

@@ -1,2 +1,2 @@
-import { protos } from '@google-cloud/spanner';
+import { protos, Snapshot, Transaction } from '@google-cloud/spanner';
 export const SpannerRequestPriority = protos.google.spanner.v1.RequestOptions.Priority;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@causa/runtime-google",
-  "version": "1.4.1",
+  "version": "1.5.0",
   "description": "An extension to the Causa runtime SDK (`@causa/runtime`), providing Google-specific features.",
   "repository": {
     "type": "git",
@@ -56,7 +56,7 @@
     "@nestjs/testing": "^11.1.9",
     "@swc/core": "^1.15.2",
     "@swc/jest": "^0.2.39",
-    "@tsconfig/node20": "^20.1.7",
+    "@tsconfig/node20": "^20.1.8",
     "@types/jest": "^30.0.0",
     "@types/jsonwebtoken": "^9.0.10",
     "@types/node": "^20.19.25",
@@ -70,10 +70,10 @@
     "jest": "^30.2.0",
     "jest-extended": "^7.0.0",
     "pino-pretty": "^13.1.2",
-    "rimraf": "^6.1.0",
+    "rimraf": "^6.1.2",
     "supertest": "^7.1.4",
     "typescript": "^5.9.3",
-    "typescript-eslint": "^8.46.4",
+    "typescript-eslint": "^8.47.0",
     "uuid": "^13.0.0"
   }
 }