@pga-ai/core 0.4.0

package/dist/rag/RAGEngine.js

@@ -0,0 +1,162 @@
+export class RAGEngine {
+    llm;
+    metricsCollector;
+    config;
+    constructor(llm, config, metricsCollector) {
+        this.llm = llm;
+        this.metricsCollector = metricsCollector;
+        this.config = config;
+    }
+    async retrieve(query) {
+        const startTime = Date.now();
+        try {
+            const queryEmbedding = await this.generateEmbedding(query);
+            const results = await this.config.vectorStore.search(queryEmbedding, {
+                topK: this.config.search.topK,
+                minScore: this.config.search.minScore,
+            });
+            const filteredResults = results.filter(r => r.score >= this.config.search.minScore);
+            this.metricsCollector?.logAudit({
+                level: 'info',
+                component: 'RAGEngine',
+                operation: 'retrieve',
+                message: `Retrieved ${filteredResults.length} documents for query`,
+                duration: Date.now() - startTime,
+                metadata: {
+                    queryLength: query.length,
+                    resultsFound: filteredResults.length,
+                    topK: this.config.search.topK,
+                    avgScore: filteredResults.length > 0
+                        ? filteredResults.reduce((sum, r) => sum + r.score, 0) / filteredResults.length
+                        : 0,
+                },
+            });
+            return filteredResults;
+        }
+        catch (error) {
+            this.metricsCollector?.logAudit({
+                level: 'error',
+                component: 'RAGEngine',
+                operation: 'retrieve',
+                message: 'Failed to retrieve documents',
+                duration: Date.now() - startTime,
+                error: error instanceof Error ? {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                } : {
+                    name: 'UnknownError',
+                    message: String(error),
+                },
+            });
+            throw error;
+        }
+    }
+    async augment(query, basePrompt) {
+        const results = await this.retrieve(query);
+        const augmentedPrompt = this.buildAugmentedPrompt(basePrompt, results);
+        const totalTokens = this.estimateTokens(augmentedPrompt);
+        return {
+            query,
+            results,
+            augmentedPrompt,
+            totalTokens,
+        };
+    }
+    async generate(query, basePrompt) {
+        const context = await this.augment(query, basePrompt);
+        const response = await this.llm.chat([
+            { role: 'system', content: context.augmentedPrompt },
+            { role: 'user', content: query },
+        ]);
+        return response.content;
+    }
+    async indexDocument(document) {
+        if (!document.embedding) {
+            document.embedding = await this.generateEmbedding(document.content);
+        }
+        await this.config.vectorStore.upsert([document]);
+    }
+    async indexDocuments(documents) {
+        const startTime = Date.now();
+        try {
+            const documentsWithEmbeddings = await Promise.all(documents.map(async (doc) => {
+                if (!doc.embedding) {
+                    doc.embedding = await this.generateEmbedding(doc.content);
+                }
+                return doc;
+            }));
+            await this.config.vectorStore.upsert(documentsWithEmbeddings);
+            this.metricsCollector?.logAudit({
+                level: 'info',
+                component: 'RAGEngine',
+                operation: 'index_documents',
+                message: `Indexed ${documents.length} documents`,
+                duration: Date.now() - startTime,
+                metadata: {
+                    documentsIndexed: documents.length,
+                    embeddingsGenerated: documents.filter(d => !d.embedding).length,
+                    avgContentLength: documents.reduce((sum, d) => sum + d.content.length, 0) / documents.length,
+                },
+            });
+        }
+        catch (error) {
+            this.metricsCollector?.logAudit({
+                level: 'error',
+                component: 'RAGEngine',
+                operation: 'index_documents',
+                message: 'Failed to index documents',
+                duration: Date.now() - startTime,
+                metadata: {
+                    documentsAttempted: documents.length,
+                },
+                error: error instanceof Error ? {
+                    name: error.name,
+                    message: error.message,
+                    stack: error.stack,
+                } : {
+                    name: 'UnknownError',
+                    message: String(error),
+                },
+            });
+            throw error;
+        }
+    }
+    async deleteDocument(documentId) {
+        await this.config.vectorStore.delete([documentId]);
+    }
+    async generateEmbedding(text) {
+        return await this.config.vectorStore.generateEmbedding(text);
+    }
+    buildAugmentedPrompt(basePrompt, results) {
+        if (results.length === 0) {
+            return basePrompt;
+        }
+        const contextSection = this.formatRetrievedContext(results);
+        return `${basePrompt}
+
+# Retrieved Knowledge Context
+
+${contextSection}
+
+IMPORTANT: Use the above context to inform your response. If the context contains relevant information, incorporate it. If not, rely on your general knowledge.`;
+    }
+    formatRetrievedContext(results) {
+        return results
+            .map((result, index) => {
+            const metadata = this.config.context.includeMetadata
+                ? `\nMetadata: ${JSON.stringify(result.document.metadata)}`
+                : '';
+            return `
+## Document ${index + 1} (Relevance: ${(result.relevance * 100).toFixed(0)}%)
+
+${result.document.content}${metadata}
+`;
+        })
+            .join('\n---\n');
+    }
+    estimateTokens(text) {
+        return Math.ceil(text.length / 4);
+    }
+}
+//# sourceMappingURL=RAGEngine.js.map

