local-risk-alert-feed 0.1.0

package/dist/types/adapters/lambda.d.ts

@@ -0,0 +1,37 @@
+import type { APIGatewayProxyEvent, APIGatewayProxyResult, Context } from 'aws-lambda';
+import type { AlertFeedConfig } from '../types';
+/**
+ * Options for the Lambda handler factory.
+ */
+export interface LambdaHandlerOptions extends AlertFeedConfig {
+    /** CORS origin(s) to allow (default: '*') */
+    corsOrigin?: string | string[];
+    /** Additional CORS headers to allow */
+    corsHeaders?: string[];
+    /** Additional CORS methods to allow */
+    corsMethods?: string[];
+}
+/**
+ * Lambda handler function type.
+ */
+export type LambdaHandler = (event: APIGatewayProxyEvent, context: Context) => Promise<APIGatewayProxyResult>;
+/**
+ * Create an AWS Lambda handler for the AlertFeed.
+ *
+ * Supports both GET (query parameters) and POST (JSON body) requests.
+ *
+ * @param options - Handler configuration options
+ * @returns Lambda handler function
+ *
+ * @example
+ * ```typescript
+ * import { createLambdaHandler } from 'local-risk-alert-feed/adapters/lambda';
+ * import { PhoenixPolicePlugin } from 'local-risk-alert-feed/plugins/police-blotter';
+ *
+ * export const handler = createLambdaHandler({
+ *   plugins: [{ plugin: new PhoenixPolicePlugin() }]
+ * });
+ * ```
+ */
+export declare function createLambdaHandler(options: LambdaHandlerOptions): LambdaHandler;
+//# sourceMappingURL=lambda.d.ts.map

package/dist/types/adapters/lambda.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.d.ts","sourceRoot":"","sources":["../../../src/adapters/lambda.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,UAAU,CAAC;AAKpE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC/B,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,OAAO,KACb,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEpC;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CA4DhF"}

package/dist/types/adapters/vercel.d.ts

@@ -0,0 +1,54 @@
+import type { AlertFeedConfig } from '../types';
+/**
+ * Options for the Vercel handler factory.
+ */
+export interface VercelHandlerOptions extends AlertFeedConfig {
+    /** CORS origin(s) to allow (default: '*') */
+    corsOrigin?: string | string[];
+}
+/**
+ * Next.js App Router request type.
+ */
+interface NextRequest {
+    method: string;
+    url: string;
+    json(): Promise<unknown>;
+    nextUrl: {
+        searchParams: URLSearchParams;
+    };
+}
+/**
+ * Handler function for Next.js App Router.
+ */
+export type VercelHandler = (request: NextRequest) => Promise<Response>;
+/**
+ * Result of createVercelHandler with GET and POST handlers.
+ */
+export interface VercelHandlerResult {
+    GET: VercelHandler;
+    POST: VercelHandler;
+}
+/**
+ * Create Next.js App Router handlers for the AlertFeed.
+ *
+ * Returns GET and POST handlers that can be exported from a route file.
+ *
+ * @param options - Handler configuration options
+ * @returns Object with GET and POST handlers
+ *
+ * @example
+ * ```typescript
+ * // app/api/alerts/route.ts
+ * import { createVercelHandler } from 'local-risk-alert-feed/adapters/vercel';
+ * import { PhoenixPolicePlugin } from 'local-risk-alert-feed/plugins/police-blotter';
+ *
+ * const { GET, POST } = createVercelHandler({
+ *   plugins: [{ plugin: new PhoenixPolicePlugin() }]
+ * });
+ *
+ * export { GET, POST };
+ * ```
+ */
+export declare function createVercelHandler(options: VercelHandlerOptions): VercelHandlerResult;
+export {};
+//# sourceMappingURL=vercel.d.ts.map

package/dist/types/adapters/vercel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vercel.d.ts","sourceRoot":"","sources":["../../../src/adapters/vercel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAsB,MAAM,UAAU,CAAC;AAKpE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,eAAe;IAC3D,6CAA6C;IAC7C,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAChC;AAED;;GAEG;AACH,UAAU,WAAW;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IACzB,OAAO,EAAE;QACP,YAAY,EAAE,eAAe,CAAC;KAC/B,CAAC;CACH;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,aAAa,CAAC;IACnB,IAAI,EAAE,aAAa,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,mBAAmB,CAsDtF"}

package/dist/types/core/alert-aggregator.d.ts

