@remix-run/data-table 0.0.0 → 0.2.0

package/dist/lib/column.d.ts

@@ -0,0 +1,193 @@
+import type { ColumnDefinition, ForeignKeyAction, IdentityOptions } from './adapter.ts';
+/**
+ * Chainable builder used to describe physical column definitions.
+ */
+export declare class ColumnBuilder<output = unknown> {
+    #private;
+    constructor(definition: ColumnDefinition);
+    /**
+     * Marks the column as nullable.
+     * @returns The column builder with `null` added to its output type.
+     */
+    nullable(): ColumnBuilder<output | null>;
+    /**
+     * Marks the column as non-nullable.
+     * @returns The column builder with `null` removed from its output type.
+     */
+    notNull(): ColumnBuilder<Exclude<output, null>>;
+    /**
+     * Sets a literal default value for the column.
+     * @param value Default value to apply when the column is omitted.
+     * @returns The column builder.
+     */
+    default(value: unknown): ColumnBuilder<output>;
+    /**
+     * Sets the column default to the current timestamp at write time.
+     * @returns The column builder.
+     */
+    defaultNow(): ColumnBuilder<output>;
+    /**
+     * Sets a raw SQL expression as the column default.
+     * @param expression SQL expression used as the default value.
+     * @returns The column builder.
+     */
+    defaultSql(expression: string): ColumnBuilder<output>;
+    /**
+     * Marks the column as part of the primary key.
+     * @returns The column builder.
+     */
+    primaryKey(): ColumnBuilder<output>;
+    /**
+     * Marks the column as unique.
+     * @param name Optional constraint name.
+     * @returns The column builder.
+     */
+    unique(name?: string): ColumnBuilder<output>;
+    /**
+     * Adds a foreign-key reference for the column.
+     * @param table Referenced table name.
+     * @param name Constraint name.
+     * @returns The column builder.
+     */
+    references(table: string, name: string): ColumnBuilder<output>;
+    /**
+     * Adds a foreign-key reference for the column.
+     * @param table Referenced table name.
+     * @param columns Referenced column list.
+     * @param name Constraint name.
+     * @returns The column builder.
+     */
+    references(table: string, columns: string | string[], name: string): ColumnBuilder<output>;
+    /**
+     * Sets the foreign-key action used when the referenced row is deleted.
+     * @param action Delete action to apply.
+     * @returns The column builder.
+     */
+    onDelete(action: ForeignKeyAction): ColumnBuilder<output>;
+    /**
+     * Sets the foreign-key action used when the referenced row is updated.
+     * @param action Update action to apply.
+     * @returns The column builder.
+     */
+    onUpdate(action: ForeignKeyAction): ColumnBuilder<output>;
+    /**
+     * Adds a check constraint for the column.
+     * @param expression SQL check expression.
+     * @param name Constraint name.
+     * @returns The column builder.
+     */
+    check(expression: string, name: string): ColumnBuilder<output>;
+    /**
+     * Adds a database comment for the column.
+     * @param text Comment text.
+     * @returns The column builder.
+     */
+    comment(text: string): ColumnBuilder<output>;
+    /**
+     * Marks the column as computed from a SQL expression.
+     * @param expression SQL expression for the computed value.
+     * @param options Computed-column options.
+     * @param options.stored Whether the computed column should be stored instead of virtual.
+     * @returns The column builder.
+     */
+    computed(expression: string, options?: {
+        stored?: boolean;
+    }): ColumnBuilder<output>;
+    /**
+     * Marks the column as unsigned when the dialect supports it.
+     * @returns The column builder.
+     */
+    unsigned(): ColumnBuilder<output>;
+    /**
+     * Marks the column as auto-incrementing when the dialect supports it.
+     * @returns The column builder.
+     */
+    autoIncrement(): ColumnBuilder<output>;
+    /**
+     * Configures an identity column strategy when the dialect supports it.
+     * @param options Identity sequence options.
+     * @returns The column builder.
+     */
+    identity(options?: IdentityOptions): ColumnBuilder<output>;
+    /**
+     * Sets the collation for the column.
+     * @param name Collation name.
+     * @returns The column builder.
+     */
+    collate(name: string): ColumnBuilder<output>;
+    /**
+     * Sets the character set for the column.
+     * @param name Character set name.
+     * @returns The column builder.
+     */
+    charset(name: string): ColumnBuilder<output>;
+    /**
+     * Sets the column length.
+     * @param value Maximum length value.
+     * @returns The column builder.
+     */
+    length(value: number): ColumnBuilder<output>;
+    /**
+     * Sets numeric precision and optional scale for the column.
+     * @param value Precision value.
+     * @param scale Optional scale value.
+     * @returns The column builder.
+     */
+    precision(value: number, scale?: number): ColumnBuilder<output>;
+    /**
+     * Sets numeric scale for the column.
+     * @param value Scale value.
+     * @returns The column builder.
+     */
+    scale(value: number): ColumnBuilder<output>;
+    /**
+     * Enables or disables timezone support for time-based columns.
+     * @param enabled Whether timezone support should be enabled.
+     * @returns The column builder.
+     */
+    timezone(enabled?: boolean): ColumnBuilder<output>;
+    /**
+     * Builds the immutable column definition.
+     * @returns A normalized column definition.
+     */
+    build(): ColumnDefinition;
+}
+/** Resolves the runtime output type from a column builder. */
+export type ColumnOutput<column extends ColumnBuilder<any>> = column extends ColumnBuilder<infer output> ? output : never;
+/** Input type accepted when writing values for a column builder. */
+export type ColumnInput<column extends ColumnBuilder<any>> = ColumnOutput<column>;
+/**
+ * Public constructor namespace for column builders.
+ */
+export type ColumnNamespace = {
+    varchar(length: number): ColumnBuilder<string>;
+    text(): ColumnBuilder<string>;
+    integer(): ColumnBuilder<number>;
+    bigint(): ColumnBuilder;
+    decimal(precision: number, scale: number): ColumnBuilder<number>;
+    boolean(): ColumnBuilder<boolean>;
+    uuid(): ColumnBuilder<string>;
+    date(): ColumnBuilder;
+    time(options?: {
+        precision?: number;
+        withTimezone?: boolean;
+    }): ColumnBuilder;
+    timestamp(options?: {
+        precision?: number;
+        withTimezone?: boolean;
+    }): ColumnBuilder;
+    json(): ColumnBuilder;
+    binary(length?: number): ColumnBuilder;
+    enum<values extends readonly string[]>(values: values): ColumnBuilder<values[number]>;
+};
+/**
+ * Chainable column builder namespace.
+ * @example
+ * ```ts
+ * import { column as c } from 'remix/data-table'
+ *
+ * let email = c.varchar(255).notNull().unique('users_email_uq')
+ * ```
+ */
+export declare const column: ColumnNamespace;
+//# sourceMappingURL=column.d.ts.map

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

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

