@kozou/ui-core 1.7.0

package/dist/adapter/postgrest.js

@@ -0,0 +1,343 @@
+// PostgrestDataAdapter — DataAdapter implementation that speaks PostgREST 12+.
+//
+// Sub-step 6-D ships list() + get() + the shared request plumbing.
+// Sub-step 6-E ships create() / update() / delete() / searchRelation().
+//
+// License-check note: this file is whitelisted in
+// .github/workflows/license-check.yml so the class names below
+// (PostgrestDataAdapter, PostgrestAdapterError, PostgrestAdapterOptions)
+// do not trip the metadata-integrity grep. The file mentions PostgREST
+// by name *only* to interoperate with the PostgREST HTTP surface; no
+// PostgREST source code is bundled here.
+import { AdapterError } from './errors.js';
+const DEFAULT_PAGE_SIZE = 50;
+const DEFAULT_SCHEMA = 'public';
+const DEFAULT_PRIMARY_KEY = 'id';
+const DEFAULT_RELATION_LIMIT = 20;
+const OR_FILTER_KEY = '__or';
+// The horizontal filter operators the in-house API list endpoint accepts.
+// The REST surface this adapter targets shares the
+// same `col=op.value` grammar natively, so an already-prefixed filter value
+// is forwarded verbatim; a bare value defaults to equality for backward
+// compatibility. Detection uses indexOf, not a regex (ReDoS-safe).
+const FILTER_OPERATORS = new Set([
+    'eq',
+    'neq',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'like',
+    'ilike',
+    'in',
+    'is',
+]);
+export class PostgrestAdapterError extends AdapterError {
+    constructor(init) {
+        super(init);
+        this.name = 'PostgrestAdapterError';
+    }
+}
+export class PostgrestDataAdapter {
+    baseUrl;
+    defaultSchema;
+    resolvePrimaryKey;
+    staticHeaders;
+    fetchImpl;
+    defaultPageSize;
+    constructor(opts) {
+        if (typeof opts.baseUrl !== 'string' || opts.baseUrl.length === 0) {
+            throw adapterConfigError('PostgrestDataAdapter: `baseUrl` is required.');
+        }
+        this.baseUrl = stripTrailingSlash(opts.baseUrl);
+        this.defaultSchema = opts.defaultSchema ?? DEFAULT_SCHEMA;
+        this.resolvePrimaryKey = makePrimaryKeyResolver(opts.primaryKey);
+        this.staticHeaders = { ...(opts.headers ?? {}) };
+        this.defaultPageSize = opts.defaultPageSize ?? DEFAULT_PAGE_SIZE;
+        const resolvedFetch = opts.fetch ?? globalThis.fetch;
+        if (typeof resolvedFetch !== 'function') {
+            throw adapterConfigError('PostgrestDataAdapter: a `fetch` implementation is required (none injected, none on globalThis).');
+        }
+        this.fetchImpl = resolvedFetch;
+    }
+    async list(resource, params) {
+        const { schema, table } = splitResource(resource, this.defaultSchema);
+        const pageSize = params.pageSize ?? this.defaultPageSize;
+        const page = params.page ?? 1;
+        const offset = (page - 1) * pageSize;
+        const query = new URLSearchParams();
+        appendFilters(query, params.filters);
+        appendOrder(query, params.sort);
+        query.set('limit', String(pageSize));
+        query.set('offset', String(offset));
+        const url = `${this.baseUrl}/${encodeURIComponent(table)}?${query.toString()}`;
+        const headers = {
+            ...this.staticHeaders,
+            Accept: 'application/json',
+            Prefer: 'count=exact',
+        };
+        addProfileHeader(headers, schema, this.defaultSchema, 'read');
+        const response = await this.send('GET', url, headers, undefined);
+        await assertOk(response, url);
+        const rows = (await readJson(response, url));
+        const total = parseContentRangeTotal(response.headers.get('content-range'), rows.length);
+        return { rows, total, page, pageSize };
+    }
+    async get(resource, id) {
+        const { schema, table } = splitResource(resource, this.defaultSchema);
+        const query = new URLSearchParams();
+        this.appendKeyEquals(query, resource, id);
+        query.set('limit', '1');
+        const url = `${this.baseUrl}/${encodeURIComponent(table)}?${query.toString()}`;
+        const headers = {
+            ...this.staticHeaders,
+            Accept: 'application/vnd.pgrst.object+json',
+        };
+        addProfileHeader(headers, schema, this.defaultSchema, 'read');
+        const response = await this.send('GET', url, headers, undefined);
+        await assertOk(response, url);
+        return (await readJson(response, url));
+    }
+    async create(resource, data) {
+        const { schema, table } = splitResource(resource, this.defaultSchema);
+        const url = `${this.baseUrl}/${encodeURIComponent(table)}`;
+        const headers = this.mutationHeaders(schema);
+        const response = await this.send('POST', url, headers, JSON.stringify(data));
+        await assertOk(response, url);
+        return (await readJson(response, url));
+    }
+    async update(resource, id, data) {
+        const { schema, table } = splitResource(resource, this.defaultSchema);
+        const query = new URLSearchParams();
+        this.appendKeyEquals(query, resource, id);
+        const url = `${this.baseUrl}/${encodeURIComponent(table)}?${query.toString()}`;
+        const headers = this.mutationHeaders(schema);
+        const response = await this.send('PATCH', url, headers, JSON.stringify(data));
+        await assertOk(response, url);
+        return (await readJson(response, url));
+    }
+    async delete(resource, id) {
+        const { schema, table } = splitResource(resource, this.defaultSchema);
+        const query = new URLSearchParams();
+        this.appendKeyEquals(query, resource, id);
+        const url = `${this.baseUrl}/${encodeURIComponent(table)}?${query.toString()}`;
+        const headers = { ...this.staticHeaders };
+        addProfileHeader(headers, schema, this.defaultSchema, 'write');
+        const response = await this.send('DELETE', url, headers, undefined);
+        await assertOk(response, url);
+    }
+    async searchRelation(resource, params) {
+        const { schema, table } = splitResource(resource, this.defaultSchema);
+        // The option id is the target's key: a scalar for a single-column key, an
+        // array of components — in key declaration order — for a composite key,
+        // so an option id is always a valid item id for the target.
+        const primaryKey = keyColumns(this.resolvePrimaryKey(resource));
+        const limit = params.limit ?? DEFAULT_RELATION_LIMIT;
+        const query = new URLSearchParams();
+        const selectFields = primaryKey.includes(params.labelField)
+            ? primaryKey
+            : [...primaryKey, params.labelField];
+        query.set('select', selectFields.join(','));
+        if (params.query.length > 0 && params.searchFields.length > 0) {
+            const orExpr = params.searchFields
+                .map((field) => `${field}.ilike.*${params.query}*`)
+                .join(',');
+            query.set('or', `(${orExpr})`);
+        }
+        query.set('limit', String(limit));
+        const url = `${this.baseUrl}/${encodeURIComponent(table)}?${query.toString()}`;
+        const headers = {
+            ...this.staticHeaders,
+            Accept: 'application/json',
+        };
+        addProfileHeader(headers, schema, this.defaultSchema, 'read');
+        const response = await this.send('GET', url, headers, undefined);
+        await assertOk(response, url);
+        const rows = (await readJson(response, url));
+        return rows.map((row) => ({
+            id: primaryKey.length === 1
+                ? row[primaryKey[0]]
+                : primaryKey.map((column) => row[column]),
+            label: String(row[params.labelField] ?? ''),
+        }));
+    }
+    /**
+     * Append the per-column equality filters that address a row by id. A
+     * composite key expands to `?col0=eq.v0&col1=eq.v1` in `primaryKey`
+     * declaration order; a single-column key keeps
+     * the `?col=eq.value` form. The id component count must match the key
+     * arity (else a config error, surfacing a wiring mismatch).
+     */
+    appendKeyEquals(query, resource, id) {
+        const columns = keyColumns(this.resolvePrimaryKey(resource));
+        const values = asResourceIdArray(id);
+        if (columns.length !== values.length) {
+            throw adapterConfigError(`PostgrestDataAdapter: resource "${resource}" has a ${columns.length}-column ` +
+                `primary key (${columns.join(', ')}) but ${values.length} id ` +
+                `component(s) were supplied.`);
+        }
+        columns.forEach((column, i) => {
+            query.set(column, `eq.${serializeFilterValue(values[i])}`);
+        });
+    }
+    mutationHeaders(schema) {
+        const headers = {
+            ...this.staticHeaders,
+            Accept: 'application/vnd.pgrst.object+json',
+            'Content-Type': 'application/json',
+            Prefer: 'return=representation',
+        };
+        addProfileHeader(headers, schema, this.defaultSchema, 'write');
+        return headers;
+    }
+    async send(method, url, headers, body) {
+        try {
+            return await this.fetchImpl(url, { method, headers, body });
+        }
+        catch (cause) {
+            throw new PostgrestAdapterError({
+                message: `PostgrestDataAdapter: ${method} ${url} failed before reaching the server: ${cause.message}`,
+                status: 0,
+                url,
+                responseBody: null,
+                code: 'network',
+            });
+        }
+    }
+}
+function stripTrailingSlash(url) {
+    return url.endsWith('/') ? url.slice(0, -1) : url;
+}
+function makePrimaryKeyResolver(pk) {
+    if (pk === undefined)
+        return () => DEFAULT_PRIMARY_KEY;
+    if (typeof pk === 'function')
+        return pk;
+    return () => pk;
+}
+/** Normalize a resolver result to the ordered list of key columns. An empty
+ *  list is rejected loudly: a key-less resource cannot be addressed by id —
+ *  silently accepting it would, e.g., let a zero-column key match a
+ *  zero-component id and emit an unfiltered (table-wide) mutation. */
+function keyColumns(pk) {
+    const columns = Array.isArray(pk) ? pk : [pk];
+    if (columns.length === 0) {
+        throw adapterConfigError('PostgrestDataAdapter: the primaryKey resolver returned no key columns.');
+    }
+    return columns;
+}
+/** Normalize a ResourceId to the ordered list of key values. */
+function asResourceIdArray(id) {
+    return Array.isArray(id) ? id : [id];
+}
+function splitResource(resource, defaultSchema) {
+    const idx = resource.indexOf('.');
+    if (idx === -1) {
+        return { schema: defaultSchema, table: resource };
+    }
+    return {
+        schema: resource.slice(0, idx),
+        table: resource.slice(idx + 1),
+    };
+}
+function appendFilters(query, filters) {
+    if (!filters)
+        return;
+    for (const [key, value] of Object.entries(filters)) {
+        if (value === undefined)
+            continue;
+        if (key === OR_FILTER_KEY) {
+            query.set('or', `(${serializeOrExpression(value)})`);
+            continue;
+        }
+        // A value already carrying a known operator prefix (`gt.5`, `in.(a,b)`,
+        // `is.null`, ...) is the REST surface's native grammar, so it is
+        // forwarded verbatim; a bare value defaults to equality (kept consistent
+        // with the in-house API adapter).
+        if (typeof value === 'string' && hasOperatorPrefix(value)) {
+            query.set(key, value);
+            continue;
+        }
+        query.set(key, `eq.${serializeFilterValue(value)}`);
+    }
+}
+/** Whether a filter value begins with a `<op>.` prefix from the known
+ *  operator set. Split on the first `.` via indexOf (no regex, ReDoS-safe). */
+function hasOperatorPrefix(value) {
+    const dot = value.indexOf('.');
+    return dot > 0 && FILTER_OPERATORS.has(value.slice(0, dot));
+}
+function serializeOrExpression(value) {
+    if (typeof value === 'string')
+        return value;
+    if (Array.isArray(value))
+        return value.map(String).join(',');
+    return String(value);
+}
+function serializeFilterValue(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'string')
+        return value;
+    return String(value);
+}
+function appendOrder(query, sort) {
+    if (!sort || sort.length === 0)
+        return;
+    query.set('order', sort.map((s) => `${s.field}.${s.order}`).join(','));
+}
+function addProfileHeader(headers, schema, defaultSchema, direction) {
+    if (schema === defaultSchema)
+        return;
+    headers[direction === 'read' ? 'Accept-Profile' : 'Content-Profile'] = schema;
+}
+function parseContentRangeTotal(header, fallback) {
+    if (!header)
+        return fallback;
+    const match = header.match(/\/(\d+)$/);
+    if (!match)
+        return fallback;
+    return Number(match[1]);
+}
+async function readJson(response, url) {
+    try {
+        return await response.json();
+    }
+    catch (cause) {
+        throw new PostgrestAdapterError({
+            message: `PostgrestDataAdapter: failed to parse JSON response from ${url}: ${cause.message}`,
+            status: response.status,
+            url,
+            responseBody: null,
+            code: 'parse',
+        });
+    }
+}
+async function assertOk(response, url) {
+    if (response.ok)
+        return;
+    let body = null;
+    try {
+        body = await response.text();
+    }
+    catch {
+        body = null;
+    }
+    throw new PostgrestAdapterError({
+        message: `PostgrestDataAdapter: request to ${url} failed with status ${response.status}`,
+        status: response.status,
+        url,
+        responseBody: body,
+        code: 'http',
+    });
+}
+function adapterConfigError(message) {
+    return new PostgrestAdapterError({
+        message,
+        status: 0,
+        url: '',
+        responseBody: null,
+        code: 'config',
+    });
+}
+//# sourceMappingURL=postgrest.js.map

