foldkit-remote-server 0.3.0 → 0.4.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
@@ -97,7 +97,10 @@ const Project = Entity.make(
97
97
  Give that Entity one Source:
98
98
 
99
99
  ```ts
100
- const ProjectSource = RemoteServer.entity(Project, {
100
+ // Your authentication's principal type; without it `principal` is `unknown`.
101
+ type Principal = { readonly isAdmin: boolean }
102
+
103
+ const ProjectSource = RemoteServer.entity<Principal>(Project, {
101
104
  // Authentication already resolved `principal` before RemoteServer sees it.
102
105
  // Return only fields this caller may read.
103
106
  authorize: (principal, fields) =>
package/dist/index.d.mts CHANGED
@@ -31,6 +31,14 @@ export interface MutationOutcome<Output> {
31
31
  readonly entities?: ReadonlyArray<NormalizedPatch>;
32
32
  /** Connection changes the mutation made; the client settles them with its patches. */
33
33
  readonly connections?: ReadonlyArray<ConnectionChange>;
34
+ /**
35
+ * Entities the mutation deleted. The client knows them absent from then on:
36
+ * they leave every connection and read `NotFound`, with no connection to name.
37
+ */
38
+ readonly deleted?: ReadonlyArray<{
39
+ readonly entity: string;
40
+ readonly id: string;
41
+ }>;
34
42
  }
35
43
  export interface MutationSource<P, R = never> {
36
44
  readonly mutation: string;
@@ -43,6 +51,10 @@ export interface MutationSource<P, R = never> {
43
51
  readonly output: unknown;
44
52
  readonly entities: ReadonlyArray<NormalizedPatch>;
45
53
  readonly connections: ReadonlyArray<ConnectionChange>;
54
+ readonly deleted: ReadonlyArray<{
55
+ readonly entity: string;
56
+ readonly id: string;
57
+ }>;
46
58
  }, RemoteServerError, R>;
47
59
  }
48
60
  export interface QueryPage {
@@ -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
@@ -216,7 +216,8 @@ const RemoteServer = {
216
216
  }).pipe(Effect.map((outcome) => ({
217
217
  output: outcome.output,
218
218
  entities: outcome.entities ?? [],
219
- connections: outcome.connections ?? []
219
+ connections: outcome.connections ?? [],
220
+ deleted: outcome.deleted ?? []
220
221
  })))
221
222
  }),
222
223
  query: (query, run) => ({
@@ -366,7 +367,11 @@ const RemoteServer = {
366
367
  id: patch.id,
367
368
  values: patch.values
368
369
  })),
369
- connections: outcome.connections
370
+ connections: outcome.connections,
371
+ deleted: outcome.deleted.map((gone) => ({
372
+ entity: gone.entity,
373
+ id: gone.id
374
+ }))
370
375
  };
371
376
  }),
372
377
  FoldkitRemoteQuery: Effect.fn("RemoteServer.FoldkitRemoteQuery")(function* (payload) {
@@ -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\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 * 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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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "foldkit-remote-server",
3
- "version": "0.3.0",
3
+ "version": "0.4.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,7 @@
38
38
  "LICENSE"
39
39
  ],
40
40
  "dependencies": {
41
- "foldkit-remote": "0.3.0"
41
+ "foldkit-remote": "0.4.0"
42
42
  },
43
43
  "peerDependencies": {
44
44
  "effect": "^4.0.0-rc.112"
@@ -47,7 +47,7 @@
47
47
  "effect": "4.0.0-rc.112",
48
48
  "foldkit": "0.158.2",
49
49
  "tsdown": "^0.23.0",
50
- "typescript": "^5.7.2"
50
+ "typescript": "5.9.3"
51
51
  },
52
52
  "scripts": {
53
53
  "build": "tsdown",