foldkit-ssr 0.8.1 → 0.9.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.
Files changed (50) hide show
  1. package/README.md +203 -69
  2. package/dist/client-F16QT0sc.d.ts +75 -0
  3. package/dist/client-F16QT0sc.d.ts.map +1 -0
  4. package/dist/client.d.ts +5 -0
  5. package/dist/client.js +271 -0
  6. package/dist/client.js.map +1 -0
  7. package/dist/context.d.ts +2 -0
  8. package/dist/context.js +21 -0
  9. package/dist/context.js.map +1 -0
  10. package/dist/diagnostics.d.ts +2 -0
  11. package/dist/diagnostics.js +59 -0
  12. package/dist/diagnostics.js.map +1 -0
  13. package/dist/{index.d.mts → index.d.ts} +18 -7
  14. package/dist/index.d.ts.map +1 -0
  15. package/dist/{index.mjs → index.js} +79 -60
  16. package/dist/index.js.map +1 -0
  17. package/dist/listen-zNd0IIAT.d.ts +69 -0
  18. package/dist/listen-zNd0IIAT.d.ts.map +1 -0
  19. package/dist/listen.d.ts +2 -0
  20. package/dist/listen.js +179 -0
  21. package/dist/listen.js.map +1 -0
  22. package/dist/requestContext-D9nsbGSJ.d.ts +21 -0
  23. package/dist/requestContext-D9nsbGSJ.d.ts.map +1 -0
  24. package/dist/requestContext.d.ts +2 -0
  25. package/dist/requestContext.js +48 -0
  26. package/dist/requestContext.js.map +1 -0
  27. package/dist/resumable-BWItJsxF.d.ts +86 -0
  28. package/dist/resumable-BWItJsxF.d.ts.map +1 -0
  29. package/dist/resumable.d.ts +2 -0
  30. package/dist/resumable.js +358 -0
  31. package/dist/resumable.js.map +1 -0
  32. package/dist/{client-DkwAniQQ.d.mts → shared-v1u-OEQI.d.ts} +218 -194
  33. package/dist/shared-v1u-OEQI.d.ts.map +1 -0
  34. package/dist/shared.d.ts +2 -0
  35. package/dist/shared.js +324 -0
  36. package/dist/shared.js.map +1 -0
  37. package/dist/{vite.d.mts → vite.d.ts} +3 -5
  38. package/dist/vite.d.ts.map +1 -0
  39. package/dist/{vite.mjs → vite.js} +3 -4
  40. package/dist/vite.js.map +1 -0
  41. package/package.json +17 -17
  42. package/dist/client-DVG9_3rL.mjs +0 -1113
  43. package/dist/client-DVG9_3rL.mjs.map +0 -1
  44. package/dist/client-DkwAniQQ.d.mts.map +0 -1
  45. package/dist/client.d.mts +0 -2
  46. package/dist/client.mjs +0 -1
  47. package/dist/index.d.mts.map +0 -1
  48. package/dist/index.mjs.map +0 -1
  49. package/dist/vite.d.mts.map +0 -1
  50. package/dist/vite.mjs.map +0 -1
@@ -1,8 +1,13 @@
1
- import { C as tagOf, D as SLOT_ATTRIBUTE, E as FALLBACK_FIELD, O as withContext, S as staticRegion, T as FALLBACK_DEPTH_FIELD, _ as resume, a as META_ATTRIBUTE, b as serving, c as STATIC_ATTRIBUTE, d as codecOf, f as metaMarkup, g as projectionsOf, h as plan, i as FOLDKIT_APP_ATTRIBUTE, l as allowedTags, m as pathKey, n as SSR$1, o as RESUME_ATTRIBUTE, p as modelFrom, r as UNTIL_LIMIT_MS, s as ResumeRefused, t as Resume, u as attributeOf, v as routeOf, w as BINDING_ATTRIBUTE, x as startingFrom, y as serializeJsonScript } from "./client-DVG9_3rL.mjs";
1
+ import { withContext } from "./context.js";
2
+ import { handlerUnnamed, pageFailed, reportingTo } from "./diagnostics.js";
3
+ import { BINDING_ATTRIBUTE, FALLBACK_DEPTH_FIELD, FALLBACK_FIELD, SLOT_ATTRIBUTE } from "./resumable.js";
4
+ import { FOLDKIT_APP_ATTRIBUTE, META_ATTRIBUTE, RESUME_ATTRIBUTE, ResumeRefused, STATIC_ATTRIBUTE, allowedTags, attributeOf, codecOf, metaMarkup, modelFrom, pathKey, plan, projectionsOf, resume, routeOf, serializeJsonScript, serving, startingFrom, staticRegion, tagOf } from "./shared.js";
5
+ import { Diagnostics, Resume, SSR as SSR$1, UNTIL_LIMIT_MS } from "./client.js";
6
+ import { requestContext } from "./requestContext.js";
2
7
  import { Cause, Context, Effect, Exit, Layer, Option, Result, Schema } from "effect";
8
+ import { Diagnostics as Diagnostics$1, Metadata } from "foldkit-surface";
3
9
  import { FOLDKIT_FLAGS_ATTRIBUTE, Rendered, Responded, injectIntoTemplate, renderToString } from "foldkit/experimental/server";
4
- import { Metadata } from "foldkit-surface";
5
- //#region src/index.ts
10
+ // src/index.ts
6
11
  /**
7
12
  * `foldkit-ssr`: what crosses from the server to the browser when a page is
8
13
  * rendered on one and resumed on the other.
@@ -139,14 +144,31 @@ const inspect = (plan, model) => {
139
144
  /** How a plan covers its Surfaces, given the server's Model and the browser's. */
140
145
  const coverage = (plan, model, browser) => {
141
146
  const covered = new Set(plan.parts.flatMap((part) => part.covers));
147
+ const families = /* @__PURE__ */ new Map();
148
+ for (const family of plan.surfaces.flatMap((source) => Option.toArray(familyOf(source)))) {
149
+ const siblings = families.get(family.from);
150
+ if (siblings === void 0) families.set(family.from, [family]);
151
+ else siblings.push(family);
152
+ }
153
+ const shown = /* @__PURE__ */ new Set();
142
154
  return {
143
155
  id: plan.id,
144
156
  state: plan.state.dependencies.map(pathOf),
145
157
  local: plan.local.map(pathOf),
146
158
  parts: plan.parts.map((part) => part.id),
147
- surfaces: plan.surfaces.flatMap((source) => coverSource(plan, covered, source, model, browser))
159
+ surfaces: plan.surfaces.flatMap((source) => {
160
+ const surface = Option.match(familyOf(source), {
161
+ onNone: () => source,
162
+ onSome: (family) => family.from
163
+ });
164
+ if (shown.has(surface)) return [];
165
+ shown.add(surface);
166
+ return coverSurface(plan, covered, surface, families.get(surface) ?? [], model, browser);
167
+ })
148
168
  };
149
169
  };
170
+ /** The plan entry as a family with a parent; none for a lone Surface. */
171
+ const familyOf = (source) => source.from !== void 0 && typeof source.instancesOf === "function" ? Option.some(source) : Option.none();
150
172
  /** One coverage row: a lone Surface, a family's parent, or one family instance. */