package/dist/adapter/postgrest.js.map

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

package/dist/adapter/types.d.ts

@@ -0,0 +1,6 @@
+export type FetchLike = (input: string, init?: {
+    method?: string;
+    headers?: Record<string, string>;
+    body?: string;
+}) => Promise<Response>;
+//# sourceMappingURL=types.d.ts.map

package/dist/adapter/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/adapter/types.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,CACtB,KAAK,EAAE,MAAM,EACb,IAAI,CAAC,EAAE;IACL,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,KACE,OAAO,CAAC,QAAQ,CAAC,CAAC"}

package/dist/adapter/types.js

@@ -0,0 +1,3 @@
+// Common types shared across all DataAdapter implementations.
+export {};
+//# sourceMappingURL=types.js.map

package/dist/adapter/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/adapter/types.ts"],"names":[],"mappings":"AAAA,8DAA8D"}

package/dist/detail/format-cell.d.ts

@@ -0,0 +1,7 @@
+import type { WidgetType } from '@kozou/core';
+export interface FormatCellInput {
+    value: unknown;
+    widget: WidgetType;
+}
+export declare function formatCellValue(input: FormatCellInput): string;
+//# sourceMappingURL=format-cell.d.ts.map

package/dist/detail/format-cell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-cell.d.ts","sourceRoot":"","sources":["../../src/detail/format-cell.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CA8B9D"}

