prest-js-sdk 0.2.0

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,366 @@
+/**
+ * prest-js-sdk
+ *
+ * TypeScript SDK for pREST (PostgreSQL REST API). Provides route-shaped methods
+ * for catalog/CRUD/stored-queries plus a typed filter DSL that serializes to
+ * pREST's `?field=op.value` URL syntax.
+ *
+ * Usage:
+ *   import { PrestClient } from "prest-js-sdk";
+ *
+ *   const client = new PrestClient("http://localhost:3000");
+ *
+ *   // Catalog
+ *   const dbs = await client.databases();
+ *
+ *   // Query with typed filter
+ *   const rows = await client.select<Balance>("yarsew", "public", "billing_balances", {
+ *     where: { actor_id: { eq: 42 }, status: "active" },
+ *     select: ["id", "balance"],
+ *     order: ["balance:desc"],
+ *     limit: 10,
+ *   });
+ *
+ *   // Insert
+ *   const [row] = await client.insert<Balance>("yarsew", "public", "billing_balances", {
+ *     actor_id: 42, balance: 100.50, status: "active",
+ *   });
+ *
+ *   // Update (filter + new values)
+ *   const updated = await client.update<Balance>(
+ *     "yarsew", "public", "billing_balances",
+ *     { actor_id: 42 },
+ *     { status: "frozen" },
+ *   );
+ *
+ *   // Delete
+ *   await client.delete("yarsew", "public", "billing_balances", { actor_id: 42 });
+ *
+ *   // Stored SQL (prest/etc/queries/reports/top_balances.sql)
+ *   const top = await client.query<Balance>("reports", "top_balances", { min: 1000 });
+ *
+ *   // Forward-compat Kratos auth (works once [auth.kratos] is wired into prest)
+ *   const authed = await PrestClient.fromKratosSession(
+ *     "http://localhost:4433",
+ *     "http://localhost:3000",
+ *   );
+ */
+export class PrestApiError extends Error {
+    status;
+    body;
+    constructor(status, message, body) {
+        super(`[${status}] ${message}`);
+        this.status = status;
+        this.body = body;
+        this.name = "PrestApiError";
+    }
+}
+// ============================================================
+// Filter serializer (the heart of the DSL)
+// ============================================================
+const VALUELESS_OPS = new Set([
+    "null", "notnull", "true", "nottrue", "false", "notfalse",
+]);
+const ARRAY_OPS = new Set(["in", "nin", "any", "some", "all"]);
+function serializeOpValue(op, val) {
+    if (VALUELESS_OPS.has(op)) {
+        return op; // ?field=null
+    }
+    if (ARRAY_OPS.has(op)) {
+        const arr = Array.isArray(val) ? val : val === undefined ? [] : [val];
+        return `${op}.(${arr.join(",")})`;
+    }
+    const v = val === undefined ? "" : typeof val === "string" ? val : String(val);
+    return `${op}.${v}`;
+}
+/**
+ * Serialize a Filter into pREST URL query params.
+ *
+ * Each field becomes one or more entries: `field=op.value`. Multiple ops on the
+ * same field are emitted as repeated query params (pREST AND-s them).
+ *
+ * @example
+ *   serializeFilter({ actor_id: 42 })
+ *   // → "actor_id=eq.42"
+ *   serializeFilter({ age: { gt: 30 }, name: { like: "foo%" } })
+ *   // → "age=gt.30&name=like.foo%25"
+ *   serializeFilter({ id: { in: [1, 2, 3] }, status: null })
+ *   // → "id=in.(1,2,3)&status=null"
+ */
+export function serializeFilter(filter) {
+    const params = new URLSearchParams();
+    for (const [field, condition] of Object.entries(filter)) {
+        if (condition === null || condition === undefined) {
+            params.append(field, "null");
+            continue;
+        }
+        if (typeof condition === "object" && !Array.isArray(condition)) {
+            for (const [op, val] of Object.entries(condition)) {
+                params.append(field, serializeOpValue(op, val));
+            }
+            continue;
+        }
+        // Primitive shorthand
+        if (typeof condition === "boolean") {
+            params.append(field, condition ? "true" : "false");
+        }
+        else {
+            params.append(field, `eq.${condition}`);
+        }
+    }
+    return params;
+}
+/**
+ * Serialize full SelectOpts into URLSearchParams (filter + modifiers).
+ */
+export function serializeSelectOpts(opts) {
+    const params = opts.where ? serializeFilter(opts.where) : new URLSearchParams();
+    if (opts.select?.length)
+        params.set("_select", opts.select.join(","));
+    if (opts.order?.length)
+        params.set("_order", opts.order.join(","));
+    if (opts.distinct)
+        params.set("_distinct", "true");
+    if (opts.count)
+        params.set("_count", "true");
+    if (opts.countFirst)
+        params.set("_count_first", "true");
+    if (opts.groupBy?.length)
+        params.set("_groupby", opts.groupBy.join(","));
+    if (opts.returning?.length)
+        params.set("_returning", opts.returning.join(","));
+    if (opts.or?.length) {
+        // pREST format: _or=field=op.value,field=op.value
+        const parts = [];
+        for (const f of opts.or) {
+            const fp = serializeFilter(f);
+            fp.forEach((v, k) => parts.push(`${k}=${v}`));
+        }
+        params.set("_or", parts.join(","));
+    }
+    if (opts.page !== undefined)
+        params.set("_page", String(opts.page));
+    if (opts.size !== undefined)
+        params.set("_size", String(opts.size));
+    if (opts.limit !== undefined)
+        params.set("_limit", String(opts.limit));
+    if (opts.offset !== undefined)
+        params.set("_offset", String(opts.offset));
+    return params;
+}
+// ============================================================
+// PrestClient
+// ============================================================
+export class PrestClient {
+    prestUrl;
+    authHeader;
+    extraHeaders;
+    constructor(config) {
+        if (typeof config === "string") {
+            // Shortcut: new PrestClient(url, authToken?)
+            this.prestUrl = config.replace(/\/+$/, "");
+            const token = arguments[1];
+            this.authHeader = token ? `Bearer ${token}` : undefined;
+            this.extraHeaders = {};
+        }
+        else {
+            this.prestUrl = config.prestUrl.replace(/\/+$/, "");
+            this.authHeader =
+                config.rawAuthHeader ??
+                    (config.authToken ? `Bearer ${config.authToken}` : undefined);
+            this.extraHeaders = { ...(config.headers ?? {}) };
+        }
+    }
+    /**
+     * Forward-compat factory: validate a Kratos session and build a PrestClient.
+     *
+     * The vanilla pREST submodule does not yet wire Kratos (the planned
+     * `[auth.kratos]` middleware is documented in the parent project's CLAUDE.md
+     * but not merged into the submodule). This helper validates the session
+     * against Kratos and stores it as a Bearer header, so it will Just Work
+     * once the integration lands. Today it's useful if you're running a patched
+     * prest build with Kratos auth.
+     *
+     * @param kratosUrl - Kratos public URL, e.g. http://localhost:4433
+     * @param prestUrl - pREST base URL, defaults to http://localhost:3000
+     * @param sessionToken - Optional token. Reads `ory_kratos_session` cookie if omitted (browser).
+     * @returns PrestClient, or null if no valid session was found.
+     */
+    static async fromKratosSession(kratosUrl, prestUrl = "http://localhost:3000", sessionToken) {
+        const token = sessionToken ??
+            (typeof document !== "undefined" ? readCookie("ory_kratos_session") : undefined);
+        if (!token)
+            return null;
+        const valid = await validateKratosSession(kratosUrl, token);
+        if (!valid)
+            return null;
+        return new PrestClient({ prestUrl, authToken: token });
+    }
+    /**
+     * Set or replace the auth token after construction.
+     * Useful after calling `login()`. Returns `this` for chaining.
+     */
+    setAuthToken(token) {
+        this.authHeader = `Bearer ${token}`;
+        return this;
+    }
+    // ─── Low-level request helper ────────────────────────────────────────────
+    /**
+     * Escape hatch for endpoints not covered by the typed methods.
+     * Throws PrestApiError on non-2xx.
+     */
+    async request(method, path, init) {
+        const url = new URL(`${path.startsWith("/") ? "" : "/"}${path}`, this.prestUrl);
+        if (init?.params) {
+            init.params.forEach((v, k) => url.searchParams.append(k, v));
+        }
+        const res = await fetch(url.toString(), {
+            method,
+            headers: {
+                Accept: "application/json",
+                ...(this.authHeader ? { Authorization: this.authHeader } : {}),
+                ...this.extraHeaders,
+                ...(init?.body && !(init.body instanceof FormData)
+                    ? { "Content-Type": "application/json" }
+                    : {}),
+                ...init?.headers,
+            },
+            body: init?.body ?? null,
+            redirect: "manual",
+        });
+        const text = await res.text();
+        let body = null;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                body = text;
+            }
+        }
+        if (!res.ok) {
+            const msg = (body && typeof body === "object" && "error" in body
+                ? String(body.error)
+                : res.statusText) || `HTTP ${res.status}`;
+            throw new PrestApiError(res.status, msg, body);
+        }
+        return body;
+    }
+    // ─── Catalog ─────────────────────────────────────────────────────────────
+    /** `GET /databases` — list database names. */
+    databases() {
+        return this.request("GET", "/databases");
+    }
+    /** `GET /schemas` — list schema names. */
+    schemas() {
+        return this.request("GET", "/schemas");
+    }
+    /** `GET /tables` — list table names. */
+    tables() {
+        return this.request("GET", "/tables");
+    }
+    /** `GET /{database}/{schema}` — list tables in a specific database/schema. */
+    tablesIn(database, schema) {
+        return this.request("GET", `/${encodeURIComponent(database)}/${encodeURIComponent(schema)}`);
+    }
+    /** `GET /show/{database}/{schema}/{table}` — table description / columns. */
+    showTable(database, schema, table) {
+        return this.request("GET", `/show/${encodeURIComponent(database)}/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`);
+    }
+    // ─── CRUD ────────────────────────────────────────────────────────────────
+    /** `GET /{db}/{schema}/{table}` — SELECT with typed filter DSL. */
+    select(database, schema, table, opts = {}) {
+        const params = serializeSelectOpts(opts);
+        return this.request("GET", `/${encodeURIComponent(database)}/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`, { params });
+    }
+    /** `POST /{db}/{schema}/{table}` — insert a single row. */
+    insert(database, schema, table, data) {
+        return this.request("POST", `/${encodeURIComponent(database)}/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`, { body: JSON.stringify(data) });
+    }
+    /** `POST /batch/{db}/{schema}/{table}` — insert multiple rows in one call. */
+    insertBatch(database, schema, table, rows) {
+        return this.request("POST", `/batch/${encodeURIComponent(database)}/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`, { body: JSON.stringify(rows) });
+    }
+    /** `PUT /{db}/{schema}/{table}?filter` — update rows matching filter. */
+    update(database, schema, table, where, data) {
+        const params = serializeFilter(where);
+        return this.request("PUT", `/${encodeURIComponent(database)}/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`, { body: JSON.stringify(data), params });
+    }
+    /** `DELETE /{db}/{schema}/{table}?filter` — delete rows matching filter. */
+    delete(database, schema, table, where) {
+        const params = serializeFilter(where);
+        return this.request("DELETE", `/${encodeURIComponent(database)}/${encodeURIComponent(schema)}/${encodeURIComponent(table)}`, { params });
+    }
+    // ─── Stored queries ──────────────────────────────────────────────────────
+    /**
+     * Execute a stored SQL script: `GET /_QUERIES/{location}/{script}`.
+     *
+     * Scripts live in `<prest queries dir>/<location>/<script>.sql` and can
+     * reference params as `{{ sqlVal "key" }}` / `{{ sqlList "key" }}` in
+     * pREST's template syntax.
+     *
+     * @param location - Folder name under prest's `queries` directory.
+     * @param script - `.sql` filename without the extension.
+     * @param params - Rendered as URL query params; accessible in the SQL template.
+     */
+    query(location, script, params = {}) {
+        const qs = new URLSearchParams();
+        for (const [k, v] of Object.entries(params))
+            qs.set(k, String(v));
+        return this.request("GET", `/_QUERIES/${encodeURIComponent(location)}/${encodeURIComponent(script)}`, { params: qs });
+    }
+    // ─── Health & auth ───────────────────────────────────────────────────────
+    /** `GET /_health` — returns true on 2xx, false otherwise. */
+    async health() {
+        try {
+            await this.request("GET", "/_health");
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * `POST /auth` — exchange username/password for a JWT.
+     * Stores the returned token and attaches it as `Authorization: Bearer <token>`
+     * on subsequent requests.
+     *
+     * Only works when pREST's `[auth]` block is enabled in `prest.toml`.
+     * Returns the token string.
+     */
+    async login(username, password) {
+        const res = await this.request("POST", "/auth", {
+            body: JSON.stringify({ username, password }),
+        });
+        const token = res.token;
+        if (!token) {
+            throw new PrestApiError(200, "auth response missing 'token' field", res);
+        }
+        this.setAuthToken(token);
+        return token;
+    }
+}
+// ============================================================
+// Helpers (Kratos session validation — mirrors alist-kratos-sdk)
+// ============================================================
+function readCookie(name) {
+    if (typeof document === "undefined")
+        return undefined;
+    const match = document.cookie.match(new RegExp("(?:^|; )" + name + "=([^;]*)"));
+    return match ? decodeURIComponent(match[1]) : undefined;
+}
+async function validateKratosSession(kratosUrl, token) {
+    try {
+        const res = await fetch(`${kratosUrl.replace(/\/+$/, "")}/sessions/whoami`, {
+            headers: { "X-Session-Token": token, Accept: "application/json" },
+        });
+        if (!res.ok)
+            return false;
+        const session = (await res.json());
+        return session.active === true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/examples/filters.mjs

@@ -0,0 +1,131 @@
+// Verifies that serializeFilter and serializeSelectOpts produce the exact URL
+// param strings pREST's `WhereByRequest` parser expects.
+//
+// Run: npm run build && node examples/filters.mjs
+// Exits non-zero on first mismatch.
+//
+// Note: the test imports the compiled JS from dist/, so build first.
+
+import assert from "node:assert";
+import { serializeFilter, serializeSelectOpts } from "../dist/index.js";
+
+let passed = 0;
+function check(name, got, want) {
+  assert.strictEqual(got, want, `${name}\n  got:  ${got}\n  want: ${want}`);
+  passed++;
+  console.log(`  ✓ ${name}`);
+}
+
+console.log("serializeFilter");
+
+// Shorthand scalar → eq.
+check(
+  "scalar number shorthand",
+  serializeFilter({ actor_id: 42 }).toString(),
+  "actor_id=eq.42",
+);
+
+check(
+  "scalar string shorthand",
+  serializeFilter({ name: "alice" }).toString(),
+  "name=eq.alice",
+);
+
+// Explicit operators
+check(
+  "gt operator",
+  serializeFilter({ age: { gt: 30 } }).toString(),
+  "age=gt.30",
+);
+
+check(
+  "gte operator",
+  serializeFilter({ age: { gte: 30 } }).toString(),
+  "age=gte.30",
+);
+
+check(
+  "like operator (URL-encoded %)",
+  serializeFilter({ name: { like: "foo%" } }).toString(),
+  "name=like.foo%25",
+);
+
+// Array operator
+check(
+  "in operator (parens, comma-separated)",
+  serializeFilter({ id: { in: [1, 2, 3] } }).toString(),
+  "id=in.%281%2C2%2C3%29", // URLSearchParams encodes ( ) ,
+);
+
+// Null / boolean shortcuts
+check(
+  "null shorthand → IS NULL",
+  serializeFilter({ deleted_at: null }).toString(),
+  "deleted_at=null",
+);
+
+check(
+  "boolean true → IS TRUE",
+  serializeFilter({ is_active: true }).toString(),
+  "is_active=true",
+);
+
+check(
+  "boolean false → IS FALSE",
+  serializeFilter({ is_active: false }).toString(),
+  "is_active=false",
+);
+
+// Multiple fields → AND-ed (separate params)
+check(
+  "multi-field AND",
+  serializeFilter({ actor_id: 42, status: { eq: "active" } }).toString(),
+  "actor_id=eq.42&status=eq.active",
+);
+
+console.log();
+console.log("serializeSelectOpts");
+
+check(
+  "select + order + pagination",
+  serializeSelectOpts({
+    where: { actor_id: 42 },
+    select: ["id", "amount"],
+    order: ["amount:desc"],
+    page: 1,
+    size: 20,
+  }).toString(),
+  "actor_id=eq.42&_select=id%2Camount&_order=amount%3Adesc&_page=1&_size=20",
+);
+
+check(
+  "distinct + count",
+  serializeSelectOpts({ distinct: true, count: true }).toString(),
+  "_distinct=true&_count=true",
+);
+
+check(
+  "limit/offset pagination",
+  serializeSelectOpts({ limit: 10, offset: 30 }).toString(),
+  "_limit=10&_offset=30",
+);
+
+check(
+  "groupBy + returning",
+  serializeSelectOpts({
+    groupBy: ["actor_id"],
+    returning: ["id", "amount"],
+  }).toString(),
+  "_groupby=actor_id&_returning=id%2Camount",
+);
+
+check(
+  "or clauses",
+  serializeSelectOpts({
+    or: [{ status: "active" }, { amount: { gt: 1000 } }],
+  }).toString(),
+  "_or=status%3Deq.active%2Camount%3Dgt.1000",
+);
+
+console.log();
+console.log(`All ${passed} checks passed.`);

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "prest-js-sdk",
+  "version": "0.2.0",
+  "description": "TypeScript SDK for pREST (PostgreSQL REST API) with typed filter DSL and optional Kratos auth",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build",
+    "changeset": "changeset",
+    "version-packages": "changeset version",
+    "release": "npm run build && changeset publish"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.27.10",
+    "typescript": "^5.7.2"
+  }
+}