swift-skills 0.0.1

package/build/tools/index.js

@@ -0,0 +1,18 @@
+// src/tools/index.ts - Barrel export for tool handlers
+export * from './types.js';
+export * from './registry.js';
+// Register handlers on import
+import { registerHandler } from './registry.js';
+import { getSwiftPatternHandler } from './handlers/getSwiftPattern.js';
+import { searchSwiftContentHandler } from './handlers/searchSwiftContent.js';
+import { listContentSourcesHandler } from './handlers/listContentSources.js';
+import { enableSourceHandler } from './handlers/enableSource.js';
+import { setupPatreonHandler } from './handlers/setupPatreon.js';
+import { getPatreonPatternsHandler } from './handlers/getPatreonPatterns.js';
+registerHandler('get_swift_pattern', getSwiftPatternHandler);
+registerHandler('search_swift_content', searchSwiftContentHandler);
+registerHandler('list_content_sources', listContentSourcesHandler);
+registerHandler('enable_source', enableSourceHandler);
+registerHandler('setup_patreon', setupPatreonHandler);
+registerHandler('get_patreon_patterns', getPatreonPatternsHandler);
+//# sourceMappingURL=index.js.map

package/build/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAE9B,8BAA8B;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAE7E,eAAe,CAAC,mBAAmB,EAAE,sBAAsB,CAAC,CAAC;AAC7D,eAAe,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAAC;AACnE,eAAe,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAAC;AACnE,eAAe,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;AACtD,eAAe,CAAC,eAAe,EAAE,mBAAmB,CAAC,CAAC;AACtD,eAAe,CAAC,sBAAsB,EAAE,yBAAyB,CAAC,CAAC"}

package/build/tools/registry.d.ts

@@ -0,0 +1,14 @@
+import type { ToolHandler } from './types.js';
+/**
+ * Register a tool handler by name
+ */
+export declare function registerHandler(name: string, handler: ToolHandler): void;
+/**
+ * Get a registered handler by name
+ */
+export declare function getHandler(name: string): ToolHandler | undefined;
+/**
+ * Check if a handler is registered
+ */
+export declare function hasHandler(name: string): boolean;
+//# sourceMappingURL=registry.d.ts.map

package/build/tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEhD"}

package/build/tools/registry.js

@@ -0,0 +1,21 @@
+// src/tools/registry.ts
+const handlers = new Map();
+/**
+ * Register a tool handler by name
+ */
+export function registerHandler(name, handler) {
+    handlers.set(name, handler);
+}
+/**
+ * Get a registered handler by name
+ */
+export function getHandler(name) {
+    return handlers.get(name);
+}
+/**
+ * Check if a handler is registered
+ */
+export function hasHandler(name) {
+    return handlers.has(name);
+}
+//# sourceMappingURL=registry.js.map

package/build/tools/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,wBAAwB;AAIxB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEhD;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAoB;IAChE,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/build/tools/registry.test.d.ts

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

package/build/tools/registry.test.d.ts.map

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

package/build/tools/registry.test.js

@@ -0,0 +1,54 @@
+// src/tools/registry.test.ts
+import { describe, it, expect } from 'vitest';
+// We need to test the registry in isolation, so we'll create a fresh module
+// Since the registry uses module-level state, we test the exported functions
+describe('Tool Registry', () => {
+    // Import fresh for each test to avoid state pollution
+    // In practice, the registry is populated at startup
+    it('should register and retrieve handlers', async () => {
+        const { registerHandler, getHandler } = await import('./registry.js');
+        const mockHandler = async () => ({ content: [{ type: 'text', text: 'test' }] });
+        registerHandler('test_tool', mockHandler);
+        const retrieved = getHandler('test_tool');
+        expect(retrieved).toBe(mockHandler);
+    });
+    it('should return undefined for unregistered handlers', async () => {
+        const { getHandler } = await import('./registry.js');
+        const result = getHandler('nonexistent_tool_12345');
+        expect(result).toBeUndefined();
+    });
+    it('should correctly report handler existence', async () => {
+        const { registerHandler, hasHandler } = await import('./registry.js');
+        const mockHandler = async () => ({ content: [{ type: 'text', text: 'test' }] });
+        registerHandler('exists_tool', mockHandler);
+        expect(hasHandler('exists_tool')).toBe(true);
+        expect(hasHandler('does_not_exist_12345')).toBe(false);
+    });
+    it('should allow overwriting handlers', async () => {
+        const { registerHandler, getHandler } = await import('./registry.js');
+        const handler1 = async () => ({ content: [{ type: 'text', text: 'first' }] });
+        const handler2 = async () => ({ content: [{ type: 'text', text: 'second' }] });
+        registerHandler('overwrite_test', handler1);
+        registerHandler('overwrite_test', handler2);
+        const retrieved = getHandler('overwrite_test');
+        expect(retrieved).toBe(handler2);
+    });
+});
+describe('Tool Registration Integration', () => {
+    it('should have core tools registered after import', async () => {
+        // Importing index.js registers all handlers
+        await import('./index.js');
+        const { hasHandler } = await import('./registry.js');
+        expect(hasHandler('get_swift_pattern')).toBe(true);
+        expect(hasHandler('search_swift_content')).toBe(true);
+        expect(hasHandler('list_content_sources')).toBe(true);
+        expect(hasHandler('enable_source')).toBe(true);
+    });
+    it('should return valid handler functions', async () => {
+        await import('./index.js');
+        const { getHandler } = await import('./registry.js');
+        const handler = getHandler('get_swift_pattern');
+        expect(typeof handler).toBe('function');
+    });
+});
+//# sourceMappingURL=registry.test.js.map

