@kozou/api 0.0.1 → 1.0.0

package/dist/query-builder.js

@@ -0,0 +1,592 @@
+// Pure SQL builders for the read path. No I/O — given a resolved Resource
+// and structured request params, produce parameterized SQL text + values.
+//
+// Safety contract:
+//   - Identifiers (table/column names) only ever come from the resolved
+//     Resource's own schema/name/columns, never raw request strings. Any
+//     filter/sort key that is not a declared column is rejected with a
+//     400 before it reaches the SQL text.
+//   - Every user-supplied value is a bound parameter ($1, $2, ...). No
+//     value is interpolated into the SQL string.
+import { badRequest } from './errors.js';
+import { quoteIdent, qualified } from './ident.js';
+import { buildEmbedSelectFragment } from './embed.js';
+export { quoteIdent };
+export const DEFAULT_PAGE_SIZE = 50;
+export const MAX_PAGE_SIZE = 200;
+const SCALAR_OP_SQL = {
+    eq: '=',
+    neq: '<>',
+    gt: '>',
+    gte: '>=',
+    lt: '<',
+    lte: '<=',
+    like: 'LIKE',
+    ilike: 'ILIKE',
+};
+const IS_KEYWORD_SQL = {
+    null: 'NULL',
+    notnull: 'NOT NULL',
+    true: 'TRUE',
+    false: 'FALSE',
+};
+/** Wildcard mapping for LIKE/ILIKE: a literal `*` in the pattern maps to SQL
+ *  `%`. Plain linear string replacement — no regular expression (avoids ReDoS,
+ *  per the CodeQL `js/polynomial-redos` precedent). */
+function toLikePattern(value) {
+    return value.split('*').join('%');
+}
+/** Reduce a `format_type`-style `dataType` to its base scalar type name, or
+ *  `null` when it is an array (`text[]`) — arrays are not scalar `LIKE` /
+ *  boolean targets. Lower-cases, drops a trailing length/precision modifier
+ *  (`character varying(255)` -> `character varying`), and trims. No regex
+ *  (linear scan), per the CodeQL `js/polynomial-redos` precedent. */
+function baseScalarType(dataType) {
+    const lower = dataType.trim().toLowerCase();
+    if (lower.includes('['))
+        return null; // any array spelling, e.g. text[]
+    const paren = lower.indexOf('(');
+    return (paren === -1 ? lower : lower.slice(0, paren)).trim();
+}
+/** Base scalar types that accept `LIKE` / `ILIKE`. Judged by the underlying
+ *  PostgreSQL type, not the widget — a `varchar` surfaced as an `enum-select`
+ *  still accepts `ilike` (Kozou v1.0 issue #76). Exact-match on the normalized
+ *  base type so array spellings (`text[]`) are excluded. */
+const TEXT_LIKE_BASE_TYPES = new Set([
+    'text',
+    'character varying',
+    'varchar',
+    'character',
+    'char',
+    'bpchar',
+    'citext',
+    'name',
+]);
+function isTextLikeType(dataType) {
+    const base = baseScalarType(dataType);
+    return base !== null && TEXT_LIKE_BASE_TYPES.has(base);
+}
+/** A boolean column — the only type for which `is.true` / `is.false` is valid
+ *  (a `boolean[]` array is excluded). */
+function isBooleanType(dataType) {
+    const base = baseScalarType(dataType);
+    return base === 'boolean' || base === 'bool';
+}
+/** Inclusive [min, max] range for each integer width, used to reject values
+ *  that parse as integers but overflow the column type at execution. */
+const INTEGER_BOUNDS = {
+    smallint: [-32768n, 32767n],
+    int2: [-32768n, 32767n],
+    integer: [-2147483648n, 2147483647n],
+    int: [-2147483648n, 2147483647n],
+    int4: [-2147483648n, 2147483647n],
+    bigint: [-9223372036854775808n, 9223372036854775807n],
+    int8: [-9223372036854775808n, 9223372036854775807n],
+};
+const DECIMAL_BASE_TYPES = new Set([
+    'numeric',
+    'decimal',
+    'real',
+    'double precision',
+    'float',
+    'float4',
+    'float8',
+]);
+const BOOLEAN_LITERALS = new Set([
+    'true',
+    'false',
+    't',
+    'f',
+    'yes',
+    'no',
+    'y',
+    'n',
+    'on',
+    'off',
+    '1',
+    '0',
+]);
+/** A plain base-10 integer literal (optional sign, then digits). A manual
+ *  scan — no regex — so it rejects the `0x`/`0b`/`0o` and exponent forms that
+ *  JavaScript's `Number` tolerates but a PostgreSQL integer column does not. */
+function isPlainInteger(s) {
+    let i = 0;
+    if (s[0] === '+' || s[0] === '-')
+        i = 1;
+    if (i === s.length)
+        return false; // sign only / empty
+    for (; i < s.length; i++) {
+        if (s[i] < '0' || s[i] > '9')
+            return false;
+    }
+    return true;
+}
+/** A lexical decimal literal: optional sign, an integer and/or fractional
+ *  part (at least one digit overall), and an optional exponent. A manual scan
+ *  (no regex) that validates *syntax only* — it does not coerce through JS
+ *  `Number`, so arbitrary-precision PostgreSQL `numeric` values (hundreds of
+ *  digits, magnitudes beyond JS range) are accepted, while `abc`, `0x10`, and
+ *  `NaN`/`Infinity` are rejected. Range / precision are checked separately
+ *  (see `decimalFitsRange`). */
+function isLexicalDecimal(s) {
+    let i = 0;
+    const n = s.length;
+    if (i < n && (s[i] === '+' || s[i] === '-'))
+        i++;
+    let digits = 0;
+    while (i < n && s[i] >= '0' && s[i] <= '9') {
+        i++;
+        digits++;
+    }
+    if (i < n && s[i] === '.') {
+        i++;
+        while (i < n && s[i] >= '0' && s[i] <= '9') {
+            i++;
+            digits++;
+        }
+    }
+    if (digits === 0)
+        return false; // need at least one digit somewhere
+    if (i < n && (s[i] === 'e' || s[i] === 'E')) {
+        i++;
+        if (i < n && (s[i] === '+' || s[i] === '-'))
+            i++;
+        let expDigits = 0;
+        while (i < n && s[i] >= '0' && s[i] <= '9') {
+            i++;
+            expDigits++;
+        }
+        if (expDigits === 0)
+            return false;
+    }
+    return i === n; // the whole string was consumed
+}
+/** Parse a `numeric(p,s)` / `numeric(p)` type modifier out of a `format_type`
+ *  string, or `null` when the type carries none (arbitrary-precision numeric).
+ *  Linear scan / split — no regex (CodeQL `js/polynomial-redos` precedent). */
+function numericTypmod(dataType) {
+    const open = dataType.indexOf('(');
+    if (open === -1)
+        return null;
+    const close = dataType.indexOf(')', open + 1);
+    if (close === -1)
+        return null;
+    const parts = dataType.slice(open + 1, close).split(',');
+    const precision = Number.parseInt(parts[0].trim(), 10);
+    if (!Number.isInteger(precision))
+        return null;
+    const scale = parts.length > 1 ? Number.parseInt(parts[1].trim(), 10) : 0;
+    if (!Number.isInteger(scale))
+        return null;
+    return { precision, scale };
+}
+/** Number of decimal digits of a non-negative BigInt (`0n` -> 1). */
+function bigIntDigits(n) {
+    return n === 0n ? 1 : n.toString().length;
+}
+/** Whether a lexically-valid decimal fits `numeric(precision, scale)`.
+ *  PostgreSQL rounds the value to `scale` fractional digits, then requires the
+ *  result to fit in `precision` total significant digits — i.e. the value
+ *  scaled to an integer in units of `10^-scale` must have at most `precision`
+ *  digits. Done with BigInt so rounding carry (`9999999999.995` ->
+ *  `10000000000.00` on `numeric(12,2)`) is exact and arbitrary-precision values
+ *  are never lost. A huge exponent is handled without materialising `10^exp`. */
+function numericFitsTypmod(value, precision, scale) {
+    let s = value.trim();
+    if (s[0] === '+' || s[0] === '-')
+        s = s.slice(1);
+    let eIdx = s.indexOf('e');
+    if (eIdx === -1)
+        eIdx = s.indexOf('E');
+    let exp = 0;
+    if (eIdx !== -1) {
+        exp = Number.parseInt(s.slice(eIdx + 1), 10);
+        s = s.slice(0, eIdx);
+    }
+    const dot = s.indexOf('.');
+    const intPart = dot === -1 ? s : s.slice(0, dot);
+    const fracPart = dot === -1 ? '' : s.slice(dot + 1);
+    const d = intPart + fracPart === '' ? 0n : BigInt(intPart + fracPart);
+    if (d === 0n)
+        return true; // zero fits any numeric(p, s)
+    // value = d * 10^(exp - fracPart.length); the rounded scaled integer is
+    // R = round(value * 10^scale) = round(d * 10^j), and we need it to have at
+    // most `precision` digits.
+    const j = exp - fracPart.length + scale;
+    if (j >= 0) {
+        // d * 10^j has exactly bigIntDigits(d) + j digits — no exponentiation.
+        return bigIntDigits(d) + j <= precision;
+    }
+    const drop = -j;
+    // Dropping more digits than d has rounds the magnitude to 0 or 1 — always fits.
+    if (drop > bigIntDigits(d))
+        return true;
+    const pow = 10n ** BigInt(drop); // drop <= digit count, so this is bounded
+    const q = d / pow;
+    const rem = d % pow;
+    const r = rem * 2n >= pow ? q + 1n : q; // round half away from zero (PostgreSQL)
+    return bigIntDigits(r) <= precision;
+}
+/** Whether a lexically-valid decimal is genuinely zero — all mantissa digits
+ *  are zero (`0`, `0.0`, `0e5`) — rather than a nonzero value that merely
+ *  rounds to zero. Scans the mantissa only, not the exponent. */
+function isLexicalZero(value) {
+    let end = value.indexOf('e');
+    if (end === -1)
+        end = value.indexOf('E');
+    if (end === -1)
+        end = value.length;
+    for (let i = 0; i < end; i++) {
+        if (value[i] >= '1' && value[i] <= '9')
+            return false;
+    }
+    return true;
+}
+/** Whether a lexically-valid decimal is representable by a PostgreSQL float
+ *  type. PostgreSQL rejects both overflow (magnitude above the type maximum)
+ *  and underflow (a nonzero magnitude that rounds to zero in the type). `real`
+ *  is IEEE single precision, so round through `Math.fround` — it maps an
+ *  overflow to `Infinity` and an underflow to `0`; `double precision` is IEEE
+ *  double, which JS `Number` models exactly. */
+function floatFits(value, single) {
+    const n = single ? Math.fround(Number(value)) : Number(value);
+    if (!Number.isFinite(n))
+        return false; // overflow -> Infinity
+    return n !== 0 || isLexicalZero(value); // nonzero input rounding to 0 = underflow
+}
+/** Whether a lexically-valid decimal fits the decimal/float column's range.
+ *  `numeric(p,s)`: see `numericFitsTypmod` (rounded to `scale`, must fit in `p`
+ *  total digits); without a typmod, precision is unlimited. `real` /
+ *  `double precision`: must be within the type's representable range. */
+function decimalFitsRange(base, dataType, value) {
+    if (base === 'real' || base === 'float4')
+        return floatFits(value, true);
+    if (base === 'double precision' || base === 'float8' || base === 'float') {
+        return floatFits(value, false);
+    }
+    const typmod = numericTypmod(dataType);
+    if (typmod === null)
+        return true; // arbitrary precision — no precision bound
+    return numericFitsTypmod(value, typmod.precision, typmod.scale);
+}
+/** Whether a string filter value parses as the column's type, for the types
+ *  where a bad value would otherwise surface only at execution as a 500:
+ *  integer family (exact, with width range), decimal/float family (lexical
+ *  syntax plus range/precision, Kozou v1.0 issue #81), and boolean. Other
+ *  types (uuid / date / json / ...) are not pre-checked and fall through to
+ *  PostgreSQL.
+ *
+ *  Decimal syntax is validated without coercing through JS `Number` (so an
+ *  arbitrary-precision `numeric` is not false-rejected); range / precision is
+ *  then checked from the type modifier (`numeric(p,s)`) or the float range. */
+function valueFitsType(base, dataType, value) {
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return false;
+    const bounds = INTEGER_BOUNDS[base];
+    if (bounds !== undefined) {
+        if (!isPlainInteger(trimmed))
+            return false;
+        const n = BigInt(trimmed);
+        return n >= bounds[0] && n <= bounds[1];
+    }
+    if (DECIMAL_BASE_TYPES.has(base)) {
+        if (!isLexicalDecimal(trimmed))
+            return false;
+        return decimalFitsRange(base, dataType, trimmed);
+    }
+    if (base === 'boolean' || base === 'bool') {
+        return BOOLEAN_LITERALS.has(trimmed.toLowerCase());
+    }
+    return true;
+}
+/**
+ * Reject a filter value that cannot parse as the column's type *before* the
+ * query runs (Kozou v1.0 issue #76). Limited to numeric-family and boolean
+ * columns — the common cases that otherwise raise a PostgreSQL data error
+ * (a 500) at execution. The check is tied to the bound filter value, so a
+ * 400 here is unambiguously client-caused (no server/view error is masked).
+ */
+function assertFilterValueParsable(filter, column, resource) {
+    if (filter.op === 'is')
+        return; // fixed keyword clause, no bound value
+    const base = baseScalarType(column.dataType);
+    if (base === null)
+        return; // array etc. — not value-checked here
+    const values = filter.op === 'in' ? filter.values : [filter.value];
+    for (const value of values) {
+        if (!valueFitsType(base, column.dataType, value)) {
+            throw badRequest(`Filter value "${value}" is not valid for column "${filter.column}" (${column.dataType}) ` +
+                `on resource "${resource.name}".`);
+        }
+    }
+}
+/**
+ * Reject statically-knowable operator/column-type mismatches with a 400 before
+ * the query runs (Kozou v1.0 issue #76): `like`/`ilike` need a text-like
+ * column, and `is.true`/`is.false` need a boolean column. Value-format
+ * mismatches that only surface at execution (e.g. `eq.abc` on a numeric
+ * column) are mapped to 400 by the handler's error classifier instead.
+ */
+function assertFilterTypeCompatible(filter, column, resource) {
+    if ((filter.op === 'like' || filter.op === 'ilike') && !isTextLikeType(column.dataType)) {
+        throw badRequest(`Operator "${filter.op}" requires a text-like column; "${filter.column}" on resource ` +
+            `"${resource.name}" is ${column.dataType}.`);
+    }
+    if (filter.op === 'is' &&
+        (filter.keyword === 'true' || filter.keyword === 'false') &&
+        !isBooleanType(column.dataType)) {
+        throw badRequest(`Filter "is.${filter.keyword}" requires a boolean column; "${filter.column}" on resource ` +
+            `"${resource.name}" is ${column.dataType}.`);
+    }
+}
+function selectColumns(resource) {
+    if (resource.columns.length === 0)
+        return '*';
+    return resource.columns.map((c) => quoteIdent(c.name)).join(', ');
+}
+/** Columns that free-text search targets: text-like widgets whose underlying
+ *  type is also text-like. uuid / enum / numeric columns are excluded (an
+ *  `ILIKE` against them either errors or is meaningless), as are text-widget
+ *  columns whose real type is an array / domain / other non-text scalar — the
+ *  base-type guard keeps `?search=` from emitting an ILIKE that PostgreSQL
+ *  rejects (Kozou v1.0 issue #76). */
+function searchableColumns(resource) {
+    return resource.columns
+        .filter((c) => (c.widget === 'text' || c.widget === 'textarea') && isTextLikeType(c.dataType))
+        .map((c) => c.name);
+}
+function clampPageSize(pageSize) {
+    if (pageSize === undefined || !Number.isFinite(pageSize) || pageSize < 1) {
+        return DEFAULT_PAGE_SIZE;
+    }
+    return Math.min(Math.floor(pageSize), MAX_PAGE_SIZE);
+}
+function clampPage(page) {
+    if (page === undefined || !Number.isFinite(page) || page < 1)
+        return 1;
+    return Math.floor(page);
+}
+export function buildListQuery(resource, params) {
+    const columnsByName = new Map(resource.columns.map((c) => [c.name, c]));
+    const whereParts = [];
+    const whereValues = [];
+    const nextParam = () => `$${whereValues.length + 1}`;
+    // Horizontal filters. The column allowlist is the resource's own columns;
+    // every supplied value is a bound parameter ($n). `is` emits a fixed
+    // keyword clause (no value bound).
+    for (const filter of params.filters ?? []) {
+        const columnDef = columnsByName.get(filter.column);
+        if (columnDef === undefined) {
+            throw badRequest(`Unknown filter column "${filter.column}" on resource "${resource.name}".`);
+        }
+        assertFilterTypeCompatible(filter, columnDef, resource);
+        assertFilterValueParsable(filter, columnDef, resource);
+        const column = quoteIdent(filter.column);
+        if (filter.op === 'in') {
+            if (filter.values.length === 0) {
+                throw badRequest(`Filter "${filter.column}=in.()" needs at least one value.`);
+            }
+            const placeholders = [];
+            for (const value of filter.values) {
+                placeholders.push(nextParam());
+                whereValues.push(value);
+            }
+            whereParts.push(`${column} IN (${placeholders.join(', ')})`);
+        }
+        else if (filter.op === 'is') {
+            whereParts.push(`${column} IS ${IS_KEYWORD_SQL[filter.keyword]}`);
+        }
+        else {
+            whereParts.push(`${column} ${SCALAR_OP_SQL[filter.op]} ${nextParam()}`);
+            whereValues.push(filter.op === 'like' || filter.op === 'ilike'
+                ? toLikePattern(filter.value)
+                : filter.value);
+        }
+    }
+    // Free-text search across text-like columns.
+    const search = params.search?.trim();
+    if (search !== undefined && search.length > 0) {
+        const cols = searchableColumns(resource);
+        if (cols.length > 0) {
+            const placeholder = nextParam();
+            whereValues.push(`%${search}%`);
+            const ors = cols.map((c) => `${quoteIdent(c)} ILIKE ${placeholder}`).join(' OR ');
+            whereParts.push(`(${ors})`);
+        }
+    }
+    const whereClause = whereParts.length > 0 ? ` WHERE ${whereParts.join(' AND ')}` : '';
+    // ORDER BY: explicit sort, else default to the primary key for stable
+    // pagination. Views (no PK) fall back to no ordering.
+    const orderParts = [];
+    if (params.sort && params.sort.length > 0) {
+        for (const s of params.sort) {
+            if (!columnsByName.has(s.field)) {
+                throw badRequest(`Unknown sort column "${s.field}" on resource "${resource.name}".`);
+            }
+            orderParts.push(`${quoteIdent(s.field)} ${s.order === 'desc' ? 'DESC' : 'ASC'}`);
+        }
+    }
+    else {
+        for (const pk of resource.primaryKey) {
+            orderParts.push(`${quoteIdent(pk)} ASC`);
+        }
+    }
+    const orderClause = orderParts.length > 0 ? ` ORDER BY ${orderParts.join(', ')}` : '';
+    const page = clampPage(params.page);
+    const pageSize = clampPageSize(params.pageSize);
+    const offset = (page - 1) * pageSize;
+    const cols = selectColumns(resource);
+    const table = qualified(resource);
+    // Embeds append correlated subqueries to the SELECT list only — they add no
+    // bound parameters, so the $n numbering above is unaffected.
+    const embedSql = params.embed && params.embed.length > 0
+        ? buildEmbedSelectFragment(params.embed, table, { n: 0 })
+        : '';
+    const dataValues = [...whereValues, pageSize, offset];
+    const limitParam = `$${whereValues.length + 1}`;
+    const offsetParam = `$${whereValues.length + 2}`;
+    const dataText = `SELECT ${cols}${embedSql} FROM ${table}${whereClause}${orderClause} LIMIT ${limitParam} OFFSET ${offsetParam}`;
+    const countText = `SELECT count(*) AS total FROM ${table}${whereClause}`;
+    return {
+        dataText,
+        dataValues,
+        countText,
+        countValues: [...whereValues],
+        page,
+        pageSize,
+    };
+}
+/** Primary key columns for an item-by-id operation. A PK-less resource (a
+ *  view, or a table without a primary key) cannot be addressed by id. */
+function primaryKey(resource) {
+    if (resource.primaryKey.length === 0) {
+        throw badRequest(`Resource "${resource.name}" has no primary key; fetch/update/delete by id is unavailable.`);
+    }
+    return resource.primaryKey;
+}
+/**
+ * Resolve the bound key values from an item id segment.
+ *
+ * A single-column PK takes the id verbatim, so the value may itself contain a
+ * comma. A composite PK splits the segment on commas into one component per
+ * key column, in `primaryKey` declaration order; the component count must
+ * match the key arity (else 400).
+ *
+ * Limitation: with a composite key, a key *value* cannot contain a comma (the
+ * segment is split after URL-decoding). Single-column keys are unaffected.
+ */
+function resolveKeyValues(resource, id, keyColumns) {
+    if (keyColumns.length === 1)
+        return [id];
+    const parts = id.split(',');
+    if (parts.length !== keyColumns.length) {
+        throw badRequest(`Resource "${resource.name}" has a composite primary key (${keyColumns.join(', ')}); ` +
+            `expected ${keyColumns.length} comma-separated key components, got ${parts.length}.`);
+    }
+    return parts;
+}
+/** `pk0 = $start AND pk1 = $start+1 AND ...` for the given key columns. */
+function keyWhereClause(keyColumns, startParam) {
+    return keyColumns.map((c, i) => `${quoteIdent(c)} = $${startParam + i}`).join(' AND ');
+}
+export function buildGetQuery(resource, id, embed) {
+    const keyColumns = primaryKey(resource);
+    const keyValues = resolveKeyValues(resource, id, keyColumns);
+    const table = qualified(resource);
+    const embedSql = embed && embed.length > 0 ? buildEmbedSelectFragment(embed, table, { n: 0 }) : '';
+    const where = keyWhereClause(keyColumns, 1);
+    const text = `SELECT ${selectColumns(resource)}${embedSql} FROM ${table} WHERE ${where} LIMIT 1`;
+    return { text, values: keyValues };
+}
+export const DEFAULT_RELATION_LIMIT = 20;
+export const MAX_RELATION_LIMIT = 100;
+function singlePrimaryKey(resource) {
+    if (resource.primaryKey.length !== 1) {
+        throw badRequest(`Resource "${resource.name}" does not have a single-column primary key.`);
+    }
+    return resource.primaryKey[0];
+}
+function assertKnownColumns(resource, keys) {
+    const columnNames = new Set(resource.columns.map((c) => c.name));
+    for (const key of keys) {
+        if (!columnNames.has(key)) {
+            throw badRequest(`Unknown column "${key}" on resource "${resource.name}".`);
+        }
+    }
+}
+export function buildInsertQuery(resource, data) {
+    const keys = Object.keys(data);
+    assertKnownColumns(resource, keys);
+    const returning = selectColumns(resource);
+    const table = qualified(resource);
+    // No columns supplied: insert a row of all column defaults.
+    if (keys.length === 0) {
+        return { text: `INSERT INTO ${table} DEFAULT VALUES RETURNING ${returning}`, values: [] };
+    }
+    const cols = keys.map(quoteIdent).join(', ');
+    const placeholders = keys.map((_, i) => `$${i + 1}`).join(', ');
+    const values = keys.map((k) => data[k]);
+    return {
+        text: `INSERT INTO ${table} (${cols}) VALUES (${placeholders}) RETURNING ${returning}`,
+        values,
+    };
+}
+export function buildUpdateQuery(resource, id, data) {
+    const keyColumns = primaryKey(resource);
+    const keys = Object.keys(data);
+    if (keys.length === 0) {
+        throw badRequest(`No fields to update on resource "${resource.name}".`);
+    }
+    assertKnownColumns(resource, keys);
+    const keyValues = resolveKeyValues(resource, id, keyColumns);
+    const sets = keys.map((k, i) => `${quoteIdent(k)} = $${i + 1}`).join(', ');
+    const values = [...keys.map((k) => data[k]), ...keyValues];
+    const where = keyWhereClause(keyColumns, keys.length + 1);
+    const text = `UPDATE ${qualified(resource)} SET ${sets} WHERE ${where} RETURNING ${selectColumns(resource)}`;
+    return { text, values };
+}
+export function buildDeleteQuery(resource, id) {
+    const keyColumns = primaryKey(resource);
+    const keyValues = resolveKeyValues(resource, id, keyColumns);
+    const where = keyWhereClause(keyColumns, 1);
+    const text = `DELETE FROM ${qualified(resource)} WHERE ${where} RETURNING ${selectColumns(resource)}`;
+    return { text, values: keyValues };
+}
+function clampRelationLimit(limit) {
+    if (limit === undefined || !Number.isFinite(limit) || limit < 1)
+        return DEFAULT_RELATION_LIMIT;
+    return Math.min(Math.floor(limit), MAX_RELATION_LIMIT);
+}
+/** Lightweight `{ id, label }` lookup used by relation-select widgets. */
+export function buildRelationOptionsQuery(resource, params) {
+    const pk = singlePrimaryKey(resource);
+    assertKnownColumns(resource, [params.labelField, ...params.searchFields]);
+    // `searchFields` is request-controlled (`?as=options&fields=`); each is
+    // ILIKE'd below, so reject a non-text-like field with a 400 rather than
+    // letting PostgreSQL raise an operator error (a 500) at execution
+    // (Kozou v1.0 issue #76).
+    const columnsByName = new Map(resource.columns.map((c) => [c.name, c]));
+    for (const field of params.searchFields) {
+        const column = columnsByName.get(field);
+        if (column !== undefined && !isTextLikeType(column.dataType)) {
+            throw badRequest(`Relation search field "${field}" must be a text-like column; it is ${column.dataType}.`);
+        }
+    }
+    const values = [];
+    let where = '';
+    const q = params.query?.trim();
+    if (q !== undefined && q.length > 0 && params.searchFields.length > 0) {
+        values.push(`%${q}%`);
+        const ors = params.searchFields.map((f) => `${quoteIdent(f)} ILIKE $1`).join(' OR ');
+        where = ` WHERE (${ors})`;
+    }
+    values.push(clampRelationLimit(params.limit));
+    const limitParam = `$${values.length}`;
+    const cols = params.labelField === pk
+        ? quoteIdent(pk)
+        : `${quoteIdent(pk)}, ${quoteIdent(params.labelField)}`;
+    const text = `SELECT ${cols} FROM ${qualified(resource)}${where} LIMIT ${limitParam}`;
+    return { text, values, primaryKey: pk, labelField: params.labelField };
+}
+//# sourceMappingURL=query-builder.js.map

