@dotdo/do 0.1.0

package/dist/do/hibernation.js

@@ -0,0 +1,518 @@
+/**
+ * Hibernation Support for Digital Objects
+ *
+ * Implements the Cloudflare Agents SDK hibernation pattern for efficient
+ * resource usage. DOs can hibernate when idle, reducing costs by ~95%.
+ *
+ * Features:
+ * - Automatic idle detection and hibernation
+ * - WebSocket connection preservation during hibernation
+ * - Alarm-based wake-up for scheduled tasks
+ * - State persistence across hibernation cycles
+ *
+ * @example Basic hibernation
+ * ```typescript
+ * const hibernation = new HibernationManager(ctx, {
+ *   idleTimeout: 10_000, // Hibernate after 10s idle
+ * })
+ *
+ * // Touch on activity to reset idle timer
+ * hibernation.touch()
+ *
+ * // Check if hibernating
+ * if (hibernation.isHibernating()) {
+ *   // Handle wake-up
+ * }
+ * ```
+ *
+ * @example WebSocket with hibernation
+ * ```typescript
+ * // Accept WebSocket with hibernation support
+ * const response = await hibernation.acceptWebSocket(request)
+ *
+ * // WebSocket survives hibernation and reconnects automatically
+ * ```
+ *
+ * @module do/hibernation
+ */
+/**
+ * Hibernation manager for Digital Objects
+ *
+ * Manages the sleep/wake lifecycle of a DO, including:
+ * - Idle detection and automatic hibernation
+ * - WebSocket hibernation
+ * - Alarm scheduling for wake-up
+ *
+ * @class HibernationManager
+ *
+ * @example
+ * ```typescript
+ * class MyDO implements DurableObject {
+ *   private hibernation: HibernationManager
+ *
+ *   constructor(ctx: DurableObjectState) {
+ *     this.hibernation = new HibernationManager(ctx, {
+ *       idleTimeout: 30_000,
+ *       onHibernate: () => this.cleanup(),
+ *       onWake: () => this.restore()
+ *     })
+ *   }
+ *
+ *   async fetch(request: Request) {
+ *     this.hibernation.touch()
+ *     // Handle request...
+ *   }
+ * }
+ * ```
+ */
+export class HibernationManager {
+    ctx;
+    /**
+     * Current hibernation state
+     */
+    state = 'active';
+    /**
+     * Timestamp of last activity
+     */
+    lastActivity = Date.now();
+    /**
+     * Map of active WebSocket connections by ID
+     */
+    webSockets = new Map();
+    /**
+     * WebSocket metadata storage
+     */
+    webSocketStates = new Map();
+    /**
+     * Counter for generating unique WebSocket IDs
+     */
+    wsIdCounter = 0;
+    /**
+     * Configuration with defaults applied
+     */
+    config;
+    /**
+     * Timer for idle detection (only in non-hibernating mode)
+     */
+    idleTimer;
+    /**
+     * Create a new HibernationManager
+     *
+     * @param ctx - Durable Object state from Cloudflare runtime
+     * @param config - Hibernation configuration options
+     */
+    constructor(ctx, config = {}) {
+        this.ctx = ctx;
+        this.config = {
+            idleTimeout: 10_000,
+            maxHibernationDuration: 24 * 60 * 60 * 1000,
+            preserveWebSockets: true,
+            ...config,
+        };
+        // Schedule initial idle check
+        this.scheduleIdleCheck();
+    }
+    /**
+     * Record activity to reset the idle timer
+     *
+     * Call this method whenever the DO processes a request,
+     * message, or any other activity.
+     *
+     * @example
+     * ```typescript
+     * async fetch(request: Request) {
+     *   this.hibernation.touch()
+     *   // Process request...
+     * }
+     * ```
+     */
+    touch() {
+        this.lastActivity = Date.now();
+        // If we were hibernating, wake up
+        if (this.state === 'hibernating') {
+            this.wake();
+        }
+        // Reset idle timer
+        this.scheduleIdleCheck();
+    }
+    /**
+     * Check if the DO is currently hibernating
+     *
+     * @returns True if hibernating, false if active
+     */
+    isHibernating() {
+        return this.state === 'hibernating';
+    }
+    /**
+     * Check if the DO is idle (no recent activity)
+     *
+     * @returns True if idle for longer than idleTimeout
+     */
+    isIdle() {
+        return Date.now() - this.lastActivity > this.config.idleTimeout;
+    }
+    /**
+     * Get the time since last activity in milliseconds
+     *
+     * @returns Milliseconds since last activity
+     */
+    getIdleTime() {
+        return Date.now() - this.lastActivity;
+    }
+    /**
+     * Get the current hibernation state
+     *
+     * @returns Current state ('active' or 'hibernating')
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get statistics about WebSocket connections
+     *
+     * @returns WebSocket connection statistics
+     */
+    getWebSocketStats() {
+        let active = 0;
+        let hibernating = 0;
+        for (const state of this.webSocketStates.values()) {
+            if (state.status === 'hibernating') {
+                hibernating++;
+            }
+            else if (state.status === 'open') {
+                active++;
+            }
+        }
+        return {
+            total: this.webSocketStates.size,
+            active,
+            hibernating,
+        };
+    }
+    /**
+     * Accept a WebSocket connection with hibernation support
+     *
+     * This method upgrades the HTTP request to a WebSocket connection
+     * that supports hibernation. The connection will survive hibernation
+     * and automatically reconnect when the DO wakes.
+     *
+     * @param request - The HTTP upgrade request
+     * @param data - Optional custom data to attach to the connection
+     * @returns HTTP response with WebSocket upgrade
+     *
+     * @example
+     * ```typescript
+     * async handleWebSocket(request: Request) {
+     *   const response = await this.hibernation.acceptWebSocket(request, {
+     *     userId: '123'
+     *   })
+     *   return response
+     * }
+     * ```
+     */
+    async acceptWebSocket(request, data) {
+        // Verify upgrade header
+        const upgradeHeader = request.headers.get('Upgrade');
+        if (upgradeHeader?.toLowerCase() !== 'websocket') {
+            return new Response('Expected WebSocket upgrade', { status: 426 });
+        }
+        // Create WebSocket pair
+        const pair = new WebSocketPair();
+        const [client, server] = [pair[0], pair[1]];
+        // Generate unique ID
+        const wsId = this.generateWebSocketId();
+        // Store WebSocket and state
+        this.webSockets.set(wsId, server);
+        this.webSocketStates.set(wsId, {
+            id: wsId,
+            status: 'open',
+            connectedAt: Date.now(),
+            lastMessageAt: Date.now(),
+            data,
+            subscriptions: [],
+        });
+        // Accept the WebSocket connection with hibernation support
+        // Using Durable Object's hibernatable WebSocket API
+        this.ctx.acceptWebSocket(server, [wsId]);
+        // Record activity
+        this.touch();
+        // Return the client WebSocket to the caller
+        return new Response(null, {
+            status: 101,
+            webSocket: client,
+        });
+    }
+    /**
+     * Send a message to a specific WebSocket connection
+     *
+     * @param wsId - The WebSocket connection ID
+     * @param message - The message to send
+     * @returns True if the message was sent, false if connection not found
+     */
+    sendToWebSocket(wsId, message) {
+        const ws = this.webSockets.get(wsId);
+        if (!ws)
+            return false;
+        try {
+            ws.send(message);
+            // Update last message time
+            const state = this.webSocketStates.get(wsId);
+            if (state) {
+                state.lastMessageAt = Date.now();
+            }
+            return true;
+        }
+        catch (error) {
+            console.error(`Failed to send to WebSocket ${wsId}:`, error);
+            this.handleWebSocketClose(ws);
+            return false;
+        }
+    }
+    /**
+     * Broadcast a message to all connected WebSockets
+     *
+     * @param message - The message to broadcast
+     * @param filter - Optional filter function to select recipients
+     * @returns Number of WebSockets that received the message
+     */
+    broadcast(message, filter) {
+        let sent = 0;
+        for (const [wsId, state] of this.webSocketStates) {
+            if (state.status !== 'open')
+                continue;
+            if (filter && !filter(state))
+                continue;
+            if (this.sendToWebSocket(wsId, message)) {
+                sent++;
+            }
+        }
+        return sent;
+    }
+    /**
+     * Get the state of a WebSocket connection
+     *
+     * @param wsId - The WebSocket connection ID
+     * @returns WebSocket state or undefined if not found
+     */
+    getWebSocketState(wsId) {
+        return this.webSocketStates.get(wsId);
+    }
+    /**
+     * Get all WebSocket states
+     *
+     * @returns Iterator of all WebSocket states
+     */
+    getAllWebSocketStates() {
+        return this.webSocketStates.values();
+    }
+    /**
+     * Update custom data for a WebSocket connection
+     *
+     * @param wsId - The WebSocket connection ID
+     * @param data - The data to merge with existing data
+     */
+    updateWebSocketData(wsId, data) {
+        const state = this.webSocketStates.get(wsId);
+        if (state) {
+            state.data = { ...state.data, ...data };
+        }
+    }
+    /**
+     * Subscribe a WebSocket to a topic
+     *
+     * @param wsId - The WebSocket connection ID
+     * @param topic - The topic to subscribe to
+     */
+    subscribe(wsId, topic) {
+        const state = this.webSocketStates.get(wsId);
+        if (state && !state.subscriptions.includes(topic)) {
+            state.subscriptions.push(topic);
+        }
+    }
+    /**
+     * Unsubscribe a WebSocket from a topic
+     *
+     * @param wsId - The WebSocket connection ID
+     * @param topic - The topic to unsubscribe from
+     */
+    unsubscribe(wsId, topic) {
+        const state = this.webSocketStates.get(wsId);
+        if (state) {
+            state.subscriptions = state.subscriptions.filter(t => t !== topic);
+        }
+    }
+    /**
+     * Publish a message to all subscribers of a topic
+     *
+     * @param topic - The topic to publish to
+     * @param message - The message to publish
+     * @returns Number of subscribers that received the message
+     */
+    publish(topic, message) {
+        return this.broadcast(message, state => state.subscriptions.includes(topic));
+    }
+    /**
+     * Handle WebSocket close event
+     *
+     * Called when a WebSocket connection is closed.
+     * Cleans up state and removes the connection.
+     *
+     * @param ws - The WebSocket that was closed
+     */
+    handleWebSocketClose(ws) {
+        // Find the WebSocket ID
+        for (const [wsId, storedWs] of this.webSockets) {
+            if (storedWs === ws) {
+                this.webSockets.delete(wsId);
+                const state = this.webSocketStates.get(wsId);
+                if (state) {
+                    state.status = 'closed';
+                }
+                this.webSocketStates.delete(wsId);
+                break;
+            }
+        }
+    }
+    /**
+     * Handle alarm callback
+     *
+     * Called when an alarm fires. This may be for hibernation,
+     * scheduled tasks, or other purposes.
+     *
+     * @returns Promise that resolves when alarm is handled
+     */
+    async handleAlarm() {
+        // Check if this is an idle timeout alarm
+        if (this.isIdle() && this.state === 'active') {
+            await this.hibernate();
+        }
+    }
+    /**
+     * Schedule an alarm at a specific time
+     *
+     * @param time - The time to trigger the alarm (Date or milliseconds)
+     * @param config - Optional alarm configuration
+     */
+    async scheduleAlarm(time, config) {
+        const scheduledTime = time instanceof Date ? time.getTime() : time;
+        await this.ctx.storage.setAlarm(scheduledTime);
+    }
+    /**
+     * Cancel all scheduled alarms
+     */
+    async cancelAlarms() {
+        await this.ctx.storage.deleteAlarm();
+    }
+    /**
+     * Force immediate hibernation
+     *
+     * @returns Promise that resolves when hibernation is complete
+     */
+    async forceHibernate() {
+        await this.hibernate();
+    }
+    /**
+     * Force immediate wake from hibernation
+     *
+     * @returns Promise that resolves when wake is complete
+     */
+    async forceWake() {
+        await this.wake();
+    }
+    /**
+     * Enter hibernation state
+     *
+     * @internal
+     */
+    async hibernate() {
+        if (this.state === 'hibernating')
+            return;
+        // Call pre-hibernation hook
+        if (this.config.onHibernate) {
+            await this.config.onHibernate();
+        }
+        // Mark WebSockets as hibernating
+        if (this.config.preserveWebSockets) {
+            for (const state of this.webSocketStates.values()) {
+                if (state.status === 'open') {
+                    state.status = 'hibernating';
+                    state.hibernatedAt = Date.now();
+                }
+            }
+        }
+        this.state = 'hibernating';
+        // Schedule wake-up alarm at max hibernation duration
+        await this.scheduleAlarm(Date.now() + this.config.maxHibernationDuration);
+        // Clear idle timer
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+            this.idleTimer = undefined;
+        }
+    }
+    /**
+     * Wake from hibernation state
+     *
+     * @internal
+     */
+    async wake() {
+        if (this.state === 'active')
+            return;
+        this.state = 'active';
+        // Mark WebSockets as active
+        for (const state of this.webSocketStates.values()) {
+            if (state.status === 'hibernating') {
+                state.status = 'open';
+                state.hibernatedAt = undefined;
+            }
+        }
+        // Call post-wake hook
+        if (this.config.onWake) {
+            await this.config.onWake();
+        }
+        // Schedule idle check
+        this.scheduleIdleCheck();
+    }
+    /**
+     * Schedule idle check via alarm
+     *
+     * @internal
+     */
+    scheduleIdleCheck() {
+        // Clear existing timer
+        if (this.idleTimer) {
+            clearTimeout(this.idleTimer);
+        }
+        // Schedule alarm for idle timeout
+        const alarmTime = this.lastActivity + this.config.idleTimeout;
+        this.ctx.storage.setAlarm(alarmTime).catch(error => {
+            console.error('Failed to set hibernation alarm:', error);
+        });
+    }
+    /**
+     * Generate a unique WebSocket ID
+     *
+     * @internal
+     */
+    generateWebSocketId() {
+        return `ws_${Date.now()}_${++this.wsIdCounter}`;
+    }
+}
+/**
+ * Create a HibernationManager instance
+ *
+ * @param ctx - Durable Object state
+ * @param config - Configuration options
+ * @returns HibernationManager instance
+ *
+ * @example
+ * ```typescript
+ * const hibernation = createHibernationManager(ctx, {
+ *   idleTimeout: 30_000
+ * })
+ * ```
+ */
+export function createHibernationManager(ctx, config) {
+    return new HibernationManager(ctx, config);
+}
+export default HibernationManager;
+//# sourceMappingURL=hibernation.js.map

