local-risk-alert-feed 0.1.0

package/dist/cjs/core/alert-feed.js

@@ -0,0 +1,236 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AlertFeed = void 0;
+const types_1 = require("../types");
+const plugin_registry_1 = require("./plugin-registry");
+const plugin_resolver_1 = require("./plugin-resolver");
+const alert_aggregator_1 = require("./alert-aggregator");
+const time_range_1 = require("./time-range");
+const errors_1 = require("../errors");
+const utils_1 = require("../utils");
+/**
+ * Main AlertFeed class that coordinates plugin fetching and alert aggregation.
+ */
+class AlertFeed {
+    registry;
+    resolver;
+    aggregator;
+    config;
+    constructor(config) {
+        this.registry = new plugin_registry_1.PluginRegistry();
+        this.resolver = new plugin_resolver_1.PluginResolver();
+        this.aggregator = new alert_aggregator_1.AlertAggregator();
+        this.config = {
+            defaultCacheTtlMs: config?.defaultCacheTtlMs ?? 5 * 60 * 1000,
+            pluginTimeoutMs: config?.pluginTimeoutMs ?? 30 * 1000,
+            continueOnPluginError: config?.continueOnPluginError ?? true,
+            maxConcurrentFetches: config?.maxConcurrentFetches ?? 5,
+        };
+        // Register initial plugins if provided
+        if (config?.plugins) {
+            // Don't await here - call registerPlugins separately
+            this.registerPluginsSync(config.plugins);
+        }
+    }
+    /**
+     * Register plugins synchronously (for constructor use).
+     * Initialization happens lazily on first query.
+     */
+    registerPluginsSync(registrations) {
+        for (const reg of registrations) {
+            // Queue registration without awaiting
+            this.registry.register(reg).catch(() => {
+                // Errors will be caught on first query
+            });
+        }
+    }
+    /**
+     * Register plugins with the feed.
+     *
+     * @param registrations - Array of plugin registrations
+     */
+    async registerPlugins(registrations) {
+        await this.registry.registerAll(registrations);
+    }
+    /**
+     * Register a single plugin.
+     *
+     * @param registration - Plugin registration
+     */
+    async registerPlugin(registration) {
+        await this.registry.register(registration);
+    }
+    /**
+     * Unregister a plugin by ID.
+     *
+     * @param pluginId - The plugin ID to unregister
+     */
+    async unregisterPlugin(pluginId) {
+        await this.registry.unregister(pluginId);
+    }
+    /**
+     * Query for alerts based on location and filters.
+     *
+     * @param query - Query parameters
+     * @returns Query response with alerts and metadata
+     */
+    async query(query) {
+        // Normalize query parameters
+        const radiusMeters = query.radiusMeters ?? types_1.DEFAULT_QUERY_RADIUS_METERS;
+        const limit = query.limit ?? types_1.DEFAULT_QUERY_LIMIT;
+        const timeRange = (0, time_range_1.normalizeTimeRange)(query.timeRange);
+        // Get all enabled plugins
+        const allPlugins = this.registry.getAll(true);
+        // Resolve which plugins to query based on location and filters
+        const applicablePlugins = this.resolver.resolve(allPlugins, {
+            location: query.location,
+            categories: query.categories,
+            temporalTypes: query.temporalTypes,
+        });
+        // Fetch from all applicable plugins
+        const { alertSets, pluginResults } = await this.fetchFromPlugins(applicablePlugins, {
+            location: query.location,
+            radiusMeters,
+            timeRange,
+            limit,
+            categories: query.categories,
+            temporalTypes: query.temporalTypes,
+        }, query.includePluginResults ?? false);
+        // Aggregate alerts
+        const aggregatedAlerts = this.aggregator.aggregate(alertSets, {
+            minRiskLevel: query.minRiskLevel,
+            timeRange,
+            location: query.location,
+            radiusMeters,
+            limit,
+        });
+        const truncated = aggregatedAlerts.length < this.getTotalAlertCount(alertSets);
+        // Build response
+        const response = {
+            alerts: aggregatedAlerts,
+            meta: {
+                totalCount: aggregatedAlerts.length,
+                queriedAt: new Date().toISOString(),
+                timeRange,
+                location: query.location,
+                radiusMeters,
+                truncated,
+            },
+        };
+        if (query.includePluginResults) {
+            response.pluginResults = pluginResults;
+        }
+        return response;
+    }
+    /**
+     * Fetch alerts from multiple plugins with concurrency control.
+     */
+    async fetchFromPlugins(plugins, options, includeResults) {
+        const alertSets = [];
+        const pluginResults = [];
+        // Process plugins with concurrency limit
+        const chunks = this.chunkArray(plugins, this.config.maxConcurrentFetches);
+        for (const chunk of chunks) {
+            const chunkResults = await Promise.all(chunk.map((plugin) => this.fetchFromPlugin(plugin, options)));
+            for (const result of chunkResults) {
+                alertSets.push(result.alerts);
+                if (includeResults) {
+                    pluginResults.push(result.info);
+                }
+            }
+        }
+        return { alertSets, pluginResults };
+    }
+    /**
+     * Fetch alerts from a single plugin with timeout handling.
+     */
+    async fetchFromPlugin(plugin, options) {
+        const startTime = Date.now();
+        const pluginId = plugin.metadata.id;
+        const pluginName = plugin.metadata.name;
+        try {
+            const result = await (0, utils_1.withTimeout)(() => plugin.fetchAlerts(options), this.config.pluginTimeoutMs, `Plugin "${pluginId}" timed out`);
+            return {
+                alerts: result.alerts,
+                info: {
+                    pluginId,
+                    pluginName,
+                    success: true,
+                    alertCount: result.alerts.length,
+                    durationMs: Date.now() - startTime,
+                    fromCache: result.fromCache,
+                    warnings: result.warnings,
+                },
+            };
+        }
+        catch (error) {
+            const durationMs = Date.now() - startTime;
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            const info = {
+                pluginId,
+                pluginName,
+                success: false,
+                alertCount: 0,
+                durationMs,
+                error: errorMessage,
+            };
+            if (!this.config.continueOnPluginError) {
+                if (error instanceof errors_1.PluginTimeoutError) {
+                    throw error;
+                }
+                throw new errors_1.PluginFetchError(pluginId, errorMessage, error instanceof Error ? error : undefined);
+            }
+            return { alerts: [], info };
+        }
+    }
+    /**
+     * Get total count of alerts across all sets.
+     */
+    getTotalAlertCount(alertSets) {
+        return alertSets.reduce((sum, set) => sum + set.length, 0);
+    }
+    /**
+     * Split an array into chunks.
+     */
+    chunkArray(array, size) {
+        const chunks = [];
+        for (let i = 0; i < array.length; i += size) {
+            chunks.push(array.slice(i, i + size));
+        }
+        return chunks;
+    }
+    /**
+     * Get registered plugin metadata.
+     *
+     * @param enabledOnly - Only return enabled plugins (default: true)
+     */
+    getPluginMetadata(enabledOnly = true) {
+        return this.registry.getMetadata(enabledOnly);
+    }
+    /**
+     * Check if a plugin is registered.
+     */
+    hasPlugin(pluginId) {
+        return this.registry.has(pluginId);
+    }
+    /**
+     * Enable a plugin.
+     */
+    async enablePlugin(pluginId) {
+        await this.registry.enable(pluginId);
+    }
+    /**
+     * Disable a plugin.
+     */
+    disablePlugin(pluginId) {
+        this.registry.disable(pluginId);
+    }
+    /**
+     * Dispose of the feed and all plugins.
+     */
+    async dispose() {
+        await this.registry.dispose();
+    }
+}
+exports.AlertFeed = AlertFeed;
+//# sourceMappingURL=alert-feed.js.map

