@nahisaho/yata-scale 1.8.5

package/dist/shard/ShardManager.js

@@ -0,0 +1,353 @@
+/**
+ * @nahisaho/yata-scale - Shard Manager
+ *
+ * Manages shard lifecycle, health, and operations
+ */
+import { ok, err } from 'neverthrow';
+import { ShardError, ShardNotFoundError, RebalanceError, } from '../errors.js';
+import { ShardRouter } from './ShardRouter.js';
+/**
+ * Shard manager for lifecycle and operations
+ */
+export class ShardManager {
+    strategyType;
+    storageFactory;
+    shards = new Map();
+    storage = new Map();
+    router;
+    rebalanceJobs = new Map();
+    healthCheckInterval;
+    constructor(strategyType, storageFactory) {
+        this.strategyType = strategyType;
+        this.storageFactory = storageFactory;
+        this.router = new ShardRouter(strategyType, []);
+    }
+    /**
+     * Initialize with shard configurations
+     */
+    async initialize(configs) {
+        for (const config of configs) {
+            await this.createShard(config);
+        }
+        // Start health check
+        this.startHealthCheck();
+    }
+    /**
+     * Create a new shard
+     */
+    async createShard(config) {
+        if (this.shards.has(config.shardId)) {
+            return err(new ShardError(`Shard already exists: ${config.shardId}`, config.shardId));
+        }
+        try {
+            // Create storage
+            const shardStorage = this.storageFactory(config);
+            await shardStorage.open();
+            this.storage.set(config.shardId, shardStorage);
+            // Create shard info
+            const info = {
+                shardId: config.shardId,
+                status: 'active',
+                entityCount: 0,
+                relationshipCount: 0,
+                sizeBytes: 0,
+                location: config.location,
+                endpoint: config.endpoint,
+                replicas: [],
+                lastModified: new Date(),
+                health: {
+                    healthy: true,
+                    latencyMs: 0,
+                    errorRate: 0,
+                    lastChecked: new Date(),
+                },
+            };
+            this.shards.set(config.shardId, info);
+            // Register with router
+            const connection = this.createConnection(info);
+            this.router.registerConnection(connection);
+            return ok(info);
+        }
+        catch (error) {
+            return err(new ShardError(`Failed to create shard: ${error instanceof Error ? error.message : String(error)}`, config.shardId, error instanceof Error ? error : undefined));
+        }
+    }
+    /**
+     * Remove a shard
+     */
+    async removeShard(shardId, graceful = true) {
+        const info = this.shards.get(shardId);
+        if (!info) {
+            return err(new ShardNotFoundError(shardId));
+        }
+        if (graceful && info.entityCount > 0) {
+            // Mark as draining and wait for rebalance
+            this.updateShardStatus(shardId, 'draining');
+            // Start rebalance to move data away
+            const rebalanceResult = await this.startRebalance({
+                targetShards: [...this.shards.keys()].filter((id) => id !== shardId),
+            });
+            if (rebalanceResult.isErr()) {
+                return err(new ShardError(`Failed to drain shard: ${rebalanceResult.error.message}`, shardId, rebalanceResult.error));
+            }
+        }
+        try {
+            // Close and remove storage
+            const shardStorage = this.storage.get(shardId);
+            if (shardStorage) {
+                await shardStorage.close();
+                this.storage.delete(shardId);
+            }
+            // Remove from router
+            this.router.unregisterConnection(shardId);
+            // Remove from shards map
+            this.shards.delete(shardId);
+            return ok(undefined);
+        }
+        catch (error) {
+            return err(new ShardError(`Failed to remove shard: ${error instanceof Error ? error.message : String(error)}`, shardId, error instanceof Error ? error : undefined));
+        }
+    }
+    /**
+     * Get shard info
+     */
+    getShardInfo(shardId) {
+        const info = this.shards.get(shardId);
+        if (!info) {
+            return err(new ShardNotFoundError(shardId));
+        }
+        return ok(info);
+    }
+    /**
+     * List all shards
+     */
+    listShards() {
+        return [...this.shards.values()];
+    }
+    /**
+     * Get shard for an entity
+     */
+    getShardForEntity(entityId) {
+        const routingResult = this.router.routeEntityId(entityId);
+        if (routingResult.isErr()) {
+            return err(routingResult.error);
+        }
+        return ok(routingResult.value.connection.info);
+    }
+    /**
+     * Get storage for an entity
+     */
+    getStorageForEntity(entityId) {
+        const routingResult = this.router.routeEntityId(entityId);
+        if (routingResult.isErr()) {
+            return err(routingResult.error);
+        }
+        const storage = this.storage.get(routingResult.value.shardId);
+        if (!storage) {
+            return err(new ShardNotFoundError(routingResult.value.shardId));
+        }
+        return ok(storage);
+    }
+    /**
+     * Start rebalancing
+     */
+    async startRebalance(options) {
+        const jobId = `rebalance-${Date.now()}`;
+        const job = {
+            jobId,
+            status: 'pending',
+            progress: 0,
+            entitiesMoved: 0,
+            startedAt: new Date(),
+        };
+        this.rebalanceJobs.set(jobId, job);
+        // Mark involved shards as rebalancing
+        const targetShards = options?.targetShards ?? [...this.shards.keys()];
+        for (const shardId of targetShards) {
+            this.updateShardStatus(shardId, 'rebalancing');
+        }
+        // Start rebalance in background
+        this.executeRebalance(jobId, options).catch((error) => {
+            const failedJob = {
+                ...job,
+                status: 'failed',
+                error: error instanceof Error ? error.message : String(error),
+                completedAt: new Date(),
+            };
+            this.rebalanceJobs.set(jobId, failedJob);
+        });
+        return ok(job);
+    }
+    /**
+     * Execute rebalance operation
+     */
+    async executeRebalance(jobId, _options) {
+        const job = this.rebalanceJobs.get(jobId);
+        // Update status
+        const runningJob = {
+            ...job,
+            status: 'running',
+        };
+        this.rebalanceJobs.set(jobId, runningJob);
+        // TODO: Implement actual rebalancing logic
+        // 1. Calculate target distribution
+        // 2. Identify entities to move
+        // 3. Move entities in batches
+        // 4. Update routing
+        // Mark as completed
+        const completedJob = {
+            ...runningJob,
+            status: 'completed',
+            progress: 100,
+            completedAt: new Date(),
+        };
+        this.rebalanceJobs.set(jobId, completedJob);
+        // Reset shard status
+        for (const shardId of this.shards.keys()) {
+            const info = this.shards.get(shardId);
+            if (info.status === 'rebalancing') {
+                this.updateShardStatus(shardId, 'active');
+            }
+        }
+    }
+    /**
+     * Get rebalance status
+     */
+    getRebalanceStatus(jobId) {
+        const job = this.rebalanceJobs.get(jobId);
+        if (!job) {
+            return err(new RebalanceError(`Rebalance job not found: ${jobId}`, jobId));
+        }
+        return ok(job);
+    }
+    /**
+     * Cancel rebalance
+     */
+    async cancelRebalance(jobId) {
+        const job = this.rebalanceJobs.get(jobId);
+        if (!job) {
+            return err(new RebalanceError(`Rebalance job not found: ${jobId}`, jobId));
+        }
+        if (job.status !== 'running' && job.status !== 'pending') {
+            return err(new RebalanceError(`Cannot cancel job in status: ${job.status}`, jobId));
+        }
+        const cancelledJob = {
+            ...job,
+            status: 'cancelled',
+            completedAt: new Date(),
+        };
+        this.rebalanceJobs.set(jobId, cancelledJob);
+        return ok(undefined);
+    }
+    /**
+     * Check health of all shards
+     */
+    async checkHealth() {
+        const results = new Map();
+        for (const [shardId, storage] of this.storage) {
+            const startTime = Date.now();
+            let healthy = true;
+            let errorRate = 0;
+            try {
+                // Simple health check - get entity count
+                await storage.getEntityCount();
+            }
+            catch {
+                healthy = false;
+                errorRate = 1;
+            }
+            const latencyMs = Date.now() - startTime;
+            const health = {
+                healthy,
+                latencyMs,
+                errorRate,
+                lastChecked: new Date(),
+            };
+            results.set(shardId, health);
+            // Update shard info
+            const info = this.shards.get(shardId);
+            if (info) {
+                this.shards.set(shardId, { ...info, health });
+            }
+        }
+        return results;
+    }
+    /**
+     * Repair a shard
+     */
+    async repairShard(shardId) {
+        const storage = this.storage.get(shardId);
+        if (!storage) {
+            return err(new ShardNotFoundError(shardId));
+        }
+        // TODO: Implement repair logic
+        // 1. Validate data integrity
+        // 2. Rebuild indexes if needed
+        // 3. Recover from WAL if available
+        return ok(undefined);
+    }
+    /**
+     * Get the router
+     */
+    getRouter() {
+        return this.router;
+    }
+    /**
+     * Get storage for a shard
+     */
+    getStorage(shardId) {
+        return this.storage.get(shardId);
+    }
+    /**
+     * Close all shards
+     */
+    async close() {
+        this.stopHealthCheck();
+        for (const storage of this.storage.values()) {
+            await storage.close();
+        }
+        this.storage.clear();
+        this.shards.clear();
+    }
+    /**
+     * Update shard status
+     */
+    updateShardStatus(shardId, status) {
+        const info = this.shards.get(shardId);
+        if (info) {
+            this.shards.set(shardId, { ...info, status, lastModified: new Date() });
+        }
+    }
+    /**
+     * Create a connection object for router
+     */
+    createConnection(info) {
+        const self = this;
+        return {
+            shardId: info.shardId,
+            info,
+            isHealthy() {
+                const current = self.shards.get(info.shardId);
+                return current?.health.healthy ?? false;
+            },
+        };
+    }
+    /**
+     * Start health check interval
+     */
+    startHealthCheck() {
+        this.healthCheckInterval = setInterval(async () => {
+            await this.checkHealth();
+        }, 30000); // Check every 30 seconds
+    }
+    /**
+     * Stop health check interval
+     */
+    stopHealthCheck() {
+        if (this.healthCheckInterval) {
+            clearInterval(this.healthCheckInterval);
+            this.healthCheckInterval = undefined;
+        }
+    }
+}
+//# sourceMappingURL=ShardManager.js.map

