@loglayer/transport-http 1.1.1 → 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (7) hide show
  1. package/dist/index.cjs +329 -334
  2. package/dist/index.cjs.map +1 -1
  3. package/dist/index.d.cts +200 -192
  4. package/dist/index.d.ts +200 -192
  5. package/dist/index.js +301 -333
  6. package/dist/index.js.map +1 -1
  7. package/package.json +7 -7
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["/home/runner/work/loglayer/loglayer/packages/transports/http/dist/index.cjs","../src/errors.ts","../src/HttpTransport.ts","../src/utils.ts"],"names":[],"mappings":"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","file":"/home/runner/work/loglayer/loglayer/packages/transports/http/dist/index.cjs","sourcesContent":[null,"/**\n * Error thrown when HTTP request fails\n */\nexport class HttpTransportError extends Error {\n constructor(\n message: string,\n public status?: number,\n public response?: Response,\n ) {\n super(message);\n this.name = \"HttpTransportError\";\n }\n}\n\n/**\n * Error thrown when rate limit is exceeded\n */\nexport class RateLimitError extends Error {\n constructor(\n message: string,\n public retryAfter: number,\n ) {\n super(message);\n this.name = \"RateLimitError\";\n }\n}\n\n/**\n * Error thrown when log entry exceeds size limits\n */\nexport class LogSizeError extends Error {\n constructor(\n message: string,\n public logEntry: Record<string, any>,\n public size: number,\n public limit: number,\n ) {\n super(message);\n this.name = \"LogSizeError\";\n }\n}\n","import type { LoggerlessTransportConfig, LogLayerTransportParams } from \"@loglayer/transport\";\nimport { LoggerlessTransport } from \"@loglayer/transport\";\nimport { LogSizeError } from \"./errors.js\";\nimport { compressData, sendWithRetry } from \"./utils.js\";\n\n/**\n * Configuration options for the HTTP transport.\n */\nexport interface HttpTransportConfig extends LoggerlessTransportConfig {\n /**\n * The URL to send logs to\n */\n url: string;\n /**\n * HTTP method to use for requests\n * @default \"POST\"\n */\n method?: string;\n /**\n * Headers to include in the request. Can be an object or a function that returns headers.\n */\n headers?: Record<string, string> | (() => Record<string, string>);\n /**\n * Content type for single log requests. User-specified headers take precedence.\n * @default \"application/json\"\n */\n contentType?: string;\n /**\n * Content type for batch log requests. User-specified headers take precedence.\n * @default \"application/json\"\n */\n batchContentType?: string;\n /**\n * Optional callback for error handling\n */\n onError?: (err: Error) => void;\n /**\n * Optional callback for debugging log entries before they are sent\n */\n onDebug?: (entry: Record<string, any>) => void;\n /**\n * Optional callback for debugging HTTP requests and responses\n */\n onDebugReqRes?: (reqRes: {\n req: { url: string; method: string; headers: Record<string, string>; body: string | Uint8Array };\n res: { status: number; statusText: string; headers: Record<string, string>; body: string };\n }) => void;\n /**\n * Function to transform log data into the payload format\n */\n payloadTemplate: (data: { logLevel: string; message: string; data?: Record<string, any> }) => string;\n /**\n * Whether to use gzip compression\n * @default false\n */\n compression?: boolean;\n /**\n * Number of retry attempts before giving up\n * @default 3\n */\n maxRetries?: number;\n /**\n * Base delay between retries in milliseconds\n * @default 1000\n */\n retryDelay?: number;\n /**\n * Whether to respect rate limiting by waiting when a 429 response is received\n * @default true\n */\n respectRateLimit?: boolean;\n /**\n * Whether to enable batch sending\n * @default true\n */\n enableBatchSend?: boolean;\n /**\n * Number of log entries to batch before sending\n * @default 100\n */\n batchSize?: number;\n /**\n * Timeout in milliseconds for sending batches regardless of size\n * @default 5000\n */\n batchSendTimeout?: number;\n /**\n * Delimiter to use between log entries in batch mode\n * @default \"\\n\"\n */\n batchSendDelimiter?: string;\n /**\n * Batch mode for sending multiple log entries\n * - \"delimiter\": Join entries with a delimiter (default)\n * - \"field\": Wrap entries in an object with a field name\n * - \"array\": Send entries as a plain JSON array\n * @default \"delimiter\"\n */\n batchMode?: \"delimiter\" | \"field\" | \"array\";\n /**\n * Field name to wrap batch entries in when batchMode is \"field\" (e.g., \"batch\" for Logflare)\n * @default undefined\n */\n batchFieldName?: string;\n /**\n * Maximum size of a single log entry in bytes\n * @default 1048576 (1MB)\n */\n maxLogSize?: number;\n /**\n * Maximum size of the payload (uncompressed) in bytes\n * @default 5242880 (5MB)\n */\n maxPayloadSize?: number;\n /**\n * Whether to enable Next.js Edge Runtime compatibility mode\n * When enabled, TextEncoder and compression are disabled\n * @default false\n */\n enableNextJsEdgeCompat?: boolean;\n}\n\n/**\n * HttpTransport is responsible for sending logs to any HTTP endpoint.\n * It supports batching, compression, retries, and rate limiting.\n *\n * Features:\n * - Configurable HTTP method and headers\n * - Custom payload template function\n * - Gzip compression support\n * - Retry logic with exponential backoff\n * - Rate limiting support\n * - Batch sending with configurable size and timeout\n * - Error and debug callbacks\n * - Log size validation\n * - Payload size tracking for batching\n */\nexport class HttpTransport extends LoggerlessTransport {\n private url: string;\n private method: string;\n private headers: Record<string, string> | (() => Record<string, string>);\n private contentType: string;\n private batchContentType: string;\n private onError?: (err: Error) => void;\n private onDebug?: (entry: Record<string, any>) => void;\n private onDebugReqRes?: (reqRes: {\n req: { url: string; method: string; headers: Record<string, string>; body: string | Uint8Array };\n res: { status: number; statusText: string; headers: Record<string, string>; body: string };\n }) => void;\n private payloadTemplate: (data: { logLevel: string; message: string; data?: Record<string, any> }) => string;\n private compression: boolean;\n private maxRetries: number;\n private retryDelay: number;\n private respectRateLimit: boolean;\n private enableBatchSend: boolean;\n private batchSize: number;\n private batchSendTimeout: number;\n private batchSendDelimiter: string;\n private batchMode: \"delimiter\" | \"field\" | \"array\";\n private batchFieldName?: string;\n private maxLogSize: number;\n private maxPayloadSize: number;\n private enableNextJsEdgeCompat: boolean;\n\n // Batch management\n private batchQueue: string[] = [];\n private batchTimeout?: NodeJS.Timeout;\n private isProcessingBatch = false;\n private currentBatchSize = 0; // Track uncompressed size of current batch\n\n /**\n * Creates a new instance of HttpTransport.\n *\n * @param config - Configuration options for the transport\n */\n constructor(config: HttpTransportConfig) {\n super(config);\n\n this.url = config.url;\n this.method = config.method ?? \"POST\";\n this.headers = config.headers ?? {};\n this.contentType = config.contentType ?? \"application/json\";\n this.batchContentType = config.batchContentType ?? \"application/json\";\n this.onError = config.onError;\n this.onDebug = config.onDebug;\n this.onDebugReqRes = config.onDebugReqRes;\n this.payloadTemplate = config.payloadTemplate;\n this.compression = config.compression ?? false;\n this.maxRetries = config.maxRetries ?? 3;\n this.retryDelay = config.retryDelay ?? 1000;\n this.respectRateLimit = config.respectRateLimit ?? true;\n this.enableBatchSend = config.enableBatchSend ?? true;\n this.batchSize = config.batchSize ?? 100;\n this.batchSendTimeout = config.batchSendTimeout ?? 5000;\n this.batchSendDelimiter = config.batchSendDelimiter ?? \"\\n\";\n this.batchMode = config.batchMode ?? \"delimiter\";\n this.batchFieldName = config.batchFieldName;\n\n // Validate that batchFieldName is provided when batchMode is \"field\"\n if (this.batchMode === \"field\" && !this.batchFieldName) {\n throw new Error(\"batchFieldName is required when batchMode is 'field'\");\n }\n this.maxLogSize = config.maxLogSize ?? 1048576; // 1MB\n this.maxPayloadSize = config.maxPayloadSize ?? 5242880; // 5MB\n this.enableNextJsEdgeCompat = config.enableNextJsEdgeCompat ?? false;\n }\n\n /**\n * Processes and ships log entries to the HTTP endpoint.\n *\n * @param params - Log parameters including level, messages, and metadata\n * @returns The original messages array\n */\n shipToLogger({ logLevel, messages, data, hasData }: LogLayerTransportParams): any[] {\n try {\n const message = messages.join(\" \");\n\n const payloadTemplate = {\n logLevel,\n message,\n };\n\n if (hasData) {\n payloadTemplate[\"data\"] = data;\n }\n\n const payload = this.payloadTemplate(payloadTemplate);\n\n if (this.onDebug) {\n this.onDebug({ logLevel, message, data });\n }\n\n // Check log entry size\n let logEntrySize: number;\n\n if (this.enableNextJsEdgeCompat || typeof TextEncoder === \"undefined\") {\n // Fallback for environments without TextEncoder (like Next.js Edge Runtime)\n logEntrySize = Buffer.byteLength(payload, \"utf8\");\n } else {\n logEntrySize = new TextEncoder().encode(payload).length;\n }\n\n if (logEntrySize > this.maxLogSize) {\n const error = new LogSizeError(\n `Log entry exceeds maximum size of ${this.maxLogSize} bytes. Size: ${logEntrySize} bytes`,\n { logLevel, message, data },\n logEntrySize,\n this.maxLogSize,\n );\n\n if (this.onError) {\n this.onError(error);\n }\n return messages;\n }\n\n if (this.enableBatchSend) {\n this.addToBatch(payload, logEntrySize);\n } else {\n // Send immediately\n this.sendPayload(payload).catch((err) => {\n if (this.onError) {\n this.onError(err);\n }\n });\n }\n } catch (error) {\n if (this.onError) {\n this.onError(error as Error);\n }\n }\n\n return messages;\n }\n\n /**\n * Adds a payload to the batch queue and triggers sending if conditions are met\n */\n private addToBatch(payload: string, logEntrySize: number): void {\n // Check if adding this entry would exceed payload size limit\n const payloadSizeWithEntry = this.currentBatchSize + logEntrySize + this.batchSendDelimiter.length;\n const payloadSizeThreshold = this.maxPayloadSize * 0.9; // 90% of max payload size\n\n // Force send if adding this entry would exceed 90% of max payload size\n if (payloadSizeWithEntry > payloadSizeThreshold && this.batchQueue.length > 0) {\n this.processBatch();\n }\n\n this.batchQueue.push(payload);\n this.currentBatchSize += logEntrySize + this.batchSendDelimiter.length;\n\n // Start batch timeout if not already running\n if (!this.batchTimeout) {\n this.batchTimeout = setTimeout(() => {\n this.processBatch();\n }, this.batchSendTimeout);\n }\n\n // Send immediately if batch size is reached\n if (this.batchQueue.length >= this.batchSize) {\n this.processBatch();\n }\n }\n\n /**\n * Processes the current batch and sends it to the HTTP endpoint\n */\n private async processBatch(): Promise<void> {\n if (this.isProcessingBatch || this.batchQueue.length === 0) {\n return;\n }\n\n this.isProcessingBatch = true;\n\n // Clear the timeout\n if (this.batchTimeout) {\n clearTimeout(this.batchTimeout);\n this.batchTimeout = undefined;\n }\n\n // Get the current batch\n const batch = this.batchQueue.splice(0, this.batchSize);\n\n // Reset batch size counter\n this.currentBatchSize = 0;\n\n try {\n await this.sendBatch(batch);\n } catch (error) {\n if (this.onError) {\n this.onError(error as Error);\n }\n } finally {\n this.isProcessingBatch = false;\n\n // If there are more items in the queue, process them\n if (this.batchQueue.length > 0) {\n this.processBatch();\n }\n }\n }\n\n /**\n * Sends a batch of payloads to the HTTP endpoint\n */\n private async sendBatch(batch: string[]): Promise<void> {\n let batchPayload: string;\n\n switch (this.batchMode) {\n case \"array\": {\n // Send batch entries as a plain JSON array\n const batchEntries = batch.map((payload) => JSON.parse(payload));\n batchPayload = JSON.stringify(batchEntries);\n break;\n }\n case \"field\": {\n // Parse each payload as JSON and create a batch object\n const fieldEntries = batch.map((payload) => JSON.parse(payload));\n const batchObject = { [this.batchFieldName!]: fieldEntries };\n batchPayload = JSON.stringify(batchObject);\n break;\n }\n default:\n // Use delimiter-based batching (default behavior)\n batchPayload = batch.join(this.batchSendDelimiter);\n break;\n }\n\n await this.sendPayload(batchPayload, this.batchContentType);\n }\n\n /**\n * Sends a single payload to the HTTP endpoint\n */\n private async sendPayload(payload: string, contentType?: string): Promise<void> {\n // Get headers\n const headers: Record<string, string> = typeof this.headers === \"function\" ? this.headers() : { ...this.headers };\n\n // Set content type - user headers take precedence\n if (!headers[\"content-type\"]) {\n headers[\"content-type\"] = contentType ?? this.contentType;\n }\n\n let finalPayload: string | Uint8Array = payload;\n\n // Apply compression if enabled and not in Next.js Edge compatibility mode\n if (this.compression && !this.enableNextJsEdgeCompat) {\n try {\n finalPayload = await compressData(payload);\n headers[\"content-encoding\"] = \"gzip\";\n } catch (error) {\n // If compression fails, fall back to uncompressed\n if (this.onError) {\n this.onError(new Error(`Compression failed: ${error}`));\n }\n }\n }\n\n await sendWithRetry(\n this.url,\n this.method,\n headers,\n finalPayload,\n this.maxRetries,\n this.retryDelay,\n this.respectRateLimit,\n this.onDebugReqRes,\n this.onError,\n );\n }\n}\n","import { HttpTransportError, RateLimitError } from \"./errors.js\";\n\n/**\n * Compresses data using gzip compression\n */\nexport async function compressData(data: string): Promise<Uint8Array> {\n const encoder = new TextEncoder();\n const dataBytes = encoder.encode(data);\n\n // Use the CompressionStream API if available (modern browsers)\n if (typeof CompressionStream !== \"undefined\") {\n const stream = new CompressionStream(\"gzip\");\n const writer = stream.writable.getWriter();\n const reader = stream.readable.getReader();\n\n await writer.write(dataBytes);\n await writer.close();\n\n const chunks: Uint8Array[] = [];\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value);\n }\n\n const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);\n const result = new Uint8Array(totalLength);\n let offset = 0;\n for (const chunk of chunks) {\n result.set(chunk, offset);\n offset += chunk.length;\n }\n\n return result;\n }\n\n // Fallback for Node.js or environments without CompressionStream\n // In a real implementation, you might want to use a library like 'zlib' for Node.js\n throw new Error(\"Gzip compression not supported in this environment\");\n}\n\n/**\n * Sends HTTP request with retry logic and rate limiting\n */\nexport async function sendWithRetry(\n url: string,\n method: string,\n headers: Record<string, string>,\n payload: string | Uint8Array,\n maxRetries: number,\n retryDelay: number,\n respectRateLimit = true,\n onDebugReqRes?: (reqRes: {\n req: { url: string; method: string; headers: Record<string, string>; body: string | Uint8Array };\n res: { status: number; statusText: string; headers: Record<string, string>; body: string };\n }) => void,\n onError?: (err: Error) => void,\n): Promise<Response> {\n let lastError: Error;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n try {\n const response = await fetch(url, {\n method,\n headers,\n body: payload,\n });\n\n // Call debug callback if provided\n if (onDebugReqRes) {\n try {\n const responseBody = await response.clone().text();\n const responseHeaders: Record<string, string> = {};\n response.headers.forEach((value, key) => {\n responseHeaders[key] = value;\n });\n\n onDebugReqRes({\n req: {\n url,\n method,\n headers,\n body: payload,\n },\n res: {\n status: response.status,\n statusText: response.statusText,\n headers: responseHeaders,\n body: responseBody,\n },\n });\n } catch (debugError) {\n // Don't let debug callback errors break the main flow\n if (onError) {\n onError(new Error(`Debug callback error: ${debugError}`));\n }\n }\n }\n\n // Handle rate limiting\n if (response.status === 429 && respectRateLimit) {\n const retryAfter = response.headers.get(\"retry-after\");\n const waitTime = retryAfter ? Number.parseInt(retryAfter, 10) * 1000 : retryDelay;\n\n throw new RateLimitError(`Rate limit exceeded. Retry after ${waitTime}ms`, waitTime);\n }\n\n // Check for non-2xx status codes and log if onError is enabled\n if (response.status < 200 || response.status >= 300) {\n if (onError) {\n onError(new Error(`HTTP request failed with status ${response.status}: ${response.statusText}`));\n }\n }\n\n // Handle other errors\n if (!response.ok) {\n throw new HttpTransportError(`HTTP ${response.status}: ${response.statusText}`, response.status, response);\n }\n\n return response;\n } catch (error) {\n lastError = error as Error;\n\n // If it's a rate limit error and we should respect it, wait and retry\n if (error instanceof RateLimitError && respectRateLimit) {\n await new Promise((resolve) => setTimeout(resolve, error.retryAfter));\n continue;\n }\n\n // If it's the last attempt, throw the error\n if (attempt === maxRetries) {\n throw error;\n }\n\n // Wait before retrying with exponential backoff\n const waitTime = retryDelay * 2 ** attempt;\n await new Promise((resolve) => setTimeout(resolve, waitTime));\n }\n }\n\n throw lastError!;\n}\n"]}
1
+ {"version":3,"file":"index.cjs","names":["status?: number","response?: Response","retryAfter: number","logEntry: Record<string, any>","size: number","limit: number","chunks: Uint8Array[]","lastError: Error","responseHeaders: Record<string, string>","LoggerlessTransport","logEntrySize: number","batchPayload: string","headers: Record<string, string>","finalPayload: string | Uint8Array"],"sources":["../src/errors.ts","../src/utils.ts","../src/HttpTransport.ts"],"sourcesContent":["/**\n * Error thrown when HTTP request fails\n */\nexport class HttpTransportError extends Error {\n constructor(\n message: string,\n public status?: number,\n public response?: Response,\n ) {\n super(message);\n this.name = \"HttpTransportError\";\n }\n}\n\n/**\n * Error thrown when rate limit is exceeded\n */\nexport class RateLimitError extends Error {\n constructor(\n message: string,\n public retryAfter: number,\n ) {\n super(message);\n this.name = \"RateLimitError\";\n }\n}\n\n/**\n * Error thrown when log entry exceeds size limits\n */\nexport class LogSizeError extends Error {\n constructor(\n message: string,\n public logEntry: Record<string, any>,\n public size: number,\n public limit: number,\n ) {\n super(message);\n this.name = \"LogSizeError\";\n }\n}\n","import { HttpTransportError, RateLimitError } from \"./errors.js\";\n\n/**\n * Compresses data using gzip compression\n */\nexport async function compressData(data: string): Promise<Uint8Array> {\n const encoder = new TextEncoder();\n const dataBytes = encoder.encode(data);\n\n // Use the CompressionStream API if available (modern browsers)\n if (typeof CompressionStream !== \"undefined\") {\n const stream = new CompressionStream(\"gzip\");\n const writer = stream.writable.getWriter();\n const reader = stream.readable.getReader();\n\n await writer.write(dataBytes);\n await writer.close();\n\n const chunks: Uint8Array[] = [];\n while (true) {\n const { done, value } = await reader.read();\n if (done) break;\n chunks.push(value);\n }\n\n const totalLength = chunks.reduce((acc, chunk) => acc + chunk.length, 0);\n const result = new Uint8Array(totalLength);\n let offset = 0;\n for (const chunk of chunks) {\n result.set(chunk, offset);\n offset += chunk.length;\n }\n\n return result;\n }\n\n // Fallback for Node.js or environments without CompressionStream\n // In a real implementation, you might want to use a library like 'zlib' for Node.js\n throw new Error(\"Gzip compression not supported in this environment\");\n}\n\n/**\n * Sends HTTP request with retry logic and rate limiting\n */\nexport async function sendWithRetry(\n url: string,\n method: string,\n headers: Record<string, string>,\n payload: string | Uint8Array,\n maxRetries: number,\n retryDelay: number,\n respectRateLimit = true,\n onDebugReqRes?: (reqRes: {\n req: { url: string; method: string; headers: Record<string, string>; body: string | Uint8Array };\n res: { status: number; statusText: string; headers: Record<string, string>; body: string };\n }) => void,\n onError?: (err: Error) => void,\n): Promise<Response> {\n let lastError: Error;\n\n for (let attempt = 0; attempt <= maxRetries; attempt++) {\n try {\n const response = await fetch(url, {\n method,\n headers,\n body: payload,\n });\n\n // Call debug callback if provided\n if (onDebugReqRes) {\n try {\n const responseBody = await response.clone().text();\n const responseHeaders: Record<string, string> = {};\n response.headers.forEach((value, key) => {\n responseHeaders[key] = value;\n });\n\n onDebugReqRes({\n req: {\n url,\n method,\n headers,\n body: payload,\n },\n res: {\n status: response.status,\n statusText: response.statusText,\n headers: responseHeaders,\n body: responseBody,\n },\n });\n } catch (debugError) {\n // Don't let debug callback errors break the main flow\n if (onError) {\n onError(new Error(`Debug callback error: ${debugError}`));\n }\n }\n }\n\n // Handle rate limiting\n if (response.status === 429 && respectRateLimit) {\n const retryAfter = response.headers.get(\"retry-after\");\n const waitTime = retryAfter ? Number.parseInt(retryAfter, 10) * 1000 : retryDelay;\n\n throw new RateLimitError(`Rate limit exceeded. Retry after ${waitTime}ms`, waitTime);\n }\n\n // Check for non-2xx status codes and log if onError is enabled\n if (response.status < 200 || response.status >= 300) {\n if (onError) {\n onError(new Error(`HTTP request failed with status ${response.status}: ${response.statusText}`));\n }\n }\n\n // Handle other errors\n if (!response.ok) {\n throw new HttpTransportError(`HTTP ${response.status}: ${response.statusText}`, response.status, response);\n }\n\n return response;\n } catch (error) {\n lastError = error as Error;\n\n // If it's a rate limit error and we should respect it, wait and retry\n if (error instanceof RateLimitError && respectRateLimit) {\n await new Promise((resolve) => setTimeout(resolve, error.retryAfter));\n continue;\n }\n\n // If it's the last attempt, throw the error\n if (attempt === maxRetries) {\n throw error;\n }\n\n // Wait before retrying with exponential backoff\n const waitTime = retryDelay * 2 ** attempt;\n await new Promise((resolve) => setTimeout(resolve, waitTime));\n }\n }\n\n throw lastError!;\n}\n","import type { LoggerlessTransportConfig, LogLayerTransportParams } from \"@loglayer/transport\";\nimport { LoggerlessTransport } from \"@loglayer/transport\";\nimport { LogSizeError } from \"./errors.js\";\nimport { compressData, sendWithRetry } from \"./utils.js\";\n\n/**\n * Configuration options for the HTTP transport.\n */\nexport interface HttpTransportConfig extends LoggerlessTransportConfig {\n /**\n * The URL to send logs to\n */\n url: string;\n /**\n * HTTP method to use for requests\n * @default \"POST\"\n */\n method?: string;\n /**\n * Headers to include in the request. Can be an object or a function that returns headers.\n */\n headers?: Record<string, string> | (() => Record<string, string>);\n /**\n * Content type for single log requests. User-specified headers take precedence.\n * @default \"application/json\"\n */\n contentType?: string;\n /**\n * Content type for batch log requests. User-specified headers take precedence.\n * @default \"application/json\"\n */\n batchContentType?: string;\n /**\n * Optional callback for error handling\n */\n onError?: (err: Error) => void;\n /**\n * Optional callback for debugging log entries before they are sent\n */\n onDebug?: (entry: Record<string, any>) => void;\n /**\n * Optional callback for debugging HTTP requests and responses\n */\n onDebugReqRes?: (reqRes: {\n req: { url: string; method: string; headers: Record<string, string>; body: string | Uint8Array };\n res: { status: number; statusText: string; headers: Record<string, string>; body: string };\n }) => void;\n /**\n * Function to transform log data into the payload format\n */\n payloadTemplate: (data: { logLevel: string; message: string; data?: Record<string, any> }) => string;\n /**\n * Whether to use gzip compression\n * @default false\n */\n compression?: boolean;\n /**\n * Number of retry attempts before giving up\n * @default 3\n */\n maxRetries?: number;\n /**\n * Base delay between retries in milliseconds\n * @default 1000\n */\n retryDelay?: number;\n /**\n * Whether to respect rate limiting by waiting when a 429 response is received\n * @default true\n */\n respectRateLimit?: boolean;\n /**\n * Whether to enable batch sending\n * @default true\n */\n enableBatchSend?: boolean;\n /**\n * Number of log entries to batch before sending\n * @default 100\n */\n batchSize?: number;\n /**\n * Timeout in milliseconds for sending batches regardless of size\n * @default 5000\n */\n batchSendTimeout?: number;\n /**\n * Delimiter to use between log entries in batch mode\n * @default \"\\n\"\n */\n batchSendDelimiter?: string;\n /**\n * Batch mode for sending multiple log entries\n * - \"delimiter\": Join entries with a delimiter (default)\n * - \"field\": Wrap entries in an object with a field name\n * - \"array\": Send entries as a plain JSON array\n * @default \"delimiter\"\n */\n batchMode?: \"delimiter\" | \"field\" | \"array\";\n /**\n * Field name to wrap batch entries in when batchMode is \"field\" (e.g., \"batch\" for Logflare)\n * @default undefined\n */\n batchFieldName?: string;\n /**\n * Maximum size of a single log entry in bytes\n * @default 1048576 (1MB)\n */\n maxLogSize?: number;\n /**\n * Maximum size of the payload (uncompressed) in bytes\n * @default 5242880 (5MB)\n */\n maxPayloadSize?: number;\n /**\n * Whether to enable Next.js Edge Runtime compatibility mode\n * When enabled, TextEncoder and compression are disabled\n * @default false\n */\n enableNextJsEdgeCompat?: boolean;\n}\n\n/**\n * HttpTransport is responsible for sending logs to any HTTP endpoint.\n * It supports batching, compression, retries, and rate limiting.\n *\n * Features:\n * - Configurable HTTP method and headers\n * - Custom payload template function\n * - Gzip compression support\n * - Retry logic with exponential backoff\n * - Rate limiting support\n * - Batch sending with configurable size and timeout\n * - Error and debug callbacks\n * - Log size validation\n * - Payload size tracking for batching\n */\nexport class HttpTransport extends LoggerlessTransport {\n private url: string;\n private method: string;\n private headers: Record<string, string> | (() => Record<string, string>);\n private contentType: string;\n private batchContentType: string;\n private onError?: (err: Error) => void;\n private onDebug?: (entry: Record<string, any>) => void;\n private onDebugReqRes?: (reqRes: {\n req: { url: string; method: string; headers: Record<string, string>; body: string | Uint8Array };\n res: { status: number; statusText: string; headers: Record<string, string>; body: string };\n }) => void;\n private payloadTemplate: (data: { logLevel: string; message: string; data?: Record<string, any> }) => string;\n private compression: boolean;\n private maxRetries: number;\n private retryDelay: number;\n private respectRateLimit: boolean;\n private enableBatchSend: boolean;\n private batchSize: number;\n private batchSendTimeout: number;\n private batchSendDelimiter: string;\n private batchMode: \"delimiter\" | \"field\" | \"array\";\n private batchFieldName?: string;\n private maxLogSize: number;\n private maxPayloadSize: number;\n private enableNextJsEdgeCompat: boolean;\n\n // Batch management\n private batchQueue: string[] = [];\n private batchTimeout?: NodeJS.Timeout;\n private isProcessingBatch = false;\n private currentBatchSize = 0; // Track uncompressed size of current batch\n\n /**\n * Creates a new instance of HttpTransport.\n *\n * @param config - Configuration options for the transport\n */\n constructor(config: HttpTransportConfig) {\n super(config);\n\n this.url = config.url;\n this.method = config.method ?? \"POST\";\n this.headers = config.headers ?? {};\n this.contentType = config.contentType ?? \"application/json\";\n this.batchContentType = config.batchContentType ?? \"application/json\";\n this.onError = config.onError;\n this.onDebug = config.onDebug;\n this.onDebugReqRes = config.onDebugReqRes;\n this.payloadTemplate = config.payloadTemplate;\n this.compression = config.compression ?? false;\n this.maxRetries = config.maxRetries ?? 3;\n this.retryDelay = config.retryDelay ?? 1000;\n this.respectRateLimit = config.respectRateLimit ?? true;\n this.enableBatchSend = config.enableBatchSend ?? true;\n this.batchSize = config.batchSize ?? 100;\n this.batchSendTimeout = config.batchSendTimeout ?? 5000;\n this.batchSendDelimiter = config.batchSendDelimiter ?? \"\\n\";\n this.batchMode = config.batchMode ?? \"delimiter\";\n this.batchFieldName = config.batchFieldName;\n\n // Validate that batchFieldName is provided when batchMode is \"field\"\n if (this.batchMode === \"field\" && !this.batchFieldName) {\n throw new Error(\"batchFieldName is required when batchMode is 'field'\");\n }\n this.maxLogSize = config.maxLogSize ?? 1048576; // 1MB\n this.maxPayloadSize = config.maxPayloadSize ?? 5242880; // 5MB\n this.enableNextJsEdgeCompat = config.enableNextJsEdgeCompat ?? false;\n }\n\n /**\n * Processes and ships log entries to the HTTP endpoint.\n *\n * @param params - Log parameters including level, messages, and metadata\n * @returns The original messages array\n */\n shipToLogger({ logLevel, messages, data, hasData }: LogLayerTransportParams): any[] {\n try {\n const message = messages.join(\" \");\n\n const payloadTemplate = {\n logLevel,\n message,\n };\n\n if (hasData) {\n payloadTemplate[\"data\"] = data;\n }\n\n const payload = this.payloadTemplate(payloadTemplate);\n\n if (this.onDebug) {\n this.onDebug({ logLevel, message, data });\n }\n\n // Check log entry size\n let logEntrySize: number;\n\n if (this.enableNextJsEdgeCompat || typeof TextEncoder === \"undefined\") {\n // Fallback for environments without TextEncoder (like Next.js Edge Runtime)\n logEntrySize = Buffer.byteLength(payload, \"utf8\");\n } else {\n logEntrySize = new TextEncoder().encode(payload).length;\n }\n\n if (logEntrySize > this.maxLogSize) {\n const error = new LogSizeError(\n `Log entry exceeds maximum size of ${this.maxLogSize} bytes. Size: ${logEntrySize} bytes`,\n { logLevel, message, data },\n logEntrySize,\n this.maxLogSize,\n );\n\n if (this.onError) {\n this.onError(error);\n }\n return messages;\n }\n\n if (this.enableBatchSend) {\n this.addToBatch(payload, logEntrySize);\n } else {\n // Send immediately\n this.sendPayload(payload).catch((err) => {\n if (this.onError) {\n this.onError(err);\n }\n });\n }\n } catch (error) {\n if (this.onError) {\n this.onError(error as Error);\n }\n }\n\n return messages;\n }\n\n /**\n * Adds a payload to the batch queue and triggers sending if conditions are met\n */\n private addToBatch(payload: string, logEntrySize: number): void {\n // Check if adding this entry would exceed payload size limit\n const payloadSizeWithEntry = this.currentBatchSize + logEntrySize + this.batchSendDelimiter.length;\n const payloadSizeThreshold = this.maxPayloadSize * 0.9; // 90% of max payload size\n\n // Force send if adding this entry would exceed 90% of max payload size\n if (payloadSizeWithEntry > payloadSizeThreshold && this.batchQueue.length > 0) {\n this.processBatch();\n }\n\n this.batchQueue.push(payload);\n this.currentBatchSize += logEntrySize + this.batchSendDelimiter.length;\n\n // Start batch timeout if not already running\n if (!this.batchTimeout) {\n this.batchTimeout = setTimeout(() => {\n this.processBatch();\n }, this.batchSendTimeout);\n }\n\n // Send immediately if batch size is reached\n if (this.batchQueue.length >= this.batchSize) {\n this.processBatch();\n }\n }\n\n /**\n * Processes the current batch and sends it to the HTTP endpoint\n */\n private async processBatch(): Promise<void> {\n if (this.isProcessingBatch || this.batchQueue.length === 0) {\n return;\n }\n\n this.isProcessingBatch = true;\n\n // Clear the timeout\n if (this.batchTimeout) {\n clearTimeout(this.batchTimeout);\n this.batchTimeout = undefined;\n }\n\n // Get the current batch\n const batch = this.batchQueue.splice(0, this.batchSize);\n\n // Reset batch size counter\n this.currentBatchSize = 0;\n\n try {\n await this.sendBatch(batch);\n } catch (error) {\n if (this.onError) {\n this.onError(error as Error);\n }\n } finally {\n this.isProcessingBatch = false;\n\n // If there are more items in the queue, process them\n if (this.batchQueue.length > 0) {\n this.processBatch();\n }\n }\n }\n\n /**\n * Sends a batch of payloads to the HTTP endpoint\n */\n private async sendBatch(batch: string[]): Promise<void> {\n let batchPayload: string;\n\n switch (this.batchMode) {\n case \"array\": {\n // Send batch entries as a plain JSON array\n const batchEntries = batch.map((payload) => JSON.parse(payload));\n batchPayload = JSON.stringify(batchEntries);\n break;\n }\n case \"field\": {\n // Parse each payload as JSON and create a batch object\n const fieldEntries = batch.map((payload) => JSON.parse(payload));\n const batchObject = { [this.batchFieldName!]: fieldEntries };\n batchPayload = JSON.stringify(batchObject);\n break;\n }\n default:\n // Use delimiter-based batching (default behavior)\n batchPayload = batch.join(this.batchSendDelimiter);\n break;\n }\n\n await this.sendPayload(batchPayload, this.batchContentType);\n }\n\n /**\n * Sends a single payload to the HTTP endpoint\n */\n private async sendPayload(payload: string, contentType?: string): Promise<void> {\n // Get headers\n const headers: Record<string, string> = typeof this.headers === \"function\" ? this.headers() : { ...this.headers };\n\n // Set content type - user headers take precedence\n if (!headers[\"content-type\"]) {\n headers[\"content-type\"] = contentType ?? this.contentType;\n }\n\n let finalPayload: string | Uint8Array = payload;\n\n // Apply compression if enabled and not in Next.js Edge compatibility mode\n if (this.compression && !this.enableNextJsEdgeCompat) {\n try {\n finalPayload = await compressData(payload);\n headers[\"content-encoding\"] = \"gzip\";\n } catch (error) {\n // If compression fails, fall back to uncompressed\n if (this.onError) {\n this.onError(new Error(`Compression failed: ${error}`));\n }\n }\n }\n\n await sendWithRetry(\n this.url,\n this.method,\n headers,\n finalPayload,\n this.maxRetries,\n this.retryDelay,\n this.respectRateLimit,\n this.onDebugReqRes,\n this.onError,\n );\n }\n}\n"],"mappings":"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"}
package/dist/index.d.cts CHANGED
@@ -1,159 +1,161 @@
1
- import { LoggerlessTransportConfig, LoggerlessTransport, LogLayerTransportParams } from '@loglayer/transport';
1
+ import { LogLayerTransportParams, LoggerlessTransport, LoggerlessTransportConfig } from "@loglayer/transport";
2
2
 