package/dist/do/hibernation.js.map

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

package/dist/do/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Base DigitalObject Module (Epic 1)
+ *
+ * The core DigitalObject class that implements:
+ * - Identity ($id, $type, $context)
+ * - State management (SQLite-backed)
+ * - Hibernation (WebSocket connection lifecycle)
+ * - Collections (nouns, verbs, things, actions)
+ *
+ * @module do
+ */
+export { DigitalObject, DOError, type DOEnv, type DigitalObjectOptions, type FetchResult, } from './DigitalObject';
+export { createDOState, type DOState, type DOStateTransaction, type MutationHandler, type StateOptions, type ListOptions as StateListOptions, type ListResult as StateListResult, } from './state';
+export { HibernationManager, createHibernationManager, type HibernationConfig, type WebSocketState, type AlarmConfig, } from './hibernation';
+export type { DigitalObjectIdentity, DigitalObjectRef, DOType, WellKnownType, DOMetadata, ParsedDOUrl, } from '../types/identity';
+export { resolveTypeUrl } from '../types/identity';
+export * from './domains';
+export * from './colo';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../do/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,aAAa,EACb,OAAO,EACP,KAAK,KAAK,EACV,KAAK,oBAAoB,EACzB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAA;AAGxB,OAAO,EACL,aAAa,EACb,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,WAAW,IAAI,gBAAgB,EACpC,KAAK,UAAU,IAAI,eAAe,GACnC,MAAM,SAAS,CAAA;AAGhB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,WAAW,GACjB,MAAM,eAAe,CAAA;AAGtB,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,MAAM,EACN,aAAa,EACb,UAAU,EACV,WAAW,GACZ,MAAM,mBAAmB,CAAA;AAE1B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAGlD,cAAc,WAAW,CAAA;AAGzB,cAAc,QAAQ,CAAA"}

