@mastra/spanner 1.10.1 → 1.11.0-alpha.0

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-spanner
 description: Documentation for @mastra/spanner. Use when working with @mastra/spanner APIs, configuration, or implementation.
 metadata:
   package: "@mastra/spanner"
-  version: "1.10.1"
+  version: "1.11.0-alpha.0"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.10.1",
+  "version": "1.11.0-alpha.0",
   "package": "@mastra/spanner",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -1908,10 +1908,13 @@ function rowToTask(row) {
 		suspendedAt: transformed.suspendedAt ? transformed.suspendedAt instanceof Date ? transformed.suspendedAt : new Date(transformed.suspendedAt) : void 0,
 		completedAt: transformed.completedAt ? transformed.completedAt instanceof Date ? transformed.completedAt : new Date(transformed.completedAt) : void 0,
 		ownerId: transformed.ownerId != null ? String(transformed.ownerId) : void 0,
-		leaseExpiresAt: transformed.leaseExpiresAt ? transformed.leaseExpiresAt instanceof Date ? transformed.leaseExpiresAt : new Date(transformed.leaseExpiresAt) : void 0
+		leaseExpiresAt: transformed.leaseExpiresAt ? transformed.leaseExpiresAt instanceof Date ? transformed.leaseExpiresAt : new Date(transformed.leaseExpiresAt) : void 0,
+		expiresAt: transformed.expiresAt ? transformed.expiresAt instanceof Date ? transformed.expiresAt : new Date(transformed.expiresAt) : void 0,
+		metadata: parseJson(transformed.metadata) ?? void 0
 	};
 }
 var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_storage.BackgroundTasksStorage {
+	supportsTaskExpiry = true;
 	database;
 	db;
 	skipDefaultIndexes;
@@ -1941,7 +1944,9 @@ var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_s
 				"suspend_payload",
 				"suspendedAt",
 				"ownerId",
-				"leaseExpiresAt"
+				"leaseExpiresAt",
+				"expiresAt",
+				"metadata"
 			]
 		});
 		await this.createDefaultIndexes();
@@ -2024,7 +2029,9 @@ var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_s
 				suspendedAt: task.suspendedAt ?? null,
 				completedAt: task.completedAt ?? null,
 				ownerId: task.ownerId ?? null,
-				leaseExpiresAt: task.leaseExpiresAt ?? null
+				leaseExpiresAt: task.leaseExpiresAt ?? null,
+				expiresAt: task.expiresAt ?? null,
+				metadata: task.metadata ?? null
 			}
 		});
 	}
@@ -2040,12 +2047,18 @@ var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_s
 		if ("completedAt" in update) data.completedAt = update.completedAt ?? null;
 		if ("ownerId" in update) data.ownerId = update.ownerId ?? null;
 		if ("leaseExpiresAt" in update) data.leaseExpiresAt = update.leaseExpiresAt ?? null;
+		if ("expiresAt" in update) data.expiresAt = update.expiresAt ?? null;
+		if ("metadata" in update) data.metadata = update.metadata ?? null;
 		if (Object.keys(data).length === 0) return false;
 		const setClauses = Object.keys(data).map((field) => `${quoteIdent(field, "column name")} = @${field}`);