package/dist/shard/ShardManager.js.map

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

package/dist/shard/ShardRouter.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @nahisaho/yata-scale - Shard Router
+ *
+ * Routes operations to appropriate shards based on partition strategy
+ */
+import { type Result } from 'neverthrow';
+import type { PartitionStrategy, PartitionStrategyType, ShardInfo, Entity, Relationship, GraphQuery } from '../types.js';
+import { ShardNotFoundError, ShardUnavailableError } from '../errors.js';
+import { type RangeConfig } from './RangePartitionStrategy.js';
+/**
+ * Shard connection interface
+ */
+export interface ShardConnection {
+    readonly shardId: string;
+    readonly info: ShardInfo;
+    isHealthy(): boolean;
+}
+/**
+ * Routing result
+ */
+export interface RoutingResult {
+    readonly shardId: string;
+    readonly connection: ShardConnection;
+}
+/**
+ * Multi-shard routing result
+ */
+export interface MultiRoutingResult {
+    readonly routings: Map<string, RoutingResult>;
+    readonly unroutable: string[];
+}
+/**
+ * Shard router for directing operations to appropriate shards
+ */
+export declare class ShardRouter {
+    private strategy;
+    private connections;
+    constructor(strategyType: PartitionStrategyType, shardIds: string[], options?: {
+        rangeConfigs?: RangeConfig[];
+    });
+    /**
+     * Create partition strategy
+     */
+    private createStrategy;
+    /**
+     * Register a shard connection
+     */
+    registerConnection(connection: ShardConnection): void;
+    /**
+     * Unregister a shard connection
+     */
+    unregisterConnection(shardId: string): void;
+    /**
+     * Route a single entity to its shard
+     */
+    routeEntity(entity: Entity): Result<RoutingResult, ShardNotFoundError | ShardUnavailableError>;
+    /**
+     * Route an entity ID to its shard
+     */
+    routeEntityId(entityId: string): Result<RoutingResult, ShardNotFoundError | ShardUnavailableError>;
+    /**
+     * Route multiple entities to their shards
+     */
+    routeEntities(entities: Entity[]): MultiRoutingResult;
+    /**
+     * Route a relationship to its shard (based on source entity)
+     */
+    routeRelationship(relationship: Relationship): Result<RoutingResult, ShardNotFoundError | ShardUnavailableError>;
+    /**
+     * Get shards for a query
+     */
+    getShardsForQuery(query: GraphQuery): string[];
+    /**
+     * Get routing for a shard ID
+     */
+    private getRouting;
+    /**
+     * Check if a shard is available
+     */
+    private isShardAvailable;
+    /**
+     * Get all available shards
+     */
+    private getAllAvailableShards;
+    /**
+     * Get the partition strategy
+     */
+    getStrategy(): PartitionStrategy;
+    /**
+     * Get all registered connections
+     */
+    getConnections(): Map<string, ShardConnection>;
+    /**
+     * Get healthy shard count
+     */
+    getHealthyShardCount(): number;
+    /**
+     * Get total shard count
+     */
+    getTotalShardCount(): number;
+}
+//# sourceMappingURL=ShardRouter.d.ts.map