package/dist/cjs/core/alert-feed.js.map

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

package/dist/cjs/core/index.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTimeRangeCurrent = exports.isTimeRangeInFuture = exports.isTimeRangeInPast = exports.getTimeRangeDuration = exports.normalizeTimeRange = exports.getDefaultTimeRangePreset = exports.getDefaultTimeRange = exports.resolveTimeRangePreset = exports.resolveTimeRange = exports.AlertAggregator = exports.PluginResolver = exports.PluginRegistry = exports.AlertFeed = void 0;
+var alert_feed_1 = require("./alert-feed");
+Object.defineProperty(exports, "AlertFeed", { enumerable: true, get: function () { return alert_feed_1.AlertFeed; } });
+var plugin_registry_1 = require("./plugin-registry");
+Object.defineProperty(exports, "PluginRegistry", { enumerable: true, get: function () { return plugin_registry_1.PluginRegistry; } });
+var plugin_resolver_1 = require("./plugin-resolver");
+Object.defineProperty(exports, "PluginResolver", { enumerable: true, get: function () { return plugin_resolver_1.PluginResolver; } });
+var alert_aggregator_1 = require("./alert-aggregator");
+Object.defineProperty(exports, "AlertAggregator", { enumerable: true, get: function () { return alert_aggregator_1.AlertAggregator; } });
+var time_range_1 = require("./time-range");
+Object.defineProperty(exports, "resolveTimeRange", { enumerable: true, get: function () { return time_range_1.resolveTimeRange; } });
+Object.defineProperty(exports, "resolveTimeRangePreset", { enumerable: true, get: function () { return time_range_1.resolveTimeRangePreset; } });
+Object.defineProperty(exports, "getDefaultTimeRange", { enumerable: true, get: function () { return time_range_1.getDefaultTimeRange; } });
+Object.defineProperty(exports, "getDefaultTimeRangePreset", { enumerable: true, get: function () { return time_range_1.getDefaultTimeRangePreset; } });
+Object.defineProperty(exports, "normalizeTimeRange", { enumerable: true, get: function () { return time_range_1.normalizeTimeRange; } });
+Object.defineProperty(exports, "getTimeRangeDuration", { enumerable: true, get: function () { return time_range_1.getTimeRangeDuration; } });
+Object.defineProperty(exports, "isTimeRangeInPast", { enumerable: true, get: function () { return time_range_1.isTimeRangeInPast; } });
+Object.defineProperty(exports, "isTimeRangeInFuture", { enumerable: true, get: function () { return time_range_1.isTimeRangeInFuture; } });
+Object.defineProperty(exports, "isTimeRangeCurrent", { enumerable: true, get: function () { return time_range_1.isTimeRangeCurrent; } });
+//# sourceMappingURL=index.js.map

