local-risk-alert-feed 0.1.0

package/dist/types/geo/distance.d.ts

@@ -0,0 +1,50 @@
+import type { GeoPoint } from '../types';
+/**
+ * Earth's radius in meters (mean radius).
+ */
+export declare const EARTH_RADIUS_METERS = 6371008.8;
+/**
+ * Convert degrees to radians.
+ */
+export declare function toRadians(degrees: number): number;
+/**
+ * Convert radians to degrees.
+ */
+export declare function toDegrees(radians: number): number;
+/**
+ * Calculate the Haversine distance between two geographic points.
+ *
+ * The Haversine formula calculates the great-circle distance between two points
+ * on a sphere given their latitudes and longitudes.
+ *
+ * @param point1 - First geographic point
+ * @param point2 - Second geographic point
+ * @returns Distance in meters
+ */
+export declare function haversineDistance(point1: GeoPoint, point2: GeoPoint): number;
+/**
+ * Calculate distance between two points (alias for haversineDistance).
+ *
+ * @param point1 - First geographic point
+ * @param point2 - Second geographic point
+ * @returns Distance in meters
+ */
+export declare function calculateDistance(point1: GeoPoint, point2: GeoPoint): number;
+/**
+ * Calculate the bearing (direction) from one point to another.
+ *
+ * @param from - Starting point
+ * @param to - Ending point
+ * @returns Bearing in degrees (0-360, where 0 is north)
+ */
+export declare function calculateBearing(from: GeoPoint, to: GeoPoint): number;
+/**
+ * Calculate a destination point given a start point, bearing, and distance.
+ *
+ * @param start - Starting point
+ * @param bearingDegrees - Bearing in degrees (0-360)
+ * @param distanceMeters - Distance in meters
+ * @returns Destination point
+ */
+export declare function destinationPoint(start: GeoPoint, bearingDegrees: number, distanceMeters: number): GeoPoint;
+//# sourceMappingURL=distance.d.ts.map

package/dist/types/geo/distance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"distance.d.ts","sourceRoot":"","sources":["../../../src/geo/distance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEzC;;GAEG;AACH,eAAO,MAAM,mBAAmB,YAAc,CAAC;AAE/C;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,CAa5E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAG,MAAM,CAE5E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,GAAG,MAAM,CAWrE;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,EACf,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GACrB,QAAQ,CAsBV"}

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

@@ -0,0 +1,3 @@
+export { EARTH_RADIUS_METERS, toRadians, toDegrees, haversineDistance, calculateDistance, calculateBearing, destinationPoint, } from './distance';
+export { isPointInRadius, isPointInCircle, isPointInBoundingBox, doCirclesOverlap, getBoundingBoxForRadius, } from './point-in-radius';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/geo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,SAAS,EACT,SAAS,EACT,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,eAAe,EACf,eAAe,EACf,oBAAoB,EACpB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,mBAAmB,CAAC"}

package/dist/types/geo/point-in-radius.d.ts

@@ -0,0 +1,44 @@
+import type { GeoPoint, GeoBoundingBox, GeoCircle } from '../types';
+/**
+ * Check if a point is within a given radius of a center point.
+ *
+ * @param point - The point to check
+ * @param center - The center point
+ * @param radiusMeters - The radius in meters
+ * @returns true if the point is within the radius
+ */
+export declare function isPointInRadius(point: GeoPoint, center: GeoPoint, radiusMeters: number): boolean;
+/**
+ * Check if a point is within a GeoCircle.
+ *
+ * @param point - The point to check
+ * @param circle - The circle definition
+ * @returns true if the point is within the circle
+ */
+export declare function isPointInCircle(point: GeoPoint, circle: GeoCircle): boolean;
+/**
+ * Check if a point is within a bounding box.
+ *
+ * @param point - The point to check
+ * @param box - The bounding box
+ * @returns true if the point is within the bounding box
+ */
+export declare function isPointInBoundingBox(point: GeoPoint, box: GeoBoundingBox): boolean;
+/**
+ * Check if two circles overlap.
+ *
+ * @param circle1 - First circle
+ * @param circle2 - Second circle
+ * @returns true if the circles overlap
+ */
+export declare function doCirclesOverlap(circle1: GeoCircle, circle2: GeoCircle): boolean;
+/**
+ * Calculate a bounding box that contains a circle.
+ * This is useful for quick filtering before doing precise distance calculations.
+ *
+ * @param center - Center point of the circle
+ * @param radiusMeters - Radius in meters
+ * @returns A bounding box that contains the circle
+ */
+export declare function getBoundingBoxForRadius(center: GeoPoint, radiusMeters: number): GeoBoundingBox;
+//# sourceMappingURL=point-in-radius.d.ts.map

