@push.rocks/smartdb 1.0.1

package/dist_ts/ts_smartdb/server/SmartdbServer.d.ts

@@ -0,0 +1,102 @@
+import type { IStorageAdapter } from '../storage/IStorageAdapter.js';
+/**
+ * Server configuration options
+ */
+export interface ISmartdbServerOptions {
+    /** Port to listen on (default: 27017) - ignored if socketPath is set */
+    port?: number;
+    /** Host to bind to (default: 127.0.0.1) - ignored if socketPath is set */
+    host?: string;
+    /** Unix socket path - if set, server listens on socket instead of TCP */
+    socketPath?: string;
+    /** Storage type: 'memory' or 'file' (default: 'memory') */
+    storage?: 'memory' | 'file';
+    /** Path for file storage (required if storage is 'file') */
+    storagePath?: string;
+    /** Enable persistence for memory storage */
+    persistPath?: string;
+    /** Persistence interval in ms (default: 60000) */
+    persistIntervalMs?: number;
+}
+/**
+ * SmartdbServer - MongoDB Wire Protocol compatible server
+ *
+ * This server implements the MongoDB wire protocol (OP_MSG) to allow
+ * official MongoDB drivers to connect and perform operations.
+ *
+ * @example
+ * ```typescript
+ * import { SmartdbServer } from '@push.rocks/smartmongo/smartdb';
+ * import { MongoClient } from 'mongodb';
+ *
+ * const server = new SmartdbServer({ port: 27017 });
+ * await server.start();
+ *
+ * const client = new MongoClient('mongodb://127.0.0.1:27017');
+ * await client.connect();
+ * ```
+ */
+export declare class SmartdbServer {
+    private options;
+    private server;
+    private storage;
+    private commandRouter;
+    private connections;
+    private connectionIdCounter;
+    private isRunning;
+    private startTime;
+    private useSocket;
+    constructor(options?: ISmartdbServerOptions);
+    /**
+     * Get the storage adapter (for testing/debugging)
+     */
+    getStorage(): IStorageAdapter;
+    /**
+     * Get server uptime in seconds
+     */
+    getUptime(): number;
+    /**
+     * Get current connection count
+     */
+    getConnectionCount(): number;
+    /**
+     * Start the server
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the server
+     */
+    stop(): Promise<void>;
+    /**
+     * Handle a new client connection
+     */
+    private handleConnection;
+    /**
+     * Handle incoming data from a client
+     */
+    private handleData;
+    /**
+     * Process complete messages from the buffer
+     */
+    private processMessages;
+    /**
+     * Get the connection URI for this server
+     */
+    getConnectionUri(): string;
+    /**
+     * Get the socket path (if using Unix socket mode)
+     */
+    get socketPath(): string | undefined;
+    /**
+     * Check if the server is running
+     */
+    get running(): boolean;
+    /**
+     * Get the port the server is listening on
+     */
+    get port(): number;
+    /**
+     * Get the host the server is bound to
+     */
+    get host(): string;
+}

package/dist_ts/ts_smartdb/server/SmartdbServer.js

