@revenexx/app-sdk 1.1.0 → 1.2.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 +95 -2
- package/dist/index.cjs +10 -1
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +11 -1
- package/dist/index.d.ts +11 -1
- package/dist/index.js +10 -1
- package/dist/index.js.map +1 -1
- package/dist/router/index.cjs +281 -0
- package/dist/router/index.cjs.map +1 -1
- package/dist/router/index.d.cts +279 -3
- package/dist/router/index.d.ts +279 -3
- package/dist/router/index.js +271 -0
- package/dist/router/index.js.map +1 -1
- package/package.json +1 -1
package/dist/router/index.js
CHANGED
|
@@ -98,6 +98,19 @@ function actorFrom(header) {
|
|
|
98
98
|
};
|
|
99
99
|
}
|
|
100
100
|
|
|
101
|
+
// src/router/market.ts
|
|
102
|
+
var MARKET_HEADERS = {
|
|
103
|
+
code: "x-revenexx-market",
|
|
104
|
+
country: "x-revenexx-market-country"
|
|
105
|
+
};
|
|
106
|
+
var COUNTRY = /^[A-Z]{2}$/;
|
|
107
|
+
function marketFrom(header) {
|
|
108
|
+
const code = (header(MARKET_HEADERS.code) ?? "").trim() || null;
|
|
109
|
+
const raw = (header(MARKET_HEADERS.country) ?? "").trim();
|
|
110
|
+
const country = code && COUNTRY.test(raw) ? raw : null;
|
|
111
|
+
return { code, country };
|
|
112
|
+
}
|
|
113
|
+
|
|
101
114
|
// src/router/router.ts
|
|
102
115
|
var splitPath = (path) => path.split("/").filter(Boolean);
|
|
103
116
|
function compileTemplate(template) {
|
|
@@ -279,6 +292,7 @@ function createApp(options = {}) {
|
|
|
279
292
|
contextToken,
|
|
280
293
|
header: (name) => headerOf(headers, name),
|
|
281
294
|
actor: actorFrom((name) => headerOf(headers, name)),
|
|
295
|
+
market: marketFrom((name) => headerOf(headers, name)),
|
|
282
296
|
log,
|
|
283
297
|
json: (data, statusCode = 200) => res.json(data, statusCode),
|
|
284
298
|
// The market rides on the request, so a market-scoped setting
|
|
@@ -448,23 +462,280 @@ function mountCrud(app, repo, opts) {
|
|
|
448
462
|
}
|
|
449
463
|
return app;
|
|
450
464
|
}
|
|
465
|
+
|
|
466
|
+
// src/router/trash.ts
|
|
467
|
+
import { randomUUID } from "crypto";
|
|
468
|
+
var TRASH_COLUMN = "deleted_at";
|
|
469
|
+
var DEFAULT_TRASH_RETENTION_DAYS = 90;
|
|
470
|
+
var PURGE_REASON_COLUMN = "purge_blocked_reason";
|
|
471
|
+
var AUDIT_SETTINGS_PATH = "/v1/audit/settings";
|
|
472
|
+
var PAGE = 200;
|
|
473
|
+
var isTrashed = (row) => row[TRASH_COLUMN] !== null && row[TRASH_COLUMN] !== void 0;
|
|
474
|
+
var idOf = (row, fallback) => String(row.id ?? fallback);
|
|
475
|
+
async function listAll(repo, where) {
|
|
476
|
+
const rows = [];
|
|
477
|
+
for (; ; ) {
|
|
478
|
+
const batch = await repo.list({ where, limit: PAGE, offset: rows.length });
|
|
479
|
+
rows.push(...batch);
|
|
480
|
+
if (batch.length < PAGE) return rows;
|
|
481
|
+
}
|
|
482
|
+
}
|
|
483
|
+
async function runCheck(check, row, caller) {
|
|
484
|
+
if (!check) return [];
|
|
485
|
+
try {
|
|
486
|
+
const out = await check(row, caller);
|
|
487
|
+
const list = Array.isArray(out) ? out : [out];
|
|
488
|
+
return list.filter((b) => Boolean(b && typeof b.reason === "string"));
|
|
489
|
+
} catch (err) {
|
|
490
|
+
return [
|
|
491
|
+
{
|
|
492
|
+
reason: `could not be checked: ${err instanceof Error ? err.message : String(err)}`,
|
|
493
|
+
code: "unverifiable"
|
|
494
|
+
}
|
|
495
|
+
];
|
|
496
|
+
}
|
|
497
|
+
}
|
|
498
|
+
var refuse = (status, message, code, details) => new HttpError(status, message, details, { code });
|
|
499
|
+
function headerFrom(caller, name) {
|
|
500
|
+
if (typeof caller.header === "function") {
|
|
501
|
+
const v = caller.header(name);
|
|
502
|
+
if (typeof v === "string" && v !== "") return v;
|
|
503
|
+
}
|
|
504
|
+
const want = name.toLowerCase();
|
|
505
|
+
for (const bag of [caller.req?.headers, caller.headers]) {
|
|
506
|
+
if (!bag) continue;
|
|
507
|
+
for (const [k, v] of Object.entries(bag)) if (k.toLowerCase() === want && typeof v === "string" && v !== "") return v;
|
|
508
|
+
}
|
|
509
|
+
return "";
|
|
510
|
+
}
|
|
511
|
+
function auditSettingsUrl(options = {}) {
|
|
512
|
+
const env = options.env ?? process.env;
|
|
513
|
+
const url = options.url || env.REVENEXX_AUDIT_SETTINGS_URL;
|
|
514
|
+
if (url) return url;
|
|
515
|
+
const endpoint = String(options.endpoint || env.REVENEXX_GATEWAY_ENDPOINT || DEFAULT_GATEWAY_ENDPOINT).replace(/\/+$/, "");
|
|
516
|
+
return `${endpoint}${AUDIT_SETTINGS_PATH}`;
|
|
517
|
+
}
|
|
518
|
+
async function readTrashRetention(caller, options = {}) {
|
|
519
|
+
const url = auditSettingsUrl(options);
|
|
520
|
+
const f = options.fetchImpl ?? globalThis.fetch;
|
|
521
|
+
const tenant = (caller.tenant ?? "") || headerFrom(caller, "x-revenexx-tenant");
|
|
522
|
+
if (!tenant) throw new Error("trash retention: no tenant");
|
|
523
|
+
const token = (caller.contextToken ?? "") || headerFrom(caller, "x-revenexx-context");
|
|
524
|
+
const headers = { Accept: "application/json", "X-Revenexx-Tenant": tenant };
|
|
525
|
+
if (token) headers.Authorization = `Bearer ${token}`;
|
|
526
|
+
const signal = AbortSignal.timeout?.(options.timeoutMs ?? 5e3);
|
|
527
|
+
const res = await f(url, { method: "GET", headers, ...signal ? { signal } : {} });
|
|
528
|
+
if (!res.ok) throw new Error(`trash retention: ${res.status} from ${AUDIT_SETTINGS_PATH}`);
|
|
529
|
+
const body = await res.json();
|
|
530
|
+
const days = body.trash_retention_days;
|
|
531
|
+
return typeof days === "number" && Number.isInteger(days) && days > 0 ? days : DEFAULT_TRASH_RETENTION_DAYS;
|
|
532
|
+
}
|
|
533
|
+
function mountTrash(app, repo, opts) {
|
|
534
|
+
const base = opts.path.replace(/\/+$/, "");
|
|
535
|
+
const idParam = opts.idParam ?? "id";
|
|
536
|
+
const children = opts.children ?? [];
|
|
537
|
+
const now = opts.now ?? (() => /* @__PURE__ */ new Date());
|
|
538
|
+
const reasonColumn = opts.purgeReasonColumn === false ? null : opts.purgeReasonColumn ?? PURGE_REASON_COLUMN;
|
|
539
|
+
const load = async (id) => {
|
|
540
|
+
if (!id) throw refuse(400, `missing path parameter '${idParam}'`, "missing_parameter");
|
|
541
|
+
const row = await repo.get(id);
|
|
542
|
+
if (!row) throw notFound();
|
|
543
|
+
return row;
|
|
544
|
+
};
|
|
545
|
+
const emit = async (name, data, topicId) => {
|
|
546
|
+
if (!name || !opts.events) return;
|
|
547
|
+
await opts.events.emit(name, data, { topicId });
|
|
548
|
+
};
|
|
549
|
+
async function trash(id, caller) {
|
|
550
|
+
const row = await load(id);
|
|
551
|
+
if (isTrashed(row)) throw refuse(409, "this record is already in the trash", "already_in_trash");
|
|
552
|
+
const blockers = await runCheck(opts.guard, row, caller);
|
|
553
|
+
if (blockers.length) {
|
|
554
|
+
throw refuse(409, `cannot go into the trash: ${blockers.map((b) => b.reason).join("; ")}`, "trash_blocked", { blockers });
|
|
555
|
+
}
|
|
556
|
+
const batch = randomUUID();
|
|
557
|
+
const fields = {
|
|
558
|
+
[TRASH_COLUMN]: now().toISOString(),
|
|
559
|
+
deleted_by: caller.actor?.email ?? caller.actor?.user ?? null,
|
|
560
|
+
deleted_by_id: caller.actor?.user ?? caller.actor?.contact ?? null,
|
|
561
|
+
trash_batch: batch
|
|
562
|
+
};
|
|
563
|
+
await repo.update(id, fields);
|
|
564
|
+
const took = {};
|
|
565
|
+
for (const child of children) {
|
|
566
|
+
const rows = await listAll(child.repo, { [child.column]: id, [TRASH_COLUMN]: null });
|
|
567
|
+
for (const r of rows) await child.repo.update(String(r.id), fields);
|
|
568
|
+
took[child.name] = rows.length;
|
|
569
|
+
}
|
|
570
|
+
await emit(opts.events?.trashed, { id, batch, took }, idOf(row, id));
|
|
571
|
+
return { id, batch, took };
|
|
572
|
+
}
|
|
573
|
+
async function restore(id, caller) {
|
|
574
|
+
void caller;
|
|
575
|
+
const row = await load(id);
|
|
576
|
+
if (!isTrashed(row)) throw refuse(409, "this record is not in the trash", "not_in_trash");
|
|
577
|
+
if (opts.parent) {
|
|
578
|
+
const parentId = row[opts.parent.column];
|
|
579
|
+
const parent = parentId == null ? null : await opts.parent.repo.get(String(parentId));
|
|
580
|
+
if (parent && isTrashed(parent)) {
|
|
581
|
+
throw refuse(409, "its parent is in the trash \u2014 restore the parent first", "parent_in_trash", {
|
|
582
|
+
parent: String(parentId)
|
|
583
|
+
});
|
|
584
|
+
}
|
|
585
|
+
}
|
|
586
|
+
const fields = { [TRASH_COLUMN]: null, deleted_by: null, deleted_by_id: null, trash_batch: null };
|
|
587
|
+
await repo.update(id, reasonColumn ? { ...fields, [reasonColumn]: null } : fields);
|
|
588
|
+
const took = {};
|
|
589
|
+
const batch = row.trash_batch;
|
|
590
|
+
for (const child of children) {
|
|
591
|
+
const rows = batch == null ? [] : await listAll(child.repo, { [child.column]: id, trash_batch: batch });
|
|
592
|
+
for (const r of rows) await child.repo.update(String(r.id), fields);
|
|
593
|
+
took[child.name] = rows.length;
|
|
594
|
+
}
|
|
595
|
+
await emit(opts.events?.restored, { id, took }, idOf(row, id));
|
|
596
|
+
return { id, took };
|
|
597
|
+
}
|
|
598
|
+
async function finalDelete(row, id, caller) {
|
|
599
|
+
const took = {};
|
|
600
|
+
const batch = row.trash_batch;
|
|
601
|
+
for (const child of children) {
|
|
602
|
+
const rows = batch == null ? [] : await listAll(child.repo, { [child.column]: id, trash_batch: batch });
|
|
603
|
+
for (const r of rows) await child.repo.delete(String(r.id));
|
|
604
|
+
took[child.name] = rows.length;
|
|
605
|
+
}
|
|
606
|
+
if (opts.deleteRow) await opts.deleteRow(row, caller);
|
|
607
|
+
else await repo.delete(id);
|
|
608
|
+
return { id, took };
|
|
609
|
+
}
|
|
610
|
+
async function deleteForGood(id, caller) {
|
|
611
|
+
const row = await load(id);
|
|
612
|
+
if (!isTrashed(row)) throw refuse(409, "only a record in the trash can be deleted for good", "not_in_trash");
|
|
613
|
+
if (opts.canDeleteForGood && !opts.canDeleteForGood(caller)) {
|
|
614
|
+
throw refuse(403, "deleting for good needs its own permission", "not_permitted");
|
|
615
|
+
}
|
|
616
|
+
const blockers = await runCheck(opts.blockers, row, caller);
|
|
617
|
+
if (blockers.length) {
|
|
618
|
+
throw refuse(409, `cannot be deleted for good: ${blockers.map((b) => b.reason).join("; ")}`, "delete_blocked", {
|
|
619
|
+
blockers
|
|
620
|
+
});
|
|
621
|
+
}
|
|
622
|
+
return finalDelete(row, id, caller);
|
|
623
|
+
}
|
|
624
|
+
async function purge(caller, options = {}) {
|
|
625
|
+
let retentionDays;
|
|
626
|
+
try {
|
|
627
|
+
retentionDays = await readTrashRetention(caller, opts.retention);
|
|
628
|
+
} catch (err) {
|
|
629
|
+
return { skipped: true, reason: err instanceof Error ? err.message : String(err), purged: [], blocked: [] };
|
|
630
|
+
}
|
|
631
|
+
const cutoff = new Date(now().getTime() - retentionDays * 864e5).toISOString();
|
|
632
|
+
const max = options.max ?? 500;
|
|
633
|
+
const due = (await listAll(repo, { [TRASH_COLUMN]: { op: "lt", value: cutoff } })).slice(0, max);
|
|
634
|
+
const result = { skipped: false, retentionDays, cutoff, purged: [], blocked: [] };
|
|
635
|
+
for (const row of due) {
|
|
636
|
+
const id = String(row.id);
|
|
637
|
+
const blockers = await runCheck(opts.blockers, row, caller);
|
|
638
|
+
if (blockers.length) {
|
|
639
|
+
result.blocked.push({ id, blockers });
|
|
640
|
+
const reason = blockers.map((b) => b.reason).join("; ");
|
|
641
|
+
if (reasonColumn && row[reasonColumn] !== reason) {
|
|
642
|
+
try {
|
|
643
|
+
await repo.update(id, { [reasonColumn]: reason });
|
|
644
|
+
} catch {
|
|
645
|
+
}
|
|
646
|
+
}
|
|
647
|
+
continue;
|
|
648
|
+
}
|
|
649
|
+
try {
|
|
650
|
+
await finalDelete(row, id, caller);
|
|
651
|
+
result.purged.push(id);
|
|
652
|
+
} catch (err) {
|
|
653
|
+
result.blocked.push({
|
|
654
|
+
id,
|
|
655
|
+
blockers: [{ reason: `delete failed: ${err instanceof Error ? err.message : String(err)}`, code: "delete_failed" }]
|
|
656
|
+
});
|
|
657
|
+
}
|
|
658
|
+
}
|
|
659
|
+
await emit(
|
|
660
|
+
opts.events?.purged,
|
|
661
|
+
{ retention_days: retentionDays, cutoff, purged: result.purged.length, blocked: result.blocked.length },
|
|
662
|
+
null
|
|
663
|
+
);
|
|
664
|
+
return result;
|
|
665
|
+
}
|
|
666
|
+
app.delete(`${base}/{${idParam}}`, async (c) => {
|
|
667
|
+
const id = c.params[idParam] ?? "";
|
|
668
|
+
const row = await load(id);
|
|
669
|
+
if (isTrashed(row)) return c.json({ deleted: true, ...await deleteForGood(id, c) });
|
|
670
|
+
return c.json({ trashed: true, ...await trash(id, c) });
|
|
671
|
+
});
|
|
672
|
+
app.post(`${base}/{${idParam}}/restore`, async (c) => {
|
|
673
|
+
return c.json({ restored: true, ...await restore(c.params[idParam] ?? "", c) });
|
|
674
|
+
});
|
|
675
|
+
return { trash, restore, deleteForGood, purge };
|
|
676
|
+
}
|
|
677
|
+
function createGatewayCounter(options = {}) {
|
|
678
|
+
const env = options.env ?? process.env;
|
|
679
|
+
const endpoint = String(options.endpoint || env.REVENEXX_GATEWAY_ENDPOINT || DEFAULT_GATEWAY_ENDPOINT).replace(/\/+$/, "");
|
|
680
|
+
async function count(caller, path, where = {}) {
|
|
681
|
+
const f = options.fetchImpl ?? globalThis.fetch;
|
|
682
|
+
const qs = new URLSearchParams();
|
|
683
|
+
for (const [k, v] of Object.entries(where)) qs.set(k, String(v));
|
|
684
|
+
qs.set("limit", "1");
|
|
685
|
+
const headers = { Accept: "application/json" };
|
|
686
|
+
const tenant = (caller.tenant ?? "") || headerFrom(caller, "x-revenexx-tenant");
|
|
687
|
+
if (tenant) headers["X-Revenexx-Tenant"] = tenant;
|
|
688
|
+
const context = (caller.contextToken ?? "") || headerFrom(caller, "x-revenexx-context");
|
|
689
|
+
if (context) headers.Authorization = `Bearer ${context}`;
|
|
690
|
+
const appContext = headerFrom(caller, "x-revenexx-app-context");
|
|
691
|
+
if (appContext) headers["x-revenexx-app-context"] = appContext;
|
|
692
|
+
try {
|
|
693
|
+
const signal = AbortSignal.timeout?.(options.timeoutMs ?? 5e3);
|
|
694
|
+
const sep = path.includes("?") ? "&" : "?";
|
|
695
|
+
const res = await f(`${endpoint}${path}${sep}${qs.toString()}`, { headers, ...signal ? { signal } : {} });
|
|
696
|
+
if (!res.ok) return null;
|
|
697
|
+
const body = await res.json();
|
|
698
|
+
const total = body?.page?.total;
|
|
699
|
+
return typeof total === "number" && Number.isFinite(total) ? total : null;
|
|
700
|
+
} catch {
|
|
701
|
+
return null;
|
|
702
|
+
}
|
|
703
|
+
}
|
|
704
|
+
async function blocker(caller, check) {
|
|
705
|
+
const n = await count(caller, check.path, check.where);
|
|
706
|
+
if (n === null) return { reason: `${check.reason} \u2014 could not be checked`, code: "unverifiable" };
|
|
707
|
+
if (n === 0) return null;
|
|
708
|
+
return { reason: `${n} ${check.reason}`, count: n, code: "referenced" };
|
|
709
|
+
}
|
|
710
|
+
return { count, blocker };
|
|
711
|
+
}
|
|
451
712
|
export {
|
|
452
713
|
ACTOR_HEADERS,
|
|
714
|
+
AUDIT_SETTINGS_PATH,
|
|
453
715
|
DEFAULT_GATEWAY_ENDPOINT,
|
|
454
716
|
DEFAULT_SETTINGS_ERROR_TTL_MS,
|
|
455
717
|
DEFAULT_SETTINGS_TIMEOUT_MS,
|
|
456
718
|
DEFAULT_SETTINGS_TTL_MS,
|
|
719
|
+
DEFAULT_TRASH_RETENTION_DAYS,
|
|
457
720
|
HttpError,
|
|
721
|
+
MARKET_HEADERS,
|
|
722
|
+
PURGE_REASON_COLUMN,
|
|
458
723
|
RESERVED_LIST_QUERY_KEYS,
|
|
724
|
+
TRASH_COLUMN,
|
|
459
725
|
actorFrom,
|
|
726
|
+
auditSettingsUrl,
|
|
460
727
|
badRequest,
|
|
461
728
|
conflict,
|
|
462
729
|
createApp,
|
|
730
|
+
createGatewayCounter,
|
|
463
731
|
createSettings,
|
|
464
732
|
forbidden,
|
|
465
733
|
isHttpError,
|
|
734
|
+
marketFrom,
|
|
466
735
|
mountCrud,
|
|
736
|
+
mountTrash,
|
|
467
737
|
notFound,
|
|
738
|
+
readTrashRetention,
|
|
468
739
|
refusalOf
|
|
469
740
|
};
|
|
470
741
|
//# sourceMappingURL=index.js.map
|