@deterministic-code/migraters 0.0.1 → 0.0.3

package/dist/infrastructure/connection-resolver.js

@@ -1,19 +0,0 @@
-export class ConnectionResolver {
-    env;
-    constructor(env = process.env) {
-        this.env = env;
-    }
-    fromEnvironment(dialect) {
-        for (const name of dialect.connectionEnvironmentVariables) {
-            const value = this.env[name];
-            if (value)
-                return value;
-        }
-        return null;
-    }
-    resolve(dialect, fromFlag) {
-        if (fromFlag)
-            return fromFlag;
-        return this.fromEnvironment(dialect);
-    }
-}

package/dist/infrastructure/default-factory.d.ts

@@ -1,4 +0,0 @@
-import { SqlDialectFactory } from '../abstractions/sql-dialect-factory.ts';
-import { ConnectionResolver } from './connection-resolver.ts';
-export declare const defaultDialectFactory: SqlDialectFactory;
-export declare const connectionResolver: ConnectionResolver;

package/dist/infrastructure/default-factory.js

@@ -1,15 +0,0 @@
-import { SqlDialectFactory } from "../abstractions/sql-dialect-factory.js";
-import { MysqlDialect } from "../dialects/mysql-dialect.js";
-import { OracleDialect } from "../dialects/oracle-dialect.js";
-import { PostgresDialect } from "../dialects/postgres-dialect.js";
-import { SqliteDialect } from "../dialects/sqlite-dialect.js";
-import { SqlServerDialect } from "../dialects/sqlserver-dialect.js";
-import { ConnectionResolver } from "./connection-resolver.js";
-export const defaultDialectFactory = new SqlDialectFactory([
-    new SqliteDialect(),
-    new PostgresDialect(),
-    new MysqlDialect(),
-    new SqlServerDialect(),
-    new OracleDialect(),
-]);
-export const connectionResolver = new ConnectionResolver();

package/dist/infrastructure/interop-default.d.ts

@@ -1,3 +0,0 @@
-export declare const interopDefault: <T>(mod: {
-    default?: T;
-}) => T;

package/dist/infrastructure/interop-default.js

@@ -1 +0,0 @@
-export const interopDefault = (mod) => (mod.default ?? mod);

package/dist/infrastructure/message-templates.d.ts

@@ -1,3 +0,0 @@
-export declare const fillTemplate: (text: string, vars: Record<string, string>) => string;
-export declare const loadMessage: (relativePath: string, vars?: Record<string, string>) => Promise<string>;
-export declare const loadScaffold: (name: "up" | "down", vars: Record<string, string>) => Promise<string>;

package/dist/infrastructure/message-templates.js

@@ -1,18 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { templatesRoot } from "./templates-root.js";
-export const fillTemplate = (text, vars) => {
-    let out = text;
-    for (const [key, value] of Object.entries(vars)) {
-        out = out.replaceAll(`{{${key}}}`, value);
-    }
-    return out;
-};
-export const loadMessage = async (relativePath, vars = {}) => {
-    const text = await readFile(join(templatesRoot(), 'messages', `${relativePath}.txt`), 'utf8');
-    return fillTemplate(text, vars);
-};
-export const loadScaffold = async (name, vars) => {
-    const text = await readFile(join(templatesRoot(), 'scaffold', `${name}.sql`), 'utf8');
-    return fillTemplate(text, vars);
-};

package/dist/infrastructure/split-on-go.d.ts

@@ -1,2 +0,0 @@
-/** Split migration SQL on whole-line GO batch separators. */
-export declare function splitOnGo(text: string): string[];

package/dist/infrastructure/split-on-go.js

@@ -1,20 +0,0 @@
-const GO_LINE = /^\s*GO\s*$/i;
-/** Split migration SQL on whole-line GO batch separators. */
-export function splitOnGo(text) {
-    const batches = [];
-    let buf = '';
-    for (const line of text.replace(/\r\n/g, '\n').split('\n')) {
-        if (GO_LINE.test(line)) {
-            const s = buf.trim();
-            if (s.length > 0)
-                batches.push(s);
-            buf = '';
-            continue;
-        }
-        buf = buf.length > 0 ? `${buf}\n${line}` : line;
-    }
-    const tail = buf.trim();
-    if (tail.length > 0)
-        batches.push(tail);
-    return batches;
-}

package/dist/infrastructure/sql-templates.d.ts

@@ -1,2 +0,0 @@
-import type { SqlDialect } from '../sql.ts';
-export declare const readSqlTemplate: (dialect: SqlDialect, name: "migrates" | "migrate_logs") => Promise<string>;

package/dist/infrastructure/sql-templates.js

@@ -1,4 +0,0 @@
-import { readFile } from 'node:fs/promises';
-import { join } from 'node:path';
-import { templatesRoot } from "./templates-root.js";
-export const readSqlTemplate = async (dialect, name) => (await readFile(join(templatesRoot(), 'sql', dialect, `${name}.sql`), 'utf8')).trim();

