@idevconn/ai-chat-be 0.1.2

package/dist/session/session.service.js

@@ -0,0 +1,161 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionService = exports.InvalidSessionError = exports.SessionLimitError = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const types_1 = require("../types");
+const session_token_1 = require("../utils/session-token");
+const logger_1 = require("../utils/logger");
+class SessionLimitError extends Error {
+    constructor(message = 'Session turn limit reached') {
+        super(message);
+        this.name = 'SessionLimitError';
+    }
+}
+exports.SessionLimitError = SessionLimitError;
+class InvalidSessionError extends Error {
+    constructor(message = 'Invalid or tampered session token') {
+        super(message);
+        this.name = 'InvalidSessionError';
+    }
+}
+exports.InvalidSessionError = InvalidSessionError;
+let SessionService = class SessionService {
+    config;
+    sessions = new Map();
+    maxHistory;
+    ttlMs;
+    maxTurns;
+    secret;
+    allowLegacy;
+    evictionTimer = null;
+    constructor(config) {
+        this.config = config;
+        this.maxHistory = config.session?.maxHistory ?? 50;
+        this.ttlMs = config.session?.ttlMs ?? 30 * 60 * 1000;
+        this.maxTurns = config.limits?.maxTurnsPerSession ?? 30;
+        const explicitSecret = config.sessionSecurity?.secret;
+        const fallback = config.auth?.key;
+        if (!explicitSecret && !fallback) {
+            logger_1.aiChatLogger.warn('SessionService: no sessionSecurity.secret or auth.key configured. Sessions will use a weak ephemeral secret.');
+        }
+        this.secret = explicitSecret || fallback || (0, crypto_1.randomUUID)();
+        this.allowLegacy = config.sessionSecurity?.allowLegacy !== false;
+        this.startEviction();
+    }
+    createSession() {
+        const rawId = (0, crypto_1.randomUUID)();
+        this.sessions.set(rawId, {
+            messages: [],
+            lastActive: Date.now(),
+            turnCount: 0,
+        });
+        return (0, session_token_1.signSessionId)(rawId, this.secret);
+    }
+    resolveToken(token) {
+        const result = (0, session_token_1.verifySessionId)(token, this.secret, this.allowLegacy);
+        if (!result.valid || !result.rawId)
+            return null;
+        return { rawId: result.rawId, legacy: result.legacy === true };
+    }
+    getHistory(token) {
+        const resolved = this.resolveToken(token);
+        if (!resolved)
+            return [];
+        const entry = this.sessions.get(resolved.rawId);
+        if (!entry)
+            return [];
+        entry.lastActive = Date.now();
+        return [...entry.messages];
+    }
+    addMessage(token, message) {
+        const resolved = this.resolveToken(token);
+        if (!resolved) {
+            throw new InvalidSessionError();
+        }
+        let entry = this.sessions.get(resolved.rawId);
+        if (!entry) {
+            if (!resolved.legacy) {
+                throw new InvalidSessionError('Session expired or was deleted. Please start a new conversation.');
+            }
+            entry = { messages: [], lastActive: Date.now(), turnCount: 0 };
+            this.sessions.set(resolved.rawId, entry);
+        }
+        entry.lastActive = Date.now();
+        if (message.role === 'user') {
+            entry.turnCount += 1;
+            if (entry.turnCount > this.maxTurns) {
+                throw new SessionLimitError(`Session turn limit (${this.maxTurns}) reached.`);
+            }
+        }
+        entry.messages.push(message);
+        if (entry.messages.length > this.maxHistory) {
+            const systemMessages = entry.messages.filter((m) => m.role === 'system');
+            const nonSystem = entry.messages.filter((m) => m.role !== 'system');
+            entry.messages = [
+                ...systemMessages,
+                ...nonSystem.slice(-this.maxHistory + systemMessages.length),
+            ];
+        }
+    }
+    deleteSession(token) {
+        const resolved = this.resolveToken(token);
+        if (!resolved)
+            return;
+        this.sessions.delete(resolved.rawId);
+    }
+    hasSession(token) {
+        const resolved = this.resolveToken(token);
+        if (!resolved)
+            return false;
+        return this.sessions.has(resolved.rawId);
+    }
+    hashToken(token) {
+        const resolved = this.resolveToken(token);
+        if (!resolved)
+            return 'invalid';
+        return hashStringFNV(resolved.rawId);
+    }
+    startEviction() {
+        this.evictionTimer = setInterval(() => {
+            const cutoff = Date.now() - this.ttlMs;
+            for (const [id, entry] of this.sessions.entries()) {
+                if (entry.lastActive < cutoff) {
+                    this.sessions.delete(id);
+                }
+            }
+        }, 60_000);
+    }
+    onModuleDestroy() {
+        if (this.evictionTimer) {
+            clearInterval(this.evictionTimer);
+        }
+    }
+};
+exports.SessionService = SessionService;
+exports.SessionService = SessionService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(types_1.AI_CHAT_CONFIG)),
+    __metadata("design:paramtypes", [Object])
+], SessionService);
+function hashStringFNV(s) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < s.length; i++) {
+        h ^= s.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return (h >>> 0).toString(16);
+}
+//# sourceMappingURL=session.service.js.map

