@syncular/migrations 0.0.6-244 → 0.0.6-245

package/README.md

@@ -1,6 +1,6 @@
 # @syncular/migrations
 
-Versioned migration utilities for Syncular apps. Provides `defineMigrations()` and `runMigrations()` with migration tracking and checksum validation (plus an optional reset strategy for client DBs).
+Versioned migration utilities for Syncular apps. Provides `defineMigrations()` and `runMigrations()` with migration tracking and deterministic checksum validation (plus an optional reset strategy for client DBs).
 
 ## Install
 
@@ -18,11 +18,26 @@ import {
 } from '@syncular/migrations';
 
 export const migrations = defineMigrations({
-  v1: async (db) => {
-    await db.schema.createTable('tasks').addColumn('id', 'text').execute();
+  v1: {
+    checksum: 'deterministic',
+    up: async (db) => {
+      await db.schema.createTable('tasks').addColumn('id', 'text').execute();
+    },
+    down: async (db) => {
+      await db.schema.dropTable('tasks').ifExists().execute();
+    },
   },
-  v2: async (db) => {
-    await db.schema.alterTable('tasks').addColumn('done', 'integer').execute();
+  v2: {
+    checksum: 'deterministic',
+    up: async (db) => {
+      await db.schema
+        .alterTable('tasks')
+        .addColumn('done', 'integer')
+        .execute();
+    },
+    down: async (db) => {
+      await db.schema.alterTable('tasks').dropColumn('done').execute();
+    },
   },
 });
 
@@ -37,6 +52,15 @@ Use `createMigrationTrackingTableName(...)` whenever you want a custom table.
 It keeps names lowercase, predictable, and consistently suffixed with
 `migration_state`.
 
+Use `checksum: 'deterministic'` for migrations that can be replayed into a
+scratch in-memory database. Syncular hashes the actual SQL trace emitted by the
+migration instead of the JavaScript source, which avoids bundle/minifier drift.
+
+Use `checksum: 'disabled'` for browser/service-worker or otherwise
+runtime-specific migrations where Syncular cannot safely create the matching
+scratch database. Disabled migrations still track version/application state, but
+they skip checksum creation and mismatch checks.
+
 ## Documentation
 
 - Schema migrations: https://syncular.dev/docs/build/migrations

package/dist/checksum.d.ts

@@ -0,0 +1,11 @@
+import { type Kysely as KyselyInstance } from 'kysely';
+import type { DefinedMigrations, MigrationChecksumAlgorithm, MigrationChecksumDialect, ParsedMigration } from './types';
+export declare const DISABLED_MIGRATION_CHECKSUM = "__syncular_checksum_disabled__";
+export declare const LEGACY_SOURCE_MIGRATION_CHECKSUM_ALGORITHM = "legacy_source_v1";
+export declare const SQL_TRACE_MIGRATION_CHECKSUM_ALGORITHM = "sql_trace_v1";
+export declare const DISABLED_MIGRATION_CHECKSUM_ALGORITHM = "disabled";
+export declare function inferMigrationChecksumDialect<DB>(db: KyselyInstance<DB>): MigrationChecksumDialect | null;
+export declare function getMigrationChecksum<DB>(migrations: DefinedMigrations<DB>, migration: ParsedMigration<DB>, dialect: MigrationChecksumDialect): Promise<string | null>;
+export declare function getLegacyMigrationChecksum<DB>(migration: ParsedMigration<DB>): string;
+export declare function getMigrationChecksumAlgorithm<DB>(migration: ParsedMigration<DB>): MigrationChecksumAlgorithm;
+//# sourceMappingURL=checksum.d.ts.map

package/dist/checksum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checksum.d.ts","sourceRoot":"","sources":["../src/checksum.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,MAAM,IAAI,cAAc,EAM9B,MAAM,QAAQ,CAAC;AAEhB,OAAO,KAAK,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,wBAAwB,EACxB,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,eAAO,MAAM,2BAA2B,mCAAmC,CAAC;AAC5E,eAAO,MAAM,0CAA0C,qBAAqB,CAAC;AAC7E,eAAO,MAAM,sCAAsC,iBAAiB,CAAC;AACrE,eAAO,MAAM,qCAAqC,aAAa,CAAC;AA0bhE,wBAAgB,6BAA6B,CAAC,EAAE,EAC9C,EAAE,EAAE,cAAc,CAAC,EAAE,CAAC,GACrB,wBAAwB,GAAG,IAAI,CAajC;AAED,wBAAsB,oBAAoB,CAAC,EAAE,EAC3C,UAAU,EAAE,iBAAiB,CAAC,EAAE,CAAC,EACjC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,EAC9B,OAAO,EAAE,wBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBxB;AAED,wBAAgB,0BAA0B,CAAC,EAAE,EAC3C,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,GAC7B,MAAM,CAER;AAED,wBAAgB,6BAA6B,CAAC,EAAE,EAC9C,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,GAC7B,0BAA0B,CAM5B"}

package/dist/checksum.js

@@ -0,0 +1,355 @@
+import { PGlite } from '@electric-sql/pglite';
+import { Kysely, PostgresAdapter, SqliteAdapter, SqliteDialect, } from 'kysely';
+import { PGliteDialect } from 'kysely-pglite-dialect';
+export const DISABLED_MIGRATION_CHECKSUM = '__syncular_checksum_disabled__';
+export const LEGACY_SOURCE_MIGRATION_CHECKSUM_ALGORITHM = 'legacy_source_v1';
+export const SQL_TRACE_MIGRATION_CHECKSUM_ALGORITHM = 'sql_trace_v1';
+export const DISABLED_MIGRATION_CHECKSUM_ALGORITHM = 'disabled';
+const checksumCache = new WeakMap();
+function stripCommentsPreservingStrings(source) {
+    let out = '';
+    let index = 0;
+    let mode = 'code';
+    while (index < source.length) {
+        const char = source[index];
+        const next = source[index + 1];
+        if (mode === 'lineComment') {
+            if (char === '\n') {
+                out += '\n';
+                mode = 'code';
+            }
+            index += 1;
+            continue;
+        }
+        if (mode === 'blockComment') {
+            if (char === '*' && next === '/') {
+                index += 2;
+                mode = 'code';
+                continue;
+            }
+            if (char === '\n') {
+                out += '\n';
+            }
+            index += 1;
+            continue;
+        }
+        if (mode === 'singleQuote') {
+            out += char;
+            if (char === '\\' && next !== undefined) {
+                out += next;
+                index += 2;
+                continue;
+            }
+            if (char === "'") {
+                mode = 'code';
+            }
+            index += 1;
+            continue;
+        }
+        if (mode === 'doubleQuote') {
+            out += char;
+            if (char === '\\' && next !== undefined) {
+                out += next;
+                index += 2;
+                continue;
+            }
+            if (char === '"') {
+                mode = 'code';
+            }
+            index += 1;
+            continue;
+        }
+        if (mode === 'template') {
+            out += char;
+            if (char === '\\' && next !== undefined) {
+                out += next;
+                index += 2;
+                continue;
+            }
+            if (char === '`') {
+                mode = 'code';
+            }
+            index += 1;
+            continue;
+        }
+        if (char === '/' && next === '/') {
+            mode = 'lineComment';
+            index += 2;
+            continue;
+        }
+        if (char === '/' && next === '*') {
+            mode = 'blockComment';
+            index += 2;
+            continue;
+        }
+        if (char === "'") {
+            mode = 'singleQuote';
+            out += char;
+            index += 1;
+            continue;
+        }
+        if (char === '"') {
+            mode = 'doubleQuote';
+            out += char;
+            index += 1;
+            continue;
+        }
+        if (char === '`') {
+            mode = 'template';
+            out += char;
+            index += 1;
+            continue;
+        }
+        out += char;
+        index += 1;
+    }
+    return out;
+}
+function hashString(value) {
+    let hash = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        hash = (hash * 31 + value.charCodeAt(index)) >>> 0;
+    }
+    return hash.toString(16).padStart(8, '0');
+}
+function normalizeLegacySource(source) {
+    return stripCommentsPreservingStrings(source).replace(/\s+/g, ' ').trim();
+}
+class TracingConnection {
+    #inner;
+    #sink;
+    constructor(inner, sink) {
+        this.#inner = inner;
+        this.#sink = sink;
+    }
+    unwrap() {
+        return this.#inner;
+    }
+    async executeQuery(compiledQuery) {
+        if (this.#sink.enabled) {
+            this.#sink.entries.push(serializeCompiledQuery(compiledQuery));
+        }
+        return await this.#inner.executeQuery(compiledQuery);
+    }
+    async *streamQuery(compiledQuery, chunkSize) {
+        if (this.#sink.enabled) {
+            this.#sink.entries.push(serializeCompiledQuery(compiledQuery));
+        }
+        for await (const result of this.#inner.streamQuery(compiledQuery, chunkSize)) {
+            yield result;
+        }
+    }
+}
+class TracingDriver {
+    #inner;
+    #sink;
+    #innerToWrapped = new Map();
+    constructor(inner, sink) {
+        this.#inner = inner;
+        this.#sink = sink;
+    }
+    async init() {
+        await this.#inner.init();
+    }
+    async acquireConnection() {
+        return this.#wrapConnection(await this.#inner.acquireConnection());
+    }
+    async beginTransaction(connection, settings) {
+        await this.#inner.beginTransaction(this.#unwrapConnection(connection), settings);
+    }
+    async commitTransaction(connection) {
+        await this.#inner.commitTransaction(this.#unwrapConnection(connection));
+    }
+    async rollbackTransaction(connection) {
+        await this.#inner.rollbackTransaction(this.#unwrapConnection(connection));
+    }
+    async savepoint(connection, savepointName, compileQuery) {
+        if (!this.#inner.savepoint) {
+            return;
+        }
+        await this.#inner.savepoint(this.#unwrapConnection(connection), savepointName, compileQuery);
+    }
+    async rollbackToSavepoint(connection, savepointName, compileQuery) {
+        if (!this.#inner.rollbackToSavepoint) {
+            return;
+        }
+        await this.#inner.rollbackToSavepoint(this.#unwrapConnection(connection), savepointName, compileQuery);
+    }
+    async releaseSavepoint(connection, savepointName, compileQuery) {
+        if (!this.#inner.releaseSavepoint) {
+            return;
+        }
+        await this.#inner.releaseSavepoint(this.#unwrapConnection(connection), savepointName, compileQuery);
+    }
+    async releaseConnection(connection) {
+        const unwrapped = this.#unwrapConnection(connection);
+        if (connection instanceof TracingConnection) {
+            this.#innerToWrapped.delete(unwrapped);
+        }
+        await this.#inner.releaseConnection(unwrapped);
+    }
+    async destroy() {
+        this.#innerToWrapped.clear();
+        await this.#inner.destroy();
+    }
+    #wrapConnection(connection) {
+        const existing = this.#innerToWrapped.get(connection);
+        if (existing) {
+            return existing;
+        }
+        const wrapped = new TracingConnection(connection, this.#sink);
+        this.#innerToWrapped.set(connection, wrapped);
+        return wrapped;
+    }
+    #unwrapConnection(connection) {
+        if (connection instanceof TracingConnection) {
+            return connection.unwrap();
+        }
+        return connection;
+    }
+}
+function createTracingDialect(baseDialect, sink) {
+    return {
+        createDriver: () => new TracingDriver(baseDialect.createDriver(), sink),
+        createAdapter: () => baseDialect.createAdapter(),
+        createQueryCompiler: () => baseDialect.createQueryCompiler(),
+        createIntrospector: (db) => baseDialect.createIntrospector(db),
+    };
+}
+function serializeCompiledQuery(compiledQuery) {
+    return JSON.stringify({
+        sql: compiledQuery.sql,
+        parameters: compiledQuery.parameters.map((value) => normalizeParameterValue(value)),
+    });
+}
+function normalizeParameterValue(value) {
+    if (typeof value === 'bigint') {
+        return { type: 'bigint', value: value.toString() };
+    }
+    if (value instanceof Date) {
+        return { type: 'date', value: value.toISOString() };
+    }
+    if (value instanceof Uint8Array) {
+        return { type: 'bytes', value: Array.from(value) };
+    }
+    if (Array.isArray(value)) {
+        return value.map((entry) => normalizeParameterValue(entry));
+    }
+    if (value && typeof value === 'object') {
+        return Object.fromEntries(Object.entries(value)
+            .sort(([left], [right]) => left.localeCompare(right))
+            .map(([key, entry]) => [key, normalizeParameterValue(entry)]));
+    }
+    return value;
+}
+function hashTrace(entries) {
+    return hashString(entries.join('\n'));
+}
+async function createSqliteChecksumDb(sink) {
+    try {
+        const bunSqliteSpecifier = 'bun:sqlite';
+        const sqliteModule = await import(bunSqliteSpecifier);
+        const dialectModule = await import('kysely-bun-sqlite');
+        const sqliteDb = new sqliteModule.Database(':memory:');
+        const dialect = createTracingDialect(new dialectModule.BunSqliteDialect({ database: sqliteDb }), sink);
+        return {
+            db: new Kysely({ dialect }),
+            dispose: async () => {
+                sqliteDb.close();
+            },
+        };
+    }
+    catch {
+        // Fall back to better-sqlite3 outside Bun.
+    }
+    try {
+        const sqliteModule = await import('better-sqlite3');
+        const sqliteDb = new sqliteModule.default(':memory:');
+        const dialect = createTracingDialect(new SqliteDialect({ database: sqliteDb }), sink);
+        return {
+            db: new Kysely({ dialect }),
+            dispose: async () => {
+                sqliteDb.close();
+            },
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        throw new Error(`Deterministic migration checksums for sqlite require an in-memory sqlite runtime in this environment. ${message}`);
+    }
+}
+async function createPostgresChecksumDb(sink) {
+    const pglite = await PGlite.create();
+    const dialect = createTracingDialect(new PGliteDialect(pglite), sink);
+    return {
+        db: new Kysely({ dialect }),
+        dispose: async () => {
+            await pglite.close();
+        },
+    };
+}
+async function createChecksumDb(dialect, sink) {
+    if (dialect === 'postgres') {
+        return await createPostgresChecksumDb(sink);
+    }
+    return await createSqliteChecksumDb(sink);
+}
+async function computeDeterministicChecksum(migrations, migration, dialect) {
+    const sink = { enabled: false, entries: [] };
+    const { db, dispose } = await createChecksumDb(dialect, sink);
+    try {
+        for (const current of migrations.migrations) {
+            if (current.version > migration.version) {
+                break;
+            }
+            sink.enabled = current.version === migration.version;
+            await current.up(db);
+            sink.enabled = false;
+            if (current.version === migration.version) {
+                break;
+            }
+        }
+        return hashTrace(sink.entries);
+    }
+    finally {
+        await db.destroy();
+        await dispose();
+    }
+}
+export function inferMigrationChecksumDialect(db) {
+    const adapter = db.getExecutor().adapter;
+    const adapterName = adapter.constructor.name;
+    if (adapter instanceof SqliteAdapter || adapterName === 'SqliteAdapter') {
+        return 'sqlite';
+    }
+    if (adapter instanceof PostgresAdapter || adapterName === 'PostgresAdapter') {
+        return 'postgres';
+    }
+    return null;
+}
+export async function getMigrationChecksum(migrations, migration, dialect) {
+    if (migration.checksum === 'disabled') {
+        return null;
+    }
+    let dialectCache = checksumCache.get(migration);
+    if (!dialectCache) {
+        dialectCache = new Map();
+        checksumCache.set(migration, dialectCache);
+    }
+    if (dialectCache.has(dialect)) {
+        return dialectCache.get(dialect) ?? null;
+    }
+    const checksum = await computeDeterministicChecksum(migrations, migration, dialect);
+    dialectCache.set(dialect, checksum);
+    return checksum;
+}
+export function getLegacyMigrationChecksum(migration) {
+    return hashString(normalizeLegacySource(migration.up.toString()));
+}
+export function getMigrationChecksumAlgorithm(migration) {
+    if (migration.checksum === 'disabled') {
+        return DISABLED_MIGRATION_CHECKSUM_ALGORITHM;
+    }
+    return SQL_TRACE_MIGRATION_CHECKSUM_ALGORITHM;
+}
+//# sourceMappingURL=checksum.js.map

package/dist/checksum.js.map

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

package/dist/define.d.ts

@@ -1,34 +1,38 @@
 /**
  * @syncular/migrations - Migration definition
  */
-import type { DefinedMigrations, MigrationRecord, ParsedMigration } from './types';
+import type { DefinedMigrations, MigrationRecord } from './types';
 /**
  * Define versioned migrations with automatic version parsing and sorting.
  *
  * @example
  * ```typescript
  * export const migrations = defineMigrations({
- *   v1: async (db) => {
- *     await db.schema.createTable('tasks')
- *       .addColumn('id', 'text', col => col.primaryKey())
- *       .addColumn('title', 'text', col => col.notNull())
- *       .execute();
+ *   v1: {
+ *     up: async (db) => {
+ *       await db.schema.createTable('tasks')
+ *         .addColumn('id', 'text', col => col.primaryKey())
+ *         .addColumn('title', 'text', col => col.notNull())
+ *         .execute();
+ *     },
+ *     down: async (db) => {
+ *       await db.schema.dropTable('tasks').ifExists().execute();
+ *     },
  *   },
- *   v2: async (db) => {
- *     await db.schema.alterTable('tasks')
- *       .addColumn('priority', 'integer', col => col.defaultTo(0))
- *       .execute();
+ *   v2: {
+ *     up: async (db) => {
+ *       await db.schema.alterTable('tasks')
+ *         .addColumn('priority', 'integer', col => col.defaultTo(0))
+ *         .execute();
+ *     },
+ *     down: async (db) => {
+ *       await db.schema.alterTable('tasks')
+ *         .dropColumn('priority')
+ *         .execute();
+ *     },
  *   },
  * });
  * ```
  */
 export declare function defineMigrations<DB = unknown, T extends MigrationRecord<DB> = MigrationRecord<DB>>(versionedMigrations: T): DefinedMigrations<DB>;
-/**
- * Get the checksum for a migration.
- */
-export declare function getMigrationChecksum<DB>(migration: ParsedMigration<DB>): string;
-/**
- * Get the accepted checksums for a migration, including the current checksum.
- */
-export declare function getCompatibleMigrationChecksums<DB>(migration: ParsedMigration<DB>): string[];
 //# sourceMappingURL=define.d.ts.map

package/dist/define.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAGjB,eAAe,EACf,eAAe,EAChB,MAAM,SAAS,CAAC;AA8JjB;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,GAAG,OAAO,EACZ,CAAC,SAAS,eAAe,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,EACnD,mBAAmB,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC,CA8E/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EACrC,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,GAC7B,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,EAAE,EAChD,SAAS,EAAE,eAAe,CAAC,EAAE,CAAC,GAC7B,MAAM,EAAE,CAOV"}
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,iBAAiB,EAGjB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAmCjB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,GAAG,OAAO,EACZ,CAAC,SAAS,eAAe,CAAC,EAAE,CAAC,GAAG,eAAe,CAAC,EAAE,CAAC,EACnD,mBAAmB,EAAE,CAAC,GAAG,iBAAiB,CAAC,EAAE,CAAC,CA4D/C"}