package/dist/types/geo/point-in-radius.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"point-in-radius.d.ts","sourceRoot":"","sources":["../../../src/geo/point-in-radius.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAGpE;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAGhG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,CAE3E;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,GAAG,OAAO,CAmBlF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,GAAG,OAAO,CAGhF;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,GAAG,cAAc,CAe9F"}

package/dist/types/index.d.ts

@@ -0,0 +1,32 @@
+export { AlertFeed } from './core';
+export { PluginRegistry, PluginResolver, AlertAggregator } from './core';
+export { resolveTimeRange, normalizeTimeRange } from './core';
+export type { PluginResolveOptions, ResolvedPlugin, AggregateOptions, AlertSortOrder } from './core';
+export type { GeoPoint, GeoBoundingBox, GeoCircle, AlertLocation, Alert, RiskLevel, AlertPriority, AlertCategory, AlertTemporalType, AlertSourceType, AlertTimestamps, AlertSource, AlertPlugin, PluginMetadata, PluginCoverage, PluginCoverageType, PluginFetchOptions, PluginFetchResult, PluginResultInfo, AlertQuery, AlertQueryResponse, AlertQueryMeta, TimeRange, TimeRangePreset, TimeRangeInput, AlertFeedConfig, PluginRegistration, CacheProvider, } from './types';
+export { RISK_LEVEL_VALUES, RISK_LEVELS, ALERT_CATEGORIES, ALERT_TEMPORAL_TYPES, TIME_RANGE_PRESETS, DEFAULT_QUERY_RADIUS_METERS, DEFAULT_QUERY_LIMIT, MAX_QUERY_LIMIT, DEFAULT_CONFIG, } from './types';
+export { AlertSchema, AlertQuerySchema, AlertQueryRequestSchema, GeoPointSchema, TimeRangeSchema, transformRequestToQuery, } from './schemas';
+export { PluginError, PluginInitializationError, PluginFetchError, PluginTimeoutError, DuplicatePluginError, PluginNotFoundError, ValidationError, FetchError, } from './errors';
+export type { ValidationIssue } from './errors';
+export { haversineDistance, calculateDistance, calculateBearing, destinationPoint, isPointInRadius, isPointInCircle, isPointInBoundingBox, doCirclesOverlap, getBoundingBoxForRadius, } from './geo';
+export { InMemoryCacheProvider, VercelKVCacheProvider, DynamoDBCacheProvider, generateCacheKey, } from './utils';
+export { withRetry, withTimeout, sleep, TimeoutError } from './utils';
+export type { RetryOptions } from './utils';
+export { BasePlugin } from './plugins';
+export type { BasePluginConfig } from './plugins';
+export { NWSWeatherPlugin } from './plugins/weather';
+export type { NWSWeatherPluginConfig } from './plugins/weather';
+export { PhoenixPolicePlugin } from './plugins/police-blotter';
+export type { PhoenixPolicePluginConfig } from './plugins/police-blotter';
+export { PhoenixFirePlugin } from './plugins/fire-emt';
+export type { PhoenixFirePluginConfig } from './plugins/fire-emt';
+export { PulsepointPlugin } from './plugins/pulsepoint';
+export type { PulsepointPluginConfig } from './plugins/pulsepoint';
+export { PhoenixEventsPlugin } from './plugins/events';
+export type { PhoenixEventsPluginConfig } from './plugins/events';
+export { ArizonaTrafficPlugin } from './plugins/traffic';
+export type { ArizonaTrafficPluginConfig } from './plugins/traffic';
+export { AirNowPlugin } from './plugins/air-quality';
+export type { AirNowPluginConfig } from './plugins/air-quality';
+export { parseCSV, toCSV } from './utils';
+export type { CSVParseOptions } from './utils';
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/plugins/air-quality/airnow.plugin.d.ts

