catalyst-core 0.3.0-beta.5 → 0.3.0-canary.2

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

@@ -0,0 +1,2 @@
+declare const router: any;
+export default router;

package/dist/server/renderer/index.js

@@ -1,8 +1,5 @@
-import express from "express"
-import handler from "./handler.jsx"
-
-const router = express.Router()
-
-router.use(handler)
-
-export default router
+import express from "express";
+import handler from "./handler.jsx";
+const router = express.Router();
+router.use(handler);
+export default router;

package/dist/server/renderer/render.d.ts

@@ -0,0 +1,35 @@
+import type { ReactElement } from "react";
+/**
+ * Returns data used by the Head component for page rendering.
+ */
+export declare const renderStart: ({ inlineCss, deferredRouteInlineCss, jsScripts, criticalPreloadLinks, deferredPreloadLinks, metaTags, isBot, fetcherData, }: {
+    inlineCss: string;
+    deferredRouteInlineCss: string;
+    jsScripts: ReactElement[];
+    criticalPreloadLinks: ReactElement[];
+    deferredPreloadLinks: ReactElement[];
+    metaTags: any[];
+    isBot: boolean;
+    fetcherData: Record<string, any>;
+}) => {
+    inlineCss: string;
+    deferredRouteInlineCss: string;
+    jsScripts: ReactElement<unknown, string | import("react").JSXElementConstructor<any>>[];
+    criticalPreloadLinks: ReactElement<unknown, string | import("react").JSXElementConstructor<any>>[];
+    deferredPreloadLinks: ReactElement<unknown, string | import("react").JSXElementConstructor<any>>[];
+    metaTags: any[];
+    isBot: boolean;
+    publicAssetPath: string;
+    fetcherData: Record<string, any>;
+};
+/**
+ * Returns data used by the Body component for page rendering.
+ */
+export declare const renderEnd: (initialState: Record<string, unknown>, _res: unknown, jsx: ReactElement, errorCode: number | null | undefined, fetcherData: Record<string, any>) => {
+    initialState: Record<string, unknown>;
+    firstFoldCss: string;
+    firstFoldJS: string;
+    jsx: ReactElement<unknown, string | import("react").JSXElementConstructor<any>>;
+    errorCode: number;
+    fetcherData: Record<string, any>;
+};

package/dist/server/renderer/render.js

@@ -2,6 +2,17 @@
  * Returns data used by the Head component for page rendering.
  */
 export const renderStart = ({
+  inlineCss,
+  deferredRouteInlineCss,
+  jsScripts,
+  criticalPreloadLinks,
+  deferredPreloadLinks,
+  metaTags,
+  isBot,
+  fetcherData
+}) => {
+  const publicAssetPath = `${process.env.PUBLIC_STATIC_ASSET_URL}${process.env.PUBLIC_STATIC_ASSET_PATH}`;
+  return {
     inlineCss,
     deferredRouteInlineCss,
     jsScripts,
@@ -9,39 +20,21 @@ export const renderStart = ({
     deferredPreloadLinks,
     metaTags,
     isBot,
-    fetcherData,
-}) => {
-    const { IS_DEV_COMMAND, WEBPACK_DEV_SERVER_HOSTNAME, WEBPACK_DEV_SERVER_PORT } = process.env
-
-    let publicAssetPath = `${process.env.PUBLIC_STATIC_ASSET_URL}${process.env.PUBLIC_STATIC_ASSET_PATH}`
-
-    if (JSON.parse(IS_DEV_COMMAND)) {
-        publicAssetPath = `http://${WEBPACK_DEV_SERVER_HOSTNAME}:${WEBPACK_DEV_SERVER_PORT}/assets/`
-    }
-
-    return {
-        inlineCss,
-        deferredRouteInlineCss,
-        jsScripts,
-        criticalPreloadLinks,
-        deferredPreloadLinks,
-        metaTags,
-        isBot,
-        publicAssetPath,
-        fetcherData,
-    }
-}
+    publicAssetPath,
+    fetcherData
+  };
+};
 
 /**
  * Returns data used by the Body component for page rendering.
  */
