@ogcio/o11y-sdk-node 0.4.2 → 0.6.0

package/dist/sdk-core/index.d.ts

@@ -0,0 +1 @@
+export * from "./lib/index.js";

package/dist/sdk-core/index.js

@@ -0,0 +1 @@
+export * from "./lib/index.js";

package/dist/sdk-core/lib/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./redaction/index.js";
+export * from "./utils/index.js";

package/dist/sdk-core/lib/index.js

@@ -0,0 +1,2 @@
+export * from "./redaction/index.js";
+export * from "./utils/index.js";

package/dist/sdk-core/lib/redaction/basic-redactor.d.ts

@@ -0,0 +1,7 @@
+import type { StringKind, RedactionResult } from "./index.js";
+export declare abstract class BasicRedactor {
+    constructor();
+    process(value: string, source: string, kind: StringKind): string;
+    protected redact(_value: string, _source: string, _kind: StringKind): RedactionResult<Record<string, unknown>>;
+    protected exportMetrics(_context: RedactionResult<Record<string, unknown>>["context"], _source: string, _kind: StringKind): void;
+}

package/dist/sdk-core/lib/redaction/basic-redactor.js

@@ -0,0 +1,18 @@
+export class BasicRedactor {
+    constructor() { }
+    process(value, source, kind) {
+        const { redactedValue, context } = this.redact(value, source, kind);
+        this.exportMetrics(context, source, kind);
+        return redactedValue;
+    }
+    redact(_value, _source, _kind) {
+        // no-op by default
+        return {
+            redactedValue: _value,
+            context: {},
+        };
+    }
+    exportMetrics(_context, _source, _kind) {
+        // no-op by default
+    }
+}

package/dist/sdk-core/lib/redaction/email-redactor.d.ts

@@ -0,0 +1,8 @@
+import { BasicRedactor } from "./basic-redactor.js";
+import type { RedactionResult } from "./index.js";
+export declare class EmailRedactor extends BasicRedactor {
+    private static readonly EMAIL_REGEX;
+    protected redact(value: string): RedactionResult<{
+        domains: Record<string, number>;
+    }>;
+}

package/dist/sdk-core/lib/redaction/email-redactor.js

@@ -0,0 +1,17 @@
+import { BasicRedactor } from "./basic-redactor.js";
+export class EmailRedactor extends BasicRedactor {
+    static EMAIL_REGEX = /[\p{L}\p{N}._%+-]+@((?:[\p{L}\p{N}-]+\.)+[\p{L}]{2,})/giu;
+    redact(value) {
+        const domains = {};
+        const redactedValue = value.replace(EmailRedactor.EMAIL_REGEX, (_, domain) => {
+            domains[domain] = (domains[domain] || 0) + 1;
+            return "[REDACTED EMAIL]";
+        });
+        return {
+            redactedValue: redactedValue,
+            context: {
+                domains,
+            },
+        };
+    }
+}

package/dist/sdk-core/lib/redaction/index.d.ts

@@ -0,0 +1,9 @@
+export interface RedactionResult<T extends Record<string, unknown>> {
+    redactedValue: string;
+    context: T;
+}
+export type StringKind = "string" | "url";
+export { BasicRedactor } from "./basic-redactor.js";
+export { EmailRedactor } from "./email-redactor.js";
+export { IpRedactor } from "./ip-redactor.js";
+export { PpsnRedactor } from "./ppsn-redactor.js";

package/dist/sdk-core/lib/redaction/index.js

@@ -0,0 +1,4 @@
+export { BasicRedactor } from "./basic-redactor.js";
+export { EmailRedactor } from "./email-redactor.js";
+export { IpRedactor } from "./ip-redactor.js";
+export { PpsnRedactor } from "./ppsn-redactor.js";

package/dist/sdk-core/lib/redaction/ip-redactor.d.ts

@@ -0,0 +1,9 @@
+import { BasicRedactor } from "./basic-redactor.js";
+import type { RedactionResult } from "./index.js";
+export declare class IpRedactor extends BasicRedactor {
+    private static readonly IPV4_REGEX;
+    private static readonly IPV6_REGEX;
+    protected redact(value: string): RedactionResult<{
+        counters: Record<string, number>;
+    }>;
+}

package/dist/sdk-core/lib/redaction/ip-redactor.js

