@dotdo/do 0.1.0

package/dist/do/colo/index.js

@@ -0,0 +1,145 @@
+/**
+ * Colo Awareness Layer
+ *
+ * Geographic intelligence for Digital Objects. Know where your DOs live,
+ * move them where you need them.
+ *
+ * @module colo
+ *
+ * @example
+ * ```typescript
+ * import { createColoOperations } from '@do/core/colo'
+ *
+ * // Create colo operations for a DO instance
+ * const colo = createColoOperations(doInstance)
+ *
+ * // Get current colo info
+ * const info = await colo.getInfo()
+ * // { colo: 'iad', region: 'enam', city: 'Ashburn', ... }
+ *
+ * // Fork to another region
+ * const replica = await colo.fork('fra', { continuous: true })
+ *
+ * // Migrate when usage patterns change
+ * await colo.migrate('nrt', { strategy: 'graceful' })
+ * ```
+ */
+// Re-export individual operations
+export { getColoInfo, getColoInfoByColo, listColos } from './info';
+export { forkDO } from './fork';
+export { migrateDO } from './migrate';
+export { addFollower, removeFollower, listFollowers } from './followers';
+export { findNearestColo, pingColo } from './routing';
+/**
+ * Storage key prefixes for colo-related data
+ */
+export const COLO_STORAGE_KEYS = {
+    /** Current colo information */
+    COLO_INFO: 'colo:info',
+    /** List of follower DO references */
+    FOLLOWERS: 'colo:followers',
+    /** Replication configuration */
+    REPLICATION_CONFIG: 'colo:replication:config',
+    /** Current replication status */
+    REPLICATION_STATUS: 'colo:replication:status',
+};
+/**
+ * Colo-related event names following NS.Object.event pattern
+ */
+export const COLO_EVENTS = {
+    /** Emitted when fork operation starts */
+    FORK_STARTED: 'Colo.Fork.started',
+    /** Emitted when fork operation completes successfully */
+    FORK_COMPLETED: 'Colo.Fork.completed',
+    /** Emitted when fork operation fails */
+    FORK_FAILED: 'Colo.Fork.failed',
+    /** Emitted when migration starts */
+    MIGRATION_STARTED: 'Colo.Migration.started',
+    /** Emitted when migration completes successfully */
+    MIGRATION_COMPLETED: 'Colo.Migration.completed',
+    /** Emitted when migration fails */
+    MIGRATION_FAILED: 'Colo.Migration.failed',
+    /** Emitted when a follower is added */
+    FOLLOWER_ADDED: 'Colo.Follower.added',
+    /** Emitted when a follower is removed */
+    FOLLOWER_REMOVED: 'Colo.Follower.removed',
+    /** Emitted when replication lag exceeds threshold */
+    REPLICATION_LAG_HIGH: 'Colo.Replication.lagHigh',
+};
+/**
+ * Error codes for colo operations
+ */
+export const COLO_ERRORS = {
+    /** Invalid colo code provided */
+    INVALID_COLO: 'INVALID_COLO',
+    /** Migration operation failed */
+    MIGRATION_FAILED: 'MIGRATION_FAILED',
+    /** Fork operation failed */
+    FORK_FAILED: 'FORK_FAILED',
+    /** Follower not found in list */
+    FOLLOWER_NOT_FOUND: 'FOLLOWER_NOT_FOUND',
+    /** Operation violates jurisdiction constraints */
+    JURISDICTION_VIOLATION: 'JURISDICTION_VIOLATION',
+    /** Replication error */
+    REPLICATION_FAILED: 'REPLICATION_FAILED',
+};
+/**
+ * Error class for colo operations
+ */
+export class ColoError extends Error {
+    code;
+    /**
+     * Create a new ColoError
+     *
+     * @param message - Error message
+     * @param code - Error code from COLO_ERRORS
+     */
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'ColoError';
+    }
+}
+/**
+ * Create colo operations interface for a Digital Object instance
+ *
+ * Factory function that wraps a DO instance with all colo-related operations.
+ * Returns an object implementing the ColoOperations interface.
+ *
+ * @param state - The DurableObjectState instance
+ * @param env - The environment bindings (for accessing other DOs)
+ * @returns ColoOperations interface with all colo methods
+ *
+ * @example
+ * ```typescript
+ * import { createColoOperations } from '@do/core/colo'
+ *
+ * class MyDO {
+ *   private colo: ColoOperations
+ *
+ *   constructor(state: DurableObjectState, env: Env) {
+ *     this.colo = createColoOperations(state, env)
+ *   }
+ *
+ *   async fetch(request: Request) {
+ *     const info = await this.colo.getInfo()
+ *     return Response.json(info)
+ *   }
+ * }
+ * ```
+ */
+export function createColoOperations(state, env) {
+    // TODO: Implement colo operations factory
+    throw new Error('Not implemented');
+}
+/**
+ * Default export for convenience
+ */
+export default {
+    createColoOperations,
+    COLO_STORAGE_KEYS,
+    COLO_EVENTS,
+    COLO_ERRORS,
+    ColoError,
+};
+//# sourceMappingURL=index.js.map

