@spinajs/log 2.0.481 → 2.0.482

package/lib/mjs/targets/wrappers/RetryingTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RetryingTarget.js","sourceRoot":"","sources":["../../../../src/targets/wrappers/RetryingTarget.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAmD,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,WAAW,EAAsB,yBAAyB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA0BrG;;;;;;;;;;GAUG;AAGI,IAAM,cAAc,GAApB,MAAM,cAAe,SAAQ,SAAiC;IAM5D,OAAO;QACZ,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC,OAAO,CAAkC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;QAE1H,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,CAAC,CAAC;QAC1D,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,GAAG,CAAC;QAEpD,sEAAsE;QACtE,8CAA8C;QAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,yBAAyB,EAAQ;aACvD,QAAQ,CAAC;YACR,gBAAgB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,GAAG,CAAC,CAAC;YAC9C,KAAK,EAAE,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC;YACzC,WAAW,EAAE,WAAW,CAAC,WAAW;YACpC,SAAS,EAAE,IAAI;SAChB,CAAC;aACD,KAAK,EAAE,CAAC;QAEX,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,KAAgB;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,0EAA0E;QAC1E,qDAAqD;QACrD,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1G,CAAC;IAEM,UAAU;QACf,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;IACjC,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,MAAO,IAAI,CAAC,KAAa,CAAC,OAAO,EAAE,EAAE,CAAC;IACxC,CAAC;CACF,CAAA;AA3CY,cAAc;IAF1B,SAAS,EAAE;IACX,UAAU,CAAC,gBAAgB,CAAC;GAChB,cAAc,CA2C1B"}

package/lib/mjs/targets/wrappers/SplitGroupTarget.d.ts

