@friskai/frisk-js 0.1.0

package/dist/logging/console-logger.d.ts

@@ -0,0 +1,3 @@
+import { LogLevel, SDKLogger } from './types';
+export declare function consoleLogger(level?: LogLevel, bindings?: Record<string, unknown>): SDKLogger;
+//# sourceMappingURL=console-logger.d.ts.map

package/dist/logging/console-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-logger.d.ts","sourceRoot":"","sources":["../../src/logging/console-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AA0D7C,wBAAgB,aAAa,CAC3B,KAAK,GAAE,QAAiB,EACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,SAAS,CAyCX"}

package/dist/logging/create-scoped-logger.d.ts

@@ -0,0 +1,6 @@
+import { SDKLogger } from './index';
+export type Meta = Record<string, unknown>;
+export declare function createScopedLogger(base: SDKLogger, bindings: Meta): SDKLogger & {
+    scope: (more: Meta) => ReturnType<typeof createScopedLogger>;
+};
+//# sourceMappingURL=create-scoped-logger.d.ts.map

package/dist/logging/create-scoped-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-scoped-logger.d.ts","sourceRoot":"","sources":["../../src/logging/create-scoped-logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC,MAAM,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAa1C,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,SAAS,EACf,QAAQ,EAAE,IAAI,GACb,SAAS,GAAG;IACb,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,UAAU,CAAC,OAAO,kBAAkB,CAAC,CAAA;CAC7D,CA+BA"}

package/dist/logging/derive-sdk-logger.d.ts

@@ -0,0 +1,6 @@
+import { LogLevel, SDKLogger } from './types';
+export declare function deriveSdkLogger(options?: {
+    logger?: any;
+    logLevel?: LogLevel;
+}, bindings?: Record<string, unknown>): SDKLogger;
+//# sourceMappingURL=derive-sdk-logger.d.ts.map

package/dist/logging/derive-sdk-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-sdk-logger.d.ts","sourceRoot":"","sources":["../../src/logging/derive-sdk-logger.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAE7C,wBAAgB,eAAe,CAC7B,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,GAAG,CAAA;IACZ,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACf,EACN,QAAQ,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACrC,SAAS,CA4BX"}

package/dist/logging/index.d.ts

@@ -0,0 +1,4 @@
+export { deriveSdkLogger } from './derive-sdk-logger';
+export { logError } from './log-error';
+export { FriskSDKLogOptions, LogLevel, SDKLogger } from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AACtC,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA"}

package/dist/logging/log-error.d.ts

@@ -0,0 +1,3 @@
+import { SDKLogger } from './types';
+export declare function logError(logger: SDKLogger | undefined, message: string, error?: unknown, meta?: Record<string, unknown>): void;
+//# sourceMappingURL=log-error.d.ts.map

package/dist/logging/log-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-error.d.ts","sourceRoot":"","sources":["../../src/logging/log-error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,GAAG,SAAS,EAC7B,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,OAAO,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAc/B"}

package/dist/logging/types.d.ts

