@ikeboy003/cloudrest-client 0.1.0 → 0.2.0

package/dist/client.d.ts

@@ -2,6 +2,14 @@ import type { AnyPaths, ClientOptions, RowOf, TableName } from "./types.js";
 import { QueryBuilder } 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 declare class CloudRestClient<P extends AnyPaths> {
     private readonly ctx;
     constructor(opts: ClientOptions);
@@ -15,6 +23,15 @@ export declare class CloudRestClient<P extends AnyPaths> {
     delete<T extends TableName<P>>(table: T): DeleteBuilder<P, T>;
     /** Call a Postgres function via `POST /rpc/<fn>`. Awaitable. */
     rpc<Result = unknown>(fn: string, args?: Record<string, unknown>): RpcCaller<Result>;
+    /**
+     * 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 }`.
+     */
+    copy(table: TableName<P>, body: string | Uint8Array, opts: CopyOptions): Promise<{
+        inserted: number;
+    }>;
 }
 export declare function createClient<P extends AnyPaths>(opts: ClientOptions): CloudRestClient<P>;
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,qBAAa,eAAe,CAAC,CAAC,SAAS,QAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEtB,IAAI,EAAE,aAAa;IAW/B,gDAAgD;IAChD,IAAI,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAI1D,qFAAqF;IACrF,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAClD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAItB,0DAA0D;IAC1D,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAItB,0DAA0D;IAC1D,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAI7D,gEAAgE;IAChE,GAAG,CAAC,MAAM,GAAG,OAAO,EAClB,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,SAAS,CAAC,MAAM,CAAC;CAGrB;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,CAExF"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,qEAAqE;IACrE,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,MAAM,CAAC,EAAE,KAAK,GAAG,QAAQ,CAAC;CAC3B;AAED,qBAAa,eAAe,CAAC,CAAC,SAAS,QAAQ;IAC7C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;gBAEtB,IAAI,EAAE,aAAa;IAW/B,gDAAgD;IAChD,IAAI,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;IAI1D,qFAAqF;IACrF,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAClD,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAItB,0DAA0D;IAC1D,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAC3B,KAAK,EAAE,CAAC,EACR,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAItB,0DAA0D;IAC1D,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;IAI7D,gEAAgE;IAChE,GAAG,CAAC,MAAM,GAAG,OAAO,EAClB,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,SAAS,CAAC,MAAM,CAAC;IAIpB;;;;;OAKG;IACG,IAAI,CACR,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,EACnB,IAAI,EAAE,MAAM,GAAG,UAAU,EACzB,IAAI,EAAE,WAAW,GAChB,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAyBjC;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,QAAQ,EAAE,IAAI,EAAE,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,CAExF"}

package/dist/client.js

