@trebired/frontend 6.5.0 → 6.6.1

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable package changes are documented here.
 
+## 6.6.1
+
+- Re-exported React server renderer option/context types from `@trebired/frontend/server`.
+
+## 6.6.0
+
+- Added server framework helpers for asset responses, locale locals, page task timeouts, and adapter-based React document rendering.
+- Exposed React SSR shell assembly hooks so apps supply product data, permission state, component resolution, and title rules without owning document orchestration.
+- Added verification coverage for asset compression/cache behavior, locale middleware, page task fallback results, and React document rendering.
+
 ## 6.5.0
 
 - Added public server helpers for frontend security locals and render-mode UI composition.

package/dist/server/assets.d.ts

@@ -0,0 +1,28 @@
+import { type ServerRequestLike, type ServerResponseLike } from "./http.js";
+type FrontendAsset = {
+    body?: Buffer | string;
+    contentType?: string;
+    etag?: string;
+};
+type FrontendAssetOptions = {
+    brotliQuality?: number;
+    contentType?: string;
+    gzipLevel?: number;
+    immutable?: boolean;
+    isImmutablePath?: (path: string) => boolean;
+    minCompressBytes?: number;
+    precompress?: boolean;
+    record?: (durationMs: number) => unknown;
+};
+declare function assetBodyBuffer(asset: FrontendAsset | null | undefined): Buffer<ArrayBufferLike>;
+declare function assetContentType(asset: FrontendAsset | null | undefined, fallback?: string): string;
+declare function assetIsCompressible(asset: FrontendAsset | null | undefined, fallback?: string): boolean;
+declare function prepareAsset(asset: FrontendAsset, options?: FrontendAssetOptions): FrontendAsset;
+declare function sendAsset(req: ServerRequestLike, res: ServerResponseLike, asset: FrontendAsset, options?: FrontendAssetOptions): boolean;
+declare function cacheControlForPercent(percent: unknown): {
+    immutable: boolean;
+    value: string;
+};
+export { assetBodyBuffer, assetContentType, assetIsCompressible, cacheControlForPercent, prepareAsset, sendAsset, };
+export type { FrontendAsset, FrontendAssetOptions };
+//# sourceMappingURL=assets.d.ts.map

package/dist/server/assets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assets.d.ts","sourceRoot":"","sources":["../../../src/server/assets.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAEnB,KAAK,aAAa,GAAG;IACnB,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IAC5C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC;CAC1C,CAAC;AAKF,iBAAS,eAAe,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,2BAG/D;AAED,iBAAS,gBAAgB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,SAAK,UAE/E;AAED,iBAAS,mBAAmB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,SAAK,WAQlF;AAsDD,iBAAS,YAAY,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,GAAE,oBAAyB,iBAiB7E;AA+DD,iBAAS,SAAS,CAChB,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,kBAAkB,EACvB,KAAK,EAAE,aAAa,EACpB,OAAO,GAAE,oBAAyB,WAmBnC;AAED,iBAAS,sBAAsB,CAAC,OAAO,EAAE,OAAO;;;EAU/C;AAED,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,SAAS,GACV,CAAC;AACF,YAAY,EAAE,aAAa,EAAE,oBAAoB,EAAE,CAAC"}

package/dist/server/assets.js

