foldkit-remote-server 0.4.0 → 0.5.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
@@ -289,6 +289,40 @@ Query input is decoded through the Query's own Schema before your callback runs.
289
289
  The callback receives the decoded input, the requested `QueryWindow`, and the
290
290
  principal.
291
291
 
292
+ ### Running a query body over rows you already hold
293
+
294
+ A descriptor declared with
295
+ [`Query.define`](../remote#queries-and-pagination) carries its meaning as a
296
+ value, and `evaluate` runs that value directly:
297
+
298
+ ```ts
299
+ import { evaluate } from 'foldkit-remote-server'
300
+
301
+ evaluate(PostsBySlug.body!, { slug: 'intro' }, rows)
302
+ // the matching rows, in the order the body asks for
303
+ ```
304
+
305
+ It is pure — it reads the rows it is given and nothing else — and it is the
306
+ reference the compiled interpreters are checked against. `foldkit-remote-drizzle`
307
+ turns the same body into SQL; the test suite runs both over the same rows in a
308
+ real SQLite and requires the same ids in the same order. That is what makes a
309
+ body source-neutral in fact rather than in principle.
310
+
311
+ **It follows SQL, not JavaScript.** The case that matters is null: `null = null`
312
+ is *unknown* in SQL and matches no row, where JavaScript would call the two
313
+ equal. A comparison keeps a row only when it is true, so a null on either side
314
+ drops it.
315
+
316
+ Two things it refuses rather than guesses:
317
+
318
+ - **Ordering by a column that is null in some row.** SQLite sorts nulls first,
319
+ Postgres sorts them last for `asc`: the databases disagree with each other, so
320
+ there is no answer to be conformant to and picking one would make this wrong
321
+ against the other.
322
+ - **Comparing values it has no order for**, such as a number against a string.
323
+
324
+ Both throw where the query runs, naming the query and the field.
325
+
292
326
  ## Mutations
293
327
 
294
328
  A Mutation Source changes server-owned state. It returns the protocol output
package/dist/index.d.mts CHANGED
@@ -1,5 +1,22 @@
1
1
  import { Effect, Schema, Stream } from "effect";
2
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
3
20
  //#region src/index.d.ts
4
21
  declare const RemoteServerError_base: Schema.Class<RemoteServerError, Schema.TaggedStruct<"RemoteServerError", {
5
22
  readonly message: Schema.String;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;qBAiCa,0BAA0B;iBAOtB;WACN;WACA,QAAQ,SAAS;;iBAGX,oBAAoB;WAC1B;WACA;;WAEA,UAAU,SAAS,eAAe;WAClC,WAAW;;iBAGL,aAAa,GAAG;WACtB;;WAEA,SAAS;WACT,OACP,SAAS,oBAAoB,OAC1B,OAAO,OAAO,cAAc,eAAe,mBAAmB;;WAE1D,aAAa,WAAW,GAAG;;;YAI1B,mBAAmB,OAAO,OAAO,YAAY;iBA8CxC,gBAAgB;WACtB,QAAQ;WACR,WAAW,cAAc;;WAEzB,cAAc,cAAc;;;;;WAK5B,UAAU;aAAyB;aAAyB;;;iBAGtD,eAAe,GAAG;WACxB;WACA,OAAO,OAAO;WACd,QAAQ,OAAO;WACf,MAAM;aAAoB;aAAyB,WAAW;QAAQ,OAAO;aAEzE;aACA,UAAU,cAAc;aACxB,aAAa,cAAc;aAC3B,SAAS;eAAyB;eAAyB;;KAEtE,mBACA;;iBAIa;WACN,OAAO;aACL;aACA;aACA;;WAEF,OAAO;WACP,KAAK;;iBAGC,YAAY,GAAG;WACrB;WACA,OAAO,OAAO;WACd,MAAM;aACJ;aACA,QAAQ;aACR,WAAW;QAChB,OAAO,OAAO,WAAW,mBAAmB;;iBAGnC,WAAW,GAAG;WACpB;WACA,YAAY;aACV,cAAc,cAAc;aAC5B;aACA,WAAW;QAChB,OAAO,OAAO,OAAO,OAAO,YAAY,aAAa,mBAAmB;;iBAG/D,iBAAiB,GAAG;WAC1B,UAAU,oBAAoB,aAAa,GAAG;WAC9C,WAAW,oBAAoB,eAAe,GAAG;WACjD,SAAS,oBAAoB,YAAY,GAAG;WAC5C,MAAM,oBAAoB,WAAW,GAAG;;iBASlC,eAAe,GAAG;;WAExB;;WAEA;;WAEA,OAAO,QAAQ,GAAG;;KAkBxB,kBAAkB,OAAO,OAAO,YAAY;UAGvC;WACC;WACA;;;;;;;;;;;iBAYM,QAAQ,GAAG;WACjB,UACP,KAAK,SACL,QAAQ,0BACL,OAAO,aAAa,mBAAmB;WACnC,UAAU,KAAK,YAAY,OAAO;;WAElC,YAAY;aACV,cAAc,cAAc;aAC5B;aACA,WAAW;;aAEX;QACL,OAAO,OAAO,iBAAiB;;WAE5B,MAAM,OAAO;;;UAyLd;WACC;WACA,SAAS,SAAS;;qBAGhB;;EAGG,UAAA,YAAA,oBAAkB;aACd;aAAyB;QACxC;;EAIW,SAAA,YAAA,oBAAkB;aACd;aAAyB;QACxC;;EAIW,SAAA,YAAA,oBAAkB;aACd;aAAyB;QACxC;;;;;;EAOM,SAAA,aAAa,WAAC,QACb,YAAU;aAEP,MAAM,aAAa,GAAG;aACtB,YAAY,aAAa,GAAG;QAEtC,aAAa,GAAG;EAQjB,WAAA,aACA,WACA,8BACA,iBACA,kBAAM,UAEI,mBAAmB,MAAM,OAAO,SAAO,MAC3C;aACK,OAAO;aACP,WAAW;QAChB,OAAO,OAAO,gBAAgB,SAAS,mBAAmB,OAC/D,eAAe,GAAG;EAeb,QAAA,aAAa,WAAW,iBAAK,OAC5B,wBAAwB,iBAAe,MACxC;aACK,OAAO;aACP,QAAQ;aACR,WAAW;QAChB,OAAO,OAAO,WAAW,mBAAmB,OACjD,YAAY,GAAG;;EAQX,OAAA,aAAa,WAAC,QACX,YAAU;aACE,WAAW,WAAW,GAAG;QAC5C,WAAW,GAAG;;;;;;;;;EAzPF,UAAA,GAAG,GAAC,UAAY,cAAc,aAAa,GAAG,QAAM,OAAO,OAAO,QAAQ,GAAG;EAwQrF,OAAA,aAAa,WAAC;aACV,mBAAmB,aAAa,GAAG;aACnC,qBAAqB,eAAe,GAAG;aACvC,mBAAmB,YAAY,GAAG;aAClC,gBAAgB,WAAW,GAAG;QACrC,iBAAiB,GAAG;;;;;;EAYL,WAAA,QAAA,kBAAgB,QAAU;;;;;;;EAsBlC,WAAA,GAAG,GAAC,QACL,iBAAiB,GAAG,IAAE,WACnB,GAAC,UACH,eAAe,GAAG,OAC1B,gBAAgB"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/evaluate.ts","../src/index.ts"],"mappings":"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"}
