mongo.do 0.1.0

package/dist/wire/commands/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/wire/commands/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAA;AACpC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAClD,OAAO,EACL,SAAS,EAGV,MAAM,oBAAoB,CAAA;AAG3B,OAAO,EAAE,SAAS,EAAE,CAAA;AAEpB,mCAAmC;AACnC,MAAM,WAAW,UAAU;IACzB,4BAA4B;IAC5B,OAAO,EAAE,OAAO,CAAA;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,yCAAyC;AACzC,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,EAAE,EAAE,MAAM,CAAA;IACV,oBAAoB;IACpB,YAAY,EAAE,MAAM,CAAA;IACpB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;IAC1C,oEAAoE;IACpE,IAAI,CAAC,EAAE,UAAU,CAAA;IACjB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,eAAe,CAAA;CAC7B;AAED,oCAAoC;AACpC,MAAM,WAAW,aAAa;IAC5B,wBAAwB;IACxB,QAAQ,EAAE,QAAQ,CAAA;IAClB,8EAA8E;IAC9E,iBAAiB,CAAC,EAAE,KAAK,CAAC;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC,CAAA;CACzE;AAED,gCAAgC;AAChC,MAAM,WAAW,cAAc;IAC7B,0BAA0B;IAC1B,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAA;CAC5E;AAED,gCAAgC;AAChC,wBAAgB,eAAe,CAAC,IAAI,GAAE,QAAa,GAAG,QAAQ,CAE7D;AAED,+BAA+B;AAC/B,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,MAAM,GAChB,QAAQ,CAEV"}

package/dist/wire/commands/types.js

@@ -0,0 +1,15 @@
+/**
+ * Command handler types for the wire protocol server
+ */
+import { ErrorCode, successResponse as rpcSuccessResponse, errorResponse as rpcErrorResponse, } from '../../types/rpc.js';
+// Re-export ErrorCode from consolidated types
+export { ErrorCode };
+/** Create a success response */
+export function successResponse(data = {}) {
+    return rpcSuccessResponse(data);
+}
+/** Create an error response */
+export function errorResponse(code, errmsg, codeName) {
+    return rpcErrorResponse(code, errmsg, codeName);
+}
+//# sourceMappingURL=types.js.map

package/dist/wire/commands/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/wire/commands/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EACL,SAAS,EACT,eAAe,IAAI,kBAAkB,EACrC,aAAa,IAAI,gBAAgB,GAClC,MAAM,oBAAoB,CAAA;AAE3B,8CAA8C;AAC9C,OAAO,EAAE,SAAS,EAAE,CAAA;AA0CpB,gCAAgC;AAChC,MAAM,UAAU,eAAe,CAAC,OAAiB,EAAE;IACjD,OAAO,kBAAkB,CAAC,IAAI,CAAa,CAAA;AAC7C,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,aAAa,CAC3B,IAAY,EACZ,MAAc,EACd,QAAiB;IAEjB,OAAO,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAa,CAAA;AAC7D,CAAC"}

package/dist/wire/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Wire Protocol Module
+ *
+ * Exports for the MongoDB wire protocol implementation.
+ */
+export { WireProtocolServer, createServer, type ServerOptions, type TlsOptions } from './server.js';
+export * from './types.js';
+export { parseHeader, serializeHeader, parseOpMsg, parseOpQuery, serializeOpMsg, serializeOpReply, parseMessage, extractCommand, } from './message.js';
+export type { MondoBackend, DatabaseInfo, CollectionInfo, FindOptions, FindResult, InsertResult, UpdateResult, DeleteResult, AggregateResult, CollStats, DbStats, IndexInfo, IndexSpec, CursorState, } from './backend/interface.js';
+export { LocalSQLiteBackend } from './backend/local-sqlite.js';
+export { CommandRouter, type RouterOptions } from './commands/router.js';
+export { ScramAuthenticator, InMemoryCredentialsProvider, createScramCredentials, type StoredCredentials, type CredentialsProvider, } from './auth/scram.js';
+export { requiresAuthentication, UNAUTHENTICATED_COMMANDS } from './commands/auth.js';
+export type { AuthOptions } from './server.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAA;AAGnG,cAAc,YAAY,CAAA;AAG1B,OAAO,EACL,WAAW,EACX,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAA;AAGrB,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,UAAU,EACV,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,eAAe,EACf,SAAS,EACT,OAAO,EACP,SAAS,EACT,SAAS,EACT,WAAW,GACZ,MAAM,wBAAwB,CAAA;AAG/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAG9D,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAGxE,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,EACtB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA;AACrF,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA"}