@@ -0,0 +1,81 @@
+import type { Alert, RiskLevel, GeoPoint, TimeRange } from '../types';
+/**
+ * Options for aggregating alerts.
+ */
+export interface AggregateOptions {
+    /** Minimum risk level to include */
+    minRiskLevel?: RiskLevel;
+    /** Maximum number of alerts to return */
+    limit?: number;
+    /** Time range to filter by */
+    timeRange?: TimeRange;
+    /** Center location for distance calculations */
+    location?: GeoPoint;
+    /** Radius in meters for location filtering */
+    radiusMeters?: number;
+}
+/**
+ * Sort order for alerts.
+ */
+export type AlertSortOrder = 'priority-asc' | 'priority-desc' | 'risk-asc' | 'risk-desc' | 'time-asc' | 'time-desc' | 'distance-asc' | 'distance-desc';
+/**
+ * Aggregates, filters, deduplicates, and sorts alerts from multiple sources.
+ */
+export declare class AlertAggregator {
+    /**
+     * Aggregate alerts from multiple sources.
+     *
+     * Combines alerts, removes duplicates, filters by criteria, and sorts.
+     *
+     * @param alertSets - Arrays of alerts from different plugins
+     * @param options - Aggregation options
+     * @returns Aggregated and filtered alerts
+     */
+    aggregate(alertSets: Alert[][], options?: AggregateOptions): Alert[];
+    /**
+     * Remove duplicate alerts based on ID and source.
+     *
+     * If two alerts have the same external ID from the same source,
+     * keep the one with the most recent issued timestamp.
+     */
+    deduplicate(alerts: Alert[]): Alert[];
+    /**
+     * Filter alerts by minimum risk level.
+     */
+    filterByRiskLevel(alerts: Alert[], minLevel: RiskLevel): Alert[];
+    /**
+     * Filter alerts by time range.
+     *
+     * Includes alerts where:
+     * - The issued timestamp falls within the range, OR
+     * - The event start/end times overlap with the range
+     */
+    filterByTimeRange(alerts: Alert[], range: TimeRange): Alert[];
+    /**
+     * Filter alerts by distance from a center point.
+     */
+    filterByRadius(alerts: Alert[], center: GeoPoint, radiusMeters: number): Alert[];
+    /**
+     * Sort alerts by one or more criteria.
+     *
+     * Later criteria are used as tiebreakers.
+     */
+    sort(alerts: Alert[], orders: AlertSortOrder[]): Alert[];
+    /**
+     * Compare two alerts based on a sort order.
+     */
+    private compare;
+    /**
+     * Sort alerts by distance from a center point.
+     */
+    sortByDistance(alerts: Alert[], center: GeoPoint, ascending?: boolean): Alert[];
+    /**
+     * Group alerts by category.
+     */
+    groupByCategory(alerts: Alert[]): Map<string, Alert[]>;
+    /**
+     * Group alerts by source plugin.
+     */
+    groupBySource(alerts: Alert[]): Map<string, Alert[]>;
+}
+//# sourceMappingURL=alert-aggregator.d.ts.map

package/dist/types/core/alert-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-aggregator.d.ts","sourceRoot":"","sources":["../../../src/core/alert-aggregator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAItE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8BAA8B;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,eAAe,GACf,UAAU,GACV,WAAW,GACX,UAAU,GACV,WAAW,GACX,cAAc,GACd,eAAe,CAAC;AAEpB;;GAEG;AACH,qBAAa,eAAe;IAC1B;;;;;;;;OAQG;IACH,SAAS,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,GAAE,gBAAqB,GAAG,KAAK,EAAE;IAiCxE;;;;;OAKG;IACH,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE;IAwCrC;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,GAAG,KAAK,EAAE;IAKhE;;;;;;OAMG;IACH,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,GAAG,KAAK,EAAE;IAiC7D;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,KAAK,EAAE;IAOhF;;;;OAIG;IACH,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,cAAc,EAAE,GAAG,KAAK,EAAE;IAUxD;;OAEG;IACH,OAAO,CAAC,OAAO;IAqBf;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,UAAO,GAAG,KAAK,EAAE;IAQ5E;;OAEG;IACH,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;IAYtD;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;CAWrD"}

package/dist/types/core/alert-feed.d.ts