@@ -0,0 +1,84 @@
+import type { PluginMetadata, PluginFetchOptions, PluginFetchResult } from '../../types';
+import { BasePlugin, BasePluginConfig } from '../base-plugin';
+/**
+ * AirNow plugin configuration.
+ */
+export interface AirNowPluginConfig extends BasePluginConfig {
+    /** AirNow API key (get one at https://docs.airnowapi.org) */
+    apiKey: string;
+    /** Include forecasts in addition to current observations. Default: true */
+    includeForecast?: boolean;
+    /** Distance in miles for nearby observations. Default: 25 */
+    distanceMiles?: number;
+}
+/**
+ * Plugin that fetches air quality data from AirNow API.
+ *
+ * Provides current AQI observations and forecasts for US locations.
+ * Important for Phoenix due to dust storms and air quality concerns.
+ *
+ * @see https://docs.airnowapi.org
+ */
+export declare class AirNowPlugin extends BasePlugin {
+    readonly metadata: PluginMetadata;
+    private airNowConfig;
+    constructor(config: AirNowPluginConfig);
+    fetchAlerts(options: PluginFetchOptions): Promise<PluginFetchResult>;
+    /**
+     * Fetch air quality data from AirNow API.
+     */
+    private fetchAirQualityData;
+    /**
+     * Fetch current air quality observations.
+     */
+    private fetchCurrentObservations;
+    /**
+     * Fetch air quality forecasts.
+     */
+    private fetchForecasts;
+    /**
+     * Transform an observation to an alert.
+     */
+    private transformObservation;
+    /**
+     * Transform a forecast to an alert.
+     */
+    private transformForecast;
+    /**
+     * Map AQI value to risk level.
+     */
+    private mapAqiToRiskLevel;
+    /**
+     * Build observation title.
+     */
+    private buildObservationTitle;
+    /**
+     * Build forecast title.
+     */
+    private buildForecastTitle;
+    /**
+     * Format pollutant name for display.
+     */
+    private formatPollutant;
+    /**
+     * Format forecast date.
+     */
+    private formatForecastDate;
+    /**
+     * Build observation description.
+     */
+    private buildObservationDescription;
+    /**
+     * Build forecast description.
+     */
+    private buildForecastDescription;
+    /**
+     * Format date as YYYY-MM-DD.
+     */
+    private formatDate;
+    /**
+     * Deduplicate alerts, keeping highest AQI per location/date.
+     */
+    private deduplicateAlerts;
+}
+//# sourceMappingURL=airnow.plugin.d.ts.map

package/dist/types/plugins/air-quality/airnow.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"airnow.plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/air-quality/airnow.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAyC9D;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,gBAAgB;IAC1D,6DAA6D;IAC7D,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAiCD;;;;;;;GAOG;AACH,qBAAa,YAAa,SAAQ,UAAU;IAC1C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAY/B;IAEF,OAAO,CAAC,YAAY,CAAqB;gBAE7B,MAAM,EAAE,kBAAkB;IAYhC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAwB1E;;OAEG;YACW,mBAAmB;IAkCjC;;OAEG;YACW,wBAAwB;IAatC;;OAEG;YACW,cAAc;IAoB5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAmC5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkCzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAezB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAK7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgB1B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAcnC;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA0BhC;;OAEG;IACH,OAAO,CAAC,UAAU;IAIlB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAqB1B"}

package/dist/types/plugins/air-quality/index.d.ts

@@ -0,0 +1,3 @@
+export { AirNowPlugin } from './airnow.plugin';
+export type { AirNowPluginConfig } from './airnow.plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/air-quality/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/air-quality/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,YAAY,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/plugins/base-plugin.d.ts

