@revenexx/app-sdk 0.9.0 → 1.0.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.
@@ -1,5 +1,5 @@
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
- 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';
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-BPYDadk4.cjs';
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-BPYDadk4.cjs';
3
3
 
4
4
  /**
5
5
  * Who is acting — the person behind a request, as the platform established
@@ -257,8 +257,26 @@ interface RepoLike {
257
257
  interface CrudOptions {
258
258
  /** Route base path, e.g. `/markets` or `/markets/{marketId}/locales`. */
259
259
  path: string;
260
- /** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */
260
+ /**
261
+ * Column metadata (from the generated ENTITIES) — enables `?col=value` list
262
+ * filters. A list query key that is neither a column, a reserved key
263
+ * (`limit`, `offset`, `order`) nor declared in `queryParams` is refused with
264
+ * `400 unknown_filter`. Without `columns`, only those keys are accepted.
265
+ */
261
266
  columns?: Record<string, unknown>;
267
+ /**
268
+ * Extra list query parameters the App handles itself (e.g. read by
269
+ * middleware, a wrapping handler, or simply tolerated). The list route
270
+ * accepts them and does NOT turn them into filters — they never reach the
271
+ * data plane and are not echoed in `filter`.
272
+ *
273
+ * mountCrud(app, db.accounts, {
274
+ * path: '/punchout/accounts',
275
+ * columns: ENTITIES.accounts.columns,
276
+ * queryParams: ['include_secrets'],
277
+ * });
278
+ */
279
+ queryParams?: string[];
262
280
  /**
263
281
  * Nested-resource scoping: path param name + the FK column it maps to.
264
282
  *
@@ -285,6 +303,11 @@ interface CrudOptions {
285
303
  /** Restrict which routes are mounted (default: all five). */
286
304
  only?: ('list' | 'get' | 'create' | 'update' | 'delete')[];
287
305
  }
306
+ /**
307
+ * Query keys the list route reads itself. Always accepted, never filters (a
308
+ * column of the same name is still filtered on as well, as before).
309
+ */
310
+ declare const RESERVED_LIST_QUERY_KEYS: readonly string[];
288
311
  declare function mountCrud<D extends SettingsDefaults = SettingsDefaults>(app: App<D>, repo: RepoLike, opts: CrudOptions): App<D>;
289
312
 
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 };
313
+ export { ACTOR_HEADERS, type Actor, type ActorPlane, type ActorTrust, type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, RESERVED_LIST_QUERY_KEYS, ReadOptions, type RepoLike, ResolvedSettings, type RouteContext, SettingsDefaults, SettingsOptions, SettingsReader, SettingsSnapshot, actorFrom, createApp, mountCrud };
@@ -1,5 +1,5 @@
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
- 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';
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-BPYDadk4.js';
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-BPYDadk4.js';
3
3
 
4
4
  /**
5
5
  * Who is acting — the person behind a request, as the platform established
@@ -257,8 +257,26 @@ interface RepoLike {
257
257
  interface CrudOptions {
258
258
  /** Route base path, e.g. `/markets` or `/markets/{marketId}/locales`. */
259
259
  path: string;
260
- /** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */
260
+ /**
261
+ * Column metadata (from the generated ENTITIES) — enables `?col=value` list
262
+ * filters. A list query key that is neither a column, a reserved key
263
+ * (`limit`, `offset`, `order`) nor declared in `queryParams` is refused with
264
+ * `400 unknown_filter`. Without `columns`, only those keys are accepted.
265
+ */
261
266
  columns?: Record<string, unknown>;
267
+ /**
268
+ * Extra list query parameters the App handles itself (e.g. read by
269
+ * middleware, a wrapping handler, or simply tolerated). The list route
270
+ * accepts them and does NOT turn them into filters — they never reach the
271
+ * data plane and are not echoed in `filter`.
272
+ *
273
+ * mountCrud(app, db.accounts, {
274
+ * path: '/punchout/accounts',
275
+ * columns: ENTITIES.accounts.columns,
276
+ * queryParams: ['include_secrets'],
277
+ * });
278
+ */
279
+ queryParams?: string[];
262
280
  /**
263
281
  * Nested-resource scoping: path param name + the FK column it maps to.
264
282
  *
@@ -285,6 +303,11 @@ interface CrudOptions {
285
303
  /** Restrict which routes are mounted (default: all five). */
286
304
  only?: ('list' | 'get' | 'create' | 'update' | 'delete')[];
287
305
  }
306
+ /**
307
+ * Query keys the list route reads itself. Always accepted, never filters (a
308
+ * column of the same name is still filtered on as well, as before).
309
+ */
310
+ declare const RESERVED_LIST_QUERY_KEYS: readonly string[];
288
311
  declare function mountCrud<D extends SettingsDefaults = SettingsDefaults>(app: App<D>, repo: RepoLike, opts: CrudOptions): App<D>;
289
312
 
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 };
313
+ export { ACTOR_HEADERS, type Actor, type ActorPlane, type ActorTrust, type App, type AppOptions, type CrudOptions, type FnContext, type FnRequest, type FnResponse, type Handler, RESERVED_LIST_QUERY_KEYS, ReadOptions, type RepoLike, ResolvedSettings, type RouteContext, SettingsDefaults, SettingsOptions, SettingsReader, SettingsSnapshot, actorFrom, createApp, mountCrud };
@@ -5,6 +5,7 @@ import {
5
5
  DEFAULT_SETTINGS_TTL_MS,
6
6
  EMPTY_UPDATE_MESSAGE,
7
7
  HttpError,
8
+ OPS,
8
9
  badRequest,
9
10
  conflict,
10
11
  createSettings,
@@ -12,8 +13,44 @@ import {
12
13
  isHttpError,
13
14
  notFound,
14
15
  updateFields
15
- } from "../chunk-2BOFXTTC.js";
16
- import "../chunk-TUTGCI5D.js";
16
+ } from "../chunk-73D37ZGB.js";
17
+
18
+ // src/instrument.ts
19
+ var started = false;
20
+ async function startTelemetry() {
21
+ if (started) {
22
+ return;
23
+ }
24
+ started = true;
25
+ const endpoint = process.env["OTEL_EXPORTER_OTLP_TRACES_ENDPOINT"] ?? process.env["OTEL_EXPORTER_OTLP_ENDPOINT"] ?? "";
26
+ if (!endpoint) {
27
+ return;
28
+ }
29
+ try {
30
+ const [{ NodeSDK }, { OTLPTraceExporter }, { UndiciInstrumentation }] = await Promise.all([
31
+ import("@opentelemetry/sdk-node"),
32
+ import("@opentelemetry/exporter-trace-otlp-proto"),
33
+ import("@opentelemetry/instrumentation-undici")
34
+ ]);
35
+ const sdk = new NodeSDK({
36
+ traceExporter: new OTLPTraceExporter(),
37
+ instrumentations: [new UndiciInstrumentation()]
38
+ });
39
+ sdk.start();
40
+ const flush = () => {
41
+ void sdk.shutdown().catch(() => {
42
+ });
43
+ };
44
+ process.once("SIGTERM", flush);
45
+ process.once("SIGINT", flush);
46
+ } catch (err) {
47
+ console.error(
48
+ "[app-sdk] OpenTelemetry init failed, continuing without tracing:",
49
+ err instanceof Error ? err.message : err
50
+ );
51
+ }
52
+ }
53
+ void startTelemetry();
17
54
 