package/build/tools/registry.test.js.map

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

package/build/tools/types.d.ts

@@ -0,0 +1,67 @@
+import type SourceManager from '../config/sources.js';
+/**
+ * Pattern returned by Patreon source
+ */
+export interface PatreonPattern {
+    id: string;
+    title: string;
+    url: string;
+    publishDate: string;
+    excerpt: string;
+    content: string;
+    creator: string;
+    topics: string[];
+    relevanceScore: number;
+    hasCode: boolean;
+}
+/**
+ * Creator info from Patreon
+ */
+export interface CreatorInfo {
+    id: string;
+    name: string;
+    url: string;
+    isSwiftRelated: boolean;
+}
+/**
+ * Interface for PatreonSource class instances
+ */
+export interface PatreonSourceInstance {
+    isConfigured(): Promise<boolean>;
+    isAvailable(): boolean;
+    getSubscribedCreators(): Promise<CreatorInfo[]>;
+    detectSwiftCreators(): Promise<CreatorInfo[]>;
+    fetchPatterns(creatorId?: string): Promise<PatreonPattern[]>;
+    searchPatterns(query: string): Promise<PatreonPattern[]>;
+    saveEnabledCreators(creatorIds: string[]): void;
+}
+/**
+ * Constructor type for PatreonSource class
+ */
+export interface PatreonSourceConstructor {
+    new (): PatreonSourceInstance;
+}
+/**
+ * Context passed to tool handlers
+ */
+export interface ToolContext {
+    sourceManager: SourceManager;
+    patreonSource: PatreonSourceConstructor | null;
+}
+/**
+ * Tool response format matching MCP SDK expectations
+ * Index signature allows additional SDK-required properties
+ */
+export interface ToolResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Handler function type for MCP tools
+ */
+export type ToolHandler = (args: Record<string, unknown>, context: ToolContext) => Promise<ToolResponse>;
+//# sourceMappingURL=types.d.ts.map

package/build/tools/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,aAAa,MAAM,sBAAsB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,WAAW,IAAI,OAAO,CAAC;IACvB,qBAAqB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,mBAAmB,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC9C,aAAa,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC7D,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IACzD,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;CACjD;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,qBAAqB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,aAAa,CAAC;IAC7B,aAAa,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAChD;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,YAAY,CAAC,CAAC"}

package/build/tools/types.js

@@ -0,0 +1,3 @@
+// src/tools/types.ts
+export {};
+//# sourceMappingURL=types.js.map

package/build/tools/types.js.map

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

package/build/utils/cache.d.ts

@@ -0,0 +1,20 @@
+export declare class FileCache {
+    private cacheDir;
+    private memoryCache;
+    private inFlightFetches;
+    private cleanupInterval;
+    constructor(namespace?: string, maxMemoryEntries?: number);
+    private startPeriodicCleanup;
+    private ensureCacheDir;
+    private getCacheKey;
+    private getCachePath;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, data: T, ttl?: number): Promise<void>;
+    getOrFetch<T>(key: string, fetcher: () => Promise<T>, ttl?: number): Promise<T>;
+    private isExpired;
+    clear(): void;
+    clearExpired(): number;
+}
+export declare const rssCache: FileCache;
+export declare const articleCache: FileCache;
+//# sourceMappingURL=cache.d.ts.map

