@earendil-works/chord 1.5.0 → 1.5.1

package/dist/node/surfaces/published.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"published.js","sourceRoot":"","sources":["../../../src/node/surfaces/published.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,sHAAsH;AACtH,oHAAoH;AACpH,oHAAoH;AACpH,sHAAsH;AACtH,mHAAmH;AACnH,QAAQ;AAER,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAIzC,OAAO,EAAE,gBAAgB,EAAkB,MAAM,yBAAyB,CAAC;AAE3E,OAAO,EAAE,SAAS,EAAoB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,EAAmB,MAAM,aAAa,CAAC;AAEvE,mHAAmH;AACnH,MAAM,SAAS,GAAG,CAAC,CAAC;AAcpB,4CAA4C;AAC5C,MAAM,UAAU,GAAG,uCAAuC,CAAC;AAE3D,yCAAyC;AACzC,MAAM,OAAO,gBAAgB;IACnB,QAAQ,CAAc;IACtB,KAAK,CAAS;IACd,OAAO,CAAS;IAChB,KAAK,CAAS;IACd,QAAQ,CAAU;IAClB,KAAK,CAAU;IACxB,+CAA+C;IACtC,QAAQ,GAAG,IAAI,GAAG,EAAqB,CAAC;IACjD,yEAAyE;IAChE,KAAK,GAAsC,EAAE,CAAC;IACvD,IAAI,CAAwB;IAE5B,YAAY,OAAoB,EAAE,IAAY,EAAE,MAAc,EAAE,IAAY,EAAE,OAAgB,EAAE,IAAa;QAC5G,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,6CAA6C;IAC7C,IAAI,GAAG;QACN,OAAO,IAAI,CAAC,IAAK,CAAC;IACnB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK,CAAC,OAAgB;QAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,4DAA4D;IAC5D,IAAI,CAAC,IAAY;QAChB,KAAK,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC;YAC7D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YAC3C,IAAI,KAAK,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC;QACvC,CAAC;QACD,OAAO,SAAS,CAAC;IAClB,CAAC;IAED;;;OAGG;IACH,IAAI,CAAC,IAAY;QAChB,OAAO;YACN,IAAI;YACJ,KAAK,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YACnB,MAAM,EAAE,KAAK,EAAE,MAAa,EAAE,OAAgB,EAAE,EAAE;gBACjD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;gBAC3F,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;gBACtE,MAAM,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;gBAC9D,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACjC,MAAM,OAAO,GAAG;oBACf,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC;oBAChF,OAAO,EAAE,KAAK;yBACZ,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,MAAM,CAAC;yBACrF,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC;oBAC3B,OAAO,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;iBAC1E,CAAC;gBACF,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;YAC9E,CAAC;SACD,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,QAAQ,CAAC,OAAgC;QACxC,MAAM,MAAM,GAAoB,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAqB,CAAC;QAC1C,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,OAAO,EAAE,CAAC;YACzC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;gBACvE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAClG,SAAS;YACV,CAAC;YACD,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;YAChF,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,IAAI,KAAK,SAAS;gBAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACrD,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACpF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC/B,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,SAAS;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACtD,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;QAChB,OAAO,MAAM,CAAC;IACf,CAAC;IAED;;;OAGG;IACH,MAAM;QACL,MAAM,KAAK,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC5C,MAAM,OAAO,GAAmC,EAAE,CAAC;QACnD,MAAM,QAAQ,GAAa,EAAE,CAAC;QAC9B,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnE,6GAA6G;YAC7G,0BAA0B;YAC1B,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,UAAU,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;YACzE,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,KAAK,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACrF,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;iBACpE,CAAC;gBACL,oFAAoF;gBACpF,MAAM,KAAK,GAAG,GAAG,IAAI,IAAI,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC;gBAC3F,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/D,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;YAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC5B,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,OAAO,UAAU,KAAK,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;YACpG,CAAC;QACF,CAAC;QACD,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/B,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC1E,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,WAAW,IAAI,KAAK,CAAC;QAChD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC5E,OAAO,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,CAAC;IAC9E,CAAC;CACD","sourcesContent":["// A client kind's published scripts (slice 11 §1, decisions \"Slice 11, P3\" and \"P5\"): what the server serves of the\n// kind's plugins, as files under the surface's prefix, and the set its scripts object shows. Each plugin's facet is a\n// script that registers itself (`<prefix>plugin/<plugin>.<digest>.js`, its stylesheet beside it), the whole set one\n// combined file named by its hash (`<prefix>plugins.<hash>.js`), assets under `<prefix>assets/`; all named by their\n// content, served forever. A rollout shipping the kind publishes a new set (a plugin whose new build failed keeps its\n// last script) without waiting for clients; the files of the last few sets stay served for clients that still load\n// them.\n\nimport { createHash } from \"node:crypto\";\nimport type { Context } from \"../../context/index.ts\";\nimport type { Principal } from \"../../data/index.ts\";\nimport type { Host, PluginFailure } from \"../../host/index.ts\";\nimport { registeredSource, type ScriptSet } from \"../../surfaces/index.ts\";\nimport type { Built, PluginScript, Plugins, RolloutStep } from \"../plugins/index.ts\";\nimport { publishTo, type SurfaceName } from \"./current.ts\";\nimport { CSS, JAVASCRIPT, mimeOf, type ServedFile } from \"./served.ts\";\n\n/** How many sets' files stay served: the current one and the few before it, for clients loading them meanwhile. */\nconst KEPT_SETS = 4;\n\n/** One plugin's published script: its digest, its registered text, its stylesheet. */\n/**\n * One plugin's published script: its digest, its registered text, its stylesheet and assets (kept with the script: a\n * plugin whose next build fails keeps all three).\n */\ntype Published = {\n\treadonly digest: string;\n\treadonly text: string;\n\treadonly css: string | undefined;\n\treadonly assets: readonly { readonly name: string; readonly bytes: Uint8Array }[];\n};\n\n/** A script's inline source map comment. */\nconst SOURCE_MAP = /\\n\\/\\/# sourceMappingURL=data:[^\\n]*/g;\n\n/** A client kind's published scripts. */\nexport class PublishedScripts<P extends Principal> {\n\treadonly #surface: SurfaceName;\n\treadonly #kind: string;\n\treadonly #prefix: string;\n\treadonly #base: string;\n\treadonly #plugins: Plugins;\n\treadonly #host: Host<P>;\n\t/** The published script of each plugin now. */\n\treadonly #current = new Map<string, Published>();\n\t/** The files of the last `KEPT_SETS` sets, newest last, each by path. */\n\treadonly #sets: ReadonlyMap<string, ServedFile>[] = [];\n\t#set: ScriptSet | undefined;\n\n\tconstructor(surface: SurfaceName, kind: string, prefix: string, base: string, plugins: Plugins, host: Host<P>) {\n\t\tthis.#surface = surface;\n\t\tthis.#kind = kind;\n\t\tthis.#prefix = prefix;\n\t\tthis.#base = base;\n\t\tthis.#plugins = plugins;\n\t\tthis.#host = host;\n\t}\n\n\t/** The set published now (after `start`). */\n\tget set(): ScriptSet {\n\t\treturn this.#set!;\n\t}\n\n\t/**\n\t * Takes the kind's current set as the first one (its plugins' facets of the kind built on first use), after the\n\t * server's load (the surface's build publishes it). The plugins whose build failed.\n\t */\n\tasync start(context: Context): Promise<readonly PluginFailure[]> {\n\t\treturn this.#publish(await this.#plugins.scripts(this.#kind, context));\n\t}\n\n\t/** A published file by its path, from the last few sets. */\n\tfile(path: string): ServedFile | undefined {\n\t\tfor (let index = this.#sets.length - 1; index >= 0; index--) {\n\t\t\tconst found = this.#sets[index]!.get(path);\n\t\t\tif (found !== undefined) return found;\n\t\t}\n\t\treturn undefined;\n\t}\n\n\t/**\n\t * The rollout step publishing the kind's current set as the rollout applied its build: one \"host\" named `name`, its\n\t * report the plugins whose new build failed (they keep their last script, and stay dirty). Clients are not waited for.\n\t */\n\tstep(name: string): RolloutStep {\n\t\treturn {\n\t\t\tname,\n\t\t\tkinds: [this.#kind],\n\t\t\treload: async (_built: Built, context: Context) => {\n\t\t\t\tconst before = new Map([...this.#current].map(([plugin, { digest }]) => [plugin, digest]));\n\t\t\t\tconst failed = this.#publish(this.#plugins.current(this.#kind) ?? []);\n\t\t\t\tawait publishTo(this.#host, this.#surface, this.set, context);\n\t\t\t\tconst after = [...this.#current];\n\t\t\t\tconst plugins = {\n\t\t\t\t\tadded: after.filter(([plugin]) => !before.has(plugin)).map(([plugin]) => plugin),\n\t\t\t\t\tchanged: after\n\t\t\t\t\t\t.filter(([plugin, { digest }]) => before.has(plugin) && before.get(plugin) !== digest)\n\t\t\t\t\t\t.map(([plugin]) => plugin),\n\t\t\t\t\tremoved: [...before.keys()].filter((plugin) => !this.#current.has(plugin)),\n\t\t\t\t};\n\t\t\t\treturn { hosts: [{ host: name, report: { plugins, failed, objects: [] } }] };\n\t\t\t},\n\t\t};\n\t}\n\n\t/**\n\t * Takes `scripts` (the kind's complete set) as the current one: a failed build keeps its plugin's last script; its\n\t * files kept with the last few sets'. The plugins whose build failed.\n\t */\n\t#publish(scripts: readonly PluginScript[]): readonly PluginFailure[] {\n\t\tconst failed: PluginFailure[] = [];\n\t\tconst next = new Map<string, Published>();\n\t\tfor (const { plugin, built } of scripts) {\n\t\t\tif (built.kind === \"script\") {\n\t\t\t\tconst text = registeredSource(plugin.name, built.digest, built.source);\n\t\t\t\tnext.set(plugin.name, { digest: built.digest, text, css: built.css?.text, assets: built.assets });\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\tfailed.push({ plugin: plugin.name, error: new Error(built.errors.join(\"\\n\")) });\n\t\t\tconst kept = this.#current.get(plugin.name);\n\t\t\tif (kept !== undefined) next.set(plugin.name, kept);\n\t\t}\n\t\tthis.#current.clear();\n\t\tfor (const [name, each] of [...next].sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)))\n\t\t\tthis.#current.set(name, each);\n\t\tconst { set, files } = this.#files();\n\t\tthis.#sets.push(files);\n\t\tif (this.#sets.length > KEPT_SETS) this.#sets.shift();\n\t\tthis.#set = set;\n\t\treturn failed;\n\t}\n\n\t/**\n\t * The set of the current scripts and its files: each script (its source map inline), stylesheet and asset, and the\n\t * combined file (without source maps: a browser reads only one per file, so they would be bytes for nothing).\n\t */\n\t#files(): { set: ScriptSet; files: Map<string, ServedFile> } {\n\t\tconst files = new Map<string, ServedFile>();\n\t\tconst entries: ScriptSet[\"plugins\"][number][] = [];\n\t\tconst combined: string[] = [];\n\t\tfor (const [name, { digest, text, css, assets }] of this.#current) {\n\t\t\t// A plugin name (`@scope/name`) as one path segment, its slash a tilde: the set's URLs are looked up as they\n\t\t\t// are, never parsed back.\n\t\t\tconst stem = `${this.#prefix}plugin/${name.replace(\"/\", \"~\")}.${digest}`;\n\t\t\tfiles.set(`${stem}.js`, { mime: JAVASCRIPT, bytes: new TextEncoder().encode(text) });\n\t\t\tif (css === undefined) entries.push({ name, digest, url: `${stem}.js` });\n\t\t\telse {\n\t\t\t\t// Named by its own content too: a change of only the CSS keeps the script's digest.\n\t\t\t\tconst style = `${stem}.${createHash(\"sha256\").update(css).digest(\"hex\").slice(0, 16)}.css`;\n\t\t\t\tfiles.set(style, { mime: CSS, bytes: new TextEncoder().encode(css) });\n\t\t\t\tentries.push({ name, digest, url: `${stem}.js`, css: style });\n\t\t\t}\n\t\t\tcombined.push(text.replace(SOURCE_MAP, \"\"));\n\t\t\tfor (const asset of assets) {\n\t\t\t\tfiles.set(`${this.#prefix}assets/${asset.name}`, { mime: mimeOf(asset.name), bytes: asset.bytes });\n\t\t\t}\n\t\t}\n\t\tconst body = combined.join(\"\");\n\t\tconst hash = createHash(\"sha256\").update(body).digest(\"hex\").slice(0, 16);\n\t\tconst url = `${this.#prefix}plugins.${hash}.js`;\n\t\tfiles.set(url, { mime: JAVASCRIPT, bytes: new TextEncoder().encode(body) });\n\t\treturn { set: { base: this.#base, combined: url, plugins: entries }, files };\n\t}\n}\n"]}

