@burojs/pocketbase 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Maksim Kuznetsov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,51 @@
+# @burojs/pocketbase
+
+A [PocketBase](https://pocketbase.io/) data provider and auth provider for
+[buro](https://github.com/buro/buro).
+
+## Install
+
+```bash
+pnpm add @burojs/pocketbase @burojs/core
+```
+
+## Usage
+
+```ts
+import { createPocketbaseAuthProvider, createPocketbaseDataProvider } from '@burojs/pocketbase';
+
+const authProvider = createPocketbaseAuthProvider({ baseUrl: pbUrl });
+
+const dataProvider = createPocketbaseDataProvider({
+  baseUrl: pbUrl,
+  getToken: authProvider.getToken,
+});
+```
+
+### `createPocketbaseDataProvider({ baseUrl, getToken, fetchImpl? })`
+
+A `DataProvider` over PocketBase's REST API: `list`/`one`/`many` queries and
+`createOne`/`updateOne`/`deleteOne` mutations. Portable filter and sort
+descriptors are translated to PocketBase's own filter string syntax; offset
+pagination only — cursor pagination is refused with a `capability` error.
+`filterExpression` (the filter-string translator) is also exported on its own,
+for callers that need to build the same string without the rest of the
+provider. It returns `undefined` for a filter that **matches every record** —
+send no `filter` argument for that — and a real expression string for
+everything else, including a filter that matches nothing. A branchless
+combinator (`{and: []}`, `{or: []}`) and an empty-set test (`in: []`,
+`hasAny: []`, `notIn: []`, `hasAll: []`) carry truth values and are folded, not
+dropped; PocketBase's grammar has no boolean literal, so the one constant that
+survives folding — FALSE — is emitted as the contradiction `(id="" && id!="")`.
+
+### `createPocketbaseAuthProvider({ baseUrl, fetchImpl?, storageKey? })`
+
+Password auth against a PocketBase `users` collection, with the session kept
+in `localStorage`. Returns an `AuthProvider` plus a `getToken(): string | null`
+escape hatch, which is how the data provider above learns the current token.
+Deliberately small: this exists to demonstrate the data/auth provider ports,
+not to be a complete auth reference.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,302 @@
+'use strict';
+
+var core = require('@burojs/core');
+
+// src/data-provider.ts
+function lit(value) {
+  return `"${String(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+var FILTER_OPERATOR_UNSUPPORTED_CODE = "filter-operator-unsupported";
+function unsupportedOperator(field, op) {
+  return {
+    kind: "capability",
+    code: FILTER_OPERATOR_UNSUPPORTED_CODE,
+    message: `@burojs/pocketbase does not support the filter operator '${op}' (on '${field}').`
+  };
+}
+var DROP = { kind: "drop" };
+var constant = (value) => ({ kind: "const", value });
+var MATCHES_NO_RECORD = '(id="" && id!="")';
+function combine(branches, op) {
+  if (branches.length === 0) return constant(op === "and");
+  const absorbing = op === "or";
+  const nodes = branches.map(translateFilter);
+  if (nodes.some((node) => node.kind === "const" && node.value === absorbing)) {
+    return constant(absorbing);
+  }
+  const parts = nodes.flatMap((node) => node.kind === "expr" ? [node.text] : []);
+  if (parts.length > 0)
+    return { kind: "expr", text: `(${parts.join(op === "and" ? " && " : " || ")})` };
+  return nodes.some((node) => node.kind === "const") ? constant(!absorbing) : DROP;
+}
+function translateFilter(filter) {
+  if (filter === null || typeof filter !== "object") return DROP;
+  const candidate = filter;
+  if (Array.isArray(candidate.and)) return combine(candidate.and, "and");
+  if (Array.isArray(candidate.or)) return combine(candidate.or, "or");
+  if ("not" in candidate) {
+    const inner = translateFilter(candidate.not);
+    if (inner.kind === "drop") return DROP;
+    if (inner.kind === "const") return constant(!inner.value);
+    return { kind: "expr", text: `!(${inner.text})` };
+  }
+  if (typeof candidate.field !== "string" || typeof candidate.op !== "string") return DROP;
+  const { field, op, value } = candidate;
+  if (op === "isNull") return { kind: "expr", text: `${field}=null` };
+  if (op === "isNotNull") return { kind: "expr", text: `${field}!=null` };
+  if (!("value" in candidate) || value === void 0) return DROP;
+  const chain = (join, term, empty) => {
+    if (!Array.isArray(value)) return DROP;
+    if (value.length === 0) return constant(empty);
+    return { kind: "expr", text: `(${value.map(term).join(join)})` };
+  };
+  switch (op) {
+    case "eq":
+      return { kind: "expr", text: `${field}=${lit(value)}` };
+    case "neq":
+      return { kind: "expr", text: `${field}!=${lit(value)}` };
+    case "contains":
+      return { kind: "expr", text: `${field}~${lit(value)}` };
+    case "startsWith":
+      return { kind: "expr", text: `${field}~${lit(`${String(value)}%`)}` };
+    case "endsWith":
+      return { kind: "expr", text: `${field}~${lit(`%${String(value)}`)}` };
+    case "gt":
+      return { kind: "expr", text: `${field}>${lit(value)}` };
+    case "gte":
+      return { kind: "expr", text: `${field}>=${lit(value)}` };
+    case "lt":
+      return { kind: "expr", text: `${field}<${lit(value)}` };
+    case "lte":
+      return { kind: "expr", text: `${field}<=${lit(value)}` };
+    case "in":
+      return chain(" || ", (entry) => `${field}=${lit(entry)}`, false);
+    case "notIn":
+      return chain(" && ", (entry) => `${field}!=${lit(entry)}`, true);
+    case "has":
+      return { kind: "expr", text: `${field}~${lit(value)}` };
+    case "hasAny":
+      return chain(" || ", (entry) => `${field}~${lit(entry)}`, false);
+    case "hasAll":
+      return chain(" && ", (entry) => `${field}~${lit(entry)}`, true);
+    // An operator this provider cannot express fails LOUDLY, and with the same
+    // `kind` and `code` `@burojs/hasura` uses. It used to return DROP, i.e. "no
+    // constraint" — so an unknown operator quietly matched every record here
+    // while the sibling quietly turned it into `_eq`. Two silent, DIFFERENT
+    // wrong answers for one input is the same defect class as the branchless
+    // combinators, one hop out.
+    default:
+      throw unsupportedOperator(field, op);
+  }
+}
+function filterExpression(filter) {
+  const node = translateFilter(filter);
+  if (node.kind === "expr") return node.text;
+  if (node.kind === "const") return node.value ? void 0 : MATCHES_NO_RECORD;
+  return void 0;
+}
+function recordResult(record, idField) {
+  if (record === null || typeof record !== "object") {
+    throw {
+      kind: "protocol",
+      code: "invalid-record",
+      message: "PocketBase returned a non-object record."
+    };
+  }
+  const id = record[idField];
+  if (typeof id !== "string" && (typeof id !== "number" || !Number.isFinite(id))) {
+    throw {
+      kind: "protocol",
+      code: "invalid-record-id",
+      message: `PocketBase record is missing a valid ${idField} field.`
+    };
+  }
+  return { kind: "record", id, record, completeness: "full" };
+}
+function createPocketbaseDataProvider(opts) {
+  const base = opts.baseUrl.replace(/\/+$/, "");
+  const records = (resource) => `${base}/api/collections/${resource}/records`;
+  async function call(url, init = {}, signal) {
+    try {
+      const token = opts.getToken();
+      const headers = new Headers(init.headers);
+      if (token) headers.set("authorization", token);
+      if (init.body && !(init.body instanceof FormData))
+        headers.set("content-type", "application/json");
+      const response = await (opts.fetchImpl ?? fetch)(url, { ...init, headers, signal });
+      const text = await response.text();
+      let json = {};
+      if (text) {
+        try {
+          json = JSON.parse(text);
+        } catch {
+          throw {
+            kind: "protocol",
+            code: "invalid-json",
+            message: "PocketBase returned invalid JSON.",
+            status: response.status
+          };
+        }
+      }
+      if (!response.ok) {
+        throw {
+          kind: "transport",
+          code: "pocketbase-request-failed",
+          message: typeof json.message === "string" ? json.message : `PocketBase error ${response.status}`,
+          status: response.status,
+          details: json
+        };
+      }
+      return json;
+    } catch (error) {
+      if (error !== null && typeof error === "object" && "kind" in error) throw error;
+      throw {
+        kind: signal?.aborted ? "cancelled" : "transport",
+        code: signal?.aborted ? "request-aborted" : "pocketbase-request-failed",
+        message: error instanceof Error ? error.message : "PocketBase request failed.",
+        cause: error
+      };
+    }
+  }
+  const body = (input) => input instanceof FormData ? input : JSON.stringify(input);
+  return core.defineDataProvider({
+    queries: {
+      async list(descriptor, context) {
+        const params = new URLSearchParams();
+        if (descriptor.pagination?.kind === "offset") {
+          params.set("page", String(descriptor.pagination.page));
+          params.set("perPage", String(descriptor.pagination.pageSize));
+        } else if (descriptor.pagination?.kind === "cursor") {
+          throw {
+            kind: "capability",
+            code: "cursor-pagination-unsupported",
+            message: "PocketBase provider supports offset pagination only."
+          };
+        }
+        const filter = filterExpression(descriptor.filter);
+        if (filter) params.set("filter", filter);
+        if (descriptor.sort?.length) {
+          params.set(
+            "sort",
+            descriptor.sort.map(({ field, direction }) => `${direction === "desc" ? "-" : "+"}${field}`).join(",")
+          );
+        }
+        const json = await call(
+          `${records(descriptor.resource)}?${params}`,
+          {},
+          context.signal
+        );
+        return {
+          data: json.items ?? [],
+          ...typeof json.totalItems === "number" ? { total: json.totalItems } : {}
+        };
+      },
+      async one(descriptor, context) {
+        return {
+          data: await call(
+            `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,
+            {},
+            context.signal
+          )
+        };
+      },
+      async many(descriptor, context) {
+        if (descriptor.ids.length === 0) return { data: [] };
+        const filter = descriptor.ids.map((id) => `id=${lit(id)}`).join(" || ");
+        const json = await call(
+          `${records(descriptor.resource)}?filter=${encodeURIComponent(filter)}&perPage=${descriptor.ids.length}`,
+          {},
+          context.signal
+        );
+        return { data: json.items ?? [] };
+      }
+    },
+    mutations: {
+      async createOne(descriptor, context) {
+        const record = await call(
+          records(descriptor.resource),
+          { method: "POST", body: body(descriptor.input) },
+          context.signal
+        );
+        return recordResult(record, descriptor.idField);
+      },
+      async updateOne(descriptor, context) {
+        const record = await call(
+          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,
+          { method: "PATCH", body: body(descriptor.input) },
+          context.signal
+        );
+        return recordResult(record, descriptor.idField);
+      },
+      async deleteOne(descriptor, context) {
+        await call(
+          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,
+          { method: "DELETE" },
+          context.signal
+        );
+        return { kind: "identity", id: descriptor.id };
+      }
+    }
+  });
+}
+
+// src/auth-provider.ts
+function createPocketbaseAuthProvider(opts) {
+  const base = opts.baseUrl.replace(/\/+$/, "");
+  const key = opts.storageKey ?? "buro-example-vite-auth";
+  const read = () => {
+    try {
+      const raw = localStorage.getItem(key);
+      if (!raw) return null;
+      const parsed = JSON.parse(raw);
+      if (!parsed || typeof parsed.token !== "string" || typeof parsed.record?.id !== "string") {
+        return null;
+      }
+      return parsed;
+    } catch {
+      return null;
+    }
+  };
+  return {
+    getToken: () => read()?.token ?? null,
+    async login(params) {
+      const { email, password } = params;
+      const fetchImpl = opts.fetchImpl ?? fetch;
+      const res = await fetchImpl(`${base}/api/collections/users/auth-with-password`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ identity: email, password })
+      });
+      if (!res.ok) {
+        return {
+          success: false,
+          error: { kind: "auth", code: "invalid-credentials", message: "Invalid credentials" }
+        };
+      }
+      localStorage.setItem(key, JSON.stringify(await res.json()));
+      return { success: true };
+    },
+    async logout() {
+      localStorage.removeItem(key);
+      return { success: true };
+    },
+    async check() {
+      return read() ? { authenticated: true } : { authenticated: false, reason: "signed-out" };
+    },
+    async onError(error) {
+      return { action: "propagate", error };
+    },
+    async getIdentity() {
+      const session = read();
+      if (!session) return null;
+      return { id: session.record.id, name: session.record.name ?? session.record.email };
+    }
+  };
+}
+
+exports.FILTER_OPERATOR_UNSUPPORTED_CODE = FILTER_OPERATOR_UNSUPPORTED_CODE;
+exports.createPocketbaseAuthProvider = createPocketbaseAuthProvider;
+exports.createPocketbaseDataProvider = createPocketbaseDataProvider;
+exports.filterExpression = filterExpression;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/data-provider.ts","../src/auth-provider.ts"],"names":["defineDataProvider"],"mappings":"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","file":"index.cjs","sourcesContent":["import { defineDataProvider, type DataError, type DataProvider, type RecordId } from '@burojs/core';\n\nexport interface PocketbaseDataProviderOpts {\n  baseUrl: string;\n  getToken: () => string | null;\n  fetchImpl?: typeof fetch;\n}\n\n/** Escapes a value for a PocketBase filter string literal. */\nfunction lit(value: unknown): string {\n  return `\"${String(value).replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')}\"`;\n}\n\n/**\n * The shared refusal code for \"this provider cannot express that filter\n * operator\". `@burojs/hasura` exports the identical string as\n * `FILTER_OPERATOR_UNSUPPORTED_CODE` and throws the same `kind`, so an\n * application that handles one handles the other.\n *\n * The two packages do not import from each other (neither depends on the\n * other, and a shared constant would have to live in `@burojs/core`, which\n * owns the filter AST but not its transports). The agreement is therefore\n * pinned by a test that drives BOTH providers:\n * `examples/marketplace-ops/tests/provider-agreement.test.ts`.\n */\nexport const FILTER_OPERATOR_UNSUPPORTED_CODE = 'filter-operator-unsupported';\n\nfunction unsupportedOperator(field: string, op: string): DataError {\n  return {\n    kind: 'capability',\n    code: FILTER_OPERATOR_UNSUPPORTED_CODE,\n    message: `@burojs/pocketbase does not support the filter operator '${op}' (on '${field}').`,\n  };\n}\n\n/**\n * What one filter node translated to. Three outcomes, not two — that missing\n * third outcome IS the defect this type exists to make unrepresentable.\n *\n * THE CLASS, stated once. The old signature was `string | undefined`, and\n * `undefined` carried two incompatible meanings at once:\n *\n *  - \"no constraint was expressed here — drop me\" (no value supplied, an\n *    unrecognised node), and\n *  - \"this node is a constant\", which is what a BRANCHLESS COMBINATOR is:\n *    `{and: []}` is vacuously TRUE, `{or: []}` is vacuously FALSE, `in: []`\n *    is an empty-set membership test and therefore FALSE.\n *\n * Dropping a node is sound only when the node is TRUE and sits in an AND\n * position, where a TRUE conjunct is genuinely absorbed. Everywhere else —\n * under `not`, beside a disjunct in an `or`, or alone at the top level, where\n * the caller turns `undefined` into no `filter` param at all and the server\n * answers with EVERY row — dropping a false node inverts the query.\n *\n * The sibling `@burojs/hasura` closed the same class in `filtersToWhere` by\n * emitting `{_and: []}` / `{_or: []}` explicitly, because Hasura's `bool_exp`\n * has a literal for both truth values. PocketBase's filter grammar has none\n * (every term is `field op value`), so this half CANNOT emit a truth value as\n * a term; it folds instead and materialises only the one constant it cannot\n * fold away — see {@link MATCHES_NO_RECORD}.\n */\ntype FilterNode =\n  | { readonly kind: 'expr'; readonly text: string }\n  | { readonly kind: 'const'; readonly value: boolean }\n  | { readonly kind: 'drop' };\n\nconst DROP: FilterNode = { kind: 'drop' };\nconst constant = (value: boolean): FilterNode => ({ kind: 'const', value });\n\n/**\n * A PocketBase filter expression that matches NO record.\n *\n * It has to be a real expression: PocketBase's filter grammar has no boolean\n * literal and no nullary operator — every term is `field op value`, combined\n * with `&&`, `||`, `!(…)` and parentheses (the grammar `@burojs/mock-kit`'s\n * `parsePbFilter` implements, and the one this file's own emitters produce).\n * So \"match nothing\" is spelled as a CONTRADICTION over a column that every\n * record has.\n *\n * Why this particular one: `id=\"\" && id!=\"\"` is false for every possible value\n * of `id`, by the definition of `=` / `!=` alone. It does not depend on what\n * `id` contains, on the collection's schema, or on PocketBase's own guarantee\n * that a record id is a non-empty 15-character string — that guarantee would\n * make the shorter `id=\"\"` sufficient, but the contradiction needs no such\n * premise and stays false under SQL three-valued logic too (a NULL comparison\n * is not TRUE, so the row is still excluded).\n *\n * There is no TRUE counterpart because none is ever needed: a TRUE node is\n * absorbed by every AND, collapses every OR to TRUE, and at the top level is\n * exactly \"send no `filter` param\", which already means every row.\n */\nconst MATCHES_NO_RECORD = '(id=\"\" && id!=\"\")';\n\n/**\n * Fold a combinator's branches. `op` supplies its own absorbing element\n * (FALSE for `and`, TRUE for `or`) and identity element (the other one).\n *\n * The branchless case is checked on the SOURCE array, before mapping, and is\n * deliberately NOT the same case as \"every branch mapped away because no VALUE\n * was supplied\". That second case still yields `drop`, and `@burojs/hasura`\n * drops on exactly the same condition — a missing or `undefined` value, never\n * on `''`, which both providers translate.\n */\nfunction combine(branches: readonly unknown[], op: 'and' | 'or'): FilterNode {\n  if (branches.length === 0) return constant(op === 'and');\n  const absorbing = op === 'or';\n  const nodes = branches.map(translateFilter);\n  if (nodes.some((node) => node.kind === 'const' && node.value === absorbing)) {\n    return constant(absorbing);\n  }\n  const parts = nodes.flatMap((node) => (node.kind === 'expr' ? [node.text] : []));\n  if (parts.length > 0)\n    return { kind: 'expr', text: `(${parts.join(op === 'and' ? ' && ' : ' || ')})` };\n  // Nothing left to write down. A surviving identity-element constant still\n  // has to be reported as a constant (it may sit under a `not`); if there were\n  // no constants at all, every branch was a drop and so is the combinator.\n  return nodes.some((node) => node.kind === 'const') ? constant(!absorbing) : DROP;\n}\n\nfunction translateFilter(filter: unknown): FilterNode {\n  if (filter === null || typeof filter !== 'object') return DROP;\n  const candidate = filter as Record<string, unknown>;\n  if (Array.isArray(candidate.and)) return combine(candidate.and, 'and');\n  if (Array.isArray(candidate.or)) return combine(candidate.or, 'or');\n  if ('not' in candidate) {\n    const inner = translateFilter(candidate.not);\n    if (inner.kind === 'drop') return DROP;\n    if (inner.kind === 'const') return constant(!inner.value);\n    return { kind: 'expr', text: `!(${inner.text})` };\n  }\n  if (typeof candidate.field !== 'string' || typeof candidate.op !== 'string') return DROP;\n\n  const { field, op, value } = candidate;\n  // `isNull`/`isNotNull` carry no value and are answered before the value\n  // check, exactly as `@burojs/hasura` orders it.\n  if (op === 'isNull') return { kind: 'expr', text: `${field}=null` };\n  if (op === 'isNotNull') return { kind: 'expr', text: `${field}!=null` };\n  // Missing / `undefined` value: no constraint was expressed, so drop — the\n  // same rule, in the same position, as `@burojs/hasura`'s. Before this, an\n  // absent value was stringified into the literal filter `a=\"undefined\"`,\n  // which matches rows whose column really contains the text \"undefined\".\n  //\n  // `''` is deliberately NOT dropped, in either provider. See the matching\n  // comment in `@burojs/hasura`'s `filtersToWhere`: the empty-search-box idiom\n  // that motivated dropping it is already handled by `searchToFilter`\n  // (`@burojs/core`), which never builds a predicate for an empty query, so\n  // dropping it again here only cost the ordinary `eq: ''` case.\n  if (!('value' in candidate) || value === undefined) return DROP;\n  /**\n   * The four set-valued operators. PocketBase has no native `in`; each is\n   * expanded into an `||`/`&&` chain of comparisons, and an EMPTY chain is not\n   * expressible in the grammar at all — which is precisely why the empty case\n   * must become a folded constant rather than a dropped node.\n   *\n   * The two truth values come from set semantics, not from a capture (this\n   * repo holds no captured PocketBase responses): `x ∈ ∅` is false, `x ∉ ∅` is\n   * true, \"has any of ∅\" is false, and \"has all of ∅\" is vacuously true.\n   */\n  const chain = (\n    join: ' || ' | ' && ',\n    term: (entry: unknown) => string,\n    empty: boolean,\n  ): FilterNode => {\n    if (!Array.isArray(value)) return DROP;\n    if (value.length === 0) return constant(empty);\n    return { kind: 'expr', text: `(${value.map(term).join(join)})` };\n  };\n\n  switch (op) {\n    case 'eq':\n      return { kind: 'expr', text: `${field}=${lit(value)}` };\n    case 'neq':\n      return { kind: 'expr', text: `${field}!=${lit(value)}` };\n    case 'contains':\n      return { kind: 'expr', text: `${field}~${lit(value)}` };\n    case 'startsWith':\n      return { kind: 'expr', text: `${field}~${lit(`${String(value)}%`)}` };\n    case 'endsWith':\n      return { kind: 'expr', text: `${field}~${lit(`%${String(value)}`)}` };\n    case 'gt':\n      return { kind: 'expr', text: `${field}>${lit(value)}` };\n    case 'gte':\n      return { kind: 'expr', text: `${field}>=${lit(value)}` };\n    case 'lt':\n      return { kind: 'expr', text: `${field}<${lit(value)}` };\n    case 'lte':\n      return { kind: 'expr', text: `${field}<=${lit(value)}` };\n    case 'in':\n      return chain(' || ', (entry) => `${field}=${lit(entry)}`, false);\n    case 'notIn':\n      return chain(' && ', (entry) => `${field}!=${lit(entry)}`, true);\n    case 'has':\n      return { kind: 'expr', text: `${field}~${lit(value)}` };\n    case 'hasAny':\n      return chain(' || ', (entry) => `${field}~${lit(entry)}`, false);\n    case 'hasAll':\n      return chain(' && ', (entry) => `${field}~${lit(entry)}`, true);\n    // An operator this provider cannot express fails LOUDLY, and with the same\n    // `kind` and `code` `@burojs/hasura` uses. It used to return DROP, i.e. \"no\n    // constraint\" — so an unknown operator quietly matched every record here\n    // while the sibling quietly turned it into `_eq`. Two silent, DIFFERENT\n    // wrong answers for one input is the same defect class as the branchless\n    // combinators, one hop out.\n    default:\n      throw unsupportedOperator(field, op);\n  }\n}\n\n/**\n * Translate a portable filter expression into a PocketBase `filter` string.\n *\n * `undefined` means **matches every record** — send no `filter` param. It is\n * the answer for both a constraint-free filter and a filter that folds to\n * TRUE; the two are indistinguishable on the wire and there is nothing to\n * gain by distinguishing them.\n *\n * A filter that folds to FALSE returns {@link MATCHES_NO_RECORD} — a real\n * expression that matches nothing — never `undefined`. Returning `undefined`\n * for it is the inversion described on {@link FilterNode}: the caller omits\n * the param and PocketBase answers with every row.\n */\nexport function filterExpression(filter: unknown): string | undefined {\n  const node = translateFilter(filter);\n  if (node.kind === 'expr') return node.text;\n  if (node.kind === 'const') return node.value ? undefined : MATCHES_NO_RECORD;\n  return undefined;\n}\n\nfunction recordResult(record: unknown, idField: string) {\n  if (record === null || typeof record !== 'object') {\n    throw {\n      kind: 'protocol',\n      code: 'invalid-record',\n      message: 'PocketBase returned a non-object record.',\n    } satisfies DataError;\n  }\n  const id = (record as Record<string, unknown>)[idField];\n  if (typeof id !== 'string' && (typeof id !== 'number' || !Number.isFinite(id))) {\n    throw {\n      kind: 'protocol',\n      code: 'invalid-record-id',\n      message: `PocketBase record is missing a valid ${idField} field.`,\n    } satisfies DataError;\n  }\n  return { kind: 'record' as const, id: id as RecordId, record, completeness: 'full' as const };\n}\n\nexport function createPocketbaseDataProvider(opts: PocketbaseDataProviderOpts): DataProvider {\n  const base = opts.baseUrl.replace(/\\/+$/, '');\n  const records = (resource: string) => `${base}/api/collections/${resource}/records`;\n\n  async function call(url: string, init: RequestInit = {}, signal?: AbortSignal): Promise<unknown> {\n    try {\n      const token = opts.getToken();\n      const headers = new Headers(init.headers);\n      if (token) headers.set('authorization', token);\n      if (init.body && !(init.body instanceof FormData))\n        headers.set('content-type', 'application/json');\n\n      const response = await (opts.fetchImpl ?? fetch)(url, { ...init, headers, signal });\n      const text = await response.text();\n      let json: Record<string, unknown> = {};\n      if (text) {\n        try {\n          json = JSON.parse(text) as Record<string, unknown>;\n        } catch {\n          throw {\n            kind: 'protocol',\n            code: 'invalid-json',\n            message: 'PocketBase returned invalid JSON.',\n            status: response.status,\n          } satisfies DataError;\n        }\n      }\n      if (!response.ok) {\n        throw {\n          kind: 'transport',\n          code: 'pocketbase-request-failed',\n          message:\n            typeof json.message === 'string' ? json.message : `PocketBase error ${response.status}`,\n          status: response.status,\n          details: json,\n        } satisfies DataError;\n      }\n      return json;\n    } catch (error) {\n      if (error !== null && typeof error === 'object' && 'kind' in error) throw error;\n      throw {\n        kind: signal?.aborted ? 'cancelled' : 'transport',\n        code: signal?.aborted ? 'request-aborted' : 'pocketbase-request-failed',\n        message: error instanceof Error ? error.message : 'PocketBase request failed.',\n        cause: error,\n      } satisfies DataError;\n    }\n  }\n\n  const body = (input: unknown): BodyInit =>\n    input instanceof FormData ? input : JSON.stringify(input);\n\n  return defineDataProvider({\n    queries: {\n      async list(descriptor, context) {\n        const params = new URLSearchParams();\n        if (descriptor.pagination?.kind === 'offset') {\n          params.set('page', String(descriptor.pagination.page));\n          params.set('perPage', String(descriptor.pagination.pageSize));\n        } else if (descriptor.pagination?.kind === 'cursor') {\n          throw {\n            kind: 'capability',\n            code: 'cursor-pagination-unsupported',\n            message: 'PocketBase provider supports offset pagination only.',\n          } satisfies DataError;\n        }\n        // No `filter` param means \"every record\", and that is exactly what an\n        // absent `filterExpression` result now means (see its doc comment).\n        // A filter that means \"match nothing\" comes back as a real expression,\n        // so it is sent rather than silently omitted.\n        const filter = filterExpression(descriptor.filter);\n        if (filter) params.set('filter', filter);\n        if (descriptor.sort?.length) {\n          params.set(\n            'sort',\n            descriptor.sort\n              .map(({ field, direction }) => `${direction === 'desc' ? '-' : '+'}${field}`)\n              .join(','),\n          );\n        }\n        const json = (await call(\n          `${records(descriptor.resource)}?${params}`,\n          {},\n          context.signal,\n        )) as { items?: unknown[]; totalItems?: number };\n        return {\n          data: json.items ?? [],\n          ...(typeof json.totalItems === 'number' ? { total: json.totalItems } : {}),\n        };\n      },\n      async one(descriptor, context) {\n        return {\n          data: await call(\n            `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,\n            {},\n            context.signal,\n          ),\n        };\n      },\n      async many(descriptor, context) {\n        if (descriptor.ids.length === 0) return { data: [] };\n        const filter = descriptor.ids.map((id) => `id=${lit(id)}`).join(' || ');\n        const json = (await call(\n          `${records(descriptor.resource)}?filter=${encodeURIComponent(filter)}&perPage=${descriptor.ids.length}`,\n          {},\n          context.signal,\n        )) as { items?: unknown[] };\n        return { data: json.items ?? [] };\n      },\n    },\n    mutations: {\n      async createOne(descriptor, context) {\n        const record = await call(\n          records(descriptor.resource),\n          { method: 'POST', body: body(descriptor.input) },\n          context.signal,\n        );\n        return recordResult(record, descriptor.idField);\n      },\n      async updateOne(descriptor, context) {\n        const record = await call(\n          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,\n          { method: 'PATCH', body: body(descriptor.input) },\n          context.signal,\n        );\n        return recordResult(record, descriptor.idField);\n      },\n      async deleteOne(descriptor, context) {\n        await call(\n          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,\n          { method: 'DELETE' },\n          context.signal,\n        );\n        return { kind: 'identity', id: descriptor.id };\n      },\n    },\n  });\n}\n","import type { AuthProvider, DataError } from '@burojs/core';\n\nexport interface PocketbaseAuthOpts {\n  baseUrl: string;\n  fetchImpl?: typeof fetch;\n  storageKey?: string;\n}\n\ninterface Session {\n  token: string;\n  record: { id: string; email?: string; name?: string; avatar?: string };\n}\n\n/**\n * Password auth against a PocketBase `users` collection, with the session in\n * localStorage. Deliberately tiny: the example exists to demonstrate the file\n * storage port, not to be an auth reference.\n */\nexport function createPocketbaseAuthProvider(\n  opts: PocketbaseAuthOpts,\n): AuthProvider & { getToken(): string | null } {\n  const base = opts.baseUrl.replace(/\\/+$/, '');\n  const key = opts.storageKey ?? 'buro-example-vite-auth';\n\n  const read = (): Session | null => {\n    try {\n      const raw = localStorage.getItem(key);\n      if (!raw) return null;\n      const parsed = JSON.parse(raw) as Partial<Session> | null;\n      // The try/catch above only guards JSON.parse throwing — it says nothing\n      // about the parsed SHAPE. A value that is valid JSON but not a Session\n      // (a stale format from an earlier version, manual tampering) must be\n      // treated as \"not logged in\", not crash `getIdentity` reading\n      // `record.id` off `undefined`.\n      if (!parsed || typeof parsed.token !== 'string' || typeof parsed.record?.id !== 'string') {\n        return null;\n      }\n      return parsed as Session;\n    } catch {\n      return null;\n    }\n  };\n\n  return {\n    getToken: () => read()?.token ?? null,\n\n    async login(params: unknown) {\n      const { email, password } = params as { email: string; password: string };\n      // Resolved HERE, per call — not once at construction. Captured at\n      // construction, a `fetch` installed afterwards is unreachable for the life\n      // of the provider: a test stub set after the factory ran silently never\n      // applies and the call escapes to the real network instead. The sibling\n      // `data-provider.ts` carried the identical bug, and it stayed invisible\n      // until something needed real fixture data from it.\n      const fetchImpl = opts.fetchImpl ?? fetch;\n      const res = await fetchImpl(`${base}/api/collections/users/auth-with-password`, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify({ identity: email, password }),\n      });\n      if (!res.ok) {\n        return {\n          success: false,\n          error: { kind: 'auth', code: 'invalid-credentials', message: 'Invalid credentials' },\n        };\n      }\n      localStorage.setItem(key, JSON.stringify((await res.json()) as Session));\n      return { success: true };\n    },\n\n    async logout() {\n      localStorage.removeItem(key);\n      return { success: true };\n    },\n\n    async check() {\n      return read() ? { authenticated: true } : { authenticated: false, reason: 'signed-out' };\n    },\n\n    async onError(error: DataError) {\n      return { action: 'propagate', error };\n    },\n\n    async getIdentity() {\n      const session = read();\n      if (!session) return null;\n      return { id: session.record.id, name: session.record.name ?? session.record.email };\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,51 @@
+import { DataProvider, AuthProvider } from '@burojs/core';
+
+interface PocketbaseDataProviderOpts {
+    baseUrl: string;
+    getToken: () => string | null;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * The shared refusal code for "this provider cannot express that filter
+ * operator". `@burojs/hasura` exports the identical string as
+ * `FILTER_OPERATOR_UNSUPPORTED_CODE` and throws the same `kind`, so an
+ * application that handles one handles the other.
+ *
+ * The two packages do not import from each other (neither depends on the
+ * other, and a shared constant would have to live in `@burojs/core`, which
+ * owns the filter AST but not its transports). The agreement is therefore
+ * pinned by a test that drives BOTH providers:
+ * `examples/marketplace-ops/tests/provider-agreement.test.ts`.
+ */
+declare const FILTER_OPERATOR_UNSUPPORTED_CODE = "filter-operator-unsupported";
+/**
+ * Translate a portable filter expression into a PocketBase `filter` string.
+ *
+ * `undefined` means **matches every record** — send no `filter` param. It is
+ * the answer for both a constraint-free filter and a filter that folds to
+ * TRUE; the two are indistinguishable on the wire and there is nothing to
+ * gain by distinguishing them.
+ *
+ * A filter that folds to FALSE returns {@link MATCHES_NO_RECORD} — a real
+ * expression that matches nothing — never `undefined`. Returning `undefined`
+ * for it is the inversion described on {@link FilterNode}: the caller omits
+ * the param and PocketBase answers with every row.
+ */
+declare function filterExpression(filter: unknown): string | undefined;
+declare function createPocketbaseDataProvider(opts: PocketbaseDataProviderOpts): DataProvider;
+
+interface PocketbaseAuthOpts {
+    baseUrl: string;
+    fetchImpl?: typeof fetch;
+    storageKey?: string;
+}
+/**
+ * Password auth against a PocketBase `users` collection, with the session in
+ * localStorage. Deliberately tiny: the example exists to demonstrate the file
+ * storage port, not to be an auth reference.
+ */
+declare function createPocketbaseAuthProvider(opts: PocketbaseAuthOpts): AuthProvider & {
+    getToken(): string | null;
+};
+
+export { FILTER_OPERATOR_UNSUPPORTED_CODE, type PocketbaseAuthOpts, type PocketbaseDataProviderOpts, createPocketbaseAuthProvider, createPocketbaseDataProvider, filterExpression };

package/dist/index.d.ts

@@ -0,0 +1,51 @@
+import { DataProvider, AuthProvider } from '@burojs/core';
+
+interface PocketbaseDataProviderOpts {
+    baseUrl: string;
+    getToken: () => string | null;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * The shared refusal code for "this provider cannot express that filter
+ * operator". `@burojs/hasura` exports the identical string as
+ * `FILTER_OPERATOR_UNSUPPORTED_CODE` and throws the same `kind`, so an
+ * application that handles one handles the other.
+ *
+ * The two packages do not import from each other (neither depends on the
+ * other, and a shared constant would have to live in `@burojs/core`, which
+ * owns the filter AST but not its transports). The agreement is therefore
+ * pinned by a test that drives BOTH providers:
+ * `examples/marketplace-ops/tests/provider-agreement.test.ts`.
+ */
+declare const FILTER_OPERATOR_UNSUPPORTED_CODE = "filter-operator-unsupported";
+/**
+ * Translate a portable filter expression into a PocketBase `filter` string.
+ *
+ * `undefined` means **matches every record** — send no `filter` param. It is
+ * the answer for both a constraint-free filter and a filter that folds to
+ * TRUE; the two are indistinguishable on the wire and there is nothing to
+ * gain by distinguishing them.
+ *
+ * A filter that folds to FALSE returns {@link MATCHES_NO_RECORD} — a real
+ * expression that matches nothing — never `undefined`. Returning `undefined`
+ * for it is the inversion described on {@link FilterNode}: the caller omits
+ * the param and PocketBase answers with every row.
+ */
+declare function filterExpression(filter: unknown): string | undefined;
+declare function createPocketbaseDataProvider(opts: PocketbaseDataProviderOpts): DataProvider;
+
+interface PocketbaseAuthOpts {
+    baseUrl: string;
+    fetchImpl?: typeof fetch;
+    storageKey?: string;
+}
+/**
+ * Password auth against a PocketBase `users` collection, with the session in
+ * localStorage. Deliberately tiny: the example exists to demonstrate the file
+ * storage port, not to be an auth reference.
+ */
+declare function createPocketbaseAuthProvider(opts: PocketbaseAuthOpts): AuthProvider & {
+    getToken(): string | null;
+};
+
+export { FILTER_OPERATOR_UNSUPPORTED_CODE, type PocketbaseAuthOpts, type PocketbaseDataProviderOpts, createPocketbaseAuthProvider, createPocketbaseDataProvider, filterExpression };

package/dist/index.js

@@ -0,0 +1,297 @@
+import { defineDataProvider } from '@burojs/core';
+
+// src/data-provider.ts
+function lit(value) {
+  return `"${String(value).replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`;
+}
+var FILTER_OPERATOR_UNSUPPORTED_CODE = "filter-operator-unsupported";
+function unsupportedOperator(field, op) {
+  return {
+    kind: "capability",
+    code: FILTER_OPERATOR_UNSUPPORTED_CODE,
+    message: `@burojs/pocketbase does not support the filter operator '${op}' (on '${field}').`
+  };
+}
+var DROP = { kind: "drop" };
+var constant = (value) => ({ kind: "const", value });
+var MATCHES_NO_RECORD = '(id="" && id!="")';
+function combine(branches, op) {
+  if (branches.length === 0) return constant(op === "and");
+  const absorbing = op === "or";
+  const nodes = branches.map(translateFilter);
+  if (nodes.some((node) => node.kind === "const" && node.value === absorbing)) {
+    return constant(absorbing);
+  }
+  const parts = nodes.flatMap((node) => node.kind === "expr" ? [node.text] : []);
+  if (parts.length > 0)
+    return { kind: "expr", text: `(${parts.join(op === "and" ? " && " : " || ")})` };
+  return nodes.some((node) => node.kind === "const") ? constant(!absorbing) : DROP;
+}
+function translateFilter(filter) {
+  if (filter === null || typeof filter !== "object") return DROP;
+  const candidate = filter;
+  if (Array.isArray(candidate.and)) return combine(candidate.and, "and");
+  if (Array.isArray(candidate.or)) return combine(candidate.or, "or");
+  if ("not" in candidate) {
+    const inner = translateFilter(candidate.not);
+    if (inner.kind === "drop") return DROP;
+    if (inner.kind === "const") return constant(!inner.value);
+    return { kind: "expr", text: `!(${inner.text})` };
+  }
+  if (typeof candidate.field !== "string" || typeof candidate.op !== "string") return DROP;
+  const { field, op, value } = candidate;
+  if (op === "isNull") return { kind: "expr", text: `${field}=null` };
+  if (op === "isNotNull") return { kind: "expr", text: `${field}!=null` };
+  if (!("value" in candidate) || value === void 0) return DROP;
+  const chain = (join, term, empty) => {
+    if (!Array.isArray(value)) return DROP;
+    if (value.length === 0) return constant(empty);
+    return { kind: "expr", text: `(${value.map(term).join(join)})` };
+  };
+  switch (op) {
+    case "eq":
+      return { kind: "expr", text: `${field}=${lit(value)}` };
+    case "neq":
+      return { kind: "expr", text: `${field}!=${lit(value)}` };
+    case "contains":
+      return { kind: "expr", text: `${field}~${lit(value)}` };
+    case "startsWith":
+      return { kind: "expr", text: `${field}~${lit(`${String(value)}%`)}` };
+    case "endsWith":
+      return { kind: "expr", text: `${field}~${lit(`%${String(value)}`)}` };
+    case "gt":
+      return { kind: "expr", text: `${field}>${lit(value)}` };
+    case "gte":
+      return { kind: "expr", text: `${field}>=${lit(value)}` };
+    case "lt":
+      return { kind: "expr", text: `${field}<${lit(value)}` };
+    case "lte":
+      return { kind: "expr", text: `${field}<=${lit(value)}` };
+    case "in":
+      return chain(" || ", (entry) => `${field}=${lit(entry)}`, false);
+    case "notIn":
+      return chain(" && ", (entry) => `${field}!=${lit(entry)}`, true);
+    case "has":
+      return { kind: "expr", text: `${field}~${lit(value)}` };
+    case "hasAny":
+      return chain(" || ", (entry) => `${field}~${lit(entry)}`, false);
+    case "hasAll":
+      return chain(" && ", (entry) => `${field}~${lit(entry)}`, true);
+    // An operator this provider cannot express fails LOUDLY, and with the same
+    // `kind` and `code` `@burojs/hasura` uses. It used to return DROP, i.e. "no
+    // constraint" — so an unknown operator quietly matched every record here
+    // while the sibling quietly turned it into `_eq`. Two silent, DIFFERENT
+    // wrong answers for one input is the same defect class as the branchless
+    // combinators, one hop out.
+    default:
+      throw unsupportedOperator(field, op);
+  }
+}
+function filterExpression(filter) {
+  const node = translateFilter(filter);
+  if (node.kind === "expr") return node.text;
+  if (node.kind === "const") return node.value ? void 0 : MATCHES_NO_RECORD;
+  return void 0;
+}
+function recordResult(record, idField) {
+  if (record === null || typeof record !== "object") {
+    throw {
+      kind: "protocol",
+      code: "invalid-record",
+      message: "PocketBase returned a non-object record."
+    };
+  }
+  const id = record[idField];
+  if (typeof id !== "string" && (typeof id !== "number" || !Number.isFinite(id))) {
+    throw {
+      kind: "protocol",
+      code: "invalid-record-id",
+      message: `PocketBase record is missing a valid ${idField} field.`
+    };
+  }
+  return { kind: "record", id, record, completeness: "full" };
+}
+function createPocketbaseDataProvider(opts) {
+  const base = opts.baseUrl.replace(/\/+$/, "");
+  const records = (resource) => `${base}/api/collections/${resource}/records`;
+  async function call(url, init = {}, signal) {
+    try {
+      const token = opts.getToken();
+      const headers = new Headers(init.headers);
+      if (token) headers.set("authorization", token);
+      if (init.body && !(init.body instanceof FormData))
+        headers.set("content-type", "application/json");
+      const response = await (opts.fetchImpl ?? fetch)(url, { ...init, headers, signal });
+      const text = await response.text();
+      let json = {};
+      if (text) {
+        try {
+          json = JSON.parse(text);
+        } catch {
+          throw {
+            kind: "protocol",
+            code: "invalid-json",
+            message: "PocketBase returned invalid JSON.",
+            status: response.status
+          };
+        }
+      }
+      if (!response.ok) {
+        throw {
+          kind: "transport",
+          code: "pocketbase-request-failed",
+          message: typeof json.message === "string" ? json.message : `PocketBase error ${response.status}`,
+          status: response.status,
+          details: json
+        };
+      }
+      return json;
+    } catch (error) {
+      if (error !== null && typeof error === "object" && "kind" in error) throw error;
+      throw {
+        kind: signal?.aborted ? "cancelled" : "transport",
+        code: signal?.aborted ? "request-aborted" : "pocketbase-request-failed",
+        message: error instanceof Error ? error.message : "PocketBase request failed.",
+        cause: error
+      };
+    }
+  }
+  const body = (input) => input instanceof FormData ? input : JSON.stringify(input);
+  return defineDataProvider({
+    queries: {
+      async list(descriptor, context) {
+        const params = new URLSearchParams();
+        if (descriptor.pagination?.kind === "offset") {
+          params.set("page", String(descriptor.pagination.page));
+          params.set("perPage", String(descriptor.pagination.pageSize));
+        } else if (descriptor.pagination?.kind === "cursor") {
+          throw {
+            kind: "capability",
+            code: "cursor-pagination-unsupported",
+            message: "PocketBase provider supports offset pagination only."
+          };
+        }
+        const filter = filterExpression(descriptor.filter);
+        if (filter) params.set("filter", filter);
+        if (descriptor.sort?.length) {
+          params.set(
+            "sort",
+            descriptor.sort.map(({ field, direction }) => `${direction === "desc" ? "-" : "+"}${field}`).join(",")
+          );
+        }
+        const json = await call(
+          `${records(descriptor.resource)}?${params}`,
+          {},
+          context.signal
+        );
+        return {
+          data: json.items ?? [],
+          ...typeof json.totalItems === "number" ? { total: json.totalItems } : {}
+        };
+      },
+      async one(descriptor, context) {
+        return {
+          data: await call(
+            `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,
+            {},
+            context.signal
+          )
+        };
+      },
+      async many(descriptor, context) {
+        if (descriptor.ids.length === 0) return { data: [] };
+        const filter = descriptor.ids.map((id) => `id=${lit(id)}`).join(" || ");
+        const json = await call(
+          `${records(descriptor.resource)}?filter=${encodeURIComponent(filter)}&perPage=${descriptor.ids.length}`,
+          {},
+          context.signal
+        );
+        return { data: json.items ?? [] };
+      }
+    },
+    mutations: {
+      async createOne(descriptor, context) {
+        const record = await call(
+          records(descriptor.resource),
+          { method: "POST", body: body(descriptor.input) },
+          context.signal
+        );
+        return recordResult(record, descriptor.idField);
+      },
+      async updateOne(descriptor, context) {
+        const record = await call(
+          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,
+          { method: "PATCH", body: body(descriptor.input) },
+          context.signal
+        );
+        return recordResult(record, descriptor.idField);
+      },
+      async deleteOne(descriptor, context) {
+        await call(
+          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,
+          { method: "DELETE" },
+          context.signal
+        );
+        return { kind: "identity", id: descriptor.id };
+      }
+    }
+  });
+}
+
+// src/auth-provider.ts
+function createPocketbaseAuthProvider(opts) {
+  const base = opts.baseUrl.replace(/\/+$/, "");
+  const key = opts.storageKey ?? "buro-example-vite-auth";
+  const read = () => {
+    try {
+      const raw = localStorage.getItem(key);
+      if (!raw) return null;
+      const parsed = JSON.parse(raw);
+      if (!parsed || typeof parsed.token !== "string" || typeof parsed.record?.id !== "string") {
+        return null;
+      }
+      return parsed;
+    } catch {
+      return null;
+    }
+  };
+  return {
+    getToken: () => read()?.token ?? null,
+    async login(params) {
+      const { email, password } = params;
+      const fetchImpl = opts.fetchImpl ?? fetch;
+      const res = await fetchImpl(`${base}/api/collections/users/auth-with-password`, {
+        method: "POST",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify({ identity: email, password })
+      });
+      if (!res.ok) {
+        return {
+          success: false,
+          error: { kind: "auth", code: "invalid-credentials", message: "Invalid credentials" }
+        };
+      }
+      localStorage.setItem(key, JSON.stringify(await res.json()));
+      return { success: true };
+    },
+    async logout() {
+      localStorage.removeItem(key);
+      return { success: true };
+    },
+    async check() {
+      return read() ? { authenticated: true } : { authenticated: false, reason: "signed-out" };
+    },
+    async onError(error) {
+      return { action: "propagate", error };
+    },
+    async getIdentity() {
+      const session = read();
+      if (!session) return null;
+      return { id: session.record.id, name: session.record.name ?? session.record.email };
+    }
+  };
+}
+
+export { FILTER_OPERATOR_UNSUPPORTED_CODE, createPocketbaseAuthProvider, createPocketbaseDataProvider, filterExpression };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/data-provider.ts","../src/auth-provider.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { defineDataProvider, type DataError, type DataProvider, type RecordId } from '@burojs/core';\n\nexport interface PocketbaseDataProviderOpts {\n  baseUrl: string;\n  getToken: () => string | null;\n  fetchImpl?: typeof fetch;\n}\n\n/** Escapes a value for a PocketBase filter string literal. */\nfunction lit(value: unknown): string {\n  return `\"${String(value).replace(/\\\\/g, '\\\\\\\\').replace(/\"/g, '\\\\\"')}\"`;\n}\n\n/**\n * The shared refusal code for \"this provider cannot express that filter\n * operator\". `@burojs/hasura` exports the identical string as\n * `FILTER_OPERATOR_UNSUPPORTED_CODE` and throws the same `kind`, so an\n * application that handles one handles the other.\n *\n * The two packages do not import from each other (neither depends on the\n * other, and a shared constant would have to live in `@burojs/core`, which\n * owns the filter AST but not its transports). The agreement is therefore\n * pinned by a test that drives BOTH providers:\n * `examples/marketplace-ops/tests/provider-agreement.test.ts`.\n */\nexport const FILTER_OPERATOR_UNSUPPORTED_CODE = 'filter-operator-unsupported';\n\nfunction unsupportedOperator(field: string, op: string): DataError {\n  return {\n    kind: 'capability',\n    code: FILTER_OPERATOR_UNSUPPORTED_CODE,\n    message: `@burojs/pocketbase does not support the filter operator '${op}' (on '${field}').`,\n  };\n}\n\n/**\n * What one filter node translated to. Three outcomes, not two — that missing\n * third outcome IS the defect this type exists to make unrepresentable.\n *\n * THE CLASS, stated once. The old signature was `string | undefined`, and\n * `undefined` carried two incompatible meanings at once:\n *\n *  - \"no constraint was expressed here — drop me\" (no value supplied, an\n *    unrecognised node), and\n *  - \"this node is a constant\", which is what a BRANCHLESS COMBINATOR is:\n *    `{and: []}` is vacuously TRUE, `{or: []}` is vacuously FALSE, `in: []`\n *    is an empty-set membership test and therefore FALSE.\n *\n * Dropping a node is sound only when the node is TRUE and sits in an AND\n * position, where a TRUE conjunct is genuinely absorbed. Everywhere else —\n * under `not`, beside a disjunct in an `or`, or alone at the top level, where\n * the caller turns `undefined` into no `filter` param at all and the server\n * answers with EVERY row — dropping a false node inverts the query.\n *\n * The sibling `@burojs/hasura` closed the same class in `filtersToWhere` by\n * emitting `{_and: []}` / `{_or: []}` explicitly, because Hasura's `bool_exp`\n * has a literal for both truth values. PocketBase's filter grammar has none\n * (every term is `field op value`), so this half CANNOT emit a truth value as\n * a term; it folds instead and materialises only the one constant it cannot\n * fold away — see {@link MATCHES_NO_RECORD}.\n */\ntype FilterNode =\n  | { readonly kind: 'expr'; readonly text: string }\n  | { readonly kind: 'const'; readonly value: boolean }\n  | { readonly kind: 'drop' };\n\nconst DROP: FilterNode = { kind: 'drop' };\nconst constant = (value: boolean): FilterNode => ({ kind: 'const', value });\n\n/**\n * A PocketBase filter expression that matches NO record.\n *\n * It has to be a real expression: PocketBase's filter grammar has no boolean\n * literal and no nullary operator — every term is `field op value`, combined\n * with `&&`, `||`, `!(…)` and parentheses (the grammar `@burojs/mock-kit`'s\n * `parsePbFilter` implements, and the one this file's own emitters produce).\n * So \"match nothing\" is spelled as a CONTRADICTION over a column that every\n * record has.\n *\n * Why this particular one: `id=\"\" && id!=\"\"` is false for every possible value\n * of `id`, by the definition of `=` / `!=` alone. It does not depend on what\n * `id` contains, on the collection's schema, or on PocketBase's own guarantee\n * that a record id is a non-empty 15-character string — that guarantee would\n * make the shorter `id=\"\"` sufficient, but the contradiction needs no such\n * premise and stays false under SQL three-valued logic too (a NULL comparison\n * is not TRUE, so the row is still excluded).\n *\n * There is no TRUE counterpart because none is ever needed: a TRUE node is\n * absorbed by every AND, collapses every OR to TRUE, and at the top level is\n * exactly \"send no `filter` param\", which already means every row.\n */\nconst MATCHES_NO_RECORD = '(id=\"\" && id!=\"\")';\n\n/**\n * Fold a combinator's branches. `op` supplies its own absorbing element\n * (FALSE for `and`, TRUE for `or`) and identity element (the other one).\n *\n * The branchless case is checked on the SOURCE array, before mapping, and is\n * deliberately NOT the same case as \"every branch mapped away because no VALUE\n * was supplied\". That second case still yields `drop`, and `@burojs/hasura`\n * drops on exactly the same condition — a missing or `undefined` value, never\n * on `''`, which both providers translate.\n */\nfunction combine(branches: readonly unknown[], op: 'and' | 'or'): FilterNode {\n  if (branches.length === 0) return constant(op === 'and');\n  const absorbing = op === 'or';\n  const nodes = branches.map(translateFilter);\n  if (nodes.some((node) => node.kind === 'const' && node.value === absorbing)) {\n    return constant(absorbing);\n  }\n  const parts = nodes.flatMap((node) => (node.kind === 'expr' ? [node.text] : []));\n  if (parts.length > 0)\n    return { kind: 'expr', text: `(${parts.join(op === 'and' ? ' && ' : ' || ')})` };\n  // Nothing left to write down. A surviving identity-element constant still\n  // has to be reported as a constant (it may sit under a `not`); if there were\n  // no constants at all, every branch was a drop and so is the combinator.\n  return nodes.some((node) => node.kind === 'const') ? constant(!absorbing) : DROP;\n}\n\nfunction translateFilter(filter: unknown): FilterNode {\n  if (filter === null || typeof filter !== 'object') return DROP;\n  const candidate = filter as Record<string, unknown>;\n  if (Array.isArray(candidate.and)) return combine(candidate.and, 'and');\n  if (Array.isArray(candidate.or)) return combine(candidate.or, 'or');\n  if ('not' in candidate) {\n    const inner = translateFilter(candidate.not);\n    if (inner.kind === 'drop') return DROP;\n    if (inner.kind === 'const') return constant(!inner.value);\n    return { kind: 'expr', text: `!(${inner.text})` };\n  }\n  if (typeof candidate.field !== 'string' || typeof candidate.op !== 'string') return DROP;\n\n  const { field, op, value } = candidate;\n  // `isNull`/`isNotNull` carry no value and are answered before the value\n  // check, exactly as `@burojs/hasura` orders it.\n  if (op === 'isNull') return { kind: 'expr', text: `${field}=null` };\n  if (op === 'isNotNull') return { kind: 'expr', text: `${field}!=null` };\n  // Missing / `undefined` value: no constraint was expressed, so drop — the\n  // same rule, in the same position, as `@burojs/hasura`'s. Before this, an\n  // absent value was stringified into the literal filter `a=\"undefined\"`,\n  // which matches rows whose column really contains the text \"undefined\".\n  //\n  // `''` is deliberately NOT dropped, in either provider. See the matching\n  // comment in `@burojs/hasura`'s `filtersToWhere`: the empty-search-box idiom\n  // that motivated dropping it is already handled by `searchToFilter`\n  // (`@burojs/core`), which never builds a predicate for an empty query, so\n  // dropping it again here only cost the ordinary `eq: ''` case.\n  if (!('value' in candidate) || value === undefined) return DROP;\n  /**\n   * The four set-valued operators. PocketBase has no native `in`; each is\n   * expanded into an `||`/`&&` chain of comparisons, and an EMPTY chain is not\n   * expressible in the grammar at all — which is precisely why the empty case\n   * must become a folded constant rather than a dropped node.\n   *\n   * The two truth values come from set semantics, not from a capture (this\n   * repo holds no captured PocketBase responses): `x ∈ ∅` is false, `x ∉ ∅` is\n   * true, \"has any of ∅\" is false, and \"has all of ∅\" is vacuously true.\n   */\n  const chain = (\n    join: ' || ' | ' && ',\n    term: (entry: unknown) => string,\n    empty: boolean,\n  ): FilterNode => {\n    if (!Array.isArray(value)) return DROP;\n    if (value.length === 0) return constant(empty);\n    return { kind: 'expr', text: `(${value.map(term).join(join)})` };\n  };\n\n  switch (op) {\n    case 'eq':\n      return { kind: 'expr', text: `${field}=${lit(value)}` };\n    case 'neq':\n      return { kind: 'expr', text: `${field}!=${lit(value)}` };\n    case 'contains':\n      return { kind: 'expr', text: `${field}~${lit(value)}` };\n    case 'startsWith':\n      return { kind: 'expr', text: `${field}~${lit(`${String(value)}%`)}` };\n    case 'endsWith':\n      return { kind: 'expr', text: `${field}~${lit(`%${String(value)}`)}` };\n    case 'gt':\n      return { kind: 'expr', text: `${field}>${lit(value)}` };\n    case 'gte':\n      return { kind: 'expr', text: `${field}>=${lit(value)}` };\n    case 'lt':\n      return { kind: 'expr', text: `${field}<${lit(value)}` };\n    case 'lte':\n      return { kind: 'expr', text: `${field}<=${lit(value)}` };\n    case 'in':\n      return chain(' || ', (entry) => `${field}=${lit(entry)}`, false);\n    case 'notIn':\n      return chain(' && ', (entry) => `${field}!=${lit(entry)}`, true);\n    case 'has':\n      return { kind: 'expr', text: `${field}~${lit(value)}` };\n    case 'hasAny':\n      return chain(' || ', (entry) => `${field}~${lit(entry)}`, false);\n    case 'hasAll':\n      return chain(' && ', (entry) => `${field}~${lit(entry)}`, true);\n    // An operator this provider cannot express fails LOUDLY, and with the same\n    // `kind` and `code` `@burojs/hasura` uses. It used to return DROP, i.e. \"no\n    // constraint\" — so an unknown operator quietly matched every record here\n    // while the sibling quietly turned it into `_eq`. Two silent, DIFFERENT\n    // wrong answers for one input is the same defect class as the branchless\n    // combinators, one hop out.\n    default:\n      throw unsupportedOperator(field, op);\n  }\n}\n\n/**\n * Translate a portable filter expression into a PocketBase `filter` string.\n *\n * `undefined` means **matches every record** — send no `filter` param. It is\n * the answer for both a constraint-free filter and a filter that folds to\n * TRUE; the two are indistinguishable on the wire and there is nothing to\n * gain by distinguishing them.\n *\n * A filter that folds to FALSE returns {@link MATCHES_NO_RECORD} — a real\n * expression that matches nothing — never `undefined`. Returning `undefined`\n * for it is the inversion described on {@link FilterNode}: the caller omits\n * the param and PocketBase answers with every row.\n */\nexport function filterExpression(filter: unknown): string | undefined {\n  const node = translateFilter(filter);\n  if (node.kind === 'expr') return node.text;\n  if (node.kind === 'const') return node.value ? undefined : MATCHES_NO_RECORD;\n  return undefined;\n}\n\nfunction recordResult(record: unknown, idField: string) {\n  if (record === null || typeof record !== 'object') {\n    throw {\n      kind: 'protocol',\n      code: 'invalid-record',\n      message: 'PocketBase returned a non-object record.',\n    } satisfies DataError;\n  }\n  const id = (record as Record<string, unknown>)[idField];\n  if (typeof id !== 'string' && (typeof id !== 'number' || !Number.isFinite(id))) {\n    throw {\n      kind: 'protocol',\n      code: 'invalid-record-id',\n      message: `PocketBase record is missing a valid ${idField} field.`,\n    } satisfies DataError;\n  }\n  return { kind: 'record' as const, id: id as RecordId, record, completeness: 'full' as const };\n}\n\nexport function createPocketbaseDataProvider(opts: PocketbaseDataProviderOpts): DataProvider {\n  const base = opts.baseUrl.replace(/\\/+$/, '');\n  const records = (resource: string) => `${base}/api/collections/${resource}/records`;\n\n  async function call(url: string, init: RequestInit = {}, signal?: AbortSignal): Promise<unknown> {\n    try {\n      const token = opts.getToken();\n      const headers = new Headers(init.headers);\n      if (token) headers.set('authorization', token);\n      if (init.body && !(init.body instanceof FormData))\n        headers.set('content-type', 'application/json');\n\n      const response = await (opts.fetchImpl ?? fetch)(url, { ...init, headers, signal });\n      const text = await response.text();\n      let json: Record<string, unknown> = {};\n      if (text) {\n        try {\n          json = JSON.parse(text) as Record<string, unknown>;\n        } catch {\n          throw {\n            kind: 'protocol',\n            code: 'invalid-json',\n            message: 'PocketBase returned invalid JSON.',\n            status: response.status,\n          } satisfies DataError;\n        }\n      }\n      if (!response.ok) {\n        throw {\n          kind: 'transport',\n          code: 'pocketbase-request-failed',\n          message:\n            typeof json.message === 'string' ? json.message : `PocketBase error ${response.status}`,\n          status: response.status,\n          details: json,\n        } satisfies DataError;\n      }\n      return json;\n    } catch (error) {\n      if (error !== null && typeof error === 'object' && 'kind' in error) throw error;\n      throw {\n        kind: signal?.aborted ? 'cancelled' : 'transport',\n        code: signal?.aborted ? 'request-aborted' : 'pocketbase-request-failed',\n        message: error instanceof Error ? error.message : 'PocketBase request failed.',\n        cause: error,\n      } satisfies DataError;\n    }\n  }\n\n  const body = (input: unknown): BodyInit =>\n    input instanceof FormData ? input : JSON.stringify(input);\n\n  return defineDataProvider({\n    queries: {\n      async list(descriptor, context) {\n        const params = new URLSearchParams();\n        if (descriptor.pagination?.kind === 'offset') {\n          params.set('page', String(descriptor.pagination.page));\n          params.set('perPage', String(descriptor.pagination.pageSize));\n        } else if (descriptor.pagination?.kind === 'cursor') {\n          throw {\n            kind: 'capability',\n            code: 'cursor-pagination-unsupported',\n            message: 'PocketBase provider supports offset pagination only.',\n          } satisfies DataError;\n        }\n        // No `filter` param means \"every record\", and that is exactly what an\n        // absent `filterExpression` result now means (see its doc comment).\n        // A filter that means \"match nothing\" comes back as a real expression,\n        // so it is sent rather than silently omitted.\n        const filter = filterExpression(descriptor.filter);\n        if (filter) params.set('filter', filter);\n        if (descriptor.sort?.length) {\n          params.set(\n            'sort',\n            descriptor.sort\n              .map(({ field, direction }) => `${direction === 'desc' ? '-' : '+'}${field}`)\n              .join(','),\n          );\n        }\n        const json = (await call(\n          `${records(descriptor.resource)}?${params}`,\n          {},\n          context.signal,\n        )) as { items?: unknown[]; totalItems?: number };\n        return {\n          data: json.items ?? [],\n          ...(typeof json.totalItems === 'number' ? { total: json.totalItems } : {}),\n        };\n      },\n      async one(descriptor, context) {\n        return {\n          data: await call(\n            `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,\n            {},\n            context.signal,\n          ),\n        };\n      },\n      async many(descriptor, context) {\n        if (descriptor.ids.length === 0) return { data: [] };\n        const filter = descriptor.ids.map((id) => `id=${lit(id)}`).join(' || ');\n        const json = (await call(\n          `${records(descriptor.resource)}?filter=${encodeURIComponent(filter)}&perPage=${descriptor.ids.length}`,\n          {},\n          context.signal,\n        )) as { items?: unknown[] };\n        return { data: json.items ?? [] };\n      },\n    },\n    mutations: {\n      async createOne(descriptor, context) {\n        const record = await call(\n          records(descriptor.resource),\n          { method: 'POST', body: body(descriptor.input) },\n          context.signal,\n        );\n        return recordResult(record, descriptor.idField);\n      },\n      async updateOne(descriptor, context) {\n        const record = await call(\n          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,\n          { method: 'PATCH', body: body(descriptor.input) },\n          context.signal,\n        );\n        return recordResult(record, descriptor.idField);\n      },\n      async deleteOne(descriptor, context) {\n        await call(\n          `${records(descriptor.resource)}/${encodeURIComponent(String(descriptor.id))}`,\n          { method: 'DELETE' },\n          context.signal,\n        );\n        return { kind: 'identity', id: descriptor.id };\n      },\n    },\n  });\n}\n","import type { AuthProvider, DataError } from '@burojs/core';\n\nexport interface PocketbaseAuthOpts {\n  baseUrl: string;\n  fetchImpl?: typeof fetch;\n  storageKey?: string;\n}\n\ninterface Session {\n  token: string;\n  record: { id: string; email?: string; name?: string; avatar?: string };\n}\n\n/**\n * Password auth against a PocketBase `users` collection, with the session in\n * localStorage. Deliberately tiny: the example exists to demonstrate the file\n * storage port, not to be an auth reference.\n */\nexport function createPocketbaseAuthProvider(\n  opts: PocketbaseAuthOpts,\n): AuthProvider & { getToken(): string | null } {\n  const base = opts.baseUrl.replace(/\\/+$/, '');\n  const key = opts.storageKey ?? 'buro-example-vite-auth';\n\n  const read = (): Session | null => {\n    try {\n      const raw = localStorage.getItem(key);\n      if (!raw) return null;\n      const parsed = JSON.parse(raw) as Partial<Session> | null;\n      // The try/catch above only guards JSON.parse throwing — it says nothing\n      // about the parsed SHAPE. A value that is valid JSON but not a Session\n      // (a stale format from an earlier version, manual tampering) must be\n      // treated as \"not logged in\", not crash `getIdentity` reading\n      // `record.id` off `undefined`.\n      if (!parsed || typeof parsed.token !== 'string' || typeof parsed.record?.id !== 'string') {\n        return null;\n      }\n      return parsed as Session;\n    } catch {\n      return null;\n    }\n  };\n\n  return {\n    getToken: () => read()?.token ?? null,\n\n    async login(params: unknown) {\n      const { email, password } = params as { email: string; password: string };\n      // Resolved HERE, per call — not once at construction. Captured at\n      // construction, a `fetch` installed afterwards is unreachable for the life\n      // of the provider: a test stub set after the factory ran silently never\n      // applies and the call escapes to the real network instead. The sibling\n      // `data-provider.ts` carried the identical bug, and it stayed invisible\n      // until something needed real fixture data from it.\n      const fetchImpl = opts.fetchImpl ?? fetch;\n      const res = await fetchImpl(`${base}/api/collections/users/auth-with-password`, {\n        method: 'POST',\n        headers: { 'content-type': 'application/json' },\n        body: JSON.stringify({ identity: email, password }),\n      });\n      if (!res.ok) {\n        return {\n          success: false,\n          error: { kind: 'auth', code: 'invalid-credentials', message: 'Invalid credentials' },\n        };\n      }\n      localStorage.setItem(key, JSON.stringify((await res.json()) as Session));\n      return { success: true };\n    },\n\n    async logout() {\n      localStorage.removeItem(key);\n      return { success: true };\n    },\n\n    async check() {\n      return read() ? { authenticated: true } : { authenticated: false, reason: 'signed-out' };\n    },\n\n    async onError(error: DataError) {\n      return { action: 'propagate', error };\n    },\n\n    async getIdentity() {\n      const session = read();\n      if (!session) return null;\n      return { id: session.record.id, name: session.record.name ?? session.record.email };\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@burojs/pocketbase",
+  "version": "0.2.0",
+  "license": "MIT",
+  "description": "Buro: PocketBase data provider and auth provider",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@burojs/core": "0.2.0"
+  },
+  "devDependencies": {
+    "jsdom": "^26.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.1.0",
+    "@burojs/tooling-eslint": "0.0.0",
+    "@burojs/tooling-tsconfig": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "typecheck:tests": "tsc -p tsconfig.test.json"
+  }
+}