@remix-run/data-table 0.1.0 → 0.2.1

package/dist/lib/table.js

@@ -1,4 +1,4 @@
-import { createSchema, parseSafe } from '@remix-run/data-schema';
+import { ColumnBuilder } from "./column.js";
 import { inferForeignKey } from "./inflection.js";
 import { normalizeWhereInput } from "./operators.js";
 import { columnMetadataKey, normalizeColumnInput, tableMetadataKey } from "./references.js";
@@ -30,13 +30,70 @@ export function getTableName(table) {
     return table[tableMetadataKey].name;
 }
 /**
- * Returns a table's schema map.
+ * Returns a table's column builder map.
  * @param table Source table instance.
- * @returns Table schema map.
+ * @returns Table column builder map.
  */
 export function getTableColumns(table) {
     return table[tableMetadataKey].columns;
 }
+/**
+ * Returns a table's resolved physical column definitions.
+ * @param table Source table instance.
+ * @returns Column definition map.
+ */
+export function getTableColumnDefinitions(table) {
+    return table[tableMetadataKey].columnDefinitions;
+}
+/**
+ * Returns a table's optional write validator.
+ * @param table Source table instance.
+ * @returns Validation function or `undefined`.
+ */
+export function getTableValidator(table) {
+    return table[tableMetadataKey].validate;
+}
+/**
+ * Returns a table's optional before-write lifecycle callback.
+ * @param table Source table instance.
+ * @returns Before-write callback or `undefined`.
+ */
+export function getTableBeforeWrite(table) {
+    return table[tableMetadataKey].beforeWrite;
+}
+/**
+ * Returns a table's optional after-write lifecycle callback.
+ * @param table Source table instance.
+ * @returns After-write callback or `undefined`.
+ */
+export function getTableAfterWrite(table) {
+    return table[tableMetadataKey].afterWrite;
+}
+/**
+ * Returns a table's optional before-delete lifecycle callback.
+ * @param table Source table instance.
+ * @returns Before-delete callback or `undefined`.
+ */
+export function getTableBeforeDelete(table) {
+    return table[tableMetadataKey].beforeDelete;
+}
+/**
+ * Returns a table's optional after-delete lifecycle callback.
+ * @param table Source table instance.
+ * @returns After-delete callback or `undefined`.
+ */
+export function getTableAfterDelete(table) {
+    return table[tableMetadataKey].afterDelete;
+}
+/**
+ * Returns a table's optional after-read lifecycle callback.
+ * The callback receives the current read shape, which may be a projected partial row.
+ * @param table Source table instance.
+ * @returns After-read callback or `undefined`.
+ */
+export function getTableAfterRead(table) {
+    return table[tableMetadataKey].afterRead;
+}
 /**
  * Returns a table's primary key columns.
  * @param table Source table instance.
@@ -53,71 +110,44 @@ export function getTablePrimaryKey(table) {
 export function getTableTimestamps(table) {
     return table[tableMetadataKey].timestamps;
 }
-let defaultTimestampConfig = {
+const defaultTimestampConfig = {
     createdAt: 'created_at',
     updatedAt: 'updated_at',
 };
-function prefixIssuePath(issue, key) {
-    let issuePath = issue.path ?? [];
-    return {
-        ...issue,
-        path: [key, ...issuePath],
-    };
-}
-function validatePartialRowInput(tableName, columns, value, options) {
-    if (typeof value !== 'object' || value === null || Array.isArray(value)) {
+export function fail(messageOrIssues, path) {
+    if (typeof messageOrIssues === 'string') {
         return {
-            issues: [{ message: 'Expected object' }],
+            issues: [{ message: messageOrIssues, path }],
         };
     }
-    let input = value;
-    let output = {};
-    let issues = [];
-    for (let key in input) {
-        if (!Object.prototype.hasOwnProperty.call(input, key)) {
-            continue;
-        }
-        if (!Object.prototype.hasOwnProperty.call(columns, key)) {
-            issues.push({
-                message: 'Unknown column "' + key + '" for table "' + tableName + '"',
-                path: [key],
-            });
-            continue;
-        }
-        let result = parseSafe(columns[key], input[key], options);
-        if (!result.success) {
-            issues.push(...result.issues.map((issue) => prefixIssuePath(issue, key)));
-            continue;
-        }
-        output[key] = result.value;
-    }
-    if (issues.length > 0) {
-        return { issues };
-    }
-    return { value: output };
-}
-export function validatePartialRow(table, value, options) {
-    let result = validatePartialRowInput(getTableName(table), getTableColumns(table), value, options);
-    if ('issues' in result) {
-        return result;
-    }
     return {
-        value: result.value,
+        issues: [...messageOrIssues],
     };
 }
 /**
  * Creates a table object with symbol-backed metadata and direct column references.
  * @param options Table declaration options.
  * @returns A frozen table object.
+ * @example
+ * ```ts
+ * import { column as c, table } from 'remix/data-table'
+ *
+ * let users = table({
+ *   name: 'users',
+ *   columns: {
+ *     id: c.integer(),
+ *     email: c.varchar(255),
+ *   },
+ *   primaryKey: 'id',
+ * })
+ * ```
  */