package/dist/detail/format-cell.js

@@ -0,0 +1,50 @@
+// Format a single cell value for the detail / list views.
+// Picks the formatter from the column's WidgetType so booleans
+// render as Yes/No, dates as YYYY-MM-DD, JSON as pretty-printed
+// text, and unknown widgets fall back to String(value).
+export function formatCellValue(input) {
+    const { value, widget } = input;
+    if (value === null || value === undefined)
+        return '';
+    switch (widget) {
+        case 'boolean':
+            return value ? 'Yes' : 'No';
+        case 'date':
+            return formatDate(value);
+        case 'datetime':
+            return formatDateTime(value);
+        case 'json':
+            if (typeof value === 'object') {
+                try {
+                    return JSON.stringify(value, null, 2);
+                }
+                catch {
+                    return String(value);
+                }
+            }
+            return String(value);
+        default:
+            if (typeof value === 'object') {
+                try {
+                    return JSON.stringify(value);
+                }
+                catch {
+                    return String(value);
+                }
+            }
+            return String(value);
+    }
+}
+function formatDate(value) {
+    const d = new Date(value);
+    if (Number.isNaN(d.getTime()))
+        return String(value);
+    return d.toISOString().slice(0, 10);
+}
+function formatDateTime(value) {
+    const d = new Date(value);
+    if (Number.isNaN(d.getTime()))
+        return String(value);
+    return d.toISOString().replace('T', ' ').slice(0, 19);
+}
+//# sourceMappingURL=format-cell.js.map

