@remix-run/data-table 0.0.0 → 0.1.0

package/dist/lib/errors.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Base error for all `data-table` failures.
+ */
+export declare class DataTableError extends Error {
+    code: string;
+    metadata?: Record<string, unknown>;
+    constructor(message: string, options?: {
+        code?: string;
+        cause?: unknown;
+        metadata?: Record<string, unknown>;
+    });
+}
+/**
+ * Thrown when input data fails schema validation.
+ */
+export declare class DataTableValidationError extends DataTableError {
+    issues: ReadonlyArray<unknown>;
+    constructor(message: string, issues: ReadonlyArray<unknown>, options?: {
+        cause?: unknown;
+        metadata?: Record<string, unknown>;
+    });
+}
+/**
+ * Thrown when a query is invalid for the current builder state.
+ */
+export declare class DataTableQueryError extends DataTableError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+        metadata?: Record<string, unknown>;
+    });
+}
+/**
+ * Thrown when adapter execution fails.
+ */
+export declare class DataTableAdapterError extends DataTableError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+        metadata?: Record<string, unknown>;
+    });
+}
+/**
+ * Thrown when a database constraint is violated.
+ */
+export declare class DataTableConstraintError extends DataTableError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+        metadata?: Record<string, unknown>;
+    });
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/lib/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAElC,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EAMF;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;IAE9B,YACE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,aAAa,CAAC,OAAO,CAAC,EAC9B,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EAUF;CACF;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,cAAc;IACrD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF;AAED;;GAEG;AACH,qBAAa,qBAAsB,SAAQ,cAAc;IACvD,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,cAAc;IAC1D,YACE,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE;QACR,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KACnC,EASF;CACF"}

package/dist/lib/errors.js

@@ -0,0 +1,67 @@
+/**
+ * Base error for all `data-table` failures.
+ */
+export class DataTableError extends Error {
+    code;
+    metadata;
+    constructor(message, options) {
+        super(message, { cause: options?.cause });
+        this.name = 'DataTableError';
+        this.code = options?.code ?? 'DATA_TABLE_ERROR';
+        this.metadata = options?.metadata;
+    }
+}
+/**
+ * Thrown when input data fails schema validation.
+ */
+export class DataTableValidationError extends DataTableError {
+    issues;
+    constructor(message, issues, options) {
+        super(message, {
+            code: 'DATA_TABLE_VALIDATION_ERROR',
+            cause: options?.cause,
+            metadata: options?.metadata,
+        });
+        this.name = 'DataTableValidationError';
+        this.issues = issues;
+    }
+}
+/**
+ * Thrown when a query is invalid for the current builder state.
+ */
+export class DataTableQueryError extends DataTableError {
+    constructor(message, options) {
+        super(message, {
+            code: 'DATA_TABLE_QUERY_ERROR',
+            cause: options?.cause,
+            metadata: options?.metadata,
+        });
+        this.name = 'DataTableQueryError';
+    }
+}
+/**
+ * Thrown when adapter execution fails.
+ */
+export class DataTableAdapterError extends DataTableError {
+    constructor(message, options) {
+        super(message, {
+            code: 'DATA_TABLE_ADAPTER_ERROR',
+            cause: options?.cause,
+            metadata: options?.metadata,
+        });
+        this.name = 'DataTableAdapterError';
+    }
+}
+/**
+ * Thrown when a database constraint is violated.
+ */
+export class DataTableConstraintError extends DataTableError {
+    constructor(message, options) {
+        super(message, {
+            code: 'DATA_TABLE_CONSTRAINT_ERROR',
+            cause: options?.cause,
+            metadata: options?.metadata,
+        });
+        this.name = 'DataTableConstraintError';
+    }
+}

package/dist/lib/inflection.d.ts

@@ -0,0 +1,3 @@
+export declare function singularize(word: string): string;
+export declare function inferForeignKey(tableName: string): string;
+//# sourceMappingURL=inflection.d.ts.map

package/dist/lib/inflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inflection.d.ts","sourceRoot":"","sources":["../../src/lib/inflection.ts"],"names":[],"mappings":"AAoBA,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAwBhD;AAED,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUzD"}

package/dist/lib/inflection.js

