@mastra/libsql 1.27.1-alpha.0 → 1.27.1-alpha.1

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.27.1-alpha.0",
+  "version": "1.27.1-alpha.1",
   "package": "@mastra/libsql",
   "exports": {},
   "modules": {}

package/dist/index.cjs

@@ -2059,6 +2059,41 @@ var LibSQLDB = class extends _mastra_core_base.MastraBase {
 		});
 	}
 	/**
+	* Updates multiple records in one write batch, with the same retry behavior as
+	* {@link batchUpdate}. Returns, in input order, whether each update changed a row,
+	* so callers can put extra conditions in `keys` (for example `{ endedAt: null }`).
+	*/
+	async batchUpdateReportingChanges({ tableName, updates }) {
+		return this.executeWriteOperationWithRetry(async () => {
+			const changed = updates.map(() => false);
+			const statements = [];
+			const statementIndexes = [];
+			for (const [index, { keys, data }] of updates.entries()) {
+				const filteredData = await this.filterRecordToKnownColumns(tableName, data);
+				if (Object.keys(filteredData).length === 0) continue;
+				statements.push(prepareUpdateStatement({
+					tableName,
+					updates: filteredData,
+					keys
+				}));
+				statementIndexes.push(index);
+			}
+			if (statements.length === 0) return changed;
+			(await withClientWriteLock(this.client, () => this.client.batch(statements, "write"))).forEach((result, i) => {
+				const index = statementIndexes[i];
+				if (index !== void 0) changed[index] = result.rowsAffected > 0;
+			});
+			return changed;
+		}, `batch update in table ${tableName}`).catch((error) => {
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("LIBSQL", "BATCH_UPDATE_REPORTING_CHANGES", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.THIRD_PARTY,
+				details: { tableName }
+			}, error);
+		});
+	}
+	/**
 	* Internal batch delete implementation without retry logic.
 	* Each record can be deleted based on single or composite keys.
 	*/
@@ -2191,7 +2226,7 @@ var LibSQLDB = class extends _mastra_core_base.MastraBase {
 	* @returns The total count of matching records
 	*/
 	async selectTotalCount({ tableName, whereClause }) {
-		const statement = `SELECT COUNT(*) as count FROM ${(0, _mastra_core_utils.parseSqlIdentifier)(tableName, "table name")} ${whereClause ? `${whereClause.sql}` : ""}`;
+		const statement = `SELECT COUNT(*) as count FROM ${(0, _mastra_core_utils.parseSqlIdentifier)(tableName, "table name")} ${whereClause ? whereClause.sql : ""}`;
 		const result = await this.client.execute({
 			sql: statement,
 			args: whereClause?.args ?? []
@@ -12563,24 +12598,27 @@ var ObservabilityLibSQL = class ObservabilityLibSQL extends _mastra_core_storage
 			}, error);
 		}
 	}
-	async batchUpdateSpans(args) {
+	#toSpanUpdates(records) {
 		const now = (/* @__PURE__ */ new Date()).toISOString();
+		return records.map((record) => {
+			const data = { ...record.updates };
+			if (data.endedAt instanceof Date) data.endedAt = data.endedAt.toISOString();
+			if (data.startedAt instanceof Date) data.startedAt = data.startedAt.toISOString();
+			data.updatedAt = now;
+			return {
+				keys: {
+					spanId: record.spanId,
+					traceId: record.traceId
+				},
+				data
+			};
+		});
+	}
+	async batchUpdateSpans(args) {
 		try {
 			return this.#db.batchUpdate({
 				tableName: _mastra_core_storage.TABLE_SPANS,
-				updates: args.records.map((record) => {
-					const data = { ...record.updates };
-					if (data.endedAt instanceof Date) data.endedAt = data.endedAt.toISOString();
-					if (data.startedAt instanceof Date) data.startedAt = data.startedAt.toISOString();
-					data.updatedAt = now;
-					return {
-						keys: {
-							spanId: record.spanId,
-							traceId: record.traceId
-						},
-						data
-					};
-				})
+				updates: this.#toSpanUpdates(args.records)
 			});
 		} catch (error) {
 			throw new _mastra_core_error.MastraError({
@@ -12590,6 +12628,30 @@ var ObservabilityLibSQL = class ObservabilityLibSQL extends _mastra_core_storage
 			}, error);
 		}
 	}
