mongo.do 0.1.0

package/dist/types/objectid.js

@@ -0,0 +1,314 @@
+/**
+ * ObjectId - MongoDB-compatible 12-byte unique identifier
+ *
+ * Structure (12 bytes = 24 hex characters):
+ * - 4 bytes: Unix timestamp (seconds since epoch)
+ * - 5 bytes: Random value (generated once per process)
+ * - 3 bytes: Incrementing counter (initialized to random value)
+ *
+ * Compatible with MongoDB BSON ObjectId specification.
+ */
+// Pre-computed hex lookup table for fast byte-to-hex conversion
+const HEX_LOOKUP = Array.from({ length: 256 }, (_, i) => i.toString(16).padStart(2, '0'));
+// Pre-computed hex char to nibble map for fast hex-to-byte conversion
+const HEX_CHAR_TO_NIBBLE = {};
+for (let i = 0; i < 16; i++) {
+    const hex = i.toString(16);
+    HEX_CHAR_TO_NIBBLE[hex] = i;
+    HEX_CHAR_TO_NIBBLE[hex.toUpperCase()] = i;
+}
+// Regex pattern for validation (compiled once)
+const OBJECTID_PATTERN = /^[0-9a-fA-F]{24}$/;
+/**
+ * Process-level state for ObjectId generation
+ */
+class ObjectIdState {
+    randomBytes = null;
+    counter;
+    constructor() {
+        // Initialize counter to random value
+        this.counter = Math.floor(Math.random() * 0xffffff);
+    }
+    getRandomBytes() {
+        if (!this.randomBytes) {
+            this.randomBytes = new Uint8Array(5);
+            if (typeof crypto !== 'undefined' && crypto.getRandomValues) {
+                crypto.getRandomValues(this.randomBytes);
+            }
+            else {
+                // Fallback for environments without Web Crypto API
+                for (let i = 0; i < 5; i++) {
+                    this.randomBytes[i] = Math.floor(Math.random() * 256);
+                }
+            }
+        }
+        return this.randomBytes;
+    }
+    getNextCounter() {
+        const value = this.counter;
+        this.counter = (this.counter + 1) & 0xffffff; // Wrap at 24 bits
+        return value;
+    }
+}
+// Singleton state instance
+const state = new ObjectIdState();
+/**
+ * Fast bytes to hex conversion using lookup table
+ */
+function bytesToHex(bytes) {
+    let result = '';
+    for (let i = 0; i < bytes.length; i++) {
+        result += HEX_LOOKUP[bytes[i]];
+    }
+    return result;
+}
+/**
+ * Fast hex to bytes conversion using nibble map
+ */
+function hexToBytes(hex) {
+    const len = hex.length >> 1;
+    const bytes = new Uint8Array(len);
+    for (let i = 0; i < len; i++) {
+        const hi = HEX_CHAR_TO_NIBBLE[hex[i * 2]];
+        const lo = HEX_CHAR_TO_NIBBLE[hex[i * 2 + 1]];
+        bytes[i] = (hi << 4) | lo;
+    }
+    return bytes;
+}
+/**
+ * Write a 32-bit integer as 4 big-endian bytes
+ */
+function writeUInt32BE(buffer, value, offset) {
+    buffer[offset] = (value >>> 24) & 0xff;
+    buffer[offset + 1] = (value >>> 16) & 0xff;
+    buffer[offset + 2] = (value >>> 8) & 0xff;
+    buffer[offset + 3] = value & 0xff;
+}
+/**
+ * Read 4 big-endian bytes as a 32-bit unsigned integer
+ */
+function readUInt32BE(buffer, offset) {
+    return (((buffer[offset] << 24) |
+        (buffer[offset + 1] << 16) |
+        (buffer[offset + 2] << 8) |
+        buffer[offset + 3]) >>>
+        0);
+}
+/**
+ * ObjectId class - MongoDB-compatible unique identifier
+ *
+ * @example
+ * ```typescript
+ * // Generate new ObjectId
+ * const id = new ObjectId()
+ *
+ * // Create from hex string
+ * const id2 = ObjectId.createFromHexString('507f1f77bcf86cd799439011')
+ *
+ * // Get timestamp
+ * const timestamp = id.getTimestamp()
+ *
+ * // Compare ObjectIds
+ * id.equals(id2) // false
+ * ```
+ */
+export class ObjectId {
+    /** BSON type identifier for serialization compatibility */
+    _bsontype = 'ObjectId';
+    /** The raw 12-byte buffer containing the ObjectId data */
+    id;
+    /** Cached hex string representation (computed lazily) */
+    _hexString = null;
+    /**
+     * Create a new ObjectId
+     *
+     * @param input - Optional: hex string, Uint8Array, or another ObjectId.
+     *                If omitted, generates a new unique ObjectId.
+     * @throws {TypeError} If input is invalid
+     */
+    constructor(input) {
+        if (input === undefined || input === null) {
+            this.id = this.generate();
+        }
+        else if (typeof input === 'string') {
+            if (!ObjectId.isValidHex(input)) {
+                throw new TypeError(`Invalid ObjectId hex string: "${input}". Must be 24 hex characters.`);
+            }
+            this.id = hexToBytes(input.toLowerCase());
+            this._hexString = input.toLowerCase();
+        }
+        else if (input instanceof Uint8Array) {
+            if (input.length !== 12) {
+                throw new TypeError(`ObjectId buffer must be exactly 12 bytes, received ${input.length}`);
+            }
+            this.id = new Uint8Array(input);
+        }
+        else if (input instanceof ObjectId) {
+            this.id = new Uint8Array(input.id);
+            this._hexString = input._hexString;
+        }
+        else {
+            throw new TypeError(`Invalid ObjectId input type. Expected string, Uint8Array, or ObjectId.`);
+        }
+    }
+    /**
+     * Generate a new 12-byte ObjectId buffer
+     * Structure: 4-byte timestamp | 5-byte random | 3-byte counter
+     */
+    generate() {
+        const buffer = new Uint8Array(12);
+        // 4 bytes: Unix timestamp in seconds (big-endian)
+        const timestamp = Math.floor(Date.now() / 1000);
+        writeUInt32BE(buffer, timestamp, 0);
+        // 5 bytes: Random value (cached per process)
+        const randomBytes = state.getRandomBytes();
+        buffer.set(randomBytes, 4);
+        // 3 bytes: Incrementing counter (big-endian, 24-bit)
+        const counterValue = state.getNextCounter();
+        buffer[9] = (counterValue >>> 16) & 0xff;
+        buffer[10] = (counterValue >>> 8) & 0xff;
+        buffer[11] = counterValue & 0xff;
+        return buffer;
+    }
+    /**
+     * Get the timestamp component of this ObjectId as a Date
+     *
+     * @returns Date object representing when this ObjectId was generated
+     */
+    getTimestamp() {
+        const seconds = readUInt32BE(this.id, 0);
+        return new Date(seconds * 1000);
+    }
+    /**
+     * Get the generation time as Unix timestamp (seconds)
+     */
+    getGenerationTime() {
+        return readUInt32BE(this.id, 0);
+    }
+    /**
+     * Return the ObjectId as a 24-character lowercase hex string
+     */
+    toHexString() {
+        if (!this._hexString) {
+            this._hexString = bytesToHex(this.id);
+        }
+        return this._hexString;
+    }
+    /**
+     * String representation of the ObjectId (same as toHexString)
+     */
+    toString() {
+        return this.toHexString();
+    }
+    /**
+     * JSON serialization - returns hex string
+     * This allows ObjectIds to serialize naturally in JSON.stringify()
+     */
+    toJSON() {
+        return this.toHexString();
+    }
+    /**
+     * Compare this ObjectId to another value for equality
+     *
+     * @param other - ObjectId, hex string, or null/undefined to compare
+     * @returns true if the ObjectIds are equal, false otherwise
+     */
+    equals(other) {
+        if (other === null || other === undefined) {
+            return false;
+        }
+        if (other instanceof ObjectId) {
+            // Fast path: compare bytes directly if hex strings are cached
+            if (this._hexString && other._hexString) {
+                return this._hexString === other._hexString;
+            }
+            // Compare bytes
+            for (let i = 0; i < 12; i++) {
+                if (this.id[i] !== other.id[i]) {
+                    return false;
+                }
+            }
+            return true;
+        }
+        // Compare with string
+        return this.toHexString() === other.toLowerCase();
+    }
+    /**
+     * Primitive value conversion (returns hex string)
+     */
+    valueOf() {
+        return this.toHexString();
+    }
+    /**
+     * Symbol.toStringTag for better debugging output
+     */
+    get [Symbol.toStringTag]() {
+        return 'ObjectId';
+    }
+    /**
+     * Create custom inspect output for Node.js console
+     */
+    [Symbol.for('nodejs.util.inspect.custom')]() {
+        return `ObjectId("${this.toHexString()}")`;
+    }
+    // ─────────────────────────────────────────────────────────────────────────
+    // Static Methods
+    // ─────────────────────────────────────────────────────────────────────────
+    /**
+     * Create an ObjectId from a 24-character hex string
+     *
+     * @param hexString - 24-character hex string
+     * @returns New ObjectId instance
+     * @throws {TypeError} If hexString is invalid
+     */
+    static createFromHexString(hexString) {
+        if (!ObjectId.isValidHex(hexString)) {
+            throw new TypeError(`Invalid ObjectId hex string: "${hexString}". Must be 24 hex characters.`);
+        }
+        return new ObjectId(hexString);
+    }
+    /**
+     * Create an ObjectId with a specific timestamp
+     * Useful for range queries on _id fields
+     *
+     * @param time - Unix timestamp in seconds
+     * @returns New ObjectId with the given timestamp and zeroed remaining bytes
+     */
+    static createFromTime(time) {
+        const buffer = new Uint8Array(12);
+        writeUInt32BE(buffer, time, 0);
+        // Remaining 8 bytes are already zero from Uint8Array initialization
+        return new ObjectId(buffer);
+    }
+    /**
+     * Generate a new ObjectId (factory method, equivalent to new ObjectId())
+     *
+     * @returns New unique ObjectId instance
+     */
+    static generate() {
+        return new ObjectId();
+    }
+    /**
+     * Check if a value is a valid ObjectId or ObjectId hex string
+     *
+     * @param value - Value to check
+     * @returns true if valid ObjectId or 24-char hex string
+     */
+    static isValid(value) {
+        if (value instanceof ObjectId) {
+            return true;
+        }
+        if (typeof value === 'string') {
+            return ObjectId.isValidHex(value);
+        }
+        return false;
+    }
+    /**
+     * Check if a string is a valid 24-character hex string
+     */
+    static isValidHex(str) {
+        return (typeof str === 'string' && str.length === 24 && OBJECTID_PATTERN.test(str));
+    }
+}
+export default ObjectId;
+//# sourceMappingURL=objectid.js.map