package/build/utils/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAkBA,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAwC;IAC3D,OAAO,CAAC,eAAe,CAA4C;IACnE,OAAO,CAAC,eAAe,CAA+C;gBAE1D,SAAS,GAAE,MAAkB,EAAE,gBAAgB,GAAE,MAAmC;IAUhG,OAAO,CAAC,oBAAoB;IAU5B,OAAO,CAAC,cAAc;IAMtB,OAAO,CAAC,WAAW;IASnB,OAAO,CAAC,YAAY;IAId,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAkCtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,EAAE,GAAG,GAAE,MAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBtE,UAAU,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,GAAE,MAAoB,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BlG,OAAO,CAAC,SAAS;IAKjB,KAAK,IAAI,IAAI;IAiBb,YAAY,IAAI,MAAM;CAqCvB;AAGD,eAAO,MAAM,QAAQ,WAAuB,CAAC;AAC7C,eAAO,MAAM,YAAY,WAA4B,CAAC"}

package/build/utils/cache.js

@@ -0,0 +1,186 @@
+// src/utils/cache.ts
+import fs from 'fs';
+import path from 'path';
+import { createHash } from 'crypto';
+import QuickLRU from 'quick-lru';
+import { getCacheDir } from './paths.js';
+const DEFAULT_TTL = 86400; // 24 hours in seconds
+const DEFAULT_MAX_MEMORY_ENTRIES = 100;
+const CLEANUP_INTERVAL_MS = 60 * 60 * 1000; // 1 hour
+export class FileCache {
+    cacheDir;
+    memoryCache;
+    inFlightFetches = new Map();
+    cleanupInterval = null;
+    constructor(namespace = 'default', maxMemoryEntries = DEFAULT_MAX_MEMORY_ENTRIES) {
+        this.cacheDir = getCacheDir(namespace);
+        this.memoryCache = new QuickLRU({ maxSize: maxMemoryEntries });
+        this.ensureCacheDir();
+        // Clean expired entries on startup
+        this.clearExpired();
+        // Start periodic cleanup
+        this.startPeriodicCleanup();
+    }
+    startPeriodicCleanup() {
+        // Avoid multiple intervals if constructor is called multiple times
+        if (this.cleanupInterval)
+            return;
+        this.cleanupInterval = setInterval(() => {
+            this.clearExpired();
+        }, CLEANUP_INTERVAL_MS);
+        // Don't keep the process alive just for cleanup
+        this.cleanupInterval.unref();
+    }
+    ensureCacheDir() {
+        if (!fs.existsSync(this.cacheDir)) {
+            fs.mkdirSync(this.cacheDir, { recursive: true });
+        }
+    }
+    getCacheKey(key) {
+        // Hash long keys to avoid filesystem issues
+        if (key.length > 100) {
+            return createHash('md5').update(key).digest('hex');
+        }
+        // Sanitize key for filesystem
+        return key.replace(/[^a-zA-Z0-9-_]/g, '_');
+    }
+    getCachePath(key) {
+        return path.join(this.cacheDir, `${this.getCacheKey(key)}.json`);
+    }
+    async get(key) {
+        // Check memory cache first
+        const memEntry = this.memoryCache.get(key);
+        if (memEntry) {
+            if (!this.isExpired(memEntry)) {
+                return memEntry.data;
+            }
+            // Remove expired entry from memory cache
+            this.memoryCache.delete(key);
+        }
+        // Check file cache
+        const cachePath = this.getCachePath(key);
+        try {
+            if (fs.existsSync(cachePath)) {
+                const content = fs.readFileSync(cachePath, 'utf-8');
+                const entry = JSON.parse(content);
+                if (!this.isExpired(entry)) {
+                    // Populate memory cache
+                    this.memoryCache.set(key, entry);
+                    return entry.data;
+                }
+                else {
+                    // Clean up expired entry
+                    fs.unlinkSync(cachePath);
+                }
+            }
+        }
+        catch {
+            // Cache read failed, return null
+        }
+        return null;
+    }
+    async set(key, data, ttl = DEFAULT_TTL) {
+        const now = Date.now();
+        const entry = {
+            data,
+            timestamp: now,
+            ttl,
+        };
+        // Set in memory cache
+        this.memoryCache.set(key, entry);
+        // Set in file cache
+        const cachePath = this.getCachePath(key);
+        try {
+            fs.writeFileSync(cachePath, JSON.stringify(entry));
+        }
+        catch {
+            // Cache write failed, continue without caching
+        }
+    }
+    async getOrFetch(key, fetcher, ttl = DEFAULT_TTL) {
+        // Check cache first
+        const cached = await this.get(key);
+        if (cached !== null) {
+            return cached;
+        }
+        // Check if a fetch is already in progress for this key
+        const inFlight = this.inFlightFetches.get(key);
+        if (inFlight) {
+            return inFlight;
+        }
+        // Start a new fetch and track it
+        const fetchPromise = (async () => {
+            try {
+                const data = await fetcher();
+                await this.set(key, data, ttl);
+                return data;
+            }
+            finally {
+                // Remove from in-flight map when complete (success or failure)
+                this.inFlightFetches.delete(key);
+            }
+        })();
+        this.inFlightFetches.set(key, fetchPromise);
+        return fetchPromise;
+    }
+    isExpired(entry) {
+        const age = (Date.now() - entry.timestamp) / 1000; // age in seconds
+        return age > entry.ttl;
+    }
+    clear() {
+        // Clear memory cache
+        this.memoryCache.clear();
+        // Clear file cache
+        try {
+            if (fs.existsSync(this.cacheDir)) {
+                const files = fs.readdirSync(this.cacheDir);
+                for (const file of files) {
+                    fs.unlinkSync(path.join(this.cacheDir, file));
+                }
+            }
+        }
+        catch {
+            // Ignore errors during clear
+        }
+    }
+    clearExpired() {
+        let cleared = 0;
+        // Clear expired from memory
+        for (const [key, entry] of this.memoryCache) {
+            if (this.isExpired(entry)) {
+                this.memoryCache.delete(key);
+                cleared++;
+            }
+        }
+        // Clear expired from files
+        try {
+            if (fs.existsSync(this.cacheDir)) {
+                const files = fs.readdirSync(this.cacheDir);
+                for (const file of files) {
+                    const filePath = path.join(this.cacheDir, file);
+                    try {
+                        const content = fs.readFileSync(filePath, 'utf-8');
+                        const entry = JSON.parse(content);
+                        if (this.isExpired(entry)) {
+                            fs.unlinkSync(filePath);
+                            cleared++;
+                        }
+                    }
+                    catch {
+                        // Remove corrupted cache files
+                        fs.unlinkSync(filePath);
+                        cleared++;
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore errors during cleanup
+        }
+        return cleared;
+    }
+}
+// Shared cache instances
+export const rssCache = new FileCache('rss');
+export const articleCache = new FileCache('articles');
+//# sourceMappingURL=cache.js.map

package/build/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../src/utils/cache.ts"],"names":[],"mappings":"AAAA,qBAAqB;AAErB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,sBAAsB;AACjD,MAAM,0BAA0B,GAAG,GAAG,CAAC;AACvC,MAAM,mBAAmB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,SAAS;AAQrD,MAAM,OAAO,SAAS;IACZ,QAAQ,CAAS;IACjB,WAAW,CAAwC;IACnD,eAAe,GAAkC,IAAI,GAAG,EAAE,CAAC;IAC3D,eAAe,GAA0C,IAAI,CAAC;IAEtE,YAAY,YAAoB,SAAS,EAAE,mBAA2B,0BAA0B;QAC9F,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,CAAC,WAAW,GAAG,IAAI,QAAQ,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,mCAAmC;QACnC,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,yBAAyB;QACzB,IAAI,CAAC,oBAAoB,EAAE,CAAC;IAC9B,CAAC;IAEO,oBAAoB;QAC1B,mEAAmE;QACnE,IAAI,IAAI,CAAC,eAAe;YAAE,OAAO;QACjC,IAAI,CAAC,eAAe,GAAG,WAAW,CAAC,GAAG,EAAE;YACtC,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,CAAC,EAAE,mBAAmB,CAAC,CAAC;QACxB,gDAAgD;QAChD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAEO,cAAc;QACpB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,GAAW;QAC7B,4CAA4C;QAC5C,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YACrB,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrD,CAAC;QACD,8BAA8B;QAC9B,OAAO,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;IAEO,YAAY,CAAC,GAAW;QAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,2BAA2B;QAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAA8B,CAAC;QACxE,IAAI,QAAQ,EAAE,CAAC;YACb,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,OAAO,QAAQ,CAAC,IAAI,CAAC;YACvB,CAAC;YACD,yCAAyC;YACzC,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;QAED,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;gBACpD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAkB,CAAC;gBAEnD,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;oBAC3B,wBAAwB;oBACxB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;oBACjC,OAAO,KAAK,CAAC,IAAI,CAAC;gBACpB,CAAC;qBAAM,CAAC;oBACN,yBAAyB;oBACzB,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;gBAC3B,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;QACnC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,IAAO,EAAE,MAAc,WAAW;QAC1D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAkB;YAC3B,IAAI;YACJ,SAAS,EAAE,GAAG;YACd,GAAG;SACJ,CAAC;QAEF,sBAAsB;QACtB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAEjC,oBAAoB;QACpB,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC;YACH,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QACrD,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAI,GAAW,EAAE,OAAyB,EAAE,MAAc,WAAW;QACnF,oBAAoB;QACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAI,GAAG,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,uDAAuD;QACvD,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAA2B,CAAC;QACzE,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,iCAAiC;QACjC,MAAM,YAAY,GAAG,CAAC,KAAK,IAAI,EAAE;YAC/B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,OAAO,EAAE,CAAC;gBAC7B,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;gBAC/B,OAAO,IAAI,CAAC;YACd,CAAC;oBAAS,CAAC;gBACT,+DAA+D;gBAC/D,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACnC,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;QAC5C,OAAO,YAAY,CAAC;IACtB,CAAC;IAEO,SAAS,CAAC,KAA0B;QAC1C,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAC,iBAAiB;QACpE,OAAO,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC;IACzB,CAAC;IAED,KAAK;QACH,qBAAqB;QACrB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;QAEzB,mBAAmB;QACnB,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;gBAChD,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,6BAA6B;QAC/B,CAAC;IACH,CAAC;IAED,YAAY;QACV,IAAI,OAAO,GAAG,CAAC,CAAC;QAEhB,4BAA4B;QAC5B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7B,OAAO,EAAE,CAAC;YACZ,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,CAAC;YACH,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACjC,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;oBACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;oBAChD,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;wBACnD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAwB,CAAC;wBACzD,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;4BAC1B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;4BACxB,OAAO,EAAE,CAAC;wBACZ,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,+BAA+B;wBAC/B,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;wBACxB,OAAO,EAAE,CAAC;oBACZ,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,+BAA+B;QACjC,CAAC;QAED,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,yBAAyB;AACzB,MAAM,CAAC,MAAM,QAAQ,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,SAAS,CAAC,UAAU,CAAC,CAAC"}

package/build/utils/concurrency.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Concurrency utilities for parallel processing
+ */
+/**
+ * Run async operations with a concurrency limit
+ * @param items - Array of items to process
+ * @param limit - Maximum number of concurrent operations (must be positive finite number)
+ * @param worker - Function to process each item
+ * @returns Promise resolving to array of results in same order as input
+ * @throws Error if limit is not a positive finite number
+ */
+export declare function runWithConcurrency<T, R>(items: T[], limit: number, worker: (item: T) => Promise<R>): Promise<R[]>;
+//# sourceMappingURL=concurrency.d.ts.map

package/build/utils/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,CAAC,EAAE,EACV,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC9B,OAAO,CAAC,CAAC,EAAE,CAAC,CA8Bd"}

package/build/utils/concurrency.js

@@ -0,0 +1,33 @@
+/**
+ * Concurrency utilities for parallel processing
+ */
+/**
+ * Run async operations with a concurrency limit
+ * @param items - Array of items to process
+ * @param limit - Maximum number of concurrent operations (must be positive finite number)
+ * @param worker - Function to process each item
+ * @returns Promise resolving to array of results in same order as input
+ * @throws Error if limit is not a positive finite number
+ */
+export async function runWithConcurrency(items, limit, worker) {
+    if (items.length === 0) {
+        return [];
+    }
+    // Validate limit is a positive finite number
+    if (!Number.isFinite(limit) || limit <= 0 || !Number.isInteger(limit)) {
+        throw new Error(`Invalid concurrency limit: ${limit}. Must be a positive finite integer, got ${typeof limit === 'number' ? limit : typeof limit}`);
+    }
+    const results = new Array(items.length);
+    let nextIndex = 0;
+    const runWorker = async () => {
+        while (nextIndex < items.length) {
+            const currentIndex = nextIndex++;
+            // Worker function should handle errors appropriately
+            results[currentIndex] = await worker(items[currentIndex]);
+        }
+    };
+    const workers = Array.from({ length: Math.min(limit, items.length) }, () => runWorker());
+    await Promise.all(workers);
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/build/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAU,EACV,KAAa,EACb,MAA+B;IAE/B,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,6CAA6C;IAC7C,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,KAAK,CACb,8BAA8B,KAAK,4CAA4C,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,EAAE,CAClI,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,MAAM,SAAS,GAAG,KAAK,IAAmB,EAAE;QAC1C,OAAO,SAAS,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAChC,MAAM,YAAY,GAAG,SAAS,EAAE,CAAC;YACjC,qDAAqD;YACrD,OAAO,CAAC,YAAY,CAAC,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5D,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CACxB,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EACzC,GAAG,EAAE,CAAC,SAAS,EAAE,CAClB,CAAC;IAEF,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/build/utils/errors.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Error handling utilities for consistent error logging across the codebase.
+ * Uses structured logger to keep output consistent.
+ */
+/**
+ * Type guard to check if a value is an Error instance.
+ */
+export declare function isError(value: unknown): value is Error;
+/**
+ * Safely extracts an error message from any thrown value.
+ * Returns error.message if Error, String(error) otherwise.
+ */
+export declare function toErrorMessage(error: unknown): string;
+/**
+ * Logs an error with context prefix and optional details.
+ * Format: [context] message { details }
+ */
+export declare function logError(context: string, error: unknown, details?: Record<string, unknown>): void;
+//# sourceMappingURL=errors.d.ts.map

package/build/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH;;GAEG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,KAAK,CAEtD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKrD;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CACtB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,IAAI,CAQN"}

package/build/utils/errors.js

@@ -0,0 +1,35 @@
+/**
+ * Error handling utilities for consistent error logging across the codebase.
+ * Uses structured logger to keep output consistent.
+ */
+import logger from './logger.js';
+/**
+ * Type guard to check if a value is an Error instance.
+ */
+export function isError(value) {
+    return value instanceof Error;
+}
+/**
+ * Safely extracts an error message from any thrown value.
+ * Returns error.message if Error, String(error) otherwise.
+ */
+export function toErrorMessage(error) {
+    if (isError(error)) {
+        return error.message;
+    }
+    return String(error);
+}
+/**
+ * Logs an error with context prefix and optional details.
+ * Format: [context] message { details }
+ */
+export function logError(context, error, details) {
+    const message = toErrorMessage(error);
+    const payload = { context, ...(details ?? {}) };
+    if (isError(error)) {
+        logger.error({ ...payload, err: error }, message);
+        return;
+    }
+    logger.error(payload, message);
+}
+//# sourceMappingURL=errors.js.map

package/build/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,aAAa,CAAC;AACjC;;GAEG;AACH,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,YAAY,KAAK,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,QAAQ,CACtB,OAAe,EACf,KAAc,EACd,OAAiC;IAEjC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;IACtC,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,CAAC;IAChD,IAAI,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACnB,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO;IACT,CAAC;IACD,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/build/utils/fetch.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Shared fetch implementation based on undici.
+ */
+import { fetch as undiciFetch } from 'undici';
+export declare const fetch: typeof undiciFetch;
+//# sourceMappingURL=fetch.d.ts.map

package/build/utils/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../../src/utils/fetch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE9C,eAAO,MAAM,KAAK,oBAAc,CAAC"}

package/build/utils/fetch.js

@@ -0,0 +1,6 @@
+/**
+ * Shared fetch implementation based on undici.
+ */
+import { fetch as undiciFetch } from 'undici';
+export const fetch = undiciFetch;
+//# sourceMappingURL=fetch.js.map

package/build/utils/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../../src/utils/fetch.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE9C,MAAM,CAAC,MAAM,KAAK,GAAG,WAAW,CAAC"}

package/build/utils/http.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Shared HTTP utilities for making requests with timeouts and error handling
+ */
+export interface FetchOptions {
+    timeout?: number;
+    headers?: Record<string, string>;
+    signal?: AbortSignal;
+}
+/**
+ * Build headers with optional authorization token
+ */
+export declare function buildHeaders(userAgent: string, authToken?: string): Record<string, string>;
+/**
+ * Fetch JSON data with timeout
+ */
+export declare function fetchJson<T>(url: string, options?: FetchOptions): Promise<T>;
+/**
+ * Fetch text content with timeout
+ */
+export declare function fetchText(url: string, options?: FetchOptions): Promise<string>;
+//# sourceMappingURL=http.d.ts.map

package/build/utils/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/utils/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAID;;GAEG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQ1F;AA8BD;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,CAAC,CAAC,CAGZ;AAED;;GAEG;AACH,wBAAsB,SAAS,CAC7B,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAGjB"}