@kozou/api 0.0.1 → 1.0.0

package/dist/embed.d.ts

@@ -0,0 +1,46 @@
+import type { RelationContext } from '@kozou/core';
+import type { Resource, ResourceLookup } from './schema-lookup.js';
+/** Maximum relation chain length (dot-separated segments) per embed path. */
+export declare const MAX_EMBED_DEPTH = 5;
+/** Maximum number of distinct relations a single request may embed. */
+export declare const MAX_EMBED_RELATIONS = 25;
+/** Maximum number of child rows inlined per parent for a to-many embed. */
+export declare const MAX_EMBED_CHILDREN = 100;
+export type EmbedKind = 'to-one' | 'to-many';
+export type EmbedNode = {
+    /** `to-one`: a forward FK on the parent. `to-many`: a child's FK pointing
+     *  back at the parent. */
+    kind: EmbedKind;
+    /** The foreign key linking parent and target. For `to-one` it lives on the
+     *  parent (`relation.field`) and points at the target (`references.column`);
+     *  for `to-many` it lives on the child target (`relation.field`) and points
+     *  back at the parent (`references.column`). */
+    relation: RelationContext;
+    /** The resolved target resource; its columns form the nested allowlist. */
+    target: Resource;
+    /** The key the nested value is returned under. */
+    key: string;
+    /** Deeper embeds, resolved against `target`. */
+    children: EmbedNode[];
+};
+export type EmbedSpec = EmbedNode[];
+/** Split a raw `embed` value into paths. Pure: no schema knowledge.
+ *  `"author,editions.books"` -> `[["author"], ["editions", "books"]]`. */
+export declare function parseEmbedParam(raw: string | null | undefined): string[][];
+/** Resolve + validate parsed paths into an embed forest. Throws `badRequest`
+ *  on any unknown / ambiguous selector, over-cap depth or count, or
+ *  unembeddable target. Paths sharing a prefix are merged so a relation is
+ *  embedded at most once per parent. */
+export declare function resolveEmbedSpec(root: Resource, paths: string[][], lookup: ResourceLookup): EmbedSpec;
+/** Render the SELECT-list fragment for an embed forest, composed recursively
+ *  for depth. `parentRef` is the SQL reference for the parent row scope (the
+ *  qualified table name at the top level, a generated alias below); `counter`
+ *  keeps aliases unique across the whole statement. Identifiers only — no
+ *  bound parameters are produced.
+ *
+ *  - to-one  -> `(SELECT to_jsonb(eN) FROM (...) eN) AS "key"`              (object | null)
+ *  - to-many -> `(SELECT coalesce(jsonb_agg(...), '[]') FROM (...) eN) AS "key"` (array) */
+export declare function buildEmbedSelectFragment(spec: EmbedNode[], parentRef: string, counter: {
+    n: number;
+}): string;
+//# sourceMappingURL=embed.d.ts.map

package/dist/embed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.d.ts","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AAEpF,6EAA6E;AAC7E,eAAO,MAAM,eAAe,IAAI,CAAC;AACjC,uEAAuE;AACvE,eAAO,MAAM,mBAAmB,KAAK,CAAC;AACtC,2EAA2E;AAC3E,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAE7C,MAAM,MAAM,SAAS,GAAG;IACtB;8BAC0B;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB;;;oDAGgD;IAChD,QAAQ,EAAE,eAAe,CAAC;IAC1B,2EAA2E;IAC3E,MAAM,EAAE,QAAQ,CAAC;IACjB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,gDAAgD;IAChD,QAAQ,EAAE,SAAS,EAAE,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;AAEpC;0EAC0E;AAC1E,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,EAAE,EAAE,CAW1E;AAED;;;wCAGwC;AACxC,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,MAAM,EAAE,EAAE,EACjB,MAAM,EAAE,cAAc,GACrB,SAAS,CAUX;AAsHD;;;;;;;4FAO4F;AAC5F,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,SAAS,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACrB,MAAM,CAuBR"}

package/dist/embed.js

