@lowdefy/server-e2e 5.6.0 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server-e2e",
-  "version": "5.6.0",
+  "version": "6.1.0",
   "license": "Apache-2.0",
   "description": "Lowdefy e2e testing server with cookie-based user injection",
   "homepage": "https://lowdefy.com",
@@ -30,71 +30,77 @@
   "files": [
     "lib/*",
     "lowdefy/*",
-    "pages/*",
     "public_default/*",
-    "next.config.js",
     "package.original.json",
     ".eslintrc.yaml",
-    ".npmrc"
+    ".npmrc",
+    "src/*",
+    "client/*",
+    "vite.config.js",
+    "postcss.config.cjs"
   ],
   "dependencies": {
     "@ant-design/cssinjs": "2.1.2",
-    "@lowdefy/actions-core": "5.6.0",
-    "@lowdefy/api": "5.6.0",
-    "@lowdefy/block-utils": "5.6.0",
-    "@lowdefy/blocks-antd": "5.6.0",
-    "@lowdefy/blocks-antd-x": "5.6.0",
-    "@lowdefy/blocks-basic": "5.6.0",
-    "@lowdefy/blocks-loaders": "5.6.0",
-    "@lowdefy/blocks-markdown": "5.6.0",
-    "@lowdefy/blocks-tiptap": "5.6.0",
-    "@lowdefy/client": "5.6.0",
-    "@lowdefy/connection-axios-http": "5.6.0",
-    "@lowdefy/connection-mongodb": "5.6.0",
-    "@lowdefy/errors": "5.6.0",
-    "@lowdefy/helpers": "5.6.0",
-    "@lowdefy/layout": "5.6.0",
-    "@lowdefy/logger": "5.6.0",
-    "@lowdefy/node-utils": "5.6.0",
-    "@lowdefy/operators-js": "5.6.0",
-    "@lowdefy/operators-nunjucks": "5.6.0",
-    "@lowdefy/operators-uuid": "5.6.0",
-    "@tailwindcss/postcss": "4.2.1",
+    "@ant-design/x": "2.7.0",
+    "@hono/node-server": "2.0.10",
+    "@lowdefy/actions-core": "6.1.0",
+    "@lowdefy/api": "6.1.0",
+    "@lowdefy/block-utils": "6.1.0",
+    "@lowdefy/blocks-aggrid": "6.1.0",
+    "@lowdefy/blocks-antd": "6.1.0",
+    "@lowdefy/blocks-antd-x": "6.1.0",
+    "@lowdefy/blocks-basic": "6.1.0",
+    "@lowdefy/blocks-echarts": "6.1.0",
+    "@lowdefy/blocks-loaders": "6.1.0",
+    "@lowdefy/blocks-markdown": "6.1.0",
+    "@lowdefy/blocks-tiptap": "6.1.0",
+    "@lowdefy/client": "6.1.0",
+    "@lowdefy/connection-axios-http": "6.1.0",
+    "@lowdefy/connection-mongodb": "6.1.0",
+    "@lowdefy/errors": "6.1.0",
+    "@lowdefy/helpers": "6.1.0",
+    "@lowdefy/layout": "6.1.0",
+    "@lowdefy/logger": "6.1.0",
+    "@lowdefy/node-utils": "6.1.0",
+    "@lowdefy/operators-js": "6.1.0",
+    "@lowdefy/operators-nunjucks": "6.1.0",
+    "@lowdefy/operators-uuid": "6.1.0",
+    "@lowdefy/websockets-core": "6.1.0",
+    "@tailwindcss/postcss": "4.3.1",
+    "@vitejs/plugin-react": "6.0.2",
     "antd": "6.3.1",
-    "dayjs": "1.11.19",
-    "next": "16.1.6",
-    "pino": "8.16.2",
+    "dayjs": "1.11.20",
+    "hono": "4.13.5",
+    "pino": "10.3.1",
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-icons": "5.6.0",
-    "tailwindcss": "4.2.1",
-    "uuid": "13.0.0"
+    "tailwindcss": "4.3.1",
+    "uuid": "14.0.0",
+    "vite": "8.0.16",
+    "ws": "8.21.0"
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",
-    "@lowdefy/build": "5.6.0",
-    "@next/eslint-plugin-next": "16.1.6",
-    "@tailwindcss/postcss": "4.2.1",
+    "@lowdefy/build": "6.1.0",
+    "@tailwindcss/postcss": "4.3.1",
     "jest": "28.1.3",
-    "tailwindcss": "4.2.1",
-    "webpack": "5.94.0",
-    "yaml": "2.3.4",
-    "yargs": "17.7.2"
+    "tailwindcss": "4.3.1",
+    "yaml": "2.9.0",
+    "yargs": "18.0.0"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "publishConfig": {
     "access": "public"
   },
+  "type": "module",
   "scripts": {
     "build": "cp package.json package.original.json || copy package.json package.original.json",
+    "build:client": "vite build",
     "build:lowdefy": "node lowdefy/build.mjs",
-    "build:next": "next build",
-    "dev": "next dev",
-    "start": "next start",
-    "lint": "next lint",
-    "next": "next",
+    "start": "node src/index.js",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js"
   }
 }