@@ -33,6 +33,36 @@ export class CloudRestClient {
     rpc(fn, args = {}) {
         return new RpcCaller(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, body, opts) {
+        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 = {
+            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,
+        });
+        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());
+    }
 }
 export function createClient(opts) {
     return new CloudRestClient(opts);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAoB,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,MAAM,OAAO,eAAe;IACT,GAAG,CAAc;IAElC,YAAY,IAAmB;QAC7B,uEAAuE;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,CAAC,GAAG,GAAG;YACT,OAAO;YACP,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;YACtD,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;SAC5B,CAAC;IACJ,CAAC;IAED,gDAAgD;IAChD,IAAI,CAAyB,KAAQ;QACnC,OAAO,IAAI,YAAY,CAAO,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,qFAAqF;IACrF,MAAM,CACJ,KAAQ,EACR,IAAmD;QAEnD,OAAO,IAAI,aAAa,CAAO,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACxD,CAAC;IAED,0DAA0D;IAC1D,MAAM,CACJ,KAAQ,EACR,KAA2B;QAE3B,OAAO,IAAI,aAAa,CAAO,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;IACzD,CAAC;IAED,0DAA0D;IAC1D,MAAM,CAAyB,KAAQ;QACrC,OAAO,IAAI,aAAa,CAAO,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAClD,CAAC;IAED,gEAAgE;IAChE,GAAG,CACD,EAAU,EACV,OAAgC,EAAE;QAElC,OAAO,IAAI,SAAS,CAAS,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IACnD,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAqB,IAAmB;IAClE,OAAO,IAAI,eAAe,CAAI,IAAI,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/filter.d.ts

@@ -1,18 +1,58 @@
 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 declare function fEq(column: string, value: unknown): FilterEntry;
-export declare function fNeq(column: string, value: unknown): FilterEntry;
-export declare function fGt(column: string, value: unknown): FilterEntry;
-export declare function fGte(column: string, value: unknown): FilterEntry;
-export declare function fLt(column: string, value: unknown): FilterEntry;
-export declare function fLte(column: string, value: unknown): FilterEntry;
-export declare function fLike(column: string, pattern: string): FilterEntry;
-export declare function fIlike(column: string, pattern: string): FilterEntry;
-export declare function fIn(column: string, values: readonly unknown[]): FilterEntry;
-export declare function fIs(column: string, value: IsValue): FilterEntry;
+export declare const fEq: (c: string, v: unknown) => FilterEntry;
+export declare const fNeq: (c: string, v: unknown) => FilterEntry;
+export declare const fGt: (c: string, v: unknown) => FilterEntry;
+export declare const fGte: (c: string, v: unknown) => FilterEntry;
+export declare const fLt: (c: string, v: unknown) => FilterEntry;
+export declare const fLte: (c: string, v: unknown) => FilterEntry;
+export declare const fLike: (c: string, p: string) => FilterEntry;
+export declare const fIlike: (c: string, p: string) => FilterEntry;
+/** POSIX regex (`~`). */
+export declare const fMatch: (c: string, p: string) => FilterEntry;
+/** Case-insensitive POSIX regex (`~*`). */
+export declare const fImatch: (c: string, p: string) => FilterEntry;
+export declare const fIn: (c: string, vals: readonly unknown[]) => FilterEntry;
+export declare const fIs: (c: string, v: IsValue) => FilterEntry;
+/** `IS DISTINCT FROM` — null-safe inequality. */
+export declare const fIsDistinct: (c: string, v: unknown) => FilterEntry;
+/** `to_tsquery` full-text search. */
+export declare const fFts: (c: string, query: string, config?: string) => FilterEntry;
+/** `plainto_tsquery`. */
+export declare const fPlfts: (c: string, query: string, config?: string) => FilterEntry;
+/** `phraseto_tsquery`. */
+export declare const fPhfts: (c: string, query: string, config?: string) => FilterEntry;
+/** `websearch_to_tsquery`. */
+export declare const fWfts: (c: string, query: string, config?: string) => FilterEntry;
+/** contains `@>` (array/range/jsonb). */
+export declare const fCs: (c: string, v: readonly unknown[]) => FilterEntry;
+/** contained-in `<@`. */
+export declare const fCd: (c: string, v: readonly unknown[]) => FilterEntry;
+/** overlap `&&` (array or range). */
+export declare const fOv: (c: string, v: readonly unknown[] | string) => FilterEntry;
+/** strictly-left-of `<<`. */
+export declare const fSl: (c: string, range: unknown) => FilterEntry;
+/** strictly-right-of `>>`. */
+export declare const fSr: (c: string, range: unknown) => FilterEntry;
+/** does-not-extend-to-the-right-of `&<`. */
+export declare const fNxr: (c: string, range: unknown) => FilterEntry;
+/** does-not-extend-to-the-left-of `&>`. */
+export declare const fNxl: (c: string, range: unknown) => FilterEntry;
+/** adjacent `-|-`. */
+export declare const fAdj: (c: string, range: unknown) => FilterEntry;
+/** Any operator + already-serialized value, e.g. `fFilter("data->>k", "eq", "x")`. */
+export declare const fFilter: (c: string, op: string, value: string) => FilterEntry;
+/** Negate any single-op filter: `column=not.is.null`, `column=not.eq.5`. */
 export declare function fNot(entry: FilterEntry): FilterEntry;
+/** Composite AND — `and=(a.eq.1,b.gt.2)`. Children may be leaves or groups (nests). */
+export declare function fAnd(entries: readonly FilterEntry[]): FilterEntry;
+/** Composite OR — `or=(a.eq.1,b.gt.2)`. Children may be leaves or groups (nests). */
 export declare function fOr(entries: readonly FilterEntry[]): FilterEntry;
 //# sourceMappingURL=filter.d.ts.map

package/dist/filter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;AAE5D,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAE/D;AACD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAEhE;AACD,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAE/D;AACD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAEhE;AACD,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAE/D;AACD,wBAAgB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAEhE;AACD,wBAAgB,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAElE;AACD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,WAAW,CAEnE;AACD,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,OAAO,EAAE,GAAG,WAAW,CAE3E;AAED,wBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,WAAW,CAE/D;AAGD,wBAAgB,IAAI,CAAC,KAAK,EAAE,WAAW,GAAG,WAAW,CAEpD;AAID,wBAAgB,GAAG,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,GAAG,WAAW,CAGhE"}
+{"version":3,"file":"filter.d.ts","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"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"}

package/dist/filter.js

@@ -1,49 +1,77 @@
-// Filter ops — equality, comparison, set membership, null checks, pattern match,
-// plus the `or` composite. (`and`, `fts`, `jsonpath` still to come.)
+// Filter ops — the full PostgREST operator set + nestable and/or/not logic.
 //
-// Each filter contributes one entry to URLSearchParams as `column=op.value`.
-import { serializeValue } from "./serialize.js";
-export function fEq(column, value) {
-    return { column, expr: `eq.${serializeValue(value)}` };
-}
-export function fNeq(column, value) {
-    return { column, expr: `neq.${serializeValue(value)}` };
-}
-export function fGt(column, value) {
-    return { column, expr: `gt.${serializeValue(value)}` };
-}
-export function fGte(column, value) {
-    return { column, expr: `gte.${serializeValue(value)}` };
-}
-export function fLt(column, value) {
-    return { column, expr: `lt.${serializeValue(value)}` };
-}
-export function fLte(column, value) {
-    return { column, expr: `lte.${serializeValue(value)}` };
-}
-export function fLike(column, pattern) {
-    return { column, expr: `like.${serializeValue(pattern)}` };
-}
-export function fIlike(column, pattern) {
-    return { column, expr: `ilike.${serializeValue(pattern)}` };
-}
-export function fIn(column, values) {
-    return { column, expr: `in.${serializeValue(values)}` };
-}
-// `is` is the correct way to check NULL / boolean — `eq.null` is a no-op in SQL.
-export function fIs(column, value) {
-    return { column, expr: `is.${value}` };
-}
-// Negate any single-op filter: PostgREST prefixes the operator with `not.`
-// e.g. `column=not.is.null`, `column=not.eq.5`.
+// 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, serializeArray, serializeRange } from "./serialize.js";
+const leaf = (column, expr) => ({ column, expr });
+// ── comparison / equality ───────────────────────────────────────────────────
+export const fEq = (c, v) => leaf(c, `eq.${serializeValue(v)}`);
+export const fNeq = (c, v) => leaf(c, `neq.${serializeValue(v)}`);
+export const fGt = (c, v) => leaf(c, `gt.${serializeValue(v)}`);
+export const fGte = (c, v) => leaf(c, `gte.${serializeValue(v)}`);
+export const fLt = (c, v) => leaf(c, `lt.${serializeValue(v)}`);
+export const fLte = (c, v) => leaf(c, `lte.${serializeValue(v)}`);
+// ── pattern match ───────────────────────────────────────────────────────────
+export const fLike = (c, p) => leaf(c, `like.${serializeValue(p)}`);
+export const fIlike = (c, p) => leaf(c, `ilike.${serializeValue(p)}`);
+/** POSIX regex (`~`). */
+export const fMatch = (c, p) => leaf(c, `match.${serializeValue(p)}`);
+/** Case-insensitive POSIX regex (`~*`). */
+export const fImatch = (c, p) => leaf(c, `imatch.${serializeValue(p)}`);
+// ── set membership / null / distinct ────────────────────────────────────────
+export const fIn = (c, vals) => leaf(c, `in.${serializeValue(vals)}`);
+// `is` is the correct NULL / boolean check — `eq.null` is a SQL no-op.
+export const fIs = (c, v) => leaf(c, `is.${v}`);
+/** `IS DISTINCT FROM` — null-safe inequality. */
+export const fIsDistinct = (c, v) => leaf(c, `isdistinct.${serializeValue(v)}`);
+// ── full-text search ────────────────────────────────────────────────────────
+// Optional text-search config (e.g. "english") rides in parens: `fts(english).query`.
+const ftsOp = (op) => (c, query, config) => 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, v) => leaf(c, `cs.${serializeArray(v)}`);
+/** contained-in `<@`. */
+export const fCd = (c, v) => leaf(c, `cd.${serializeArray(v)}`);
+/** overlap `&&` (array or range). */
+export const fOv = (c, v) => leaf(c, `ov.${Array.isArray(v) ? serializeArray(v) : serializeRange(v)}`);
+/** strictly-left-of `<<`. */
+export const fSl = (c, range) => leaf(c, `sl.${serializeRange(range)}`);
+/** strictly-right-of `>>`. */
+export const fSr = (c, range) => leaf(c, `sr.${serializeRange(range)}`);
+/** does-not-extend-to-the-right-of `&<`. */
+export const fNxr = (c, range) => leaf(c, `nxr.${serializeRange(range)}`);
+/** does-not-extend-to-the-left-of `&>`. */
+export const fNxl = (c, range) => leaf(c, `nxl.${serializeRange(range)}`);
+/** adjacent `-|-`. */
+export const fAdj = (c, range) => leaf(c, `adj.${serializeRange(range)}`);
+// ── generic escape hatch ────────────────────────────────────────────────────
+/** Any operator + already-serialized value, e.g. `fFilter("data->>k", "eq", "x")`. */
+export const fFilter = (c, op, value) => 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) {
     return { column: entry.column, expr: `not.${entry.expr}` };
 }
