@kozou/api 0.0.1 → 1.0.0

package/dist/ident.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ident.d.ts","sourceRoot":"","sources":["../src/ident.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEnD;kBACkB;AAClB,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,iDAAiD;AACjD,wBAAgB,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAEpD"}

package/dist/ident.js

@@ -0,0 +1,12 @@
+// Identifier quoting + qualified table names. Shared by the query builder
+// and the embed fragment renderer so both quote identifiers identically.
+/** Quote an identifier for safe inlining (defense in depth on top of the
+ *  allowlist). */
+export function quoteIdent(id) {
+    return '"' + id.replace(/"/g, '""') + '"';
+}
+/** `"schema"."name"` for a resolved resource. */
+export function qualified(resource) {
+    return `${quoteIdent(resource.schema)}.${quoteIdent(resource.name)}`;
+}
+//# sourceMappingURL=ident.js.map

package/dist/ident.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ident.js","sourceRoot":"","sources":["../src/ident.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,yEAAyE;AAIzE;kBACkB;AAClB,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC;AAC5C,CAAC;AAED,iDAAiD;AACjD,MAAM,UAAU,SAAS,CAAC,QAAkB;IAC1C,OAAO,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;AACvE,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { startApiServer, createApiRequestListener, isLoopbackHost, type StartApiServerOptions, type ApiServerHandle, type PoolClient, type ConnectionPool, } from './startApiServer.js';
+export { createAuthenticator, signServiceToken, type AuthConfig, type AuthContext, type Authenticator, type JwtAlgorithm, type ServiceTokenOptions, } from './auth.js';
+export { handleApiRequest, parseListParams, type Queryable, type ApiHandlerDeps, type ApiHttpRequest, type ApiHttpResult, } from './handler.js';
+export { buildResourceLookup, type Resource, type ResourceKind, type ResourceLookup, type ReverseRelation, } from './schema-lookup.js';
+export { buildListQuery, buildGetQuery, buildInsertQuery, buildUpdateQuery, buildDeleteQuery, buildRelationOptionsQuery, quoteIdent, DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE, DEFAULT_RELATION_LIMIT, MAX_RELATION_LIMIT, type ListQueryParams, type BuiltListQuery, type BuiltGetQuery, type BuiltMutation, type RelationOptionsParams, type BuiltRelationOptions, type SortDirection, type Filter, type FilterOperator, type ScalarFilterOperator, type IsKeyword, } from './query-builder.js';
+export { buildOpenApiDocument, type OpenApiOptions } from './openapi.js';
+export { parseEmbedParam, resolveEmbedSpec, buildEmbedSelectFragment, MAX_EMBED_DEPTH, MAX_EMBED_RELATIONS, MAX_EMBED_CHILDREN, type EmbedKind, type EmbedNode, type EmbedSpec, } from './embed.js';
+export { KozouApiError, type ApiErrorBody } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,mBAAmB,GACzB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,KAAK,SAAS,EACd,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,EACnB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,eAAe,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,MAAM,EACX,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,SAAS,GACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAEzE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,SAAS,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// @kozou/api: Kozou's own REST layer — the default `kozou dev` data backend.
+// Serves the tables and views of a SchemaContext as a REST API. Its wire
+// format and OpenAPI are a stable contract as of Kozou v1.0; see the README
+// for the supported surface and the scope table.
+export { startApiServer, createApiRequestListener, isLoopbackHost, } from './startApiServer.js';
+export { createAuthenticator, signServiceToken, } from './auth.js';
+export { handleApiRequest, parseListParams, } from './handler.js';
+export { buildResourceLookup, } from './schema-lookup.js';
+export { buildListQuery, buildGetQuery, buildInsertQuery, buildUpdateQuery, buildDeleteQuery, buildRelationOptionsQuery, quoteIdent, DEFAULT_PAGE_SIZE, MAX_PAGE_SIZE, DEFAULT_RELATION_LIMIT, MAX_RELATION_LIMIT, } from './query-builder.js';
+export { buildOpenApiDocument } from './openapi.js';
+export { parseEmbedParam, resolveEmbedSpec, buildEmbedSelectFragment, MAX_EMBED_DEPTH, MAX_EMBED_RELATIONS, MAX_EMBED_CHILDREN, } from './embed.js';
+export { KozouApiError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,yEAAyE;AACzE,4EAA4E;AAC5E,iDAAiD;AAEjD,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,cAAc,GAKf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,GAMjB,MAAM,WAAW,CAAC;AAEnB,OAAO,EACL,gBAAgB,EAChB,eAAe,GAKhB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,mBAAmB,GAKpB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,yBAAyB,EACzB,UAAU,EACV,iBAAiB,EACjB,aAAa,EACb,sBAAsB,EACtB,kBAAkB,GAYnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAuB,MAAM,cAAc,CAAC;AAEzE,OAAO,EACL,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,GAInB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,aAAa,EAAqB,MAAM,aAAa,CAAC"}

package/dist/openapi.d.ts

@@ -0,0 +1,9 @@
+import type { SchemaContext } from '@kozou/core';
+export type OpenApiOptions = {
+    title?: string;
+    version?: string;
+};
+type JsonObject = Record<string, unknown>;
+export declare function buildOpenApiDocument(schema: SchemaContext, opts?: OpenApiOptions): JsonObject;
+export {};
+//# sourceMappingURL=openapi.d.ts.map

package/dist/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../src/openapi.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,aAAa,EAMd,MAAM,aAAa,CAAC;AAGrB,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAK1C,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EACrB,IAAI,GAAE,cAAmB,GACxB,UAAU,CAuDZ"}

package/dist/openapi.js

@@ -0,0 +1,300 @@
+// OpenAPI 3.1 document generation from a SchemaContext (Kozou v0.2 spec
+// §3.2). The differentiator over a generic auto-API is that COMMENT-derived
+// metadata is baked into the document: table/view/column descriptions, the
+// `@ai:` notes (as `x-kozou-ai`), `@policy:` rules (as `x-kozou-policy`),
+// CHECK / ENUM members (as `enum`), and the resolved widget (as
+// `x-kozou-widget`).
+//
+// `@policy:` rules are advisory metadata for AI agents and clients; they are
+// not enforced here. Hard access control is the schema author's Postgres
+// row-level security (see auth.ts).
+//
+// Pure function — no I/O. The server builds the document once at start and
+// serves it at `GET /openapi.json`.
+import { RESERVED_PARAMS } from './handler.js';
+export function buildOpenApiDocument(schema, opts = {}) {
+    const resources = [
+        ...schema.tables.map((t) => ({ resource: t, writable: true })),
+        ...schema.views.map((v) => ({ resource: v, writable: false })),
+    ];
+    // Use the bare name as the URL segment when it is unique across schemas,
+    // otherwise the qualified name — mirroring the request resolver.
+    const nameCounts = new Map();
+    for (const { resource } of resources) {
+        nameCounts.set(resource.name, (nameCounts.get(resource.name) ?? 0) + 1);
+    }
+    const segmentFor = (r) => nameCounts.get(r.name) === 1 ? r.name : r.qualifiedName;
+    const knownQNames = new Set(resources.map(({ resource }) => resource.qualifiedName));
+    // Reverse index for one-to-many embed hints: parent qualifiedName -> children.
+    const reverseByParent = new Map();
+    for (const t of schema.tables) {
+        for (const rel of t.relations ?? []) {
+            const parentQN = `${rel.references.schema}.${rel.references.table}`;
+            const entry = { childName: t.name, childQN: t.qualifiedName, field: rel.field };
+            const list = reverseByParent.get(parentQN);
+            if (list)
+                list.push(entry);
+            else
+                reverseByParent.set(parentQN, [entry]);
+        }
+    }
+    const paths = {};
+    const schemas = {};
+    for (const { resource, writable } of resources) {
+        const ref = `#/components/schemas/${resource.qualifiedName}`;
+        const relations = 'relations' in resource ? resource.relations : [];
+        const reverse = reverseByParent.get(resource.qualifiedName) ?? [];
+        const embeds = embedHints(relations, reverse, knownQNames);
+        schemas[resource.qualifiedName] = resourceSchema(resource, embeds);
+        Object.assign(paths, resourcePaths(resource, segmentFor(resource), ref, writable, embeds.length > 0));
+    }
+    return {
+        openapi: '3.1.0',
+        info: {
+            title: opts.title ?? 'Kozou API',
+            version: opts.version ?? '0.0.0',
+            description: 'REST API generated by Kozou from PostgreSQL DDL + COMMENT. Descriptions, enums, and AI notes below are sourced from the database COMMENTs.',
+        },
+        paths,
+        components: { schemas },
+    };
+}
+function resourceSchema(resource, embeds) {
+    const properties = {};
+    const required = [];
+    for (const column of resource.columns) {
+        properties[column.name] = columnSchema(column);
+        if (!column.nullable)
+            required.push(column.name);
+    }
+    const schema = { type: 'object', properties };
+    if (resource.description)
+        schema.description = resource.description;
+    if (resource.aiDescription)
+        schema['x-kozou-ai'] = resource.aiDescription;
+    if (resource.policy && resource.policy.length > 0)
+        schema['x-kozou-policy'] = resource.policy;
+    if (required.length > 0)
+        schema.required = required;
+    // Embeddable relations (forward to-one + reverse to-many, only targets that
+    // are themselves exposed resources), as a hint for clients building
+    // `?embed=`. Computed once by the caller and shared with the path builder so
+    // the `embed` query parameter is only advertised where it is usable.
+    if (embeds.length > 0)
+        schema['x-kozou-embeds'] = embeds;
+    return schema;
+}
+function embedHints(forward, reverse, knownQNames) {
+    const hints = [];
+    for (const r of forward) {
+        const qn = `${r.references.schema}.${r.references.table}`;
+        if (!knownQNames.has(qn))
+            continue;
+        hints.push({
+            field: r.field,
+            key: r.references.table,
+            target: `#/components/schemas/${qn}`,
+            cardinality: 'to-one',
+        });
+    }
+    for (const e of reverse) {
+        if (!knownQNames.has(e.childQN))
+            continue;
+        hints.push({
+            field: e.field,
+            key: e.childName,
+            target: `#/components/schemas/${e.childQN}`,
+            cardinality: 'to-many',
+        });
+    }
+    return hints;
+}
+function columnSchema(column) {
+    const base = widgetType(column.widget);
+    const schema = { ...base };
+    if (column.nullable && typeof schema.type === 'string') {
+        schema.type = [schema.type, 'null'];
+    }
+    if (column.enumValues && column.enumValues.length > 0) {
+        schema.enum = column.nullable ? [...column.enumValues, null] : [...column.enumValues];
+    }
+    if (column.description)
+        schema.description = column.description;
+    if (column.aiDescription)
+        schema['x-kozou-ai'] = column.aiDescription;
+    if (column.policy && column.policy.length > 0)
+        schema['x-kozou-policy'] = column.policy;
+    schema['x-kozou-widget'] = column.widget;
+    return schema;
+}
+function widgetType(widget) {
+    switch (widget) {
+        case 'number':
+        case 'currency':
+            return { type: 'number' };
+        case 'boolean':
+            return { type: 'boolean' };
+        case 'date':
+            return { type: 'string', format: 'date' };
+        case 'datetime':
+            return { type: 'string', format: 'date-time' };
+        case 'uuid':
+            return { type: 'string', format: 'uuid' };
+        case 'image-url':
+            return { type: 'string', format: 'uri' };
+        case 'json':
+            return { type: 'object' };
+        case 'text':
+        case 'textarea':
+        case 'enum-select':
+        case 'relation-select':
+        default:
+            return { type: 'string' };
+    }
+}
+function resourcePaths(resource, segment, ref, writable, hasEmbeds) {
+    const rowRef = { $ref: ref };
+    const label = resource.label || resource.name;
+    // The `embed` parameter is only advertised where the resource has at least
+    // one embeddable relation; a non-empty `embed` on a relation-less resource
+    // (e.g. a view) is rejected with 400, so listing it would be misleading.
+    const embedParams = hasEmbeds ? [embedParam()] : [];
+    const collection = {
+        get: {
+            summary: `List ${label}`,
+            description: resource.description ?? undefined,
+            parameters: [...listParameters(), ...filterParameters(resource), ...embedParams],
+            responses: {
+                '200': jsonResponse(`A page of ${label}.`, listResultSchema(rowRef)),
+            },
+        },
+    };
+    if (writable) {
+        collection.post = {
+            summary: `Create a ${label} row`,
+            requestBody: jsonBody(rowRef),
+            responses: {
+                '201': jsonResponse('The created row.', rowRef),
+                '400': errorResponse('Validation error.'),
+            },
+        };
+    }
+    const paths = { [`/${segment}`]: collection };
+    // Item-by-id routes only exist for resources addressable by a primary key.
+    // Views and primary-key-less tables cannot be fetched/updated/deleted by id
+    // (the request handler rejects such reads with 400), so the document must
+    // not advertise an item path for them.
+    const primaryKey = 'primaryKey' in resource ? resource.primaryKey : [];
+    if (primaryKey.length >= 1) {
+        const idParam = itemIdParam(resource);
+        const item = {
+            get: {
+                summary: `Fetch a ${label} row by id`,
+                parameters: [idParam, ...embedParams],
+                responses: {
+                    '200': jsonResponse('The row.', rowRef),
+                    '404': errorResponse('No such row.'),
+                },
+            },
+        };
+        if (writable) {
+            item.patch = {
+                summary: `Update a ${label} row`,
+                parameters: [idParam],
+                requestBody: jsonBody(rowRef),
+                responses: {
+                    '200': jsonResponse('The updated row.', rowRef),
+                    '404': errorResponse('No such row.'),
+                },
+            };
+            item.delete = {
+                summary: `Delete a ${label} row`,
+                parameters: [idParam],
+                responses: {
+                    '200': jsonResponse('The deleted row.', rowRef),
+                    '404': errorResponse('No such row.'),
+                },
+            };
+        }
+        paths[`/${segment}/{id}`] = item;
+    }
+    return paths;
+}
+/** The `{id}` path parameter. Only called for a resource with a non-empty
+ *  primary key (the caller in `resourcePaths` guards on it). A composite
+ *  primary key is addressed by comma-joining its components — in `primaryKey`
+ *  declaration order — into the single `{id}` segment, each component
+ *  percent-encoded. */
+function itemIdParam(resource) {
+    const pk = 'primaryKey' in resource ? resource.primaryKey : [];
+    let description;
+    if (pk.length > 1) {
+        const cols = pk.map((c) => `\`${c}\``).join(', ');
+        description =
+            `Composite primary key: the components (${cols}) in this order, joined by an ` +
+                `unescaped comma in the single path segment. Percent-encode reserved characters ` +
+                `within a component; a component value cannot itself contain a comma (the segment ` +
+                `is split on commas after URL-decoding).`;
+    }
+    else {
+        description = `Primary key of the row (\`${pk[0]}\`).`;
+    }
+    return { name: 'id', in: 'path', required: true, schema: { type: 'string' }, description };
+}
+function listParameters() {
+    return [
+        queryParam('page', { type: 'integer', minimum: 1 }, '1-based page index.'),
+        queryParam('pageSize', { type: 'integer', minimum: 1 }, 'Rows per page.'),
+        queryParam('sort', { type: 'string' }, 'Comma-separated `field.asc` / `field.desc`.'),
+        queryParam('search', { type: 'string' }, 'Free-text ILIKE across text columns.'),
+    ];
+}
+/** Operators accepted by the `<column>=<op>.<value>` filter grammar. */
+const FILTER_OPERATORS_DOC = 'eq, neq, gt, gte, lt, lte, like, ilike, in, is';
+/** One query parameter per filterable column documenting the
+ *  `<column>=<op>.<value>` grammar. Control keys (page/sort/…) are skipped so
+ *  the doc never advertises them as filters. Multiple filters on one column
+ *  combine with AND (e.g. a `gte`/`lte` range). */
+function filterParameters(resource) {
+    return resource.columns
+        .filter((c) => !RESERVED_PARAMS.has(c.name))
+        .map((c) => queryParam(c.name, { type: 'string' }, `Filter on \`${c.name}\`: \`<op>.<value>\` where op is one of ${FILTER_OPERATORS_DOC} ` +
+        `(e.g. \`${c.name}=gte.10\`, \`${c.name}=in.(a,b)\`, \`${c.name}=is.null\`). ` +
+        `A bare value means \`eq\`. Repeat the key to AND several conditions.`));
+}
+function queryParam(name, schema, description) {
+    return { name, in: 'query', required: false, schema, description };
+}
+function embedParam() {
+    return queryParam('embed', { type: 'string' }, 'Comma-separated forward to-one relations to inline as nested objects; dot for depth (e.g. "author,editions.books.authors"). Each segment is a foreign-key column name or its referenced table name.');
+}
+function listResultSchema(rowRef) {
+    return {
+        type: 'object',
+        properties: {
+            rows: { type: 'array', items: rowRef },
+            total: { type: 'integer' },
+            page: { type: 'integer' },
+            pageSize: { type: 'integer' },
+        },
+        required: ['rows', 'total', 'page', 'pageSize'],
+    };
+}
+function jsonResponse(description, schema) {
+    return { description, content: { 'application/json': { schema } } };
+}
+function jsonBody(schema) {
+    return { required: true, content: { 'application/json': { schema } } };
+}
+function errorResponse(description) {
+    return jsonResponse(description, {
+        type: 'object',
+        properties: {
+            error: {
+                type: 'object',
+                properties: { code: { type: 'string' }, message: { type: 'string' } },
+            },
+        },
+    });
+}
+//# sourceMappingURL=openapi.js.map

package/dist/openapi.js.map

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

package/dist/query-builder.d.ts

@@ -0,0 +1,83 @@
+import { quoteIdent } from './ident.js';
+import { type EmbedNode } from './embed.js';
+import type { Resource } from './schema-lookup.js';
+export { quoteIdent };
+export declare const DEFAULT_PAGE_SIZE = 50;
+export declare const MAX_PAGE_SIZE = 200;
+export type SortDirection = 'asc' | 'desc';
+/** Horizontal filter operators for the `?<col>=<op>.<value>` query grammar. */
+export type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'like' | 'ilike' | 'in' | 'is';
+/** Comparison operators that bind a single value. */
+export type ScalarFilterOperator = Exclude<FilterOperator, 'in' | 'is'>;
+/** Allowed right-hand keywords for the `is` operator (never bound — a fixed
+ *  SQL `IS [NOT] NULL/TRUE/FALSE` clause). */
+export type IsKeyword = 'null' | 'notnull' | 'true' | 'false';
+/** A single horizontal filter. `column` must be a declared column of the
+ *  resource (enforced in {@link buildListQuery}). Multiple filters on the same
+ *  column are allowed and combine with AND (e.g. a `gte`/`lte` range). */
+export type Filter = {
+    column: string;
+    op: ScalarFilterOperator;
+    value: string;
+} | {
+    column: string;
+    op: 'in';
+    values: string[];
+} | {
+    column: string;
+    op: 'is';
+    keyword: IsKeyword;
+};
+export type ListQueryParams = {
+    page?: number;
+    pageSize?: number;
+    sort?: {
+        field: string;
+        order: SortDirection;
+    }[];
+    search?: string;
+    /** Horizontal filters. Each filter's column must be a declared column of
+     *  the resource; every supplied value is a bound parameter. */
+    filters?: Filter[];
+    /** Resolved forward to-one relations to inline as nested JSON objects. */
+    embed?: EmbedNode[];
+};
+export type BuiltListQuery = {
+    dataText: string;
+    dataValues: unknown[];
+    countText: string;
+    countValues: unknown[];
+    /** Effective (clamped) pagination echoed back in the response. */
+    page: number;
+    pageSize: number;
+};
+export type BuiltGetQuery = {
+    text: string;
+    values: unknown[];
+};
+export declare function buildListQuery(resource: Resource, params: ListQueryParams): BuiltListQuery;
+export declare function buildGetQuery(resource: Resource, id: string, embed?: EmbedNode[]): BuiltGetQuery;
+export type BuiltMutation = {
+    text: string;
+    values: unknown[];
+};
+export declare const DEFAULT_RELATION_LIMIT = 20;
+export declare const MAX_RELATION_LIMIT = 100;
+export type RelationOptionsParams = {
+    labelField: string;
+    searchFields: string[];
+    query?: string;
+    limit?: number;
+};
+export type BuiltRelationOptions = {
+    text: string;
+    values: unknown[];
+    primaryKey: string;
+    labelField: string;
+};
+export declare function buildInsertQuery(resource: Resource, data: Record<string, unknown>): BuiltMutation;
+export declare function buildUpdateQuery(resource: Resource, id: string, data: Record<string, unknown>): BuiltMutation;
+export declare function buildDeleteQuery(resource: Resource, id: string): BuiltMutation;
+/** Lightweight `{ id, label }` lookup used by relation-select widgets. */
+export declare function buildRelationOptionsQuery(resource: Resource, params: RelationOptionsParams): BuiltRelationOptions;
+//# sourceMappingURL=query-builder.d.ts.map

package/dist/query-builder.d.ts.map

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