@canonical/react-ssr 0.21.0 → 0.23.0

package/dist/esm/renderer/JSXRenderer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSXRenderer.js","sourceRoot":"","sources":["../../../src/renderer/JSXRenderer.ts"],"names":[],"mappings":"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"}

package/dist/esm/renderer/constants.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/renderer/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC"}

package/dist/esm/renderer/index.js

@@ -1,4 +0,0 @@
-export * from "./constants.js";
-export { default as Extractor } from "./Extractor.js";
-export { default as JSXRenderer } from "./JSXRenderer.js";
-//# sourceMappingURL=index.js.map

package/dist/esm/renderer/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/renderer/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/esm/renderer/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/esm/renderer/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/renderer/types.ts"],"names":[],"mappings":""}

package/dist/esm/server/index.js

@@ -1,2 +0,0 @@
-export * from "./serve.js";
-//# sourceMappingURL=index.js.map

package/dist/esm/server/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/esm/server/serve-express.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-import path from "node:path";
-import { parseArgs } from "node:util";
-import express from "express";
-import { serveStream } from "./serve.js";
-const { values, positionals } = parseArgs({
-    args: process.argv.slice(2),
-    options: {
-        port: {
-            type: "string",
-            alias: "p",
-            default: "5173",
-        },
-        staticFilepath: {
-            type: "string",
-            alias: "s",
-            default: "dist/client/assets",
-        },
-        staticRoute: {
-            type: "string",
-            alias: "r",
-            default: "assets",
-        },
-        streaming: {
-            type: "boolean",
-            default: false,
-        },
-    },
-    strict: true,
-    allowPositionals: true,
-});
-const port = values.port || 5173;
-const cwd = process.cwd();
-const rendererFilePath = path.join(cwd, positionals[0]);
-const staticDir = path.join(cwd, values.staticFilepath || "assets");
-const staticRoute = values.staticRoute || "assets";
-if (!rendererFilePath) {
-    console.error("Usage: node server.js <renderer-path>");
-    process.exit(1);
-}
-const handler = await import(rendererFilePath).then((module) => {
-    if (values.streaming) {
-        return module.default.renderToStream;
-    }
-    else {
-        return module.default.renderToString;
-    }
-});
-if (typeof handler !== "function") {
-    throw new Error("Renderer file must default-export a renderer function.");
-}
-const app = express();
-app.use(`/${staticRoute}`, express.static(staticDir));
-app.use(serveStream(handler));
-app.listen(port, () => {
-    console.log(`Server started on http://localhost:${port}/`);
-});
-//# sourceMappingURL=serve-express.js.map

package/dist/esm/server/serve-express.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serve-express.js","sourceRoot":"","sources":["../../../src/server/serve-express.ts"],"names":[],"mappings":";AAEA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,OAAO,MAAM,SAAS,CAAC;AAE9B,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,SAAS,CAAC;IACxC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,OAAO,EAAE;QACP,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,MAAM;SAChB;QACD,cAAc,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,oBAAoB;SAC9B;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,KAAK,EAAE,GAAG;YACV,OAAO,EAAE,QAAQ;SAClB;QACD,SAAS,EAAE;YACT,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;SACf;KACF;IACD,MAAM,EAAE,IAAI;IACZ,gBAAgB,EAAE,IAAI;CACvB,CAAC,CAAC;AAEH,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC;AACjC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;AAC1B,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AACxD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,cAAc,IAAI,QAAQ,CAAC,CAAC;AACpE,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,IAAI,QAAQ,CAAC;AAEnD,IAAI,CAAC,gBAAgB,EAAE,CAAC;IACtB,OAAO,CAAC,KAAK,CAAC,uCAAuC,CAAC,CAAC;IACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,OAAO,GAAkB,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;IAC5E,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrB,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC;IACvC,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;IAClC,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;AAEtB,GAAG,CAAC,GAAG,CAAC,IAAI,WAAW,EAAE,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;AACtD,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;AAE9B,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,sCAAsC,IAAI,GAAG,CAAC,CAAC;AAC7D,CAAC,CAAC,CAAC"}

