@ikeboy003/cloudrest-client 0.0.1 → 0.2.0

package/dist/rpc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,EAAE;AACF,sFAAsF;AACtF,EAAE;AACF,4BAA4B;AAC5B,qDAAqD;AACrD,qEAAqE;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,OAAO,SAAS;IAED;IACA;IACA;IAHnB,YACmB,GAAgB,EAChB,EAAU,EACV,OAAgC,EAAE;QAFlC,QAAG,GAAH,GAAG,CAAa;QAChB,OAAE,GAAF,EAAE,CAAQ;QACV,SAAI,GAAJ,IAAI,CAA8B;IAClD,CAAC;IAEI,KAAK,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,QAAQ,IAAI,CAAC,EAAE,EAAE,CAAC;QACjD,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;YAClC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO;SACpB,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC1C,IAAI,KAAK;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;QAExD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,sEAAsE;QACtE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,SAAmB,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI;YAAE,OAAO,SAAmB,CAAC;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAW,CAAC;IACpC,CAAC;IAED,IAAI,CACF,WAA8D,EAC9D,UAA+D;QAE/D,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAmB,CAAC,CAAC;IAC5D,CAAC;CACF"}
+{"version":3,"file":"rpc.js","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,0EAA0E;AAC1E,EAAE;AACF,sFAAsF;AACtF,EAAE;AACF,4BAA4B;AAC5B,qDAAqD;AACrD,qEAAqE;AAGrE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAEzC,MAAM,OAAO,SAAS;IAED;IACA;IACA;IAHnB,YACmB,GAAgB,EAChB,EAAU,EACV,OAAgC,EAAE;QAFlC,QAAG,GAAH,GAAG,CAAa;QAChB,OAAE,GAAF,EAAE,CAAQ;QACV,SAAI,GAAJ,IAAI,CAA8B;IAClD,CAAC;IAEI,KAAK,CAAC,IAAI;QAChB,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACxD,MAAM,OAAO,GAA2B;YACtC,MAAM,EAAE,kBAAkB;YAC1B,cAAc,EAAE,kBAAkB;YAClC,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO;SACpB,CAAC;QACF,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC;QAC1C,IAAI,KAAK;YAAE,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,KAAK,EAAE,CAAC;QAExD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE;YACpC,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;SAChC,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YAC9C,MAAM,IAAI,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC7D,CAAC;QAED,sEAAsE;QACtE,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;YAAE,OAAO,SAAmB,CAAC;QACnD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,CAAC,IAAI;YAAE,OAAO,SAAmB,CAAC;QACtC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAW,CAAC;IACpC,CAAC;IAED,IAAI,CACF,WAA8D,EAC9D,UAA+D;QAE/D,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,UAAmB,CAAC,CAAC;IAC5D,CAAC;CACF"}

package/dist/serialize.d.ts

@@ -1,2 +1,6 @@
+export declare function joinUrl(base: string, path: string): string;
 export declare function serializeValue(v: unknown): string;
+export declare function serializeListItem(v: unknown): string;
+export declare function serializeArray(v: readonly unknown[]): string;
+export declare function serializeRange(v: unknown): string;
 //# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAgBA,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAOjD"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAmBA,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAOjD;AAED,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAMpD;AAID,wBAAgB,cAAc,CAAC,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAE5D;AAKD,wBAAgB,cAAc,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAKjD"}

package/dist/serialize.js