@@ -0,0 +1,56 @@
+const IRREGULAR_SINGULAR_FORMS = {
+    people: 'person',
+    men: 'man',
+    women: 'woman',
+    children: 'child',
+    teeth: 'tooth',
+    feet: 'foot',
+    geese: 'goose',
+    mice: 'mouse',
+    data: 'datum',
+    media: 'medium',
+    indices: 'index',
+    vertices: 'vertex',
+    analyses: 'analysis',
+    statuses: 'status',
+    categories: 'category',
+    companies: 'company',
+    addresses: 'address',
+};
+export function singularize(word) {
+    let lower = word.toLowerCase();
+    if (IRREGULAR_SINGULAR_FORMS[lower]) {
+        return preserveCase(word, IRREGULAR_SINGULAR_FORMS[lower]);
+    }
+    if (lower.endsWith('ies') && lower.length > 3) {
+        return preserveCase(word, word.slice(0, -3) + 'y');
+    }
+    if (lower.endsWith('sses') || lower.endsWith('shes') || lower.endsWith('ches')) {
+        return preserveCase(word, word.slice(0, -2));
+    }
+    if (lower.endsWith('xes') || lower.endsWith('zes')) {
+        return preserveCase(word, word.slice(0, -2));
+    }
+    if (lower.endsWith('s') && !lower.endsWith('ss')) {
+        return preserveCase(word, word.slice(0, -1));
+    }
+    return word;
+}
+export function inferForeignKey(tableName) {
+    let segments = tableName.split('_');
+    let tail = segments.pop() ?? tableName;
+    let singularTail = singularize(tail);
+    if (segments.length === 0) {
+        return singularTail + '_id';
+    }
+    return [...segments, singularTail + '_id'].join('_');
+}
+function preserveCase(source, replacement) {
+    if (source.length === 0) {
+        return replacement;
+    }
+    if (source[0] === source[0].toUpperCase()) {
+        return replacement[0].toUpperCase() + replacement.slice(1);
+    }
+    return replacement;
+}

package/dist/lib/operators.d.ts

