@deterministic-code/migraters 0.0.0-stage → 0.0.1

package/dist/migrater.js

@@ -0,0 +1,84 @@
+import { mkdir, readdir, writeFile } from 'node:fs/promises';
+import { isMigrationName, nextSequence, pad4 } from "./create-sequence.js";
+import { applyOneDown, applyOneUp, discoverMigrations } from "./datasource-migrate.js";
+import { defaultDialectFactory } from "./infrastructure/default-factory.js";
+import { fillTemplate, loadMessage, loadScaffold } from "./infrastructure/message-templates.js";
+const invalidNameTpl = await loadMessage('errors/invalid-name');
+export class Migrater {
+    dialect;
+    constructor(dialect) {
+        this.dialect = dialect;
+    }
+    get name() {
+        return this.dialect.name;
+    }
+    async setup({ connection, migrationsPath }) {
+        await this.dialect.prepareSetup(connection);
+        const client = await this.dialect.createClient(connection);
+        try {
+            await client.exec(this.dialect.migratesDdl);
+            await client.exec(this.dialect.migrateLogsDdl);
+            await mkdir(migrationsPath, { recursive: true });
+        }
+        finally {
+            await client.close();
+        }
+    }
+    async up({ connection, migrationsPath, one = false }) {
+        const client = await this.dialect.createClient(connection);
+        try {
+            const migrations = await discoverMigrations({
+                migratePath: migrationsPath,
+                dialect: this.dialect.name,
+            });
+            const applied = [];
+            for (;;) {
+                const result = await applyOneUp({ client, migrations });
+                if (!result.applied || result.name == null)
+                    break;
+                applied.push(result.name);
+                if (one)
+                    break;
+            }
+            return applied;
+        }
+        finally {
+            await client.close();
+        }
+    }
+    async down({ connection, migrationsPath }) {
+        const client = await this.dialect.createClient(connection);
+        try {
+            const migrations = await discoverMigrations({
+                migratePath: migrationsPath,
+                dialect: this.dialect.name,
+            });
+            const result = await applyOneDown({ client, migrations });
+            return result.rolledBack ? result.name : null;
+        }
+        finally {
+            await client.close();
+        }
+    }
+    async create({ name, migrationsPath }) {
+        if (!isMigrationName(name)) {
+            throw new Error(fillTemplate(invalidNameTpl, { name }));
+        }
+        await mkdir(migrationsPath, { recursive: true });
+        let entries = [];
+        try {
+            entries = await readdir(migrationsPath);
+        }
+        catch (err) {
+            if (!(err instanceof Error && 'code' in err && err.code === 'ENOENT'))
+                throw err;
+        }
+        const seq = pad4(nextSequence(entries));
+        const upName = `${seq}_${name}_up.sql`;
+        const downName = `${seq}_${name}_down.sql`;
+        await writeFile(`${migrationsPath}/${upName}`, await loadScaffold('up', { name }));
+        await writeFile(`${migrationsPath}/${downName}`, await loadScaffold('down', { name }));
+        return { upName, downName };
+    }
+}
+export const getMigrater = (provider) => new Migrater(defaultDialectFactory.get(provider));

package/dist/migration-client.d.ts

@@ -0,0 +1,21 @@
+export type MigrationRowValue = string | number | bigint | boolean | Date | null;
+export type MigrationRow = Record<string, MigrationRowValue>;
+export type MigrationSqlParam = string | number | bigint | boolean | Date | null;
+/** The subset of a better-sqlite3 Database that `insertLogStarted` reaches through `_raw` when a caller injects a synchronous handle. */
+export interface SqliteRawDatabase {
+    prepare(source: string): {
+        run(...params: MigrationSqlParam[]): {
+            lastInsertRowid: number | bigint;
+        };
+    };
+}
+/** Provider-agnostic migration client used by IMigrater.up, IMigrater.down, and IMigrater.setup. */
+export interface MigrationClient {
+    dialect: import('./sql.ts').SqlDialect;
+    exec(sql: string): Promise<void>;
+    query(sql: string, params?: MigrationSqlParam[]): Promise<MigrationRow[]>;
+    run(sql: string, params?: MigrationSqlParam[]): Promise<void>;
+    transaction<T>(fn: () => Promise<T>): Promise<T>;
+    close(): Promise<void>;
+    _raw?: SqliteRawDatabase;
+}

