@revenexx/app-sdk 1.5.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +92 -7
- package/dist/{chunk-PXQA7E4F.js → chunk-AVWPY5D2.js} +133 -31
- package/dist/chunk-AVWPY5D2.js.map +1 -0
- package/dist/{errors-CWT-wc8L.d.cts → errors-BsKwZ07u.d.cts} +15 -3
- package/dist/{errors-CWT-wc8L.d.ts → errors-BsKwZ07u.d.ts} +15 -3
- package/dist/index.cjs +129 -34
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +41 -5
- package/dist/index.js.map +1 -1
- package/dist/router/index.cjs +106 -30
- package/dist/router/index.cjs.map +1 -1
- package/dist/router/index.d.cts +49 -9
- package/dist/router/index.d.ts +49 -9
- package/dist/router/index.js +53 -21
- package/dist/router/index.js.map +1 -1
- package/package.json +1 -1
- package/dist/chunk-PXQA7E4F.js.map +0 -1
package/README.md
CHANGED
|
@@ -227,7 +227,22 @@ mountCrud(app, db.accounts, {
|
|
|
227
227
|
});
|
|
228
228
|
```
|
|
229
229
|
|
|
230
|
-
|
|
230
|
+
The columns an entity's schema flags add — the trash columns for `trash: true`,
|
|
231
|
+
`external_id` for `external_id: true` — are filters too, whether or not `columns`
|
|
232
|
+
names them. `mountCrud` reads the flags from the entity client (`db.notes`, also
|
|
233
|
+
when spread as `{ ...db.notes }`). A repo of your own that rebuilds the client's
|
|
234
|
+
methods carries no flags: pass `trash: true` / `external_id: true` as options —
|
|
235
|
+
otherwise its trash columns are guarded only when `columns` names `trash_batch`. A
|
|
236
|
+
flag is only ever added; `trash: false` does not switch off what the client says. A
|
|
237
|
+
key you claim in `queryParams` stays yours and is not a filter.
|
|
238
|
+
|
|
239
|
+
On a `trash: true` entity, `POST` / `PUT` refuse a body that sets a trash column
|
|
240
|
+
(`deleted_at`, `deleted_by`, `deleted_by_id`, `trash_batch`, `purge_blocked_reason`,
|
|
241
|
+
`null` included) with `400 read_only_field`, naming them in `details.fields`. Only the
|
|
242
|
+
trash routes (`mountTrash`) write them. `external_id` is written like any column.
|
|
243
|
+
|
|
244
|
+
Without `columns`, only the reserved and declared keys and the columns the flags
|
|
245
|
+
add are accepted. A list
|
|
231
246
|
that reads its own parameters can also stay a hand-written route
|
|
232
247
|
(`only: ['get', 'create', 'update', 'delete']` plus `app.get(base, …)`).
|
|
233
248
|
|
|
@@ -251,7 +266,7 @@ its own parameter (`queryParams`, or a hand-written list).
|
|
|
251
266
|
### The trash in one call
|
|
252
267
|
|
|
253
268
|
An entity with `trash: true` in `schema.json` gets the routes a trash needs from
|
|
254
|
-
`mountTrash
|
|
269
|
+
`mountTrash`:
|
|
255
270
|
|
|
256
271
|
```js
|
|
257
272
|
const refs = createGatewayCounter();
|
|
@@ -326,13 +341,65 @@ that only blew up at `res.json()` time, as a 500 with a raw Node message:
|
|
|
326
341
|
| condition | answer | code | message |
|
|
327
342
|
|---|---|---|---|
|
|
328
343
|
| `update` with a patch carrying no fields | `400` | `empty_update` | `request body must contain at least one field to update` |
|
|
344
|
+
| `create` with no fields | `400` | `empty_create` | `request body must contain at least one field to create` |
|
|
329
345
|
| `update` matched no row (deleted, or invisible under RLS) | `404` | `not_found` | `not found` |
|
|
330
346
|
| `create` returned no representation | `500` | `empty_representation` | `the record was created but could not be read back` |
|
|
347
|
+
| `create` / `update` / `updateIf` naming a key that is not a column | `400` | `unknown_field` | `unknown field 'x' — not a column of '<entity>'. …` |
|
|
348
|
+
| `create` / `update` / `updateIf` with a list instead of one record | `400` | `bad_request` | `a write takes one record, as a JSON object — not a list` |
|
|
331
349
|
|
|
332
350
|
The empty-patch rule lives in the data client, not in `mountCrud`, so it holds
|
|
333
351
|
for hand-written route handlers too. It is enforced before the request leaves
|
|
334
352
|
the App — an empty patch costs no round trip.
|
|
335
353
|
|
|
354
|
+
### A write names only the columns the App declares
|
|
355
|
+
|
|
356
|
+
`create`, `update` and `updateIf` check every key of the row against the
|
|
357
|
+
entity's generated `columns` before the request leaves the App. A key that is
|
|
358
|
+
not a column is refused — never dropped — with `400 unknown_field`, naming
|
|
359
|
+
every such key:
|
|
360
|
+
|
|
361
|
+
```
|
|
362
|
+
db.accounts.create({ name: 'Acme', frame_ancestors: '*' })
|
|
363
|
+
-> 400 {"error":"unknown field 'frame_ancestors' — not a column of 'accounts'. …",
|
|
364
|
+
"code":"unknown_field",
|
|
365
|
+
"details":{"unknown":["frame_ancestors"],"allowed":["created_at","id","name",…]}}
|
|
366
|
+
```
|
|
367
|
+
|
|
368
|
+
Why the SDK and not the database: during a rollout the new version's schema
|
|
369
|
+
is applied before the new code is served — with a release candidate, days
|
|
370
|
+
before the stable tenants move — and every running version shares one database
|
|
371
|
+
role. From that moment the database accepts the new column from the *old*
|
|
372
|
+
code too, which never validated it. Each version therefore writes only the
|
|
373
|
+
columns it was generated against.
|
|
374
|
+
|
|
375
|
+
- Only the top level is checked; a `jsonb` column takes any document.
|
|
376
|
+
- `tenant_id` is on every table without being declared and is accepted.
|
|
377
|
+
- The system columns the App declares in `schema.json` (`id`, `created_at`,
|
|
378
|
+
`updated_at`, …) are columns like any other.
|
|
379
|
+
- The columns a schema flag adds count as declared, whether or not the App
|
|
380
|
+
declares them as well: `trash: true` adds `deleted_at`, `deleted_by`,
|
|
381
|
+
`deleted_by_id`, `trash_batch` and `purge_blocked_reason`, `external_id: true`
|
|
382
|
+
adds `external_id`. The generated descriptor carries the flag; regenerate the
|
|
383
|
+
client (`revenexx apps generate`) with a CLI that writes it. Without the flag
|
|
384
|
+
the same keys are refused.
|
|
385
|
+
- A key whose value is `undefined` is not sent and not checked.
|
|
386
|
+
- A write is one record. A list — a non-empty array, as a JSON array body arrives
|
|
387
|
+
in `c.body`, or an object keyed exactly `0` … `n-1` — is refused with `400 bad_request` (`a write takes one record, as a JSON object —
|
|
388
|
+
not a list`): PostgREST would read it as a bulk insert, with keys the check never
|
|
389
|
+
saw. `POST` / `PUT` on a mounted collection refuse such a body the same way. An
|
|
390
|
+
empty array is an empty record.
|
|
391
|
+
- A create with no field (`{}`, `[]`, only `undefined` values) is refused with
|
|
392
|
+
`400 empty_create`, on both adapters: PostgREST would read `[]` as a bulk insert
|
|
393
|
+
of no rows and the App would answer `500`.
|
|
394
|
+
- An entity whose descriptor has no `columns` is not checked.
|
|
395
|
+
- `mountCrud` passes its body to the data client, so `POST` / `PUT` answer the
|
|
396
|
+
same `400`. A handler that accepts control keys of its own (an actor, a
|
|
397
|
+
market, the backdating `at`) removes them before it writes; for backdating,
|
|
398
|
+
`createApp({ backdating: { strip: true } })` removes every moment field the
|
|
399
|
+
route names (`at`, `placed_at`, …) on every request, gate open or closed.
|
|
400
|
+
- The `mock` and `remote` adapters refuse the same keys when used without the
|
|
401
|
+
client, so a test cannot pass on a write production refuses.
|
|
402
|
+
|
|
336
403
|
These are `HttpError`s: `@revenexx/app-sdk/router` turns them into the response
|
|
337
404
|
automatically. An App that routes itself must honour `err.status` in its
|
|
338
405
|
catch-all (`isHttpError(err) ? err.status : 500`), or it will report a 400 as a
|
|
@@ -352,10 +419,13 @@ on the wording:
|
|
|
352
419
|
| `conflict` | 409 | `conflict()` |
|
|
353
420
|
| `not_permitted` | 403 | an entity-client call the manifest does not grant |
|
|
354
421
|
| `empty_update` | 400 | `update` / `PUT` with nothing to update |
|
|
422
|
+
| `empty_create` | 400 | `create` / `POST` with nothing to create |
|
|
423
|
+
| `unknown_field` | 400 | `create` / `update` / `updateIf` (and `POST` / `PUT` on a mounted collection) with a key that is not a column |
|
|
355
424
|
| `empty_condition` | 400 | `updateIf` with an empty `where` |
|
|
356
425
|
| `undefined_condition` | 400 | a `where` entry left `undefined`, on any read or `updateIf` |
|
|
357
426
|
| `unknown_filter`, `unsupported_filter_operator`, `invalid_value` | 400 | a mounted list's querystring |
|
|
358
427
|
| `missing_parameter` | 400 | a `mountCrud` route without its path parameter |
|
|
428
|
+
| `read_only_field` | 400 | `POST` / `PUT` on a mounted `trash: true` entity setting a trash column |
|
|
359
429
|
| `trash_blocked`, `delete_blocked`, `already_in_trash`, `not_in_trash`, `parent_in_trash` | 409 | `mountTrash` routes |
|
|
360
430
|
| `not_permitted` | 403 | `mountTrash`'s final delete when `canDeleteForGood` refuses |
|
|
361
431
|
| `no_route` / `method_not_allowed` | 404 / 405 | the router |
|
|
@@ -408,13 +478,14 @@ before you write that line.
|
|
|
408
478
|
| field | is |
|
|
409
479
|
|---|---|
|
|
410
480
|
| `user` / `email` | the human the gateway authenticated, or `null`. `null` today |
|
|
411
|
-
| `contact` / `organization` | the `customers` contact they were resolved to, or `null` |
|
|
412
|
-
| `
|
|
481
|
+
| `contact` / `organization` | the `customers` contact they were resolved to, or `null`. Always `null` for a rep |
|
|
482
|
+
| `rep` | the sales rep's code when the gateway resolved a rep, or `null` |
|
|
483
|
+
| `permissions`, `holds(p)` | what the tenant's role provider grants that contact or rep |
|
|
413
484
|
| `trust` | `authenticated`, `asserted` or `none` |
|
|
414
|
-
| `plane` | `contact`, `operator` or `system` |
|
|
485
|
+
| `plane` | `rep`, `contact`, `operator` or `system` |
|
|
415
486
|
| `authenticated()` | shorthand for `trust === 'authenticated'`, and `false` for every caller today |
|
|
416
487
|
|
|
417
|
-
**
|
|
488
|
+
**Two planes produce somebody today, `contact` and `rep`, and both are `asserted`.** A storefront call is
|
|
418
489
|
made by a server holding the tenant API key on behalf of a customer: it *asserts*
|
|
419
490
|
the person, the gateway resolves the name through the tenant's role provider, and
|
|
420
491
|
`trust` is `asserted`. That is enough to stop a malicious end user and never a
|
|
@@ -439,6 +510,18 @@ with no contact and is likewise not produced today. Treating "no contact
|
|
|
439
510
|
resolved" as "must be the platform" reads an unknown customer as an
|
|
440
511
|
administrator, which is the mistake the field exists to prevent.
|
|
441
512
|
|
|
513
|
+
**`rep` is the merchant's sales rep** (ADR-0132). The rep portal's server asserts
|
|
514
|
+
`rep:<rep_code>`, the gateway resolves it through the `sales-reps` app's role
|
|
515
|
+
provider and sends `X-Revenexx-Caller: rep` with `X-Revenexx-Rep`, never the contact
|
|
516
|
+
headers. `plane` is `rep`, `rep` is the code, and `trust` is always `asserted`. Both
|
|
517
|
+
headers are needed: `rep` beside no code is no rep and holds no permission.
|
|
518
|
+
The gateway sends the code percent-encoded as UTF-8 (RFC 3986, as
|
|
519
|
+
`encodeURIComponent` writes it), because a rep code may be non-ASCII: `M%C3%9CLLER-01`
|
|
520
|
+
reads as `MÜLLER-01`. A value that does not decode is no rep. A call that says `rep` never
|
|
521
|
+
reads as a contact, with or without a code: contact headers beside it are ignored,
|
|
522
|
+
because a rep read as a contact would pass a buyer's per-row rules. Narrow a rep's
|
|
523
|
+
reads by their coverage, never by `contact`.
|
|
524
|
+
|
|
442
525
|
Every field comes from headers the gateway sets itself and strips from anything
|
|
443
526
|
a caller sends, so none of this can be talked up from outside. Never take the
|
|
444
527
|
acting person from the context token's claims — those describe the calling
|
|
@@ -522,7 +605,9 @@ app.post('/orders/place', async (c) => {
|
|
|
522
605
|
row.
|
|
523
606
|
- **The body.** Left as it came. `at` is a reserved body field in an App that
|
|
524
607
|
opts in; when a handler spreads its body into a row, pass `strip: true` and
|
|
525
|
-
the moment's fields are removed from `c.body` on
|
|
608
|
+
the moment's fields are removed from `c.body` on every request to a
|
|
609
|
+
backdatable route, whether the gate opened or not — the data client refuses a
|
|
610
|
+
key that is not a column.
|
|
526
611
|
|
|
527
612
|
Every App that opts in declares the setting in its `settings.json`:
|
|
528
613
|
|
|
@@ -68,11 +68,11 @@ function toParams(query = {}) {
|
|
|
68
68
|
const { where = {}, select, order, limit, offset } = query;
|
|
69
69
|
for (const [col, cond] of Object.entries(where)) {
|
|
70
70
|
if (Array.isArray(cond)) {
|
|
71
|
-
params.append(col, `in
|
|
71
|
+
params.append(col, `in.${inList(cond)}`);
|
|
72
72
|
} else if (cond && typeof cond === "object" && typeof cond.op === "string") {
|
|
73
73
|
const c = cond;
|
|
74
74
|
if (!OPS.has(c.op)) throw new Error(`query: unsupported operator '${c.op}'`);
|
|
75
|
-
const v = Array.isArray(c.value) ?
|
|
75
|
+
const v = Array.isArray(c.value) ? inList(c.value) : c.value;
|
|
76
76
|
params.append(col, `${c.op}.${v}`);
|
|
77
77
|
} else if (cond === null) {
|
|
78
78
|
params.append(col, "is.null");
|
|
@@ -86,6 +86,13 @@ function toParams(query = {}) {
|
|
|
86
86
|
if (Number.isInteger(offset)) params.set("offset", String(offset));
|
|
87
87
|
return params;
|
|
88
88
|
}
|
|
89
|
+
function inList(values) {
|
|
90
|
+
return `(${values.map(quoteListValue).join(",")})`;
|
|
91
|
+
}
|
|
92
|
+
function quoteListValue(v) {
|
|
93
|
+
if (v === null || v === void 0) return "null";
|
|
94
|
+
return `"${String(v).replace(/[\\"]/g, "\\$&")}"`;
|
|
95
|
+
}
|
|
89
96
|
function matches(row, where = {}) {
|
|
90
97
|
for (const [col, cond] of Object.entries(where)) {
|
|
91
98
|
const val = row[col] ?? null;
|
|
@@ -343,6 +350,117 @@ function createSettings(options = {}) {
|
|
|
343
350
|
|
|
344
351
|
// src/backdating.ts
|
|
345
352
|
import { AsyncLocalStorage } from "async_hooks";
|
|
353
|
+
|
|
354
|
+
// src/patch.ts
|
|
355
|
+
var EMPTY_UPDATE_MESSAGE = "request body must contain at least one field to update";
|
|
356
|
+
function updateFields(patch) {
|
|
357
|
+
if (!patch || typeof patch !== "object" || Array.isArray(patch)) return [];
|
|
358
|
+
return Object.keys(patch).filter(
|
|
359
|
+
(key) => patch[key] !== void 0
|
|
360
|
+
);
|
|
361
|
+
}
|
|
362
|
+
var EMPTY_CREATE_MESSAGE = "request body must contain at least one field to create";
|
|
363
|
+
function assertCreatable(data) {
|
|
364
|
+
if (updateFields(data).length === 0) throw badRequest(EMPTY_CREATE_MESSAGE, void 0, { code: "empty_create" });
|
|
365
|
+
}
|
|
366
|
+
function assertUpdatable(patch) {
|
|
367
|
+
if (updateFields(patch).length === 0) throw badRequest(EMPTY_UPDATE_MESSAGE, void 0, { code: "empty_update" });
|
|
368
|
+
}
|
|
369
|
+
var EMPTY_CONDITION_MESSAGE = "a conditional update needs at least one condition in where";
|
|
370
|
+
function assertCondition(where) {
|
|
371
|
+
if (!where || typeof where !== "object" || Array.isArray(where) || Object.keys(where).length === 0) {
|
|
372
|
+
throw badRequest(EMPTY_CONDITION_MESSAGE, void 0, { code: "empty_condition" });
|
|
373
|
+
}
|
|
374
|
+
assertDefined(where);
|
|
375
|
+
}
|
|
376
|
+
function assertDefined(where) {
|
|
377
|
+
if (!where || typeof where !== "object") return;
|
|
378
|
+
for (const [col, cond] of Object.entries(where)) {
|
|
379
|
+
if (cond === void 0) {
|
|
380
|
+
throw badRequest(`where.${col} is undefined \u2014 a condition needs a value`, void 0, { code: "undefined_condition" });
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
var IMPLICIT_COLUMNS = ["tenant_id"];
|
|
385
|
+
var TRASH_FLAG_COLUMNS = [
|
|
386
|
+
"deleted_at",
|
|
387
|
+
"deleted_by",
|
|
388
|
+
"deleted_by_id",
|
|
389
|
+
"trash_batch",
|
|
390
|
+
"purge_blocked_reason"
|
|
391
|
+
];
|
|
392
|
+
var EXTERNAL_ID_FLAG_COLUMNS = ["external_id"];
|
|
393
|
+
function flagColumns(entity) {
|
|
394
|
+
return [
|
|
395
|
+
...entity.trash === true ? TRASH_FLAG_COLUMNS : [],
|
|
396
|
+
...entity.external_id === true ? EXTERNAL_ID_FLAG_COLUMNS : []
|
|
397
|
+
];
|
|
398
|
+
}
|
|
399
|
+
function writableColumns(entity) {
|
|
400
|
+
return [.../* @__PURE__ */ new Set([...Object.keys(entity.columns ?? {}), ...flagColumns(entity)])].sort();
|
|
401
|
+
}
|
|
402
|
+
function unknownFields(entity, data) {
|
|
403
|
+
if (!checksFields(entity)) return [];
|
|
404
|
+
if (!data || typeof data !== "object" || Array.isArray(data)) return [];
|
|
405
|
+
const row = data;
|
|
406
|
+
const writable = /* @__PURE__ */ new Set([...writableColumns(entity), ...IMPLICIT_COLUMNS]);
|
|
407
|
+
return Object.keys(row).filter((key) => row[key] !== void 0 && !writable.has(key)).sort();
|
|
408
|
+
}
|
|
409
|
+
function checksFields(entity) {
|
|
410
|
+
return !!entity.columns && Object.keys(entity.columns).length > 0;
|
|
411
|
+
}
|
|
412
|
+
var ONE_RECORD_MESSAGE = "a write takes one record, as a JSON object \u2014 not a list";
|
|
413
|
+
function assertOneRecord(entity, data) {
|
|
414
|
+
if (checksFields(entity) && isList(data)) throw oneRecordRefusal();
|
|
415
|
+
}
|
|
416
|
+
var INDEX = /^(?:0|[1-9]\d*)$/;
|
|
417
|
+
function isList(data) {
|
|
418
|
+
if (!data || typeof data !== "object") return false;
|
|
419
|
+
if (Array.isArray(data)) return data.length > 0;
|
|
420
|
+
const keys = Object.keys(data);
|
|
421
|
+
return keys.length > 0 && keys.every((k) => INDEX.test(k) && Number(k) < keys.length);
|
|
422
|
+
}
|
|
423
|
+
function trashFieldsIn(entity, body) {
|
|
424
|
+
if (entity.trash !== true || !body || typeof body !== "object") return [];
|
|
425
|
+
const row = body;
|
|
426
|
+
return TRASH_FLAG_COLUMNS.filter((k) => Object.prototype.hasOwnProperty.call(row, k) && row[k] !== void 0).sort();
|
|
427
|
+
}
|
|
428
|
+
function assertNoTrashFields(entity, body) {
|
|
429
|
+
const fields = trashFieldsIn(entity, body);
|
|
430
|
+
if (fields.length === 0) return;
|
|
431
|
+
const quoted = fields.map((k) => `'${k}'`).join(", ");
|
|
432
|
+
throw badRequest(
|
|
433
|
+
`field${fields.length > 1 ? "s" : ""} ${quoted} ${fields.length > 1 ? "are" : "is"} kept by the trash \u2014 put a record into the trash, restore or purge it through the trash routes.`,
|
|
434
|
+
{ fields },
|
|
435
|
+
{ code: "read_only_field" }
|
|
436
|
+
);
|
|
437
|
+
}
|
|
438
|
+
var ENTITY_DESCRIPTOR = /* @__PURE__ */ Symbol.for("revenexx.app-sdk.entity");
|
|
439
|
+
function guardsTrash(stated, described, columns) {
|
|
440
|
+
if (stated === true || described === true) return true;
|
|
441
|
+
if (stated === void 0 && described === void 0) return !!columns && Object.prototype.hasOwnProperty.call(columns, "trash_batch");
|
|
442
|
+
return false;
|
|
443
|
+
}
|
|
444
|
+
function describedEntity(repo) {
|
|
445
|
+
if (!repo || typeof repo !== "object") return void 0;
|
|
446
|
+
return repo[ENTITY_DESCRIPTOR];
|
|
447
|
+
}
|
|
448
|
+
function oneRecordRefusal() {
|
|
449
|
+
return badRequest(ONE_RECORD_MESSAGE, void 0, { code: "bad_request" });
|
|
450
|
+
}
|
|
451
|
+
function assertKnownFields(entity, data) {
|
|
452
|
+
assertOneRecord(entity, data);
|
|
453
|
+
const unknown = unknownFields(entity, data);
|
|
454
|
+
if (unknown.length === 0) return;
|
|
455
|
+
const quoted = unknown.map((k) => `'${k}'`).join(", ");
|
|
456
|
+
throw badRequest(
|
|
457
|
+
`unknown field${unknown.length > 1 ? "s" : ""} ${quoted} \u2014 not a column of '${entity.name}'. A field that cannot be written is refused rather than dropped; see details.allowed.`,
|
|
458
|
+
{ unknown, allowed: writableColumns(entity) },
|
|
459
|
+
{ code: "unknown_field" }
|
|
460
|
+
);
|
|
461
|
+
}
|
|
462
|
+
|
|
463
|
+
// src/backdating.ts
|
|
346
464
|
var MAX_MONTHS_BACK = 24;
|
|
347
465
|
var BACKDATING_SETTING = "allow_backdating";
|
|
348
466
|
var BACKDATING_FIELD = "at";
|
|
@@ -443,7 +561,7 @@ function backdatingDb(db, entities) {
|
|
|
443
561
|
const member = Reflect.get(r, key, rr);
|
|
444
562
|
if (key !== "create" || typeof member !== "function") return member;
|
|
445
563
|
return (data, ...rest) => {
|
|
446
|
-
if (!backdated() || !data || typeof data !== "object" || Array.isArray(data)) {
|
|
564
|
+
if (!backdated() || !data || typeof data !== "object" || Array.isArray(data) || isList(data)) {
|
|
447
565
|
return member.call(r, data, ...rest);
|
|
448
566
|
}
|
|
449
567
|
const at = now();
|
|
@@ -461,33 +579,6 @@ function backdatingDb(db, entities) {
|
|
|
461
579
|
});
|
|
462
580
|
}
|
|
463
581
|
|
|
464
|
-
// src/patch.ts
|
|
465
|
-
var EMPTY_UPDATE_MESSAGE = "request body must contain at least one field to update";
|
|
466
|
-
function updateFields(patch) {
|
|
467
|
-
if (!patch || typeof patch !== "object" || Array.isArray(patch)) return [];
|
|
468
|
-
return Object.keys(patch).filter(
|
|
469
|
-
(key) => patch[key] !== void 0
|
|
470
|
-
);
|
|
471
|
-
}
|
|
472
|
-
function assertUpdatable(patch) {
|
|
473
|
-
if (updateFields(patch).length === 0) throw badRequest(EMPTY_UPDATE_MESSAGE, void 0, { code: "empty_update" });
|
|
474
|
-
}
|
|
475
|
-
var EMPTY_CONDITION_MESSAGE = "a conditional update needs at least one condition in where";
|
|
476
|
-
function assertCondition(where) {
|
|
477
|
-
if (!where || typeof where !== "object" || Array.isArray(where) || Object.keys(where).length === 0) {
|
|
478
|
-
throw badRequest(EMPTY_CONDITION_MESSAGE, void 0, { code: "empty_condition" });
|
|
479
|
-
}
|
|
480
|
-
assertDefined(where);
|
|
481
|
-
}
|
|
482
|
-
function assertDefined(where) {
|
|
483
|
-
if (!where || typeof where !== "object") return;
|
|
484
|
-
for (const [col, cond] of Object.entries(where)) {
|
|
485
|
-
if (cond === void 0) {
|
|
486
|
-
throw badRequest(`where.${col} is undefined \u2014 a condition needs a value`, void 0, { code: "undefined_condition" });
|
|
487
|
-
}
|
|
488
|
-
}
|
|
489
|
-
}
|
|
490
|
-
|
|
491
582
|
export {
|
|
492
583
|
HttpError,
|
|
493
584
|
isHttpError,
|
|
@@ -502,9 +593,20 @@ export {
|
|
|
502
593
|
matches,
|
|
503
594
|
EMPTY_UPDATE_MESSAGE,
|
|
504
595
|
updateFields,
|
|
596
|
+
assertCreatable,
|
|
505
597
|
assertUpdatable,
|
|
506
598
|
assertCondition,
|
|
507
599
|
assertDefined,
|
|
600
|
+
IMPLICIT_COLUMNS,
|
|
601
|
+
flagColumns,
|
|
602
|
+
assertOneRecord,
|
|
603
|
+
isList,
|
|
604
|
+
assertNoTrashFields,
|
|
605
|
+
ENTITY_DESCRIPTOR,
|
|
606
|
+
guardsTrash,
|
|
607
|
+
describedEntity,
|
|
608
|
+
oneRecordRefusal,
|
|
609
|
+
assertKnownFields,
|
|
508
610
|
DEFAULT_GATEWAY_ENDPOINT,
|
|
509
611
|
DEFAULT_SETTINGS_TTL_MS,
|
|
510
612
|
DEFAULT_SETTINGS_ERROR_TTL_MS,
|
|
@@ -524,4 +626,4 @@ export {
|
|
|
524
626
|
backdatingFields,
|
|
525
627
|
backdatingDb
|
|
526
628
|
};
|
|
527
|
-
//# sourceMappingURL=chunk-
|
|
629
|
+
//# sourceMappingURL=chunk-AVWPY5D2.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/errors.ts","../src/query.ts","../src/settings.ts","../src/backdating.ts","../src/patch.ts"],"sourcesContent":["/**\n * The one error representation every layer of the SDK agrees on.\n *\n * `HttpError` used to live in `./router/router.ts`. It moved here so the data\n * adapters can raise it too: an adapter that knows a PostgREST failure is a\n * duplicate key can say \"409\" without the router having to guess from a\n * message string.\n *\n * Two fields exist purely to keep internal database detail out of responses:\n * - `message` / `details` are the *client-facing* payload — always safe,\n * never derived from a database error body.\n * - `serverDetail` is the raw diagnosis. The router logs it and drops it; it\n * is never serialised into a response.\n */\n\nexport interface HttpErrorOptions {\n /** Stable machine-readable code (e.g. `unique_violation`). Safe to expose. */\n code?: string;\n /**\n * Raw diagnosis for server-side logs and traces only — may contain table and\n * constraint names. Never included in the HTTP response.\n */\n serverDetail?: unknown;\n}\n\n/** Throw inside a handler (or an adapter) to answer with a specific HTTP status. */\nexport class HttpError extends Error {\n readonly status: number;\n readonly details?: unknown;\n readonly code?: string;\n readonly serverDetail?: unknown;\n /**\n * Structural marker. `dist/index.cjs` and `dist/router/index.cjs` are separate\n * bundles, so an error thrown by the data client and caught by the router is\n * an instance of a *different* copy of this class — `instanceof` would be\n * false. Everything checks this flag via `isHttpError` instead.\n */\n readonly __isHttpError = true as const;\n\n constructor(status: number, message: string, details?: unknown, options: HttpErrorOptions = {}) {\n super(message);\n this.name = 'HttpError';\n this.status = status;\n if (details !== undefined) this.details = details;\n if (options.code !== undefined) this.code = options.code;\n if (options.serverDetail !== undefined) this.serverDetail = options.serverDetail;\n }\n}\n\n/** Duck-typed `instanceof HttpError` — survives the bundle split (see above). */\nexport function isHttpError(err: unknown): err is HttpError {\n if (!err || typeof err !== 'object') return false;\n const e = err as { __isHttpError?: unknown; name?: unknown; status?: unknown };\n return e.__isHttpError === true || (e.name === 'HttpError' && typeof e.status === 'number');\n}\n\n/*\n * The helpers carry a stable `code` (from 1.0), so every refusal the SDK or an App\n * raises through them is machine-readable. Pass `options.code` for a sharper one.\n */\nexport const notFound = (message = 'not found', options: HttpErrorOptions = {}): HttpError =>\n new HttpError(404, message, undefined, { code: 'not_found', ...options });\nexport const badRequest = (message = 'bad request', details?: unknown, options: HttpErrorOptions = {}): HttpError =>\n new HttpError(400, message, details, { code: 'bad_request', ...options });\nexport const forbidden = (message = 'forbidden', options: HttpErrorOptions = {}): HttpError =>\n new HttpError(403, message, undefined, { code: 'forbidden', ...options });\nexport const conflict = (message = 'conflict', options: HttpErrorOptions = {}): HttpError =>\n new HttpError(409, message, undefined, { code: 'conflict', ...options });\n\n/**\n * The body every refusal is answered with. `error` is the message (the router's\n * shape since 0.3); `message` and `type` repeat the message and the code under the\n * names the platform client (`@revenexx/sdk`) reads, so a caller that catches its\n * `RevenexxException` sees the App's reason as `err.message` and its code as\n * `err.type` instead of `undefined` (RAD-98).\n */\nexport function refusalBody(message: string, code?: string, details?: unknown): Record<string, unknown> {\n return {\n error: message,\n message,\n ...(code ? { code, type: code } : {}),\n ...(details != null ? { details } : {}),\n };\n}\n\n/** A refusal, whichever side raised it. */\nexport interface Refusal {\n /** HTTP status the refusal was answered with. */\n status: number;\n /** The refusing App's stable code, or null when it gave none. */\n code: string | null;\n /** Why, in words safe to show. */\n message: string;\n details: unknown;\n /** The App that answered, as the gateway tagged it; null for this App's own refusal. */\n app: string | null;\n}\n\n/**\n * Read a refusal out of whatever was thrown: this App's own `HttpError`, or the\n * exception the platform client (`@revenexx/sdk`) throws when another App refused a\n * call — whose `code` is the HTTP status and whose `response` is that App's body\n * verbatim. `null` for anything that is not a refusal (a crash, a network fault),\n * which is the distinction a caller needs: a question that could not be answered is\n * not the far side being down.\n */\nexport function refusalOf(err: unknown): Refusal | null {\n if (isHttpError(err)) {\n return { status: err.status, code: err.code ?? null, message: err.message, details: err.details ?? null, app: null };\n }\n if (!err || typeof err !== 'object') return null;\n const e = err as { code?: unknown; response?: unknown; message?: unknown; type?: unknown; app?: unknown };\n const status = typeof e.code === 'number' ? e.code : Number.NaN;\n if (!(status >= 400 && status <= 599) || typeof e.response !== 'string') return null;\n let body: Record<string, unknown> = {};\n try {\n const parsed: unknown = JSON.parse(e.response || '{}');\n if (parsed && typeof parsed === 'object' && !Array.isArray(parsed)) body = parsed as Record<string, unknown>;\n } catch {\n /* not JSON: fall back to what the exception itself carries */\n }\n const str = (v: unknown): string | null => (typeof v === 'string' && v !== '' ? v : null);\n return {\n status,\n code: str(body.code) ?? str(body.type) ?? str(e.type),\n message: str(body.error) ?? str(body.message) ?? str(e.message) ?? 'the call was refused',\n details: body.details ?? null,\n app: str(e.app),\n };\n}\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\nexport const OPS: ReadonlySet<FilterOp> = 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.${inList(cond)}`);\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) ? inList(c.value) : c.value;\n params.append(col, `${c.op}.${v}`);\n } else if (cond === null) {\n // `eq.null` compares against the string 'null'; the mock already reads a\n // null condition as \"is null\", and now the data plane does too.\n params.append(col, 'is.null');\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/**\n * A value list as PostgREST reads it: `(\"a\",\"b\")`. Every value is double-quoted\n * with `\\` and `\"` escaped, so a comma, a parenthesis, a quote or a backslash\n * inside a value stays part of that value instead of splitting the list or\n * breaking the filter. `null` stays the bare word `null`.\n */\nfunction inList(values: readonly unknown[]): string {\n return `(${values.map(quoteListValue).join(',')})`;\n}\n\nfunction quoteListValue(v: unknown): string {\n if (v === null || v === undefined) return 'null';\n return `\"${String(v).replace(/[\\\\\"]/g, '\\\\$&')}\"`;\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 // A column a row does not carry reads as null — in Postgres every row has\n // every column. Same as the PHP runtime.\n const val = row[col] ?? null;\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 * 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: [ … ], stored: [ … ] }\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 * ## Writing the app's OWN settings\n *\n * Some values have to be STORED, not merely declared — a platform service may\n * refuse to act on a default it cannot tell from \"nobody decided\". The app can\n * store them itself:\n *\n * const result = await settings.set(c, { locale_granularity: 'language' }, { ifAbsent: true });\n * // PATCH {gateway}/v1/settings/apps/{app}\n * // -> { ok, written: [...], kept: [...], ignored: [...] }\n *\n * The gateway lets an app write only its own settings, for the tenant its\n * request belongs to: it reads the app from the platform-signed\n * `x-revenexx-app-context` header the router hands every HTTP invocation, which\n * this reader forwards. A run started by an event or a schedule carries none,\n * so a write from there comes back `ok: false` — write from an HTTP route.\n * `ifAbsent` keeps every key the tenant already stored: use it for defaults,\n * so an install hook never undoes a merchant's choice. `stored` on a snapshot\n * says which keys are stored rather than defaulted.\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 /**\n * Keys whose value the tenant STORED (a tenant value, or the market's\n * override), as opposed to the declared default. A stored default and an\n * unset key resolve to the same value; this tells them apart. Empty on a\n * fallback, and from a gateway too old to say.\n */\n stored: 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 WriteOptions {\n /** Keep every key the tenant already stored; write only the missing ones. */\n ifAbsent?: boolean;\n}\n\n/** The outcome of `set()`. Key names only — the gateway never echoes values. */\nexport interface SettingsWriteResult {\n /** true when the gateway accepted the write (even if it wrote nothing). */\n ok: boolean;\n /** HTTP status of the gateway's answer; 0 when it was never asked or unreachable. */\n status: number;\n /** Keys stored by this write. */\n written: string[];\n /** Keys left alone because they were already stored (`ifAbsent`). */\n kept: string[];\n /** Keys dropped because the app's settings.json does not declare them. */\n ignored: string[];\n /** Why the write did not happen, when `ok` is false. */\n error?: 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/stored/provenance. */\n load(source?: SettingsSource, options?: ReadOptions): Promise<SettingsSnapshot<D>>;\n /**\n * Store this app's OWN tenant-level settings for the request's tenant.\n * Never throws: a refusal or an unreachable gateway is `ok: false`, also\n * reported to `onError`. A successful write drops the tenant's cached reads.\n */\n set(source: SettingsSource | undefined, values: Record<string, unknown>, options?: WriteOptions): Promise<SettingsWriteResult>;\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 stored?: unknown;\n}\n\nfunction stringList(value: unknown): string[] {\n return Array.isArray(value) ? value.filter((k): k is string => typeof k === 'string') : [];\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 stored: [],\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: stringList(body.masked),\n stored: stringList(body.stored),\n resolved: true,\n };\n }\n\n /** Drop every cached read for one tenant of this app (after a write). */\n const forgetTenant = (tenant: string, app: string): void => {\n const prefix = `${tenant}\\u0000${app}\\u0000`;\n for (const key of [...cache.keys()]) if (key.startsWith(prefix)) cache.delete(key);\n for (const key of [...lastGood.keys()]) if (key.startsWith(prefix)) lastGood.delete(key);\n };\n\n async function set(\n source: SettingsSource | undefined,\n values: Record<string, unknown>,\n writeOptions: WriteOptions = {},\n ): Promise<SettingsWriteResult> {\n const app = appName();\n const tenant = (source?.tenant ?? '') || headerOf(source, 'x-revenexx-tenant');\n const refused = (status: number, error: string): SettingsWriteResult => ({\n ok: false,\n status,\n written: [],\n kept: [],\n ignored: [],\n error,\n });\n\n // Nothing the gateway could accept — answer without a round trip.\n if (!app) return refused(0, 'no app name (pass `app` or set REVENEXX_APP_NAME)');\n if (!tenant) return refused(0, 'no tenant on the request');\n const appContext = headerOf(source, 'x-revenexx-app-context');\n if (!appContext) {\n return refused(0, 'no app context on the request — settings are written from an HTTP route, not an event or schedule run');\n }\n if (!values || typeof values !== 'object' || Array.isArray(values)) return refused(0, 'values must be an object');\n\n const f = options.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') return refused(0, 'settings: no fetch available (Node >=18 or pass fetchImpl)');\n\n const token = (source?.contextToken ?? '') || headerOf(source, 'x-revenexx-context');\n const headers: Record<string, string> = {\n Accept: 'application/json',\n 'Content-Type': 'application/json',\n 'X-Revenexx-Tenant': tenant,\n 'X-Revenexx-App-Context': appContext,\n };\n if (token) headers.Authorization = `Bearer ${token}`;\n\n try {\n const signal = timeoutSignal(timeoutMs);\n const res = await f(`${endpoint}/v1/settings/apps/${encodeURIComponent(app)}`, {\n method: 'PATCH',\n headers,\n body: JSON.stringify({ data: values, if_absent: writeOptions.ifAbsent === true }),\n ...(signal ? { signal } : {}),\n });\n const text = await res.text();\n let body: Record<string, unknown> = {};\n try {\n body = text ? (JSON.parse(text) as Record<string, unknown>) : {};\n } catch {\n body = {};\n }\n if (!res.ok) {\n const reason = typeof body.error === 'string' ? body.error : typeof body.message === 'string' ? body.message : '';\n const err = new Error(`settings: write ${res.status} for ${app}${reason ? ` — ${reason}` : ''}`) as Error & {\n status?: number;\n };\n err.status = res.status;\n report(err, { app, tenant, market: null });\n return refused(res.status, err.message);\n }\n const result: SettingsWriteResult = {\n ok: true,\n status: res.status,\n written: stringList(body.written),\n kept: stringList(body.kept),\n ignored: stringList(body.ignored),\n };\n if (result.written.length > 0) forgetTenant(tenant, app);\n return result;\n } catch (err: unknown) {\n const error = err instanceof Error ? err : new Error(String(err));\n report(error, { app, tenant, market: null });\n return refused(0, error.message);\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 set,\n async get(source?: SettingsSource, readOptions?: ReadOptions): Promise<ResolvedSettings<D>> {\n return (await load(source, readOptions)).settings;\n },\n clear(): void {\n cache.clear();\n lastGood.clear();\n },\n };\n}\n","/**\n * Backdating — replaying history into a test tenant (RAD-311).\n *\n * A simulator fills a test tenant with months of orders, payments and stock\n * movements. Everything an App stamps is \"now\", so without help the whole\n * history would land on the afternoon the simulator ran. An App that opts in\n * (`createApp({ backdating: true })`) lets a mutating request carry a past\n * moment in its body (`at`, or a route's own field) and runs the WHOLE request\n * on that clock: every `now()` the handler reads, every timestamp it writes,\n * and — through `backdatingDb` — the `created_at` of every row it creates.\n *\n * Only for a tenant whose admin switched it on: the App setting\n * `allow_backdating` (scope tenant, default off), read through `c.settings()`.\n * A settings service that cannot be reached hands back the declared defaults,\n * so an unreadable setting means off. The tenant has to be named twice and\n * agree: the `x-revenexx-tenant` header AND the `tenant_id` claim of the\n * forwarded identity token (`x-revenexx-context`). The header alone is not\n * enough — a caller reaching the function URL directly can set it. The claim is\n * not verified here; the data plane verifies the token on every read and write,\n * so a token claiming another tenant writes nothing at all.\n *\n * Without the gate the field is ignored, unread and unvalidated. With it the\n * moment must be an ISO 8601 date-time with a zone, not in the future and not\n * more than `MAX_MONTHS_BACK` months back; anything else is a 400 with code\n * `backdating_invalid`.\n *\n * The clock lives in an AsyncLocalStorage kept on `globalThis`, so the two\n * entry points (`@revenexx/app-sdk` and `@revenexx/app-sdk/router`, separate\n * bundles, each in ESM and CJS) read one and the same clock.\n */\n\nimport { AsyncLocalStorage } from 'node:async_hooks';\nimport { HttpError } from './errors.js';\nimport { isList } from './patch.js';\n\n/** How far back a backdated request may reach, in months. */\nexport const MAX_MONTHS_BACK = 24;\n\n/** The App setting that opens backdating for a tenant. */\nexport const BACKDATING_SETTING = 'allow_backdating';\n\n/** The body field every backdated route accepts. Reserved in Apps that opt in. */\nexport const BACKDATING_FIELD = 'at';\n\n/** The refusal code of a moment that cannot be honoured. */\nexport const BACKDATING_INVALID = 'backdating_invalid';\n\n/** The route methods `backdating: true` covers. */\nexport const BACKDATING_METHODS: readonly string[] = ['POST', 'PUT', 'PATCH', 'DELETE'];\n\n/**\n * `createApp({ backdating })`. `true` lets every mutating route (POST, PUT,\n * PATCH, DELETE) accept `at`; the object form does the same and refines it.\n */\nexport interface BackdatingOptions {\n /**\n * Per-route body fields that carry the moment, in precedence order, keyed\n * `METHOD /template` exactly as the route was registered:\n * `{ 'POST /orders/place': ['placed_at', 'at'] }`. `at` is always accepted —\n * appended last when the list does not name it. A route named here is\n * backdatable whatever its method.\n */\n routes?: Record<string, readonly string[]>;\n /** Routes (`METHOD /template`) that are never backdated. Wins over `routes`. */\n exclude?: readonly string[];\n /**\n * Remove the moment's fields from `c.body` before the handler runs, on every\n * request to a backdatable route — whether the gate opened or not. Default\n * false: the body is left as it came. Set it when a handler spreads its body\n * into a row: the data client refuses a key that is not a column.\n */\n strip?: boolean;\n}\n\ninterface ClockStore {\n at: string;\n}\n\nconst STORE_KEY = Symbol.for('@revenexx/app-sdk/backdating-clock');\n\nfunction clockStorage(): AsyncLocalStorage<ClockStore> {\n const g = globalThis as unknown as Record<symbol, AsyncLocalStorage<ClockStore> | undefined>;\n let storage = g[STORE_KEY];\n if (!storage) {\n storage = new AsyncLocalStorage<ClockStore>();\n g[STORE_KEY] = storage;\n }\n return storage;\n}\n\nconst CLOCK = clockStorage();\n\n/** The request's clock as an ISO string: the backdated moment while one runs, the wall clock otherwise. */\nexport const now = (): string => CLOCK.getStore()?.at ?? new Date().toISOString();\n\n/** The request's clock as a Date, for code that does arithmetic on it. */\nexport const clock = (): Date => new Date(now());\n\n/** True while a backdated request (or `runAt`) is running. */\nexport const backdated = (): boolean => Boolean(CLOCK.getStore()?.at);\n\n/**\n * Run `fn` on the clock `at` (a normalized ISO string). `null` runs it on the\n * wall clock. Everything `fn` awaits sees the same clock. For a job outside a\n * route — a replay worker — and for tests.\n */\nexport function runAt<T>(at: string | null | undefined, fn: () => T): T {\n return at ? CLOCK.run({ at }, fn) : fn();\n}\n\n/** Date-time with a zone, seconds and fraction optional. A bare date is not a moment. */\nconst ISO_DATE_TIME = /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}(?::\\d{2}(?:\\.\\d{1,9})?)?(?:Z|[+-]\\d{2}:?\\d{2})$/;\n\nconst invalid = (field: string, message: string): HttpError =>\n new HttpError(400, `'${field}' ${message}`, { field }, { code: BACKDATING_INVALID });\n\n/**\n * Check one requested moment and answer it normalized (UTC, `toISOString`).\n * Throws a 400 `backdating_invalid` naming `field` when it is not an ISO 8601\n * date-time with a zone, lies in the future, or lies more than\n * `MAX_MONTHS_BACK` months back. `reference` is the wall clock to measure\n * against (tests).\n */\nexport function parseBackdate(field: string, value: unknown, reference: Date = new Date()): string {\n const text = typeof value === 'string' ? value.trim() : '';\n if (!ISO_DATE_TIME.test(text)) throw invalid(field, 'must be an ISO 8601 date-time with a time zone');\n const at = new Date(text);\n if (Number.isNaN(at.getTime())) throw invalid(field, 'must be an ISO 8601 date-time with a time zone');\n if (at.getTime() > reference.getTime()) throw invalid(field, 'must not be in the future');\n const earliest = new Date(reference.getTime());\n earliest.setUTCMonth(earliest.getUTCMonth() - MAX_MONTHS_BACK);\n if (at.getTime() < earliest.getTime()) {\n throw invalid(field, `must not be more than ${MAX_MONTHS_BACK} months back`);\n }\n return at.toISOString();\n}\n\n/** What the gate reads off a request: the router's route context fits. */\nexport interface BackdatingSource {\n header?(name: string): string;\n contextToken?: string;\n settings?(): Promise<Record<string, unknown>>;\n}\n\n/** The `tenant_id` claim of a JWT, or '' (decoded, not verified). */\nfunction tokenTenant(token: unknown): string {\n const parts = typeof token === 'string' ? token.split('.') : [];\n if (parts.length < 2) return '';\n try {\n const payload = parts[1]!.replace(/-/g, '+').replace(/_/g, '/');\n const claims = JSON.parse(Buffer.from(payload, 'base64').toString('utf8')) as { tenant_id?: unknown } | null;\n return typeof claims?.tenant_id === 'string' ? claims.tenant_id.trim() : '';\n } catch {\n return '';\n }\n}\n\n/** `true`, or the text `'true'` a settings store may hand back, opens it. Nothing else does. */\nexport function settingAllowsBackdating(value: unknown): boolean {\n return value === true || (typeof value === 'string' && value.trim().toLowerCase() === 'true');\n}\n\n/**\n * Whether this request's tenant may backdate: the tenant header and the\n * identity token's `tenant_id` claim name the same tenant, and that tenant's\n * `allow_backdating` setting is on. Never throws; anything unreadable is false.\n */\nexport async function backdatingAllowed(c: BackdatingSource): Promise<boolean> {\n const read = (name: string): string => (typeof c?.header === 'function' ? String(c.header(name) ?? '').trim() : '');\n const header = read('x-revenexx-tenant');\n const claimed = tokenTenant(c?.contextToken || read('x-revenexx-context'));\n if (!header || header !== claimed) return false;\n if (typeof c?.settings !== 'function') return false;\n try {\n const settings = await c.settings();\n return settingAllowsBackdating(settings?.[BACKDATING_SETTING]);\n } catch {\n return false;\n }\n}\n\nconst present = (value: unknown): boolean => value !== undefined && value !== null && value !== '';\n\n/**\n * The moment a request asks for, or null. Reads nothing when no field is\n * present, resolves the gate next and returns null when it is closed, then\n * validates the first field present in `fields` order.\n */\nexport async function requestedMoment(\n c: BackdatingSource & { body?: Record<string, unknown> },\n fields: readonly string[],\n): Promise<string | null> {\n const body = c?.body;\n if (!body || typeof body !== 'object') return null;\n const field = fields.find((f) => present(body[f]));\n if (field === undefined) return null;\n if (!(await backdatingAllowed(c))) return null;\n return parseBackdate(field, body[field]);\n}\n\n/**\n * The fields a route reads its moment from under these options, or null when\n * the route is not backdatable. `key` is `METHOD /template`.\n */\nexport function backdatingFields(\n option: boolean | BackdatingOptions | undefined,\n method: string,\n template: string,\n): string[] | null {\n if (!option) return null;\n const opts: BackdatingOptions = option === true ? {} : option;\n const key = `${method.toUpperCase()} ${template}`;\n if (opts.exclude?.includes(key)) return null;\n const named = opts.routes?.[key];\n if (named) return named.includes(BACKDATING_FIELD) ? [...named] : [...named, BACKDATING_FIELD];\n return BACKDATING_METHODS.includes(method.toUpperCase()) ? [BACKDATING_FIELD] : null;\n}\n\n/** The part of an entity descriptor `backdatingDb` reads: does it have the column? */\nexport interface BackdatingEntity {\n columns?: Record<string, unknown>;\n}\n\n/**\n * The data client, with `created_at` (and `updated_at`, when the entity has\n * it) stamped on every row a backdated request creates. Outside a backdated\n * request it changes nothing: the database default stamps the row as always.\n * A value the caller set is kept. Only entities whose descriptor in `entities`\n * declares a `created_at` column are touched; pass the generated `ENTITIES`.\n *\n * const { createDb, ENTITIES } = require('./db.generated');\n * const db = backdatingDb(createDb(), ENTITIES);\n */\nexport function backdatingDb<T extends object>(db: T, entities: Record<string, BackdatingEntity | undefined>): T {\n const wrapped = new Map<string, unknown>();\n return new Proxy(db, {\n get(target, prop, receiver) {\n const value: unknown = Reflect.get(target, prop, receiver);\n if (typeof prop !== 'string') return value;\n const columns = entities?.[prop]?.columns;\n if (!columns || !('created_at' in columns) || !value || typeof value !== 'object') return value;\n const repo = value as { create?: unknown };\n if (typeof repo.create !== 'function') return value;\n if (!wrapped.has(prop)) {\n wrapped.set(\n prop,\n new Proxy(repo, {\n get(r, key, rr) {\n const member: unknown = Reflect.get(r, key, rr);\n if (key !== 'create' || typeof member !== 'function') return member;\n return (data: unknown, ...rest: unknown[]) => {\n if (!backdated() || !data || typeof data !== 'object' || Array.isArray(data) || isList(data)) {\n return (member as (...a: unknown[]) => unknown).call(r, data, ...rest);\n }\n const at = now();\n const row: Record<string, unknown> = { ...(data as Record<string, unknown>) };\n if (row.created_at === undefined) row.created_at = at;\n if ('updated_at' in columns && row.updated_at === undefined) row.updated_at = at;\n return (member as (...a: unknown[]) => unknown).call(r, row, ...rest);\n };\n },\n }),\n );\n }\n return wrapped.get(prop);\n },\n });\n}\n","/**\n * What counts as an update.\n *\n * PostgREST answers a `PATCH` whose body carries no columns with `200 []` — no\n * error, no representation. The adapter then hands `rows[0]` (i.e. `undefined`)\n * back as the updated row, and the App serialises it: open-runtimes does\n * `Buffer.from(JSON.stringify(obj), 'utf8')`, and `JSON.stringify(undefined)`\n * is `undefined`, so Node throws\n *\n * TypeError [ERR_INVALID_ARG_TYPE]: The first argument must be of type string\n * or an instance of Buffer, ArrayBuffer, or Array or an Array-like Object.\n * Received undefined\n *\n * which the App reports as a 500. A caller who sent nothing to update is told\n * the service is broken instead of what to send.\n *\n * The rule lives here, one level below the router, because not every App routes\n * its writes through `mountCrud`: `PUT /v1/greetings/{id}` and\n * `PUT /v1/payments/providers/{id}` are hand-written handlers that call\n * `db.<entity>.update()` directly, and they were the two endpoints that 500ed.\n * A guard in `mountCrud` alone only protects the Apps that happen to use it.\n */\n\nimport { badRequest } from './errors.js';\n\n/** The one wording every layer uses for \"you sent nothing to update\". */\nexport const EMPTY_UPDATE_MESSAGE = 'request body must contain at least one field to update';\n\n/**\n * The fields a patch would actually send. `undefined` values are excluded\n * because `JSON.stringify` drops them: `{ name: undefined }` reaches PostgREST\n * as `{}` and is exactly as empty as `{}` itself.\n */\nexport function updateFields(patch: unknown): string[] {\n if (!patch || typeof patch !== 'object' || Array.isArray(patch)) return [];\n return Object.keys(patch as Record<string, unknown>).filter(\n (key) => (patch as Record<string, unknown>)[key] !== undefined,\n );\n}\n\n/** The one wording every layer uses for \"you sent nothing to create\". */\nexport const EMPTY_CREATE_MESSAGE = 'request body must contain at least one field to create';\n\n/**\n * Throw a 400 `empty_create` when a create carries no field — `{}`, `[]`, or\n * only `undefined` values.\n *\n * The two adapters disagreed about it: the mock stored a row of defaults, the\n * remote adapter sent the body to PostgREST, which reads `[]` as a bulk insert\n * of no rows and answers `[]` — the App then reported `500\n * empty_representation`. PHP cannot tell `[]` from `{}`, so both are refused,\n * in both runtimes and on both adapters, before any request.\n */\nexport function assertCreatable(data: unknown): void {\n if (updateFields(data).length === 0) throw badRequest(EMPTY_CREATE_MESSAGE, undefined, { code: 'empty_create' });\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, undefined, { code: 'empty_update' });\n}\n\n/**\n * The one wording every layer uses for \"a conditional update with no condition\".\n *\n * `updateIf(id, {}, patch)` is an unconditional update spelled as a\n * conditional one — almost always a condition built from a variable that was\n * never set. Running it would let through the very race the caller reached\n * for `updateIf` to close, so it is refused; `update()` is the unconditional\n * write.\n */\nexport const EMPTY_CONDITION_MESSAGE = 'a conditional update needs at least one condition in where';\n\n/**\n * Throw a 400 when a `where` carries no condition, or one left `undefined`.\n *\n * An `undefined` entry is refused rather than dropped: dropping it would\n * quietly weaken the condition, and the two adapters would disagree about it\n * (`toParams` sends `eq.undefined`, `matches` compares against a missing key).\n */\nexport function assertCondition(where: unknown): void {\n if (!where || typeof where !== 'object' || Array.isArray(where) || Object.keys(where).length === 0) {\n throw badRequest(EMPTY_CONDITION_MESSAGE, undefined, { code: 'empty_condition' });\n }\n assertDefined(where);\n}\n\n/**\n * Throw a 400 when any `where` entry is `undefined` — on every read, not only a\n * conditional update. The two adapters disagree about one: `toParams` sends\n * `eq.undefined`, `matches` compares against a missing key. It is almost always\n * a variable that was never set, so it is refused rather than guessed at.\n */\nexport function assertDefined(where: unknown): void {\n if (!where || typeof where !== 'object') return;\n for (const [col, cond] of Object.entries(where as Record<string, unknown>)) {\n if (cond === undefined) {\n throw badRequest(`where.${col} is undefined — a condition needs a value`, undefined, { code: 'undefined_condition' });\n }\n }\n}\n\n/**\n * Columns every table has without declaring them in schema.json — Baseline\n * adds them, so the generated column list does not name them. Writing one is\n * left exactly as it was before the field check existed.\n */\nexport const IMPLICIT_COLUMNS: readonly string[] = ['tenant_id'];\n\n/**\n * The columns `trash: true` adds to an entity that does not declare them\n * itself: when the row went into the trash, who put it there (by name and by\n * subject id), the group it went with, and why it may not be purged yet.\n */\nexport const TRASH_FLAG_COLUMNS: readonly string[] = [\n 'deleted_at',\n 'deleted_by',\n 'deleted_by_id',\n 'trash_batch',\n 'purge_blocked_reason',\n];\n\n/** The column `external_id: true` adds to an entity that does not declare it. */\nexport const EXTERNAL_ID_FLAG_COLUMNS: readonly string[] = ['external_id'];\n\n/** The parts of an entity descriptor the field check reads. */\nexport interface WriteShape {\n name: string;\n columns?: Record<string, unknown>;\n trash?: boolean;\n external_id?: boolean;\n}\n\n/**\n * The columns Baseline adds for the entity's schema flags, whether or not the\n * App declares them as well. A column that exists in the table is a column\n * this version may write, even when the generated list only carries the flag.\n */\nexport function flagColumns(entity: Omit<WriteShape, 'name'>): string[] {\n return [\n ...(entity.trash === true ? TRASH_FLAG_COLUMNS : []),\n ...(entity.external_id === true ? EXTERNAL_ID_FLAG_COLUMNS : []),\n ];\n}\n\n/**\n * Every column a write may name, sorted: the declared columns plus the ones the\n * entity's flags add. `tenant_id` is accepted on top of these without being\n * listed, as before.\n */\nexport function writableColumns(entity: Omit<WriteShape, 'name'>): string[] {\n return [...new Set([...Object.keys(entity.columns ?? {}), ...flagColumns(entity)])].sort();\n}\n\n/**\n * The keys of a write that are not columns this version declares.\n *\n * A version writes only the columns it declares. The data plane cannot hold\n * that line on its own: during a rollout the new schema is applied before the\n * new code is served (and, with a release candidate, days before the stable\n * tenants move), and from that moment the old code can store a key it never\n * knew into the new column — without the validation the new version brings.\n * The generated `columns` are the list this version was built against, so a\n * key outside them is refused here, before the request.\n *\n * The columns an entity's `trash` and `external_id` flags add count as\n * declared: Baseline creates them from the flag, and an App that sets only the\n * flag still writes them (`mountTrash`, an import keeping the foreign key).\n *\n * Only the top level is checked: a `jsonb` column takes any document. A key\n * whose value is `undefined` is not sent (`JSON.stringify` drops it) and is\n * not checked. An entity without column metadata is not checked — there is\n * nothing to check against. A list is not a record and has no fields of its\n * own; `assertKnownFields` refuses it before this is asked.\n */\nexport function unknownFields(entity: Omit<WriteShape, 'name'>, data: unknown): string[] {\n if (!checksFields(entity)) return [];\n if (!data || typeof data !== 'object' || Array.isArray(data)) return [];\n const row = data as Record<string, unknown>;\n const writable = new Set([...writableColumns(entity), ...IMPLICIT_COLUMNS]);\n return Object.keys(row)\n .filter((key) => row[key] !== undefined && !writable.has(key))\n .sort();\n}\n\n/** Whether the entity carries the column metadata the field check reads. */\nfunction checksFields(entity: Omit<WriteShape, 'name'>): boolean {\n return !!entity.columns && Object.keys(entity.columns).length > 0;\n}\n\n/** The one wording every layer uses for \"a write takes one record\". */\nexport const ONE_RECORD_MESSAGE = 'a write takes one record, as a JSON object — not a list';\n\n/**\n * Throw a 400 `bad_request` when a write is a list rather than one record.\n *\n * `create` sends its data as the body of `POST /<table>`, and PostgREST reads a\n * JSON array there as a bulk insert: every element a row, every element's keys\n * columns. The field check reads the keys of one object, so a list slipped past\n * it with any key in any element — the rollout gap the check closes, reopened\n * one level down. The router hands an App a JSON array body unchanged, so a\n * handler that writes `db.x.create(c.body)` reached it from outside.\n *\n * Checked wherever the field check runs (an entity with column metadata), and\n * by `mountCrud` for every body it routes. What counts as a list is `isList`.\n */\nexport function assertOneRecord(entity: Omit<WriteShape, 'name'>, data: unknown): void {\n if (checksFields(entity) && isList(data)) throw oneRecordRefusal();\n}\n\nconst INDEX = /^(?:0|[1-9]\\d*)$/;\n\n/**\n * Whether a body is a list: a non-empty array, or a non-empty object whose keys\n * are exactly the indexes `0` … `n-1`, in any order.\n *\n * The definition is the one the PHP runtime can apply, and both use it: PHP\n * decodes `[…]` and `{\"0\":…}` to the same array, and `[]` to the same array as\n * `{}`. So an empty list is an empty record, and an object keyed by indexes is\n * a list.\n */\nexport function isList(data: unknown): boolean {\n if (!data || typeof data !== 'object') return false;\n if (Array.isArray(data)) return data.length > 0;\n const keys = Object.keys(data);\n return keys.length > 0 && keys.every((k) => INDEX.test(k) && Number(k) < keys.length);\n}\n\n/**\n * The columns `trash: true` adds are kept by the trash machinery — `mountTrash`\n * puts a record into the trash with its children, restores the group and\n * records why a purge waits. A body sent to a mounted collection that set them\n * would skip all of that: a record trashed with a forged `deleted_by`, or\n * restored and unblocked by `{\"deleted_at\": null, \"purge_blocked_reason\": null}`.\n * So `POST` / `PUT` of `mountCrud` refuse them on a trash entity, declared or\n * not; the data client still writes them for the trash routes.\n */\nexport function trashFieldsIn(entity: Omit<WriteShape, 'name'>, body: unknown): string[] {\n if (entity.trash !== true || !body || typeof body !== 'object') return [];\n const row = body as Record<string, unknown>;\n return TRASH_FLAG_COLUMNS.filter((k) => Object.prototype.hasOwnProperty.call(row, k) && row[k] !== undefined).sort();\n}\n\n/** Throw a 400 `read_only_field` when a mounted write sets a trash column. */\nexport function assertNoTrashFields(entity: Omit<WriteShape, 'name'>, body: unknown): void {\n const fields = trashFieldsIn(entity, body);\n if (fields.length === 0) return;\n const quoted = fields.map((k) => `'${k}'`).join(', ');\n throw badRequest(\n `field${fields.length > 1 ? 's' : ''} ${quoted} ${fields.length > 1 ? 'are' : 'is'} kept by the trash — ` +\n 'put a record into the trash, restore or purge it through the trash routes.',\n { fields },\n { code: 'read_only_field' },\n );\n}\n\n/**\n * The descriptor an entity client was built from, on a non-enumerable symbol\n * key, so `mountCrud` reads the entity's flags from the repo it is given, as\n * PHP's `Crud::mount` reads them from the `Entity`. `Symbol.for` keeps it the\n * same key across the ESM and CJS builds.\n */\nexport const ENTITY_DESCRIPTOR: unique symbol = Symbol.for('revenexx.app-sdk.entity') as never;\n\n/**\n * Whether a mounted collection keeps the trash columns out of bodies. Flags are\n * only ever added, never taken away: the repo's descriptor or `opts.trash`\n * turns it on, and `trash: false` cannot turn off what the descriptor says.\n * When neither states the flag — a repo of the App's own, wrapped or rebuilt —\n * a `trash_batch` among the columns, which only the trash machinery has, keeps\n * the guard on: unreadable fails closed.\n */\nexport function guardsTrash(stated: boolean | undefined, described: boolean | undefined, columns?: Record<string, unknown>): boolean {\n if (stated === true || described === true) return true;\n if (stated === undefined && described === undefined) return !!columns && Object.prototype.hasOwnProperty.call(columns, 'trash_batch');\n return false;\n}\n\n/** The descriptor behind a repo, when it is an entity client of this SDK. */\nexport function describedEntity(repo: unknown): Omit<WriteShape, 'name'> | undefined {\n if (!repo || typeof repo !== 'object') return undefined;\n return (repo as { [ENTITY_DESCRIPTOR]?: Omit<WriteShape, 'name'> })[ENTITY_DESCRIPTOR];\n}\n\n/** The refusal for a list where one record belongs. */\nexport function oneRecordRefusal() {\n return badRequest(ONE_RECORD_MESSAGE, undefined, { code: 'bad_request' });\n}\n\n/**\n * Throw a 400 `unknown_field` when a write carries a key that is not a column.\n * Refused, never dropped: dropping would turn a caller's mistake into lost\n * data with no signal. A list is refused first (`assertOneRecord`).\n */\nexport function assertKnownFields(entity: WriteShape, data: unknown): void {\n assertOneRecord(entity, data);\n const unknown = unknownFields(entity, data);\n if (unknown.length === 0) return;\n const quoted = unknown.map((k) => `'${k}'`).join(', ');\n throw badRequest(\n `unknown field${unknown.length > 1 ? 's' : ''} ${quoted} — not a column of '${entity.name}'. ` +\n 'A field that cannot be written is refused rather than dropped; see details.allowed.',\n { unknown, allowed: writableColumns(entity) },\n { code: 'unknown_field' },\n );\n}\n"],"mappings":";AA0BO,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;AAMO,IAAM,WAAW,CAAC,UAAU,aAAa,UAA4B,CAAC,MAC3E,IAAI,UAAU,KAAK,SAAS,QAAW,EAAE,MAAM,aAAa,GAAG,QAAQ,CAAC;AACnE,IAAM,aAAa,CAAC,UAAU,eAAe,SAAmB,UAA4B,CAAC,MAClG,IAAI,UAAU,KAAK,SAAS,SAAS,EAAE,MAAM,eAAe,GAAG,QAAQ,CAAC;AACnE,IAAM,YAAY,CAAC,UAAU,aAAa,UAA4B,CAAC,MAC5E,IAAI,UAAU,KAAK,SAAS,QAAW,EAAE,MAAM,aAAa,GAAG,QAAQ,CAAC;AACnE,IAAM,WAAW,CAAC,UAAU,YAAY,UAA4B,CAAC,MAC1E,IAAI,UAAU,KAAK,SAAS,QAAW,EAAE,MAAM,YAAY,GAAG,QAAQ,CAAC;AASlE,SAAS,YAAY,SAAiB,MAAe,SAA4C;AACtG,SAAO;AAAA,IACL,OAAO;AAAA,IACP;AAAA,IACA,GAAI,OAAO,EAAE,MAAM,MAAM,KAAK,IAAI,CAAC;AAAA,IACnC,GAAI,WAAW,OAAO,EAAE,QAAQ,IAAI,CAAC;AAAA,EACvC;AACF;AAuBO,SAAS,UAAU,KAA8B;AACtD,MAAI,YAAY,GAAG,GAAG;AACpB,WAAO,EAAE,QAAQ,IAAI,QAAQ,MAAM,IAAI,QAAQ,MAAM,SAAS,IAAI,SAAS,SAAS,IAAI,WAAW,MAAM,KAAK,KAAK;AAAA,EACrH;AACA,MAAI,CAAC,OAAO,OAAO,QAAQ,SAAU,QAAO;AAC5C,QAAM,IAAI;AACV,QAAM,SAAS,OAAO,EAAE,SAAS,WAAW,EAAE,OAAO,OAAO;AAC5D,MAAI,EAAE,UAAU,OAAO,UAAU,QAAQ,OAAO,EAAE,aAAa,SAAU,QAAO;AAChF,MAAI,OAAgC,CAAC;AACrC,MAAI;AACF,UAAM,SAAkB,KAAK,MAAM,EAAE,YAAY,IAAI;AACrD,QAAI,UAAU,OAAO,WAAW,YAAY,CAAC,MAAM,QAAQ,MAAM,EAAG,QAAO;AAAA,EAC7E,QAAQ;AAAA,EAER;AACA,QAAM,MAAM,CAAC,MAA+B,OAAO,MAAM,YAAY,MAAM,KAAK,IAAI;AACpF,SAAO;AAAA,IACL;AAAA,IACA,MAAM,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,KAAK,IAAI,EAAE,IAAI;AAAA,IACpD,SAAS,IAAI,KAAK,KAAK,KAAK,IAAI,KAAK,OAAO,KAAK,IAAI,EAAE,OAAO,KAAK;AAAA,IACnE,SAAS,KAAK,WAAW;AAAA,IACzB,KAAK,IAAI,EAAE,GAAG;AAAA,EAChB;AACF;;;ACzHO,IAAM,MAA6B,oBAAI,IAAc,CAAC,MAAM,OAAO,MAAM,OAAO,MAAM,OAAO,QAAQ,SAAS,MAAM,IAAI,CAAC;AAGzH,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,MAAM,OAAO,IAAI,CAAC,EAAE;AAAA,IACzC,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,OAAO,EAAE,KAAK,IAAI,EAAE;AACvD,aAAO,OAAO,KAAK,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;AAAA,IACnC,WAAW,SAAS,MAAM;AAGxB,aAAO,OAAO,KAAK,SAAS;AAAA,IAC9B,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;AAQA,SAAS,OAAO,QAAoC;AAClD,SAAO,IAAI,OAAO,IAAI,cAAc,EAAE,KAAK,GAAG,CAAC;AACjD;AAEA,SAAS,eAAe,GAAoB;AAC1C,MAAI,MAAM,QAAQ,MAAM,OAAW,QAAO;AAC1C,SAAO,IAAI,OAAO,CAAC,EAAE,QAAQ,UAAU,MAAM,CAAC;AAChD;AAGO,SAAS,QAAQ,KAAU,QAAwB,CAAC,GAAY;AACrE,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAG/C,UAAM,MAAM,IAAI,GAAG,KAAK;AACxB,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;;;ACrBO,IAAM,2BAA2B;AAcjC,IAAM,0BAA0B;AAWhC,IAAM,gCAAgC;AAGtC,IAAM,8BAA8B;AAkI3C,SAAS,WAAW,OAA0B;AAC5C,SAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,OAAO,CAAC,MAAmB,OAAO,MAAM,QAAQ,IAAI,CAAC;AAC3F;AAGA,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,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,WAAW,KAAK,MAAM;AAAA,MAC9B,QAAQ,WAAW,KAAK,MAAM;AAAA,MAC9B,UAAU;AAAA,IACZ;AAAA,EACF;AAGA,QAAM,eAAe,CAAC,QAAgB,QAAsB;AAC1D,UAAM,SAAS,GAAG,MAAM,KAAS,GAAG;AACpC,eAAW,OAAO,CAAC,GAAG,MAAM,KAAK,CAAC,EAAG,KAAI,IAAI,WAAW,MAAM,EAAG,OAAM,OAAO,GAAG;AACjF,eAAW,OAAO,CAAC,GAAG,SAAS,KAAK,CAAC,EAAG,KAAI,IAAI,WAAW,MAAM,EAAG,UAAS,OAAO,GAAG;AAAA,EACzF;AAEA,iBAAe,IACb,QACA,QACA,eAA6B,CAAC,GACA;AAC9B,UAAM,MAAM,QAAQ;AACpB,UAAM,UAAU,QAAQ,UAAU,OAAO,SAAS,QAAQ,mBAAmB;AAC7E,UAAM,UAAU,CAAC,QAAgB,WAAwC;AAAA,MACvE,IAAI;AAAA,MACJ;AAAA,MACA,SAAS,CAAC;AAAA,MACV,MAAM,CAAC;AAAA,MACP,SAAS,CAAC;AAAA,MACV;AAAA,IACF;AAGA,QAAI,CAAC,IAAK,QAAO,QAAQ,GAAG,mDAAmD;AAC/E,QAAI,CAAC,OAAQ,QAAO,QAAQ,GAAG,0BAA0B;AACzD,UAAM,aAAa,SAAS,QAAQ,wBAAwB;AAC5D,QAAI,CAAC,YAAY;AACf,aAAO,QAAQ,GAAG,4GAAuG;AAAA,IAC3H;AACA,QAAI,CAAC,UAAU,OAAO,WAAW,YAAY,MAAM,QAAQ,MAAM,EAAG,QAAO,QAAQ,GAAG,0BAA0B;AAEhH,UAAM,IAAI,QAAQ,aAAa,WAAW;AAC1C,QAAI,OAAO,MAAM,WAAY,QAAO,QAAQ,GAAG,4DAA4D;AAE3G,UAAM,SAAS,QAAQ,gBAAgB,OAAO,SAAS,QAAQ,oBAAoB;AACnF,UAAM,UAAkC;AAAA,MACtC,QAAQ;AAAA,MACR,gBAAgB;AAAA,MAChB,qBAAqB;AAAA,MACrB,0BAA0B;AAAA,IAC5B;AACA,QAAI,MAAO,SAAQ,gBAAgB,UAAU,KAAK;AAElD,QAAI;AACF,YAAM,SAAS,cAAc,SAAS;AACtC,YAAM,MAAM,MAAM,EAAE,GAAG,QAAQ,qBAAqB,mBAAmB,GAAG,CAAC,IAAI;AAAA,QAC7E,QAAQ;AAAA,QACR;AAAA,QACA,MAAM,KAAK,UAAU,EAAE,MAAM,QAAQ,WAAW,aAAa,aAAa,KAAK,CAAC;AAAA,QAChF,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;AAAA,MAC7B,CAAC;AACD,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,UAAI,OAAgC,CAAC;AACrC,UAAI;AACF,eAAO,OAAQ,KAAK,MAAM,IAAI,IAAgC,CAAC;AAAA,MACjE,QAAQ;AACN,eAAO,CAAC;AAAA,MACV;AACA,UAAI,CAAC,IAAI,IAAI;AACX,cAAM,SAAS,OAAO,KAAK,UAAU,WAAW,KAAK,QAAQ,OAAO,KAAK,YAAY,WAAW,KAAK,UAAU;AAC/G,cAAM,MAAM,IAAI,MAAM,mBAAmB,IAAI,MAAM,QAAQ,GAAG,GAAG,SAAS,WAAM,MAAM,KAAK,EAAE,EAAE;AAG/F,YAAI,SAAS,IAAI;AACjB,eAAO,KAAK,EAAE,KAAK,QAAQ,QAAQ,KAAK,CAAC;AACzC,eAAO,QAAQ,IAAI,QAAQ,IAAI,OAAO;AAAA,MACxC;AACA,YAAM,SAA8B;AAAA,QAClC,IAAI;AAAA,QACJ,QAAQ,IAAI;AAAA,QACZ,SAAS,WAAW,KAAK,OAAO;AAAA,QAChC,MAAM,WAAW,KAAK,IAAI;AAAA,QAC1B,SAAS,WAAW,KAAK,OAAO;AAAA,MAClC;AACA,UAAI,OAAO,QAAQ,SAAS,EAAG,cAAa,QAAQ,GAAG;AACvD,aAAO;AAAA,IACT,SAAS,KAAc;AACrB,YAAM,QAAQ,eAAe,QAAQ,MAAM,IAAI,MAAM,OAAO,GAAG,CAAC;AAChE,aAAO,OAAO,EAAE,KAAK,QAAQ,QAAQ,KAAK,CAAC;AAC3C,aAAO,QAAQ,GAAG,MAAM,OAAO;AAAA,IACjC;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,UAAMA,OAAM,KAAK,IAAI;AACrB,UAAM,MAAM,MAAM,IAAI,GAAG;AACzB,QAAI,OAAOA,OAAM,IAAI,KAAK,IAAI,IAAK,QAAO,IAAI;AAE9C,UAAM,SAAS,QAAQ,gBAAgB,OAAO,SAAS,QAAQ,oBAAoB;AACnF,UAAM,QAAkB,EAAE,IAAIA,MAAK,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;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;;;AC/cA,SAAS,yBAAyB;;;ACL3B,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,IAAM,uBAAuB;AAY7B,SAAS,gBAAgB,MAAqB;AACnD,MAAI,aAAa,IAAI,EAAE,WAAW,EAAG,OAAM,WAAW,sBAAsB,QAAW,EAAE,MAAM,eAAe,CAAC;AACjH;AAGO,SAAS,gBAAgB,OAAsB;AACpD,MAAI,aAAa,KAAK,EAAE,WAAW,EAAG,OAAM,WAAW,sBAAsB,QAAW,EAAE,MAAM,eAAe,CAAC;AAClH;AAWO,IAAM,0BAA0B;AAShC,SAAS,gBAAgB,OAAsB;AACpD,MAAI,CAAC,SAAS,OAAO,UAAU,YAAY,MAAM,QAAQ,KAAK,KAAK,OAAO,KAAK,KAAK,EAAE,WAAW,GAAG;AAClG,UAAM,WAAW,yBAAyB,QAAW,EAAE,MAAM,kBAAkB,CAAC;AAAA,EAClF;AACA,gBAAc,KAAK;AACrB;AAQO,SAAS,cAAc,OAAsB;AAClD,MAAI,CAAC,SAAS,OAAO,UAAU,SAAU;AACzC,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAgC,GAAG;AAC1E,QAAI,SAAS,QAAW;AACtB,YAAM,WAAW,SAAS,GAAG,kDAA6C,QAAW,EAAE,MAAM,sBAAsB,CAAC;AAAA,IACtH;AAAA,EACF;AACF;AAOO,IAAM,mBAAsC,CAAC,WAAW;AAOxD,IAAM,qBAAwC;AAAA,EACnD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,IAAM,2BAA8C,CAAC,aAAa;AAelE,SAAS,YAAY,QAA4C;AACtE,SAAO;AAAA,IACL,GAAI,OAAO,UAAU,OAAO,qBAAqB,CAAC;AAAA,IAClD,GAAI,OAAO,gBAAgB,OAAO,2BAA2B,CAAC;AAAA,EAChE;AACF;AAOO,SAAS,gBAAgB,QAA4C;AAC1E,SAAO,CAAC,GAAG,oBAAI,IAAI,CAAC,GAAG,OAAO,KAAK,OAAO,WAAW,CAAC,CAAC,GAAG,GAAG,YAAY,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK;AAC3F;AAuBO,SAAS,cAAc,QAAkC,MAAyB;AACvF,MAAI,CAAC,aAAa,MAAM,EAAG,QAAO,CAAC;AACnC,MAAI,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,EAAG,QAAO,CAAC;AACtE,QAAM,MAAM;AACZ,QAAM,WAAW,oBAAI,IAAI,CAAC,GAAG,gBAAgB,MAAM,GAAG,GAAG,gBAAgB,CAAC;AAC1E,SAAO,OAAO,KAAK,GAAG,EACnB,OAAO,CAAC,QAAQ,IAAI,GAAG,MAAM,UAAa,CAAC,SAAS,IAAI,GAAG,CAAC,EAC5D,KAAK;AACV;AAGA,SAAS,aAAa,QAA2C;AAC/D,SAAO,CAAC,CAAC,OAAO,WAAW,OAAO,KAAK,OAAO,OAAO,EAAE,SAAS;AAClE;AAGO,IAAM,qBAAqB;AAe3B,SAAS,gBAAgB,QAAkC,MAAqB;AACrF,MAAI,aAAa,MAAM,KAAK,OAAO,IAAI,EAAG,OAAM,iBAAiB;AACnE;AAEA,IAAM,QAAQ;AAWP,SAAS,OAAO,MAAwB;AAC7C,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,MAAI,MAAM,QAAQ,IAAI,EAAG,QAAO,KAAK,SAAS;AAC9C,QAAM,OAAO,OAAO,KAAK,IAAI;AAC7B,SAAO,KAAK,SAAS,KAAK,KAAK,MAAM,CAAC,MAAM,MAAM,KAAK,CAAC,KAAK,OAAO,CAAC,IAAI,KAAK,MAAM;AACtF;AAWO,SAAS,cAAc,QAAkC,MAAyB;AACvF,MAAI,OAAO,UAAU,QAAQ,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO,CAAC;AACxE,QAAM,MAAM;AACZ,SAAO,mBAAmB,OAAO,CAAC,MAAM,OAAO,UAAU,eAAe,KAAK,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,MAAS,EAAE,KAAK;AACrH;AAGO,SAAS,oBAAoB,QAAkC,MAAqB;AACzF,QAAM,SAAS,cAAc,QAAQ,IAAI;AACzC,MAAI,OAAO,WAAW,EAAG;AACzB,QAAM,SAAS,OAAO,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AACpD,QAAM;AAAA,IACJ,QAAQ,OAAO,SAAS,IAAI,MAAM,EAAE,IAAI,MAAM,IAAI,OAAO,SAAS,IAAI,QAAQ,IAAI;AAAA,IAElF,EAAE,OAAO;AAAA,IACT,EAAE,MAAM,kBAAkB;AAAA,EAC5B;AACF;AAQO,IAAM,oBAAmC,uBAAO,IAAI,yBAAyB;AAU7E,SAAS,YAAY,QAA6B,WAAgC,SAA4C;AACnI,MAAI,WAAW,QAAQ,cAAc,KAAM,QAAO;AAClD,MAAI,WAAW,UAAa,cAAc,OAAW,QAAO,CAAC,CAAC,WAAW,OAAO,UAAU,eAAe,KAAK,SAAS,aAAa;AACpI,SAAO;AACT;AAGO,SAAS,gBAAgB,MAAqD;AACnF,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,SAAQ,KAA4D,iBAAiB;AACvF;AAGO,SAAS,mBAAmB;AACjC,SAAO,WAAW,oBAAoB,QAAW,EAAE,MAAM,cAAc,CAAC;AAC1E;AAOO,SAAS,kBAAkB,QAAoB,MAAqB;AACzE,kBAAgB,QAAQ,IAAI;AAC5B,QAAM,UAAU,cAAc,QAAQ,IAAI;AAC1C,MAAI,QAAQ,WAAW,EAAG;AAC1B,QAAM,SAAS,QAAQ,IAAI,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,KAAK,IAAI;AACrD,QAAM;AAAA,IACJ,gBAAgB,QAAQ,SAAS,IAAI,MAAM,EAAE,IAAI,MAAM,4BAAuB,OAAO,IAAI;AAAA,IAEzF,EAAE,SAAS,SAAS,gBAAgB,MAAM,EAAE;AAAA,IAC5C,EAAE,MAAM,gBAAgB;AAAA,EAC1B;AACF;;;AD7QO,IAAM,kBAAkB;AAGxB,IAAM,qBAAqB;AAG3B,IAAM,mBAAmB;AAGzB,IAAM,qBAAqB;AAG3B,IAAM,qBAAwC,CAAC,QAAQ,OAAO,SAAS,QAAQ;AA8BtF,IAAM,YAAY,uBAAO,IAAI,oCAAoC;AAEjE,SAAS,eAA8C;AACrD,QAAM,IAAI;AACV,MAAI,UAAU,EAAE,SAAS;AACzB,MAAI,CAAC,SAAS;AACZ,cAAU,IAAI,kBAA8B;AAC5C,MAAE,SAAS,IAAI;AAAA,EACjB;AACA,SAAO;AACT;AAEA,IAAM,QAAQ,aAAa;AAGpB,IAAM,MAAM,MAAc,MAAM,SAAS,GAAG,OAAM,oBAAI,KAAK,GAAE,YAAY;AAGzE,IAAM,QAAQ,MAAY,IAAI,KAAK,IAAI,CAAC;AAGxC,IAAM,YAAY,MAAe,QAAQ,MAAM,SAAS,GAAG,EAAE;AAO7D,SAAS,MAAS,IAA+B,IAAgB;AACtE,SAAO,KAAK,MAAM,IAAI,EAAE,GAAG,GAAG,EAAE,IAAI,GAAG;AACzC;AAGA,IAAM,gBAAgB;AAEtB,IAAM,UAAU,CAAC,OAAe,YAC9B,IAAI,UAAU,KAAK,IAAI,KAAK,KAAK,OAAO,IAAI,EAAE,MAAM,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAS9E,SAAS,cAAc,OAAe,OAAgB,YAAkB,oBAAI,KAAK,GAAW;AACjG,QAAM,OAAO,OAAO,UAAU,WAAW,MAAM,KAAK,IAAI;AACxD,MAAI,CAAC,cAAc,KAAK,IAAI,EAAG,OAAM,QAAQ,OAAO,gDAAgD;AACpG,QAAM,KAAK,IAAI,KAAK,IAAI;AACxB,MAAI,OAAO,MAAM,GAAG,QAAQ,CAAC,EAAG,OAAM,QAAQ,OAAO,gDAAgD;AACrG,MAAI,GAAG,QAAQ,IAAI,UAAU,QAAQ,EAAG,OAAM,QAAQ,OAAO,2BAA2B;AACxF,QAAM,WAAW,IAAI,KAAK,UAAU,QAAQ,CAAC;AAC7C,WAAS,YAAY,SAAS,YAAY,IAAI,eAAe;AAC7D,MAAI,GAAG,QAAQ,IAAI,SAAS,QAAQ,GAAG;AACrC,UAAM,QAAQ,OAAO,yBAAyB,eAAe,cAAc;AAAA,EAC7E;AACA,SAAO,GAAG,YAAY;AACxB;AAUA,SAAS,YAAY,OAAwB;AAC3C,QAAM,QAAQ,OAAO,UAAU,WAAW,MAAM,MAAM,GAAG,IAAI,CAAC;AAC9D,MAAI,MAAM,SAAS,EAAG,QAAO;AAC7B,MAAI;AACF,UAAM,UAAU,MAAM,CAAC,EAAG,QAAQ,MAAM,GAAG,EAAE,QAAQ,MAAM,GAAG;AAC9D,UAAM,SAAS,KAAK,MAAM,OAAO,KAAK,SAAS,QAAQ,EAAE,SAAS,MAAM,CAAC;AACzE,WAAO,OAAO,QAAQ,cAAc,WAAW,OAAO,UAAU,KAAK,IAAI;AAAA,EAC3E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAGO,SAAS,wBAAwB,OAAyB;AAC/D,SAAO,UAAU,QAAS,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,YAAY,MAAM;AACxF;AAOA,eAAsB,kBAAkB,GAAuC;AAC7E,QAAM,OAAO,CAAC,SAA0B,OAAO,GAAG,WAAW,aAAa,OAAO,EAAE,OAAO,IAAI,KAAK,EAAE,EAAE,KAAK,IAAI;AAChH,QAAM,SAAS,KAAK,mBAAmB;AACvC,QAAM,UAAU,YAAY,GAAG,gBAAgB,KAAK,oBAAoB,CAAC;AACzE,MAAI,CAAC,UAAU,WAAW,QAAS,QAAO;AAC1C,MAAI,OAAO,GAAG,aAAa,WAAY,QAAO;AAC9C,MAAI;AACF,UAAM,WAAW,MAAM,EAAE,SAAS;AAClC,WAAO,wBAAwB,WAAW,kBAAkB,CAAC;AAAA,EAC/D,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAEA,IAAM,UAAU,CAAC,UAA4B,UAAU,UAAa,UAAU,QAAQ,UAAU;AAOhG,eAAsB,gBACpB,GACA,QACwB;AACxB,QAAM,OAAO,GAAG;AAChB,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAC9C,QAAM,QAAQ,OAAO,KAAK,CAAC,MAAM,QAAQ,KAAK,CAAC,CAAC,CAAC;AACjD,MAAI,UAAU,OAAW,QAAO;AAChC,MAAI,CAAE,MAAM,kBAAkB,CAAC,EAAI,QAAO;AAC1C,SAAO,cAAc,OAAO,KAAK,KAAK,CAAC;AACzC;AAMO,SAAS,iBACd,QACA,QACA,UACiB;AACjB,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,OAA0B,WAAW,OAAO,CAAC,IAAI;AACvD,QAAM,MAAM,GAAG,OAAO,YAAY,CAAC,IAAI,QAAQ;AAC/C,MAAI,KAAK,SAAS,SAAS,GAAG,EAAG,QAAO;AACxC,QAAM,QAAQ,KAAK,SAAS,GAAG;AAC/B,MAAI,MAAO,QAAO,MAAM,SAAS,gBAAgB,IAAI,CAAC,GAAG,KAAK,IAAI,CAAC,GAAG,OAAO,gBAAgB;AAC7F,SAAO,mBAAmB,SAAS,OAAO,YAAY,CAAC,IAAI,CAAC,gBAAgB,IAAI;AAClF;AAiBO,SAAS,aAA+B,IAAO,UAA2D;AAC/G,QAAM,UAAU,oBAAI,IAAqB;AACzC,SAAO,IAAI,MAAM,IAAI;AAAA,IACnB,IAAI,QAAQ,MAAM,UAAU;AAC1B,YAAM,QAAiB,QAAQ,IAAI,QAAQ,MAAM,QAAQ;AACzD,UAAI,OAAO,SAAS,SAAU,QAAO;AACrC,YAAM,UAAU,WAAW,IAAI,GAAG;AAClC,UAAI,CAAC,WAAW,EAAE,gBAAgB,YAAY,CAAC,SAAS,OAAO,UAAU,SAAU,QAAO;AAC1F,YAAM,OAAO;AACb,UAAI,OAAO,KAAK,WAAW,WAAY,QAAO;AAC9C,UAAI,CAAC,QAAQ,IAAI,IAAI,GAAG;AACtB,gBAAQ;AAAA,UACN;AAAA,UACA,IAAI,MAAM,MAAM;AAAA,YACd,IAAI,GAAG,KAAK,IAAI;AACd,oBAAM,SAAkB,QAAQ,IAAI,GAAG,KAAK,EAAE;AAC9C,kBAAI,QAAQ,YAAY,OAAO,WAAW,WAAY,QAAO;AAC7D,qBAAO,CAAC,SAAkB,SAAoB;AAC5C,oBAAI,CAAC,UAAU,KAAK,CAAC,QAAQ,OAAO,SAAS,YAAY,MAAM,QAAQ,IAAI,KAAK,OAAO,IAAI,GAAG;AAC5F,yBAAQ,OAAwC,KAAK,GAAG,MAAM,GAAG,IAAI;AAAA,gBACvE;AACA,sBAAM,KAAK,IAAI;AACf,sBAAM,MAA+B,EAAE,GAAI,KAAiC;AAC5E,oBAAI,IAAI,eAAe,OAAW,KAAI,aAAa;AACnD,oBAAI,gBAAgB,WAAW,IAAI,eAAe,OAAW,KAAI,aAAa;AAC9E,uBAAQ,OAAwC,KAAK,GAAG,KAAK,GAAG,IAAI;AAAA,cACtE;AAAA,YACF;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MACF;AACA,aAAO,QAAQ,IAAI,IAAI;AAAA,IACzB;AAAA,EACF,CAAC;AACH;","names":["now"]}
|
|
@@ -39,6 +39,17 @@ interface Entity {
|
|
|
39
39
|
pk: string;
|
|
40
40
|
columns?: Record<string, ColumnDef>;
|
|
41
41
|
ops?: Op[] | Set<Op>;
|
|
42
|
+
/**
|
|
43
|
+
* schema.json `trash: true`. Baseline then adds `deleted_at`, `deleted_by`,
|
|
44
|
+
* `deleted_by_id`, `trash_batch` and `purge_blocked_reason`, and a write may
|
|
45
|
+
* name them even when `columns` does not list them.
|
|
46
|
+
*/
|
|
47
|
+
trash?: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* schema.json `external_id: true`. Baseline then adds `external_id`, and a
|
|
50
|
+
* write may name it even when `columns` does not list it.
|
|
51
|
+
*/
|
|
52
|
+
external_id?: boolean;
|
|
42
53
|
}
|
|
43
54
|
type Row = Record<string, unknown>;
|
|
44
55
|
/** A page of rows plus the total count of matching rows (ignoring limit/offset). */
|
|
@@ -406,9 +417,10 @@ interface BackdatingOptions {
|
|
|
406
417
|
/** Routes (`METHOD /template`) that are never backdated. Wins over `routes`. */
|
|
407
418
|
exclude?: readonly string[];
|
|
408
419
|
/**
|
|
409
|
-
* Remove the moment's fields from `c.body` before the handler runs, on
|
|
410
|
-
*
|
|
411
|
-
*
|
|
420
|
+
* Remove the moment's fields from `c.body` before the handler runs, on every
|
|
421
|
+
* request to a backdatable route — whether the gate opened or not. Default
|
|
422
|
+
* false: the body is left as it came. Set it when a handler spreads its body
|
|
423
|
+
* into a row: the data client refuses a key that is not a column.
|
|
412
424
|
*/
|
|
413
425
|
strip?: boolean;
|
|
414
426
|
}
|
|
@@ -39,6 +39,17 @@ interface Entity {
|
|
|
39
39
|
pk: string;
|
|
40
40
|
columns?: Record<string, ColumnDef>;
|
|
41
41
|
ops?: Op[] | Set<Op>;
|
|
42
|
+
/**
|
|
43
|
+
* schema.json `trash: true`. Baseline then adds `deleted_at`, `deleted_by`,
|
|
44
|
+
* `deleted_by_id`, `trash_batch` and `purge_blocked_reason`, and a write may
|
|
45
|
+
* name them even when `columns` does not list them.
|
|
46
|
+
*/
|
|
47
|
+
trash?: boolean;
|
|
48
|
+
/**
|
|
49
|
+
* schema.json `external_id: true`. Baseline then adds `external_id`, and a
|
|
50
|
+
* write may name it even when `columns` does not list it.
|
|
51
|
+
*/
|
|
52
|
+
external_id?: boolean;
|
|
42
53
|
}
|
|
43
54
|
type Row = Record<string, unknown>;
|
|
44
55
|
/** A page of rows plus the total count of matching rows (ignoring limit/offset). */
|
|
@@ -406,9 +417,10 @@ interface BackdatingOptions {
|
|
|
406
417
|
/** Routes (`METHOD /template`) that are never backdated. Wins over `routes`. */
|
|
407
418
|
exclude?: readonly string[];
|
|
408
419
|
/**
|
|
409
|
-
* Remove the moment's fields from `c.body` before the handler runs, on
|
|
410
|
-
*
|
|
411
|
-
*
|
|
420
|
+
* Remove the moment's fields from `c.body` before the handler runs, on every
|
|
421
|
+
* request to a backdatable route — whether the gate opened or not. Default
|
|
422
|
+
* false: the body is left as it came. Set it when a handler spreads its body
|
|
423
|
+
* into a row: the data client refuses a key that is not a column.
|
|
412
424
|
*/
|
|
413
425
|
strip?: boolean;
|
|
414
426
|
}
|