@vertz/db 0.2.12 → 0.2.13

package/dist/internals.d.ts

@@ -1,3 +1,10 @@
+/**
+* The query function type expected by the migration runner.
+*/
+type MigrationQueryFn = (sql: string, params: readonly unknown[]) => Promise<{
+	rows: readonly Record<string, unknown>[];
+	rowCount: number;
+}>;
 interface JsonbValidator<T> {
 	parse(value: unknown): T;
 }
@@ -10,11 +17,6 @@ interface ColumnMetadata {
 	readonly _annotations: Record<string, true>;
 	readonly isReadOnly: boolean;
 	readonly isAutoUpdate: boolean;
-	readonly isTenant: boolean;
-	readonly references: {
-		readonly table: string;
-		readonly column: string;
-	} | null;
 	readonly check: string | null;
 	readonly defaultValue?: unknown;
 	readonly format?: string;
@@ -65,18 +67,15 @@ interface ColumnBuilder<
 	check(sql: string): ColumnBuilder<TType, Omit<TMeta, "check"> & {
 		readonly check: string;
 	}>;
-	references(table: string, column?: string): ColumnBuilder<TType, Omit<TMeta, "references"> & {
-		readonly references: {
-			readonly table: string;
-			readonly column: string;
-		};
-	}>;
 }
 type InferColumnType<C> = C extends ColumnBuilder<infer T, ColumnMetadata> ? T : never;
+type IndexType = "btree" | "hash" | "gin" | "gist" | "brin";
 interface IndexDef {
 	readonly columns: readonly string[];
 	readonly name?: string;
 	readonly unique?: boolean;
+	readonly type?: IndexType;
+	readonly where?: string;
 }
 /** A record of column builders -- the shape passed to d.table(). */
 type ColumnRecord = Record<string, ColumnBuilder<unknown, ColumnMetadata>>;
@@ -170,6 +169,8 @@ interface IndexSnapshot {
 	columns: string[];
 	name?: string;
 	unique?: boolean;
+	type?: IndexType;
+	where?: string;
 }
 interface ForeignKeySnapshot {
 	column: string;
@@ -196,6 +197,34 @@ interface SnapshotStorage {
 	save(key: string, snapshot: SchemaSnapshot): Promise<void>;
 }
 /**
+* Options for autoMigrate.
+*/
+interface AutoMigrateOptions {
+	/** The current schema snapshot (from d.table() definitions). */
+	currentSchema: SchemaSnapshot;
+	/** Key for snapshot persistence (file path for NodeSnapshotStorage, or any string key for custom backends). */
+	snapshotPath: string;
+	/** Database dialect - currently only 'sqlite' is supported. */
+	dialect: "sqlite";
+	/** Database connection that can execute SQL queries. */
+	db: MigrationQueryFn;
+	/** Optional storage adapter. Defaults to NodeSnapshotStorage. */
+	storage?: SnapshotStorage;
+}
+/**
+* Auto-migrate the database schema.
+*
+* This function:
+* 1. Loads the previous snapshot from disk (if any)
+* 2. Compares against the current schema
+* 3. Generates and applies migration SQL
+* 4. Logs warnings for destructive changes
+* 5. Saves the updated snapshot
+*
+* @param options - Migration options
+*/
+declare function autoMigrate(options: AutoMigrateOptions): Promise<void>;
+/**
 * Node.js filesystem implementation of SnapshotStorage.
 * Uses node:fs/promises for file I/O and node:path for directory creation.
 */
@@ -290,4 +319,4 @@ declare function mapRow<T>(row: Record<string, unknown>): T;
 * Convert an array of rows from snake_case to camelCase.
 */
 declare function mapRows<T>(rows: readonly Record<string, unknown>[]): T[];
-export { resolveSelectColumns, mapRows, mapRow, getTimestampColumns, getPrimaryKeyColumns, getDefaultColumns, getColumnsWithoutAnnotations, getColumnNames, executeQuery, QueryFn, NodeSnapshotStorage, GroupByArgs, ExecutorResult, CountArgs, AggregateArgs };
+export { resolveSelectColumns, mapRows, mapRow, getTimestampColumns, getPrimaryKeyColumns, getDefaultColumns, getColumnsWithoutAnnotations, getColumnNames, executeQuery, autoMigrate, QueryFn, NodeSnapshotStorage, GroupByArgs, ExecutorResult, CountArgs, AutoMigrateOptions, AggregateArgs };

package/dist/internals.js

@@ -1,4 +1,5 @@
 import {
+  autoMigrate,
   executeQuery,
   getColumnNames,
   getColumnsWithoutAnnotations,
@@ -8,7 +9,7 @@ import {
   mapRow,
   mapRows,
   resolveSelectColumns
-} from "./shared/chunk-agyds4jw.js";
+} from "./shared/chunk-1x9z0p5e.js";
 import {
   NodeSnapshotStorage
 } from "./shared/chunk-kb4tnn2k.js";
@@ -22,5 +23,6 @@ export {
   getColumnsWithoutAnnotations,
   getColumnNames,
   executeQuery,
+  autoMigrate,
   NodeSnapshotStorage
 };