package/dist/cjs/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":";;;AAAA,2CAAyC;AAAhC,uGAAA,SAAS,OAAA;AAClB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AAEvB,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAExB,2CAUsB;AATpB,8GAAA,gBAAgB,OAAA;AAChB,oHAAA,sBAAsB,OAAA;AACtB,iHAAA,mBAAmB,OAAA;AACnB,uHAAA,yBAAyB,OAAA;AACzB,gHAAA,kBAAkB,OAAA;AAClB,kHAAA,oBAAoB,OAAA;AACpB,+GAAA,iBAAiB,OAAA;AACjB,iHAAA,mBAAmB,OAAA;AACnB,gHAAA,kBAAkB,OAAA"}

package/dist/cjs/core/plugin-registry.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginRegistry = void 0;
+const errors_1 = require("../errors");
+/**
+ * Registry for managing alert plugins.
+ *
+ * Handles registration, initialization, and lifecycle of plugins.
+ */
+class PluginRegistry {
+    plugins = new Map();
+    /**
+     * Register a single plugin.
+     *
+     * @param registration - Plugin registration details
+     * @throws DuplicatePluginError if a plugin with the same ID is already registered
+     */
+    async register(registration) {
+        const { plugin, config, enabled = true } = registration;
+        const pluginId = plugin.metadata.id;
+        if (this.plugins.has(pluginId)) {
+            throw new errors_1.DuplicatePluginError(pluginId);
+        }
+        const entry = {
+            plugin,
+            config,
+            enabled,
+            initialized: false,
+        };
+        this.plugins.set(pluginId, entry);
+        // Initialize if enabled
+        if (enabled) {
+            await this.initializePlugin(entry);
+        }
+    }
+    /**
+     * Register multiple plugins at once.
+     *
+     * @param registrations - Array of plugin registrations
+     */
+    async registerAll(registrations) {
+        for (const registration of registrations) {
+            await this.register(registration);
+        }
+    }
+    /**
+     * Unregister a plugin by ID.
+     *
+     * @param pluginId - The plugin ID to unregister
+     * @throws PluginNotFoundError if the plugin is not registered
+     */
+    async unregister(pluginId) {
+        const entry = this.plugins.get(pluginId);
+        if (!entry) {
+            throw new errors_1.PluginNotFoundError(pluginId);
+        }
+        // Dispose if initialized
+        if (entry.initialized && entry.plugin.dispose) {
+            await entry.plugin.dispose();
+        }
+        this.plugins.delete(pluginId);
+    }
+    /**
+     * Get a plugin by ID.
+     *
+     * @param pluginId - The plugin ID to retrieve
+     * @returns The plugin instance or undefined if not found
+     */
+    get(pluginId) {
+        return this.plugins.get(pluginId)?.plugin;
+    }
+    /**
+     * Get all registered plugins.
+     *
+     * @param enabledOnly - If true, only return enabled plugins (default: true)
+     * @returns Array of plugin instances
+     */
+    getAll(enabledOnly = true) {
+        const plugins = [];
+        for (const entry of this.plugins.values()) {
+            if (!enabledOnly || entry.enabled) {
+                plugins.push(entry.plugin);
+            }
+        }
+        return plugins;
+    }
+    /**
+     * Get metadata for all registered plugins.
+     *
+     * @param enabledOnly - If true, only return enabled plugins
+     * @returns Array of plugin metadata
+     */
+    getMetadata(enabledOnly = true) {
+        return this.getAll(enabledOnly).map((p) => p.metadata);
+    }
+    /**
+     * Check if a plugin is registered.
+     *
+     * @param pluginId - The plugin ID to check
+     * @returns true if the plugin is registered
+     */
+    has(pluginId) {
+        return this.plugins.has(pluginId);
+    }
+    /**
+     * Enable a registered plugin.
+     *
+     * @param pluginId - The plugin ID to enable
+     */
+    async enable(pluginId) {
+        const entry = this.plugins.get(pluginId);
+        if (!entry) {
+            throw new errors_1.PluginNotFoundError(pluginId);
+        }
+        entry.enabled = true;
+        if (!entry.initialized) {
+            await this.initializePlugin(entry);
+        }
+    }
+    /**
+     * Disable a registered plugin.
+     *
+     * @param pluginId - The plugin ID to disable
+     */
+    disable(pluginId) {
+        const entry = this.plugins.get(pluginId);
+        if (!entry) {
+            throw new errors_1.PluginNotFoundError(pluginId);
+        }
+        entry.enabled = false;
+    }
+    /**
+     * Check if a plugin is enabled.
+     *
+     * @param pluginId - The plugin ID to check
+     * @returns true if the plugin is enabled
+     */
+    isEnabled(pluginId) {
+        return this.plugins.get(pluginId)?.enabled ?? false;
+    }
+    /**
+     * Get the number of registered plugins.
+     *
+     * @param enabledOnly - If true, only count enabled plugins
+     */
+    size(enabledOnly = false) {
+        if (!enabledOnly) {
+            return this.plugins.size;
+        }
+        let count = 0;
+        for (const entry of this.plugins.values()) {
+            if (entry.enabled)
+                count++;
+        }
+        return count;
+    }
+    /**
+     * Dispose all plugins and clear the registry.
+     */
+    async dispose() {
+        for (const entry of this.plugins.values()) {
+            if (entry.initialized && entry.plugin.dispose) {
+                try {
+                    await entry.plugin.dispose();
+                }
+                catch {
+                    // Ignore disposal errors
+                }
+            }
+        }
+        this.plugins.clear();
+    }
+    /**
+     * Initialize a plugin.
+     */
+    async initializePlugin(entry) {
+        if (entry.initialized)
+            return;
+        const pluginId = entry.plugin.metadata.id;
+        try {
+            if (entry.plugin.initialize) {
+                await entry.plugin.initialize(entry.config);
+            }
+            entry.initialized = true;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new errors_1.PluginInitializationError(pluginId, message, error instanceof Error ? error : undefined);
+        }
+    }
+}
+exports.PluginRegistry = PluginRegistry;
+//# sourceMappingURL=plugin-registry.js.map