package/package.original.json

@@ -1,6 +1,6 @@
 {
   "name": "@lowdefy/server-e2e",
-  "version": "5.6.0",
+  "version": "6.1.0",
   "license": "Apache-2.0",
   "description": "Lowdefy e2e testing server with cookie-based user injection",
   "homepage": "https://lowdefy.com",
@@ -30,72 +30,78 @@
   "files": [
     "lib/*",
     "lowdefy/*",
-    "pages/*",
     "public_default/*",
-    "next.config.js",
     "package.original.json",
     ".eslintrc.yaml",
-    ".npmrc"
+    ".npmrc",
+    "src/*",
+    "client/*",
+    "vite.config.js",
+    "postcss.config.cjs"
   ],
   "scripts": {
     "build": "cp package.json package.original.json || copy package.json package.original.json",
+    "build:client": "vite build",
     "build:lowdefy": "node lowdefy/build.mjs",
-    "build:next": "next build",
-    "dev": "next dev",
-    "start": "next start",
-    "lint": "next lint",
-    "next": "next",
-    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "prepublishOnly": "pnpm build"
+    "prepublishOnly": "pnpm build",
+    "start": "node src/index.js",
+    "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js"
   },
   "dependencies": {
     "@ant-design/cssinjs": "2.1.2",
-    "@lowdefy/actions-core": "5.6.0",
-    "@lowdefy/api": "5.6.0",
-    "@lowdefy/block-utils": "5.6.0",
-    "@lowdefy/blocks-antd": "5.6.0",
-    "@lowdefy/blocks-antd-x": "5.6.0",
-    "@lowdefy/blocks-basic": "5.6.0",
-    "@lowdefy/blocks-loaders": "5.6.0",
-    "@lowdefy/blocks-markdown": "5.6.0",
-    "@lowdefy/blocks-tiptap": "5.6.0",
-    "@lowdefy/client": "5.6.0",
-    "@lowdefy/connection-axios-http": "5.6.0",
-    "@lowdefy/connection-mongodb": "5.6.0",
-    "@lowdefy/errors": "5.6.0",
-    "@lowdefy/helpers": "5.6.0",
-    "@lowdefy/layout": "5.6.0",
-    "@lowdefy/logger": "5.6.0",
-    "@lowdefy/node-utils": "5.6.0",
-    "@lowdefy/operators-js": "5.6.0",
-    "@lowdefy/operators-nunjucks": "5.6.0",
-    "@lowdefy/operators-uuid": "5.6.0",
-    "@tailwindcss/postcss": "4.2.1",
+    "@ant-design/x": "2.7.0",
+    "@hono/node-server": "2.0.10",
+    "@lowdefy/actions-core": "6.1.0",
+    "@lowdefy/api": "6.1.0",
+    "@lowdefy/block-utils": "6.1.0",
+    "@lowdefy/blocks-aggrid": "6.1.0",
+    "@lowdefy/blocks-antd": "6.1.0",
+    "@lowdefy/blocks-antd-x": "6.1.0",
+    "@lowdefy/blocks-basic": "6.1.0",
+    "@lowdefy/blocks-echarts": "6.1.0",
+    "@lowdefy/blocks-loaders": "6.1.0",
+    "@lowdefy/blocks-markdown": "6.1.0",
+    "@lowdefy/blocks-tiptap": "6.1.0",
+    "@lowdefy/client": "6.1.0",
+    "@lowdefy/connection-axios-http": "6.1.0",
+    "@lowdefy/connection-mongodb": "6.1.0",
+    "@lowdefy/errors": "6.1.0",
+    "@lowdefy/helpers": "6.1.0",
+    "@lowdefy/layout": "6.1.0",
+    "@lowdefy/logger": "6.1.0",
+    "@lowdefy/node-utils": "6.1.0",
+    "@lowdefy/operators-js": "6.1.0",
+    "@lowdefy/operators-nunjucks": "6.1.0",
+    "@lowdefy/operators-uuid": "6.1.0",
+    "@lowdefy/websockets-core": "6.1.0",
+    "@tailwindcss/postcss": "4.3.1",
+    "@vitejs/plugin-react": "6.0.2",
     "antd": "6.3.1",
-    "dayjs": "1.11.19",
-    "next": "16.1.6",
-    "pino": "8.16.2",
+    "dayjs": "1.11.20",
+    "hono": "4.13.5",
+    "pino": "10.3.1",
     "react": "18.2.0",
     "react-dom": "18.2.0",
     "react-icons": "5.6.0",
-    "tailwindcss": "4.2.1",
-    "uuid": "13.0.0"
+    "tailwindcss": "4.3.1",
+    "uuid": "14.0.0",
+    "vite": "8.0.16",
+    "ws": "8.21.0"
   },
   "devDependencies": {
     "@jest/globals": "28.1.3",
-    "@lowdefy/build": "5.6.0",
-    "@next/eslint-plugin-next": "16.1.6",
-    "@tailwindcss/postcss": "4.2.1",
+    "@lowdefy/build": "6.1.0",
+    "@tailwindcss/postcss": "4.3.1",
     "jest": "28.1.3",
-    "tailwindcss": "4.2.1",
-    "webpack": "5.94.0",
-    "yaml": "2.3.4",
-    "yargs": "17.7.2"
+    "tailwindcss": "4.3.1",
+    "yaml": "2.9.0",
+    "yargs": "18.0.0"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "publishConfig": {
     "access": "public"
-  }
+  },
+  "type": "module"
 }