package/dist/esm/server/serve.js

@@ -1,41 +0,0 @@
-/**
- * Execute a request handler that renders a React component to a stream, then streams it back to the client.
- * This function should be used as a request controller in an HTTP server.
- * @param handler A request handler that renders a React component to a stream.
- * @throws Error if the handler throws an error during rendering.
- * @returns The stream generated by the handler
- * @example ```ts
- * import express from "express";
- * import { serveStream } from "@canonical/react-ssr/server";
- * import { JSXRenderer } from "@canonical/react-ssr/renderer";
- * // htmlString is created by some build process that bundles the client code
- * import htmlString from "../../dist/client/index.html?raw";
- * import EntryServer from "./entry-server.js";
- *
- * // `EntryServer` is an instance of `@canonical/react-ssr/renderer/ServerEntrypoint`
- * const Renderer = new JSXRenderer(EntryServer, {
- *   htmlString,
- * });
- *
- * const ssrHandler = Renderer.render;
- *
- * const app = express();
- *
- * app.use("/(assets|public)", express.static("dist/client/assets"));
- * app.use(serveStream(ssrHandler));
- */
-export function serveStream(handler) {
-    return (req, res) => {
-        try {
-            res.setHeader("Content-Type", "text/html");
-            res.setHeader("Transfer-Encoding", "chunked");
-            handler(req, res);
-        }
-        catch (error) {
-            console.error("Error during rendering:", error);
-            res.statusCode = 500;
-            res.end("Internal server error");
-        }
-    };
-}
-//# sourceMappingURL=serve.js.map

package/dist/esm/server/serve.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../src/server/serve.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,WAAW,CAAC,OAAsB;IAChD,OAAO,CAAC,GAAoB,EAAE,GAAmB,EAAE,EAAE;QACnD,IAAI,CAAC;YACH,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;YAC3C,GAAG,CAAC,SAAS,CAAC,mBAAmB,EAAE,SAAS,CAAC,CAAC;YAC9C,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACpB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;YAChD,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC;YACrB,GAAG,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAC;QACnC,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/types/renderer/Extractor.d.ts

@@ -1,68 +0,0 @@
-import { type Document, type Element } from "domhandler";
-import React from "react";
-/**
- * Parses an HTML string to extract and convert the <head> tags to React.createElement calls.
- * The tags extracted are:
- * - title
- * - style
- * - meta
- * - link
- * - script
- * - base
- */
-declare class Extractor {
-    /**
-     * A document object representing the DOM of a page.
-     */
-    protected readonly document: Document;
-    /**
-     * Creates an Extractor object for a given HTML string.
-     */
-    constructor(html: string);
-    /**
-     * Searches elements with the specified tag in the document.
-     *
-     * @remark The method uses the parsed {@link Extractor.document | document} to navigate the
-     * whole DOM (usinig a stack) and checks for the elements with the tag name that matches
-     * the given parameter.
-     */
-    protected getElementsByTagName(tagName: string): Element[];
-    /**
-     * Converts HTML keys to React keys.
-     *
-     * @remark There are some HTML attributes that don't map exactly to React with the same name.
-     * For example, class -> className.
-     */
-    protected convertKeyToReactKey(key: string): string;
-    /**
-     * Converts a parsed {@link domhandler#Element | DOM Element} into a {@link react#React.ReactElement | ReactElement}.
-     *
-     * @remark The method takes into account the attributes of the parsed {@link domhandler#Element | Element}
-     * and passes them as props when creating the {@link react#React.ReactElement | ReactElement}.
-     * It only handles children of type "text".
-     */
-    protected convertToReactElement(element: Element, index: number): React.ReactElement;
-    /**
-     * Finds all <link> elements in the {@link Extractor.document | document} and converts them
-     * into {@link react#React.ReactElement | ReactElements}.
-     *
-     * @remark The list of elements returned will be in order of appearance in the DOM.
-     */
-    getLinkElements(): React.ReactElement[];
-    /**
-     * Finds all <script> elements in the {@link Extractor.document | document} and converts them
-     * into {@link react#React.ReactElement | ReactElements}.
-     *
-     * @remark The list of elements returned will be in order of appearance in the DOM.
-     */
-    getScriptElements(): React.ReactElement[];
-    /**
-     * Finds all the <head> elements which are not "script" or "link" in the {@link Extractor.document | document}
-     * and converts them into {@link react#React.ReactElement | ReactElements}.
-     *
-     * @remark The list of elements returned will be in order of appearance in the DOM.
-     */
-    getOtherHeadElements(): React.ReactElement[];
-}
-export default Extractor;
-//# sourceMappingURL=Extractor.d.ts.map

