@turingpulse/sdk 1.0.1

package/dist/deploy.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Deploy tracking for change detection and root cause analysis.
+ */
+/**
+ * Information about a deployment.
+ */
+export interface DeployInfo {
+    /** CI/CD provider (github, gitlab, jenkins, etc.) */
+    provider: string;
+    /** Git commit SHA */
+    gitSha?: string;
+    /** Version tag or branch name */
+    versionTag?: string;
+    /** Commit message */
+    commitMessage?: string;
+    /** Deployment timestamp */
+    deployedAt?: Date;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Automatically detect deployment info from CI/CD environment variables.
+ *
+ * Supports:
+ * - GitHub Actions
+ * - GitLab CI
+ * - CircleCI
+ * - Jenkins
+ * - Azure DevOps
+ * - Bitbucket Pipelines
+ * - Travis CI
+ */
+export declare class AutoDeployDetector {
+    /**
+     * Detect deployment info from environment variables.
+     *
+     * @returns DeployInfo if running in a known CI/CD environment, undefined otherwise
+     */
+    static detect(): DeployInfo | undefined;
+}
+/**
+ * Options for registering a deploy.
+ */
+export interface RegisterDeployOptions {
+    /** The workflow ID this deployment affects */
+    workflowId: string;
+    /** Version tag (e.g., "v1.2.3") */
+    version?: string;
+    /** Git commit SHA */
+    gitSha?: string;
+    /** Git commit message */
+    commitMessage?: string;
+    /** Additional metadata */
+    metadata?: Record<string, unknown>;
+    /** Deployment timestamp (defaults to now) */
+    deployedAt?: Date;
+    /** If true, auto-detect from CI/CD environment variables */
+    autoDetect?: boolean;
+}
+/**
+ * Register a deployment event with TuringPulse.
+ *
+ * Call this from your CI/CD pipeline or application startup to track deployments.
+ * Deployment events are correlated with anomalies and drifts for root cause analysis.
+ *
+ * @param options - Deploy registration options
+ * @returns True if deploy was registered successfully, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { registerDeploy } from '@turingpulse/sdk';
+ *
+ * // Manual registration
+ * await registerDeploy({
+ *   workflowId: 'chat-assistant',
+ *   version: 'v1.2.3',
+ *   gitSha: process.env.GIT_SHA,
+ *   commitMessage: process.env.GIT_COMMIT_MSG,
+ * });
+ *
+ * // Auto-detect from CI/CD environment
+ * await registerDeploy({
+ *   workflowId: 'chat-assistant',
+ *   autoDetect: true,
+ * });
+ * ```
+ */
+export declare function registerDeploy(options: RegisterDeployOptions): Promise<boolean>;
+//# sourceMappingURL=deploy.d.ts.map

package/dist/deploy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../src/deploy.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2BAA2B;IAC3B,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAuFD;;;;;;;;;;;GAWG;AACH,qBAAa,kBAAkB;IAC7B;;;;OAIG;IACH,MAAM,CAAC,MAAM,IAAI,UAAU,GAAG,SAAS;CAkCxC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qBAAqB;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yBAAyB;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,6CAA6C;IAC7C,UAAU,CAAC,EAAE,IAAI,CAAC;IAClB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,OAAO,CAAC,CA8CrF"}

package/dist/deploy.js

@@ -0,0 +1,203 @@
+/**
+ * Deploy tracking for change detection and root cause analysis.
+ */
+import { getInstance } from './plugin';
+import { PluginNotInitializedError } from './errors';
+import { safeEnv, safeErrorMessage } from './utils';
+/**
+ * CI/CD provider detection and variable mapping.
+ */
+const PROVIDERS = {
+    github: {
+        detect: ['GITHUB_ACTIONS'],
+        sha: ['GITHUB_SHA'],
+        ref: ['GITHUB_REF', 'GITHUB_REF_NAME'],
+        message: ['GITHUB_EVENT_HEAD_COMMIT_MESSAGE'],
+        run_id: ['GITHUB_RUN_ID'],
+        workflow: ['GITHUB_WORKFLOW'],
+        actor: ['GITHUB_ACTOR'],
+    },
+    gitlab: {
+        detect: ['GITLAB_CI'],
+        sha: ['CI_COMMIT_SHA'],
+        ref: ['CI_COMMIT_REF_NAME', 'CI_COMMIT_TAG'],
+        message: ['CI_COMMIT_MESSAGE'],
+        pipeline_id: ['CI_PIPELINE_ID'],
+        job_name: ['CI_JOB_NAME'],
+        user: ['GITLAB_USER_LOGIN'],
+    },
+    circleci: {
+        detect: ['CIRCLECI'],
+        sha: ['CIRCLE_SHA1'],
+        ref: ['CIRCLE_TAG', 'CIRCLE_BRANCH'],
+        build_num: ['CIRCLE_BUILD_NUM'],
+        workflow_id: ['CIRCLE_WORKFLOW_ID'],
+        username: ['CIRCLE_USERNAME'],
+    },
+    jenkins: {
+        detect: ['JENKINS_URL', 'BUILD_NUMBER'],
+        sha: ['GIT_COMMIT'],
+        ref: ['GIT_BRANCH', 'BUILD_TAG'],
+        build_num: ['BUILD_NUMBER'],
+        job_name: ['JOB_NAME'],
+        user: ['BUILD_USER'],
+    },
+    azure: {
+        detect: ['TF_BUILD', 'AZURE_PIPELINES'],
+        sha: ['BUILD_SOURCEVERSION'],
+        ref: ['BUILD_SOURCEBRANCH', 'BUILD_SOURCEBRANCHNAME'],
+        build_id: ['BUILD_BUILDID'],
+        pipeline_name: ['BUILD_DEFINITIONNAME'],
+        requester: ['BUILD_REQUESTEDFOR'],
+    },
+    bitbucket: {
+        detect: ['BITBUCKET_PIPELINE_UUID'],
+        sha: ['BITBUCKET_COMMIT'],
+        ref: ['BITBUCKET_TAG', 'BITBUCKET_BRANCH'],
+        build_num: ['BITBUCKET_BUILD_NUMBER'],
+        pipeline_uuid: ['BITBUCKET_PIPELINE_UUID'],
+    },
+    travis: {
+        detect: ['TRAVIS'],
+        sha: ['TRAVIS_COMMIT'],
+        ref: ['TRAVIS_TAG', 'TRAVIS_BRANCH'],
+        message: ['TRAVIS_COMMIT_MESSAGE'],
+        build_id: ['TRAVIS_BUILD_ID'],
+        job_id: ['TRAVIS_JOB_ID'],
+    },
+};
+/**
+ * Get the first non-empty environment variable value.
+ */
+function getFirstEnv(envVars) {
+    for (const varName of envVars) {
+        const value = safeEnv(varName);
+        if (value) {
+            return value;
+        }
+    }
+    return undefined;
+}
+/**
+ * Automatically detect deployment info from CI/CD environment variables.
+ *
+ * Supports:
+ * - GitHub Actions
+ * - GitLab CI
+ * - CircleCI
+ * - Jenkins
+ * - Azure DevOps
+ * - Bitbucket Pipelines
+ * - Travis CI
+ */
+export class AutoDeployDetector {
+    /**
+     * Detect deployment info from environment variables.
+     *
+     * @returns DeployInfo if running in a known CI/CD environment, undefined otherwise
+     */
+    static detect() {
+        for (const [provider, config] of Object.entries(PROVIDERS)) {
+            const detectVars = config.detect || [];
+            if (!detectVars.every((v) => safeEnv(v))) {
+                continue;
+            }
+            const gitSha = getFirstEnv(config.sha || []);
+            const versionTag = getFirstEnv(config.ref || []);
+            const commitMessage = getFirstEnv(config.message || []);
+            const metadata = {};
+            for (const [key, envVars] of Object.entries(config)) {
+                if (['detect', 'sha', 'ref', 'message'].includes(key)) {
+                    continue;
+                }
+                const value = getFirstEnv(envVars || []);
+                if (value) {
+                    metadata[key] = value;
+                }
+            }
+            return {
+                provider,
+                gitSha,
+                versionTag,
+                commitMessage,
+                deployedAt: new Date(),
+                metadata: Object.keys(metadata).length > 0 ? metadata : undefined,
+            };
+        }
+        return undefined;
+    }
+}
+/**
+ * Register a deployment event with TuringPulse.
+ *
+ * Call this from your CI/CD pipeline or application startup to track deployments.
+ * Deployment events are correlated with anomalies and drifts for root cause analysis.
+ *
+ * @param options - Deploy registration options
+ * @returns True if deploy was registered successfully, false otherwise
+ *
+ * @example
+ * ```typescript
+ * import { registerDeploy } from '@turingpulse/sdk';
+ *
+ * // Manual registration
+ * await registerDeploy({
+ *   workflowId: 'chat-assistant',
+ *   version: 'v1.2.3',
+ *   gitSha: process.env.GIT_SHA,
+ *   commitMessage: process.env.GIT_COMMIT_MSG,
+ * });
+ *
+ * // Auto-detect from CI/CD environment
+ * await registerDeploy({
+ *   workflowId: 'chat-assistant',
+ *   autoDetect: true,
+ * });
+ * ```
+ */
+export async function registerDeploy(options) {
+    let { version, gitSha, commitMessage, metadata, deployedAt } = options;
+    const { workflowId, autoDetect = true } = options;
+    if (autoDetect) {
+        const detected = AutoDeployDetector.detect();
+        if (detected) {
+            gitSha = gitSha || detected.gitSha;
+            version = version || detected.versionTag;
+            commitMessage = commitMessage || detected.commitMessage;
+            deployedAt = deployedAt || detected.deployedAt;
+            if (detected.metadata) {
+                metadata = { ...(detected.metadata || {}), ...(metadata || {}) };
+            }
+        }
+    }
+    let plugin;
+    try {
+        plugin = getInstance();
+    }
+    catch (error) {
+        if (error instanceof PluginNotInitializedError) {
+            // eslint-disable-next-line no-console
+            console.warn('Cannot register deploy: TuringPulse plugin not initialized');
+            return false;
+        }
+        throw error;
+    }
+    const payload = {
+        workflow_id: workflowId,
+        version_tag: version,
+        git_sha: gitSha,
+        commit_message: commitMessage,
+        deployed_at: (deployedAt || new Date()).toISOString(),
+        metadata: metadata || {},
+    };
+    try {
+        const result = (await plugin.client.postDeploy(payload));
+        return result?.success ?? false;
+    }
+    catch (error) {
+        // eslint-disable-next-line no-console
+        console.warn('Failed to register deploy:', safeErrorMessage(error));
+        return false;
+    }
+}
+//# sourceMappingURL=deploy.js.map

package/dist/deploy.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,18 @@
+export declare class TuringPulsePluginError extends Error {
+    constructor(message: string);
+}
+export declare class PluginNotInitializedError extends TuringPulsePluginError {
+    constructor();
+}
+export declare class TriggerNotFoundError extends TuringPulsePluginError {
+    constructor(key: string);
+}
+export declare class GovernanceBlockedError extends TuringPulsePluginError {
+    readonly reason: string | undefined;
+    readonly policyIds: string[];
+    constructor(reason?: string, policyIds?: string[]);
+}
+export declare class ConfigurationError extends TuringPulsePluginError {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,yBAA0B,SAAQ,sBAAsB;;CAQpE;AAED,qBAAa,oBAAqB,SAAQ,sBAAsB;gBAClD,GAAG,EAAE,MAAM;CAIxB;AAED,qBAAa,sBAAuB,SAAQ,sBAAsB;IAChE,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;gBAEjB,MAAM,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE;CAQlD;AAED,qBAAa,kBAAmB,SAAQ,sBAAsB;gBAChD,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -0,0 +1,34 @@
+export class TuringPulsePluginError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TuringPulsePluginError';
+    }
+}
+export class PluginNotInitializedError extends TuringPulsePluginError {
+    constructor() {
+        super('TuringPulse plugin is not initialized. ' +
+            'Call init(...) once or set TP_API_KEY env var.');
+        this.name = 'PluginNotInitializedError';
+    }
+}
+export class TriggerNotFoundError extends TuringPulsePluginError {
+    constructor(key) {
+        super(`No trigger registered for key "${key}".`);
+        this.name = 'TriggerNotFoundError';
+    }
+}
+export class GovernanceBlockedError extends TuringPulsePluginError {
+    constructor(reason, policyIds) {
+        super(`Execution blocked by governance policy: ${reason ?? 'no reason provided'}`);
+        this.name = 'GovernanceBlockedError';
+        this.reason = reason;
+        this.policyIds = policyIds ?? [];
+    }
+}
+export class ConfigurationError extends TuringPulsePluginError {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigurationError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,MAAM,OAAO,yBAA0B,SAAQ,sBAAsB;IACnE;QACE,KAAK,CACH,yCAAyC;YACzC,gDAAgD,CACjD,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,sBAAsB;IAC9D,YAAY,GAAW;QACrB,KAAK,CAAC,kCAAkC,GAAG,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,sBAAsB;IAIhE,YAAY,MAAe,EAAE,SAAoB;QAC/C,KAAK,CACH,2CAA2C,MAAM,IAAI,oBAAoB,EAAE,CAC5E,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,EAAE,CAAC;IACnC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,sBAAsB;IAC5D,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}