package/dist/lib/column.js

@@ -0,0 +1,302 @@
+import { toTableRef } from "./migrations/helpers.js";
+/**
+ * Chainable builder used to describe physical column definitions.
+ */
+export class ColumnBuilder {
+    #definition;
+    constructor(definition) {
+        this.#definition = definition;
+    }
+    /**
+     * Marks the column as nullable.
+     * @returns The column builder with `null` added to its output type.
+     */
+    nullable() {
+        this.#definition.nullable = true;
+        return this;
+    }
+    /**
+     * Marks the column as non-nullable.
+     * @returns The column builder with `null` removed from its output type.
+     */
+    notNull() {
+        this.#definition.nullable = false;
+        return this;
+    }
+    /**
+     * Sets a literal default value for the column.
+     * @param value Default value to apply when the column is omitted.
+     * @returns The column builder.
+     */
+    default(value) {
+        this.#definition.default = {
+            kind: 'literal',
+            value,
+        };
+        return this;
+    }
+    /**
+     * Sets the column default to the current timestamp at write time.
+     * @returns The column builder.
+     */
+    defaultNow() {
+        this.#definition.default = {
+            kind: 'now',
+        };
+        return this;
+    }
+    /**
+     * Sets a raw SQL expression as the column default.
+     * @param expression SQL expression used as the default value.
+     * @returns The column builder.
+     */
+    defaultSql(expression) {
+        this.#definition.default = {
+            kind: 'sql',
+            expression,
+        };
+        return this;
+    }
+    /**
+     * Marks the column as part of the primary key.
+     * @returns The column builder.
+     */
+    primaryKey() {
+        this.#definition.primaryKey = true;
+        return this;
+    }
+    /**
+     * Marks the column as unique.
+     * @param name Optional constraint name.
+     * @returns The column builder.
+     */
+    unique(name) {
+        this.#definition.unique = name ? { name } : true;
+        return this;
+    }
+    references(table, columnsOrName, maybeName) {
+        let columns = maybeName === undefined ? 'id' : columnsOrName;
+        let name = maybeName === undefined ? String(columnsOrName) : maybeName;
+        this.#definition.references = {
+            table: toTableRef(table),
+            columns: Array.isArray(columns) ? [...columns] : [columns],
+            onDelete: this.#definition.references?.onDelete,
+            onUpdate: this.#definition.references?.onUpdate,
+            name,
+        };
+        return this;
+    }
+    /**
+     * Sets the foreign-key action used when the referenced row is deleted.
+     * @param action Delete action to apply.
+     * @returns The column builder.
+     */
+    onDelete(action) {
+        if (!this.#definition.references) {
+            throw new Error('onDelete() requires references() to be set first');
+        }
+        this.#definition.references.onDelete = action;
+        return this;
+    }
+    /**
+     * Sets the foreign-key action used when the referenced row is updated.
+     * @param action Update action to apply.
+     * @returns The column builder.
+     */
+    onUpdate(action) {
+        if (!this.#definition.references) {
+            throw new Error('onUpdate() requires references() to be set first');
+        }
+        this.#definition.references.onUpdate = action;
+        return this;
+    }
+    /**
+     * Adds a check constraint for the column.
+     * @param expression SQL check expression.
+     * @param name Constraint name.
+     * @returns The column builder.
+     */
+    check(expression, name) {
+        let checks = this.#definition.checks ?? [];
+        checks.push({ expression, name });
+        this.#definition.checks = checks;
+        return this;
+    }
+    /**
+     * Adds a database comment for the column.
+     * @param text Comment text.
+     * @returns The column builder.
+     */
+    comment(text) {
+        this.#definition.comment = text;
+        return this;
+    }
+    /**
+     * Marks the column as computed from a SQL expression.
+     * @param expression SQL expression for the computed value.
+     * @param options Computed-column options.
+     * @param options.stored Whether the computed column should be stored instead of virtual.
+     * @returns The column builder.
+     */
+    computed(expression, options) {
+        this.#definition.computed = {
+            expression,
+            stored: options?.stored ?? true,
+        };
+        return this;
+    }
+    /**
+     * Marks the column as unsigned when the dialect supports it.
+     * @returns The column builder.
+     */
+    unsigned() {
+        this.#definition.unsigned = true;
+        return this;
+    }
+    /**
+     * Marks the column as auto-incrementing when the dialect supports it.
+     * @returns The column builder.
+     */
+    autoIncrement() {
+        this.#definition.autoIncrement = true;
+        return this;
+    }
+    /**
+     * Configures an identity column strategy when the dialect supports it.
+     * @param options Identity sequence options.
+     * @returns The column builder.
+     */
+    identity(options) {
+        this.#definition.identity = options ?? {};
+        return this;
+    }
+    /**
+     * Sets the collation for the column.
+     * @param name Collation name.
+     * @returns The column builder.
+     */
+    collate(name) {
+        this.#definition.collate = name;
+        return this;
+    }
+    /**
+     * Sets the character set for the column.
+     * @param name Character set name.
+     * @returns The column builder.
+     */
+    charset(name) {
+        this.#definition.charset = name;
+        return this;
+    }
+    /**
+     * Sets the column length.
+     * @param value Maximum length value.
+     * @returns The column builder.
+     */
+    length(value) {
+        this.#definition.length = value;
+        return this;
+    }
+    /**
+     * Sets numeric precision and optional scale for the column.
+     * @param value Precision value.
+     * @param scale Optional scale value.
+     * @returns The column builder.
+     */
+    precision(value, scale) {
+        this.#definition.precision = value;
+        if (scale !== undefined) {
+            this.#definition.scale = scale;
+        }
+        return this;
+    }
+    /**
+     * Sets numeric scale for the column.
+     * @param value Scale value.
+     * @returns The column builder.
+     */
+    scale(value) {
+        this.#definition.scale = value;
+        return this;
+    }
+    /**
+     * Enables or disables timezone support for time-based columns.
+     * @param enabled Whether timezone support should be enabled.
+     * @returns The column builder.
+     */
+    timezone(enabled = true) {
+        this.#definition.withTimezone = enabled;
+        return this;
+    }
+    /**
+     * Builds the immutable column definition.
+     * @returns A normalized column definition.
+     */
+    build() {
+        return {
+            ...this.#definition,
+            checks: this.#definition.checks ? [...this.#definition.checks] : undefined,
+        };
+    }
+}
+function createColumnBuilder(type) {
+    return new ColumnBuilder({ type });
+}
+/**
+ * Chainable column builder namespace.
+ * @example
+ * ```ts
+ * import { column as c } from 'remix/data-table'
+ *
+ * let email = c.varchar(255).notNull().unique('users_email_uq')
+ * ```
+ */
+export const column = {
+    varchar(length) {
+        return new ColumnBuilder({ type: 'varchar', length });
+    },
+    text() {
+        return createColumnBuilder('text');
+    },
+    integer() {
+        return createColumnBuilder('integer');
+    },
+    bigint() {
+        return createColumnBuilder('bigint');
+    },
+    decimal(precision, scale) {
+        return new ColumnBuilder({ type: 'decimal', precision, scale });
+    },
+    boolean() {
+        return createColumnBuilder('boolean');
+    },
+    uuid() {
+        return createColumnBuilder('uuid');
+    },
+    date() {
+        return createColumnBuilder('date');
+    },
+    time(options) {
+        return new ColumnBuilder({
+            type: 'time',
+            precision: options?.precision,
+            withTimezone: options?.withTimezone,
+        });
+    },
+    timestamp(options) {
+        return new ColumnBuilder({
+            type: 'timestamp',
+            precision: options?.precision,
+            withTimezone: options?.withTimezone,
+        });
+    },
+    json() {
+        return createColumnBuilder('json');
+    },
+    binary(length) {
+        return new ColumnBuilder({ type: 'binary', length });
+    },
+    enum(values) {
+        return new ColumnBuilder({ type: 'enum', enumValues: [...values] });
+    },
+};

