@revenexx/app-sdk 0.8.0 → 0.9.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 +53 -0
- package/dist/router/index.cjs +40 -0
- package/dist/router/index.cjs.map +1 -1
- package/dist/router/index.d.cts +109 -1
- package/dist/router/index.d.ts +109 -1
- package/dist/router/index.js +40 -0
- package/dist/router/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -202,6 +202,59 @@ automatically. An App that routes itself must honour `err.status` in its
|
|
|
202
202
|
catch-all (`isHttpError(err) ? err.status : 500`), or it will report a 400 as a
|
|
203
203
|
500 no matter what the SDK raises.
|
|
204
204
|
|
|
205
|
+
## Who is acting
|
|
206
|
+
|
|
207
|
+
`c.tenant` says whose data a request is for. `c.actor` says whose hand is on it.
|
|
208
|
+
|
|
209
|
+
```js
|
|
210
|
+
app.post('/procurement/pending-approvals/{id}/approve', async (c) => {
|
|
211
|
+
// A signature has to be proven. `asserted` is a tenant server's word for a
|
|
212
|
+
// customer it is acting for — right for attribution, not for authority.
|
|
213
|
+
if (!c.actor.authenticated()) throw forbidden('this decision needs a signed-in approver');
|
|
214
|
+
|
|
215
|
+
const approval = await db.pending_approvals.get(c.params.id);
|
|
216
|
+
// Compare two names, never two absences: an operator has no contact, and an
|
|
217
|
+
// approval nobody is named on has none either, so `!==` alone would let the
|
|
218
|
+
// two nulls agree.
|
|
219
|
+
if (!c.actor.contact || approval.approver_contact_id !== c.actor.contact) {
|
|
220
|
+
throw forbidden('this approval is not yours');
|
|
221
|
+
}
|
|
222
|
+
// …
|
|
223
|
+
});
|
|
224
|
+
```
|
|
225
|
+
|
|
226
|
+
| field | is |
|
|
227
|
+
|---|---|
|
|
228
|
+
| `user` / `email` | the human the gateway authenticated, or `null` |
|
|
229
|
+
| `contact` / `organization` | the `customers` contact they were resolved to, or `null` |
|
|
230
|
+
| `permissions`, `holds(p)` | what the tenant's role provider grants that contact |
|
|
231
|
+
| `trust` | `authenticated`, `asserted` or `none` |
|
|
232
|
+
| `plane` | `contact`, `operator` or `system` |
|
|
233
|
+
| `authenticated()` | shorthand for `trust === 'authenticated'` |
|
|
234
|
+
|
|
235
|
+
**Two planes.** A storefront call is made by a server holding the tenant API key
|
|
236
|
+
on behalf of a customer: it *asserts* the person, the gateway resolves the name
|
|
237
|
+
through the tenant's role provider, and `trust` is `asserted` — enough to stop a
|
|
238
|
+
malicious end user, never a compromised BFF. A Cockpit call, or any call
|
|
239
|
+
carrying a person's own token, was verified by the gateway before a route was
|
|
240
|
+
matched: `trust` is `authenticated` and the contact was resolved from that
|
|
241
|
+
proven subject. The headers are identical either way, which is exactly why
|
|
242
|
+
`trust` is a field: the same `contact` is a signature on one plane and a label
|
|
243
|
+
on the other.
|
|
244
|
+
|
|
245
|
+
**`plane` is the distinction apps otherwise get wrong.** `operator` is an
|
|
246
|
+
authenticated human with no contact — back office staff, support, a partner
|
|
247
|
+
operating the tenant — and that absence is the answer, not a failed lookup.
|
|
248
|
+
`system` is nobody at all: a schedule, a webhook, a service token. Treating "no
|
|
249
|
+
contact resolved" as "must be the platform" reads an unknown customer as an
|
|
250
|
+
administrator.
|
|
251
|
+
|
|
252
|
+
Every field comes from headers the gateway sets itself and strips from anything
|
|
253
|
+
a caller sends, so none of this can be talked up from outside. Never take the
|
|
254
|
+
acting person from the context token's claims — those describe the calling
|
|
255
|
+
*system*, which in a theme site is the theme's service user — and never from the
|
|
256
|
+
request body, which is the caller's own word about itself.
|
|
257
|
+
|
|
205
258
|
## App settings
|
|
206
259
|
|
|
207
260
|
An App declares the knobs a merchant may turn in `settings.json`; the Cockpit
|
package/dist/router/index.cjs
CHANGED
|
@@ -30,11 +30,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
|
|
|
30
30
|
// src/router/index.ts
|
|
31
31
|
var router_exports = {};
|
|
32
32
|
__export(router_exports, {
|
|
33
|
+
ACTOR_HEADERS: () => ACTOR_HEADERS,
|
|
33
34
|
DEFAULT_GATEWAY_ENDPOINT: () => DEFAULT_GATEWAY_ENDPOINT,
|
|
34
35
|
DEFAULT_SETTINGS_ERROR_TTL_MS: () => DEFAULT_SETTINGS_ERROR_TTL_MS,
|
|
35
36
|
DEFAULT_SETTINGS_TIMEOUT_MS: () => DEFAULT_SETTINGS_TIMEOUT_MS,
|
|
36
37
|
DEFAULT_SETTINGS_TTL_MS: () => DEFAULT_SETTINGS_TTL_MS,
|
|
37
38
|
HttpError: () => HttpError,
|
|
39
|
+
actorFrom: () => actorFrom,
|
|
38
40
|
badRequest: () => badRequest,
|
|
39
41
|
conflict: () => conflict,
|
|
40
42
|
createApp: () => createApp,
|
|
@@ -86,6 +88,41 @@ void startTelemetry();
|
|
|
86
88
|
// src/router/router.ts
|
|
87
89
|
var import_api = require("@opentelemetry/api");
|
|
88
90
|
|
|
91
|
+
// src/router/actor.ts
|
|
92
|
+
var ACTOR_HEADERS = {
|
|
93
|
+
user: "x-revenexx-actor",
|
|
94
|
+
email: "x-revenexx-actor-email",
|
|
95
|
+
trust: "x-revenexx-actor-trust",
|
|
96
|
+
contact: "x-revenexx-contact",
|
|
97
|
+
organization: "x-revenexx-organization",
|
|
98
|
+
permissions: "x-revenexx-permissions"
|
|
99
|
+
};
|
|
100
|
+
var nullIfEmpty = (v) => v.trim() === "" ? null : v.trim();
|
|
101
|
+
function actorFrom(header) {
|
|
102
|
+
const read = (name) => {
|
|
103
|
+
const v = header(name);
|
|
104
|
+
return typeof v === "string" ? v : "";
|
|
105
|
+
};
|
|
106
|
+
const user = nullIfEmpty(read(ACTOR_HEADERS.user));
|
|
107
|
+
const contact = nullIfEmpty(read(ACTOR_HEADERS.contact));
|
|
108
|
+
const permissions = read(ACTOR_HEADERS.permissions).split(",").map((p) => p.trim()).filter(Boolean);
|
|
109
|
+
const raw = read(ACTOR_HEADERS.trust).trim().toLowerCase();
|
|
110
|
+
const trust = user === null && contact === null ? "none" : user !== null && raw === "authenticated" ? "authenticated" : "asserted";
|
|
111
|
+
const plane = contact !== null ? "contact" : user !== null ? "operator" : "system";
|
|
112
|
+
const held = new Set(permissions);
|
|
113
|
+
return {
|
|
114
|
+
user,
|
|
115
|
+
email: nullIfEmpty(read(ACTOR_HEADERS.email)),
|
|
116
|
+
contact,
|
|
117
|
+
organization: nullIfEmpty(read(ACTOR_HEADERS.organization)),
|
|
118
|
+
permissions,
|
|
119
|
+
trust,
|
|
120
|
+
plane,
|
|
121
|
+
holds: (permission) => permission !== "" && held.has(permission),
|
|
122
|
+
authenticated: () => trust === "authenticated"
|
|
123
|
+
};
|
|
124
|
+
}
|
|
125
|
+
|
|
89
126
|
// src/settings.ts
|
|
90
127
|
var DEFAULT_GATEWAY_ENDPOINT = "https://api.revenexx.com";
|
|
91
128
|
var DEFAULT_SETTINGS_TTL_MS = 6e4;
|
|
@@ -432,6 +469,7 @@ function createApp(options = {}) {
|
|
|
432
469
|
tenant,
|
|
433
470
|
contextToken,
|
|
434
471
|
header: (name) => headerOf2(headers, name),
|
|
472
|
+
actor: actorFrom((name) => headerOf2(headers, name)),
|
|
435
473
|
log,
|
|
436
474
|
json: (data, statusCode = 200) => res.json(data, statusCode),
|
|
437
475
|
// The market rides on the request, so a market-scoped setting
|
|
@@ -593,11 +631,13 @@ function mountCrud(app, repo, opts) {
|
|
|
593
631
|
}
|
|
594
632
|
// Annotate the CommonJS export names for ESM import in node:
|
|
595
633
|
0 && (module.exports = {
|
|
634
|
+
ACTOR_HEADERS,
|
|
596
635
|
DEFAULT_GATEWAY_ENDPOINT,
|
|
597
636
|
DEFAULT_SETTINGS_ERROR_TTL_MS,
|
|
598
637
|
DEFAULT_SETTINGS_TIMEOUT_MS,
|
|
599
638
|
DEFAULT_SETTINGS_TTL_MS,
|
|
600
639
|
HttpError,
|
|
640
|
+
actorFrom,
|
|
601
641
|
badRequest,
|
|
602
642
|
conflict,
|
|
603
643
|
createApp,
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/router/index.ts","../../src/instrument.ts","../../src/router/router.ts","../../src/settings.ts","../../src/errors.ts","../../src/patch.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// App settings. `createApp` builds a reader for you (`c.settings()`); create\n// one directly when code outside a handler needs the same values.\nexport {\n createSettings,\n DEFAULT_GATEWAY_ENDPOINT,\n DEFAULT_SETTINGS_TTL_MS,\n DEFAULT_SETTINGS_ERROR_TTL_MS,\n DEFAULT_SETTINGS_TIMEOUT_MS,\n} from '../settings.js';\nexport type {\n SettingsReader,\n SettingsOptions,\n SettingsSnapshot,\n SettingsSource,\n SettingsDefaults,\n ResolvedSettings,\n ReadOptions,\n} from '../settings.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';\nimport { createSettings } from '../settings.js';\nimport type {\n ReadOptions,\n ResolvedSettings,\n SettingsDefaults,\n SettingsOptions,\n SettingsReader,\n SettingsSnapshot,\n} from '../settings.js';\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<D extends SettingsDefaults = SettingsDefaults> {\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 * This tenant's effective settings for the app, resolved for the request's\n * market. Cached and fail-open — see `createSettings`. Available on every\n * app; pass `settings` to `createApp` to declare defaults and get them typed.\n */\n settings(options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n settingsSnapshot(options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n}\n\nexport type Handler<D extends SettingsDefaults = SettingsDefaults> = (\n c: RouteContext<D>,\n) => 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<D extends SettingsDefaults> {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler<D>;\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 // The runtime hands `req.query` through UNDECODED — measured in production\n // against every one of the 13 apps after 0.6.0 shipped:\n //\n // GET /v1/customers/organizations?name=ACME%20GmbH\n // -> returned 0, filter {\"name\":\"ACME%20GmbH\"} (the row 'ACME GmbH' exists)\n //\n // 0.6.0 only decoded when the query rode on `req.path`, which this runtime\n // does not do, so the fix was inert. Decode here as well; each source is\n // still decoded exactly once, because the branch above returns.\n for (const [k, v] of Object.entries(req.query ?? {})) {\n const raw = typeof v === 'string' ? v : v == null ? null : String(v);\n if (raw !== null) out[decodeComponent(k)] = decodeComponent(raw);\n }\n return out;\n}\n\n/**\n * Percent-decode one query key or value, treating `+` as a space the way a\n * form-encoded query requires.\n *\n * Falls back to the input when it is not valid percent-encoding — a lone `%`\n * is a legitimate character in a search term, and throwing a URIError on it\n * would turn a harmless filter into a 500.\n */\nfunction decodeComponent(value: string): string {\n try {\n return decodeURIComponent(value.replace(/\\+/g, ' '));\n } catch {\n return value;\n }\n}\n\nexport interface AppOptions<D extends SettingsDefaults = SettingsDefaults> {\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 * App settings behind `c.settings()`. Pass the defaults your settings.json\n * declares — they type the resolved object and are what the app runs on if\n * the settings service is unreachable:\n *\n * createApp({ name: 'orders', settings: { defaults: { auto_reserve: true } } })\n *\n * `app` defaults to this app's `name`. Pass a reader built with\n * `createSettings` instead when you want to share it with code outside the\n * router. Omit entirely and `c.settings()` still works — it just has no\n * declared defaults to fall back on.\n */\n settings?: Omit<SettingsOptions<D>, 'app'> & { app?: string } | SettingsReader<D>;\n}\n\nexport interface App<D extends SettingsDefaults = SettingsDefaults> {\n get(template: string, handler: Handler<D>): App<D>;\n post(template: string, handler: Handler<D>): App<D>;\n put(template: string, handler: Handler<D>): App<D>;\n patch(template: string, handler: Handler<D>): App<D>;\n delete(template: string, handler: Handler<D>): App<D>;\n on(method: string, template: string, handler: Handler<D>): App<D>;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** The settings reader backing `c.settings()` (e.g. to clear its cache). */\n settings: SettingsReader<D>;\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst isSettingsReader = <D extends SettingsDefaults>(\n value: NonNullable<AppOptions<D>['settings']>,\n): value is SettingsReader<D> => typeof (value as SettingsReader<D>).get === 'function';\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<D extends SettingsDefaults = SettingsDefaults>(options: AppOptions<D> = {}): App<D> {\n const routes: CompiledRoute<D>[] = [];\n const health = options.health !== false;\n // The app knows its own name, so the settings reader does not have to be told\n // it. One reader per app, created once: the cache lives on it.\n const settings: SettingsReader<D> =\n options.settings && isSettingsReader(options.settings)\n ? options.settings\n : createSettings<D>({ app: options.name, ...(options.settings ?? {}) });\n\n const app: App<D> = {\n settings,\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<D>; 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<D> = {\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 // The market rides on the request, so a market-scoped setting\n // resolves for the market this call is for — no argument needed.\n settings: (readOptions) => settings.get(c, readOptions),\n settingsSnapshot: (readOptions) => settings.load(c, readOptions),\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 * App settings — the tenant's configuration for THIS app, read at runtime.\n *\n * An App declares its settings in `settings.json` (`{ settings: { <key>:\n * { type, scope, default, sensitive, ... } } }`). The cockpit renders that\n * schema, Console stores the tenant's chosen values, and the gateway resolves\n * the two into an effective map:\n *\n * GET {gateway}/v1/settings/apps/{app}[?market={code}]\n * -> { app, market, settings: { … }, masked: [ … ] }\n *\n * Resolution happens ON THE GATEWAY, and this reader does not second-guess it.\n * Per key, the gateway applies (api/internal/gateway/settings.go,\n * `resolveSettings`):\n *\n * 1. per-market override — only for settings declared `\"scope\": \"market\"`,\n * and only when `?market=` is sent\n * 2. stored tenant value — the flat value in `settings_values`\n * 3. schema default — the `default` from settings.json\n *\n * Settings flagged `sensitive` are never in `settings`; their keys are listed\n * in `masked` so a caller can tell \"not configured\" from \"not for you\".\n *\n * The `defaults` you pass here are a *fourth*, last-resort layer: they are what\n * the app runs on when the settings service cannot be reached, and they are\n * what types the resolved object. They never override a value the gateway\n * actually resolved — only a `null`/absent one.\n *\n * const settings = createSettings({\n * app: 'orders',\n * defaults: { auto_reserve: true, reservation_minutes: 30 },\n * });\n *\n * app.post('/orders', async (c) => {\n * const s = await settings.get(c); // market taken from the request\n * if (s.auto_reserve) { … }\n * });\n *\n * Or let the router own it — `createApp({ name, settings: { defaults } })`\n * gives every handler `await c.settings()`.\n *\n * Two properties make this safe to call on every request:\n *\n * - it FAILS OPEN. A gateway blip, a missing tenant, a timeout, an app that\n * declares no settings at all: you get the last good values if there are\n * any, otherwise your declared defaults. It never throws and never takes\n * the app down. Availability is the default; switching something off is\n * the deliberate act, and a deliberate act must not be the accident.\n * - it CACHES. Per (tenant, app, market), for a short TTL, with concurrent\n * reads sharing one in-flight request. A warm read is a Map lookup.\n */\n\n/** The platform gateway. Override with REVENEXX_GATEWAY_ENDPOINT. */\nexport const DEFAULT_GATEWAY_ENDPOINT = 'https://api.revenexx.com';\n\n/**\n * How long a resolved settings map stays warm in the process (ms).\n *\n * Settings are configuration, not data: a merchant flips one every few weeks.\n * The gateway keeps its own 30s cache in front of Console and drops it on a\n * NATS invalidation when values change, so this second layer is the only real\n * staleness — a cockpit change takes effect within a minute. That is the right\n * trade against the alternative, which is a gateway round trip on the hot path\n * of every single request.\n *\n * Override per reader (`ttlMs`) or per deployment (REVENEXX_SETTINGS_TTL_MS).\n */\nexport const DEFAULT_SETTINGS_TTL_MS = 60_000;\n\n/**\n * How long a FAILED read stays cached (ms). Short, because the failure is\n * usually transient and we want to recover quickly — but not zero, or an\n * unreachable gateway would put a doomed round trip on every request, which is\n * exactly the outage the fail-open is supposed to absorb.\n *\n * A 404 (\"app not installed or declares no settings\") is not a failure but a\n * stable answer, and is cached for the full TTL.\n */\nexport const DEFAULT_SETTINGS_ERROR_TTL_MS = 5_000;\n\n/** Request timeout (ms). A hung settings service must not hang the app. */\nexport const DEFAULT_SETTINGS_TIMEOUT_MS = 2_000;\n\nexport type SettingsDefaults = Record<string, unknown>;\n\n/**\n * The resolved map. Keys you declared in `defaults` keep their type; anything\n * else the manifest declares is still there, as `unknown`.\n */\nexport type ResolvedSettings<D extends SettingsDefaults = SettingsDefaults> = D & Record<string, unknown>;\n\n/**\n * Anything a request's tenant/token/market can be read from: the router's\n * `RouteContext`, the raw function context (`{ req: { headers } }`), or a bare\n * headers object.\n */\nexport interface SettingsSource {\n header?(name: string): string;\n tenant?: string | null;\n contextToken?: string;\n req?: { headers?: Record<string, string> | undefined } | undefined;\n headers?: Record<string, string> | undefined;\n}\n\nexport interface SettingsOptions<D extends SettingsDefaults = SettingsDefaults> {\n /**\n * The app whose settings to read. Defaults to REVENEXX_APP_NAME, which the\n * runtime sets — a deployed app usually needs no value here. `createApp`\n * passes its own `name`.\n */\n app?: string;\n /**\n * Last-resort values, and the type source. Use the same defaults your\n * settings.json declares: they are what the app runs on if the settings\n * service is unreachable.\n */\n defaults?: D;\n /** Gateway base URL. Default: REVENEXX_GATEWAY_ENDPOINT or the platform gateway. */\n endpoint?: string;\n /** Cache TTL in ms. Default: REVENEXX_SETTINGS_TTL_MS or 60_000. */\n ttlMs?: number;\n /** How long a failed read is cached, in ms. Default 5_000. */\n errorTtlMs?: number;\n /** Per-request timeout in ms. Default 2_000. */\n timeoutMs?: number;\n /** Environment to read from (tests). Default `process.env`. */\n env?: Record<string, string | undefined>;\n /** Fetch implementation (tests). Default `globalThis.fetch`. */\n fetchImpl?: typeof fetch;\n /**\n * Called when a read fails and the app falls back. Wire it to the function's\n * `error()` so a silent fallback is still visible. Must not throw.\n */\n onError?: (error: Error, info: { app: string; tenant: string; market: string | null }) => void;\n}\n\n/** A resolved read, with the provenance a caller occasionally needs. */\nexport interface SettingsSnapshot<D extends SettingsDefaults = SettingsDefaults> {\n app: string;\n tenant: string;\n /** The market the values were resolved for, or null for the tenant baseline. */\n market: string | null;\n settings: ResolvedSettings<D>;\n /** Keys that exist but are `sensitive`, so their values were withheld. */\n masked: string[];\n /** true when these values came from the gateway (fresh or cached). */\n resolved: boolean;\n /** Why the fallback happened, when `resolved` is false. */\n error?: string;\n}\n\nexport interface ReadOptions {\n /** Resolve for this market instead of the one on the request. `''` = tenant baseline. */\n market?: string;\n}\n\nexport interface SettingsReader<D extends SettingsDefaults = SettingsDefaults> {\n /** The effective settings for this request. Never throws. */\n get(source?: SettingsSource, options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n load(source?: SettingsSource, options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n /** Drop the cache (tests, or right after writing settings). */\n clear(): void;\n}\n\ninterface Entry<D extends SettingsDefaults> {\n at: number;\n ttl: number;\n promise: Promise<SettingsSnapshot<D>>;\n}\n\ninterface GatewayResponse {\n settings?: Record<string, unknown>;\n masked?: unknown;\n}\n\n/** Case-insensitive header read across the three shapes we accept. */\nfunction headerOf(source: SettingsSource | undefined, name: string): string {\n if (!source) return '';\n if (typeof source.header === 'function') {\n const v = source.header(name);\n if (typeof v === 'string' && v !== '') return v;\n }\n const bags = [source.req?.headers, source.headers];\n const want = name.toLowerCase();\n for (const bag of bags) {\n if (!bag) continue;\n const direct = bag[name] ?? bag[want];\n if (typeof direct === 'string' && direct !== '') return direct;\n for (const [k, v] of Object.entries(bag)) {\n if (k.toLowerCase() === want && typeof v === 'string' && v !== '') return v;\n }\n }\n return '';\n}\n\n/**\n * Merge the gateway's resolved map over the declared defaults.\n *\n * A `null` from the gateway does NOT clobber a default: a setting the merchant\n * never touched and whose schema carries no default resolves to `null`, and a\n * caller should not have to null-check a key it declared a default for. A real\n * stored value — including `false`, `0` and `''` — always wins.\n */\nfunction mergeSettings<D extends SettingsDefaults>(\n defaults: D | undefined,\n resolved: Record<string, unknown> | undefined,\n): ResolvedSettings<D> {\n const out: Record<string, unknown> = { ...(defaults ?? {}) };\n for (const [key, value] of Object.entries(resolved ?? {})) {\n if (value !== null && value !== undefined) out[key] = value;\n else if (!(key in out)) out[key] = value ?? null;\n }\n return out as ResolvedSettings<D>;\n}\n\nfunction timeoutSignal(ms: number): AbortSignal | undefined {\n const factory = (AbortSignal as { timeout?: (ms: number) => AbortSignal }).timeout;\n if (typeof factory === 'function') return factory(ms);\n if (typeof AbortController !== 'function') return undefined;\n const controller = new AbortController();\n setTimeout(() => controller.abort(), ms).unref?.();\n return controller.signal;\n}\n\n/**\n * Build a settings reader for one app. Create it once at module scope — the\n * cache lives on the reader, and a per-request reader would cache nothing.\n */\nexport function createSettings<D extends SettingsDefaults = SettingsDefaults>(\n options: SettingsOptions<D> = {},\n): SettingsReader<D> {\n const env = options.env ?? process.env;\n const defaults = options.defaults;\n const ttlMs = options.ttlMs ?? Number(env.REVENEXX_SETTINGS_TTL_MS ?? DEFAULT_SETTINGS_TTL_MS);\n const errorTtlMs = options.errorTtlMs ?? DEFAULT_SETTINGS_ERROR_TTL_MS;\n const timeoutMs = options.timeoutMs ?? DEFAULT_SETTINGS_TIMEOUT_MS;\n const endpoint = String(options.endpoint || env.REVENEXX_GATEWAY_ENDPOINT || DEFAULT_GATEWAY_ENDPOINT).replace(\n /\\/+$/,\n '',\n );\n\n const cache = new Map<string, Entry<D>>();\n /** Last successful snapshot per key — served instead of defaults on a blip. */\n const lastGood = new Map<string, SettingsSnapshot<D>>();\n\n const appName = (): string => String(options.app || env.REVENEXX_APP_NAME || '').trim();\n\n const fallback = (app: string, tenant: string, market: string | null, error: string): SettingsSnapshot<D> => ({\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, undefined),\n masked: [],\n resolved: false,\n error,\n });\n\n const report = (err: Error, info: { app: string; tenant: string; market: string | null }): void => {\n try {\n options.onError?.(err, info);\n } catch {\n /* an error reporter must never be the reason a request fails */\n }\n };\n\n async function request(app: string, tenant: string, token: string, market: string | null): Promise<SettingsSnapshot<D>> {\n const f = options.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') throw new Error('settings: no fetch available (Node >=18 or pass fetchImpl)');\n\n const qs = market ? `?market=${encodeURIComponent(market)}` : '';\n const headers: Record<string, string> = { Accept: 'application/json', 'X-Revenexx-Tenant': tenant };\n if (token) headers.Authorization = `Bearer ${token}`;\n\n const signal = timeoutSignal(timeoutMs);\n const res = await f(`${endpoint}/v1/settings/apps/${encodeURIComponent(app)}${qs}`, {\n method: 'GET',\n headers,\n ...(signal ? { signal } : {}),\n });\n const text = await res.text();\n if (!res.ok) {\n const err = new Error(`settings: ${res.status} for ${app}`) as Error & { status?: number };\n err.status = res.status;\n throw err;\n }\n const body = (text ? JSON.parse(text) : {}) as GatewayResponse;\n return {\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, body.settings),\n masked: Array.isArray(body.masked) ? body.masked.filter((k): k is string => typeof k === 'string') : [],\n resolved: true,\n };\n }\n\n async function load(source?: SettingsSource, readOptions: ReadOptions = {}): Promise<SettingsSnapshot<D>> {\n const app = appName();\n const tenant = (source?.tenant ?? '') || headerOf(source, 'x-revenexx-tenant');\n const market = (readOptions.market ?? headerOf(source, 'x-revenexx-market')).trim() || null;\n\n // Nothing to ask with — answer from the defaults without a round trip.\n if (!app) return fallback('', tenant, market, 'no app name (pass `app` or set REVENEXX_APP_NAME)');\n if (!tenant) return fallback(app, '', market, 'no tenant on the request');\n\n const key = `${tenant}\u0000${app}\u0000${market ?? ''}`;\n const now = Date.now();\n const hit = cache.get(key);\n if (hit && now - hit.at < hit.ttl) return hit.promise;\n\n const token = (source?.contextToken ?? '') || headerOf(source, 'x-revenexx-context');\n const entry: Entry<D> = { at: now, ttl: ttlMs, promise: undefined as unknown as Promise<SettingsSnapshot<D>> };\n entry.promise = request(app, tenant, token, market)\n .then((snapshot) => {\n lastGood.set(key, snapshot);\n return snapshot;\n })\n .catch((err: unknown) => {\n const error = err instanceof Error ? err : new Error(String(err));\n // A 404 is the gateway saying \"this app is not installed, or declares\n // no settings\" — a stable answer, not a blip. Cache it for the full TTL\n // so an app without settings does not re-ask every five seconds.\n const status = (error as { status?: number }).status;\n entry.ttl = status === 404 ? ttlMs : errorTtlMs;\n report(error, { app, tenant, market });\n // Prefer the last values we genuinely resolved over the defaults: they\n // are the tenant's actual configuration, and a gateway blip is no\n // reason to silently revert a merchant's choices.\n const stale = lastGood.get(key);\n if (stale) return { ...stale, resolved: false, error: error.message };\n return fallback(app, tenant, market, error.message);\n });\n\n // Cached before it settles, so concurrent requests share one fetch.\n cache.set(key, entry);\n return entry.promise;\n }\n\n return {\n load,\n async get(source?: SettingsSource, readOptions?: ReadOptions): Promise<ResolvedSettings<D>> {\n return (await load(source, readOptions)).settings;\n },\n clear(): void {\n cache.clear();\n lastGood.clear();\n },\n };\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 * What counts as an update.\n *\n * PostgREST answers a `PATCH` whose body carries no columns with `200 []` — no\n * error, no representation. The adapter then hands `rows[0]` (i.e. `undefined`)\n * back as the updated row, and the App serialises it: open-runtimes does\n * `Buffer.from(JSON.stringify(obj), 'utf8')`, and `JSON.stringify(undefined)`\n * is `undefined`, so Node throws\n *\n * TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string\n * or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object.\n * Received undefined\n *\n * which the App reports as a 500. A caller who sent nothing to update is told\n * the service is broken instead of what to send.\n *\n * The rule lives here, one level below the router, because not every App routes\n * its writes through `mountCrud`: `PUT /v1/greetings/{id}` and\n * `PUT /v1/payments/providers/{id}` are hand-written handlers that call\n * `db.<entity>.update()` directly, and they were the two endpoints that 500ed.\n * A guard in `mountCrud` alone only protects the Apps that happen to use it.\n */\n\nimport { badRequest } from './errors.js';\n\n/** The one wording every layer uses for \"you sent nothing to update\". */\nexport const EMPTY_UPDATE_MESSAGE = 'request body must contain at least one field to update';\n\n/**\n * The fields a patch would actually send. `undefined` values are excluded\n * because `JSON.stringify` drops them: `{ name: undefined }` reaches PostgREST\n * as `{}` and is exactly as empty as `{}` itself.\n */\nexport function updateFields(patch: unknown): string[] {\n if (!patch || typeof patch !== 'object' || Array.isArray(patch)) return [];\n return Object.keys(patch as Record<string, unknown>).filter(\n (key) => (patch as Record<string, unknown>)[key] !== undefined,\n );\n}\n\n/** Throw a 400 when a patch carries nothing to write. */\nexport function assertUpdatable(patch: unknown): void {\n if (updateFields(patch).length === 0) throw badRequest(EMPTY_UPDATE_MESSAGE);\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';\nimport { EMPTY_UPDATE_MESSAGE, updateFields } from '../patch.js';\nimport type { SettingsDefaults } from '../settings.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\n/** `json` / `jsonb`, read off the generated ENTITIES column metadata. */\nconst isJsonColumn = (def: unknown): boolean =>\n /^jsonb?\\b/i.test(String((def as { type?: unknown } | null | undefined)?.type ?? ''));\n\n/**\n * A filter on a jsonb column is a whole-document equality, so the value has to\n * be a JSON document. `k in opts.columns` never looked at the column *type*, so\n * anything else went to the data plane as `col=eq.<junk>`; Postgres failed the\n * cast (SQLSTATE 22P02) and the caller got a 400 that named neither the\n * parameter nor what a good value looks like:\n *\n * GET /v1/forms?definition=x -> 400 {\"error\":\"a value in the request has\n * the wrong format\",\"code\":\"invalid_value\"}\n *\n * It is our query parameter, so it is our 400. Same status and same `code` as\n * before — only the message becomes actionable, and the round trip disappears.\n * The rule is exactly the data plane's: it must parse as JSON. Postgres compares\n * jsonb semantically, so key order and whitespace stay irrelevant and nothing\n * that worked before stops working — a whole, exactly-serialised document is\n * still forwarded unchanged.\n *\n * Deliberately NOT a containment (`cs.`) filter: `?labels={\"de\":\"Hauptlager\"}`\n * matches one exact document today, and turning that into \"contains\" would\n * silently widen a filter three apps already declare, with examples, as\n * equality. Widening it is a product decision, not a bug fix.\n *\n * The message states the rule and does NOT show an instance of the document.\n * It cannot: the generated column metadata carries `type`, `notNull` and\n * sometimes `default`, and nothing about the shape — 22 of the 25 jsonb\n * columns in `products` have no default at all. The first version borrowed\n * one column's example for every column, so a filter on an array-shaped\n * document (`family_variants.axes`, `measurement_families.units`) was\n * illustrated with an object. A caller who copies that shape sends valid JSON,\n * so there is no 400 — the answer is 200 with zero rows, which is the worst\n * failure this API has. The honest example is per column, the app knows it,\n * and it is already published on the parameter; so point there instead of\n * inventing one here.\n */\nfunction assertJsonFilter(column: string, value: string): void {\n try {\n JSON.parse(value);\n } catch {\n throw new HttpError(\n 400,\n `filter '${column}' must be a whole JSON document, serialized exactly as stored ` +\n `and compared for equality — not a path or containment query. ` +\n `This parameter's example in the API contract shows the shape this column holds.`,\n undefined,\n { code: 'invalid_value' },\n );\n }\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<D extends SettingsDefaults = SettingsDefaults>(\n app: App<D>,\n repo: RepoLike,\n opts: CrudOptions,\n): App<D> {\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 // A key naming no column is dropped, not refused: `filter` below echoes\n // exactly the keys that were honoured, so `filter: {}` next to a full\n // page is how a caller tells \"not filtered\" from \"filtered to nothing\".\n // Thirteen live apps document that, and 400ing instead would break every\n // client that carries a stray parameter.\n if (!opts.columns || !(k in opts.columns)) continue;\n if (isJsonColumn(opts.columns[k])) assertJsonFilter(k, v);\n 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. The rule itself\n // lives in ../patch.ts and is enforced by the data client, so Apps that\n // hand-write their PUT handler get it too; this check stays because it is\n // the only one that can see the *body* rather than the merged patch —\n // with a nested parent the merge always carries the FK, so the patch is\n // never literally empty — and because it answers without a round trip.\n if (updateFields(c.body).length === 0) throw new HttpError(400, EMPTY_UPDATE_MESSAGE);\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":"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","names":["headerOf","otelContext","items"]}
|
|
1
|
+
{"version":3,"sources":["../../src/router/index.ts","../../src/instrument.ts","../../src/router/router.ts","../../src/router/actor.ts","../../src/settings.ts","../../src/errors.ts","../../src/patch.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\n// Who is acting. `createApp` reads it for you (`c.actor`); `actorFrom` is here\n// for code outside a handler that has the same headers in hand.\nexport { actorFrom, ACTOR_HEADERS } from './actor.js';\nexport type { Actor, ActorTrust, ActorPlane } from './actor.js';\n\nexport { mountCrud } from './crud.js';\nexport type { CrudOptions, RepoLike } from './crud.js';\n\n// App settings. `createApp` builds a reader for you (`c.settings()`); create\n// one directly when code outside a handler needs the same values.\nexport {\n createSettings,\n DEFAULT_GATEWAY_ENDPOINT,\n DEFAULT_SETTINGS_TTL_MS,\n DEFAULT_SETTINGS_ERROR_TTL_MS,\n DEFAULT_SETTINGS_TIMEOUT_MS,\n} from '../settings.js';\nexport type {\n SettingsReader,\n SettingsOptions,\n SettingsSnapshot,\n SettingsSource,\n SettingsDefaults,\n ResolvedSettings,\n ReadOptions,\n} from '../settings.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';\nimport { actorFrom } from './actor.js';\nimport type { Actor } from './actor.js';\nimport { createSettings } from '../settings.js';\nimport type {\n ReadOptions,\n ResolvedSettings,\n SettingsDefaults,\n SettingsOptions,\n SettingsReader,\n SettingsSnapshot,\n} from '../settings.js';\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<D extends SettingsDefaults = SettingsDefaults> {\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 /**\n * Who is acting — the person behind this request, as the platform\n * established them (see ./actor.ts).\n *\n * `c.tenant` says whose data this is; this says whose hand is on it. Read\n * `c.actor.authenticated()` before enforcing a per-person rule, and\n * `c.actor.plane` to tell one of the tenant's contacts from a back-office\n * operator from a system caller. Never derive either from the context\n * token's claims: those describe the calling SYSTEM.\n */\n actor: Actor;\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 * This tenant's effective settings for the app, resolved for the request's\n * market. Cached and fail-open — see `createSettings`. Available on every\n * app; pass `settings` to `createApp` to declare defaults and get them typed.\n */\n settings(options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n settingsSnapshot(options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n}\n\nexport type Handler<D extends SettingsDefaults = SettingsDefaults> = (\n c: RouteContext<D>,\n) => 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<D extends SettingsDefaults> {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler<D>;\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 // The runtime hands `req.query` through UNDECODED — measured in production\n // against every one of the 13 apps after 0.6.0 shipped:\n //\n // GET /v1/customers/organizations?name=ACME%20GmbH\n // -> returned 0, filter {\"name\":\"ACME%20GmbH\"} (the row 'ACME GmbH' exists)\n //\n // 0.6.0 only decoded when the query rode on `req.path`, which this runtime\n // does not do, so the fix was inert. Decode here as well; each source is\n // still decoded exactly once, because the branch above returns.\n for (const [k, v] of Object.entries(req.query ?? {})) {\n const raw = typeof v === 'string' ? v : v == null ? null : String(v);\n if (raw !== null) out[decodeComponent(k)] = decodeComponent(raw);\n }\n return out;\n}\n\n/**\n * Percent-decode one query key or value, treating `+` as a space the way a\n * form-encoded query requires.\n *\n * Falls back to the input when it is not valid percent-encoding — a lone `%`\n * is a legitimate character in a search term, and throwing a URIError on it\n * would turn a harmless filter into a 500.\n */\nfunction decodeComponent(value: string): string {\n try {\n return decodeURIComponent(value.replace(/\\+/g, ' '));\n } catch {\n return value;\n }\n}\n\nexport interface AppOptions<D extends SettingsDefaults = SettingsDefaults> {\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 * App settings behind `c.settings()`. Pass the defaults your settings.json\n * declares — they type the resolved object and are what the app runs on if\n * the settings service is unreachable:\n *\n * createApp({ name: 'orders', settings: { defaults: { auto_reserve: true } } })\n *\n * `app` defaults to this app's `name`. Pass a reader built with\n * `createSettings` instead when you want to share it with code outside the\n * router. Omit entirely and `c.settings()` still works — it just has no\n * declared defaults to fall back on.\n */\n settings?: Omit<SettingsOptions<D>, 'app'> & { app?: string } | SettingsReader<D>;\n}\n\nexport interface App<D extends SettingsDefaults = SettingsDefaults> {\n get(template: string, handler: Handler<D>): App<D>;\n post(template: string, handler: Handler<D>): App<D>;\n put(template: string, handler: Handler<D>): App<D>;\n patch(template: string, handler: Handler<D>): App<D>;\n delete(template: string, handler: Handler<D>): App<D>;\n on(method: string, template: string, handler: Handler<D>): App<D>;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** The settings reader backing `c.settings()` (e.g. to clear its cache). */\n settings: SettingsReader<D>;\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst isSettingsReader = <D extends SettingsDefaults>(\n value: NonNullable<AppOptions<D>['settings']>,\n): value is SettingsReader<D> => typeof (value as SettingsReader<D>).get === 'function';\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<D extends SettingsDefaults = SettingsDefaults>(options: AppOptions<D> = {}): App<D> {\n const routes: CompiledRoute<D>[] = [];\n const health = options.health !== false;\n // The app knows its own name, so the settings reader does not have to be told\n // it. One reader per app, created once: the cache lives on it.\n const settings: SettingsReader<D> =\n options.settings && isSettingsReader(options.settings)\n ? options.settings\n : createSettings<D>({ app: options.name, ...(options.settings ?? {}) });\n\n const app: App<D> = {\n settings,\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<D>; 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<D> = {\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 actor: actorFrom((name) => headerOf(headers, name)),\n log,\n json: (data, statusCode = 200) => res.json(data, statusCode),\n // The market rides on the request, so a market-scoped setting\n // resolves for the market this call is for — no argument needed.\n settings: (readOptions) => settings.get(c, readOptions),\n settingsSnapshot: (readOptions) => settings.load(c, readOptions),\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 * Who is acting — the person behind a request, as the platform established\n * them.\n *\n * An app has always been told which TENANT a call is for. Which PERSON was a\n * different question, and for a long time it had no answer: the brokered\n * context identifies the calling system (in a theme site, the theme's service\n * user — a robot with no name), the gateway strips inbound identity headers\n * because they are forgeable, and anything in the request body is the caller's\n * own word about itself. Apps that needed a person resolved one out of the\n * context's email claim and hoped, or read an `_actor` out of the body and\n * called it attribution rather than authentication, because that is all it was.\n *\n * The gateway now states it (RAD-12), on two planes:\n *\n * - ASSERTED. A storefront call is made by a server — the theme BFF, holding\n * the tenant API key — on behalf of a customer. The credential proves the\n * tenant, so the caller names the person and the gateway resolves that name\n * through the tenant's role provider. It defends against a malicious end\n * user, not against a compromised BFF.\n * - AUTHENTICATED. A Cockpit call, or any call carrying a person's own\n * Zitadel token, needs nobody's word: the signature and issuer were\n * verified before a route was matched, and the contact — if there is one —\n * was resolved from that proven subject.\n *\n * Both arrive in the same headers, which is exactly why `trust` exists. The\n * same `contact` is a signature on one plane and a label on the other, and an\n * app deciding an approval has to be able to tell the two apart. An app that\n * only attributes — a \"last edited by\" — can ignore it.\n *\n * Every header read here is set ONLY by the gateway: it builds a fresh header\n * set per dispatch and strips any copy a caller sent. So `actor.trust` cannot\n * be talked up from outside, and an app never has to decide whether to believe\n * a header — only what to do with what it says.\n */\n\n/** How the platform came to know who is acting. */\nexport type ActorTrust = 'authenticated' | 'asserted' | 'none';\n\n/**\n * Which side of the platform the caller is on.\n *\n * - `contact` — one of the tenant's own people: a buyer, an approver.\n * - `operator` — a human the PLATFORM knows and the tenant's records do not.\n * Back office: Cockpit staff, support, a partner operating the tenant. There\n * is no contact to check a per-row rule against, and that absence is the\n * signal, not a failure to resolve one.\n * - `system` — nobody: a schedule, a webhook, a service token, an in-mesh call.\n *\n * This is the distinction apps otherwise make by hand, badly — usually by\n * treating \"no contact resolved\" as \"must be the platform\", which is also what\n * an unknown customer looks like.\n */\nexport type ActorPlane = 'contact' | 'operator' | 'system';\n\n/** The acting person, as far as the platform can state it. */\nexport interface Actor {\n /** The authenticated human's platform subject, or null when none was proven. */\n user: string | null;\n /** Their email claim, or null. Attribution — never a lookup key to trust on its own. */\n email: string | null;\n /** The `customers` contact the platform resolved them to, or null. */\n contact: string | null;\n /** That contact's organization, or null. */\n organization: string | null;\n /** The permissions the tenant's role provider granted them. Empty when there is no contact. */\n permissions: string[];\n /** How well `contact` is known. `none` when nobody was established at all. */\n trust: ActorTrust;\n /** Which side of the platform the caller is on. */\n plane: ActorPlane;\n /** Does this actor hold the permission? False for every permission when nobody is acting. */\n holds(permission: string): boolean;\n /**\n * Is this a person the platform itself authenticated?\n *\n * The one check a per-person rule should make. An app enforcing \"only the\n * approver this approval names may decide it\" needs a signature, and only\n * this plane produces one.\n */\n authenticated(): boolean;\n}\n\n/** Gateway-set headers. Named here so a reader can grep the wire format. */\nexport const ACTOR_HEADERS = {\n user: 'x-revenexx-actor',\n email: 'x-revenexx-actor-email',\n trust: 'x-revenexx-actor-trust',\n contact: 'x-revenexx-contact',\n organization: 'x-revenexx-organization',\n permissions: 'x-revenexx-permissions',\n} as const;\n\nconst nullIfEmpty = (v: string): string | null => (v.trim() === '' ? null : v.trim());\n\n/**\n * Read the acting person out of a request's headers.\n *\n * Unknown values of the trust header degrade to `asserted` rather than to\n * `authenticated`: a gateway that learns a third plane must not silently\n * promote it past a signature check written today.\n */\nexport function actorFrom(header: (name: string) => string | undefined): Actor {\n // A caller outside a handler has its own header bag — a Node request answers\n // `undefined` for a header nobody sent and an array for one sent twice. Read\n // everything through here so neither shape reaches a `.trim()`.\n const read = (name: string): string => {\n const v = header(name);\n return typeof v === 'string' ? v : '';\n };\n\n const user = nullIfEmpty(read(ACTOR_HEADERS.user));\n const contact = nullIfEmpty(read(ACTOR_HEADERS.contact));\n const permissions = read(ACTOR_HEADERS.permissions)\n .split(',')\n .map((p) => p.trim())\n .filter(Boolean);\n\n // Nobody established: `none`, whatever the header says. An app reading\n // `trust === 'asserted'` must not see it for a call that named no one.\n //\n // And `authenticated` needs the person it authenticated: a trust header\n // arriving beside no subject is a plane half-stated, which degrades like any\n // other value the gateway did not mean.\n const raw = read(ACTOR_HEADERS.trust).trim().toLowerCase();\n const trust: ActorTrust =\n user === null && contact === null\n ? 'none'\n : user !== null && raw === 'authenticated'\n ? 'authenticated'\n : 'asserted';\n\n const plane: ActorPlane = contact !== null ? 'contact' : user !== null ? 'operator' : 'system';\n const held = new Set(permissions);\n\n return {\n user,\n email: nullIfEmpty(read(ACTOR_HEADERS.email)),\n contact,\n organization: nullIfEmpty(read(ACTOR_HEADERS.organization)),\n permissions,\n trust,\n plane,\n holds: (permission) => permission !== '' && held.has(permission),\n authenticated: () => trust === 'authenticated',\n };\n}\n","/**\n * App settings — the tenant's configuration for THIS app, read at runtime.\n *\n * An App declares its settings in `settings.json` (`{ settings: { <key>:\n * { type, scope, default, sensitive, ... } } }`). The cockpit renders that\n * schema, Console stores the tenant's chosen values, and the gateway resolves\n * the two into an effective map:\n *\n * GET {gateway}/v1/settings/apps/{app}[?market={code}]\n * -> { app, market, settings: { … }, masked: [ … ] }\n *\n * Resolution happens ON THE GATEWAY, and this reader does not second-guess it.\n * Per key, the gateway applies (api/internal/gateway/settings.go,\n * `resolveSettings`):\n *\n * 1. per-market override — only for settings declared `\"scope\": \"market\"`,\n * and only when `?market=` is sent\n * 2. stored tenant value — the flat value in `settings_values`\n * 3. schema default — the `default` from settings.json\n *\n * Settings flagged `sensitive` are never in `settings`; their keys are listed\n * in `masked` so a caller can tell \"not configured\" from \"not for you\".\n *\n * The `defaults` you pass here are a *fourth*, last-resort layer: they are what\n * the app runs on when the settings service cannot be reached, and they are\n * what types the resolved object. They never override a value the gateway\n * actually resolved — only a `null`/absent one.\n *\n * const settings = createSettings({\n * app: 'orders',\n * defaults: { auto_reserve: true, reservation_minutes: 30 },\n * });\n *\n * app.post('/orders', async (c) => {\n * const s = await settings.get(c); // market taken from the request\n * if (s.auto_reserve) { … }\n * });\n *\n * Or let the router own it — `createApp({ name, settings: { defaults } })`\n * gives every handler `await c.settings()`.\n *\n * Two properties make this safe to call on every request:\n *\n * - it FAILS OPEN. A gateway blip, a missing tenant, a timeout, an app that\n * declares no settings at all: you get the last good values if there are\n * any, otherwise your declared defaults. It never throws and never takes\n * the app down. Availability is the default; switching something off is\n * the deliberate act, and a deliberate act must not be the accident.\n * - it CACHES. Per (tenant, app, market), for a short TTL, with concurrent\n * reads sharing one in-flight request. A warm read is a Map lookup.\n */\n\n/** The platform gateway. Override with REVENEXX_GATEWAY_ENDPOINT. */\nexport const DEFAULT_GATEWAY_ENDPOINT = 'https://api.revenexx.com';\n\n/**\n * How long a resolved settings map stays warm in the process (ms).\n *\n * Settings are configuration, not data: a merchant flips one every few weeks.\n * The gateway keeps its own 30s cache in front of Console and drops it on a\n * NATS invalidation when values change, so this second layer is the only real\n * staleness — a cockpit change takes effect within a minute. That is the right\n * trade against the alternative, which is a gateway round trip on the hot path\n * of every single request.\n *\n * Override per reader (`ttlMs`) or per deployment (REVENEXX_SETTINGS_TTL_MS).\n */\nexport const DEFAULT_SETTINGS_TTL_MS = 60_000;\n\n/**\n * How long a FAILED read stays cached (ms). Short, because the failure is\n * usually transient and we want to recover quickly — but not zero, or an\n * unreachable gateway would put a doomed round trip on every request, which is\n * exactly the outage the fail-open is supposed to absorb.\n *\n * A 404 (\"app not installed or declares no settings\") is not a failure but a\n * stable answer, and is cached for the full TTL.\n */\nexport const DEFAULT_SETTINGS_ERROR_TTL_MS = 5_000;\n\n/** Request timeout (ms). A hung settings service must not hang the app. */\nexport const DEFAULT_SETTINGS_TIMEOUT_MS = 2_000;\n\nexport type SettingsDefaults = Record<string, unknown>;\n\n/**\n * The resolved map. Keys you declared in `defaults` keep their type; anything\n * else the manifest declares is still there, as `unknown`.\n */\nexport type ResolvedSettings<D extends SettingsDefaults = SettingsDefaults> = D & Record<string, unknown>;\n\n/**\n * Anything a request's tenant/token/market can be read from: the router's\n * `RouteContext`, the raw function context (`{ req: { headers } }`), or a bare\n * headers object.\n */\nexport interface SettingsSource {\n header?(name: string): string;\n tenant?: string | null;\n contextToken?: string;\n req?: { headers?: Record<string, string> | undefined } | undefined;\n headers?: Record<string, string> | undefined;\n}\n\nexport interface SettingsOptions<D extends SettingsDefaults = SettingsDefaults> {\n /**\n * The app whose settings to read. Defaults to REVENEXX_APP_NAME, which the\n * runtime sets — a deployed app usually needs no value here. `createApp`\n * passes its own `name`.\n */\n app?: string;\n /**\n * Last-resort values, and the type source. Use the same defaults your\n * settings.json declares: they are what the app runs on if the settings\n * service is unreachable.\n */\n defaults?: D;\n /** Gateway base URL. Default: REVENEXX_GATEWAY_ENDPOINT or the platform gateway. */\n endpoint?: string;\n /** Cache TTL in ms. Default: REVENEXX_SETTINGS_TTL_MS or 60_000. */\n ttlMs?: number;\n /** How long a failed read is cached, in ms. Default 5_000. */\n errorTtlMs?: number;\n /** Per-request timeout in ms. Default 2_000. */\n timeoutMs?: number;\n /** Environment to read from (tests). Default `process.env`. */\n env?: Record<string, string | undefined>;\n /** Fetch implementation (tests). Default `globalThis.fetch`. */\n fetchImpl?: typeof fetch;\n /**\n * Called when a read fails and the app falls back. Wire it to the function's\n * `error()` so a silent fallback is still visible. Must not throw.\n */\n onError?: (error: Error, info: { app: string; tenant: string; market: string | null }) => void;\n}\n\n/** A resolved read, with the provenance a caller occasionally needs. */\nexport interface SettingsSnapshot<D extends SettingsDefaults = SettingsDefaults> {\n app: string;\n tenant: string;\n /** The market the values were resolved for, or null for the tenant baseline. */\n market: string | null;\n settings: ResolvedSettings<D>;\n /** Keys that exist but are `sensitive`, so their values were withheld. */\n masked: string[];\n /** true when these values came from the gateway (fresh or cached). */\n resolved: boolean;\n /** Why the fallback happened, when `resolved` is false. */\n error?: string;\n}\n\nexport interface ReadOptions {\n /** Resolve for this market instead of the one on the request. `''` = tenant baseline. */\n market?: string;\n}\n\nexport interface SettingsReader<D extends SettingsDefaults = SettingsDefaults> {\n /** The effective settings for this request. Never throws. */\n get(source?: SettingsSource, options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n load(source?: SettingsSource, options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n /** Drop the cache (tests, or right after writing settings). */\n clear(): void;\n}\n\ninterface Entry<D extends SettingsDefaults> {\n at: number;\n ttl: number;\n promise: Promise<SettingsSnapshot<D>>;\n}\n\ninterface GatewayResponse {\n settings?: Record<string, unknown>;\n masked?: unknown;\n}\n\n/** Case-insensitive header read across the three shapes we accept. */\nfunction headerOf(source: SettingsSource | undefined, name: string): string {\n if (!source) return '';\n if (typeof source.header === 'function') {\n const v = source.header(name);\n if (typeof v === 'string' && v !== '') return v;\n }\n const bags = [source.req?.headers, source.headers];\n const want = name.toLowerCase();\n for (const bag of bags) {\n if (!bag) continue;\n const direct = bag[name] ?? bag[want];\n if (typeof direct === 'string' && direct !== '') return direct;\n for (const [k, v] of Object.entries(bag)) {\n if (k.toLowerCase() === want && typeof v === 'string' && v !== '') return v;\n }\n }\n return '';\n}\n\n/**\n * Merge the gateway's resolved map over the declared defaults.\n *\n * A `null` from the gateway does NOT clobber a default: a setting the merchant\n * never touched and whose schema carries no default resolves to `null`, and a\n * caller should not have to null-check a key it declared a default for. A real\n * stored value — including `false`, `0` and `''` — always wins.\n */\nfunction mergeSettings<D extends SettingsDefaults>(\n defaults: D | undefined,\n resolved: Record<string, unknown> | undefined,\n): ResolvedSettings<D> {\n const out: Record<string, unknown> = { ...(defaults ?? {}) };\n for (const [key, value] of Object.entries(resolved ?? {})) {\n if (value !== null && value !== undefined) out[key] = value;\n else if (!(key in out)) out[key] = value ?? null;\n }\n return out as ResolvedSettings<D>;\n}\n\nfunction timeoutSignal(ms: number): AbortSignal | undefined {\n const factory = (AbortSignal as { timeout?: (ms: number) => AbortSignal }).timeout;\n if (typeof factory === 'function') return factory(ms);\n if (typeof AbortController !== 'function') return undefined;\n const controller = new AbortController();\n setTimeout(() => controller.abort(), ms).unref?.();\n return controller.signal;\n}\n\n/**\n * Build a settings reader for one app. Create it once at module scope — the\n * cache lives on the reader, and a per-request reader would cache nothing.\n */\nexport function createSettings<D extends SettingsDefaults = SettingsDefaults>(\n options: SettingsOptions<D> = {},\n): SettingsReader<D> {\n const env = options.env ?? process.env;\n const defaults = options.defaults;\n const ttlMs = options.ttlMs ?? Number(env.REVENEXX_SETTINGS_TTL_MS ?? DEFAULT_SETTINGS_TTL_MS);\n const errorTtlMs = options.errorTtlMs ?? DEFAULT_SETTINGS_ERROR_TTL_MS;\n const timeoutMs = options.timeoutMs ?? DEFAULT_SETTINGS_TIMEOUT_MS;\n const endpoint = String(options.endpoint || env.REVENEXX_GATEWAY_ENDPOINT || DEFAULT_GATEWAY_ENDPOINT).replace(\n /\\/+$/,\n '',\n );\n\n const cache = new Map<string, Entry<D>>();\n /** Last successful snapshot per key — served instead of defaults on a blip. */\n const lastGood = new Map<string, SettingsSnapshot<D>>();\n\n const appName = (): string => String(options.app || env.REVENEXX_APP_NAME || '').trim();\n\n const fallback = (app: string, tenant: string, market: string | null, error: string): SettingsSnapshot<D> => ({\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, undefined),\n masked: [],\n resolved: false,\n error,\n });\n\n const report = (err: Error, info: { app: string; tenant: string; market: string | null }): void => {\n try {\n options.onError?.(err, info);\n } catch {\n /* an error reporter must never be the reason a request fails */\n }\n };\n\n async function request(app: string, tenant: string, token: string, market: string | null): Promise<SettingsSnapshot<D>> {\n const f = options.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') throw new Error('settings: no fetch available (Node >=18 or pass fetchImpl)');\n\n const qs = market ? `?market=${encodeURIComponent(market)}` : '';\n const headers: Record<string, string> = { Accept: 'application/json', 'X-Revenexx-Tenant': tenant };\n if (token) headers.Authorization = `Bearer ${token}`;\n\n const signal = timeoutSignal(timeoutMs);\n const res = await f(`${endpoint}/v1/settings/apps/${encodeURIComponent(app)}${qs}`, {\n method: 'GET',\n headers,\n ...(signal ? { signal } : {}),\n });\n const text = await res.text();\n if (!res.ok) {\n const err = new Error(`settings: ${res.status} for ${app}`) as Error & { status?: number };\n err.status = res.status;\n throw err;\n }\n const body = (text ? JSON.parse(text) : {}) as GatewayResponse;\n return {\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, body.settings),\n masked: Array.isArray(body.masked) ? body.masked.filter((k): k is string => typeof k === 'string') : [],\n resolved: true,\n };\n }\n\n async function load(source?: SettingsSource, readOptions: ReadOptions = {}): Promise<SettingsSnapshot<D>> {\n const app = appName();\n const tenant = (source?.tenant ?? '') || headerOf(source, 'x-revenexx-tenant');\n const market = (readOptions.market ?? headerOf(source, 'x-revenexx-market')).trim() || null;\n\n // Nothing to ask with — answer from the defaults without a round trip.\n if (!app) return fallback('', tenant, market, 'no app name (pass `app` or set REVENEXX_APP_NAME)');\n if (!tenant) return fallback(app, '', market, 'no tenant on the request');\n\n const key = `${tenant}\u0000${app}\u0000${market ?? ''}`;\n const now = Date.now();\n const hit = cache.get(key);\n if (hit && now - hit.at < hit.ttl) return hit.promise;\n\n const token = (source?.contextToken ?? '') || headerOf(source, 'x-revenexx-context');\n const entry: Entry<D> = { at: now, ttl: ttlMs, promise: undefined as unknown as Promise<SettingsSnapshot<D>> };\n entry.promise = request(app, tenant, token, market)\n .then((snapshot) => {\n lastGood.set(key, snapshot);\n return snapshot;\n })\n .catch((err: unknown) => {\n const error = err instanceof Error ? err : new Error(String(err));\n // A 404 is the gateway saying \"this app is not installed, or declares\n // no settings\" — a stable answer, not a blip. Cache it for the full TTL\n // so an app without settings does not re-ask every five seconds.\n const status = (error as { status?: number }).status;\n entry.ttl = status === 404 ? ttlMs : errorTtlMs;\n report(error, { app, tenant, market });\n // Prefer the last values we genuinely resolved over the defaults: they\n // are the tenant's actual configuration, and a gateway blip is no\n // reason to silently revert a merchant's choices.\n const stale = lastGood.get(key);\n if (stale) return { ...stale, resolved: false, error: error.message };\n return fallback(app, tenant, market, error.message);\n });\n\n // Cached before it settles, so concurrent requests share one fetch.\n cache.set(key, entry);\n return entry.promise;\n }\n\n return {\n load,\n async get(source?: SettingsSource, readOptions?: ReadOptions): Promise<ResolvedSettings<D>> {\n return (await load(source, readOptions)).settings;\n },\n clear(): void {\n cache.clear();\n lastGood.clear();\n },\n };\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 * What counts as an update.\n *\n * PostgREST answers a `PATCH` whose body carries no columns with `200 []` — no\n * error, no representation. The adapter then hands `rows[0]` (i.e. `undefined`)\n * back as the updated row, and the App serialises it: open-runtimes does\n * `Buffer.from(JSON.stringify(obj), 'utf8')`, and `JSON.stringify(undefined)`\n * is `undefined`, so Node throws\n *\n * TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string\n * or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object.\n * Received undefined\n *\n * which the App reports as a 500. A caller who sent nothing to update is told\n * the service is broken instead of what to send.\n *\n * The rule lives here, one level below the router, because not every App routes\n * its writes through `mountCrud`: `PUT /v1/greetings/{id}` and\n * `PUT /v1/payments/providers/{id}` are hand-written handlers that call\n * `db.<entity>.update()` directly, and they were the two endpoints that 500ed.\n * A guard in `mountCrud` alone only protects the Apps that happen to use it.\n */\n\nimport { badRequest } from './errors.js';\n\n/** The one wording every layer uses for \"you sent nothing to update\". */\nexport const EMPTY_UPDATE_MESSAGE = 'request body must contain at least one field to update';\n\n/**\n * The fields a patch would actually send. `undefined` values are excluded\n * because `JSON.stringify` drops them: `{ name: undefined }` reaches PostgREST\n * as `{}` and is exactly as empty as `{}` itself.\n */\nexport function updateFields(patch: unknown): string[] {\n if (!patch || typeof patch !== 'object' || Array.isArray(patch)) return [];\n return Object.keys(patch as Record<string, unknown>).filter(\n (key) => (patch as Record<string, unknown>)[key] !== undefined,\n );\n}\n\n/** Throw a 400 when a patch carries nothing to write. */\nexport function assertUpdatable(patch: unknown): void {\n if (updateFields(patch).length === 0) throw badRequest(EMPTY_UPDATE_MESSAGE);\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';\nimport { EMPTY_UPDATE_MESSAGE, updateFields } from '../patch.js';\nimport type { SettingsDefaults } from '../settings.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\n/** `json` / `jsonb`, read off the generated ENTITIES column metadata. */\nconst isJsonColumn = (def: unknown): boolean =>\n /^jsonb?\\b/i.test(String((def as { type?: unknown } | null | undefined)?.type ?? ''));\n\n/**\n * A filter on a jsonb column is a whole-document equality, so the value has to\n * be a JSON document. `k in opts.columns` never looked at the column *type*, so\n * anything else went to the data plane as `col=eq.<junk>`; Postgres failed the\n * cast (SQLSTATE 22P02) and the caller got a 400 that named neither the\n * parameter nor what a good value looks like:\n *\n * GET /v1/forms?definition=x -> 400 {\"error\":\"a value in the request has\n * the wrong format\",\"code\":\"invalid_value\"}\n *\n * It is our query parameter, so it is our 400. Same status and same `code` as\n * before — only the message becomes actionable, and the round trip disappears.\n * The rule is exactly the data plane's: it must parse as JSON. Postgres compares\n * jsonb semantically, so key order and whitespace stay irrelevant and nothing\n * that worked before stops working — a whole, exactly-serialised document is\n * still forwarded unchanged.\n *\n * Deliberately NOT a containment (`cs.`) filter: `?labels={\"de\":\"Hauptlager\"}`\n * matches one exact document today, and turning that into \"contains\" would\n * silently widen a filter three apps already declare, with examples, as\n * equality. Widening it is a product decision, not a bug fix.\n *\n * The message states the rule and does NOT show an instance of the document.\n * It cannot: the generated column metadata carries `type`, `notNull` and\n * sometimes `default`, and nothing about the shape — 22 of the 25 jsonb\n * columns in `products` have no default at all. The first version borrowed\n * one column's example for every column, so a filter on an array-shaped\n * document (`family_variants.axes`, `measurement_families.units`) was\n * illustrated with an object. A caller who copies that shape sends valid JSON,\n * so there is no 400 — the answer is 200 with zero rows, which is the worst\n * failure this API has. The honest example is per column, the app knows it,\n * and it is already published on the parameter; so point there instead of\n * inventing one here.\n */\nfunction assertJsonFilter(column: string, value: string): void {\n try {\n JSON.parse(value);\n } catch {\n throw new HttpError(\n 400,\n `filter '${column}' must be a whole JSON document, serialized exactly as stored ` +\n `and compared for equality — not a path or containment query. ` +\n `This parameter's example in the API contract shows the shape this column holds.`,\n undefined,\n { code: 'invalid_value' },\n );\n }\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<D extends SettingsDefaults = SettingsDefaults>(\n app: App<D>,\n repo: RepoLike,\n opts: CrudOptions,\n): App<D> {\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 // A key naming no column is dropped, not refused: `filter` below echoes\n // exactly the keys that were honoured, so `filter: {}` next to a full\n // page is how a caller tells \"not filtered\" from \"filtered to nothing\".\n // Thirteen live apps document that, and 400ing instead would break every\n // client that carries a stray parameter.\n if (!opts.columns || !(k in opts.columns)) continue;\n if (isJsonColumn(opts.columns[k])) assertJsonFilter(k, v);\n 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. The rule itself\n // lives in ../patch.ts and is enforced by the data client, so Apps that\n // hand-write their PUT handler get it too; this check stays because it is\n // the only one that can see the *body* rather than the merged patch —\n // with a nested parent the merge always carries the FK, so the patch is\n // never literally empty — and because it answers without a round trip.\n if (updateFields(c.body).length === 0) throw new HttpError(400, EMPTY_UPDATE_MESSAGE);\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":"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","names":["headerOf","otelContext","items"]}
|
package/dist/router/index.d.cts
CHANGED
|
@@ -1,6 +1,103 @@
|
|
|
1
1
|
import { m as SettingsDefaults, k as ReadOptions, l as ResolvedSettings, p as SettingsSnapshot, o as SettingsReader, n as SettingsOptions, Q as Query, R as Row, P as Page } from '../errors-D7FGkghT.cjs';
|
|
2
2
|
export { D as DEFAULT_GATEWAY_ENDPOINT, e as DEFAULT_SETTINGS_ERROR_TTL_MS, f as DEFAULT_SETTINGS_TIMEOUT_MS, g as DEFAULT_SETTINGS_TTL_MS, H as HttpError, j as HttpErrorOptions, q as SettingsSource, t as badRequest, u as conflict, r as createSettings, v as forbidden, s as isHttpError, w as notFound } from '../errors-D7FGkghT.cjs';
|
|
3
3
|
|
|
4
|
+
/**
|
|
5
|
+
* Who is acting — the person behind a request, as the platform established
|
|
6
|
+
* them.
|
|
7
|
+
*
|
|
8
|
+
* An app has always been told which TENANT a call is for. Which PERSON was a
|
|
9
|
+
* different question, and for a long time it had no answer: the brokered
|
|
10
|
+
* context identifies the calling system (in a theme site, the theme's service
|
|
11
|
+
* user — a robot with no name), the gateway strips inbound identity headers
|
|
12
|
+
* because they are forgeable, and anything in the request body is the caller's
|
|
13
|
+
* own word about itself. Apps that needed a person resolved one out of the
|
|
14
|
+
* context's email claim and hoped, or read an `_actor` out of the body and
|
|
15
|
+
* called it attribution rather than authentication, because that is all it was.
|
|
16
|
+
*
|
|
17
|
+
* The gateway now states it (RAD-12), on two planes:
|
|
18
|
+
*
|
|
19
|
+
* - ASSERTED. A storefront call is made by a server — the theme BFF, holding
|
|
20
|
+
* the tenant API key — on behalf of a customer. The credential proves the
|
|
21
|
+
* tenant, so the caller names the person and the gateway resolves that name
|
|
22
|
+
* through the tenant's role provider. It defends against a malicious end
|
|
23
|
+
* user, not against a compromised BFF.
|
|
24
|
+
* - AUTHENTICATED. A Cockpit call, or any call carrying a person's own
|
|
25
|
+
* Zitadel token, needs nobody's word: the signature and issuer were
|
|
26
|
+
* verified before a route was matched, and the contact — if there is one —
|
|
27
|
+
* was resolved from that proven subject.
|
|
28
|
+
*
|
|
29
|
+
* Both arrive in the same headers, which is exactly why `trust` exists. The
|
|
30
|
+
* same `contact` is a signature on one plane and a label on the other, and an
|
|
31
|
+
* app deciding an approval has to be able to tell the two apart. An app that
|
|
32
|
+
* only attributes — a "last edited by" — can ignore it.
|
|
33
|
+
*
|
|
34
|
+
* Every header read here is set ONLY by the gateway: it builds a fresh header
|
|
35
|
+
* set per dispatch and strips any copy a caller sent. So `actor.trust` cannot
|
|
36
|
+
* be talked up from outside, and an app never has to decide whether to believe
|
|
37
|
+
* a header — only what to do with what it says.
|
|
38
|
+
*/
|
|
39
|
+
/** How the platform came to know who is acting. */
|
|
40
|
+
type ActorTrust = 'authenticated' | 'asserted' | 'none';
|
|
41
|
+
/**
|
|
42
|
+
* Which side of the platform the caller is on.
|
|
43
|
+
*
|
|
44
|
+
* - `contact` — one of the tenant's own people: a buyer, an approver.
|
|
45
|
+
* - `operator` — a human the PLATFORM knows and the tenant's records do not.
|
|
46
|
+
* Back office: Cockpit staff, support, a partner operating the tenant. There
|
|
47
|
+
* is no contact to check a per-row rule against, and that absence is the
|
|
48
|
+
* signal, not a failure to resolve one.
|
|
49
|
+
* - `system` — nobody: a schedule, a webhook, a service token, an in-mesh call.
|
|
50
|
+
*
|
|
51
|
+
* This is the distinction apps otherwise make by hand, badly — usually by
|
|
52
|
+
* treating "no contact resolved" as "must be the platform", which is also what
|
|
53
|
+
* an unknown customer looks like.
|
|
54
|
+
*/
|
|
55
|
+
type ActorPlane = 'contact' | 'operator' | 'system';
|
|
56
|
+
/** The acting person, as far as the platform can state it. */
|
|
57
|
+
interface Actor {
|
|
58
|
+
/** The authenticated human's platform subject, or null when none was proven. */
|
|
59
|
+
user: string | null;
|
|
60
|
+
/** Their email claim, or null. Attribution — never a lookup key to trust on its own. */
|
|
61
|
+
email: string | null;
|
|
62
|
+
/** The `customers` contact the platform resolved them to, or null. */
|
|
63
|
+
contact: string | null;
|
|
64
|
+
/** That contact's organization, or null. */
|
|
65
|
+
organization: string | null;
|
|
66
|
+
/** The permissions the tenant's role provider granted them. Empty when there is no contact. */
|
|
67
|
+
permissions: string[];
|
|
68
|
+
/** How well `contact` is known. `none` when nobody was established at all. */
|
|
69
|
+
trust: ActorTrust;
|
|
70
|
+
/** Which side of the platform the caller is on. */
|
|
71
|
+
plane: ActorPlane;
|
|
72
|
+
/** Does this actor hold the permission? False for every permission when nobody is acting. */
|
|
73
|
+
holds(permission: string): boolean;
|
|
74
|
+
/**
|
|
75
|
+
* Is this a person the platform itself authenticated?
|
|
76
|
+
*
|
|
77
|
+
* The one check a per-person rule should make. An app enforcing "only the
|
|
78
|
+
* approver this approval names may decide it" needs a signature, and only
|
|
79
|
+
* this plane produces one.
|
|
80
|
+
*/
|
|
81
|
+
authenticated(): boolean;
|
|
82
|
+
}
|
|
83
|
+
/** Gateway-set headers. Named here so a reader can grep the wire format. */
|
|
84
|
+
declare const ACTOR_HEADERS: {
|
|
85
|
+
readonly user: "x-revenexx-actor";
|
|
86
|
+
readonly email: "x-revenexx-actor-email";
|
|
87
|
+
readonly trust: "x-revenexx-actor-trust";
|
|
88
|
+
readonly contact: "x-revenexx-contact";
|
|
89
|
+
readonly organization: "x-revenexx-organization";
|
|
90
|
+
readonly permissions: "x-revenexx-permissions";
|
|
91
|
+
};
|
|
92
|
+
/**
|
|
93
|
+
* Read the acting person out of a request's headers.
|
|
94
|
+
*
|
|
95
|
+
* Unknown values of the trust header degrade to `asserted` rather than to
|
|
96
|
+
* `authenticated`: a gateway that learns a third plane must not silently
|
|
97
|
+
* promote it past a signature check written today.
|
|
98
|
+
*/
|
|
99
|
+
declare function actorFrom(header: (name: string) => string | undefined): Actor;
|
|
100
|
+
|
|
4
101
|
/**
|
|
5
102
|
* Minimal HTTP router for revenexx App functions.
|
|
6
103
|
*
|
|
@@ -57,6 +154,17 @@ interface RouteContext<D extends SettingsDefaults = SettingsDefaults> {
|
|
|
57
154
|
tenant: string | null;
|
|
58
155
|
/** The forwarded identity token (`x-revenexx-context`), if present. */
|
|
59
156
|
contextToken: string;
|
|
157
|
+
/**
|
|
158
|
+
* Who is acting — the person behind this request, as the platform
|
|
159
|
+
* established them (see ./actor.ts).
|
|
160
|
+
*
|
|
161
|
+
* `c.tenant` says whose data this is; this says whose hand is on it. Read
|
|
162
|
+
* `c.actor.authenticated()` before enforcing a per-person rule, and
|
|
163
|
+
* `c.actor.plane` to tell one of the tenant's contacts from a back-office
|
|
164
|
+
* operator from a system caller. Never derive either from the context
|
|
165
|
+
* token's claims: those describe the calling SYSTEM.
|
|
166
|
+
*/
|
|
167
|
+
actor: Actor;
|
|
60
168
|
/** Case-insensitive header lookup. */
|
|
61
169
|
header(name: string): string;
|
|
62
170
|
log(message: string): void;
|
|
@@ -179,4 +287,4 @@ interface CrudOptions {
|
|
|
179
287
|
}
|
|
180
288
|
declare function mountCrud<D extends SettingsDefaults = SettingsDefaults>(app: App<D>, repo: RepoLike, opts: CrudOptions): App<D>;
|
|
181
289
|
|
|
182
|
-
export { type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, ReadOptions, type RepoLike, ResolvedSettings, type RouteContext, SettingsDefaults, SettingsOptions, SettingsReader, SettingsSnapshot, createApp, mountCrud };
|
|
290
|
+
export { ACTOR_HEADERS, type Actor, type ActorPlane, type ActorTrust, type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, ReadOptions, type RepoLike, ResolvedSettings, type RouteContext, SettingsDefaults, SettingsOptions, SettingsReader, SettingsSnapshot, actorFrom, createApp, mountCrud };
|
package/dist/router/index.d.ts
CHANGED
|
@@ -1,6 +1,103 @@
|
|
|
1
1
|
import { m as SettingsDefaults, k as ReadOptions, l as ResolvedSettings, p as SettingsSnapshot, o as SettingsReader, n as SettingsOptions, Q as Query, R as Row, P as Page } from '../errors-D7FGkghT.js';
|
|
2
2
|
export { D as DEFAULT_GATEWAY_ENDPOINT, e as DEFAULT_SETTINGS_ERROR_TTL_MS, f as DEFAULT_SETTINGS_TIMEOUT_MS, g as DEFAULT_SETTINGS_TTL_MS, H as HttpError, j as HttpErrorOptions, q as SettingsSource, t as badRequest, u as conflict, r as createSettings, v as forbidden, s as isHttpError, w as notFound } from '../errors-D7FGkghT.js';
|
|
3
3
|
|
|
4
|
+
/**
|
|
5
|
+
* Who is acting — the person behind a request, as the platform established
|
|
6
|
+
* them.
|
|
7
|
+
*
|
|
8
|
+
* An app has always been told which TENANT a call is for. Which PERSON was a
|
|
9
|
+
* different question, and for a long time it had no answer: the brokered
|
|
10
|
+
* context identifies the calling system (in a theme site, the theme's service
|
|
11
|
+
* user — a robot with no name), the gateway strips inbound identity headers
|
|
12
|
+
* because they are forgeable, and anything in the request body is the caller's
|
|
13
|
+
* own word about itself. Apps that needed a person resolved one out of the
|
|
14
|
+
* context's email claim and hoped, or read an `_actor` out of the body and
|
|
15
|
+
* called it attribution rather than authentication, because that is all it was.
|
|
16
|
+
*
|
|
17
|
+
* The gateway now states it (RAD-12), on two planes:
|
|
18
|
+
*
|
|
19
|
+
* - ASSERTED. A storefront call is made by a server — the theme BFF, holding
|
|
20
|
+
* the tenant API key — on behalf of a customer. The credential proves the
|
|
21
|
+
* tenant, so the caller names the person and the gateway resolves that name
|
|
22
|
+
* through the tenant's role provider. It defends against a malicious end
|
|
23
|
+
* user, not against a compromised BFF.
|
|
24
|
+
* - AUTHENTICATED. A Cockpit call, or any call carrying a person's own
|
|
25
|
+
* Zitadel token, needs nobody's word: the signature and issuer were
|
|
26
|
+
* verified before a route was matched, and the contact — if there is one —
|
|
27
|
+
* was resolved from that proven subject.
|
|
28
|
+
*
|
|
29
|
+
* Both arrive in the same headers, which is exactly why `trust` exists. The
|
|
30
|
+
* same `contact` is a signature on one plane and a label on the other, and an
|
|
31
|
+
* app deciding an approval has to be able to tell the two apart. An app that
|
|
32
|
+
* only attributes — a "last edited by" — can ignore it.
|
|
33
|
+
*
|
|
34
|
+
* Every header read here is set ONLY by the gateway: it builds a fresh header
|
|
35
|
+
* set per dispatch and strips any copy a caller sent. So `actor.trust` cannot
|
|
36
|
+
* be talked up from outside, and an app never has to decide whether to believe
|
|
37
|
+
* a header — only what to do with what it says.
|
|
38
|
+
*/
|
|
39
|
+
/** How the platform came to know who is acting. */
|
|
40
|
+
type ActorTrust = 'authenticated' | 'asserted' | 'none';
|
|
41
|
+
/**
|
|
42
|
+
* Which side of the platform the caller is on.
|
|
43
|
+
*
|
|
44
|
+
* - `contact` — one of the tenant's own people: a buyer, an approver.
|
|
45
|
+
* - `operator` — a human the PLATFORM knows and the tenant's records do not.
|
|
46
|
+
* Back office: Cockpit staff, support, a partner operating the tenant. There
|
|
47
|
+
* is no contact to check a per-row rule against, and that absence is the
|
|
48
|
+
* signal, not a failure to resolve one.
|
|
49
|
+
* - `system` — nobody: a schedule, a webhook, a service token, an in-mesh call.
|
|
50
|
+
*
|
|
51
|
+
* This is the distinction apps otherwise make by hand, badly — usually by
|
|
52
|
+
* treating "no contact resolved" as "must be the platform", which is also what
|
|
53
|
+
* an unknown customer looks like.
|
|
54
|
+
*/
|
|
55
|
+
type ActorPlane = 'contact' | 'operator' | 'system';
|
|
56
|
+
/** The acting person, as far as the platform can state it. */
|
|
57
|
+
interface Actor {
|
|
58
|
+
/** The authenticated human's platform subject, or null when none was proven. */
|
|
59
|
+
user: string | null;
|
|
60
|
+
/** Their email claim, or null. Attribution — never a lookup key to trust on its own. */
|
|
61
|
+
email: string | null;
|
|
62
|
+
/** The `customers` contact the platform resolved them to, or null. */
|
|
63
|
+
contact: string | null;
|
|
64
|
+
/** That contact's organization, or null. */
|
|
65
|
+
organization: string | null;
|
|
66
|
+
/** The permissions the tenant's role provider granted them. Empty when there is no contact. */
|
|
67
|
+
permissions: string[];
|
|
68
|
+
/** How well `contact` is known. `none` when nobody was established at all. */
|
|
69
|
+
trust: ActorTrust;
|
|
70
|
+
/** Which side of the platform the caller is on. */
|
|
71
|
+
plane: ActorPlane;
|
|
72
|
+
/** Does this actor hold the permission? False for every permission when nobody is acting. */
|
|
73
|
+
holds(permission: string): boolean;
|
|
74
|
+
/**
|
|
75
|
+
* Is this a person the platform itself authenticated?
|
|
76
|
+
*
|
|
77
|
+
* The one check a per-person rule should make. An app enforcing "only the
|
|
78
|
+
* approver this approval names may decide it" needs a signature, and only
|
|
79
|
+
* this plane produces one.
|
|
80
|
+
*/
|
|
81
|
+
authenticated(): boolean;
|
|
82
|
+
}
|
|
83
|
+
/** Gateway-set headers. Named here so a reader can grep the wire format. */
|
|
84
|
+
declare const ACTOR_HEADERS: {
|
|
85
|
+
readonly user: "x-revenexx-actor";
|
|
86
|
+
readonly email: "x-revenexx-actor-email";
|
|
87
|
+
readonly trust: "x-revenexx-actor-trust";
|
|
88
|
+
readonly contact: "x-revenexx-contact";
|
|
89
|
+
readonly organization: "x-revenexx-organization";
|
|
90
|
+
readonly permissions: "x-revenexx-permissions";
|
|
91
|
+
};
|
|
92
|
+
/**
|
|
93
|
+
* Read the acting person out of a request's headers.
|
|
94
|
+
*
|
|
95
|
+
* Unknown values of the trust header degrade to `asserted` rather than to
|
|
96
|
+
* `authenticated`: a gateway that learns a third plane must not silently
|
|
97
|
+
* promote it past a signature check written today.
|
|
98
|
+
*/
|
|
99
|
+
declare function actorFrom(header: (name: string) => string | undefined): Actor;
|
|
100
|
+
|
|
4
101
|
/**
|
|
5
102
|
* Minimal HTTP router for revenexx App functions.
|
|
6
103
|
*
|
|
@@ -57,6 +154,17 @@ interface RouteContext<D extends SettingsDefaults = SettingsDefaults> {
|
|
|
57
154
|
tenant: string | null;
|
|
58
155
|
/** The forwarded identity token (`x-revenexx-context`), if present. */
|
|
59
156
|
contextToken: string;
|
|
157
|
+
/**
|
|
158
|
+
* Who is acting — the person behind this request, as the platform
|
|
159
|
+
* established them (see ./actor.ts).
|
|
160
|
+
*
|
|
161
|
+
* `c.tenant` says whose data this is; this says whose hand is on it. Read
|
|
162
|
+
* `c.actor.authenticated()` before enforcing a per-person rule, and
|
|
163
|
+
* `c.actor.plane` to tell one of the tenant's contacts from a back-office
|
|
164
|
+
* operator from a system caller. Never derive either from the context
|
|
165
|
+
* token's claims: those describe the calling SYSTEM.
|
|
166
|
+
*/
|
|
167
|
+
actor: Actor;
|
|
60
168
|
/** Case-insensitive header lookup. */
|
|
61
169
|
header(name: string): string;
|
|
62
170
|
log(message: string): void;
|
|
@@ -179,4 +287,4 @@ interface CrudOptions {
|
|
|
179
287
|
}
|
|
180
288
|
declare function mountCrud<D extends SettingsDefaults = SettingsDefaults>(app: App<D>, repo: RepoLike, opts: CrudOptions): App<D>;
|
|
181
289
|
|
|
182
|
-
export { type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, ReadOptions, type RepoLike, ResolvedSettings, type RouteContext, SettingsDefaults, SettingsOptions, SettingsReader, SettingsSnapshot, createApp, mountCrud };
|
|
290
|
+
export { ACTOR_HEADERS, type Actor, type ActorPlane, type ActorTrust, type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, ReadOptions, type RepoLike, ResolvedSettings, type RouteContext, SettingsDefaults, SettingsOptions, SettingsReader, SettingsSnapshot, actorFrom, createApp, mountCrud };
|
package/dist/router/index.js
CHANGED
|
@@ -23,6 +23,43 @@ import {
|
|
|
23
23
|
SpanKind,
|
|
24
24
|
SpanStatusCode
|
|
25
25
|
} from "@opentelemetry/api";
|
|
26
|
+
|
|
27
|
+
// src/router/actor.ts
|
|
28
|
+
var ACTOR_HEADERS = {
|
|
29
|
+
user: "x-revenexx-actor",
|
|
30
|
+
email: "x-revenexx-actor-email",
|
|
31
|
+
trust: "x-revenexx-actor-trust",
|
|
32
|
+
contact: "x-revenexx-contact",
|
|
33
|
+
organization: "x-revenexx-organization",
|
|
34
|
+
permissions: "x-revenexx-permissions"
|
|
35
|
+
};
|
|
36
|
+
var nullIfEmpty = (v) => v.trim() === "" ? null : v.trim();
|
|
37
|
+
function actorFrom(header) {
|
|
38
|
+
const read = (name) => {
|
|
39
|
+
const v = header(name);
|
|
40
|
+
return typeof v === "string" ? v : "";
|
|
41
|
+
};
|
|
42
|
+
const user = nullIfEmpty(read(ACTOR_HEADERS.user));
|
|
43
|
+
const contact = nullIfEmpty(read(ACTOR_HEADERS.contact));
|
|
44
|
+
const permissions = read(ACTOR_HEADERS.permissions).split(",").map((p) => p.trim()).filter(Boolean);
|
|
45
|
+
const raw = read(ACTOR_HEADERS.trust).trim().toLowerCase();
|
|
46
|
+
const trust = user === null && contact === null ? "none" : user !== null && raw === "authenticated" ? "authenticated" : "asserted";
|
|
47
|
+
const plane = contact !== null ? "contact" : user !== null ? "operator" : "system";
|
|
48
|
+
const held = new Set(permissions);
|
|
49
|
+
return {
|
|
50
|
+
user,
|
|
51
|
+
email: nullIfEmpty(read(ACTOR_HEADERS.email)),
|
|
52
|
+
contact,
|
|
53
|
+
organization: nullIfEmpty(read(ACTOR_HEADERS.organization)),
|
|
54
|
+
permissions,
|
|
55
|
+
trust,
|
|
56
|
+
plane,
|
|
57
|
+
holds: (permission) => permission !== "" && held.has(permission),
|
|
58
|
+
authenticated: () => trust === "authenticated"
|
|
59
|
+
};
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
// src/router/router.ts
|
|
26
63
|
var splitPath = (path) => path.split("/").filter(Boolean);
|
|
27
64
|
function compileTemplate(template) {
|
|
28
65
|
return splitPath(template).map((seg) => {
|
|
@@ -202,6 +239,7 @@ function createApp(options = {}) {
|
|
|
202
239
|
tenant,
|
|
203
240
|
contextToken,
|
|
204
241
|
header: (name) => headerOf(headers, name),
|
|
242
|
+
actor: actorFrom((name) => headerOf(headers, name)),
|
|
205
243
|
log,
|
|
206
244
|
json: (data, statusCode = 200) => res.json(data, statusCode),
|
|
207
245
|
// The market rides on the request, so a market-scoped setting
|
|
@@ -353,11 +391,13 @@ function mountCrud(app, repo, opts) {
|
|
|
353
391
|
return app;
|
|
354
392
|
}
|
|
355
393
|
export {
|
|
394
|
+
ACTOR_HEADERS,
|
|
356
395
|
DEFAULT_GATEWAY_ENDPOINT,
|
|
357
396
|
DEFAULT_SETTINGS_ERROR_TTL_MS,
|
|
358
397
|
DEFAULT_SETTINGS_TIMEOUT_MS,
|
|
359
398
|
DEFAULT_SETTINGS_TTL_MS,
|
|
360
399
|
HttpError,
|
|
400
|
+
actorFrom,
|
|
361
401
|
badRequest,
|
|
362
402
|
conflict,
|
|
363
403
|
createApp,
|
package/dist/router/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/router/router.ts","../../src/router/crud.ts"],"sourcesContent":["/**\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';\nimport { createSettings } from '../settings.js';\nimport type {\n ReadOptions,\n ResolvedSettings,\n SettingsDefaults,\n SettingsOptions,\n SettingsReader,\n SettingsSnapshot,\n} from '../settings.js';\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<D extends SettingsDefaults = SettingsDefaults> {\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 * This tenant's effective settings for the app, resolved for the request's\n * market. Cached and fail-open — see `createSettings`. Available on every\n * app; pass `settings` to `createApp` to declare defaults and get them typed.\n */\n settings(options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n settingsSnapshot(options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n}\n\nexport type Handler<D extends SettingsDefaults = SettingsDefaults> = (\n c: RouteContext<D>,\n) => 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<D extends SettingsDefaults> {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler<D>;\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 // The runtime hands `req.query` through UNDECODED — measured in production\n // against every one of the 13 apps after 0.6.0 shipped:\n //\n // GET /v1/customers/organizations?name=ACME%20GmbH\n // -> returned 0, filter {\"name\":\"ACME%20GmbH\"} (the row 'ACME GmbH' exists)\n //\n // 0.6.0 only decoded when the query rode on `req.path`, which this runtime\n // does not do, so the fix was inert. Decode here as well; each source is\n // still decoded exactly once, because the branch above returns.\n for (const [k, v] of Object.entries(req.query ?? {})) {\n const raw = typeof v === 'string' ? v : v == null ? null : String(v);\n if (raw !== null) out[decodeComponent(k)] = decodeComponent(raw);\n }\n return out;\n}\n\n/**\n * Percent-decode one query key or value, treating `+` as a space the way a\n * form-encoded query requires.\n *\n * Falls back to the input when it is not valid percent-encoding — a lone `%`\n * is a legitimate character in a search term, and throwing a URIError on it\n * would turn a harmless filter into a 500.\n */\nfunction decodeComponent(value: string): string {\n try {\n return decodeURIComponent(value.replace(/\\+/g, ' '));\n } catch {\n return value;\n }\n}\n\nexport interface AppOptions<D extends SettingsDefaults = SettingsDefaults> {\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 * App settings behind `c.settings()`. Pass the defaults your settings.json\n * declares — they type the resolved object and are what the app runs on if\n * the settings service is unreachable:\n *\n * createApp({ name: 'orders', settings: { defaults: { auto_reserve: true } } })\n *\n * `app` defaults to this app's `name`. Pass a reader built with\n * `createSettings` instead when you want to share it with code outside the\n * router. Omit entirely and `c.settings()` still works — it just has no\n * declared defaults to fall back on.\n */\n settings?: Omit<SettingsOptions<D>, 'app'> & { app?: string } | SettingsReader<D>;\n}\n\nexport interface App<D extends SettingsDefaults = SettingsDefaults> {\n get(template: string, handler: Handler<D>): App<D>;\n post(template: string, handler: Handler<D>): App<D>;\n put(template: string, handler: Handler<D>): App<D>;\n patch(template: string, handler: Handler<D>): App<D>;\n delete(template: string, handler: Handler<D>): App<D>;\n on(method: string, template: string, handler: Handler<D>): App<D>;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** The settings reader backing `c.settings()` (e.g. to clear its cache). */\n settings: SettingsReader<D>;\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst isSettingsReader = <D extends SettingsDefaults>(\n value: NonNullable<AppOptions<D>['settings']>,\n): value is SettingsReader<D> => typeof (value as SettingsReader<D>).get === 'function';\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<D extends SettingsDefaults = SettingsDefaults>(options: AppOptions<D> = {}): App<D> {\n const routes: CompiledRoute<D>[] = [];\n const health = options.health !== false;\n // The app knows its own name, so the settings reader does not have to be told\n // it. One reader per app, created once: the cache lives on it.\n const settings: SettingsReader<D> =\n options.settings && isSettingsReader(options.settings)\n ? options.settings\n : createSettings<D>({ app: options.name, ...(options.settings ?? {}) });\n\n const app: App<D> = {\n settings,\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<D>; 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<D> = {\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 // The market rides on the request, so a market-scoped setting\n // resolves for the market this call is for — no argument needed.\n settings: (readOptions) => settings.get(c, readOptions),\n settingsSnapshot: (readOptions) => settings.load(c, readOptions),\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 * 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';\nimport { EMPTY_UPDATE_MESSAGE, updateFields } from '../patch.js';\nimport type { SettingsDefaults } from '../settings.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\n/** `json` / `jsonb`, read off the generated ENTITIES column metadata. */\nconst isJsonColumn = (def: unknown): boolean =>\n /^jsonb?\\b/i.test(String((def as { type?: unknown } | null | undefined)?.type ?? ''));\n\n/**\n * A filter on a jsonb column is a whole-document equality, so the value has to\n * be a JSON document. `k in opts.columns` never looked at the column *type*, so\n * anything else went to the data plane as `col=eq.<junk>`; Postgres failed the\n * cast (SQLSTATE 22P02) and the caller got a 400 that named neither the\n * parameter nor what a good value looks like:\n *\n * GET /v1/forms?definition=x -> 400 {\"error\":\"a value in the request has\n * the wrong format\",\"code\":\"invalid_value\"}\n *\n * It is our query parameter, so it is our 400. Same status and same `code` as\n * before — only the message becomes actionable, and the round trip disappears.\n * The rule is exactly the data plane's: it must parse as JSON. Postgres compares\n * jsonb semantically, so key order and whitespace stay irrelevant and nothing\n * that worked before stops working — a whole, exactly-serialised document is\n * still forwarded unchanged.\n *\n * Deliberately NOT a containment (`cs.`) filter: `?labels={\"de\":\"Hauptlager\"}`\n * matches one exact document today, and turning that into \"contains\" would\n * silently widen a filter three apps already declare, with examples, as\n * equality. Widening it is a product decision, not a bug fix.\n *\n * The message states the rule and does NOT show an instance of the document.\n * It cannot: the generated column metadata carries `type`, `notNull` and\n * sometimes `default`, and nothing about the shape — 22 of the 25 jsonb\n * columns in `products` have no default at all. The first version borrowed\n * one column's example for every column, so a filter on an array-shaped\n * document (`family_variants.axes`, `measurement_families.units`) was\n * illustrated with an object. A caller who copies that shape sends valid JSON,\n * so there is no 400 — the answer is 200 with zero rows, which is the worst\n * failure this API has. The honest example is per column, the app knows it,\n * and it is already published on the parameter; so point there instead of\n * inventing one here.\n */\nfunction assertJsonFilter(column: string, value: string): void {\n try {\n JSON.parse(value);\n } catch {\n throw new HttpError(\n 400,\n `filter '${column}' must be a whole JSON document, serialized exactly as stored ` +\n `and compared for equality — not a path or containment query. ` +\n `This parameter's example in the API contract shows the shape this column holds.`,\n undefined,\n { code: 'invalid_value' },\n );\n }\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<D extends SettingsDefaults = SettingsDefaults>(\n app: App<D>,\n repo: RepoLike,\n opts: CrudOptions,\n): App<D> {\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 // A key naming no column is dropped, not refused: `filter` below echoes\n // exactly the keys that were honoured, so `filter: {}` next to a full\n // page is how a caller tells \"not filtered\" from \"filtered to nothing\".\n // Thirteen live apps document that, and 400ing instead would break every\n // client that carries a stray parameter.\n if (!opts.columns || !(k in opts.columns)) continue;\n if (isJsonColumn(opts.columns[k])) assertJsonFilter(k, v);\n 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. The rule itself\n // lives in ../patch.ts and is enforced by the data client, so Apps that\n // hand-write their PUT handler get it too; this check stays because it is\n // the only one that can see the *body* rather than the merged patch —\n // with a nested parent the merge always carries the FK, so the patch is\n // never literally empty — and because it answers without a round trip.\n if (updateFields(c.body).length === 0) throw new HttpError(400, EMPTY_UPDATE_MESSAGE);\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":"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","names":["items"]}
|
|
1
|
+
{"version":3,"sources":["../../src/router/router.ts","../../src/router/actor.ts","../../src/router/crud.ts"],"sourcesContent":["/**\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';\nimport { actorFrom } from './actor.js';\nimport type { Actor } from './actor.js';\nimport { createSettings } from '../settings.js';\nimport type {\n ReadOptions,\n ResolvedSettings,\n SettingsDefaults,\n SettingsOptions,\n SettingsReader,\n SettingsSnapshot,\n} from '../settings.js';\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<D extends SettingsDefaults = SettingsDefaults> {\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 /**\n * Who is acting — the person behind this request, as the platform\n * established them (see ./actor.ts).\n *\n * `c.tenant` says whose data this is; this says whose hand is on it. Read\n * `c.actor.authenticated()` before enforcing a per-person rule, and\n * `c.actor.plane` to tell one of the tenant's contacts from a back-office\n * operator from a system caller. Never derive either from the context\n * token's claims: those describe the calling SYSTEM.\n */\n actor: Actor;\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 * This tenant's effective settings for the app, resolved for the request's\n * market. Cached and fail-open — see `createSettings`. Available on every\n * app; pass `settings` to `createApp` to declare defaults and get them typed.\n */\n settings(options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n settingsSnapshot(options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n}\n\nexport type Handler<D extends SettingsDefaults = SettingsDefaults> = (\n c: RouteContext<D>,\n) => 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<D extends SettingsDefaults> {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler<D>;\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 // The runtime hands `req.query` through UNDECODED — measured in production\n // against every one of the 13 apps after 0.6.0 shipped:\n //\n // GET /v1/customers/organizations?name=ACME%20GmbH\n // -> returned 0, filter {\"name\":\"ACME%20GmbH\"} (the row 'ACME GmbH' exists)\n //\n // 0.6.0 only decoded when the query rode on `req.path`, which this runtime\n // does not do, so the fix was inert. Decode here as well; each source is\n // still decoded exactly once, because the branch above returns.\n for (const [k, v] of Object.entries(req.query ?? {})) {\n const raw = typeof v === 'string' ? v : v == null ? null : String(v);\n if (raw !== null) out[decodeComponent(k)] = decodeComponent(raw);\n }\n return out;\n}\n\n/**\n * Percent-decode one query key or value, treating `+` as a space the way a\n * form-encoded query requires.\n *\n * Falls back to the input when it is not valid percent-encoding — a lone `%`\n * is a legitimate character in a search term, and throwing a URIError on it\n * would turn a harmless filter into a 500.\n */\nfunction decodeComponent(value: string): string {\n try {\n return decodeURIComponent(value.replace(/\\+/g, ' '));\n } catch {\n return value;\n }\n}\n\nexport interface AppOptions<D extends SettingsDefaults = SettingsDefaults> {\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 * App settings behind `c.settings()`. Pass the defaults your settings.json\n * declares — they type the resolved object and are what the app runs on if\n * the settings service is unreachable:\n *\n * createApp({ name: 'orders', settings: { defaults: { auto_reserve: true } } })\n *\n * `app` defaults to this app's `name`. Pass a reader built with\n * `createSettings` instead when you want to share it with code outside the\n * router. Omit entirely and `c.settings()` still works — it just has no\n * declared defaults to fall back on.\n */\n settings?: Omit<SettingsOptions<D>, 'app'> & { app?: string } | SettingsReader<D>;\n}\n\nexport interface App<D extends SettingsDefaults = SettingsDefaults> {\n get(template: string, handler: Handler<D>): App<D>;\n post(template: string, handler: Handler<D>): App<D>;\n put(template: string, handler: Handler<D>): App<D>;\n patch(template: string, handler: Handler<D>): App<D>;\n delete(template: string, handler: Handler<D>): App<D>;\n on(method: string, template: string, handler: Handler<D>): App<D>;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** The settings reader backing `c.settings()` (e.g. to clear its cache). */\n settings: SettingsReader<D>;\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst isSettingsReader = <D extends SettingsDefaults>(\n value: NonNullable<AppOptions<D>['settings']>,\n): value is SettingsReader<D> => typeof (value as SettingsReader<D>).get === 'function';\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<D extends SettingsDefaults = SettingsDefaults>(options: AppOptions<D> = {}): App<D> {\n const routes: CompiledRoute<D>[] = [];\n const health = options.health !== false;\n // The app knows its own name, so the settings reader does not have to be told\n // it. One reader per app, created once: the cache lives on it.\n const settings: SettingsReader<D> =\n options.settings && isSettingsReader(options.settings)\n ? options.settings\n : createSettings<D>({ app: options.name, ...(options.settings ?? {}) });\n\n const app: App<D> = {\n settings,\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<D>; 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<D> = {\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 actor: actorFrom((name) => headerOf(headers, name)),\n log,\n json: (data, statusCode = 200) => res.json(data, statusCode),\n // The market rides on the request, so a market-scoped setting\n // resolves for the market this call is for — no argument needed.\n settings: (readOptions) => settings.get(c, readOptions),\n settingsSnapshot: (readOptions) => settings.load(c, readOptions),\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 * Who is acting — the person behind a request, as the platform established\n * them.\n *\n * An app has always been told which TENANT a call is for. Which PERSON was a\n * different question, and for a long time it had no answer: the brokered\n * context identifies the calling system (in a theme site, the theme's service\n * user — a robot with no name), the gateway strips inbound identity headers\n * because they are forgeable, and anything in the request body is the caller's\n * own word about itself. Apps that needed a person resolved one out of the\n * context's email claim and hoped, or read an `_actor` out of the body and\n * called it attribution rather than authentication, because that is all it was.\n *\n * The gateway now states it (RAD-12), on two planes:\n *\n * - ASSERTED. A storefront call is made by a server — the theme BFF, holding\n * the tenant API key — on behalf of a customer. The credential proves the\n * tenant, so the caller names the person and the gateway resolves that name\n * through the tenant's role provider. It defends against a malicious end\n * user, not against a compromised BFF.\n * - AUTHENTICATED. A Cockpit call, or any call carrying a person's own\n * Zitadel token, needs nobody's word: the signature and issuer were\n * verified before a route was matched, and the contact — if there is one —\n * was resolved from that proven subject.\n *\n * Both arrive in the same headers, which is exactly why `trust` exists. The\n * same `contact` is a signature on one plane and a label on the other, and an\n * app deciding an approval has to be able to tell the two apart. An app that\n * only attributes — a \"last edited by\" — can ignore it.\n *\n * Every header read here is set ONLY by the gateway: it builds a fresh header\n * set per dispatch and strips any copy a caller sent. So `actor.trust` cannot\n * be talked up from outside, and an app never has to decide whether to believe\n * a header — only what to do with what it says.\n */\n\n/** How the platform came to know who is acting. */\nexport type ActorTrust = 'authenticated' | 'asserted' | 'none';\n\n/**\n * Which side of the platform the caller is on.\n *\n * - `contact` — one of the tenant's own people: a buyer, an approver.\n * - `operator` — a human the PLATFORM knows and the tenant's records do not.\n * Back office: Cockpit staff, support, a partner operating the tenant. There\n * is no contact to check a per-row rule against, and that absence is the\n * signal, not a failure to resolve one.\n * - `system` — nobody: a schedule, a webhook, a service token, an in-mesh call.\n *\n * This is the distinction apps otherwise make by hand, badly — usually by\n * treating \"no contact resolved\" as \"must be the platform\", which is also what\n * an unknown customer looks like.\n */\nexport type ActorPlane = 'contact' | 'operator' | 'system';\n\n/** The acting person, as far as the platform can state it. */\nexport interface Actor {\n /** The authenticated human's platform subject, or null when none was proven. */\n user: string | null;\n /** Their email claim, or null. Attribution — never a lookup key to trust on its own. */\n email: string | null;\n /** The `customers` contact the platform resolved them to, or null. */\n contact: string | null;\n /** That contact's organization, or null. */\n organization: string | null;\n /** The permissions the tenant's role provider granted them. Empty when there is no contact. */\n permissions: string[];\n /** How well `contact` is known. `none` when nobody was established at all. */\n trust: ActorTrust;\n /** Which side of the platform the caller is on. */\n plane: ActorPlane;\n /** Does this actor hold the permission? False for every permission when nobody is acting. */\n holds(permission: string): boolean;\n /**\n * Is this a person the platform itself authenticated?\n *\n * The one check a per-person rule should make. An app enforcing \"only the\n * approver this approval names may decide it\" needs a signature, and only\n * this plane produces one.\n */\n authenticated(): boolean;\n}\n\n/** Gateway-set headers. Named here so a reader can grep the wire format. */\nexport const ACTOR_HEADERS = {\n user: 'x-revenexx-actor',\n email: 'x-revenexx-actor-email',\n trust: 'x-revenexx-actor-trust',\n contact: 'x-revenexx-contact',\n organization: 'x-revenexx-organization',\n permissions: 'x-revenexx-permissions',\n} as const;\n\nconst nullIfEmpty = (v: string): string | null => (v.trim() === '' ? null : v.trim());\n\n/**\n * Read the acting person out of a request's headers.\n *\n * Unknown values of the trust header degrade to `asserted` rather than to\n * `authenticated`: a gateway that learns a third plane must not silently\n * promote it past a signature check written today.\n */\nexport function actorFrom(header: (name: string) => string | undefined): Actor {\n // A caller outside a handler has its own header bag — a Node request answers\n // `undefined` for a header nobody sent and an array for one sent twice. Read\n // everything through here so neither shape reaches a `.trim()`.\n const read = (name: string): string => {\n const v = header(name);\n return typeof v === 'string' ? v : '';\n };\n\n const user = nullIfEmpty(read(ACTOR_HEADERS.user));\n const contact = nullIfEmpty(read(ACTOR_HEADERS.contact));\n const permissions = read(ACTOR_HEADERS.permissions)\n .split(',')\n .map((p) => p.trim())\n .filter(Boolean);\n\n // Nobody established: `none`, whatever the header says. An app reading\n // `trust === 'asserted'` must not see it for a call that named no one.\n //\n // And `authenticated` needs the person it authenticated: a trust header\n // arriving beside no subject is a plane half-stated, which degrades like any\n // other value the gateway did not mean.\n const raw = read(ACTOR_HEADERS.trust).trim().toLowerCase();\n const trust: ActorTrust =\n user === null && contact === null\n ? 'none'\n : user !== null && raw === 'authenticated'\n ? 'authenticated'\n : 'asserted';\n\n const plane: ActorPlane = contact !== null ? 'contact' : user !== null ? 'operator' : 'system';\n const held = new Set(permissions);\n\n return {\n user,\n email: nullIfEmpty(read(ACTOR_HEADERS.email)),\n contact,\n organization: nullIfEmpty(read(ACTOR_HEADERS.organization)),\n permissions,\n trust,\n plane,\n holds: (permission) => permission !== '' && held.has(permission),\n authenticated: () => trust === 'authenticated',\n };\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';\nimport { EMPTY_UPDATE_MESSAGE, updateFields } from '../patch.js';\nimport type { SettingsDefaults } from '../settings.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\n/** `json` / `jsonb`, read off the generated ENTITIES column metadata. */\nconst isJsonColumn = (def: unknown): boolean =>\n /^jsonb?\\b/i.test(String((def as { type?: unknown } | null | undefined)?.type ?? ''));\n\n/**\n * A filter on a jsonb column is a whole-document equality, so the value has to\n * be a JSON document. `k in opts.columns` never looked at the column *type*, so\n * anything else went to the data plane as `col=eq.<junk>`; Postgres failed the\n * cast (SQLSTATE 22P02) and the caller got a 400 that named neither the\n * parameter nor what a good value looks like:\n *\n * GET /v1/forms?definition=x -> 400 {\"error\":\"a value in the request has\n * the wrong format\",\"code\":\"invalid_value\"}\n *\n * It is our query parameter, so it is our 400. Same status and same `code` as\n * before — only the message becomes actionable, and the round trip disappears.\n * The rule is exactly the data plane's: it must parse as JSON. Postgres compares\n * jsonb semantically, so key order and whitespace stay irrelevant and nothing\n * that worked before stops working — a whole, exactly-serialised document is\n * still forwarded unchanged.\n *\n * Deliberately NOT a containment (`cs.`) filter: `?labels={\"de\":\"Hauptlager\"}`\n * matches one exact document today, and turning that into \"contains\" would\n * silently widen a filter three apps already declare, with examples, as\n * equality. Widening it is a product decision, not a bug fix.\n *\n * The message states the rule and does NOT show an instance of the document.\n * It cannot: the generated column metadata carries `type`, `notNull` and\n * sometimes `default`, and nothing about the shape — 22 of the 25 jsonb\n * columns in `products` have no default at all. The first version borrowed\n * one column's example for every column, so a filter on an array-shaped\n * document (`family_variants.axes`, `measurement_families.units`) was\n * illustrated with an object. A caller who copies that shape sends valid JSON,\n * so there is no 400 — the answer is 200 with zero rows, which is the worst\n * failure this API has. The honest example is per column, the app knows it,\n * and it is already published on the parameter; so point there instead of\n * inventing one here.\n */\nfunction assertJsonFilter(column: string, value: string): void {\n try {\n JSON.parse(value);\n } catch {\n throw new HttpError(\n 400,\n `filter '${column}' must be a whole JSON document, serialized exactly as stored ` +\n `and compared for equality — not a path or containment query. ` +\n `This parameter's example in the API contract shows the shape this column holds.`,\n undefined,\n { code: 'invalid_value' },\n );\n }\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<D extends SettingsDefaults = SettingsDefaults>(\n app: App<D>,\n repo: RepoLike,\n opts: CrudOptions,\n): App<D> {\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 // A key naming no column is dropped, not refused: `filter` below echoes\n // exactly the keys that were honoured, so `filter: {}` next to a full\n // page is how a caller tells \"not filtered\" from \"filtered to nothing\".\n // Thirteen live apps document that, and 400ing instead would break every\n // client that carries a stray parameter.\n if (!opts.columns || !(k in opts.columns)) continue;\n if (isJsonColumn(opts.columns[k])) assertJsonFilter(k, v);\n 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. The rule itself\n // lives in ../patch.ts and is enforced by the data client, so Apps that\n // hand-write their PUT handler get it too; this check stays because it is\n // the only one that can see the *body* rather than the merged patch —\n // with a nested parent the merge always carries the FK, so the patch is\n // never literally empty — and because it answers without a round trip.\n if (updateFields(c.body).length === 0) throw new HttpError(400, EMPTY_UPDATE_MESSAGE);\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":"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","names":["items"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@revenexx/app-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"description": "Typed data client + HTTP router for revenexx Apps. Swappable adapters (mock | remote | runtime) so the same App code runs against in-memory fixtures locally and the real data plane in production.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|