dotdo 0.0.1 → 0.0.2

package/dist/lib/StateStorage.js

@@ -0,0 +1,403 @@
+/**
+ * StateStorage - Type-safe wrapper around Durable Object state API
+ *
+ * Provides:
+ * - Type-safe get/set/delete operations
+ * - Batch read/write
+ * - Transactions
+ * - Optional JSON schema validation
+ * - State versioning/migration
+ * - TTL support
+ * - Key prefixing
+ */
+/// <reference types="@cloudflare/workers-types" />
+// ============================================================================
+// ERRORS
+// ============================================================================
+export class StateStorageError extends Error {
+    key;
+    operation;
+    constructor(message, operation, key) {
+        super(message);
+        this.name = 'StateStorageError';
+        this.operation = operation;
+        this.key = key;
+    }
+}
+export class StateValidationError extends StateStorageError {
+    validatorKey;
+    constructor(key, validatorKey) {
+        super(`Validation failed for key '${key}' using validator '${validatorKey}'`, 'validation', key);
+        this.name = 'StateValidationError';
+        this.validatorKey = validatorKey;
+    }
+}
+export class StateMigrationError extends StateStorageError {
+    fromVersion;
+    toVersion;
+    constructor(key, fromVersion, toVersion, cause) {
+        super(`Migration failed for key '${key}' from version ${fromVersion} to ${toVersion}: ${cause?.message || 'Unknown error'}`, 'migration', key);
+        this.name = 'StateMigrationError';
+        this.fromVersion = fromVersion;
+        this.toVersion = toVersion;
+    }
+}
+// ============================================================================
+// STATE STORAGE
+// ============================================================================
+export class StateStorage {
+    storage;
+    options;
+    prefix;
+    versioned;
+    version;
+    validators;
+    validateOnGet;
+    migrations;
+    defaultTTL;
+    maxValueSize;
+    // ═══════════════════════════════════════════════════════════════════════════
+    // CONSTRUCTOR
+    // ═══════════════════════════════════════════════════════════════════════════
+    constructor(state, options = {}) {
+        if (!state?.storage) {
+            throw new StateStorageError('Invalid state: storage is required', 'constructor');
+        }
+        this.storage = state.storage;
+        this.options = options;
+        this.prefix = options.prefix ?? '';
+        this.versioned = options.versioned ?? false;
+        this.version = options.version ?? 1;
+        this.validators = options.validators ?? {};
+        this.validateOnGet = options.validateOnGet ?? false;
+        this.migrations = options.migrations ?? {};
+        this.defaultTTL = options.defaultTTL ?? 0;
+        this.maxValueSize = options.maxValueSize;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // BASIC OPERATIONS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get a value by key
+     */
+    async get(key, defaultValue) {
+        try {
+            const fullKey = this.prefixKey(key);
+            const wrapped = await this.storage.get(fullKey);
+            if (wrapped === undefined) {
+                return defaultValue;
+            }
+            // Check for versioned wrapper vs raw value
+            if (!this.isWrappedValue(wrapped)) {
+                // Raw value (not wrapped), return as-is
+                return wrapped;
+            }
+            // Check TTL
+            if (wrapped.expiresAt && Date.now() >= wrapped.expiresAt) {
+                // Value expired, delete and return default
+                await this.storage.delete(fullKey);
+                return defaultValue;
+            }
+            let value = wrapped.value;
+            // Run migrations if needed
+            if (this.versioned && wrapped.version !== undefined && wrapped.version < this.version) {
+                value = await this.migrateValue(key, value, wrapped.version);
+                // Update stored value with new version
+                await this.setInternal(key, value, { ttl: wrapped.expiresAt ? wrapped.expiresAt - Date.now() : 0 });
+            }
+            // Validate if configured
+            if (this.validateOnGet) {
+                this.validateValue(key, value);
+            }
+            return value;
+        }
+        catch (error) {
+            if (error instanceof StateStorageError)
+                throw error;
+            throw new StateStorageError(`Failed to get key '${key}': ${error.message}`, 'get', key);
+        }
+    }
+    /**
+     * Set a value
+     */
+    async set(key, value, options = {}) {
+        // Validate if validator exists for this key
+        this.validateValue(key, value);
+        await this.setInternal(key, value, options);
+    }
+    /**
+     * Internal set implementation
+     */
+    async setInternal(key, value, options = {}) {
+        try {
+            const fullKey = this.prefixKey(key);
+            // Check value size if configured
+            if (this.maxValueSize || options.warnOnLargeValue) {
+                const size = this.estimateSize(value);
+                if (this.maxValueSize && size > this.maxValueSize) {
+                    throw new StateStorageError(`Value exceeds maximum size (${size} > ${this.maxValueSize} bytes)`, 'set', key);
+                }
+                if (options.warnOnLargeValue && options.largeValueThreshold && size > options.largeValueThreshold) {
+                    console.warn(`StateStorage: large value detected for key '${key}' (${size} bytes)`);
+                }
+            }
+            // Determine TTL
+            const ttl = options.ttl !== undefined ? options.ttl : this.defaultTTL;
+            const now = Date.now();
+            // Wrap value with metadata
+            const wrapped = {
+                value,
+                createdAt: now,
+                updatedAt: now,
+                ...(this.versioned && { version: this.version }),
+                ...(ttl > 0 && { expiresAt: now + ttl }),
+            };
+            // Check if updating existing value to preserve createdAt
+            const existing = await this.storage.get(fullKey);
+            if (existing && this.isWrappedValue(existing)) {
+                wrapped.createdAt = existing.createdAt;
+            }
+            await this.storage.put(fullKey, wrapped);
+        }
+        catch (error) {
+            if (error instanceof StateStorageError)
+                throw error;
+            throw new StateStorageError(`Failed to set key '${key}': ${error.message}`, 'set', key);
+        }
+    }
+    /**
+     * Delete a value
+     */
+    async delete(key) {
+        try {
+            const fullKey = this.prefixKey(key);
+            return await this.storage.delete(fullKey);
+        }
+        catch (error) {
+            throw new StateStorageError(`Failed to delete key '${key}': ${error.message}`, 'delete', key);
+        }
+    }
+    /**
+     * Check if key exists
+     */
+    async has(key) {
+        const value = await this.get(key);
+        return value !== undefined;
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // BATCH OPERATIONS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get multiple values at once
+     */
+    async getMany(keys) {
+        const result = {};
+        // Process all keys
+        await Promise.all(keys.map(async (key) => {
+            result[key] = await this.get(key);
+        }));
+        return result;
+    }
+    /**
+     * Set multiple values at once
+     */
+    async setMany(values, options = {}) {
+        await Promise.all(Object.entries(values).map(([key, value]) => this.set(key, value, options)));
+    }
+    /**
+     * Delete multiple keys at once
+     */
+    async deleteMany(keys) {
+        let count = 0;
+        await Promise.all(keys.map(async (key) => {
+            if (await this.delete(key)) {
+                count++;
+            }
+        }));
+        return count;
+    }
+    /**
+     * List entries with optional filtering
+     */
+    async list(options = {}) {
+        const storagePrefix = this.prefix + (options.prefix ?? '');
+        const entries = await this.storage.list({
+            prefix: storagePrefix,
+            limit: options.limit,
+            start: options.start ? this.prefix + options.start : undefined,
+            end: options.end ? this.prefix + options.end : undefined,
+        });
+        const result = new Map();
+        const now = Date.now();
+        for (const [fullKey, wrapped] of entries) {
+            // Strip prefix from key
+            const key = this.stripPrefix(fullKey);
+            // Skip expired values
+            if (this.isWrappedValue(wrapped) && wrapped.expiresAt && now >= wrapped.expiresAt) {
+                continue;
+            }
+            // Extract value
+            const value = this.isWrappedValue(wrapped) ? wrapped.value : wrapped;
+            result.set(key, value);
+        }
+        return result;
+    }
+    /**
+     * Get keys with optional prefix filter
+     */
+    async keys(options = {}) {
+        const entries = await this.list(options);
+        return Array.from(entries.keys());
+    }
+    /**
+     * Count entries with optional prefix filter
+     */
+    async count(options = {}) {
+        const entries = await this.list(options);
+        return entries.size;
+    }
+    /**
+     * Clear all entries or entries with prefix
+     */
+    async clear(options = {}) {
+        if (options.prefix) {
+            // Delete only entries with the given prefix
+            const keys = await this.keys({ prefix: options.prefix });
+            await this.deleteMany(keys);
+        }
+        else {
+            // Delete all entries
+            await this.storage.deleteAll();
+        }
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // TRANSACTIONS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Execute a transaction
+     */
+    async transaction(closure) {
+        // Create transaction context
+        const tx = {
+            get: async (key, defaultValue) => this.get(key, defaultValue),
+            set: async (key, value, options) => this.set(key, value, options),
+            delete: async (key) => this.delete(key),
+            has: async (key) => this.has(key),
+        };
+        // Use DO storage transaction
+        return await this.storage.transaction(async () => {
+            return await closure(tx);
+        });
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // METADATA & UTILITIES
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Get metadata for a key
+     */
+    async getMetadata(key) {
+        const fullKey = this.prefixKey(key);
+        const wrapped = await this.storage.get(fullKey);
+        if (!wrapped || !this.isWrappedValue(wrapped)) {
+            return undefined;
+        }
+        return {
+            version: wrapped.version,
+            createdAt: wrapped.createdAt,
+            updatedAt: wrapped.updatedAt,
+            expiresAt: wrapped.expiresAt,
+        };
+    }
+    /**
+     * Get storage statistics
+     */
+    async getStats() {
+        const entries = await this.list();
+        let estimatedSize = 0;
+        for (const [key, value] of entries) {
+            estimatedSize += key.length * 2; // UTF-16 chars
+            estimatedSize += this.estimateSize(value);
+        }
+        return {
+            keyCount: entries.size,
+            estimatedSize,
+        };
+    }
+    // ═══════════════════════════════════════════════════════════════════════════
+    // PRIVATE HELPERS
+    // ═══════════════════════════════════════════════════════════════════════════
+    /**
+     * Check if value is a wrapped value (has our metadata structure)
+     */
+    isWrappedValue(value) {
+        if (typeof value !== 'object' || value === null)
+            return false;
+        const obj = value;
+        return 'value' in obj && 'createdAt' in obj && 'updatedAt' in obj;
+    }
+    /**
+     * Add prefix to key
+     */
+    prefixKey(key) {
+        return this.prefix + key;
+    }
+    /**
+     * Remove prefix from key
+     */
+    stripPrefix(key) {
+        if (this.prefix && key.startsWith(this.prefix)) {
+            return key.slice(this.prefix.length);
+        }
+        return key;
+    }
+    /**
+     * Validate a value using configured validator
+     */
+    validateValue(key, value) {
+        // Find validator for this key
+        const validator = this.validators[key];
+        if (validator && !validator(value)) {
+            throw new StateValidationError(key, key);
+        }
+    }
+    /**
+     * Run migrations on a value
+     */
+    async migrateValue(key, value, fromVersion) {
+        const keyMigrations = this.migrations[key];
+        if (!keyMigrations) {
+            // No migrations defined for this key, return as-is
+            return value;
+        }
+        let currentValue = value;
+        let currentVersion = fromVersion;
+        // Run migrations in sequence
+        while (currentVersion < this.version) {
+            const migration = keyMigrations[currentVersion];
+            if (migration) {
+                try {
+                    currentValue = migration(currentValue);
+                }
+                catch (error) {
+                    throw new StateMigrationError(key, currentVersion, currentVersion + 1, error);
+                }
+            }
+            currentVersion++;
+        }
+        return currentValue;
+    }
+    /**
+     * Estimate size of a value in bytes
+     */
+    estimateSize(value) {
+        try {
+            const json = JSON.stringify(value);
+            return json.length * 2; // Rough estimate for UTF-16
+        }
+        catch {
+            return 0;
+        }
+    }
+}
+export default StateStorage;
+//# sourceMappingURL=StateStorage.js.map

package/dist/lib/StateStorage.js.map

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

package/dist/lib/TypeRegistry.js

@@ -0,0 +1,122 @@
+/**
+ * TypeRegistry - Registry for DO type classes
+ *
+ * Provides registration, lookup, and inheritance queries for DO types.
+ */
+/**
+ * Reserved type names that cannot be registered
+ */
+const RESERVED_TYPES = new Set([
+    'Object',
+    'Function',
+    'Array',
+    'String',
+    'Number',
+    'Boolean',
+    'Symbol',
+    'Error',
+    'Promise',
+    'Date',
+    'RegExp',
+    'Map',
+    'Set',
+    'WeakMap',
+    'WeakSet',
+    'Proxy',
+    'Reflect',
+]);
+/**
+ * TypeRegistry - Registry for DO type classes
+ */
+export class TypeRegistry {
+    types = new Map();
+    metadata = new Map();
+    /**
+     * Register a DO class by its $type
+     */
+    register(DOClass, options) {
+        const $type = DOClass.$type;
+        // Validate $type exists
+        if (!$type) {
+            throw new Error('Class must have a static $type property');
+        }
+        // Validate PascalCase
+        if (!/^[A-Z][a-zA-Z0-9]*$/.test($type)) {
+            if (/^[a-z]/.test($type)) {
+                throw new Error(`Type name must be PascalCase: ${$type}`);
+            }
+            throw new Error(`Type name contains invalid characters: ${$type}`);
+        }
+        // Check reserved names
+        if (RESERVED_TYPES.has($type)) {
+            throw new Error(`Type name is reserved: ${$type}`);
+        }
+        // Check for duplicate registration
+        const existing = this.types.get($type);
+        if (existing) {
+            throw new Error(`Type "${$type}" is already registered by ${existing.name}`);
+        }
+        // Store the class
+        this.types.set($type, DOClass);
+        // Store metadata
+        const parentClass = Object.getPrototypeOf(DOClass);
+        const extendsType = parentClass?.$type || undefined;
+        this.metadata.set($type, {
+            binding: options?.binding || 'DO',
+            extends: extendsType,
+        });
+    }
+    /**
+     * Get a registered class by $type
+     */
+    get($type) {
+        return this.types.get($type);
+    }
+    /**
+     * Get metadata for a registered type
+     */
+    getMetadata($type) {
+        return this.metadata.get($type) || { binding: 'DO' };
+    }
+    /**
+     * List all registered type names
+     */
+    listTypes() {
+        return Array.from(this.types.keys());
+    }
+    /**
+     * Find all types that extend a base type
+     */
+    findSubtypes(baseType) {
+        const subtypes = [];
+        for (const [$type, DOClass] of this.types) {
+            if ($type === baseType)
+                continue;
+            // Walk up the prototype chain
+            let current = Object.getPrototypeOf(DOClass);
+            while (current && current.$type) {
+                if (current.$type === baseType) {
+                    subtypes.push($type);
+                    break;
+                }
+                current = Object.getPrototypeOf(current);
+            }
+        }
+        return subtypes;
+    }
+    /**
+     * Check if a type is registered
+     */
+    has($type) {
+        return this.types.has($type);
+    }
+    /**
+     * Clear all registered types
+     */
+    clear() {
+        this.types.clear();
+        this.metadata.clear();
+    }
+}
+export default TypeRegistry;
+//# sourceMappingURL=TypeRegistry.js.map

package/dist/lib/TypeRegistry.js.map

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