package/dist/lib/database/execution-context.d.ts

@@ -0,0 +1,10 @@
+import type { DataManipulationOperation, DataManipulationResult, DatabaseAdapter } from '../adapter.ts';
+import type { Database } from '../database.ts';
+export declare const executeOperation: unique symbol;
+export type QueryExecutionContext = {
+    adapter: DatabaseAdapter;
+    now(): unknown;
+    transaction<result>(callback: (database: Database) => Promise<result>): Promise<result>;
+    [executeOperation](operation: DataManipulationOperation): Promise<DataManipulationResult>;
+};
+//# sourceMappingURL=execution-context.d.ts.map

package/dist/lib/database/execution-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.d.ts","sourceRoot":"","sources":["../../../src/lib/database/execution-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACtB,eAAe,EAChB,MAAM,eAAe,CAAA;AACtB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAE9C,eAAO,MAAM,gBAAgB,eAA6B,CAAA;AAE1D,MAAM,MAAM,qBAAqB,GAAG;IAClC,OAAO,EAAE,eAAe,CAAA;IACxB,GAAG,IAAI,OAAO,CAAA;IACd,WAAW,CAAC,MAAM,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IACvF,CAAC,gBAAgB,CAAC,CAAC,SAAS,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAA;CAC1F,CAAA"}