package/dist/wire/index.js

@@ -0,0 +1,19 @@
+/**
+ * Wire Protocol Module
+ *
+ * Exports for the MongoDB wire protocol implementation.
+ */
+// Server
+export { WireProtocolServer, createServer } from './server.js';
+// Types
+export * from './types.js';
+// Message parsing
+export { parseHeader, serializeHeader, parseOpMsg, parseOpQuery, serializeOpMsg, serializeOpReply, parseMessage, extractCommand, } from './message.js';
+// Local SQLite backend
+export { LocalSQLiteBackend } from './backend/local-sqlite.js';
+// Command router
+export { CommandRouter } from './commands/router.js';
+// Authentication
+export { ScramAuthenticator, InMemoryCredentialsProvider, createScramCredentials, } from './auth/scram.js';
+export { requiresAuthentication, UNAUTHENTICATED_COMMANDS } from './commands/auth.js';
+//# sourceMappingURL=index.js.map

package/dist/wire/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/wire/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,SAAS;AACT,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAuC,MAAM,aAAa,CAAA;AAEnG,QAAQ;AACR,cAAc,YAAY,CAAA;AAE1B,kBAAkB;AAClB,OAAO,EACL,WAAW,EACX,eAAe,EACf,UAAU,EACV,YAAY,EACZ,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,cAAc,GACf,MAAM,cAAc,CAAA;AAoBrB,uBAAuB;AACvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAsB,MAAM,sBAAsB,CAAA;AAExE,iBAAiB;AACjB,OAAO,EACL,kBAAkB,EAClB,2BAA2B,EAC3B,sBAAsB,GAGvB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/wire/message.d.ts

@@ -0,0 +1,49 @@
+/**
+ * MongoDB Wire Protocol Message Parsing and Serialization
+ *
+ * Handles the binary message format including:
+ * - MsgHeader (16 bytes)
+ * - OP_MSG (modern format)
+ * - OP_QUERY (legacy, for handshake)
+ * - OP_REPLY (legacy response)
+ */
+import { Document } from 'bson';
+import { type MsgHeader, type OpMsgMessage, type OpQueryMessage, type Section1 } from './types.js';
+/**
+ * Parse the 16-byte message header
+ */
+export declare function parseHeader(buffer: Buffer): MsgHeader;
+/**
+ * Serialize a message header to buffer
+ */
+export declare function serializeHeader(header: MsgHeader): Buffer;
+/**
+ * Parse OP_MSG message (opcode 2013)
+ */
+export declare function parseOpMsg(buffer: Buffer): OpMsgMessage;
+/**
+ * Parse OP_QUERY message (opcode 2004, legacy)
+ * Still used for initial handshake by some clients
+ */
+export declare function parseOpQuery(buffer: Buffer): OpQueryMessage;
+/**
+ * Serialize an OP_MSG response
+ */
+export declare function serializeOpMsg(requestID: number, responseTo: number, body: Document, additionalSections?: Section1[]): Buffer;
+/**
+ * Serialize an OP_REPLY response (legacy)
+ */
+export declare function serializeOpReply(requestID: number, responseTo: number, documents: Document[], cursorID?: bigint, responseFlags?: number): Buffer;
+/**
+ * Parse any incoming message based on opcode
+ */
+export declare function parseMessage(buffer: Buffer): OpMsgMessage | OpQueryMessage;
+/**
+ * Extract the command document and database from parsed message
+ */
+export declare function extractCommand(message: OpMsgMessage | OpQueryMessage): {
+    db: string;
+    command: Document;
+    documentSequences: Map<string, Document[]>;
+};
+//# sourceMappingURL=message.d.ts.map

package/dist/wire/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../src/wire/message.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAQ,QAAQ,EAAE,MAAM,MAAM,CAAA;AACrC,OAAO,EACL,KAAK,SAAS,EACd,KAAK,YAAY,EACjB,KAAK,cAAc,EAGnB,KAAK,QAAQ,EAId,MAAM,YAAY,CAAA;AAKnB;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAWrD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,GAAG,MAAM,CAOzD;AAuBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAuDvD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAmD3D;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,QAAQ,EACd,kBAAkB,CAAC,EAAE,QAAQ,EAAE,GAC9B,MAAM,CAiER;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,QAAQ,EAAE,EACrB,QAAQ,GAAE,MAAW,EACrB,aAAa,GAAE,MAAU,GACxB,MAAM,CA6CR;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,GAAG,cAAc,CAW1E;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,cAAc,GAAG;IACtE,EAAE,EAAE,MAAM,CAAA;IACV,OAAO,EAAE,QAAQ,CAAA;IACjB,iBAAiB,EAAE,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAA;CAC3C,CA+BA"}