@@ -0,0 +1,99 @@
+import type { AlertPlugin, PluginMetadata, PluginFetchOptions, PluginFetchResult, GeoPoint, Alert, RiskLevel, AlertPriority, CacheProvider } from '../types';
+import type { CSVParseOptions } from '../utils';
+/**
+ * Configuration for base plugin.
+ */
+export interface BasePluginConfig {
+    /** Cache provider for storing fetched data */
+    cache?: CacheProvider;
+    /** Default cache TTL in milliseconds */
+    cacheTtlMs?: number;
+    /** Number of retry attempts for failed requests */
+    maxRetries?: number;
+    /** User-Agent header for HTTP requests */
+    userAgent?: string;
+}
+/**
+ * Abstract base class for alert plugins.
+ *
+ * Provides common functionality for:
+ * - Location coverage checking
+ * - HTTP fetching with retry
+ * - Caching
+ * - Alert creation helpers
+ */
+export declare abstract class BasePlugin implements AlertPlugin {
+    abstract readonly metadata: PluginMetadata;
+    protected config: BasePluginConfig;
+    protected cache?: CacheProvider;
+    constructor(config?: BasePluginConfig);
+    /**
+     * Initialize the plugin. Override if needed.
+     */
+    initialize(config?: Record<string, unknown>): Promise<void>;
+    /**
+     * Check if this plugin covers the given location.
+     *
+     * For global plugins, always returns true.
+     * For regional plugins, checks if the point is within the coverage radius.
+     */
+    coversLocation(point: GeoPoint): boolean;
+    /**
+     * Fetch alerts. Must be implemented by subclasses.
+     */
+    abstract fetchAlerts(options: PluginFetchOptions): Promise<PluginFetchResult>;
+    /**
+     * Clean up resources. Override if needed.
+     */
+    dispose(): Promise<void>;
+    /**
+     * Fetch JSON data from a URL with retry logic.
+     */
+    protected fetchJson<T>(url: string, init?: RequestInit): Promise<T>;
+    /**
+     * Fetch CSV data from a URL with retry logic.
+     *
+     * @param url - The URL to fetch from
+     * @param options - CSV parsing options
+     * @param init - Optional fetch init options
+     * @returns Parsed CSV data as array of objects
+     */
+    protected fetchCsv<T extends Record<string, unknown> = Record<string, unknown>>(url: string, options?: CSVParseOptions, init?: RequestInit): Promise<T[]>;
+    /**
+     * Get cached data or fetch fresh data.
+     */
+    protected getCachedOrFetch<T>(cacheKey: string, fetcher: () => Promise<T>, ttlMs?: number): Promise<{
+        data: T;
+        fromCache: boolean;
+    }>;
+    /**
+     * Generate a cache key for this plugin and query options.
+     */
+    protected generateCacheKey(options: PluginFetchOptions): string;
+    /**
+     * Create an alert with common fields filled in.
+     */
+    protected createAlert(data: Omit<Alert, 'source'> & {
+        externalId?: string;
+    }): Alert;
+    /**
+     * Get the source type based on plugin categories.
+     */
+    protected getSourceType(): Alert['source']['type'];
+    /**
+     * Map a numeric severity to a risk level.
+     *
+     * @param value - Numeric value (0-100 scale)
+     * @returns Corresponding risk level
+     */
+    protected mapToRiskLevel(value: number): RiskLevel;
+    /**
+     * Map a risk level to a priority.
+     */
+    protected riskLevelToPriority(level: RiskLevel): AlertPriority;
+    /**
+     * Create an empty result (no alerts).
+     */
+    protected emptyResult(): PluginFetchResult;
+}
+//# sourceMappingURL=base-plugin.d.ts.map