@@ -0,0 +1,23 @@
+import { BasicRedactor } from "./basic-redactor.js";
+export class IpRedactor extends BasicRedactor {
+    static IPV4_REGEX = /(?<!\d)(?:%[0-9A-Fa-f]{2})?(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)(\.(25[0-5]|2[0-4][0-9]|[01]?[0-9][0-9]?)){3}(?:%[0-9A-Fa-f]{2})?(?!\d)/gi;
+    static IPV6_REGEX = /(?<![0-9a-f:])(?:%[0-9A-Fa-f]{2})?((?:[0-9A-Fa-f]{1,4}:){7}[0-9A-Fa-f]{1,4}|(?:[0-9A-Fa-f]{1,4}:){1,7}:|:(?::[0-9A-Fa-f]{1,4}){1,7}|(?:[0-9A-Fa-f]{1,4}:){1,6}:[0-9A-Fa-f]{1,4}|(?:[0-9A-Fa-f]{1,4}:){1,5}(?::[0-9A-Fa-f]{1,4}){1,2}|(?:[0-9A-Fa-f]{1,4}:){1,4}(?::[0-9A-Fa-f]{1,4}){1,3}|(?:[0-9A-Fa-f]{1,4}:){1,3}(?::[0-9A-Fa-f]{1,4}){1,4}|(?:[0-9A-Fa-f]{1,4}:){1,2}(?::[0-9A-Fa-f]{1,4}){1,5}|[0-9A-Fa-f]{1,4}:(?::[0-9A-Fa-f]{1,4}){1,6}|:(?::[0-9A-Fa-f]{1,4}){1,7}:?|(?:[0-9A-Fa-f]{1,4}:){1,4}:(?:25[0-5]|2[0-4]\d|1\d\d|\d{1,2})(?:\.(?:25[0-5]|2[0-4]\d|1\d\d|\d{1,2})){3})(?:%[0-9A-Fa-f]{2})?(?![0-9a-f:])/gi;
+    redact(value) {
+        const counters = {};
+        const redactedValue = value
+            .replace(IpRedactor.IPV4_REGEX, () => {
+            counters["IPv4"] = (counters["IPv4"] || 0) + 1;
+            return "[REDACTED IPV4]";
+        })
+            .replace(IpRedactor.IPV6_REGEX, () => {
+            counters["IPv6"] = (counters["IPv6"] || 0) + 1;
+            return "[REDACTED IPV6]";
+        });
+        return {
+            redactedValue: redactedValue,
+            context: {
+                counters,
+            },
+        };
+    }
+}

package/dist/sdk-core/lib/redaction/ppsn-redactor.d.ts

@@ -0,0 +1,8 @@
+import { BasicRedactor } from "./basic-redactor.js";
+import type { RedactionResult } from "./index.js";
+export declare class PpsnRedactor extends BasicRedactor {
+    private static readonly PPSN_REGEX;
+    protected redact(value: string): RedactionResult<{
+        redactedCounter: number;
+    }>;
+}

package/dist/sdk-core/lib/redaction/ppsn-redactor.js

@@ -0,0 +1,17 @@
+import { BasicRedactor } from "./basic-redactor.js";
+export class PpsnRedactor extends BasicRedactor {
+    static PPSN_REGEX = /(?<!([0-9]|[a-z]))[0-9]{7}[a-z]{1,2}(?!([0-9]|[a-z]))/gi;
+    redact(value) {
+        let redactedCounter = 0;
+        const redactedValue = value.replace(PpsnRedactor.PPSN_REGEX, (_) => {
+            redactedCounter++;
+            return "[REDACTED PPSN]";
+        });
+        return {
+            redactedValue: redactedValue,
+            context: {
+                redactedCounter,
+            },
+        };
+    }
+}

package/dist/sdk-core/lib/utils/data-structures.d.ts

@@ -0,0 +1,15 @@
+import type { AnyValue } from "@opentelemetry/api-logs";
+import { BasicRedactor } from "../redaction/index.js";
+/**
+ * Cleans a string by redacting configured PIIs and emitting metrics for redacted values.
+ *
+ * If the string is URL-encoded, it will be decoded before redaction.
+ *
+ * @param {string} value - The input value to sanitize.
+ * @param {string} source - The source context of the input, used in metrics.
+ * @param {BasicRedactor[]} redactors - The string redactors containing the redaction logic.
+ *
+ * @returns {string} The cleaned string with any configured PII replaced by `[REDACTED PII_TYPE]`.
+ */
+export declare function _cleanStringPII<T extends string>(value: string, source: T, redactors: BasicRedactor[]): string;
+export declare function _recursiveObjectClean<T extends AnyValue, R extends string>(value: T, source: R, redactors: BasicRedactor[]): T;