package/dist/migration-client.js

@@ -0,0 +1 @@
+export {};

package/dist/path-exists.d.ts

@@ -0,0 +1 @@
+export declare const pathExists: (p: string) => Promise<boolean>;

package/dist/path-exists.js

@@ -0,0 +1,10 @@
+import { access } from 'node:fs/promises';
+export const pathExists = async (p) => {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+};

package/dist/sql.d.ts

@@ -0,0 +1,3 @@
+export type SqlDialect = 'sqlite' | 'mysql' | 'postgres' | 'sqlserver' | 'oracle';
+export declare const normalizeDialect: (raw: string | null | undefined) => SqlDialect | null;
+export { pathExists } from './path-exists.ts';

package/dist/sql.js

@@ -0,0 +1,15 @@
+import { cliSpec } from "./cli-spec.js";
+const stripKey = (raw) => raw.toLowerCase().replace(/[\s_\-]/g, '');
+export const normalizeDialect = (raw) => {
+    if (!raw)
+        return null;
+    const key = stripKey(raw);
+    if (cliSpec.providers.includes(key))
+        return key;
+    for (const [alias, canonical] of Object.entries(cliSpec.provider_aliases ?? {})) {
+        if (stripKey(alias) === key)
+            return canonical;
+    }
+    return null;
+};
+export { pathExists } from "./path-exists.js";

package/dist/templates/help/create.txt

@@ -0,0 +1,16 @@
+{{usage}}
+
+Creates a new <NNNN>_<name>_up.sql + <NNNN>_<name>_down.sql pair scaffolded
+with TODO placeholders. NNNN is one greater than the highest 1-4-digit
+sequence prefix already present in the migrations directory (starts at 0001).
+Legacy timestamp-prefixed filenames are ignored for numbering.
+
+  --provider         Database dialect. Required.
+  --name             snake_case slug for the new migration. Required. Must
+                     match /^[a-z][a-z0-9_]*$/.
+  --migrations-path  Migrations directory (default: ./sql/<dialect>/migrations).
+                     Created with mkdir -p if it does not exist.
+
+Examples:
+  {{command}} --provider sqlite --name add_users
+  {{command}} --provider postgres --name backfill_email_lower --migrations-path ./db/changes/postgres

package/dist/templates/help/down.txt

@@ -0,0 +1,42 @@
+{{usage}}
+
+Rolls back the MOST RECENTLY applied migration (one step). DESTRUCTIVE: prints a
+random 4-letter uppercase token on stderr and refuses to proceed unless the
+operator types it back on stdin (or passes --confirm <TOKEN> matching it).
+
+  --provider         Database dialect. Required.
+  --connection       Connection string. Required (or set the per-dialect env var below).
+  --migrations-path  Full path to the migrations directory.
+  --migrations-root  Root prefix; the script then looks at <migrations-root>/<dialect>/migrations.
+                     Defaults to 'sql'. Ignored when --migrations-path is also set.
+  --confirm          Skip the interactive prompt. The TOKEN must match the value
+                     printed on stderr at runtime — there is no fixed bypass value.
+
+Examples:
+  # sqlite — bare path or sqlite:// URL.
+  {{command}} --provider sqlite --connection ./app.sqlite
+  {{command}} --provider sqlite --connection sqlite:///absolute/path/app.sqlite
+
+  # postgres — URL or keyword form.
+  {{command}} --provider postgres --connection postgresql://user:pass@host:5432/dbname
+
+  # mysql — URL form.
+  {{command}} --provider mysql --connection mysql://user:pass@host:3306/dbname
+
+  # sqlserver / oracle — pass a driver-native connection string.
+  {{command}} --provider sqlserver --connection "Server=host;Database=dbname;User Id=user;Password=pass;"
+  {{command}} --provider oracle   --connection "user/pass@host:1521/service"
+
+  # env-var fallback when --connection is omitted:
+  SQLITE_PATH=./app.sqlite       {{command}} --provider sqlite
+  DATABASE_URL=postgresql://...  {{command}} --provider postgres
+
+  # custom migrations layout (default looks under sql/<dialect>/migrations):
+  {{command}} --provider sqlite --connection ./app.sqlite --migrations-path ./db/changes/sqlite
+
+Per-dialect env vars consulted when --connection is omitted:
+  sqlite     SQLITE_PATH, DB_PATH
+  postgres   PG_CONNECTION_STRING, DATABASE_URL
+  mysql      MYSQL_URL, DATABASE_URL
+  sqlserver  MSSQL_URL, DATABASE_URL
+  oracle     ORACLE_CONNECT_STRING, DATABASE_URL

