logixia 1.13.3 → 2.0.4

package/dist/{cloudwatch.transport-DZ6ies7g.mjs → cloudwatch.transport-BTvYfLs9.mjs}

@@ -1,15 +1,22 @@
-import { r as internalWarn } from "./internal-log-Cm8SOWSV.mjs";
-import { i as stringifyForLog } from "./safe-stringify-DJ66tW5I.mjs";
-import { a as httpRequest, i as HttpError, n as DEFAULT_MAX_BUFFER_SIZE, o as isPermanentHttpError, r as DEFAULT_REQUEST_TIMEOUT_MS, t as BatchBuffer } from "./batch-buffer-PGvSgbmd.mjs";
-import { t as mergeCoreFields } from "./entry-fields-BJkuPnIg.mjs";
-import * as fs from "node:fs";
+import { r as internalWarn } from "./internal-log-uCSd1PMc.mjs";
+import { n as protectSecrets, o as urlSecrets } from "./secret-config-BegMLkYl.mjs";
+import { i as stringifyForLog } from "./safe-stringify-BMRl3EX3.mjs";
+import { t as mergeCoreFields } from "./entry-fields-CGuvT2R0.mjs";
+import { a as httpRequest, i as HttpError, o as isPermanentHttpError, t as BatchBuffer } from "./batch-buffer-0fgLmIPn.mjs";
+import * as crypto from "node:crypto";
 import * as os from "node:os";
+import * as fs from "node:fs";
 import * as path$1 from "node:path";
-import * as crypto from "node:crypto";
-
-//#region src/transports/aws-credentials.ts
-const REFRESH_MARGIN_MS = 300 * 1e3;
-const FAILURE_BACKOFF_MS = 30 * 1e3;
+// src/transports/aws-credentials.ts
+/**
+* AWS credential resolution without the SDK.
+*
+* Order: explicit config, environment variables, shared credentials file,
+* ECS/container credentials, EC2 instance metadata (IMDSv2).
+* Not supported: SSO, assume-role profiles, credential_process, web identity.
+*/
+const REFRESH_MARGIN_MS = 3e5;
+const FAILURE_BACKOFF_MS = 3e4;
 const METADATA_TIMEOUT_MS = 2e3;
 /** Parse the sections of an AWS ini file into `{ section: { key: value } }`. */
 function parseIni(text) {
@@ -68,7 +75,7 @@ function fromDocument(raw) {
 		expiresAt: Number.isNaN(expiresAt) ? void 0 : expiresAt
 	};
 }