package/dist/cjs/core/plugin-registry.js.map

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

package/dist/cjs/core/plugin-resolver.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginResolver = void 0;
+/**
+ * Resolves which plugins are applicable for a given query.
+ *
+ * Determines plugin coverage based on:
+ * - Geographic coverage (global or regional with center + radius)
+ * - Supported alert categories
+ * - Supported temporal types
+ */
+class PluginResolver {
+    /**
+     * Resolve which plugins cover the given location and match the filters.
+     *
+     * @param plugins - Available plugins to check
+     * @param options - Resolution options including location and filters
+     * @returns Array of plugins that match all criteria
+     */
+    resolve(plugins, options) {
+        const { location, categories, temporalTypes } = options;
+        return plugins.filter((plugin) => {
+            // Check location coverage
+            if (!plugin.coversLocation(location)) {
+                return false;
+            }
+            // Check category support
+            if (categories && categories.length > 0) {
+                const supported = plugin.metadata.supportedCategories;
+                const hasCategory = categories.some((c) => supported.includes(c));
+                if (!hasCategory) {
+                    return false;
+                }
+            }
+            // Check temporal type support
+            if (temporalTypes && temporalTypes.length > 0) {
+                const supported = plugin.metadata.supportedTemporalTypes;
+                const hasTemporalType = temporalTypes.some((t) => supported.includes(t));
+                if (!hasTemporalType) {
+                    return false;
+                }
+            }
+            return true;
+        });
+    }
+    /**
+     * Resolve plugins with detailed coverage information.
+     *
+     * @param plugins - Available plugins to check
+     * @param options - Resolution options
+     * @returns Array of resolved plugins with coverage details
+     */
+    resolveWithDetails(plugins, options) {
+        const { location, categories, temporalTypes } = options;
+        return plugins.map((plugin) => {
+            const coversLocation = plugin.coversLocation(location);
+            let supportsCategories = true;
+            if (categories && categories.length > 0) {
+                const supported = plugin.metadata.supportedCategories;
+                supportsCategories = categories.some((c) => supported.includes(c));
+            }
+            let supportsTemporalTypes = true;
+            if (temporalTypes && temporalTypes.length > 0) {
+                const supported = plugin.metadata.supportedTemporalTypes;
+                supportsTemporalTypes = temporalTypes.some((t) => supported.includes(t));
+            }
+            return {
+                plugin,
+                coversLocation,
+                supportsCategories,
+                supportsTemporalTypes,
+            };
+        });
+    }
+    /**
+     * Get plugins that cover a specific location (regardless of category/temporal filters).
+     *
+     * @param plugins - Available plugins
+     * @param location - The location to check
+     * @returns Plugins that cover the location
+     */
+    getPluginsForLocation(plugins, location) {
+        return plugins.filter((plugin) => plugin.coversLocation(location));
+    }
+    /**
+     * Get plugins that support specific categories.
+     *
+     * @param plugins - Available plugins
+     * @param categories - Categories to filter by
+     * @returns Plugins that support at least one of the specified categories
+     */
+    getPluginsForCategories(plugins, categories) {
+        if (categories.length === 0) {
+            return plugins;
+        }
+        return plugins.filter((plugin) => {
+            const supported = plugin.metadata.supportedCategories;
+            return categories.some((c) => supported.includes(c));
+        });
+    }
+    /**
+     * Get global plugins (plugins that cover all locations).
+     *
+     * @param plugins - Available plugins
+     * @returns Plugins with global coverage
+     */
+    getGlobalPlugins(plugins) {
+        return plugins.filter((plugin) => plugin.metadata.coverage.type === 'global');
+    }
+    /**
+     * Get regional plugins (plugins that cover specific geographic areas).
+     *
+     * @param plugins - Available plugins
+     * @returns Plugins with regional coverage
+     */
+    getRegionalPlugins(plugins) {
+        return plugins.filter((plugin) => plugin.metadata.coverage.type === 'regional');
+    }
+}
+exports.PluginResolver = PluginResolver;
+//# sourceMappingURL=plugin-resolver.js.map