package/dist/rag/RAGEngine.js.map

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

package/dist/rag/VectorStoreAdapter.d.ts

@@ -0,0 +1,40 @@
+import type { RAGDocument, RAGSearchResult } from './RAGEngine.js';
+export interface VectorStoreAdapter {
+    initialize(): Promise<void>;
+    search(queryEmbedding: number[], options: {
+        topK: number;
+        minScore?: number;
+        filter?: Record<string, any>;
+    }): Promise<RAGSearchResult[]>;
+    upsert(documents: RAGDocument[]): Promise<void>;
+    delete(documentIds: string[]): Promise<void>;
+    generateEmbedding(text: string): Promise<number[]>;
+    getStats(): Promise<{
+        totalDocuments: number;
+        dimensions: number;
+        indexSize: number;
+    }>;
+}
+export declare class InMemoryVectorStore implements VectorStoreAdapter {
+    private documents;
+    private embeddingService?;
+    constructor(embeddingService?: (text: string) => Promise<number[]>);
+    initialize(): Promise<void>;
+    search(queryEmbedding: number[], options: {
+        topK: number;
+        minScore?: number;
+        filter?: Record<string, any>;
+    }): Promise<RAGSearchResult[]>;
+    upsert(documents: RAGDocument[]): Promise<void>;
+    delete(documentIds: string[]): Promise<void>;
+    generateEmbedding(text: string): Promise<number[]>;
+    getStats(): Promise<{
+        totalDocuments: number;
+        dimensions: number;
+        indexSize: number;
+    }>;
+    private cosineSimilarity;
+    private matchesFilter;
+    private simpleEmbedding;
+}
+//# sourceMappingURL=VectorStoreAdapter.d.ts.map

package/dist/rag/VectorStoreAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorStoreAdapter.d.ts","sourceRoot":"","sources":["../../src/rag/VectorStoreAdapter.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAInE,MAAM,WAAW,kBAAkB;IAI/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAK5B,MAAM,CACF,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;KAChC,GACF,OAAO,CAAC,eAAe,EAAE,CAAC,CAAC;IAK9B,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAKhD,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAM7C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAKnD,QAAQ,IAAI,OAAO,CAAC;QAChB,cAAc,EAAE,MAAM,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC,CAAC;CACN;AAID,qBAAa,mBAAoB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,SAAS,CAAuC;IACxD,OAAO,CAAC,gBAAgB,CAAC,CAAsC;gBAEnD,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC;IAI5D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,MAAM,CACR,cAAc,EAAE,MAAM,EAAE,EACxB,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,GAC3E,OAAO,CAAC,eAAe,EAAE,CAAC;IAgCvB,MAAM,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM/C,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAM5C,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASlD,QAAQ,IAAI,OAAO,CAAC;QAAE,cAAc,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAa5F,OAAO,CAAC,gBAAgB;IAyBxB,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,eAAe;CAiC1B"}