package/dist/do/colo/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../do/colo/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAWH,kCAAkC;AAClC,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC/B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AACxE,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAmBrD;;GAEG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,+BAA+B;IAC/B,SAAS,EAAE,WAAW;IACtB,qCAAqC;IACrC,SAAS,EAAE,gBAAgB;IAC3B,gCAAgC;IAChC,kBAAkB,EAAE,yBAAyB;IAC7C,iCAAiC;IACjC,kBAAkB,EAAE,yBAAyB;CACrC,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,yCAAyC;IACzC,YAAY,EAAE,mBAAmB;IACjC,yDAAyD;IACzD,cAAc,EAAE,qBAAqB;IACrC,wCAAwC;IACxC,WAAW,EAAE,kBAAkB;IAC/B,oCAAoC;IACpC,iBAAiB,EAAE,wBAAwB;IAC3C,oDAAoD;IACpD,mBAAmB,EAAE,0BAA0B;IAC/C,mCAAmC;IACnC,gBAAgB,EAAE,uBAAuB;IACzC,uCAAuC;IACvC,cAAc,EAAE,qBAAqB;IACrC,yCAAyC;IACzC,gBAAgB,EAAE,uBAAuB;IACzC,qDAAqD;IACrD,oBAAoB,EAAE,0BAA0B;CACxC,CAAA;AAEV;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,iCAAiC;IACjC,YAAY,EAAE,cAAc;IAC5B,iCAAiC;IACjC,gBAAgB,EAAE,kBAAkB;IACpC,4BAA4B;IAC5B,WAAW,EAAE,aAAa;IAC1B,iCAAiC;IACjC,kBAAkB,EAAE,oBAAoB;IACxC,kDAAkD;IAClD,sBAAsB,EAAE,wBAAwB;IAChD,wBAAwB;IACxB,kBAAkB,EAAE,oBAAoB;CAChC,CAAA;AAEV;;GAEG;AACH,MAAM,OAAO,SAAU,SAAQ,KAAK;IAShB;IARlB;;;;;OAKG;IACH,YACE,OAAe,EACC,IAA8B;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,SAAI,GAAJ,IAAI,CAA0B;QAG9C,IAAI,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAyB,EACzB,GAAY;IAEZ,0CAA0C;IAC1C,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAA;AACpC,CAAC;AAED;;GAEG;AACH,eAAe;IACb,oBAAoB;IACpB,iBAAiB;IACjB,WAAW;IACX,WAAW;IACX,SAAS;CACV,CAAA"}

