dotdo 0.0.1 → 0.0.2

package/dist/lib/colo/caching.js

@@ -0,0 +1,196 @@
+/**
+ * DO Location Caching
+ *
+ * Issue: dotdo-4cgch - DO location caching
+ *
+ * Once a DO detects its location, it should cache it in DO storage since
+ * the location never changes for a given DO instance.
+ *
+ * This module provides:
+ * - LocationCache class for managing cached DO location
+ * - getOrDetectLocation() function for cached location retrieval
+ * - Storage key constants for consistent access
+ */
+import { fetchDOLocation } from './detection';
+// ============================================================================
+// Storage Key Constants
+// ============================================================================
+/**
+ * Storage key used for caching DO location
+ */
+export const LOCATION_STORAGE_KEY = 'do:location';
+/**
+ * Cache version for migration support
+ */
+export const LOCATION_CACHE_VERSION = 1;
+/**
+ * Serialize DOLocation for storage
+ */
+function serializeDOLocation(location) {
+    const serialized = {
+        colo: location.colo,
+        region: location.region,
+        city: location.city,
+        cfHint: location.cfHint,
+        detectedAt: location.detectedAt instanceof Date
+            ? location.detectedAt.toISOString()
+            : new Date(location.detectedAt).toISOString(),
+    };
+    if (location.coordinates)
+        serialized.coordinates = location.coordinates;
+    if (location.cf)
+        serialized.cf = location.cf;
+    if (location.trace)
+        serialized.trace = location.trace;
+    if (location.ip)
+        serialized.ip = location.ip;
+    if (location.country)
+        serialized.country = location.country;
+    if (location.timezone)
+        serialized.timezone = location.timezone;
+    return serialized;
+}
+/**
+ * Deserialize DOLocation from storage
+ */
+function deserializeDOLocation(serialized) {
+    const location = {
+        colo: serialized.colo,
+        region: serialized.region,
+        city: serialized.city,
+        cfHint: serialized.cfHint,
+        detectedAt: new Date(serialized.detectedAt),
+    };
+    if (serialized.coordinates)
+        location.coordinates = serialized.coordinates;
+    if (serialized.cf)
+        location.cf = serialized.cf;
+    if (serialized.trace)
+        location.trace = serialized.trace;
+    if (serialized.ip)
+        location.ip = serialized.ip;
+    if (serialized.country)
+        location.country = serialized.country;
+    if (serialized.timezone)
+        location.timezone = serialized.timezone;
+    return location;
+}
+// ============================================================================
+// LocationCache Class
+// ============================================================================
+/**
+ * Cache for storing and retrieving DO location from DurableObjectStorage
+ *
+ * Once a DO detects its location, it's immutable for the lifetime of that
+ * DO instance. This cache ensures we only detect once and persist the result.
+ *
+ * @example
+ * ```typescript
+ * const cache = new LocationCache(ctx.storage)
+ *
+ * // Check if location is cached
+ * if (await cache.has()) {
+ *   const location = await cache.get()
+ *   console.log(`DO located at: ${location.city}`)
+ * }
+ *
+ * // Cache detected location
+ * await cache.set(detectedLocation)
+ * ```
+ */
+export class LocationCache {
+    storage;
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Get cached location or null if not cached
+     *
+     * @returns The cached DOLocation or null
+     */
+    async get() {
+        const cached = await this.storage.get(LOCATION_STORAGE_KEY);
+        if (!cached) {
+            return null;
+        }
+        return deserializeDOLocation(cached);
+    }
+    /**
+     * Set cached location (returns the location)
+     *
+     * If a location is already cached, this is a no-op and returns
+     * the existing cached location (immutable per DO instance).
+     *
+     * @param location - The location to cache
+     * @returns The cached location (may be existing if already set)
+     */
+    async set(location) {
+        // Check if already cached - don't overwrite
+        const existing = await this.get();
+        if (existing) {
+            return existing;
+        }
+        // Store serialized location
+        await this.storage.put(LOCATION_STORAGE_KEY, serializeDOLocation(location));
+        return location;
+    }
+    /**
+     * Check if location is cached
+     *
+     * @returns True if location is cached, false otherwise
+     */
+    async has() {
+        const cached = await this.storage.get(LOCATION_STORAGE_KEY);
+        return cached !== undefined;
+    }
+    /**
+     * Clear cached location (primarily for testing)
+     *
+     * In production, this should rarely be called since DO location
+     * is immutable once detected.
+     */
+    async clear() {
+        await this.storage.delete(LOCATION_STORAGE_KEY);
+    }
+}
+// ============================================================================
+// getOrDetectLocation Function
+// ============================================================================
+/**
+ * Gets cached location or detects and caches it
+ *
+ * This function should be the primary way to get a DO's location:
+ * 1. Check if location is cached in storage
+ * 2. If cached, return it immediately
+ * 3. If not cached, detect location and cache it
+ * 4. Return the location
+ *
+ * Detection only happens once per DO lifetime.
+ *
+ * @param storage - DurableObjectStorage for caching
+ * @returns The DO's location (cached or freshly detected)
+ *
+ * @example
+ * ```typescript
+ * // In a Durable Object
+ * async fetch(request: Request) {
+ *   const location = await getOrDetectLocation(this.ctx.storage)
+ *   console.log(`Processing request at ${location.city} (${location.colo})`)
+ *   // ...
+ * }
+ * ```
+ */
+export async function getOrDetectLocation(storage) {
+    const cache = new LocationCache(storage);
+    // Check cache first
+    const cached = await cache.get();
+    if (cached) {
+        return cached;
+    }
+    // Detect location (returns canonical DOLocation with all fields populated)
+    const location = await fetchDOLocation();
+    // Cache the result
+    await cache.set(location);
+    return location;
+}
+//# sourceMappingURL=caching.js.map