package/dist/rag/VectorStoreAdapter.js

@@ -0,0 +1,106 @@
+export class InMemoryVectorStore {
+    documents = new Map();
+    embeddingService;
+    constructor(embeddingService) {
+        this.embeddingService = embeddingService;
+    }
+    async initialize() {
+    }
+    async search(queryEmbedding, options) {
+        const results = [];
+        for (const doc of this.documents.values()) {
+            if (!doc.embedding)
+                continue;
+            const similarity = this.cosineSimilarity(queryEmbedding, doc.embedding);
+            if (options.minScore && similarity < options.minScore) {
+                continue;
+            }
+            if (options.filter && !this.matchesFilter(doc.metadata, options.filter)) {
+                continue;
+            }
+            results.push({
+                document: doc,
+                score: similarity,
+                relevance: similarity,
+            });
+        }
+        results.sort((a, b) => b.score - a.score);
+        return results.slice(0, options.topK);
+    }
+    async upsert(documents) {
+        for (const doc of documents) {
+            this.documents.set(doc.id, doc);
+        }
+    }
+    async delete(documentIds) {
+        for (const id of documentIds) {
+            this.documents.delete(id);
+        }
+    }
+    async generateEmbedding(text) {
+        if (this.embeddingService) {
+            return await this.embeddingService(text);
+        }
+        return this.simpleEmbedding(text);
+    }
+    async getStats() {
+        const firstDoc = Array.from(this.documents.values())[0];
+        const dimensions = firstDoc?.embedding?.length || 0;
+        return {
+            totalDocuments: this.documents.size,
+            dimensions,
+            indexSize: this.documents.size * dimensions * 4,
+        };
+    }
+    cosineSimilarity(a, b) {
+        if (a.length !== b.length) {
+            throw new Error('Vectors must have same dimensions');
+        }
+        let dotProduct = 0;
+        let normA = 0;
+        let normB = 0;
+        for (let i = 0; i < a.length; i++) {
+            dotProduct += a[i] * b[i];
+            normA += a[i] * a[i];
+            normB += b[i] * b[i];
+        }
+        normA = Math.sqrt(normA);
+        normB = Math.sqrt(normB);
+        if (normA === 0 || normB === 0) {
+            return 0;
+        }
+        return dotProduct / (normA * normB);
+    }
+    matchesFilter(metadata, filter) {
+        for (const [key, value] of Object.entries(filter)) {
+            if (metadata[key] !== value) {
+                return false;
+            }
+        }
+        return true;
+    }
+    simpleEmbedding(text) {
+        const dim = 128;
+        const embedding = new Array(dim).fill(0);
+        const keywords = text.toLowerCase()
+            .replace(/[^\w\s]/g, '')
+            .split(/\s+/)
+            .filter(w => w.length > 2);
+        for (const word of keywords) {
+            let hash = 0;
+            for (let i = 0; i < word.length; i++) {
+                hash = ((hash << 5) - hash) + word.charCodeAt(i);
+                hash = hash & hash;
+            }
+            const index = Math.abs(hash) % dim;
+            embedding[index] += 1;
+        }
+        for (let i = 0; i < text.length && i < 100; i++) {
+            const charCode = text.charCodeAt(i);
+            embedding[(charCode + i) % dim] += 0.1;
+        }
+        const norm = Math.sqrt(embedding.reduce((sum, val) => sum + val * val, 0));
+        return norm > 0 ? embedding.map(val => val / norm) : embedding;
+    }
+}
+//# sourceMappingURL=VectorStoreAdapter.js.map

package/dist/rag/VectorStoreAdapter.js.map

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

package/dist/realtime/EventEmitter.d.ts