-// Composite OR: `or=(title.ilike.*x*,author.ilike.*x*)`. Each child is a normal
-// FilterEntry (`column` + `op.value`) re-spelled in the dotted inner grammar
-// `column.op.value`. Compose children from the same f* helpers above.
+/** Render an entry as a CHILD inside a logic group. */
+function renderChild(e) {
+    return e.group ? `${e.column}${e.expr}` : `${e.column}.${e.expr}`;
+}
+/** Composite AND — `and=(a.eq.1,b.gt.2)`. Children may be leaves or groups (nests). */
+export function fAnd(entries) {
+    return { column: "and", expr: `(${entries.map(renderChild).join(",")})`, group: true };
+}
+/** Composite OR — `or=(a.eq.1,b.gt.2)`. Children may be leaves or groups (nests). */
 export function fOr(entries) {
-    const inner = entries.map((e) => `${e.column}.${e.expr}`).join(",");
-    return { column: "or", expr: `(${inner})` };
+    return { column: "or", expr: `(${entries.map(renderChild).join(",")})`, group: true };
 }
 //# sourceMappingURL=filter.js.map

package/dist/filter.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,qEAAqE;AACrE,EAAE;AACF,6EAA6E;AAE7E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAShD,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,KAAc;IAChD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AACzD,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,KAAc;IACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AAC1D,CAAC;AACD,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,KAAc;IAChD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AACzD,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,KAAc;IACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AAC1D,CAAC;AACD,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,KAAc;IAChD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AACzD,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,MAAc,EAAE,KAAc;IACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;AAC1D,CAAC;AACD,MAAM,UAAU,KAAK,CAAC,MAAc,EAAE,OAAe;IACnD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;AAC7D,CAAC;AACD,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,OAAe;IACpD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,cAAc,CAAC,OAAO,CAAC,EAAE,EAAE,CAAC;AAC9D,CAAC;AACD,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,MAA0B;IAC5D,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;AAC1D,CAAC;AACD,iFAAiF;AACjF,MAAM,UAAU,GAAG,CAAC,MAAc,EAAE,KAAc;IAChD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,EAAE,EAAE,CAAC;AACzC,CAAC;AACD,2EAA2E;AAC3E,gDAAgD;AAChD,MAAM,UAAU,IAAI,CAAC,KAAkB;IACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;AAC7D,CAAC;AACD,gFAAgF;AAChF,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,UAAU,GAAG,CAAC,OAA+B;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACpE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,KAAK,GAAG,EAAE,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"filter.js","sourceRoot":"","sources":["../src/filter.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,4EAA4E;AAC5E,+EAA+E;AAC/E,oFAAoF;AACpF,qCAAqC;AAErC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAahF,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,IAAY,EAAe,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAE/E,+EAA+E;AAC/E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAChG,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC9F,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAEhG,+EAA+E;AAC/E,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,CAAS,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACjG,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnG,yBAAyB;AACzB,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,CAAS,EAAE,CAAS,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACnG,2CAA2C;AAC3C,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,CAAS,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,UAAU,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAErG,+EAA+E;AAC/E,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,IAAwB,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC/G,uEAAuE;AACvE,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;AAC9E,iDAAiD;AACjD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAS,EAAE,CAAU,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,cAAc,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAE9G,+EAA+E;AAC/E,sFAAsF;AACtF,MAAM,KAAK,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,CAAC,CAAS,EAAE,KAAa,EAAE,MAAe,EAAe,EAAE,CACvF,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,KAAK,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACnG,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;AACjC,yBAAyB;AACzB,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AACrC,0BAA0B;AAC1B,MAAM,CAAC,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;AACrC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;AAEnC,+EAA+E;AAC/E,yCAAyC;AACzC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAqB,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACzG,yBAAyB;AACzB,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAAqB,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AACzG,qCAAqC;AACrC,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,CAA8B,EAAe,EAAE,CAC5E,IAAI,CAAC,CAAC,EAAE,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;AAC5E,6BAA6B;AAC7B,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,KAAc,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACtG,8BAA8B;AAC9B,MAAM,CAAC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAE,KAAc,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACtG,4CAA4C;AAC5C,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,KAAc,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxG,2CAA2C;AAC3C,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,KAAc,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AACxG,sBAAsB;AACtB,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,KAAc,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAExG,+EAA+E;AAC/E,sFAAsF;AACtF,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAU,EAAE,KAAa,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,IAAI,KAAK,EAAE,CAAC,CAAC;AAExG,+EAA+E;AAC/E,4EAA4E;AAC5E,MAAM,UAAU,IAAI,CAAC,KAAkB;IACrC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;AAC7D,CAAC;AAED,uDAAuD;AACvD,SAAS,WAAW,CAAC,CAAc;IACjC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,IAAI,CAAC,OAA+B;IAClD,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzF,CAAC;AACD,qFAAqF;AACrF,MAAM,UAAU,GAAG,CAAC,OAA+B;IACjD,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACxF,CAAC"}