package/postcss.config.cjs

@@ -0,0 +1 @@
+module.exports = { plugins: { '@tailwindcss/postcss': {} } };

package/src/app.js

@@ -0,0 +1,78 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { Hono } from 'hono';
+import { compress } from 'hono/compress';
+import { serveStatic } from '@hono/node-server/serve-static';
+
+import apiContext from './middleware/apiContext.js';
+import apiPageHandler from './routes/apiPage.js';
+import clientErrorHandler from './routes/clientError.js';
+import createErrorHandler from './middleware/errorHandler.js';
+import createLogger from '../lib/server/log/createLogger.js';
+import endpointsHandler from './routes/endpoints.js';
+import lowdefyConfig from '../lib/build/config.js';
+import renderPage from './html/renderPage.js';
+import requestHandler from './routes/request.js';
+import sessionMockHandler from './routes/sessionMock.js';
+import usageHandler from './routes/usage.js';
+import websocketHandler from './routes/websocket.js';
+
+const basePath = lowdefyConfig.basePath ?? '';
+
+function createApp() {
+  const app = basePath ? new Hono().basePath(basePath) : new Hono();
+  const logger = createLogger({ server: 'lowdefy' });
+
+  app.use('*', async (c, next) => {
+    if (c.req.path.includes('/api/websocket')) {
+      return next();
+    }
+    return compress()(c, next);
+  });
+
+  app.use('/api/*', apiContext());
+  // Mock session endpoint — reads the lowdefy_e2e_user cookie; also the
+  // e2e harness health check (e2e-utils polls /api/auth/session).
+  app.get('/api/auth/session', sessionMockHandler);
+  app.all('/api/request/*', requestHandler);
+  app.all('/api/endpoints/*', endpointsHandler);
+  app.all('/api/client-error', clientErrorHandler);
+  app.all('/api/usage', usageHandler);
+  app.get('/api/websocket', websocketHandler);
+  app.get('/api/page/*', apiPageHandler);
+
+  // Vite build output (includes public/ via Vite's publicDir copy). Falls
+  // through to the page routes when no file matches.
+  app.use(
+    '/*',
+    serveStatic({
+      root: './dist/client',
+      rewriteRequestPath: basePath ? (path) => path.replace(basePath, '') : undefined,
+    })
+  );
+
+  app.use('/*', apiContext());
+  app.get('/', (c) => renderPage(c, { pageId: '' }));
+  app.get('/404', (c) => renderPage(c, { pageId: '404', status: 404 }));
+  app.get('/:rest{.+}', (c) => renderPage(c, { pageId: c.req.param('rest') }));
+
+  app.onError(createErrorHandler({ basePath, logger }));
+
+  return app;
+}
+
+export default createApp;

package/src/html/getAssets.js