@@ -0,0 +1,181 @@
+// The `embed` sub-language for the read path. Inlines related rows as nested
+// JSON, to a capped depth, in a single SQL statement:
+//   - forward (to-one / one-to-one): the parent's FK -> a single object.
+//   - reverse (one-to-many): children whose FK points back -> an array.
+//
+// Pipeline:
+//   parseEmbedParam          "a,b.c"        -> string[][]            (pure syntax)
+//   resolveEmbedSpec         paths + lookup -> EmbedNode[]           (validate; all 400s)
+//   buildEmbedSelectFragment spec           -> SQL SELECT-list text  (identifiers only)
+//
+// Safety: every identifier emitted comes from the introspected schema (a
+// relation's field / referenced column, or a target's declared columns), never
+// from the raw request string. The selector only *chooses* which allowlisted
+// relation to follow. No bound parameters are produced, so the caller's $n
+// numbering is untouched.
+import { badRequest } from './errors.js';
+import { quoteIdent, qualified } from './ident.js';
+/** Maximum relation chain length (dot-separated segments) per embed path. */
+export const MAX_EMBED_DEPTH = 5;
+/** Maximum number of distinct relations a single request may embed. */
+export const MAX_EMBED_RELATIONS = 25;
+/** Maximum number of child rows inlined per parent for a to-many embed. */
+export const MAX_EMBED_CHILDREN = 100;
+/** Split a raw `embed` value into paths. Pure: no schema knowledge.
+ *  `"author,editions.books"` -> `[["author"], ["editions", "books"]]`. */
+export function parseEmbedParam(raw) {
+    if (raw === null || raw === undefined)
+        return [];
+    const paths = [];
+    for (const group of raw.split(',')) {
+        const segments = group
+            .split('.')
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        if (segments.length > 0)
+            paths.push(segments);
+    }
+    return paths;
+}
+/** Resolve + validate parsed paths into an embed forest. Throws `badRequest`
+ *  on any unknown / ambiguous selector, over-cap depth or count, or
+ *  unembeddable target. Paths sharing a prefix are merged so a relation is
+ *  embedded at most once per parent. */
+export function resolveEmbedSpec(root, paths, lookup) {
+    const counter = { n: 0 };
+    const forest = [];
+    for (const path of paths) {
+        if (path.length > MAX_EMBED_DEPTH) {
+            throw badRequest(`Embed depth ${path.length} exceeds the maximum of ${MAX_EMBED_DEPTH}.`);
+        }
+        insertPath(root, path, 0, forest, lookup, counter);
+    }
+    return forest;
+}
+function insertPath(parent, path, index, siblings, lookup, counter) {
+    if (index >= path.length)
+        return;
+    const resolved = resolveSegment(parent, path[index], lookup);
+    let node = siblings.find((s) => s.kind === resolved.kind &&
+        s.target.qualifiedName === resolved.target.qualifiedName &&
+        s.relation.field === resolved.relation.field);
+    if (node === undefined) {
+        if (counter.n >= MAX_EMBED_RELATIONS) {
+            throw badRequest(`Embed requests too many relations (max ${MAX_EMBED_RELATIONS}).`);
+        }
+        const key = chooseKey(resolved.target, resolved.relation, siblings, parent);
+        node = { kind: resolved.kind, relation: resolved.relation, target: resolved.target, key, children: [] };
+        siblings.push(node);
+        counter.n += 1;
+    }
+    insertPath(node.target, path, index + 1, node.children, lookup, counter);
+}
+/** Resolve one selector against a parent: a forward relation first, then a
+ *  reverse (child) relation. Views expose neither. */
+function resolveSegment(parent, selector, lookup) {
+    if (parent.kind === 'view') {
+        throw badRequest(`Resource "${parent.name}" is a view and exposes no embeddable relations.`);
+    }
+    const forward = matchForward(parent, selector);
+    if (forward !== undefined) {
+        return { kind: 'to-one', relation: forward, target: resolveTarget(forward, lookup) };
+    }
+    const reverse = matchReverse(parent, selector, lookup);
+    if (reverse !== undefined) {
+        return { kind: 'to-many', relation: reverse.relation, target: reverse.child };
+    }
+    throw badRequest(`Unknown embed relation "${selector}" on resource "${parent.name}".`);
+}
+/** Match a forward to-one relation by FK field name, or by referenced table
+ *  name when exactly one FK targets it. */
+function matchForward(parent, selector) {
+    const byField = parent.relations.find((r) => r.field === selector);
+    if (byField !== undefined)
+        return byField;
+    const byTable = parent.relations.filter((r) => r.references.table === selector);
+    if (byTable.length === 1)
+        return byTable[0];
+    if (byTable.length > 1) {
+        const fields = byTable.map((r) => r.field).join('", "');
+        throw badRequest(`Ambiguous embed "${selector}" on "${parent.name}": foreign keys "${fields}" all reference "${selector}"; use the foreign-key column name.`);
+    }
+    return undefined;
+}
+/** Match a reverse to-many relation by child table name, when exactly one of
+ *  that child's foreign keys references the parent. */
+function matchReverse(parent, selector, lookup) {
+    const candidates = lookup.reverse(parent.qualifiedName).filter((e) => e.child.name === selector);
+    if (candidates.length === 1)
+        return candidates[0];
+    if (candidates.length > 1) {
+        const fields = candidates.map((e) => e.relation.field).join('", "');
+        throw badRequest(`Ambiguous reverse embed "${selector}" on "${parent.name}": "${selector}" references it via "${fields}"; embedding multiple reverse keys is not yet supported.`);
+    }
+    return undefined;
+}
+function resolveTarget(relation, lookup) {
+    const qn = `${relation.references.schema}.${relation.references.table}`;
+    const target = lookup.resolve(qn);
+    if (target === undefined) {
+        throw badRequest(`Embed target "${qn}" is not an available resource.`);
+    }
+    return target;
+}
+/** Pick a result key that collides with neither a sibling embed nor a real
+ *  column on the parent (which would shadow the raw scalar value). Prefers the
+ *  target table name, then the FK field with a trailing id-suffix stripped,
+ *  then the raw FK field. */
+function chooseKey(target, relation, siblings, parent) {
+    const taken = new Set(siblings.map((s) => s.key));
+    const columns = new Set(parent.columns.map((c) => c.name));
+    const candidates = [target.name, stripIdSuffix(relation.field), relation.field];
+    for (const key of candidates) {
+        if (key.length > 0 && !taken.has(key) && !columns.has(key))
+            return key;
+    }
+    throw badRequest(`Cannot derive a non-conflicting embed key for "${relation.field}" on "${parent.name}".`);
+}
+function stripIdSuffix(field) {
+    const stripped = field.replace(/_(id|uuid|fk|key)$/i, '');
+    return stripped.length > 0 ? stripped : field;
+}
+/** Render the SELECT-list fragment for an embed forest, composed recursively
+ *  for depth. `parentRef` is the SQL reference for the parent row scope (the
+ *  qualified table name at the top level, a generated alias below); `counter`
+ *  keeps aliases unique across the whole statement. Identifiers only — no
+ *  bound parameters are produced.
+ *
+ *  - to-one  -> `(SELECT to_jsonb(eN) FROM (...) eN) AS "key"`              (object | null)
+ *  - to-many -> `(SELECT coalesce(jsonb_agg(...), '[]') FROM (...) eN) AS "key"` (array) */
+export function buildEmbedSelectFragment(spec, parentRef, counter) {
+    let out = '';
+    for (const node of spec) {
+        counter.n += 1;
+        const alias = `e${counter.n}`;
+        const cols = node.target.columns.length > 0
+            ? node.target.columns.map((c) => quoteIdent(c.name)).join(', ')
+            : '*';
+        const children = buildEmbedSelectFragment(node.children, alias, counter);
+        const fkField = quoteIdent(node.relation.field);
+        const refCol = quoteIdent(node.relation.references.column);
+        if (node.kind === 'to-one') {
+            const inner = `SELECT ${cols}${children} FROM ${qualified(node.target)} ${alias} WHERE ${alias}.${refCol} = ${parentRef}.${fkField}`;
+            out += `, (SELECT to_jsonb(${alias}) FROM (${inner}) ${alias}) AS ${quoteIdent(node.key)}`;
+        }
+        else {
+            const order = orderByPrimaryKey(node.target, alias);
+            const inner = `SELECT ${cols}${children} FROM ${qualified(node.target)} ${alias} WHERE ${alias}.${fkField} = ${parentRef}.${refCol}${order} LIMIT ${MAX_EMBED_CHILDREN}`;
+            out += `, (SELECT coalesce(jsonb_agg(to_jsonb(${alias})${order}), '[]'::jsonb) FROM (${inner}) ${alias}) AS ${quoteIdent(node.key)}`;
+        }
+    }
+    return out;
+}
+/** `ORDER BY <alias>.<pk>...` for deterministic, bounded to-many results.
+ *  Empty when the target has no primary key. */
+function orderByPrimaryKey(target, alias) {
+    if (target.primaryKey.length === 0)
+        return '';
+    const cols = target.primaryKey.map((c) => `${alias}.${quoteIdent(c)}`).join(', ');
+    return ` ORDER BY ${cols}`;
+}
+//# sourceMappingURL=embed.js.map

