Installation & quick start

npm install querypipe
# or
pnpm add querypipe
yarn add querypipe
bun add querypipe

import { createQuery, numberField, stringField, dateField, enumField, isOk } from "querypipe";

const products = createQuery({
  fields: {
    id: numberField(),
    name: stringField(),
    price: numberField(),
    category: enumField(["phone", "laptop", "tablet"]),
    deletedAt: dateField(),
  },
  stableBy: "id",                    // deterministic tie-breaker, injected at execution time
  guards: { maxSortColumns: 3 },     // backend-safe by default
});

// Client — immutable fluent builder, progressive sorting
const q = products
  .filter("price", "between", [1000, 5000])
  .filter("deletedAt", "isNull")
  .sort("price", "desc")
  .thenSort("name");                 // refines, never destroys, the existing order

q.stringify();
// "sort=price:desc,name:asc&filter=price:between:1000,5000;deletedAt:isNull"

declare const rows: Array<{ id: number; name: string; price: number }>;
q.apply(rows);                       // non-mutating, stable, SQL ORDER BY-equivalent

// Server — untrusted input, never throws
const parsed = products.parse("sort=price:desc&filter=deletedAt:isNull");
if (!isOk(parsed)) {
  console.log(parsed.errors);        // structured, machine-readable, all at once
}