@@ -0,0 +1,45 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import fs from 'node:fs';
+import path from 'node:path';
+
+// The Vite manifest is read once at startup — deploys start a new server
+// process after `vite build` completes, so assets never change at runtime.
+// In-place deploys must build before restarting (documented).
+let assets = null;
+
+function getAssets() {
+  if (assets) {
+    return assets;
+  }
+  const manifestPath = path.join(process.cwd(), 'dist/client/.vite/manifest.json');
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+  const entry = manifest['client/main.jsx'];
+  if (!entry) {
+    throw new Error(
+      'Vite manifest has no "client/main.jsx" entry. Run the client build before starting the server.'
+    );
+  }
+  assets = {
+    js: entry.file,
+    css: entry.css ?? [],
+    imports: (entry.imports ?? []).map((key) => manifest[key]?.file).filter(Boolean),
+  };
+  return assets;
+}
+
+export default getAssets;

package/src/html/renderPage.js

@@ -0,0 +1,79 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { getPageConfig, getRootConfig } from '@lowdefy/api';
+
+import appJson from '../../lib/build/app.js';
+import lowdefyConfig from '../../lib/build/config.js';
+import themeConfig from '../../lib/build/theme.js';
+import getAssets from './getAssets.js';
+import template from './template.js';
+
+const basePath = lowdefyConfig.basePath ?? '';
+
+// Replaces pages/[[...pageId]].js getServerSideProps and pages/404.js
+// getStaticProps. The home redirect logic lives here, not at the route level.
+async function renderPage(c, { pageId, status = 200 }) {
+  const context = c.get('lowdefyContext');
+  const { logger, session } = context;
+
+  let resolvedPageId = pageId;
+  const rootConfig = await getRootConfig(context);
+
+  if (!resolvedPageId) {
+    const { home } = rootConfig;
+    if (home.configured === false) {
+      logger.info({ event: 'redirect_to_homepage', pageId: home.pageId });
+      return c.redirect(`${basePath}/${home.pageId}`, 302);
+    }
+    resolvedPageId = home.pageId;
+  }
+
+  const pageConfig = await getPageConfig(context, {
+    pageId: resolvedPageId,
+    urlQuery: c.req.query(),
+  });
+
+  if (!pageConfig) {
+    if (resolvedPageId === '404') {
+      // No 404 page in the build — return a plain 404 rather than redirecting in a loop.
+      return c.text('Page not found.', 404);
+    }
+    logger.info({ event: 'redirect_page_not_found', pageId: resolvedPageId });
+    return c.redirect(`${basePath}/404`, 302);
+  }
+
+  logger.info({ event: 'page_view', pageId: resolvedPageId });
+
+  const html = template({
+    appendBody: appJson.html?.appendBody ?? '',
+    appendHead: appJson.html?.appendHead ?? '',
+    assets: getAssets(),
+    basePath,
+    config: {
+      basePath,
+      pageConfig,
+      rootConfig,
+      session: session ?? null,
+    },
+    themeConfig,
+    title: pageConfig.properties?.title ?? resolvedPageId,
+  });
+
+  return c.html(html, status);
+}
+
+export default renderPage;

package/src/html/template.js