@@ -0,0 +1,80 @@
+import type { AlertFeedConfig, AlertQuery, AlertQueryResponse, PluginRegistration } from '../types';
+/**
+ * Main AlertFeed class that coordinates plugin fetching and alert aggregation.
+ */
+export declare class AlertFeed {
+    private registry;
+    private resolver;
+    private aggregator;
+    private config;
+    constructor(config?: AlertFeedConfig);
+    /**
+     * Register plugins synchronously (for constructor use).
+     * Initialization happens lazily on first query.
+     */
+    private registerPluginsSync;
+    /**
+     * Register plugins with the feed.
+     *
+     * @param registrations - Array of plugin registrations
+     */
+    registerPlugins(registrations: PluginRegistration[]): Promise<void>;
+    /**
+     * Register a single plugin.
+     *
+     * @param registration - Plugin registration
+     */
+    registerPlugin(registration: PluginRegistration): Promise<void>;
+    /**
+     * Unregister a plugin by ID.
+     *
+     * @param pluginId - The plugin ID to unregister
+     */
+    unregisterPlugin(pluginId: string): Promise<void>;
+    /**
+     * Query for alerts based on location and filters.
+     *
+     * @param query - Query parameters
+     * @returns Query response with alerts and metadata
+     */
+    query(query: AlertQuery): Promise<AlertQueryResponse>;
+    /**
+     * Fetch alerts from multiple plugins with concurrency control.
+     */
+    private fetchFromPlugins;
+    /**
+     * Fetch alerts from a single plugin with timeout handling.
+     */
+    private fetchFromPlugin;
+    /**
+     * Get total count of alerts across all sets.
+     */
+    private getTotalAlertCount;
+    /**
+     * Split an array into chunks.
+     */
+    private chunkArray;
+    /**
+     * Get registered plugin metadata.
+     *
+     * @param enabledOnly - Only return enabled plugins (default: true)
+     */
+    getPluginMetadata(enabledOnly?: boolean): import("../types").PluginMetadata[];
+    /**
+     * Check if a plugin is registered.
+     */
+    hasPlugin(pluginId: string): boolean;
+    /**
+     * Enable a plugin.
+     */
+    enablePlugin(pluginId: string): Promise<void>;
+    /**
+     * Disable a plugin.
+     */
+    disablePlugin(pluginId: string): void;
+    /**
+     * Dispose of the feed and all plugins.
+     */
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=alert-feed.d.ts.map

package/dist/types/core/alert-feed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-feed.d.ts","sourceRoot":"","sources":["../../../src/core/alert-feed.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAInB,MAAM,UAAU,CAAC;AASlB;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,UAAU,CAAkB;IACpC,OAAO,CAAC,MAAM,CAKZ;gBAEU,MAAM,CAAC,EAAE,eAAe;IAkBpC;;;OAGG;IACH,OAAO,CAAC,mBAAmB;IAS3B;;;;OAIG;IACG,eAAe,CAAC,aAAa,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzE;;;;OAIG;IACG,cAAc,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE;;;;OAIG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvD;;;;;OAKG;IACG,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6D3D;;OAEG;YACW,gBAAgB;IA8B9B;;OAEG;YACW,eAAe;IAuD7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAI1B;;OAEG;IACH,OAAO,CAAC,UAAU;IAQlB;;;;OAIG;IACH,iBAAiB,CAAC,WAAW,UAAO;IAIpC;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC;;OAEG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAInD;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAIrC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/dist/types/core/index.d.ts

@@ -0,0 +1,8 @@
+export { AlertFeed } from './alert-feed';
+export { PluginRegistry } from './plugin-registry';
+export { PluginResolver } from './plugin-resolver';
+export type { PluginResolveOptions, ResolvedPlugin } from './plugin-resolver';
+export { AlertAggregator } from './alert-aggregator';
+export type { AggregateOptions, AlertSortOrder } from './alert-aggregator';
+export { resolveTimeRange, resolveTimeRangePreset, getDefaultTimeRange, getDefaultTimeRangePreset, normalizeTimeRange, getTimeRangeDuration, isTimeRangeInPast, isTimeRangeInFuture, isTimeRangeCurrent, } from './time-range';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,kBAAkB,EAClB,oBAAoB,EACpB,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/types/core/plugin-registry.d.ts

@@ -0,0 +1,91 @@
+import type { AlertPlugin, PluginRegistration, PluginMetadata } from '../types';
+/**
+ * Registry for managing alert plugins.
+ *
+ * Handles registration, initialization, and lifecycle of plugins.
+ */
+export declare class PluginRegistry {
+    private plugins;
+    /**
+     * Register a single plugin.
+     *
+     * @param registration - Plugin registration details
+     * @throws DuplicatePluginError if a plugin with the same ID is already registered
+     */
+    register(registration: PluginRegistration): Promise<void>;
+    /**
+     * Register multiple plugins at once.
+     *
+     * @param registrations - Array of plugin registrations
+     */
+    registerAll(registrations: PluginRegistration[]): Promise<void>;
+    /**
+     * Unregister a plugin by ID.
+     *
+     * @param pluginId - The plugin ID to unregister
+     * @throws PluginNotFoundError if the plugin is not registered
+     */
+    unregister(pluginId: string): Promise<void>;
+    /**
+     * Get a plugin by ID.
+     *
+     * @param pluginId - The plugin ID to retrieve
+     * @returns The plugin instance or undefined if not found
+     */
+    get(pluginId: string): AlertPlugin | undefined;
+    /**
+     * Get all registered plugins.
+     *
+     * @param enabledOnly - If true, only return enabled plugins (default: true)
+     * @returns Array of plugin instances
+     */
+    getAll(enabledOnly?: boolean): AlertPlugin[];
+    /**
+     * Get metadata for all registered plugins.
+     *
+     * @param enabledOnly - If true, only return enabled plugins
+     * @returns Array of plugin metadata
+     */
+    getMetadata(enabledOnly?: boolean): PluginMetadata[];
+    /**
+     * Check if a plugin is registered.
+     *
+     * @param pluginId - The plugin ID to check
+     * @returns true if the plugin is registered
+     */
+    has(pluginId: string): boolean;
+    /**
+     * Enable a registered plugin.
+     *
+     * @param pluginId - The plugin ID to enable
+     */
+    enable(pluginId: string): Promise<void>;
+    /**
+     * Disable a registered plugin.
+     *
+     * @param pluginId - The plugin ID to disable
+     */
+    disable(pluginId: string): void;
+    /**
+     * Check if a plugin is enabled.
+     *
+     * @param pluginId - The plugin ID to check
+     * @returns true if the plugin is enabled
+     */
+    isEnabled(pluginId: string): boolean;
+    /**
+     * Get the number of registered plugins.
+     *
+     * @param enabledOnly - If true, only count enabled plugins
+     */
+    size(enabledOnly?: boolean): number;
+    /**
+     * Dispose all plugins and clear the registry.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Initialize a plugin.
+     */
+    private initializePlugin;
+}
+//# sourceMappingURL=plugin-registry.d.ts.map

package/dist/types/core/plugin-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-registry.d.ts","sourceRoot":"","sources":["../../../src/core/plugin-registry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAiBhF;;;;GAIG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,OAAO,CAAkC;IAEjD;;;;;OAKG;IACG,QAAQ,CAAC,YAAY,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuB/D;;;;OAIG;IACG,WAAW,CAAC,aAAa,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAMrE;;;;;OAKG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAI9C;;;;;OAKG;IACH,MAAM,CAAC,WAAW,UAAO,GAAG,WAAW,EAAE;IAYzC;;;;;OAKG;IACH,WAAW,CAAC,WAAW,UAAO,GAAG,cAAc,EAAE;IAIjD;;;;;OAKG;IACH,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B;;;;OAIG;IACG,MAAM,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAc7C;;;;OAIG;IACH,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAU/B;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;OAIG;IACH,IAAI,CAAC,WAAW,UAAQ,GAAG,MAAM;IAYjC;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAc9B;;OAEG;YACW,gBAAgB;CAmB/B"}

package/dist/types/core/plugin-resolver.d.ts

@@ -0,0 +1,78 @@
+import type { AlertPlugin, GeoPoint, AlertCategory, AlertTemporalType } from '../types';
+/**
+ * Options for resolving plugins.
+ */
+export interface PluginResolveOptions {
+    /** The location to check coverage for */
+    location: GeoPoint;
+    /** Filter by categories the plugin must support */
+    categories?: AlertCategory[];
+    /** Filter by temporal types the plugin must support */
+    temporalTypes?: AlertTemporalType[];
+}
+/**
+ * Result of plugin resolution with coverage information.
+ */
+export interface ResolvedPlugin {
+    plugin: AlertPlugin;
+    coversLocation: boolean;
+    supportsCategories: boolean;
+    supportsTemporalTypes: boolean;
+}
+/**
+ * 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 declare 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: AlertPlugin[], options: PluginResolveOptions): AlertPlugin[];
+    /**
+     * 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: AlertPlugin[], options: PluginResolveOptions): ResolvedPlugin[];
+    /**
+     * 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: AlertPlugin[], location: GeoPoint): AlertPlugin[];
+    /**
+     * 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: AlertPlugin[], categories: AlertCategory[]): AlertPlugin[];
+    /**
+     * Get global plugins (plugins that cover all locations).
+     *
+     * @param plugins - Available plugins
+     * @returns Plugins with global coverage
+     */
+    getGlobalPlugins(plugins: AlertPlugin[]): AlertPlugin[];
+    /**
+     * Get regional plugins (plugins that cover specific geographic areas).
+     *
+     * @param plugins - Available plugins
+     * @returns Plugins with regional coverage
+     */
+    getRegionalPlugins(plugins: AlertPlugin[]): AlertPlugin[];
+}
+//# sourceMappingURL=plugin-resolver.d.ts.map