-export const renderEnd = (initialState = {}, res, jsx, errorCode, fetcherData) => {
-    return {
-        initialState,
-        firstFoldCss: "",
-        firstFoldJS: "",
-        jsx,
-        errorCode,
-        fetcherData,
-    }
-}
+export const renderEnd = (initialState = {}, _res, jsx, errorCode, fetcherData) => {
+  return {
+    initialState,
+    firstFoldCss: "",
+    firstFoldJS: "",
+    jsx,
+    errorCode,
+    fetcherData
+  };
+};

package/dist/server/utils/botDetectionMiddleware.d.ts

@@ -0,0 +1 @@
+export declare function botDetectionMiddleware(req: any, res: any, next: any): void;

package/dist/server/utils/botDetectionMiddleware.js

@@ -1,29 +1,39 @@
-import { getUserAgentDetails } from "./userAgentUtil.js"
+import { getUserAgentDetails } from "./userAgentUtil.js";
 
 // Loaded once at startup when OTEL is enabled; null otherwise.
-let _context, _trace, _IS_BOT_KEY
+let _context, _trace, _IS_BOT_KEY;
+// config.json booleans survive the process.env swap in loadEnvironmentVariables(),
+// so this is genuinely true at runtime when config sets OTEL_ENABLE: true. The cast
+// exists only because TS types process.env values as string | undefined.
 if (process.env.OTEL_ENABLE === true) {
-    try {
-        const { context, trace } = await import("@opentelemetry/api")
-        const { IS_BOT_KEY } = await import("../../otel.js")
-        _context = context
-        _trace = trace
-        _IS_BOT_KEY = IS_BOT_KEY
-    } catch {
-        // otel packages not installed — context injection skipped
-    }
+  try {
+    const {
+      context,
+      trace
+    } = await import("@opentelemetry/api");
+    const {
+      IS_BOT_KEY
+    } = await import("../../otel.js");
+    _context = context;
+    _trace = trace;
+    _IS_BOT_KEY = IS_BOT_KEY;
+  } catch {
+    // otel packages not installed — context injection skipped
+  }
 }
-
 export function botDetectionMiddleware(req, res, next) {
-    const ua = req.headers["user-agent"] || ""
-    const { googleBot, aiBot, statusCakeBot } = getUserAgentDetails(ua)
-    const isBot = !!(googleBot || aiBot || statusCakeBot)
-    res.locals.is_bot = isBot
-
-    if (_context && _IS_BOT_KEY) {
-        _trace?.getActiveSpan()?.setAttribute("http.response.is_bot", isBot)
-        _context.with(_context.active().setValue(_IS_BOT_KEY, isBot), next)
-    } else {
-        next()
-    }
+  const ua = req.headers["user-agent"] || "";
+  const {
+    googleBot,
+    aiBot,
+    statusCakeBot
+  } = getUserAgentDetails(ua);
+  const isBot = !!(googleBot || aiBot || statusCakeBot);
+  res.locals.is_bot = isBot;
+  if (_context && _IS_BOT_KEY) {
+    _trace?.getActiveSpan()?.setAttribute("http.response.is_bot", isBot);
+    _context.with(_context.active().setValue(_IS_BOT_KEY, isBot), next);
+  } else {
+    next();
+  }
 }

package/dist/server/utils/cjsRequire.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared helper to bridge ESM server entry files with legacy CommonJS helpers.
+ *
+ * Usage (in an ESM server file):
+ *   import { cjsRequire } from "catalyst-core/server/cjsRequire"
+ *   const legacyHelper = cjsRequire("./legacy/helper")
+ */
+export declare const cjsRequire: NodeJS.Require;

package/dist/server/utils/cjsRequire.js

@@ -1,4 +1,4 @@
-import { createRequire } from "module"
+import { createRequire } from "module";
 
 /**
  * Shared helper to bridge ESM server entry files with legacy CommonJS helpers.
@@ -7,4 +7,4 @@ import { createRequire } from "module"
  *   import { cjsRequire } from "catalyst-core/server/cjsRequire"
  *   const legacyHelper = cjsRequire("./legacy/helper")
  */
-export const cjsRequire = createRequire(import.meta.url)
+export const cjsRequire = createRequire(import.meta.url);

package/dist/server/utils/userAgentUtil.d.ts

@@ -0,0 +1,7 @@
+export declare const STATUS_CAKE_USER_AGENT_MOBILE = "StatusCake_Pagespeed_Indev";
+/**
+ * returns object which contains google bot and user-agent info
+ * @param {string} ua - user agent
+ * @return {object} - returns user agent
+ */
+export declare const getUserAgentDetails: (ua: any) => any;