package/dist/do/colo/info.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Colo Information Operations
+ *
+ * Get information about colos, regions, and the current DO location.
+ *
+ * @module colo/info
+ */
+import type { ColoInfo, Region, RegionInfo } from '../../types/colo';
+/**
+ * Validate that a colo code is known
+ *
+ * @param colo - IATA colo code to validate
+ * @returns True if colo is valid
+ */
+export declare function isValidColo(colo: string): boolean;
+/**
+ * Get the region for a given colo code
+ *
+ * @param colo - IATA colo code
+ * @returns Region code or null if colo not found
+ *
+ * @example
+ * ```typescript
+ * const region = getRegionForColo('iad')
+ * // 'enam'
+ * ```
+ */
+export declare function getRegionForColo(colo: string): Region | null;
+/**
+ * Get region metadata
+ *
+ * @param region - Region code
+ * @returns RegionInfo or null if region not found
+ *
+ * @example
+ * ```typescript
+ * const info = getRegionInfo('apac')
+ * // { region: 'apac', name: 'Asia Pacific', colos: ['nrt', 'sin', ...] }
+ * ```
+ */
+export declare function getRegionInfo(region: Region): RegionInfo | null;
+/**
+ * Get information about the current colo where this DO is running
+ *
+ * Retrieves colo information from the request context or cached storage.
+ * The colo code comes from Cloudflare's cf.colo property.
+ *
+ * @param state - The DurableObjectState instance
+ * @param request - Optional request to extract colo from cf property
+ * @returns ColoInfo with colo code, region, and metadata
+ *
+ * @example
+ * ```typescript
+ * const info = await getColoInfo(this.state, request)
+ * console.log(info.colo) // 'iad'
+ * console.log(info.region) // 'enam'
+ * console.log(info.city) // 'Ashburn'
+ * ```
+ */
+export declare function getColoInfo(state: DurableObjectState, request?: Request): Promise<ColoInfo>;
+/**
+ * Get information about a specific colo by its IATA code
+ *
+ * @param colo - IATA airport code (e.g., 'iad', 'lhr', 'nrt')
+ * @returns ColoInfo or null if colo not found
+ *
+ * @example
+ * ```typescript
+ * const info = await getColoInfoByColo('fra')
+ * if (info) {
+ *   console.log(info.region) // 'weur'
+ *   console.log(info.city) // 'Frankfurt'
+ * }
+ * ```
+ */
+export declare function getColoInfoByColo(colo: string): Promise<ColoInfo | null>;
+/**
+ * List all available colos, optionally filtered by region
+ *
+ * @param region - Optional region to filter by
+ * @returns Array of ColoInfo for matching colos
+ *
+ * @example
+ * ```typescript
+ * // List all colos
+ * const allColos = await listColos()
+ *
+ * // List only Asia Pacific colos
+ * const apacColos = await listColos('apac')
+ * // [{ colo: 'nrt', region: 'apac', ... }, ...]
+ * ```
+ */
+export declare function listColos(region?: Region): Promise<ColoInfo[]>;
+/**
+ * Colo metadata lookup table
+ *
+ * Maps IATA codes to city/country information.
+ * This is a subset of major colos - Cloudflare has 300+.
+ */
+export declare const COLO_METADATA: Record<string, {
+    city: string;
+    country: string;
+    latitude: number;
+    longitude: number;
+}>;
+//# sourceMappingURL=info.d.ts.map

package/dist/do/colo/info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../../do/colo/info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAYpE;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAE/D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,kBAAkB,EACzB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,QAAQ,CAAC,CAMnB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAM9E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAMpE;AAED;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAChC,MAAM,EACN;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAkEvE,CAAA"}

package/dist/do/colo/info.js