@@ -12,6 +12,12 @@
 const SCALAR_SPECIAL = /[,"]/;
 // List items are inside `(a,b,c)`, so `(`, `)`, and `,` all need quoting.
 const LIST_SPECIAL = /[(),."]/;
+// Join the client baseUrl with a table/route, tolerant of trailing/leading
+// slashes on either side, so `baseUrl="http://h:3005"` + `table="catalog_public"`
+// (or "/catalog_public") both yield exactly one separating slash.
+export function joinUrl(base, path) {
+    return `${base.replace(/\/+$/, "")}/${String(path).replace(/^\/+/, "")}`;
+}
 export function serializeValue(v) {
     if (v === null || v === undefined)
         return "null";
@@ -25,7 +31,7 @@ export function serializeValue(v) {
         return String(v);
     return escapeIfNeeded(String(v), SCALAR_SPECIAL);
 }
-function serializeListItem(v) {
+export function serializeListItem(v) {
     if (v === null || v === undefined)
         return "null";
     if (v instanceof Date)
@@ -36,6 +42,20 @@ function serializeListItem(v) {
         return String(v);
     return escapeIfNeeded(String(v), LIST_SPECIAL);
 }
+// PostgreSQL array literal `{a,b,c}` — used by the array operators cs/cd/ov
+// (`tags=cs.{a,b}`). Distinct from the `(a,b)` list form used by `in`.
+export function serializeArray(v) {
+    return `{${v.map(serializeListItem).join(",")}}`;
+}
+// Range/value argument for the range operators (sl/sr/nxr/nxl/adj). Accepts a
+// ready-made literal (`"(1,10)"`, `"[2020-01-01,2020-12-31]"`) or a `[lo, hi]`
+// tuple → `(lo,hi)`.
+export function serializeRange(v) {
+    if (Array.isArray(v)) {
+        return `(${serializeListItem(v[0])},${serializeListItem(v[1])})`;
+    }
+    return String(v);
+}
 function escapeIfNeeded(s, special) {
     if (s === "")
         return '""';

package/dist/serialize.js.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,+DAA+D;AAC/D,EAAE;AACF,SAAS;AACT,0DAA0D;AAC1D,uBAAuB;AACvB,4EAA4E;AAC5E,0EAA0E;AAE1E,uEAAuE;AACvE,sEAAsE;AACtE,+CAA+C;AAC/C,MAAM,cAAc,GAAG,MAAM,CAAC;AAC9B,0EAA0E;AAC1E,MAAM,YAAY,GAAG,SAAS,CAAC;AAE/B,MAAM,UAAU,cAAc,CAAC,CAAU;IACvC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACjD,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvE,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACxD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,iBAAiB,CAAC,CAAU;IACnC,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IACjD,IAAI,CAAC,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;IACxD,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACrE,OAAO,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,cAAc,CAAC,CAAS,EAAE,OAAe;IAChD,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC1B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAC/B,OAAO,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,GAAG,CAAC;AAC9D,CAAC"}
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -9,7 +9,7 @@ export type RowOf<P extends AnyPaths, T extends keyof P> = P[T] extends {
             };
         };
     };
-} ? Body extends ReadonlyArray<infer Item> ? Item : Body : never;
+} ? Body extends ReadonlyArray<infer Item> ? Item : Body : Record<string, unknown>;
 export type TableName<P extends AnyPaths> = Extract<keyof P, string>;
 export type TokenGetter = () => string | null | Promise<string | null>;
 export interface ClientOptions {

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAK3C,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,MAAM,CAAC,IACrD,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,SAAS,EAAE;YAAE,GAAG,EAAE;gBAAE,OAAO,EAAE;oBAAE,kBAAkB,EAAE,MAAM,IAAI,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,GACzF,IAAI,SAAS,aAAa,CAAC,MAAM,IAAI,CAAC,GACpC,IAAI,GACJ,IAAI,GACN,KAAK,CAAC;AAGZ,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAGrE,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAK3C,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,QAAQ,EAAE,CAAC,SAAS,MAAM,CAAC,IACrD,CAAC,CAAC,CAAC,CAAC,SAAS;IAAE,GAAG,EAAE;QAAE,SAAS,EAAE;YAAE,GAAG,EAAE;gBAAE,OAAO,EAAE;oBAAE,kBAAkB,EAAE,MAAM,IAAI,CAAA;iBAAE,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,GACzF,IAAI,SAAS,aAAa,CAAC,MAAM,IAAI,CAAC,GACpC,IAAI,GACJ,IAAI,GAGN,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAG9B,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAGrE,MAAM,MAAM,WAAW,GAAG,MAAM,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAEvE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikeboy003/cloudrest-client",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Typed query builder for cloudrest. PostgREST-grammar compatible.",
   "type": "module",
   "main": "./dist/index.js",
@@ -11,15 +11,21 @@
       "import": "./dist/index.js"
     }
   },
-  "files": ["dist", "src", "README.md"],
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "dev": "tsc -p tsconfig.json --watch"
+    "build": "tsc -p tsconfig.json && tsc-alias -p tsconfig.json",
+    "dev": "tsc -p tsconfig.json --watch",
+    "test": "node --test test/*.test.mjs"
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
+    "tsc-alias": "^1.8.17",
     "typescript": "^5.5.0"
   }
 }

package/src/client.ts