package/dist/lib/database/execution-context.js

@@ -0,0 +1 @@
+export const executeOperation = Symbol('executeOperation');

package/dist/lib/database/helpers.d.ts

@@ -0,0 +1,26 @@
+import type { OrderByInput, OrderByTuple, QueryTableInput, SingleTableWhere, TableColumnName, WriteResult, WriteRowsResult } from '../database.ts';
+import type { Predicate } from '../operators.ts';
+import type { AnyTable, PrimaryKeyInput, TableName, TablePrimaryKey, TableRow } from '../table.ts';
+import type { QueryExecutionContext } from './execution-context.ts';
+export declare function asQueryTableInput<table extends AnyTable>(table: table): QueryTableInput<TableName<table>, TableRow<table>, TablePrimaryKey<table>>;
+export declare function getPrimaryKeyWhere<table extends AnyTable>(table: table, value: PrimaryKeyInput<table>): SingleTableWhere<table>;
+export declare function getPrimaryKeyWhereFromRow<table extends AnyTable>(table: table, row: Record<string, unknown>): SingleTableWhere<table>;
+export declare function resolveCreateRowWhere<table extends AnyTable>(table: table, values: Partial<TableRow<table>>, insertId: unknown): SingleTableWhere<table>;
+export declare function normalizeOrderByInput<table extends AnyTable>(input: OrderByInput<table> | undefined): OrderByTuple<table>[];
+export declare function toWriteResult(result: WriteResult | WriteRowsResult<unknown>): WriteResult;
+export declare function hasScopedWriteModifiers(state: {
+    orderBy: unknown[];
+    limit?: number;
+    offset?: number;
+}): boolean;
+export declare function loadPrimaryKeyRowsForScope<table extends AnyTable>(database: QueryExecutionContext, table: table, state: {
+    where: Predicate<string>[];
+    orderBy: Array<{
+        column: string;
+        direction: 'asc' | 'desc';
+    }>;
+    limit?: number;
+    offset?: number;
+}): Promise<Record<string, unknown>[]>;
+export declare function buildPrimaryKeyPredicate<table extends AnyTable>(table: table, keyObjects: Record<string, unknown>[]): Predicate<TableColumnName<table>> | undefined;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/lib/database/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/lib/database/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EAIZ,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,eAAe,EAChB,MAAM,gBAAgB,CAAA;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,SAAS,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAGlG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAGnE,wBAAgB,iBAAiB,CAAC,KAAK,SAAS,QAAQ,EACtD,KAAK,EAAE,KAAK,GACX,eAAe,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAM5E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,SAAS,QAAQ,EACvD,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,GAC5B,gBAAgB,CAAC,KAAK,CAAC,CAEzB;AAED,wBAAgB,yBAAyB,CAAC,KAAK,SAAS,QAAQ,EAC9D,KAAK,EAAE,KAAK,EACZ,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC3B,gBAAgB,CAAC,KAAK,CAAC,CAQzB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,QAAQ,EAC1D,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAChC,QAAQ,EAAE,OAAO,GAChB,gBAAgB,CAAC,KAAK,CAAC,CAkCzB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,SAAS,QAAQ,EAC1D,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,SAAS,GACrC,YAAY,CAAC,KAAK,CAAC,EAAE,CAcvB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,WAAW,CAKzF;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE;IAC7C,OAAO,EAAE,OAAO,EAAE,CAAA;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GAAG,OAAO,CAEV;AAED,wBAAsB,0BAA0B,CAAC,KAAK,SAAS,QAAQ,EACrE,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE;IACL,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,CAAA;IAC1B,OAAO,EAAE,KAAK,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAA;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB,GACA,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAuCpC;AAED,wBAAgB,wBAAwB,CAAC,KAAK,SAAS,QAAQ,EAC7D,KAAK,EAAE,KAAK,EACZ,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GACpC,SAAS,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAyB/C"}