package/dist/index.d.ts

@@ -1,23 +1,43 @@
 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, SingleQuery, PagedQuery } from "./query.js";
 export type { IsValue, FilterEntry } from "./filter.js";
-import { fEq, fNeq, fGt, fGte, fLt, fLte, fLike, fIlike, fIn, fIs, fNot } from "./filter.js";
+import * as F from "./filter.js";
+import type { FilterEntry } from "./filter.js";
 export declare const cond: {
-    readonly eq: typeof fEq;
-    readonly neq: typeof fNeq;
-    readonly gt: typeof fGt;
-    readonly gte: typeof fGte;
-    readonly lt: typeof fLt;
-    readonly lte: typeof fLte;
-    readonly like: typeof fLike;
-    readonly ilike: typeof fIlike;
-    readonly in: typeof fIn;
-    readonly is: typeof fIs;
-    readonly not: typeof fNot;
+    readonly eq: (c: string, v: unknown) => FilterEntry;
+    readonly neq: (c: string, v: unknown) => FilterEntry;
+    readonly gt: (c: string, v: unknown) => FilterEntry;
+    readonly gte: (c: string, v: unknown) => FilterEntry;
+    readonly lt: (c: string, v: unknown) => FilterEntry;
+    readonly lte: (c: string, v: unknown) => FilterEntry;
+    readonly like: (c: string, p: string) => FilterEntry;
+    readonly ilike: (c: string, p: string) => FilterEntry;
+    readonly match: (c: string, p: string) => FilterEntry;
+    readonly imatch: (c: string, p: string) => FilterEntry;
+    readonly in: (c: string, vals: readonly unknown[]) => FilterEntry;
+    readonly is: (c: string, v: F.IsValue) => FilterEntry;
+    readonly isDistinct: (c: string, v: unknown) => FilterEntry;
+    readonly fts: (c: string, query: string, config?: string) => FilterEntry;
+    readonly plfts: (c: string, query: string, config?: string) => FilterEntry;
+    readonly phfts: (c: string, query: string, config?: string) => FilterEntry;
+    readonly wfts: (c: string, query: string, config?: string) => FilterEntry;
+    readonly cs: (c: string, v: readonly unknown[]) => FilterEntry;
+    readonly cd: (c: string, v: readonly unknown[]) => FilterEntry;
+    readonly ov: (c: string, v: readonly unknown[] | string) => FilterEntry;
+    readonly sl: (c: string, range: unknown) => FilterEntry;
+    readonly sr: (c: string, range: unknown) => FilterEntry;
+    readonly nxr: (c: string, range: unknown) => FilterEntry;
+    readonly nxl: (c: string, range: unknown) => FilterEntry;
+    readonly adj: (c: string, range: unknown) => FilterEntry;
+    readonly filter: (c: string, op: string, value: string) => FilterEntry;
+    readonly not: typeof F.fNot;
+    readonly and: (...e: FilterEntry[]) => FilterEntry;
+    readonly or: (...e: FilterEntry[]) => FilterEntry;
 };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EACV,QAAQ,EACR,aAAa,EACb,KAAK,EACL,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAIxD,OAAO,EACL,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAC/D,MAAM,aAAa,CAAC;AACrB,eAAO,MAAM,IAAI;;;;;;;;;;;;CAGP,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EACV,QAAQ,EACR,aAAa,EACb,KAAK,EACL,SAAS,EACT,WAAW,GACZ,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAKxD,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AACjC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,eAAO,MAAM,IAAI;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAQH,WAAW,EAAE,KAAG,WAAW;wBAC5B,WAAW,EAAE,KAAG,WAAW;CAC9B,CAAC"}