package/dist/session/session.service.js.map

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

package/dist/types/chat.types.d.ts

@@ -0,0 +1,31 @@
+export interface ChatMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+export interface ChatTurnInput {
+    sessionId: string;
+    message: string;
+    history: ChatMessage[];
+    ragContext?: string;
+}
+export interface ChatStreamEvent {
+    type: 'token' | 'tool_call' | 'tool_result' | 'done' | 'error';
+    content?: string;
+    usage?: TokenUsage;
+    error?: string;
+}
+export interface TokenUsage {
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+}
+export interface ChatRequestDto {
+    sessionId?: string;
+    message: string;
+}
+export interface StreamOptions {
+    temperature?: number;
+    maxTokens?: number;
+    signal?: AbortSignal;
+}
+//# sourceMappingURL=chat.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chat.types.d.ts","sourceRoot":"","sources":["../../src/types/chat.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB"}

package/dist/types/chat.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=chat.types.js.map

package/dist/types/chat.types.js.map

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

package/dist/types/config.types.d.ts

@@ -0,0 +1,139 @@
+export interface AiChatModuleConfig {
+    provider?: 'gemini' | 'openai' | 'grok' | 'auto' | (string & {});
+    apiKey?: string;
+    model?: string;
+    embeddingModel?: string;
+    baseUrl?: string;
+    retry?: {
+        maxAttempts: number;
+        baseDelayMs: number;
+    };
+    geminiApiKey?: string;
+    geminiModel?: string;
+    openaiApiKey?: string;
+    openaiModel?: string;
+    grokApiKey?: string;
+    grokModel?: string;
+    rag?: RagModuleConfig;
+    auth?: AuthConfig;
+    guards?: GuardsConfig;
+    session?: SessionConfig;
+    systemPrompt?: string;
+    temperature?: number;
+    maxTokens?: number;
+    locale?: string;
+    timezone?: string;
+    intent?: IntentConfig;
+    rateLimit?: RateLimitConfig;
+    output?: OutputConfig;
+    pii?: PiiConfig;
+    sessionSecurity?: SessionSecurityConfig;
+    limits?: HardLimitsConfig;
+    audit?: AuditConfig;
+    moderation?: ModerationConfig;
+    llmInjectionClassifier?: LlmInjectionClassifierConfig;
+    log?: boolean;
+}
+export interface RagModuleConfig {
+    docsPath?: string;
+    topK?: number;
+    chunkSize?: number;
+    embedBatchSize?: number;
+}
+export interface AuthConfig {
+    strategy: 'api-key' | 'jwt' | 'custom';
+    key?: string;
+    jwtSecret?: string;
+    validate?: (token: string) => Promise<boolean>;
+}
+export interface GuardsConfig {
+    promptInjection?: {
+        enabled?: boolean;
+        mode?: 'block' | 'warn';
+    };
+    topicRelevance?: {
+        enabled?: boolean;
+        threshold?: number;
+        fallbackMessage?: string;
+    };
+}
+export interface SessionConfig {
+    maxHistory?: number;
+    ttlMs?: number;
+}
+export interface IntentConfig {
+    enabled?: boolean;
+    strategy?: 'embedding' | 'disabled';
+    threshold?: number;
+    offTopicMessage?: string;
+}
+export interface RateLimitConfig {
+    enabled?: boolean;
+    perKey?: {
+        limit: number;
+        windowMs: number;
+    };
+    perSession?: {
+        limit: number;
+        windowMs: number;
+    };
+    perIp?: {
+        limit: number;
+        windowMs: number;
+    };
+}
+export interface OutputConfig {
+    redactSystemPrompt?: boolean;
+    redactPii?: boolean;
+    customNeedles?: string[];
+}
+export type PiiType = 'email' | 'phone' | 'creditCard' | 'ssn' | 'ipv4';
+export interface PiiConfig {
+    enabled?: boolean;
+    mode?: 'warn' | 'block' | 'redact';
+    types?: PiiType[];
+}
+export interface SessionSecurityConfig {
+    secret?: string;
+    allowLegacy?: boolean;
+}
+export interface HardLimitsConfig {
+    maxInputChars?: number;
+    maxOutputTokens?: number;
+    maxTurnsPerSession?: number;
+}
+export interface AuditEvent {
+    ts: number;
+    sessionHash: string;
+    apiKeyHash: string;
+    inputHash: string;
+    inputLength: number;
+    outputLength: number;
+    intent: 'docs_question' | 'off_topic';
+    injectionFlags: string[];
+    piiTypes: string[];
+    provider: 'gemini' | 'openai' | 'grok' | 'unknown';
+    latencyMs: number;
+    outcome: 'success' | 'error' | 'rate_limited' | 'blocked' | 'off_topic' | 'session_limit' | 'moderated';
+    error?: string;
+}
+export interface AuditConfig {
+    enabled?: boolean;
+    sink?: (event: AuditEvent) => Promise<void> | void;
+}
+export interface ModerationResult {
+    allowed: boolean;
+    reason?: string;
+}
+export interface ModerationConfig {
+    inputFn?: (text: string) => Promise<ModerationResult>;
+    outputFn?: (text: string) => Promise<ModerationResult>;
+}
+export interface LlmInjectionClassifierConfig {
+    enabled?: boolean;
+    model?: string;
+    provider?: 'gemini' | 'openai' | 'grok';
+    threshold?: 'strict' | 'balanced';
+}
+export declare const AI_CHAT_CONFIG: unique symbol;
+//# sourceMappingURL=config.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.d.ts","sourceRoot":"","sources":["../../src/types/config.types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IACjE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IAErD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,GAAG,CAAC,EAAE,eAAe,CAAC;IACtB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,gBAAgB,CAAC;IAC9B,sBAAsB,CAAC,EAAE,4BAA4B,CAAC;IAEtD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,SAAS,GAAG,KAAK,GAAG,QAAQ,CAAC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAED,MAAM,WAAW,YAAY;IAC3B,eAAe,CAAC,EAAE;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;KACzB,CAAC;IACF,cAAc,CAAC,EAAE;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,WAAW,GAAG,UAAU,CAAC;IACpC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,UAAU,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACjD,KAAK,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,YAAY;IAC3B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,KAAK,GAAG,MAAM,CAAC;AAExE,MAAM,WAAW,SAAS;IACxB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,eAAe,GAAG,WAAW,CAAC;IACtC,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,QAAQ,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EACH,SAAS,GACT,OAAO,GACP,cAAc,GACd,SAAS,GACT,WAAW,GACX,eAAe,GACf,WAAW,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACpD;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACtD,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,4BAA4B;IAC3C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;IACxC,SAAS,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;CACnC;AAED,eAAO,MAAM,cAAc,eAA2B,CAAC"}

