@gusto/baerly-storage 0.1.2 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +24 -1
- package/dist/API.md +44 -15
- package/dist/client-react.d.ts +73 -82
- package/dist/client-react.js +95 -53
- package/dist/client-react.js.map +1 -1
- package/package.json +3 -3
package/README.md
CHANGED
|
@@ -56,6 +56,29 @@ const { rows } = useLiveQuery<Ticket>({
|
|
|
56
56
|
});
|
|
57
57
|
```
|
|
58
58
|
|
|
59
|
+
## Cheat sheet
|
|
60
|
+
|
|
61
|
+
```ts
|
|
62
|
+
// reads — Collection or, after a modifier, Query
|
|
63
|
+
db.collection("tickets").get(id); // by id
|
|
64
|
+
db.collection("tickets").where({ status: "open" }).all();
|
|
65
|
+
db.collection("tickets").where(q => q.gte("count", 1)).count();
|
|
66
|
+
|
|
67
|
+
// writes — by id on Collection, bulk on Query
|
|
68
|
+
db.collection("tickets").insert({ status: "open", title: "ship it" });
|
|
69
|
+
db.collection("tickets").update(id, { status: "closed" }); // merge-patch
|
|
70
|
+
db.collection("tickets").where({ status: "closed" }).delete();
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
|---|---|
|
|
74
|
+
| **Verbs** | `first` `all` `count` `get` · `insert` `update` `replace` `delete` |
|
|
75
|
+
| **Modifiers** | `where` `order` `limit` |
|
|
76
|
+
| **Operators** | `eq` `gt` `gte` `lt` `lte` `in` |
|
|
77
|
+
| **Errors** | one `BaerlyError`, discriminate by `.code` (`Conflict`, `NotFound`, `SchemaError`, …) |
|
|
78
|
+
|
|
79
|
+
Full reference: [`docs/guide/cheatsheet.md`](./docs/guide/cheatsheet.md), or
|
|
80
|
+
`cat node_modules/@gusto/baerly-storage/dist/API.md` in an installed app.
|
|
81
|
+
|
|
59
82
|
## Why?
|
|
60
83
|
|
|
61
84
|
- **An API an LLM can use first try.** The whole public surface fits in
|
|
@@ -89,7 +112,7 @@ For a runnable multi-tab demo see [`examples/react-node/`](./examples/react-node
|
|
|
89
112
|
- 🧭 **How it works** — [`docs/about/how-it-works.md`](./docs/about/how-it-works.md) (the plain-language mental model — bucket + one atomic pointer flip)
|
|
90
113
|
- 🧱 **Product thesis** — [`docs/about/thesis.md`](./docs/about/thesis.md)
|
|
91
114
|
- 🏗️ **Architecture** — [`docs/contributing/architecture.md`](./docs/contributing/architecture.md)
|
|
92
|
-
- 🔧 **Embed by hand** — [`
|
|
115
|
+
- 🔧 **Embed by hand** — [`packages/server/API.md`](./packages/server/API.md) (the embed-by-hand + custom-routes recipes — `baerlyNode().fetch` is the canonical shape; ships as `dist/API.md` in the package)
|
|
93
116
|
|
|
94
117
|
## Where things live
|
|
95
118
|
|
package/dist/API.md
CHANGED
|
@@ -398,6 +398,12 @@ The win is on the read side: `db.collection("tickets").all()` is
|
|
|
398
398
|
typed `Ticket[]` with `_id: string` (required), so route handlers
|
|
399
399
|
and response schemas don't need a parallel "_id-required" row type.
|
|
400
400
|
|
|
401
|
+
`_id` is server-minted (UUIDv7, sorts by mint time) — there is no
|
|
402
|
+
exported id generator, and minting one client-side is unsupported.
|
|
403
|
+
For a write that must reference its own id, write the parent first and
|
|
404
|
+
read back the `_id` the server returns; design cross-collection writes
|
|
405
|
+
parent-first with cleanup, not by pre-minting ids.
|
|
406
|
+
|
|
401
407
|
Indexes: declared here, threaded into `Db.create` automatically. The
|
|
402
408
|
read-path auto-planner picks an index when the predicate matches;
|
|
403
409
|
mismatches fall back to the full scan with a metric bump (correctness
|
|
@@ -497,29 +503,46 @@ subscribers in other UI frameworks can `fetch` this endpoint
|
|
|
497
503
|
directly, or import the internal `pollSinceOnce` helper from
|
|
498
504
|
`@baerly/client` if cursor-aware tailing is needed.
|
|
499
505
|
|
|
500
|
-
## React: `
|
|
506
|
+
## React: `createBaerlyReact`
|
|
507
|
+
|
|
508
|
+
`@gusto/baerly-storage/client/react` exports one factory,
|
|
509
|
+
`createBaerlyReact<typeof config>()`. Call it once and export the
|
|
510
|
+
result; it returns `{ BaerlyProvider, useQuery, useMutation,
|
|
511
|
+
useBaerlyClient }` all bound to your config, so a `useQuery` /
|
|
512
|
+
`useMutation` callback's `c.collection("notes")` infers the real row
|
|
513
|
+
type — **no `as Promise<Note[]>` cast**. (React context can't carry a
|
|
514
|
+
generic to the hooks; binding once at the factory is what threads it.)
|
|
515
|
+
The provider owns a shared `/v1/since` long-poll per `(client,
|
|
516
|
+
collection)`; idle cycles cost zero list reads, and any non-empty batch
|
|
517
|
+
invalidates every `useQuery` whose chain touches the firing collection.
|
|
518
|
+
|
|
519
|
+
```ts
|
|
520
|
+
// src/web/client.ts — wire the client + bound hooks once.
|
|
521
|
+
import { createBaerlyClient } from "@gusto/baerly-storage/client";
|
|
522
|
+
import { createBaerlyReact } from "@gusto/baerly-storage/client/react";
|
|
523
|
+
import config from "../../baerly.config.ts";
|
|
501
524
|
|
|
502
|
-
|
|
503
|
-
|
|
504
|
-
|
|
505
|
-
|
|
525
|
+
export const client = createBaerlyClient({ baseUrl: "", config });
|
|
526
|
+
export const { BaerlyProvider, useQuery, useMutation } =
|
|
527
|
+
createBaerlyReact<typeof config>();
|
|
528
|
+
```
|
|
506
529
|
|
|
507
530
|
```tsx
|
|
508
|
-
import
|
|
509
|
-
|
|
510
|
-
} from "@gusto/baerly-storage/client/react";
|
|
531
|
+
// Components import the bound hooks from your module, not the package.
|
|
532
|
+
import { BaerlyProvider, client, useMutation, useQuery } from "./client.ts";
|
|
511
533
|
|
|
512
534
|
// 1. Wrap your app once.
|
|
513
|
-
<BaerlyProvider client={
|
|
535
|
+
<BaerlyProvider client={client}>
|
|
514
536
|
<App />
|
|
515
537
|
</BaerlyProvider>
|
|
516
538
|
|
|
517
|
-
// 2. useQuery(cb, deps) —
|
|
518
|
-
// a ClientCollection / ClientQuery chain. Re-runs on deps
|
|
519
|
-
// on long-poll invalidation. Result is a discriminated
|
|
520
|
-
|
|
539
|
+
// 2. useQuery(cb, deps) — the callback receives the bound client and
|
|
540
|
+
// returns a ClientCollection / ClientQuery chain. Re-runs on deps
|
|
541
|
+
// change OR on long-poll invalidation. Result is a discriminated
|
|
542
|
+
// union; the row type is inferred from the collection name:
|
|
543
|
+
const result = useQuery((c) => c.collection("notes").all(), []);
|
|
521
544
|
// result.status: "loading" | "ok" | "error" | "skipped"
|
|
522
|
-
// result.data:
|
|
545
|
+
// result.data: Note[] | undefined (present iff status === "ok")
|
|
523
546
|
// result.error: BaerlyError | undefined (present iff status === "error")
|
|
524
547
|
|
|
525
548
|
// 3. useQuery.skip — short-circuit to status: "skipped", no
|
|
@@ -527,7 +550,7 @@ const result = useQuery((c) => c.collection("notes").all() as Promise<Note[]>, [
|
|
|
527
550
|
const filtered = useQuery(
|
|
528
551
|
(c) => filter === "all"
|
|
529
552
|
? useQuery.skip
|
|
530
|
-
: c.collection("notes").where({ status: filter }).all()
|
|
553
|
+
: c.collection("notes").where({ status: filter }).all(),
|
|
531
554
|
[filter],
|
|
532
555
|
);
|
|
533
556
|
|
|
@@ -538,6 +561,12 @@ const [mutate, { isPending, error }] = useMutation();
|
|
|
538
561
|
await mutate((c) => c.collection("notes").insert({ body }));
|
|
539
562
|
```
|
|
540
563
|
|
|
564
|
+
> No type parameter (`createBaerlyReact()`) gives an unbound surface —
|
|
565
|
+
> collection names widen to `string`, rows to `DocumentData` — matching
|
|
566
|
+
> the in-process `Db.collection` fallback. There are no loose hooks to
|
|
567
|
+
> import directly: an unbound hook can't see the config, so binding at
|
|
568
|
+
> the factory is the only path.
|
|
569
|
+
|
|
541
570
|
## HTTP wire format
|
|
542
571
|
|
|
543
572
|
The JS SDK is the canonical path. Reach for `curl` only when
|
package/dist/client-react.d.ts
CHANGED
|
@@ -3,55 +3,19 @@ import { o as BaerlyError } from "./index-DSvwEUeF.js";
|
|
|
3
3
|
import { t as BaerlyClient } from "./client-DYZfoZb9.js";
|
|
4
4
|
import { ReactNode } from "react";
|
|
5
5
|
|
|
6
|
-
//#region packages/client/src/react/
|
|
7
|
-
interface BaerlyProviderProps {
|
|
8
|
-
readonly client: BaerlyClient;
|
|
9
|
-
readonly children?: ReactNode;
|
|
10
|
-
}
|
|
11
|
-
/**
|
|
12
|
-
* Provides a {@link BaerlyClient} to every Baerly React hook below it.
|
|
13
|
-
* Wrap your app once near the root; the hooks read the client from
|
|
14
|
-
* this context and have no `client` argument.
|
|
15
|
-
*
|
|
16
|
-
* @example
|
|
17
|
-
* ```tsx
|
|
18
|
-
* import { createBaerlyClient } from "@gusto/baerly-storage/client";
|
|
19
|
-
* import { BaerlyProvider } from "@gusto/baerly-storage/client/react";
|
|
20
|
-
*
|
|
21
|
-
* const client = createBaerlyClient({ baseUrl: "/api" });
|
|
22
|
-
*
|
|
23
|
-
* <BaerlyProvider client={client}>
|
|
24
|
-
* <App />
|
|
25
|
-
* </BaerlyProvider>
|
|
26
|
-
* ```
|
|
27
|
-
*/
|
|
28
|
-
declare const BaerlyProvider: ({
|
|
29
|
-
client,
|
|
30
|
-
children
|
|
31
|
-
}: BaerlyProviderProps) => React.JSX.Element;
|
|
6
|
+
//#region packages/client/src/react/use-mutation.d.ts
|
|
32
7
|
/**
|
|
33
|
-
*
|
|
34
|
-
*
|
|
35
|
-
*
|
|
36
|
-
*
|
|
37
|
-
*
|
|
38
|
-
* Use this directly when you need imperative access — e.g. inside an
|
|
39
|
-
* event handler that performs a one-shot read or a custom long-poll.
|
|
40
|
-
* For declarative reads and mutations, prefer the typed hooks.
|
|
41
|
-
*
|
|
42
|
-
* @example
|
|
43
|
-
* ```tsx
|
|
44
|
-
* const client = useBaerlyClient<MyConfig>();
|
|
45
|
-
* const onExport = async () => {
|
|
46
|
-
* const rows = await client.collection("tickets").all();
|
|
47
|
-
* download(rows);
|
|
48
|
-
* };
|
|
49
|
-
* ```
|
|
8
|
+
* Tuple returned by {@link useMutation}. Positionally mirrors React
|
|
9
|
+
* 19's `useActionState`: `[mutate, state]`. `mutate` is stable across
|
|
10
|
+
* renders; `state` is a fresh object only when `isPending` or
|
|
11
|
+
* `error` actually flips.
|
|
50
12
|
*/
|
|
51
|
-
|
|
13
|
+
type UseMutationTuple<TConfig extends BaerlyConfig = UnboundConfig> = readonly [mutate: <T>(callback: (client: BaerlyClient<TConfig>) => Promise<T>) => Promise<T>, state: {
|
|
14
|
+
readonly isPending: boolean;
|
|
15
|
+
readonly error: BaerlyError | undefined;
|
|
16
|
+
}];
|
|
52
17
|
//#endregion
|
|
53
18
|
//#region packages/client/src/react/use-query.d.ts
|
|
54
|
-
declare const SKIP: unique symbol;
|
|
55
19
|
/**
|
|
56
20
|
* Result handed back by {@link useQuery}. Discriminate on `status` —
|
|
57
21
|
* narrowing into `"ok"` / `"refreshing"` gives `data: T`; narrowing
|
|
@@ -80,52 +44,79 @@ type UseQueryResult<T> = {
|
|
|
80
44
|
readonly data: T | undefined;
|
|
81
45
|
readonly error: Error;
|
|
82
46
|
};
|
|
47
|
+
//#endregion
|
|
48
|
+
//#region packages/client/src/react/create-react.d.ts
|
|
83
49
|
/**
|
|
84
|
-
*
|
|
85
|
-
*
|
|
86
|
-
*
|
|
50
|
+
* Props for the config-bound `BaerlyProvider` returned by
|
|
51
|
+
* {@link createBaerlyReact}. `client` is typed `BaerlyClient<TConfig>`
|
|
52
|
+
* to document the intended binding; the hooks carry `TConfig`
|
|
53
|
+
* themselves, so row inference holds regardless of the client value's
|
|
54
|
+
* own inferred type.
|
|
87
55
|
*/
|
|
88
|
-
|
|
89
|
-
|
|
90
|
-
readonly
|
|
91
|
-
}
|
|
92
|
-
//#endregion
|
|
93
|
-
//#region packages/client/src/react/use-mutation.d.ts
|
|
56
|
+
interface BaerlyProviderProps<TConfig extends BaerlyConfig> {
|
|
57
|
+
readonly client: BaerlyClient<TConfig>;
|
|
58
|
+
readonly children?: ReactNode;
|
|
59
|
+
}
|
|
94
60
|
/**
|
|
95
|
-
*
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
* `
|
|
61
|
+
* The config-bound React surface returned by {@link createBaerlyReact}.
|
|
62
|
+
* Every hook is pinned to `TConfig`, so `c.collection("notes")` inside
|
|
63
|
+
* a `useQuery` / `useMutation` callback infers the real row type — no
|
|
64
|
+
* `as Promise<Note[]>` cast.
|
|
99
65
|
*/
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
readonly
|
|
103
|
-
|
|
66
|
+
interface BaerlyReact<TConfig extends BaerlyConfig> {
|
|
67
|
+
/** Wrap your app once; provides the bound client to every hook below it. */
|
|
68
|
+
readonly BaerlyProvider: (props: BaerlyProviderProps<TConfig>) => React.JSX.Element;
|
|
69
|
+
/**
|
|
70
|
+
* Reactive read. The callback receives `BaerlyClient<TConfig>`, so
|
|
71
|
+
* the chain is fully typed. `useQuery.skip` short-circuits to
|
|
72
|
+
* `{ status: "skipped" }`.
|
|
73
|
+
*/
|
|
74
|
+
readonly useQuery: {
|
|
75
|
+
<T>(callback: (client: BaerlyClient<TConfig>) => Promise<T> | symbol, deps?: ReadonlyArray<unknown>): UseQueryResult<T>;
|
|
76
|
+
/**
|
|
77
|
+
* Sentinel — return it from the callback to defer the read
|
|
78
|
+
* (`{ status: "skipped" }`, no subscription). Typed `symbol` (not
|
|
79
|
+
* the impl's `unique symbol`) so the bound surface stays nameable
|
|
80
|
+
* across the package boundary; identity-compared at runtime.
|
|
81
|
+
*/
|
|
82
|
+
readonly skip: symbol;
|
|
83
|
+
};
|
|
84
|
+
/** Imperative mutation hook → `[mutate, { isPending, error }]`. */
|
|
85
|
+
readonly useMutation: () => UseMutationTuple<TConfig>;
|
|
86
|
+
/** Escape hatch — the raw bound {@link BaerlyClient} for imperative use. */
|
|
87
|
+
readonly useBaerlyClient: () => BaerlyClient<TConfig>;
|
|
88
|
+
}
|
|
104
89
|
/**
|
|
105
|
-
*
|
|
106
|
-
*
|
|
107
|
-
*
|
|
108
|
-
*
|
|
109
|
-
*
|
|
110
|
-
* successful call clears it).
|
|
111
|
-
*
|
|
112
|
-
* Errors are normalised to {@link BaerlyError}: a non-`BaerlyError`
|
|
113
|
-
* throwable from the callback is wrapped under
|
|
114
|
-
* `code: "MutationFailed"` with the original on `.cause`.
|
|
90
|
+
* Build the typed React surface for one `baerly.config.ts`. Call it
|
|
91
|
+
* once at module scope and export the result; every hook is bound to
|
|
92
|
+
* the config so collection names autocomplete and row types infer
|
|
93
|
+
* end-to-end. This is the only React entry point — there are no
|
|
94
|
+
* loose, unbound hooks to import by mistake.
|
|
115
95
|
*
|
|
116
96
|
* @example
|
|
97
|
+
* ```ts
|
|
98
|
+
* // src/web/client.ts
|
|
99
|
+
* import { createBaerlyClient } from "@gusto/baerly-storage/client";
|
|
100
|
+
* import { createBaerlyReact } from "@gusto/baerly-storage/client/react";
|
|
101
|
+
* import config from "../../baerly.config.ts";
|
|
102
|
+
*
|
|
103
|
+
* export const client = createBaerlyClient({ baseUrl: "", config });
|
|
104
|
+
* export const { BaerlyProvider, useQuery, useMutation } =
|
|
105
|
+
* createBaerlyReact<typeof config>();
|
|
106
|
+
* ```
|
|
107
|
+
*
|
|
117
108
|
* ```tsx
|
|
118
|
-
*
|
|
119
|
-
*
|
|
120
|
-
*
|
|
121
|
-
*
|
|
122
|
-
* >
|
|
123
|
-
* {isPending ? "Saving…" : "Save"}
|
|
124
|
-
* </button>
|
|
125
|
-
* {error ? <p>{error.message}</p> : null}
|
|
109
|
+
* // any component
|
|
110
|
+
* import { useQuery } from "./client.ts";
|
|
111
|
+
* const notes = useQuery((c) => c.collection("notes").all(), []);
|
|
112
|
+
* // ^? UseQueryResult<Note[]> — no cast
|
|
126
113
|
* ```
|
|
114
|
+
*
|
|
115
|
+
* Omit the type parameter (`createBaerlyReact()`) for an unbound app;
|
|
116
|
+
* collection names widen to `string` and rows to `DocumentData`,
|
|
117
|
+
* matching the in-process `Db.collection` fallback.
|
|
127
118
|
*/
|
|
128
|
-
declare const
|
|
119
|
+
declare const createBaerlyReact: <TConfig extends BaerlyConfig = UnboundConfig>() => BaerlyReact<TConfig>;
|
|
129
120
|
//#endregion
|
|
130
|
-
export {
|
|
121
|
+
export { type BaerlyProviderProps, type BaerlyReact, type UseMutationTuple, type UseQueryResult, createBaerlyReact };
|
|
131
122
|
//# sourceMappingURL=client-react.d.ts.map
|
package/dist/client-react.js
CHANGED
|
@@ -8,12 +8,16 @@ const ClientContext = createContext(void 0);
|
|
|
8
8
|
* Wrap your app once near the root; the hooks read the client from
|
|
9
9
|
* this context and have no `client` argument.
|
|
10
10
|
*
|
|
11
|
+
* Obtained from {@link createBaerlyReact}, not imported directly:
|
|
12
|
+
*
|
|
11
13
|
* @example
|
|
12
14
|
* ```tsx
|
|
13
15
|
* import { createBaerlyClient } from "@gusto/baerly-storage/client";
|
|
14
|
-
* import {
|
|
16
|
+
* import { createBaerlyReact } from "@gusto/baerly-storage/client/react";
|
|
17
|
+
* import config from "./baerly.config.ts";
|
|
15
18
|
*
|
|
16
|
-
* const client = createBaerlyClient({ baseUrl: "/api" });
|
|
19
|
+
* const client = createBaerlyClient({ baseUrl: "/api", config });
|
|
20
|
+
* const { BaerlyProvider } = createBaerlyReact<typeof config>();
|
|
17
21
|
*
|
|
18
22
|
* <BaerlyProvider client={client}>
|
|
19
23
|
* <App />
|
|
@@ -46,6 +50,63 @@ const useBaerlyClient = () => {
|
|
|
46
50
|
return client;
|
|
47
51
|
};
|
|
48
52
|
//#endregion
|
|
53
|
+
//#region packages/client/src/react/use-mutation.ts
|
|
54
|
+
/**
|
|
55
|
+
* Imperative mutation hook. `mutate(callback)` runs the callback
|
|
56
|
+
* against the real `BaerlyClient` and resolves to whatever the
|
|
57
|
+
* callback returns; `state` carries `isPending` (refcounted across
|
|
58
|
+
* concurrent submits — `true` until every in-flight call settles)
|
|
59
|
+
* and `error` (last-wins; the most recent rejection until the next
|
|
60
|
+
* successful call clears it).
|
|
61
|
+
*
|
|
62
|
+
* Errors are normalised to {@link BaerlyError}: a non-`BaerlyError`
|
|
63
|
+
* throwable from the callback is wrapped under
|
|
64
|
+
* `code: "MutationFailed"` with the original on `.cause`.
|
|
65
|
+
*
|
|
66
|
+
* @example
|
|
67
|
+
* ```tsx
|
|
68
|
+
* const [mutate, { isPending, error }] = useMutation();
|
|
69
|
+
* <button
|
|
70
|
+
* disabled={isPending}
|
|
71
|
+
* onClick={() => mutate((client) => client.collection("notes").insert({ body }))}
|
|
72
|
+
* >
|
|
73
|
+
* {isPending ? "Saving…" : "Save"}
|
|
74
|
+
* </button>
|
|
75
|
+
* {error ? <p>{error.message}</p> : null}
|
|
76
|
+
* ```
|
|
77
|
+
*/
|
|
78
|
+
const useMutation = () => {
|
|
79
|
+
const client = useBaerlyClient();
|
|
80
|
+
const inFlightRef = useRef(0);
|
|
81
|
+
const mountedRef = useRef(true);
|
|
82
|
+
const [isPending, setIsPending] = useState(false);
|
|
83
|
+
const [lastError, setLastError] = useState(void 0);
|
|
84
|
+
useEffect(() => () => {
|
|
85
|
+
mountedRef.current = false;
|
|
86
|
+
}, []);
|
|
87
|
+
return [useCallback(async (callback) => {
|
|
88
|
+
const wasIdle = inFlightRef.current === 0;
|
|
89
|
+
inFlightRef.current += 1;
|
|
90
|
+
if (wasIdle && mountedRef.current) {
|
|
91
|
+
setIsPending(true);
|
|
92
|
+
setLastError(void 0);
|
|
93
|
+
}
|
|
94
|
+
try {
|
|
95
|
+
return await callback(client);
|
|
96
|
+
} catch (error) {
|
|
97
|
+
const be = error instanceof BaerlyError ? error : new BaerlyError("MutationFailed", error instanceof Error ? error.message : String(error), error);
|
|
98
|
+
if (mountedRef.current) setLastError(be);
|
|
99
|
+
throw be;
|
|
100
|
+
} finally {
|
|
101
|
+
inFlightRef.current -= 1;
|
|
102
|
+
if (inFlightRef.current === 0 && mountedRef.current) setIsPending(false);
|
|
103
|
+
}
|
|
104
|
+
}, [client]), useMemo(() => ({
|
|
105
|
+
isPending,
|
|
106
|
+
error: lastError
|
|
107
|
+
}), [isPending, lastError])];
|
|
108
|
+
};
|
|
109
|
+
//#endregion
|
|
49
110
|
//#region packages/client/src/react/stable-key.ts
|
|
50
111
|
/**
|
|
51
112
|
* Deterministic JSON serialization with sorted object keys. `useQuery`
|
|
@@ -497,63 +558,44 @@ const useQueryImpl = (callback, deps) => {
|
|
|
497
558
|
*/
|
|
498
559
|
const useQuery = Object.assign(useQueryImpl, { skip: SKIP });
|
|
499
560
|
//#endregion
|
|
500
|
-
//#region packages/client/src/react/
|
|
561
|
+
//#region packages/client/src/react/create-react.ts
|
|
501
562
|
/**
|
|
502
|
-
*
|
|
503
|
-
*
|
|
504
|
-
*
|
|
505
|
-
*
|
|
506
|
-
*
|
|
507
|
-
* successful call clears it).
|
|
508
|
-
*
|
|
509
|
-
* Errors are normalised to {@link BaerlyError}: a non-`BaerlyError`
|
|
510
|
-
* throwable from the callback is wrapped under
|
|
511
|
-
* `code: "MutationFailed"` with the original on `.cause`.
|
|
563
|
+
* Build the typed React surface for one `baerly.config.ts`. Call it
|
|
564
|
+
* once at module scope and export the result; every hook is bound to
|
|
565
|
+
* the config so collection names autocomplete and row types infer
|
|
566
|
+
* end-to-end. This is the only React entry point — there are no
|
|
567
|
+
* loose, unbound hooks to import by mistake.
|
|
512
568
|
*
|
|
513
569
|
* @example
|
|
570
|
+
* ```ts
|
|
571
|
+
* // src/web/client.ts
|
|
572
|
+
* import { createBaerlyClient } from "@gusto/baerly-storage/client";
|
|
573
|
+
* import { createBaerlyReact } from "@gusto/baerly-storage/client/react";
|
|
574
|
+
* import config from "../../baerly.config.ts";
|
|
575
|
+
*
|
|
576
|
+
* export const client = createBaerlyClient({ baseUrl: "", config });
|
|
577
|
+
* export const { BaerlyProvider, useQuery, useMutation } =
|
|
578
|
+
* createBaerlyReact<typeof config>();
|
|
579
|
+
* ```
|
|
580
|
+
*
|
|
514
581
|
* ```tsx
|
|
515
|
-
*
|
|
516
|
-
*
|
|
517
|
-
*
|
|
518
|
-
*
|
|
519
|
-
* >
|
|
520
|
-
* {isPending ? "Saving…" : "Save"}
|
|
521
|
-
* </button>
|
|
522
|
-
* {error ? <p>{error.message}</p> : null}
|
|
582
|
+
* // any component
|
|
583
|
+
* import { useQuery } from "./client.ts";
|
|
584
|
+
* const notes = useQuery((c) => c.collection("notes").all(), []);
|
|
585
|
+
* // ^? UseQueryResult<Note[]> — no cast
|
|
523
586
|
* ```
|
|
587
|
+
*
|
|
588
|
+
* Omit the type parameter (`createBaerlyReact()`) for an unbound app;
|
|
589
|
+
* collection names widen to `string` and rows to `DocumentData`,
|
|
590
|
+
* matching the in-process `Db.collection` fallback.
|
|
524
591
|
*/
|
|
525
|
-
const
|
|
526
|
-
|
|
527
|
-
|
|
528
|
-
|
|
529
|
-
|
|
530
|
-
|
|
531
|
-
useEffect(() => () => {
|
|
532
|
-
mountedRef.current = false;
|
|
533
|
-
}, []);
|
|
534
|
-
return [useCallback(async (callback) => {
|
|
535
|
-
const wasIdle = inFlightRef.current === 0;
|
|
536
|
-
inFlightRef.current += 1;
|
|
537
|
-
if (wasIdle && mountedRef.current) {
|
|
538
|
-
setIsPending(true);
|
|
539
|
-
setLastError(void 0);
|
|
540
|
-
}
|
|
541
|
-
try {
|
|
542
|
-
return await callback(client);
|
|
543
|
-
} catch (error) {
|
|
544
|
-
const be = error instanceof BaerlyError ? error : new BaerlyError("MutationFailed", error instanceof Error ? error.message : String(error), error);
|
|
545
|
-
if (mountedRef.current) setLastError(be);
|
|
546
|
-
throw be;
|
|
547
|
-
} finally {
|
|
548
|
-
inFlightRef.current -= 1;
|
|
549
|
-
if (inFlightRef.current === 0 && mountedRef.current) setIsPending(false);
|
|
550
|
-
}
|
|
551
|
-
}, [client]), useMemo(() => ({
|
|
552
|
-
isPending,
|
|
553
|
-
error: lastError
|
|
554
|
-
}), [isPending, lastError])];
|
|
555
|
-
};
|
|
592
|
+
const createBaerlyReact = () => ({
|
|
593
|
+
BaerlyProvider,
|
|
594
|
+
useQuery,
|
|
595
|
+
useMutation,
|
|
596
|
+
useBaerlyClient
|
|
597
|
+
});
|
|
556
598
|
//#endregion
|
|
557
|
-
export {
|
|
599
|
+
export { createBaerlyReact };
|
|
558
600
|
|
|
559
601
|
//# sourceMappingURL=client-react.js.map
|
package/dist/client-react.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"client-react.js","names":[],"sources":["../packages/client/src/react/provider.ts","../packages/client/src/react/stable-key.ts","../packages/client/src/poll-since-once.ts","../packages/client/src/react/subscription-pool.ts","../packages/client/src/react/use-query.ts","../packages/client/src/react/use-mutation.ts"],"sourcesContent":["import { createContext, createElement, useContext, type ReactNode } from \"react\";\nimport type { BaerlyConfig, UnboundConfig } from \"@baerly/protocol\";\nimport type { BaerlyClient } from \"../client.ts\";\n\nconst ClientContext = createContext<BaerlyClient | undefined>(undefined);\n\nexport interface BaerlyProviderProps {\n readonly client: BaerlyClient;\n readonly children?: ReactNode;\n}\n\n/**\n * Provides a {@link BaerlyClient} to every Baerly React hook below it.\n * Wrap your app once near the root; the hooks read the client from\n * this context and have no `client` argument.\n *\n * @example\n * ```tsx\n * import { createBaerlyClient } from \"@gusto/baerly-storage/client\";\n * import { BaerlyProvider } from \"@gusto/baerly-storage/client/react\";\n *\n * const client = createBaerlyClient({ baseUrl: \"/api\" });\n *\n * <BaerlyProvider client={client}>\n * <App />\n * </BaerlyProvider>\n * ```\n */\nexport const BaerlyProvider = ({ client, children }: BaerlyProviderProps): React.JSX.Element =>\n createElement(ClientContext.Provider, { value: client }, children);\n\n/**\n * Returns the {@link BaerlyClient} provided by the nearest\n * {@link BaerlyProvider}. Throws a clear error if called outside a\n * provider — every hook in this package uses it, so a missing\n * provider surfaces here first.\n *\n * Use this directly when you need imperative access — e.g. inside an\n * event handler that performs a one-shot read or a custom long-poll.\n * For declarative reads and mutations, prefer the typed hooks.\n *\n * @example\n * ```tsx\n * const client = useBaerlyClient<MyConfig>();\n * const onExport = async () => {\n * const rows = await client.collection(\"tickets\").all();\n * download(rows);\n * };\n * ```\n */\nexport const useBaerlyClient = <\n TConfig extends BaerlyConfig = UnboundConfig,\n>(): BaerlyClient<TConfig> => {\n const client = useContext(ClientContext);\n if (client === undefined) {\n throw new Error(\n \"useBaerlyClient (and every Baerly React hook) must be used inside <BaerlyProvider>. \" +\n \"Wrap your app: <BaerlyProvider client={client}>…</BaerlyProvider>.\",\n );\n }\n return client as BaerlyClient<TConfig>;\n};\n","/**\n * Deterministic JSON serialization with sorted object keys. `useQuery`\n * feeds its `[chainShape, deps]` tuple into this to compute the\n * read-signature that keys the subscription-pool's result cache.\n * Sorting keys means `{ a: 1, b: 2 }` and `{ b: 2, a: 1 }` stringify\n * identically, which `JSON.stringify` alone does not guarantee (it\n * preserves insertion order).\n *\n * Inputs are caller-declared `deps` plus the deterministic chain\n * shape — no `undefined`, no functions, no circular references — so\n * a recursive walk terminates and the output is well-defined. Arrays\n * are serialized positionally.\n *\n * @internal\n */\nexport const stableKey = (value: unknown): string => {\n if (value === null || typeof value !== \"object\") {\n return JSON.stringify(value);\n }\n if (Array.isArray(value)) {\n return `[${value.map(stableKey).join(\",\")}]`;\n }\n const entries = Object.entries(value as Record<string, unknown>).toSorted(([a], [b]) =>\n compareStrings(a, b),\n );\n return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableKey(v)}`).join(\",\")}}`;\n};\n\n// Lex compare for object-key ordering. `localeCompare` is locale-aware\n// and would re-order BMP code points; we need byte-stable output so the\n// `useEffect` deps key is identical across machines.\nconst compareStrings = (a: string, b: string): number => {\n if (a < b) {\n return -1;\n }\n if (a > b) {\n return 1;\n }\n return 0;\n};\n","import type { SinceResponse } from \"./contract.ts\";\nimport { type RequestContext, request } from \"./request.ts\";\n\n/**\n * One round-trip of `GET /v1/since?collection=…&cursor=…`. The single\n * place that talks to `/v1/since` in this package — the React\n * `subscription-pool` is its only first-party consumer.\n *\n * Long-poll semantics live server-side: the call resolves once the\n * server's budget elapses (`{ events: [], next_cursor: <same> }`) or\n * one or more events arrive. Callers are expected to loop over this\n * helper, threading `next_cursor` through.\n *\n * `cursor === \"\"` means \"start at `log_seq_start`\" (the wire\n * protocol); pass the previously returned `next_cursor` to resume.\n *\n * `signal` cancels the underlying fetch via the standard\n * `AbortController` plumbing; the rejection propagates as\n * `AbortError`.\n */\nexport const pollSinceOnce = async (\n ctx: RequestContext,\n name: string,\n cursor: string,\n signal: AbortSignal | undefined,\n): Promise<SinceResponse> => {\n const params = new URLSearchParams();\n params.set(\"collection\", name);\n params.set(\"cursor\", cursor);\n return request<SinceResponse>(ctx, {\n method: \"GET\",\n path: `/v1/since?${params.toString()}`,\n signal,\n });\n};\n","import { BaerlyError } from \"@baerly/protocol\";\nimport type { BaerlyClient } from \"../client.ts\";\nimport { getClientContext } from \"../internal/context.ts\";\nimport { pollSinceOnce } from \"../poll-since-once.ts\";\n\n/**\n * Discriminated snapshot a hook hands back from `getSnapshot`. The\n * `useQuery` types narrow this further (data: T vs data: undefined);\n * the pool stores it generically so the cache can be a single\n * `Map<signature, CachedSnapshot>`.\n */\nexport interface CachedSnapshot {\n readonly status: \"loading\" | \"refreshing\" | \"ok\" | \"error\";\n readonly data: unknown;\n readonly error: Error | undefined;\n}\n\nexport const LOADING_SNAPSHOT: CachedSnapshot = Object.freeze({\n status: \"loading\",\n data: undefined,\n error: undefined,\n});\n\nconst toError = (raw: unknown): Error => {\n if (raw instanceof BaerlyError || raw instanceof Error) {\n return raw;\n }\n return new BaerlyError(\"Internal\", String(raw));\n};\n\ninterface CacheEntry {\n snapshot: CachedSnapshot;\n /** Tables this signature's chain references — used for invalidation. */\n readonly chainTables: ReadonlySet<string>;\n /** Aborts the in-flight read for this signature, if any. */\n inFlight: AbortController | undefined;\n}\n\ninterface TablePoll {\n refcount: number;\n controller: AbortController;\n cursor: string;\n}\n\ninterface SubscriptionPool {\n /** Register a subscriber. Returns an unsubscribe. */\n attach(\n signature: string,\n tables: ReadonlyArray<string>,\n chainTables: ReadonlySet<string>,\n fetcher: () => Promise<unknown>,\n notify: () => void,\n ): () => void;\n /** Read the cached snapshot for `signature` (or the canonical loading sentinel). */\n getSnapshot(signature: string): CachedSnapshot;\n}\n\nconst poolByClient = new WeakMap<BaerlyClient, SubscriptionPool>();\n\n/** Returns the (lazily-created) pool for `client`. */\nexport const poolFor = (client: BaerlyClient): SubscriptionPool => {\n let pool = poolByClient.get(client);\n if (pool === undefined) {\n pool = createPool(client);\n poolByClient.set(client, pool);\n }\n return pool;\n};\n\nconst createPool = (client: BaerlyClient): SubscriptionPool => {\n const cache = new Map<string, CacheEntry>();\n const subscribersBySignature = new Map<string, Set<() => void>>();\n const tablePolls = new Map<string, TablePoll>();\n\n const notifyAll = (signature: string): void => {\n const subs = subscribersBySignature.get(signature);\n if (subs === undefined) {\n return;\n }\n for (const notify of subs) {\n notify();\n }\n };\n\n const dispatchFetch = (signature: string, fetcher: () => Promise<unknown>): void => {\n const entry = cache.get(signature);\n if (entry === undefined) {\n return;\n }\n if (entry.inFlight !== undefined) {\n entry.inFlight.abort();\n }\n const controller = new AbortController();\n entry.inFlight = controller;\n const prevSnapshot = entry.snapshot;\n const hadData = entry.snapshot.status === \"ok\" || entry.snapshot.status === \"refreshing\";\n entry.snapshot = hadData\n ? { status: \"refreshing\", data: entry.snapshot.data, error: undefined }\n : LOADING_SNAPSHOT;\n if (entry.snapshot !== prevSnapshot) {\n notifyAll(signature);\n }\n void (async () => {\n try {\n const data = await fetcher();\n if (controller.signal.aborted) {\n return;\n }\n const live = cache.get(signature);\n if (live === undefined || live.inFlight !== controller) {\n return;\n }\n live.snapshot = { status: \"ok\", data, error: undefined };\n live.inFlight = undefined;\n notifyAll(signature);\n } catch (error) {\n if (controller.signal.aborted) {\n return;\n }\n const live = cache.get(signature);\n if (live === undefined || live.inFlight !== controller) {\n return;\n }\n const wrapped = toError(error);\n live.snapshot = {\n status: \"error\",\n data: live.snapshot.data,\n error: wrapped,\n };\n live.inFlight = undefined;\n notifyAll(signature);\n }\n })();\n };\n\n const invalidateForTable = (table: string): void => {\n for (const [signature, entry] of cache) {\n if (!entry.chainTables.has(table)) {\n continue;\n }\n const subs = subscribersBySignature.get(signature);\n if (subs === undefined || subs.size === 0) {\n continue;\n }\n // Any subscriber's fetcher is fine — they all produce the\n // same call against the real client for this signature\n // (signature is hashed on chain shape + deps).\n const fetcher = signatureFetchers.get(signature);\n if (fetcher !== undefined) {\n dispatchFetch(signature, fetcher);\n }\n }\n };\n\n /** Per-signature fetcher; last writer wins (all fetchers for a signature are equivalent). */\n const signatureFetchers = new Map<string, () => Promise<unknown>>();\n\n const startTablePoll = (table: string): void => {\n if (tablePolls.has(table)) {\n return;\n }\n const controller = new AbortController();\n const poll: TablePoll = { refcount: 1, controller, cursor: \"\" };\n tablePolls.set(table, poll);\n const ctx = getClientContext(client);\n void (async () => {\n while (!controller.signal.aborted) {\n try {\n const res = await pollSinceOnce(ctx, table, poll.cursor, controller.signal);\n if (controller.signal.aborted) {\n return;\n }\n if (res.events.length > 0 || res.next_cursor !== poll.cursor) {\n poll.cursor = res.next_cursor;\n if (res.events.length > 0) {\n invalidateForTable(table);\n }\n }\n } catch (error) {\n if (controller.signal.aborted) {\n return;\n }\n if (error instanceof DOMException && error.name === \"AbortError\") {\n return;\n }\n // 1-second backoff on error to avoid hot-spinning on a\n // persistent failure; downstream subscribers' next fetch\n // sees the same error if it doesn't clear.\n await new Promise((r) => setTimeout(r, 1000));\n }\n }\n })();\n };\n\n const stopTablePoll = (table: string): void => {\n const poll = tablePolls.get(table);\n if (poll === undefined) {\n return;\n }\n poll.refcount--;\n if (poll.refcount === 0) {\n poll.controller.abort();\n tablePolls.delete(table);\n }\n };\n\n const incrementTablePoll = (table: string): void => {\n const poll = tablePolls.get(table);\n if (poll === undefined) {\n startTablePoll(table);\n } else {\n poll.refcount++;\n }\n };\n\n return {\n getSnapshot(signature: string): CachedSnapshot {\n return cache.get(signature)?.snapshot ?? LOADING_SNAPSHOT;\n },\n attach(signature, tables, chainTables, fetcher, notify) {\n let entry = cache.get(signature);\n const isFirstSubscriber = entry === undefined;\n if (entry === undefined) {\n entry = {\n snapshot: LOADING_SNAPSHOT,\n chainTables,\n inFlight: undefined,\n };\n cache.set(signature, entry);\n }\n signatureFetchers.set(signature, fetcher);\n let subs = subscribersBySignature.get(signature);\n if (subs === undefined) {\n subs = new Set();\n subscribersBySignature.set(signature, subs);\n }\n subs.add(notify);\n for (const table of tables) {\n incrementTablePoll(table);\n }\n if (isFirstSubscriber) {\n dispatchFetch(signature, fetcher);\n } else {\n // Cache already has data (or in-flight). The new subscriber\n // gets the existing snapshot via getSnapshot; no extra fetch.\n }\n return () => {\n const liveSubs = subscribersBySignature.get(signature);\n if (liveSubs !== undefined) {\n liveSubs.delete(notify);\n if (liveSubs.size === 0) {\n subscribersBySignature.delete(signature);\n const liveEntry = cache.get(signature);\n if (liveEntry !== undefined) {\n liveEntry.inFlight?.abort();\n cache.delete(signature);\n }\n signatureFetchers.delete(signature);\n }\n }\n for (const table of tables) {\n stopTablePoll(table);\n }\n };\n },\n };\n};\n","import { type BaerlyConfig, BaerlyError, type UnboundConfig } from \"@baerly/protocol\";\nimport { useCallback, useReducer, useRef, useSyncExternalStore } from \"react\";\nimport type { BaerlyClient } from \"../client.ts\";\nimport { useBaerlyClient } from \"./provider.ts\";\nimport { stableKey } from \"./stable-key.ts\";\nimport { LOADING_SNAPSHOT, poolFor } from \"./subscription-pool.ts\";\n\nconst SKIP: unique symbol = Symbol(\"baerly.useQuery.skip\");\n\n/**\n * Result handed back by {@link useQuery}. Discriminate on `status` —\n * narrowing into `\"ok\"` / `\"refreshing\"` gives `data: T`; narrowing\n * into `\"loading\"` / `\"skipped\"` gives `data: undefined`; narrowing\n * into `\"error\"` gives `data: T | undefined` (the prior successful\n * read survives across errors so the UI can keep rendering).\n */\nexport type UseQueryResult<T> =\n | { readonly status: \"loading\"; readonly data: undefined; readonly error: undefined }\n | { readonly status: \"refreshing\"; readonly data: T; readonly error: undefined }\n | { readonly status: \"ok\"; readonly data: T; readonly error: undefined }\n | { readonly status: \"skipped\"; readonly data: undefined; readonly error: undefined }\n | { readonly status: \"error\"; readonly data: T | undefined; readonly error: Error };\n\nconst SKIPPED_SNAPSHOT: UseQueryResult<never> = Object.freeze({\n status: \"skipped\",\n data: undefined,\n error: undefined,\n});\n\ninterface RecorderState {\n readonly collectionsRead: Set<string>;\n readonly chain: Array<string>;\n}\n\nconst WRITE_METHODS = new Set([\"insert\", \"update\", \"replace\", \"delete\"]);\n\nconst awaitedError = (prop: string | symbol): BaerlyError =>\n new BaerlyError(\n \"UseQueryAwaitedRecorder\",\n `useQuery callbacks must not dereference the result of an awaited recorder terminal — property access (${String(prop)}) on the awaited value throws. The recorder is for the synchronous prefix of the callback only. For compound reads, use Promise.all (parallel) or compose two useQuery calls with useQuery.skip (dependent). See the lint rule baerly/no-await-in-use-query for the edit-time check.`,\n );\n\n/**\n * Sentinel handed back when a recorder terminal is awaited. Every\n * own-property access throws `BaerlyError(\"UseQueryAwaitedRecorder\")`;\n * `Symbol.*` accesses (which the JS engine uses internally —\n * Symbol.toPrimitive, Symbol.iterator, etc.) return undefined so the\n * sentinel can flow through engine-side coercions without spurious\n * throws. The single shared instance avoids per-render allocation.\n */\nconst SENTINEL_SAFE_PROPS = new Set<string | symbol>([\n // The JS engine probes `.then` to test whether a value is a\n // thenable while resolving Promises. Returning undefined makes the\n // sentinel look like a non-thenable so awaiting it yields the\n // sentinel itself (not a chained Promise) — and our error fires on\n // the next, user-visible property access.\n \"then\",\n // `.catch` and `.finally` are sometimes probed similarly.\n \"catch\",\n \"finally\",\n // `Symbol.toStringTag` etc. are probed by `String()` and JSON\n // serialization. The generic `typeof prop === \"symbol\"` branch\n // already covers these; keep them here for explicit reference.\n]);\n\nconst AWAITED_SENTINEL: unknown = new Proxy(\n Object.create(null) as Record<string | symbol, unknown>,\n {\n get(_target, prop) {\n if (typeof prop === \"symbol\" || SENTINEL_SAFE_PROPS.has(prop)) {\n return undefined;\n }\n throw awaitedError(prop);\n },\n },\n);\n\nconst TERMINAL_RESULT: Promise<unknown> = Promise.resolve(AWAITED_SENTINEL);\n\nconst makeTerminal = (): Promise<unknown> => TERMINAL_RESULT;\n\nconst makeQuery = (state: RecorderState): unknown => {\n const query: Record<string, unknown> = {};\n for (const modifier of [\"where\", \"order\", \"limit\"]) {\n query[modifier] = (): unknown => {\n state.chain.push(modifier);\n return query;\n };\n }\n for (const terminal of [\"first\", \"all\", \"count\"]) {\n query[terminal] = (): unknown => {\n state.chain.push(terminal);\n return makeTerminal();\n };\n }\n return query;\n};\n\nconst makeCollection = (name: string, state: RecorderState): unknown => {\n state.collectionsRead.add(name);\n state.chain.push(`collection:${name}`);\n const collection: Record<string, unknown> = {\n name,\n };\n for (const modifier of [\"where\", \"order\", \"limit\"]) {\n collection[modifier] = (): unknown => {\n state.chain.push(modifier);\n return makeQuery(state);\n };\n }\n for (const terminal of [\"first\", \"all\", \"count\", \"get\"]) {\n collection[terminal] = (): unknown => {\n state.chain.push(terminal);\n return makeTerminal();\n };\n }\n for (const write of WRITE_METHODS) {\n collection[write] = (): never => {\n throw new BaerlyError(\n \"UnexpectedWriteInQuery\",\n `useQuery callbacks must not write to the database. .${write}() was called on collection \"${name}\". Use useMutation() instead.`,\n );\n };\n }\n return collection;\n};\n\nconst createRecorder = (): { client: unknown; state: RecorderState } => {\n const state: RecorderState = {\n collectionsRead: new Set(),\n chain: [],\n };\n const recorder = {\n collection: (name: string): unknown => makeCollection(name, state),\n healthz: (): never => {\n throw new BaerlyError(\n \"UnexpectedWriteInQuery\",\n \"useQuery callbacks must not call client.healthz(); use useMutation() or the bare client.\",\n );\n },\n };\n return { client: recorder, state };\n};\n\ninterface DiscoveryOk {\n readonly kind: \"ok\";\n readonly collections: ReadonlyArray<string>;\n readonly chainShape: string;\n readonly callbackResult: unknown;\n}\ninterface DiscoverySkip {\n readonly kind: \"skip\";\n}\ninterface DiscoveryError {\n readonly kind: \"error\";\n readonly error: Error;\n}\ntype DiscoveryResult = DiscoveryOk | DiscoverySkip | DiscoveryError;\n\nconst discover = (\n callback: (client: BaerlyClient) => Promise<unknown> | typeof SKIP,\n): DiscoveryResult => {\n const { client: recorder, state } = createRecorder();\n let callbackResult: unknown;\n try {\n callbackResult = callback(recorder as BaerlyClient);\n } catch (error) {\n return {\n kind: \"error\",\n error: error instanceof Error ? error : new BaerlyError(\"Internal\", String(error)),\n };\n }\n if (callbackResult === SKIP) {\n return { kind: \"skip\" };\n }\n return {\n kind: \"ok\",\n collections: [...state.collectionsRead].toSorted(),\n chainShape: stableKey(state.chain),\n callbackResult,\n };\n};\n\n/**\n * Reactive read against a `baerly` server. The callback receives a\n * type-compatible `BaerlyClient` proxy that records which collections it\n * touches; the hook subscribes to those collections and re-runs the\n * callback against the real client when any of them mutate.\n *\n * Re-runs also fire whenever the `deps` array changes between\n * renders (shallow `stableKey` compare). Closure variables read\n * inside the callback must be listed in `deps` — the companion\n * `baerly/exhaustive-deps-use-query` lint rule flags missing\n * entries.\n *\n * Returning {@link useQuery.skip} from the callback yields\n * `{ status: \"skipped\" }` and registers no subscription — use it\n * for deferred / conditional reads.\n *\n * @example\n * ```tsx\n * // Single read\n * const note = useQuery((c) => c.collection(\"notes\").get(id), [id]);\n * if (note.status === \"loading\") return <Spinner/>;\n * if (note.status === \"error\") return <Err e={note.error}/>;\n * return <pre>{note.data?.body}</pre>; // typed Note | undefined\n *\n * // Deferred read\n * const list = useQuery(\n * (c) => userId ? c.collection(\"notes\").where({ authorId: userId }).all() : useQuery.skip,\n * [userId],\n * );\n * if (list.status === \"skipped\") return null;\n *\n * // Dependent read (parent → child)\n * const parent = useQuery((c) => c.collection(\"notes\").get(id), [id]);\n * const replies = useQuery(\n * (c) => parent.status === \"ok\"\n * ? c.collection(\"comments\").where({ noteId: parent.data._id }).all()\n * : useQuery.skip,\n * [parent.status === \"ok\" ? parent.data._id : undefined],\n * );\n * ```\n */\nconst useQueryImpl = <T, TConfig extends BaerlyConfig = UnboundConfig>(\n callback: (client: BaerlyClient<TConfig>) => Promise<T> | typeof SKIP,\n deps?: ReadonlyArray<unknown>,\n): UseQueryResult<T> => {\n const client = useBaerlyClient<TConfig>();\n const pool = poolFor(client as unknown as BaerlyClient);\n\n const callbackRef = useRef(callback);\n callbackRef.current = callback;\n\n // Force-update for async-error capture (see below). Used to push\n // a microtask-deferred recorder-await rejection back into a sync\n // render.\n const [, forceUpdate] = useReducer((c: number) => c + 1, 0);\n const asyncErrorRef = useRef<BaerlyError | undefined>(undefined);\n\n // Recorder pass. Cheap — no I/O.\n const discovery = discover(\n callbackRef.current as (client: BaerlyClient) => Promise<unknown> | typeof SKIP,\n );\n\n // The signature inputs that need to be stable across the same\n // logical query: chain shape + caller-declared deps.\n const depsKey = stableKey([deps ?? []]);\n const signatureBase =\n discovery.kind === \"ok\"\n ? stableKey([discovery.chainShape, deps ?? []])\n : `__non_ok__${discovery.kind}__${depsKey}`;\n\n // Reset the captured async error if the signature changed (the\n // user is on a different query now — give them a fresh chance).\n const lastSignatureRef = useRef<string>(\"\");\n if (lastSignatureRef.current !== signatureBase) {\n lastSignatureRef.current = signatureBase;\n asyncErrorRef.current = undefined;\n }\n\n // Attach an async-error handler to the callback's returned value\n // so that any microtask-deferred rejection from sentinel access\n // (sequential-await pattern) flows back into render via\n // forceUpdate. Wrap in `Promise.resolve(...)` so a bare recorder\n // terminal (Promise<sentinel>) is observed too — the resolved\n // value carries no `.catch`. Always attach (even if asyncErrorRef\n // is already set) so the per-render discovery invocation's\n // rejection is observed and doesn't surface as an unhandled\n // rejection from vitest or the host runtime.\n if (discovery.kind === \"ok\") {\n const result = discovery.callbackResult;\n if (\n result !== null &&\n typeof result === \"object\" &&\n typeof (result as { then?: unknown }).then === \"function\"\n ) {\n Promise.resolve(result as PromiseLike<unknown>).then(\n () => {\n /* discovery success — value discarded */\n },\n (error: unknown) => {\n if (\n error instanceof BaerlyError &&\n error.code === \"UseQueryAwaitedRecorder\" &&\n asyncErrorRef.current === undefined\n ) {\n asyncErrorRef.current = error;\n forceUpdate();\n }\n // Any other rejection is silently swallowed here — the\n // pool's real-client fetch path is the canonical surface\n // for non-recorder errors.\n },\n );\n }\n }\n\n // Subscription channel — stable per (client, collectionsRead.join(\" \")).\n // Pool's getSnapshot returns the current cached entry for this\n // signature; React polls it on subscribe + on every notify.\n const collectionsJoin =\n discovery.kind === \"ok\" ? discovery.collections.join(\"\\x00\") : \"__non_ok__\";\n\n const fetcherRef = useRef<() => Promise<unknown>>(() => Promise.resolve(undefined));\n fetcherRef.current = (): Promise<unknown> => {\n const out = callbackRef.current(client) as Promise<unknown> | typeof SKIP;\n if (out === SKIP) {\n return Promise.resolve(undefined);\n }\n return out as Promise<unknown>;\n };\n\n const chainCollectionsRef = useRef<ReadonlySet<string>>(new Set());\n const discoveryKindRef = useRef<DiscoveryResult[\"kind\"]>(\"ok\");\n const discoveryErrorRef = useRef<Error | undefined>(undefined);\n discoveryKindRef.current = discovery.kind;\n if (discovery.kind === \"ok\") {\n chainCollectionsRef.current = new Set(discovery.collections);\n discoveryErrorRef.current = undefined;\n } else if (discovery.kind === \"error\") {\n discoveryErrorRef.current = discovery.error;\n } else {\n discoveryErrorRef.current = undefined;\n }\n\n const subscribe = useCallback(\n (notify: () => void): (() => void) => {\n if (discovery.kind !== \"ok\") {\n return () => {};\n }\n return pool.attach(\n signatureBase,\n discovery.collections,\n chainCollectionsRef.current,\n () => fetcherRef.current(),\n notify,\n );\n },\n // The signature/collections determine the subscription; React\n // re-subscribes when either changes.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [pool, signatureBase, collectionsJoin],\n );\n\n // Stable per-error snapshot cache so repeated getSnapshot polls\n // within a single render return the same reference. React's\n // useSyncExternalStore detects identity changes; constructing a\n // fresh error literal each call drives an infinite re-render.\n const errorSnapshotRef = useRef<\n | {\n error: Error;\n snapshot: UseQueryResult<unknown>;\n }\n | undefined\n >(undefined);\n const snapshotForError = (err: Error): UseQueryResult<T> => {\n if (errorSnapshotRef.current?.error === err) {\n return errorSnapshotRef.current.snapshot as UseQueryResult<T>;\n }\n const snapshot = {\n status: \"error\" as const,\n data: undefined,\n error: err,\n } satisfies UseQueryResult<unknown>;\n errorSnapshotRef.current = { error: err, snapshot };\n return snapshot as UseQueryResult<T>;\n };\n\n const getSnapshot = useCallback((): UseQueryResult<T> => {\n if (asyncErrorRef.current) {\n return snapshotForError(asyncErrorRef.current);\n }\n if (discoveryKindRef.current === \"skip\") {\n return SKIPPED_SNAPSHOT as UseQueryResult<T>;\n }\n if (discoveryKindRef.current === \"error\") {\n return snapshotForError(\n discoveryErrorRef.current ?? new BaerlyError(\"Internal\", \"unknown discovery error\"),\n );\n }\n return pool.getSnapshot(signatureBase) as UseQueryResult<T>;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [pool, signatureBase]);\n\n // discoveryKindRef + discoveryErrorRef carry the latest discovery\n // state into getSnapshot without making it a useCallback dep\n // (avoids re-creating the snapshot callback every render).\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n};\n\n/**\n * Reactive read hook. See {@link useQueryImpl} JSDoc for usage.\n * The `.skip` property is the sentinel that short-circuits the hook\n * into `status: \"skipped\"`.\n */\nexport const useQuery: {\n <T, TConfig extends BaerlyConfig = UnboundConfig>(\n callback: (client: BaerlyClient<TConfig>) => Promise<T> | typeof SKIP,\n deps?: ReadonlyArray<unknown>,\n ): UseQueryResult<T>;\n readonly skip: typeof SKIP;\n} = Object.assign(useQueryImpl, { skip: SKIP }) as {\n <T, TConfig extends BaerlyConfig = UnboundConfig>(\n callback: (client: BaerlyClient<TConfig>) => Promise<T> | typeof SKIP,\n deps?: ReadonlyArray<unknown>,\n ): UseQueryResult<T>;\n readonly skip: typeof SKIP;\n};\n\n// Quiet `LOADING_SNAPSHOT` as a value-import — referenced by\n// generated type for the `loading` branch only; bundled alongside\n// `subscription-pool.ts`.\nvoid LOADING_SNAPSHOT;\n","import { type BaerlyConfig, BaerlyError, type UnboundConfig } from \"@baerly/protocol\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { BaerlyClient } from \"../client.ts\";\nimport { useBaerlyClient } from \"./provider.ts\";\n\n/**\n * Tuple returned by {@link useMutation}. Positionally mirrors React\n * 19's `useActionState`: `[mutate, state]`. `mutate` is stable across\n * renders; `state` is a fresh object only when `isPending` or\n * `error` actually flips.\n */\nexport type UseMutationTuple<TConfig extends BaerlyConfig = UnboundConfig> = readonly [\n mutate: <T>(callback: (client: BaerlyClient<TConfig>) => Promise<T>) => Promise<T>,\n state: { readonly isPending: boolean; readonly error: BaerlyError | undefined },\n];\n\n/**\n * Imperative mutation hook. `mutate(callback)` runs the callback\n * against the real `BaerlyClient` and resolves to whatever the\n * callback returns; `state` carries `isPending` (refcounted across\n * concurrent submits — `true` until every in-flight call settles)\n * and `error` (last-wins; the most recent rejection until the next\n * successful call clears it).\n *\n * Errors are normalised to {@link BaerlyError}: a non-`BaerlyError`\n * throwable from the callback is wrapped under\n * `code: \"MutationFailed\"` with the original on `.cause`.\n *\n * @example\n * ```tsx\n * const [mutate, { isPending, error }] = useMutation();\n * <button\n * disabled={isPending}\n * onClick={() => mutate((client) => client.collection(\"notes\").insert({ body }))}\n * >\n * {isPending ? \"Saving…\" : \"Save\"}\n * </button>\n * {error ? <p>{error.message}</p> : null}\n * ```\n */\nexport const useMutation = <\n TConfig extends BaerlyConfig = UnboundConfig,\n>(): UseMutationTuple<TConfig> => {\n const client = useBaerlyClient<TConfig>();\n const inFlightRef = useRef<number>(0);\n const mountedRef = useRef<boolean>(true);\n const [isPending, setIsPending] = useState<boolean>(false);\n const [lastError, setLastError] = useState<BaerlyError | undefined>(undefined);\n\n useEffect(\n () => () => {\n mountedRef.current = false;\n },\n [],\n );\n\n const mutate = useCallback(\n async <T>(callback: (c: BaerlyClient<TConfig>) => Promise<T>): Promise<T> => {\n const wasIdle = inFlightRef.current === 0;\n inFlightRef.current += 1;\n if (wasIdle && mountedRef.current) {\n setIsPending(true);\n setLastError(undefined);\n }\n try {\n const result = await callback(client);\n return result;\n } catch (error) {\n const be =\n error instanceof BaerlyError\n ? error\n : new BaerlyError(\n \"MutationFailed\",\n error instanceof Error ? error.message : String(error),\n error,\n );\n if (mountedRef.current) {\n setLastError(be);\n }\n throw be;\n } finally {\n inFlightRef.current -= 1;\n if (inFlightRef.current === 0 && mountedRef.current) {\n setIsPending(false);\n }\n }\n },\n [client],\n );\n\n const state = useMemo(() => ({ isPending, error: lastError }), [isPending, lastError]);\n\n return [mutate, state] as const;\n};\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"client-react.js","names":[],"sources":["../packages/client/src/react/provider.ts","../packages/client/src/react/use-mutation.ts","../packages/client/src/react/stable-key.ts","../packages/client/src/poll-since-once.ts","../packages/client/src/react/subscription-pool.ts","../packages/client/src/react/use-query.ts","../packages/client/src/react/create-react.ts"],"sourcesContent":["import { createContext, createElement, useContext, type ReactNode } from \"react\";\nimport type { BaerlyConfig, UnboundConfig } from \"@baerly/protocol\";\nimport type { BaerlyClient } from \"../client.ts\";\n\nconst ClientContext = createContext<BaerlyClient | undefined>(undefined);\n\nexport interface BaerlyProviderProps {\n readonly client: BaerlyClient;\n readonly children?: ReactNode;\n}\n\n/**\n * Provides a {@link BaerlyClient} to every Baerly React hook below it.\n * Wrap your app once near the root; the hooks read the client from\n * this context and have no `client` argument.\n *\n * Obtained from {@link createBaerlyReact}, not imported directly:\n *\n * @example\n * ```tsx\n * import { createBaerlyClient } from \"@gusto/baerly-storage/client\";\n * import { createBaerlyReact } from \"@gusto/baerly-storage/client/react\";\n * import config from \"./baerly.config.ts\";\n *\n * const client = createBaerlyClient({ baseUrl: \"/api\", config });\n * const { BaerlyProvider } = createBaerlyReact<typeof config>();\n *\n * <BaerlyProvider client={client}>\n * <App />\n * </BaerlyProvider>\n * ```\n */\nexport const BaerlyProvider = ({ client, children }: BaerlyProviderProps): React.JSX.Element =>\n createElement(ClientContext.Provider, { value: client }, children);\n\n/**\n * Returns the {@link BaerlyClient} provided by the nearest\n * {@link BaerlyProvider}. Throws a clear error if called outside a\n * provider — every hook in this package uses it, so a missing\n * provider surfaces here first.\n *\n * Use this directly when you need imperative access — e.g. inside an\n * event handler that performs a one-shot read or a custom long-poll.\n * For declarative reads and mutations, prefer the typed hooks.\n *\n * @example\n * ```tsx\n * const client = useBaerlyClient<MyConfig>();\n * const onExport = async () => {\n * const rows = await client.collection(\"tickets\").all();\n * download(rows);\n * };\n * ```\n */\nexport const useBaerlyClient = <\n TConfig extends BaerlyConfig = UnboundConfig,\n>(): BaerlyClient<TConfig> => {\n const client = useContext(ClientContext);\n if (client === undefined) {\n throw new Error(\n \"useBaerlyClient (and every Baerly React hook) must be used inside <BaerlyProvider>. \" +\n \"Wrap your app: <BaerlyProvider client={client}>…</BaerlyProvider>.\",\n );\n }\n return client as BaerlyClient<TConfig>;\n};\n","import { type BaerlyConfig, BaerlyError, type UnboundConfig } from \"@baerly/protocol\";\nimport { useCallback, useEffect, useMemo, useRef, useState } from \"react\";\nimport type { BaerlyClient } from \"../client.ts\";\nimport { useBaerlyClient } from \"./provider.ts\";\n\n/**\n * Tuple returned by {@link useMutation}. Positionally mirrors React\n * 19's `useActionState`: `[mutate, state]`. `mutate` is stable across\n * renders; `state` is a fresh object only when `isPending` or\n * `error` actually flips.\n */\nexport type UseMutationTuple<TConfig extends BaerlyConfig = UnboundConfig> = readonly [\n mutate: <T>(callback: (client: BaerlyClient<TConfig>) => Promise<T>) => Promise<T>,\n state: { readonly isPending: boolean; readonly error: BaerlyError | undefined },\n];\n\n/**\n * Imperative mutation hook. `mutate(callback)` runs the callback\n * against the real `BaerlyClient` and resolves to whatever the\n * callback returns; `state` carries `isPending` (refcounted across\n * concurrent submits — `true` until every in-flight call settles)\n * and `error` (last-wins; the most recent rejection until the next\n * successful call clears it).\n *\n * Errors are normalised to {@link BaerlyError}: a non-`BaerlyError`\n * throwable from the callback is wrapped under\n * `code: \"MutationFailed\"` with the original on `.cause`.\n *\n * @example\n * ```tsx\n * const [mutate, { isPending, error }] = useMutation();\n * <button\n * disabled={isPending}\n * onClick={() => mutate((client) => client.collection(\"notes\").insert({ body }))}\n * >\n * {isPending ? \"Saving…\" : \"Save\"}\n * </button>\n * {error ? <p>{error.message}</p> : null}\n * ```\n */\nexport const useMutation = <\n TConfig extends BaerlyConfig = UnboundConfig,\n>(): UseMutationTuple<TConfig> => {\n const client = useBaerlyClient<TConfig>();\n const inFlightRef = useRef<number>(0);\n const mountedRef = useRef<boolean>(true);\n const [isPending, setIsPending] = useState<boolean>(false);\n const [lastError, setLastError] = useState<BaerlyError | undefined>(undefined);\n\n useEffect(\n () => () => {\n mountedRef.current = false;\n },\n [],\n );\n\n const mutate = useCallback(\n async <T>(callback: (c: BaerlyClient<TConfig>) => Promise<T>): Promise<T> => {\n const wasIdle = inFlightRef.current === 0;\n inFlightRef.current += 1;\n if (wasIdle && mountedRef.current) {\n setIsPending(true);\n setLastError(undefined);\n }\n try {\n const result = await callback(client);\n return result;\n } catch (error) {\n const be =\n error instanceof BaerlyError\n ? error\n : new BaerlyError(\n \"MutationFailed\",\n error instanceof Error ? error.message : String(error),\n error,\n );\n if (mountedRef.current) {\n setLastError(be);\n }\n throw be;\n } finally {\n inFlightRef.current -= 1;\n if (inFlightRef.current === 0 && mountedRef.current) {\n setIsPending(false);\n }\n }\n },\n [client],\n );\n\n const state = useMemo(() => ({ isPending, error: lastError }), [isPending, lastError]);\n\n return [mutate, state] as const;\n};\n","/**\n * Deterministic JSON serialization with sorted object keys. `useQuery`\n * feeds its `[chainShape, deps]` tuple into this to compute the\n * read-signature that keys the subscription-pool's result cache.\n * Sorting keys means `{ a: 1, b: 2 }` and `{ b: 2, a: 1 }` stringify\n * identically, which `JSON.stringify` alone does not guarantee (it\n * preserves insertion order).\n *\n * Inputs are caller-declared `deps` plus the deterministic chain\n * shape — no `undefined`, no functions, no circular references — so\n * a recursive walk terminates and the output is well-defined. Arrays\n * are serialized positionally.\n *\n * @internal\n */\nexport const stableKey = (value: unknown): string => {\n if (value === null || typeof value !== \"object\") {\n return JSON.stringify(value);\n }\n if (Array.isArray(value)) {\n return `[${value.map(stableKey).join(\",\")}]`;\n }\n const entries = Object.entries(value as Record<string, unknown>).toSorted(([a], [b]) =>\n compareStrings(a, b),\n );\n return `{${entries.map(([k, v]) => `${JSON.stringify(k)}:${stableKey(v)}`).join(\",\")}}`;\n};\n\n// Lex compare for object-key ordering. `localeCompare` is locale-aware\n// and would re-order BMP code points; we need byte-stable output so the\n// `useEffect` deps key is identical across machines.\nconst compareStrings = (a: string, b: string): number => {\n if (a < b) {\n return -1;\n }\n if (a > b) {\n return 1;\n }\n return 0;\n};\n","import type { SinceResponse } from \"./contract.ts\";\nimport { type RequestContext, request } from \"./request.ts\";\n\n/**\n * One round-trip of `GET /v1/since?collection=…&cursor=…`. The single\n * place that talks to `/v1/since` in this package — the React\n * `subscription-pool` is its only first-party consumer.\n *\n * Long-poll semantics live server-side: the call resolves once the\n * server's budget elapses (`{ events: [], next_cursor: <same> }`) or\n * one or more events arrive. Callers are expected to loop over this\n * helper, threading `next_cursor` through.\n *\n * `cursor === \"\"` means \"start at `log_seq_start`\" (the wire\n * protocol); pass the previously returned `next_cursor` to resume.\n *\n * `signal` cancels the underlying fetch via the standard\n * `AbortController` plumbing; the rejection propagates as\n * `AbortError`.\n */\nexport const pollSinceOnce = async (\n ctx: RequestContext,\n name: string,\n cursor: string,\n signal: AbortSignal | undefined,\n): Promise<SinceResponse> => {\n const params = new URLSearchParams();\n params.set(\"collection\", name);\n params.set(\"cursor\", cursor);\n return request<SinceResponse>(ctx, {\n method: \"GET\",\n path: `/v1/since?${params.toString()}`,\n signal,\n });\n};\n","import { BaerlyError } from \"@baerly/protocol\";\nimport type { BaerlyClient } from \"../client.ts\";\nimport { getClientContext } from \"../internal/context.ts\";\nimport { pollSinceOnce } from \"../poll-since-once.ts\";\n\n/**\n * Discriminated snapshot a hook hands back from `getSnapshot`. The\n * `useQuery` types narrow this further (data: T vs data: undefined);\n * the pool stores it generically so the cache can be a single\n * `Map<signature, CachedSnapshot>`.\n */\nexport interface CachedSnapshot {\n readonly status: \"loading\" | \"refreshing\" | \"ok\" | \"error\";\n readonly data: unknown;\n readonly error: Error | undefined;\n}\n\nexport const LOADING_SNAPSHOT: CachedSnapshot = Object.freeze({\n status: \"loading\",\n data: undefined,\n error: undefined,\n});\n\nconst toError = (raw: unknown): Error => {\n if (raw instanceof BaerlyError || raw instanceof Error) {\n return raw;\n }\n return new BaerlyError(\"Internal\", String(raw));\n};\n\ninterface CacheEntry {\n snapshot: CachedSnapshot;\n /** Tables this signature's chain references — used for invalidation. */\n readonly chainTables: ReadonlySet<string>;\n /** Aborts the in-flight read for this signature, if any. */\n inFlight: AbortController | undefined;\n}\n\ninterface TablePoll {\n refcount: number;\n controller: AbortController;\n cursor: string;\n}\n\ninterface SubscriptionPool {\n /** Register a subscriber. Returns an unsubscribe. */\n attach(\n signature: string,\n tables: ReadonlyArray<string>,\n chainTables: ReadonlySet<string>,\n fetcher: () => Promise<unknown>,\n notify: () => void,\n ): () => void;\n /** Read the cached snapshot for `signature` (or the canonical loading sentinel). */\n getSnapshot(signature: string): CachedSnapshot;\n}\n\nconst poolByClient = new WeakMap<BaerlyClient, SubscriptionPool>();\n\n/** Returns the (lazily-created) pool for `client`. */\nexport const poolFor = (client: BaerlyClient): SubscriptionPool => {\n let pool = poolByClient.get(client);\n if (pool === undefined) {\n pool = createPool(client);\n poolByClient.set(client, pool);\n }\n return pool;\n};\n\nconst createPool = (client: BaerlyClient): SubscriptionPool => {\n const cache = new Map<string, CacheEntry>();\n const subscribersBySignature = new Map<string, Set<() => void>>();\n const tablePolls = new Map<string, TablePoll>();\n\n const notifyAll = (signature: string): void => {\n const subs = subscribersBySignature.get(signature);\n if (subs === undefined) {\n return;\n }\n for (const notify of subs) {\n notify();\n }\n };\n\n const dispatchFetch = (signature: string, fetcher: () => Promise<unknown>): void => {\n const entry = cache.get(signature);\n if (entry === undefined) {\n return;\n }\n if (entry.inFlight !== undefined) {\n entry.inFlight.abort();\n }\n const controller = new AbortController();\n entry.inFlight = controller;\n const prevSnapshot = entry.snapshot;\n const hadData = entry.snapshot.status === \"ok\" || entry.snapshot.status === \"refreshing\";\n entry.snapshot = hadData\n ? { status: \"refreshing\", data: entry.snapshot.data, error: undefined }\n : LOADING_SNAPSHOT;\n if (entry.snapshot !== prevSnapshot) {\n notifyAll(signature);\n }\n void (async () => {\n try {\n const data = await fetcher();\n if (controller.signal.aborted) {\n return;\n }\n const live = cache.get(signature);\n if (live === undefined || live.inFlight !== controller) {\n return;\n }\n live.snapshot = { status: \"ok\", data, error: undefined };\n live.inFlight = undefined;\n notifyAll(signature);\n } catch (error) {\n if (controller.signal.aborted) {\n return;\n }\n const live = cache.get(signature);\n if (live === undefined || live.inFlight !== controller) {\n return;\n }\n const wrapped = toError(error);\n live.snapshot = {\n status: \"error\",\n data: live.snapshot.data,\n error: wrapped,\n };\n live.inFlight = undefined;\n notifyAll(signature);\n }\n })();\n };\n\n const invalidateForTable = (table: string): void => {\n for (const [signature, entry] of cache) {\n if (!entry.chainTables.has(table)) {\n continue;\n }\n const subs = subscribersBySignature.get(signature);\n if (subs === undefined || subs.size === 0) {\n continue;\n }\n // Any subscriber's fetcher is fine — they all produce the\n // same call against the real client for this signature\n // (signature is hashed on chain shape + deps).\n const fetcher = signatureFetchers.get(signature);\n if (fetcher !== undefined) {\n dispatchFetch(signature, fetcher);\n }\n }\n };\n\n /** Per-signature fetcher; last writer wins (all fetchers for a signature are equivalent). */\n const signatureFetchers = new Map<string, () => Promise<unknown>>();\n\n const startTablePoll = (table: string): void => {\n if (tablePolls.has(table)) {\n return;\n }\n const controller = new AbortController();\n const poll: TablePoll = { refcount: 1, controller, cursor: \"\" };\n tablePolls.set(table, poll);\n const ctx = getClientContext(client);\n void (async () => {\n while (!controller.signal.aborted) {\n try {\n const res = await pollSinceOnce(ctx, table, poll.cursor, controller.signal);\n if (controller.signal.aborted) {\n return;\n }\n if (res.events.length > 0 || res.next_cursor !== poll.cursor) {\n poll.cursor = res.next_cursor;\n if (res.events.length > 0) {\n invalidateForTable(table);\n }\n }\n } catch (error) {\n if (controller.signal.aborted) {\n return;\n }\n if (error instanceof DOMException && error.name === \"AbortError\") {\n return;\n }\n // 1-second backoff on error to avoid hot-spinning on a\n // persistent failure; downstream subscribers' next fetch\n // sees the same error if it doesn't clear.\n await new Promise((r) => setTimeout(r, 1000));\n }\n }\n })();\n };\n\n const stopTablePoll = (table: string): void => {\n const poll = tablePolls.get(table);\n if (poll === undefined) {\n return;\n }\n poll.refcount--;\n if (poll.refcount === 0) {\n poll.controller.abort();\n tablePolls.delete(table);\n }\n };\n\n const incrementTablePoll = (table: string): void => {\n const poll = tablePolls.get(table);\n if (poll === undefined) {\n startTablePoll(table);\n } else {\n poll.refcount++;\n }\n };\n\n return {\n getSnapshot(signature: string): CachedSnapshot {\n return cache.get(signature)?.snapshot ?? LOADING_SNAPSHOT;\n },\n attach(signature, tables, chainTables, fetcher, notify) {\n let entry = cache.get(signature);\n const isFirstSubscriber = entry === undefined;\n if (entry === undefined) {\n entry = {\n snapshot: LOADING_SNAPSHOT,\n chainTables,\n inFlight: undefined,\n };\n cache.set(signature, entry);\n }\n signatureFetchers.set(signature, fetcher);\n let subs = subscribersBySignature.get(signature);\n if (subs === undefined) {\n subs = new Set();\n subscribersBySignature.set(signature, subs);\n }\n subs.add(notify);\n for (const table of tables) {\n incrementTablePoll(table);\n }\n if (isFirstSubscriber) {\n dispatchFetch(signature, fetcher);\n } else {\n // Cache already has data (or in-flight). The new subscriber\n // gets the existing snapshot via getSnapshot; no extra fetch.\n }\n return () => {\n const liveSubs = subscribersBySignature.get(signature);\n if (liveSubs !== undefined) {\n liveSubs.delete(notify);\n if (liveSubs.size === 0) {\n subscribersBySignature.delete(signature);\n const liveEntry = cache.get(signature);\n if (liveEntry !== undefined) {\n liveEntry.inFlight?.abort();\n cache.delete(signature);\n }\n signatureFetchers.delete(signature);\n }\n }\n for (const table of tables) {\n stopTablePoll(table);\n }\n };\n },\n };\n};\n","import { type BaerlyConfig, BaerlyError, type UnboundConfig } from \"@baerly/protocol\";\nimport { useCallback, useReducer, useRef, useSyncExternalStore } from \"react\";\nimport type { BaerlyClient } from \"../client.ts\";\nimport { useBaerlyClient } from \"./provider.ts\";\nimport { stableKey } from \"./stable-key.ts\";\nimport { LOADING_SNAPSHOT, poolFor } from \"./subscription-pool.ts\";\n\nconst SKIP: unique symbol = Symbol(\"baerly.useQuery.skip\");\n\n/**\n * Result handed back by {@link useQuery}. Discriminate on `status` —\n * narrowing into `\"ok\"` / `\"refreshing\"` gives `data: T`; narrowing\n * into `\"loading\"` / `\"skipped\"` gives `data: undefined`; narrowing\n * into `\"error\"` gives `data: T | undefined` (the prior successful\n * read survives across errors so the UI can keep rendering).\n */\nexport type UseQueryResult<T> =\n | { readonly status: \"loading\"; readonly data: undefined; readonly error: undefined }\n | { readonly status: \"refreshing\"; readonly data: T; readonly error: undefined }\n | { readonly status: \"ok\"; readonly data: T; readonly error: undefined }\n | { readonly status: \"skipped\"; readonly data: undefined; readonly error: undefined }\n | { readonly status: \"error\"; readonly data: T | undefined; readonly error: Error };\n\nconst SKIPPED_SNAPSHOT: UseQueryResult<never> = Object.freeze({\n status: \"skipped\",\n data: undefined,\n error: undefined,\n});\n\ninterface RecorderState {\n readonly collectionsRead: Set<string>;\n readonly chain: Array<string>;\n}\n\nconst WRITE_METHODS = new Set([\"insert\", \"update\", \"replace\", \"delete\"]);\n\nconst awaitedError = (prop: string | symbol): BaerlyError =>\n new BaerlyError(\n \"UseQueryAwaitedRecorder\",\n `useQuery callbacks must not dereference the result of an awaited recorder terminal — property access (${String(prop)}) on the awaited value throws. The recorder is for the synchronous prefix of the callback only. For compound reads, use Promise.all (parallel) or compose two useQuery calls with useQuery.skip (dependent). See the lint rule baerly/no-await-in-use-query for the edit-time check.`,\n );\n\n/**\n * Sentinel handed back when a recorder terminal is awaited. Every\n * own-property access throws `BaerlyError(\"UseQueryAwaitedRecorder\")`;\n * `Symbol.*` accesses (which the JS engine uses internally —\n * Symbol.toPrimitive, Symbol.iterator, etc.) return undefined so the\n * sentinel can flow through engine-side coercions without spurious\n * throws. The single shared instance avoids per-render allocation.\n */\nconst SENTINEL_SAFE_PROPS = new Set<string | symbol>([\n // The JS engine probes `.then` to test whether a value is a\n // thenable while resolving Promises. Returning undefined makes the\n // sentinel look like a non-thenable so awaiting it yields the\n // sentinel itself (not a chained Promise) — and our error fires on\n // the next, user-visible property access.\n \"then\",\n // `.catch` and `.finally` are sometimes probed similarly.\n \"catch\",\n \"finally\",\n // `Symbol.toStringTag` etc. are probed by `String()` and JSON\n // serialization. The generic `typeof prop === \"symbol\"` branch\n // already covers these; keep them here for explicit reference.\n]);\n\nconst AWAITED_SENTINEL: unknown = new Proxy(\n Object.create(null) as Record<string | symbol, unknown>,\n {\n get(_target, prop) {\n if (typeof prop === \"symbol\" || SENTINEL_SAFE_PROPS.has(prop)) {\n return undefined;\n }\n throw awaitedError(prop);\n },\n },\n);\n\nconst TERMINAL_RESULT: Promise<unknown> = Promise.resolve(AWAITED_SENTINEL);\n\nconst makeTerminal = (): Promise<unknown> => TERMINAL_RESULT;\n\nconst makeQuery = (state: RecorderState): unknown => {\n const query: Record<string, unknown> = {};\n for (const modifier of [\"where\", \"order\", \"limit\"]) {\n query[modifier] = (): unknown => {\n state.chain.push(modifier);\n return query;\n };\n }\n for (const terminal of [\"first\", \"all\", \"count\"]) {\n query[terminal] = (): unknown => {\n state.chain.push(terminal);\n return makeTerminal();\n };\n }\n return query;\n};\n\nconst makeCollection = (name: string, state: RecorderState): unknown => {\n state.collectionsRead.add(name);\n state.chain.push(`collection:${name}`);\n const collection: Record<string, unknown> = {\n name,\n };\n for (const modifier of [\"where\", \"order\", \"limit\"]) {\n collection[modifier] = (): unknown => {\n state.chain.push(modifier);\n return makeQuery(state);\n };\n }\n for (const terminal of [\"first\", \"all\", \"count\", \"get\"]) {\n collection[terminal] = (): unknown => {\n state.chain.push(terminal);\n return makeTerminal();\n };\n }\n for (const write of WRITE_METHODS) {\n collection[write] = (): never => {\n throw new BaerlyError(\n \"UnexpectedWriteInQuery\",\n `useQuery callbacks must not write to the database. .${write}() was called on collection \"${name}\". Use useMutation() instead.`,\n );\n };\n }\n return collection;\n};\n\nconst createRecorder = (): { client: unknown; state: RecorderState } => {\n const state: RecorderState = {\n collectionsRead: new Set(),\n chain: [],\n };\n const recorder = {\n collection: (name: string): unknown => makeCollection(name, state),\n healthz: (): never => {\n throw new BaerlyError(\n \"UnexpectedWriteInQuery\",\n \"useQuery callbacks must not call client.healthz(); use useMutation() or the bare client.\",\n );\n },\n };\n return { client: recorder, state };\n};\n\ninterface DiscoveryOk {\n readonly kind: \"ok\";\n readonly collections: ReadonlyArray<string>;\n readonly chainShape: string;\n readonly callbackResult: unknown;\n}\ninterface DiscoverySkip {\n readonly kind: \"skip\";\n}\ninterface DiscoveryError {\n readonly kind: \"error\";\n readonly error: Error;\n}\ntype DiscoveryResult = DiscoveryOk | DiscoverySkip | DiscoveryError;\n\nconst discover = (\n callback: (client: BaerlyClient) => Promise<unknown> | typeof SKIP,\n): DiscoveryResult => {\n const { client: recorder, state } = createRecorder();\n let callbackResult: unknown;\n try {\n callbackResult = callback(recorder as BaerlyClient);\n } catch (error) {\n return {\n kind: \"error\",\n error: error instanceof Error ? error : new BaerlyError(\"Internal\", String(error)),\n };\n }\n if (callbackResult === SKIP) {\n return { kind: \"skip\" };\n }\n return {\n kind: \"ok\",\n collections: [...state.collectionsRead].toSorted(),\n chainShape: stableKey(state.chain),\n callbackResult,\n };\n};\n\n/**\n * Reactive read against a `baerly` server. The callback receives a\n * type-compatible `BaerlyClient` proxy that records which collections it\n * touches; the hook subscribes to those collections and re-runs the\n * callback against the real client when any of them mutate.\n *\n * Re-runs also fire whenever the `deps` array changes between\n * renders (shallow `stableKey` compare). Closure variables read\n * inside the callback must be listed in `deps` — the companion\n * `baerly/exhaustive-deps-use-query` lint rule flags missing\n * entries.\n *\n * Returning {@link useQuery.skip} from the callback yields\n * `{ status: \"skipped\" }` and registers no subscription — use it\n * for deferred / conditional reads.\n *\n * @example\n * ```tsx\n * // Single read\n * const note = useQuery((c) => c.collection(\"notes\").get(id), [id]);\n * if (note.status === \"loading\") return <Spinner/>;\n * if (note.status === \"error\") return <Err e={note.error}/>;\n * return <pre>{note.data?.body}</pre>; // typed Note | undefined\n *\n * // Deferred read\n * const list = useQuery(\n * (c) => userId ? c.collection(\"notes\").where({ authorId: userId }).all() : useQuery.skip,\n * [userId],\n * );\n * if (list.status === \"skipped\") return null;\n *\n * // Dependent read (parent → child)\n * const parent = useQuery((c) => c.collection(\"notes\").get(id), [id]);\n * const replies = useQuery(\n * (c) => parent.status === \"ok\"\n * ? c.collection(\"comments\").where({ noteId: parent.data._id }).all()\n * : useQuery.skip,\n * [parent.status === \"ok\" ? parent.data._id : undefined],\n * );\n * ```\n */\nconst useQueryImpl = <T, TConfig extends BaerlyConfig = UnboundConfig>(\n callback: (client: BaerlyClient<TConfig>) => Promise<T> | typeof SKIP,\n deps?: ReadonlyArray<unknown>,\n): UseQueryResult<T> => {\n const client = useBaerlyClient<TConfig>();\n const pool = poolFor(client as unknown as BaerlyClient);\n\n const callbackRef = useRef(callback);\n callbackRef.current = callback;\n\n // Force-update for async-error capture (see below). Used to push\n // a microtask-deferred recorder-await rejection back into a sync\n // render.\n const [, forceUpdate] = useReducer((c: number) => c + 1, 0);\n const asyncErrorRef = useRef<BaerlyError | undefined>(undefined);\n\n // Recorder pass. Cheap — no I/O.\n const discovery = discover(\n callbackRef.current as (client: BaerlyClient) => Promise<unknown> | typeof SKIP,\n );\n\n // The signature inputs that need to be stable across the same\n // logical query: chain shape + caller-declared deps.\n const depsKey = stableKey([deps ?? []]);\n const signatureBase =\n discovery.kind === \"ok\"\n ? stableKey([discovery.chainShape, deps ?? []])\n : `__non_ok__${discovery.kind}__${depsKey}`;\n\n // Reset the captured async error if the signature changed (the\n // user is on a different query now — give them a fresh chance).\n const lastSignatureRef = useRef<string>(\"\");\n if (lastSignatureRef.current !== signatureBase) {\n lastSignatureRef.current = signatureBase;\n asyncErrorRef.current = undefined;\n }\n\n // Attach an async-error handler to the callback's returned value\n // so that any microtask-deferred rejection from sentinel access\n // (sequential-await pattern) flows back into render via\n // forceUpdate. Wrap in `Promise.resolve(...)` so a bare recorder\n // terminal (Promise<sentinel>) is observed too — the resolved\n // value carries no `.catch`. Always attach (even if asyncErrorRef\n // is already set) so the per-render discovery invocation's\n // rejection is observed and doesn't surface as an unhandled\n // rejection from vitest or the host runtime.\n if (discovery.kind === \"ok\") {\n const result = discovery.callbackResult;\n if (\n result !== null &&\n typeof result === \"object\" &&\n typeof (result as { then?: unknown }).then === \"function\"\n ) {\n Promise.resolve(result as PromiseLike<unknown>).then(\n () => {\n /* discovery success — value discarded */\n },\n (error: unknown) => {\n if (\n error instanceof BaerlyError &&\n error.code === \"UseQueryAwaitedRecorder\" &&\n asyncErrorRef.current === undefined\n ) {\n asyncErrorRef.current = error;\n forceUpdate();\n }\n // Any other rejection is silently swallowed here — the\n // pool's real-client fetch path is the canonical surface\n // for non-recorder errors.\n },\n );\n }\n }\n\n // Subscription channel — stable per (client, collectionsRead.join(\" \")).\n // Pool's getSnapshot returns the current cached entry for this\n // signature; React polls it on subscribe + on every notify.\n const collectionsJoin =\n discovery.kind === \"ok\" ? discovery.collections.join(\"\\x00\") : \"__non_ok__\";\n\n const fetcherRef = useRef<() => Promise<unknown>>(() => Promise.resolve(undefined));\n fetcherRef.current = (): Promise<unknown> => {\n const out = callbackRef.current(client) as Promise<unknown> | typeof SKIP;\n if (out === SKIP) {\n return Promise.resolve(undefined);\n }\n return out as Promise<unknown>;\n };\n\n const chainCollectionsRef = useRef<ReadonlySet<string>>(new Set());\n const discoveryKindRef = useRef<DiscoveryResult[\"kind\"]>(\"ok\");\n const discoveryErrorRef = useRef<Error | undefined>(undefined);\n discoveryKindRef.current = discovery.kind;\n if (discovery.kind === \"ok\") {\n chainCollectionsRef.current = new Set(discovery.collections);\n discoveryErrorRef.current = undefined;\n } else if (discovery.kind === \"error\") {\n discoveryErrorRef.current = discovery.error;\n } else {\n discoveryErrorRef.current = undefined;\n }\n\n const subscribe = useCallback(\n (notify: () => void): (() => void) => {\n if (discovery.kind !== \"ok\") {\n return () => {};\n }\n return pool.attach(\n signatureBase,\n discovery.collections,\n chainCollectionsRef.current,\n () => fetcherRef.current(),\n notify,\n );\n },\n // The signature/collections determine the subscription; React\n // re-subscribes when either changes.\n // eslint-disable-next-line react-hooks/exhaustive-deps\n [pool, signatureBase, collectionsJoin],\n );\n\n // Stable per-error snapshot cache so repeated getSnapshot polls\n // within a single render return the same reference. React's\n // useSyncExternalStore detects identity changes; constructing a\n // fresh error literal each call drives an infinite re-render.\n const errorSnapshotRef = useRef<\n | {\n error: Error;\n snapshot: UseQueryResult<unknown>;\n }\n | undefined\n >(undefined);\n const snapshotForError = (err: Error): UseQueryResult<T> => {\n if (errorSnapshotRef.current?.error === err) {\n return errorSnapshotRef.current.snapshot as UseQueryResult<T>;\n }\n const snapshot = {\n status: \"error\" as const,\n data: undefined,\n error: err,\n } satisfies UseQueryResult<unknown>;\n errorSnapshotRef.current = { error: err, snapshot };\n return snapshot as UseQueryResult<T>;\n };\n\n const getSnapshot = useCallback((): UseQueryResult<T> => {\n if (asyncErrorRef.current) {\n return snapshotForError(asyncErrorRef.current);\n }\n if (discoveryKindRef.current === \"skip\") {\n return SKIPPED_SNAPSHOT as UseQueryResult<T>;\n }\n if (discoveryKindRef.current === \"error\") {\n return snapshotForError(\n discoveryErrorRef.current ?? new BaerlyError(\"Internal\", \"unknown discovery error\"),\n );\n }\n return pool.getSnapshot(signatureBase) as UseQueryResult<T>;\n // eslint-disable-next-line react-hooks/exhaustive-deps\n }, [pool, signatureBase]);\n\n // discoveryKindRef + discoveryErrorRef carry the latest discovery\n // state into getSnapshot without making it a useCallback dep\n // (avoids re-creating the snapshot callback every render).\n return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);\n};\n\n/**\n * Reactive read hook. See {@link useQueryImpl} JSDoc for usage.\n * The `.skip` property is the sentinel that short-circuits the hook\n * into `status: \"skipped\"`.\n */\nexport const useQuery: {\n <T, TConfig extends BaerlyConfig = UnboundConfig>(\n callback: (client: BaerlyClient<TConfig>) => Promise<T> | typeof SKIP,\n deps?: ReadonlyArray<unknown>,\n ): UseQueryResult<T>;\n readonly skip: typeof SKIP;\n} = Object.assign(useQueryImpl, { skip: SKIP }) as {\n <T, TConfig extends BaerlyConfig = UnboundConfig>(\n callback: (client: BaerlyClient<TConfig>) => Promise<T> | typeof SKIP,\n deps?: ReadonlyArray<unknown>,\n ): UseQueryResult<T>;\n readonly skip: typeof SKIP;\n};\n\n// Quiet `LOADING_SNAPSHOT` as a value-import — referenced by\n// generated type for the `loading` branch only; bundled alongside\n// `subscription-pool.ts`.\nvoid LOADING_SNAPSHOT;\n","import type { BaerlyConfig, UnboundConfig } from \"@baerly/protocol\";\nimport type { ReactNode } from \"react\";\nimport type { BaerlyClient } from \"../client.ts\";\nimport { BaerlyProvider, useBaerlyClient } from \"./provider.ts\";\nimport { useMutation, type UseMutationTuple } from \"./use-mutation.ts\";\nimport { useQuery, type UseQueryResult } from \"./use-query.ts\";\n\n/**\n * Props for the config-bound `BaerlyProvider` returned by\n * {@link createBaerlyReact}. `client` is typed `BaerlyClient<TConfig>`\n * to document the intended binding; the hooks carry `TConfig`\n * themselves, so row inference holds regardless of the client value's\n * own inferred type.\n */\nexport interface BaerlyProviderProps<TConfig extends BaerlyConfig> {\n readonly client: BaerlyClient<TConfig>;\n readonly children?: ReactNode;\n}\n\n/**\n * The config-bound React surface returned by {@link createBaerlyReact}.\n * Every hook is pinned to `TConfig`, so `c.collection(\"notes\")` inside\n * a `useQuery` / `useMutation` callback infers the real row type — no\n * `as Promise<Note[]>` cast.\n */\nexport interface BaerlyReact<TConfig extends BaerlyConfig> {\n /** Wrap your app once; provides the bound client to every hook below it. */\n readonly BaerlyProvider: (props: BaerlyProviderProps<TConfig>) => React.JSX.Element;\n /**\n * Reactive read. The callback receives `BaerlyClient<TConfig>`, so\n * the chain is fully typed. `useQuery.skip` short-circuits to\n * `{ status: \"skipped\" }`.\n */\n readonly useQuery: {\n <T>(\n callback: (client: BaerlyClient<TConfig>) => Promise<T> | symbol,\n deps?: ReadonlyArray<unknown>,\n ): UseQueryResult<T>;\n /**\n * Sentinel — return it from the callback to defer the read\n * (`{ status: \"skipped\" }`, no subscription). Typed `symbol` (not\n * the impl's `unique symbol`) so the bound surface stays nameable\n * across the package boundary; identity-compared at runtime.\n */\n readonly skip: symbol;\n };\n /** Imperative mutation hook → `[mutate, { isPending, error }]`. */\n readonly useMutation: () => UseMutationTuple<TConfig>;\n /** Escape hatch — the raw bound {@link BaerlyClient} for imperative use. */\n readonly useBaerlyClient: () => BaerlyClient<TConfig>;\n}\n\n/**\n * Build the typed React surface for one `baerly.config.ts`. Call it\n * once at module scope and export the result; every hook is bound to\n * the config so collection names autocomplete and row types infer\n * end-to-end. This is the only React entry point — there are no\n * loose, unbound hooks to import by mistake.\n *\n * @example\n * ```ts\n * // src/web/client.ts\n * import { createBaerlyClient } from \"@gusto/baerly-storage/client\";\n * import { createBaerlyReact } from \"@gusto/baerly-storage/client/react\";\n * import config from \"../../baerly.config.ts\";\n *\n * export const client = createBaerlyClient({ baseUrl: \"\", config });\n * export const { BaerlyProvider, useQuery, useMutation } =\n * createBaerlyReact<typeof config>();\n * ```\n *\n * ```tsx\n * // any component\n * import { useQuery } from \"./client.ts\";\n * const notes = useQuery((c) => c.collection(\"notes\").all(), []);\n * // ^? UseQueryResult<Note[]> — no cast\n * ```\n *\n * Omit the type parameter (`createBaerlyReact()`) for an unbound app;\n * collection names widen to `string` and rows to `DocumentData`,\n * matching the in-process `Db.collection` fallback.\n */\nexport const createBaerlyReact = <\n TConfig extends BaerlyConfig = UnboundConfig,\n>(): BaerlyReact<TConfig> => ({\n // Identical runtime implementations — the generic is erased, so the\n // factory only re-pins each hook's type to `TConfig`. The\n // recorder-proxy in `useQuery` is structurally typed as\n // `BaerlyClient`, so binding a narrower config is a no-op at runtime.\n BaerlyProvider: BaerlyProvider as BaerlyReact<TConfig>[\"BaerlyProvider\"],\n useQuery: useQuery as unknown as BaerlyReact<TConfig>[\"useQuery\"],\n useMutation: useMutation as BaerlyReact<TConfig>[\"useMutation\"],\n useBaerlyClient: useBaerlyClient as BaerlyReact<TConfig>[\"useBaerlyClient\"],\n});\n"],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@gusto/baerly-storage",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "Vendorless document database that runs over any S3-compatible storage API.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cloudflare-workers",
|
|
@@ -122,10 +122,10 @@
|
|
|
122
122
|
"yaml": "2.9.0",
|
|
123
123
|
"@baerly/adapter-cloudflare": "0.1.0",
|
|
124
124
|
"@baerly/adapter-node": "0.1.0",
|
|
125
|
+
"@baerly/dev": "0.1.0",
|
|
125
126
|
"@baerly/client": "0.1.0",
|
|
126
127
|
"@baerly/protocol": "0.1.0",
|
|
127
|
-
"@baerly/server": "0.1.0"
|
|
128
|
-
"@baerly/dev": "0.1.0"
|
|
128
|
+
"@baerly/server": "0.1.0"
|
|
129
129
|
},
|
|
130
130
|
"peerDependencies": {
|
|
131
131
|
"@cloudflare/workers-types": "^4",
|