package/dist/index.mjs CHANGED
@@ -1,5 +1,94 @@
1
1
  import { Effect, Queue, Schema, Stream } from "effect";
2
- import { REMOTE_PROTOCOL_VERSION, RemoteLiveError, RemoteMutationError, RemoteProtocolError, RemoteQueryError, RemoteReadError, Requirement, connectionIdentity, entityKey, refsIn, stableStringify } from "foldkit-remote";
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
3
92
  //#region src/index.ts
4
93
  /**
5
94
  * `foldkit-remote-server` — server-side Sources and handler compilation.
@@ -48,6 +137,27 @@ const DEFAULT_MAX_IDS_PER_ENTITY = 1e3;
48
137
  /** A nested selection may not reach further than this many relation levels. */
49
138
  const DEFAULT_MAX_DEPTH = 8;
50
139
  /** Fails when the requirements name more distinct ids of one entity than `maxIds`. */
140
+ /**
141
+ * Each page of a relation read beside another is a source read of its own, and
142
+ * the names come from the client, so how many one relation may have is bounded.
143
+ * A screen shows a list and a page or two of it, not dozens.
144
+ */
145
+ const MAX_PAGES_PER_RELATION = 4;
146
+ /** The relation a request pages more ways than allowed, at any depth; `undefined` when none. */
147
+ const checkPagesPerRelation = (requirements) => {
148
+ for (const requirement of requirements) {
149
+ const pages = /* @__PURE__ */ new Map();
150
+ for (const name of requirement.fields) {
151
+ if (!name.includes(RELATION_ALIAS)) continue;
152
+ const field = aliasedField(name);
153
+ const count = (pages.get(field) ?? 0) + 1;
154
+ if (count > MAX_PAGES_PER_RELATION) return `${requirement.entity}.${field}`;
155
+ pages.set(field, count);
156
+ }
157
+ const nested = checkPagesPerRelation(Object.values(requirement.relations ?? {}));
158
+ if (nested !== void 0) return nested;
159
+ }
160
+ };
51
161
  const checkIdsPerEntity = (requirements, maxIds) => {
52
162
  const ids = /* @__PURE__ */ new Map();
53
163
  for (const requirement of requirements) {
@@ -71,6 +181,8 @@ const liveHub = (entities) => Effect.sync(() => {
71
181
  subscribe: ({ requirements, after, principal, maxIdsPerEntity }) => Stream.unwrap(Effect.gen(function* () {
72
182
  const over = checkIdsPerEntity(requirements, Math.max(1, maxIdsPerEntity ?? DEFAULT_MAX_IDS_PER_ENTITY));
73
183
  if (over !== void 0) return yield* new RemoteServerError({ message: `Too many "${over}" ids in one live subscription` });
184
+ const paged = checkPagesPerRelation(requirements);
185
+ if (paged !== void 0) return yield* new RemoteServerError({ message: `Too many pages of "${paged}" in one live subscription` });
74
186
  const selected = /* @__PURE__ */ new Map();
75
187
  for (const requirement of requirements) {
76
188
  const key = `${requirement.entity}:${requirement.id}`;
@@ -99,26 +211,34 @@ const liveHub = (entities) => Effect.sync(() => {
99
211
  for (const subscriber of subscribers) {
100
212
  const selected = subscriber.selected.get(key);
101
213
  if (selected === void 0) continue;
102
- const wanted = fields.filter((field) => selected.fields.has(field));
103
- if (wanted.length === 0) continue;
104
- const windows = Object.fromEntries(wanted.flatMap((field) => {
105
- const window = selected.windows.get(field);
106
- return window === void 0 ? [] : [[field, window]];
107
- }));
108
214
  const byWindows = groups.get(subscriber.principal) ?? /* @__PURE__ */ new Map();
109
215
  groups.set(subscriber.principal, byWindows);
110
- const windowKey = stableStringify(windows);
111
- const group = byWindows.get(windowKey) ?? {
112
- windows,
113
- entries: []
216
+ const join = (windows, renames, wanted) => {
217
+ const groupKey = `${stableStringify(windows)}\u0000${stableStringify(renames)}`;
218
+ const group = byWindows.get(groupKey) ?? {
219
+ windows,
220
+ renames,
221
+ entries: []
222
+ };
223
+ byWindows.set(groupKey, group);
224
+ group.entries.push({
225
+ subscriber,
226
+ fields: wanted
227
+ });
114
228
  };
115
- byWindows.set(windowKey, group);
116
- group.entries.push({
117
- subscriber,
118
- fields: wanted
119
- });
229
+ const wanted = fields.filter((field) => selected.fields.has(field));
230
+ if (wanted.length > 0) join(Object.fromEntries(wanted.flatMap((field) => {
231
+ const window = selected.windows.get(field);
232
+ return window === void 0 ? [] : [[field, window]];
233
+ })), {}, wanted);
234
+ for (const alias of selected.fields) {
235
+ const window = selected.windows.get(alias);
236
+ const field = aliasedField(alias);
237
+ if (field === alias || window === void 0 || !fields.includes(field)) continue;
238
+ join({ [field]: window }, { [field]: alias }, [field]);
239
+ }
120
240
  }
121
- for (const [principal, byWindows] of groups) for (const { windows, entries: group } of byWindows.values()) {
241
+ for (const [principal, byWindows] of groups) for (const { windows, renames, entries: group } of byWindows.values()) {
122
242
  const requested = [...new Set(group.flatMap((entry) => entry.fields))];
123
243
  const allowed = allowedFields(source, principal, requested);
124
244
  if (allowed.length === 0) continue;
@@ -132,7 +252,7 @@ const liveHub = (entities) => Effect.sync(() => {
132
252
  if (record === void 0) continue;
133
253
  for (const { subscriber, fields: wanted } of group) {
134
254
  const values = Object.create(null);
135
- for (const field of wanted) if (allowedSet.has(field) && Object.hasOwn(record.values, field)) values[field] = record.values[field];
255
+ for (const field of wanted) if (allowedSet.has(field) && Object.hasOwn(record.values, field)) values[renames[field] ?? field] = record.values[field];
136
256
  const changed = Object.keys(values);
137
257
  if (changed.length === 0) continue;
138
258
  yield* emit(subscriber, {
@@ -164,6 +284,57 @@ const protocolMismatch = (received) => received === REMOTE_PROTOCOL_VERSION ? vo
164
284
  expected: REMOTE_PROTOCOL_VERSION,
165
285
  received
166
286
  });
287
+ const pickNames = (record, names) => {
288
+ if (record === void 0) return void 0;
289
+ const picked = names.flatMap((name) => Object.hasOwn(record, name) ? [[name, record[name]]] : []);
290
+ return picked.length === 0 ? void 0 : Object.fromEntries(picked);
291
+ };
292
+ /**
293
+ * A request's aliased fields, each as a read of its own. `comments@first=10` is
294
+ * the `comments` relation read with the alias's window, so a source sees the
295
+ * field it knows and one window for it, while the whole list rides beside it in
296
+ * another read. The answer goes back under the alias, which is also the key of
297
+ * the relation followed from it.
298
+ */
299
+ const splitAliases = (request) => {
300
+ const aliases = request.fields.filter((field) => field.includes(RELATION_ALIAS));
301
+ if (aliases.length === 0) return [request];
302
+ const plain = request.fields.filter((field) => !field.includes(RELATION_ALIAS));
303
+ const building = [{
304
+ fields: [...plain],
305
+ windows: { ...pickNames(request.windows, plain) },
306
+ relations: { ...pickNames(request.relations, plain) },
307
+ renames: {}
308
+ }];
309
+ for (const alias of aliases) {
310
+ const window = request.windows?.[alias];
311
+ if (window === void 0) continue;
312
+ const field = aliasedField(alias);
313
+ let part = building.find((candidate) => !candidate.fields.includes(field));
314
+ if (part === void 0) {
315
+ part = {
316
+ fields: [],
317
+ windows: {},
318
+ relations: {},
319
+ renames: {}
320
+ };
321
+ building.push(part);
322
+ }
323
+ part.fields.push(field);
324
+ part.windows[field] = window;
325
+ part.renames[field] = alias;
326
+ const relation = request.relations?.[alias];
327
+ if (relation !== void 0) part.relations[alias] = relation;
328
+ }
329
+ return building.filter((part) => part.fields.length > 0).map((part) => ({
330
+ entity: request.entity,
331
+ id: request.id,
332
+ fields: part.fields,
333
+ ...Object.keys(part.windows).length === 0 ? {} : { windows: part.windows },
334
+ ...Object.keys(part.relations).length === 0 ? {} : { relations: part.relations },
335
+ ...Object.keys(part.renames).length === 0 ? {} : { renames: part.renames }
336
+ }));
337
+ };
167
338
  /**
168
339
  * One level's requests grouped per entity and window signature: ids and
169
340
  * slices unioned. Requests that page a relation differently are separate
@@ -171,15 +342,17 @@ const protocolMismatch = (received) => received === REMOTE_PROTOCOL_VERSION ? vo
171
342
  */
172
343
  const groupByEntity = (requests) => {
173
344
  const grouped = /* @__PURE__ */ new Map();
174
- for (const request of requests) {
175
- const groupKey = `${request.entity}\u0000${stableStringify(request.windows ?? null)}`;
345
+ for (const request of requests.flatMap(splitAliases)) {
346
+ const renames = request.renames ?? {};
347
+ const groupKey = `${request.entity}\u0000${stableStringify(request.windows ?? null)}\u0000${stableStringify(renames)}`;
176
348
  const group = grouped.get(groupKey);
177
349
  if (group === void 0) grouped.set(groupKey, {
178
350
  ids: /* @__PURE__ */ new Set([request.id]),
179
351
  slice: Requirement.mergeRelation({
180
352
  entity: request.entity,
181
353
  fields: []
182
- }, request)
354
+ }, request),
355
+ renames
183
356
  });
184
357
  else {
185
358
  group.ids.add(request.id);
@@ -279,6 +452,8 @@ const RemoteServer = {
279
452
  const maxIds = Math.max(1, options.maxIdsPerEntity ?? DEFAULT_MAX_IDS_PER_ENTITY);
280
453
  const over = checkIdsPerEntity(payload.requests, maxIds);
281
454
  if (over !== void 0) return yield* new RemoteReadError({ message: `Too many "${over}" ids in one read batch` });
455
+ const paged = checkPagesPerRelation(payload.requests);
456
+ if (paged !== void 0) return yield* new RemoteReadError({ message: `Too many pages of "${paged}" in one read` });
282
457
  let pending = payload.requests;
283
458
  for (let depth = 0; pending.length > 0; depth++) {
284
459
  if (depth > maxDepth) return yield* new RemoteReadError({ message: `Nested selection deeper than ${maxDepth} relation levels` });
@@ -307,7 +482,7 @@ const RemoteServer = {
307
482
  }
308
483
  }
309
484
  };
310
- for (const { ids, slice } of groupByEntity(pending)) {
485
+ for (const { ids, slice, renames } of groupByEntity(pending)) {
311
486
  const name = slice.entity;
312
487
  const source = server.entities.get(name);
313
488
  if (source === void 0) continue;
@@ -324,7 +499,7 @@ const RemoteServer = {
324
499
  }).pipe(Effect.catchTag("RemoteServerError", (error) => Effect.fail(new RemoteReadError({ message: error.message })))));
325
500
  for (const record of records) {
326
501
  const values = Object.create(null);
327
- for (const field of allowed) if (Object.hasOwn(record.values, field)) values[field] = record.values[field];
502
+ for (const field of allowed) if (Object.hasOwn(record.values, field)) values[renames[field] ?? field] = record.values[field];
328
503
  entities.push({
329
504
  entity: name,
330
505
  id: record.id,
@@ -332,7 +507,7 @@ const RemoteServer = {
332
507
  });
333
508
  const key = `${name}:${record.id}`;
334
509
  const known = fetched.get(key) ?? /* @__PURE__ */ new Set();
335
- for (const field of allowed) known.add(field);
510
+ for (const field of allowed) known.add(renames[field] ?? field);
336
511
  fetched.set(key, known);
337
512
  fetchedValues.set(key, {
338
513
  ...fetchedValues.get(key),
@@ -412,6 +587,6 @@ const RemoteServer = {
412
587
  })
413
588
  };
414
589
  //#endregion
415
- export { RemoteServer, RemoteServerError };
590
+ export { QueryEvaluateError, RemoteServer, RemoteServerError, evaluate };
416
591
 
417
592
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"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, 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} 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`. */\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 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 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 wanted = fields.filter(field => selected.fields.has(field))\n if (wanted.length === 0) continue\n const windows = Object.fromEntries(\n wanted.flatMap(field => {\n const window = selected.windows.get(field)\n return window === undefined ? [] : [[field, window] as const]\n }),\n )\n const byWindows = groups.get(subscriber.principal) ?? new Map<string, ReadGroup<P>>()\n groups.set(subscriber.principal, byWindows)\n const windowKey = stableStringify(windows)\n const group = byWindows.get(windowKey) ?? { windows, entries: [] }\n byWindows.set(windowKey, group)\n group.entries.push({ subscriber, fields: wanted })\n }\n for (const [principal, byWindows] of groups) {\n for (const { windows, 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[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}\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) {\n const groupKey = `${request.entity}\\u0000${stableStringify(request.windows ?? null)}`\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 })\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\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 } 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 const values: Record<string, unknown> = Object.create(null)\n for (const field of allowed) {\n if (Object.hasOwn(record.values, field)) values[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(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"],"mappings":"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"}
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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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldkit-remote-server",
3
- "version": "0.4.0",
3
+ "version": "0.5.0",
4
4
  "description": "Server sources and handler compilation for foldkit-remote: entities, selection authorization, and normalization.",
5
5
  "keywords": [
6
6
  "foldkit",
@@ -38,7 +38,8 @@
38
38
  "LICENSE"
39
39
  ],
40
40
  "dependencies": {
41
- "foldkit-remote": "0.4.0"
41
+ "foldkit-remote": "0.5.0",
42
+ "foldkit-entity": "0.2.0"
42
43
  },
43
44
  "peerDependencies": {
44
45
  "effect": "^4.0.0-rc.112"