package/dist/types/config.types.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AI_CHAT_CONFIG = void 0;
+exports.AI_CHAT_CONFIG = Symbol('AI_CHAT_CONFIG');
+//# sourceMappingURL=config.types.js.map

package/dist/types/config.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.types.js","sourceRoot":"","sources":["../../src/types/config.types.ts"],"names":[],"mappings":";;;AA0Ja,QAAA,cAAc,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,4 @@
+export * from './config.types';
+export * from './chat.types';
+export * from './provider.types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./config.types"), exports);
+__exportStar(require("./chat.types"), exports);
+__exportStar(require("./provider.types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,+CAA6B;AAC7B,mDAAiC"}

package/dist/types/provider.types.d.ts

@@ -0,0 +1,15 @@
+import { ChatMessage, ChatStreamEvent, StreamOptions } from './chat.types';
+export type ProviderId = 'gemini' | 'openai' | 'grok';
+export interface ILlmProvider {
+    readonly id: ProviderId;
+    readonly supportsEmbedding: boolean;
+    chatStream(messages: ChatMessage[], options?: StreamOptions): AsyncGenerator<ChatStreamEvent>;
+    embed?(texts: string[]): Promise<number[][]>;
+}
+export interface ProviderConfig {
+    apiKey: string;
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}
+//# sourceMappingURL=provider.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"provider.types.d.ts","sourceRoot":"","sources":["../../src/types/provider.types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3E,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEtD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,UAAU,CAAC;IACxB,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IAEpC,UAAU,CAAC,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;IAE9F,KAAK,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB"}

package/dist/types/provider.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=provider.types.js.map

package/dist/types/provider.types.js.map

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

package/dist/utils/cosine-similarity.d.ts

@@ -0,0 +1,2 @@
+export declare function cosineSimilarity(a: number[], b: number[]): number;
+//# sourceMappingURL=cosine-similarity.d.ts.map

package/dist/utils/cosine-similarity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine-similarity.d.ts","sourceRoot":"","sources":["../../src/utils/cosine-similarity.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAmBjE"}

package/dist/utils/cosine-similarity.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cosineSimilarity = cosineSimilarity;
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length) {
+        throw new Error(`Vector dimension mismatch: ${a.length} vs ${b.length}`);
+    }
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += a[i] * b[i];
+        normA += a[i] * a[i];
+        normB += b[i] * b[i];
+    }
+    const denominator = Math.sqrt(normA) * Math.sqrt(normB);
+    if (denominator === 0)
+        return 0;
+    return dot / denominator;
+}
+//# sourceMappingURL=cosine-similarity.js.map

