@crvouga/mockingbird-service-redis 2.2.0 → 2.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +21 -9
- package/SUPPORT.md +10 -0
- package/dist/chunk-LHUY4G3I.js +943 -0
- package/dist/chunk-LHUY4G3I.js.map +7 -0
- package/dist/{chunk-IWEHAJ2L.js → chunk-Z3XQGVTX.js} +109 -2
- package/dist/chunk-Z3XQGVTX.js.map +7 -0
- package/dist/cli.js +4077 -159
- package/dist/cli.js.map +4 -4
- package/dist/index.d.ts +5 -0
- package/dist/index.js +1 -1
- package/dist/server.d.ts +257 -3
- package/dist/server.js +2 -2
- package/package.json +1 -1
- package/dist/chunk-EKVFDNUN.js +0 -329
- package/dist/chunk-EKVFDNUN.js.map +0 -7
- package/dist/chunk-IWEHAJ2L.js.map +0 -7
|
@@ -1,7 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"version": 3,
|
|
3
|
-
"sources": ["../src/server.ts", "../../core/src/clock.ts", "../../core/src/control.ts"],
|
|
4
|
-
"sourcesContent": ["import { createConnection, createServer, type Server, type Socket } from \"node:net\"\nimport type { ConfigService, FleetChild } from \"@crvouga/mockingbird-adapter-node\"\nimport { matchNamespacePath, resolveAdminPrefix } from \"@crvouga/mockingbird-service\"\nimport { createRedis, type Redis, RedisConnectionError } from \"./engine.ts\"\nimport { asCommand, encodeReply, type Reply, RespParser } from \"./protocol.ts\"\n\n/** HTTP port for `serve --config`. The RESP socket binds an ephemeral port. */\nexport const DEFAULT_PORT = 8827\n\nexport interface ServeOptions {\n port?: number\n host?: string\n}\n\nexport interface RedisListening {\n host: string\n port: number\n close(): Promise<void>\n}\n\nexport function serve(redis: Redis, options: ServeOptions = {}): Promise<RedisListening> {\n const host = options.host ?? \"127.0.0.1\"\n const port = options.port ?? 6379\n const sockets = new Set<Socket>()\n const server = createServer({ keepAlive: true }, (socket) => {\n sockets.add(socket)\n attach(redis, socket, () => sockets.delete(socket))\n })\n return new Promise((resolve, reject) => {\n const fail = (error: Error) => reject(error)\n server.once(\"error\", fail)\n server.listen(port, host, () => {\n server.off(\"error\", fail)\n const address = server.address()\n const actual = address && typeof address === \"object\" ? address.port : port\n resolve({\n host,\n port: actual,\n close: () => shutdown(server, sockets, redis),\n })\n })\n })\n}\n\nfunction attach(redis: Redis, socket: Socket, onGone: () => void): void {\n const session = redis.createSession()\n const parser = new RespParser()\n const pending: Array<{ name: string; args: Uint8Array[] }> = []\n let pumping = false\n const write = (reply: Reply) => {\n if (!socket.destroyed) socket.write(encodeReply(reply, session.protocol))\n }\n session.onPush = write\n const stop = redis.onDisconnect((dropped) => {\n if (dropped === session) socket.destroy()\n })\n const finish = () => {\n redis.disconnect(session)\n stop()\n onGone()\n }\n socket.on(\"data\", (chunk: Uint8Array) => {\n for (const reply of parser.push(chunk)) {\n const command = asCommand(reply)\n if (\"t\" in command) {\n write(command)\n continue\n }\n pending.push(command)\n }\n void pump()\n })\n const pump = async () => {\n if (pumping) return\n pumping = true\n try {\n while (pending.length > 0) {\n const command = pending.shift()\n if (!command) break\n try {\n const reply = await redis.perform(session, command.name, command.args)\n write(reply)\n if (session.quit) {\n socket.end()\n break\n }\n } catch (error) {\n if (error instanceof RedisConnectionError) {\n socket.destroy()\n break\n }\n socket.destroy()\n break\n }\n }\n } finally {\n pumping = false\n if (pending.length > 0 && !socket.destroyed) void pump()\n }\n }\n socket.on(\"close\", finish)\n socket.on(\"error\", finish)\n}\n\nfunction shutdown(server: Server, sockets: Set<Socket>, redis: Redis): Promise<void> {\n redis.close()\n for (const socket of sockets) socket.destroy()\n return new Promise((resolve) => {\n server.close(() => resolve())\n })\n}\n\ntype FleetRuntime = {\n fetch(request: Request): Promise<Response>\n respPort: number\n close(): Promise<void>\n}\n\nconst isHealth = (pathname: string, adminPrefix: string): boolean => {\n const path = pathname.replace(/\\/+$/, \"\") || \"/\"\n return (\n path === `${adminPrefix}/health` ||\n matchNamespacePath(path, adminPrefix)?.[2] === `${adminPrefix}/health`\n )\n}\n\n/**\n * Fleet entry for `serve --config`. HTTP `GET /__admin/health` reports `service: redis`.\n * RESP listens on an ephemeral port named in the startup banner.\n */\nexport const serveTarget = {\n name: \"redis\",\n protocol: \"redis\" as const,\n defaultPort: 6379,\n start: startProtocol,\n async create(\n _values: unknown = {},\n common: { adminPrefix?: string } = {},\n ): Promise<FleetRuntime> {\n const redis = createRedis()\n const tcp = await serve(redis, { host: \"127.0.0.1\", port: 0 })\n const runtime: FleetRuntime = {\n respPort: tcp.port,\n close: () => tcp.close(),\n fetch: async (request: Request) => {\n if (\n request.method === \"GET\" &&\n isHealth(new URL(request.url).pathname, resolveAdminPrefix(common.adminPrefix))\n ) {\n return Response.json({ status: \"ok\", service: \"redis\" })\n }\n return new Response(\"not found\", { status: 404 })\n },\n }\n return runtime\n },\n banner(runtime: FleetRuntime) {\n return [`resp: redis://127.0.0.1:${runtime.respPort}`]\n },\n}\n\n/** Each fleet namespace owns a listener and an engine; Redis SELECT retains vendor semantics. */\nasync function startProtocol(entry: ConfigService): Promise<FleetChild> {\n const namespaces = new Map<string, { redis: Redis; listener: RedisListening; database: number }>()\n const selectors = { default: 0, ...entry.namespaces }\n try {\n for (const [name, database] of Object.entries(selectors)) {\n if (!/^[A-Za-z0-9_.-]{1,64}$/.test(name)) throw new Error(\"invalid Redis namespace\")\n if (\n typeof database !== \"number\" ||\n !Number.isInteger(database) ||\n database < 0 ||\n database > 15\n )\n throw new Error(\"invalid Redis database index\")\n const redis = createRedis({\n ...(entry.password !== undefined ? { password: entry.password } : {}),\n ...(entry.seed !== undefined ? { seed: Number(entry.seed) } : {}),\n })\n const listener = await serve(redis, {\n host: entry.host ?? \"127.0.0.1\",\n port: name === \"default\" ? (entry.port ?? 6379) : 0,\n })\n namespaces.set(name, { redis, listener, database })\n }\n } catch (error) {\n await Promise.allSettled([...namespaces.values()].map(({ listener }) => listener.close()))\n throw error\n }\n const get = (name: string) => {\n const found = namespaces.get(name)\n if (!found) throw new Error(`Redis namespace ${name} is not configured`)\n return found\n }\n const url = (name: string, privateUrl = false) => {\n const { listener, database } = get(name)\n const host = listener.host.includes(\":\") ? `[${listener.host}]` : listener.host\n const auth =\n privateUrl && entry.password !== undefined ? `:${encodeURIComponent(entry.password)}@` : \"\"\n return `redis://${auth}${host}:${listener.port}/${database}`\n }\n return {\n protocol: \"redis\",\n url: url(\"default\"),\n connection: url(\"default\", true),\n connections: Object.fromEntries([...namespaces.keys()].map((name) => [name, url(name, true)])),\n namespaces: {\n mechanism: \"endpoint\",\n endpoints: Object.fromEntries([...namespaces.keys()].map((name) => [name, url(name)])),\n },\n async ready() {\n return (\n await Promise.all(\n [...namespaces.values()].map(({ listener, database }) =>\n probe(listener, database, entry.password),\n ),\n )\n ).every(Boolean)\n },\n async close() {\n await Promise.all([...namespaces.values()].map(({ listener }) => listener.close()))\n },\n lock: (name) => get(name).redis.fence(),\n diagnostics(name) {\n const { redis } = get(name)\n return {\n activeRequests: redis.activeCommands(),\n activeConnections: redis.connections(),\n blockedCommands: redis.waiterCount(),\n pendingJobs: redis.pendingJobs(),\n activeJobs: redis.activeJobs(),\n pendingWebhooks: 0,\n unmatchedRequests: 0,\n }\n },\n async checkpoint(name) {\n return get(name).redis.snapshot()\n },\n async restore(name, point) {\n get(name).redis.restore(point)\n },\n async reset(name) {\n get(name).redis.reset()\n },\n clock: (name) => get(name).redis.clock,\n }\n}\n\n/** Readiness checks the actual RESP listener, including configured authentication and SELECT. */\nfunction probe(\n listener: RedisListening,\n database: number,\n password: string | undefined,\n): Promise<boolean> {\n return new Promise((resolve) => {\n const socket = createConnection({ host: listener.host, port: listener.port })\n const parser = new RespParser()\n const commands = [\n ...(password !== undefined ? [[\"AUTH\", password]] : []),\n [\"SELECT\", String(database)],\n [\"PING\"],\n ]\n const expected = commands.map((command) => (command[0] === \"PING\" ? \"PONG\" : \"OK\"))\n let result = false\n const finish = (ok: boolean) => {\n result = ok\n socket.destroy()\n }\n const timeout = setTimeout(() => finish(false), 2000)\n socket.once(\"close\", () => {\n clearTimeout(timeout)\n resolve(result)\n })\n socket.on(\"error\", () => finish(false))\n socket.once(\"connect\", () => {\n for (const command of commands)\n socket.write(\n `*${command.length}\\r\\n${command.map((arg) => `$${Buffer.byteLength(arg)}\\r\\n${arg}\\r\\n`).join(\"\")}`,\n )\n })\n socket.on(\"data\", (data) => {\n try {\n for (const reply of parser.push(data)) {\n if (reply.t !== \"simple\" || reply.v !== expected.shift()) {\n finish(false)\n return\n }\n if (expected.length === 0) {\n finish(true)\n return\n }\n }\n } catch {\n finish(false)\n }\n })\n })\n}\n", "/**\n * The single source of time for a service.\n *\n * Every timestamp a mock writes reads from here, so a suite moves time instead of\n * sleeping: appointment windows, result delays and expiries become reachable in\n * milliseconds. A frozen clock also makes timestamps reproducible from a seed.\n */\nexport type ClockState = {\n /** Current epoch milliseconds. */\n now: number\n /** True while time does not advance on its own. */\n frozen: boolean\n /** Milliseconds this clock adds to its underlying source. */\n offsetMs: number\n}\n\nexport type Clock = {\n now(): number\n /** Pin the clock to an exact instant, keeping it frozen if it already was. */\n set(epochMs: number): void\n /** Move the clock forward, or back with a negative delta. */\n advance(deltaMs: number): void\n /** Stop time at the current instant. */\n freeze(): void\n /** Resume from the current instant. */\n unfreeze(): void\n /** Drop back to the underlying source, live. */\n reset(): void\n state(): ClockState\n}\n\n/** A {@link Clock} over `source` (default `Date.now`), live and unfrozen. */\nexport const createClock = (source: () => number = Date.now): Clock => {\n let offsetMs = 0\n let frozenAt: number | undefined\n const now = () => frozenAt ?? source() + offsetMs\n return {\n now,\n set: (epochMs) => {\n if (frozenAt !== undefined) frozenAt = epochMs\n else offsetMs = epochMs - source()\n },\n advance: (deltaMs) => {\n if (frozenAt !== undefined) frozenAt += deltaMs\n else offsetMs += deltaMs\n },\n freeze: () => {\n frozenAt = now()\n },\n unfreeze: () => {\n if (frozenAt === undefined) return\n offsetMs = frozenAt - source()\n frozenAt = undefined\n },\n reset: () => {\n offsetMs = 0\n frozenAt = undefined\n },\n state: () => ({ now: now(), frozen: frozenAt !== undefined, offsetMs }),\n }\n}\n", "import type { Clock } from \"./clock.js\"\nimport type { FaultRegistry, FaultRule } from \"./faults.js\"\nimport type { Journal } from \"./journal.js\"\nimport type { Metrics } from \"./metrics.js\"\n\n/** Unauthenticated readiness probe, served ahead of every vendor auth gate. */\nexport const HEALTH_PATH = \"/__admin/health\"\n/** Prefix of every control-plane route; never part of a vendor contract. */\nexport const ADMIN_PREFIX = \"/__admin\"\n/** Resolve once at construction; ambiguous URL forms are never accepted. */\nexport const resolveAdminPrefix = (prefix: string = ADMIN_PREFIX): string => {\n if (!/^\\/[A-Za-z0-9_-]+(?:\\/[A-Za-z0-9_-]+)*$/.test(prefix)) {\n throw new Error(\n \"adminPrefix must be an absolute non-root path of literal segments, without a trailing slash\",\n )\n }\n return prefix\n}\n\n/** Segment-boundary matching prevents /__administer from entering the control plane. */\nexport const isAdminPath = (path: string, prefix: string): boolean =>\n path === prefix || path.startsWith(`${prefix}/`)\n\n/** SDK base URL namespace carrier, entirely inside the configured internal route tree. */\nexport const matchNamespacePath = (path: string, prefix: string): RegExpExecArray | null =>\n /^\\/ns\\/([^/]+)(\\/.*)?$/.exec(isAdminPath(path, prefix) ? path.slice(prefix.length) : \"\")\n\n/** Fail before serving when the declared vendor contract overlaps the reserved tree. */\nexport const assertAdminPrefixAvailable = (prefix: string, paths: readonly string[]): void => {\n const reserved = prefix.split(\"/\").slice(1)\n for (const path of paths) {\n const segments = path.split(\"/\").slice(1)\n // Catch-all vendor roots (e.g. S3 /{bucket}/{key}) share the listener.\n // The internal tree is reserved before vendor dispatch, regardless of the wildcard.\n if (segments.length < reserved.length || /^\\{[^}]+\\}$/.test(segments[0] ?? \"\")) continue\n if (\n reserved.every((part, i) => segments[i] === part || /^\\{[^}]+\\}$/.test(segments[i] ?? \"\"))\n ) {\n throw new Error(\n `vendor route ${path} collides with adminPrefix ${prefix}; choose a different adminPrefix`,\n )\n }\n }\n}\n\n/** Carries the admin key, which is separate from any vendor credential. */\nexport const ADMIN_KEY_HEADER = \"x-mockingbird-admin-key\"\n/** Selects the isolated namespace a request reads and writes. */\nexport const NAMESPACE_HEADER = \"x-mockingbird-namespace\"\n\nexport type AdminRequest = {\n request: Request\n url: URL\n /** `:param` segments of the matched route. */\n params: Record<string, string>\n /** Namespace the request targets: `?namespace=`, then the header, then the default. */\n namespace: string\n /** Parsed JSON body, or `undefined` when there is none. */\n body: unknown\n}\n\nexport type AdminRoute = (request: AdminRequest) => Response | Promise<Response>\n\n/**\n * Service-specific admin routes, keyed `METHOD /path` relative to `/__admin`, with\n * `:param` segments \u2014 e.g. `\"POST /orders/:id/transition\"`.\n */\nexport type AdminRoutes = Record<string, AdminRoute>\n\nexport type ControlContext = {\n name: string\n startedAt: number\n wallNow: () => number\n clock: Clock\n namespaceClock?(namespace: string): Clock\n faults: FaultRegistry\n metrics: Metrics\n journal: Journal\n defaultNamespace: string\n namespaces(): string[]\n reset(namespace: string | \"*\"): Promise<void>\n timeTravel: {\n checkpoint(\n namespace: string,\n branch: string,\n ): { id: string; branch: string; parent: string | null; at: number; records?: number }\n branch(\n name: string,\n options: { namespace: string; at?: string },\n ): { id: string; branch: string; parent: string | null; at: number }\n checkout(checkpoint: string, options: { namespace: string; branch: string }): void\n retain(namespace: string, checkpoint: string): void\n release(namespace: string, checkpoint: string): boolean\n inspect(namespace: string): {\n branches: Readonly<Record<string, string>>\n checkpoints: readonly { id: string; branch: string; parent: string | null; at: number }[]\n }\n }\n /** Extra fields for `GET /__admin/health`, such as the loaded corpus version. */\n describe(): Record<string, unknown>\n routes: AdminRoutes\n adminPrefix?: string\n adminKey: string | undefined\n /** Expand a named fault preset; enables `POST /faults {\"preset\": \"<name>\"}`. */\n applyPreset?(name: string, namespace: string, overrides: Partial<FaultRule>): FaultRule[]\n}\n\nexport type ControlPlane = {\n /** The control-plane response for `request`, or `undefined` for a vendor request. */\n handle(request: Request): Promise<Response | undefined>\n /**\n * Namespace a vendor request targets, from {@link NAMESPACE_HEADER}. Only admin routes\n * also accept `?namespace=`, so a vendor query parameter of that name can never\n * silently reroute a request.\n */\n namespaceOf(request: Request): string\n}\n\nconst json = (status: number, body: unknown): Response =>\n new Response(JSON.stringify(body), {\n status,\n headers: { \"content-type\": \"application/json; charset=utf-8\" },\n })\n\n/** Admin errors use one documented shape, distinct from any vendor's error body. */\nconst adminError = (status: number, message: string): Response =>\n json(status, { error: { type: \"mockingbird_admin\", message } })\n\nconst UNITS: Record<string, number> = {\n ms: 1,\n s: 1000,\n m: 60_000,\n h: 3_600_000,\n d: 86_400_000,\n}\n\n/** Milliseconds from a number, or a duration like `\"90s\"`, `\"15m\"`, `\"2h\"`, `\"3d\"`. */\nexport const parseDuration = (value: unknown): number | undefined => {\n if (typeof value === \"number\" && Number.isFinite(value)) return value\n if (typeof value !== \"string\") return undefined\n const match = /^(-?\\d+(?:\\.\\d+)?)\\s*(ms|s|m|h|d)$/.exec(value.trim())\n if (!match) return undefined\n return Number(match[1]) * (UNITS[match[2] as string] as number)\n}\n\n/** Epoch milliseconds from a number or an ISO-8601 string. */\nconst parseInstant = (value: unknown): number | undefined => {\n if (typeof value === \"number\" && Number.isFinite(value)) return value\n if (typeof value !== \"string\") return undefined\n const parsed = Date.parse(value)\n return Number.isNaN(parsed) ? undefined : parsed\n}\n\nconst matchRoute = (pattern: string, path: string): Record<string, string> | undefined => {\n const want = pattern.split(\"/\").filter(Boolean)\n const have = path.split(\"/\").filter(Boolean)\n if (want.length !== have.length) return undefined\n const params: Record<string, string> = {}\n for (let i = 0; i < want.length; i++) {\n const segment = want[i] as string\n const actual = have[i] as string\n if (segment.startsWith(\":\")) params[segment.slice(1)] = decodeURIComponent(actual)\n else if (segment !== actual) return undefined\n }\n return params\n}\n\nconst readJson = async (request: Request): Promise<unknown> => {\n const text = await request.text()\n if (text.trim() === \"\") return undefined\n return JSON.parse(text) as unknown\n}\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null && !Array.isArray(value)\n\nexport const createControlPlane = (context: ControlContext): ControlPlane => {\n const adminPrefix = resolveAdminPrefix(context.adminPrefix)\n // Legacy snapshot ids are opaque aliases to pinned Timeline checkpoints. Timeline remains the\n // only history owner; this map carries no state value and can be removed with the alias.\n const snapshots = new Map<string, { namespace: string; checkpoint: string }>()\n let snapshotCounter = 0\n\n const headerNamespace = (request: Request): string =>\n request.headers.get(NAMESPACE_HEADER) ?? context.defaultNamespace\n const adminNamespace = (request: Request, url: URL): string =>\n url.searchParams.get(\"namespace\") ?? headerNamespace(request)\n\n const health = (): Response => {\n return json(200, {\n ...context.describe(),\n status: \"ok\",\n service: context.name,\n uptimeMs: context.wallNow() - context.startedAt,\n clock: context.clock.state(),\n namespaces: context.namespaces().length,\n adminPrefix,\n adminUi: `${adminPrefix}/ui`,\n })\n }\n\n const builtin: AdminRoutes = {\n \"GET /health\": health,\n \"GET /\": () =>\n json(200, {\n service: context.name,\n routes: [...Object.keys(builtin), ...Object.keys(context.routes)].sort(),\n }),\n\n \"POST /reset\": async ({ url, namespace }) => {\n const target = url.searchParams.get(\"all\") === \"1\" ? \"*\" : namespace\n await context.reset(target)\n return json(200, { status: \"ok\", reset: target === \"*\" ? context.namespaces() : [target] })\n },\n\n \"GET /namespaces\": () =>\n json(200, { default: context.defaultNamespace, namespaces: context.namespaces() }),\n\n \"GET /clock\": ({ namespace }) =>\n json(200, (context.namespaceClock?.(namespace) ?? context.clock).state()),\n \"POST /clock\": ({ body, namespace }) => {\n const clock = context.namespaceClock?.(namespace) ?? context.clock\n if (!isRecord(body)) return adminError(400, \"expected a JSON object\")\n if (body.reset === true) clock.reset()\n // Freeze before applying mutations so a compound `{ set, freeze: true }` request is\n // atomic. Setting a live clock adjusts its offset; freezing it afterward would read the\n // wall clock again and could pin it a millisecond past the requested instant.\n if (body.freeze === true) clock.freeze()\n if (body.set !== undefined) {\n const instant = parseInstant(body.set)\n if (instant === undefined) return adminError(400, \"set: expected epoch ms or ISO-8601\")\n clock.set(instant)\n }\n if (body.advance !== undefined) {\n const delta = parseDuration(body.advance)\n if (delta === undefined) return adminError(400, 'advance: expected ms or \"15m\"-style')\n clock.advance(delta)\n }\n if (body.freeze === false) clock.unfreeze()\n return json(200, clock.state())\n },\n\n \"GET /faults\": () => json(200, { faults: context.faults.list() }),\n \"POST /faults\": ({ body, namespace }) => {\n if (isRecord(body) && typeof body.preset === \"string\") {\n if (!context.applyPreset) return adminError(400, `${context.name} has no fault presets`)\n const { preset, ...overrides } = body\n try {\n return json(201, {\n preset,\n rules: context.applyPreset(preset, namespace, overrides as Partial<FaultRule>),\n })\n } catch (error) {\n return adminError(404, error instanceof Error ? error.message : String(error))\n }\n }\n if (\n !isRecord(body) ||\n (typeof body.status !== \"number\" &&\n typeof body.delayMs !== \"number\" &&\n typeof body.latencyMs !== \"number\" &&\n body.drop !== true &&\n typeof body.effect !== \"string\")\n ) {\n return adminError(\n 400,\n \"a fault needs a numeric status, a delayMs/latencyMs, drop: true, an effect, or a preset\",\n )\n }\n const rule = {\n // Scoped to the caller's namespace unless it asks for every one, so one worker's\n // injected failure never lands on another's request.\n namespace,\n ...body,\n id: typeof body.id === \"string\" ? body.id : `fault_${context.faults.list().length + 1}`,\n } as FaultRule\n return json(201, context.faults.add(rule))\n },\n \"DELETE /faults\": ({ url }) => {\n const id = url.searchParams.get(\"id\")\n if (id === null) {\n context.faults.clear()\n return json(200, { status: \"ok\" })\n }\n return context.faults.remove(id)\n ? json(200, { status: \"ok\" })\n : adminError(404, `no fault ${id}`)\n },\n\n \"POST /snapshots\": ({ namespace }) => {\n const point = context.timeTravel.checkpoint(namespace, \"main\")\n context.timeTravel.retain(namespace, point.id)\n snapshotCounter++\n const id = `snap_${snapshotCounter}`\n snapshots.set(id, { namespace, checkpoint: point.id })\n return json(201, { id, namespace, records: point.records ?? 0 })\n },\n \"POST /snapshots/:id/restore\": ({ params, namespace }) => {\n const alias = snapshots.get(params.id as string)\n if (!alias) return adminError(404, `no snapshot ${params.id}`)\n if (alias.namespace !== namespace) {\n return adminError(409, `snapshot ${params.id} belongs to namespace ${alias.namespace}`)\n }\n context.timeTravel.checkout(alias.checkpoint, { namespace, branch: \"main\" })\n return json(200, { status: \"ok\", id: params.id, namespace })\n },\n \"DELETE /snapshots/:id\": ({ params }) => {\n const id = params.id as string\n const alias = snapshots.get(id)\n if (!alias) return adminError(404, `no snapshot ${id}`)\n snapshots.delete(id)\n context.timeTravel.release(alias.namespace, alias.checkpoint)\n return json(200, { status: \"ok\" })\n },\n\n \"GET /timeline\": ({ namespace }) => json(200, context.timeTravel.inspect(namespace)),\n \"POST /checkpoints\": ({ body, namespace }) => {\n const branch = isRecord(body) && typeof body.branch === \"string\" ? body.branch : \"main\"\n try {\n return json(201, context.timeTravel.checkpoint(namespace, branch))\n } catch (error) {\n return adminError(409, error instanceof Error ? error.message : String(error))\n }\n },\n \"POST /branches/:name\": ({ params, body, namespace }) => {\n const at = isRecord(body) && typeof body.at === \"string\" ? body.at : undefined\n try {\n return json(\n 201,\n context.timeTravel.branch(params.name as string, {\n namespace,\n ...(at !== undefined ? { at } : {}),\n }),\n )\n } catch (error) {\n return adminError(409, error instanceof Error ? error.message : String(error))\n }\n },\n \"POST /branches/:name/checkout\": ({ params, body, namespace }) => {\n if (!isRecord(body) || typeof body.checkpoint !== \"string\") {\n return adminError(400, 'expected {\"checkpoint\":\"cp_...\"}')\n }\n try {\n context.timeTravel.checkout(body.checkpoint, {\n namespace,\n branch: params.name as string,\n })\n return json(200, { status: \"ok\", branch: params.name, checkpoint: body.checkpoint })\n } catch (error) {\n return adminError(409, error instanceof Error ? error.message : String(error))\n }\n },\n\n \"GET /requests\": ({ url, namespace }) => {\n const status = url.searchParams.get(\"status\")\n const since = url.searchParams.get(\"since\")\n const limit = url.searchParams.get(\"limit\")\n const sinceMs =\n since === null ? undefined : parseInstant(/^\\d+$/.test(since) ? Number(since) : since)\n if (since !== null && sinceMs === undefined) {\n return adminError(400, \"since: expected epoch ms or ISO-8601\")\n }\n if (status !== null && !/^\\d{3}$/.test(status))\n return adminError(400, \"status: expected an HTTP status\")\n if (limit !== null && !/^\\d+$/.test(limit)) return adminError(400, \"limit: expected a count\")\n const operationId = url.searchParams.get(\"operationId\")\n const everyNamespace = url.searchParams.get(\"all\") === \"1\"\n return json(200, {\n size: context.journal.size,\n requests: context.journal.list({\n ...(everyNamespace ? {} : { namespace }),\n ...(operationId !== null ? { operationId } : {}),\n ...(status !== null ? { status: Number(status) } : {}),\n ...(sinceMs !== undefined ? { since: sinceMs } : {}),\n ...(limit !== null ? { limit: Number(limit) } : {}),\n }),\n })\n },\n \"DELETE /requests\": ({ url, namespace }) => {\n context.journal.clear(url.searchParams.get(\"all\") === \"1\" ? undefined : namespace)\n return json(200, { status: \"ok\" })\n },\n\n \"GET /metrics\": () => json(200, context.metrics.report()),\n \"DELETE /metrics\": () => {\n context.metrics.reset()\n return json(200, { status: \"ok\" })\n },\n }\n\n for (const key of Object.keys(context.routes)) {\n if (Object.hasOwn(builtin, key)) throw new Error(`admin route ${key} overrides a shared route`)\n const path = key.slice(key.indexOf(\" \") + 1)\n if (isAdminPath(path, \"/ns\") || isAdminPath(path, \"/blobs\"))\n throw new Error(`admin route ${key} overlaps an internal transport`)\n }\n const routes = [...Object.entries(builtin), ...Object.entries(context.routes)].map(\n ([key, handler]) => {\n const space = key.indexOf(\" \")\n return { method: key.slice(0, space), pattern: key.slice(space + 1), handler }\n },\n )\n\n return {\n namespaceOf: headerNamespace,\n async handle(request) {\n const url = new URL(request.url)\n if (url.pathname === `${adminPrefix}/health` && request.method === \"GET\") {\n return health()\n }\n if (!isAdminPath(url.pathname, adminPrefix)) {\n return undefined\n }\n const path = url.pathname.slice(adminPrefix.length) || \"/\"\n // The shell has no data. Panel markup stays on GET /ui/manifest, which is locked.\n const shell = request.method === \"GET\" && (path === \"/ui\" || path === \"/ui/\")\n if (\n !shell &&\n context.adminKey !== undefined &&\n request.headers.get(ADMIN_KEY_HEADER) !== context.adminKey\n ) {\n return adminError(401, `missing or wrong ${ADMIN_KEY_HEADER}`)\n }\n for (const route of routes) {\n if (route.method !== request.method) continue\n let params: Record<string, string> | undefined\n try {\n params = matchRoute(route.pattern, path)\n } catch {\n return adminError(400, \"invalid path encoding\")\n }\n if (!params) continue\n let body: unknown\n try {\n body = await readJson(request)\n } catch {\n return adminError(400, \"request body is not valid JSON\")\n }\n const namespace = adminNamespace(request, url)\n if (!/^[A-Za-z0-9_.-]{1,64}$/.test(namespace)) return adminError(400, \"invalid namespace\")\n return route.handler({\n request,\n url,\n params,\n namespace,\n body,\n })\n }\n return adminError(\n 404,\n `no admin route ${request.method} ${path}; GET ${adminPrefix} lists them`,\n )\n },\n }\n}\n"],
|
|
5
|
-
"mappings": ";;;;;;;;;AAAA,SAAS,kBAAkB,oBAA8C;;;ACgClE,IAAM,cAAc,CAAC,SAAuB,KAAK,QAAc;AACpE,MAAI,WAAW;AACf,MAAI;AACJ,QAAM,MAAM,MAAM,YAAY,OAAM,IAAK;AACzC,SAAO;IACL;IACA,KAAK,CAAC,YAAW;AACf,UAAI,aAAa;AAAW,mBAAW;;AAClC,mBAAW,UAAU,OAAM;IAClC;IACA,SAAS,CAAC,YAAW;AACnB,UAAI,aAAa;AAAW,oBAAY;;AACnC,oBAAY;IACnB;IACA,QAAQ,MAAK;AACX,iBAAW,IAAG;IAChB;IACA,UAAU,MAAK;AACb,UAAI,aAAa;AAAW;AAC5B,iBAAW,WAAW,OAAM;AAC5B,iBAAW;IACb;IACA,OAAO,MAAK;AACV,iBAAW;AACX,iBAAW;IACb;IACA,OAAO,OAAO,EAAE,KAAK,IAAG,GAAI,QAAQ,aAAa,QAAW,SAAQ;;AAExE;;;ACpDO,IAAM,eAAe;AAErB,IAAM,qBAAqB,CAAC,SAAiB,iBAAwB;AAC1E,MAAI,CAAC,0CAA0C,KAAK,MAAM,GAAG;AAC3D,UAAM,IAAI,MACR,6FAA6F;EAEjG;AACA,SAAO;AACT;AAGO,IAAM,cAAc,CAAC,MAAc,WACxC,SAAS,UAAU,KAAK,WAAW,GAAG,MAAM,GAAG;AAG1C,IAAM,qBAAqB,CAAC,MAAc,WAC/C,yBAAyB,KAAK,YAAY,MAAM,MAAM,IAAI,KAAK,MAAM,OAAO,MAAM,IAAI,EAAE;AAuG1F,IAAM,QAAgC;EACpC,IAAI;EACJ,GAAG;EACH,GAAG;EACH,GAAG;EACH,GAAG;;AAIE,IAAM,gBAAgB,CAAC,UAAsC;AAClE,MAAI,OAAO,UAAU,YAAY,OAAO,SAAS,KAAK;AAAG,WAAO;AAChE,MAAI,OAAO,UAAU;AAAU,WAAO;AACtC,QAAM,QAAQ,qCAAqC,KAAK,MAAM,KAAI,CAAE;AACpE,MAAI,CAAC;AAAO,WAAO;AACnB,SAAO,OAAO,MAAM,CAAC,CAAC,IAAK,MAAM,MAAM,CAAC,CAAW;AACrD;;;AFxIO,IAAM,eAAe;AAarB,SAAS,MAAM,OAAc,UAAwB,CAAC,GAA4B;AACvF,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,UAAU,oBAAI,IAAY;AAChC,QAAM,SAAS,aAAa,EAAE,WAAW,KAAK,GAAG,CAAC,WAAW;AAC3D,YAAQ,IAAI,MAAM;AAClB,WAAO,OAAO,QAAQ,MAAM,QAAQ,OAAO,MAAM,CAAC;AAAA,EACpD,CAAC;AACD,SAAO,IAAI,QAAQ,CAAC,SAAS,WAAW;AACtC,UAAM,OAAO,CAAC,UAAiB,OAAO,KAAK;AAC3C,WAAO,KAAK,SAAS,IAAI;AACzB,WAAO,OAAO,MAAM,MAAM,MAAM;AAC9B,aAAO,IAAI,SAAS,IAAI;AACxB,YAAM,UAAU,OAAO,QAAQ;AAC/B,YAAM,SAAS,WAAW,OAAO,YAAY,WAAW,QAAQ,OAAO;AACvE,cAAQ;AAAA,QACN;AAAA,QACA,MAAM;AAAA,QACN,OAAO,MAAM,SAAS,QAAQ,SAAS,KAAK;AAAA,MAC9C,CAAC;AAAA,IACH,CAAC;AAAA,EACH,CAAC;AACH;AAEA,SAAS,OAAO,OAAc,QAAgB,QAA0B;AACtE,QAAM,UAAU,MAAM,cAAc;AACpC,QAAM,SAAS,IAAI,WAAW;AAC9B,QAAM,UAAuD,CAAC;AAC9D,MAAI,UAAU;AACd,QAAM,QAAQ,CAAC,UAAiB;AAC9B,QAAI,CAAC,OAAO,UAAW,QAAO,MAAM,YAAY,OAAO,QAAQ,QAAQ,CAAC;AAAA,EAC1E;AACA,UAAQ,SAAS;AACjB,QAAM,OAAO,MAAM,aAAa,CAAC,YAAY;AAC3C,QAAI,YAAY,QAAS,QAAO,QAAQ;AAAA,EAC1C,CAAC;AACD,QAAM,SAAS,MAAM;AACnB,UAAM,WAAW,OAAO;AACxB,SAAK;AACL,WAAO;AAAA,EACT;AACA,SAAO,GAAG,QAAQ,CAAC,UAAsB;AACvC,eAAW,SAAS,OAAO,KAAK,KAAK,GAAG;AACtC,YAAM,UAAU,UAAU,KAAK;AAC/B,UAAI,OAAO,SAAS;AAClB,cAAM,OAAO;AACb;AAAA,MACF;AACA,cAAQ,KAAK,OAAO;AAAA,IACtB;AACA,SAAK,KAAK;AAAA,EACZ,CAAC;AACD,QAAM,OAAO,YAAY;AACvB,QAAI,QAAS;AACb,cAAU;AACV,QAAI;AACF,aAAO,QAAQ,SAAS,GAAG;AACzB,cAAM,UAAU,QAAQ,MAAM;AAC9B,YAAI,CAAC,QAAS;AACd,YAAI;AACF,gBAAM,QAAQ,MAAM,MAAM,QAAQ,SAAS,QAAQ,MAAM,QAAQ,IAAI;AACrE,gBAAM,KAAK;AACX,cAAI,QAAQ,MAAM;AAChB,mBAAO,IAAI;AACX;AAAA,UACF;AAAA,QACF,SAAS,OAAO;AACd,cAAI,iBAAiB,sBAAsB;AACzC,mBAAO,QAAQ;AACf;AAAA,UACF;AACA,iBAAO,QAAQ;AACf;AAAA,QACF;AAAA,MACF;AAAA,IACF,UAAE;AACA,gBAAU;AACV,UAAI,QAAQ,SAAS,KAAK,CAAC,OAAO,UAAW,MAAK,KAAK;AAAA,IACzD;AAAA,EACF;AACA,SAAO,GAAG,SAAS,MAAM;AACzB,SAAO,GAAG,SAAS,MAAM;AAC3B;AAEA,SAAS,SAAS,QAAgB,SAAsB,OAA6B;AACnF,QAAM,MAAM;AACZ,aAAW,UAAU,QAAS,QAAO,QAAQ;AAC7C,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,WAAO,MAAM,MAAM,QAAQ,CAAC;AAAA,EAC9B,CAAC;AACH;AAQA,IAAM,WAAW,CAAC,UAAkB,gBAAiC;AACnE,QAAM,OAAO,SAAS,QAAQ,QAAQ,EAAE,KAAK;AAC7C,SACE,SAAS,GAAG,WAAW,aACvB,mBAAmB,MAAM,WAAW,IAAI,CAAC,MAAM,GAAG,WAAW;AAEjE;AAMO,IAAM,cAAc;AAAA,EACzB,MAAM;AAAA,EACN,UAAU;AAAA,EACV,aAAa;AAAA,EACb,OAAO;AAAA,EACP,MAAM,OACJ,UAAmB,CAAC,GACpB,SAAmC,CAAC,GACb;AACvB,UAAM,QAAQ,YAAY;AAC1B,UAAM,MAAM,MAAM,MAAM,OAAO,EAAE,MAAM,aAAa,MAAM,EAAE,CAAC;AAC7D,UAAM,UAAwB;AAAA,MAC5B,UAAU,IAAI;AAAA,MACd,OAAO,MAAM,IAAI,MAAM;AAAA,MACvB,OAAO,OAAO,YAAqB;AACjC,YACE,QAAQ,WAAW,SACnB,SAAS,IAAI,IAAI,QAAQ,GAAG,EAAE,UAAU,mBAAmB,OAAO,WAAW,CAAC,GAC9E;AACA,iBAAO,SAAS,KAAK,EAAE,QAAQ,MAAM,SAAS,QAAQ,CAAC;AAAA,QACzD;AACA,eAAO,IAAI,SAAS,aAAa,EAAE,QAAQ,IAAI,CAAC;AAAA,MAClD;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EACA,OAAO,SAAuB;AAC5B,WAAO,CAAC,2BAA2B,QAAQ,QAAQ,EAAE;AAAA,EACvD;AACF;AAGA,eAAe,cAAc,OAA2C;AACtE,QAAM,aAAa,oBAAI,IAA0E;AACjG,QAAM,YAAY,EAAE,SAAS,GAAG,GAAG,MAAM,WAAW;AACpD,MAAI;AACF,eAAW,CAAC,MAAM,QAAQ,KAAK,OAAO,QAAQ,SAAS,GAAG;AACxD,UAAI,CAAC,yBAAyB,KAAK,IAAI,EAAG,OAAM,IAAI,MAAM,yBAAyB;AACnF,UACE,OAAO,aAAa,YACpB,CAAC,OAAO,UAAU,QAAQ,KAC1B,WAAW,KACX,WAAW;AAEX,cAAM,IAAI,MAAM,8BAA8B;AAChD,YAAM,QAAQ,YAAY;AAAA,QACxB,GAAI,MAAM,aAAa,SAAY,EAAE,UAAU,MAAM,SAAS,IAAI,CAAC;AAAA,QACnE,GAAI,MAAM,SAAS,SAAY,EAAE,MAAM,OAAO,MAAM,IAAI,EAAE,IAAI,CAAC;AAAA,MACjE,CAAC;AACD,YAAM,WAAW,MAAM,MAAM,OAAO;AAAA,QAClC,MAAM,MAAM,QAAQ;AAAA,QACpB,MAAM,SAAS,YAAa,MAAM,QAAQ,OAAQ;AAAA,MACpD,CAAC;AACD,iBAAW,IAAI,MAAM,EAAE,OAAO,UAAU,SAAS,CAAC;AAAA,IACpD;AAAA,EACF,SAAS,OAAO;AACd,UAAM,QAAQ,WAAW,CAAC,GAAG,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,SAAS,MAAM,CAAC,CAAC;AACzF,UAAM;AAAA,EACR;AACA,QAAM,MAAM,CAAC,SAAiB;AAC5B,UAAM,QAAQ,WAAW,IAAI,IAAI;AACjC,QAAI,CAAC,MAAO,OAAM,IAAI,MAAM,mBAAmB,IAAI,oBAAoB;AACvE,WAAO;AAAA,EACT;AACA,QAAM,MAAM,CAAC,MAAc,aAAa,UAAU;AAChD,UAAM,EAAE,UAAU,SAAS,IAAI,IAAI,IAAI;AACvC,UAAM,OAAO,SAAS,KAAK,SAAS,GAAG,IAAI,IAAI,SAAS,IAAI,MAAM,SAAS;AAC3E,UAAM,OACJ,cAAc,MAAM,aAAa,SAAY,IAAI,mBAAmB,MAAM,QAAQ,CAAC,MAAM;AAC3F,WAAO,WAAW,IAAI,GAAG,IAAI,IAAI,SAAS,IAAI,IAAI,QAAQ;AAAA,EAC5D;AACA,SAAO;AAAA,IACL,UAAU;AAAA,IACV,KAAK,IAAI,SAAS;AAAA,IAClB,YAAY,IAAI,WAAW,IAAI;AAAA,IAC/B,aAAa,OAAO,YAAY,CAAC,GAAG,WAAW,KAAK,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC;AAAA,IAC7F,YAAY;AAAA,MACV,WAAW;AAAA,MACX,WAAW,OAAO,YAAY,CAAC,GAAG,WAAW,KAAK,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC,CAAC;AAAA,IACvF;AAAA,IACA,MAAM,QAAQ;AACZ,cACE,MAAM,QAAQ;AAAA,QACZ,CAAC,GAAG,WAAW,OAAO,CAAC,EAAE;AAAA,UAAI,CAAC,EAAE,UAAU,SAAS,MACjD,MAAM,UAAU,UAAU,MAAM,QAAQ;AAAA,QAC1C;AAAA,MACF,GACA,MAAM,OAAO;AAAA,IACjB;AAAA,IACA,MAAM,QAAQ;AACZ,YAAM,QAAQ,IAAI,CAAC,GAAG,WAAW,OAAO,CAAC,EAAE,IAAI,CAAC,EAAE,SAAS,MAAM,SAAS,MAAM,CAAC,CAAC;AAAA,IACpF;AAAA,IACA,MAAM,CAAC,SAAS,IAAI,IAAI,EAAE,MAAM,MAAM;AAAA,IACtC,YAAY,MAAM;AAChB,YAAM,EAAE,MAAM,IAAI,IAAI,IAAI;AAC1B,aAAO;AAAA,QACL,gBAAgB,MAAM,eAAe;AAAA,QACrC,mBAAmB,MAAM,YAAY;AAAA,QACrC,iBAAiB,MAAM,YAAY;AAAA,QACnC,aAAa,MAAM,YAAY;AAAA,QAC/B,YAAY,MAAM,WAAW;AAAA,QAC7B,iBAAiB;AAAA,QACjB,mBAAmB;AAAA,MACrB;AAAA,IACF;AAAA,IACA,MAAM,WAAW,MAAM;AACrB,aAAO,IAAI,IAAI,EAAE,MAAM,SAAS;AAAA,IAClC;AAAA,IACA,MAAM,QAAQ,MAAM,OAAO;AACzB,UAAI,IAAI,EAAE,MAAM,QAAQ,KAAK;AAAA,IAC/B;AAAA,IACA,MAAM,MAAM,MAAM;AAChB,UAAI,IAAI,EAAE,MAAM,MAAM;AAAA,IACxB;AAAA,IACA,OAAO,CAAC,SAAS,IAAI,IAAI,EAAE,MAAM;AAAA,EACnC;AACF;AAGA,SAAS,MACP,UACA,UACA,UACkB;AAClB,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,SAAS,iBAAiB,EAAE,MAAM,SAAS,MAAM,MAAM,SAAS,KAAK,CAAC;AAC5E,UAAM,SAAS,IAAI,WAAW;AAC9B,UAAM,WAAW;AAAA,MACf,GAAI,aAAa,SAAY,CAAC,CAAC,QAAQ,QAAQ,CAAC,IAAI,CAAC;AAAA,MACrD,CAAC,UAAU,OAAO,QAAQ,CAAC;AAAA,MAC3B,CAAC,MAAM;AAAA,IACT;AACA,UAAM,WAAW,SAAS,IAAI,CAAC,YAAa,QAAQ,CAAC,MAAM,SAAS,SAAS,IAAK;AAClF,QAAI,SAAS;AACb,UAAM,SAAS,CAAC,OAAgB;AAC9B,eAAS;AACT,aAAO,QAAQ;AAAA,IACjB;AACA,UAAM,UAAU,WAAW,MAAM,OAAO,KAAK,GAAG,GAAI;AACpD,WAAO,KAAK,SAAS,MAAM;AACzB,mBAAa,OAAO;AACpB,cAAQ,MAAM;AAAA,IAChB,CAAC;AACD,WAAO,GAAG,SAAS,MAAM,OAAO,KAAK,CAAC;AACtC,WAAO,KAAK,WAAW,MAAM;AAC3B,iBAAW,WAAW;AACpB,eAAO;AAAA,UACL,IAAI,QAAQ,MAAM;AAAA,EAAO,QAAQ,IAAI,CAAC,QAAQ,IAAI,OAAO,WAAW,GAAG,CAAC;AAAA,EAAO,GAAG;AAAA,CAAM,EAAE,KAAK,EAAE,CAAC;AAAA,QACpG;AAAA,IACJ,CAAC;AACD,WAAO,GAAG,QAAQ,CAAC,SAAS;AAC1B,UAAI;AACF,mBAAW,SAAS,OAAO,KAAK,IAAI,GAAG;AACrC,cAAI,MAAM,MAAM,YAAY,MAAM,MAAM,SAAS,MAAM,GAAG;AACxD,mBAAO,KAAK;AACZ;AAAA,UACF;AACA,cAAI,SAAS,WAAW,GAAG;AACzB,mBAAO,IAAI;AACX;AAAA,UACF;AAAA,QACF;AAAA,MACF,QAAQ;AACN,eAAO,KAAK;AAAA,MACd;AAAA,IACF,CAAC;AAAA,EACH,CAAC;AACH;",
|
|
6
|
-
"names": []
|
|
7
|
-
}
|