@skillsmith/core 0.5.4 → 0.5.6

package/dist/repositories/SkillVersionRepository.js

@@ -0,0 +1,118 @@
+/**
+ * @fileoverview SkillVersionRepository — persistent content-hash version tracking
+ * @module @skillsmith/core/repositories/SkillVersionRepository
+ * @see SMI-skill-version-tracking Wave 1
+ *
+ * Records a content hash after every successful skill upsert so that the
+ * skill_updates MCP tool (Individual tier) can detect registry changes by
+ * comparing the locally-stored hash against the current registry hash.
+ *
+ * Design notes:
+ *  - No FK on skill_id — soft reference, version history survives skill removal
+ *  - recordVersion is idempotent via INSERT OR IGNORE on the unique index
+ *  - pruneVersions keeps the 50 most-recent rows per skill (configurable)
+ */
+// ============================================================================
+// Repository
+// ============================================================================
+/**
+ * Repository for reading and writing skill version records
+ */
+export class SkillVersionRepository {
+    db;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Record a version hash for a skill.
+     *
+     * Idempotent: if (skill_id, content_hash) already exists the INSERT is
+     * silently ignored (INSERT OR IGNORE on the unique index).
+     *
+     * After inserting, prunes rows beyond keepCount to bound table growth.
+     *
+     * @param skillId     Registry skill identifier
+     * @param contentHash SHA-256 hex digest
+     * @param semver      Optional semver string
+     * @param metadata    Optional JSON string for future extension
+     * @param keepCount   Maximum rows to keep per skill (default 50)
+     */
+    async recordVersion(skillId, contentHash, semver, metadata, keepCount = 50) {
+        this.db
+            .prepare(`INSERT OR IGNORE INTO skill_versions (skill_id, content_hash, semver, metadata)
+         VALUES (?, ?, ?, ?)`)
+            .run(skillId, contentHash, semver ?? null, metadata ?? null);
+        await this.pruneVersions(skillId, keepCount);
+    }
+    /**
+     * Get the most recently recorded version for a skill.
+     *
+     * @param skillId Registry skill identifier
+     * @returns Most recent SkillVersionRow or null if none recorded
+     */
+    async getLatestVersion(skillId) {
+        const row = this.db
+            .prepare(`SELECT id, skill_id, content_hash, recorded_at, semver, metadata
+           FROM skill_versions
+          WHERE skill_id = ?
+          ORDER BY recorded_at DESC
+          LIMIT 1`)
+            .get(skillId);
+        return row ?? null;
+    }
+    /**
+     * Get the full version history for a skill, newest first.
+     *
+     * @param skillId Registry skill identifier
+     * @param limit   Maximum rows to return (default 20)
+     * @returns Array of SkillVersionRow ordered by recorded_at DESC
+     */
+    async getVersionHistory(skillId, limit = 20) {
+        return this.db
+            .prepare(`SELECT id, skill_id, content_hash, recorded_at, semver, metadata
+           FROM skill_versions
+          WHERE skill_id = ?
+          ORDER BY recorded_at DESC
+          LIMIT ?`)
+            .all(skillId, limit);
+    }
+    /**
+     * Look up a specific version by its content hash.
+     *
+     * @param skillId     Registry skill identifier
+     * @param contentHash SHA-256 hex digest to look up
+     * @returns Matching SkillVersionRow or null
+     */
+    async getVersionByHash(skillId, contentHash) {
+        const row = this.db
+            .prepare(`SELECT id, skill_id, content_hash, recorded_at, semver, metadata
+           FROM skill_versions
+          WHERE skill_id = ?
+            AND content_hash = ?
+          LIMIT 1`)
+            .get(skillId, contentHash);
+        return row ?? null;
+    }
+    /**
+     * Prune version history to at most keepCount rows per skill.
+     *
+     * Uses the subquery pattern (DELETE WHERE id NOT IN SELECT … LIMIT)
+     * which is compatible with SQLite's restricted DELETE syntax.
+     *
+     * @param skillId   Registry skill identifier
+     * @param keepCount Number of most-recent rows to retain (default 50)
+     */
+    async pruneVersions(skillId, keepCount = 50) {
+        this.db
+            .prepare(`DELETE FROM skill_versions
+          WHERE skill_id = ?
+            AND id NOT IN (
+              SELECT id FROM skill_versions
+               WHERE skill_id = ?
+               ORDER BY recorded_at DESC
+               LIMIT ?
+            )`)
+            .run(skillId, skillId, keepCount);
+    }
+}
+//# sourceMappingURL=SkillVersionRepository.js.map

