@revenexx/app-sdk 0.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/LICENSE +21 -0
- package/README.md +32 -0
- package/dist/index.cjs +344 -0
- package/dist/index.cjs.map +1 -0
- package/dist/index.d.cts +146 -0
- package/dist/index.d.ts +146 -0
- package/dist/index.js +307 -0
- package/dist/index.js.map +1 -0
- package/package.json +43 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 revenexx
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# @revenexx/app-sdk
|
|
2
|
+
|
|
3
|
+
Typed PostgREST data client for revenexx Apps. Swappable adapters
|
|
4
|
+
(`mock` | `remote` | `runtime`) so the same App code runs against in-memory
|
|
5
|
+
fixtures locally and real PostgREST in production (ADR-0013 / ADR-0057).
|
|
6
|
+
|
|
7
|
+
Usually you don't use this directly — [`@revenexx/app-sdk-cli`](../cli) generates
|
|
8
|
+
a typed `createDb()` on top of it from your App's `schema.json`. The runtime is
|
|
9
|
+
also usable on its own:
|
|
10
|
+
|
|
11
|
+
```ts
|
|
12
|
+
import { createClient } from '@revenexx/app-sdk';
|
|
13
|
+
|
|
14
|
+
const db = createClient({
|
|
15
|
+
adapter: 'mock',
|
|
16
|
+
entities: { greetings: { table: 'revenexx__sample_app__greetings', pk: 'id', ops: ['list', 'create'] } },
|
|
17
|
+
seed: {},
|
|
18
|
+
});
|
|
19
|
+
await db.greetings.create({ name: 'Max' });
|
|
20
|
+
```
|
|
21
|
+
|
|
22
|
+
## Custom adapters
|
|
23
|
+
|
|
24
|
+
The adapter is a small interface (`list/get/create/update/remove`). Register a
|
|
25
|
+
new backend before constructing the client:
|
|
26
|
+
|
|
27
|
+
```ts
|
|
28
|
+
import { registerAdapter, createClient } from '@revenexx/app-sdk';
|
|
29
|
+
|
|
30
|
+
registerAdapter('sqlite', (config) => ({ kind: 'sqlite', /* … */ }));
|
|
31
|
+
const db = createClient({ adapter: 'sqlite', entities, file: 'dev.db' });
|
|
32
|
+
```
|
package/dist/index.cjs
ADDED
|
@@ -0,0 +1,344 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
var __defProp = Object.defineProperty;
|
|
3
|
+
var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
|
|
4
|
+
var __getOwnPropNames = Object.getOwnPropertyNames;
|
|
5
|
+
var __hasOwnProp = Object.prototype.hasOwnProperty;
|
|
6
|
+
var __export = (target, all) => {
|
|
7
|
+
for (var name in all)
|
|
8
|
+
__defProp(target, name, { get: all[name], enumerable: true });
|
|
9
|
+
};
|
|
10
|
+
var __copyProps = (to, from, except, desc) => {
|
|
11
|
+
if (from && typeof from === "object" || typeof from === "function") {
|
|
12
|
+
for (let key of __getOwnPropNames(from))
|
|
13
|
+
if (!__hasOwnProp.call(to, key) && key !== except)
|
|
14
|
+
__defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
|
|
15
|
+
}
|
|
16
|
+
return to;
|
|
17
|
+
};
|
|
18
|
+
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
|
+
|
|
20
|
+
// src/index.ts
|
|
21
|
+
var index_exports = {};
|
|
22
|
+
__export(index_exports, {
|
|
23
|
+
adapterKinds: () => adapterKinds,
|
|
24
|
+
applyDefaults: () => applyDefaults,
|
|
25
|
+
createAdapter: () => createAdapter,
|
|
26
|
+
createClient: () => createClient,
|
|
27
|
+
createMockAdapter: () => createMockAdapter,
|
|
28
|
+
createRemoteAdapter: () => createRemoteAdapter,
|
|
29
|
+
createRuntimeAdapter: () => createRuntimeAdapter,
|
|
30
|
+
matches: () => matches,
|
|
31
|
+
opsFromAccess: () => opsFromAccess,
|
|
32
|
+
registerAdapter: () => registerAdapter,
|
|
33
|
+
toParams: () => toParams
|
|
34
|
+
});
|
|
35
|
+
module.exports = __toCommonJS(index_exports);
|
|
36
|
+
|
|
37
|
+
// src/adapters/mock.ts
|
|
38
|
+
var import_node_crypto = require("crypto");
|
|
39
|
+
|
|
40
|
+
// src/query.ts
|
|
41
|
+
var OPS = /* @__PURE__ */ new Set(["eq", "neq", "gt", "gte", "lt", "lte", "like", "ilike", "in", "is"]);
|
|
42
|
+
function toParams(query = {}) {
|
|
43
|
+
const params = new URLSearchParams();
|
|
44
|
+
const { where = {}, select, order, limit, offset } = query;
|
|
45
|
+
for (const [col, cond] of Object.entries(where)) {
|
|
46
|
+
if (Array.isArray(cond)) {
|
|
47
|
+
params.append(col, `in.(${cond.join(",")})`);
|
|
48
|
+
} else if (cond && typeof cond === "object" && typeof cond.op === "string") {
|
|
49
|
+
const c = cond;
|
|
50
|
+
if (!OPS.has(c.op)) throw new Error(`query: unsupported operator '${c.op}'`);
|
|
51
|
+
const v = Array.isArray(c.value) ? `(${c.value.join(",")})` : c.value;
|
|
52
|
+
params.append(col, `${c.op}.${v}`);
|
|
53
|
+
} else {
|
|
54
|
+
params.append(col, `eq.${cond}`);
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
if (Array.isArray(select) && select.length) params.set("select", select.join(","));
|
|
58
|
+
if (order) params.set("order", /\.(asc|desc)$/.test(order) ? order : `${order}.asc`);
|
|
59
|
+
if (Number.isInteger(limit)) params.set("limit", String(limit));
|
|
60
|
+
if (Number.isInteger(offset)) params.set("offset", String(offset));
|
|
61
|
+
return params;
|
|
62
|
+
}
|
|
63
|
+
function matches(row, where = {}) {
|
|
64
|
+
for (const [col, cond] of Object.entries(where)) {
|
|
65
|
+
const val = row[col];
|
|
66
|
+
if (Array.isArray(cond)) {
|
|
67
|
+
if (!cond.includes(val)) return false;
|
|
68
|
+
} else if (cond && typeof cond === "object" && typeof cond.op === "string") {
|
|
69
|
+
const c = cond;
|
|
70
|
+
if (!compare(val, c.op, c.value)) return false;
|
|
71
|
+
} else if (val !== cond) {
|
|
72
|
+
return false;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
return true;
|
|
76
|
+
}
|
|
77
|
+
function compare(a, op, b) {
|
|
78
|
+
switch (op) {
|
|
79
|
+
case "eq":
|
|
80
|
+
return a === b;
|
|
81
|
+
case "neq":
|
|
82
|
+
return a !== b;
|
|
83
|
+
case "gt":
|
|
84
|
+
return a > b;
|
|
85
|
+
case "gte":
|
|
86
|
+
return a >= b;
|
|
87
|
+
case "lt":
|
|
88
|
+
return a < b;
|
|
89
|
+
case "lte":
|
|
90
|
+
return a <= b;
|
|
91
|
+
case "is":
|
|
92
|
+
return a === b;
|
|
93
|
+
case "in":
|
|
94
|
+
return Array.isArray(b) && b.includes(a);
|
|
95
|
+
case "like":
|
|
96
|
+
case "ilike": {
|
|
97
|
+
const re = new RegExp(
|
|
98
|
+
"^" + String(b).replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/%/g, ".*").replace(/_/g, ".") + "$",
|
|
99
|
+
op === "ilike" ? "i" : ""
|
|
100
|
+
);
|
|
101
|
+
return re.test(String(a));
|
|
102
|
+
}
|
|
103
|
+
default:
|
|
104
|
+
return false;
|
|
105
|
+
}
|
|
106
|
+
}
|
|
107
|
+
|
|
108
|
+
// src/adapters/mock.ts
|
|
109
|
+
function shape(rows, query) {
|
|
110
|
+
let out = rows;
|
|
111
|
+
if (query.order) {
|
|
112
|
+
const [c, dir = "asc"] = query.order.split(".");
|
|
113
|
+
const key = c;
|
|
114
|
+
out = out.slice().sort((a, b) => a[key] < b[key] ? -1 : a[key] > b[key] ? 1 : 0);
|
|
115
|
+
if (dir === "desc") out.reverse();
|
|
116
|
+
}
|
|
117
|
+
if (query.offset) out = out.slice(query.offset);
|
|
118
|
+
if (Number.isInteger(query.limit)) out = out.slice(0, query.limit);
|
|
119
|
+
if (Array.isArray(query.select) && query.select.length) {
|
|
120
|
+
const cols = query.select;
|
|
121
|
+
out = out.map((r) => Object.fromEntries(cols.map((c) => [c, r[c]])));
|
|
122
|
+
}
|
|
123
|
+
return out.map((r) => ({ ...r }));
|
|
124
|
+
}
|
|
125
|
+
function applyDefaults(entity, data) {
|
|
126
|
+
const row = { ...data };
|
|
127
|
+
for (const [col, def] of Object.entries(entity.columns ?? {})) {
|
|
128
|
+
if (row[col] !== void 0 || def == null) continue;
|
|
129
|
+
const d = def.default;
|
|
130
|
+
if (d == null) continue;
|
|
131
|
+
if (/gen_random_uuid/i.test(d)) row[col] = (0, import_node_crypto.randomUUID)();
|
|
132
|
+
else if (/now\(\)|current_timestamp/i.test(d)) row[col] = (/* @__PURE__ */ new Date()).toISOString();
|
|
133
|
+
else {
|
|
134
|
+
const m = /^'(.*)'$/.exec(String(d).trim());
|
|
135
|
+
if (m) row[col] = m[1];
|
|
136
|
+
}
|
|
137
|
+
}
|
|
138
|
+
return row;
|
|
139
|
+
}
|
|
140
|
+
function createMockAdapter(seed = {}) {
|
|
141
|
+
const store = /* @__PURE__ */ new Map();
|
|
142
|
+
const tbl = (entity) => {
|
|
143
|
+
let m = store.get(entity.name);
|
|
144
|
+
if (!m) {
|
|
145
|
+
m = /* @__PURE__ */ new Map();
|
|
146
|
+
for (const r of seed[entity.name] ?? []) m.set(r[entity.pk], { ...r });
|
|
147
|
+
store.set(entity.name, m);
|
|
148
|
+
}
|
|
149
|
+
return m;
|
|
150
|
+
};
|
|
151
|
+
return {
|
|
152
|
+
kind: "mock",
|
|
153
|
+
async list(entity, query = {}) {
|
|
154
|
+
const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));
|
|
155
|
+
return shape(filtered, query);
|
|
156
|
+
},
|
|
157
|
+
async page(entity, query = {}) {
|
|
158
|
+
const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));
|
|
159
|
+
return { items: shape(filtered, query), total: filtered.length, limit: query.limit, offset: query.offset };
|
|
160
|
+
},
|
|
161
|
+
async get(entity, id) {
|
|
162
|
+
const r = tbl(entity).get(id);
|
|
163
|
+
return r ? { ...r } : null;
|
|
164
|
+
},
|
|
165
|
+
async create(entity, data) {
|
|
166
|
+
const row = applyDefaults(entity, data);
|
|
167
|
+
if (row[entity.pk] === void 0) row[entity.pk] = (0, import_node_crypto.randomUUID)();
|
|
168
|
+
tbl(entity).set(row[entity.pk], row);
|
|
169
|
+
return { ...row };
|
|
170
|
+
},
|
|
171
|
+
async update(entity, id, patch) {
|
|
172
|
+
const cur = tbl(entity).get(id);
|
|
173
|
+
if (!cur) throw new Error(`mock: ${entity.name}/${String(id)} not found`);
|
|
174
|
+
const row = { ...cur, ...patch };
|
|
175
|
+
if (entity.columns?.updated_at) row.updated_at = (/* @__PURE__ */ new Date()).toISOString();
|
|
176
|
+
tbl(entity).set(id, row);
|
|
177
|
+
return { ...row };
|
|
178
|
+
},
|
|
179
|
+
async remove(entity, id) {
|
|
180
|
+
tbl(entity).delete(id);
|
|
181
|
+
}
|
|
182
|
+
};
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
// src/adapters/remote.ts
|
|
186
|
+
function createRemoteAdapter(config) {
|
|
187
|
+
const f = config.fetchImpl ?? globalThis.fetch;
|
|
188
|
+
if (typeof f !== "function") {
|
|
189
|
+
throw new Error("remote adapter: no fetch available (Node >=18 or pass fetchImpl)");
|
|
190
|
+
}
|
|
191
|
+
const base = String(config.endpoint ?? "").replace(/\/$/, "");
|
|
192
|
+
if (!base) throw new Error("remote adapter: endpoint is required");
|
|
193
|
+
const headers = (extra) => {
|
|
194
|
+
const h = { "Content-Type": "application/json", Accept: "application/json", ...extra };
|
|
195
|
+
if (config.token) h.Authorization = `Bearer ${config.token}`;
|
|
196
|
+
if (config.tenant) h["X-Revenexx-Tenant"] = config.tenant;
|
|
197
|
+
return h;
|
|
198
|
+
};
|
|
199
|
+
async function req(method, path, opts = {}) {
|
|
200
|
+
const res = await f(`${base}${path}`, {
|
|
201
|
+
method,
|
|
202
|
+
headers: headers(opts.prefer ? { Prefer: opts.prefer } : {}),
|
|
203
|
+
body: opts.body != null ? JSON.stringify(opts.body) : void 0
|
|
204
|
+
});
|
|
205
|
+
const text = await res.text();
|
|
206
|
+
if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);
|
|
207
|
+
return text ? JSON.parse(text) : null;
|
|
208
|
+
}
|
|
209
|
+
return {
|
|
210
|
+
kind: "remote",
|
|
211
|
+
async list(entity, query = {}) {
|
|
212
|
+
const qs = toParams(query).toString();
|
|
213
|
+
return await req("GET", `/${entity.table}${qs ? `?${qs}` : ""}`) ?? [];
|
|
214
|
+
},
|
|
215
|
+
async get(entity, id) {
|
|
216
|
+
const rows = await req("GET", `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}&limit=1`);
|
|
217
|
+
return rows?.[0] ?? null;
|
|
218
|
+
},
|
|
219
|
+
async create(entity, data) {
|
|
220
|
+
const rows = await req("POST", `/${entity.table}`, { body: data, prefer: "return=representation" });
|
|
221
|
+
return Array.isArray(rows) ? rows[0] : rows;
|
|
222
|
+
},
|
|
223
|
+
async update(entity, id, patch) {
|
|
224
|
+
const rows = await req("PATCH", `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {
|
|
225
|
+
body: patch,
|
|
226
|
+
prefer: "return=representation"
|
|
227
|
+
});
|
|
228
|
+
return Array.isArray(rows) ? rows[0] : rows;
|
|
229
|
+
},
|
|
230
|
+
async remove(entity, id) {
|
|
231
|
+
await req("DELETE", `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`);
|
|
232
|
+
},
|
|
233
|
+
async page(entity, query = {}) {
|
|
234
|
+
const qs = toParams(query).toString();
|
|
235
|
+
const res = await f(`${base}/${entity.table}${qs ? `?${qs}` : ""}`, {
|
|
236
|
+
method: "GET",
|
|
237
|
+
headers: headers({ Prefer: "count=exact" })
|
|
238
|
+
});
|
|
239
|
+
const text = await res.text();
|
|
240
|
+
if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);
|
|
241
|
+
const items = text ? JSON.parse(text) : [];
|
|
242
|
+
const range = res.headers.get("content-range") ?? "";
|
|
243
|
+
const total = Number.parseInt(range.split("/")[1] ?? "", 10);
|
|
244
|
+
return {
|
|
245
|
+
items,
|
|
246
|
+
total: Number.isFinite(total) ? total : items.length,
|
|
247
|
+
limit: query.limit,
|
|
248
|
+
offset: query.offset
|
|
249
|
+
};
|
|
250
|
+
}
|
|
251
|
+
};
|
|
252
|
+
}
|
|
253
|
+
|
|
254
|
+
// src/adapters/runtime.ts
|
|
255
|
+
function createRuntimeAdapter(config = {}) {
|
|
256
|
+
const env = config.env ?? process.env;
|
|
257
|
+
const h = config.context?.req?.headers ?? {};
|
|
258
|
+
const get = (name) => h[name] ?? h[name.toLowerCase()] ?? "";
|
|
259
|
+
const remote = createRemoteAdapter({
|
|
260
|
+
endpoint: env.REVENEXX_DATA_ENDPOINT ?? "",
|
|
261
|
+
token: get("x-revenexx-context") || env.REVENEXX_CONTEXT || "",
|
|
262
|
+
tenant: get("x-revenexx-tenant") || env.REVENEXX_TENANT || ""
|
|
263
|
+
});
|
|
264
|
+
return { ...remote, kind: "runtime" };
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
// src/adapters/index.ts
|
|
268
|
+
var registry = /* @__PURE__ */ new Map();
|
|
269
|
+
function registerAdapter(kind, factory) {
|
|
270
|
+
registry.set(kind, factory);
|
|
271
|
+
}
|
|
272
|
+
function adapterKinds() {
|
|
273
|
+
return [...registry.keys()];
|
|
274
|
+
}
|
|
275
|
+
function createAdapter(config) {
|
|
276
|
+
const kind = config.adapter ?? "";
|
|
277
|
+
const factory = registry.get(kind);
|
|
278
|
+
if (!factory) {
|
|
279
|
+
const known = adapterKinds().join(" | ") || "none registered";
|
|
280
|
+
throw new Error(`app-sdk: unknown adapter '${kind}' (${known})`);
|
|
281
|
+
}
|
|
282
|
+
return factory(config);
|
|
283
|
+
}
|
|
284
|
+
registerAdapter("mock", (c) => createMockAdapter(c.seed));
|
|
285
|
+
registerAdapter("remote", (c) => createRemoteAdapter(c));
|
|
286
|
+
registerAdapter("runtime", (c) => createRuntimeAdapter(c));
|
|
287
|
+
|
|
288
|
+
// src/client.ts
|
|
289
|
+
var ACCESS_TO_OPS = {
|
|
290
|
+
read: ["list", "get"],
|
|
291
|
+
create: ["create"],
|
|
292
|
+
update: ["update"],
|
|
293
|
+
delete: ["delete"]
|
|
294
|
+
};
|
|
295
|
+
function opsFromAccess(access = []) {
|
|
296
|
+
const ops = /* @__PURE__ */ new Set();
|
|
297
|
+
for (const a of access) (ACCESS_TO_OPS[a] ?? []).forEach((o) => ops.add(o));
|
|
298
|
+
return ops;
|
|
299
|
+
}
|
|
300
|
+
function entityClient(adapter, entity) {
|
|
301
|
+
const ops = entity.ops instanceof Set ? entity.ops : new Set(entity.ops ?? ["list", "get", "create", "update", "delete"]);
|
|
302
|
+
const guard = (op, fn) => ops.has(op) ? fn : (() => {
|
|
303
|
+
throw new Error(
|
|
304
|
+
`${entity.name}.${op}() is not permitted \u2014 add the matching access to manifest.permissions for '${entity.name}'`
|
|
305
|
+
);
|
|
306
|
+
});
|
|
307
|
+
return {
|
|
308
|
+
list: guard("list", (query) => adapter.list(entity, query ?? {})),
|
|
309
|
+
page: guard("list", (query) => {
|
|
310
|
+
if (!adapter.page) {
|
|
311
|
+
throw new Error(`${entity.name}.page() is not supported by the '${adapter.kind}' adapter`);
|
|
312
|
+
}
|
|
313
|
+
return adapter.page(entity, query ?? {});
|
|
314
|
+
}),
|
|
315
|
+
get: guard("get", (id) => adapter.get(entity, id)),
|
|
316
|
+
create: guard("create", (data) => adapter.create(entity, data)),
|
|
317
|
+
update: guard("update", (id, patch) => adapter.update(entity, id, patch)),
|
|
318
|
+
delete: guard("delete", (id) => adapter.remove(entity, id))
|
|
319
|
+
};
|
|
320
|
+
}
|
|
321
|
+
function createClient(config) {
|
|
322
|
+
if (!config?.entities) throw new Error("app-sdk: createClient needs { adapter, entities }");
|
|
323
|
+
const adapter = createAdapter(config);
|
|
324
|
+
const db = /* @__PURE__ */ Object.create({ __adapter: adapter.kind });
|
|
325
|
+
for (const [name, def] of Object.entries(config.entities)) {
|
|
326
|
+
db[name] = entityClient(adapter, { name, ...def });
|
|
327
|
+
}
|
|
328
|
+
return db;
|
|
329
|
+
}
|
|
330
|
+
// Annotate the CommonJS export names for ESM import in node:
|
|
331
|
+
0 && (module.exports = {
|
|
332
|
+
adapterKinds,
|
|
333
|
+
applyDefaults,
|
|
334
|
+
createAdapter,
|
|
335
|
+
createClient,
|
|
336
|
+
createMockAdapter,
|
|
337
|
+
createRemoteAdapter,
|
|
338
|
+
createRuntimeAdapter,
|
|
339
|
+
matches,
|
|
340
|
+
opsFromAccess,
|
|
341
|
+
registerAdapter,
|
|
342
|
+
toParams
|
|
343
|
+
});
|
|
344
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/index.ts","../src/adapters/mock.ts","../src/query.ts","../src/adapters/remote.ts","../src/adapters/runtime.ts","../src/adapters/index.ts","../src/client.ts"],"sourcesContent":["/**\n * @revenexx/app-sdk — typed PostgREST data client for revenexx Apps.\n *\n * The generated per-App client (see @revenexx/app-sdk-cli) wraps `createClient`\n * with strongly-typed entity interfaces. You can also use this runtime directly.\n */\n\nexport { createClient, opsFromAccess } from './client.js';\nexport type { Client, ClientConfig, EntityClient } from './client.js';\n\nexport { toParams, matches } from './query.js';\n\nexport {\n registerAdapter,\n createAdapter,\n adapterKinds,\n createMockAdapter,\n createRemoteAdapter,\n createRuntimeAdapter,\n applyDefaults,\n} from './adapters/index.js';\nexport type { AdapterFactory } from './adapters/index.js';\nexport type { RemoteConfig } from './adapters/remote.js';\nexport type { RuntimeConfig } from './adapters/runtime.js';\n\nexport type {\n Adapter,\n Entity,\n ColumnDef,\n Op,\n Query,\n Filter,\n FilterOp,\n Scalar,\n Row,\n Page,\n} from './types.js';\n","import { randomUUID } from 'node:crypto';\nimport type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { matches } from '../query.js';\n\n/** Apply order → offset → limit → select to an already-filtered row set. */\nfunction shape(rows: Row[], query: Query): Row[] {\n let out = rows;\n if (query.order) {\n const [c, dir = 'asc'] = query.order.split('.');\n const key = c as string;\n out = out.slice().sort((a, b) => (a[key]! < b[key]! ? -1 : a[key]! > b[key]! ? 1 : 0));\n if (dir === 'desc') out.reverse();\n }\n if (query.offset) out = out.slice(query.offset);\n if (Number.isInteger(query.limit)) out = out.slice(0, query.limit);\n if (Array.isArray(query.select) && query.select.length) {\n const cols = query.select as string[];\n out = out.map((r) => Object.fromEntries(cols.map((c) => [c, r[c]])));\n }\n return out.map((r) => ({ ...r }));\n}\n\n/** Best-effort apply of schema.json column defaults for the mock adapter. */\nexport function applyDefaults(entity: Entity, data: Row): Row {\n const row: Row = { ...data };\n for (const [col, def] of Object.entries(entity.columns ?? {})) {\n if (row[col] !== undefined || def == null) continue;\n const d = def.default;\n if (d == null) continue;\n if (/gen_random_uuid/i.test(d)) row[col] = randomUUID();\n else if (/now\\(\\)|current_timestamp/i.test(d)) row[col] = new Date().toISOString();\n else {\n const m = /^'(.*)'$/.exec(String(d).trim());\n if (m) row[col] = m[1];\n }\n }\n return row;\n}\n\n/**\n * In-memory adapter. Zero infrastructure: develop + unit-test App logic against\n * fixtures. Does NOT enforce RLS, constraints, triggers or PostgREST semantics —\n * run the `remote` adapter against a dev tenant for that fidelity before deploy.\n */\nexport function createMockAdapter(seed: Record<string, Row[]> = {}): Adapter {\n const store = new Map<string, Map<unknown, Row>>();\n const tbl = (entity: Entity): Map<unknown, Row> => {\n let m = store.get(entity.name);\n if (!m) {\n m = new Map();\n for (const r of seed[entity.name] ?? []) m.set(r[entity.pk], { ...r });\n store.set(entity.name, m);\n }\n return m;\n };\n\n return {\n kind: 'mock',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return shape(filtered, query);\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return { items: shape(filtered, query), total: filtered.length, limit: query.limit, offset: query.offset };\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const r = tbl(entity).get(id);\n return r ? { ...r } : null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const row = applyDefaults(entity, data);\n if (row[entity.pk] === undefined) row[entity.pk] = randomUUID();\n tbl(entity).set(row[entity.pk], row);\n return { ...row };\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const cur = tbl(entity).get(id);\n if (!cur) throw new Error(`mock: ${entity.name}/${String(id)} not found`);\n const row: Row = { ...cur, ...patch };\n if (entity.columns?.updated_at) row.updated_at = new Date().toISOString();\n tbl(entity).set(id, row);\n return { ...row };\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n tbl(entity).delete(id);\n },\n };\n}\n","import type { Query, FilterOp, Row } from './types.js';\n\n/**\n * PostgREST query helpers. `toParams` serialises a query for the HTTP adapters;\n * `matches` applies the same `where` semantics in memory for the mock adapter —\n * keeping one shape means App code is identical across adapters.\n */\n\nconst OPS = new Set<FilterOp>(['eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'like', 'ilike', 'in', 'is']);\n\n/** Serialise a query object to PostgREST URLSearchParams. */\nexport function toParams(query: Query = {}): URLSearchParams {\n const params = new URLSearchParams();\n const { where = {}, select, order, limit, offset } = query;\n\n for (const [col, cond] of Object.entries(where)) {\n if (Array.isArray(cond)) {\n params.append(col, `in.(${cond.join(',')})`);\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!OPS.has(c.op)) throw new Error(`query: unsupported operator '${c.op}'`);\n const v = Array.isArray(c.value) ? `(${c.value.join(',')})` : c.value;\n params.append(col, `${c.op}.${v}`);\n } else {\n params.append(col, `eq.${cond}`);\n }\n }\n\n if (Array.isArray(select) && select.length) params.set('select', (select as string[]).join(','));\n if (order) params.set('order', /\\.(asc|desc)$/.test(order) ? order : `${order}.asc`);\n if (Number.isInteger(limit)) params.set('limit', String(limit));\n if (Number.isInteger(offset)) params.set('offset', String(offset));\n\n return params;\n}\n\n/** In-memory predicate mirroring `toParams`' `where` semantics (mock adapter). */\nexport function matches(row: Row, where: Query['where'] = {}): boolean {\n for (const [col, cond] of Object.entries(where)) {\n const val = row[col];\n if (Array.isArray(cond)) {\n if (!cond.includes(val as never)) return false;\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!compare(val, c.op, c.value)) return false;\n } else if (val !== cond) {\n return false;\n }\n }\n return true;\n}\n\nfunction compare(a: unknown, op: FilterOp, b: unknown): boolean {\n switch (op) {\n case 'eq': return a === b;\n case 'neq': return a !== b;\n case 'gt': return (a as number) > (b as number);\n case 'gte': return (a as number) >= (b as number);\n case 'lt': return (a as number) < (b as number);\n case 'lte': return (a as number) <= (b as number);\n case 'is': return a === b;\n case 'in': return Array.isArray(b) && b.includes(a);\n case 'like':\n case 'ilike': {\n const re = new RegExp(\n '^' + String(b).replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&').replace(/%/g, '.*').replace(/_/g, '.') + '$',\n op === 'ilike' ? 'i' : '',\n );\n return re.test(String(a));\n }\n default: return false;\n }\n}\n","import type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { toParams } from '../query.js';\n\nexport interface RemoteConfig {\n endpoint: string;\n token?: string;\n tenant?: string;\n fetchImpl?: typeof fetch;\n}\n\n/** PostgREST-over-HTTP adapter (production data plane / dev tenant). */\nexport function createRemoteAdapter(config: RemoteConfig): Adapter {\n const f = config.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') {\n throw new Error('remote adapter: no fetch available (Node >=18 or pass fetchImpl)');\n }\n const base = String(config.endpoint ?? '').replace(/\\/$/, '');\n if (!base) throw new Error('remote adapter: endpoint is required');\n\n const headers = (extra?: Record<string, string>): Record<string, string> => {\n const h: Record<string, string> = { 'Content-Type': 'application/json', Accept: 'application/json', ...extra };\n if (config.token) h.Authorization = `Bearer ${config.token}`;\n if (config.tenant) h['X-Revenexx-Tenant'] = config.tenant;\n return h;\n };\n\n async function req(method: string, path: string, opts: { body?: unknown; prefer?: string } = {}): Promise<unknown> {\n const res = await f(`${base}${path}`, {\n method,\n headers: headers(opts.prefer ? { Prefer: opts.prefer } : {}),\n body: opts.body != null ? JSON.stringify(opts.body) : undefined,\n });\n const text = await res.text();\n if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);\n return text ? JSON.parse(text) : null;\n }\n\n return {\n kind: 'remote',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const qs = toParams(query).toString();\n return ((await req('GET', `/${entity.table}${qs ? `?${qs}` : ''}`)) as Row[]) ?? [];\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const rows = (await req('GET', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}&limit=1`)) as Row[];\n return rows?.[0] ?? null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const rows = await req('POST', `/${entity.table}`, { body: data, prefer: 'return=representation' });\n return (Array.isArray(rows) ? rows[0] : rows) as Row;\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const rows = await req('PATCH', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {\n body: patch,\n prefer: 'return=representation',\n });\n return (Array.isArray(rows) ? rows[0] : rows) as Row;\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n await req('DELETE', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`);\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n // One request: PostgREST returns the page in the body and the total in\n // Content-Range (\"0-9/247\" or \"*/247\") when asked for an exact count.\n const qs = toParams(query).toString();\n const res = await f(`${base}/${entity.table}${qs ? `?${qs}` : ''}`, {\n method: 'GET',\n headers: headers({ Prefer: 'count=exact' }),\n });\n const text = await res.text();\n if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);\n const items = (text ? JSON.parse(text) : []) as Row[];\n const range = res.headers.get('content-range') ?? '';\n const total = Number.parseInt(range.split('/')[1] ?? '', 10);\n return {\n items,\n total: Number.isFinite(total) ? total : items.length,\n limit: query.limit,\n offset: query.offset,\n };\n },\n };\n}\n","import type { Adapter } from '../types.js';\nimport { createRemoteAdapter } from './remote.js';\n\ninterface FunctionContext {\n req?: { headers?: Record<string, string> };\n}\n\nexport interface RuntimeConfig {\n context?: FunctionContext;\n env?: Record<string, string | undefined>;\n}\n\n/**\n * Production adapter: a `remote` adapter auto-configured from the function's\n * per-invocation context (ADR-0057). Token = the brokered identity forwarded as\n * `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env. App code\n * stays identical — only the adapter selection differs between local and prod.\n */\nexport function createRuntimeAdapter(config: RuntimeConfig = {}): Adapter {\n const env = config.env ?? process.env;\n const h = config.context?.req?.headers ?? {};\n const get = (name: string): string => h[name] ?? h[name.toLowerCase()] ?? '';\n\n const remote = createRemoteAdapter({\n endpoint: env.REVENEXX_DATA_ENDPOINT ?? '',\n token: get('x-revenexx-context') || env.REVENEXX_CONTEXT || '',\n tenant: get('x-revenexx-tenant') || env.REVENEXX_TENANT || '',\n });\n\n return { ...remote, kind: 'runtime' };\n}\n","import type { Adapter } from '../types.js';\nimport { createMockAdapter, applyDefaults } from './mock.js';\nimport { createRemoteAdapter } from './remote.js';\nimport { createRuntimeAdapter } from './runtime.js';\n\n/**\n * Adapter registry. Built-ins (mock | remote | runtime) are registered below;\n * add a new backend by calling `registerAdapter('my-kind', (config) => …)`\n * before constructing the client — no changes to the client or generated code.\n */\nexport type AdapterFactory = (config: Record<string, any>) => Adapter;\n\nconst registry = new Map<string, AdapterFactory>();\n\nexport function registerAdapter(kind: string, factory: AdapterFactory): void {\n registry.set(kind, factory);\n}\n\nexport function adapterKinds(): string[] {\n return [...registry.keys()];\n}\n\nexport function createAdapter(config: { adapter?: string } & Record<string, any>): Adapter {\n const kind = config.adapter ?? '';\n const factory = registry.get(kind);\n if (!factory) {\n const known = adapterKinds().join(' | ') || 'none registered';\n throw new Error(`app-sdk: unknown adapter '${kind}' (${known})`);\n }\n return factory(config);\n}\n\nregisterAdapter('mock', (c) => createMockAdapter(c.seed));\nregisterAdapter('remote', (c) => createRemoteAdapter(c as { endpoint: string }));\nregisterAdapter('runtime', (c) => createRuntimeAdapter(c));\n\nexport { createMockAdapter, createRemoteAdapter, createRuntimeAdapter, applyDefaults };\n","import type { Adapter, Entity, Op, Query, Row, Page } from './types.js';\nimport { createAdapter } from './adapters/index.js';\n\n/** manifest `permissions` access → entity client methods. */\nconst ACCESS_TO_OPS: Record<string, Op[]> = {\n read: ['list', 'get'],\n create: ['create'],\n update: ['update'],\n delete: ['delete'],\n};\n\n/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */\nexport function opsFromAccess(access: string[] = []): Set<Op> {\n const ops = new Set<Op>();\n for (const a of access) (ACCESS_TO_OPS[a] ?? []).forEach((o) => ops.add(o));\n return ops;\n}\n\n/** The methods exposed for a single entity; absent ops throw at call time. */\nexport interface EntityClient<T extends Row = Row, Create extends Row = T> {\n list(query?: Query<T>): Promise<T[]>;\n /** Like `list`, but also returns the total count of matching rows (for pagination). */\n page(query?: Query<T>): Promise<Page<T>>;\n get(id: string | number): Promise<T | null>;\n create(data: Create): Promise<T>;\n update(id: string | number, patch: Partial<Create>): Promise<T>;\n delete(id: string | number): Promise<void>;\n}\n\nfunction entityClient(adapter: Adapter, entity: Entity): EntityClient {\n const ops = entity.ops instanceof Set ? entity.ops : new Set<Op>(entity.ops ?? ['list', 'get', 'create', 'update', 'delete']);\n const guard = <F extends (...args: never[]) => unknown>(op: Op, fn: F): F =>\n (ops.has(op)\n ? fn\n : (() => {\n throw new Error(\n `${entity.name}.${op}() is not permitted — add the matching access to manifest.permissions for '${entity.name}'`,\n );\n }) as unknown as F);\n\n return {\n list: guard('list', (query?: Query) => adapter.list(entity, query ?? {})),\n page: guard('list', (query?: Query) => {\n if (!adapter.page) {\n throw new Error(`${entity.name}.page() is not supported by the '${adapter.kind}' adapter`);\n }\n return adapter.page(entity, query ?? {});\n }),\n get: guard('get', (id: string | number) => adapter.get(entity, id)),\n create: guard('create', (data: Row) => adapter.create(entity, data)),\n update: guard('update', (id: string | number, patch: Row) => adapter.update(entity, id, patch)),\n delete: guard('delete', (id: string | number) => adapter.remove(entity, id)),\n } as EntityClient;\n}\n\nexport interface ClientConfig {\n adapter: string;\n entities: Record<string, Omit<Entity, 'name'>>;\n [key: string]: unknown;\n}\n\nexport type Client = Record<string, EntityClient> & { readonly __adapter: string };\n\n/**\n * Build a typed entity client.\n * local dev : createClient({ adapter: 'mock', entities, seed })\n * dev tenant: createClient({ adapter: 'remote', entities, endpoint, token, tenant })\n * production: createClient({ adapter: 'runtime', entities, context }) // in the function\n */\nexport function createClient(config: ClientConfig): Client {\n if (!config?.entities) throw new Error('app-sdk: createClient needs { adapter, entities }');\n const adapter = createAdapter(config);\n const db = Object.create({ __adapter: adapter.kind }) as Client;\n for (const [name, def] of Object.entries(config.entities)) {\n db[name] = entityClient(adapter, { name, ...def });\n }\n return db;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA2B;;;ACQ3B,IAAM,MAAM,oBAAI,IAAc,CAAC,MAAM,OAAO,MAAM,OAAO,MAAM,OAAO,QAAQ,SAAS,MAAM,IAAI,CAAC;AAG3F,SAAS,SAAS,QAAe,CAAC,GAAoB;AAC3D,QAAM,SAAS,IAAI,gBAAgB;AACnC,QAAM,EAAE,QAAQ,CAAC,GAAG,QAAQ,OAAO,OAAO,OAAO,IAAI;AAErD,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,aAAO,OAAO,KAAK,OAAO,KAAK,KAAK,GAAG,CAAC,GAAG;AAAA,IAC7C,WAAW,QAAQ,OAAO,SAAS,YAAY,OAAQ,KAA0B,OAAO,UAAU;AAChG,YAAM,IAAI;AACV,UAAI,CAAC,IAAI,IAAI,EAAE,EAAE,EAAG,OAAM,IAAI,MAAM,gCAAgC,EAAE,EAAE,GAAG;AAC3E,YAAM,IAAI,MAAM,QAAQ,EAAE,KAAK,IAAI,IAAI,EAAE,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE;AAChE,aAAO,OAAO,KAAK,GAAG,EAAE,EAAE,IAAI,CAAC,EAAE;AAAA,IACnC,OAAO;AACL,aAAO,OAAO,KAAK,MAAM,IAAI,EAAE;AAAA,IACjC;AAAA,EACF;AAEA,MAAI,MAAM,QAAQ,MAAM,KAAK,OAAO,OAAQ,QAAO,IAAI,UAAW,OAAoB,KAAK,GAAG,CAAC;AAC/F,MAAI,MAAO,QAAO,IAAI,SAAS,gBAAgB,KAAK,KAAK,IAAI,QAAQ,GAAG,KAAK,MAAM;AACnF,MAAI,OAAO,UAAU,KAAK,EAAG,QAAO,IAAI,SAAS,OAAO,KAAK,CAAC;AAC9D,MAAI,OAAO,UAAU,MAAM,EAAG,QAAO,IAAI,UAAU,OAAO,MAAM,CAAC;AAEjE,SAAO;AACT;AAGO,SAAS,QAAQ,KAAU,QAAwB,CAAC,GAAY;AACrE,aAAW,CAAC,KAAK,IAAI,KAAK,OAAO,QAAQ,KAAK,GAAG;AAC/C,UAAM,MAAM,IAAI,GAAG;AACnB,QAAI,MAAM,QAAQ,IAAI,GAAG;AACvB,UAAI,CAAC,KAAK,SAAS,GAAY,EAAG,QAAO;AAAA,IAC3C,WAAW,QAAQ,OAAO,SAAS,YAAY,OAAQ,KAA0B,OAAO,UAAU;AAChG,YAAM,IAAI;AACV,UAAI,CAAC,QAAQ,KAAK,EAAE,IAAI,EAAE,KAAK,EAAG,QAAO;AAAA,IAC3C,WAAW,QAAQ,MAAM;AACvB,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,QAAQ,GAAY,IAAc,GAAqB;AAC9D,UAAQ,IAAI;AAAA,IACV,KAAK;AAAM,aAAO,MAAM;AAAA,IACxB,KAAK;AAAO,aAAO,MAAM;AAAA,IACzB,KAAK;AAAM,aAAQ,IAAgB;AAAA,IACnC,KAAK;AAAO,aAAQ,KAAiB;AAAA,IACrC,KAAK;AAAM,aAAQ,IAAgB;AAAA,IACnC,KAAK;AAAO,aAAQ,KAAiB;AAAA,IACrC,KAAK;AAAM,aAAO,MAAM;AAAA,IACxB,KAAK;AAAM,aAAO,MAAM,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;AAAA,IAClD,KAAK;AAAA,IACL,KAAK,SAAS;AACZ,YAAM,KAAK,IAAI;AAAA,QACb,MAAM,OAAO,CAAC,EAAE,QAAQ,sBAAsB,MAAM,EAAE,QAAQ,MAAM,IAAI,EAAE,QAAQ,MAAM,GAAG,IAAI;AAAA,QAC/F,OAAO,UAAU,MAAM;AAAA,MACzB;AACA,aAAO,GAAG,KAAK,OAAO,CAAC,CAAC;AAAA,IAC1B;AAAA,IACA;AAAS,aAAO;AAAA,EAClB;AACF;;;ADnEA,SAAS,MAAM,MAAa,OAAqB;AAC/C,MAAI,MAAM;AACV,MAAI,MAAM,OAAO;AACf,UAAM,CAAC,GAAG,MAAM,KAAK,IAAI,MAAM,MAAM,MAAM,GAAG;AAC9C,UAAM,MAAM;AACZ,UAAM,IAAI,MAAM,EAAE,KAAK,CAAC,GAAG,MAAO,EAAE,GAAG,IAAK,EAAE,GAAG,IAAK,KAAK,EAAE,GAAG,IAAK,EAAE,GAAG,IAAK,IAAI,CAAE;AACrF,QAAI,QAAQ,OAAQ,KAAI,QAAQ;AAAA,EAClC;AACA,MAAI,MAAM,OAAQ,OAAM,IAAI,MAAM,MAAM,MAAM;AAC9C,MAAI,OAAO,UAAU,MAAM,KAAK,EAAG,OAAM,IAAI,MAAM,GAAG,MAAM,KAAK;AACjE,MAAI,MAAM,QAAQ,MAAM,MAAM,KAAK,MAAM,OAAO,QAAQ;AACtD,UAAM,OAAO,MAAM;AACnB,UAAM,IAAI,IAAI,CAAC,MAAM,OAAO,YAAY,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AAAA,EACrE;AACA,SAAO,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAClC;AAGO,SAAS,cAAc,QAAgB,MAAgB;AAC5D,QAAM,MAAW,EAAE,GAAG,KAAK;AAC3B,aAAW,CAAC,KAAK,GAAG,KAAK,OAAO,QAAQ,OAAO,WAAW,CAAC,CAAC,GAAG;AAC7D,QAAI,IAAI,GAAG,MAAM,UAAa,OAAO,KAAM;AAC3C,UAAM,IAAI,IAAI;AACd,QAAI,KAAK,KAAM;AACf,QAAI,mBAAmB,KAAK,CAAC,EAAG,KAAI,GAAG,QAAI,+BAAW;AAAA,aAC7C,6BAA6B,KAAK,CAAC,EAAG,KAAI,GAAG,KAAI,oBAAI,KAAK,GAAE,YAAY;AAAA,SAC5E;AACH,YAAM,IAAI,WAAW,KAAK,OAAO,CAAC,EAAE,KAAK,CAAC;AAC1C,UAAI,EAAG,KAAI,GAAG,IAAI,EAAE,CAAC;AAAA,IACvB;AAAA,EACF;AACA,SAAO;AACT;AAOO,SAAS,kBAAkB,OAA8B,CAAC,GAAY;AAC3E,QAAM,QAAQ,oBAAI,IAA+B;AACjD,QAAM,MAAM,CAAC,WAAsC;AACjD,QAAI,IAAI,MAAM,IAAI,OAAO,IAAI;AAC7B,QAAI,CAAC,GAAG;AACN,UAAI,oBAAI,IAAI;AACZ,iBAAW,KAAK,KAAK,OAAO,IAAI,KAAK,CAAC,EAAG,GAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC;AACrE,YAAM,IAAI,OAAO,MAAM,CAAC;AAAA,IAC1B;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAmB;AAC5D,YAAM,WAAW,CAAC,GAAG,IAAI,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;AAChF,aAAO,MAAM,UAAU,KAAK;AAAA,IAC9B;AAAA,IACA,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAkB;AAC3D,YAAM,WAAW,CAAC,GAAG,IAAI,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC;AAChF,aAAO,EAAE,OAAO,MAAM,UAAU,KAAK,GAAG,OAAO,SAAS,QAAQ,OAAO,MAAM,OAAO,QAAQ,MAAM,OAAO;AAAA,IAC3G;AAAA,IACA,MAAM,IAAI,QAAgB,IAA0C;AAClE,YAAM,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE;AAC5B,aAAO,IAAI,EAAE,GAAG,EAAE,IAAI;AAAA,IACxB;AAAA,IACA,MAAM,OAAO,QAAgB,MAAyB;AACpD,YAAM,MAAM,cAAc,QAAQ,IAAI;AACtC,UAAI,IAAI,OAAO,EAAE,MAAM,OAAW,KAAI,OAAO,EAAE,QAAI,+BAAW;AAC9D,UAAI,MAAM,EAAE,IAAI,IAAI,OAAO,EAAE,GAAG,GAAG;AACnC,aAAO,EAAE,GAAG,IAAI;AAAA,IAClB;AAAA,IACA,MAAM,OAAO,QAAgB,IAAqB,OAA0B;AAC1E,YAAM,MAAM,IAAI,MAAM,EAAE,IAAI,EAAE;AAC9B,UAAI,CAAC,IAAK,OAAM,IAAI,MAAM,SAAS,OAAO,IAAI,IAAI,OAAO,EAAE,CAAC,YAAY;AACxE,YAAM,MAAW,EAAE,GAAG,KAAK,GAAG,MAAM;AACpC,UAAI,OAAO,SAAS,WAAY,KAAI,cAAa,oBAAI,KAAK,GAAE,YAAY;AACxE,UAAI,MAAM,EAAE,IAAI,IAAI,GAAG;AACvB,aAAO,EAAE,GAAG,IAAI;AAAA,IAClB;AAAA,IACA,MAAM,OAAO,QAAgB,IAAoC;AAC/D,UAAI,MAAM,EAAE,OAAO,EAAE;AAAA,IACvB;AAAA,EACF;AACF;;;AE7EO,SAAS,oBAAoB,QAA+B;AACjE,QAAM,IAAI,OAAO,aAAa,WAAW;AACzC,MAAI,OAAO,MAAM,YAAY;AAC3B,UAAM,IAAI,MAAM,kEAAkE;AAAA,EACpF;AACA,QAAM,OAAO,OAAO,OAAO,YAAY,EAAE,EAAE,QAAQ,OAAO,EAAE;AAC5D,MAAI,CAAC,KAAM,OAAM,IAAI,MAAM,sCAAsC;AAEjE,QAAM,UAAU,CAAC,UAA2D;AAC1E,UAAM,IAA4B,EAAE,gBAAgB,oBAAoB,QAAQ,oBAAoB,GAAG,MAAM;AAC7G,QAAI,OAAO,MAAO,GAAE,gBAAgB,UAAU,OAAO,KAAK;AAC1D,QAAI,OAAO,OAAQ,GAAE,mBAAmB,IAAI,OAAO;AACnD,WAAO;AAAA,EACT;AAEA,iBAAe,IAAI,QAAgB,MAAc,OAA4C,CAAC,GAAqB;AACjH,UAAM,MAAM,MAAM,EAAE,GAAG,IAAI,GAAG,IAAI,IAAI;AAAA,MACpC;AAAA,MACA,SAAS,QAAQ,KAAK,SAAS,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC,CAAC;AAAA,MAC3D,MAAM,KAAK,QAAQ,OAAO,KAAK,UAAU,KAAK,IAAI,IAAI;AAAA,IACxD,CAAC;AACD,UAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,QAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,aAAa,IAAI,MAAM,KAAK,IAAI,EAAE;AAC/D,WAAO,OAAO,KAAK,MAAM,IAAI,IAAI;AAAA,EACnC;AAEA,SAAO;AAAA,IACL,MAAM;AAAA,IACN,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAmB;AAC5D,YAAM,KAAK,SAAS,KAAK,EAAE,SAAS;AACpC,aAAS,MAAM,IAAI,OAAO,IAAI,OAAO,KAAK,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE,EAAE,KAAgB,CAAC;AAAA,IACpF;AAAA,IACA,MAAM,IAAI,QAAgB,IAA0C;AAClE,YAAM,OAAQ,MAAM,IAAI,OAAO,IAAI,OAAO,KAAK,IAAI,OAAO,EAAE,OAAO,mBAAmB,OAAO,EAAE,CAAC,CAAC,UAAU;AAC3G,aAAO,OAAO,CAAC,KAAK;AAAA,IACtB;AAAA,IACA,MAAM,OAAO,QAAgB,MAAyB;AACpD,YAAM,OAAO,MAAM,IAAI,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,MAAM,MAAM,QAAQ,wBAAwB,CAAC;AAClG,aAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAAA,IAC1C;AAAA,IACA,MAAM,OAAO,QAAgB,IAAqB,OAA0B;AAC1E,YAAM,OAAO,MAAM,IAAI,SAAS,IAAI,OAAO,KAAK,IAAI,OAAO,EAAE,OAAO,mBAAmB,OAAO,EAAE,CAAC,CAAC,IAAI;AAAA,QACpG,MAAM;AAAA,QACN,QAAQ;AAAA,MACV,CAAC;AACD,aAAQ,MAAM,QAAQ,IAAI,IAAI,KAAK,CAAC,IAAI;AAAA,IAC1C;AAAA,IACA,MAAM,OAAO,QAAgB,IAAoC;AAC/D,YAAM,IAAI,UAAU,IAAI,OAAO,KAAK,IAAI,OAAO,EAAE,OAAO,mBAAmB,OAAO,EAAE,CAAC,CAAC,EAAE;AAAA,IAC1F;AAAA,IACA,MAAM,KAAK,QAAgB,QAAe,CAAC,GAAkB;AAG3D,YAAM,KAAK,SAAS,KAAK,EAAE,SAAS;AACpC,YAAM,MAAM,MAAM,EAAE,GAAG,IAAI,IAAI,OAAO,KAAK,GAAG,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI;AAAA,QAClE,QAAQ;AAAA,QACR,SAAS,QAAQ,EAAE,QAAQ,cAAc,CAAC;AAAA,MAC5C,CAAC;AACD,YAAM,OAAO,MAAM,IAAI,KAAK;AAC5B,UAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,aAAa,IAAI,MAAM,KAAK,IAAI,EAAE;AAC/D,YAAM,QAAS,OAAO,KAAK,MAAM,IAAI,IAAI,CAAC;AAC1C,YAAM,QAAQ,IAAI,QAAQ,IAAI,eAAe,KAAK;AAClD,YAAM,QAAQ,OAAO,SAAS,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;AAC3D,aAAO;AAAA,QACL;AAAA,QACA,OAAO,OAAO,SAAS,KAAK,IAAI,QAAQ,MAAM;AAAA,QAC9C,OAAO,MAAM;AAAA,QACb,QAAQ,MAAM;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;;;AChEO,SAAS,qBAAqB,SAAwB,CAAC,GAAY;AACxE,QAAM,MAAM,OAAO,OAAO,QAAQ;AAClC,QAAM,IAAI,OAAO,SAAS,KAAK,WAAW,CAAC;AAC3C,QAAM,MAAM,CAAC,SAAyB,EAAE,IAAI,KAAK,EAAE,KAAK,YAAY,CAAC,KAAK;AAE1E,QAAM,SAAS,oBAAoB;AAAA,IACjC,UAAU,IAAI,0BAA0B;AAAA,IACxC,OAAO,IAAI,oBAAoB,KAAK,IAAI,oBAAoB;AAAA,IAC5D,QAAQ,IAAI,mBAAmB,KAAK,IAAI,mBAAmB;AAAA,EAC7D,CAAC;AAED,SAAO,EAAE,GAAG,QAAQ,MAAM,UAAU;AACtC;;;AClBA,IAAM,WAAW,oBAAI,IAA4B;AAE1C,SAAS,gBAAgB,MAAc,SAA+B;AAC3E,WAAS,IAAI,MAAM,OAAO;AAC5B;AAEO,SAAS,eAAyB;AACvC,SAAO,CAAC,GAAG,SAAS,KAAK,CAAC;AAC5B;AAEO,SAAS,cAAc,QAA6D;AACzF,QAAM,OAAO,OAAO,WAAW;AAC/B,QAAM,UAAU,SAAS,IAAI,IAAI;AACjC,MAAI,CAAC,SAAS;AACZ,UAAM,QAAQ,aAAa,EAAE,KAAK,KAAK,KAAK;AAC5C,UAAM,IAAI,MAAM,6BAA6B,IAAI,MAAM,KAAK,GAAG;AAAA,EACjE;AACA,SAAO,QAAQ,MAAM;AACvB;AAEA,gBAAgB,QAAQ,CAAC,MAAM,kBAAkB,EAAE,IAAI,CAAC;AACxD,gBAAgB,UAAU,CAAC,MAAM,oBAAoB,CAAyB,CAAC;AAC/E,gBAAgB,WAAW,CAAC,MAAM,qBAAqB,CAAC,CAAC;;;AC9BzD,IAAM,gBAAsC;AAAA,EAC1C,MAAM,CAAC,QAAQ,KAAK;AAAA,EACpB,QAAQ,CAAC,QAAQ;AAAA,EACjB,QAAQ,CAAC,QAAQ;AAAA,EACjB,QAAQ,CAAC,QAAQ;AACnB;AAGO,SAAS,cAAc,SAAmB,CAAC,GAAY;AAC5D,QAAM,MAAM,oBAAI,IAAQ;AACxB,aAAW,KAAK,OAAQ,EAAC,cAAc,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,MAAM,IAAI,IAAI,CAAC,CAAC;AAC1E,SAAO;AACT;AAaA,SAAS,aAAa,SAAkB,QAA8B;AACpE,QAAM,MAAM,OAAO,eAAe,MAAM,OAAO,MAAM,IAAI,IAAQ,OAAO,OAAO,CAAC,QAAQ,OAAO,UAAU,UAAU,QAAQ,CAAC;AAC5H,QAAM,QAAQ,CAA0C,IAAQ,OAC7D,IAAI,IAAI,EAAE,IACP,MACC,MAAM;AACL,UAAM,IAAI;AAAA,MACR,GAAG,OAAO,IAAI,IAAI,EAAE,mFAA8E,OAAO,IAAI;AAAA,IAC/G;AAAA,EACF;AAEN,SAAO;AAAA,IACL,MAAM,MAAM,QAAQ,CAAC,UAAkB,QAAQ,KAAK,QAAQ,SAAS,CAAC,CAAC,CAAC;AAAA,IACxE,MAAM,MAAM,QAAQ,CAAC,UAAkB;AACrC,UAAI,CAAC,QAAQ,MAAM;AACjB,cAAM,IAAI,MAAM,GAAG,OAAO,IAAI,oCAAoC,QAAQ,IAAI,WAAW;AAAA,MAC3F;AACA,aAAO,QAAQ,KAAK,QAAQ,SAAS,CAAC,CAAC;AAAA,IACzC,CAAC;AAAA,IACD,KAAK,MAAM,OAAO,CAAC,OAAwB,QAAQ,IAAI,QAAQ,EAAE,CAAC;AAAA,IAClE,QAAQ,MAAM,UAAU,CAAC,SAAc,QAAQ,OAAO,QAAQ,IAAI,CAAC;AAAA,IACnE,QAAQ,MAAM,UAAU,CAAC,IAAqB,UAAe,QAAQ,OAAO,QAAQ,IAAI,KAAK,CAAC;AAAA,IAC9F,QAAQ,MAAM,UAAU,CAAC,OAAwB,QAAQ,OAAO,QAAQ,EAAE,CAAC;AAAA,EAC7E;AACF;AAgBO,SAAS,aAAa,QAA8B;AACzD,MAAI,CAAC,QAAQ,SAAU,OAAM,IAAI,MAAM,mDAAmD;AAC1F,QAAM,UAAU,cAAc,MAAM;AACpC,QAAM,KAAK,uBAAO,OAAO,EAAE,WAAW,QAAQ,KAAK,CAAC;AACpD,aAAW,CAAC,MAAM,GAAG,KAAK,OAAO,QAAQ,OAAO,QAAQ,GAAG;AACzD,OAAG,IAAI,IAAI,aAAa,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;AAAA,EACnD;AACA,SAAO;AACT;","names":[]}
|
package/dist/index.d.cts
ADDED
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared runtime types. The generated per-App client (emitted by
|
|
3
|
+
* @revenexx/app-sdk-cli) layers strongly-typed entity interfaces on top of
|
|
4
|
+
* these loose runtime shapes.
|
|
5
|
+
*/
|
|
6
|
+
type FilterOp = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'is';
|
|
7
|
+
type Scalar = string | number | boolean | null;
|
|
8
|
+
/** A PostgREST filter: equality, an `in` list, or an explicit operator. */
|
|
9
|
+
type Filter = Scalar | Scalar[] | {
|
|
10
|
+
op: FilterOp;
|
|
11
|
+
value: unknown;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* The query object is the one interface shared by every adapter: remote/runtime
|
|
15
|
+
* serialise it to a PostgREST querystring, mock applies it in memory — so App
|
|
16
|
+
* code is identical regardless of where the data lives.
|
|
17
|
+
*/
|
|
18
|
+
interface Query<T = Record<string, unknown>> {
|
|
19
|
+
where?: Partial<Record<keyof T & string, Filter>> & Record<string, Filter>;
|
|
20
|
+
select?: (keyof T & string)[] | string[];
|
|
21
|
+
order?: string;
|
|
22
|
+
limit?: number;
|
|
23
|
+
offset?: number;
|
|
24
|
+
}
|
|
25
|
+
type Op = 'list' | 'get' | 'create' | 'update' | 'delete';
|
|
26
|
+
interface ColumnDef {
|
|
27
|
+
type: string;
|
|
28
|
+
pk?: boolean;
|
|
29
|
+
notNull?: boolean;
|
|
30
|
+
default?: string | null;
|
|
31
|
+
check?: string;
|
|
32
|
+
}
|
|
33
|
+
/** A generated entity descriptor: maps an App entity to its real table + ops. */
|
|
34
|
+
interface Entity {
|
|
35
|
+
name: string;
|
|
36
|
+
table: string;
|
|
37
|
+
pk: string;
|
|
38
|
+
columns?: Record<string, ColumnDef>;
|
|
39
|
+
ops?: Op[] | Set<Op>;
|
|
40
|
+
}
|
|
41
|
+
type Row = Record<string, unknown>;
|
|
42
|
+
/** A page of rows plus the total count of matching rows (ignoring limit/offset). */
|
|
43
|
+
interface Page<T = Row> {
|
|
44
|
+
items: T[];
|
|
45
|
+
total: number;
|
|
46
|
+
limit?: number;
|
|
47
|
+
offset?: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* The data-plane contract. Implement this to add a new backend (e.g. GraphQL,
|
|
51
|
+
* a local SQLite file) and register it with `registerAdapter`.
|
|
52
|
+
*
|
|
53
|
+
* `page` is optional: adapters that can report a total (PostgREST `count=exact`,
|
|
54
|
+
* an in-memory store) implement it; others fall back to `list` only.
|
|
55
|
+
*/
|
|
56
|
+
interface Adapter {
|
|
57
|
+
readonly kind: string;
|
|
58
|
+
list(entity: Entity, query?: Query): Promise<Row[]>;
|
|
59
|
+
get(entity: Entity, id: string | number): Promise<Row | null>;
|
|
60
|
+
create(entity: Entity, data: Row): Promise<Row>;
|
|
61
|
+
update(entity: Entity, id: string | number, patch: Row): Promise<Row>;
|
|
62
|
+
remove(entity: Entity, id: string | number): Promise<void>;
|
|
63
|
+
page?(entity: Entity, query?: Query): Promise<Page>;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */
|
|
67
|
+
declare function opsFromAccess(access?: string[]): Set<Op>;
|
|
68
|
+
/** The methods exposed for a single entity; absent ops throw at call time. */
|
|
69
|
+
interface EntityClient<T extends Row = Row, Create extends Row = T> {
|
|
70
|
+
list(query?: Query<T>): Promise<T[]>;
|
|
71
|
+
/** Like `list`, but also returns the total count of matching rows (for pagination). */
|
|
72
|
+
page(query?: Query<T>): Promise<Page<T>>;
|
|
73
|
+
get(id: string | number): Promise<T | null>;
|
|
74
|
+
create(data: Create): Promise<T>;
|
|
75
|
+
update(id: string | number, patch: Partial<Create>): Promise<T>;
|
|
76
|
+
delete(id: string | number): Promise<void>;
|
|
77
|
+
}
|
|
78
|
+
interface ClientConfig {
|
|
79
|
+
adapter: string;
|
|
80
|
+
entities: Record<string, Omit<Entity, 'name'>>;
|
|
81
|
+
[key: string]: unknown;
|
|
82
|
+
}
|
|
83
|
+
type Client = Record<string, EntityClient> & {
|
|
84
|
+
readonly __adapter: string;
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* Build a typed entity client.
|
|
88
|
+
* local dev : createClient({ adapter: 'mock', entities, seed })
|
|
89
|
+
* dev tenant: createClient({ adapter: 'remote', entities, endpoint, token, tenant })
|
|
90
|
+
* production: createClient({ adapter: 'runtime', entities, context }) // in the function
|
|
91
|
+
*/
|
|
92
|
+
declare function createClient(config: ClientConfig): Client;
|
|
93
|
+
|
|
94
|
+
/** Serialise a query object to PostgREST URLSearchParams. */
|
|
95
|
+
declare function toParams(query?: Query): URLSearchParams;
|
|
96
|
+
/** In-memory predicate mirroring `toParams`' `where` semantics (mock adapter). */
|
|
97
|
+
declare function matches(row: Row, where?: Query['where']): boolean;
|
|
98
|
+
|
|
99
|
+
/** Best-effort apply of schema.json column defaults for the mock adapter. */
|
|
100
|
+
declare function applyDefaults(entity: Entity, data: Row): Row;
|
|
101
|
+
/**
|
|
102
|
+
* In-memory adapter. Zero infrastructure: develop + unit-test App logic against
|
|
103
|
+
* fixtures. Does NOT enforce RLS, constraints, triggers or PostgREST semantics —
|
|
104
|
+
* run the `remote` adapter against a dev tenant for that fidelity before deploy.
|
|
105
|
+
*/
|
|
106
|
+
declare function createMockAdapter(seed?: Record<string, Row[]>): Adapter;
|
|
107
|
+
|
|
108
|
+
interface RemoteConfig {
|
|
109
|
+
endpoint: string;
|
|
110
|
+
token?: string;
|
|
111
|
+
tenant?: string;
|
|
112
|
+
fetchImpl?: typeof fetch;
|
|
113
|
+
}
|
|
114
|
+
/** PostgREST-over-HTTP adapter (production data plane / dev tenant). */
|
|
115
|
+
declare function createRemoteAdapter(config: RemoteConfig): Adapter;
|
|
116
|
+
|
|
117
|
+
interface FunctionContext {
|
|
118
|
+
req?: {
|
|
119
|
+
headers?: Record<string, string>;
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
interface RuntimeConfig {
|
|
123
|
+
context?: FunctionContext;
|
|
124
|
+
env?: Record<string, string | undefined>;
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* Production adapter: a `remote` adapter auto-configured from the function's
|
|
128
|
+
* per-invocation context (ADR-0057). Token = the brokered identity forwarded as
|
|
129
|
+
* `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env. App code
|
|
130
|
+
* stays identical — only the adapter selection differs between local and prod.
|
|
131
|
+
*/
|
|
132
|
+
declare function createRuntimeAdapter(config?: RuntimeConfig): Adapter;
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* Adapter registry. Built-ins (mock | remote | runtime) are registered below;
|
|
136
|
+
* add a new backend by calling `registerAdapter('my-kind', (config) => …)`
|
|
137
|
+
* before constructing the client — no changes to the client or generated code.
|
|
138
|
+
*/
|
|
139
|
+
type AdapterFactory = (config: Record<string, any>) => Adapter;
|
|
140
|
+
declare function registerAdapter(kind: string, factory: AdapterFactory): void;
|
|
141
|
+
declare function adapterKinds(): string[];
|
|
142
|
+
declare function createAdapter(config: {
|
|
143
|
+
adapter?: string;
|
|
144
|
+
} & Record<string, any>): Adapter;
|
|
145
|
+
|
|
146
|
+
export { type Adapter, type AdapterFactory, type Client, type ClientConfig, type ColumnDef, type Entity, type EntityClient, type Filter, type FilterOp, type Op, type Page, type Query, type RemoteConfig, type Row, type RuntimeConfig, type Scalar, adapterKinds, applyDefaults, createAdapter, createClient, createMockAdapter, createRemoteAdapter, createRuntimeAdapter, matches, opsFromAccess, registerAdapter, toParams };
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,146 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared runtime types. The generated per-App client (emitted by
|
|
3
|
+
* @revenexx/app-sdk-cli) layers strongly-typed entity interfaces on top of
|
|
4
|
+
* these loose runtime shapes.
|
|
5
|
+
*/
|
|
6
|
+
type FilterOp = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'is';
|
|
7
|
+
type Scalar = string | number | boolean | null;
|
|
8
|
+
/** A PostgREST filter: equality, an `in` list, or an explicit operator. */
|
|
9
|
+
type Filter = Scalar | Scalar[] | {
|
|
10
|
+
op: FilterOp;
|
|
11
|
+
value: unknown;
|
|
12
|
+
};
|
|
13
|
+
/**
|
|
14
|
+
* The query object is the one interface shared by every adapter: remote/runtime
|
|
15
|
+
* serialise it to a PostgREST querystring, mock applies it in memory — so App
|
|
16
|
+
* code is identical regardless of where the data lives.
|
|
17
|
+
*/
|
|
18
|
+
interface Query<T = Record<string, unknown>> {
|
|
19
|
+
where?: Partial<Record<keyof T & string, Filter>> & Record<string, Filter>;
|
|
20
|
+
select?: (keyof T & string)[] | string[];
|
|
21
|
+
order?: string;
|
|
22
|
+
limit?: number;
|
|
23
|
+
offset?: number;
|
|
24
|
+
}
|
|
25
|
+
type Op = 'list' | 'get' | 'create' | 'update' | 'delete';
|
|
26
|
+
interface ColumnDef {
|
|
27
|
+
type: string;
|
|
28
|
+
pk?: boolean;
|
|
29
|
+
notNull?: boolean;
|
|
30
|
+
default?: string | null;
|
|
31
|
+
check?: string;
|
|
32
|
+
}
|
|
33
|
+
/** A generated entity descriptor: maps an App entity to its real table + ops. */
|
|
34
|
+
interface Entity {
|
|
35
|
+
name: string;
|
|
36
|
+
table: string;
|
|
37
|
+
pk: string;
|
|
38
|
+
columns?: Record<string, ColumnDef>;
|
|
39
|
+
ops?: Op[] | Set<Op>;
|
|
40
|
+
}
|
|
41
|
+
type Row = Record<string, unknown>;
|
|
42
|
+
/** A page of rows plus the total count of matching rows (ignoring limit/offset). */
|
|
43
|
+
interface Page<T = Row> {
|
|
44
|
+
items: T[];
|
|
45
|
+
total: number;
|
|
46
|
+
limit?: number;
|
|
47
|
+
offset?: number;
|
|
48
|
+
}
|
|
49
|
+
/**
|
|
50
|
+
* The data-plane contract. Implement this to add a new backend (e.g. GraphQL,
|
|
51
|
+
* a local SQLite file) and register it with `registerAdapter`.
|
|
52
|
+
*
|
|
53
|
+
* `page` is optional: adapters that can report a total (PostgREST `count=exact`,
|
|
54
|
+
* an in-memory store) implement it; others fall back to `list` only.
|
|
55
|
+
*/
|
|
56
|
+
interface Adapter {
|
|
57
|
+
readonly kind: string;
|
|
58
|
+
list(entity: Entity, query?: Query): Promise<Row[]>;
|
|
59
|
+
get(entity: Entity, id: string | number): Promise<Row | null>;
|
|
60
|
+
create(entity: Entity, data: Row): Promise<Row>;
|
|
61
|
+
update(entity: Entity, id: string | number, patch: Row): Promise<Row>;
|
|
62
|
+
remove(entity: Entity, id: string | number): Promise<void>;
|
|
63
|
+
page?(entity: Entity, query?: Query): Promise<Page>;
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */
|
|
67
|
+
declare function opsFromAccess(access?: string[]): Set<Op>;
|
|
68
|
+
/** The methods exposed for a single entity; absent ops throw at call time. */
|
|
69
|
+
interface EntityClient<T extends Row = Row, Create extends Row = T> {
|
|
70
|
+
list(query?: Query<T>): Promise<T[]>;
|
|
71
|
+
/** Like `list`, but also returns the total count of matching rows (for pagination). */
|
|
72
|
+
page(query?: Query<T>): Promise<Page<T>>;
|
|
73
|
+
get(id: string | number): Promise<T | null>;
|
|
74
|
+
create(data: Create): Promise<T>;
|
|
75
|
+
update(id: string | number, patch: Partial<Create>): Promise<T>;
|
|
76
|
+
delete(id: string | number): Promise<void>;
|
|
77
|
+
}
|
|
78
|
+
interface ClientConfig {
|
|
79
|
+
adapter: string;
|
|
80
|
+
entities: Record<string, Omit<Entity, 'name'>>;
|
|
81
|
+
[key: string]: unknown;
|
|
82
|
+
}
|
|
83
|
+
type Client = Record<string, EntityClient> & {
|
|
84
|
+
readonly __adapter: string;
|
|
85
|
+
};
|
|
86
|
+
/**
|
|
87
|
+
* Build a typed entity client.
|
|
88
|
+
* local dev : createClient({ adapter: 'mock', entities, seed })
|
|
89
|
+
* dev tenant: createClient({ adapter: 'remote', entities, endpoint, token, tenant })
|
|
90
|
+
* production: createClient({ adapter: 'runtime', entities, context }) // in the function
|
|
91
|
+
*/
|
|
92
|
+
declare function createClient(config: ClientConfig): Client;
|
|
93
|
+
|
|
94
|
+
/** Serialise a query object to PostgREST URLSearchParams. */
|
|
95
|
+
declare function toParams(query?: Query): URLSearchParams;
|
|
96
|
+
/** In-memory predicate mirroring `toParams`' `where` semantics (mock adapter). */
|
|
97
|
+
declare function matches(row: Row, where?: Query['where']): boolean;
|
|
98
|
+
|
|
99
|
+
/** Best-effort apply of schema.json column defaults for the mock adapter. */
|
|
100
|
+
declare function applyDefaults(entity: Entity, data: Row): Row;
|
|
101
|
+
/**
|
|
102
|
+
* In-memory adapter. Zero infrastructure: develop + unit-test App logic against
|
|
103
|
+
* fixtures. Does NOT enforce RLS, constraints, triggers or PostgREST semantics —
|
|
104
|
+
* run the `remote` adapter against a dev tenant for that fidelity before deploy.
|
|
105
|
+
*/
|
|
106
|
+
declare function createMockAdapter(seed?: Record<string, Row[]>): Adapter;
|
|
107
|
+
|
|
108
|
+
interface RemoteConfig {
|
|
109
|
+
endpoint: string;
|
|
110
|
+
token?: string;
|
|
111
|
+
tenant?: string;
|
|
112
|
+
fetchImpl?: typeof fetch;
|
|
113
|
+
}
|
|
114
|
+
/** PostgREST-over-HTTP adapter (production data plane / dev tenant). */
|
|
115
|
+
declare function createRemoteAdapter(config: RemoteConfig): Adapter;
|
|
116
|
+
|
|
117
|
+
interface FunctionContext {
|
|
118
|
+
req?: {
|
|
119
|
+
headers?: Record<string, string>;
|
|
120
|
+
};
|
|
121
|
+
}
|
|
122
|
+
interface RuntimeConfig {
|
|
123
|
+
context?: FunctionContext;
|
|
124
|
+
env?: Record<string, string | undefined>;
|
|
125
|
+
}
|
|
126
|
+
/**
|
|
127
|
+
* Production adapter: a `remote` adapter auto-configured from the function's
|
|
128
|
+
* per-invocation context (ADR-0057). Token = the brokered identity forwarded as
|
|
129
|
+
* `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env. App code
|
|
130
|
+
* stays identical — only the adapter selection differs between local and prod.
|
|
131
|
+
*/
|
|
132
|
+
declare function createRuntimeAdapter(config?: RuntimeConfig): Adapter;
|
|
133
|
+
|
|
134
|
+
/**
|
|
135
|
+
* Adapter registry. Built-ins (mock | remote | runtime) are registered below;
|
|
136
|
+
* add a new backend by calling `registerAdapter('my-kind', (config) => …)`
|
|
137
|
+
* before constructing the client — no changes to the client or generated code.
|
|
138
|
+
*/
|
|
139
|
+
type AdapterFactory = (config: Record<string, any>) => Adapter;
|
|
140
|
+
declare function registerAdapter(kind: string, factory: AdapterFactory): void;
|
|
141
|
+
declare function adapterKinds(): string[];
|
|
142
|
+
declare function createAdapter(config: {
|
|
143
|
+
adapter?: string;
|
|
144
|
+
} & Record<string, any>): Adapter;
|
|
145
|
+
|
|
146
|
+
export { type Adapter, type AdapterFactory, type Client, type ClientConfig, type ColumnDef, type Entity, type EntityClient, type Filter, type FilterOp, type Op, type Page, type Query, type RemoteConfig, type Row, type RuntimeConfig, type Scalar, adapterKinds, applyDefaults, createAdapter, createClient, createMockAdapter, createRemoteAdapter, createRuntimeAdapter, matches, opsFromAccess, registerAdapter, toParams };
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,307 @@
|
|
|
1
|
+
// src/adapters/mock.ts
|
|
2
|
+
import { randomUUID } from "crypto";
|
|
3
|
+
|
|
4
|
+
// src/query.ts
|
|
5
|
+
var OPS = /* @__PURE__ */ new Set(["eq", "neq", "gt", "gte", "lt", "lte", "like", "ilike", "in", "is"]);
|
|
6
|
+
function toParams(query = {}) {
|
|
7
|
+
const params = new URLSearchParams();
|
|
8
|
+
const { where = {}, select, order, limit, offset } = query;
|
|
9
|
+
for (const [col, cond] of Object.entries(where)) {
|
|
10
|
+
if (Array.isArray(cond)) {
|
|
11
|
+
params.append(col, `in.(${cond.join(",")})`);
|
|
12
|
+
} else if (cond && typeof cond === "object" && typeof cond.op === "string") {
|
|
13
|
+
const c = cond;
|
|
14
|
+
if (!OPS.has(c.op)) throw new Error(`query: unsupported operator '${c.op}'`);
|
|
15
|
+
const v = Array.isArray(c.value) ? `(${c.value.join(",")})` : c.value;
|
|
16
|
+
params.append(col, `${c.op}.${v}`);
|
|
17
|
+
} else {
|
|
18
|
+
params.append(col, `eq.${cond}`);
|
|
19
|
+
}
|
|
20
|
+
}
|
|
21
|
+
if (Array.isArray(select) && select.length) params.set("select", select.join(","));
|
|
22
|
+
if (order) params.set("order", /\.(asc|desc)$/.test(order) ? order : `${order}.asc`);
|
|
23
|
+
if (Number.isInteger(limit)) params.set("limit", String(limit));
|
|
24
|
+
if (Number.isInteger(offset)) params.set("offset", String(offset));
|
|
25
|
+
return params;
|
|
26
|
+
}
|
|
27
|
+
function matches(row, where = {}) {
|
|
28
|
+
for (const [col, cond] of Object.entries(where)) {
|
|
29
|
+
const val = row[col];
|
|
30
|
+
if (Array.isArray(cond)) {
|
|
31
|
+
if (!cond.includes(val)) return false;
|
|
32
|
+
} else if (cond && typeof cond === "object" && typeof cond.op === "string") {
|
|
33
|
+
const c = cond;
|
|
34
|
+
if (!compare(val, c.op, c.value)) return false;
|
|
35
|
+
} else if (val !== cond) {
|
|
36
|
+
return false;
|
|
37
|
+
}
|
|
38
|
+
}
|
|
39
|
+
return true;
|
|
40
|
+
}
|
|
41
|
+
function compare(a, op, b) {
|
|
42
|
+
switch (op) {
|
|
43
|
+
case "eq":
|
|
44
|
+
return a === b;
|
|
45
|
+
case "neq":
|
|
46
|
+
return a !== b;
|
|
47
|
+
case "gt":
|
|
48
|
+
return a > b;
|
|
49
|
+
case "gte":
|
|
50
|
+
return a >= b;
|
|
51
|
+
case "lt":
|
|
52
|
+
return a < b;
|
|
53
|
+
case "lte":
|
|
54
|
+
return a <= b;
|
|
55
|
+
case "is":
|
|
56
|
+
return a === b;
|
|
57
|
+
case "in":
|
|
58
|
+
return Array.isArray(b) && b.includes(a);
|
|
59
|
+
case "like":
|
|
60
|
+
case "ilike": {
|
|
61
|
+
const re = new RegExp(
|
|
62
|
+
"^" + String(b).replace(/[.+?^${}()|[\]\\]/g, "\\$&").replace(/%/g, ".*").replace(/_/g, ".") + "$",
|
|
63
|
+
op === "ilike" ? "i" : ""
|
|
64
|
+
);
|
|
65
|
+
return re.test(String(a));
|
|
66
|
+
}
|
|
67
|
+
default:
|
|
68
|
+
return false;
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
// src/adapters/mock.ts
|
|
73
|
+
function shape(rows, query) {
|
|
74
|
+
let out = rows;
|
|
75
|
+
if (query.order) {
|
|
76
|
+
const [c, dir = "asc"] = query.order.split(".");
|
|
77
|
+
const key = c;
|
|
78
|
+
out = out.slice().sort((a, b) => a[key] < b[key] ? -1 : a[key] > b[key] ? 1 : 0);
|
|
79
|
+
if (dir === "desc") out.reverse();
|
|
80
|
+
}
|
|
81
|
+
if (query.offset) out = out.slice(query.offset);
|
|
82
|
+
if (Number.isInteger(query.limit)) out = out.slice(0, query.limit);
|
|
83
|
+
if (Array.isArray(query.select) && query.select.length) {
|
|
84
|
+
const cols = query.select;
|
|
85
|
+
out = out.map((r) => Object.fromEntries(cols.map((c) => [c, r[c]])));
|
|
86
|
+
}
|
|
87
|
+
return out.map((r) => ({ ...r }));
|
|
88
|
+
}
|
|
89
|
+
function applyDefaults(entity, data) {
|
|
90
|
+
const row = { ...data };
|
|
91
|
+
for (const [col, def] of Object.entries(entity.columns ?? {})) {
|
|
92
|
+
if (row[col] !== void 0 || def == null) continue;
|
|
93
|
+
const d = def.default;
|
|
94
|
+
if (d == null) continue;
|
|
95
|
+
if (/gen_random_uuid/i.test(d)) row[col] = randomUUID();
|
|
96
|
+
else if (/now\(\)|current_timestamp/i.test(d)) row[col] = (/* @__PURE__ */ new Date()).toISOString();
|
|
97
|
+
else {
|
|
98
|
+
const m = /^'(.*)'$/.exec(String(d).trim());
|
|
99
|
+
if (m) row[col] = m[1];
|
|
100
|
+
}
|
|
101
|
+
}
|
|
102
|
+
return row;
|
|
103
|
+
}
|
|
104
|
+
function createMockAdapter(seed = {}) {
|
|
105
|
+
const store = /* @__PURE__ */ new Map();
|
|
106
|
+
const tbl = (entity) => {
|
|
107
|
+
let m = store.get(entity.name);
|
|
108
|
+
if (!m) {
|
|
109
|
+
m = /* @__PURE__ */ new Map();
|
|
110
|
+
for (const r of seed[entity.name] ?? []) m.set(r[entity.pk], { ...r });
|
|
111
|
+
store.set(entity.name, m);
|
|
112
|
+
}
|
|
113
|
+
return m;
|
|
114
|
+
};
|
|
115
|
+
return {
|
|
116
|
+
kind: "mock",
|
|
117
|
+
async list(entity, query = {}) {
|
|
118
|
+
const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));
|
|
119
|
+
return shape(filtered, query);
|
|
120
|
+
},
|
|
121
|
+
async page(entity, query = {}) {
|
|
122
|
+
const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));
|
|
123
|
+
return { items: shape(filtered, query), total: filtered.length, limit: query.limit, offset: query.offset };
|
|
124
|
+
},
|
|
125
|
+
async get(entity, id) {
|
|
126
|
+
const r = tbl(entity).get(id);
|
|
127
|
+
return r ? { ...r } : null;
|
|
128
|
+
},
|
|
129
|
+
async create(entity, data) {
|
|
130
|
+
const row = applyDefaults(entity, data);
|
|
131
|
+
if (row[entity.pk] === void 0) row[entity.pk] = randomUUID();
|
|
132
|
+
tbl(entity).set(row[entity.pk], row);
|
|
133
|
+
return { ...row };
|
|
134
|
+
},
|
|
135
|
+
async update(entity, id, patch) {
|
|
136
|
+
const cur = tbl(entity).get(id);
|
|
137
|
+
if (!cur) throw new Error(`mock: ${entity.name}/${String(id)} not found`);
|
|
138
|
+
const row = { ...cur, ...patch };
|
|
139
|
+
if (entity.columns?.updated_at) row.updated_at = (/* @__PURE__ */ new Date()).toISOString();
|
|
140
|
+
tbl(entity).set(id, row);
|
|
141
|
+
return { ...row };
|
|
142
|
+
},
|
|
143
|
+
async remove(entity, id) {
|
|
144
|
+
tbl(entity).delete(id);
|
|
145
|
+
}
|
|
146
|
+
};
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
// src/adapters/remote.ts
|
|
150
|
+
function createRemoteAdapter(config) {
|
|
151
|
+
const f = config.fetchImpl ?? globalThis.fetch;
|
|
152
|
+
if (typeof f !== "function") {
|
|
153
|
+
throw new Error("remote adapter: no fetch available (Node >=18 or pass fetchImpl)");
|
|
154
|
+
}
|
|
155
|
+
const base = String(config.endpoint ?? "").replace(/\/$/, "");
|
|
156
|
+
if (!base) throw new Error("remote adapter: endpoint is required");
|
|
157
|
+
const headers = (extra) => {
|
|
158
|
+
const h = { "Content-Type": "application/json", Accept: "application/json", ...extra };
|
|
159
|
+
if (config.token) h.Authorization = `Bearer ${config.token}`;
|
|
160
|
+
if (config.tenant) h["X-Revenexx-Tenant"] = config.tenant;
|
|
161
|
+
return h;
|
|
162
|
+
};
|
|
163
|
+
async function req(method, path, opts = {}) {
|
|
164
|
+
const res = await f(`${base}${path}`, {
|
|
165
|
+
method,
|
|
166
|
+
headers: headers(opts.prefer ? { Prefer: opts.prefer } : {}),
|
|
167
|
+
body: opts.body != null ? JSON.stringify(opts.body) : void 0
|
|
168
|
+
});
|
|
169
|
+
const text = await res.text();
|
|
170
|
+
if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);
|
|
171
|
+
return text ? JSON.parse(text) : null;
|
|
172
|
+
}
|
|
173
|
+
return {
|
|
174
|
+
kind: "remote",
|
|
175
|
+
async list(entity, query = {}) {
|
|
176
|
+
const qs = toParams(query).toString();
|
|
177
|
+
return await req("GET", `/${entity.table}${qs ? `?${qs}` : ""}`) ?? [];
|
|
178
|
+
},
|
|
179
|
+
async get(entity, id) {
|
|
180
|
+
const rows = await req("GET", `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}&limit=1`);
|
|
181
|
+
return rows?.[0] ?? null;
|
|
182
|
+
},
|
|
183
|
+
async create(entity, data) {
|
|
184
|
+
const rows = await req("POST", `/${entity.table}`, { body: data, prefer: "return=representation" });
|
|
185
|
+
return Array.isArray(rows) ? rows[0] : rows;
|
|
186
|
+
},
|
|
187
|
+
async update(entity, id, patch) {
|
|
188
|
+
const rows = await req("PATCH", `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {
|
|
189
|
+
body: patch,
|
|
190
|
+
prefer: "return=representation"
|
|
191
|
+
});
|
|
192
|
+
return Array.isArray(rows) ? rows[0] : rows;
|
|
193
|
+
},
|
|
194
|
+
async remove(entity, id) {
|
|
195
|
+
await req("DELETE", `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`);
|
|
196
|
+
},
|
|
197
|
+
async page(entity, query = {}) {
|
|
198
|
+
const qs = toParams(query).toString();
|
|
199
|
+
const res = await f(`${base}/${entity.table}${qs ? `?${qs}` : ""}`, {
|
|
200
|
+
method: "GET",
|
|
201
|
+
headers: headers({ Prefer: "count=exact" })
|
|
202
|
+
});
|
|
203
|
+
const text = await res.text();
|
|
204
|
+
if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);
|
|
205
|
+
const items = text ? JSON.parse(text) : [];
|
|
206
|
+
const range = res.headers.get("content-range") ?? "";
|
|
207
|
+
const total = Number.parseInt(range.split("/")[1] ?? "", 10);
|
|
208
|
+
return {
|
|
209
|
+
items,
|
|
210
|
+
total: Number.isFinite(total) ? total : items.length,
|
|
211
|
+
limit: query.limit,
|
|
212
|
+
offset: query.offset
|
|
213
|
+
};
|
|
214
|
+
}
|
|
215
|
+
};
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
// src/adapters/runtime.ts
|
|
219
|
+
function createRuntimeAdapter(config = {}) {
|
|
220
|
+
const env = config.env ?? process.env;
|
|
221
|
+
const h = config.context?.req?.headers ?? {};
|
|
222
|
+
const get = (name) => h[name] ?? h[name.toLowerCase()] ?? "";
|
|
223
|
+
const remote = createRemoteAdapter({
|
|
224
|
+
endpoint: env.REVENEXX_DATA_ENDPOINT ?? "",
|
|
225
|
+
token: get("x-revenexx-context") || env.REVENEXX_CONTEXT || "",
|
|
226
|
+
tenant: get("x-revenexx-tenant") || env.REVENEXX_TENANT || ""
|
|
227
|
+
});
|
|
228
|
+
return { ...remote, kind: "runtime" };
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
// src/adapters/index.ts
|
|
232
|
+
var registry = /* @__PURE__ */ new Map();
|
|
233
|
+
function registerAdapter(kind, factory) {
|
|
234
|
+
registry.set(kind, factory);
|
|
235
|
+
}
|
|
236
|
+
function adapterKinds() {
|
|
237
|
+
return [...registry.keys()];
|
|
238
|
+
}
|
|
239
|
+
function createAdapter(config) {
|
|
240
|
+
const kind = config.adapter ?? "";
|
|
241
|
+
const factory = registry.get(kind);
|
|
242
|
+
if (!factory) {
|
|
243
|
+
const known = adapterKinds().join(" | ") || "none registered";
|
|
244
|
+
throw new Error(`app-sdk: unknown adapter '${kind}' (${known})`);
|
|
245
|
+
}
|
|
246
|
+
return factory(config);
|
|
247
|
+
}
|
|
248
|
+
registerAdapter("mock", (c) => createMockAdapter(c.seed));
|
|
249
|
+
registerAdapter("remote", (c) => createRemoteAdapter(c));
|
|
250
|
+
registerAdapter("runtime", (c) => createRuntimeAdapter(c));
|
|
251
|
+
|
|
252
|
+
// src/client.ts
|
|
253
|
+
var ACCESS_TO_OPS = {
|
|
254
|
+
read: ["list", "get"],
|
|
255
|
+
create: ["create"],
|
|
256
|
+
update: ["update"],
|
|
257
|
+
delete: ["delete"]
|
|
258
|
+
};
|
|
259
|
+
function opsFromAccess(access = []) {
|
|
260
|
+
const ops = /* @__PURE__ */ new Set();
|
|
261
|
+
for (const a of access) (ACCESS_TO_OPS[a] ?? []).forEach((o) => ops.add(o));
|
|
262
|
+
return ops;
|
|
263
|
+
}
|
|
264
|
+
function entityClient(adapter, entity) {
|
|
265
|
+
const ops = entity.ops instanceof Set ? entity.ops : new Set(entity.ops ?? ["list", "get", "create", "update", "delete"]);
|
|
266
|
+
const guard = (op, fn) => ops.has(op) ? fn : (() => {
|
|
267
|
+
throw new Error(
|
|
268
|
+
`${entity.name}.${op}() is not permitted \u2014 add the matching access to manifest.permissions for '${entity.name}'`
|
|
269
|
+
);
|
|
270
|
+
});
|
|
271
|
+
return {
|
|
272
|
+
list: guard("list", (query) => adapter.list(entity, query ?? {})),
|
|
273
|
+
page: guard("list", (query) => {
|
|
274
|
+
if (!adapter.page) {
|
|
275
|
+
throw new Error(`${entity.name}.page() is not supported by the '${adapter.kind}' adapter`);
|
|
276
|
+
}
|
|
277
|
+
return adapter.page(entity, query ?? {});
|
|
278
|
+
}),
|
|
279
|
+
get: guard("get", (id) => adapter.get(entity, id)),
|
|
280
|
+
create: guard("create", (data) => adapter.create(entity, data)),
|
|
281
|
+
update: guard("update", (id, patch) => adapter.update(entity, id, patch)),
|
|
282
|
+
delete: guard("delete", (id) => adapter.remove(entity, id))
|
|
283
|
+
};
|
|
284
|
+
}
|
|
285
|
+
function createClient(config) {
|
|
286
|
+
if (!config?.entities) throw new Error("app-sdk: createClient needs { adapter, entities }");
|
|
287
|
+
const adapter = createAdapter(config);
|
|
288
|
+
const db = /* @__PURE__ */ Object.create({ __adapter: adapter.kind });
|
|
289
|
+
for (const [name, def] of Object.entries(config.entities)) {
|
|
290
|
+
db[name] = entityClient(adapter, { name, ...def });
|
|
291
|
+
}
|
|
292
|
+
return db;
|
|
293
|
+
}
|
|
294
|
+
export {
|
|
295
|
+
adapterKinds,
|
|
296
|
+
applyDefaults,
|
|
297
|
+
createAdapter,
|
|
298
|
+
createClient,
|
|
299
|
+
createMockAdapter,
|
|
300
|
+
createRemoteAdapter,
|
|
301
|
+
createRuntimeAdapter,
|
|
302
|
+
matches,
|
|
303
|
+
opsFromAccess,
|
|
304
|
+
registerAdapter,
|
|
305
|
+
toParams
|
|
306
|
+
};
|
|
307
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/adapters/mock.ts","../src/query.ts","../src/adapters/remote.ts","../src/adapters/runtime.ts","../src/adapters/index.ts","../src/client.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { matches } from '../query.js';\n\n/** Apply order → offset → limit → select to an already-filtered row set. */\nfunction shape(rows: Row[], query: Query): Row[] {\n let out = rows;\n if (query.order) {\n const [c, dir = 'asc'] = query.order.split('.');\n const key = c as string;\n out = out.slice().sort((a, b) => (a[key]! < b[key]! ? -1 : a[key]! > b[key]! ? 1 : 0));\n if (dir === 'desc') out.reverse();\n }\n if (query.offset) out = out.slice(query.offset);\n if (Number.isInteger(query.limit)) out = out.slice(0, query.limit);\n if (Array.isArray(query.select) && query.select.length) {\n const cols = query.select as string[];\n out = out.map((r) => Object.fromEntries(cols.map((c) => [c, r[c]])));\n }\n return out.map((r) => ({ ...r }));\n}\n\n/** Best-effort apply of schema.json column defaults for the mock adapter. */\nexport function applyDefaults(entity: Entity, data: Row): Row {\n const row: Row = { ...data };\n for (const [col, def] of Object.entries(entity.columns ?? {})) {\n if (row[col] !== undefined || def == null) continue;\n const d = def.default;\n if (d == null) continue;\n if (/gen_random_uuid/i.test(d)) row[col] = randomUUID();\n else if (/now\\(\\)|current_timestamp/i.test(d)) row[col] = new Date().toISOString();\n else {\n const m = /^'(.*)'$/.exec(String(d).trim());\n if (m) row[col] = m[1];\n }\n }\n return row;\n}\n\n/**\n * In-memory adapter. Zero infrastructure: develop + unit-test App logic against\n * fixtures. Does NOT enforce RLS, constraints, triggers or PostgREST semantics —\n * run the `remote` adapter against a dev tenant for that fidelity before deploy.\n */\nexport function createMockAdapter(seed: Record<string, Row[]> = {}): Adapter {\n const store = new Map<string, Map<unknown, Row>>();\n const tbl = (entity: Entity): Map<unknown, Row> => {\n let m = store.get(entity.name);\n if (!m) {\n m = new Map();\n for (const r of seed[entity.name] ?? []) m.set(r[entity.pk], { ...r });\n store.set(entity.name, m);\n }\n return m;\n };\n\n return {\n kind: 'mock',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return shape(filtered, query);\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n const filtered = [...tbl(entity).values()].filter((r) => matches(r, query.where));\n return { items: shape(filtered, query), total: filtered.length, limit: query.limit, offset: query.offset };\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const r = tbl(entity).get(id);\n return r ? { ...r } : null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const row = applyDefaults(entity, data);\n if (row[entity.pk] === undefined) row[entity.pk] = randomUUID();\n tbl(entity).set(row[entity.pk], row);\n return { ...row };\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const cur = tbl(entity).get(id);\n if (!cur) throw new Error(`mock: ${entity.name}/${String(id)} not found`);\n const row: Row = { ...cur, ...patch };\n if (entity.columns?.updated_at) row.updated_at = new Date().toISOString();\n tbl(entity).set(id, row);\n return { ...row };\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n tbl(entity).delete(id);\n },\n };\n}\n","import type { Query, FilterOp, Row } from './types.js';\n\n/**\n * PostgREST query helpers. `toParams` serialises a query for the HTTP adapters;\n * `matches` applies the same `where` semantics in memory for the mock adapter —\n * keeping one shape means App code is identical across adapters.\n */\n\nconst OPS = new Set<FilterOp>(['eq', 'neq', 'gt', 'gte', 'lt', 'lte', 'like', 'ilike', 'in', 'is']);\n\n/** Serialise a query object to PostgREST URLSearchParams. */\nexport function toParams(query: Query = {}): URLSearchParams {\n const params = new URLSearchParams();\n const { where = {}, select, order, limit, offset } = query;\n\n for (const [col, cond] of Object.entries(where)) {\n if (Array.isArray(cond)) {\n params.append(col, `in.(${cond.join(',')})`);\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!OPS.has(c.op)) throw new Error(`query: unsupported operator '${c.op}'`);\n const v = Array.isArray(c.value) ? `(${c.value.join(',')})` : c.value;\n params.append(col, `${c.op}.${v}`);\n } else {\n params.append(col, `eq.${cond}`);\n }\n }\n\n if (Array.isArray(select) && select.length) params.set('select', (select as string[]).join(','));\n if (order) params.set('order', /\\.(asc|desc)$/.test(order) ? order : `${order}.asc`);\n if (Number.isInteger(limit)) params.set('limit', String(limit));\n if (Number.isInteger(offset)) params.set('offset', String(offset));\n\n return params;\n}\n\n/** In-memory predicate mirroring `toParams`' `where` semantics (mock adapter). */\nexport function matches(row: Row, where: Query['where'] = {}): boolean {\n for (const [col, cond] of Object.entries(where)) {\n const val = row[col];\n if (Array.isArray(cond)) {\n if (!cond.includes(val as never)) return false;\n } else if (cond && typeof cond === 'object' && typeof (cond as { op?: unknown }).op === 'string') {\n const c = cond as { op: FilterOp; value: unknown };\n if (!compare(val, c.op, c.value)) return false;\n } else if (val !== cond) {\n return false;\n }\n }\n return true;\n}\n\nfunction compare(a: unknown, op: FilterOp, b: unknown): boolean {\n switch (op) {\n case 'eq': return a === b;\n case 'neq': return a !== b;\n case 'gt': return (a as number) > (b as number);\n case 'gte': return (a as number) >= (b as number);\n case 'lt': return (a as number) < (b as number);\n case 'lte': return (a as number) <= (b as number);\n case 'is': return a === b;\n case 'in': return Array.isArray(b) && b.includes(a);\n case 'like':\n case 'ilike': {\n const re = new RegExp(\n '^' + String(b).replace(/[.+?^${}()|[\\]\\\\]/g, '\\\\$&').replace(/%/g, '.*').replace(/_/g, '.') + '$',\n op === 'ilike' ? 'i' : '',\n );\n return re.test(String(a));\n }\n default: return false;\n }\n}\n","import type { Adapter, Entity, Query, Row, Page } from '../types.js';\nimport { toParams } from '../query.js';\n\nexport interface RemoteConfig {\n endpoint: string;\n token?: string;\n tenant?: string;\n fetchImpl?: typeof fetch;\n}\n\n/** PostgREST-over-HTTP adapter (production data plane / dev tenant). */\nexport function createRemoteAdapter(config: RemoteConfig): Adapter {\n const f = config.fetchImpl ?? globalThis.fetch;\n if (typeof f !== 'function') {\n throw new Error('remote adapter: no fetch available (Node >=18 or pass fetchImpl)');\n }\n const base = String(config.endpoint ?? '').replace(/\\/$/, '');\n if (!base) throw new Error('remote adapter: endpoint is required');\n\n const headers = (extra?: Record<string, string>): Record<string, string> => {\n const h: Record<string, string> = { 'Content-Type': 'application/json', Accept: 'application/json', ...extra };\n if (config.token) h.Authorization = `Bearer ${config.token}`;\n if (config.tenant) h['X-Revenexx-Tenant'] = config.tenant;\n return h;\n };\n\n async function req(method: string, path: string, opts: { body?: unknown; prefer?: string } = {}): Promise<unknown> {\n const res = await f(`${base}${path}`, {\n method,\n headers: headers(opts.prefer ? { Prefer: opts.prefer } : {}),\n body: opts.body != null ? JSON.stringify(opts.body) : undefined,\n });\n const text = await res.text();\n if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);\n return text ? JSON.parse(text) : null;\n }\n\n return {\n kind: 'remote',\n async list(entity: Entity, query: Query = {}): Promise<Row[]> {\n const qs = toParams(query).toString();\n return ((await req('GET', `/${entity.table}${qs ? `?${qs}` : ''}`)) as Row[]) ?? [];\n },\n async get(entity: Entity, id: string | number): Promise<Row | null> {\n const rows = (await req('GET', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}&limit=1`)) as Row[];\n return rows?.[0] ?? null;\n },\n async create(entity: Entity, data: Row): Promise<Row> {\n const rows = await req('POST', `/${entity.table}`, { body: data, prefer: 'return=representation' });\n return (Array.isArray(rows) ? rows[0] : rows) as Row;\n },\n async update(entity: Entity, id: string | number, patch: Row): Promise<Row> {\n const rows = await req('PATCH', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`, {\n body: patch,\n prefer: 'return=representation',\n });\n return (Array.isArray(rows) ? rows[0] : rows) as Row;\n },\n async remove(entity: Entity, id: string | number): Promise<void> {\n await req('DELETE', `/${entity.table}?${entity.pk}=eq.${encodeURIComponent(String(id))}`);\n },\n async page(entity: Entity, query: Query = {}): Promise<Page> {\n // One request: PostgREST returns the page in the body and the total in\n // Content-Range (\"0-9/247\" or \"*/247\") when asked for an exact count.\n const qs = toParams(query).toString();\n const res = await f(`${base}/${entity.table}${qs ? `?${qs}` : ''}`, {\n method: 'GET',\n headers: headers({ Prefer: 'count=exact' }),\n });\n const text = await res.text();\n if (!res.ok) throw new Error(`PostgREST ${res.status}: ${text}`);\n const items = (text ? JSON.parse(text) : []) as Row[];\n const range = res.headers.get('content-range') ?? '';\n const total = Number.parseInt(range.split('/')[1] ?? '', 10);\n return {\n items,\n total: Number.isFinite(total) ? total : items.length,\n limit: query.limit,\n offset: query.offset,\n };\n },\n };\n}\n","import type { Adapter } from '../types.js';\nimport { createRemoteAdapter } from './remote.js';\n\ninterface FunctionContext {\n req?: { headers?: Record<string, string> };\n}\n\nexport interface RuntimeConfig {\n context?: FunctionContext;\n env?: Record<string, string | undefined>;\n}\n\n/**\n * Production adapter: a `remote` adapter auto-configured from the function's\n * per-invocation context (ADR-0057). Token = the brokered identity forwarded as\n * `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env. App code\n * stays identical — only the adapter selection differs between local and prod.\n */\nexport function createRuntimeAdapter(config: RuntimeConfig = {}): Adapter {\n const env = config.env ?? process.env;\n const h = config.context?.req?.headers ?? {};\n const get = (name: string): string => h[name] ?? h[name.toLowerCase()] ?? '';\n\n const remote = createRemoteAdapter({\n endpoint: env.REVENEXX_DATA_ENDPOINT ?? '',\n token: get('x-revenexx-context') || env.REVENEXX_CONTEXT || '',\n tenant: get('x-revenexx-tenant') || env.REVENEXX_TENANT || '',\n });\n\n return { ...remote, kind: 'runtime' };\n}\n","import type { Adapter } from '../types.js';\nimport { createMockAdapter, applyDefaults } from './mock.js';\nimport { createRemoteAdapter } from './remote.js';\nimport { createRuntimeAdapter } from './runtime.js';\n\n/**\n * Adapter registry. Built-ins (mock | remote | runtime) are registered below;\n * add a new backend by calling `registerAdapter('my-kind', (config) => …)`\n * before constructing the client — no changes to the client or generated code.\n */\nexport type AdapterFactory = (config: Record<string, any>) => Adapter;\n\nconst registry = new Map<string, AdapterFactory>();\n\nexport function registerAdapter(kind: string, factory: AdapterFactory): void {\n registry.set(kind, factory);\n}\n\nexport function adapterKinds(): string[] {\n return [...registry.keys()];\n}\n\nexport function createAdapter(config: { adapter?: string } & Record<string, any>): Adapter {\n const kind = config.adapter ?? '';\n const factory = registry.get(kind);\n if (!factory) {\n const known = adapterKinds().join(' | ') || 'none registered';\n throw new Error(`app-sdk: unknown adapter '${kind}' (${known})`);\n }\n return factory(config);\n}\n\nregisterAdapter('mock', (c) => createMockAdapter(c.seed));\nregisterAdapter('remote', (c) => createRemoteAdapter(c as { endpoint: string }));\nregisterAdapter('runtime', (c) => createRuntimeAdapter(c));\n\nexport { createMockAdapter, createRemoteAdapter, createRuntimeAdapter, applyDefaults };\n","import type { Adapter, Entity, Op, Query, Row, Page } from './types.js';\nimport { createAdapter } from './adapters/index.js';\n\n/** manifest `permissions` access → entity client methods. */\nconst ACCESS_TO_OPS: Record<string, Op[]> = {\n read: ['list', 'get'],\n create: ['create'],\n update: ['update'],\n delete: ['delete'],\n};\n\n/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */\nexport function opsFromAccess(access: string[] = []): Set<Op> {\n const ops = new Set<Op>();\n for (const a of access) (ACCESS_TO_OPS[a] ?? []).forEach((o) => ops.add(o));\n return ops;\n}\n\n/** The methods exposed for a single entity; absent ops throw at call time. */\nexport interface EntityClient<T extends Row = Row, Create extends Row = T> {\n list(query?: Query<T>): Promise<T[]>;\n /** Like `list`, but also returns the total count of matching rows (for pagination). */\n page(query?: Query<T>): Promise<Page<T>>;\n get(id: string | number): Promise<T | null>;\n create(data: Create): Promise<T>;\n update(id: string | number, patch: Partial<Create>): Promise<T>;\n delete(id: string | number): Promise<void>;\n}\n\nfunction entityClient(adapter: Adapter, entity: Entity): EntityClient {\n const ops = entity.ops instanceof Set ? entity.ops : new Set<Op>(entity.ops ?? ['list', 'get', 'create', 'update', 'delete']);\n const guard = <F extends (...args: never[]) => unknown>(op: Op, fn: F): F =>\n (ops.has(op)\n ? fn\n : (() => {\n throw new Error(\n `${entity.name}.${op}() is not permitted — add the matching access to manifest.permissions for '${entity.name}'`,\n );\n }) as unknown as F);\n\n return {\n list: guard('list', (query?: Query) => adapter.list(entity, query ?? {})),\n page: guard('list', (query?: Query) => {\n if (!adapter.page) {\n throw new Error(`${entity.name}.page() is not supported by the '${adapter.kind}' adapter`);\n }\n return adapter.page(entity, query ?? {});\n }),\n get: guard('get', (id: string | number) => adapter.get(entity, id)),\n create: guard('create', (data: Row) => adapter.create(entity, data)),\n update: guard('update', (id: string | number, patch: Row) => adapter.update(entity, id, patch)),\n delete: guard('delete', (id: string | number) => adapter.remove(entity, id)),\n } as EntityClient;\n}\n\nexport interface ClientConfig {\n adapter: string;\n entities: Record<string, Omit<Entity, 'name'>>;\n [key: string]: unknown;\n}\n\nexport type Client = Record<string, EntityClient> & { readonly __adapter: string };\n\n/**\n * Build a typed entity client.\n * local dev : createClient({ adapter: 'mock', entities, seed })\n * dev tenant: createClient({ adapter: 'remote', entities, endpoint, token, tenant })\n * production: createClient({ adapter: 'runtime', entities, context }) // in the function\n */\nexport function createClient(config: ClientConfig): Client {\n if (!config?.entities) throw new Error('app-sdk: createClient needs { adapter, entities }');\n const adapter = createAdapter(config);\n const db = Object.create({ __adapter: adapter.kind }) as Client;\n for (const [name, def] of Object.entries(config.entities)) {\n db[name] = entityClient(adapter, { name, ...def });\n }\n return db;\n}\n"],"mappings":"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","names":[]}
|
package/package.json
ADDED
|
@@ -0,0 +1,43 @@
|
|
|
1
|
+
{
|
|
2
|
+
"name": "@revenexx/app-sdk",
|
|
3
|
+
"version": "0.2.0",
|
|
4
|
+
"description": "Typed PostgREST data client for revenexx Apps. Swappable adapters (mock | remote | runtime) so the same App code runs against in-memory fixtures locally and real PostgREST in production (ADR-0013 / ADR-0057).",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"type": "module",
|
|
7
|
+
"main": "./dist/index.cjs",
|
|
8
|
+
"module": "./dist/index.js",
|
|
9
|
+
"types": "./dist/index.d.ts",
|
|
10
|
+
"exports": {
|
|
11
|
+
".": {
|
|
12
|
+
"types": "./dist/index.d.ts",
|
|
13
|
+
"import": "./dist/index.js",
|
|
14
|
+
"require": "./dist/index.cjs"
|
|
15
|
+
}
|
|
16
|
+
},
|
|
17
|
+
"files": [
|
|
18
|
+
"dist"
|
|
19
|
+
],
|
|
20
|
+
"engines": {
|
|
21
|
+
"node": ">=18"
|
|
22
|
+
},
|
|
23
|
+
"publishConfig": {
|
|
24
|
+
"registry": "https://registry.npmjs.org",
|
|
25
|
+
"access": "restricted"
|
|
26
|
+
},
|
|
27
|
+
"repository": {
|
|
28
|
+
"type": "git",
|
|
29
|
+
"url": "git+https://github.com/revenexx/app-sdks.git",
|
|
30
|
+
"directory": "packages/sdk"
|
|
31
|
+
},
|
|
32
|
+
"devDependencies": {
|
|
33
|
+
"@types/node": "^22.10.2",
|
|
34
|
+
"tsup": "^8.3.5",
|
|
35
|
+
"typescript": "^5.7.2",
|
|
36
|
+
"vitest": "^2.1.8"
|
|
37
|
+
},
|
|
38
|
+
"scripts": {
|
|
39
|
+
"build": "tsup",
|
|
40
|
+
"test": "vitest run",
|
|
41
|
+
"typecheck": "tsc --noEmit"
|
|
42
|
+
}
|
|
43
|
+
}
|