dotdo 0.0.1 → 0.0.2

package/dist/objects/primitives/index.js

@@ -0,0 +1,337 @@
+/**
+ * DO Primitives Integration
+ *
+ * Integrates the unified primitives (TemporalStore, WindowManager,
+ * ExactlyOnceContext, TypedColumnStore) into the Durable Object architecture.
+ *
+ * Provides a factory that creates DO-backed primitives with:
+ * - Automatic persistence to DO storage
+ * - Alarm integration for time-based triggers
+ * - Proper initialization and cleanup
+ *
+ * @example
+ * ```typescript
+ * class MyDO extends DO {
+ *   async handleRequest(req: Request) {
+ *     // Get primitives via factory
+ *     const primitives = createDOPrimitiveFactory(this.ctx, this.env)
+ *
+ *     // Create a temporal store for events
+ *     const eventStore = primitives.temporal<Event>('events')
+ *     await eventStore.put('event-1', event, Date.now())
+ *
+ *     // Create a window manager for aggregation
+ *     const windowMgr = primitives.window('tumbling', { size: { minutes: 5 } })
+ *     windowMgr.process(metric, Date.now())
+ *   }
+ * }
+ * ```
+ */
+import { createTemporalStore, WindowManager, hours, minutes, seconds, milliseconds, createExactlyOnceContext, createColumnStore, EventTimeTrigger, CountTrigger, ProcessingTimeTrigger, } from '../../db/primitives';
+import { createDOStorageAdapter, createTemporalStorageAdapter, createExactlyOnceStorageAdapter, } from './storage-adapter';
+import { createDOAlarmAdapter, createWindowAlarmIntegration, } from './alarm-adapter';
+// Re-export adapters for direct usage
+export * from './storage-adapter';
+export * from './alarm-adapter';
+// ============================================================================
+// Implementation
+// ============================================================================
+/**
+ * Convert DurationSpec to duration object
+ */
+function toDuration(spec) {
+    if (spec.hours)
+        return hours(spec.hours);
+    if (spec.minutes)
+        return minutes(spec.minutes);
+    if (spec.seconds)
+        return seconds(spec.seconds);
+    if (spec.milliseconds)
+        return milliseconds(spec.milliseconds);
+    throw new Error('Invalid duration spec: must specify hours, minutes, seconds, or milliseconds');
+}
+/**
+ * DO Primitive Factory implementation
+ */
+class DOPrimitiveFactoryImpl {
+    ctx;
+    env;
+    storageAdapter;
+    alarmAdapter;
+    windowIntegration;
+    // Instance caches for lazy initialization and reuse
+    temporalStores = new Map();
+    columnStores = new Map();
+    exactlyOnceCtx = null;
+    constructor(ctx, env) {
+        this.ctx = ctx;
+        this.env = env;
+        this.storageAdapter = createDOStorageAdapter(ctx.storage);
+        this.alarmAdapter = createDOAlarmAdapter(ctx);
+        this.windowIntegration = createWindowAlarmIntegration(this.alarmAdapter, ctx.storage);
+    }
+    temporal(name, options) {
+        const cached = this.temporalStores.get(name);
+        if (cached)
+            return cached;
+        // Create DO-backed temporal store
+        const storageAdapter = createTemporalStorageAdapter(this.ctx.storage, name);
+        const store = createDOBackedTemporalStore(storageAdapter, options);
+        this.temporalStores.set(name, store);
+        return store;
+    }
+    window(type, config) {
+        // Create window assigner based on type
+        let assigner;
+        switch (type) {
+            case 'tumbling':
+                if (!config.size)
+                    throw new Error('Tumbling windows require a size');
+                assigner = WindowManager.tumbling(toDuration(config.size));
+                break;
+            case 'sliding':
+                if (!config.size || !config.slide)
+                    throw new Error('Sliding windows require both size and slide');
+                assigner = WindowManager.sliding(toDuration(config.size), toDuration(config.slide));
+                break;
+            case 'session':
+                if (!config.gap)
+                    throw new Error('Session windows require a gap');
+                assigner = WindowManager.session(toDuration(config.gap));
+                break;
+            case 'global':
+                assigner = WindowManager.global();
+                break;
+            default:
+                throw new Error(`Unknown window type: ${type}`);
+        }
+        const windowManager = new WindowManager(assigner);
+        // Configure trigger
+        if (config.trigger) {
+            let trigger;
+            if (config.trigger === 'eventTime') {
+                trigger = new EventTimeTrigger();
+            }
+            else if (config.trigger === 'count') {
+                trigger = new CountTrigger(1);
+            }
+            else if (config.trigger === 'processingTime') {
+                trigger = new ProcessingTimeTrigger(minutes(1));
+            }
+            else if ('count' in config.trigger) {
+                trigger = new CountTrigger(config.trigger.count);
+            }
+            else if ('interval' in config.trigger) {
+                trigger = new ProcessingTimeTrigger(toDuration(config.trigger.interval));
+            }
+            else {
+                trigger = new EventTimeTrigger();
+            }
+            windowManager.withTrigger(trigger);
+        }
+        else {
+            // Default to event time trigger
+            windowManager.withTrigger(new EventTimeTrigger());
+        }
+        // Configure key extractor
+        if (config.keyBy) {
+            windowManager.withKeyExtractor(config.keyBy);
+        }
+        // Integrate with DO alarms for automatic watermark advancement
+        const originalProcess = windowManager.process.bind(windowManager);
+        windowManager.process = (element, timestamp) => {
+            originalProcess(element, timestamp);
+            // Schedule alarm for any new windows that will need to trigger
+            const windows = windowManager.assign(element, timestamp);
+            for (const window of windows) {
+                // Schedule alarm slightly after window end
+                this.windowIntegration.scheduleWindowTrigger(window.end + 1);
+            }
+        };
+        // Register alarm handler for window triggers
+        this.alarmAdapter.onAlarm('window-trigger', async () => {
+            await this.windowIntegration.handleWindowAlarm((timestamp) => {
+                windowManager.advanceWatermark(timestamp);
+            });
+        });
+        return windowManager;
+    }
+    exactlyOnce(options) {
+        if (this.exactlyOnceCtx)
+            return this.exactlyOnceCtx;
+        // Create DO-backed exactly-once context
+        const storageAdapter = createExactlyOnceStorageAdapter(this.ctx.storage, 'default');
+        this.exactlyOnceCtx = createDOBackedExactlyOnceContext(storageAdapter, options);
+        return this.exactlyOnceCtx;
+    }
+    columns(name) {
+        const cached = this.columnStores.get(name);
+        if (cached)
+            return cached;
+        // Create column store (currently in-memory, persistence can be added later)
+        const store = createColumnStore();
+        this.columnStores.set(name, store);
+        return store;
+    }
+    alarms() {
+        return this.alarmAdapter;
+    }
+    storage() {
+        return this.storageAdapter;
+    }
+    async handleAlarm() {
+        await this.alarmAdapter.handleAlarm();
+    }
+}
+/**
+ * Create a DO-backed temporal store
+ */
+function createDOBackedTemporalStore(storageAdapter, options) {
+    // Create the base in-memory temporal store
+    const memStore = createTemporalStore(options);
+    // Wrap with persistence layer
+    const store = {
+        async put(key, value, timestamp, opts) {
+            // Store in memory first
+            await memStore.put(key, value, timestamp, opts);
+            // Persist to DO storage
+            const versions = await storageAdapter.loadVersions(key);
+            const version = versions.length + 1;
+            await storageAdapter.saveVersion(key, value, timestamp, version, opts?.ttl ? timestamp + opts.ttl : undefined);
+        },
+        async get(key) {
+            // Try memory first
+            const memResult = await memStore.get(key);
+            if (memResult !== null)
+                return memResult;
+            // Fall back to storage
+            const versions = await storageAdapter.loadVersions(key);
+            if (versions.length === 0)
+                return null;
+            const lastVersion = versions[versions.length - 1];
+            return lastVersion ? lastVersion.value : null;
+        },
+        async getAsOf(key, timestamp) {
+            // Try memory first
+            const memResult = await memStore.getAsOf(key, timestamp);
+            if (memResult !== null)
+                return memResult;
+            // Fall back to storage
+            const versions = await storageAdapter.loadVersions(key);
+            for (let i = versions.length - 1; i >= 0; i--) {
+                const version = versions[i];
+                if (version && version.timestamp <= timestamp) {
+                    return version.value;
+                }
+            }
+            return null;
+        },
+        range(prefix, timeRange) {
+            // Delegate to memory store for now
+            return memStore.range(prefix, timeRange);
+        },
+        async snapshot() {
+            return memStore.snapshot();
+        },
+        async restoreSnapshot(id) {
+            return memStore.restoreSnapshot(id);
+        },
+        async listSnapshots() {
+            return memStore.listSnapshots();
+        },
+        async prune(policy) {
+            return memStore.prune(policy);
+        },
+        async compact(policy) {
+            return memStore.compact(policy);
+        },
+        getRetentionPolicy() {
+            return memStore.getRetentionPolicy();
+        },
+        setRetentionPolicy(policy) {
+            memStore.setRetentionPolicy(policy);
+        },
+    };
+    return store;
+}
+/**
+ * Create a DO-backed exactly-once context
+ */
+function createDOBackedExactlyOnceContext(storageAdapter, options) {
+    // Create the base in-memory context
+    const memCtx = createExactlyOnceContext(options);
+    // Wrap with persistence layer
+    const ctx = {
+        async processOnce(eventId, fn) {
+            // Check storage for already processed
+            const processed = await storageAdapter.loadProcessedIds();
+            if (processed.has(eventId)) {
+                return processed.get(eventId).result;
+            }
+            // Process using memory context
+            const result = await memCtx.processOnce(eventId, fn);
+            // Persist to storage
+            await storageAdapter.markProcessed(eventId, Date.now(), result);
+            return result;
+        },
+        async isProcessed(eventId) {
+            // Check memory first
+            const memResult = await memCtx.isProcessed(eventId);
+            if (memResult)
+                return true;
+            // Check storage
+            const processed = await storageAdapter.loadProcessedIds();
+            return processed.has(eventId);
+        },
+        async transaction(fn) {
+            // Use memory context for transactions
+            const result = await memCtx.transaction(fn);
+            // Persist state changes
+            const state = (await memCtx.getCheckpointState()).state;
+            await storageAdapter.saveState(state);
+            return result;
+        },
+        emit(event) {
+            memCtx.emit(event);
+        },
+        async flush() {
+            return memCtx.flush();
+        },
+        async onBarrier(barrier) {
+            return memCtx.onBarrier(barrier);
+        },
+        async getCheckpointState() {
+            return memCtx.getCheckpointState();
+        },
+        async restoreFromCheckpoint(state) {
+            return memCtx.restoreFromCheckpoint(state);
+        },
+        getEpoch() {
+            return memCtx.getEpoch();
+        },
+        getBufferedEventCount() {
+            return memCtx.getBufferedEventCount();
+        },
+        async clear() {
+            return memCtx.clear();
+        },
+    };
+    return ctx;
+}
+/**
+ * Create a DO primitive factory
+ *
+ * @param ctx - Durable Object state
+ * @param env - Environment bindings
+ * @returns Primitive factory instance
+ *
+ * @example
+ * ```typescript
+ * const primitives = createDOPrimitiveFactory(this.ctx, this.env)
+ * const eventStore = primitives.temporal<Event>('events')
+ * ```
+ */
+export function createDOPrimitiveFactory(ctx, env) {
+    return new DOPrimitiveFactoryImpl(ctx, env);
+}
+//# sourceMappingURL=index.js.map

