ai-functions 0.2.19 → 0.3.0

package/dist/utils/__tests__/schema.test.js

@@ -0,0 +1,49 @@
+import { describe, it, expect } from 'vitest';
+import { createSchemaFromTemplate } from '../schema';
+describe('createSchemaFromTemplate', () => {
+    it('should create enum schema for pipe-separated values', () => {
+        const template = {
+            productType: 'App | API | Marketplace',
+        };
+        const schema = createSchemaFromTemplate(template);
+        const result = schema.safeParse({ productType: 'App' });
+        expect(result.success).toBe(true);
+        const productTypeField = schema._def.shape().productType;
+        expect(productTypeField._def.description).toBe('App | API | Marketplace');
+        expect(productTypeField.options).toContain('App');
+        expect(productTypeField.options).toContain('API');
+        expect(productTypeField.options).toContain('Marketplace');
+    });
+    it('should create string schema with description', () => {
+        const template = {
+            description: 'website meta description',
+        };
+        const schema = createSchemaFromTemplate(template);
+        const result = schema.safeParse({ description: 'A great website' });
+        expect(result.success).toBe(true);
+        const descriptionField = schema._def.shape().description;
+        expect(descriptionField._def.description).toBe('website meta description');
+    });
+    it('should enforce word count constraints', () => {
+        const template = {
+            customer: 'ideal customer profile in 3-5 words',
+        };
+        const schema = createSchemaFromTemplate(template);
+        // Valid case
+        const validResult = schema.safeParse({ customer: 'small business tech startups' });
+        expect(validResult.success).toBe(true);
+        // Too few words
+        const tooFewResult = schema.safeParse({ customer: 'small businesses' });
+        expect(tooFewResult.success).toBe(false);
+        if (!tooFewResult.success) {
+            expect(tooFewResult.error.errors[0].message).toBe('Must be between 3 and 5 words');
+        }
+        // Too many words
+        const tooManyResult = schema.safeParse({ customer: 'small business tech startups in California' });
+        expect(tooManyResult.success).toBe(false);
+        if (!tooManyResult.success) {
+            expect(tooManyResult.error.errors[0].message).toBe('Must be between 3 and 5 words');
+        }
+    });
+});
+//# sourceMappingURL=schema.test.js.map

package/dist/utils/__tests__/schema.test.js.map

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

package/dist/utils/__tests__/stream-progress.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stream-progress.test.d.ts.map

package/dist/utils/__tests__/stream-progress.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-progress.test.d.ts","sourceRoot":"","sources":["../../../src/utils/__tests__/stream-progress.test.ts"],"names":[],"mappings":""}

package/dist/utils/__tests__/stream-progress.test.js

@@ -0,0 +1,85 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { StreamProgressTracker } from '../stream-progress';
+describe('StreamProgressTracker', () => {
+    beforeEach(() => {
+        vi.useFakeTimers();
+    });
+    it('should track basic progress', () => {
+        const onProgress = vi.fn();
+        const tracker = new StreamProgressTracker({
+            onProgress,
+            enableTokenCounting: true,
+        });
+        tracker.onChunk('Hello');
+        expect(onProgress).toHaveBeenCalledWith(expect.objectContaining({
+            type: 'chunk',
+            chunk: 'Hello',
+            tokensGenerated: expect.any(Number),
+        }));
+        tracker.onComplete();
+        expect(onProgress).toHaveBeenLastCalledWith(expect.objectContaining({
+            type: 'complete',
+            tokensGenerated: expect.any(Number),
+            totalTokens: expect.any(Number),
+        }));
+    });
+    it('should estimate time remaining', async () => {
+        const onProgress = vi.fn();
+        const tracker = new StreamProgressTracker({
+            onProgress,
+            enableTokenCounting: true,
+            estimateTimeRemaining: true,
+        });
+        // First chunk
+        tracker.onChunk('Hello');
+        // Advance time and send another chunk
+        await vi.advanceTimersByTimeAsync(1000);
+        tracker.onChunk('World');
+        expect(onProgress).toHaveBeenLastCalledWith(expect.objectContaining({
+            type: 'chunk',
+            chunk: 'World',
+            estimatedTimeRemaining: expect.any(Number),
+        }));
+    });
+    it('should track token-level progress', () => {
+        const onProgress = vi.fn();
+        const tracker = new StreamProgressTracker({
+            onProgress,
+            enableTokenCounting: true,
+        });
+        tracker.onToken('Hello');
+        expect(onProgress).toHaveBeenCalledWith(expect.objectContaining({
+            type: 'token',
+            chunk: 'Hello',
+            tokensGenerated: 1,
+        }));
+    });
+    it('should not include token counts when disabled', () => {
+        const onProgress = vi.fn();
+        const tracker = new StreamProgressTracker({
+            onProgress,
+            enableTokenCounting: false,
+        });
+        tracker.onChunk('Hello');
+        expect(onProgress).toHaveBeenCalledWith(expect.objectContaining({
+            type: 'chunk',
+            chunk: 'Hello',
+        }));
+        expect(onProgress).not.toHaveBeenCalledWith(expect.objectContaining({
+            tokensGenerated: expect.any(Number),
+        }));
+    });
+    it('should not estimate time when disabled', () => {
+        const onProgress = vi.fn();
+        const tracker = new StreamProgressTracker({
+            onProgress,
+            enableTokenCounting: true,
+            estimateTimeRemaining: false,
+        });
+        tracker.onChunk('Hello');
+        expect(onProgress).not.toHaveBeenCalledWith(expect.objectContaining({
+            estimatedTimeRemaining: expect.any(Number),
+        }));
+    });
+});
+//# sourceMappingURL=stream-progress.test.js.map