@@ -0,0 +1,86 @@
+export type PGAEventType = 'genome:created' | 'genome:updated' | 'genome:deleted' | 'genome:evolved' | 'mutation:proposed' | 'mutation:applied' | 'mutation:rejected' | 'chat:started' | 'chat:message' | 'chat:completed' | 'metrics:updated' | 'alert:triggered' | 'health:changed' | 'user:created' | 'user:updated';
+export interface PGAEvent<T = unknown> {
+    type: PGAEventType;
+    timestamp: Date;
+    data: T;
+    metadata?: {
+        userId?: string;
+        genomeId?: string;
+        tenantId?: string;
+        correlationId?: string;
+        [key: string]: unknown;
+    };
+}
+export interface GenomeCreatedEvent {
+    genomeId: string;
+    name: string;
+    userId?: string;
+}
+export interface GenomeEvolvedEvent {
+    genomeId: string;
+    layer: number;
+    gene: string;
+    oldFitness: number;
+    newFitness: number;
+    improvement: number;
+}
+export interface MutationAppliedEvent {
+    genomeId: string;
+    layer: number;
+    gene: string;
+    variant: string;
+    fitness: number;
+    reason: string;
+}
+export interface ChatMessageEvent {
+    genomeId: string;
+    userId: string;
+    message: string;
+    response?: string;
+    duration?: number;
+}
+export interface MetricsUpdatedEvent {
+    type: 'performance' | 'cost' | 'health';
+    data: unknown;
+}
+export interface AlertTriggeredEvent {
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    type: string;
+    title: string;
+    description: string;
+}
+export type EventHandler<T = unknown> = (event: PGAEvent<T>) => void | Promise<void>;
+export declare class PGAEventEmitter {
+    private subscriptions;
+    private wildcardSubscriptions;
+    private eventHistory;
+    private maxHistorySize;
+    private nextSubscriptionId;
+    on<T = unknown>(type: PGAEventType, handler: EventHandler<T>): string;
+    once<T = unknown>(type: PGAEventType, handler: EventHandler<T>): string;
+    onAny(handler: EventHandler): string;
+    private subscribe;
+    off(subscriptionId: string): boolean;
+    removeAllListeners(type?: PGAEventType): void;
+    emit<T = unknown>(type: PGAEventType, data: T, metadata?: PGAEvent<T>['metadata']): Promise<void>;
+    emitSync<T = unknown>(type: PGAEventType, data: T, metadata?: PGAEvent<T>['metadata']): void;
+    getHistory(filter?: {
+        type?: PGAEventType;
+        since?: Date;
+        limit?: number;
+    }): PGAEvent[];
+    waitFor<T = unknown>(type: PGAEventType, timeout?: number, predicate?: (event: PGAEvent<T>) => boolean): Promise<PGAEvent<T>>;
+    listenerCount(type?: PGAEventType): number;
+    eventNames(): PGAEventType[];
+    clearHistory(): void;
+    setMaxHistorySize(size: number): void;
+    getStats(): {
+        totalSubscriptions: number;
+        subscriptionsByType: Record<string, number>;
+        wildcardSubscriptions: number;
+        historySize: number;
+        eventTypes: PGAEventType[];
+    };
+}
+export declare const globalEvents: PGAEventEmitter;
+//# sourceMappingURL=EventEmitter.d.ts.map

package/dist/realtime/EventEmitter.d.ts.map

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

package/dist/realtime/EventEmitter.js

