@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 +3 -0
- package/dist/index.cjs +119 -9
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.ts +16 -0
- package/dist/index.mjs +119 -9
- package/dist/index.mjs.map +1 -1
- package/dist/public/assets/docs.css +1 -1
- package/dist/public/assets/docs.js +18 -18
- package/dist/web/components/HelperEnumInput.d.ts +2 -1
- package/dist/web/components/PlaygroundOverlay.d.ts +68 -9
- package/dist/web/components/PresetsView.d.ts +6 -1
- package/package.json +1 -1
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
|
|
420
|
-
const
|
|
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
|
-
|
|
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 (
|
|
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
|
|
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:
|
|
575
|
-
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
|
-
|
|
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,
|
package/dist/index.cjs.map
CHANGED
|
@@ -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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA,4BAAAA;AAAA,EAAA;AAAA;AAAA;AASA,oBAA4B;AAE5B,qBAAwC;AACxC,qBAAe;AACf,uBAAiB;AACjB,sBAA8B;;;ACZ9B,oBAAqC;;;ACDrC,QAAmB;AAyBnB,SAAS,OAAO,QAAkC;AAChD,MAAI,CAAC,UAAU,OAAO,WAAW,SAAU,QAAO;AAClD,QAAM,YAAY;AAClB,SAAO,UAAU,MAAM,OAAO,UAAU;AAC1C;AAOA,SAAS,eAAe,QAAoC;AAC1D,QAAM,OAAY;AAGlB,QAAM,WAAW,KAAK,gBAAgB,MAClC,KAAK,eAAe,IAAI,MAAM,IAC9B;AACJ,MAAI,YAAY,OAAO,SAAS,gBAAgB,UAAU;AACxD,WAAO,SAAS;AAAA,EAClB;AAGA,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI,OAAO,OAAO,IAAI,gBAAgB,UAAU;AAC9C,WAAO,IAAI;AAAA,EACb;AAEA,SAAO;AACT;AAUA,SAAS,OAAO,QAId;AACA,MAAI,IAAY;AAChB,MAAI,WAAW;AACf,MAAI,WAAW;AAGf,QAAM,iBAAiC;AAGvC,SAAO,MAAM;AAEX,QAAI,kBAAkB,aAAa,gBAAgB;AACjD,YAAM,MAAM,OAAO,CAAC,KAAK,CAAC;AAC1B,YAAM,aACJ,OAAQ,EAAU,eAAe,aAC5B,EAAU,WAAW,IACtB,IAAI;AACV,UAAI,CAAC,WAAY;AACjB,UAAI;AACJ;AAAA,IACF;AAGA,QAAI,aAAe,eAAa;AAC9B,iBAAW;AACX,YAAM,MAAM,OAAO,CAAC;AACpB,UAAK,OAAO,IAAI,aAAc;AAC9B;AAAA,IACF;AAEA,QAAI,aAAe,eAAa;AAC9B,iBAAW;AACX,YAAM,MAAM,OAAO,CAAC;AACpB,UAAK,OAAO,IAAI,aAAc;AAC9B;AAAA,IACF;AAEA,QAAI,aAAe,cAAY;AAC7B,YAAM,MAAM,OAAO,CAAC;AACpB,UAAK,OAAO,IAAI,aAAc;AAC9B;AAAA,IACF;AAEA;AAAA,EACF;AAEA,SAAO,EAAE,MAAM,GAAG,UAAU,SAAS;AACvC;AAEO,SAAS,iBACd,QACoC;AACpC,MAAI,CAAC,OAAQ,QAAO;AAEpB,QAAM,EAAE,MAAM,UAAU,SAAS,IAAI,OAAO,MAAM;AAClD,QAAM,MAAM,OAAO,IAAI;AAEvB,QAAM,OAA+B;AAAA,IACnC,MAAM,UAAU,IAAI;AAAA,IACpB,UAAU,YAAY;AAAA,IACtB,UAAU,YAAY;AAAA,IACtB,aAAa,eAAe,IAAI;AAAA,EAClC;AAGA,MAAI,gBAAkB,aAAW;AAG/B,UAAM,WACH,KAAa,UAAU,OAAO,OAAO,IAAI,UAAU,aAChD,IAAI,MAAM,IACV,KAAK;AAEX,UAAM,QACJ,OAAO,aAAa,aAAa,SAAS,IAAI,YAAY,CAAC;AAE7D,UAAM,QAAgD,CAAC;AACvD,eAAW,OAAO,OAAO,KAAK,KAAK,GAAG;AACpC,YAAM,QAAQ,MAAM,GAAG;AACvB,YAAM,YAAY,iBAAiB,KAAK;AACxC,UAAI,UAAW,OAAM,GAAG,IAAI;AAAA,IAC9B;AACA,SAAK,aAAa;AAAA,EACpB;AAGA,MAAI,gBAAkB,YAAU;AAG9B,UAAM,QACH,OAAQ,IAAI,WACZ,OAAQ,IAAI,QACb;AACF,QAAI,OAAO;AACT,WAAK,UAAU,iBAAiB,KAAK;AAAA,IACvC;AAAA,EACF;AAGA,MAAI,gBAAkB,YAAU;AAC9B,UAAM,UAAqB,OAAO,IAAI,WAAY,CAAC;AACnD,SAAK,QAAQ,QACV,IAAI,CAAC,QAAQ,iBAAiB,GAAG,CAAC,EAClC,OAAO,OAAO;AAAA,EACnB;AAGA,MAAI,gBAAkB,cAAY;AAChC,QAAI,KAAK;AAEP,UAAI,MAAM,QAAQ,IAAI,MAAM,GAAG;AAC7B,aAAK,UACH,IAAI,OAAO,WAAW,IAAI,IAAI,OAAO,CAAC,IAAI,IAAI,OAAO,MAAM;AAAA,MAC/D,OAAO;AAEL,aAAK,UAAU,IAAI;AAAA,MACrB;AAAA,IACF;AAAA,EACF;AAGA,MAAI,gBAAkB,WAAS;AAC7B,QAAI,KAAK;AACP,UAAI,MAAM,QAAQ,IAAI,MAAM,GAAG;AAE7B,aAAK,aAAa,IAAI,OAAO,MAAM;AAAA,MACrC,WAAW,IAAI,WAAW,OAAO,IAAI,YAAY,UAAU;AAEzD,aAAK,aAAa,OAAO,OAAO,IAAI,OAAO,EAAE;AAAA,UAAI,CAAC,MAChD,OAAO,CAAC;AAAA,QACV;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAEA,SAAS,UAAU,QAAwB;AAGzC,MAAI,kBAAoB,YAAW,QAAO;AAC1C,MAAI,kBAAoB,YAAW,QAAO;AAC1C,MAAI,kBAAoB,aAAY,QAAO;AAC3C,MAAI,kBAAoB,YAAW,QAAO;AAC1C,MAAI,kBAAoB,UAAS,QAAO;AACxC,MAAI,kBAAoB,WAAU,QAAO;AACzC,MAAI,kBAAoB,YAAW,QAAO;AAC1C,MAAI,kBAAoB,WAAU,QAAO;AACzC,MAAI,kBAAoB,aAAY,QAAO;AAC3C,MAAI,kBAAoB,UAAS,QAAO;AACxC,MAAI,kBAAoB,YAAW,QAAO;AAC1C,MAAI,kBAAoB,WAAU,QAAO;AACzC,MAAI,kBAAoB,aAAY,QAAO;AAC3C,MAAI,kBAAoB,SAAQ,QAAO;AAEvC,SAAO;AACT;;;AC/LO,SAAS,cAAc,MAAiC;AAC7D,QAAM,MAAM,KAAK;AAEjB,QAAM,OAAO,MAAM,QAAQ,IAAI,IAAI,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC;AAE3D,SAAO;AAAA,IACL,QAAQ,KAAK;AAAA;AAAA,IACb,MAAM,KAAK;AAAA,IACX,KAAK;AAAA,MACH,aAAa,IAAI;AAAA,MACjB,SAAS,IAAI;AAAA,MACb,WAAW,IAAI;AAAA,MACf;AAAA,MACA,YAAY,IAAI;AAAA,MAChB,WAAW,IAAI;AAAA,MACf,MAAM,CAAC,CAAC,IAAI;AAAA,MACZ,UAAU,IAAI;AAAA,MACd,SAAS,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,IAAI,WAAW;AAAA,MAC9C,UAAU,CAAC,CAAC,IAAI;AAAA,MAChB,WAAW,CAAC,CAAC,IAAI;AAAA,MACjB,WAAW,CAAC,CAAC,IAAI;AAAA,MAEjB,YAAY,iBAAiB,IAAI,UAAU;AAAA,MAC3C,aAAa,iBAAiB,IAAI,WAAW;AAAA,MAC7C,cAAc,iBAAiB,IAAI,YAAY;AAAA,MAC/C,cAAc,iBAAiB,IAAI,YAAY;AAAA,IACjD;AAAA,EACF;AACF;;;AFYM;AAhDN,IAAM,qBAAqB;AAE3B,SAAS,cAAc,MAAc;AACnC,MAAI,CAAC,KAAM,QAAO;AAClB,SAAO,KAAK,SAAS,GAAG,IAAI,KAAK,MAAM,GAAG,EAAE,IAAI;AAClD;AAEA,SAAS,kBAAkB,MAA0B;AACnD,MAAI,CAAC,KAAM,QAAO;AAClB,MAAI,SAAS,IAAK,QAAO;AACzB,SAAO,KAAK,SAAS,GAAG,KAAK,KAAK,SAAS,IAAI,KAAK,MAAM,GAAG,EAAE,IAAI;AACrE;AAEA,SAAS,uBAAuB,QAA4B;AAC1D,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,UAAU,OAAO,SAAS,GAAG,KAAK,OAAO,SAAS,IAAI,OAAO,MAAM,GAAG,EAAE,IAAI;AAClF,SAAO,QAAQ,WAAW,GAAG,IAAI,UAAU,IAAI,OAAO;AACxD;AAcO,IAAM,eAAe,CAAC;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAAyB;AACvB,QAAM,UAAU,GAAG,SAAS;AAC5B,QAAM,QAAQ,GAAG,SAAS;AAC1B,QAAM,aAAa,gBAAgB,EAAE,cAAc,UAAU,eAAe,SAAS,CAAC;AAEtF,SACE,6CAAC,UAAK,MAAK,MACT;AAAA,iDAAC,UACC;AAAA,kDAAC,UAAK,SAAQ,SAAQ;AAAA,MACtB,4CAAC,UAAK,MAAK,YAAW,SAAQ,yCAAwC;AAAA,MACtE,4CAAC,WAAM,2BAAa;AAAA,MACpB,4CAAC,UAAK,KAAI,cAAa,MAAM,SAAS;AAAA,OACxC;AAAA,IACA,6CAAC,UACC;AAAA,kDAAC,SAAI,IAAG,aAAY;AAAA,MACpB;AAAA,QAAC;AAAA;AAAA,UACC,IAAG;AAAA,UACH,MAAK;AAAA,UACL,OAAO;AAAA,UACP,yBAAyB,EAAE,QAAQ,WAAW;AAAA;AAAA,MAChD;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,IAAG;AAAA,UACH,MAAK;AAAA,UACL,OAAO;AAAA,UACP,yBAAyB,EAAE,QAAQ,YAAY;AAAA;AAAA,MACjD;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,IAAG;AAAA,UACH,MAAK;AAAA,UACL,OAAO;AAAA,UACP,yBAAyB,EAAE,QAAQ,YAAY;AAAA;AAAA,MACjD;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,IAAG;AAAA,UACH,MAAK;AAAA,UACL,OAAO;AAAA,UACP,yBAAyB,EAAE,QAAQ,SAAS;AAAA;AAAA,MAC9C;AAAA,MACA;AAAA,QAAC;AAAA;AAAA,UACC,IAAG;AAAA,UACH,MAAK;AAAA,UACL,OAAO;AAAA,UACP,yBAAyB,EAAE,QAAQ,WAAW;AAAA;AAAA,MAChD;AAAA,MACA,4CAAC,YAAO,MAAK,UAAS,KAAK,OAAO,OAAO,UAAU;AAAA,OACrD;AAAA,KACF;AAEJ;AAEA,SAAS,gBAAgB,QAAmB;AAC1C,SAAO,KAAK,UAAU,OAAO,IAAI,aAAa,CAAC,EAAE,QAAQ,QAAQ,MAAM;AACzE;AAEA,SAAS,iBAAiB,SAA2C;AACnE,SAAO,KAAK,UAAU,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC,CAAC,EAAE,QAAQ,QAAQ,MAAM;AACrF;AAEA,SAAS,sBAAsB,cAAsD;AACnF,SAAO,KAAK,UAAU,MAAM,QAAQ,YAAY,IAAI,eAAe,CAAC,CAAC,EAAE,QAAQ,QAAQ,MAAM;AAC/F;AAEA,SAAS,kBAAkB,UAAsC;AAC/D,SAAO,KAAK,UAAU,MAAM,QAAQ,QAAQ,IAAI,WAAW,CAAC,CAAC,EAAE,QAAQ,QAAQ,MAAM;AACvF;AAIA,SAAS,gBAAgB,QAAoB;AAC3C,SAAO,KAAK,UAAU,MAAM,EAAE,QAAQ,QAAQ,MAAM;AACtD;AAEO,SAAS,uBACd,QACA,UAAyB,CAAC,GACZ;AACd,QAAM,YAAY,cAAc,QAAQ,iBAAiB,kBAAkB;AAC3E,QAAM,aAAa,gBAAgB,MAAM;AACzC,QAAM,cAAc,iBAAiB,QAAQ,OAAO;AACpD,QAAM,WAAW,kBAAkB,QAAQ,YAAY;AACvD,QAAM,cAAc,sBAAsB,QAAQ,YAAY;AAC9D,QAAM,WAAW,kBAAkB,QAAQ,QAAQ;AACnD,QAAM,gBAAgB,uBAAuB,QAAQ,aAAa;AAClE,QAAM,WAAW,QAAQ;AAEzB,SACE;AAAA,IAAC;AAAA;AAAA,MACC;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU,QAAQ;AAAA;AAAA,EACpB;AAEJ;AAEO,SAAS,mBAAmB,QAAmB,UAAyB,CAAC,GAAW;AACzF,QAAM,MAAM,uBAAuB,QAAQ,OAAO;AAClD,QAAM,WAAO,oCAAqB,GAAG;AACrC,SAAO,kBAAkB,IAAI;AAC/B;;;AGrKO,SAASC,oBAAmB,QAAmB,UAAyB,CAAC,GAAW;AACzF,SAAO,mBAAa,QAAQ,OAAO;AACrC;;;ACVA,iBAAkB;AAmEX,IAAM,gBAAgB,aAAE,KAAK,CAAC,SAAS,QAAQ,QAAQ,SAAS,QAAQ,CAAC;AAEzE,IAAM,yBAAyB,aAAE,OAAO;AAAA,EAC7C,IAAI,aAAE,OAAO;AAAA,EACb,WAAW,aAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,WAAW,aAAE,OAAO;AAAA,EACpB,QAAQ,aAAE,OAAO;AAAA,EACjB,MAAM,aAAE,OAAO;AAAA,EACf,SAAS,aAAE,OAAO,EAAE,SAAS;AAAA,EAC7B,QAAQ,aAAE,OAAO,aAAE,OAAO,GAAE,aAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACjD,OAAO,aAAE,OAAO,aAAE,OAAO,GAAE,aAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EAChD,MAAM,aAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,QAAQ,aAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,QAAQ,aAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,YAAY,aAAE,OAAO;AAAA,EACrB,OAAO,aAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;AAEM,IAAM,qBAAqB,aAAE,OAAO;AAAA,EACzC,IAAI,aAAE,OAAO;AAAA,EACb,MAAM;AAAA,EACN,SAAS,aAAE,OAAO;AAAA,EAClB,WAAW,aAAE,OAAO;AAAA,EACpB,WAAW,aAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,MAAM,aAAE,MAAM,aAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACnC,UAAU,aAAE,OAAO,EAAE,SAAS;AAChC,CAAC;AAEM,IAAM,yBAAyB,aAAE,OAAO;AAAA,EAC7C,QAAQ,aAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,OAAO,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AAAA,EAC5C,SAAS,aAAE,MAAM,aAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACtC,MAAM,aAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,QAAQ,aAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,MAAM,aAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,MAAM,aAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,IAAI,aAAE,OAAO,EAAE,SAAS;AAAA,EACxB,QAAQ,aAAE,KAAK,CAAC,aAAa,QAAQ,UAAU,CAAC,EAAE,SAAS;AAAA,EAC3D,SAAS,aAAE,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,SAAS;AAC5C,CAAC;AAEM,IAAM,qBAAqB,aAAE,OAAO;AAAA,EACzC,QAAQ,aAAE,OAAO,EAAE,SAAS;AAAA,EAC5B,OAAO,aAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS;AAAA,EAC5C,OAAO,aAAE,MAAM,aAAa,EAAE,SAAS;AAAA,EACvC,MAAM,aAAE,MAAM,aAAE,OAAO,CAAC,EAAE,SAAS;AAAA,EACnC,WAAW,aAAE,OAAO,EAAE,SAAS;AAAA,EAC/B,MAAM,aAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,MAAM,aAAE,OAAO,EAAE,SAAS;AAAA,EAC1B,IAAI,aAAE,OAAO,EAAE,SAAS;AAAA,EACxB,SAAS,aAAE,KAAK,CAAC,OAAO,MAAM,CAAC,EAAE,SAAS;AAC5C,CAAC;AAEM,IAAM,oBAAoB,CAAyB,eACxD,aAAE,OAAO;AAAA,EACP,OAAO,aAAE,MAAM,UAAU,EAAE,QAAQ,CAAC,CAAC;AAAA,EACrC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,EAChC,YAAY,aAAE,OAAO,EAAE,SAAS;AAAA,EAChC,OAAO,aAAE,OAAO,EAAE,SAAS;AAC7B,CAAC;AAEI,IAAM,+BAA+B,kBAAkB,sBAAsB;AAC7E,IAAM,2BAA2B,kBAAkB,kBAAkB;;;ALoB5E,IAAM,oBAAoB,CAAC,UACzB,MAAM,SAAS,GAAG,KAAK,MAAM,SAAS,IAAI,MAAM,MAAM,GAAG,EAAE,IAAI;AAE1D,SAAS,kBAAqC;AAAA,EACnD;AAAA,EACA;AAAA,EACA,UAAU,CAAC;AAAA,EACX,UAAU,CAAC;AACb,GAAsC;AACpC,QAAM,SAAS,QAAQ,SAAS,kBAAkB,QAAQ,MAAM,IAAI;AACpE,QAAM,WAAW,QAAQ,QAAQ;AACjC,QAAM,qBAAqB,kBAAkB,QAAQ;AACrD,QAAM,kBAAkB;AAAA,IACtB,QAAQ,iBAAiB,GAAG,kBAAkB;AAAA,EAChD;AACA,QAAM,mBAAmB,QAAQ,YAAY,YAAY,GAAG,kBAAkB;AAC9E,QAAM,kBAAkB;AAAA,IACtB,iBAAiB,WAAW,GAAG,IAAI,mBAAmB,IAAI,gBAAgB;AAAA,EAC5E;AACA,QAAM,sBAAsB;AAC5B,QAAM,kBAAkB;AACxB,QAAM,iBAAiB,kBAAkB,QAAQ,cAAc;AAC/D,QAAM,gBAAgB,sBAAsB,QAAQ,cAAc,mBAAmB;AACrF,QAAM,aAAa,kBAAkB,QAAQ,UAAU,iBAAiB,cAAc;AACtF,QAAM,kBAAsC,cAAc,MAAM;AAChE,QAAM,eAA+B,WAAW,MAAM;AACtD,QAAM,oBAAgD,cAAc,IAAI,CAAC,WAAW;AAAA,IAClF,GAAG;AAAA,IACH,SAAS,MAAM,WAAW,MAAM;AAAA,EAClC,EAAE;AACF,QAAM,eAA6B;AAAA,IACjC,SAAS,GAAG,eAAe;AAAA,IAC3B,MAAM,GAAG,eAAe;AAAA,EAC1B;AACA,QAAM,iBAAmC;AAAA,IACvC,SAAS;AAAA,MACP,OAAO;AAAA,MACP,UAAU;AAAA,MACV,OAAO;AAAA,IACT;AAAA,IACA,MAAM;AAAA,MACJ,OAAO;AAAA,MACP,UAAU;AAAA,MACV,OAAO;AAAA,IACT;AAAA,EACF;AACA,QAAM,gBAAgB;AAAA,IACpB,SAAS;AAAA,MACP,QAAQ;AAAA,MACR,MAAM,aAAa;AAAA,MACnB,KAAK;AAAA,QACH,SAAS;AAAA,QACT,aAAa;AAAA,QACb,aAAa;AAAA,QACb,cAAc;AAAA,QACd,MAAM,CAAC,YAAY,MAAM;AAAA,MAC3B;AAAA,IACF;AAAA,IACA,MAAM;AAAA,MACJ,QAAQ;AAAA,MACR,MAAM,aAAa;AAAA,MACnB,KAAK;AAAA,QACH,SAAS;AAAA,QACT,aAAa;AAAA,QACb,aAAa;AAAA,QACb,cAAc;AAAA,QACd,MAAM,CAAC,YAAY,MAAM;AAAA,MAC3B;AAAA,IACF;AAAA,EACF;AACA,QAAM,YAAY,iBAAiB;AACnC,QAAM,YAAY,iBAAAC,QAAK,KAAK,WAAW,QAAQ;AAC/C,QAAM,aAAa,QAAQ,QAAQ;AACnC,QAAM,aAAa,QAAQ;AAC3B,QAAM,cAAc,YAAY,YAAY;AAC5C,QAAM,eAAe,oBAAoB,UAAU;AACnD,QAAM,YAAY,YAAY,SAAS;AAEvC,MAAI,aAAa;AACf,UAAM,QAAQ,eACV,oBAAoB,cAAc,SAAS,IAC3C,2BAA2B;AAC/B,KAAC,oBAAoB,iBAAiB,eAAe,EAAE,QAAQ,CAAC,MAAM;AACpE,aAAO,IAAI,GAAG,KAAK;AAAA,IACrB,CAAC;AAAA,EACH;AAEA,SAAO,IAAI,qBAAiB,eAAAC,QAAc,WAAW,EAAE,WAAW,MAAM,QAAQ,OAAO,CAAC,CAAC;AACzF,QAAM,mBAAmB,CAAC,QAAQ,YAAY;AAC9C,QAAM,gBAAgB,CAAC,QAAQ,YAAY;AAE3C,MAAI,oBAAoB,eAAe;AACrC,WAAO,IAAI,CAAC,KAAK,KAAK,SAAS;AAC7B,UACE,IAAI,KAAK,WAAW,eAAe,KACnC,IAAI,KAAK,WAAW,eAAe,KACnC,IAAI,KAAK,WAAW,kBAAkB,GACtC;AACA,eAAO,KAAK;AAAA,MACd;AACA,YAAM,QAAQ,KAAK,IAAI;AACvB,YAAM,kBACJ,IAAI,QAAQ,cAAc,KAAK,IAAI,QAAQ,aAAa,KAAK,IAAI,QAAQ,cAAc;AACzF,YAAM,YAAY,MAAM,QAAQ,eAAe,IAAI,gBAAgB,CAAC,IAAI;AACxE,UAAI,KAAK,UAAU,MAAM;AACvB,cAAM,YAAY,KAAK,IAAI;AAC3B,cAAM,aAAa,KAAK,IAAI,YAAY,OAAO,CAAC;AAChD,cAAM,cAAc,OAAO,IAAI,UAAU,KAAK,EAAE,YAAY;AAC5D,cAAM,WAAW,IAAI,QAAQ,IAAI,eAAe;AAChD,cAAM,SAAS,IAAI;AACnB,cAAM,WAAW,UAAU,MAAM,GAAG,MAAM,KAAK;AAE/C,YAAI,kBAAkB;AACpB,0BAAgB,QAAQ;AAAA,YACtB,QAAI,2BAAY,CAAC,EAAE,SAAS,KAAK;AAAA,YACjC,WAAW,YAAY,OAAO,SAAS,IAAI;AAAA,YAC3C;AAAA,YACA,QAAQ;AAAA,YACR,MAAM;AAAA,YACN,SAAS,IAAI,eAAe;AAAA,YAC5B,QAAQ,CAAC;AAAA,YACT,OAAO,kBAAkB,IAAI,KAAK;AAAA,YAClC,MAAM,cAAc,IAAI,IAAI;AAAA,YAC5B,QAAQ;AAAA,YACR;AAAA,YACA;AAAA,YACA,OAAO;AAAA,UACT,CAAC;AACD,cAAI,gBAAgB,SAAS,oBAAqB,iBAAgB,SAAS;AAAA,QAC7E;AAEA,YAAI,eAAe;AACjB,gBAAM,UAAmB,UAAU,MAAM,UAAU,UAAU,MAAM,SAAS;AAC5E,gBAAM,WAAW,KAAK,UAAU;AAAA,YAC9B,OAAO,IAAI;AAAA,YACX;AAAA,UACF,CAAC;AACD,gBAAM,WAAW,eAAe;AAAA,YAC9B,QAAI,2BAAY,CAAC,EAAE,SAAS,KAAK;AAAA,YACjC,MAAM;AAAA,YACN,SAAS,GAAG,WAAW,IAAI,QAAQ,OAAO,MAAM;AAAA,YAChD;AAAA,YACA,WAAW,YAAY,OAAO,SAAS,IAAI;AAAA,YAC3C,MAAM,CAAC;AAAA,YACP;AAAA,UACF,CAAC;AACD,cAAI,UAAU;AACZ,yBAAa,QAAQ,QAAQ;AAC7B,gBAAI,aAAa,SAAS,gBAAiB,cAAa,SAAS;AAAA,UACnE;AAAA,QACF;AAAA,MACF,CAAC;AACD,WAAK;AAAA,IACP,CAAC;AAAA,EACH;AAEA,SAAO,IAAI,aAAa,SAAS,OAAO,KAAK,QAAQ;AACnD,UAAM,UAAU,QAAQ,YAAY;AACpC,QAAI;AACF,+BAAyB,GAAG;AAC5B,YAAM,QAAQ,yBAAyB,GAAG;AAC1C,UAAI,CAAC,SAAS;AACZ,cAAMC,YAAW,kBAAkB,iBAAiB,OAAO,mBAAmB;AAC9E,YAAI,KAAKA,SAAQ;AACjB;AAAA,MACF;AACA,YAAM,SAAS,MAAM,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AAEhD,YAAM,aAAa,qBAAqB,MAAM;AAC9C,YAAM,WAAW,kBAAkB,WAAW,OAAO,OAAO,mBAAmB;AAC/E,UAAI,KAAK,QAAQ;AAAA,IACnB,SAAS,KAAK;AACZ,cAAQ,MAAM,mCAAmC,GAAG;AACpD,UAAI,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO,8BAA8B,CAAC;AAAA,IAC/D;AAAA,EACF,CAAC;AAED,SAAO,IAAI,aAAa,MAAM,OAAO,KAAK,QAAQ;AAChD,UAAM,UAAU,QAAQ,YAAY;AACpC,QAAI;AACF,+BAAyB,GAAG;AAC5B,YAAM,QAAQ,qBAAqB,GAAG;AACtC,UAAI,CAAC,SAAS;AACZ,cAAMA,YAAW,eAAe,cAAc,OAAO,eAAe;AACpE,YAAI,KAAKA,SAAQ;AACjB;AAAA,MACF;AACA,YAAM,SAAS,MAAM,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;AAChD,YAAM,aAAa,qBAAqB,MAAM;AAC9C,YAAM,WAAW,kBAAkB,WAAW,OAAO,cAAc;AACnE,YAAM,WAAW,eAAe,UAAU,OAAO,eAAe;AAChE,UAAI,KAAK,QAAQ;AAAA,IACnB,SAAS,KAAK;AACZ,cAAQ,MAAM,+BAA+B,GAAG;AAChD,UAAI,OAAO,GAAG,EAAE,KAAK,EAAE,OAAO,2BAA2B,CAAC;AAAA,IAC5D;AAAA,EACF,CAAC;AAED,QAAM,iBAAiB,CAAC,oBAAoB,GAAG,kBAAkB,KAAK,GAAG,kBAAkB,MAAM;AAEjG,SAAO,IAAI,gBAAgB,CAAC,KAAK,QAAQ;AACvC,UAAM,iBAAiB,MAAM,QAAQ,MAAM,IACvC,OAAO,OAAO,CAAC,SAAS,KAAK,IAAI,eAAe,IAAI,IACpD,CAAC;AACL,UAAM,kBAAkB,MAAM,QAAQ,OAAO,IAAI,UAAU,CAAC;AAC5D,UAAM,kBACJ,QAAQ,YAAY,EAAE,KAAK,KAAK,QAAQ,gBAAgB,SAAS,gBAAgB,CAAC,KAAK,CAAC;AAC1F,UAAM,cAAc,gBAAgB,UAAU;AAC9C,UAAM,eAAe,gBAAgB,WAAW;AAEhD,UAAM,gBAAgB,OAAO,gBAAgB,SAAS;AAEtD,QAAI,QAAQ,gBAAgB;AAC5B,QAAI,CAAC,SAAS,cAAc,CAAC,eAAe;AAC1C,kBAAQ,2BAAY,EAAE,EAAE,SAAS,QAAQ;AAAA,IAC3C;AAEA,UAAM,OAAO,gBACR,gBAAgB,OACjBC,oBAAmB,aAAa;AAAA,MAC9B,UAAU;AAAA,MACV,eAAe,GAAG,MAAM,GAAG,eAAe;AAAA,MAC1C,cAAc,GAAG,MAAM,GAAG,kBAAkB;AAAA,MAC5C,eAAe;AAAA,MACf,cAAc;AAAA,MACd,UAAU;AAAA,MACV,SAAS,iBAAiB,YAAY;AAAA,MACtC,UAAU;AAAA,QACR,SAAS,GAAG,MAAM,GAAG,aAAa,OAAO;AAAA,QACzC,MAAM,GAAG,MAAM,GAAG,aAAa,IAAI;AAAA,MACrC;AAAA,IACF,CAAC;AAEL,6BAAyB,GAAG;AAC5B,QAAI,cAAc,OAAO;AACvB,UAAI;AAAA,QACF;AAAA,QACA;AAAA,UACE;AAAA,UACA,4BAA4B,KAAK;AAAA,UACjC,2BAA2B,KAAK;AAAA,UAChC;AAAA,UACA;AAAA,UACA;AAAA,UACA;AAAA,QACF,EAAE,KAAK,IAAI;AAAA,MACb;AAAA,IACF;AAEA,QAAI,KAAK,IAAI;AAAA,EACf,CAAC;AAED,SAAO,EAAE,MAAM,UAAU,UAAU,cAAc,eAAe,eAAe;AACjF;AAEA,SAAS,mBAAmB;AAC1B,QAAM,YACJ,OAAO,cAAc,cACjB,YACA,iBAAAH,QAAK,YAAQ,+BAAc,iBAAe,CAAC;AACjD,QAAM,aAAa,iBAAAA,QAAK,QAAQ,WAAW,WAAW;AACtD,MAAI,eAAAI,QAAG,WAAW,UAAU,EAAG,QAAO;AAGtC,QAAM,WAAW,iBAAAJ,QAAK,QAAQ,WAAW,gBAAgB;AACzD,MAAI,eAAAI,QAAG,WAAW,QAAQ,EAAG,QAAO;AAEpC,SAAO;AACT;AAEA,SAAS,iBAAiB,SAAuD;AAC/E,MAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO,CAAC;AACrC,SAAO,QAAQ,IAAI,CAAC,YAAY;AAAA,IAC9B,MAAM,OAAO;AAAA,IACb,aAAa,OAAO;AAAA,IACpB,MAAM,MAAM,QAAQ,OAAO,IAAI,IAAI,OAAO,KAAK,MAAM,IAAI,CAAC;AAAA,IAC1D,WAAW,OAAO;AAAA,IAClB,KAAK,MAAM,QAAQ,OAAO,GAAG,IACzB,OAAO,IAAI,IAAI,CAAC,QAAQ;AAAA,MACtB,QAAQ,OAAO,GAAG,WAAW,WAAW,GAAG,OAAO,YAAY,IAAI;AAAA,MAClE,MAAM,OAAO,GAAG,SAAS,WAAW,GAAG,OAAO;AAAA,MAC9C,MAAM,GAAG;AAAA,MACT,OAAO,GAAG;AAAA,MACV,QAAQ,GAAG;AAAA,IACb,EAAE,IACF,CAAC;AAAA,EACP,EAAE;AACJ;AAEA,SAAS,yBAAyB,KAAgC;AAChE,QAAM,QAAQ,IAAI,SAAS,CAAC;AAC5B,QAAM,UAAU,gBAAgB,MAAM,OAAO;AAC7C,QAAMJ,QAAO,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAC3D,QAAM,SAAS,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AACjE,QAAM,OAAO,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAC3D,QAAM,SAAS,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AACjE,QAAM,SAAS,UAAU,MAAM,MAAM,IAAK,MAAM,SAAwC;AACxF,QAAM,UAAU,UAAU,MAAM,OAAO,IAAK,MAAM,UAA0C;AAC5F,QAAM,QAAQ,WAAW,MAAM,KAAK;AACpC,QAAM,OAAO,eAAe,MAAM,IAAI;AACtC,QAAM,KAAK,eAAe,MAAM,EAAE;AAElC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA,MAAAA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,qBAAqB,KAA4B;AACxD,QAAM,QAAQ,IAAI,SAAS,CAAC;AAC5B,QAAM,QAAQ,gBAAgB,MAAM,KAAK;AACzC,QAAM,OAAO,gBAAgB,MAAM,IAAI;AACvC,QAAM,YAAY,OAAO,MAAM,cAAc,WAAW,MAAM,YAAY;AAC1E,QAAM,OAAO,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAC3D,QAAM,SAAS,OAAO,MAAM,WAAW,WAAW,MAAM,SAAS;AACjE,QAAM,QAAQ,WAAW,MAAM,KAAK;AACpC,QAAM,OAAO,eAAe,MAAM,IAAI;AACtC,QAAM,KAAK,eAAe,MAAM,EAAE;AAClC,QAAM,UAAU,UAAU,MAAM,OAAO,IAAK,MAAM,UAAsC;AAExF,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAEA,SAAS,gBAAgB,OAAgB;AACvC,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,QAAQ,MACX,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AACjB,SAAO,MAAM,SAAS,QAAQ;AAChC;AAEA,SAAS,WAAW,OAAgB;AAClC,MAAI,UAAU,OAAW,QAAO;AAChC,QAAM,MAAM,OAAO,KAAK;AACxB,MAAI,CAAC,OAAO,SAAS,GAAG,KAAK,OAAO,EAAG,QAAO;AAC9C,SAAO;AACT;AAEA,SAAS,eAAe,OAAgB;AACtC,MAAI,OAAO,UAAU,SAAU,QAAO;AACtC,QAAM,UAAU,OAAO,KAAK;AAC5B,MAAI,OAAO,SAAS,OAAO,EAAG,QAAO;AACrC,QAAM,YAAY,KAAK,MAAM,KAAK;AAClC,MAAI,OAAO,MAAM,SAAS,EAAG,QAAO;AACpC,SAAO;AACT;AAEA,SAAS,UAAU,OAAgB;AACjC,SAAO,UAAU,eAAe,UAAU,UAAU,UAAU;AAChE;AAEA,SAAS,UAAU,OAAgB;AACjC,SAAO,UAAU,SAAS,UAAU;AACtC;AAEA,SAAS,qBAAwB,MAAyD;AACxF,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,EAAE,OAAO,CAAC,EAAE;AAC1D,SAAO;AAAA,IACL,OAAO,MAAM,QAAQ,KAAK,KAAK,IAAI,KAAK,QAAQ,CAAC;AAAA,IACjD,YAAY,KAAK;AAAA,IACjB,YAAY,KAAK;AAAA,IACjB,OAAO,KAAK;AAAA,EACd;AACF;AAEA,SAAS,kBACP,OACA,OACA,WAC+B;AAC/B,QAAM,SAAS,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAC7D,QAAM,OAAO,OAAO,MAAM,OAAO,WAAW,MAAM,KAAK;AACvD,QAAM,UAAU,MAAM,UAAU,IAAI,IAAI,MAAM,QAAQ,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,IAAI;AACrF,QAAM,cAAc,MAAM,QAAQ,IAAI,YAAY;AAClD,QAAM,cAAc,MAAM,QAAQ,IAAI,YAAY;AAClD,QAAM,gBAAgB,MAAM,UAAU,IAAI,KAAK;AAC/C,QAAM,YAAY,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU;AACrE,QAAI,SAAS,QAAQ,CAAC,QAAQ,IAAI,OAAO,MAAM,UAAU,EAAE,EAAE,YAAY,CAAC,EAAG,QAAO;AACpF,QAAI,cAAc,CAAC,OAAO,MAAM,QAAQ,EAAE,EAAE,YAAY,EAAE,SAAS,UAAU,EAAG,QAAO;AACvF,QAAI,cAAc;AAChB,YAAM,YACJ,MAAM,WAAW,UAAa,MAAM,WAAW,OAAO,OAAO,MAAM,MAAM,IAAI;AAC/E,UAAI,CAAC,UAAU,WAAW,YAAY,EAAG,QAAO;AAAA,IAClD;AACA,QAAI,OAAO,SAAS,MAAM,KAAK,MAAM,YAAa,OAAmB,QAAO;AAC5E,QAAI,OAAO,SAAS,IAAI,KAAK,MAAM,YAAa,KAAiB,QAAO;AACxE,QAAI,YAAY;AACd,YAAM,WAAW;AAAA,QACf,MAAM;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA,QACN,MAAM;AAAA,QACN,KAAK,UAAU,MAAM,UAAU,CAAC,CAAC;AAAA,QACjC,KAAK,UAAU,MAAM,SAAS,CAAC,CAAC;AAAA,MAClC,EACG,OAAO,OAAO,EACd,KAAK,GAAG,EACR,YAAY;AACf,UAAI,CAAC,SAAS,SAAS,UAAU,EAAG,QAAO;AAAA,IAC7C;AACA,WAAO;AAAA,EACT,CAAC;AAED,QAAM,SAAS,MAAM,UAAU;AAC/B,QAAM,YAAY,MAAM,YAAY,QAAQ,IAAI;AAChD,QAAM,SAAS,SAAS,MAAM,EAAE,KAAK,CAAC,GAAG,MAAM;AAC7C,QAAI,QAAQ;AACZ,QAAI,WAAW,QAAQ;AACrB,cAAQ,OAAO,EAAE,QAAQ,EAAE,EAAE,cAAc,OAAO,EAAE,QAAQ,EAAE,CAAC;AAAA,IACjE,WAAW,WAAW,YAAY;AAChC,eAAS,EAAE,cAAc,MAAM,EAAE,cAAc;AAAA,IACjD,OAAO;AACL,eAAS,EAAE,aAAa,MAAM,EAAE,aAAa;AAAA,IAC/C;AACA,WAAO,QAAQ;AAAA,EACjB,CAAC;AAED,SAAO,cAAc,QAAQ,MAAM,QAAQ,MAAM,OAAO,WAAW,EAAE;AACvE;AAEA,SAAS,eACP,OACA,OACA,WAC2B;AAC3B,QAAM,SAAS,OAAO,MAAM,SAAS,WAAW,MAAM,OAAO;AAC7D,QAAM,OAAO,OAAO,MAAM,OAAO,WAAW,MAAM,KAAK;AACvD,QAAM,cAAc,MAAM,QAAQ,IAAI,YAAY;AAClD,QAAM,mBAAmB,MAAM,aAAa,IAAI,YAAY;AAC5D,QAAM,QAAQ,MAAM,QAAQ,IAAI,IAAI,MAAM,KAAK,IAAI;AACnD,QAAM,OAAO,MAAM,OAAO,IAAI,IAAI,MAAM,IAAI,IAAI;AAChD,QAAM,YAAY,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC,GAAG,OAAO,CAAC,UAAU;AACrE,QAAI,OAAO,QAAQ,CAAC,MAAM,IAAI,MAAM,IAAI,EAAG,QAAO;AAClD,UAAM,YAAY,MAAM,QAAQ,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC;AAC5D,QAAI,MAAM,QAAQ,CAAC,UAAU,KAAK,CAAC,QAAQ,KAAK,IAAI,GAAG,CAAC,EAAG,QAAO;AAClE,QAAI,mBAAmB,EAAE,MAAM,aAAa,IAAI,YAAY,EAAE,SAAS,eAAe;AACpF,aAAO;AACT,QAAI,OAAO,SAAS,MAAM,KAAK,MAAM,YAAa,OAAmB,QAAO;AAC5E,QAAI,OAAO,SAAS,IAAI,KAAK,MAAM,YAAa,KAAiB,QAAO;AACxE,QAAI,YAAY;AACd,YAAM,WAAW;AAAA,QACf,MAAM;AAAA,QACN,MAAM;AAAA,QACN,UAAU,KAAK,GAAG;AAAA,QAClB,OAAO,MAAM,aAAa,WAAW,MAAM,WAAW,KAAK,UAAU,MAAM,YAAY,EAAE;AAAA,MAC3F,EACG,OAAO,OAAO,EACd,KAAK,GAAG,EACR,YAAY;AACf,UAAI,CAAC,SAAS,SAAS,UAAU,EAAG,QAAO;AAAA,IAC7C;AACA,WAAO;AAAA,EACT,CAAC;AAED,QAAM,YAAY,MAAM,YAAY,QAAQ,IAAI;AAChD,QAAM,SAAS,SAAS,MAAM,EAAE,KAAK,CAAC,GAAG,OAAO,EAAE,YAAY,EAAE,aAAa,SAAS;AAEtF,SAAO,cAAc,QAAQ,MAAM,QAAQ,MAAM,OAAO,WAAW,EAAE;AACvE;AAEA,SAAS,cACP,OACA,QACA,OACA,WACA,eACgB;AAChB,QAAM,YAAY,WAAW,OAAO,WAAW,aAAa;AAC5D,QAAM,QAAQ,YAAY,MAAM;AAChC,QAAM,MAAM,QAAQ;AACpB,QAAM,QAAQ,MAAM,MAAM,OAAO,GAAG;AACpC,QAAM,aAAa,MAAM,MAAM,SAAS,OAAO,GAAG,IAAI;AACtD,QAAM,aAAa,QAAQ,IAAI,OAAO,KAAK,IAAI,QAAQ,WAAW,CAAC,CAAC,IAAI;AACxE,SAAO;AAAA,IACL,OAAO;AAAA,IACP;AAAA,IACA;AAAA,IACA,OAAO,MAAM;AAAA,EACf;AACF;AAEA,SAAS,WAAW,OAA2B,WAAmB,UAAkB;AAClF,MAAI,CAAC,OAAO,SAAS,KAAK,EAAG,QAAO,KAAK,IAAI,WAAW,QAAQ;AAChE,QAAM,OAAO,KAAK,IAAI,GAAG,KAAK,IAAI,WAAW,KAAe,CAAC;AAC7D,SAAO;AACT;AAEA,SAAS,YAAY,QAAmC;AACtD,QAAM,MAAM,OAAO,MAAM;AACzB,MAAI,OAAO,SAAS,GAAG,KAAK,OAAO,EAAG,QAAO,KAAK,MAAM,GAAG;AAC3D,SAAO;AACT;AAEA,SAAS,sBACP,OACA,WACoB;AACpB,MAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACnC,SAAO,MACJ,MAAM,GAAG,SAAS,EAClB,IAAI,CAAC,OAAO,SAAS;AAAA,IACpB,IAAI,MAAM,UAAM,2BAAY,CAAC,EAAE,SAAS,KAAK;AAAA,IAC7C,WAAW,OAAQ,MAAc,cAAc,WAAY,MAAc,YAAY;AAAA,IACrF,WAAW,MAAM,aAAa,KAAK,IAAI,IAAI,MAAM;AAAA,IACjD,QAAQ,MAAM,UAAU;AAAA,IACxB,MAAM,MAAM,QAAQ;AAAA,IACpB,SAAS,MAAM,WAAW,MAAM,QAAQ;AAAA,IACxC,QAAQ,MAAM,UAAU,CAAC;AAAA,IACzB,OAAO,MAAM,SAAS,CAAC;AAAA,IACvB,MAAM,MAAM,QAAQ;AAAA,IACpB,QAAQ,MAAM,UAAU;AAAA,IACxB,QAAQ,MAAM;AAAA,IACd,YAAY,MAAM,cAAc;AAAA,IAChC,OAAO,MAAM;AAAA,EACf,EAAE,EACD,OAAO,CAAC,UAAU,MAAM,UAAU,MAAM,IAAI;AACjD;AAEA,SAAS,kBACP,OACA,WACA,UACgB;AAChB,MAAI,CAAC,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACnC,QAAM,aAAa,MAChB,MAAM,GAAG,SAAS,EAClB,IAAI,CAAC,OAAO,SAAS;AAAA,IACpB,IAAI,MAAM,UAAM,2BAAY,CAAC,EAAE,SAAS,KAAK;AAAA,IAC7C,MAAM,MAAM,QAAQ;AAAA,IACpB,SAAS,MAAM,WAAW;AAAA,IAC1B,WAAW,MAAM,aAAa,KAAK,IAAI,IAAI,MAAM;AAAA,IACjD,WAAW,MAAM;AAAA,IACjB,MAAM,MAAM,QAAQ,MAAM,IAAI,IAAI,MAAM,OAAO,CAAC;AAAA,IAChD,UAAU,MAAM;AAAA,EAClB,EAAE,EACD,OAAO,CAAC,UAAU,MAAM,OAAO;AAElC,SAAO,kBAAkB,YAAY,QAAQ;AAC/C;AAEA,SAAS,kBAAkB,OAAiD;AAC1E,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO,CAAC;AACjD,SAAO,OAAO;AAAA,IACZ,OAAO,QAAQ,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC;AAAA,EACvE;AACF;AAEA,SAAS,cAAc,MAAuB;AAC5C,MAAI,SAAS,UAAa,SAAS,KAAM,QAAO;AAChD,MAAI,OAAO,SAAS,SAAU,QAAO;AACrC,MAAI;AACF,WAAO,KAAK,UAAU,IAAI;AAAA,EAC5B,QAAQ;AACN,WAAO,OAAO,IAAI;AAAA,EACpB;AACF;AAEA,SAAS,YAAY,OAAwB;AAC3C,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,MAAI,MAAM,QAAQ,KAAK,EAAG,QAAO,MAAM,IAAI,WAAW,EAAE,KAAK,GAAG;AAChE,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI;AACF,aAAO,KAAK,UAAU,KAAK;AAAA,IAC7B,QAAQ;AACN,aAAO,OAAO,KAAK;AAAA,IACrB;AAAA,EACF;AACA,SAAO,OAAO,KAAK;AACrB;AAEA,SAAS,kBAAkB,UAAwB;AACjD,MAAI,CAAC,SAAU,QAAO,CAAC,UAAwB;AAC/C,SAAO,CAAC,UAAwB;AAC9B,QAAI;AACF,aAAO,SAAS,KAAK,KAAK;AAAA,IAC5B,SAAS,KAAK;AACZ,cAAQ,MAAM,kDAA6C,GAAG;AAC9D,aAAO;AAAA,IACT;AAAA,EACF;AACF;AAEA,SAAS,kBACP,SACA,UACgB;AAChB,MAAI,CAAC,MAAM,QAAQ,OAAO,EAAG,QAAO,CAAC;AACrC,QAAM,OAAuB,CAAC;AAC9B,aAAW,SAAS,SAAS;AAC3B,UAAM,WAAW,SAAS,KAAK;AAC/B,QAAI,SAAU,MAAK,KAAK,QAAQ;AAAA,EAClC;AACA,SAAO;AACT;AAEA,SAAS,oBAAoB,MAAwB;AACnD,MAAI,MAAM,SAAU,QAAO,KAAK;AAChC,SAAO;AACT;AAEA,SAAS,oBAAoB,UAAkB,OAAe;AAC5D,QAAM,UAAU,SAAS,KAAK;AAC9B,SAAO,CAAC,KAAc,KAAe,SAAqB;AACxD,UAAM,WAAW,gBAAgB,IAAI,QAAQ,aAAa;AAC1D,QAAI,YAAY,aAAa,SAAS;AACpC,aAAO,KAAK;AAAA,IACd;AACA,6BAAyB,GAAG;AAC5B,QAAI,UAAU,oBAAoB,gBAAgB,KAAK,GAAG;AAC1D,QAAI,OAAO,GAAG,EAAE,KAAK,oBAAoB,+DAA+D,CAAC;AAAA,EAC3G;AACF;AAEA,SAAS,6BAA6B;AACpC,SAAO,CAAC,MAAe,QAAkB;AACvC,6BAAyB,GAAG;AAC5B,QACG,OAAO,GAAG,EACV,KAAK,oBAAoB,kCAAkC,CAAC;AAAA,EACjE;AACF;AAEA,SAAS,gBAAgB,YAA2C;AAClE,MAAI,CAAC,WAAY,QAAO;AACxB,QAAM,SAAS,MAAM,QAAQ,UAAU,IAAI,WAAW,CAAC,IAAI;AAC3D,MAAI,OAAO,WAAW,YAAY,CAAC,OAAO,WAAW,QAAQ,EAAG,QAAO;AACvE,QAAM,QAAQ,OAAO,MAAM,SAAS,MAAM;AAC1C,MAAI;AACF,UAAM,UAAU,OAAO,KAAK,OAAO,QAAQ,EAAE,SAAS,MAAM;AAC5D,UAAM,QAAQ,QAAQ,MAAM,GAAG;AAC/B,UAAM,MAAM;AACZ,WAAO,MAAM,KAAK,GAAG;AAAA,EACvB,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,SAAS,oBAAoB,SAAiB;AAC5C,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAiBA,OAAO;AAAA;AAAA;AAAA;AAIhB;AAEA,SAAS,yBAAyB,KAAe;AAC/C,MAAI,UAAU,0BAA0B,SAAS;AACjD,MAAI,UAAU,mBAAmB,aAAa;AAC9C,MAAI,UAAU,mBAAmB,YAAY;AAC7C,MAAI,UAAU,iBAAiB,UAAU;AAC3C;","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.
|