package/dist/detail/format-cell.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format-cell.js","sourceRoot":"","sources":["../../src/detail/format-cell.ts"],"names":[],"mappings":"AAAA,0DAA0D;AAC1D,+DAA+D;AAC/D,gEAAgE;AAChE,wDAAwD;AASxD,MAAM,UAAU,eAAe,CAAC,KAAsB;IACpD,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,KAAK,CAAC;IAChC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAErD,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC9B,KAAK,MAAM;YACT,OAAO,UAAU,CAAC,KAAK,CAAC,CAAC;QAC3B,KAAK,UAAU;YACb,OAAO,cAAc,CAAC,KAAK,CAAC,CAAC;QAC/B,KAAK,MAAM;YACT,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxC,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;QACvB;YACE,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,IAAI,CAAC;oBACH,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;gBAC/B,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;YACD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAA+B,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,CAAC,GAAG,IAAI,IAAI,CAAC,KAA+B,CAAC,CAAC;IACpD,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC"}

package/dist/detail/resolve-fk-labels.d.ts

@@ -0,0 +1,23 @@
+import type { SchemaContext, TableContext } from '@kozou/core';
+import type { FkRowLoader } from '../server/fk-row-cache.js';
+export interface ResolvedFkLabel {
+    /** Raw FK value as stored on the source row (typically a UUID
+     *  string but can be a numeric surrogate key). For a composite
+     *  relation, the encoded id segment (each component
+     *  percent-encoded, comma-joined) — ready for the detail link. */
+    value: string | number;
+    /** Label projected from `referencedTable.displayField`, or `null`
+     *  when the target row / displayField is missing. */
+    label: string | null;
+    /** `schema.table` of the referenced row, kept on the result so the
+     *  template can build a future link without re-deriving it. */
+    referencedQualifiedName: string;
+}
+export interface ResolveFkLabelsArgs {
+    table: TableContext;
+    row: Record<string, unknown>;
+    schema: SchemaContext;
+    loadRow: FkRowLoader;
+}
+export declare function resolveFkLabels(args: ResolveFkLabelsArgs): Promise<Record<string, ResolvedFkLabel>>;
+//# sourceMappingURL=resolve-fk-labels.d.ts.map

