@parlor/client 0.1.0 → 0.3.0

package/dist/ssr/render.js

@@ -0,0 +1,96 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { RouterContextProvider, Scripts } from "@tanstack/react-router";
+import { createRequestHandler, getSsrStatus, transformHtmlStringWithRouter, } from "@tanstack/react-router/ssr/server";
+import { createElement } from "react";
+import { renderToReadableStream, renderToString } from "react-dom/server";
+import { createActionClient } from "../action-client.js";
+import { SERVER_RENDERED } from "../router/mount.js";
+const FORWARDED_HEADERS = ["cookie", "authorization"];
+const APP_TAG = "parlor-app";
+const CONTAINER = /<([a-z][\w-]*)(\s[^>]*?\bid=(["']?)root\3(?:\s[^>]*)?)>\s*<\/\1>/i;
+const TITLE = /<title[\s>]/i;
+const TEMPLATE_TITLE = /\s*<title[^>]*>[\s\S]*?<\/title>/i;
+let warnedNoContainer = false;
+function forwarded(headers) {
+    const kept = {};
+    for (const name of FORWARDED_HEADERS) {
+        const value = headers.get(name);
+        if (value !== null)
+            kept[name] = value;
+    }
+    return kept;
+}
+/** A route that says it never renders on the server settles it before any loader runs. */
+function declined(router, pathname) {
+    const [routes] = router.getMatchedRoutes(pathname);
+    return routes.some((route) => {
+        const ssr = route.options.ssr ?? router.options.defaultSsr ?? true;
+        return ssr === false || ssr === "data-only";
+    });
+}
+/**
+ * Every element above the app has one child, so `useId` counts as it does from the browser's
+ * root. The router's scripts render after the app, once it has taken what loaders dehydrated.
+ */
+async function renderDocument(router, element, nonce) {
+    const stream = await renderToReadableStream(_jsx("html", { children: _jsx("body", { children: createElement(APP_TAG, null, element) }) }), {
+        nonce,
+        progressiveChunkSize: Number.POSITIVE_INFINITY,
+        onError: (error) => console.error("[parlor] Server render:", error),
+    });
+    await stream.allReady;
+    const app = await new Response(stream).text();
+    const scripts = renderToString(_jsx(RouterContextProvider, { router: router, children: _jsx(Scripts, {}) }));
+    const html = app
+        .replace(/^<!DOCTYPE html>/i, "")
+        .replace("</body>", () => `${scripts}</body>`);
+    return transformHtmlStringWithRouter(router, html);
+}
+/** React renders the app and hoists its head tags; the template keeps everything else. */
+function intoTemplate(template, rendered) {
+    const head = rendered.slice(rendered.indexOf("<head>") + "<head>".length, rendered.indexOf("</head>"));
+    const appStart = rendered.indexOf(`<${APP_TAG}>`) + `<${APP_TAG}>`.length;
+    const appEnd = rendered.lastIndexOf(`</${APP_TAG}>`);
+    const scripts = rendered.slice(appEnd + `</${APP_TAG}>`.length, rendered.lastIndexOf("</body>"));
+    const headEnd = template.indexOf("</head>");
+    const templateHead = template.slice(0, headEnd);
+    const shell = `${TITLE.test(head) ? templateHead.replace(TEMPLATE_TITLE, "") : templateHead}${head}${template.slice(headEnd)}`;
+    return shell.replace(CONTAINER, (_match, tag, attributes) => `<${tag}${attributes} ${SERVER_RENDERED}>${rendered.slice(appStart, appEnd)}</${tag}>${scripts}`);
+}
+/**
+ * Renders one document request with TanStack Router's SSR handler: the loaders run against
+ * the app's server with the request's cookie and authorization, then React renders the
+ * matched routes and the router's state, query cache included, goes along for hydration.
+ */
+export function createRenderer(createApp) {
+    return async (request, { template, fetch, nonce }) => {
+        if (!CONTAINER.test(template)) {
+            if (!warnedNoContainer) {
+                warnedNoContainer = true;
+                console.warn('[parlor] index.html has no empty element with id="root", so pages are not rendered on the server.');
+            }
+            return undefined;
+        }
+        const url = new URL(request.url);
+        const { router, element } = createApp(createActionClient({
+            baseUrl: url.origin,
+            fetch: (input, init) => fetch(new Request(input, init)),
+            headers: forwarded(request.headers),
+        }));
+        if (declined(router, url.pathname))
+            return undefined;
+        router.update({ ...router.options, ssr: { nonce } });
+        const notRendered = new Response();
+        const response = await createRequestHandler({ request, createRouter: () => router })(async ({ responseHeaders }) => {
+            if (!router.state.matches.every((match) => match.ssr === true))
+                return notRendered;
+            const page = intoTemplate(template, await renderDocument(router, element, nonce));
+            return new Response(page, {
+                status: getSsrStatus(router),
+                headers: responseHeaders,
+            });
+        });
+        return response === notRendered ? undefined : response;
+    };
+}
+//# sourceMappingURL=render.js.map

package/dist/ssr/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../src/ssr/render.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAkB,qBAAqB,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EACL,oBAAoB,EACpB,YAAY,EACZ,6BAA6B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAE1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAwB,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAiB3E,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAU,CAAC;AAC/D,MAAM,OAAO,GAAG,YAAY,CAAC;AAC7B,MAAM,SAAS,GAAG,mEAAmE,CAAC;AACtF,MAAM,KAAK,GAAG,cAAc,CAAC;AAC7B,MAAM,cAAc,GAAG,mCAAmC,CAAC;AAE3D,IAAI,iBAAiB,GAAG,KAAK,CAAC;AAE9B,SAAS,SAAS,CAAC,OAAgB;IACjC,MAAM,IAAI,GAA2B,EAAE,CAAC;IACxC,KAAK,MAAM,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,KAAK,KAAK,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;IACzC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,0FAA0F;AAC1F,SAAS,QAAQ,CAAC,MAAiB,EAAE,QAAgB;IACnD,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACnD,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC;QACnE,OAAO,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,WAAW,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,cAAc,CAC3B,MAAiB,EACjB,OAAkB,EAClB,KAAa;IAEb,MAAM,MAAM,GAAG,MAAM,sBAAsB,CACzC,yBACE,yBAAO,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,GAAQ,GAC/C,EACP;QACE,KAAK;QACL,oBAAoB,EAAE,MAAM,CAAC,iBAAiB;QAC9C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC;KACpE,CACF,CAAC;IACF,MAAM,MAAM,CAAC,QAAQ,CAAC;IACtB,MAAM,GAAG,GAAG,MAAM,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,MAAM,OAAO,GAAG,cAAc,CAC5B,KAAC,qBAAqB,IAAC,MAAM,EAAE,MAAM,YACnC,KAAC,OAAO,KAAG,GACW,CACzB,CAAC;IACF,MAAM,IAAI,GAAG,GAAG;SACb,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC;SAChC,OAAO,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,SAAS,CAAC,CAAC;IACjD,OAAO,6BAA6B,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC;AAED,0FAA0F;AAC1F,SAAS,YAAY,CAAC,QAAgB,EAAE,QAAgB;IACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CACzB,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,MAAM,EAC5C,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAC5B,CAAC;IACF,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,OAAO,GAAG,CAAC,GAAG,IAAI,OAAO,GAAG,CAAC,MAAM,CAAC;IAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,WAAW,CAAC,KAAK,OAAO,GAAG,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAC5B,MAAM,GAAG,KAAK,OAAO,GAAG,CAAC,MAAM,EAC/B,QAAQ,CAAC,WAAW,CAAC,SAAS,CAAC,CAChC,CAAC;IACF,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5C,MAAM,YAAY,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,GAAG,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/H,OAAO,KAAK,CAAC,OAAO,CAClB,SAAS,EACT,CAAC,MAAM,EAAE,GAAW,EAAE,UAAkB,EAAE,EAAE,CAC1C,IAAI,GAAG,GAAG,UAAU,IAAI,eAAe,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,MAAM,CAAC,KAAK,GAAG,IAAI,OAAO,EAAE,CACnG,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,SAA0B;IACvD,OAAO,KAAK,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACnD,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBACvB,iBAAiB,GAAG,IAAI,CAAC;gBACzB,OAAO,CAAC,IAAI,CACV,mGAAmG,CACpG,CAAC;YACJ,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,SAAS,CACnC,kBAAkB,CAAC;YACjB,OAAO,EAAE,GAAG,CAAC,MAAM;YACnB,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;YACvD,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC;SACpC,CAAC,CACH,CAAC;QACF,IAAI,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;YAAE,OAAO,SAAS,CAAC;QACrD,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAErD,MAAM,WAAW,GAAG,IAAI,QAAQ,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,CAClF,KAAK,EAAE,EAAE,eAAe,EAAE,EAAE,EAAE;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,KAAK,IAAI,CAAC;gBAC5D,OAAO,WAAW,CAAC;YACrB,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,cAAc,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;YAClF,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE;gBACxB,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC;gBAC5B,OAAO,EAAE,eAAe;aACzB,CAAC,CAAC;QACL,CAAC,CACF,CAAC;QACF,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;IACzD,CAAC,CAAC;AACJ,CAAC","sourcesContent":["import { type AnyRouter, RouterContextProvider, Scripts } from \"@tanstack/react-router\";\nimport {\n  createRequestHandler,\n  getSsrStatus,\n  transformHtmlStringWithRouter,\n} from \"@tanstack/react-router/ssr/server\";\nimport { createElement, type ReactNode } from \"react\";\nimport { renderToReadableStream, renderToString } from \"react-dom/server\";\n\nimport { createActionClient } from \"../action-client.js\";\nimport { type CreateParlorApp, SERVER_RENDERED } from \"../router/mount.js\";\n\nexport interface RenderOptions {\n  /** The app's `index.html` as the browser gets it; the page renders into its `#root`. */\n  readonly template: string;\n  /** Reaches the app's server: in process, through its Durable Object, or over the network in dev. */\n  readonly fetch: (request: Request) => Promise<Response>;\n  /** Goes on every inline script; the response's policy allows it. */\n  readonly nonce: string;\n}\n\n/** The page, or undefined when a route it matches does not render on the server. */\nexport type RenderPage = (\n  request: Request,\n  options: RenderOptions,\n) => Promise<Response | undefined>;\n\nconst FORWARDED_HEADERS = [\"cookie\", \"authorization\"] as const;\nconst APP_TAG = \"parlor-app\";\nconst CONTAINER = /<([a-z][\\w-]*)(\\s[^>]*?\\bid=([\"']?)root\\3(?:\\s[^>]*)?)>\\s*<\\/\\1>/i;\nconst TITLE = /<title[\\s>]/i;\nconst TEMPLATE_TITLE = /\\s*<title[^>]*>[\\s\\S]*?<\\/title>/i;\n\nlet warnedNoContainer = false;\n\nfunction forwarded(headers: Headers): Record<string, string> {\n  const kept: Record<string, string> = {};\n  for (const name of FORWARDED_HEADERS) {\n    const value = headers.get(name);\n    if (value !== null) kept[name] = value;\n  }\n  return kept;\n}\n\n/** A route that says it never renders on the server settles it before any loader runs. */\nfunction declined(router: AnyRouter, pathname: string): boolean {\n  const [routes] = router.getMatchedRoutes(pathname);\n  return routes.some((route) => {\n    const ssr = route.options.ssr ?? router.options.defaultSsr ?? true;\n    return ssr === false || ssr === \"data-only\";\n  });\n}\n\n/**\n * Every element above the app has one child, so `useId` counts as it does from the browser's\n * root. The router's scripts render after the app, once it has taken what loaders dehydrated.\n */\nasync function renderDocument(\n  router: AnyRouter,\n  element: ReactNode,\n  nonce: string,\n): Promise<string> {\n  const stream = await renderToReadableStream(\n    <html>\n      <body>{createElement(APP_TAG, null, element)}</body>\n    </html>,\n    {\n      nonce,\n      progressiveChunkSize: Number.POSITIVE_INFINITY,\n      onError: (error) => console.error(\"[parlor] Server render:\", error),\n    },\n  );\n  await stream.allReady;\n  const app = await new Response(stream).text();\n  const scripts = renderToString(\n    <RouterContextProvider router={router}>\n      <Scripts />\n    </RouterContextProvider>,\n  );\n  const html = app\n    .replace(/^<!DOCTYPE html>/i, \"\")\n    .replace(\"</body>\", () => `${scripts}</body>`);\n  return transformHtmlStringWithRouter(router, html);\n}\n\n/** React renders the app and hoists its head tags; the template keeps everything else. */\nfunction intoTemplate(template: string, rendered: string): string {\n  const head = rendered.slice(\n    rendered.indexOf(\"<head>\") + \"<head>\".length,\n    rendered.indexOf(\"</head>\"),\n  );\n  const appStart = rendered.indexOf(`<${APP_TAG}>`) + `<${APP_TAG}>`.length;\n  const appEnd = rendered.lastIndexOf(`</${APP_TAG}>`);\n  const scripts = rendered.slice(\n    appEnd + `</${APP_TAG}>`.length,\n    rendered.lastIndexOf(\"</body>\"),\n  );\n  const headEnd = template.indexOf(\"</head>\");\n  const templateHead = template.slice(0, headEnd);\n  const shell = `${TITLE.test(head) ? templateHead.replace(TEMPLATE_TITLE, \"\") : templateHead}${head}${template.slice(headEnd)}`;\n  return shell.replace(\n    CONTAINER,\n    (_match, tag: string, attributes: string) =>\n      `<${tag}${attributes} ${SERVER_RENDERED}>${rendered.slice(appStart, appEnd)}</${tag}>${scripts}`,\n  );\n}\n\n/**\n * Renders one document request with TanStack Router's SSR handler: the loaders run against\n * the app's server with the request's cookie and authorization, then React renders the\n * matched routes and the router's state, query cache included, goes along for hydration.\n */\nexport function createRenderer(createApp: CreateParlorApp): RenderPage {\n  return async (request, { template, fetch, nonce }) => {\n    if (!CONTAINER.test(template)) {\n      if (!warnedNoContainer) {\n        warnedNoContainer = true;\n        console.warn(\n          '[parlor] index.html has no empty element with id=\"root\", so pages are not rendered on the server.',\n        );\n      }\n      return undefined;\n    }\n    const url = new URL(request.url);\n    const { router, element } = createApp(\n      createActionClient({\n        baseUrl: url.origin,\n        fetch: (input, init) => fetch(new Request(input, init)),\n        headers: forwarded(request.headers),\n      }),\n    );\n    if (declined(router, url.pathname)) return undefined;\n    router.update({ ...router.options, ssr: { nonce } });\n\n    const notRendered = new Response();\n    const response = await createRequestHandler({ request, createRouter: () => router })(\n      async ({ responseHeaders }) => {\n        if (!router.state.matches.every((match) => match.ssr === true))\n          return notRendered;\n        const page = intoTemplate(template, await renderDocument(router, element, nonce));\n        return new Response(page, {\n          status: getSsrStatus(router),\n          headers: responseHeaders,\n        });\n      },\n    );\n    return response === notRendered ? undefined : response;\n  };\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parlor/client",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "homepage": "https://cychien.github.io/parlor",
   "bugs": "https://github.com/cychien/parlor/issues",
   "license": "MIT",
@@ -22,14 +22,22 @@
     "./react": {
       "types": "./dist/react/index.d.ts",
       "import": "./dist/react/index.js"
+    },
+    "./router": {
+      "types": "./dist/router/index.d.ts",
+      "import": "./dist/router/index.js"
+    },
+    "./ssr": {
+      "types": "./dist/ssr/index.d.ts",
+      "import": "./dist/ssr/index.js"
     }
   },
   "dependencies": {
-    "@parlor/chat": "0.1.0",
-    "@parlor/capabilities": "0.1.0",
-    "@parlor/agent-ui": "0.1.0",
-    "@parlor/core": "0.1.0",
-    "@parlor/sync": "0.1.0"
+    "@parlor/agent-ui": "0.3.0",
+    "@parlor/core": "0.3.0",
+    "@parlor/chat": "0.3.0",
+    "@parlor/sync": "0.3.0",
+    "@parlor/capabilities": "0.3.0"
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.104.1",
@@ -47,7 +55,7 @@
     "zod": "^4.6.5"
   },
   "peerDependencies": {
-    "@tanstack/react-query": ">=5",
+    "@tanstack/react-query": ">=5.102",
     "@tanstack/react-router": ">=1.170",
     "react": ">=19",
     "react-dom": ">=19"