package/dist/utils/__tests__/stream-progress.test.js.map

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

package/dist/utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from './validation';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/utils/index.js

@@ -0,0 +1,2 @@
+export * from './validation';
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/dist/utils/request-handler.d.ts

@@ -0,0 +1,17 @@
+import type { RequestHandlingOptions } from '../types';
+export declare class RequestHandler {
+    private retryOptions;
+    private queue;
+    private streamingTimeout;
+    constructor(options?: RequestHandlingOptions);
+    executeWithRetry<T>(operation: () => Promise<T> | AsyncGenerator<T>, retryable?: boolean, isStreaming?: boolean): Promise<T>;
+    execute<T>(operation: () => Promise<T> | AsyncGenerator<T>, retryable?: boolean, isStreaming?: boolean): Promise<T>;
+    get concurrency(): number | undefined;
+    get size(): number;
+    get pending(): number;
+    clear(): void;
+    pause(): void;
+    resume(): void;
+}
+export declare function createRequestHandler(options?: RequestHandlingOptions): RequestHandler;
+//# sourceMappingURL=request-handler.d.ts.map

package/dist/utils/request-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-handler.d.ts","sourceRoot":"","sources":["../../src/utils/request-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAA;AAItD,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAKnB;IACD,OAAO,CAAC,KAAK,CAAQ;IACrB,OAAO,CAAC,gBAAgB,CAAQ;gBAEpB,OAAO,GAAE,sBAA2B;IAW1C,gBAAgB,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,UAAO,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAuE7H,OAAO,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,UAAO,EAAE,WAAW,UAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;IAW9G,IAAI,WAAW,IAAI,MAAM,GAAG,SAAS,CAEpC;IAED,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,MAAM,CAEpB;IAED,KAAK,IAAI,IAAI;IAIb,KAAK,IAAI,IAAI;IAIb,MAAM,IAAI,IAAI;CAGf;AAED,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,sBAA2B,GAAG,cAAc,CAEzF"}

package/dist/utils/request-handler.js