package/dist/wire/message.js

@@ -0,0 +1,299 @@
+/**
+ * MongoDB Wire Protocol Message Parsing and Serialization
+ *
+ * Handles the binary message format including:
+ * - MsgHeader (16 bytes)
+ * - OP_MSG (modern format)
+ * - OP_QUERY (legacy, for handshake)
+ * - OP_REPLY (legacy response)
+ */
+import { BSON } from 'bson';
+import { OpCode, OpMsgFlags, } from './types.js';
+/** Header size in bytes */
+const HEADER_SIZE = 16;
+/**
+ * Parse the 16-byte message header
+ */
+export function parseHeader(buffer) {
+    if (buffer.length < HEADER_SIZE) {
+        throw new Error(`Buffer too small for header: ${buffer.length} < ${HEADER_SIZE}`);
+    }
+    return {
+        messageLength: buffer.readInt32LE(0),
+        requestID: buffer.readInt32LE(4),
+        responseTo: buffer.readInt32LE(8),
+        opCode: buffer.readInt32LE(12),
+    };
+}
+/**
+ * Serialize a message header to buffer
+ */
+export function serializeHeader(header) {
+    const buffer = Buffer.allocUnsafe(HEADER_SIZE);
+    buffer.writeInt32LE(header.messageLength, 0);
+    buffer.writeInt32LE(header.requestID, 4);
+    buffer.writeInt32LE(header.responseTo, 8);
+    buffer.writeInt32LE(header.opCode, 12);
+    return buffer;
+}
+/**
+ * Parse a C-style null-terminated string
+ */
+function parseCString(buffer, offset) {
+    let end = offset;
+    while (end < buffer.length && buffer[end] !== 0) {
+        end++;
+    }
+    const str = buffer.toString('utf8', offset, end);
+    return [str, end + 1]; // +1 to skip the null terminator
+}
+/**
+ * Parse a BSON document from buffer
+ */
+function parseBSONDocument(buffer, offset) {
+    const length = buffer.readInt32LE(offset);
+    const doc = BSON.deserialize(buffer.subarray(offset, offset + length));
+    return [doc, offset + length];
+}
+/**
+ * Parse OP_MSG message (opcode 2013)
+ */
+export function parseOpMsg(buffer) {
+    const header = parseHeader(buffer);
+    if (header.opCode !== OpCode.OP_MSG) {
+        throw new Error(`Expected OP_MSG (${OpCode.OP_MSG}), got ${header.opCode}`);
+    }
+    let offset = HEADER_SIZE;
+    // Flag bits (4 bytes)
+    const flagBits = buffer.readUInt32LE(offset);
+    offset += 4;
+    const hasChecksum = (flagBits & OpMsgFlags.CHECKSUM_PRESENT) !== 0;
+    const messageEnd = hasChecksum ? buffer.length - 4 : buffer.length;
+    // Parse sections
+    const sections = [];
+    while (offset < messageEnd) {
+        const kind = buffer.readUInt8(offset);
+        offset += 1;
+        if (kind === 0) {
+            // Kind 0: Single BSON document
+            const [body, newOffset] = parseBSONDocument(buffer, offset);
+            sections.push({ kind: 0, body });
+            offset = newOffset;
+        }
+        else if (kind === 1) {
+            // Kind 1: Document sequence
+            const sectionSize = buffer.readInt32LE(offset);
+            const sectionEnd = offset + sectionSize;
+            offset += 4;
+            const [identifier, docStart] = parseCString(buffer, offset);
+            offset = docStart;
+            const documents = [];
+            while (offset < sectionEnd) {
+                const [doc, newOffset] = parseBSONDocument(buffer, offset);
+                documents.push(doc);
+                offset = newOffset;
+            }
+            sections.push({ kind: 1, identifier, documents });
+        }
+        else {
+            throw new Error(`Unknown section kind: ${kind}`);
+        }
+    }
+    // Optional checksum
+    if (hasChecksum) {
+        return { header, flagBits, sections, checksum: buffer.readUInt32LE(messageEnd) };
+    }
+    return { header, flagBits, sections };
+}
+/**
+ * Parse OP_QUERY message (opcode 2004, legacy)
+ * Still used for initial handshake by some clients
+ */
+export function parseOpQuery(buffer) {
+    const header = parseHeader(buffer);
+    if (header.opCode !== OpCode.OP_QUERY) {
+        throw new Error(`Expected OP_QUERY (${OpCode.OP_QUERY}), got ${header.opCode}`);
+    }
+    let offset = HEADER_SIZE;
+    // Flags (4 bytes)
+    const flags = buffer.readInt32LE(offset);
+    offset += 4;
+    // Full collection name (cstring)
+    const [fullCollectionName, afterName] = parseCString(buffer, offset);
+    offset = afterName;
+    // Number to skip (4 bytes)
+    const numberToSkip = buffer.readInt32LE(offset);
+    offset += 4;
+    // Number to return (4 bytes)
+    const numberToReturn = buffer.readInt32LE(offset);
+    offset += 4;
+    // Query document
+    const [query, afterQuery] = parseBSONDocument(buffer, offset);
+    offset = afterQuery;
+    // Optional return fields selector
+    if (offset < buffer.length) {
+        const [returnFieldsSelector] = parseBSONDocument(buffer, offset);
+        return {
+            header,
+            flags,
+            fullCollectionName,
+            numberToSkip,
+            numberToReturn,
+            query,
+            returnFieldsSelector,
+        };
+    }
+    return {
+        header,
+        flags,
+        fullCollectionName,
+        numberToSkip,
+        numberToReturn,
+        query,
+    };
+}
+/**
+ * Serialize an OP_MSG response
+ */
+export function serializeOpMsg(requestID, responseTo, body, additionalSections) {
+    // Serialize the body document
+    const bodyBson = Buffer.from(BSON.serialize(body));
+    // Calculate section 0 size
+    let sectionsSize = 1 + bodyBson.length; // kind byte + BSON
+    // Calculate additional sections size
+    const serializedSections = [];
+    if (additionalSections) {
+        for (const section of additionalSections) {
+            const identifierBuf = Buffer.from(section.identifier + '\0', 'utf8');
+            const docsBufs = section.documents.map((doc) => Buffer.from(BSON.serialize(doc)));
+            const docsSize = docsBufs.reduce((sum, buf) => sum + buf.length, 0);
+            const sectionSize = 4 + identifierBuf.length + docsSize; // size + identifier + docs
+            const sectionBuf = Buffer.allocUnsafe(1 + sectionSize); // kind + section
+            sectionBuf.writeUInt8(1, 0); // kind = 1
+            sectionBuf.writeInt32LE(sectionSize, 1);
+            identifierBuf.copy(sectionBuf, 5);
+            let docOffset = 5 + identifierBuf.length;
+            for (const docBuf of docsBufs) {
+                docBuf.copy(sectionBuf, docOffset);
+                docOffset += docBuf.length;
+            }
+            serializedSections.push(sectionBuf);
+            sectionsSize += sectionBuf.length;
+        }
+    }
+    // Total message length
+    const messageLength = HEADER_SIZE + 4 + sectionsSize; // header + flagBits + sections
+    // Allocate buffer
+    const buffer = Buffer.allocUnsafe(messageLength);
+    let offset = 0;
+    // Header
+    buffer.writeInt32LE(messageLength, offset);
+    offset += 4;
+    buffer.writeInt32LE(requestID, offset);
+    offset += 4;
+    buffer.writeInt32LE(responseTo, offset);
+    offset += 4;
+    buffer.writeInt32LE(OpCode.OP_MSG, offset);
+    offset += 4;
+    // Flag bits (no flags set)
+    buffer.writeUInt32LE(0, offset);
+    offset += 4;
+    // Section 0 (body)
+    buffer.writeUInt8(0, offset); // kind = 0
+    offset += 1;
+    bodyBson.copy(buffer, offset);
+    offset += bodyBson.length;
+    // Additional sections
+    for (const sectionBuf of serializedSections) {
+        sectionBuf.copy(buffer, offset);
+        offset += sectionBuf.length;
+    }
+    return buffer;
+}
+/**
+ * Serialize an OP_REPLY response (legacy)
+ */
+export function serializeOpReply(requestID, responseTo, documents, cursorID = 0n, responseFlags = 0) {
+    // Serialize documents
+    const docBuffers = documents.map((doc) => Buffer.from(BSON.serialize(doc)));
+    const docsSize = docBuffers.reduce((sum, buf) => sum + buf.length, 0);
+    // Total message length
+    // header(16) + responseFlags(4) + cursorID(8) + startingFrom(4) + numberReturned(4) + docs
+    const messageLength = HEADER_SIZE + 20 + docsSize;
+    const buffer = Buffer.allocUnsafe(messageLength);
+    let offset = 0;
+    // Header
+    buffer.writeInt32LE(messageLength, offset);
+    offset += 4;
+    buffer.writeInt32LE(requestID, offset);
+    offset += 4;
+    buffer.writeInt32LE(responseTo, offset);
+    offset += 4;
+    buffer.writeInt32LE(OpCode.OP_REPLY, offset);
+    offset += 4;
+    // Response flags
+    buffer.writeInt32LE(responseFlags, offset);
+    offset += 4;
+    // Cursor ID
+    buffer.writeBigInt64LE(cursorID, offset);
+    offset += 8;
+    // Starting from
+    buffer.writeInt32LE(0, offset);
+    offset += 4;
+    // Number returned
+    buffer.writeInt32LE(documents.length, offset);
+    offset += 4;
+    // Documents
+    for (const docBuf of docBuffers) {
+        docBuf.copy(buffer, offset);
+        offset += docBuf.length;
+    }
+    return buffer;
+}
+/**
+ * Parse any incoming message based on opcode
+ */
+export function parseMessage(buffer) {
+    const header = parseHeader(buffer);
+    switch (header.opCode) {
+        case OpCode.OP_MSG:
+            return parseOpMsg(buffer);
+        case OpCode.OP_QUERY:
+            return parseOpQuery(buffer);
+        default:
+            throw new Error(`Unsupported opcode: ${header.opCode}`);
+    }
+}
+/**
+ * Extract the command document and database from parsed message
+ */
+export function extractCommand(message) {
+    if ('sections' in message) {
+        // OP_MSG
+        const section0 = message.sections.find((s) => s.kind === 0);
+        if (!section0) {
+            throw new Error('OP_MSG missing section 0 (body)');
+        }
+        const command = section0.body;
+        const db = command.$db;
+        if (!db) {
+            throw new Error('OP_MSG command missing $db field');
+        }
+        // Collect document sequences from kind=1 sections
+        const documentSequences = new Map();
+        for (const section of message.sections) {
+            if (section.kind === 1) {
+                documentSequences.set(section.identifier, section.documents);
+            }
+        }
+        return { db, command, documentSequences };
+    }
+    else {
+        // OP_QUERY
+        const parts = message.fullCollectionName.split('.');
+        const db = parts[0] || 'admin';
+        const command = message.query;
+        return { db, command, documentSequences: new Map() };
+    }
+}
+//# sourceMappingURL=message.js.map

