local-risk-alert-feed 0.1.0

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

@@ -0,0 +1,189 @@
+import { DuplicatePluginError, PluginNotFoundError, PluginInitializationError, } from '../errors';
+/**
+ * Registry for managing alert plugins.
+ *
+ * Handles registration, initialization, and lifecycle of plugins.
+ */
+export 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 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 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 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 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 PluginInitializationError(pluginId, message, error instanceof Error ? error : undefined);
+        }
+    }
+}
+//# sourceMappingURL=plugin-registry.js.map

package/dist/esm/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/esm/core/plugin-resolver.js

@@ -0,0 +1,117 @@
+/**
+ * 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
+ */
+export 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');
+    }
+}
+//# sourceMappingURL=plugin-resolver.js.map

package/dist/esm/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/esm/core/time-range.js

@@ -0,0 +1,57 @@
+import { resolveTimeRange as resolveTimeRangeUtil, resolveTimeRangePreset } from '../utils';
+/**
+ * Re-export time range utilities for use in core module.
+ */
+export const resolveTimeRange = resolveTimeRangeUtil;
+export { resolveTimeRangePreset };
+/**
+ * Get the default time range preset.
+ */
+export function getDefaultTimeRangePreset() {
+    return 'next-24h';
+}
+/**
+ * Get the default resolved time range.
+ */
+export function getDefaultTimeRange() {
+    return 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
+ */
+export function normalizeTimeRange(input, defaultPreset = 'next-24h') {
+    if (!input) {
+        return resolveTimeRangePreset(defaultPreset, new Date());
+    }
+    return resolveTimeRangeUtil(input, new Date());
+}
+/**
+ * Get the duration of a time range in milliseconds.
+ */
+export function getTimeRangeDuration(range) {
+    return new Date(range.end).getTime() - new Date(range.start).getTime();
+}
+/**
+ * Check if a time range is in the past.
+ */
+export function isTimeRangeInPast(range) {
+    return new Date(range.end).getTime() < Date.now();
+}
+/**
+ * Check if a time range is in the future.
+ */
+export function isTimeRangeInFuture(range) {
+    return new Date(range.start).getTime() > Date.now();
+}
+/**
+ * Check if a time range spans the current time.
+ */
+export 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/esm/core/time-range.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range.js","sourceRoot":"","sources":["../../../src/core/time-range.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE5F;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,oBAAoB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB;IACjC,OAAO,sBAAsB,CAAC,yBAAyB,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,KAAsB,EACtB,gBAAiC,UAAU;IAE3C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,sBAAsB,CAAC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO,oBAAoB,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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"}

package/dist/esm/errors/fetch-error.js

@@ -0,0 +1,67 @@
+/**
+ * Error thrown when an HTTP fetch operation fails.
+ */
+export class FetchError extends Error {
+    code = 'FETCH_ERROR';
+    url;
+    statusCode;
+    statusText;
+    cause;
+    constructor(message, url, options) {
+        super(message);
+        this.name = 'FetchError';
+        this.url = url;
+        this.statusCode = options?.statusCode;
+        this.statusText = options?.statusText;
+        this.cause = options?.cause;
+        Object.setPrototypeOf(this, FetchError.prototype);
+    }
+    /**
+     * Create a FetchError from a failed Response object.
+     */
+    static fromResponse(url, response) {
+        return new FetchError(`HTTP ${response.status}: ${response.statusText}`, url, {
+            statusCode: response.status,
+            statusText: response.statusText,
+        });
+    }
+    /**
+     * Create a FetchError from a network error.
+     */
+    static fromNetworkError(url, error) {
+        return new FetchError(`Network error: ${error.message}`, url, {
+            cause: error,
+        });
+    }
+    /**
+     * Check if this is a client error (4xx status code).
+     */
+    isClientError() {
+        return this.statusCode !== undefined && this.statusCode >= 400 && this.statusCode < 500;
+    }
+    /**
+     * Check if this is a server error (5xx status code).
+     */
+    isServerError() {
+        return this.statusCode !== undefined && this.statusCode >= 500;
+    }
+    /**
+     * Check if this error is retryable (network error or 5xx status).
+     */
+    isRetryable() {
+        return this.statusCode === undefined || this.isServerError() || this.statusCode === 429;
+    }
+    /**
+     * Convert to a plain object for serialization.
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            url: this.url,
+            statusCode: this.statusCode,
+            statusText: this.statusText,
+        };
+    }
+}
+//# sourceMappingURL=fetch-error.js.map

package/dist/esm/errors/fetch-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-error.js","sourceRoot":"","sources":["../../../src/errors/fetch-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,GAAG,aAAa,CAAC;IACrB,GAAG,CAAS;IACZ,UAAU,CAAU;IACpB,UAAU,CAAU;IACpB,KAAK,CAAS;IAEvB,YACE,OAAe,EACf,GAAW,EACX,OAIC;QAED,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,UAAU,GAAG,OAAO,EAAE,UAAU,CAAC;QACtC,IAAI,CAAC,KAAK,GAAG,OAAO,EAAE,KAAK,CAAC;QAC5B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAW,EAAE,QAAkB;QACjD,OAAO,IAAI,UAAU,CAAC,QAAQ,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,UAAU,EAAE,EAAE,GAAG,EAAE;YAC5E,UAAU,EAAE,QAAQ,CAAC,MAAM;YAC3B,UAAU,EAAE,QAAQ,CAAC,UAAU;SAChC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAW,EAAE,KAAY;QAC/C,OAAO,IAAI,UAAU,CAAC,kBAAkB,KAAK,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE;YAC5D,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,GAAG,IAAI,IAAI,CAAC,UAAU,GAAG,GAAG,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,aAAa;QACX,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,IAAI,GAAG,CAAC;IACjE,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,IAAI,CAAC,aAAa,EAAE,IAAI,IAAI,CAAC,UAAU,KAAK,GAAG,CAAC;IAC1F,CAAC;IAED;;OAEG;IACH,MAAM;QAOJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/index.js

@@ -0,0 +1,4 @@
+export { PluginError, PluginInitializationError, PluginFetchError, PluginTimeoutError, DuplicatePluginError, PluginNotFoundError, } from './plugin-error';
+export { ValidationError } from './validation-error';
+export { FetchError } from './fetch-error';
+//# sourceMappingURL=index.js.map

package/dist/esm/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,WAAW,EACX,yBAAyB,EACzB,gBAAgB,EAChB,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGrD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/esm/errors/plugin-error.js

@@ -0,0 +1,71 @@
+/**
+ * Base error class for plugin-related errors.
+ */
+export class PluginError extends Error {
+    pluginId;
+    code;
+    constructor(message, pluginId, code = 'PLUGIN_ERROR') {
+        super(message);
+        this.name = 'PluginError';
+        this.pluginId = pluginId;
+        this.code = code;
+        Object.setPrototypeOf(this, PluginError.prototype);
+    }
+}
+/**
+ * Error thrown when a plugin fails to initialize.
+ */
+export class PluginInitializationError extends PluginError {
+    cause;
+    constructor(pluginId, message, cause) {
+        super(`Plugin "${pluginId}" failed to initialize: ${message}`, pluginId, 'PLUGIN_INIT_ERROR');
+        this.name = 'PluginInitializationError';
+        this.cause = cause;
+        Object.setPrototypeOf(this, PluginInitializationError.prototype);
+    }
+}
+/**
+ * Error thrown when a plugin fetch operation fails.
+ */
+export class PluginFetchError extends PluginError {
+    cause;
+    constructor(pluginId, message, cause) {
+        super(`Plugin "${pluginId}" fetch failed: ${message}`, pluginId, 'PLUGIN_FETCH_ERROR');
+        this.name = 'PluginFetchError';
+        this.cause = cause;
+        Object.setPrototypeOf(this, PluginFetchError.prototype);
+    }
+}
+/**
+ * Error thrown when a plugin operation times out.
+ */
+export class PluginTimeoutError extends PluginError {
+    timeoutMs;
+    constructor(pluginId, timeoutMs) {
+        super(`Plugin "${pluginId}" timed out after ${timeoutMs}ms`, pluginId, 'PLUGIN_TIMEOUT_ERROR');
+        this.name = 'PluginTimeoutError';
+        this.timeoutMs = timeoutMs;
+        Object.setPrototypeOf(this, PluginTimeoutError.prototype);
+    }
+}
+/**
+ * Error thrown when trying to register a plugin with a duplicate ID.
+ */
+export class DuplicatePluginError extends PluginError {
+    constructor(pluginId) {
+        super(`Plugin with ID "${pluginId}" is already registered`, pluginId, 'DUPLICATE_PLUGIN_ERROR');
+        this.name = 'DuplicatePluginError';
+        Object.setPrototypeOf(this, DuplicatePluginError.prototype);
+    }
+}
+/**
+ * Error thrown when a referenced plugin is not found.
+ */
+export class PluginNotFoundError extends PluginError {
+    constructor(pluginId) {
+        super(`Plugin with ID "${pluginId}" not found`, pluginId, 'PLUGIN_NOT_FOUND_ERROR');
+        this.name = 'PluginNotFoundError';
+        Object.setPrototypeOf(this, PluginNotFoundError.prototype);
+    }
+}
+//# sourceMappingURL=plugin-error.js.map

package/dist/esm/errors/plugin-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-error.js","sourceRoot":"","sources":["../../../src/errors/plugin-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,QAAQ,CAAS;IACjB,IAAI,CAAS;IAEtB,YAAY,OAAe,EAAE,QAAgB,EAAE,IAAI,GAAG,cAAc;QAClE,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC;IACrD,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,WAAW;IAC/C,KAAK,CAAS;IAEvB,YAAY,QAAgB,EAAE,OAAe,EAAE,KAAa;QAC1D,KAAK,CAAC,WAAW,QAAQ,2BAA2B,OAAO,EAAE,EAAE,QAAQ,EAAE,mBAAmB,CAAC,CAAC;QAC9F,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,yBAAyB,CAAC,SAAS,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,WAAW;IACtC,KAAK,CAAS;IAEvB,YAAY,QAAgB,EAAE,OAAe,EAAE,KAAa;QAC1D,KAAK,CAAC,WAAW,QAAQ,mBAAmB,OAAO,EAAE,EAAE,QAAQ,EAAE,oBAAoB,CAAC,CAAC;QACvF,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC1D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,WAAW;IACxC,SAAS,CAAS;IAE3B,YAAY,QAAgB,EAAE,SAAiB;QAC7C,KAAK,CACH,WAAW,QAAQ,qBAAqB,SAAS,IAAI,EACrD,QAAQ,EACR,sBAAsB,CACvB,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,kBAAkB,CAAC,SAAS,CAAC,CAAC;IAC5D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,oBAAqB,SAAQ,WAAW;IACnD,YAAY,QAAgB;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,yBAAyB,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC;QAChG,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC9D,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,WAAW;IAClD,YAAY,QAAgB;QAC1B,KAAK,CAAC,mBAAmB,QAAQ,aAAa,EAAE,QAAQ,EAAE,wBAAwB,CAAC,CAAC;QACpF,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAC7D,CAAC;CACF"}

package/dist/esm/errors/validation-error.js

@@ -0,0 +1,45 @@
+/**
+ * Error thrown when input validation fails.
+ */
+export class ValidationError extends Error {
+    code = 'VALIDATION_ERROR';
+    issues;
+    constructor(message, issues) {
+        super(message);
+        this.name = 'ValidationError';
+        this.issues = issues;
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+    /**
+     * Create a ValidationError from a Zod error.
+     */
+    static fromZodError(error) {
+        const issues = error.issues.map((issue) => ({
+            path: issue.path.join('.'),
+            message: issue.message,
+            code: issue.code,
+        }));
+        const paths = issues.map((i) => i.path || 'value').join(', ');
+        const message = `Validation failed for: ${paths}`;
+        return new ValidationError(message, issues);
+    }
+    /**
+     * Get a formatted string representation of all issues.
+     */
+    getFormattedIssues() {
+        return this.issues
+            .map((issue) => `  - ${issue.path || 'value'}: ${issue.message}`)
+            .join('\n');
+    }
+    /**
+     * Convert to a plain object for serialization.
+     */
+    toJSON() {
+        return {
+            code: this.code,
+            message: this.message,
+            issues: this.issues,
+        };
+    }
+}
+//# sourceMappingURL=validation-error.js.map

package/dist/esm/errors/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../../../src/errors/validation-error.ts"],"names":[],"mappings":"AAWA;;GAEG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,GAAG,kBAAkB,CAAC;IAC1B,MAAM,CAAoB;IAEnC,YAAY,OAAe,EAAE,MAAyB;QACpD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAe;QACjC,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAe,EAAE,EAAE,CAAC,CAAC;YACpD,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,IAAI,EAAE,KAAK,CAAC,IAAI;SACjB,CAAC,CAAC,CAAC;QAEJ,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,0BAA0B,KAAK,EAAE,CAAC;QAElD,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,OAAO,IAAI,CAAC,MAAM;aACf,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,IAAI,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;aAChE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF"}