local-risk-alert-feed 0.1.0

package/dist/esm/utils/cache.js

@@ -0,0 +1,181 @@
+/**
+ * In-memory cache provider implementation.
+ * Suitable for development, testing, or single-instance deployments.
+ */
+export class InMemoryCacheProvider {
+    cache = new Map();
+    cleanupIntervalId;
+    constructor(cleanupIntervalMs = 60_000) {
+        // Periodically clean up expired entries
+        this.cleanupIntervalId = setInterval(() => this.cleanup(), cleanupIntervalMs);
+    }
+    async get(key) {
+        const entry = this.cache.get(key);
+        if (!entry) {
+            return null;
+        }
+        // Check if expired
+        if (entry.expiresAt !== null && Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return null;
+        }
+        return entry.value;
+    }
+    async set(key, value, ttlMs) {
+        const expiresAt = ttlMs ? Date.now() + ttlMs : null;
+        this.cache.set(key, { value, expiresAt });
+    }
+    async delete(key) {
+        this.cache.delete(key);
+    }
+    async has(key) {
+        const value = await this.get(key);
+        return value !== null;
+    }
+    /**
+     * Clear all entries from the cache.
+     */
+    async clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get the number of entries in the cache.
+     */
+    size() {
+        return this.cache.size;
+    }
+    /**
+     * Dispose of the cache provider and stop cleanup interval.
+     */
+    dispose() {
+        if (this.cleanupIntervalId) {
+            clearInterval(this.cleanupIntervalId);
+            this.cleanupIntervalId = undefined;
+        }
+        this.cache.clear();
+    }
+    /**
+     * Remove expired entries from the cache.
+     */
+    cleanup() {
+        const now = Date.now();
+        for (const [key, entry] of this.cache.entries()) {
+            if (entry.expiresAt !== null && now > entry.expiresAt) {
+                this.cache.delete(key);
+            }
+        }
+    }
+}
+/**
+ * Vercel KV cache provider implementation.
+ * Requires @vercel/kv package to be installed.
+ */
+export class VercelKVCacheProvider {
+    kv;
+    prefix;
+    constructor(kv, prefix = 'alert-feed:') {
+        this.kv = kv;
+        this.prefix = prefix;
+    }
+    getKey(key) {
+        return `${this.prefix}${key}`;
+    }
+    async get(key) {
+        const result = await this.kv.get(this.getKey(key));
+        return result ?? null;
+    }
+    async set(key, value, ttlMs) {
+        const fullKey = this.getKey(key);
+        if (ttlMs) {
+            // Vercel KV expects TTL in seconds
+            await this.kv.set(fullKey, value, { ex: Math.ceil(ttlMs / 1000) });
+        }
+        else {
+            await this.kv.set(fullKey, value);
+        }
+    }
+    async delete(key) {
+        await this.kv.del(this.getKey(key));
+    }
+    async has(key) {
+        const exists = await this.kv.exists(this.getKey(key));
+        return exists === 1;
+    }
+}
+/**
+ * DynamoDB cache provider implementation.
+ * Requires @aws-sdk/client-dynamodb and @aws-sdk/lib-dynamodb packages.
+ */
+export class DynamoDBCacheProvider {
+    client;
+    tableName;
+    keyAttribute;
+    valueAttribute;
+    ttlAttribute;
+    constructor(client, options) {
+        this.client = client;
+        this.tableName = options.tableName;
+        this.keyAttribute = options.keyAttribute ?? 'pk';
+        this.valueAttribute = options.valueAttribute ?? 'value';
+        this.ttlAttribute = options.ttlAttribute ?? 'ttl';
+    }
+    async get(key) {
+        const result = await this.client.get({
+            TableName: this.tableName,
+            Key: { [this.keyAttribute]: key },
+        });
+        if (!result.Item) {
+            return null;
+        }
+        // Check if TTL has expired (DynamoDB doesn't immediately delete expired items)
+        const ttl = result.Item[this.ttlAttribute];
+        if (ttl && Date.now() / 1000 > ttl) {
+            return null;
+        }
+        return result.Item[this.valueAttribute];
+    }
+    async set(key, value, ttlMs) {
+        const item = {
+            [this.keyAttribute]: key,
+            [this.valueAttribute]: value,
+        };
+        if (ttlMs) {
+            // DynamoDB TTL expects Unix timestamp in seconds
+            item[this.ttlAttribute] = Math.floor((Date.now() + ttlMs) / 1000);
+        }
+        await this.client.put({
+            TableName: this.tableName,
+            Item: item,
+        });
+    }
+    async delete(key) {
+        await this.client.delete({
+            TableName: this.tableName,
+            Key: { [this.keyAttribute]: key },
+        });
+    }
+    async has(key) {
+        const result = await this.get(key);
+        return result !== null;
+    }
+}
+/**
+ * Generate a cache key for alert feed queries.
+ *
+ * @param pluginId - Plugin identifier
+ * @param location - Location coordinates
+ * @param timeRange - Time range for the query
+ * @returns A unique cache key string
+ */
+export function generateCacheKey(pluginId, location, timeRange) {
+    // Round coordinates to 3 decimal places (~100m precision) for cache hit efficiency
+    const lat = location.latitude.toFixed(3);
+    const lon = location.longitude.toFixed(3);
+    const locationHash = `${lat},${lon}`;
+    // Use date only for time range (hourly granularity would cause too many cache misses)
+    const startDate = timeRange.start.slice(0, 10);
+    const endDate = timeRange.end.slice(0, 10);
+    const timeHash = `${startDate}_${endDate}`;
+    return `alert-feed:${pluginId}:${locationHash}:${timeHash}`;
+}
+//# sourceMappingURL=cache.js.map