package/dist/eventBuilder.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Event construction extracted from the plugin to satisfy SRP.
+ *
+ * EventBuilder handles AgentEvent assembly from ExecutionContext,
+ * including metadata, tokens, tool calls, and KPI results.
+ */
+import type { AgentEvent } from '@turingpulse/interfaces';
+import { TuringPulseConfig } from './config';
+import { ExecutionContext } from './context';
+import { InstrumentationOptions } from './instrumentation';
+import { KPIResult } from './kpi';
+export declare class EventBuilder {
+    private readonly config;
+    private readonly redactFieldNames;
+    constructor(config: TuringPulseConfig);
+    build(context: ExecutionContext, options: InstrumentationOptions, kpiResults: KPIResult[]): AgentEvent;
+    private assembleMetadata;
+    private applyRedaction;
+    private redactValue;
+}
+//# sourceMappingURL=eventBuilder.d.ts.map

package/dist/eventBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventBuilder.d.ts","sourceRoot":"","sources":["../src/eventBuilder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAE1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAe,MAAM,OAAO,CAAC;AAI/C,qBAAa,YAAY;IAGX,OAAO,CAAC,QAAQ,CAAC,MAAM;IAFnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAc;gBAElB,MAAM,EAAE,iBAAiB;IAMtD,KAAK,CACH,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,sBAAsB,EAC/B,UAAU,EAAE,SAAS,EAAE,GACtB,UAAU;IAsBb,OAAO,CAAC,gBAAgB;IA2ExB,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,WAAW;CAgBpB"}