package/dist/utils/cosine-similarity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cosine-similarity.js","sourceRoot":"","sources":["../../src/utils/cosine-similarity.ts"],"names":[],"mappings":";;AAAA,4CAmBC;AAnBD,SAAgB,gBAAgB,CAAC,CAAW,EAAE,CAAW;IACvD,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACvB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,OAAO,GAAG,GAAG,WAAW,CAAC;AAC3B,CAAC"}

package/dist/utils/error-sanitizer.d.ts

@@ -0,0 +1,8 @@
+export type ClientErrorCode = 'PROVIDER_ERROR' | 'RATE_LIMITED' | 'BAD_REQUEST' | 'TIMEOUT' | 'BLOCKED' | 'OFF_TOPIC' | 'SESSION_LIMIT' | 'MODERATED' | 'INTERNAL_ERROR';
+export interface SanitizedError {
+    code: ClientErrorCode;
+    message: string;
+}
+export declare function sanitizeError(err: unknown): SanitizedError;
+export declare function code(c: ClientErrorCode, override?: string): SanitizedError;
+//# sourceMappingURL=error-sanitizer.d.ts.map

package/dist/utils/error-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-sanitizer.d.ts","sourceRoot":"","sources":["../../src/utils/error-sanitizer.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GACvB,gBAAgB,GAChB,cAAc,GACd,aAAa,GACb,SAAS,GACT,SAAS,GACT,WAAW,GACX,eAAe,GACf,WAAW,GACX,gBAAgB,CAAC;AAErB,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,eAAe,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AAkBD,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,CA+B1D;AAED,wBAAgB,IAAI,CAAC,CAAC,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,cAAc,CAE1E"}