package/dist/esm/utils/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../../../src/utils/cache.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACxB,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC/C,iBAAiB,CAAkC;IAE3D,YAAY,iBAAiB,GAAG,MAAM;QACpC,wCAAwC;QACxC,IAAI,CAAC,iBAAiB,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,iBAAiB,CAAC,CAAC;IAChF,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAA8B,CAAC;QAE/D,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,IAAI,CAAC;QACd,CAAC;QAED,mBAAmB;QACnB,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YAC7D,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC,KAAK,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QAChD,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QACpD,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,KAAK,IAAI,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,IAAI;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC3B,aAAa,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;YACtC,IAAI,CAAC,iBAAiB,GAAG,SAAS,CAAC;QACrC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACK,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,SAAS,KAAK,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBACtD,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACxB,EAAE,CAAiB;IACnB,MAAM,CAAS;IAEvB,YAAY,EAAkB,EAAE,MAAM,GAAG,aAAa;QACpD,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEO,MAAM,CAAC,GAAW;QACxB,OAAO,GAAG,IAAI,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAI,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,OAAO,MAAM,IAAI,IAAI,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QAChD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,KAAK,EAAE,CAAC;YACV,mCAAmC;YACnC,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACtD,OAAO,MAAM,KAAK,CAAC,CAAC;IACtB,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAyB;IAC/B,SAAS,CAAS;IAClB,YAAY,CAAS;IACrB,cAAc,CAAS;IACvB,YAAY,CAAS;IAE7B,YACE,MAA8B,EAC9B,OAKC;QAED,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;QACjD,IAAI,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC;QACxD,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACpD,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW;QACtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YACnC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,+EAA+E;QAC/E,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAuB,CAAC;QACjE,IAAI,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAM,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QAChD,MAAM,IAAI,GAA4B;YACpC,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG;YACxB,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,KAAK;SAC7B,CAAC;QAEF,IAAI,KAAK,EAAE,CAAC;YACV,iDAAiD;YACjD,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACpE,CAAC;QAED,MAAM,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC;YACpB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI;SACX,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;YACvB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,GAAG,EAAE;SAClC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnC,OAAO,MAAM,KAAK,IAAI,CAAC;IACzB,CAAC;CACF;AAwBD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAAgB,EAChB,QAAiD,EACjD,SAAyC;IAEzC,mFAAmF;IACnF,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,QAAQ,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1C,MAAM,YAAY,GAAG,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IAErC,sFAAsF;IACtF,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,GAAG,SAAS,IAAI,OAAO,EAAE,CAAC;IAE3C,OAAO,cAAc,QAAQ,IAAI,YAAY,IAAI,QAAQ,EAAE,CAAC;AAC9D,CAAC"}

package/dist/esm/utils/csv.js

