@revenexx/app-sdk 0.4.2 → 0.6.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 +29 -1
- package/dist/chunk-WJ7QJ3NU.js +41 -0
- package/dist/chunk-WJ7QJ3NU.js.map +1 -0
- package/dist/errors-DrxYD96C.d.cts +111 -0
- package/dist/errors-DrxYD96C.d.ts +111 -0
- package/dist/index.cjs +154 -15
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +2 -2
- package/dist/index.d.ts +2 -2
- package/dist/index.js +129 -15
- package/dist/index.js.map +1 -1
- package/dist/router/index.cjs +55 -4
- package/dist/router/index.cjs.map +1 -1
- package/dist/router/index.d.cts +18 -13
- package/dist/router/index.d.ts +18 -13
- package/dist/router/index.js +40 -16
- package/dist/router/index.js.map +1 -1
- package/package.json +1 -1
- package/dist/types-BMd8t8Pi.d.cts +0 -66
- package/dist/types-BMd8t8Pi.d.ts +0 -66
package/dist/router/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"sources":["../../src/router/router.ts","../../src/router/crud.ts"],"sourcesContent":["/**\n * Minimal HTTP router for revenexx App functions.\n *\n * App functions receive a single invocation context ({ req, res, log, error })\n * and are expected to answer every route the App's manifest declares. This\n * router turns that into declarative, testable handlers:\n *\n * const app = createApp({ name: 'markets' });\n * app.get('/markets', (c) => c.json({ items: [] }));\n * app.get('/markets/{id}', (c) => c.json({ id: c.params.id }));\n * module.exports = app.handler();\n *\n * Matching is literal-first: `/markets/locales` always wins over\n * `/markets/{id}` regardless of registration order. Path templates use the\n * same `{param}` syntax as manifest capability routes (`:param` also works).\n */\n\nimport {\n trace,\n context as otelContext,\n propagation,\n SpanKind,\n SpanStatusCode,\n type Span,\n type TextMapGetter,\n} from '@opentelemetry/api';\n\nexport interface FnRequest {\n method?: string;\n path?: string;\n url?: string;\n headers?: Record<string, string>;\n query?: Record<string, unknown>;\n body?: unknown;\n bodyText?: string;\n bodyRaw?: string;\n}\n\nexport interface FnResponse {\n json(data: unknown, statusCode?: number, headers?: Record<string, string>): unknown;\n send?(body: string, statusCode?: number, headers?: Record<string, string>): unknown;\n}\n\n/** The invocation context an App function receives from the runtime. */\nexport interface FnContext {\n req: FnRequest;\n res: FnResponse;\n log?: (message: string) => void;\n error?: (message: string) => void;\n}\n\n/** Per-request context handed to route handlers. */\nexport interface RouteContext {\n /** Raw invocation context (escape hatch). */\n ctx: FnContext;\n req: FnRequest;\n method: string;\n /** Normalised path (no trailing slash, no query string). */\n path: string;\n /** Path parameters from the matched route template (e.g. `{id}`). */\n params: Record<string, string>;\n /** Query string parameters (string values). */\n query: Record<string, string>;\n /** Parsed JSON body, or `{}` when absent/unparsable. */\n body: Record<string, unknown>;\n /** Tenant slug from the `x-revenexx-tenant` header (or token claim). */\n tenant: string | null;\n /** The forwarded identity token (`x-revenexx-context`), if present. */\n contextToken: string;\n /** Case-insensitive header lookup. */\n header(name: string): string;\n log(message: string): void;\n /** Respond with JSON. Returning `c.json(...)` ends the request. */\n json(data: unknown, statusCode?: number): unknown;\n}\n\nexport type Handler = (c: RouteContext) => unknown | Promise<unknown>;\n\n/** Throw inside a handler to answer with a specific HTTP status. */\nexport class HttpError extends Error {\n readonly status: number;\n readonly details?: unknown;\n constructor(status: number, message: string, details?: unknown) {\n super(message);\n this.name = 'HttpError';\n this.status = status;\n this.details = details;\n }\n}\n\nexport const notFound = (message = 'not found'): HttpError => new HttpError(404, message);\nexport const badRequest = (message = 'bad request', details?: unknown): HttpError =>\n new HttpError(400, message, details);\nexport const forbidden = (message = 'forbidden'): HttpError => new HttpError(403, message);\nexport const conflict = (message = 'conflict'): HttpError => new HttpError(409, message);\n\ninterface Segment {\n lit?: string;\n param?: string;\n}\n\ninterface CompiledRoute {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler;\n}\n\nconst splitPath = (path: string): string[] => path.split('/').filter(Boolean);\n\nfunction compileTemplate(template: string): Segment[] {\n return splitPath(template).map((seg) => {\n const braced = /^\\{([A-Za-z_][A-Za-z0-9_]*)\\}$/.exec(seg);\n if (braced) return { param: braced[1] };\n if (seg.startsWith(':') && seg.length > 1) return { param: seg.slice(1) };\n return { lit: seg };\n });\n}\n\nfunction matchSegments(segments: Segment[], reqSegs: string[]): Record<string, string> | null {\n if (segments.length !== reqSegs.length) return null;\n const params: Record<string, string> = {};\n for (let i = 0; i < segments.length; i++) {\n const s = segments[i]!;\n if (s.param) params[s.param] = decodeURIComponent(reqSegs[i]!);\n else if (s.lit !== reqSegs[i]) return null;\n }\n return params;\n}\n\nfunction headerOf(headers: Record<string, string> | undefined, name: string): string {\n if (!headers) return '';\n const direct = headers[name] ?? headers[name.toLowerCase()];\n if (typeof direct === 'string') return direct;\n const want = name.toLowerCase();\n for (const [k, v] of Object.entries(headers)) {\n if (k.toLowerCase() === want && typeof v === 'string') return v;\n }\n return '';\n}\n\nfunction decodeClaims(token: string): Record<string, unknown> {\n if (!token || token.split('.').length < 2) return {};\n try {\n const payload = token.split('.')[1]!.replace(/-/g, '+').replace(/_/g, '/');\n const parsed: unknown = JSON.parse(Buffer.from(payload, 'base64').toString('utf8'));\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n}\n\nfunction parseBody(req: FnRequest): Record<string, unknown> {\n const candidate = req.body ?? req.bodyText ?? req.bodyRaw;\n if (candidate == null || candidate === '') return {};\n if (typeof candidate === 'object') return candidate as Record<string, unknown>;\n if (typeof candidate === 'string') {\n try {\n const parsed: unknown = JSON.parse(candidate);\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n }\n return {};\n}\n\nfunction parseQuery(req: FnRequest): Record<string, string> {\n const out: Record<string, string> = {};\n for (const [k, v] of Object.entries(req.query ?? {})) {\n if (typeof v === 'string') out[k] = v;\n else if (v != null) out[k] = String(v);\n }\n return out;\n}\n\nexport interface AppOptions {\n /** App name reported on the built-in health route. */\n name?: string;\n /**\n * Built-in `GET /` health route (default true). Responds with the app\n * identity (from the runtime env), status and the registered routes.\n */\n health?: boolean;\n /** Extra payload merged into the health response. */\n healthExtra?: () => Record<string, unknown>;\n}\n\nexport interface App {\n get(template: string, handler: Handler): App;\n post(template: string, handler: Handler): App;\n put(template: string, handler: Handler): App;\n patch(template: string, handler: Handler): App;\n delete(template: string, handler: Handler): App;\n on(method: string, template: string, handler: Handler): App;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst tracer = trace.getTracer('@revenexx/app-sdk');\n\n/** Case-insensitive W3C trace-context extraction from the function's headers. */\nconst headerGetter: TextMapGetter<Record<string, string>> = {\n keys: (carrier) => Object.keys(carrier ?? {}),\n get: (carrier, key) => headerOf(carrier, key) || undefined,\n};\n\nexport function createApp(options: AppOptions = {}): App {\n const routes: CompiledRoute[] = [];\n const health = options.health !== false;\n\n const app: App = {\n get: (t, h) => app.on('GET', t, h),\n post: (t, h) => app.on('POST', t, h),\n put: (t, h) => app.on('PUT', t, h),\n patch: (t, h) => app.on('PATCH', t, h),\n delete: (t, h) => app.on('DELETE', t, h),\n on(method, template, handler) {\n const segments = compileTemplate(template);\n routes.push({\n method: method.toUpperCase(),\n template,\n segments,\n literals: segments.filter((s) => s.lit !== undefined).length,\n handler,\n });\n // Literal-first: more literal segments = more specific = tried first.\n routes.sort((a, b) => b.literals - a.literals);\n return app;\n },\n routes: () => routes.map((r) => ({ method: r.method, path: r.template })).sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method)),\n handler() {\n return (context: FnContext) => {\n const { req, res } = context;\n const headers = req.headers ?? {};\n const method = (req.method ?? 'GET').toUpperCase();\n const rawPath = String(req.path ?? '/').split('?')[0]!;\n const path = rawPath.replace(/\\/+$/, '') || '/';\n\n // Continue the caller's trace (gateway/site) when a traceparent is forwarded;\n // otherwise this SERVER span roots a fresh trace. Outbound PostgREST fetches\n // become child CLIENT spans via the undici instrumentation (see ./instrument).\n const parentCtx = propagation.extract(otelContext.active(), headers, headerGetter);\n\n return tracer.startActiveSpan(\n `${method} ${path}`,\n { kind: SpanKind.SERVER, attributes: { 'http.request.method': method, 'url.path': path } },\n parentCtx,\n async (span: Span) => {\n const contextToken = headerOf(headers, 'x-revenexx-context');\n const tenant =\n headerOf(headers, 'x-revenexx-tenant') ||\n (decodeClaims(contextToken).tenant_id as string | undefined) ||\n null;\n if (options.name) span.setAttribute('revenexx.app', options.name);\n if (tenant) span.setAttribute('revenexx.tenant', tenant);\n const log = (m: string) => context.log?.(m);\n\n log(`${options.name ?? 'app'} ${method} ${path} — tenant=${tenant ?? 'none'}`);\n\n try {\n if (health && path === '/' && method === 'GET') {\n span.setAttribute('http.route', '/');\n return res.json({\n app: {\n id: process.env.REVENEXX_APP_ID ?? null,\n name: options.name ?? process.env.REVENEXX_APP_NAME ?? null,\n deployment: process.env.REVENEXX_APP_DEPLOYMENT ?? null,\n runtime: `${process.env.REVENEXX_APP_RUNTIME_NAME ?? ''}-${process.env.REVENEXX_APP_RUNTIME_VERSION ?? ''}`,\n },\n status: 'ok',\n routes: app.routes(),\n timestamp: new Date().toISOString(),\n ...(options.healthExtra?.() ?? {}),\n });\n }\n\n const reqSegs = splitPath(path);\n let matched: { route: CompiledRoute; params: Record<string, string> } | null = null;\n let pathExists = false;\n for (const route of routes) {\n const params = matchSegments(route.segments, reqSegs);\n if (!params) continue;\n pathExists = true;\n if (route.method === method) {\n matched = { route, params };\n break;\n }\n }\n\n if (!matched) {\n const status = pathExists ? 405 : 404;\n span.setAttribute('http.response.status_code', status);\n span.setStatus({ code: SpanStatusCode.ERROR, message: pathExists ? 'method not allowed' : 'no route' });\n if (pathExists) {\n return res.json({ error: `method ${method} not allowed for ${path}` }, 405);\n }\n return res.json({ error: `no route for ${method} ${path}`, routes: app.routes() }, 404);\n }\n\n span.updateName(`${method} ${matched.route.template}`);\n span.setAttribute('http.route', matched.route.template);\n\n // Gateway-extracted params (x-capability-params) win over our own match\n // for safety, but they should always agree.\n let gatewayParams: Record<string, string> = {};\n try {\n gatewayParams = JSON.parse(headerOf(headers, 'x-capability-params') || '{}') as Record<string, string>;\n } catch {\n gatewayParams = {};\n }\n\n const c: RouteContext = {\n ctx: context,\n req,\n method,\n path,\n params: { ...matched.params, ...gatewayParams },\n query: parseQuery(req),\n body: parseBody(req),\n tenant,\n contextToken,\n header: (name) => headerOf(headers, name),\n log,\n json: (data, statusCode = 200) => res.json(data, statusCode),\n };\n\n return await matched.route.handler(c);\n } catch (err) {\n if (err instanceof HttpError) {\n span.setAttribute('http.response.status_code', err.status);\n if (err.status >= 500) span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });\n return res.json({ error: err.message, ...(err.details != null ? { details: err.details } : {}) }, err.status);\n }\n const msg = err instanceof Error ? err.message : String(err);\n if (/not permitted/.test(msg)) {\n span.setAttribute('http.response.status_code', 403);\n return res.json({ error: msg }, 403);\n }\n span.recordException(err instanceof Error ? err : new Error(msg));\n span.setStatus({ code: SpanStatusCode.ERROR, message: msg });\n context.error?.(`unhandled error on ${method} ${path}: ${msg}`);\n return res.json({ error: msg }, 500);\n } finally {\n span.end();\n }\n },\n );\n };\n },\n };\n\n return app;\n}\n","/**\n * CRUD route mounting: wire a generated entity client to REST routes in one\n * call, with the platform's standard list/get/create/update/delete semantics.\n *\n * const app = createApp({ name: 'markets' });\n * const db = createDb({ adapter: 'runtime', context });\n *\n * mountCrud(app, db.markets, { path: '/markets', columns: ENTITIES.markets.columns });\n * mountCrud(app, db.locales, {\n * path: '/markets/{marketId}/locales',\n * columns: ENTITIES.locales.columns,\n * parent: { param: 'marketId', column: 'market_id' },\n * });\n *\n * Nested resources (a `parent` option) scope every operation to the parent row:\n * lists filter by the parent column, creates inject it, and reads/writes 404\n * when the row belongs to a different parent.\n */\n\nimport type { Page, Query, Row } from '../types.js';\nimport { HttpError, notFound, type App, type RouteContext } from './router.js';\n\n/** Structural subset of the SDK's EntityClient — any compatible repo works. */\nexport interface RepoLike {\n list(query?: Query): Promise<Row[]>;\n page?(query?: Query): Promise<Page>;\n get(id: string | number): Promise<Row | null>;\n create(data: Row): Promise<Row>;\n update(id: string | number, patch: Row): Promise<Row>;\n delete(id: string | number): Promise<void>;\n}\n\nexport interface CrudOptions {\n /** Route base path, e.g. `/markets` or `/markets/{marketId}/locales`. */\n path: string;\n /** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */\n columns?: Record<string, unknown>;\n /** Nested-resource scoping: path param name + the FK column it maps to. */\n parent?: { param: string; column: string };\n /** Path param for the row id (default `id`). */\n idParam?: string;\n /** Pagination bounds for list (defaults: 50, max 200). */\n defaultLimit?: number;\n maxLimit?: number;\n /** Restrict which routes are mounted (default: all five). */\n only?: ('list' | 'get' | 'create' | 'update' | 'delete')[];\n}\n\nconst INT = (v: unknown, d: number): number => {\n const n = parseInt(String(v), 10);\n return Number.isFinite(n) ? n : d;\n};\n\nfunction parentWhere(c: RouteContext, parent?: CrudOptions['parent']): Record<string, string> {\n if (!parent) return {};\n const value = c.params[parent.param];\n if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);\n return { [parent.column]: value };\n}\n\n/** Fetch a row and enforce nested-parent ownership; throws 404 when absent. */\nasync function fetchOwned(\n repo: RepoLike,\n c: RouteContext,\n opts: CrudOptions,\n): Promise<{ id: string; row: Row }> {\n const id = c.params[opts.idParam ?? 'id'] ?? '';\n if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? 'id'}'`);\n const row = await repo.get(id);\n if (!row) throw notFound();\n if (opts.parent) {\n const expected = c.params[opts.parent.param];\n if (String(row[opts.parent.column] ?? '') !== String(expected ?? '')) throw notFound();\n }\n return { id, row };\n}\n\nexport function mountCrud(app: App, repo: RepoLike, opts: CrudOptions): App {\n const base = opts.path.replace(/\\/+$/, '');\n const idTemplate = `${base}/{${opts.idParam ?? 'id'}}`;\n const enabled = new Set(opts.only ?? ['list', 'get', 'create', 'update', 'delete']);\n const defaultLimit = opts.defaultLimit ?? 50;\n const maxLimit = opts.maxLimit ?? 200;\n\n if (enabled.has('list')) {\n app.get(base, async (c) => {\n const where: Record<string, string> = {};\n for (const [k, v] of Object.entries(c.query)) {\n if (opts.columns && k in opts.columns) where[k] = v;\n }\n // The nested-parent filter always wins — a query param must not widen\n // the scope beyond the parent in the path.\n Object.assign(where, parentWhere(c, opts.parent));\n const limit = Math.min(Math.max(INT(c.query.limit, defaultLimit), 1), maxLimit);\n const offset = Math.max(INT(c.query.offset, 0), 0);\n const order = typeof c.query.order === 'string' && c.query.order ? c.query.order : undefined;\n const query: Query = { where, limit, offset, ...(order ? { order } : {}) };\n\n if (repo.page) {\n const { items, total } = await repo.page(query);\n return c.json({\n items,\n page: { limit, offset, total, returned: items.length, hasMore: offset + items.length < total },\n filter: where,\n });\n }\n const items = await repo.list(query);\n return c.json({ items, page: { limit, offset, returned: items.length }, filter: where });\n });\n }\n\n if (enabled.has('create')) {\n app.post(base, async (c) => {\n const data = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.create(data), 201);\n });\n }\n\n if (enabled.has('get')) {\n app.get(idTemplate, async (c) => {\n const { row } = await fetchOwned(repo, c, opts);\n return c.json(row);\n });\n }\n\n if (enabled.has('update')) {\n app.put(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n // Never let a body overwrite the nested-parent FK.\n const patch = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.update(id, patch));\n });\n }\n\n if (enabled.has('delete')) {\n app.delete(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n await repo.delete(id);\n return c.json({ deleted: true, id });\n });\n }\n\n return app;\n}\n"],"mappings":"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","names":["items"]}
|
|
1
|
+
{"version":3,"sources":["../../src/router/router.ts","../../src/router/crud.ts"],"sourcesContent":["/**\n * Minimal HTTP router for revenexx App functions.\n *\n * App functions receive a single invocation context ({ req, res, log, error })\n * and are expected to answer every route the App's manifest declares. This\n * router turns that into declarative, testable handlers:\n *\n * const app = createApp({ name: 'markets' });\n * app.get('/markets', (c) => c.json({ items: [] }));\n * app.get('/markets/{id}', (c) => c.json({ id: c.params.id }));\n * module.exports = app.handler();\n *\n * Matching is literal-first: `/markets/locales` always wins over\n * `/markets/{id}` regardless of registration order. Path templates use the\n * same `{param}` syntax as manifest capability routes (`:param` also works).\n */\n\nimport {\n trace,\n context as otelContext,\n propagation,\n SpanKind,\n SpanStatusCode,\n type Span,\n type TextMapGetter,\n} from '@opentelemetry/api';\n\nexport interface FnRequest {\n method?: string;\n path?: string;\n url?: string;\n headers?: Record<string, string>;\n query?: Record<string, unknown>;\n body?: unknown;\n bodyText?: string;\n bodyRaw?: string;\n}\n\nexport interface FnResponse {\n json(data: unknown, statusCode?: number, headers?: Record<string, string>): unknown;\n send?(body: string, statusCode?: number, headers?: Record<string, string>): unknown;\n}\n\n/** The invocation context an App function receives from the runtime. */\nexport interface FnContext {\n req: FnRequest;\n res: FnResponse;\n log?: (message: string) => void;\n error?: (message: string) => void;\n}\n\n/** Per-request context handed to route handlers. */\nexport interface RouteContext {\n /** Raw invocation context (escape hatch). */\n ctx: FnContext;\n req: FnRequest;\n method: string;\n /** Normalised path (no trailing slash, no query string). */\n path: string;\n /** Path parameters from the matched route template (e.g. `{id}`). */\n params: Record<string, string>;\n /** Query string parameters (string values). */\n query: Record<string, string>;\n /** Parsed JSON body, or `{}` when absent/unparsable. */\n body: Record<string, unknown>;\n /** Tenant slug from the `x-revenexx-tenant` header (or token claim). */\n tenant: string | null;\n /** The forwarded identity token (`x-revenexx-context`), if present. */\n contextToken: string;\n /** Case-insensitive header lookup. */\n header(name: string): string;\n log(message: string): void;\n /** Respond with JSON. Returning `c.json(...)` ends the request. */\n json(data: unknown, statusCode?: number): unknown;\n}\n\nexport type Handler = (c: RouteContext) => unknown | Promise<unknown>;\n\n// `HttpError` lives in ../errors.js so the data adapters can raise it too — a\n// PostgREST unique violation answers 409 without the router guessing from a\n// message string. Re-exported here so `@revenexx/app-sdk/router` is unchanged.\nexport {\n HttpError,\n isHttpError,\n notFound,\n badRequest,\n forbidden,\n conflict,\n type HttpErrorOptions,\n} from '../errors.js';\nimport { isHttpError } from '../errors.js';\n\ninterface Segment {\n lit?: string;\n param?: string;\n}\n\ninterface CompiledRoute {\n method: string;\n template: string;\n segments: Segment[];\n literals: number;\n handler: Handler;\n}\n\nconst splitPath = (path: string): string[] => path.split('/').filter(Boolean);\n\nfunction compileTemplate(template: string): Segment[] {\n return splitPath(template).map((seg) => {\n const braced = /^\\{([A-Za-z_][A-Za-z0-9_]*)\\}$/.exec(seg);\n if (braced) return { param: braced[1] };\n if (seg.startsWith(':') && seg.length > 1) return { param: seg.slice(1) };\n return { lit: seg };\n });\n}\n\nfunction matchSegments(segments: Segment[], reqSegs: string[]): Record<string, string> | null {\n if (segments.length !== reqSegs.length) return null;\n const params: Record<string, string> = {};\n for (let i = 0; i < segments.length; i++) {\n const s = segments[i]!;\n if (s.param) params[s.param] = decodeURIComponent(reqSegs[i]!);\n else if (s.lit !== reqSegs[i]) return null;\n }\n return params;\n}\n\nfunction headerOf(headers: Record<string, string> | undefined, name: string): string {\n if (!headers) return '';\n const direct = headers[name] ?? headers[name.toLowerCase()];\n if (typeof direct === 'string') return direct;\n const want = name.toLowerCase();\n for (const [k, v] of Object.entries(headers)) {\n if (k.toLowerCase() === want && typeof v === 'string') return v;\n }\n return '';\n}\n\nfunction decodeClaims(token: string): Record<string, unknown> {\n if (!token || token.split('.').length < 2) return {};\n try {\n const payload = token.split('.')[1]!.replace(/-/g, '+').replace(/_/g, '/');\n const parsed: unknown = JSON.parse(Buffer.from(payload, 'base64').toString('utf8'));\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n}\n\nfunction parseBody(req: FnRequest): Record<string, unknown> {\n const candidate = req.body ?? req.bodyText ?? req.bodyRaw;\n if (candidate == null || candidate === '') return {};\n if (typeof candidate === 'object') return candidate as Record<string, unknown>;\n if (typeof candidate === 'string') {\n try {\n const parsed: unknown = JSON.parse(candidate);\n return parsed && typeof parsed === 'object' ? (parsed as Record<string, unknown>) : {};\n } catch {\n return {};\n }\n }\n return {};\n}\n\n/**\n * Request query, percent-DECODED exactly once.\n *\n * `req.path` carries the query string verbatim as the gateway forwarded it, so\n * it is the authoritative source: `URLSearchParams` decodes it once, correctly,\n * and treats `+` as a space the way a form-encoded query requires.\n *\n * The runtime's own `req.query` hands values through *undecoded*. A filter of\n * `?code=m%61in` arrived as the literal `m%61in` and matched nothing, when per\n * RFC 3986 it simply means `main`. That broke every filter value needing an\n * escape — spaces, `&`, `+`, `/`, commas, anything non-ASCII — so \"Müller & Co\"\n * could not be filtered for at all. It also let the gateway's response cache\n * merge two spellings the app answered differently (revenexx/api#32).\n *\n * `req.query` stays the fallback for callers that populate it without a query\n * string on the path (the mock adapter and direct unit tests do this). Decoding\n * that again here would be wrong — a double decode turns `%2520` into a space —\n * so each source is decoded by exactly one owner.\n */\nfunction parseQuery(req: FnRequest): Record<string, string> {\n const out: Record<string, string> = {};\n const rawPath = String(req.path ?? '');\n const qmark = rawPath.indexOf('?');\n if (qmark >= 0) {\n for (const [k, v] of new URLSearchParams(rawPath.slice(qmark + 1))) out[k] = v;\n return out;\n }\n for (const [k, v] of Object.entries(req.query ?? {})) {\n if (typeof v === 'string') out[k] = v;\n else if (v != null) out[k] = String(v);\n }\n return out;\n}\n\nexport interface AppOptions {\n /** App name reported on the built-in health route. */\n name?: string;\n /**\n * Built-in `GET /` health route (default true). Responds with the app\n * identity (from the runtime env), status and the registered routes.\n */\n health?: boolean;\n /** Extra payload merged into the health response. */\n healthExtra?: () => Record<string, unknown>;\n}\n\nexport interface App {\n get(template: string, handler: Handler): App;\n post(template: string, handler: Handler): App;\n put(template: string, handler: Handler): App;\n patch(template: string, handler: Handler): App;\n delete(template: string, handler: Handler): App;\n on(method: string, template: string, handler: Handler): App;\n /** Registered routes (e.g. for docs or the health response). */\n routes(): { method: string; path: string }[];\n /** Build the function entrypoint: `module.exports = app.handler()`. */\n handler(): (context: FnContext) => Promise<unknown>;\n}\n\nconst tracer = trace.getTracer('@revenexx/app-sdk');\n\n/** Case-insensitive W3C trace-context extraction from the function's headers. */\nconst headerGetter: TextMapGetter<Record<string, string>> = {\n keys: (carrier) => Object.keys(carrier ?? {}),\n get: (carrier, key) => headerOf(carrier, key) || undefined,\n};\n\nexport function createApp(options: AppOptions = {}): App {\n const routes: CompiledRoute[] = [];\n const health = options.health !== false;\n\n const app: App = {\n get: (t, h) => app.on('GET', t, h),\n post: (t, h) => app.on('POST', t, h),\n put: (t, h) => app.on('PUT', t, h),\n patch: (t, h) => app.on('PATCH', t, h),\n delete: (t, h) => app.on('DELETE', t, h),\n on(method, template, handler) {\n const segments = compileTemplate(template);\n routes.push({\n method: method.toUpperCase(),\n template,\n segments,\n literals: segments.filter((s) => s.lit !== undefined).length,\n handler,\n });\n // Literal-first: more literal segments = more specific = tried first.\n routes.sort((a, b) => b.literals - a.literals);\n return app;\n },\n routes: () => routes.map((r) => ({ method: r.method, path: r.template })).sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method)),\n handler() {\n return (context: FnContext) => {\n const { req, res } = context;\n const headers = req.headers ?? {};\n const method = (req.method ?? 'GET').toUpperCase();\n const rawPath = String(req.path ?? '/').split('?')[0]!;\n const path = rawPath.replace(/\\/+$/, '') || '/';\n\n // Continue the caller's trace (gateway/site) when a traceparent is forwarded;\n // otherwise this SERVER span roots a fresh trace. Outbound PostgREST fetches\n // become child CLIENT spans via the undici instrumentation (see ./instrument).\n const parentCtx = propagation.extract(otelContext.active(), headers, headerGetter);\n\n return tracer.startActiveSpan(\n `${method} ${path}`,\n { kind: SpanKind.SERVER, attributes: { 'http.request.method': method, 'url.path': path } },\n parentCtx,\n async (span: Span) => {\n const contextToken = headerOf(headers, 'x-revenexx-context');\n const tenant =\n headerOf(headers, 'x-revenexx-tenant') ||\n (decodeClaims(contextToken).tenant_id as string | undefined) ||\n null;\n if (options.name) span.setAttribute('revenexx.app', options.name);\n if (tenant) span.setAttribute('revenexx.tenant', tenant);\n const log = (m: string) => context.log?.(m);\n\n log(`${options.name ?? 'app'} ${method} ${path} — tenant=${tenant ?? 'none'}`);\n\n try {\n if (health && path === '/' && method === 'GET') {\n span.setAttribute('http.route', '/');\n return res.json({\n app: {\n id: process.env.REVENEXX_APP_ID ?? null,\n name: options.name ?? process.env.REVENEXX_APP_NAME ?? null,\n deployment: process.env.REVENEXX_APP_DEPLOYMENT ?? null,\n runtime: `${process.env.REVENEXX_APP_RUNTIME_NAME ?? ''}-${process.env.REVENEXX_APP_RUNTIME_VERSION ?? ''}`,\n },\n status: 'ok',\n routes: app.routes(),\n timestamp: new Date().toISOString(),\n ...(options.healthExtra?.() ?? {}),\n });\n }\n\n const reqSegs = splitPath(path);\n let matched: { route: CompiledRoute; params: Record<string, string> } | null = null;\n let pathExists = false;\n for (const route of routes) {\n const params = matchSegments(route.segments, reqSegs);\n if (!params) continue;\n pathExists = true;\n if (route.method === method) {\n matched = { route, params };\n break;\n }\n }\n\n if (!matched) {\n const status = pathExists ? 405 : 404;\n span.setAttribute('http.response.status_code', status);\n span.setStatus({ code: SpanStatusCode.ERROR, message: pathExists ? 'method not allowed' : 'no route' });\n if (pathExists) {\n return res.json({ error: `method ${method} not allowed for ${path}` }, 405);\n }\n return res.json({ error: `no route for ${method} ${path}`, routes: app.routes() }, 404);\n }\n\n span.updateName(`${method} ${matched.route.template}`);\n span.setAttribute('http.route', matched.route.template);\n\n // Gateway-extracted params (x-capability-params) win over our own match\n // for safety, but they should always agree.\n let gatewayParams: Record<string, string> = {};\n try {\n gatewayParams = JSON.parse(headerOf(headers, 'x-capability-params') || '{}') as Record<string, string>;\n } catch {\n gatewayParams = {};\n }\n\n const c: RouteContext = {\n ctx: context,\n req,\n method,\n path,\n params: { ...matched.params, ...gatewayParams },\n query: parseQuery(req),\n body: parseBody(req),\n tenant,\n contextToken,\n header: (name) => headerOf(headers, name),\n log,\n json: (data, statusCode = 200) => res.json(data, statusCode),\n };\n\n return await matched.route.handler(c);\n } catch (err) {\n if (isHttpError(err)) {\n span.setAttribute('http.response.status_code', err.status);\n if (err.code) span.setAttribute('revenexx.error.code', err.code);\n if (err.status >= 500) span.setStatus({ code: SpanStatusCode.ERROR, message: err.message });\n // The diagnosis (table names, constraint names, the raw\n // PostgREST body) stays on this side of the wire: logged and\n // traced, never serialised into the response.\n if (err.serverDetail !== undefined) {\n const detail =\n typeof err.serverDetail === 'string' ? err.serverDetail : JSON.stringify(err.serverDetail);\n span.setAttribute('revenexx.error.detail', detail);\n context.error?.(`${method} ${path} — ${err.status} ${err.message}: ${detail}`);\n }\n return res.json(\n {\n error: err.message,\n ...(err.code ? { code: err.code } : {}),\n ...(err.details != null ? { details: err.details } : {}),\n },\n err.status,\n );\n }\n const msg = err instanceof Error ? err.message : String(err);\n if (/not permitted/.test(msg)) {\n span.setAttribute('http.response.status_code', 403);\n return res.json({ error: msg }, 403);\n }\n span.recordException(err instanceof Error ? err : new Error(msg));\n span.setStatus({ code: SpanStatusCode.ERROR, message: msg });\n context.error?.(`unhandled error on ${method} ${path}: ${msg}`);\n return res.json({ error: msg }, 500);\n } finally {\n span.end();\n }\n },\n );\n };\n },\n };\n\n return app;\n}\n","/**\n * CRUD route mounting: wire a generated entity client to REST routes in one\n * call, with the platform's standard list/get/create/update/delete semantics.\n *\n * const app = createApp({ name: 'markets' });\n * const db = createDb({ adapter: 'runtime', context });\n *\n * mountCrud(app, db.markets, { path: '/markets', columns: ENTITIES.markets.columns });\n * mountCrud(app, db.locales, {\n * path: '/markets/{marketId}/locales',\n * columns: ENTITIES.locales.columns,\n * parent: { param: 'marketId', column: 'market_id' },\n * });\n *\n * Nested resources (a `parent` option) scope every operation to the parent row:\n * lists filter by the parent column, creates inject it, and reads/writes 404\n * when the row belongs to a different parent.\n */\n\nimport type { Page, Query, Row } from '../types.js';\nimport { HttpError, notFound, type App, type RouteContext } from './router.js';\n\n/** Structural subset of the SDK's EntityClient — any compatible repo works. */\nexport interface RepoLike {\n list(query?: Query): Promise<Row[]>;\n page?(query?: Query): Promise<Page>;\n get(id: string | number): Promise<Row | null>;\n create(data: Row): Promise<Row>;\n update(id: string | number, patch: Row): Promise<Row>;\n delete(id: string | number): Promise<void>;\n}\n\nexport interface CrudOptions {\n /** Route base path, e.g. `/markets` or `/markets/{marketId}/locales`. */\n path: string;\n /** Column metadata (from the generated ENTITIES) — enables `?col=value` list filters. */\n columns?: Record<string, unknown>;\n /**\n * Nested-resource scoping: path param name + the FK column it maps to.\n *\n * Pass `repo` (the PARENT's repo) to make the collection routes verify the\n * parent exists. Without it, `GET /lists/{unknown-id}/entries` answers `200`\n * with an empty page, which a client cannot tell apart from a parent that\n * genuinely has no children — and `POST` would attach a row to a parent that\n * is not there. The single-row routes never had this gap: `fetchOwned`\n * already 404s on an ownership mismatch.\n *\n * Optional to stay backwards compatible; it costs one extra read per\n * collection request, so it is the app's call.\n */\n parent?: { param: string; column: string; repo?: Pick<RepoLike, 'get'> };\n /** Path param for the row id (default `id`). */\n idParam?: string;\n /** Pagination bounds for list (defaults: 50, max 200). */\n defaultLimit?: number;\n maxLimit?: number;\n /** Restrict which routes are mounted (default: all five). */\n only?: ('list' | 'get' | 'create' | 'update' | 'delete')[];\n}\n\nconst INT = (v: unknown, d: number): number => {\n const n = parseInt(String(v), 10);\n return Number.isFinite(n) ? n : d;\n};\n\nfunction parentWhere(c: RouteContext, parent?: CrudOptions['parent']): Record<string, string> {\n if (!parent) return {};\n const value = c.params[parent.param];\n if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);\n return { [parent.column]: value };\n}\n\n/**\n * 404 when the nested parent does not exist, so an unknown parent is not\n * reported as an empty collection. No-op unless the app supplied `parent.repo`.\n */\nasync function assertParentExists(c: RouteContext, parent?: CrudOptions['parent']): Promise<void> {\n if (!parent?.repo) return;\n const value = c.params[parent.param];\n if (!value) throw new HttpError(400, `missing path parameter '${parent.param}'`);\n if (!(await parent.repo.get(value))) throw notFound();\n}\n\n/** Fetch a row and enforce nested-parent ownership; throws 404 when absent. */\nasync function fetchOwned(\n repo: RepoLike,\n c: RouteContext,\n opts: CrudOptions,\n): Promise<{ id: string; row: Row }> {\n const id = c.params[opts.idParam ?? 'id'] ?? '';\n if (!id) throw new HttpError(400, `missing path parameter '${opts.idParam ?? 'id'}'`);\n const row = await repo.get(id);\n if (!row) throw notFound();\n if (opts.parent) {\n const expected = c.params[opts.parent.param];\n if (String(row[opts.parent.column] ?? '') !== String(expected ?? '')) throw notFound();\n }\n return { id, row };\n}\n\nexport function mountCrud(app: App, repo: RepoLike, opts: CrudOptions): App {\n const base = opts.path.replace(/\\/+$/, '');\n const idTemplate = `${base}/{${opts.idParam ?? 'id'}}`;\n const enabled = new Set(opts.only ?? ['list', 'get', 'create', 'update', 'delete']);\n const defaultLimit = opts.defaultLimit ?? 50;\n const maxLimit = opts.maxLimit ?? 200;\n\n if (enabled.has('list')) {\n app.get(base, async (c) => {\n await assertParentExists(c, opts.parent);\n const where: Record<string, string> = {};\n for (const [k, v] of Object.entries(c.query)) {\n if (opts.columns && k in opts.columns) where[k] = v;\n }\n // The nested-parent filter always wins — a query param must not widen\n // the scope beyond the parent in the path.\n Object.assign(where, parentWhere(c, opts.parent));\n const limit = Math.min(Math.max(INT(c.query.limit, defaultLimit), 1), maxLimit);\n const offset = Math.max(INT(c.query.offset, 0), 0);\n const order = typeof c.query.order === 'string' && c.query.order ? c.query.order : undefined;\n const query: Query = { where, limit, offset, ...(order ? { order } : {}) };\n\n if (repo.page) {\n const { items, total } = await repo.page(query);\n return c.json({\n items,\n page: { limit, offset, total, returned: items.length, hasMore: offset + items.length < total },\n filter: where,\n });\n }\n const items = await repo.list(query);\n return c.json({ items, page: { limit, offset, returned: items.length }, filter: where });\n });\n }\n\n if (enabled.has('create')) {\n app.post(base, async (c) => {\n await assertParentExists(c, opts.parent);\n const data = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.create(data), 201);\n });\n }\n\n if (enabled.has('get')) {\n app.get(idTemplate, async (c) => {\n const { row } = await fetchOwned(repo, c, opts);\n return c.json(row);\n });\n }\n\n if (enabled.has('update')) {\n app.put(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n // A body carrying no fields of its own is not an update. Passing it\n // through produced an empty PostgREST patch, which surfaced as a 500 with\n // a raw Node message (\"The first argument must be of type string or an\n // instance of Buffer … Received undefined\") — an internal serializer\n // fault reported as a server error for what is a malformed request. The\n // guard reads c.body, not the merged patch: with a nested parent the\n // merge always carries the FK, so the patch is never literally empty.\n const fields = c.body && typeof c.body === 'object' && !Array.isArray(c.body) ? Object.keys(c.body) : [];\n if (fields.length === 0) throw new HttpError(400, 'request body must contain at least one field to update');\n // Never let a body overwrite the nested-parent FK.\n const patch = { ...c.body, ...parentWhere(c, opts.parent) };\n return c.json(await repo.update(id, patch));\n });\n }\n\n if (enabled.has('delete')) {\n app.delete(idTemplate, async (c) => {\n const { id } = await fetchOwned(repo, c, opts);\n await repo.delete(id);\n return c.json({ deleted: true, id });\n });\n }\n\n return app;\n}\n"],"mappings":"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","names":["items"]}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@revenexx/app-sdk",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.6.0",
|
|
4
4
|
"description": "Typed data client + HTTP router for revenexx Apps. Swappable adapters (mock | remote | runtime) so the same App code runs against in-memory fixtures locally and the real data plane in production.",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"type": "module",
|
|
@@ -1,66 +0,0 @@
|
|
|
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
|
-
export type { Adapter as A, ColumnDef as C, Entity as E, Filter as F, Op as O, Page as P, Query as Q, Row as R, Scalar as S, FilterOp as a };
|
package/dist/types-BMd8t8Pi.d.ts
DELETED
|
@@ -1,66 +0,0 @@
|
|
|
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
|
-
export type { Adapter as A, ColumnDef as C, Entity as E, Filter as F, Op as O, Page as P, Query as Q, Row as R, Scalar as S, FilterOp as a };
|