18
55
  // src/router/router.ts
19
56
  import {
@@ -216,9 +253,9 @@ function createApp(options = {}) {
216
253
  span.setAttribute("http.response.status_code", status);
217
254
  span.setStatus({ code: SpanStatusCode.ERROR, message: pathExists ? "method not allowed" : "no route" });
218
255
  if (pathExists) {
219
- return res.json({ error: `method ${method} not allowed for ${path}` }, 405);
256
+ return res.json({ error: `method ${method} not allowed for ${path}`, code: "method_not_allowed" }, 405);
220
257
  }
221
- return res.json({ error: `no route for ${method} ${path}`, routes: app.routes() }, 404);
258
+ return res.json({ error: `no route for ${method} ${path}`, code: "no_route", routes: app.routes() }, 404);
222
259
  }
223
260
  span.updateName(`${method} ${matched.route.template}`);
224
261
  span.setAttribute("http.route", matched.route.template);
@@ -268,14 +305,11 @@ function createApp(options = {}) {
268
305
  );
269
306
  }
270
307
  const msg = err instanceof Error ? err.message : String(err);
271
- if (/not permitted/.test(msg)) {
272
- span.setAttribute("http.response.status_code", 403);
273
- return res.json({ error: msg }, 403);
274
- }
308
+ span.setAttribute("http.response.status_code", 500);
275
309
  span.recordException(err instanceof Error ? err : new Error(msg));
276
310
  span.setStatus({ code: SpanStatusCode.ERROR, message: msg });
277
311
  context.error?.(`unhandled error on ${method} ${path}: ${msg}`);
278
- return res.json({ error: msg }, 500);
312
+ return res.json({ error: "internal error", code: "internal_error" }, 500);
279
313
  } finally {
280
314
  span.end();
281
315
  }
@@ -288,6 +322,7 @@ function createApp(options = {}) {
288
322
  }
289
323
 
290
324
  // src/router/crud.ts
325
+ var RESERVED_LIST_QUERY_KEYS = Object.freeze(["limit", "offset", "order"]);
291
326
  var INT = (v, d) => {
292
327
  const n = parseInt(String(v), 10);
293
328
  return Number.isFinite(n) ? n : d;
@@ -305,21 +340,46 @@ function assertJsonFilter(column, value) {
305
340
  );
306
341
  }
307
342
  }
343
+ function assertKnownKeys(query, opts) {
344
+ const columns = opts.columns ?? {};
345
+ const extra = opts.queryParams ?? [];
346
+ const known = (k) => Object.prototype.hasOwnProperty.call(columns, k) || RESERVED_LIST_QUERY_KEYS.includes(k) || extra.includes(k);
347
+ const unknown = Object.keys(query).filter((k) => !known(k));
348
+ if (unknown.length === 0) return;
349
+ const allowed = [.../* @__PURE__ */ new Set([...Object.keys(columns), ...RESERVED_LIST_QUERY_KEYS, ...extra])].sort();
350
+ const quoted = unknown.map((k) => `'${k}'`).join(", ");
351
+ throw new HttpError(
352
+ 400,
353
+ `unknown list filter ${quoted} \u2014 not a column of this resource. A filter that cannot be applied is refused rather than ignored; see details.allowed.`,
354
+ { unknown, allowed },
355
+ { code: "unknown_filter" }
356
+ );
357
+ }
358
+ var OPERATOR_PREFIX = new RegExp(`^(?:not|${[...OPS].join("|")})\\.`);
359
+ function assertNoOperator(column, value) {
360
+ if (!OPERATOR_PREFIX.test(value)) return;
361
+ throw new HttpError(
362
+ 400,
363
+ `filter '${column}' carries an operator ('${value.slice(0, value.indexOf(".") + 1)}') \u2014 a list filters by exact value only; operators and value lists are not supported.`,
364
+ { parameter: column },
365
+ { code: "unsupported_filter_operator" }
366
+ );
367
+ }
308
368
  function parentWhere(c, parent) {
309
369
  if (!parent) return {};
310
370
  const value = c.params[parent.param];
311
- if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);
371
+ if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`, void 0, { code: "missing_parameter" });
312
372
  return { [parent.column]: value };
313
373
  }
314
374
  async function assertParentExists(c, parent) {
315
375
  if (!parent?.repo) return;
316
376
  const value = c.params[parent.param];
317
- if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);
377
+ if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`, void 0, { code: "missing_parameter" });
318
378
  if (!await parent.repo.get(value)) throw notFound();
319
379
  }
320
380
  async function fetchOwned(repo, c, opts) {
321
381
  const id = c.params[opts.idParam ?? "id"] ?? "";
322
- if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? "id"}'`);
382
+ if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? "id"}'`, void 0, { code: "missing_parameter" });
323
383
  const row = await repo.get(id);
324
384
  if (!row) throw notFound();