package/dist/wire/message.js.map

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

package/dist/wire/server.d.ts

@@ -0,0 +1,145 @@
+/**
+ * MongoDB Wire Protocol Server
+ *
+ * TCP server that speaks the MongoDB wire protocol.
+ * Can run locally with Bun for development/Compass support.
+ */
+import type { MondoBackend } from './backend/interface.js';
+/** TLS configuration options for secure connections */
+export interface TlsOptions {
+    /**
+     * Private key in PEM format.
+     * Can be a string path, Buffer, or Bun.file()
+     */
+    key: string | Buffer | ReturnType<typeof Bun.file>;
+    /**
+     * Certificate chain in PEM format.
+     * Can be a string path, Buffer, or Bun.file()
+     */
+    cert: string | Buffer | ReturnType<typeof Bun.file>;
+    /**
+     * Optionally override the trusted CA certificates.
+     * Default is to trust well-known CAs curated by Mozilla.
+     */
+    ca?: string | Buffer | ReturnType<typeof Bun.file> | Array<string | Buffer | ReturnType<typeof Bun.file>>;
+    /**
+     * Passphrase for encrypted private key
+     */
+    passphrase?: string;
+    /**
+     * Request a certificate from clients (mutual TLS)
+     * Default: false
+     */
+    requestCert?: boolean;
+    /**
+     * Reject connections from clients with invalid/untrusted certificates
+     * Only has effect when requestCert is true
+     * Default: true
+     */
+    rejectUnauthorized?: boolean;
+    /**
+     * Minimum TLS version to allow
+     * Default: 'TLSv1.2'
+     */
+    minVersion?: 'TLSv1' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3';
+    /**
+     * Maximum TLS version to allow
+     * Default: 'TLSv1.3'
+     */
+    maxVersion?: 'TLSv1' | 'TLSv1.1' | 'TLSv1.2' | 'TLSv1.3';
+    /**
+     * Server name for SNI (Server Name Indication)
+     */
+    serverName?: string;
+    /**
+     * ALPN protocols to advertise
+     */
+    ALPNProtocols?: string[];
+}
+/** Authentication configuration options */
+export interface AuthOptions {
+    /** Enable authentication (default: false for local development) */
+    enabled: boolean;
+    /** Username for SCRAM-SHA-256 authentication */
+    username: string;
+    /** Password for SCRAM-SHA-256 authentication */
+    password: string;
+}
+/** Server configuration options */
+export interface ServerOptions {
+    /** Port to listen on (default: 27017) */
+    port?: number;
+    /** Host to bind to (default: 'localhost') */
+    host?: string;
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /**
+     * TLS configuration for secure connections.
+     * When provided, the server will use TLS/SSL.
+     * If not provided, the server runs without encryption (for local development).
+     */
+    tls?: TlsOptions;
+    /**
+     * SECURITY: Authentication configuration
+     * When enabled, clients must authenticate before executing most commands
+     */
+    auth?: AuthOptions;
+}
+/**
+ * Wire Protocol Server
+ *
+ * Handles TCP connections and dispatches commands to the router.
+ * SECURITY: Supports optional authentication via SCRAM-SHA-256.
+ */
+export declare class WireProtocolServer {
+    private options;
+    private router;
+    private connections;
+    private nextConnectionId;
+    private nextRequestId;
+    private server;
+    private authenticator;
+    constructor(backend: MondoBackend, options?: ServerOptions);
+    /**
+     * Start the server
+     */
+    start(): Promise<void>;
+    /**
+     * Build TLS configuration object from TlsOptions
+     */
+    private buildTlsConfig;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Process accumulated buffer for complete messages
+     */
+    private processBuffer;
+    /**
+     * Handle a single message
+     */
+    private handleMessage;
+    /**
+     * Get server address info
+     */
+    get address(): {
+        host: string;
+        port: number;
+        tls: boolean;
+    };
+    /**
+     * Check if server is using TLS
+     */
+    get isTls(): boolean;
+    /**
+     * Get the MongoDB connection string for this server
+     * Returns mongodb:// for non-TLS or mongodb+srv:// style for TLS
+     */
+    get connectionString(): string;
+}
+/**
+ * Create and start a wire protocol server
+ */
+export declare function createServer(backend: MondoBackend, options?: ServerOptions): Promise<WireProtocolServer>;
+//# sourceMappingURL=server.d.ts.map