package/dist/templates/help/init.txt

@@ -0,0 +1,13 @@
+{{usage}}
+
+Selects the dialects this tree will compile and install. Repeat --dialect
+once per provider. Re-running replaces the previous set. --all restores
+every dialect. Does not take --connection.
+
+  --dialect  Dialect to enable. Repeat for each dialect. Aliases from this file apply.
+  --all      Enable every dialect. Restores the committed full-provider set.
+
+Examples:
+  {{command}} --dialect sqlite --dialect postgres
+  {{command}} --dialect oracle
+  {{command}} --all

package/dist/templates/help/setup.txt

@@ -0,0 +1,41 @@
+{{usage}}
+
+Creates the bookkeeping tables (migrates, migrate_logs) for the chosen dialect
+and the migrations directory (mkdir -p). Idempotent — re-running against an
+already-setup database is a no-op. For sqlite, also mkdir -p of the parent
+directory of --connection so a fresh-tree path like ./.test/foo.sqlite works.
+
+  --provider         Database dialect. Required.
+  --connection       Connection string. Required (or set the per-dialect env var below).
+  --migrations-path  Migrations directory (default: ./sql/<dialect>/migrations).
+  --and-up           After setup, immediately invoke migrate-up so the chain is applied in one step.
+
+Examples:
+  # sqlite — bare path or sqlite:// URL; both create a file on disk.
+  {{command}} --provider sqlite --connection ./app.sqlite
+  {{command}} --provider sqlite --connection sqlite:///absolute/path/app.sqlite
+
+  # postgres — URL or keyword form.
+  {{command}} --provider postgres --connection postgresql://user:pass@host:5432/dbname
+
+  # mysql — URL form.
+  {{command}} --provider mysql --connection mysql://user:pass@host:3306/dbname
+
+  # sqlserver / oracle — pass a driver-native connection string.
+  {{command}} --provider sqlserver --connection "Server=host;Database=dbname;User Id=user;Password=pass;"
+  {{command}} --provider oracle   --connection "user/pass@host:1521/service"
+
+  # env-var fallback when --connection is omitted:
+  SQLITE_PATH=./app.sqlite       {{command}} --provider sqlite
+  DATABASE_URL=postgresql://...  {{command}} --provider postgres
+  DATABASE_URL=mysql://...       {{command}} --provider mysql
+
+  # explicit in-memory sqlite:
+  {{command}} --provider sqlite --connection :memory:
+
+Per-dialect env vars consulted when --connection is omitted:
+  sqlite     SQLITE_PATH, DB_PATH
+  postgres   PG_CONNECTION_STRING, DATABASE_URL
+  mysql      MYSQL_URL, DATABASE_URL
+  sqlserver  MSSQL_URL, DATABASE_URL
+  oracle     ORACLE_CONNECT_STRING, DATABASE_URL

package/dist/templates/help/up.txt