@@ -0,0 +1,196 @@
+/**
+ * Colo Information Operations
+ *
+ * Get information about colos, regions, and the current DO location.
+ *
+ * @module colo/info
+ */
+import { REGIONS } from '../../types/colo';
+/**
+ * Get all colo codes from all regions
+ *
+ * @returns Array of all known colo codes
+ */
+function getAllColos() {
+    return Object.values(REGIONS).flatMap((r) => r.colos);
+}
+/**
+ * Validate that a colo code is known
+ *
+ * @param colo - IATA colo code to validate
+ * @returns True if colo is valid
+ */
+export function isValidColo(colo) {
+    return getAllColos().includes(colo.toLowerCase());
+}
+/**
+ * Get the region for a given colo code
+ *
+ * @param colo - IATA colo code
+ * @returns Region code or null if colo not found
+ *
+ * @example
+ * ```typescript
+ * const region = getRegionForColo('iad')
+ * // 'enam'
+ * ```
+ */
+export function getRegionForColo(colo) {
+    const normalizedColo = colo.toLowerCase();
+    for (const [region, info] of Object.entries(REGIONS)) {
+        if (info.colos.includes(normalizedColo)) {
+            return region;
+        }
+    }
+    return null;
+}
+/**
+ * Get region metadata
+ *
+ * @param region - Region code
+ * @returns RegionInfo or null if region not found
+ *
+ * @example
+ * ```typescript
+ * const info = getRegionInfo('apac')
+ * // { region: 'apac', name: 'Asia Pacific', colos: ['nrt', 'sin', ...] }
+ * ```
+ */
+export function getRegionInfo(region) {
+    return REGIONS[region] ?? null;
+}
+/**
+ * Get information about the current colo where this DO is running
+ *
+ * Retrieves colo information from the request context or cached storage.
+ * The colo code comes from Cloudflare's cf.colo property.
+ *
+ * @param state - The DurableObjectState instance
+ * @param request - Optional request to extract colo from cf property
+ * @returns ColoInfo with colo code, region, and metadata
+ *
+ * @example
+ * ```typescript
+ * const info = await getColoInfo(this.state, request)
+ * console.log(info.colo) // 'iad'
+ * console.log(info.region) // 'enam'
+ * console.log(info.city) // 'Ashburn'
+ * ```
+ */
+export async function getColoInfo(state, request) {
+    // TODO: Implement getColoInfo
+    // 1. Try to get colo from request.cf.colo
+    // 2. Fall back to cached value in storage
+    // 3. Build ColoInfo from colo code
+    throw new Error('Not implemented');
+}
+/**
+ * Get information about a specific colo by its IATA code
+ *
+ * @param colo - IATA airport code (e.g., 'iad', 'lhr', 'nrt')
+ * @returns ColoInfo or null if colo not found
+ *
+ * @example
+ * ```typescript
+ * const info = await getColoInfoByColo('fra')
+ * if (info) {
+ *   console.log(info.region) // 'weur'
+ *   console.log(info.city) // 'Frankfurt'
+ * }
+ * ```
+ */
+export async function getColoInfoByColo(colo) {
+    // TODO: Implement getColoInfoByColo
+    // 1. Validate colo code
+    // 2. Look up region
+    // 3. Build ColoInfo with known metadata
+    throw new Error('Not implemented');
+}
+/**
+ * List all available colos, optionally filtered by region
+ *
+ * @param region - Optional region to filter by
+ * @returns Array of ColoInfo for matching colos
+ *
+ * @example
+ * ```typescript
+ * // List all colos
+ * const allColos = await listColos()
+ *
+ * // List only Asia Pacific colos
+ * const apacColos = await listColos('apac')
+ * // [{ colo: 'nrt', region: 'apac', ... }, ...]
+ * ```
+ */
+export async function listColos(region) {
+    // TODO: Implement listColos
+    // 1. If region provided, filter to that region
+    // 2. Build ColoInfo for each colo
+    // 3. Sort by some reasonable order (alphabetical or by size)
+    throw new Error('Not implemented');
+}
+/**
+ * Colo metadata lookup table
+ *
+ * Maps IATA codes to city/country information.
+ * This is a subset of major colos - Cloudflare has 300+.
+ */
+export const COLO_METADATA = {
+    // Western North America
+    sjc: { city: 'San Jose', country: 'US', latitude: 37.3639, longitude: -121.9289 },
+    lax: { city: 'Los Angeles', country: 'US', latitude: 33.9416, longitude: -118.4085 },
+    sea: { city: 'Seattle', country: 'US', latitude: 47.4502, longitude: -122.3088 },
+    den: { city: 'Denver', country: 'US', latitude: 39.8561, longitude: -104.6737 },
+    phx: { city: 'Phoenix', country: 'US', latitude: 33.4352, longitude: -112.0101 },
+    pdx: { city: 'Portland', country: 'US', latitude: 45.5898, longitude: -122.5951 },
+    yvr: { city: 'Vancouver', country: 'CA', latitude: 49.1967, longitude: -123.1815 },
+    // Eastern North America
+    iad: { city: 'Ashburn', country: 'US', latitude: 38.9519, longitude: -77.448 },
+    dfw: { city: 'Dallas', country: 'US', latitude: 32.8998, longitude: -97.0403 },
+    atl: { city: 'Atlanta', country: 'US', latitude: 33.6407, longitude: -84.4277 },
+    ord: { city: 'Chicago', country: 'US', latitude: 41.9742, longitude: -87.9073 },
+    mia: { city: 'Miami', country: 'US', latitude: 25.7959, longitude: -80.287 },
+    yyz: { city: 'Toronto', country: 'CA', latitude: 43.6777, longitude: -79.6248 },
+    bos: { city: 'Boston', country: 'US', latitude: 42.3656, longitude: -71.0096 },
+    jfk: { city: 'New York', country: 'US', latitude: 40.6413, longitude: -73.7781 },
+    // Western Europe
+    lhr: { city: 'London', country: 'GB', latitude: 51.47, longitude: -0.4543 },
+    cdg: { city: 'Paris', country: 'FR', latitude: 49.0097, longitude: 2.5479 },
+    fra: { city: 'Frankfurt', country: 'DE', latitude: 50.0379, longitude: 8.5622 },
+    ams: { city: 'Amsterdam', country: 'NL', latitude: 52.3105, longitude: 4.7683 },
+    dub: { city: 'Dublin', country: 'IE', latitude: 53.4264, longitude: -6.2499 },
+    mad: { city: 'Madrid', country: 'ES', latitude: 40.4983, longitude: -3.5676 },
+    lis: { city: 'Lisbon', country: 'PT', latitude: 38.7742, longitude: -9.1342 },
+    // Eastern Europe
+    waw: { city: 'Warsaw', country: 'PL', latitude: 52.1672, longitude: 20.9679 },
+    bud: { city: 'Budapest', country: 'HU', latitude: 47.4398, longitude: 19.2611 },
+    prg: { city: 'Prague', country: 'CZ', latitude: 50.1008, longitude: 14.26 },
+    vie: { city: 'Vienna', country: 'AT', latitude: 48.1103, longitude: 16.5697 },
+    // Asia Pacific
+    nrt: { city: 'Tokyo', country: 'JP', latitude: 35.7653, longitude: 140.3857 },
+    sin: { city: 'Singapore', country: 'SG', latitude: 1.3644, longitude: 103.9915 },
+    hkg: { city: 'Hong Kong', country: 'HK', latitude: 22.308, longitude: 113.9185 },
+    bom: { city: 'Mumbai', country: 'IN', latitude: 19.0896, longitude: 72.8656 },
+    del: { city: 'Delhi', country: 'IN', latitude: 28.5562, longitude: 77.1 },
+    icn: { city: 'Seoul', country: 'KR', latitude: 37.4602, longitude: 126.4407 },
+    kix: { city: 'Osaka', country: 'JP', latitude: 34.4347, longitude: 135.244 },
+    // Oceania
+    syd: { city: 'Sydney', country: 'AU', latitude: -33.9399, longitude: 151.1753 },
+    mel: { city: 'Melbourne', country: 'AU', latitude: -37.6733, longitude: 144.8433 },
+    akl: { city: 'Auckland', country: 'NZ', latitude: -37.0082, longitude: 174.7917 },
+    per: { city: 'Perth', country: 'AU', latitude: -31.9385, longitude: 115.9672 },
+    // South America
+    gru: { city: 'Sao Paulo', country: 'BR', latitude: -23.4356, longitude: -46.4731 },
+    eze: { city: 'Buenos Aires', country: 'AR', latitude: -34.8222, longitude: -58.5358 },
+    scl: { city: 'Santiago', country: 'CL', latitude: -33.393, longitude: -70.7858 },
+    bog: { city: 'Bogota', country: 'CO', latitude: 4.7016, longitude: -74.1469 },
+    // Africa
+    jnb: { city: 'Johannesburg', country: 'ZA', latitude: -26.1367, longitude: 28.242 },
+    cpt: { city: 'Cape Town', country: 'ZA', latitude: -33.9715, longitude: 18.6021 },
+    nbo: { city: 'Nairobi', country: 'KE', latitude: -1.3192, longitude: 36.9258 },
+    // Middle East
+    dxb: { city: 'Dubai', country: 'AE', latitude: 25.2532, longitude: 55.3657 },
+    tlv: { city: 'Tel Aviv', country: 'IL', latitude: 32.0055, longitude: 34.8854 },
+    ruh: { city: 'Riyadh', country: 'SA', latitude: 24.9578, longitude: 46.6989 },
+};
+//# sourceMappingURL=info.js.map

