foldkit-remote-server 0.5.0 → 0.7.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 CHANGED
@@ -80,7 +80,7 @@ Drizzle-backed entities and queries.
80
80
  Start with the same Entity the client selects:
81
81
 
82
82
  ```ts
83
- import { Schema } from 'effect'
83
+ import { Effect, Schema } from 'effect'
84
84
  import { Entity, Remote, RemoteRpc } from 'foldkit-remote'
85
85
  import { RemoteServer } from 'foldkit-remote-server'
86
86
 
@@ -100,15 +100,23 @@ Give that Entity one Source:
100
100
  // Your authentication's principal type; without it `principal` is `unknown`.
101
101
  type Principal = { readonly isAdmin: boolean }
102
102
 
103
+ const rows = new Map([
104
+ ['p1', { id: 'p1', name: 'Apollo', privateNotes: 'Internal' }],
105
+ ])
106
+
103
107
  const ProjectSource = RemoteServer.entity<Principal>(Project, {
104
108
  // Authentication already resolved `principal` before RemoteServer sees it.
105
109
  // Return only fields this caller may read.
106
110
  authorize: (principal, fields) =>
107
111
  fields.filter(field => field !== 'privateNotes' || principal.isAdmin),
108
112
 
109
- // Your application owns this function. Read exactly the ids/fields requested.
110
- read: ({ ids, fields, principal }) =>
111
- loadProjects({ ids, fields, principal }),
113
+ read: ({ ids, fields }) => Effect.succeed(ids.flatMap(id => {
114
+ const row = rows.get(id)
115
+ return row === undefined ? [] : [{
116
+ id,
117
+ values: Object.fromEntries(Object.entries(row).filter(([field]) => fields.includes(field))),
118
+ }]
119
+ })),
112
120
  })
113
121
 
114
122
  const Server = RemoteServer.make({
@@ -120,11 +128,17 @@ Compile that definition into the Remote RPC handlers for one authenticated
120
128
  principal:
121
129
 
122
130
  ```ts
131
+ const principal: Principal = { isAdmin: false }
123
132
  const handlers = RemoteServer.handlers(Server, principal)
124
133
  const layer = RemoteRpc.toLayer(handlers)
125
134
  ```
126
135
 
127
- That is the core package. A client requirement such as:
136
+ `RemoteServer.entity` and `make` only describe the server. `handlers` binds
137
+ a principal; `RemoteRpc.toLayer` provides handlers to Effect RPC. Neither starts
138
+ an HTTP listener. In this example the source returns an Effect over local rows;
139
+ replace its body with your database or API reader when connecting real data.
140
+
141
+ A client requirement such as:
128
142
 
129
143
  ```text
130
144
  Project:p1 [id, name, privateNotes]
@@ -296,12 +310,18 @@ A descriptor declared with
296
310
  value, and `evaluate` runs that value directly:
297
311
 
298
312
  ```ts
299
- import { evaluate } from 'foldkit-remote-server'
313
+ import { evaluate } from 'foldkit-entity'
300
314
 
301
315
  evaluate(PostsBySlug.body!, { slug: 'intro' }, rows)
302
316
  // the matching rows, in the order the body asks for
303
317
  ```
304
318
 
319
+ It lives in [`foldkit-entity`](../entity), beside the IR it interprets, because
320
+ it is that IR's reference semantics rather than anything this package does —
321
+ and because a client judging rows it already holds needs it without depending on
322
+ a server package. This package re-exports it, so importing it from either place
323
+ means the same thing.
324
+
305
325
  It is pure — it reads the rows it is given and nothing else — and it is the
306
326
  reference the compiled interpreters are checked against. `foldkit-remote-drizzle`
307
327
  turns the same body into SQL; the test suite runs both over the same rows in a
@@ -323,6 +343,30 @@ Two things it refuses rather than guesses:
323
343
 
324
344
  Both throw where the query runs, naming the query and the field.
325
345
 
346
+ ### Checking an interpreter against the semantics
347
+
348
+ `evaluate` is the reference, and `cases` is what it is a reference *to*: the
349
+ conformance suite, exported so an interpreter written elsewhere can be held to
350
+ the same semantics.
351
+
352
+ ```ts
353
+ import { Subject, cases, rows } from 'foldkit-remote-server'
354
+
355
+ for (const { what, body, input, expected } of cases) {
356
+ expect(yourInterpreter(body, input, rows).map(row => row.id)).toEqual(expected)
357
+ }
358
+ ```
359
+
360
+ Every case is chosen to make interpreters **disagree**, which is the only kind
361
+ that tests anything: mixed case, nulls on both sides of a comparison, `%` and
362
+ `_` as literal text, the empty search, a predicate compared to a boolean either
363
+ way round. That is not caution for its own sake — `contains` reached a released
364
+ package meaning three different things because every value in the original
365
+ fixture happened to be lowercase.
366
+
367
+ Both interpreters here run it: this package over rows in memory, and
368
+ `foldkit-remote-drizzle` compiled to SQL against a real SQLite.
369
+
326
370
  ## Mutations
327
371
 
328
372
  A Mutation Source changes server-owned state. It returns the protocol output
@@ -547,6 +591,45 @@ The handler applies bounded, protocol-level safeguards before or around Sources:
547
591
  A `liveHub` applies the same id bound to a subscription. A hand-written live
548
592
  Source is responsible for any additional bounds appropriate to its backend.
549
593
 