3
+ //#region src/errors.d.ts
3
4
  /**
4
5
  * Error thrown when HTTP request fails
5
6
  */
6
7
  declare class HttpTransportError extends Error {
7
- status?: number;
8
- response?: Response;
9
- constructor(message: string, status?: number, response?: Response);
8
+ status?: number;
9
+ response?: Response;
10
+ constructor(message: string, status?: number, response?: Response);
10
11
  }
11
12
  /**
12
13
  * Error thrown when rate limit is exceeded
13
14
  */
14
15
  declare class RateLimitError extends Error {
15
- retryAfter: number;
16
- constructor(message: string, retryAfter: number);
16
+ retryAfter: number;
17
+ constructor(message: string, retryAfter: number);
17
18
  }
18
19
  /**
19
20
  * Error thrown when log entry exceeds size limits
20
21
  */
21
22
  declare class LogSizeError extends Error {
22
- logEntry: Record<string, any>;
23
- size: number;
24
- limit: number;
25
- constructor(message: string, logEntry: Record<string, any>, size: number, limit: number);
23
+ logEntry: Record<string, any>;
24
+ size: number;
25
+ limit: number;
26
+ constructor(message: string, logEntry: Record<string, any>, size: number, limit: number);
26
27
  }
27
-
28
+ //#endregion
29
+ //#region src/HttpTransport.d.ts
28
30
  /**
29
31
  * Configuration options for the HTTP transport.
30
32
  */