@@ -0,0 +1,173 @@
+export class PGAEventEmitter {
+    subscriptions = new Map();
+    wildcardSubscriptions = [];
+    eventHistory = [];
+    maxHistorySize = 1000;
+    nextSubscriptionId = 1;
+    on(type, handler) {
+        return this.subscribe(type, handler, false);
+    }
+    once(type, handler) {
+        return this.subscribe(type, handler, true);
+    }
+    onAny(handler) {
+        const subscription = {
+            id: `wildcard_${this.nextSubscriptionId++}`,
+            type: '*',
+            handler,
+            once: false,
+        };
+        this.wildcardSubscriptions.push(subscription);
+        return subscription.id;
+    }
+    subscribe(type, handler, once) {
+        const subscription = {
+            id: `${type}_${this.nextSubscriptionId++}`,
+            type,
+            handler: handler,
+            once,
+        };
+        const existing = this.subscriptions.get(type) || [];
+        existing.push(subscription);
+        this.subscriptions.set(type, existing);
+        return subscription.id;
+    }
+    off(subscriptionId) {
+        const wildcardIndex = this.wildcardSubscriptions.findIndex((s) => s.id === subscriptionId);
+        if (wildcardIndex !== -1) {
+            this.wildcardSubscriptions.splice(wildcardIndex, 1);
+            return true;
+        }
+        for (const [type, subs] of this.subscriptions.entries()) {
+            const index = subs.findIndex((s) => s.id === subscriptionId);
+            if (index !== -1) {
+                subs.splice(index, 1);
+                if (subs.length === 0) {
+                    this.subscriptions.delete(type);
+                }
+                return true;
+            }
+        }
+        return false;
+    }
+    removeAllListeners(type) {
+        if (type) {
+            this.subscriptions.delete(type);
+        }
+        else {
+            this.subscriptions.clear();
+            this.wildcardSubscriptions = [];
+        }
+    }
+    async emit(type, data, metadata) {
+        const event = {
+            type,
+            timestamp: new Date(),
+            data,
+            metadata,
+        };
+        this.eventHistory.push(event);
+        if (this.eventHistory.length > this.maxHistorySize) {
+            this.eventHistory.shift();
+        }
+        const typeSubscriptions = this.subscriptions.get(type) || [];
+        const allSubscriptions = [...typeSubscriptions, ...this.wildcardSubscriptions];
+        const promises = [];
+        for (const subscription of allSubscriptions) {
+            try {
+                const result = subscription.handler(event);
+                if (result instanceof Promise) {
+                    promises.push(result);
+                }
+                if (subscription.once) {
+                    this.off(subscription.id);
+                }
+            }
+            catch (error) {
+                console.error(`Error in event handler for ${type}:`, error);
+            }
+        }
+        if (promises.length > 0) {
+            await Promise.all(promises);
+        }
+    }
+    emitSync(type, data, metadata) {
+        this.emit(type, data, metadata).catch((error) => {
+            console.error(`Error emitting event ${type}:`, error);
+        });
+    }
+    getHistory(filter) {
+        let events = this.eventHistory;
+        if (filter?.type) {
+            events = events.filter((e) => e.type === filter.type);
+        }
+        if (filter?.since) {
+            events = events.filter((e) => e.timestamp >= filter.since);
+        }
+        if (filter?.limit) {
+            events = events.slice(-filter.limit);
+        }
+        return events;
+    }
+    async waitFor(type, timeout, predicate) {
+        return new Promise((resolve, reject) => {
+            let subscriptionId;
+            let timeoutId;
+            const handler = (event) => {
+                if (predicate && !predicate(event)) {
+                    return;
+                }
+                if (timeoutId) {
+                    clearTimeout(timeoutId);
+                }
+                this.off(subscriptionId);
+                resolve(event);
+            };
+            subscriptionId = this.once(type, handler);
+            if (timeout) {
+                timeoutId = setTimeout(() => {
+                    this.off(subscriptionId);
+                    reject(new Error(`Timeout waiting for event: ${type}`));
+                }, timeout);
+            }
+        });
+    }
+    listenerCount(type) {
+        if (type) {
+            const subs = this.subscriptions.get(type) || [];
+            return subs.length + this.wildcardSubscriptions.length;
+        }
+        let total = this.wildcardSubscriptions.length;
+        for (const subs of this.subscriptions.values()) {
+            total += subs.length;
+        }
+        return total;
+    }
+    eventNames() {
+        return Array.from(this.subscriptions.keys());
+    }
+    clearHistory() {
+        this.eventHistory = [];
+    }
+    setMaxHistorySize(size) {
+        this.maxHistorySize = size;
+        if (this.eventHistory.length > size) {
+            this.eventHistory = this.eventHistory.slice(-size);
+        }
+    }
+    getStats() {
+        const subscriptionsByType = {};
+        for (const [type, subs] of this.subscriptions.entries()) {
+            subscriptionsByType[type] = subs.length;
+        }
+        return {
+            totalSubscriptions: this.listenerCount(),
+            subscriptionsByType,
+            wildcardSubscriptions: this.wildcardSubscriptions.length,
+            historySize: this.eventHistory.length,
+            eventTypes: this.eventNames(),
+        };
+    }
+}
+export const globalEvents = new PGAEventEmitter();
+//# sourceMappingURL=EventEmitter.js.map