package/dist/server/utils/userAgentUtil.js

@@ -1,93 +1,90 @@
-import parser from "ua-parser-js"
-
+import parser from "ua-parser-js";
 const googleBots = {
-    "APIs-Google": "APIs-Google",
-    AdSense: "Mediapartners-Google",
-    "AdsBot Mobile Web Android": "AdsBot-Google-Mobile",
-    "AdsBot Mobile Web": "AdsBot-Google-Mobile",
-    AdsBot: "AdsBot-Google",
-    "Mobile AdSense": "Mediapartners-Google",
-    "Mobile Apps Android": "AdsBot-Google-Mobile-Apps",
-    Feedfetcher: "FeedFetcher-Google",
-    "Google Read Aloud": "Google-Read-Aloud",
-    "Duplex on the Web": "DuplexWeb-Google",
-    "Google Favicon": "Google Favicon",
-    "Web Light": "googleweblight",
-    "Amp crawler": "Google-AMPHTM",
-    Googlebot: "Googlebot",
-    "Google Inspection Tool": "Google-InspectionTool",
-    "Google Agent": "Google-Agent",
-}
+  "APIs-Google": "APIs-Google",
+  AdSense: "Mediapartners-Google",
+  "AdsBot Mobile Web Android": "AdsBot-Google-Mobile",
+  "AdsBot Mobile Web": "AdsBot-Google-Mobile",
+  AdsBot: "AdsBot-Google",
+  "Mobile AdSense": "Mediapartners-Google",
+  "Mobile Apps Android": "AdsBot-Google-Mobile-Apps",
+  Feedfetcher: "FeedFetcher-Google",
+  "Google Read Aloud": "Google-Read-Aloud",
+  "Duplex on the Web": "DuplexWeb-Google",
+  "Google Favicon": "Google Favicon",
+  "Web Light": "googleweblight",
+  "Amp crawler": "Google-AMPHTM",
+  Googlebot: "Googlebot",
+  "Google Inspection Tool": "Google-InspectionTool",
+  "Google Agent": "Google-Agent"
+};
 
 // AI Crawler bots - for improved SEO with AI search engines
 const aiCrawlerBots = {
-    // OpenAI/ChatGPT bots
-    GPTBot: "GPTBot",
-    "ChatGPT-User": "ChatGPT-User",
-    "OAI-SearchBot": "OAI-SearchBot",
-
-    // Anthropic/Claude bots
-    ClaudeBot: "ClaudeBot",
-    "Claude-User": "Claude-User",
-    "Claude-SearchBot": "Claude-SearchBot",
-
-    // Perplexity bots
-    PerplexityBot: "PerplexityBot",
-    "Perplexity-User": "Perplexity-User",
-
-    // Microsoft Bing bot (also powers Bing Chat/Copilot)
-    Bingbot: "bingbot",
-
-    // Meta Crawler bot
-    MetaBot: "meta-externalagent",
-}
+  // OpenAI/ChatGPT bots
+  GPTBot: "GPTBot",
+  "ChatGPT-User": "ChatGPT-User",
+  "OAI-SearchBot": "OAI-SearchBot",
+  // Anthropic/Claude bots
+  ClaudeBot: "ClaudeBot",
+  "Claude-User": "Claude-User",
+  "Claude-SearchBot": "Claude-SearchBot",
+  // Perplexity bots
+  PerplexityBot: "PerplexityBot",
+  "Perplexity-User": "Perplexity-User",
+  // Microsoft Bing bot (also powers Bing Chat/Copilot)
+  Bingbot: "bingbot",
+  // Meta Crawler bot
+  MetaBot: "meta-externalagent"
+};
 
 // StatusCake synthetic monitoring user agents.
 // STATUS_CAKE_USER_AGENT_MOBILE matches the mobile pagespeed monitor — kept as a
 // named export so apps that compare UAs directly (mweb's document.js, App/index.js)
 // can import the same constant catalyst uses for its bot detection.