package/dist/detail/resolve-fk-labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-fk-labels.d.ts","sourceRoot":"","sources":["../../src/detail/resolve-fk-labels.ts"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAmB,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B;;;sEAGkE;IAClE,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB;yDACqD;IACrD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB;mEAC+D;IAC/D,uBAAuB,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,YAAY,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC7B,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,CAiD1C"}

package/dist/detail/resolve-fk-labels.js

@@ -0,0 +1,118 @@
+// Resolve foreign-key columns on a detail row to the referenced
+// row's displayField label.
+//
+// Pure function (modulo the injected `loadRow`) so the unit test can
+// drive every branch without spinning up a DataAdapter. The detail
+// route loader wires `loadRow` to a FkRowCache-backed call into the
+// real DataAdapter. Tracks FK label resolution.
+//
+// Behaviour:
+// - Skip FK columns whose row value is `null` / `undefined`.
+// - Look up the referenced table inside the SchemaContext. If it is
+//   absent (orphaned FK, schema drift) emit an entry with `label: null`
+//   so the template can fall back to the raw value.
+// - If the referenced table has no `displayField` heuristic, or the
+//   loaded row does not carry that field, emit `label: null` similarly.
+// - A composite (multi-column) relation resolves through the target's
+//   primary key: its entry is keyed by the relation's first column and
+//   carries the encoded composite id as `value` (the detail-link
+//   segment). It is skipped — raw values render as-is — when the
+//   relation does not cover the target's full primary key (the row
+//   cannot be addressed by id then), when any component is missing,
+//   or when another relation claims the same first column (resolving
+//   both would race on the shared key).
+// - Issue every lookup in parallel via `Promise.all`. The cache layer
+//   is responsible for dedupe of repeat keys within a render.
+import { encodeResourceId } from '../resource-id.js';
+export async function resolveFkLabels(args) {
+    const { table, row, schema, loadRow } = args;
+    const out = {};
+    const lookups = [];
+    // Resolved labels are keyed by column name. Two relations can claim the
+    // same column — e.g. composite keys sharing a leading tenant_id, or a
+    // column that is both a single FK and a composite component — and the
+    // parallel lookups would then overwrite each other nondeterministically.
+    // A composite relation therefore only resolves when its first column is
+    // claimed by no other relation; the single-column behaviour is unchanged.
+    const claims = new Map();
+    for (const relation of table.relations) {
+        const first = (relation.fields ?? [relation.field])[0];
+        claims.set(first, (claims.get(first) ?? 0) + 1);
+    }
+    for (const relation of table.relations) {
+        const fields = relation.fields ?? [relation.field];
+        if (fields.length > 1) {
+            if ((claims.get(fields[0]) ?? 0) > 1)
+                continue;
+            const lookup = compositeLookup(fields, relation, row, schema, loadRow, out);
+            if (lookup !== null)
+                lookups.push(lookup);
+            continue;
+        }
+        const rawValue = row[relation.field];
+        if (rawValue === null || rawValue === undefined)
+            continue;
+        if (typeof rawValue !== 'string' && typeof rawValue !== 'number')
+            continue;
+        const value = rawValue;
+        const referencedQualifiedName = `${relation.references.schema}.${relation.references.table}`;
+        const referencedTable = schema.tables.find((t) => t.qualifiedName === referencedQualifiedName);
+        if (referencedTable === undefined) {
+            out[relation.field] = { value, label: null, referencedQualifiedName };
+            continue;
+        }
+        lookups.push(loadRow(referencedQualifiedName, value).then((targetRow) => {
+            const label = projectLabel(referencedTable, targetRow);
+            out[relation.field] = { value, label, referencedQualifiedName };
+        }));
+    }
+    await Promise.all(lookups);
+    return out;
+}
+/** Build the lookup for a composite relation, or return `null` when it
+ *  cannot be resolved (the raw values then render as-is). The target row is
+ *  fetched by primary key, so the relation must reference the target's full
+ *  primary key (in any column order) and every component must be present.
+ *  The resolved entry is keyed by the relation's first column. */
+function compositeLookup(fields, relation, row, schema, loadRow, out) {
+    const referencedQualifiedName = `${relation.references.schema}.${relation.references.table}`;
+    const referencedTable = schema.tables.find((t) => t.qualifiedName === referencedQualifiedName);
+    if (referencedTable === undefined)
+        return null;
+    const refColumns = relation.references.columns ?? [relation.references.column];
+    if (refColumns.length !== fields.length)
+        return null;
+    const primaryKey = referencedTable.primaryKey;
+    if (primaryKey.length !== refColumns.length ||
+        !primaryKey.every((column) => refColumns.includes(column))) {
+        return null;
+    }
+    // Assemble the item id in the target's primary-key declaration order; the
+    // referencing columns may list the key in a different order.
+    const components = [];
+    for (const keyColumn of primaryKey) {
+        const raw = row[fields[refColumns.indexOf(keyColumn)]];
+        if (raw === null || raw === undefined)
+            return null;
+        if (typeof raw !== 'string' && typeof raw !== 'number')
+            return null;
+        components.push(raw);
+    }
+    const value = encodeResourceId(components);
+    return loadRow(referencedQualifiedName, components).then((targetRow) => {
+        const label = projectLabel(referencedTable, targetRow);
+        out[fields[0]] = { value, label, referencedQualifiedName };
+    });
+}
+function projectLabel(referencedTable, targetRow) {
+    if (targetRow === null)
+        return null;
+    const display = referencedTable.displayField;
+    if (display === null)
+        return null;
+    const value = targetRow[display];
+    if (value === null || value === undefined)
+        return null;
+    return String(value);
+}
+//# sourceMappingURL=resolve-fk-labels.js.map