package/dist/realtime/EventEmitter.js.map

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

package/dist/realtime/StreamingManager.d.ts

@@ -0,0 +1,26 @@
+export interface StreamChunk<T = string> {
+    data: T;
+    index: number;
+    done: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface StreamOptions {
+    bufferSize?: number;
+    chunkDelay?: number;
+    onChunk?: (chunk: StreamChunk) => void;
+    onComplete?: () => void;
+    onError?: (error: Error) => void;
+}
+export declare class StreamingManager {
+    streamText(content: string, options?: StreamOptions): AsyncGenerator<StreamChunk<string>, void, unknown>;
+    streamArray<T>(items: T[], options?: StreamOptions): AsyncGenerator<StreamChunk<T>, void, unknown>;
+    bufferStream<T>(stream: AsyncIterable<StreamChunk<T>>, bufferSize: number): AsyncGenerator<StreamChunk<T[]>, void, unknown>;
+    mapStream<T, U>(stream: AsyncIterable<StreamChunk<T>>, mapper: (data: T) => U | Promise<U>): AsyncGenerator<StreamChunk<U>, void, unknown>;
+    filterStream<T>(stream: AsyncIterable<StreamChunk<T>>, predicate: (data: T) => boolean | Promise<boolean>): AsyncGenerator<StreamChunk<T>, void, unknown>;
+    collectStream<T>(stream: AsyncIterable<StreamChunk<T>>): Promise<T[]>;
+    mergeStreams<T>(...streams: AsyncIterable<StreamChunk<T>>[]): AsyncGenerator<StreamChunk<T>, void, unknown>;
+    takeStream<T>(stream: AsyncIterable<StreamChunk<T>>, count: number): AsyncGenerator<StreamChunk<T>, void, unknown>;
+    rateLimitStream<T>(stream: AsyncIterable<StreamChunk<T>>, maxChunksPerSecond: number): AsyncGenerator<StreamChunk<T>, void, unknown>;
+}
+export declare const globalStreaming: StreamingManager;
+//# sourceMappingURL=StreamingManager.d.ts.map

package/dist/realtime/StreamingManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingManager.d.ts","sourceRoot":"","sources":["../../src/realtime/StreamingManager.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACnC,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,MAAM,WAAW,aAAa;IAI1B,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,UAAU,CAAC,EAAE,MAAM,CAAC;IAKpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IAKvC,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IAKxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACpC;AAOD,qBAAa,gBAAgB;IAIlB,UAAU,CACb,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,aAAkB,GAC5B,cAAc,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAkD9C,WAAW,CAAC,CAAC,EAChB,KAAK,EAAE,CAAC,EAAE,EACV,OAAO,GAAE,aAAkB,GAC5B,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAyCzC,YAAY,CAAC,CAAC,EACjB,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EACrC,UAAU,EAAE,MAAM,GACnB,cAAc,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IA+B3C,SAAS,CAAC,CAAC,EAAE,CAAC,EACjB,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EACrC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GACpC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAkBzC,YAAY,CAAC,CAAC,EACjB,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EACrC,SAAS,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GACnD,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAoB1C,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAapE,YAAY,CAAC,CAAC,EACjB,GAAG,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,GAC5C,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAyBzC,UAAU,CAAC,CAAC,EACf,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EACrC,KAAK,EAAE,MAAM,GACd,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;IAoBzC,eAAe,CAAC,CAAC,EACpB,MAAM,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EACrC,kBAAkB,EAAE,MAAM,GAC3B,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;CAmBnD;AAKD,eAAO,MAAM,eAAe,kBAAyB,CAAC"}