package/dist/infrastructure/templates-root.d.ts

@@ -1,2 +0,0 @@
-/** Repo `shared/templates`; after build, `dist/templates` (copied from shared). */
-export declare const templatesRoot: () => string;

package/dist/infrastructure/templates-root.js

@@ -1,11 +0,0 @@
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-const HERE = dirname(fileURLToPath(import.meta.url));
-/** Repo `shared/templates`; after build, `dist/templates` (copied from shared). */
-export const templatesRoot = () => {
-    const normalized = HERE.replaceAll('\\', '/');
-    if (normalized.endsWith('/dist/infrastructure')) {
-        return join(HERE, '..', 'templates');
-    }
-    return join(HERE, '..', '..', '..', 'shared', 'templates');
-};

package/dist/init-select.d.ts

@@ -1,12 +0,0 @@
-export type SelectedDialects = {
-    names: string[];
-    packages: {
-        name: string;
-        version: string;
-    }[];
-    allDriverPackages: string[];
-};
-export declare const normalizeInitProvider: (raw: string) => string | undefined;
-export declare const resolveInitDialects: (raw: string[], all: boolean) => string[];
-export declare const bundleYamlPath: () => string;
-export declare const loadSelectedPackages: (dialects: string[]) => Promise<SelectedDialects>;

package/dist/init-select.js

@@ -1,52 +0,0 @@
-import { existsSync } from 'node:fs';
-import { readFile } from 'node:fs/promises';
-import { dirname, join } from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { parse } from 'yaml';
-import { cliSpec } from "./cli-spec.js";
-const stripKey = (raw) => raw.replace(/[\s_-]/g, '').toLowerCase();
-export const normalizeInitProvider = (raw) => {
-    const key = stripKey(raw);
-    const direct = cliSpec.providers.find((p) => stripKey(p) === key);
-    if (direct)
-        return direct;
-    return cliSpec.provider_aliases[key];
-};
-export const resolveInitDialects = (raw, all) => {
-    if (all)
-        return [...cliSpec.providers];
-    if (raw.length === 0) {
-        throw new Error('pass --dialect <provider> at least once, or --all');
-    }
-    const selected = new Set();
-    for (const value of raw) {
-        const name = normalizeInitProvider(value);
-        if (!name) {
-            throw new Error(`unsupported provider: ${value}`);
-        }
-        selected.add(name);
-    }
-    return cliSpec.providers.filter((name) => selected.has(name));
-};
-export const bundleYamlPath = () => {
-    const here = dirname(fileURLToPath(import.meta.url));
-    const candidates = [
-        join(here, '..', 'bundle.yaml'),
-        join(here, '..', '..', 'bundle.yaml'),
-        join(process.cwd(), 'bundle.yaml'),
-    ];
-    const found = candidates.find((candidate) => existsSync(candidate));
-    if (!found) {
-        throw new Error('bundle.yaml not found');
-    }
-    return found;
-};
-export const loadSelectedPackages = async (dialects) => {
-    const raw = parse(await readFile(bundleYamlPath(), 'utf8'));
-    const byName = raw.languages?.typescript?.dialects ?? {};
-    const allDriverPackages = [
-        ...new Set(Object.values(byName).flatMap((d) => (d.packages ?? []).map((p) => p.name))),
-    ];
-    const packages = dialects.flatMap((name) => byName[name]?.packages ?? []);
-    return { names: dialects, packages, allDriverPackages };
-};

package/dist/migrater.d.ts

@@ -1,12 +0,0 @@
-import type { CreateArg, CreateResponse, DownArg, IMigrater, SetupArg, UpArg } from './abstractions/migrater.ts';
-import type { ISqlDialect } from './abstractions/sql-dialect.ts';
-export declare class Migrater implements IMigrater {
-    private readonly dialect;
-    constructor(dialect: ISqlDialect);
-    get name(): string;
-    setup({ connection, migrationsPath }: SetupArg): Promise<void>;
-    up({ connection, migrationsPath, one }: UpArg): Promise<string[]>;
-    down({ connection, migrationsPath }: DownArg): Promise<string | null>;
-    create({ name, migrationsPath }: CreateArg): Promise<CreateResponse>;
-}
-export declare const getMigrater: (provider: string) => IMigrater;

package/dist/migrater.js

@@ -1,84 +0,0 @@
-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

@@ -1,21 +0,0 @@
-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

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

package/dist/path-exists.d.ts

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

package/dist/path-exists.js

@@ -1,10 +0,0 @@
-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

@@ -1,3 +0,0 @@
-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

@@ -1,15 +0,0 @@
-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/init.txt