package/dist/node/surfaces/served.d.ts

@@ -0,0 +1,15 @@
+import type { HttpResponse } from "../http/index.ts";
+/** A file the server serves: its type and bytes. */
+export type ServedFile = {
+    readonly mime: string;
+    readonly bytes: Uint8Array;
+};
+/** A served file's response, cached by the browser forever (its path names its content); 404 for none. */
+export declare function served(found: ServedFile | undefined): HttpResponse;
+/** The type of a script. */
+export declare const JAVASCRIPT = "text/javascript; charset=utf-8";
+/** The type of a stylesheet. */
+export declare const CSS = "text/css; charset=utf-8";
+/** The type of a built asset, by extension. */
+export declare function mimeOf(path: string): string;
+//# sourceMappingURL=served.d.ts.map

package/dist/node/surfaces/served.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"served.d.ts","sourceRoot":"","sources":["../../../src/node/surfaces/served.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,oDAAoD;AACpD,MAAM,MAAM,UAAU,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE/E,0GAA0G;AAC1G,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,SAAS,GAAG,YAAY,CAWlE;AAED,4BAA4B;AAC5B,eAAO,MAAM,UAAU,mCAAmC,CAAC;AAE3D,gCAAgC;AAChC,eAAO,MAAM,GAAG,4BAA4B,CAAC;AAE7C,+CAA+C;AAC/C,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C"}

package/dist/node/surfaces/served.js

@@ -0,0 +1,42 @@
+// The files the surfaces serve (slice 11 §1, §4): base bundles, plugin scripts, stylesheets and assets, each named by
+// its content and so cached by clients forever; their types.
+import { extname } from "node:path";
+/** A served file's response, cached by the browser forever (its path names its content); 404 for none. */
+export function served(found) {
+    if (found === undefined)
+        return { kind: "error", status: 404 };
+    const { mime, bytes } = found;
+    return {
+        kind: "bytes",
+        mime,
+        size: bytes.length,
+        read: async (offset, length) => bytes.subarray(offset, offset + length),
+        // Overrides the baseline's `no-store` for these files only.
+        headers: { "Cache-Control": "private, max-age=31536000, immutable" },
+    };
+}
+/** The type of a script. */
+export const JAVASCRIPT = "text/javascript; charset=utf-8";
+/** The type of a stylesheet. */
+export const CSS = "text/css; charset=utf-8";
+/** The type of a built asset, by extension. */
+export function mimeOf(path) {
+    return ASSET_TYPES[extname(path).slice(1).toLowerCase()] ?? "application/octet-stream";
+}
+/** The types of the assets builds collect, by extension. */
+const ASSET_TYPES = {
+    svg: "image/svg+xml",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    woff: "font/woff",
+    woff2: "font/woff2",
+    ttf: "font/ttf",
+    wasm: "application/wasm",
+    json: "application/json",
+    css: CSS,
+    js: JAVASCRIPT,
+};
+//# sourceMappingURL=served.js.map

