@deterministic-code/migraters 0.0.1 → 0.0.2

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/bin/migrate-setup.ts

@@ -1,98 +0,0 @@
-#!/usr/bin/env node
-// Idempotent migrate-setup — creates the migrates + migrate_logs tracking tables per dialect.
-
-import { missingProviderMsg, requireConnection, requireDialect, takeFlag } from '../cli.ts';
-import { fillTemplate, loadMessage } from '../infrastructure/message-templates.ts';
-import { loadHelp, Migrater } from '../index.ts';
-
-const [HELP_TEXT, unknownArgTpl, setupCompleteTpl] = await Promise.all([
-  loadHelp('migrate-setup'),
-  loadMessage('errors/unknown-arg'),
-  loadMessage('setup-complete'),
-]);
-
-const parseArgs = (argv: string[]) => {
-  const args: {
-    provider: string | null;
-    connection: string | null;
-    migrationsPath: string | null;
-    andUp: boolean;
-  } = {
-    provider: null,
-    connection: null,
-    migrationsPath: null,
-    andUp: 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 === '--and-up') {
-      args.andUp = true;
-      continue;
-    }
-    let taken;
-    if ((taken = takeFlag(rest, i, a, '--provider'))) {
-      args.provider = taken.value;
-      i = taken.next;
-    } else if ((taken = takeFlag(rest, i, a, '--connection'))) {
-      args.connection = taken.value;
-      i = taken.next;
-    } else if (
-      (taken = takeFlag(rest, i, a, '--migrations-path')) ||
-      (taken = takeFlag(rest, i, a, '--migrate-path'))
-    ) {
-      args.migrationsPath = taken.value;
-      i = taken.next;
-    } else {
-      process.stderr.write(fillTemplate(unknownArgTpl, { arg: a }));
-      process.exit(2);
-    }
-  }
-  return args;
-};
-
-const main = async () => {
-  const args = parseArgs(process.argv);
-  if (!args.provider) {
-    process.stderr.write(missingProviderMsg);
-    process.exit(2);
-  }
-  const dialect = requireDialect(args.provider);
-  const connection = requireConnection(dialect, args.connection);
-
-  const migrationsPath = args.migrationsPath ?? `./sql/${dialect.name}/migrations`;
-  const migrater = new Migrater(dialect);
-  await migrater.setup({ connection, migrationsPath });
-  process.stdout.write(
-    fillTemplate(setupCompleteTpl, {
-      dialect: dialect.name,
-      migrationsPath,
-      createExample: `  migrate-create --provider ${dialect.name} --name add_users`,
-      upExample: `  migrate-up --provider ${dialect.name} --connection ${connection}`,
-    }),
-  );
-
-  if (args.andUp) {
-    const names = await migrater.up({ connection, migrationsPath });
-    const [noPendingMsg, noMorePendingMsg, appliedTpl] = await Promise.all([
-      loadMessage('status/no-pending'),
-      loadMessage('status/no-more-pending'),
-      loadMessage('status/applied'),
-    ]);
-    if (names.length === 0) process.stdout.write(noPendingMsg);
-    else {
-      for (const name of names) process.stdout.write(fillTemplate(appliedTpl, { name }));
-      process.stdout.write(noMorePendingMsg);
-    }
-  }
-};
-
-main().catch((e: unknown) => {
-  const err = e as Error;
-  process.stderr.write(`${err?.stack ?? err?.message ?? String(e)}\n`);
-  process.exit(1);
-});

package/src/bin/migrate-up.ts

