digitaltwin-core 0.6.1 → 0.7.2

package/dist/components/custom_table_manager.js

@@ -0,0 +1,525 @@
+export class CustomTableManager {
+    /**
+     * Injects required dependencies into the custom table manager instance.
+     *
+     * Called by the Digital Twin Engine during component initialization.
+     *
+     * @param {DatabaseAdapter} db - Database adapter for data operations
+     *
+     * @example
+     * ```typescript
+     * const customTableManager = new MyCustomTableManager()
+     * customTableManager.setDependencies(databaseAdapter)
+     * ```
+     */
+    setDependencies(db) {
+        this.db = db;
+        this.tableName = this.getConfiguration().name;
+    }
+    /**
+     * Initialize the database table with custom columns.
+     *
+     * Creates the table if it doesn't exist, with standard columns (id, created_at, updated_at)
+     * plus the custom columns defined in the configuration.
+     *
+     * @returns {Promise<void>}
+     *
+     * @example
+     * ```typescript
+     * // Called automatically by the framework
+     * await customTableManager.initializeTable()
+     * ```
+     */
+    async initializeTable() {
+        const config = this.getConfiguration();
+        // Use the new createTableWithColumns method from DatabaseAdapter
+        await this.db.createTableWithColumns(config.name, config.columns);
+    }
+    /**
+     * Validate query conditions against requirements.
+     *
+     * @private
+     * @param {Record<string, any>} conditions - Conditions to validate
+     * @param {QueryValidationOptions} options - Validation options
+     * @throws {Error} If validation fails
+     */
+    validateQuery(conditions, options) {
+        if (!options)
+            return;
+        // Check required fields
+        if (options.required) {
+            for (const field of options.required) {
+                if (!(field in conditions)) {
+                    throw new Error(`Field '${field}' is required`);
+                }
+                const value = conditions[field];
+                if (value == null || value === '') {
+                    throw new Error(`Field '${field}' must have a non-empty value`);
+                }
+            }
+        }
+        // Custom validation
+        if (options.validate) {
+            try {
+                options.validate(conditions);
+            }
+            catch (error) {
+                throw new Error(`Validation failed: ${error instanceof Error ? error.message : 'Unknown validation error'}`);
+            }
+        }
+    }
+    /**
+     * Create a new record in the custom table.
+     *
+     * @param {Record<string, any>} data - Data to insert (excluding id, created_at, updated_at)
+     * @returns {Promise<number>} The ID of the created record
+     *
+     * @example
+     * ```typescript
+     * const id = await customTableManager.create({
+     *   sensor_id: 'TEMP001',
+     *   type: 'temperature',
+     *   location: 'Building A - Floor 1',
+     *   active: true
+     * })
+     * console.log(`Created sensor with ID: ${id}`)
+     * ```
+     */
+    async create(data) {
+        const now = new Date();
+        const record = {
+            name: this.tableName,
+            type: 'custom_table_record',
+            url: '',
+            date: now,
+            ...data
+        };
+        // Use the existing save method from DatabaseAdapter
+        const savedRecord = await this.db.save(record);
+        return savedRecord.id;
+    }
+    /**
+     * Find all records in the custom table.
+     *
+     * @returns {Promise<CustomTableRecord[]>} Array of all records
+     *
+     * @example
+     * ```typescript
+     * const allSensors = await customTableManager.findAll()
+     * console.log(`Found ${allSensors.length} sensors`)
+     * ```
+     */
+    async findAll() {
+        const veryOldDate = new Date('1970-01-01');
+        const farFutureDate = new Date('2099-12-31');
+        const records = await this.db.getByDateRange(this.tableName, veryOldDate, farFutureDate, 1000);
+        return records.map(record => ({
+            id: record.id,
+            created_at: record.date,
+            updated_at: record.date,
+            ...this.extractCustomFields(record)
+        }));
+    }
+    /**
+     * Find a record by its ID.
+     *
+     * @param {number} id - The record ID to find
+     * @returns {Promise<CustomTableRecord | null>} The record or null if not found
+     *
+     * @example
+     * ```typescript
+     * const sensor = await customTableManager.findById(123)
+     * if (sensor) {
+     *   console.log(`Sensor: ${sensor.sensor_id}`)
+     * }
+     * ```
+     */
+    async findById(id) {
+        const record = await this.db.getById(id.toString(), this.tableName);
+        if (!record) {
+            return null;
+        }
+        return {
+            id: record.id,
+            created_at: record.date,
+            updated_at: record.date,
+            ...this.extractCustomFields(record)
+        };
+    }
+    /**
+     * Find records by a single column value with optional validation.
+     *
+     * @param {string} columnName - Name of the column to search by
+     * @param {any} value - Value to search for
+     * @param {boolean} required - Whether the value is required (default: true)
+     * @returns {Promise<CustomTableRecord[]>} Array of matching records
+     *
+     * @example
+     * ```typescript
+     * const wmsLayers = await wmsManager.findByColumn('wms_url', 'https://example.com/wms')
+     * const activeLayers = await wmsManager.findByColumn('active', true)
+     *
+     * // Optional value (won't throw if empty)
+     * const layers = await wmsManager.findByColumn('description', '', false)
+     * ```
+     */
+    async findByColumn(columnName, value, required = true) {
+        if (required && (value == null || value === '')) {
+            throw new Error(`Value for column '${columnName}' is required and cannot be empty`);
+        }
+        return this.findByCondition({ [columnName]: value });
+    }
+    /**
+     * Find records by multiple column values with validation support.
+     *
+     * @param {Record<string, any>} conditions - Key-value pairs to match
+     * @param {QueryValidationOptions} options - Validation options
+     * @returns {Promise<CustomTableRecord[]>} Array of matching records
+     *
+     * @example
+     * ```typescript
+     * // Simple query
+     * const layers = await wmsManager.findByColumns({
+     *   wms_url: 'https://example.com/wms',
+     *   active: true
+     * })
+     *
+     * // With validation
+     * const layers = await wmsManager.findByColumns(
+     *   { wms_url: wmsUrl, projection: projection },
+     *   {
+     *     required: ['wms_url', 'projection'],
+     *     validate: (conditions) => {
+     *       if (!conditions.wms_url.startsWith('http')) {
+     *         throw new Error('WMS URL must start with http or https')
+     *       }
+     *     }
+     *   }
+     * )
+     * ```
+     */
+    async findByColumns(conditions, options) {
+        this.validateQuery(conditions, options);
+        return this.findByCondition(conditions);
+    }
+    /**
+     * Find records matching specific conditions (base method).
+     *
+     * @param {Record<string, any>} conditions - Key-value pairs to match
+     * @returns {Promise<CustomTableRecord[]>} Array of matching records
+     *
+     * @example
+     * ```typescript
+     * const activeSensors = await customTableManager.findByCondition({ active: true })
+     * const tempSensors = await customTableManager.findByCondition({ type: 'temperature' })
+     * ```
+     */
+    async findByCondition(conditions) {
+        const records = await this.db.findByConditions(this.tableName, conditions);
+        return records.map(record => ({
+            id: record.id,
+            created_at: record.date,
+            updated_at: record.date,
+            ...this.extractCustomFields(record)
+        }));
+    }
+    /**
+     * Update a record by its ID.
+     *
+     * @param {number} id - The record ID to update
+     * @param {Record<string, any>} data - Data to update (excluding id, created_at)
+     * @returns {Promise<void>}
+     *
+     * @example
+     * ```typescript
+     * await customTableManager.update(123, {
+     *   active: false,
+     *   last_ping: new Date()
+     * })
+     * ```
+     */
+    async update(id, data) {
+        // Use the new efficient SQL UPDATE method
+        await this.db.updateById(this.tableName, id, data);
+    }
+    /**
+     * Delete a record by its ID.
+     *
+     * @param {number} id - The record ID to delete
+     * @returns {Promise<void>}
+     *
+     * @example
+     * ```typescript
+     * await customTableManager.delete(123)
+     * console.log('Sensor deleted successfully')
+     * ```
+     */
+    async delete(id) {
+        await this.db.delete(id.toString(), this.tableName);
+    }
+    /**
+     * Delete records by a single column value.
+     *
+     * @param {string} columnName - Name of the column to match for deletion
+     * @param {any} value - Value to match for deletion
+     * @returns {Promise<number>} Number of records deleted
+     *
+     * @example
+     * ```typescript
+     * const deleted = await wmsManager.deleteByColumn('active', false)
+     * console.log(`Deleted ${deleted} inactive layers`)
+     * ```
+     */
+    async deleteByColumn(columnName, value) {
+        return this.deleteByCondition({ [columnName]: value });
+    }
+    /**
+     * Delete records matching specific conditions.
+     *
+     * @param {Record<string, any>} conditions - Key-value pairs to match for deletion
+     * @returns {Promise<number>} Number of records deleted
+     *
+     * @example
+     * ```typescript
+     * const deleted = await customTableManager.deleteByCondition({ active: false })
+     * console.log(`Deleted ${deleted} inactive sensors`)
+     * ```
+     */
+    async deleteByCondition(conditions) {
+        const recordsToDelete = await this.findByCondition(conditions);
+        for (const record of recordsToDelete) {
+            await this.delete(record.id);
+        }
+        return recordsToDelete.length;
+    }
+    /**
+     * Extract custom fields from a database record, excluding framework fields.
+     *
+     * @private
+     * @param {any} record - Database record
+     * @returns {Record<string, any>} Custom fields only
+     */
+    extractCustomFields(record) {
+        const config = this.getConfiguration();
+        const customFields = {};
+        for (const columnName of Object.keys(config.columns)) {
+            if (columnName in record) {
+                customFields[columnName] = record[columnName];
+            }
+        }
+        return customFields;
+    }
+    /**
+     * Get HTTP endpoints exposed by this custom table manager.
+     *
+     * Returns both standard CRUD endpoints and custom endpoints defined in configuration.
+     *
+     * @returns {Array} Array of endpoint descriptors with methods, paths, and handlers
+     *
+     * @example
+     * ```typescript
+     * // Standard endpoints for a table named 'sensors':
+     * GET    /sensors         - Get all records
+     * POST   /sensors         - Create new record
+     * GET    /sensors/:id     - Get specific record
+     * PUT    /sensors/:id     - Update specific record
+     * DELETE /sensors/:id     - Delete specific record
+     *
+     * // Plus any custom endpoints defined in configuration
+     * ```
+     */
+    getEndpoints() {
+        const config = this.getConfiguration();
+        const endpoints = [];
+        // Standard CRUD endpoints
+        endpoints.push({
+            method: 'get',
+            path: `/${config.name}`,
+            handler: this.handleGetAll.bind(this),
+            responseType: 'application/json'
+        });
+        endpoints.push({
+            method: 'post',
+            path: `/${config.name}`,
+            handler: this.handleCreate.bind(this),
+            responseType: 'application/json'
+        });
+        endpoints.push({
+            method: 'get',
+            path: `/${config.name}/:id`,
+            handler: this.handleGetById.bind(this),
+            responseType: 'application/json'
+        });
+        endpoints.push({
+            method: 'put',
+            path: `/${config.name}/:id`,
+            handler: this.handleUpdate.bind(this),
+            responseType: 'application/json'
+        });
+        endpoints.push({
+            method: 'delete',
+            path: `/${config.name}/:id`,
+            handler: this.handleDelete.bind(this),
+            responseType: 'application/json'
+        });
+        // Custom endpoints from configuration
+        if (config.endpoints) {
+            for (const endpoint of config.endpoints) {
+                const handlerMethod = this[endpoint.handler];
+                if (typeof handlerMethod === 'function') {
+                    endpoints.push({
+                        method: endpoint.method,
+                        path: `/${config.name}${endpoint.path}`,
+                        handler: handlerMethod.bind(this),
+                        responseType: 'application/json'
+                    });
+                }
+            }
+        }
+        return endpoints;
+    }
+    /**
+     * Standard endpoint handlers for CRUD operations
+     */
+    async handleGetAll(req) {
+        try {
+            const records = await this.findAll();
+            return {
+                status: 200,
+                content: JSON.stringify(records),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+        catch (error) {
+            return {
+                status: 500,
+                content: JSON.stringify({
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+    }
+    async handleCreate(req) {
+        try {
+            if (!req?.body) {
+                return {
+                    status: 400,
+                    content: JSON.stringify({ error: 'Request body is required' }),
+                    headers: { 'Content-Type': 'application/json' }
+                };
+            }
+            const id = await this.create(req.body);
+            return {
+                status: 201,
+                content: JSON.stringify({ id, message: 'Record created successfully' }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+        catch (error) {
+            return {
+                status: 500,
+                content: JSON.stringify({
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+    }
+    async handleGetById(req) {
+        try {
+            const { id } = req.params || {};
+            if (!id) {
+                return {
+                    status: 400,
+                    content: JSON.stringify({ error: 'ID parameter is required' }),
+                    headers: { 'Content-Type': 'application/json' }
+                };
+            }
+            const record = await this.findById(parseInt(id));
+            if (!record) {
+                return {
+                    status: 404,
+                    content: JSON.stringify({ error: 'Record not found' }),
+                    headers: { 'Content-Type': 'application/json' }
+                };
+            }
+            return {
+                status: 200,
+                content: JSON.stringify(record),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+        catch (error) {
+            return {
+                status: 500,
+                content: JSON.stringify({
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+    }
+    async handleUpdate(req) {
+        try {
+            const { id } = req.params || {};
+            if (!id) {
+                return {
+                    status: 400,
+                    content: JSON.stringify({ error: 'ID parameter is required' }),
+                    headers: { 'Content-Type': 'application/json' }
+                };
+            }
+            if (!req?.body) {
+                return {
+                    status: 400,
+                    content: JSON.stringify({ error: 'Request body is required' }),
+                    headers: { 'Content-Type': 'application/json' }
+                };
+            }
+            await this.update(parseInt(id), req.body);
+            return {
+                status: 200,
+                content: JSON.stringify({ message: 'Record updated successfully' }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+        catch (error) {
+            return {
+                status: 500,
+                content: JSON.stringify({
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+    }
+    async handleDelete(req) {
+        try {
+            const { id } = req.params || {};
+            if (!id) {
+                return {
+                    status: 400,
+                    content: JSON.stringify({ error: 'ID parameter is required' }),
+                    headers: { 'Content-Type': 'application/json' }
+                };
+            }
+            await this.delete(parseInt(id));
+            return {
+                status: 200,
+                content: JSON.stringify({ message: 'Record deleted successfully' }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+        catch (error) {
+            return {
+                status: 500,
+                content: JSON.stringify({
+                    error: error instanceof Error ? error.message : 'Unknown error'
+                }),
+                headers: { 'Content-Type': 'application/json' }
+            };
+        }
+    }
+}
+//# sourceMappingURL=custom_table_manager.js.map

package/dist/components/custom_table_manager.js.map

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

package/dist/components/index.d.ts

@@ -2,7 +2,10 @@ export { Collector } from './collector.js';
 export { Harvester } from './harvester.js';
 export { Handler } from './handler.js';
 export { AssetsManager, type AssetMetadataRow, type CreateAssetRequest, type UpdateAssetRequest } from './assets_manager.js';
+export { TilesetManager, type TilesetMetadataRow } from './tileset_manager.js';
+export { MapManager, type MapLayerMetadataRow } from './map_manager.js';
 export { GlobalAssetsHandler } from './global_assets_handler.js';
+export { CustomTableManager, type CustomTableRecord, type QueryValidationOptions, type CustomTableComponent } from './custom_table_manager.js';
 export { Component, Servable } from './interfaces.js';
-export { ComponentConfiguration, AssetsConfiguration, DataResponse } from './types.js';
+export { ComponentConfiguration, AssetsConfiguration, DataResponse, StoreConfiguration, type EndpointDefinition } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACH,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAC1B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACH,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EAC1B,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EACH,kBAAkB,EAClB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EAC5B,MAAM,2BAA2B,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AACrD,OAAO,EACH,sBAAsB,EACtB,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,EAClB,KAAK,kBAAkB,EAC1B,MAAM,YAAY,CAAA"}

package/dist/components/index.js

@@ -2,5 +2,8 @@ export { Collector } from './collector.js';
 export { Harvester } from './harvester.js';
 export { Handler } from './handler.js';
 export { AssetsManager } from './assets_manager.js';
+export { TilesetManager } from './tileset_manager.js';
+export { MapManager } from './map_manager.js';
 export { GlobalAssetsHandler } from './global_assets_handler.js';
+export { CustomTableManager } from './custom_table_manager.js';
 //# sourceMappingURL=index.js.map

package/dist/components/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACH,aAAa,EAIhB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC1C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EACH,aAAa,EAIhB,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,cAAc,EAA2B,MAAM,sBAAsB,CAAA;AAC9E,OAAO,EAAE,UAAU,EAA4B,MAAM,kBAAkB,CAAA;AACvE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,OAAO,EACH,kBAAkB,EAIrB,MAAM,2BAA2B,CAAA"}

package/dist/components/map_manager.d.ts

@@ -0,0 +1,61 @@
+import { AssetsManager } from './assets_manager.js';
+import type { DataResponse } from './types.js';
+/**
+ * Extended metadata for map layer assets
+ */
+export interface MapLayerMetadataRow {
+    id?: number;
+    name: string;
+    type: string;
+    url: string;
+    date: Date;
+    description: string;
+    source: string;
+    owner_id: number | null;
+    filename: string;
+    layer_type?: string;
+    layer_name?: string;
+    geometry_type?: string;
+    properties_count?: number;
+}
+/**
+ * Specialized Assets Manager for handling map layer data.
+ *
+ * Extends the base AssetsManager with specialized logic for:
+ * - Processing JSON layer objects containing map data
+ * - Extracting and analyzing layer metadata
+ * - Storing layer-specific information
+ *
+ * Inherits all CRUD endpoints from AssetsManager:
+ * - GET /{name} - List all layers
+ * - POST /{name}/upload - Upload layer data (overridden)
+ * - GET /{name}/:id - Get layer data
+ * - PUT /{name}/:id - Update layer metadata
+ * - DELETE /{name}/:id - Delete layer
+ * - GET /{name}/:id/download - Download layer data
+ */
+export declare abstract class MapManager extends AssetsManager {
+    /**
+     * Override the upload handler to process JSON layer objects instead of files.
+     *
+     * Processes the layer data:
+     * 1. Validates the layer object structure
+     * 2. Extracts layer-specific metadata
+     * 3. Stores the layer data as JSON
+     *
+     * @param req - HTTP request with layer JSON data
+     * @returns DataResponse with upload result
+     */
+    handleUpload(req: any): Promise<DataResponse>;
+    /**
+     * Analyze layer content to extract metadata
+     * @param layer - The layer object to analyze
+     * @returns Layer metadata information
+     */
+    private analyzeLayerContent;
+    /**
+     * Override retrieve to include layer-specific metadata in the response
+     */
+    retrieve(): Promise<DataResponse>;
+}
+//# sourceMappingURL=map_manager.d.ts.map

package/dist/components/map_manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map_manager.d.ts","sourceRoot":"","sources":["../../src/components/map_manager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,KAAK,EAA0B,YAAY,EAAE,MAAM,YAAY,CAAA;AAGtE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,IAAI,CAAA;IACV,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,QAAQ,EAAE,MAAM,CAAA;IAEhB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;GAeG;AACH,8BAAsB,UAAW,SAAQ,aAAa;IAClD;;;;;;;;;;OAUG;IACG,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,YAAY,CAAC;IAqHnD;;;;OAIG;IACH,OAAO,CAAC,mBAAmB;IA+D3B;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,YAAY,CAAC;CAwC1C"}