-		const params = {
-			...data,
-			id: taskId
-		};
+		const params = { id: taskId };
+		const types = {};
+		for (const [field, value] of Object.entries(data)) {
+			const prepared = this.db.prepareValue(value, field, _mastra_core_storage.TABLE_BACKGROUND_TASKS);
+			params[field] = prepared;
+			const colType = getColumnDef(_mastra_core_storage.TABLE_BACKGROUND_TASKS, field)?.type;
+			if (prepared === null || colType === "jsonb" || colType === "timestamp") types[field] = getSpannerParamType(colType);
+		}
 		const predicates = [];
 		if (options?.expectedStatus) {
 			predicates.push("status = @expectedStatus");
@@ -2062,15 +2075,24 @@ var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_s
 			if (options.expectedLeaseExpiresAt === null) predicates.push("leaseExpiresAt IS NULL");
 			else {
 				predicates.push("leaseExpiresAt = @expectedLeaseExpiresAt");
-				params.expectedLeaseExpiresAt = options.expectedLeaseExpiresAt;
+				params.expectedLeaseExpiresAt = this.db.prepareValue(options.expectedLeaseExpiresAt, "leaseExpiresAt", _mastra_core_storage.TABLE_BACKGROUND_TASKS);
+				types.expectedLeaseExpiresAt = getSpannerParamType("timestamp");
+			}
+		}
+		if (options?.expectedSuspendedAt !== void 0) {
+			if (options.expectedSuspendedAt === null) predicates.push("suspendedAt IS NULL");
+			else {
+				predicates.push("suspendedAt = @expectedSuspendedAt");
+				params.expectedSuspendedAt = this.db.prepareValue(options.expectedSuspendedAt, "suspendedAt", _mastra_core_storage.TABLE_BACKGROUND_TASKS);
+				types.expectedSuspendedAt = getSpannerParamType("timestamp");
 			}
 		}
 		const predicateSql = predicates.length > 0 ? ` AND ${predicates.join(" AND ")}` : "";
-		const [rowCount] = await this.database.runUpdate({
+		return await this.db.runDml({
 			sql: `UPDATE ${this.tableName()} SET ${setClauses.join(", ")} WHERE id = @id${predicateSql}`,
-			params
-		});
-		return rowCount > 0;
+			params,
+			types
+		}) > 0;
 	}
 	async getTask(taskId) {
 		const [rows] = await this.database.run({
@@ -2140,7 +2162,8 @@ var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_s
 			params[name] = filter.toolCallId;
 			conditions.push(`${quoteIdent("tool_call_id", "column name")} = @${name}`);
 		}
-		const dateCol = filter.dateFilterBy === "startedAt" ? quoteIdent("startedAt", "column name") : filter.dateFilterBy === "suspendedAt" ? quoteIdent("suspendedAt", "column name") : filter.dateFilterBy === "completedAt" ? quoteIdent("completedAt", "column name") : quoteIdent("createdAt", "column name");
+		const dateCol = filter.dateFilterBy === "startedAt" ? quoteIdent("startedAt", "column name") : filter.dateFilterBy === "suspendedAt" ? quoteIdent("suspendedAt", "column name") : filter.dateFilterBy === "completedAt" ? quoteIdent("completedAt", "column name") : filter.dateFilterBy === "expiresAt" ? quoteIdent("expiresAt", "column name") : quoteIdent("createdAt", "column name");
+		if (filter.hasExpiresAt !== void 0) conditions.push(`${quoteIdent("expiresAt", "column name")} IS ${filter.hasExpiresAt ? "NOT NULL" : "NULL"}`);
 		if (filter.fromDate) {
 			const name = `p${idx++}`;
 			params[name] = filter.fromDate.toISOString();
@@ -2205,7 +2228,8 @@ var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_s
 			conditions.push(statusCondition.sql);
 			idx = statusCondition.nextIdx;
 		}
-		const dateCol = filter.dateFilterBy === "startedAt" ? quoteIdent("startedAt", "column name") : filter.dateFilterBy === "completedAt" ? quoteIdent("completedAt", "column name") : quoteIdent("createdAt", "column name");
+		const dateCol = filter.dateFilterBy === "startedAt" ? quoteIdent("startedAt", "column name") : filter.dateFilterBy === "suspendedAt" ? quoteIdent("suspendedAt", "column name") : filter.dateFilterBy === "completedAt" ? quoteIdent("completedAt", "column name") : filter.dateFilterBy === "expiresAt" ? quoteIdent("expiresAt", "column name") : quoteIdent("createdAt", "column name");
+		if (filter.hasExpiresAt !== void 0) conditions.push(`${quoteIdent("expiresAt", "column name")} IS ${filter.hasExpiresAt ? "NOT NULL" : "NULL"}`);
 		if (filter.fromDate) {
 			const name = `p${idx++}`;
 			params[name] = filter.fromDate.toISOString();