31
33
  interface HttpTransportConfig extends LoggerlessTransportConfig {
32
- /**
33
- * The URL to send logs to
34
- */
35
- url: string;
36
- /**
37
- * HTTP method to use for requests
38
- * @default "POST"
39
- */
40
- method?: string;
41
- /**
42
- * Headers to include in the request. Can be an object or a function that returns headers.
43
- */
44
- headers?: Record<string, string> | (() => Record<string, string>);
45
- /**
46
- * Content type for single log requests. User-specified headers take precedence.
47
- * @default "application/json"
48
- */
49
- contentType?: string;
50
- /**
51
- * Content type for batch log requests. User-specified headers take precedence.
52
- * @default "application/json"
53
- */
54
- batchContentType?: string;
55
- /**
56
- * Optional callback for error handling
57
- */
58
- onError?: (err: Error) => void;
59
- /**
60
- * Optional callback for debugging log entries before they are sent
61
- */
62
- onDebug?: (entry: Record<string, any>) => void;
63
- /**
64
- * Optional callback for debugging HTTP requests and responses
65
- */
66
- onDebugReqRes?: (reqRes: {
67
- req: {
68
- url: string;
69
- method: string;
70
- headers: Record<string, string>;
71
- body: string | Uint8Array;
72
- };
73
- res: {
74
- status: number;
75
- statusText: string;
76
- headers: Record<string, string>;
77
- body: string;
78
- };
79
- }) => void;
80
- /**
81
- * Function to transform log data into the payload format
82
- */
83
- payloadTemplate: (data: {
84
- logLevel: string;
85
- message: string;
86
- data?: Record<string, any>;
87
- }) => string;
88
- /**
89
- * Whether to use gzip compression
90
- * @default false
91
- */
92
- compression?: boolean;
93
- /**
94
- * Number of retry attempts before giving up
95
- * @default 3
96
- */
97
- maxRetries?: number;
98
- /**
99
- * Base delay between retries in milliseconds
100
- * @default 1000
101
- */
102
- retryDelay?: number;
103
- /**
104
- * Whether to respect rate limiting by waiting when a 429 response is received
105
- * @default true
106
- */
107
- respectRateLimit?: boolean;
108
- /**
109
- * Whether to enable batch sending
110
- * @default true
111
- */
112
- enableBatchSend?: boolean;
113
- /**
114
- * Number of log entries to batch before sending
115
- * @default 100
116
- */
117
- batchSize?: number;
118
- /**
119
- * Timeout in milliseconds for sending batches regardless of size
120
- * @default 5000
121
- */
122
- batchSendTimeout?: number;
123
- /**
124
- * Delimiter to use between log entries in batch mode
125
- * @default "\n"
126
- */
127
- batchSendDelimiter?: string;
128
- /**
129
- * Batch mode for sending multiple log entries
130
- * - "delimiter": Join entries with a delimiter (default)
131
- * - "field": Wrap entries in an object with a field name
132
- * - "array": Send entries as a plain JSON array
133
- * @default "delimiter"
134
- */
135
- batchMode?: "delimiter" | "field" | "array";
136
- /**
137
- * Field name to wrap batch entries in when batchMode is "field" (e.g., "batch" for Logflare)
138
- * @default undefined
139
- */
140
- batchFieldName?: string;
141
- /**
142
- * Maximum size of a single log entry in bytes
143
- * @default 1048576 (1MB)
144
- */
145
- maxLogSize?: number;
146
- /**
147
- * Maximum size of the payload (uncompressed) in bytes
148
- * @default 5242880 (5MB)
149
- */
150
- maxPayloadSize?: number;
151
- /**
152
- * Whether to enable Next.js Edge Runtime compatibility mode
153
- * When enabled, TextEncoder and compression are disabled
154
- * @default false
155
- */
156
- enableNextJsEdgeCompat?: boolean;
34
+ /**
35
+ * The URL to send logs to
36
+ */
37
+ url: string;
38
+ /**
39
+ * HTTP method to use for requests
40
+ * @default "POST"
41
+ */
42
+ method?: string;
43
+ /**
44
+ * Headers to include in the request. Can be an object or a function that returns headers.
45
+ */
46
+ headers?: Record<string, string> | (() => Record<string, string>);
47
+ /**
48
+ * Content type for single log requests. User-specified headers take precedence.
49
+ * @default "application/json"
50
+ */
51
+ contentType?: string;
52
+ /**
53
+ * Content type for batch log requests. User-specified headers take precedence.
54
+ * @default "application/json"
55
+ */
56
+ batchContentType?: string;
57
+ /**
58
+ * Optional callback for error handling
59
+ */
60
+ onError?: (err: Error) => void;
61
+ /**
62
+ * Optional callback for debugging log entries before they are sent
63
+ */
64
+ onDebug?: (entry: Record<string, any>) => void;
65
+ /**
66
+ * Optional callback for debugging HTTP requests and responses
67
+ */
68
+ onDebugReqRes?: (reqRes: {
69
+ req: {
70
+ url: string;
71
+ method: string;
72
+ headers: Record<string, string>;
73
+ body: string | Uint8Array;
74
+ };
75
+ res: {
76
+ status: number;
77
+ statusText: string;
78
+ headers: Record<string, string>;
79
+ body: string;
80
+ };
81
+ }) => void;
82
+ /**
83
+ * Function to transform log data into the payload format
84
+ */
85
+ payloadTemplate: (data: {
86
+ logLevel: string;
87
+ message: string;
88
+ data?: Record<string, any>;
89
+ }) => string;
90
+ /**
91
+ * Whether to use gzip compression
92
+ * @default false
93
+ */
94
+ compression?: boolean;
95
+ /**
96
+ * Number of retry attempts before giving up
97
+ * @default 3
98
+ */
99
+ maxRetries?: number;
100
+ /**
101
+ * Base delay between retries in milliseconds
102
+ * @default 1000
103
+ */
104
+ retryDelay?: number;
105
+ /**
106
+ * Whether to respect rate limiting by waiting when a 429 response is received
107
+ * @default true
108
+ */
109
+ respectRateLimit?: boolean;
110
+ /**
111
+ * Whether to enable batch sending
112
+ * @default true
113
+ */
114
+ enableBatchSend?: boolean;
115
+ /**
116
+ * Number of log entries to batch before sending
117
+ * @default 100
118
+ */
119
+ batchSize?: number;
120
+ /**
121
+ * Timeout in milliseconds for sending batches regardless of size
122
+ * @default 5000
123
+ */
124
+ batchSendTimeout?: number;
125
+ /**
126
+ * Delimiter to use between log entries in batch mode
127
+ * @default "\n"
128
+ */
129
+ batchSendDelimiter?: string;
130
+ /**
131
+ * Batch mode for sending multiple log entries
132
+ * - "delimiter": Join entries with a delimiter (default)
133
+ * - "field": Wrap entries in an object with a field name
134
+ * - "array": Send entries as a plain JSON array
135
+ * @default "delimiter"
136
+ */
137
+ batchMode?: "delimiter" | "field" | "array";
138
+ /**
139
+ * Field name to wrap batch entries in when batchMode is "field" (e.g., "batch" for Logflare)
140
+ * @default undefined
141
+ */
142
+ batchFieldName?: string;
143
+ /**
144
+ * Maximum size of a single log entry in bytes
145
+ * @default 1048576 (1MB)
146
+ */
147
+ maxLogSize?: number;
148
+ /**
149
+ * Maximum size of the payload (uncompressed) in bytes
150
+ * @default 5242880 (5MB)
151
+ */
152
+ maxPayloadSize?: number;
153
+ /**
154
+ * Whether to enable Next.js Edge Runtime compatibility mode
155
+ * When enabled, TextEncoder and compression are disabled
156
+ * @default false
157
+ */
158
+ enableNextJsEdgeCompat?: boolean;
157
159
  }