package/dist/types/plugins/base-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-plugin.d.ts","sourceRoot":"","sources":["../../../src/plugins/base-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,kBAAkB,EAClB,iBAAiB,EACjB,QAAQ,EACR,KAAK,EACL,SAAS,EACT,aAAa,EACb,aAAa,EACd,MAAM,UAAU,CAAC;AAIlB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,KAAK,CAAC,EAAE,aAAa,CAAC;IACtB,wCAAwC;IACxC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;GAQG;AACH,8BAAsB,UAAW,YAAW,WAAW;IACrD,QAAQ,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAE3C,SAAS,CAAC,MAAM,EAAE,gBAAgB,CAAC;IACnC,SAAS,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC;gBAEpB,MAAM,CAAC,EAAE,gBAAgB;IAUrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IASjE;;;;;OAKG;IACH,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAcxC;;OAEG;IACH,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAE7E;;OAEG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAI9B;;OAEG;cACa,SAAS,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC;IA8BzE;;;;;;;OAOG;cACa,QAAQ,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClF,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,eAAe,EACzB,IAAI,CAAC,EAAE,WAAW,GACjB,OAAO,CAAC,CAAC,EAAE,CAAC;IA+Bf;;OAEG;cACa,gBAAgB,CAAC,CAAC,EAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACzB,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAiB3C;;OAEG;IACH,SAAS,CAAC,gBAAgB,CAAC,OAAO,EAAE,kBAAkB,GAAG,MAAM;IAI/D;;OAEG;IACH,SAAS,CAAC,WAAW,CACnB,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,GACpD,KAAK;IAaR;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAWlD;;;;;OAKG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS;IAQlD;;OAEG;IACH,SAAS,CAAC,mBAAmB,CAAC,KAAK,EAAE,SAAS,GAAG,aAAa;IAW9D;;OAEG;IACH,SAAS,CAAC,WAAW,IAAI,iBAAiB;CAG3C"}

package/dist/types/plugins/events/index.d.ts

@@ -0,0 +1,3 @@
+export { PhoenixEventsPlugin } from './phoenix-events.plugin';
+export type { PhoenixEventsPluginConfig } from './phoenix-events.plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/plugins/events/phoenix-events.plugin.d.ts

@@ -0,0 +1,71 @@
+import type { PluginMetadata, PluginFetchOptions, PluginFetchResult } from '../../types';
+import { BasePlugin, BasePluginConfig } from '../base-plugin';
+/**
+ * Phoenix Events plugin configuration.
+ */
+export interface PhoenixEventsPluginConfig extends BasePluginConfig {
+    /** Ticketmaster API key (required for Ticketmaster data) */
+    ticketmasterApiKey?: string;
+    /** Socrata app token for Phoenix Open Data (optional) */
+    socrataAppToken?: string;
+    /** Maximum events to fetch from each source. Default: 100 */
+    limit?: number;
+    /** Enable Ticketmaster source. Default: true if API key provided */
+    enableTicketmaster?: boolean;
+    /** Enable Phoenix permits source. Default: true */
+    enablePhoenixPermits?: boolean;
+}
+/**
+ * Plugin that fetches event data from Ticketmaster and Phoenix city permits.
+ *
+ * Aggregates from:
+ * - Ticketmaster Discovery API for concerts, sports, theater
+ * - Phoenix Open Data for special event permits (street closures, parades)
+ */
+export declare class PhoenixEventsPlugin extends BasePlugin {
+    readonly metadata: PluginMetadata;
+    private eventsConfig;
+    constructor(config?: PhoenixEventsPluginConfig);
+    fetchAlerts(options: PluginFetchOptions): Promise<PluginFetchResult>;
+    /**
+     * Fetch events from all enabled sources.
+     */
+    private fetchAllEvents;
+    /**
+     * Fetch events from Ticketmaster Discovery API.
+     */
+    private fetchTicketmasterEvents;
+    /**
+     * Transform a Ticketmaster event to our Alert format.
+     */
+    private transformTicketmasterEvent;
+    /**
+     * Fetch events from Phoenix Open Data special events permits.
+     */
+    private fetchPhoenixPermitEvents;
+    /**
+     * Transform a Phoenix permit event to our Alert format.
+     */
+    private transformPhoenixPermitEvent;
+    /**
+     * Assess risk level for a Ticketmaster event.
+     */
+    private assessEventRisk;
+    /**
+     * Assess risk and category for a permit event.
+     */
+    private assessPermitEventRisk;
+    /**
+     * Build description for Ticketmaster event.
+     */
+    private buildTicketmasterDescription;
+    /**
+     * Build description for permit event.
+     */
+    private buildPermitDescription;
+    /**
+     * Deduplicate events that might appear in both sources.
+     */
+    private deduplicateEvents;
+}
+//# sourceMappingURL=phoenix-events.plugin.d.ts.map