@@ -0,0 +1,157 @@
+import zlib from "node:zlib";
+import { requestHeader, setResponseHeader, } from "./http.js";
+const encodedCache = new WeakMap();
+const preparedAssets = new WeakSet();
+function assetBodyBuffer(asset) {
+    const body = asset && asset.body != null ? asset.body : "";
+    return Buffer.isBuffer(body) ? body : Buffer.from(String(body), "utf8");
+}
+function assetContentType(asset, fallback = "") {
+    return String(asset && asset.contentType ? asset.contentType : fallback);
+}
+function assetIsCompressible(asset, fallback = "") {
+    const type = assetContentType(asset, fallback).toLowerCase();
+    return (type.includes("text/css") ||
+        type.includes("javascript") ||
+        type.includes("application/json") ||
+        type.includes("text/plain"));
+}
+function cacheEncodedAsset(asset, encoding, encoded, rawLength) {
+    if (!encoding || !encoded || encoded.length >= rawLength)
+        return;
+    const cache = encodedCache.get(asset) || {};
+    cache[encoding] = encoded;
+    encodedCache.set(asset, cache);
+}
+function boundedInteger(value, fallback, min, max) {
+    const parsed = Math.floor(Number(value));
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.max(min, Math.min(max, parsed));
+}
+function prepareBrotliAsset(asset, raw, options) {
+    try {
+        cacheEncodedAsset(asset, "br", zlib.brotliCompressSync(raw, {
+            params: {
+                [zlib.constants.BROTLI_PARAM_QUALITY]: boundedInteger(options.brotliQuality, 5, 0, 11),
+                [zlib.constants.BROTLI_PARAM_SIZE_HINT]: raw.length,
+            },
+        }), raw.length);
+    }
+    catch { }
+}
+function prepareGzipAsset(asset, raw, options) {
+    try {
+        cacheEncodedAsset(asset, "gzip", zlib.gzipSync(raw, {
+            level: boundedInteger(options.gzipLevel, 6, 1, 9),
+        }), raw.length);
+    }
+    catch { }
+}
+function prepareAsset(asset, options = {}) {
+    if (!asset || typeof asset !== "object")
+        return asset;
+    if (preparedAssets.has(asset))
+        return asset;
+    preparedAssets.add(asset);
+    if (options.precompress === false || !assetIsCompressible(asset, options.contentType)) {
+        return asset;
+    }
+    const raw = assetBodyBuffer(asset);
+    if (raw.length < Math.max(0, Number(options.minCompressBytes) || 1024)) {
+        return asset;
+    }
+    prepareBrotliAsset(asset, raw, options);
+    prepareGzipAsset(asset, raw, options);
+    return asset;
+}
+function requestAssetPath(req) {
+    return String((req && (req.path || req.originalUrl || req.url)) || "")
+        .split("?")[0];
+}
+function isHashedAssetPath(path) {
+    return /^\/(?:css|js)\/.+-[a-f0-9]{8,64}\.(?:css|js)$/i.test(path);
+}
+function shouldUseImmutableCache(req, options) {
+    if (options.immutable === false)
+        return false;
+    const path = requestAssetPath(req);
+    return options.isImmutablePath ? options.isImmutablePath(path) : isHashedAssetPath(path);
+}
+function applyAssetCacheHeaders(req, res, options) {
+    if (shouldUseImmutableCache(req, options)) {
+        setResponseHeader(res, "Cache-Control", "public, max-age=31536000, immutable");
+        return;
+    }
+    setResponseHeader(res, "Cache-Control", "no-store, no-cache, must-revalidate, proxy-revalidate");
+    setResponseHeader(res, "Pragma", "no-cache");
+    setResponseHeader(res, "Expires", "0");
+}
+function preferredAssetEncoding(req) {
+    const accept = requestHeader(req, "accept-encoding").toLowerCase();
+    if (accept.includes("br"))
+        return "br";
+    if (accept.includes("gzip"))
+        return "gzip";
+    return "";
+}
+function encodedAssetBody(asset, encoding) {
+    if (!encoding || !assetIsCompressible(asset))
+        return null;
+    return encodedCache.get(asset)?.[encoding] || null;
+}
+function sendPreparedAssetBody(req, res, asset) {
+    const encoding = preferredAssetEncoding(req);
+    const encoded = encodedAssetBody(asset, encoding);
+    const body = encoded || assetBodyBuffer(asset);
+    if (encoded) {
+        setResponseHeader(res, "Content-Encoding", encoding);
+        setResponseHeader(res, "Vary", "Accept-Encoding");
+    }
+    setResponseHeader(res, "Content-Length", String(body.length));
+    if (typeof res.send === "function")
+        return res.send(body);
+    return res.end?.(body);
+}
+function sendAsset(req, res, asset, options = {}) {
+    const startedAt = performance.now();
+    try {
+        const etag = asset && typeof asset.etag === "string" ? asset.etag : "";
+        if (etag)
+            setResponseHeader(res, "ETag", etag);
+        if (etag && requestHeader(req, "if-none-match") === etag) {
+            if (typeof res.status === "function")
+                res.status(304);
+            res.end?.();
+            return true;
+        }
+        const type = assetContentType(asset, options.contentType);
+        if (type)
+            setResponseHeader(res, "Content-Type", type);
+        applyAssetCacheHeaders(req, res, options);
+        sendPreparedAssetBody(req, res, prepareAsset(asset, options));
+        return true;
+    }
+    finally {
+        options.record?.(Math.max(0, performance.now() - startedAt));
+    }
+}
+function cacheControlForPercent(percent) {
+    const parsed = Number(percent);
+    const value = Math.max(0, Math.min(100, Math.floor(Number.isFinite(parsed) ? parsed : 100)));
+    if (value === 0)
+        return { immutable: false, value: "no-store, must-revalidate" };
+    if (value <= 10)
+        return { immutable: false, value: "public, max-age=0, must-revalidate" };
+    if (value <= 40)
+        return { immutable: false, value: "public, max-age=600" };
+    if (value <= 70)
+        return { immutable: false, value: "public, max-age=3600" };
+    if (value <= 90)
+        return { immutable: false, value: "public, max-age=86400" };
+    if (value < 100)
+        return { immutable: false, value: "public, max-age=31536000" };
+    return { immutable: true, value: "public, max-age=31536000, immutable" };
+}
+export { assetBodyBuffer, assetContentType, assetIsCompressible, cacheControlForPercent, prepareAsset, sendAsset, };
+//# sourceMappingURL=assets.js.map

