@mastra/spanner 1.10.0 → 1.10.1-alpha.1

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.0"
+  version: "1.10.1-alpha.1"
 ---
 
 ## When to use

package/dist/docs/assets/SOURCE_MAP.json

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

package/dist/docs/references/reference-storage-retention.md

@@ -294,7 +294,7 @@ const storage = new MongoDBStore({
 
 ## Reclaiming disk
 
-`prune()` deletes rows but doesn't shrink the database file. On SQLite/libSQL the freed pages go on a freelist and are reused by future writes, so the file stops growing: for most users this alone solves the unbounded-growth problem.
+`prune()` deletes rows but doesn't shrink the database file. On SQLite/libSQL the freed pages go on a freelist for reuse by future writes. Reusing these pages prevents unbounded file growth for most users.
 
 Handing that free space back to the OS is a separate concern that Mastra doesn't manage. If you specifically need to shrink the file, run the underlying database's compaction (for example `VACUUM` on self-hosted libSQL) yourself in a maintenance window. A full `VACUUM` locks the file and needs roughly twice the file size in free disk. On PostgreSQL, autovacuum reclaims dead tuples for reuse automatically. A manual `VACUUM FULL` is only needed if you must return disk to the OS.
 

package/dist/index.cjs

@@ -6,7 +6,7 @@ let _mastra_core_base = require("@mastra/core/base");
 let _mastra_core_utils = require("@mastra/core/utils");
 let _mastra_core_agent = require("@mastra/core/agent");
 let _mastra_core_evals = require("@mastra/core/evals");
-//#region src/storage/db/utils.ts
+// src/storage/db/utils.ts
 /**
 * Quote a Spanner identifier with backticks. GoogleSQL uses backticks for
 * identifiers that may collide with reserved keywords.
@@ -58,8 +58,7 @@ function getColumnDef(table, column) {
 function isInOperator(value) {
 	return typeof value === "object" && value !== null && "$in" in value && Array.isArray(value.$in);
 }
-//#endregion
-//#region src/storage/db/index.ts
+// src/storage/db/index.ts
 /**
 * Resolves a SpannerDomainConfig into a concrete Database handle plus options.
 */
@@ -1142,8 +1141,7 @@ var SpannerDB = class extends _mastra_core_base.MastraBase {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/utils.ts
+// src/storage/domains/utils.ts
 /**
 * Build storage filter entries for a date range, using the operator suffixes
 * understood by `SpannerDB.prepareWhereClause`.
@@ -1196,8 +1194,7 @@ function transformFromSpannerRow({ tableName, row }) {
 	}
 	return result;
 }
-//#endregion
-//#region src/storage/domains/agents/index.ts
+// src/storage/domains/agents/index.ts
 const VERSION_CONFIG_KEYS = [
 	"name",
 	"description",
@@ -1857,8 +1854,7 @@ var AgentsSpanner = class AgentsSpanner extends _mastra_core_storage.AgentsStora
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/background-tasks/index.ts
+// src/storage/domains/background-tasks/index.ts
 function buildStatusCondition(filter, params, startIdx) {
 	if (filter.status === void 0) return { kind: "no-filter" };
 	const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
@@ -2270,8 +2266,7 @@ var BackgroundTasksSpanner = class BackgroundTasksSpanner extends _mastra_core_s
 		return Number(rows[0]?.count ?? 0);
 	}
 };
-//#endregion
-//#region src/storage/domains/blobs/index.ts
+// src/storage/domains/blobs/index.ts
 /**
 * Content-addressable blob store backed by Spanner. Blobs are keyed by their
 * SHA-256 hash; duplicate puts are no-ops thanks to `INSERT OR IGNORE`.
@@ -2489,8 +2484,7 @@ var BlobsSpanner = class BlobsSpanner extends _mastra_core_storage.BlobStore {
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/channels/index.ts
+// src/storage/domains/channels/index.ts
 const INSTALLATIONS = _mastra_core_storage.TABLE_CHANNEL_INSTALLATIONS;
 const CONFIG = _mastra_core_storage.TABLE_CHANNEL_CONFIG;
 const WEBHOOK_INDEX = "mastra_channel_installations_webhookid_idx";
@@ -2834,8 +2828,7 @@ var ChannelsSpanner = class ChannelsSpanner extends _mastra_core_storage.Channel
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/datasets/index.ts
+// src/storage/domains/datasets/index.ts
 function toDate$1(value) {
 	return value instanceof Date ? value : new Date(value);
 }
@@ -4185,8 +4178,7 @@ var DatasetsSpanner = class DatasetsSpanner extends _mastra_core_storage.Dataset
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/experiments/index.ts
+// src/storage/domains/experiments/index.ts
 function toDate(value) {
 	return value instanceof Date ? value : new Date(value);
 }
@@ -5180,8 +5172,7 @@ var ExperimentsSpanner = class ExperimentsSpanner extends _mastra_core_storage.E
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/favorites/index.ts
+// src/storage/domains/favorites/index.ts
 /**
 * Maps a favorite entity type to the parent table whose denormalized
 * `favoriteCount` column the favorites domain keeps in sync.
@@ -5526,8 +5517,7 @@ var FavoritesSpanner = class FavoritesSpanner extends _mastra_core_storage.Favor
 		} catch {}
 	}
 };
-//#endregion
-//#region src/storage/domains/mcp-clients/index.ts
+// src/storage/domains/mcp-clients/index.ts
 /**
 * Spanner-backed storage for MCP-client definitions and their immutable versions.
 * Mirrors the thin-record + versions pattern used by agents/skills/prompt-blocks.
@@ -6111,8 +6101,7 @@ var MCPClientsSpanner = class MCPClientsSpanner extends _mastra_core_storage.MCP
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/mcp-servers/index.ts
+// src/storage/domains/mcp-servers/index.ts
 /**
 * Spanner-backed storage for MCP-server definitions and their immutable versions.
 * Mirrors the thin-record + versions pattern used by agents/skills/prompt-blocks.
@@ -6720,8 +6709,7 @@ var MCPServersSpanner = class MCPServersSpanner extends _mastra_core_storage.MCP
 		}
 	}
 };
-//#endregion
-//#region src/storage/db/run-fencing.ts
+// src/storage/db/run-fencing.ts
 /** Epoch milliseconds on the database clock, read when the statement runs. */
 const DB_NOW_MS = "UNIX_MILLIS(CURRENT_TIMESTAMP())";
 /**
@@ -6774,8 +6762,7 @@ function withRunFence(db, claimsTable, fence, operation, write) {
 		return write(tx);
 	});
 }
-//#endregion
-//#region src/storage/domains/memory/index.ts
+// src/storage/domains/memory/index.ts
 function buildSpannerMessageMetadataFilter(metadataFilter) {
 	if (!metadataFilter) return {
 		clauses: [],
@@ -8045,8 +8032,7 @@ var MemorySpanner = class MemorySpanner extends _mastra_core_storage.MemoryStora
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/observability/metrics.ts
+// src/storage/domains/observability/metrics.ts
 /** Physical table name. Not exposed by `@mastra/core/storage` (no TABLE_METRICS
 *  constant exists), so the Spanner adapter owns the name itself. Follows the
 *  same `mastra_ai_*` convention as `TABLE_SPANS = 'mastra_ai_spans'`. */
@@ -9153,8 +9139,7 @@ async function clearMetrics(database) {
 		}
 	});
 }