package/dist/cjs/core/plugin-resolver.js.map

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

package/dist/cjs/core/time-range.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveTimeRangePreset = exports.resolveTimeRange = void 0;
+exports.getDefaultTimeRangePreset = getDefaultTimeRangePreset;
+exports.getDefaultTimeRange = getDefaultTimeRange;
+exports.normalizeTimeRange = normalizeTimeRange;
+exports.getTimeRangeDuration = getTimeRangeDuration;
+exports.isTimeRangeInPast = isTimeRangeInPast;
+exports.isTimeRangeInFuture = isTimeRangeInFuture;
+exports.isTimeRangeCurrent = isTimeRangeCurrent;
+const utils_1 = require("../utils");
+Object.defineProperty(exports, "resolveTimeRangePreset", { enumerable: true, get: function () { return utils_1.resolveTimeRangePreset; } });
+/**
+ * Re-export time range utilities for use in core module.
+ */
+exports.resolveTimeRange = utils_1.resolveTimeRange;
+/**
+ * Get the default time range preset.
+ */
+function getDefaultTimeRangePreset() {
+    return 'next-24h';
+}
+/**
+ * Get the default resolved time range.
+ */
+function getDefaultTimeRange() {
+    return (0, utils_1.resolveTimeRangePreset)(getDefaultTimeRangePreset(), new Date());
+}
+/**
+ * Normalize a time range input to an explicit TimeRange.
+ *
+ * @param input - Time range input (preset or explicit)
+ * @param defaultPreset - Default preset to use if input is undefined
+ * @returns Normalized TimeRange
+ */
+function normalizeTimeRange(input, defaultPreset = 'next-24h') {
+    if (!input) {
+        return (0, utils_1.resolveTimeRangePreset)(defaultPreset, new Date());
+    }
+    return (0, utils_1.resolveTimeRange)(input, new Date());
+}
+/**
+ * Get the duration of a time range in milliseconds.
+ */
+function getTimeRangeDuration(range) {
+    return new Date(range.end).getTime() - new Date(range.start).getTime();
+}
+/**
+ * Check if a time range is in the past.
+ */
+function isTimeRangeInPast(range) {
+    return new Date(range.end).getTime() < Date.now();
+}
+/**
+ * Check if a time range is in the future.
+ */
+function isTimeRangeInFuture(range) {
+    return new Date(range.start).getTime() > Date.now();
+}
+/**
+ * Check if a time range spans the current time.
+ */
+function isTimeRangeCurrent(range) {
+    const now = Date.now();
+    return new Date(range.start).getTime() <= now && new Date(range.end).getTime() >= now;
+}
+//# sourceMappingURL=time-range.js.map

package/dist/cjs/core/time-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range.js","sourceRoot":"","sources":["../../../src/core/time-range.ts"],"names":[],"mappings":";;;AAYA,8DAEC;AAKD,kDAEC;AASD,gDASC;AAKD,oDAEC;AAKD,8CAEC;AAKD,kDAEC;AAKD,gDAGC;AAnED,oCAA4F;AAMnF,uGAN0C,8BAAsB,OAM1C;AAJ/B;;GAEG;AACU,QAAA,gBAAgB,GAAG,wBAAoB,CAAC;AAGrD;;GAEG;AACH,SAAgB,yBAAyB;IACvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB;IACjC,OAAO,IAAA,8BAAsB,EAAC,yBAAyB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,kBAAkB,CAChC,KAAsB,EACtB,gBAAiC,UAAU;IAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAA,8BAAsB,EAAC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,IAAA,wBAAoB,EAAC,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAgB,oBAAoB,CAAC,KAAgB;IACnD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,SAAgB,iBAAiB,CAAC,KAAgB;IAChD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,SAAgB,mBAAmB,CAAC,KAAgB;IAClD,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACtD,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAAC,KAAgB;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,IAAI,GAAG,CAAC;AACxF,CAAC"}