@@ -0,0 +1,279 @@
+import * as net from 'net';
+import * as fs from 'fs/promises';
+import * as plugins from '../plugins.js';
+import { WireProtocol, OP_QUERY } from './WireProtocol.js';
+import { CommandRouter } from './CommandRouter.js';
+import { MemoryStorageAdapter } from '../storage/MemoryStorageAdapter.js';
+import { FileStorageAdapter } from '../storage/FileStorageAdapter.js';
+/**
+ * SmartdbServer - MongoDB Wire Protocol compatible server
+ *
+ * This server implements the MongoDB wire protocol (OP_MSG) to allow
+ * official MongoDB drivers to connect and perform operations.
+ *
+ * @example
+ * ```typescript
+ * import { SmartdbServer } from '@push.rocks/smartmongo/smartdb';
+ * import { MongoClient } from 'mongodb';
+ *
+ * const server = new SmartdbServer({ port: 27017 });
+ * await server.start();
+ *
+ * const client = new MongoClient('mongodb://127.0.0.1:27017');
+ * await client.connect();
+ * ```
+ */
+export class SmartdbServer {
+    options;
+    server = null;
+    storage;
+    commandRouter;
+    connections = new Map();
+    connectionIdCounter = 0;
+    isRunning = false;
+    startTime = new Date();
+    useSocket;
+    constructor(options = {}) {
+        this.useSocket = !!options.socketPath;
+        this.options = {
+            port: options.port ?? 27017,
+            host: options.host ?? '127.0.0.1',
+            socketPath: options.socketPath ?? '',
+            storage: options.storage ?? 'memory',
+            storagePath: options.storagePath ?? './data',
+            persistPath: options.persistPath ?? '',
+            persistIntervalMs: options.persistIntervalMs ?? 60000,
+        };
+        // Create storage adapter
+        if (this.options.storage === 'file') {
+            this.storage = new FileStorageAdapter(this.options.storagePath);
+        }
+        else {
+            this.storage = new MemoryStorageAdapter({
+                persistPath: this.options.persistPath || undefined,
+                persistIntervalMs: this.options.persistPath ? this.options.persistIntervalMs : undefined,
+            });
+        }
+        // Create command router
+        this.commandRouter = new CommandRouter(this.storage, this);
+    }
+    /**
+     * Get the storage adapter (for testing/debugging)
+     */
+    getStorage() {
+        return this.storage;
+    }
+    /**
+     * Get server uptime in seconds
+     */
+    getUptime() {
+        return Math.floor((Date.now() - this.startTime.getTime()) / 1000);
+    }
+    /**
+     * Get current connection count
+     */
+    getConnectionCount() {
+        return this.connections.size;
+    }
+    /**
+     * Start the server
+     */
+    async start() {
+        if (this.isRunning) {
+            throw new Error('Server is already running');
+        }
+        // Initialize storage
+        await this.storage.initialize();
+        // Clean up stale socket file if using Unix socket
+        if (this.useSocket && this.options.socketPath) {
+            try {
+                await fs.unlink(this.options.socketPath);
+            }
+            catch (err) {
+                // Ignore ENOENT (file doesn't exist)
+                if (err.code !== 'ENOENT') {
+                    throw err;
+                }
+            }
+        }
+        return new Promise((resolve, reject) => {
+            this.server = net.createServer((socket) => {
+                this.handleConnection(socket);
+            });
+            this.server.on('error', (err) => {
+                if (!this.isRunning) {
+                    reject(err);
+                }
+                else {
+                    console.error('Server error:', err);
+                }
+            });
+            if (this.useSocket && this.options.socketPath) {
+                // Listen on Unix socket
+                this.server.listen(this.options.socketPath, () => {
+                    this.isRunning = true;
+                    this.startTime = new Date();
+                    resolve();
+                });
+            }
+            else {
+                // Listen on TCP
+                this.server.listen(this.options.port, this.options.host, () => {
+                    this.isRunning = true;
+                    this.startTime = new Date();
+                    resolve();
+                });
+            }
+        });
+    }
+    /**
+     * Stop the server
+     */
+    async stop() {
+        if (!this.isRunning || !this.server) {
+            return;
+        }
+        // Close all connections
+        for (const conn of this.connections.values()) {
+            conn.socket.destroy();
+        }
+        this.connections.clear();
+        // Close command router (cleans up session engine, cursors, etc.)
+        this.commandRouter.close();
+        // Close storage
+        await this.storage.close();
+        return new Promise((resolve) => {
+            this.server.close(async () => {
+                this.isRunning = false;
+                this.server = null;
+                // Clean up socket file if using Unix socket
+                if (this.useSocket && this.options.socketPath) {
+                    try {
+                        await fs.unlink(this.options.socketPath);
+                    }
+                    catch (err) {
+                        // Ignore ENOENT (file doesn't exist)
+                        if (err.code !== 'ENOENT') {
+                            console.error('Failed to remove socket file:', err);
+                        }
+                    }
+                }
+                resolve();
+            });
+        });
+    }
+    /**
+     * Handle a new client connection
+     */
+    handleConnection(socket) {
+        const connectionId = ++this.connectionIdCounter;
+        const state = {
+            id: connectionId,
+            socket,
+            buffer: Buffer.alloc(0),
+            authenticated: true, // No auth required for now
+            database: 'test',
+        };
+        this.connections.set(connectionId, state);
+        socket.on('data', (data) => {
+            this.handleData(state, Buffer.isBuffer(data) ? data : Buffer.from(data));
+        });
+        socket.on('close', () => {
+            this.connections.delete(connectionId);
+        });
+        socket.on('error', (err) => {
+            // Connection errors are expected when clients disconnect
+            this.connections.delete(connectionId);
+        });
+    }
+    /**
+     * Handle incoming data from a client
+     */
+    handleData(state, data) {
+        // Append new data to buffer
+        state.buffer = Buffer.concat([state.buffer, data]);
+        // Process messages from buffer
+        this.processMessages(state);
+    }
+    /**
+     * Process complete messages from the buffer
+     */
+    async processMessages(state) {
+        while (state.buffer.length >= 16) {
+            try {
+                const result = WireProtocol.parseMessage(state.buffer);
+                if (!result) {
+                    // Not enough data for a complete message
+                    break;
+                }
+                const { command, bytesConsumed } = result;
+                // Remove processed bytes from buffer
+                state.buffer = state.buffer.subarray(bytesConsumed);
+                // Process the command
+                const response = await this.commandRouter.route(command);
+                // Encode and send response
+                let responseBuffer;
+                if (command.opCode === OP_QUERY) {
+                    // Legacy OP_QUERY gets OP_REPLY response
+                    responseBuffer = WireProtocol.encodeOpReplyResponse(command.requestID, [response]);
+                }
+                else {
+                    // OP_MSG gets OP_MSG response
+                    responseBuffer = WireProtocol.encodeOpMsgResponse(command.requestID, response);
+                }
+                if (!state.socket.destroyed) {
+                    state.socket.write(responseBuffer);
+                }
+            }
+            catch (error) {
+                // Send error response
+                const errorResponse = WireProtocol.encodeErrorResponse(0, // We don't have the requestID at this point
+                1, error.message || 'Internal error');
+                if (!state.socket.destroyed) {
+                    state.socket.write(errorResponse);
+                }
+                // Clear buffer on parse errors to avoid infinite loops
+                if (error.message?.includes('opCode') || error.message?.includes('section')) {
+                    state.buffer = Buffer.alloc(0);
+                }
+                break;
+            }
+        }
+    }
+    /**
+     * Get the connection URI for this server
+     */
+    getConnectionUri() {
+        if (this.useSocket && this.options.socketPath) {
+            // URL-encode the socket path (replace / with %2F)
+            const encodedPath = encodeURIComponent(this.options.socketPath);
+            return `mongodb://${encodedPath}`;
+        }
+        return `mongodb://${this.options.host}:${this.options.port}`;
+    }
+    /**
+     * Get the socket path (if using Unix socket mode)
+     */
+    get socketPath() {
+        return this.useSocket ? this.options.socketPath : undefined;
+    }
+    /**
+     * Check if the server is running
+     */
+    get running() {
+        return this.isRunning;
+    }
+    /**
+     * Get the port the server is listening on
+     */
+    get port() {
+        return this.options.port;
+    }
+    /**
+     * Get the host the server is bound to
+     */
+    get host() {
+        return this.options.host;
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiU21hcnRkYlNlcnZlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3RzL3RzX3NtYXJ0ZGIvc2VydmVyL1NtYXJ0ZGJTZXJ2ZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEdBQUcsTUFBTSxLQUFLLENBQUM7QUFDM0IsT0FBTyxLQUFLLEVBQUUsTUFBTSxhQUFhLENBQUM7QUFDbEMsT0FBTyxLQUFLLE9BQU8sTUFBTSxlQUFlLENBQUM7QUFDekMsT0FBTyxFQUFFLFlBQVksRUFBRSxRQUFRLEVBQUUsTUFBTSxtQkFBbUIsQ0FBQztBQUMzRCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFDbkQsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0sb0NBQW9DLENBQUM7QUFDMUUsT0FBTyxFQUFFLGtCQUFrQixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFrQ3RFOzs7Ozs7Ozs7Ozs7Ozs7OztHQWlCRztBQUNILE1BQU0sT0FBTyxhQUFhO0lBQ2hCLE9BQU8sQ0FBK0U7SUFDdEYsTUFBTSxHQUFzQixJQUFJLENBQUM7SUFDakMsT0FBTyxDQUFrQjtJQUN6QixhQUFhLENBQWdCO0lBQzdCLFdBQVcsR0FBa0MsSUFBSSxHQUFHLEVBQUUsQ0FBQztJQUN2RCxtQkFBbUIsR0FBRyxDQUFDLENBQUM7SUFDeEIsU0FBUyxHQUFHLEtBQUssQ0FBQztJQUNsQixTQUFTLEdBQVMsSUFBSSxJQUFJLEVBQUUsQ0FBQztJQUM3QixTQUFTLENBQVU7SUFFM0IsWUFBWSxVQUFpQyxFQUFFO1FBQzdDLElBQUksQ0FBQyxTQUFTLEdBQUcsQ0FBQyxDQUFDLE9BQU8sQ0FBQyxVQUFVLENBQUM7UUFDdEMsSUFBSSxDQUFDLE9BQU8sR0FBRztZQUNiLElBQUksRUFBRSxPQUFPLENBQUMsSUFBSSxJQUFJLEtBQUs7WUFDM0IsSUFBSSxFQUFFLE9BQU8sQ0FBQyxJQUFJLElBQUksV0FBVztZQUNqQyxVQUFVLEVB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

package/dist_ts/ts_smartdb/server/WireProtocol.d.ts

@@ -0,0 +1,117 @@
+import * as plugins from '../plugins.js';
+/**
+ * MongoDB Wire Protocol Implementation
+ * Handles parsing and encoding of MongoDB wire protocol messages (OP_MSG primarily)
+ *
+ * Wire Protocol Message Format:
+ * - Header (16 bytes): messageLength (4), requestID (4), responseTo (4), opCode (4)
+ * - OP_MSG: flagBits (4), sections[], optional checksum (4)
+ *
+ * References:
+ * - https://www.mongodb.com/docs/manual/reference/mongodb-wire-protocol/
+ */
+export declare const OP_REPLY = 1;
+export declare const OP_UPDATE = 2001;
+export declare const OP_INSERT = 2002;
+export declare const OP_QUERY = 2004;
+export declare const OP_GET_MORE = 2005;
+export declare const OP_DELETE = 2006;
+export declare const OP_KILL_CURSORS = 2007;
+export declare const OP_COMPRESSED = 2012;
+export declare const OP_MSG = 2013;
+export declare const SECTION_BODY = 0;
+export declare const SECTION_DOCUMENT_SEQUENCE = 1;
+export declare const MSG_FLAG_CHECKSUM_PRESENT: number;
+export declare const MSG_FLAG_MORE_TO_COME: number;
+export declare const MSG_FLAG_EXHAUST_ALLOWED: number;
+/**
+ * Parsed message header
+ */
+export interface IMessageHeader {
+    messageLength: number;
+    requestID: number;
+    responseTo: number;
+    opCode: number;
+}
+/**
+ * Parsed OP_MSG message
+ */
+export interface IOpMsgMessage {
+    header: IMessageHeader;
+    flagBits: number;
+    sections: IOpMsgSection[];
+    checksum?: number;
+}
+/**
+ * OP_MSG section (either body or document sequence)
+ */
+export interface IOpMsgSection {
+    type: number;
+    payload: plugins.bson.Document;
+    sequenceIdentifier?: string;
+    documents?: plugins.bson.Document[];
+}
+/**
+ * Parsed OP_QUERY message (legacy, but used for initial handshake)
+ */
+export interface IOpQueryMessage {
+    header: IMessageHeader;
+    flags: number;
+    fullCollectionName: string;
+    numberToSkip: number;
+    numberToReturn: number;
+    query: plugins.bson.Document;
+    returnFieldsSelector?: plugins.bson.Document;
+}
+/**
+ * Parsed command from any message type
+ */
+export interface IParsedCommand {
+    commandName: string;
+    command: plugins.bson.Document;
+    database: string;
+    requestID: number;
+    opCode: number;
+    documentSequences?: Map<string, plugins.bson.Document[]>;
+}
+/**
+ * Wire Protocol parser and encoder
+ */
+export declare class WireProtocol {
+    /**
+     * Parse a complete message from a buffer
+     * Returns the parsed command and the number of bytes consumed
+     */
+    static parseMessage(buffer: Buffer): {
+        command: IParsedCommand;
+        bytesConsumed: number;
+    } | null;
+    /**
+     * Parse message header (16 bytes)
+     */
+    private static parseHeader;
+    /**
+     * Parse OP_MSG message
+     */
+    private static parseOpMsg;
+    /**
+     * Parse OP_QUERY message (legacy, used for initial handshake)
+     */
+    private static parseOpQuery;
+    /**
+     * Encode a response as OP_MSG
+     */
+    static encodeOpMsgResponse(responseTo: number, response: plugins.bson.Document, requestID?: number): Buffer;
+    /**
+     * Encode a response as OP_REPLY (legacy, for OP_QUERY responses)
+     */
+    static encodeOpReplyResponse(responseTo: number, documents: plugins.bson.Document[], requestID?: number, cursorId?: bigint): Buffer;
+    /**
+     * Encode an error response
+     */
+    static encodeErrorResponse(responseTo: number, errorCode: number, errorMessage: string, commandName?: string): Buffer;
+    /**
+     * Get error code name from error code
+     */
+    private static getErrorCodeName;
+}