package/dist/repositories/SkillVersionRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SkillVersionRepository.js","sourceRoot":"","sources":["../../src/repositories/SkillVersionRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAoBH,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,sBAAsB;IACzB,EAAE,CAAc;IAExB,YAAY,EAAgB;QAC1B,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;IACd,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,KAAK,CAAC,aAAa,CACjB,OAAe,EACf,WAAmB,EACnB,MAAe,EACf,QAAiB,EACjB,SAAS,GAAG,EAAE;QAEd,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;6BACqB,CACtB;aACA,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,IAAI,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAC,CAAA;QAE9D,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAC9C,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CACN;;;;kBAIU,CACX;aACA,GAAG,CAAC,OAAO,CAAgC,CAAA;QAE9C,OAAO,GAAG,IAAI,IAAI,CAAA;IACpB,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,iBAAiB,CAAC,OAAe,EAAE,KAAK,GAAG,EAAE;QACjD,OAAO,IAAI,CAAC,EAAE;aACX,OAAO,CACN;;;;kBAIU,CACX;aACA,GAAG,CAAC,OAAO,EAAE,KAAK,CAAsB,CAAA;IAC7C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,gBAAgB,CAAC,OAAe,EAAE,WAAmB;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE;aAChB,OAAO,CACN;;;;kBAIU,CACX;aACA,GAAG,CAAC,OAAO,EAAE,WAAW,CAAgC,CAAA;QAE3D,OAAO,GAAG,IAAI,IAAI,CAAA;IACpB,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,aAAa,CAAC,OAAe,EAAE,SAAS,GAAG,EAAE;QACjD,IAAI,CAAC,EAAE;aACJ,OAAO,CACN;;;;;;;cAOM,CACP;aACA,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,CAAC,CAAA;IACrC,CAAC;CACF"}

package/dist/repositories/SyncConfigRepository.d.ts

