apitally 0.25.8 → 1.0.0-beta.1

package/dist/adonisjs/stubs/config/apitally.stub

@@ -4,22 +4,18 @@
   })
 }}}
 import env from '#start/env'
-import app from '@adonisjs/core/services/app'
 import { defineConfig } from 'apitally/adonisjs'
 
-const apitallyConfig = defineConfig({
-  clientId: env.get('APITALLY_CLIENT_ID'),
-  env: env.get('APITALLY_ENV', app.inProduction ? 'prod' : 'dev'),
-{{#if enableRequestLogging}}
-  requestLogging: {
-    enabled: true,
-    logRequestHeaders: true,
-    logRequestBody: true,
-    logResponseBody: true,
-    captureLogs: true,
-    captureTraces: true,
-  },
+export default defineConfig({
+  writeToken: env.get('APITALLY_WRITE_TOKEN'),
+  env: env.get('APITALLY_ENV'),
+{{#if captureRequestHeaders}}
+  captureRequestHeaders: true,
+{{/if}}
+{{#if captureRequestBody}}
+  captureRequestBody: true,
+{{/if}}
+{{#if captureResponseBody}}
+  captureResponseBody: true,
 {{/if}}
 })
-
-export default apitallyConfig

package/dist/bodyCapture.cjs

@@ -0,0 +1,128 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var bodyCapture_exports = {};
+__export(bodyCapture_exports, {
+  BODY_TOO_LARGE: () => BODY_TOO_LARGE,
+  BODY_TOO_LARGE_BUFFER: () => BODY_TOO_LARGE_BUFFER,
+  BodyCapture: () => BodyCapture,
+  MAX_BODY_SIZE: () => MAX_BODY_SIZE
+});
+module.exports = __toCommonJS(bodyCapture_exports);
+const MAX_BODY_SIZE = 5e4;
+const BODY_TOO_LARGE = "[BODY_TOO_LARGE]";
+const BODY_TOO_LARGE_BUFFER = Buffer.from(BODY_TOO_LARGE);
+const ALLOWED_CONTENT_TYPES = [
+  "application/json",
+  "application/problem+json",
+  "application/vnd.api+json",
+  "application/ld+json",
+  "application/x-ndjson",
+  "text/markdown",
+  "text/plain"
+];
+class BodyCapture {
+  shouldCapture;
+  declaredSize;
+  tooLarge;
+  chunks = [];
+  bufferedLength = 0;
+  observedLength = 0;
+  completed = false;
+  constructor(options) {
+    this.shouldCapture = options.captureBody && isAllowedContentType(options.contentType);
+    const transferEncoding = Array.isArray(options.transferEncoding) ? options.transferEncoding.join(",") : options.transferEncoding;
+    const isChunkedTransferEncoding = typeof transferEncoding === "string" && transferEncoding.toLowerCase().includes("chunked");
+    this.declaredSize = isChunkedTransferEncoding ? void 0 : parseContentLength(options.contentLength);
+    this.tooLarge = this.shouldCapture && this.declaredSize !== void 0 && this.declaredSize > MAX_BODY_SIZE;
+  }
+  get isBuffering() {
+    return this.shouldCapture && !this.tooLarge;
+  }
+  addChunk(chunk, encoding) {
+    const byteLength = typeof chunk === "string" ? Buffer.byteLength(chunk, encoding) : chunk.byteLength;
+    this.observedLength += byteLength;
+    if (!this.shouldCapture || this.tooLarge) {
+      return;
+    }
+    const bytes = typeof chunk === "string" ? Buffer.from(chunk, encoding) : chunk;
+    this.bufferedLength += byteLength;
+    if (this.bufferedLength > MAX_BODY_SIZE) {
+      this.tooLarge = true;
+      this.chunks = [];
+      return;
+    }
+    this.chunks.push(bytes);
+  }
+  stopBuffering() {
+    this.shouldCapture = false;
+    this.tooLarge = false;
+    this.chunks = [];
+    this.bufferedLength = 0;
+  }
+  markComplete() {
+    this.completed = true;
+  }
+  // The sentinel is exported even when the stream never completed; a partial
+  // buffer from an aborted stream never is.
+  get body() {
+    if (this.tooLarge) {
+      return BODY_TOO_LARGE_BUFFER;
+    }
+    if (!this.completed || this.bufferedLength === 0) {
+      return void 0;
+    }
+    return Buffer.concat(this.chunks);
+  }
+  // The trusted declared size, else the running byte count once the stream was
+  // observed to completion; undefined means no size attribute.
+  get size() {
+    if (this.declaredSize !== void 0) {
+      return this.declaredSize;
+    }
+    return this.completed ? this.observedLength : void 0;
+  }
+}
+function isAllowedContentType(contentType) {
+  if (!contentType) {
+    return false;
+  }
+  const normalized = contentType.trim().toLowerCase();
+  return ALLOWED_CONTENT_TYPES.some((allowed) => normalized.startsWith(allowed));
+}
+function parseContentLength(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isNaN(parsed) ? void 0 : parsed;
+  }
+  if (Array.isArray(value)) {
+    return parseContentLength(value[0]);
+  }
+  return void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BODY_TOO_LARGE,
+  BODY_TOO_LARGE_BUFFER,
+  BodyCapture,
+  MAX_BODY_SIZE
+});
+//# sourceMappingURL=bodyCapture.cjs.map

package/dist/bodyCapture.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bodyCapture.ts"],"sourcesContent":["// Captured bodies above the cap are represented by a sentinel and never\n// exported truncated.\nexport const MAX_BODY_SIZE = 50_000;\nexport const BODY_TOO_LARGE = \"[BODY_TOO_LARGE]\";\nexport const BODY_TOO_LARGE_BUFFER = Buffer.from(BODY_TOO_LARGE);\n\nconst ALLOWED_CONTENT_TYPES = [\n  \"application/json\",\n  \"application/problem+json\",\n  \"application/vnd.api+json\",\n  \"application/ld+json\",\n  \"application/x-ndjson\",\n  \"text/markdown\",\n  \"text/plain\",\n];\n\ninterface BodyCaptureOptions {\n  captureBody: boolean;\n  contentType?: string | null;\n  contentLength?: string | number | string[] | null;\n  transferEncoding?: string | string[] | null;\n}\n\n// Capture eligibility and declared oversize decisions use headers only; all\n// observed bytes still count toward size.\nexport class BodyCapture {\n  private shouldCapture: boolean;\n  private readonly declaredSize?: number;\n  private tooLarge: boolean;\n  private chunks: Uint8Array[] = [];\n  private bufferedLength = 0;\n  private observedLength = 0;\n  private completed = false;\n\n  constructor(options: BodyCaptureOptions) {\n    this.shouldCapture = options.captureBody && isAllowedContentType(options.contentType);\n    // Transfer-Encoding: chunked makes Content-Length unusable, so observed\n    // decoded bytes determine size.\n    const transferEncoding = Array.isArray(options.transferEncoding)\n      ? options.transferEncoding.join(\",\")\n      : options.transferEncoding;\n    const isChunkedTransferEncoding =\n      typeof transferEncoding === \"string\" && transferEncoding.toLowerCase().includes(\"chunked\");\n    this.declaredSize = isChunkedTransferEncoding\n      ? undefined\n      : parseContentLength(options.contentLength);\n    this.tooLarge =\n      this.shouldCapture && this.declaredSize !== undefined && this.declaredSize > MAX_BODY_SIZE;\n  }\n\n  get isBuffering(): boolean {\n    return this.shouldCapture && !this.tooLarge;\n  }\n\n  addChunk(chunk: Buffer | Uint8Array | string, encoding?: BufferEncoding): void {\n    const byteLength =\n      typeof chunk === \"string\" ? Buffer.byteLength(chunk, encoding) : chunk.byteLength;\n    this.observedLength += byteLength;\n    if (!this.shouldCapture || this.tooLarge) {\n      return;\n    }\n    const bytes = typeof chunk === \"string\" ? Buffer.from(chunk, encoding) : chunk;\n    this.bufferedLength += byteLength;\n    if (this.bufferedLength > MAX_BODY_SIZE) {\n      // A body must never be exported truncated, so crossing the cap discards\n      // the buffer and yields the sentinel.\n      this.tooLarge = true;\n      this.chunks = [];\n      return;\n    }\n    this.chunks.push(bytes);\n  }\n\n  stopBuffering(): void {\n    this.shouldCapture = false;\n    this.tooLarge = false;\n    this.chunks = [];\n    this.bufferedLength = 0;\n  }\n\n  markComplete(): void {\n    this.completed = true;\n  }\n\n  // The sentinel is exported even when the stream never completed; a partial\n  // buffer from an aborted stream never is.\n  get body(): Buffer | undefined {\n    if (this.tooLarge) {\n      return BODY_TOO_LARGE_BUFFER;\n    }\n    if (!this.completed || this.bufferedLength === 0) {\n      return undefined;\n    }\n    return Buffer.concat(this.chunks);\n  }\n\n  // The trusted declared size, else the running byte count once the stream was\n  // observed to completion; undefined means no size attribute.\n  get size(): number | undefined {\n    if (this.declaredSize !== undefined) {\n      return this.declaredSize;\n    }\n    return this.completed ? this.observedLength : undefined;\n  }\n}\n\nexport interface CapturedBody {\n  body?: Buffer;\n  size?: number;\n}\n\nfunction isAllowedContentType(contentType: string | null | undefined): boolean {\n  if (!contentType) {\n    return false;\n  }\n  const normalized = contentType.trim().toLowerCase();\n  return ALLOWED_CONTENT_TYPES.some((allowed) => normalized.startsWith(allowed));\n}\n\nfunction parseContentLength(\n  value: string | number | string[] | null | undefined,\n): number | undefined {\n  if (typeof value === \"number\") {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    const parsed = Number.parseInt(value, 10);\n    return Number.isNaN(parsed) ? undefined : parsed;\n  }\n  if (Array.isArray(value)) {\n    return parseContentLength(value[0]);\n  }\n  return undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAEO,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AACvB,MAAM,wBAAwB,OAAO,KAAK,cAAc;AAE/D,MAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAWO,MAAM,YAAY;AAAA,EACf;AAAA,EACS;AAAA,EACT;AAAA,EACA,SAAuB,CAAC;AAAA,EACxB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,YAAY;AAAA,EAEpB,YAAY,SAA6B;AACvC,SAAK,gBAAgB,QAAQ,eAAe,qBAAqB,QAAQ,WAAW;AAGpF,UAAM,mBAAmB,MAAM,QAAQ,QAAQ,gBAAgB,IAC3D,QAAQ,iBAAiB,KAAK,GAAG,IACjC,QAAQ;AACZ,UAAM,4BACJ,OAAO,qBAAqB,YAAY,iBAAiB,YAAY,EAAE,SAAS,SAAS;AAC3F,SAAK,eAAe,4BAChB,SACA,mBAAmB,QAAQ,aAAa;AAC5C,SAAK,WACH,KAAK,iBAAiB,KAAK,iBAAiB,UAAa,KAAK,eAAe;AAAA,EACjF;AAAA,EAEA,IAAI,cAAuB;AACzB,WAAO,KAAK,iBAAiB,CAAC,KAAK;AAAA,EACrC;AAAA,EAEA,SAAS,OAAqC,UAAiC;AAC7E,UAAM,aACJ,OAAO,UAAU,WAAW,OAAO,WAAW,OAAO,QAAQ,IAAI,MAAM;AACzE,SAAK,kBAAkB;AACvB,QAAI,CAAC,KAAK,iBAAiB,KAAK,UAAU;AACxC;AAAA,IACF;AACA,UAAM,QAAQ,OAAO,UAAU,WAAW,OAAO,KAAK,OAAO,QAAQ,IAAI;AACzE,SAAK,kBAAkB;AACvB,QAAI,KAAK,iBAAiB,eAAe;AAGvC,WAAK,WAAW;AAChB,WAAK,SAAS,CAAC;AACf;AAAA,IACF;AACA,SAAK,OAAO,KAAK,KAAK;AAAA,EACxB;AAAA,EAEA,gBAAsB;AACpB,SAAK,gBAAgB;AACrB,SAAK,WAAW;AAChB,SAAK,SAAS,CAAC;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEA,eAAqB;AACnB,SAAK,YAAY;AAAA,EACnB;AAAA;AAAA;AAAA,EAIA,IAAI,OAA2B;AAC7B,QAAI,KAAK,UAAU;AACjB,aAAO;AAAA,IACT;AACA,QAAI,CAAC,KAAK,aAAa,KAAK,mBAAmB,GAAG;AAChD,aAAO;AAAA,IACT;AACA,WAAO,OAAO,OAAO,KAAK,MAAM;AAAA,EAClC;AAAA;AAAA;AAAA,EAIA,IAAI,OAA2B;AAC7B,QAAI,KAAK,iBAAiB,QAAW;AACnC,aAAO,KAAK;AAAA,IACd;AACA,WAAO,KAAK,YAAY,KAAK,iBAAiB;AAAA,EAChD;AACF;AAOA,SAAS,qBAAqB,aAAiD;AAC7E,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,EACT;AACA,QAAM,aAAa,YAAY,KAAK,EAAE,YAAY;AAClD,SAAO,sBAAsB,KAAK,CAAC,YAAY,WAAW,WAAW,OAAO,CAAC;AAC/E;AAEA,SAAS,mBACP,OACoB;AACpB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,SAAS,OAAO,SAAS,OAAO,EAAE;AACxC,WAAO,OAAO,MAAM,MAAM,IAAI,SAAY;AAAA,EAC5C;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,mBAAmB,MAAM,CAAC,CAAC;AAAA,EACpC;AACA,SAAO;AACT;","names":[]}

package/dist/bodyCapture.d.cts

@@ -0,0 +1,31 @@
+declare const MAX_BODY_SIZE = 50000;
+declare const BODY_TOO_LARGE = "[BODY_TOO_LARGE]";
+declare const BODY_TOO_LARGE_BUFFER: Buffer<ArrayBuffer>;
+interface BodyCaptureOptions {
+    captureBody: boolean;
+    contentType?: string | null;
+    contentLength?: string | number | string[] | null;
+    transferEncoding?: string | string[] | null;
+}
+declare class BodyCapture {
+    private shouldCapture;
+    private readonly declaredSize?;
+    private tooLarge;
+    private chunks;
+    private bufferedLength;
+    private observedLength;
+    private completed;
+    constructor(options: BodyCaptureOptions);
+    get isBuffering(): boolean;
+    addChunk(chunk: Buffer | Uint8Array | string, encoding?: BufferEncoding): void;
+    stopBuffering(): void;
+    markComplete(): void;
+    get body(): Buffer | undefined;
+    get size(): number | undefined;
+}
+interface CapturedBody {
+    body?: Buffer;
+    size?: number;
+}
+
+export { BODY_TOO_LARGE, BODY_TOO_LARGE_BUFFER, BodyCapture, type CapturedBody, MAX_BODY_SIZE };

package/dist/bodyCapture.d.ts

@@ -0,0 +1,31 @@
+declare const MAX_BODY_SIZE = 50000;
+declare const BODY_TOO_LARGE = "[BODY_TOO_LARGE]";
+declare const BODY_TOO_LARGE_BUFFER: Buffer<ArrayBuffer>;
+interface BodyCaptureOptions {
+    captureBody: boolean;
+    contentType?: string | null;
+    contentLength?: string | number | string[] | null;
+    transferEncoding?: string | string[] | null;
+}
+declare class BodyCapture {
+    private shouldCapture;
+    private readonly declaredSize?;
+    private tooLarge;
+    private chunks;
+    private bufferedLength;
+    private observedLength;
+    private completed;
+    constructor(options: BodyCaptureOptions);
+    get isBuffering(): boolean;
+    addChunk(chunk: Buffer | Uint8Array | string, encoding?: BufferEncoding): void;
+    stopBuffering(): void;
+    markComplete(): void;
+    get body(): Buffer | undefined;
+    get size(): number | undefined;
+}
+interface CapturedBody {
+    body?: Buffer;
+    size?: number;
+}
+
+export { BODY_TOO_LARGE, BODY_TOO_LARGE_BUFFER, BodyCapture, type CapturedBody, MAX_BODY_SIZE };

package/dist/bodyCapture.js

@@ -0,0 +1,101 @@
+const MAX_BODY_SIZE = 5e4;
+const BODY_TOO_LARGE = "[BODY_TOO_LARGE]";
+const BODY_TOO_LARGE_BUFFER = Buffer.from(BODY_TOO_LARGE);
+const ALLOWED_CONTENT_TYPES = [
+  "application/json",
+  "application/problem+json",
+  "application/vnd.api+json",
+  "application/ld+json",
+  "application/x-ndjson",
+  "text/markdown",
+  "text/plain"
+];
+class BodyCapture {
+  shouldCapture;
+  declaredSize;
+  tooLarge;
+  chunks = [];
+  bufferedLength = 0;
+  observedLength = 0;
+  completed = false;
+  constructor(options) {
+    this.shouldCapture = options.captureBody && isAllowedContentType(options.contentType);
+    const transferEncoding = Array.isArray(options.transferEncoding) ? options.transferEncoding.join(",") : options.transferEncoding;
+    const isChunkedTransferEncoding = typeof transferEncoding === "string" && transferEncoding.toLowerCase().includes("chunked");
+    this.declaredSize = isChunkedTransferEncoding ? void 0 : parseContentLength(options.contentLength);
+    this.tooLarge = this.shouldCapture && this.declaredSize !== void 0 && this.declaredSize > MAX_BODY_SIZE;
+  }
+  get isBuffering() {
+    return this.shouldCapture && !this.tooLarge;
+  }
+  addChunk(chunk, encoding) {
+    const byteLength = typeof chunk === "string" ? Buffer.byteLength(chunk, encoding) : chunk.byteLength;
+    this.observedLength += byteLength;
+    if (!this.shouldCapture || this.tooLarge) {
+      return;
+    }
+    const bytes = typeof chunk === "string" ? Buffer.from(chunk, encoding) : chunk;
+    this.bufferedLength += byteLength;
+    if (this.bufferedLength > MAX_BODY_SIZE) {
+      this.tooLarge = true;
+      this.chunks = [];
+      return;
+    }
+    this.chunks.push(bytes);
+  }
+  stopBuffering() {
+    this.shouldCapture = false;
+    this.tooLarge = false;
+    this.chunks = [];
+    this.bufferedLength = 0;
+  }
+  markComplete() {
+    this.completed = true;
+  }
+  // The sentinel is exported even when the stream never completed; a partial
+  // buffer from an aborted stream never is.
+  get body() {
+    if (this.tooLarge) {
+      return BODY_TOO_LARGE_BUFFER;
+    }
+    if (!this.completed || this.bufferedLength === 0) {
+      return void 0;
+    }
+    return Buffer.concat(this.chunks);
+  }
+  // The trusted declared size, else the running byte count once the stream was
+  // observed to completion; undefined means no size attribute.
+  get size() {
+    if (this.declaredSize !== void 0) {
+      return this.declaredSize;
+    }
+    return this.completed ? this.observedLength : void 0;
+  }
+}
+function isAllowedContentType(contentType) {
+  if (!contentType) {
+    return false;
+  }
+  const normalized = contentType.trim().toLowerCase();
+  return ALLOWED_CONTENT_TYPES.some((allowed) => normalized.startsWith(allowed));
+}
+function parseContentLength(value) {
+  if (typeof value === "number") {
+    return value;
+  }
+  if (typeof value === "string") {
+    const parsed = Number.parseInt(value, 10);
+    return Number.isNaN(parsed) ? void 0 : parsed;
+  }
+  if (Array.isArray(value)) {
+    return parseContentLength(value[0]);
+  }
+  return void 0;
+}
+export {
+  BODY_TOO_LARGE,
+  BODY_TOO_LARGE_BUFFER,
+  BodyCapture,
+  MAX_BODY_SIZE
+};
+//# sourceMappingURL=bodyCapture.js.map

package/dist/bodyCapture.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/bodyCapture.ts"],"sourcesContent":["// Captured bodies above the cap are represented by a sentinel and never\n// exported truncated.\nexport const MAX_BODY_SIZE = 50_000;\nexport const BODY_TOO_LARGE = \"[BODY_TOO_LARGE]\";\nexport const BODY_TOO_LARGE_BUFFER = Buffer.from(BODY_TOO_LARGE);\n\nconst ALLOWED_CONTENT_TYPES = [\n  \"application/json\",\n  \"application/problem+json\",\n  \"application/vnd.api+json\",\n  \"application/ld+json\",\n  \"application/x-ndjson\",\n  \"text/markdown\",\n  \"text/plain\",\n];\n\ninterface BodyCaptureOptions {\n  captureBody: boolean;\n  contentType?: string | null;\n  contentLength?: string | number | string[] | null;\n  transferEncoding?: string | string[] | null;\n}\n\n// Capture eligibility and declared oversize decisions use headers only; all\n// observed bytes still count toward size.\nexport class BodyCapture {\n  private shouldCapture: boolean;\n  private readonly declaredSize?: number;\n  private tooLarge: boolean;\n  private chunks: Uint8Array[] = [];\n  private bufferedLength = 0;\n  private observedLength = 0;\n  private completed = false;\n\n  constructor(options: BodyCaptureOptions) {\n    this.shouldCapture = options.captureBody && isAllowedContentType(options.contentType);\n    // Transfer-Encoding: chunked makes Content-Length unusable, so observed\n    // decoded bytes determine size.\n    const transferEncoding = Array.isArray(options.transferEncoding)\n      ? options.transferEncoding.join(\",\")\n      : options.transferEncoding;\n    const isChunkedTransferEncoding =\n      typeof transferEncoding === \"string\" && transferEncoding.toLowerCase().includes(\"chunked\");\n    this.declaredSize = isChunkedTransferEncoding\n      ? undefined\n      : parseContentLength(options.contentLength);\n    this.tooLarge =\n      this.shouldCapture && this.declaredSize !== undefined && this.declaredSize > MAX_BODY_SIZE;\n  }\n\n  get isBuffering(): boolean {\n    return this.shouldCapture && !this.tooLarge;\n  }\n\n  addChunk(chunk: Buffer | Uint8Array | string, encoding?: BufferEncoding): void {\n    const byteLength =\n      typeof chunk === \"string\" ? Buffer.byteLength(chunk, encoding) : chunk.byteLength;\n    this.observedLength += byteLength;\n    if (!this.shouldCapture || this.tooLarge) {\n      return;\n    }\n    const bytes = typeof chunk === \"string\" ? Buffer.from(chunk, encoding) : chunk;\n    this.bufferedLength += byteLength;\n    if (this.bufferedLength > MAX_BODY_SIZE) {\n      // A body must never be exported truncated, so crossing the cap discards\n      // the buffer and yields the sentinel.\n      this.tooLarge = true;\n      this.chunks = [];\n      return;\n    }\n    this.chunks.push(bytes);\n  }\n\n  stopBuffering(): void {\n    this.shouldCapture = false;\n    this.tooLarge = false;\n    this.chunks = [];\n    this.bufferedLength = 0;\n  }\n\n  markComplete(): void {\n    this.completed = true;\n  }\n\n  // The sentinel is exported even when the stream never completed; a partial\n  // buffer from an aborted stream never is.\n  get body(): Buffer | undefined {\n    if (this.tooLarge) {\n      return BODY_TOO_LARGE_BUFFER;\n    }\n    if (!this.completed || this.bufferedLength === 0) {\n      return undefined;\n    }\n    return Buffer.concat(this.chunks);\n  }\n\n  // The trusted declared size, else the running byte count once the stream was\n  // observed to completion; undefined means no size attribute.\n  get size(): number | undefined {\n    if (this.declaredSize !== undefined) {\n      return this.declaredSize;\n    }\n    return this.completed ? this.observedLength : undefined;\n  }\n}\n\nexport interface CapturedBody {\n  body?: Buffer;\n  size?: number;\n}\n\nfunction isAllowedContentType(contentType: string | null | undefined): boolean {\n  if (!contentType) {\n    return false;\n  }\n  const normalized = contentType.trim().toLowerCase();\n  return ALLOWED_CONTENT_TYPES.some((allowed) => normalized.startsWith(allowed));\n}\n\nfunction parseContentLength(\n  value: string | number | string[] | null | undefined,\n): number | undefined {\n  if (typeof value === \"number\") {\n    return value;\n  }\n  if (typeof value === \"string\") {\n    const parsed = Number.parseInt(value, 10);\n    return Number.isNaN(parsed) ? undefined : parsed;\n  }\n  if (Array.isArray(value)) {\n    return parseContentLength(value[0]);\n  }\n  return undefined;\n}\n"],"mappings":"AAEO,MAAM,gBAAgB;AACtB,MAAM,iBAAiB;AACvB,MAAM,wBAAwB,OAAO,KAAK,cAAc;AAE/D,MAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAWO,MAAM,YAAY;AAAA,EACf;AAAA,EACS;AAAA,EACT;AAAA,EACA,SAAuB,CAAC;AAAA,EACxB,iBAAiB;AAAA,EACjB,iBAAiB;AAAA,EACjB,YAAY;AAAA,EAEpB,YAAY,SAA6B;AACvC,SAAK,gBAAgB,QAAQ,eAAe,qBAAqB,QAAQ,WAAW;AAGpF,UAAM,mBAAmB,MAAM,QAAQ,QAAQ,gBAAgB,IAC3D,QAAQ,iBAAiB,KAAK,GAAG,IACjC,QAAQ;AACZ,UAAM,4BACJ,OAAO,qBAAqB,YAAY,iBAAiB,YAAY,EAAE,SAAS,SAAS;AAC3F,SAAK,eAAe,4BAChB,SACA,mBAAmB,QAAQ,aAAa;AAC5C,SAAK,WACH,KAAK,iBAAiB,KAAK,iBAAiB,UAAa,KAAK,eAAe;AAAA,EACjF;AAAA,EAEA,IAAI,cAAuB;AACzB,WAAO,KAAK,iBAAiB,CAAC,KAAK;AAAA,EACrC;AAAA,EAEA,SAAS,OAAqC,UAAiC;AAC7E,UAAM,aACJ,OAAO,UAAU,WAAW,OAAO,WAAW,OAAO,QAAQ,IAAI,MAAM;AACzE,SAAK,kBAAkB;AACvB,QAAI,CAAC,KAAK,iBAAiB,KAAK,UAAU;AACxC;AAAA,IACF;AACA,UAAM,QAAQ,OAAO,UAAU,WAAW,OAAO,KAAK,OAAO,QAAQ,IAAI;AACzE,SAAK,kBAAkB;AACvB,QAAI,KAAK,iBAAiB,eAAe;AAGvC,WAAK,WAAW;AAChB,WAAK,SAAS,CAAC;AACf;AAAA,IACF;AACA,SAAK,OAAO,KAAK,KAAK;AAAA,EACxB;AAAA,EAEA,gBAAsB;AACpB,SAAK,gBAAgB;AACrB,SAAK,WAAW;AAChB,SAAK,SAAS,CAAC;AACf,SAAK,iBAAiB;AAAA,EACxB;AAAA,EAEA,eAAqB;AACnB,SAAK,YAAY;AAAA,EACnB;AAAA;AAAA;AAAA,EAIA,IAAI,OAA2B;AAC7B,QAAI,KAAK,UAAU;AACjB,aAAO;AAAA,IACT;AACA,QAAI,CAAC,KAAK,aAAa,KAAK,mBAAmB,GAAG;AAChD,aAAO;AAAA,IACT;AACA,WAAO,OAAO,OAAO,KAAK,MAAM;AAAA,EAClC;AAAA;AAAA;AAAA,EAIA,IAAI,OAA2B;AAC7B,QAAI,KAAK,iBAAiB,QAAW;AACnC,aAAO,KAAK;AAAA,IACd;AACA,WAAO,KAAK,YAAY,KAAK,iBAAiB;AAAA,EAChD;AACF;AAOA,SAAS,qBAAqB,aAAiD;AAC7E,MAAI,CAAC,aAAa;AAChB,WAAO;AAAA,EACT;AACA,QAAM,aAAa,YAAY,KAAK,EAAE,YAAY;AAClD,SAAO,sBAAsB,KAAK,CAAC,YAAY,WAAW,WAAW,OAAO,CAAC;AAC/E;AAEA,SAAS,mBACP,OACoB;AACpB,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,SAAS,OAAO,SAAS,OAAO,EAAE;AACxC,WAAO,OAAO,MAAM,MAAM,IAAI,SAAY;AAAA,EAC5C;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,mBAAmB,MAAM,CAAC,CAAC;AAAA,EACpC;AACA,SAAO;AACT;","names":[]}

package/dist/config.cjs

@@ -0,0 +1,227 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var config_exports = {};
+__export(config_exports, {
+  DEFAULT_ENV: () => DEFAULT_ENV,
+  DEFAULT_EXCLUDE_PATHS: () => DEFAULT_EXCLUDE_PATHS,
+  DEFAULT_MASK_BODY_FIELDS: () => DEFAULT_MASK_BODY_FIELDS,
+  DEFAULT_MASK_HEADERS: () => DEFAULT_MASK_HEADERS,
+  DEFAULT_MASK_QUERY_PARAMS: () => DEFAULT_MASK_QUERY_PARAMS,
+  EXCLUDE_USER_AGENTS: () => EXCLUDE_USER_AGENTS,
+  compilePatterns: () => compilePatterns,
+  getConfig: () => getConfig,
+  isApitallyDisabledViaEnv: () => isApitallyDisabledViaEnv,
+  isValidWriteToken: () => isValidWriteToken,
+  matchesAny: () => matchesAny,
+  setConfig: () => setConfig
+});
+module.exports = __toCommonJS(config_exports);
+var import_logger = require('./logger.cjs');
+const DEFAULT_OTLP_ENDPOINT = "https://otlp.apitally.io";
+const DEFAULT_ENV = "dev";
+const DEFAULT_MASK_QUERY_PARAMS = [
+  "auth",
+  "api[-_]?key",
+  "secret",
+  "token",
+  "password",
+  "pwd"
+];
+const DEFAULT_MASK_HEADERS = ["auth", "api[-_]?key", "secret", "token", "cookie"];
+const DEFAULT_MASK_BODY_FIELDS = [
+  "password",
+  "pwd",
+  "token",
+  "secret",
+  "auth",
+  "card[-_ ]?number",
+  "ccv",
+  "ssn"
+];
+const DEFAULT_EXCLUDE_PATHS = [
+  "/_?healthz?/?$",
+  "/_?health[-_]?checks?/?$",
+  "/_?heart[-_]?beats?/?$",
+  "/ping/?$",
+  "/ready/?$",
+  "/live/?$",
+  "/favicon(?:-[\\w-]+)?\\.(ico|png|svg)$",
+  "/apple-touch-icon(?:-[\\w-]+)?\\.png$",
+  "/robots\\.txt$",
+  "/sitemap\\.xml$",
+  "/manifest\\.json$",
+  "/site\\.webmanifest$",
+  "/service-worker\\.js$",
+  "/sw\\.js$",
+  "/\\.well-known/"
+];
+const EXCLUDE_USER_AGENTS = [
+  "health[-_ ]?check",
+  "microsoft-azure-application-lb",
+  "googlehc",
+  "kube-probe"
+];
+const WRITE_TOKEN_FORMAT = /^apt_[a-zA-Z0-9]{24}$/;
+const TRUE_VALUES = /* @__PURE__ */ new Set(["1", "true", "yes"]);
+const GLOBAL_CONFIG_KEY = /* @__PURE__ */ Symbol.for("apitally.config");
+const configHolder = globalThis;
+function setConfig(options = {}) {
+  const { config, error } = resolveConfig(options);
+  const currentConfig = configHolder[GLOBAL_CONFIG_KEY];
+  if (currentConfig) {
+    if (!isSameConfig(config, currentConfig)) {
+      (0, import_logger.logWarning)(
+        "useApitally() was called again with different options; the first call's configuration stays in effect"
+      );
+    }
+    return currentConfig;
+  }
+  if (error) {
+    (0, import_logger.logError)(error);
+  }
+  configHolder[GLOBAL_CONFIG_KEY] = config;
+  return config;
+}
+function getConfig() {
+  return configHolder[GLOBAL_CONFIG_KEY] ?? resolveConfig({}).config;
+}
+function isValidWriteToken(value) {
+  return WRITE_TOKEN_FORMAT.test(value);
+}
+function isApitallyDisabledViaEnv() {
+  return isTruthyEnvValue(process.env.APITALLY_DISABLED);
+}
+function matchesAny(patterns, value) {
+  return patterns.some((pattern) => {
+    pattern.lastIndex = 0;
+    return pattern.test(value);
+  });
+}
+function compilePatterns(defaults, userPatterns = []) {
+  return [
+    ...defaults.map((pattern) => new RegExp(pattern, "i")),
+    ...userPatterns.map((pattern) => new RegExp(pattern))
+  ];
+}
+function resolveConfig(options) {
+  const config = {
+    writeToken: options.writeToken ?? nonEmptyEnvVar("APITALLY_WRITE_TOKEN") ?? "",
+    env: options.env ?? nonEmptyEnvVar("APITALLY_ENV") ?? DEFAULT_ENV,
+    appVersion: options.appVersion,
+    disabled: options.disabled === true || isTruthyEnvValue(process.env.APITALLY_DISABLED) || isTruthyEnvValue(process.env.OTEL_SDK_DISABLED),
+    captureLogs: options.captureLogs ?? true,
+    captureRequestHeaders: options.captureRequestHeaders ?? false,
+    captureRequestBody: options.captureRequestBody ?? false,
+    captureResponseHeaders: options.captureResponseHeaders ?? true,
+    captureResponseBody: options.captureResponseBody ?? false,
+    maskQueryParams: dropNonRegExpPatterns("maskQueryParams", options.maskQueryParams),
+    maskHeaders: dropNonRegExpPatterns("maskHeaders", options.maskHeaders),
+    maskBodyFields: dropNonRegExpPatterns("maskBodyFields", options.maskBodyFields),
+    maskRequestBody: options.maskRequestBody,
+    maskResponseBody: options.maskResponseBody,
+    maskLogRecord: options.maskLogRecord,
+    excludePaths: dropNonRegExpPatterns("excludePaths", options.excludePaths),
+    // An invalid sampleRate resolves to capturing everything: no data is lost, so no warning.
+    sampleRate: typeof options.sampleRate === "number" && options.sampleRate >= 0 && options.sampleRate <= 1 ? options.sampleRate : 1,
+    sampleOnRequest: options.sampleOnRequest,
+    sampleOnResponse: options.sampleOnResponse,
+    otlpEndpoint: nonEmptyEnvVar("APITALLY_OTLP_ENDPOINT") ?? DEFAULT_OTLP_ENDPOINT
+  };
+  if (config.disabled) {
+    return { config };
+  }
+  if (!config.writeToken) {
+    config.disabled = true;
+    return {
+      config,
+      error: "Apitally write token is missing (set the writeToken option or the APITALLY_WRITE_TOKEN environment variable)"
+    };
+  }
+  if (!isValidWriteToken(config.writeToken)) {
+    config.disabled = true;
+    return {
+      config,
+      error: `Apitally write token has an invalid format: ${config.writeToken.slice(0, 8)}...`
+    };
+  }
+  if (!isHttpUrl(config.otlpEndpoint)) {
+    config.disabled = true;
+    return {
+      config,
+      error: `Apitally OTLP endpoint is not a valid HTTP or HTTPS URL: ${config.otlpEndpoint}`
+    };
+  }
+  return { config };
+}
+function isHttpUrl(value) {
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    return false;
+  }
+  return url.protocol === "http:" || url.protocol === "https:";
+}
+function dropNonRegExpPatterns(optionName, patterns = []) {
+  return patterns.filter((pattern) => {
+    if (pattern instanceof RegExp) {
+      return true;
+    }
+    (0, import_logger.logError)(`Pattern in ${optionName} ignored because it is not a RegExp: ${String(pattern)}`);
+    return false;
+  });
+}
+function isSameConfig(a, b) {
+  return Object.keys(a).every((key) => {
+    const left = a[key];
+    const right = b[key];
+    if (Array.isArray(left) && Array.isArray(right)) {
+      return left.length === right.length && left.every((item, index) => {
+        const other = right[index];
+        return item instanceof RegExp && other instanceof RegExp && item.source === other.source && item.flags === other.flags;
+      });
+    }
+    if (typeof left === "function" && typeof right === "function") {
+      return true;
+    }
+    return left === right;
+  });
+}
+function isTruthyEnvValue(value) {
+  return value !== void 0 && TRUE_VALUES.has(value.trim().toLowerCase());
+}
+function nonEmptyEnvVar(name) {
+  return process.env[name]?.trim() || void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_ENV,
+  DEFAULT_EXCLUDE_PATHS,
+  DEFAULT_MASK_BODY_FIELDS,
+  DEFAULT_MASK_HEADERS,
+  DEFAULT_MASK_QUERY_PARAMS,
+  EXCLUDE_USER_AGENTS,
+  compilePatterns,
+  getConfig,
+  isApitallyDisabledViaEnv,
+  isValidWriteToken,
+  matchesAny,
+  setConfig
+});
+//# sourceMappingURL=config.cjs.map

package/dist/config.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import type { ReadWriteLogRecord } from \"@opentelemetry/sdk-logs\";\nimport type { ReadableSpan } from \"@opentelemetry/sdk-trace-base\";\nimport { logError, logWarning } from \"./logger.js\";\n\nexport type BodyMaskingCallback = (body: Buffer, span: ReadableSpan) => Buffer | null;\nexport type LogRecordMaskingCallback = (\n  logRecord: ReadWriteLogRecord,\n) => ReadWriteLogRecord | null | undefined;\nexport type SamplingCallback = (span: ReadableSpan) => number | boolean | undefined;\n\nexport interface ApitallyOptions {\n  writeToken?: string;\n  env?: string;\n  appVersion?: string;\n  disabled?: boolean;\n  captureLogs?: boolean;\n  captureRequestHeaders?: boolean;\n  captureRequestBody?: boolean;\n  captureResponseHeaders?: boolean;\n  captureResponseBody?: boolean;\n  maskQueryParams?: RegExp[];\n  maskHeaders?: RegExp[];\n  maskBodyFields?: RegExp[];\n  maskRequestBody?: BodyMaskingCallback;\n  maskResponseBody?: BodyMaskingCallback;\n  maskLogRecord?: LogRecordMaskingCallback;\n  excludePaths?: RegExp[];\n  sampleRate?: number;\n  sampleOnRequest?: SamplingCallback;\n  sampleOnResponse?: SamplingCallback;\n}\n\ntype OptionalConfigKeys =\n  | \"appVersion\"\n  | \"maskRequestBody\"\n  | \"maskResponseBody\"\n  | \"maskLogRecord\"\n  | \"sampleOnRequest\"\n  | \"sampleOnResponse\";\n\nexport type ApitallyConfig = Required<Omit<ApitallyOptions, OptionalConfigKeys>> &\n  Pick<ApitallyOptions, OptionalConfigKeys> & { otlpEndpoint: string };\n\nconst DEFAULT_OTLP_ENDPOINT = \"https://otlp.apitally.io\";\nexport const DEFAULT_ENV = \"dev\";\n\n// User-supplied patterns extend these defaults, never replace them.\nexport const DEFAULT_MASK_QUERY_PARAMS = [\n  \"auth\",\n  \"api[-_]?key\",\n  \"secret\",\n  \"token\",\n  \"password\",\n  \"pwd\",\n];\nexport const DEFAULT_MASK_HEADERS = [\"auth\", \"api[-_]?key\", \"secret\", \"token\", \"cookie\"];\nexport const DEFAULT_MASK_BODY_FIELDS = [\n  \"password\",\n  \"pwd\",\n  \"token\",\n  \"secret\",\n  \"auth\",\n  \"card[-_ ]?number\",\n  \"ccv\",\n  \"ssn\",\n];\nexport const DEFAULT_EXCLUDE_PATHS = [\n  \"/_?healthz?/?$\",\n  \"/_?health[-_]?checks?/?$\",\n  \"/_?heart[-_]?beats?/?$\",\n  \"/ping/?$\",\n  \"/ready/?$\",\n  \"/live/?$\",\n  \"/favicon(?:-[\\\\w-]+)?\\\\.(ico|png|svg)$\",\n  \"/apple-touch-icon(?:-[\\\\w-]+)?\\\\.png$\",\n  \"/robots\\\\.txt$\",\n  \"/sitemap\\\\.xml$\",\n  \"/manifest\\\\.json$\",\n  \"/site\\\\.webmanifest$\",\n  \"/service-worker\\\\.js$\",\n  \"/sw\\\\.js$\",\n  \"/\\\\.well-known/\",\n];\nexport const EXCLUDE_USER_AGENTS = [\n  \"health[-_ ]?check\",\n  \"microsoft-azure-application-lb\",\n  \"googlehc\",\n  \"kube-probe\",\n];\n\nconst WRITE_TOKEN_FORMAT = /^apt_[a-zA-Z0-9]{24}$/;\nconst TRUE_VALUES = new Set([\"1\", \"true\", \"yes\"]);\n\n// The ESM and CJS builds can load together, so a Symbol.for key gives both\n// copies the same configuration.\nconst GLOBAL_CONFIG_KEY = Symbol.for(\"apitally.config\");\nconst configHolder = globalThis as Record<symbol, ApitallyConfig | undefined>;\n\nexport function setConfig(options: ApitallyOptions = {}): ApitallyConfig {\n  const { config, error } = resolveConfig(options);\n  const currentConfig = configHolder[GLOBAL_CONFIG_KEY];\n  if (currentConfig) {\n    if (!isSameConfig(config, currentConfig)) {\n      logWarning(\n        \"useApitally() was called again with different options; the first call's configuration stays in effect\",\n      );\n    }\n    return currentConfig;\n  }\n  if (error) {\n    logError(error);\n  }\n  configHolder[GLOBAL_CONFIG_KEY] = config;\n  return config;\n}\n\nexport function getConfig(): ApitallyConfig {\n  return configHolder[GLOBAL_CONFIG_KEY] ?? resolveConfig({}).config;\n}\n\nexport function isValidWriteToken(value: string): boolean {\n  return WRITE_TOKEN_FORMAT.test(value);\n}\n\n// The emergency kill switch, re-checked at the activation boundary so it wins\n// even over an explicit disabled: false option.\nexport function isApitallyDisabledViaEnv(): boolean {\n  return isTruthyEnvValue(process.env.APITALLY_DISABLED);\n}\n\nexport function matchesAny(patterns: RegExp[], value: string): boolean {\n  return patterns.some((pattern) => {\n    pattern.lastIndex = 0;\n    return pattern.test(value);\n  });\n}\n\nexport function compilePatterns(defaults: string[], userPatterns: RegExp[] = []): RegExp[] {\n  return [\n    ...defaults.map((pattern) => new RegExp(pattern, \"i\")),\n    ...userPatterns.map((pattern) => new RegExp(pattern)),\n  ];\n}\n\nfunction resolveConfig(options: ApitallyOptions): {\n  config: ApitallyConfig;\n  error?: string;\n} {\n  const config: ApitallyConfig = {\n    writeToken: options.writeToken ?? nonEmptyEnvVar(\"APITALLY_WRITE_TOKEN\") ?? \"\",\n    env: options.env ?? nonEmptyEnvVar(\"APITALLY_ENV\") ?? DEFAULT_ENV,\n    appVersion: options.appVersion,\n    disabled:\n      options.disabled === true ||\n      isTruthyEnvValue(process.env.APITALLY_DISABLED) ||\n      isTruthyEnvValue(process.env.OTEL_SDK_DISABLED),\n    captureLogs: options.captureLogs ?? true,\n    captureRequestHeaders: options.captureRequestHeaders ?? false,\n    captureRequestBody: options.captureRequestBody ?? false,\n    captureResponseHeaders: options.captureResponseHeaders ?? true,\n    captureResponseBody: options.captureResponseBody ?? false,\n    maskQueryParams: dropNonRegExpPatterns(\"maskQueryParams\", options.maskQueryParams),\n    maskHeaders: dropNonRegExpPatterns(\"maskHeaders\", options.maskHeaders),\n    maskBodyFields: dropNonRegExpPatterns(\"maskBodyFields\", options.maskBodyFields),\n    maskRequestBody: options.maskRequestBody,\n    maskResponseBody: options.maskResponseBody,\n    maskLogRecord: options.maskLogRecord,\n    excludePaths: dropNonRegExpPatterns(\"excludePaths\", options.excludePaths),\n    // An invalid sampleRate resolves to capturing everything: no data is lost, so no warning.\n    sampleRate:\n      typeof options.sampleRate === \"number\" && options.sampleRate >= 0 && options.sampleRate <= 1\n        ? options.sampleRate\n        : 1,\n    sampleOnRequest: options.sampleOnRequest,\n    sampleOnResponse: options.sampleOnResponse,\n    otlpEndpoint: nonEmptyEnvVar(\"APITALLY_OTLP_ENDPOINT\") ?? DEFAULT_OTLP_ENDPOINT,\n  };\n  if (config.disabled) {\n    return { config };\n  }\n  if (!config.writeToken) {\n    config.disabled = true;\n    return {\n      config,\n      error:\n        \"Apitally write token is missing (set the writeToken option or the APITALLY_WRITE_TOKEN environment variable)\",\n    };\n  }\n  if (!isValidWriteToken(config.writeToken)) {\n    config.disabled = true;\n    // The write token is a credential and must never appear unmasked in logs.\n    return {\n      config,\n      error: `Apitally write token has an invalid format: ${config.writeToken.slice(0, 8)}...`,\n    };\n  }\n  if (!isHttpUrl(config.otlpEndpoint)) {\n    config.disabled = true;\n    return {\n      config,\n      error: `Apitally OTLP endpoint is not a valid HTTP or HTTPS URL: ${config.otlpEndpoint}`,\n    };\n  }\n  return { config };\n}\n\nfunction isHttpUrl(value: string): boolean {\n  let url: URL;\n  try {\n    url = new URL(value);\n  } catch {\n    return false;\n  }\n  return url.protocol === \"http:\" || url.protocol === \"https:\";\n}\n\n// Invalid pattern values could leave data unredacted, so they are logged and omitted.\nfunction dropNonRegExpPatterns(optionName: string, patterns: RegExp[] = []): RegExp[] {\n  return patterns.filter((pattern) => {\n    if (pattern instanceof RegExp) {\n      return true;\n    }\n    logError(`Pattern in ${optionName} ignored because it is not a RegExp: ${String(pattern)}`);\n    return false;\n  });\n}\n\nfunction isSameConfig(a: ApitallyConfig, b: ApitallyConfig): boolean {\n  return (Object.keys(a) as (keyof ApitallyConfig)[]).every((key) => {\n    const left = a[key];\n    const right = b[key];\n    if (Array.isArray(left) && Array.isArray(right)) {\n      return (\n        left.length === right.length &&\n        left.every((item, index) => {\n          const other = right[index];\n          return (\n            item instanceof RegExp &&\n            other instanceof RegExp &&\n            item.source === other.source &&\n            item.flags === other.flags\n          );\n        })\n      );\n    }\n    // Callback identity says nothing about sameness; app factories create them inline.\n    if (typeof left === \"function\" && typeof right === \"function\") {\n      return true;\n    }\n    return left === right;\n  });\n}\n\nfunction isTruthyEnvValue(value: string | undefined): boolean {\n  return value !== undefined && TRUE_VALUES.has(value.trim().toLowerCase());\n}\n\nfunction nonEmptyEnvVar(name: string): string | undefined {\n  return process.env[name]?.trim() || undefined;\n}\n"],"mappings":"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","names":[]}

package/dist/config.d.cts

@@ -0,0 +1,45 @@
+import { ReadWriteLogRecord } from '@opentelemetry/sdk-logs';
+import { ReadableSpan } from '@opentelemetry/sdk-trace-base';
+
+type BodyMaskingCallback = (body: Buffer, span: ReadableSpan) => Buffer | null;
+type LogRecordMaskingCallback = (logRecord: ReadWriteLogRecord) => ReadWriteLogRecord | null | undefined;
+type SamplingCallback = (span: ReadableSpan) => number | boolean | undefined;
+interface ApitallyOptions {
+    writeToken?: string;
+    env?: string;
+    appVersion?: string;
+    disabled?: boolean;
+    captureLogs?: boolean;
+    captureRequestHeaders?: boolean;
+    captureRequestBody?: boolean;
+    captureResponseHeaders?: boolean;
+    captureResponseBody?: boolean;
+    maskQueryParams?: RegExp[];
+    maskHeaders?: RegExp[];
+    maskBodyFields?: RegExp[];
+    maskRequestBody?: BodyMaskingCallback;
+    maskResponseBody?: BodyMaskingCallback;
+    maskLogRecord?: LogRecordMaskingCallback;
+    excludePaths?: RegExp[];
+    sampleRate?: number;
+    sampleOnRequest?: SamplingCallback;
+    sampleOnResponse?: SamplingCallback;
+}
+type OptionalConfigKeys = "appVersion" | "maskRequestBody" | "maskResponseBody" | "maskLogRecord" | "sampleOnRequest" | "sampleOnResponse";
+type ApitallyConfig = Required<Omit<ApitallyOptions, OptionalConfigKeys>> & Pick<ApitallyOptions, OptionalConfigKeys> & {
+    otlpEndpoint: string;
+};
+declare const DEFAULT_ENV = "dev";
+declare const DEFAULT_MASK_QUERY_PARAMS: string[];
+declare const DEFAULT_MASK_HEADERS: string[];
+declare const DEFAULT_MASK_BODY_FIELDS: string[];
+declare const DEFAULT_EXCLUDE_PATHS: string[];
+declare const EXCLUDE_USER_AGENTS: string[];
+declare function setConfig(options?: ApitallyOptions): ApitallyConfig;
+declare function getConfig(): ApitallyConfig;
+declare function isValidWriteToken(value: string): boolean;
+declare function isApitallyDisabledViaEnv(): boolean;
+declare function matchesAny(patterns: RegExp[], value: string): boolean;
+declare function compilePatterns(defaults: string[], userPatterns?: RegExp[]): RegExp[];
+
+export { type ApitallyConfig, type ApitallyOptions, type BodyMaskingCallback, DEFAULT_ENV, DEFAULT_EXCLUDE_PATHS, DEFAULT_MASK_BODY_FIELDS, DEFAULT_MASK_HEADERS, DEFAULT_MASK_QUERY_PARAMS, EXCLUDE_USER_AGENTS, type LogRecordMaskingCallback, type SamplingCallback, compilePatterns, getConfig, isApitallyDisabledViaEnv, isValidWriteToken, matchesAny, setConfig };