@prefactor/core 0.1.0

package/dist/transport/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/transport/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C;;;;;;GAMG;AACH,MAAM,WAAW,SAAS;IACxB;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,CAAC;IAEvB;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD;;OAEG;IACH,kBAAkB,IAAI,IAAI,CAAC;IAE3B;;OAEG;IACH,mBAAmB,IAAI,IAAI,CAAC;IAE5B;;;;OAIG;IACH,KAAK,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B"}

package/dist/transport/base.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=base.js.map

package/dist/transport/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/transport/base.ts"],"names":[],"mappings":""}

package/dist/transport/http.d.ts

@@ -0,0 +1,90 @@
+import type { HttpTransportConfig } from '../config.js';
+import type { Span } from '../tracing/span.js';
+import type { Transport } from './base.js';
+/**
+ * HTTP transport sends spans to a remote API endpoint.
+ *
+ * Features:
+ * - Queue-based async processing
+ * - Exponential backoff retry logic
+ * - Span ID mapping (SDK ID → backend ID)
+ * - Agent instance lifecycle management
+ * - Graceful shutdown with timeout
+ *
+ * @example
+ * ```typescript
+ * const transport = new HttpTransport({
+ *   apiUrl: 'https://api.prefactor.ai',
+ *   apiToken: process.env.PREFACTOR_API_TOKEN!,
+ * });
+ * ```
+ */
+export declare class HttpTransport implements Transport {
+    private config;
+    private queue;
+    private processing;
+    private closed;
+    private agentInstanceId;
+    private spanIdMap;
+    constructor(config: HttpTransportConfig);
+    /**
+     * Emit a span (adds to queue for async processing)
+     *
+     * @param span - The span to emit
+     */
+    emit(span: Span): void;
+    /**
+     * Finish a previously emitted span (for AGENT spans)
+     *
+     * @param spanId - ID of the span to finish
+     * @param endTime - End time in milliseconds since Unix epoch
+     */
+    finishSpan(spanId: string, endTime: number): void;
+    /**
+     * Signal the start of an agent instance execution
+     */
+    startAgentInstance(): void;
+    /**
+     * Signal the completion of an agent instance execution
+     */
+    finishAgentInstance(): void;
+    /**
+     * Start background queue processing
+     */
+    private startProcessing;
+    /**
+     * Send a span to the API
+     */
+    private sendSpan;
+    /**
+     * Transform span to backend API format with nested details/payload structure
+     */
+    private transformSpanToApiFormat;
+    /**
+     * Get default schema (v1.0.0) with span schemas for all supported types
+     */
+    private getDefaultSchema;
+    /**
+     * Ensure an agent instance is registered
+     */
+    private ensureAgentRegistered;
+    /**
+     * Start agent instance execution
+     */
+    private startAgentInstanceHttp;
+    /**
+     * Finish agent instance execution
+     */
+    private finishAgentInstanceHttp;
+    /**
+     * Finish a span via HTTP
+     */
+    private finishSpanHttp;
+    /**
+     * Close the transport and wait for queue to drain
+     *
+     * @returns Promise that resolves when transport is closed
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAY3C;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,aAAc,YAAW,SAAS;IAOjC,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAuB;IAC9C,OAAO,CAAC,SAAS,CAA6B;gBAE1B,MAAM,EAAE,mBAAmB;IAI/C;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAOtB;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAQjD;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAO1B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAO3B;;OAEG;YACW,eAAe;IAwC7B;;OAEG;YACW,QAAQ;IAmDtB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAmDhC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;YACW,qBAAqB;IA6DnC;;OAEG;YACW,sBAAsB;IA6BpC;;OAEG;YACW,uBAAuB;IA2BrC;;OAEG;YACW,cAAc;IA4B5B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAc7B"}

package/dist/transport/http.js

@@ -0,0 +1,399 @@
+import { getLogger } from '../utils/logging.js';
+const logger = getLogger('http-transport');
+/**
+ * HTTP transport sends spans to a remote API endpoint.
+ *
+ * Features:
+ * - Queue-based async processing
+ * - Exponential backoff retry logic
+ * - Span ID mapping (SDK ID → backend ID)
+ * - Agent instance lifecycle management
+ * - Graceful shutdown with timeout
+ *
+ * @example
+ * ```typescript
+ * const transport = new HttpTransport({
+ *   apiUrl: 'https://api.prefactor.ai',
+ *   apiToken: process.env.PREFACTOR_API_TOKEN!,
+ * });
+ * ```
+ */
+export class HttpTransport {
+    config;
+    queue = [];
+    processing = false;
+    closed = false;
+    agentInstanceId = null;
+    spanIdMap = new Map();
+    constructor(config) {
+        this.config = config;
+        this.startProcessing();
+    }
+    /**
+     * Emit a span (adds to queue for async processing)
+     *
+     * @param span - The span to emit
+     */
+    emit(span) {
+        if (this.closed) {
+            return;
+        }
+        this.queue.push({ type: 'span', data: span });
+    }
+    /**
+     * Finish a previously emitted span (for AGENT spans)
+     *
+     * @param spanId - ID of the span to finish
+     * @param endTime - End time in milliseconds since Unix epoch
+     */
+    finishSpan(spanId, endTime) {
+        if (this.closed) {
+            return;
+        }
+        const timestamp = new Date(endTime).toISOString();
+        this.queue.push({ type: 'finish_span', data: { spanId, timestamp } });
+    }
+    /**
+     * Signal the start of an agent instance execution
+     */
+    startAgentInstance() {
+        if (this.closed) {
+            return;
+        }
+        this.queue.push({ type: 'start_agent', data: null });
+    }
+    /**
+     * Signal the completion of an agent instance execution
+     */
+    finishAgentInstance() {
+        if (this.closed) {
+            return;
+        }
+        this.queue.push({ type: 'finish_agent', data: null });
+    }
+    /**
+     * Start background queue processing
+     */
+    async startProcessing() {
+        this.processing = true;
+        while (!this.closed || this.queue.length > 0) {
+            if (this.queue.length === 0) {
+                await new Promise((resolve) => setTimeout(resolve, 100));
+                continue;
+            }
+            const item = this.queue.shift();
+            if (!item)
+                continue;
+            try {
+                // Ensure agent is registered before processing spans
+                if (!this.agentInstanceId && item.type !== 'start_agent') {
+                    await this.ensureAgentRegistered();
+                }
+                switch (item.type) {
+                    case 'span':
+                        await this.sendSpan(item.data);
+                        break;
+                    case 'finish_span':
+                        await this.finishSpanHttp(item.data);
+                        break;
+                    case 'start_agent':
+                        await this.startAgentInstanceHttp();
+                        break;
+                    case 'finish_agent':
+                        await this.finishAgentInstanceHttp();
+                        break;
+                }
+            }
+            catch (error) {
+                logger.error('Error processing queue item:', error);
+            }
+        }
+        this.processing = false;
+    }
+    /**
+     * Send a span to the API
+     */
+    async sendSpan(span, retry = 0) {
+        const url = `${this.config.apiUrl}/api/v1/agent_spans`;
+        const payload = this.transformSpanToApiFormat(span);
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(this.config.requestTimeout),
+            });
+            if (response.ok) {
+                const data = (await response.json());
+                const backendSpanId = data?.details?.id;
+                if (backendSpanId) {
+                    this.spanIdMap.set(span.spanId, backendSpanId);
+                }
+                return;
+            }
+            // Retry on server errors or rate limiting
+            if ((response.status >= 500 || response.status === 429) && retry < this.config.maxRetries) {
+                const delay = Math.min(this.config.initialRetryDelay * this.config.retryMultiplier ** retry, this.config.maxRetryDelay);
+                logger.debug(`Retrying span send after ${delay}ms (attempt ${retry + 1})`);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.sendSpan(span, retry + 1);
+            }
+            logger.error(`Failed to send span: ${response.status} ${response.statusText}`);
+        }
+        catch (error) {
+            logger.error('Error sending span:', error);
+            // Retry on network errors
+            if (retry < this.config.maxRetries) {
+                const delay = Math.min(this.config.initialRetryDelay * this.config.retryMultiplier ** retry, this.config.maxRetryDelay);
+                await new Promise((resolve) => setTimeout(resolve, delay));
+                return this.sendSpan(span, retry + 1);
+            }
+        }
+    }
+    /**
+     * Transform span to backend API format with nested details/payload structure
+     */
+    transformSpanToApiFormat(span) {
+        const startedAt = new Date(span.startTime).toISOString();
+        const finishedAt = span.endTime ? new Date(span.endTime).toISOString() : null;
+        // Build payload with span data
+        const payload = {
+            span_id: span.spanId,
+            trace_id: span.traceId,
+            name: span.name,
+            status: span.status,
+            inputs: span.inputs,
+            outputs: span.outputs,
+            metadata: span.metadata,
+            tags: span.tags,
+            token_usage: null,
+            error: null,
+        };
+        // Add optional token_usage
+        if (span.tokenUsage) {
+            payload.token_usage = {
+                prompt_tokens: span.tokenUsage.promptTokens,
+                completion_tokens: span.tokenUsage.completionTokens,
+                total_tokens: span.tokenUsage.totalTokens,
+            };
+        }
+        // Add optional error
+        if (span.error) {
+            payload.error = {
+                error_type: span.error.errorType,
+                message: span.error.message,
+                stacktrace: span.error.stacktrace,
+            };
+        }
+        // Resolve parent span ID to backend ID
+        const parentSpanId = span.parentSpanId ? (this.spanIdMap.get(span.parentSpanId) ?? null) : null;
+        return {
+            details: {
+                agent_instance_id: this.agentInstanceId,
+                schema_name: span.spanType,
+                payload,
+                parent_span_id: parentSpanId,
+                started_at: startedAt,
+                finished_at: finishedAt,
+            },
+        };
+    }
+    /**
+     * Get default schema (v1.0.0) with span schemas for all supported types
+     */
+    getDefaultSchema() {
+        return {
+            external_identifier: '1.0.0',
+            span_schemas: {
+                agent: {
+                    type: 'object',
+                    properties: { type: { type: 'string', const: 'agent' } },
+                },
+                llm: {
+                    type: 'object',
+                    properties: { type: { type: 'string', const: 'llm' } },
+                },
+                tool: {
+                    type: 'object',
+                    properties: { type: { type: 'string', const: 'tool' } },
+                },
+                chain: {
+                    type: 'object',
+                    properties: { type: { type: 'string', const: 'chain' } },
+                },
+                retriever: {
+                    type: 'object',
+                    properties: { type: { type: 'string', const: 'retriever' } },
+                },
+            },
+        };
+    }
+    /**
+     * Ensure an agent instance is registered
+     */
+    async ensureAgentRegistered() {
+        if (this.agentInstanceId) {
+            return;
+        }
+        const url = `${this.config.apiUrl}/api/v1/agent_instance/register`;
+        const payload = {};
+        if (this.config.agentId)
+            payload.agent_id = this.config.agentId;
+        if (this.config.agentVersion) {
+            payload.agent_version = {
+                external_identifier: this.config.agentVersion,
+                name: this.config.agentName || 'Agent',
+                description: this.config.agentDescription || '',
+            };
+        }
+        // Schema handling - four modes:
+        // 1. skipSchema=true: No schema in payload (pre-registered on backend)
+        // 2. agentSchema provided: Use full custom schema object
+        // 3. agentSchemaVersion provided: Use version identifier only
+        // 4. None of above: Use default v1.0.0 schema
+        if (this.config.skipSchema) {
+            logger.debug('Skipping schema in registration (skipSchema=true)');
+            // Do not add agent_schema_version key
+        }
+        else if (this.config.agentSchema) {
+            logger.debug('Using custom agent schema');
+            payload.agent_schema_version = this.config.agentSchema;
+        }
+        else if (this.config.agentSchemaVersion) {
+            logger.debug(`Using schema version: ${this.config.agentSchemaVersion}`);
+            payload.agent_schema_version = {
+                external_identifier: this.config.agentSchemaVersion,
+            };
+        }
+        else {
+            logger.debug('Using default hardcoded schema (v1.0.0)');
+            payload.agent_schema_version = this.getDefaultSchema();
+        }
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify(payload),
+                signal: AbortSignal.timeout(this.config.requestTimeout),
+            });
+            if (response.ok) {
+                const data = (await response.json());
+                this.agentInstanceId = data?.details?.id ?? null;
+                logger.debug(`Registered agent instance: ${this.agentInstanceId}`);
+            }
+            else {
+                logger.error(`Failed to register agent: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            logger.error('Error registering agent:', error);
+        }
+    }
+    /**
+     * Start agent instance execution
+     */
+    async startAgentInstanceHttp() {
+        await this.ensureAgentRegistered();
+        if (!this.agentInstanceId) {
+            logger.error('Cannot start agent instance: not registered');
+            return;
+        }
+        const url = `${this.config.apiUrl}/api/v1/agent_instance/${this.agentInstanceId}/start`;
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({}),
+                signal: AbortSignal.timeout(this.config.requestTimeout),
+            });
+            if (!response.ok) {
+                logger.error(`Failed to start agent instance: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            logger.error('Error starting agent instance:', error);
+        }
+    }
+    /**
+     * Finish agent instance execution
+     */
+    async finishAgentInstanceHttp() {
+        if (!this.agentInstanceId) {
+            logger.error('Cannot finish agent instance: not registered');
+            return;
+        }
+        const url = `${this.config.apiUrl}/api/v1/agent_instance/${this.agentInstanceId}/finish`;
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({}),
+                signal: AbortSignal.timeout(this.config.requestTimeout),
+            });
+            if (!response.ok) {
+                logger.error(`Failed to finish agent instance: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            logger.error('Error finishing agent instance:', error);
+        }
+    }
+    /**
+     * Finish a span via HTTP
+     */
+    async finishSpanHttp(data) {
+        const backendSpanId = this.spanIdMap.get(data.spanId);
+        if (!backendSpanId) {
+            logger.warn(`Cannot finish span ${data.spanId}: backend ID not found`);
+            return;
+        }
+        const url = `${this.config.apiUrl}/api/v1/agent_spans/${backendSpanId}/finish`;
+        try {
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    Authorization: `Bearer ${this.config.apiToken}`,
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ timestamp: data.timestamp }),
+                signal: AbortSignal.timeout(this.config.requestTimeout),
+            });
+            if (!response.ok) {
+                logger.error(`Failed to finish span: ${response.status} ${response.statusText}`);
+            }
+        }
+        catch (error) {
+            logger.error('Error finishing span:', error);
+        }
+    }
+    /**
+     * Close the transport and wait for queue to drain
+     *
+     * @returns Promise that resolves when transport is closed
+     */
+    async close() {
+        this.closed = true;
+        // Wait for queue to drain (with timeout)
+        const timeout = 10000;
+        const start = Date.now();
+        while (this.processing && Date.now() - start < timeout) {
+            await new Promise((resolve) => setTimeout(resolve, 100));
+        }
+        if (this.processing) {
+            logger.warn('Transport closed with pending queue items');
+        }
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/transport/http.js.map

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

package/dist/transport/stdio.d.ts

@@ -0,0 +1,48 @@
+import type { Span } from '../tracing/span.js';
+import type { Transport } from './base.js';
+/**
+ * STDIO transport emits spans as newline-delimited JSON to stdout.
+ *
+ * This is the default transport and requires no configuration.
+ * It's useful for local development and for piping span data to other tools.
+ *
+ * Features:
+ * - Newline-delimited JSON output
+ * - Promise-based write locking for ordering
+ * - Graceful error handling
+ *
+ * @example
+ * ```typescript
+ * const transport = new StdioTransport();
+ * const tracer = new Tracer(transport);
+ * ```
+ */
+export declare class StdioTransport implements Transport {
+    private closed;
+    private writeLock;
+    /**
+     * Emit a span to stdout as JSON
+     *
+     * @param span - The span to emit
+     */
+    emit(span: Span): void;
+    /**
+     * No-op for stdio transport (not applicable)
+     */
+    finishSpan(): void;
+    /**
+     * No-op for stdio transport (not applicable)
+     */
+    startAgentInstance(): void;
+    /**
+     * No-op for stdio transport (not applicable)
+     */
+    finishAgentInstance(): void;
+    /**
+     * Close the transport and wait for pending writes to complete
+     *
+     * @returns Promise that resolves when all writes are complete
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=stdio.d.ts.map

package/dist/transport/stdio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.d.ts","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,cAAe,YAAW,SAAS;IAC9C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqB;IAEtC;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAiBtB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,mBAAmB,IAAI,IAAI;IAI3B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/transport/stdio.js

@@ -0,0 +1,71 @@
+import { serializeValue } from '../utils/serialization.js';
+/**
+ * STDIO transport emits spans as newline-delimited JSON to stdout.
+ *
+ * This is the default transport and requires no configuration.
+ * It's useful for local development and for piping span data to other tools.
+ *
+ * Features:
+ * - Newline-delimited JSON output
+ * - Promise-based write locking for ordering
+ * - Graceful error handling
+ *
+ * @example
+ * ```typescript
+ * const transport = new StdioTransport();
+ * const tracer = new Tracer(transport);
+ * ```
+ */
+export class StdioTransport {
+    closed = false;
+    writeLock = Promise.resolve();
+    /**
+     * Emit a span to stdout as JSON
+     *
+     * @param span - The span to emit
+     */
+    emit(span) {
+        if (this.closed) {
+            return;
+        }
+        // Queue write to maintain ordering
+        this.writeLock = this.writeLock.then(async () => {
+            try {
+                const serialized = serializeValue(span);
+                const json = JSON.stringify(serialized);
+                await Bun.write(Bun.stdout, `${json}\n`);
+            }
+            catch (error) {
+                console.error('Failed to emit span to stdout:', error);
+            }
+        });
+    }
+    /**
+     * No-op for stdio transport (not applicable)
+     */
+    finishSpan() {
+        // No-op for stdio transport
+    }
+    /**
+     * No-op for stdio transport (not applicable)
+     */
+    startAgentInstance() {
+        // No-op for stdio transport
+    }
+    /**
+     * No-op for stdio transport (not applicable)
+     */
+    finishAgentInstance() {
+        // No-op for stdio transport
+    }
+    /**
+     * Close the transport and wait for pending writes to complete
+     *
+     * @returns Promise that resolves when all writes are complete
+     */
+    async close() {
+        this.closed = true;
+        await this.writeLock;
+    }
+}
+//# sourceMappingURL=stdio.js.map

package/dist/transport/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../src/transport/stdio.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAG3D;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,cAAc;IACjB,MAAM,GAAG,KAAK,CAAC;IACf,SAAS,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAEtC;;;;OAIG;IACH,IAAI,CAAC,IAAU;QACb,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE;YAC9C,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;gBACxC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;gBACxC,MAAM,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;YAC3C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,gCAAgC,EAAE,KAAK,CAAC,CAAC;YACzD,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU;QACR,4BAA4B;IAC9B,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,4BAA4B;IAC9B,CAAC;IAED;;OAEG;IACH,mBAAmB;QACjB,4BAA4B;IAC9B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;CACF"}

package/dist/utils/logging.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Logger class for the Prefactor SDK
+ */
+declare class Logger {
+    private namespace;
+    private static level;
+    constructor(namespace: string);
+    debug(message: string, ...args: unknown[]): void;
+    info(message: string, ...args: unknown[]): void;
+    warn(message: string, ...args: unknown[]): void;
+    error(message: string, ...args: unknown[]): void;
+    /**
+     * Set the global log level
+     */
+    static setLevel(level: 'debug' | 'info' | 'warn' | 'error'): void;
+}
+/**
+ * Get a logger instance for a specific namespace
+ *
+ * @param namespace - The namespace for this logger
+ * @returns Logger instance
+ */
+export declare function getLogger(namespace: string): Logger;
+/**
+ * Configure logging based on environment variables
+ */
+export declare function configureLogging(): void;
+export {};
+//# sourceMappingURL=logging.d.ts.map