151
173
  const coverRow = (plan, covered, entry, served, browserServed) => ({
152
174
  name: entry.name,
@@ -165,33 +187,30 @@ const coverRow = (plan, covered, entry, served, browserServed) => ({
165
187
  sameInBrowser: readsKey(served) === readsKey(browserServed)
166
188
  });
167
189
  /**
168
- * A plan entry's coverage rows: one for a lone Surface, or a family's parent
169
- * followed by one row per instance. The parent row keeps the parent's reads
170
- * covered; each instance row says which key it is and which parent reveals
171
- * it, so a gap names the instance (`Member[u1]`), not just the Surface.
190
+ * A Surface's coverage rows: its own row, then, while it is active, one row
191
+ * per instance of each family it is the parent of. The parent row keeps the
192
+ * parent's reads covered; each instance row says which key it is and which
193
+ * parent reveals it, so a gap names the instance (`Member[u1]`), not just the
194
+ * Surface.
172
195
  */
173
- const coverSource = (plan, covered, source, model, browser) => {
174
- const from = source.from;
175
- if (from === void 0 || typeof source.instancesOf !== "function") {
176
- const lone = source;
177
- return [coverRow(plan, covered, lone, Option.getOrUndefined(lone.projectionOf(model)), Option.getOrUndefined(lone.projectionOf(browser)))];
178
- }
179
- const family = source;
180
- const rows = [coverRow(plan, covered, from, Option.getOrUndefined(from.projectionOf(model)), Option.getOrUndefined(from.projectionOf(browser)))];
181
- if (rows[0]?.active !== true) return rows;
182
- const browserInstances = family.instancesOf(browser);
183
- for (const instance of family.instancesOf(model)) rows.push(coverRow(plan, covered, {
184
- name: family.name,
185
- key: instance.key,
186
- via: {
187
- surface: from.name,
188
- ...from.activation === void 0 ? {} : { activation: {
189
- path: pathOf(from.activation.path),
190
- cover: coverOf(from.activation.path, plan)
191
- } }
192
- }
193
- }, instance.projection, browserInstances.find((other) => other.key === instance.key)?.projection));
194
- return rows;
196
+ const coverSurface = (plan, covered, surface, families, model, browser) => {
197
+ const own = coverRow(plan, covered, surface, Option.getOrUndefined(surface.projectionOf(model)), Option.getOrUndefined(surface.projectionOf(browser)));
198
+ if (!own.active) return [own];
199
+ const via = {
200
+ surface: surface.name,
201
+ ...surface.activation === void 0 ? {} : { activation: {
202
+ path: pathOf(surface.activation.path),
203
+ cover: coverOf(surface.activation.path, plan)
204
+ } }
205
+ };
206
+ return [own, ...families.flatMap((family) => {
207
+ const browserInstances = new Map(family.instancesOf(browser).map((instance) => [instance.key, instance.projection]));
208
+ return family.instancesOf(model).map((instance) => coverRow(plan, covered, {
209
+ name: family.name,
210
+ key: instance.key,
211
+ via
212
+ }, instance.projection, browserInstances.get(instance.key)));
213
+ })];
195
214
  };
196
215
  /** A coverage row as a shortfall names it: `Member[u1]` for an instance, the name alone otherwise. */
197
216
  const displayOf = (surface) => surface.key === void 0 ? surface.name : `${surface.name}[${surface.key}]`;
@@ -483,25 +502,26 @@ const robots = (options) => [
483
502
  `Sitemap: ${new URL(options.sitemap ?? "/sitemap.xml", options.origin).href}`,
484
503
  ""
485
504
  ].join("\n");
486
- const warnedUnnamed = /* @__PURE__ */ new Set();
505
+ const reportedUnnamed = /* @__PURE__ */ new Set();
487
506
  /**
488
- * Warns, once per process, about each handler that keeps a page from
489
- * answering before boot. Only a page that waits to boot is held up: one
490
- * started `'now'`, with no lazy bundle to load, boots before any event.
507
+ * Reports, once per process, each handler that keeps a page from answering
508
+ * before boot. Only a page that waits to boot is held up: one started
509
+ * `'now'`, with no lazy bundle to load, boots before any event.
491
510
  */
492
- const warnUnnamed = (config, plan, unnamed) => {
493
- if (plan.start === "now" && (config.lazy ?? []).length === 0) return;
494
- for (const { element, event } of unnamed) {
511
+ const reportUnnamed = (config, plan, unnamed) => Effect.suspend(() => {
512
+ if (plan.start === "now" && (config.lazy ?? []).length === 0) return Effect.void;
513
+ const first = unnamed.filter(({ element, event }) => {
495
514
  const key = JSON.stringify([
496
515
  plan.id,
497
516
  element,
498
517
  event
499
518
  ]);
500
- if (warnedUnnamed.has(key)) continue;
501
- warnedUnnamed.add(key);
502
- console.warn(`[foldkit-ssr] plan "${plan.id}": ${element} handles ${event} with a function, which the page cannot name, so that event waits for the live runtime. Give the handler a Message, or, for OnInput, OnChange, OnKeyDown or OnKeyUp, the Message's constructor with the field the event fills left out.`);
503
- }
504
- };
519
+ if (reportedUnnamed.has(key)) return false;
520
+ reportedUnnamed.add(key);
521
+ return true;
522
+ });
523
+ return Effect.forEach(first, ({ element, event }) => Diagnostics$1.report(handlerUnnamed(plan.id, element, event)), { discard: true });
524
+ });
505
525
  /**
506
526
  * Renders pages at build time, one per path, each as `SSR.render` and
507
527
  * `SSR.page` would, to be written as files. `origin` makes each path the full
@@ -527,18 +547,15 @@ const generate = (config, plan, options) => Effect.gen(function* () {
527
547
  });
528
548
  files.set(fileOf(path), path);
529
549
  }
530
- return yield* Effect.forEach(options.paths, (path) => Effect.map(renderMatching(config, plan, {
550
+ return yield* Effect.forEach(options.paths, (path) => renderMatching(config, plan, {
531
551
  buildId: options.buildId,
532
552
  url: new URL(path, options.origin).href,
533
553
  ...options.flags === void 0 ? {} : { flags: options.flags(path) }
534
- }, "path"), (result) => {
535
- warnUnnamed(config, plan, result.unnamed);
536
- return {
537
- path,
538
- file: fileOf(path),
539
- html: page(options.template, result, { head: options.head })
540
- };
541
- }));
554
+ }, "path").pipe(Effect.tap((result) => reportUnnamed(config, plan, result.unnamed)), Effect.map((result) => ({
555
+ path,
556
+ file: fileOf(path),
557
+ html: page(options.template, result, { head: options.head })
558
+ }))));
542
559
  });
543
560
  /**
544
561
  * The server entry for Foldkit's pipeline: the `renderPage` a dev server,
@@ -552,7 +569,7 @@ const generate = (config, plan, options) => Effect.gen(function* () {
552
569
  * the post is unusable. `OPTIONS` is answered `204`, and any other method
553
570
  * `405`, each with the methods the entry answers in `allow` (`handleRequest`
554
571
  * passes every method through). A render that fails, or a plan the render
555
- * refuses, is answered `500` with the reason logged, never with a page the
572
+ * refuses, is answered `500` with the reason reported (`diagnostics`), never with a page the
556
573
  * browser cannot resume. `headers(request)` rides on the `Rendered` result, so
557
574
  * Foldkit's `toResponse` sets it over its own on the page: a cache policy, or
558
575
  * a CORS answer to a preflight.
@@ -582,12 +599,14 @@ const entry = (config, plan, options) => {
582
599
  const answer = async (request) => {
583
600
  const method = request.method.toUpperCase();
584
601
  const posting = method === "POST" && plan.fallback === "server";
602
+ const { diagnostics } = options;
603
+ const reporting = reportingTo(diagnostics === void 0 ? void 0 : (diagnostic) => diagnostics(diagnostic, request));
585
604
  const headersOf = options.headers;
586
605
  let extra;
587
606
  if (headersOf !== void 0) try {
588
607
  extra = new Headers(headersOf(request));
589
608
  } catch (error) {
590
- console.error(`[foldkit-ssr] ${request.url} was not answered: headers threw ${String(error)}`);
609
+ await Effect.runPromise(reporting(Diagnostics$1.report(pageFailed(request.url, Cause.die(error)))));
591
610
  return Responded(plainText(500, "The page could not be rendered."));
592
611
  }
593
612
  const responded = (response) => Responded(extra === void 0 ? response : merge(response, extra));
@@ -617,14 +636,14 @@ const entry = (config, plan, options) => {
617
636
  ...flagged,
618
637
  ...styled
619
638
  });
620
- }));
639
+ }).pipe(reporting));
621
640
  if (Exit.isFailure(exit)) {
622
641
  const refused = Cause.findErrorOption(exit.cause).pipe(Option.filter((error) => error instanceof FallbackRefused));
623
642
  if (Option.isSome(refused)) return responded(plainText(400, `The form could not be handled: ${refused.value.message}`));
624
- console.error(`[foldkit-ssr] ${request.url} was not rendered: ${Cause.pretty(exit.cause)}`);
643
+ await Effect.runPromise(reporting(Diagnostics$1.report(pageFailed(request.url, exit.cause))));
625
644
  return responded(plainText(500, "The page could not be rendered."));
626
645
  }
627
- warnUnnamed(config, plan, exit.value.unnamed);
646
+ await Effect.runPromise(reporting(reportUnnamed(config, plan, exit.value.unnamed)));
628
647
  return extra === void 0 ? Rendered(exit.value.rendered) : Rendered(exit.value.rendered, { headers: extra });
629
648
  };
630
649
  return { renderPage: answer };
@@ -794,9 +813,9 @@ const SSR = {
794
813
  handle,
795
814
  serializeJsonScript,
796
815
  sitemap,
797
- robots
816
+ robots,
817
+ requestContext
798
818
  };
799
- //#endregion
800
- export { BINDING_ATTRIBUTE, FALLBACK_FIELD, FOLDKIT_APP_ATTRIBUTE, FallbackRefused, META_ATTRIBUTE, RESUME_ATTRIBUTE, Resume, ResumeRefused, ResumeUnsafe, SLOT_ATTRIBUTE, SSR, STATIC_ATTRIBUTE, UNTIL_LIMIT_MS, metaMarkup };
819
+ export { BINDING_ATTRIBUTE, Diagnostics, FALLBACK_FIELD, FOLDKIT_APP_ATTRIBUTE, FallbackRefused, META_ATTRIBUTE, RESUME_ATTRIBUTE, Resume, ResumeRefused, ResumeUnsafe, SLOT_ATTRIBUTE, SSR, STATIC_ATTRIBUTE, UNTIL_LIMIT_MS, metaMarkup };
801
820
 
802
- //# sourceMappingURL=index.mjs.map
821
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","names":["Diagnostics","Client"],"sources":["../src/index.ts"],"sourcesContent":["/**\n * `foldkit-ssr`: what crosses from the server to the browser when a page is\n * rendered on one and resumed on the other.\n *\n * Built from the plan in `docs/design/ssr-PLAN.md`. A resume plan names the\n * slice of the Model the browser owns. The server writes that slice onto the\n * stamped root as a JSON attribute, beside Foldkit's own stamps; the browser\n * reads it back and sets it onto a baseline\n * Model. Nothing outside the slice crosses, and a payload that cannot be read\n * back exactly is refused, never half-restored.\n *\n * Rendering and hydrating stay Foldkit's own: this package adds only the\n * handover. This module is the server's side and the browser's\n * (`foldkit-ssr/client`) together.\n */\nimport { Cause, Context, Effect, Exit, Layer, Option, Result, Schema } from 'effect'\nimport {\n FOLDKIT_FLAGS_ATTRIBUTE,\n Rendered,\n Responded,\n injectIntoTemplate,\n renderToString,\n type EntryModule,\n type EntryResult,\n type RenderError,\n type RenderedApplication,\n} from 'foldkit/experimental/server'\nimport { Diagnostics, Metadata, type Diagnostic, type MetadataSummary } from 'foldkit-surface'\nimport type {\n Activation,\n ActiveSurface,\n Projection,\n SurfaceFamily,\n SurfaceSource,\n} from 'foldkit-surface'\nimport { withContext, type Binding, type Region, type UnnamedHandler } from './context.js'\nimport { handlerUnnamed, pageFailed, reportingTo } from './diagnostics.js'\nimport { type EncodedBinding } from './listen.js'\nimport { FALLBACK_DEPTH_FIELD, FALLBACK_FIELD } from './resumable.js'\nimport { requestContext } from './requestContext.js'\nimport { SSR as Client } from './client.js'\nimport {\n PROTOCOL,\n allowedTags,\n attributeOf,\n codecOf,\n modelFrom,\n metaMarkup,\n pathKey,\n plan,\n projectionsOf,\n resume,\n routeOf,\n serializeJsonScript,\n serving,\n startingFrom,\n staticRegion,\n tagOf,\n type Loadable,\n type PlanSurface,\n type ResumableConfig,\n type ResumePlan,\n type RouteMatch,\n} from './shared.js'\n\n/** The projections of the plan's entries that are active for `model`. */\nconst activeProjections = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n model: Model,\n) => plan.surfaces.flatMap(source => projectionsOf(source, model))\n\n/** What the envelope carries of a Model: the encoded slice, and each part's capture. */\ninterface Payload {\n readonly state: unknown\n readonly parts?: Readonly<Record<string, unknown>>\n}\n\n/**\n * What the envelope carries of `model`: the plan's slice, encoded through its\n * own Schema, and each part's capture.\n */\nconst payloadOf = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n model: Model,\n): Payload => {\n const state = Schema.encodeSync(codecOf(plan.state.schema))(plan.state.get(model))\n if (plan.parts.length === 0) return { state }\n const projections = activeProjections(plan, model)\n return {\n state,\n parts: Object.fromEntries(plan.parts.map(part => [part.id, part.capture(model, projections)])),\n }\n}\n\ninterface EnvelopeOptions {\n readonly route?: string | undefined\n readonly match?: RouteMatch | undefined\n readonly bindings?: ReadonlyArray<EncodedBinding> | undefined\n /** Every event the page's markers name, so the browser listens without scanning for them. */\n readonly events?: ReadonlyArray<string> | undefined\n}\n\n/**\n * The envelope for `model`: the plan's slice, each part's capture, and\n * the route it was rendered for, if it was rendered for one. `SSR.render`\n * carries it on the stamped root, beside Foldkit's own stamps, escaped for\n * the attribute; this is the same JSON unescaped, for tests and hosts that\n * place the page themselves.\n */\nconst envelope = <Model, Fields extends Schema.Struct.Fields>(\n resume: ResumePlan<Model, Fields>,\n model: Model,\n options: EnvelopeOptions = {},\n): string => envelopeOf(resume, payloadOf(resume, model), options)\n\n/**\n * The envelope for a payload already built: the JSON the stamped root carries.\n */\nconst envelopeOf = <Model, Fields extends Schema.Struct.Fields>(\n resume: ResumePlan<Model, Fields>,\n payload: Payload,\n options: EnvelopeOptions,\n): string =>\n serializeJsonScript({\n v: PROTOCOL,\n plan: resume.id,\n ...payload,\n ...(options.route === undefined ? {} : { route: options.route }),\n ...(options.match === 'path' ? { match: 'path' } : {}),\n ...(options.bindings === undefined || options.bindings.length === 0\n ? {}\n : { bindings: options.bindings }),\n ...(options.events === undefined || options.events.length === 0\n ? {}\n : { events: options.events }),\n })\n\n/**\n * The rendered application with the envelope on its stamped root, beside\n * Foldkit's own app and build stamps. `injectIntoTemplate` accepts the\n * envelope there, as part of the root, and refuses it beside the root, so a\n * page the host injects carries the handover without the entry owning the\n * template. Hydration adopts the server's nodes around it and drops the\n * attribute on its first patch, so the browser reads the envelope before it\n * boots.\n */\nconst withEnvelopeAttribute = (html: string, json: string): string => {\n const stamp = 'data-foldkit-app=\"'\n // The stamp names the root's open tag: it opens the markup, and no quoted\n // attribute value before it may hold a `>` of its own, which would end a\n // naive scan early, or the stamp string itself. A stamp past the tag's end,\n // or in text, is not the root.\n let from = 0\n for (;;) {\n const at = html.indexOf(stamp, from)\n if (at === -1) {\n throw new Error(\n 'foldkit-ssr: the rendered application has no stamped root to carry the resume envelope',\n )\n }\n if (isInRootTag(html, at)) {\n const end = html.indexOf('\"', at + stamp.length)\n if (end === -1) {\n throw new Error(\n 'foldkit-ssr: the rendered application has no stamped root to carry the resume envelope',\n )\n }\n return `${html.slice(0, end + 1)}${attributeOf(json)}${html.slice(end + 1)}`\n }\n from = at + stamp.length\n }\n}\n\n/** Whether `at` sits inside the markup's first tag: quoted values skipped whole. */\nconst isInRootTag = (html: string, at: number): boolean => {\n if (!html.startsWith('<')) return false\n let index = 1\n while (index < at) {\n const char = html[index]\n if (char === '\"' || char === \"'\") {\n const close = html.indexOf(char, index + 1)\n if (close === -1 || close >= at) return false\n index = close + 1\n } else if (char === '>') {\n return false\n } else {\n index++\n }\n }\n return true\n}\n\n/**\n * The rendered markup with `extra` as the root's last child, so the first\n * paint is styled before any script runs where no template head can take it.\n * A void root holds no children: styles for one are refused, naming the tag,\n * rather than served where no browser could keep them.\n */\nconst withInRoot = (html: string, extra: string): Result.Result<string, ResumeUnsafe> => {\n const tag = /^<([A-Za-z][A-Za-z0-9-]*)/.exec(html)?.[1]\n const at = tag === undefined ? -1 : html.search(new RegExp(`</${tag}>\\\\s*$`))\n if (tag === undefined || at === -1) {\n return Result.fail(\n new ResumeUnsafe({\n reason: 'VoidRootWithStyles',\n message: `styles need a root element that can hold them, but the view returned <${tag ?? '?'}>: put the styles in the template's head with SSR.generate, or return an element root`,\n }),\n )\n }\n return Result.succeed(`${html.slice(0, at)}${extra}${html.slice(at)}`)\n}\n\n/**\n * The Model the browser will start from when the server's Model is `model`:\n * the payload taken through the page as the envelope carries it, as JSON, and\n * resumed exactly as `SSR.resume` resumes it. A part that cannot restore its\n * own capture fails here, on the server.\n */\nconst browserModelOf = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n payload: Payload,\n): Result.Result<Model, string> => modelFrom(plan, JSON.parse(serializeJsonScript(payload)))\n\n/** Where the browser gets a Model path's value: the envelope, the baseline, or nowhere it may. */\nexport type Cover = 'state' | 'local' | 'missing'\n\n/** One Surface as a plan covers it, for the server's Model. */\nexport interface SurfaceCoverage {\n readonly name: string\n /** Whether the Surface is active for the server's Model. */\n readonly active: boolean\n /** The instance key, for one instance of a `Surface.each` family. */\n readonly key?: string | undefined\n /**\n * The parent a family instance resolves through: the Surface whose Model\n * reveals it, and the place that activates the parent, when readable.\n */\n readonly via?:\n | {\n readonly surface: string\n readonly activation?: { readonly path: string; readonly cover: Cover } | undefined\n }\n | undefined\n /** The place a `Surface.when` activation reads; absent for `Surface.at`. */\n readonly activation?: { readonly path: string; readonly cover: Cover } | undefined\n /** The Model paths the active Surface reads. */\n readonly reads: ReadonlyArray<{ readonly path: string; readonly cover: Cover }>\n /**\n * What the active Surface reads that no Model path names, such as Remote\n * data, by its metadata. The slice cannot carry it.\n */\n readonly unresumed: ReadonlyArray<MetadataSummary>\n /** Whether the browser's Model activates it the same way, with the same reads. */\n readonly sameInBrowser: boolean\n}\n\n/** What a plan sends, what it leaves local, and how it covers each Surface. */\nexport interface PlanInspection {\n readonly id: string\n readonly state: ReadonlyArray<string>\n readonly local: ReadonlyArray<string>\n /** The ids of the parts that resume state the slice cannot carry. */\n readonly parts: ReadonlyArray<string>\n readonly surfaces: ReadonlyArray<SurfaceCoverage>\n}\n\nconst pathOf = (path: ReadonlyArray<string>): string =>\n path.length === 0 ? '(the whole Model)' : path.join('.')\n\n/**\n * A path is covered by a sent or local path equal to it or containing it. An\n * empty path is the whole Model, which no pick covers.\n */\nconst coverOf = (\n path: ReadonlyArray<string>,\n plan: {\n readonly state: { readonly dependencies: ReadonlyArray<ReadonlyArray<string>> }\n readonly local: ReadonlyArray<ReadonlyArray<string>>\n },\n): Cover => {\n const contains = (outer: ReadonlyArray<string>) =>\n outer.length > 0 &&\n outer.length <= path.length &&\n outer.every((key, index) => path[index] === key)\n if (plan.state.dependencies.some(contains)) return 'state'\n if (plan.local.some(contains)) return 'local'\n return 'missing'\n}\n\n/** A projection's reads as one comparable string, or `inactive`. */\nconst readsKey = (\n projection:\n | {\n readonly dependencies: ReadonlyArray<ReadonlyArray<string>>\n readonly metadata: Metadata\n }\n | undefined,\n): string =>\n projection === undefined\n ? 'inactive'\n : JSON.stringify([projection.dependencies, Metadata.summarize(projection.metadata)])\n\n/**\n * How a plan covers each of its Surfaces when the server's Model is `model`.\n * A Surface's reads depend on the Model, through its params, so coverage is\n * worked out for a Model, not for the plan alone.\n */\nconst inspect = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n model: Model,\n): PlanInspection => {\n const resumed = browserModelOf(plan, payloadOf(plan, model))\n if (Result.isFailure(resumed)) throw new Error(`SSR.inspect: ${resumed.failure}`)\n return coverage(plan, model, resumed.success)\n}\n\n/** How a plan covers its Surfaces, given the server's Model and the browser's. */\nconst coverage = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n model: Model,\n browser: Model,\n): PlanInspection => {\n const covered = new Set(plan.parts.flatMap(part => part.covers))\n const families = new Map<ActiveSurface<Model>, Array<Family<Model>>>()\n for (const family of plan.surfaces.flatMap(source => Option.toArray(familyOf(source)))) {\n const siblings = families.get(family.from)\n if (siblings === undefined) families.set(family.from, [family])\n else siblings.push(family)\n }\n // A row is a Surface's identity, not a plan entry: families sharing a\n // parent, or a parent also listed alone, show that parent once.\n const shown = new Set<ActiveSurface<Model>>()\n return {\n id: plan.id,\n state: plan.state.dependencies.map(pathOf),\n local: plan.local.map(pathOf),\n parts: plan.parts.map(part => part.id),\n surfaces: plan.surfaces.flatMap(source => {\n const surface = Option.match(familyOf(source), {\n onNone: () => source as ActiveSurface<Model>,\n onSome: family => family.from,\n })\n if (shown.has(surface)) return []\n shown.add(surface)\n return coverSurface(plan, covered, surface, families.get(surface) ?? [], model, browser)\n }),\n }\n}\n\ntype Family<Model> = SurfaceFamily<Model, unknown, unknown, unknown, unknown>\n\n/** The plan entry as a family with a parent; none for a lone Surface. */\nconst familyOf = <Model>(source: PlanSurface<Model>): Option.Option<Family<Model>> =>\n (source as { readonly from?: ActiveSurface<Model> }).from !== undefined &&\n typeof (source as Partial<SurfaceSource<Model>>).instancesOf === 'function'\n ? Option.some(source as Family<Model>)\n : Option.none()\n\n/** One coverage row: a lone Surface, a family's parent, or one family instance. */\nconst coverRow = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n covered: ReadonlySet<string>,\n entry: {\n readonly name: string\n readonly key?: string | undefined\n readonly via?: SurfaceCoverage['via']\n readonly activation?: Activation | undefined\n },\n served: Projection<Model, unknown> | undefined,\n browserServed: Projection<Model, unknown> | undefined,\n): SurfaceCoverage => ({\n name: entry.name,\n active: served !== undefined,\n ...(entry.key === undefined ? {} : { key: entry.key }),\n ...(entry.via === undefined ? {} : { via: entry.via }),\n ...(entry.activation === undefined\n ? {}\n : {\n activation: {\n path: pathOf(entry.activation.path),\n cover: coverOf(entry.activation.path, plan),\n },\n }),\n reads: (served?.dependencies ?? []).map(path => ({\n path: pathOf(path),\n cover: coverOf(path, plan),\n })),\n unresumed:\n served === undefined\n ? []\n : Metadata.summarize(served.metadata).filter(summary => !covered.has(summary.name)),\n sameInBrowser: readsKey(served) === readsKey(browserServed),\n})\n\n/**\n * A Surface's coverage rows: its own row, then, while it is active, one row\n * per instance of each family it is the parent of. The parent row keeps the\n * parent's reads covered; each instance row says which key it is and which\n * parent reveals it, so a gap names the instance (`Member[u1]`), not just the\n * Surface.\n */\nconst coverSurface = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n covered: ReadonlySet<string>,\n surface: ActiveSurface<Model>,\n families: ReadonlyArray<Family<Model>>,\n model: Model,\n browser: Model,\n): ReadonlyArray<SurfaceCoverage> => {\n const own = coverRow(\n plan,\n covered,\n surface,\n Option.getOrUndefined(surface.projectionOf(model)),\n Option.getOrUndefined(surface.projectionOf(browser)),\n )\n if (!own.active) return [own]\n const via: SurfaceCoverage['via'] = {\n surface: surface.name,\n ...(surface.activation === undefined\n ? {}\n : {\n activation: {\n path: pathOf(surface.activation.path),\n cover: coverOf(surface.activation.path, plan),\n },\n }),\n }\n return [\n own,\n ...families.flatMap(family => {\n const browserInstances = new Map(\n family.instancesOf(browser).map(instance => [instance.key, instance.projection]),\n )\n return family\n .instancesOf(model)\n .map(instance =>\n coverRow(\n plan,\n covered,\n { name: family.name, key: instance.key, via },\n instance.projection,\n browserInstances.get(instance.key),\n ),\n )\n }),\n ]\n}\n\n/** A coverage row as a shortfall names it: `Member[u1]` for an instance, the name alone otherwise. */\nconst displayOf = (surface: SurfaceCoverage): string =>\n surface.key === undefined ? surface.name : `${surface.name}[${surface.key}]`\n\n/** Each way an inspection shows the plan falls short, one line each. */\nconst shortfalls = (inspection: PlanInspection): ReadonlyArray<string> =>\n inspection.surfaces.flatMap(surface => [\n ...(surface.activation?.cover === 'missing'\n ? [\n `Surface \"${displayOf(surface)}\" is activated by ${surface.activation.path}, which is neither in the plan's state nor local`,\n ]\n : []),\n ...surface.reads\n .filter(read => read.cover === 'missing')\n .map(\n read =>\n `Surface \"${displayOf(surface)}\" reads ${read.path}, which is neither in the plan's state nor local`,\n ),\n ...surface.unresumed.map(\n summary =>\n `Surface \"${displayOf(surface)}\" reads ${summary.name} data (${summary.entries.join(', ')}), which no part of the plan resumes`,\n ),\n ...(surface.sameInBrowser\n ? []\n : [\n `Surface \"${displayOf(surface)}\" is ${surface.active ? 'active' : 'inactive'} on the server and activates differently from the Model the browser starts from`,\n ]),\n ])\n\n/** Why a server refused to render a page against its plan. */\nexport class ResumeUnsafe extends Schema.TaggedError<ResumeUnsafe>()('ResumeUnsafe', {\n reason: Schema.Literals([\n 'UndeclaredStartup',\n 'Uncovered',\n 'ViewDependsOnUnsentState',\n 'DuplicateStaticRegion',\n 'UngeneratablePath',\n 'UnrestorablePart',\n 'UnencodableBinding',\n 'EagerStartRequired',\n 'UndeclaredSurfaces',\n 'BindingInStaticRegion',\n 'VoidRootWithStyles',\n ]),\n message: Schema.String,\n}) {}\n\n/** Each binding whose Message no active Surface lists, one line each. */\nconst unlistedBindings = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n model: Model,\n bindings: ReadonlyArray<Binding>,\n): ReadonlyArray<string> => {\n const allowed = allowedTags(plan, model)\n return bindings\n .filter(binding => !allowed.has(tagOf(binding.message)))\n .map(\n binding =>\n `the ${binding.event} binding on ${binding.element} dispatches ${tagOf(binding.message)}, which no active Surface lists in its messages`,\n )\n}\n\n/** Loads every lazy bundle's bodies, so the view renders whole. */\nconst loadLazy = (config: { readonly lazy?: ReadonlyArray<Loadable> | undefined }) =>\n Effect.promise(() => Promise.all((config.lazy ?? []).map(bundle => bundle.load())))\n\n/** Foldkit's own Flags script, which a resumed page never carries. */\nconst FLAGS_SCRIPT = new RegExp(\n `<script[^>]*${FOLDKIT_FLAGS_ATTRIBUTE}[^>]*>[\\\\s\\\\S]*?</script>`,\n 'g',\n)\n\n/**\n * The head fields a render returns beside the body. Each is read by the view,\n * so each must come out the same from the browser's Model; since Foldkit 0.163\n * none has a default from the URL.\n */\nconst HEAD_FIELDS = ['title', 'lang', 'dir', 'canonical', 'ogUrl'] as const\n\n/** A render's bindings, encoded, or why one cannot be. */\nconst encodeBindings = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n bindings: ReadonlyArray<Binding>,\n): Result.Result<ReadonlyArray<EncodedBinding>, string> => {\n if (bindings.length === 0) return Result.succeed([])\n if (plan.Message === undefined) {\n return Result.fail(\n 'the page has bindings, and the plan has no Message Schema to encode them with: make the plan from the application',\n )\n }\n const encode = Schema.encodeUnknownResult(plan.Message as Schema.Codec<unknown, unknown>)\n const out: Array<EncodedBinding> = []\n for (const binding of bindings) {\n const message = encode(binding.message)\n if (Result.isFailure(message)) {\n return Result.fail(\n `the ${binding.event} binding on ${binding.element} does not encode as a Message: ${message.failure.message}`,\n )\n }\n out.push({\n attribute: binding.attribute,\n message: message.success,\n ...(binding.hole === undefined ? {} : { hole: binding.hole }),\n ...(binding.depth === undefined ? {} : { depth: binding.depth }),\n ...(binding.options === undefined ? {} : { options: binding.options }),\n })\n }\n return Result.succeed(out)\n}\n\n/**\n * The bindings that differ between the server's render and the browser's, by\n * element: a Message built from a field the plan does not send would dispatch\n * one Message before boot and another after.\n */\nconst changedBindings = (\n served: ReadonlyArray<Binding>,\n encoded: ReadonlyArray<EncodedBinding>,\n reencoded: ReadonlyArray<EncodedBinding>,\n): ReadonlyArray<string> =>\n served.flatMap((binding, index) =>\n JSON.stringify(encoded[index]) === JSON.stringify(reencoded[index])\n ? []\n : [`${binding.event} binding on ${binding.element}`],\n )\n\n/**\n * The Subscription and Managed Resource entries that would start late under a\n * deferred boot and are not declared deferrable, by the plan or by a part.\n * Foldkit starts every Subscription's stream at boot, so every entry counts; a\n * Managed Resource counts when the Model asks for it.\n */\nconst eagerEntries = <Model, Fields extends Schema.Struct.Fields>(\n config: ResumableConfig<Model>,\n plan: ResumePlan<Model, Fields>,\n model: Model,\n): ReadonlyArray<string> => {\n if (plan.start === 'now') return []\n const declared = (key: string, entry: unknown) =>\n plan.deferrable.includes(key) || plan.parts.some(part => part.deferrable?.(key, entry) === true)\n const subscriptions = Object.entries(config.subscriptions ?? {}).filter(\n ([key, entry]) => !declared(key, entry),\n )\n const resources = Object.entries(config.managedResources ?? {}).filter(([key, entry]) => {\n const asks = (\n entry as { modelToMaybeRequirements?: (model: Model) => unknown }\n ).modelToMaybeRequirements?.(model)\n const active = Option.isOption(asks) ? Option.isSome(asks) : asks !== undefined\n return active && !declared(key, entry)\n })\n return [\n ...subscriptions.map(([key]) => `subscription \"${key}\"`),\n ...resources.map(([key]) => `resource \"${key}\"`),\n ]\n}\n\n/** A page the server rendered against a plan, with its envelope. */\nexport interface RenderedPage {\n /**\n * The rendered application with the envelope on its stamped root, so\n * Foldkit's `injectIntoTemplate` places the page whole: the host owns the\n * template, and the entry never splices markup into it.\n */\n readonly rendered: RenderedApplication\n /** The envelope, as carried on the root, for tests and custom hosts. */\n readonly envelope: string\n /** The head markup of the plan's `meta`, empty without one. */\n readonly meta: string\n /**\n * Each element whose handler for an event is a function, marked `*`: the\n * page cannot answer that event before the live runtime boots.\n */\n readonly unnamed: ReadonlyArray<UnnamedHandler>\n}\n\n/**\n * Renders a page on the server against a resume plan.\n *\n * The application's `init` runs once. Its Model's slice is round-tripped\n * through the plan's Schema and set onto the baseline, which is the Model the\n * browser will start from, and the page is rendered from that Model. Every\n * way the browser could start somewhere else is a `ResumeUnsafe`, whose\n * `reason` names it; the README lists them. The one that matters most: the\n * view rendered from the browser's Model differs from the one rendered from\n * the server's, because it reads a field the plan leaves out. In production\n * Foldkit would rebuild that part of the page silently, so this is the one\n * place it shows.\n */\nconst render = <Model, Fields extends Schema.Struct.Fields, Message = any>(\n config: ResumableConfig<Model, Message>,\n plan: ResumePlan<Model, Fields>,\n options: {\n readonly buildId: string\n readonly url?: string | undefined\n readonly flags?: unknown\n /**\n * Markup for the first paint, given what was rendered, carried as the\n * root's last child: keep it to `<style>`, which the browser drops on\n * hydration. Anything a head owns (`meta`, links) stays with `SSR.page`\n * and `SSR.generate`.\n */\n readonly styles?: Head | undefined\n },\n): Effect.Effect<RenderedPage, RenderError | ResumeUnsafe> =>\n renderMatching(config, plan, options, 'full')\n\nconst renderMatching = <Model, Fields extends Schema.Struct.Fields>(\n config: ResumableConfig<Model>,\n plan: ResumePlan<Model, Fields>,\n options: {\n readonly buildId: string\n readonly url?: string | undefined\n readonly flags?: unknown\n readonly styles?: Head | undefined\n },\n match: RouteMatch,\n): Effect.Effect<RenderedPage, RenderError | ResumeUnsafe> =>\n Effect.gen(function* () {\n yield* loadLazy(config)\n let served: ReturnType<ResumableConfig<Model>['init']> | undefined\n const regions = new Map<string, Region>()\n const duplicates = new Set<string>()\n const servedBindings: Array<Binding> = []\n const browserBindings: Array<Binding> = []\n const inStatic: Array<{ region: string; element: string; event: string }> = []\n const unnamed: Array<UnnamedHandler> = []\n const fallback = fallbackEncoder(plan)\n const capturing = withContext(\n { ...config, init: (...args: ReadonlyArray<unknown>) => (served = config.init(...args)) },\n {\n mode: 'collect',\n regions,\n duplicates,\n bindings: servedBindings,\n fallback,\n wrap: message => message,\n depth: 0,\n region: undefined,\n inStatic,\n unnamed,\n },\n )\n const full = yield* renderToString(capturing as never, options as never)\n if (duplicates.size > 0) {\n return yield* new ResumeUnsafe({\n reason: 'DuplicateStaticRegion',\n message: `two static regions share the id ${[...duplicates].map(id => `\"${id}\"`).join(', ')}: the browser could adopt only one`,\n })\n }\n if (inStatic.length > 0) {\n const found = inStatic.map(\n ({ region, element, event }) => `a ${event} handler on ${element} in \"${region}\"`,\n )\n return yield* new ResumeUnsafe({\n reason: 'BindingInStaticRegion',\n message: `a static region is the server's alone, and these would never run: ${found.join(', ')}. What a Message changes belongs in a Surface`,\n })\n }\n const started = served!\n const commands = started.commands ?? []\n if (commands.length > 0 && plan.boot === undefined) {\n return yield* new ResumeUnsafe({\n reason: 'UndeclaredStartup',\n message: `init returned ${commands.map(command => command.name).join(', ')}, which no browser would run: name them in the plan's boot`,\n })\n }\n\n // Built once: each part's capture reads the whole store it owns.\n const payload = payloadOf(plan, started.model)\n const resumed = browserModelOf(plan, payload)\n if (Result.isFailure(resumed)) {\n return yield* new ResumeUnsafe({ reason: 'UnrestorablePart', message: resumed.failure })\n }\n const browser = resumed.success\n\n const eager = eagerEntries(config, plan, started.model)\n if (eager.length > 0) {\n return yield* new ResumeUnsafe({\n reason: 'EagerStartRequired',\n message: `the plan starts ${plan.start}, and these would start late: ${eager.join(', ')}. Name each in the plan's deferrable, or start now`,\n })\n }\n\n if (servedBindings.length > 0 && plan.surfaces.length === 0) {\n return yield* new ResumeUnsafe({\n reason: 'UndeclaredSurfaces',\n message: `the page has ${servedBindings.length} binding${servedBindings.length === 1 ? '' : 's'} and the plan declares no surfaces, so nothing says which Messages it may dispatch: name them in the plan's surfaces`,\n })\n }\n const uncovered = [\n ...shortfalls(coverage(plan, started.model, browser)),\n ...unlistedBindings(plan, started.model, servedBindings),\n ]\n if (uncovered.length > 0) {\n return yield* new ResumeUnsafe({\n reason: 'Uncovered',\n message: `the plan does not cover what the browser reads:\\n- ${uncovered.join('\\n- ')}`,\n })\n }\n\n // With no `Flags` key in the config, Foldkit writes no Flags script.\n const rendered = yield* renderToString(\n withContext(startingFrom(config, { model: browser }), {\n mode: 'replay',\n regions,\n bindings: browserBindings,\n fallback,\n wrap: message => message,\n depth: 0,\n }) as never,\n options as never,\n )\n const encoded = encodeBindings(plan, servedBindings)\n const reencoded = encodeBindings(plan, browserBindings)\n if (Result.isFailure(encoded)) {\n return yield* new ResumeUnsafe({ reason: 'UnencodableBinding', message: encoded.failure })\n }\n const meta = plan.meta === undefined ? '' : metaMarkup(plan.meta(started.model))\n const differing = [\n ...(full.html.replace(FLAGS_SCRIPT, '') === rendered.html ? [] : ['body']),\n ...HEAD_FIELDS.filter(field => full[field] !== rendered[field]),\n ...(plan.meta === undefined || metaMarkup(plan.meta(browser)) === meta ? [] : ['meta']),\n ...changedBindings(\n servedBindings,\n encoded.success,\n Result.isFailure(reencoded) ? [] : reencoded.success,\n ),\n ]\n if (differing.length > 0) {\n return yield* new ResumeUnsafe({\n reason: 'ViewDependsOnUnsentState',\n message: `the view differs in its ${differing.join(', ')} when rendered from the Model the browser will start from: it reads a field the plan leaves out`,\n })\n }\n const envelope = envelopeOf(plan, payload, {\n ...(options.url === undefined\n ? {}\n : { route: match === 'path' ? pathKey(routeOf(options.url)) : routeOf(options.url) }),\n match,\n bindings: encoded.success,\n events: [\n ...new Set([\n ...servedBindings.map(binding => binding.event),\n ...unnamed.map(handler => handler.event),\n ]),\n ].sort(),\n })\n const styled =\n options.styles === undefined\n ? Result.succeed(rendered.html)\n : withInRoot(rendered.html, options.styles(rendered))\n if (Result.isFailure(styled)) return yield* styled.failure\n return {\n rendered: { ...rendered, html: withEnvelopeAttribute(styled.success, envelope) },\n meta,\n envelope,\n unnamed,\n }\n })\n\n/**\n * What a page adds to its head, given what it rendered: such as a stylesheet\n * of the classes the markup uses (`Style.usedIn` in `foldkit-mixins`). The\n * same shape describes `styles`, which rides in the rendered root instead,\n * for pages whose template the host owns.\n */\nexport type Head = (rendered: RenderedApplication) => string\n\n/**\n * The template with `extra` before its last `</head>`, as a slice for the same\n * reason as the envelope. Nothing to add leaves it as it is; something to add\n * and no `</head>` is refused, rather than dropped.\n */\nconst withHead = (template: string, extra: string): string => {\n if (extra === '') return template\n const at = template.search(/<\\/head>(?![\\s\\S]*<\\/head>)/i)\n if (at === -1) throw new Error('foldkit-ssr: the template has no </head> to put the head in')\n return `${template.slice(0, at)}${extra}${template.slice(at)}`\n}\n\n/**\n * Foldkit fills `canonical` and `og:url` only into a tag the template already\n * has, and leaves the page without one otherwise. A render that sets either\n * and a template without its tag is refused, naming the tag.\n */\nconst FILLED_TAGS = [\n {\n field: 'canonical',\n tag: '<link rel=\"canonical\" href=\"\">',\n at: /<link\\b[^>]*\\brel\\s*=\\s*[\"']?canonical[\"'\\s>]/i,\n },\n {\n field: 'ogUrl',\n tag: '<meta property=\"og:url\" content=\"\">',\n at: /<meta\\b[^>]*\\bproperty\\s*=\\s*[\"']?og:url[\"'\\s>]/i,\n },\n] as const\n\nconst withFilledTags = (template: string, rendered: RenderedApplication): string => {\n const missing = FILLED_TAGS.filter(\n ({ field, at }) => rendered[field] !== undefined && !at.test(template),\n )\n if (missing.length > 0) {\n throw new Error(\n `foldkit-ssr: the view sets ${missing.map(({ field }) => field).join(' and ')}, and the template has no ${missing.map(({ tag }) => tag).join(' or ')} for Foldkit to fill: add it to the template's head`,\n )\n }\n return template\n}\n\n/** The plan's `meta`, then what `head` adds, one line apart. */\nconst headOf = (\n result: { readonly rendered: RenderedApplication; readonly meta: string },\n head: Head | undefined,\n): string => [result.meta, head?.(result.rendered) ?? ''].filter(markup => markup !== '').join('\\n')\n\n/**\n * The page to serve: the rendered application in the template, with the\n * plan's `meta` and `head`'s markup, if any, before `</head>`. The envelope\n * is already in the rendered root, so this is Foldkit's `injectIntoTemplate`\n * with a head, and nothing else.\n */\nconst page = (\n template: string,\n result: { readonly rendered: RenderedApplication; readonly meta: string },\n options: { readonly head?: Head | undefined } = {},\n): string =>\n injectIntoTemplate(\n withHead(withFilledTags(template, result.rendered), headOf(result, options.head)),\n result.rendered,\n )\n\n/** A page generated at build time, and the file a static host serves it from. */\nexport interface GeneratedPage {\n readonly path: string\n readonly file: string\n readonly html: string\n}\n\n/**\n * One generated page per path, in the paths' order: a tuple when the paths\n * are written out, so `const [home, about] = pages` needs no check.\n */\nexport type GeneratedPages<Paths extends ReadonlyArray<string>> = {\n readonly [K in keyof Paths]: GeneratedPage\n}\n\n/** The file a static host serves for a path: `/about` is `about/index.html`. */\nconst fileOf = (path: string): string => {\n const trimmed = path.replace(/^\\/+/, '').replace(/\\/+$/, '')\n if (trimmed === '') return 'index.html'\n return trimmed.endsWith('.html') ? trimmed : `${trimmed}/index.html`\n}\n\nconst xmlText = (text: string): string =>\n text\n .replaceAll('&', '&amp;')\n .replaceAll('<', '&lt;')\n .replaceAll('>', '&gt;')\n .replaceAll('\"', '&quot;')\n .replaceAll(\"'\", '&apos;')\n\n/**\n * A sitemap of the pages a build generated, each at its full address under\n * `origin`, in the order given. `modified`, when a page has it, is any date\n * `Date` reads, written as the UTC day. A path that does not start with `/`,\n * a path given twice, and a date `Date` cannot read are refused: each would\n * make a sitemap a search engine rejects or misreads.\n */\nconst sitemap = (\n pages: ReadonlyArray<{ readonly path: string; readonly modified?: string | undefined }>,\n options: { readonly origin: string },\n): string => {\n const seen = new Set<string>()\n const urls = pages.map(({ path, modified }) => {\n if (!path.startsWith('/')) throw new Error(`SSR.sitemap: \"${path}\" does not start with /`)\n if (seen.has(path)) throw new Error(`SSR.sitemap: \"${path}\" is listed twice`)\n seen.add(path)\n const loc = `<loc>${xmlText(new URL(path, options.origin).href)}</loc>`\n if (modified === undefined) return ` <url>${loc}</url>`\n const at = new Date(modified)\n if (Number.isNaN(at.getTime())) {\n throw new Error(`SSR.sitemap: \"${modified}\", the date of \"${path}\", is not a date`)\n }\n return ` <url>${loc}<lastmod>${at.toISOString().slice(0, 10)}</lastmod></url>`\n })\n return [\n '<?xml version=\"1.0\" encoding=\"UTF-8\"?>',\n '<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">',\n ...urls,\n '</urlset>',\n '',\n ].join('\\n')\n}\n\n/**\n * A `robots.txt` that lets every crawler in, except under `disallow`, and\n * names the sitemap at `sitemap` (default `/sitemap.xml`) under `origin`.\n */\nconst robots = (options: {\n readonly origin: string\n readonly sitemap?: string | undefined\n readonly disallow?: ReadonlyArray<string> | undefined\n}): string =>\n [\n 'User-agent: *',\n 'Allow: /',\n ...(options.disallow ?? []).map(path => `Disallow: ${path}`),\n '',\n `Sitemap: ${new URL(options.sitemap ?? '/sitemap.xml', options.origin).href}`,\n '',\n ].join('\\n')\n\n// Keyed by plan, element and event: a server renders the same page for every\n// request, so one report each is enough to learn which handler to name.\nconst reportedUnnamed = new Set<string>()\n\n/**\n * Reports, once per process, each handler that keeps a page from answering\n * before boot. Only a page that waits to boot is held up: one started\n * `'now'`, with no lazy bundle to load, boots before any event.\n */\nconst reportUnnamed = <Model, Fields extends Schema.Struct.Fields>(\n config: ResumableConfig<Model>,\n plan: ResumePlan<Model, Fields>,\n unnamed: ReadonlyArray<UnnamedHandler>,\n): Effect.Effect<void> =>\n Effect.suspend(() => {\n if (plan.start === 'now' && (config.lazy ?? []).length === 0) return Effect.void\n const first = unnamed.filter(({ element, event }) => {\n const key = JSON.stringify([plan.id, element, event])\n if (reportedUnnamed.has(key)) return false\n reportedUnnamed.add(key)\n return true\n })\n return Effect.forEach(\n first,\n ({ element, event }) => Diagnostics.report(handlerUnnamed(plan.id, element, event)),\n { discard: true },\n )\n })\n\n/**\n * Renders pages at build time, one per path, each as `SSR.render` and\n * `SSR.page` would, to be written as files. `origin` makes each path the full\n * URL a routing application parses. `flags`, when the application has them,\n * gives each path its own.\n *\n * A generated page records its path alone: a static host serves the same file\n * whatever the query, so the browser checks the path and ignores the query. A\n * path with a query or fragment, or two paths that would be one file, are\n * refused.\n */\nconst generate = <\n Model,\n Fields extends Schema.Struct.Fields,\n const Paths extends ReadonlyArray<string>,\n Message = any,\n>(\n config: ResumableConfig<Model, Message>,\n plan: ResumePlan<Model, Fields>,\n options: {\n readonly buildId: string\n readonly template: string\n readonly origin: string\n readonly paths: Paths\n readonly flags?: ((path: string) => unknown) | undefined\n readonly head?: Head | undefined\n },\n): Effect.Effect<GeneratedPages<Paths>, RenderError | ResumeUnsafe> =>\n Effect.gen(function* () {\n const files = new Map<string, string>()\n for (const path of options.paths) {\n if (!path.startsWith('/') || /[?#]/.test(path)) {\n return yield* new ResumeUnsafe({\n reason: 'UngeneratablePath',\n message: `\"${path}\" is not a path a file can be served at: start it with / and leave out any query or fragment`,\n })\n }\n const other = files.get(fileOf(path))\n if (other !== undefined) {\n return yield* new ResumeUnsafe({\n reason: 'UngeneratablePath',\n message: `\"${other}\" and \"${path}\" would both be written to ${fileOf(path)}`,\n })\n }\n files.set(fileOf(path), path)\n }\n const pages = yield* Effect.forEach(options.paths, path =>\n renderMatching(\n config,\n plan,\n {\n buildId: options.buildId,\n url: new URL(path, options.origin).href,\n ...(options.flags === undefined ? {} : { flags: options.flags(path) }),\n },\n 'path',\n ).pipe(\n Effect.tap(result => reportUnnamed(config, plan, result.unnamed)),\n Effect.map(result => ({\n path,\n file: fileOf(path),\n html: page(options.template, result, { head: options.head }),\n })),\n ),\n )\n // One page per path, in order, so the array is the tuple the paths describe.\n return pages as unknown as GeneratedPages<Paths>\n })\n\n/**\n * The server entry for Foldkit's pipeline: the `renderPage` a dev server,\n * a fetch handler, or `handleRequest` calls, and that the `fetch.js` a Foldkit\n * build emits imports from the server entry module, so a resumed page is\n * served by Node and Workers alike.\n *\n * `GET` and `HEAD` render the page against the plan, with the request's URL\n * and, when the application has Flags, `flags(request)`. `POST` goes to\n * `SSR.handle` when the plan has a server fallback, and is answered `400` when\n * the post is unusable. `OPTIONS` is answered `204`, and any other method\n * `405`, each with the methods the entry answers in `allow` (`handleRequest`\n * passes every method through). A render that fails, or a plan the render\n * refuses, is answered `500` with the reason reported (`diagnostics`), never with a page the\n * browser cannot resume. `headers(request)` rides on the `Rendered` result, so\n * Foldkit's `toResponse` sets it over its own on the page: a cache policy, or\n * a CORS answer to a preflight.\n *\n * The page is answered as `Rendered`: the rendered application carries the\n * envelope in its root, so the host injects it into its own template with\n * Foldkit's `injectIntoTemplate`, and a build can generate it with Foldkit's\n * `prerender`. The template, and the container it fills, are the host's:\n * `handleRequest` still classifies static misses and answers `HEAD` without\n * a body.\n *\n * What the page says of itself (`meta`) and per-page `head` markup are\n * written into a template's head, which the host owns here: a plan with\n * `meta` is refused when the entry is made, and served with `SSR.generate`.\n */\nconst entry = <Model, Fields extends Schema.Struct.Fields, Message = any>(\n config: ResumableConfig<Model, Message>,\n plan: ResumePlan<Model, Fields>,\n options: {\n readonly buildId: string\n readonly flags?: ((request: Request) => unknown | PromiseLike<unknown>) | undefined\n readonly headers?: ((request: Request) => HeadersInit) | undefined\n /**\n * A posted form's own services, from its request (who is asking, a\n * client bound to them), for the Commands the fallback runs; where one is\n * also the config's, the request's is used. A render runs no Command, so\n * it reads the request through `flags`. The Layer may neither fail nor\n * need a service: one that refuses who is asking (a session that ended)\n * decides before this, in the host, or dies here into a 500.\n */\n readonly resources?: ((request: Request) => Layer.Layer<never, never, never>) | undefined\n /**\n * The origins a form may be posted from, required by a plan with a server\n * fallback: a post whose `Origin` (which\n * every browser sends on one) is not among them is a 403 before its body\n * is read, so a page elsewhere cannot post as someone signed in here. A\n * form cannot carry a CSRF header; this is its check. A post with no\n * `Origin` or `Origin: null` (a page served with `Referrer-Policy:\n * no-referrer`) is taken when `Sec-Fetch-Site` says `same-origin`. Each must be an origin exactly as\n * a browser sends it (`https://example.com`).\n */\n readonly origins?: ReadonlyArray<string> | undefined\n /**\n * Markup for the first paint, carried as the rendered root's last child.\n * The host owns the template in dynamic serving, so this is where\n * per-page styles go; anything a head owns stays with `SSR.generate`.\n */\n readonly styles?: Head | undefined\n /**\n * Where this request's diagnostics go, with the request: a request\n * answered 500 (`PageFailed`), a handler the page cannot name, and what\n * a posted form's Commands report. The reporter in the Effect context\n * (`Diagnostics.Reporter`) when not given, by default the log.\n */\n readonly diagnostics?:\n | ((diagnostic: Diagnostic, request: Request) => Effect.Effect<void>)\n | undefined\n },\n): EntryModule => {\n if (plan.meta !== undefined) {\n throw new Error(\n `foldkit-ssr: plan \"${plan.id}\" says what the page says of itself (meta), which is written into the template's head, and the template is the host's: serve it with SSR.generate, not SSR.entry`,\n )\n }\n for (const origin of options.origins ?? []) {\n if (!URL.canParse(origin) || new URL(origin).origin !== origin)\n throw new Error(`foldkit-ssr: ${JSON.stringify(origin)} in origins is not an origin`)\n }\n // A post runs `flags`, the config's resources and the post's own, any of\n // which may act as whoever the cookie says posted.\n if (plan.fallback === 'server' && options.origins === undefined) {\n throw new Error(\n `foldkit-ssr: plan \"${plan.id}\" handles posted forms, which run as whoever posted; name the origins a form may be posted from (origins)`,\n )\n }\n // Required above for every plan that takes a post, the only reader of it.\n const origins = new Set(options.origins ?? [])\n const allow = plan.fallback === 'server' ? 'GET, HEAD, POST, OPTIONS' : 'GET, HEAD, OPTIONS'\n // Deleted and appended rather than set, which would keep one `set-cookie` of several.\n const merge = (response: Response, extra: Headers): Response => {\n for (const name of new Set(extra.keys())) response.headers.delete(name)\n extra.forEach((value, name) => response.headers.append(name, value))\n return response\n }\n const answer = async (request: Request): Promise<EntryResult> => {\n const method = request.method.toUpperCase()\n const posting = method === 'POST' && plan.fallback === 'server'\n const { diagnostics } = options\n const reporting = reportingTo(\n diagnostics === undefined ? undefined : diagnostic => diagnostics(diagnostic, request),\n )\n const headersOf = options.headers\n let extra: Headers | undefined\n if (headersOf !== undefined) {\n try {\n extra = new Headers(headersOf(request))\n } catch (error) {\n await Effect.runPromise(\n reporting(Diagnostics.report(pageFailed(request.url, Cause.die(error)))),\n )\n return Responded(plainText(500, 'The page could not be rendered.'))\n }\n }\n const responded = (response: Response): EntryResult =>\n Responded(extra === undefined ? response : merge(response, extra))\n if (method === 'OPTIONS')\n return responded(new Response(null, { status: 204, headers: { allow } }))\n if (method !== 'GET' && method !== 'HEAD' && !posting) {\n return responded(new Response(null, { status: 405, headers: { allow } }))\n }\n if (posting && !postedFrom(request, origins)) {\n return responded(plainText(403, 'The form was not posted from this site.'))\n }\n const flagsOf = options.flags\n const styled = options.styles === undefined ? {} : { styles: options.styles }\n // `Effect.result` would miss a defect, such as a view that throws, and a\n // `flags` that throws or rejects is not in the Effect at all: both would\n // reject `renderPage` instead of answering it.\n const exit = await Effect.runPromiseExit(\n Effect.gen(function* () {\n const flags =\n flagsOf === undefined ? undefined : yield* Effect.tryPromise(async () => flagsOf(request))\n const flagged = flagsOf === undefined ? {} : { flags }\n if (posting) {\n return yield* handle(request, config, plan, {\n buildId: options.buildId,\n ...flagged,\n ...styled,\n ...(options.resources === undefined ? {} : { resources: options.resources(request) }),\n })\n }\n return yield* render(config, plan, {\n buildId: options.buildId,\n url: request.url,\n ...flagged,\n ...styled,\n })\n }).pipe(reporting),\n )\n if (Exit.isFailure(exit)) {\n const refused = Cause.findErrorOption(exit.cause).pipe(\n Option.filter(error => error instanceof FallbackRefused),\n )\n if (Option.isSome(refused)) {\n return responded(plainText(400, `The form could not be handled: ${refused.value.message}`))\n }\n await Effect.runPromise(reporting(Diagnostics.report(pageFailed(request.url, exit.cause))))\n return responded(plainText(500, 'The page could not be rendered.'))\n }\n await Effect.runPromise(reporting(reportUnnamed(config, plan, exit.value.unnamed)))\n // No `headers` key without custom headers: a `Rendered` that carries none\n // stays generatable as a static file.\n return extra === undefined\n ? Rendered(exit.value.rendered)\n : Rendered(exit.value.rendered, { headers: extra })\n }\n return { renderPage: answer }\n}\n\n/**\n * Whether a post came from one of `origins`, by what the browser sends and no\n * page or form can set: its `Origin`, or, where that is missing or opaque\n * (`Origin: null`, which a page served with `Referrer-Policy: no-referrer`\n * sends on its own forms), its Fetch Metadata `Sec-Fetch-Site`. A post with\n * neither header is refused. `foldkit-auth`'s resolver decides the same way.\n */\nconst postedFrom = (request: Request, origins: ReadonlySet<string>): boolean => {\n const origin = request.headers.get('origin')\n return origin === null || origin === 'null'\n ? request.headers.get('sec-fetch-site') === 'same-origin'\n : origins.has(origin)\n}\n\nconst plainText = (status: number, body: string): Response =>\n new Response(body, { status, headers: { 'content-type': 'text/plain; charset=utf-8' } })\n\n/** How a form's Message is written into the page for the fallback, when the plan has one. */\nconst fallbackEncoder = <Model, Fields extends Schema.Struct.Fields>(\n plan: ResumePlan<Model, Fields>,\n): ((message: unknown) => string | undefined) | undefined => {\n if (plan.fallback !== 'server' || plan.Message === undefined) return undefined\n const encode = Schema.encodeUnknownResult(plan.Message as Schema.Codec<unknown, unknown>)\n return message => {\n const encoded = encode(message)\n return Result.isFailure(encoded) ? undefined : JSON.stringify(encoded.success)\n }\n}\n\n/** Why a posted form was not handled: the request, not the page or the plan, is at fault. */\nexport class FallbackRefused extends Schema.TaggedError<FallbackRefused>()('FallbackRefused', {\n reason: Schema.Literals(['Missing', 'Unreadable', 'Invalid', 'Unlisted', 'NoFallback']),\n message: Schema.String,\n}) {}\n\nconst refuseFallback = (reason: FallbackRefused['reason'], message: string) =>\n Effect.fail(new FallbackRefused({ reason, message }))\n\n/** A Command as Foldkit runs it: named, with the Effect that yields its Message. */\ninterface RunnableCommand {\n readonly name: string\n readonly effect: Effect.Effect<unknown, unknown, any>\n}\n\nconst isRunnable = (command: unknown): command is RunnableCommand =>\n typeof command === 'object' &&\n command !== null &&\n 'effect' in command &&\n Effect.isEffect(command.effect)\n\n/**\n * The most Messages and Commands one post may run. The browser's loop runs\n * for the life of the page, so a Command that schedules itself again, a tick\n * or a poll, is ordinary there; on the server it would hold the request open\n * for ever.\n */\nconst MAX_STEPS = 100\n\n/**\n * Foldkit's loop, once, on the server: `update` for each Message, then each\n * returned Command run under the config's `resources`, its Message folded\n * back through `update`, until no Command remains.\n */\nconst fold = <Model>(\n config: ResumableConfig<Model>,\n post: Context.Context<never>,\n model: Model,\n messages: ReadonlyArray<unknown>,\n commands: ReadonlyArray<unknown>,\n): Effect.Effect<Model> =>\n Effect.gen(function* () {\n let current = model\n const pending = [...messages]\n const queue = [...commands]\n let steps = 0\n let last = ''\n while (pending.length > 0 || queue.length > 0) {\n if (++steps > MAX_STEPS) {\n return yield* Effect.die(\n new Error(\n `SSR.handle: the post did not settle within ${MAX_STEPS} Messages and Commands; the last Command run was \"${last}\". A Command that schedules itself again cannot run on the server`,\n ),\n )\n }\n if (pending.length > 0) {\n const next = config.update(current, pending.shift()) as {\n readonly model: Model\n readonly commands?: ReadonlyArray<unknown> | undefined\n }\n current = next.model\n queue.push(...(next.commands ?? []))\n continue\n }\n const command = queue.shift()\n if (!isRunnable(command)) {\n return yield* Effect.die(\n new Error(`SSR.handle: a Command has no Effect to run: ${JSON.stringify(command)}`),\n )\n }\n // A Command that fails would crash Foldkit's runtime; here it is a defect\n // the entry answers with 500, since the config declares its requirements.\n // The post's own services first, so one it shares with the config's is its own.\n const own = Effect.provide(command.effect, post)\n const provided: Effect.Effect<unknown, unknown, never> =\n config.resources === undefined\n ? (own as Effect.Effect<unknown, unknown, never>)\n : (Effect.provide(own, config.resources) as Effect.Effect<unknown, unknown, never>)\n last = command.name\n const result = yield* Effect.orDie(provided)\n // A Command fired and forgotten yields no Message, and folds nothing in.\n if (result !== undefined && result !== null) pending.push(result)\n }\n return current\n })\n\n/** The Model `init` gives this request, as the server's render would start from. */\nconst startOf = <Model>(\n config: ResumableConfig<Model>,\n options: { readonly url?: string | undefined; readonly flags?: unknown },\n): Effect.Effect<ReturnType<ResumableConfig<Model>['init']>, RenderError> =>\n Effect.gen(function* () {\n let started: ReturnType<ResumableConfig<Model>['init']> | undefined\n yield* renderToString(\n {\n ...config,\n init: (...args: ReadonlyArray<unknown>) => (started = config.init(...args)),\n } as never,\n { buildId: 'x', ...options } as never,\n )\n return started!\n })\n\n/**\n * Answers a form posted by a page rendered with `fallback: 'server'`: the\n * posted Message is decoded through the plan's Message Schema, with posted\n * fields of the same names as its own overriding them, and must be one the\n * Surfaces active for the request's Model may send. The server then rebuilds\n * the Model the browser had, `init` and then the plan's `boot` with every\n * Command it leads to, runs `update` with the Message and every Command that\n * follows, and renders the result as a fresh page.\n */\nconst handle = <Model, Fields extends Schema.Struct.Fields, Message = any>(\n request: Request,\n config: ResumableConfig<Model, Message>,\n plan: ResumePlan<Model, Fields>,\n options: {\n readonly buildId: string\n readonly flags?: unknown\n readonly styles?: Head | undefined\n /**\n * This post's own services, beside the config's `resources`: who is\n * asking, a client bound to them. Built once for the post; where both\n * provide a service, the post's is the one its Commands get.\n */\n readonly resources?: Layer.Layer<never, never, never> | undefined\n },\n): Effect.Effect<RenderedPage, RenderError | ResumeUnsafe | FallbackRefused> =>\n // The post's resources live as long as the post.\n Effect.scoped(\n Effect.gen(function* () {\n if (plan.fallback !== 'server' || plan.Message === undefined) {\n return yield* refuseFallback('NoFallback', `plan \"${plan.id}\" has no server fallback`)\n }\n const form = yield* Effect.tryPromise({\n try: () => request.formData(),\n catch: () =>\n new FallbackRefused({ reason: 'Unreadable', message: 'the body is not a form' }),\n })\n const posted = form.get(FALLBACK_FIELD)\n if (typeof posted !== 'string') {\n return yield* refuseFallback('Missing', `the form carries no ${FALLBACK_FIELD} field`)\n }\n let raw: unknown\n try {\n raw = JSON.parse(posted)\n } catch {\n return yield* refuseFallback('Unreadable', `${FALLBACK_FIELD} is not JSON`)\n }\n const decode = Schema.decodeUnknownResult(plan.Message as Schema.Codec<unknown, unknown>)\n const invalid = (failure: { readonly message: string }) =>\n refuseFallback('Invalid', `the posted Message does not decode: ${failure.message}`)\n // The posted Message is decoded before anything reads it.\n const written = decode(raw)\n if (Result.isFailure(written)) return yield* invalid(written.failure)\n // A form inside a placement posts the parent's Message; the fields it\n // names sit `depth` wrappers down.\n const postedDepth = form.get(FALLBACK_DEPTH_FIELD) ?? '0'\n if (typeof postedDepth !== 'string' || !/^\\d{1,2}$/.test(postedDepth)) {\n return yield* refuseFallback('Unreadable', `${FALLBACK_DEPTH_FIELD} is not a depth`)\n }\n const override = (value: unknown, down: number): unknown => {\n if (typeof value !== 'object' || value === null) return value\n const copy: Record<string, unknown> = { ...value }\n if (down > 0) {\n copy.message = override(copy.message, down - 1)\n return copy\n }\n form.forEach((field, name) => {\n if (name !== FALLBACK_FIELD && Object.hasOwn(copy, name) && typeof field === 'string') {\n copy[name] = field\n }\n })\n return copy\n }\n // The fields typed into the form, set into the Message and decoded again.\n const decoded = decode(override(raw, Number(postedDepth)))\n if (Result.isFailure(decoded)) return yield* invalid(decoded.failure)\n const message = decoded.success\n const started = yield* startOf(config, { url: request.url, ...options })\n const allowed = allowedTags(plan, started.model)\n if (!allowed.has(tagOf(message))) {\n return yield* refuseFallback(\n 'Unlisted',\n `the posted ${tagOf(message)} is not one an active Surface lists in its messages`,\n )\n }\n // As the browser got here: `init` on the server, then the plan's `boot`\n // at hydration, and only then the user's Message. `init`'s own Commands\n // never run in the browser, so they do not run here.\n const boot = (plan.boot?.(started.model) as ReadonlyArray<unknown> | undefined) ?? []\n const post =\n options.resources === undefined ? Context.empty() : yield* Layer.build(options.resources)\n const booted = yield* fold(config, post, started.model, [], boot)\n const model = yield* fold(config, post, booted, [message], [])\n return yield* render(startingFrom(config, { model }) as ResumableConfig<Model>, plan, {\n buildId: options.buildId,\n url: request.url,\n ...(options.styles === undefined ? {} : { styles: options.styles }),\n })\n }),\n )\n\nexport const SSR = {\n plan,\n envelope,\n resume,\n render,\n page,\n hydrate: Client.hydrate,\n inspect,\n static: staticRegion,\n serving,\n generate,\n entry,\n handle,\n serializeJsonScript,\n sitemap,\n robots,\n requestContext,\n}\n\nexport type { RequestContext } from './requestContext.js'\n\nexport {\n FOLDKIT_APP_ATTRIBUTE,\n META_ATTRIBUTE,\n RESUME_ATTRIBUTE,\n STATIC_ATTRIBUTE,\n Resume,\n ResumeRefused,\n BINDING_ATTRIBUTE,\n FALLBACK_FIELD,\n SLOT_ATTRIBUTE,\n UNTIL_LIMIT_MS,\n metaMarkup,\n type DecodedBinding,\n type Loadable,\n type Meta,\n type PlanSurface,\n type ResumableBuilder,\n type ResumableConfig,\n type ResumePart,\n type ResumePlan,\n type Start,\n type UnnamedHandler,\n type BundleUnloaded,\n type HandlerUnnamed,\n type PageContained,\n type PageFailed,\n type SsrDiagnostic,\n type StaticRegionMissing,\n Diagnostics,\n type Diagnostic,\n type ReportDiagnostic,\n} from './client.js'\n"],"mappings":"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"}
@@ -0,0 +1,69 @@
1
+ import { Result, Schema } from "effect";
2
+ /**
3
+ * A binding as the envelope carries it: Foldkit's attribute (`OnSubmit`,
4
+ * `OnBlur`), whose tag says what its handler does beside dispatching; the
5
+ * Message, encoded through the application's Message Schema (for a hole, with
6
+ * the hole filled by a placeholder); the fields the event fills, `depth`
7
+ * placement wrappers down; and the attribute's options. Its ordinal is its
8
+ * index.
9
+ */
10
+ interface EncodedBinding {
11
+ readonly attribute: string;
12
+ readonly message: unknown;
13
+ readonly hole?: ReadonlyArray<string>;
14
+ readonly depth?: number;
15
+ readonly options?: unknown;
16
+ }
17
+ /**
18
+ * The page's list of bindings, read as untrusted input: each entry checked,
19
+ * and only its known keys kept, or the reason the list is refused. Checked by
20
+ * hand rather than through a Schema, which at a thousand rows took most of a
21
+ * frame for a shape this plain; the Message inside each entry is still decoded
22
+ * through the application's Schema by `decodeBindings`.
23
+ */
24
+ declare const readBindings: (value: unknown) => Result.Result<ReadonlyArray<EncodedBinding>, string>;
25
+ /** A binding decoded from the page: its Message is one of the application's. */
26
+ interface DecodedBinding {
27
+ readonly attribute: string;
28
+ readonly event: string;
29
+ readonly message: unknown;
30
+ readonly hole?: ReadonlyArray<string> | undefined;
31
+ readonly depth?: number | undefined;
32
+ readonly options?: unknown;
33
+ }
34
+ /**
35
+ * The page's bindings, decoded through the application's Message Schema, and
36
+ * every marker in `root` checked against them. A page whose markers name a
37
+ * binding it does not carry, or whose entry is not one of the application's
38
+ * Messages, is refused whole, with the reason.
39
+ */
40
+ declare const decodeBindings: (Message: Schema.Top | undefined, encoded: ReadonlyArray<EncodedBinding>, root: ParentNode, allowed: ReadonlySet<string>) => Result.Result<ReadonlyArray<DecodedBinding>, string>;
41
+ /**
42
+ * What the markers make of one event: the Messages its bindings dispatch, in
43
+ * the order the live page would, and, when the walk met a handler the page
44
+ * could not name, that element. An answer with `unnamed` is incomplete: the
45
+ * live page would do more than its Messages say.
46
+ */
47
+ interface Answer {
48
+ readonly event: Event;
49
+ readonly messages: ReadonlyArray<unknown>;
50
+ readonly unnamed?: Element | undefined;
51
+ }
52
+ interface ListenOptions {
53
+ readonly bindings: ReadonlyArray<DecodedBinding>;
54
+ readonly onAnswer: (answer: Answer) => void;
55
+ /**
56
+ * Every event the page's markers name, as the envelope lists them. Given,
57
+ * `listen` needs no pass over the page to find the events a marker names
58
+ * with `*` alone; without it, it reads every element's attributes, which on
59
+ * a large page is most of its cost.
60
+ */
61
+ readonly events?: Iterable<string> | undefined;
62
+ }
63
+ /**
64
+ * Listens at `root` for every event the bindings name, and answers each from
65
+ * the markers. Returns what removes the listeners.
66
+ */
67
+ declare const listen: (root: Element, options: ListenOptions) => (() => void);
68
+ export { decodeBindings as a, ListenOptions as i, DecodedBinding as n, listen as o, EncodedBinding as r, readBindings as s, Answer as t };
69
+ //# sourceMappingURL=listen-zNd0IIAT.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"listen-zNd0IIAT.d.ts","names":[],"sources":["../src/listen.ts"],"mappings":";;;;;;;;;UA0BiB;WACN;WACA;WACA,OAAO;WACP;WACA;;;;;;;;;cAaE,eAAY,mBAEtB,OAAO,OAAO,cAAc;;UA+Bd;WACN;WACA;WACA;WACA,OAAO;WACP;WACA;;;;;;;;cASE,iBAAc,SAChB,OAAO,iBAAe,SACtB,cAAc,iBAAe,MAChC,YAAU,SACP,wBACR,OAAO,OAAO,cAAc;;;;;;;UAoHd;WACN,OAAO;WACP,UAAU;WACV,UAAU;;UAGJ;WACN,UAAU,cAAc;WACxB,WAAW,QAAQ;;;;;;;WAOnB,SAAS;;;;;;cAOP,SAAM,MAAU,SAAO,SAAW"}
@@ -0,0 +1,2 @@
1
+ import { a as decodeBindings, i as ListenOptions, n as DecodedBinding, o as listen, r as EncodedBinding, s as readBindings, t as Answer } from "./listen-zNd0IIAT.js";
2
+ export { Answer, DecodedBinding, EncodedBinding, ListenOptions, decodeBindings, listen, readBindings };