package/dist/utils/error-sanitizer.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sanitizeError = sanitizeError;
+exports.code = code;
+const GENERIC_MESSAGES = {
+    PROVIDER_ERROR: 'The AI provider returned an error. Please try again.',
+    RATE_LIMITED: 'Too many requests. Please slow down and try again.',
+    BAD_REQUEST: 'The request was invalid. Please rephrase and try again.',
+    TIMEOUT: 'The request took too long. Please try again.',
+    BLOCKED: 'The request was blocked by a security filter.',
+    OFF_TOPIC: 'I can only help with questions about the loaded documentation.',
+    SESSION_LIMIT: 'Session limit reached. Please start a new conversation.',
+    MODERATED: 'The response was withheld by the moderation policy.',
+    INTERNAL_ERROR: 'An internal error occurred. Please try again later.',
+};
+function sanitizeError(err) {
+    if (!err)
+        return code('INTERNAL_ERROR');
+    const message = (err instanceof Error ? err.message : String(err)).toLowerCase();
+    const name = err instanceof Error ? err.name : '';
+    if (name === 'AbortError' || /timeout|timed out|deadline/i.test(message)) {
+        return code('TIMEOUT');
+    }
+    if (/\b429\b|rate[-_ ]?limit|too many requests|quota/i.test(message)) {
+        return code('RATE_LIMITED');
+    }
+    if (/\b400\b|invalid|validation|malformed|bad request/i.test(message)) {
+        return code('BAD_REQUEST');
+    }
+    if (name === 'SessionLimitError' || /session.*(limit|quota)/i.test(message)) {
+        return code('SESSION_LIMIT');
+    }
+    if (/(blocked|forbidden)/i.test(message)) {
+        return code('BLOCKED');
+    }
+    if (/\bapi\b|provider|gemini|openai|grok|model|completion/i.test(message)) {
+        return code('PROVIDER_ERROR');
+    }
+    return code('INTERNAL_ERROR');
+}
+function code(c, override) {
+    return { code: c, message: override ?? GENERIC_MESSAGES[c] };
+}
+//# sourceMappingURL=error-sanitizer.js.map

package/dist/utils/error-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-sanitizer.js","sourceRoot":"","sources":["../../src/utils/error-sanitizer.ts"],"names":[],"mappings":";;AAgCA,sCA+BC;AAED,oBAEC;AAnDD,MAAM,gBAAgB,GAAoC;IACxD,cAAc,EAAE,sDAAsD;IACtE,YAAY,EAAE,oDAAoD;IAClE,WAAW,EAAE,yDAAyD;IACtE,OAAO,EAAE,8CAA8C;IACvD,OAAO,EAAE,+CAA+C;IACxD,SAAS,EAAE,gEAAgE;IAC3E,aAAa,EAAE,yDAAyD;IACxE,SAAS,EAAE,qDAAqD;IAChE,cAAc,EAAE,qDAAqD;CACtE,CAAC;AAMF,SAAgB,aAAa,CAAC,GAAY;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAExC,MAAM,OAAO,GAAG,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IACjF,MAAM,IAAI,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAElD,IAAI,IAAI,KAAK,YAAY,IAAI,6BAA6B,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,kDAAkD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC,cAAc,CAAC,CAAC;IAC9B,CAAC;IAED,IAAI,mDAAmD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACtE,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,IAAI,KAAK,mBAAmB,IAAI,yBAAyB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,CAAC,eAAe,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,uDAAuD,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,IAAI,CAAC,gBAAgB,CAAC,CAAC;AAChC,CAAC;AAED,SAAgB,IAAI,CAAC,CAAkB,EAAE,QAAiB;IACxD,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,QAAQ,IAAI,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,6 @@
+export * from './retry';
+export * from './cosine-similarity';
+export * from './text';
+export * from './sse-parser';
+export * from './logger';
+//# 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,SAAS,CAAC;AACxB,cAAc,qBAAqB,CAAC;AACpC,cAAc,QAAQ,CAAC;AACvB,cAAc,cAAc,CAAC;AAC7B,cAAc,UAAU,CAAC"}

package/dist/utils/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./retry"), exports);
+__exportStar(require("./cosine-similarity"), exports);
+__exportStar(require("./text"), exports);
+__exportStar(require("./sse-parser"), exports);
+__exportStar(require("./logger"), exports);
+//# 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,0CAAwB;AACxB,sDAAoC;AACpC,yCAAuB;AACvB,+CAA6B;AAC7B,2CAAyB"}

package/dist/utils/logger.d.ts

@@ -0,0 +1,11 @@
+import { Logger } from '@nestjs/common';
+export declare const aiChatLogger: Logger;
+export declare function setBootLogsEnabled(enabled: boolean): void;
+export declare function logBoot(message: string): void;
+export declare function logBootWarn(message: string): void;
+export declare function logBootError(message: string): void;
+export declare function logProviderDisabled(provider: string, reason: string): void;
+export declare function logProviderEnabled(provider: string, model: string): void;
+export declare function logStreamError(provider: string, error: unknown): void;
+export declare function logRagLoaded(chunkCount: number, fileCount: number, resolvedPath: string): void;
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,eAAO,MAAM,YAAY,QAAuB,CAAC;AAMjD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEzD;AAED,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAG7C;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGjD;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAGlD;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAE1E;AAED,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAExE;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAGrE;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAE9F"}

