@mastra/loggers 1.3.4-alpha.0 → 1.3.5-alpha.1

package/README.md

@@ -69,6 +69,22 @@ const upstashTransport = new UpstashTransport({
 
 `HttpTransport` sends batches of structured log records to an HTTP endpoint and supports request headers, batching, retry, and flush configuration. Use it for application-specific collectors and hosted logging gateways.
 
+Logs wait in an in-memory buffer until they are sent. `maxBufferSize` caps that buffer so an unreachable endpoint can't exhaust memory. It defaults to 10,000 records and is never lower than `batchSize`. When the buffer is full, the oldest records are dropped first; `getDroppedLogCount()` returns how many were dropped. `batchSize` and `maxBufferSize` must be positive integers, otherwise the constructor throws.
+
+```typescript
+import { HttpTransport } from '@mastra/loggers/http';
+
+const httpTransport = new HttpTransport({
+  url: 'https://logs.example.com/ingest',
+  headers: { Authorization: `Bearer ${process.env.LOG_TOKEN}` },
+  batchSize: 100,
+  flushInterval: 10_000,
+  maxBufferSize: 5_000,
+});
+
+const droppedLogs = httpTransport.getDroppedLogCount();
+```
+
 - [`PinoLogger` reference](https://mastra.ai/reference/logging/pino-logger)
 
 ## Changelog

package/dist/docs/SKILL.md

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

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.3.4-alpha.0",
+  "version": "1.3.5-alpha.1",
   "package": "@mastra/loggers",
   "exports": {},
   "modules": {}

package/dist/docs/references/reference-file-based-agents-logger.md

@@ -4,8 +4,6 @@
 
 # Logger
 
-> **Beta:** Breaking changes may occur without a major version bump until the API is stable.
-
 Mastra sets the project's [logger](https://mastra.ai/docs/observability/logging) from a `logger.ts` file directly under `src/mastra/`. The file default-exports a logger, which replaces the built-in `ConsoleLogger` used across agents, workflows, and other components.
 
 Use this page for the file-based convention. For log levels, transports, and provider details, see [logging](https://mastra.ai/docs/observability/logging).

package/dist/file/index.cjs

@@ -1,6 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _mastra_core_logger = require("@mastra/core/logger");
 let fs = require("fs");
+let readline = require("readline");
 //#region src/file/index.ts
 var FileTransport = class extends _mastra_core_logger.LoggerTransport {
 	path;
@@ -43,39 +44,7 @@ var FileTransport = class extends _mastra_core_logger.LoggerTransport {
 	}
 	async listLogs(params) {
 		try {
-			const { fromDate, toDate, logLevel, filters, returnPaginationResults: returnPaginationResultsInput, page: pageInput, perPage: perPageInput } = params || {};
-			const page = pageInput === 0 ? 1 : pageInput ?? 1;
-			const perPage = perPageInput ?? 100;
-			const returnPaginationResults = returnPaginationResultsInput ?? true;
-			let filteredLogs = (0, fs.readFileSync)(this.path, "utf8").split("\n").filter(Boolean).flatMap((line) => {
-				try {
-					return [JSON.parse(line)];
-				} catch {
-					return [];
-				}
-			}).filter((record) => record !== null && typeof record === "object");
-			if (filters) filteredLogs = filteredLogs.filter((log) => Object.entries(filters || {}).every(([key, value]) => log[key] === value));
-			if (logLevel) filteredLogs = filteredLogs.filter((log) => log.level === logLevel);
-			if (fromDate) filteredLogs = filteredLogs.filter((log) => new Date(log.time).getTime() >= fromDate.getTime());
-			if (toDate) filteredLogs = filteredLogs.filter((log) => new Date(log.time).getTime() <= toDate.getTime());
-			if (!returnPaginationResults) return {
-				logs: filteredLogs,
-				total: filteredLogs.length,
-				page,
-				perPage: filteredLogs.length,
-				hasMore: false
-			};
-			const total = filteredLogs.length;
-			const resolvedPerPage = perPage || 100;
-			const start = (page - 1) * resolvedPerPage;
-			const end = start + resolvedPerPage;
-			return {
-				logs: filteredLogs.slice(start, end),
-				total,
-				page,
-				perPage: resolvedPerPage,
-				hasMore: end < total
-			};
+			return await this.#queryLogs(params || {});
 		} catch (error) {
 			console.error("Error getting logs from file:", error);
 			return {
@@ -87,27 +56,17 @@ var FileTransport = class extends _mastra_core_logger.LoggerTransport {
 			};
 		}
 	}
-	async listLogsByRunId({ runId, fromDate, toDate, logLevel, filters, page: pageInput, perPage: perPageInput }) {
+	async listLogsByRunId({ runId, fromDate, toDate, logLevel, filters, page, perPage }) {
 		try {
-			const page = pageInput === 0 ? 1 : pageInput ?? 1;
-			const perPage = perPageInput ?? 100;
-			const logs = (await this.listLogs({
+			return await this.#queryLogs({
+				runId,
 				fromDate,
 				toDate,
 				logLevel,
-				filters
-			}))?.logs?.filter((log) => log?.runId === runId) || [];
-			const total = logs.length;
-			const resolvedPerPage = perPage || 100;
-			const start = (page - 1) * resolvedPerPage;
-			const end = start + resolvedPerPage;
-			return {
-				logs: logs.slice(start, end),
-				total,
+				filters,
 				page,
-				perPage: resolvedPerPage,
-				hasMore: end < total
-			};
+				perPage
+			});
 		} catch (error) {
 			console.error("Error getting logs by runId from file:", error);
 			return {
@@ -119,6 +78,54 @@ var FileTransport = class extends _mastra_core_logger.LoggerTransport {
 			};
 		}
 	}
+	/**
+	* Streams the log file line by line, counting every matching record but
+	* retaining only the requested page (or all matches when pagination is off).
+	*/
+	async #queryLogs({ runId, fromDate, toDate, logLevel, filters, returnPaginationResults = true, page: pageInput, perPage: perPageInput }) {
+		const page = pageInput === 0 ? 1 : pageInput ?? 1;
+		const perPage = (perPageInput ?? 100) || 100;
+		const start = (page - 1) * perPage;
+		const end = start + perPage;
+		const filterEntries = Object.entries(filters ?? {});
+		const logs = [];
+		let total = 0;
+		const lines = (0, readline.createInterface)({
+			input: (0, fs.createReadStream)(this.path, "utf8"),
+			crlfDelay: Infinity
+		});
+		for await (const line of lines) {
+			if (!line.trim()) continue;
+			let log;
+			try {
+				log = JSON.parse(line);
+			} catch {
+				continue;
+			}
+			if (log === null || typeof log !== "object") continue;
+			if (runId !== void 0 && log.runId !== runId) continue;
+			if (!filterEntries.every(([key, value]) => log[key] === value)) continue;
+			if (logLevel && log.level !== logLevel) continue;
+			if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;
+			if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;
+			if (!returnPaginationResults || total >= start && total < end) logs.push(log);
+			total++;
+		}
+		if (!returnPaginationResults) return {
+			logs,
+			total,
+			page,
+			perPage: total,
+			hasMore: false
+		};
+		return {
+			logs,
+			total,
+			page,
+			perPage,
+			hasMore: end < total
+		};
+	}
 };
 //#endregion
 exports.FileTransport = FileTransport;

package/dist/file/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["LoggerTransport"],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createWriteStream, existsSync, readFileSync } from 'node:fs';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      console.info(this.path);\n      throw new Error('File path does not exist');\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk: any) => void) {\n    try {\n      this.fileStream.write(chunk);\n    } catch (error) {\n      console.error('Error parsing log entry:', error);\n    }\n    callback(null, chunk);\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      const {\n        fromDate,\n        toDate,\n        logLevel,\n        filters,\n        returnPaginationResults: returnPaginationResultsInput,\n        page: pageInput,\n        perPage: perPageInput,\n      } = params || {};\n\n      const page = pageInput === 0 ? 1 : (pageInput ?? 1);\n      const perPage = perPageInput ?? 100;\n      const returnPaginationResults = returnPaginationResultsInput ?? true;\n\n      const logs = readFileSync(this.path, 'utf8')\n        .split('\\n')\n        .filter(Boolean)\n        .flatMap(line => {\n          try {\n            return [JSON.parse(line)];\n          } catch {\n            return [];\n          }\n        });\n\n      let filteredLogs = logs.filter(record => record !== null && typeof record === 'object');\n\n      if (filters) {\n        filteredLogs = filteredLogs.filter(log =>\n          Object.entries(filters || {}).every(([key, value]) => log[key as keyof BaseLogMessage] === value),\n        );\n      }\n\n      if (logLevel) {\n        filteredLogs = filteredLogs.filter(log => log.level === logLevel);\n      }\n\n      if (fromDate) {\n        filteredLogs = filteredLogs.filter(log => new Date(log.time)?.getTime() >= fromDate!.getTime());\n      }\n\n      if (toDate) {\n        filteredLogs = filteredLogs.filter(log => new Date(log.time)?.getTime() <= toDate!.getTime());\n      }\n\n      if (!returnPaginationResults) {\n        return {\n          logs: filteredLogs,\n          total: filteredLogs.length,\n          page,\n          perPage: filteredLogs.length,\n          hasMore: false,\n        };\n      }\n\n      const total = filteredLogs.length;\n      const resolvedPerPage = perPage || 100;\n      const start = (page - 1) * resolvedPerPage;\n      const end = start + resolvedPerPage;\n      const paginatedLogs = filteredLogs.slice(start, end);\n      const hasMore = end < total;\n\n      return {\n        logs: paginatedLogs,\n        total,\n        page,\n        perPage: resolvedPerPage,\n        hasMore,\n      };\n    } catch (error) {\n      console.error('Error getting logs from file:', error);\n      return {\n        logs: [],\n        total: 0,\n        page: 0,\n        perPage: 0,\n        hasMore: false,\n      };\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      const page = pageInput === 0 ? 1 : (pageInput ?? 1);\n      const perPage = perPageInput ?? 100;\n      const allLogs = await this.listLogs({ fromDate, toDate, logLevel, filters });\n      const logs = (allLogs?.logs?.filter(log => log?.runId === runId) || []) as BaseLogMessage[];\n      const total = logs.length;\n      const resolvedPerPage = perPage || 100;\n      const start = (page - 1) * resolvedPerPage;\n      const end = start + resolvedPerPage;\n      const paginatedLogs = logs.slice(start, end);\n      const hasMore = end < total;\n\n      return {\n        logs: paginatedLogs,\n        total,\n        page,\n        perPage: resolvedPerPage,\n        hasMore,\n      };\n    } catch (error) {\n      console.error('Error getting logs by runId from file:', error);\n      return {\n        logs: [],\n        total: 0,\n        page: 0,\n        perPage: 0,\n        hasMore: false,\n      };\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["LoggerTransport","#queryLogs"],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createReadStream, createWriteStream, existsSync } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      console.info(this.path);\n      throw new Error('File path does not exist');\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk: any) => void) {\n    try {\n      this.fileStream.write(chunk);\n    } catch (error) {\n      console.error('Error parsing log entry:', error);\n    }\n    callback(null, chunk);\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      return await this.#queryLogs(params || {});\n    } catch (error) {\n      console.error('Error getting logs from file:', error);\n      return { logs: [], total: 0, page: 0, perPage: 0, hasMore: false };\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      return await this.#queryLogs({ runId, fromDate, toDate, logLevel, filters, page, perPage });\n    } catch (error) {\n      console.error('Error getting logs by runId from file:', error);\n      return { logs: [], total: 0, page: 0, perPage: 0, hasMore: false };\n    }\n  }\n\n  /**\n   * Streams the log file line by line, counting every matching record but\n   * retaining only the requested page (or all matches when pagination is off).\n   */\n  async #queryLogs({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    returnPaginationResults = true,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId?: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }) {\n    const page = pageInput === 0 ? 1 : (pageInput ?? 1);\n    const perPage = (perPageInput ?? 100) || 100;\n    const start = (page - 1) * perPage;\n    const end = start + perPage;\n    const filterEntries = Object.entries(filters ?? {});\n\n    const logs: BaseLogMessage[] = [];\n    let total = 0;\n\n    const lines = createInterface({ input: createReadStream(this.path, 'utf8'), crlfDelay: Infinity });\n    for await (const line of lines) {\n      if (!line.trim()) continue;\n\n      let log: any;\n      try {\n        log = JSON.parse(line);\n      } catch {\n        continue;\n      }\n\n      if (log === null || typeof log !== 'object') continue;\n      if (runId !== undefined && log.runId !== runId) continue;\n      if (!filterEntries.every(([key, value]) => log[key] === value)) continue;\n      if (logLevel && log.level !== logLevel) continue;\n      if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;\n      if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;\n\n      if (!returnPaginationResults || (total >= start && total < end)) {\n        logs.push(log);\n      }\n      total++;\n    }\n\n    if (!returnPaginationResults) {\n      return { logs, total, page, perPage: total, hasMore: false };\n    }\n\n    return { logs, total, page, perPage, hasMore: end < total };\n  }\n}\n"],"mappings":"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"}

package/dist/file/index.d.ts

@@ -2,6 +2,7 @@ import type { WriteStream } from 'node:fs';
 import { LoggerTransport } from '@mastra/core/logger';
 import type { BaseLogMessage, LogLevel } from '@mastra/core/logger';
 export declare class FileTransport extends LoggerTransport {
+    #private;
     path: string;
     fileStream: WriteStream;
     constructor({ path }: {
@@ -26,7 +27,7 @@ export declare class FileTransport extends LoggerTransport {
         perPage: number;
         hasMore: boolean;
     }>;
-    listLogsByRunId({ runId, fromDate, toDate, logLevel, filters, page: pageInput, perPage: perPageInput, }: {
+    listLogsByRunId({ runId, fromDate, toDate, logLevel, filters, page, perPage, }: {
         runId: string;
         fromDate?: Date;
         toDate?: Date;

package/dist/file/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,qBAAa,aAAc,SAAQ,eAAe;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAUrC;IAED,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,QAO5F;IAED,MAAM,CAAC,QAAQ,EAAE,QAAQ,QAKxB;IAED,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAUxF;IAGD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,QAKxC;IAEK,QAAQ,CAAC,MAAM,CAAC,EAAE;QACtB,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,IAAI,EAAE,cAAc,EAAE,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAiFD;IAEK,eAAe,CAAC,EACpB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,EAAE,SAAS,EACf,OAAO,EAAE,YAAY,GACtB,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,IAAI,EAAE,cAAc,EAAE,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CA8BD;CACF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/file/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG3C,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpE,qBAAa,aAAc,SAAQ,eAAe;;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,WAAW,CAAC;IACxB,YAAY,EAAE,IAAI,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAUrC;IAED,UAAU,CAAC,KAAK,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,QAO5F;IAED,MAAM,CAAC,QAAQ,EAAE,QAAQ,QAKxB;IAED,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,KAAK,IAAI,GAAG,OAAO,CAUxF;IAGD,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,QAKxC;IAEK,QAAQ,CAAC,MAAM,CAAC,EAAE;QACtB,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,IAAI,EAAE,cAAc,EAAE,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAOD;IAEK,eAAe,CAAC,EACpB,KAAK,EACL,QAAQ,EACR,MAAM,EACN,QAAQ,EACR,OAAO,EACP,IAAI,EACJ,OAAO,GACR,EAAE;QACD,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,CAAC,EAAE,IAAI,CAAC;QAChB,MAAM,CAAC,EAAE,IAAI,CAAC;QACd,QAAQ,CAAC,EAAE,QAAQ,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC;QACV,IAAI,EAAE,cAAc,EAAE,CAAC;QACvB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,OAAO,CAAC;KAClB,CAAC,CAOD;CAgEF"}

package/dist/file/index.js

@@ -1,5 +1,6 @@
 import { LoggerTransport } from "@mastra/core/logger";
-import { createWriteStream, existsSync, readFileSync } from "fs";
+import { createReadStream, createWriteStream, existsSync } from "fs";
+import { createInterface } from "readline";
 //#region src/file/index.ts
 var FileTransport = class extends LoggerTransport {
 	path;
@@ -42,39 +43,7 @@ var FileTransport = class extends LoggerTransport {
 	}
 	async listLogs(params) {
 		try {
-			const { fromDate, toDate, logLevel, filters, returnPaginationResults: returnPaginationResultsInput, page: pageInput, perPage: perPageInput } = params || {};
-			const page = pageInput === 0 ? 1 : pageInput ?? 1;
-			const perPage = perPageInput ?? 100;
-			const returnPaginationResults = returnPaginationResultsInput ?? true;
-			let filteredLogs = readFileSync(this.path, "utf8").split("\n").filter(Boolean).flatMap((line) => {
-				try {
-					return [JSON.parse(line)];
-				} catch {
-					return [];
-				}
-			}).filter((record) => record !== null && typeof record === "object");
-			if (filters) filteredLogs = filteredLogs.filter((log) => Object.entries(filters || {}).every(([key, value]) => log[key] === value));
-			if (logLevel) filteredLogs = filteredLogs.filter((log) => log.level === logLevel);
-			if (fromDate) filteredLogs = filteredLogs.filter((log) => new Date(log.time).getTime() >= fromDate.getTime());
-			if (toDate) filteredLogs = filteredLogs.filter((log) => new Date(log.time).getTime() <= toDate.getTime());
-			if (!returnPaginationResults) return {
-				logs: filteredLogs,
-				total: filteredLogs.length,
-				page,
-				perPage: filteredLogs.length,
-				hasMore: false
-			};
-			const total = filteredLogs.length;
-			const resolvedPerPage = perPage || 100;
-			const start = (page - 1) * resolvedPerPage;
-			const end = start + resolvedPerPage;
-			return {
-				logs: filteredLogs.slice(start, end),
-				total,
-				page,
-				perPage: resolvedPerPage,
-				hasMore: end < total
-			};
+			return await this.#queryLogs(params || {});
 		} catch (error) {
 			console.error("Error getting logs from file:", error);
 			return {
@@ -86,27 +55,17 @@ var FileTransport = class extends LoggerTransport {
 			};
 		}
 	}
-	async listLogsByRunId({ runId, fromDate, toDate, logLevel, filters, page: pageInput, perPage: perPageInput }) {
+	async listLogsByRunId({ runId, fromDate, toDate, logLevel, filters, page, perPage }) {
 		try {
-			const page = pageInput === 0 ? 1 : pageInput ?? 1;
-			const perPage = perPageInput ?? 100;
-			const logs = (await this.listLogs({
+			return await this.#queryLogs({
+				runId,
 				fromDate,
 				toDate,
 				logLevel,
-				filters
-			}))?.logs?.filter((log) => log?.runId === runId) || [];
-			const total = logs.length;
-			const resolvedPerPage = perPage || 100;
-			const start = (page - 1) * resolvedPerPage;
-			const end = start + resolvedPerPage;
-			return {
-				logs: logs.slice(start, end),
-				total,
+				filters,
 				page,
-				perPage: resolvedPerPage,
-				hasMore: end < total
-			};
+				perPage
+			});
 		} catch (error) {
 			console.error("Error getting logs by runId from file:", error);
 			return {
@@ -118,6 +77,54 @@ var FileTransport = class extends LoggerTransport {
 			};
 		}
 	}
+	/**
+	* Streams the log file line by line, counting every matching record but
+	* retaining only the requested page (or all matches when pagination is off).
+	*/
+	async #queryLogs({ runId, fromDate, toDate, logLevel, filters, returnPaginationResults = true, page: pageInput, perPage: perPageInput }) {
+		const page = pageInput === 0 ? 1 : pageInput ?? 1;
+		const perPage = (perPageInput ?? 100) || 100;
+		const start = (page - 1) * perPage;
+		const end = start + perPage;
+		const filterEntries = Object.entries(filters ?? {});
+		const logs = [];
+		let total = 0;
+		const lines = createInterface({
+			input: createReadStream(this.path, "utf8"),
+			crlfDelay: Infinity
+		});
+		for await (const line of lines) {
+			if (!line.trim()) continue;
+			let log;
+			try {
+				log = JSON.parse(line);
+			} catch {
+				continue;
+			}
+			if (log === null || typeof log !== "object") continue;
+			if (runId !== void 0 && log.runId !== runId) continue;
+			if (!filterEntries.every(([key, value]) => log[key] === value)) continue;
+			if (logLevel && log.level !== logLevel) continue;
+			if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;
+			if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;
+			if (!returnPaginationResults || total >= start && total < end) logs.push(log);
+			total++;
+		}
+		if (!returnPaginationResults) return {
+			logs,
+			total,
+			page,
+			perPage: total,
+			hasMore: false
+		};
+		return {
+			logs,
+			total,
+			page,
+			perPage,
+			hasMore: end < total
+		};
+	}
 };
 //#endregion
 export { FileTransport };

package/dist/file/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createWriteStream, existsSync, readFileSync } from 'node:fs';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      console.info(this.path);\n      throw new Error('File path does not exist');\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk: any) => void) {\n    try {\n      this.fileStream.write(chunk);\n    } catch (error) {\n      console.error('Error parsing log entry:', error);\n    }\n    callback(null, chunk);\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      const {\n        fromDate,\n        toDate,\n        logLevel,\n        filters,\n        returnPaginationResults: returnPaginationResultsInput,\n        page: pageInput,\n        perPage: perPageInput,\n      } = params || {};\n\n      const page = pageInput === 0 ? 1 : (pageInput ?? 1);\n      const perPage = perPageInput ?? 100;\n      const returnPaginationResults = returnPaginationResultsInput ?? true;\n\n      const logs = readFileSync(this.path, 'utf8')\n        .split('\\n')\n        .filter(Boolean)\n        .flatMap(line => {\n          try {\n            return [JSON.parse(line)];\n          } catch {\n            return [];\n          }\n        });\n\n      let filteredLogs = logs.filter(record => record !== null && typeof record === 'object');\n\n      if (filters) {\n        filteredLogs = filteredLogs.filter(log =>\n          Object.entries(filters || {}).every(([key, value]) => log[key as keyof BaseLogMessage] === value),\n        );\n      }\n\n      if (logLevel) {\n        filteredLogs = filteredLogs.filter(log => log.level === logLevel);\n      }\n\n      if (fromDate) {\n        filteredLogs = filteredLogs.filter(log => new Date(log.time)?.getTime() >= fromDate!.getTime());\n      }\n\n      if (toDate) {\n        filteredLogs = filteredLogs.filter(log => new Date(log.time)?.getTime() <= toDate!.getTime());\n      }\n\n      if (!returnPaginationResults) {\n        return {\n          logs: filteredLogs,\n          total: filteredLogs.length,\n          page,\n          perPage: filteredLogs.length,\n          hasMore: false,\n        };\n      }\n\n      const total = filteredLogs.length;\n      const resolvedPerPage = perPage || 100;\n      const start = (page - 1) * resolvedPerPage;\n      const end = start + resolvedPerPage;\n      const paginatedLogs = filteredLogs.slice(start, end);\n      const hasMore = end < total;\n\n      return {\n        logs: paginatedLogs,\n        total,\n        page,\n        perPage: resolvedPerPage,\n        hasMore,\n      };\n    } catch (error) {\n      console.error('Error getting logs from file:', error);\n      return {\n        logs: [],\n        total: 0,\n        page: 0,\n        perPage: 0,\n        hasMore: false,\n      };\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      const page = pageInput === 0 ? 1 : (pageInput ?? 1);\n      const perPage = perPageInput ?? 100;\n      const allLogs = await this.listLogs({ fromDate, toDate, logLevel, filters });\n      const logs = (allLogs?.logs?.filter(log => log?.runId === runId) || []) as BaseLogMessage[];\n      const total = logs.length;\n      const resolvedPerPage = perPage || 100;\n      const start = (page - 1) * resolvedPerPage;\n      const end = start + resolvedPerPage;\n      const paginatedLogs = logs.slice(start, end);\n      const hasMore = end < total;\n\n      return {\n        logs: paginatedLogs,\n        total,\n        page,\n        perPage: resolvedPerPage,\n        hasMore,\n      };\n    } catch (error) {\n      console.error('Error getting logs by runId from file:', error);\n      return {\n        logs: [],\n        total: 0,\n        page: 0,\n        perPage: 0,\n        hasMore: false,\n      };\n    }\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":["#queryLogs"],"sources":["../../src/file/index.ts"],"sourcesContent":["import type { WriteStream } from 'node:fs';\nimport { createReadStream, createWriteStream, existsSync } from 'node:fs';\nimport { createInterface } from 'node:readline';\nimport { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\nexport class FileTransport extends LoggerTransport {\n  path: string;\n  fileStream: WriteStream;\n  constructor({ path }: { path: string }) {\n    super({ objectMode: true });\n    this.path = path;\n\n    if (!existsSync(this.path)) {\n      console.info(this.path);\n      throw new Error('File path does not exist');\n    }\n\n    this.fileStream = createWriteStream(this.path, { flags: 'a' });\n  }\n\n  _transform(chunk: any, _encoding: string, callback: (error: Error | null, chunk: any) => void) {\n    try {\n      this.fileStream.write(chunk);\n    } catch (error) {\n      console.error('Error parsing log entry:', error);\n    }\n    callback(null, chunk);\n  }\n\n  _flush(callback: Function) {\n    // End the file stream when transform stream ends\n    this.fileStream.end(() => {\n      callback();\n    });\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  // Clean up resources\n  _destroy(error: Error, callback: Function) {\n    if (this.fileStream) {\n      this.fileStream.destroy(error);\n    }\n    callback(error);\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean; // default true\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      return await this.#queryLogs(params || {});\n    } catch (error) {\n      console.error('Error getting logs from file:', error);\n      return { logs: [], total: 0, page: 0, perPage: 0, hasMore: false };\n    }\n  }\n\n  async listLogsByRunId({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    try {\n      return await this.#queryLogs({ runId, fromDate, toDate, logLevel, filters, page, perPage });\n    } catch (error) {\n      console.error('Error getting logs by runId from file:', error);\n      return { logs: [], total: 0, page: 0, perPage: 0, hasMore: false };\n    }\n  }\n\n  /**\n   * Streams the log file line by line, counting every matching record but\n   * retaining only the requested page (or all matches when pagination is off).\n   */\n  async #queryLogs({\n    runId,\n    fromDate,\n    toDate,\n    logLevel,\n    filters,\n    returnPaginationResults = true,\n    page: pageInput,\n    perPage: perPageInput,\n  }: {\n    runId?: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }) {\n    const page = pageInput === 0 ? 1 : (pageInput ?? 1);\n    const perPage = (perPageInput ?? 100) || 100;\n    const start = (page - 1) * perPage;\n    const end = start + perPage;\n    const filterEntries = Object.entries(filters ?? {});\n\n    const logs: BaseLogMessage[] = [];\n    let total = 0;\n\n    const lines = createInterface({ input: createReadStream(this.path, 'utf8'), crlfDelay: Infinity });\n    for await (const line of lines) {\n      if (!line.trim()) continue;\n\n      let log: any;\n      try {\n        log = JSON.parse(line);\n      } catch {\n        continue;\n      }\n\n      if (log === null || typeof log !== 'object') continue;\n      if (runId !== undefined && log.runId !== runId) continue;\n      if (!filterEntries.every(([key, value]) => log[key] === value)) continue;\n      if (logLevel && log.level !== logLevel) continue;\n      if (fromDate && !(new Date(log.time).getTime() >= fromDate.getTime())) continue;\n      if (toDate && !(new Date(log.time).getTime() <= toDate.getTime())) continue;\n\n      if (!returnPaginationResults || (total >= start && total < end)) {\n        logs.push(log);\n      }\n      total++;\n    }\n\n    if (!returnPaginationResults) {\n      return { logs, total, page, perPage: total, hasMore: false };\n    }\n\n    return { logs, total, page, perPage, hasMore: end < total };\n  }\n}\n"],"mappings":"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"}

package/dist/http/index.cjs

@@ -1,6 +1,25 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let _mastra_core_logger = require("@mastra/core/logger");
 //#region src/http/index.ts
+var HttpResponseError = class extends Error {
+	status;
+	retryAfterMs;
+	constructor(status, statusText, retryAfterMs) {
+		super(`HTTP ${status}: ${statusText}`);
+		this.status = status;
+		this.retryAfterMs = retryAfterMs;
+	}
+};
+function isRetryableStatus(status) {
+	return status === 408 || status === 425 || status === 429 || status >= 500;
+}
+function parseRetryAfter(headers) {
+	const value = headers?.get("retry-after")?.trim();
+	if (!value) return void 0;
+	if (/^\d+$/.test(value)) return Number(value) * 1e3;
+	const date = Date.parse(value);
+	return Number.isNaN(date) ? void 0 : Math.max(0, date - Date.now());
+}
 var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 	url;
 	method;
@@ -10,6 +29,10 @@ var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 	timeout;
 	retryOptions;
 	logBuffer;
+	maxBufferSize;
+	droppedLogCount = 0;
+	flushPromise = null;
+	flushRequested = false;
 	lastFlush;
 	flushIntervalId;
 	constructor(options) {
@@ -21,7 +44,7 @@ var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 			"Content-Type": "application/json",
 			...options.headers
 		};
-		this.batchSize = options.batchSize || 100;
+		this.batchSize = options.batchSize ?? 100;
 		this.flushInterval = options.flushInterval || 1e4;
 		this.timeout = options.timeout || 3e4;
 		this.retryOptions = {
@@ -29,13 +52,13 @@ var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 			retryDelay: options.retryOptions?.retryDelay ?? 1e3,
 			exponentialBackoff: options.retryOptions?.exponentialBackoff ?? true
 		};
+		if (!Number.isInteger(this.batchSize) || this.batchSize < 1) throw new Error("HttpTransport batchSize must be a positive integer");
+		const maxBufferSize = options.maxBufferSize ?? 1e4;
+		if (!Number.isInteger(maxBufferSize) || maxBufferSize < 1) throw new Error("HttpTransport maxBufferSize must be a positive integer");
+		this.maxBufferSize = Math.max(maxBufferSize, this.batchSize);
 		this.logBuffer = [];
 		this.lastFlush = Date.now();
-		this.flushIntervalId = setInterval(() => {
-			this._flush().catch((err) => {
-				console.error("Error flushing logs to HTTP endpoint:", err);
-			});
-		}, this.flushInterval);
+		this.flushIntervalId = setInterval(() => this.requestFlush(), this.flushInterval);
 	}
 	async makeHttpRequest(data, retryCount = 0) {
 		const controller = new AbortController();
@@ -49,27 +72,69 @@ var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 				signal: controller.signal
 			});
 			clearTimeout(timeoutId);
-			if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+			if (!response.ok) throw new HttpResponseError(response.status, response.statusText, parseRetryAfter(response.headers));
 			return response;
 		} catch (error) {
 			clearTimeout(timeoutId);
-			if (retryCount < this.retryOptions.maxRetries) {
-				const delay = this.retryOptions.exponentialBackoff ? this.retryOptions.retryDelay * Math.pow(2, retryCount) : this.retryOptions.retryDelay;
+			if (!(error instanceof HttpResponseError && !isRetryableStatus(error.status)) && retryCount < this.retryOptions.maxRetries) {
+				const backoff = this.retryOptions.exponentialBackoff ? this.retryOptions.retryDelay * Math.pow(2, retryCount) : this.retryOptions.retryDelay;
+				const retryAfter = error instanceof HttpResponseError ? error.retryAfterMs ?? 0 : 0;
+				const delay = Math.max(backoff, Math.min(retryAfter, this.timeout));
 				await new Promise((resolve) => setTimeout(resolve, delay));
 				return this.makeHttpRequest(data, retryCount + 1);
 			}
 			throw error;
 		}
 	}
-	async _flush() {
-		if (this.logBuffer.length === 0) return;
+	enforceBufferLimit() {
+		const overflow = this.logBuffer.length - this.maxBufferSize;
+		if (overflow <= 0) return;
+		this.logBuffer.splice(0, overflow);
+		if (this.droppedLogCount === 0) console.warn(`HttpTransport: buffer exceeded maxBufferSize (${this.maxBufferSize}); dropping oldest logs. Use getDroppedLogCount() to track drops.`);
+		this.droppedLogCount += overflow;
+	}
+	requestFlush() {
+		if (this.flushPromise) {
+			this.flushRequested = true;
+			return;
+		}
+		this._flush().catch((err) => {
+			console.error("Error flushing logs to HTTP endpoint:", err);
+		});
+	}
+	_flush() {
+		if (this.flushPromise) {
+			this.flushRequested = true;
+			return this.flushPromise;
+		}
+		if (this.logBuffer.length === 0) return Promise.resolve();
+		this.flushRequested = false;
+		const flush = this.flushBatch().finally(() => {
+			this.flushPromise = null;
+		});
+		this.flushPromise = flush;
+		const continueDraining = () => {
+			if (this.logBuffer.length >= this.batchSize || this.flushRequested && this.logBuffer.length > 0) this.requestFlush();
+		};
+		flush.then(continueDraining, (error) => {
+			if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) continueDraining();
+		});
+		return flush;
+	}
+	async flushBatch() {
 		const now = Date.now();
 		const logs = this.logBuffer.splice(0, this.batchSize);
 		try {
 			await this.makeHttpRequest(logs);
 			this.lastFlush = now;
 		} catch (error) {
+			if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) {
+				this.droppedLogCount += logs.length;
+				console.warn(`HttpTransport: endpoint rejected a batch with HTTP ${error.status}; dropping ${logs.length} logs. Use getDroppedLogCount() to track drops.`);
+				throw error;
+			}
 			this.logBuffer.unshift(...logs);
+			this.enforceBufferLimit();
 			throw error;
 		}
 	}
@@ -88,9 +153,8 @@ var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 			const log = typeof chunk === "string" ? JSON.parse(chunk) : chunk;
 			if (!log.time) log.time = Date.now();
 			this.logBuffer.push(log);
-			if (this.logBuffer.length >= this.batchSize) this._flush().catch((err) => {
-				console.error("Error flushing logs to HTTP endpoint:", err);
-			});
+			this.enforceBufferLimit();
+			if (this.logBuffer.length >= this.batchSize) this.requestFlush();
 			cb(null, chunk);
 		} catch (error) {
 			cb(error);
@@ -98,11 +162,16 @@ var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 	}
 	_destroy(err, cb) {
 		clearInterval(this.flushIntervalId);
-		if (this.logBuffer.length > 0) this._flush().then(() => cb(err)).catch((flushErr) => {
-			console.error("Error in final flush:", flushErr);
-			cb(err || flushErr);
-		});
-		else cb(err);
+		if (this.logBuffer.length > 0 || this.flushPromise) {
+			const drain = async () => {
+				await this.flushPromise?.catch(() => {});
+				while (this.flushPromise || this.logBuffer.length > 0) await (this.flushPromise ?? this._flush());
+			};
+			drain().then(() => cb(err)).catch((flushErr) => {
+				console.error("Error in final flush:", flushErr);
+				cb(err || flushErr);
+			});
+		} else cb(err);
 	}
 	async listLogs(params) {
 		console.warn("HttpTransport.listLogs: This transport is write-only. Override this method to implement log retrieval.");
@@ -130,6 +199,9 @@ var HttpTransport = class extends _mastra_core_logger.LoggerTransport {
 	clearBuffer() {
 		this.logBuffer = [];
 	}
+	getDroppedLogCount() {
+		return this.droppedLogCount;
+	}
 	getLastFlushTime() {
 		return this.lastFlush;
 	}

package/dist/http/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["LoggerTransport"],"sources":["../../src/http/index.ts"],"sourcesContent":["import { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\ninterface RetryOptions {\n  maxRetries?: number;\n  retryDelay?: number;\n  exponentialBackoff?: boolean;\n}\n\ninterface HttpTransportOptions {\n  url: string;\n  method?: 'POST' | 'PUT' | 'PATCH';\n  headers?: Record<string, string>;\n  batchSize?: number;\n  flushInterval?: number;\n  timeout?: number;\n  retryOptions?: RetryOptions;\n}\n\nexport class HttpTransport extends LoggerTransport {\n  private url: string;\n  private method: string;\n  private headers: Record<string, string>;\n  private batchSize: number;\n  private flushInterval: number;\n  private timeout: number;\n  private retryOptions: Required<RetryOptions>;\n  private logBuffer: BaseLogMessage[];\n  private lastFlush: number;\n  private flushIntervalId: NodeJS.Timeout;\n\n  constructor(options: HttpTransportOptions) {\n    super({ objectMode: true });\n\n    if (!options.url) {\n      throw new Error('HTTP URL is required');\n    }\n\n    this.url = options.url;\n    this.method = options.method || 'POST';\n    this.headers = {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    };\n    this.batchSize = options.batchSize || 100;\n    this.flushInterval = options.flushInterval || 10000;\n    this.timeout = options.timeout || 30000;\n    this.retryOptions = {\n      maxRetries: options.retryOptions?.maxRetries ?? 3,\n      retryDelay: options.retryOptions?.retryDelay ?? 1000,\n      exponentialBackoff: options.retryOptions?.exponentialBackoff ?? true,\n    };\n\n    this.logBuffer = [];\n    this.lastFlush = Date.now();\n\n    // Start flush interval\n    this.flushIntervalId = setInterval(() => {\n      this._flush().catch(err => {\n        console.error('Error flushing logs to HTTP endpoint:', err);\n      });\n    }, this.flushInterval);\n  }\n\n  private async makeHttpRequest(data: any, retryCount = 0): Promise<Response> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const body = JSON.stringify({ logs: data });\n\n      const response = await fetch(this.url, {\n        method: this.method,\n        headers: this.headers,\n        body,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      return response;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (retryCount < this.retryOptions.maxRetries) {\n        const delay = this.retryOptions.exponentialBackoff\n          ? this.retryOptions.retryDelay * Math.pow(2, retryCount)\n          : this.retryOptions.retryDelay;\n\n        await new Promise(resolve => setTimeout(resolve, delay));\n        return this.makeHttpRequest(data, retryCount + 1);\n      }\n\n      throw error;\n    }\n  }\n\n  async _flush(): Promise<void> {\n    if (this.logBuffer.length === 0) {\n      return;\n    }\n\n    const now = Date.now();\n    const logs = this.logBuffer.splice(0, this.batchSize);\n\n    try {\n      await this.makeHttpRequest(logs);\n      this.lastFlush = now;\n    } catch (error) {\n      // On error, put logs back in the buffer\n      this.logBuffer.unshift(...logs);\n      throw error;\n    }\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  _transform(chunk: string, _enc: string, cb: Function): void {\n    try {\n      // Parse the log line if it's a string\n      const log = typeof chunk === 'string' ? JSON.parse(chunk) : chunk;\n\n      // Add timestamp if not present\n      if (!log.time) {\n        log.time = Date.now();\n      }\n\n      // Add to buffer\n      this.logBuffer.push(log);\n\n      // Flush if buffer reaches batch size\n      if (this.logBuffer.length >= this.batchSize) {\n        this._flush().catch(err => {\n          console.error('Error flushing logs to HTTP endpoint:', err);\n        });\n      }\n\n      // Pass through the log\n      cb(null, chunk);\n    } catch (error) {\n      cb(error);\n    }\n  }\n\n  _destroy(err: Error, cb: Function): void {\n    clearInterval(this.flushIntervalId);\n\n    // Final flush\n    if (this.logBuffer.length > 0) {\n      this._flush()\n        .then(() => cb(err))\n        .catch(flushErr => {\n          console.error('Error in final flush:', flushErr);\n          cb(err || flushErr);\n        });\n    } else {\n      cb(err);\n    }\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogs: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: params?.page ?? 1,\n      perPage: params?.perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  async listLogsByRunId({\n    runId: _runId,\n    fromDate: _fromDate,\n    toDate: _toDate,\n    logLevel: _logLevel,\n    filters: _filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogsByRunId: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: page ?? 1,\n      perPage: perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  // Utility methods\n  public getBufferedLogs(): BaseLogMessage[] {\n    return [...this.logBuffer];\n  }\n\n  public clearBuffer(): void {\n    this.logBuffer = [];\n  }\n\n  public getLastFlushTime(): number {\n    return this.lastFlush;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.cjs","names":["LoggerTransport"],"sources":["../../src/http/index.ts"],"sourcesContent":["import { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\ninterface RetryOptions {\n  maxRetries?: number;\n  retryDelay?: number;\n  exponentialBackoff?: boolean;\n}\n\ninterface HttpTransportOptions {\n  url: string;\n  method?: 'POST' | 'PUT' | 'PATCH';\n  headers?: Record<string, string>;\n  batchSize?: number;\n  flushInterval?: number;\n  timeout?: number;\n  retryOptions?: RetryOptions;\n  maxBufferSize?: number;\n}\n\nclass HttpResponseError extends Error {\n  constructor(\n    readonly status: number,\n    statusText: string,\n    readonly retryAfterMs: number | undefined,\n  ) {\n    super(`HTTP ${status}: ${statusText}`);\n  }\n}\n\n// Other 4xx responses mean the request itself is wrong and will fail the same way on every retry.\nfunction isRetryableStatus(status: number): boolean {\n  return status === 408 || status === 425 || status === 429 || status >= 500;\n}\n\n// Retry-After is either delta-seconds or an HTTP date (RFC 9110). Invalid values are ignored.\nfunction parseRetryAfter(headers: Headers | undefined): number | undefined {\n  const value = headers?.get('retry-after')?.trim();\n  if (!value) return undefined;\n  if (/^\\d+$/.test(value)) return Number(value) * 1000;\n  const date = Date.parse(value);\n  return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n}\n\nexport class HttpTransport extends LoggerTransport {\n  private url: string;\n  private method: string;\n  private headers: Record<string, string>;\n  private batchSize: number;\n  private flushInterval: number;\n  private timeout: number;\n  private retryOptions: Required<RetryOptions>;\n  private logBuffer: BaseLogMessage[];\n  private maxBufferSize: number;\n  private droppedLogCount = 0;\n  private flushPromise: Promise<void> | null = null;\n  private flushRequested = false;\n  private lastFlush: number;\n  private flushIntervalId: NodeJS.Timeout;\n\n  constructor(options: HttpTransportOptions) {\n    super({ objectMode: true });\n\n    if (!options.url) {\n      throw new Error('HTTP URL is required');\n    }\n\n    this.url = options.url;\n    this.method = options.method || 'POST';\n    this.headers = {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    };\n    this.batchSize = options.batchSize ?? 100;\n    this.flushInterval = options.flushInterval || 10000;\n    this.timeout = options.timeout || 30000;\n    this.retryOptions = {\n      maxRetries: options.retryOptions?.maxRetries ?? 3,\n      retryDelay: options.retryOptions?.retryDelay ?? 1000,\n      exponentialBackoff: options.retryOptions?.exponentialBackoff ?? true,\n    };\n\n    if (!Number.isInteger(this.batchSize) || this.batchSize < 1) {\n      throw new Error('HttpTransport batchSize must be a positive integer');\n    }\n\n    const maxBufferSize = options.maxBufferSize ?? 10_000;\n    if (!Number.isInteger(maxBufferSize) || maxBufferSize < 1) {\n      throw new Error('HttpTransport maxBufferSize must be a positive integer');\n    }\n    this.maxBufferSize = Math.max(maxBufferSize, this.batchSize);\n    this.logBuffer = [];\n    this.lastFlush = Date.now();\n\n    // Start flush interval\n    this.flushIntervalId = setInterval(() => this.requestFlush(), this.flushInterval);\n  }\n\n  private async makeHttpRequest(data: any, retryCount = 0): Promise<Response> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const body = JSON.stringify({ logs: data });\n\n      const response = await fetch(this.url, {\n        method: this.method,\n        headers: this.headers,\n        body,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new HttpResponseError(response.status, response.statusText, parseRetryAfter(response.headers));\n      }\n\n      return response;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      const isPermanent = error instanceof HttpResponseError && !isRetryableStatus(error.status);\n      if (!isPermanent && retryCount < this.retryOptions.maxRetries) {\n        const backoff = this.retryOptions.exponentialBackoff\n          ? this.retryOptions.retryDelay * Math.pow(2, retryCount)\n          : this.retryOptions.retryDelay;\n        // Honor the server's Retry-After, capped at the request timeout so a large value can't stall shutdown.\n        const retryAfter = error instanceof HttpResponseError ? (error.retryAfterMs ?? 0) : 0;\n        const delay = Math.max(backoff, Math.min(retryAfter, this.timeout));\n\n        await new Promise(resolve => setTimeout(resolve, delay));\n        return this.makeHttpRequest(data, retryCount + 1);\n      }\n\n      throw error;\n    }\n  }\n\n  private enforceBufferLimit(): void {\n    const overflow = this.logBuffer.length - this.maxBufferSize;\n    if (overflow <= 0) {\n      return;\n    }\n\n    this.logBuffer.splice(0, overflow);\n    if (this.droppedLogCount === 0) {\n      console.warn(\n        `HttpTransport: buffer exceeded maxBufferSize (${this.maxBufferSize}); dropping oldest logs. Use getDroppedLogCount() to track drops.`,\n      );\n    }\n    this.droppedLogCount += overflow;\n  }\n\n  // Internal fire-and-forget flush. While a request is in flight this only records the request, so writes\n  // during a slow or retrying request don't each attach another handler to the pending promise.\n  private requestFlush(): void {\n    if (this.flushPromise) {\n      this.flushRequested = true;\n      return;\n    }\n    this._flush().catch(err => {\n      console.error('Error flushing logs to HTTP endpoint:', err);\n    });\n  }\n\n  _flush(): Promise<void> {\n    // Only one request in flight at a time, so an outage doesn't fan out into overlapping retry chains.\n    if (this.flushPromise) {\n      this.flushRequested = true;\n      return this.flushPromise;\n    }\n    if (this.logBuffer.length === 0) {\n      return Promise.resolve();\n    }\n\n    this.flushRequested = false;\n    const flush = this.flushBatch().finally(() => {\n      this.flushPromise = null;\n    });\n    this.flushPromise = flush;\n    // Flushes requested while this request was in flight only got this promise back, so send their logs now,\n    // and keep draining full batches. On a transient failure, wait for the next interval instead of retrying\n    // straight away. A permanently rejected batch was dropped, so the logs behind it can go out now.\n    const continueDraining = () => {\n      if (this.logBuffer.length >= this.batchSize || (this.flushRequested && this.logBuffer.length > 0)) {\n        this.requestFlush();\n      }\n    };\n    flush.then(continueDraining, error => {\n      if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) {\n        continueDraining();\n      }\n    });\n    return flush;\n  }\n\n  private async flushBatch(): Promise<void> {\n    const now = Date.now();\n    const logs = this.logBuffer.splice(0, this.batchSize);\n\n    try {\n      await this.makeHttpRequest(logs);\n      this.lastFlush = now;\n    } catch (error) {\n      // The endpoint rejected this batch outright, so resending it can't succeed and would block the logs behind it.\n      if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) {\n        this.droppedLogCount += logs.length;\n        console.warn(\n          `HttpTransport: endpoint rejected a batch with HTTP ${error.status}; dropping ${logs.length} logs. Use getDroppedLogCount() to track drops.`,\n        );\n        throw error;\n      }\n\n      // On a transient error, put logs back in the buffer\n      this.logBuffer.unshift(...logs);\n      this.enforceBufferLimit();\n      throw error;\n    }\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  _transform(chunk: string, _enc: string, cb: Function): void {\n    try {\n      // Parse the log line if it's a string\n      const log = typeof chunk === 'string' ? JSON.parse(chunk) : chunk;\n\n      // Add timestamp if not present\n      if (!log.time) {\n        log.time = Date.now();\n      }\n\n      // Add to buffer\n      this.logBuffer.push(log);\n      this.enforceBufferLimit();\n\n      // Flush if buffer reaches batch size\n      if (this.logBuffer.length >= this.batchSize) {\n        this.requestFlush();\n      }\n\n      // Pass through the log\n      cb(null, chunk);\n    } catch (error) {\n      cb(error);\n    }\n  }\n\n  _destroy(err: Error, cb: Function): void {\n    clearInterval(this.flushIntervalId);\n\n    // Final drain. Wait out any in-flight request (ignoring its failure, since its logs are back in the buffer),\n    // then keep sending until the buffer is empty. A failed request ends the drain instead of retrying forever.\n    if (this.logBuffer.length > 0 || this.flushPromise) {\n      const drain = async () => {\n        await this.flushPromise?.catch(() => {});\n        while (this.flushPromise || this.logBuffer.length > 0) {\n          await (this.flushPromise ?? this._flush());\n        }\n      };\n\n      drain()\n        .then(() => cb(err))\n        .catch(flushErr => {\n          console.error('Error in final flush:', flushErr);\n          cb(err || flushErr);\n        });\n    } else {\n      cb(err);\n    }\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogs: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: params?.page ?? 1,\n      perPage: params?.perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  async listLogsByRunId({\n    runId: _runId,\n    fromDate: _fromDate,\n    toDate: _toDate,\n    logLevel: _logLevel,\n    filters: _filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogsByRunId: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: page ?? 1,\n      perPage: perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  // Utility methods\n  public getBufferedLogs(): BaseLogMessage[] {\n    return [...this.logBuffer];\n  }\n\n  public clearBuffer(): void {\n    this.logBuffer = [];\n  }\n\n  public getDroppedLogCount(): number {\n    return this.droppedLogCount;\n  }\n\n  public getLastFlushTime(): number {\n    return this.lastFlush;\n  }\n}\n"],"mappings":"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"}

package/dist/http/index.d.ts

@@ -13,6 +13,7 @@ interface HttpTransportOptions {
     flushInterval?: number;
     timeout?: number;
     retryOptions?: RetryOptions;
+    maxBufferSize?: number;
 }
 export declare class HttpTransport extends LoggerTransport {
     private url;
@@ -23,11 +24,18 @@ export declare class HttpTransport extends LoggerTransport {
     private timeout;
     private retryOptions;
     private logBuffer;
+    private maxBufferSize;
+    private droppedLogCount;
+    private flushPromise;
+    private flushRequested;
     private lastFlush;
     private flushIntervalId;
     constructor(options: HttpTransportOptions);
     private makeHttpRequest;
+    private enforceBufferLimit;
+    private requestFlush;
     _flush(): Promise<void>;
+    private flushBatch;
     _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean;
     _transform(chunk: string, _enc: string, cb: Function): void;
     _destroy(err: Error, cb: Function): void;
@@ -63,6 +71,7 @@ export declare class HttpTransport extends LoggerTransport {
     }>;
     getBufferedLogs(): BaseLogMessage[];
     clearBuffer(): void;
+    getDroppedLogCount(): number;
     getLastFlushTime(): number;
 }
 export {};

package/dist/http/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/http/index.ts"],"names":[],"mappings":"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"}

package/dist/http/index.js

@@ -1,5 +1,24 @@
 import { LoggerTransport } from "@mastra/core/logger";
 //#region src/http/index.ts
+var HttpResponseError = class extends Error {
+	status;
+	retryAfterMs;
+	constructor(status, statusText, retryAfterMs) {
+		super(`HTTP ${status}: ${statusText}`);
+		this.status = status;
+		this.retryAfterMs = retryAfterMs;
+	}
+};
+function isRetryableStatus(status) {
+	return status === 408 || status === 425 || status === 429 || status >= 500;
+}
+function parseRetryAfter(headers) {
+	const value = headers?.get("retry-after")?.trim();
+	if (!value) return void 0;
+	if (/^\d+$/.test(value)) return Number(value) * 1e3;
+	const date = Date.parse(value);
+	return Number.isNaN(date) ? void 0 : Math.max(0, date - Date.now());
+}
 var HttpTransport = class extends LoggerTransport {
 	url;
 	method;
@@ -9,6 +28,10 @@ var HttpTransport = class extends LoggerTransport {
 	timeout;
 	retryOptions;
 	logBuffer;
+	maxBufferSize;
+	droppedLogCount = 0;
+	flushPromise = null;
+	flushRequested = false;
 	lastFlush;
 	flushIntervalId;
 	constructor(options) {
@@ -20,7 +43,7 @@ var HttpTransport = class extends LoggerTransport {
 			"Content-Type": "application/json",
 			...options.headers
 		};
-		this.batchSize = options.batchSize || 100;
+		this.batchSize = options.batchSize ?? 100;
 		this.flushInterval = options.flushInterval || 1e4;
 		this.timeout = options.timeout || 3e4;
 		this.retryOptions = {
@@ -28,13 +51,13 @@ var HttpTransport = class extends LoggerTransport {
 			retryDelay: options.retryOptions?.retryDelay ?? 1e3,
 			exponentialBackoff: options.retryOptions?.exponentialBackoff ?? true
 		};
+		if (!Number.isInteger(this.batchSize) || this.batchSize < 1) throw new Error("HttpTransport batchSize must be a positive integer");
+		const maxBufferSize = options.maxBufferSize ?? 1e4;
+		if (!Number.isInteger(maxBufferSize) || maxBufferSize < 1) throw new Error("HttpTransport maxBufferSize must be a positive integer");
+		this.maxBufferSize = Math.max(maxBufferSize, this.batchSize);
 		this.logBuffer = [];
 		this.lastFlush = Date.now();
-		this.flushIntervalId = setInterval(() => {
-			this._flush().catch((err) => {
-				console.error("Error flushing logs to HTTP endpoint:", err);
-			});
-		}, this.flushInterval);
+		this.flushIntervalId = setInterval(() => this.requestFlush(), this.flushInterval);
 	}
 	async makeHttpRequest(data, retryCount = 0) {
 		const controller = new AbortController();
@@ -48,27 +71,69 @@ var HttpTransport = class extends LoggerTransport {
 				signal: controller.signal
 			});
 			clearTimeout(timeoutId);
-			if (!response.ok) throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+			if (!response.ok) throw new HttpResponseError(response.status, response.statusText, parseRetryAfter(response.headers));
 			return response;
 		} catch (error) {
 			clearTimeout(timeoutId);
-			if (retryCount < this.retryOptions.maxRetries) {
-				const delay = this.retryOptions.exponentialBackoff ? this.retryOptions.retryDelay * Math.pow(2, retryCount) : this.retryOptions.retryDelay;
+			if (!(error instanceof HttpResponseError && !isRetryableStatus(error.status)) && retryCount < this.retryOptions.maxRetries) {
+				const backoff = this.retryOptions.exponentialBackoff ? this.retryOptions.retryDelay * Math.pow(2, retryCount) : this.retryOptions.retryDelay;
+				const retryAfter = error instanceof HttpResponseError ? error.retryAfterMs ?? 0 : 0;
+				const delay = Math.max(backoff, Math.min(retryAfter, this.timeout));
 				await new Promise((resolve) => setTimeout(resolve, delay));
 				return this.makeHttpRequest(data, retryCount + 1);
 			}
 			throw error;
 		}
 	}
-	async _flush() {
-		if (this.logBuffer.length === 0) return;
+	enforceBufferLimit() {
+		const overflow = this.logBuffer.length - this.maxBufferSize;
+		if (overflow <= 0) return;
+		this.logBuffer.splice(0, overflow);
+		if (this.droppedLogCount === 0) console.warn(`HttpTransport: buffer exceeded maxBufferSize (${this.maxBufferSize}); dropping oldest logs. Use getDroppedLogCount() to track drops.`);
+		this.droppedLogCount += overflow;
+	}
+	requestFlush() {
+		if (this.flushPromise) {
+			this.flushRequested = true;
+			return;
+		}
+		this._flush().catch((err) => {
+			console.error("Error flushing logs to HTTP endpoint:", err);
+		});
+	}
+	_flush() {
+		if (this.flushPromise) {
+			this.flushRequested = true;
+			return this.flushPromise;
+		}
+		if (this.logBuffer.length === 0) return Promise.resolve();
+		this.flushRequested = false;
+		const flush = this.flushBatch().finally(() => {
+			this.flushPromise = null;
+		});
+		this.flushPromise = flush;
+		const continueDraining = () => {
+			if (this.logBuffer.length >= this.batchSize || this.flushRequested && this.logBuffer.length > 0) this.requestFlush();
+		};
+		flush.then(continueDraining, (error) => {
+			if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) continueDraining();
+		});
+		return flush;
+	}
+	async flushBatch() {
 		const now = Date.now();
 		const logs = this.logBuffer.splice(0, this.batchSize);
 		try {
 			await this.makeHttpRequest(logs);
 			this.lastFlush = now;
 		} catch (error) {
+			if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) {
+				this.droppedLogCount += logs.length;
+				console.warn(`HttpTransport: endpoint rejected a batch with HTTP ${error.status}; dropping ${logs.length} logs. Use getDroppedLogCount() to track drops.`);
+				throw error;
+			}
 			this.logBuffer.unshift(...logs);
+			this.enforceBufferLimit();
 			throw error;
 		}
 	}
@@ -87,9 +152,8 @@ var HttpTransport = class extends LoggerTransport {
 			const log = typeof chunk === "string" ? JSON.parse(chunk) : chunk;
 			if (!log.time) log.time = Date.now();
 			this.logBuffer.push(log);
-			if (this.logBuffer.length >= this.batchSize) this._flush().catch((err) => {
-				console.error("Error flushing logs to HTTP endpoint:", err);
-			});
+			this.enforceBufferLimit();
+			if (this.logBuffer.length >= this.batchSize) this.requestFlush();
 			cb(null, chunk);
 		} catch (error) {
 			cb(error);
@@ -97,11 +161,16 @@ var HttpTransport = class extends LoggerTransport {
 	}
 	_destroy(err, cb) {
 		clearInterval(this.flushIntervalId);
-		if (this.logBuffer.length > 0) this._flush().then(() => cb(err)).catch((flushErr) => {
-			console.error("Error in final flush:", flushErr);
-			cb(err || flushErr);
-		});
-		else cb(err);
+		if (this.logBuffer.length > 0 || this.flushPromise) {
+			const drain = async () => {
+				await this.flushPromise?.catch(() => {});
+				while (this.flushPromise || this.logBuffer.length > 0) await (this.flushPromise ?? this._flush());
+			};
+			drain().then(() => cb(err)).catch((flushErr) => {
+				console.error("Error in final flush:", flushErr);
+				cb(err || flushErr);
+			});
+		} else cb(err);
 	}
 	async listLogs(params) {
 		console.warn("HttpTransport.listLogs: This transport is write-only. Override this method to implement log retrieval.");
@@ -129,6 +198,9 @@ var HttpTransport = class extends LoggerTransport {
 	clearBuffer() {
 		this.logBuffer = [];
 	}
+	getDroppedLogCount() {
+		return this.droppedLogCount;
+	}
 	getLastFlushTime() {
 		return this.lastFlush;
 	}

package/dist/http/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../src/http/index.ts"],"sourcesContent":["import { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\ninterface RetryOptions {\n  maxRetries?: number;\n  retryDelay?: number;\n  exponentialBackoff?: boolean;\n}\n\ninterface HttpTransportOptions {\n  url: string;\n  method?: 'POST' | 'PUT' | 'PATCH';\n  headers?: Record<string, string>;\n  batchSize?: number;\n  flushInterval?: number;\n  timeout?: number;\n  retryOptions?: RetryOptions;\n}\n\nexport class HttpTransport extends LoggerTransport {\n  private url: string;\n  private method: string;\n  private headers: Record<string, string>;\n  private batchSize: number;\n  private flushInterval: number;\n  private timeout: number;\n  private retryOptions: Required<RetryOptions>;\n  private logBuffer: BaseLogMessage[];\n  private lastFlush: number;\n  private flushIntervalId: NodeJS.Timeout;\n\n  constructor(options: HttpTransportOptions) {\n    super({ objectMode: true });\n\n    if (!options.url) {\n      throw new Error('HTTP URL is required');\n    }\n\n    this.url = options.url;\n    this.method = options.method || 'POST';\n    this.headers = {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    };\n    this.batchSize = options.batchSize || 100;\n    this.flushInterval = options.flushInterval || 10000;\n    this.timeout = options.timeout || 30000;\n    this.retryOptions = {\n      maxRetries: options.retryOptions?.maxRetries ?? 3,\n      retryDelay: options.retryOptions?.retryDelay ?? 1000,\n      exponentialBackoff: options.retryOptions?.exponentialBackoff ?? true,\n    };\n\n    this.logBuffer = [];\n    this.lastFlush = Date.now();\n\n    // Start flush interval\n    this.flushIntervalId = setInterval(() => {\n      this._flush().catch(err => {\n        console.error('Error flushing logs to HTTP endpoint:', err);\n      });\n    }, this.flushInterval);\n  }\n\n  private async makeHttpRequest(data: any, retryCount = 0): Promise<Response> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const body = JSON.stringify({ logs: data });\n\n      const response = await fetch(this.url, {\n        method: this.method,\n        headers: this.headers,\n        body,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new Error(`HTTP ${response.status}: ${response.statusText}`);\n      }\n\n      return response;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      if (retryCount < this.retryOptions.maxRetries) {\n        const delay = this.retryOptions.exponentialBackoff\n          ? this.retryOptions.retryDelay * Math.pow(2, retryCount)\n          : this.retryOptions.retryDelay;\n\n        await new Promise(resolve => setTimeout(resolve, delay));\n        return this.makeHttpRequest(data, retryCount + 1);\n      }\n\n      throw error;\n    }\n  }\n\n  async _flush(): Promise<void> {\n    if (this.logBuffer.length === 0) {\n      return;\n    }\n\n    const now = Date.now();\n    const logs = this.logBuffer.splice(0, this.batchSize);\n\n    try {\n      await this.makeHttpRequest(logs);\n      this.lastFlush = now;\n    } catch (error) {\n      // On error, put logs back in the buffer\n      this.logBuffer.unshift(...logs);\n      throw error;\n    }\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  _transform(chunk: string, _enc: string, cb: Function): void {\n    try {\n      // Parse the log line if it's a string\n      const log = typeof chunk === 'string' ? JSON.parse(chunk) : chunk;\n\n      // Add timestamp if not present\n      if (!log.time) {\n        log.time = Date.now();\n      }\n\n      // Add to buffer\n      this.logBuffer.push(log);\n\n      // Flush if buffer reaches batch size\n      if (this.logBuffer.length >= this.batchSize) {\n        this._flush().catch(err => {\n          console.error('Error flushing logs to HTTP endpoint:', err);\n        });\n      }\n\n      // Pass through the log\n      cb(null, chunk);\n    } catch (error) {\n      cb(error);\n    }\n  }\n\n  _destroy(err: Error, cb: Function): void {\n    clearInterval(this.flushIntervalId);\n\n    // Final flush\n    if (this.logBuffer.length > 0) {\n      this._flush()\n        .then(() => cb(err))\n        .catch(flushErr => {\n          console.error('Error in final flush:', flushErr);\n          cb(err || flushErr);\n        });\n    } else {\n      cb(err);\n    }\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogs: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: params?.page ?? 1,\n      perPage: params?.perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  async listLogsByRunId({\n    runId: _runId,\n    fromDate: _fromDate,\n    toDate: _toDate,\n    logLevel: _logLevel,\n    filters: _filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogsByRunId: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: page ?? 1,\n      perPage: perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  // Utility methods\n  public getBufferedLogs(): BaseLogMessage[] {\n    return [...this.logBuffer];\n  }\n\n  public clearBuffer(): void {\n    this.logBuffer = [];\n  }\n\n  public getLastFlushTime(): number {\n    return this.lastFlush;\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../../src/http/index.ts"],"sourcesContent":["import { LoggerTransport } from '@mastra/core/logger';\nimport type { BaseLogMessage, LogLevel } from '@mastra/core/logger';\n\ninterface RetryOptions {\n  maxRetries?: number;\n  retryDelay?: number;\n  exponentialBackoff?: boolean;\n}\n\ninterface HttpTransportOptions {\n  url: string;\n  method?: 'POST' | 'PUT' | 'PATCH';\n  headers?: Record<string, string>;\n  batchSize?: number;\n  flushInterval?: number;\n  timeout?: number;\n  retryOptions?: RetryOptions;\n  maxBufferSize?: number;\n}\n\nclass HttpResponseError extends Error {\n  constructor(\n    readonly status: number,\n    statusText: string,\n    readonly retryAfterMs: number | undefined,\n  ) {\n    super(`HTTP ${status}: ${statusText}`);\n  }\n}\n\n// Other 4xx responses mean the request itself is wrong and will fail the same way on every retry.\nfunction isRetryableStatus(status: number): boolean {\n  return status === 408 || status === 425 || status === 429 || status >= 500;\n}\n\n// Retry-After is either delta-seconds or an HTTP date (RFC 9110). Invalid values are ignored.\nfunction parseRetryAfter(headers: Headers | undefined): number | undefined {\n  const value = headers?.get('retry-after')?.trim();\n  if (!value) return undefined;\n  if (/^\\d+$/.test(value)) return Number(value) * 1000;\n  const date = Date.parse(value);\n  return Number.isNaN(date) ? undefined : Math.max(0, date - Date.now());\n}\n\nexport class HttpTransport extends LoggerTransport {\n  private url: string;\n  private method: string;\n  private headers: Record<string, string>;\n  private batchSize: number;\n  private flushInterval: number;\n  private timeout: number;\n  private retryOptions: Required<RetryOptions>;\n  private logBuffer: BaseLogMessage[];\n  private maxBufferSize: number;\n  private droppedLogCount = 0;\n  private flushPromise: Promise<void> | null = null;\n  private flushRequested = false;\n  private lastFlush: number;\n  private flushIntervalId: NodeJS.Timeout;\n\n  constructor(options: HttpTransportOptions) {\n    super({ objectMode: true });\n\n    if (!options.url) {\n      throw new Error('HTTP URL is required');\n    }\n\n    this.url = options.url;\n    this.method = options.method || 'POST';\n    this.headers = {\n      'Content-Type': 'application/json',\n      ...options.headers,\n    };\n    this.batchSize = options.batchSize ?? 100;\n    this.flushInterval = options.flushInterval || 10000;\n    this.timeout = options.timeout || 30000;\n    this.retryOptions = {\n      maxRetries: options.retryOptions?.maxRetries ?? 3,\n      retryDelay: options.retryOptions?.retryDelay ?? 1000,\n      exponentialBackoff: options.retryOptions?.exponentialBackoff ?? true,\n    };\n\n    if (!Number.isInteger(this.batchSize) || this.batchSize < 1) {\n      throw new Error('HttpTransport batchSize must be a positive integer');\n    }\n\n    const maxBufferSize = options.maxBufferSize ?? 10_000;\n    if (!Number.isInteger(maxBufferSize) || maxBufferSize < 1) {\n      throw new Error('HttpTransport maxBufferSize must be a positive integer');\n    }\n    this.maxBufferSize = Math.max(maxBufferSize, this.batchSize);\n    this.logBuffer = [];\n    this.lastFlush = Date.now();\n\n    // Start flush interval\n    this.flushIntervalId = setInterval(() => this.requestFlush(), this.flushInterval);\n  }\n\n  private async makeHttpRequest(data: any, retryCount = 0): Promise<Response> {\n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.timeout);\n\n    try {\n      const body = JSON.stringify({ logs: data });\n\n      const response = await fetch(this.url, {\n        method: this.method,\n        headers: this.headers,\n        body,\n        signal: controller.signal,\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        throw new HttpResponseError(response.status, response.statusText, parseRetryAfter(response.headers));\n      }\n\n      return response;\n    } catch (error) {\n      clearTimeout(timeoutId);\n\n      const isPermanent = error instanceof HttpResponseError && !isRetryableStatus(error.status);\n      if (!isPermanent && retryCount < this.retryOptions.maxRetries) {\n        const backoff = this.retryOptions.exponentialBackoff\n          ? this.retryOptions.retryDelay * Math.pow(2, retryCount)\n          : this.retryOptions.retryDelay;\n        // Honor the server's Retry-After, capped at the request timeout so a large value can't stall shutdown.\n        const retryAfter = error instanceof HttpResponseError ? (error.retryAfterMs ?? 0) : 0;\n        const delay = Math.max(backoff, Math.min(retryAfter, this.timeout));\n\n        await new Promise(resolve => setTimeout(resolve, delay));\n        return this.makeHttpRequest(data, retryCount + 1);\n      }\n\n      throw error;\n    }\n  }\n\n  private enforceBufferLimit(): void {\n    const overflow = this.logBuffer.length - this.maxBufferSize;\n    if (overflow <= 0) {\n      return;\n    }\n\n    this.logBuffer.splice(0, overflow);\n    if (this.droppedLogCount === 0) {\n      console.warn(\n        `HttpTransport: buffer exceeded maxBufferSize (${this.maxBufferSize}); dropping oldest logs. Use getDroppedLogCount() to track drops.`,\n      );\n    }\n    this.droppedLogCount += overflow;\n  }\n\n  // Internal fire-and-forget flush. While a request is in flight this only records the request, so writes\n  // during a slow or retrying request don't each attach another handler to the pending promise.\n  private requestFlush(): void {\n    if (this.flushPromise) {\n      this.flushRequested = true;\n      return;\n    }\n    this._flush().catch(err => {\n      console.error('Error flushing logs to HTTP endpoint:', err);\n    });\n  }\n\n  _flush(): Promise<void> {\n    // Only one request in flight at a time, so an outage doesn't fan out into overlapping retry chains.\n    if (this.flushPromise) {\n      this.flushRequested = true;\n      return this.flushPromise;\n    }\n    if (this.logBuffer.length === 0) {\n      return Promise.resolve();\n    }\n\n    this.flushRequested = false;\n    const flush = this.flushBatch().finally(() => {\n      this.flushPromise = null;\n    });\n    this.flushPromise = flush;\n    // Flushes requested while this request was in flight only got this promise back, so send their logs now,\n    // and keep draining full batches. On a transient failure, wait for the next interval instead of retrying\n    // straight away. A permanently rejected batch was dropped, so the logs behind it can go out now.\n    const continueDraining = () => {\n      if (this.logBuffer.length >= this.batchSize || (this.flushRequested && this.logBuffer.length > 0)) {\n        this.requestFlush();\n      }\n    };\n    flush.then(continueDraining, error => {\n      if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) {\n        continueDraining();\n      }\n    });\n    return flush;\n  }\n\n  private async flushBatch(): Promise<void> {\n    const now = Date.now();\n    const logs = this.logBuffer.splice(0, this.batchSize);\n\n    try {\n      await this.makeHttpRequest(logs);\n      this.lastFlush = now;\n    } catch (error) {\n      // The endpoint rejected this batch outright, so resending it can't succeed and would block the logs behind it.\n      if (error instanceof HttpResponseError && !isRetryableStatus(error.status)) {\n        this.droppedLogCount += logs.length;\n        console.warn(\n          `HttpTransport: endpoint rejected a batch with HTTP ${error.status}; dropping ${logs.length} logs. Use getDroppedLogCount() to track drops.`,\n        );\n        throw error;\n      }\n\n      // On a transient error, put logs back in the buffer\n      this.logBuffer.unshift(...logs);\n      this.enforceBufferLimit();\n      throw error;\n    }\n  }\n\n  _write(chunk: any, encoding?: string, callback?: (error?: Error | null) => void): boolean {\n    if (typeof callback === 'function') {\n      this._transform(chunk, encoding || 'utf8', callback);\n      return true;\n    }\n\n    this._transform(chunk, encoding || 'utf8', (error: Error | null) => {\n      if (error) console.error('Transform error in write:', error);\n    });\n    return true;\n  }\n\n  _transform(chunk: string, _enc: string, cb: Function): void {\n    try {\n      // Parse the log line if it's a string\n      const log = typeof chunk === 'string' ? JSON.parse(chunk) : chunk;\n\n      // Add timestamp if not present\n      if (!log.time) {\n        log.time = Date.now();\n      }\n\n      // Add to buffer\n      this.logBuffer.push(log);\n      this.enforceBufferLimit();\n\n      // Flush if buffer reaches batch size\n      if (this.logBuffer.length >= this.batchSize) {\n        this.requestFlush();\n      }\n\n      // Pass through the log\n      cb(null, chunk);\n    } catch (error) {\n      cb(error);\n    }\n  }\n\n  _destroy(err: Error, cb: Function): void {\n    clearInterval(this.flushIntervalId);\n\n    // Final drain. Wait out any in-flight request (ignoring its failure, since its logs are back in the buffer),\n    // then keep sending until the buffer is empty. A failed request ends the drain instead of retrying forever.\n    if (this.logBuffer.length > 0 || this.flushPromise) {\n      const drain = async () => {\n        await this.flushPromise?.catch(() => {});\n        while (this.flushPromise || this.logBuffer.length > 0) {\n          await (this.flushPromise ?? this._flush());\n        }\n      };\n\n      drain()\n        .then(() => cb(err))\n        .catch(flushErr => {\n          console.error('Error in final flush:', flushErr);\n          cb(err || flushErr);\n        });\n    } else {\n      cb(err);\n    }\n  }\n\n  async listLogs(params?: {\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    returnPaginationResults?: boolean;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogs: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: params?.page ?? 1,\n      perPage: params?.perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  async listLogsByRunId({\n    runId: _runId,\n    fromDate: _fromDate,\n    toDate: _toDate,\n    logLevel: _logLevel,\n    filters: _filters,\n    page,\n    perPage,\n  }: {\n    runId: string;\n    fromDate?: Date;\n    toDate?: Date;\n    logLevel?: LogLevel;\n    filters?: Record<string, any>;\n    page?: number;\n    perPage?: number;\n  }): Promise<{\n    logs: BaseLogMessage[];\n    total: number;\n    page: number;\n    perPage: number;\n    hasMore: boolean;\n  }> {\n    // HttpTransport is write-only by default\n    // Subclasses can override this method to implement log retrieval\n    console.warn(\n      'HttpTransport.listLogsByRunId: This transport is write-only. Override this method to implement log retrieval.',\n    );\n\n    return {\n      logs: [],\n      total: 0,\n      page: page ?? 1,\n      perPage: perPage ?? 100,\n      hasMore: false,\n    };\n  }\n\n  // Utility methods\n  public getBufferedLogs(): BaseLogMessage[] {\n    return [...this.logBuffer];\n  }\n\n  public clearBuffer(): void {\n    this.logBuffer = [];\n  }\n\n  public getDroppedLogCount(): number {\n    return this.droppedLogCount;\n  }\n\n  public getLastFlushTime(): number {\n    return this.lastFlush;\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/loggers",
-  "version": "1.3.4-alpha.0",
+  "version": "1.3.5-alpha.1",
   "description": "",
   "type": "module",
   "files": [
@@ -76,9 +76,9 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.11",
-    "@internal/types-builder": "0.0.113",
-    "@mastra/core": "1.73.0-alpha.1",
-    "@internal/lint": "0.0.138"
+    "@internal/lint": "0.0.140",
+    "@internal/types-builder": "0.0.115",
+    "@mastra/core": "1.75.0-alpha.8"
   },
   "peerDependencies": {
     "@mastra/core": ">=1.0.0-0 <2.0.0-0"