package/dist/types/renderer/Extractor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Extractor.d.ts","sourceRoot":"","sources":["../../../src/renderer/Extractor.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,OAAO,EAAoB,MAAM,YAAY,CAAC;AAE3E,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B;;;;;;;;;GASG;AACH,cAAM,SAAS;IACb;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAEtC;;OAEG;gBACS,IAAI,EAAE,MAAM;IAIxB;;;;;;OAMG;IACH,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,EAAE;IAwB1D;;;;;OAKG;IACH,SAAS,CAAC,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAKnD;;;;;;OAMG;IACH,SAAS,CAAC,qBAAqB,CAC7B,OAAO,EAAE,OAAO,EAChB,KAAK,EAAE,MAAM,GACZ,KAAK,CAAC,YAAY;IAiBrB;;;;;OAKG;IACI,eAAe,IAAI,KAAK,CAAC,YAAY,EAAE;IAO9C;;;;;OAKG;IACI,iBAAiB,IAAI,KAAK,CAAC,YAAY,EAAE;IAOhD;;;;;OAKG;IACI,oBAAoB,IAAI,KAAK,CAAC,YAAY,EAAE;CAQpD;AAED,eAAe,SAAS,CAAC"}

package/dist/types/renderer/JSXRenderer.d.ts

@@ -1,71 +0,0 @@
-import { type RenderToPipeableStreamOptions } from "react-dom/server";
-import Extractor from "./Extractor.js";
-import type { RendererOptions, RenderHandler, ServerEntrypoint, ServerEntrypointProps } from "./types.js";
-/**
- * This class is responsible for rendering a React JSX component and sending it as response to a client.
- * It offers 2 ways of doing it:
- * - As string
- * - As stream
- * Each way has its advantages and inconveniences. You can read more about them in the package README.
- */
-export default class JSXRenderer<TComponent extends ServerEntrypoint<InitialData>, InitialData extends Record<string, unknown>> {
-    protected readonly Component: TComponent;
-    protected readonly initialData: InitialData;
-    protected readonly options: RendererOptions;
-    protected extractor: Extractor | undefined;
-    /**
-     * Creates a renderer instance which can be used to write Server Side Rendered HTML
-     * into a {@link node:http#ServerResponse | ServerResponse}.
-     */
-    constructor(Component: TComponent, initialData?: InitialData, options?: RendererOptions);
-    /**
-     * Gets the locale to be used for the rendered page.
-     * Default if there was no locale passed as option is "en".
-     */
-    getLocale(): string;
-    /**
-     * Gets the props needed to render the component.
-     */
-    protected getComponentProps(): ServerEntrypointProps<InitialData>;
-    /**
-     * Gets a list of all the "src" attributes of the given scripts that match the passed type.
-     */
-    protected getScriptSourcesByType(scripts: React.ReactElement[], type: "module" | "classic"): string[];
-    /**
-     * Adds some properties to the options that are passed to {@link react-dom#renderToPipeableStream | renderToPipeableStream}.
-     *
-     * @remark The options that are added are:
-     * - bootstrapScriptContent: includes the initial data passed as prop to the component in a <script> so that it
-     *  is available when rendering the page in the browser (to avoid hydration mismatches).
-     * - bootstrapScripts: classic scripts which react strips out of the page. The only way to add them is to include them
-     *  in this property.
-     * - bootstrapModules: module scripts which react also strips out of the page and need to be added like this.
-     */
-    protected enrichRendererOptions(props: ServerEntrypointProps<InitialData>): RenderToPipeableStreamOptions;
-    /**
-     * This function is responsible for rendering a React component and sending it to the client through
-     * a pipeable stream.
-     *
-     * @remark See the README to understand the difference between rendering options.
-     *
-     * The streaming might improve the time taken for the page to be rendered and interactive
-     * (at least in part), using React's Suspense/lazy API and pipeable streams.
-     *
-     * CAUTION: The resulting HTML rendered this way is not cacheable.
-     */
-    renderToStream: RenderHandler;
-    /**
-     * Renders this renderer's JSX component as a string and writes it to the given
-     * {@link node:http#ServerResponse | ServerResponse}.
-     *
-     * @remark See the README to understand the difference between rendering options.
-     *
-     * Rendering to string means all <Suspense> components are loaded synchronously and the response
-     * won't be sent to the client until all components have finished loading data and processing.
-     *
-     * renderToString is useful in Vite Dev mode, as the HMR doesn't work well with Suspense
-     * and the Pipeable Stream rendering. Also if the resulting document needs to be cached.
-     */
-    renderToString: RenderHandler;
-}
-//# sourceMappingURL=JSXRenderer.d.ts.map