package/dist/utils/logger.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiChatLogger = void 0;
+exports.setBootLogsEnabled = setBootLogsEnabled;
+exports.logBoot = logBoot;
+exports.logBootWarn = logBootWarn;
+exports.logBootError = logBootError;
+exports.logProviderDisabled = logProviderDisabled;
+exports.logProviderEnabled = logProviderEnabled;
+exports.logStreamError = logStreamError;
+exports.logRagLoaded = logRagLoaded;
+const common_1 = require("@nestjs/common");
+exports.aiChatLogger = new common_1.Logger('AiChat');
+const BOOT_PREFIX = '[AiChat]';
+let bootLogsEnabled = true;
+function setBootLogsEnabled(enabled) {
+    bootLogsEnabled = enabled;
+}
+function logBoot(message) {
+    if (!bootLogsEnabled)
+        return;
+    console.log(`${BOOT_PREFIX} ${message}`);
+}
+function logBootWarn(message) {
+    if (!bootLogsEnabled)
+        return;
+    console.warn(`${BOOT_PREFIX} WARN ${message}`);
+}
+function logBootError(message) {
+    if (!bootLogsEnabled)
+        return;
+    console.error(`${BOOT_PREFIX} ERROR ${message}`);
+}
+function logProviderDisabled(provider, reason) {
+    logBootWarn(`${provider} provider disabled: ${reason}`);
+}
+function logProviderEnabled(provider, model) {
+    logBoot(`${provider} provider enabled (model: ${model})`);
+}
+function logStreamError(provider, error) {
+    const message = error instanceof Error ? error.message : String(error);
+    exports.aiChatLogger.error(`Stream error from ${provider}: ${message}`);
+}
+function logRagLoaded(chunkCount, fileCount, resolvedPath) {
+    logBoot(`RAG loaded: ${chunkCount} chunks from ${fileCount} documents (from ${resolvedPath})`);
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAQA,gDAEC;AAED,0BAGC;AAED,kCAGC;AAED,oCAGC;AAED,kDAEC;AAED,gDAEC;AAED,wCAGC;AAED,oCAEC;AA1CD,2CAAwC;AAE3B,QAAA,YAAY,GAAG,IAAI,eAAM,CAAC,QAAQ,CAAC,CAAC;AAEjD,MAAM,WAAW,GAAG,UAAU,CAAC;AAE/B,IAAI,eAAe,GAAG,IAAI,CAAC;AAE3B,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,eAAe,GAAG,OAAO,CAAC;AAC5B,CAAC;AAED,SAAgB,OAAO,CAAC,OAAe;IACrC,IAAI,CAAC,eAAe;QAAE,OAAO;IAC7B,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,IAAI,OAAO,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAgB,WAAW,CAAC,OAAe;IACzC,IAAI,CAAC,eAAe;QAAE,OAAO;IAC7B,OAAO,CAAC,IAAI,CAAC,GAAG,WAAW,SAAS,OAAO,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,SAAgB,YAAY,CAAC,OAAe;IAC1C,IAAI,CAAC,eAAe;QAAE,OAAO;IAC7B,OAAO,CAAC,KAAK,CAAC,GAAG,WAAW,UAAU,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,SAAgB,mBAAmB,CAAC,QAAgB,EAAE,MAAc;IAClE,WAAW,CAAC,GAAG,QAAQ,uBAAuB,MAAM,EAAE,CAAC,CAAC;AAC1D,CAAC;AAED,SAAgB,kBAAkB,CAAC,QAAgB,EAAE,KAAa;IAChE,OAAO,CAAC,GAAG,QAAQ,6BAA6B,KAAK,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,SAAgB,cAAc,CAAC,QAAgB,EAAE,KAAc;IAC7D,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvE,oBAAY,CAAC,KAAK,CAAC,qBAAqB,QAAQ,KAAK,OAAO,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAgB,YAAY,CAAC,UAAkB,EAAE,SAAiB,EAAE,YAAoB;IACtF,OAAO,CAAC,eAAe,UAAU,gBAAgB,SAAS,oBAAoB,YAAY,GAAG,CAAC,CAAC;AACjG,CAAC"}