@mastra/observability 1.17.1 → 1.17.2-alpha.1

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @mastra/observability
 
+## 1.17.2-alpha.1
+
+### Patch Changes
+
+- Fix PostgreSQL observability writes failing on NUL characters and unpaired Unicode surrogates ([#21728](https://github.com/mastra-ai/mastra/pull/21728))
+
+  Span serialization truncated strings by UTF-16 code unit, so a cut inside an emoji left a lone surrogate that PostgreSQL rejected on the jsonb cast (`22P02`). NUL characters were rejected as well (`22P05`). Because observability events are inserted as a single multi-row statement, one malformed field discarded the entire batch.
+
+  Truncation now preserves complete surrogate pairs, and the v-next PostgreSQL observability encoder sanitizes NUL and unpaired surrogates before the jsonb cast, using the same sanitizer that workflow snapshots already rely on. Valid Unicode, including complete emoji, is preserved.
+
+- Updated dependencies [[`2c85f42`](https://github.com/mastra-ai/mastra/commit/2c85f428e04ccd63ea31a7ec80b5b327afdad555), [`11bbeb9`](https://github.com/mastra-ai/mastra/commit/11bbeb9b108ef2264e05acefc6dafb9cbb342921), [`1a485f3`](https://github.com/mastra-ai/mastra/commit/1a485f3538f5ec64d58bd8b5e1e99de0c695c87b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`8661d7d`](https://github.com/mastra-ai/mastra/commit/8661d7d7179f0a024456aabdd8679bcecd09ac28), [`575e343`](https://github.com/mastra-ai/mastra/commit/575e343900451021d96110916497d334af7bc252), [`cacb839`](https://github.com/mastra-ai/mastra/commit/cacb8392d9e74189b56d857290b0615f98a2683d), [`b47b26e`](https://github.com/mastra-ai/mastra/commit/b47b26e6fe95cb8a3482be2c5e52de157fe59d0b), [`0d37487`](https://github.com/mastra-ai/mastra/commit/0d37487d9f349388a3f1cef6a536cf9dcc4b6273), [`c46eb09`](https://github.com/mastra-ai/mastra/commit/c46eb09ce4987509af57a0ac582c61241a6dd2f1), [`30ed33e`](https://github.com/mastra-ai/mastra/commit/30ed33ee14084a26019aba15fceadda6d6ddefaf), [`91ad69d`](https://github.com/mastra-ai/mastra/commit/91ad69d64994c89199b0c55399e64ed91c61df2f), [`8dc408d`](https://github.com/mastra-ai/mastra/commit/8dc408d34438f9e13297f792c11a5cfd6cf952e1), [`c92def1`](https://github.com/mastra-ai/mastra/commit/c92def10a13c822972c96f0a4ca6ffc1f4258aed), [`c5eaec5`](https://github.com/mastra-ai/mastra/commit/c5eaec5a860d80d0e3805e67db0414b87ac8cbed), [`e66b2ba`](https://github.com/mastra-ai/mastra/commit/e66b2ba100db63eaeab6e21e1ea34b113f2ec781)]:
+  - @mastra/core@1.62.0-alpha.3
+
+## 1.17.2-alpha.0
+
+### Patch Changes
+
+- Fixed `MastraStorageExporter` staying disabled when a configured observability store is temporarily unavailable during startup. The exporter now recovers on a later event, so traces resume without restarting the process. (#21943) ([#21957](https://github.com/mastra-ai/mastra/pull/21957))
+
+- Updated dependencies [[`f95f468`](https://github.com/mastra-ai/mastra/commit/f95f468cf1e7c2b924a13826494f98b8f2ccd581)]:
+  - @mastra/core@1.61.1-alpha.1
+
 ## 1.17.1
 
 ### Patch Changes

package/dist/exporters/mastra-storage.d.ts

@@ -23,6 +23,9 @@ export declare class MastraStorageExporter extends BaseExporter {
      * Initialize the exporter (called after all dependencies are ready)
      */
     init(options: InitExporterOptions): Promise<void>;
+    private warnUnavailable;
+    private initializeStorage;
+    private ensureInitialized;
     /**
      * Checks if buffer should be flushed based on size or time triggers
      */
@@ -63,12 +66,6 @@ export declare class MastraStorageExporter extends BaseExporter {
      */
     private flushBuffer;
     _exportTracingEvent(event: TracingEvent): Promise<void>;
-    /**
-     * Resolves when an ongoing init call is finished
-     * Doesn't wait for the caller to call init
-     * @returns
-     */
-    private waitForInit;
     /**
      * Handle metric events — buffer for batch flush.
      */

package/dist/exporters/mastra-storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mastra-storage.d.ts","sourceRoot":"","sources":["../../src/exporters/mastra-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,aAAa,EAId,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAwB,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AAS/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,4FAA4F;AAC5F,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;CAC5C;AAoCD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;;IACrD,IAAI,SAA6B;gBAgBrB,MAAM,GAAE,2BAAgC;IAiBpD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDvD;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAiBzB;;;;OAIG;YACW,kBAAkB;IAQhC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,QAAQ;IAsBhB;;;;OAIG;YACW,YAAY;IAkC1B;;;OAGG;YACW,gBAAgB;IA+D9B;;;;;;;OAOG;YACW,WAAW;IA+HnB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D;;;;OAIG;YACW,WAAW;IAOzB;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBhC"}
+{"version":3,"file":"mastra-storage.d.ts","sourceRoot":"","sources":["../../src/exporters/mastra-storage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,WAAW,EACX,QAAQ,EACR,UAAU,EACV,aAAa,EAId,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAwB,sBAAsB,EAAwB,MAAM,sBAAsB,CAAC;AAS/G,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAItC,4FAA4F;AAC5F,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACrE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;CAC5C;AAkCD;;;GAGG;AACH,qBAAa,qBAAsB,SAAQ,YAAY;;IACrD,IAAI,SAA6B;gBAgBrB,MAAM,GAAE,2BAAgC;IAiBpD;;OAEG;IACG,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAUvD,OAAO,CAAC,eAAe;YAUT,iBAAiB;YA6CjB,iBAAiB;IAS/B;;OAEG;IACH,OAAO,CAAC,WAAW;IAyBnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAcrB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,iBAAiB;IAiBzB;;;;OAIG;YACW,kBAAkB;IAQhC,OAAO,CAAC,iBAAiB;IAgBzB,OAAO,CAAC,QAAQ;IAsBhB;;;;OAIG;YACW,YAAY;IAkC1B;;;OAGG;YACW,gBAAgB;IA+D9B;;;;;;;OAOG;YACW,WAAW;IA+HnB,mBAAmB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAW7D;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtD;;OAEG;IACG,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAQhD;;OAEG;IACG,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBhC"}

package/dist/index.cjs

@@ -246,10 +246,18 @@ function mergeSerializationOptions(userOptions) {
 }
 /**
 * Hard-cap any string to prevent unbounded growth.
+*
+* The cut never splits a UTF-16 surrogate pair: if it would land immediately
+* after a lone high surrogate (U+D800..U+DBFF), it backs off one code unit so
+* the pair is dropped as a whole. `JSON.stringify` emits a lone `\ud83d` for a
+* split pair, which PostgreSQL rejects on a jsonb cast with 22P02
+* ("Unicode low surrogate must follow a high surrogate").
 */
 function truncateString(s, maxChars) {
 	if (s.length <= maxChars) return s;
-	return s.slice(0, maxChars) + "…[truncated]";
+	const code = s.charCodeAt(maxChars - 1);
+	const safeEnd = code >= 55296 && code <= 56319 ? maxChars - 1 : maxChars;
+	return s.slice(0, safeEnd) + "…[truncated]";
 }
 function formatSerializationError(error) {
 	return `[${error instanceof Error ? truncateString(error.message, 256) : "unknown error"}]`;
@@ -7123,8 +7131,8 @@ const FLUSH_SUCCEEDED = { failed: false };
 var MastraStorageExporter = class extends BaseExporter {
 	name = "mastra-storage-exporter";
 	#config;
-	#isInitializing = false;
-	#initPromises = /* @__PURE__ */ new Set();
+	#initializationPromise;
+	#wasUnavailable = false;
 	#eventBuffer;
 	#storage;
 	#observabilityStorage;
@@ -7149,41 +7157,56 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Initialize the exporter (called after all dependencies are ready)
 	*/
 	async init(options) {
+		this.#emitDropEvent = options.emitDropEvent;
+		this.#storage = options.mastra?.getStorage();
+		if (!this.#storage) {
+			this.logger.warn("MastraStorageExporter disabled: Storage not available. Traces will not be persisted.");
+			return;
+		}
+		await this.ensureInitialized();
+	}
+	warnUnavailable(message, error) {
+		if (this.#wasUnavailable) return;
+		this.#wasUnavailable = true;
+		if (error === void 0) {
+			this.logger.warn(message);
+			return;
+		}
+		this.logger.warn(message, { error: error instanceof Error ? error.message : String(error) });
+	}
+	async initializeStorage() {
+		const storage = this.#storage;
+		if (!storage) return;
 		try {
-			this.#isInitializing = true;
-			this.#emitDropEvent = options.emitDropEvent;
-			this.#storage = options.mastra?.getStorage();
-			if (!this.#storage) {
-				this.logger.warn("MastraStorageExporter disabled: Storage not available. Traces will not be persisted.");
-				return;
-			}
-			this.#observabilityStorage = await this.#storage.getStore("observability");
-			if (!this.#observabilityStorage) {
-				this.logger.warn("MastraStorageExporter disabled: Observability storage not available. Traces will not be persisted.");
-				return;
-			}
-			if (!this.#resolvedStrategy) {
-				this.#resolvedStrategy = resolveTracingStorageStrategy(this.#config, this.#observabilityStorage, this.#storage.constructor.name, this.logger);
-				this.logger.debug("tracing storage exporter initialized", {
-					strategy: this.#resolvedStrategy,
-					source: this.#config.strategy !== "auto" ? "user" : "auto",
-					storageAdapter: this.#storage.constructor.name,
-					maxBatchSize: this.#config.maxBatchSize,
-					maxBatchWaitMs: this.#config.maxBatchWaitMs
-				});
-			}
-			if (this.#resolvedStrategy) this.#eventBuffer.init({ strategy: this.#resolvedStrategy });
-		} finally {
-			this.#isInitializing = false;
-			/**
-			* Assumes caller waits until export of a parent span is completed before calling
-			* export for child spans , order is not relevant for resolve
-			*/
-			this.#initPromises.forEach((resolve) => {
-				resolve();
-			});
-			this.#initPromises.clear();
+			this.#observabilityStorage = await storage.getStore("observability");
+		} catch (error) {
+			this.warnUnavailable("MastraStorageExporter unavailable: Failed to initialize observability storage. Traces will not be persisted until storage becomes available.", error);
+			return;
+		}
+		if (!this.#observabilityStorage) {
+			this.warnUnavailable("MastraStorageExporter unavailable: Observability storage not available. Traces will not be persisted until storage becomes available.");
+			return;
 		}
+		this.#resolvedStrategy = resolveTracingStorageStrategy(this.#config, this.#observabilityStorage, storage.constructor.name, this.logger);
+		this.#eventBuffer.init({ strategy: this.#resolvedStrategy });
+		this.logger.debug("tracing storage exporter initialized", {
+			strategy: this.#resolvedStrategy,
+			source: this.#config.strategy !== "auto" ? "user" : "auto",
+			storageAdapter: storage.constructor.name,
+			maxBatchSize: this.#config.maxBatchSize,
+			maxBatchWaitMs: this.#config.maxBatchWaitMs
+		});
+		if (this.#wasUnavailable) {
+			this.#wasUnavailable = false;
+			this.logger.info("MastraStorageExporter recovered: Observability storage is available. Traces will be persisted.");
+		}
+	}
+	async ensureInitialized() {
+		if (this.#observabilityStorage || !this.#storage) return;
+		this.#initializationPromise ??= this.initializeStorage().finally(() => {
+			this.#initializationPromise = void 0;
+		});
+		await this.#initializationPromise;
 	}
 	/**
 	* Checks if buffer should be flushed based on size or time triggers
@@ -7435,7 +7458,7 @@ var MastraStorageExporter = class extends BaseExporter {
 		}
 	}
 	async _exportTracingEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) {
 			this.logger.debug("Cannot store traces. Observability storage is not initialized");
 			return;
@@ -7444,21 +7467,10 @@ var MastraStorageExporter = class extends BaseExporter {
 		await this.handleBatchedFlush();
 	}
 	/**
-	* Resolves when an ongoing init call is finished
-	* Doesn't wait for the caller to call init
-	* @returns
-	*/
-	async waitForInit() {
-		if (!this.#isInitializing) return;
-		return new Promise((resolve) => {
-			this.#initPromises.add(resolve);
-		});
-	}
-	/**
 	* Handle metric events — buffer for batch flush.
 	*/
 	async onMetricEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();
@@ -7467,7 +7479,7 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Handle log events — buffer for batch flush.
 	*/
 	async onLogEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();
@@ -7476,7 +7488,7 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Handle score events — buffer for batch flush.
 	*/
 	async onScoreEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();
@@ -7485,7 +7497,7 @@ var MastraStorageExporter = class extends BaseExporter {
 	* Handle feedback events — buffer for batch flush.
 	*/
 	async onFeedbackEvent(event) {
-		await this.waitForInit();
+		await this.ensureInitialized();
 		if (!this.#observabilityStorage) return;
 		this.#eventBuffer.addEvent(event);
 		await this.handleBatchedFlush();