package/dist/types/objectid.js.map

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

package/dist/types/rpc.d.ts

@@ -0,0 +1,313 @@
+/**
+ * Consolidated RPC Types
+ *
+ * This module contains all shared RPC-related type definitions used across:
+ * - src/rpc/rpc-target.ts
+ * - src/rpc/rpc-client.ts
+ * - src/rpc/endpoint.ts
+ * - src/rpc/index.ts
+ * - src/wire/backend/workers-proxy.ts
+ */
+/**
+ * Durable Object namespace interface
+ */
+export interface DurableObjectNamespace {
+    idFromName(name: string): DurableObjectId;
+    get(id: DurableObjectId): DurableObjectStub;
+}
+/**
+ * Durable Object ID interface
+ */
+export interface DurableObjectId {
+    toString(): string;
+}
+/**
+ * Durable Object stub interface
+ */
+export interface DurableObjectStub {
+    fetch(request: Request | string, init?: RequestInit): Promise<Response>;
+}
+/**
+ * Base Mondo environment bindings interface
+ */
+export interface MondoEnv {
+    MONDO_DATABASE: DurableObjectNamespace;
+    /** Optional Worker Loader for $function support (closed beta) */
+    LOADER?: WorkerLoader;
+    /** Optional auth token for RPC endpoint */
+    MONDO_AUTH_TOKEN?: string;
+}
+/**
+ * Worker Loader interface for dynamic worker creation
+ * (Closed beta feature for $function operator support)
+ */
+export interface WorkerLoader {
+    get(id: string, getCode: () => Promise<WorkerCode>): WorkerStub;
+}
+/**
+ * Worker code specification for dynamic workers
+ */
+export interface WorkerCode {
+    compatibilityDate: string;
+    compatibilityFlags?: string[];
+    mainModule: string;
+    modules: Record<string, string | {
+        js: string;
+    } | {
+        text: string;
+    }>;
+    globalOutbound?: null;
+    env?: Record<string, unknown>;
+}
+/**
+ * Worker stub interface for dynamic workers
+ */
+export interface WorkerStub {
+    fetch?(request: Request): Promise<Response>;
+    getEntrypoint?(name?: string): WorkerEntrypoint;
+}
+/**
+ * Worker entrypoint interface
+ */
+export interface WorkerEntrypoint {
+    fetch(request: Request): Promise<Response>;
+}
+/**
+ * RPC request structure for Workers RPC (capnweb-style)
+ * Used by rpc-target.ts and rpc-client.ts
+ */
+export interface RpcRequest {
+    id?: string;
+    method: string;
+    params: unknown[];
+}
+/**
+ * RPC response structure for Workers RPC
+ */
+export interface RpcResponse {
+    id?: string;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Batch response structure
+ */
+export interface BatchResponse {
+    results: RpcResponse[];
+}
+/**
+ * RPC request structure for HTTP endpoint
+ * Used by endpoint.ts and workers-proxy.ts
+ */
+export interface HttpRpcRequest {
+    method: string;
+    db?: string;
+    collection?: string;
+    filter?: Record<string, unknown>;
+    update?: Record<string, unknown>;
+    document?: Record<string, unknown>;
+    documents?: Record<string, unknown>[];
+    pipeline?: Record<string, unknown>[];
+    options?: Record<string, unknown>;
+    field?: string;
+    query?: Record<string, unknown>;
+}
+/**
+ * HTTP RPC success response
+ */
+export interface HttpRpcSuccessResponse {
+    ok: 1;
+    result: unknown;
+}
+/**
+ * HTTP RPC error response
+ */
+export interface HttpRpcErrorResponse {
+    ok: 0;
+    error: string;
+    code: number;
+    codeName?: string;
+}
+/**
+ * HTTP RPC response (union type)
+ */
+export type HttpRpcResponse = HttpRpcSuccessResponse | HttpRpcErrorResponse;
+/**
+ * RPC message types for internal operations
+ */
+export declare enum MessageType {
+    INSERT_ONE = "insertOne",
+    INSERT_MANY = "insertMany",
+    FIND_ONE = "findOne",
+    FIND = "find",
+    UPDATE_ONE = "updateOne",
+    UPDATE_MANY = "updateMany",
+    DELETE_ONE = "deleteOne",
+    DELETE_MANY = "deleteMany",
+    AGGREGATE = "aggregate",
+    COUNT = "count",
+    DISTINCT = "distinct",
+    CREATE_INDEX = "createIndex",
+    DROP_INDEX = "dropIndex",
+    LIST_INDEXES = "listIndexes",
+    CREATE_COLLECTION = "createCollection",
+    DROP_COLLECTION = "dropCollection",
+    LIST_COLLECTIONS = "listCollections",
+    STATS = "stats",
+    HEALTH = "health"
+}
+/**
+ * Legacy RPC request interface (message-based)
+ */
+export interface LegacyRpcRequest {
+    type: MessageType;
+    collection?: string;
+    payload: unknown;
+}
+/**
+ * Legacy RPC response interface
+ */
+export interface LegacyRpcResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Database reference returned by db() method
+ */
+export interface DatabaseRef {
+    name: string;
+    stub: DurableObjectStub;
+}
+/**
+ * Collection reference returned by collection() method
+ */
+export interface CollectionRef {
+    dbName: string;
+    collectionName: string;
+    stub: DurableObjectStub;
+}
+/**
+ * Batched executor options
+ */
+export interface BatchedExecutorOptions {
+    maxBatchSize?: number;
+    flushInterval?: number;
+}
+/**
+ * Pipelined operation reference
+ */
+export interface PipelineOp {
+    id: string;
+    method: string;
+    params: unknown[];
+    dependencies: string[];
+}
+/**
+ * RPC client options
+ */
+export interface RpcClientOptions {
+    /** Enable automatic reconnection */
+    autoReconnect?: boolean;
+    /** Maximum retry attempts */
+    maxRetries?: number;
+    /** Reconnect interval in milliseconds */
+    reconnectInterval?: number;
+    /** Enable request deduplication */
+    deduplicate?: boolean;
+    /** Deduplication TTL in milliseconds */
+    deduplicationTtl?: number;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+/**
+ * Options for request deduplicator
+ */
+export interface DeduplicatorOptions {
+    ttl?: number;
+}
+/**
+ * Event handler type
+ */
+export type EventHandler<T = unknown> = (event: T) => void;
+/**
+ * Reconnect event data
+ */
+export interface ReconnectEvent {
+    attempt: number;
+    lastError?: Error;
+}
+/**
+ * RPC Handler interface
+ */
+export interface RpcHandler {
+    fetch(request: Request): Promise<Response>;
+}
+/**
+ * MongoDB-compatible error codes
+ */
+export declare const ErrorCode: {
+    readonly OK: 0;
+    readonly INTERNAL_ERROR: 1;
+    readonly BAD_VALUE: 2;
+    readonly NO_SUCH_KEY: 4;
+    readonly GRAPH_CONTAINS_CYCLE: 5;
+    readonly HOST_UNREACHABLE: 6;
+    readonly HOST_NOT_FOUND: 7;
+    readonly UNKNOWN_ERROR: 8;
+    readonly FAILED_TO_PARSE: 9;
+    readonly CANNOT_MUTATE_OBJECT: 10;
+    readonly USER_NOT_FOUND: 11;
+    readonly UNSUPPORTED_FORMAT: 12;
+    readonly UNAUTHORIZED: 13;
+    readonly TYPE_MISMATCH: 14;
+    readonly OVERFLOW: 15;
+    readonly INVALID_LENGTH: 16;
+    readonly PROTOCOL_ERROR: 17;
+    readonly AUTHENTICATION_FAILED: 18;
+    readonly CANNOT_REUSE_OBJECT: 19;
+    readonly ILLEGAL_OPERATION: 20;
+    readonly EMPTY_ARRAY_OPERATION: 21;
+    readonly INVALID_BSON: 22;
+    readonly ALREADY_INITIALIZED: 23;
+    readonly LOCK_TIMEOUT: 24;
+    readonly REMOTE_VALIDATION_ERROR: 25;
+    readonly NAMESPACE_NOT_FOUND: 26;
+    readonly INDEX_NOT_FOUND: 27;
+    readonly PATH_NOT_VIABLE: 28;
+    readonly NON_EXISTENT_PATH: 29;
+    readonly INVALID_PATH: 30;
+    readonly ROLE_NOT_FOUND: 31;
+    readonly ROLES_NOT_RELATED: 32;
+    readonly PRIVILEGE_NOT_FOUND: 33;
+    readonly CANNOT_BACKFILL_ARRAY: 34;
+    readonly COMMAND_NOT_FOUND: 59;
+    readonly DATABASE_NOT_FOUND: 60;
+    readonly LOCATION_ERROR: 16755;
+    readonly DUPLICATE_KEY: 11000;
+};
+export type ErrorCodeValue = (typeof ErrorCode)[keyof typeof ErrorCode];
+/**
+ * Get the code name for an error code
+ */
+export declare function getErrorCodeName(code: number): string;
+/**
+ * Create a success response (Document format for wire protocol)
+ */
+export declare function successResponse(data?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Create an error response (Document format for wire protocol)
+ */
+export declare function errorResponse(code: number, errmsg: string, codeName?: string): Record<string, unknown>;
+/**
+ * Create a legacy success response
+ */
+export declare function legacySuccessResponse<T>(data: T): LegacyRpcResponse<T>;
+/**
+ * Create a legacy error response
+ */
+export declare function legacyErrorResponse(code: string, message: string): LegacyRpcResponse<never>;
+//# sourceMappingURL=rpc.d.ts.map

package/dist/types/rpc.d.ts.map

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