@@ -1,7 +1,16 @@
-import type { AnyPaths, ClientOptions, RowOf, TableName } from "./types.js";
-import { QueryBuilder, type ExecContext } from "./query.js";
-import { InsertBuilder, UpdateBuilder, DeleteBuilder } from "./mutation.js";
-import { RpcCaller } from "./rpc.js";
+import type { AnyPaths, ClientOptions, RowOf, TableName } from "@/types.js";
+import { QueryBuilder, type ExecContext } from "@/query.js";
+import { InsertBuilder, UpdateBuilder, DeleteBuilder } from "@/mutation.js";
+import { RpcCaller } from "@/rpc.js";
+
+export interface CopyOptions {
+  /** Target columns, in body order. Required (maps to `?columns=`). */
+  columns: string[];
+  /** Schema the table lives in (default "public"). */
+  schema?: string;
+  /** Wire format of `body` (default "csv"). NDJSON is transcoded server-side. */
+  format?: "csv" | "ndjson";
+}
 
 export class CloudRestClient<P extends AnyPaths> {
   private readonly ctx: ExecContext;
@@ -50,6 +59,42 @@ export class CloudRestClient<P extends AnyPaths> {
   ): RpcCaller<Result> {
     return new RpcCaller<Result>(this.ctx, fn, args);
   }
+
+  /**
+   * Bulk-ingest via the server's COPY endpoint
+   * (`POST /_copy/{schema}/{table}?columns=`). `body` is CSV (with a header row)
+   * or NDJSON. Streams straight into `COPY` — far faster than row-by-row
+   * inserts for large loads. Resolves to `{ inserted: N }`.
+   */
+  async copy(
+    table: TableName<P>,
+    body: string | Uint8Array,
+    opts: CopyOptions,
+  ): Promise<{ inserted: number }> {
+    const schema = opts.schema ?? "public";
+    const cols = opts.columns.map(encodeURIComponent).join(",");
+    const url = `${this.ctx.baseUrl}/_copy/${schema}/${String(table)}?columns=${cols}`;
+    const headers: Record<string, string> = {
+      Accept: "application/json",
+      "Content-Type":
+        opts.format === "ndjson" ? "application/x-ndjson" : "text/csv",
+      ...this.ctx.headers,
+    };
+    const token = await this.ctx.getToken?.();
+    if (token) headers["Authorization"] = `Bearer ${token}`;
+
+    const res = await this.ctx.fetch(url, {
+      method: "POST",
+      headers,
+      body: body as BodyInit,
+    });
+    if (!res.ok) {
+      const errBody = await res.json().catch(() => null);
+      const { CloudRestError } = await import("@/errors.js");
+      throw new CloudRestError(res.status, res.statusText, errBody);
+    }
+    return (await res.json()) as { inserted: number };
+  }
 }
 
 export function createClient<P extends AnyPaths>(opts: ClientOptions): CloudRestClient<P> {

package/src/filter.ts

@@ -1,50 +1,100 @@
-// Filter ops — v0 covers the 80% of queries: equality, comparison, set membership,
-// null checks, pattern match. Composite ops (or, and, fts, jsonpath) come later.
+// Filter ops — the full PostgREST operator set + nestable and/or/not logic.
 //
-// Each filter contributes one entry to URLSearchParams as `column=op.value`.
+// Each filter contributes one entry. A leaf renders as `column=op.value`; a
+// logic group renders as `and=(child,child)` / `or=(...)`. As a CHILD inside a
+// group, a leaf re-spells to `column.op.value` and a group to `and(...)`/`or(...)`,
+// which is how PostgREST nests them.
 
-import { serializeValue } from "./serialize.js";
+import { serializeValue, serializeArray, serializeRange } from "@/serialize.js";
 
 export type IsValue = "null" | "true" | "false" | "unknown";
 
 export interface FilterEntry {
+  /** Leaf: the column. Group: "and" | "or". */
   column: string;
+  /** Leaf: "op.value". Group: "(child,child,...)". */
   expr: string;
+  /** True for a logic group (and/or), so child-rendering omits the dot. */
+  group?: boolean;
 }
 
-export function fEq(column: string, value: unknown): FilterEntry {
-  return { column, expr: `eq.${serializeValue(value)}` };
-}
-export function fNeq(column: string, value: unknown): FilterEntry {
-  return { column, expr: `neq.${serializeValue(value)}` };
-}
-export function fGt(column: string, value: unknown): FilterEntry {
-  return { column, expr: `gt.${serializeValue(value)}` };
-}
-export function fGte(column: string, value: unknown): FilterEntry {
-  return { column, expr: `gte.${serializeValue(value)}` };
-}
-export function fLt(column: string, value: unknown): FilterEntry {
-  return { column, expr: `lt.${serializeValue(value)}` };
-}
-export function fLte(column: string, value: unknown): FilterEntry {
-  return { column, expr: `lte.${serializeValue(value)}` };
-}
-export function fLike(column: string, pattern: string): FilterEntry {
-  return { column, expr: `like.${serializeValue(pattern)}` };
-}
-export function fIlike(column: string, pattern: string): FilterEntry {
-  return { column, expr: `ilike.${serializeValue(pattern)}` };
+const leaf = (column: string, expr: string): FilterEntry => ({ column, expr });
+
+// ── comparison / equality ───────────────────────────────────────────────────
+export const fEq = (c: string, v: unknown): FilterEntry => leaf(c, `eq.${serializeValue(v)}`);
+export const fNeq = (c: string, v: unknown): FilterEntry => leaf(c, `neq.${serializeValue(v)}`);
+export const fGt = (c: string, v: unknown): FilterEntry => leaf(c, `gt.${serializeValue(v)}`);
+export const fGte = (c: string, v: unknown): FilterEntry => leaf(c, `gte.${serializeValue(v)}`);
+export const fLt = (c: string, v: unknown): FilterEntry => leaf(c, `lt.${serializeValue(v)}`);
+export const fLte = (c: string, v: unknown): FilterEntry => leaf(c, `lte.${serializeValue(v)}`);
+
+// ── pattern match ───────────────────────────────────────────────────────────
+export const fLike = (c: string, p: string): FilterEntry => leaf(c, `like.${serializeValue(p)}`);
+export const fIlike = (c: string, p: string): FilterEntry => leaf(c, `ilike.${serializeValue(p)}`);
+/** POSIX regex (`~`). */
+export const fMatch = (c: string, p: string): FilterEntry => leaf(c, `match.${serializeValue(p)}`);
+/** Case-insensitive POSIX regex (`~*`). */
+export const fImatch = (c: string, p: string): FilterEntry => leaf(c, `imatch.${serializeValue(p)}`);
+
+// ── set membership / null / distinct ────────────────────────────────────────
+export const fIn = (c: string, vals: readonly unknown[]): FilterEntry => leaf(c, `in.${serializeValue(vals)}`);
+// `is` is the correct NULL / boolean check — `eq.null` is a SQL no-op.
+export const fIs = (c: string, v: IsValue): FilterEntry => leaf(c, `is.${v}`);
+/** `IS DISTINCT FROM` — null-safe inequality. */
+export const fIsDistinct = (c: string, v: unknown): FilterEntry => leaf(c, `isdistinct.${serializeValue(v)}`);
+
+// ── full-text search ────────────────────────────────────────────────────────
+// Optional text-search config (e.g. "english") rides in parens: `fts(english).query`.
+const ftsOp = (op: string) => (c: string, query: string, config?: string): FilterEntry =>
+  leaf(c, config ? `${op}(${config}).${serializeValue(query)}` : `${op}.${serializeValue(query)}`);
+/** `to_tsquery` full-text search. */
+export const fFts = ftsOp("fts");
+/** `plainto_tsquery`. */
+export const fPlfts = ftsOp("plfts");
+/** `phraseto_tsquery`. */
+export const fPhfts = ftsOp("phfts");
+/** `websearch_to_tsquery`. */
+export const fWfts = ftsOp("wfts");
+
+// ── array / range containment + adjacency ───────────────────────────────────
+/** contains `@>` (array/range/jsonb). */
+export const fCs = (c: string, v: readonly unknown[]): FilterEntry => leaf(c, `cs.${serializeArray(v)}`);
+/** contained-in `<@`. */
+export const fCd = (c: string, v: readonly unknown[]): FilterEntry => leaf(c, `cd.${serializeArray(v)}`);
+/** overlap `&&` (array or range). */
+export const fOv = (c: string, v: readonly unknown[] | string): FilterEntry =>
+  leaf(c, `ov.${Array.isArray(v) ? serializeArray(v) : serializeRange(v)}`);
+/** strictly-left-of `<<`. */
+export const fSl = (c: string, range: unknown): FilterEntry => leaf(c, `sl.${serializeRange(range)}`);
+/** strictly-right-of `>>`. */
+export const fSr = (c: string, range: unknown): FilterEntry => leaf(c, `sr.${serializeRange(range)}`);
+/** does-not-extend-to-the-right-of `&<`. */
+export const fNxr = (c: string, range: unknown): FilterEntry => leaf(c, `nxr.${serializeRange(range)}`);
+/** does-not-extend-to-the-left-of `&>`. */
+export const fNxl = (c: string, range: unknown): FilterEntry => leaf(c, `nxl.${serializeRange(range)}`);
+/** adjacent `-|-`. */
+export const fAdj = (c: string, range: unknown): FilterEntry => leaf(c, `adj.${serializeRange(range)}`);
+
+// ── generic escape hatch ────────────────────────────────────────────────────
+/** Any operator + already-serialized value, e.g. `fFilter("data->>k", "eq", "x")`. */
+export const fFilter = (c: string, op: string, value: string): FilterEntry => leaf(c, `${op}.${value}`);
+
+// ── negation + logic groups (nestable) ──────────────────────────────────────
+/** Negate any single-op filter: `column=not.is.null`, `column=not.eq.5`. */
+export function fNot(entry: FilterEntry): FilterEntry {
+  return { column: entry.column, expr: `not.${entry.expr}` };
 }
-export function fIn(column: string, values: readonly unknown[]): FilterEntry {
-  return { column, expr: `in.${serializeValue(values)}` };
+
+/** Render an entry as a CHILD inside a logic group. */
+function renderChild(e: FilterEntry): string {
+  return e.group ? `${e.column}${e.expr}` : `${e.column}.${e.expr}`;
 }
-// `is` is the correct way to check NULL / boolean — `eq.null` is a no-op in SQL.
-export function fIs(column: string, value: IsValue): FilterEntry {
-  return { column, expr: `is.${value}` };
+
+/** Composite AND — `and=(a.eq.1,b.gt.2)`. Children may be leaves or groups (nests). */
+export function fAnd(entries: readonly FilterEntry[]): FilterEntry {
+  return { column: "and", expr: `(${entries.map(renderChild).join(",")})`, group: true };
 }
-// Negate any single-op filter: PostgREST prefixes the operator with `not.`
-// e.g. `column=not.is.null`, `column=not.eq.5`.
-export function fNot(entry: FilterEntry): FilterEntry {
-  return { column: entry.column, expr: `not.${entry.expr}` };
+/** Composite OR — `or=(a.eq.1,b.gt.2)`. Children may be leaves or groups (nests). */
+export function fOr(entries: readonly FilterEntry[]): FilterEntry {
+  return { column: "or", expr: `(${entries.map(renderChild).join(",")})`, group: true };
 }

package/src/index.ts

@@ -1,14 +1,32 @@
-export { createClient, CloudRestClient } from "./client.js";
-export { CloudRestError } from "./errors.js";
-export { QueryBuilder } from "./query.js";
-export { InsertBuilder, UpdateBuilder, DeleteBuilder } from "./mutation.js";
-export { RpcCaller } from "./rpc.js";
+export { createClient, CloudRestClient } from "@/client.js";
+export type { CopyOptions } from "@/client.js";
+export { CloudRestError } from "@/errors.js";
+export { QueryBuilder } from "@/query.js";
+export type { OrderOptions, CountStrategy, SingleQuery, PagedQuery } from "@/query.js";
+export { InsertBuilder, UpdateBuilder, DeleteBuilder } from "@/mutation.js";
+export { RpcCaller } from "@/rpc.js";
 export type {
   AnyPaths,
   ClientOptions,
   RowOf,
   TableName,
   TokenGetter,
-} from "./types.js";
-export type { OrderOptions } from "./query.js";
-export type { IsValue } from "./filter.js";
+} from "@/types.js";
+export type { IsValue, FilterEntry } from "@/filter.js";
+
+// Bare condition builders for composing `.and(...)` / `.or(...)` (nestable).
+//   db.from("books").or(cond.ilike("title","*x*"), cond.ilike("author","*x*"))
+//   db.from("books").and(cond.gte("year",2000), cond.or(cond.eq("a",1), cond.eq("b",2)))
+import * as F from "@/filter.js";
+import type { FilterEntry } from "@/filter.js";
+export const cond = {
+  eq: F.fEq, neq: F.fNeq, gt: F.fGt, gte: F.fGte, lt: F.fLt, lte: F.fLte,
+  like: F.fLike, ilike: F.fIlike, match: F.fMatch, imatch: F.fImatch,
+  in: F.fIn, is: F.fIs, isDistinct: F.fIsDistinct,
+  fts: F.fFts, plfts: F.fPlfts, phfts: F.fPhfts, wfts: F.fWfts,
+  cs: F.fCs, cd: F.fCd, ov: F.fOv, sl: F.fSl, sr: F.fSr, nxr: F.fNxr, nxl: F.fNxl, adj: F.fAdj,
+  filter: F.fFilter, not: F.fNot,
+  // Variadic so they compose ergonomically + nest: cond.and(cond.eq(..), cond.or(..)).
+  and: (...e: FilterEntry[]): FilterEntry => F.fAnd(e),
+  or: (...e: FilterEntry[]): FilterEntry => F.fOr(e),
+} as const;