-export const STATUS_CAKE_USER_AGENT_MOBILE = "StatusCake_Pagespeed_Indev"
+export const STATUS_CAKE_USER_AGENT_MOBILE = "StatusCake_Pagespeed_Indev";
 const statusCakeBots = {
-    "StatusCake Pagespeed Mobile": STATUS_CAKE_USER_AGENT_MOBILE,
-    StatusCake: "StatusCake",
-}
+  "StatusCake Pagespeed Mobile": STATUS_CAKE_USER_AGENT_MOBILE,
+  StatusCake: "StatusCake"
+};
 
 /**
  * check if user agent contains bot data
  * @param {string} ua - user agent
  * @return {string|null}
  */
-const getGoogleBot = (ua) => {
-    for (let key in googleBots) {
-        if (ua.includes(googleBots[key])) return key
-    }
-    return null
-}
-
-const getAICrawlerBot = (ua) => {
-    for (let key in aiCrawlerBots) {
-        if (ua.includes(aiCrawlerBots[key])) return key
-    }
-    return null
-}
-
-const getStatusCakeBot = (ua) => {
-    for (let key in statusCakeBots) {
-        if (ua.includes(statusCakeBots[key])) return key
-    }
-    return null
-}
+const getGoogleBot = ua => {
+  for (let key in googleBots) {
+    if (ua.includes(googleBots[key])) return key;
+  }
+  return null;
+};
+const getAICrawlerBot = ua => {
+  for (let key in aiCrawlerBots) {
+    if (ua.includes(aiCrawlerBots[key])) return key;
+  }
+  return null;
+};
+const getStatusCakeBot = ua => {
+  for (let key in statusCakeBots) {
+    if (ua.includes(statusCakeBots[key])) return key;
+  }
+  return null;
+};
 
 /**
  * returns object which contains google bot and user-agent info
  * @param {string} ua - user agent
  * @return {object} - returns user agent
  */
-export const getUserAgentDetails = (ua) => {
-    const agentDetails = parser(ua)
-    const googleBot = getGoogleBot(ua)
-    const aiBot = getAICrawlerBot(ua)
-    const statusCakeBot = getStatusCakeBot(ua)
-
-    return { ...agentDetails, googleBot, aiBot, statusCakeBot }
-}
+export const getUserAgentDetails = ua => {
+  const agentDetails = parser(ua);
+  const googleBot = getGoogleBot(ua);
+  const aiBot = getAICrawlerBot(ua);
+  const statusCakeBot = getStatusCakeBot(ua);
+  return {
+    ...agentDetails,
+    googleBot,
+    aiBot,
+    statusCakeBot
+  };
+};

package/dist/server/utils/validator.d.ts

@@ -0,0 +1,31 @@
+declare const handleError: (e: any) => void;
+declare const validatePreInitServer: (fn: any) => any;
+declare const validateMiddleware: (fn: any) => any;
+declare const validateReducerFunction: (fn: any) => any;
+declare const validateConfigFile: (obj: any) => any;
+declare const validatePackageJson: (obj: any) => any;
+declare const validateModuleAlias: (obj: any) => any;
+declare const validateConfigureStore: (fn: any) => any;
+declare const validateGetRoutes: (fn: any) => any;
+declare const validateCustomDocument: (fn: any) => any;
+/**
+ * Safely call a function, catching and logging any errors — including a
+ * rejected promise if `fn` is async. Used for user-defined hooks
+ * (preServerInit, onRouteMatch, onFetcherError, onServerError, etc.) that
+ * should never crash the SSR pipeline.
+ *
+ * Async by necessity: awaiting `fn`'s return value is the only way to catch
+ * a rejection in the same try/catch as a synchronous throw. Existing call
+ * sites that don't await safeCall(...) are unaffected — they already
+ * treated its return value as fire-and-forget — but the rejection now
+ * reaches the same structured-error path a sync throw does, instead of
+ * surfacing as an unhandled promise rejection.
+ */
+declare const safeCall: (fn: any, ...args: any[]) => Promise<any>;
+/**
+ * Same as safeCall, but names the specific hook (e.g. "preServerInit") in the
+ * error so it's identifiable rather than generic. Used at call sites that know
+ * which hook they're invoking.
+ */
+declare const safeCallNamed: (hookName: any, fn: any, ...args: any[]) => Promise<any>;
+export { handleError, validateConfigFile, validateConfigureStore, validateCustomDocument, validateGetRoutes, validatePackageJson, validateReducerFunction, validateModuleAlias, validatePreInitServer, validateMiddleware, safeCall, safeCallNamed, };