package/dist/query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.js","sourceRoot":"","sources":["../src/query-builder.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,0EAA0E;AAC1E,EAAE;AACF,mBAAmB;AACnB,wEAAwE;AACxE,yEAAyE;AACzE,uEAAuE;AACvE,0CAA0C;AAC1C,uEAAuE;AACvE,iDAAiD;AAIjD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,EAAE,wBAAwB,EAAkB,MAAM,YAAY,CAAC;AAGtE,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,MAAM,CAAC,MAAM,iBAAiB,GAAG,EAAE,CAAC;AACpC,MAAM,CAAC,MAAM,aAAa,GAAG,GAAG,CAAC;AA4CjC,MAAM,aAAa,GAAyC;IAC1D,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,IAAI;IACT,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,IAAI;IACT,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,IAAI;IACT,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACf,CAAC;AAEF,MAAM,cAAc,GAA8B;IAChD,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,UAAU;IACnB,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;CACf,CAAC;AAEF;;uDAEuD;AACvD,SAAS,aAAa,CAAC,KAAa;IAClC,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;;;;qEAIqE;AACrE,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC5C,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,kCAAkC;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/D,CAAC;AAED;;;4DAG4D;AAC5D,MAAM,oBAAoB,GAAG,IAAI,GAAG,CAAC;IACnC,MAAM;IACN,mBAAmB;IACnB,SAAS;IACT,WAAW;IACX,MAAM;IACN,QAAQ;IACR,QAAQ;IACR,MAAM;CACP,CAAC,CAAC;AAEH,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,IAAI,KAAK,IAAI,IAAI,oBAAoB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzD,CAAC;AAED;yCACyC;AACzC,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,IAAI,GAAG,cAAc,CAAC,QAAQ,CAAC,CAAC;IACtC,OAAO,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,MAAM,CAAC;AAC/C,CAAC;AAED;wEACwE;AACxE,MAAM,cAAc,GAAqC;IACvD,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC;IACpC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC;IAChC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,WAAW,CAAC;IACjC,MAAM,EAAE,CAAC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;IACrD,IAAI,EAAE,CAAC,CAAC,oBAAoB,EAAE,oBAAoB,CAAC;CACpD,CAAC;AACF,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,SAAS;IACT,SAAS;IACT,MAAM;IACN,kBAAkB;IAClB,OAAO;IACP,QAAQ;IACR,QAAQ;CACT,CAAC,CAAC;AACH,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC;IAC/B,MAAM;IACN,OAAO;IACP,GAAG;IACH,GAAG;IACH,KAAK;IACL,IAAI;IACJ,GAAG;IACH,GAAG;IACH,IAAI;IACJ,KAAK;IACL,GAAG;IACH,GAAG;CACJ,CAAC,CAAC;AAEH;;gFAEgF;AAChF,SAAS,cAAc,CAAC,CAAS;IAC/B,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,CAAC,GAAG,CAAC,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC,CAAC,oBAAoB;IACtD,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;YAAE,OAAO,KAAK,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;gCAMgC;AAChC,SAAS,gBAAgB,CAAC,CAAS;IACjC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;QAAE,CAAC,EAAE,CAAC;IACjD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;QAC3C,CAAC,EAAE,CAAC;QACJ,MAAM,EAAE,CAAC;IACX,CAAC;IACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QAC1B,CAAC,EAAE,CAAC;QACJ,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;YAC3C,CAAC,EAAE,CAAC;YACJ,MAAM,EAAE,CAAC;QACX,CAAC;IACH,CAAC;IACD,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,oCAAoC;IACpE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QAC5C,CAAC,EAAE,CAAC;QACJ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;YAAE,CAAC,EAAE,CAAC;QACjD,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,EAAE,CAAC;YAC3C,CAAC,EAAE,CAAC;YACJ,SAAS,EAAE,CAAC;QACd,CAAC;QACD,IAAI,SAAS,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;IACpC,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,gCAAgC;AAClD,CAAC;AAED;;+EAE+E;AAC/E,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7B,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IACvD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1E,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1C,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC9B,CAAC;AAED,qEAAqE;AACrE,SAAS,YAAY,CAAC,CAAS;IAC7B,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC;AAC5C,CAAC;AAED;;;;;;iFAMiF;AACjF,SAAS,iBAAiB,CAAC,KAAa,EAAE,SAAiB,EAAE,KAAa;IACxE,IAAI,CAAC,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IACrB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,IAAI,IAAI,KAAK,CAAC,CAAC;QAAE,IAAI,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACvC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,IAAI,KAAK,CAAC,CAAC,EAAE,CAAC;QAChB,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC7C,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;IACvB,CAAC;IACD,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IACpD,MAAM,CAAC,GAAG,OAAO,GAAG,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,GAAG,QAAQ,CAAC,CAAC;IACtE,IAAI,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC,CAAC,8BAA8B;IACzD,wEAAwE;IACxE,2EAA2E;IAC3E,2BAA2B;IAC3B,MAAM,CAAC,GAAG,GAAG,GAAG,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC;IACxC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACX,uEAAuE;QACvE,OAAO,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;IAC1C,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC;IAChB,gFAAgF;IAChF,IAAI,IAAI,GAAG,YAAY,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,GAAG,GAAG,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,0CAA0C;IAC3E,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;IAClB,MAAM,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;IACpB,MAAM,CAAC,GAAG,GAAG,GAAG,EAAE,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,yCAAyC;IACjF,OAAO,YAAY,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC;AAED;;iEAEiE;AACjE,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC7B,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,CAAC,CAAC;QAAE,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG;YAAE,OAAO,KAAK,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;gDAKgD;AAChD,SAAS,SAAS,CAAC,KAAa,EAAE,MAAe;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9D,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC,CAAC,uBAAuB;IAC9D,OAAO,CAAC,KAAK,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,0CAA0C;AACpF,CAAC;AAED;;;yEAGyE;AACzE,SAAS,gBAAgB,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAa;IACrE,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACxE,IAAI,IAAI,KAAK,kBAAkB,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;QACzE,OAAO,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjC,CAAC;IACD,MAAM,MAAM,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC,CAAC,2CAA2C;IAC7E,OAAO,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;;;;;;+EAS+E;AAC/E,SAAS,aAAa,CAAC,IAAY,EAAE,QAAgB,EAAE,KAAa;IAClE,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QACzB,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1B,OAAO,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;YAAE,OAAO,KAAK,CAAC;QAC7C,OAAO,gBAAgB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAC1C,OAAO,gBAAgB,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,SAAS,yBAAyB,CAChC,MAAc,EACd,MAAqB,EACrB,QAAkB;IAElB,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI;QAAE,OAAO,CAAC,uCAAuC;IACvE,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,CAAC,sCAAsC;IACjE,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,EAAE,CAAC;YACjD,MAAM,UAAU,CACd,iBAAiB,KAAK,8BAA8B,MAAM,CAAC,MAAM,MAAM,MAAM,CAAC,QAAQ,IAAI;gBACxF,gBAAgB,QAAQ,CAAC,IAAI,IAAI,CACpC,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,0BAA0B,CACjC,MAAc,EACd,MAAqB,EACrB,QAAkB;IAElB,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,MAAM,IAAI,MAAM,CAAC,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxF,MAAM,UAAU,CACd,aAAa,MAAM,CAAC,EAAE,mCAAmC,MAAM,CAAC,MAAM,gBAAgB;YACpF,IAAI,QAAQ,CAAC,IAAI,QAAQ,MAAM,CAAC,QAAQ,GAAG,CAC9C,CAAC;IACJ,CAAC;IACD,IACE,MAAM,CAAC,EAAE,KAAK,IAAI;QAClB,CAAC,MAAM,CAAC,OAAO,KAAK,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,OAAO,CAAC;QACzD,CAAC,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,EAC/B,CAAC;QACD,MAAM,UAAU,CACd,cAAc,MAAM,CAAC,OAAO,iCAAiC,MAAM,CAAC,MAAM,gBAAgB;YACxF,IAAI,QAAQ,CAAC,IAAI,QAAQ,MAAM,CAAC,QAAQ,GAAG,CAC9C,CAAC;IACJ,CAAC;AACH,CAAC;AAiBD,SAAS,aAAa,CAAC,QAAkB;IACvC,IAAI,QAAQ,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IAC9C,OAAO,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpE,CAAC;AAED;;;;;sCAKsC;AACtC,SAAS,iBAAiB,CAAC,QAAkB;IAC3C,OAAO,QAAQ,CAAC,OAAO;SACpB,MAAM,CACL,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,QAAQ,CAAC,CACtF;SACA,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,aAAa,CAAC,QAA4B;IACjD,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;AACvD,CAAC;AAED,SAAS,SAAS,CAAC,IAAwB;IACzC,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAkB,EAClB,MAAuB;IAEvB,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAExE,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,MAAM,WAAW,GAAc,EAAE,CAAC;IAClC,MAAM,SAAS,GAAG,GAAW,EAAE,CAAC,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAE7D,0EAA0E;IAC1E,qEAAqE;IACrE,mCAAmC;IACnC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACnD,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,UAAU,CAAC,0BAA0B,MAAM,CAAC,MAAM,kBAAkB,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;QAC/F,CAAC;QACD,0BAA0B,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACxD,yBAAyB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACzC,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YACvB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC/B,MAAM,UAAU,CAAC,WAAW,MAAM,CAAC,MAAM,mCAAmC,CAAC,CAAC;YAChF,CAAC;YACD,MAAM,YAAY,GAAa,EAAE,CAAC;YAClC,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;gBAC/B,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC1B,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,QAAQ,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/D,CAAC;aAAM,IAAI,MAAM,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;YAC9B,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,OAAO,cAAc,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,SAAS,EAAE,EAAE,CAAC,CAAC;YACxE,WAAW,CAAC,IAAI,CACd,MAAM,CAAC,EAAE,KAAK,MAAM,IAAI,MAAM,CAAC,EAAE,KAAK,OAAO;gBAC3C,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC;gBAC7B,CAAC,CAAC,MAAM,CAAC,KAAK,CACjB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,6CAA6C;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpB,MAAM,WAAW,GAAG,SAAS,EAAE,CAAC;YAChC,WAAW,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,UAAU,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAClF,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,UAAU,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtF,sEAAsE;IACtE,sDAAsD;IACtD,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1C,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;gBAChC,MAAM,UAAU,CAAC,wBAAwB,CAAC,CAAC,KAAK,kBAAkB,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;YACvF,CAAC;YACD,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;QACnF,CAAC;IACH,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,EAAE,IAAI,QAAQ,CAAC,UAAU,EAAE,CAAC;YACrC,UAAU,CAAC,IAAI,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,MAAM,WAAW,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,aAAa,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEtF,MAAM,IAAI,GAAG,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC;IAErC,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,4EAA4E;IAC5E,6DAA6D;IAC7D,MAAM,QAAQ,GACZ,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;QACrC,CAAC,CAAC,wBAAwB,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACzD,CAAC,CAAC,EAAE,CAAC;IAET,MAAM,UAAU,GAAG,CAAC,GAAG,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IAChD,MAAM,WAAW,GAAG,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;IACjD,MAAM,QAAQ,GAAG,UAAU,IAAI,GAAG,QAAQ,SAAS,KAAK,GAAG,WAAW,GAAG,WAAW,UAAU,UAAU,WAAW,WAAW,EAAE,CAAC;IAEjI,MAAM,SAAS,GAAG,iCAAiC,KAAK,GAAG,WAAW,EAAE,CAAC;IAEzE,OAAO;QACL,QAAQ;QACR,UAAU;QACV,SAAS;QACT,WAAW,EAAE,CAAC,GAAG,WAAW,CAAC;QAC7B,IAAI;QACJ,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;yEACyE;AACzE,SAAS,UAAU,CAAC,QAAkB;IACpC,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,UAAU,CACd,aAAa,QAAQ,CAAC,IAAI,iEAAiE,CAC5F,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,UAAU,CAAC;AAC7B,CAAC;AAED;;;;;;;;;;GAUG;AACH,SAAS,gBAAgB,CAAC,QAAkB,EAAE,EAAU,EAAE,UAAoB;IAC5E,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC5B,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;QACvC,MAAM,UAAU,CACd,aAAa,QAAQ,CAAC,IAAI,kCAAkC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YACpF,YAAY,UAAU,CAAC,MAAM,wCAAwC,KAAK,CAAC,MAAM,GAAG,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,2EAA2E;AAC3E,SAAS,cAAc,CAAC,UAAoB,EAAE,UAAkB;IAC9D,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,UAAU,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACzF,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,QAAkB,EAClB,EAAU,EACV,KAAmB;IAEnB,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,QAAQ,GACZ,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpF,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,UAAU,aAAa,CAAC,QAAQ,CAAC,GAAG,QAAQ,SAAS,KAAK,UAAU,KAAK,UAAU,CAAC;IACjG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AASD,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAgBtC,SAAS,gBAAgB,CAAC,QAAkB;IAC1C,IAAI,QAAQ,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrC,MAAM,UAAU,CACd,aAAa,QAAQ,CAAC,IAAI,8CAA8C,CACzE,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,kBAAkB,CAAC,QAAkB,EAAE,IAAc;IAC5D,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACjE,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC1B,MAAM,UAAU,CAAC,mBAAmB,GAAG,kBAAkB,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAkB,EAClB,IAA6B;IAE7B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEnC,MAAM,SAAS,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAElC,4DAA4D;IAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,eAAe,KAAK,6BAA6B,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC5F,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,OAAO;QACL,IAAI,EAAE,eAAe,KAAK,KAAK,IAAI,aAAa,YAAY,eAAe,SAAS,EAAE;QACtF,MAAM;KACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,QAAkB,EAClB,EAAU,EACV,IAA6B;IAE7B,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,UAAU,CAAC,oCAAoC,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IAC1E,CAAC;IACD,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACnC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAE7D,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3E,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,UAAU,SAAS,CAAC,QAAQ,CAAC,QAAQ,IAAI,UAAU,KAAK,cAAc,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC7G,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAkB,EAAE,EAAU;IAC7D,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,MAAM,SAAS,GAAG,gBAAgB,CAAC,QAAQ,EAAE,EAAE,EAAE,UAAU,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,cAAc,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,eAAe,SAAS,CAAC,QAAQ,CAAC,UAAU,KAAK,cAAc,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;IACtG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAyB;IACnD,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,sBAAsB,CAAC;IAC/F,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC,CAAC;AACzD,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,yBAAyB,CACvC,QAAkB,EAClB,MAA6B;IAE7B,MAAM,EAAE,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;IACtC,kBAAkB,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAC,UAAU,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;IAE1E,wEAAwE;IACxE,wEAAwE;IACxE,kEAAkE;IAClE,0BAA0B;IAC1B,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,YAAY,EAAE,CAAC;QACxC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC7D,MAAM,UAAU,CACd,0BAA0B,KAAK,uCAAuC,MAAM,CAAC,QAAQ,GAAG,CACzF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAc,EAAE,CAAC;IAC7B,IAAI,KAAK,GAAG,EAAE,CAAC;IACf,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/B,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,MAAM,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtB,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrF,KAAK,GAAG,WAAW,GAAG,GAAG,CAAC;IAC5B,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;IAEvC,MAAM,IAAI,GACR,MAAM,CAAC,UAAU,KAAK,EAAE;QACtB,CAAC,CAAC,UAAU,CAAC,EAAE,CAAC;QAChB,CAAC,CAAC,GAAG,UAAU,CAAC,EAAE,CAAC,KAAK,UAAU,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;IAC5D,MAAM,IAAI,GAAG,UAAU,IAAI,SAAS,SAAS,CAAC,QAAQ,CAAC,GAAG,KAAK,UAAU,UAAU,EAAE,CAAC;IAEtF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;AACzE,CAAC"}

