@deterministic-code/migraters 0.0.2 → 0.0.4

package/shared/templates/messages/errors/unknown-arg.txt

@@ -0,0 +1 @@
+unknown arg: {{arg}}

package/shared/templates/messages/errors/unsupported-provider.txt

@@ -0,0 +1 @@
+unsupported provider: {{provider}}

package/shared/templates/messages/setup-complete.txt

@@ -0,0 +1,9 @@
+Setup complete: migrates and migrate_logs ready ({{dialect}}).
+Migrations directory: {{migrationsPath}}
+
+Next steps:
+  # create a new migration
+  {{createExample}}
+
+  # apply pending migrations
+  {{upExample}}

package/shared/templates/messages/status/applied.txt

@@ -0,0 +1 @@
+Applied: {{name}}

package/shared/templates/messages/status/created.txt

@@ -0,0 +1 @@
+Created: {{file}}

package/shared/templates/messages/status/no-more-pending.txt

@@ -0,0 +1 @@
+No more pending migrations.

package/shared/templates/messages/status/no-pending.txt

@@ -0,0 +1 @@
+No pending migrations.

package/shared/templates/messages/status/no-rollback.txt

@@ -0,0 +1 @@
+No applied migrations to roll back.

package/shared/templates/messages/status/rolled-back.txt

@@ -0,0 +1 @@
+Rolled back: {{name}}

package/shared/templates/scaffold/down.sql

@@ -0,0 +1 @@
+-- TODO: write the down migration for "{{name}}"

package/shared/templates/scaffold/up.sql

@@ -0,0 +1 @@
+-- TODO: write the up migration for "{{name}}"

package/shared/templates/sql/mysql/migrate_logs.sql

