dotdo 0.0.1 → 0.0.2

package/dist/primitives/fsx/core/types.js

@@ -0,0 +1,307 @@
+/**
+ * Core filesystem types
+ *
+ * This module defines the comprehensive TypeScript interfaces for the fsx.do
+ * filesystem capability. These types provide a POSIX-like API for filesystem
+ * operations on Cloudflare Durable Objects with tiered storage support.
+ *
+ * @module core/types
+ */
+import { constants } from './constants';
+/**
+ * File statistics class
+ */
+export class Stats {
+    /** Device ID */
+    dev;
+    /** Inode number */
+    ino;
+    /** File mode (permissions + type) */
+    mode;
+    /** Number of hard links */
+    nlink;
+    /** User ID */
+    uid;
+    /** Group ID */
+    gid;
+    /** Device ID (if special file) */
+    rdev;
+    /** File size in bytes */
+    size;
+    /** Block size */
+    blksize;
+    /** Number of blocks */
+    blocks;
+    /** Access time in ms */
+    atimeMs;
+    /** Modification time in ms */
+    mtimeMs;
+    /** Change time (metadata) in ms */
+    ctimeMs;
+    /** Birth time (creation) in ms */
+    birthtimeMs;
+    constructor(init) {
+        this.dev = init.dev;
+        this.ino = init.ino;
+        this.mode = init.mode;
+        this.nlink = init.nlink;
+        this.uid = init.uid;
+        this.gid = init.gid;
+        this.rdev = init.rdev;
+        this.size = init.size;
+        this.blksize = init.blksize;
+        this.blocks = init.blocks;
+        this.atimeMs = init.atimeMs;
+        this.mtimeMs = init.mtimeMs;
+        this.ctimeMs = init.ctimeMs;
+        this.birthtimeMs = init.birthtimeMs;
+    }
+    /** Access time */
+    get atime() {
+        return new Date(this.atimeMs);
+    }
+    /** Modification time */
+    get mtime() {
+        return new Date(this.mtimeMs);
+    }
+    /** Change time (metadata) */
+    get ctime() {
+        return new Date(this.ctimeMs);
+    }
+    /** Birth time (creation) */
+    get birthtime() {
+        return new Date(this.birthtimeMs);
+    }
+    /** Is regular file */
+    isFile() {
+        return (this.mode & constants.S_IFMT) === constants.S_IFREG;
+    }
+    /** Is directory */
+    isDirectory() {
+        return (this.mode & constants.S_IFMT) === constants.S_IFDIR;
+    }
+    /** Is symbolic link */
+    isSymbolicLink() {
+        return (this.mode & constants.S_IFMT) === constants.S_IFLNK;
+    }
+    /** Is block device */
+    isBlockDevice() {
+        return (this.mode & constants.S_IFMT) === constants.S_IFBLK;
+    }
+    /** Is character device */
+    isCharacterDevice() {
+        return (this.mode & constants.S_IFMT) === constants.S_IFCHR;
+    }
+    /** Is FIFO (named pipe) */
+    isFIFO() {
+        return (this.mode & constants.S_IFMT) === constants.S_IFIFO;
+    }
+    /** Is socket */
+    isSocket() {
+        return (this.mode & constants.S_IFMT) === constants.S_IFSOCK;
+    }
+}
+/**
+ * Directory entry class
+ */
+export class Dirent {
+    /** Entry name */
+    name;
+    /** Parent path */
+    parentPath;
+    /** Entry type */
+    _type;
+    constructor(name, parentPath, type) {
+        this.name = name;
+        this.parentPath = parentPath;
+        this._type = type;
+    }
+    /** Full path */
+    get path() {
+        if (this.parentPath.endsWith('/')) {
+            return this.parentPath + this.name;
+        }
+        return this.parentPath + '/' + this.name;
+    }
+    /** Is regular file */
+    isFile() {
+        return this._type === 'file';
+    }
+    /** Is directory */
+    isDirectory() {
+        return this._type === 'directory';
+    }
+    /** Is symbolic link */
+    isSymbolicLink() {
+        return this._type === 'symlink';
+    }
+    /** Is block device */
+    isBlockDevice() {
+        return this._type === 'block';
+    }
+    /** Is character device */
+    isCharacterDevice() {
+        return this._type === 'character';
+    }
+    /** Is FIFO */
+    isFIFO() {
+        return this._type === 'fifo';
+    }
+    /** Is socket */
+    isSocket() {
+        return this._type === 'socket';
+    }
+}
+/**
+ * File handle for open files
+ */
+export class FileHandle {
+    /** File descriptor */
+    fd;
+    /** Internal data buffer */
+    _data;
+    /** Internal stats */
+    _stats;
+    /** Whether the handle is closed */
+    _closed = false;
+    constructor(fd, data, stats) {
+        this.fd = fd;
+        this._data = data;
+        this._stats = stats;
+    }
+    _ensureOpen() {
+        if (this._closed) {
+            throw new Error('File handle is closed');
+        }
+    }
+    /** Read from file */
+    async read(buffer, offset = 0, length, position = 0) {
+        this._ensureOpen();
+        const readLength = length ?? this._data.length - position;
+        const actualLength = Math.min(readLength, this._data.length - position);
+        const bytesToRead = Math.min(actualLength, buffer.length - offset);
+        for (let i = 0; i < bytesToRead; i++) {
+            buffer[offset + i] = this._data[position + i];
+        }
+        return { bytesRead: bytesToRead, buffer };
+    }
+    /** Write to file */
+    async write(data, position) {
+        this._ensureOpen();
+        const bytes = typeof data === 'string' ? new TextEncoder().encode(data) : data;
+        const pos = position ?? this._data.length;
+        // Expand data array if needed
+        if (pos + bytes.length > this._data.length) {
+            const newData = new Uint8Array(pos + bytes.length);
+            newData.set(this._data);
+            this._data = newData;
+        }
+        // Write the data
+        for (let i = 0; i < bytes.length; i++) {
+            this._data[pos + i] = bytes[i];
+        }
+        // Note: stats size update will be reflected in stat() via this._data.length
+        // No need to update _stats here since stat() reads directly from _data.length
+        return { bytesWritten: bytes.length };
+    }
+    /** Get file stats */
+    async stat() {
+        this._ensureOpen();
+        // Return current stats with updated size
+        return new Stats({
+            dev: this._stats.dev,
+            ino: this._stats.ino,
+            mode: this._stats.mode,
+            nlink: this._stats.nlink,
+            uid: this._stats.uid,
+            gid: this._stats.gid,
+            rdev: this._stats.rdev,
+            size: this._data.length,
+            blksize: this._stats.blksize,
+            blocks: Math.ceil(this._data.length / this._stats.blksize),
+            atimeMs: this._stats.atime.getTime(),
+            mtimeMs: this._stats.mtime.getTime(),
+            ctimeMs: this._stats.ctime.getTime(),
+            birthtimeMs: this._stats.birthtime.getTime(),
+        });
+    }
+    /** Truncate file */
+    async truncate(length = 0) {
+        this._ensureOpen();
+        if (length < this._data.length) {
+            this._data = this._data.slice(0, length);
+        }
+        else if (length > this._data.length) {
+            const newData = new Uint8Array(length);
+            newData.set(this._data);
+            this._data = newData;
+        }
+        // Create a new stats object preserving the atime/mtime/ctime/birthtime getters
+        const oldStats = this._stats;
+        this._stats = {
+            dev: oldStats.dev,
+            ino: oldStats.ino,
+            mode: oldStats.mode,
+            nlink: oldStats.nlink,
+            uid: oldStats.uid,
+            gid: oldStats.gid,
+            rdev: oldStats.rdev,
+            size: this._data.length,
+            blksize: oldStats.blksize,
+            blocks: Math.ceil(this._data.length / oldStats.blksize),
+            atime: oldStats.atime,
+            mtime: oldStats.mtime,
+            ctime: oldStats.ctime,
+            birthtime: oldStats.birthtime,
+            isFile: () => oldStats.isFile(),
+            isDirectory: () => oldStats.isDirectory(),
+            isSymbolicLink: () => oldStats.isSymbolicLink(),
+            isBlockDevice: () => oldStats.isBlockDevice(),
+            isCharacterDevice: () => oldStats.isCharacterDevice(),
+            isFIFO: () => oldStats.isFIFO(),
+            isSocket: () => oldStats.isSocket(),
+        };
+    }
+    /** Sync to disk */
+    async sync() {
+        this._ensureOpen();
+        // No-op in memory implementation
+    }
+    /** Close file */
+    async close() {
+        this._closed = true;
+    }
+    /** Create readable stream */
+    createReadStream(options) {
+        this._ensureOpen();
+        const start = options?.start ?? 0;
+        const end = options?.end ?? this._data.length - 1;
+        const data = this._data.slice(start, end + 1);
+        const highWaterMark = options?.highWaterMark ?? 16384;
+        let offset = 0;
+        return new ReadableStream({
+            pull(controller) {
+                if (offset >= data.length) {
+                    controller.close();
+                    return;
+                }
+                const chunk = data.slice(offset, offset + highWaterMark);
+                offset += chunk.length;
+                controller.enqueue(chunk);
+            },
+        });
+    }
+    /** Create writable stream */
+    createWriteStream(options) {
+        this._ensureOpen();
+        let position = options?.start ?? 0;
+        const self = this;
+        return new WritableStream({
+            async write(chunk) {
+                await self.write(chunk, position);
+                position += chunk.length;
+            },
+        });
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/primitives/fsx/core/types.js.map

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

package/dist/sandbox/index.js

@@ -0,0 +1,258 @@
+/**
+ * Cloudflare Sandbox SDK Integration
+ *
+ * This module provides code execution in isolated containers on Cloudflare's edge
+ * using the @cloudflare/sandbox SDK. Each sandbox runs in a VM-backed Durable Object
+ * with full Ubuntu environment.
+ *
+ * @see https://developers.cloudflare.com/sandbox/
+ * @see https://github.com/cloudflare/sandbox-sdk
+ */
+import { getSandbox as getCloudfareSandbox, proxyToSandbox, parseSSEStream, } from '@cloudflare/sandbox';
+// Re-export Sandbox class for wrangler config
+export { Sandbox } from '@cloudflare/sandbox';
+// ============================================================================
+// Sandbox Wrapper Class
+// ============================================================================
+/**
+ * Wrapper around Cloudflare Sandbox providing a simplified API
+ */
+export class DotdoSandbox {
+    sandbox;
+    hostname;
+    constructor(sandbox, hostname) {
+        this.sandbox = sandbox;
+        this.hostname = hostname;
+    }
+    // --------------------------------------------------------------------------
+    // Command Execution
+    // --------------------------------------------------------------------------
+    /**
+     * Execute a shell command and return the result
+     */
+    async exec(command) {
+        return this.sandbox.exec(command);
+    }
+    /**
+     * Execute a command with streaming output
+     */
+    async execStream(command) {
+        const stream = await this.sandbox.execStream(command);
+        return parseSSEStream(stream);
+    }
+    /**
+     * Start a background process (e.g., web server)
+     */
+    async startProcess(command) {
+        await this.sandbox.startProcess(command);
+    }
+    // --------------------------------------------------------------------------
+    // File Operations
+    // --------------------------------------------------------------------------
+    /**
+     * Write content to a file in the sandbox
+     */
+    async writeFile(path, content, options) {
+        await this.sandbox.writeFile(path, content, options);
+    }
+    /**
+     * Read a file from the sandbox
+     */
+    async readFile(path, options) {
+        return this.sandbox.readFile(path, options);
+    }
+    /**
+     * Create a directory (recursive by default)
+     */
+    async mkdir(path, options) {
+        await this.sandbox.mkdir(path, options ?? { recursive: true });
+    }
+    /**
+     * Delete a file
+     */
+    async deleteFile(path) {
+        await this.sandbox.deleteFile(path);
+    }
+    /**
+     * Check if a file or directory exists
+     * Uses readFile to check existence since exists() is not in the Sandbox API
+     */
+    async exists(path) {
+        try {
+            await this.sandbox.readFile(path);
+            return { exists: true };
+        }
+        catch {
+            return { exists: false };
+        }
+    }
+    /**
+     * Rename/move a file
+     */
+    async renameFile(oldPath, newPath) {
+        await this.sandbox.renameFile(oldPath, newPath);
+    }
+    // --------------------------------------------------------------------------
+    // Code Interpreter
+    // --------------------------------------------------------------------------
+    /**
+     * Create a code execution context for interactive coding
+     */
+    async createCodeContext(options) {
+        return this.sandbox.createCodeContext(options);
+    }
+    /**
+     * Execute code in a context
+     */
+    async runCode(code, options) {
+        return this.sandbox.runCode(code, options);
+    }
+    /**
+     * List all code contexts
+     */
+    async listCodeContexts() {
+        return this.sandbox.listCodeContexts();
+    }
+    /**
+     * Delete a code context
+     */
+    async deleteCodeContext(contextId) {
+        await this.sandbox.deleteCodeContext(contextId);
+    }
+    // --------------------------------------------------------------------------
+    // Service Exposure
+    // --------------------------------------------------------------------------
+    /**
+     * Expose a port for external access (preview URLs)
+     */
+    async exposePort(port, options) {
+        const result = await this.sandbox.exposePort(port, {
+            hostname: this.hostname,
+            ...options,
+        });
+        return { port, exposedAt: result.url, name: options?.name };
+    }
+    /**
+     * List all exposed ports
+     */
+    async getExposedPorts() {
+        return this.sandbox.getExposedPorts(this.hostname);
+    }
+    /**
+     * Remove port exposure
+     */
+    async unexposePort(port) {
+        await this.sandbox.unexposePort(port);
+    }
+    // --------------------------------------------------------------------------
+    // Lifecycle
+    // --------------------------------------------------------------------------
+    /**
+     * Destroy the sandbox and release resources
+     */
+    async destroy() {
+        await this.sandbox.destroy();
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+/**
+ * Get or create a sandbox instance by ID
+ *
+ * @example
+ * ```typescript
+ * const sandbox = getSandbox(env.Sandbox, "user-123", request.url)
+ * const result = await sandbox.exec("python --version")
+ * ```
+ */
+export function getSandbox(namespace, sandboxId, hostname, config) {
+    // Note: config options like sleepAfter are set on the Sandbox DO itself
+    // The getSandbox function from @cloudflare/sandbox only takes namespace and id
+    const cfSandbox = getCloudfareSandbox(namespace, sandboxId);
+    return new DotdoSandbox(cfSandbox, hostname);
+}
+/**
+ * Handle preview URL routing for exposed sandbox services
+ *
+ * @example
+ * ```typescript
+ * export default {
+ *   async fetch(request: Request, env: Env) {
+ *     const proxyResponse = await handlePreviewProxy(request, env)
+ *     if (proxyResponse) return proxyResponse
+ *     // ... handle other routes
+ *   }
+ * }
+ * ```
+ */
+export async function handlePreviewProxy(request, env) {
+    return proxyToSandbox(request, env);
+}
+// ============================================================================
+// Convenience Functions
+// ============================================================================
+/**
+ * Execute code in a temporary sandbox and return results
+ * Useful for one-off code execution without managing sandbox lifecycle
+ */
+export async function executeCode(namespace, code, options) {
+    const sandboxId = options.sandboxId ?? `temp-${crypto.randomUUID()}`;
+    const hostname = options.hostname ?? 'localhost';
+    const sandbox = getSandbox(namespace, sandboxId, hostname);
+    try {
+        const context = await sandbox.createCodeContext({
+            language: options.language,
+            timeout: options.timeout ?? 30000,
+        });
+        return await sandbox.runCode(code, {
+            context: context, // Context returned has id, language, cwd, createdAt, lastUsed
+            language: options.language,
+            timeout: options.timeout
+        });
+    }
+    finally {
+        // Cleanup temp sandboxes
+        if (!options.sandboxId) {
+            await sandbox.destroy();
+        }
+    }
+}
+/**
+ * Execute a shell command in a temporary sandbox
+ */
+export async function executeCommand(namespace, command, options) {
+    const sandboxId = options?.sandboxId ?? `temp-${crypto.randomUUID()}`;
+    const hostname = options?.hostname ?? 'localhost';
+    const sandbox = getSandbox(namespace, sandboxId, hostname);
+    try {
+        return await sandbox.exec(command);
+    }
+    finally {
+        if (!options?.sandboxId) {
+            await sandbox.destroy();
+        }
+    }
+}
+// ============================================================================
+// Naming Patterns
+// ============================================================================
+/**
+ * Generate a sandbox ID for per-user persistent sessions
+ */
+export function userSandboxId(userId) {
+    return `user-${userId}`;
+}
+/**
+ * Generate a sandbox ID for ephemeral sessions
+ */
+export function sessionSandboxId() {
+    return `session-${crypto.randomUUID()}`;
+}
+/**
+ * Generate a sandbox ID for idempotent task execution
+ */
+export function taskSandboxId(taskId) {
+    return `task-${taskId}`;
+}
+//# sourceMappingURL=index.js.map

package/dist/sandbox/index.js.map

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

package/dist/sdk/capnweb-compat.js

@@ -0,0 +1,42 @@
+/**
+ * Cap'n Web compatibility layer
+ *
+ * This module provides typed wrappers around capnweb functions.
+ * We use a minimal type interface to avoid TypeScript's deep type
+ * instantiation issues with capnweb's recursive generic types.
+ *
+ * The capnweb library is imported at runtime, but we define our own
+ * simplified types to prevent TypeScript from analyzing the full
+ * recursive type definitions.
+ *
+ * @internal
+ */
+// Import capnweb with type assertion to avoid deep type analysis.
+// We use require() here because:
+// 1. It prevents TypeScript from analyzing capnweb's recursive generic types
+// 2. Bundlers (esbuild, webpack, vite) transform this for browser/Worker environments
+// 3. Node.js supports require() natively
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const capnweb = require('capnweb');
+/**
+ * Create a WebSocket RPC session
+ *
+ * @param url - WebSocket URL (wss:// or ws://)
+ * @param localMain - Optional local object to expose to the remote
+ * @param options - Session options
+ * @returns RPC stub for the remote object
+ */
+export function newWebSocketRpcSession(url, localMain, options) {
+    return capnweb.newWebSocketRpcSession(url, localMain, options);
+}
+/**
+ * Create an HTTP batch RPC session
+ *
+ * @param url - HTTP URL for batch RPC endpoint
+ * @param options - Session options
+ * @returns RPC stub for the remote object
+ */
+export function newHttpBatchRpcSession(url, options) {
+    return capnweb.newHttpBatchRpcSession(url, options);
+}
+//# sourceMappingURL=capnweb-compat.js.map

package/dist/sdk/capnweb-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capnweb-compat.js","sourceRoot":"","sources":["../../sdk/capnweb-compat.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAkBH,kEAAkE;AAClE,iCAAiC;AACjC,6EAA6E;AAC7E,sFAAsF;AACtF,yCAAyC;AACzC,iEAAiE;AACjE,MAAM,OAAO,GAAkB,OAAO,CAAC,SAAS,CAAkB,CAAA;AAElE;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,GAAW,EACX,SAAmB,EACnB,OAAwB;IAExB,OAAO,OAAO,CAAC,sBAAsB,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAA;AAChE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,OAAwB;IAC1E,OAAO,OAAO,CAAC,sBAAsB,CAAC,GAAG,EAAE,OAAO,CAAC,CAAA;AACrD,CAAC"}

package/dist/sdk/client.js

@@ -0,0 +1,20 @@
+/**
+ * dotdo Client SDK - Cap'n Web RPC Client
+ *
+ * This module re-exports from @dotdo/client for backwards compatibility.
+ * The canonical implementation is now in packages/client.
+ *
+ * @deprecated Import from '@dotdo/client' instead of 'dotdo/sdk/client'
+ * @module sdk/client
+ */
+// Re-export everything from @dotdo/client
+export { 
+// Main exports
+$, $Context, configure, 
+// Session management
+disposeSession, disposeAllSessions, 
+// Legacy exports for backwards compatibility
+createClient, } from '@dotdo/client';
+// Default export
+export { default } from '@dotdo/client';
+//# sourceMappingURL=client.js.map

package/dist/sdk/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../sdk/client.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,0CAA0C;AAC1C,OAAO;AACL,eAAe;AACf,CAAC,EACD,QAAQ,EACR,SAAS;AACT,qBAAqB;AACrB,cAAc,EACd,kBAAkB;AAClB,6CAA6C;AAC7C,YAAY,GAeb,MAAM,eAAe,CAAA;AAEtB,iBAAiB;AACjB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA"}

package/dist/sdk/index.js

@@ -0,0 +1,17 @@
+/**
+ * SDK - Client SDKs for dotdo
+ *
+ * Cap'n Web RPC client with WebSocket-first + HTTP batch fallback.
+ * Provides automatic promise pipelining for optimal performance.
+ *
+ * @deprecated Import from '@dotdo/client' instead
+ * @module sdk
+ */
+export { 
+// Main exports
+$, $Context, configure, 
+// Session management
+disposeSession, disposeAllSessions, 
+// Legacy exports for backwards compatibility
+createClient, } from '@dotdo/client';
+//# sourceMappingURL=index.js.map

package/dist/sdk/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../sdk/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO;AACL,eAAe;AACf,CAAC,EACD,QAAQ,EACR,SAAS;AACT,qBAAqB;AACrB,cAAc,EACd,kBAAkB;AAClB,6CAA6C;AAC7C,YAAY,GAUb,MAAM,eAAe,CAAA"}