package/dist/node/surfaces/served.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"served.js","sourceRoot":"","sources":["../../../src/node/surfaces/served.ts"],"names":[],"mappings":"AAAA,sHAAsH;AACtH,6DAA6D;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,0GAA0G;AAC1G,MAAM,UAAU,MAAM,CAAC,KAA6B;IACnD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAC/D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC;IAC9B,OAAO;QACN,IAAI,EAAE,OAAO;QACb,IAAI;QACJ,IAAI,EAAE,KAAK,CAAC,MAAM;QAClB,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC;QACvE,4DAA4D;QAC5D,OAAO,EAAE,EAAE,eAAe,EAAE,sCAAsC,EAAE;KACpE,CAAC;AACH,CAAC;AAED,4BAA4B;AAC5B,MAAM,CAAC,MAAM,UAAU,GAAG,gCAAgC,CAAC;AAE3D,gCAAgC;AAChC,MAAM,CAAC,MAAM,GAAG,GAAG,yBAAyB,CAAC;AAE7C,+CAA+C;AAC/C,MAAM,UAAU,MAAM,CAAC,IAAY;IAClC,OAAO,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,0BAA0B,CAAC;AACxF,CAAC;AAED,4DAA4D;AAC5D,MAAM,WAAW,GAAqC;IACrD,GAAG,EAAE,eAAe;IACpB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,WAAW;IACjB,KAAK,EAAE,YAAY;IACnB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,kBAAkB;IACxB,GAAG,EAAE,GAAG;IACR,EAAE,EAAE,UAAU;CACd,CAAC","sourcesContent":["// The files the surfaces serve (slice 11 §1, §4): base bundles, plugin scripts, stylesheets and assets, each named by\n// its content and so cached by clients forever; their types.\n\nimport { extname } from \"node:path\";\nimport type { HttpResponse } from \"../http/index.ts\";\n\n/** A file the server serves: its type and bytes. */\nexport type ServedFile = { readonly mime: string; readonly bytes: Uint8Array };\n\n/** A served file's response, cached by the browser forever (its path names its content); 404 for none. */\nexport function served(found: ServedFile | undefined): HttpResponse {\n\tif (found === undefined) return { kind: \"error\", status: 404 };\n\tconst { mime, bytes } = found;\n\treturn {\n\t\tkind: \"bytes\",\n\t\tmime,\n\t\tsize: bytes.length,\n\t\tread: async (offset, length) => bytes.subarray(offset, offset + length),\n\t\t// Overrides the baseline's `no-store` for these files only.\n\t\theaders: { \"Cache-Control\": \"private, max-age=31536000, immutable\" },\n\t};\n}\n\n/** The type of a script. */\nexport const JAVASCRIPT = \"text/javascript; charset=utf-8\";\n\n/** The type of a stylesheet. */\nexport const CSS = \"text/css; charset=utf-8\";\n\n/** The type of a built asset, by extension. */\nexport function mimeOf(path: string): string {\n\treturn ASSET_TYPES[extname(path).slice(1).toLowerCase()] ?? \"application/octet-stream\";\n}\n\n/** The types of the assets builds collect, by extension. */\nconst ASSET_TYPES: Readonly<Record<string, string>> = {\n\tsvg: \"image/svg+xml\",\n\tpng: \"image/png\",\n\tjpg: \"image/jpeg\",\n\tjpeg: \"image/jpeg\",\n\tgif: \"image/gif\",\n\twebp: \"image/webp\",\n\twoff: \"font/woff\",\n\twoff2: \"font/woff2\",\n\tttf: \"font/ttf\",\n\twasm: \"application/wasm\",\n\tjson: \"application/json\",\n\tcss: CSS,\n\tjs: JAVASCRIPT,\n};\n"]}

package/dist/node/surfaces/surface-build.d.ts

@@ -0,0 +1,53 @@
+import type { Principal } from "../../data/index.ts";
+import type { Host } from "../../host/index.ts";
+import type { ScriptSet } from "../../surfaces/index.ts";
+import type { HttpResponse } from "../http/index.ts";
+import type { BaseInputs, Plugins, RolloutStep } from "../plugins/index.ts";
+import { type BaseBundle, type BasePlatform } from "./bundle.ts";
+import { type SurfaceName } from "./current.ts";
+import { PublishedScripts } from "./published.ts";
+/** How a surface's build ended: built (its base bundle's hash and inputs), or failed (esbuild's failure). */
+export type SurfaceBuilt = {
+    readonly kind: "built";
+    readonly base: string;
+    readonly inputs: BaseInputs;
+} | {
+    readonly kind: "failed";
+    readonly error: unknown;
+};
+/** What a surface builds: its kind, entry, conditions, the plugins component. */
+export type SurfaceBuildOptions = {
+    readonly kind: string;
+    readonly entry: string;
+    readonly conditions: readonly string[] | undefined;
+    readonly plugins: Plugins;
+};
+/** A surface's base bundle and first set, built once, after the server's load. */
+export declare class SurfaceBuild<P extends Principal> {
+    #private;
+    constructor(surface: SurfaceName, platform: BasePlatform, prefix: string, options: SurfaceBuildOptions, server: Host<P>);
+    /** The set published now: the kind's first one once taken, an empty one before. */
+    get set(): ScriptSet;
+    /** How the build ended, once it did. */
+    get built(): SurfaceBuilt | undefined;
+    /**
+     * Builds the base bundle and publishes the kind's first set (its plugins' facets built on first use) to the scripts
+     * object, once (after the server's load: the object must be served). Shared by every waiter, so no caller's abort
+     * ends it (the server's close fails it). Never rejects: its outcome.
+     */
+    build(): Promise<SurfaceBuilt>;
+    /** The response for a file of the built surface (its base bundle's, a published set's), 503 when the build failed. */
+    file(path: string): Promise<HttpResponse>;
+    /** The built parts for a request (the build started when nothing did), `undefined` when it failed. */
+    parts(): Promise<{
+        readonly base: BaseBundle;
+        readonly published: PublishedScripts<P>;
+    } | undefined>;
+    /**
+     * The rollout step publishing the kind's current set, after the build: a failed build fails the step's one host
+     * (`name`), whose plugins stay dirty; the rollout's abort ends its wait for the build (the step rejects, the rollout
+     * stops there; the build goes on).
+     */
+    step(name: string): RolloutStep;
+}
+//# sourceMappingURL=surface-build.d.ts.map

package/dist/node/surfaces/surface-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-build.d.ts","sourceRoot":"","sources":["../../../src/node/surfaces/surface-build.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAS,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACnF,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,YAAY,EAAa,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlD,6GAA6G;AAC7G,MAAM,MAAM,YAAY,GACrB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAA;CAAE,GAC9E;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC;AAExD,iFAAiF;AACjF,MAAM,MAAM,mBAAmB,GAAG;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC1B,CAAC;AAUF,kFAAkF;AAClF,qBAAa,YAAY,CAAC,CAAC,SAAS,SAAS;;IAW5C,YACC,OAAO,EAAE,WAAW,EACpB,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAOf;IAED,mFAAmF;IACnF,IAAI,GAAG,IAAI,SAAS,CAEnB;IAED,wCAAwC;IACxC,IAAI,KAAK,IAAI,YAAY,GAAG,SAAS,CAEpC;IAED;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAEnC;IAED,sHAAsH;IAChH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAI9C;IAED,sGAAsG;IAChG,KAAK,IAAI,OAAO,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;QAAC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,SAAS,CAAC,CAGzG;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAU9B;CAyBD"}

package/dist/node/surfaces/surface-build.js