@@ -0,0 +1,105 @@
+import { AIRequestError } from '../types';
+import PQueue from 'p-queue';
+export class RequestHandler {
+    constructor(options = {}) {
+        this.retryOptions = {
+            maxRetries: options.maxRetries ?? 2,
+            initialDelay: options.retryDelay ?? 100,
+            maxDelay: options.timeout ?? 1000,
+            backoffFactor: 2
+        };
+        this.queue = new PQueue({ concurrency: 1 });
+        this.streamingTimeout = options.streamingTimeout ?? 30000;
+    }
+    async executeWithRetry(operation, retryable = true, isStreaming = false) {
+        let lastError;
+        let attempt = 0;
+        const maxAttempts = retryable ? this.retryOptions.maxRetries : 0;
+        const timeoutMs = isStreaming ? this.streamingTimeout : this.retryOptions.maxDelay;
+        const executeWithTimeout = async (op) => {
+            const abortController = new AbortController();
+            const timeoutId = setTimeout(() => {
+                abortController.abort();
+            }, timeoutMs);
+            try {
+                if (op instanceof Promise) {
+                    const result = await Promise.race([
+                        op,
+                        new Promise((_, reject) => {
+                            abortController.signal.addEventListener('abort', () => {
+                                reject(new AIRequestError(`Request timed out after ${timeoutMs}ms`));
+                            });
+                        })
+                    ]);
+                    return result;
+                }
+                else {
+                    const chunks = [];
+                    for await (const chunk of op) {
+                        if (abortController.signal.aborted) {
+                            throw new AIRequestError(`Stream timed out after ${timeoutMs}ms`);
+                        }
+                        chunks.push(chunk);
+                    }
+                    if (chunks.length === 0) {
+                        throw new AIRequestError('No chunks received from stream');
+                    }
+                    return chunks[chunks.length - 1];
+                }
+            }
+            finally {
+                clearTimeout(timeoutId);
+            }
+        };
+        while (attempt <= maxAttempts) {
+            try {
+                return await executeWithTimeout(operation());
+            }
+            catch (error) {
+                lastError = error;
+                if (!retryable || error instanceof AIRequestError && !error.retryable) {
+                    throw error;
+                }
+                if (attempt >= maxAttempts) {
+                    throw new AIRequestError(`Failed after ${attempt + 1} attempts: ${lastError?.message || 'Unknown error'}`, undefined, false);
+                }
+                const delay = Math.min(this.retryOptions.initialDelay * Math.pow(this.retryOptions.backoffFactor, attempt), this.retryOptions.maxDelay);
+                await new Promise(resolve => setTimeout(resolve, delay));
+                attempt++;
+            }
+        }
+        throw lastError || new AIRequestError('Operation failed with no error details');
+    }
+    execute(operation, retryable = true, isStreaming = false) {
+        const executeOperation = async () => {
+            const result = await this.executeWithRetry(operation, retryable, isStreaming);
+            if (result === undefined) {
+                throw new AIRequestError('Operation returned undefined result');
+            }
+            return result;
+        };
+        return this.queue.add(executeOperation);
+    }
+    get concurrency() {
+        return this.queue?.concurrency;
+    }
+    get size() {
+        return this.queue?.size ?? 0;
+    }
+    get pending() {
+        return this.queue?.pending ?? 0;
+    }
+    clear() {
+        this.queue?.clear();
+    }
+    pause() {
+        this.queue?.pause();
+    }
+    resume() {
+        this.queue?.start();
+    }
+}
+export function createRequestHandler(options = {}) {
+    return new RequestHandler(options);
+}
+//# sourceMappingURL=request-handler.js.map

package/dist/utils/request-handler.js.map

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

package/dist/utils/schema.d.ts

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+/**
+ * Creates a Zod schema from a template object where:
+ * - String values become descriptions
+ * - Pipe-separated values become enums
+ * - Word count constraints (e.g. "3-5 words") are enforced
+ */
+export declare function createSchemaFromTemplate<T extends Record<string, string>>(template: T): z.ZodObject<{
+    [K in keyof T]: z.ZodString | z.ZodEnum<[string, ...string[]]> | z.ZodEffects<z.ZodString>;
+}>;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvE,QAAQ,EAAE,CAAC,GACV,CAAC,CAAC,SAAS,CAAC;KACZ,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;CAC3F,CAAC,CA8CD"}

package/dist/utils/schema.js

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+/**
+ * Creates a Zod schema from a template object where:
+ * - String values become descriptions
+ * - Pipe-separated values become enums
+ * - Word count constraints (e.g. "3-5 words") are enforced
+ */
+export function createSchemaFromTemplate(template) {
+    const shape = Object.entries(template).reduce((acc, [key, value]) => {
+        // Check if value contains pipe-separated options
+        if (value.includes('|')) {
+            const options = value
+                .split('|')
+                .map((opt) => opt.trim())
+                .filter(Boolean); // Remove empty strings
+            if (options.length >= 1) {
+                acc[key] = z.enum([options[0], ...options.slice(1)]).describe(value);
+            }
+            else {
+                acc[key] = z.string().describe(value);
+            }
+        }
+        else {
+            // Check for word count constraints
+            const wordCountMatch = value.match(/(\d+)-(\d+)\s+words/);
+            if (wordCountMatch) {
+                const [, minStr, maxStr] = wordCountMatch;
+                const min = parseInt(minStr, 10);
+                const max = parseInt(maxStr, 10);
+                acc[key] = z
+                    .string()
+                    .min(1)
+                    .refine((val) => {
+                    const words = val.trim().split(/\s+/).length;
+                    return words >= min && words <= max;
+                }, {
+                    message: `Must be between ${min} and ${max} words`,
+                    params: { min, max },
+                })
+                    .describe(value);
+            }
+            else {
+                // Regular string field with description
+                acc[key] = z.string().describe(value);
+            }
+        }
+        return acc;
+    }, {});
+    return z.object(shape);
+}
+//# sourceMappingURL=schema.js.map