package/dist/objects/primitives/index.js.map

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

package/dist/objects/primitives/storage-adapter.js

@@ -0,0 +1,182 @@
+/**
+ * DO Storage Adapter
+ *
+ * Adapts Durable Object storage to work with the unified primitives.
+ * Provides a consistent interface for primitives to persist their state
+ * using DO's built-in storage mechanisms.
+ *
+ * Key features:
+ * - Namespaced key storage to avoid collisions
+ * - Batch operations for efficiency
+ * - Serialization/deserialization handling
+ * - SQL storage support for complex queries
+ */
+/**
+ * Internal prefix for DO storage keys
+ */
+const DEFAULT_NAMESPACE = 'primitives';
+/**
+ * DO Storage Adapter implementation
+ */
+class DOStorageAdapterImpl {
+    storage;
+    namespace;
+    useSql;
+    constructor(storage, options) {
+        this.storage = storage;
+        this.namespace = options?.namespace ?? DEFAULT_NAMESPACE;
+        this.useSql = options?.useSql ?? false;
+    }
+    /**
+     * Get the prefixed key for DO storage
+     */
+    prefixKey(key) {
+        return `${this.namespace}:${key}`;
+    }
+    /**
+     * Remove prefix from key
+     */
+    unprefixKey(prefixedKey) {
+        const prefix = `${this.namespace}:`;
+        return prefixedKey.startsWith(prefix) ? prefixedKey.slice(prefix.length) : prefixedKey;
+    }
+    async get(key) {
+        return this.storage.get(this.prefixKey(key));
+    }
+    async put(key, value) {
+        await this.storage.put(this.prefixKey(key), value);
+    }
+    async delete(key) {
+        return this.storage.delete(this.prefixKey(key));
+    }
+    async list(prefix) {
+        const fullPrefix = prefix ? this.prefixKey(prefix) : `${this.namespace}:`;
+        const entries = await this.storage.list({ prefix: fullPrefix });
+        // Convert to Map with unprefixed keys
+        const result = new Map();
+        for (const [key, value] of entries) {
+            result.set(this.unprefixKey(key), value);
+        }
+        return result;
+    }
+    async putMany(entries) {
+        if (entries.length === 0)
+            return;
+        // Convert to object for batch put
+        const batch = {};
+        for (const { key, value } of entries) {
+            batch[this.prefixKey(key)] = value;
+        }
+        await this.storage.put(batch);
+    }
+    async deleteMany(keys) {
+        if (keys.length === 0)
+            return;
+        await this.storage.delete(keys.map((k) => this.prefixKey(k)));
+    }
+}
+/**
+ * Create a storage adapter for DO primitives
+ *
+ * @param storage - Durable Object storage instance
+ * @param options - Adapter configuration options
+ * @returns Storage adapter compatible with primitives
+ */
+export function createDOStorageAdapter(storage, options) {
+    return new DOStorageAdapterImpl(storage, options);
+}
+/**
+ * Create a temporal storage adapter
+ */
+export function createTemporalStorageAdapter(storage, storeName) {
+    const prefix = `primitives:temporal:${storeName}:`;
+    return {
+        async loadVersions(key) {
+            const entries = await storage.list({ prefix: `${prefix}versions:${key}:` });
+            const versions = [];
+            for (const [, entry] of entries) {
+                versions.push({
+                    value: entry.value,
+                    timestamp: entry.timestamp,
+                    version: entry.version,
+                });
+            }
+            // Sort by timestamp
+            versions.sort((a, b) => a.timestamp - b.timestamp);
+            return versions;
+        },
+        async saveVersion(key, value, timestamp, version, expiresAt) {
+            await storage.put(`${prefix}versions:${key}:${version}`, {
+                value,
+                timestamp,
+                version,
+                expiresAt,
+            });
+        },
+        async pruneVersions(key, olderThan) {
+            const entries = await storage.list({ prefix: `${prefix}versions:${key}:` });
+            const keysToDelete = [];
+            for (const [storageKey, entry] of entries) {
+                if (entry.timestamp < olderThan) {
+                    keysToDelete.push(storageKey);
+                }
+            }
+            if (keysToDelete.length > 0) {
+                await storage.delete(keysToDelete);
+            }
+            return keysToDelete.length;
+        },
+        async loadSnapshots() {
+            return storage.list({ prefix: `${prefix}snapshots:` });
+        },
+        async saveSnapshot(id, snapshot) {
+            await storage.put(`${prefix}snapshots:${id}`, snapshot);
+        },
+        async deleteSnapshot(id) {
+            await storage.delete(`${prefix}snapshots:${id}`);
+        },
+    };
+}
+/**
+ * Create an exactly-once storage adapter
+ */
+export function createExactlyOnceStorageAdapter(storage, contextName) {
+    const prefix = `primitives:exactlyonce:${contextName}:`;
+    return {
+        async loadProcessedIds() {
+            const entries = await storage.list({
+                prefix: `${prefix}processed:`,
+            });
+            const result = new Map();
+            for (const [key, value] of entries) {
+                const eventId = key.slice(`${prefix}processed:`.length);
+                result.set(eventId, value);
+            }
+            return result;
+        },
+        async markProcessed(eventId, timestamp, result) {
+            await storage.put(`${prefix}processed:${eventId}`, { timestamp, result });
+        },
+        async pruneExpired(olderThan) {
+            const entries = await storage.list({ prefix: `${prefix}processed:` });
+            const keysToDelete = [];
+            for (const [key, value] of entries) {
+                if (value.timestamp < olderThan) {
+                    keysToDelete.push(key);
+                }
+            }
+            if (keysToDelete.length > 0) {
+                await storage.delete(keysToDelete);
+            }
+            return keysToDelete.length;
+        },
+        async loadState() {
+            const state = await storage.get(`${prefix}state`);
+            return new Map(Object.entries(state ?? {}));
+        },
+        async saveState(state) {
+            await storage.put(`${prefix}state`, Object.fromEntries(state));
+        },
+    };
+}
+//# sourceMappingURL=storage-adapter.js.map