-const CONTAINER_HOSTS = new Set([
+const CONTAINER_HOSTS = /* @__PURE__ */ new Set([
 	"169.254.170.2",
 	"169.254.170.23",
 	"[fd00:ec2::23]",
@@ -113,8 +120,7 @@ async function fromInstanceMetadata() {
 		timeoutMs: METADATA_TIMEOUT_MS,
 		label: "EC2 instance metadata"
 	});
-	const session = await get("/latest/api/token", "PUT", { "X-aws-ec2-metadata-token-ttl-seconds": "21600" });
-	const auth = { "X-aws-ec2-metadata-token": session.body.trim() };
+	const auth = { "X-aws-ec2-metadata-token": (await get("/latest/api/token", "PUT", { "X-aws-ec2-metadata-token-ttl-seconds": "21600" })).body.trim() };
 	const role = (_roles$body$split$ = (await get("/latest/meta-data/iam/security-credentials/", "GET", auth)).body.split("\n")[0]) === null || _roles$body$split$ === void 0 ? void 0 : _roles$body$split$.trim();
 	if (!role) return void 0;
 	return fromDocument((await get(`/latest/meta-data/iam/security-credentials/${encodeURIComponent(role)}`, "GET", auth)).body);
@@ -122,6 +128,7 @@ async function fromInstanceMetadata() {
 var AwsCredentialProvider = class {
 	constructor(config) {
 		this.failedAt = 0;
+		protectSecrets(this, ["cached", "explicit"]);
 		if (config.accessKeyId && config.secretAccessKey) this.explicit = {
 			accessKeyId: config.accessKeyId,
 			secretAccessKey: config.secretAccessKey,
@@ -149,6 +156,19 @@ var AwsCredentialProvider = class {
 		this.cached = found;
 		return found;
 	}
+	/** Secret values this provider may hold, for scrubbing error text. */
+	secretValues() {
+		var _this$explicit, _this$explicit2, _this$cached, _this$cached2;
+		const env = process.env;
+		return [
+			(_this$explicit = this.explicit) === null || _this$explicit === void 0 ? void 0 : _this$explicit.secretAccessKey,
+			(_this$explicit2 = this.explicit) === null || _this$explicit2 === void 0 ? void 0 : _this$explicit2.sessionToken,
+			(_this$cached = this.cached) === null || _this$cached === void 0 ? void 0 : _this$cached.secretAccessKey,
+			(_this$cached2 = this.cached) === null || _this$cached2 === void 0 ? void 0 : _this$cached2.sessionToken,
+			env["AWS_SECRET_ACCESS_KEY"],
+			env["AWS_SESSION_TOKEN"]
+		];
+	}
 	invalidate() {
 		this.cached = void 0;
 		this.failedAt = 0;
@@ -157,14 +177,15 @@ var AwsCredentialProvider = class {
 		return c.expiresAt !== void 0 && c.expiresAt - Date.now() < REFRESH_MARGIN_MS;
 	}
 };
-
-//#endregion
-//#region src/transports/aws-sigv4.ts
+// src/transports/aws-sigv4.ts
+/**
+* AWS Signature Version 4 request signing, dependency-free.
+*/
 const sha256Hex = (data) => crypto.createHash("sha256").update(data).digest("hex");
 const hmac = (key, msg) => crypto.createHmac("sha256", key).update(msg).digest();
 /** Returns the request headers (lowercase names) with `x-amz-date` and `authorization` added. */
 function signV4(opts) {
-	const { method, path: path$2, query = "", body, region, service, credentials, headers: input, date } = opts;
+	const { method, path, query = "", body, region, service, credentials, headers: input, date } = opts;
 	const amzDate = (date ?? /* @__PURE__ */ new Date()).toISOString().replace(/[:-]|\.\d{3}/g, "");
 	const dateStamp = amzDate.slice(0, 8);
 	const headers = {};
@@ -176,7 +197,7 @@ function signV4(opts) {
 	const signedHeaders = names.join(";");
 	const canonicalRequest = [
 		method,
-		path$2,
+		path,
 		query,
 		canonicalHeaders,
 		signedHeaders,
@@ -194,13 +215,11 @@ function signV4(opts) {
 	headers["authorization"] = `AWS4-HMAC-SHA256 Credential=${credentials.accessKeyId}/${scope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
 	return headers;
 }
-
-//#endregion
-//#region src/transports/cloudwatch.transport.ts
+// src/transports/cloudwatch.transport.ts
 const MAX_EVENTS_PER_PUT = 1e4;
 const EMF_MAX_METRICS = 100;
 /** Error types worth retrying even though CloudWatch reports them as HTTP 400. */
-const RETRYABLE_TYPES = new Set([
+const RETRYABLE_TYPES = /* @__PURE__ */ new Set([
 	"ThrottlingException",
 	"ThrottledException",
 	"LimitExceededException",
@@ -236,18 +255,20 @@ var CloudWatchTransport = class {
 		this.emf = config.emf ?? false;
 		this.emfMetrics = config.emfMetrics ? new Set(config.emfMetrics) : void 0;
 		this.level = config.level;
-		this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;
+		this.requestTimeoutMs = config.requestTimeoutMs ?? 1e4;
 		this.buffer = new BatchBuffer({
 			name: "CloudWatchTransport",
 			batchSize: this.batchSize,
-			maxBufferSize: config.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE,
+			maxBufferSize: config.maxBufferSize ?? 1e4,
 			send: (events) => this.putLogEvents(events),
+			secrets: () => [...this.credentials.secretValues(), ...urlSecrets(this.endpoint)],
 			shouldRetry: (err) => !isPermanentHttpError(err) || RETRYABLE_TYPES.has(awsErrorType(err) ?? "")
 		});
 		this.flushTimer = setInterval(() => {
 			this.flush().catch(() => {});
 		}, this.flushInterval);
 		if (this.flushTimer.unref) this.flushTimer.unref();
+		protectSecrets(this, ["credentials", "endpoint"]);
 	}
 	write(entry) {
 		const timestamp = entry.timestamp ? new Date(entry.timestamp).getTime() : Date.now();
@@ -357,11 +378,16 @@ var CloudWatchTransport = class {
 			headers,
 			body,
 			timeoutMs: this.requestTimeoutMs,
-			label: `CloudWatch ${action}`
+			label: `CloudWatch ${action}`,
+			secrets: () => [
+				...this.credentials.secretValues(),
+				headers["authorization"],
+				headers["x-amz-security-token"],
+				...urlSecrets(this.endpoint)
+			]
 		});
 	}
 };
-
-//#endregion
 export { CloudWatchTransport as t };
-//# sourceMappingURL=cloudwatch.transport-DZ6ies7g.mjs.map
+
+//# sourceMappingURL=cloudwatch.transport-BTvYfLs9.mjs.map

package/dist/cloudwatch.transport-BTvYfLs9.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudwatch.transport-BTvYfLs9.mjs","names":["path"],"sources":["../src/transports/aws-credentials.ts","../src/transports/aws-sigv4.ts","../src/transports/cloudwatch.transport.ts"],"sourcesContent":["/**\n * AWS credential resolution without the SDK.\n *\n * Order: explicit config, environment variables, shared credentials file,\n * ECS/container credentials, EC2 instance metadata (IMDSv2).\n * Not supported: SSO, assume-role profiles, credential_process, web identity.\n */\n\nimport * as fs from 'node:fs';\nimport * as os from 'node:os';\nimport * as path from 'node:path';\n\nimport { internalWarn } from '../utils/internal-log';\nimport { type AwsCredentials } from './aws-sigv4';\nimport { httpRequest } from './batch-buffer';\nimport { protectSecrets } from './secret-config';\n\nconst REFRESH_MARGIN_MS = 5 * 60 * 1000;\nconst FAILURE_BACKOFF_MS = 30 * 1000;\nconst METADATA_TIMEOUT_MS = 2000;\n\nexport interface AwsCredentialConfig {\n  accessKeyId?: string | undefined;\n  secretAccessKey?: string | undefined;\n  sessionToken?: string | undefined;\n}\n\n/** Parse the sections of an AWS ini file into `{ section: { key: value } }`. */\nexport function parseIni(text: string): Record<string, Record<string, string>> {\n  const out: Record<string, Record<string, string>> = {};\n  let section: Record<string, string> | undefined;\n  for (const raw of text.split(/\\r?\\n/)) {\n    const line = raw.trim();\n    if (!line || line.startsWith('#') || line.startsWith(';')) continue;\n    const header = /^\\[(.+)\\]$/.exec(line);\n    if (header) {\n      section = out[header[1]!.trim()] = out[header[1]!.trim()] ?? {};\n      continue;\n    }\n    const eq = line.indexOf('=');\n    if (eq > 0 && section) section[line.slice(0, eq).trim()] = line.slice(eq + 1).trim();\n  }\n  return out;\n}\n\nfunction fromEnv(): AwsCredentials | undefined {\n  const accessKeyId = process.env['AWS_ACCESS_KEY_ID'];\n  const secretAccessKey = process.env['AWS_SECRET_ACCESS_KEY'];\n  if (!accessKeyId || !secretAccessKey) return undefined;\n  return { accessKeyId, secretAccessKey, sessionToken: process.env['AWS_SESSION_TOKEN'] };\n}\n\nfunction fromSharedFile(): AwsCredentials | undefined {\n  const file =\n    process.env['AWS_SHARED_CREDENTIALS_FILE'] ?? path.join(os.homedir(), '.aws', 'credentials');\n  const profile = process.env['AWS_PROFILE'] ?? 'default';\n  let text: string;\n  try {\n    text = fs.readFileSync(file, 'utf8');\n  } catch {\n    return undefined;\n  }\n  const section = parseIni(text)[profile];\n  const accessKeyId = section?.['aws_access_key_id'];\n  const secretAccessKey = section?.['aws_secret_access_key'];\n  if (!accessKeyId || !secretAccessKey) return undefined;\n  return { accessKeyId, secretAccessKey, sessionToken: section?.['aws_session_token'] };\n}\n\ninterface CredentialDocument {\n  AccessKeyId?: string;\n  SecretAccessKey?: string;\n  Token?: string;\n  Expiration?: string;\n}\n\nfunction fromDocument(raw: string): AwsCredentials | undefined {\n  const doc = JSON.parse(raw) as CredentialDocument;\n  if (!doc.AccessKeyId || !doc.SecretAccessKey) return undefined;\n  const expiresAt = doc.Expiration ? Date.parse(doc.Expiration) : Number.NaN;\n  return {\n    accessKeyId: doc.AccessKeyId,\n    secretAccessKey: doc.SecretAccessKey,\n    sessionToken: doc.Token,\n    expiresAt: Number.isNaN(expiresAt) ? undefined : expiresAt,\n  };\n}\n\nconst CONTAINER_HOSTS = new Set([\n  // eslint-disable-next-line sonarjs/no-hardcoded-ip -- fixed ECS credentials endpoint\n  '169.254.170.2',\n  // eslint-disable-next-line sonarjs/no-hardcoded-ip -- fixed EKS pod identity endpoint\n  '169.254.170.23',\n  '[fd00:ec2::23]',\n  'localhost',\n  '[::1]',\n]);\n\n/** Same rule as the AWS SDKs: never send the container token to an arbitrary http host. */\nfunction isAllowedContainerHost(url: URL): boolean {\n  if (url.protocol === 'https:') return true;\n  if (url.protocol !== 'http:') return false;\n  return CONTAINER_HOSTS.has(url.hostname) || /^127(?:\\.\\d{1,3}){3}$/.test(url.hostname);\n}\n\nasync function fromContainer(): Promise<AwsCredentials | undefined> {\n  const relative = process.env['AWS_CONTAINER_CREDENTIALS_RELATIVE_URI'];\n  const full = process.env['AWS_CONTAINER_CREDENTIALS_FULL_URI'];\n  if (!relative && !full) return undefined;\n  const url = new URL(relative ? `http://169.254.170.2${relative}` : (full as string));\n  if (!relative && !isAllowedContainerHost(url)) {\n    internalWarn(\n      `ignoring AWS_CONTAINER_CREDENTIALS_FULL_URI: ${url.host} is not https or a loopback / ECS / EKS address`\n    );\n    return undefined;\n  }\n  const headers: Record<string, string> = {};\n  const tokenFile = process.env['AWS_CONTAINER_AUTHORIZATION_TOKEN_FILE'];\n  const token = tokenFile\n    ? fs.readFileSync(tokenFile, 'utf8').trim()\n    : process.env['AWS_CONTAINER_AUTHORIZATION_TOKEN'];\n  if (token) headers['Authorization'] = token;\n  const res = await httpRequest({\n    url,\n    method: 'GET',\n    headers,\n    timeoutMs: METADATA_TIMEOUT_MS,\n    label: 'AWS container credentials',\n  });\n  return fromDocument(res.body);\n}\n\nasync function fromInstanceMetadata(): Promise<AwsCredentials | undefined> {\n  if (process.env['AWS_EC2_METADATA_DISABLED'] === 'true') return undefined;\n  const base = process.env['AWS_EC2_METADATA_SERVICE_ENDPOINT'] ?? 'http://169.254.169.254';\n  const get = (p: string, method: string, headers: Record<string, string>) =>\n    httpRequest({\n      url: new URL(p, base),\n      method,\n      headers,\n      timeoutMs: METADATA_TIMEOUT_MS,\n      label: 'EC2 instance metadata',\n    });\n  const session = await get('/latest/api/token', 'PUT', {\n    'X-aws-ec2-metadata-token-ttl-seconds': '21600',\n  });\n  const auth = { 'X-aws-ec2-metadata-token': session.body.trim() };\n  const roles = await get('/latest/meta-data/iam/security-credentials/', 'GET', auth);\n  const role = roles.body.split('\\n')[0]?.trim();\n  if (!role) return undefined;\n  const creds = await get(\n    `/latest/meta-data/iam/security-credentials/${encodeURIComponent(role)}`,\n    'GET',\n    auth\n  );\n  return fromDocument(creds.body);\n}\n\nexport class AwsCredentialProvider {\n  private cached: AwsCredentials | undefined;\n  private failedAt = 0;\n  private readonly explicit: AwsCredentials | undefined;\n\n  constructor(config: AwsCredentialConfig) {\n    protectSecrets(this, ['cached', 'explicit']);\n    if (config.accessKeyId && config.secretAccessKey) {\n      this.explicit = {\n        accessKeyId: config.accessKeyId,\n        secretAccessKey: config.secretAccessKey,\n        sessionToken: config.sessionToken,\n      };\n    }\n  }\n\n  /** Throws when no source yields credentials, so the caller keeps its buffer. */\n  async get(): Promise<AwsCredentials> {\n    if (this.explicit) return this.explicit;\n    const env = fromEnv();\n    if (env) return env;\n    if (this.cached && !this.isExpiring(this.cached)) return this.cached;\n    if (Date.now() - this.failedAt < FAILURE_BACKOFF_MS) {\n      throw new Error('no AWS credentials found (retrying shortly)');\n    }\n\n    let found = fromSharedFile();\n    for (const source of [fromContainer, fromInstanceMetadata]) {\n      if (found) break;\n      try {\n        found = await source();\n      } catch {\n        /* source not available here; try the next */\n      }\n    }\n    if (!found) {\n      this.failedAt = Date.now();\n      throw new Error(\n        'no AWS credentials found: set AWS_ACCESS_KEY_ID/AWS_SECRET_ACCESS_KEY, a shared credentials file, container credentials, or run on EC2 with an instance role'\n      );\n    }\n    this.cached = found;\n    return found;\n  }\n\n  /** Secret values this provider may hold, for scrubbing error text. */\n  secretValues(): (string | undefined)[] {\n    const env = process.env;\n    return [\n      this.explicit?.secretAccessKey,\n      this.explicit?.sessionToken,\n      this.cached?.secretAccessKey,\n      this.cached?.sessionToken,\n      env['AWS_SECRET_ACCESS_KEY'],\n      env['AWS_SESSION_TOKEN'],\n    ];\n  }\n\n  invalidate(): void {\n    this.cached = undefined;\n    this.failedAt = 0;\n  }\n\n  private isExpiring(c: AwsCredentials): boolean {\n    return c.expiresAt !== undefined && c.expiresAt - Date.now() < REFRESH_MARGIN_MS;\n  }\n}\n","/**\n * AWS Signature Version 4 request signing, dependency-free.\n */\n\nimport * as crypto from 'node:crypto';\n\nexport interface AwsCredentials {\n  accessKeyId: string;\n  secretAccessKey: string;\n  sessionToken?: string | undefined;\n  /** Epoch ms after which the credentials are no longer valid. */\n  expiresAt?: number | undefined;\n}\n\nexport interface SignV4Options {\n  method: string;\n  path: string;\n  query?: string;\n  /** Must include `host`. Names are lowercased before signing. */\n  headers: Record<string, string>;\n  body: string;\n  region: string;\n  service: string;\n  credentials: AwsCredentials;\n  date?: Date;\n}\n\nconst sha256Hex = (data: string): string => crypto.createHash('sha256').update(data).digest('hex');\n\nconst hmac = (key: Buffer | string, msg: string): Buffer =>\n  crypto.createHmac('sha256', key).update(msg).digest();\n\n/** Returns the request headers (lowercase names) with `x-amz-date` and `authorization` added. */\nexport function signV4(opts: SignV4Options): Record<string, string> {\n  const {\n    method,\n    path,\n    query = '',\n    body,\n    region,\n    service,\n    credentials,\n    headers: input,\n    date,\n  } = opts;\n  const amzDate = (date ?? new Date()).toISOString().replace(/[:-]|\\.\\d{3}/g, '');\n  const dateStamp = amzDate.slice(0, 8);\n\n  const headers: Record<string, string> = {};\n  for (const [k, v] of Object.entries(input)) headers[k.toLowerCase()] = v;\n  headers['x-amz-date'] = amzDate;\n  if (credentials.sessionToken) headers['x-amz-security-token'] = credentials.sessionToken;\n\n  const names = Object.keys(headers).sort();\n  const canonicalHeaders = names\n    .map((n) => `${n}:${headers[n]!.trim().replace(/\\s+/g, ' ')}\\n`)\n    .join('');\n  const signedHeaders = names.join(';');\n\n  const canonicalRequest = [\n    method,\n    path,\n    query,\n    canonicalHeaders,\n    signedHeaders,\n    sha256Hex(body),\n  ].join('\\n');\n  const scope = `${dateStamp}/${region}/${service}/aws4_request`;\n  const stringToSign = ['AWS4-HMAC-SHA256', amzDate, scope, sha256Hex(canonicalRequest)].join('\\n');\n\n  const signingKey = hmac(\n    hmac(hmac(hmac(`AWS4${credentials.secretAccessKey}`, dateStamp), region), service),\n    'aws4_request'\n  );\n  const signature = crypto.createHmac('sha256', signingKey).update(stringToSign).digest('hex');\n\n  headers['authorization'] =\n    `AWS4-HMAC-SHA256 Credential=${credentials.accessKeyId}/${scope}, ` +\n    `SignedHeaders=${signedHeaders}, Signature=${signature}`;\n  return headers;\n}\n","/**\n * logixia — AWS CloudWatch Logs transport\n *\n * Sends log entries to AWS CloudWatch Logs via the PutLogEvents API.\n * Supports EMF (Embedded Metric Format) for automatic metric extraction.\n *\n * Auth, in order: explicit config, environment variables, the shared\n * credentials file (AWS_PROFILE, AWS_SHARED_CREDENTIALS_FILE), ECS container\n * credentials, then EC2 instance metadata (IMDSv2). SSO, assume-role profiles\n * and credential_process are not supported. No SDK dependency — raw HTTPS with\n * AWS Signature Version 4.\n *\n * The log group and stream are created on first use if they do not exist.\n *\n * @example\n * ```ts\n * import { CloudWatchTransport } from 'logixia';\n *\n * const logger = createLogger({\n *   transports: {\n *     cloudwatch: new CloudWatchTransport({\n *       region: 'us-east-1',\n *       logGroupName: '/myapp/production',\n *       logStreamName: `api-${process.env.HOSTNAME}`,\n *       batchSize: 100,\n *       flushIntervalMs: 5000,\n *     }),\n *   },\n * });\n * ```\n */\n\nimport type { IAsyncTransport, TransportLogEntry } from '../types/transport.types';\nimport { internalWarn } from '../utils/internal-log';\nimport { stringifyForLog } from '../utils/safe-stringify';\nimport { AwsCredentialProvider } from './aws-credentials';\nimport { signV4 } from './aws-sigv4';\nimport {\n  BatchBuffer,\n  DEFAULT_MAX_BUFFER_SIZE,\n  DEFAULT_REQUEST_TIMEOUT_MS,\n  HttpError,\n  httpRequest,\n  isPermanentHttpError,\n} from './batch-buffer';\nimport { mergeCoreFields } from './entry-fields';\nimport { protectSecrets, urlSecrets } from './secret-config';\n\nexport interface CloudWatchTransportConfig {\n  /** AWS region, e.g. `'us-east-1'`. Falls back to `AWS_REGION` env var. */\n  region?: string;\n  /** CloudWatch Logs group name. Created automatically if it does not exist. */\n  logGroupName: string;\n  /** CloudWatch Logs stream name. Defaults to hostname + process PID. */\n  logStreamName?: string;\n  /** Override the Logs endpoint, e.g. for LocalStack. Default: `https://logs.<region>.amazonaws.com`. */\n  endpoint?: string;\n  /** AWS access key ID. Falls back to the credential chain described above. */\n  accessKeyId?: string;\n  /** AWS secret access key. Used together with `accessKeyId`. */\n  secretAccessKey?: string;\n  /** AWS session token for temporary credentials. Used together with `accessKeyId`. */\n  sessionToken?: string;\n  /**\n   * Number of log events to batch before flushing.\n   * CloudWatch allows max 10,000 events per PutLogEvents call; larger values are capped.\n   * @default 100\n   */\n  batchSize?: number;\n  /**\n   * Max ms between flushes even if batchSize is not reached.\n   * @default 5000\n   */\n  flushIntervalMs?: number;\n  /**\n   * Enable EMF (Embedded Metric Format) — wraps log entries as CloudWatch\n   * metric namespaces so numeric fields become CloudWatch Metrics automatically.\n   * @default false\n   */\n  emf?: boolean;\n  /** CloudWatch Metrics namespace used by EMF. @default 'Logixia' */\n  emfNamespace?: string;\n  /**\n   * Payload fields published as EMF metrics. When set, only these numeric\n   * fields become metrics; when unset every numeric payload field does (up to\n   * the EMF limit of 100 per entry).\n   */\n  emfMetrics?: string[];\n  /** Abort a request that has not finished after this many ms. @default 10000 */\n  requestTimeoutMs?: number;\n  /** Max buffered events; the oldest are dropped past this. @default 10000 */\n  maxBufferSize?: number;\n  /** Minimum log level to forward. */\n  level?: string;\n}\n\nconst MAX_EVENTS_PER_PUT = 10_000;\nconst EMF_MAX_METRICS = 100;\n\n/** Error types worth retrying even though CloudWatch reports them as HTTP 400. */\nconst RETRYABLE_TYPES = new Set([\n  'ThrottlingException',\n  'ThrottledException',\n  'LimitExceededException',\n  'ServiceUnavailableException',\n  'ExpiredTokenException',\n  'ResourceNotFoundException',\n]);\n\nfunction awsErrorType(err: unknown): string | undefined {\n  if (!(err instanceof HttpError)) return undefined;\n  try {\n    const type = (JSON.parse(err.body) as { __type?: string }).__type;\n    return type?.split('#').pop();\n  } catch {\n    return undefined;\n  }\n}\n\ninterface CwLogEvent {\n  timestamp: number;\n  message: string;\n}\n\n/**\n * AWS CloudWatch Logs transport with EMF support and batched PutLogEvents calls.\n */\nexport class CloudWatchTransport implements IAsyncTransport {\n  public readonly name = 'cloudwatch';\n  public readonly batchSize: number;\n  public readonly flushInterval: number;\n  public readonly level: string | undefined;\n\n  private readonly buffer: BatchBuffer<CwLogEvent>;\n  private readonly requestTimeoutMs: number;\n  private flushTimer: NodeJS.Timeout | null = null;\n  private readonly credentials: AwsCredentialProvider;\n  private readonly endpoint: URL;\n  private streamReady = false;\n\n  private readonly region: string;\n  private readonly logGroupName: string;\n  private readonly logStreamName: string;\n  private readonly emf: boolean;\n  private readonly emfNamespace: string;\n  private readonly emfMetrics: ReadonlySet<string> | undefined;\n\n  constructor(config: CloudWatchTransportConfig) {\n    this.region =\n      config.region ??\n      process.env['AWS_REGION'] ??\n      process.env['AWS_DEFAULT_REGION'] ??\n      'us-east-1';\n    this.logGroupName = config.logGroupName;\n    this.logStreamName =\n      config.logStreamName ?? `${process.env['HOSTNAME'] ?? 'node'}-${process.pid}`;\n    this.credentials = new AwsCredentialProvider(config);\n    this.endpoint = new URL(config.endpoint ?? `https://logs.${this.region}.amazonaws.com`);\n    this.batchSize = Math.min(config.batchSize ?? 100, MAX_EVENTS_PER_PUT);\n    this.emfNamespace = config.emfNamespace ?? 'Logixia';\n    this.flushInterval = config.flushIntervalMs ?? 5000;\n    this.emf = config.emf ?? false;\n    this.emfMetrics = config.emfMetrics ? new Set(config.emfMetrics) : undefined;\n    this.level = config.level;\n    this.requestTimeoutMs = config.requestTimeoutMs ?? DEFAULT_REQUEST_TIMEOUT_MS;\n    this.buffer = new BatchBuffer<CwLogEvent>({\n      name: 'CloudWatchTransport',\n      batchSize: this.batchSize,\n      maxBufferSize: config.maxBufferSize ?? DEFAULT_MAX_BUFFER_SIZE,\n      send: (events) => this.putLogEvents(events),\n      secrets: () => [...this.credentials.secretValues(), ...urlSecrets(this.endpoint)],\n      shouldRetry: (err) =>\n        !isPermanentHttpError(err) || RETRYABLE_TYPES.has(awsErrorType(err) ?? ''),\n    });\n\n    this.flushTimer = setInterval(() => {\n      this.flush().catch(() => {});\n    }, this.flushInterval);\n    if (this.flushTimer.unref) this.flushTimer.unref();\n    protectSecrets(this, ['credentials', 'endpoint']);\n  }\n\n  write(entry: TransportLogEntry): void {\n    const timestamp = entry.timestamp ? new Date(entry.timestamp).getTime() : Date.now();\n    const message = this.emf ? this.toEmf(entry) : stringifyForLog(entry);\n    this.buffer.push({ timestamp, message });\n    this.buffer.flushIfFull();\n  }\n\n  flush(): Promise<void> {\n    return this.buffer.flush();\n  }\n\n  /**\n   * Flush remaining events and stop the interval timer on shutdown. Without this\n   * the manager's close() skips the transport (close was undefined) and any\n   * buffered events were lost on deploy. Waits for any in-flight send first.\n   */\n  async close(): Promise<void> {\n    if (this.flushTimer) {\n      clearInterval(this.flushTimer);\n      this.flushTimer = null;\n    }\n    await this.buffer.close();\n  }\n\n  private toEmf(entry: TransportLogEntry): string {\n    const { level, message, data: payload, timestamp } = entry;\n    const fields = mergeCoreFields({ _aws: undefined, level, message }, payload);\n    const metricNames: string[] = [];\n    for (const [k, v] of Object.entries(fields)) {\n      if (k === '_aws' || k === 'level' || k === 'message' || typeof v !== 'number') continue;\n      if (this.emfMetrics && !this.emfMetrics.has(k)) continue;\n      if (metricNames.length < EMF_MAX_METRICS) metricNames.push(k);\n    }\n    fields['_aws'] = {\n      Timestamp: timestamp ? new Date(timestamp).getTime() : Date.now(),\n      CloudWatchMetrics:\n        metricNames.length > 0\n          ? [\n              {\n                Namespace: this.emfNamespace,\n                Dimensions: [['level']],\n                Metrics: metricNames.map((n) => ({ Name: n, Unit: 'None' })),\n              },\n            ]\n          : [],\n    };\n    return stringifyForLog(fields);\n  }\n\n  private async putLogEvents(events: CwLogEvent[]): Promise<void> {\n    await this.ensureStream();\n    const logEvents = [...events].sort((a, b) => a.timestamp - b.timestamp);\n    try {\n      await this.call('PutLogEvents', {\n        logGroupName: this.logGroupName,\n        logStreamName: this.logStreamName,\n        logEvents,\n      });\n    } catch (err) {\n      const type = awsErrorType(err);\n      if (type === 'DataAlreadyAcceptedException') return;\n      if (type === 'ResourceNotFoundException') this.streamReady = false;\n      if (type === 'ExpiredTokenException') this.credentials.invalidate();\n      throw err;\n    }\n  }\n\n  private async ensureStream(): Promise<void> {\n    if (this.streamReady) return;\n    try {\n      await this.call('CreateLogGroup', { logGroupName: this.logGroupName });\n    } catch (err) {\n      if (awsErrorType(err) === 'ExpiredTokenException') this.credentials.invalidate();\n      if (!(err instanceof HttpError)) throw err;\n      if (awsErrorType(err) !== 'ResourceAlreadyExistsException') {\n        internalWarn(`CloudWatchTransport: CreateLogGroup failed, continuing (${err.message})`);\n      }\n    }\n    try {\n      await this.call('CreateLogStream', {\n        logGroupName: this.logGroupName,\n        logStreamName: this.logStreamName,\n      });\n    } catch (err) {\n      if (awsErrorType(err) !== 'ResourceAlreadyExistsException') throw err;\n    }\n    this.streamReady = true;\n  }\n\n  private async call(action: string, payload: Record<string, unknown>): Promise<void> {\n    const credentials = await this.credentials.get();\n    const body = stringifyForLog(payload);\n    const { host } = this.endpoint;\n    const headers = signV4({\n      method: 'POST',\n      path: '/',\n      headers: {\n        host,\n        'content-type': 'application/x-amz-json-1.1',\n        'x-amz-target': `Logs_20140328.${action}`,\n      },\n      body,\n      region: this.region,\n      service: 'logs',\n      credentials,\n    });\n    await httpRequest({\n      url: this.endpoint,\n      headers,\n      body,\n      timeoutMs: this.requestTimeoutMs,\n      label: `CloudWatch ${action}`,\n      secrets: () => [\n        ...this.credentials.secretValues(),\n        headers['authorization'],\n        headers['x-amz-security-token'],\n        ...urlSecrets(this.endpoint),\n      ],\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/{cloudwatch.transport-B00st6Xv.d.ts → cloudwatch.transport-Bf7L4I59.d.ts}

@@ -1,7 +1,4 @@
-import { p as TransportLogEntry, s as IAsyncTransport } from "./transport.types-DqVLZTyf.js";
-
-//#region src/transports/cloudwatch.transport.d.ts
-
+import { p as TransportLogEntry, s as IAsyncTransport } from "./transport.types-BJVL1QQl.js";
 interface CloudWatchTransportConfig {
   /** AWS region, e.g. `'us-east-1'`. Falls back to `AWS_REGION` env var. */
   region?: string;
@@ -83,6 +80,5 @@ declare class CloudWatchTransport implements IAsyncTransport {
   private ensureStream;
   private call;
 }
-//#endregion
 export { CloudWatchTransportConfig as n, CloudWatchTransport as t };
-//# sourceMappingURL=cloudwatch.transport-B00st6Xv.d.ts.map
+//# sourceMappingURL=cloudwatch.transport-Bf7L4I59.d.ts.map

package/dist/cloudwatch.transport-Bf7L4I59.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudwatch.transport-Bf7L4I59.d.ts","names":[],"sources":["../src/transports/cloudwatch.transport.ts"],"mappings":";UAgDiB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;;;;EAKA;;;;;;EAMA;;EAEA;;;;;;EAMA;;EAEA;;EAEA;;EAEA;;;;;cAkCW,+BAA+B;WAC1B;WACA;WACA;WACA;mBAEC;mBACA;UACT;mBACS;mBACA;UACT;mBAES;mBACA;mBACA;mBACA;mBACA;mBACA;EAEL,YAAA,QAAQ;EAmCpB,MAAM,OAAO;EAOb,SAAS;;;;;;EASH,SAAS;UAQP;UAyBM;UAkBA;UAsBA"}

package/dist/{cloudwatch.transport-Blc7Gtxt.d.mts → cloudwatch.transport-Rj4yTpRn.d.mts}

@@ -1,7 +1,4 @@
-import { p as TransportLogEntry, s as IAsyncTransport } from "./transport.types-CtNr3D7S.mjs";
-
-//#region src/transports/cloudwatch.transport.d.ts
-
+import { p as TransportLogEntry, s as IAsyncTransport } from "./transport.types-BJVL1QQl.mjs";
 interface CloudWatchTransportConfig {
   /** AWS region, e.g. `'us-east-1'`. Falls back to `AWS_REGION` env var. */
   region?: string;
@@ -83,6 +80,5 @@ declare class CloudWatchTransport implements IAsyncTransport {
   private ensureStream;
   private call;
 }
-//#endregion
 export { CloudWatchTransportConfig as n, CloudWatchTransport as t };
-//# sourceMappingURL=cloudwatch.transport-Blc7Gtxt.d.mts.map
+//# sourceMappingURL=cloudwatch.transport-Rj4yTpRn.d.mts.map

package/dist/cloudwatch.transport-Rj4yTpRn.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cloudwatch.transport-Rj4yTpRn.d.mts","names":[],"sources":["../src/transports/cloudwatch.transport.ts"],"mappings":";UAgDiB;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;EAEA;;;;;;EAMA;;;;;EAKA;;;;;;EAMA;;EAEA;;;;;;EAMA;;EAEA;;EAEA;;EAEA;;;;;cAkCW,+BAA+B;WAC1B;WACA;WACA;WACA;mBAEC;mBACA;UACT;mBACS;mBACA;UACT;mBAES;mBACA;mBACA;mBACA;mBACA;mBACA;EAEL,YAAA,QAAQ;EAmCpB,MAAM,OAAO;EAOb,SAAS;;;;;;EASH,SAAS;UAQP;UAyBM;UAkBA;UAsBA"}

package/dist/{coerce.utils-Cu6IUTgX.mjs → coerce.utils-B_rEudCn.mjs}

@@ -1,4 +1,4 @@
-//#region src/utils/coerce.utils.ts
+// src/utils/coerce.utils.ts
 /**
 * Defensive value coercion helpers for Logixia.
 *
@@ -32,7 +32,6 @@ function safeToString(value) {
 	} catch {}
 	return `[${((_constructor = value.constructor) === null || _constructor === void 0 ? void 0 : _constructor.name) ?? "object"}]`;
 }
-
-//#endregion
 export { safeToString as t };
-//# sourceMappingURL=coerce.utils-Cu6IUTgX.mjs.map
+
+//# sourceMappingURL=coerce.utils-B_rEudCn.mjs.map

package/dist/{coerce.utils-Cu6IUTgX.mjs.map → coerce.utils-B_rEudCn.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"coerce.utils-Cu6IUTgX.mjs","names":[],"sources":["../src/utils/coerce.utils.ts"],"sourcesContent":["/**\n * Defensive value coercion helpers for Logixia.\n *\n * Logger inputs come from third-party code (NestJS framework internals,\n * user payloads, error objects) where the runtime type is not always what\n * the TypeScript signature promises. The formatter / transport hot paths\n * call `.replace()` on string fields and crash if the field is anything\n * else. Use these helpers anywhere a downstream consumer assumes a string.\n */\n\n/**\n * Coerce any value to a string without throwing.\n *\n * - `undefined` / `null` → `''` (so the field is rendered as empty rather\n *   than the literal string \"undefined\")\n * - strings → returned as-is (zero allocation on the hot path)\n * - Errors → `error.message` (matches what users would expect to see)\n * - everything else → `JSON.stringify` if possible, falling back to\n *   `String(value)` for circular refs / values without a stringifier.\n */\nexport function safeToString(value: unknown): string {\n  if (typeof value === 'string') return value;\n  if (value === undefined || value === null) return '';\n  if (value instanceof Error) return value.message;\n  if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'symbol') return value.toString();\n  if (typeof value === 'function') {\n    return `[Function: ${(value as { name?: string }).name || 'anonymous'}]`;\n  }\n  // value is now narrowed to object — JSON-stringify, falling back to a\n  // constructor-name tag for circular refs / throwing toJSON.\n  try {\n    const json = JSON.stringify(value);\n    // JSON.stringify returns undefined for values it can't represent (e.g. an\n    // object whose toJSON() returns undefined). Returning that would defeat the\n    // whole point of this helper — a downstream .replace() on `undefined` throws.\n    if (json !== undefined) return json;\n  } catch {\n    /* fall through to the constructor-name tag below */\n  }\n  const ctor = (value as { constructor?: { name?: string } }).constructor?.name;\n  return `[${ctor ?? 'object'}]`;\n}\n\n/**\n * String-replace on a value that may not be a string.\n * Coerces non-strings before delegating to `String.prototype.replace`.\n */\nexport function safeReplace(value: unknown, pattern: string | RegExp, replacement: string): string {\n  return safeToString(value).replace(pattern, replacement);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,OAAwB;;AACnD,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,KAAI,iBAAiB,MAAO,QAAO,MAAM;AACzC,KAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,UAC7E,QAAO,OAAO,MAAM;AAEtB,KAAI,OAAO,UAAU,SAAU,QAAO,MAAM,UAAU;AACtD,KAAI,OAAO,UAAU,WACnB,QAAO,cAAe,MAA4B,QAAQ,YAAY;AAIxE,KAAI;EACF,MAAM,OAAO,KAAK,UAAU,MAAM;AAIlC,MAAI,SAAS,OAAW,QAAO;SACzB;AAIR,QAAO,qBADO,MAA8C,yEAAa,SACtD,SAAS"}
+{"version":3,"file":"coerce.utils-B_rEudCn.mjs","names":[],"sources":["../src/utils/coerce.utils.ts"],"sourcesContent":["/**\n * Defensive value coercion helpers for Logixia.\n *\n * Logger inputs come from third-party code (NestJS framework internals,\n * user payloads, error objects) where the runtime type is not always what\n * the TypeScript signature promises. The formatter / transport hot paths\n * call `.replace()` on string fields and crash if the field is anything\n * else. Use these helpers anywhere a downstream consumer assumes a string.\n */\n\n/**\n * Coerce any value to a string without throwing.\n *\n * - `undefined` / `null` → `''` (so the field is rendered as empty rather\n *   than the literal string \"undefined\")\n * - strings → returned as-is (zero allocation on the hot path)\n * - Errors → `error.message` (matches what users would expect to see)\n * - everything else → `JSON.stringify` if possible, falling back to\n *   `String(value)` for circular refs / values without a stringifier.\n */\nexport function safeToString(value: unknown): string {\n  if (typeof value === 'string') return value;\n  if (value === undefined || value === null) return '';\n  if (value instanceof Error) return value.message;\n  if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'symbol') return value.toString();\n  if (typeof value === 'function') {\n    return `[Function: ${(value as { name?: string }).name || 'anonymous'}]`;\n  }\n  // value is now narrowed to object — JSON-stringify, falling back to a\n  // constructor-name tag for circular refs / throwing toJSON.\n  try {\n    const json = JSON.stringify(value);\n    // JSON.stringify returns undefined for values it can't represent (e.g. an\n    // object whose toJSON() returns undefined). Returning that would defeat the\n    // whole point of this helper — a downstream .replace() on `undefined` throws.\n    if (json !== undefined) return json;\n  } catch {\n    /* fall through to the constructor-name tag below */\n  }\n  const ctor = (value as { constructor?: { name?: string } }).constructor?.name;\n  return `[${ctor ?? 'object'}]`;\n}\n\n/**\n * String-replace on a value that may not be a string.\n * Coerces non-strings before delegating to `String.prototype.replace`.\n */\nexport function safeReplace(value: unknown, pattern: string | RegExp, replacement: string): string {\n  return safeToString(value).replace(pattern, replacement);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,OAAwB;;CACnD,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO;CAClD,IAAI,iBAAiB,OAAO,OAAO,MAAM;CACzC,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAC7E,OAAO,OAAO,KAAK;CAErB,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,SAAS;CACrD,IAAI,OAAO,UAAU,YACnB,OAAO,cAAe,MAA4B,QAAQ,YAAY;CAIxE,IAAI;EACF,MAAM,OAAO,KAAK,UAAU,KAAK;EAIjC,IAAI,SAAS,KAAA,GAAW,OAAO;CACjC,QAAQ,CAER;CAEA,OAAO,MAAA,eADO,MAA8C,iBAAA,QAAA,iBAAA,KAAA,IAAA,KAAA,IAAA,aAAa,SACtD,SAAS;AAC9B"}

package/dist/{coerce.utils-B-LilukN.js → coerce.utils-C1C5sIX0.js}

@@ -1,5 +1,4 @@
-
-//#region src/utils/coerce.utils.ts
+// src/utils/coerce.utils.ts
 /**
 * Defensive value coercion helpers for Logixia.
 *
@@ -33,12 +32,11 @@ function safeToString(value) {
 	} catch {}
 	return `[${((_constructor = value.constructor) === null || _constructor === void 0 ? void 0 : _constructor.name) ?? "object"}]`;
 }
-
-//#endregion
-Object.defineProperty(exports, 'safeToString', {
-  enumerable: true,
-  get: function () {
-    return safeToString;
-  }
+Object.defineProperty(exports, "safeToString", {
+	enumerable: true,
+	get: function() {
+		return safeToString;
+	}
 });
-//# sourceMappingURL=coerce.utils-B-LilukN.js.map
+
+//# sourceMappingURL=coerce.utils-C1C5sIX0.js.map

package/dist/{coerce.utils-B-LilukN.js.map → coerce.utils-C1C5sIX0.js.map}

@@ -1 +1 @@
-{"version":3,"file":"coerce.utils-B-LilukN.js","names":[],"sources":["../src/utils/coerce.utils.ts"],"sourcesContent":["/**\n * Defensive value coercion helpers for Logixia.\n *\n * Logger inputs come from third-party code (NestJS framework internals,\n * user payloads, error objects) where the runtime type is not always what\n * the TypeScript signature promises. The formatter / transport hot paths\n * call `.replace()` on string fields and crash if the field is anything\n * else. Use these helpers anywhere a downstream consumer assumes a string.\n */\n\n/**\n * Coerce any value to a string without throwing.\n *\n * - `undefined` / `null` → `''` (so the field is rendered as empty rather\n *   than the literal string \"undefined\")\n * - strings → returned as-is (zero allocation on the hot path)\n * - Errors → `error.message` (matches what users would expect to see)\n * - everything else → `JSON.stringify` if possible, falling back to\n *   `String(value)` for circular refs / values without a stringifier.\n */\nexport function safeToString(value: unknown): string {\n  if (typeof value === 'string') return value;\n  if (value === undefined || value === null) return '';\n  if (value instanceof Error) return value.message;\n  if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'symbol') return value.toString();\n  if (typeof value === 'function') {\n    return `[Function: ${(value as { name?: string }).name || 'anonymous'}]`;\n  }\n  // value is now narrowed to object — JSON-stringify, falling back to a\n  // constructor-name tag for circular refs / throwing toJSON.\n  try {\n    const json = JSON.stringify(value);\n    // JSON.stringify returns undefined for values it can't represent (e.g. an\n    // object whose toJSON() returns undefined). Returning that would defeat the\n    // whole point of this helper — a downstream .replace() on `undefined` throws.\n    if (json !== undefined) return json;\n  } catch {\n    /* fall through to the constructor-name tag below */\n  }\n  const ctor = (value as { constructor?: { name?: string } }).constructor?.name;\n  return `[${ctor ?? 'object'}]`;\n}\n\n/**\n * String-replace on a value that may not be a string.\n * Coerces non-strings before delegating to `String.prototype.replace`.\n */\nexport function safeReplace(value: unknown, pattern: string | RegExp, replacement: string): string {\n  return safeToString(value).replace(pattern, replacement);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,OAAwB;;AACnD,KAAI,OAAO,UAAU,SAAU,QAAO;AACtC,KAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,KAAI,iBAAiB,MAAO,QAAO,MAAM;AACzC,KAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,UAC7E,QAAO,OAAO,MAAM;AAEtB,KAAI,OAAO,UAAU,SAAU,QAAO,MAAM,UAAU;AACtD,KAAI,OAAO,UAAU,WACnB,QAAO,cAAe,MAA4B,QAAQ,YAAY;AAIxE,KAAI;EACF,MAAM,OAAO,KAAK,UAAU,MAAM;AAIlC,MAAI,SAAS,OAAW,QAAO;SACzB;AAIR,QAAO,qBADO,MAA8C,yEAAa,SACtD,SAAS"}
+{"version":3,"file":"coerce.utils-C1C5sIX0.js","names":[],"sources":["../src/utils/coerce.utils.ts"],"sourcesContent":["/**\n * Defensive value coercion helpers for Logixia.\n *\n * Logger inputs come from third-party code (NestJS framework internals,\n * user payloads, error objects) where the runtime type is not always what\n * the TypeScript signature promises. The formatter / transport hot paths\n * call `.replace()` on string fields and crash if the field is anything\n * else. Use these helpers anywhere a downstream consumer assumes a string.\n */\n\n/**\n * Coerce any value to a string without throwing.\n *\n * - `undefined` / `null` → `''` (so the field is rendered as empty rather\n *   than the literal string \"undefined\")\n * - strings → returned as-is (zero allocation on the hot path)\n * - Errors → `error.message` (matches what users would expect to see)\n * - everything else → `JSON.stringify` if possible, falling back to\n *   `String(value)` for circular refs / values without a stringifier.\n */\nexport function safeToString(value: unknown): string {\n  if (typeof value === 'string') return value;\n  if (value === undefined || value === null) return '';\n  if (value instanceof Error) return value.message;\n  if (typeof value === 'number' || typeof value === 'bigint' || typeof value === 'boolean') {\n    return String(value);\n  }\n  if (typeof value === 'symbol') return value.toString();\n  if (typeof value === 'function') {\n    return `[Function: ${(value as { name?: string }).name || 'anonymous'}]`;\n  }\n  // value is now narrowed to object — JSON-stringify, falling back to a\n  // constructor-name tag for circular refs / throwing toJSON.\n  try {\n    const json = JSON.stringify(value);\n    // JSON.stringify returns undefined for values it can't represent (e.g. an\n    // object whose toJSON() returns undefined). Returning that would defeat the\n    // whole point of this helper — a downstream .replace() on `undefined` throws.\n    if (json !== undefined) return json;\n  } catch {\n    /* fall through to the constructor-name tag below */\n  }\n  const ctor = (value as { constructor?: { name?: string } }).constructor?.name;\n  return `[${ctor ?? 'object'}]`;\n}\n\n/**\n * String-replace on a value that may not be a string.\n * Coerces non-strings before delegating to `String.prototype.replace`.\n */\nexport function safeReplace(value: unknown, pattern: string | RegExp, replacement: string): string {\n  return safeToString(value).replace(pattern, replacement);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,aAAa,OAAwB;;CACnD,IAAI,OAAO,UAAU,UAAU,OAAO;CACtC,IAAI,UAAU,KAAA,KAAa,UAAU,MAAM,OAAO;CAClD,IAAI,iBAAiB,OAAO,OAAO,MAAM;CACzC,IAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAC7E,OAAO,OAAO,KAAK;CAErB,IAAI,OAAO,UAAU,UAAU,OAAO,MAAM,SAAS;CACrD,IAAI,OAAO,UAAU,YACnB,OAAO,cAAe,MAA4B,QAAQ,YAAY;CAIxE,IAAI;EACF,MAAM,OAAO,KAAK,UAAU,KAAK;EAIjC,IAAI,SAAS,KAAA,GAAW,OAAO;CACjC,QAAQ,CAER;CAEA,OAAO,MAAA,eADO,MAA8C,iBAAA,QAAA,iBAAA,KAAA,IAAA,KAAA,IAAA,aAAa,SACtD,SAAS;AAC9B"}

package/dist/correlation.d.mts

@@ -1,4 +1,3 @@
-//#region src/correlation.d.ts
 /**
  * logixia — Microservices Correlation ID Propagation
  *
@@ -52,7 +51,7 @@
  * ```
  */
 /** Fields injected into the log context by the correlation middleware. */
-interface CorrelationContext {
+export interface CorrelationContext {
   correlationId: string;
   traceId?: string;
   /** Service that originated the request (from `X-Origin-Service` header). */
@@ -60,7 +59,7 @@ interface CorrelationContext {
   /** Index signature so CorrelationContext is assignable to LogContext. */
   [key: string]: unknown;
 }
-interface CorrelationMiddlewareOptions {
+export interface CorrelationMiddlewareOptions {
   /**
    * HTTP header to read/write the correlation ID from/to.
    * @default 'x-correlation-id'
@@ -100,12 +99,12 @@ interface CorrelationMiddlewareOptions {
  * function's JSDoc and README promise. `logixia/correlation` is Node-only
  * (it builds on `AsyncLocalStorage`), so importing `node:crypto` is safe here.
  */
-declare function generateCorrelationId(): string;
+export declare function generateCorrelationId(): string;
 /**
  * Return the correlation ID from the current `LogixiaContext`, or `undefined`
  * when called outside any context scope.
  */
-declare function getCurrentCorrelationId(): string | undefined;
+export declare function getCurrentCorrelationId(): string | undefined;
 /**
  * Run `callback` inside a correlation context scope.
  *
@@ -119,7 +118,7 @@ declare function getCurrentCorrelationId(): string | undefined;
  * });
  * ```
  */
-declare function withCorrelationId<T>(correlationId: string | undefined, callback: () => T): T;
+export declare function withCorrelationId<T>(correlationId: string | undefined, callback: () => T): T;
 /**
  * Express-compatible middleware that:
  * 1. Reads `X-Correlation-ID` from the incoming request (or generates a new one)
@@ -133,7 +132,7 @@ declare function withCorrelationId<T>(correlationId: string | undefined, callbac
  * app.use(correlationMiddleware());
  * ```
  */
-declare function correlationMiddleware(options?: CorrelationMiddlewareOptions): (req: Record<string, unknown>, res: Record<string, unknown>, next: () => void) => void;
+export declare function correlationMiddleware(options?: CorrelationMiddlewareOptions): (req: Record<string, unknown>, res: Record<string, unknown>, next: () => void) => void;
 /**
  * Fastify `onRequest` lifecycle hook — same functionality as `correlationMiddleware`
  * but adapted to Fastify's hook API.
@@ -144,7 +143,7 @@ declare function correlationMiddleware(options?: CorrelationMiddlewareOptions):
  * fastify.addHook('onRequest', correlationFastifyHook());
  * ```
  */
-declare function correlationFastifyHook(options?: CorrelationMiddlewareOptions): (request: Record<string, unknown>, reply: Record<string, unknown>, done: () => void) => void;
+export declare function correlationFastifyHook(options?: CorrelationMiddlewareOptions): (request: Record<string, unknown>, reply: Record<string, unknown>, done: () => void) => void;
 /**
  * A drop-in replacement for `fetch` that automatically injects the current
  * `correlationId` from `LogixiaContext` as an `X-Correlation-ID` request header.
@@ -162,7 +161,7 @@ declare function correlationFastifyHook(options?: CorrelationMiddlewareOptions):
  * });
  * ```
  */
-declare function correlationFetch(input: string | URL | Request, init?: RequestInit, options?: {
+export declare function correlationFetch(input: string | URL | Request, init?: RequestInit, options?: {
   header?: string;
 }): Promise<Response>;
 /**
@@ -177,10 +176,10 @@ declare function correlationFetch(input: string | URL | Request, init?: RequestI
  * axios.interceptors.request.use(createCorrelationAxiosInterceptor());
  * ```
  */
-declare function createCorrelationAxiosInterceptor(options?: {
+export declare function createCorrelationAxiosInterceptor(options?: {
   header?: string;
 }): (config: Record<string, unknown>) => Record<string, unknown>;
-interface ChildFromRequestOptions {
+export interface ChildFromRequestOptions {
   /** Header to read the correlation ID from. @default 'x-correlation-id' */
   correlationHeader?: string;
   /**
@@ -222,7 +221,7 @@ interface ChildFromRequestOptions {
  * });
  * ```
  */
-declare function childFromRequest<TLogger extends {
+export declare function childFromRequest<TLogger extends {
   child(...args: never[]): TLogger;
 }>(req: Record<string, unknown>, logger: TLogger, options?: ChildFromRequestOptions): TLogger;
 /**
@@ -243,7 +242,7 @@ declare function childFromRequest<TLogger extends {
  * });
  * ```
  */
-declare function extractMessageCorrelationId(message: Record<string, unknown>): string | undefined;
+export declare function extractMessageCorrelationId(message: Record<string, unknown>): string | undefined;
 /**
  * Build Kafka message headers containing the current correlation context.
  *
@@ -257,7 +256,5 @@ declare function extractMessageCorrelationId(message: Record<string, unknown>):
  * });
  * ```
  */
-declare function buildKafkaCorrelationHeaders(): Record<string, string>;
-//#endregion
-export { ChildFromRequestOptions, CorrelationContext, CorrelationMiddlewareOptions, buildKafkaCorrelationHeaders, childFromRequest, correlationFastifyHook, correlationFetch, correlationMiddleware, createCorrelationAxiosInterceptor, extractMessageCorrelationId, generateCorrelationId, getCurrentCorrelationId, withCorrelationId };
+export declare function buildKafkaCorrelationHeaders(): Record<string, string>;
 //# sourceMappingURL=correlation.d.mts.map

package/dist/correlation.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"correlation.d.mts","names":[],"sources":["../src/correlation.ts"],"sourcesContent":[],"mappings":";;AA6DA;AASA;AA2CA;AAwBA;AAkBA;AAoBA;;;;;AAiDA;;;;;AAwDA;;;;;;;AA4CA;AAyBA;AA2CA;;;;;;;AAmFA;AAyCA;;;;;;;;;;;;;;;;;;;;UAvciB,kBAAA;;;;;;;;UASA,4BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2CD,qBAAA,CAAA;;;;;iBAwBA,uBAAA,CAAA;;;;;;;;;;;;;;iBAkBA,wEAAwE,IAAI;;;;;;;;;;;;;;iBAoB5E,qBAAA,WAA+B,qCAUtC,8BACA;;;;;;;;;;;iBAsCO,sBAAA,WAAgC,yCAUnC,gCACF;;;;;;;;;;;;;;;;;;iBA6CW,gBAAA,iBACJ,MAAM,gBAChB;;IAEL,QAAQ;;;;;;;;;;;;;iBAwCK,iCAAA;;aAEJ,4BAA4B;UAuBvB,uBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2CD;2BAA4D;QACrE,iCACG,mBACC,0BACR;;;;;;;;;;;;;;;;;;;iBA+Ea,2BAAA,UAAqC;;;;;;;;;;;;;;iBAyCrC,4BAAA,CAAA,GAAgC"}
+{"version":3,"file":"correlation.d.mts","names":[],"sources":["../src/correlation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DiB;EACf;EACA;;EAEA;;GAEC;;iBAGc;;;;;EAKf;;;;;EAKA;;;;;EAKA;;;;;;;EAOA;;;;;;EAMA;;;;;;;;;;;;wBAec;;;;;wBAwBA;;;;;;;;;;;;;;wBAkBA,kBAAkB,GAAG,mCAAmC,gBAAgB,IAAI;;;;;;;;;;;;;;wBAoB5E,sBAAsB,UAAS,gCAU3C,KAAK,yBACL,KAAK,yBACL;;;;;;;;;;;wBAqCY,uBAAuB,UAAS,gCAU5C,SAAS,yBACT,OAAO,yBACP;;;;;;;;;;;;;;;;;;wBA4CkB,iBACpB,gBAAgB,MAAM,SACtB,OAAM,aACN;EAAW;IACV,QAAQ;;;;;;;;;;;;;wBAwCK,kCACd;EAAW;KACT,QAAQ,4BAA4B;iBAuBvB;;EAEf;;;;;;;EAOA;;;;;;;EAOA;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2Bc,iBAAiB;EAAkB,SAAS,gBAAgB;GAC1E,KAAK,yBACL,QAAQ,SACR,UAAS,0BACR;;;;;;;;;;;;;;;;;;;wBA+Ea,4BAA4B,SAAS;;;;;;;;;;;;;;wBAyCrC,gCAAgC"}

package/dist/correlation.d.ts

@@ -1,4 +1,3 @@
-//#region src/correlation.d.ts
 /**
  * logixia — Microservices Correlation ID Propagation
  *
@@ -52,7 +51,7 @@
  * ```
  */
 /** Fields injected into the log context by the correlation middleware. */
-interface CorrelationContext {
+export interface CorrelationContext {
   correlationId: string;
   traceId?: string;
   /** Service that originated the request (from `X-Origin-Service` header). */
@@ -60,7 +59,7 @@ interface CorrelationContext {
   /** Index signature so CorrelationContext is assignable to LogContext. */
   [key: string]: unknown;
 }
-interface CorrelationMiddlewareOptions {
+export interface CorrelationMiddlewareOptions {
   /**
    * HTTP header to read/write the correlation ID from/to.
    * @default 'x-correlation-id'
@@ -100,12 +99,12 @@ interface CorrelationMiddlewareOptions {
  * function's JSDoc and README promise. `logixia/correlation` is Node-only
  * (it builds on `AsyncLocalStorage`), so importing `node:crypto` is safe here.
  */
-declare function generateCorrelationId(): string;
+export declare function generateCorrelationId(): string;
 /**
  * Return the correlation ID from the current `LogixiaContext`, or `undefined`
  * when called outside any context scope.
  */
-declare function getCurrentCorrelationId(): string | undefined;
+export declare function getCurrentCorrelationId(): string | undefined;
 /**
  * Run `callback` inside a correlation context scope.
  *
@@ -119,7 +118,7 @@ declare function getCurrentCorrelationId(): string | undefined;
  * });
  * ```
  */
-declare function withCorrelationId<T>(correlationId: string | undefined, callback: () => T): T;
+export declare function withCorrelationId<T>(correlationId: string | undefined, callback: () => T): T;
 /**
  * Express-compatible middleware that:
  * 1. Reads `X-Correlation-ID` from the incoming request (or generates a new one)
@@ -133,7 +132,7 @@ declare function withCorrelationId<T>(correlationId: string | undefined, callbac
  * app.use(correlationMiddleware());
  * ```
  */
-declare function correlationMiddleware(options?: CorrelationMiddlewareOptions): (req: Record<string, unknown>, res: Record<string, unknown>, next: () => void) => void;
+export declare function correlationMiddleware(options?: CorrelationMiddlewareOptions): (req: Record<string, unknown>, res: Record<string, unknown>, next: () => void) => void;
 /**
  * Fastify `onRequest` lifecycle hook — same functionality as `correlationMiddleware`
  * but adapted to Fastify's hook API.
@@ -144,7 +143,7 @@ declare function correlationMiddleware(options?: CorrelationMiddlewareOptions):
  * fastify.addHook('onRequest', correlationFastifyHook());
  * ```
  */
-declare function correlationFastifyHook(options?: CorrelationMiddlewareOptions): (request: Record<string, unknown>, reply: Record<string, unknown>, done: () => void) => void;
+export declare function correlationFastifyHook(options?: CorrelationMiddlewareOptions): (request: Record<string, unknown>, reply: Record<string, unknown>, done: () => void) => void;
 /**
  * A drop-in replacement for `fetch` that automatically injects the current
  * `correlationId` from `LogixiaContext` as an `X-Correlation-ID` request header.
@@ -162,7 +161,7 @@ declare function correlationFastifyHook(options?: CorrelationMiddlewareOptions):
  * });
  * ```
  */
-declare function correlationFetch(input: string | URL | Request, init?: RequestInit, options?: {
+export declare function correlationFetch(input: string | URL | Request, init?: RequestInit, options?: {
   header?: string;
 }): Promise<Response>;
 /**
@@ -177,10 +176,10 @@ declare function correlationFetch(input: string | URL | Request, init?: RequestI
  * axios.interceptors.request.use(createCorrelationAxiosInterceptor());
  * ```
  */
-declare function createCorrelationAxiosInterceptor(options?: {
+export declare function createCorrelationAxiosInterceptor(options?: {
   header?: string;
 }): (config: Record<string, unknown>) => Record<string, unknown>;
-interface ChildFromRequestOptions {
+export interface ChildFromRequestOptions {
   /** Header to read the correlation ID from. @default 'x-correlation-id' */
   correlationHeader?: string;
   /**
@@ -222,7 +221,7 @@ interface ChildFromRequestOptions {
  * });
  * ```
  */
-declare function childFromRequest<TLogger extends {
+export declare function childFromRequest<TLogger extends {
   child(...args: never[]): TLogger;
 }>(req: Record<string, unknown>, logger: TLogger, options?: ChildFromRequestOptions): TLogger;
 /**
@@ -243,7 +242,7 @@ declare function childFromRequest<TLogger extends {
  * });
  * ```
  */
-declare function extractMessageCorrelationId(message: Record<string, unknown>): string | undefined;
+export declare function extractMessageCorrelationId(message: Record<string, unknown>): string | undefined;
 /**
  * Build Kafka message headers containing the current correlation context.
  *
@@ -257,7 +256,5 @@ declare function extractMessageCorrelationId(message: Record<string, unknown>):
  * });
  * ```
  */
-declare function buildKafkaCorrelationHeaders(): Record<string, string>;
-//#endregion
-export { ChildFromRequestOptions, CorrelationContext, CorrelationMiddlewareOptions, buildKafkaCorrelationHeaders, childFromRequest, correlationFastifyHook, correlationFetch, correlationMiddleware, createCorrelationAxiosInterceptor, extractMessageCorrelationId, generateCorrelationId, getCurrentCorrelationId, withCorrelationId };
+export declare function buildKafkaCorrelationHeaders(): Record<string, string>;
 //# sourceMappingURL=correlation.d.ts.map

package/dist/correlation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"correlation.d.ts","names":[],"sources":["../src/correlation.ts"],"sourcesContent":[],"mappings":";;AA6DA;AASA;AA2CA;AAwBA;AAkBA;AAoBA;;;;;AAiDA;;;;;AAwDA;;;;;;;AA4CA;AAyBA;AA2CA;;;;;;;AAmFA;AAyCA;;;;;;;;;;;;;;;;;;;;UAvciB,kBAAA;;;;;;;;UASA,4BAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2CD,qBAAA,CAAA;;;;;iBAwBA,uBAAA,CAAA;;;;;;;;;;;;;;iBAkBA,wEAAwE,IAAI;;;;;;;;;;;;;;iBAoB5E,qBAAA,WAA+B,qCAUtC,8BACA;;;;;;;;;;;iBAsCO,sBAAA,WAAgC,yCAUnC,gCACF;;;;;;;;;;;;;;;;;;iBA6CW,gBAAA,iBACJ,MAAM,gBAChB;;IAEL,QAAQ;;;;;;;;;;;;;iBAwCK,iCAAA;;aAEJ,4BAA4B;UAuBvB,uBAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA2CD;2BAA4D;QACrE,iCACG,mBACC,0BACR;;;;;;;;;;;;;;;;;;;iBA+Ea,2BAAA,UAAqC;;;;;;;;;;;;;;iBAyCrC,4BAAA,CAAA,GAAgC"}
+{"version":3,"file":"correlation.d.ts","names":[],"sources":["../src/correlation.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA6DiB;EACf;EACA;;EAEA;;GAEC;;iBAGc;;;;;EAKf;;;;;EAKA;;;;;EAKA;;;;;;;EAOA;;;;;;EAMA;;;;;;;;;;;;wBAec;;;;;wBAwBA;;;;;;;;;;;;;;wBAkBA,kBAAkB,GAAG,mCAAmC,gBAAgB,IAAI;;;;;;;;;;;;;;wBAoB5E,sBAAsB,UAAS,gCAU3C,KAAK,yBACL,KAAK,yBACL;;;;;;;;;;;wBAqCY,uBAAuB,UAAS,gCAU5C,SAAS,yBACT,OAAO,yBACP;;;;;;;;;;;;;;;;;;wBA4CkB,iBACpB,gBAAgB,MAAM,SACtB,OAAM,aACN;EAAW;IACV,QAAQ;;;;;;;;;;;;;wBAwCK,kCACd;EAAW;KACT,QAAQ,4BAA4B;iBAuBvB;;EAEf;;;;;;;EAOA;;;;;;;EAOA;;;;;;;;;;;;;;;;;;;;;;;;;;wBA2Bc,iBAAiB;EAAkB,SAAS,gBAAgB;GAC1E,KAAK,yBACL,QAAQ,SACR,UAAS,0BACR;;;;;;;;;;;;;;;;;;;wBA+Ea,4BAA4B,SAAS;;;;;;;;;;;;;;wBAyCrC,gCAAgC"}