package/dist/index.js

@@ -3,11 +3,19 @@ export { CloudRestError } from "./errors.js";
 export { QueryBuilder } from "./query.js";
 export { InsertBuilder, UpdateBuilder, DeleteBuilder } from "./mutation.js";
 export { RpcCaller } from "./rpc.js";
-// Bare condition builders for composing `.or(...)`. Each returns a FilterEntry:
-//   db.from("catalog_public").or(cond.ilike("title","*x*"), cond.ilike("author","*x*"))
-import { fEq, fNeq, fGt, fGte, fLt, fLte, fLike, fIlike, fIn, fIs, fNot, } 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";
 export const cond = {
-    eq: fEq, neq: fNeq, gt: fGt, gte: fGte, lt: fLt, lte: fLte,
-    like: fLike, ilike: fIlike, in: fIn, is: fIs, not: fNot,
+    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) => F.fAnd(e),
+    or: (...e) => F.fOr(e),
 };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAWrC,gFAAgF;AAChF,wFAAwF;AACxF,OAAO,EACL,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,GAC/D,MAAM,aAAa,CAAC;AACrB,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI;IAC1D,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI;CAC/C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE5D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAUrC,6EAA6E;AAC7E,+EAA+E;AAC/E,yFAAyF;AACzF,OAAO,KAAK,CAAC,MAAM,aAAa,CAAC;AAEjC,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI;IACtE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO;IAClE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,EAAE,CAAC,CAAC,WAAW;IAC/C,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK;IAC5D,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI;IAC5F,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,IAAI;IAC9B,qFAAqF;IACrF,GAAG,EAAE,CAAC,GAAG,CAAgB,EAAe,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,EAAE,EAAE,CAAC,GAAG,CAAgB,EAAe,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CAC1C,CAAC"}