package/dist/utils/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/utils/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CACtC,QAAW;IAOX,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAuB,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QACxF,iDAAiD;QACjD,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,KAAK;iBAClB,KAAK,CAAC,GAAG,CAAC;iBACV,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;iBACxB,MAAM,CAAC,OAAO,CAAC,CAAA,CAAC,uBAAuB;YAC1C,IAAI,OAAO,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACxB,GAAG,CAAC,GAAc,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAA0B,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAC1G,CAAC;iBAAM,CAAC;gBACN,GAAG,CAAC,GAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAClD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,mCAAmC;YACnC,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAA;YACzD,IAAI,cAAc,EAAE,CAAC;gBACnB,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,cAAc,CAAA;gBACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;gBAChC,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;gBAChC,GAAG,CAAC,GAAc,CAAC,GAAG,CAAC;qBACpB,MAAM,EAAE;qBACR,GAAG,CAAC,CAAC,CAAC;qBACN,MAAM,CACL,CAAC,GAAG,EAAE,EAAE;oBACN,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAA;oBAC5C,OAAO,KAAK,IAAI,GAAG,IAAI,KAAK,IAAI,GAAG,CAAA;gBACrC,CAAC,EACD;oBACE,OAAO,EAAE,mBAAmB,GAAG,QAAQ,GAAG,QAAQ;oBAClD,MAAM,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE;iBACrB,CACF;qBACA,QAAQ,CAAC,KAAK,CAAC,CAAA;YACpB,CAAC;iBAAM,CAAC;gBACN,wCAAwC;gBACxC,GAAG,CAAC,GAAc,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;YAClD,CAAC;QACH,CAAC;QACD,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,CAAC,CAAC,MAAM,CAAC,KAAoB,CAAC,CAAA;AACvC,CAAC"}

package/dist/utils/stream-progress.d.ts

@@ -0,0 +1,17 @@
+import { StreamingOptions } from '../types';
+export declare class StreamProgressTracker {
+    private tokensGenerated;
+    private startTime;
+    private lastUpdateTime;
+    private tokenRate;
+    private readonly options;
+    private readonly callback;
+    private readonly alpha;
+    constructor(options: StreamingOptions);
+    private updateTokenRate;
+    private estimateTimeRemaining;
+    onChunk(chunk: string): void;
+    onToken(token: string): void;
+    onComplete(): void;
+}
+//# sourceMappingURL=stream-progress.d.ts.map

package/dist/utils/stream-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-progress.d.ts","sourceRoot":"","sources":["../../src/utils/stream-progress.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE9E,qBAAa,qBAAqB;IAChC,OAAO,CAAC,eAAe,CAAa;IACpC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmB;IAC5C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAEzB,OAAO,EAAE,gBAAgB;IAKrC,OAAO,CAAC,eAAe;IAmBvB,OAAO,CAAC,qBAAqB;IAmBtB,OAAO,CAAC,KAAK,EAAE,MAAM;IAuBrB,OAAO,CAAC,KAAK,EAAE,MAAM;IAqBrB,UAAU;CAWlB"}

package/dist/utils/stream-progress.js

