@revenexx/app-sdk 0.7.1 → 0.7.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/{errors-Co6JSseO.d.cts → errors-CeQxIhQn.d.cts} +1 -1
- package/dist/{errors-Co6JSseO.d.ts → errors-CeQxIhQn.d.ts} +1 -1
- package/dist/index.cjs +5 -2
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +22 -6
- package/dist/index.d.ts +22 -6
- package/dist/index.js +5 -2
- package/dist/index.js.map +1 -1
- package/dist/router/index.cjs +16 -1
- package/dist/router/index.cjs.map +1 -1
- package/dist/router/index.d.cts +2 -2
- package/dist/router/index.d.ts +2 -2
- package/dist/router/index.js +16 -1
- package/dist/router/index.js.map +1 -1
- package/package.json +1 -1
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Shared runtime types. The generated per-App client (emitted by
|
|
3
|
-
*
|
|
3
|
+
* `revenexx apps generate`) layers strongly-typed entity interfaces on top of
|
|
4
4
|
* these loose runtime shapes.
|
|
5
5
|
*/
|
|
6
6
|
type FilterOp = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'is';
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
/**
|
|
2
2
|
* Shared runtime types. The generated per-App client (emitted by
|
|
3
|
-
*
|
|
3
|
+
* `revenexx apps generate`) layers strongly-typed entity interfaces on top of
|
|
4
4
|
* these loose runtime shapes.
|
|
5
5
|
*/
|
|
6
6
|
type FilterOp = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'is';
|
package/dist/index.cjs
CHANGED
|
@@ -418,8 +418,11 @@ function createRuntimeAdapter(config = {}) {
|
|
|
418
418
|
endpoint: env.REVENEXX_DATA_ENDPOINT || DEFAULT_DATA_ENDPOINT,
|
|
419
419
|
token: get("x-revenexx-context") || env.REVENEXX_CONTEXT || "",
|
|
420
420
|
tenant: get("x-revenexx-tenant") || env.REVENEXX_TENANT || "",
|
|
421
|
-
// Active market
|
|
422
|
-
//
|
|
421
|
+
// Active market forwarded to the data layer. It ASSIGNS the market on
|
|
422
|
+
// insert and filters reads only through a `*_scoped` view — generated
|
|
423
|
+
// entities read the base table, so on the app path a list is unaffected by
|
|
424
|
+
// it. See RemoteConfig.market; absent is a no-op on reads, not a narrower
|
|
425
|
+
// default.
|
|
423
426
|
market: get("x-revenexx-market") || env.REVENEXX_MARKET || ""
|
|
424
427
|
});
|
|
425
428
|
return { ...remote, kind: "runtime" };
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../src/index.ts","../src/adapters/mock.ts","../src/errors.ts","../src/query.ts","../src/adapters/postgrest-error.ts","../src/adapters/remote.ts","../src/adapters/runtime.ts","../src/adapters/index.ts","../src/patch.ts","../src/client.ts","../src/settings.ts"],"sourcesContent":["/**\n * @revenexx/app-sdk — typed PostgREST data client for revenexx Apps.\n *\n * The generated per-App client (see @revenexx/app-sdk-cli) wraps `createClient`\n * with strongly-typed entity interfaces. You can also use this runtime directly.\n */\n\nexport { createClient, opsFromAccess } from './client.js';\nexport type { Client, ClientConfig, EntityClient } from './client.js';\n\nexport { toParams, matches } from './query.js';\n\n// App settings: the tenant's configuration for this app, resolved by the\n// gateway (market override → tenant value → schema default) and cached.\n// Also re-exported from `@revenexx/app-sdk/router`, where `createApp` can own\n// the reader for you (`c.settings()`).\nexport {\n createSettings,\n DEFAULT_GATEWAY_ENDPOINT,\n DEFAULT_SETTINGS_TTL_MS,\n DEFAULT_SETTINGS_ERROR_TTL_MS,\n DEFAULT_SETTINGS_TIMEOUT_MS,\n} from './settings.js';\nexport type {\n SettingsReader,\n SettingsOptions,\n SettingsSnapshot,\n SettingsSource,\n SettingsDefaults,\n ResolvedSettings,\n ReadOptions,\n} from './settings.js';\n\n// The data client raises HttpError for mapped data-plane failures (a duplicate\n// key is a 409, not a 500). `@revenexx/app-sdk/router` turns it into the HTTP\n// response; catch it directly when you are not using the router. Use\n// `isHttpError`, not `instanceof` — the two entrypoints are separate bundles.\nexport { HttpError, isHttpError } from './errors.js';\nexport type { HttpErrorOptions } from './errors.js';\n\nexport {\n registerAdapter,\n createAdapter,\n adapterKinds,\n createMockAdapter,\n createRemoteAdapter,\n createRuntimeAdapter,\n applyDefaults,\n} from './adapters/index.js';\nexport type { AdapterFactory } from './adapters/index.js';\nexport type { RemoteConfig } from './adapters/remote.js';\nexport type { RuntimeConfig } from './adapters/runtime.js';\nexport { DEFAULT_DATA_ENDPOINT } from './adapters/runtime.js';\n\nexport type {\n Adapter,\n Entity,\n ColumnDef,\n Op,\n Query,\n Filter,\n FilterOp,\n Scalar,\n Row,\n Page,\n} from './types.js';\n","import { randomUUID } from 'node:crypto';\nimport type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { notFound } from '../errors.js';\nimport { matches } from '../query.js';\n\n/** Apply order → offset → limit → select to an already-filtered row set. */\nfunction shape(rows: Row[], query: Query): Row[] {\n let out = rows;\n if (query.order) {\n const [c, dir = 'asc'] = query.order.split('.');\n const key = c as string;\n out = out.slice().sort((a, b) => (a[key]! < b[key]! ? -1 : a[key]! > b[key]! ? 1 : 0));\n if (dir === 'desc') out.reverse();\n }\n if (query.offset) out = out.slice(query.offset);\n if (Number.isInteger(query.limit)) out = out.slice(0, query.limit);\n if (Array.isArray(query.select) && query.select.length) {\n const cols = query.select as string[];\n out = out.map((r) => Object.fromEntries(cols.map((c) => [c, r[c]])));\n }\n return out.map((r) => ({ ...r }));\n}\n\n/** Best-effort apply of schema.json column defaults for the mock adapter. */\nexport function applyDefaults(entity: Entity, data: Row): Row {\n const row: Row = { ...data };\n for (const [col, def] of Object.entries(entity.columns ?? {})) {\n if (row[col] !== undefined || def == null) continue;\n const d = def.default;\n if (d == null) continue;\n if (/gen_random_uuid/i.test(d)) row[col] = randomUUID();\n else if (/now\\(\\)|current_timestamp/i.test(d)) row[col] = new Date().toISOString();\n else {\n const m = /^'(.*)'$/.exec(String(d).trim());\n if (m) row[col] = m[1];\n }\n }\n return row;\n}\n\n/**\n * In-memory adapter. Zero infrastructure: develop + unit-test App logic against\n * fixtures. Does NOT enforce RLS, constraints, triggers or PostgREST semantics —\n * run the `remote` adapter against a dev tenant for that fidelity before deploy.\n */\nexport function createMockAdapter(seed: Record<string, Row[]> = {}): Adapter {\n const store = new Map<string, Map<unknown, Row>>();\n const tbl = (entity: Entity): Map<unknown, Row> => {\n let m = store.get(entity.name);\n if (!m) {\n m = new Map();\n for (const r of seed[entity.name] ?? []) m.set(r[entity.pk], { ...r });\n store.set(entity.name, m);\n }\n return m;\n };\n\n return {\n kind: 'mock',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return shape(filtered, query);\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return { items: shape(filtered, query), total: filtered.length, limit: query.limit, offset: query.offset };\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const r = tbl(entity).get(id);\n return r ? { ...r } : null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const row = applyDefaults(entity, data);\n if (row[entity.pk] === undefined) row[entity.pk] = randomUUID();\n tbl(entity).set(row[entity.pk], row);\n return { ...row };\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const cur = tbl(entity).get(id);\n // Same answer the remote adapter gives for a patch that matched no row —\n // a 404, not a 500. The message is unchanged so existing App tests that\n // assert on it keep passing.\n if (!cur) throw notFound(`mock: ${entity.name}/${String(id)} not found`);\n const row: Row = { ...cur, ...patch };\n if (entity.columns?.updated_at) row.updated_at = new Date().toISOString();\n tbl(entity).set(id, row);\n return { ...row };\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n tbl(entity).delete(id);\n },\n };\n}\n","/**\n * The one error representation every layer of the SDK agrees on.\n *\n * `HttpError` used to live in `./router/router.ts`. It moved here so the data\n * adapters can raise it too: an adapter that knows a PostgREST failure is a\n * duplicate key can say \"409\" without the router having to guess from a\n * message string.\n *\n * Two fields exist purely to keep internal database detail out of responses:\n * - `message` / `details` are the *client-facing* payload — always safe,\n * never derived from a database error body.\n * - `serverDetail` is the raw diagnosis. The router logs it and drops it; it\n * is never serialised into a response.\n */\n\nexport interface HttpErrorOptions {\n /** Stable machine-readable code (e.g. `unique_violation`). Safe to expose. */\n code?: string;\n /**\n * Raw diagnosis for server-side logs and traces only — may contain table and\n * constraint names. Never included in the HTTP response.\n */\n serverDetail?: unknown;\n}\n\n/** Throw inside a handler (or an adapter) to answer with a specific HTTP status. */\nexport class HttpError extends Error {\n readonly status: number;\n readonly details?: unknown;\n readonly code?: string;\n readonly serverDetail?: unknown;\n /**\n * Structural marker. `dist/index.cjs` and `dist/router/index.cjs` are separate\n * bundles, so an error thrown by the data client and caught by the router is\n * an instance of a *different* copy of this class — `instanceof` would be\n * false. Everything checks this flag via `isHttpError` instead.\n */\n readonly __isHttpError = true as const;\n\n constructor(status: number, message: string, details?: unknown, options: HttpErrorOptions = {}) {\n super(message);\n this.name = 'HttpError';\n this.status = status;\n if (details !== undefined) this.details = details;\n if (options.code !== undefined) this.code = options.code;\n if (options.serverDetail !== undefined) this.serverDetail = options.serverDetail;\n }\n}\n\n/** Duck-typed `instanceof HttpError` — survives the bundle split (see above). */\nexport function isHttpError(err: unknown): err is HttpError {\n if (!err || typeof err !== 'object') return false;\n const e = err as { __isHttpError?: unknown; name?: unknown; status?: unknown };\n return e.__isHttpError === true || (e.name === 'HttpError' && typeof e.status === 'number');\n}\n\nexport const notFound = (message = 'not found'): HttpError => new HttpError(404, message);\nexport const badRequest = (message = 'bad request', details?: unknown): HttpError =>\n new HttpError(400, message, details);\nexport const forbidden = (message = 'forbidden'): HttpError => new HttpError(403, message);\nexport const conflict = (message = 'conflict'): HttpError => new HttpError(409, message);\n","import type { Query, FilterOp, Row } from './types.js';\n\n/**\n * PostgREST query helpers. `toParams` serialises a query for the HTTP adapters;\n * `matches` applies the same `where` semantics in memory for the mock adapter —\n * keeping one shape means App code is identical across adapters.\n */\n\nconst OPS = new Set<FilterOp>(['eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'like', 'ilike', 'in', 'is']);\n\n/** Serialise a query object to PostgREST URLSearchParams. */\nexport function toParams(query: Query = {}): URLSearchParams {\n const params = new URLSearchParams();\n const { where = {}, select, order, limit, offset } = query;\n\n for (const [col, cond] of Object.entries(where)) {\n if (Array.isArray(cond)) {\n params.append(col, `in.(${cond.join(',')})`);\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!OPS.has(c.op)) throw new Error(`query: unsupported operator '${c.op}'`);\n const v = Array.isArray(c.value) ? `(${c.value.join(',')})` : c.value;\n params.append(col, `${c.op}.${v}`);\n } else {\n params.append(col, `eq.${cond}`);\n }\n }\n\n if (Array.isArray(select) && select.length) params.set('select', (select as string[]).join(','));\n if (order) params.set('order', /\\.(asc|desc)$/.test(order) ? order : `${order}.asc`);\n if (Number.isInteger(limit)) params.set('limit', String(limit));\n if (Number.isInteger(offset)) params.set('offset', String(offset));\n\n return params;\n}\n\n/** In-memory predicate mirroring `toParams`' `where` semantics (mock adapter). */\nexport function matches(row: Row, where: Query['where'] = {}): boolean {\n for (const [col, cond] of Object.entries(where)) {\n const val = row[col];\n if (Array.isArray(cond)) {\n if (!cond.includes(val as never)) return false;\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!compare(val, c.op, c.value)) return false;\n } else if (val !== cond) {\n return false;\n }\n }\n return true;\n}\n\nfunction compare(a: unknown, op: FilterOp, b: unknown): boolean {\n switch (op) {\n case 'eq': return a === b;\n case 'neq': return a !== b;\n case 'gt': return (a as number) > (b as number);\n case 'gte': return (a as number) >= (b as number);\n case 'lt': return (a as number) < (b as number);\n case 'lte': return (a as number) <= (b as number);\n case 'is': return a === b;\n case 'in': return Array.isArray(b) && b.includes(a);\n case 'like':\n case 'ilike': {\n const re = new RegExp(\n '^' + String(b).replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&').replace(/%/g, '.*').replace(/_/g, '.') + '$',\n op === 'ilike' ? 'i' : '',\n );\n return re.test(String(a));\n }\n default: return false;\n }\n}\n","/**\n * PostgREST failure → HTTP answer.\n *\n * PostgREST reports database constraint violations with a JSON body that names\n * the offending table and constraint:\n *\n * {\"code\":\"23505\",\"details\":\"Key (tenant_id, code)=(…) already exists.\",\n * \"message\":\"duplicate key value violates unique constraint\n * \\\"idx__revenexx__channels__channels__tenant_id_code__uniq\\\"\"}\n *\n * Forwarding that verbatim is wrong twice over: an expected condition (a\n * duplicate code) reads as a server outage, and the response leaks the internal\n * schema to every API caller. This module maps the failure to a status the\n * platform's own error contract already understands, with a stable, generic\n * message. The raw body travels on `HttpError.serverDetail`, which the router\n * logs and never serialises.\n *\n * Mapping:\n * 23505 unique_violation → 409 a record with this value already exists\n * 23P01 exclusion_violation → 409 conflicts with an existing record\n * 23503 foreign_key_violation → 400 when the referenced parent is missing\n * → 409 when a dependent row blocks a delete\n * 23502 not_null_violation → 400 a required value is missing\n * 23514 check_violation → 400 value not allowed\n * 22xxx data exception → 400 wrong format (22P02 bad uuid/number …)\n * anything else → PostgREST's own status when it is a client\n * error we recognise, otherwise 500\n *\n * `PGRST103` (offset past the end of the result set) is deliberately *not* an\n * error — see `rangeNotSatisfiable` and the adapter's `list`/`page`.\n */\n\nimport { HttpError } from '../errors.js';\n\n/** The shape PostgREST uses for error bodies. */\ninterface PgErrorBody {\n code?: string;\n message?: string;\n details?: string;\n hint?: string;\n}\n\nfunction parseBody(body: string): PgErrorBody {\n if (!body) return {};\n try {\n const parsed: unknown = JSON.parse(body);\n return parsed && typeof parsed === 'object' ? (parsed as PgErrorBody) : {};\n } catch {\n return {};\n }\n}\n\ninterface Mapped {\n status: number;\n code: string;\n message: string;\n}\n\n/** SQLSTATE → what the caller is allowed to know. */\nconst BY_SQLSTATE: Record<string, Mapped> = {\n '23505': { status: 409, code: 'unique_violation', message: 'a record with this value already exists' },\n '23P01': { status: 409, code: 'exclusion_violation', message: 'a record conflicts with an existing one' },\n '23502': { status: 400, code: 'not_null_violation', message: 'a required value is missing' },\n '23514': { status: 400, code: 'check_violation', message: 'a value is not allowed here' },\n '22P02': { status: 400, code: 'invalid_value', message: 'a value in the request has the wrong format' },\n};\n\n/** Statuses PostgREST returns that already describe the client's mistake. */\nconst CLIENT_STATUS: Record<number, string> = {\n 400: 'the request could not be processed',\n 401: 'unauthenticated',\n 403: 'forbidden',\n 404: 'not found',\n 405: 'method not allowed',\n 406: 'the requested representation is not available',\n 409: 'the request conflicts with the current state of the data',\n 413: 'the request is too large',\n 415: 'unsupported media type',\n 422: 'the request could not be processed',\n 429: 'too many requests',\n};\n\n/**\n * A foreign-key violation is two different bugs depending on direction, and\n * Postgres' own wording distinguishes them reliably (PostgREST forwards it\n * untouched in `details`):\n *\n * write: Key (market_id)=(…) is not present in table \"markets\". → 400\n * delete: Key (id)=(…) is still referenced from table \"locales\". → 409\n *\n * If neither phrase is present (a localised server, or future wording), fall\n * back to the request method: a DELETE can only fail on a dependent row, any\n * other verb can only fail on a missing parent.\n */\nfunction foreignKey(pg: PgErrorBody, method: string): Mapped {\n const blocked: Mapped = {\n status: 409,\n code: 'foreign_key_violation',\n message: 'this record is still referenced by other records',\n };\n const missing: Mapped = {\n status: 400,\n code: 'foreign_key_violation',\n message: 'a referenced record does not exist',\n };\n const text = `${pg.details ?? ''} ${pg.message ?? ''}`;\n if (/is still referenced from/i.test(text)) return blocked;\n if (/is not present in table/i.test(text)) return missing;\n return method.toUpperCase() === 'DELETE' ? blocked : missing;\n}\n\nfunction classify(status: number, pg: PgErrorBody, method: string): Mapped {\n const sqlstate = typeof pg.code === 'string' ? pg.code : '';\n if (sqlstate === '23503') return foreignKey(pg, method);\n const known = BY_SQLSTATE[sqlstate];\n if (known) return known;\n // Class 22 is Postgres' \"data exception\" family — always bad input, never a\n // server fault (22003 numeric out of range, 22007 bad timestamp, 22001 value\n // too long, …).\n if (/^22/.test(sqlstate)) {\n return { status: 400, code: 'invalid_value', message: 'a value in the request has the wrong format' };\n }\n const generic = CLIENT_STATUS[status];\n if (generic) return { status, code: 'bad_request', message: generic };\n return { status: 500, code: 'data_error', message: 'the data service could not complete the request' };\n}\n\n/**\n * Map a non-2xx PostgREST response to an `HttpError` whose message is safe to\n * return. The raw body is preserved on `serverDetail` for logs only.\n */\nexport function postgrestError(status: number, body: string, context: { method: string; table?: string }): HttpError {\n const pg = parseBody(body);\n const mapped = classify(status, pg, context.method);\n return new HttpError(mapped.status, mapped.message, undefined, {\n code: mapped.code,\n serverDetail: {\n source: 'postgrest',\n status,\n method: context.method,\n ...(context.table ? { table: context.table } : {}),\n sqlstate: pg.code ?? null,\n message: pg.message ?? (body || null),\n details: pg.details ?? null,\n hint: pg.hint ?? null,\n },\n });\n}\n\n/**\n * `PGRST103` / HTTP 416: the requested offset is past the end of the result\n * set. That is a legitimate request — the last page of a table someone just\n * emptied — not a failure, so callers answer with an empty page instead of an\n * error. Returns the true row count PostgREST reported, or `null` when the\n * response is a real error.\n */\nexport function rangeNotSatisfiable(status: number, body: string): { total: number } | null {\n if (status !== 416) return null;\n const pg = parseBody(body);\n // PostgREST: \"An offset of 25 was requested, but there are only 3 rows.\"\n const m = /there are only (\\d+) rows/i.exec(`${pg.details ?? ''} ${pg.message ?? ''}`);\n return { total: m ? Number.parseInt(m[1]!, 10) : 0 };\n}\n","import type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { toParams } from '../query.js';\nimport { HttpError, notFound } from '../errors.js';\nimport { postgrestError, rangeNotSatisfiable } from './postgrest-error.js';\n\nexport interface RemoteConfig {\n endpoint: string;\n token?: string;\n tenant?: string;\n /** Active market (scope filter). Forwarded as X-Revenexx-Market so the\n * data layer's scoping engine (baseline.is_visible) filters market-scoped\n * rows to this market + globals. A filter, not a security boundary — the\n * tenant is the hard contract (token/RLS). */\n market?: string;\n fetchImpl?: typeof fetch;\n}\n\n/** PostgREST-over-HTTP adapter (production data plane / dev tenant). */\nexport function createRemoteAdapter(config: RemoteConfig): Adapter {\n const f = config.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') {\n throw new Error('remote adapter: no fetch available (Node >=18 or pass fetchImpl)');\n }\n const base = String(config.endpoint ?? '').replace(/\\/$/, '');\n if (!base) throw new Error('remote adapter: endpoint is required');\n\n const headers = (extra?: Record<string, string>): Record<string, string> => {\n const h: Record<string, string> = { 'Content-Type': 'application/json', Accept: 'application/json', ...extra };\n if (config.token) h.Authorization = `Bearer ${config.token}`;\n if (config.tenant) h['X-Revenexx-Tenant'] = config.tenant;\n if (config.market) h['X-Revenexx-Market'] = config.market;\n return h;\n };\n\n interface Sent {\n status: number;\n ok: boolean;\n text: string;\n // Total parsed from the Content-Range header (\"0-9/247\"), when present.\n total: number | null;\n }\n\n interface SendOptions {\n body?: unknown;\n prefer?: string;\n /** Table name — server-side log context only, never returned to a caller. */\n table?: string;\n }\n\n async function send(method: string, path: string, opts: SendOptions = {}): Promise<Sent> {\n const res = await f(`${base}${path}`, {\n method,\n headers: headers(opts.prefer ? { Prefer: opts.prefer } : {}),\n body: opts.body != null ? JSON.stringify(opts.body) : undefined,\n });\n const text = await res.text();\n const range = res.headers?.get?.('content-range') ?? '';\n const total = Number.parseInt(range.split('/')[1] ?? '', 10);\n return { status: res.status, ok: res.ok, text, total: Number.isFinite(total) ? total : null };\n }\n\n async function req(method: string, path: string, opts: SendOptions = {}): Promise<unknown> {\n const { ok, status, text } = await send(method, path, opts);\n // Constraint violations become the status they deserve, with a message that\n // names no table or constraint (see ./postgrest-error).\n if (!ok) throw postgrestError(status, text, { method, table: opts.table });\n return text ? JSON.parse(text) : null;\n }\n\n /**\n * The single row out of a `return=representation` response.\n *\n * PostgREST answers `200 []` — a success — whenever the write touched no row:\n * a `PATCH` whose filter matched nothing, or one whose body carried no\n * columns. `rows[0]` is then `undefined`, and returning it breaks the\n * `Promise<Row>` contract in the worst possible place: the App hands it to\n * `res.json()`, `JSON.stringify(undefined)` is `undefined`, and the runtime's\n * `Buffer.from(undefined)` raises a Node type error that surfaces to the\n * caller as a 500. Nothing downstream can recover from that, so the absence\n * is reported here, as an answer the caller can act on.\n */\n const oneRow = (rows: unknown, onMissing: () => HttpError): Row => {\n const row = Array.isArray(rows) ? (rows[0] as Row | undefined) : (rows as Row | null);\n if (row == null) throw onMissing();\n return row;\n };\n\n return {\n kind: 'remote',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const qs = toParams(query).toString();\n const { ok, status, text } = await send('GET', `/${entity.table}${qs ? `?${qs}` : ''}`, {\n table: entity.table,\n });\n if (!ok) {\n // An offset past the end of the result set is a legitimate request, not\n // a failure — answer with no rows (see ./postgrest-error).\n if (rangeNotSatisfiable(status, text)) return [];\n throw postgrestError(status, text, { method: 'GET', table: entity.table });\n }\n return (text ? (JSON.parse(text) as Row[]) : []) ?? [];\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const rows = (await req('GET', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}&limit=1`, {\n table: entity.table,\n })) as Row[];\n return rows?.[0] ?? null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const rows = await req('POST', `/${entity.table}`, {\n body: data,\n prefer: 'return=representation',\n table: entity.table,\n });\n // An insert that reports success but returns no row means the row is not\n // readable back (an RLS policy that permits INSERT but not SELECT). That\n // is a server-side condition, so it keeps a 5xx — but a described one.\n return oneRow(\n rows,\n () =>\n new HttpError(500, 'the record was created but could not be read back', undefined, {\n code: 'empty_representation',\n serverDetail: { source: 'postgrest', method: 'POST', table: entity.table },\n }),\n );\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const rows = await req('PATCH', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {\n body: patch,\n prefer: 'return=representation',\n table: entity.table,\n });\n // No row came back for a patch that carried fields: the row is gone or\n // invisible to this tenant (deleted between the read and the write, or\n // filtered by RLS). Both are a 404 to the caller. An empty patch never\n // reaches here — the client rejects it with a 400 first (see ../patch.ts).\n return oneRow(rows, () => notFound());\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n await req('DELETE', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {\n table: entity.table,\n });\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n // One request: PostgREST returns the page in the body and the total in\n // Content-Range (\"0-9/247\" or \"*/247\") when asked for an exact count.\n const qs = toParams(query).toString();\n const { ok, status, text, total } = await send('GET', `/${entity.table}${qs ? `?${qs}` : ''}`, {\n prefer: 'count=exact',\n table: entity.table,\n });\n if (!ok) {\n // Paging past the end of the result set is a legitimate request — the\n // last page of a list someone just emptied. Answer with an empty page\n // carrying the requested bounds and the true total, not an error.\n const overflow = rangeNotSatisfiable(status, text);\n if (overflow) {\n return { items: [], total: total ?? overflow.total, limit: query.limit, offset: query.offset };\n }\n throw postgrestError(status, text, { method: 'GET', table: entity.table });\n }\n const items = (text ? JSON.parse(text) : []) as Row[];\n return {\n items,\n total: total ?? items.length,\n limit: query.limit,\n offset: query.offset,\n };\n },\n };\n}\n","import type { Adapter } from '../types.js';\nimport { createRemoteAdapter } from './remote.js';\n\ninterface FunctionContext {\n req?: { headers?: Record<string, string> };\n}\n\nexport interface RuntimeConfig {\n context?: FunctionContext;\n env?: Record<string, string | undefined>;\n}\n\n/** The platform data plane. Override with REVENEXX_DATA_ENDPOINT when needed. */\nexport const DEFAULT_DATA_ENDPOINT = 'https://apps.api.revenexx.com';\n\n/**\n * Production adapter: a `remote` adapter auto-configured from the function's\n * per-invocation context. Token = the brokered identity forwarded as\n * `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env, falling\n * back to the platform data plane — deployed apps work with zero configuration.\n * App code stays identical — only the adapter selection differs between local\n * and prod.\n */\nexport function createRuntimeAdapter(config: RuntimeConfig = {}): Adapter {\n const env = config.env ?? process.env;\n const h = config.context?.req?.headers ?? {};\n const get = (name: string): string => h[name] ?? h[name.toLowerCase()] ?? '';\n\n const remote = createRemoteAdapter({\n endpoint: env.REVENEXX_DATA_ENDPOINT || DEFAULT_DATA_ENDPOINT,\n token: get('x-revenexx-context') || env.REVENEXX_CONTEXT || '',\n tenant: get('x-revenexx-tenant') || env.REVENEXX_TENANT || '',\n // Active market (scope filter) forwarded to the data layer. Absent → the\n // scoping engine sees no market → only global rows match (safe default).\n market: get('x-revenexx-market') || env.REVENEXX_MARKET || '',\n });\n\n return { ...remote, kind: 'runtime' };\n}\n","import type { Adapter } from '../types.js';\nimport { createMockAdapter, applyDefaults } from './mock.js';\nimport { createRemoteAdapter } from './remote.js';\nimport { createRuntimeAdapter } from './runtime.js';\n\n/**\n * Adapter registry. Built-ins (mock | remote | runtime) are registered below;\n * add a new backend by calling `registerAdapter('my-kind', (config) => …)`\n * before constructing the client — no changes to the client or generated code.\n */\nexport type AdapterFactory = (config: Record<string, any>) => Adapter;\n\nconst registry = new Map<string, AdapterFactory>();\n\nexport function registerAdapter(kind: string, factory: AdapterFactory): void {\n registry.set(kind, factory);\n}\n\nexport function adapterKinds(): string[] {\n return [...registry.keys()];\n}\n\nexport function createAdapter(config: { adapter?: string } & Record<string, any>): Adapter {\n const kind = config.adapter ?? '';\n const factory = registry.get(kind);\n if (!factory) {\n const known = adapterKinds().join(' | ') || 'none registered';\n throw new Error(`app-sdk: unknown adapter '${kind}' (${known})`);\n }\n return factory(config);\n}\n\nregisterAdapter('mock', (c) => createMockAdapter(c.seed));\nregisterAdapter('remote', (c) => createRemoteAdapter(c as { endpoint: string }));\nregisterAdapter('runtime', (c) => createRuntimeAdapter(c));\n\nexport { createMockAdapter, createRemoteAdapter, createRuntimeAdapter, applyDefaults };\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","import type { Adapter, Entity, Op, Query, Row, Page } from './types.js';\nimport { createAdapter } from './adapters/index.js';\nimport { assertUpdatable } from './patch.js';\n\n/** manifest `permissions` access → entity client methods. */\nconst ACCESS_TO_OPS: Record<string, Op[]> = {\n read: ['list', 'get'],\n create: ['create'],\n update: ['update'],\n delete: ['delete'],\n};\n\n/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */\nexport function opsFromAccess(access: string[] = []): Set<Op> {\n const ops = new Set<Op>();\n for (const a of access) (ACCESS_TO_OPS[a] ?? []).forEach((o) => ops.add(o));\n return ops;\n}\n\n/** The methods exposed for a single entity; absent ops throw at call time. */\nexport interface EntityClient<T extends Row = Row, Create extends Row = T> {\n list(query?: Query<T>): Promise<T[]>;\n /** Like `list`, but also returns the total count of matching rows (for pagination). */\n page(query?: Query<T>): Promise<Page<T>>;\n get(id: string | number): Promise<T | null>;\n create(data: Create): Promise<T>;\n update(id: string | number, patch: Partial<Create>): Promise<T>;\n delete(id: string | number): Promise<void>;\n}\n\nfunction entityClient(adapter: Adapter, entity: Entity): EntityClient {\n const ops = entity.ops instanceof Set ? entity.ops : new Set<Op>(entity.ops ?? ['list', 'get', 'create', 'update', 'delete']);\n const guard = <F extends (...args: never[]) => unknown>(op: Op, fn: F): F =>\n (ops.has(op)\n ? fn\n : (() => {\n throw new Error(\n `${entity.name}.${op}() is not permitted — add the matching access to manifest.permissions for '${entity.name}'`,\n );\n }) as unknown as F);\n\n return {\n list: guard('list', (query?: Query) => adapter.list(entity, query ?? {})),\n page: guard('list', (query?: Query) => {\n if (!adapter.page) {\n throw new Error(`${entity.name}.page() is not supported by the '${adapter.kind}' adapter`);\n }\n return adapter.page(entity, query ?? {});\n }),\n get: guard('get', (id: string | number) => adapter.get(entity, id)),\n create: guard('create', (data: Row) => adapter.create(entity, data)),\n // A patch with no fields is a malformed request, not a write: PostgREST\n // performs no update and returns no row, which used to leave the App\n // serialising `undefined` and answering 500 (see ./patch.ts). Rejected here\n // rather than in `mountCrud` so every App gets it — hand-written PUT\n // handlers that call `update()` directly were the ones that broke.\n //\n // `async` on purpose: a rejected promise, not a synchronous throw, so a bad\n // patch is handled like any other data-plane failure (`await` / `.catch()`)\n // and the declared `Promise<T>` stays honest.\n update: guard('update', async (id: string | number, patch: Row) => {\n assertUpdatable(patch);\n return adapter.update(entity, id, patch);\n }),\n delete: guard('delete', (id: string | number) => adapter.remove(entity, id)),\n } as EntityClient;\n}\n\nexport interface ClientConfig {\n adapter: string;\n entities: Record<string, Omit<Entity, 'name'>>;\n [key: string]: unknown;\n}\n\nexport type Client = Record<string, EntityClient> & { readonly __adapter: string };\n\n/**\n * Build a typed entity client.\n * local dev : createClient({ adapter: 'mock', entities, seed })\n * dev tenant: createClient({ adapter: 'remote', entities, endpoint, token, tenant })\n * production: createClient({ adapter: 'runtime', entities, context }) // in the function\n */\nexport function createClient(config: ClientConfig): Client {\n if (!config?.entities) throw new Error('app-sdk: createClient needs { adapter, entities }');\n const adapter = createAdapter(config);\n const db = Object.create({ __adapter: adapter.kind }) as Client;\n for (const [name, def] of Object.entries(config.entities)) {\n db[name] = entityClient(adapter, { name, ...def });\n }\n return db;\n}\n","/**\n * App settings — the tenant's configuration for THIS app, read at runtime.\n *\n * An App declares its settings in `settings.json` (`{ settings: { <key>:\n * { type, scope, default, sensitive, ... } } }`). The cockpit renders that\n * schema, Console stores the tenant's chosen values, and the gateway resolves\n * the two into an effective map:\n *\n * GET {gateway}/v1/settings/apps/{app}[?market={code}]\n * -> { app, market, settings: { … }, masked: [ … ] }\n *\n * Resolution happens ON THE GATEWAY, and this reader does not second-guess it.\n * Per key, the gateway applies (api/internal/gateway/settings.go,\n * `resolveSettings`):\n *\n * 1. per-market override — only for settings declared `\"scope\": \"market\"`,\n * and only when `?market=` is sent\n * 2. stored tenant value — the flat value in `settings_values`\n * 3. schema default — the `default` from settings.json\n *\n * Settings flagged `sensitive` are never in `settings`; their keys are listed\n * in `masked` so a caller can tell \"not configured\" from \"not for you\".\n *\n * The `defaults` you pass here are a *fourth*, last-resort layer: they are what\n * the app runs on when the settings service cannot be reached, and they are\n * what types the resolved object. They never override a value the gateway\n * actually resolved — only a `null`/absent one.\n *\n * const settings = createSettings({\n * app: 'orders',\n * defaults: { auto_reserve: true, reservation_minutes: 30 },\n * });\n *\n * app.post('/orders', async (c) => {\n * const s = await settings.get(c); // market taken from the request\n * if (s.auto_reserve) { … }\n * });\n *\n * Or let the router own it — `createApp({ name, settings: { defaults } })`\n * gives every handler `await c.settings()`.\n *\n * Two properties make this safe to call on every request:\n *\n * - it FAILS OPEN. A gateway blip, a missing tenant, a timeout, an app that\n * declares no settings at all: you get the last good values if there are\n * any, otherwise your declared defaults. It never throws and never takes\n * the app down. Availability is the default; switching something off is\n * the deliberate act, and a deliberate act must not be the accident.\n * - it CACHES. Per (tenant, app, market), for a short TTL, with concurrent\n * reads sharing one in-flight request. A warm read is a Map lookup.\n */\n\n/** The platform gateway. Override with REVENEXX_GATEWAY_ENDPOINT. */\nexport const DEFAULT_GATEWAY_ENDPOINT = 'https://api.revenexx.com';\n\n/**\n * How long a resolved settings map stays warm in the process (ms).\n *\n * Settings are configuration, not data: a merchant flips one every few weeks.\n * The gateway keeps its own 30s cache in front of Console and drops it on a\n * NATS invalidation when values change, so this second layer is the only real\n * staleness — a cockpit change takes effect within a minute. That is the right\n * trade against the alternative, which is a gateway round trip on the hot path\n * of every single request.\n *\n * Override per reader (`ttlMs`) or per deployment (REVENEXX_SETTINGS_TTL_MS).\n */\nexport const DEFAULT_SETTINGS_TTL_MS = 60_000;\n\n/**\n * How long a FAILED read stays cached (ms). Short, because the failure is\n * usually transient and we want to recover quickly — but not zero, or an\n * unreachable gateway would put a doomed round trip on every request, which is\n * exactly the outage the fail-open is supposed to absorb.\n *\n * A 404 (\"app not installed or declares no settings\") is not a failure but a\n * stable answer, and is cached for the full TTL.\n */\nexport const DEFAULT_SETTINGS_ERROR_TTL_MS = 5_000;\n\n/** Request timeout (ms). A hung settings service must not hang the app. */\nexport const DEFAULT_SETTINGS_TIMEOUT_MS = 2_000;\n\nexport type SettingsDefaults = Record<string, unknown>;\n\n/**\n * The resolved map. Keys you declared in `defaults` keep their type; anything\n * else the manifest declares is still there, as `unknown`.\n */\nexport type ResolvedSettings<D extends SettingsDefaults = SettingsDefaults> = D & Record<string, unknown>;\n\n/**\n * Anything a request's tenant/token/market can be read from: the router's\n * `RouteContext`, the raw function context (`{ req: { headers } }`), or a bare\n * headers object.\n */\nexport interface SettingsSource {\n header?(name: string): string;\n tenant?: string | null;\n contextToken?: string;\n req?: { headers?: Record<string, string> | undefined } | undefined;\n headers?: Record<string, string> | undefined;\n}\n\nexport interface SettingsOptions<D extends SettingsDefaults = SettingsDefaults> {\n /**\n * The app whose settings to read. Defaults to REVENEXX_APP_NAME, which the\n * runtime sets — a deployed app usually needs no value here. `createApp`\n * passes its own `name`.\n */\n app?: string;\n /**\n * Last-resort values, and the type source. Use the same defaults your\n * settings.json declares: they are what the app runs on if the settings\n * service is unreachable.\n */\n defaults?: D;\n /** Gateway base URL. Default: REVENEXX_GATEWAY_ENDPOINT or the platform gateway. */\n endpoint?: string;\n /** Cache TTL in ms. Default: REVENEXX_SETTINGS_TTL_MS or 60_000. */\n ttlMs?: number;\n /** How long a failed read is cached, in ms. Default 5_000. */\n errorTtlMs?: number;\n /** Per-request timeout in ms. Default 2_000. */\n timeoutMs?: number;\n /** Environment to read from (tests). Default `process.env`. */\n env?: Record<string, string | undefined>;\n /** Fetch implementation (tests). Default `globalThis.fetch`. */\n fetchImpl?: typeof fetch;\n /**\n * Called when a read fails and the app falls back. Wire it to the function's\n * `error()` so a silent fallback is still visible. Must not throw.\n */\n onError?: (error: Error, info: { app: string; tenant: string; market: string | null }) => void;\n}\n\n/** A resolved read, with the provenance a caller occasionally needs. */\nexport interface SettingsSnapshot<D extends SettingsDefaults = SettingsDefaults> {\n app: string;\n tenant: string;\n /** The market the values were resolved for, or null for the tenant baseline. */\n market: string | null;\n settings: ResolvedSettings<D>;\n /** Keys that exist but are `sensitive`, so their values were withheld. */\n masked: string[];\n /** true when these values came from the gateway (fresh or cached). */\n resolved: boolean;\n /** Why the fallback happened, when `resolved` is false. */\n error?: string;\n}\n\nexport interface ReadOptions {\n /** Resolve for this market instead of the one on the request. `''` = tenant baseline. */\n market?: string;\n}\n\nexport interface SettingsReader<D extends SettingsDefaults = SettingsDefaults> {\n /** The effective settings for this request. Never throws. */\n get(source?: SettingsSource, options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n load(source?: SettingsSource, options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n /** Drop the cache (tests, or right after writing settings). */\n clear(): void;\n}\n\ninterface Entry<D extends SettingsDefaults> {\n at: number;\n ttl: number;\n promise: Promise<SettingsSnapshot<D>>;\n}\n\ninterface GatewayResponse {\n settings?: Record<string, unknown>;\n masked?: unknown;\n}\n\n/** Case-insensitive header read across the three shapes we accept. */\nfunction headerOf(source: SettingsSource | undefined, name: string): string {\n if (!source) return '';\n if (typeof source.header === 'function') {\n const v = source.header(name);\n if (typeof v === 'string' && v !== '') return v;\n }\n const bags = [source.req?.headers, source.headers];\n const want = name.toLowerCase();\n for (const bag of bags) {\n if (!bag) continue;\n const direct = bag[name] ?? bag[want];\n if (typeof direct === 'string' && direct !== '') return direct;\n for (const [k, v] of Object.entries(bag)) {\n if (k.toLowerCase() === want && typeof v === 'string' && v !== '') return v;\n }\n }\n return '';\n}\n\n/**\n * Merge the gateway's resolved map over the declared defaults.\n *\n * A `null` from the gateway does NOT clobber a default: a setting the merchant\n * never touched and whose schema carries no default resolves to `null`, and a\n * caller should not have to null-check a key it declared a default for. A real\n * stored value — including `false`, `0` and `''` — always wins.\n */\nfunction mergeSettings<D extends SettingsDefaults>(\n defaults: D | undefined,\n resolved: Record<string, unknown> | undefined,\n): ResolvedSettings<D> {\n const out: Record<string, unknown> = { ...(defaults ?? {}) };\n for (const [key, value] of Object.entries(resolved ?? {})) {\n if (value !== null && value !== undefined) out[key] = value;\n else if (!(key in out)) out[key] = value ?? null;\n }\n return out as ResolvedSettings<D>;\n}\n\nfunction timeoutSignal(ms: number): AbortSignal | undefined {\n const factory = (AbortSignal as { timeout?: (ms: number) => AbortSignal }).timeout;\n if (typeof factory === 'function') return factory(ms);\n if (typeof AbortController !== 'function') return undefined;\n const controller = new AbortController();\n setTimeout(() => controller.abort(), ms).unref?.();\n return controller.signal;\n}\n\n/**\n * Build a settings reader for one app. Create it once at module scope — the\n * cache lives on the reader, and a per-request reader would cache nothing.\n */\nexport function createSettings<D extends SettingsDefaults = SettingsDefaults>(\n options: SettingsOptions<D> = {},\n): SettingsReader<D> {\n const env = options.env ?? process.env;\n const defaults = options.defaults;\n const ttlMs = options.ttlMs ?? Number(env.REVENEXX_SETTINGS_TTL_MS ?? DEFAULT_SETTINGS_TTL_MS);\n const errorTtlMs = options.errorTtlMs ?? DEFAULT_SETTINGS_ERROR_TTL_MS;\n const timeoutMs = options.timeoutMs ?? DEFAULT_SETTINGS_TIMEOUT_MS;\n const endpoint = String(options.endpoint || env.REVENEXX_GATEWAY_ENDPOINT || DEFAULT_GATEWAY_ENDPOINT).replace(\n /\\/+$/,\n '',\n );\n\n const cache = new Map<string, Entry<D>>();\n /** Last successful snapshot per key — served instead of defaults on a blip. */\n const lastGood = new Map<string, SettingsSnapshot<D>>();\n\n const appName = (): string => String(options.app || env.REVENEXX_APP_NAME || '').trim();\n\n const fallback = (app: string, tenant: string, market: string | null, error: string): SettingsSnapshot<D> => ({\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, undefined),\n masked: [],\n resolved: false,\n error,\n });\n\n const report = (err: Error, info: { app: string; tenant: string; market: string | null }): void => {\n try {\n options.onError?.(err, info);\n } catch {\n /* an error reporter must never be the reason a request fails */\n }\n };\n\n async function request(app: string, tenant: string, token: string, market: string | null): Promise<SettingsSnapshot<D>> {\n const f = options.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') throw new Error('settings: no fetch available (Node >=18 or pass fetchImpl)');\n\n const qs = market ? `?market=${encodeURIComponent(market)}` : '';\n const headers: Record<string, string> = { Accept: 'application/json', 'X-Revenexx-Tenant': tenant };\n if (token) headers.Authorization = `Bearer ${token}`;\n\n const signal = timeoutSignal(timeoutMs);\n const res = await f(`${endpoint}/v1/settings/apps/${encodeURIComponent(app)}${qs}`, {\n method: 'GET',\n headers,\n ...(signal ? { signal } : {}),\n });\n const text = await res.text();\n if (!res.ok) {\n const err = new Error(`settings: ${res.status} for ${app}`) as Error & { status?: number };\n err.status = res.status;\n throw err;\n }\n const body = (text ? JSON.parse(text) : {}) as GatewayResponse;\n return {\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, body.settings),\n masked: Array.isArray(body.masked) ? body.masked.filter((k): k is string => typeof k === 'string') : [],\n resolved: true,\n };\n }\n\n async function load(source?: SettingsSource, readOptions: ReadOptions = {}): Promise<SettingsSnapshot<D>> {\n const app = appName();\n const tenant = (source?.tenant ?? '') || headerOf(source, 'x-revenexx-tenant');\n const market = (readOptions.market ?? headerOf(source, 'x-revenexx-market')).trim() || null;\n\n // Nothing to ask with — answer from the defaults without a round trip.\n if (!app) return fallback('', tenant, market, 'no app name (pass `app` or set REVENEXX_APP_NAME)');\n if (!tenant) return fallback(app, '', market, 'no tenant on the request');\n\n const key = `${tenant}\u0000${app}\u0000${market ?? ''}`;\n const now = Date.now();\n const hit = cache.get(key);\n if (hit && now - hit.at < hit.ttl) return hit.promise;\n\n const token = (source?.contextToken ?? '') || headerOf(source, 'x-revenexx-context');\n const entry: Entry<D> = { at: now, ttl: ttlMs, promise: undefined as unknown as Promise<SettingsSnapshot<D>> };\n entry.promise = request(app, tenant, token, market)\n .then((snapshot) => {\n lastGood.set(key, snapshot);\n return snapshot;\n })\n .catch((err: unknown) => {\n const error = err instanceof Error ? err : new Error(String(err));\n // A 404 is the gateway saying \"this app is not installed, or declares\n // no settings\" — a stable answer, not a blip. Cache it for the full TTL\n // so an app without settings does not re-ask every five seconds.\n const status = (error as { status?: number }).status;\n entry.ttl = status === 404 ? ttlMs : errorTtlMs;\n report(error, { app, tenant, market });\n // Prefer the last values we genuinely resolved over the defaults: they\n // are the tenant's actual configuration, and a gateway blip is no\n // reason to silently revert a merchant's choices.\n const stale = lastGood.get(key);\n if (stale) return { ...stale, resolved: false, error: error.message };\n return fallback(app, tenant, market, error.message);\n });\n\n // Cached before it settles, so concurrent requests share one fetch.\n cache.set(key, entry);\n return entry.promise;\n }\n\n return {\n load,\n async get(source?: SettingsSource, readOptions?: ReadOptions): Promise<ResolvedSettings<D>> {\n return (await load(source, readOptions)).settings;\n },\n clear(): void {\n cache.clear();\n lastGood.clear();\n },\n };\n}\n"],"mappings":"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","names":[]}
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/adapters/mock.ts","../src/errors.ts","../src/query.ts","../src/adapters/postgrest-error.ts","../src/adapters/remote.ts","../src/adapters/runtime.ts","../src/adapters/index.ts","../src/patch.ts","../src/client.ts","../src/settings.ts"],"sourcesContent":["/**\n * @revenexx/app-sdk — typed PostgREST data client for revenexx Apps.\n *\n * The generated per-App client (see `revenexx apps generate`) wraps `createClient`\n * with strongly-typed entity interfaces. You can also use this runtime directly.\n */\n\nexport { createClient, opsFromAccess } from './client.js';\nexport type { Client, ClientConfig, EntityClient } from './client.js';\n\nexport { toParams, matches } from './query.js';\n\n// App settings: the tenant's configuration for this app, resolved by the\n// gateway (market override → tenant value → schema default) and cached.\n// Also re-exported from `@revenexx/app-sdk/router`, where `createApp` can own\n// the reader for you (`c.settings()`).\nexport {\n createSettings,\n DEFAULT_GATEWAY_ENDPOINT,\n DEFAULT_SETTINGS_TTL_MS,\n DEFAULT_SETTINGS_ERROR_TTL_MS,\n DEFAULT_SETTINGS_TIMEOUT_MS,\n} from './settings.js';\nexport type {\n SettingsReader,\n SettingsOptions,\n SettingsSnapshot,\n SettingsSource,\n SettingsDefaults,\n ResolvedSettings,\n ReadOptions,\n} from './settings.js';\n\n// The data client raises HttpError for mapped data-plane failures (a duplicate\n// key is a 409, not a 500). `@revenexx/app-sdk/router` turns it into the HTTP\n// response; catch it directly when you are not using the router. Use\n// `isHttpError`, not `instanceof` — the two entrypoints are separate bundles.\nexport { HttpError, isHttpError } from './errors.js';\nexport type { HttpErrorOptions } from './errors.js';\n\nexport {\n registerAdapter,\n createAdapter,\n adapterKinds,\n createMockAdapter,\n createRemoteAdapter,\n createRuntimeAdapter,\n applyDefaults,\n} from './adapters/index.js';\nexport type { AdapterFactory } from './adapters/index.js';\nexport type { RemoteConfig } from './adapters/remote.js';\nexport type { RuntimeConfig } from './adapters/runtime.js';\nexport { DEFAULT_DATA_ENDPOINT } from './adapters/runtime.js';\n\nexport type {\n Adapter,\n Entity,\n ColumnDef,\n Op,\n Query,\n Filter,\n FilterOp,\n Scalar,\n Row,\n Page,\n} from './types.js';\n","import { randomUUID } from 'node:crypto';\nimport type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { notFound } from '../errors.js';\nimport { matches } from '../query.js';\n\n/** Apply order → offset → limit → select to an already-filtered row set. */\nfunction shape(rows: Row[], query: Query): Row[] {\n let out = rows;\n if (query.order) {\n const [c, dir = 'asc'] = query.order.split('.');\n const key = c as string;\n out = out.slice().sort((a, b) => (a[key]! < b[key]! ? -1 : a[key]! > b[key]! ? 1 : 0));\n if (dir === 'desc') out.reverse();\n }\n if (query.offset) out = out.slice(query.offset);\n if (Number.isInteger(query.limit)) out = out.slice(0, query.limit);\n if (Array.isArray(query.select) && query.select.length) {\n const cols = query.select as string[];\n out = out.map((r) => Object.fromEntries(cols.map((c) => [c, r[c]])));\n }\n return out.map((r) => ({ ...r }));\n}\n\n/** Best-effort apply of schema.json column defaults for the mock adapter. */\nexport function applyDefaults(entity: Entity, data: Row): Row {\n const row: Row = { ...data };\n for (const [col, def] of Object.entries(entity.columns ?? {})) {\n if (row[col] !== undefined || def == null) continue;\n const d = def.default;\n if (d == null) continue;\n if (/gen_random_uuid/i.test(d)) row[col] = randomUUID();\n else if (/now\\(\\)|current_timestamp/i.test(d)) row[col] = new Date().toISOString();\n else {\n const m = /^'(.*)'$/.exec(String(d).trim());\n if (m) row[col] = m[1];\n }\n }\n return row;\n}\n\n/**\n * In-memory adapter. Zero infrastructure: develop + unit-test App logic against\n * fixtures. Does NOT enforce RLS, constraints, triggers or PostgREST semantics —\n * run the `remote` adapter against a dev tenant for that fidelity before deploy.\n */\nexport function createMockAdapter(seed: Record<string, Row[]> = {}): Adapter {\n const store = new Map<string, Map<unknown, Row>>();\n const tbl = (entity: Entity): Map<unknown, Row> => {\n let m = store.get(entity.name);\n if (!m) {\n m = new Map();\n for (const r of seed[entity.name] ?? []) m.set(r[entity.pk], { ...r });\n store.set(entity.name, m);\n }\n return m;\n };\n\n return {\n kind: 'mock',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return shape(filtered, query);\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return { items: shape(filtered, query), total: filtered.length, limit: query.limit, offset: query.offset };\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const r = tbl(entity).get(id);\n return r ? { ...r } : null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const row = applyDefaults(entity, data);\n if (row[entity.pk] === undefined) row[entity.pk] = randomUUID();\n tbl(entity).set(row[entity.pk], row);\n return { ...row };\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const cur = tbl(entity).get(id);\n // Same answer the remote adapter gives for a patch that matched no row —\n // a 404, not a 500. The message is unchanged so existing App tests that\n // assert on it keep passing.\n if (!cur) throw notFound(`mock: ${entity.name}/${String(id)} not found`);\n const row: Row = { ...cur, ...patch };\n if (entity.columns?.updated_at) row.updated_at = new Date().toISOString();\n tbl(entity).set(id, row);\n return { ...row };\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n tbl(entity).delete(id);\n },\n };\n}\n","/**\n * The one error representation every layer of the SDK agrees on.\n *\n * `HttpError` used to live in `./router/router.ts`. It moved here so the data\n * adapters can raise it too: an adapter that knows a PostgREST failure is a\n * duplicate key can say \"409\" without the router having to guess from a\n * message string.\n *\n * Two fields exist purely to keep internal database detail out of responses:\n * - `message` / `details` are the *client-facing* payload — always safe,\n * never derived from a database error body.\n * - `serverDetail` is the raw diagnosis. The router logs it and drops it; it\n * is never serialised into a response.\n */\n\nexport interface HttpErrorOptions {\n /** Stable machine-readable code (e.g. `unique_violation`). Safe to expose. */\n code?: string;\n /**\n * Raw diagnosis for server-side logs and traces only — may contain table and\n * constraint names. Never included in the HTTP response.\n */\n serverDetail?: unknown;\n}\n\n/** Throw inside a handler (or an adapter) to answer with a specific HTTP status. */\nexport class HttpError extends Error {\n readonly status: number;\n readonly details?: unknown;\n readonly code?: string;\n readonly serverDetail?: unknown;\n /**\n * Structural marker. `dist/index.cjs` and `dist/router/index.cjs` are separate\n * bundles, so an error thrown by the data client and caught by the router is\n * an instance of a *different* copy of this class — `instanceof` would be\n * false. Everything checks this flag via `isHttpError` instead.\n */\n readonly __isHttpError = true as const;\n\n constructor(status: number, message: string, details?: unknown, options: HttpErrorOptions = {}) {\n super(message);\n this.name = 'HttpError';\n this.status = status;\n if (details !== undefined) this.details = details;\n if (options.code !== undefined) this.code = options.code;\n if (options.serverDetail !== undefined) this.serverDetail = options.serverDetail;\n }\n}\n\n/** Duck-typed `instanceof HttpError` — survives the bundle split (see above). */\nexport function isHttpError(err: unknown): err is HttpError {\n if (!err || typeof err !== 'object') return false;\n const e = err as { __isHttpError?: unknown; name?: unknown; status?: unknown };\n return e.__isHttpError === true || (e.name === 'HttpError' && typeof e.status === 'number');\n}\n\nexport const notFound = (message = 'not found'): HttpError => new HttpError(404, message);\nexport const badRequest = (message = 'bad request', details?: unknown): HttpError =>\n new HttpError(400, message, details);\nexport const forbidden = (message = 'forbidden'): HttpError => new HttpError(403, message);\nexport const conflict = (message = 'conflict'): HttpError => new HttpError(409, message);\n","import type { Query, FilterOp, Row } from './types.js';\n\n/**\n * PostgREST query helpers. `toParams` serialises a query for the HTTP adapters;\n * `matches` applies the same `where` semantics in memory for the mock adapter —\n * keeping one shape means App code is identical across adapters.\n */\n\nconst OPS = new Set<FilterOp>(['eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'like', 'ilike', 'in', 'is']);\n\n/** Serialise a query object to PostgREST URLSearchParams. */\nexport function toParams(query: Query = {}): URLSearchParams {\n const params = new URLSearchParams();\n const { where = {}, select, order, limit, offset } = query;\n\n for (const [col, cond] of Object.entries(where)) {\n if (Array.isArray(cond)) {\n params.append(col, `in.(${cond.join(',')})`);\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!OPS.has(c.op)) throw new Error(`query: unsupported operator '${c.op}'`);\n const v = Array.isArray(c.value) ? `(${c.value.join(',')})` : c.value;\n params.append(col, `${c.op}.${v}`);\n } else {\n params.append(col, `eq.${cond}`);\n }\n }\n\n if (Array.isArray(select) && select.length) params.set('select', (select as string[]).join(','));\n if (order) params.set('order', /\\.(asc|desc)$/.test(order) ? order : `${order}.asc`);\n if (Number.isInteger(limit)) params.set('limit', String(limit));\n if (Number.isInteger(offset)) params.set('offset', String(offset));\n\n return params;\n}\n\n/** In-memory predicate mirroring `toParams`' `where` semantics (mock adapter). */\nexport function matches(row: Row, where: Query['where'] = {}): boolean {\n for (const [col, cond] of Object.entries(where)) {\n const val = row[col];\n if (Array.isArray(cond)) {\n if (!cond.includes(val as never)) return false;\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!compare(val, c.op, c.value)) return false;\n } else if (val !== cond) {\n return false;\n }\n }\n return true;\n}\n\nfunction compare(a: unknown, op: FilterOp, b: unknown): boolean {\n switch (op) {\n case 'eq': return a === b;\n case 'neq': return a !== b;\n case 'gt': return (a as number) > (b as number);\n case 'gte': return (a as number) >= (b as number);\n case 'lt': return (a as number) < (b as number);\n case 'lte': return (a as number) <= (b as number);\n case 'is': return a === b;\n case 'in': return Array.isArray(b) && b.includes(a);\n case 'like':\n case 'ilike': {\n const re = new RegExp(\n '^' + String(b).replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&').replace(/%/g, '.*').replace(/_/g, '.') + '$',\n op === 'ilike' ? 'i' : '',\n );\n return re.test(String(a));\n }\n default: return false;\n }\n}\n","/**\n * PostgREST failure → HTTP answer.\n *\n * PostgREST reports database constraint violations with a JSON body that names\n * the offending table and constraint:\n *\n * {\"code\":\"23505\",\"details\":\"Key (tenant_id, code)=(…) already exists.\",\n * \"message\":\"duplicate key value violates unique constraint\n * \\\"idx__revenexx__channels__channels__tenant_id_code__uniq\\\"\"}\n *\n * Forwarding that verbatim is wrong twice over: an expected condition (a\n * duplicate code) reads as a server outage, and the response leaks the internal\n * schema to every API caller. This module maps the failure to a status the\n * platform's own error contract already understands, with a stable, generic\n * message. The raw body travels on `HttpError.serverDetail`, which the router\n * logs and never serialises.\n *\n * Mapping:\n * 23505 unique_violation → 409 a record with this value already exists\n * 23P01 exclusion_violation → 409 conflicts with an existing record\n * 23503 foreign_key_violation → 400 when the referenced parent is missing\n * → 409 when a dependent row blocks a delete\n * 23502 not_null_violation → 400 a required value is missing\n * 23514 check_violation → 400 value not allowed\n * 22xxx data exception → 400 wrong format (22P02 bad uuid/number …)\n * anything else → PostgREST's own status when it is a client\n * error we recognise, otherwise 500\n *\n * `PGRST103` (offset past the end of the result set) is deliberately *not* an\n * error — see `rangeNotSatisfiable` and the adapter's `list`/`page`.\n */\n\nimport { HttpError } from '../errors.js';\n\n/** The shape PostgREST uses for error bodies. */\ninterface PgErrorBody {\n code?: string;\n message?: string;\n details?: string;\n hint?: string;\n}\n\nfunction parseBody(body: string): PgErrorBody {\n if (!body) return {};\n try {\n const parsed: unknown = JSON.parse(body);\n return parsed && typeof parsed === 'object' ? (parsed as PgErrorBody) : {};\n } catch {\n return {};\n }\n}\n\ninterface Mapped {\n status: number;\n code: string;\n message: string;\n}\n\n/** SQLSTATE → what the caller is allowed to know. */\nconst BY_SQLSTATE: Record<string, Mapped> = {\n '23505': { status: 409, code: 'unique_violation', message: 'a record with this value already exists' },\n '23P01': { status: 409, code: 'exclusion_violation', message: 'a record conflicts with an existing one' },\n '23502': { status: 400, code: 'not_null_violation', message: 'a required value is missing' },\n '23514': { status: 400, code: 'check_violation', message: 'a value is not allowed here' },\n '22P02': { status: 400, code: 'invalid_value', message: 'a value in the request has the wrong format' },\n};\n\n/** Statuses PostgREST returns that already describe the client's mistake. */\nconst CLIENT_STATUS: Record<number, string> = {\n 400: 'the request could not be processed',\n 401: 'unauthenticated',\n 403: 'forbidden',\n 404: 'not found',\n 405: 'method not allowed',\n 406: 'the requested representation is not available',\n 409: 'the request conflicts with the current state of the data',\n 413: 'the request is too large',\n 415: 'unsupported media type',\n 422: 'the request could not be processed',\n 429: 'too many requests',\n};\n\n/**\n * A foreign-key violation is two different bugs depending on direction, and\n * Postgres' own wording distinguishes them reliably (PostgREST forwards it\n * untouched in `details`):\n *\n * write: Key (market_id)=(…) is not present in table \"markets\". → 400\n * delete: Key (id)=(…) is still referenced from table \"locales\". → 409\n *\n * If neither phrase is present (a localised server, or future wording), fall\n * back to the request method: a DELETE can only fail on a dependent row, any\n * other verb can only fail on a missing parent.\n */\nfunction foreignKey(pg: PgErrorBody, method: string): Mapped {\n const blocked: Mapped = {\n status: 409,\n code: 'foreign_key_violation',\n message: 'this record is still referenced by other records',\n };\n const missing: Mapped = {\n status: 400,\n code: 'foreign_key_violation',\n message: 'a referenced record does not exist',\n };\n const text = `${pg.details ?? ''} ${pg.message ?? ''}`;\n if (/is still referenced from/i.test(text)) return blocked;\n if (/is not present in table/i.test(text)) return missing;\n return method.toUpperCase() === 'DELETE' ? blocked : missing;\n}\n\nfunction classify(status: number, pg: PgErrorBody, method: string): Mapped {\n const sqlstate = typeof pg.code === 'string' ? pg.code : '';\n if (sqlstate === '23503') return foreignKey(pg, method);\n const known = BY_SQLSTATE[sqlstate];\n if (known) return known;\n // Class 22 is Postgres' \"data exception\" family — always bad input, never a\n // server fault (22003 numeric out of range, 22007 bad timestamp, 22001 value\n // too long, …).\n if (/^22/.test(sqlstate)) {\n return { status: 400, code: 'invalid_value', message: 'a value in the request has the wrong format' };\n }\n const generic = CLIENT_STATUS[status];\n if (generic) return { status, code: 'bad_request', message: generic };\n return { status: 500, code: 'data_error', message: 'the data service could not complete the request' };\n}\n\n/**\n * Map a non-2xx PostgREST response to an `HttpError` whose message is safe to\n * return. The raw body is preserved on `serverDetail` for logs only.\n */\nexport function postgrestError(status: number, body: string, context: { method: string; table?: string }): HttpError {\n const pg = parseBody(body);\n const mapped = classify(status, pg, context.method);\n return new HttpError(mapped.status, mapped.message, undefined, {\n code: mapped.code,\n serverDetail: {\n source: 'postgrest',\n status,\n method: context.method,\n ...(context.table ? { table: context.table } : {}),\n sqlstate: pg.code ?? null,\n message: pg.message ?? (body || null),\n details: pg.details ?? null,\n hint: pg.hint ?? null,\n },\n });\n}\n\n/**\n * `PGRST103` / HTTP 416: the requested offset is past the end of the result\n * set. That is a legitimate request — the last page of a table someone just\n * emptied — not a failure, so callers answer with an empty page instead of an\n * error. Returns the true row count PostgREST reported, or `null` when the\n * response is a real error.\n */\nexport function rangeNotSatisfiable(status: number, body: string): { total: number } | null {\n if (status !== 416) return null;\n const pg = parseBody(body);\n // PostgREST: \"An offset of 25 was requested, but there are only 3 rows.\"\n const m = /there are only (\\d+) rows/i.exec(`${pg.details ?? ''} ${pg.message ?? ''}`);\n return { total: m ? Number.parseInt(m[1]!, 10) : 0 };\n}\n","import type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { toParams } from '../query.js';\nimport { HttpError, notFound } from '../errors.js';\nimport { postgrestError, rangeNotSatisfiable } from './postgrest-error.js';\n\nexport interface RemoteConfig {\n endpoint: string;\n token?: string;\n tenant?: string;\n /**\n * Active market, forwarded as `X-Revenexx-Market`. Never a security boundary\n * — the tenant is the hard contract (token/RLS).\n *\n * What it does depends entirely on which endpoint the entity points at, and\n * the two effects are not symmetric:\n *\n * - **On INSERT it ASSIGNS.** An `AFTER INSERT` trigger on every scopeable\n * table reads the header and writes a `baseline.entity_scopes` row for the\n * new id. Sending a market here narrows what that row is visible as, for\n * good. Sending none leaves it unassigned, i.e. visible everywhere.\n * - **On SELECT it filters only through a `*_scoped` view.**\n * `baseline.is_visible()` is called from the view body and nowhere else, so\n * a read of the BASE table ignores the header completely.\n *\n * Generated entities target the base table (`vendor__app__entity`), so unless\n * an App overrides `entity.table` with the `_scoped` name, a list returns the\n * same rows with or without a market. Absent is therefore a no-op on reads,\n * not a \"globals only\" default.\n */\n market?: string;\n fetchImpl?: typeof fetch;\n}\n\n/** PostgREST-over-HTTP adapter (production data plane / dev tenant). */\nexport function createRemoteAdapter(config: RemoteConfig): Adapter {\n const f = config.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') {\n throw new Error('remote adapter: no fetch available (Node >=18 or pass fetchImpl)');\n }\n const base = String(config.endpoint ?? '').replace(/\\/$/, '');\n if (!base) throw new Error('remote adapter: endpoint is required');\n\n const headers = (extra?: Record<string, string>): Record<string, string> => {\n const h: Record<string, string> = { 'Content-Type': 'application/json', Accept: 'application/json', ...extra };\n if (config.token) h.Authorization = `Bearer ${config.token}`;\n if (config.tenant) h['X-Revenexx-Tenant'] = config.tenant;\n if (config.market) h['X-Revenexx-Market'] = config.market;\n return h;\n };\n\n interface Sent {\n status: number;\n ok: boolean;\n text: string;\n // Total parsed from the Content-Range header (\"0-9/247\"), when present.\n total: number | null;\n }\n\n interface SendOptions {\n body?: unknown;\n prefer?: string;\n /** Table name — server-side log context only, never returned to a caller. */\n table?: string;\n }\n\n async function send(method: string, path: string, opts: SendOptions = {}): Promise<Sent> {\n const res = await f(`${base}${path}`, {\n method,\n headers: headers(opts.prefer ? { Prefer: opts.prefer } : {}),\n body: opts.body != null ? JSON.stringify(opts.body) : undefined,\n });\n const text = await res.text();\n const range = res.headers?.get?.('content-range') ?? '';\n const total = Number.parseInt(range.split('/')[1] ?? '', 10);\n return { status: res.status, ok: res.ok, text, total: Number.isFinite(total) ? total : null };\n }\n\n async function req(method: string, path: string, opts: SendOptions = {}): Promise<unknown> {\n const { ok, status, text } = await send(method, path, opts);\n // Constraint violations become the status they deserve, with a message that\n // names no table or constraint (see ./postgrest-error).\n if (!ok) throw postgrestError(status, text, { method, table: opts.table });\n return text ? JSON.parse(text) : null;\n }\n\n /**\n * The single row out of a `return=representation` response.\n *\n * PostgREST answers `200 []` — a success — whenever the write touched no row:\n * a `PATCH` whose filter matched nothing, or one whose body carried no\n * columns. `rows[0]` is then `undefined`, and returning it breaks the\n * `Promise<Row>` contract in the worst possible place: the App hands it to\n * `res.json()`, `JSON.stringify(undefined)` is `undefined`, and the runtime's\n * `Buffer.from(undefined)` raises a Node type error that surfaces to the\n * caller as a 500. Nothing downstream can recover from that, so the absence\n * is reported here, as an answer the caller can act on.\n */\n const oneRow = (rows: unknown, onMissing: () => HttpError): Row => {\n const row = Array.isArray(rows) ? (rows[0] as Row | undefined) : (rows as Row | null);\n if (row == null) throw onMissing();\n return row;\n };\n\n return {\n kind: 'remote',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const qs = toParams(query).toString();\n const { ok, status, text } = await send('GET', `/${entity.table}${qs ? `?${qs}` : ''}`, {\n table: entity.table,\n });\n if (!ok) {\n // An offset past the end of the result set is a legitimate request, not\n // a failure — answer with no rows (see ./postgrest-error).\n if (rangeNotSatisfiable(status, text)) return [];\n throw postgrestError(status, text, { method: 'GET', table: entity.table });\n }\n return (text ? (JSON.parse(text) as Row[]) : []) ?? [];\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const rows = (await req('GET', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}&limit=1`, {\n table: entity.table,\n })) as Row[];\n return rows?.[0] ?? null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const rows = await req('POST', `/${entity.table}`, {\n body: data,\n prefer: 'return=representation',\n table: entity.table,\n });\n // An insert that reports success but returns no row means the row is not\n // readable back (an RLS policy that permits INSERT but not SELECT). That\n // is a server-side condition, so it keeps a 5xx — but a described one.\n return oneRow(\n rows,\n () =>\n new HttpError(500, 'the record was created but could not be read back', undefined, {\n code: 'empty_representation',\n serverDetail: { source: 'postgrest', method: 'POST', table: entity.table },\n }),\n );\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const rows = await req('PATCH', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {\n body: patch,\n prefer: 'return=representation',\n table: entity.table,\n });\n // No row came back for a patch that carried fields: the row is gone or\n // invisible to this tenant (deleted between the read and the write, or\n // filtered by RLS). Both are a 404 to the caller. An empty patch never\n // reaches here — the client rejects it with a 400 first (see ../patch.ts).\n return oneRow(rows, () => notFound());\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n await req('DELETE', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {\n table: entity.table,\n });\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n // One request: PostgREST returns the page in the body and the total in\n // Content-Range (\"0-9/247\" or \"*/247\") when asked for an exact count.\n const qs = toParams(query).toString();\n const { ok, status, text, total } = await send('GET', `/${entity.table}${qs ? `?${qs}` : ''}`, {\n prefer: 'count=exact',\n table: entity.table,\n });\n if (!ok) {\n // Paging past the end of the result set is a legitimate request — the\n // last page of a list someone just emptied. Answer with an empty page\n // carrying the requested bounds and the true total, not an error.\n const overflow = rangeNotSatisfiable(status, text);\n if (overflow) {\n return { items: [], total: total ?? overflow.total, limit: query.limit, offset: query.offset };\n }\n throw postgrestError(status, text, { method: 'GET', table: entity.table });\n }\n const items = (text ? JSON.parse(text) : []) as Row[];\n return {\n items,\n total: total ?? items.length,\n limit: query.limit,\n offset: query.offset,\n };\n },\n };\n}\n","import type { Adapter } from '../types.js';\nimport { createRemoteAdapter } from './remote.js';\n\ninterface FunctionContext {\n req?: { headers?: Record<string, string> };\n}\n\nexport interface RuntimeConfig {\n context?: FunctionContext;\n env?: Record<string, string | undefined>;\n}\n\n/** The platform data plane. Override with REVENEXX_DATA_ENDPOINT when needed. */\nexport const DEFAULT_DATA_ENDPOINT = 'https://apps.api.revenexx.com';\n\n/**\n * Production adapter: a `remote` adapter auto-configured from the function's\n * per-invocation context. Token = the brokered identity forwarded as\n * `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env, falling\n * back to the platform data plane — deployed apps work with zero configuration.\n * App code stays identical — only the adapter selection differs between local\n * and prod.\n */\nexport function createRuntimeAdapter(config: RuntimeConfig = {}): Adapter {\n const env = config.env ?? process.env;\n const h = config.context?.req?.headers ?? {};\n const get = (name: string): string => h[name] ?? h[name.toLowerCase()] ?? '';\n\n const remote = createRemoteAdapter({\n endpoint: env.REVENEXX_DATA_ENDPOINT || DEFAULT_DATA_ENDPOINT,\n token: get('x-revenexx-context') || env.REVENEXX_CONTEXT || '',\n tenant: get('x-revenexx-tenant') || env.REVENEXX_TENANT || '',\n // Active market forwarded to the data layer. It ASSIGNS the market on\n // insert and filters reads only through a `*_scoped` view — generated\n // entities read the base table, so on the app path a list is unaffected by\n // it. See RemoteConfig.market; absent is a no-op on reads, not a narrower\n // default.\n market: get('x-revenexx-market') || env.REVENEXX_MARKET || '',\n });\n\n return { ...remote, kind: 'runtime' };\n}\n","import type { Adapter } from '../types.js';\nimport { createMockAdapter, applyDefaults } from './mock.js';\nimport { createRemoteAdapter } from './remote.js';\nimport { createRuntimeAdapter } from './runtime.js';\n\n/**\n * Adapter registry. Built-ins (mock | remote | runtime) are registered below;\n * add a new backend by calling `registerAdapter('my-kind', (config) => …)`\n * before constructing the client — no changes to the client or generated code.\n */\nexport type AdapterFactory = (config: Record<string, any>) => Adapter;\n\nconst registry = new Map<string, AdapterFactory>();\n\nexport function registerAdapter(kind: string, factory: AdapterFactory): void {\n registry.set(kind, factory);\n}\n\nexport function adapterKinds(): string[] {\n return [...registry.keys()];\n}\n\nexport function createAdapter(config: { adapter?: string } & Record<string, any>): Adapter {\n const kind = config.adapter ?? '';\n const factory = registry.get(kind);\n if (!factory) {\n const known = adapterKinds().join(' | ') || 'none registered';\n throw new Error(`app-sdk: unknown adapter '${kind}' (${known})`);\n }\n return factory(config);\n}\n\nregisterAdapter('mock', (c) => createMockAdapter(c.seed));\nregisterAdapter('remote', (c) => createRemoteAdapter(c as { endpoint: string }));\nregisterAdapter('runtime', (c) => createRuntimeAdapter(c));\n\nexport { createMockAdapter, createRemoteAdapter, createRuntimeAdapter, applyDefaults };\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","import type { Adapter, Entity, Op, Query, Row, Page } from './types.js';\nimport { createAdapter } from './adapters/index.js';\nimport { assertUpdatable } from './patch.js';\n\n/** manifest `permissions` access → entity client methods. */\nconst ACCESS_TO_OPS: Record<string, Op[]> = {\n read: ['list', 'get'],\n create: ['create'],\n update: ['update'],\n delete: ['delete'],\n};\n\n/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */\nexport function opsFromAccess(access: string[] = []): Set<Op> {\n const ops = new Set<Op>();\n for (const a of access) (ACCESS_TO_OPS[a] ?? []).forEach((o) => ops.add(o));\n return ops;\n}\n\n/** The methods exposed for a single entity; absent ops throw at call time. */\nexport interface EntityClient<T extends Row = Row, Create extends Row = T> {\n list(query?: Query<T>): Promise<T[]>;\n /** Like `list`, but also returns the total count of matching rows (for pagination). */\n page(query?: Query<T>): Promise<Page<T>>;\n get(id: string | number): Promise<T | null>;\n create(data: Create): Promise<T>;\n update(id: string | number, patch: Partial<Create>): Promise<T>;\n delete(id: string | number): Promise<void>;\n}\n\nfunction entityClient(adapter: Adapter, entity: Entity): EntityClient {\n const ops = entity.ops instanceof Set ? entity.ops : new Set<Op>(entity.ops ?? ['list', 'get', 'create', 'update', 'delete']);\n const guard = <F extends (...args: never[]) => unknown>(op: Op, fn: F): F =>\n (ops.has(op)\n ? fn\n : (() => {\n throw new Error(\n `${entity.name}.${op}() is not permitted — add the matching access to manifest.permissions for '${entity.name}'`,\n );\n }) as unknown as F);\n\n return {\n list: guard('list', (query?: Query) => adapter.list(entity, query ?? {})),\n page: guard('list', (query?: Query) => {\n if (!adapter.page) {\n throw new Error(`${entity.name}.page() is not supported by the '${adapter.kind}' adapter`);\n }\n return adapter.page(entity, query ?? {});\n }),\n get: guard('get', (id: string | number) => adapter.get(entity, id)),\n create: guard('create', (data: Row) => adapter.create(entity, data)),\n // A patch with no fields is a malformed request, not a write: PostgREST\n // performs no update and returns no row, which used to leave the App\n // serialising `undefined` and answering 500 (see ./patch.ts). Rejected here\n // rather than in `mountCrud` so every App gets it — hand-written PUT\n // handlers that call `update()` directly were the ones that broke.\n //\n // `async` on purpose: a rejected promise, not a synchronous throw, so a bad\n // patch is handled like any other data-plane failure (`await` / `.catch()`)\n // and the declared `Promise<T>` stays honest.\n update: guard('update', async (id: string | number, patch: Row) => {\n assertUpdatable(patch);\n return adapter.update(entity, id, patch);\n }),\n delete: guard('delete', (id: string | number) => adapter.remove(entity, id)),\n } as EntityClient;\n}\n\nexport interface ClientConfig {\n adapter: string;\n entities: Record<string, Omit<Entity, 'name'>>;\n [key: string]: unknown;\n}\n\nexport type Client = Record<string, EntityClient> & { readonly __adapter: string };\n\n/**\n * Build a typed entity client.\n * local dev : createClient({ adapter: 'mock', entities, seed })\n * dev tenant: createClient({ adapter: 'remote', entities, endpoint, token, tenant })\n * production: createClient({ adapter: 'runtime', entities, context }) // in the function\n */\nexport function createClient(config: ClientConfig): Client {\n if (!config?.entities) throw new Error('app-sdk: createClient needs { adapter, entities }');\n const adapter = createAdapter(config);\n const db = Object.create({ __adapter: adapter.kind }) as Client;\n for (const [name, def] of Object.entries(config.entities)) {\n db[name] = entityClient(adapter, { name, ...def });\n }\n return db;\n}\n","/**\n * App settings — the tenant's configuration for THIS app, read at runtime.\n *\n * An App declares its settings in `settings.json` (`{ settings: { <key>:\n * { type, scope, default, sensitive, ... } } }`). The cockpit renders that\n * schema, Console stores the tenant's chosen values, and the gateway resolves\n * the two into an effective map:\n *\n * GET {gateway}/v1/settings/apps/{app}[?market={code}]\n * -> { app, market, settings: { … }, masked: [ … ] }\n *\n * Resolution happens ON THE GATEWAY, and this reader does not second-guess it.\n * Per key, the gateway applies (api/internal/gateway/settings.go,\n * `resolveSettings`):\n *\n * 1. per-market override — only for settings declared `\"scope\": \"market\"`,\n * and only when `?market=` is sent\n * 2. stored tenant value — the flat value in `settings_values`\n * 3. schema default — the `default` from settings.json\n *\n * Settings flagged `sensitive` are never in `settings`; their keys are listed\n * in `masked` so a caller can tell \"not configured\" from \"not for you\".\n *\n * The `defaults` you pass here are a *fourth*, last-resort layer: they are what\n * the app runs on when the settings service cannot be reached, and they are\n * what types the resolved object. They never override a value the gateway\n * actually resolved — only a `null`/absent one.\n *\n * const settings = createSettings({\n * app: 'orders',\n * defaults: { auto_reserve: true, reservation_minutes: 30 },\n * });\n *\n * app.post('/orders', async (c) => {\n * const s = await settings.get(c); // market taken from the request\n * if (s.auto_reserve) { … }\n * });\n *\n * Or let the router own it — `createApp({ name, settings: { defaults } })`\n * gives every handler `await c.settings()`.\n *\n * Two properties make this safe to call on every request:\n *\n * - it FAILS OPEN. A gateway blip, a missing tenant, a timeout, an app that\n * declares no settings at all: you get the last good values if there are\n * any, otherwise your declared defaults. It never throws and never takes\n * the app down. Availability is the default; switching something off is\n * the deliberate act, and a deliberate act must not be the accident.\n * - it CACHES. Per (tenant, app, market), for a short TTL, with concurrent\n * reads sharing one in-flight request. A warm read is a Map lookup.\n */\n\n/** The platform gateway. Override with REVENEXX_GATEWAY_ENDPOINT. */\nexport const DEFAULT_GATEWAY_ENDPOINT = 'https://api.revenexx.com';\n\n/**\n * How long a resolved settings map stays warm in the process (ms).\n *\n * Settings are configuration, not data: a merchant flips one every few weeks.\n * The gateway keeps its own 30s cache in front of Console and drops it on a\n * NATS invalidation when values change, so this second layer is the only real\n * staleness — a cockpit change takes effect within a minute. That is the right\n * trade against the alternative, which is a gateway round trip on the hot path\n * of every single request.\n *\n * Override per reader (`ttlMs`) or per deployment (REVENEXX_SETTINGS_TTL_MS).\n */\nexport const DEFAULT_SETTINGS_TTL_MS = 60_000;\n\n/**\n * How long a FAILED read stays cached (ms). Short, because the failure is\n * usually transient and we want to recover quickly — but not zero, or an\n * unreachable gateway would put a doomed round trip on every request, which is\n * exactly the outage the fail-open is supposed to absorb.\n *\n * A 404 (\"app not installed or declares no settings\") is not a failure but a\n * stable answer, and is cached for the full TTL.\n */\nexport const DEFAULT_SETTINGS_ERROR_TTL_MS = 5_000;\n\n/** Request timeout (ms). A hung settings service must not hang the app. */\nexport const DEFAULT_SETTINGS_TIMEOUT_MS = 2_000;\n\nexport type SettingsDefaults = Record<string, unknown>;\n\n/**\n * The resolved map. Keys you declared in `defaults` keep their type; anything\n * else the manifest declares is still there, as `unknown`.\n */\nexport type ResolvedSettings<D extends SettingsDefaults = SettingsDefaults> = D & Record<string, unknown>;\n\n/**\n * Anything a request's tenant/token/market can be read from: the router's\n * `RouteContext`, the raw function context (`{ req: { headers } }`), or a bare\n * headers object.\n */\nexport interface SettingsSource {\n header?(name: string): string;\n tenant?: string | null;\n contextToken?: string;\n req?: { headers?: Record<string, string> | undefined } | undefined;\n headers?: Record<string, string> | undefined;\n}\n\nexport interface SettingsOptions<D extends SettingsDefaults = SettingsDefaults> {\n /**\n * The app whose settings to read. Defaults to REVENEXX_APP_NAME, which the\n * runtime sets — a deployed app usually needs no value here. `createApp`\n * passes its own `name`.\n */\n app?: string;\n /**\n * Last-resort values, and the type source. Use the same defaults your\n * settings.json declares: they are what the app runs on if the settings\n * service is unreachable.\n */\n defaults?: D;\n /** Gateway base URL. Default: REVENEXX_GATEWAY_ENDPOINT or the platform gateway. */\n endpoint?: string;\n /** Cache TTL in ms. Default: REVENEXX_SETTINGS_TTL_MS or 60_000. */\n ttlMs?: number;\n /** How long a failed read is cached, in ms. Default 5_000. */\n errorTtlMs?: number;\n /** Per-request timeout in ms. Default 2_000. */\n timeoutMs?: number;\n /** Environment to read from (tests). Default `process.env`. */\n env?: Record<string, string | undefined>;\n /** Fetch implementation (tests). Default `globalThis.fetch`. */\n fetchImpl?: typeof fetch;\n /**\n * Called when a read fails and the app falls back. Wire it to the function's\n * `error()` so a silent fallback is still visible. Must not throw.\n */\n onError?: (error: Error, info: { app: string; tenant: string; market: string | null }) => void;\n}\n\n/** A resolved read, with the provenance a caller occasionally needs. */\nexport interface SettingsSnapshot<D extends SettingsDefaults = SettingsDefaults> {\n app: string;\n tenant: string;\n /** The market the values were resolved for, or null for the tenant baseline. */\n market: string | null;\n settings: ResolvedSettings<D>;\n /** Keys that exist but are `sensitive`, so their values were withheld. */\n masked: string[];\n /** true when these values came from the gateway (fresh or cached). */\n resolved: boolean;\n /** Why the fallback happened, when `resolved` is false. */\n error?: string;\n}\n\nexport interface ReadOptions {\n /** Resolve for this market instead of the one on the request. `''` = tenant baseline. */\n market?: string;\n}\n\nexport interface SettingsReader<D extends SettingsDefaults = SettingsDefaults> {\n /** The effective settings for this request. Never throws. */\n get(source?: SettingsSource, options?: ReadOptions): Promise<ResolvedSettings<D>>;\n /** The same read, plus market/masked/provenance. */\n load(source?: SettingsSource, options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n /** Drop the cache (tests, or right after writing settings). */\n clear(): void;\n}\n\ninterface Entry<D extends SettingsDefaults> {\n at: number;\n ttl: number;\n promise: Promise<SettingsSnapshot<D>>;\n}\n\ninterface GatewayResponse {\n settings?: Record<string, unknown>;\n masked?: unknown;\n}\n\n/** Case-insensitive header read across the three shapes we accept. */\nfunction headerOf(source: SettingsSource | undefined, name: string): string {\n if (!source) return '';\n if (typeof source.header === 'function') {\n const v = source.header(name);\n if (typeof v === 'string' && v !== '') return v;\n }\n const bags = [source.req?.headers, source.headers];\n const want = name.toLowerCase();\n for (const bag of bags) {\n if (!bag) continue;\n const direct = bag[name] ?? bag[want];\n if (typeof direct === 'string' && direct !== '') return direct;\n for (const [k, v] of Object.entries(bag)) {\n if (k.toLowerCase() === want && typeof v === 'string' && v !== '') return v;\n }\n }\n return '';\n}\n\n/**\n * Merge the gateway's resolved map over the declared defaults.\n *\n * A `null` from the gateway does NOT clobber a default: a setting the merchant\n * never touched and whose schema carries no default resolves to `null`, and a\n * caller should not have to null-check a key it declared a default for. A real\n * stored value — including `false`, `0` and `''` — always wins.\n */\nfunction mergeSettings<D extends SettingsDefaults>(\n defaults: D | undefined,\n resolved: Record<string, unknown> | undefined,\n): ResolvedSettings<D> {\n const out: Record<string, unknown> = { ...(defaults ?? {}) };\n for (const [key, value] of Object.entries(resolved ?? {})) {\n if (value !== null && value !== undefined) out[key] = value;\n else if (!(key in out)) out[key] = value ?? null;\n }\n return out as ResolvedSettings<D>;\n}\n\nfunction timeoutSignal(ms: number): AbortSignal | undefined {\n const factory = (AbortSignal as { timeout?: (ms: number) => AbortSignal }).timeout;\n if (typeof factory === 'function') return factory(ms);\n if (typeof AbortController !== 'function') return undefined;\n const controller = new AbortController();\n setTimeout(() => controller.abort(), ms).unref?.();\n return controller.signal;\n}\n\n/**\n * Build a settings reader for one app. Create it once at module scope — the\n * cache lives on the reader, and a per-request reader would cache nothing.\n */\nexport function createSettings<D extends SettingsDefaults = SettingsDefaults>(\n options: SettingsOptions<D> = {},\n): SettingsReader<D> {\n const env = options.env ?? process.env;\n const defaults = options.defaults;\n const ttlMs = options.ttlMs ?? Number(env.REVENEXX_SETTINGS_TTL_MS ?? DEFAULT_SETTINGS_TTL_MS);\n const errorTtlMs = options.errorTtlMs ?? DEFAULT_SETTINGS_ERROR_TTL_MS;\n const timeoutMs = options.timeoutMs ?? DEFAULT_SETTINGS_TIMEOUT_MS;\n const endpoint = String(options.endpoint || env.REVENEXX_GATEWAY_ENDPOINT || DEFAULT_GATEWAY_ENDPOINT).replace(\n /\\/+$/,\n '',\n );\n\n const cache = new Map<string, Entry<D>>();\n /** Last successful snapshot per key — served instead of defaults on a blip. */\n const lastGood = new Map<string, SettingsSnapshot<D>>();\n\n const appName = (): string => String(options.app || env.REVENEXX_APP_NAME || '').trim();\n\n const fallback = (app: string, tenant: string, market: string | null, error: string): SettingsSnapshot<D> => ({\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, undefined),\n masked: [],\n resolved: false,\n error,\n });\n\n const report = (err: Error, info: { app: string; tenant: string; market: string | null }): void => {\n try {\n options.onError?.(err, info);\n } catch {\n /* an error reporter must never be the reason a request fails */\n }\n };\n\n async function request(app: string, tenant: string, token: string, market: string | null): Promise<SettingsSnapshot<D>> {\n const f = options.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') throw new Error('settings: no fetch available (Node >=18 or pass fetchImpl)');\n\n const qs = market ? `?market=${encodeURIComponent(market)}` : '';\n const headers: Record<string, string> = { Accept: 'application/json', 'X-Revenexx-Tenant': tenant };\n if (token) headers.Authorization = `Bearer ${token}`;\n\n const signal = timeoutSignal(timeoutMs);\n const res = await f(`${endpoint}/v1/settings/apps/${encodeURIComponent(app)}${qs}`, {\n method: 'GET',\n headers,\n ...(signal ? { signal } : {}),\n });\n const text = await res.text();\n if (!res.ok) {\n const err = new Error(`settings: ${res.status} for ${app}`) as Error & { status?: number };\n err.status = res.status;\n throw err;\n }\n const body = (text ? JSON.parse(text) : {}) as GatewayResponse;\n return {\n app,\n tenant,\n market,\n settings: mergeSettings(defaults, body.settings),\n masked: Array.isArray(body.masked) ? body.masked.filter((k): k is string => typeof k === 'string') : [],\n resolved: true,\n };\n }\n\n async function load(source?: SettingsSource, readOptions: ReadOptions = {}): Promise<SettingsSnapshot<D>> {\n const app = appName();\n const tenant = (source?.tenant ?? '') || headerOf(source, 'x-revenexx-tenant');\n const market = (readOptions.market ?? headerOf(source, 'x-revenexx-market')).trim() || null;\n\n // Nothing to ask with — answer from the defaults without a round trip.\n if (!app) return fallback('', tenant, market, 'no app name (pass `app` or set REVENEXX_APP_NAME)');\n if (!tenant) return fallback(app, '', market, 'no tenant on the request');\n\n const key = `${tenant}\u0000${app}\u0000${market ?? ''}`;\n const now = Date.now();\n const hit = cache.get(key);\n if (hit && now - hit.at < hit.ttl) return hit.promise;\n\n const token = (source?.contextToken ?? '') || headerOf(source, 'x-revenexx-context');\n const entry: Entry<D> = { at: now, ttl: ttlMs, promise: undefined as unknown as Promise<SettingsSnapshot<D>> };\n entry.promise = request(app, tenant, token, market)\n .then((snapshot) => {\n lastGood.set(key, snapshot);\n return snapshot;\n })\n .catch((err: unknown) => {\n const error = err instanceof Error ? err : new Error(String(err));\n // A 404 is the gateway saying \"this app is not installed, or declares\n // no settings\" — a stable answer, not a blip. Cache it for the full TTL\n // so an app without settings does not re-ask every five seconds.\n const status = (error as { status?: number }).status;\n entry.ttl = status === 404 ? ttlMs : errorTtlMs;\n report(error, { app, tenant, market });\n // Prefer the last values we genuinely resolved over the defaults: they\n // are the tenant's actual configuration, and a gateway blip is no\n // reason to silently revert a merchant's choices.\n const stale = lastGood.get(key);\n if (stale) return { ...stale, resolved: false, error: error.message };\n return fallback(app, tenant, market, error.message);\n });\n\n // Cached before it settles, so concurrent requests share one fetch.\n cache.set(key, entry);\n return entry.promise;\n }\n\n return {\n load,\n async get(source?: SettingsSource, readOptions?: ReadOptions): Promise<ResolvedSettings<D>> {\n return (await load(source, readOptions)).settings;\n },\n clear(): void {\n cache.clear();\n lastGood.clear();\n },\n };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA2B;;;AC0BpB,IAAM,YAAN,cAAwB,MAAM;AAAA,EAC1B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,gBAAgB;AAAA,EAEzB,YAAY,QAAgB,SAAiB,SAAmB,UAA4B,CAAC,GAAG;AAC9F,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AACd,QAAI,YAAY,OAAW,MAAK,UAAU;AAC1C,QAAI,QAAQ,SAAS,OAAW,MAAK,OAAO,QAAQ;AACpD,QAAI,QAAQ,iBAAiB,OAAW,MAAK,eAAe,QAAQ;AAAA,EACtE;AACF;AAGO,SAAS,YAAY,KAAgC;AAC1D,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,IAAI;AACV,SAAO,EAAE,kBAAkB,QAAS,EAAE,SAAS,eAAe,OAAO,EAAE,WAAW;AACpF;AAEO,IAAM,WAAW,CAAC,UAAU,gBAA2B,IAAI,UAAU,KAAK,OAAO;AACjF,IAAM,aAAa,CAAC,UAAU,eAAe,YAClD,IAAI,UAAU,KAAK,SAAS,OAAO;;;AClDrC,IAAM,MAAM,oBAAI,IAAc,CAAC,MAAM,OAAO,MAAM,OAAO,MAAM,OAAO,QAAQ,SAAS,MAAM,IAAI,CAAC;AAG3F,SAAS,SAAS,QAAe,CAAC,GAAoB;AAC3D,QAAM,SAAS,IAAI,gBAAgB;AACnC,QAAM,EAAE,QAAQ,CAAC,GAAG,QAAQ,OAAO,OAAO,OAAO,IAAI;AAErD,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,aAAO,OAAO,KAAK,OAAO,KAAK,KAAK,GAAG,CAAC,GAAG;AAAA,IAC7C,WAAW,QAAQ,OAAO,SAAS,YAAY,OAAQ,KAA0B,OAAO,UAAU;AAChG,YAAM,IAAI;AACV,UAAI,CAAC,IAAI,IAAI,EAAE,EAAE,EAAG,OAAM,IAAI,MAAM,gCAAgC,EAAE,EAAE,GAAG;AAC3E,YAAM,IAAI,MAAM,QAAQ,EAAE,KAAK,IAAI,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE;AAChE,aAAO,OAAO,KAAK,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;AAAA,IACnC,OAAO;AACL,aAAO,OAAO,KAAK,MAAM,IAAI,EAAE;AAAA,IACjC;AAAA,EACF;AAEA,MAAI,MAAM,QAAQ,MAAM,KAAK,OAAO,OAAQ,QAAO,IAAI,UAAW,OAAoB,KAAK,GAAG,CAAC;AAC/F,MAAI,MAAO,QAAO,IAAI,SAAS,gBAAgB,KAAK,KAAK,IAAI,QAAQ,GAAG,KAAK,MAAM;AACnF,MAAI,OAAO,UAAU,KAAK,EAAG,QAAO,IAAI,SAAS,OAAO,KAAK,CAAC;AAC9D,MAAI,OAAO,UAAU,MAAM,EAAG,QAAO,IAAI,UAAU,OAAO,MAAM,CAAC;AAEjE,SAAO;AACT;AAGO,SAAS,QAAQ,KAAU,QAAwB,CAAC,GAAY;AACrE,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,UAAM,MAAM,IAAI,GAAG;AACnB,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,UAAI,CAAC,KAAK,SAAS,GAAY,EAAG,QAAO;AAAA,IAC3C,WAAW,QAAQ,OAAO,SAAS,YAAY,OAAQ,KAA0B,OAAO,UAAU;AAChG,YAAM,IAAI;AACV,UAAI,CAAC,QAAQ,KAAK,EAAE,IAAI,EAAE,KAAK,EAAG,QAAO;AAAA,IAC3C,WAAW,QAAQ,MAAM;AACvB,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,QAAQ,GAAY,IAAc,GAAqB;AAC9D,UAAQ,IAAI;AAAA,IACV,KAAK;AAAM,aAAO,MAAM;AAAA,IACxB,KAAK;AAAO,aAAO,MAAM;AAAA,IACzB,KAAK;AAAM,aAAQ,IAAgB;AAAA,IACnC,KAAK;AAAO,aAAQ,KAAiB;AAAA,IACrC,KAAK;AAAM,aAAQ,IAAgB;AAAA,IACnC,KAAK;AAAO,aAAQ,KAAiB;AAAA,IACrC,KAAK;AAAM,aAAO,MAAM;AAAA,IACxB,KAAK;AAAM,aAAO,MAAM,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;AAAA,IAClD,KAAK;AAAA,IACL,KAAK,SAAS;AACZ,YAAM,KAAK,IAAI;AAAA,QACb,MAAM,OAAO,CAAC,EAAE,QAAQ,sBAAsB,MAAM,EAAE,QAAQ,MAAM,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI;AAAA,QAC/F,OAAO,UAAU,MAAM;AAAA,MACzB;AACA,aAAO,GAAG,KAAK,OAAO,CAAC,CAAC;AAAA,IAC1B;AAAA,IACA;AAAS,aAAO;AAAA,EAClB;AACF;;;AFlEA,SAAS,MAAM,MAAa,OAAqB;AAC/C,MAAI,MAAM;AACV,MAAI,MAAM,OAAO;AACf,UAAM,CAAC,GAAG,MAAM,KAAK,IAAI,MAAM,MAAM,MAAM,GAAG;AAC9C,UAAM,MAAM;AACZ,UAAM,IAAI,MAAM,EAAE,KAAK,CAAC,GAAG,MAAO,EAAE,GAAG,IAAK,EAAE,GAAG,IAAK,KAAK,EAAE,GAAG,IAAK,EAAE,GAAG,IAAK,IAAI,CAAE;AACrF,QAAI,QAAQ,OAAQ,KAAI,QAAQ;AAAA,EAClC;AACA,MAAI,MAAM,OAAQ,OAAM,IAAI,MAAM,MAAM,MAAM;AAC9C,MAAI,OAAO,UAAU,MAAM,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,MAAM,KAAK;AACjE,MAAI,MAAM,QAAQ,MAAM,MAAM,KAAK,MAAM,OAAO,QAAQ;AACtD,UAAM,OAAO,MAAM;AACnB,UAAM,IAAI,IAAI,CAAC,MAAM,OAAO,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAAA,EACrE;AACA,SAAO,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAClC;AAGO,SAAS,cAAc,QAAgB,MAAgB;AAC5D,QAAM,MAAW,EAAE,GAAG,KAAK;AAC3B,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,OAAO,WAAW,CAAC,CAAC,GAAG;AAC7D,QAAI,IAAI,GAAG,MAAM,UAAa,OAAO,KAAM;AAC3C,UAAM,IAAI,IAAI;AACd,QAAI,KAAK,KAAM;AACf,QAAI,mBAAmB,KAAK,CAAC,EAAG,KAAI,GAAG,QAAI,+BAAW;AAAA,aAC7C,6BAA6B,KAAK,CAAC,EAAG,KAAI,GAAG,KAAI,oBAAI,KAAK,GAAE,YAAY;AAAA,SAC5E;AACH,YAAM,IAAI,WAAW,KAAK,OAAO,CAAC,EAAE,KAAK,CAAC;AAC1C,UAAI,EAAG,KAAI,GAAG,IAAI,EAAE,CAAC;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,kBAAkB,OAA8B,CAAC,GAAY;AAC3E,QAAM,QAAQ,oBAAI,IAA+B;AACjD,QAAM,MAAM,CAAC,WAAsC;AACjD,QAAI,IAAI,MAAM,IAAI,OAAO,IAAI;AAC7B,QAAI,CAAC,GAAG;AACN,UAAI,oBAAI,IAAI;AACZ,iBAAW,KAAK,KAAK,OAAO,IAAI,KAAK,CAAC,EAAG,GAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACrE,YAAM,IAAI,OAAO,MAAM,CAAC;AAAA,IAC1B;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAmB;AAC5D,YAAM,WAAW,CAAC,GAAG,IAAI,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;AAChF,aAAO,MAAM,UAAU,KAAK;AAAA,IAC9B;AAAA,IACA,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAkB;AAC3D,YAAM,WAAW,CAAC,GAAG,IAAI,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;AAChF,aAAO,EAAE,OAAO,MAAM,UAAU,KAAK,GAAG,OAAO,SAAS,QAAQ,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO;AAAA,IAC3G;AAAA,IACA,MAAM,IAAI,QAAgB,IAA0C;AAClE,YAAM,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE;AAC5B,aAAO,IAAI,EAAE,GAAG,EAAE,IAAI;AAAA,IACxB;AAAA,IACA,MAAM,OAAO,QAAgB,MAAyB;AACpD,YAAM,MAAM,cAAc,QAAQ,IAAI;AACtC,UAAI,IAAI,OAAO,EAAE,MAAM,OAAW,KAAI,OAAO,EAAE,QAAI,+BAAW;AAC9D,UAAI,MAAM,EAAE,IAAI,IAAI,OAAO,EAAE,GAAG,GAAG;AACnC,aAAO,EAAE,GAAG,IAAI;AAAA,IAClB;AAAA,IACA,MAAM,OAAO,QAAgB,IAAqB,OAA0B;AAC1E,YAAM,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE;AAI9B,UAAI,CAAC,IAAK,OAAM,SAAS,SAAS,OAAO,IAAI,IAAI,OAAO,EAAE,CAAC,YAAY;AACvE,YAAM,MAAW,EAAE,GAAG,KAAK,GAAG,MAAM;AACpC,UAAI,OAAO,SAAS,WAAY,KAAI,cAAa,oBAAI,KAAK,GAAE,YAAY;AACxE,UAAI,MAAM,EAAE,IAAI,IAAI,GAAG;AACvB,aAAO,EAAE,GAAG,IAAI;AAAA,IAClB;AAAA,IACA,MAAM,OAAO,QAAgB,IAAoC;AAC/D,UAAI,MAAM,EAAE,OAAO,EAAE;AAAA,IACvB;AAAA,EACF;AACF;;;AGlDA,SAAS,UAAU,MAA2B;AAC5C,MAAI,CAAC,KAAM,QAAO,CAAC;AACnB,MAAI;AACF,UAAM,SAAkB,KAAK,MAAM,IAAI;AACvC,WAAO,UAAU,OAAO,WAAW,WAAY,SAAyB,CAAC;AAAA,EAC3E,QAAQ;AACN,WAAO,CAAC;AAAA,EACV;AACF;AASA,IAAM,cAAsC;AAAA,EAC1C,SAAS,EAAE,QAAQ,KAAK,MAAM,oBAAoB,SAAS,0CAA0C;AAAA,EACrG,SAAS,EAAE,QAAQ,KAAK,MAAM,uBAAuB,SAAS,0CAA0C;AAAA,EACxG,SAAS,EAAE,QAAQ,KAAK,MAAM,sBAAsB,SAAS,8BAA8B;AAAA,EAC3F,SAAS,EAAE,QAAQ,KAAK,MAAM,mBAAmB,SAAS,8BAA8B;AAAA,EACxF,SAAS,EAAE,QAAQ,KAAK,MAAM,iBAAiB,SAAS,8CAA8C;AACxG;AAGA,IAAM,gBAAwC;AAAA,EAC5C,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AAAA,EACL,KAAK;AACP;AAcA,SAAS,WAAW,IAAiB,QAAwB;AAC3D,QAAM,UAAkB;AAAA,IACtB,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AACA,QAAM,UAAkB;AAAA,IACtB,QAAQ;AAAA,IACR,MAAM;AAAA,IACN,SAAS;AAAA,EACX;AACA,QAAM,OAAO,GAAG,GAAG,WAAW,EAAE,IAAI,GAAG,WAAW,EAAE;AACpD,MAAI,4BAA4B,KAAK,IAAI,EAAG,QAAO;AACnD,MAAI,2BAA2B,KAAK,IAAI,EAAG,QAAO;AAClD,SAAO,OAAO,YAAY,MAAM,WAAW,UAAU;AACvD;AAEA,SAAS,SAAS,QAAgB,IAAiB,QAAwB;AACzE,QAAM,WAAW,OAAO,GAAG,SAAS,WAAW,GAAG,OAAO;AACzD,MAAI,aAAa,QAAS,QAAO,WAAW,IAAI,MAAM;AACtD,QAAM,QAAQ,YAAY,QAAQ;AAClC,MAAI,MAAO,QAAO;AAIlB,MAAI,MAAM,KAAK,QAAQ,GAAG;AACxB,WAAO,EAAE,QAAQ,KAAK,MAAM,iBAAiB,SAAS,8CAA8C;AAAA,EACtG;AACA,QAAM,UAAU,cAAc,MAAM;AACpC,MAAI,QAAS,QAAO,EAAE,QAAQ,MAAM,eAAe,SAAS,QAAQ;AACpE,SAAO,EAAE,QAAQ,KAAK,MAAM,cAAc,SAAS,kDAAkD;AACvG;AAMO,SAAS,eAAe,QAAgB,MAAc,SAAwD;AACnH,QAAM,KAAK,UAAU,IAAI;AACzB,QAAM,SAAS,SAAS,QAAQ,IAAI,QAAQ,MAAM;AAClD,SAAO,IAAI,UAAU,OAAO,QAAQ,OAAO,SAAS,QAAW;AAAA,IAC7D,MAAM,OAAO;AAAA,IACb,cAAc;AAAA,MACZ,QAAQ;AAAA,MACR;AAAA,MACA,QAAQ,QAAQ;AAAA,MAChB,GAAI,QAAQ,QAAQ,EAAE,OAAO,QAAQ,MAAM,IAAI,CAAC;AAAA,MAChD,UAAU,GAAG,QAAQ;AAAA,MACrB,SAAS,GAAG,YAAY,QAAQ;AAAA,MAChC,SAAS,GAAG,WAAW;AAAA,MACvB,MAAM,GAAG,QAAQ;AAAA,IACnB;AAAA,EACF,CAAC;AACH;AASO,SAAS,oBAAoB,QAAgB,MAAwC;AAC1F,MAAI,WAAW,IAAK,QAAO;AAC3B,QAAM,KAAK,UAAU,IAAI;AAEzB,QAAM,IAAI,6BAA6B,KAAK,GAAG,GAAG,WAAW,EAAE,IAAI,GAAG,WAAW,EAAE,EAAE;AACrF,SAAO,EAAE,OAAO,IAAI,OAAO,SAAS,EAAE,CAAC,GAAI,EAAE,IAAI,EAAE;AACrD;;;AChIO,SAAS,oBAAoB,QAA+B;AACjE,QAAM,IAAI,OAAO,aAAa,WAAW;AACzC,MAAI,OAAO,MAAM,YAAY;AAC3B,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,QAAM,OAAO,OAAO,OAAO,YAAY,EAAE,EAAE,QAAQ,OAAO,EAAE;AAC5D,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,sCAAsC;AAEjE,QAAM,UAAU,CAAC,UAA2D;AAC1E,UAAM,IAA4B,EAAE,gBAAgB,oBAAoB,QAAQ,oBAAoB,GAAG,MAAM;AAC7G,QAAI,OAAO,MAAO,GAAE,gBAAgB,UAAU,OAAO,KAAK;AAC1D,QAAI,OAAO,OAAQ,GAAE,mBAAmB,IAAI,OAAO;AACnD,QAAI,OAAO,OAAQ,GAAE,mBAAmB,IAAI,OAAO;AACnD,WAAO;AAAA,EACT;AAiBA,iBAAe,KAAK,QAAgB,MAAc,OAAoB,CAAC,GAAkB;AACvF,UAAM,MAAM,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,IAAI;AAAA,MACpC;AAAA,MACA,SAAS,QAAQ,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC;AAAA,MAC3D,MAAM,KAAK,QAAQ,OAAO,KAAK,UAAU,KAAK,IAAI,IAAI;AAAA,IACxD,CAAC;AACD,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,UAAM,QAAQ,IAAI,SAAS,MAAM,eAAe,KAAK;AACrD,UAAM,QAAQ,OAAO,SAAS,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;AAC3D,WAAO,EAAE,QAAQ,IAAI,QAAQ,IAAI,IAAI,IAAI,MAAM,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ,KAAK;AAAA,EAC9F;AAEA,iBAAe,IAAI,QAAgB,MAAc,OAAoB,CAAC,GAAqB;AACzF,UAAM,EAAE,IAAI,QAAQ,KAAK,IAAI,MAAM,KAAK,QAAQ,MAAM,IAAI;AAG1D,QAAI,CAAC,GAAI,OAAM,eAAe,QAAQ,MAAM,EAAE,QAAQ,OAAO,KAAK,MAAM,CAAC;AACzE,WAAO,OAAO,KAAK,MAAM,IAAI,IAAI;AAAA,EACnC;AAcA,QAAM,SAAS,CAAC,MAAe,cAAoC;AACjE,UAAM,MAAM,MAAM,QAAQ,IAAI,IAAK,KAAK,CAAC,IAAyB;AAClE,QAAI,OAAO,KAAM,OAAM,UAAU;AACjC,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAmB;AAC5D,YAAM,KAAK,SAAS,KAAK,EAAE,SAAS;AACpC,YAAM,EAAE,IAAI,QAAQ,KAAK,IAAI,MAAM,KAAK,OAAO,IAAI,OAAO,KAAK,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI;AAAA,QACtF,OAAO,OAAO;AAAA,MAChB,CAAC;AACD,UAAI,CAAC,IAAI;AAGP,YAAI,oBAAoB,QAAQ,IAAI,EAAG,QAAO,CAAC;AAC/C,cAAM,eAAe,QAAQ,MAAM,EAAE,QAAQ,OAAO,OAAO,OAAO,MAAM,CAAC;AAAA,MAC3E;AACA,cAAQ,OAAQ,KAAK,MAAM,IAAI,IAAc,CAAC,MAAM,CAAC;AAAA,IACvD;AAAA,IACA,MAAM,IAAI,QAAgB,IAA0C;AAClE,YAAM,OAAQ,MAAM,IAAI,OAAO,IAAI,OAAO,KAAK,IAAI,OAAO,EAAE,OAAO,mBAAmB,OAAO,EAAE,CAAC,CAAC,YAAY;AAAA,QAC3G,OAAO,OAAO;AAAA,MAChB,CAAC;AACD,aAAO,OAAO,CAAC,KAAK;AAAA,IACtB;AAAA,IACA,MAAM,OAAO,QAAgB,MAAyB;AACpD,YAAM,OAAO,MAAM,IAAI,QAAQ,IAAI,OAAO,KAAK,IAAI;AAAA,QACjD,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,OAAO,OAAO;AAAA,MAChB,CAAC;AAID,aAAO;AAAA,QACL;AAAA,QACA,MACE,IAAI,UAAU,KAAK,qDAAqD,QAAW;AAAA,UACjF,MAAM;AAAA,UACN,cAAc,EAAE,QAAQ,aAAa,QAAQ,QAAQ,OAAO,OAAO,MAAM;AAAA,QAC3E,CAAC;AAAA,MACL;AAAA,IACF;AAAA,IACA,MAAM,OAAO,QAAgB,IAAqB,OAA0B;AAC1E,YAAM,OAAO,MAAM,IAAI,SAAS,IAAI,OAAO,KAAK,IAAI,OAAO,EAAE,OAAO,mBAAmB,OAAO,EAAE,CAAC,CAAC,IAAI;AAAA,QACpG,MAAM;AAAA,QACN,QAAQ;AAAA,QACR,OAAO,OAAO;AAAA,MAChB,CAAC;AAKD,aAAO,OAAO,MAAM,MAAM,SAAS,CAAC;AAAA,IACtC;AAAA,IACA,MAAM,OAAO,QAAgB,IAAoC;AAC/D,YAAM,IAAI,UAAU,IAAI,OAAO,KAAK,IAAI,OAAO,EAAE,OAAO,mBAAmB,OAAO,EAAE,CAAC,CAAC,IAAI;AAAA,QACxF,OAAO,OAAO;AAAA,MAChB,CAAC;AAAA,IACH;AAAA,IACA,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAkB;AAG3D,YAAM,KAAK,SAAS,KAAK,EAAE,SAAS;AACpC,YAAM,EAAE,IAAI,QAAQ,MAAM,MAAM,IAAI,MAAM,KAAK,OAAO,IAAI,OAAO,KAAK,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI;AAAA,QAC7F,QAAQ;AAAA,QACR,OAAO,OAAO;AAAA,MAChB,CAAC;AACD,UAAI,CAAC,IAAI;AAIP,cAAM,WAAW,oBAAoB,QAAQ,IAAI;AACjD,YAAI,UAAU;AACZ,iBAAO,EAAE,OAAO,CAAC,GAAG,OAAO,SAAS,SAAS,OAAO,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO;AAAA,QAC/F;AACA,cAAM,eAAe,QAAQ,MAAM,EAAE,QAAQ,OAAO,OAAO,OAAO,MAAM,CAAC;AAAA,MAC3E;AACA,YAAM,QAAS,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC;AAC1C,aAAO;AAAA,QACL;AAAA,QACA,OAAO,SAAS,MAAM;AAAA,QACtB,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;;;AC7KO,IAAM,wBAAwB;AAU9B,SAAS,qBAAqB,SAAwB,CAAC,GAAY;AACxE,QAAM,MAAM,OAAO,OAAO,QAAQ;AAClC,QAAM,IAAI,OAAO,SAAS,KAAK,WAAW,CAAC;AAC3C,QAAM,MAAM,CAAC,SAAyB,EAAE,IAAI,KAAK,EAAE,KAAK,YAAY,CAAC,KAAK;AAE1E,QAAM,SAAS,oBAAoB;AAAA,IACjC,UAAU,IAAI,0BAA0B;AAAA,IACxC,OAAO,IAAI,oBAAoB,KAAK,IAAI,oBAAoB;AAAA,IAC5D,QAAQ,IAAI,mBAAmB,KAAK,IAAI,mBAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAM3D,QAAQ,IAAI,mBAAmB,KAAK,IAAI,mBAAmB;AAAA,EAC7D,CAAC;AAED,SAAO,EAAE,GAAG,QAAQ,MAAM,UAAU;AACtC;;;AC7BA,IAAM,WAAW,oBAAI,IAA4B;AAE1C,SAAS,gBAAgB,MAAc,SAA+B;AAC3E,WAAS,IAAI,MAAM,OAAO;AAC5B;AAEO,SAAS,eAAyB;AACvC,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;AAEO,SAAS,cAAc,QAA6D;AACzF,QAAM,OAAO,OAAO,WAAW;AAC/B,QAAM,UAAU,SAAS,IAAI,IAAI;AACjC,MAAI,CAAC,SAAS;AACZ,UAAM,QAAQ,aAAa,EAAE,KAAK,KAAK,KAAK;AAC5C,UAAM,IAAI,MAAM,6BAA6B,IAAI,MAAM,KAAK,GAAG;AAAA,EACjE;AACA,SAAO,QAAQ,MAAM;AACvB;AAEA,gBAAgB,QAAQ,CAAC,MAAM,kBAAkB,EAAE,IAAI,CAAC;AACxD,gBAAgB,UAAU,CAAC,MAAM,oBAAoB,CAAyB,CAAC;AAC/E,gBAAgB,WAAW,CAAC,MAAM,qBAAqB,CAAC,CAAC;;;ACRlD,IAAM,uBAAuB;AAO7B,SAAS,aAAa,OAA0B;AACrD,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,EAAG,QAAO,CAAC;AACzE,SAAO,OAAO,KAAK,KAAgC,EAAE;AAAA,IACnD,CAAC,QAAS,MAAkC,GAAG,MAAM;AAAA,EACvD;AACF;AAGO,SAAS,gBAAgB,OAAsB;AACpD,MAAI,aAAa,KAAK,EAAE,WAAW,EAAG,OAAM,WAAW,oBAAoB;AAC7E;;;ACtCA,IAAM,gBAAsC;AAAA,EAC1C,MAAM,CAAC,QAAQ,KAAK;AAAA,EACpB,QAAQ,CAAC,QAAQ;AAAA,EACjB,QAAQ,CAAC,QAAQ;AAAA,EACjB,QAAQ,CAAC,QAAQ;AACnB;AAGO,SAAS,cAAc,SAAmB,CAAC,GAAY;AAC5D,QAAM,MAAM,oBAAI,IAAQ;AACxB,aAAW,KAAK,OAAQ,EAAC,cAAc,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;AAC1E,SAAO;AACT;AAaA,SAAS,aAAa,SAAkB,QAA8B;AACpE,QAAM,MAAM,OAAO,eAAe,MAAM,OAAO,MAAM,IAAI,IAAQ,OAAO,OAAO,CAAC,QAAQ,OAAO,UAAU,UAAU,QAAQ,CAAC;AAC5H,QAAM,QAAQ,CAA0C,IAAQ,OAC7D,IAAI,IAAI,EAAE,IACP,MACC,MAAM;AACL,UAAM,IAAI;AAAA,MACR,GAAG,OAAO,IAAI,IAAI,EAAE,mFAA8E,OAAO,IAAI;AAAA,IAC/G;AAAA,EACF;AAEN,SAAO;AAAA,IACL,MAAM,MAAM,QAAQ,CAAC,UAAkB,QAAQ,KAAK,QAAQ,SAAS,CAAC,CAAC,CAAC;AAAA,IACxE,MAAM,MAAM,QAAQ,CAAC,UAAkB;AACrC,UAAI,CAAC,QAAQ,MAAM;AACjB,cAAM,IAAI,MAAM,GAAG,OAAO,IAAI,oCAAoC,QAAQ,IAAI,WAAW;AAAA,MAC3F;AACA,aAAO,QAAQ,KAAK,QAAQ,SAAS,CAAC,CAAC;AAAA,IACzC,CAAC;AAAA,IACD,KAAK,MAAM,OAAO,CAAC,OAAwB,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAAA,IAClE,QAAQ,MAAM,UAAU,CAAC,SAAc,QAAQ,OAAO,QAAQ,IAAI,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAUnE,QAAQ,MAAM,UAAU,OAAO,IAAqB,UAAe;AACjE,sBAAgB,KAAK;AACrB,aAAO,QAAQ,OAAO,QAAQ,IAAI,KAAK;AAAA,IACzC,CAAC;AAAA,IACD,QAAQ,MAAM,UAAU,CAAC,OAAwB,QAAQ,OAAO,QAAQ,EAAE,CAAC;AAAA,EAC7E;AACF;AAgBO,SAAS,aAAa,QAA8B;AACzD,MAAI,CAAC,QAAQ,SAAU,OAAM,IAAI,MAAM,mDAAmD;AAC1F,QAAM,UAAU,cAAc,MAAM;AACpC,QAAM,KAAK,uBAAO,OAAO,EAAE,WAAW,QAAQ,KAAK,CAAC;AACpD,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,OAAO,QAAQ,GAAG;AACzD,OAAG,IAAI,IAAI,aAAa,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;AAAA,EACnD;AACA,SAAO;AACT;;;ACrCO,IAAM,2BAA2B;AAcjC,IAAM,0BAA0B;AAWhC,IAAM,gCAAgC;AAGtC,IAAM,8BAA8B;AAgG3C,SAAS,SAAS,QAAoC,MAAsB;AAC1E,MAAI,CAAC,OAAQ,QAAO;AACpB,MAAI,OAAO,OAAO,WAAW,YAAY;AACvC,UAAM,IAAI,OAAO,OAAO,IAAI;AAC5B,QAAI,OAAO,MAAM,YAAY,MAAM,GAAI,QAAO;AAAA,EAChD;AACA,QAAM,OAAO,CAAC,OAAO,KAAK,SAAS,OAAO,OAAO;AACjD,QAAM,OAAO,KAAK,YAAY;AAC9B,aAAW,OAAO,MAAM;AACtB,QAAI,CAAC,IAAK;AACV,UAAM,SAAS,IAAI,IAAI,KAAK,IAAI,IAAI;AACpC,QAAI,OAAO,WAAW,YAAY,WAAW,GAAI,QAAO;AACxD,eAAW,CAAC,GAAG,CAAC,KAAK,OAAO,QAAQ,GAAG,GAAG;AACxC,UAAI,EAAE,YAAY,MAAM,QAAQ,OAAO,MAAM,YAAY,MAAM,GAAI,QAAO;AAAA,IAC5E;AAAA,EACF;AACA,SAAO;AACT;AAUA,SAAS,cACP,UACA,UACqB;AACrB,QAAM,MAA+B,EAAE,GAAI,YAAY,CAAC,EAAG;AAC3D,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,YAAY,CAAC,CAAC,GAAG;AACzD,QAAI,UAAU,QAAQ,UAAU,OAAW,KAAI,GAAG,IAAI;AAAA,aAC7C,EAAE,OAAO,KAAM,KAAI,GAAG,IAAI,SAAS;AAAA,EAC9C;AACA,SAAO;AACT;AAEA,SAAS,cAAc,IAAqC;AAC1D,QAAM,UAAW,YAA0D;AAC3E,MAAI,OAAO,YAAY,WAAY,QAAO,QAAQ,EAAE;AACpD,MAAI,OAAO,oBAAoB,WAAY,QAAO;AAClD,QAAM,aAAa,IAAI,gBAAgB;AACvC,aAAW,MAAM,WAAW,MAAM,GAAG,EAAE,EAAE,QAAQ;AACjD,SAAO,WAAW;AACpB;AAMO,SAAS,eACd,UAA8B,CAAC,GACZ;AACnB,QAAM,MAAM,QAAQ,OAAO,QAAQ;AACnC,QAAM,WAAW,QAAQ;AACzB,QAAM,QAAQ,QAAQ,SAAS,OAAO,IAAI,4BAA4B,uBAAuB;AAC7F,QAAM,aAAa,QAAQ,cAAc;AACzC,QAAM,YAAY,QAAQ,aAAa;AACvC,QAAM,WAAW,OAAO,QAAQ,YAAY,IAAI,6BAA6B,wBAAwB,EAAE;AAAA,IACrG;AAAA,IACA;AAAA,EACF;AAEA,QAAM,QAAQ,oBAAI,IAAsB;AAExC,QAAM,WAAW,oBAAI,IAAiC;AAEtD,QAAM,UAAU,MAAc,OAAO,QAAQ,OAAO,IAAI,qBAAqB,EAAE,EAAE,KAAK;AAEtF,QAAM,WAAW,CAAC,KAAa,QAAgB,QAAuB,WAAwC;AAAA,IAC5G;AAAA,IACA;AAAA,IACA;AAAA,IACA,UAAU,cAAc,UAAU,MAAS;AAAA,IAC3C,QAAQ,CAAC;AAAA,IACT,UAAU;AAAA,IACV;AAAA,EACF;AAEA,QAAM,SAAS,CAAC,KAAY,SAAuE;AACjG,QAAI;AACF,cAAQ,UAAU,KAAK,IAAI;AAAA,IAC7B,QAAQ;AAAA,IAER;AAAA,EACF;AAEA,iBAAe,QAAQ,KAAa,QAAgB,OAAe,QAAqD;AACtH,UAAM,IAAI,QAAQ,aAAa,WAAW;AAC1C,QAAI,OAAO,MAAM,WAAY,OAAM,IAAI,MAAM,4DAA4D;AAEzG,UAAM,KAAK,SAAS,WAAW,mBAAmB,MAAM,CAAC,KAAK;AAC9D,UAAM,UAAkC,EAAE,QAAQ,oBAAoB,qBAAqB,OAAO;AAClG,QAAI,MAAO,SAAQ,gBAAgB,UAAU,KAAK;AAElD,UAAM,SAAS,cAAc,SAAS;AACtC,UAAM,MAAM,MAAM,EAAE,GAAG,QAAQ,qBAAqB,mBAAmB,GAAG,CAAC,GAAG,EAAE,IAAI;AAAA,MAClF,QAAQ;AAAA,MACR;AAAA,MACA,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,IAC7B,CAAC;AACD,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,MAAM,IAAI,MAAM,aAAa,IAAI,MAAM,QAAQ,GAAG,EAAE;AAC1D,UAAI,SAAS,IAAI;AACjB,YAAM;AAAA,IACR;AACA,UAAM,OAAQ,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC;AACzC,WAAO;AAAA,MACL;AAAA,MACA;AAAA,MACA;AAAA,MACA,UAAU,cAAc,UAAU,KAAK,QAAQ;AAAA,MAC/C,QAAQ,MAAM,QAAQ,KAAK,MAAM,IAAI,KAAK,OAAO,OAAO,CAAC,MAAmB,OAAO,MAAM,QAAQ,IAAI,CAAC;AAAA,MACtG,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,iBAAe,KAAK,QAAyB,cAA2B,CAAC,GAAiC;AACxG,UAAM,MAAM,QAAQ;AACpB,UAAM,UAAU,QAAQ,UAAU,OAAO,SAAS,QAAQ,mBAAmB;AAC7E,UAAM,UAAU,YAAY,UAAU,SAAS,QAAQ,mBAAmB,GAAG,KAAK,KAAK;AAGvF,QAAI,CAAC,IAAK,QAAO,SAAS,IAAI,QAAQ,QAAQ,mDAAmD;AACjG,QAAI,CAAC,OAAQ,QAAO,SAAS,KAAK,IAAI,QAAQ,0BAA0B;AAExE,UAAM,MAAM,GAAG,MAAM,KAAI,GAAG,KAAI,UAAU,EAAE;AAC5C,UAAM,MAAM,KAAK,IAAI;AACrB,UAAM,MAAM,MAAM,IAAI,GAAG;AACzB,QAAI,OAAO,MAAM,IAAI,KAAK,IAAI,IAAK,QAAO,IAAI;AAE9C,UAAM,SAAS,QAAQ,gBAAgB,OAAO,SAAS,QAAQ,oBAAoB;AACnF,UAAM,QAAkB,EAAE,IAAI,KAAK,KAAK,OAAO,SAAS,OAAqD;AAC7G,UAAM,UAAU,QAAQ,KAAK,QAAQ,OAAO,MAAM,EAC/C,KAAK,CAAC,aAAa;AAClB,eAAS,IAAI,KAAK,QAAQ;AAC1B,aAAO;AAAA,IACT,CAAC,EACA,MAAM,CAAC,QAAiB;AACvB,YAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAIhE,YAAM,SAAU,MAA8B;AAC9C,YAAM,MAAM,WAAW,MAAM,QAAQ;AACrC,aAAO,OAAO,EAAE,KAAK,QAAQ,OAAO,CAAC;AAIrC,YAAM,QAAQ,SAAS,IAAI,GAAG;AAC9B,UAAI,MAAO,QAAO,EAAE,GAAG,OAAO,UAAU,OAAO,OAAO,MAAM,QAAQ;AACpE,aAAO,SAAS,KAAK,QAAQ,QAAQ,MAAM,OAAO;AAAA,IACpD,CAAC;AAGH,UAAM,IAAI,KAAK,KAAK;AACpB,WAAO,MAAM;AAAA,EACf;AAEA,SAAO;AAAA,IACL;AAAA,IACA,MAAM,IAAI,QAAyB,aAAyD;AAC1F,cAAQ,MAAM,KAAK,QAAQ,WAAW,GAAG;AAAA,IAC3C;AAAA,IACA,QAAc;AACZ,YAAM,MAAM;AACZ,eAAS,MAAM;AAAA,IACjB;AAAA,EACF;AACF;","names":[]}
|
package/dist/index.d.cts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { R as Row, Q as Query, P as Page, E as Entity, O as Op, A as Adapter } from './errors-
|
|
2
|
-
export { C as ColumnDef, D as DEFAULT_GATEWAY_ENDPOINT, a as DEFAULT_SETTINGS_ERROR_TTL_MS, b as DEFAULT_SETTINGS_TIMEOUT_MS, c as DEFAULT_SETTINGS_TTL_MS, F as Filter, d as FilterOp, H as HttpError, e as HttpErrorOptions, f as ReadOptions, g as ResolvedSettings, S as Scalar, h as SettingsDefaults, i as SettingsOptions, j as SettingsReader, k as SettingsSnapshot, l as SettingsSource, m as createSettings, n as isHttpError } from './errors-
|
|
1
|
+
import { R as Row, Q as Query, P as Page, E as Entity, O as Op, A as Adapter } from './errors-CeQxIhQn.cjs';
|
|
2
|
+
export { C as ColumnDef, D as DEFAULT_GATEWAY_ENDPOINT, a as DEFAULT_SETTINGS_ERROR_TTL_MS, b as DEFAULT_SETTINGS_TIMEOUT_MS, c as DEFAULT_SETTINGS_TTL_MS, F as Filter, d as FilterOp, H as HttpError, e as HttpErrorOptions, f as ReadOptions, g as ResolvedSettings, S as Scalar, h as SettingsDefaults, i as SettingsOptions, j as SettingsReader, k as SettingsSnapshot, l as SettingsSource, m as createSettings, n as isHttpError } from './errors-CeQxIhQn.cjs';
|
|
3
3
|
|
|
4
4
|
/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */
|
|
5
5
|
declare function opsFromAccess(access?: string[]): Set<Op>;
|
|
@@ -47,10 +47,26 @@ interface RemoteConfig {
|
|
|
47
47
|
endpoint: string;
|
|
48
48
|
token?: string;
|
|
49
49
|
tenant?: string;
|
|
50
|
-
/**
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
50
|
+
/**
|
|
51
|
+
* Active market, forwarded as `X-Revenexx-Market`. Never a security boundary
|
|
52
|
+
* — the tenant is the hard contract (token/RLS).
|
|
53
|
+
*
|
|
54
|
+
* What it does depends entirely on which endpoint the entity points at, and
|
|
55
|
+
* the two effects are not symmetric:
|
|
56
|
+
*
|
|
57
|
+
* - **On INSERT it ASSIGNS.** An `AFTER INSERT` trigger on every scopeable
|
|
58
|
+
* table reads the header and writes a `baseline.entity_scopes` row for the
|
|
59
|
+
* new id. Sending a market here narrows what that row is visible as, for
|
|
60
|
+
* good. Sending none leaves it unassigned, i.e. visible everywhere.
|
|
61
|
+
* - **On SELECT it filters only through a `*_scoped` view.**
|
|
62
|
+
* `baseline.is_visible()` is called from the view body and nowhere else, so
|
|
63
|
+
* a read of the BASE table ignores the header completely.
|
|
64
|
+
*
|
|
65
|
+
* Generated entities target the base table (`vendor__app__entity`), so unless
|
|
66
|
+
* an App overrides `entity.table` with the `_scoped` name, a list returns the
|
|
67
|
+
* same rows with or without a market. Absent is therefore a no-op on reads,
|
|
68
|
+
* not a "globals only" default.
|
|
69
|
+
*/
|
|
54
70
|
market?: string;
|
|
55
71
|
fetchImpl?: typeof fetch;
|
|
56
72
|
}
|
package/dist/index.d.ts
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
import { R as Row, Q as Query, P as Page, E as Entity, O as Op, A as Adapter } from './errors-
|
|
2
|
-
export { C as ColumnDef, D as DEFAULT_GATEWAY_ENDPOINT, a as DEFAULT_SETTINGS_ERROR_TTL_MS, b as DEFAULT_SETTINGS_TIMEOUT_MS, c as DEFAULT_SETTINGS_TTL_MS, F as Filter, d as FilterOp, H as HttpError, e as HttpErrorOptions, f as ReadOptions, g as ResolvedSettings, S as Scalar, h as SettingsDefaults, i as SettingsOptions, j as SettingsReader, k as SettingsSnapshot, l as SettingsSource, m as createSettings, n as isHttpError } from './errors-
|
|
1
|
+
import { R as Row, Q as Query, P as Page, E as Entity, O as Op, A as Adapter } from './errors-CeQxIhQn.js';
|
|
2
|
+
export { C as ColumnDef, D as DEFAULT_GATEWAY_ENDPOINT, a as DEFAULT_SETTINGS_ERROR_TTL_MS, b as DEFAULT_SETTINGS_TIMEOUT_MS, c as DEFAULT_SETTINGS_TTL_MS, F as Filter, d as FilterOp, H as HttpError, e as HttpErrorOptions, f as ReadOptions, g as ResolvedSettings, S as Scalar, h as SettingsDefaults, i as SettingsOptions, j as SettingsReader, k as SettingsSnapshot, l as SettingsSource, m as createSettings, n as isHttpError } from './errors-CeQxIhQn.js';
|
|
3
3
|
|
|
4
4
|
/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */
|
|
5
5
|
declare function opsFromAccess(access?: string[]): Set<Op>;
|
|
@@ -47,10 +47,26 @@ interface RemoteConfig {
|
|
|
47
47
|
endpoint: string;
|
|
48
48
|
token?: string;
|
|
49
49
|
tenant?: string;
|
|
50
|
-
/**
|
|
51
|
-
*
|
|
52
|
-
*
|
|
53
|
-
*
|
|
50
|
+
/**
|
|
51
|
+
* Active market, forwarded as `X-Revenexx-Market`. Never a security boundary
|
|
52
|
+
* — the tenant is the hard contract (token/RLS).
|
|
53
|
+
*
|
|
54
|
+
* What it does depends entirely on which endpoint the entity points at, and
|
|
55
|
+
* the two effects are not symmetric:
|
|
56
|
+
*
|
|
57
|
+
* - **On INSERT it ASSIGNS.** An `AFTER INSERT` trigger on every scopeable
|
|
58
|
+
* table reads the header and writes a `baseline.entity_scopes` row for the
|
|
59
|
+
* new id. Sending a market here narrows what that row is visible as, for
|
|
60
|
+
* good. Sending none leaves it unassigned, i.e. visible everywhere.
|
|
61
|
+
* - **On SELECT it filters only through a `*_scoped` view.**
|
|
62
|
+
* `baseline.is_visible()` is called from the view body and nowhere else, so
|
|
63
|
+
* a read of the BASE table ignores the header completely.
|
|
64
|
+
*
|
|
65
|
+
* Generated entities target the base table (`vendor__app__entity`), so unless
|
|
66
|
+
* an App overrides `entity.table` with the `_scoped` name, a list returns the
|
|
67
|
+
* same rows with or without a market. Absent is therefore a no-op on reads,
|
|
68
|
+
* not a "globals only" default.
|
|
69
|
+
*/
|
|
54
70
|
market?: string;
|
|
55
71
|
fetchImpl?: typeof fetch;
|
|
56
72
|
}
|
package/dist/index.js
CHANGED
|
@@ -356,8 +356,11 @@ function createRuntimeAdapter(config = {}) {
|
|
|
356
356
|
endpoint: env.REVENEXX_DATA_ENDPOINT || DEFAULT_DATA_ENDPOINT,
|
|
357
357
|
token: get("x-revenexx-context") || env.REVENEXX_CONTEXT || "",
|
|
358
358
|
tenant: get("x-revenexx-tenant") || env.REVENEXX_TENANT || "",
|
|
359
|
-
// Active market
|
|
360
|
-
//
|
|
359
|
+
// Active market forwarded to the data layer. It ASSIGNS the market on
|
|
360
|
+
// insert and filters reads only through a `*_scoped` view — generated
|
|
361
|
+
// entities read the base table, so on the app path a list is unaffected by
|
|
362
|
+
// it. See RemoteConfig.market; absent is a no-op on reads, not a narrower
|
|
363
|
+
// default.
|
|
361
364
|
market: get("x-revenexx-market") || env.REVENEXX_MARKET || ""
|
|
362
365
|
});
|
|
363
366
|
return { ...remote, kind: "runtime" };
|