@@ -1,111 +0,0 @@
-#!/usr/bin/env node
-// Default: applies ALL pending migrations in sequence, each in its own transaction. Pass --one to apply only the next pending migration (legacy one-shot behavior; useful when wrapping in an external loop or when you want to inspect state between steps).
-
-import { resolve } from 'node:path';
-import { missingProviderMsg, requireConnection, requireDialect, takeFlag } from '../cli.ts';
-import { fillTemplate, loadMessage } from '../infrastructure/message-templates.ts';
-import { loadHelp, Migrater } from '../index.ts';
-
-const [HELP_TEXT, unknownArgTpl, noPendingMsg, noMorePendingMsg, appliedTpl] = await Promise.all([
-  loadHelp('migrate-up'),
-  loadMessage('errors/unknown-arg'),
-  loadMessage('status/no-pending'),
-  loadMessage('status/no-more-pending'),
-  loadMessage('status/applied'),
-]);
-
-const parseArgs = (argv: string[]) => {
-  const args: {
-    provider: string | null;
-    migratePath: string | null;
-    migrateRoot: string | null;
-    connection: string | null;
-    one: boolean;
-  } = {
-    provider: null,
-    migratePath: null,
-    migrateRoot: null,
-    connection: null,
-    one: 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 === '--one') {
-      args.one = true;
-      continue;
-    }
-    let taken;
-    if ((taken = takeFlag(rest, i, a, '--provider'))) {
-      args.provider = taken.value;
-      i = taken.next;
-    } else if (
-      (taken = takeFlag(rest, i, a, '--migrations-path')) ||
-      (taken = takeFlag(rest, i, a, '--migrate-path'))
-    ) {
-      args.migratePath = taken.value;
-      i = taken.next;
-    } else if (
-      (taken = takeFlag(rest, i, a, '--migrations-root')) ||
-      (taken = takeFlag(rest, i, a, '--migrate-root'))
-    ) {
-      args.migrateRoot = taken.value;
-      i = taken.next;
-    } else if ((taken = takeFlag(rest, i, a, '--connection'))) {
-      args.connection = taken.value;
-      i = taken.next;
-    } else {
-      process.stderr.write(fillTemplate(unknownArgTpl, { arg: a }));
-      process.exit(2);
-    }
-  }
-  return args;
-};
-
-const resolveMigratePath = (
-  args: { migratePath: string | null; migrateRoot: string | null },
-  dialect: string,
-): string => {
-  if (args.migratePath) return args.migratePath;
-  const root = args.migrateRoot ?? 'sql';
-  return `${root}/${dialect}/migrations`;
-};
-
-const main = async () => {
-  const args = parseArgs(process.argv);
-  if (!args.provider) {
-    process.stderr.write(missingProviderMsg);
-    process.exit(2);
-  }
-  const dialect = requireDialect(args.provider);
-  const connection = requireConnection(dialect, args.connection);
-
-  const missing = await dialect.prerequisiteError(connection);
-  if (missing !== null) {
-    process.stderr.write(`${missing}\n`);
-    process.exit(2);
-  }
-
-  const migratePath = resolve(resolveMigratePath(args, dialect.name));
-  const names = await new Migrater(dialect).up({
-    connection,
-    migrationsPath: migratePath,
-    one: args.one,
-  });
-  if (names.length === 0) {
-    process.stdout.write(noPendingMsg);
-    return;
-  }
-  for (const name of names) process.stdout.write(fillTemplate(appliedTpl, { name }));
-  if (!args.one) process.stdout.write(noMorePendingMsg);
-};
-
-main().catch((e: unknown) => {
-  const err = e as Error;
-  process.stderr.write(`${err?.stack ?? err?.message ?? String(e)}\n`);
-  process.exit(1);
-});

package/src/cli-contract.ts

@@ -1,25 +0,0 @@
-export type { MigrateVerb } from './cli-spec.ts';
-export { migrateCommand, usageLine, programUsageText } from './cli-spec.ts';
-import { usageLine, type MigrateVerb } from './cli-spec.ts';
-import { fillTemplate } from './infrastructure/message-templates.ts';
-
-export const MIGRATE_VERBS = ['setup', 'up', 'down', 'create'] as const;
-
-export const verbFromCommand = (command: string): MigrateVerb => {
-  const verb = command.replace(/^migrate-/, '');
-  if (
-    verb !== 'init' &&
-    verb !== 'setup' &&
-    verb !== 'up' &&
-    verb !== 'down' &&
-    verb !== 'create'
-  ) {
-    throw new Error(`Unknown migrate command "${command}"`);
-  }
-  return verb;
-};
-
-export const fillHelpTemplate = (text: string, command: string): string => {
-  const usage = usageLine(verbFromCommand(command));
-  return fillTemplate(text, { command, usage });
-};

package/src/cli-spec.ts