@@ -0,0 +1,43 @@
+{{usage}}
+
+Applies ALL pending migrations in sequence, each in its own transaction.
+
+  --provider         Database dialect. Required.
+  --connection       Connection string. Required (or set the per-dialect env var below).
+  --migrations-path  Full path to the migrations directory (e.g. sql/sqlite/migrations).
+  --migrations-root  Root prefix; the script then looks at <migrations-root>/<dialect>/migrations.
+                     Defaults to 'sql'. Ignored when --migrations-path is also set.
+  --one              Apply only the next pending migration, then exit. Default is to apply all pending migrations.
+
+Examples:
+  # sqlite — bare path or sqlite:// URL; both create a file on disk.
+  {{command}} --provider sqlite --connection ./app.sqlite
+  {{command}} --provider sqlite --connection sqlite:///absolute/path/app.sqlite
+
+  # postgres — URL or keyword form.
+  {{command}} --provider postgres --connection postgresql://user:pass@host:5432/dbname
+
+  # mysql — URL form.
+  {{command}} --provider mysql --connection mysql://user:pass@host:3306/dbname
+
+  # sqlserver / oracle — pass a driver-native connection string.
+  {{command}} --provider sqlserver --connection "Server=host;Database=dbname;User Id=user;Password=pass;"
+  {{command}} --provider oracle   --connection "user/pass@host:1521/service"
+
+  # env-var fallback when --connection is omitted:
+  SQLITE_PATH=./app.sqlite       {{command}} --provider sqlite
+  DATABASE_URL=postgresql://...  {{command}} --provider postgres
+
+  # custom migrations layout (default looks under sql/<dialect>/migrations):
+  {{command}} --provider sqlite --connection ./app.sqlite --migrations-path ./db/changes/sqlite
+  {{command}} --provider sqlite --connection ./app.sqlite --migrations-root ./db/changes
+
+  # one-shot: apply the next pending migration only, then exit.
+  {{command}} --provider sqlite --connection ./app.sqlite --one
+
+Per-dialect env vars consulted when --connection is omitted:
+  sqlite     SQLITE_PATH, DB_PATH
+  postgres   PG_CONNECTION_STRING, DATABASE_URL
+  mysql      MYSQL_URL, DATABASE_URL
+  sqlserver  MSSQL_URL, DATABASE_URL
+  oracle     ORACLE_CONNECT_STRING, DATABASE_URL

package/dist/templates/messages/checksum-drift-line.txt

@@ -0,0 +1 @@
+  {{name}}: stored {{stored}}..., current {{current}}...

package/dist/templates/messages/checksum-drift.txt

@@ -0,0 +1,11 @@
+Migration checksum drift detected — the migration file changed AFTER it was applied:
+{{lines}}
+
+The DB and source disagree about the schema you're running. Either the codegen
+regenerated an already-applied migration in place (the canonical bug — emit a NEW
+migration file instead), or the migrate state was hand-edited.
+
+Recovery options:
+  1. Emit a new migration that brings the DB up to the current schema, then deploy.
+  2. For showcase/dev DBs with no real data: wipe the DB file and let migrate:up re-run from scratch.
+  3. If you've verified the DB matches the new file: MIGRATE_ALLOW_CHECKSUM_DRIFT=1 npm run migrate:up

package/dist/templates/messages/down/confirm-mismatch.txt

@@ -0,0 +1 @@
+--confirm value ({{supplied}}) does not match the token printed above ({{token}}). Aborting.

package/dist/templates/messages/down/confirm-prompt.txt

@@ -0,0 +1 @@
+Type {{token}} to confirm rollback: 

package/dist/templates/messages/down/confirm-stdin-failed.txt

@@ -0,0 +1 @@
+failed to read confirmation from stdin — aborting.

package/dist/templates/messages/down/confirm-token-mismatch.txt

@@ -0,0 +1 @@
+Confirmation token did not match — aborting.

package/dist/templates/messages/down/confirm-tty-required.txt

@@ -0,0 +1 @@
+migrate-down requires interactive confirmation when stdin is not a TTY — pass --confirm {{token}} (this exact token, printed above) to proceed.

package/dist/templates/messages/down/destructive-header.txt

@@ -0,0 +1,3 @@
+
+⚠ DESTRUCTIVE: this rolls back the most recently applied migration on {{dialect}}.
+  Confirmation token: {{token}}

package/dist/templates/messages/errors/invalid-name.txt

@@ -0,0 +1 @@
+--name must be snake_case: lowercase letter then [a-z0-9_] (got "{{name}}")

package/dist/templates/messages/errors/migrate-path-not-dir.txt

@@ -0,0 +1 @@
+migrate-path is not a directory: {{path}}

package/dist/templates/messages/errors/missing-connection.txt