@@ -0,0 +1,30 @@
+import { ICommonTargetOptions, ILogEntry, ITargetsOption, LogTarget } from "@spinajs/log-common";
+/**
+ * Options for {@link SplitGroupTarget}.
+ */
+export interface ISplitGroupTargetOptions extends ICommonTargetOptions {
+    options: {
+        /**
+         * Inline child target definitions this group fans out to. Each is resolved
+         * through DI exactly like a top-level target, so any registered target type
+         * ( File, Json, Loki, another wrapper ... ) can be nested here.
+         */
+        targets: ITargetsOption[];
+    };
+}
+/**
+ * Fan-out wrapper: one configured target name that writes every entry to MANY
+ * inner targets. The inner targets are declared inline under `options.targets`
+ * and are owned by this wrapper ( they are NOT part of the logger's Targets
+ * list ), so the wrapper resolves, flushes and disposes them.
+ *
+ * Pure / browser-safe - just delegates to its children.
+ */
+export declare class SplitGroupTarget extends LogTarget<ISplitGroupTargetOptions> {
+    protected Inner: LogTarget<ICommonTargetOptions>[];
+    resolve(): void;
+    write(entry: ILogEntry): Promise<void>;
+    forceFlush(): Promise<void>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=SplitGroupTarget.d.ts.map

package/lib/mjs/targets/wrappers/SplitGroupTarget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SplitGroupTarget.d.ts","sourceRoot":"","sources":["../../../../src/targets/wrappers/SplitGroupTarget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAGjG;;GAEG;AACH,MAAM,WAAW,wBAAyB,SAAQ,oBAAoB;IACpE,OAAO,EAAE;QACP;;;;WAIG;QACH,OAAO,EAAE,cAAc,EAAE,CAAC;KAC3B,CAAC;CACH;AAED;;;;;;;GAOG;AACH,qBAEa,gBAAiB,SAAQ,SAAS,CAAC,wBAAwB,CAAC;IACvE,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,oBAAoB,CAAC,EAAE,CAAM;IAEjD,OAAO,IAAI,IAAI;IAQf,KAAK,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAStC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAKtC"}

package/lib/mjs/targets/wrappers/SplitGroupTarget.js

@@ -0,0 +1,49 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { LogTarget } from "@spinajs/log-common";
+import { DI, Injectable, Singleton } from "@spinajs/di";
+/**
+ * Fan-out wrapper: one configured target name that writes every entry to MANY
+ * inner targets. The inner targets are declared inline under `options.targets`
+ * and are owned by this wrapper ( they are NOT part of the logger's Targets
+ * list ), so the wrapper resolves, flushes and disposes them.
+ *
+ * Pure / browser-safe - just delegates to its children.
+ */
+let SplitGroupTarget = class SplitGroupTarget extends LogTarget {
+    constructor() {
+        super(...arguments);
+        this.Inner = [];
+    }
+    resolve() {
+        // resolve each child via DI exactly like FrameworkLogger.resolveLogTargets
+        // does - the child's ITargetsOption is passed as the single ctor arg.
+        this.Inner = this.Options.options.targets.map((t) => DI.resolve(t.type, [t]));
+        super.resolve();
+    }
+    write(entry) {
+        if (!this.Options.enabled) {
+            return Promise.resolve();
+        }
+        // wrap in Promise.resolve because some targets' write is sync / void.
+        return Promise.allSettled(this.Inner.map((t) => Promise.resolve(t.write(entry)))).then(() => undefined);
+    }
+    forceFlush() {
+        return Promise.allSettled(this.Inner.map((t) => t.forceFlush())).then(() => undefined);
+    }
+    async dispose() {
+        // the wrapper owns its children ( they are not in the logger's Targets list )
+        // so it drives their teardown.
+        await Promise.allSettled(this.Inner.map((t) => t.dispose?.()));
+    }
+};
+SplitGroupTarget = __decorate([
+    Singleton(),
+    Injectable("SplitGroupTarget")
+], SplitGroupTarget);
+export { SplitGroupTarget };
+//# sourceMappingURL=SplitGroupTarget.js.map

package/lib/mjs/targets/wrappers/SplitGroupTarget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SplitGroupTarget.js","sourceRoot":"","sources":["../../../../src/targets/wrappers/SplitGroupTarget.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAmD,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgBxD;;;;;;;GAOG;AAGI,IAAM,gBAAgB,GAAtB,MAAM,gBAAiB,SAAQ,SAAmC;IAAlE;;QACK,UAAK,GAAsC,EAAE,CAAC;IA4B1D,CAAC;IA1BQ,OAAO;QACZ,2EAA2E;QAC3E,sEAAsE;QACtE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,OAAO,CAAkC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE/G,KAAK,CAAC,OAAO,EAAE,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,KAAgB;QAC3B,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;YAC1B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;QAC3B,CAAC;QAED,sEAAsE;QACtE,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1G,CAAC;IAEM,UAAU;QACf,OAAO,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACzF,CAAC;IAEM,KAAK,CAAC,OAAO;QAClB,8EAA8E;QAC9E,+BAA+B;QAC/B,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAE,CAAS,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1E,CAAC;CACF,CAAA;AA7BY,gBAAgB;IAF5B,SAAS,EAAE;IACX,UAAU,CAAC,kBAAkB,CAAC;GAClB,gBAAgB,CA6B5B"}

package/lib/mjs/traceparent.d.ts

@@ -0,0 +1,63 @@
+/**
+ * W3C Trace Context ( traceparent ) utilities.
+ *
+ * Pure, dependency-free and cross-platform ( Node 20+ and browsers ) — randomness
+ * is sourced from the WHATWG `crypto.getRandomValues`, available on `globalThis`
+ * in both environments, so this module deliberately does NOT import
+ * `node:crypto` and stays safe to bundle for the browser.
+ *
+ * A W3C `traceparent` header has the shape:
+ *
+ *   version "-" trace-id "-" parent-id "-" trace-flags
+ *   00      -   32 hex    -   16 hex     -   2 hex
+ *
+ * See https://www.w3.org/TR/trace-context/#traceparent-header.
+ */
+/**
+ * Minimal trace context this service carries on the ambient store and emits on
+ * the outbound `traceparent` header.
+ */
+export interface ITraceContext {
+    /** 32-hex-char trace id, shared by every span across services in one trace. */
+    traceId: string;
+    /** 16-hex-char span id identifying this service's span within the trace. */
+    spanId: string;
+    /** Whether the trace is sampled ( low bit of the trace-flags ). */
+    sampled: boolean;
+}
+/**
+ * Parse & validate an inbound `traceparent` header value.
+ *
+ * @returns the decomposed parts ( plus the derived `sampled` flag ), or `null`
+ *          when the value is missing / malformed / forbidden by the spec
+ *          ( all-zero trace-id, all-zero parent-id, or version `ff` ).
+ */
+export declare function parseTraceparent(value: string | undefined | null): {
+    version: string;
+    traceId: string;
+    parentId: string;
+    flags: string;
+    sampled: boolean;
+} | null;
+/**
+ * A fresh random trace id ( 16 bytes -> 32 lowercase hex chars ).
+ */
+export declare function randomTraceId(): string;
+/**
+ * A fresh random span id ( 8 bytes -> 16 lowercase hex chars ).
+ */
+export declare function randomSpanId(): string;
+/**
+ * Render a {@link ITraceContext} as a W3C `traceparent` header value.
+ */
+export declare function formatTraceparent(ctx: ITraceContext): string;
+/**
+ * Derive this service's trace context for a request.
+ *
+ * When `inboundTraceparent` is a valid header we CONTINUE the trace: the trace
+ * id and sampled decision are inherited, and a fresh span id is minted for this
+ * service's own span ( its parent being the inbound `parent-id` ). Otherwise a
+ * brand-new, sampled trace is STARTED.
+ */
+export declare function newTraceContext(inboundTraceparent?: string | null): ITraceContext;
+//# sourceMappingURL=traceparent.d.ts.map

package/lib/mjs/traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent.d.ts","sourceRoot":"","sources":["../../src/traceparent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+EAA+E;IAC/E,OAAO,EAAE,MAAM,CAAC;IAChB,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;CAClB;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAwBjK;AAgBD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAE5D;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,aAAa,CAejF"}

package/lib/mjs/traceparent.js

@@ -0,0 +1,100 @@
+/**
+ * W3C Trace Context ( traceparent ) utilities.
+ *
+ * Pure, dependency-free and cross-platform ( Node 20+ and browsers ) — randomness
+ * is sourced from the WHATWG `crypto.getRandomValues`, available on `globalThis`
+ * in both environments, so this module deliberately does NOT import
+ * `node:crypto` and stays safe to bundle for the browser.
+ *
+ * A W3C `traceparent` header has the shape:
+ *
+ *   version "-" trace-id "-" parent-id "-" trace-flags
+ *   00      -   32 hex    -   16 hex     -   2 hex
+ *
+ * See https://www.w3.org/TR/trace-context/#traceparent-header.
+ */
+const TRACEPARENT_RE = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+const ZERO_TRACE_ID = "00000000000000000000000000000000";
+const ZERO_SPAN_ID = "0000000000000000";
+/**
+ * Parse & validate an inbound `traceparent` header value.
+ *
+ * @returns the decomposed parts ( plus the derived `sampled` flag ), or `null`
+ *          when the value is missing / malformed / forbidden by the spec
+ *          ( all-zero trace-id, all-zero parent-id, or version `ff` ).
+ */
+export function parseTraceparent(value) {
+    if (!value) {
+        return null;
+    }
+    const match = TRACEPARENT_RE.exec(value.toLowerCase());
+    if (!match) {
+        return null;
+    }
+    const [, version, traceId, parentId, flags] = match;
+    // Spec-forbidden values: version ff is reserved, and all-zero ids are invalid.
+    if (version === "ff" || traceId === ZERO_TRACE_ID || parentId === ZERO_SPAN_ID) {
+        return null;
+    }
+    return {
+        version,
+        traceId,
+        parentId,
+        flags,
+        sampled: (parseInt(flags, 16) & 0x01) === 1,
+    };
+}
+/**
+ * Cross-platform `n` random bytes rendered as lowercase hex.
+ */
+function randomHex(bytes) {
+    const buffer = new Uint8Array(bytes);
+    globalThis.crypto.getRandomValues(buffer);
+    let out = "";
+    for (const b of buffer) {
+        out += b.toString(16).padStart(2, "0");
+    }
+    return out;
+}
+/**
+ * A fresh random trace id ( 16 bytes -> 32 lowercase hex chars ).
+ */
+export function randomTraceId() {
+    return randomHex(16);
+}
+/**
+ * A fresh random span id ( 8 bytes -> 16 lowercase hex chars ).
+ */
+export function randomSpanId() {
+    return randomHex(8);
+}
+/**
+ * Render a {@link ITraceContext} as a W3C `traceparent` header value.
+ */
+export function formatTraceparent(ctx) {
+    return `00-${ctx.traceId}-${ctx.spanId}-${ctx.sampled ? "01" : "00"}`;
+}
+/**
+ * Derive this service's trace context for a request.
+ *
+ * When `inboundTraceparent` is a valid header we CONTINUE the trace: the trace
+ * id and sampled decision are inherited, and a fresh span id is minted for this
+ * service's own span ( its parent being the inbound `parent-id` ). Otherwise a
+ * brand-new, sampled trace is STARTED.
+ */
+export function newTraceContext(inboundTraceparent) {
+    const parsed = parseTraceparent(inboundTraceparent);
+    if (parsed) {
+        return {
+            traceId: parsed.traceId,
+            spanId: randomSpanId(),
+            sampled: parsed.sampled,
+        };
+    }
+    return {
+        traceId: randomTraceId(),
+        spanId: randomSpanId(),
+        sampled: true,
+    };
+}
+//# sourceMappingURL=traceparent.js.map

package/lib/mjs/traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent.js","sourceRoot":"","sources":["../../src/traceparent.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAeH,MAAM,cAAc,GAAG,6DAA6D,CAAC;AACrF,MAAM,aAAa,GAAG,kCAAkC,CAAC;AACzD,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAgC;IAC/D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,KAAK,GAAG,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,GAAG,KAAK,CAAC;IAEpD,+EAA+E;IAC/E,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,aAAa,IAAI,QAAQ,KAAK,YAAY,EAAE,CAAC;QAC/E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,OAAO;QACP,OAAO;QACP,QAAQ;QACR,KAAK;QACL,OAAO,EAAE,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACrC,UAAU,CAAC,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;IAE1C,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,SAAS,CAAC,EAAE,CAAC,CAAC;AACvB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAkB;IAClD,OAAO,MAAM,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,kBAAkC;IAChE,MAAM,MAAM,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IACpD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,MAAM,EAAE,YAAY,EAAE;YACtB,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,aAAa,EAAE;QACxB,MAAM,EAAE,YAAY,EAAE;QACtB,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC"}