package/dist/types/core/plugin-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-resolver.d.ts","sourceRoot":"","sources":["../../../src/core/plugin-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAExF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,yCAAyC;IACzC,QAAQ,EAAE,QAAQ,CAAC;IACnB,mDAAmD;IACnD,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;IAC7B,uDAAuD;IACvD,aAAa,CAAC,EAAE,iBAAiB,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,WAAW,CAAC;IACpB,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,qBAAqB,EAAE,OAAO,CAAC;CAChC;AAED;;;;;;;GAOG;AACH,qBAAa,cAAc;IACzB;;;;;;OAMG;IACH,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,WAAW,EAAE;IA+B7E;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,oBAAoB,GAAG,cAAc,EAAE;IA2B3F;;;;;;OAMG;IACH,qBAAqB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,QAAQ,EAAE,QAAQ,GAAG,WAAW,EAAE;IAIhF;;;;;;OAMG;IACH,uBAAuB,CAAC,OAAO,EAAE,WAAW,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,GAAG,WAAW,EAAE;IAW3F;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;IAIvD;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE;CAG1D"}

package/dist/types/core/time-range.d.ts

@@ -0,0 +1,40 @@
+import type { TimeRange, TimeRangeInput, TimeRangePreset } from '../types';
+import { resolveTimeRange as resolveTimeRangeUtil, resolveTimeRangePreset } from '../utils';
+/**
+ * Re-export time range utilities for use in core module.
+ */
+export declare const resolveTimeRange: typeof resolveTimeRangeUtil;
+export { resolveTimeRangePreset };
+/**
+ * Get the default time range preset.
+ */
+export declare function getDefaultTimeRangePreset(): TimeRangePreset;
+/**
+ * Get the default resolved time range.
+ */
+export declare function getDefaultTimeRange(): TimeRange;
+/**
+ * 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 declare function normalizeTimeRange(input?: TimeRangeInput, defaultPreset?: TimeRangePreset): TimeRange;
+/**
+ * Get the duration of a time range in milliseconds.
+ */
+export declare function getTimeRangeDuration(range: TimeRange): number;
+/**
+ * Check if a time range is in the past.
+ */
+export declare function isTimeRangeInPast(range: TimeRange): boolean;
+/**
+ * Check if a time range is in the future.
+ */
+export declare function isTimeRangeInFuture(range: TimeRange): boolean;
+/**
+ * Check if a time range spans the current time.
+ */
+export declare function isTimeRangeCurrent(range: TimeRange): boolean;
+//# sourceMappingURL=time-range.d.ts.map