@@ -0,0 +1,86 @@
+export class StreamProgressTracker {
+    constructor(options) {
+        this.tokensGenerated = 0;
+        this.startTime = Date.now();
+        this.lastUpdateTime = Date.now();
+        this.tokenRate = 0;
+        this.alpha = 0.3; // EMA smoothing factor
+        this.options = options;
+        this.callback = options.onProgress || (() => { });
+    }
+    updateTokenRate(newTokens) {
+        const now = Date.now();
+        const timeDiff = now - this.lastUpdateTime;
+        if (timeDiff > 0) {
+            // Calculate instantaneous rate
+            const instantRate = newTokens / timeDiff;
+            // Apply exponential moving average for smoother rate
+            if (this.tokenRate === 0) {
+                this.tokenRate = instantRate;
+            }
+            else {
+                this.tokenRate = (this.alpha * instantRate) + ((1 - this.alpha) * this.tokenRate);
+            }
+            this.lastUpdateTime = now;
+        }
+    }
+    estimateTimeRemaining() {
+        if (!this.options.estimateTimeRemaining || this.tokenRate === 0) {
+            return undefined;
+        }
+        // Use dynamic estimation based on current progress
+        const progressRatio = this.tokensGenerated / Math.max(100, this.tokensGenerated * 2);
+        const estimatedTotalTokens = Math.max(this.tokensGenerated * (1 + (1 - progressRatio)), this.tokensGenerated + 100);
+        const remainingTokens = estimatedTotalTokens - this.tokensGenerated;
+        const estimatedMs = remainingTokens / this.tokenRate;
+        // Return undefined if estimate is unreasonable
+        return estimatedMs > 0 && estimatedMs < 3600000 ? estimatedMs : undefined;
+    }
+    onChunk(chunk) {
+        // Rough token count estimation (can be replaced with more accurate counting)
+        const estimatedTokens = Math.ceil(chunk.length / 4);
+        this.tokensGenerated += estimatedTokens;
+        if (this.options.enableTokenCounting) {
+            this.updateTokenRate(estimatedTokens);
+        }
+        const progress = {
+            type: 'chunk',
+            chunk,
+            ...(this.options.enableTokenCounting && {
+                tokensGenerated: this.tokensGenerated,
+            }),
+            ...(this.options.estimateTimeRemaining && {
+                estimatedTimeRemaining: this.estimateTimeRemaining(),
+            }),
+        };
+        this.callback(progress);
+    }
+    onToken(token) {
+        this.tokensGenerated += 1;
+        if (this.options.enableTokenCounting) {
+            this.updateTokenRate(1);
+        }
+        const progress = {
+            type: 'token',
+            chunk: token,
+            ...(this.options.enableTokenCounting && {
+                tokensGenerated: this.tokensGenerated,
+            }),
+            ...(this.options.estimateTimeRemaining && {
+                estimatedTimeRemaining: this.estimateTimeRemaining(),
+            }),
+        };
+        this.callback(progress);
+    }
+    onComplete() {
+        const progress = {
+            type: 'complete',
+            ...(this.options.enableTokenCounting && {
+                tokensGenerated: this.tokensGenerated,
+                totalTokens: this.tokensGenerated,
+            }),
+        };
+        this.callback(progress);
+    }
+}
+//# sourceMappingURL=stream-progress.js.map

package/dist/utils/stream-progress.js.map

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

package/dist/utils/validation.d.ts

@@ -0,0 +1,3 @@
+import { SimpleSchema } from '../types';
+export declare function validateSchema(schema: SimpleSchema): void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAEvC,wBAAgB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAWzD"}

package/dist/utils/validation.js

@@ -0,0 +1,30 @@
+export function validateSchema(schema) {
+    if (!schema || typeof schema !== 'object') {
+        throw new Error('Schema must be a valid object');
+    }
+    Object.entries(schema).forEach(([key, value]) => {
+        if (!key || typeof key !== 'string') {
+            throw new Error('Schema keys must be non-empty strings');
+        }
+        validateSchemaValue(value);
+    });
+}
+function validateSchemaValue(value) {
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            throw new Error('Array schema values must not be empty');
+        }
+        value.forEach(item => {
+            if (typeof item !== 'string') {
+                throw new Error('Array schema values must contain only strings');
+            }
+        });
+    }
+    else if (typeof value === 'object' && value !== null) {
+        validateSchema(value);
+    }
+    else if (typeof value !== 'string') {
+        throw new Error('Schema values must be strings, arrays of strings, or nested objects');
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,cAAc,CAAC,MAAoB;IACjD,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC1C,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAA;IAClD,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC9C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QACD,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC5B,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAA;QAC1D,CAAC;QACD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;YACnB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAA;YAClE,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACvD,cAAc,CAAC,KAAqB,CAAC,CAAA;IACvC,CAAC;SAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAA;IACxF,CAAC;AACH,CAAC"}