package/dist/lib/colo/caching.js.map

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

package/dist/lib/colo/detection.js

@@ -0,0 +1,194 @@
+/**
+ * DO Location Detection
+ *
+ * Detects Cloudflare colo location from within a Durable Object.
+ *
+ * Primary method: `https://workers.cloudflare.com/cf.json` - returns JSON with
+ * colo, coordinates, country, and more metadata directly.
+ *
+ * Fallback: `https://cloudflare.com/cdn-cgi/trace` - returns key=value pairs
+ * with colo=XXX where XXX is a 3-letter IATA code.
+ *
+ * Reference: dotdo-c3g99 - DO location detection mechanism
+ */
+import { codeToCity } from '../../types/Location';
+import { createDOLocation, } from '../../types/DOLocation';
+// ============================================================================
+// Constants
+// ============================================================================
+/**
+ * Cloudflare's cf.json endpoint - returns JSON with rich location data
+ * Preferred over trace endpoint for simpler parsing and more data
+ */
+export const CLOUDFLARE_CF_JSON_URL = 'https://workers.cloudflare.com/cf.json';
+/**
+ * Cloudflare's trace endpoint URL for detecting colo location (fallback)
+ * @deprecated Use CLOUDFLARE_CF_JSON_URL instead
+ */
+export const CLOUDFLARE_TRACE_URL = 'https://cloudflare.com/cdn-cgi/trace';
+// ============================================================================
+// Helper: Valid ColoCode Set
+// ============================================================================
+const validColoCodes = new Set(Object.keys(codeToCity));
+/**
+ * Validates if a string is a known ColoCode
+ */
+function isValidColoCode(code) {
+    return validColoCodes.has(code);
+}
+// ============================================================================
+// Functions
+// ============================================================================
+/**
+ * Parses all fields from trace response
+ *
+ * @param response - Raw response from /cdn-cgi/trace endpoint
+ * @returns TraceData object with parsed fields (all fields are optional)
+ *
+ * @example
+ * ```ts
+ * const data = parseTraceResponse('colo=SJC\nip=1.2.3.4\nloc=US')
+ * console.log(data.colo) // 'SJC'
+ * console.log(data.loc) // 'US'
+ * ```
+ */
+export function parseTraceResponse(response) {
+    const result = {};
+    // Split by various line ending styles (CRLF, LF, CR)
+    const lines = response.split(/\r\n|\n|\r/);
+    for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (!trimmedLine)
+            continue;
+        // Find the first equals sign (value may contain equals signs)
+        const eqIndex = trimmedLine.indexOf('=');
+        if (eqIndex === -1)
+            continue;
+        const key = trimmedLine.substring(0, eqIndex);
+        const value = trimmedLine.substring(eqIndex + 1);
+        result[key] = value;
+    }
+    return result;
+}
+/**
+ * Parses the trace response to extract colo code
+ *
+ * @param traceResponse - Raw response from /cdn-cgi/trace endpoint
+ * @returns ColoCode if valid, null otherwise
+ *
+ * @example
+ * ```ts
+ * const colo = detectColoFromTrace('colo=SJC\nip=1.2.3.4')
+ * // Returns: 'sjc'
+ * ```
+ */
+export function detectColoFromTrace(traceResponse) {
+    if (!traceResponse || !traceResponse.trim()) {
+        return null;
+    }
+    const traceData = parseTraceResponse(traceResponse);
+    if (!traceData.colo) {
+        return null;
+    }
+    // Trim whitespace and normalize to lowercase
+    const coloValue = traceData.colo.trim().toLowerCase();
+    if (!coloValue) {
+        return null;
+    }
+    // Validate against known colo codes
+    if (!isValidColoCode(coloValue)) {
+        return null;
+    }
+    return coloValue;
+}
+/**
+ * Fetches location from cf.json endpoint (preferred method)
+ *
+ * @returns Promise resolving to DOLocation with rich metadata
+ * @throws Error on network error or invalid response
+ *
+ * @example
+ * ```ts
+ * const location = await fetchDOLocationFromCfJson()
+ * console.log(location.colo) // 'sjc'
+ * console.log(location.coordinates) // { lat: 37.36, lng: -121.93 }
+ * ```
+ */
+export async function fetchDOLocationFromCfJson() {
+    const response = await fetch(CLOUDFLARE_CF_JSON_URL);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch cf.json endpoint: ${response.status} ${response.statusText}`);
+    }
+    const cfData = (await response.json());
+    if (!cfData.colo) {
+        throw new Error('Missing colo in cf.json response');
+    }
+    const coloValue = cfData.colo.trim().toLowerCase();
+    if (!isValidColoCode(coloValue)) {
+        throw new Error(`Invalid or unknown colo code: ${cfData.colo}`);
+    }
+    const lat = parseFloat(cfData.latitude);
+    const lng = parseFloat(cfData.longitude);
+    return createDOLocation(coloValue, {
+        coordinates: isFinite(lat) && isFinite(lng) ? { lat, lng } : undefined,
+        cf: cfData,
+        country: cfData.country,
+        timezone: cfData.timezone,
+    });
+}
+/**
+ * Fetches location from trace endpoint (fallback method)
+ *
+ * @returns Promise resolving to DOLocation with trace metadata
+ * @throws Error on network error, invalid response, or unknown colo code
+ * @deprecated Use fetchDOLocationFromCfJson for richer data
+ */
+export async function fetchDOLocationFromTrace() {
+    const response = await fetch(CLOUDFLARE_TRACE_URL);
+    if (!response.ok) {
+        throw new Error(`Failed to fetch trace endpoint: ${response.status} ${response.statusText}`);
+    }
+    const responseText = await response.text();
+    if (!responseText || !responseText.trim()) {
+        throw new Error('Empty response from trace endpoint');
+    }
+    const traceData = parseTraceResponse(responseText);
+    const colo = detectColoFromTrace(responseText);
+    if (!colo) {
+        const rawColo = traceData.colo || '<missing>';
+        throw new Error(`Invalid or unknown colo code: ${rawColo}`);
+    }
+    return createDOLocation(colo, {
+        trace: traceData,
+        ip: traceData.ip,
+        country: traceData.loc,
+    });
+}
+/**
+ * Fetches and parses location from within a DO
+ *
+ * Uses cf.json endpoint as primary source (richer data, simpler parsing).
+ * Falls back to trace endpoint if cf.json fails.
+ *
+ * @returns Promise resolving to DOLocation with detected colo and metadata
+ * @throws Error on network error, invalid response, or unknown colo code
+ *
+ * @example
+ * ```ts
+ * const location = await fetchDOLocation()
+ * console.log(location.colo) // 'sjc'
+ * console.log(location.coordinates) // { latitude: 37.36, longitude: -121.93 }
+ * console.log(location.detectedAt) // Date
+ * ```
+ */
+export async function fetchDOLocation() {
+    try {
+        // Try cf.json first - richer data, simpler parsing
+        return await fetchDOLocationFromCfJson();
+    }
+    catch {
+        // Fall back to trace endpoint
+        return await fetchDOLocationFromTrace();
+    }
+}
+//# sourceMappingURL=detection.js.map

package/dist/lib/colo/detection.js.map

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

package/dist/lib/colo/external-data.js

@@ -0,0 +1,219 @@
+/**
+ * External Data Client for WHERE-DOs-Live API
+ *
+ * Issue: dotdo-2bik1
+ *
+ * Provides utilities for fetching colo metadata from the WHERE-DOs-Live API
+ * until we have enough of our own data. The API provides colo metadata including
+ * coordinates and DO support likelihood.
+ */
+// ============================================================================
+// Static Colo Data (Fallback)
+// ============================================================================
+/**
+ * Static colo data for all 23 DO colos
+ * Used as fallback when API is unavailable
+ */
+const STATIC_COLO_DATA = [
+    // US West
+    { code: 'lax', city: 'LosAngeles', region: 'us-west', coordinates: { lat: 33.9425, lng: -118.408 }, supportsDOs: true },
+    { code: 'sjc', city: 'SanJose', region: 'us-west', coordinates: { lat: 37.3639, lng: -121.9289 }, supportsDOs: true },
+    { code: 'sea', city: 'Seattle', region: 'us-west', coordinates: { lat: 47.4502, lng: -122.3088 }, supportsDOs: true },
+    { code: 'den', city: 'Denver', region: 'us-west', coordinates: { lat: 39.8561, lng: -104.6737 }, supportsDOs: true },
+    // US East
+    { code: 'iad', city: 'Virginia', region: 'us-east', coordinates: { lat: 38.9445, lng: -77.4558 }, supportsDOs: true },
+    { code: 'ewr', city: 'Newark', region: 'us-east', coordinates: { lat: 40.6895, lng: -74.1745 }, supportsDOs: true },
+    { code: 'ord', city: 'Chicago', region: 'us-east', coordinates: { lat: 41.9742, lng: -87.9073 }, supportsDOs: true },
+    { code: 'dfw', city: 'Dallas', region: 'us-east', coordinates: { lat: 32.8998, lng: -97.0403 }, supportsDOs: true },
+    { code: 'atl', city: 'Atlanta', region: 'us-east', coordinates: { lat: 33.6407, lng: -84.4277 }, supportsDOs: true },
+    { code: 'mia', city: 'Miami', region: 'us-east', coordinates: { lat: 25.7959, lng: -80.2870 }, supportsDOs: true },
+    // EU West
+    { code: 'lhr', city: 'London', region: 'eu-west', coordinates: { lat: 51.4700, lng: -0.4543 }, supportsDOs: true },
+    { code: 'cdg', city: 'Paris', region: 'eu-west', coordinates: { lat: 49.0097, lng: 2.5479 }, supportsDOs: true },
+    { code: 'ams', city: 'Amsterdam', region: 'eu-west', coordinates: { lat: 52.3105, lng: 4.7683 }, supportsDOs: true },
+    { code: 'fra', city: 'Frankfurt', region: 'eu-west', coordinates: { lat: 50.0379, lng: 8.5622 }, supportsDOs: true },
+    { code: 'mrs', city: 'Marseille', region: 'eu-west', coordinates: { lat: 43.4365, lng: 5.2153 }, supportsDOs: true },
+    { code: 'mxp', city: 'Milan', region: 'eu-west', coordinates: { lat: 45.6306, lng: 8.7281 }, supportsDOs: true },
+    // EU East
+    { code: 'prg', city: 'Prague', region: 'eu-east', coordinates: { lat: 50.1018, lng: 14.2632 }, supportsDOs: true },
+    { code: 'arn', city: 'Stockholm', region: 'eu-east', coordinates: { lat: 59.6498, lng: 17.9238 }, supportsDOs: true },
+    { code: 'vie', city: 'Vienna', region: 'eu-east', coordinates: { lat: 48.1103, lng: 16.5697 }, supportsDOs: true },
+    // Asia-Pacific
+    { code: 'sin', city: 'Singapore', region: 'asia-pacific', coordinates: { lat: 1.3644, lng: 103.9915 }, supportsDOs: true },
+    { code: 'hkg', city: 'HongKong', region: 'asia-pacific', coordinates: { lat: 22.3080, lng: 113.9185 }, supportsDOs: true },
+    { code: 'nrt', city: 'Tokyo', region: 'asia-pacific', coordinates: { lat: 35.7649, lng: 140.3867 }, supportsDOs: true },
+    { code: 'kix', city: 'Osaka', region: 'asia-pacific', coordinates: { lat: 34.4347, lng: 135.2441 }, supportsDOs: true },
+];
+// ============================================================================
+// ColoDataClient Class
+// ============================================================================
+/**
+ * Client for fetching colo metadata from WHERE-DOs-Live API
+ */
+export class ColoDataClient {
+    baseUrl;
+    cacheTTL = 5 * 60 * 1000; // Default 5 minutes
+    cache = null;
+    cacheTimestamp = 0;
+    constructor(baseUrl) {
+        this.baseUrl = baseUrl ?? 'https://where-dos-live.do.workers.dev/api';
+    }
+    /**
+     * Check if cache is still valid
+     */
+    isCacheValid() {
+        if (this.cacheTTL === 0)
+            return false;
+        if (!this.cache)
+            return false;
+        return Date.now() - this.cacheTimestamp < this.cacheTTL;
+    }
+    /**
+     * Fetch all colo metadata from API
+     */
+    async fetchAllColos() {
+        // Return cached data if valid
+        if (this.isCacheValid() && this.cache) {
+            return this.cache;
+        }
+        const response = await fetch(`${this.baseUrl}/colos`, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+        });
+        if (!response.ok) {
+            throw new Error(`API error: ${response.status}`);
+        }
+        const data = await response.json();
+        // Update cache
+        this.cache = data;
+        this.cacheTimestamp = Date.now();
+        return data;
+    }
+    /**
+     * Get metadata for specific colo
+     */
+    async getColo(code) {
+        const response = await fetch(`${this.baseUrl}/colos/${code}`, {
+            method: 'GET',
+            headers: { 'Content-Type': 'application/json' },
+        });
+        if (response.status === 404) {
+            return null;
+        }
+        const data = await response.json();
+        if (!data) {
+            return null;
+        }
+        return data;
+    }
+    /**
+     * Get colos that support DOs
+     */
+    async getDOColos() {
+        const allColos = await this.fetchAllColos();
+        return allColos.filter(colo => colo.supportsDOs);
+    }
+    /**
+     * Get colos by region
+     */
+    async getColosByRegion(region) {
+        const allColos = await this.fetchAllColos();
+        return allColos.filter(colo => colo.region === region);
+    }
+    /**
+     * Set cache TTL in milliseconds
+     */
+    setCacheTTL(ttl) {
+        this.cacheTTL = ttl;
+    }
+    /**
+     * Clear the cache
+     */
+    clearCache() {
+        this.cache = null;
+        this.cacheTimestamp = 0;
+    }
+}
+// ============================================================================
+// syncColoData Function
+// ============================================================================
+/**
+ * Sync external data to local storage
+ */
+export async function syncColoData(client, storage) {
+    // Fetch all colos from client
+    const colos = await client.fetchAllColos();
+    // Get existing keys from storage
+    const existingData = await storage.list({ prefix: 'colo:' });
+    const existingCodes = new Set();
+    const existingColos = new Map();
+    for (const [key, value] of existingData) {
+        const code = key.replace('colo:', '');
+        existingCodes.add(code);
+        existingColos.set(code, value);
+    }
+    let added = 0;
+    let updated = 0;
+    let removed = 0;
+    let successfulTotal = 0;
+    // Process each colo from API
+    for (const colo of colos) {
+        const key = `colo:${colo.code}`;
+        try {
+            if (existingCodes.has(colo.code)) {
+                // Check if data has changed
+                const existing = existingColos.get(colo.code);
+                if (JSON.stringify(existing) !== JSON.stringify(colo)) {
+                    await storage.put(key, colo);
+                    updated++;
+                }
+                existingCodes.delete(colo.code);
+            }
+            else {
+                await storage.put(key, colo);
+                added++;
+            }
+            successfulTotal++;
+        }
+        catch {
+            // Handle partial failures gracefully - continue with other colos
+        }
+    }
+    // Remove colos that are no longer in API response
+    for (const code of existingCodes) {
+        try {
+            await storage.delete(`colo:${code}`);
+            removed++;
+        }
+        catch {
+            // Handle partial failures gracefully
+        }
+    }
+    return {
+        added,
+        updated,
+        removed,
+        total: successfulTotal,
+        syncedAt: new Date(),
+    };
+}
+// ============================================================================
+// getColoWithLikelihood Function
+// ============================================================================
+/**
+ * Get colo metadata with likelihood score
+ * Always returns likelihood (defaults to 1.0 if not present)
+ */
+export async function getColoWithLikelihood(code, client) {
+    const colo = await client.getColo(code);
+    if (!colo) {
+        throw new Error(`Colo not found: ${code}`);
+    }
+    // Ensure likelihood is always present, default to 1.0 for DO-supporting colos
+    const likelihood = colo.likelihood ?? (colo.supportsDOs ? 1.0 : 0.5);
+    return {
+        ...colo,
+        likelihood,
+    };
+}
+//# sourceMappingURL=external-data.js.map

package/dist/lib/colo/external-data.js.map

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