package/dist/{lib/internals/redaction/pii-detection.js → sdk-core/lib/utils/data-structures.js}

@@ -1,37 +1,14 @@
+import { _containsEncodedComponents } from "./string-decoding.js";
 const decoder = new TextDecoder();
 const encoder = new TextEncoder();
-/**
- * Checks whether a string contains URI-encoded components.
- *
- * @param {string} value - The string to inspect.
- * @returns {boolean} `true` if the string is encoded, `false` otherwise.
- */
-export function _containsEncodedComponents(value) {
-    try {
-        const decodedURIComponent = decodeURIComponent(value);
-        if (decodeURI(value) !== decodedURIComponent) {
-            return true;
-        }
-        if (value !== decodedURIComponent) {
-            return (encodeURIComponent(decodedURIComponent) === value ||
-                encodeURI(decodedURIComponent) === value);
-        }
-    }
-    catch {
-        return false;
-    }
-    return false;
-}
 /**
  * Cleans a string by redacting configured PIIs and emitting metrics for redacted values.
  *
  * If the string is URL-encoded, it will be decoded before redaction.
  *
- * @template T
- *
  * @param {string} value - The input value to sanitize.
- * @param {"trace" | "log"} source - The source context of the input, used in metrics.
- * @param {Redactor[]} redactors - The string processors containing the redaction logic.
+ * @param {string} source - The source context of the input, used in metrics.
+ * @param {BasicRedactor[]} redactors - The string redactors containing the redaction logic.
  *
  * @returns {string} The cleaned string with any configured PII replaced by `[REDACTED PII_TYPE]`.
  */
@@ -45,7 +22,7 @@ export function _cleanStringPII(value, source, redactors) {
         decodedValue = decodeURIComponent(value);
         kind = "url";
     }