package/dist/schema-lookup.d.ts

@@ -0,0 +1,30 @@
+import type { SchemaContext, ColumnContext, RelationContext } from '@kozou/core';
+export type ResourceKind = 'table' | 'view';
+/** A normalized, query-ready view of a table or a view. */
+export type Resource = {
+    kind: ResourceKind;
+    schema: string;
+    name: string;
+    qualifiedName: string;
+    columns: ColumnContext[];
+    /** Primary-key columns. Empty for views and PK-less tables. */
+    primaryKey: string[];
+    /** Outgoing forward (to-one / one-to-one) relations. Empty for views. */
+    relations: RelationContext[];
+};
+/** A child resource holding a foreign key that points back at some parent —
+ *  the basis for reverse (one-to-many) embedding. */
+export type ReverseRelation = {
+    child: Resource;
+    relation: RelationContext;
+};
+export type ResourceLookup = {
+    /** Resolve by bare name (when unambiguous) or by `schema.name`. */
+    resolve(name: string): Resource | undefined;
+    /** Qualified names of every addressable resource, sorted. */
+    list(): string[];
+    /** Children whose foreign key references the given qualified resource. */
+    reverse(qualifiedName: string): ReverseRelation[];
+};
+export declare function buildResourceLookup(schema: SchemaContext): ResourceLookup;
+//# sourceMappingURL=schema-lookup.d.ts.map

package/dist/schema-lookup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-lookup.d.ts","sourceRoot":"","sources":["../src/schema-lookup.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5C,2DAA2D;AAC3D,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,aAAa,EAAE,CAAC;IACzB,+DAA+D;IAC/D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,yEAAyE;IACzE,SAAS,EAAE,eAAe,EAAE,CAAC;CAC9B,CAAC;AAEF;qDACqD;AACrD,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,QAAQ,CAAC;IAChB,QAAQ,EAAE,eAAe,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,mEAAmE;IACnE,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC5C,6DAA6D;IAC7D,IAAI,IAAI,MAAM,EAAE,CAAC;IACjB,0EAA0E;IAC1E,OAAO,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,EAAE,CAAC;CACnD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,cAAc,CA0DzE"}