package/dist/objects/primitives/storage-adapter.js.map

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

package/dist/objects/primitives/with-primitives.js

@@ -0,0 +1,102 @@
+/**
+ * With Primitives Mixin
+ *
+ * A capability mixin that adds the unified primitives to any Durable Object class.
+ * Provides zero-config access to:
+ * - TemporalStore: Time-aware key-value storage
+ * - WindowManager: Stream windowing and aggregation
+ * - ExactlyOnceContext: Idempotent event processing
+ * - TypedColumnStore: Columnar analytical storage
+ *
+ * @example
+ * ```typescript
+ * import { DO } from 'dotdo'
+ * import { withPrimitives } from 'dotdo/primitives'
+ *
+ * class MyDO extends withPrimitives(DO) {
+ *   async handleRequest(req: Request) {
+ *     // Access primitives via $.primitives
+ *     const eventStore = this.$.primitives.temporal<Event>('events')
+ *     await eventStore.put('event-1', event, Date.now())
+ *
+ *     // Process events exactly once
+ *     await this.$.primitives.exactlyOnce().processOnce(event.id, async () => {
+ *       // Process event
+ *     })
+ *   }
+ * }
+ * ```
+ */
+import { createCapabilityMixin, } from '../mixins/infrastructure';
+import { createDOPrimitiveFactory, } from './index';
+import { WindowManager } from '../../db/primitives';
+export { WindowManager };
+/**
+ * Create the primitives capability
+ */
+function createPrimitivesCapability(ctx) {
+    // Create the factory lazily on first access
+    let factory = null;
+    const getFactory = () => {
+        if (!factory) {
+            factory = createDOPrimitiveFactory(ctx.state, ctx.env);
+        }
+        return factory;
+    };
+    return {
+        temporal(name, options) {
+            return getFactory().temporal(name, options);
+        },
+        window(type, config) {
+            return getFactory().window(type, config);
+        },
+        exactlyOnce(options) {
+            return getFactory().exactlyOnce(options);
+        },
+        columns(name) {
+            return getFactory().columns(name);
+        },
+        async handleAlarm() {
+            return getFactory().handleAlarm();
+        },
+    };
+}
+/**
+ * Primitives mixin
+ *
+ * Adds unified primitives capability to a Durable Object class.
+ *
+ * @param Base - Base DO class to extend
+ * @returns Extended class with primitives capability
+ *
+ * @example
+ * ```typescript
+ * import { DO } from 'dotdo'
+ * import { withPrimitives } from 'dotdo/primitives'
+ *
+ * // Add primitives to DO
+ * class MyDO extends withPrimitives(DO) {
+ *   async fetch(request: Request) {
+ *     // Use primitives via $.primitives
+ *     const store = this.$.primitives.temporal('events')
+ *     // ...
+ *   }
+ * }
+ *
+ * // Compose with other mixins
+ * import { withFs } from 'dotdo/mixins'
+ * class FullDO extends withFs(withPrimitives(DO)) {
+ *   // Has both $.primitives and $.fs
+ * }
+ * ```
+ */
+export const withPrimitives = createCapabilityMixin('primitives', createPrimitivesCapability);
+/**
+ * Convenience re-export of primitive utilities
+ */
+export { 
+// Duration helpers from WindowManager
+hours, minutes, seconds, milliseconds, 
+// Trigger types
+EventTimeTrigger, CountTrigger, ProcessingTimeTrigger, PurgingTrigger, Trigger, } from '../../db/primitives';
+//# sourceMappingURL=with-primitives.js.map