-    return redactors.reduce((redactedValue, currentRedactor) => currentRedactor(redactedValue, source, kind), decodedValue);
+    return redactors.reduce((redactedValue, currentRedactor) => currentRedactor.process(redactedValue, source, kind), decodedValue);
 }
 export function _recursiveObjectClean(value, source, redactors) {
     if (typeof value === "string") {

package/dist/sdk-core/lib/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { _cleanStringPII, _recursiveObjectClean } from "./data-structures.js";
+export { _containsEncodedComponents } from "./string-decoding.js";

package/dist/sdk-core/lib/utils/index.js

@@ -0,0 +1,2 @@
+export { _cleanStringPII, _recursiveObjectClean } from "./data-structures.js";
+export { _containsEncodedComponents } from "./string-decoding.js";

package/dist/sdk-core/lib/utils/string-decoding.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks whether a string contains URI-encoded components.
+ *
+ * @param {string} value - The string to inspect.
+ * @returns {boolean} `true` if the string is encoded, `false` otherwise.
+ */
+export declare function _containsEncodedComponents(value: string): boolean;

package/dist/sdk-core/lib/utils/string-decoding.js

@@ -0,0 +1,22 @@
+/**
+ * Checks whether a string contains URI-encoded components.
+ *
+ * @param {string} value - The string to inspect.
+ * @returns {boolean} `true` if the string is encoded, `false` otherwise.
+ */
+export function _containsEncodedComponents(value) {
+    try {
+        const decodedURIComponent = decodeURIComponent(value);
+        if (decodeURI(value) !== decodedURIComponent) {
+            return true;
+        }
+        if (value !== decodedURIComponent) {
+            return (encodeURIComponent(decodedURIComponent) === value ||
+                encodeURI(decodedURIComponent) === value);
+        }
+    }
+    catch {
+        return false;
+    }
+    return false;
+}

package/dist/{index.d.ts → sdk-node/index.d.ts}

@@ -5,3 +5,4 @@ export type { NodeSDK };
 export { buildNodeInstrumentation as instrumentNode };
 export * from "./lib/metrics.js";
 export * from "./lib/traces.js";
+export * from "../sdk-core/index.js";

package/dist/{index.js → sdk-node/index.js}

@@ -2,3 +2,4 @@ import buildNodeInstrumentation from "./lib/instrumentation.node.js";
 export { buildNodeInstrumentation as instrumentNode };
 export * from "./lib/metrics.js";
 export * from "./lib/traces.js";
+export * from "../sdk-core/index.js";

package/dist/{lib → sdk-node/lib}/config-manager.d.ts

@@ -1,3 +1,3 @@
-import { NodeSDKConfig } from "./index.js";
+import type { NodeSDKConfig } from "./index.js";
 export declare const setNodeSdkConfig: (config: NodeSDKConfig) => void;
 export declare const getNodeSdkConfig: () => NodeSDKConfig | undefined;

package/dist/sdk-node/lib/exporter/console.d.ts

@@ -0,0 +1,3 @@
+import type { NodeSDKConfig } from "../index.js";
+import type { Exporters } from "./index.js";
+export default function buildConsoleExporters(config: NodeSDKConfig): Exporters;

package/dist/sdk-node/lib/exporter/grpc.d.ts

@@ -0,0 +1,3 @@
+import type { NodeSDKConfig } from "../index.js";
+import type { Exporters } from "./index.js";
+export default function buildGrpcExporters(config: NodeSDKConfig): Promise<Exporters>;

package/dist/sdk-node/lib/exporter/http.d.ts

@@ -0,0 +1,3 @@
+import type { NodeSDKConfig } from "../index.js";
+import type { Exporters } from "./index.js";
+export default function buildHttpExporters(config: NodeSDKConfig): Exporters;

package/dist/{lib → sdk-node/lib}/exporter/index.d.ts

@@ -1,6 +1,6 @@
-import { LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import type { LogRecordProcessor } from "@opentelemetry/sdk-logs";
 import type { metrics } from "@opentelemetry/sdk-node";
-import { SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { SpanProcessor } from "@opentelemetry/sdk-trace-base";
 export type Exporters = {
     spans: SpanProcessor[];
     metrics: metrics.MetricReader;

package/dist/{lib → sdk-node/lib}/exporter/pii-exporter-decorator.d.ts

@@ -1,9 +1,9 @@
-import { ExportResult } from "@opentelemetry/core";
+import type { ExportResult } from "@opentelemetry/core";
 import { OTLPExporterBase } from "@opentelemetry/otlp-exporter-base";
-import { ReadableLogRecord } from "@opentelemetry/sdk-logs";
-import { PushMetricExporter, ResourceMetrics } from "@opentelemetry/sdk-metrics";
-import { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
-import { NodeSDKConfig } from "../index.js";
+import type { ReadableLogRecord } from "@opentelemetry/sdk-logs";
+import type { PushMetricExporter, ResourceMetrics } from "@opentelemetry/sdk-metrics";
+import type { ReadableSpan, SpanExporter } from "@opentelemetry/sdk-trace-base";
+import type { NodeSDKConfig } from "../index.js";
 export declare class PIIExporterDecorator extends OTLPExporterBase<(ReadableSpan | ReadableLogRecord)[] | ResourceMetrics> implements SpanExporter, PushMetricExporter {
     private readonly _exporter;
     private readonly _config;

package/dist/{lib → sdk-node/lib}/exporter/pii-exporter-decorator.js

@@ -1,6 +1,6 @@
 import { OTLPExporterBase } from "@opentelemetry/otlp-exporter-base";
-import { _cleanStringPII, _recursiveObjectClean, } from "../internals/redaction/pii-detection.js";
 import { redactors, } from "../internals/redaction/redactors/index.js";
+import { _cleanStringPII, _recursiveObjectClean, BasicRedactor, } from "../../../sdk-core/index.js";
 export class PIIExporterDecorator extends OTLPExporterBase {
     _exporter;
     _config;
@@ -110,10 +110,14 @@ export class PIIExporterDecorator extends OTLPExporterBase {
     }
     // Default opt-in every redactor available, excluding only those explicitly configured to false
     _buildRedactors(redactorsConfig = {}) {
-        return Object.entries(redactors)
+        const defaultRedactors = Object.entries(redactors)
             .filter(([key]) => {
             return redactorsConfig[key] !== false;
         })
             .map(([_, value]) => value);
+        const customRedactors = redactorsConfig.custom?.length
+            ? (redactorsConfig.custom.filter((redactor) => redactor instanceof BasicRedactor) ?? [])
+            : [];
+        return [...defaultRedactors, ...customRedactors];
     }
 }

package/dist/sdk-node/lib/exporter/processor-config.d.ts

@@ -0,0 +1,7 @@
+import type { NodeSDKConfig } from "../index.js";
+import { EnrichLogProcessor } from "../processor/enrich-logger-processor.js";
+import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
+import { NextJsLogProcessor } from "../processor/nextjs-logger-processor.js";
+import { NextJsSpanProcessor } from "../processor/nextjs-span-processor.js";
+export declare function _spansProcessorConfig(config: NodeSDKConfig): (EnrichSpanProcessor | NextJsSpanProcessor)[];
+export declare function _logsProcessorConfig(config: NodeSDKConfig): (EnrichLogProcessor | NextJsLogProcessor)[];

package/dist/{lib → sdk-node/lib}/exporter/processor-config.js

@@ -1,7 +1,10 @@
 import { EnrichLogProcessor } from "../processor/enrich-logger-processor.js";
 import { EnrichSpanProcessor } from "../processor/enrich-span-processor.js";
+import { NextJsLogProcessor } from "../processor/nextjs-logger-processor.js";
+import { NextJsSpanProcessor } from "../processor/nextjs-span-processor.js";
 export function _spansProcessorConfig(config) {
     const _processor = [];
+    _processor.push(new NextJsSpanProcessor());
     if (config.spanAttributes) {
         _processor.push(new EnrichSpanProcessor(config.spanAttributes));
     }
@@ -9,6 +12,7 @@ export function _spansProcessorConfig(config) {
 }
 export function _logsProcessorConfig(config) {
     const _processor = [];
+    _processor.push(new NextJsLogProcessor());
     if (config.spanAttributes) {
         _processor.push(new EnrichLogProcessor(config.spanAttributes));
     }

package/dist/{lib → sdk-node/lib}/index.d.ts

@@ -1,4 +1,5 @@
 import type { Metadata } from "@grpc/grpc-js";
+import { BasicRedactor } from "../../sdk-core/lib/redaction/basic-redactor.js";
 export interface NodeSDKConfig {
     /**
      * The opentelemetry collector entrypoint GRPC url.
@@ -83,6 +84,16 @@ export interface NodeSDKConfig {
          * @default true
          */
         ip?: boolean;
+        /**
+         * Redact PPSN (Personal Public Service Number)
+         * @default true
+         */
+        ppsn?: boolean;
+        /**
+         * Custom redactors to be added together with the default ones
+         * @default []
+         */
+        custom?: BasicRedactor[];
     };
 }
 export interface SamplerCondition {

package/dist/{lib → sdk-node/lib}/instrumentation.node.js

@@ -56,7 +56,7 @@ export default async function buildNodeInstrumentation(config) {
             ],
             spanProcessors: exporter.spans,
             serviceName: config.serviceName,
-            metricReader: exporter.metrics,
+            metricReaders: [exporter.metrics],
             logRecordProcessors: exporter.logs,
             sampler: mainSampler,
             textMapPropagator: new W3CTraceContextPropagator(),

package/dist/sdk-node/lib/internals/redaction/redactors/email.d.ts

@@ -0,0 +1,8 @@
+import type { PIISource, RedactionMetric } from "./index.js";
+import type { Counter } from "@opentelemetry/api";
+import { EmailRedactor, type StringKind } from "../../../../../sdk-core/index.js";
+export declare class EmailRedactorWithMetrics extends EmailRedactor {
+    protected _counterRedactionMetric: Counter<RedactionMetric>;
+    constructor(metric: Counter<RedactionMetric>);
+    protected exportMetrics(context: ReturnType<typeof this.redact>["context"], source: PIISource, kind: StringKind): void;
+}

package/dist/sdk-node/lib/internals/redaction/redactors/email.js

@@ -0,0 +1,19 @@
+import { EmailRedactor, } from "../../../../../sdk-core/index.js";
+export class EmailRedactorWithMetrics extends EmailRedactor {
+    _counterRedactionMetric;
+    constructor(metric) {
+        super();
+        this._counterRedactionMetric = metric;
+    }
+    exportMetrics(context, source, kind) {
+        const { domains } = context;
+        for (const [domain, domainCount] of Object.entries(domains)) {
+            this._counterRedactionMetric.add(domainCount, {
+                pii_type: "email",
+                redaction_source: source,
+                pii_email_domain: domain,
+                pii_format: kind,
+            });
+        }
+    }
+}

package/dist/sdk-node/lib/internals/redaction/redactors/index.d.ts

@@ -0,0 +1,16 @@
+import type { NodeSDKConfig } from "../../../index.js";
+import type { Attributes } from "@opentelemetry/api";
+import { BasicRedactor } from "../../../../../sdk-core/index.js";
+export type PIISource = "trace" | "log" | "metric";
+export interface RedactionMetric extends Attributes {
+    /** Type of PII redacted (e.g., "email", "phone"). */
+    pii_type: string;
+    /** Domain part of the redacted PII (e.g., "gmail.com"). */
+    pii_email_domain?: string;
+    /** Source of the redaction (trace, log or metric). */
+    redaction_source: PIISource;
+    /** Format or structure of the redacted value. */
+    pii_format: "string" | "url";
+}
+export type RedactorKeys = keyof Omit<NonNullable<NodeSDKConfig["detection"]>, "custom">;
+export declare const redactors: Record<RedactorKeys, BasicRedactor>;

package/dist/sdk-node/lib/internals/redaction/redactors/index.js

@@ -0,0 +1,13 @@
+import { EmailRedactorWithMetrics } from "./email.js";
+import { IpRedactorWithMetrics } from "./ip.js";
+import { getMetric } from "../../../metrics.js";
+import { PpsnRedactorWithMetrics } from "./ppsn.js";
+const metricCounter = getMetric("counter", {
+    meterName: "o11y",
+    metricName: "o11y_pii_redaction",
+});
+export const redactors = {
+    email: new EmailRedactorWithMetrics(metricCounter),
+    ip: new IpRedactorWithMetrics(metricCounter),
+    ppsn: new PpsnRedactorWithMetrics(metricCounter),
+};

package/dist/sdk-node/lib/internals/redaction/redactors/ip.d.ts

@@ -0,0 +1,8 @@
+import type { Counter } from "@opentelemetry/api";
+import type { PIISource, RedactionMetric } from "./index.js";
+import { IpRedactor, type StringKind } from "../../../../../sdk-core/index.js";
+export declare class IpRedactorWithMetrics extends IpRedactor {
+    protected _counterRedactionMetric: Counter<RedactionMetric>;
+    constructor(metric: Counter<RedactionMetric>);
+    protected exportMetrics(context: ReturnType<typeof this.redact>["context"], source: PIISource, kind: StringKind): void;
+}

package/dist/sdk-node/lib/internals/redaction/redactors/ip.js

@@ -0,0 +1,20 @@
+import { IpRedactor } from "../../../../../sdk-core/index.js";
+export class IpRedactorWithMetrics extends IpRedactor {
+    _counterRedactionMetric;
+    constructor(metric) {
+        super();
+        this._counterRedactionMetric = metric;
+    }
+    exportMetrics(context, source, kind) {
+        const { counters } = context;
+        Object.entries(counters).forEach(([type, counter]) => {
+            if (counter > 0) {
+                this._counterRedactionMetric.add(counter, {
+                    pii_type: type,
+                    redaction_source: source,
+                    pii_format: kind,
+                });
+            }
+        });
+    }
+}

package/dist/sdk-node/lib/internals/redaction/redactors/ppsn.d.ts

@@ -0,0 +1,8 @@
+import type { PIISource, RedactionMetric } from "./index.js";
+import type { Counter } from "@opentelemetry/api";
+import { PpsnRedactor, type StringKind } from "../../../../../sdk-core/index.js";
+export declare class PpsnRedactorWithMetrics extends PpsnRedactor {
+    protected _counterRedactionMetric: Counter<RedactionMetric>;
+    constructor(metric: Counter<RedactionMetric>);
+    protected exportMetrics(context: ReturnType<typeof this.redact>["context"], source: PIISource, kind: StringKind): void;
+}

package/dist/sdk-node/lib/internals/redaction/redactors/ppsn.js

@@ -0,0 +1,18 @@
+import { PpsnRedactor, } from "../../../../../sdk-core/index.js";
+export class PpsnRedactorWithMetrics extends PpsnRedactor {
+    _counterRedactionMetric;
+    constructor(metric) {
+        super();
+        this._counterRedactionMetric = metric;
+    }
+    exportMetrics(context, source, kind) {
+        const { redactedCounter } = context;
+        if (redactedCounter === 0)
+            return;
+        this._counterRedactionMetric.add(redactedCounter, {
+            pii_type: "ppsn",
+            redaction_source: source,
+            pii_format: kind,
+        });
+    }
+}

package/dist/{lib → sdk-node/lib}/metrics.d.ts

@@ -1,4 +1,4 @@
-import { Counter, Gauge, Histogram, MetricOptions, ObservableCounter, ObservableGauge, ObservableUpDownCounter, UpDownCounter, Attributes } from "@opentelemetry/api";
+import { type Counter, type Gauge, type Histogram, type MetricOptions, type ObservableCounter, type ObservableGauge, type ObservableUpDownCounter, type UpDownCounter, type Attributes } from "@opentelemetry/api";
 type MetricTypeMap<TAttributes extends Attributes> = {
     counter: Counter<TAttributes>;
     histogram: Histogram<TAttributes>;

package/dist/{lib → sdk-node/lib}/processor/enrich-logger-processor.d.ts

@@ -1,6 +1,6 @@
-import { SdkLogRecord, LogRecordProcessor } from "@opentelemetry/sdk-logs";
-import { Context } from "@opentelemetry/api";
-import { SignalAttributeValue } from "../index.js";
+import type { SdkLogRecord, LogRecordProcessor } from "@opentelemetry/sdk-logs";
+import type { Context } from "@opentelemetry/api";
+import type { SignalAttributeValue } from "../index.js";
 export declare class EnrichLogProcessor implements LogRecordProcessor {
     private _spanAttributes?;
     constructor(spanAttributes?: Record<string, SignalAttributeValue | (() => SignalAttributeValue)>);

package/dist/{lib → sdk-node/lib}/processor/enrich-span-processor.d.ts

@@ -1,6 +1,6 @@
-import { Context } from "@opentelemetry/api";
-import { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
-import { SignalAttributeValue } from "../index.js";
+import type { Context } from "@opentelemetry/api";
+import type { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+import type { SignalAttributeValue } from "../index.js";
 export declare class EnrichSpanProcessor implements SpanProcessor {
     private _spanAttributes;
     constructor(spanAttributes?: Record<string, SignalAttributeValue | (() => SignalAttributeValue)>);

package/dist/sdk-node/lib/processor/nextjs-logger-processor.d.ts

@@ -0,0 +1,7 @@
+import { Context } from "@opentelemetry/api";
+import { LogRecordProcessor, SdkLogRecord } from "@opentelemetry/sdk-logs";
+export declare class NextJsLogProcessor implements LogRecordProcessor {
+    onEmit(logRecord: SdkLogRecord, _context?: Context): void;
+    shutdown(): Promise<void>;
+    forceFlush(): Promise<void>;
+}

package/dist/sdk-node/lib/processor/nextjs-logger-processor.js

@@ -0,0 +1,30 @@
+import { SeverityNumber } from "@opentelemetry/api-logs";
+export class NextJsLogProcessor {
+    onEmit(logRecord, _context) {
+        try {
+            if (typeof logRecord.body === "object" &&
+                logRecord.body !== null &&
+                "error" in logRecord.body) {
+                const error = logRecord.body.error;
+                if (error &&
+                    typeof error.digest === "string" &&
+                    error.digest.includes("NEXT_REDIRECT")) {
+                    logRecord.setBody({
+                        message: error.digest,
+                    });
+                    logRecord.setSeverityNumber(SeverityNumber.INFO);
+                    logRecord.setSeverityText("INFO");
+                }
+            }
+        }
+        catch (err) {
+            console.error("Error processing log record:", err);
+        }
+    }
+    shutdown() {
+        return Promise.resolve();
+    }
+    forceFlush() {
+        return Promise.resolve();
+    }
+}

package/dist/sdk-node/lib/processor/nextjs-span-processor.d.ts

@@ -0,0 +1,8 @@
+import { Context } from "@opentelemetry/api";
+import { ReadableSpan, Span, SpanProcessor } from "@opentelemetry/sdk-trace-base";
+export declare class NextJsSpanProcessor implements SpanProcessor {
+    forceFlush(): Promise<void>;
+    onStart(span: Span, _context: Context): void;
+    onEnd(_span: ReadableSpan): void;
+    shutdown(): Promise<void>;
+}