package/dist/shard/ShardRouter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShardRouter.d.ts","sourceRoot":"","sources":["../../src/shard/ShardRouter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EACV,iBAAiB,EACjB,qBAAqB,EACrB,SAAS,EACT,MAAM,EACN,YAAY,EACZ,UAAU,EACX,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAGvF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,SAAS,IAAI,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC;CAC/B;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAoB;IACpC,OAAO,CAAC,WAAW,CAA2C;gBAG5D,YAAY,EAAE,qBAAqB,EACnC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;KAAE;IAK5C;;OAEG;IACH,OAAO,CAAC,cAAc;IAoBtB;;OAEG;IACH,kBAAkB,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAIrD;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAI3C;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;IAK9F;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC,aAAa,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;IAKlG;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,kBAAkB;IAqBrD;;OAEG;IACH,iBAAiB,CACf,YAAY,EAAE,YAAY,GACzB,MAAM,CAAC,aAAa,EAAE,kBAAkB,GAAG,qBAAqB,CAAC;IAMpE;;OAEG;IACH,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE;IA0B9C;;OAEG;IACH,OAAO,CAAC,UAAU;IAgBlB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAKxB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAU7B;;OAEG;IACH,WAAW,IAAI,iBAAiB;IAIhC;;OAEG;IACH,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC;IAI9C;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAU9B;;OAEG;IACH,kBAAkB,IAAI,MAAM;CAG7B"}