325
385
  if (opts.parent) {
@@ -336,13 +396,15 @@ function mountCrud(app, repo, opts) {
336
396
  const maxLimit = opts.maxLimit ?? 200;
337
397
  if (enabled.has("list")) {
338
398
  app.get(base, async (c) => {
339
- await assertParentExists(c, opts.parent);
399
+ assertKnownKeys(c.query, opts);
340
400
  const where = {};
341
401
  for (const [k, v] of Object.entries(c.query)) {
342
- if (!opts.columns || !(k in opts.columns)) continue;
402
+ if (!opts.columns || !Object.prototype.hasOwnProperty.call(opts.columns, k)) continue;
403
+ assertNoOperator(k, v);
343
404
  if (isJsonColumn(opts.columns[k])) assertJsonFilter(k, v);
344
405
  where[k] = v;
345
406
  }
407
+ await assertParentExists(c, opts.parent);
346
408
  Object.assign(where, parentWhere(c, opts.parent));
347
409
  const limit = Math.min(Math.max(INT(c.query.limit, defaultLimit), 1), maxLimit);
348
410
  const offset = Math.max(INT(c.query.offset, 0), 0);
@@ -376,7 +438,7 @@ function mountCrud(app, repo, opts) {
376
438
  if (enabled.has("update")) {
377
439
  app.put(idTemplate, async (c) => {
378
440
  const { id } = await fetchOwned(repo, c, opts);
379
- if (updateFields(c.body).length === 0) throw new HttpError(400, EMPTY_UPDATE_MESSAGE);
441
+ if (updateFields(c.body).length === 0) throw new HttpError(400, EMPTY_UPDATE_MESSAGE, void 0, { code: "empty_update" });
380
442
  const patch = { ...c.body, ...parentWhere(c, opts.parent) };
381
443
  return c.json(await repo.update(id, patch));
382
444
  });
@@ -397,6 +459,7 @@ export {
397
459
  DEFAULT_SETTINGS_TIMEOUT_MS,
398
460
  DEFAULT_SETTINGS_TTL_MS,
399
461
  HttpError,
462
+ RESERVED_LIST_QUERY_KEYS,
400
463
  actorFrom,
401
464
  badRequest,
402
465
  conflict,
@@ -1 +1 @@
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"]}
1
+ {"version":3,"sources":["../../src/instrument.ts","../../src/router/router.ts","../../src/router/actor.ts","../../src/router/crud.ts"],"sourcesContent":["/**\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}`, code: 'method_not_allowed' }, 405);\n }\n return res.json({ error: `no route for ${method} ${path}`, code: 'no_route', 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 // Anything that is not an HttpError is a fault, not an answer: its\n // message may carry internals (a stack's TypeError, a table name),\n // so it is logged and traced, and the caller gets a fixed body.\n const msg = err instanceof Error ? err.message : String(err);\n span.setAttribute('http.response.status_code', 500);\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: 'internal error', code: 'internal_error' }, 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 { OPS } from '../query.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 /**\n * Column metadata (from the generated ENTITIES) — enables `?col=value` list\n * filters. A list query key that is neither a column, a reserved key\n * (`limit`, `offset`, `order`) nor declared in `queryParams` is refused with\n * `400 unknown_filter`. Without `columns`, only those keys are accepted.\n */\n columns?: Record<string, unknown>;\n /**\n * Extra list query parameters the App handles itself (e.g. read by\n * middleware, a wrapping handler, or simply tolerated). The list route\n * accepts them and does NOT turn them into filters — they never reach the\n * data plane and are not echoed in `filter`.\n *\n * mountCrud(app, db.accounts, {\n * path: '/punchout/accounts',\n * columns: ENTITIES.accounts.columns,\n * queryParams: ['include_secrets'],\n * });\n */\n queryParams?: string[];\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\n/**\n * Query keys the list route reads itself. Always accepted, never filters (a\n * column of the same name is still filtered on as well, as before).\n */\nexport const RESERVED_LIST_QUERY_KEYS: readonly string[] = Object.freeze(['limit', 'offset', 'order']);\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\n/**\n * A list query key that names no column used to be dropped, so a wrong filter\n * answered `200` with the UNFILTERED list — indistinguishable, to a caller that\n * does not inspect `filter`, from a correct one. Measured damage:\n * `GET /customers/segments?organization_id=…` (segments has no such column)\n * handed promotions every segment of the tenant. A filter we cannot apply is a\n * caller's mistake, so it is our 400, naming the key(s) and what is accepted.\n */\nfunction assertKnownKeys(query: Record<string, string>, opts: CrudOptions): void {\n const columns = opts.columns ?? {};\n const extra = opts.queryParams ?? [];\n const known = (k: string): boolean =>\n Object.prototype.hasOwnProperty.call(columns, k) || RESERVED_LIST_QUERY_KEYS.includes(k) || extra.includes(k);\n const unknown = Object.keys(query).filter((k) => !known(k));\n if (unknown.length === 0) return;\n const allowed = [...new Set([...Object.keys(columns), ...RESERVED_LIST_QUERY_KEYS, ...extra])].sort();\n const quoted = unknown.map((k) => `'${k}'`).join(', ');\n throw new HttpError(\n 400,\n `unknown list filter ${quoted} — not a column of this resource. ` +\n `A filter that cannot be applied is refused rather than ignored; see details.allowed.`,\n { unknown, allowed },\n { code: 'unknown_filter' },\n );\n}\n\n/** `in.`, `eq.`, `not.` … — a PostgREST operator prefix, as a caller would write one. */\nconst OPERATOR_PREFIX = new RegExp(`^(?:not|${[...OPS].join('|')})\\\\.`);\n\n/**\n * A list filter is an exact value: `toParams` sends the string as `eq.<value>`.\n * A caller who writes PostgREST syntax (`?sku=in.(a,b)`) therefore got\n * `sku=eq.in.(a,b)` — `200` with zero rows, which reads as \"none of those\n * exist\". Measured damage: punchout resolved every product of an inbound cart\n * that way and found none (RAD-160). An exact value that genuinely starts with\n * `in.` or `eq.` is implausible, so a value carrying an operator prefix is our\n * 400 rather than a silent miss. Only column filters are checked: `queryParams`\n * and the reserved keys never reach `where`.\n */\nfunction assertNoOperator(column: string, value: string): void {\n if (!OPERATOR_PREFIX.test(value)) return;\n throw new HttpError(\n 400,\n `filter '${column}' carries an operator ('${value.slice(0, value.indexOf('.') + 1)}') — ` +\n `a list filters by exact value only; operators and value lists are not supported.`,\n { parameter: column },\n { code: 'unsupported_filter_operator' },\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}'`, undefined, { code: 'missing_parameter' });\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}'`, undefined, { code: 'missing_parameter' });\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'}'`, undefined, { code: 'missing_parameter' });\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 // Refuse before any round trip — including the parent lookup.\n assertKnownKeys(c.query, opts);\n const where: Record<string, string> = {};\n for (const [k, v] of Object.entries(c.query)) {\n // Reserved / app-declared keys that are not columns are not filters.\n if (!opts.columns || !Object.prototype.hasOwnProperty.call(opts.columns, k)) continue;\n assertNoOperator(k, v);\n if (isJsonColumn(opts.columns[k])) assertJsonFilter(k, v);\n where[k] = v;\n }\n await assertParentExists(c, opts.parent);\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, undefined, { code: 'empty_update' });\n // Never let a body overwrite the nested-parent FK.\n const patch = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.update(id, patch));\n });\n }\n\n if (enabled.has('delete')) {\n app.delete(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n await repo.delete(id);\n return c.json({ deleted: true, id });\n });\n }\n\n return app;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,IAAI,UAAU;AAMd,eAAsB,iBAAgC;AACpD,MAAI,SAAS;AACX;AAAA,EACF;AACA,YAAU;AAEV,QAAM,WACJ,QAAQ,IAAI,oCAAoC,KAAK,QAAQ,IAAI,6BAA6B,KAAK;AACrG,MAAI,CAAC,UAAU;AACb;AAAA,EACF;AAEA,MAAI;AACF,UAAM,CAAC,EAAE,QAAQ,GAAG,EAAE,kBAAkB,GAAG,EAAE,sBAAsB,CAAC,IAAI,MAAM,QAAQ,IAAI;AAAA,MACxF,OAAO,yBAAyB;AAAA,MAChC,OAAO,0CAA0C;AAAA,MACjD,OAAO,uCAAuC;AAAA,IAChD,CAAC;AAGD,UAAM,MAAM,IAAI,QAAQ;AAAA,MACtB,eAAe,IAAI,kBAAkB;AAAA,MACrC,kBAAkB,CAAC,IAAI,sBAAsB,CAAC;AAAA,IAChD,CAAC;AAED,QAAI,MAAM;AAEV,UAAM,QAAQ,MAAY;AACxB,WAAK,IAAI,SAAS,EAAE,MAAM,MAAM;AAAA,MAEhC,CAAC;AAAA,IACH;AACA,YAAQ,KAAK,WAAW,KAAK;AAC7B,YAAQ,KAAK,UAAU,KAAK;AAAA,EAC9B,SAAS,KAAK;AAEZ,YAAQ;AAAA,MACN;AAAA,MACA,eAAe,QAAQ,IAAI,UAAU;AAAA,IACvC;AAAA,EACF;AACF;AAGA,KAAK,eAAe;;;ACrDpB;AAAA,EACE;AAAA,EACA,WAAW;AAAA,EACX;AAAA,EACA;AAAA,EACA;AAAA,OAGK;;;AC2DA,IAAM,gBAAgB;AAAA,EAC3B,MAAM;AAAA,EACN,OAAO;AAAA,EACP,OAAO;AAAA,EACP,SAAS;AAAA,EACT,cAAc;AAAA,EACd,aAAa;AACf;AAEA,IAAM,cAAc,CAAC,MAA8B,EAAE,KAAK,MAAM,KAAK,OAAO,EAAE,KAAK;AAS5E,SAAS,UAAU,QAAqD;AAI7E,QAAM,OAAO,CAAC,SAAyB;AACrC,UAAM,IAAI,OAAO,IAAI;AACrB,WAAO,OAAO,MAAM,WAAW,IAAI;AAAA,EACrC;AAEA,QAAM,OAAO,YAAY,KAAK,cAAc,IAAI,CAAC;AACjD,QAAM,UAAU,YAAY,KAAK,cAAc,OAAO,CAAC;AACvD,QAAM,cAAc,KAAK,cAAc,WAAW,EAC/C,MAAM,GAAG,EACT,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EACnB,OAAO,OAAO;AAQjB,QAAM,MAAM,KAAK,cAAc,KAAK,EAAE,KAAK,EAAE,YAAY;AACzD,QAAM,QACJ,SAAS,QAAQ,YAAY,OACzB,SACA,SAAS,QAAQ,QAAQ,kBACvB,kBACA;AAER,QAAM,QAAoB,YAAY,OAAO,YAAY,SAAS,OAAO,aAAa;AACtF,QAAM,OAAO,IAAI,IAAI,WAAW;AAEhC,SAAO;AAAA,IACL;AAAA,IACA,OAAO,YAAY,KAAK,cAAc,KAAK,CAAC;AAAA,IAC5C;AAAA,IACA,cAAc,YAAY,KAAK,cAAc,YAAY,CAAC;AAAA,IAC1D;AAAA,IACA;AAAA,IACA;AAAA,IACA,OAAO,CAAC,eAAe,eAAe,MAAM,KAAK,IAAI,UAAU;AAAA,IAC/D,eAAe,MAAM,UAAU;AAAA,EACjC;AACF;;;ADTA,IAAM,YAAY,CAAC,SAA2B,KAAK,MAAM,GAAG,EAAE,OAAO,OAAO;AAE5E,SAAS,gBAAgB,UAA6B;AACpD,SAAO,UAAU,QAAQ,EAAE,IAAI,CAAC,QAAQ;AACtC,UAAM,SAAS,iCAAiC,KAAK,GAAG;AACxD,QAAI,OAAQ,QAAO,EAAE,OAAO,OAAO,CAAC,EAAE;AACtC,QAAI,IAAI,WAAW,GAAG,KAAK,IAAI,SAAS,EAAG,QAAO,EAAE,OAAO,IAAI,MAAM,CAAC,EAAE;AACxE,WAAO,EAAE,KAAK,IAAI;AAAA,EACpB,CAAC;AACH;AAEA,SAAS,cAAc,UAAqB,SAAkD;AAC5F,MAAI,SAAS,WAAW,QAAQ,OAAQ,QAAO;AAC/C,QAAM,SAAiC,CAAC;AACxC,WAAS,IAAI,GAAG,IAAI,SAAS,QAAQ,KAAK;AACxC,UAAM,IAAI,SAAS,CAAC;AACpB,QAAI,EAAE,MAAO,QAAO,EAAE,KAAK,IAAI,mBAAmB,QAAQ,CAAC,CAAE;AAAA,aACpD,EAAE,QAAQ,QAAQ,CAAC,EAAG,QAAO;AAAA,EACxC;AACA,SAAO;AACT;AAEA,SAAS,SAAS,SAA6C,MAAsB;AACnF,MAAI,CAAC,QAAS,QAAO;AACrB,QAAM,SAAS,QAAQ,IAAI,KAAK,QAAQ,KAAK,YAAY,CAAC;AAC1D,MAAI,OAAO,WAAW,SAAU,QAAO;AACvC,QAAM,OAAO,KAAK,YAAY;AAC9B,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,OAAO,GAAG;AAC5C,QAAI,EAAE,YAAY,MAAM,QAAQ,OAAO,MAAM,SAAU,QAAO;AAAA,EAChE;AACA,SAAO;AACT;AAEA,SAAS,aAAa,OAAwC;AAC5D,MAAI,CAAC,SAAS,MAAM,MAAM,GAAG,EAAE,SAAS,EAAG,QAAO,CAAC;AACnD,MAAI;AACF,UAAM,UAAU,MAAM,MAAM,GAAG,EAAE,CAAC,EAAG,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG;AACzE,UAAM,SAAkB,KAAK,MAAM,OAAO,KAAK,SAAS,QAAQ,EAAE,SAAS,MAAM,CAAC;AAClF,WAAO,UAAU,OAAO,WAAW,WAAY,SAAqC,CAAC;AAAA,EACvF,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AAEA,SAAS,UAAU,KAAyC;AAC1D,QAAM,YAAY,IAAI,QAAQ,IAAI,YAAY,IAAI;AAClD,MAAI,aAAa,QAAQ,cAAc,GAAI,QAAO,CAAC;AACnD,MAAI,OAAO,cAAc,SAAU,QAAO;AAC1C,MAAI,OAAO,cAAc,UAAU;AACjC,QAAI;AACF,YAAM,SAAkB,KAAK,MAAM,SAAS;AAC5C,aAAO,UAAU,OAAO,WAAW,WAAY,SAAqC,CAAC;AAAA,IACvF,QAAQ;AACN,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACA,SAAO,CAAC;AACV;AAqBA,SAAS,WAAW,KAAwC;AAC1D,QAAM,MAA8B,CAAC;AACrC,QAAM,UAAU,OAAO,IAAI,QAAQ,EAAE;AACrC,QAAM,QAAQ,QAAQ,QAAQ,GAAG;AACjC,MAAI,SAAS,GAAG;AACd,eAAW,CAAC,GAAG,CAAC,KAAK,IAAI,gBAAgB,QAAQ,MAAM,QAAQ,CAAC,CAAC,EAAG,KAAI,CAAC,IAAI;AAC7E,WAAO;AAAA,EACT;AAUA,aAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,IAAI,SAAS,CAAC,CAAC,GAAG;AACpD,UAAM,MAAM,OAAO,MAAM,WAAW,IAAI,KAAK,OAAO,OAAO,OAAO,CAAC;AACnE,QAAI,QAAQ,KAAM,KAAI,gBAAgB,CAAC,CAAC,IAAI,gBAAgB,GAAG;AAAA,EACjE;AACA,SAAO;AACT;AAUA,SAAS,gBAAgB,OAAuB;AAC9C,MAAI;AACF,WAAO,mBAAmB,MAAM,QAAQ,OAAO,GAAG,CAAC;AAAA,EACrD,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AA0CA,IAAM,mBAAmB,CACvB,UAC+B,OAAQ,MAA4B,QAAQ;AAE7E,IAAM,SAAS,MAAM,UAAU,mBAAmB;AAGlD,IAAM,eAAsD;AAAA,EAC1D,MAAM,CAAC,YAAY,OAAO,KAAK,WAAW,CAAC,CAAC;AAAA,EAC5C,KAAK,CAAC,SAAS,QAAQ,SAAS,SAAS,GAAG,KAAK;AACnD;AAEO,SAAS,UAAyD,UAAyB,CAAC,GAAW;AAC5G,QAAM,SAA6B,CAAC;AACpC,QAAM,SAAS,QAAQ,WAAW;AAGlC,QAAM,WACJ,QAAQ,YAAY,iBAAiB,QAAQ,QAAQ,IACjD,QAAQ,WACR,eAAkB,EAAE,KAAK,QAAQ,MAAM,GAAI,QAAQ,YAAY,CAAC,EAAG,CAAC;AAE1E,QAAM,MAAc;AAAA,IAClB;AAAA,IACA,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC;AAAA,IACjC,MAAM,CAAC,GAAG,MAAM,IAAI,GAAG,QAAQ,GAAG,CAAC;AAAA,IACnC,KAAK,CAAC,GAAG,MAAM,IAAI,GAAG,OAAO,GAAG,CAAC;AAAA,IACjC,OAAO,CAAC,GAAG,MAAM,IAAI,GAAG,SAAS,GAAG,CAAC;AAAA,IACrC,QAAQ,CAAC,GAAG,MAAM,IAAI,GAAG,UAAU,GAAG,CAAC;AAAA,IACvC,GAAG,QAAQ,UAAU,SAAS;AAC5B,YAAM,WAAW,gBAAgB,QAAQ;AACzC,aAAO,KAAK;AAAA,QACV,QAAQ,OAAO,YAAY;AAAA,QAC3B;AAAA,QACA;AAAA,QACA,UAAU,SAAS,OAAO,CAAC,MAAM,EAAE,QAAQ,MAAS,EAAE;AAAA,QACtD;AAAA,MACF,CAAC;AAED,aAAO,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAC7C,aAAO;AAAA,IACT;AAAA,IACA,QAAQ,MAAM,OAAO,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,CAAC,GAAG,MAAM,EAAE,KAAK,cAAc,EAAE,IAAI,KAAK,EAAE,OAAO,cAAc,EAAE,MAAM,CAAC;AAAA,IACzJ,UAAU;AACR,aAAO,CAAC,YAAuB;AAC7B,cAAM,EAAE,KAAK,IAAI,IAAI;AACrB,cAAM,UAAU,IAAI,WAAW,CAAC;AAChC,cAAM,UAAU,IAAI,UAAU,OAAO,YAAY;AACjD,cAAM,UAAU,OAAO,IAAI,QAAQ,GAAG,EAAE,MAAM,GAAG,EAAE,CAAC;AACpD,cAAM,OAAO,QAAQ,QAAQ,QAAQ,EAAE,KAAK;AAK5C,cAAM,YAAY,YAAY,QAAQ,YAAY,OAAO,GAAG,SAAS,YAAY;AAEjF,eAAO,OAAO;AAAA,UACZ,GAAG,MAAM,IAAI,IAAI;AAAA,UACjB,EAAE,MAAM,SAAS,QAAQ,YAAY,EAAE,uBAAuB,QAAQ,YAAY,KAAK,EAAE;AAAA,UACzF;AAAA,UACA,OAAO,SAAe;AACpB,kBAAM,eAAe,SAAS,SAAS,oBAAoB;AAC3D,kBAAM,SACJ,SAAS,SAAS,mBAAmB,KACpC,aAAa,YAAY,EAAE,aAC5B;AACF,gBAAI,QAAQ,KAAM,MAAK,aAAa,gBAAgB,QAAQ,IAAI;AAChE,gBAAI,OAAQ,MAAK,aAAa,mBAAmB,MAAM;AACvD,kBAAM,MAAM,CAAC,MAAc,QAAQ,MAAM,CAAC;AAE1C,gBAAI,GAAG,QAAQ,QAAQ,KAAK,IAAI,MAAM,IAAI,IAAI,kBAAa,UAAU,MAAM,EAAE;AAE7E,gBAAI;AACF,kBAAI,UAAU,SAAS,OAAO,WAAW,OAAO;AAC9C,qBAAK,aAAa,cAAc,GAAG;AACnC,uBAAO,IAAI,KAAK;AAAA,kBACd,KAAK;AAAA,oBACH,IAAI,QAAQ,IAAI,mBAAmB;AAAA,oBACnC,MAAM,QAAQ,QAAQ,QAAQ,IAAI,qBAAqB;AAAA,oBACvD,YAAY,QAAQ,IAAI,2BAA2B;AAAA,oBACnD,SAAS,GAAG,QAAQ,IAAI,6BAA6B,EAAE,IAAI,QAAQ,IAAI,gCAAgC,EAAE;AAAA,kBAC3G;AAAA,kBACA,QAAQ;AAAA,kBACR,QAAQ,IAAI,OAAO;AAAA,kBACnB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,kBAClC,GAAI,QAAQ,cAAc,KAAK,CAAC;AAAA,gBAClC,CAAC;AAAA,cACH;AAEA,oBAAM,UAAU,UAAU,IAAI;AAC9B,kBAAI,UAA8E;AAClF,kBAAI,aAAa;AACjB,yBAAW,SAAS,QAAQ;AAC1B,sBAAM,SAAS,cAAc,MAAM,UAAU,OAAO;AACpD,oBAAI,CAAC,OAAQ;AACb,6BAAa;AACb,oBAAI,MAAM,WAAW,QAAQ;AAC3B,4BAAU,EAAE,OAAO,OAAO;AAC1B;AAAA,gBACF;AAAA,cACF;AAEA,kBAAI,CAAC,SAAS;AACZ,sBAAM,SAAS,aAAa,MAAM;AAClC,qBAAK,aAAa,6BAA6B,MAAM;AACrD,qBAAK,UAAU,EAAE,MAAM,eAAe,OAAO,SAAS,aAAa,uBAAuB,WAAW,CAAC;AACtG,oBAAI,YAAY;AACd,yBAAO,IAAI,KAAK,EAAE,OAAO,UAAU,MAAM,oBAAoB,IAAI,IAAI,MAAM,qBAAqB,GAAG,GAAG;AAAA,gBACxG;AACA,uBAAO,IAAI,KAAK,EAAE,OAAO,gBAAgB,MAAM,IAAI,IAAI,IAAI,MAAM,YAAY,QAAQ,IAAI,OAAO,EAAE,GAAG,GAAG;AAAA,cAC1G;AAEA,mBAAK,WAAW,GAAG,MAAM,IAAI,QAAQ,MAAM,QAAQ,EAAE;AACrD,mBAAK,aAAa,cAAc,QAAQ,MAAM,QAAQ;AAItD,kBAAI,gBAAwC,CAAC;AAC7C,kBAAI;AACF,gCAAgB,KAAK,MAAM,SAAS,SAAS,qBAAqB,KAAK,IAAI;AAAA,cAC7E,QAAQ;AACN,gCAAgB,CAAC;AAAA,cACnB;AAEA,oBAAM,IAAqB;AAAA,gBACzB,KAAK;AAAA,gBACL;AAAA,gBACA;AAAA,gBACA;AAAA,gBACA,QAAQ,EAAE,GAAG,QAAQ,QAAQ,GAAG,cAAc;AAAA,gBAC9C,OAAO,WAAW,GAAG;AAAA,gBACrB,MAAM,UAAU,GAAG;AAAA,gBACnB;AAAA,gBACA;AAAA,gBACA,QAAQ,CAAC,SAAS,SAAS,SAAS,IAAI;AAAA,gBACxC,OAAO,UAAU,CAAC,SAAS,SAAS,SAAS,IAAI,CAAC;AAAA,gBAClD;AAAA,gBACA,MAAM,CAAC,MAAM,aAAa,QAAQ,IAAI,KAAK,MAAM,UAAU;AAAA;AAAA;AAAA,gBAG3D,UAAU,CAAC,gBAAgB,SAAS,IAAI,GAAG,WAAW;AAAA,gBACtD,kBAAkB,CAAC,gBAAgB,SAAS,KAAK,GAAG,WAAW;AAAA,cACjE;AAEA,qBAAO,MAAM,QAAQ,MAAM,QAAQ,CAAC;AAAA,YACtC,SAAS,KAAK;AACZ,kBAAI,YAAY,GAAG,GAAG;AACpB,qBAAK,aAAa,6BAA6B,IAAI,MAAM;AACzD,oBAAI,IAAI,KAAM,MAAK,aAAa,uBAAuB,IAAI,IAAI;AAC/D,oBAAI,IAAI,UAAU,IAAK,MAAK,UAAU,EAAE,MAAM,eAAe,OAAO,SAAS,IAAI,QAAQ,CAAC;AAI1F,oBAAI,IAAI,iBAAiB,QAAW;AAClC,wBAAM,SACJ,OAAO,IAAI,iBAAiB,WAAW,IAAI,eAAe,KAAK,UAAU,IAAI,YAAY;AAC3F,uBAAK,aAAa,yBAAyB,MAAM;AACjD,0BAAQ,QAAQ,GAAG,MAAM,IAAI,IAAI,WAAM,IAAI,MAAM,IAAI,IAAI,OAAO,KAAK,MAAM,EAAE;AAAA,gBAC/E;AACA,uBAAO,IAAI;AAAA,kBACT;AAAA,oBACE,OAAO,IAAI;AAAA,oBACX,GAAI,IAAI,OAAO,EAAE,MAAM,IAAI,KAAK,IAAI,CAAC;AAAA,oBACrC,GAAI,IAAI,WAAW,OAAO,EAAE,SAAS,IAAI,QAAQ,IAAI,CAAC;AAAA,kBACxD;AAAA,kBACA,IAAI;AAAA,gBACN;AAAA,cACF;AAIA,oBAAM,MAAM,eAAe,QAAQ,IAAI,UAAU,OAAO,GAAG;AAC3D,mBAAK,aAAa,6BAA6B,GAAG;AAClD,mBAAK,gBAAgB,eAAe,QAAQ,MAAM,IAAI,MAAM,GAAG,CAAC;AAChE,mBAAK,UAAU,EAAE,MAAM,eAAe,OAAO,SAAS,IAAI,CAAC;AAC3D,sBAAQ,QAAQ,sBAAsB,MAAM,IAAI,IAAI,KAAK,GAAG,EAAE;AAC9D,qBAAO,IAAI,KAAK,EAAE,OAAO,kBAAkB,MAAM,iBAAiB,GAAG,GAAG;AAAA,YAC1E,UAAE;AACA,mBAAK,IAAI;AAAA,YACX;AAAA,UACF;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;;;AE7YO,IAAM,2BAA8C,OAAO,OAAO,CAAC,SAAS,UAAU,OAAO,CAAC;AAErG,IAAM,MAAM,CAAC,GAAY,MAAsB;AAC7C,QAAM,IAAI,SAAS,OAAO,CAAC,GAAG,EAAE;AAChC,SAAO,OAAO,SAAS,CAAC,IAAI,IAAI;AAClC;AAGA,IAAM,eAAe,CAAC,QACpB,aAAa,KAAK,OAAQ,KAA+C,QAAQ,EAAE,CAAC;AAoCtF,SAAS,iBAAiB,QAAgB,OAAqB;AAC7D,MAAI;AACF,SAAK,MAAM,KAAK;AAAA,EAClB,QAAQ;AACN,UAAM,IAAI;AAAA,MACR;AAAA,MACA,WAAW,MAAM;AAAA,MAGjB;AAAA,MACA,EAAE,MAAM,gBAAgB;AAAA,IAC1B;AAAA,EACF;AACF;AAUA,SAAS,gBAAgB,OAA+B,MAAyB;AAC/E,QAAM,UAAU,KAAK,WAAW,CAAC;AACjC,QAAM,QAAQ,KAAK,eAAe,CAAC;AACnC,QAAM,QAAQ,CAAC,MACb,OAAO,UAAU,eAAe,KAAK,SAAS,CAAC,KAAK,yBAAyB,SAAS,CAAC,KAAK,MAAM,SAAS,CAAC;AAC9G,QAAM,UAAU,OAAO,KAAK,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC1D,MAAI,QAAQ,WAAW,EAAG;AAC1B,QAAM,UAAU,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,OAAO,GAAG,GAAG,0BAA0B,GAAG,KAAK,CAAC,CAAC,EAAE,KAAK;AACpG,QAAM,SAAS,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AACrD,QAAM,IAAI;AAAA,IACR;AAAA,IACA,uBAAuB,MAAM;AAAA,IAE7B,EAAE,SAAS,QAAQ;AAAA,IACnB,EAAE,MAAM,iBAAiB;AAAA,EAC3B;AACF;AAGA,IAAM,kBAAkB,IAAI,OAAO,WAAW,CAAC,GAAG,GAAG,EAAE,KAAK,GAAG,CAAC,MAAM;AAYtE,SAAS,iBAAiB,QAAgB,OAAqB;AAC7D,MAAI,CAAC,gBAAgB,KAAK,KAAK,EAAG;AAClC,QAAM,IAAI;AAAA,IACR;AAAA,IACA,WAAW,MAAM,2BAA2B,MAAM,MAAM,GAAG,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC;AAAA,IAElF,EAAE,WAAW,OAAO;AAAA,IACpB,EAAE,MAAM,8BAA8B;AAAA,EACxC;AACF;AAEA,SAAS,YAAY,GAAiB,QAAwD;AAC5F,MAAI,CAAC,OAAQ,QAAO,CAAC;AACrB,QAAM,QAAQ,EAAE,OAAO,OAAO,KAAK;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,UAAU,KAAK,2BAA2B,OAAO,KAAK,KAAK,QAAW,EAAE,MAAM,oBAAoB,CAAC;AACzH,SAAO,EAAE,CAAC,OAAO,MAAM,GAAG,MAAM;AAClC;AAMA,eAAe,mBAAmB,GAAiB,QAA+C;AAChG,MAAI,CAAC,QAAQ,KAAM;AACnB,QAAM,QAAQ,EAAE,OAAO,OAAO,KAAK;AACnC,MAAI,CAAC,MAAO,OAAM,IAAI,UAAU,KAAK,2BAA2B,OAAO,KAAK,KAAK,QAAW,EAAE,MAAM,oBAAoB,CAAC;AACzH,MAAI,CAAE,MAAM,OAAO,KAAK,IAAI,KAAK,EAAI,OAAM,SAAS;AACtD;AAGA,eAAe,WACb,MACA,GACA,MACmC;AACnC,QAAM,KAAK,EAAE,OAAO,KAAK,WAAW,IAAI,KAAK;AAC7C,MAAI,CAAC,GAAI,OAAM,IAAI,UAAU,KAAK,2BAA2B,KAAK,WAAW,IAAI,KAAK,QAAW,EAAE,MAAM,oBAAoB,CAAC;AAC9H,QAAM,MAAM,MAAM,KAAK,IAAI,EAAE;AAC7B,MAAI,CAAC,IAAK,OAAM,SAAS;AACzB,MAAI,KAAK,QAAQ;AACf,UAAM,WAAW,EAAE,OAAO,KAAK,OAAO,KAAK;AAC3C,QAAI,OAAO,IAAI,KAAK,OAAO,MAAM,KAAK,EAAE,MAAM,OAAO,YAAY,EAAE,EAAG,OAAM,SAAS;AAAA,EACvF;AACA,SAAO,EAAE,IAAI,IAAI;AACnB;AAEO,SAAS,UACd,KACA,MACA,MACQ;AACR,QAAM,OAAO,KAAK,KAAK,QAAQ,QAAQ,EAAE;AACzC,QAAM,aAAa,GAAG,IAAI,KAAK,KAAK,WAAW,IAAI;AACnD,QAAM,UAAU,IAAI,IAAI,KAAK,QAAQ,CAAC,QAAQ,OAAO,UAAU,UAAU,QAAQ,CAAC;AAClF,QAAM,eAAe,KAAK,gBAAgB;AAC1C,QAAM,WAAW,KAAK,YAAY;AAElC,MAAI,QAAQ,IAAI,MAAM,GAAG;AACvB,QAAI,IAAI,MAAM,OAAO,MAAM;AAEzB,sBAAgB,EAAE,OAAO,IAAI;AAC7B,YAAM,QAAgC,CAAC;AACvC,iBAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,EAAE,KAAK,GAAG;AAE5C,YAAI,CAAC,KAAK,WAAW,CAAC,OAAO,UAAU,eAAe,KAAK,KAAK,SAAS,CAAC,EAAG;AAC7E,yBAAiB,GAAG,CAAC;AACrB,YAAI,aAAa,KAAK,QAAQ,CAAC,CAAC,EAAG,kBAAiB,GAAG,CAAC;AACxD,cAAM,CAAC,IAAI;AAAA,MACb;AACA,YAAM,mBAAmB,GAAG,KAAK,MAAM;AAGvC,aAAO,OAAO,OAAO,YAAY,GAAG,KAAK,MAAM,CAAC;AAChD,YAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,IAAI,EAAE,MAAM,OAAO,YAAY,GAAG,CAAC,GAAG,QAAQ;AAC9E,YAAM,SAAS,KAAK,IAAI,IAAI,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC;AACjD,YAAM,QAAQ,OAAO,EAAE,MAAM,UAAU,YAAY,EAAE,MAAM,QAAQ,EAAE,MAAM,QAAQ;AACnF,YAAM,QAAe,EAAE,OAAO,OAAO,QAAQ,GAAI,QAAQ,EAAE,MAAM,IAAI,CAAC,EAAG;AAEzE,UAAI,KAAK,MAAM;AACb,cAAM,EAAE,OAAAA,QAAO,MAAM,IAAI,MAAM,KAAK,KAAK,KAAK;AAC9C,eAAO,EAAE,KAAK;AAAA,UACZ,OAAAA;AAAA,UACA,MAAM,EAAE,OAAO,QAAQ,OAAO,UAAUA,OAAM,QAAQ,SAAS,SAASA,OAAM,SAAS,MAAM;AAAA,UAC7F,QAAQ;AAAA,QACV,CAAC;AAAA,MACH;AACA,YAAM,QAAQ,MAAM,KAAK,KAAK,KAAK;AACnC,aAAO,EAAE,KAAK,EAAE,OAAO,MAAM,EAAE,OAAO,QAAQ,UAAU,MAAM,OAAO,GAAG,QAAQ,MAAM,CAAC;AAAA,IACzF,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,KAAK,MAAM,OAAO,MAAM;AAC1B,YAAM,mBAAmB,GAAG,KAAK,MAAM;AACvC,YAAM,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,MAAM,EAAE;AACzD,aAAO,EAAE,KAAK,MAAM,KAAK,OAAO,IAAI,GAAG,GAAG;AAAA,IAC5C,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,KAAK,GAAG;AACtB,QAAI,IAAI,YAAY,OAAO,MAAM;AAC/B,YAAM,EAAE,IAAI,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAC9C,aAAO,EAAE,KAAK,GAAG;AAAA,IACnB,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,IAAI,YAAY,OAAO,MAAM;AAC/B,YAAM,EAAE,GAAG,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAO7C,UAAI,aAAa,EAAE,IAAI,EAAE,WAAW,EAAG,OAAM,IAAI,UAAU,KAAK,sBAAsB,QAAW,EAAE,MAAM,eAAe,CAAC;AAEzH,YAAM,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,KAAK,MAAM,EAAE;AAC1D,aAAO,EAAE,KAAK,MAAM,KAAK,OAAO,IAAI,KAAK,CAAC;AAAA,IAC5C,CAAC;AAAA,EACH;AAEA,MAAI,QAAQ,IAAI,QAAQ,GAAG;AACzB,QAAI,OAAO,YAAY,OAAO,MAAM;AAClC,YAAM,EAAE,GAAG,IAAI,MAAM,WAAW,MAAM,GAAG,IAAI;AAC7C,YAAM,KAAK,OAAO,EAAE;AACpB,aAAO,EAAE,KAAK,EAAE,SAAS,MAAM,GAAG,CAAC;AAAA,IACrC,CAAC;AAAA,EACH;AAEA,SAAO;AACT;","names":["items"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@revenexx/app-sdk",
3
- "version": "0.9.0",
3
+ "version": "1.0.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",
@@ -17,11 +17,6 @@
17
17
  "types": "./dist/router/index.d.ts",
18
18
  "import": "./dist/router/index.js",
19
19
  "require": "./dist/router/index.cjs"
20
- },
21
- "./instrument": {
22
- "types": "./dist/instrument.d.ts",
23
- "import": "./dist/instrument.js",
24
- "require": "./dist/instrument.cjs"
25
20
  }
26
21
  },
27
22
  "files": [
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../src/errors.ts","../src/settings.ts","../src/patch.ts"],"sourcesContent":["/**\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 * 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 * 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"],"mappings":"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","names":[]}