-//#endregion
-//#region src/storage/domains/observability/index.ts
+// src/storage/domains/observability/index.ts
 function invalidTraceFilterKey(kind, key) {
 	return new _mastra_core_error.MastraError({
 		id: (0, _mastra_core_storage.createStorageErrorId)("SPANNER", "LIST_TRACES", "VALIDATE_FAILED"),
@@ -9770,8 +9755,7 @@ var ObservabilitySpanner = class ObservabilitySpanner extends _mastra_core_stora
 		return getMetricLabelValues(this.database, args, this.readOptions());
 	}
 };
-//#endregion
-//#region src/storage/domains/prompt-blocks/index.ts
+// src/storage/domains/prompt-blocks/index.ts
 /**
 * Spanner-backed storage for prompt blocks and their immutable versions.
 * Mirrors the thin-record + versions pattern used by agents/skills/scorer-definitions.
@@ -10362,8 +10346,7 @@ var PromptBlocksSpanner = class PromptBlocksSpanner extends _mastra_core_storage
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/schedules/index.ts
+// src/storage/domains/schedules/index.ts
 function rowToSchedule(row) {
 	const transformed = transformFromSpannerRow({
 		tableName: _mastra_core_storage.TABLE_SCHEDULES,
@@ -10861,8 +10844,7 @@ var SchedulesSpanner = class SchedulesSpanner extends _mastra_core_storage.Sched
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/scorer-definitions/index.ts
+// src/storage/domains/scorer-definitions/index.ts
 /**
 * Spanner-backed storage for scorer definitions and their immutable versions.
 * Mirrors the thin-record + versions pattern used by agents/skills/prompt-blocks.
@@ -11461,8 +11443,7 @@ var ScorerDefinitionsSpanner = class ScorerDefinitionsSpanner extends _mastra_co
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/scores/index.ts
+// src/storage/domains/scores/index.ts
 function transformScoreRow(row) {
 	const normalized = transformFromSpannerRow({
 		tableName: _mastra_core_storage.TABLE_SCORERS,
@@ -11744,8 +11725,7 @@ var ScoresSpanner = class ScoresSpanner extends _mastra_core_storage.ScoresStora
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/skills/index.ts
+// src/storage/domains/skills/index.ts
 /**
 * Spanner-backed storage for skills and their immutable versions.
 * Mirrors the thin-record + versions pattern used by agents/prompt-blocks/scorer-definitions.
@@ -12369,8 +12349,7 @@ var SkillsSpanner = class SkillsSpanner extends _mastra_core_storage.SkillsStora
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workflow-definitions/index.ts
+// src/storage/domains/workflow-definitions/index.ts
 function rowToDefinition(row) {
 	const parsed = transformFromSpannerRow({
 		tableName: _mastra_core_storage.TABLE_WORKFLOW_DEFINITIONS,
@@ -12540,8 +12519,7 @@ var WorkflowDefinitionsSpanner = class WorkflowDefinitionsSpanner extends _mastr
 		});
 	}
 };
-//#endregion
-//#region src/storage/domains/workflows/index.ts
+// src/storage/domains/workflows/index.ts
 const RUN_OWNERS_TABLE = quoteIdent(_mastra_core_storage.TABLE_WORKFLOW_RUN_OWNERS, "table name");
 const RUN_ID = quoteIdent("runId", "column name");
 const OWNER_ID = quoteIdent("ownerId", "column name");
@@ -13247,8 +13225,7 @@ var WorkflowsSpanner = class WorkflowsSpanner extends _mastra_core_storage.Workf
 		}
 	}
 };
-//#endregion
-//#region src/storage/domains/workspaces/index.ts
+// src/storage/domains/workspaces/index.ts
 /** Snapshot config fields that live exclusively on version rows. */
 const SNAPSHOT_FIELDS = [
 	"name",
@@ -13877,8 +13854,7 @@ var WorkspacesSpanner = class WorkspacesSpanner extends _mastra_core_storage.Wor
 		}
 	}
 };
-//#endregion
-//#region src/storage/index.ts
+// src/storage/index.ts
 /** Domain keys this adapter implements; the only valid values for `enabledDomains`. */
 const SPANNER_DOMAIN_KEYS = [
 	"scores",
@@ -14069,15 +14045,10 @@ var SpannerStore = class extends _mastra_core_storage.MastraCompositeStore {
 	*/
 	async close() {
 		if (!this.ownsClient) return;
-		try {
-			await this.database.close();
-			if (this.spanner) this.spanner.close();
-		} catch (error) {
-			throw error;
-		}
+		await this.database.close();
+		if (this.spanner) this.spanner.close();
 	}
 };
-//#endregion
 exports.AgentsSpanner = AgentsSpanner;
 exports.BackgroundTasksSpanner = BackgroundTasksSpanner;
 exports.BlobsSpanner = BlobsSpanner;