package/dist/embed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"embed.js","sourceRoot":"","sources":["../src/embed.ts"],"names":[],"mappings":"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"}

package/dist/errors.d.ts

@@ -0,0 +1,19 @@
+export declare class KozouApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+/** Shape of the JSON body returned for any non-2xx response. */
+export type ApiErrorBody = {
+    error: {
+        code: string;
+        message: string;
+    };
+};
+export declare function errorBody(code: string, message: string): ApiErrorBody;
+export declare function notFound(message: string): KozouApiError;
+export declare function badRequest(message: string): KozouApiError;
+export declare function methodNotAllowed(message: string): KozouApiError;
+export declare function unauthorized(message: string): KozouApiError;
+export declare function forbidden(message: string): KozouApiError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAKA,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAM1D;AAED,gEAAgE;AAChE,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,YAAY,CAErE;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAEvD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAEzD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE/D;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE3D;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAExD"}

package/dist/errors.js

@@ -0,0 +1,33 @@
+// Error type for the Kozou REST layer. A KozouApiError carries the HTTP
+// status and a short machine-readable code; the request handler maps it
+// to a JSON error body. Anything thrown that is *not* a KozouApiError is
+// treated as an unexpected 500.
+export class KozouApiError extends Error {
+    status;
+    code;
+    constructor(status, code, message) {
+        super(message);
+        this.name = 'KozouApiError';
+        this.status = status;
+        this.code = code;
+    }
+}
+export function errorBody(code, message) {
+    return { error: { code, message } };
+}
+export function notFound(message) {
+    return new KozouApiError(404, 'not_found', message);
+}
+export function badRequest(message) {
+    return new KozouApiError(400, 'bad_request', message);
+}
+export function methodNotAllowed(message) {
+    return new KozouApiError(405, 'method_not_allowed', message);
+}
+export function unauthorized(message) {
+    return new KozouApiError(401, 'unauthorized', message);
+}
+export function forbidden(message) {
+    return new KozouApiError(403, 'forbidden', message);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,wEAAwE;AACxE,yEAAyE;AACzE,gCAAgC;AAEhC,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAS;IACf,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAY,EAAE,OAAe;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAUD,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,OAAe;IACrD,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,OAAe;IACtC,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,cAAc,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,OAAO,IAAI,aAAa,CAAC,GAAG,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC"}

package/dist/handler.d.ts

@@ -0,0 +1,39 @@
+import type { ResourceLookup } from './schema-lookup.js';
+import { type ListQueryParams } from './query-builder.js';
+/** Minimal query interface satisfied by both `pg.Pool` and `pg.Client`. */
+export type Queryable = {
+    query<R extends Record<string, unknown>>(text: string, values?: unknown[]): Promise<{
+        rows: R[];
+        rowCount: number | null;
+    }>;
+};
+export type ApiHandlerDeps = {
+    db: Queryable;
+    lookup: ResourceLookup;
+    /** Advertised in `GET /`. Optional; defaults to null. */
+    version?: string;
+    /** Prebuilt OpenAPI document served at `GET /openapi.json`. */
+    openapi?: Record<string, unknown>;
+};
+export type ApiHttpRequest = {
+    method: string;
+    /** URL-decoded path segments with empty segments removed. */
+    segments: string[];
+    query: URLSearchParams;
+    /** Parsed JSON request body (create / update). Undefined when absent. */
+    body?: unknown;
+    /** Raw request headers (node lower-cases the keys). Used for auth; absent on
+     *  the zero-auth path. */
+    headers?: Record<string, string | string[] | undefined>;
+};
+export type ApiHttpResult = {
+    status: number;
+    body: unknown;
+};
+/** List query keys consumed as controls (not column filters). Shared with the
+ *  OpenAPI generator so it never advertises a control key as a filterable
+ *  column. */
+export declare const RESERVED_PARAMS: Set<string>;
+export declare function handleApiRequest(deps: ApiHandlerDeps, req: ApiHttpRequest): Promise<ApiHttpResult>;
+export declare function parseListParams(query: URLSearchParams): ListQueryParams;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAY,MAAM,oBAAoB,CAAC;AACnE,OAAO,EAOL,KAAK,eAAe,EAIrB,MAAM,oBAAoB,CAAC;AAG5B,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,EAAE,GACjB,OAAO,CAAC;QAAE,IAAI,EAAE,CAAC,EAAE,CAAC;QAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;CACpD,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,SAAS,CAAC;IACd,MAAM,EAAE,cAAc,CAAC;IACvB,yDAAyD;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,yEAAyE;IACzE,IAAI,CAAC,EAAE,OAAO,CAAC;IACf;8BAC0B;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;CACzD,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF;;cAEc;AACd,eAAO,MAAM,eAAe,aAA2D,CAAC;AAExF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,cAAc,EACpB,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,aAAa,CAAC,CAUxB;AAkLD,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CA0BvE"}

package/dist/handler.js

@@ -0,0 +1,267 @@
+// Framework-agnostic request handling. Maps a parsed HTTP request to a
+// JSON result, independent of node:http (so it can be unit-tested with a
+// fake Queryable and driven by the node:http wiring in startApiServer.ts).
+import { KozouApiError, badRequest, errorBody, methodNotAllowed, notFound } from './errors.js';
+import { buildGetQuery, buildListQuery, buildInsertQuery, buildUpdateQuery, buildDeleteQuery, buildRelationOptionsQuery, } from './query-builder.js';
+import { parseEmbedParam, resolveEmbedSpec } from './embed.js';
+/** List query keys consumed as controls (not column filters). Shared with the
+ *  OpenAPI generator so it never advertises a control key as a filterable
+ *  column. */
+export const RESERVED_PARAMS = new Set(['page', 'pageSize', 'sort', 'search', 'embed']);
+export async function handleApiRequest(deps, req) {
+    try {
+        return await route(deps, req);
+    }
+    catch (err) {
+        if (err instanceof KozouApiError) {
+            return { status: err.status, body: errorBody(err.code, err.message) };
+        }
+        const message = err instanceof Error ? err.message : String(err);
+        return { status: 500, body: errorBody('internal', message) };
+    }
+}
+async function route(deps, req) {
+    const { method, segments, query } = req;
+    const m = method.toUpperCase();
+    if (segments.length === 0) {
+        requireMethod(method, 'GET');
+        return {
+            status: 200,
+            body: { name: 'kozou-api', version: deps.version ?? null, resources: deps.lookup.list() },
+        };
+    }
+    if (segments.length === 1 && segments[0] === 'openapi.json') {
+        requireMethod(method, 'GET');
+        if (!deps.openapi) {
+            throw notFound('OpenAPI document is not configured.');
+        }
+        return { status: 200, body: deps.openapi };
+    }
+    if (segments.length === 1) {
+        const resource = resolveOr404(deps.lookup, segments[0]);
+        if (m === 'GET') {
+            return query.get('as') === 'options'
+                ? relationOptions(deps, resource, query)
+                : listResource(deps, resource, query);
+        }
+        if (m === 'POST')
+            return createResource(deps, resource, req.body);
+        throw methodNotAllowed(`Method ${method} not allowed on a collection; use GET or POST.`);
+    }
+    if (segments.length === 2) {
+        const resource = resolveOr404(deps.lookup, segments[0]);
+        const id = segments[1];
+        if (m === 'GET')
+            return getResource(deps, resource, id, query);
+        if (m === 'PATCH')
+            return updateResource(deps, resource, id, req.body);
+        if (m === 'DELETE')
+            return deleteResource(deps, resource, id);
+        throw methodNotAllowed(`Method ${method} not allowed on an item; use GET, PATCH, or DELETE.`);
+    }
+    throw notFound(`No route for /${segments.join('/')}.`);
+}
+async function listResource(deps, resource, query) {
+    const params = parseListParams(query);
+    const embed = resolveEmbedSpec(resource, parseEmbedParam(query.get('embed')), deps.lookup);
+    const built = buildListQuery(resource, { ...params, embed });
+    const [dataResult, countResult] = await Promise.all([
+        deps.db.query(built.dataText, built.dataValues),
+        deps.db.query(built.countText, built.countValues),
+    ]);
+    const total = Number(countResult.rows[0]?.total ?? 0);
+    return {
+        status: 200,
+        body: { rows: dataResult.rows, total, page: built.page, pageSize: built.pageSize },
+    };
+}
+async function getResource(deps, resource, id, query) {
+    const embed = resolveEmbedSpec(resource, parseEmbedParam(query.get('embed')), deps.lookup);
+    const built = buildGetQuery(resource, id, embed);
+    const result = await deps.db.query(built.text, built.values);
+    if (result.rows.length === 0) {
+        return notFoundResult(resource, id);
+    }
+    return { status: 200, body: result.rows[0] };
+}
+async function createResource(deps, resource, body) {
+    requireWritable(resource);
+    const built = buildInsertQuery(resource, requireObjectBody(body));
+    const result = await deps.db.query(built.text, built.values);
+    return { status: 201, body: result.rows[0] };
+}
+async function updateResource(deps, resource, id, body) {
+    requireWritable(resource);
+    const built = buildUpdateQuery(resource, id, requireObjectBody(body));
+    const result = await deps.db.query(built.text, built.values);
+    if (result.rows.length === 0)
+        return notFoundResult(resource, id);
+    return { status: 200, body: result.rows[0] };
+}
+async function deleteResource(deps, resource, id) {
+    requireWritable(resource);
+    const built = buildDeleteQuery(resource, id);
+    const result = await deps.db.query(built.text, built.values);
+    if (result.rows.length === 0)
+        return notFoundResult(resource, id);
+    return { status: 200, body: result.rows[0] };
+}
+async function relationOptions(deps, resource, query) {
+    const labelField = query.get('label');
+    if (labelField === null || labelField.length === 0) {
+        throw badRequest('Relation options require a "label" query parameter.');
+    }
+    const fieldsRaw = query.get('fields');
+    const searchFields = fieldsRaw
+        ? fieldsRaw.split(',').map((s) => s.trim()).filter((s) => s.length > 0)
+        : [];
+    const built = buildRelationOptionsQuery(resource, {
+        labelField,
+        searchFields,
+        query: query.get('q') ?? undefined,
+        limit: parsePositiveInt(query.get('limit')),
+    });
+    const result = await deps.db.query(built.text, built.values);
+    const options = result.rows.map((row) => ({
+        id: row[built.primaryKey],
+        label: String(row[built.labelField] ?? ''),
+    }));
+    return { status: 200, body: { options } };
+}
+function notFoundResult(resource, id) {
+    return {
+        status: 404,
+        body: errorBody('not_found', `No "${resource.name}" row with id "${id}".`),
+    };
+}
+function requireWritable(resource) {
+    if (resource.kind === 'view') {
+        throw methodNotAllowed(`Resource "${resource.name}" is a read-only view.`);
+    }
+}
+function requireObjectBody(body) {
+    if (body === null || typeof body !== 'object' || Array.isArray(body)) {
+        throw badRequest('Request body must be a JSON object.');
+    }
+    return body;
+}
+function resolveOr404(lookup, name) {
+    const resource = lookup.resolve(name);
+    if (!resource) {
+        throw notFound(`Unknown resource "${name}".`);
+    }
+    return resource;
+}
+function requireMethod(method, allowed) {
+    if (method.toUpperCase() !== allowed) {
+        throw methodNotAllowed(`Method ${method} not allowed here; use ${allowed}.`);
+    }
+}
+export function parseListParams(query) {
+    const params = {};
+    const page = parsePositiveInt(query.get('page'));
+    if (page !== undefined)
+        params.page = page;
+    const pageSize = parsePositiveInt(query.get('pageSize'));
+    if (pageSize !== undefined)
+        params.pageSize = pageSize;
+    const search = query.get('search');
+    if (search !== null && search.length > 0)
+        params.search = search;
+    const sort = parseSort(query.get('sort'));
+    if (sort.length > 0)
+        params.sort = sort;
+    // Each non-reserved query entry is one horizontal filter. Repeated keys are
+    // kept (not collapsed) so a column can carry several filters — e.g. a
+    // `?price=gte.10&price=lte.20` range — that combine with AND.
+    const filters = [];
+    for (const [key, value] of query.entries()) {
+        if (RESERVED_PARAMS.has(key))
+            continue;
+        filters.push(parseFilter(key, value));
+    }
+    if (filters.length > 0)
+        params.filters = filters;
+    return params;
+}
+const FILTER_OPERATORS = new Set([
+    'eq',
+    'neq',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'like',
+    'ilike',
+    'in',
+    'is',
+]);
+function isFilterOperator(token) {
+    return FILTER_OPERATORS.has(token);
+}
+/**
+ * Parse one `?<column>=<raw>` entry into a structured {@link Filter}.
+ *
+ * Grammar: `<op>.<value>` where `op` is one of the known operators; the split
+ * is on the FIRST `.` only (so values may contain dots). A value whose prefix
+ * is not a known operator — or which has no leading `op.` at all — is treated
+ * as an equality match, keeping the legacy `?<column>=<value>` form working.
+ * The split uses `indexOf`, not a regular expression (ReDoS-safe).
+ */
+function parseFilter(column, raw) {
+    const dot = raw.indexOf('.');
+    if (dot > 0) {
+        const maybeOp = raw.slice(0, dot);
+        if (isFilterOperator(maybeOp)) {
+            return buildFilter(column, maybeOp, raw.slice(dot + 1));
+        }
+    }
+    return { column, op: 'eq', value: raw };
+}
+function buildFilter(column, op, rhs) {
+    if (op === 'in') {
+        if (rhs.length < 2 || rhs[0] !== '(' || rhs[rhs.length - 1] !== ')') {
+            throw badRequest(`Filter "${column}=in.${rhs}" must look like "in.(v1,v2,...)".`);
+        }
+        const inner = rhs.slice(1, -1);
+        // Note: values cannot contain a comma (no quoting is supported in v1.0).
+        const values = inner.length === 0 ? [] : inner.split(',');
+        return { column, op: 'in', values };
+    }
+    if (op === 'is') {
+        if (rhs === 'null' || rhs === 'notnull' || rhs === 'true' || rhs === 'false') {
+            return { column, op: 'is', keyword: rhs };
+        }
+        throw badRequest(`Filter "${column}=is.${rhs}" must be one of is.null, is.notnull, is.true, is.false.`);
+    }
+    return { column, op, value: rhs };
+}
+function parsePositiveInt(raw) {
+    if (raw === null || raw.length === 0)
+        return undefined;
+    const n = Number(raw);
+    if (!Number.isFinite(n))
+        return undefined;
+    return n;
+}
+function parseSort(raw) {
+    if (raw === null || raw.length === 0)
+        return [];
+    const result = [];
+    for (const token of raw.split(',')) {
+        const trimmed = token.trim();
+        if (trimmed.length === 0)
+            continue;
+        const dot = trimmed.lastIndexOf('.');
+        if (dot > 0) {
+            const suffix = trimmed.slice(dot + 1).toLowerCase();
+            if (suffix === 'asc' || suffix === 'desc') {
+                result.push({ field: trimmed.slice(0, dot), order: suffix });
+                continue;
+            }
+        }
+        result.push({ field: trimmed, order: 'asc' });
+    }
+    return result;
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"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"}

package/dist/ident.d.ts

@@ -0,0 +1,7 @@
+import type { Resource } from './schema-lookup.js';
+/** Quote an identifier for safe inlining (defense in depth on top of the
+ *  allowlist). */
+export declare function quoteIdent(id: string): string;
+/** `"schema"."name"` for a resolved resource. */
+export declare function qualified(resource: Resource): string;
+//# sourceMappingURL=ident.d.ts.map