package/dist/types/plugins/events/phoenix-events.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoenix-events.plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/events/phoenix-events.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAoB,MAAM,aAAa,CAAC;AAC3G,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAwE9D;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,4DAA4D;IAC5D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,mDAAmD;IACnD,oBAAoB,CAAC,EAAE,OAAO,CAAC;CAChC;AA0CD;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAc/B;IAEF,OAAO,CAAC,YAAY,CAA4B;gBAEpC,MAAM,CAAC,EAAE,yBAAyB;IAUxC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA6B1E;;OAEG;YACW,cAAc;IAkC5B;;OAEG;YACW,uBAAuB;IA0BrC;;OAEG;IACH,OAAO,CAAC,0BAA0B;IAwDlC;;OAEG;YACW,wBAAwB;IAiCtC;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAgDnC;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;OAEG;IACH,OAAO,CAAC,4BAA4B;IA2BpC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,iBAAiB;CA0B1B"}

package/dist/types/plugins/fire-emt/index.d.ts

@@ -0,0 +1,3 @@
+export { PhoenixFirePlugin } from './phoenix-fire.plugin';
+export type { PhoenixFirePluginConfig } from './phoenix-fire.plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/fire-emt/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/fire-emt/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC1D,YAAY,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/types/plugins/fire-emt/phoenix-fire.plugin.d.ts

@@ -0,0 +1,47 @@
+import type { PluginMetadata, PluginFetchOptions, PluginFetchResult } from '../../types';
+import { BasePlugin, BasePluginConfig } from '../base-plugin';
+/**
+ * Phoenix Fire plugin configuration.
+ */
+export interface PhoenixFirePluginConfig extends BasePluginConfig {
+    /** Socrata app token for higher rate limits (optional) */
+    appToken?: string;
+    /** Maximum records to fetch per request. Default: 1000 */
+    limit?: number;
+}
+/**
+ * Plugin that fetches fire and EMS incident data from Phoenix Open Data Portal.
+ *
+ * @see https://www.phoenixopendata.com/dataset/fire-incidents
+ */
+export declare class PhoenixFirePlugin extends BasePlugin {
+    readonly metadata: PluginMetadata;
+    private fireConfig;
+    constructor(config?: PhoenixFirePluginConfig);
+    fetchAlerts(options: PluginFetchOptions): Promise<PluginFetchResult>;
+    /**
+     * Build the Socrata API URL for Phoenix fire data.
+     */
+    private buildApiUrl;
+    /**
+     * Fetch incidents from the API.
+     */
+    private fetchIncidents;
+    /**
+     * Transform a Phoenix Fire incident to our Alert format.
+     */
+    private transformIncident;
+    /**
+     * Map a call type to category and risk level.
+     */
+    private mapCallType;
+    /**
+     * Format call type for display.
+     */
+    private formatCallType;
+    /**
+     * Build description from incident data.
+     */
+    private buildDescription;
+}
+//# sourceMappingURL=phoenix-fire.plugin.d.ts.map

package/dist/types/plugins/fire-emt/phoenix-fire.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoenix-fire.plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/fire-emt/phoenix-fire.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAA4B,MAAM,aAAa,CAAC;AACnH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAuB9D;;GAEG;AACH,MAAM,WAAW,uBAAwB,SAAQ,gBAAgB;IAC/D,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,UAAU;IAC/C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAc/B;IAEF,OAAO,CAAC,UAAU,CAA0B;gBAEhC,MAAM,CAAC,EAAE,uBAAuB;IAQtC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgC1E;;OAEG;IACH,OAAO,CAAC,WAAW;IAyCnB;;OAEG;YACW,cAAc;IAI5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAqDzB;;OAEG;IACH,OAAO,CAAC,WAAW;IA8BnB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAsBzB"}

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