package/dist/do/index.js

@@ -0,0 +1,23 @@
+/**
+ * Base DigitalObject Module (Epic 1)
+ *
+ * The core DigitalObject class that implements:
+ * - Identity ($id, $type, $context)
+ * - State management (SQLite-backed)
+ * - Hibernation (WebSocket connection lifecycle)
+ * - Collections (nouns, verbs, things, actions)
+ *
+ * @module do
+ */
+// Base DigitalObject class
+export { DigitalObject, DOError, } from './DigitalObject';
+// State management
+export { createDOState, } from './state';
+// Hibernation support
+export { HibernationManager, createHibernationManager, } from './hibernation';
+export { resolveTypeUrl } from '../types/identity';
+// Domain management
+export * from './domains';
+// Colo awareness (geo-distribution, replication)
+export * from './colo';
+//# sourceMappingURL=index.js.map

package/dist/do/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../do/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,2BAA2B;AAC3B,OAAO,EACL,aAAa,EACb,OAAO,GAIR,MAAM,iBAAiB,CAAA;AAExB,mBAAmB;AACnB,OAAO,EACL,aAAa,GAOd,MAAM,SAAS,CAAA;AAEhB,sBAAsB;AACtB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,GAIzB,MAAM,eAAe,CAAA;AAYtB,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAElD,oBAAoB;AACpB,cAAc,WAAW,CAAA;AAEzB,iDAAiD;AACjD,cAAc,QAAQ,CAAA"}