package/dist/server/assets.js.map

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

package/dist/server/index.d.ts

@@ -4,9 +4,13 @@ export * from "../icons/server-context.d.ts";
 export * from "../icons/shared.d.ts";
 export * from "./favicon.js";
 export * from "./http.js";
+export * from "./assets.js";
 export * from "./language.js";
+export * from "./locale.js";
 export * from "./live.js";
 export * from "./navigation.js";
+export * from "./page-task.js";
+export * from "./react/render.d.ts";
 export * from "./render-mode.js";
 export * from "./security.js";
 export * from "./seo.js";

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/server/index.js

@@ -4,9 +4,13 @@ export * from "../icons/server-context.js";
 export * from "../icons/shared.js";
 export * from "./favicon.js";
 export * from "./http.js";
+export * from "./assets.js";
 export * from "./language.js";
+export * from "./locale.js";
 export * from "./live.js";
 export * from "./navigation.js";
+export * from "./page-task.js";
+export * from "./react/render.js";
 export * from "./render-mode.js";
 export * from "./security.js";
 export * from "./seo.js";

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC"}

package/dist/server/locale.d.ts

@@ -0,0 +1,22 @@
+import { type ServerRequestLike, type ServerResponseLike } from "./http.js";
+type LocaleState = {
+    effective: string;
+    request: string;
+    user: string;
+};
+type LocaleMiddlewareOptions = {
+    defaultLocale?: string;
+    localsKey?: string;
+    normalize?: (value: unknown) => string;
+    readUserLocale?: (req: ServerRequestLike, res: ServerResponseLike) => unknown;
+};
+declare function normalizeIntlLocale(input: unknown): string;
+declare function readRequestLocale(req: ServerRequestLike | null | undefined, normalize?: (value: unknown) => string): string;
+declare function createLocaleState(req: ServerRequestLike, res: ServerResponseLike, options?: LocaleMiddlewareOptions): LocaleState;
+declare function applyLocaleToLocals(req: ServerRequestLike, res: ServerResponseLike, options?: LocaleMiddlewareOptions): LocaleState;
+declare function createLocaleMiddleware(options?: LocaleMiddlewareOptions): (req: ServerRequestLike, res: ServerResponseLike, next: () => unknown) => unknown;
+declare function attachLocaleMiddleware(app: unknown, options?: LocaleMiddlewareOptions): void;
+declare const normalizeLocale: typeof normalizeIntlLocale;
+export { applyLocaleToLocals, attachLocaleMiddleware, createLocaleMiddleware, createLocaleState, normalizeLocale, readRequestLocale, };
+export type { LocaleMiddlewareOptions, LocaleState };
+//# sourceMappingURL=locale.d.ts.map

