@niscorp/moss 0.2.3 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
- import { renderDocument, createServer } from './chunk-2AHJ6VDR.js';
1
+ import { renderDocument, createServer } from './chunk-3CJCJKKY.js';
2
2
  import { readFile } from 'fs/promises';
3
3
  import { relative, extname, join } from 'path';
4
4
  import { serve as serve$1 } from '@hono/node-server';
@@ -60,5 +60,5 @@ var serve = async (app, runtime) => {
60
60
  };
61
61
 
62
62
  export { MOSS_PATHS, attachSocket, mountSite, serve };
63
- //# sourceMappingURL=chunk-JBRD2TDQ.js.map
64
- //# sourceMappingURL=chunk-JBRD2TDQ.js.map
63
+ //# sourceMappingURL=chunk-DPFWL7BS.js.map
64
+ //# sourceMappingURL=chunk-DPFWL7BS.js.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/node.ts"],"names":["listen"],"mappings":"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","file":"chunk-JBRD2TDQ.js","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { extname, join, relative } from 'node:path';\nimport { serve as listen } from '@hono/node-server';\nimport { serveStatic } from '@hono/node-server/serve-static';\nimport { WebSocketServer } from 'ws';\nimport type { IncomingMessage } from 'node:http';\nimport type { Duplex } from 'node:stream';\nimport { createServer } from './server';\nimport type { MossServer } from './server';\nimport type { NiscApp } from './app';\nimport type { NiscRuntime } from './runtime';\nimport type { SocketAccept } from './socket';\nimport { renderDocument } from './document';\nimport type { DocumentConfig } from './document';\n\n// ═══════════════════════════════════════════════════════════════\n// The Node entry — runtime-specific by design: the transport is a seam, so\n// the Bun flip swaps this file, never the app. Two exports: the\n// websocket transport for hosts that run their own listener (the dev\n// checks, vite), and the batteries-included `serve`.\n// ═══════════════════════════════════════════════════════════════\n\n// Anything that emits Node upgrade events — http.Server structurally, so\n// the @hono/node-server return type needs no narrowing.\ntype Upgradeable = {\n on: (event: 'upgrade', handler: (req: IncomingMessage, socket: Duplex, head: Buffer) => void) => unknown;\n};\n\n// The `ws` half of the transport seam: RFC 6455 stays library-handled\n// (permessage-deflate on by default — see `runtime.socketCompression`); the\n// protocol above the seam is nisc's own (../socket.ts) and identical on every\n// runtime.\nexport const attachSocket = (\n httpServer: Upgradeable,\n accept: SocketAccept,\n path = '/socket',\n options?: { compression?: boolean | Record<string, unknown> },\n): void => {\n const wss = new WebSocketServer({ noServer: true, perMessageDeflate: options?.compression ?? true });\n httpServer.on('upgrade', (req, socket, head) => {\n const url = req.url ?? '/';\n // Not ours: leave it for whichever other listener owns it (vite's HMR\n // upgrade rides the same server in dev).\n if (new URL(url, 'http://nisc.local').pathname !== path) return;\n wss.handleUpgrade(req, socket, head, (ws) => {\n // accept promises to handle its own failures (see socket.ts). This is\n // the floor under that promise: an await added there without a guard\n // degrades to one logged close here instead of an unhandled rejection\n // taking every session on the box down with it.\n accept(url, {\n send: (text) => ws.send(text),\n close: (code, reason) => ws.close(code, reason),\n onMessage: (fn) => ws.on('message', (data) => fn(String(data))),\n onClose: (fn) => ws.on('close', () => fn()),\n }).catch((error: unknown) => {\n console.error('[moss/node] a connection escaped accept:', error);\n try {\n ws.close(1011, 'accept failed');\n } catch {\n // already gone\n }\n });\n });\n });\n};\n\n// THE BUILT TERMINAL, served by the same process as the app — one origin, so the\n// socket is `/socket` wherever the page came from.\n//\n// `dist` is what the app's bundler wrote: index.html and its assets. Every GET\n// that nothing registered earlier answers is a file from it, or a PAGE:\n// index.html with the caller's screen drawn into it (./document) — the app's own\n// for `/`, one of the manifest's pages for a path that leads to one. index.html\n// itself is never served as a file: it is the template, and goes out drawn.\n//\n// A name with an extension that is neither a file in `dist` nor a page of the\n// manifest is a MISSING FILE, and is answered 404 — not with a screen. A browser\n// holding a page from before a deploy asks for that page's script by its old\n// name; what it needs back is \"gone\", not a document that is not a script.\n//\n// Register the app's own routes FIRST; this is the catch-all. `owned` names the\n// prefixes that are never a page (default: moss's own surfaces) — an unknown\n// path under one is a 404, not a screen.\nexport type SiteConfig = Pick<DocumentConfig, 'draw' | 'htmlAttributes' | 'tokenKey' | 'waitMs'> & {\n dist: string;\n owned?: RegExp;\n};\n\n// The paths the app server answers itself; everything else is the site's.\nexport const MOSS_PATHS = /^\\/(api|catalog|socket|operator|integrations)(\\/|$)/;\n\nexport const mountSite = (server: MossServer, config: SiteConfig): void => {\n const { dist, owned = MOSS_PATHS, ...drawing } = config;\n // serveStatic resolves `root` against the working directory.\n const root = relative(process.cwd(), dist) || '.';\n const files = serveStatic({ root });\n server.use('/*', async (c, next) => {\n const path = c.req.path;\n if (owned.test(path) || path === '/' || path === '/index.html' || server.page(path) !== undefined) return next();\n return files(c, next);\n });\n server.get('*', async (c) => {\n if (owned.test(c.req.path)) return c.notFound();\n // the static server above found no such file, and no page is at this path\n if (extname(c.req.path) !== '' && c.req.path !== '/index.html' && server.page(c.req.path) === undefined) return c.notFound();\n const template = await readFile(join(dist, 'index.html'), 'utf8');\n const page = await renderDocument({\n ...drawing,\n server,\n template,\n request: { path: c.req.path === '/index.html' ? '/' : c.req.path, cookie: c.req.header('cookie') ?? null },\n });\n return c.html(page.html, 200, page.headers);\n });\n};\n\nexport const serve = async (app: NiscApp, runtime: NiscRuntime & { port?: number }): Promise<MossServer> => {\n const server = await createServer(app, runtime);\n const port = runtime.port ?? 8787;\n const httpServer = listen({ fetch: server.fetch, port });\n attachSocket(httpServer, server.socket, '/socket', { ...(runtime.socketCompression !== undefined ? { compression: runtime.socketCompression } : {}) });\n console.log(`moss serving http://localhost:${port}`);\n console.log(`surfaces: GET /catalog · GET|POST /api/vex · GET|POST /api/<resource>/vex · ws://localhost:${port}/socket`);\n return server;\n};\n"]}
1
+ {"version":3,"sources":["../src/node.ts"],"names":["listen"],"mappings":";;;;;;;AAgCO,IAAM,eAAe,CAC1B,UAAA,EACA,MAAA,EACA,IAAA,GAAO,WACP,OAAA,KACS;AACT,EAAA,MAAM,GAAA,GAAM,IAAI,eAAA,CAAgB,EAAE,QAAA,EAAU,MAAM,iBAAA,EAAmB,OAAA,EAAS,WAAA,IAAe,IAAA,EAAM,CAAA;AACnG,EAAA,UAAA,CAAW,EAAA,CAAG,SAAA,EAAW,CAAC,GAAA,EAAK,QAAQ,IAAA,KAAS;AAC9C,IAAA,MAAM,GAAA,GAAM,IAAI,GAAA,IAAO,GAAA;AAGvB,IAAA,IAAI,IAAI,GAAA,CAAI,GAAA,EAAK,mBAAmB,CAAA,CAAE,aAAa,IAAA,EAAM;AACzD,IAAA,GAAA,CAAI,aAAA,CAAc,GAAA,EAAK,MAAA,EAAQ,IAAA,EAAM,CAAC,EAAA,KAAO;AAK3C,MAAA,MAAA,CAAO,GAAA,EAAK;AAAA,QACV,IAAA,EAAM,CAAC,IAAA,KAAS,EAAA,CAAG,KAAK,IAAI,CAAA;AAAA,QAC5B,OAAO,CAAC,IAAA,EAAM,WAAW,EAAA,CAAG,KAAA,CAAM,MAAM,MAAM,CAAA;AAAA,QAC9C,SAAA,EAAW,CAAC,EAAA,KAAO,EAAA,CAAG,EAAA,CAAG,SAAA,EAAW,CAAC,IAAA,KAAS,EAAA,CAAG,MAAA,CAAO,IAAI,CAAC,CAAC,CAAA;AAAA,QAC9D,OAAA,EAAS,CAAC,EAAA,KAAO,EAAA,CAAG,GAAG,OAAA,EAAS,MAAM,IAAI;AAAA,OAC3C,CAAA,CAAE,KAAA,CAAM,CAAC,KAAA,KAAmB;AAC3B,QAAA,OAAA,CAAQ,KAAA,CAAM,4CAA4C,KAAK,CAAA;AAC/D,QAAA,IAAI;AACF,UAAA,EAAA,CAAG,KAAA,CAAM,MAAM,eAAe,CAAA;AAAA,QAChC,CAAA,CAAA,MAAQ;AAAA,QAER;AAAA,MACF,CAAC,CAAA;AAAA,IACH,CAAC,CAAA;AAAA,EACH,CAAC,CAAA;AACH;AAyBO,IAAM,UAAA,GAAa;AAEnB,IAAM,SAAA,GAAY,CAAC,MAAA,EAAoB,MAAA,KAA6B;AACzE,EAAA,MAAM,EAAE,IAAA,EAAM,KAAA,GAAQ,UAAA,EAAY,GAAG,SAAQ,GAAI,MAAA;AAEjD,EAAA,MAAM,OAAO,QAAA,CAAS,OAAA,CAAQ,GAAA,EAAI,EAAG,IAAI,CAAA,IAAK,GAAA;AAC9C,EAAA,MAAM,KAAA,GAAQ,WAAA,CAAY,EAAE,IAAA,EAAM,CAAA;AAClC,EAAA,MAAA,CAAO,GAAA,CAAI,IAAA,EAAM,OAAO,CAAA,EAAG,IAAA,KAAS;AAClC,IAAA,MAAM,IAAA,GAAO,EAAE,GAAA,CAAI,IAAA;AACnB,IAAA,IAAI,KAAA,CAAM,IAAA,CAAK,IAAI,CAAA,IAAK,SAAS,GAAA,IAAO,IAAA,KAAS,aAAA,IAAiB,MAAA,CAAO,IAAA,CAAK,IAAI,CAAA,KAAM,MAAA,SAAkB,IAAA,EAAK;AAC/G,IAAA,OAAO,KAAA,CAAM,GAAG,IAAI,CAAA;AAAA,EACtB,CAAC,CAAA;AACD,EAAA,MAAA,CAAO,GAAA,CAAI,GAAA,EAAK,OAAO,CAAA,KAAM;AAC3B,IAAA,IAAI,KAAA,CAAM,KAAK,CAAA,CAAE,GAAA,CAAI,IAAI,CAAA,EAAG,OAAO,EAAE,QAAA,EAAS;AAE9C,IAAA,IAAI,QAAQ,CAAA,CAAE,GAAA,CAAI,IAAI,CAAA,KAAM,EAAA,IAAM,EAAE,GAAA,CAAI,IAAA,KAAS,iBAAiB,MAAA,CAAO,IAAA,CAAK,EAAE,GAAA,CAAI,IAAI,MAAM,MAAA,EAAW,OAAO,EAAE,QAAA,EAAS;AAC3H,IAAA,MAAM,WAAW,MAAM,QAAA,CAAS,KAAK,IAAA,EAAM,YAAY,GAAG,MAAM,CAAA;AAChE,IAAA,MAAM,IAAA,GAAO,MAAM,cAAA,CAAe;AAAA,MAChC,GAAG,OAAA;AAAA,MACH,MAAA;AAAA,MACA,QAAA;AAAA,MACA,SAAS,EAAE,IAAA,EAAM,CAAA,CAAE,GAAA,CAAI,SAAS,aAAA,GAAgB,GAAA,GAAM,CAAA,CAAE,GAAA,CAAI,MAAM,MAAA,EAAQ,CAAA,CAAE,IAAI,MAAA,CAAO,QAAQ,KAAK,IAAA;AAAK,KAC1G,CAAA;AACD,IAAA,OAAO,EAAE,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,GAAA,EAAK,KAAK,OAAO,CAAA;AAAA,EAC5C,CAAC,CAAA;AACH;AAEO,IAAM,KAAA,GAAQ,OAAO,GAAA,EAAc,OAAA,KAAkE;AAC1G,EAAA,MAAM,MAAA,GAAS,MAAM,YAAA,CAAa,GAAA,EAAK,OAAO,CAAA;AAC9C,EAAA,MAAM,IAAA,GAAO,QAAQ,IAAA,IAAQ,IAAA;AAC7B,EAAA,MAAM,aAAaA,OAAA,CAAO,EAAE,OAAO,MAAA,CAAO,KAAA,EAAO,MAAM,CAAA;AACvD,EAAA,YAAA,CAAa,YAAY,MAAA,CAAO,MAAA,EAAQ,SAAA,EAAW,EAAE,GAAI,OAAA,CAAQ,iBAAA,KAAsB,MAAA,GAAY,EAAE,aAAa,OAAA,CAAQ,iBAAA,EAAkB,GAAI,IAAK,CAAA;AACrJ,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,8BAAA,EAAiC,IAAI,CAAA,CAAE,CAAA;AACnD,EAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,oGAAA,EAA8F,IAAI,CAAA,OAAA,CAAS,CAAA;AACvH,EAAA,OAAO,MAAA;AACT","file":"chunk-DPFWL7BS.js","sourcesContent":["import { readFile } from 'node:fs/promises';\nimport { extname, join, relative } from 'node:path';\nimport { serve as listen } from '@hono/node-server';\nimport { serveStatic } from '@hono/node-server/serve-static';\nimport { WebSocketServer } from 'ws';\nimport type { IncomingMessage } from 'node:http';\nimport type { Duplex } from 'node:stream';\nimport { createServer } from './server';\nimport type { MossServer } from './server';\nimport type { NiscApp } from './app';\nimport type { NiscRuntime } from './runtime';\nimport type { SocketAccept } from './socket';\nimport { renderDocument } from './document';\nimport type { DocumentConfig } from './document';\n\n// ═══════════════════════════════════════════════════════════════\n// The Node entry — runtime-specific by design: the transport is a seam, so\n// the Bun flip swaps this file, never the app. Two exports: the\n// websocket transport for hosts that run their own listener (the dev\n// checks, vite), and the batteries-included `serve`.\n// ═══════════════════════════════════════════════════════════════\n\n// Anything that emits Node upgrade events — http.Server structurally, so\n// the @hono/node-server return type needs no narrowing.\ntype Upgradeable = {\n on: (event: 'upgrade', handler: (req: IncomingMessage, socket: Duplex, head: Buffer) => void) => unknown;\n};\n\n// The `ws` half of the transport seam: RFC 6455 stays library-handled\n// (permessage-deflate on by default — see `runtime.socketCompression`); the\n// protocol above the seam is nisc's own (../socket.ts) and identical on every\n// runtime.\nexport const attachSocket = (\n httpServer: Upgradeable,\n accept: SocketAccept,\n path = '/socket',\n options?: { compression?: boolean | Record<string, unknown> },\n): void => {\n const wss = new WebSocketServer({ noServer: true, perMessageDeflate: options?.compression ?? true });\n httpServer.on('upgrade', (req, socket, head) => {\n const url = req.url ?? '/';\n // Not ours: leave it for whichever other listener owns it (vite's HMR\n // upgrade rides the same server in dev).\n if (new URL(url, 'http://nisc.local').pathname !== path) return;\n wss.handleUpgrade(req, socket, head, (ws) => {\n // accept promises to handle its own failures (see socket.ts). This is\n // the floor under that promise: an await added there without a guard\n // degrades to one logged close here instead of an unhandled rejection\n // taking every session on the box down with it.\n accept(url, {\n send: (text) => ws.send(text),\n close: (code, reason) => ws.close(code, reason),\n onMessage: (fn) => ws.on('message', (data) => fn(String(data))),\n onClose: (fn) => ws.on('close', () => fn()),\n }).catch((error: unknown) => {\n console.error('[moss/node] a connection escaped accept:', error);\n try {\n ws.close(1011, 'accept failed');\n } catch {\n // already gone\n }\n });\n });\n });\n};\n\n// THE BUILT TERMINAL, served by the same process as the app — one origin, so the\n// socket is `/socket` wherever the page came from.\n//\n// `dist` is what the app's bundler wrote: index.html and its assets. Every GET\n// that nothing registered earlier answers is a file from it, or a PAGE:\n// index.html with the caller's screen drawn into it (./document) — the app's own\n// for `/`, one of the manifest's pages for a path that leads to one. index.html\n// itself is never served as a file: it is the template, and goes out drawn.\n//\n// A name with an extension that is neither a file in `dist` nor a page of the\n// manifest is a MISSING FILE, and is answered 404 — not with a screen. A browser\n// holding a page from before a deploy asks for that page's script by its old\n// name; what it needs back is \"gone\", not a document that is not a script.\n//\n// Register the app's own routes FIRST; this is the catch-all. `owned` names the\n// prefixes that are never a page (default: moss's own surfaces) — an unknown\n// path under one is a 404, not a screen.\nexport type SiteConfig = Pick<DocumentConfig, 'draw' | 'htmlAttributes' | 'site' | 'tokenKey' | 'waitMs'> & {\n dist: string;\n owned?: RegExp;\n};\n\n// The paths the app server answers itself; everything else is the site's.\nexport const MOSS_PATHS = /^\\/(api|catalog|socket|operator|integrations)(\\/|$)/;\n\nexport const mountSite = (server: MossServer, config: SiteConfig): void => {\n const { dist, owned = MOSS_PATHS, ...drawing } = config;\n // serveStatic resolves `root` against the working directory.\n const root = relative(process.cwd(), dist) || '.';\n const files = serveStatic({ root });\n server.use('/*', async (c, next) => {\n const path = c.req.path;\n if (owned.test(path) || path === '/' || path === '/index.html' || server.page(path) !== undefined) return next();\n return files(c, next);\n });\n server.get('*', async (c) => {\n if (owned.test(c.req.path)) return c.notFound();\n // the static server above found no such file, and no page is at this path\n if (extname(c.req.path) !== '' && c.req.path !== '/index.html' && server.page(c.req.path) === undefined) return c.notFound();\n const template = await readFile(join(dist, 'index.html'), 'utf8');\n const page = await renderDocument({\n ...drawing,\n server,\n template,\n request: { path: c.req.path === '/index.html' ? '/' : c.req.path, cookie: c.req.header('cookie') ?? null },\n });\n return c.html(page.html, 200, page.headers);\n });\n};\n\nexport const serve = async (app: NiscApp, runtime: NiscRuntime & { port?: number }): Promise<MossServer> => {\n const server = await createServer(app, runtime);\n const port = runtime.port ?? 8787;\n const httpServer = listen({ fetch: server.fetch, port });\n attachSocket(httpServer, server.socket, '/socket', { ...(runtime.socketCompression !== undefined ? { compression: runtime.socketCompression } : {}) });\n console.log(`moss serving http://localhost:${port}`);\n console.log(`surfaces: GET /catalog · GET|POST /api/vex · GET|POST /api/<resource>/vex · ws://localhost:${port}/socket`);\n return server;\n};\n"]}
@@ -1,3 +1,4 @@
1
+ import { ScreenHead } from '@niscorp/nova/document';
1
2
  import * as _niscorp_nova from '@niscorp/nova';
