openbase-js 0.1.3 → 0.1.5

package/index.cjs

@@ -6,9 +6,12 @@ class QueryBuilder {
     this._apiKey = apiKey;
     this._dbName = dbName;
     this._table = table;
-    this._filters = {};
+    this._filters = [];
     this._columns = '*';
     this._limitVal = null;
+    this._offsetVal = null;
+    this._orderCol = null;
+    this._orderAsc = true;
     this._single = false;
     this._operation = 'select';
     this._insertData = null;
@@ -21,8 +24,58 @@ class QueryBuilder {
     return this;
   }
 
+  // ─── Filter operators ──────────────────────────────────────────────────────
+
   eq(column, value) {
-    this._filters[column] = value;
+    this._filters.push({ col: column, op: 'eq', val: value });
+    return this;
+  }
+
+  gt(column, value) {
+    this._filters.push({ col: column, op: 'gt', val: value });
+    return this;
+  }
+
+  lt(column, value) {
+    this._filters.push({ col: column, op: 'lt', val: value });
+    return this;
+  }
+
+  gte(column, value) {
+    this._filters.push({ col: column, op: 'gte', val: value });
+    return this;
+  }
+
+  lte(column, value) {
+    this._filters.push({ col: column, op: 'lte', val: value });
+    return this;
+  }
+
+  like(column, pattern) {
+    this._filters.push({ col: column, op: 'like', val: pattern });
+    return this;
+  }
+
+  ilike(column, pattern) {
+    this._filters.push({ col: column, op: 'ilike', val: pattern });
+    return this;
+  }
+
+  in(column, values) {
+    this._filters.push({ col: column, op: 'in', val: values });
+    return this;
+  }
+
+  is(column, value) {
+    this._filters.push({ col: column, op: 'is', val: value });
+    return this;
+  }
+
+  // ─── Modifiers ─────────────────────────────────────────────────────────────
+
+  order(column, { ascending = true } = {}) {
+    this._orderCol = column;
+    this._orderAsc = ascending;
     return this;
   }
 
@@ -31,12 +84,20 @@ class QueryBuilder {
     return this;
   }
 
+  range(from, to) {
+    this._limitVal = to - from + 1;
+    this._offsetVal = from;
+    return this;
+  }
+
   single() {
     this._single = true;
     this._limitVal = 1;
     return this;
   }
 
+  // ─── Mutation operators ────────────────────────────────────────────────────
+
   insert(data) {
     this._operation = 'insert';
     this._insertData = data;
@@ -54,16 +115,46 @@ class QueryBuilder {
     return this;
   }
 
+  // ─── SQL Builder ───────────────────────────────────────────────────────────
+
+  _filterToSQL(f) {
+    const col = `"${f.col}"`;
+    switch (f.op) {
+      case 'eq': return typeof f.val === 'string' ? `${col} = '${f.val}'` : `${col} = ${f.val}`;
+      case 'gt': return `${col} > ${f.val}`;
+      case 'lt': return `${col} < ${f.val}`;
+      case 'gte': return `${col} >= ${f.val}`;
+      case 'lte': return `${col} <= ${f.val}`;
+      case 'like': return `${col} LIKE '${f.val}'`;
+      case 'ilike': return `${col} ILIKE '${f.val}'`;
+      case 'in': {
+        const list = f.val.map(v => typeof v === 'string' ? `'${v}'` : v).join(', ');
+        return `${col} IN (${list})`;
+      }
+      case 'is': {
+        if (f.val === null) return `${col} IS NULL`;
+        if (f.val === true) return `${col} IS TRUE`;
+        if (f.val === false) return `${col} IS FALSE`;
+        return `${col} IS NULL`;
+      }
+      default: return `${col} = '${f.val}'`;
+    }
+  }
+
   _buildSQL() {
     let sql = '';
 
     if (this._operation === 'select') {
       sql = `SELECT ${this._columns} FROM "${this._table}"`;
-      const whereParts = Object.entries(this._filters).map(([col, val]) =>
-        typeof val === 'string' ? `"${col}" = '${val}'` : `"${col}" = ${val}`
-      );
-      if (whereParts.length) sql += ` WHERE ${whereParts.join(' AND ')}`;
+      if (this._filters.length) {
+        const where = this._filters.map(f => this._filterToSQL(f)).join(' AND ');
+        sql += ` WHERE ${where}`;
+      }
+      if (this._orderCol) {
+        sql += ` ORDER BY "${this._orderCol}" ${this._orderAsc ? 'ASC' : 'DESC'}`;
+      }
       if (this._limitVal) sql += ` LIMIT ${this._limitVal}`;
+      if (this._offsetVal) sql += ` OFFSET ${this._offsetVal}`;
 
     } else if (this._operation === 'insert') {
       const cols = Object.keys(this._insertData).map(c => `"${c}"`).join(', ');
@@ -76,25 +167,27 @@ class QueryBuilder {
       const setClauses = Object.entries(this._updateData).map(([col, val]) =>
         typeof val === 'string' ? `"${col}" = '${val.replace(/'/g, "''")}'` : `"${col}" = ${val}`
       ).join(', ');
-      const whereParts = Object.entries(this._filters).map(([col, val]) =>
-        typeof val === 'string' ? `"${col}" = '${val}'` : `"${col}" = ${val}`
-      );
       sql = `UPDATE "${this._table}" SET ${setClauses}`;
-      if (whereParts.length) sql += ` WHERE ${whereParts.join(' AND ')}`;
+      if (this._filters.length) {
+        const where = this._filters.map(f => this._filterToSQL(f)).join(' AND ');
+        sql += ` WHERE ${where}`;
+      }
       sql += ` RETURNING *`;
 
     } else if (this._operation === 'delete') {
-      const whereParts = Object.entries(this._filters).map(([col, val]) =>
-        typeof val === 'string' ? `"${col}" = '${val}'` : `"${col}" = ${val}`
-      );
       sql = `DELETE FROM "${this._table}"`;
-      if (whereParts.length) sql += ` WHERE ${whereParts.join(' AND ')}`;
+      if (this._filters.length) {
+        const where = this._filters.map(f => this._filterToSQL(f)).join(' AND ');
+        sql += ` WHERE ${where}`;
+      }
       sql += ` RETURNING *`;
     }
 
     return sql;
   }
 
+  // ─── Executor ──────────────────────────────────────────────────────────────
+
   async _buildAndRun() {
     const sql = this._buildSQL();
     try {
@@ -122,6 +215,127 @@ class QueryBuilder {
   }
 }
 
+// ─── Storage Client ───────────────────────────────────────────────────────────
+
+class StorageClient {
+  constructor(baseUrl, apiKey, dbName) {
+    this._baseUrl = baseUrl;
+    this._apiKey = apiKey;
+    this._dbName = dbName;
+  }
+
+  _headers() {
+    return { 'Authorization': `Bearer ${this._apiKey}` };
+  }
+
+  // Detect if we're running in Node.js
+  _isNode() {
+    return typeof window === 'undefined' && typeof process !== 'undefined';
+  }
+
+  // Build a FormData object that works in both browser and Node.js
+  // In browser: file = File or Blob object
+  // In Node.js: file = file path string, Buffer, or ReadStream
+  async _buildFormData(file, filename) {
+    if (this._isNode()) {
+      // Node.js — use form-data package
+      let FormDataNode;
+      try {
+        FormDataNode = require('form-data');
+      } catch {
+        throw new Error(
+          '[openbase] In Node.js, storage.upload() requires the "form-data" package.\n' +
+          'Install it with: npm install form-data'
+        );
+      }
+
+      const fs = require('fs');
+      const path = require('path');
+      const formData = new FormDataNode();
+
+      if (typeof file === 'string') {
+        // file path string — read from disk
+        const resolvedName = filename || path.basename(file);
+        formData.append('file', fs.createReadStream(file), resolvedName);
+      } else if (Buffer.isBuffer(file)) {
+        // Buffer
+        formData.append('file', file, filename || 'file');
+      } else {
+        // ReadStream or anything else
+        formData.append('file', file, filename || 'file');
+      }
+
+      return formData;
+
+    } else {
+      // Browser — use native FormData
+      const formData = new FormData();
+      formData.append('file', file, filename || file.name);
+      return formData;
+    }
+  }
+
+  // Upload a file
+  // Browser: pass a File or Blob (from <input type="file"> or drag-and-drop)
+  // Node.js: pass a file path string, Buffer, or ReadStream
+  async upload(file, filename) {
+    try {
+      const formData = await this._buildFormData(file, filename);
+
+      // In Node.js, form-data needs its own headers (includes boundary)
+      const headers = this._isNode()
+        ? { ...this._headers(), ...formData.getHeaders() }
+        : this._headers();
+
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/upload`, {
+        method: 'POST',
+        headers,
+        body: formData,
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+
+  // List all files in this project's bucket
+  async list() {
+    try {
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/list`, {
+        headers: this._headers(),
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+
+  // Get a presigned URL valid for 7 days
+  async getUrl(filename) {
+    try {
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/url/${encodeURIComponent(filename)}`, {
+        headers: this._headers(),
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+
+  // Delete a file
+  async remove(filename) {
+    try {
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/${encodeURIComponent(filename)}`, {
+        method: 'DELETE',
+        headers: this._headers(),
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+}
+
 // ─── Client ───────────────────────────────────────────────────────────────────
 
 class OpenbaseClient {
@@ -129,6 +343,7 @@ class OpenbaseClient {
     this._baseUrl = baseUrl.replace(/\/$/, '');
     this._apiKey = apiKey;
     this._dbName = dbName;
+    this.storage = new StorageClient(this._baseUrl, this._apiKey, this._dbName);
   }
 
   from(table) {
@@ -152,5 +367,4 @@ if (typeof module !== 'undefined') {
 if (typeof window !== 'undefined') {
   window.openbase = { createClient };
 }
-
 module.exports = { createClient };

package/index.d.ts

@@ -1,23 +1,89 @@
+/// <reference types="node" />
+import { ReadStream } from 'fs';
+
 export interface OpenbaseResponse<T> {
   data: T | null;
   error: string | null;
 }
 
 export declare class QueryBuilder<T = Record<string, unknown>> {
+  // Column selection
   select(columns?: string): this;
+
+  // Filter operators
   eq(column: string, value: unknown): this;
+  gt(column: string, value: number): this;
+  lt(column: string, value: number): this;
+  gte(column: string, value: number): this;
+  lte(column: string, value: number): this;
+  like(column: string, pattern: string): this;
+  ilike(column: string, pattern: string): this;
+  in(column: string, values: unknown[]): this;
+  is(column: string, value: null | boolean): this;
+
+  // Modifiers
+  order(column: string, options?: { ascending?: boolean }): this;
   limit(n: number): this;
+  range(from: number, to: number): this;
   single(): this;
+
+  // Mutations
   insert(data: Partial<T>): this;
   update(data: Partial<T>): this;
   delete(): this;
+
   then<R>(
     resolve: (value: OpenbaseResponse<T[]>) => R,
     reject?: (reason: unknown) => R
   ): Promise<R>;
 }
 
+export interface StorageFileInfo {
+  name: string;
+  size: number;
+  content_type: string;
+}
+
+export interface StorageListItem {
+  name: string;
+  size: number;
+  last_modified: string;
+}
+
+export declare class StorageClient {
+  /**
+   * Upload a file to this project's storage bucket.
+   *
+   * Browser: pass a File or Blob (e.g. from <input type="file">)
+   * Node.js: pass a file path string, Buffer, or ReadStream
+   *          Requires the "form-data" package: npm install form-data
+   */
+  upload(
+    file: File | Blob | string | Buffer | ReadStream,
+    filename?: string
+  ): Promise<OpenbaseResponse<StorageFileInfo>>;
+
+  /**
+   * List all files in this project's storage bucket.
+   */
+  list(): Promise<OpenbaseResponse<StorageListItem[]>>;
+
+  /**
+   * Get a presigned URL for a file, valid for 7 days.
+   */
+  getUrl(filename: string): Promise<OpenbaseResponse<{ url: string }>>;
+
+  /**
+   * Delete a file from this project's storage bucket.
+   */
+  remove(filename: string): Promise<OpenbaseResponse<{ name: string }>>;
+}
+
 export declare class OpenbaseClient {
+  /** Storage client for file upload, listing, URLs, and deletion */
+  storage: StorageClient;
+
+  /** Query builder for database operations */
   from<T = Record<string, unknown>>(table: string): QueryBuilder<T>;
 }
 

package/index.js

@@ -6,9 +6,12 @@ class QueryBuilder {
     this._apiKey = apiKey;
     this._dbName = dbName;
     this._table = table;
-    this._filters = {};
+    this._filters = [];
     this._columns = '*';
     this._limitVal = null;
+    this._offsetVal = null;
+    this._orderCol = null;
+    this._orderAsc = true;
     this._single = false;
     this._operation = 'select';
     this._insertData = null;
@@ -21,8 +24,58 @@ class QueryBuilder {
     return this;
   }
 
+  // ─── Filter operators ──────────────────────────────────────────────────────
+
   eq(column, value) {
-    this._filters[column] = value;
+    this._filters.push({ col: column, op: 'eq', val: value });
+    return this;
+  }
+
+  gt(column, value) {
+    this._filters.push({ col: column, op: 'gt', val: value });
+    return this;
+  }
+
+  lt(column, value) {
+    this._filters.push({ col: column, op: 'lt', val: value });
+    return this;
+  }
+
+  gte(column, value) {
+    this._filters.push({ col: column, op: 'gte', val: value });
+    return this;
+  }
+
+  lte(column, value) {
+    this._filters.push({ col: column, op: 'lte', val: value });
+    return this;
+  }
+
+  like(column, pattern) {
+    this._filters.push({ col: column, op: 'like', val: pattern });
+    return this;
+  }
+
+  ilike(column, pattern) {
+    this._filters.push({ col: column, op: 'ilike', val: pattern });
+    return this;
+  }
+
+  in(column, values) {
+    this._filters.push({ col: column, op: 'in', val: values });
+    return this;
+  }
+
+  is(column, value) {
+    this._filters.push({ col: column, op: 'is', val: value });
+    return this;
+  }
+
+  // ─── Modifiers ─────────────────────────────────────────────────────────────
+
+  order(column, { ascending = true } = {}) {
+    this._orderCol = column;
+    this._orderAsc = ascending;
     return this;
   }
 
@@ -31,12 +84,20 @@ class QueryBuilder {
     return this;
   }
 
+  range(from, to) {
+    this._limitVal = to - from + 1;
+    this._offsetVal = from;
+    return this;
+  }
+
   single() {
     this._single = true;
     this._limitVal = 1;
     return this;
   }
 
+  // ─── Mutation operators ────────────────────────────────────────────────────
+
   insert(data) {
     this._operation = 'insert';
     this._insertData = data;
@@ -54,16 +115,46 @@ class QueryBuilder {
     return this;
   }
 
+  // ─── SQL Builder ───────────────────────────────────────────────────────────
+
+  _filterToSQL(f) {
+    const col = `"${f.col}"`;
+    switch (f.op) {
+      case 'eq': return typeof f.val === 'string' ? `${col} = '${f.val}'` : `${col} = ${f.val}`;
+      case 'gt': return `${col} > ${f.val}`;
+      case 'lt': return `${col} < ${f.val}`;
+      case 'gte': return `${col} >= ${f.val}`;
+      case 'lte': return `${col} <= ${f.val}`;
+      case 'like': return `${col} LIKE '${f.val}'`;
+      case 'ilike': return `${col} ILIKE '${f.val}'`;
+      case 'in': {
+        const list = f.val.map(v => typeof v === 'string' ? `'${v}'` : v).join(', ');
+        return `${col} IN (${list})`;
+      }
+      case 'is': {
+        if (f.val === null) return `${col} IS NULL`;
+        if (f.val === true) return `${col} IS TRUE`;
+        if (f.val === false) return `${col} IS FALSE`;
+        return `${col} IS NULL`;
+      }
+      default: return `${col} = '${f.val}'`;
+    }
+  }
+
   _buildSQL() {
     let sql = '';
 
     if (this._operation === 'select') {
       sql = `SELECT ${this._columns} FROM "${this._table}"`;
-      const whereParts = Object.entries(this._filters).map(([col, val]) =>
-        typeof val === 'string' ? `"${col}" = '${val}'` : `"${col}" = ${val}`
-      );
-      if (whereParts.length) sql += ` WHERE ${whereParts.join(' AND ')}`;
+      if (this._filters.length) {
+        const where = this._filters.map(f => this._filterToSQL(f)).join(' AND ');
+        sql += ` WHERE ${where}`;
+      }
+      if (this._orderCol) {
+        sql += ` ORDER BY "${this._orderCol}" ${this._orderAsc ? 'ASC' : 'DESC'}`;
+      }
       if (this._limitVal) sql += ` LIMIT ${this._limitVal}`;
+      if (this._offsetVal) sql += ` OFFSET ${this._offsetVal}`;
 
     } else if (this._operation === 'insert') {
       const cols = Object.keys(this._insertData).map(c => `"${c}"`).join(', ');
@@ -76,25 +167,27 @@ class QueryBuilder {
       const setClauses = Object.entries(this._updateData).map(([col, val]) =>
         typeof val === 'string' ? `"${col}" = '${val.replace(/'/g, "''")}'` : `"${col}" = ${val}`
       ).join(', ');
-      const whereParts = Object.entries(this._filters).map(([col, val]) =>
-        typeof val === 'string' ? `"${col}" = '${val}'` : `"${col}" = ${val}`
-      );
       sql = `UPDATE "${this._table}" SET ${setClauses}`;
-      if (whereParts.length) sql += ` WHERE ${whereParts.join(' AND ')}`;
+      if (this._filters.length) {
+        const where = this._filters.map(f => this._filterToSQL(f)).join(' AND ');
+        sql += ` WHERE ${where}`;
+      }
       sql += ` RETURNING *`;
 
     } else if (this._operation === 'delete') {
-      const whereParts = Object.entries(this._filters).map(([col, val]) =>
-        typeof val === 'string' ? `"${col}" = '${val}'` : `"${col}" = ${val}`
-      );
       sql = `DELETE FROM "${this._table}"`;
-      if (whereParts.length) sql += ` WHERE ${whereParts.join(' AND ')}`;
+      if (this._filters.length) {
+        const where = this._filters.map(f => this._filterToSQL(f)).join(' AND ');
+        sql += ` WHERE ${where}`;
+      }
       sql += ` RETURNING *`;
     }
 
     return sql;
   }
 
+  // ─── Executor ──────────────────────────────────────────────────────────────
+
   async _buildAndRun() {
     const sql = this._buildSQL();
     try {
@@ -122,6 +215,127 @@ class QueryBuilder {
   }
 }
 
+// ─── Storage Client ───────────────────────────────────────────────────────────
+
+class StorageClient {
+  constructor(baseUrl, apiKey, dbName) {
+    this._baseUrl = baseUrl;
+    this._apiKey = apiKey;
+    this._dbName = dbName;
+  }
+
+  _headers() {
+    return { 'Authorization': `Bearer ${this._apiKey}` };
+  }
+
+  // Detect if we're running in Node.js
+  _isNode() {
+    return typeof window === 'undefined' && typeof process !== 'undefined';
+  }
+
+  // Build a FormData object that works in both browser and Node.js
+  // In browser: file = File or Blob object
+  // In Node.js: file = file path string, Buffer, or ReadStream
+  async _buildFormData(file, filename) {
+    if (this._isNode()) {
+      // Node.js — use form-data package
+      let FormDataNode;
+      try {
+        FormDataNode = require('form-data');
+      } catch {
+        throw new Error(
+          '[openbase] In Node.js, storage.upload() requires the "form-data" package.\n' +
+          'Install it with: npm install form-data'
+        );
+      }
+
+      const fs = require('fs');
+      const path = require('path');
+      const formData = new FormDataNode();
+
+      if (typeof file === 'string') {
+        // file path string — read from disk
+        const resolvedName = filename || path.basename(file);
+        formData.append('file', fs.createReadStream(file), resolvedName);
+      } else if (Buffer.isBuffer(file)) {
+        // Buffer
+        formData.append('file', file, filename || 'file');
+      } else {
+        // ReadStream or anything else
+        formData.append('file', file, filename || 'file');
+      }
+
+      return formData;
+
+    } else {
+      // Browser — use native FormData
+      const formData = new FormData();
+      formData.append('file', file, filename || file.name);
+      return formData;
+    }
+  }
+
+  // Upload a file
+  // Browser: pass a File or Blob (from <input type="file"> or drag-and-drop)
+  // Node.js: pass a file path string, Buffer, or ReadStream
+  async upload(file, filename) {
+    try {
+      const formData = await this._buildFormData(file, filename);
+
+      // In Node.js, form-data needs its own headers (includes boundary)
+      const headers = this._isNode()
+        ? { ...this._headers(), ...formData.getHeaders() }
+        : this._headers();
+
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/upload`, {
+        method: 'POST',
+        headers,
+        body: formData,
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+
+  // List all files in this project's bucket
+  async list() {
+    try {
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/list`, {
+        headers: this._headers(),
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+
+  // Get a presigned URL valid for 7 days
+  async getUrl(filename) {
+    try {
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/url/${encodeURIComponent(filename)}`, {
+        headers: this._headers(),
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+
+  // Delete a file
+  async remove(filename) {
+    try {
+      const res = await fetch(`${this._baseUrl}/storage/${this._dbName}/${encodeURIComponent(filename)}`, {
+        method: 'DELETE',
+        headers: this._headers(),
+      });
+      return await res.json();
+    } catch (err) {
+      return { data: null, error: err.message };
+    }
+  }
+}
+
 // ─── Client ───────────────────────────────────────────────────────────────────
 
 class OpenbaseClient {
@@ -129,6 +343,7 @@ class OpenbaseClient {
     this._baseUrl = baseUrl.replace(/\/$/, '');
     this._apiKey = apiKey;
     this._dbName = dbName;
+    this.storage = new StorageClient(this._baseUrl, this._apiKey, this._dbName);
   }
 
   from(table) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openbase-js",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "JavaScript client for Openbase — a self-hosted Supabase alternative",
   "main": "index.js",
   "types": "index.d.ts",

package/test.js

@@ -43,4 +43,55 @@ async function test() {
   console.log('deleted:', deleted);
 }
 
-test().catch(console.error);
+async function testOperators() {
+  console.log('\n── GT / LT ─────────────────────────');
+  const { data: gt } = await client.from('leads').select('*').gt('id', 2);
+  console.log('gt id > 2:', gt);
+
+  console.log('\n── GTE / LTE ───────────────────────');
+  const { data: lte } = await client.from('leads').select('*').lte('id', 3);
+  console.log('lte id <= 3:', lte);
+
+  console.log('\n── LIKE ────────────────────────────');
+  const { data: like } = await client.from('leads').select('*').like('company_name', '%oo%');
+  console.log('like company_name %oo%:', like);
+
+  console.log('\n── ILIKE (case insensitive) ────────');
+  const { data: ilike } = await client.from('leads').select('*').ilike('company_name', '%google%');
+  console.log('ilike company_name %google%:', ilike);
+
+  console.log('\n── IN ──────────────────────────────');
+  const { data: inResult } = await client.from('leads').select('*').in('slug', ['google', 'meta']);
+  console.log('in slug [google, meta]:', inResult);
+
+  console.log('\n── IS NULL ─────────────────────────');
+  const { data: isNull } = await client.from('leads').select('*').is('custom_pitch', null);
+  console.log('is custom_pitch null:', isNull);
+
+  console.log('\n── ORDER ASC ───────────────────────');
+  const { data: asc } = await client.from('leads').select('*').order('id', { ascending: true });
+  console.log('order id asc:', asc?.map(r => r.id));
+
+  console.log('\n── ORDER DESC ──────────────────────');
+  const { data: desc } = await client.from('leads').select('*').order('id', { ascending: false });
+  console.log('order id desc:', desc?.map(r => r.id));
+
+  console.log('\n── LIMIT ───────────────────────────');
+  const { data: limited } = await client.from('leads').select('*').limit(2);
+  console.log('limit 2:', limited?.length, 'rows');
+
+  console.log('\n── RANGE (pagination) ──────────────');
+  const { data: page } = await client.from('leads').select('*').range(0, 1);
+  console.log('range 0-1:', page?.length, 'rows');
+
+  console.log('\n── CHAINED (gt + order + limit) ────');
+  const { data: chained } = await client
+    .from('leads')
+    .select('*')
+    .gt('id', 1)
+    .order('id', { ascending: false })
+    .limit(3);
+  console.log('chained:', chained);
+}
+
+testOperators().catch(console.error);