-export function createTable(options) {
+export function table(options) {
     let tableName = options.name;
     let columns = options.columns;
-    if (Object.prototype.hasOwnProperty.call(columns, '~standard')) {
-        throw new Error('Column name "~standard" is reserved for table validation on "' + tableName + '"');
-    }
     let resolvedPrimaryKey = normalizePrimaryKey(tableName, columns, options.primaryKey);
     let timestampConfig = normalizeTimestampConfig(options.timestamps);
+    let columnDefinitions = resolveTableColumns(tableName, columns);
     let table = Object.create(null);
     Object.defineProperty(table, tableMetadataKey, {
         value: Object.freeze({
@@ -125,18 +155,13 @@ export function createTable(options) {
             columns,
             primaryKey: resolvedPrimaryKey,
             timestamps: timestampConfig,
-        }),
-        enumerable: false,
-        writable: false,
-        configurable: false,
-    });
-    Object.defineProperty(table, '~standard', {
-        value: Object.freeze({
-            version: 1,
-            vendor: 'data-table',
-            validate(value, parseOptions) {
-                return validatePartialRowInput(tableName, columns, value, parseOptions);
-            },
+            columnDefinitions,
+            beforeWrite: options.beforeWrite,
+            afterWrite: options.afterWrite,
+            beforeDelete: options.beforeDelete,
+            afterDelete: options.afterDelete,
+            afterRead: options.afterRead,
+            validate: options.validate,
         }),
         enumerable: false,
         writable: false,
@@ -146,8 +171,7 @@ export function createTable(options) {
         if (!Object.prototype.hasOwnProperty.call(columns, columnName)) {
             continue;
         }
-        let schema = columns[columnName];
-        let column = createColumnReference(tableName, columnName, schema);
+        let column = createColumnReference(tableName, columnName);
         Object.defineProperty(table, columnName, {
             value: column,
             enumerable: true,
@@ -157,17 +181,34 @@ export function createTable(options) {
     }
     return Object.freeze(table);
 }
-function createColumnReference(tableName, columnName, schema) {
+function createColumnReference(tableName, columnName) {
     return Object.freeze({
         kind: 'column',
         [columnMetadataKey]: Object.freeze({
             tableName,
             columnName,
             qualifiedName: tableName + '.' + columnName,
-            schema,
         }),
     });
 }
+function resolveTableColumns(tableName, columns) {
+    let columnDefinitions = {};
+    for (let columnName in columns) {
+        if (!Object.prototype.hasOwnProperty.call(columns, columnName)) {
+            continue;
+        }
+        let column = columns[columnName];
+        if (!(column instanceof ColumnBuilder)) {
+            throw new Error('Invalid column "' +
+                columnName +
+                '" for table "' +
+                tableName +
+                '". Expected a column(...) builder');
+        }
+        columnDefinitions[columnName] = column.build();
+    }
+    return Object.freeze(columnDefinitions);
+}
 /**
  * Defines a one-to-many relation from `source` to `target`.
  * @param source Source table.
@@ -264,33 +305,15 @@ export function hasManyThrough(source, target, relationOptions) {
         },
     });
 }
-/**
- * Creates a schema that accepts `Date`, string, and numeric timestamp inputs.
- * @returns Timestamp schema for generated timestamp helpers.
- */
-export function timestampSchema() {
-    return createSchema((value) => {
-        if (value instanceof Date) {
-            return { value };
-        }
-        if (typeof value === 'string' || typeof value === 'number') {
-            return { value };
-        }
-        return {
-            issues: [{ message: 'Expected Date, string, or number' }],
-        };
-    });
-}
-let defaultTimestampSchema = timestampSchema();
 /**
  * Convenience helper for standard snake_case timestamp columns.
- * @param schema Schema used for both timestamp columns.
- * @returns Column schema map for `created_at`/`updated_at`.
+ * @returns Column-builder map for `created_at`/`updated_at`.
  */
-export function timestamps(schema = defaultTimestampSchema) {
+export function timestamps() {
+    let timestampColumn = () => new ColumnBuilder({ type: 'timestamp' });
     return {
-        created_at: schema,
-        updated_at: schema,
+        created_at: timestampColumn(),
+        updated_at: timestampColumn(),
     };
 }
 /**
@@ -355,7 +378,7 @@ export function stableSerialize(value) {
 function normalizePrimaryKey(tableName, columns, primaryKey) {
     if (primaryKey === undefined) {
         if (!Object.prototype.hasOwnProperty.call(columns, 'id')) {
-            throw new Error('Table "' + tableName + '" must define an "id" column or an explicit primaryKey');
+            throw new Error('Table "' + tableName + '" must include an "id" column or an explicit primaryKey');
         }
         return ['id'];
     }

package/dist/migrations/node.d.ts

@@ -0,0 +1,2 @@
+export { loadMigrations } from '../lib/migrations-node.ts';
+//# sourceMappingURL=node.d.ts.map

package/dist/migrations/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/migrations/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/migrations/node.js

@@ -0,0 +1 @@
+export { loadMigrations } from "../lib/migrations-node.js";

package/dist/migrations.d.ts

@@ -0,0 +1,8 @@
+export type { AlterTableBuilder, CreateMigrationInput, Migration, MigrationContext, MigrationDescriptor, MigrationDirection, MigrationJournalRow, MigrationSchema, MigrationRegistry, MigrationRunner, MigrationRunnerOptions, MigrationStatus, MigrationStatusEntry, MigrationTransactionMode, MigrateOptions, MigrateResult, KeyColumns, TableInput, } from './lib/migrations.ts';
+export { createMigration } from './lib/migrations.ts';
+export type { ColumnNamespace } from './lib/column.ts';
+export { ColumnBuilder, column } from './lib/column.ts';
+export { createMigrationRegistry } from './lib/migrations/registry.ts';
+export { createMigrationRunner } from './lib/migrations/runner.ts';
+export { parseMigrationFilename } from './lib/migrations/filename.ts';
+//# sourceMappingURL=migrations.d.ts.map

package/dist/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../src/migrations.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACpB,wBAAwB,EACxB,cAAc,EACd,aAAa,EACb,UAAU,EACV,UAAU,GACX,MAAM,qBAAqB,CAAA;AAC5B,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAA;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAA;AAClE,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA"}

package/dist/migrations.js

@@ -0,0 +1,5 @@
+export { createMigration } from "./lib/migrations.js";
+export { ColumnBuilder, column } from "./lib/column.js";
+export { createMigrationRegistry } from "./lib/migrations/registry.js";
+export { createMigrationRunner } from "./lib/migrations/runner.js";
+export { parseMigrationFilename } from "./lib/migrations/filename.js";

package/dist/operators.d.ts

@@ -0,0 +1,3 @@
+export type { Predicate, WhereInput, WhereObject } from './lib/operators.ts';
+export { and, between, eq, gt, gte, ilike, inList, isNull, like, lt, lte, ne, notInList, notNull, or, } from './lib/operators.ts';
+//# sourceMappingURL=operators.d.ts.map

package/dist/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../src/operators.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAC5E,OAAO,EACL,GAAG,EACH,OAAO,EACP,EAAE,EACF,EAAE,EACF,GAAG,EACH,KAAK,EACL,MAAM,EACN,MAAM,EACN,IAAI,EACJ,EAAE,EACF,GAAG,EACH,EAAE,EACF,SAAS,EACT,OAAO,EACP,EAAE,GACH,MAAM,oBAAoB,CAAA"}

package/dist/operators.js

@@ -0,0 +1 @@
+export { and, between, eq, gt, gte, ilike, inList, isNull, like, lt, lte, ne, notInList, notNull, or, } from "./lib/operators.js";

package/dist/sql-helpers.d.ts

@@ -0,0 +1,3 @@
+export type { QuoteIdentifier } from './lib/sql-helpers.ts';
+export { collectColumns, isDataManipulationOperation, normalizeJoinType, quoteLiteral, quotePath, quoteTableRef, } from './lib/sql-helpers.ts';
+//# sourceMappingURL=sql-helpers.d.ts.map

package/dist/sql-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql-helpers.d.ts","sourceRoot":"","sources":["../src/sql-helpers.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EACL,cAAc,EACd,2BAA2B,EAC3B,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,aAAa,GACd,MAAM,sBAAsB,CAAA"}

package/dist/sql-helpers.js

@@ -0,0 +1 @@
+export { collectColumns, isDataManipulationOperation, normalizeJoinType, quoteLiteral, quotePath, quoteTableRef, } from "./lib/sql-helpers.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@remix-run/data-table",
-  "version": "0.1.0",
-  "description": "A typed, relational query toolkit for Remix",
+  "version": "0.2.1",
+  "description": "A typed, relational query toolkit for JavaScript",
   "author": "Michael Jackson <mjijackson@gmail.com>",
   "license": "MIT",
   "repository": {
@@ -24,18 +24,31 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./migrations": {
+      "types": "./dist/migrations.d.ts",
+      "default": "./dist/migrations.js"
+    },
+    "./migrations/node": {
+      "types": "./dist/migrations/node.d.ts",
+      "default": "./dist/migrations/node.js"
+    },
+    "./operators": {
+      "types": "./dist/operators.d.ts",
+      "default": "./dist/operators.js"
+    },
+    "./sql-helpers": {
+      "types": "./dist/sql-helpers.d.ts",
+      "default": "./dist/sql-helpers.js"
+    },
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^24.6.0",
     "@typescript/native-preview": "7.0.0-dev.20251125.1",
-    "better-sqlite3": "^12.4.1",
-    "@remix-run/data-schema": "0.1.0"
-  },
-  "dependencies": {
-    "@remix-run/data-schema": "^0.1.0"
+    "@remix-run/assert": "0.2.0",
+    "@remix-run/test": "0.3.0"
   },
+  "dependencies": {},
   "keywords": [
     "remix",
     "orm",
@@ -47,8 +60,9 @@
   "scripts": {
     "build": "tsgo -p tsconfig.build.json",
     "clean": "git clean -fdX",
-    "test": "node --disable-warning=ExperimentalWarning --test",
-    "test:coverage": "node --disable-warning=ExperimentalWarning --experimental-test-coverage --test-coverage-include='src/lib/operators.ts' --test-coverage-include='src/lib/references.ts' --test-coverage-include='src/lib/inflection.ts' --test-coverage-include='src/lib/sql.ts' --test-coverage-include='src/lib/errors.ts' --test-coverage-lines=90 --test-coverage-branches=90 --test-coverage-functions=90 --test ./src/lib/operators.test.ts ./src/lib/references.test.ts ./src/lib/inflection.test.ts ./src/lib/sql.test.ts ./src/lib/errors.test.ts",
+    "test": "remix-test",
+    "test:bun": "bun x --bun remix-test",
+    "test:coverage": "remix-test --coverage",
     "typecheck": "tsgo --noEmit"
   }
 }

package/src/index.ts

@@ -1,12 +1,66 @@
 export type {
   AdapterCapabilityOverrides,
   AdapterCapabilities,
-  AdapterExecuteRequest,
-  AdapterResult,
-  AdapterStatement,
+  DataManipulationRequest,
+  DataMigrationRequest,
+  AddCheckChange,
+  AddCheckOperation,
+  AddColumnChange,
+  AddForeignKeyChange,
+  AddForeignKeyOperation,
+  AddPrimaryKeyChange,
+  AddUniqueChange,
+  AlterTableChange,
+  AlterTableOperation,
+  ChangeColumnChange,
+  CheckConstraint,
+  ColumnCheck,
+  ColumnComputed,
+  ColumnDefault,
+  ColumnDefinition,
+  ColumnTypeName,
+  CountOperation,
+  CreateIndexOperation,
+  CreateTableOperation,
+  DataMigrationResult,
+  DataMigrationOperation,
+  DataManipulationResult,
+  DataManipulationOperation,
+  DeleteOperation,
   DatabaseAdapter,
+  DropCheckChange,
+  DropCheckOperation,
+  DropColumnChange,
+  DropForeignKeyChange,
+  DropForeignKeyOperation,
+  DropIndexOperation,
+  DropPrimaryKeyChange,
+  DropTableOperation,
+  DropUniqueChange,
+  ExistsOperation,
+  ForeignKeyAction,
+  ForeignKeyConstraint,
+  IndexDefinition,
+  IndexMethod,
+  InsertManyOperation,
+  InsertOperation,
+  JoinClause,
+  JoinType,
+  PrimaryKeyConstraint,
+  RawOperation,
+  RenameColumnChange,
+  RenameIndexOperation,
+  RenameTableOperation,
+  ReturningSelection,
+  SelectColumn,
+  SelectOperation,
+  SetTableCommentChange,
+  TableRef,
   TransactionOptions,
   TransactionToken,
+  UniqueConstraint,
+  UpdateOperation,
+  UpsertOperation,
 } from './lib/adapter.ts'
 
 export {
@@ -24,7 +78,6 @@ export type {
   BelongsToOptions,
   ColumnReference,
   ColumnReferenceForQualifiedName,
-  ColumnSchemas,
   HasManyOptions,
   HasManyThroughOptions,
   HasOneOptions,
@@ -37,33 +90,64 @@ export type {
   RelationKind,
   RelationMapForTable,
   Table,
+  TableAfterDelete,
+  TableAfterDeleteContext,
+  TableAfterRead,
+  TableAfterReadContext,
+  TableAfterReadResult,
+  TableAfterWrite,
+  TableAfterWriteContext,
+  TableBeforeDelete,
+  TableBeforeDeleteContext,
+  TableBeforeDeleteResult,
+  TableBeforeWrite,
+  TableBeforeWriteContext,
+  TableBeforeWriteResult,
   TableColumnInput,
   TableColumnName,
   TableColumns,
+  TableLifecycleOperation,
   TableName,
   TablePrimaryKey,
   TableReference,
   TableRow,
   TableRowWith,
+  TableColumnsDefinition,
+  TableValidate,
+  TableValidationContext,
+  TableWriteOperation,
+  TableValidationOperation,
+  TableValidationResult,
   TimestampConfig,
   TimestampOptions,
+  ValidationFailure,
+  ValidationIssue,
 } from './lib/table.ts'
 export {
   belongsTo,
   columnMetadataKey,
-  createTable,
+  fail,
   getTableColumns,
+  getTableColumnDefinitions,
+  getTableBeforeDelete,
+  getTableBeforeWrite,
+  getTableAfterDelete,
+  getTableAfterRead,
+  getTableAfterWrite,
   getTableName,
   getTablePrimaryKey,
   getTableReference,
   getTableTimestamps,
+  getTableValidator,
   hasMany,
   hasManyThrough,
   hasOne,
+  table,
   tableMetadataKey,
-  timestampSchema,
   timestamps,
 } from './lib/table.ts'
+export type { ColumnNamespace } from './lib/column.ts'
+export { ColumnBuilder, column } from './lib/column.ts'
 
 export type { Predicate, WhereInput, WhereObject } from './lib/operators.ts'
 export {
@@ -93,16 +177,13 @@ export type {
   CreateManyRowsOptions,
   CreateResultOptions,
   CreateRowOptions,
-  Database,
   DeleteManyOptions,
   FindManyOptions,
   FindOneOptions,
   OrderByInput,
   OrderByTuple,
-  QueryBuilderFor,
   QueryColumnTypesForTable,
   QueryForTable,
-  QueryMethod,
   QueryTableInput,
   SingleTableColumn,
   SingleTableWhere,
@@ -112,4 +193,6 @@ export type {
   WriteRowResult,
   WriteRowsResult,
 } from './lib/database.ts'
-export { createDatabase, QueryBuilder } from './lib/database.ts'
+export { createDatabase, Database } from './lib/database.ts'
+export type { AnyQuery } from './lib/query.ts'
+export { Query, query } from './lib/query.ts'