@@ -0,0 +1,17 @@
+export { BasePlugin } from './base-plugin';
+export type { BasePluginConfig } from './base-plugin';
+export { NWSWeatherPlugin } from './weather';
+export type { NWSWeatherPluginConfig } from './weather';
+export { PhoenixPolicePlugin } from './police-blotter';
+export type { PhoenixPolicePluginConfig } from './police-blotter';
+export { PhoenixFirePlugin } from './fire-emt';
+export type { PhoenixFirePluginConfig } from './fire-emt';
+export { PulsepointPlugin } from './pulsepoint';
+export type { PulsepointPluginConfig } from './pulsepoint';
+export { PhoenixEventsPlugin } from './events';
+export type { PhoenixEventsPluginConfig } from './events';
+export { ArizonaTrafficPlugin } from './traffic';
+export type { ArizonaTrafficPluginConfig } from './traffic';
+export { AirNowPlugin } from './air-quality';
+export type { AirNowPluginConfig } from './air-quality';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,YAAY,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAGxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,YAAY,EAAE,yBAAyB,EAAE,MAAM,kBAAkB,CAAC;AAGlE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAG1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,YAAY,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,yBAAyB,EAAE,MAAM,UAAU,CAAC;AAG1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AACjD,YAAY,EAAE,0BAA0B,EAAE,MAAM,WAAW,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/types/plugins/police-blotter/index.d.ts

@@ -0,0 +1,3 @@
+export { PhoenixPolicePlugin } from './phoenix-police.plugin';
+export type { PhoenixPolicePluginConfig } from './phoenix-police.plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/police-blotter/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/police-blotter/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/types/plugins/police-blotter/phoenix-police.plugin.d.ts

@@ -0,0 +1,49 @@
+import type { PluginMetadata, PluginFetchOptions, PluginFetchResult } from '../../types';
+import { BasePlugin, BasePluginConfig } from '../base-plugin';
+/**
+ * Phoenix Police plugin configuration.
+ */
+export interface PhoenixPolicePluginConfig extends BasePluginConfig {
+    /** Socrata app token for higher rate limits (optional) */
+    appToken?: string;
+    /** Maximum records to fetch per request. Default: 1000 */
+    limit?: number;
+}
+/**
+ * Plugin that fetches crime data from the Phoenix Open Data Portal.
+ *
+ * Uses the Phoenix Crime Incidents dataset via Socrata API.
+ *
+ * @see https://www.phoenixopendata.com/dataset/crime-data
+ */
+export declare class PhoenixPolicePlugin extends BasePlugin {
+    readonly metadata: PluginMetadata;
+    private phoenixConfig;
+    constructor(config?: PhoenixPolicePluginConfig);
+    fetchAlerts(options: PluginFetchOptions): Promise<PluginFetchResult>;
+    /**
+     * Build the Socrata API URL for Phoenix crime data.
+     */
+    private buildApiUrl;
+    /**
+     * Fetch incidents from the API.
+     */
+    private fetchIncidents;
+    /**
+     * Transform a Phoenix Police incident to our Alert format.
+     */
+    private transformIncident;
+    /**
+     * Map a crime category to a risk level.
+     */
+    private mapCrimeToRiskLevel;
+    /**
+     * Format the crime category as a title.
+     */
+    private formatCrimeTitle;
+    /**
+     * Build a description from incident data.
+     */
+    private buildDescription;
+}
+//# sourceMappingURL=phoenix-police.plugin.d.ts.map

package/dist/types/plugins/police-blotter/phoenix-police.plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phoenix-police.plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/police-blotter/phoenix-police.plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAa,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAmB9D;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,gBAAgB;IACjE,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgCD;;;;;;GAMG;AACH,qBAAa,mBAAoB,SAAQ,UAAU;IACjD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAc/B;IAEF,OAAO,CAAC,aAAa,CAA4B;gBAErC,MAAM,CAAC,EAAE,yBAAyB;IAQxC,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA4B1E;;OAEG;IACH,OAAO,CAAC,WAAW;IA0CnB;;OAEG;YACW,cAAc;IAI5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4CzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAI3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAqBzB"}

package/dist/types/plugins/pulsepoint/index.d.ts

@@ -0,0 +1,3 @@
+export { PulsepointPlugin } from './pulsepoint.plugin';
+export type { PulsepointPluginConfig } from './pulsepoint.plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/pulsepoint/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/pulsepoint/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC"}