594
+ ## A backend held in memory
595
+
596
+ `RemoteServer.memory` serves rows you give it through the same `handlers` a
597
+ real server uses, so a client sees what production would send: only the
598
+ fields asked for, and nested relations resolved in one read. Use it for a
599
+ first run, a test, a story or a demo, when there is no database yet.
600
+
601
+ ```ts
602
+ const backend = RemoteServer.memory({
603
+ domain: Data, // or the definition from Remote.define
604
+ rows: {
605
+ User: [{ id: 'u1', name: 'Ada' }],
606
+ Project: [{ id: 'p1', name: 'Apollo', status: 'active', owner: 'User:u1' }],
607
+ },
608
+ // Optional: each mutation writes through the store, and the next read sees it.
609
+ mutations: store => [
610
+ RemoteServer.mutation(RenameProject, ({ input }) => {
611
+ store.write('Project', input.id, { name: input.name })
612
+ return Effect.succeed({
613
+ output: { id: input.id },
614
+ entities: [Remote.patch(Project, input.id, { name: input.name })],
615
+ })
616
+ }),
617
+ ],
618
+ })
619
+
620
+ backend.layer // provide it where the real RemoteClient would go
621
+ ```
622
+
623
+ - Rows are in their **wire shape**: a relation is its ref key (`'User:u1'`),
624
+ and a to-many relation is a list of them.
625
+ - A query declared with `Query.define` is answered by running its body over
626
+ the rows with [`evaluate`](#running-a-query-body-over-rows-you-already-hold),
627
+ the reference interpreter, and paged with offset cursors. A query with no
628
+ body has nothing to run and is refused when the backend is made, unless you
629
+ pass a source for it in `queries`.
630
+ - It pushes no live changes and authorizes nothing: every field is readable.
631
+ It is not a server to deploy.
632
+
550
633
  ## What it does not own
551
634
 
552
635
  `foldkit-remote-server` intentionally does **not** own:
package/dist/index.d.mts CHANGED
@@ -1,22 +1,6 @@
1
- import { Effect, Schema, Stream } from "effect";
2
- import { Boundary, ConnectionChangeSchema, ConnectionIdentity, LiveChange, MutationDescriptor, NormalizedPatch, QueryDescriptor, QueryWindow, RemoteDescriptor, RemoteRpcClient, Requirement } from "foldkit-remote";
3
- import { AnyQuery } from "foldkit-entity";
4
- //#region src/evaluate.d.ts
5
- /** A row as this interpreter reads one: values by field key. */
6
- export type Row = Readonly<Record<string, unknown>>;
7
- export declare class QueryEvaluateError extends Error {
8
- constructor(message: string);
9
- }
10
- /**
11
- * The rows the body matches, in the order it asks for. Pure: it reads the rows
12
- * it is given and nothing else.
13
- *
14
- * `input` holds the values this run was given, by the keys the body's
15
- * placeholders were built with — the same record the query would be called
16
- * with anywhere else.
17
- */
18
- export declare const evaluate: (body: AnyQuery, input: Row, rows: ReadonlyArray<Row>) => ReadonlyArray<Row>;
19
- //#endregion
1
+ import { Effect, Layer, Schema, Stream } from "effect";
2
+ import { QueryEvaluateError, Row, assertSupported, evaluate, supported } from "foldkit-entity";
3
+ import { Boundary, ConnectionChangeSchema, ConnectionIdentity, LiveChange, MutationDescriptor, NormalizedPatch, QueryDescriptor, QueryWindow, RemoteClient, RemoteDescriptor, RemoteRpcClient, Requirement } from "foldkit-remote";
20
4
  //#region src/index.d.ts
21
5
  declare const RemoteServerError_base: Schema.Class<RemoteServerError, Schema.TaggedStruct<"RemoteServerError", {
22
6
  readonly message: Schema.String;
@@ -147,7 +131,33 @@ interface EntityName {
147
131
  readonly name: string;
148
132
  readonly fields?: Readonly<Record<string, unknown>> | undefined;
149
133
  }
134
+ /** One entity's rows in their wire shape: a relation is its ref key, `'User:u1'`. */
135
+ export type MemoryRows = Readonly<Record<string, ReadonlyArray<Readonly<Record<string, unknown>> & {
136
+ readonly id: string;
137
+ }>>>;
138
+ /**
139
+ * The rows a memory backend holds, which its mutations write through. A
140
+ * change is what the next read sees; nothing is pushed to a client.
141
+ */
142
+ export interface MemoryStore {
143
+ /** The rows of one entity, in insertion order. */
144
+ readonly rows: (entity: string) => ReadonlyArray<Readonly<Record<string, unknown>>>;
145
+ /** Writes these values onto a row, creating it if it is new. */
146
+ readonly write: (entity: string, id: string, values: Readonly<Record<string, unknown>>) => void;
147
+ readonly remove: (entity: string, id: string) => void;
148
+ }
149
+ export interface MemoryBackend extends MemoryStore {
150
+ /** A `RemoteClient` answering from the rows. Provide it where the real one would go. */
151
+ readonly layer: Layer.Layer<RemoteClient>;
152
+ }
150
153
  export declare const RemoteServer: {
154
+ /** A backend held in memory, for a first run, a test or a demo. See `memory`. */
155
+ memory: (config: {
156
+ readonly domain: Pick<RemoteDescriptor, "registry">;
157
+ readonly rows: MemoryRows;
158
+ readonly queries?: ReadonlyArray<QuerySource<undefined>>;
159
+ readonly mutations?: (store: MemoryStore) => ReadonlyArray<MutationSource<undefined>>;
160
+ }) => MemoryBackend;
151
161
  /** A mutation outcome's report that `ref` now heads the connection. */
152
162
  prepend: (connection: ConnectionIdentity, ref: {
153
163
  readonly entity: string;
@@ -215,4 +225,5 @@ export declare const RemoteServer: {
215
225
  handlers: <P, R>(server: ServerDefinition<P, R>, principal: P, options?: HandlerOptions<P, R>) => RemoteRpcClient<R>;
216
226
  };
217
227
  //#endregion
228
+ export { QueryEvaluateError, type Row, assertSupported, evaluate, supported };
218
229
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/evaluate.ts","../src/index.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":"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"}
package/dist/index.mjs CHANGED
@@ -1,94 +1,6 @@
1
1
  import { Effect, Queue, Schema, Stream } from "effect";
2
- import { RELATION_ALIAS, REMOTE_PROTOCOL_VERSION, RemoteLiveError, RemoteMutationError, RemoteProtocolError, RemoteQueryError, RemoteReadError, Requirement, aliasedField, connectionIdentity, entityKey, refsIn, stableStringify } from "foldkit-remote";
3
- import { isPredicate } from "foldkit-entity";
4
- //#region src/evaluate.ts
5
- /**
6
- * The reference interpreter: a query body run over rows already in memory.
7
- *
8
- * `foldkit-remote-drizzle` compiles a body to SQL. This runs the same body
9
- * directly, which is what makes "source-neutral" a fact rather than a claim —
10
- * the two are checked against each other over a real database, and a body that
11
- * means one thing here and another there is a bug in one of them.
12
- *
13
- * It is also the interpreter to reach for when there is no database: a test
14
- * that wants rows, or a server assembling a page from values it already holds.
15
- *
16
- * **It follows SQL, not JavaScript.** Where the two disagree this follows SQL,
17
- * because SQL is what the other interpreter runs. The important case is null:
18
- * `null = null` is unknown in SQL and a row is not matched by it, where
19
- * JavaScript would happily call the two equal.
20
- */
21
- var QueryEvaluateError = class extends Error {
22
- constructor(message) {
23
- super(`[foldkit-remote-server] ${message}`);
24
- this.name = "QueryEvaluateError";
25
- }
26
- };
27
- const valueOf = (node, row, input) => {
28
- switch (node._tag) {
29
- case "Field": return row[node.key];
30
- case "Literal": return node.value;
31
- case "Input": return input[node.key];
32
- }
33
- };
34
- const isNull = (value) => value === null || value === void 0;
35
- /** A predicate used as a value is its own truth; anything else is its value. */
36
- const sideOf = (node, row, input) => isPredicate(node) ? truthValue(holds(node, row, input)) : valueOf(node, row, input);
37
- /**
38
- * A predicate compared as a value. SQL's unknown is null there too, so an
39
- * unknown compared to anything stays unknown rather than becoming false.
40
- */
41
- const truthValue = (truth) => truth === "unknown" ? null : truth;
42
- const holds = (node, row, input) => {
43
- switch (node._tag) {
44
- case "Eq": {
45
- const left = sideOf(node.left, row, input);
46
- const right = sideOf(node.right, row, input);
47
- if (isNull(left) || isNull(right)) return "unknown";
48
- return left === right;
49
- }
50
- case "Null": return isNull(valueOf(node.operand, row, input)) !== node.present;
51
- case "Contains": {
52
- const value = valueOf(node.value, row, input);
53
- const search = sideOf(node.search, row, input);
54
- if (isNull(value) || isNull(search)) return "unknown";
55
- if (typeof value !== "string" || typeof search !== "string") throw new QueryEvaluateError("a containment test was given something that is not text");
56
- return value.toLowerCase().includes(search.toLowerCase());
57
- }
58
- }
59
- };
60
- /** Every predicate must hold: the list is the conjunction, as it is in a `Query`. */
61
- const matches = (body, row, input) => body.where.every((node) => holds(node, row, input) === true);
62
- const compare = (left, right, query) => {
63
- if (typeof left === "string" && typeof right === "string") return left < right ? -1 : left > right ? 1 : 0;
64
- if (typeof left === "number" && typeof right === "number") return left - right;
65
- if (typeof left === "boolean" && typeof right === "boolean") return Number(left) - Number(right);
66
- throw new QueryEvaluateError(`query "${query}" orders by values this interpreter cannot compare (${typeof left} and ${typeof right})`);
67
- };
68
- const ordered = (rows, terms, query) => {
69
- if (terms.length === 0) return [...rows];
70
- return [...rows].sort((left, right) => {
71
- for (const term of terms) {
72
- if (term.expr._tag !== "Field") throw new QueryEvaluateError(`query "${query}" orders by something that is not a field, which this interpreter cannot run yet`);
73
- const a = left[term.expr.key];
74
- const b = right[term.expr.key];
75
- if (isNull(a) || isNull(b)) throw new QueryEvaluateError(`query "${query}" orders by "${term.expr.key}", which is null in a row; where nulls sort is a thing databases disagree about, so it is outside what this interpreter will answer for`);
76
- const sign = compare(a, b, query);
77
- if (sign !== 0) return term.direction === "asc" ? sign : -sign;
78
- }
79
- return 0;
80
- });
81
- };
82
- /**
83
- * The rows the body matches, in the order it asks for. Pure: it reads the rows
84
- * it is given and nothing else.
85
- *
86
- * `input` holds the values this run was given, by the keys the body's
87
- * placeholders were built with — the same record the query would be called
88
- * with anywhere else.
89
- */
90
- const evaluate = (body, input, rows) => ordered(rows.filter((row) => matches(body, row, input)), body.orderBy, body.entity.name);
91
- //#endregion
2
+ import { QueryEvaluateError, assertSupported, evaluate, evaluate as evaluate$1, supported } from "foldkit-entity";
3
+ import { RELATION_ALIAS, REMOTE_PROTOCOL_VERSION, Remote, RemoteLiveError, RemoteMutationError, RemoteProtocolError, RemoteQueryError, RemoteReadError, Requirement, aliasedField, connectionIdentity, entityKey, refsIn, stableStringify } from "foldkit-remote";
92
4
  //#region src/index.ts
93
5
  /**
94
6
  * `foldkit-remote-server` — server-side Sources and handler compilation.
@@ -361,7 +273,180 @@ const groupByEntity = (requests) => {
361
273
  }
362
274
  return [...grouped.values()];
363
275
  };
276
+ /**
277
+ * One page of ordered items for a window, as a real server pages them. A
278
+ * cursor is an item's id: a forward page starts at the `after` it was asked
279
+ * for and ends at its last item while more follow, a backward page the
280
+ * mirror, so a page fetched from another's end cursor joins it.
281
+ *
282
+ * `locate` places a cursor that is not among the items, as a keyset does: a
283
+ * row that stopped matching still has a place in the order. Without it, such
284
+ * a cursor is an error. A page of no items has no id of its own to end at, so
285
+ * with more beyond it and no cursor to repeat, its boundary is `Unknown`.
286
+ */
287
+ const pageOf = (items, window, idOf, locate) => {
288
+ if (window.after !== void 0 && window.before !== void 0 || window.first !== void 0 && window.last !== void 0) throw new Error("A query window cannot combine after with before, or first with last");
289
+ const position = (cursor) => {
290
+ const index = items.findIndex((item) => idOf(item) === cursor);
291
+ if (index >= 0) return {
292
+ index,
293
+ exact: true
294
+ };
295
+ if (locate !== void 0) return locate(cursor);
296
+ throw new Error(`Cursor "${cursor}" names nothing in these results`);
297
+ };
298
+ const cursor = (id) => ({
299
+ _tag: "Cursor",
300
+ cursor: id
301
+ });
302
+ const terminal = { _tag: "Terminal" };
303
+ const unknown = { _tag: "Unknown" };
304
+ if (window.last !== void 0 || window.before !== void 0) {
305
+ const to = window.before === void 0 ? items.length : position(window.before).index;
306
+ const from = window.last === void 0 ? 0 : Math.max(0, to - window.last);
307
+ const page = items.slice(from, to);
308
+ return {
309
+ items: page,
310
+ start: from === 0 ? terminal : page.length > 0 ? cursor(idOf(page[0])) : window.before === void 0 ? unknown : cursor(window.before),
311
+ end: window.before === void 0 ? terminal : cursor(window.before)
312
+ };
313
+ }
314
+ const at = window.after === void 0 ? void 0 : position(window.after);
315
+ const from = at === void 0 ? 0 : at.exact ? at.index + 1 : at.index;
316
+ const to = window.first === void 0 ? items.length : Math.min(items.length, from + window.first);
317
+ const page = items.slice(from, to);
318
+ const end = to >= items.length ? terminal : page.length > 0 ? cursor(idOf(page.at(-1))) : window.after === void 0 ? unknown : cursor(window.after);
319
+ return {
320
+ items: page,
321
+ start: window.after === void 0 ? terminal : cursor(window.after),
322
+ end
323
+ };
324
+ };
325
+ /**
326
+ * A backend held in memory: the rows you give it, served through the same
327
+ * handlers a real server uses. For a first run, a test, a story or a demo, with
328
+ * no database and no network.
329
+ *
330
+ * Reads go through `handlers`, so field filtering and nested relations behave
331
+ * as they do in production. A query declared with `Query.define` is answered
332
+ * by running its body over the rows with the reference interpreter, the one
333
+ * every interpreter is held to by the conformance suite. A query with no body
334
+ * has nothing to run and is refused when the backend is made, unless `queries`
335
+ * supplies a source for it. Mutations are yours to give: each one writes
336
+ * through the store it is handed, and the next read sees the change.
337
+ *
338
+ * It does not push live changes, and it authorizes nothing: every field of
339
+ * every row is readable. It is not a server to deploy.
340
+ */
341
+ const memory = (config) => {
342
+ const tables = /* @__PURE__ */ new Map();
343
+ const table = (entity) => {
344
+ const existing = tables.get(entity);
345
+ if (existing !== void 0) return existing;
346
+ const created = /* @__PURE__ */ new Map();
347
+ tables.set(entity, created);
348
+ return created;
349
+ };
350
+ for (const [entity, rows] of Object.entries(config.rows)) for (const row of rows) table(entity).set(String(row.id), { ...row });
351
+ const store = {
352
+ rows: (entity) => [...table(entity).values()],
353
+ write: (entity, id, values) => {
354
+ table(entity).set(id, {
355
+ ...table(entity).get(id),
356
+ id,
357
+ ...values
358
+ });
359
+ },
360
+ remove: (entity, id) => {
361
+ table(entity).delete(id);
362
+ }
363
+ };
364
+ const valueFor = (value, window) => {
365
+ if (window === void 0 || !Array.isArray(value)) return value;
366
+ const refs = [...new Set(value)];
367
+ const idOf = (ref) => ref.slice(ref.indexOf(":") + 1);
368
+ const named = (cursor) => cursor === void 0 ? void 0 : cursor.includes(":") ? idOf(cursor) : cursor;
369
+ let page;
370
+ try {
371
+ page = pageOf(refs, {
372
+ ...window,
373
+ after: named(window.after),
374
+ before: named(window.before)
375
+ }, idOf);
376
+ } catch {
377
+ return {
378
+ refs: [],
379
+ hasNext: false,
380
+ hasPrevious: false
381
+ };
382
+ }
383
+ return {
384
+ refs: page.items,
385
+ hasNext: page.end._tag === "Cursor",
386
+ hasPrevious: page.start._tag === "Cursor"
387
+ };
388
+ };
389
+ const entities = [...config.domain.registry.entities.keys()].map((name) => RemoteServer.entity({ name }, { read: ({ ids, fields, windows }) => Effect.try({
390
+ try: () => ids.flatMap((id) => {
391
+ const row = table(name).get(id);
392
+ if (row === void 0) return [];
393
+ return [{
394
+ id,
395
+ values: Object.fromEntries(fields.flatMap((field) => field in row ? [[field, valueFor(row[field], windows?.[field])]] : []))
396
+ }];
397
+ }),
398
+ catch: (error) => new RemoteServerError({ message: error instanceof Error ? error.message : String(error) })
399
+ }) }));
400
+ const given = new Set((config.queries ?? []).map((source) => source.query));
401
+ const bodiless = [...config.domain.registry.queries.values()].filter((query) => query.body === void 0 && !given.has(query.name));
402
+ if (bodiless.length > 0) throw new Error(`RemoteServer.memory: ${bodiless.map((query) => `"${query.name}"`).join(", ")} ${bodiless.length === 1 ? "has" : "have"} no body to run. Declare ${bodiless.length === 1 ? "it" : "them"} with Query.define, or give a source in \`queries\`.`);
403
+ const queries = [...config.queries ?? [], ...[...config.domain.registry.queries.values()].filter((query) => !given.has(query.name)).map((query) => RemoteServer.query(query, ({ input, window }) => Effect.try({
404
+ try: () => {
405
+ const body = query.body;
406
+ const encoded = Schema.encodeSync(query.Input)(input);
407
+ const entity = body.entity.name;
408
+ const rows = store.rows(entity);
409
+ const matched = evaluate$1(body, encoded, rows);
410
+ const locate = (cursor) => {
411
+ const row = rows.find((candidate) => String(candidate.id) === cursor);
412
+ if (row === void 0) throw new Error(`Cursor "${cursor}" names a row that no longer exists`);
413
+ return {
414
+ index: evaluate$1({
415
+ ...body,
416
+ where: []
417
+ }, encoded, [...matched, row]).indexOf(row),
418
+ exact: false
419
+ };
420
+ };
421
+ const page = pageOf(matched, window, (row) => String(row.id), locate);
422
+ return {
423
+ edges: page.items.map((row) => {
424
+ const id = String(row.id);
425
+ return {
426
+ entity,
427
+ id,
428
+ key: entityKey(entity, id)
429
+ };
430
+ }),
431
+ start: page.start,
432
+ end: page.end
433
+ };
434
+ },
435
+ catch: (error) => new RemoteServerError({ message: error instanceof Error ? error.message : String(error) })
436
+ })))];
437
+ const server = RemoteServer.make({
438
+ entities,
439
+ queries,
440
+ mutations: config.mutations?.(store) ?? []
441
+ });
442
+ return {
443
+ ...store,
444
+ layer: Remote.clientLayer(RemoteServer.handlers(server, void 0))
445
+ };
446
+ };
364
447
  const RemoteServer = {
448
+ /** A backend held in memory, for a first run, a test or a demo. See `memory`. */
449
+ memory,
365
450
  /** A mutation outcome's report that `ref` now heads the connection. */
366
451
  prepend: (connection, ref) => connectionChange(connection, ref, "prepend"),
367
452
  /** A mutation outcome's report that `ref` now ends the connection. */
@@ -587,6 +672,6 @@ const RemoteServer = {
587
672
  })
588
673
  };
589
674
  //#endregion
590
- export { QueryEvaluateError, RemoteServer, RemoteServerError, evaluate };
675
+ export { QueryEvaluateError, RemoteServer, RemoteServerError, assertSupported, evaluate, supported };
591
676
 
592
677
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../src/evaluate.ts","../src/index.ts"],"sourcesContent":["/**\n * The reference interpreter: a query body run over rows already in memory.\n *\n * `foldkit-remote-drizzle` compiles a body to SQL. This runs the same body\n * directly, which is what makes \"source-neutral\" a fact rather than a claim —\n * the two are checked against each other over a real database, and a body that\n * means one thing here and another there is a bug in one of them.\n *\n * It is also the interpreter to reach for when there is no database: a test\n * that wants rows, or a server assembling a page from values it already holds.\n *\n * **It follows SQL, not JavaScript.** Where the two disagree this follows SQL,\n * because SQL is what the other interpreter runs. The important case is null:\n * `null = null` is unknown in SQL and a row is not matched by it, where\n * JavaScript would happily call the two equal.\n */\nimport { isPredicate } from 'foldkit-entity'\nimport type { AnyExpr, AnyQuery, Operandish, OrderTerm, Predicate } from 'foldkit-entity'\n\n/** A row as this interpreter reads one: values by field key. */\nexport type Row = Readonly<Record<string, unknown>>\n\nexport class QueryEvaluateError extends Error {\n constructor(message: string) {\n super(`[foldkit-remote-server] ${message}`)\n this.name = 'QueryEvaluateError'\n }\n}\n\nconst valueOf = (node: AnyExpr, row: Row, input: Row): unknown => {\n switch (node._tag) {\n case 'Field':\n return row[node.key]\n case 'Literal':\n return node.value\n case 'Input':\n return input[node.key]\n }\n}\n\n/** SQL's unknown: neither true nor false, and a row is kept only on true. */\ntype Truth = boolean | 'unknown'\n\nconst isNull = (value: unknown): boolean => value === null || value === undefined\n\n/** A predicate used as a value is its own truth; anything else is its value. */\nconst sideOf = (node: Operandish, row: Row, input: Row): unknown =>\n isPredicate(node) ? truthValue(holds(node, row, input)) : valueOf(node, row, input)\n\n/**\n * A predicate compared as a value. SQL's unknown is null there too, so an\n * unknown compared to anything stays unknown rather than becoming false.\n */\nconst truthValue = (truth: Truth): unknown => (truth === 'unknown' ? null : truth)\n\nconst holds = (node: Predicate, row: Row, input: Row): Truth => {\n switch (node._tag) {\n case 'Eq': {\n const left = sideOf(node.left, row, input)\n const right = sideOf(node.right, row, input)\n // `null = anything` is unknown in SQL, including `null = null`. A row is\n // kept only when a comparison is true, so an unknown drops it either way;\n // saying so explicitly is what keeps this honest about three-valued logic\n // rather than accidentally right about it.\n if (isNull(left) || isNull(right)) return 'unknown'\n return left === right\n }\n case 'Null':\n // The one comparison that is never unknown: asking whether a value is\n // absent always has an answer.\n return isNull(valueOf(node.operand, row, input)) !== node.present\n case 'Contains': {\n const value = valueOf(node.value, row, input)\n const search = sideOf(node.search, row, input)\n // `null like anything` is unknown, which is why an empty search is not\n // the same as no filter over a column that can be null.\n if (isNull(value) || isNull(search)) return 'unknown'\n if (typeof value !== 'string' || typeof search !== 'string') {\n throw new QueryEvaluateError('a containment test was given something that is not text')\n }\n // Case-insensitive, because that is what `Expr.contains` means and what\n // the compiled SQL folds both sides to. Plain `includes` would be\n // case-sensitive here and case-insensitive under SQLite's `like`, which\n // is a body meaning two things.\n return value.toLowerCase().includes(search.toLowerCase())\n }\n }\n}\n\n/** Every predicate must hold: the list is the conjunction, as it is in a `Query`. */\nconst matches = (body: AnyQuery, row: Row, input: Row): boolean =>\n body.where.every(node => holds(node, row, input) === true)\n\nconst compare = (left: unknown, right: unknown, query: string): number => {\n if (typeof left === 'string' && typeof right === 'string') {\n return left < right ? -1 : left > right ? 1 : 0\n }\n if (typeof left === 'number' && typeof right === 'number') return left - right\n if (typeof left === 'boolean' && typeof right === 'boolean') {\n return Number(left) - Number(right)\n }\n throw new QueryEvaluateError(\n `query \"${query}\" orders by values this interpreter cannot compare (${typeof left} and ${typeof right})`,\n )\n}\n\nconst ordered = (rows: ReadonlyArray<Row>, terms: ReadonlyArray<OrderTerm>, query: string) => {\n if (terms.length === 0) return [...rows]\n return [...rows].sort((left, right) => {\n for (const term of terms) {\n if (term.expr._tag !== 'Field') {\n throw new QueryEvaluateError(\n `query \"${query}\" orders by something that is not a field, which this interpreter cannot run yet`,\n )\n }\n const a = left[term.expr.key]\n const b = right[term.expr.key]\n if (isNull(a) || isNull(b)) {\n throw new QueryEvaluateError(\n `query \"${query}\" orders by \"${term.expr.key}\", which is null in a row; where nulls sort is a thing databases disagree about, so it is outside what this interpreter will answer for`,\n )\n }\n const sign = compare(a, b, query)\n if (sign !== 0) return term.direction === 'asc' ? sign : -sign\n }\n return 0\n })\n}\n\n/**\n * The rows the body matches, in the order it asks for. Pure: it reads the rows\n * it is given and nothing else.\n *\n * `input` holds the values this run was given, by the keys the body's\n * placeholders were built with — the same record the query would be called\n * with anywhere else.\n */\nexport const evaluate = (\n body: AnyQuery,\n input: Row,\n rows: ReadonlyArray<Row>,\n): ReadonlyArray<Row> =>\n ordered(\n rows.filter(row => matches(body, row, input)),\n body.orderBy,\n body.entity.name,\n )\n","/**\n * `foldkit-remote-server` — server-side Sources and handler compilation.\n *\n * Owns entity/query Sources, **selection authorization**, normalization, and\n * turning them into Effect RPC handlers. It does not own HTTP, serialization, or\n * auth protocol; `principal` is resolved outside and passed in.\n */\nimport { Effect, Queue, Schema, Stream } from 'effect'\nimport {\n REMOTE_PROTOCOL_VERSION,\n RemoteLiveError,\n RemoteMutationError,\n RemoteProtocolError,\n RemoteQueryError,\n RemoteReadError,\n connectionIdentity,\n entityKey,\n refsIn,\n stableStringify,\n type Boundary,\n type ConnectionChangeSchema,\n type ConnectionIdentity,\n type LiveChange,\n type MutationDescriptor,\n type NormalizedPatch,\n type QueryDescriptor,\n type QueryWindow,\n type RelationRequirement,\n type RemoteDescriptor,\n Requirement,\n type RemoteRpcClient,\n RELATION_ALIAS,\n aliasedField,\n} from 'foldkit-remote'\n\nexport class RemoteServerError extends Schema.TaggedError<RemoteServerError>()(\n 'RemoteServerError',\n {\n message: Schema.String,\n },\n) {}\n\nexport interface EntityRecord {\n readonly id: string\n readonly values: Readonly<Record<string, unknown>>\n}\n\nexport interface EntitySourceContext<P> {\n readonly ids: readonly string[]\n readonly fields: readonly string[]\n /** A pagination window per requested relation field. */\n readonly windows?: Readonly<Record<string, QueryWindow>> | undefined\n readonly principal: P\n}\n\nexport interface EntitySource<P, R = never> {\n readonly entity: string\n /** The fields the entity declares; a request for any other never reaches `read`. */\n readonly fields?: ReadonlySet<string> | undefined\n readonly read: (\n context: EntitySourceContext<P>,\n ) => Effect.Effect<ReadonlyArray<EntityRecord>, RemoteServerError, R>\n /** Returns the fields this principal may read; omitted means all requested. */\n readonly authorize?: (principal: P, fields: readonly string[]) => readonly string[]\n}\n\n/** A connection change a mutation made, as the wire carries it. */\nexport type ConnectionChange = Schema.Schema.Type<typeof ConnectionChangeSchema>\n\nconst connectionChange = (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n position: 'prepend' | 'append' | 'remove',\n): ConnectionChange => {\n const edge = { entity: ref.entity, id: ref.id, key: entityKey(ref.entity, ref.id) }\n return position === 'remove'\n ? { _tag: 'Remove', connection: connectionIdentity(connection), edge }\n : { _tag: 'Insert', connection: connectionIdentity(connection), position, edge }\n}\n\n/**\n * The requested fields, in request order, that the source declares and the\n * principal may read. Never a field the client did not request, even if a\n * permissive `authorize` returns more.\n */\nconst allowedFields = <P, R>(\n source: EntitySource<P, R>,\n principal: P,\n requested: ReadonlyArray<string>,\n): ReadonlyArray<string> => {\n const declared =\n source.fields === undefined ? requested : requested.filter(field => source.fields!.has(field))\n if (declared.length === 0) return []\n const permitted = new Set(\n source.authorize === undefined ? declared : source.authorize(principal, declared),\n )\n return declared.filter(field => permitted.has(field))\n}\n\n/** The windows of the fields being read; only a field being read carries its window. */\nconst windowsOf = (\n windows: Readonly<Record<string, QueryWindow>> | undefined,\n fields: ReadonlyArray<string>,\n): { readonly windows?: Readonly<Record<string, QueryWindow>> } => {\n if (windows === undefined) return {}\n const kept = Object.fromEntries(\n fields.flatMap(field =>\n Object.hasOwn(windows, field) ? [[field, windows[field]!] as const] : [],\n ),\n )\n return Object.keys(kept).length === 0 ? {} : { windows: kept }\n}\n\nexport interface MutationOutcome<Output> {\n readonly output: Output\n readonly entities?: ReadonlyArray<NormalizedPatch>\n /** Connection changes the mutation made; the client settles them with its patches. */\n readonly connections?: ReadonlyArray<ConnectionChange>\n /**\n * Entities the mutation deleted. The client knows them absent from then on:\n * they leave every connection and read `NotFound`, with no connection to name.\n */\n readonly deleted?: ReadonlyArray<{ readonly entity: string; readonly id: string }>\n}\n\nexport interface MutationSource<P, R = never> {\n readonly mutation: string\n readonly Input: Schema.Codec<unknown>\n readonly Output: Schema.Codec<unknown>\n readonly run: (context: { readonly input: unknown; readonly principal: P }) => Effect.Effect<\n {\n readonly output: unknown\n readonly entities: ReadonlyArray<NormalizedPatch>\n readonly connections: ReadonlyArray<ConnectionChange>\n readonly deleted: ReadonlyArray<{ readonly entity: string; readonly id: string }>\n },\n RemoteServerError,\n R\n >\n}\n\nexport interface QueryPage {\n readonly edges: ReadonlyArray<{\n readonly entity: string\n readonly id: string\n readonly key: string\n }>\n readonly start: Boundary\n readonly end: Boundary\n}\n\nexport interface QuerySource<P, R = never> {\n readonly query: string\n readonly Input: Schema.Codec<unknown>\n readonly run: (context: {\n readonly input: unknown\n readonly window: QueryWindow\n readonly principal: P\n }) => Effect.Effect<QueryPage, RemoteServerError, R>\n}\n\nexport interface LiveSource<P, R = never> {\n readonly entity: string\n readonly subscribe: (context: {\n readonly requirements: ReadonlyArray<Requirement>\n readonly after: number\n readonly principal: P\n }) => Stream.Stream<Schema.Schema.Type<typeof LiveChange>, RemoteServerError, R>\n}\n\nexport interface ServerDefinition<P, R = never> {\n readonly entities: ReadonlyMap<string, EntitySource<P, R>>\n readonly mutations: ReadonlyMap<string, MutationSource<P, R>>\n readonly queries: ReadonlyMap<string, QuerySource<P, R>>\n readonly live: ReadonlyMap<string, LiveSource<P, R>>\n}\n\n/** A read batch may not carry more than this many distinct ids per entity. */\nconst DEFAULT_MAX_IDS_PER_ENTITY = 1000\n\n/** A nested selection may not reach further than this many relation levels. */\nconst DEFAULT_MAX_DEPTH = 8\n\nexport interface HandlerOptions<P, R = never> {\n /** A read or live subscription may not name more ids of one entity than this; default 1000. */\n readonly maxIdsPerEntity?: number | undefined\n /** A nested selection may not reach further than this many relation levels; default 8. */\n readonly maxDepth?: number | undefined\n /** A hub whose `changed`/`deleted` signals reach the subscribers this handler registers. */\n readonly live?: LiveHub<P, R> | undefined\n}\n\n/** Fails when the requirements name more distinct ids of one entity than `maxIds`. */\n/**\n * Each page of a relation read beside another is a source read of its own, and\n * the names come from the client, so how many one relation may have is bounded.\n * A screen shows a list and a page or two of it, not dozens.\n */\nconst MAX_PAGES_PER_RELATION = 4\n\n/** The relation a request pages more ways than allowed, at any depth; `undefined` when none. */\nconst checkPagesPerRelation = (\n requirements: ReadonlyArray<RelationRequirement>,\n): string | undefined => {\n for (const requirement of requirements) {\n const pages = new Map<string, number>()\n for (const name of requirement.fields) {\n if (!name.includes(RELATION_ALIAS)) continue\n const field = aliasedField(name)\n const count = (pages.get(field) ?? 0) + 1\n if (count > MAX_PAGES_PER_RELATION) return `${requirement.entity}.${field}`\n pages.set(field, count)\n }\n const nested = checkPagesPerRelation(Object.values(requirement.relations ?? {}))\n if (nested !== undefined) return nested\n }\n return undefined\n}\n\nconst checkIdsPerEntity = (\n requirements: ReadonlyArray<Requirement>,\n maxIds: number,\n): string | undefined => {\n const ids = new Map<string, Set<string>>()\n for (const requirement of requirements) {\n const seen = ids.get(requirement.entity) ?? new Set<string>()\n seen.add(requirement.id)\n ids.set(requirement.entity, seen)\n if (seen.size > maxIds) return requirement.entity\n }\n return undefined\n}\n\ntype LiveChangeValue = Schema.Schema.Type<typeof LiveChange>\ntype Uncursored<T> = T extends unknown ? Omit<T, 'cursor'> : never\n\ninterface LiveRef {\n readonly entity: string\n readonly id: string\n}\n\n/**\n * The server-side \"these fields changed\" signal. A hub tracks each live\n * subscriber's requirements (entity, id, fields) and principal; `changed`\n * re-reads the changed fields a subscriber selects through the entity's own\n * source, under that subscriber's principal, and streams the patch to it.\n * Subscribers that select none of the changed fields do no work. Cursors\n * continue from the cursor each subscriber resumed at, so the client's\n * duplicate and gap handling is unchanged.\n */\nexport interface LiveHub<P, R = never> {\n readonly changed: (\n ref: LiveRef,\n fields: ReadonlyArray<string>,\n ) => Effect.Effect<void, RemoteServerError, R>\n readonly deleted: (ref: LiveRef) => Effect.Effect<void>\n /** Registers a subscriber for the stream's lifetime; `handlers` calls this. */\n readonly subscribe: (context: {\n readonly requirements: ReadonlyArray<Requirement>\n readonly after: number\n readonly principal: P\n /** Refuses a subscription naming more ids of one entity than this. */\n readonly maxIdsPerEntity?: number | undefined\n }) => Stream.Stream<LiveChangeValue, RemoteServerError>\n /** How many subscribers are registered now. */\n readonly size: Effect.Effect<number>\n}\n\ninterface Selected {\n readonly fields: Set<string>\n /** The window each paged field was subscribed with, so a re-read pages the same way. */\n readonly windows: Map<string, QueryWindow>\n}\n\n/** The subscribers one source read answers, and the fields each wants of it. */\ninterface ReadGroup<P> {\n readonly windows: Readonly<Record<string, QueryWindow>>\n /** The alias each field read here is answered under. */\n readonly renames: Readonly<Record<string, string>>\n readonly entries: Array<{ readonly subscriber: Subscriber<P>; readonly fields: string[] }>\n}\n\ninterface Subscriber<P> {\n /** Per entity:id, the fields (and their windows) this subscriber selects. */\n readonly selected: ReadonlyMap<string, Selected>\n readonly principal: P\n readonly queue: Queue.Queue<LiveChangeValue>\n cursor: number\n}\n\nconst liveHub = <P, R>(entities: ReadonlyArray<EntitySource<P, R>>): Effect.Effect<LiveHub<P, R>> =>\n Effect.sync(() => {\n const sources = new Map(entities.map(source => [source.entity, source]))\n const subscribers = new Set<Subscriber<P>>()\n const emit = (subscriber: Subscriber<P>, change: Uncursored<LiveChangeValue>) => {\n subscriber.cursor += 1\n return Queue.offer(subscriber.queue, {\n ...change,\n cursor: subscriber.cursor,\n } as LiveChangeValue)\n }\n\n return {\n subscribe: ({ requirements, after, principal, maxIdsPerEntity }) =>\n Stream.unwrap(\n Effect.gen(function* () {\n const over = checkIdsPerEntity(\n requirements,\n Math.max(1, maxIdsPerEntity ?? DEFAULT_MAX_IDS_PER_ENTITY),\n )\n if (over !== undefined) {\n return yield* new RemoteServerError({\n message: `Too many \"${over}\" ids in one live subscription`,\n })\n }\n const paged = checkPagesPerRelation(requirements)\n if (paged !== undefined) {\n return yield* new RemoteServerError({\n message: `Too many pages of \"${paged}\" in one live subscription`,\n })\n }\n const selected = new Map<string, Selected>()\n for (const requirement of requirements) {\n const key = `${requirement.entity}:${requirement.id}`\n const entry = selected.get(key) ?? { fields: new Set<string>(), windows: new Map() }\n for (const field of requirement.fields) entry.fields.add(field)\n for (const [field, window] of Object.entries(requirement.windows ?? {})) {\n entry.windows.set(field, window)\n }\n selected.set(key, entry)\n }\n const subscriber: Subscriber<P> = {\n selected,\n principal,\n queue: yield* Queue.unbounded<LiveChangeValue>(),\n cursor: after,\n }\n subscribers.add(subscriber)\n return Stream.fromQueue(subscriber.queue).pipe(\n Stream.ensuring(Effect.sync(() => void subscribers.delete(subscriber))),\n )\n }),\n ),\n\n changed: (ref, fields) =>\n Effect.gen(function* () {\n const key = `${ref.entity}:${ref.id}`\n const source = sources.get(ref.entity)\n if (source === undefined) return\n // One source read per principal (by identity) and window signature:\n // subscribers sharing both share the read, and a paged field is\n // re-read with the window the subscriber selected it with.\n const groups = new Map<P, Map<string, ReadGroup<P>>>()\n for (const subscriber of subscribers) {\n const selected = subscriber.selected.get(key)\n if (selected === undefined) continue\n const byWindows = groups.get(subscriber.principal) ?? new Map<string, ReadGroup<P>>()\n groups.set(subscriber.principal, byWindows)\n const join = (\n windows: Readonly<Record<string, QueryWindow>>,\n renames: Readonly<Record<string, string>>,\n wanted: string[],\n ): void => {\n const groupKey = `${stableStringify(windows)}\\u0000${stableStringify(renames)}`\n const group = byWindows.get(groupKey) ?? { windows, renames, entries: [] }\n byWindows.set(groupKey, group)\n group.entries.push({ subscriber, fields: wanted })\n }\n const wanted = fields.filter(field => selected.fields.has(field))\n if (wanted.length > 0)\n join(\n Object.fromEntries(\n wanted.flatMap(field => {\n const window = selected.windows.get(field)\n return window === undefined ? [] : [[field, window] as const]\n }),\n ),\n {},\n wanted,\n )\n // A page read under an alias changes when the relation it reads does, and\n // is re-read on its own, with its window, so the whole list can be too.\n for (const alias of selected.fields) {\n const window = selected.windows.get(alias)\n const field = aliasedField(alias)\n if (field === alias || window === undefined || !fields.includes(field)) continue\n join({ [field]: window }, { [field]: alias }, [field])\n }\n }\n for (const [principal, byWindows] of groups) {\n for (const { windows, renames, entries: group } of byWindows.values()) {\n const requested = [...new Set(group.flatMap(entry => entry.fields))]\n const allowed = allowedFields(source, principal, requested)\n if (allowed.length === 0) continue\n const allowedSet = new Set(allowed)\n const records = yield* source.read({\n ids: [ref.id],\n fields: allowed,\n principal,\n ...windowsOf(windows, allowed),\n })\n const record = records.find(candidate => candidate.id === ref.id)\n if (record === undefined) continue\n for (const { subscriber, fields: wanted } of group) {\n const values: Record<string, unknown> = Object.create(null)\n for (const field of wanted) {\n if (allowedSet.has(field) && Object.hasOwn(record.values, field)) {\n values[renames[field] ?? field] = record.values[field]\n }\n }\n const changed = Object.keys(values)\n if (changed.length === 0) continue\n yield* emit(subscriber, {\n _tag: 'EntityPatched',\n entity: ref.entity,\n id: ref.id,\n values,\n changed,\n })\n }\n }\n }\n }),\n\n deleted: ref =>\n Effect.gen(function* () {\n const key = `${ref.entity}:${ref.id}`\n for (const subscriber of subscribers) {\n if (!subscriber.selected.has(key)) continue\n yield* emit(subscriber, { _tag: 'EntityDeleted', entity: ref.entity, id: ref.id })\n }\n }),\n\n size: Effect.sync(() => subscribers.size),\n }\n })\n\nconst protocolMismatch = (received: number): RemoteProtocolError | undefined =>\n received === REMOTE_PROTOCOL_VERSION\n ? undefined\n : new RemoteProtocolError({\n message: `Remote protocol version ${received} is not ${REMOTE_PROTOCOL_VERSION}`,\n expected: REMOTE_PROTOCOL_VERSION,\n received,\n })\n\ninterface EntityGroup {\n readonly ids: Set<string>\n /** The union of the requests' fields, windows, and relations. */\n slice: RelationRequirement\n /** The alias each field read here is answered under; see `RELATION_ALIAS`. */\n readonly renames: Readonly<Record<string, string>>\n}\n\n/** A request, or the part of one that reads a relation under an alias. */\ntype Part = Requirement & { readonly renames?: Readonly<Record<string, string>> }\n\nconst pickNames = <T>(\n record: Readonly<Record<string, T>> | undefined,\n names: ReadonlyArray<string>,\n): Readonly<Record<string, T>> | undefined => {\n if (record === undefined) return undefined\n const picked = names.flatMap(name =>\n Object.hasOwn(record, name) ? [[name, record[name]!] as const] : [],\n )\n return picked.length === 0 ? undefined : Object.fromEntries(picked)\n}\n\n/**\n * A request's aliased fields, each as a read of its own. `comments@first=10` is\n * the `comments` relation read with the alias's window, so a source sees the\n * field it knows and one window for it, while the whole list rides beside it in\n * another read. The answer goes back under the alias, which is also the key of\n * the relation followed from it.\n */\nconst splitAliases = (request: Requirement): ReadonlyArray<Part> => {\n const aliases = request.fields.filter(field => field.includes(RELATION_ALIAS))\n if (aliases.length === 0) return [request]\n const plain = request.fields.filter(field => !field.includes(RELATION_ALIAS))\n interface Building {\n fields: string[]\n windows: Record<string, QueryWindow>\n relations: Record<string, RelationRequirement>\n renames: Record<string, string>\n }\n const first: Building = {\n fields: [...plain],\n windows: { ...pickNames(request.windows, plain) },\n relations: { ...pickNames(request.relations, plain) },\n renames: {},\n }\n const building: Building[] = [first]\n for (const alias of aliases) {\n const window = request.windows?.[alias]\n // An alias is a page: one that names no window asks for nothing.\n if (window === undefined) continue\n const field = aliasedField(alias)\n // It rides in a read that does not already read its relation, so a request\n // costs one read unless the list and a page of it are both wanted.\n let part = building.find(candidate => !candidate.fields.includes(field))\n if (part === undefined) {\n part = { fields: [], windows: {}, relations: {}, renames: {} }\n building.push(part)\n }\n part.fields.push(field)\n part.windows[field] = window\n part.renames[field] = alias\n const relation = request.relations?.[alias]\n if (relation !== undefined) part.relations[alias] = relation\n }\n return building\n .filter(part => part.fields.length > 0)\n .map(part => ({\n entity: request.entity,\n id: request.id,\n fields: part.fields,\n ...(Object.keys(part.windows).length === 0 ? {} : { windows: part.windows }),\n ...(Object.keys(part.relations).length === 0 ? {} : { relations: part.relations }),\n ...(Object.keys(part.renames).length === 0 ? {} : { renames: part.renames }),\n }))\n}\n\n/**\n * One level's requests grouped per entity and window signature: ids and\n * slices unioned. Requests that page a relation differently are separate\n * groups, so one window never answers for another id.\n */\nconst groupByEntity = (requests: ReadonlyArray<Requirement>): EntityGroup[] => {\n const grouped = new Map<string, EntityGroup>()\n for (const request of requests.flatMap(splitAliases)) {\n const renames = request.renames ?? {}\n const groupKey = `${request.entity}\\u0000${stableStringify(request.windows ?? null)}\\u0000${stableStringify(renames)}`\n const group = grouped.get(groupKey)\n if (group === undefined) {\n grouped.set(groupKey, {\n ids: new Set([request.id]),\n slice: Requirement.mergeRelation({ entity: request.entity, fields: [] }, request),\n renames,\n })\n } else {\n group.ids.add(request.id)\n group.slice = Requirement.mergeRelation(group.slice, request)\n }\n }\n return [...grouped.values()]\n}\n\n/** A descriptor's name and, when it declares them, its fields. */\ninterface EntityName {\n readonly name: string\n readonly fields?: Readonly<Record<string, unknown>> | undefined\n}\n\nexport const RemoteServer = {\n /** A mutation outcome's report that `ref` now heads the connection. */\n prepend: (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n ): ConnectionChange => connectionChange(connection, ref, 'prepend'),\n\n /** A mutation outcome's report that `ref` now ends the connection. */\n append: (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n ): ConnectionChange => connectionChange(connection, ref, 'append'),\n\n /** A mutation outcome's report that `ref` left the connection. */\n remove: (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n ): ConnectionChange => connectionChange(connection, ref, 'remove'),\n\n /**\n * An entity source. Given the Entity (or anything with its `name` and\n * `fields`), a request for a field the entity does not declare never\n * reaches `read` or `authorize`.\n */\n entity: <P = unknown, R = never>(\n entity: EntityName,\n options: {\n readonly read: EntitySource<P, R>['read']\n readonly authorize?: EntitySource<P, R>['authorize']\n },\n ): EntitySource<P, R> => ({\n entity: entity.name,\n ...(entity.fields === undefined ? {} : { fields: new Set(Object.keys(entity.fields)) }),\n read: options.read,\n ...(options.authorize === undefined ? {} : { authorize: options.authorize }),\n }),\n\n mutation: <\n P = unknown,\n R = never,\n Name extends string = string,\n Input = unknown,\n Output = unknown,\n >(\n mutation: MutationDescriptor<Name, Input, Output>,\n run: (context: {\n readonly input: Input\n readonly principal: P\n }) => Effect.Effect<MutationOutcome<Output>, RemoteServerError, R>,\n ): MutationSource<P, R> => ({\n mutation: mutation.name,\n Input: mutation.Input,\n Output: mutation.Output,\n run: context =>\n run({ input: context.input as Input, principal: context.principal }).pipe(\n Effect.map(outcome => ({\n output: outcome.output,\n entities: outcome.entities ?? [],\n connections: outcome.connections ?? [],\n deleted: outcome.deleted ?? [],\n })),\n ),\n }),\n\n query: <P = unknown, R = never, Input = unknown>(\n query: QueryDescriptor<string, Input, unknown>,\n run: (context: {\n readonly input: Input\n readonly window: QueryWindow\n readonly principal: P\n }) => Effect.Effect<QueryPage, RemoteServerError, R>,\n ): QuerySource<P, R> => ({\n query: query.name,\n Input: query.Input,\n run: context =>\n run({ input: context.input as Input, window: context.window, principal: context.principal }),\n }),\n\n /** Streams live entity patches for a client's live requirements. */\n live: <P = unknown, R = never>(\n entity: EntityName,\n options: { readonly subscribe: LiveSource<P, R>['subscribe'] },\n ): LiveSource<P, R> => ({\n entity: entity.name,\n subscribe: options.subscribe,\n }),\n\n /**\n * A `LiveHub` over entity sources. Pass it to `handlers` as `live`, then\n * call `hub.changed(ref, fields)` from wherever the data changes (a mutation\n * source, a database trigger); each subscriber that selects any of those\n * fields receives them, re-read through the entity source under its own\n * principal. It needs only the entity sources, so the mutation sources that\n * signal it can be built after it.\n */\n liveHub,\n\n make: <P = unknown, R = never>(config: {\n readonly entities: readonly EntitySource<P, R>[]\n readonly mutations?: readonly MutationSource<P, R>[]\n readonly queries?: readonly QuerySource<P, R>[]\n readonly live?: readonly LiveSource<P, R>[]\n }): ServerDefinition<P, R> => ({\n entities: new Map(config.entities.map(source => [source.entity, source])),\n mutations: new Map((config.mutations ?? []).map(source => [source.mutation, source])),\n queries: new Map((config.queries ?? []).map(source => [source.query, source])),\n live: new Map((config.live ?? []).map(source => [source.entity, source])),\n }),\n\n /**\n * Checks every source name against the declared domain, so an undeclared\n * entity/query/mutation fails at startup rather than returning nothing at\n * call time.\n */\n validate: (domain: RemoteDescriptor, server: ServerDefinition<any, any>): void => {\n const assertDeclared = (\n kind: string,\n declared: ReadonlyMap<string, unknown>,\n names: Iterable<string>,\n ): void => {\n for (const name of names) {\n if (!declared.has(name))\n throw new Error(`RemoteServer: ${kind} \"${name}\" is not declared in the Remote domain`)\n }\n }\n assertDeclared('entity', domain.registry.entities, server.entities.keys())\n assertDeclared('query', domain.registry.queries, server.queries.keys())\n assertDeclared('mutation', domain.registry.mutations, server.mutations.keys())\n },\n\n /**\n * Compiles the server into the `Read`/`Mutate` RPC handlers. `principal` is\n * resolved outside (authentication middleware in a later phase); unknown\n * entities, entities with no allowed fields, and unknown mutations return an\n * error or nothing rather than leaking existence.\n */\n handlers: <P, R>(\n server: ServerDefinition<P, R>,\n principal: P,\n options: HandlerOptions<P, R> = {},\n ): RemoteRpcClient<R> => ({\n FoldkitRemoteRead: Effect.fn('RemoteServer.FoldkitRemoteRead')(function* (payload) {\n const mismatch = protocolMismatch(payload.version)\n if (mismatch !== undefined) return yield* mismatch\n\n const entities: Array<{\n readonly entity: string\n readonly id: string\n readonly values: Record<string, unknown>\n }> = []\n // What this batch has already read per entity:id (fields and values), so\n // a target several relations share is fetched once, a later spec's nested\n // relation is followed from the values already in hand, and a cyclic\n // selection stays finite.\n const fetched = new Map<string, Set<string>>()\n const fetchedValues = new Map<string, Record<string, unknown>>()\n const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH\n const maxIds = Math.max(1, options.maxIdsPerEntity ?? DEFAULT_MAX_IDS_PER_ENTITY)\n\n // The limit guards the client's batch, whatever windows split it into;\n // a nested level's fan-out is the server's own doing, so it is chunked\n // rather than refused.\n const over = checkIdsPerEntity(payload.requests, maxIds)\n if (over !== undefined) {\n return yield* new RemoteReadError({ message: `Too many \"${over}\" ids in one read batch` })\n }\n const paged = checkPagesPerRelation(payload.requests)\n if (paged !== undefined) {\n return yield* new RemoteReadError({ message: `Too many pages of \"${paged}\" in one read` })\n }\n\n // Level by level: a level's relation refs become the next level's requests.\n let pending: ReadonlyArray<Requirement> = payload.requests\n for (let depth = 0; pending.length > 0; depth++) {\n if (depth > maxDepth) {\n return yield* new RemoteReadError({\n message: `Nested selection deeper than ${maxDepth} relation levels`,\n })\n }\n const next: Requirement[] = []\n\n /**\n * Follows each relation's refs in `values` into the next level, asking\n * only for fields this batch has not read of the target; a target read\n * in full already is followed further from its fetched values.\n */\n const follow = (\n values: Record<string, unknown>,\n relations: Readonly<Record<string, RelationRequirement>>,\n ): void => {\n for (const [field, relation] of Object.entries(relations)) {\n if (!Object.hasOwn(values, field)) continue\n for (const ref of refsIn(values[field])) {\n if (ref.entity !== relation.entity) continue\n const key = `${relation.entity}:${ref.id}`\n const read = fetched.get(key)\n const fields = relation.fields.filter(name => read?.has(name) !== true)\n if (fields.length > 0) {\n next.push({\n entity: relation.entity,\n id: ref.id,\n fields,\n ...(relation.windows === undefined ? {} : { windows: relation.windows }),\n ...(relation.relations === undefined ? {} : { relations: relation.relations }),\n })\n } else if (relation.relations !== undefined) {\n follow(fetchedValues.get(key) ?? {}, relation.relations)\n }\n }\n }\n }\n\n for (const { ids, slice, renames } of groupByEntity(pending)) {\n const name = slice.entity\n const source = server.entities.get(name)\n if (source === undefined) continue\n const allowed = allowedFields(source, principal, slice.fields)\n if (allowed.length === 0) continue\n\n const windows = windowsOf(slice.windows, allowed)\n const idList = [...ids]\n const records: EntityRecord[] = []\n for (let start = 0; start < idList.length; start += maxIds) {\n records.push(\n ...(yield* source\n .read({\n ids: idList.slice(start, start + maxIds),\n fields: allowed,\n principal,\n ...windows,\n })\n .pipe(\n Effect.catchTag('RemoteServerError', error =>\n Effect.fail(new RemoteReadError({ message: error.message })),\n ),\n )),\n )\n }\n\n for (const record of records) {\n // Null-prototype so a crafted field name (`__proto__`) cannot reach\n // the prototype, and `Object.hasOwn` so inherited names are ignored.\n // A field read under an alias is answered, and remembered, under the alias.\n const values: Record<string, unknown> = Object.create(null)\n for (const field of allowed) {\n if (Object.hasOwn(record.values, field))\n values[renames[field] ?? field] = record.values[field]\n }\n entities.push({ entity: name, id: record.id, values })\n\n const key = `${name}:${record.id}`\n const known = fetched.get(key) ?? new Set<string>()\n for (const field of allowed) known.add(renames[field] ?? field)\n fetched.set(key, known)\n fetchedValues.set(key, { ...fetchedValues.get(key), ...values })\n\n // `values` holds only allowed fields, so a relation the principal\n // may not read is never followed.\n follow(values, slice.relations ?? {})\n }\n }\n // A target read by this level (as another group's request) is not\n // read again by the next.\n pending = next.flatMap(request => {\n const read = fetched.get(`${request.entity}:${request.id}`)\n const fields = request.fields.filter(field => read?.has(field) !== true)\n return fields.length === 0 ? [] : [{ ...request, fields }]\n })\n }\n\n return { entities }\n }),\n\n FoldkitRemoteMutate: Effect.fn('RemoteServer.FoldkitRemoteMutate')(function* (payload) {\n const source = server.mutations.get(payload.mutation)\n if (source === undefined) {\n return yield* new RemoteMutationError({\n message: `Unknown mutation: ${payload.mutation}`,\n })\n }\n\n const input = yield* Schema.decodeUnknownEffect(source.Input)(payload.input).pipe(\n Effect.catchTag('SchemaError', () =>\n Effect.fail(new RemoteMutationError({ message: 'Invalid mutation input' })),\n ),\n )\n\n const outcome = yield* source\n .run({ input, principal })\n .pipe(\n Effect.catchTag('RemoteServerError', error =>\n Effect.fail(new RemoteMutationError({ message: error.message })),\n ),\n )\n\n const output = yield* Schema.encodeUnknownEffect(source.Output)(outcome.output).pipe(\n Effect.catchTag('SchemaError', () =>\n Effect.fail(new RemoteMutationError({ message: 'Invalid mutation output' })),\n ),\n )\n\n return {\n output,\n entities: outcome.entities.map(patch => ({\n entity: patch.entity,\n id: patch.id,\n values: patch.values,\n })),\n connections: outcome.connections,\n deleted: outcome.deleted.map(gone => ({ entity: gone.entity, id: gone.id })),\n }\n }),\n\n FoldkitRemoteQuery: Effect.fn('RemoteServer.FoldkitRemoteQuery')(function* (payload) {\n const source = server.queries.get(payload.query)\n if (source === undefined) {\n return yield* new RemoteQueryError({ message: `Unknown query: ${payload.query}` })\n }\n\n const input = yield* Schema.decodeUnknownEffect(source.Input)(payload.input).pipe(\n Effect.catchTag('SchemaError', () =>\n Effect.fail(new RemoteQueryError({ message: 'Invalid query input' })),\n ),\n )\n\n const page = yield* source\n .run({ input, window: payload.window, principal })\n .pipe(\n Effect.catchTag('RemoteServerError', error =>\n Effect.fail(new RemoteQueryError({ message: error.message })),\n ),\n )\n\n return { edges: page.edges, start: page.start, end: page.end }\n }),\n\n FoldkitRemoteLive: payload => {\n const mismatch = protocolMismatch(payload.version)\n if (mismatch !== undefined) return Stream.fail(mismatch)\n const entities = [...new Set(payload.requirements.map(request => request.entity))]\n const streams: Array<Stream.Stream<LiveChangeValue, RemoteServerError, R>> = entities.flatMap(\n entity => {\n const source = server.live.get(entity)\n if (source === undefined) return []\n return [\n source.subscribe({\n requirements: payload.requirements.filter(request => request.entity === entity),\n after: payload.after,\n principal,\n }),\n ]\n },\n )\n if (options.live !== undefined) {\n streams.push(\n options.live.subscribe({\n requirements: payload.requirements,\n after: payload.after,\n principal,\n maxIdsPerEntity: options.maxIdsPerEntity,\n }),\n )\n }\n // An entity with no live source simply contributes nothing; the client's\n // planner refetches it rather than the stream failing.\n return Stream.mergeAll(streams, { concurrency: 'unbounded' }).pipe(\n Stream.mapError(error => new RemoteLiveError({ message: error.message })),\n )\n },\n }),\n}\n\nexport * from './evaluate.js'\n"],"mappings":"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"}
1
+ {"version":3,"file":"index.mjs","names":["evaluate"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `foldkit-remote-server` — server-side Sources and handler compilation.\n *\n * Owns entity/query Sources, **selection authorization**, normalization, and\n * turning them into Effect RPC handlers. It does not own HTTP, serialization, or\n * auth protocol; `principal` is resolved outside and passed in.\n */\nimport { Effect, Layer, Queue, Schema, Stream } from 'effect'\nimport { evaluate, type Row } from 'foldkit-entity'\nimport {\n REMOTE_PROTOCOL_VERSION,\n Remote,\n RemoteClient,\n RemoteLiveError,\n RemoteMutationError,\n RemoteProtocolError,\n RemoteQueryError,\n RemoteReadError,\n connectionIdentity,\n entityKey,\n refsIn,\n stableStringify,\n type Boundary,\n type ConnectionChangeSchema,\n type ConnectionIdentity,\n type LiveChange,\n type MutationDescriptor,\n type NormalizedPatch,\n type QueryDescriptor,\n type QueryWindow,\n type RelationRequirement,\n type RemoteDescriptor,\n Requirement,\n type RemoteRpcClient,\n RELATION_ALIAS,\n aliasedField,\n} from 'foldkit-remote'\n\nexport class RemoteServerError extends Schema.TaggedError<RemoteServerError>()(\n 'RemoteServerError',\n {\n message: Schema.String,\n },\n) {}\n\nexport interface EntityRecord {\n readonly id: string\n readonly values: Readonly<Record<string, unknown>>\n}\n\nexport interface EntitySourceContext<P> {\n readonly ids: readonly string[]\n readonly fields: readonly string[]\n /** A pagination window per requested relation field. */\n readonly windows?: Readonly<Record<string, QueryWindow>> | undefined\n readonly principal: P\n}\n\nexport interface EntitySource<P, R = never> {\n readonly entity: string\n /** The fields the entity declares; a request for any other never reaches `read`. */\n readonly fields?: ReadonlySet<string> | undefined\n readonly read: (\n context: EntitySourceContext<P>,\n ) => Effect.Effect<ReadonlyArray<EntityRecord>, RemoteServerError, R>\n /** Returns the fields this principal may read; omitted means all requested. */\n readonly authorize?: (principal: P, fields: readonly string[]) => readonly string[]\n}\n\n/** A connection change a mutation made, as the wire carries it. */\nexport type ConnectionChange = Schema.Schema.Type<typeof ConnectionChangeSchema>\n\nconst connectionChange = (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n position: 'prepend' | 'append' | 'remove',\n): ConnectionChange => {\n const edge = { entity: ref.entity, id: ref.id, key: entityKey(ref.entity, ref.id) }\n return position === 'remove'\n ? { _tag: 'Remove', connection: connectionIdentity(connection), edge }\n : { _tag: 'Insert', connection: connectionIdentity(connection), position, edge }\n}\n\n/**\n * The requested fields, in request order, that the source declares and the\n * principal may read. Never a field the client did not request, even if a\n * permissive `authorize` returns more.\n */\nconst allowedFields = <P, R>(\n source: EntitySource<P, R>,\n principal: P,\n requested: ReadonlyArray<string>,\n): ReadonlyArray<string> => {\n const declared =\n source.fields === undefined ? requested : requested.filter(field => source.fields!.has(field))\n if (declared.length === 0) return []\n const permitted = new Set(\n source.authorize === undefined ? declared : source.authorize(principal, declared),\n )\n return declared.filter(field => permitted.has(field))\n}\n\n/** The windows of the fields being read; only a field being read carries its window. */\nconst windowsOf = (\n windows: Readonly<Record<string, QueryWindow>> | undefined,\n fields: ReadonlyArray<string>,\n): { readonly windows?: Readonly<Record<string, QueryWindow>> } => {\n if (windows === undefined) return {}\n const kept = Object.fromEntries(\n fields.flatMap(field =>\n Object.hasOwn(windows, field) ? [[field, windows[field]!] as const] : [],\n ),\n )\n return Object.keys(kept).length === 0 ? {} : { windows: kept }\n}\n\nexport interface MutationOutcome<Output> {\n readonly output: Output\n readonly entities?: ReadonlyArray<NormalizedPatch>\n /** Connection changes the mutation made; the client settles them with its patches. */\n readonly connections?: ReadonlyArray<ConnectionChange>\n /**\n * Entities the mutation deleted. The client knows them absent from then on:\n * they leave every connection and read `NotFound`, with no connection to name.\n */\n readonly deleted?: ReadonlyArray<{ readonly entity: string; readonly id: string }>\n}\n\nexport interface MutationSource<P, R = never> {\n readonly mutation: string\n readonly Input: Schema.Codec<unknown>\n readonly Output: Schema.Codec<unknown>\n readonly run: (context: { readonly input: unknown; readonly principal: P }) => Effect.Effect<\n {\n readonly output: unknown\n readonly entities: ReadonlyArray<NormalizedPatch>\n readonly connections: ReadonlyArray<ConnectionChange>\n readonly deleted: ReadonlyArray<{ readonly entity: string; readonly id: string }>\n },\n RemoteServerError,\n R\n >\n}\n\nexport interface QueryPage {\n readonly edges: ReadonlyArray<{\n readonly entity: string\n readonly id: string\n readonly key: string\n }>\n readonly start: Boundary\n readonly end: Boundary\n}\n\nexport interface QuerySource<P, R = never> {\n readonly query: string\n readonly Input: Schema.Codec<unknown>\n readonly run: (context: {\n readonly input: unknown\n readonly window: QueryWindow\n readonly principal: P\n }) => Effect.Effect<QueryPage, RemoteServerError, R>\n}\n\nexport interface LiveSource<P, R = never> {\n readonly entity: string\n readonly subscribe: (context: {\n readonly requirements: ReadonlyArray<Requirement>\n readonly after: number\n readonly principal: P\n }) => Stream.Stream<Schema.Schema.Type<typeof LiveChange>, RemoteServerError, R>\n}\n\nexport interface ServerDefinition<P, R = never> {\n readonly entities: ReadonlyMap<string, EntitySource<P, R>>\n readonly mutations: ReadonlyMap<string, MutationSource<P, R>>\n readonly queries: ReadonlyMap<string, QuerySource<P, R>>\n readonly live: ReadonlyMap<string, LiveSource<P, R>>\n}\n\n/** A read batch may not carry more than this many distinct ids per entity. */\nconst DEFAULT_MAX_IDS_PER_ENTITY = 1000\n\n/** A nested selection may not reach further than this many relation levels. */\nconst DEFAULT_MAX_DEPTH = 8\n\nexport interface HandlerOptions<P, R = never> {\n /** A read or live subscription may not name more ids of one entity than this; default 1000. */\n readonly maxIdsPerEntity?: number | undefined\n /** A nested selection may not reach further than this many relation levels; default 8. */\n readonly maxDepth?: number | undefined\n /** A hub whose `changed`/`deleted` signals reach the subscribers this handler registers. */\n readonly live?: LiveHub<P, R> | undefined\n}\n\n/** Fails when the requirements name more distinct ids of one entity than `maxIds`. */\n/**\n * Each page of a relation read beside another is a source read of its own, and\n * the names come from the client, so how many one relation may have is bounded.\n * A screen shows a list and a page or two of it, not dozens.\n */\nconst MAX_PAGES_PER_RELATION = 4\n\n/** The relation a request pages more ways than allowed, at any depth; `undefined` when none. */\nconst checkPagesPerRelation = (\n requirements: ReadonlyArray<RelationRequirement>,\n): string | undefined => {\n for (const requirement of requirements) {\n const pages = new Map<string, number>()\n for (const name of requirement.fields) {\n if (!name.includes(RELATION_ALIAS)) continue\n const field = aliasedField(name)\n const count = (pages.get(field) ?? 0) + 1\n if (count > MAX_PAGES_PER_RELATION) return `${requirement.entity}.${field}`\n pages.set(field, count)\n }\n const nested = checkPagesPerRelation(Object.values(requirement.relations ?? {}))\n if (nested !== undefined) return nested\n }\n return undefined\n}\n\nconst checkIdsPerEntity = (\n requirements: ReadonlyArray<Requirement>,\n maxIds: number,\n): string | undefined => {\n const ids = new Map<string, Set<string>>()\n for (const requirement of requirements) {\n const seen = ids.get(requirement.entity) ?? new Set<string>()\n seen.add(requirement.id)\n ids.set(requirement.entity, seen)\n if (seen.size > maxIds) return requirement.entity\n }\n return undefined\n}\n\ntype LiveChangeValue = Schema.Schema.Type<typeof LiveChange>\ntype Uncursored<T> = T extends unknown ? Omit<T, 'cursor'> : never\n\ninterface LiveRef {\n readonly entity: string\n readonly id: string\n}\n\n/**\n * The server-side \"these fields changed\" signal. A hub tracks each live\n * subscriber's requirements (entity, id, fields) and principal; `changed`\n * re-reads the changed fields a subscriber selects through the entity's own\n * source, under that subscriber's principal, and streams the patch to it.\n * Subscribers that select none of the changed fields do no work. Cursors\n * continue from the cursor each subscriber resumed at, so the client's\n * duplicate and gap handling is unchanged.\n */\nexport interface LiveHub<P, R = never> {\n readonly changed: (\n ref: LiveRef,\n fields: ReadonlyArray<string>,\n ) => Effect.Effect<void, RemoteServerError, R>\n readonly deleted: (ref: LiveRef) => Effect.Effect<void>\n /** Registers a subscriber for the stream's lifetime; `handlers` calls this. */\n readonly subscribe: (context: {\n readonly requirements: ReadonlyArray<Requirement>\n readonly after: number\n readonly principal: P\n /** Refuses a subscription naming more ids of one entity than this. */\n readonly maxIdsPerEntity?: number | undefined\n }) => Stream.Stream<LiveChangeValue, RemoteServerError>\n /** How many subscribers are registered now. */\n readonly size: Effect.Effect<number>\n}\n\ninterface Selected {\n readonly fields: Set<string>\n /** The window each paged field was subscribed with, so a re-read pages the same way. */\n readonly windows: Map<string, QueryWindow>\n}\n\n/** The subscribers one source read answers, and the fields each wants of it. */\ninterface ReadGroup<P> {\n readonly windows: Readonly<Record<string, QueryWindow>>\n /** The alias each field read here is answered under. */\n readonly renames: Readonly<Record<string, string>>\n readonly entries: Array<{ readonly subscriber: Subscriber<P>; readonly fields: string[] }>\n}\n\ninterface Subscriber<P> {\n /** Per entity:id, the fields (and their windows) this subscriber selects. */\n readonly selected: ReadonlyMap<string, Selected>\n readonly principal: P\n readonly queue: Queue.Queue<LiveChangeValue>\n cursor: number\n}\n\nconst liveHub = <P, R>(entities: ReadonlyArray<EntitySource<P, R>>): Effect.Effect<LiveHub<P, R>> =>\n Effect.sync(() => {\n const sources = new Map(entities.map(source => [source.entity, source]))\n const subscribers = new Set<Subscriber<P>>()\n const emit = (subscriber: Subscriber<P>, change: Uncursored<LiveChangeValue>) => {\n subscriber.cursor += 1\n return Queue.offer(subscriber.queue, {\n ...change,\n cursor: subscriber.cursor,\n } as LiveChangeValue)\n }\n\n return {\n subscribe: ({ requirements, after, principal, maxIdsPerEntity }) =>\n Stream.unwrap(\n Effect.gen(function* () {\n const over = checkIdsPerEntity(\n requirements,\n Math.max(1, maxIdsPerEntity ?? DEFAULT_MAX_IDS_PER_ENTITY),\n )\n if (over !== undefined) {\n return yield* new RemoteServerError({\n message: `Too many \"${over}\" ids in one live subscription`,\n })\n }\n const paged = checkPagesPerRelation(requirements)\n if (paged !== undefined) {\n return yield* new RemoteServerError({\n message: `Too many pages of \"${paged}\" in one live subscription`,\n })\n }\n const selected = new Map<string, Selected>()\n for (const requirement of requirements) {\n const key = `${requirement.entity}:${requirement.id}`\n const entry = selected.get(key) ?? { fields: new Set<string>(), windows: new Map() }\n for (const field of requirement.fields) entry.fields.add(field)\n for (const [field, window] of Object.entries(requirement.windows ?? {})) {\n entry.windows.set(field, window)\n }\n selected.set(key, entry)\n }\n const subscriber: Subscriber<P> = {\n selected,\n principal,\n queue: yield* Queue.unbounded<LiveChangeValue>(),\n cursor: after,\n }\n subscribers.add(subscriber)\n return Stream.fromQueue(subscriber.queue).pipe(\n Stream.ensuring(Effect.sync(() => void subscribers.delete(subscriber))),\n )\n }),\n ),\n\n changed: (ref, fields) =>\n Effect.gen(function* () {\n const key = `${ref.entity}:${ref.id}`\n const source = sources.get(ref.entity)\n if (source === undefined) return\n // One source read per principal (by identity) and window signature:\n // subscribers sharing both share the read, and a paged field is\n // re-read with the window the subscriber selected it with.\n const groups = new Map<P, Map<string, ReadGroup<P>>>()\n for (const subscriber of subscribers) {\n const selected = subscriber.selected.get(key)\n if (selected === undefined) continue\n const byWindows = groups.get(subscriber.principal) ?? new Map<string, ReadGroup<P>>()\n groups.set(subscriber.principal, byWindows)\n const join = (\n windows: Readonly<Record<string, QueryWindow>>,\n renames: Readonly<Record<string, string>>,\n wanted: string[],\n ): void => {\n const groupKey = `${stableStringify(windows)}\\u0000${stableStringify(renames)}`\n const group = byWindows.get(groupKey) ?? { windows, renames, entries: [] }\n byWindows.set(groupKey, group)\n group.entries.push({ subscriber, fields: wanted })\n }\n const wanted = fields.filter(field => selected.fields.has(field))\n if (wanted.length > 0)\n join(\n Object.fromEntries(\n wanted.flatMap(field => {\n const window = selected.windows.get(field)\n return window === undefined ? [] : [[field, window] as const]\n }),\n ),\n {},\n wanted,\n )\n // A page read under an alias changes when the relation it reads does, and\n // is re-read on its own, with its window, so the whole list can be too.\n for (const alias of selected.fields) {\n const window = selected.windows.get(alias)\n const field = aliasedField(alias)\n if (field === alias || window === undefined || !fields.includes(field)) continue\n join({ [field]: window }, { [field]: alias }, [field])\n }\n }\n for (const [principal, byWindows] of groups) {\n for (const { windows, renames, entries: group } of byWindows.values()) {\n const requested = [...new Set(group.flatMap(entry => entry.fields))]\n const allowed = allowedFields(source, principal, requested)\n if (allowed.length === 0) continue\n const allowedSet = new Set(allowed)\n const records = yield* source.read({\n ids: [ref.id],\n fields: allowed,\n principal,\n ...windowsOf(windows, allowed),\n })\n const record = records.find(candidate => candidate.id === ref.id)\n if (record === undefined) continue\n for (const { subscriber, fields: wanted } of group) {\n const values: Record<string, unknown> = Object.create(null)\n for (const field of wanted) {\n if (allowedSet.has(field) && Object.hasOwn(record.values, field)) {\n values[renames[field] ?? field] = record.values[field]\n }\n }\n const changed = Object.keys(values)\n if (changed.length === 0) continue\n yield* emit(subscriber, {\n _tag: 'EntityPatched',\n entity: ref.entity,\n id: ref.id,\n values,\n changed,\n })\n }\n }\n }\n }),\n\n deleted: ref =>\n Effect.gen(function* () {\n const key = `${ref.entity}:${ref.id}`\n for (const subscriber of subscribers) {\n if (!subscriber.selected.has(key)) continue\n yield* emit(subscriber, { _tag: 'EntityDeleted', entity: ref.entity, id: ref.id })\n }\n }),\n\n size: Effect.sync(() => subscribers.size),\n }\n })\n\nconst protocolMismatch = (received: number): RemoteProtocolError | undefined =>\n received === REMOTE_PROTOCOL_VERSION\n ? undefined\n : new RemoteProtocolError({\n message: `Remote protocol version ${received} is not ${REMOTE_PROTOCOL_VERSION}`,\n expected: REMOTE_PROTOCOL_VERSION,\n received,\n })\n\ninterface EntityGroup {\n readonly ids: Set<string>\n /** The union of the requests' fields, windows, and relations. */\n slice: RelationRequirement\n /** The alias each field read here is answered under; see `RELATION_ALIAS`. */\n readonly renames: Readonly<Record<string, string>>\n}\n\n/** A request, or the part of one that reads a relation under an alias. */\ntype Part = Requirement & { readonly renames?: Readonly<Record<string, string>> }\n\nconst pickNames = <T>(\n record: Readonly<Record<string, T>> | undefined,\n names: ReadonlyArray<string>,\n): Readonly<Record<string, T>> | undefined => {\n if (record === undefined) return undefined\n const picked = names.flatMap(name =>\n Object.hasOwn(record, name) ? [[name, record[name]!] as const] : [],\n )\n return picked.length === 0 ? undefined : Object.fromEntries(picked)\n}\n\n/**\n * A request's aliased fields, each as a read of its own. `comments@first=10` is\n * the `comments` relation read with the alias's window, so a source sees the\n * field it knows and one window for it, while the whole list rides beside it in\n * another read. The answer goes back under the alias, which is also the key of\n * the relation followed from it.\n */\nconst splitAliases = (request: Requirement): ReadonlyArray<Part> => {\n const aliases = request.fields.filter(field => field.includes(RELATION_ALIAS))\n if (aliases.length === 0) return [request]\n const plain = request.fields.filter(field => !field.includes(RELATION_ALIAS))\n interface Building {\n fields: string[]\n windows: Record<string, QueryWindow>\n relations: Record<string, RelationRequirement>\n renames: Record<string, string>\n }\n const first: Building = {\n fields: [...plain],\n windows: { ...pickNames(request.windows, plain) },\n relations: { ...pickNames(request.relations, plain) },\n renames: {},\n }\n const building: Building[] = [first]\n for (const alias of aliases) {\n const window = request.windows?.[alias]\n // An alias is a page: one that names no window asks for nothing.\n if (window === undefined) continue\n const field = aliasedField(alias)\n // It rides in a read that does not already read its relation, so a request\n // costs one read unless the list and a page of it are both wanted.\n let part = building.find(candidate => !candidate.fields.includes(field))\n if (part === undefined) {\n part = { fields: [], windows: {}, relations: {}, renames: {} }\n building.push(part)\n }\n part.fields.push(field)\n part.windows[field] = window\n part.renames[field] = alias\n const relation = request.relations?.[alias]\n if (relation !== undefined) part.relations[alias] = relation\n }\n return building\n .filter(part => part.fields.length > 0)\n .map(part => ({\n entity: request.entity,\n id: request.id,\n fields: part.fields,\n ...(Object.keys(part.windows).length === 0 ? {} : { windows: part.windows }),\n ...(Object.keys(part.relations).length === 0 ? {} : { relations: part.relations }),\n ...(Object.keys(part.renames).length === 0 ? {} : { renames: part.renames }),\n }))\n}\n\n/**\n * One level's requests grouped per entity and window signature: ids and\n * slices unioned. Requests that page a relation differently are separate\n * groups, so one window never answers for another id.\n */\nconst groupByEntity = (requests: ReadonlyArray<Requirement>): EntityGroup[] => {\n const grouped = new Map<string, EntityGroup>()\n for (const request of requests.flatMap(splitAliases)) {\n const renames = request.renames ?? {}\n const groupKey = `${request.entity}\\u0000${stableStringify(request.windows ?? null)}\\u0000${stableStringify(renames)}`\n const group = grouped.get(groupKey)\n if (group === undefined) {\n grouped.set(groupKey, {\n ids: new Set([request.id]),\n slice: Requirement.mergeRelation({ entity: request.entity, fields: [] }, request),\n renames,\n })\n } else {\n group.ids.add(request.id)\n group.slice = Requirement.mergeRelation(group.slice, request)\n }\n }\n return [...grouped.values()]\n}\n\n/** A descriptor's name and, when it declares them, its fields. */\ninterface EntityName {\n readonly name: string\n readonly fields?: Readonly<Record<string, unknown>> | undefined\n}\n\n/** One entity's rows in their wire shape: a relation is its ref key, `'User:u1'`. */\nexport type MemoryRows = Readonly<\n Record<string, ReadonlyArray<Readonly<Record<string, unknown>> & { readonly id: string }>>\n>\n\n/**\n * The rows a memory backend holds, which its mutations write through. A\n * change is what the next read sees; nothing is pushed to a client.\n */\nexport interface MemoryStore {\n /** The rows of one entity, in insertion order. */\n readonly rows: (entity: string) => ReadonlyArray<Readonly<Record<string, unknown>>>\n /** Writes these values onto a row, creating it if it is new. */\n readonly write: (entity: string, id: string, values: Readonly<Record<string, unknown>>) => void\n readonly remove: (entity: string, id: string) => void\n}\n\nexport interface MemoryBackend extends MemoryStore {\n /** A `RemoteClient` answering from the rows. Provide it where the real one would go. */\n readonly layer: Layer.Layer<RemoteClient>\n}\n\n/** Where a cursor falls among ordered items: before `index`, or at it when `exact`. */\ninterface Position {\n readonly index: number\n readonly exact: boolean\n}\n\n/**\n * One page of ordered items for a window, as a real server pages them. A\n * cursor is an item's id: a forward page starts at the `after` it was asked\n * for and ends at its last item while more follow, a backward page the\n * mirror, so a page fetched from another's end cursor joins it.\n *\n * `locate` places a cursor that is not among the items, as a keyset does: a\n * row that stopped matching still has a place in the order. Without it, such\n * a cursor is an error. A page of no items has no id of its own to end at, so\n * with more beyond it and no cursor to repeat, its boundary is `Unknown`.\n */\nconst pageOf = <Item>(\n items: ReadonlyArray<Item>,\n window: QueryWindow,\n idOf: (item: Item) => string,\n locate?: (cursor: string) => Position,\n): { readonly items: ReadonlyArray<Item>; readonly start: Boundary; readonly end: Boundary } => {\n if (\n (window.after !== undefined && window.before !== undefined) ||\n (window.first !== undefined && window.last !== undefined)\n ) {\n throw new Error('A query window cannot combine after with before, or first with last')\n }\n const position = (cursor: string): Position => {\n const index = items.findIndex(item => idOf(item) === cursor)\n if (index >= 0) return { index, exact: true }\n if (locate !== undefined) return locate(cursor)\n throw new Error(`Cursor \"${cursor}\" names nothing in these results`)\n }\n const cursor = (id: string): Boundary => ({ _tag: 'Cursor', cursor: id })\n const terminal: Boundary = { _tag: 'Terminal' }\n const unknown: Boundary = { _tag: 'Unknown' }\n if (window.last !== undefined || window.before !== undefined) {\n const to = window.before === undefined ? items.length : position(window.before).index\n const from = window.last === undefined ? 0 : Math.max(0, to - window.last)\n const page = items.slice(from, to)\n const start =\n from === 0\n ? terminal\n : page.length > 0\n ? cursor(idOf(page[0]!))\n : window.before === undefined\n ? unknown\n : cursor(window.before)\n return {\n items: page,\n start,\n end: window.before === undefined ? terminal : cursor(window.before),\n }\n }\n const at = window.after === undefined ? undefined : position(window.after)\n const from = at === undefined ? 0 : at.exact ? at.index + 1 : at.index\n const to = window.first === undefined ? items.length : Math.min(items.length, from + window.first)\n const page = items.slice(from, to)\n const end =\n to >= items.length\n ? terminal\n : page.length > 0\n ? cursor(idOf(page.at(-1)!))\n : window.after === undefined\n ? unknown\n : cursor(window.after)\n return { items: page, start: window.after === undefined ? terminal : cursor(window.after), end }\n}\n\n/**\n * A backend held in memory: the rows you give it, served through the same\n * handlers a real server uses. For a first run, a test, a story or a demo, with\n * no database and no network.\n *\n * Reads go through `handlers`, so field filtering and nested relations behave\n * as they do in production. A query declared with `Query.define` is answered\n * by running its body over the rows with the reference interpreter, the one\n * every interpreter is held to by the conformance suite. A query with no body\n * has nothing to run and is refused when the backend is made, unless `queries`\n * supplies a source for it. Mutations are yours to give: each one writes\n * through the store it is handed, and the next read sees the change.\n *\n * It does not push live changes, and it authorizes nothing: every field of\n * every row is readable. It is not a server to deploy.\n */\nconst memory = (config: {\n readonly domain: Pick<RemoteDescriptor, 'registry'>\n readonly rows: MemoryRows\n readonly queries?: ReadonlyArray<QuerySource<undefined>>\n readonly mutations?: (store: MemoryStore) => ReadonlyArray<MutationSource<undefined>>\n}): MemoryBackend => {\n const tables = new Map<string, Map<string, Record<string, unknown>>>()\n const table = (entity: string) => {\n const existing = tables.get(entity)\n if (existing !== undefined) return existing\n const created = new Map<string, Record<string, unknown>>()\n tables.set(entity, created)\n return created\n }\n for (const [entity, rows] of Object.entries(config.rows)) {\n // Keyed by the id as the wire carries it, a string, whatever JSON gave.\n for (const row of rows) table(entity).set(String(row.id), { ...row })\n }\n const store: MemoryStore = {\n rows: entity => [...table(entity).values()],\n write: (entity, id, values) => {\n table(entity).set(id, { ...table(entity).get(id), id, ...values })\n },\n remove: (entity, id) => {\n table(entity).delete(id)\n },\n }\n\n // A relation page is the refs in a window of the stored list. Its cursor is a\n // ref key, or a bare id, as a real server accepts either.\n const valueFor = (value: unknown, window: QueryWindow | undefined): unknown => {\n if (window === undefined || !Array.isArray(value)) return value\n // A ref listed twice would make a cursor ambiguous, and paging cycle.\n const refs = [...new Set(value as ReadonlyArray<string>)]\n const idOf = (ref: string) => ref.slice(ref.indexOf(':') + 1)\n const named = (cursor: string | undefined) =>\n cursor === undefined ? undefined : cursor.includes(':') ? idOf(cursor) : cursor\n let page: ReturnType<typeof pageOf<string>>\n try {\n page = pageOf(\n refs,\n { ...window, after: named(window.after), before: named(window.before) },\n idOf,\n )\n } catch {\n // A cursor that names nothing in the list answers this one field with an\n // empty page. Failing would fail the whole batch it rode in, every other\n // entity and field with it.\n return { refs: [], hasNext: false, hasPrevious: false }\n }\n // A cursor at either end is exactly \"more lie that way\".\n return {\n refs: page.items,\n hasNext: page.end._tag === 'Cursor',\n hasPrevious: page.start._tag === 'Cursor',\n }\n }\n\n const entities = [...config.domain.registry.entities.keys()].map(name =>\n RemoteServer.entity<undefined>(\n { name },\n {\n read: ({ ids, fields, windows }) =>\n Effect.try({\n try: () =>\n ids.flatMap(id => {\n const row = table(name).get(id)\n if (row === undefined) return []\n const values = Object.fromEntries(\n fields.flatMap(field =>\n field in row ? [[field, valueFor(row[field], windows?.[field])] as const] : [],\n ),\n )\n return [{ id, values }]\n }),\n catch: error =>\n new RemoteServerError({\n message: error instanceof Error ? error.message : String(error),\n }),\n }),\n },\n ),\n )\n\n const given = new Set((config.queries ?? []).map(source => source.query))\n const bodiless = [...config.domain.registry.queries.values()].filter(\n query => query.body === undefined && !given.has(query.name),\n )\n if (bodiless.length > 0) {\n throw new Error(\n `RemoteServer.memory: ${bodiless.map(query => `\"${query.name}\"`).join(', ')} ${bodiless.length === 1 ? 'has' : 'have'} no body to run. Declare ${bodiless.length === 1 ? 'it' : 'them'} with Query.define, or give a source in \\`queries\\`.`,\n )\n }\n const queries = [\n ...(config.queries ?? []),\n ...[...config.domain.registry.queries.values()]\n .filter(query => !given.has(query.name))\n .map(query =>\n RemoteServer.query<undefined>(query, ({ input, window }) =>\n Effect.try({\n try: () => {\n const body = query.body!\n const encoded = Schema.encodeSync(query.Input)(input) as Readonly<\n Record<string, unknown>\n >\n const entity = body.entity.name\n const rows = store.rows(entity) as ReadonlyArray<Row>\n const matched = evaluate(body, encoded, rows)\n // A cursor row that no longer matches still has a place in the\n // order, as a keyset has it: sort it among the matches with the\n // predicates set aside. One that no longer exists has none.\n const locate = (cursor: string) => {\n const row = rows.find(candidate => String(candidate.id) === cursor)\n if (row === undefined) {\n throw new Error(`Cursor \"${cursor}\" names a row that no longer exists`)\n }\n const placed = evaluate({ ...body, where: [] } as typeof body, encoded, [\n ...matched,\n row,\n ])\n return { index: placed.indexOf(row), exact: false }\n }\n const page = pageOf(matched, window, row => String(row.id), locate)\n return {\n edges: page.items.map(row => {\n const id = String(row.id)\n return { entity, id, key: entityKey(entity, id) }\n }),\n start: page.start,\n end: page.end,\n }\n },\n catch: error =>\n new RemoteServerError({\n message: error instanceof Error ? error.message : String(error),\n }),\n }),\n ),\n ),\n ]\n\n const server = RemoteServer.make<undefined>({\n entities,\n queries,\n mutations: config.mutations?.(store) ?? [],\n })\n return {\n ...store,\n layer: Remote.clientLayer(\n RemoteServer.handlers(server, undefined),\n ) as Layer.Layer<RemoteClient>,\n }\n}\n\nexport const RemoteServer = {\n /** A backend held in memory, for a first run, a test or a demo. See `memory`. */\n memory,\n\n /** A mutation outcome's report that `ref` now heads the connection. */\n prepend: (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n ): ConnectionChange => connectionChange(connection, ref, 'prepend'),\n\n /** A mutation outcome's report that `ref` now ends the connection. */\n append: (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n ): ConnectionChange => connectionChange(connection, ref, 'append'),\n\n /** A mutation outcome's report that `ref` left the connection. */\n remove: (\n connection: ConnectionIdentity,\n ref: { readonly entity: string; readonly id: string },\n ): ConnectionChange => connectionChange(connection, ref, 'remove'),\n\n /**\n * An entity source. Given the Entity (or anything with its `name` and\n * `fields`), a request for a field the entity does not declare never\n * reaches `read` or `authorize`.\n */\n entity: <P = unknown, R = never>(\n entity: EntityName,\n options: {\n readonly read: EntitySource<P, R>['read']\n readonly authorize?: EntitySource<P, R>['authorize']\n },\n ): EntitySource<P, R> => ({\n entity: entity.name,\n ...(entity.fields === undefined ? {} : { fields: new Set(Object.keys(entity.fields)) }),\n read: options.read,\n ...(options.authorize === undefined ? {} : { authorize: options.authorize }),\n }),\n\n mutation: <\n P = unknown,\n R = never,\n Name extends string = string,\n Input = unknown,\n Output = unknown,\n >(\n mutation: MutationDescriptor<Name, Input, Output>,\n run: (context: {\n readonly input: Input\n readonly principal: P\n }) => Effect.Effect<MutationOutcome<Output>, RemoteServerError, R>,\n ): MutationSource<P, R> => ({\n mutation: mutation.name,\n Input: mutation.Input,\n Output: mutation.Output,\n run: context =>\n run({ input: context.input as Input, principal: context.principal }).pipe(\n Effect.map(outcome => ({\n output: outcome.output,\n entities: outcome.entities ?? [],\n connections: outcome.connections ?? [],\n deleted: outcome.deleted ?? [],\n })),\n ),\n }),\n\n query: <P = unknown, R = never, Input = unknown>(\n query: QueryDescriptor<string, Input, unknown>,\n run: (context: {\n readonly input: Input\n readonly window: QueryWindow\n readonly principal: P\n }) => Effect.Effect<QueryPage, RemoteServerError, R>,\n ): QuerySource<P, R> => ({\n query: query.name,\n Input: query.Input,\n run: context =>\n run({ input: context.input as Input, window: context.window, principal: context.principal }),\n }),\n\n /** Streams live entity patches for a client's live requirements. */\n live: <P = unknown, R = never>(\n entity: EntityName,\n options: { readonly subscribe: LiveSource<P, R>['subscribe'] },\n ): LiveSource<P, R> => ({\n entity: entity.name,\n subscribe: options.subscribe,\n }),\n\n /**\n * A `LiveHub` over entity sources. Pass it to `handlers` as `live`, then\n * call `hub.changed(ref, fields)` from wherever the data changes (a mutation\n * source, a database trigger); each subscriber that selects any of those\n * fields receives them, re-read through the entity source under its own\n * principal. It needs only the entity sources, so the mutation sources that\n * signal it can be built after it.\n */\n liveHub,\n\n make: <P = unknown, R = never>(config: {\n readonly entities: readonly EntitySource<P, R>[]\n readonly mutations?: readonly MutationSource<P, R>[]\n readonly queries?: readonly QuerySource<P, R>[]\n readonly live?: readonly LiveSource<P, R>[]\n }): ServerDefinition<P, R> => ({\n entities: new Map(config.entities.map(source => [source.entity, source])),\n mutations: new Map((config.mutations ?? []).map(source => [source.mutation, source])),\n queries: new Map((config.queries ?? []).map(source => [source.query, source])),\n live: new Map((config.live ?? []).map(source => [source.entity, source])),\n }),\n\n /**\n * Checks every source name against the declared domain, so an undeclared\n * entity/query/mutation fails at startup rather than returning nothing at\n * call time.\n */\n validate: (domain: RemoteDescriptor, server: ServerDefinition<any, any>): void => {\n const assertDeclared = (\n kind: string,\n declared: ReadonlyMap<string, unknown>,\n names: Iterable<string>,\n ): void => {\n for (const name of names) {\n if (!declared.has(name))\n throw new Error(`RemoteServer: ${kind} \"${name}\" is not declared in the Remote domain`)\n }\n }\n assertDeclared('entity', domain.registry.entities, server.entities.keys())\n assertDeclared('query', domain.registry.queries, server.queries.keys())\n assertDeclared('mutation', domain.registry.mutations, server.mutations.keys())\n },\n\n /**\n * Compiles the server into the `Read`/`Mutate` RPC handlers. `principal` is\n * resolved outside (authentication middleware in a later phase); unknown\n * entities, entities with no allowed fields, and unknown mutations return an\n * error or nothing rather than leaking existence.\n */\n handlers: <P, R>(\n server: ServerDefinition<P, R>,\n principal: P,\n options: HandlerOptions<P, R> = {},\n ): RemoteRpcClient<R> => ({\n FoldkitRemoteRead: Effect.fn('RemoteServer.FoldkitRemoteRead')(function* (payload) {\n const mismatch = protocolMismatch(payload.version)\n if (mismatch !== undefined) return yield* mismatch\n\n const entities: Array<{\n readonly entity: string\n readonly id: string\n readonly values: Record<string, unknown>\n }> = []\n // What this batch has already read per entity:id (fields and values), so\n // a target several relations share is fetched once, a later spec's nested\n // relation is followed from the values already in hand, and a cyclic\n // selection stays finite.\n const fetched = new Map<string, Set<string>>()\n const fetchedValues = new Map<string, Record<string, unknown>>()\n const maxDepth = options.maxDepth ?? DEFAULT_MAX_DEPTH\n const maxIds = Math.max(1, options.maxIdsPerEntity ?? DEFAULT_MAX_IDS_PER_ENTITY)\n\n // The limit guards the client's batch, whatever windows split it into;\n // a nested level's fan-out is the server's own doing, so it is chunked\n // rather than refused.\n const over = checkIdsPerEntity(payload.requests, maxIds)\n if (over !== undefined) {\n return yield* new RemoteReadError({ message: `Too many \"${over}\" ids in one read batch` })\n }\n const paged = checkPagesPerRelation(payload.requests)\n if (paged !== undefined) {\n return yield* new RemoteReadError({ message: `Too many pages of \"${paged}\" in one read` })\n }\n\n // Level by level: a level's relation refs become the next level's requests.\n let pending: ReadonlyArray<Requirement> = payload.requests\n for (let depth = 0; pending.length > 0; depth++) {\n if (depth > maxDepth) {\n return yield* new RemoteReadError({\n message: `Nested selection deeper than ${maxDepth} relation levels`,\n })\n }\n const next: Requirement[] = []\n\n /**\n * Follows each relation's refs in `values` into the next level, asking\n * only for fields this batch has not read of the target; a target read\n * in full already is followed further from its fetched values.\n */\n const follow = (\n values: Record<string, unknown>,\n relations: Readonly<Record<string, RelationRequirement>>,\n ): void => {\n for (const [field, relation] of Object.entries(relations)) {\n if (!Object.hasOwn(values, field)) continue\n for (const ref of refsIn(values[field])) {\n if (ref.entity !== relation.entity) continue\n const key = `${relation.entity}:${ref.id}`\n const read = fetched.get(key)\n const fields = relation.fields.filter(name => read?.has(name) !== true)\n if (fields.length > 0) {\n next.push({\n entity: relation.entity,\n id: ref.id,\n fields,\n ...(relation.windows === undefined ? {} : { windows: relation.windows }),\n ...(relation.relations === undefined ? {} : { relations: relation.relations }),\n })\n } else if (relation.relations !== undefined) {\n follow(fetchedValues.get(key) ?? {}, relation.relations)\n }\n }\n }\n }\n\n for (const { ids, slice, renames } of groupByEntity(pending)) {\n const name = slice.entity\n const source = server.entities.get(name)\n if (source === undefined) continue\n const allowed = allowedFields(source, principal, slice.fields)\n if (allowed.length === 0) continue\n\n const windows = windowsOf(slice.windows, allowed)\n const idList = [...ids]\n const records: EntityRecord[] = []\n for (let start = 0; start < idList.length; start += maxIds) {\n records.push(\n ...(yield* source\n .read({\n ids: idList.slice(start, start + maxIds),\n fields: allowed,\n principal,\n ...windows,\n })\n .pipe(\n Effect.catchTag('RemoteServerError', error =>\n Effect.fail(new RemoteReadError({ message: error.message })),\n ),\n )),\n )\n }\n\n for (const record of records) {\n // Null-prototype so a crafted field name (`__proto__`) cannot reach\n // the prototype, and `Object.hasOwn` so inherited names are ignored.\n // A field read under an alias is answered, and remembered, under the alias.\n const values: Record<string, unknown> = Object.create(null)\n for (const field of allowed) {\n if (Object.hasOwn(record.values, field))\n values[renames[field] ?? field] = record.values[field]\n }\n entities.push({ entity: name, id: record.id, values })\n\n const key = `${name}:${record.id}`\n const known = fetched.get(key) ?? new Set<string>()\n for (const field of allowed) known.add(renames[field] ?? field)\n fetched.set(key, known)\n fetchedValues.set(key, { ...fetchedValues.get(key), ...values })\n\n // `values` holds only allowed fields, so a relation the principal\n // may not read is never followed.\n follow(values, slice.relations ?? {})\n }\n }\n // A target read by this level (as another group's request) is not\n // read again by the next.\n pending = next.flatMap(request => {\n const read = fetched.get(`${request.entity}:${request.id}`)\n const fields = request.fields.filter(field => read?.has(field) !== true)\n return fields.length === 0 ? [] : [{ ...request, fields }]\n })\n }\n\n return { entities }\n }),\n\n FoldkitRemoteMutate: Effect.fn('RemoteServer.FoldkitRemoteMutate')(function* (payload) {\n const source = server.mutations.get(payload.mutation)\n if (source === undefined) {\n return yield* new RemoteMutationError({\n message: `Unknown mutation: ${payload.mutation}`,\n })\n }\n\n const input = yield* Schema.decodeUnknownEffect(source.Input)(payload.input).pipe(\n Effect.catchTag('SchemaError', () =>\n Effect.fail(new RemoteMutationError({ message: 'Invalid mutation input' })),\n ),\n )\n\n const outcome = yield* source\n .run({ input, principal })\n .pipe(\n Effect.catchTag('RemoteServerError', error =>\n Effect.fail(new RemoteMutationError({ message: error.message })),\n ),\n )\n\n const output = yield* Schema.encodeUnknownEffect(source.Output)(outcome.output).pipe(\n Effect.catchTag('SchemaError', () =>\n Effect.fail(new RemoteMutationError({ message: 'Invalid mutation output' })),\n ),\n )\n\n return {\n output,\n entities: outcome.entities.map(patch => ({\n entity: patch.entity,\n id: patch.id,\n values: patch.values,\n })),\n connections: outcome.connections,\n deleted: outcome.deleted.map(gone => ({ entity: gone.entity, id: gone.id })),\n }\n }),\n\n FoldkitRemoteQuery: Effect.fn('RemoteServer.FoldkitRemoteQuery')(function* (payload) {\n const source = server.queries.get(payload.query)\n if (source === undefined) {\n return yield* new RemoteQueryError({ message: `Unknown query: ${payload.query}` })\n }\n\n const input = yield* Schema.decodeUnknownEffect(source.Input)(payload.input).pipe(\n Effect.catchTag('SchemaError', () =>\n Effect.fail(new RemoteQueryError({ message: 'Invalid query input' })),\n ),\n )\n\n const page = yield* source\n .run({ input, window: payload.window, principal })\n .pipe(\n Effect.catchTag('RemoteServerError', error =>\n Effect.fail(new RemoteQueryError({ message: error.message })),\n ),\n )\n\n return { edges: page.edges, start: page.start, end: page.end }\n }),\n\n FoldkitRemoteLive: payload => {\n const mismatch = protocolMismatch(payload.version)\n if (mismatch !== undefined) return Stream.fail(mismatch)\n const entities = [...new Set(payload.requirements.map(request => request.entity))]\n const streams: Array<Stream.Stream<LiveChangeValue, RemoteServerError, R>> = entities.flatMap(\n entity => {\n const source = server.live.get(entity)\n if (source === undefined) return []\n return [\n source.subscribe({\n requirements: payload.requirements.filter(request => request.entity === entity),\n after: payload.after,\n principal,\n }),\n ]\n },\n )\n if (options.live !== undefined) {\n streams.push(\n options.live.subscribe({\n requirements: payload.requirements,\n after: payload.after,\n principal,\n maxIdsPerEntity: options.maxIdsPerEntity,\n }),\n )\n }\n // An entity with no live source simply contributes nothing; the client's\n // planner refetches it rather than the stream failing.\n return Stream.mergeAll(streams, { concurrency: 'unbounded' }).pipe(\n Stream.mapError(error => new RemoteLiveError({ message: error.message })),\n )\n },\n }),\n}\n\nexport * from './evaluate.js'\n"],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldkit-remote-server",
3
- "version": "0.5.0",
3
+ "version": "0.7.0",
4
4
  "description": "Server sources and handler compilation for foldkit-remote: entities, selection authorization, and normalization.",
5
5
  "keywords": [
6
6
  "foldkit",
@@ -38,8 +38,8 @@
38
38
  "LICENSE"
39
39
  ],
40
40
  "dependencies": {
41
- "foldkit-remote": "0.5.0",
42
- "foldkit-entity": "0.2.0"
41
+ "foldkit-entity": "0.3.0",
42
+ "foldkit-remote": "0.7.0"
43
43
  },
44
44
  "peerDependencies": {
45
45
  "effect": "^4.0.0-rc.112"