@@ -0,0 +1,185 @@
+/**
+ * Simple CSV parser for handling Phoenix Open Data CSV responses.
+ *
+ * This is a lightweight parser that handles:
+ * - Quoted fields with commas
+ * - Escaped quotes within fields
+ * - Header row parsing
+ * - Type coercion for common patterns
+ */
+/**
+ * Parse a CSV string into an array of objects.
+ *
+ * @param csvText - The raw CSV text
+ * @param options - Parser options
+ * @returns Array of parsed objects with headers as keys
+ */
+export function parseCSV(csvText, options = {}) {
+    const { delimiter = ',', hasHeader = true, trimFields = true } = options;
+    const lines = splitCSVLines(csvText);
+    if (lines.length === 0) {
+        return [];
+    }
+    const headerLine = hasHeader ? lines[0] : null;
+    const dataLines = hasHeader ? lines.slice(1) : lines;
+    const headers = headerLine
+        ? parseCSVLine(headerLine, delimiter).map((h) => (trimFields ? h.trim() : h))
+        : [];
+    const results = [];
+    for (const line of dataLines) {
+        if (line.trim() === '')
+            continue;
+        const values = parseCSVLine(line, delimiter);
+        const obj = {};
+        for (let i = 0; i < values.length; i++) {
+            const key = headers[i] ?? `column_${i}`;
+            let value = trimFields ? values[i].trim() : values[i];
+            // Type coercion for common patterns
+            if (options.coerceTypes !== false) {
+                value = coerceValue(value);
+            }
+            obj[key] = value;
+        }
+        results.push(obj);
+    }
+    return results;
+}
+/**
+ * Split CSV text into lines, handling quoted newlines.
+ */
+function splitCSVLines(text) {
+    const lines = [];
+    let currentLine = '';
+    let inQuotes = false;
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        if (char === '"') {
+            // Check for escaped quote
+            if (inQuotes && text[i + 1] === '"') {
+                currentLine += '""';
+                i++;
+            }
+            else {
+                inQuotes = !inQuotes;
+                currentLine += char;
+            }
+        }
+        else if ((char === '\n' || char === '\r') && !inQuotes) {
+            // End of line
+            if (currentLine.length > 0) {
+                lines.push(currentLine);
+            }
+            currentLine = '';
+            // Skip \r\n as single line ending
+            if (char === '\r' && text[i + 1] === '\n') {
+                i++;
+            }
+        }
+        else {
+            currentLine += char;
+        }
+    }
+    // Add final line if exists
+    if (currentLine.length > 0) {
+        lines.push(currentLine);
+    }
+    return lines;
+}
+/**
+ * Parse a single CSV line into fields.
+ */
+function parseCSVLine(line, delimiter) {
+    const fields = [];
+    let currentField = '';
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i++) {
+        const char = line[i];
+        if (char === '"') {
+            if (inQuotes && line[i + 1] === '"') {
+                // Escaped quote
+                currentField += '"';
+                i++;
+            }
+            else {
+                // Toggle quote mode
+                inQuotes = !inQuotes;
+            }
+        }
+        else if (char === delimiter && !inQuotes) {
+            // End of field
+            fields.push(currentField);
+            currentField = '';
+        }
+        else {
+            currentField += char;
+        }
+    }
+    // Add final field
+    fields.push(currentField);
+    return fields;
+}
+/**
+ * Attempt to coerce a string value to a more specific type.
+ */
+function coerceValue(value) {
+    // Empty or null-like values
+    if (value === '' || value.toLowerCase() === 'null' || value.toLowerCase() === 'undefined') {
+        return null;
+    }
+    // Boolean
+    if (value.toLowerCase() === 'true')
+        return true;
+    if (value.toLowerCase() === 'false')
+        return false;
+    // Number (integer or float)
+    if (/^-?\d+$/.test(value)) {
+        const num = parseInt(value, 10);
+        if (!isNaN(num) && num >= Number.MIN_SAFE_INTEGER && num <= Number.MAX_SAFE_INTEGER) {
+            return num;
+        }
+    }
+    if (/^-?\d*\.\d+$/.test(value)) {
+        const num = parseFloat(value);
+        if (!isNaN(num)) {
+            return num;
+        }
+    }
+    // Return as string
+    return value;
+}
+/**
+ * Convert an array of objects to CSV string.
+ */
+export function toCSV(data, options = {}) {
+    if (data.length === 0)
+        return '';
+    const { delimiter = ',' } = options;
+    const headers = options.headers ?? Object.keys(data[0]);
+    const lines = [];
+    // Header row
+    lines.push(headers.map((h) => escapeCSVField(String(h), delimiter)).join(delimiter));
+    // Data rows
+    for (const row of data) {
+        const values = headers.map((h) => {
+            const value = row[h];
+            if (value === null || value === undefined)
+                return '';
+            return escapeCSVField(String(value), delimiter);
+        });
+        lines.push(values.join(delimiter));
+    }
+    return lines.join('\n');
+}
+/**
+ * Escape a field for CSV output.
+ */
+function escapeCSVField(value, delimiter) {
+    // Check if quoting is needed
+    if (value.includes('"') || value.includes(delimiter) || value.includes('\n') || value.includes('\r')) {
+        // Escape quotes by doubling them
+        const escaped = value.replace(/"/g, '""');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+//# sourceMappingURL=csv.js.map

package/dist/esm/utils/csv.js.map

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

package/dist/esm/utils/date.js

@@ -0,0 +1,142 @@
+/**
+ * Duration constants in milliseconds.
+ */
+export const HOUR_MS = 60 * 60 * 1000;
+export const DAY_MS = 24 * HOUR_MS;
+/**
+ * Check if a string is a valid TimeRangePreset.
+ */
+export function isTimeRangePreset(value) {
+    return [
+        'past-24h',
+        'past-7d',
+        'past-30d',
+        'next-4h',
+        'next-12h',
+        'next-24h',
+        'next-7d',
+    ].includes(value);
+}
+/**
+ * Check if an object is a TimeRange.
+ */
+export function isTimeRange(value) {
+    return (typeof value === 'object' &&
+        value !== null &&
+        'start' in value &&
+        'end' in value &&
+        typeof value.start === 'string' &&
+        typeof value.end === 'string');
+}
+/**
+ * Resolve a TimeRangeInput to an explicit TimeRange.
+ *
+ * @param input - Either a preset string or explicit time range
+ * @param now - Optional reference time (defaults to current time)
+ * @returns Resolved TimeRange with start and end as ISO strings
+ */
+export function resolveTimeRange(input, now) {
+    const reference = now ?? new Date();
+    // Default to next-24h if no input provided
+    if (!input) {
+        return resolveTimeRangePreset('next-24h', reference);
+    }
+    // If it's already a TimeRange, return it
+    if (isTimeRange(input)) {
+        return input;
+    }
+    // Otherwise it's a preset
+    return resolveTimeRangePreset(input, reference);
+}
+/**
+ * Resolve a TimeRangePreset to an explicit TimeRange.
+ */
+export function resolveTimeRangePreset(preset, now) {
+    const reference = now.getTime();
+    switch (preset) {
+        case 'past-24h':
+            return {
+                start: new Date(reference - DAY_MS).toISOString(),
+                end: now.toISOString(),
+            };
+        case 'past-7d':
+            return {
+                start: new Date(reference - 7 * DAY_MS).toISOString(),
+                end: now.toISOString(),
+            };
+        case 'past-30d':
+            return {
+                start: new Date(reference - 30 * DAY_MS).toISOString(),
+                end: now.toISOString(),
+            };
+        case 'next-4h':
+            return {
+                start: now.toISOString(),
+                end: new Date(reference + 4 * HOUR_MS).toISOString(),
+            };
+        case 'next-12h':
+            return {
+                start: now.toISOString(),
+                end: new Date(reference + 12 * HOUR_MS).toISOString(),
+            };
+        case 'next-24h':
+            return {
+                start: now.toISOString(),
+                end: new Date(reference + DAY_MS).toISOString(),
+            };
+        case 'next-7d':
+            return {
+                start: now.toISOString(),
+                end: new Date(reference + 7 * DAY_MS).toISOString(),
+            };
+    }
+}
+/**
+ * Check if a date falls within a time range.
+ *
+ * @param date - The date to check (string or Date)
+ * @param range - The time range to check against
+ * @returns true if the date falls within the range (inclusive)
+ */
+export function isDateInRange(date, range) {
+    const timestamp = typeof date === 'string' ? new Date(date).getTime() : date.getTime();
+    const start = new Date(range.start).getTime();
+    const end = new Date(range.end).getTime();
+    return timestamp >= start && timestamp <= end;
+}
+/**
+ * Check if two time ranges overlap.
+ */
+export function doRangesOverlap(range1, range2) {
+    const start1 = new Date(range1.start).getTime();
+    const end1 = new Date(range1.end).getTime();
+    const start2 = new Date(range2.start).getTime();
+    const end2 = new Date(range2.end).getTime();
+    return start1 <= end2 && start2 <= end1;
+}
+/**
+ * Format a duration in milliseconds to a human-readable string.
+ */
+export function formatDuration(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    if (ms < 60_000) {
+        return `${(ms / 1000).toFixed(1)}s`;
+    }
+    if (ms < HOUR_MS) {
+        return `${(ms / 60_000).toFixed(1)}m`;
+    }
+    if (ms < DAY_MS) {
+        return `${(ms / HOUR_MS).toFixed(1)}h`;
+    }
+    return `${(ms / DAY_MS).toFixed(1)}d`;
+}
+/**
+ * Parse an ISO date string to a Date object, returning null if invalid.
+ */
+export function parseISODate(dateString) {
+    const date = new Date(dateString);
+    return isNaN(date.getTime()) ? null : date;
+}
+//# sourceMappingURL=date.js.map

package/dist/esm/utils/date.js.map

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

package/dist/esm/utils/index.js

@@ -0,0 +1,5 @@
+export { HOUR_MS, DAY_MS, isTimeRangePreset, isTimeRange, resolveTimeRange, resolveTimeRangePreset, isDateInRange, doRangesOverlap, formatDuration, parseISODate, } from './date';
+export { withRetry, withTimeout, sleep, TimeoutError } from './retry';
+export { InMemoryCacheProvider, VercelKVCacheProvider, DynamoDBCacheProvider, generateCacheKey, } from './cache';
+export { parseCSV, toCSV } from './csv';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,MAAM,EACN,iBAAiB,EACjB,WAAW,EACX,gBAAgB,EAChB,sBAAsB,EACtB,aAAa,EACb,eAAe,EACf,cAAc,EACd,YAAY,GACb,MAAM,QAAQ,CAAC;AAEhB,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGtE,OAAO,EACL,qBAAqB,EACrB,qBAAqB,EACrB,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC"}

package/dist/esm/utils/retry.js

@@ -0,0 +1,102 @@
+/**
+ * Default retry options.
+ */
+const DEFAULT_OPTIONS = {
+    maxAttempts: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 10000,
+    backoffMultiplier: 2,
+};
+/**
+ * Execute a function with automatic retry on failure.
+ *
+ * Uses exponential backoff with jitter for retry delays.
+ *
+ * @param fn - The async function to execute
+ * @param options - Retry configuration options
+ * @returns The result of the function
+ * @throws The last error if all retries fail
+ */
+export async function withRetry(fn, options) {
+    const config = {
+        ...DEFAULT_OPTIONS,
+        ...options,
+    };
+    let lastError;
+    let delay = config.initialDelayMs;
+    for (let attempt = 1; attempt <= config.maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Check if we should retry
+            const shouldRetry = attempt < config.maxAttempts && (config.isRetryable ? config.isRetryable(lastError) : true);
+            if (!shouldRetry) {
+                throw lastError;
+            }
+            // Notify about retry
+            if (config.onRetry) {
+                config.onRetry(lastError, attempt, delay);
+            }
+            // Wait with jitter
+            await sleep(addJitter(delay));
+            // Increase delay for next retry
+            delay = Math.min(delay * config.backoffMultiplier, config.maxDelayMs);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Sleep for a given duration.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Add random jitter to a delay value (±25%).
+ */
+function addJitter(delay) {
+    const jitter = delay * 0.25 * (Math.random() * 2 - 1);
+    return Math.max(0, Math.round(delay + jitter));
+}
+/**
+ * Execute a function with a timeout.
+ *
+ * @param fn - The async function to execute
+ * @param timeoutMs - Maximum execution time in milliseconds
+ * @param timeoutMessage - Optional error message for timeout
+ * @returns The result of the function
+ * @throws TimeoutError if the function takes longer than timeoutMs
+ */
+export async function withTimeout(fn, timeoutMs, timeoutMessage = 'Operation timed out') {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            reject(new TimeoutError(timeoutMessage, timeoutMs));
+        }, timeoutMs);
+    });
+    try {
+        const result = await Promise.race([fn(), timeoutPromise]);
+        clearTimeout(timeoutId);
+        return result;
+    }
+    catch (error) {
+        clearTimeout(timeoutId);
+        throw error;
+    }
+}
+/**
+ * Error thrown when an operation times out.
+ */
+export class TimeoutError extends Error {
+    code = 'TIMEOUT_ERROR';
+    timeoutMs;
+    constructor(message, timeoutMs) {
+        super(message);
+        this.name = 'TimeoutError';
+        this.timeoutMs = timeoutMs;
+        Object.setPrototypeOf(this, TimeoutError.prototype);
+    }
+}
+//# sourceMappingURL=retry.js.map

package/dist/esm/utils/retry.js.map

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

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

@@ -0,0 +1,5 @@
+export { createLambdaHandler } from './lambda';
+export type { LambdaHandlerOptions, LambdaHandler } from './lambda';
+export { createVercelHandler } from './vercel';
+export type { VercelHandlerOptions, VercelHandler, VercelHandlerResult } from './vercel';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,YAAY,EAAE,oBAAoB,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC"}