@emeryld/rrroutes-openapi 2.3.0 → 2.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -5,6 +5,7 @@ RRRoutes docs + “try it” playground, shipped as static assets plus a thin Ex
5
5
  ## What you get
6
6
  - React docs UI (filters, grouping, schema tables) with a built-in playground for hitting your endpoints.
7
7
  - Express helper that mounts the docs page and serves the built assets.
8
+ - Playground inputs share a base URL and let you set custom request headers across calls.
8
9
  - Escape hatches: supply your own React tree or prerendered HTML if you want full control.
9
10
 
10
11
  ## Quick start (Express)
@@ -30,6 +31,8 @@ mountRRRoutesDocs({
30
31
  - `path` (default `/__rrroutes/docs`): where the page is mounted.
31
32
  - `assetBasePath` (default `${path}/assets`): where the static JS/CSS are served from.
32
33
  - `csp` (default `true`): emit a CSP header + nonce.
34
+ - `auth`: HTTP Basic auth for the docs + webhooks. Uses `process.env.RRROUTES_DOCS_PASSWORD` by default; set `enabled: false` to skip the guard.
35
+ - `redactLogEntry`: `(entry) => entry | null` hook to scrub or drop log entries before they hit the UI.
33
36
  - `onRequest`: `(ctx) => ({ leaves?, nonce?, html? })` hook to tweak leaves, override the nonce, or return a fully custom HTML response.
34
37
 
35
38
  ## Render it yourself
package/dist/index.cjs CHANGED
@@ -416,8 +416,15 @@ function mountRRRoutesDocs({
416
416
  );
417
417
  const defaultHistoryLimit = 200;
418
418
  const defaultLogLimit = 400;
419
- const inMemoryHistory = normalizeHistorySeeds(options.historySeeds, defaultHistoryLimit);
420
- const inMemoryLogs = normalizeLogSeeds(options.logSeeds, defaultLogLimit);
419
+ const redactLogEntry = createLogRedactor(options.redactLogEntry);
420
+ const seededHistory = normalizeHistorySeeds(options.historySeeds, defaultHistoryLimit);
421
+ const seededLogs = normalizeLogSeeds(options.logSeeds, defaultLogLimit, redactLogEntry);
422
+ const inMemoryHistory = seededHistory.slice();
423
+ const inMemoryLogs = seededLogs.slice();
424
+ const historySeedsForUi = seededHistory.map((entry) => ({
425
+ ...entry,
426
+ fullUrl: entry.fullUrl || entry.path
427
+ }));
421
428
  const webhookPaths = {
422
429
  history: `${webhookBasePath}/history`,
423
430
  logs: `${webhookBasePath}/logs`
@@ -461,6 +468,16 @@ function mountRRRoutesDocs({
461
468
  const publicDir = resolvePublicDir();
462
469
  const assetsDir = import_node_path.default.join(publicDir, "assets");
463
470
  const cspEnabled = options.csp !== false;
471
+ const authConfig = options.auth;
472
+ const authEnabled = authConfig?.enabled !== false;
473
+ const docsPassword = resolveDocsPassword(authConfig);
474
+ const authRealm = authConfig?.realm || "RRRoutes Docs";
475
+ if (authEnabled) {
476
+ const guard = docsPassword ? createPasswordGuard(docsPassword, authRealm) : createMissingPasswordGuard();
477
+ [normalizedDocsPath, assetsMountPath, webhookBasePath].forEach((p) => {
478
+ router.use(p, guard);
479
+ });
480
+ }
464
481
  router.use(assetsMountPath, (0, import_express.static)(assetsDir, { immutable: true, maxAge: "365d" }));
465
482
  const usingFakeHistory = !options.logWebhook?.history;
466
483
  const usingFakeLogs = !options.logWebhook?.logs;
@@ -503,7 +520,7 @@ function mountRRRoutesDocs({
503
520
  query: req.query,
504
521
  durationMs
505
522
  });
506
- inMemoryLogs.unshift({
523
+ const redacted = redactLogEntry({
507
524
  id: (0, import_crypto.randomBytes)(8).toString("hex"),
508
525
  type: logType,
509
526
  message: `${methodUpper} ${pathOnly} -> ${status}`,
@@ -512,7 +529,10 @@ function mountRRRoutesDocs({
512
529
  tags: [],
513
530
  metadata
514
531
  });
515
- if (inMemoryLogs.length > defaultLogLimit) inMemoryLogs.length = defaultLogLimit;
532
+ if (redacted) {
533
+ inMemoryLogs.unshift(redacted);
534
+ if (inMemoryLogs.length > defaultLogLimit) inMemoryLogs.length = defaultLogLimit;
535
+ }
516
536
  }
517
537
  });
518
538
  next();
@@ -521,6 +541,7 @@ function mountRRRoutesDocs({
521
541
  router.get(webhookPaths.history, async (req, res) => {
522
542
  const handler = options.logWebhook?.history;
523
543
  try {
544
+ applyDocsSecurityHeaders(res);
524
545
  const query = parseHistoryWebhookQuery(req);
525
546
  if (!handler) {
526
547
  const filtered2 = applyHistoryQuery(inMemoryHistory, query, defaultHistoryLimit);
@@ -539,6 +560,7 @@ function mountRRRoutesDocs({
539
560
  router.get(webhookPaths.logs, async (req, res) => {
540
561
  const handler = options.logWebhook?.logs;
541
562
  try {
563
+ applyDocsSecurityHeaders(res);
542
564
  const query = parseLogWebhookQuery(req);
543
565
  if (!handler) {
544
566
  const filtered2 = applyLogsQuery(inMemoryLogs, query, defaultLogLimit);
@@ -547,7 +569,8 @@ function mountRRRoutesDocs({
547
569
  }
548
570
  const result = await handler({ query, req, res });
549
571
  const normalized = normalizeWebhookPage(result);
550
- const filtered = applyLogsQuery(normalized.items, query, defaultLogLimit);
572
+ const redacted = applyLogRedaction(normalized.items, redactLogEntry);
573
+ const filtered = applyLogsQuery(redacted, query, defaultLogLimit);
551
574
  res.json(filtered);
552
575
  } catch (err) {
553
576
  console.error("Failed to serve log webhook", err);
@@ -571,14 +594,15 @@ function mountRRRoutesDocs({
571
594
  assetBasePath: `${prefix}${assetsMountPath}`,
572
595
  docsBasePath: `${prefix}${normalizedDocsPath}`,
573
596
  baseUrlSuffix: prefix,
574
- historySeeds: options.historySeeds,
575
- logSeeds: options.logSeeds,
597
+ historySeeds: historySeedsForUi,
598
+ logSeeds: seededLogs,
576
599
  presets: normalizePresets(finalPresets),
577
600
  webhooks: {
578
601
  history: `${prefix}${webhookPaths.history}`,
579
602
  logs: `${prefix}${webhookPaths.logs}`
580
603
  }
581
604
  });
605
+ applyDocsSecurityHeaders(res);
582
606
  if (cspEnabled && nonce) {
583
607
  res.setHeader(
584
608
  "Content-Security-Policy",
@@ -820,9 +844,9 @@ function normalizeHistorySeeds(seeds, hardLimit) {
820
844
  error: entry.error
821
845
  })).filter((entry) => entry.method && entry.path);
822
846
  }
823
- function normalizeLogSeeds(seeds, hardLimit) {
847
+ function normalizeLogSeeds(seeds, hardLimit, redactor) {
824
848
  if (!Array.isArray(seeds)) return [];
825
- return seeds.slice(0, hardLimit).map((entry, idx) => ({
849
+ const normalized = seeds.slice(0, hardLimit).map((entry, idx) => ({
826
850
  id: entry.id || (0, import_crypto.randomBytes)(8).toString("hex"),
827
851
  type: entry.type || "info",
828
852
  message: entry.message || "",
@@ -831,6 +855,7 @@ function normalizeLogSeeds(seeds, hardLimit) {
831
855
  tags: Array.isArray(entry.tags) ? entry.tags : [],
832
856
  metadata: entry.metadata
833
857
  })).filter((entry) => entry.message);
858
+ return applyLogRedaction(normalized, redactor);
834
859
  }
835
860
  function coerceQueryRecord(query) {
836
861
  if (!query || typeof query !== "object") return {};
@@ -859,6 +884,91 @@ function coerceValue(value) {
859
884
  }
860
885
  return String(value);
861
886
  }
887
+ function createLogRedactor(redactor) {
888
+ if (!redactor) return (entry) => entry;
889
+ return (entry) => {
890
+ try {
891
+ return redactor(entry) ?? null;
892
+ } catch (err) {
893
+ console.error("Log redaction failed \u2013 dropping log entry", err);
894
+ return null;
895
+ }
896
+ };
897
+ }
898
+ function applyLogRedaction(entries, redactor) {
899
+ if (!Array.isArray(entries)) return [];
900
+ const next = [];
901
+ for (const entry of entries) {
902
+ const redacted = redactor(entry);
903
+ if (redacted) next.push(redacted);
904
+ }
905
+ return next;
906
+ }
907
+ function resolveDocsPassword(auth) {
908
+ if (auth?.password) return auth.password;
909
+ return void 0;
910
+ }
911
+ function createPasswordGuard(password, realm) {
912
+ const trimmed = password.trim();
913
+ return (req, res, next) => {
914
+ const provided = extractPassword(req.headers.authorization);
915
+ if (provided && provided === trimmed) {
916
+ return next();
917
+ }
918
+ applyDocsSecurityHeaders(res);
919
+ res.setHeader("WWW-Authenticate", `Basic realm="${realm}"`);
920
+ res.status(401).send(renderAuthErrorPage("Docs are password protected. Provide the configured password."));
921
+ };
922
+ }
923
+ function createMissingPasswordGuard() {
924
+ return (_req, res) => {
925
+ applyDocsSecurityHeaders(res);
926
+ res.status(500).send(renderAuthErrorPage("Provide password to mounted docs"));
927
+ };
928
+ }
929
+ function extractPassword(authHeader) {
930
+ if (!authHeader) return void 0;
931
+ const header = Array.isArray(authHeader) ? authHeader[0] : authHeader;
932
+ if (typeof header !== "string" || !header.startsWith("Basic ")) return void 0;
933
+ const token = header.slice("Basic ".length);
934
+ try {
935
+ const decoded = Buffer.from(token, "base64").toString("utf8");
936
+ const parts = decoded.split(":");
937
+ parts.shift();
938
+ return parts.join(":");
939
+ } catch {
940
+ return void 0;
941
+ }
942
+ }
943
+ function renderAuthErrorPage(message) {
944
+ return `<!DOCTYPE html>
945
+ <html lang="en">
946
+ <head>
947
+ <meta charset="UTF-8" />
948
+ <meta name="viewport" content="width=device-width, initial-scale=1.0" />
949
+ <title>RRRoutes docs locked</title>
950
+ <style>
951
+ body { margin:0; font-family: system-ui, -apple-system, Segoe UI, sans-serif; background: #0f172a; color: #e2e8f0; display:flex; align-items:center; justify-content:center; min-height:100vh; }
952
+ .card { padding:32px; border:1px solid #1e293b; border-radius:12px; max-width:420px; background: rgba(15,23,42,0.8); box-shadow:0 15px 45px rgba(0,0,0,0.35); }
953
+ h1 { margin:0 0 12px; font-size:22px; }
954
+ p { margin:0; line-height:1.5; color:#cbd5e1; }
955
+ code { background: rgba(226,232,240,0.1); padding: 2px 4px; border-radius: 4px; }
956
+ </style>
957
+ </head>
958
+ <body>
959
+ <div class="card">
960
+ <h1>Docs locked</h1>
961
+ <p>${message}</p>
962
+ </div>
963
+ </body>
964
+ </html>`;
965
+ }
966
+ function applyDocsSecurityHeaders(res) {
967
+ res.setHeader("X-Content-Type-Options", "nosniff");
968
+ res.setHeader("Referrer-Policy", "same-origin");
969
+ res.setHeader("X-Frame-Options", "SAMEORIGIN");
970
+ res.setHeader("Cache-Control", "no-store");
971
+ }
862
972
  // Annotate the CommonJS export names for ESM import in node:
863
973
  0 && (module.exports = {
864
974
  mountRRRoutesDocs,
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/docs/LeafDocsPage.tsx","../src/docs/schemaIntrospection.ts","../src/docs/serializer.ts","../src/docs/docs.ts","../src/webhooks.ts"],"sourcesContent":["/**\n * dry styles\nfake history logs data for testing\ngraphs for history data\nlogs webhook\nsecurity -> gated access + give environment and if environment='production' -> extra \"Are you sure you want to do this\" pop-up for each non-get action\n */\n\nimport type { AnyLeaf } from '@emeryld/rrroutes-contract';\nimport { randomBytes } from 'crypto';\nimport type { Request, Response, Router } from 'express';\nimport { static as expressStatic } from 'express';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport z from 'zod';\nimport type { SerializableHistoryEntry } from './docs/docs.js';\nimport { renderLeafDocsHTML } from './docs/docs.js';\nimport type { SerializablePreset } from './docs/presets.js';\nimport {\n historyFeedEntrySchema,\n historyFeedQuerySchema,\n historyWebhookResponseSchema,\n logFeedEntrySchema,\n logFeedQuerySchema,\n logWebhookResponseSchema,\n type HistoryFeedEntry,\n type HistoryFeedQuery,\n type LogFeedEntry,\n type LogFeedQuery,\n type LogType,\n type WebhookPage,\n type WebhookPaths\n} from './webhooks.js';\n\nexport type DocsRequestContext = {\n req: Request;\n res: Response;\n leaves: AnyLeaf[];\n presets: PresetGroup<AnyLeaf>[];\n};\n\nexport type DocsOnRequestResult = {\n leaves?: AnyLeaf[];\n presets?: PresetGroup<AnyLeaf>[];\n nonce?: string;\n html?: string;\n};\n\nexport type OpenApiDocsOptions = {\n /** Path where docs are mounted. Defaults to `/__rrroutes/docs`. */\n path?: string;\n prefix?: string;\n /** Whether to emit a CSP header + nonce. Defaults to true. */\n csp?: boolean;\n /** Override where static assets are served from. Defaults to `${path}/assets`. */\n assetBasePath?: string;\n /** Optional seed history entries that will pre-populate the docs UI history. */\n historySeeds?: SerializableHistoryEntry[];\n /** Optional seed log entries that will pre-populate the docs UI logs tab. */\n logSeeds?: LogFeedEntry[];\n /** Handlers + settings for webhook-driven history/log feeds. */\n logWebhook?: LogWebhookConfig;\n /**\n * Hook that runs on every request. Use it to adjust leaves, override nonce, or\n * provide a fully custom HTML response.\n */\n onRequest?: (ctx: DocsRequestContext) => DocsOnRequestResult | void;\n};\n\nexport type Preset<L extends AnyLeaf> = L extends infer A extends AnyLeaf? {\n method: A['method'];\n path: A['path'];\n // pre-set values for schemas. Does not have to be complete.\n body?: z.output<A['cfg']['bodySchema']>;\n query?: z.output<A['cfg']['querySchema']>;\n params?: z.output<A['cfg']['paramsSchema']>;\n}:never;\n\nexport type PresetGroup<L extends AnyLeaf> = {\n name: string;\n description?: string;\n tags: string[];\n docsGroup?: string;\n\n ops: Preset<L>[];\n};\n\nexport type MountDocsArgs<L extends AnyLeaf> = {\n router: Router;\n leaves: L[];\n presets?: PresetGroup<L>[];\n options?: OpenApiDocsOptions;\n};\n\nexport type WebhookLeafMap = {\n history: AnyLeaf;\n logs: AnyLeaf;\n};\n\nexport type WebhookSchemaMap = {\n history: {\n query: typeof historyFeedQuerySchema;\n response: typeof historyWebhookResponseSchema;\n entry: typeof historyFeedEntrySchema;\n };\n logs: {\n query: typeof logFeedQuerySchema;\n response: typeof logWebhookResponseSchema;\n entry: typeof logFeedEntrySchema;\n };\n};\n\nexport type MountDocsResult = {\n path: string;\n webhooks: WebhookPaths;\n webhookLeaves: WebhookLeafMap;\n webhookSchemas: WebhookSchemaMap;\n};\n\ntype WebhookHandler<Q, R> = (ctx: { query: Q; req: Request; res: Response }) => Promise<WebhookPage<R>> | WebhookPage<R>;\n\nexport type LogWebhookConfig = {\n /** Base path for webhook endpoints. Defaults to `${docsPath}/webhooks`. */\n basePath?: string;\n /** Handler to hydrate the history feed. */\n history?: WebhookHandler<HistoryFeedQuery, HistoryFeedEntry>;\n /** Handler to hydrate the log feed. */\n logs?: WebhookHandler<LogFeedQuery, LogFeedEntry>;\n};\n\nconst trimTrailingSlash = (value: string) =>\n value.endsWith('/') && value.length > 1 ? value.slice(0, -1) : value;\n\nexport function mountRRRoutesDocs<L extends AnyLeaf>({\n router,\n leaves,\n presets = [],\n options = {},\n}: MountDocsArgs<L>): MountDocsResult {\n const prefix = options.prefix ? trimTrailingSlash(options.prefix) : '';\n const docsPath = options.path ?? '/__rrroutes/docs';\n const normalizedDocsPath = trimTrailingSlash(docsPath);\n const assetsMountPath = trimTrailingSlash(\n options.assetBasePath ?? `${normalizedDocsPath}/assets`,\n );\n const webhookBaseInput = options.logWebhook?.basePath ?? `${normalizedDocsPath}/webhooks`;\n const webhookBasePath = trimTrailingSlash(\n webhookBaseInput.startsWith('/') ? webhookBaseInput : `/${webhookBaseInput}`,\n );\n const defaultHistoryLimit = 200;\n const defaultLogLimit = 400;\n const inMemoryHistory: HistoryFeedEntry[] = normalizeHistorySeeds(options.historySeeds, defaultHistoryLimit);\n const inMemoryLogs: LogFeedEntry[] = normalizeLogSeeds(options.logSeeds, defaultLogLimit);\n const webhookPaths: WebhookPaths = {\n history: `${webhookBasePath}/history`,\n logs: `${webhookBasePath}/logs`,\n };\n const webhookSchemas: WebhookSchemaMap = {\n history: {\n query: historyFeedQuerySchema,\n response: historyWebhookResponseSchema,\n entry: historyFeedEntrySchema,\n },\n logs: {\n query: logFeedQuerySchema,\n response: logWebhookResponseSchema,\n entry: logFeedEntrySchema,\n },\n };\n const webhookLeaves = {\n history: {\n method: 'get',\n path: webhookPaths.history,\n cfg: {\n summary: 'RRRoutes docs history feed',\n description: 'Returns request history for the docs UI.',\n querySchema: historyFeedQuerySchema,\n outputSchema: historyWebhookResponseSchema,\n tags: ['rrroutes', 'docs'],\n },\n },\n logs: {\n method: 'get',\n path: webhookPaths.logs,\n cfg: {\n summary: 'RRRoutes docs request logs',\n description: 'Returns request logs for the docs UI.',\n querySchema: logFeedQuerySchema,\n outputSchema: logWebhookResponseSchema,\n tags: ['rrroutes', 'docs'],\n },\n },\n } as const satisfies WebhookLeafMap;\n const publicDir = resolvePublicDir();\n const assetsDir = path.join(publicDir, 'assets');\n const cspEnabled = options.csp !== false;\n\n router.use(assetsMountPath, expressStatic(assetsDir, { immutable: true, maxAge: '365d' }));\n const usingFakeHistory = !options.logWebhook?.history;\n const usingFakeLogs = !options.logWebhook?.logs;\n\n if (usingFakeHistory || usingFakeLogs) {\n router.use((req, res, next) => {\n if (\n req.path.startsWith(webhookBasePath) ||\n req.path.startsWith(assetsMountPath) ||\n req.path.startsWith(normalizedDocsPath)\n ) {\n return next();\n }\n const start = Date.now();\n const requestIdHeader =\n req.headers['x-request-id'] || req.headers['x-requestid'] || req.headers['x-request_id'];\n const requestId = Array.isArray(requestIdHeader) ? requestIdHeader[0] : requestIdHeader;\n res.once('finish', () => {\n const timestamp = Date.now();\n const durationMs = Math.max(timestamp - start, 0);\n const methodUpper = String(req.method || 'GET').toUpperCase();\n const pathOnly = req.path || req.originalUrl || '';\n const status = res.statusCode;\n const errorMsg = status >= 400 ? `${status}` : undefined;\n\n if (usingFakeHistory) {\n inMemoryHistory.unshift({\n id: randomBytes(8).toString('hex'),\n requestId: requestId ? String(requestId) : undefined,\n timestamp,\n method: methodUpper,\n path: pathOnly,\n fullUrl: req.originalUrl || pathOnly,\n params: {},\n query: coerceQueryRecord(req.query),\n body: coercePayload(req.body),\n output: '',\n status,\n durationMs,\n error: errorMsg,\n });\n if (inMemoryHistory.length > defaultHistoryLimit) inMemoryHistory.length = defaultHistoryLimit;\n }\n\n if (usingFakeLogs) {\n const logType: LogType = status >= 500 ? 'error' : status >= 400 ? 'warn' : 'info';\n const metadata = JSON.stringify({\n query: req.query,\n durationMs,\n });\n inMemoryLogs.unshift({\n id: randomBytes(8).toString('hex'),\n type: logType,\n message: `${methodUpper} ${pathOnly} -> ${status}`,\n timestamp,\n requestId: requestId ? String(requestId) : undefined,\n tags: [],\n metadata,\n });\n if (inMemoryLogs.length > defaultLogLimit) inMemoryLogs.length = defaultLogLimit;\n }\n });\n next();\n });\n }\n\n router.get(webhookPaths.history, async (req, res) => {\n const handler = options.logWebhook?.history;\n try {\n const query = parseHistoryWebhookQuery(req);\n if (!handler) {\n const filtered = applyHistoryQuery(inMemoryHistory, query, defaultHistoryLimit);\n res.json(filtered);\n return;\n }\n const result = await handler({ query, req, res });\n\n const normalized = normalizeWebhookPage(result);\n const filtered = applyHistoryQuery(normalized.items, query, defaultHistoryLimit);\n res.json(filtered);\n } catch (err) {\n console.error('Failed to serve history webhook', err);\n res.status(500).json({ error: 'Failed to load history feed' });\n }\n });\n\n router.get(webhookPaths.logs, async (req, res) => {\n const handler = options.logWebhook?.logs;\n try {\n const query = parseLogWebhookQuery(req);\n if (!handler) {\n const filtered = applyLogsQuery(inMemoryLogs, query, defaultLogLimit);\n res.json(filtered);\n return;\n }\n const result = await handler({ query, req, res });\n const normalized = normalizeWebhookPage(result);\n const filtered = applyLogsQuery(normalized.items, query, defaultLogLimit);\n res.json(filtered);\n } catch (err) {\n console.error('Failed to serve log webhook', err);\n res.status(500).json({ error: 'Failed to load logs feed' });\n }\n });\n\n const docsRoutePaths = [normalizedDocsPath, `${normalizedDocsPath}/`, `${normalizedDocsPath}/*id`];\n\n router.get(docsRoutePaths, (req, res) => {\n const preparedLeaves = Array.isArray(leaves)\n ? leaves.filter((leaf) => leaf.cfg.docsHidden !== true)\n : [];\n const preparedPresets = Array.isArray(presets) ? presets : [];\n const onRequestResult =\n options.onRequest?.({ req, res, leaves: preparedLeaves, presets: preparedPresets }) ?? {};\n const finalLeaves = onRequestResult.leaves ?? preparedLeaves;\n const finalPresets = onRequestResult.presets ?? preparedPresets;\n\n const hasCustomHtml = typeof onRequestResult.html === 'string';\n\n let nonce = onRequestResult.nonce;\n if (!nonce && cspEnabled && !hasCustomHtml) {\n nonce = randomBytes(16).toString('base64');\n }\n\n const html = hasCustomHtml\n ? (onRequestResult.html as string)\n : renderLeafDocsHTML(finalLeaves, {\n cspNonce: nonce,\n assetBasePath: `${prefix}${assetsMountPath}`,\n docsBasePath: `${prefix}${normalizedDocsPath}`,\n baseUrlSuffix: prefix,\n historySeeds: options.historySeeds,\n logSeeds: options.logSeeds,\n presets: normalizePresets(finalPresets),\n webhooks: {\n history: `${prefix}${webhookPaths.history}`,\n logs: `${prefix}${webhookPaths.logs}`,\n },\n });\n\n if (cspEnabled && nonce) {\n res.setHeader(\n 'Content-Security-Policy',\n [\n \"default-src 'self'\",\n `script-src 'self' 'nonce-${nonce}'`,\n `style-src 'self' 'nonce-${nonce}'`,\n \"img-src 'self' data:\",\n \"connect-src 'self'\",\n \"font-src 'self'\",\n \"frame-ancestors 'self'\",\n ].join('; '),\n );\n }\n\n res.send(html);\n });\n\n return { path: docsPath, webhooks: webhookPaths, webhookLeaves, webhookSchemas };\n}\n\nfunction resolvePublicDir() {\n const moduleDir =\n typeof __dirname !== 'undefined'\n ? __dirname\n : path.dirname(fileURLToPath(import.meta.url));\n const fromModule = path.resolve(moduleDir, '../public');\n if (fs.existsSync(fromModule)) return fromModule;\n\n // When running from source (ts-node), fall back to the built output path.\n const fallback = path.resolve(moduleDir, '../dist/public');\n if (fs.existsSync(fallback)) return fallback;\n\n return fromModule; // fallback; express static will 404 if missing\n}\n\nfunction normalizePresets(presets: PresetGroup<AnyLeaf>[]): SerializablePreset[] {\n if (!Array.isArray(presets)) return [];\n return presets.map((preset) => ({\n name: preset.name,\n description: preset.description,\n tags: Array.isArray(preset.tags) ? preset.tags.slice() : [],\n docsGroup: preset.docsGroup,\n ops: Array.isArray(preset.ops)\n ? preset.ops.map((op) => ({\n method: typeof op.method === 'string' ? op.method.toUpperCase() : '',\n path: typeof op.path === 'string' ? op.path : '',\n body: op.body,\n query: op.query,\n params: op.params,\n }))\n : [],\n }));\n}\n\nfunction parseHistoryWebhookQuery(req: Request): HistoryFeedQuery {\n const query = req.query || {};\n const methods = parseStringList(query.methods);\n const path = typeof query.path === 'string' ? query.path : undefined;\n const status = typeof query.status === 'string' ? query.status : undefined;\n const text = typeof query.text === 'string' ? query.text : undefined;\n const cursor = typeof query.cursor === 'string' ? query.cursor : undefined;\n const sortBy = isSortKey(query.sortBy) ? (query.sortBy as HistoryFeedQuery['sortBy']) : undefined;\n const sortDir = isSortDir(query.sortDir) ? (query.sortDir as HistoryFeedQuery['sortDir']) : undefined;\n const limit = parseLimit(query.limit);\n const from = parseDateInput(query.from);\n const to = parseDateInput(query.to);\n\n return {\n cursor,\n methods,\n path,\n status,\n text,\n limit,\n from,\n to,\n sortBy,\n sortDir,\n };\n}\n\nfunction parseLogWebhookQuery(req: Request): LogFeedQuery {\n const query = req.query || {};\n const types = parseStringList(query.types) as LogFeedQuery['types'];\n const tags = parseStringList(query.tags);\n const requestId = typeof query.requestId === 'string' ? query.requestId : undefined;\n const text = typeof query.text === 'string' ? query.text : undefined;\n const cursor = typeof query.cursor === 'string' ? query.cursor : undefined;\n const limit = parseLimit(query.limit);\n const from = parseDateInput(query.from);\n const to = parseDateInput(query.to);\n const sortDir = isSortDir(query.sortDir) ? (query.sortDir as LogFeedQuery['sortDir']) : undefined;\n\n return {\n cursor,\n types,\n tags,\n requestId,\n text,\n limit,\n from,\n to,\n sortDir,\n };\n}\n\nfunction parseStringList(value: unknown) {\n if (typeof value !== 'string') return undefined;\n const parts = value\n .split(',')\n .map((p) => p.trim())\n .filter(Boolean);\n return parts.length ? parts : undefined;\n}\n\nfunction parseLimit(value: unknown) {\n if (value === undefined) return undefined;\n const num = Number(value);\n if (!Number.isFinite(num) || num <= 0) return undefined;\n return num;\n}\n\nfunction parseDateInput(value: unknown) {\n if (typeof value !== 'string') return undefined;\n const numeric = Number(value);\n if (Number.isFinite(numeric)) return numeric;\n const timestamp = Date.parse(value);\n if (Number.isNaN(timestamp)) return undefined;\n return timestamp;\n}\n\nfunction isSortKey(value: unknown) {\n return value === 'timestamp' || value === 'path' || value === 'duration';\n}\n\nfunction isSortDir(value: unknown) {\n return value === 'asc' || value === 'desc';\n}\n\nfunction normalizeWebhookPage<T>(page: WebhookPage<T> | null | undefined): WebhookPage<T> {\n if (!page || typeof page !== 'object') return { items: [] };\n return {\n items: Array.isArray(page.items) ? page.items : [],\n nextCursor: page.nextCursor,\n prevCursor: page.prevCursor,\n total: page.total,\n };\n}\n\nfunction applyHistoryQuery(\n items: HistoryFeedEntry[],\n query: HistoryFeedQuery,\n hardLimit: number,\n): WebhookPage<HistoryFeedEntry> {\n const fromTs = typeof query.from === 'number' ? query.from : undefined;\n const toTs = typeof query.to === 'number' ? query.to : undefined;\n const methods = query.methods ? new Set(query.methods.map((m) => m.toUpperCase())) : undefined;\n const pathNeedle = (query.path || '').toLowerCase();\n const textNeedle = (query.text || '').toLowerCase();\n const statusNeedle = (query.status || '').trim();\n const filtered = (Array.isArray(items) ? items : []).filter((entry) => {\n if (methods?.size && !methods.has(String(entry.method || '').toUpperCase())) return false;\n if (pathNeedle && !String(entry.path || '').toLowerCase().includes(pathNeedle)) return false;\n if (statusNeedle) {\n const statusStr =\n entry.status !== undefined && entry.status !== null ? String(entry.status) : 'ERR';\n if (!statusStr.startsWith(statusNeedle)) return false;\n }\n if (Number.isFinite(fromTs) && entry.timestamp < (fromTs as number)) return false;\n if (Number.isFinite(toTs) && entry.timestamp > (toTs as number)) return false;\n if (textNeedle) {\n const haystack = [\n entry.path,\n entry.fullUrl,\n entry.body,\n entry.output,\n entry.error,\n JSON.stringify(entry.params || {}),\n JSON.stringify(entry.query || {}),\n ]\n .filter(Boolean)\n .join(' ')\n .toLowerCase();\n if (!haystack.includes(textNeedle)) return false;\n }\n return true;\n });\n\n const sortBy = query.sortBy || 'timestamp';\n const direction = query.sortDir === 'asc' ? 1 : -1;\n const sorted = filtered.slice().sort((a, b) => {\n let delta = 0;\n if (sortBy === 'path') {\n delta = String(a.path || '').localeCompare(String(b.path || ''));\n } else if (sortBy === 'duration') {\n delta = (a.durationMs || 0) - (b.durationMs || 0);\n } else {\n delta = (a.timestamp || 0) - (b.timestamp || 0);\n }\n return delta * direction;\n });\n\n return paginateItems(sorted, query.cursor, query.limit, hardLimit, 25);\n}\n\nfunction applyLogsQuery(\n items: LogFeedEntry[],\n query: LogFeedQuery,\n hardLimit: number,\n): WebhookPage<LogFeedEntry> {\n const fromTs = typeof query.from === 'number' ? query.from : undefined;\n const toTs = typeof query.to === 'number' ? query.to : undefined;\n const textNeedle = (query.text || '').toLowerCase();\n const requestIdNeedle = (query.requestId || '').toLowerCase();\n const types = query.types ? new Set(query.types) : undefined;\n const tags = query.tags ? new Set(query.tags) : undefined;\n const filtered = (Array.isArray(items) ? items : []).filter((entry) => {\n if (types?.size && !types.has(entry.type)) return false;\n const entryTags = Array.isArray(entry.tags) ? entry.tags : [];\n if (tags?.size && !entryTags.some((tag) => tags.has(tag))) return false;\n if (requestIdNeedle && !(entry.requestId || '').toLowerCase().includes(requestIdNeedle))\n return false;\n if (Number.isFinite(fromTs) && entry.timestamp < (fromTs as number)) return false;\n if (Number.isFinite(toTs) && entry.timestamp > (toTs as number)) return false;\n if (textNeedle) {\n const haystack = [\n entry.message,\n entry.requestId,\n entryTags.join(' '),\n typeof entry.metadata === 'string' ? entry.metadata : JSON.stringify(entry.metadata || ''),\n ]\n .filter(Boolean)\n .join(' ')\n .toLowerCase();\n if (!haystack.includes(textNeedle)) return false;\n }\n return true;\n });\n\n const direction = query.sortDir === 'asc' ? 1 : -1;\n const sorted = filtered.slice().sort((a, b) => (a.timestamp - b.timestamp) * direction);\n\n return paginateItems(sorted, query.cursor, query.limit, hardLimit, 50);\n}\n\nfunction paginateItems<T>(\n items: T[],\n cursor: string | undefined,\n limit: number | undefined,\n hardLimit: number,\n fallbackLimit: number,\n): WebhookPage<T> {\n const safeLimit = clampLimit(limit, hardLimit, fallbackLimit);\n const start = parseCursor(cursor);\n const end = start + safeLimit;\n const slice = items.slice(start, end);\n const nextCursor = end < items.length ? String(end) : undefined;\n const prevCursor = start > 0 ? String(Math.max(start - safeLimit, 0)) : undefined;\n return {\n items: slice,\n nextCursor,\n prevCursor,\n total: items.length,\n };\n}\n\nfunction clampLimit(value: number | undefined, hardLimit: number, fallback: number) {\n if (!Number.isFinite(value)) return Math.min(hardLimit, fallback);\n const safe = Math.max(1, Math.min(hardLimit, value as number));\n return safe;\n}\n\nfunction parseCursor(cursor: string | undefined | null) {\n const num = Number(cursor);\n if (Number.isFinite(num) && num >= 0) return Math.floor(num);\n return 0;\n}\n\nfunction normalizeHistorySeeds(\n seeds: SerializableHistoryEntry[] | undefined,\n hardLimit: number,\n): HistoryFeedEntry[] {\n if (!Array.isArray(seeds)) return [];\n return seeds\n .slice(0, hardLimit)\n .map((entry, idx) => ({\n id: entry.id || randomBytes(8).toString('hex'),\n requestId: typeof (entry as any).requestId === 'string' ? (entry as any).requestId : undefined,\n timestamp: entry.timestamp ?? Date.now() - idx * 1000,\n method: entry.method || 'GET',\n path: entry.path || '/',\n fullUrl: entry.fullUrl || entry.path || '/',\n params: entry.params || {},\n query: entry.query || {},\n body: entry.body || '',\n output: entry.output || '',\n status: entry.status,\n durationMs: entry.durationMs ?? 0,\n error: entry.error,\n }))\n .filter((entry) => entry.method && entry.path);\n}\n\nfunction normalizeLogSeeds(seeds: LogFeedEntry[] | undefined, hardLimit: number): LogFeedEntry[] {\n if (!Array.isArray(seeds)) return [];\n return seeds\n .slice(0, hardLimit)\n .map((entry, idx) => ({\n id: entry.id || randomBytes(8).toString('hex'),\n type: entry.type || 'info',\n message: entry.message || '',\n timestamp: entry.timestamp ?? Date.now() - idx * 1000,\n requestId: entry.requestId,\n tags: Array.isArray(entry.tags) ? entry.tags : [],\n metadata: entry.metadata,\n }))\n .filter((entry) => entry.message);\n}\n\nfunction coerceQueryRecord(query: Request['query']): Record<string, string> {\n if (!query || typeof query !== 'object') return {};\n return Object.fromEntries(\n Object.entries(query).map(([key, value]) => [key, coerceValue(value)]),\n );\n}\n\nfunction coercePayload(body: unknown): string {\n if (body === undefined || body === null) return '';\n if (typeof body === 'string') return body;\n try {\n return JSON.stringify(body);\n } catch {\n return String(body);\n }\n}\n\nfunction coerceValue(value: unknown): string {\n if (value === undefined || value === null) return '';\n if (Array.isArray(value)) return value.map(coerceValue).join(',');\n if (typeof value === 'object') {\n try {\n return JSON.stringify(value);\n } catch {\n return String(value);\n }\n }\n return String(value);\n}\n\nexport { renderLeafDocsHTML } from './docs/docs.js';\nexport { serializeLeaf } from './docs/serializer.js';\nexport type { SerializableLeaf } from './docs/serializer.js';\nexport type {\n HistoryFeedEntry, historyFeedEntrySchema, HistoryFeedQuery, historyFeedQuerySchema,\n historyWebhookResponseSchema, LogFeedEntry, logFeedEntrySchema, LogFeedQuery, logFeedQuerySchema, LogType, logTypeSchema, logWebhookResponseSchema, WebhookPage, webhookPageSchema, WebhookPaths\n} from './webhooks.js';\n","import type { AnyLeaf } from '@emeryld/rrroutes-contract';\nimport type { ReactElement } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\nimport type { SerializablePreset } from './presets.js';\nimport { serializeLeaf } from './serializer.js';\nimport type { WebhookPaths } from '../webhooks.js';\nimport type { LogFeedEntry } from '../webhooks.js';\n\nexport interface RenderOptions {\n /** CSP nonce applied to data + script tags. */\n cspNonce?: string;\n /** Base URL where static assets are served (e.g. `/__rrroutes/docs/assets`). */\n assetBasePath?: string;\n /** Root path where the docs are mounted (e.g. `/__rrroutes/docs`). Used for client routing. */\n docsBasePath?: string;\n /** Optional suffix appended to the window origin when building default playground base URLs. */\n baseUrlSuffix?: string;\n /** Preset collections rendered into the docs UI. */\n presets?: SerializablePreset[];\n /** Optional seed history entries to pre-populate the UI (useful in dev). */\n historySeeds?: SerializableHistoryEntry[];\n /** Optional seed log entries to pre-populate the logs UI. */\n logSeeds?: LogFeedEntry[];\n /** Paths for webhook-backed history/log feeds. */\n webhooks?: WebhookPaths;\n}\n\nconst DEFAULT_ASSET_BASE = '/__rrroutes/docs/assets';\n\nfunction normalizeBase(base: string) {\n if (!base) return DEFAULT_ASSET_BASE;\n return base.endsWith('/') ? base.slice(0, -1) : base;\n}\n\nfunction normalizeDocsBase(base: string | undefined) {\n if (!base) return '';\n if (base === '/') return '/';\n return base.endsWith('/') && base.length > 1 ? base.slice(0, -1) : base;\n}\n\nfunction normalizeBaseUrlSuffix(suffix: string | undefined) {\n if (!suffix) return '';\n const trimmed = suffix.endsWith('/') && suffix.length > 1 ? suffix.slice(0, -1) : suffix;\n return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;\n}\n\ntype DocsDocumentProps = {\n leavesJson: string;\n presetsJson: string;\n assetBase: string;\n docsBase: string;\n historyJson: string;\n logsJson: string;\n baseUrlSuffix?: string;\n webhooks?: WebhookPaths;\n cspNonce?: string;\n};\n\nexport const DocsDocument = ({\n leavesJson,\n presetsJson,\n assetBase,\n docsBase,\n historyJson,\n logsJson,\n baseUrlSuffix,\n webhooks,\n cspNonce,\n}: DocsDocumentProps) => {\n const cssHref = `${assetBase}/docs.css`;\n const jsSrc = `${assetBase}/docs.js`;\n const configJson = serializeConfig({ docsBasePath: docsBase, baseUrlSuffix, webhooks });\n\n return (\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>API Reference</title>\n <link rel=\"stylesheet\" href={cssHref} />\n </head>\n <body>\n <div id=\"docs-root\"></div>\n <script\n id=\"leaf-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: leavesJson }}\n />\n <script\n id=\"preset-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: presetsJson }}\n />\n <script\n id=\"history-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: historyJson }}\n />\n <script\n id=\"logs-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: logsJson }}\n />\n <script\n id=\"docs-config\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: configJson }}\n />\n <script type=\"module\" src={jsSrc} nonce={cspNonce} />\n </body>\n </html>\n );\n};\n\nfunction serializeLeaves(leaves: AnyLeaf[]) {\n return JSON.stringify(leaves.map(serializeLeaf)).replace(/<\\//g, '<\\\\/');\n}\n\nfunction serializePresets(presets: SerializablePreset[] | undefined) {\n return JSON.stringify(Array.isArray(presets) ? presets : []).replace(/<\\//g, '<\\\\/');\n}\n\nfunction serializeHistorySeeds(historySeeds: SerializableHistoryEntry[] | undefined) {\n return JSON.stringify(Array.isArray(historySeeds) ? historySeeds : []).replace(/<\\//g, '<\\\\/');\n}\n\nfunction serializeLogSeeds(logSeeds: LogFeedEntry[] | undefined) {\n return JSON.stringify(Array.isArray(logSeeds) ? logSeeds : []).replace(/<\\//g, '<\\\\/');\n}\n\ntype DocsConfig = { docsBasePath: string; baseUrlSuffix?: string; webhooks?: WebhookPaths };\n\nfunction serializeConfig(config: DocsConfig) {\n return JSON.stringify(config).replace(/<\\//g, '<\\\\/');\n}\n\nexport function createLeafDocsDocument(\n leaves: AnyLeaf[],\n options: RenderOptions = {},\n): ReactElement {\n const assetBase = normalizeBase(options.assetBasePath ?? DEFAULT_ASSET_BASE);\n const leavesJson = serializeLeaves(leaves);\n const presetsJson = serializePresets(options.presets);\n const docsBase = normalizeDocsBase(options.docsBasePath);\n const historyJson = serializeHistorySeeds(options.historySeeds);\n const logsJson = serializeLogSeeds(options.logSeeds);\n const baseUrlSuffix = normalizeBaseUrlSuffix(options.baseUrlSuffix);\n const webhooks = options.webhooks;\n\n return (\n <DocsDocument\n leavesJson={leavesJson}\n presetsJson={presetsJson}\n assetBase={assetBase}\n docsBase={docsBase}\n historyJson={historyJson}\n logsJson={logsJson}\n baseUrlSuffix={baseUrlSuffix}\n webhooks={webhooks}\n cspNonce={options.cspNonce}\n />\n );\n}\n\nexport function renderLeafDocsHTML(leaves: AnyLeaf[], options: RenderOptions = {}): string {\n const doc = createLeafDocsDocument(leaves, options);\n const html = renderToStaticMarkup(doc);\n return `<!DOCTYPE html>${html}`;\n}\n\nexport type SerializableHistoryEntry = {\n id?: string;\n timestamp: number;\n method: string;\n path: string;\n fullUrl: string;\n params?: Record<string, string>;\n query?: Record<string, string>;\n body?: string;\n output?: string;\n status?: number;\n durationMs: number;\n error?: string;\n};\n","// schemaIntrospection.ts\nimport * as z from \"zod\";\n\nexport type SerializableSchemaNode = {\n kind: string; // \"object\" | \"string\" | \"number\" | ...\n optional?: boolean;\n nullable?: boolean;\n description?: string;\n\n // object\n properties?: Record<string, SerializableSchemaNode>;\n // array\n element?: SerializableSchemaNode;\n // union\n union?: SerializableSchemaNode[];\n // literal\n literal?: unknown;\n // enum\n enumValues?: string[];\n};\n\ntype ZodAny = z.ZodTypeAny;\n\n/**\n * Zod 3 uses `schema._def`, Zod 4 uses `schema._zod.def`.\n */\nfunction getDef(schema: unknown): any | undefined {\n if (!schema || typeof schema !== \"object\") return undefined;\n const anySchema = schema as any;\n return anySchema._zod?.def ?? anySchema._def;\n}\n\n/**\n * Try to get a human-readable description.\n * Zod 4: use metadata/registry; fallback to internal def.description.\n * Zod 3: only internal def.description exists.\n */\nfunction getDescription(schema: ZodAny): string | undefined {\n const anyZ: any = z as any;\n\n // Zod 4 global registry metadata, if present\n const registry = anyZ.globalRegistry?.get\n ? anyZ.globalRegistry.get(schema)\n : undefined;\n if (registry && typeof registry.description === \"string\") {\n return registry.description;\n }\n\n // Legacy / internal description\n const def = getDef(schema);\n if (def && typeof def.description === \"string\") {\n return def.description;\n }\n\n return undefined;\n}\n\n/**\n * Peel off wrappers (effects, optional, nullable, default) and\n * return the inner schema + flags.\n *\n * Supports:\n * - Zod 3: ZodEffects, ZodOptional, ZodNullable, ZodDefault\n * - Zod 4: ZodOptional, ZodNullable, ZodDefault\n */\nfunction unwrap(schema: ZodAny): {\n base: ZodAny;\n optional: boolean;\n nullable: boolean;\n} {\n let s: ZodAny = schema;\n let optional = false;\n let nullable = false;\n\n // Zod 3 only (undefined in Zod 4)\n const ZodEffectsCtor: any = (z as any).ZodEffects;\n\n // eslint-disable-next-line no-constant-condition\n while (true) {\n // Zod 3: ZodEffects wrapper\n if (ZodEffectsCtor && s instanceof ZodEffectsCtor) {\n const def = getDef(s) || {};\n const sourceType =\n typeof (s as any).sourceType === \"function\"\n ? (s as any).sourceType()\n : def.schema;\n if (!sourceType) break;\n s = sourceType;\n continue;\n }\n\n // Zod 3 + 4: optional/nullable/default wrappers\n if (s instanceof z.ZodOptional) {\n optional = true;\n const def = getDef(s);\n s = (def && def.innerType) || s; // innerType exists in both 3 & 4\n continue;\n }\n\n if (s instanceof z.ZodNullable) {\n nullable = true;\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n if (s instanceof z.ZodDefault) {\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n break;\n }\n\n return { base: s, optional, nullable };\n}\n\nexport function introspectSchema(\n schema: ZodAny | undefined\n): SerializableSchemaNode | undefined {\n if (!schema) return undefined;\n\n const { base, optional, nullable } = unwrap(schema);\n const def = getDef(base);\n\n const node: SerializableSchemaNode = {\n kind: inferKind(base),\n optional: optional || undefined,\n nullable: nullable || undefined,\n description: getDescription(base),\n };\n\n // OBJECT\n if (base instanceof z.ZodObject) {\n // Zod 3: _def.shape() (function)\n // Zod 4: .shape getter returns an object\n const rawShape: any =\n (base as any).shape ?? (def && typeof def.shape === \"function\"\n ? def.shape()\n : def?.shape);\n\n const shape =\n typeof rawShape === \"function\" ? rawShape() : rawShape ?? {};\n\n const props: Record<string, SerializableSchemaNode> = {};\n for (const key of Object.keys(shape)) {\n const child = shape[key] as ZodAny;\n const childNode = introspectSchema(child);\n if (childNode) props[key] = childNode;\n }\n node.properties = props;\n }\n\n // ARRAY\n if (base instanceof z.ZodArray) {\n // Zod 3: def.type is inner schema\n // Zod 4: def.element is inner schema\n const inner =\n (def && (def.element as ZodAny)) ||\n (def && (def.type as ZodAny)) ||\n undefined;\n if (inner) {\n node.element = introspectSchema(inner);\n }\n }\n\n // UNION\n if (base instanceof z.ZodUnion) {\n const options: ZodAny[] = (def && def.options) || [];\n node.union = options\n .map((opt) => introspectSchema(opt))\n .filter(Boolean) as SerializableSchemaNode[];\n }\n\n // LITERAL\n if (base instanceof z.ZodLiteral) {\n if (def) {\n // Zod 4: def.values (multi-literal)\n if (Array.isArray(def.values)) {\n node.literal =\n def.values.length === 1 ? def.values[0] : def.values.slice();\n } else {\n // Zod 3: def.value\n node.literal = def.value;\n }\n }\n }\n\n // ENUM\n if (base instanceof z.ZodEnum) {\n if (def) {\n if (Array.isArray(def.values)) {\n // Zod 3\n node.enumValues = def.values.slice();\n } else if (def.entries && typeof def.entries === \"object\") {\n // Zod 4: entries is a { key: value } map\n node.enumValues = Object.values(def.entries).map((v: unknown) =>\n String(v)\n );\n }\n }\n }\n\n return node;\n}\n\nfunction inferKind(schema: ZodAny): string {\n // This path still uses instanceof; it works with Zod 4 Classic\n // (importing from \"zod\"). Anything unknown falls back to \"unknown\".\n if (schema instanceof z.ZodString) return \"string\";\n if (schema instanceof z.ZodNumber) return \"number\";\n if (schema instanceof z.ZodBoolean) return \"boolean\";\n if (schema instanceof z.ZodBigInt) return \"bigint\";\n if (schema instanceof z.ZodDate) return \"date\";\n if (schema instanceof z.ZodArray) return \"array\";\n if (schema instanceof z.ZodObject) return \"object\";\n if (schema instanceof z.ZodUnion) return \"union\";\n if (schema instanceof z.ZodLiteral) return \"literal\";\n if (schema instanceof z.ZodEnum) return \"enum\";\n if (schema instanceof z.ZodRecord) return \"record\";\n if (schema instanceof z.ZodTuple) return \"tuple\";\n if (schema instanceof z.ZodUnknown) return \"unknown\";\n if (schema instanceof z.ZodAny) return \"any\";\n\n return \"unknown\";\n}\n","// serializer.ts\nimport type { AnyLeaf, MethodCfg } from \"@emeryld/rrroutes-contract\";\nimport { introspectSchema, SerializableSchemaNode } from \"./schemaIntrospection.js\";\n\ntype SerializableMethodCfg = Pick<\n MethodCfg,\n | \"description\"\n | \"summary\"\n | \"docsGroup\"\n | \"tags\"\n | \"deprecated\"\n | \"stability\"\n | \"feed\"\n | \"docsMeta\"\n> & {\n hasBody: boolean;\n hasQuery: boolean;\n hasParams: boolean;\n hasOutput: boolean;\n\n // NEW: full Zod ASTs\n bodySchema?: SerializableSchemaNode;\n querySchema?: SerializableSchemaNode;\n paramsSchema?: SerializableSchemaNode;\n outputSchema?: SerializableSchemaNode;\n};\n\nexport type SerializableLeaf = {\n method: string;\n path: string;\n cfg: SerializableMethodCfg;\n};\n\nexport type { SerializableSchemaNode } from \"./schemaIntrospection.js\";\n\nexport function serializeLeaf(leaf: AnyLeaf): SerializableLeaf {\n const cfg = leaf.cfg;\n\n const tags = Array.isArray(cfg.tags) ? cfg.tags.slice() : [];\n\n return {\n method: leaf.method, // 'get' | 'post' | ...\n path: leaf.path,\n cfg: {\n description: cfg.description,\n summary: cfg.summary,\n docsGroup: cfg.docsGroup,\n tags,\n deprecated: cfg.deprecated,\n stability: cfg.stability,\n feed: !!cfg.feed,\n docsMeta: cfg.docsMeta,\n hasBody: !!cfg.bodySchema || !!cfg.bodyFiles?.length,\n hasQuery: !!cfg.querySchema,\n hasParams: !!cfg.paramsSchema,\n hasOutput: !!cfg.outputSchema,\n\n bodySchema: introspectSchema(cfg.bodySchema),\n querySchema: introspectSchema(cfg.querySchema),\n paramsSchema: introspectSchema(cfg.paramsSchema),\n outputSchema: introspectSchema(cfg.outputSchema),\n },\n };\n}\n","// renderLeafDocsHTML.ts\nimport type { AnyLeaf } from \"@emeryld/rrroutes-contract\";\nimport {\n createLeafDocsDocument,\n renderLeafDocsHTML as LeafDocsPage,\n RenderOptions,\n} from \"./LeafDocsPage.js\";\n\nexport function renderLeafDocsHTML(leaves: AnyLeaf[], options: RenderOptions = {}): string {\n return LeafDocsPage(leaves, options);\n}\n\nexport type { RenderOptions, SerializableHistoryEntry } from \"./LeafDocsPage.js\";\nexport { createLeafDocsDocument } from \"./LeafDocsPage.js\";\nexport type { SerializablePreset, SerializablePresetOperation } from \"./presets.js\";\nexport type { LogFeedEntry } from \"../webhooks.js\";\n","import { z } from 'zod';\n\nexport type WebhookPage<T> = {\n items: T[];\n nextCursor?: string;\n prevCursor?: string;\n total?: number;\n};\n\nexport type WebhookPaths = {\n history: string;\n logs: string;\n};\n\nexport type HistoryFeedEntry = {\n id: string;\n requestId?: string;\n timestamp: number;\n method: string;\n path: string;\n fullUrl?: string;\n params?: Record<string, string>;\n query?: Record<string, string>;\n body?: string;\n output?: string;\n status?: number;\n durationMs: number;\n error?: string;\n};\n\nexport type HistoryFeedQuery = {\n cursor?: string;\n limit?: number;\n methods?: string[];\n path?: string;\n status?: string;\n from?: number;\n to?: number;\n text?: string;\n sortBy?: 'timestamp' | 'path' | 'duration';\n sortDir?: 'asc' | 'desc';\n};\n\nexport type LogType = 'debug' | 'info' | 'warn' | 'error' | 'system';\n\nexport type LogFeedEntry = {\n id: string;\n type: LogType;\n message: string;\n timestamp: number;\n requestId?: string;\n tags?: string[];\n metadata?: string;\n};\n\nexport type LogFeedQuery = {\n cursor?: string;\n limit?: number;\n types?: LogType[];\n tags?: string[];\n requestId?: string;\n text?: string;\n from?: number;\n to?: number;\n sortDir?: 'asc' | 'desc';\n};\n\nexport const logTypeSchema = z.enum(['debug', 'info', 'warn', 'error', 'system']);\n\nexport const historyFeedEntrySchema = z.object({\n id: z.string(),\n requestId: z.string().optional(),\n timestamp: z.number(),\n method: z.string(),\n path: z.string(),\n fullUrl: z.string().optional(),\n params: z.record(z.string(),z.string()).optional(),\n query: z.record(z.string(),z.string()).optional(),\n body: z.string().optional(),\n output: z.string().optional(),\n status: z.number().optional(),\n durationMs: z.number(),\n error: z.string().optional(),\n});\n\nexport const logFeedEntrySchema = z.object({\n id: z.string(),\n type: logTypeSchema,\n message: z.string(),\n timestamp: z.number(),\n requestId: z.string().optional(),\n tags: z.array(z.string()).optional(),\n metadata: z.string().optional(),\n});\n\nexport const historyFeedQuerySchema = z.object({\n cursor: z.string().optional(),\n limit: z.number().int().positive().optional(),\n methods: z.array(z.string()).optional(),\n path: z.string().optional(),\n status: z.string().optional(),\n text: z.string().optional(),\n from: z.number().optional(),\n to: z.number().optional(),\n sortBy: z.enum(['timestamp', 'path', 'duration']).optional(),\n sortDir: z.enum(['asc', 'desc']).optional(),\n});\n\nexport const logFeedQuerySchema = z.object({\n cursor: z.string().optional(),\n limit: z.number().int().positive().optional(),\n types: z.array(logTypeSchema).optional(),\n tags: z.array(z.string()).optional(),\n requestId: z.string().optional(),\n text: z.string().optional(),\n from: z.number().optional(),\n to: z.number().optional(),\n sortDir: z.enum(['asc', 'desc']).optional(),\n});\n\nexport const webhookPageSchema = <T extends z.ZodTypeAny>(itemSchema: T) =>\n z.object({\n items: z.array(itemSchema).default([]),\n nextCursor: z.string().optional(),\n prevCursor: z.string().optional(),\n total: z.number().optional(),\n });\n\nexport const historyWebhookResponseSchema = webhookPageSchema(historyFeedEntrySchema);\nexport const logWebhookResponseSchema = webhookPageSchema(logFeedEntrySchema);\n"],"mappings":"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","names":["renderLeafDocsHTML","renderLeafDocsHTML","path","expressStatic","filtered","renderLeafDocsHTML","fs"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/docs/LeafDocsPage.tsx","../src/docs/schemaIntrospection.ts","../src/docs/serializer.ts","../src/docs/docs.ts","../src/webhooks.ts"],"sourcesContent":["/**\n * dry styles\nfake history logs data for testing\ngraphs for history data\nlogs webhook\nsecurity -> gated access + give environment and if environment='production' -> extra \"Are you sure you want to do this\" pop-up for each non-get action\n */\n\nimport type { AnyLeaf } from '@emeryld/rrroutes-contract';\nimport { randomBytes } from 'crypto';\nimport type { Request, Response, Router } from 'express';\nimport { static as expressStatic } from 'express';\nimport fs from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport z from 'zod';\nimport type { SerializableHistoryEntry } from './docs/docs.js';\nimport { renderLeafDocsHTML } from './docs/docs.js';\nimport type { SerializablePreset } from './docs/presets.js';\nimport {\n historyFeedEntrySchema,\n historyFeedQuerySchema,\n historyWebhookResponseSchema,\n logFeedEntrySchema,\n logFeedQuerySchema,\n logWebhookResponseSchema,\n type HistoryFeedEntry,\n type HistoryFeedQuery,\n type LogFeedEntry,\n type LogFeedQuery,\n type LogType,\n type WebhookPage,\n type WebhookPaths\n} from './webhooks.js';\n\nexport type DocsRequestContext = {\n req: Request;\n res: Response;\n leaves: AnyLeaf[];\n presets: PresetGroup<AnyLeaf>[];\n};\n\nexport type DocsOnRequestResult = {\n leaves?: AnyLeaf[];\n presets?: PresetGroup<AnyLeaf>[];\n nonce?: string;\n html?: string;\n};\n\nexport type DocsAuthOptions = {\n /** Turn auth on/off. Enabled by default. */\n enabled?: boolean;\n /** Password to require for docs access. Falls back to the env var when omitted. */\n password?: string;\n /** Realm used for the HTTP Basic challenge prompt. */\n realm?: string;\n};\n\nexport type LogRedactor = (entry: LogFeedEntry) => LogFeedEntry | null | undefined;\n\nexport type OpenApiDocsOptions = {\n /** Path where docs are mounted. Defaults to `/__rrroutes/docs`. */\n path?: string;\n prefix?: string;\n /** Whether to emit a CSP header + nonce. Defaults to true. */\n csp?: boolean;\n /** Override where static assets are served from. Defaults to `${path}/assets`. */\n assetBasePath?: string;\n /** Optional seed history entries that will pre-populate the docs UI history. */\n historySeeds?: SerializableHistoryEntry[];\n /** Optional seed log entries that will pre-populate the docs UI logs tab. */\n logSeeds?: LogFeedEntry[];\n /** Handlers + settings for webhook-driven history/log feeds. */\n logWebhook?: LogWebhookConfig;\n /**\n * Optional hook to redact or drop log entries before they are persisted or sent to the UI.\n * Return `null`/`undefined` to skip an entry entirely.\n */\n redactLogEntry?: LogRedactor;\n /** Password protection + realm configuration for the mounted docs. */\n auth?: DocsAuthOptions;\n /**\n * Hook that runs on every request. Use it to adjust leaves, override nonce, or\n * provide a fully custom HTML response.\n */\n onRequest?: (ctx: DocsRequestContext) => DocsOnRequestResult | void;\n};\n\nexport type Preset<L extends AnyLeaf> = L extends infer A extends AnyLeaf? {\n method: A['method'];\n path: A['path'];\n // pre-set values for schemas. Does not have to be complete.\n body?: z.output<A['cfg']['bodySchema']>;\n query?: z.output<A['cfg']['querySchema']>;\n params?: z.output<A['cfg']['paramsSchema']>;\n}:never;\n\nexport type PresetGroup<L extends AnyLeaf> = {\n name: string;\n description?: string;\n tags: string[];\n docsGroup?: string;\n\n ops: Preset<L>[];\n};\n\nexport type MountDocsArgs<L extends AnyLeaf> = {\n router: Router;\n leaves: L[];\n presets?: PresetGroup<L>[];\n options?: OpenApiDocsOptions;\n};\n\nexport type WebhookLeafMap = {\n history: AnyLeaf;\n logs: AnyLeaf;\n};\n\nexport type WebhookSchemaMap = {\n history: {\n query: typeof historyFeedQuerySchema;\n response: typeof historyWebhookResponseSchema;\n entry: typeof historyFeedEntrySchema;\n };\n logs: {\n query: typeof logFeedQuerySchema;\n response: typeof logWebhookResponseSchema;\n entry: typeof logFeedEntrySchema;\n };\n};\n\nexport type MountDocsResult = {\n path: string;\n webhooks: WebhookPaths;\n webhookLeaves: WebhookLeafMap;\n webhookSchemas: WebhookSchemaMap;\n};\n\ntype WebhookHandler<Q, R> = (ctx: { query: Q; req: Request; res: Response }) => Promise<WebhookPage<R>> | WebhookPage<R>;\n\nexport type LogWebhookConfig = {\n /** Base path for webhook endpoints. Defaults to `${docsPath}/webhooks`. */\n basePath?: string;\n /** Handler to hydrate the history feed. */\n history?: WebhookHandler<HistoryFeedQuery, HistoryFeedEntry>;\n /** Handler to hydrate the log feed. */\n logs?: WebhookHandler<LogFeedQuery, LogFeedEntry>;\n};\n\nconst trimTrailingSlash = (value: string) =>\n value.endsWith('/') && value.length > 1 ? value.slice(0, -1) : value;\n\nexport function mountRRRoutesDocs<L extends AnyLeaf>({\n router,\n leaves,\n presets = [],\n options = {},\n}: MountDocsArgs<L>): MountDocsResult {\n const prefix = options.prefix ? trimTrailingSlash(options.prefix) : '';\n const docsPath = options.path ?? '/__rrroutes/docs';\n const normalizedDocsPath = trimTrailingSlash(docsPath);\n const assetsMountPath = trimTrailingSlash(\n options.assetBasePath ?? `${normalizedDocsPath}/assets`,\n );\n const webhookBaseInput = options.logWebhook?.basePath ?? `${normalizedDocsPath}/webhooks`;\n const webhookBasePath = trimTrailingSlash(\n webhookBaseInput.startsWith('/') ? webhookBaseInput : `/${webhookBaseInput}`,\n );\n const defaultHistoryLimit = 200;\n const defaultLogLimit = 400;\n const redactLogEntry = createLogRedactor(options.redactLogEntry);\n const seededHistory = normalizeHistorySeeds(options.historySeeds, defaultHistoryLimit);\n const seededLogs = normalizeLogSeeds(options.logSeeds, defaultLogLimit, redactLogEntry);\n const inMemoryHistory: HistoryFeedEntry[] = seededHistory.slice();\n const inMemoryLogs: LogFeedEntry[] = seededLogs.slice();\n const historySeedsForUi: SerializableHistoryEntry[] = seededHistory.map((entry) => ({\n ...entry,\n fullUrl: entry.fullUrl || entry.path,\n }));\n const webhookPaths: WebhookPaths = {\n history: `${webhookBasePath}/history`,\n logs: `${webhookBasePath}/logs`,\n };\n const webhookSchemas: WebhookSchemaMap = {\n history: {\n query: historyFeedQuerySchema,\n response: historyWebhookResponseSchema,\n entry: historyFeedEntrySchema,\n },\n logs: {\n query: logFeedQuerySchema,\n response: logWebhookResponseSchema,\n entry: logFeedEntrySchema,\n },\n };\n const webhookLeaves = {\n history: {\n method: 'get',\n path: webhookPaths.history,\n cfg: {\n summary: 'RRRoutes docs history feed',\n description: 'Returns request history for the docs UI.',\n querySchema: historyFeedQuerySchema,\n outputSchema: historyWebhookResponseSchema,\n tags: ['rrroutes', 'docs'],\n },\n },\n logs: {\n method: 'get',\n path: webhookPaths.logs,\n cfg: {\n summary: 'RRRoutes docs request logs',\n description: 'Returns request logs for the docs UI.',\n querySchema: logFeedQuerySchema,\n outputSchema: logWebhookResponseSchema,\n tags: ['rrroutes', 'docs'],\n },\n },\n } as const satisfies WebhookLeafMap;\n const publicDir = resolvePublicDir();\n const assetsDir = path.join(publicDir, 'assets');\n const cspEnabled = options.csp !== false;\n const authConfig = options.auth;\n const authEnabled = authConfig?.enabled !== false;\n const docsPassword = resolveDocsPassword(authConfig);\n const authRealm = authConfig?.realm || 'RRRoutes Docs';\n\n if (authEnabled) {\n const guard = docsPassword\n ? createPasswordGuard(docsPassword, authRealm)\n : createMissingPasswordGuard();\n [normalizedDocsPath, assetsMountPath, webhookBasePath].forEach((p) => {\n router.use(p, guard);\n });\n }\n\n router.use(assetsMountPath, expressStatic(assetsDir, { immutable: true, maxAge: '365d' }));\n const usingFakeHistory = !options.logWebhook?.history;\n const usingFakeLogs = !options.logWebhook?.logs;\n\n if (usingFakeHistory || usingFakeLogs) {\n router.use((req, res, next) => {\n if (\n req.path.startsWith(webhookBasePath) ||\n req.path.startsWith(assetsMountPath) ||\n req.path.startsWith(normalizedDocsPath)\n ) {\n return next();\n }\n const start = Date.now();\n const requestIdHeader =\n req.headers['x-request-id'] || req.headers['x-requestid'] || req.headers['x-request_id'];\n const requestId = Array.isArray(requestIdHeader) ? requestIdHeader[0] : requestIdHeader;\n res.once('finish', () => {\n const timestamp = Date.now();\n const durationMs = Math.max(timestamp - start, 0);\n const methodUpper = String(req.method || 'GET').toUpperCase();\n const pathOnly = req.path || req.originalUrl || '';\n const status = res.statusCode;\n const errorMsg = status >= 400 ? `${status}` : undefined;\n\n if (usingFakeHistory) {\n inMemoryHistory.unshift({\n id: randomBytes(8).toString('hex'),\n requestId: requestId ? String(requestId) : undefined,\n timestamp,\n method: methodUpper,\n path: pathOnly,\n fullUrl: req.originalUrl || pathOnly,\n params: {},\n query: coerceQueryRecord(req.query),\n body: coercePayload(req.body),\n output: '',\n status,\n durationMs,\n error: errorMsg,\n });\n if (inMemoryHistory.length > defaultHistoryLimit) inMemoryHistory.length = defaultHistoryLimit;\n }\n\n if (usingFakeLogs) {\n const logType: LogType = status >= 500 ? 'error' : status >= 400 ? 'warn' : 'info';\n const metadata = JSON.stringify({\n query: req.query,\n durationMs,\n });\n const redacted = redactLogEntry({\n id: randomBytes(8).toString('hex'),\n type: logType,\n message: `${methodUpper} ${pathOnly} -> ${status}`,\n timestamp,\n requestId: requestId ? String(requestId) : undefined,\n tags: [],\n metadata,\n });\n if (redacted) {\n inMemoryLogs.unshift(redacted);\n if (inMemoryLogs.length > defaultLogLimit) inMemoryLogs.length = defaultLogLimit;\n }\n }\n });\n next();\n });\n }\n\n router.get(webhookPaths.history, async (req, res) => {\n const handler = options.logWebhook?.history;\n try {\n applyDocsSecurityHeaders(res);\n const query = parseHistoryWebhookQuery(req);\n if (!handler) {\n const filtered = applyHistoryQuery(inMemoryHistory, query, defaultHistoryLimit);\n res.json(filtered);\n return;\n }\n const result = await handler({ query, req, res });\n\n const normalized = normalizeWebhookPage(result);\n const filtered = applyHistoryQuery(normalized.items, query, defaultHistoryLimit);\n res.json(filtered);\n } catch (err) {\n console.error('Failed to serve history webhook', err);\n res.status(500).json({ error: 'Failed to load history feed' });\n }\n });\n\n router.get(webhookPaths.logs, async (req, res) => {\n const handler = options.logWebhook?.logs;\n try {\n applyDocsSecurityHeaders(res);\n const query = parseLogWebhookQuery(req);\n if (!handler) {\n const filtered = applyLogsQuery(inMemoryLogs, query, defaultLogLimit);\n res.json(filtered);\n return;\n }\n const result = await handler({ query, req, res });\n const normalized = normalizeWebhookPage(result);\n const redacted = applyLogRedaction(normalized.items, redactLogEntry);\n const filtered = applyLogsQuery(redacted, query, defaultLogLimit);\n res.json(filtered);\n } catch (err) {\n console.error('Failed to serve log webhook', err);\n res.status(500).json({ error: 'Failed to load logs feed' });\n }\n });\n\n const docsRoutePaths = [normalizedDocsPath, `${normalizedDocsPath}/`, `${normalizedDocsPath}/*id`];\n\n router.get(docsRoutePaths, (req, res) => {\n const preparedLeaves = Array.isArray(leaves)\n ? leaves.filter((leaf) => leaf.cfg.docsHidden !== true)\n : [];\n const preparedPresets = Array.isArray(presets) ? presets : [];\n const onRequestResult =\n options.onRequest?.({ req, res, leaves: preparedLeaves, presets: preparedPresets }) ?? {};\n const finalLeaves = onRequestResult.leaves ?? preparedLeaves;\n const finalPresets = onRequestResult.presets ?? preparedPresets;\n\n const hasCustomHtml = typeof onRequestResult.html === 'string';\n\n let nonce = onRequestResult.nonce;\n if (!nonce && cspEnabled && !hasCustomHtml) {\n nonce = randomBytes(16).toString('base64');\n }\n\n const html = hasCustomHtml\n ? (onRequestResult.html as string)\n : renderLeafDocsHTML(finalLeaves, {\n cspNonce: nonce,\n assetBasePath: `${prefix}${assetsMountPath}`,\n docsBasePath: `${prefix}${normalizedDocsPath}`,\n baseUrlSuffix: prefix,\n historySeeds: historySeedsForUi,\n logSeeds: seededLogs,\n presets: normalizePresets(finalPresets),\n webhooks: {\n history: `${prefix}${webhookPaths.history}`,\n logs: `${prefix}${webhookPaths.logs}`,\n },\n });\n\n applyDocsSecurityHeaders(res);\n if (cspEnabled && nonce) {\n res.setHeader(\n 'Content-Security-Policy',\n [\n \"default-src 'self'\",\n `script-src 'self' 'nonce-${nonce}'`,\n `style-src 'self' 'nonce-${nonce}'`,\n \"img-src 'self' data:\",\n \"connect-src 'self'\",\n \"font-src 'self'\",\n \"frame-ancestors 'self'\",\n ].join('; '),\n );\n }\n\n res.send(html);\n });\n\n return { path: docsPath, webhooks: webhookPaths, webhookLeaves, webhookSchemas };\n}\n\nfunction resolvePublicDir() {\n const moduleDir =\n typeof __dirname !== 'undefined'\n ? __dirname\n : path.dirname(fileURLToPath(import.meta.url));\n const fromModule = path.resolve(moduleDir, '../public');\n if (fs.existsSync(fromModule)) return fromModule;\n\n // When running from source (ts-node), fall back to the built output path.\n const fallback = path.resolve(moduleDir, '../dist/public');\n if (fs.existsSync(fallback)) return fallback;\n\n return fromModule; // fallback; express static will 404 if missing\n}\n\nfunction normalizePresets(presets: PresetGroup<AnyLeaf>[]): SerializablePreset[] {\n if (!Array.isArray(presets)) return [];\n return presets.map((preset) => ({\n name: preset.name,\n description: preset.description,\n tags: Array.isArray(preset.tags) ? preset.tags.slice() : [],\n docsGroup: preset.docsGroup,\n ops: Array.isArray(preset.ops)\n ? preset.ops.map((op) => ({\n method: typeof op.method === 'string' ? op.method.toUpperCase() : '',\n path: typeof op.path === 'string' ? op.path : '',\n body: op.body,\n query: op.query,\n params: op.params,\n }))\n : [],\n }));\n}\n\nfunction parseHistoryWebhookQuery(req: Request): HistoryFeedQuery {\n const query = req.query || {};\n const methods = parseStringList(query.methods);\n const path = typeof query.path === 'string' ? query.path : undefined;\n const status = typeof query.status === 'string' ? query.status : undefined;\n const text = typeof query.text === 'string' ? query.text : undefined;\n const cursor = typeof query.cursor === 'string' ? query.cursor : undefined;\n const sortBy = isSortKey(query.sortBy) ? (query.sortBy as HistoryFeedQuery['sortBy']) : undefined;\n const sortDir = isSortDir(query.sortDir) ? (query.sortDir as HistoryFeedQuery['sortDir']) : undefined;\n const limit = parseLimit(query.limit);\n const from = parseDateInput(query.from);\n const to = parseDateInput(query.to);\n\n return {\n cursor,\n methods,\n path,\n status,\n text,\n limit,\n from,\n to,\n sortBy,\n sortDir,\n };\n}\n\nfunction parseLogWebhookQuery(req: Request): LogFeedQuery {\n const query = req.query || {};\n const types = parseStringList(query.types) as LogFeedQuery['types'];\n const tags = parseStringList(query.tags);\n const requestId = typeof query.requestId === 'string' ? query.requestId : undefined;\n const text = typeof query.text === 'string' ? query.text : undefined;\n const cursor = typeof query.cursor === 'string' ? query.cursor : undefined;\n const limit = parseLimit(query.limit);\n const from = parseDateInput(query.from);\n const to = parseDateInput(query.to);\n const sortDir = isSortDir(query.sortDir) ? (query.sortDir as LogFeedQuery['sortDir']) : undefined;\n\n return {\n cursor,\n types,\n tags,\n requestId,\n text,\n limit,\n from,\n to,\n sortDir,\n };\n}\n\nfunction parseStringList(value: unknown) {\n if (typeof value !== 'string') return undefined;\n const parts = value\n .split(',')\n .map((p) => p.trim())\n .filter(Boolean);\n return parts.length ? parts : undefined;\n}\n\nfunction parseLimit(value: unknown) {\n if (value === undefined) return undefined;\n const num = Number(value);\n if (!Number.isFinite(num) || num <= 0) return undefined;\n return num;\n}\n\nfunction parseDateInput(value: unknown) {\n if (typeof value !== 'string') return undefined;\n const numeric = Number(value);\n if (Number.isFinite(numeric)) return numeric;\n const timestamp = Date.parse(value);\n if (Number.isNaN(timestamp)) return undefined;\n return timestamp;\n}\n\nfunction isSortKey(value: unknown) {\n return value === 'timestamp' || value === 'path' || value === 'duration';\n}\n\nfunction isSortDir(value: unknown) {\n return value === 'asc' || value === 'desc';\n}\n\nfunction normalizeWebhookPage<T>(page: WebhookPage<T> | null | undefined): WebhookPage<T> {\n if (!page || typeof page !== 'object') return { items: [] };\n return {\n items: Array.isArray(page.items) ? page.items : [],\n nextCursor: page.nextCursor,\n prevCursor: page.prevCursor,\n total: page.total,\n };\n}\n\nfunction applyHistoryQuery(\n items: HistoryFeedEntry[],\n query: HistoryFeedQuery,\n hardLimit: number,\n): WebhookPage<HistoryFeedEntry> {\n const fromTs = typeof query.from === 'number' ? query.from : undefined;\n const toTs = typeof query.to === 'number' ? query.to : undefined;\n const methods = query.methods ? new Set(query.methods.map((m) => m.toUpperCase())) : undefined;\n const pathNeedle = (query.path || '').toLowerCase();\n const textNeedle = (query.text || '').toLowerCase();\n const statusNeedle = (query.status || '').trim();\n const filtered = (Array.isArray(items) ? items : []).filter((entry) => {\n if (methods?.size && !methods.has(String(entry.method || '').toUpperCase())) return false;\n if (pathNeedle && !String(entry.path || '').toLowerCase().includes(pathNeedle)) return false;\n if (statusNeedle) {\n const statusStr =\n entry.status !== undefined && entry.status !== null ? String(entry.status) : 'ERR';\n if (!statusStr.startsWith(statusNeedle)) return false;\n }\n if (Number.isFinite(fromTs) && entry.timestamp < (fromTs as number)) return false;\n if (Number.isFinite(toTs) && entry.timestamp > (toTs as number)) return false;\n if (textNeedle) {\n const haystack = [\n entry.path,\n entry.fullUrl,\n entry.body,\n entry.output,\n entry.error,\n JSON.stringify(entry.params || {}),\n JSON.stringify(entry.query || {}),\n ]\n .filter(Boolean)\n .join(' ')\n .toLowerCase();\n if (!haystack.includes(textNeedle)) return false;\n }\n return true;\n });\n\n const sortBy = query.sortBy || 'timestamp';\n const direction = query.sortDir === 'asc' ? 1 : -1;\n const sorted = filtered.slice().sort((a, b) => {\n let delta = 0;\n if (sortBy === 'path') {\n delta = String(a.path || '').localeCompare(String(b.path || ''));\n } else if (sortBy === 'duration') {\n delta = (a.durationMs || 0) - (b.durationMs || 0);\n } else {\n delta = (a.timestamp || 0) - (b.timestamp || 0);\n }\n return delta * direction;\n });\n\n return paginateItems(sorted, query.cursor, query.limit, hardLimit, 25);\n}\n\nfunction applyLogsQuery(\n items: LogFeedEntry[],\n query: LogFeedQuery,\n hardLimit: number,\n): WebhookPage<LogFeedEntry> {\n const fromTs = typeof query.from === 'number' ? query.from : undefined;\n const toTs = typeof query.to === 'number' ? query.to : undefined;\n const textNeedle = (query.text || '').toLowerCase();\n const requestIdNeedle = (query.requestId || '').toLowerCase();\n const types = query.types ? new Set(query.types) : undefined;\n const tags = query.tags ? new Set(query.tags) : undefined;\n const filtered = (Array.isArray(items) ? items : []).filter((entry) => {\n if (types?.size && !types.has(entry.type)) return false;\n const entryTags = Array.isArray(entry.tags) ? entry.tags : [];\n if (tags?.size && !entryTags.some((tag) => tags.has(tag))) return false;\n if (requestIdNeedle && !(entry.requestId || '').toLowerCase().includes(requestIdNeedle))\n return false;\n if (Number.isFinite(fromTs) && entry.timestamp < (fromTs as number)) return false;\n if (Number.isFinite(toTs) && entry.timestamp > (toTs as number)) return false;\n if (textNeedle) {\n const haystack = [\n entry.message,\n entry.requestId,\n entryTags.join(' '),\n typeof entry.metadata === 'string' ? entry.metadata : JSON.stringify(entry.metadata || ''),\n ]\n .filter(Boolean)\n .join(' ')\n .toLowerCase();\n if (!haystack.includes(textNeedle)) return false;\n }\n return true;\n });\n\n const direction = query.sortDir === 'asc' ? 1 : -1;\n const sorted = filtered.slice().sort((a, b) => (a.timestamp - b.timestamp) * direction);\n\n return paginateItems(sorted, query.cursor, query.limit, hardLimit, 50);\n}\n\nfunction paginateItems<T>(\n items: T[],\n cursor: string | undefined,\n limit: number | undefined,\n hardLimit: number,\n fallbackLimit: number,\n): WebhookPage<T> {\n const safeLimit = clampLimit(limit, hardLimit, fallbackLimit);\n const start = parseCursor(cursor);\n const end = start + safeLimit;\n const slice = items.slice(start, end);\n const nextCursor = end < items.length ? String(end) : undefined;\n const prevCursor = start > 0 ? String(Math.max(start - safeLimit, 0)) : undefined;\n return {\n items: slice,\n nextCursor,\n prevCursor,\n total: items.length,\n };\n}\n\nfunction clampLimit(value: number | undefined, hardLimit: number, fallback: number) {\n if (!Number.isFinite(value)) return Math.min(hardLimit, fallback);\n const safe = Math.max(1, Math.min(hardLimit, value as number));\n return safe;\n}\n\nfunction parseCursor(cursor: string | undefined | null) {\n const num = Number(cursor);\n if (Number.isFinite(num) && num >= 0) return Math.floor(num);\n return 0;\n}\n\nfunction normalizeHistorySeeds(\n seeds: SerializableHistoryEntry[] | undefined,\n hardLimit: number,\n): HistoryFeedEntry[] {\n if (!Array.isArray(seeds)) return [];\n return seeds\n .slice(0, hardLimit)\n .map((entry, idx) => ({\n id: entry.id || randomBytes(8).toString('hex'),\n requestId: typeof (entry as any).requestId === 'string' ? (entry as any).requestId : undefined,\n timestamp: entry.timestamp ?? Date.now() - idx * 1000,\n method: entry.method || 'GET',\n path: entry.path || '/',\n fullUrl: entry.fullUrl || entry.path || '/',\n params: entry.params || {},\n query: entry.query || {},\n body: entry.body || '',\n output: entry.output || '',\n status: entry.status,\n durationMs: entry.durationMs ?? 0,\n error: entry.error,\n }))\n .filter((entry) => entry.method && entry.path);\n}\n\nfunction normalizeLogSeeds(\n seeds: LogFeedEntry[] | undefined,\n hardLimit: number,\n redactor: ReturnType<typeof createLogRedactor>,\n): LogFeedEntry[] {\n if (!Array.isArray(seeds)) return [];\n const normalized = seeds\n .slice(0, hardLimit)\n .map((entry, idx) => ({\n id: entry.id || randomBytes(8).toString('hex'),\n type: entry.type || 'info',\n message: entry.message || '',\n timestamp: entry.timestamp ?? Date.now() - idx * 1000,\n requestId: entry.requestId,\n tags: Array.isArray(entry.tags) ? entry.tags : [],\n metadata: entry.metadata,\n }))\n .filter((entry) => entry.message);\n\n return applyLogRedaction(normalized, redactor);\n}\n\nfunction coerceQueryRecord(query: Request['query']): Record<string, string> {\n if (!query || typeof query !== 'object') return {};\n return Object.fromEntries(\n Object.entries(query).map(([key, value]) => [key, coerceValue(value)]),\n );\n}\n\nfunction coercePayload(body: unknown): string {\n if (body === undefined || body === null) return '';\n if (typeof body === 'string') return body;\n try {\n return JSON.stringify(body);\n } catch {\n return String(body);\n }\n}\n\nfunction coerceValue(value: unknown): string {\n if (value === undefined || value === null) return '';\n if (Array.isArray(value)) return value.map(coerceValue).join(',');\n if (typeof value === 'object') {\n try {\n return JSON.stringify(value);\n } catch {\n return String(value);\n }\n }\n return String(value);\n}\n\nfunction createLogRedactor(redactor?: LogRedactor) {\n if (!redactor) return (entry: LogFeedEntry) => entry;\n return (entry: LogFeedEntry) => {\n try {\n return redactor(entry) ?? null;\n } catch (err) {\n console.error('Log redaction failed – dropping log entry', err);\n return null;\n }\n };\n}\n\nfunction applyLogRedaction(\n entries: LogFeedEntry[] | undefined,\n redactor: ReturnType<typeof createLogRedactor>,\n): LogFeedEntry[] {\n if (!Array.isArray(entries)) return [];\n const next: LogFeedEntry[] = [];\n for (const entry of entries) {\n const redacted = redactor(entry);\n if (redacted) next.push(redacted);\n }\n return next;\n}\n\nfunction resolveDocsPassword(auth?: DocsAuthOptions) {\n if (auth?.password) return auth.password;\n return undefined;\n}\n\nfunction createPasswordGuard(password: string, realm: string) {\n const trimmed = password.trim();\n return (req: Request, res: Response, next: () => void) => {\n const provided = extractPassword(req.headers.authorization);\n if (provided && provided === trimmed) {\n return next();\n }\n applyDocsSecurityHeaders(res);\n res.setHeader('WWW-Authenticate', `Basic realm=\"${realm}\"`);\n res.status(401).send(renderAuthErrorPage('Docs are password protected. Provide the configured password.'));\n };\n}\n\nfunction createMissingPasswordGuard() {\n return (_req: Request, res: Response) => {\n applyDocsSecurityHeaders(res);\n res\n .status(500)\n .send(renderAuthErrorPage('Provide password to mounted docs'));\n };\n}\n\nfunction extractPassword(authHeader: string | string[] | undefined) {\n if (!authHeader) return undefined;\n const header = Array.isArray(authHeader) ? authHeader[0] : authHeader;\n if (typeof header !== 'string' || !header.startsWith('Basic ')) return undefined;\n const token = header.slice('Basic '.length);\n try {\n const decoded = Buffer.from(token, 'base64').toString('utf8');\n const parts = decoded.split(':');\n parts.shift(); // username\n return parts.join(':');\n } catch {\n return undefined;\n }\n}\n\nfunction renderAuthErrorPage(message: string) {\n return `<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n <meta charset=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>RRRoutes docs locked</title>\n <style>\n body { margin:0; font-family: system-ui, -apple-system, Segoe UI, sans-serif; background: #0f172a; color: #e2e8f0; display:flex; align-items:center; justify-content:center; min-height:100vh; }\n .card { padding:32px; border:1px solid #1e293b; border-radius:12px; max-width:420px; background: rgba(15,23,42,0.8); box-shadow:0 15px 45px rgba(0,0,0,0.35); }\n h1 { margin:0 0 12px; font-size:22px; }\n p { margin:0; line-height:1.5; color:#cbd5e1; }\n code { background: rgba(226,232,240,0.1); padding: 2px 4px; border-radius: 4px; }\n </style>\n</head>\n<body>\n <div class=\"card\">\n <h1>Docs locked</h1>\n <p>${message}</p>\n </div>\n</body>\n</html>`;\n}\n\nfunction applyDocsSecurityHeaders(res: Response) {\n res.setHeader('X-Content-Type-Options', 'nosniff');\n res.setHeader('Referrer-Policy', 'same-origin');\n res.setHeader('X-Frame-Options', 'SAMEORIGIN');\n res.setHeader('Cache-Control', 'no-store');\n}\n\nexport { renderLeafDocsHTML } from './docs/docs.js';\nexport { serializeLeaf } from './docs/serializer.js';\nexport type { SerializableLeaf } from './docs/serializer.js';\nexport type {\n HistoryFeedEntry, historyFeedEntrySchema, HistoryFeedQuery, historyFeedQuerySchema,\n historyWebhookResponseSchema, LogFeedEntry, logFeedEntrySchema, LogFeedQuery, logFeedQuerySchema, LogType, logTypeSchema, logWebhookResponseSchema, WebhookPage, webhookPageSchema, WebhookPaths\n} from './webhooks.js';\n","import type { AnyLeaf } from '@emeryld/rrroutes-contract';\nimport type { ReactElement } from 'react';\nimport { renderToStaticMarkup } from 'react-dom/server';\nimport type { SerializablePreset } from './presets.js';\nimport { serializeLeaf } from './serializer.js';\nimport type { WebhookPaths } from '../webhooks.js';\nimport type { LogFeedEntry } from '../webhooks.js';\n\nexport interface RenderOptions {\n /** CSP nonce applied to data + script tags. */\n cspNonce?: string;\n /** Base URL where static assets are served (e.g. `/__rrroutes/docs/assets`). */\n assetBasePath?: string;\n /** Root path where the docs are mounted (e.g. `/__rrroutes/docs`). Used for client routing. */\n docsBasePath?: string;\n /** Optional suffix appended to the window origin when building default playground base URLs. */\n baseUrlSuffix?: string;\n /** Preset collections rendered into the docs UI. */\n presets?: SerializablePreset[];\n /** Optional seed history entries to pre-populate the UI (useful in dev). */\n historySeeds?: SerializableHistoryEntry[];\n /** Optional seed log entries to pre-populate the logs UI. */\n logSeeds?: LogFeedEntry[];\n /** Paths for webhook-backed history/log feeds. */\n webhooks?: WebhookPaths;\n}\n\nconst DEFAULT_ASSET_BASE = '/__rrroutes/docs/assets';\n\nfunction normalizeBase(base: string) {\n if (!base) return DEFAULT_ASSET_BASE;\n return base.endsWith('/') ? base.slice(0, -1) : base;\n}\n\nfunction normalizeDocsBase(base: string | undefined) {\n if (!base) return '';\n if (base === '/') return '/';\n return base.endsWith('/') && base.length > 1 ? base.slice(0, -1) : base;\n}\n\nfunction normalizeBaseUrlSuffix(suffix: string | undefined) {\n if (!suffix) return '';\n const trimmed = suffix.endsWith('/') && suffix.length > 1 ? suffix.slice(0, -1) : suffix;\n return trimmed.startsWith('/') ? trimmed : `/${trimmed}`;\n}\n\ntype DocsDocumentProps = {\n leavesJson: string;\n presetsJson: string;\n assetBase: string;\n docsBase: string;\n historyJson: string;\n logsJson: string;\n baseUrlSuffix?: string;\n webhooks?: WebhookPaths;\n cspNonce?: string;\n};\n\nexport const DocsDocument = ({\n leavesJson,\n presetsJson,\n assetBase,\n docsBase,\n historyJson,\n logsJson,\n baseUrlSuffix,\n webhooks,\n cspNonce,\n}: DocsDocumentProps) => {\n const cssHref = `${assetBase}/docs.css`;\n const jsSrc = `${assetBase}/docs.js`;\n const configJson = serializeConfig({ docsBasePath: docsBase, baseUrlSuffix, webhooks });\n\n return (\n <html lang=\"en\">\n <head>\n <meta charSet=\"UTF-8\" />\n <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\" />\n <title>API Reference</title>\n <link rel=\"stylesheet\" href={cssHref} />\n </head>\n <body>\n <div id=\"docs-root\"></div>\n <script\n id=\"leaf-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: leavesJson }}\n />\n <script\n id=\"preset-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: presetsJson }}\n />\n <script\n id=\"history-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: historyJson }}\n />\n <script\n id=\"logs-data\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: logsJson }}\n />\n <script\n id=\"docs-config\"\n type=\"application/json\"\n nonce={cspNonce}\n dangerouslySetInnerHTML={{ __html: configJson }}\n />\n <script type=\"module\" src={jsSrc} nonce={cspNonce} />\n </body>\n </html>\n );\n};\n\nfunction serializeLeaves(leaves: AnyLeaf[]) {\n return JSON.stringify(leaves.map(serializeLeaf)).replace(/<\\//g, '<\\\\/');\n}\n\nfunction serializePresets(presets: SerializablePreset[] | undefined) {\n return JSON.stringify(Array.isArray(presets) ? presets : []).replace(/<\\//g, '<\\\\/');\n}\n\nfunction serializeHistorySeeds(historySeeds: SerializableHistoryEntry[] | undefined) {\n return JSON.stringify(Array.isArray(historySeeds) ? historySeeds : []).replace(/<\\//g, '<\\\\/');\n}\n\nfunction serializeLogSeeds(logSeeds: LogFeedEntry[] | undefined) {\n return JSON.stringify(Array.isArray(logSeeds) ? logSeeds : []).replace(/<\\//g, '<\\\\/');\n}\n\ntype DocsConfig = { docsBasePath: string; baseUrlSuffix?: string; webhooks?: WebhookPaths };\n\nfunction serializeConfig(config: DocsConfig) {\n return JSON.stringify(config).replace(/<\\//g, '<\\\\/');\n}\n\nexport function createLeafDocsDocument(\n leaves: AnyLeaf[],\n options: RenderOptions = {},\n): ReactElement {\n const assetBase = normalizeBase(options.assetBasePath ?? DEFAULT_ASSET_BASE);\n const leavesJson = serializeLeaves(leaves);\n const presetsJson = serializePresets(options.presets);\n const docsBase = normalizeDocsBase(options.docsBasePath);\n const historyJson = serializeHistorySeeds(options.historySeeds);\n const logsJson = serializeLogSeeds(options.logSeeds);\n const baseUrlSuffix = normalizeBaseUrlSuffix(options.baseUrlSuffix);\n const webhooks = options.webhooks;\n\n return (\n <DocsDocument\n leavesJson={leavesJson}\n presetsJson={presetsJson}\n assetBase={assetBase}\n docsBase={docsBase}\n historyJson={historyJson}\n logsJson={logsJson}\n baseUrlSuffix={baseUrlSuffix}\n webhooks={webhooks}\n cspNonce={options.cspNonce}\n />\n );\n}\n\nexport function renderLeafDocsHTML(leaves: AnyLeaf[], options: RenderOptions = {}): string {\n const doc = createLeafDocsDocument(leaves, options);\n const html = renderToStaticMarkup(doc);\n return `<!DOCTYPE html>${html}`;\n}\n\nexport type SerializableHistoryEntry = {\n id?: string;\n timestamp: number;\n method: string;\n path: string;\n fullUrl: string;\n params?: Record<string, string>;\n query?: Record<string, string>;\n body?: string;\n output?: string;\n status?: number;\n durationMs: number;\n error?: string;\n};\n","// schemaIntrospection.ts\nimport * as z from \"zod\";\n\nexport type SerializableSchemaNode = {\n kind: string; // \"object\" | \"string\" | \"number\" | ...\n optional?: boolean;\n nullable?: boolean;\n description?: string;\n\n // object\n properties?: Record<string, SerializableSchemaNode>;\n // array\n element?: SerializableSchemaNode;\n // union\n union?: SerializableSchemaNode[];\n // literal\n literal?: unknown;\n // enum\n enumValues?: string[];\n};\n\ntype ZodAny = z.ZodTypeAny;\n\n/**\n * Zod 3 uses `schema._def`, Zod 4 uses `schema._zod.def`.\n */\nfunction getDef(schema: unknown): any | undefined {\n if (!schema || typeof schema !== \"object\") return undefined;\n const anySchema = schema as any;\n return anySchema._zod?.def ?? anySchema._def;\n}\n\n/**\n * Try to get a human-readable description.\n * Zod 4: use metadata/registry; fallback to internal def.description.\n * Zod 3: only internal def.description exists.\n */\nfunction getDescription(schema: ZodAny): string | undefined {\n const anyZ: any = z as any;\n\n // Zod 4 global registry metadata, if present\n const registry = anyZ.globalRegistry?.get\n ? anyZ.globalRegistry.get(schema)\n : undefined;\n if (registry && typeof registry.description === \"string\") {\n return registry.description;\n }\n\n // Legacy / internal description\n const def = getDef(schema);\n if (def && typeof def.description === \"string\") {\n return def.description;\n }\n\n return undefined;\n}\n\n/**\n * Peel off wrappers (effects, optional, nullable, default) and\n * return the inner schema + flags.\n *\n * Supports:\n * - Zod 3: ZodEffects, ZodOptional, ZodNullable, ZodDefault\n * - Zod 4: ZodOptional, ZodNullable, ZodDefault\n */\nfunction unwrap(schema: ZodAny): {\n base: ZodAny;\n optional: boolean;\n nullable: boolean;\n} {\n let s: ZodAny = schema;\n let optional = false;\n let nullable = false;\n\n // Zod 3 only (undefined in Zod 4)\n const ZodEffectsCtor: any = (z as any).ZodEffects;\n\n // eslint-disable-next-line no-constant-condition\n while (true) {\n // Zod 3: ZodEffects wrapper\n if (ZodEffectsCtor && s instanceof ZodEffectsCtor) {\n const def = getDef(s) || {};\n const sourceType =\n typeof (s as any).sourceType === \"function\"\n ? (s as any).sourceType()\n : def.schema;\n if (!sourceType) break;\n s = sourceType;\n continue;\n }\n\n // Zod 3 + 4: optional/nullable/default wrappers\n if (s instanceof z.ZodOptional) {\n optional = true;\n const def = getDef(s);\n s = (def && def.innerType) || s; // innerType exists in both 3 & 4\n continue;\n }\n\n if (s instanceof z.ZodNullable) {\n nullable = true;\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n if (s instanceof z.ZodDefault) {\n const def = getDef(s);\n s = (def && def.innerType) || s;\n continue;\n }\n\n break;\n }\n\n return { base: s, optional, nullable };\n}\n\nexport function introspectSchema(\n schema: ZodAny | undefined\n): SerializableSchemaNode | undefined {\n if (!schema) return undefined;\n\n const { base, optional, nullable } = unwrap(schema);\n const def = getDef(base);\n\n const node: SerializableSchemaNode = {\n kind: inferKind(base),\n optional: optional || undefined,\n nullable: nullable || undefined,\n description: getDescription(base),\n };\n\n // OBJECT\n if (base instanceof z.ZodObject) {\n // Zod 3: _def.shape() (function)\n // Zod 4: .shape getter returns an object\n const rawShape: any =\n (base as any).shape ?? (def && typeof def.shape === \"function\"\n ? def.shape()\n : def?.shape);\n\n const shape =\n typeof rawShape === \"function\" ? rawShape() : rawShape ?? {};\n\n const props: Record<string, SerializableSchemaNode> = {};\n for (const key of Object.keys(shape)) {\n const child = shape[key] as ZodAny;\n const childNode = introspectSchema(child);\n if (childNode) props[key] = childNode;\n }\n node.properties = props;\n }\n\n // ARRAY\n if (base instanceof z.ZodArray) {\n // Zod 3: def.type is inner schema\n // Zod 4: def.element is inner schema\n const inner =\n (def && (def.element as ZodAny)) ||\n (def && (def.type as ZodAny)) ||\n undefined;\n if (inner) {\n node.element = introspectSchema(inner);\n }\n }\n\n // UNION\n if (base instanceof z.ZodUnion) {\n const options: ZodAny[] = (def && def.options) || [];\n node.union = options\n .map((opt) => introspectSchema(opt))\n .filter(Boolean) as SerializableSchemaNode[];\n }\n\n // LITERAL\n if (base instanceof z.ZodLiteral) {\n if (def) {\n // Zod 4: def.values (multi-literal)\n if (Array.isArray(def.values)) {\n node.literal =\n def.values.length === 1 ? def.values[0] : def.values.slice();\n } else {\n // Zod 3: def.value\n node.literal = def.value;\n }\n }\n }\n\n // ENUM\n if (base instanceof z.ZodEnum) {\n if (def) {\n if (Array.isArray(def.values)) {\n // Zod 3\n node.enumValues = def.values.slice();\n } else if (def.entries && typeof def.entries === \"object\") {\n // Zod 4: entries is a { key: value } map\n node.enumValues = Object.values(def.entries).map((v: unknown) =>\n String(v)\n );\n }\n }\n }\n\n return node;\n}\n\nfunction inferKind(schema: ZodAny): string {\n // This path still uses instanceof; it works with Zod 4 Classic\n // (importing from \"zod\"). Anything unknown falls back to \"unknown\".\n if (schema instanceof z.ZodString) return \"string\";\n if (schema instanceof z.ZodNumber) return \"number\";\n if (schema instanceof z.ZodBoolean) return \"boolean\";\n if (schema instanceof z.ZodBigInt) return \"bigint\";\n if (schema instanceof z.ZodDate) return \"date\";\n if (schema instanceof z.ZodArray) return \"array\";\n if (schema instanceof z.ZodObject) return \"object\";\n if (schema instanceof z.ZodUnion) return \"union\";\n if (schema instanceof z.ZodLiteral) return \"literal\";\n if (schema instanceof z.ZodEnum) return \"enum\";\n if (schema instanceof z.ZodRecord) return \"record\";\n if (schema instanceof z.ZodTuple) return \"tuple\";\n if (schema instanceof z.ZodUnknown) return \"unknown\";\n if (schema instanceof z.ZodAny) return \"any\";\n\n return \"unknown\";\n}\n","// serializer.ts\nimport type { AnyLeaf, MethodCfg } from \"@emeryld/rrroutes-contract\";\nimport { introspectSchema, SerializableSchemaNode } from \"./schemaIntrospection.js\";\n\ntype SerializableMethodCfg = Pick<\n MethodCfg,\n | \"description\"\n | \"summary\"\n | \"docsGroup\"\n | \"tags\"\n | \"deprecated\"\n | \"stability\"\n | \"feed\"\n | \"docsMeta\"\n> & {\n hasBody: boolean;\n hasQuery: boolean;\n hasParams: boolean;\n hasOutput: boolean;\n\n // NEW: full Zod ASTs\n bodySchema?: SerializableSchemaNode;\n querySchema?: SerializableSchemaNode;\n paramsSchema?: SerializableSchemaNode;\n outputSchema?: SerializableSchemaNode;\n};\n\nexport type SerializableLeaf = {\n method: string;\n path: string;\n cfg: SerializableMethodCfg;\n};\n\nexport type { SerializableSchemaNode } from \"./schemaIntrospection.js\";\n\nexport function serializeLeaf(leaf: AnyLeaf): SerializableLeaf {\n const cfg = leaf.cfg;\n\n const tags = Array.isArray(cfg.tags) ? cfg.tags.slice() : [];\n\n return {\n method: leaf.method, // 'get' | 'post' | ...\n path: leaf.path,\n cfg: {\n description: cfg.description,\n summary: cfg.summary,\n docsGroup: cfg.docsGroup,\n tags,\n deprecated: cfg.deprecated,\n stability: cfg.stability,\n feed: !!cfg.feed,\n docsMeta: cfg.docsMeta,\n hasBody: !!cfg.bodySchema || !!cfg.bodyFiles?.length,\n hasQuery: !!cfg.querySchema,\n hasParams: !!cfg.paramsSchema,\n hasOutput: !!cfg.outputSchema,\n\n bodySchema: introspectSchema(cfg.bodySchema),\n querySchema: introspectSchema(cfg.querySchema),\n paramsSchema: introspectSchema(cfg.paramsSchema),\n outputSchema: introspectSchema(cfg.outputSchema),\n },\n };\n}\n","// renderLeafDocsHTML.ts\nimport type { AnyLeaf } from \"@emeryld/rrroutes-contract\";\nimport {\n createLeafDocsDocument,\n renderLeafDocsHTML as LeafDocsPage,\n RenderOptions,\n} from \"./LeafDocsPage.js\";\n\nexport function renderLeafDocsHTML(leaves: AnyLeaf[], options: RenderOptions = {}): string {\n return LeafDocsPage(leaves, options);\n}\n\nexport type { RenderOptions, SerializableHistoryEntry } from \"./LeafDocsPage.js\";\nexport { createLeafDocsDocument } from \"./LeafDocsPage.js\";\nexport type { SerializablePreset, SerializablePresetOperation } from \"./presets.js\";\nexport type { LogFeedEntry } from \"../webhooks.js\";\n","import { z } from 'zod';\n\nexport type WebhookPage<T> = {\n items: T[];\n nextCursor?: string;\n prevCursor?: string;\n total?: number;\n};\n\nexport type WebhookPaths = {\n history: string;\n logs: string;\n};\n\nexport type HistoryFeedEntry = {\n id: string;\n requestId?: string;\n timestamp: number;\n method: string;\n path: string;\n fullUrl?: string;\n params?: Record<string, string>;\n query?: Record<string, string>;\n body?: string;\n output?: string;\n status?: number;\n durationMs: number;\n error?: string;\n};\n\nexport type HistoryFeedQuery = {\n cursor?: string;\n limit?: number;\n methods?: string[];\n path?: string;\n status?: string;\n from?: number;\n to?: number;\n text?: string;\n sortBy?: 'timestamp' | 'path' | 'duration';\n sortDir?: 'asc' | 'desc';\n};\n\nexport type LogType = 'debug' | 'info' | 'warn' | 'error' | 'system';\n\nexport type LogFeedEntry = {\n id: string;\n type: LogType;\n message: string;\n timestamp: number;\n requestId?: string;\n tags?: string[];\n metadata?: string;\n};\n\nexport type LogFeedQuery = {\n cursor?: string;\n limit?: number;\n types?: LogType[];\n tags?: string[];\n requestId?: string;\n text?: string;\n from?: number;\n to?: number;\n sortDir?: 'asc' | 'desc';\n};\n\nexport const logTypeSchema = z.enum(['debug', 'info', 'warn', 'error', 'system']);\n\nexport const historyFeedEntrySchema = z.object({\n id: z.string(),\n requestId: z.string().optional(),\n timestamp: z.number(),\n method: z.string(),\n path: z.string(),\n fullUrl: z.string().optional(),\n params: z.record(z.string(),z.string()).optional(),\n query: z.record(z.string(),z.string()).optional(),\n body: z.string().optional(),\n output: z.string().optional(),\n status: z.number().optional(),\n durationMs: z.number(),\n error: z.string().optional(),\n});\n\nexport const logFeedEntrySchema = z.object({\n id: z.string(),\n type: logTypeSchema,\n message: z.string(),\n timestamp: z.number(),\n requestId: z.string().optional(),\n tags: z.array(z.string()).optional(),\n metadata: z.string().optional(),\n});\n\nexport const historyFeedQuerySchema = z.object({\n cursor: z.string().optional(),\n limit: z.number().int().positive().optional(),\n methods: z.array(z.string()).optional(),\n path: z.string().optional(),\n status: z.string().optional(),\n text: z.string().optional(),\n from: z.number().optional(),\n to: z.number().optional(),\n sortBy: z.enum(['timestamp', 'path', 'duration']).optional(),\n sortDir: z.enum(['asc', 'desc']).optional(),\n});\n\nexport const logFeedQuerySchema = z.object({\n cursor: z.string().optional(),\n limit: z.number().int().positive().optional(),\n types: z.array(logTypeSchema).optional(),\n tags: z.array(z.string()).optional(),\n requestId: z.string().optional(),\n text: z.string().optional(),\n from: z.number().optional(),\n to: z.number().optional(),\n sortDir: z.enum(['asc', 'desc']).optional(),\n});\n\nexport const webhookPageSchema = <T extends z.ZodTypeAny>(itemSchema: T) =>\n z.object({\n items: z.array(itemSchema).default([]),\n nextCursor: z.string().optional(),\n prevCursor: z.string().optional(),\n total: z.number().optional(),\n });\n\nexport const historyWebhookResponseSchema = webhookPageSchema(historyFeedEntrySchema);\nexport const logWebhookResponseSchema = webhookPageSchema(logFeedEntrySchema);\n"],"mappings":"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","names":["renderLeafDocsHTML","renderLeafDocsHTML","path","expressStatic","filtered","renderLeafDocsHTML","fs"]}
package/dist/index.d.ts CHANGED
@@ -22,6 +22,15 @@ export type DocsOnRequestResult = {
22
22
  nonce?: string;
23
23
  html?: string;
24
24
  };
25
+ export type DocsAuthOptions = {
26
+ /** Turn auth on/off. Enabled by default. */
27
+ enabled?: boolean;
28
+ /** Password to require for docs access. Falls back to the env var when omitted. */
29
+ password?: string;
30
+ /** Realm used for the HTTP Basic challenge prompt. */
31
+ realm?: string;
32
+ };
33
+ export type LogRedactor = (entry: LogFeedEntry) => LogFeedEntry | null | undefined;
25
34
  export type OpenApiDocsOptions = {
26
35
  /** Path where docs are mounted. Defaults to `/__rrroutes/docs`. */
27
36
  path?: string;
@@ -36,6 +45,13 @@ export type OpenApiDocsOptions = {
36
45
  logSeeds?: LogFeedEntry[];
37
46
  /** Handlers + settings for webhook-driven history/log feeds. */
38
47
  logWebhook?: LogWebhookConfig;
48
+ /**
49
+ * Optional hook to redact or drop log entries before they are persisted or sent to the UI.
50
+ * Return `null`/`undefined` to skip an entry entirely.
51
+ */
52
+ redactLogEntry?: LogRedactor;
53
+ /** Password protection + realm configuration for the mounted docs. */
54
+ auth?: DocsAuthOptions;
39
55
  /**
40
56
  * Hook that runs on every request. Use it to adjust leaves, override nonce, or
41
57
  * provide a fully custom HTML response.