@@ -0,0 +1,14 @@
+export type LogLevel = 'silent' | 'error' | 'warn' | 'info' | 'debug' | 'trace';
+export interface SDKLogger {
+    trace?: (...args: any[]) => void;
+    debug?: (...args: any[]) => void;
+    info?: (...args: any[]) => void;
+    warn?: (...args: any[]) => void;
+    error?: (...args: any[]) => void;
+    child?: (bindings: Record<string, unknown>) => SDKLogger;
+}
+export type FriskSDKLogOptions = {
+    logger?: SDKLogger;
+    logLevel?: LogLevel;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/logging/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/logging/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAA;AAE/E,MAAM,WAAW,SAAS;IACxB,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAChC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAChC,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC/B,IAAI,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAC/B,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,IAAI,CAAA;IAGhC,KAAK,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,SAAS,CAAA;CACzD;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,QAAQ,CAAC,EAAE,QAAQ,CAAA;CACpB,CAAA"}

package/dist/native-bindings/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @friskai/frisk-js Native Bindings
+ *
+ * This module encapsulates all access to the native N-API bindings.
+ * Other modules in the SDK should import from here rather than
+ * directly accessing the native/ folder.
+ *
+ * @internal
+ */
+export declare const nativeBindings: any;
+import type { JsProcessToolCallOptions, JsProcessToolCallResult, FriskHandle as NativeFriskHandleClass, RedactionResult, redactDictionary as redactDictionaryFn } from '../../native';
+export declare const FriskHandle: typeof NativeFriskHandleClass;
+export declare const redactDictionary: typeof redactDictionaryFn;
+export type { JsProcessToolCallOptions as NativeProcessToolCallOptions };
+export type { JsProcessToolCallResult as NativeProcessToolCallResult };
+export type { RedactionResult as NativeRedactionResult };
+export type FriskHandleInstance = InstanceType<typeof NativeFriskHandleClass>;
+//# sourceMappingURL=index.d.ts.map

package/dist/native-bindings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/native-bindings/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH,eAAO,MAAM,cAAc,KAA+B,CAAA;AAG1D,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,WAAW,IAAI,sBAAsB,EACrC,eAAe,EACf,gBAAgB,IAAI,kBAAkB,EACvC,MAAM,cAAc,CAAA;AAGrB,eAAO,MAAM,WAAW,EAAE,OAAO,sBACL,CAAA;AAC5B,eAAO,MAAM,gBAAgB,EAAE,OAAO,kBACL,CAAA;AAGjC,YAAY,EAAE,wBAAwB,IAAI,4BAA4B,EAAE,CAAA;AACxE,YAAY,EAAE,uBAAuB,IAAI,2BAA2B,EAAE,CAAA;AACtE,YAAY,EAAE,eAAe,IAAI,qBAAqB,EAAE,CAAA;AAGxD,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,OAAO,sBAAsB,CAAC,CAAA"}

package/dist/telemetry/constants.d.ts

@@ -0,0 +1,6 @@
+export declare const SPAN_NAME_PROCESS_TOOL_CALL = "process_tool_call";
+export declare const SPAN_NAME_FRISK_SESSION = "frisk_session";
+export declare const TRACER_NAME = "frisk_js_sdk";
+export declare const TRACER_VERSION = "0.1.0";
+export declare const SPAN_ATTRIBUTE_LLM_REASONING = "llm_reasoning";
+//# sourceMappingURL=constants.d.ts.map

package/dist/telemetry/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/telemetry/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,sBAAsB,CAAA;AAC9D,eAAO,MAAM,uBAAuB,kBAAkB,CAAA;AACtD,eAAO,MAAM,WAAW,iBAAiB,CAAA;AACzC,eAAO,MAAM,cAAc,UAAU,CAAA;AACrC,eAAO,MAAM,4BAA4B,kBAAkB,CAAA"}

package/dist/telemetry/dynamic-auth-metadata.d.ts

@@ -0,0 +1,50 @@
+import type { OutgoingHttpHeaders } from 'node:http2';
+import { Metadata } from '@grpc/grpc-js';
+/**
+ * Token provider function type that returns the current auth token
+ */
+export type TokenProvider = () => string;
+/**
+ * A Metadata subclass that dynamically injects the authorization header
+ * when the metadata is accessed. This allows token rotation without
+ * recreating the exporter.
+ *
+ * IMPORTANT: The OpenTelemetry OTLP gRPC exporter caches the Metadata object
+ * after the first call to metadata(). To support token rotation, this class
+ * updates its internal state (via the inherited `set()` method) whenever
+ * any accessor method is called, ensuring the authorization header always
+ * contains the latest token.
+ *
+ * The gRPC library internally accesses metadata via methods like get(), getMap(),
+ * clone(), etc. We override all of these to first refresh the token.
+ */
+export declare class DynamicAuthMetadata extends Metadata {
+    private tokenProvider;
+    constructor(tokenProvider: TokenProvider);
+    /**
+     * Update the internal authorization header with the latest token.
+     * This mutates the Metadata object in place.
+     */
+    private refreshToken;
+    /**
+     * Override get() to refresh token before returning values.
+     */
+    get(key: string): (string | Buffer)[];
+    /**
+     * Override getMap() to refresh token before returning the map.
+     */
+    getMap(): {
+        [key: string]: string | Buffer;
+    };
+    /**
+     * Override clone() to refresh token before cloning.
+     * The cloned Metadata will have the current token value.
+     */
+    clone(): Metadata;
+    /**
+     * Override toHttp2Headers() which is used by gRPC when sending requests.
+     * This ensures the token is refreshed right before the RPC is made.
+     */
+    toHttp2Headers(): OutgoingHttpHeaders;
+}
+//# sourceMappingURL=dynamic-auth-metadata.d.ts.map

package/dist/telemetry/dynamic-auth-metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamic-auth-metadata.d.ts","sourceRoot":"","sources":["../../src/telemetry/dynamic-auth-metadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,MAAM,CAAA;AAExC;;;;;;;;;;;;;GAaG;AACH,qBAAa,mBAAoB,SAAQ,QAAQ;IAC/C,OAAO,CAAC,aAAa,CAAe;gBAExB,aAAa,EAAE,aAAa;IAOxC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACM,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE;IAK9C;;OAEG;IACM,MAAM,IAAI;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;KAAE;IAKrD;;;OAGG;IACM,KAAK,IAAI,QAAQ;IAK1B;;;OAGG;IACM,cAAc,IAAI,mBAAmB;CAI/C"}

package/dist/telemetry/get-otel-sdk.d.ts

@@ -0,0 +1,18 @@
+export declare class TracerHandle {
+    private telemetryEndpoint;
+    private tracerProvider;
+    private authToken;
+    private tracerName;
+    private tracerVersion;
+    constructor({ telemetryEndpoint, authToken, tracerName, tracerVersion, }: {
+        telemetryEndpoint: string;
+        authToken: string;
+        tracerName: string;
+        tracerVersion: string;
+    });
+    shutdown(): Promise<void>;
+    getTracer(): import("@opentelemetry/api").Tracer;
+    updateAuthToken(token: string): void;
+    private getTracerProvider;
+}
+//# sourceMappingURL=get-otel-sdk.d.ts.map

package/dist/telemetry/get-otel-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-otel-sdk.d.ts","sourceRoot":"","sources":["../../src/telemetry/get-otel-sdk.ts"],"names":[],"mappings":"AAUA,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAQ;gBAEV,EACjB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,aAAa,GACd,EAAE;QACD,iBAAiB,EAAE,MAAM,CAAA;QACzB,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;KACtB;IAQY,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,SAAS;IAIT,eAAe,CAAC,KAAK,EAAE,MAAM;IAIpC,OAAO,CAAC,iBAAiB;CA8B1B"}

package/dist/telemetry/get-tracer.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @friskai/frisk-js Telemetry - Tracer
+ *
+ * Provides OpenTelemetry tracer for the Frisk SDK.
+ */
+import { type Tracer } from '@opentelemetry/api';
+/**
+ * Get the OpenTelemetry tracer for the Frisk SDK.
+ *
+ * This creates a tracer using the global tracer provider.
+ *
+ * @returns The OpenTelemetry Tracer instance
+ */
+export declare function getTracer(): Tracer;
+//# sourceMappingURL=get-tracer.d.ts.map

package/dist/telemetry/get-tracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-tracer.d.ts","sourceRoot":"","sources":["../../src/telemetry/get-tracer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,MAAM,EAAS,MAAM,oBAAoB,CAAA;AAGvD;;;;;;GAMG;AACH,wBAAgB,SAAS,IAAI,MAAM,CAElC"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @friskai/frisk-js Telemetry Module
+ *
+ * OpenTelemetry utilities for distributed tracing.
+ */
+export * from './constants';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAA"}

package/dist/telemetry/mocks/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Mock telemetry utilities for unit tests
+ */
+export { createMockSpan, createMockTracer, getMockTracerInstance, resetMockTracer, setMockTracerInstance, } from './mockTracer';
+export { createMockTracerHandle, injectMockTracerHandle, type MockTracerHandle, } from './mockTracerHandle';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/mocks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/telemetry/mocks/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,qBAAqB,EACrB,eAAe,EACf,qBAAqB,GACtB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,oBAAoB,CAAA"}

package/dist/telemetry/mocks/mockTracer.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Mock tracer for unit tests
+ *
+ * Provides a mock implementation of OpenTelemetry Tracer for testing
+ * FriskSession and ToolCallSpan without real telemetry infrastructure.
+ */
+import type { Span, Tracer } from '@opentelemetry/api';
+/**
+ * Creates a mock Span that records calls for testing assertions
+ */
+export declare function createMockSpan(): Span & {
+    _attributes: Record<string, unknown>;
+    _events: Array<{
+        name: string;
+        attributes?: Record<string, unknown>;
+    }>;
+    _ended: boolean;
+};
+/**
+ * Creates a mock Tracer that returns mock spans
+ */
+export declare function createMockTracer(): Tracer & {
+    _spans: Array<ReturnType<typeof createMockSpan>>;
+    _lastSpan: ReturnType<typeof createMockSpan> | null;
+};
+/**
+ * Get the current mock tracer instance (useful for test assertions)
+ */
+export declare function getMockTracerInstance(): ReturnType<typeof createMockTracer> | null;
+/**
+ * Set a custom mock tracer instance
+ */
+export declare function setMockTracerInstance(tracer: ReturnType<typeof createMockTracer>): void;
+/**
+ * Reset the mock tracer instance
+ */
+export declare function resetMockTracer(): void;
+//# sourceMappingURL=mockTracer.d.ts.map

package/dist/telemetry/mocks/mockTracer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockTracer.d.ts","sourceRoot":"","sources":["../../../src/telemetry/mocks/mockTracer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAEV,IAAI,EAGJ,MAAM,EACP,MAAM,oBAAoB,CAAA;AAI3B;;GAEG;AACH,wBAAgB,cAAc,IAAI,IAAI,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACpC,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAAA;IACtE,MAAM,EAAE,OAAO,CAAA;CAChB,CA4DA;AAKD;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,GAAG;IAC3C,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC,CAAA;IAChD,SAAS,EAAE,UAAU,CAAC,OAAO,cAAc,CAAC,GAAG,IAAI,CAAA;CACpD,CAkDA;AAID;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,UAAU,CACjD,OAAO,gBAAgB,CACxB,GAAG,IAAI,CAEP;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAC1C,IAAI,CAEN;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,IAAI,CAEtC"}

package/dist/telemetry/mocks/mockTracerHandle.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Mock TracerHandle for unit tests
+ *
+ * Provides a mock implementation of TracerHandle for testing
+ * without real telemetry infrastructure.
+ */
+import { vi } from 'vitest';
+import { createMockTracer } from './mockTracer';
+export type MockTracerHandle = {
+    getTracer: ReturnType<typeof vi.fn>;
+    updateAuthToken: ReturnType<typeof vi.fn>;
+    shutdown: ReturnType<typeof vi.fn>;
+    _mockTracer: ReturnType<typeof createMockTracer>;
+};
+/**
+ * Creates a mock TracerHandle that returns a mock tracer
+ *
+ * @param mockTracer - Optional pre-created mock tracer to use. If not provided, a new one will be created.
+ * @returns A mock TracerHandle instance
+ *
+ * @example
+ * ```typescript
+ * const mockTracerHandle = createMockTracerHandle()
+ * // Set it on a frisk instance
+ * ;(frisk as any)._tracerHandle = mockTracerHandle
+ *
+ * // Access the mock tracer for assertions
+ * const mockTracer = mockTracerHandle._mockTracer
+ * expect(mockTracer.startSpan).toHaveBeenCalled()
+ * ```
+ */
+export declare function createMockTracerHandle(mockTracer?: ReturnType<typeof createMockTracer>): MockTracerHandle;
+/**
+ * Injects a mock TracerHandle into a Frisk instance for testing
+ *
+ * This is a convenience function that creates a mock TracerHandle
+ * and sets it on the Frisk instance's private `_tracerHandle` property.
+ *
+ * @param frisk - The Frisk instance to inject the mock into
+ * @param mockTracer - Optional pre-created mock tracer to use
+ * @returns The created MockTracerHandle for assertions
+ *
+ * @example
+ * ```typescript
+ * const frisk = new Frisk({ apiKey: 'test-key', ... })
+ * const mockTracerHandle = injectMockTracerHandle(frisk)
+ *
+ * // Now frisk.tracerHandle.getTracer() returns a mock tracer
+ * const session = frisk.createSession()
+ *
+ * // Assert on the mock tracer
+ * expect(mockTracerHandle._mockTracer.startSpan).toHaveBeenCalled()
+ * ```
+ */
+export declare function injectMockTracerHandle(frisk: any, mockTracer?: ReturnType<typeof createMockTracer>): MockTracerHandle;
+//# sourceMappingURL=mockTracerHandle.d.ts.map

package/dist/telemetry/mocks/mockTracerHandle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mockTracerHandle.d.ts","sourceRoot":"","sources":["../../../src/telemetry/mocks/mockTracerHandle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;IACnC,eAAe,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;IACzC,QAAQ,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC,CAAA;IAClC,WAAW,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAA;CACjD,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAC/C,gBAAgB,CASlB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,sBAAsB,CAEpC,KAAK,EAAE,GAAG,EACV,UAAU,CAAC,EAAE,UAAU,CAAC,OAAO,gBAAgB,CAAC,GAC/C,gBAAgB,CAIlB"}

package/dist/telemetry/tracer-handle.d.ts

@@ -0,0 +1,18 @@
+export declare class TracerHandle {
+    private telemetryEndpoint;
+    private tracerProvider;
+    private authToken;
+    private tracerName;
+    private tracerVersion;
+    constructor({ telemetryEndpoint, authToken, tracerName, tracerVersion, }: {
+        telemetryEndpoint: string;
+        authToken: string;
+        tracerName: string;
+        tracerVersion: string;
+    });
+    shutdown(): Promise<void>;
+    getTracer(): import("@opentelemetry/api").Tracer;
+    updateAuthToken(token: string): void;
+    private getTracerProvider;
+}
+//# sourceMappingURL=tracer-handle.d.ts.map

package/dist/telemetry/tracer-handle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracer-handle.d.ts","sourceRoot":"","sources":["../../src/telemetry/tracer-handle.ts"],"names":[],"mappings":"AAaA,qBAAa,YAAY;IACvB,OAAO,CAAC,iBAAiB,CAAQ;IACjC,OAAO,CAAC,cAAc,CAAoB;IAC1C,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;IAC1B,OAAO,CAAC,aAAa,CAAQ;gBAEV,EACjB,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,aAAa,GACd,EAAE;QACD,iBAAiB,EAAE,MAAM,CAAA;QACzB,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,CAAA;KACtB;IAQY,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,SAAS;IAIT,eAAe,CAAC,KAAK,EAAE,MAAM;IAIpC,OAAO,CAAC,iBAAiB;CA6B1B"}

package/dist/utils/redact.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @friskai/frisk-js Redaction Types
+ *
+ * Types for data redaction functionality.
+ */
+/**
+ * Redaction option - can be:
+ * - `true` to redact all fields
+ * - `false` to redact nothing
+ * - An array of field names/paths to selectively redact
+ */
+export type RedactOption = boolean | string[];
+/**
+ * Result of a dictionary redaction operation
+ */
+export interface RedactedDictionary {
+    /**
+     * The redacted dictionary value
+     */
+    value: Record<string, unknown>;
+    /**
+     * Paths that were redacted (e.g., ["password", "user.ssn"])
+     */
+    redactedPaths: string[];
+}
+/**
+ * Result of a serialized object redaction operation
+ */
+export interface RedactedSerializedObject {
+    /**
+     * The serialized (JSON string) value, or null if input was null
+     */
+    value: string | null;
+    /**
+     * Paths that were redacted
+     */
+    redactedPaths: string[];
+}
+/**
+ * Combine multiple redact options into one
+ *
+ * @param options - Array of redact options to combine
+ * @returns Combined redact option
+ */
+export declare function combineRedactOptions(...options: (RedactOption | null | undefined)[]): RedactOption;
+/**
+ * Redact fields from a dictionary based on the redact option
+ *
+ * This is a simple implementation that removes redacted fields from an object".
+ * For more complex redaction, use the native `redactDictionary` function.
+ *
+ * @param data - The dictionary to redact
+ * @param redactOption - The redaction configuration
+ * @returns The redacted dictionary with paths that were redacted
+ */
+export declare function redactDictionarySimple(data: Record<string, unknown>, redactOption?: RedactOption): RedactedDictionary;
+//# sourceMappingURL=redact.d.ts.map

package/dist/utils/redact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redact.d.ts","sourceRoot":"","sources":["../../src/utils/redact.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,EAAE,CAAA;AAE7C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAE9B;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IAEpB;;OAEG;IACH,aAAa,EAAE,MAAM,EAAE,CAAA;CACxB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,OAAO,EAAE,CAAC,YAAY,GAAG,IAAI,GAAG,SAAS,CAAC,EAAE,GAC9C,YAAY,CAuBd;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,YAAY,CAAC,EAAE,YAAY,GAC1B,kBAAkB,CAyBpB"}

package/native/.gitnore.bak

@@ -0,0 +1 @@
+*.node

package/native/README.md

@@ -0,0 +1,55 @@
+# Native Bindings
+
+This folder contains the native N-API bindings for the `@friskai/frisk-js` package.
+
+## Contents
+
+| File | Description | Git Status |
+|------|-------------|------------|
+| `index.cjs` | Platform loader that detects the OS/architecture and loads the correct `.node` binary | ✅ Tracked |
+| `index.d.ts` | TypeScript type definitions for the native bindings | ✅ Tracked |
+| `*.node` | Native binary files (e.g., `frisk-js.darwin-arm64.node`) | ❌ Ignored |
+
+## Why are `index.cjs` and `index.d.ts` committed?
+
+These files are **auto-generated** by [napi-rs](https://napi.rs/) during the Rust build process (`npm run build:rust`), but they are committed to source control for the following reasons:
+
+1. **IDE Support**: The type definitions (`index.d.ts`) enable TypeScript IntelliSense and type checking without requiring a native build.
+
+2. **CI/CD Verification**: Type checking can be performed in CI environments that may not have Rust toolchain installed.
+
+3. **Stability**: These files only change when the Rust API changes, making them safe to commit.
+
+4. **Standard Practice**: This is the recommended approach for napi-rs projects (see [@napi-rs/canvas](https://github.com/nicolebienz/canvas), [@swc/core](https://github.com/swc-project/swc), etc.).
+
+## Why is `index.cjs` instead of `index.js`?
+
+The parent package uses `"type": "module"` in `package.json`, which means all `.js` files are treated as ES Modules. The napi-rs loader uses CommonJS syntax (`require`, `module.exports`), so we rename it to `.cjs` to ensure Node.js loads it correctly.
+
+## Why are `.node` files ignored?
+
+The `.node` files are platform-specific native binaries compiled from Rust. They are:
+
+- **Large**: Binary files bloat the repository
+- **Platform-specific**: Only the binary for the current platform is needed
+- **Build artifacts**: Regenerated on every `npm run build:rust`
+
+## Build Process
+
+The `npm run build:rust` command:
+
+1. Compiles Rust code to a native `.node` binary
+2. Generates `index.js` (platform loader) and `index.d.ts` (type definitions)
+3. Renames `index.js` to `index.cjs` for ESM compatibility
+
+```bash
+# Build native bindings
+npm run build:rust
+
+# Build TypeScript SDK
+npm run build:ts
+
+# Build everything
+npm run build
+```
+