package/dist/lib/database/helpers.js

@@ -0,0 +1,116 @@
+import { DataTableQueryError } from "../errors.js";
+import { and, eq, inList, or } from "../operators.js";
+import { query as createQuery } from "../query.js";
+import { getPrimaryKeyObject, getTableName, getTablePrimaryKey } from "../table.js";
+import { loadRowsWithRelationsForQuery } from "./query-execution.js";
+export function asQueryTableInput(table) {
+    return table;
+}
+export function getPrimaryKeyWhere(table, value) {
+    return getPrimaryKeyObject(table, value);
+}
+export function getPrimaryKeyWhereFromRow(table, row) {
+    let where = {};
+    for (let key of getTablePrimaryKey(table)) {
+        where[key] = row[key];
+    }
+    return where;
+}
+export function resolveCreateRowWhere(table, values, insertId) {
+    let primaryKey = getTablePrimaryKey(table);
+    if (primaryKey.length === 1) {
+        let key = primaryKey[0];
+        if (Object.prototype.hasOwnProperty.call(values, key)) {
+            return {
+                [key]: values[key],
+            };
+        }
+        if (insertId !== undefined) {
+            return {
+                [key]: insertId,
+            };
+        }
+    }
+    let where = {};
+    for (let key of primaryKey) {
+        if (!Object.prototype.hasOwnProperty.call(values, key)) {
+            throw new DataTableQueryError('create({ returnRow: true }) requires primary key values for table "' +
+                getTableName(table) +
+                '" when adapter does not support RETURNING');
+        }
+        where[key] = values[key];
+    }
+    return where;
+}
+export function normalizeOrderByInput(input) {
+    if (!input) {
+        return [];
+    }
+    if (input.length === 0) {
+        return [];
+    }
+    if (Array.isArray(input[0])) {
+        return input;
+    }
+    return [input];
+}
+export function toWriteResult(result) {
+    return {
+        affectedRows: result.affectedRows,
+        insertId: result.insertId,
+    };
+}
+export function hasScopedWriteModifiers(state) {
+    return state.orderBy.length > 0 || state.limit !== undefined || state.offset !== undefined;
+}
+export async function loadPrimaryKeyRowsForScope(database, table, state) {
+    let query = createQuery(table);
+    for (let predicate of state.where) {
+        query = query.where(predicate);
+    }
+    for (let clause of state.orderBy) {
+        query = query.orderBy(clause.column, clause.direction);
+    }
+    if (state.limit !== undefined) {
+        query = query.limit(state.limit);
+    }
+    if (state.offset !== undefined) {
+        query = query.offset(state.offset);
+    }
+    let rows = await loadRowsWithRelationsForQuery(database, query.select(...getTablePrimaryKey(table)));
+    let primaryKeys = getTablePrimaryKey(table);
+    return rows.map((row) => {
+        let keyObject = {};
+        for (let key of rowKeys(row, primaryKeys)) {
+            keyObject[key] = row[key];
+        }
+        return keyObject;
+    });
+}
+export function buildPrimaryKeyPredicate(table, keyObjects) {
+    let primaryKey = getTablePrimaryKey(table);
+    if (keyObjects.length === 0) {
+        return undefined;
+    }
+    if (primaryKey.length === 1) {
+        let key = primaryKey[0];
+        return inList(key, keyObjects.map((objectValue) => objectValue[key]));
+    }
+    let predicates = keyObjects.map((objectValue) => {
+        let comparisons = primaryKey.map((key) => {
+            let typedKey = key;
+            return eq(typedKey, objectValue[typedKey]);
+        });
+        return and(...comparisons);
+    });
+    return or(...predicates);
+}
+function rowKeys(row, keys) {
+    let output = [];
+    for (let key of keys) {
+        if (Object.prototype.hasOwnProperty.call(row, key)) {
+            output.push(key);
+        }
+    }
+    return output;
+}