@@ -0,0 +1,151 @@
+import type { ColumnInput, ColumnReferenceLike, NormalizeColumnInput } from './references.ts';
+/**
+ * Comparison operators supported by `comparison` predicates.
+ */
+export type ComparisonOperator = 'eq' | 'ne' | 'gt' | 'gte' | 'lt' | 'lte' | 'in' | 'notIn' | 'like' | 'ilike';
+type QualifiedColumnReference = `${string}.${string}`;
+type PredicateColumn<input extends string | ColumnReferenceLike> = NormalizeColumnInput<input> & string;
+/**
+ * Normalized predicate representation consumed by adapters.
+ */
+export type Predicate<column extends string = string> = {
+    type: 'comparison';
+    operator: ComparisonOperator;
+    column: column;
+    value: unknown;
+    valueType: 'value';
+} | {
+    type: 'comparison';
+    operator: Exclude<ComparisonOperator, 'in' | 'notIn'>;
+    column: column;
+    value: column;
+    valueType: 'column';
+} | {
+    type: 'between';
+    column: column;
+    lower: unknown;
+    upper: unknown;
+} | {
+    type: 'null';
+    operator: 'isNull' | 'notNull';
+    column: column;
+} | {
+    type: 'logical';
+    operator: 'and' | 'or';
+    predicates: Predicate<column>[];
+};
+export type WhereObject<column extends string = string> = Partial<Record<column, unknown>>;
+/**
+ * User-facing where input accepted by `query.where()` and relation modifiers.
+ */
+export type WhereInput<column extends string = string> = Predicate<column> | WhereObject<column>;
+/**
+ * Builds an equality predicate.
+ */
+export declare function eq<left extends ColumnInput<QualifiedColumnReference>, right extends ColumnInput<QualifiedColumnReference>>(column: left, value: right & (right extends `${string}@${string}` ? never : right)): Predicate<PredicateColumn<left> | PredicateColumn<right>>;
+export declare function eq<column extends string | ColumnReferenceLike>(column: column, value: unknown): Predicate<PredicateColumn<column>>;
+/**
+ * Builds an inequality predicate.
+ */
+export declare function ne<left extends ColumnInput<QualifiedColumnReference>, right extends ColumnInput<QualifiedColumnReference>>(column: left, value: right & (right extends `${string}@${string}` ? never : right)): Predicate<PredicateColumn<left> | PredicateColumn<right>>;
+export declare function ne<column extends string | ColumnReferenceLike>(column: column, value: unknown): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a greater-than predicate.
+ */
+export declare function gt<left extends ColumnInput<QualifiedColumnReference>, right extends ColumnInput<QualifiedColumnReference>>(column: left, value: right & (right extends `${string}@${string}` ? never : right)): Predicate<PredicateColumn<left> | PredicateColumn<right>>;
+export declare function gt<column extends string | ColumnReferenceLike>(column: column, value: unknown): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a greater-than-or-equal predicate.
+ */
+export declare function gte<left extends ColumnInput<QualifiedColumnReference>, right extends ColumnInput<QualifiedColumnReference>>(column: left, value: right & (right extends `${string}@${string}` ? never : right)): Predicate<PredicateColumn<left> | PredicateColumn<right>>;
+export declare function gte<column extends string | ColumnReferenceLike>(column: column, value: unknown): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a less-than predicate.
+ */
+export declare function lt<left extends ColumnInput<QualifiedColumnReference>, right extends ColumnInput<QualifiedColumnReference>>(column: left, value: right & (right extends `${string}@${string}` ? never : right)): Predicate<PredicateColumn<left> | PredicateColumn<right>>;
+export declare function lt<column extends string | ColumnReferenceLike>(column: column, value: unknown): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a less-than-or-equal predicate.
+ */
+export declare function lte<left extends ColumnInput<QualifiedColumnReference>, right extends ColumnInput<QualifiedColumnReference>>(column: left, value: right & (right extends `${string}@${string}` ? never : right)): Predicate<PredicateColumn<left> | PredicateColumn<right>>;
+export declare function lte<column extends string | ColumnReferenceLike>(column: column, value: unknown): Predicate<PredicateColumn<column>>;
+/**
+ * Builds an `IN` predicate.
+ * @param column Column to compare.
+ * @param values Candidate values.
+ * @returns An `in` comparison predicate.
+ */
+export declare function inList<column extends string | ColumnReferenceLike>(column: column, values: readonly unknown[]): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a `NOT IN` predicate.
+ * @param column Column to compare.
+ * @param values Candidate values.
+ * @returns A `notIn` comparison predicate.
+ */
+export declare function notInList<column extends string | ColumnReferenceLike>(column: column, values: readonly unknown[]): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a case-sensitive SQL `LIKE` predicate.
+ * @param column Column to compare.
+ * @param value Match pattern.
+ * @returns A `like` comparison predicate.
+ */
+export declare function like<column extends string | ColumnReferenceLike>(column: column, value: string): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a case-insensitive SQL `LIKE` predicate.
+ * @param column Column to compare.
+ * @param value Match pattern.
+ * @returns An `ilike` comparison predicate.
+ */
+export declare function ilike<column extends string | ColumnReferenceLike>(column: column, value: string): Predicate<PredicateColumn<column>>;
+/**
+ * Builds a `BETWEEN` predicate.
+ * @param column Column to compare.
+ * @param lower Lower bound value.
+ * @param upper Upper bound value.
+ * @returns A `between` predicate.
+ */
+export declare function between<column extends string | ColumnReferenceLike>(column: column, lower: unknown, upper: unknown): Predicate<PredicateColumn<column>>;
+/**
+ * Builds an `IS NULL` predicate.
+ * @param column Column to compare.
+ * @returns An `isNull` predicate.
+ */
+export declare function isNull<column extends string | ColumnReferenceLike>(column: column): Predicate<PredicateColumn<column>>;
+/**
+ * Builds an `IS NOT NULL` predicate.
+ * @param column Column to compare.
+ * @returns A `notNull` predicate.
+ */
+export declare function notNull<column extends string | ColumnReferenceLike>(column: column): Predicate<PredicateColumn<column>>;
+/**
+ * Combines predicates with logical `AND`.
+ * @param predicates Child predicates.
+ * @returns A logical `and` predicate.
+ */
+export declare function and<column extends string>(...predicates: Predicate<column>[]): Predicate<column>;
+/**
+ * Combines predicates with logical `OR`.
+ * @param predicates Child predicates.
+ * @returns A logical `or` predicate.
+ */
+export declare function or<column extends string>(...predicates: Predicate<column>[]): Predicate<column>;
+/**
+ * Returns `true` when a value is a normalized predicate object.
+ * @param value Value to inspect.
+ * @returns Whether the value is a predicate.
+ */
+export declare function isPredicate<column extends string = string>(value: unknown): value is Predicate<column>;
+/**
+ * Normalizes object shorthand into a predicate tree.
+ * @param input Predicate object or shorthand where map.
+ * @returns A normalized predicate.
+ */
+export declare function normalizeWhereInput<column extends string>(input: WhereInput<column>): Predicate<column>;
+/**
+ * Collects referenced columns from a predicate tree.
+ * @param predicate Predicate to inspect.
+ * @returns Referenced column names.
+ */
+export declare function getPredicateColumns(predicate: Predicate): string[];
+export {};
+//# sourceMappingURL=operators.d.ts.map