package/dist/mutation.d.ts

@@ -1,36 +1,92 @@
 import type { AnyPaths, RowOf, TableName } from "./types.js";
-import { type FilterEntry, type IsValue } from "./filter.js";
+import type { FilterEntry, IsValue } from "./filter.js";
 import type { ExecContext } from "./query.js";
-declare class FilterableMutation<Row> {
+declare abstract class WriteTuning<Row> {
+    protected returnMode?: "representation" | "minimal";
+    protected txMode?: "rollback" | "commit";
+    protected maxAff?: number;
+    protected minAff?: number;
+    protected tz?: string;
+    protected bufferedFlag: boolean;
+    protected missingMode?: "default" | "null";
+    protected resolution?: "merge-duplicates" | "ignore-duplicates";
+    /** Return affected rows (adds Prefer: return=representation). */
+    returning(): this;
+    /** No body back (Prefer: return=minimal) — the default if unset. */
+    minimal(): this;
+    /** Dry-run: run + roll back (Prefer: tx=rollback). */
+    dryRun(): this;
+    /** Fail (PGRST) if more than N rows would be affected. */
+    maxAffected(n: number): this;
+    /** Fail if fewer than N rows are affected. */
+    minAffected(n: number): this;
+    /** Render timestamptz output in this zone (Prefer: timezone=<tz>). */
+    timezone(tz: string): this;
+    /** Buffer the response + set Content-Length (Prefer: response-buffered). */
+    buffered(): this;
+    protected prefer(): string[];
+}
+declare abstract class FilterableMutation<Row> extends WriteTuning<Row> {
     protected filters: FilterEntry[];
-    eq(col: string, v: unknown): this;
-    neq(col: string, v: unknown): this;
-    gt(col: string, v: unknown): this;
-    gte(col: string, v: unknown): this;
-    lt(col: string, v: unknown): this;
-    lte(col: string, v: unknown): this;
-    like(col: string, pat: string): this;
-    ilike(col: string, pat: string): this;
-    in(col: string, vals: readonly unknown[]): this;
-    is(col: string, v: IsValue): this;
+    eq(c: string, v: unknown): this;
+    neq(c: string, v: unknown): this;
+    gt(c: string, v: unknown): this;
+    gte(c: string, v: unknown): this;
+    lt(c: string, v: unknown): this;
+    lte(c: string, v: unknown): this;
+    like(c: string, p: string): this;
+    ilike(c: string, p: string): this;
+    match(c: string, p: string): this;
+    imatch(c: string, p: string): this;
+    in(c: string, vals: readonly unknown[]): this;
+    is(c: string, v: IsValue): this;
+    isDistinct(c: string, v: unknown): this;
+    fts(c: string, q: string, cfg?: string): this;
+    plfts(c: string, q: string, cfg?: string): this;
+    phfts(c: string, q: string, cfg?: string): this;
+    wfts(c: string, q: string, cfg?: string): this;
+    cs(c: string, vals: readonly unknown[]): this;
+    cd(c: string, vals: readonly unknown[]): this;
+    ov(c: string, v: readonly unknown[] | string): this;
+    sl(c: string, r: unknown): this;
+    sr(c: string, r: unknown): this;
+    nxr(c: string, r: unknown): this;
+    nxl(c: string, r: unknown): this;
+    adj(c: string, r: unknown): this;
+    not(entry: FilterEntry): this;
+    notIs(c: string, v: IsValue): this;
+    filter(c: string, op: string, value: string): this;
+    and(...entries: FilterEntry[]): this;
+    or(...entries: FilterEntry[]): this;
+    protected filterQs(): string;
 }
-export declare class InsertBuilder<P extends AnyPaths, T extends TableName<P>, Row = RowOf<P, T>> implements PromiseLike<Row[]> {
+export declare class InsertBuilder<P extends AnyPaths, T extends TableName<P>, Row = RowOf<P, T>> extends WriteTuning<Row> implements PromiseLike<Row[]> {
     private readonly ctx;
     private readonly table;
     private rows;
-    private returnRows;
     private files;
+    private onConflictCols?;
+    private columnsList?;
     constructor(ctx: ExecContext, table: T, rows: Partial<Row> | Partial<Row>[]);
-    /** Return inserted rows (adds Prefer: return=representation). */
-    returning(): this;
     /**
-     * Attach a file for a media column. Switches the insert to a multipart
-     * write: the row's scalar columns ride as a `payload` JSON part and each
-     * file as a part named after its column. The server's media stage stores
-     * the bytes and puts a reference in the column. Single-row inserts only.
+     * Upsert on conflict of `columns` (a PK/unique set). Default resolution
+     * merges (UPDATE); pass `{ ignoreDuplicates: true }` for DO NOTHING.
+     */
+    onConflict(columns: string | string[], opts?: {
+        ignoreDuplicates?: boolean;
+    }): this;
+    /** Restrict the insert to these columns (`?columns=`) — consistent bulk keys. */
+    columns(cols: string[]): this;
+    /** Treat keys absent from a row as `NULL` rather than the column default. */
+    missing(mode: "default" | "null"): this;
+    /**
+     * Attach a file for a media column — switches to a multipart write (scalar
+     * columns as a JSON `payload` part, each file as a part named after its
+     * column). The server's media stage stores bytes → reference into the column.
+     * Single-row inserts only.
      */
     attach(column: string, file: Blob): this;
-    private hasFiles;
+    private buildUrl;
     private formBody;
     then<R1 = Row[], R2 = never>(onfulfilled?: ((value: Row[]) => R1 | PromiseLike<R1>) | null, onrejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2>;
 }
@@ -38,18 +94,14 @@ export declare class UpdateBuilder<P extends AnyPaths, T extends TableName<P>, R
     private readonly ctx;
     private readonly table;
     private readonly patch;
-    private returnRows;
     constructor(ctx: ExecContext, table: T, patch: Partial<Row>);
-    returning(): this;
     private url;
     then<R1 = Row[], R2 = never>(onfulfilled?: ((value: Row[]) => R1 | PromiseLike<R1>) | null, onrejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2>;
 }
 export declare class DeleteBuilder<P extends AnyPaths, T extends TableName<P>, Row = RowOf<P, T>> extends FilterableMutation<Row> implements PromiseLike<Row[]> {
     private readonly ctx;
     private readonly table;
-    private returnRows;
     constructor(ctx: ExecContext, table: T);
-    returning(): this;
     private url;
     then<R1 = Row[], R2 = never>(onfulfilled?: ((value: Row[]) => R1 | PromiseLike<R1>) | null, onrejected?: ((reason: unknown) => R2 | PromiseLike<R2>) | null): PromiseLike<R1 | R2>;
 }

package/dist/mutation.d.ts.map

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