@revenexx/app-sdk 0.4.2 → 0.6.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 +29 -1
- package/dist/chunk-WJ7QJ3NU.js +41 -0
- package/dist/chunk-WJ7QJ3NU.js.map +1 -0
- package/dist/errors-DrxYD96C.d.cts +111 -0
- package/dist/errors-DrxYD96C.d.ts +111 -0
- package/dist/index.cjs +154 -15
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +129 -15
- package/dist/index.js.map +1 -1
- package/dist/router/index.cjs +55 -4
- package/dist/router/index.cjs.map +1 -1
- package/dist/router/index.d.cts +18 -13
- package/dist/router/index.d.ts +18 -13
- package/dist/router/index.js +40 -16
- package/dist/router/index.js.map +1 -1
- package/package.json +1 -1
- package/dist/types-BMd8t8Pi.d.cts +0 -66
- package/dist/types-BMd8t8Pi.d.ts +0 -66
package/dist/router/index.cjs
CHANGED
|
@@ -35,6 +35,7 @@ __export(router_exports, {
|
|
|
35
35
|
conflict: () => conflict,
|
|
36
36
|
createApp: () => createApp,
|
|
37
37
|
forbidden: () => forbidden,
|
|
38
|
+
isHttpError: () => isHttpError,
|
|
38
39
|
mountCrud: () => mountCrud,
|
|
39
40
|
notFound: () => notFound
|
|
40
41
|
});
|
|
@@ -79,20 +80,40 @@ void startTelemetry();
|
|
|
79
80
|
|
|
80
81
|
// src/router/router.ts
|
|
81
82
|
var import_api = require("@opentelemetry/api");
|
|
83
|
+
|
|
84
|
+
// src/errors.ts
|
|
82
85
|
var HttpError = class extends Error {
|
|
83
86
|
status;
|
|
84
87
|
details;
|
|
85
|
-
|
|
88
|
+
code;
|
|
89
|
+
serverDetail;
|
|
90
|
+
/**
|
|
91
|
+
* Structural marker. `dist/index.cjs` and `dist/router/index.cjs` are separate
|
|
92
|
+
* bundles, so an error thrown by the data client and caught by the router is
|
|
93
|
+
* an instance of a *different* copy of this class — `instanceof` would be
|
|
94
|
+
* false. Everything checks this flag via `isHttpError` instead.
|
|
95
|
+
*/
|
|
96
|
+
__isHttpError = true;
|
|
97
|
+
constructor(status, message, details, options = {}) {
|
|
86
98
|
super(message);
|
|
87
99
|
this.name = "HttpError";
|
|
88
100
|
this.status = status;
|
|
89
|
-
this.details = details;
|
|
101
|
+
if (details !== void 0) this.details = details;
|
|
102
|
+
if (options.code !== void 0) this.code = options.code;
|
|
103
|
+
if (options.serverDetail !== void 0) this.serverDetail = options.serverDetail;
|
|
90
104
|
}
|
|
91
105
|
};
|
|
106
|
+
function isHttpError(err) {
|
|
107
|
+
if (!err || typeof err !== "object") return false;
|
|
108
|
+
const e = err;
|
|
109
|
+
return e.__isHttpError === true || e.name === "HttpError" && typeof e.status === "number";
|
|
110
|
+
}
|
|
92
111
|
var notFound = (message = "not found") => new HttpError(404, message);
|
|
93
112
|
var badRequest = (message = "bad request", details) => new HttpError(400, message, details);
|
|
94
113
|
var forbidden = (message = "forbidden") => new HttpError(403, message);
|
|
95
114
|
var conflict = (message = "conflict") => new HttpError(409, message);
|
|
115
|
+
|
|
116
|
+
// src/router/router.ts
|
|
96
117
|
var splitPath = (path) => path.split("/").filter(Boolean);
|
|
97
118
|
function compileTemplate(template) {
|
|
98
119
|
return splitPath(template).map((seg) => {
|
|
@@ -148,6 +169,12 @@ function parseBody(req) {
|
|
|
148
169
|
}
|
|
149
170
|
function parseQuery(req) {
|
|
150
171
|
const out = {};
|
|
172
|
+
const rawPath = String(req.path ?? "");
|
|
173
|
+
const qmark = rawPath.indexOf("?");
|
|
174
|
+
if (qmark >= 0) {
|
|
175
|
+
for (const [k, v] of new URLSearchParams(rawPath.slice(qmark + 1))) out[k] = v;
|
|
176
|
+
return out;
|
|
177
|
+
}
|
|
151
178
|
for (const [k, v] of Object.entries(req.query ?? {})) {
|
|
152
179
|
if (typeof v === "string") out[k] = v;
|
|
153
180
|
else if (v != null) out[k] = String(v);
|
|
@@ -261,10 +288,23 @@ function createApp(options = {}) {
|
|
|
261
288
|
};
|
|
262
289
|
return await matched.route.handler(c);
|
|
263
290
|
} catch (err) {
|
|
264
|
-
if (err
|
|
291
|
+
if (isHttpError(err)) {
|
|
265
292
|
span.setAttribute("http.response.status_code", err.status);
|
|
293
|
+
if (err.code) span.setAttribute("revenexx.error.code", err.code);
|
|
266
294
|
if (err.status >= 500) span.setStatus({ code: import_api.SpanStatusCode.ERROR, message: err.message });
|
|
267
|
-
|
|
295
|
+
if (err.serverDetail !== void 0) {
|
|
296
|
+
const detail = typeof err.serverDetail === "string" ? err.serverDetail : JSON.stringify(err.serverDetail);
|
|
297
|
+
span.setAttribute("revenexx.error.detail", detail);
|
|
298
|
+
context.error?.(`${method} ${path} \u2014 ${err.status} ${err.message}: ${detail}`);
|
|
299
|
+
}
|
|
300
|
+
return res.json(
|
|
301
|
+
{
|
|
302
|
+
error: err.message,
|
|
303
|
+
...err.code ? { code: err.code } : {},
|
|
304
|
+
...err.details != null ? { details: err.details } : {}
|
|
305
|
+
},
|
|
306
|
+
err.status
|
|
307
|
+
);
|
|
268
308
|
}
|
|
269
309
|
const msg = err instanceof Error ? err.message : String(err);
|
|
270
310
|
if (/not permitted/.test(msg)) {
|
|
@@ -297,6 +337,12 @@ function parentWhere(c, parent) {
|
|
|
297
337
|
if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);
|
|
298
338
|
return { [parent.column]: value };
|
|
299
339
|
}
|
|
340
|
+
async function assertParentExists(c, parent) {
|
|
341
|
+
if (!parent?.repo) return;
|
|
342
|
+
const value = c.params[parent.param];
|
|
343
|
+
if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);
|
|
344
|
+
if (!await parent.repo.get(value)) throw notFound();
|
|
345
|
+
}
|
|
300
346
|
async function fetchOwned(repo, c, opts) {
|
|
301
347
|
const id = c.params[opts.idParam ?? "id"] ?? "";
|
|
302
348
|
if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? "id"}'`);
|
|
@@ -316,6 +362,7 @@ function mountCrud(app, repo, opts) {
|
|
|
316
362
|
const maxLimit = opts.maxLimit ?? 200;
|
|
317
363
|
if (enabled.has("list")) {
|
|
318
364
|
app.get(base, async (c) => {
|
|
365
|
+
await assertParentExists(c, opts.parent);
|
|
319
366
|
const where = {};
|
|
320
367
|
for (const [k, v] of Object.entries(c.query)) {
|
|
321
368
|
if (opts.columns && k in opts.columns) where[k] = v;
|
|
@@ -339,6 +386,7 @@ function mountCrud(app, repo, opts) {
|
|
|
339
386
|
}
|
|
340
387
|
if (enabled.has("create")) {
|
|
341
388
|
app.post(base, async (c) => {
|
|
389
|
+
await assertParentExists(c, opts.parent);
|
|
342
390
|
const data = { ...c.body, ...parentWhere(c, opts.parent) };
|
|
343
391
|
return c.json(await repo.create(data), 201);
|
|
344
392
|
});
|
|
@@ -352,6 +400,8 @@ function mountCrud(app, repo, opts) {
|
|
|
352
400
|
if (enabled.has("update")) {
|
|
353
401
|
app.put(idTemplate, async (c) => {
|
|
354
402
|
const { id } = await fetchOwned(repo, c, opts);
|
|
403
|
+
const fields = c.body && typeof c.body === "object" && !Array.isArray(c.body) ? Object.keys(c.body) : [];
|
|
404
|
+
if (fields.length === 0) throw new HttpError(400, "request body must contain at least one field to update");
|
|
355
405
|
const patch = { ...c.body, ...parentWhere(c, opts.parent) };
|
|
356
406
|
return c.json(await repo.update(id, patch));
|
|
357
407
|
});
|
|
@@ -372,6 +422,7 @@ function mountCrud(app, repo, opts) {
|
|
|
372
422
|
conflict,
|
|
373
423
|
createApp,
|
|
374
424
|
forbidden,
|
|
425
|
+
isHttpError,
|
|
375
426
|
mountCrud,
|
|
376
427
|
notFound
|
|
377
428
|
});
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/router/index.ts","../../src/instrument.ts","../../src/router/router.ts","../../src/router/crud.ts"],"sourcesContent":["/**\n * @revenexx/app-sdk/router — declarative HTTP routing for revenexx App\n * functions. Pair with the generated data client for clean, testable handlers.\n */\n\n// Side effect: auto-start OpenTelemetry when OTEL_* env is configured. Runs in the\n// app's code context (where OTel deps resolve), so no NODE_OPTIONS preload is needed.\nimport '../instrument.js';\n\nexport {\n createApp,\n HttpError,\n notFound,\n badRequest,\n forbidden,\n conflict,\n} from './router.js';\nexport type {\n App,\n AppOptions,\n Handler,\n RouteContext,\n FnContext,\n FnRequest,\n FnResponse,\n} from './router.js';\n\nexport { mountCrud } from './crud.js';\nexport type { CrudOptions, RepoLike } from './crud.js';\n","/**\n * OpenTelemetry bootstrap for revenexx App functions.\n *\n * Loaded automatically as a side effect of importing `@revenexx/app-sdk/router`\n * (the app requires the router from its own code dir, so OTel deps resolve).\n * Do NOT preload via `NODE_OPTIONS=--require` in open-runtimes: that runs in the\n * runtime server's node process, which cannot resolve the app's node_modules and\n * crashes the runtime.\n *\n * Configuration is 100% standard `OTEL_*` env; with no OTLP endpoint set it is a\n * cheap no-op (the heavy OTel packages aren't even loaded):\n * OTEL_EXPORTER_OTLP_ENDPOINT https://traces.revenexx.com\n * OTEL_EXPORTER_OTLP_HEADERS Authorization=Basic <base64>\n * OTEL_SERVICE_NAME products\n * OTEL_RESOURCE_ATTRIBUTES service.namespace=revenue-cloud,deployment.environment=prod\n *\n * Lean: only outbound undici/fetch (the PostgREST data plane) is auto-instrumented.\n * The per-invocation SERVER span is added by the router (createApp).\n */\n\nlet started = false;\n\n/**\n * Start OpenTelemetry once. Safe to call repeatedly. NEVER throws — a telemetry\n * failure must not take the function down (a missing trace beats a dead runtime).\n */\nexport async function startTelemetry(): Promise<void> {\n if (started) {\n return;\n }\n started = true;\n\n const endpoint =\n process.env['OTEL_EXPORTER_OTLP_TRACES_ENDPOINT'] ?? process.env['OTEL_EXPORTER_OTLP_ENDPOINT'] ?? '';\n if (!endpoint) {\n return; // tracing disabled — don't even load the OTel packages\n }\n\n try {\n const [{ NodeSDK }, { OTLPTraceExporter }, { UndiciInstrumentation }] = await Promise.all([\n import('@opentelemetry/sdk-node'),\n import('@opentelemetry/exporter-trace-otlp-proto'),\n import('@opentelemetry/instrumentation-undici'),\n ]);\n\n // Exporter + resource (service.name, resource attrs) are read from OTEL_* env.\n const sdk = new NodeSDK({\n traceExporter: new OTLPTraceExporter(),\n instrumentations: [new UndiciInstrumentation()],\n });\n\n sdk.start();\n\n const flush = (): void => {\n void sdk.shutdown().catch(() => {\n /* best effort */\n });\n };\n process.once('SIGTERM', flush);\n process.once('SIGINT', flush);\n } catch (err) {\n // eslint-disable-next-line no-console\n console.error(\n '[app-sdk] OpenTelemetry init failed, continuing without tracing:',\n err instanceof Error ? err.message : err,\n );\n }\n}\n\n// Auto-start on import (side effect). Fire-and-forget; never blocks or throws.\nvoid startTelemetry();\n","/**\n * Minimal HTTP router for revenexx App functions.\n *\n * App functions receive a single invocation context ({ req, res, log, error })\n * and are expected to answer every route the App's manifest declares. This\n * router turns that into declarative, testable handlers:\n *\n * const app = createApp({ name: 'markets' });\n * app.get('/markets', (c) => c.json({ items: [] }));\n * app.get('/markets/{id}', (c) => c.json({ id: c.params.id }));\n * module.exports = app.handler();\n *\n * Matching is literal-first: `/markets/locales` always wins over\n * `/markets/{id}` regardless of registration order. Path templates use the\n * same `{param}` syntax as manifest capability routes (`:param` also works).\n */\n\nimport {\n trace,\n context as otelContext,\n propagation,\n SpanKind,\n SpanStatusCode,\n type Span,\n type TextMapGetter,\n} from '@opentelemetry/api';\n\nexport interface FnRequest {\n method?: string;\n path?: string;\n url?: string;\n headers?: Record<string, string>;\n query?: Record<string, unknown>;\n body?: unknown;\n bodyText?: string;\n bodyRaw?: string;\n}\n\nexport interface FnResponse {\n json(data: unknown, statusCode?: number, headers?: Record<string, string>): unknown;\n send?(body: string, statusCode?: number, headers?: Record<string, string>): unknown;\n}\n\n/** The invocation context an App function receives from the runtime. */\nexport interface FnContext {\n req: FnRequest;\n res: FnResponse;\n log?: (message: string) => void;\n error?: (message: string) => void;\n}\n\n/** Per-request context handed to route handlers. */\nexport interface RouteContext {\n /** Raw invocation context (escape hatch). */\n ctx: FnContext;\n req: FnRequest;\n method: string;\n /** Normalised path (no trailing slash, no query string). */\n path: string;\n /** Path parameters from the matched route template (e.g. `{id}`). */\n params: Record<string, string>;\n /** Query string parameters (string values). */\n query: Record<string, string>;\n /** Parsed JSON body, or `{}` when absent/unparsable. */\n body: Record<string, unknown>;\n /** Tenant slug from the `x-revenexx-tenant` header (or token claim). */\n tenant: string | null;\n /** The forwarded identity token (`x-revenexx-context`), if present. */\n contextToken: string;\n /** Case-insensitive header lookup. */\n header(name: string): string;\n log(message: string): void;\n /** Respond with JSON. Returning `c.json(...)` ends the request. */\n json(data: unknown, statusCode?: number): unknown;\n}\n\nexport type Handler = (c: RouteContext) => unknown | Promise<unknown>;\n\n/** Throw inside a handler to answer with a specific HTTP status. */\nexport class HttpError extends Error {\n readonly status: number;\n readonly details?: unknown;\n constructor(status: number, message: string, details?: unknown) {\n super(message);\n this.name = 'HttpError';\n this.status = status;\n this.details = details;\n }\n}\n\nexport const notFound = (message = 'not found'): HttpError => new HttpError(404, message);\nexport const badRequest = (message = 'bad request', details?: unknown): HttpError =>\n new HttpError(400, message, details);\nexport const forbidden = (message = 'forbidden'): HttpError => new HttpError(403, message);\nexport const conflict = (message = 'conflict'): HttpError => new HttpError(409, message);\n\ninterface Segment {\n lit?: string;\n param?: string;\n}\n\ninterface CompiledRoute {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler;\n}\n\nconst splitPath = (path: string): string[] => path.split('/').filter(Boolean);\n\nfunction compileTemplate(template: string): Segment[] {\n return splitPath(template).map((seg) => {\n const braced = /^\\{([A-Za-z_][A-Za-z0-9_]*)\\}$/.exec(seg);\n if (braced) return { param: braced[1] };\n if (seg.startsWith(':') && seg.length > 1) return { param: seg.slice(1) };\n return { lit: seg };\n });\n}\n\nfunction matchSegments(segments: Segment[], reqSegs: string[]): Record<string, string> | null {\n if (segments.length !== reqSegs.length) return null;\n const params: Record<string, string> = {};\n for (let i = 0; i < segments.length; i++) {\n const s = segments[i]!;\n if (s.param) params[s.param] = decodeURIComponent(reqSegs[i]!);\n else if (s.lit !== reqSegs[i]) return null;\n }\n return params;\n}\n\nfunction headerOf(headers: Record<string, string> | undefined, name: string): string {\n if (!headers) return '';\n const direct = headers[name] ?? headers[name.toLowerCase()];\n if (typeof direct === 'string') return direct;\n const want = name.toLowerCase();\n for (const [k, v] of Object.entries(headers)) {\n if (k.toLowerCase() === want && typeof v === 'string') return v;\n }\n return '';\n}\n\nfunction decodeClaims(token: string): Record<string, unknown> {\n if (!token || token.split('.').length < 2) return {};\n try {\n const payload = token.split('.')[1]!.replace(/-/g, '+').replace(/_/g, '/');\n const parsed: unknown = JSON.parse(Buffer.from(payload, 'base64').toString('utf8'));\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n}\n\nfunction parseBody(req: FnRequest): Record<string, unknown> {\n const candidate = req.body ?? req.bodyText ?? req.bodyRaw;\n if (candidate == null || candidate === '') return {};\n if (typeof candidate === 'object') return candidate as Record<string, unknown>;\n if (typeof candidate === 'string') {\n try {\n const parsed: unknown = JSON.parse(candidate);\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n }\n return {};\n}\n\nfunction parseQuery(req: FnRequest): Record<string, string> {\n const out: Record<string, string> = {};\n for (const [k, v] of Object.entries(req.query ?? {})) {\n if (typeof v === 'string') out[k] = v;\n else if (v != null) out[k] = String(v);\n }\n return out;\n}\n\nexport interface AppOptions {\n /** App name reported on the built-in health route. */\n name?: string;\n /**\n * Built-in `GET /` health route (default true). Responds with the app\n * identity (from the runtime env), status and the registered routes.\n */\n health?: boolean;\n /** Extra payload merged into the health response. */\n healthExtra?: () => Record<string, unknown>;\n}\n\nexport interface App {\n get(template: string, handler: Handler): App;\n post(template: string, handler: Handler): App;\n put(template: string, handler: Handler): App;\n patch(template: string, handler: Handler): App;\n delete(template: string, handler: Handler): App;\n on(method: string, template: string, handler: Handler): App;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst tracer = trace.getTracer('@revenexx/app-sdk');\n\n/** Case-insensitive W3C trace-context extraction from the function's headers. */\nconst headerGetter: TextMapGetter<Record<string, string>> = {\n keys: (carrier) => Object.keys(carrier ?? {}),\n get: (carrier, key) => headerOf(carrier, key) || undefined,\n};\n\nexport function createApp(options: AppOptions = {}): App {\n const routes: CompiledRoute[] = [];\n const health = options.health !== false;\n\n const app: App = {\n get: (t, h) => app.on('GET', t, h),\n post: (t, h) => app.on('POST', t, h),\n put: (t, h) => app.on('PUT', t, h),\n patch: (t, h) => app.on('PATCH', t, h),\n delete: (t, h) => app.on('DELETE', t, h),\n on(method, template, handler) {\n const segments = compileTemplate(template);\n routes.push({\n method: method.toUpperCase(),\n template,\n segments,\n literals: segments.filter((s) => s.lit !== undefined).length,\n handler,\n });\n // Literal-first: more literal segments = more specific = tried first.\n routes.sort((a, b) => b.literals - a.literals);\n return app;\n },\n routes: () => routes.map((r) => ({ method: r.method, path: r.template })).sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method)),\n handler() {\n return (context: FnContext) => {\n const { req, res } = context;\n const headers = req.headers ?? {};\n const method = (req.method ?? 'GET').toUpperCase();\n const rawPath = String(req.path ?? '/').split('?')[0]!;\n const path = rawPath.replace(/\\/+$/, '') || '/';\n\n // Continue the caller's trace (gateway/site) when a traceparent is forwarded;\n // otherwise this SERVER span roots a fresh trace. Outbound PostgREST fetches\n // become child CLIENT spans via the undici instrumentation (see ./instrument).\n const parentCtx = propagation.extract(otelContext.active(), headers, headerGetter);\n\n return tracer.startActiveSpan(\n `${method} ${path}`,\n { kind: SpanKind.SERVER, attributes: { 'http.request.method': method, 'url.path': path } },\n parentCtx,\n async (span: Span) => {\n const contextToken = headerOf(headers, 'x-revenexx-context');\n const tenant =\n headerOf(headers, 'x-revenexx-tenant') ||\n (decodeClaims(contextToken).tenant_id as string | undefined) ||\n null;\n if (options.name) span.setAttribute('revenexx.app', options.name);\n if (tenant) span.setAttribute('revenexx.tenant', tenant);\n const log = (m: string) => context.log?.(m);\n\n log(`${options.name ?? 'app'} ${method} ${path} — tenant=${tenant ?? 'none'}`);\n\n try {\n if (health && path === '/' && method === 'GET') {\n span.setAttribute('http.route', '/');\n return res.json({\n app: {\n id: process.env.REVENEXX_APP_ID ?? null,\n name: options.name ?? process.env.REVENEXX_APP_NAME ?? null,\n deployment: process.env.REVENEXX_APP_DEPLOYMENT ?? null,\n runtime: `${process.env.REVENEXX_APP_RUNTIME_NAME ?? ''}-${process.env.REVENEXX_APP_RUNTIME_VERSION ?? ''}`,\n },\n status: 'ok',\n routes: app.routes(),\n timestamp: new Date().toISOString(),\n ...(options.healthExtra?.() ?? {}),\n });\n }\n\n const reqSegs = splitPath(path);\n let matched: { route: CompiledRoute; params: Record<string, string> } | null = null;\n let pathExists = false;\n for (const route of routes) {\n const params = matchSegments(route.segments, reqSegs);\n if (!params) continue;\n pathExists = true;\n if (route.method === method) {\n matched = { route, params };\n break;\n }\n }\n\n if (!matched) {\n const status = pathExists ? 405 : 404;\n span.setAttribute('http.response.status_code', status);\n span.setStatus({ code: SpanStatusCode.ERROR, message: pathExists ? 'method not allowed' : 'no route' });\n if (pathExists) {\n return res.json({ error: `method ${method} not allowed for ${path}` }, 405);\n }\n return res.json({ error: `no route for ${method} ${path}`, routes: app.routes() }, 404);\n }\n\n span.updateName(`${method} ${matched.route.template}`);\n span.setAttribute('http.route', matched.route.template);\n\n // Gateway-extracted params (x-capability-params) win over our own match\n // for safety, but they should always agree.\n let gatewayParams: Record<string, string> = {};\n try {\n gatewayParams = JSON.parse(headerOf(headers, 'x-capability-params') || '{}') as Record<string, string>;\n } catch {\n gatewayParams = {};\n }\n\n const c: RouteContext = {\n ctx: context,\n req,\n method,\n path,\n params: { ...matched.params, ...gatewayParams },\n query: parseQuery(req),\n body: parseBody(req),\n tenant,\n contextToken,\n header: (name) => headerOf(headers, name),\n log,\n json: (data, statusCode = 200) => res.json(data, statusCode),\n };\n\n return await matched.route.handler(c);\n } catch (err) {\n if (err instanceof HttpError) {\n span.setAttribute('http.response.status_code', err.status);\n if (err.status >= 500) span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });\n return res.json({ error: err.message, ...(err.details != null ? { details: err.details } : {}) }, err.status);\n }\n const msg = err instanceof Error ? err.message : String(err);\n if (/not permitted/.test(msg)) {\n span.setAttribute('http.response.status_code', 403);\n return res.json({ error: msg }, 403);\n }\n span.recordException(err instanceof Error ? err : new Error(msg));\n span.setStatus({ code: SpanStatusCode.ERROR, message: msg });\n context.error?.(`unhandled error on ${method} ${path}: ${msg}`);\n return res.json({ error: msg }, 500);\n } finally {\n span.end();\n }\n },\n );\n };\n },\n };\n\n return app;\n}\n","/**\n * CRUD route mounting: wire a generated entity client to REST routes in one\n * call, with the platform's standard list/get/create/update/delete semantics.\n *\n * const app = createApp({ name: 'markets' });\n * const db = createDb({ adapter: 'runtime', context });\n *\n * mountCrud(app, db.markets, { path: '/markets', columns: ENTITIES.markets.columns });\n * mountCrud(app, db.locales, {\n * path: '/markets/{marketId}/locales',\n * columns: ENTITIES.locales.columns,\n * parent: { param: 'marketId', column: 'market_id' },\n * });\n *\n * Nested resources (a `parent` option) scope every operation to the parent row:\n * lists filter by the parent column, creates inject it, and reads/writes 404\n * when the row belongs to a different parent.\n */\n\nimport type { Page, Query, Row } from '../types.js';\nimport { HttpError, notFound, type App, type RouteContext } from './router.js';\n\n/** Structural subset of the SDK's EntityClient — any compatible repo works. */\nexport interface RepoLike {\n list(query?: Query): Promise<Row[]>;\n page?(query?: Query): Promise<Page>;\n get(id: string | number): Promise<Row | null>;\n create(data: Row): Promise<Row>;\n update(id: string | number, patch: Row): Promise<Row>;\n delete(id: string | number): Promise<void>;\n}\n\nexport interface CrudOptions {\n /** Route base path, e.g. `/markets` or `/markets/{marketId}/locales`. */\n path: string;\n /** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */\n columns?: Record<string, unknown>;\n /** Nested-resource scoping: path param name + the FK column it maps to. */\n parent?: { param: string; column: string };\n /** Path param for the row id (default `id`). */\n idParam?: string;\n /** Pagination bounds for list (defaults: 50, max 200). */\n defaultLimit?: number;\n maxLimit?: number;\n /** Restrict which routes are mounted (default: all five). */\n only?: ('list' | 'get' | 'create' | 'update' | 'delete')[];\n}\n\nconst INT = (v: unknown, d: number): number => {\n const n = parseInt(String(v), 10);\n return Number.isFinite(n) ? n : d;\n};\n\nfunction parentWhere(c: RouteContext, parent?: CrudOptions['parent']): Record<string, string> {\n if (!parent) return {};\n const value = c.params[parent.param];\n if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);\n return { [parent.column]: value };\n}\n\n/** Fetch a row and enforce nested-parent ownership; throws 404 when absent. */\nasync function fetchOwned(\n repo: RepoLike,\n c: RouteContext,\n opts: CrudOptions,\n): Promise<{ id: string; row: Row }> {\n const id = c.params[opts.idParam ?? 'id'] ?? '';\n if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? 'id'}'`);\n const row = await repo.get(id);\n if (!row) throw notFound();\n if (opts.parent) {\n const expected = c.params[opts.parent.param];\n if (String(row[opts.parent.column] ?? '') !== String(expected ?? '')) throw notFound();\n }\n return { id, row };\n}\n\nexport function mountCrud(app: App, repo: RepoLike, opts: CrudOptions): App {\n const base = opts.path.replace(/\\/+$/, '');\n const idTemplate = `${base}/{${opts.idParam ?? 'id'}}`;\n const enabled = new Set(opts.only ?? ['list', 'get', 'create', 'update', 'delete']);\n const defaultLimit = opts.defaultLimit ?? 50;\n const maxLimit = opts.maxLimit ?? 200;\n\n if (enabled.has('list')) {\n app.get(base, async (c) => {\n const where: Record<string, string> = {};\n for (const [k, v] of Object.entries(c.query)) {\n if (opts.columns && k in opts.columns) where[k] = v;\n }\n // The nested-parent filter always wins — a query param must not widen\n // the scope beyond the parent in the path.\n Object.assign(where, parentWhere(c, opts.parent));\n const limit = Math.min(Math.max(INT(c.query.limit, defaultLimit), 1), maxLimit);\n const offset = Math.max(INT(c.query.offset, 0), 0);\n const order = typeof c.query.order === 'string' && c.query.order ? c.query.order : undefined;\n const query: Query = { where, limit, offset, ...(order ? { order } : {}) };\n\n if (repo.page) {\n const { items, total } = await repo.page(query);\n return c.json({\n items,\n page: { limit, offset, total, returned: items.length, hasMore: offset + items.length < total },\n filter: where,\n });\n }\n const items = await repo.list(query);\n return c.json({ items, page: { limit, offset, returned: items.length }, filter: where });\n });\n }\n\n if (enabled.has('create')) {\n app.post(base, async (c) => {\n const data = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.create(data), 201);\n });\n }\n\n if (enabled.has('get')) {\n app.get(idTemplate, async (c) => {\n const { row } = await fetchOwned(repo, c, opts);\n return c.json(row);\n });\n }\n\n if (enabled.has('update')) {\n app.put(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n // Never let a body overwrite the nested-parent FK.\n const patch = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.update(id, patch));\n });\n }\n\n if (enabled.has('delete')) {\n app.delete(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n await repo.delete(id);\n return c.json({ deleted: true, id });\n });\n }\n\n return app;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACoBA,IAAI,UAAU;AAMd,eAAsB,iBAAgC;AACpD,MAAI,SAAS;AACX;AAAA,EACF;AACA,YAAU;AAEV,QAAM,WACJ,QAAQ,IAAI,oCAAoC,KAAK,QAAQ,IAAI,6BAA6B,KAAK;AACrG,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,MAAI;AACF,UAAM,CAAC,EAAE,QAAQ,GAAG,EAAE,kBAAkB,GAAG,EAAE,sBAAsB,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,MACxF,OAAO,yBAAyB;AAAA,MAChC,OAAO,0CAA0C;AAAA,MACjD,OAAO,uCAAuC;AAAA,IAChD,CAAC;AAGD,UAAM,MAAM,IAAI,QAAQ;AAAA,MACtB,eAAe,IAAI,kBAAkB;AAAA,MACrC,kBAAkB,CAAC,IAAI,sBAAsB,CAAC;AAAA,IAChD,CAAC;AAED,QAAI,MAAM;AAEV,UAAM,QAAQ,MAAY;AACxB,WAAK,IAAI,SAAS,EAAE,MAAM,MAAM;AAAA,MAEhC,CAAC;AAAA,IACH;AACA,YAAQ,KAAK,WAAW,KAAK;AAC7B,YAAQ,KAAK,UAAU,KAAK;AAAA,EAC9B,SAAS,KAAK;AAEZ,YAAQ;AAAA,MACN;AAAA,MACA,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;AAGA,KAAK,eAAe;;;ACrDpB,iBAQO;AAsDA,IAAM,YAAN,cAAwB,MAAM;AAAA,EAC1B;AAAA,EACA;AAAA,EACT,YAAY,QAAgB,SAAiB,SAAmB;AAC9D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,SAAK,UAAU;AAAA,EACjB;AACF;AAEO,IAAM,WAAW,CAAC,UAAU,gBAA2B,IAAI,UAAU,KAAK,OAAO;AACjF,IAAM,aAAa,CAAC,UAAU,eAAe,YAClD,IAAI,UAAU,KAAK,SAAS,OAAO;AAC9B,IAAM,YAAY,CAAC,UAAU,gBAA2B,IAAI,UAAU,KAAK,OAAO;AAClF,IAAM,WAAW,CAAC,UAAU,eAA0B,IAAI,UAAU,KAAK,OAAO;AAevF,IAAM,YAAY,CAAC,SAA2B,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAE5E,SAAS,gBAAgB,UAA6B;AACpD,SAAO,UAAU,QAAQ,EAAE,IAAI,CAAC,QAAQ;AACtC,UAAM,SAAS,iCAAiC,KAAK,GAAG;AACxD,QAAI,OAAQ,QAAO,EAAE,OAAO,OAAO,CAAC,EAAE;AACtC,QAAI,IAAI,WAAW,GAAG,KAAK,IAAI,SAAS,EAAG,QAAO,EAAE,OAAO,IAAI,MAAM,CAAC,EAAE;AACxE,WAAO,EAAE,KAAK,IAAI;AAAA,EACpB,CAAC;AACH;AAEA,SAAS,cAAc,UAAqB,SAAkD;AAC5F,MAAI,SAAS,WAAW,QAAQ,OAAQ,QAAO;AAC/C,QAAM,SAAiC,CAAC;AACxC,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,UAAM,IAAI,SAAS,CAAC;AACpB,QAAI,EAAE,MAAO,QAAO,EAAE,KAAK,IAAI,mBAAmB,QAAQ,CAAC,CAAE;AAAA,aACpD,EAAE,QAAQ,QAAQ,CAAC,EAAG,QAAO;AAAA,EACxC;AACA,SAAO;AACT;AAEA,SAAS,SAAS,SAA6C,MAAsB;AACnF,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAAS,QAAQ,IAAI,KAAK,QAAQ,KAAK,YAAY,CAAC;AAC1D,MAAI,OAAO,WAAW,SAAU,QAAO;AACvC,QAAM,OAAO,KAAK,YAAY;AAC9B,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,OAAO,GAAG;AAC5C,QAAI,EAAE,YAAY,MAAM,QAAQ,OAAO,MAAM,SAAU,QAAO;AAAA,EAChE;AACA,SAAO;AACT;AAEA,SAAS,aAAa,OAAwC;AAC5D,MAAI,CAAC,SAAS,MAAM,MAAM,GAAG,EAAE,SAAS,EAAG,QAAO,CAAC;AACnD,MAAI;AACF,UAAM,UAAU,MAAM,MAAM,GAAG,EAAE,CAAC,EAAG,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG;AACzE,UAAM,SAAkB,KAAK,MAAM,OAAO,KAAK,SAAS,QAAQ,EAAE,SAAS,MAAM,CAAC;AAClF,WAAO,UAAU,OAAO,WAAW,WAAY,SAAqC,CAAC;AAAA,EACvF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,SAAS,UAAU,KAAyC;AAC1D,QAAM,YAAY,IAAI,QAAQ,IAAI,YAAY,IAAI;AAClD,MAAI,aAAa,QAAQ,cAAc,GAAI,QAAO,CAAC;AACnD,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,MAAI,OAAO,cAAc,UAAU;AACjC,QAAI;AACF,YAAM,SAAkB,KAAK,MAAM,SAAS;AAC5C,aAAO,UAAU,OAAO,WAAW,WAAY,SAAqC,CAAC;AAAA,IACvF,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACA,SAAO,CAAC;AACV;AAEA,SAAS,WAAW,KAAwC;AAC1D,QAAM,MAA8B,CAAC;AACrC,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAAI,SAAS,CAAC,CAAC,GAAG;AACpD,QAAI,OAAO,MAAM,SAAU,KAAI,CAAC,IAAI;AAAA,aAC3B,KAAK,KAAM,KAAI,CAAC,IAAI,OAAO,CAAC;AAAA,EACvC;AACA,SAAO;AACT;AA2BA,IAAM,SAAS,iBAAM,UAAU,mBAAmB;AAGlD,IAAM,eAAsD;AAAA,EAC1D,MAAM,CAAC,YAAY,OAAO,KAAK,WAAW,CAAC,CAAC;AAAA,EAC5C,KAAK,CAAC,SAAS,QAAQ,SAAS,SAAS,GAAG,KAAK;AACnD;AAEO,SAAS,UAAU,UAAsB,CAAC,GAAQ;AACvD,QAAM,SAA0B,CAAC;AACjC,QAAM,SAAS,QAAQ,WAAW;AAElC,QAAM,MAAW;AAAA,IACf,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC;AAAA,IACjC,MAAM,CAAC,GAAG,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC;AAAA,IACnC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC;AAAA,IACjC,OAAO,CAAC,GAAG,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC;AAAA,IACrC,QAAQ,CAAC,GAAG,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC;AAAA,IACvC,GAAG,QAAQ,UAAU,SAAS;AAC5B,YAAM,WAAW,gBAAgB,QAAQ;AACzC,aAAO,KAAK;AAAA,QACV,QAAQ,OAAO,YAAY;AAAA,QAC3B;AAAA,QACA;AAAA,QACA,UAAU,SAAS,OAAO,CAAC,MAAM,EAAE,QAAQ,MAAS,EAAE;AAAA,QACtD;AAAA,MACF,CAAC;AAED,aAAO,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAC7C,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,MAAM,CAAC;AAAA,IACzJ,UAAU;AACR,aAAO,CAAC,YAAuB;AAC7B,cAAM,EAAE,KAAK,IAAI,IAAI;AACrB,cAAM,UAAU,IAAI,WAAW,CAAC;AAChC,cAAM,UAAU,IAAI,UAAU,OAAO,YAAY;AACjD,cAAM,UAAU,OAAO,IAAI,QAAQ,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC;AACpD,cAAM,OAAO,QAAQ,QAAQ,QAAQ,EAAE,KAAK;AAK5C,cAAM,YAAY,uBAAY,QAAQ,WAAAA,QAAY,OAAO,GAAG,SAAS,YAAY;AAEjF,eAAO,OAAO;AAAA,UACZ,GAAG,MAAM,IAAI,IAAI;AAAA,UACjB,EAAE,MAAM,oBAAS,QAAQ,YAAY,EAAE,uBAAuB,QAAQ,YAAY,KAAK,EAAE;AAAA,UACzF;AAAA,UACA,OAAO,SAAe;AACpB,kBAAM,eAAe,SAAS,SAAS,oBAAoB;AAC3D,kBAAM,SACJ,SAAS,SAAS,mBAAmB,KACpC,aAAa,YAAY,EAAE,aAC5B;AACF,gBAAI,QAAQ,KAAM,MAAK,aAAa,gBAAgB,QAAQ,IAAI;AAChE,gBAAI,OAAQ,MAAK,aAAa,mBAAmB,MAAM;AACvD,kBAAM,MAAM,CAAC,MAAc,QAAQ,MAAM,CAAC;AAE1C,gBAAI,GAAG,QAAQ,QAAQ,KAAK,IAAI,MAAM,IAAI,IAAI,kBAAa,UAAU,MAAM,EAAE;AAE7E,gBAAI;AACF,kBAAI,UAAU,SAAS,OAAO,WAAW,OAAO;AAC9C,qBAAK,aAAa,cAAc,GAAG;AACnC,uBAAO,IAAI,KAAK;AAAA,kBACd,KAAK;AAAA,oBACH,IAAI,QAAQ,IAAI,mBAAmB;AAAA,oBACnC,MAAM,QAAQ,QAAQ,QAAQ,IAAI,qBAAqB;AAAA,oBACvD,YAAY,QAAQ,IAAI,2BAA2B;AAAA,oBACnD,SAAS,GAAG,QAAQ,IAAI,6BAA6B,EAAE,IAAI,QAAQ,IAAI,gCAAgC,EAAE;AAAA,kBAC3G;AAAA,kBACA,QAAQ;AAAA,kBACR,QAAQ,IAAI,OAAO;AAAA,kBACnB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,kBAClC,GAAI,QAAQ,cAAc,KAAK,CAAC;AAAA,gBAClC,CAAC;AAAA,cACH;AAEA,oBAAM,UAAU,UAAU,IAAI;AAC9B,kBAAI,UAA2E;AAC/E,kBAAI,aAAa;AACjB,yBAAW,SAAS,QAAQ;AAC1B,sBAAM,SAAS,cAAc,MAAM,UAAU,OAAO;AACpD,oBAAI,CAAC,OAAQ;AACb,6BAAa;AACb,oBAAI,MAAM,WAAW,QAAQ;AAC3B,4BAAU,EAAE,OAAO,OAAO;AAC1B;AAAA,gBACF;AAAA,cACF;AAEA,kBAAI,CAAC,SAAS;AACZ,sBAAM,SAAS,aAAa,MAAM;AAClC,qBAAK,aAAa,6BAA6B,MAAM;AACrD,qBAAK,UAAU,EAAE,MAAM,0BAAe,OAAO,SAAS,aAAa,uBAAuB,WAAW,CAAC;AACtG,oBAAI,YAAY;AACd,yBAAO,IAAI,KAAK,EAAE,OAAO,UAAU,MAAM,oBAAoB,IAAI,GAAG,GAAG,GAAG;AAAA,gBAC5E;AACA,uBAAO,IAAI,KAAK,EAAE,OAAO,gBAAgB,MAAM,IAAI,IAAI,IAAI,QAAQ,IAAI,OAAO,EAAE,GAAG,GAAG;AAAA,cACxF;AAEA,mBAAK,WAAW,GAAG,MAAM,IAAI,QAAQ,MAAM,QAAQ,EAAE;AACrD,mBAAK,aAAa,cAAc,QAAQ,MAAM,QAAQ;AAItD,kBAAI,gBAAwC,CAAC;AAC7C,kBAAI;AACF,gCAAgB,KAAK,MAAM,SAAS,SAAS,qBAAqB,KAAK,IAAI;AAAA,cAC7E,QAAQ;AACN,gCAAgB,CAAC;AAAA,cACnB;AAEA,oBAAM,IAAkB;AAAA,gBACtB,KAAK;AAAA,gBACL;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA,QAAQ,EAAE,GAAG,QAAQ,QAAQ,GAAG,cAAc;AAAA,gBAC9C,OAAO,WAAW,GAAG;AAAA,gBACrB,MAAM,UAAU,GAAG;AAAA,gBACnB;AAAA,gBACA;AAAA,gBACA,QAAQ,CAAC,SAAS,SAAS,SAAS,IAAI;AAAA,gBACxC;AAAA,gBACA,MAAM,CAAC,MAAM,aAAa,QAAQ,IAAI,KAAK,MAAM,UAAU;AAAA,cAC7D;AAEA,qBAAO,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,YACtC,SAAS,KAAK;AACZ,kBAAI,eAAe,WAAW;AAC5B,qBAAK,aAAa,6BAA6B,IAAI,MAAM;AACzD,oBAAI,IAAI,UAAU,IAAK,MAAK,UAAU,EAAE,MAAM,0BAAe,OAAO,SAAS,IAAI,QAAQ,CAAC;AAC1F,uBAAO,IAAI,KAAK,EAAE,OAAO,IAAI,SAAS,GAAI,IAAI,WAAW,OAAO,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC,EAAG,GAAG,IAAI,MAAM;AAAA,cAC9G;AACA,oBAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,kBAAI,gBAAgB,KAAK,GAAG,GAAG;AAC7B,qBAAK,aAAa,6BAA6B,GAAG;AAClD,uBAAO,IAAI,KAAK,EAAE,OAAO,IAAI,GAAG,GAAG;AAAA,cACrC;AACA,mBAAK,gBAAgB,eAAe,QAAQ,MAAM,IAAI,MAAM,GAAG,CAAC;AAChE,mBAAK,UAAU,EAAE,MAAM,0BAAe,OAAO,SAAS,IAAI,CAAC;AAC3D,sBAAQ,QAAQ,sBAAsB,MAAM,IAAI,IAAI,KAAK,GAAG,EAAE;AAC9D,qBAAO,IAAI,KAAK,EAAE,OAAO,IAAI,GAAG,GAAG;AAAA,YACrC,UAAE;AACA,mBAAK,IAAI;AAAA,YACX;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;ACpTA,IAAM,MAAM,CAAC,GAAY,MAAsB;AAC7C,QAAM,IAAI,SAAS,OAAO,CAAC,GAAG,EAAE;AAChC,SAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAClC;AAEA,SAAS,YAAY,GAAiB,QAAwD;AAC5F,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,QAAM,QAAQ,EAAE,OAAO,OAAO,KAAK;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,UAAU,KAAK,2BAA2B,OAAO,KAAK,GAAG;AAC/E,SAAO,EAAE,CAAC,OAAO,MAAM,GAAG,MAAM;AAClC;AAGA,eAAe,WACb,MACA,GACA,MACmC;AACnC,QAAM,KAAK,EAAE,OAAO,KAAK,WAAW,IAAI,KAAK;AAC7C,MAAI,CAAC,GAAI,OAAM,IAAI,UAAU,KAAK,2BAA2B,KAAK,WAAW,IAAI,GAAG;AACpF,QAAM,MAAM,MAAM,KAAK,IAAI,EAAE;AAC7B,MAAI,CAAC,IAAK,OAAM,SAAS;AACzB,MAAI,KAAK,QAAQ;AACf,UAAM,WAAW,EAAE,OAAO,KAAK,OAAO,KAAK;AAC3C,QAAI,OAAO,IAAI,KAAK,OAAO,MAAM,KAAK,EAAE,MAAM,OAAO,YAAY,EAAE,EAAG,OAAM,SAAS;AAAA,EACvF;AACA,SAAO,EAAE,IAAI,IAAI;AACnB;AAEO,SAAS,UAAU,KAAU,MAAgB,MAAwB;AAC1E,QAAM,OAAO,KAAK,KAAK,QAAQ,QAAQ,EAAE;AACzC,QAAM,aAAa,GAAG,IAAI,KAAK,KAAK,WAAW,IAAI;AACnD,QAAM,UAAU,IAAI,IAAI,KAAK,QAAQ,CAAC,QAAQ,OAAO,UAAU,UAAU,QAAQ,CAAC;AAClF,QAAM,eAAe,KAAK,gBAAgB;AAC1C,QAAM,WAAW,KAAK,YAAY;AAElC,MAAI,QAAQ,IAAI,MAAM,GAAG;AACvB,QAAI,IAAI,MAAM,OAAO,MAAM;AACzB,YAAM,QAAgC,CAAC;AACvC,iBAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,EAAE,KAAK,GAAG;AAC5C,YAAI,KAAK,WAAW,KAAK,KAAK,QAAS,OAAM,CAAC,IAAI;AAAA,MACpD;AAGA,aAAO,OAAO,OAAO,YAAY,GAAG,KAAK,MAAM,CAAC;AAChD,YAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE,MAAM,OAAO,YAAY,GAAG,CAAC,GAAG,QAAQ;AAC9E,YAAM,SAAS,KAAK,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC;AACjD,YAAM,QAAQ,OAAO,EAAE,MAAM,UAAU,YAAY,EAAE,MAAM,QAAQ,EAAE,MAAM,QAAQ;AACnF,YAAM,QAAe,EAAE,OAAO,OAAO,QAAQ,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG;AAEzE,UAAI,KAAK,MAAM;AACb,cAAM,EAAE,OAAAC,QAAO,MAAM,IAAI,MAAM,KAAK,KAAK,KAAK;AAC9C,eAAO,EAAE,KAAK;AAAA,UACZ,OAAAA;AAAA,UACA,MAAM,EAAE,OAAO,QAAQ,OAAO,UAAUA,OAAM,QAAQ,SAAS,SAASA,OAAM,SAAS,MAAM;AAAA,UAC7F,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AACA,YAAM,QAAQ,MAAM,KAAK,KAAK,KAAK;AACnC,aAAO,EAAE,KAAK,EAAE,OAAO,MAAM,EAAE,OAAO,QAAQ,UAAU,MAAM,OAAO,GAAG,QAAQ,MAAM,CAAC;AAAA,IACzF,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,KAAK,MAAM,OAAO,MAAM;AAC1B,YAAM,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,MAAM,EAAE;AACzD,aAAO,EAAE,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG,GAAG;AAAA,IAC5C,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,KAAK,GAAG;AACtB,QAAI,IAAI,YAAY,OAAO,MAAM;AAC/B,YAAM,EAAE,IAAI,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAC9C,aAAO,EAAE,KAAK,GAAG;AAAA,IACnB,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,IAAI,YAAY,OAAO,MAAM;AAC/B,YAAM,EAAE,GAAG,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAE7C,YAAM,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,MAAM,EAAE;AAC1D,aAAO,EAAE,KAAK,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC;AAAA,IAC5C,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,OAAO,YAAY,OAAO,MAAM;AAClC,YAAM,EAAE,GAAG,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAC7C,YAAM,KAAK,OAAO,EAAE;AACpB,aAAO,EAAE,KAAK,EAAE,SAAS,MAAM,GAAG,CAAC;AAAA,IACrC,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":["otelContext","items"]}
|
|
1
|
+
{"version":3,"sources":["../../src/router/index.ts","../../src/instrument.ts","../../src/router/router.ts","../../src/errors.ts","../../src/router/crud.ts"],"sourcesContent":["/**\n * @revenexx/app-sdk/router — declarative HTTP routing for revenexx App\n * functions. Pair with the generated data client for clean, testable handlers.\n */\n\n// Side effect: auto-start OpenTelemetry when OTEL_* env is configured. Runs in the\n// app's code context (where OTel deps resolve), so no NODE_OPTIONS preload is needed.\nimport '../instrument.js';\n\nexport {\n createApp,\n HttpError,\n isHttpError,\n notFound,\n badRequest,\n forbidden,\n conflict,\n} from './router.js';\nexport type {\n HttpErrorOptions,\n App,\n AppOptions,\n Handler,\n RouteContext,\n FnContext,\n FnRequest,\n FnResponse,\n} from './router.js';\n\nexport { mountCrud } from './crud.js';\nexport type { CrudOptions, RepoLike } from './crud.js';\n","/**\n * OpenTelemetry bootstrap for revenexx App functions.\n *\n * Loaded automatically as a side effect of importing `@revenexx/app-sdk/router`\n * (the app requires the router from its own code dir, so OTel deps resolve).\n * Do NOT preload via `NODE_OPTIONS=--require` in open-runtimes: that runs in the\n * runtime server's node process, which cannot resolve the app's node_modules and\n * crashes the runtime.\n *\n * Configuration is 100% standard `OTEL_*` env; with no OTLP endpoint set it is a\n * cheap no-op (the heavy OTel packages aren't even loaded):\n * OTEL_EXPORTER_OTLP_ENDPOINT https://traces.revenexx.com\n * OTEL_EXPORTER_OTLP_HEADERS Authorization=Basic <base64>\n * OTEL_SERVICE_NAME products\n * OTEL_RESOURCE_ATTRIBUTES service.namespace=revenue-cloud,deployment.environment=prod\n *\n * Lean: only outbound undici/fetch (the PostgREST data plane) is auto-instrumented.\n * The per-invocation SERVER span is added by the router (createApp).\n */\n\nlet started = false;\n\n/**\n * Start OpenTelemetry once. Safe to call repeatedly. NEVER throws — a telemetry\n * failure must not take the function down (a missing trace beats a dead runtime).\n */\nexport async function startTelemetry(): Promise<void> {\n if (started) {\n return;\n }\n started = true;\n\n const endpoint =\n process.env['OTEL_EXPORTER_OTLP_TRACES_ENDPOINT'] ?? process.env['OTEL_EXPORTER_OTLP_ENDPOINT'] ?? '';\n if (!endpoint) {\n return; // tracing disabled — don't even load the OTel packages\n }\n\n try {\n const [{ NodeSDK }, { OTLPTraceExporter }, { UndiciInstrumentation }] = await Promise.all([\n import('@opentelemetry/sdk-node'),\n import('@opentelemetry/exporter-trace-otlp-proto'),\n import('@opentelemetry/instrumentation-undici'),\n ]);\n\n // Exporter + resource (service.name, resource attrs) are read from OTEL_* env.\n const sdk = new NodeSDK({\n traceExporter: new OTLPTraceExporter(),\n instrumentations: [new UndiciInstrumentation()],\n });\n\n sdk.start();\n\n const flush = (): void => {\n void sdk.shutdown().catch(() => {\n /* best effort */\n });\n };\n process.once('SIGTERM', flush);\n process.once('SIGINT', flush);\n } catch (err) {\n // eslint-disable-next-line no-console\n console.error(\n '[app-sdk] OpenTelemetry init failed, continuing without tracing:',\n err instanceof Error ? err.message : err,\n );\n }\n}\n\n// Auto-start on import (side effect). Fire-and-forget; never blocks or throws.\nvoid startTelemetry();\n","/**\n * Minimal HTTP router for revenexx App functions.\n *\n * App functions receive a single invocation context ({ req, res, log, error })\n * and are expected to answer every route the App's manifest declares. This\n * router turns that into declarative, testable handlers:\n *\n * const app = createApp({ name: 'markets' });\n * app.get('/markets', (c) => c.json({ items: [] }));\n * app.get('/markets/{id}', (c) => c.json({ id: c.params.id }));\n * module.exports = app.handler();\n *\n * Matching is literal-first: `/markets/locales` always wins over\n * `/markets/{id}` regardless of registration order. Path templates use the\n * same `{param}` syntax as manifest capability routes (`:param` also works).\n */\n\nimport {\n trace,\n context as otelContext,\n propagation,\n SpanKind,\n SpanStatusCode,\n type Span,\n type TextMapGetter,\n} from '@opentelemetry/api';\n\nexport interface FnRequest {\n method?: string;\n path?: string;\n url?: string;\n headers?: Record<string, string>;\n query?: Record<string, unknown>;\n body?: unknown;\n bodyText?: string;\n bodyRaw?: string;\n}\n\nexport interface FnResponse {\n json(data: unknown, statusCode?: number, headers?: Record<string, string>): unknown;\n send?(body: string, statusCode?: number, headers?: Record<string, string>): unknown;\n}\n\n/** The invocation context an App function receives from the runtime. */\nexport interface FnContext {\n req: FnRequest;\n res: FnResponse;\n log?: (message: string) => void;\n error?: (message: string) => void;\n}\n\n/** Per-request context handed to route handlers. */\nexport interface RouteContext {\n /** Raw invocation context (escape hatch). */\n ctx: FnContext;\n req: FnRequest;\n method: string;\n /** Normalised path (no trailing slash, no query string). */\n path: string;\n /** Path parameters from the matched route template (e.g. `{id}`). */\n params: Record<string, string>;\n /** Query string parameters (string values). */\n query: Record<string, string>;\n /** Parsed JSON body, or `{}` when absent/unparsable. */\n body: Record<string, unknown>;\n /** Tenant slug from the `x-revenexx-tenant` header (or token claim). */\n tenant: string | null;\n /** The forwarded identity token (`x-revenexx-context`), if present. */\n contextToken: string;\n /** Case-insensitive header lookup. */\n header(name: string): string;\n log(message: string): void;\n /** Respond with JSON. Returning `c.json(...)` ends the request. */\n json(data: unknown, statusCode?: number): unknown;\n}\n\nexport type Handler = (c: RouteContext) => unknown | Promise<unknown>;\n\n// `HttpError` lives in ../errors.js so the data adapters can raise it too — a\n// PostgREST unique violation answers 409 without the router guessing from a\n// message string. Re-exported here so `@revenexx/app-sdk/router` is unchanged.\nexport {\n HttpError,\n isHttpError,\n notFound,\n badRequest,\n forbidden,\n conflict,\n type HttpErrorOptions,\n} from '../errors.js';\nimport { isHttpError } from '../errors.js';\n\ninterface Segment {\n lit?: string;\n param?: string;\n}\n\ninterface CompiledRoute {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler;\n}\n\nconst splitPath = (path: string): string[] => path.split('/').filter(Boolean);\n\nfunction compileTemplate(template: string): Segment[] {\n return splitPath(template).map((seg) => {\n const braced = /^\\{([A-Za-z_][A-Za-z0-9_]*)\\}$/.exec(seg);\n if (braced) return { param: braced[1] };\n if (seg.startsWith(':') && seg.length > 1) return { param: seg.slice(1) };\n return { lit: seg };\n });\n}\n\nfunction matchSegments(segments: Segment[], reqSegs: string[]): Record<string, string> | null {\n if (segments.length !== reqSegs.length) return null;\n const params: Record<string, string> = {};\n for (let i = 0; i < segments.length; i++) {\n const s = segments[i]!;\n if (s.param) params[s.param] = decodeURIComponent(reqSegs[i]!);\n else if (s.lit !== reqSegs[i]) return null;\n }\n return params;\n}\n\nfunction headerOf(headers: Record<string, string> | undefined, name: string): string {\n if (!headers) return '';\n const direct = headers[name] ?? headers[name.toLowerCase()];\n if (typeof direct === 'string') return direct;\n const want = name.toLowerCase();\n for (const [k, v] of Object.entries(headers)) {\n if (k.toLowerCase() === want && typeof v === 'string') return v;\n }\n return '';\n}\n\nfunction decodeClaims(token: string): Record<string, unknown> {\n if (!token || token.split('.').length < 2) return {};\n try {\n const payload = token.split('.')[1]!.replace(/-/g, '+').replace(/_/g, '/');\n const parsed: unknown = JSON.parse(Buffer.from(payload, 'base64').toString('utf8'));\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n}\n\nfunction parseBody(req: FnRequest): Record<string, unknown> {\n const candidate = req.body ?? req.bodyText ?? req.bodyRaw;\n if (candidate == null || candidate === '') return {};\n if (typeof candidate === 'object') return candidate as Record<string, unknown>;\n if (typeof candidate === 'string') {\n try {\n const parsed: unknown = JSON.parse(candidate);\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n }\n return {};\n}\n\n/**\n * Request query, percent-DECODED exactly once.\n *\n * `req.path` carries the query string verbatim as the gateway forwarded it, so\n * it is the authoritative source: `URLSearchParams` decodes it once, correctly,\n * and treats `+` as a space the way a form-encoded query requires.\n *\n * The runtime's own `req.query` hands values through *undecoded*. A filter of\n * `?code=m%61in` arrived as the literal `m%61in` and matched nothing, when per\n * RFC 3986 it simply means `main`. That broke every filter value needing an\n * escape — spaces, `&`, `+`, `/`, commas, anything non-ASCII — so \"Müller & Co\"\n * could not be filtered for at all. It also let the gateway's response cache\n * merge two spellings the app answered differently (revenexx/api#32).\n *\n * `req.query` stays the fallback for callers that populate it without a query\n * string on the path (the mock adapter and direct unit tests do this). Decoding\n * that again here would be wrong — a double decode turns `%2520` into a space —\n * so each source is decoded by exactly one owner.\n */\nfunction parseQuery(req: FnRequest): Record<string, string> {\n const out: Record<string, string> = {};\n const rawPath = String(req.path ?? '');\n const qmark = rawPath.indexOf('?');\n if (qmark >= 0) {\n for (const [k, v] of new URLSearchParams(rawPath.slice(qmark + 1))) out[k] = v;\n return out;\n }\n for (const [k, v] of Object.entries(req.query ?? {})) {\n if (typeof v === 'string') out[k] = v;\n else if (v != null) out[k] = String(v);\n }\n return out;\n}\n\nexport interface AppOptions {\n /** App name reported on the built-in health route. */\n name?: string;\n /**\n * Built-in `GET /` health route (default true). Responds with the app\n * identity (from the runtime env), status and the registered routes.\n */\n health?: boolean;\n /** Extra payload merged into the health response. */\n healthExtra?: () => Record<string, unknown>;\n}\n\nexport interface App {\n get(template: string, handler: Handler): App;\n post(template: string, handler: Handler): App;\n put(template: string, handler: Handler): App;\n patch(template: string, handler: Handler): App;\n delete(template: string, handler: Handler): App;\n on(method: string, template: string, handler: Handler): App;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst tracer = trace.getTracer('@revenexx/app-sdk');\n\n/** Case-insensitive W3C trace-context extraction from the function's headers. */\nconst headerGetter: TextMapGetter<Record<string, string>> = {\n keys: (carrier) => Object.keys(carrier ?? {}),\n get: (carrier, key) => headerOf(carrier, key) || undefined,\n};\n\nexport function createApp(options: AppOptions = {}): App {\n const routes: CompiledRoute[] = [];\n const health = options.health !== false;\n\n const app: App = {\n get: (t, h) => app.on('GET', t, h),\n post: (t, h) => app.on('POST', t, h),\n put: (t, h) => app.on('PUT', t, h),\n patch: (t, h) => app.on('PATCH', t, h),\n delete: (t, h) => app.on('DELETE', t, h),\n on(method, template, handler) {\n const segments = compileTemplate(template);\n routes.push({\n method: method.toUpperCase(),\n template,\n segments,\n literals: segments.filter((s) => s.lit !== undefined).length,\n handler,\n });\n // Literal-first: more literal segments = more specific = tried first.\n routes.sort((a, b) => b.literals - a.literals);\n return app;\n },\n routes: () => routes.map((r) => ({ method: r.method, path: r.template })).sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method)),\n handler() {\n return (context: FnContext) => {\n const { req, res } = context;\n const headers = req.headers ?? {};\n const method = (req.method ?? 'GET').toUpperCase();\n const rawPath = String(req.path ?? '/').split('?')[0]!;\n const path = rawPath.replace(/\\/+$/, '') || '/';\n\n // Continue the caller's trace (gateway/site) when a traceparent is forwarded;\n // otherwise this SERVER span roots a fresh trace. Outbound PostgREST fetches\n // become child CLIENT spans via the undici instrumentation (see ./instrument).\n const parentCtx = propagation.extract(otelContext.active(), headers, headerGetter);\n\n return tracer.startActiveSpan(\n `${method} ${path}`,\n { kind: SpanKind.SERVER, attributes: { 'http.request.method': method, 'url.path': path } },\n parentCtx,\n async (span: Span) => {\n const contextToken = headerOf(headers, 'x-revenexx-context');\n const tenant =\n headerOf(headers, 'x-revenexx-tenant') ||\n (decodeClaims(contextToken).tenant_id as string | undefined) ||\n null;\n if (options.name) span.setAttribute('revenexx.app', options.name);\n if (tenant) span.setAttribute('revenexx.tenant', tenant);\n const log = (m: string) => context.log?.(m);\n\n log(`${options.name ?? 'app'} ${method} ${path} — tenant=${tenant ?? 'none'}`);\n\n try {\n if (health && path === '/' && method === 'GET') {\n span.setAttribute('http.route', '/');\n return res.json({\n app: {\n id: process.env.REVENEXX_APP_ID ?? null,\n name: options.name ?? process.env.REVENEXX_APP_NAME ?? null,\n deployment: process.env.REVENEXX_APP_DEPLOYMENT ?? null,\n runtime: `${process.env.REVENEXX_APP_RUNTIME_NAME ?? ''}-${process.env.REVENEXX_APP_RUNTIME_VERSION ?? ''}`,\n },\n status: 'ok',\n routes: app.routes(),\n timestamp: new Date().toISOString(),\n ...(options.healthExtra?.() ?? {}),\n });\n }\n\n const reqSegs = splitPath(path);\n let matched: { route: CompiledRoute; params: Record<string, string> } | null = null;\n let pathExists = false;\n for (const route of routes) {\n const params = matchSegments(route.segments, reqSegs);\n if (!params) continue;\n pathExists = true;\n if (route.method === method) {\n matched = { route, params };\n break;\n }\n }\n\n if (!matched) {\n const status = pathExists ? 405 : 404;\n span.setAttribute('http.response.status_code', status);\n span.setStatus({ code: SpanStatusCode.ERROR, message: pathExists ? 'method not allowed' : 'no route' });\n if (pathExists) {\n return res.json({ error: `method ${method} not allowed for ${path}` }, 405);\n }\n return res.json({ error: `no route for ${method} ${path}`, routes: app.routes() }, 404);\n }\n\n span.updateName(`${method} ${matched.route.template}`);\n span.setAttribute('http.route', matched.route.template);\n\n // Gateway-extracted params (x-capability-params) win over our own match\n // for safety, but they should always agree.\n let gatewayParams: Record<string, string> = {};\n try {\n gatewayParams = JSON.parse(headerOf(headers, 'x-capability-params') || '{}') as Record<string, string>;\n } catch {\n gatewayParams = {};\n }\n\n const c: RouteContext = {\n ctx: context,\n req,\n method,\n path,\n params: { ...matched.params, ...gatewayParams },\n query: parseQuery(req),\n body: parseBody(req),\n tenant,\n contextToken,\n header: (name) => headerOf(headers, name),\n log,\n json: (data, statusCode = 200) => res.json(data, statusCode),\n };\n\n return await matched.route.handler(c);\n } catch (err) {\n if (isHttpError(err)) {\n span.setAttribute('http.response.status_code', err.status);\n if (err.code) span.setAttribute('revenexx.error.code', err.code);\n if (err.status >= 500) span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });\n // The diagnosis (table names, constraint names, the raw\n // PostgREST body) stays on this side of the wire: logged and\n // traced, never serialised into the response.\n if (err.serverDetail !== undefined) {\n const detail =\n typeof err.serverDetail === 'string' ? err.serverDetail : JSON.stringify(err.serverDetail);\n span.setAttribute('revenexx.error.detail', detail);\n context.error?.(`${method} ${path} — ${err.status} ${err.message}: ${detail}`);\n }\n return res.json(\n {\n error: err.message,\n ...(err.code ? { code: err.code } : {}),\n ...(err.details != null ? { details: err.details } : {}),\n },\n err.status,\n );\n }\n const msg = err instanceof Error ? err.message : String(err);\n if (/not permitted/.test(msg)) {\n span.setAttribute('http.response.status_code', 403);\n return res.json({ error: msg }, 403);\n }\n span.recordException(err instanceof Error ? err : new Error(msg));\n span.setStatus({ code: SpanStatusCode.ERROR, message: msg });\n context.error?.(`unhandled error on ${method} ${path}: ${msg}`);\n return res.json({ error: msg }, 500);\n } finally {\n span.end();\n }\n },\n );\n };\n },\n };\n\n return app;\n}\n","/**\n * The one error representation every layer of the SDK agrees on.\n *\n * `HttpError` used to live in `./router/router.ts`. It moved here so the data\n * adapters can raise it too: an adapter that knows a PostgREST failure is a\n * duplicate key can say \"409\" without the router having to guess from a\n * message string.\n *\n * Two fields exist purely to keep internal database detail out of responses:\n * - `message` / `details` are the *client-facing* payload — always safe,\n * never derived from a database error body.\n * - `serverDetail` is the raw diagnosis. The router logs it and drops it; it\n * is never serialised into a response.\n */\n\nexport interface HttpErrorOptions {\n /** Stable machine-readable code (e.g. `unique_violation`). Safe to expose. */\n code?: string;\n /**\n * Raw diagnosis for server-side logs and traces only — may contain table and\n * constraint names. Never included in the HTTP response.\n */\n serverDetail?: unknown;\n}\n\n/** Throw inside a handler (or an adapter) to answer with a specific HTTP status. */\nexport class HttpError extends Error {\n readonly status: number;\n readonly details?: unknown;\n readonly code?: string;\n readonly serverDetail?: unknown;\n /**\n * Structural marker. `dist/index.cjs` and `dist/router/index.cjs` are separate\n * bundles, so an error thrown by the data client and caught by the router is\n * an instance of a *different* copy of this class — `instanceof` would be\n * false. Everything checks this flag via `isHttpError` instead.\n */\n readonly __isHttpError = true as const;\n\n constructor(status: number, message: string, details?: unknown, options: HttpErrorOptions = {}) {\n super(message);\n this.name = 'HttpError';\n this.status = status;\n if (details !== undefined) this.details = details;\n if (options.code !== undefined) this.code = options.code;\n if (options.serverDetail !== undefined) this.serverDetail = options.serverDetail;\n }\n}\n\n/** Duck-typed `instanceof HttpError` — survives the bundle split (see above). */\nexport function isHttpError(err: unknown): err is HttpError {\n if (!err || typeof err !== 'object') return false;\n const e = err as { __isHttpError?: unknown; name?: unknown; status?: unknown };\n return e.__isHttpError === true || (e.name === 'HttpError' && typeof e.status === 'number');\n}\n\nexport const notFound = (message = 'not found'): HttpError => new HttpError(404, message);\nexport const badRequest = (message = 'bad request', details?: unknown): HttpError =>\n new HttpError(400, message, details);\nexport const forbidden = (message = 'forbidden'): HttpError => new HttpError(403, message);\nexport const conflict = (message = 'conflict'): HttpError => new HttpError(409, message);\n","/**\n * CRUD route mounting: wire a generated entity client to REST routes in one\n * call, with the platform's standard list/get/create/update/delete semantics.\n *\n * const app = createApp({ name: 'markets' });\n * const db = createDb({ adapter: 'runtime', context });\n *\n * mountCrud(app, db.markets, { path: '/markets', columns: ENTITIES.markets.columns });\n * mountCrud(app, db.locales, {\n * path: '/markets/{marketId}/locales',\n * columns: ENTITIES.locales.columns,\n * parent: { param: 'marketId', column: 'market_id' },\n * });\n *\n * Nested resources (a `parent` option) scope every operation to the parent row:\n * lists filter by the parent column, creates inject it, and reads/writes 404\n * when the row belongs to a different parent.\n */\n\nimport type { Page, Query, Row } from '../types.js';\nimport { HttpError, notFound, type App, type RouteContext } from './router.js';\n\n/** Structural subset of the SDK's EntityClient — any compatible repo works. */\nexport interface RepoLike {\n list(query?: Query): Promise<Row[]>;\n page?(query?: Query): Promise<Page>;\n get(id: string | number): Promise<Row | null>;\n create(data: Row): Promise<Row>;\n update(id: string | number, patch: Row): Promise<Row>;\n delete(id: string | number): Promise<void>;\n}\n\nexport interface CrudOptions {\n /** Route base path, e.g. `/markets` or `/markets/{marketId}/locales`. */\n path: string;\n /** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */\n columns?: Record<string, unknown>;\n /**\n * Nested-resource scoping: path param name + the FK column it maps to.\n *\n * Pass `repo` (the PARENT's repo) to make the collection routes verify the\n * parent exists. Without it, `GET /lists/{unknown-id}/entries` answers `200`\n * with an empty page, which a client cannot tell apart from a parent that\n * genuinely has no children — and `POST` would attach a row to a parent that\n * is not there. The single-row routes never had this gap: `fetchOwned`\n * already 404s on an ownership mismatch.\n *\n * Optional to stay backwards compatible; it costs one extra read per\n * collection request, so it is the app's call.\n */\n parent?: { param: string; column: string; repo?: Pick<RepoLike, 'get'> };\n /** Path param for the row id (default `id`). */\n idParam?: string;\n /** Pagination bounds for list (defaults: 50, max 200). */\n defaultLimit?: number;\n maxLimit?: number;\n /** Restrict which routes are mounted (default: all five). */\n only?: ('list' | 'get' | 'create' | 'update' | 'delete')[];\n}\n\nconst INT = (v: unknown, d: number): number => {\n const n = parseInt(String(v), 10);\n return Number.isFinite(n) ? n : d;\n};\n\nfunction parentWhere(c: RouteContext, parent?: CrudOptions['parent']): Record<string, string> {\n if (!parent) return {};\n const value = c.params[parent.param];\n if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);\n return { [parent.column]: value };\n}\n\n/**\n * 404 when the nested parent does not exist, so an unknown parent is not\n * reported as an empty collection. No-op unless the app supplied `parent.repo`.\n */\nasync function assertParentExists(c: RouteContext, parent?: CrudOptions['parent']): Promise<void> {\n if (!parent?.repo) return;\n const value = c.params[parent.param];\n if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);\n if (!(await parent.repo.get(value))) throw notFound();\n}\n\n/** Fetch a row and enforce nested-parent ownership; throws 404 when absent. */\nasync function fetchOwned(\n repo: RepoLike,\n c: RouteContext,\n opts: CrudOptions,\n): Promise<{ id: string; row: Row }> {\n const id = c.params[opts.idParam ?? 'id'] ?? '';\n if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? 'id'}'`);\n const row = await repo.get(id);\n if (!row) throw notFound();\n if (opts.parent) {\n const expected = c.params[opts.parent.param];\n if (String(row[opts.parent.column] ?? '') !== String(expected ?? '')) throw notFound();\n }\n return { id, row };\n}\n\nexport function mountCrud(app: App, repo: RepoLike, opts: CrudOptions): App {\n const base = opts.path.replace(/\\/+$/, '');\n const idTemplate = `${base}/{${opts.idParam ?? 'id'}}`;\n const enabled = new Set(opts.only ?? ['list', 'get', 'create', 'update', 'delete']);\n const defaultLimit = opts.defaultLimit ?? 50;\n const maxLimit = opts.maxLimit ?? 200;\n\n if (enabled.has('list')) {\n app.get(base, async (c) => {\n await assertParentExists(c, opts.parent);\n const where: Record<string, string> = {};\n for (const [k, v] of Object.entries(c.query)) {\n if (opts.columns && k in opts.columns) where[k] = v;\n }\n // The nested-parent filter always wins — a query param must not widen\n // the scope beyond the parent in the path.\n Object.assign(where, parentWhere(c, opts.parent));\n const limit = Math.min(Math.max(INT(c.query.limit, defaultLimit), 1), maxLimit);\n const offset = Math.max(INT(c.query.offset, 0), 0);\n const order = typeof c.query.order === 'string' && c.query.order ? c.query.order : undefined;\n const query: Query = { where, limit, offset, ...(order ? { order } : {}) };\n\n if (repo.page) {\n const { items, total } = await repo.page(query);\n return c.json({\n items,\n page: { limit, offset, total, returned: items.length, hasMore: offset + items.length < total },\n filter: where,\n });\n }\n const items = await repo.list(query);\n return c.json({ items, page: { limit, offset, returned: items.length }, filter: where });\n });\n }\n\n if (enabled.has('create')) {\n app.post(base, async (c) => {\n await assertParentExists(c, opts.parent);\n const data = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.create(data), 201);\n });\n }\n\n if (enabled.has('get')) {\n app.get(idTemplate, async (c) => {\n const { row } = await fetchOwned(repo, c, opts);\n return c.json(row);\n });\n }\n\n if (enabled.has('update')) {\n app.put(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n // A body carrying no fields of its own is not an update. Passing it\n // through produced an empty PostgREST patch, which surfaced as a 500 with\n // a raw Node message (\"The first argument must be of type string or an\n // instance of Buffer … Received undefined\") — an internal serializer\n // fault reported as a server error for what is a malformed request. The\n // guard reads c.body, not the merged patch: with a nested parent the\n // merge always carries the FK, so the patch is never literally empty.\n const fields = c.body && typeof c.body === 'object' && !Array.isArray(c.body) ? Object.keys(c.body) : [];\n if (fields.length === 0) throw new HttpError(400, 'request body must contain at least one field to update');\n // Never let a body overwrite the nested-parent FK.\n const patch = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.update(id, patch));\n });\n }\n\n if (enabled.has('delete')) {\n app.delete(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n await repo.delete(id);\n return c.json({ deleted: true, id });\n });\n }\n\n return app;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACoBA,IAAI,UAAU;AAMd,eAAsB,iBAAgC;AACpD,MAAI,SAAS;AACX;AAAA,EACF;AACA,YAAU;AAEV,QAAM,WACJ,QAAQ,IAAI,oCAAoC,KAAK,QAAQ,IAAI,6BAA6B,KAAK;AACrG,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,MAAI;AACF,UAAM,CAAC,EAAE,QAAQ,GAAG,EAAE,kBAAkB,GAAG,EAAE,sBAAsB,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,MACxF,OAAO,yBAAyB;AAAA,MAChC,OAAO,0CAA0C;AAAA,MACjD,OAAO,uCAAuC;AAAA,IAChD,CAAC;AAGD,UAAM,MAAM,IAAI,QAAQ;AAAA,MACtB,eAAe,IAAI,kBAAkB;AAAA,MACrC,kBAAkB,CAAC,IAAI,sBAAsB,CAAC;AAAA,IAChD,CAAC;AAED,QAAI,MAAM;AAEV,UAAM,QAAQ,MAAY;AACxB,WAAK,IAAI,SAAS,EAAE,MAAM,MAAM;AAAA,MAEhC,CAAC;AAAA,IACH;AACA,YAAQ,KAAK,WAAW,KAAK;AAC7B,YAAQ,KAAK,UAAU,KAAK;AAAA,EAC9B,SAAS,KAAK;AAEZ,YAAQ;AAAA,MACN;AAAA,MACA,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;AAGA,KAAK,eAAe;;;ACrDpB,iBAQO;;;ACCA,IAAM,YAAN,cAAwB,MAAM;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAAgB;AAAA,EAEzB,YAAY,QAAgB,SAAiB,SAAmB,UAA4B,CAAC,GAAG;AAC9F,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,QAAI,YAAY,OAAW,MAAK,UAAU;AAC1C,QAAI,QAAQ,SAAS,OAAW,MAAK,OAAO,QAAQ;AACpD,QAAI,QAAQ,iBAAiB,OAAW,MAAK,eAAe,QAAQ;AAAA,EACtE;AACF;AAGO,SAAS,YAAY,KAAgC;AAC1D,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,IAAI;AACV,SAAO,EAAE,kBAAkB,QAAS,EAAE,SAAS,eAAe,OAAO,EAAE,WAAW;AACpF;AAEO,IAAM,WAAW,CAAC,UAAU,gBAA2B,IAAI,UAAU,KAAK,OAAO;AACjF,IAAM,aAAa,CAAC,UAAU,eAAe,YAClD,IAAI,UAAU,KAAK,SAAS,OAAO;AAC9B,IAAM,YAAY,CAAC,UAAU,gBAA2B,IAAI,UAAU,KAAK,OAAO;AAClF,IAAM,WAAW,CAAC,UAAU,eAA0B,IAAI,UAAU,KAAK,OAAO;;;AD6CvF,IAAM,YAAY,CAAC,SAA2B,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAE5E,SAAS,gBAAgB,UAA6B;AACpD,SAAO,UAAU,QAAQ,EAAE,IAAI,CAAC,QAAQ;AACtC,UAAM,SAAS,iCAAiC,KAAK,GAAG;AACxD,QAAI,OAAQ,QAAO,EAAE,OAAO,OAAO,CAAC,EAAE;AACtC,QAAI,IAAI,WAAW,GAAG,KAAK,IAAI,SAAS,EAAG,QAAO,EAAE,OAAO,IAAI,MAAM,CAAC,EAAE;AACxE,WAAO,EAAE,KAAK,IAAI;AAAA,EACpB,CAAC;AACH;AAEA,SAAS,cAAc,UAAqB,SAAkD;AAC5F,MAAI,SAAS,WAAW,QAAQ,OAAQ,QAAO;AAC/C,QAAM,SAAiC,CAAC;AACxC,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,UAAM,IAAI,SAAS,CAAC;AACpB,QAAI,EAAE,MAAO,QAAO,EAAE,KAAK,IAAI,mBAAmB,QAAQ,CAAC,CAAE;AAAA,aACpD,EAAE,QAAQ,QAAQ,CAAC,EAAG,QAAO;AAAA,EACxC;AACA,SAAO;AACT;AAEA,SAAS,SAAS,SAA6C,MAAsB;AACnF,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAAS,QAAQ,IAAI,KAAK,QAAQ,KAAK,YAAY,CAAC;AAC1D,MAAI,OAAO,WAAW,SAAU,QAAO;AACvC,QAAM,OAAO,KAAK,YAAY;AAC9B,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,OAAO,GAAG;AAC5C,QAAI,EAAE,YAAY,MAAM,QAAQ,OAAO,MAAM,SAAU,QAAO;AAAA,EAChE;AACA,SAAO;AACT;AAEA,SAAS,aAAa,OAAwC;AAC5D,MAAI,CAAC,SAAS,MAAM,MAAM,GAAG,EAAE,SAAS,EAAG,QAAO,CAAC;AACnD,MAAI;AACF,UAAM,UAAU,MAAM,MAAM,GAAG,EAAE,CAAC,EAAG,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG;AACzE,UAAM,SAAkB,KAAK,MAAM,OAAO,KAAK,SAAS,QAAQ,EAAE,SAAS,MAAM,CAAC;AAClF,WAAO,UAAU,OAAO,WAAW,WAAY,SAAqC,CAAC;AAAA,EACvF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,SAAS,UAAU,KAAyC;AAC1D,QAAM,YAAY,IAAI,QAAQ,IAAI,YAAY,IAAI;AAClD,MAAI,aAAa,QAAQ,cAAc,GAAI,QAAO,CAAC;AACnD,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,MAAI,OAAO,cAAc,UAAU;AACjC,QAAI;AACF,YAAM,SAAkB,KAAK,MAAM,SAAS;AAC5C,aAAO,UAAU,OAAO,WAAW,WAAY,SAAqC,CAAC;AAAA,IACvF,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACA,SAAO,CAAC;AACV;AAqBA,SAAS,WAAW,KAAwC;AAC1D,QAAM,MAA8B,CAAC;AACrC,QAAM,UAAU,OAAO,IAAI,QAAQ,EAAE;AACrC,QAAM,QAAQ,QAAQ,QAAQ,GAAG;AACjC,MAAI,SAAS,GAAG;AACd,eAAW,CAAC,GAAG,CAAC,KAAK,IAAI,gBAAgB,QAAQ,MAAM,QAAQ,CAAC,CAAC,EAAG,KAAI,CAAC,IAAI;AAC7E,WAAO;AAAA,EACT;AACA,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAAI,SAAS,CAAC,CAAC,GAAG;AACpD,QAAI,OAAO,MAAM,SAAU,KAAI,CAAC,IAAI;AAAA,aAC3B,KAAK,KAAM,KAAI,CAAC,IAAI,OAAO,CAAC;AAAA,EACvC;AACA,SAAO;AACT;AA2BA,IAAM,SAAS,iBAAM,UAAU,mBAAmB;AAGlD,IAAM,eAAsD;AAAA,EAC1D,MAAM,CAAC,YAAY,OAAO,KAAK,WAAW,CAAC,CAAC;AAAA,EAC5C,KAAK,CAAC,SAAS,QAAQ,SAAS,SAAS,GAAG,KAAK;AACnD;AAEO,SAAS,UAAU,UAAsB,CAAC,GAAQ;AACvD,QAAM,SAA0B,CAAC;AACjC,QAAM,SAAS,QAAQ,WAAW;AAElC,QAAM,MAAW;AAAA,IACf,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC;AAAA,IACjC,MAAM,CAAC,GAAG,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC;AAAA,IACnC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC;AAAA,IACjC,OAAO,CAAC,GAAG,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC;AAAA,IACrC,QAAQ,CAAC,GAAG,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC;AAAA,IACvC,GAAG,QAAQ,UAAU,SAAS;AAC5B,YAAM,WAAW,gBAAgB,QAAQ;AACzC,aAAO,KAAK;AAAA,QACV,QAAQ,OAAO,YAAY;AAAA,QAC3B;AAAA,QACA;AAAA,QACA,UAAU,SAAS,OAAO,CAAC,MAAM,EAAE,QAAQ,MAAS,EAAE;AAAA,QACtD;AAAA,MACF,CAAC;AAED,aAAO,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAC7C,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,MAAM,CAAC;AAAA,IACzJ,UAAU;AACR,aAAO,CAAC,YAAuB;AAC7B,cAAM,EAAE,KAAK,IAAI,IAAI;AACrB,cAAM,UAAU,IAAI,WAAW,CAAC;AAChC,cAAM,UAAU,IAAI,UAAU,OAAO,YAAY;AACjD,cAAM,UAAU,OAAO,IAAI,QAAQ,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC;AACpD,cAAM,OAAO,QAAQ,QAAQ,QAAQ,EAAE,KAAK;AAK5C,cAAM,YAAY,uBAAY,QAAQ,WAAAA,QAAY,OAAO,GAAG,SAAS,YAAY;AAEjF,eAAO,OAAO;AAAA,UACZ,GAAG,MAAM,IAAI,IAAI;AAAA,UACjB,EAAE,MAAM,oBAAS,QAAQ,YAAY,EAAE,uBAAuB,QAAQ,YAAY,KAAK,EAAE;AAAA,UACzF;AAAA,UACA,OAAO,SAAe;AACpB,kBAAM,eAAe,SAAS,SAAS,oBAAoB;AAC3D,kBAAM,SACJ,SAAS,SAAS,mBAAmB,KACpC,aAAa,YAAY,EAAE,aAC5B;AACF,gBAAI,QAAQ,KAAM,MAAK,aAAa,gBAAgB,QAAQ,IAAI;AAChE,gBAAI,OAAQ,MAAK,aAAa,mBAAmB,MAAM;AACvD,kBAAM,MAAM,CAAC,MAAc,QAAQ,MAAM,CAAC;AAE1C,gBAAI,GAAG,QAAQ,QAAQ,KAAK,IAAI,MAAM,IAAI,IAAI,kBAAa,UAAU,MAAM,EAAE;AAE7E,gBAAI;AACF,kBAAI,UAAU,SAAS,OAAO,WAAW,OAAO;AAC9C,qBAAK,aAAa,cAAc,GAAG;AACnC,uBAAO,IAAI,KAAK;AAAA,kBACd,KAAK;AAAA,oBACH,IAAI,QAAQ,IAAI,mBAAmB;AAAA,oBACnC,MAAM,QAAQ,QAAQ,QAAQ,IAAI,qBAAqB;AAAA,oBACvD,YAAY,QAAQ,IAAI,2BAA2B;AAAA,oBACnD,SAAS,GAAG,QAAQ,IAAI,6BAA6B,EAAE,IAAI,QAAQ,IAAI,gCAAgC,EAAE;AAAA,kBAC3G;AAAA,kBACA,QAAQ;AAAA,kBACR,QAAQ,IAAI,OAAO;AAAA,kBACnB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,kBAClC,GAAI,QAAQ,cAAc,KAAK,CAAC;AAAA,gBAClC,CAAC;AAAA,cACH;AAEA,oBAAM,UAAU,UAAU,IAAI;AAC9B,kBAAI,UAA2E;AAC/E,kBAAI,aAAa;AACjB,yBAAW,SAAS,QAAQ;AAC1B,sBAAM,SAAS,cAAc,MAAM,UAAU,OAAO;AACpD,oBAAI,CAAC,OAAQ;AACb,6BAAa;AACb,oBAAI,MAAM,WAAW,QAAQ;AAC3B,4BAAU,EAAE,OAAO,OAAO;AAC1B;AAAA,gBACF;AAAA,cACF;AAEA,kBAAI,CAAC,SAAS;AACZ,sBAAM,SAAS,aAAa,MAAM;AAClC,qBAAK,aAAa,6BAA6B,MAAM;AACrD,qBAAK,UAAU,EAAE,MAAM,0BAAe,OAAO,SAAS,aAAa,uBAAuB,WAAW,CAAC;AACtG,oBAAI,YAAY;AACd,yBAAO,IAAI,KAAK,EAAE,OAAO,UAAU,MAAM,oBAAoB,IAAI,GAAG,GAAG,GAAG;AAAA,gBAC5E;AACA,uBAAO,IAAI,KAAK,EAAE,OAAO,gBAAgB,MAAM,IAAI,IAAI,IAAI,QAAQ,IAAI,OAAO,EAAE,GAAG,GAAG;AAAA,cACxF;AAEA,mBAAK,WAAW,GAAG,MAAM,IAAI,QAAQ,MAAM,QAAQ,EAAE;AACrD,mBAAK,aAAa,cAAc,QAAQ,MAAM,QAAQ;AAItD,kBAAI,gBAAwC,CAAC;AAC7C,kBAAI;AACF,gCAAgB,KAAK,MAAM,SAAS,SAAS,qBAAqB,KAAK,IAAI;AAAA,cAC7E,QAAQ;AACN,gCAAgB,CAAC;AAAA,cACnB;AAEA,oBAAM,IAAkB;AAAA,gBACtB,KAAK;AAAA,gBACL;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA,QAAQ,EAAE,GAAG,QAAQ,QAAQ,GAAG,cAAc;AAAA,gBAC9C,OAAO,WAAW,GAAG;AAAA,gBACrB,MAAM,UAAU,GAAG;AAAA,gBACnB;AAAA,gBACA;AAAA,gBACA,QAAQ,CAAC,SAAS,SAAS,SAAS,IAAI;AAAA,gBACxC;AAAA,gBACA,MAAM,CAAC,MAAM,aAAa,QAAQ,IAAI,KAAK,MAAM,UAAU;AAAA,cAC7D;AAEA,qBAAO,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,YACtC,SAAS,KAAK;AACZ,kBAAI,YAAY,GAAG,GAAG;AACpB,qBAAK,aAAa,6BAA6B,IAAI,MAAM;AACzD,oBAAI,IAAI,KAAM,MAAK,aAAa,uBAAuB,IAAI,IAAI;AAC/D,oBAAI,IAAI,UAAU,IAAK,MAAK,UAAU,EAAE,MAAM,0BAAe,OAAO,SAAS,IAAI,QAAQ,CAAC;AAI1F,oBAAI,IAAI,iBAAiB,QAAW;AAClC,wBAAM,SACJ,OAAO,IAAI,iBAAiB,WAAW,IAAI,eAAe,KAAK,UAAU,IAAI,YAAY;AAC3F,uBAAK,aAAa,yBAAyB,MAAM;AACjD,0BAAQ,QAAQ,GAAG,MAAM,IAAI,IAAI,WAAM,IAAI,MAAM,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE;AAAA,gBAC/E;AACA,uBAAO,IAAI;AAAA,kBACT;AAAA,oBACE,OAAO,IAAI;AAAA,oBACX,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAAA,oBACrC,GAAI,IAAI,WAAW,OAAO,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC;AAAA,kBACxD;AAAA,kBACA,IAAI;AAAA,gBACN;AAAA,cACF;AACA,oBAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,kBAAI,gBAAgB,KAAK,GAAG,GAAG;AAC7B,qBAAK,aAAa,6BAA6B,GAAG;AAClD,uBAAO,IAAI,KAAK,EAAE,OAAO,IAAI,GAAG,GAAG;AAAA,cACrC;AACA,mBAAK,gBAAgB,eAAe,QAAQ,MAAM,IAAI,MAAM,GAAG,CAAC;AAChE,mBAAK,UAAU,EAAE,MAAM,0BAAe,OAAO,SAAS,IAAI,CAAC;AAC3D,sBAAQ,QAAQ,sBAAsB,MAAM,IAAI,IAAI,KAAK,GAAG,EAAE;AAC9D,qBAAO,IAAI,KAAK,EAAE,OAAO,IAAI,GAAG,GAAG;AAAA,YACrC,UAAE;AACA,mBAAK,IAAI;AAAA,YACX;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;AE9UA,IAAM,MAAM,CAAC,GAAY,MAAsB;AAC7C,QAAM,IAAI,SAAS,OAAO,CAAC,GAAG,EAAE;AAChC,SAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAClC;AAEA,SAAS,YAAY,GAAiB,QAAwD;AAC5F,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,QAAM,QAAQ,EAAE,OAAO,OAAO,KAAK;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,UAAU,KAAK,2BAA2B,OAAO,KAAK,GAAG;AAC/E,SAAO,EAAE,CAAC,OAAO,MAAM,GAAG,MAAM;AAClC;AAMA,eAAe,mBAAmB,GAAiB,QAA+C;AAChG,MAAI,CAAC,QAAQ,KAAM;AACnB,QAAM,QAAQ,EAAE,OAAO,OAAO,KAAK;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,UAAU,KAAK,2BAA2B,OAAO,KAAK,GAAG;AAC/E,MAAI,CAAE,MAAM,OAAO,KAAK,IAAI,KAAK,EAAI,OAAM,SAAS;AACtD;AAGA,eAAe,WACb,MACA,GACA,MACmC;AACnC,QAAM,KAAK,EAAE,OAAO,KAAK,WAAW,IAAI,KAAK;AAC7C,MAAI,CAAC,GAAI,OAAM,IAAI,UAAU,KAAK,2BAA2B,KAAK,WAAW,IAAI,GAAG;AACpF,QAAM,MAAM,MAAM,KAAK,IAAI,EAAE;AAC7B,MAAI,CAAC,IAAK,OAAM,SAAS;AACzB,MAAI,KAAK,QAAQ;AACf,UAAM,WAAW,EAAE,OAAO,KAAK,OAAO,KAAK;AAC3C,QAAI,OAAO,IAAI,KAAK,OAAO,MAAM,KAAK,EAAE,MAAM,OAAO,YAAY,EAAE,EAAG,OAAM,SAAS;AAAA,EACvF;AACA,SAAO,EAAE,IAAI,IAAI;AACnB;AAEO,SAAS,UAAU,KAAU,MAAgB,MAAwB;AAC1E,QAAM,OAAO,KAAK,KAAK,QAAQ,QAAQ,EAAE;AACzC,QAAM,aAAa,GAAG,IAAI,KAAK,KAAK,WAAW,IAAI;AACnD,QAAM,UAAU,IAAI,IAAI,KAAK,QAAQ,CAAC,QAAQ,OAAO,UAAU,UAAU,QAAQ,CAAC;AAClF,QAAM,eAAe,KAAK,gBAAgB;AAC1C,QAAM,WAAW,KAAK,YAAY;AAElC,MAAI,QAAQ,IAAI,MAAM,GAAG;AACvB,QAAI,IAAI,MAAM,OAAO,MAAM;AACzB,YAAM,mBAAmB,GAAG,KAAK,MAAM;AACvC,YAAM,QAAgC,CAAC;AACvC,iBAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,EAAE,KAAK,GAAG;AAC5C,YAAI,KAAK,WAAW,KAAK,KAAK,QAAS,OAAM,CAAC,IAAI;AAAA,MACpD;AAGA,aAAO,OAAO,OAAO,YAAY,GAAG,KAAK,MAAM,CAAC;AAChD,YAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE,MAAM,OAAO,YAAY,GAAG,CAAC,GAAG,QAAQ;AAC9E,YAAM,SAAS,KAAK,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC;AACjD,YAAM,QAAQ,OAAO,EAAE,MAAM,UAAU,YAAY,EAAE,MAAM,QAAQ,EAAE,MAAM,QAAQ;AACnF,YAAM,QAAe,EAAE,OAAO,OAAO,QAAQ,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG;AAEzE,UAAI,KAAK,MAAM;AACb,cAAM,EAAE,OAAAC,QAAO,MAAM,IAAI,MAAM,KAAK,KAAK,KAAK;AAC9C,eAAO,EAAE,KAAK;AAAA,UACZ,OAAAA;AAAA,UACA,MAAM,EAAE,OAAO,QAAQ,OAAO,UAAUA,OAAM,QAAQ,SAAS,SAASA,OAAM,SAAS,MAAM;AAAA,UAC7F,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AACA,YAAM,QAAQ,MAAM,KAAK,KAAK,KAAK;AACnC,aAAO,EAAE,KAAK,EAAE,OAAO,MAAM,EAAE,OAAO,QAAQ,UAAU,MAAM,OAAO,GAAG,QAAQ,MAAM,CAAC;AAAA,IACzF,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,KAAK,MAAM,OAAO,MAAM;AAC1B,YAAM,mBAAmB,GAAG,KAAK,MAAM;AACvC,YAAM,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,MAAM,EAAE;AACzD,aAAO,EAAE,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG,GAAG;AAAA,IAC5C,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,KAAK,GAAG;AACtB,QAAI,IAAI,YAAY,OAAO,MAAM;AAC/B,YAAM,EAAE,IAAI,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAC9C,aAAO,EAAE,KAAK,GAAG;AAAA,IACnB,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,IAAI,YAAY,OAAO,MAAM;AAC/B,YAAM,EAAE,GAAG,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAQ7C,YAAM,SAAS,EAAE,QAAQ,OAAO,EAAE,SAAS,YAAY,CAAC,MAAM,QAAQ,EAAE,IAAI,IAAI,OAAO,KAAK,EAAE,IAAI,IAAI,CAAC;AACvG,UAAI,OAAO,WAAW,EAAG,OAAM,IAAI,UAAU,KAAK,wDAAwD;AAE1G,YAAM,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,MAAM,EAAE;AAC1D,aAAO,EAAE,KAAK,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC;AAAA,IAC5C,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,OAAO,YAAY,OAAO,MAAM;AAClC,YAAM,EAAE,GAAG,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAC7C,YAAM,KAAK,OAAO,EAAE;AACpB,aAAO,EAAE,KAAK,EAAE,SAAS,MAAM,GAAG,CAAC;AAAA,IACrC,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":["otelContext","items"]}
|
package/dist/router/index.d.cts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { Q as Query, R as Row, P as Page } from '../
|
|
1
|
+
import { Q as Query, R as Row, P as Page } from '../errors-DrxYD96C.cjs';
|
|
2
|
+
export { H as HttpError, b as HttpErrorOptions, c as badRequest, d as conflict, f as forbidden, i as isHttpError, n as notFound } from '../errors-DrxYD96C.cjs';
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* Minimal HTTP router for revenexx App functions.
|
|
@@ -62,16 +63,7 @@ interface RouteContext {
|
|
|
62
63
|
json(data: unknown, statusCode?: number): unknown;
|
|
63
64
|
}
|
|
64
65
|
type Handler = (c: RouteContext) => unknown | Promise<unknown>;
|
|
65
|
-
|
|
66
|
-
declare class HttpError extends Error {
|
|
67
|
-
readonly status: number;
|
|
68
|
-
readonly details?: unknown;
|
|
69
|
-
constructor(status: number, message: string, details?: unknown);
|
|
70
|
-
}
|
|
71
|
-
declare const notFound: (message?: string) => HttpError;
|
|
72
|
-
declare const badRequest: (message?: string, details?: unknown) => HttpError;
|
|
73
|
-
declare const forbidden: (message?: string) => HttpError;
|
|
74
|
-
declare const conflict: (message?: string) => HttpError;
|
|
66
|
+
|
|
75
67
|
interface AppOptions {
|
|
76
68
|
/** App name reported on the built-in health route. */
|
|
77
69
|
name?: string;
|
|
@@ -133,10 +125,23 @@ interface CrudOptions {
|
|
|
133
125
|
path: string;
|
|
134
126
|
/** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */
|
|
135
127
|
columns?: Record<string, unknown>;
|
|
136
|
-
/**
|
|
128
|
+
/**
|
|
129
|
+
* Nested-resource scoping: path param name + the FK column it maps to.
|
|
130
|
+
*
|
|
131
|
+
* Pass `repo` (the PARENT's repo) to make the collection routes verify the
|
|
132
|
+
* parent exists. Without it, `GET /lists/{unknown-id}/entries` answers `200`
|
|
133
|
+
* with an empty page, which a client cannot tell apart from a parent that
|
|
134
|
+
* genuinely has no children — and `POST` would attach a row to a parent that
|
|
135
|
+
* is not there. The single-row routes never had this gap: `fetchOwned`
|
|
136
|
+
* already 404s on an ownership mismatch.
|
|
137
|
+
*
|
|
138
|
+
* Optional to stay backwards compatible; it costs one extra read per
|
|
139
|
+
* collection request, so it is the app's call.
|
|
140
|
+
*/
|
|
137
141
|
parent?: {
|
|
138
142
|
param: string;
|
|
139
143
|
column: string;
|
|
144
|
+
repo?: Pick<RepoLike, 'get'>;
|
|
140
145
|
};
|
|
141
146
|
/** Path param for the row id (default `id`). */
|
|
142
147
|
idParam?: string;
|
|
@@ -148,4 +153,4 @@ interface CrudOptions {
|
|
|
148
153
|
}
|
|
149
154
|
declare function mountCrud(app: App, repo: RepoLike, opts: CrudOptions): App;
|
|
150
155
|
|
|
151
|
-
export { type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler,
|
|
156
|
+
export { type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, type RepoLike, type RouteContext, createApp, mountCrud };
|
package/dist/router/index.d.ts
CHANGED
|
@@ -1,4 +1,5 @@
|
|
|
1
|
-
import { Q as Query, R as Row, P as Page } from '../
|
|
1
|
+
import { Q as Query, R as Row, P as Page } from '../errors-DrxYD96C.js';
|
|
2
|
+
export { H as HttpError, b as HttpErrorOptions, c as badRequest, d as conflict, f as forbidden, i as isHttpError, n as notFound } from '../errors-DrxYD96C.js';
|
|
2
3
|
|
|
3
4
|
/**
|
|
4
5
|
* Minimal HTTP router for revenexx App functions.
|
|
@@ -62,16 +63,7 @@ interface RouteContext {
|
|
|
62
63
|
json(data: unknown, statusCode?: number): unknown;
|
|
63
64
|
}
|
|
64
65
|
type Handler = (c: RouteContext) => unknown | Promise<unknown>;
|
|
65
|
-
|
|
66
|
-
declare class HttpError extends Error {
|
|
67
|
-
readonly status: number;
|
|
68
|
-
readonly details?: unknown;
|
|
69
|
-
constructor(status: number, message: string, details?: unknown);
|
|
70
|
-
}
|
|
71
|
-
declare const notFound: (message?: string) => HttpError;
|
|
72
|
-
declare const badRequest: (message?: string, details?: unknown) => HttpError;
|
|
73
|
-
declare const forbidden: (message?: string) => HttpError;
|
|
74
|
-
declare const conflict: (message?: string) => HttpError;
|
|
66
|
+
|
|
75
67
|
interface AppOptions {
|
|
76
68
|
/** App name reported on the built-in health route. */
|
|
77
69
|
name?: string;
|
|
@@ -133,10 +125,23 @@ interface CrudOptions {
|
|
|
133
125
|
path: string;
|
|
134
126
|
/** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */
|
|
135
127
|
columns?: Record<string, unknown>;
|
|
136
|
-
/**
|
|
128
|
+
/**
|
|
129
|
+
* Nested-resource scoping: path param name + the FK column it maps to.
|
|
130
|
+
*
|
|
131
|
+
* Pass `repo` (the PARENT's repo) to make the collection routes verify the
|
|
132
|
+
* parent exists. Without it, `GET /lists/{unknown-id}/entries` answers `200`
|
|
133
|
+
* with an empty page, which a client cannot tell apart from a parent that
|
|
134
|
+
* genuinely has no children — and `POST` would attach a row to a parent that
|
|
135
|
+
* is not there. The single-row routes never had this gap: `fetchOwned`
|
|
136
|
+
* already 404s on an ownership mismatch.
|
|
137
|
+
*
|
|
138
|
+
* Optional to stay backwards compatible; it costs one extra read per
|
|
139
|
+
* collection request, so it is the app's call.
|
|
140
|
+
*/
|
|
137
141
|
parent?: {
|
|
138
142
|
param: string;
|
|
139
143
|
column: string;
|
|
144
|
+
repo?: Pick<RepoLike, 'get'>;
|
|
140
145
|
};
|
|
141
146
|
/** Path param for the row id (default `id`). */
|
|
142
147
|
idParam?: string;
|
|
@@ -148,4 +153,4 @@ interface CrudOptions {
|
|
|
148
153
|
}
|
|
149
154
|
declare function mountCrud(app: App, repo: RepoLike, opts: CrudOptions): App;
|
|
150
155
|
|
|
151
|
-
export { type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler,
|
|
156
|
+
export { type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, type RepoLike, type RouteContext, createApp, mountCrud };
|
package/dist/router/index.js
CHANGED
|
@@ -1,3 +1,11 @@
|
|
|
1
|
+
import {
|
|
2
|
+
HttpError,
|
|
3
|
+
badRequest,
|
|
4
|
+
conflict,
|
|
5
|
+
forbidden,
|
|
6
|
+
isHttpError,
|
|
7
|
+
notFound
|
|
8
|
+
} from "../chunk-WJ7QJ3NU.js";
|
|
1
9
|
import "../chunk-TUTGCI5D.js";
|
|
2
10
|
|
|
3
11
|
// src/router/router.ts
|
|
@@ -8,20 +16,6 @@ import {
|
|
|
8
16
|
SpanKind,
|
|
9
17
|
SpanStatusCode
|
|
10
18
|
} from "@opentelemetry/api";
|
|
11
|
-
var HttpError = class extends Error {
|
|
12
|
-
status;
|
|
13
|
-
details;
|
|
14
|
-
constructor(status, message, details) {
|
|
15
|
-
super(message);
|
|
16
|
-
this.name = "HttpError";
|
|
17
|
-
this.status = status;
|
|
18
|
-
this.details = details;
|
|
19
|
-
}
|
|
20
|
-
};
|
|
21
|
-
var notFound = (message = "not found") => new HttpError(404, message);
|
|
22
|
-
var badRequest = (message = "bad request", details) => new HttpError(400, message, details);
|
|
23
|
-
var forbidden = (message = "forbidden") => new HttpError(403, message);
|
|
24
|
-
var conflict = (message = "conflict") => new HttpError(409, message);
|
|
25
19
|
var splitPath = (path) => path.split("/").filter(Boolean);
|
|
26
20
|
function compileTemplate(template) {
|
|
27
21
|
return splitPath(template).map((seg) => {
|
|
@@ -77,6 +71,12 @@ function parseBody(req) {
|
|
|
77
71
|
}
|
|
78
72
|
function parseQuery(req) {
|
|
79
73
|
const out = {};
|
|
74
|
+
const rawPath = String(req.path ?? "");
|
|
75
|
+
const qmark = rawPath.indexOf("?");
|
|
76
|
+
if (qmark >= 0) {
|
|
77
|
+
for (const [k, v] of new URLSearchParams(rawPath.slice(qmark + 1))) out[k] = v;
|
|
78
|
+
return out;
|
|
79
|
+
}
|
|
80
80
|
for (const [k, v] of Object.entries(req.query ?? {})) {
|
|
81
81
|
if (typeof v === "string") out[k] = v;
|
|
82
82
|
else if (v != null) out[k] = String(v);
|
|
@@ -190,10 +190,23 @@ function createApp(options = {}) {
|
|
|
190
190
|
};
|
|
191
191
|
return await matched.route.handler(c);
|
|
192
192
|
} catch (err) {
|
|
193
|
-
if (err
|
|
193
|
+
if (isHttpError(err)) {
|
|
194
194
|
span.setAttribute("http.response.status_code", err.status);
|
|
195
|
+
if (err.code) span.setAttribute("revenexx.error.code", err.code);
|
|
195
196
|
if (err.status >= 500) span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });
|
|
196
|
-
|
|
197
|
+
if (err.serverDetail !== void 0) {
|
|
198
|
+
const detail = typeof err.serverDetail === "string" ? err.serverDetail : JSON.stringify(err.serverDetail);
|
|
199
|
+
span.setAttribute("revenexx.error.detail", detail);
|
|
200
|
+
context.error?.(`${method} ${path} \u2014 ${err.status} ${err.message}: ${detail}`);
|
|
201
|
+
}
|
|
202
|
+
return res.json(
|
|
203
|
+
{
|
|
204
|
+
error: err.message,
|
|
205
|
+
...err.code ? { code: err.code } : {},
|
|
206
|
+
...err.details != null ? { details: err.details } : {}
|
|
207
|
+
},
|
|
208
|
+
err.status
|
|
209
|
+
);
|
|
197
210
|
}
|
|
198
211
|
const msg = err instanceof Error ? err.message : String(err);
|
|
199
212
|
if (/not permitted/.test(msg)) {
|
|
@@ -226,6 +239,12 @@ function parentWhere(c, parent) {
|
|
|
226
239
|
if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);
|
|
227
240
|
return { [parent.column]: value };
|
|
228
241
|
}
|
|
242
|
+
async function assertParentExists(c, parent) {
|
|
243
|
+
if (!parent?.repo) return;
|
|
244
|
+
const value = c.params[parent.param];
|
|
245
|
+
if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);
|
|
246
|
+
if (!await parent.repo.get(value)) throw notFound();
|
|
247
|
+
}
|
|
229
248
|
async function fetchOwned(repo, c, opts) {
|
|
230
249
|
const id = c.params[opts.idParam ?? "id"] ?? "";
|
|
231
250
|
if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? "id"}'`);
|
|
@@ -245,6 +264,7 @@ function mountCrud(app, repo, opts) {
|
|
|
245
264
|
const maxLimit = opts.maxLimit ?? 200;
|
|
246
265
|
if (enabled.has("list")) {
|
|
247
266
|
app.get(base, async (c) => {
|
|
267
|
+
await assertParentExists(c, opts.parent);
|
|
248
268
|
const where = {};
|
|
249
269
|
for (const [k, v] of Object.entries(c.query)) {
|
|
250
270
|
if (opts.columns && k in opts.columns) where[k] = v;
|
|
@@ -268,6 +288,7 @@ function mountCrud(app, repo, opts) {
|
|
|
268
288
|
}
|
|
269
289
|
if (enabled.has("create")) {
|
|
270
290
|
app.post(base, async (c) => {
|
|
291
|
+
await assertParentExists(c, opts.parent);
|
|
271
292
|
const data = { ...c.body, ...parentWhere(c, opts.parent) };
|
|
272
293
|
return c.json(await repo.create(data), 201);
|
|
273
294
|
});
|
|
@@ -281,6 +302,8 @@ function mountCrud(app, repo, opts) {
|
|
|
281
302
|
if (enabled.has("update")) {
|
|
282
303
|
app.put(idTemplate, async (c) => {
|
|
283
304
|
const { id } = await fetchOwned(repo, c, opts);
|
|
305
|
+
const fields = c.body && typeof c.body === "object" && !Array.isArray(c.body) ? Object.keys(c.body) : [];
|
|
306
|
+
if (fields.length === 0) throw new HttpError(400, "request body must contain at least one field to update");
|
|
284
307
|
const patch = { ...c.body, ...parentWhere(c, opts.parent) };
|
|
285
308
|
return c.json(await repo.update(id, patch));
|
|
286
309
|
});
|
|
@@ -300,6 +323,7 @@ export {
|
|
|
300
323
|
conflict,
|
|
301
324
|
createApp,
|
|
302
325
|
forbidden,
|
|
326
|
+
isHttpError,
|
|
303
327
|
mountCrud,
|
|
304
328
|
notFound
|
|
305
329
|
};
|