@@ -0,0 +1 @@
+missing --connection — pass --connection <url> (e.g. ./app.sqlite for sqlite) or set one of: {{envVars}}. Run with --help for examples.

package/dist/templates/messages/errors/missing-name-hint.txt

@@ -0,0 +1 @@
+missing --name — pass --name <snake_case_slug>.

package/dist/templates/messages/errors/missing-name.txt

@@ -0,0 +1 @@
+missing --name

package/dist/templates/messages/errors/missing-provider-hint.txt

@@ -0,0 +1 @@
+missing --provider — pass --provider <{{providers}}>. Run with --help for examples.

package/dist/templates/messages/errors/missing-provider.txt

@@ -0,0 +1 @@
+missing --provider

package/dist/templates/messages/errors/missing-value-for-flag.txt

@@ -0,0 +1 @@
+missing value for {{flag}}

package/dist/templates/messages/errors/rollback-no-down-sibling.txt

@@ -0,0 +1 @@
+Cannot roll back "{{name}}": no <stem>_down.sql sibling found

package/dist/templates/messages/errors/rollback-no-rollback-sibling.txt

@@ -0,0 +1 @@
+Cannot roll back "{{name}}": no rollback_*.sql sibling found

package/dist/templates/messages/errors/rollback-not-in-path.txt

@@ -0,0 +1 @@
+Most recently applied migration is not present under --migrate-path

package/dist/templates/messages/errors/sqlite-prerequisite.txt

@@ -0,0 +1 @@
+sqlite file: {{path}} does not exist — run 'migrate-setup --provider sqlite --connection {{path}}' to create it

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

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

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

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

package/dist/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/dist/templates/messages/status/applied.txt

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

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

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

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

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

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

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

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

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

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

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

package/dist/templates/scaffold/down.sql

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

package/dist/templates/scaffold/up.sql

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

package/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/dist/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/package.json

@@ -1,6 +1,80 @@
 {
   "name": "@deterministic-code/migraters",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.0.1",
+  "description": "TypeScript migrate executables for deterministic-code.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "bin": {
+    "migrate-up": "./dist/bin/migrate-up.js",
+    "migrate-down": "./dist/bin/migrate-down.js",
+    "migrate-setup": "./dist/bin/migrate-setup.js",
+    "migrate-create": "./dist/bin/migrate-create.js",
+    "migrate-init": "./dist/bin/migrate-init.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "cli.yaml",
+    "bundle.yaml",
+    "tsconfig.build.json"
+  ],
+  "scripts": {
+    "build": "rm -rf dist && tsc -p tsconfig.build.json && cp -R ../shared/templates dist/templates",
+    "prepare": "npm run build",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit",
+    "test": "vitest run --coverage",
+    "test:proof": "vitest run --config vitest.proof.config.ts",
+    "test:coverage": "vitest run --coverage",
+    "generate:help": "node --experimental-strip-types src/generate-help.ts",
+    "format": "prettier --write ."
+  },
+  "dependencies": {
+    "yaml": "^2.9.0"
+  },
+  "peerDependencies": {
+    "better-sqlite3": "^12.10.0",
+    "mssql": "^12.5.0",
+    "mysql2": "^3.22.2",
+    "oracledb": "^6.10.0",
+    "pg": "^8.13.0"
+  },
+  "peerDependenciesMeta": {
+    "better-sqlite3": {
+      "optional": true
+    },
+    "mssql": {
+      "optional": true
+    },
+    "mysql2": {
+      "optional": true
+    },
+    "oracledb": {
+      "optional": true
+    },
+    "pg": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "better-sqlite3": "^12.10.0",
+    "@types/mssql": "^12.3.0",
+    "@types/node": "^22.10.0",
+    "@types/oracledb": "^6.10.3",
+    "@types/pg": "^8.11.10",
+    "@vitest/coverage-v8": "^3.2.4",
+    "mssql": "^12.5.0",
+    "mysql2": "^3.22.2",
+    "oracledb": "^6.10.0",
+    "pg": "^8.13.0",
+    "prettier": "^3.9.6",
+    "typescript": "^5.8.0",
+    "vitest": "^3.2.4"
+  }
+}