package/dist/eventBuilder.js

@@ -0,0 +1,127 @@
+/**
+ * Event construction extracted from the plugin to satisfy SRP.
+ *
+ * EventBuilder handles AgentEvent assembly from ExecutionContext,
+ * including metadata, tokens, tool calls, and KPI results.
+ */
+import { kpiMetadata } from './kpi';
+const MAX_FIELD_SIZE = 500000;
+export class EventBuilder {
+    constructor(config) {
+        this.config = config;
+        this.redactFieldNames = new Set((config.redactFields ?? []).map((f) => f.toLowerCase()));
+    }
+    build(context, options, kpiResults) {
+        const metadata = this.assembleMetadata(context, options, kpiResults);
+        return {
+            runId: context.runId,
+            agentId: context.agentId,
+            timestamp: (context.completedAt ?? context.startedAt).toISOString(),
+            type: 'agent_step',
+            payload: {
+                name: context.operation,
+                durationMs: context.durationMs,
+                status: context.status,
+                metadata,
+                tokens: context.tokensInput > 0 || context.tokensOutput > 0
+                    ? { prompt: context.tokensInput, completion: context.tokensOutput }
+                    : undefined,
+                costUsd: context.costUsd > 0 ? context.costUsd : undefined,
+            },
+        };
+    }
+    assembleMetadata(context, options, kpiResults) {
+        const metadata = {
+            ...Object.fromEntries(Object.entries(context.labels).map(([k, v]) => [k, String(v)])),
+            ...Object.fromEntries(Object.entries(context.metadata).map(([k, v]) => [k, String(v)])),
+            'agent.status': context.status,
+            'agent.hidden_entrypoint': String(context.hiddenEntrypoint),
+            'agent.run_id': context.runId,
+            'agent.operation': context.operation,
+            span_id: context.spanId,
+            depth: String(context.depth),
+        };
+        if (context.parentSpanId)
+            metadata['parent_span_id'] = context.parentSpanId;
+        if (context.model)
+            metadata['model'] = context.model;
+        if (context.provider)
+            metadata['provider'] = context.provider;
+        if (context.nodeType)
+            metadata['node_type'] = context.nodeType;
+        if (context.framework)
+            metadata['framework'] = context.framework;
+        if (context.promptText)
+            metadata['prompt'] = context.promptText.slice(0, MAX_FIELD_SIZE);
+        if (context.systemPrompt)
+            metadata['system_prompt'] = context.systemPrompt.slice(0, MAX_FIELD_SIZE);
+        if (context.inputData)
+            metadata['input'] = context.inputData.slice(0, MAX_FIELD_SIZE);
+        if (context.outputData)
+            metadata['output'] = context.outputData.slice(0, MAX_FIELD_SIZE);
+        if (context.availableTools?.length) {
+            metadata['available_tools'] = JSON.stringify(context.availableTools);
+        }
+        if (context.workflowName)
+            metadata['workflow_name'] = context.workflowName;
+        if (context.triggerKey)
+            metadata['agent.trigger_key'] = context.triggerKey;
+        if (context.error instanceof Error) {
+            metadata['error.type'] = context.error.name;
+            metadata['error.message'] = context.error.message;
+        }
+        if (options.governance) {
+            metadata['governance.hitl'] = String(options.governance.hitl);
+            metadata['governance.hatl'] = String(options.governance.hatl);
+            metadata['governance.hotl'] = String(options.governance.hotl);
+        }
+        for (const result of kpiResults) {
+            Object.assign(metadata, kpiMetadata(result));
+        }
+        if (context.attachments.length > 0) {
+            metadata['attachments'] = JSON.stringify(context.attachments);
+        }
+        if (context.inputContext) {
+            metadata['input_context'] = context.inputContext.slice(0, MAX_FIELD_SIZE);
+        }
+        if (context.toolCalls.length > 0) {
+            metadata['tool_calls'] = JSON.stringify(context.toolCalls.map((tc) => ({
+                tool_name: tc.toolName,
+                tool_args: this.redactValue(tc.toolArgs),
+                tool_result: tc.toolResult ?? '',
+                tool_id: tc.toolId ?? '',
+                success: tc.success,
+                error_message: tc.errorMessage,
+            })));
+        }
+        this.applyRedaction(metadata);
+        return metadata;
+    }
+    applyRedaction(metadata) {
+        if (this.redactFieldNames.size === 0)
+            return;
+        for (const key of Object.keys(metadata)) {
+            if (this.redactFieldNames.has(key.toLowerCase())) {
+                metadata[key] = '[REDACTED]';
+            }
+        }
+    }
+    redactValue(value, depth = 0) {
+        if (depth > 20 || this.redactFieldNames.size === 0)
+            return value;
+        if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+            const result = {};
+            for (const [k, v] of Object.entries(value)) {
+                result[k] = this.redactFieldNames.has(k.toLowerCase())
+                    ? '[REDACTED]'
+                    : this.redactValue(v, depth + 1);
+            }
+            return result;
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.redactValue(item, depth + 1));
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=eventBuilder.js.map

package/dist/eventBuilder.js.map

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