@@ -0,0 +1,95 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import safeScriptJson from '../lib/safeScriptJson.js';
+
+const HTML_ESCAPES = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;' };
+
+function escapeHtml(value) {
+  return String(value).replace(/[&<>"]/g, (c) => HTML_ESCAPES[c]);
+}
+
+// Synchronous script that creates the @layer order declaration and keeps it as
+// the first child of <head> via MutationObserver. antd's CSS-in-JS uses
+// prependQueue to inject <style> tags at the top of <head>, which would
+// otherwise make @layer antd the first (lowest priority) layer.
+// MutationObserver fires before paint, so the browser never sees the wrong
+// cascade order.
+const layerOrderScript = `(function(){var s=document.createElement("style");s.id="__lf-layer-order";s.textContent="@layer theme, base, antd, components, utilities;";document.head.prepend(s);new MutationObserver(function(){if(document.head.firstChild!==s)document.head.prepend(s)}).observe(document.head,{childList:true})})();`;
+
+// Synchronous pre-hydration script setting the <html> background and
+// color-scheme — prevents a mode-mismatch flash of the page and of browser
+// chrome (scrollbars, form controls) on page load. Mirrors useDarkMode.js
+// resolution order: configDarkMode → localStorage → prefers-color-scheme.
+function darkModeScript({ configColorMode, darkBg, lightBg }) {
+  return `(function(){var c=${safeScriptJson(configColorMode)};var db=${safeScriptJson(
+    darkBg
+  )};var lb=${safeScriptJson(
+    lightBg
+  )};var d;if(c==="dark")d=true;else if(c==="light")d=false;else{try{var p=localStorage.getItem("lowdefy_darkMode");if(p==="dark")d=true;else if(p==="light")d=false;else d=window.matchMedia("(prefers-color-scheme:dark)").matches}catch(e){d=window.matchMedia("(prefers-color-scheme:dark)").matches}}var bg=d?db:lb;document.documentElement.style.colorScheme=d?"dark":"light";if(bg)document.documentElement.style.backgroundColor=bg})();`;
+}
+
+function template({
+  appendBody = '',
+  appendHead = '',
+  assets,
+  basePath = '',
+  config,
+  themeConfig = {},
+  title,
+}) {
+  const VALID_COLOR_MODES = ['system', 'light', 'dark'];
+  const configColorMode = VALID_COLOR_MODES.includes(themeConfig.darkMode)
+    ? themeConfig.darkMode
+    : 'system';
+  const darkBg = themeConfig?.antd?.darkToken?.colorBgLayout ?? '#000';
+  const lightBg = themeConfig?.antd?.lightToken?.colorBgLayout ?? '';
+
+  const cssLinks = assets.css
+    .map((file) => `<link rel="stylesheet" href="${basePath}/${file}" />`)
+    .join('\n    ');
+  const modulePreloads = assets.imports
+    .map((file) => `<link rel="modulepreload" href="${basePath}/${file}" />`)
+    .join('\n    ');
+
+  // appendHead and appendBody are intentionally raw HTML from app config
+  // (analytics snippets, font links) — they must not be escaped. The config
+  // JSON and pre-hydration interpolations go through safeScriptJson.
+  return `<!DOCTYPE html>
+<html class="lowdefy">
+  <head>
+    <meta charset="utf-8" />
+    <script>${layerOrderScript}</script>
+    <script>${darkModeScript({ configColorMode, darkBg, lightBg })}</script>
+    <link rel="manifest" href="${basePath}/manifest.webmanifest" />
+    <link rel="icon" type="image/svg+xml" href="${basePath}/icon.svg" />
+    <link rel="apple-touch-icon" href="${basePath}/apple-touch-icon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    ${title ? `<title>${escapeHtml(title)}</title>` : ''}
+    ${cssLinks}
+    ${modulePreloads}
+    ${appendHead}
+  </head>
+  <body>
+    <div id="root"></div>
+    <script id="__LOWDEFY_CONFIG__" type="application/json">${safeScriptJson(config)}</script>
+    ${appendBody}
+    <script type="module" src="${basePath}/${assets.js}"></script>
+  </body>
+</html>`;
+}
+
+export default template;

package/src/index.js

@@ -0,0 +1,40 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+import { serve } from '@hono/node-server';
+import { WebSocketServer } from 'ws';
+
+import createApp from './app.js';
+import createLogger from '../lib/server/log/createLogger.js';
+
+const app = createApp();
+const logger = createLogger();
+const port = Number(process.env.PORT ?? 3000);
+
+const wss = new WebSocketServer({ noServer: true, maxPayload: 256 * 1024 });
+
+const server = serve({ fetch: app.fetch, port, websocket: { server: wss } }, (info) => {
+  logger.info(`Lowdefy e2e server listening on http://localhost:${info.port}`);
+});
+
+function shutdown() {
+  server.close(() => {
+    process.exit(0);
+  });
+}
+
+process.on('SIGINT', shutdown);
+process.on('SIGTERM', shutdown);

package/src/lib/getPathSegments.js

@@ -0,0 +1,25 @@
+/*
+  Copyright 2020-2026 Lowdefy, Inc
+
+  Licensed under the Apache License, Version 2.0 (the "License");
+  you may not use this file except in compliance with the License.
+  You may obtain a copy of the License at
+
+      http://www.apache.org/licenses/LICENSE-2.0
+
+  Unless required by applicable law or agreed to in writing, software
+  distributed under the License is distributed on an "AS IS" BASIS,
+  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+  See the License for the specific language governing permissions and
+  limitations under the License.
+*/
+
+// Splits the rest of a catch-all route into decoded segments, independent of
+// any configured basePath. Mirrors the Next.js [...param] query arrays —
+// nested ids (slashes in pageId or endpointId) are real.
+function getPathSegments(c, prefix) {
+  const rest = c.req.path.split(prefix)[1] ?? '';
+  return rest.split('/').filter(Boolean).map(decodeURIComponent);
+}
+
+export default getPathSegments;