package/dist/objects/primitives/with-primitives.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"with-primitives.js","sourceRoot":"","sources":["../../../objects/primitives/with-primitives.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EACL,qBAAqB,GAGtB,MAAM,0BAA0B,CAAA;AAEjC,OAAO,EACL,wBAAwB,GAKzB,MAAM,SAAS,CAAA;AAUhB,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAenD,OAAO,EAAE,aAAa,EAAE,CAAA;AAqHxB;;GAEG;AACH,SAAS,0BAA0B,CAAC,GAAsB;IACxD,4CAA4C;IAC5C,IAAI,OAAO,GAA8B,IAAI,CAAA;IAE7C,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,wBAAwB,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,CAAA;QACxD,CAAC;QACD,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IAED,OAAO;QACL,QAAQ,CAAI,IAAY,EAAE,OAA8B;YACtD,OAAO,UAAU,EAAE,CAAC,QAAQ,CAAI,IAAI,EAAE,OAAO,CAAC,CAAA;QAChD,CAAC;QAED,MAAM,CAAI,IAAgB,EAAE,MAAoB;YAC9C,OAAO,UAAU,EAAE,CAAC,MAAM,CAAI,IAAI,EAAE,MAAM,CAAC,CAAA;QAC7C,CAAC;QAED,WAAW,CAAC,OAAmC;YAC7C,OAAO,UAAU,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;QAC1C,CAAC;QAED,OAAO,CAAC,IAAY;YAClB,OAAO,UAAU,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACnC,CAAC;QAED,KAAK,CAAC,WAAW;YACf,OAAO,UAAU,EAAE,CAAC,WAAW,EAAE,CAAA;QACnC,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,qBAAqB,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAA;AAwB7F;;GAEG;AACH,OAAO;AACL,sCAAsC;AACtC,KAAK,EACL,OAAO,EACP,OAAO,EACP,YAAY;AACZ,gBAAgB;AAChB,gBAAgB,EAChB,YAAY,EACZ,qBAAqB,EACrB,cAAc,EACd,OAAO,GACR,MAAM,qBAAqB,CAAA"}