package/dist/server/locale.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"locale.d.ts","sourceRoot":"","sources":["../../../src/server/locale.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACxB,MAAM,WAAW,CAAC;AAEnB,KAAK,WAAW,GAAG;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,uBAAuB,GAAG;IAC7B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;IACvC,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC;CAC/E,CAAC;AAEF,iBAAS,mBAAmB,CAAC,KAAK,EAAE,OAAO,UAQ1C;AASD,iBAAS,iBAAiB,CACxB,GAAG,EAAE,iBAAiB,GAAG,IAAI,GAAG,SAAS,EACzC,SAAS,GAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAA4B,UAc5D;AAYD,iBAAS,iBAAiB,CACxB,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,kBAAkB,EACvB,OAAO,GAAE,uBAA4B,GACpC,WAAW,CAWb;AAED,iBAAS,mBAAmB,CAC1B,GAAG,EAAE,iBAAiB,EACtB,GAAG,EAAE,kBAAkB,EACvB,OAAO,GAAE,uBAA4B,eAMtC;AAED,iBAAS,sBAAsB,CAAC,OAAO,GAAE,uBAA4B,IAEjE,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,MAAM,MAAM,OAAO,aAKtB;AAED,iBAAS,sBAAsB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,uBAA4B,QAIlF;AAED,QAAA,MAAM,eAAe,4BAAsB,CAAC;AAE5C,OAAO,EACL,mBAAmB,EACnB,sBAAsB,EACtB,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,GAClB,CAAC;AACF,YAAY,EAAE,uBAAuB,EAAE,WAAW,EAAE,CAAC"}

package/dist/server/locale.js

@@ -0,0 +1,74 @@
+import { requestHeader, } from "./http.js";
+function normalizeIntlLocale(input) {
+    const raw = String(input == null ? "" : input).trim();
+    if (!raw)
+        return "";
+    try {
+        return Intl.DateTimeFormat.supportedLocalesOf([raw])[0] || "";
+    }
+    catch {
+        return "";
+    }
+}
+function localeWeight(entry) {
+    const match = entry.match(/(?:^|;)\s*q=([0-9.]+)/i);
+    if (!match)
+        return 1;
+    const parsed = Number(match[1]);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function readRequestLocale(req, normalize = normalizeIntlLocale) {
+    const raw = requestHeader(req, "accept-language");
+    if (!raw)
+        return "";
+    const entries = raw
+        .split(",")
+        .map((entry) => entry.trim())
+        .filter(Boolean)
+        .sort((left, right) => localeWeight(right) - localeWeight(left));
+    for (const entry of entries) {
+        const locale = normalize(entry.split(";")[0]);
+        if (locale)
+            return locale;
+    }
+    return "";
+}
+function defaultUserLocale(req, res) {
+    const viewer = req?.viewer && typeof req.viewer === "object"
+        ? req.viewer
+        : res?.locals?.viewer && typeof res.locals.viewer === "object"
+            ? res.locals.viewer
+            : null;
+    return viewer && typeof viewer === "object" ? viewer.locale : "";
+}
+function createLocaleState(req, res, options = {}) {
+    const normalize = options.normalize || normalizeIntlLocale;
+    const user = normalize(options.readUserLocale ? options.readUserLocale(req, res) : defaultUserLocale(req, res));
+    const request = readRequestLocale(req, normalize);
+    return {
+        effective: user || request || normalize(options.defaultLocale),
+        request,
+        user,
+    };
+}
+function applyLocaleToLocals(req, res, options = {}) {
+    if (!res.locals || typeof res.locals !== "object")
+        res.locals = {};
+    const state = createLocaleState(req, res, options);
+    res.locals[options.localsKey || "locale"] = state;
+    return state;
+}
+function createLocaleMiddleware(options = {}) {
+    return function localeMiddleware(req, res, next) {
+        applyLocaleToLocals(req, res, options);
+        return next();
+    };
+}
+function attachLocaleMiddleware(app, options = {}) {
+    if (app && typeof app.use === "function") {
+        app.use(createLocaleMiddleware(options));
+    }
+}
+const normalizeLocale = normalizeIntlLocale;
+export { applyLocaleToLocals, attachLocaleMiddleware, createLocaleMiddleware, createLocaleState, normalizeLocale, readRequestLocale, };
+//# sourceMappingURL=locale.js.map

package/dist/server/locale.js.map

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

package/dist/server/page-task.d.ts

@@ -0,0 +1,36 @@
+type PageTaskFailure = {
+    details: string;
+    ok: false;
+    status: number;
+    status_code: string;
+};
+type PageTaskFailureContext = {
+    entityId: string;
+    message: string;
+    operation: string;
+    page: string;
+    status: number;
+    statusCode: string;
+    timeoutMs: number;
+};
+type PageTaskOptions<TFailure = PageTaskFailure> = {
+    entityId?: unknown;
+    fail?: (context: PageTaskFailureContext) => TFailure;
+    failureMessage?: (context: {
+        operation: string;
+        status: number;
+        statusCode: string;
+    }) => string;
+    logger?: {
+        error?: (scope: string, message: string, metadata?: Record<string, unknown>) => unknown;
+        warn?: (scope: string, message: string, metadata?: Record<string, unknown>) => unknown;
+    };
+    operation: unknown;
+    page: unknown;
+    timeoutMs?: unknown;
+};
+declare const DEFAULT_PAGE_TASK_TIMEOUT_MS = 15000;
+declare function runPageTask<T, TFailure = PageTaskFailure>(task: () => Promise<T>, options: PageTaskOptions<TFailure>): Promise<T | TFailure>;
+export { DEFAULT_PAGE_TASK_TIMEOUT_MS, runPageTask };
+export type { PageTaskFailure, PageTaskFailureContext, PageTaskOptions };
+//# sourceMappingURL=page-task.d.ts.map

package/dist/server/page-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"page-task.d.ts","sourceRoot":"","sources":["../../../src/server/page-task.ts"],"names":[],"mappings":"AAEA,KAAK,eAAe,GAAG;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,KAAK,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,KAAK,sBAAsB,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,KAAK,eAAe,CAAC,QAAQ,GAAG,eAAe,IAAI;IACjD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,sBAAsB,KAAK,QAAQ,CAAC;IACrD,cAAc,CAAC,EAAE,CAAC,OAAO,EAAE;QACvB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACtB,KAAK,MAAM,CAAC;IACb,MAAM,CAAC,EAAE;QACP,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;QACxF,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC;KACxF,CAAC;IACF,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,QAAA,MAAM,4BAA4B,QAAQ,CAAC;AAmF3C,iBAAe,WAAW,CAAC,CAAC,EAAE,QAAQ,GAAG,eAAe,EACtD,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,eAAe,CAAC,QAAQ,CAAC,GACjC,OAAO,CAAC,CAAC,GAAG,QAAQ,CAAC,CAmCvB;AAED,OAAO,EAAE,4BAA4B,EAAE,WAAW,EAAE,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,eAAe,EAAE,CAAC"}