package/dist/lib/database/query-execution.d.ts

@@ -0,0 +1,7 @@
+import type { AnyQuery, QueryExecutionResult, QueryState } from '../query.ts';
+import type { AnyTable } from '../table.ts';
+import { type QueryExecutionContext } from './execution-context.ts';
+export declare function executeQuery<input extends AnyQuery>(database: QueryExecutionContext, input: input): Promise<QueryExecutionResult<input>>;
+export declare function loadRowsWithRelationsForQuery(database: QueryExecutionContext, input: AnyQuery): Promise<Record<string, unknown>[]>;
+export declare function loadRowsWithRelationsForState(database: QueryExecutionContext, table: AnyTable, state: QueryState): Promise<Record<string, unknown>[]>;
+//# sourceMappingURL=query-execution.d.ts.map

package/dist/lib/database/query-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-execution.d.ts","sourceRoot":"","sources":["../../../src/lib/database/query-execution.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,QAAQ,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAE7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAA;AAG3C,OAAO,EAAoB,KAAK,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAmBrF,wBAAsB,YAAY,CAAC,KAAK,SAAS,QAAQ,EACvD,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,KAAK,GACX,OAAO,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,CA0EtC;AAED,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,QAAQ,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAGpC;AAED,wBAAsB,6BAA6B,CACjD,QAAQ,EAAE,qBAAqB,EAC/B,KAAK,EAAE,QAAQ,EACf,KAAK,EAAE,UAAU,GAChB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAUpC"}