@@ -1,13 +0,0 @@
-{{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/messages/down/confirm-prompt.txt

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

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

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

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

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

package/src/bin/migrate-init.ts

@@ -1,88 +0,0 @@
-#!/usr/bin/env node
-import { spawnSync } from 'node:child_process';
-import { loadHelp } from '../help.ts';
-import { loadSelectedPackages, resolveInitDialects } from '../init-select.ts';
-
-const HELP_TEXT = await loadHelp('migrate-init');
-
-const takeFlag = (
-  rest: string[],
-  i: number,
-  arg: string,
-  flag: string,
-): { value: string; next: number } | undefined => {
-  const eq = `${flag}=`;
-  if (arg === flag) {
-    const value = rest[i + 1];
-    if (value === undefined) return undefined;
-    return { value, next: i + 1 };
-  }
-  if (arg.startsWith(eq)) return { value: arg.slice(eq.length), next: i };
-  return undefined;
-};
-
-const parseArgs = (argv: string[]) => {
-  const dialects: string[] = [];
-  let all = false;
-  const rest = argv.slice(2);
-  for (let i = 0; i < rest.length; i++) {
-    const a = rest[i] as string;
-    if (a === '-h' || a === '--help') {
-      process.stderr.write(HELP_TEXT);
-      process.exit(0);
-    }
-    if (a === '--all') {
-      all = true;
-      continue;
-    }
-    const taken = takeFlag(rest, i, a, '--dialect');
-    if (taken) {
-      dialects.push(taken.value);
-      i = taken.next;
-      continue;
-    }
-    process.stderr.write(`unknown arg: ${a}\n`);
-    process.exit(2);
-  }
-  return { dialects, all };
-};
-
-const npmFlags = ['--no-audit', '--no-fund', '--loglevel=error'];
-
-const npm = (args: string[]): void => {
-  const cmd = process.platform === 'win32' ? 'npm.cmd' : 'npm';
-  const result = spawnSync(cmd, args, { stdio: 'inherit', cwd: process.cwd() });
-  if (result.status !== 0) {
-    process.exit(result.status ?? 1);
-  }
-};
-
-const main = async () => {
-  const args = parseArgs(process.argv);
-  let names: string[];
-  try {
-    names = resolveInitDialects(args.dialects, args.all);
-  } catch (e) {
-    const err = e as Error;
-    process.stderr.write(`${err.message}\n`);
-    process.exit(2);
-  }
-  const selected = await loadSelectedPackages(names);
-  const specs = selected.packages.map((p) => `${p.name}@${p.version}`);
-  if (specs.length > 0) {
-    npm(['install', ...npmFlags, ...specs]);
-  }
-  const remove = selected.allDriverPackages.filter(
-    (name) => !selected.packages.some((p) => p.name === name),
-  );
-  if (remove.length > 0) {
-    npm(['uninstall', ...npmFlags, ...remove]);
-  }
-  process.stdout.write(`Enabled dialects: ${selected.names.join(', ')}\n`);
-};
-
-main().catch((e: unknown) => {
-  const err = e as Error;
-  process.stderr.write(`${err?.stack ?? err?.message ?? String(e)}\n`);
-  process.exit(1);
-});

package/src/infrastructure/default-factory.test.ts

@@ -1,18 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { defaultDialectFactory } from './default-factory.ts';
-
-describe('defaultDialectFactory', () => {
-  it('registers every dialect name and alias', () => {
-    const names = defaultDialectFactory.all().map((d) => d.name);
-    expect(names).toEqual(['sqlite', 'postgres', 'mysql', 'sqlserver', 'oracle']);
-    expect(defaultDialectFactory.get('sqlite3').name).toBe('sqlite');
-    expect(defaultDialectFactory.get('postgresql').name).toBe('postgres');
-    expect(defaultDialectFactory.get('mariadb').name).toBe('mysql');
-    expect(defaultDialectFactory.get('mssql').name).toBe('sqlserver');
-    expect(defaultDialectFactory.get('mssqlserver').name).toBe('sqlserver');
-    expect(defaultDialectFactory.get('ms-sql-server').name).toBe('sqlserver');
-    expect(defaultDialectFactory.get('ora').name).toBe('oracle');
-    expect(defaultDialectFactory.tryGet('nope')).toBeUndefined();
-    expect(() => defaultDialectFactory.get('nope')).toThrow(/Unknown SQL dialect/);
-  });
-});

package/src/infrastructure/default-factory.ts

@@ -1,17 +0,0 @@
-import { SqlDialectFactory } from '../abstractions/sql-dialect-factory.ts';
-import { MysqlDialect } from '../dialects/mysql-dialect.ts';
-import { OracleDialect } from '../dialects/oracle-dialect.ts';
-import { PostgresDialect } from '../dialects/postgres-dialect.ts';
-import { SqliteDialect } from '../dialects/sqlite-dialect.ts';
-import { SqlServerDialect } from '../dialects/sqlserver-dialect.ts';
-import { ConnectionResolver } from './connection-resolver.ts';
-
-export const defaultDialectFactory = new SqlDialectFactory([
-  new SqliteDialect(),
-  new PostgresDialect(),
-  new MysqlDialect(),
-  new SqlServerDialect(),
-  new OracleDialect(),
-]);
-
-export const connectionResolver = new ConnectionResolver();