@@ -0,0 +1,105 @@
+// A client surface's build (owner decision "A" on startup cost): its base bundle and its kind's first published set,
+// made off the server's start: the kit starts it right after the server listens, and every request for the page or a
+// surface file waits for it (and starts it when nothing did). A base that does not build fails only what needs it:
+// those requests answer 503, the server runs on. Built from the real files at every start.
+import { awaitWithContext, BACKGROUND_CONTEXT } from "../../context/index.js";
+import { buildBase } from "./bundle.js";
+import { publishTo } from "./current.js";
+import { PublishedScripts } from "./published.js";
+import { served } from "./served.js";
+/** The set the scripts object shows before the build: no client holds it then (the page and the start wait). */
+const UNBUILT = { base: "", combined: "", plugins: [] };
+/** A surface's base bundle and first set, built once, after the server's load. */
+export class SurfaceBuild {
+    #surface;
+    #platform;
+    #prefix;
+    #options;
+    #server;
+    #building;
+    #outcome;
+    /** The published scripts once they took the first set (before it is published: the scripts object starts there). */
+    #published;
+    constructor(surface, platform, prefix, options, server) {
+        this.#surface = surface;
+        this.#platform = platform;
+        this.#prefix = prefix;
+        this.#options = options;
+        this.#server = server;
+    }
+    /** The set published now: the kind's first one once taken, an empty one before. */
+    get set() {
+        return this.#published?.set ?? UNBUILT;
+    }
+    /** How the build ended, once it did. */
+    get built() {
+        return this.#outcome === undefined ? undefined : publicOutcome(this.#outcome);
+    }
+    /**
+     * Builds the base bundle and publishes the kind's first set (its plugins' facets built on first use) to the scripts
+     * object, once (after the server's load: the object must be served). Shared by every waiter, so no caller's abort
+     * ends it (the server's close fails it). Never rejects: its outcome.
+     */
+    async build() {
+        return publicOutcome(await this.#ready());
+    }
+    /** The response for a file of the built surface (its base bundle's, a published set's), 503 when the build failed. */
+    async file(path) {
+        const outcome = await this.#ready();
+        if (outcome.kind === "failed")
+            return { kind: "error", status: 503 };
+        return served(outcome.base.files.get(path) ?? outcome.published.file(path));
+    }
+    /** The built parts for a request (the build started when nothing did), `undefined` when it failed. */
+    async parts() {
+        const outcome = await this.#ready();
+        return outcome.kind === "built" ? outcome : undefined;
+    }
+    /**
+     * The rollout step publishing the kind's current set, after the build: a failed build fails the step's one host
+     * (`name`), whose plugins stay dirty; the rollout's abort ends its wait for the build (the step rejects, the rollout
+     * stops there; the build goes on).
+     */
+    step(name) {
+        return {
+            name,
+            kinds: [this.#options.kind],
+            reload: async (built, context) => {
+                const outcome = await awaitWithContext(this.#ready(), context);
+                if (outcome.kind === "failed")
+                    return { hosts: [{ host: name, error: outcome.error }] };
+                return outcome.published.step(name).reload(built, context);
+            },
+        };
+    }
+    /** The build, started once. */
+    #ready() {
+        this.#building ??= this.#run(BACKGROUND_CONTEXT).then((outcome) => {
+            this.#outcome = outcome;
+            return outcome;
+        });
+        return this.#building;
+    }
+    /** Builds the base bundle, takes the kind's current set as the first and publishes it. */
+    async #run(context) {
+        const { kind, entry, conditions, plugins } = this.#options;
+        try {
+            const base = await buildBase(entry, this.#platform, this.#prefix, conditions);
+            const published = new PublishedScripts(this.#surface, kind, this.#prefix, base.hash, plugins, this.#server);
+            await published.start(context);
+            this.#published = published;
+            await publishTo(this.#server, this.#surface, published.set, context);
+            return { kind: "built", base, published };
+        }
+        catch (error) {
+            return { kind: "failed", error };
+        }
+    }
+}
+/** `outcome` as callers see it. */
+function publicOutcome(outcome) {
+    return outcome.kind === "built"
+        ? { kind: "built", base: outcome.base.hash, inputs: outcome.base.inputs }
+        : { kind: "failed", error: outcome.error };
+}
+//# sourceMappingURL=surface-build.js.map

package/dist/node/surfaces/surface-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface-build.js","sourceRoot":"","sources":["../../../src/node/surfaces/surface-build.ts"],"names":[],"mappings":"AAAA,qHAAqH;AACrH,qHAAqH;AACrH,mHAAmH;AACnH,2FAA2F;AAE3F,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAgB,MAAM,wBAAwB,CAAC;AAM5F,OAAO,EAAsC,SAAS,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAoB,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAoBrC,gHAAgH;AAChH,MAAM,OAAO,GAAc,EAAE,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;AAEnE,kFAAkF;AAClF,MAAM,OAAO,YAAY;IACf,QAAQ,CAAc;IACtB,SAAS,CAAe;IACxB,OAAO,CAAS;IAChB,QAAQ,CAAsB;IAC9B,OAAO,CAAU;IAC1B,SAAS,CAAkC;IAC3C,QAAQ,CAAyB;IACjC,oHAAoH;IACpH,UAAU,CAAkC;IAE5C,YACC,OAAoB,EACpB,QAAsB,EACtB,MAAc,EACd,OAA4B,EAC5B,MAAe;QAEf,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC;QAC1B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,mFAAmF;IACnF,IAAI,GAAG;QACN,OAAO,IAAI,CAAC,UAAU,EAAE,GAAG,IAAI,OAAO,CAAC;IACxC,CAAC;IAED,wCAAwC;IACxC,IAAI,KAAK;QACR,OAAO,IAAI,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,KAAK;QACV,OAAO,aAAa,CAAC,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,sHAAsH;IACtH,KAAK,CAAC,IAAI,CAAC,IAAY;QACtB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;QACrE,OAAO,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7E,CAAC;IAED,sGAAsG;IACtG,KAAK,CAAC,KAAK;QACV,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACvD,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAY;QAChB,OAAO;YACN,IAAI;YACJ,KAAK,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC3B,MAAM,EAAE,KAAK,EAAE,KAAY,EAAE,OAAgB,EAAE,EAAE;gBAChD,MAAM,OAAO,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;gBAC/D,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC;gBACxF,OAAO,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;YAC5D,CAAC;SACD,CAAC;IACH,CAAC;IAED,+BAA+B;IAC/B,MAAM;QACL,IAAI,CAAC,SAAS,KAAK,IAAI,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACjE,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC;YACxB,OAAO,OAAO,CAAC;QAChB,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC;IACvB,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,IAAI,CAAC,OAAgB;QAC1B,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3D,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;YAC9E,MAAM,SAAS,GAAG,IAAI,gBAAgB,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC5G,MAAM,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/B,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC5B,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QAC3C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;QAClC,CAAC;IACF,CAAC;CACD;AAED,mCAAmC;AACnC,SAAS,aAAa,CAAsB,OAAmB;IAC9D,OAAO,OAAO,CAAC,IAAI,KAAK,OAAO;QAC9B,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE;QACzE,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC;AAC7C,CAAC","sourcesContent":["// A client surface's build (owner decision \"A\" on startup cost): its base bundle and its kind's first published set,\n// made off the server's start: the kit starts it right after the server listens, and every request for the page or a\n// surface file waits for it (and starts it when nothing did). A base that does not build fails only what needs it:\n// those requests answer 503, the server runs on. Built from the real files at every start.\n\nimport { awaitWithContext, BACKGROUND_CONTEXT, type Context } from \"../../context/index.ts\";\nimport type { Principal } from \"../../data/index.ts\";\nimport type { Host } from \"../../host/index.ts\";\nimport type { ScriptSet } from \"../../surfaces/index.ts\";\nimport type { HttpResponse } from \"../http/index.ts\";\nimport type { BaseInputs, Built, Plugins, RolloutStep } from \"../plugins/index.ts\";\nimport { type BaseBundle, type BasePlatform, buildBase } from \"./bundle.ts\";\nimport { publishTo, type SurfaceName } from \"./current.ts\";\nimport { PublishedScripts } from \"./published.ts\";\nimport { served } from \"./served.ts\";\n\n/** How a surface's build ended: built (its base bundle's hash and inputs), or failed (esbuild's failure). */\nexport type SurfaceBuilt =\n\t| { readonly kind: \"built\"; readonly base: string; readonly inputs: BaseInputs }\n\t| { readonly kind: \"failed\"; readonly error: unknown };\n\n/** What a surface builds: its kind, entry, conditions, the plugins component. */\nexport type SurfaceBuildOptions = {\n\treadonly kind: string;\n\treadonly entry: string;\n\treadonly conditions: readonly string[] | undefined;\n\treadonly plugins: Plugins;\n};\n\n/** A built surface's parts, or why there are none. */\ntype Outcome<P extends Principal> =\n\t| { readonly kind: \"built\"; readonly base: BaseBundle; readonly published: PublishedScripts<P> }\n\t| { readonly kind: \"failed\"; readonly error: unknown };\n\n/** The set the scripts object shows before the build: no client holds it then (the page and the start wait). */\nconst UNBUILT: ScriptSet = { base: \"\", combined: \"\", plugins: [] };\n\n/** A surface's base bundle and first set, built once, after the server's load. */\nexport class SurfaceBuild<P extends Principal> {\n\treadonly #surface: SurfaceName;\n\treadonly #platform: BasePlatform;\n\treadonly #prefix: string;\n\treadonly #options: SurfaceBuildOptions;\n\treadonly #server: Host<P>;\n\t#building: Promise<Outcome<P>> | undefined;\n\t#outcome: Outcome<P> | undefined;\n\t/** The published scripts once they took the first set (before it is published: the scripts object starts there). */\n\t#published: PublishedScripts<P> | undefined;\n\n\tconstructor(\n\t\tsurface: SurfaceName,\n\t\tplatform: BasePlatform,\n\t\tprefix: string,\n\t\toptions: SurfaceBuildOptions,\n\t\tserver: Host<P>,\n\t) {\n\t\tthis.#surface = surface;\n\t\tthis.#platform = platform;\n\t\tthis.#prefix = prefix;\n\t\tthis.#options = options;\n\t\tthis.#server = server;\n\t}\n\n\t/** The set published now: the kind's first one once taken, an empty one before. */\n\tget set(): ScriptSet {\n\t\treturn this.#published?.set ?? UNBUILT;\n\t}\n\n\t/** How the build ended, once it did. */\n\tget built(): SurfaceBuilt | undefined {\n\t\treturn this.#outcome === undefined ? undefined : publicOutcome(this.#outcome);\n\t}\n\n\t/**\n\t * Builds the base bundle and publishes the kind's first set (its plugins' facets built on first use) to the scripts\n\t * object, once (after the server's load: the object must be served). Shared by every waiter, so no caller's abort\n\t * ends it (the server's close fails it). Never rejects: its outcome.\n\t */\n\tasync build(): Promise<SurfaceBuilt> {\n\t\treturn publicOutcome(await this.#ready());\n\t}\n\n\t/** The response for a file of the built surface (its base bundle's, a published set's), 503 when the build failed. */\n\tasync file(path: string): Promise<HttpResponse> {\n\t\tconst outcome = await this.#ready();\n\t\tif (outcome.kind === \"failed\") return { kind: \"error\", status: 503 };\n\t\treturn served(outcome.base.files.get(path) ?? outcome.published.file(path));\n\t}\n\n\t/** The built parts for a request (the build started when nothing did), `undefined` when it failed. */\n\tasync parts(): Promise<{ readonly base: BaseBundle; readonly published: PublishedScripts<P> } | undefined> {\n\t\tconst outcome = await this.#ready();\n\t\treturn outcome.kind === \"built\" ? outcome : undefined;\n\t}\n\n\t/**\n\t * The rollout step publishing the kind's current set, after the build: a failed build fails the step's one host\n\t * (`name`), whose plugins stay dirty; the rollout's abort ends its wait for the build (the step rejects, the rollout\n\t * stops there; the build goes on).\n\t */\n\tstep(name: string): RolloutStep {\n\t\treturn {\n\t\t\tname,\n\t\t\tkinds: [this.#options.kind],\n\t\t\treload: async (built: Built, context: Context) => {\n\t\t\t\tconst outcome = await awaitWithContext(this.#ready(), context);\n\t\t\t\tif (outcome.kind === \"failed\") return { hosts: [{ host: name, error: outcome.error }] };\n\t\t\t\treturn outcome.published.step(name).reload(built, context);\n\t\t\t},\n\t\t};\n\t}\n\n\t/** The build, started once. */\n\t#ready(): Promise<Outcome<P>> {\n\t\tthis.#building ??= this.#run(BACKGROUND_CONTEXT).then((outcome) => {\n\t\t\tthis.#outcome = outcome;\n\t\t\treturn outcome;\n\t\t});\n\t\treturn this.#building;\n\t}\n\n\t/** Builds the base bundle, takes the kind's current set as the first and publishes it. */\n\tasync #run(context: Context): Promise<Outcome<P>> {\n\t\tconst { kind, entry, conditions, plugins } = this.#options;\n\t\ttry {\n\t\t\tconst base = await buildBase(entry, this.#platform, this.#prefix, conditions);\n\t\t\tconst published = new PublishedScripts(this.#surface, kind, this.#prefix, base.hash, plugins, this.#server);\n\t\t\tawait published.start(context);\n\t\t\tthis.#published = published;\n\t\t\tawait publishTo(this.#server, this.#surface, published.set, context);\n\t\t\treturn { kind: \"built\", base, published };\n\t\t} catch (error) {\n\t\t\treturn { kind: \"failed\", error };\n\t\t}\n\t}\n}\n\n/** `outcome` as callers see it. */\nfunction publicOutcome<P extends Principal>(outcome: Outcome<P>): SurfaceBuilt {\n\treturn outcome.kind === \"built\"\n\t\t? { kind: \"built\", base: outcome.base.hash, inputs: outcome.base.inputs }\n\t\t: { kind: \"failed\", error: outcome.error };\n}\n"]}

package/dist/node/surfaces/tui.d.ts

@@ -0,0 +1,40 @@
+import type { Principal } from "../../data/index.ts";
+import { type Facet, type Host } from "../../host/index.ts";
+import type { Plugins, RolloutStep } from "../plugins/index.ts";
+import { type SurfaceBuilt } from "./surface-build.ts";
+/** What `tuiSurface` takes. */
+export type TuiSurfaceOptions = {
+    /** The terminal facet kind: `tui` by default. */
+    readonly kind?: string;
+    readonly plugins: Plugins;
+    /** The app's terminal start code (it calls `startTerminalRuntime`): the base bundle's entry. */
+    readonly entry: string;
+    /** The conditions the base bundle's packages resolve with: the server process's by default (`processConditions`). */
+    readonly conditions?: readonly string[];
+};
+/** What a launcher downloads at its start (`GET /_chord/tui/start`): the base bundle and the combined plugin file. */
+export type TuiStart = {
+    readonly base: string;
+    readonly script: string;
+    readonly combined: string;
+};
+/** The terminal surface: its facet (for the server's core facets), its rollout step, its build. */
+export type TuiSurface<P extends Principal> = {
+    readonly facet: Facet<P>;
+    step(name: string): RolloutStep;
+    /**
+     * Builds the base bundle and publishes the terminal kind's first set, once, after the server's load (the launcher's
+     * start and the surface's files wait for it, and start it when nothing did). Never rejects: how it ended.
+     */
+    build(): Promise<SurfaceBuilt>;
+    /** How the build ended, once it did. */
+    readonly built: SurfaceBuilt | undefined;
+};
+/** Where the terminal surface's files live. */
+export declare const TUI_PREFIX = "/_chord/tui/";
+/**
+ * The terminal surface on `server`: its facet serves the launcher's start and the surface's files once `build` built
+ * the base bundle (503 when it failed). The build is not started here.
+ */
+export declare function tuiSurface<P extends Principal>(server: Host<P>, options: TuiSurfaceOptions): TuiSurface<P>;
+//# sourceMappingURL=tui.d.ts.map

package/dist/node/surfaces/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../../../src/node/surfaces/tui.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEhE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG;IAC/B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gGAAgG;IAChG,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,qHAAqH;IACrH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF,sHAAsH;AACtH,MAAM,MAAM,QAAQ,GAAG;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAErG,mGAAmG;AACnG,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,IAAI;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAChC;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,+CAA+C;AAC/C,eAAO,MAAM,UAAU,iBAAiB,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAoC1G"}

package/dist/node/surfaces/tui.js

@@ -0,0 +1,55 @@
+// The terminal surface's server side (slice 11 §4, decisions "Slice 11, P3" and "P8"): the terminal kind's base bundle
+// (one ES module the sandbox evaluates) built from the app's terminal entry after the server's start (`build`; the
+// launcher's start and the surface's files wait for it, and answer 503 when it failed), the kind's plugin scripts
+// published as registered scripts and one combined file, `TuiScripts` showing the current set, all served to the
+// launcher, which signs in with a token. Routes and objects are `Http` contributions of the surface's facet.
+import { defineFacet } from "../../host/index.js";
+import { Http } from "../http/index.js";
+import { scriptsFacet } from "./current.js";
+import { SurfaceBuild } from "./surface-build.js";
+/** Where the terminal surface's files live. */
+export const TUI_PREFIX = "/_chord/tui/";
+/**
+ * The terminal surface on `server`: its facet serves the launcher's start and the surface's files once `build` built
+ * the base bundle (503 when it failed). The build is not started here.
+ */
+export function tuiSurface(server, options) {
+    const { kind = "tui", entry, conditions, plugins } = options;
+    const building = new SurfaceBuild("tui", "sandbox", TUI_PREFIX, { kind, entry, conditions, plugins }, server);
+    const serve = async (request) => building.file(request.path);
+    const facet = defineFacet((host, self) => {
+        scriptsFacet("tui", building).setup(host, self);
+        self.contribute(Http, {
+            routes: {
+                [`GET ${TUI_PREFIX}start`]: async () => {
+                    const parts = await building.parts();
+                    if (parts === undefined)
+                        return { kind: "error", status: 503 };
+                    const { base, published } = parts;
+                    const start = { base: base.hash, script: base.script, combined: published.set.combined };
+                    return { kind: "json", value: start, headers: { "Cache-Control": "no-store" } };
+                },
+                [`GET ${TUI_PREFIX}base`]: {
+                    public: true,
+                    handler: async () => {
+                        const parts = await building.parts();
+                        if (parts === undefined)
+                            return { kind: "error", status: 503 };
+                        return { kind: "json", value: parts.base.hash, headers: { "Cache-Control": "no-store" } };
+                    },
+                },
+                [`GET ${TUI_PREFIX}:file`]: serve,
+                [`GET ${TUI_PREFIX}plugin/:file`]: serve,
+            },
+        });
+    });
+    return {
+        facet,
+        step: (name) => building.step(name),
+        build: () => building.build(),
+        get built() {
+            return building.built;
+        },
+    };
+}
+//# sourceMappingURL=tui.js.map

package/dist/node/surfaces/tui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.js","sourceRoot":"","sources":["../../../src/node/surfaces/tui.ts"],"names":[],"mappings":"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","sourcesContent":["// The terminal surface's server side (slice 11 §4, decisions \"Slice 11, P3\" and \"P8\"): the terminal kind's base bundle\n// (one ES module the sandbox evaluates) built from the app's terminal entry after the server's start (`build`; the\n// launcher's start and the surface's files wait for it, and answer 503 when it failed), the kind's plugin scripts\n// published as registered scripts and one combined file, `TuiScripts` showing the current set, all served to the\n// launcher, which signs in with a token. Routes and objects are `Http` contributions of the surface's facet.\n\nimport type { Principal } from \"../../data/index.ts\";\nimport { defineFacet, type Facet, type Host } from \"../../host/index.ts\";\nimport { Http, type HttpRequest, type HttpResponse } from \"../http/index.ts\";\nimport type { Plugins, RolloutStep } from \"../plugins/index.ts\";\nimport { scriptsFacet } from \"./current.ts\";\nimport { SurfaceBuild, type SurfaceBuilt } from \"./surface-build.ts\";\n\n/** What `tuiSurface` takes. */\nexport type TuiSurfaceOptions = {\n\t/** The terminal facet kind: `tui` by default. */\n\treadonly kind?: string;\n\treadonly plugins: Plugins;\n\t/** The app's terminal start code (it calls `startTerminalRuntime`): the base bundle's entry. */\n\treadonly entry: string;\n\t/** The conditions the base bundle's packages resolve with: the server process's by default (`processConditions`). */\n\treadonly conditions?: readonly string[];\n};\n\n/** What a launcher downloads at its start (`GET /_chord/tui/start`): the base bundle and the combined plugin file. */\nexport type TuiStart = { readonly base: string; readonly script: string; readonly combined: string };\n\n/** The terminal surface: its facet (for the server's core facets), its rollout step, its build. */\nexport type TuiSurface<P extends Principal> = {\n\treadonly facet: Facet<P>;\n\tstep(name: string): RolloutStep;\n\t/**\n\t * Builds the base bundle and publishes the terminal kind's first set, once, after the server's load (the launcher's\n\t * start and the surface's files wait for it, and start it when nothing did). Never rejects: how it ended.\n\t */\n\tbuild(): Promise<SurfaceBuilt>;\n\t/** How the build ended, once it did. */\n\treadonly built: SurfaceBuilt | undefined;\n};\n\n/** Where the terminal surface's files live. */\nexport const TUI_PREFIX = \"/_chord/tui/\";\n\n/**\n * The terminal surface on `server`: its facet serves the launcher's start and the surface's files once `build` built\n * the base bundle (503 when it failed). The build is not started here.\n */\nexport function tuiSurface<P extends Principal>(server: Host<P>, options: TuiSurfaceOptions): TuiSurface<P> {\n\tconst { kind = \"tui\", entry, conditions, plugins } = options;\n\tconst building = new SurfaceBuild<P>(\"tui\", \"sandbox\", TUI_PREFIX, { kind, entry, conditions, plugins }, server);\n\tconst serve = async (request: HttpRequest): Promise<HttpResponse> => building.file(request.path);\n\tconst facet = defineFacet<P>((host, self) => {\n\t\tscriptsFacet<P>(\"tui\", building).setup(host, self);\n\t\tself.contribute(Http, {\n\t\t\troutes: {\n\t\t\t\t[`GET ${TUI_PREFIX}start`]: async () => {\n\t\t\t\t\tconst parts = await building.parts();\n\t\t\t\t\tif (parts === undefined) return { kind: \"error\", status: 503 };\n\t\t\t\t\tconst { base, published } = parts;\n\t\t\t\t\tconst start: TuiStart = { base: base.hash, script: base.script, combined: published.set.combined };\n\t\t\t\t\treturn { kind: \"json\", value: start, headers: { \"Cache-Control\": \"no-store\" } };\n\t\t\t\t},\n\t\t\t\t[`GET ${TUI_PREFIX}base`]: {\n\t\t\t\t\tpublic: true,\n\t\t\t\t\thandler: async () => {\n\t\t\t\t\t\tconst parts = await building.parts();\n\t\t\t\t\t\tif (parts === undefined) return { kind: \"error\", status: 503 };\n\t\t\t\t\t\treturn { kind: \"json\", value: parts.base.hash, headers: { \"Cache-Control\": \"no-store\" } };\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\t[`GET ${TUI_PREFIX}:file`]: serve,\n\t\t\t\t[`GET ${TUI_PREFIX}plugin/:file`]: serve,\n\t\t\t},\n\t\t});\n\t});\n\treturn {\n\t\tfacet,\n\t\tstep: (name) => building.step(name),\n\t\tbuild: () => building.build(),\n\t\tget built() {\n\t\t\treturn building.built;\n\t\t},\n\t};\n}\n"]}

package/dist/node/surfaces/web.d.ts

@@ -0,0 +1,56 @@
+import type { Principal } from "../../data/index.ts";
+import { type Facet, type Host } from "../../host/index.ts";
+import { type HttpRequest } from "../http/index.ts";
+import type { Plugins, RolloutStep } from "../plugins/index.ts";
+import { type SurfaceBuilt } from "./surface-build.ts";
+/** What `webSurface` takes. */
+export type WebSurfaceOptions = {
+    /** The web facet kind: `web` by default. */
+    readonly kind?: string;
+    readonly plugins: Plugins;
+    /** The app's web start code (it calls `startPage`): the base bundle's entry. */
+    readonly entry: string;
+    /** The page's HTML: the app's template, given the request (its `nonce`) and the assets to include. */
+    readonly page: (request: HttpRequest, assets: PageAssets) => string | Promise<string>;
+    /** The paths serving the page: `["/"]` by default (patterns, `/*` for a page with its own routing). */
+    readonly paths?: readonly string[];
+    /** Whether the page and its scripts are served without a principal (a public app); signed in only by default. */
+    readonly public?: boolean;
+    /** The conditions the base bundle's packages resolve with: the server process's by default (`processConditions`). */
+    readonly conditions?: readonly string[];
+};
+/**
+ * What a page includes, in this order: `bootstrap` as an inline script with the response's nonce (before the
+ * stylesheets: it records how each one's load ends), then the stylesheets `styles` (the base bundle's first, then each
+ * plugin's) and the scripts `plugins` and `script` (deferred, in that order). `pageScripts` writes the tags.
+ */
+export type PageAssets = {
+    readonly bootstrap: string;
+    readonly script: string;
+    readonly plugins: string;
+    readonly styles: readonly string[];
+};
+/** The web surface: its facet (for the server's core facets), its rollout step, its build. */
+export type WebSurface<P extends Principal> = {
+    readonly facet: Facet<P>;
+    /** The rollout step publishing the web kind's current set (after the server's step; after the build). */
+    step(name: string): RolloutStep;
+    /**
+     * Builds the base bundle and publishes the web kind's first set (its facets built on first use), once, after the
+     * server's load (the page and the surface's files wait for it, and start it when nothing did). Never rejects: how it
+     * ended (`built`: the base bundle's hash and the files it read, the app's base code for this surface).
+     */
+    build(): Promise<SurfaceBuilt>;
+    /** How the build ended, once it did. */
+    readonly built: SurfaceBuilt | undefined;
+};
+/** Where the web surface's files live. */
+export declare const WEB_PREFIX = "/_chord/web/";
+/**
+ * The web surface on `server`: its facet serves the page and the surface's files once `build` built the base bundle
+ * (503 when it failed). The build is not started here.
+ */
+export declare function webSurface<P extends Principal>(server: Host<P>, options: WebSurfaceOptions): WebSurface<P>;
+/** The page's tags for `assets`: the inline bootstrap with `nonce`, the stylesheets, then the deferred scripts. */
+export declare function pageScripts(assets: PageAssets, nonce: string): string;
+//# sourceMappingURL=web.d.ts.map

package/dist/node/surfaces/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../../src/node/surfaces/web.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAe,KAAK,KAAK,EAAE,KAAK,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAEzE,OAAO,EAAQ,KAAK,WAAW,EAA4C,MAAM,kBAAkB,CAAC;AACpG,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGhE,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErE,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG;IAC/B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sGAAsG;IACtG,QAAQ,CAAC,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACtF,uGAAuG;IACvG,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,iHAAiH;IACjH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,qHAAqH;IACrH,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC,CAAC;AAEF,8FAA8F;AAC9F,MAAM,MAAM,UAAU,CAAC,CAAC,SAAS,SAAS,IAAI;IAC7C,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,yGAAyG;IACzG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAChC;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAC;CACzC,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,UAAU,iBAAiB,CAAC;AAEzC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,CAAC,CAAC,CAoB1G;AAmED,mHAAmH;AACnH,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAOrE"}

package/dist/node/surfaces/web.js

@@ -0,0 +1,108 @@
+// The web surface's server side (slice 11 §1, decisions "Slice 11's points" and "P3" to "P5"): the base bundle built
+// from the app's entry after the server's start (`build`; the page and the surface's files wait for it, and answer 503
+// when it failed), the plugins' web scripts published as registered scripts and one combined file,
+// `WebScripts` showing the current set, and the page through the app's own template; everything as `Http`
+// contributions of the surface's facet, which the app puts among the server's core facets. The app keeps its HTML,
+// CSS, components and themes.
+import { defineFacet } from "../../host/index.js";
+import { REGISTER } from "../../surfaces/index.js";
+import { Http } from "../http/index.js";
+import { scriptsFacet } from "./current.js";
+import { SurfaceBuild } from "./surface-build.js";
+/** Where the web surface's files live. */
+export const WEB_PREFIX = "/_chord/web/";
+/**
+ * The web surface on `server`: its facet serves the page and the surface's files once `build` built the base bundle
+ * (503 when it failed). The build is not started here.
+ */
+export function webSurface(server, options) {
+    const { kind = "web", entry, conditions, plugins } = options;
+    const building = new SurfaceBuild("web", "browser", WEB_PREFIX, { kind, entry, conditions, plugins }, server);
+    const facet = defineFacet((host, self) => {
+        scriptsFacet("web", building).setup(host, self);
+        self.contribute(Http, {
+            routes: webRoutes(options, building),
+            csp: { "style-src": ["'self'"], "img-src": ["'self'", "data:"], "font-src": ["'self'"] },
+            // Scripts from the surface's files only (and the page's nonce): no other same-origin response runs (Opus L8).
+            scripts: [WEB_PREFIX],
+        });
+    });
+    return {
+        facet,
+        step: (name) => building.step(name),
+        build: () => building.build(),
+        get built() {
+            return building.built;
+        },
+    };
+}
+/**
+ * The surface's routes, each waiting for the build (503 when it failed): its files (served forever), its current base
+ * hash (public), and the page.
+ */
+function webRoutes(options, building) {
+    const access = options.public === true ? { public: true } : {};
+    const serve = async (request) => building.file(request.path);
+    const routes = {
+        [`GET ${WEB_PREFIX}:file`]: { ...access, handler: serve },
+        [`GET ${WEB_PREFIX}plugin/:file`]: { ...access, handler: serve },
+        [`GET ${WEB_PREFIX}assets/:file`]: { ...access, handler: serve },
+        // Asked by a page before it reconnects: another base means its code is outdated. Public: an outdated page whose
+        // session ended still learns it should reload.
+        [`GET ${WEB_PREFIX}base`]: {
+            public: true,
+            handler: async () => {
+                const parts = await building.parts();
+                if (parts === undefined)
+                    return { kind: "error", status: 503 };
+                return { kind: "json", value: parts.base.hash, headers: { "Cache-Control": "no-store" } };
+            },
+        },
+    };
+    for (const path of options.paths ?? ["/"]) {
+        routes[`GET ${path}`] = {
+            ...access,
+            page: true,
+            handler: async (request) => {
+                const parts = await building.parts();
+                if (parts === undefined)
+                    return { kind: "error", status: 503 };
+                return { kind: "html", body: await options.page(request, pageAssets(parts.base, parts.published)) };
+            },
+        };
+    }
+    return routes;
+}
+/** What the page includes now: the bootstrap, the base script, the current combined file, the stylesheets. */
+function pageAssets(base, published) {
+    const { set } = published;
+    const styles = [
+        ...(base.style === undefined ? [] : [base.style]),
+        ...set.plugins.flatMap(({ css }) => (css === undefined ? [] : [css])),
+    ];
+    return { bootstrap: bootstrap(base.hash, set), script: base.script, plugins: set.combined, styles };
+}
+/**
+ * The page's inline bootstrap: the base hash and each plugin's stylesheet (`set`'s, the combined file's) for
+ * `startPage`; how each stylesheet's load ended (`links`, by `href`: `load` or `error`, from a capturing listener the
+ * page's start removes: a failed load still has a `sheet`, empty); and the `chordFacet` the combined file's scripts
+ * call before the base bundle runs (they queue; `startPage` takes them).
+ */
+function bootstrap(hash, set) {
+    const styles = Object.fromEntries(set.plugins.flatMap(({ name, css }) => (css === undefined ? [] : [[name, css]])));
+    // Inside a script element: no `<` (a `</script>` in a name would end it).
+    const page = JSON.stringify({ base: hash, styles, links: {}, queued: [] }).replaceAll("<", "\\u003c");
+    const watching = 'chordPage.watching=function(e){var t=e.target;if(t&&t.tagName==="LINK")chordPage.links[t.getAttribute("href")]=e.type};' +
+        'document.addEventListener("load",chordPage.watching,true);document.addEventListener("error",chordPage.watching,true);';
+    return `globalThis.chordPage=${page};${watching}globalThis.${REGISTER}=function(p,d,f){chordPage.queued.push([p,d,f])};`;
+}
+/** The page's tags for `assets`: the inline bootstrap with `nonce`, the stylesheets, then the deferred scripts. */
+export function pageScripts(assets, nonce) {
+    return [
+        `<script nonce="${nonce}">${assets.bootstrap}</script>`,
+        ...assets.styles.map((href) => `<link rel="stylesheet" href="${href}">`),
+        `<script defer src="${assets.plugins}"></script>`,
+        `<script defer src="${assets.script}"></script>`,
+    ].join("\n");
+}
+//# sourceMappingURL=web.js.map

package/dist/node/surfaces/web.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../../src/node/surfaces/web.ts"],"names":[],"mappings":"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","sourcesContent":["// The web surface's server side (slice 11 §1, decisions \"Slice 11's points\" and \"P3\" to \"P5\"): the base bundle built\n// from the app's entry after the server's start (`build`; the page and the surface's files wait for it, and answer 503\n// when it failed), the plugins' web scripts published as registered scripts and one combined file,\n// `WebScripts` showing the current set, and the page through the app's own template; everything as `Http`\n// contributions of the surface's facet, which the app puts among the server's core facets. The app keeps its HTML,\n// CSS, components and themes.\n\nimport type { Principal } from \"../../data/index.ts\";\nimport { defineFacet, type Facet, type Host } from \"../../host/index.ts\";\nimport { REGISTER, type ScriptSet } from \"../../surfaces/index.ts\";\nimport { Http, type HttpRequest, type HttpResponse, type HttpRouteOptions } from \"../http/index.ts\";\nimport type { Plugins, RolloutStep } from \"../plugins/index.ts\";\nimport type { BaseBundle } from \"./bundle.ts\";\nimport { scriptsFacet } from \"./current.ts\";\nimport { SurfaceBuild, type SurfaceBuilt } from \"./surface-build.ts\";\n\n/** What `webSurface` takes. */\nexport type WebSurfaceOptions = {\n\t/** The web facet kind: `web` by default. */\n\treadonly kind?: string;\n\treadonly plugins: Plugins;\n\t/** The app's web start code (it calls `startPage`): the base bundle's entry. */\n\treadonly entry: string;\n\t/** The page's HTML: the app's template, given the request (its `nonce`) and the assets to include. */\n\treadonly page: (request: HttpRequest, assets: PageAssets) => string | Promise<string>;\n\t/** The paths serving the page: `[\"/\"]` by default (patterns, `/*` for a page with its own routing). */\n\treadonly paths?: readonly string[];\n\t/** Whether the page and its scripts are served without a principal (a public app); signed in only by default. */\n\treadonly public?: boolean;\n\t/** The conditions the base bundle's packages resolve with: the server process's by default (`processConditions`). */\n\treadonly conditions?: readonly string[];\n};\n\n/**\n * What a page includes, in this order: `bootstrap` as an inline script with the response's nonce (before the\n * stylesheets: it records how each one's load ends), then the stylesheets `styles` (the base bundle's first, then each\n * plugin's) and the scripts `plugins` and `script` (deferred, in that order). `pageScripts` writes the tags.\n */\nexport type PageAssets = {\n\treadonly bootstrap: string;\n\treadonly script: string;\n\treadonly plugins: string;\n\treadonly styles: readonly string[];\n};\n\n/** The web surface: its facet (for the server's core facets), its rollout step, its build. */\nexport type WebSurface<P extends Principal> = {\n\treadonly facet: Facet<P>;\n\t/** The rollout step publishing the web kind's current set (after the server's step; after the build). */\n\tstep(name: string): RolloutStep;\n\t/**\n\t * Builds the base bundle and publishes the web kind's first set (its facets built on first use), once, after the\n\t * server's load (the page and the surface's files wait for it, and start it when nothing did). Never rejects: how it\n\t * ended (`built`: the base bundle's hash and the files it read, the app's base code for this surface).\n\t */\n\tbuild(): Promise<SurfaceBuilt>;\n\t/** How the build ended, once it did. */\n\treadonly built: SurfaceBuilt | undefined;\n};\n\n/** Where the web surface's files live. */\nexport const WEB_PREFIX = \"/_chord/web/\";\n\n/**\n * The web surface on `server`: its facet serves the page and the surface's files once `build` built the base bundle\n * (503 when it failed). The build is not started here.\n */\nexport function webSurface<P extends Principal>(server: Host<P>, options: WebSurfaceOptions): WebSurface<P> {\n\tconst { kind = \"web\", entry, conditions, plugins } = options;\n\tconst building = new SurfaceBuild<P>(\"web\", \"browser\", WEB_PREFIX, { kind, entry, conditions, plugins }, server);\n\tconst facet = defineFacet<P>((host, self) => {\n\t\tscriptsFacet<P>(\"web\", building).setup(host, self);\n\t\tself.contribute(Http, {\n\t\t\troutes: webRoutes(options, building),\n\t\t\tcsp: { \"style-src\": [\"'self'\"], \"img-src\": [\"'self'\", \"data:\"], \"font-src\": [\"'self'\"] },\n\t\t\t// Scripts from the surface's files only (and the page's nonce): no other same-origin response runs (Opus L8).\n\t\t\tscripts: [WEB_PREFIX],\n\t\t});\n\t});\n\treturn {\n\t\tfacet,\n\t\tstep: (name) => building.step(name),\n\t\tbuild: () => building.build(),\n\t\tget built() {\n\t\t\treturn building.built;\n\t\t},\n\t};\n}\n\n/**\n * The surface's routes, each waiting for the build (503 when it failed): its files (served forever), its current base\n * hash (public), and the page.\n */\nfunction webRoutes<P extends Principal>(\n\toptions: WebSurfaceOptions,\n\tbuilding: SurfaceBuild<P>,\n): Record<string, HttpRouteOptions> {\n\tconst access = options.public === true ? { public: true as const } : {};\n\tconst serve = async (request: HttpRequest): Promise<HttpResponse> => building.file(request.path);\n\tconst routes: Record<string, HttpRouteOptions> = {\n\t\t[`GET ${WEB_PREFIX}:file`]: { ...access, handler: serve },\n\t\t[`GET ${WEB_PREFIX}plugin/:file`]: { ...access, handler: serve },\n\t\t[`GET ${WEB_PREFIX}assets/:file`]: { ...access, handler: serve },\n\t\t// Asked by a page before it reconnects: another base means its code is outdated. Public: an outdated page whose\n\t\t// session ended still learns it should reload.\n\t\t[`GET ${WEB_PREFIX}base`]: {\n\t\t\tpublic: true,\n\t\t\thandler: async () => {\n\t\t\t\tconst parts = await building.parts();\n\t\t\t\tif (parts === undefined) return { kind: \"error\", status: 503 };\n\t\t\t\treturn { kind: \"json\", value: parts.base.hash, headers: { \"Cache-Control\": \"no-store\" } };\n\t\t\t},\n\t\t},\n\t};\n\tfor (const path of options.paths ?? [\"/\"]) {\n\t\troutes[`GET ${path}`] = {\n\t\t\t...access,\n\t\t\tpage: true,\n\t\t\thandler: async (request) => {\n\t\t\t\tconst parts = await building.parts();\n\t\t\t\tif (parts === undefined) return { kind: \"error\", status: 503 };\n\t\t\t\treturn { kind: \"html\", body: await options.page(request, pageAssets(parts.base, parts.published)) };\n\t\t\t},\n\t\t};\n\t}\n\treturn routes;\n}\n\n/** What the page includes now: the bootstrap, the base script, the current combined file, the stylesheets. */\nfunction pageAssets(base: BaseBundle, published: { readonly set: ScriptSet }): PageAssets {\n\tconst { set } = published;\n\tconst styles = [\n\t\t...(base.style === undefined ? [] : [base.style]),\n\t\t...set.plugins.flatMap(({ css }) => (css === undefined ? [] : [css])),\n\t];\n\treturn { bootstrap: bootstrap(base.hash, set), script: base.script, plugins: set.combined, styles };\n}\n\n/**\n * The page's inline bootstrap: the base hash and each plugin's stylesheet (`set`'s, the combined file's) for\n * `startPage`; how each stylesheet's load ended (`links`, by `href`: `load` or `error`, from a capturing listener the\n * page's start removes: a failed load still has a `sheet`, empty); and the `chordFacet` the combined file's scripts\n * call before the base bundle runs (they queue; `startPage` takes them).\n */\nfunction bootstrap(hash: string, set: ScriptSet): string {\n\tconst styles = Object.fromEntries(set.plugins.flatMap(({ name, css }) => (css === undefined ? [] : [[name, css]])));\n\t// Inside a script element: no `<` (a `</script>` in a name would end it).\n\tconst page = JSON.stringify({ base: hash, styles, links: {}, queued: [] }).replaceAll(\"<\", \"\\\\u003c\");\n\tconst watching =\n\t\t'chordPage.watching=function(e){var t=e.target;if(t&&t.tagName===\"LINK\")chordPage.links[t.getAttribute(\"href\")]=e.type};' +\n\t\t'document.addEventListener(\"load\",chordPage.watching,true);document.addEventListener(\"error\",chordPage.watching,true);';\n\treturn `globalThis.chordPage=${page};${watching}globalThis.${REGISTER}=function(p,d,f){chordPage.queued.push([p,d,f])};`;\n}\n\n/** The page's tags for `assets`: the inline bootstrap with `nonce`, the stylesheets, then the deferred scripts. */\nexport function pageScripts(assets: PageAssets, nonce: string): string {\n\treturn [\n\t\t`<script nonce=\"${nonce}\">${assets.bootstrap}</script>`,\n\t\t...assets.styles.map((href) => `<link rel=\"stylesheet\" href=\"${href}\">`),\n\t\t`<script defer src=\"${assets.plugins}\"></script>`,\n\t\t`<script defer src=\"${assets.script}\"></script>`,\n\t].join(\"\\n\");\n}\n"]}