@@ -0,0 +1,11 @@
+CREATE TABLE IF NOT EXISTS `migrate_logs` (
+  `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
+  `migrate_name` VARCHAR(255) NOT NULL,
+  `direction` VARCHAR(8) NOT NULL,
+  `status` VARCHAR(16) NOT NULL,
+  `finished_at` TIMESTAMP NULL,
+  `duration_ms` INT,
+  `error_message` TEXT,
+  `created` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+);

package/shared/templates/sql/mysql/migrates.sql

@@ -0,0 +1,7 @@
+CREATE TABLE IF NOT EXISTS `migrates` (
+  `id` BIGINT AUTO_INCREMENT PRIMARY KEY,
+  `name` VARCHAR(255) NOT NULL UNIQUE,
+  `checksum` VARCHAR(64),
+  `created` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  `updated` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
+);

package/shared/templates/sql/oracle/migrate_logs.sql

@@ -0,0 +1,14 @@
+BEGIN
+  EXECUTE IMMEDIATE 'CREATE TABLE "migrate_logs" (
+    "id" NUMBER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+    "migrate_name" VARCHAR2(255) NOT NULL,
+    "direction" VARCHAR2(8) NOT NULL,
+    "status" VARCHAR2(16) NOT NULL,
+    "finished_at" TIMESTAMP,
+    "duration_ms" NUMBER(10),
+    "error_message" CLOB,
+    "created" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "updated" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL
+  )';
+EXCEPTION WHEN OTHERS THEN IF SQLCODE != -955 THEN RAISE; END IF;
+END;

package/shared/templates/sql/oracle/migrates.sql

@@ -0,0 +1,10 @@
+BEGIN
+  EXECUTE IMMEDIATE 'CREATE TABLE "migrates" (
+    "id" NUMBER GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+    "name" VARCHAR2(255) NOT NULL UNIQUE,
+    "checksum" VARCHAR2(64),
+    "created" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL,
+    "updated" TIMESTAMP DEFAULT CURRENT_TIMESTAMP NOT NULL
+  )';
+EXCEPTION WHEN OTHERS THEN IF SQLCODE != -955 THEN RAISE; END IF;
+END;

package/shared/templates/sql/postgres/migrate_logs.sql

@@ -0,0 +1,11 @@
+CREATE TABLE IF NOT EXISTS "migrate_logs" (
+  "id" BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  "migrate_name" VARCHAR(255) NOT NULL,
+  "direction" VARCHAR(8) NOT NULL,
+  "status" VARCHAR(16) NOT NULL,
+  "finished_at" TIMESTAMPTZ,
+  "duration_ms" INTEGER,
+  "error_message" TEXT,
+  "created" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  "updated" TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);

package/shared/templates/sql/postgres/migrates.sql

@@ -0,0 +1,7 @@
+CREATE TABLE IF NOT EXISTS "migrates" (
+  "id" BIGINT GENERATED ALWAYS AS IDENTITY PRIMARY KEY,
+  "name" VARCHAR(255) NOT NULL UNIQUE,
+  "checksum" VARCHAR(64),
+  "created" TIMESTAMPTZ NOT NULL DEFAULT NOW(),
+  "updated" TIMESTAMPTZ NOT NULL DEFAULT NOW()
+);

package/shared/templates/sql/sqlite/migrate_logs.sql

@@ -0,0 +1,11 @@
+CREATE TABLE IF NOT EXISTS "migrate_logs" (
+  "id" INTEGER PRIMARY KEY AUTOINCREMENT,
+  "migrate_name" VARCHAR(255) NOT NULL,
+  "direction" VARCHAR(8) NOT NULL,
+  "status" VARCHAR(16) NOT NULL,
+  "finished_at" DATETIME,
+  "duration_ms" INTEGER,
+  "error_message" TEXT,
+  "created" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "updated" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);

package/shared/templates/sql/sqlite/migrates.sql

@@ -0,0 +1,7 @@
+CREATE TABLE IF NOT EXISTS "migrates" (
+  "id" INTEGER PRIMARY KEY AUTOINCREMENT,
+  "name" VARCHAR(255) NOT NULL UNIQUE,
+  "checksum" VARCHAR(64),
+  "created" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP,
+  "updated" DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);

package/shared/templates/sql/sqlserver/migrate_logs.sql

@@ -0,0 +1,12 @@
+IF OBJECT_ID('dbo.migrate_logs', 'U') IS NULL
+CREATE TABLE [migrate_logs] (
+  [id] BIGINT IDENTITY(1,1) PRIMARY KEY,
+  [migrate_name] NVARCHAR(255) NOT NULL,
+  [direction] NVARCHAR(8) NOT NULL,
+  [status] NVARCHAR(16) NOT NULL,
+  [finished_at] DATETIME2,
+  [duration_ms] INT,
+  [error_message] NVARCHAR(MAX),
+  [created] DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME(),
+  [updated] DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME()
+);

package/shared/templates/sql/sqlserver/migrates.sql

@@ -0,0 +1,8 @@
+IF OBJECT_ID('dbo.migrates', 'U') IS NULL
+CREATE TABLE [migrates] (
+  [id] BIGINT IDENTITY(1,1) PRIMARY KEY,
+  [name] NVARCHAR(255) NOT NULL UNIQUE,
+  [checksum] NVARCHAR(64),
+  [created] DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME(),
+  [updated] DATETIME2 NOT NULL DEFAULT SYSUTCDATETIME()
+);

package/typescript/bundle.yaml

@@ -0,0 +1,254 @@
+# Source of truth for vendoring migrate runners into generated apps.
+# generators-migraters `fetch-bundle` copies these files; `generate` emits
+# Bundled content or Reference install instructions from the same manifest.
+
+repository: https://github.com/deterministic-code/migraters
+ref: main
+
+languages:
+  typescript:
+    root: migraters
+    common:
+      - cli.yaml
+      - typescript/cli.yaml
+      - typescript/package.json
+      - typescript/tsconfig.build.json
+      - typescript/src/**/*.ts
+      - shared/templates/help/**
+      - shared/templates/messages/**
+      - shared/templates/scaffold/**
+    exclude:
+      - typescript/src/**/*.test.ts
+      - typescript/src/generate-help.ts
+    dialects:
+      sqlite:
+        files:
+          - typescript/dialects/sqlite/**
+          - shared/templates/sql/sqlite/**
+        apk: sqlite
+        packages:
+          - name: better-sqlite3
+            installScripts: true
+      postgres:
+        files:
+          - typescript/dialects/postgres/**
+          - shared/templates/sql/postgres/**
+        apk: postgresql-client
+        packages:
+          - name: pg
+      mysql:
+        files:
+          - typescript/dialects/mysql/**
+          - shared/templates/sql/mysql/**
+        apk: mysql-client
+        packages:
+          - name: mysql2
+      sqlserver:
+        files:
+          - typescript/dialects/sqlserver/**
+          - shared/templates/sql/sqlserver/**
+        packages:
+          - name: mssql
+      oracle:
+        files:
+          - typescript/dialects/oracle/**
+          - shared/templates/sql/oracle/**
+        packages:
+          - name: oracledb
+    commands:
+      setup: migrate-setup --provider {{provider}}
+      up: migrate-up --provider {{provider}} --migrate-path {{migrationsPath}}
+      down: migrate-down --provider {{provider}} --migrate-path {{migrationsPath}}
+      create: migrate-create --provider {{provider}}
+    build:
+      cwd: typescript
+      steps:
+        - npm install
+        - npm run build
+    invoke:
+      setup:
+        reference: migrate-setup --provider "$DIALECT" --connection "$CONN"
+        bundled: npm --prefix /app/migraters/typescript exec -- migrate-setup --provider "$DIALECT" --connection "$CONN"
+      up:
+        reference: migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+        bundled: npm --prefix /app/migraters/typescript exec -- migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+    reference:
+      package: "@deterministic-code/migraters"
+      spec: "github:deterministic-code/migraters"
+    docker:
+      copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+          COPY {{lane}}migraters ./migraters
+      runtime_copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+          COPY {{lane}}migraters ./migraters
+
+  rust:
+    root: migraters
+    common:
+      - rust/Cargo.toml
+      - rust/rustfmt.toml
+      - rust/src/**/*.rs
+      - rust/api/**
+      - rust/init/**
+      - shared/templates/help/**
+      - shared/templates/messages/**
+      - shared/templates/scaffold/**
+      - cli.yaml
+    dialects:
+      sqlite:
+        files:
+          - rust/dialects/sqlite/**
+          - shared/templates/sql/sqlite/**
+        apk: sqlite
+      postgres:
+        files:
+          - rust/dialects/postgres/**
+          - shared/templates/sql/postgres/**
+        apk: postgresql-client
+      mysql:
+        files:
+          - rust/dialects/mysql/**
+          - shared/templates/sql/mysql/**
+        apk: mysql-client
+      sqlserver:
+        files:
+          - rust/dialects/sqlserver/**
+          - shared/templates/sql/sqlserver/**
+      oracle:
+        files:
+          - rust/dialects/oracle/**
+          - shared/templates/sql/oracle/**
+    commands:
+      setup: migrate-setup --provider {{provider}}
+      up: migrate-up --provider {{provider}} --migrate-path {{migrationsPath}}
+      down: migrate-down --provider {{provider}} --migrate-path {{migrationsPath}}
+      create: migrate-create --provider {{provider}}
+    build:
+      cwd: rust
+      steps:
+        - cargo build --release
+    invoke:
+      setup:
+        reference: migrate-setup --provider "$DIALECT" --connection "$CONN"
+        bundled: /app/migraters/rust/target/release/migrate-setup --provider "$DIALECT" --connection "$CONN"
+      up:
+        reference: migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+        bundled: /app/migraters/rust/target/release/migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+    reference:
+      git: "https://github.com/deterministic-code/migraters"
+      path: rust
+    docker:
+      copy:
+        reference: |
+          COPY {{shared}}sql ./sql
+        bundled: |
+          COPY {{shared}}sql ./sql
+          COPY {{lane}}migraters ./migraters
+          RUN cargo build --release --manifest-path migraters/rust/Cargo.toml
+      runtime_copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY --from=builder /app/migraters/rust/target/release/migrate-setup /app/migraters/rust/target/release/migrate-setup
+          COPY --from=builder /app/migraters/rust/target/release/migrate-up /app/migraters/rust/target/release/migrate-up
+          COPY --from=builder /app/migraters/rust/target/release/migrate-down /app/migraters/rust/target/release/migrate-down
+          COPY --from=builder /app/migraters/rust/target/release/migrate-create /app/migraters/rust/target/release/migrate-create
+          COPY {{shared}}sql {{containerSqlRoot}}
+
+  csharp:
+    root: migraters
+    common:
+      - csharp/**/*.cs
+      - csharp/MigrateRunner.csproj
+      - csharp/MigrateRunner.Core.csproj
+      - csharp/MigrateInit/MigrateInit.csproj
+      - csharp/GlobalUsings.cs
+      - csharp/.csharpierrc.json
+      - csharp/.csharpierignore
+      - csharp/dotnet-tools.json
+      - cli.yaml
+      - shared/templates/help/**
+      - shared/templates/messages/**
+      - shared/templates/scaffold/**
+    exclude:
+      - csharp/bin/**
+      - csharp/obj/**
+    dialects:
+      sqlite:
+        files:
+          - csharp/Dialects/Sqlite/**
+          - shared/templates/sql/sqlite/**
+        apk: sqlite
+        packages:
+          - name: Microsoft.Data.Sqlite
+            version: "9.0.0"
+      postgres:
+        files:
+          - csharp/Dialects/Postgres/**
+          - shared/templates/sql/postgres/**
+        apk: postgresql-client
+        packages:
+          - name: Npgsql
+            version: "9.0.2"
+      mysql:
+        files:
+          - csharp/Dialects/Mysql/**
+          - shared/templates/sql/mysql/**
+        apk: mysql-client
+        packages:
+          - name: MySqlConnector
+            version: "2.4.0"
+      sqlserver:
+        files:
+          - csharp/Dialects/SqlServer/**
+          - shared/templates/sql/sqlserver/**
+        packages:
+          - name: Microsoft.Data.SqlClient
+            version: "6.0.2"
+      oracle:
+        files:
+          - csharp/Dialects/Oracle/**
+          - shared/templates/sql/oracle/**
+        packages:
+          - name: Oracle.ManagedDataAccess.Core
+            version: "23.9.1"
+    commands:
+      setup: migrate-setup --provider {{provider}}
+      up: migrate-up --provider {{provider}} --migrate-path {{migrationsPath}}
+      down: migrate-down --provider {{provider}} --migrate-path {{migrationsPath}}
+      create: migrate-create --provider {{provider}}
+    build:
+      cwd: csharp
+      steps:
+        - dotnet publish MigrateRunner.csproj -c Release
+    invoke:
+      setup:
+        reference: migrate-setup --provider "$DIALECT" --connection "$CONN"
+        bundled: dotnet /app/MigrateRunner/MigrateRunner.dll setup --provider "$DIALECT" --connection "$CONN"
+      up:
+        reference: migrate-up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+        bundled: dotnet /app/MigrateRunner/MigrateRunner.dll up --provider "$DIALECT" --migrate-path "$MIGRATIONS_DIR" --connection "$CONN"
+    reference:
+      git: "https://github.com/deterministic-code/migraters"
+      path: csharp
+    docker:
+      copy:
+        reference: |
+          COPY {{shared}}sql ./sql
+        bundled: |
+          COPY {{shared}}sql ./sql
+          COPY {{lane}}migraters ./migraters
+          RUN dotnet publish migraters/csharp/MigrateRunner.csproj -c Release -o /app/migrate-publish
+      runtime_copy:
+        reference: |
+          COPY {{shared}}sql {{containerSqlRoot}}
+        bundled: |
+          COPY --from=build /app/migrate-publish ./MigrateRunner
+          COPY {{shared}}sql {{containerSqlRoot}}

package/typescript/dialects/mysql/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@deterministic-code/migraters-mysql",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "mysql2": "*"
+  }
+}

package/typescript/dialects/mysql/src/index.ts

@@ -0,0 +1,4 @@
+import { MysqlDialect } from './mysql-dialect.ts';
+
+export const createDialect = (): MysqlDialect => new MysqlDialect();
+export { MysqlDialect, applyMysqlDdlViaTextProtocol } from './mysql-dialect.ts';

package/typescript/dialects/mysql/src/mysql-dialect.test.ts

@@ -0,0 +1,99 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+
+const mysql = vi.hoisted(() => {
+  const state = {
+    failRollback: false,
+    ended: false,
+    queries: [] as string[],
+    executes: [] as { sql: string; params?: unknown[] }[],
+  };
+  const conn = {
+    async query(sql: string) {
+      state.queries.push(sql);
+    },
+    async execute(sql: string, params?: unknown[]) {
+      state.executes.push({ sql, params });
+      return [[{ n: 1 }]];
+    },
+    async beginTransaction() {},
+    async commit() {},
+    async rollback() {
+      if (state.failRollback) throw new Error('rollback failed');
+    },
+    async end() {
+      state.ended = true;
+    },
+  };
+  return {
+    state,
+    createConnection: async () => conn,
+  };
+});
+
+vi.mock('mysql2/promise', () => ({
+  createConnection: mysql.createConnection,
+}));
+
+import { applyMysqlDdlViaTextProtocol, MysqlDialect } from './mysql-dialect.ts';
+
+const dialect = new MysqlDialect();
+
+describe('MysqlDialect', () => {
+  afterEach(() => {
+    mysql.state.failRollback = false;
+    mysql.state.ended = false;
+    mysql.state.queries = [];
+    mysql.state.executes = [];
+  });
+
+  it('registers as mysql with backtick identifiers', async () => {
+    expect(dialect.name).toBe('mysql');
+    expect([...dialect.connectionEnvironmentVariables]).toEqual(['MYSQL_URL', 'DATABASE_URL']);
+    expect(dialect.quoteIdent('t')).toBe('`t`');
+    expect(dialect.nowExpr()).toBe('CURRENT_TIMESTAMP');
+    expect(dialect.limitClause(2)).toBe('LIMIT 2');
+    expect(dialect.translatePlaceholders('?')).toBe('?');
+    expect(dialect.migratesDdl).toMatch(/migrates/i);
+    expect(dialect.migrateLogsDdl).toMatch(/migrate_logs/i);
+    expect(await dialect.prerequisiteError('mysql://x')).toBeNull();
+    await dialect.prepareSetup('mysql://x');
+  });
+
+  it('applyMysqlDdlViaTextProtocol uses query, not execute', async () => {
+    const seen: string[] = [];
+    await applyMysqlDdlViaTextProtocol({ query: async (sql: string) => { seen.push(sql); } }, 'CREATE TABLE t (id INT)');
+    expect(seen).toEqual(['CREATE TABLE t (id INT)']);
+  });
+
+  it('createDatabaseIfMissing issues CREATE DATABASE IF NOT EXISTS', async () => {
+    await dialect.createDatabaseIfMissing('mysql://root:proof@mysql:3306/proof');
+    expect(mysql.state.queries[0]).toContain('CREATE DATABASE IF NOT EXISTS `proof`');
+    await dialect.createDatabaseIfMissing('mysql://root:proof@mysql:3306/');
+  });
+
+  it('createClient uses text-protocol exec and execute for query/run', async () => {
+    const client = await dialect.createClient('mysql://localhost/db');
+    expect(client.dialect).toBe('mysql');
+    await client.exec('DROP PROCEDURE p');
+    expect(mysql.state.queries).toContain('DROP PROCEDURE p');
+    expect(await client.query('SELECT ?', [1])).toEqual([{ n: 1 }]);
+    await client.run('UPDATE t SET x = ?', [2]);
+    expect(await client.transaction(async () => 9)).toBe(9);
+    await expect(
+      client.transaction(async () => {
+        throw new Error('tx');
+      }),
+    ).rejects.toThrow('tx');
+    mysql.state.failRollback = true;
+    const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+    await expect(
+      client.transaction(async () => {
+        throw new Error('tx2');
+      }),
+    ).rejects.toThrow('tx2');
+    expect(warn).toHaveBeenCalled();
+    warn.mockRestore();
+    await client.close();
+    expect(mysql.state.ended).toBe(true);
+  });
+});

package/typescript/dialects/mysql/src/mysql-dialect.ts

@@ -0,0 +1,75 @@
+import type { MigrationClient, MigrationRow } from '../../../src/migration-client.ts';
+import { applyMysqlDdlViaTextProtocol } from '../../../src/infrastructure/mysql-text-protocol.ts';
+import { readSqlTemplate } from '../../../src/infrastructure/sql-templates.ts';
+import { SqlDialectBase } from '../../../src/abstractions/sql-dialect-base.ts';
+
+export { applyMysqlDdlViaTextProtocol };
+
+const [migratesDdl, migrateLogsDdl] = await Promise.all([
+  readSqlTemplate('mysql', 'migrates'),
+  readSqlTemplate('mysql', 'migrate_logs'),
+]);
+
+export class MysqlDialect extends SqlDialectBase {
+  readonly name = 'mysql' as const;
+  readonly connectionEnvironmentVariables = ['MYSQL_URL', 'DATABASE_URL'] as const;
+  readonly migratesDdl = migratesDdl;
+  readonly migrateLogsDdl = migrateLogsDdl;
+
+  quoteIdent(ident: string): string {
+    return `\`${ident}\``;
+  }
+
+  async createDatabaseIfMissing(connection: string): Promise<void> {
+    const url = new URL(connection);
+    const name = url.pathname.replace(/^\//, '');
+    if (!name) return;
+    url.pathname = '/';
+    const mysql = await import('mysql2/promise');
+    const conn = await mysql.createConnection(url.toString());
+    try {
+      await conn.query(`CREATE DATABASE IF NOT EXISTS \`${name.replaceAll('`', '``')}\``);
+    } finally {
+      await conn.end();
+    }
+  }
+
+  async createClient(connection: string): Promise<MigrationClient> {
+    const mysql = await import('mysql2/promise');
+    const conn = await mysql.createConnection(connection);
+    return {
+      dialect: 'mysql',
+      async exec(sql) {
+        await applyMysqlDdlViaTextProtocol(conn, sql);
+      },
+      async query(sql, params = []) {
+        const [rows] = await conn.execute(sql, params);
+        return rows as MigrationRow[];
+      },
+      async run(sql, params = []) {
+        await conn.execute(sql, params);
+      },
+      async transaction(fn) {
+        await conn.beginTransaction();
+        try {
+          const r = await fn();
+          await conn.commit();
+          return r;
+        } catch (e) {
+          try {
+            await conn.rollback();
+          } catch (rollbackErr) {
+            console.warn(
+              'mysql rollback failed after transaction error; original error rethrown',
+              rollbackErr,
+            );
+          }
+          throw e;
+        }
+      },
+      async close() {
+        await conn.end();
+      },
+    };
+  }
+}

package/typescript/dialects/oracle/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@deterministic-code/migraters-oracle",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": "./src/index.ts"
+  },
+  "dependencies": {
+    "@types/oracledb": "*",
+    "oracledb": "*"
+  }
+}

package/typescript/dialects/oracle/src/index.ts

@@ -0,0 +1,4 @@
+import { OracleDialect } from './oracle-dialect.ts';
+
+export const createDialect = (): OracleDialect => new OracleDialect();
+export { OracleDialect, parseOracleConnection } from './oracle-dialect.ts';