package/dist/server/page-task.js

@@ -0,0 +1,91 @@
+import { toText } from "../components/index.js";
+const DEFAULT_PAGE_TASK_TIMEOUT_MS = 15000;
+function pageTaskTimeoutMs(input) {
+    const parsed = Number(input);
+    return Math.max(1, Number.isFinite(parsed) ? Math.floor(parsed) : DEFAULT_PAGE_TASK_TIMEOUT_MS);
+}
+function pageTaskErrorStatus(error) {
+    const status = error && typeof error === "object" && "status" in error
+        ? Number(error.status)
+        : 0;
+    return Number.isFinite(status) && status > 0 ? status : 500;
+}
+function pageTaskErrorCode(error, status) {
+    return (toText(error && typeof error === "object" && "status_code" in error
+        ? error.status_code
+        : "") || (status === 504 ? "page-route-timeout" : "page-route-load-failed"));
+}
+function defaultFailureMessage(status, operation) {
+    return status === 504
+        ? `Timed out while loading ${operation}.`
+        : `Failed to load ${operation}.`;
+}
+function pageTaskErrorMessage(error, context, options) {
+    return (toText(error && typeof error === "object" && "message" in error
+        ? error.message
+        : "") ||
+        options.failureMessage?.(context) ||
+        defaultFailureMessage(context.status, context.operation));
+}
+function pageTaskFailure(context, options) {
+    if (options.fail)
+        return options.fail(context);
+    return {
+        details: context.message,
+        ok: false,
+        status: context.status,
+        status_code: context.statusCode,
+    };
+}
+function logPageTaskFailure(context, options) {
+    const level = context.status >= 500 && context.status !== 504 ? "error" : "warn";
+    options.logger?.[level]?.("frontend.page", "page task failed", {
+        entity_id: context.entityId,
+        message: context.message,
+        operation: context.operation,
+        page: context.page,
+        status: context.status,
+        status_code: context.statusCode,
+        timeout_ms: context.timeoutMs,
+    });
+}
+function createPageTaskTimeout(operation) {
+    const error = new Error(defaultFailureMessage(504, operation));
+    error.status = 504;
+    error.status_code = "page-route-timeout";
+    return error;
+}
+async function runPageTask(task, options) {
+    const operation = toText(options.operation, "page task");
+    const timeoutMs = pageTaskTimeoutMs(options.timeoutMs);
+    let timer = null;
+    try {
+        return await Promise.race([
+            Promise.resolve().then(task),
+            new Promise((_, reject) => {
+                timer = setTimeout(() => reject(createPageTaskTimeout(operation)), timeoutMs);
+            }),
+        ]);
+    }
+    catch (error) {
+        const status = pageTaskErrorStatus(error);
+        const statusCode = pageTaskErrorCode(error, status);
+        const context = {
+            entityId: toText(options.entityId),
+            message: pageTaskErrorMessage(error, { operation, status, statusCode }, options),
+            operation,
+            page: toText(options.page, "unknown"),
+            status,
+            statusCode,
+            timeoutMs,
+        };
+        logPageTaskFailure(context, options);
+        return pageTaskFailure(context, options);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+export { DEFAULT_PAGE_TASK_TIMEOUT_MS, runPageTask };
+//# sourceMappingURL=page-task.js.map

package/dist/server/page-task.js.map

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

package/dist/server/react/document.d.ts

@@ -0,0 +1,29 @@
+import { type ServerResponseLike } from "../http.d.ts";
+import type { FrontendDocumentContext, FrontendReactRendererOptions, FrontendRenderShell } from "./types.d.ts";
+declare function defaultNormalizePageId(pageId: unknown): string;
+declare function applyScriptNonce(html: string, nonce: unknown): string;
+declare function countHtmlTags(html: string, tagName: string): number;
+declare function readResponseRequestRoute(res: ServerResponseLike | null | undefined): string;
+declare function buildDocumentContext(res: ServerResponseLike, pageId: string, componentId: string, props: Record<string, unknown>, options: FrontendReactRendererOptions, shellInput?: FrontendRenderShell): FrontendDocumentContext;
+declare function rootDocumentProps(body: unknown, context: FrontendDocumentContext, options: FrontendReactRendererOptions): {
+    body: unknown;
+    cssLinks: string;
+    csrfToken: string;
+    currentUrl: string;
+    faviconHref: string;
+    fontPreloadLinks: string;
+    jsLinks: string;
+    lang: string;
+    nonce: string;
+    pageId: string;
+    pageTitle: string;
+    seo: Record<string, unknown>;
+    shell: FrontendRenderShell;
+    theme: string;
+    themeKey: string;
+    title: string;
+    viewerId: string;
+};
+declare function logDocumentStart(context: FrontendDocumentContext, res: ServerResponseLike, options: FrontendReactRendererOptions): void;
+export { applyScriptNonce, buildDocumentContext, countHtmlTags, defaultNormalizePageId, logDocumentStart, readResponseRequestRoute, rootDocumentProps, };
+//# sourceMappingURL=document.d.ts.map

package/dist/server/react/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../../../src/server/react/document.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,eAAe,CAAC;AAEvB,OAAO,KAAK,EACV,uBAAuB,EACvB,4BAA4B,EAC5B,mBAAmB,EACpB,MAAM,eAAe,CAAC;AAEvB,iBAAS,sBAAsB,CAAC,MAAM,EAAE,OAAO,UAY9C;AAED,iBAAS,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,UAQrD;AAED,iBAAS,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAInD;AAED,iBAAS,wBAAwB,CAAC,GAAG,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,UAG3E;AAwCD,iBAAS,oBAAoB,CAC3B,GAAG,EAAE,kBAAkB,EACvB,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,4BAA4B,EACrC,UAAU,CAAC,EAAE,mBAAmB,GAC/B,uBAAuB,CAoBzB;AAkBD,iBAAS,iBAAiB,CACxB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,uBAAuB,EAChC,OAAO,EAAE,4BAA4B;;;;;;;;;;;;;;;;;;EAqBtC;AAED,iBAAS,gBAAgB,CACvB,OAAO,EAAE,uBAAuB,EAChC,GAAG,EAAE,kBAAkB,EACvB,OAAO,EAAE,4BAA4B,QActC;AAED,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,aAAa,EACb,sBAAsB,EACtB,gBAAgB,EAChB,wBAAwB,EACxB,iBAAiB,GAClB,CAAC"}