@@ -0,0 +1,91 @@
+/**
+ * SyncConfigRepository - Manages sync configuration state
+ *
+ * Handles the singleton sync_config record for registry sync settings.
+ */
+import type { Database as DatabaseType } from '../db/database-interface.js';
+/**
+ * Sync frequency options
+ */
+export type SyncFrequency = 'daily' | 'weekly';
+/**
+ * Interval in milliseconds for each frequency
+ */
+export declare const FREQUENCY_INTERVALS: Record<SyncFrequency, number>;
+/**
+ * Sync configuration
+ */
+export interface SyncConfig {
+    id: string;
+    enabled: boolean;
+    frequency: SyncFrequency;
+    intervalMs: number;
+    lastSyncAt: string | null;
+    nextSyncAt: string | null;
+    lastSyncCount: number;
+    lastSyncError: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Partial update input
+ */
+export interface SyncConfigUpdate {
+    enabled?: boolean;
+    frequency?: SyncFrequency;
+}
+/**
+ * Repository for sync configuration management
+ */
+export declare class SyncConfigRepository {
+    private db;
+    private stmts;
+    constructor(db: DatabaseType);
+    /**
+     * Ensure sync_config table exists and has default row
+     */
+    private ensureTable;
+    private prepareStatements;
+    private rowToConfig;
+    /**
+     * Get current sync configuration
+     */
+    getConfig(): SyncConfig;
+    /**
+     * Update sync configuration
+     */
+    updateConfig(update: SyncConfigUpdate): SyncConfig;
+    /**
+     * Record successful sync completion
+     */
+    setLastSync(timestamp: string, count: number): void;
+    /**
+     * Record sync error
+     */
+    setLastSyncError(error: string): void;
+    /**
+     * Clear any stored error
+     */
+    clearError(): void;
+    /**
+     * Calculate next sync time based on last sync and interval
+     */
+    calculateNextSync(lastSyncAt: string, intervalMs: number): string;
+    /**
+     * Check if sync is due based on current time
+     */
+    isSyncDue(): boolean;
+    /**
+     * Enable automatic sync
+     */
+    enable(): SyncConfig;
+    /**
+     * Disable automatic sync
+     */
+    disable(): SyncConfig;
+    /**
+     * Set sync frequency
+     */
+    setFrequency(frequency: SyncFrequency): SyncConfig;
+}
+//# sourceMappingURL=SyncConfigRepository.d.ts.map

package/dist/repositories/SyncConfigRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncConfigRepository.d.ts","sourceRoot":"","sources":["../../src/repositories/SyncConfigRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE3E;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE9C;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,CAG7D,CAAA;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,aAAa,CAAA;IACxB,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,aAAa,EAAE,MAAM,CAAA;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB;AAkBD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,SAAS,CAAC,EAAE,aAAa,CAAA;CAC1B;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,KAAK,CAOZ;gBAEW,EAAE,EAAE,YAAY;IAM5B;;OAEG;IACH,OAAO,CAAC,WAAW;IA4BnB,OAAO,CAAC,iBAAiB;IAsCzB,OAAO,CAAC,WAAW;IAenB;;OAEG;IACH,SAAS,IAAI,UAAU;IAoBvB;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,UAAU;IAkBlD;;OAEG;IACH,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IASnD;;OAEG;IACH,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM;IAMjE;;OAEG;IACH,SAAS,IAAI,OAAO;IAkBpB;;OAEG;IACH,MAAM,IAAI,UAAU;IAIpB;;OAEG;IACH,OAAO,IAAI,UAAU;IAIrB;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,aAAa,GAAG,UAAU;CAGnD"}

package/dist/repositories/SyncConfigRepository.js

@@ -0,0 +1,202 @@
+/**
+ * SyncConfigRepository - Manages sync configuration state
+ *
+ * Handles the singleton sync_config record for registry sync settings.
+ */
+/**
+ * Interval in milliseconds for each frequency
+ */
+export const FREQUENCY_INTERVALS = {
+    daily: 86400000, // 24 hours
+    weekly: 604800000, // 7 days
+};
+/**
+ * Repository for sync configuration management
+ */
+export class SyncConfigRepository {
+    db;
+    stmts;
+    constructor(db) {
+        this.db = db;
+        this.ensureTable();
+        this.prepareStatements();
+    }
+    /**
+     * Ensure sync_config table exists and has default row
+     */
+    ensureTable() {
+        // Check if table exists
+        const tableExists = this.db
+            .prepare("SELECT name FROM sqlite_master WHERE type='table' AND name='sync_config'")
+            .get();
+        if (!tableExists) {
+            // Create table if it doesn't exist (handles pre-migration databases)
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS sync_config (
+          id TEXT PRIMARY KEY DEFAULT 'default',
+          enabled INTEGER NOT NULL DEFAULT 1,
+          frequency TEXT NOT NULL DEFAULT 'daily' CHECK(frequency IN ('daily', 'weekly')),
+          interval_ms INTEGER NOT NULL DEFAULT 86400000,
+          last_sync_at TEXT,
+          next_sync_at TEXT,
+          last_sync_count INTEGER DEFAULT 0,
+          last_sync_error TEXT,
+          created_at TEXT NOT NULL DEFAULT (datetime('now')),
+          updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+        );
+      `);
+        }
+        // Ensure default config exists
+        this.db.exec("INSERT OR IGNORE INTO sync_config (id) VALUES ('default')");
+    }
+    prepareStatements() {
+        this.stmts = {
+            get: this.db.prepare(`
+        SELECT * FROM sync_config WHERE id = 'default'
+      `),
+            update: this.db.prepare(`
+        UPDATE sync_config
+        SET enabled = ?, frequency = ?, interval_ms = ?, updated_at = datetime('now')
+        WHERE id = 'default'
+      `),
+            setLastSync: this.db.prepare(`
+        UPDATE sync_config
+        SET last_sync_at = ?, last_sync_count = ?, last_sync_error = NULL, updated_at = datetime('now')
+        WHERE id = 'default'
+      `),
+            setLastSyncError: this.db.prepare(`
+        UPDATE sync_config
+        SET last_sync_error = ?, updated_at = datetime('now')
+        WHERE id = 'default'
+      `),
+            setNextSync: this.db.prepare(`
+        UPDATE sync_config
+        SET next_sync_at = ?, updated_at = datetime('now')
+        WHERE id = 'default'
+      `),
+            clearError: this.db.prepare(`
+        UPDATE sync_config
+        SET last_sync_error = NULL, updated_at = datetime('now')
+        WHERE id = 'default'
+      `),
+        };
+    }
+    rowToConfig(row) {
+        return {
+            id: row.id,
+            enabled: row.enabled === 1,
+            frequency: row.frequency,
+            intervalMs: row.interval_ms,
+            lastSyncAt: row.last_sync_at,
+            nextSyncAt: row.next_sync_at,
+            lastSyncCount: row.last_sync_count,
+            lastSyncError: row.last_sync_error,
+            createdAt: row.created_at,
+            updatedAt: row.updated_at,
+        };
+    }
+    /**
+     * Get current sync configuration
+     */
+    getConfig() {
+        const row = this.stmts.get.get();
+        if (!row) {
+            // Should never happen due to ensureTable(), but handle gracefully
+            return {
+                id: 'default',
+                enabled: true,
+                frequency: 'daily',
+                intervalMs: FREQUENCY_INTERVALS.daily,
+                lastSyncAt: null,
+                nextSyncAt: null,
+                lastSyncCount: 0,
+                lastSyncError: null,
+                createdAt: new Date().toISOString(),
+                updatedAt: new Date().toISOString(),
+            };
+        }
+        return this.rowToConfig(row);
+    }
+    /**
+     * Update sync configuration
+     */
+    updateConfig(update) {
+        const current = this.getConfig();
+        const enabled = update.enabled ?? current.enabled;
+        const frequency = update.frequency ?? current.frequency;
+        const intervalMs = FREQUENCY_INTERVALS[frequency];
+        this.stmts.update.run(enabled ? 1 : 0, frequency, intervalMs);
+        // If frequency changed, recalculate next sync
+        if (update.frequency && current.lastSyncAt) {
+            const nextSync = this.calculateNextSync(current.lastSyncAt, intervalMs);
+            this.stmts.setNextSync.run(nextSync);
+        }
+        return this.getConfig();
+    }
+    /**
+     * Record successful sync completion
+     */
+    setLastSync(timestamp, count) {
+        this.stmts.setLastSync.run(timestamp, count);
+        // Calculate next sync time
+        const config = this.getConfig();
+        const nextSync = this.calculateNextSync(timestamp, config.intervalMs);
+        this.stmts.setNextSync.run(nextSync);
+    }
+    /**
+     * Record sync error
+     */
+    setLastSyncError(error) {
+        this.stmts.setLastSyncError.run(error);
+    }
+    /**
+     * Clear any stored error
+     */
+    clearError() {
+        this.stmts.clearError.run();
+    }
+    /**
+     * Calculate next sync time based on last sync and interval
+     */
+    calculateNextSync(lastSyncAt, intervalMs) {
+        const lastSync = new Date(lastSyncAt);
+        const nextSync = new Date(lastSync.getTime() + intervalMs);
+        return nextSync.toISOString();
+    }
+    /**
+     * Check if sync is due based on current time
+     */
+    isSyncDue() {
+        const config = this.getConfig();
+        // If never synced, it's due
+        if (!config.lastSyncAt) {
+            return true;
+        }
+        // If no next sync calculated, calculate it
+        if (!config.nextSyncAt) {
+            const nextSync = this.calculateNextSync(config.lastSyncAt, config.intervalMs);
+            this.stmts.setNextSync.run(nextSync);
+            return new Date() >= new Date(nextSync);
+        }
+        return new Date() >= new Date(config.nextSyncAt);
+    }
+    /**
+     * Enable automatic sync
+     */
+    enable() {
+        return this.updateConfig({ enabled: true });
+    }
+    /**
+     * Disable automatic sync
+     */
+    disable() {
+        return this.updateConfig({ enabled: false });
+    }
+    /**
+     * Set sync frequency
+     */
+    setFrequency(frequency) {
+        return this.updateConfig({ frequency });
+    }
+}
+//# sourceMappingURL=SyncConfigRepository.js.map

package/dist/repositories/SyncConfigRepository.js.map

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

package/dist/repositories/SyncHistoryRepository.d.ts

@@ -0,0 +1,104 @@
+/**
+ * SyncHistoryRepository - Tracks sync operation history
+ *
+ * Records each sync run with timing, counts, and status for monitoring.
+ */
+import type { Database as DatabaseType } from '../db/database-interface.js';
+/**
+ * Sync run status
+ */
+export type SyncStatus = 'running' | 'success' | 'failed' | 'partial';
+/**
+ * Sync history entry
+ */
+export interface SyncHistoryEntry {
+    id: string;
+    startedAt: string;
+    completedAt: string | null;
+    status: SyncStatus;
+    skillsAdded: number;
+    skillsUpdated: number;
+    skillsUnchanged: number;
+    errorMessage: string | null;
+    durationMs: number | null;
+    createdAt: string;
+}
+/**
+ * Sync result for completing a run
+ */
+export interface SyncRunResult {
+    skillsAdded: number;
+    skillsUpdated: number;
+    skillsUnchanged: number;
+}
+/**
+ * Repository for sync history tracking
+ */
+export declare class SyncHistoryRepository {
+    private db;
+    private stmts;
+    constructor(db: DatabaseType);
+    /**
+     * Ensure sync_history table exists
+     */
+    private ensureTable;
+    private prepareStatements;
+    private rowToEntry;
+    /**
+     * Start a new sync run
+     * @returns The sync run ID
+     */
+    startRun(): string;
+    /**
+     * Complete a sync run successfully
+     */
+    completeRun(id: string, result: SyncRunResult): void;
+    /**
+     * Mark a sync run as partially complete (some errors)
+     */
+    completeRunPartial(id: string, result: SyncRunResult, errorMessage: string): void;
+    /**
+     * Mark a sync run as failed
+     */
+    failRun(id: string, error: string): void;
+    /**
+     * Get a specific sync run by ID
+     */
+    getById(id: string): SyncHistoryEntry | null;
+    /**
+     * Get sync history (most recent first)
+     */
+    getHistory(limit?: number): SyncHistoryEntry[];
+    /**
+     * Get the last successful sync run
+     */
+    getLastSuccessful(): SyncHistoryEntry | null;
+    /**
+     * Get any currently running sync operations
+     */
+    getRunning(): SyncHistoryEntry[];
+    /**
+     * Check if a sync is currently running
+     */
+    isRunning(): boolean;
+    /**
+     * Clean up old history entries
+     * @param daysToKeep Number of days of history to retain
+     */
+    cleanup(daysToKeep?: number): number;
+    /**
+     * Get total count of history entries
+     */
+    count(): number;
+    /**
+     * Get sync statistics
+     */
+    getStats(): {
+        totalRuns: number;
+        successfulRuns: number;
+        failedRuns: number;
+        lastSuccessAt: string | null;
+        averageDurationMs: number | null;
+    };
+}
+//# sourceMappingURL=SyncHistoryRepository.d.ts.map

package/dist/repositories/SyncHistoryRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SyncHistoryRepository.d.ts","sourceRoot":"","sources":["../../src/repositories/SyncHistoryRepository.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,IAAI,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE3E;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAA;AAErE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAA;IACV,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,MAAM,EAAE,UAAU,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,EAAE,MAAM,CAAA;CAClB;AAkBD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAA;IACnB,aAAa,EAAE,MAAM,CAAA;IACrB,eAAe,EAAE,MAAM,CAAA;CACxB;AAcD;;GAEG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,EAAE,CAAc;IACxB,OAAO,CAAC,KAAK,CAUZ;gBAEW,EAAE,EAAE,YAAY;IAM5B;;OAEG;IACH,OAAO,CAAC,WAAW;IA0BnB,OAAO,CAAC,iBAAiB;IA6CzB,OAAO,CAAC,UAAU;IAelB;;;OAGG;IACH,QAAQ,IAAI,MAAM;IAOlB;;OAEG;IACH,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,GAAG,IAAI;IAyBpD;;OAEG;IACH,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI;IA8BjF;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAYxC;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAK5C;;OAEG;IACH,UAAU,CAAC,KAAK,GAAE,MAAW,GAAG,gBAAgB,EAAE;IAKlD;;OAEG;IACH,iBAAiB,IAAI,gBAAgB,GAAG,IAAI;IAK5C;;OAEG;IACH,UAAU,IAAI,gBAAgB,EAAE;IAKhC;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;;OAGG;IACH,OAAO,CAAC,UAAU,GAAE,MAAW,GAAG,MAAM;IAOxC;;OAEG;IACH,KAAK,IAAI,MAAM;IAKf;;OAEG;IACH,QAAQ,IAAI;QACV,SAAS,EAAE,MAAM,CAAA;QACjB,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;QAC5B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAA;KACjC;CA6BF"}