package/dist/do/colo/info.js.map

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

package/dist/do/colo/migrate.d.ts

@@ -0,0 +1,161 @@
+/**
+ * Migration Operations
+ *
+ * Move Digital Objects between colos. Use when usage patterns change
+ * or for optimization.
+ *
+ * @module colo/migrate
+ */
+import type { MigrateOptions } from '../../types/colo';
+import type { DigitalObjectRef } from '../../types/identity';
+/**
+ * Migration strategy
+ *
+ * - `graceful`: Wait for in-flight requests, then migrate (slower but safer)
+ * - `immediate`: Migrate immediately, in-flight requests may fail (faster but riskier)
+ */
+export type MigrationStrategy = 'graceful' | 'immediate';
+/**
+ * Migration state during the migration process
+ */
+export type MigrationState = 'idle' | 'preparing' | 'draining' | 'transferring' | 'switching' | 'completed' | 'failed';
+/**
+ * Migration status information
+ */
+export interface MigrationStatus {
+    /** Current state of the migration */
+    state: MigrationState;
+    /** Source colo */
+    sourceColo: string;
+    /** Target colo */
+    targetColo: string;
+    /** When migration started */
+    startedAt: number;
+    /** Progress percentage (0-100) */
+    progress: number;
+    /** Number of entries transferred */
+    entriesTransferred: number;
+    /** Total entries to transfer */
+    totalEntries: number;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Migrate options with defaults applied
+ */
+export interface ResolvedMigrateOptions {
+    /** Whether to wait for migration to complete (default: true) */
+    wait: boolean;
+    /** Timeout for migration in ms (default: 60000) */
+    timeout: number;
+    /** Strategy for handling in-flight requests (default: 'graceful') */
+    strategy: MigrationStrategy;
+}
+/**
+ * Migrate this DO to another colo
+ *
+ * Moves the primary DO to a different geographic location. This is useful when:
+ * - User patterns shift (e.g., most users now in Asia instead of US)
+ * - Optimizing for latency based on analytics
+ * - Meeting new jurisdiction requirements
+ *
+ * **Graceful Strategy** (default):
+ * 1. Stop accepting new writes
+ * 2. Wait for in-flight requests to complete
+ * 3. Transfer all state to new location
+ * 4. Update routing to point to new location
+ * 5. Resume normal operation
+ *
+ * **Immediate Strategy**:
+ * 1. Snapshot current state
+ * 2. Create new DO in target colo with snapshot
+ * 3. Immediately switch routing
+ * 4. In-flight requests to old location may fail
+ *
+ * @param state - The DurableObjectState instance
+ * @param env - Environment bindings
+ * @param targetColo - IATA code of target colo (e.g., 'fra', 'nrt')
+ * @param options - Migration configuration options
+ * @throws ColoError if target colo is invalid or migration fails
+ *
+ * @example
+ * ```typescript
+ * // Graceful migration (recommended)
+ * await migrateDO(state, env, 'nrt', {
+ *   strategy: 'graceful',
+ *   timeout: 30000,
+ * })
+ *
+ * // Immediate migration (faster but riskier)
+ * await migrateDO(state, env, 'nrt', {
+ *   strategy: 'immediate',
+ * })
+ *
+ * // Fire and forget (don't wait for completion)
+ * await migrateDO(state, env, 'fra', {
+ *   wait: false,
+ * })
+ * ```
+ */
+export declare function migrateDO(state: DurableObjectState, env: unknown, targetColo: string, options?: MigrateOptions): Promise<void>;
+/**
+ * Apply default values to migrate options
+ *
+ * @param options - Partial options from caller
+ * @returns Fully resolved options with defaults
+ */
+export declare function resolveMigrateOptions(options?: MigrateOptions): ResolvedMigrateOptions;
+/**
+ * Get the current migration status
+ *
+ * @param state - The DurableObjectState instance
+ * @returns Current migration status or null if no migration in progress
+ *
+ * @example
+ * ```typescript
+ * const status = await getMigrationStatus(state)
+ * if (status) {
+ *   console.log(`Migration ${status.progress}% complete`)
+ *   console.log(`${status.entriesTransferred}/${status.totalEntries} entries`)
+ * }
+ * ```
+ */
+export declare function getMigrationStatus(state: DurableObjectState): Promise<MigrationStatus | null>;
+/**
+ * Cancel an in-progress migration
+ *
+ * Can only cancel migrations that haven't reached the 'switching' state.
+ * Graceful migrations in 'draining' or 'transferring' state can be cancelled.
+ *
+ * @param state - The DurableObjectState instance
+ * @throws ColoError if no migration in progress or migration cannot be cancelled
+ *
+ * @example
+ * ```typescript
+ * await cancelMigration(state)
+ * // Migration cancelled, DO remains in original colo
+ * ```
+ */
+export declare function cancelMigration(state: DurableObjectState): Promise<void>;
+/**
+ * Drain in-flight requests during graceful migration
+ *
+ * Waits for active requests to complete before proceeding with state transfer.
+ *
+ * @param state - The DurableObjectState instance
+ * @param timeout - Maximum time to wait in ms
+ * @returns True if all requests drained, false if timeout
+ */
+export declare function drainRequests(state: DurableObjectState, timeout: number): Promise<boolean>;
+/**
+ * Transfer state to a new DO location
+ *
+ * Exports all storage entries and sends them to the target DO.
+ *
+ * @param state - Source DO state
+ * @param targetRef - Reference to target DO
+ * @param onProgress - Optional callback for progress updates
+ * @returns Number of entries transferred
+ */
+export declare function transferState(state: DurableObjectState, targetRef: DigitalObjectRef, onProgress?: (transferred: number, total: number) => void): Promise<number>;
+//# sourceMappingURL=migrate.d.ts.map

package/dist/do/colo/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../do/colo/migrate.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAI5D;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,CAAA;AAExD;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,WAAW,GACX,UAAU,GACV,cAAc,GACd,WAAW,GACX,WAAW,GACX,QAAQ,CAAA;AAEZ;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,qCAAqC;IACrC,KAAK,EAAE,cAAc,CAAA;IACrB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,kBAAkB;IAClB,UAAU,EAAE,MAAM,CAAA;IAClB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAA;IACjB,kCAAkC;IAClC,QAAQ,EAAE,MAAM,CAAA;IAChB,oCAAoC;IACpC,kBAAkB,EAAE,MAAM,CAAA;IAC1B,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;CACf;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,IAAI,EAAE,OAAO,CAAA;IACb,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAA;IACf,qEAAqE;IACrE,QAAQ,EAAE,iBAAiB,CAAA;CAC5B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AACH,wBAAsB,SAAS,CAC7B,KAAK,EAAE,kBAAkB,EACzB,GAAG,EAAE,OAAO,EACZ,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,sBAAsB,CAMtF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC,CAQjC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAU9E;AAED;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CACjC,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,gBAAgB,EAC3B,UAAU,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,GACxD,OAAO,CAAC,MAAM,CAAC,CAUjB"}