lograil 0.1.0

package/dist/cjs/pipeline/pipeline.d.ts

@@ -0,0 +1,45 @@
+import type { LogEntry } from '../types.js';
+import type { Filter } from './filter.js';
+import type { Processor } from './processor.js';
+import type { Formatter } from './formatter.js';
+export interface PipelineOptions {
+    filters?: Filter[];
+    processors?: Processor[];
+    formatter?: Formatter;
+}
+/**
+ * The processing pipeline sits between the Logger (entry creation) and the
+ * Transports (output). For each entry it:
+ *
+ *   1. runs all {@link Filter}s — if any returns `false` the entry is dropped;
+ *   2. runs all {@link Processor}s in order, allowing enrichment / redaction;
+ *   3. exposes a {@link Formatter} used by transports to serialize the entry.
+ */
+export declare class Pipeline {
+    private filters;
+    private processors;
+    private formatter;
+    private cachedFilter;
+    /**
+     * Error sink for a throwing {@link Filter} or {@link Processor}. The logger
+     * wires this to its own global error handler; when unset, the throw is simply
+     * swallowed and the entry proceeds unchanged (for processors) or is dropped
+     * (for filters).
+     */
+    onError?: (err: unknown, info: {
+        phase: 'filter' | 'process';
+        entry: LogEntry;
+    }) => void;
+    constructor(options?: PipelineOptions);
+    addFilter(filter: Filter): void;
+    addProcessor(processor: Processor): void;
+    removeFilter(filter: Filter): void;
+    removeProcessor(processor: Processor): void;
+    setFormatter(formatter: Formatter): void;
+    getFormatter(): Formatter;
+    /**
+     * Run filters and processors. Returns `null` when the entry is filtered out.
+     */
+    process(entry: LogEntry): LogEntry | null;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/cjs/pipeline/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../src/pipeline/pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC;IACzB,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,OAAO,CAAC,OAAO,CAAW;IAC1B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,YAAY,CAAiC;IACrD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,KAAK,IAAI,CAAC;gBAE7E,OAAO,GAAE,eAAoB;IAMzC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIxC,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAMlC,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAK3C,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAIxC,YAAY,IAAI,SAAS;IAIzB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,IAAI;CA4B1C"}

package/dist/cjs/pipeline/pipeline.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Pipeline = void 0;
+const filter_js_1 = require("./filter.js");
+/**
+ * The processing pipeline sits between the Logger (entry creation) and the
+ * Transports (output). For each entry it:
+ *
+ *   1. runs all {@link Filter}s — if any returns `false` the entry is dropped;
+ *   2. runs all {@link Processor}s in order, allowing enrichment / redaction;
+ *   3. exposes a {@link Formatter} used by transports to serialize the entry.
+ */
+class Pipeline {
+    constructor(options = {}) {
+        this.cachedFilter = undefined;
+        this.filters = options.filters ? [...options.filters] : [];
+        this.processors = options.processors ? [...options.processors] : [];
+        this.formatter = options.formatter ?? ((e) => e);
+    }
+    addFilter(filter) {
+        this.filters.push(filter);
+        this.cachedFilter = undefined;
+    }
+    addProcessor(processor) {
+        this.processors.push(processor);
+    }
+    removeFilter(filter) {
+        const i = this.filters.indexOf(filter);
+        if (i >= 0)
+            this.filters.splice(i, 1);
+        this.cachedFilter = undefined;
+    }
+    removeProcessor(processor) {
+        const i = this.processors.indexOf(processor);
+        if (i >= 0)
+            this.processors.splice(i, 1);
+    }
+    setFormatter(formatter) {
+        this.formatter = formatter;
+    }
+    getFormatter() {
+        return this.formatter;
+    }
+    /**
+     * Run filters and processors. Returns `null` when the entry is filtered out.
+     */
+    process(entry) {
+        if (this.filters.length) {
+            if (this.cachedFilter === undefined) {
+                this.cachedFilter =
+                    this.filters.length === 1 ? this.filters[0] : (0, filter_js_1.combineFilters)(this.filters);
+            }
+            try {
+                if (!this.cachedFilter(entry)) {
+                    return null;
+                }
+            }
+            catch (err) {
+                this.onError?.(err, { phase: 'filter', entry });
+                return null;
+            }
+        }
+        let current = entry;
+        for (const processor of this.processors) {
+            try {
+                current = processor(current);
+            }
+            catch (err) {
+                // A broken processor must not crash logging. Keep the last good entry
+                // and continue with the remaining processors.
+                this.onError?.(err, { phase: 'process', entry });
+            }
+            if (!current)
+                return null;
+        }
+        return current;
+    }
+}
+exports.Pipeline = Pipeline;
+//# sourceMappingURL=pipeline.js.map

package/dist/cjs/pipeline/pipeline.js.map

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

package/dist/cjs/pipeline/processor.d.ts

@@ -0,0 +1,67 @@
+import type { LogEntry } from '../types.js';
+/**
+ * A Processor transforms a log entry before it is formatted. Processors must
+ * return (the same or a new) entry. They are useful for enrichment, redaction
+ * or normalization.
+ */
+export type Processor = (entry: LogEntry) => LogEntry;
+/**
+ * Default processor: returns the entry unchanged.
+ */
+export declare const identityProcessor: Processor;
+/**
+ * Create a processor that redacts sensitive data before formatting. It walks
+ * `context`, `metadata` and each element of `args`, replacing any value whose
+ * path matches one of `keys` with `replacement` (default `"[REDACTED]"`).
+ *
+ * Matching is **structural** — the original objects are never mutated; only the
+ * branches that actually contain a match are cloned. When nothing matches the
+ * entry is returned unchanged (same reference), so the common "no secret" case
+ * adds no allocation.
+ *
+ * @example
+ * createRedactProcessor(['password'])            // any `password` at any depth
+ * createRedactProcessor(['user.password'])       // only `user.password`
+ * createRedactProcessor(['*.token', 'user.*'])   // wildcards
+ */
+/**
+ * Common secret / PII key names redacted by {@link createRedactProcessor} when
+ * no explicit key list is supplied. Covers passwords, tokens, API keys, auth
+ * headers, cookies, private keys and a few PII fields.
+ */
+export declare const DEFAULT_SENSITIVE_KEYS: string[];
+export declare function createRedactProcessor(keys?: string[], replacement?: unknown): Processor;
+/**
+ * A Serializer transforms a single value keyed by `name` before formatting.
+ * `entry` is passed for contextual serialization (e.g. capturing the level).
+ */
+export type Serializer = (value: unknown, entry: LogEntry) => unknown;
+/**
+ * Create a processor that normalizes values by key name before formatting. For
+ * every property named `key` found in `context`, `metadata`, each element of
+ * `args` (and the entry's `error`), the matching serializer replaces the value.
+ * Matching is by property name at **any depth** (e.g. a `req` serializer runs on
+ * any object that has a `req` property).
+ *
+ * Transformation is **structural** — only the branches that contain a matching
+ * key are cloned; when no serializer fires the entry is returned unchanged (same
+ * reference), so the common "no serializer matched" case adds no allocation.
+ *
+ * @example
+ * createSerializeProcessor({
+ *   err: (e) => ({ name: e.name, message: e.message, stack: e.stack }),
+ *   user: (u) => ({ id: u.id }), // drop the rest of the user object
+ * })
+ */
+export declare function createSerializeProcessor(serializers: Record<string, Serializer>): Processor;
+/**
+ * A preset of common {@link Serializer}s keyed by the property names they match
+ * (`error`, `date`, `buffer`, `url`, `req`, `res`). Spread it into your own
+ * serializer map to get safe, compact representations of these types out of the
+ * box, e.g. `createSerializeProcessor({ ...createDefaultSerializers(), user })`.
+ *
+ * Matching is by property name at any depth (see {@link createSerializeProcessor}),
+ * so any object with a `req`/`res`/`url`/`error` property is normalized.
+ */
+export declare function createDefaultSerializers(): Record<string, Serializer>;
+//# sourceMappingURL=processor.d.ts.map

package/dist/cjs/pipeline/processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"processor.d.ts","sourceRoot":"","sources":["../../../src/pipeline/processor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,QAAQ,CAAC;AAEtD;;GAEG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAA4B,CAAC;AAwE7D;;;;;;;;;;;;;;GAcG;AACH;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,EA0B1C,CAAC;AAEF,wBAAgB,qBAAqB,CACnC,IAAI,GAAE,MAAM,EAA2B,EACvC,WAAW,GAAE,OAAsB,GAClC,SAAS,CAoBX;AAED;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC;AAoCtE;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,GAAG,SAAS,CA+B3F;AAqCD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CASrE"}

package/dist/cjs/pipeline/processor.js

@@ -0,0 +1,284 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SENSITIVE_KEYS = exports.identityProcessor = void 0;
+exports.createRedactProcessor = createRedactProcessor;
+exports.createSerializeProcessor = createSerializeProcessor;
+exports.createDefaultSerializers = createDefaultSerializers;
+/**
+ * Default processor: returns the entry unchanged.
+ */
+const identityProcessor = (entry) => entry;
+exports.identityProcessor = identityProcessor;
+/**
+ * Compile a redaction spec into a path matcher.
+ *
+ * - A bare key (no `.` and no `*`), e.g. `"password"`, matches **any** property
+ *   named that way at any depth (the historical behavior — convenient for
+ *   common secrets).
+ * - A dotted spec, e.g. `"user.password"` or `"*.password"`, matches only the
+ *   exact path. `*` matches any single key/array index at that position. Numeric
+ *   array indices are matched positionally (`"list.0.id"`).
+ */
+function compileMatcher(spec) {
+    if (!spec.includes('.') && !spec.includes('*')) {
+        return (p) => p.length > 0 && p[p.length - 1] === spec;
+    }
+    const segs = spec.split('.');
+    return (p) => {
+        if (p.length !== segs.length)
+            return false;
+        for (let i = 0; i < segs.length; i++) {
+            const s = segs[i];
+            if (s === '*')
+                continue;
+            if (String(p[i]) !== s)
+                return false;
+        }
+        return true;
+    };
+}
+function redactNode(node, path, matchers, replacement) {
+    if (Array.isArray(node)) {
+        let changed = false;
+        const out = new Array(node.length);
+        for (let i = 0; i < node.length; i++) {
+            const cp = [...path, i];
+            if (matchers.some((m) => m(cp))) {
+                out[i] = replacement;
+                changed = true;
+            }
+            else {
+                const r = redactNode(node[i], cp, matchers, replacement);
+                out[i] = r;
+                if (r !== node[i])
+                    changed = true;
+            }
+        }
+        return changed ? out : node;
+    }
+    if (node !== null && typeof node === 'object') {
+        let changed = false;
+        const out = {};
+        for (const k of Object.keys(node)) {
+            const cp = [...path, k];
+            const v = node[k];
+            if (matchers.some((m) => m(cp))) {
+                out[k] = replacement;
+                changed = true;
+            }
+            else {
+                const r = redactNode(v, cp, matchers, replacement);
+                out[k] = r;
+                if (r !== v)
+                    changed = true;
+            }
+        }
+        return changed ? out : node;
+    }
+    return node;
+}
+/**
+ * Create a processor that redacts sensitive data before formatting. It walks
+ * `context`, `metadata` and each element of `args`, replacing any value whose
+ * path matches one of `keys` with `replacement` (default `"[REDACTED]"`).
+ *
+ * Matching is **structural** — the original objects are never mutated; only the
+ * branches that actually contain a match are cloned. When nothing matches the
+ * entry is returned unchanged (same reference), so the common "no secret" case
+ * adds no allocation.
+ *
+ * @example
+ * createRedactProcessor(['password'])            // any `password` at any depth
+ * createRedactProcessor(['user.password'])       // only `user.password`
+ * createRedactProcessor(['*.token', 'user.*'])   // wildcards
+ */
+/**
+ * Common secret / PII key names redacted by {@link createRedactProcessor} when
+ * no explicit key list is supplied. Covers passwords, tokens, API keys, auth
+ * headers, cookies, private keys and a few PII fields.
+ */
+exports.DEFAULT_SENSITIVE_KEYS = [
+    'password',
+    'passwd',
+    'pwd',
+    'secret',
+    'token',
+    'accessToken',
+    'refreshToken',
+    'apiKey',
+    'api_key',
+    'authorization',
+    'auth',
+    'cookie',
+    'setCookie',
+    'set-cookie',
+    'privateKey',
+    'private_key',
+    'credentials',
+    'credential',
+    'sessionId',
+    'session',
+    'csrfToken',
+    'csrf',
+    'otp',
+    'ssn',
+    'x-api-key',
+];
+function createRedactProcessor(keys = exports.DEFAULT_SENSITIVE_KEYS, replacement = '[REDACTED]') {
+    if (keys.length === 0)
+        return exports.identityProcessor;
+    const matchers = keys.map(compileMatcher);
+    return (entry) => {
+        const context = redactNode(entry.context, [], matchers, replacement);
+        const metadata = redactNode(entry.metadata, [], matchers, replacement);
+        let argsChanged = false;
+        const args = entry.args.map((a) => {
+            const r = redactNode(a, [], matchers, replacement);
+            if (r !== a)
+                argsChanged = true;
+            return r;
+        });
+        if (context === entry.context && metadata === entry.metadata && !argsChanged) {
+            return entry;
+        }
+        return { ...entry, context, metadata, args: argsChanged ? args : entry.args };
+    };
+}
+function serializeNode(node, serializers, entry) {
+    if (Array.isArray(node)) {
+        let changed = false;
+        const out = new Array(node.length);
+        for (let i = 0; i < node.length; i++) {
+            const r = serializeNode(node[i], serializers, entry);
+            out[i] = r;
+            if (r !== node[i])
+                changed = true;
+        }
+        return changed ? out : node;
+    }
+    if (node !== null && typeof node === 'object') {
+        let changed = false;
+        const out = {};
+        for (const k of Object.keys(node)) {
+            const v = node[k];
+            if (serializers[k]) {
+                out[k] = serializers[k](v, entry);
+                changed = true;
+            }
+            else {
+                const r = serializeNode(v, serializers, entry);
+                out[k] = r;
+                if (r !== v)
+                    changed = true;
+            }
+        }
+        return changed ? out : node;
+    }
+    return node;
+}
+/**
+ * Create a processor that normalizes values by key name before formatting. For
+ * every property named `key` found in `context`, `metadata`, each element of
+ * `args` (and the entry's `error`), the matching serializer replaces the value.
+ * Matching is by property name at **any depth** (e.g. a `req` serializer runs on
+ * any object that has a `req` property).
+ *
+ * Transformation is **structural** — only the branches that contain a matching
+ * key are cloned; when no serializer fires the entry is returned unchanged (same
+ * reference), so the common "no serializer matched" case adds no allocation.
+ *
+ * @example
+ * createSerializeProcessor({
+ *   err: (e) => ({ name: e.name, message: e.message, stack: e.stack }),
+ *   user: (u) => ({ id: u.id }), // drop the rest of the user object
+ * })
+ */
+function createSerializeProcessor(serializers) {
+    if (!serializers || Object.keys(serializers).length === 0)
+        return exports.identityProcessor;
+    return (entry) => {
+        const context = serializeNode(entry.context, serializers, entry);
+        const metadata = serializeNode(entry.metadata, serializers, entry);
+        let argsChanged = false;
+        const args = entry.args.map((a) => {
+            const r = serializeNode(a, serializers, entry);
+            if (r !== a)
+                argsChanged = true;
+            return r;
+        });
+        let error = entry.error;
+        let errorChanged = false;
+        if (error !== undefined && serializers['error']) {
+            const r = serializers['error'](error, entry);
+            if (r !== error) {
+                error = r;
+                errorChanged = true;
+            }
+        }
+        if (context === entry.context && metadata === entry.metadata && !argsChanged && !errorChanged) {
+            return entry;
+        }
+        return {
+            ...entry,
+            context,
+            metadata,
+            args: argsChanged ? args : entry.args,
+            ...(errorChanged ? { error } : {}),
+        };
+    };
+}
+function serializeErrorValue(v) {
+    return v instanceof Error ? { name: v.name, message: v.message, stack: v.stack } : v;
+}
+function serializeBufferValue(v) {
+    if (typeof Buffer !== 'undefined' && Buffer.isBuffer(v))
+        return `Buffer(${v.length})`;
+    if (v instanceof ArrayBuffer)
+        return `ArrayBuffer(${v.byteLength})`;
+    if (ArrayBuffer.isView(v)) {
+        return `${v.constructor.name}(${v.byteLength})`;
+    }
+    return v;
+}
+function serializeUrlValue(v) {
+    return v instanceof URL ? v.href : v;
+}
+function serializeDateValue(v) {
+    return v instanceof Date ? v.toISOString() : v;
+}
+function serializeRequestValue(v) {
+    if (!v || typeof v !== 'object')
+        return v;
+    const r = v;
+    if (!('method' in r) && !('url' in r))
+        return v;
+    return { method: r.method, url: r.url, headers: r.headers };
+}
+function serializeResponseValue(v) {
+    if (!v || typeof v !== 'object')
+        return v;
+    const r = v;
+    if (!('status' in r) && !('statusCode' in r))
+        return v;
+    return { status: r.status ?? r.statusCode, headers: r.headers };
+}
+/**
+ * A preset of common {@link Serializer}s keyed by the property names they match
+ * (`error`, `date`, `buffer`, `url`, `req`, `res`). Spread it into your own
+ * serializer map to get safe, compact representations of these types out of the
+ * box, e.g. `createSerializeProcessor({ ...createDefaultSerializers(), user })`.
+ *
+ * Matching is by property name at any depth (see {@link createSerializeProcessor}),
+ * so any object with a `req`/`res`/`url`/`error` property is normalized.
+ */
+function createDefaultSerializers() {
+    return {
+        error: serializeErrorValue,
+        date: serializeDateValue,
+        buffer: serializeBufferValue,
+        url: serializeUrlValue,
+        req: serializeRequestValue,
+        res: serializeResponseValue,
+    };
+}
+//# sourceMappingURL=processor.js.map

package/dist/cjs/pipeline/processor.js.map

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

package/dist/cjs/pipeline/sampler.d.ts

@@ -0,0 +1,45 @@
+import type { LogLevelName } from '../types.js';
+import type { Filter } from './filter.js';
+export interface SamplingOptions {
+    /**
+     * Probability (0..1) that a sampled-level entry is kept. `1` (default) keeps
+     * everything; `0` drops all sampled-level entries. Applied before rate
+     * limiting. Sampling is intentionally lossy — only enable it for high-volume,
+     * low-value levels (e.g. `debug`/`info`).
+     */
+    rate?: number;
+    /**
+     * Restrict sampling to these level names. Entries of other levels always pass
+     * through untouched. Omit to sample every level.
+     */
+    levels?: LogLevelName[];
+    /**
+     * Maximum entries kept per second (token-bucket refill rate). When set, bursts
+     * up to `burst` are allowed, then entries are dropped until tokens refill.
+     * Off when unset. Combined with `rate` via logical AND.
+     */
+    maxPerSecond?: number;
+    /** Burst capacity for `maxPerSecond`; defaults to `maxPerSecond`. */
+    burst?: number;
+}
+/**
+ * Build a {@link Filter} that drops log entries to reduce volume. Two orthogonal
+ * strategies are supported and combined with a logical AND:
+ *
+ * - **probabilistic** (`rate`): keep each entry with probability `rate`;
+ * - **rate limiting** (`maxPerSecond` + `burst`): a token bucket caps throughput
+ *   per second, tolerating short bursts.
+ *
+ * Entries outside `levels` are always kept. Because this is a filter, sampled
+ * entries never reach processors, formatters or transports — so sampling is also
+ * the cheapest way to cut cost under load.
+ *
+ * @example
+ * ```ts
+ * logger.getPipeline().addFilter(
+ *   createSampler({ levels: ['debug', 'info'], maxPerSecond: 100, burst: 200 }),
+ * );
+ * ```
+ */
+export declare function createSampler(options?: SamplingOptions): Filter;
+//# sourceMappingURL=sampler.d.ts.map

package/dist/cjs/pipeline/sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../../src/pipeline/sampler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,YAAY,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC;IACxB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,qEAAqE;IACrE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,aAAa,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAuCnE"}

package/dist/cjs/pipeline/sampler.js

@@ -0,0 +1,62 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSampler = createSampler;
+/**
+ * Build a {@link Filter} that drops log entries to reduce volume. Two orthogonal
+ * strategies are supported and combined with a logical AND:
+ *
+ * - **probabilistic** (`rate`): keep each entry with probability `rate`;
+ * - **rate limiting** (`maxPerSecond` + `burst`): a token bucket caps throughput
+ *   per second, tolerating short bursts.
+ *
+ * Entries outside `levels` are always kept. Because this is a filter, sampled
+ * entries never reach processors, formatters or transports — so sampling is also
+ * the cheapest way to cut cost under load.
+ *
+ * @example
+ * ```ts
+ * logger.getPipeline().addFilter(
+ *   createSampler({ levels: ['debug', 'info'], maxPerSecond: 100, burst: 200 }),
+ * );
+ * ```
+ */
+function createSampler(options = {}) {
+    const rate = options.rate ?? 1;
+    const levelSet = options.levels ? new Set(options.levels) : undefined;
+    const maxPerSecond = options.maxPerSecond;
+    const capacity = maxPerSecond !== undefined ? (options.burst ?? maxPerSecond) : 0;
+    // Token-bucket state for rate limiting; lazily initialized on first use.
+    let tokens = capacity;
+    let lastRefill = 0;
+    return (entry) => {
+        // Levels not opted into sampling always pass through.
+        if (levelSet && !levelSet.has(entry.levelName))
+            return true;
+        // Probabilistic sampling.
+        if (rate < 1 && Math.random() >= rate)
+            return false;
+        // Rate limiting (token bucket keyed on the entry's ms timestamp).
+        if (maxPerSecond !== undefined) {
+            const now = entry.timestamp;
+            if (lastRefill === 0) {
+                lastRefill = now;
+                tokens = capacity;
+            }
+            else {
+                const elapsed = now - lastRefill;
+                if (elapsed > 0) {
+                    tokens = Math.min(capacity, tokens + (elapsed * maxPerSecond) / 1000);
+                    lastRefill = now;
+                }
+            }
+            if (tokens >= 1) {
+                tokens -= 1;
+            }
+            else {
+                return false;
+            }
+        }
+        return true;
+    };
+}
+//# sourceMappingURL=sampler.js.map

package/dist/cjs/pipeline/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../../../src/pipeline/sampler.ts"],"names":[],"mappings":";;AA6CA,sCAuCC;AA1DD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,aAAa,CAAC,UAA2B,EAAE;IACzD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC1C,MAAM,QAAQ,GAAG,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,IAAI,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAElF,yEAAyE;IACzE,IAAI,MAAM,GAAG,QAAQ,CAAC;IACtB,IAAI,UAAU,GAAG,CAAC,CAAC;IAEnB,OAAO,CAAC,KAAe,EAAW,EAAE;QAClC,sDAAsD;QACtD,IAAI,QAAQ,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAE5D,0BAA0B;QAC1B,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI;YAAE,OAAO,KAAK,CAAC;QAEpD,kEAAkE;QAClE,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;YAC5B,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;gBACrB,UAAU,GAAG,GAAG,CAAC;gBACjB,MAAM,GAAG,QAAQ,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,MAAM,OAAO,GAAG,GAAG,GAAG,UAAU,CAAC;gBACjC,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC,OAAO,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC;oBACtE,UAAU,GAAG,GAAG,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;gBAChB,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;iBAAM,CAAC;gBACN,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/dist/cjs/plugin/index.d.ts

@@ -0,0 +1,4 @@
+export * from './plugin.js';
+export * from './manager.js';
+export * from './otel-trace.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/plugin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,iBAAiB,CAAC"}

package/dist/cjs/plugin/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./plugin.js"), exports);
+__exportStar(require("./manager.js"), exports);
+__exportStar(require("./otel-trace.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/plugin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/plugin/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,+CAA6B;AAC7B,kDAAgC"}