package/dist/lib/operators.d.ts.map

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

package/dist/lib/operators.js

@@ -0,0 +1,218 @@
+import { isColumnReference, normalizeColumnInput } from "./references.js";
+export function eq(column, value) {
+    return createComparisonPredicate('eq', column, value);
+}
+export function ne(column, value) {
+    return createComparisonPredicate('ne', column, value);
+}
+export function gt(column, value) {
+    return createComparisonPredicate('gt', column, value);
+}
+export function gte(column, value) {
+    return createComparisonPredicate('gte', column, value);
+}
+export function lt(column, value) {
+    return createComparisonPredicate('lt', column, value);
+}
+export function lte(column, value) {
+    return createComparisonPredicate('lte', column, value);
+}
+/**
+ * Builds an `IN` predicate.
+ * @param column Column to compare.
+ * @param values Candidate values.
+ * @returns An `in` comparison predicate.
+ */
+export function inList(column, values) {
+    return {
+        type: 'comparison',
+        operator: 'in',
+        column: resolvePredicateColumn(column),
+        value: [...values],
+        valueType: 'value',
+    };
+}
+/**
+ * Builds a `NOT IN` predicate.
+ * @param column Column to compare.
+ * @param values Candidate values.
+ * @returns A `notIn` comparison predicate.
+ */
+export function notInList(column, values) {
+    return {
+        type: 'comparison',
+        operator: 'notIn',
+        column: resolvePredicateColumn(column),
+        value: [...values],
+        valueType: 'value',
+    };
+}
+/**
+ * Builds a case-sensitive SQL `LIKE` predicate.
+ * @param column Column to compare.
+ * @param value Match pattern.
+ * @returns A `like` comparison predicate.
+ */
+export function like(column, value) {
+    return {
+        type: 'comparison',
+        operator: 'like',
+        column: resolvePredicateColumn(column),
+        value,
+        valueType: 'value',
+    };
+}
+/**
+ * Builds a case-insensitive SQL `LIKE` predicate.
+ * @param column Column to compare.
+ * @param value Match pattern.
+ * @returns An `ilike` comparison predicate.
+ */
+export function ilike(column, value) {
+    return {
+        type: 'comparison',
+        operator: 'ilike',
+        column: resolvePredicateColumn(column),
+        value,
+        valueType: 'value',
+    };
+}
+/**
+ * Builds a `BETWEEN` predicate.
+ * @param column Column to compare.
+ * @param lower Lower bound value.
+ * @param upper Upper bound value.
+ * @returns A `between` predicate.
+ */
+export function between(column, lower, upper) {
+    return {
+        type: 'between',
+        column: resolvePredicateColumn(column),
+        lower,
+        upper,
+    };
+}
+/**
+ * Builds an `IS NULL` predicate.
+ * @param column Column to compare.
+ * @returns An `isNull` predicate.
+ */
+export function isNull(column) {
+    return { type: 'null', operator: 'isNull', column: resolvePredicateColumn(column) };
+}
+/**
+ * Builds an `IS NOT NULL` predicate.
+ * @param column Column to compare.
+ * @returns A `notNull` predicate.
+ */
+export function notNull(column) {
+    return { type: 'null', operator: 'notNull', column: resolvePredicateColumn(column) };
+}
+/**
+ * Combines predicates with logical `AND`.
+ * @param predicates Child predicates.
+ * @returns A logical `and` predicate.
+ */
+export function and(...predicates) {
+    let filtered = predicates.filter(Boolean);
+    return { type: 'logical', operator: 'and', predicates: filtered };
+}
+/**
+ * Combines predicates with logical `OR`.
+ * @param predicates Child predicates.
+ * @returns A logical `or` predicate.
+ */
+export function or(...predicates) {
+    let filtered = predicates.filter(Boolean);
+    return { type: 'logical', operator: 'or', predicates: filtered };
+}
+/**
+ * Returns `true` when a value is a normalized predicate object.
+ * @param value Value to inspect.
+ * @returns Whether the value is a predicate.
+ */
+export function isPredicate(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    if (!('type' in value)) {
+        return false;
+    }
+    let input = value;
+    return (input.type === 'comparison' ||
+        input.type === 'between' ||
+        input.type === 'null' ||
+        input.type === 'logical');
+}
+/**
+ * Normalizes object shorthand into a predicate tree.
+ * @param input Predicate object or shorthand where map.
+ * @returns A normalized predicate.
+ */
+export function normalizeWhereInput(input) {
+    if (isPredicate(input)) {
+        return input;
+    }
+    let keys = Object.keys(input);
+    let predicates = keys.map((column) => eq(column, input[column]));
+    return and(...predicates);
+}
+/**
+ * Collects referenced columns from a predicate tree.
+ * @param predicate Predicate to inspect.
+ * @returns Referenced column names.
+ */
+export function getPredicateColumns(predicate) {
+    if (predicate.type === 'comparison') {
+        if (predicate.valueType === 'column') {
+            return [predicate.column, predicate.value];
+        }
+        return [predicate.column];
+    }
+    if (predicate.type === 'between') {
+        return [predicate.column];
+    }
+    if (predicate.type === 'null') {
+        return [predicate.column];
+    }
+    let columns = [];
+    for (let child of predicate.predicates) {
+        columns.push(...getPredicateColumns(child));
+    }
+    return columns;
+}
+function isQualifiedColumnReference(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    return /^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z_][a-zA-Z0-9_]*)+$/.test(value);
+}
+function resolvePredicateColumn(column) {
+    return normalizeColumnInput(column);
+}
+function resolveComparisonValue(value) {
+    if (isColumnReference(value)) {
+        return normalizeColumnInput(value);
+    }
+    return value;
+}
+function createComparisonPredicate(operator, column, value) {
+    let normalizedColumn = resolvePredicateColumn(column);
+    let normalizedValue = resolveComparisonValue(value);
+    if (isQualifiedColumnReference(normalizedColumn) && isQualifiedColumnReference(normalizedValue)) {
+        return {
+            type: 'comparison',
+            operator,
+            column: normalizedColumn,
+            value: normalizedValue,
+            valueType: 'column',
+        };
+    }
+    return {
+        type: 'comparison',
+        operator,
+        column: normalizedColumn,
+        value: normalizedValue,
+        valueType: 'value',
+    };
+}

