foldkit-remote-server 0.1.0 → 0.3.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
@@ -1,216 +1,536 @@
1
1
  # `foldkit-remote-server`
2
2
 
3
- The server half of [`foldkit-remote`](https://github.com/doeixd/foldkit-plus/tree/main/packages/remote).
4
- It owns the semantic work Effect RPC does not know about: entity, query, and
5
- mutation Sources, **selection authorization**, normalization, and compilation to
6
- the `RemoteRpc` handlers.
3
+ The server-side interpreter for [`foldkit-remote`](../remote).
4
+
5
+ A Remote client sends **semantic requirements** — entity ids, selected fields,
6
+ query windows, mutations, and live requirements. `foldkit-remote-server` turns
7
+ those requirements into calls to application-owned **Sources**, enforces
8
+ field-level read authorization while the field names are still known, and
9
+ normalizes the results back into the patches the client cache understands.
10
+
11
+ The central pipeline is:
12
+
13
+ ```text
14
+ Remote requirement
15
+ |
16
+ v
17
+ RemoteServer handlers
18
+ |
19
+ +-- validate protocol / input
20
+ +-- filter fields by Entity + principal
21
+ +-- group and de-duplicate reads
22
+ |
23
+ v
24
+ application Source
25
+ |
26
+ v
27
+ normalized Remote result
28
+ |
29
+ v
30
+ Remote client -> Message -> Data.reduce -> Model
31
+ ```
32
+
33
+ A Source is deliberately small: it says how your application reads one Entity,
34
+ runs one Query or Mutation, or produces one live stream. The package does **not**
35
+ own HTTP, WebSockets, authentication, or a database connection. Authentication
36
+ resolves a `principal` outside this package; database/API clients remain Effect
37
+ requirements of the Sources that use them.
38
+
39
+ Use this package when the server is yours and you want the selections declared
40
+ by `foldkit-remote` to survive all the way to the data boundary instead of
41
+ turning back into hand-written per-screen endpoints.
42
+
43
+ ## What this package owns
44
+
45
+ ```text
46
+ client owns
47
+ which server facts are required
48
+
49
+ foldkit-remote-server owns
50
+ requirement interpretation
51
+ field authorization
52
+ read grouping / de-duplication
53
+ nested selection traversal
54
+ normalized wire results
55
+
56
+ application Sources own
57
+ how those facts are actually loaded or changed
58
+
59
+ Effect RPC / application owns
60
+ transport + serialization + authentication
61
+ ```
7
62
 
8
- It does not own HTTP, WebSockets, serialization, the authentication protocol, or
9
- database connections. `principal` is resolved outside and passed in; runtime
10
- dependencies stay in the Effect environment instead of being captured.
63
+ That separation matters. `RemoteServer` can decide that a client may read
64
+ `Project.name` but not `Project.privateNotes`; only your Source knows whether
65
+ that field comes from Postgres, another service, an in-memory index, or
66
+ something else.
11
67
 
12
- ## Quick start
68
+ ## Install
69
+
70
+ ```bash
71
+ pnpm add foldkit-remote-server
72
+ ```
73
+
74
+ `effect` is a peer dependency; `foldkit-remote` comes with the package.
75
+ [`foldkit-remote-drizzle`](../remote-drizzle) is an optional Source compiler for
76
+ Drizzle-backed entities and queries.
77
+
78
+ ## Sixty seconds: answer one Entity read
79
+
80
+ Start with the same Entity the client selects:
13
81
 
14
82
  ```ts
15
- import { Effect, Schema } from 'effect'
16
- import { Entity, Mutation, Query, RemoteRpc } from 'foldkit-remote'
83
+ import { Schema } from 'effect'
84
+ import { Entity, Remote, RemoteRpc } from 'foldkit-remote'
17
85
  import { RemoteServer } from 'foldkit-remote-server'
18
86
 
19
87
  const Project = Entity.make(
20
88
  'Project',
21
- Schema.Struct({ id: Schema.String, name: Schema.String, privateNotes: Schema.String }),
89
+ Schema.Struct({
90
+ id: Schema.String,
91
+ name: Schema.String,
92
+ privateNotes: Schema.String,
93
+ }),
22
94
  )
95
+ ```
23
96
 
24
- const RenameProject = Mutation.make('RenameProject', {
25
- Input: Schema.Struct({ id: Schema.String, name: Schema.String }),
26
- Output: Schema.Struct({ id: Schema.String }),
27
- })
97
+ Give that Entity one Source:
28
98
 
29
- const ProjectsByOwner = Query.make('ProjectsByOwner', {
30
- Input: Schema.Struct({ ownerId: Schema.String }),
31
- Result: Query.connection(Project),
99
+ ```ts
100
+ const ProjectSource = RemoteServer.entity(Project, {
101
+ // Authentication already resolved `principal` before RemoteServer sees it.
102
+ // Return only fields this caller may read.
103
+ authorize: (principal, fields) =>
104
+ fields.filter(field => field !== 'privateNotes' || principal.isAdmin),
105
+
106
+ // Your application owns this function. Read exactly the ids/fields requested.
107
+ read: ({ ids, fields, principal }) =>
108
+ loadProjects({ ids, fields, principal }),
32
109
  })
33
110
 
34
111
  const Server = RemoteServer.make({
35
- entities: [
36
- RemoteServer.entity(Project, {
37
- authorize: (principal, fields) => fields.filter(field => principal.canRead(Project, field)),
38
- read: ({ ids, fields, windows, principal }) => loadProjects({ ids, fields, windows, principal }),
39
- }),
40
- ],
41
- mutations: [
42
- RemoteServer.mutation(RenameProject, ({ input, principal }) =>
43
- renameProject(input, principal).pipe(
44
- Effect.map(output => ({
45
- output,
46
- entities: [Entity.patch(Project.ref(input.id), { name: input.name })],
47
- })),
48
- ),
49
- ),
50
- ],
51
- queries: [
52
- RemoteServer.query(ProjectsByOwner, ({ input, window, principal }) =>
53
- projectsPage({ ownerId: input.ownerId, window, principal }),
54
- ),
55
- ],
56
- live: [
57
- RemoteServer.live(Project, {
58
- subscribe: ({ requirements, after, principal }) =>
59
- projectEvents({ ids: requirements.map(request => request.id), after, principal }),
60
- }),
61
- ],
112
+ entities: [ProjectSource],
62
113
  })
114
+ ```
63
115
 
116
+ Compile that definition into the Remote RPC handlers for one authenticated
117
+ principal:
118
+
119
+ ```ts
64
120
  const handlers = RemoteServer.handlers(Server, principal)
65
121
  const layer = RemoteRpc.toLayer(handlers)
66
- // FoldkitRemoteRead, FoldkitRemoteMutate, FoldkitRemoteQuery, FoldkitRemoteLive
67
122
  ```
68
123
 
69
- `handlers(server, principal, options?)` takes a `HandlerOptions<P, R>`:
70
- `maxIdsPerEntity` (default 1000) bounds a read batch and a live subscription
71
- per entity, `maxDepth` (default 8) bounds nested resolution, and `live` is the
72
- hub whose signals reach the subscriptions this handler registers. In-process,
73
- the handlers are a `RemoteClient` through `Remote.clientLayer(handlers)`, with
74
- whatever the sources require supplied by `Layer.provide`.
124
+ That is the core package. A client requirement such as:
75
125
 
76
- ## Sources
126
+ ```text
127
+ Project:p1 [id, name, privateNotes]
128
+ ```
77
129
 
78
- ### `RemoteServer.entity`
130
+ runs as:
79
131
 
80
- ```ts
81
- RemoteServer.entity(Project, {
82
- authorize?: (principal: P, fields: readonly string[]) => readonly string[],
83
- read: (context: { ids; fields; windows?; principal }) =>
84
- Effect.Effect<ReadonlyArray<{ id: string; values: Record<string, unknown> }>, RemoteServerError, R>,
132
+ ```text
133
+ 1. Project declares: id, name, privateNotes
134
+ 2. authorize returns: id, name
135
+ 3. Source receives: ids=[p1], fields=[id,name]
136
+ 4. Source returns: { id: 'p1', values: { id: 'p1', name: 'Apollo' } }
137
+ 5. handler normalizes: Project:p1 { id, name }
138
+ 6. client records presence only for the returned fields
139
+ ```
140
+
141
+ `privateNotes` never reaches `read`. Authorization happens before application
142
+ data access, while the request still has semantic field names.
143
+
144
+ ## The read lifecycle
145
+
146
+ An Entity read is more than a direct function call because a Remote selection
147
+ may contain several ids and nested relations. The handler performs the mechanical
148
+ work once so Sources do not have to:
149
+
150
+ ```text
151
+ client requirements
152
+ |
153
+ v
154
+ group by Entity
155
+ |
156
+ v
157
+ union requested fields
158
+ |
159
+ v
160
+ filter declared + authorized fields
161
+ |
162
+ v
163
+ batch / de-duplicate ids
164
+ |
165
+ v
166
+ Entity Source.read(...)
167
+ |
168
+ v
169
+ follow selected relation refs
170
+ |
171
+ v
172
+ next Entity Source
173
+ |
174
+ v
175
+ normalized patches
176
+ ```
177
+
178
+ A Source therefore receives the useful boundary directly:
179
+
180
+ ```text
181
+ RemoteServer.entity(entity, {
182
+ read: ({ ids, fields, windows?, principal }) => Effect<
183
+ ReadonlyArray<{ id: string; values: Record<string, unknown> }>,
184
+ RemoteServerError,
185
+ R
186
+ >,
187
+
188
+ authorize?: (principal, fields) => readonly string[]
85
189
  })
86
190
  ```
87
191
 
88
- Given the Entity, a request for a field it does not declare never reaches
89
- `read` or `authorize`; `RemoteServer.entity({ name: 'Project' }, …)` declares
90
- no fields and passes every requested one through.
192
+ Important consequences:
193
+
194
+ - a field the Entity does not declare never reaches `authorize` or `read`;
195
+ - `authorize` can only remove requested fields, never add new ones;
196
+ - a Source may return a partial entity — omitted fields remain absent on the
197
+ client and may be requested later;
198
+ - ids shared by several selections are de-duplicated;
199
+ - relation targets are fetched level by level and shared targets are not loaded
200
+ repeatedly;
201
+ - a relation the principal may not read is never followed.
202
+
203
+ The Source should still avoid reading or returning columns the request did not
204
+ ask for. The handler filters returned values again, but the data boundary is the
205
+ best place to preserve least privilege and avoid wasted work.
206
+
207
+ ## Nested selections
208
+
209
+ Suppose the client projects:
210
+
211
+ ```text
212
+ Project:p1 {
213
+ id
214
+ name
215
+ owner { id name }
216
+ }
217
+ ```
218
+
219
+ and the Project Source returns an owner ref:
220
+
221
+ ```text
222
+ Project:p1.owner = User:u7
223
+ ```
224
+
225
+ The handler follows that ref through the `User` Source on the next level:
226
+
227
+ ```text
228
+ Project requirement
229
+ |
230
+ v
231
+ Project Source
232
+ |
233
+ | owner = User:u7
234
+ v
235
+ User requirement
236
+ |
237
+ v
238
+ User Source
239
+ ```
240
+
241
+ The Sources do not recursively call each other. `RemoteServer` owns traversal,
242
+ depth limits, batching, and de-duplication; each Source still answers only for
243
+ its own Entity.
91
244
 
92
- `read` is called once per entity, id batch, and window per read level: ids are
93
- batched up to `maxIdsPerEntity`, ids that page a relation differently are read
94
- separately, and a nested selection reads its next level after the refs arrive.
95
- `windows` carries the pagination window for each requested relation field. The result may be a partial
96
- entity: a field the source omits is simply not present, and presence metadata on
97
- the client reflects that.
245
+ ## Queries
98
246
 
99
- ### `RemoteServer.query`
247
+ A Query Source answers the ordered connection itself. Entity fields for the page
248
+ items remain normal Entity reads, so query membership and entity data stay
249
+ separate:
100
250
 
101
251
  ```ts
102
- RemoteServer.query(ProjectsByOwner, ({ input, window, principal }) =>
103
- Effect.Effect<QueryPage, RemoteServerError, R>,
252
+ import { Query } from 'foldkit-remote'
253
+
254
+ const ProjectsByOwner = Query.make('ProjectsByOwner', {
255
+ Input: Schema.Struct({ ownerId: Schema.String }),
256
+ Result: Query.connection(Project),
257
+ })
258
+
259
+ const ProjectsByOwnerSource = RemoteServer.query(
260
+ ProjectsByOwner,
261
+ ({ input, window, principal }) =>
262
+ projectsPage({ ownerId: input.ownerId, window, principal }),
104
263
  )
264
+
265
+ const Server = RemoteServer.make({
266
+ entities: [ProjectSource],
267
+ queries: [ProjectsByOwnerSource],
268
+ })
269
+ ```
270
+
271
+ A Query returns:
272
+
273
+ ```ts
274
+ {
275
+ edges,
276
+ start,
277
+ end,
278
+ }
105
279
  ```
106
280
 
107
- `QueryPage` is `{ edges, start, end }`; `start`/`end` are `Boundary` values
108
- (`Terminal`, `Cursor`, or `Unknown`) so the client can merge the page without
109
- inferring adjacency from row count.
281
+ `start` and `end` are Remote `Boundary` values (`Terminal`, `Cursor`, or
282
+ `Unknown`). The client uses those explicit boundaries when merging pages instead
283
+ of guessing from row count.
284
+
285
+ Query input is decoded through the Query's own Schema before your callback runs.
286
+ The callback receives the decoded input, the requested `QueryWindow`, and the
287
+ principal.
288
+
289
+ ## Mutations
110
290
 
111
- ### `RemoteServer.mutation`
291
+ A Mutation Source changes server-owned state. It returns the protocol output
292
+ plus any normalized entity/connection changes that should settle the client's
293
+ cache immediately:
112
294
 
113
295
  ```ts
114
- RemoteServer.mutation(RenameProject, ({ input, principal }) =>
115
- Effect.Effect<
116
- { output: Output; entities?: NormalizedPatch[]; connections?: ConnectionChange[] },
117
- RemoteServerError,
118
- R
119
- >,
296
+ import { Effect } from 'effect'
297
+ import { Mutation } from 'foldkit-remote'
298
+
299
+ const RenameProject = Mutation.make('RenameProject', {
300
+ Input: Schema.Struct({ id: Schema.String, name: Schema.String }),
301
+ Output: Schema.Struct({ id: Schema.String }),
302
+ })
303
+
304
+ const RenameProjectSource = RemoteServer.mutation(
305
+ RenameProject,
306
+ ({ input, principal }) =>
307
+ renameProject(input, principal).pipe(
308
+ Effect.map(output => ({
309
+ output,
310
+ entities: [
311
+ Entity.patch(Project.ref(input.id), { name: input.name }),
312
+ ],
313
+ })),
314
+ ),
120
315
  )
121
316
  ```
122
317
 
123
- `input` is decoded against the mutation's `Input` schema first, so the callback
124
- receives the typed input. `output` is encoded against `Output`; `entities` are
125
- the normalized cache patches the client will reconcile, and `connections` the
126
- confirmed connection inserts and removes that replace the client's optimistic
127
- ones in place: `RemoteServer.prepend(connection, ref)`, `append`, and
128
- `remove`, where `connection` is a `QueryRef` or its identity.
318
+ The input is decoded before the Source runs and the output is encoded before it
319
+ crosses the wire. A Source may additionally return connection changes:
320
+
321
+ ```ts
322
+ RemoteServer.prepend(connection, Project.ref(id))
323
+ RemoteServer.append(connection, Project.ref(id))
324
+ RemoteServer.remove(connection, Project.ref(id))
325
+ ```
326
+
327
+ Those confirmed changes replace the corresponding optimistic connection layers
328
+ on the client.
329
+
330
+ Remote mutations are immediate requests against **server-owned** state. They are
331
+ not a durable offline intent log; client-authored edits that must survive offline
332
+ belong to `foldkit-sync`.
333
+
334
+ ## Live data
335
+
336
+ There are two ways to produce live changes.
129
337
 
130
- ### `RemoteServer.live`
338
+ ### Write a live Source directly
131
339
 
132
340
  ```ts
133
- RemoteServer.live(Project, {
341
+ const ProjectLive = RemoteServer.live(Project, {
134
342
  subscribe: ({ requirements, after, principal }) =>
135
- Stream.Stream<LiveChange, RemoteServerError, R>,
343
+ projectEvents({
344
+ requirements,
345
+ after,
346
+ principal,
347
+ }),
136
348
  })
137
349
  ```
138
350
 
139
- `after` is the client's resume cursor; events at or before it are duplicates. The
140
- handler merges the requested entities' streams and maps a source failure onto the
141
- wire error. An entity with no live source contributes nothing, so the client
142
- plans a refetch instead of failing the stream. A `LiveChange` is an entity patch
143
- or delete, or a connection insert/remove/invalidate.
351
+ `after` is the client's resume cursor. Events at or before it are duplicates.
352
+ The stream carries Remote `LiveChange`s: entity patches/deletes and connection
353
+ insert/remove/invalidate events.
354
+
355
+ If an Entity has no live Source, it contributes no stream. That is not an error:
356
+ the client planner can fall back to refetching it.
144
357
 
145
- ### `RemoteServer.liveHub`
358
+ ### Let a `liveHub` re-read changed fields
146
359
 
147
- The higher-level signal. A hub tracks each live subscriber's requirements and
148
- principal, so the server says *what changed* and the hub works out *who cares*:
360
+ When your infrastructure can say **what changed** but does not naturally produce
361
+ Remote patches, use a hub:
149
362
 
150
363
  ```ts
364
+ const entitySources = [ProjectSource]
151
365
  const hub = yield* RemoteServer.liveHub(entitySources)
152
- const handlers = RemoteServer.handlers(server, principal, { live: hub })
153
366
 
154
- // Wherever the data changes (a mutation source, a database trigger):
367
+ const handlers = RemoteServer.handlers(Server, principal, {
368
+ live: hub,
369
+ })
370
+
371
+ // From a mutation Source, database trigger consumer, etc.
155
372
  yield* hub.changed(Project.ref(projectId), ['status', 'updatedAt'])
156
373
  yield* hub.deleted(Project.ref(projectId))
157
374
  ```
158
375
 
159
- `changed` intersects the fields with what each subscriber selects, re-reads
160
- that intersection through the entity's own source under the subscriber's
161
- principal (one read per principal value and window signature; subscribers
162
- selecting none of the fields do no work), and streams an `EntityPatched`
163
- carrying only the fields that subscriber may see. A record the source does not
164
- return for the changed id reaches nobody. `deleted` streams an `EntityDeleted` to the entity's
165
- subscribers. Cursors continue from the cursor each subscriber resumed at, so
166
- the client's duplicate and gap handling is unchanged. A hub and hand-written
167
- `RemoteServer.live` sources number their events independently; use one or the
168
- other for a given subscription. Nested relation targets are not subscribed by
169
- the hub, only the requirements' own entities.
170
-
171
- ## Authorization
172
-
173
- Authentication and authorization are separate. Authentication answers *who is
174
- this* (Effect RPC middleware → `Principal`); `RemoteServer` answers *may this
175
- principal read this semantic field*. Authorization is mandatory, not opt-in:
176
-
177
- - A field the Entity does not declare is dropped before `authorize` sees it.
178
- - An entity with no `authorize` exposes the requested fields.
179
- - An entity with `authorize` exposes only the returned fields, and a field the
180
- principal may not see is dropped.
181
- - **Never read or return a field the client did not request**, even if a
182
- permissive `authorize` allows more.
183
- - If no field survives authorization, the entity contributes nothing, so the
184
- existence of an unauthorized entity is not leaked.
376
+ The hub remembers each subscriber's requirements and principal. `changed`:
377
+
378
+ 1. intersects the changed fields with what each subscriber selected;
379
+ 2. re-reads only that intersection through the Entity Source;
380
+ 3. applies that subscriber's authorization again;
381
+ 4. emits the resulting patch with a continuing cursor.
382
+
383
+ Subscribers that selected none of the changed fields do no work.
384
+
385
+ A hand-written live Source and a hub number their events independently. Use one
386
+ or the other for a given subscription path rather than mixing cursor domains.
387
+
388
+ ## Authentication vs authorization
389
+
390
+ Keep these boundaries separate:
391
+
392
+ ```text
393
+ authentication
394
+ "Who is making this request?"
395
+ Effect RPC middleware / application
396
+ |
397
+ v
398
+ Principal
399
+ |
400
+ v
401
+ authorization
402
+ "Which semantic fields may this principal read?"
403
+ RemoteServer.entity(... authorize ...)
404
+ ```
405
+
406
+ `RemoteServer.handlers(Server, principal)` deliberately receives a resolved
407
+ principal. It does not inspect headers, sessions, cookies, or bearer tokens.
408
+
409
+ For Entity reads:
410
+
411
+ - undeclared fields are dropped first;
412
+ - `authorize` receives only declared, requested fields;
413
+ - omitting `authorize` means the requested declared fields are readable;
414
+ - returning no fields produces no entity contribution;
415
+ - existence is not leaked merely because an unauthorized id was requested.
416
+
417
+ Mutation and Query policy belongs in their Sources because those operations are
418
+ application-specific rather than field-selection policy.
419
+
420
+ ## Compose and validate the server
421
+
422
+ A complete server definition is just the collection of Sources:
423
+
424
+ ```ts
425
+ const Server = RemoteServer.make({
426
+ entities: [ProjectSource, UserSource],
427
+ queries: [ProjectsByOwnerSource],
428
+ mutations: [RenameProjectSource],
429
+ live: [ProjectLive],
430
+ })
431
+ ```
432
+
433
+ When the client and server share the Remote domain declaration, validate the
434
+ Source names at startup:
435
+
436
+ ```ts
437
+ const Data = Remote.define({
438
+ entities: [Project, User],
439
+ queries: [ProjectsByOwner],
440
+ mutations: [RenameProject],
441
+ })
442
+
443
+ RemoteServer.validate(Data, Server)
444
+ ```
445
+
446
+ That catches an Entity, Query, or Mutation Source whose name is not declared by
447
+ the shared domain instead of letting it silently answer nothing at runtime.
448
+
449
+ Then compile once per authenticated principal:
450
+
451
+ ```ts
452
+ const handlers = RemoteServer.handlers(Server, principal, {
453
+ maxIdsPerEntity: 1000,
454
+ maxDepth: 8,
455
+ live: hub,
456
+ })
457
+ ```
458
+
459
+ `handlers` implements the `RemoteRpc` client shape directly. In-process — tests,
460
+ SSR, a worker, or a single service — it can become a `RemoteClient` with:
461
+
462
+ ```ts
463
+ const clientLayer = Remote.clientLayer(handlers)
464
+ ```
465
+
466
+ Across a process boundary, use:
467
+
468
+ ```ts
469
+ const rpcLayer = RemoteRpc.toLayer(handlers)
470
+ ```
471
+
472
+ The application supplies the Effect RPC server/transport layer. `RemoteServer`
473
+ does not choose HTTP, WebSocket, or another transport for you.
474
+
475
+ ## Runtime dependencies belong to Sources
476
+
477
+ Sources are Effects, so dependencies stay explicit:
478
+
479
+ ```text
480
+ Project Source
481
+ requires Database
482
+
483
+ Billing Query Source
484
+ requires BillingApi
485
+
486
+ RemoteServer
487
+ requires Database | BillingApi
488
+ ```
489
+
490
+ The server definition does not capture either service. Provide their Layers at
491
+ the application boundary. This is also why `foldkit-remote-drizzle` provides
492
+ Drizzle-backed Sources rather than putting a database inside `RemoteServer`.
185
493
 
186
494
  ## Hardening
187
495
 
188
- - Each read batch and live subscription is bounded per entity
189
- (`maxIdsPerEntity`, default 1000, counted across the batch's window groups),
190
- and an oversized one fails rather than loading unbounded rows.
191
- - A selection nested past `MAX_RELATION_DEPTH` (8) or naming more than
192
- `MAX_FIELDS_PER_REQUEST` (256) fields of one entity is refused at decode.
193
- - Returned field names are filtered with `Object.hasOwn` and accumulated into a
194
- null-prototype object, so a crafted field name such as `__proto__` or
195
- `toString` cannot reach the prototype.
196
- - Handler errors are remapped to the wire error types without echoing internals.
197
-
198
- ## What it owns
199
-
200
- - Entity, query, mutation, and live Sources.
201
- - Selection authorization and field filtering.
202
- - Request grouping, id de-duplication, field unions, and window threading.
203
- - Normalization of source results into wire entities.
204
- - Source-name validation: `RemoteServer.validate(domain, server)` checks every
205
- entity, query, and mutation source against the domain's `registry`, so an
206
- undeclared name fails at startup rather than returning nothing at call time.
207
- - Compilation to the `RemoteRpc` handlers.
208
-
209
- ## Limits
210
-
211
- - Transport, serialization, and the authentication protocol are Effect RPC's; the
212
- application provides the server protocol layer.
213
- - The live wire carries a `LiveChange` union: entity patches and deletes, plus
214
- connection insert/remove/invalidate events.
215
- - Database and other runtime dependencies are the Source's Effect requirements,
216
- not this package's.
496
+ The handler applies bounded, protocol-level safeguards before or around Sources:
497
+
498
+ - a read batch may name at most `maxIdsPerEntity` distinct ids for one Entity
499
+ (default `1000`); oversized client batches fail rather than loading unbounded
500
+ rows;
501
+ - nested resolution is bounded by `maxDepth` (default `8`);
502
+ - the wire decoder also rejects a selection deeper than
503
+ `MAX_RELATION_DEPTH` (`8`) or more than `MAX_FIELDS_PER_REQUEST` (`256`)
504
+ fields for one Entity;
505
+ - returned field names are copied with `Object.hasOwn` into null-prototype
506
+ objects, so names such as `__proto__` or `toString` cannot reach prototypes;
507
+ - Source errors are remapped to protocol error types without echoing application
508
+ internals.
509
+
510
+ A `liveHub` applies the same id bound to a subscription. A hand-written live
511
+ Source is responsible for any additional bounds appropriate to its backend.
512
+
513
+ ## What it does not own
514
+
515
+ `foldkit-remote-server` intentionally does **not** own:
516
+
517
+ - HTTP/WebSocket transport or serialization;
518
+ - authentication protocol or session storage;
519
+ - a database connection;
520
+ - the client's normalized cache;
521
+ - client rendering or Surface activation;
522
+ - durable/offline client-authored state.
523
+
524
+ Those boundaries keep this package an interpreter of the Remote contract rather
525
+ than another application runtime.
526
+
527
+ ## See also
528
+
529
+ - [Server-derived state](../../docs/remote.md) — the client/server mental model
530
+ and ownership rules.
531
+ - [`foldkit-remote`](../remote) — requirements, normalized client Model,
532
+ subscriptions, mutations, live reads, and retention.
533
+ - [`foldkit-remote-drizzle`](../remote-drizzle) — compile Entity selections and
534
+ Query windows into Drizzle reads.
535
+ - [`examples/kitchen-sink`](../../examples/kitchen-sink) — Remote +
536
+ RemoteServer + Drizzle + `liveHub` in one executable trace.
package/dist/index.d.mts CHANGED
@@ -1,6 +1,5 @@
1
1
  import { Effect, Schema, Stream } from "effect";
2
- import { Boundary, ConnectionChangeSchema, ConnectionIdentity, LiveChange, MutationDescriptor, NormalizedPatch, QueryDescriptor, QueryWindow, RemoteDescriptor, RemoteRpcClient } from "foldkit-remote";
3
- import { Requirement } from "foldkit-surface";
2
+ import { Boundary, ConnectionChangeSchema, ConnectionIdentity, LiveChange, MutationDescriptor, NormalizedPatch, QueryDescriptor, QueryWindow, RemoteDescriptor, RemoteRpcClient, Requirement } from "foldkit-remote";
4
3
  //#region src/index.d.ts
5
4
  declare const RemoteServerError_base: Schema.Class<RemoteServerError, Schema.TaggedStruct<"RemoteServerError", {
6
5
  readonly message: Schema.String;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../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,6 +1,5 @@
1
1
  import { Effect, Queue, Schema, Stream } from "effect";
2
- import { REMOTE_PROTOCOL_VERSION, RemoteLiveError, RemoteMutationError, RemoteProtocolError, RemoteQueryError, RemoteReadError, connectionIdentity, entityKey, refsIn, stableStringify } from "foldkit-remote";
3
- import { Requirement } from "foldkit-surface";
2
+ import { REMOTE_PROTOCOL_VERSION, RemoteLiveError, RemoteMutationError, RemoteProtocolError, RemoteQueryError, RemoteReadError, Requirement, connectionIdentity, entityKey, refsIn, stableStringify } from "foldkit-remote";
4
3
  //#region src/index.ts
5
4
  /**
6
5
  * `foldkit-remote-server` — server-side Sources and handler compilation.
@@ -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 type RemoteRpcClient,\n} from 'foldkit-remote'\nimport { Requirement } from 'foldkit-surface'\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\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 },\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 })),\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 }\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/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\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 },\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 })),\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 }\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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"}
package/package.json CHANGED
@@ -1,9 +1,20 @@
1
1
  {
2
2
  "name": "foldkit-remote-server",
3
- "version": "0.1.0",
3
+ "version": "0.3.0",
4
4
  "description": "Server sources and handler compilation for foldkit-remote: entities, selection authorization, and normalization.",
5
+ "keywords": [
6
+ "foldkit",
7
+ "effect",
8
+ "server-state",
9
+ "rpc",
10
+ "authorization",
11
+ "normalization"
12
+ ],
5
13
  "type": "module",
6
14
  "license": "MIT",
15
+ "publishConfig": {
16
+ "access": "public"
17
+ },
7
18
  "author": "Patrick Glenn <doeixd@gmail.com>",
8
19
  "repository": {
9
20
  "type": "git",
@@ -27,8 +38,7 @@
27
38
  "LICENSE"
28
39
  ],
29
40
  "dependencies": {
30
- "foldkit-remote": "0.1.0",
31
- "foldkit-surface": "0.1.0"
41
+ "foldkit-remote": "0.3.0"
32
42
  },
33
43
  "peerDependencies": {
34
44
  "effect": "^4.0.0-rc.112"