@@ -1,64 +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';
-
-export type MigrateVerb = 'init' | 'setup' | 'up' | 'down' | 'create';
-
-export type CliArg = {
-  flag: string;
-  placeholder?: string;
-  required: boolean;
-};
-
-export type CliCommand = {
-  verb: MigrateVerb;
-  args: CliArg[];
-};
-
-export type CliSpec = {
-  command: string;
-  providers: string[];
-  provider_aliases: Record<string, string>;
-  aliases: Record<string, string>;
-  env_var_list_separator: string;
-  connection_environment: Record<string, string[]>;
-  commands: CliCommand[];
-};
-
-export const cliYamlPath = (): string => {
-  const here = dirname(fileURLToPath(import.meta.url));
-  const candidates = [
-    join(here, '..', 'cli.yaml'),
-    join(here, '..', '..', 'cli.yaml'),
-    join(process.cwd(), 'cli.yaml'),
-  ];
-  const found = candidates.find((candidate) => existsSync(candidate));
-  if (!found) {
-    throw new Error('cli.yaml not found');
-  }
-  return found;
-};
-
-export const cliSpec = parse(await readFile(cliYamlPath(), 'utf8')) as CliSpec;
-
-export const migrateCommand = (verb: MigrateVerb): string =>
-  cliSpec.command.replace('{verb}', verb);
-
-const providers = cliSpec.providers.join('|');
-
-const argUsage = (arg: CliArg): string => {
-  const ph = arg.placeholder === 'providers' ? providers : arg.placeholder;
-  const body = ph ? `${arg.flag} <${ph}>` : arg.flag;
-  return arg.required ? body : `[${body}]`;
-};
-
-export const usageLine = (verb: MigrateVerb): string => {
-  const command = cliSpec.commands.find((c) => c.verb === verb);
-  if (!command) throw new Error(`cli.yaml: missing command ${verb}`);
-  return `Usage: ${migrateCommand(verb)} ${command.args.map(argUsage).join(' ')}`;
-};
-
-export const programUsageText = (): string =>
-  `${cliSpec.commands.map((c) => usageLine(c.verb)).join('\n')}\n`;

package/src/cli.ts

@@ -1,52 +0,0 @@
-import { connectionResolver, defaultDialectFactory } from './infrastructure/default-factory.ts';
-import type { ISqlDialect } from './abstractions/sql-dialect.ts';
-import { cliSpec } from './cli-spec.ts';
-import { fillTemplate, loadMessage } from './infrastructure/message-templates.ts';
-
-const missingProviderMsg = await loadMessage('errors/missing-provider');
-const unsupportedProviderTpl = await loadMessage('errors/unsupported-provider');
-const missingConnectionTpl = await loadMessage('errors/missing-connection');
-
-export { missingProviderMsg };
-
-export const requireDialect = (provider: string | null): ISqlDialect => {
-  if (!provider) {
-    process.stderr.write(missingProviderMsg);
-    process.exit(2);
-  }
-  const dialect = defaultDialectFactory.tryGet(provider);
-  if (!dialect) {
-    process.stderr.write(fillTemplate(unsupportedProviderTpl, { provider }));
-    process.exit(2);
-  }
-  return dialect;
-};
-
-export const requireConnection = (dialect: ISqlDialect, fromFlag: string | null): string => {
-  const connection = connectionResolver.resolve(dialect, fromFlag);
-  if (!connection) {
-    process.stderr.write(
-      fillTemplate(missingConnectionTpl, {
-        envVars: dialect.connectionEnvironmentVariables.join(cliSpec.env_var_list_separator),
-      }),
-    );
-    process.exit(2);
-  }
-  return connection;
-};
-
-export 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;
-};

package/src/create-sequence.ts

@@ -1,17 +0,0 @@
-export const MIGRATION_NAME_RE = /^[a-z][a-z0-9_]*$/;
-const SEQ_RE = /^(\d{1,4})_.*_up\.sql$/;
-
-export const isMigrationName = (name: string): boolean => MIGRATION_NAME_RE.test(name);
-
-export const nextSequence = (filenames: Iterable<string>): number => {
-  let max = 0;
-  for (const name of filenames) {
-    const m = SEQ_RE.exec(name);
-    if (!m) continue;
-    const n = Number.parseInt(m[1] as string, 10);
-    if (n > max) max = n;
-  }
-  return max + 1;
-};
-
-export const pad4 = (n: number): string => String(n).padStart(4, '0');