package/dist/lib/references.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Symbol key used to store non-enumerable table metadata.
+ */
+export declare const tableMetadataKey: unique symbol;
+/**
+ * Symbol key used to store non-enumerable column metadata.
+ */
+export declare const columnMetadataKey: unique symbol;
+type UnknownTableMetadata<name extends string = string, columns extends Record<string, unknown> = Record<string, unknown>, primaryKey extends readonly string[] = readonly string[], timestamps = unknown> = {
+    name: name;
+    columns: columns;
+    primaryKey: primaryKey;
+    timestamps: timestamps;
+};
+export type TableMetadataLike<name extends string = string, columns extends Record<string, unknown> = Record<string, unknown>, primaryKey extends readonly string[] = readonly string[], timestamps = unknown> = {
+    [tableMetadataKey]: UnknownTableMetadata<name, columns, primaryKey, timestamps>;
+};
+export type ColumnReferenceLike<qualifiedName extends string = string> = {
+    kind: 'column';
+    [columnMetadataKey]: {
+        tableName: string;
+        columnName: string;
+        qualifiedName: qualifiedName;
+        schema: unknown;
+    };
+};
+export type ColumnInput<qualifiedName extends string = string> = qualifiedName | ColumnReferenceLike<qualifiedName>;
+export type NormalizeColumnInput<input> = input extends ColumnReferenceLike<infer qualifiedName> ? qualifiedName : input;
+/**
+ * Returns `true` when a value is a `data-table` column reference.
+ * @param value Value to inspect.
+ * @returns Whether the value is a column reference object.
+ */
+export declare function isColumnReference(value: unknown): value is ColumnReferenceLike;
+/**
+ * Normalizes string/column-reference inputs to a qualified column name.
+ * @param input Column name or column reference.
+ * @returns The normalized qualified column name.
+ */
+export declare function normalizeColumnInput<input extends string | ColumnReferenceLike>(input: input): NormalizeColumnInput<input>;
+export {};
+//# sourceMappingURL=references.d.ts.map