158
160
  /**
159
161
  * HttpTransport is responsible for sending logs to any HTTP endpoint.
@@ -171,61 +173,67 @@ interface HttpTransportConfig extends LoggerlessTransportConfig {
171
173
  * - Payload size tracking for batching
172
174
  */
173
175
  declare class HttpTransport extends LoggerlessTransport {
174
- private url;
175
- private method;
176
- private headers;
177
- private contentType;
178
- private batchContentType;
179
- private onError?;
180
- private onDebug?;
181
- private onDebugReqRes?;
182
- private payloadTemplate;
183
- private compression;
184
- private maxRetries;
185
- private retryDelay;
186
- private respectRateLimit;
187
- private enableBatchSend;
188
- private batchSize;
189
- private batchSendTimeout;
190
- private batchSendDelimiter;
191
- private batchMode;
192
- private batchFieldName?;
193
- private maxLogSize;
194
- private maxPayloadSize;
195
- private enableNextJsEdgeCompat;
196
- private batchQueue;
197
- private batchTimeout?;
198
- private isProcessingBatch;
199
- private currentBatchSize;
200
- /**
201
- * Creates a new instance of HttpTransport.
202
- *
203
- * @param config - Configuration options for the transport
204
- */
205
- constructor(config: HttpTransportConfig);
206
- /**
207
- * Processes and ships log entries to the HTTP endpoint.
208
- *
209
- * @param params - Log parameters including level, messages, and metadata
210
- * @returns The original messages array
211
- */
212
- shipToLogger({ logLevel, messages, data, hasData }: LogLayerTransportParams): any[];
213
- /**
214
- * Adds a payload to the batch queue and triggers sending if conditions are met
215
- */
216
- private addToBatch;
217
- /**
218
- * Processes the current batch and sends it to the HTTP endpoint
219
- */
220
- private processBatch;
221
- /**
222
- * Sends a batch of payloads to the HTTP endpoint
223
- */
224
- private sendBatch;
225
- /**
226
- * Sends a single payload to the HTTP endpoint
227
- */
228
- private sendPayload;
176
+ private url;
177
+ private method;
178
+ private headers;
179
+ private contentType;
180
+ private batchContentType;
181
+ private onError?;
182
+ private onDebug?;
183
+ private onDebugReqRes?;
184
+ private payloadTemplate;
185
+ private compression;
186
+ private maxRetries;
187
+ private retryDelay;
188
+ private respectRateLimit;
189
+ private enableBatchSend;
190
+ private batchSize;
191
+ private batchSendTimeout;
192
+ private batchSendDelimiter;
193
+ private batchMode;
194
+ private batchFieldName?;
195
+ private maxLogSize;
196
+ private maxPayloadSize;
197
+ private enableNextJsEdgeCompat;
198
+ private batchQueue;
199
+ private batchTimeout?;
200
+ private isProcessingBatch;
201
+ private currentBatchSize;
202
+ /**
203
+ * Creates a new instance of HttpTransport.
204
+ *
205
+ * @param config - Configuration options for the transport
206
+ */
207
+ constructor(config: HttpTransportConfig);
208
+ /**
209
+ * Processes and ships log entries to the HTTP endpoint.
210
+ *
211
+ * @param params - Log parameters including level, messages, and metadata
212
+ * @returns The original messages array
213
+ */
214
+ shipToLogger({
215
+ logLevel,
216
+ messages,
217
+ data,
218
+ hasData
219
+ }: LogLayerTransportParams): any[];
220
+ /**
221
+ * Adds a payload to the batch queue and triggers sending if conditions are met
222
+ */
223
+ private addToBatch;
224
+ /**
225
+ * Processes the current batch and sends it to the HTTP endpoint
226
+ */
227
+ private processBatch;
228
+ /**
229
+ * Sends a batch of payloads to the HTTP endpoint
230
+ */
231
+ private sendBatch;
232
+ /**
233
+ * Sends a single payload to the HTTP endpoint
234
+ */
235
+ private sendPayload;
229
236
  }
230
-
237
+ //#endregion
231
238
  export { HttpTransport, type HttpTransportConfig, HttpTransportError, LogSizeError, RateLimitError };
239
+ //# sourceMappingURL=index.d.cts.map