package/dist/wire/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/wire/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAO1D,uDAAuD;AACvD,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAA;IAClD;;;OAGG;IACH,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAA;IACnD;;;OAGG;IACH,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAA;IACzG;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAC5B;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACxD;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAA;IACxD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAA;CACzB;AAED,2CAA2C;AAC3C,MAAM,WAAW,WAAW;IAC1B,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAA;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;IAChB,gDAAgD;IAChD,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;;OAIG;IACH,GAAG,CAAC,EAAE,UAAU,CAAA;IAChB;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAA;CACnB;AAQD;;;;;GAKG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAyB;IACxC,OAAO,CAAC,MAAM,CAAe;IAC7B,OAAO,CAAC,WAAW,CAA0C;IAC7D,OAAO,CAAC,gBAAgB,CAAI;IAC5B,OAAO,CAAC,aAAa,CAAI;IAEzB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,aAAa,CAAkC;gBAE3C,OAAO,EAAE,YAAY,EAAE,OAAO,GAAE,aAAkB;IA8B9D;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAsE5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAmCtB;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;YACW,aAAa;IAoC3B;;OAEG;YACW,aAAa;IA0E3B;;OAEG;IACH,IAAI,OAAO,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,OAAO,CAAA;KAAE,CAM1D;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;OAGG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAI7B;CACF;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,OAAO,EAAE,YAAY,EACrB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,CAI7B"}