package/dist/lib/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/lib/references.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAAqC,CAAA;AAElE;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAAsC,CAAA;AAEpE,KAAK,oBAAoB,CACvB,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EACxD,UAAU,GAAG,OAAO,IAClB;IACF,IAAI,EAAE,IAAI,CAAA;IACV,OAAO,EAAE,OAAO,CAAA;IAChB,UAAU,EAAE,UAAU,CAAA;IACtB,UAAU,EAAE,UAAU,CAAA;CACvB,CAAA;AAED,MAAM,MAAM,iBAAiB,CAC3B,IAAI,SAAS,MAAM,GAAG,MAAM,EAC5B,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,UAAU,SAAS,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,EACxD,UAAU,GAAG,OAAO,IAClB;IACF,CAAC,gBAAgB,CAAC,EAAE,oBAAoB,CAAC,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,CAAA;CAChF,CAAA;AAED,MAAM,MAAM,mBAAmB,CAAC,aAAa,SAAS,MAAM,GAAG,MAAM,IAAI;IACvE,IAAI,EAAE,QAAQ,CAAA;IACd,CAAC,iBAAiB,CAAC,EAAE;QACnB,SAAS,EAAE,MAAM,CAAA;QACjB,UAAU,EAAE,MAAM,CAAA;QAClB,aAAa,EAAE,aAAa,CAAA;QAC5B,MAAM,EAAE,OAAO,CAAA;KAChB,CAAA;CACF,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,aAAa,SAAS,MAAM,GAAG,MAAM,IACzD,aAAa,GACb,mBAAmB,CAAC,aAAa,CAAC,CAAA;AAEtC,MAAM,MAAM,oBAAoB,CAAC,KAAK,IACpC,KAAK,SAAS,mBAAmB,CAAC,MAAM,aAAa,CAAC,GAAG,aAAa,GAAG,KAAK,CAAA;AAEhF;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,mBAAmB,CAU9E;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,SAAS,MAAM,GAAG,mBAAmB,EAC7E,KAAK,EAAE,KAAK,GACX,oBAAoB,CAAC,KAAK,CAAC,CAM7B"}

package/dist/lib/references.js

@@ -0,0 +1,33 @@
+/**
+ * Symbol key used to store non-enumerable table metadata.
+ */
+export const tableMetadataKey = Symbol('data-table.tableMetadata');
+/**
+ * Symbol key used to store non-enumerable column metadata.
+ */
+export const columnMetadataKey = Symbol('data-table.columnMetadata');
+/**
+ * Returns `true` when a value is a `data-table` column reference.
+ * @param value Value to inspect.
+ * @returns Whether the value is a column reference object.
+ */
+export function isColumnReference(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    if (!('kind' in value) || value.kind !== 'column') {
+        return false;
+    }
+    return columnMetadataKey in value;
+}
+/**
+ * Normalizes string/column-reference inputs to a qualified column name.
+ * @param input Column name or column reference.
+ * @returns The normalized qualified column name.
+ */
+export function normalizeColumnInput(input) {
+    if (typeof input === 'string') {
+        return input;
+    }
+    return input[columnMetadataKey].qualifiedName;
+}

package/dist/lib/sql.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Parameterized SQL payload with positional `?` placeholders.
+ */
+export type SqlStatement = {
+    text: string;
+    values: unknown[];
+};
+/**
+ * Tagged-template helper for building parameterized SQL statements.
+ * @param strings Template string parts.
+ * @param values Interpolated values or nested `SqlStatement` values.
+ * @returns A normalized SQL statement.
+ */
+export declare function sql(strings: TemplateStringsArray, ...values: unknown[]): SqlStatement;
+/**
+ * Returns `true` when a value matches the `SqlStatement` shape.
+ * @param value Value to inspect.
+ * @returns Whether the value is a SQL statement object.
+ */
+export declare function isSqlStatement(value: unknown): value is SqlStatement;
+/**
+ * Creates a SQL statement from raw text and values.
+ * @param text SQL text containing `?` placeholders.
+ * @param values Placeholder values.
+ * @returns A normalized SQL statement.
+ */
+export declare function rawSql(text: string, values?: unknown[]): SqlStatement;
+//# sourceMappingURL=sql.d.ts.map