@emeryld/rrroutes-openapi 2.2.27 → 2.3.0-alpha.0

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/docs/LeafDocsPage.tsx","../src/docs/schemaIntrospection.ts","../src/docs/serializer.ts","../src/docs/docs.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';\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  /**\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\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>) {\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 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\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          presets: normalizePresets(finalPresets),\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 };\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\nexport { renderLeafDocsHTML } from './docs/docs.js';\nexport { serializeLeaf } from './docs/serializer.js';\nexport type { SerializableLeaf } from './docs/serializer.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';\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}\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  baseUrlSuffix?: string;\n  cspNonce?: string;\n};\n\nexport const DocsDocument = ({\n  leavesJson,\n  presetsJson,\n  assetBase,\n  docsBase,\n  historyJson,\n  baseUrlSuffix,\n  cspNonce,\n}: DocsDocumentProps) => {\n  const cssHref = `${assetBase}/docs.css`;\n  const jsSrc = `${assetBase}/docs.js`;\n  const configJson = serializeConfig({ docsBasePath: docsBase, baseUrlSuffix });\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=\"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\ntype DocsConfig = { docsBasePath: string; baseUrlSuffix?: string };\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 baseUrlSuffix = normalizeBaseUrlSuffix(options.baseUrlSuffix);\n\n  return (\n    <DocsDocument\n      leavesJson={leavesJson}\n      presetsJson={presetsJson}\n      assetBase={assetBase}\n      docsBase={docsBase}\n      historyJson={historyJson}\n      baseUrlSuffix={baseUrlSuffix}\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\";\n"],"mappings":"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","names":["renderLeafDocsHTML","renderLeafDocsHTML","path","expressStatic","renderLeafDocsHTML","fs"]}
+{"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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;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;;;ALE5E,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,kBAAsC,sBAAsB,QAAQ,cAAc,mBAAmB;AAC3G,QAAM,eAA+B,kBAAkB,QAAQ,UAAU,eAAe;AACxF,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;AAEnC,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,uBAAa,QAAQ;AAAA,YACnB,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,aAAa,SAAS,gBAAiB,cAAa,SAAS;AAAA,QACnE;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,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,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,eAAe,WAAW,OAAO,OAAO,eAAe;AACxE,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,QAAQ;AAAA,MACtB,UAAU,QAAQ;AAAA,MAClB,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,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,kBAAkB,OAAmC,WAAmC;AAC/F,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,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;AACpC;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;","names":["renderLeafDocsHTML","renderLeafDocsHTML","path","expressStatic","filtered","renderLeafDocsHTML","fs"]}

package/dist/index.d.ts

@@ -9,6 +9,7 @@ import type { AnyLeaf } from '@emeryld/rrroutes-contract';
 import type { Request, Response, Router } from 'express';
 import z from 'zod';
 import type { SerializableHistoryEntry } from './docs/docs.js';
+import { historyFeedEntrySchema, historyFeedQuerySchema, historyWebhookResponseSchema, logFeedEntrySchema, logFeedQuerySchema, logWebhookResponseSchema, type HistoryFeedEntry, type HistoryFeedQuery, type LogFeedEntry, type LogFeedQuery, type WebhookPage, type WebhookPaths } from './webhooks.js';
 export type DocsRequestContext = {
     req: Request;
     res: Response;
@@ -31,6 +32,10 @@ export type OpenApiDocsOptions = {
     assetBasePath?: string;
     /** Optional seed history entries that will pre-populate the docs UI history. */
     historySeeds?: SerializableHistoryEntry[];
+    /** Optional seed log entries that will pre-populate the docs UI logs tab. */
+    logSeeds?: LogFeedEntry[];
+    /** Handlers + settings for webhook-driven history/log feeds. */
+    logWebhook?: LogWebhookConfig;
     /**
      * Hook that runs on every request. Use it to adjust leaves, override nonce, or
      * provide a fully custom HTML response.
@@ -57,9 +62,43 @@ export type MountDocsArgs<L extends AnyLeaf> = {
     presets?: PresetGroup<L>[];
     options?: OpenApiDocsOptions;
 };
-export declare function mountRRRoutesDocs<L extends AnyLeaf>({ router, leaves, presets, options, }: MountDocsArgs<L>): {
+export type WebhookLeafMap = {
+    history: AnyLeaf;
+    logs: AnyLeaf;
+};
+export type WebhookSchemaMap = {
+    history: {
+        query: typeof historyFeedQuerySchema;
+        response: typeof historyWebhookResponseSchema;
+        entry: typeof historyFeedEntrySchema;
+    };
+    logs: {
+        query: typeof logFeedQuerySchema;
+        response: typeof logWebhookResponseSchema;
+        entry: typeof logFeedEntrySchema;
+    };
+};
+export type MountDocsResult = {
     path: string;
+    webhooks: WebhookPaths;
+    webhookLeaves: WebhookLeafMap;
+    webhookSchemas: WebhookSchemaMap;
+};
+type WebhookHandler<Q, R> = (ctx: {
+    query: Q;
+    req: Request;
+    res: Response;
+}) => Promise<WebhookPage<R>> | WebhookPage<R>;
+export type LogWebhookConfig = {
+    /** Base path for webhook endpoints. Defaults to `${docsPath}/webhooks`. */
+    basePath?: string;
+    /** Handler to hydrate the history feed. */
+    history?: WebhookHandler<HistoryFeedQuery, HistoryFeedEntry>;
+    /** Handler to hydrate the log feed. */
+    logs?: WebhookHandler<LogFeedQuery, LogFeedEntry>;
 };
+export declare function mountRRRoutesDocs<L extends AnyLeaf>({ router, leaves, presets, options, }: MountDocsArgs<L>): MountDocsResult;
 export { renderLeafDocsHTML } from './docs/docs.js';
 export { serializeLeaf } from './docs/serializer.js';
 export type { SerializableLeaf } from './docs/serializer.js';
+export type { HistoryFeedEntry, historyFeedEntrySchema, HistoryFeedQuery, historyFeedQuerySchema, historyWebhookResponseSchema, LogFeedEntry, logFeedEntrySchema, LogFeedQuery, logFeedQuerySchema, LogType, logTypeSchema, logWebhookResponseSchema, WebhookPage, webhookPageSchema, WebhookPaths } from './webhooks.js';