package/dist/shard/ShardRouter.js

@@ -0,0 +1,181 @@
+/**
+ * @nahisaho/yata-scale - Shard Router
+ *
+ * Routes operations to appropriate shards based on partition strategy
+ */
+import { ok, err } from 'neverthrow';
+import { ShardNotFoundError, ShardUnavailableError } from '../errors.js';
+import { HashPartitionStrategy } from './HashPartitionStrategy.js';
+import { RangePartitionStrategy } from './RangePartitionStrategy.js';
+import { GraphPartitionStrategy } from './GraphPartitionStrategy.js';
+/**
+ * Shard router for directing operations to appropriate shards
+ */
+export class ShardRouter {
+    strategy;
+    connections = new Map();
+    constructor(strategyType, shardIds, options) {
+        this.strategy = this.createStrategy(strategyType, shardIds, options);
+    }
+    /**
+     * Create partition strategy
+     */
+    createStrategy(type, shardIds, options) {
+        switch (type) {
+            case 'hash':
+                return new HashPartitionStrategy(shardIds);
+            case 'range':
+                if (!options?.rangeConfigs) {
+                    throw new Error('Range configs required for range partition strategy');
+                }
+                return new RangePartitionStrategy(options.rangeConfigs);
+            case 'graph':
+                return new GraphPartitionStrategy(shardIds);
+            default:
+                throw new Error(`Unknown partition strategy: ${type}`);
+        }
+    }
+    /**
+     * Register a shard connection
+     */
+    registerConnection(connection) {
+        this.connections.set(connection.shardId, connection);
+    }
+    /**
+     * Unregister a shard connection
+     */
+    unregisterConnection(shardId) {
+        this.connections.delete(shardId);
+    }
+    /**
+     * Route a single entity to its shard
+     */
+    routeEntity(entity) {
+        const shardId = this.strategy.getShardId(entity.id, entity.metadata);
+        return this.getRouting(shardId);
+    }
+    /**
+     * Route an entity ID to its shard
+     */
+    routeEntityId(entityId) {
+        const shardId = this.strategy.getShardId(entityId);
+        return this.getRouting(shardId);
+    }
+    /**
+     * Route multiple entities to their shards
+     */
+    routeEntities(entities) {
+        const routings = new Map();
+        const unroutable = [];
+        const entityIds = entities.map((e) => e.id);
+        const shardMap = this.strategy.getShardIds(entityIds);
+        for (const entity of entities) {
+            const shardId = shardMap.get(entity.id);
+            const result = this.getRouting(shardId);
+            if (result.isOk()) {
+                routings.set(entity.id, result.value);
+            }
+            else {
+                unroutable.push(entity.id);
+            }
+        }
+        return { routings, unroutable };
+    }
+    /**
+     * Route a relationship to its shard (based on source entity)
+     */
+    routeRelationship(relationship) {
+        // Route based on source entity for consistency
+        const shardId = this.strategy.getShardId(relationship.sourceId);
+        return this.getRouting(shardId);
+    }
+    /**
+     * Get shards for a query
+     */
+    getShardsForQuery(query) {
+        // If specific entity IDs are requested, route to those shards
+        if (query.entityFilters?.ids && query.entityFilters.ids.length > 0) {
+            const shardSet = new Set();
+            const shardMap = this.strategy.getShardIds(query.entityFilters.ids);
+            for (const shardId of shardMap.values()) {
+                if (this.isShardAvailable(shardId)) {
+                    shardSet.add(shardId);
+                }
+            }
+            return [...shardSet];
+        }
+        // If traversal starts from a specific node, start there
+        if (query.traversal?.startId) {
+            const shardId = this.strategy.getShardId(query.traversal.startId);
+            if (this.isShardAvailable(shardId)) {
+                // For traversals, we may need to query all shards as edges cross boundaries
+                return this.getAllAvailableShards();
+            }
+        }
+        // Otherwise, query all available shards
+        return this.getAllAvailableShards();
+    }
+    /**
+     * Get routing for a shard ID
+     */
+    getRouting(shardId) {
+        const connection = this.connections.get(shardId);
+        if (!connection) {
+            return err(new ShardNotFoundError(shardId));
+        }
+        if (!connection.isHealthy()) {
+            return err(new ShardUnavailableError(shardId));
+        }
+        return ok({ shardId, connection });
+    }
+    /**
+     * Check if a shard is available
+     */
+    isShardAvailable(shardId) {
+        const connection = this.connections.get(shardId);
+        return connection !== undefined && connection.isHealthy();
+    }
+    /**
+     * Get all available shards
+     */
+    getAllAvailableShards() {
+        const available = [];
+        for (const [shardId, connection] of this.connections) {
+            if (connection.isHealthy()) {
+                available.push(shardId);
+            }
+        }
+        return available;
+    }
+    /**
+     * Get the partition strategy
+     */
+    getStrategy() {
+        return this.strategy;
+    }
+    /**
+     * Get all registered connections
+     */
+    getConnections() {
+        return new Map(this.connections);
+    }
+    /**
+     * Get healthy shard count
+     */
+    getHealthyShardCount() {
+        let count = 0;
+        for (const connection of this.connections.values()) {
+            if (connection.isHealthy()) {
+                count++;
+            }
+        }
+        return count;
+    }
+    /**
+     * Get total shard count
+     */
+    getTotalShardCount() {
+        return this.connections.size;
+    }
+}
+//# sourceMappingURL=ShardRouter.js.map

package/dist/shard/ShardRouter.js.map

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

package/dist/shard/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @nahisaho/yata-scale - Shard Module
+ *
+ * Exports for shard management functionality
+ */
+export { ShardManager } from './ShardManager.js';
+export { HashPartitionStrategy } from './HashPartitionStrategy.js';
+export { RangePartitionStrategy } from './RangePartitionStrategy.js';
+export { GraphPartitionStrategy } from './GraphPartitionStrategy.js';
+export { ShardRouter } from './ShardRouter.js';
+export { Rebalancer } from './Rebalancer.js';
+export type { ShardConfig, ShardInfo, ShardStatus, ShardHealth, ShardLocation, PartitionStrategy, PartitionStrategyType, RebalanceOptions, RebalanceJob, } from '../types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shard/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C,YAAY,EACV,WAAW,EACX,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,gBAAgB,EAChB,YAAY,GACb,MAAM,aAAa,CAAC"}