package/dist/types/core/time-range.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"time-range.d.ts","sourceRoot":"","sources":["../../../src/core/time-range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3E,OAAO,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAE5F;;GAEG;AACH,eAAO,MAAM,gBAAgB,6BAAuB,CAAC;AACrD,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,eAAe,CAE3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,SAAS,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,CAAC,EAAE,cAAc,EACtB,aAAa,GAAE,eAA4B,GAC1C,SAAS,CAMX;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,CAE7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAE7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAG5D"}

package/dist/types/errors/fetch-error.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Error thrown when an HTTP fetch operation fails.
+ */
+export declare class FetchError extends Error {
+    readonly code = "FETCH_ERROR";
+    readonly url: string;
+    readonly statusCode?: number;
+    readonly statusText?: string;
+    readonly cause?: Error;
+    constructor(message: string, url: string, options?: {
+        statusCode?: number;
+        statusText?: string;
+        cause?: Error;
+    });
+    /**
+     * Create a FetchError from a failed Response object.
+     */
+    static fromResponse(url: string, response: Response): FetchError;
+    /**
+     * Create a FetchError from a network error.
+     */
+    static fromNetworkError(url: string, error: Error): FetchError;
+    /**
+     * Check if this is a client error (4xx status code).
+     */
+    isClientError(): boolean;
+    /**
+     * Check if this is a server error (5xx status code).
+     */
+    isServerError(): boolean;
+    /**
+     * Check if this error is retryable (network error or 5xx status).
+     */
+    isRetryable(): boolean;
+    /**
+     * Convert to a plain object for serialization.
+     */
+    toJSON(): {
+        code: string;
+        message: string;
+        url: string;
+        statusCode?: number;
+        statusText?: string;
+    };
+}
+//# sourceMappingURL=fetch-error.d.ts.map

