@code-rag/core 0.1.0

package/dist/storage/s3-provider.test.js

@@ -0,0 +1,329 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { S3StorageProvider } from './s3-provider.js';
+// ---------------------------------------------------------------------------
+// Mock node:https and node:http
+// ---------------------------------------------------------------------------
+const { mockHttpsRequest, mockHttpRequest } = vi.hoisted(() => ({
+    mockHttpsRequest: vi.fn(),
+    mockHttpRequest: vi.fn(),
+}));
+vi.mock('node:https', () => ({ request: mockHttpsRequest }));
+vi.mock('node:http', () => ({ request: mockHttpRequest }));
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+const DEFAULT_CONFIG = {
+    provider: 's3',
+    bucket: 'test-bucket',
+    region: 'us-east-1',
+    accessKeyId: 'AKIAIOSFODNN7EXAMPLE',
+    secretAccessKey: 'wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY',
+};
+function setupMockResponse(statusCode, body) {
+    const bodyBuf = typeof body === 'string' ? Buffer.from(body) : body;
+    mockHttpsRequest.mockImplementation((_options, callback) => {
+        const res = {
+            statusCode,
+            on: vi.fn((event, handler) => {
+                if (event === 'data') {
+                    process.nextTick(() => handler(bodyBuf));
+                }
+                if (event === 'end') {
+                    process.nextTick(() => process.nextTick(() => handler()));
+                }
+                return res;
+            }),
+        };
+        process.nextTick(() => callback(res));
+        return {
+            on: vi.fn(),
+            write: vi.fn(),
+            end: vi.fn(),
+        };
+    });
+}
+function setupNetworkError(errorMessage) {
+    mockHttpsRequest.mockImplementation((_options, _callback) => {
+        const req = {
+            on: vi.fn((event, handler) => {
+                if (event === 'error') {
+                    process.nextTick(() => handler(new Error(errorMessage)));
+                }
+                return req;
+            }),
+            write: vi.fn(),
+            end: vi.fn(),
+        };
+        return req;
+    });
+}
+function setupMockResponseForHttp(statusCode, body) {
+    const bodyBuf = typeof body === 'string' ? Buffer.from(body) : body;
+    mockHttpRequest.mockImplementation((_options, callback) => {
+        const res = {
+            statusCode,
+            on: vi.fn((event, handler) => {
+                if (event === 'data') {
+                    process.nextTick(() => handler(bodyBuf));
+                }
+                if (event === 'end') {
+                    process.nextTick(() => process.nextTick(() => handler()));
+                }
+                return res;
+            }),
+        };
+        process.nextTick(() => callback(res));
+        return {
+            on: vi.fn(),
+            write: vi.fn(),
+            end: vi.fn(),
+        };
+    });
+}
+// ---------------------------------------------------------------------------
+// Tests
+// ---------------------------------------------------------------------------
+describe('S3StorageProvider', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+        setupMockResponse(200, '');
+    });
+    describe('constructor', () => {
+        it('should set host from bucket and region for standard S3', () => {
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const urlResult = provider.getUrl('test-key');
+            expect(urlResult.isOk()).toBe(true);
+            if (urlResult.isOk()) {
+                expect(urlResult.value).toContain('test-bucket.s3.us-east-1.amazonaws.com');
+            }
+        });
+        it('should use custom endpoint for S3-compatible stores', () => {
+            const config = {
+                ...DEFAULT_CONFIG,
+                endpoint: 'http://localhost:9000',
+            };
+            const provider = new S3StorageProvider(config);
+            const urlResult = provider.getUrl('test-key');
+            expect(urlResult.isOk()).toBe(true);
+            if (urlResult.isOk()) {
+                expect(urlResult.value).toContain('http://localhost:9000/test-bucket/');
+            }
+        });
+    });
+    describe('upload', () => {
+        it('should return ok on successful upload', async () => {
+            setupMockResponse(200, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.upload('my-key', Buffer.from('hello'));
+            expect(result.isOk()).toBe(true);
+        });
+        it('should return err on HTTP error', async () => {
+            setupMockResponse(500, 'InternalServerError');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.upload('my-key', Buffer.from('hello'));
+            expect(result.isErr()).toBe(true);
+            if (result.isErr()) {
+                expect(result.error.message).toContain('S3 upload failed');
+                expect(result.error.name).toBe('StorageError');
+            }
+        });
+        it('should return err on network error', async () => {
+            setupNetworkError('ECONNREFUSED');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.upload('my-key', Buffer.from('hello'));
+            expect(result.isErr()).toBe(true);
+            if (result.isErr()) {
+                expect(result.error.message).toContain('ECONNREFUSED');
+            }
+        });
+        it('should call write with body data', async () => {
+            setupMockResponse(200, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const data = Buffer.from('test-data');
+            await provider.upload('my-key', data);
+            const lastCall = mockHttpsRequest.mock.results[0]?.value;
+            expect(lastCall.write).toHaveBeenCalledWith(data);
+        });
+    });
+    describe('download', () => {
+        it('should return buffer on success', async () => {
+            const expectedData = Buffer.from('file-contents');
+            setupMockResponse(200, expectedData);
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.download('my-key');
+            expect(result.isOk()).toBe(true);
+            if (result.isOk()) {
+                expect(result.value.toString()).toBe('file-contents');
+            }
+        });
+        it('should return err on 404', async () => {
+            setupMockResponse(404, 'NoSuchKey');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.download('missing-key');
+            expect(result.isErr()).toBe(true);
+            if (result.isErr()) {
+                expect(result.error.message).toContain('S3 download failed');
+            }
+        });
+        it('should return err on 403', async () => {
+            setupMockResponse(403, 'AccessDenied');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.download('forbidden-key');
+            expect(result.isErr()).toBe(true);
+            if (result.isErr()) {
+                expect(result.error.message).toContain('S3 download failed');
+            }
+        });
+    });
+    describe('delete', () => {
+        it('should return ok on successful delete', async () => {
+            setupMockResponse(204, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.delete('my-key');
+            expect(result.isOk()).toBe(true);
+        });
+        it('should return err on failure', async () => {
+            setupMockResponse(500, 'Error');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.delete('my-key');
+            expect(result.isErr()).toBe(true);
+            if (result.isErr()) {
+                expect(result.error.message).toContain('S3 delete failed');
+            }
+        });
+    });
+    describe('list', () => {
+        it('should parse XML response and return keys', async () => {
+            const xml = `<?xml version="1.0"?>
+<ListBucketResult>
+  <Contents><Key>file1.ts</Key></Contents>
+  <Contents><Key>file2.ts</Key></Contents>
+</ListBucketResult>`;
+            setupMockResponse(200, xml);
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.list('src/');
+            expect(result.isOk()).toBe(true);
+            if (result.isOk()) {
+                expect(result.value).toEqual(['file1.ts', 'file2.ts']);
+            }
+        });
+        it('should return empty array when no keys match', async () => {
+            const xml = `<?xml version="1.0"?><ListBucketResult></ListBucketResult>`;
+            setupMockResponse(200, xml);
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.list('nonexistent/');
+            expect(result.isOk()).toBe(true);
+            if (result.isOk()) {
+                expect(result.value).toEqual([]);
+            }
+        });
+        it('should return err on failure', async () => {
+            setupMockResponse(500, 'Error');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.list('src/');
+            expect(result.isErr()).toBe(true);
+            if (result.isErr()) {
+                expect(result.error.message).toContain('S3 list failed');
+            }
+        });
+    });
+    describe('exists', () => {
+        it('should return true when object exists', async () => {
+            setupMockResponse(200, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.exists('my-key');
+            expect(result.isOk()).toBe(true);
+            if (result.isOk()) {
+                expect(result.value).toBe(true);
+            }
+        });
+        it('should return false when object does not exist (404)', async () => {
+            // HEAD request with 404 triggers reject with '404 Not Found'
+            setupMockResponse(404, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.exists('missing-key');
+            expect(result.isOk()).toBe(true);
+            if (result.isOk()) {
+                expect(result.value).toBe(false);
+            }
+        });
+        it('should return err on non-404 error', async () => {
+            setupMockResponse(500, 'InternalError');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = await provider.exists('error-key');
+            expect(result.isErr()).toBe(true);
+            if (result.isErr()) {
+                expect(result.error.message).toContain('S3 exists check failed');
+            }
+        });
+    });
+    describe('getUrl', () => {
+        it('should return standard S3 URL', () => {
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            const result = provider.getUrl('my-file.ts');
+            expect(result.isOk()).toBe(true);
+            if (result.isOk()) {
+                expect(result.value).toBe('https://test-bucket.s3.us-east-1.amazonaws.com/my-file.ts');
+            }
+        });
+        it('should return custom endpoint URL', () => {
+            const config = { ...DEFAULT_CONFIG, endpoint: 'http://minio:9000' };
+            const provider = new S3StorageProvider(config);
+            const result = provider.getUrl('my-file.ts');
+            expect(result.isOk()).toBe(true);
+            if (result.isOk()) {
+                expect(result.value).toBe('http://minio:9000/test-bucket/my-file.ts');
+            }
+        });
+    });
+    describe('custom endpoint (MinIO)', () => {
+        it('should use http for http:// endpoint', async () => {
+            setupMockResponseForHttp(200, '');
+            const config = {
+                ...DEFAULT_CONFIG,
+                endpoint: 'http://localhost:9000',
+            };
+            const provider = new S3StorageProvider(config);
+            const result = await provider.upload('test', Buffer.from('data'));
+            expect(result.isOk()).toBe(true);
+            expect(mockHttpRequest).toHaveBeenCalled();
+        });
+        it('should use https for https:// endpoint', async () => {
+            setupMockResponse(200, '');
+            const config = {
+                ...DEFAULT_CONFIG,
+                endpoint: 'https://minio.example.com',
+            };
+            const provider = new S3StorageProvider(config);
+            const result = await provider.upload('test', Buffer.from('data'));
+            expect(result.isOk()).toBe(true);
+            expect(mockHttpsRequest).toHaveBeenCalled();
+        });
+    });
+    describe('AWS Signature V4', () => {
+        it('should include Authorization header in request', async () => {
+            setupMockResponse(200, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            await provider.upload('my-key', Buffer.from('hello'));
+            const options = mockHttpsRequest.mock.calls[0]?.[0];
+            expect(options.headers).toBeDefined();
+            expect(options.headers['authorization']).toContain('AWS4-HMAC-SHA256');
+            expect(options.headers['authorization']).toContain('Credential=AKIAIOSFODNN7EXAMPLE');
+        });
+        it('should include x-amz-date header', async () => {
+            setupMockResponse(200, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            await provider.upload('my-key', Buffer.from('hello'));
+            const options = mockHttpsRequest.mock.calls[0]?.[0];
+            expect(options.headers['x-amz-date']).toMatch(/^\d{8}T\d{6}Z$/);
+        });
+        it('should include content-sha256 header', async () => {
+            setupMockResponse(200, '');
+            const provider = new S3StorageProvider(DEFAULT_CONFIG);
+            await provider.upload('my-key', Buffer.from('hello'));
+            const options = mockHttpsRequest.mock.calls[0]?.[0];
+            expect(options.headers['x-amz-content-sha256']).toMatch(/^[a-f0-9]{64}$/);
+        });
+    });
+});
+//# sourceMappingURL=s3-provider.test.js.map

package/dist/storage/s3-provider.test.js.map

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

package/dist/storage/types.d.ts

@@ -0,0 +1,65 @@
+import type { Result } from 'neverthrow';
+/**
+ * Error class for cloud storage operations.
+ */
+export declare class StorageError extends Error {
+    constructor(message: string);
+}
+/**
+ * Provider-agnostic interface for cloud object storage.
+ * All operations return Result<T, StorageError> for safe error handling.
+ */
+export interface CloudStorageProvider {
+    /**
+     * Upload data to the given key.
+     */
+    upload(key: string, data: Buffer): Promise<Result<void, StorageError>>;
+    /**
+     * Download data from the given key.
+     */
+    download(key: string): Promise<Result<Buffer, StorageError>>;
+    /**
+     * Delete the object at the given key.
+     */
+    delete(key: string): Promise<Result<void, StorageError>>;
+    /**
+     * List object keys matching a prefix.
+     */
+    list(prefix: string): Promise<Result<readonly string[], StorageError>>;
+    /**
+     * Check whether an object exists at the given key.
+     */
+    exists(key: string): Promise<Result<boolean, StorageError>>;
+    /**
+     * Get a URL (or presigned URL) for the given key.
+     */
+    getUrl(key: string): Result<string, StorageError>;
+}
+export interface S3Config {
+    readonly provider: 's3';
+    readonly bucket: string;
+    readonly region: string;
+    readonly accessKeyId: string;
+    readonly secretAccessKey: string;
+    /** Optional custom endpoint for S3-compatible stores like MinIO. */
+    readonly endpoint?: string;
+}
+export interface AzureBlobConfig {
+    readonly provider: 'azure-blob';
+    readonly accountName: string;
+    readonly accountKey: string;
+    readonly containerName: string;
+}
+export interface GCSConfig {
+    readonly provider: 'gcs';
+    readonly projectId: string;
+    readonly bucket: string;
+    /** Service account JSON key (parsed object). */
+    readonly credentials: GCSCredentials;
+}
+export interface GCSCredentials {
+    readonly client_email: string;
+    readonly private_key: string;
+    readonly token_uri: string;
+}
+export type CloudStorageConfig = S3Config | AzureBlobConfig | GCSConfig;

package/dist/storage/types.js

@@ -0,0 +1,12 @@
+// ---------------------------------------------------------------------------
+// StorageError
+// ---------------------------------------------------------------------------
+/**
+ * Error class for cloud storage operations.
+ */
+export class StorageError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StorageError';
+    }
+}

package/dist/storage/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,eAAe;AACf,8EAA8E;AAE9E;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}

package/dist/types/chunk.d.ts

@@ -0,0 +1,32 @@
+export interface ChunkMetadata {
+    chunkType: ChunkType;
+    name: string;
+    parentName?: string;
+    declarations: string[];
+    imports: string[];
+    exports: string[];
+    repoName?: string;
+    /** Wikilinks extracted from documentation chunks ([[link]] syntax). */
+    links?: string[];
+    /** Tags extracted from documentation chunks (#tag syntax + frontmatter). */
+    tags?: string[];
+    /** Aliases from Obsidian frontmatter. */
+    aliases?: string[];
+    /** Document title from frontmatter. */
+    docTitle?: string;
+}
+export type ChunkType = 'function' | 'method' | 'class' | 'module' | 'interface' | 'type_alias' | 'config_block' | 'import_block' | 'doc';
+export interface Chunk {
+    id: string;
+    content: string;
+    nlSummary: string;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    language: string;
+    metadata: ChunkMetadata;
+    embedding?: number[];
+}
+export interface ChunkWithEmbedding extends Chunk {
+    embedding: number[];
+}

package/dist/types/chunk.js

@@ -0,0 +1 @@
+export {};

package/dist/types/chunk.js.map

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

package/dist/types/config.d.ts

@@ -0,0 +1,71 @@
+export interface OpenAICompatibleConfig {
+    baseUrl: string;
+    apiKey?: string;
+    maxBatchSize: number;
+}
+export interface EmbeddingDockerConfig {
+    image: string;
+    gpu: 'auto' | 'nvidia' | 'none';
+}
+export interface EmbeddingConfig {
+    provider: string;
+    model: string;
+    dimensions: number;
+    openaiCompatible?: OpenAICompatibleConfig;
+    autoStart: boolean;
+    autoStop: boolean;
+    docker: EmbeddingDockerConfig;
+}
+export interface LLMConfig {
+    provider: string;
+    model: string;
+}
+export interface IngestionConfig {
+    maxTokensPerChunk: number;
+    exclude: string[];
+}
+export interface SearchConfig {
+    topK: number;
+    vectorWeight: number;
+    bm25Weight: number;
+}
+export interface QdrantStorageConfig {
+    url?: string;
+    collectionName?: string;
+}
+export interface StorageConfig {
+    path: string;
+    provider?: 'lancedb' | 'qdrant';
+    qdrant?: QdrantStorageConfig;
+}
+export interface ProjectConfig {
+    name: string;
+    languages: string[] | 'auto';
+}
+export interface ReRankerConfig {
+    enabled: boolean;
+    model: string;
+    topN: number;
+}
+export interface RepoConfig {
+    path: string;
+    name?: string;
+    languages?: string[];
+    exclude?: string[];
+}
+export interface BacklogConfig {
+    provider: string;
+    config?: Record<string, unknown>;
+}
+export interface CodeRAGConfig {
+    version: string;
+    project: ProjectConfig;
+    ingestion: IngestionConfig;
+    embedding: EmbeddingConfig;
+    llm: LLMConfig;
+    search: SearchConfig;
+    storage: StorageConfig;
+    reranker?: ReRankerConfig;
+    repos?: RepoConfig[];
+    backlog?: BacklogConfig;
+}

package/dist/types/config.js

@@ -0,0 +1 @@
+export {};

package/dist/types/config.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export type { ChunkMetadata, ChunkType, Chunk, ChunkWithEmbedding } from './chunk.js';
+export type { CodeRAGConfig, EmbeddingConfig, OpenAICompatibleConfig, EmbeddingDockerConfig, LLMConfig, IngestionConfig, SearchConfig, StorageConfig, QdrantStorageConfig, ProjectConfig, ReRankerConfig, RepoConfig, BacklogConfig, } from './config.js';
+export type { EmbeddingProvider, VectorStore, LLMProvider, ReRanker, Parser, Chunker, ParsedFile, } from './provider.js';
+export { EmbedError, StoreError, LLMError, ParseError, ChunkError, ReRankerError } from './provider.js';
+export type { SearchQuery, SearchFilters, SearchOptions, SearchResult, SearchMethod, } from './search.js';

package/dist/types/index.js

@@ -0,0 +1 @@
+export { EmbedError, StoreError, LLMError, ParseError, ChunkError, ReRankerError } from './provider.js';

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/provider.d.ts

@@ -0,0 +1,54 @@
+import type { Result } from 'neverthrow';
+import type { Chunk } from './chunk.js';
+export declare class ParseError extends Error {
+    constructor(message: string);
+}
+export declare class ChunkError extends Error {
+    constructor(message: string);
+}
+export declare class EmbedError extends Error {
+    constructor(message: string);
+}
+export declare class StoreError extends Error {
+    constructor(message: string);
+}
+export declare class LLMError extends Error {
+    constructor(message: string);
+}
+export interface ParsedFile {
+    filePath: string;
+    language: string;
+    content: string;
+    declarations: string[];
+}
+export interface Parser {
+    parse(filePath: string, content: string): Promise<Result<ParsedFile, ParseError>>;
+    supportedLanguages(): string[];
+}
+export interface Chunker {
+    chunk(parsed: ParsedFile): Promise<Result<Chunk[], ChunkError>>;
+}
+export interface EmbeddingProvider {
+    embed(texts: string[]): Promise<Result<number[][], EmbedError>>;
+    readonly dimensions: number;
+}
+export interface VectorStore {
+    upsert(ids: string[], embeddings: number[][], metadata: Record<string, unknown>[]): Promise<Result<void, StoreError>>;
+    query(embedding: number[], topK: number): Promise<Result<{
+        id: string;
+        score: number;
+        metadata?: Record<string, unknown>;
+    }[], StoreError>>;
+    delete(ids: string[]): Promise<Result<void, StoreError>>;
+    count(): Promise<Result<number, StoreError>>;
+    close(): void;
+}
+export interface LLMProvider {
+    generate(prompt: string): Promise<Result<string, LLMError>>;
+}
+export declare class ReRankerError extends Error {
+    constructor(message: string);
+}
+export interface ReRanker {
+    rerank(query: string, results: import('./search.js').SearchResult[]): Promise<Result<import('./search.js').SearchResult[], ReRankerError>>;
+}

package/dist/types/provider.js

@@ -0,0 +1,36 @@
+export class ParseError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ParseError';
+    }
+}
+export class ChunkError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ChunkError';
+    }
+}
+export class EmbedError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'EmbedError';
+    }
+}
+export class StoreError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'StoreError';
+    }
+}
+export class LLMError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'LLMError';
+    }
+}
+export class ReRankerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ReRankerError';
+    }
+}

package/dist/types/provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider.js","sourceRoot":"","sources":["../../src/types/provider.ts"],"names":[],"mappings":"AAGA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;IACzB,CAAC;CACF;AA0CD,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF"}