gitlab-catalog-browser 0.1.0

package/dist/api/gitlab.js

@@ -0,0 +1,226 @@
+/**
+ * Base GitLab API client.
+ *
+ * Provides authenticated HTTP access to GitLab REST APIs with:
+ * - Bearer token authentication
+ * - Configurable base URL and timeout
+ * - Structured error handling for all HTTP error codes
+ * - Pagination support
+ */
+import { AuthenticationError, PermissionError, NotFoundError, RateLimitError, ServerError, NetworkError, ConfigurationError, } from '../types/api.js';
+// ──────────────────────────────────────────────
+// GitLabApiClient
+// ──────────────────────────────────────────────
+export class GitLabApiClient {
+    baseUrl;
+    token;
+    defaultTimeout;
+    debug;
+    constructor(config = {}) {
+        this.baseUrl = (config.gitlabUrl ?? 'https://gitlab.com').replace(/\/+$/, '');
+        this.token = config.token;
+        this.defaultTimeout = config.timeout ?? 30000;
+        this.debug = config.debug ?? false;
+    }
+    // ────────────────────────────────────────────
+    // Public HTTP methods
+    // ────────────────────────────────────────────
+    /**
+     * Send an authenticated GET request.
+     */
+    async get(path, options = {}) {
+        return this.request('GET', path, options);
+    }
+    /**
+     * Send an authenticated POST request with JSON body.
+     */
+    async post(path, options = {}) {
+        return this.request('POST', path, options);
+    }
+    /**
+     * Send an authenticated PUT request with JSON body.
+     */
+    async put(path, options = {}) {
+        return this.request('PUT', path, options);
+    }
+    /**
+     * Send an authenticated DELETE request.
+     */
+    async delete(path, options = {}) {
+        return this.request('DELETE', path, options);
+    }
+    // ────────────────────────────────────────────
+    // Pagination
+    // ────────────────────────────────────────────
+    /**
+     * Fetch a paginated list, returning all pages.
+     * Uses GitLab's standard `page`/`per_page` query parameter convention.
+     */
+    async getAll(path, options = {}) {
+        const { page = 1, perPage = 20, ...rest } = options;
+        const results = [];
+        let currentPage = page;
+        let hasMore = true;
+        while (hasMore) {
+            const data = await this.get(path, {
+                ...rest,
+                params: { ...rest.params, page: currentPage, per_page: perPage },
+            });
+            results.push(...data);
+            // If we got fewer items than perPage, we're on the last page
+            if (data.length < perPage) {
+                hasMore = false;
+            }
+            else {
+                currentPage++;
+            }
+        }
+        return results;
+    }
+    // ────────────────────────────────────────────
+    // Core request method
+    // ────────────────────────────────────────────
+    async request(method, path, options = {}) {
+        const startTime = Date.now();
+        // Validate token
+        if (!this.token) {
+            throw new ConfigurationError('No GitLab token configured. Set GITLAB_CI_CLI_TOKEN or add "token" to your config file.');
+        }
+        // Build URL
+        const cleanPath = path.startsWith('/') ? path : `/${path}`;
+        const url = new URL(`${this.baseUrl}${cleanPath}`);
+        // Add query parameters
+        if (options.params) {
+            for (const [key, value] of Object.entries(options.params)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        // Build headers
+        const headers = {
+            Authorization: `Bearer ${this.token}`,
+            Accept: 'application/json',
+            ...options.headers,
+        };
+        if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+        }
+        // Abort controller for timeout
+        const timeoutMs = options.timeout ?? this.defaultTimeout;
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        // Combine signals if both provided
+        const signal = options.signal
+            ? composeAbortSignals(options.signal, controller.signal)
+            : controller.signal;
+        try {
+            if (this.debug) {
+                console.error(`[GitLab API] ${method} ${url.toString()}`);
+            }
+            const response = await fetch(url.toString(), {
+                method,
+                headers,
+                body: options.body !== undefined ? JSON.stringify(options.body) : undefined,
+                signal,
+            });
+            const duration = Date.now() - startTime;
+            if (this.debug) {
+                console.error(`[GitLab API] → ${response.status} (${duration}ms)`);
+            }
+            // Handle errors
+            if (!response.ok) {
+                const errorBody = await this.parseErrorBody(response);
+                this.throwHttpError(response.status, response.statusText, url.toString(), errorBody);
+            }
+            // Parse response body
+            const contentType = response.headers.get('content-type') ?? '';
+            if (contentType.includes('application/json')) {
+                return (await response.json());
+            }
+            // For non-JSON responses, return the status as unknown
+            return { status: response.status };
+        }
+        catch (err) {
+            // If it's already one of our typed errors, re-throw
+            if (err instanceof AuthenticationError ||
+                err instanceof PermissionError ||
+                err instanceof NotFoundError ||
+                err instanceof RateLimitError ||
+                err instanceof ServerError ||
+                err instanceof ConfigurationError) {
+                throw err;
+            }
+            // Check for abort (timeout)
+            if (err instanceof DOMException && err.name === 'AbortError') {
+                throw new NetworkError(this.baseUrl, `Request timed out after ${timeoutMs}ms`);
+            }
+            // Network or other errors
+            throw new NetworkError(this.baseUrl, err instanceof Error ? err.message : String(err));
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    // ────────────────────────────────────────────
+    // Error handling
+    // ────────────────────────────────────────────
+    /**
+     * Try to parse the error body from an unsuccessful response.
+     */
+    async parseErrorBody(response) {
+        try {
+            const body = (await response.json());
+            if (typeof body.message === 'string')
+                return body.message;
+            if (body.error)
+                return body.error;
+        }
+        catch {
+            // Ignore parse errors
+        }
+        return `HTTP ${response.status} ${response.statusText}`;
+    }
+    /**
+     * Throw the appropriate error type based on HTTP status code.
+     */
+    throwHttpError(status, statusText, url, message) {
+        switch (status) {
+            case 401:
+                throw new AuthenticationError();
+            case 403:
+                throw new PermissionError(message);
+            case 404:
+                throw new NotFoundError(url);
+            case 429:
+                throw new RateLimitError(`Rate limited: ${message}`);
+            default:
+                if (status >= 500) {
+                    throw new ServerError(status, statusText);
+                }
+                // Generic HTTP error
+                throw new Error(`GitLab API error (${status}): ${message}`);
+        }
+    }
+}
+// ──────────────────────────────────────────────
+// Helpers
+// ──────────────────────────────────────────────
+/**
+ * Compose two AbortSignals into one that aborts if either aborts.
+ */
+function composeAbortSignals(s1, s2) {
+    const controller = new AbortController();
+    const onAbort = () => controller.abort();
+    s1.addEventListener('abort', onAbort);
+    s2.addEventListener('abort', onAbort);
+    // Clean up listeners if neither aborts
+    if (!s1.aborted && !s2.aborted) {
+        controller.signal.addEventListener('abort', () => {
+            s1.removeEventListener('abort', onAbort);
+            s2.removeEventListener('abort', onAbort);
+        });
+    }
+    return controller.signal;
+}
+//# sourceMappingURL=gitlab.js.map

package/dist/api/gitlab.js.map

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

package/dist/api/lint.d.ts

@@ -0,0 +1,61 @@
+/**
+ * CI Lint API methods for GitLab CI/CD pipeline validation.
+ *
+ * Provides typed methods for validating .gitlab-ci.yml content via the
+ * GitLab CI Lint API endpoint.
+ */
+import { GitLabApiClient } from './gitlab.js';
+export interface LintValidateOptions {
+    /** Project path for context-aware validation */
+    project?: string;
+    /** Whether to include job details in response */
+    includeJobs?: boolean;
+    /** Enable dry-run mode for rules evaluation */
+    dryRun?: boolean;
+    /** Simulated CI/CD variables (key-value pairs) for dry-run evaluation */
+    variables?: Record<string, string>;
+}
+export interface LintError {
+    line?: number;
+    column?: number;
+    message: string;
+}
+export interface LintWarning {
+    line?: number;
+    column?: number;
+    message: string;
+}
+export interface LintJob {
+    name: string;
+    stage: string;
+    /** Whether this job would execute (in dry-run mode) */
+    when?: string;
+    /** Why the job was excluded (in dry-run mode) */
+    except_reason?: string | null;
+}
+export interface LintResult {
+    /** Validation status */
+    status: 'valid' | 'invalid';
+    /** List of errors (empty if valid) */
+    errors: LintError[];
+    /** List of warnings */
+    warnings: LintWarning[];
+    /** List of jobs (when include_jobs or dry_run is true) */
+    jobs?: LintJob[];
+    /** Whether the pipeline is valid (for dry-run mode) */
+    valid?: boolean;
+    /** Merged YAML configuration */
+    merged_yaml?: string;
+}
+export declare class LintApi {
+    private readonly client;
+    constructor(client: GitLabApiClient);
+    /**
+     * Validate a .gitlab-ci.yml content string using the GitLab CI Lint API.
+     *
+     * @param content - The YAML content to validate
+     * @param options - Validation options (project context, dry-run, etc.)
+     */
+    validate(content: string, options?: LintValidateOptions): Promise<LintResult>;
+}
+//# sourceMappingURL=lint.d.ts.map

package/dist/api/lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.d.ts","sourceRoot":"","sources":["../../src/api/lint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAM9C,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iDAAiD;IACjD,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,UAAU;IACzB,wBAAwB;IACxB,MAAM,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,sCAAsC;IACtC,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,uBAAuB;IACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAMD,qBAAa,OAAO;IACN,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,eAAe;IAEpD;;;;;OAKG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,UAAU,CAAC;CAwBxF"}

package/dist/api/lint.js

@@ -0,0 +1,41 @@
+/**
+ * CI Lint API methods for GitLab CI/CD pipeline validation.
+ *
+ * Provides typed methods for validating .gitlab-ci.yml content via the
+ * GitLab CI Lint API endpoint.
+ */
+// ──────────────────────────────────────────────
+// LintApi
+// ──────────────────────────────────────────────
+export class LintApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Validate a .gitlab-ci.yml content string using the GitLab CI Lint API.
+     *
+     * @param content - The YAML content to validate
+     * @param options - Validation options (project context, dry-run, etc.)
+     */
+    async validate(content, options = {}) {
+        const body = {
+            content,
+        };
+        if (options.includeJobs) {
+            body.include_jobs = true;
+        }
+        if (options.dryRun) {
+            body.dry = true;
+        }
+        if (options.variables && Object.keys(options.variables).length > 0) {
+            body.variables = options.variables;
+        }
+        // If a project is specified, use the project-specific lint endpoint
+        const endpoint = options.project
+            ? `/projects/${encodeURIComponent(options.project)}/ci/lint`
+            : '/ci/lint';
+        return this.client.post(endpoint, { body });
+    }
+}
+//# sourceMappingURL=lint.js.map

package/dist/api/lint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint.js","sourceRoot":"","sources":["../../src/api/lint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH,iDAAiD;AACjD,UAAU;AACV,iDAAiD;AAEjD,MAAM,OAAO,OAAO;IACW;IAA7B,YAA6B,MAAuB;QAAvB,WAAM,GAAN,MAAM,CAAiB;IAAG,CAAC;IAExD;;;;;OAKG;IACH,KAAK,CAAC,QAAQ,CAAC,OAAe,EAAE,UAA+B,EAAE;QAC/D,MAAM,IAAI,GAA4B;YACpC,OAAO;SACR,CAAC;QAEF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QAED,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC;QAClB,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnE,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACrC,CAAC;QAED,oEAAoE;QACpE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO;YAC9B,CAAC,CAAC,aAAa,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU;YAC5D,CAAC,CAAC,UAAU,CAAC;QAEf,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAa,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;CACF"}

package/dist/cache/schema-cache.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Schema Cache — file-based JSON cache with TTL for component schema data.
+ *
+ * Cache entries are persisted in `.gitlab-ci-cli-cache.json` in the
+ * configured cache directory (default: current working directory).
+ * Supports configurable TTL via `GITLAB_CI_CLI_CACHE_TTL` env var (ms).
+ * Cache directory can be overridden via `GITLAB_CI_CLI_CACHE_DIR` env var.
+ */
+export declare class SchemaCache {
+    private store;
+    private cacheDir;
+    private cachePath;
+    constructor(cacheDir?: string);
+    /**
+     * Get a value from cache. Returns null if not found or expired.
+     */
+    get<T>(key: string): {
+        data: T;
+        age: number;
+    } | null;
+    /**
+     * Set a value in cache with optional custom TTL.
+     */
+    set(key: string, data: unknown, ttl?: number): void;
+    /**
+     * Clear all cached entries.
+     */
+    clear(): void;
+    /**
+     * Remove a single entry from cache.
+     */
+    remove(key: string): void;
+    /**
+     * Get the number of cached entries.
+     */
+    get size(): number;
+    /**
+     * Load cache from disk.
+     */
+    private load;
+    /**
+     * Save cache to disk.
+     */
+    private save;
+    /**
+     * Resolve TTL from env var or default.
+     */
+    private resolveTtl;
+}
+/**
+ * Build a cache key for component schema requests.
+ */
+export declare function buildComponentCacheKey(fullPath: string, version?: string): string;
+//# sourceMappingURL=schema-cache.d.ts.map

package/dist/cache/schema-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-cache.d.ts","sourceRoot":"","sources":["../../src/cache/schema-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA0BH,qBAAa,WAAW;IACtB,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;gBAEd,QAAQ,CAAC,EAAE,MAAM;IAM7B;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAepD;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IASnD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKzB;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IASZ;;OAEG;IACH,OAAO,CAAC,IAAI;IAYZ;;OAEG;IACH,OAAO,CAAC,UAAU;CAQnB;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CAIR"}

package/dist/cache/schema-cache.js

@@ -0,0 +1,124 @@
+/**
+ * Schema Cache — file-based JSON cache with TTL for component schema data.
+ *
+ * Cache entries are persisted in `.gitlab-ci-cli-cache.json` in the
+ * configured cache directory (default: current working directory).
+ * Supports configurable TTL via `GITLAB_CI_CLI_CACHE_TTL` env var (ms).
+ * Cache directory can be overridden via `GITLAB_CI_CLI_CACHE_DIR` env var.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ──────────────────────────────────────────────
+// Types
+// ──────────────────────────────────────────────
+const DEFAULT_TTL = 5 * 60 * 1000; // 5 minutes in milliseconds
+const CACHE_FILENAME = '.gitlab-ci-cli-cache.json';
+// ──────────────────────────────────────────────
+// SchemaCache
+// ──────────────────────────────────────────────
+export class SchemaCache {
+    store = {};
+    cacheDir;
+    cachePath;
+    constructor(cacheDir) {
+        this.cacheDir = cacheDir ?? process.env.GITLAB_CI_CLI_CACHE_DIR ?? process.cwd();
+        this.cachePath = join(this.cacheDir, CACHE_FILENAME);
+        this.load();
+    }
+    /**
+     * Get a value from cache. Returns null if not found or expired.
+     */
+    get(key) {
+        const entry = this.store[key];
+        if (!entry)
+            return null;
+        const age = Date.now() - entry.timestamp;
+        if (age > entry.ttl) {
+            // Expired — remove it
+            delete this.store[key];
+            this.save();
+            return null;
+        }
+        return { data: entry.data, age };
+    }
+    /**
+     * Set a value in cache with optional custom TTL.
+     */
+    set(key, data, ttl) {
+        this.store[key] = {
+            data,
+            timestamp: Date.now(),
+            ttl: ttl ?? this.resolveTtl(),
+        };
+        this.save();
+    }
+    /**
+     * Clear all cached entries.
+     */
+    clear() {
+        this.store = {};
+        this.save();
+    }
+    /**
+     * Remove a single entry from cache.
+     */
+    remove(key) {
+        delete this.store[key];
+        this.save();
+    }
+    /**
+     * Get the number of cached entries.
+     */
+    get size() {
+        return Object.keys(this.store).length;
+    }
+    /**
+     * Load cache from disk.
+     */
+    load() {
+        try {
+            const content = readFileSync(this.cachePath, 'utf-8');
+            this.store = JSON.parse(content);
+        }
+        catch {
+            this.store = {};
+        }
+    }
+    /**
+     * Save cache to disk.
+     */
+    save() {
+        try {
+            const dir = this.cacheDir;
+            if (!existsSync(dir)) {
+                mkdirSync(dir, { recursive: true });
+            }
+            writeFileSync(this.cachePath, JSON.stringify(this.store, null, 2), 'utf-8');
+        }
+        catch {
+            // Silently fail — cache is a performance optimization, not critical
+        }
+    }
+    /**
+     * Resolve TTL from env var or default.
+     */
+    resolveTtl() {
+        const envTtl = process.env.GITLAB_CI_CLI_CACHE_TTL;
+        if (envTtl) {
+            const parsed = parseInt(envTtl, 10);
+            if (!isNaN(parsed) && parsed > 0)
+                return parsed;
+        }
+        return DEFAULT_TTL;
+    }
+}
+/**
+ * Build a cache key for component schema requests.
+ */
+export function buildComponentCacheKey(fullPath, version) {
+    const parts = ['component', fullPath];
+    if (version)
+        parts.push(version);
+    return parts.join(':');
+}
+//# sourceMappingURL=schema-cache.js.map

package/dist/cache/schema-cache.js.map

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

package/dist/commands/batch.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Batch command execution handler.
+ *
+ * Implements `batch` command for executing multiple CLI commands
+ * in a single invocation, sequentially.
+ */
+import type { GitLabCIConfig } from '../config/types.js';
+export interface BatchOptions {
+    bail?: boolean;
+    json?: boolean;
+}
+/**
+ * Handle `batch <commands...> [--bail]` or `batch --json` (stdin).
+ */
+export declare function handleBatch(commands: string[] | undefined, _config: Partial<GitLabCIConfig>, options?: BatchOptions): Promise<{
+    exitCode: number;
+    output: string;
+}>;
+//# sourceMappingURL=batch.d.ts.map

package/dist/commands/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/commands/batch.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA0DD;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAC9B,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,EAChC,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkI/C"}