toridb 1.0.0 → 1.0.1

package/dist/toridb.esm.js

@@ -1,682 +1,669 @@
-import require$$0 from 'net';
+import net from 'net';
 
-function getDefaultExportFromCjs (x) {
-	return x && x.__esModule && Object.prototype.hasOwnProperty.call(x, 'default') ? x['default'] : x;
+/**
+ * Command Compiler: Translates JS Objects and Types to ToriDB DSL
+ */
+class Compiler {
+  /**
+   * Translates a JS Object to a ToriDB Filter string.
+   * { age: { $gt: 18 }, status: 'active' } -> "age > 18 AND status = 'active'"
+   */
+  static compileFilter(filter) {
+    if (!filter || typeof filter !== 'object') return "";
+
+    const parts = [];
+    for (const [key, value] of Object.entries(filter)) {
+      if (key === '$or' && Array.isArray(value)) {
+        parts.push(`(${value.map(f => this.compileFilter(f)).join(" OR ")})`);
+      } else if (key === '$and' && Array.isArray(value)) {
+        parts.push(`(${value.map(f => this.compileFilter(f)).join(" AND ")})`);
+      } else if (typeof value === 'object' && value !== null) {
+        // Handle operators: { $gt: 10 }
+        for (const [op, val] of Object.entries(value)) {
+          const symbol = this._mapOperator(op);
+          parts.push(`${key} ${symbol} ${this._escape(val)}`);
+        }
+      } else {
+        // Basic equality
+        parts.push(`${key} = ${this._escape(value)}`);
+      }
+    }
+    return parts.join(" AND ");
+  }
+
+  /**
+   * Translates a Blueprint definition to ToriDB Table Definition format.
+   * { id: { type: 'INT', primary: true }, user_id: { type: 'INT', references: 'users.id' } }
+   * -> "id:INT:pk user_id:INT:fk(users.id)"
+   */
+  static compileBlueprint(name, blueprint) {
+    const cols = [];
+    for (const [colName, config] of Object.entries(blueprint)) {
+      let type = typeof config === 'string' ? config : config.type;
+      let pk = (config.primary || config.is_pk) ? ":pk" : "";
+      let fk = "";
+
+      if (config.references) {
+        const [refTable, refCol] = config.references.split('.');
+        fk = `:fk(${refTable}.${refCol})`;
+      }
+
+      // Auto-map JS types if not specified as SQL types
+      if (type === 'Number') type = 'INT';
+      if (type === 'String') type = 'STRING';
+      if (type === 'Object') type = 'JSON';
+      if (type === 'Boolean') type = 'BOOL';
+
+      cols.push(`${colName}:${type}${pk}${fk}`);
+    }
+    return `CREATE TABLE ${name} ${cols.join(" ")}`;
+  }
+
+  /**
+   * Maps MongoDB-style operators to ToriDB SQL operators.
+   * @param {string} op - The operator to map (e.g., "$gt").
+   * @returns {string} The corresponding SQL operator or the operator itself if no map exists.
+   * @private
+   */
+  static _mapOperator(op) {
+    const maps = {
+      '$gt': '>', '$gte': '>=', '$lt': '<', '$lte': '<=',
+      '$ne': '!=', '$eq': '=', '$like': 'LIKE', '$in': 'IN'
+    };
+    return maps[op] || op;
+  }
+
+  /**
+   * Escapes values for safe inclusion in ToriDB queries.
+   * Handles strings, arrays, and objects (JSON).
+   * @param {any} val - The value to escape.
+   * @returns {string} The escaped and formatted value string.
+   * @private
+   */
+  static _escape(val) {
+    if (typeof val === 'string') {
+      // If it's a list for IN operator, don't wrap the whole thing in quotes
+      // but wrap individual elements if they are strings.
+      // However, the server's IN expects (val1,val2)
+      return `"${val.replace(/"/g, '\\"')}"`;
+    }
+    if (Array.isArray(val)) {
+      return `(${val.map(v => this._escape(v)).join(",")})`;
+    }
+    if (typeof val === 'object' && val !== null) return `"${JSON.stringify(val).replace(/"/g, '\\"')}"`;
+    return String(val);
+  }
 }
 
 /**
  * High-Performance RESP (REdis Serialization Protocol) Parser
  * Handles Simple Strings, Errors, Integers, Bulk Strings, and Nested Arrays.
- */
-
-var resp;
-var hasRequiredResp;
-
-function requireResp () {
-	if (hasRequiredResp) return resp;
-	hasRequiredResp = 1;
-	class RespParser {
-	  constructor() {
-	    this.reset();
-	  }
-
-	  reset() {
-	    this.buffer = Buffer.alloc(0);
-	  }
-
-	  feed(data) {
-	    this.buffer = Buffer.concat([this.buffer, data]);
-	  }
-
-	  /**
-	   * Tries to parse the next complete RESP value from the buffer.
-	   * @returns {any | undefined} The parsed value or undefined if incomplete.
-	   */
-	  parseNext() {
-	    if (this.buffer.length === 0) return undefined;
-
-	    const result = this._decode(0);
-	    if (result) {
-	      this.buffer = this.buffer.slice(result.bytesRead);
-	      return result.value;
-	    }
-	    return undefined;
-	  }
-
-	  _decode(offset) {
-	    if (offset >= this.buffer.length) return null;
-
-	    const prefix = this.buffer[offset];
-	    const lineEnd = this.buffer.indexOf('\r\n', offset);
-	    if (lineEnd === -1) return null;
-
-	    const content = this.buffer.slice(offset + 1, lineEnd).toString();
-	    const bytesBeforeData = lineEnd - offset + 2;
-
-	    switch (prefix) {
-	      case 43: // '+' Simple String
-	        return { value: content, bytesRead: bytesBeforeData };
-
-	      case 45: // '-' Error
-	        return { value: new Error(content), bytesRead: bytesBeforeData };
-
-	      case 58: // ':' Integer
-	        return { value: parseInt(content, 10), bytesRead: bytesBeforeData };
-
-	      case 36: { // '$' Bulk String
-	        const length = parseInt(content, 10);
-	        if (length === -1) return { value: null, bytesRead: bytesBeforeData };
-	        
-	        const dataEnd = lineEnd + 2 + length;
-	        if (this.buffer.length < dataEnd + 2) return null;
-	        
-	        const value = this.buffer.slice(lineEnd + 2, dataEnd).toString();
-	        // Verify CRLF
-	        if (this.buffer[dataEnd] !== 13 || this.buffer[dataEnd + 1] !== 10) {
-	           throw new Error("Invalid Bulk String terminator");
-	        }
-	        return { value, bytesRead: bytesBeforeData + length + 2 };
-	      }
-
-	      case 42: { // '*' Array
-	        const count = parseInt(content, 10);
-	        if (count === -1) return { value: null, bytesRead: bytesBeforeData };
-	        if (count === 0) return { value: [], bytesRead: bytesBeforeData };
-
-	        let totalRead = bytesBeforeData;
-	        const items = [];
-	        for (let i = 0; i < count; i++) {
-	          const item = this._decode(offset + totalRead);
-	          if (!item) return null;
-	          items.push(item.value);
-	          totalRead += item.bytesRead;
-	        }
-	        return { value: items, bytesRead: totalRead };
-	      }
-
-	      default:
-	        // Attempt to handle unexpected data as a simple string line
-	        return { value: content, bytesRead: bytesBeforeData };
-	    }
-	  }
-
-	  /**
-	   * Serializes a command into a RESP Array.
-	   * @param {string[]} args 
-	   */
-	  static encode(args) {
-	    let res = `*${args.length}\r\n`;
-	    for (const arg of args) {
-	      const s = String(arg);
-	      res += `$${Buffer.byteLength(s)}\r\n${s}\r\n`;
-	    }
-	    return Buffer.from(res);
-	  }
-	}
-
-	resp = { RespParser };
-	return resp;
+ */
+class RespParser {
+  /**
+   * Initializes or resets the parser state.
+   */
+  constructor() {
+    this.reset();
+  }
+
+  /**
+   * Clears the current data buffer.
+   */
+  reset() {
+    this.buffer = Buffer.alloc(0);
+  }
+
+  /**
+   * Feeds raw binary data into the parser's buffer.
+   * @param {Buffer} data - The raw data received from the socket.
+   */
+  feed(data) {
+    this.buffer = Buffer.concat([this.buffer, data]);
+  }
+
+  /**
+   * Tries to parse the next complete RESP value from the buffer.
+   * @returns {any | undefined} The parsed value or undefined if incomplete.
+   */
+  parseNext() {
+    if (this.buffer.length === 0) return undefined;
+
+    const result = this._decode(0);
+    if (result) {
+      this.buffer = this.buffer.slice(result.bytesRead);
+      return result.value;
+    }
+    return undefined;
+  }
+
+  /**
+   * Decodes a single RESP value from the buffer starting at a given offset.
+   * Internal recursive method for handling nested arrays and bulk strings.
+   * @param {number} offset - The buffer offset to start parsing from.
+   * @returns {Object|null} An object with {value, bytesRead} or null if incomplete.
+   * @private
+   */
+  _decode(offset) {
+    if (offset >= this.buffer.length) return null;
+
+    const prefix = this.buffer[offset];
+    const lineEnd = this.buffer.indexOf('\r\n', offset);
+    if (lineEnd === -1) return null;
+
+    const content = this.buffer.slice(offset + 1, lineEnd).toString();
+    const bytesBeforeData = lineEnd - offset + 2;
+
+    switch (prefix) {
+      case 43: // '+' Simple String
+        return { value: content, bytesRead: bytesBeforeData };
+
+      case 45: // '-' Error
+        return { value: new Error(content), bytesRead: bytesBeforeData };
+
+      case 58: // ':' Integer
+        return { value: parseInt(content, 10), bytesRead: bytesBeforeData };
+
+      case 36: { // '$' Bulk String
+        const length = parseInt(content, 10);
+        if (length === -1) return { value: null, bytesRead: bytesBeforeData };
+        
+        const dataEnd = lineEnd + 2 + length;
+        if (this.buffer.length < dataEnd + 2) return null;
+        
+        const value = this.buffer.slice(lineEnd + 2, dataEnd).toString();
+        // Verify CRLF
+        if (this.buffer[dataEnd] !== 13 || this.buffer[dataEnd + 1] !== 10) {
+           throw new Error("Invalid Bulk String terminator");
+        }
+        return { value, bytesRead: bytesBeforeData + length + 2 };
+      }
+
+      case 42: { // '*' Array
+        const count = parseInt(content, 10);
+        if (count === -1) return { value: null, bytesRead: bytesBeforeData };
+        if (count === 0) return { value: [], bytesRead: bytesBeforeData };
+
+        let totalRead = bytesBeforeData;
+        const items = [];
+        for (let i = 0; i < count; i++) {
+          const item = this._decode(offset + totalRead);
+          if (!item) return null;
+          items.push(item.value);
+          totalRead += item.bytesRead;
+        }
+        return { value: items, bytesRead: totalRead };
+      }
+
+      default:
+        // Attempt to handle unexpected data as a simple string line
+        return { value: content, bytesRead: bytesBeforeData };
+    }
+  }
+
+  /**
+   * Serializes a command into a RESP Array.
+   * @param {string[]} args 
+   */
+  static encode(args) {
+    let res = `*${args.length}\r\n`;
+    for (const arg of args) {
+      const s = String(arg);
+      res += `$${Buffer.byteLength(s)}\r\n${s}\r\n`;
+    }
+    return Buffer.from(res);
+  }
 }
 
 /**
- * Command Compiler: Translates JS Objects and Types to ToriDB DSL
- */
-
-var compiler;
-var hasRequiredCompiler;
-
-function requireCompiler () {
-	if (hasRequiredCompiler) return compiler;
-	hasRequiredCompiler = 1;
-	class Compiler {
-	  /**
-	   * Translates a JS Object to a ToriDB Filter string.
-	   * { age: { $gt: 18 }, status: 'active' } -> "age > 18 AND status = 'active'"
-	   */
-	  static compileFilter(filter) {
-	    if (!filter || typeof filter !== 'object') return "";
-
-	    const parts = [];
-	    for (const [key, value] of Object.entries(filter)) {
-	      if (key === '$or' && Array.isArray(value)) {
-	        parts.push(`(${value.map(f => this.compileFilter(f)).join(" OR ")})`);
-	      } else if (key === '$and' && Array.isArray(value)) {
-	        parts.push(`(${value.map(f => this.compileFilter(f)).join(" AND ")})`);
-	      } else if (typeof value === 'object' && value !== null) {
-	        // Handle operators: { $gt: 10 }
-	        for (const [op, val] of Object.entries(value)) {
-	          const symbol = this._mapOperator(op);
-	          parts.push(`${key} ${symbol} ${this._escape(val)}`);
-	        }
-	      } else {
-	        // Basic equality
-	        parts.push(`${key} = ${this._escape(value)}`);
-	      }
-	    }
-	    return parts.join(" AND ");
-	  }
-
-	  /**
-	   * Translates a Blueprint definition to ToriDB Table Definition format.
-	   * { id: { type: 'INT', primary: true }, user_id: { type: 'INT', references: 'users.id' } }
-	   * -> "id:INT:pk user_id:INT:fk(users.id)"
-	   */
-	  static compileBlueprint(name, blueprint) {
-	    const cols = [];
-	    for (const [colName, config] of Object.entries(blueprint)) {
-	      let type = typeof config === 'string' ? config : config.type;
-	      let pk = (config.primary || config.is_pk) ? ":pk" : "";
-	      let fk = "";
-
-	      if (config.references) {
-	        const [refTable, refCol] = config.references.split('.');
-	        fk = `:fk(${refTable}.${refCol})`;
-	      }
-
-	      // Auto-map JS types if not specified as SQL types
-	      if (type === 'Number') type = 'INT';
-	      if (type === 'String') type = 'STRING';
-	      if (type === 'Object') type = 'JSON';
-	      if (type === 'Boolean') type = 'BOOL';
-
-	      cols.push(`${colName}:${type}${pk}${fk}`);
-	    }
-	    return `CREATE TABLE ${name} ${cols.join(" ")}`;
-	  }
-
-	  static _mapOperator(op) {
-	    const maps = {
-	      '$gt': '>', '$gte': '>=', '$lt': '<', '$lte': '<=',
-	      '$ne': '!=', '$eq': '=', '$like': 'LIKE', '$in': 'IN'
-	    };
-	    return maps[op] || op;
-	  }
-
-	  static _escape(val) {
-	    if (typeof val === 'string') {
-	      // If it's a list for IN operator, don't wrap the whole thing in quotes
-	      // but wrap individual elements if they are strings.
-	      // However, the server's IN expects (val1,val2)
-	      return `"${val.replace(/"/g, '\\"')}"`;
-	    }
-	    if (Array.isArray(val)) {
-	      return `(${val.map(v => this._escape(v)).join(",")})`;
-	    }
-	    if (typeof val === 'object' && val !== null) return `"${JSON.stringify(val).replace(/"/g, '\\"')}"`;
-	    return String(val);
-	  }
-	}
-
-	compiler = { Compiler };
-	return compiler;
-}
-
-var sdk$1;
-var hasRequiredSdk;
-
-function requireSdk () {
-	if (hasRequiredSdk) return sdk$1;
-	hasRequiredSdk = 1;
-	const net = require$$0;
-	const { RespParser } = requireResp();
-	const { Compiler } = requireCompiler();
-
-	/**
-	 * Main client class for interacting with ToriDB.
-	 * Supports Key-Value, NoSQL structures (List, Set, Hash, JSON), and Relational modeling.
-	 */
-	class ToriDB {
-	    /**
-	     * Represents a database schema definition.
-	     */
-	    static Blueprint = class {
-	        /**
-	         * @param {Object} definition - The schema definition object.
-	         */
-	        constructor(definition) {
-	            this.definition = definition;
-	        }
-	    };
-
-	    /**
-	     * Creates a new ToriDB client instance.
-	     * @param {string} [uri="db://127.0.0.1:8569"] - Connection URI (e.g., db://user:pass@host:port/db)
-	     */
-	    constructor(uri = "db://127.0.0.1:8569") {
-	        this.host = "127.0.0.1";
-	        this.port = 8569;
-	        this.user = "default";
-	        this.password = null;
-	        this._parseUri(uri);
-
-	        this.parser = new RespParser();
-	        this.socket = new net.Socket();
-	        this.isConnected = false;
-	        this.pendingRequests = [];
-
-	        this._setupSocket();
-
-	        // Managers
-	        this.system = new SystemManager(this);
-	    }
-
-	    /**
-	     * Parses the connection URI.
-	     * @param {string} uri - The connection URI to parse.
-	     * @private
-	     */
-	    _parseUri(uri) {
-	        const regex = /^db:\/\/(?:(?:([^:]+):([^@+]+)[@+])?)([^:/\?]+)(?::(\d+))?(?:(?:\/([^?]+))?)?/;
-	        const match = uri.match(regex);
-	        if (match) {
-	            this.user = match[1] || "default";
-	            this.password = match[2] || null;
-	            this.host = match[3];
-	            this.port = parseInt(match[4], 10) || 8569;
-	        }
-	    }
-
-	    /**
-	     * Sets up socket events for data handling, errors, and closure.
-	     * @private
-	     */
-	    _setupSocket() {
-	        this.socket.on('data', (data) => {
-	            this.parser.feed(data);
-	            let response;
-	            while ((response = this.parser.parseNext()) !== undefined) {
-	                const req = this.pendingRequests.shift();
-	                if (req) {
-	                    if (response instanceof Error) req.reject(response);
-	                    else req.resolve(response);
-	                }
-	            }
-	        });
-
-	        this.socket.on('error', (err) => {
-	            this.isConnected = false;
-	            this.pendingRequests.forEach(req => req.reject(err));
-	            this.pendingRequests = [];
-	        });
-
-	        this.socket.on('close', () => {
-	            this.isConnected = false;
-	        });
-	    }
-
-	    /**
-	     * Establishes a connection to the ToriDB server.
-	     * @returns {Promise<void>}
-	     * @throws {Error} If connection or authentication fails.
-	     */
-	    async connect() {
-	        if (this.isConnected) return;
-	        return new Promise((resolve, reject) => {
-	            this.socket.connect(this.port, this.host, async () => {
-	                this.isConnected = true;
-	                if (this.password) {
-	                    try {
-	                        await this.execute("AUTH", this.user, this.password);
-	                    } catch (e) {
-	                        this.disconnect();
-	                        return reject(new Error(`Authentication failed: ${e.message}`));
-	                    }
-	                }
-	                resolve();
-	            });
-	            this.socket.once('error', reject);
-	        });
-	    }
-
-	    /**
-	     * Disconnects from the ToriDB server.
-	     */
-	    disconnect() {
-	        this.socket.destroy();
-	        this.isConnected = false;
-	    }
-
-	    /**
-	     * Executes a command on the ToriDB server.
-	     * @param {...any} args - Command arguments.
-	     * @returns {Promise<any>} The server response.
-	     */
-	    async execute(...args) {
-	        if (!this.isConnected) await this.connect();
-	        return new Promise((resolve, reject) => {
-	            this.pendingRequests.push({ resolve, reject });
-	            this.socket.write(RespParser.encode(args));
-	        });
-	    }
-
-	    /**
-	     * Executes a raw query string.
-	     * @param {string} s - The query string.
-	     * @returns {Promise<any>}
-	     */
-	    async query(s) {
-	        return this.execute(...s.match(/(?:[^\s"]+|"[^"]*")+/g).map(p => p.replace(/"/g, '')));
-	    }
-
-	    // --- Key-Value & TTL ---
-	    /**
-	     * Retrieves the value of a key.
-	     * @param {string} key - The key to get.
-	     * @returns {Promise<any>}
-	     */
-	    async get(key) { return this.execute("GET", key); }
-
-	    /**
-	     * Sets the value of a key.
-	     * @param {string} key - The key to set.
-	     * @param {any} val - The value to store (objects are JSON-stringified).
-	     * @returns {Promise<string>} OK on success.
-	     */
-	    async set(key, val) {
-	        const s = typeof val === 'object' ? JSON.stringify(val) : String(val);
-	        return this.execute("SET", key, s);
-	    }
-	    /**
-	     * Sets the value of a key with an expiration time.
-	     * @param {string} key - The key to set.
-	     * @param {any} val - The value to store.
-	     * @param {number} ttl - Time to live in seconds.
-	     * @returns {Promise<string>} OK on success.
-	     */
-	    async setEx(key, val, ttl) {
-	        const s = typeof val === 'object' ? JSON.stringify(val) : String(val);
-	        return this.execute("SETEX", key, s, String(ttl));
-	    }
-	    /**
-	     * Gets the remaining time to live of a key.
-	     * @param {string} key - The key.
-	     * @returns {Promise<number>} TTL in seconds, or -1 if no TTL, or -2 if key doesn't exist.
-	     */
-	    async ttl(key) { return this.execute("TTL", key); }
-
-	    /**
-	     * Increments the integer value of a key by one.
-	     * @param {string} key - The key to increment.
-	     * @returns {Promise<number>} The value after increment.
-	     */
-	    async incr(key) { return this.execute("INCR", key); }
-
-	    /**
-	     * Decrements the integer value of a key by one.
-	     * @param {string} key - The key to decrement.
-	     * @returns {Promise<number>} The value after decrement.
-	     */
-	    async decr(key) { return this.execute("DECR", key); }
-
-	    // --- NoSQL Structures ---
-	    /**
-	     * Accesses list operations for a given key.
-	     * @param {string} key - The list key.
-	     * @returns {Object} An object with list operations (push, rpush, pop, rpop, range).
-	     */
-	    list(key) {
-	        return {
-	            push: (...vals) => this.execute("LPUSH", key, ...vals.map(String)),
-	            rpush: (...vals) => this.execute("RPUSH", key, ...vals.map(String)),
-	            pop: (count = 1) => this.execute("LPOP", key, String(count)),
-	            rpop: (count = 1) => this.execute("RPOP", key, String(count)),
-	            range: (start, stop) => this.execute("LRANGE", key, String(start), String(stop))
-	        };
-	    }
-
-	    /**
-	     * Accesses set operations for a given key.
-	     * @param {string} key - The set key.
-	     * @returns {Object} An object with set operations (add, members).
-	     */
-	    setOf(key) {
-	        return {
-	            add: (...members) => this.execute("SADD", key, ...members.map(String)),
-	            members: () => this.execute("SMEMBERS", key)
-	        };
-	    }
-
-	    /**
-	     * Accesses hash operations for a given key.
-	     * @param {string} key - The hash key.
-	     * @returns {Object} An object with hash operations (set, get, all).
-	     */
-	    hash(key) {
-	        return {
-	            set: (field, val) => this.execute("HSET", key, field, String(val)),
-	            get: (field) => this.execute("HGET", key, field),
-	            all: () => this.execute("HGETALL", key)
-	        };
-	    }
-
-	    /**
-	     * Accesses sorted set operations for a given key.
-	     * @param {string} key - The sorted set key.
-	     * @returns {Object} An object with sorted set operations (add, range, score).
-	     */
-	    sortedSet(key) {
-	        return {
-	            add: (score, member) => this.execute("ZADD", key, String(score), member),
-	            range: (start, stop) => this.execute("ZRANGE", key, String(start), String(stop)),
-	            score: (member) => this.execute("ZSCORE", key, member)
-	        };
-	    }
-
-	    /**
-	     * Accesses JSON operations for a given key.
-	     * @param {string} key - The JSON key.
-	     * @returns {Object} An object with JSON operations (get, set).
-	     */
-	    json(key) {
-	        return {
-	            get: (path = "$") => this.execute("JSON.GET", key, path),
-	            set: (path, val) => {
-	                const s = typeof val === 'object' ? JSON.stringify(val) : JSON.stringify(val);
-	                return this.execute("JSON.SET", key, path, s);
-	            }
-	        };
-	    }
-
-	    // --- Relational (Models) ---
-	    /**
-	     * Defines or accesses a model for relational-like operations.
-	     * @param {string} name - The model name (table name).
-	     * @param {ToriDB.Blueprint} blueprint - The schema definition.
-	     * @returns {Object} An object with model operations (create, find, findById, update, delete, etc.).
-	     */
-	    model(name, blueprint) {
-	        const createCmd = Compiler.compileBlueprint(name, blueprint.definition);
-	        this.execute(...createCmd.match(/(?:[^\s"]+|"[^"]*")+/g).map(p => p.replace(/"/g, ''))).catch(() => { });
-
-	        return {
-	            create: (data) => this.execute("INSERT", name, ...Object.values(data).map(v => typeof v === 'object' ? JSON.stringify(v) : String(v))),
-	            find: (filter) => new QueryBuilder(this, name, filter),
-	            findById: (id) => new QueryBuilder(this, name, { id }).execute().then(r => r[0] || null),
-	            update: (filter, data) => {
-	                const where = Compiler.compileFilter(filter);
-	                const [col, val] = Object.entries(data)[0];
-	                const sVal = typeof val === 'object' ? JSON.stringify(val) : String(val);
-	                return this.execute("UPDATE", name, "SET", col, "=", sVal, "WHERE", where);
-	            },
-	            delete: (filter) => this.execute("DELETE", "FROM", name, "WHERE", Compiler.compileFilter(filter)),
-	            createIndex: (idxName, col) => this.execute("CREATE", "INDEX", idxName, "ON", name, `(${col})`),
-	            addColumn: (col, type) => this.execute("ALTER", "TABLE", name, "ADD", `${col}:${type}`),
-	            dropColumn: (col) => this.execute("ALTER", "TABLE", name, "DROP", col)
-	        };
-	    }
-
-	    /**
-	     * Accesses a table for query operations.
-	     * @param {string} name - The table name.
-	     * @returns {Object} An object with a find method.
-	     */
-	    table(name) {
-	        return { find: (filter) => new QueryBuilder(this, name, filter) };
-	    }
-	}
-
-	/**
-	 * Manager for system-level operations (ACL, Cluster, Replication, etc.).
-	 */
-	class SystemManager {
-	    /**
-	     * @param {ToriDB} client - The ToriDB client instance.
-	     */
-	    constructor(client) { this.client = client; }
-
-	    /**
-	     * Retrieves server information and statistics.
-	     * @returns {Promise<string>}
-	     */
-	    async info() { return this.client.execute("INFO"); }
-
-	    /**
-	     * Synchronously saves the dataset to disk.
-	     * @returns {Promise<string>}
-	     */
-	    async save() { return this.client.execute("SAVE"); }
-
-	    /**
-	     * Triggers an AOF rewrite in the background.
-	     * @returns {Promise<string>}
-	     */
-	    async rewriteAof() { return this.client.execute("REWRITEAOF"); }
-
-	    /**
-	     * Accesses ACL (Access Control List) operations.
-	     * @returns {Object} An object with ACL operations (createUser, getUser, listUsers, deleteUser).
-	     */
-	    get acl() {
-	        return {
-	            createUser: (u, p, rules) => this.client.execute("ACL", "SETUSER", u, p, ...rules),
-	            getUser: (u) => this.client.execute("ACL", "GETUSER", u),
-	            listUsers: () => this.client.execute("ACL", "LIST"),
-	            deleteUser: (u) => this.client.execute("ACL", "DELUSER", u)
-	        };
-	    }
-
-	    /**
-	     * Accesses cluster management operations.
-	     * @returns {Object} An object with cluster operations (meet, slots, info).
-	     */
-	    get cluster() {
-	        return {
-	            meet: (h, p) => this.client.execute("CLUSTER", "MEET", h, String(p)),
-	            slots: () => this.client.execute("CLUSTER", "SLOTS"),
-	            info: () => this.client.execute("CLUSTER", "INFO")
-	        };
-	    }
-
-	    /**
-	     * Accesses replication management operations.
-	     * @returns {Object} An object with replication operations (slaveOf, stop).
-	     */
-	    get replication() {
-	        return {
-	            slaveOf: (h, p) => this.client.execute("REPLICAOF", h, String(p)),
-	            stop: () => this.client.execute("REPLICAOF", "NO", "ONE")
-	        };
-	    }
-
-	    /**
-	     * Accesses client management operations.
-	     * @returns {Object} An object with client operations (list, kill).
-	     */
-	    get clients() {
-	        return {
-	            list: () => this.client.execute("CLIENT", "LIST"),
-	            kill: (addr) => this.client.execute("CLIENT", "KILL", addr)
-	        };
-	    }
-	}
-
-	/**
-	 * Helper class for building and executing SQL-like queries.
-	 */
-	class QueryBuilder {
-	    /**
-	     * @param {ToriDB} client - The ToriDB client instance.
-	     * @param {string} target - The table or model name.
-	     * @param {Object} [filter={}] - Initial filter object.
-	     */
-	    constructor(client, target, filter = {}) {
-	        this.client = client;
-	        this.target = target;
-	        this.params = {
-	            filter: Compiler.compileFilter(filter),
-	            limit: null,
-	            offset: null,
-	            orderBy: null,
-	            groupBy: null,
-	            select: "*"
-	        };
-	    }
-
-	    /**
-	     * Specifies the fields to select.
-	     * @param {string|string[]|Object} fields - Fields to select.
-	     * @returns {QueryBuilder} This instance for chaining.
-	     */
-	    select(fields) {
-	        if (typeof fields === 'string') this.params.select = fields;
-	        else if (Array.isArray(fields)) this.params.select = fields.join(", ");
-	        else if (typeof fields === 'object') {
-	            this.params.select = Object.entries(fields).map(([k, v]) => `${v} AS ${k}`).join(", ");
-	        }
-	        return this;
-	    }
-
-	    /**
-	     * Limits the number of results.
-	     * @param {number} n - The limit count.
-	     * @returns {QueryBuilder} This instance for chaining.
-	     */
-	    limit(n) { this.params.limit = n; return this; }
-
-	    /**
-	     * Offsets the results.
-	     * @param {number} n - The offset count.
-	     * @returns {QueryBuilder} This instance for chaining.
-	     */
-	    offset(n) { this.params.offset = n; return this; }
-
-	    /**
-	     * Orders the results by a column.
-	     * @param {string} col - The column name.
-	     * @param {string} [dir="ASC"] - Sort direction (ASC or DESC).
-	     * @returns {QueryBuilder} This instance for chaining.
-	     */
-	    orderBy(col, dir = "ASC") { this.params.orderBy = `${col} ${dir.toUpperCase()}`; return this; }
-
-	    /**
-	     * Groups the results by columns.
-	     * @param {string|string[]} cols - The columns to group by.
-	     * @returns {QueryBuilder} This instance for chaining.
-	     */
-	    groupBy(cols) { this.params.groupBy = Array.isArray(cols) ? cols.join(", ") : cols; return this; }
-
-	    /**
-	     * Compiles and executes the query.
-	     * @returns {Promise<any[]>} The query results.
-	     */
-	    async execute() {
-	        const args = ["SELECT", this.params.select, "FROM", this.target];
-	        if (this.params.filter) { args.push("WHERE"); args.push(this.params.filter); }
-	        if (this.params.groupBy) { args.push("GROUP"); args.push("BY"); args.push(this.params.groupBy); }
-	        if (this.params.orderBy) { args.push("ORDER"); args.push("BY"); args.push(this.params.orderBy); }
-	        if (this.params.limit) { args.push("LIMIT"); args.push(String(this.params.limit)); }
-	        if (this.params.offset) { args.push("OFFSET"); args.push(String(this.params.offset)); }
-
-	        return this.client.execute(...args);
-	    }
-	}
-
-	sdk$1 = { ToriDB };
-	return sdk$1;
+ * Main client class for interacting with ToriDB.
+ * Supports Key-Value, NoSQL structures (List, Set, Hash, JSON), and Relational modeling.
+ */
+class ToriDB {
+    /**
+     * Represents a database schema definition.
+     */
+    static Blueprint = class {
+        /**
+         * @param {Object} definition - The schema definition object.
+         */
+        constructor(definition) {
+            this.definition = definition;
+        }
+    };
+
+    /**
+     * Creates a new ToriDB client instance.
+     * @param {string} [uri="db://127.0.0.1:8569"] - Connection URI (e.g., db://user:pass@host:port/db)
+     */
+    constructor(uri = "db://127.0.0.1:8569") {
+        this.host = "127.0.0.1";
+        this.port = 8569;
+        this.user = "default";
+        this.password = null;
+        this._parseUri(uri);
+
+        this.parser = new RespParser();
+        this.socket = new net.Socket();
+        this.isConnected = false;
+        this.pendingRequests = [];
+
+        this._setupSocket();
+
+        // Managers
+        this.system = new SystemManager(this);
+    }
+
+    /**
+     * Parses the connection URI.
+     * @param {string} uri - The connection URI to parse.
+     * @private
+     */
+    _parseUri(uri) {
+        const regex = /^db:\/\/(?:(?:([^:]+):([^@+]+)[@+])?)([^:/\?]+)(?::(\d+))?(?:(?:\/([^?]+))?)?/;
+        const match = uri.match(regex);
+        if (match) {
+            this.user = match[1] || "default";
+            this.password = match[2] || null;
+            this.host = match[3];
+            this.port = parseInt(match[4], 10) || 8569;
+        }
+    }
+
+    /**
+     * Sets up socket events for data handling, errors, and closure.
+     * @private
+     */
+    _setupSocket() {
+        this.socket.on('data', (data) => {
+            this.parser.feed(data);
+            let response;
+            while ((response = this.parser.parseNext()) !== undefined) {
+                const req = this.pendingRequests.shift();
+                if (req) {
+                    if (response instanceof Error) req.reject(response);
+                    else req.resolve(response);
+                }
+            }
+        });
+
+        this.socket.on('error', (err) => {
+            this.isConnected = false;
+            this.pendingRequests.forEach(req => req.reject(err));
+            this.pendingRequests = [];
+        });
+
+        this.socket.on('close', () => {
+            this.isConnected = false;
+        });
+    }
+
+    /**
+     * Establishes a connection to the ToriDB server.
+     * @returns {Promise<void>}
+     * @throws {Error} If connection or authentication fails.
+     */
+    async connect() {
+        if (this.isConnected) return;
+        return new Promise((resolve, reject) => {
+            this.socket.connect(this.port, this.host, async () => {
+                this.isConnected = true;
+                if (this.password) {
+                    try {
+                        await this.execute("AUTH", this.user, this.password);
+                    } catch (e) {
+                        this.disconnect();
+                        return reject(new Error(`Authentication failed: ${e.message}`));
+                    }
+                }
+                resolve();
+            });
+            this.socket.once('error', reject);
+        });
+    }
+
+    /**
+     * Disconnects from the ToriDB server.
+     */
+    disconnect() {
+        this.socket.destroy();
+        this.isConnected = false;
+    }
+
+    /**
+     * Executes a command on the ToriDB server.
+     * @param {...any} args - Command arguments.
+     * @returns {Promise<any>} The server response.
+     */
+    async execute(...args) {
+        if (!this.isConnected) await this.connect();
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.push({ resolve, reject });
+            this.socket.write(RespParser.encode(args));
+        });
+    }
+
+    /**
+     * Executes a raw query string.
+     * @param {string} s - The query string.
+     * @returns {Promise<any>}
+     */
+    async query(s) {
+        return this.execute(...s.match(/(?:[^\s"]+|"[^"]*")+/g).map(p => p.replace(/"/g, '')));
+    }
+
+    // --- Key-Value & TTL ---
+    /**
+     * Retrieves the value of a key.
+     * @param {string} key - The key to get.
+     * @returns {Promise<any>}
+     */
+    async get(key) { return this.execute("GET", key); }
+
+    /**
+     * Sets the value of a key.
+     * @param {string} key - The key to set.
+     * @param {any} val - The value to store (objects are JSON-stringified).
+     * @returns {Promise<string>} OK on success.
+     */
+    async set(key, val) {
+        const s = typeof val === 'object' ? JSON.stringify(val) : String(val);
+        return this.execute("SET", key, s);
+    }
+    /**
+     * Sets the value of a key with an expiration time.
+     * @param {string} key - The key to set.
+     * @param {any} val - The value to store.
+     * @param {number} ttl - Time to live in seconds.
+     * @returns {Promise<string>} OK on success.
+     */
+    async setEx(key, val, ttl) {
+        const s = typeof val === 'object' ? JSON.stringify(val) : String(val);
+        return this.execute("SETEX", key, s, String(ttl));
+    }
+    /**
+     * Gets the remaining time to live of a key.
+     * @param {string} key - The key.
+     * @returns {Promise<number>} TTL in seconds, or -1 if no TTL, or -2 if key doesn't exist.
+     */
+    async ttl(key) { return this.execute("TTL", key); }
+
+    /**
+     * Increments the integer value of a key by one.
+     * @param {string} key - The key to increment.
+     * @returns {Promise<number>} The value after increment.
+     */
+    async incr(key) { return this.execute("INCR", key); }
+
+    /**
+     * Decrements the integer value of a key by one.
+     * @param {string} key - The key to decrement.
+     * @returns {Promise<number>} The value after decrement.
+     */
+    async decr(key) { return this.execute("DECR", key); }
+
+    // --- NoSQL Structures ---
+    /**
+     * Accesses list operations for a given key.
+     * @param {string} key - The list key.
+     * @returns {Object} An object with list operations (push, rpush, pop, rpop, range).
+     */
+    list(key) {
+        return {
+            push: (...vals) => this.execute("LPUSH", key, ...vals.map(String)),
+            rpush: (...vals) => this.execute("RPUSH", key, ...vals.map(String)),
+            pop: (count = 1) => this.execute("LPOP", key, String(count)),
+            rpop: (count = 1) => this.execute("RPOP", key, String(count)),
+            range: (start, stop) => this.execute("LRANGE", key, String(start), String(stop))
+        };
+    }
+
+    /**
+     * Accesses set operations for a given key.
+     * @param {string} key - The set key.
+     * @returns {Object} An object with set operations (add, members).
+     */
+    setOf(key) {
+        return {
+            add: (...members) => this.execute("SADD", key, ...members.map(String)),
+            members: () => this.execute("SMEMBERS", key)
+        };
+    }
+
+    /**
+     * Accesses hash operations for a given key.
+     * @param {string} key - The hash key.
+     * @returns {Object} An object with hash operations (set, get, all).
+     */
+    hash(key) {
+        return {
+            set: (field, val) => this.execute("HSET", key, field, String(val)),
+            get: (field) => this.execute("HGET", key, field),
+            all: () => this.execute("HGETALL", key)
+        };
+    }
+
+    /**
+     * Accesses sorted set operations for a given key.
+     * @param {string} key - The sorted set key.
+     * @returns {Object} An object with sorted set operations (add, range, score).
+     */
+    sortedSet(key) {
+        return {
+            add: (score, member) => this.execute("ZADD", key, String(score), member),
+            range: (start, stop) => this.execute("ZRANGE", key, String(start), String(stop)),
+            score: (member) => this.execute("ZSCORE", key, member)
+        };
+    }
+
+    /**
+     * Accesses JSON operations for a given key.
+     * @param {string} key - The JSON key.
+     * @returns {Object} An object with JSON operations (get, set).
+     */
+    json(key) {
+        return {
+            get: (path = "$") => this.execute("JSON.GET", key, path),
+            set: (path, val) => {
+                const s = typeof val === 'object' ? JSON.stringify(val) : JSON.stringify(val);
+                return this.execute("JSON.SET", key, path, s);
+            }
+        };
+    }
+
+    // --- Relational (Models) ---
+    /**
+     * Defines or accesses a model for relational-like operations.
+     * @param {string} name - The model name (table name).
+     * @param {ToriDB.Blueprint} blueprint - The schema definition.
+     * @returns {Object} An object with model operations (create, find, findById, update, delete, etc.).
+     */
+    model(name, blueprint) {
+        const createCmd = Compiler.compileBlueprint(name, blueprint.definition);
+        this.execute(...createCmd.match(/(?:[^\s"]+|"[^"]*")+/g).map(p => p.replace(/"/g, ''))).catch(() => { });
+
+        return {
+            create: (data) => this.execute("INSERT", name, ...Object.values(data).map(v => typeof v === 'object' ? JSON.stringify(v) : String(v))),
+            find: (filter) => new QueryBuilder(this, name, filter),
+            findById: (id) => new QueryBuilder(this, name, { id }).execute().then(r => r[0] || null),
+            update: (filter, data) => {
+                const where = Compiler.compileFilter(filter);
+                const [col, val] = Object.entries(data)[0];
+                const sVal = typeof val === 'object' ? JSON.stringify(val) : String(val);
+                return this.execute("UPDATE", name, "SET", col, "=", sVal, "WHERE", where);
+            },
+            delete: (filter) => this.execute("DELETE", "FROM", name, "WHERE", Compiler.compileFilter(filter)),
+            createIndex: (idxName, col) => this.execute("CREATE", "INDEX", idxName, "ON", name, `(${col})`),
+            addColumn: (col, type) => this.execute("ALTER", "TABLE", name, "ADD", `${col}:${type}`),
+            dropColumn: (col) => this.execute("ALTER", "TABLE", name, "DROP", col)
+        };
+    }
+
+    /**
+     * Accesses a table for query operations.
+     * @param {string} name - The table name.
+     * @returns {Object} An object with a find method.
+     */
+    table(name) {
+        return { find: (filter) => new QueryBuilder(this, name, filter) };
+    }
+}
+
+/**
+ * Manager for system-level operations (ACL, Cluster, Replication, etc.).
+ */
+class SystemManager {
+    /**
+     * @param {ToriDB} client - The ToriDB client instance.
+     */
+    constructor(client) { this.client = client; }
+
+    /**
+     * Retrieves server information and statistics.
+     * @returns {Promise<string>}
+     */
+    async info() { return this.client.execute("INFO"); }
+
+    /**
+     * Synchronously saves the dataset to disk.
+     * @returns {Promise<string>}
+     */
+    async save() { return this.client.execute("SAVE"); }
+
+    /**
+     * Triggers an AOF rewrite in the background.
+     * @returns {Promise<string>}
+     */
+    async rewriteAof() { return this.client.execute("REWRITEAOF"); }
+
+    /**
+     * Accesses ACL (Access Control List) operations.
+     * @returns {Object} An object with ACL operations (createUser, getUser, listUsers, deleteUser).
+     */
+    get acl() {
+        return {
+            createUser: (u, p, rules) => this.client.execute("ACL", "SETUSER", u, p, ...rules),
+            getUser: (u) => this.client.execute("ACL", "GETUSER", u),
+            listUsers: () => this.client.execute("ACL", "LIST"),
+            deleteUser: (u) => this.client.execute("ACL", "DELUSER", u)
+        };
+    }
+
+    /**
+     * Accesses cluster management operations.
+     * @returns {Object} An object with cluster operations (meet, slots, info).
+     */
+    get cluster() {
+        return {
+            meet: (h, p) => this.client.execute("CLUSTER", "MEET", h, String(p)),
+            slots: () => this.client.execute("CLUSTER", "SLOTS"),
+            info: () => this.client.execute("CLUSTER", "INFO")
+        };
+    }
+
+    /**
+     * Accesses replication management operations.
+     * @returns {Object} An object with replication operations (slaveOf, stop).
+     */
+    get replication() {
+        return {
+            slaveOf: (h, p) => this.client.execute("REPLICAOF", h, String(p)),
+            stop: () => this.client.execute("REPLICAOF", "NO", "ONE")
+        };
+    }
+
+    /**
+     * Accesses client management operations.
+     * @returns {Object} An object with client operations (list, kill).
+     */
+    get clients() {
+        return {
+            list: () => this.client.execute("CLIENT", "LIST"),
+            kill: (addr) => this.client.execute("CLIENT", "KILL", addr)
+        };
+    }
+}
+
+/**
+ * Helper class for building and executing SQL-like queries.
+ */
+class QueryBuilder {
+    /**
+     * @param {ToriDB} client - The ToriDB client instance.
+     * @param {string} target - The table or model name.
+     * @param {Object} [filter={}] - Initial filter object.
+     */
+    constructor(client, target, filter = {}) {
+        this.client = client;
+        this.target = target;
+        this.params = {
+            filter: Compiler.compileFilter(filter),
+            limit: null,
+            offset: null,
+            orderBy: null,
+            groupBy: null,
+            select: "*"
+        };
+    }
+
+    /**
+     * Specifies the fields to select.
+     * @param {string|string[]|Object} fields - Fields to select.
+     * @returns {QueryBuilder} This instance for chaining.
+     */
+    select(fields) {
+        if (typeof fields === 'string') this.params.select = fields;
+        else if (Array.isArray(fields)) this.params.select = fields.join(", ");
+        else if (typeof fields === 'object') {
+            this.params.select = Object.entries(fields).map(([k, v]) => `${v} AS ${k}`).join(", ");
+        }
+        return this;
+    }
+
+    /**
+     * Limits the number of results.
+     * @param {number} n - The limit count.
+     * @returns {QueryBuilder} This instance for chaining.
+     */
+    limit(n) { this.params.limit = n; return this; }
+
+    /**
+     * Offsets the results.
+     * @param {number} n - The offset count.
+     * @returns {QueryBuilder} This instance for chaining.
+     */
+    offset(n) { this.params.offset = n; return this; }
+
+    /**
+     * Orders the results by a column.
+     * @param {string} col - The column name.
+     * @param {string} [dir="ASC"] - Sort direction (ASC or DESC).
+     * @returns {QueryBuilder} This instance for chaining.
+     */
+    orderBy(col, dir = "ASC") { this.params.orderBy = `${col} ${dir.toUpperCase()}`; return this; }
+
+    /**
+     * Groups the results by columns.
+     * @param {string|string[]} cols - The columns to group by.
+     * @returns {QueryBuilder} This instance for chaining.
+     */
+    groupBy(cols) { this.params.groupBy = Array.isArray(cols) ? cols.join(", ") : cols; return this; }
+
+    /**
+     * Compiles and executes the query.
+     * @returns {Promise<any[]>} The query results.
+     */
+    async execute() {
+        const args = ["SELECT", this.params.select, "FROM", this.target];
+        if (this.params.filter) { args.push("WHERE"); args.push(this.params.filter); }
+        if (this.params.groupBy) { args.push("GROUP"); args.push("BY"); args.push(this.params.groupBy); }
+        if (this.params.orderBy) { args.push("ORDER"); args.push("BY"); args.push(this.params.orderBy); }
+        if (this.params.limit) { args.push("LIMIT"); args.push(String(this.params.limit)); }
+        if (this.params.offset) { args.push("OFFSET"); args.push(String(this.params.offset)); }
+
+        return this.client.execute(...args);
+    }
 }
 
-var sdkExports = requireSdk();
-var sdk = /*@__PURE__*/getDefaultExportFromCjs(sdkExports);
-
-export { sdk as default };
+export { ToriDB };
 //# sourceMappingURL=toridb.esm.js.map