package/dist/types/renderer/JSXRenderer.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"JSXRenderer.d.ts","sourceRoot":"","sources":["../../../src/renderer/JSXRenderer.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,6BAA6B,EAGnC,MAAM,kBAAkB,CAAC;AAE1B,OAAO,SAAS,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EAEb,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,OAAO,WAAW,CAC9B,UAAU,SAAS,gBAAgB,CAAC,WAAW,CAAC,EAChD,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IASzC,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU;IACxC,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW;IAC3C,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,eAAe;IAT7C,SAAS,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,CAAC;IAE3C;;;OAGG;gBAEkB,SAAS,EAAE,UAAU,EACrB,WAAW,GAAE,WAA+B,EAC5C,OAAO,GAAE,eAAoB;IAOlD;;;OAGG;IACI,SAAS,IAAI,MAAM;IAI1B;;OAEG;IACH,SAAS,CAAC,iBAAiB,IAAI,qBAAqB,CAAC,WAAW,CAAC;IAUjE;;OAEG;IACH,SAAS,CAAC,sBAAsB,CAC9B,OAAO,EAAE,KAAK,CAAC,YAAY,EAAE,EAC7B,IAAI,EAAE,QAAQ,GAAG,SAAS,GACzB,MAAM,EAAE;IAsBX;;;;;;;;;OASG;IACH,SAAS,CAAC,qBAAqB,CAC7B,KAAK,EAAE,qBAAqB,CAAC,WAAW,CAAC,GACxC,6BAA6B;IA6BhC;;;;;;;;;;OAUG;IACH,cAAc,EAAE,aAAa,CAqD3B;IAEF;;;;;;;;;;;OAWG;IACH,cAAc,EAAE,aAAa,CAW3B;CACH"}

package/dist/types/renderer/constants.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/renderer/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,qBAAqB,CAAC"}

package/dist/types/renderer/index.d.ts

@@ -1,5 +0,0 @@
-export * from "./constants.js";
-export { default as Extractor } from "./Extractor.js";
-export { default as JSXRenderer } from "./JSXRenderer.js";
-export type { RendererOptions, RenderHandler, RenderResult, ServerEntrypoint, ServerEntrypointProps, } from "./types.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/types/renderer/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/renderer/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC1D,YAAY,EACV,eAAe,EACf,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/types/renderer/types.d.ts

