@revenexx/app-sdk 0.2.1 → 0.3.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 +157 -17
- package/dist/index.cjs +3 -3
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +4 -66
- package/dist/index.d.ts +4 -66
- package/dist/index.js.map +1 -1
- package/dist/router/index.cjs +299 -0
- package/dist/router/index.cjs.map +1 -0
- package/dist/router/index.d.cts +151 -0
- package/dist/router/index.d.ts +151 -0
- package/dist/router/index.js +266 -0
- package/dist/router/index.js.map +1 -0
- package/dist/types-BMd8t8Pi.d.cts +66 -0
- package/dist/types-BMd8t8Pi.d.ts +66 -0
- package/package.json +8 -3
package/README.md
CHANGED
|
@@ -1,32 +1,172 @@
|
|
|
1
1
|
# @revenexx/app-sdk
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
|
|
5
|
-
fixtures locally and real PostgREST in production (ADR-0013 / ADR-0057).
|
|
3
|
+
The SDK for building **revenexx Apps** — typed data access and HTTP routing for
|
|
4
|
+
the revenexx Revenue Cloud app platform.
|
|
6
5
|
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
6
|
+
A revenexx App declares its data model in a `schema.json` and its identity and
|
|
7
|
+
permissions in a `manifest.json`. The platform provisions the database,
|
|
8
|
+
API exposure and tenant isolation from those files; your function code only
|
|
9
|
+
needs two things:
|
|
10
10
|
|
|
11
|
-
|
|
12
|
-
|
|
11
|
+
- a **data client** to read and write the App's entities (`@revenexx/app-sdk`)
|
|
12
|
+
- a **router** to answer the HTTP routes your App exposes (`@revenexx/app-sdk/router`)
|
|
13
|
+
|
|
14
|
+
```bash
|
|
15
|
+
npm install @revenexx/app-sdk
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Data client
|
|
19
|
+
|
|
20
|
+
The client gives every entity the same methods — `list`, `page`, `get`,
|
|
21
|
+
`create`, `update`, `delete` — and the same query shape, independent of where
|
|
22
|
+
the data lives. Swap the *adapter* to move between environments:
|
|
23
|
+
|
|
24
|
+
| adapter | use it for | infrastructure |
|
|
25
|
+
|-----------|-------------------------------------------------------|----------------|
|
|
26
|
+
| `mock` | local development + unit tests against fixtures | none |
|
|
27
|
+
| `remote` | integration checks against a real development tenant | none local |
|
|
28
|
+
| `runtime` | production, inside the deployed function | auto-configured |
|
|
29
|
+
|
|
30
|
+
```js
|
|
31
|
+
const { createClient } = require('@revenexx/app-sdk');
|
|
13
32
|
|
|
14
33
|
const db = createClient({
|
|
15
|
-
adapter: 'mock',
|
|
16
|
-
entities: {
|
|
17
|
-
|
|
34
|
+
adapter: 'mock', // 'remote' | 'runtime'
|
|
35
|
+
entities: {
|
|
36
|
+
markets: { table: 'acme__shop__markets', pk: 'id' },
|
|
37
|
+
},
|
|
38
|
+
seed: { markets: [{ id: 'm1', code: 'de', currency: 'EUR' }] },
|
|
18
39
|
});
|
|
19
|
-
|
|
40
|
+
|
|
41
|
+
await db.markets.create({ code: 'at', currency: 'EUR' });
|
|
42
|
+
const eur = await db.markets.list({ where: { currency: 'EUR' }, order: 'code.asc' });
|
|
43
|
+
const page = await db.markets.page({ limit: 20, offset: 0 }); // { items, total }
|
|
20
44
|
```
|
|
21
45
|
|
|
22
|
-
|
|
46
|
+
Most Apps don't hand-write the `entities` map: the revenexx tooling generates a
|
|
47
|
+
typed `db.generated.js` from your App's `schema.json` + `manifest.json`, so
|
|
48
|
+
`createDb({ adapter, ... })` is one import away and every entity is typed.
|
|
49
|
+
|
|
50
|
+
### Queries
|
|
51
|
+
|
|
52
|
+
One query shape works across all adapters:
|
|
23
53
|
|
|
24
|
-
|
|
25
|
-
|
|
54
|
+
```js
|
|
55
|
+
await db.markets.list({
|
|
56
|
+
where: {
|
|
57
|
+
currency: 'EUR', // equality
|
|
58
|
+
code: ['de', 'at'], // IN list
|
|
59
|
+
created_at: { op: 'gte', value: '2026-01-01' }, // explicit operator
|
|
60
|
+
},
|
|
61
|
+
select: ['id', 'code'],
|
|
62
|
+
order: 'created_at.desc',
|
|
63
|
+
limit: 50,
|
|
64
|
+
offset: 0,
|
|
65
|
+
});
|
|
66
|
+
```
|
|
26
67
|
|
|
27
|
-
|
|
28
|
-
|
|
68
|
+
Operators: `eq`, `neq`, `gt`, `gte`, `lt`, `lte`, `like`, `ilike`, `in`, `is`.
|
|
69
|
+
|
|
70
|
+
### Permissions
|
|
71
|
+
|
|
72
|
+
The methods available per entity follow your App manifest's `permissions`
|
|
73
|
+
declarations. Calling an operation the manifest doesn't grant throws a
|
|
74
|
+
descriptive error (and the platform would reject it anyway) — so local tests
|
|
75
|
+
catch permission gaps before deploy.
|
|
76
|
+
|
|
77
|
+
### Custom adapters
|
|
78
|
+
|
|
79
|
+
The adapter is a small interface (`list/get/create/update/remove`, optional
|
|
80
|
+
`page`). Register a new backend before constructing the client:
|
|
81
|
+
|
|
82
|
+
```js
|
|
83
|
+
const { registerAdapter, createClient } = require('@revenexx/app-sdk');
|
|
29
84
|
|
|
30
85
|
registerAdapter('sqlite', (config) => ({ kind: 'sqlite', /* … */ }));
|
|
31
86
|
const db = createClient({ adapter: 'sqlite', entities, file: 'dev.db' });
|
|
32
87
|
```
|
|
88
|
+
|
|
89
|
+
## Router
|
|
90
|
+
|
|
91
|
+
`@revenexx/app-sdk/router` turns the single function entrypoint into
|
|
92
|
+
declarative routes. Path templates use the same `{param}` syntax as your
|
|
93
|
+
manifest's capability routes.
|
|
94
|
+
|
|
95
|
+
```js
|
|
96
|
+
const { createApp, notFound } = require('@revenexx/app-sdk/router');
|
|
97
|
+
const { createDb } = require('./db.generated');
|
|
98
|
+
|
|
99
|
+
const app = createApp({ name: 'markets' });
|
|
100
|
+
|
|
101
|
+
app.get('/markets/{id}/context', async (c) => {
|
|
102
|
+
const db = createDb({ adapter: 'runtime', context: c.ctx });
|
|
103
|
+
const market = await db.markets.get(c.params.id);
|
|
104
|
+
if (!market) throw notFound();
|
|
105
|
+
const locales = await db.locales.list({ where: { market_id: market.id } });
|
|
106
|
+
return c.json({ market, locales });
|
|
107
|
+
});
|
|
108
|
+
|
|
109
|
+
module.exports = app.handler();
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
What you get:
|
|
113
|
+
|
|
114
|
+
- **Literal-first matching** — `/markets/defaults` wins over `/markets/{id}`,
|
|
115
|
+
regardless of registration order.
|
|
116
|
+
- **A clean per-request context** — `c.params`, `c.query`, `c.body` (parsed),
|
|
117
|
+
`c.tenant`, `c.header(name)`, `c.log(msg)`, `c.json(data, status)`.
|
|
118
|
+
- **Error mapping** — throw `HttpError` / `notFound()` / `badRequest()` /
|
|
119
|
+
`forbidden()` / `conflict()` for explicit statuses; data-client permission
|
|
120
|
+
errors become `403`; anything else is logged and answered as `500`.
|
|
121
|
+
- **A health route** — `GET /` answers with the App identity, status and the
|
|
122
|
+
registered routes (disable with `createApp({ health: false })`).
|
|
123
|
+
- **404/405 handling** — unknown paths list the available routes; known paths
|
|
124
|
+
with a wrong method answer `405`.
|
|
125
|
+
|
|
126
|
+
### CRUD in one line
|
|
127
|
+
|
|
128
|
+
`mountCrud` wires an entity to the standard five REST routes with filtering and
|
|
129
|
+
pagination built in:
|
|
130
|
+
|
|
131
|
+
```js
|
|
132
|
+
mountCrud(app, db.markets, { path: '/markets', columns: ENTITIES.markets.columns });
|
|
133
|
+
// GET /markets list — ?currency=EUR&limit=50&offset=0&order=code.asc
|
|
134
|
+
// POST /markets create
|
|
135
|
+
// GET /markets/{id} read
|
|
136
|
+
// PUT /markets/{id} update
|
|
137
|
+
// DELETE /markets/{id} delete
|
|
138
|
+
```
|
|
139
|
+
|
|
140
|
+
Nested resources scope every operation to their parent:
|
|
141
|
+
|
|
142
|
+
```js
|
|
143
|
+
mountCrud(app, db.locales, {
|
|
144
|
+
path: '/markets/{marketId}/locales',
|
|
145
|
+
columns: ENTITIES.locales.columns,
|
|
146
|
+
parent: { param: 'marketId', column: 'market_id' },
|
|
147
|
+
});
|
|
148
|
+
// lists filter by market_id, creates inject it, and a locale belonging to a
|
|
149
|
+
// different market answers 404 — even if the request body claims otherwise.
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
Options: `only: ['list', 'get']` restricts the mounted routes; `defaultLimit` /
|
|
153
|
+
`maxLimit` tune pagination bounds (defaults 50 / 200).
|
|
154
|
+
|
|
155
|
+
### Testing your App
|
|
156
|
+
|
|
157
|
+
Handlers are plain functions over a context object, so tests don't need any
|
|
158
|
+
infrastructure: build the app with a `mock`-adapter client, call
|
|
159
|
+
`app.handler()` with a fake `{ req, res }`, and assert on the captured JSON.
|
|
160
|
+
|
|
161
|
+
```js
|
|
162
|
+
const handler = app.handler();
|
|
163
|
+
await handler({
|
|
164
|
+
req: { method: 'GET', path: '/markets', headers: {}, query: {} },
|
|
165
|
+
res: { json: (data, status = 200) => ({ data, status }) },
|
|
166
|
+
log: console.log,
|
|
167
|
+
});
|
|
168
|
+
```
|
|
169
|
+
|
|
170
|
+
## License
|
|
171
|
+
|
|
172
|
+
MIT
|
package/dist/index.cjs
CHANGED
|
@@ -18,8 +18,8 @@ var __copyProps = (to, from, except, desc) => {
|
|
|
18
18
|
var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
|
|
19
19
|
|
|
20
20
|
// src/index.ts
|
|
21
|
-
var
|
|
22
|
-
__export(
|
|
21
|
+
var src_exports = {};
|
|
22
|
+
__export(src_exports, {
|
|
23
23
|
adapterKinds: () => adapterKinds,
|
|
24
24
|
applyDefaults: () => applyDefaults,
|
|
25
25
|
createAdapter: () => createAdapter,
|
|
@@ -32,7 +32,7 @@ __export(index_exports, {
|
|
|
32
32
|
registerAdapter: () => registerAdapter,
|
|
33
33
|
toParams: () => toParams
|
|
34
34
|
});
|
|
35
|
-
module.exports = __toCommonJS(
|
|
35
|
+
module.exports = __toCommonJS(src_exports);
|
|
36
36
|
|
|
37
37
|
// src/adapters/mock.ts
|
|
38
38
|
var import_node_crypto = require("crypto");
|
package/dist/index.cjs.map
CHANGED
|
@@ -1 +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":"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","names":[]}
|
|
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. 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
CHANGED
|
@@ -1,67 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
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
|
-
}
|
|
1
|
+
import { R as Row, Q as Query, P as Page, E as Entity, O as Op, A as Adapter } from './types-BMd8t8Pi.cjs';
|
|
2
|
+
export { C as ColumnDef, F as Filter, a as FilterOp, S as Scalar } from './types-BMd8t8Pi.cjs';
|
|
65
3
|
|
|
66
4
|
/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */
|
|
67
5
|
declare function opsFromAccess(access?: string[]): Set<Op>;
|
|
@@ -125,7 +63,7 @@ interface RuntimeConfig {
|
|
|
125
63
|
}
|
|
126
64
|
/**
|
|
127
65
|
* Production adapter: a `remote` adapter auto-configured from the function's
|
|
128
|
-
* per-invocation context
|
|
66
|
+
* per-invocation context. Token = the brokered identity forwarded as
|
|
129
67
|
* `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env. App code
|
|
130
68
|
* stays identical — only the adapter selection differs between local and prod.
|
|
131
69
|
*/
|
|
@@ -143,4 +81,4 @@ declare function createAdapter(config: {
|
|
|
143
81
|
adapter?: string;
|
|
144
82
|
} & Record<string, any>): Adapter;
|
|
145
83
|
|
|
146
|
-
export {
|
|
84
|
+
export { Adapter, type AdapterFactory, type Client, type ClientConfig, Entity, type EntityClient, Op, Page, Query, type RemoteConfig, Row, type RuntimeConfig, adapterKinds, applyDefaults, createAdapter, createClient, createMockAdapter, createRemoteAdapter, createRuntimeAdapter, matches, opsFromAccess, registerAdapter, toParams };
|
package/dist/index.d.ts
CHANGED
|
@@ -1,67 +1,5 @@
|
|
|
1
|
-
|
|
2
|
-
|
|
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
|
-
}
|
|
1
|
+
import { R as Row, Q as Query, P as Page, E as Entity, O as Op, A as Adapter } from './types-BMd8t8Pi.js';
|
|
2
|
+
export { C as ColumnDef, F as Filter, a as FilterOp, S as Scalar } from './types-BMd8t8Pi.js';
|
|
65
3
|
|
|
66
4
|
/** Map a manifest access list (e.g. ['read','create']) to a Set of ops. */
|
|
67
5
|
declare function opsFromAccess(access?: string[]): Set<Op>;
|
|
@@ -125,7 +63,7 @@ interface RuntimeConfig {
|
|
|
125
63
|
}
|
|
126
64
|
/**
|
|
127
65
|
* Production adapter: a `remote` adapter auto-configured from the function's
|
|
128
|
-
* per-invocation context
|
|
66
|
+
* per-invocation context. Token = the brokered identity forwarded as
|
|
129
67
|
* `x-revenexx-context`; tenant = `x-revenexx-tenant`; endpoint = env. App code
|
|
130
68
|
* stays identical — only the adapter selection differs between local and prod.
|
|
131
69
|
*/
|
|
@@ -143,4 +81,4 @@ declare function createAdapter(config: {
|
|
|
143
81
|
adapter?: string;
|
|
144
82
|
} & Record<string, any>): Adapter;
|
|
145
83
|
|
|
146
|
-
export {
|
|
84
|
+
export { Adapter, type AdapterFactory, type Client, type ClientConfig, Entity, type EntityClient, Op, Page, Query, type RemoteConfig, Row, type RuntimeConfig, adapterKinds, applyDefaults, createAdapter, createClient, createMockAdapter, createRemoteAdapter, createRuntimeAdapter, matches, opsFromAccess, registerAdapter, toParams };
|