@bilal-fazlani/mock-server 0.2.1 → 0.3.0

package/.next/standalone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bilal-fazlani/mock-server",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "A generic, catalog-driven HTTP API mock server — run via npx or Docker, no request-handling code required.",
   "license": "MIT",
   "repository": {
@@ -50,6 +50,7 @@
     "radix-ui": "^1.6.2",
     "react": "19.2.4",
     "react-dom": "19.2.4",
+    "shiki": "^4.3.1",
     "tailwind-merge": "^3.6.0",
     "tailwindcss": "^4.3.2",
     "tw-animate-css": "^1.4.0"

package/.next/standalone/release-please-config.json

@@ -5,6 +5,7 @@
       "release-type": "node",
       "package-name": "@bilal-fazlani/mock-server",
       "include-v-in-tag": true,
+      "include-component-in-tag": false,
       "bump-minor-pre-major": true,
       "bump-patch-for-minor-pre-major": false,
       "changelog-sections": [

package/.next/standalone/scripts/validate-catalog.ts

@@ -0,0 +1,38 @@
+import path from 'node:path'
+import { validateAppConfig, validateCatalog } from '../src/lib/catalog/validate'
+import { ConfigError, parsePassthroughAsDefault } from '../src/lib/config'
+import { CatalogLoadError, loadCatalog } from '../src/lib/catalog/load'
+import { compileResolvers } from '../src/lib/runtime'
+
+const root = process.cwd()
+let catalog
+try {
+  catalog = loadCatalog(path.join(root, 'catalog'))
+} catch (err) {
+  if (err instanceof CatalogLoadError) {
+    console.error('Catalog validation FAILED:')
+    console.error(err.message)
+    process.exit(1)
+  }
+  throw err
+}
+const { errors: catalogErrors } = validateCatalog(catalog, path.join(root, 'catalog'))
+
+let configErrors: string[] = []
+try {
+  const passthroughAsDefault = parsePassthroughAsDefault(process.env.PASSTHROUGH_AS_DEFAULT)
+  configErrors = validateAppConfig(catalog, process.env, passthroughAsDefault)
+} catch (err) {
+  if (err instanceof ConfigError) configErrors = [err.message]
+  else throw err
+}
+
+const { errors: resolverErrors } = compileResolvers(catalog, path.join(root, 'catalog'))
+
+const errors = [...catalogErrors, ...configErrors, ...resolverErrors]
+if (errors.length > 0) {
+  console.error('Catalog validation FAILED:')
+  for (const e of errors) console.error(` - ${e}`)
+  process.exit(1)
+}
+console.log('Catalog validation passed.')

package/.next/standalone/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":false,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/mock-server/mock-server","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","serverExternalPackages":["mongodb-memory-server","esbuild"],"outputFileTracingIncludes":{"**":["./node_modules/mongodb-memory-server/**"]},"turbopack":{"root":"/home/runner/work/mock-server/mock-server"},"distDirRoot":".next"}
+const nextConfig = {"env":{"NEXT_PUBLIC_APP_VERSION":"0.3.0","NEXT_PUBLIC_GIT_SHA":"d2cc65d7fbb735332d50f6db2b5a37f4f192c809"},"webpack":null,"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":false,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/mock-server/mock-server","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","serverExternalPackages":["mongodb-memory-server","esbuild"],"outputFileTracingIncludes":{"**":["./node_modules/mongodb-memory-server/**"]},"turbopack":{"root":"/home/runner/work/mock-server/mock-server"},"distDirRoot":".next"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/.next/standalone/src/app/[...path]/route.ts

@@ -0,0 +1,41 @@
+import { appendDynamicHistory, getDynamicHistory } from '../../lib/dynamic/history-store'
+import { insertLogEntry } from '../../lib/logs/store'
+import {
+  advanceScenarioProgress,
+  captureProfileKeyMapping,
+  getDb,
+  getGlobalMockScenario,
+  getProfile,
+  getProfileKeyMapping,
+} from '../../lib/profiles/store'
+import { createMockHandler } from '../../lib/router/handler'
+import { passthrough } from '../../lib/router/passthrough'
+import { getRuntime } from '../../lib/runtime'
+
+async function handle(
+  request: Request,
+  { params }: { params: Promise<{ path: string[] }> },
+): Promise<Response> {
+  const rt = getRuntime()
+  const handler = createMockHandler({
+    ...rt,
+    env: process.env,
+    getProfile: async (profileId) => getProfile(await getDb(), profileId),
+    getGlobalMockScenario: async (system, endpoint) =>
+      (await getGlobalMockScenario(await getDb(), system, endpoint))?.scenario ?? null,
+    getProfileKeyMapping: async (namespace, key) =>
+      getProfileKeyMapping(await getDb(), namespace, key),
+    captureProfileKeyMapping: async (input) => captureProfileKeyMapping(await getDb(), input),
+    advanceScenarioProgress: async (profileId, endpointName, steps) =>
+      advanceScenarioProgress(await getDb(), profileId, endpointName, steps),
+    getDynamicHistory: async (ownerType, ownerKey, endpointName, scenario) =>
+      getDynamicHistory(await getDb(), ownerType, ownerKey, endpointName, scenario),
+    appendDynamicHistory: async (ownerType, ownerKey, endpointName, scenario, slug) =>
+      appendDynamicHistory(await getDb(), ownerType, ownerKey, endpointName, scenario, slug, rt.resolverHistoryLimit),
+    passthrough,
+    writeLog: async (entry) => insertLogEntry(await getDb(), entry),
+  })
+  return handler(request, (await params).path)
+}
+
+export { handle as GET, handle as POST, handle as PUT, handle as PATCH, handle as DELETE }

package/.next/standalone/src/app/ui/api/catalog/route.ts

@@ -0,0 +1,32 @@
+import type { Catalog } from '../../../../lib/catalog/types'
+import { getRuntime } from '../../../../lib/runtime'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(): Promise<Response> {
+  const { catalog } = getRuntime()
+  return Response.json(toCatalogView(catalog))
+}
+
+function toCatalogView(catalog: Catalog) {
+  return {
+    systems: catalog.systems.map((system) => ({
+      slug: system.slug,
+      name: system.name,
+      baseUrlEnv: system.baseUrlEnv,
+      endpoints: system.endpoints.map((endpoint) => ({
+        name: endpoint.name,
+        displayName: endpoint.displayName,
+        method: endpoint.method,
+        path: endpoint.path,
+        mockType: endpoint.mockType ?? 'profiled',
+        resolverScenarios: endpoint.resolverScenarios,
+        // The runtime-control API contract exposes scenarios as slug → label
+        // strings; the internal `summary` is surfaced only in the catalog UI.
+        scenarios: Object.fromEntries(
+          Object.entries(endpoint.scenarios).map(([slug, meta]) => [slug, meta.label]),
+        ),
+      })),
+    })),
+  }
+}

package/.next/standalone/src/app/ui/api/global-mocks/[system]/[endpoint]/route.ts

@@ -0,0 +1,53 @@
+import { findEndpointBySlug } from '../../../../../../lib/catalog/find'
+import {
+  clearGlobalMockScenario,
+  getDb,
+  upsertGlobalMockScenario,
+} from '../../../../../../lib/profiles/store'
+import { getRuntime } from '../../../../../../lib/runtime'
+import { isScenarioDeclared } from '../../../../../../lib/scenarios'
+
+export const dynamic = 'force-dynamic'
+
+type Ctx = { params: Promise<{ system: string; endpoint: string }> }
+
+export async function PUT(request: Request, { params }: Ctx): Promise<Response> {
+  const { system, endpoint } = await params
+  const found = findEndpointBySlug(getRuntime().catalog, system, endpoint)
+  if (!found) {
+    return Response.json({ error: `unknown endpoint ${system}/${endpoint}` }, { status: 404 })
+  }
+  if ((found.endpoint.mockType ?? 'profiled') !== 'global') {
+    return Response.json(
+      { error: `endpoint "${endpoint}" is not a global mock` },
+      { status: 400 },
+    )
+  }
+
+  let body: unknown
+  try {
+    body = await request.json()
+  } catch {
+    return Response.json({ error: 'request body is not valid JSON' }, { status: 400 })
+  }
+  const scenario = (body as { scenario?: unknown } | null)?.scenario
+  if (typeof scenario !== 'string' || scenario === '') {
+    return Response.json({ error: 'scenario is required' }, { status: 400 })
+  }
+  if (!isScenarioDeclared(found.endpoint, scenario)) {
+    return Response.json({ error: `scenario "${scenario}" is not declared` }, { status: 400 })
+  }
+
+  await upsertGlobalMockScenario(await getDb(), { system, endpoint, scenario })
+  return Response.json({ system, endpoint, scenario })
+}
+
+export async function DELETE(_request: Request, { params }: Ctx): Promise<Response> {
+  const { system, endpoint } = await params
+  const found = findEndpointBySlug(getRuntime().catalog, system, endpoint)
+  if (!found) {
+    return Response.json({ error: `unknown endpoint ${system}/${endpoint}` }, { status: 404 })
+  }
+  await clearGlobalMockScenario(await getDb(), system, endpoint)
+  return new Response(null, { status: 204 })
+}

package/.next/standalone/src/app/ui/api/global-mocks/route.ts

@@ -0,0 +1,8 @@
+import { getDb, listGlobalMockScenarios } from '../../../../lib/profiles/store'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(): Promise<Response> {
+  const scenarios = await listGlobalMockScenarios(await getDb())
+  return Response.json({ scenarios })
+}

package/.next/standalone/src/app/ui/api/health/route.ts

@@ -0,0 +1,47 @@
+import { getDb } from '../../../../lib/profiles/store'
+import { BUILD_INFO } from '../../../../lib/build-info'
+
+// Never cache — the health check must reflect live Mongo connectivity.
+export const dynamic = 'force-dynamic'
+
+// Fail fast: the MongoDB driver's default server-selection timeout is 30s, far
+// longer than the compose healthcheck's 5s window. Bound the check so a down
+// Mongo yields a prompt 503 instead of a hung request.
+const CHECK_TIMEOUT_MS = 3000
+
+export async function GET(): Promise<Response> {
+  const build = { version: BUILD_INFO.version, sha: BUILD_INFO.gitSha }
+  try {
+    await withTimeout(pingMongo(), CHECK_TIMEOUT_MS)
+    return Response.json({ status: 'ok', mongo: 'up', ...build })
+  } catch (err) {
+    return Response.json(
+      { status: 'error', mongo: 'down', error: err instanceof Error ? err.message : String(err), ...build },
+      { status: 503 },
+    )
+  }
+}
+
+async function pingMongo(): Promise<void> {
+  const db = await getDb()
+  await db.command({ ping: 1 })
+}
+
+function withTimeout<T>(promise: Promise<T>, ms: number): Promise<T> {
+  return new Promise<T>((resolve, reject) => {
+    const timer = setTimeout(
+      () => reject(new Error(`health check timed out after ${ms}ms`)),
+      ms,
+    )
+    promise.then(
+      (value) => {
+        clearTimeout(timer)
+        resolve(value)
+      },
+      (error) => {
+        clearTimeout(timer)
+        reject(error)
+      },
+    )
+  })
+}

package/.next/standalone/src/app/ui/api/logs/[logId]/route.ts

@@ -0,0 +1,15 @@
+import { getLogEntry } from '../../../../../lib/logs/store'
+import { getDb } from '../../../../../lib/profiles/store'
+import { toLogEntryView } from '../../../logs/types'
+
+export const dynamic = 'force-dynamic'
+
+export async function GET(
+  _request: Request,
+  { params }: { params: Promise<{ logId: string }> },
+): Promise<Response> {
+  const { logId } = await params
+  const entry = await getLogEntry(await getDb(), logId)
+  if (!entry) return Response.json({ error: 'not_found' }, { status: 404 })
+  return Response.json({ entry: toLogEntryView(entry) })
+}

package/.next/standalone/src/app/ui/api/logs/route.ts

@@ -0,0 +1,24 @@
+import { listLogSummaries } from '../../../../lib/logs/store'
+import { getDb } from '../../../../lib/profiles/store'
+import { toLogSummaryView } from '../../logs/types'
+
+export const dynamic = 'force-dynamic'
+
+const MAX_LIMIT = 200
+
+export async function GET(request: Request): Promise<Response> {
+  const params = new URL(request.url).searchParams
+  const requestedLimit = Number.parseInt(params.get('limit') ?? '', 10)
+  const entries = await listLogSummaries(await getDb(), {
+    profileId: params.get('profile') || undefined,
+    endpoint: params.get('endpoint') || undefined,
+    errorsOnly: params.get('errorsOnly') === '1',
+    logIdQuery: params.get('logId') || undefined,
+    sinceId: params.get('since') || undefined,
+    beforeId: params.get('before') || undefined,
+    limit: Number.isFinite(requestedLimit)
+      ? Math.min(Math.max(requestedLimit, 1), MAX_LIMIT)
+      : undefined,
+  })
+  return Response.json({ entries: entries.map(toLogSummaryView) })
+}

package/.next/standalone/src/app/ui/api/profiles/[profileId]/reset/route.ts

@@ -0,0 +1,25 @@
+import { resetDynamicHistory } from '../../../../../../lib/dynamic/history-store'
+import { writeAdminLog } from '../../../../../../lib/logs/admin-log'
+import { getDb, resetScenarioProgress } from '../../../../../../lib/profiles/store'
+
+export const dynamic = 'force-dynamic'
+
+type Ctx = { params: Promise<{ profileId: string }> }
+
+export async function POST(request: Request, { params }: Ctx): Promise<Response> {
+  const { profileId } = await params
+
+  let endpoint: string | undefined
+  try {
+    const body = (await request.json()) as { endpoint?: unknown } | null
+    if (typeof body?.endpoint === 'string' && body.endpoint !== '') endpoint = body.endpoint
+  } catch {
+    // No body / malformed JSON → whole-profile reset.
+  }
+
+  const db = await getDb()
+  await resetScenarioProgress(db, profileId, endpoint)
+  await resetDynamicHistory(db, 'profile', profileId, endpoint)
+  await writeAdminLog(db, profileId, 'progress_reset', endpoint)
+  return new Response(null, { status: 204 })
+}

package/.next/standalone/src/app/ui/api/profiles/[profileId]/route.ts

@@ -0,0 +1,64 @@
+import { writeAdminLog } from '../../../../../lib/logs/admin-log'
+import {
+  InvalidScenarioSelectionError,
+  parseEndpointScenariosFromJson,
+} from '../../../../../lib/profiles/api-scenarios'
+import { deleteProfile, getDb, getProfile, upsertProfile } from '../../../../../lib/profiles/store'
+import { getRuntime } from '../../../../../lib/runtime'
+import { implicitScenario } from '../../../../../lib/scenarios'
+
+export const dynamic = 'force-dynamic'
+
+type Ctx = { params: Promise<{ profileId: string }> }
+
+export async function GET(_request: Request, { params }: Ctx): Promise<Response> {
+  const { profileId } = await params
+  const profile = await getProfile(await getDb(), profileId)
+  if (!profile) return Response.json({ error: 'not_found' }, { status: 404 })
+  return Response.json(profile)
+}
+
+export async function PUT(request: Request, { params }: Ctx): Promise<Response> {
+  const { profileId } = await params
+
+  let body: unknown
+  try {
+    body = await request.json()
+  } catch {
+    return Response.json({ error: 'request body is not valid JSON' }, { status: 400 })
+  }
+  const raw = body as { displayName?: unknown; endpointScenarios?: unknown } | null
+
+  const { catalog, passthroughAsDefault } = getRuntime()
+  const implicit = implicitScenario(passthroughAsDefault)
+
+  let endpointScenarios
+  try {
+    endpointScenarios = parseEndpointScenariosFromJson(
+      raw?.endpointScenarios ?? {},
+      catalog,
+      implicit,
+    )
+  } catch (err) {
+    if (err instanceof InvalidScenarioSelectionError) {
+      return Response.json({ error: err.message }, { status: 400 })
+    }
+    throw err
+  }
+
+  const displayName =
+    typeof raw?.displayName === 'string' && raw.displayName.trim() !== ''
+      ? raw.displayName.trim()
+      : undefined
+
+  const db = await getDb()
+  await upsertProfile(db, { profileId, displayName, endpointScenarios })
+  await writeAdminLog(db, profileId, 'profile_saved')
+  return Response.json(await getProfile(db, profileId))
+}
+
+export async function DELETE(_request: Request, { params }: Ctx): Promise<Response> {
+  const { profileId } = await params
+  await deleteProfile(await getDb(), profileId)
+  return new Response(null, { status: 204 })
+}

package/.next/standalone/src/app/ui/catalog/highlight.ts

@@ -0,0 +1,12 @@
+import { codeToHtml } from 'shiki'
+
+// Server-side dual-theme highlighting. defaultColor:false emits both palettes
+// as --shiki-light/--shiki-dark CSS variables; globals.css swaps them on the
+// `.dark` root class set by next-themes (attribute="class" in layout.tsx).
+export async function highlight(code: string, lang: 'json' | 'typescript'): Promise<string> {
+  return codeToHtml(code, {
+    lang,
+    themes: { light: 'github-light', dark: 'github-dark' },
+    defaultColor: false,
+  })
+}

package/.next/standalone/src/app/ui/catalog/scenario-view.ts

@@ -0,0 +1,68 @@
+import fs from 'node:fs'
+import type { EndpointDef, SystemDef } from '../../../lib/catalog/types'
+import { REAL_LABEL } from '../../../lib/config'
+import { loadFixture } from '../../../lib/mock-engine/fixtures'
+import { resolverFilePath } from '../../../lib/mock-engine/resolver'
+import { highlight } from './highlight'
+
+export type ScenarioView = {
+  key: string
+  label: string
+  summary?: string
+  isDefault: boolean
+} & (
+  | { kind: 'passthrough'; baseUrlEnv: string; url: string | null }
+  | { kind: 'fixture'; json: string; html: string }
+  | { kind: 'error'; message: string }
+  | { kind: 'resolver'; code: string; html: string }
+)
+
+export async function buildScenarioViews(
+  system: SystemDef,
+  endpoint: EndpointDef,
+  catalogDir: string,
+  env: Record<string, string | undefined>,
+  passthroughAsDefault: boolean,
+): Promise<ScenarioView[]> {
+  const declared: ScenarioView[] = await Promise.all(
+    Object.entries(endpoint.scenarios).map(async ([key, meta]) => {
+      const { label, summary } = meta
+      const isDefault = key === 'default'
+      if (endpoint.resolverScenarios.includes(key)) {
+        try {
+          const code = fs.readFileSync(
+            resolverFilePath(catalogDir, system.slug, endpoint.name, key),
+            'utf8',
+          )
+          return { key, label, ...(summary ? { summary } : {}), isDefault, kind: 'resolver' as const, code, html: await highlight(code, 'typescript') }
+        } catch (err) {
+          return { key, label, ...(summary ? { summary } : {}), isDefault, kind: 'error' as const, message: (err as Error).message }
+        }
+      }
+      try {
+        const fixture = loadFixture(catalogDir, system.slug, endpoint.name, key)
+        // `json` is the full fixture (status/headers/body) — kept for the header
+        // status-chip parsing. `html` highlights the body only, matching the
+        // body block the pre-highlighting UI rendered.
+        const json = JSON.stringify(fixture, null, 2)
+        const bodyJson = JSON.stringify(fixture.body, null, 2)
+        return { key, label, ...(summary ? { summary } : {}), isDefault, kind: 'fixture' as const, json, html: await highlight(bodyJson, 'json') }
+      } catch (err) {
+        return { key, label, ...(summary ? { summary } : {}), isDefault, kind: 'error' as const, message: (err as Error).message }
+      }
+    }),
+  )
+
+  // "real" is never declared in the catalog — it's an implicit capability of
+  // every endpoint.
+  const passthrough: ScenarioView = {
+    key: 'real',
+    label: REAL_LABEL,
+    isDefault: passthroughAsDefault,
+    kind: 'passthrough',
+    baseUrlEnv: system.baseUrlEnv,
+    url: env[system.baseUrlEnv] ?? null,
+  }
+
+  return passthroughAsDefault ? [passthrough, ...declared] : [...declared, passthrough]
+}

package/.next/standalone/src/app/ui/global-mocks/actions.ts

@@ -0,0 +1,50 @@
+'use server'
+
+import { revalidatePath } from 'next/cache'
+import { redirect } from 'next/navigation'
+import { resetDynamicHistory } from '../../../lib/dynamic/history-store'
+import {
+  clearGlobalMockScenario,
+  getDb,
+  upsertGlobalMockScenario,
+} from '../../../lib/profiles/store'
+import { getRuntime } from '../../../lib/runtime'
+import { implicitScenario, isScenarioDeclared } from '../../../lib/scenarios'
+
+export async function saveGlobalMocks(formData: FormData): Promise<void> {
+  const { catalog, passthroughAsDefault } = getRuntime()
+  const implicit = implicitScenario(passthroughAsDefault)
+  const db = await getDb()
+
+  for (const system of catalog.systems) {
+    for (const endpoint of system.endpoints) {
+      if ((endpoint.mockType ?? 'profiled') !== 'global') continue
+      const value = formData.get(`scenario:${system.slug}:${endpoint.name}`)
+      if (typeof value !== 'string' || value === '') continue
+      if (!isScenarioDeclared(endpoint, value)) {
+        throw new Error(`endpoint "${endpoint.name}": scenario "${value}" is not declared`)
+      }
+      if (value === implicit) {
+        await clearGlobalMockScenario(db, system.slug, endpoint.name)
+      } else {
+        await upsertGlobalMockScenario(db, {
+          system: system.slug,
+          endpoint: endpoint.name,
+          scenario: value,
+        })
+      }
+    }
+  }
+
+  redirect('/ui/global-mocks')
+}
+
+export async function resetGlobalDynamicHistoryAction(
+  systemSlug: string,
+  endpointName: string,
+): Promise<void> {
+  if (!systemSlug || !endpointName) throw new Error('system and endpoint are required')
+
+  await resetDynamicHistory(await getDb(), 'global', systemSlug, endpointName)
+  revalidatePath('/ui/global-mocks')
+}

package/.next/standalone/src/app/ui/logs/actions.ts

@@ -0,0 +1,11 @@
+'use server'
+
+import { revalidatePath } from 'next/cache'
+import { clearLogs } from '../../../lib/logs/store'
+import { getDb } from '../../../lib/profiles/store'
+
+export async function clearLogsAction(formData: FormData): Promise<void> {
+  const profileId = String(formData.get('profileId') ?? '').trim() || undefined
+  await clearLogs(await getDb(), profileId)
+  revalidatePath('/ui/logs')
+}

package/.next/standalone/src/app/ui/logs/list-state.ts

@@ -0,0 +1,64 @@
+import type { LogSummaryView } from './types'
+
+export const TAIL_CAP = 100
+export const DOM_CAP = 500
+export const OLDER_PAGE_SIZE = 50
+export const TOP_THRESHOLD_PX = 8
+export const PENDING_CAP = 200
+
+/** Unique by logId, keeping the first occurrence (order preserved). */
+function dedupe(entries: LogSummaryView[]): LogSummaryView[] {
+  const seen = new Set<string>()
+  const out: LogSummaryView[] = []
+  for (const e of entries) {
+    if (seen.has(e.logId)) continue
+    seen.add(e.logId)
+    out.push(e)
+  }
+  return out
+}
+
+/** Tail mode: prepend newer entries, dedupe, keep the newest TAIL_CAP. */
+export function mergeTail(
+  current: LogSummaryView[],
+  fresh: LogSummaryView[],
+): LogSummaryView[] {
+  return dedupe([...fresh, ...current]).slice(0, TAIL_CAP)
+}
+
+/** Append older entries, dedupe, and cap the rendered DOM at DOM_CAP. */
+export function appendOlder(
+  current: LogSummaryView[],
+  older: LogSummaryView[],
+): { rows: LogSummaryView[]; capped: boolean } {
+  const merged = dedupe([...current, ...older])
+  const capped = merged.length >= DOM_CAP
+  return { rows: merged.slice(0, DOM_CAP), capped }
+}
+
+/** Browse mode: accumulate fresh entries not already rendered or buffered. */
+export function bufferPending(
+  pending: LogSummaryView[],
+  fresh: LogSummaryView[],
+  knownIds: Set<string>,
+): LogSummaryView[] {
+  const buffered = new Set(pending.map((e) => e.logId))
+  const additions = fresh.filter((e) => !knownIds.has(e.logId) && !buffered.has(e.logId))
+  // Fresh arrivals are newer than everything already buffered, so they go in
+  // front to keep the buffer newest-first (matching the list sort).
+  // Bound the buffer — under sustained load a scrolled-away user must not
+  // accumulate entries without limit. Newest are kept.
+  return [...additions, ...pending].slice(0, PENDING_CAP)
+}
+
+/** Return to tail: prepend buffered entries, drop loaded-older rows, trim. */
+export function flushToTail(
+  rows: LogSummaryView[],
+  pending: LogSummaryView[],
+): LogSummaryView[] {
+  return dedupe([...pending, ...rows]).slice(0, TAIL_CAP)
+}
+
+export function atTop(scrollTop: number): boolean {
+  return scrollTop <= TOP_THRESHOLD_PX
+}