+	async batchUpdateUnendedSpans(args) {
+		try {
+			const changed = await this.#db.batchUpdateReportingChanges({
+				tableName: _mastra_core_storage.TABLE_SPANS,
+				updates: this.#toSpanUpdates(args.records).map((update) => ({
+					...update,
+					keys: {
+						...update.keys,
+						endedAt: null
+					}
+				}))
+			});
+			return { updated: args.records.filter((_, index) => changed[index]).map(({ traceId, spanId }) => ({
+				traceId,
+				spanId
+			})) };
+		} catch (error) {
+			throw new _mastra_core_error.MastraError({
+				id: (0, _mastra_core_storage.createStorageErrorId)("LIBSQL", "BATCH_UPDATE_UNENDED_SPANS", "FAILED"),
+				domain: _mastra_core_error.ErrorDomain.STORAGE,
+				category: _mastra_core_error.ErrorCategory.USER
+			}, error);
+		}
+	}
 	async batchDeleteTraces(args) {
 		this.assertUnscopedBatchDeleteTraces(args);
 		try {
@@ -15278,6 +15340,9 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 	supportsConcurrentUpdates() {
 		return true;
 	}
+	supportsGuardedSnapshotWrites() {
+		return true;
+	}
 	parseWorkflowRun(row) {
 		let parsedSnapshot = row.snapshot;
 		if (typeof parsedSnapshot === "string") try {
@@ -15551,7 +15616,7 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 			}
 		}), "updateWorkflowState");
 	}
-	async persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot, createdAt, updatedAt, fence }) {
+	async persistWorkflowSnapshot({ workflowName, runId, resourceId, snapshot, createdAt, updatedAt, fence, expectedStatus }) {
 		const now = /* @__PURE__ */ new Date();
 		const createdAtValue = (createdAt ?? now).toISOString();
 		const updatedAtValue = (updatedAt ?? now).toISOString();
@@ -15559,21 +15624,30 @@ var WorkflowsLibSQL = class WorkflowsLibSQL extends _mastra_core_storage.Workflo
 			workflowName,
 			runId
 		});
+		const expected = expectedStatus === void 0 ? [] : Array.isArray(expectedStatus) ? expectedStatus : [expectedStatus];
+		const guard = expectedStatus === void 0 ? "" : expected.length ? ` WHERE json_extract(${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}.snapshot, '$.status') IN (${expected.map(() => "?").join(", ")})` : " WHERE 0";
 		const check = this.#runFenceCheck(fence, runId, "persistWorkflowSnapshot");
-		await this.executeWithRetry(() => withRunFence(this.#client, check, (writer) => writer.execute({
+		return (await this.executeWithRetry(() => withRunFence(this.#client, check, (writer) => writer.execute({
 			sql: `INSERT INTO ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT} (workflow_name, run_id, resourceId, snapshot, createdAt, updatedAt)
                 VALUES (?, ?, ?, jsonb(?), ?, ?)
                 ON CONFLICT(workflow_name, run_id)
-                DO UPDATE SET resourceId = COALESCE(excluded.resourceId, ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}.resourceId), snapshot = excluded.snapshot, updatedAt = excluded.updatedAt`,
+                DO UPDATE SET resourceId = COALESCE(excluded.resourceId, ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT}.resourceId), snapshot = excluded.snapshot, updatedAt = excluded.updatedAt${guard}`,
 			args: [
 				workflowName,
 				runId,
 				resourceId ?? null,
 				safeStringify(snapshot),
 				createdAtValue,
-				updatedAtValue
+				updatedAtValue,
+				...expected
 			]
-		})), "persistWorkflowSnapshot");
+		})), "persistWorkflowSnapshot")).rowsAffected > 0;
+	}
+	async loadWorkflowRunStatus({ workflowName, runId }) {
+		return (await this.#client.execute({
+			sql: `SELECT json_extract(snapshot, '$.status') AS status FROM ${_mastra_core_storage.TABLE_WORKFLOW_SNAPSHOT} WHERE workflow_name = ? AND run_id = ?`,
+			args: [workflowName, runId]
+		})).rows?.[0]?.status ?? null;
 	}
 	async loadWorkflowSnapshot({ workflowName, runId }) {
 		this.logger.debug("Loading workflow snapshot", {