2
3
  import { LayoutPaletteEntry, ActionDefinition, Shell, FetchFn, LayoutNode, CanvasConfig, ActionFragment, FunctionHandler, RenderNode } from '@niscorp/nova';
3
4
  import { PgPool, MutationClient, CacheBackend, ScopePolicy, ScopeBehaviors, SeedEntry, SeedMutation } from '@niscorp/vex';
@@ -967,6 +968,7 @@ type DocumentConfig = {
967
968
  };
968
969
  draw: (snapshot: ShellSnapshot) => string | Promise<string>;
969
970
  htmlAttributes?: (snapshot: ShellSnapshot) => Record<string, string>;
971
+ site?: string;
970
972
  tokenKey?: string;
971
973
  waitMs?: number;
972
974
  root?: string;
@@ -977,6 +979,7 @@ type DrawnDocument = {
977
979
  drawn: boolean;
978
980
  principal: string | null;
979
981
  page?: string;
982
+ head?: ScreenHead;
980
983
  live?: boolean;
981
984
  why?: string[];
982
985
  drawnWith?: string[];
@@ -987,6 +990,7 @@ type ExportedDocument = {
987
990
  path: string;
988
991
  html: string;
989
992
  page?: string;
993
+ head?: ScreenHead;
990
994
  drawn: boolean;
991
995
  live: boolean;
992
996
  why: string[];
@@ -1,3 +1,4 @@
1
+ import { ScreenHead } from '@niscorp/nova/document';
1
2
  import * as _niscorp_nova from '@niscorp/nova';
2
3
  import { LayoutPaletteEntry, ActionDefinition, Shell, FetchFn, LayoutNode, CanvasConfig, ActionFragment, FunctionHandler, RenderNode } from '@niscorp/nova';
3
4
  import { PgPool, MutationClient, CacheBackend, ScopePolicy, ScopeBehaviors, SeedEntry, SeedMutation } from '@niscorp/vex';
@@ -967,6 +968,7 @@ type DocumentConfig = {
967
968
  };
968
969
  draw: (snapshot: ShellSnapshot) => string | Promise<string>;
969
970
  htmlAttributes?: (snapshot: ShellSnapshot) => Record<string, string>;
971
+ site?: string;
970
972
  tokenKey?: string;
971
973
  waitMs?: number;
972
974
  root?: string;
@@ -977,6 +979,7 @@ type DrawnDocument = {
977
979
  drawn: boolean;
978
980
  principal: string | null;
979
981
  page?: string;
982
+ head?: ScreenHead;
980
983
  live?: boolean;
981
984
  why?: string[];
982
985
  drawnWith?: string[];
@@ -987,6 +990,7 @@ type ExportedDocument = {
987
990
  path: string;
988
991
  html: string;
989
992
  page?: string;
993
+ head?: ScreenHead;
990
994
  drawn: boolean;
991
995
  live: boolean;
992
996
  why: string[];
package/dist/index.cjs CHANGED
@@ -16,6 +16,7 @@ var zod = require('zod');
16
16
  var reflect = require('@niscorp/nova/reflect');
17
17
  var i18n = require('@niscorp/nova/i18n');
18
18
  var prism = require('@niscorp/prism');
19
+ var document = require('@niscorp/nova/document');
19
20
 
20
21
  // src/app.ts
21
22
  var defineApp = (app) => app;
@@ -3554,8 +3555,6 @@ var createTideDriver = (config) => {
3554
3555
  }
3555
3556
  };
3556
3557
  };
3557
-
3558
- // src/document.ts
3559
3558
  var SNAPSHOT_ELEMENT_ID = "nisc-snapshot";
3560
3559
  var DEFAULT_TOKEN_KEY = "nisc.token";
3561
3560
  var DEFAULT_ROOT = '<div id="root"></div>';
@@ -3599,9 +3598,13 @@ var renderDocument = async (config) => {
3599
3598
  });
3600
3599
  const screen = await draw(snapshot);
3601
3600
  const attributes = Object.entries(config.htmlAttributes?.(snapshot) ?? {}).map(([name, value]) => ` ${name}="${escapeAttribute(value)}"`).join("");
3602
- const html = template.replace(root, () => `${root.replace("></div>", () => `>${screen}</div>`)}${embedSnapshot(snapshot, principal, request.path)}`).replace(/<html([^>]*)>/, (whole, existing) => attributes === "" ? whole : `<html${existing}${attributes}>`);
3601
+ const placed = template.replace(root, () => `${root.replace("></div>", () => `>${screen}</div>`)}${embedSnapshot(snapshot, principal, request.path)}`).replace(/<html([^>]*)>/, (whole, existing) => attributes === "" ? whole : `<html${existing}${attributes}>`);
3602
+ const head = document.headOf({ frame: () => snapshot.frame, canvasTree: (id) => snapshot.trees[id] ?? [] });
3603
+ for (const why of head?.refused ?? []) console.error(`[moss/document] "${request.path}" \u2014 ${why}`);
3604
+ const html = document.placeHead(placed, head?.elements, { ...config.site !== void 0 ? { site: config.site } : {}, path: request.path });
3603
3605
  return {
3604
3606
  html,
3607
+ ...head !== void 0 ? { head } : {},
3605
3608
  headers: {
3606
3609
  ...documentHeaders(principal),
3607
3610
  ...token !== null && principal === null ? { "set-cookie": `${encodeURIComponent(tokenKey)}=; Path=/; Max-Age=0; SameSite=Lax` } : {}
@@ -3628,6 +3631,7 @@ var exportDocuments = async (config) => {
3628
3631
  path,
3629
3632
  html: page.html,
3630
3633
  ...page.page !== void 0 ? { page: page.page } : {},
3634
+ ...page.head !== void 0 ? { head: page.head } : {},
3631
3635
  drawn: page.drawn,
3632
3636
  // undrawn is not concluded finished
3633
3637
  live: page.live ?? true,