package/dist/detail/resolve-fk-labels.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export type { FetchLike, AdapterErrorCode, AdapterErrorInit, PostgrestAdapterOptions, PostgrestPrimaryKeyResolver, KozouApiAdapterOptions, } from './adapter/index.js';
+export { AdapterError, PostgrestAdapterError, PostgrestDataAdapter, KozouApiAdapterError, KozouApiDataAdapter, } from './adapter/index.js';
+export { rowIdSegment, encodeResourceId, parseResourceId, } from './resource-id.js';
+export { DEFAULT_PAGE_SIZE, parseListParamsFromUrl, } from './query/list-params.js';
+export type { ParseListParamsInput, ParsedListParams, } from './query/list-params.js';
+export { buildHref, buildSortHref, formatCell } from './list/list-href.js';
+export type { ListViewParams } from './list/list-href.js';
+export { pickViewDisplayColumns, pickViewSearchFields, } from './view/columns.js';
+export { formatCellValue } from './detail/format-cell.js';
+export type { FormatCellInput } from './detail/format-cell.js';
+export { resolveFkLabels } from './detail/resolve-fk-labels.js';
+export type { ResolvedFkLabel, ResolveFkLabelsArgs, } from './detail/resolve-fk-labels.js';
+export { SchemaCache } from './server/schema-cache.js';
+export type { SchemaLoader, Clock, SchemaCacheOptions, } from './server/schema-cache.js';
+export { FkRowCache } from './server/fk-row-cache.js';
+export type { FkRowCacheOptions, FkRowLoader, } from './server/fk-row-cache.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":"AAcA,YAAY,EACV,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC3E,YAAY,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1D,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,YAAY,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,+BAA+B,CAAC;AAGvC,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EACV,YAAY,EACZ,KAAK,EACL,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,YAAY,EACV,iBAAiB,EACjB,WAAW,GACZ,MAAM,0BAA0B,CAAC"}