@@ -1,35 +0,0 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type * as React from "react";
-import type { PipeableStream, RenderToPipeableStreamOptions } from "react-dom/server";
-export interface RendererOptions {
-    defaultLocale?: string;
-    /** An HTML string to extract the head tags from */
-    htmlString?: string;
-    /**
-     * Options to pass to `react-dom/server.renderToPipeableStream`.
-     * See https://react.dev/reference/react-dom/server/renderToPipeableStream#parameters.
-     */
-    renderToPipeableStreamOptions?: RenderToPipeableStreamOptions;
-}
-/** The props that the server entrypoint component will receive */
-export interface ServerEntrypointProps<InitialData extends Record<string, unknown>> {
-    /** The language of the page. This is typically read from the request headers. */
-    lang?: string;
-    /** The script tags to include in the page */
-    scriptElements?: React.ReactElement[];
-    /** The link tags to include in the page */
-    linkElements?: React.ReactElement[];
-    /** Other head elements: title, base, style & meta */
-    otherHeadElements?: React.ReactElement[];
-    /**
-     * Initial data used in the server to render the React application, which needs to be
-     * embedded in the resulting HTML so that the hydration in the client matches that of the server.
-     */
-    initialData?: InitialData;
-}
-export type ServerEntrypoint<InitialData extends Record<string, unknown>> = React.ComponentType<ServerEntrypointProps<InitialData>>;
-/** The result of rendering a React component */
-export type RenderResult = PipeableStream;
-/** A function that renders a React component */
-export type RenderHandler = (req: IncomingMessage, res: ServerResponse) => void;
-//# sourceMappingURL=types.d.ts.map

package/dist/types/renderer/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/renderer/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAC;AACpC,OAAO,KAAK,EACV,cAAc,EACd,6BAA6B,EAC9B,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,eAAe;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mDAAmD;IACnD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,6BAA6B,CAAC,EAAE,6BAA6B,CAAC;CAC/D;AAED,kEAAkE;AAClE,MAAM,WAAW,qBAAqB,CACpC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAE3C,iFAAiF;IACjF,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6CAA6C;IAC7C,cAAc,CAAC,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;IACtC,2CAA2C;IAC3C,YAAY,CAAC,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;IACpC,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC;IACzC;;;OAGG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,MAAM,MAAM,gBAAgB,CAAC,WAAW,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IACtE,KAAK,CAAC,aAAa,CAAC,qBAAqB,CAAC,WAAW,CAAC,CAAC,CAAC;AAI1D,gDAAgD;AAChD,MAAM,MAAM,YAAY,GAAG,cAAc,CAAC;AAC1C,gDAAgD;AAChD,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC"}

package/dist/types/server/index.d.ts

@@ -1,2 +0,0 @@
-export * from "./serve.js";
-//# sourceMappingURL=index.d.ts.map

package/dist/types/server/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/types/server/serve-express.d.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-export {};
-//# sourceMappingURL=serve-express.d.ts.map

package/dist/types/server/serve-express.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serve-express.d.ts","sourceRoot":"","sources":["../../../src/server/serve-express.ts"],"names":[],"mappings":""}

package/dist/types/server/serve.d.ts

@@ -1,30 +0,0 @@
-import type { IncomingMessage, ServerResponse } from "node:http";
-import type { RenderHandler } from "../renderer/index.js";
-/**
- * Execute a request handler that renders a React component to a stream, then streams it back to the client.
- * This function should be used as a request controller in an HTTP server.
- * @param handler A request handler that renders a React component to a stream.
- * @throws Error if the handler throws an error during rendering.
- * @returns The stream generated by the handler
- * @example ```ts
- * import express from "express";
- * import { serveStream } from "@canonical/react-ssr/server";
- * import { JSXRenderer } from "@canonical/react-ssr/renderer";
- * // htmlString is created by some build process that bundles the client code
- * import htmlString from "../../dist/client/index.html?raw";
- * import EntryServer from "./entry-server.js";
- *
- * // `EntryServer` is an instance of `@canonical/react-ssr/renderer/ServerEntrypoint`
- * const Renderer = new JSXRenderer(EntryServer, {
- *   htmlString,
- * });
- *
- * const ssrHandler = Renderer.render;
- *
- * const app = express();
- *
- * app.use("/(assets|public)", express.static("dist/client/assets"));
- * app.use(serveStream(ssrHandler));
- */
-export declare function serveStream(handler: RenderHandler): (req: IncomingMessage, res: ServerResponse) => void;
-//# sourceMappingURL=serve.d.ts.map

package/dist/types/server/serve.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../../src/server/serve.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,aAAa,IACxC,KAAK,eAAe,EAAE,KAAK,cAAc,UAWlD"}