package/dist/types/errors/fetch-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch-error.d.ts","sourceRoot":"","sources":["../../../src/errors/fetch-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAGrB,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,CAAC,EAAE,KAAK,CAAC;KACf;IAWH;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU;IAOhE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,GAAG,UAAU;IAM9D;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,aAAa,IAAI,OAAO;IAIxB;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,MAAM,IAAI;QACR,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,GAAG,EAAE,MAAM,CAAC;QACZ,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;CASF"}

package/dist/types/errors/index.d.ts

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

package/dist/types/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","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;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/errors/plugin-error.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Base error class for plugin-related errors.
+ */
+export declare class PluginError extends Error {
+    readonly pluginId: string;
+    readonly code: string;
+    constructor(message: string, pluginId: string, code?: string);
+}
+/**
+ * Error thrown when a plugin fails to initialize.
+ */
+export declare class PluginInitializationError extends PluginError {
+    readonly cause?: Error;
+    constructor(pluginId: string, message: string, cause?: Error);
+}
+/**
+ * Error thrown when a plugin fetch operation fails.
+ */
+export declare class PluginFetchError extends PluginError {
+    readonly cause?: Error;
+    constructor(pluginId: string, message: string, cause?: Error);
+}
+/**
+ * Error thrown when a plugin operation times out.
+ */
+export declare class PluginTimeoutError extends PluginError {
+    readonly timeoutMs: number;
+    constructor(pluginId: string, timeoutMs: number);
+}
+/**
+ * Error thrown when trying to register a plugin with a duplicate ID.
+ */
+export declare class DuplicatePluginError extends PluginError {
+    constructor(pluginId: string);
+}
+/**
+ * Error thrown when a referenced plugin is not found.
+ */
+export declare class PluginNotFoundError extends PluginError {
+    constructor(pluginId: string);
+}
+//# sourceMappingURL=plugin-error.d.ts.map

package/dist/types/errors/plugin-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-error.d.ts","sourceRoot":"","sources":["../../../src/errors/plugin-error.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,SAAiB;CAOrE;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,WAAW;IACxD,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM7D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;IAC/C,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;gBAEX,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK;CAM7D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAUhD;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,WAAW;gBACvC,QAAQ,EAAE,MAAM;CAK7B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,WAAW;gBACtC,QAAQ,EAAE,MAAM;CAK7B"}

package/dist/types/errors/validation-error.d.ts

@@ -0,0 +1,34 @@
+import type { ZodError } from 'zod';
+/**
+ * Represents a single validation issue.
+ */
+export interface ValidationIssue {
+    path: string;
+    message: string;
+    code: string;
+}
+/**
+ * Error thrown when input validation fails.
+ */
+export declare class ValidationError extends Error {
+    readonly code = "VALIDATION_ERROR";
+    readonly issues: ValidationIssue[];
+    constructor(message: string, issues: ValidationIssue[]);
+    /**
+     * Create a ValidationError from a Zod error.
+     */
+    static fromZodError(error: ZodError): ValidationError;
+    /**
+     * Get a formatted string representation of all issues.
+     */
+    getFormattedIssues(): string;
+    /**
+     * Convert to a plain object for serialization.
+     */
+    toJSON(): {
+        code: string;
+        message: string;
+        issues: ValidationIssue[];
+    };
+}
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/types/errors/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../../../src/errors/validation-error.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAY,MAAM,KAAK,CAAC;AAE9C;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,sBAAsB;IACnC,QAAQ,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC;gBAEvB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;IAOtD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,eAAe;IAarD;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAM5B;;OAEG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE;CAOvE"}