@danceroutine/tango-migrations 1.11.1 → 1.11.2

package/dist/introspect/PostgresIntrospector.d.ts

@@ -1,56 +0,0 @@
-import type { DBClient, DatabaseIntrospector } from './DatabaseIntrospector';
-/** Introspected column metadata. */
-export interface DbColumn {
-    name: string;
-    type: string;
-    notNull: boolean;
-    default: string | null;
-    isPk: boolean;
-    isUnique: boolean;
-}
-/** Introspected index metadata. */
-export interface DbIndex {
-    name: string;
-    table: string;
-    unique: boolean;
-    columns: string[];
-    where: string | null;
-}
-/** Introspected foreign key metadata. */
-export interface DbForeignKey {
-    name: string;
-    table: string;
-    columns: string[];
-    refTable: string;
-    refColumns: string[];
-    onDelete: string | null;
-    onUpdate: string | null;
-    validated: boolean;
-}
-/** Introspected table metadata. */
-export interface DbTable {
-    name: string;
-    columns: Record<string, DbColumn>;
-    pks: string[];
-    indexes: Record<string, DbIndex>;
-    fks: Record<string, DbForeignKey>;
-}
-/** Introspected schema metadata. */
-export interface DbSchema {
-    tables: Record<string, DbTable>;
-}
-/**
- * PostgreSQL implementation of schema introspection.
- */
-export declare class PostgresIntrospector implements DatabaseIntrospector {
-    static readonly BRAND: "tango.migrations.postgres_introspector";
-    readonly __tangoBrand: typeof PostgresIntrospector.BRAND;
-    /**
-     * Narrow an unknown value to the PostgreSQL schema introspector.
-     */
-    static isPostgresIntrospector(value: unknown): value is PostgresIntrospector;
-    /**
-     * Read table and column metadata from PostgreSQL system catalogs.
-     */
-    introspect(client: DBClient): Promise<DbSchema>;
-}

package/dist/introspect/SqliteIntrospector.d.ts

@@ -1,53 +0,0 @@
-import type { DBClient, DatabaseIntrospector } from './DatabaseIntrospector';
-/** Introspected column metadata. */
-export interface DbColumn {
-    name: string;
-    type: string;
-    notNull: boolean;
-    default: string | null;
-    isPk: boolean;
-    isUnique: boolean;
-}
-/** Introspected table metadata. */
-export interface DbTable {
-    name: string;
-    columns: Record<string, DbColumn>;
-    pks: string[];
-    indexes: Record<string, {
-        name: string;
-        table: string;
-        unique: boolean;
-        columns: string[];
-        where: string | null;
-    }>;
-    fks: Record<string, {
-        name: string;
-        table: string;
-        columns: string[];
-        refTable: string;
-        refColumns: string[];
-        onDelete: string | null;
-        onUpdate: string | null;
-        validated: boolean;
-    }>;
-}
-/** Introspected schema metadata. */
-export interface DbSchema {
-    tables: Record<string, DbTable>;
-}
-/**
- * SQLite implementation of schema introspection.
- */
-export declare class SqliteIntrospector implements DatabaseIntrospector {
-    static readonly BRAND: "tango.migrations.sqlite_introspector";
-    readonly __tangoBrand: typeof SqliteIntrospector.BRAND;
-    private readonly sqlSafety;
-    /**
-     * Narrow an unknown value to the SQLite schema introspector.
-     */
-    static isSqliteIntrospector(value: unknown): value is SqliteIntrospector;
-    /**
-     * Read table/column/index metadata from SQLite pragmas.
-     */
-    introspect(client: DBClient): Promise<DbSchema>;
-}

package/dist/introspect-DD3fm15e.js

@@ -1,13 +0,0 @@
-import { __export } from "./chunk-BkvOhyD0.js";
-import { PostgresIntrospector, SqliteIntrospector } from "./SqliteIntrospector-CWwPWhmA.js";
-
-//#region src/introspect/index.ts
-var introspect_exports = {};
-__export(introspect_exports, {
-	PostgresIntrospector: () => PostgresIntrospector,
-	SqliteIntrospector: () => SqliteIntrospector
-});
-
-//#endregion
-export { introspect_exports };
-//# sourceMappingURL=introspect-DD3fm15e.js.map

package/dist/introspect-DD3fm15e.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"introspect-DD3fm15e.js","names":[],"sources":["../src/introspect/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport type { DBClient, DatabaseIntrospector } from './DatabaseIntrospector';\nexport {\n    PostgresIntrospector,\n    type DbColumn as PostgresDbColumn,\n    type DbForeignKey as PostgresDbForeignKey,\n    type DbIndex as PostgresDbIndex,\n    type DbSchema as PostgresDbSchema,\n    type DbTable as PostgresDbTable,\n} from './PostgresIntrospector';\nexport {\n    SqliteIntrospector,\n    type DbColumn as SqliteDbColumn,\n    type DbSchema as SqliteDbSchema,\n    type DbTable as SqliteDbTable,\n} from './SqliteIntrospector';\n"],"mappings":""}

package/dist/runner/MigrationRunner.d.ts

@@ -1,79 +0,0 @@
-import type { Dialect } from '../domain/Dialect';
-import type { CompilerStrategy } from '../strategies/CompilerStrategy';
-/** DB client contract required by migration execution. */
-interface DBClient {
-    /** Execute SQL with optional parameters. */
-    query<T = unknown>(sql: string, params?: readonly unknown[]): Promise<{
-        rows: T[];
-    }>;
-    /** Release underlying database resources. */
-    close(): Promise<void>;
-}
-/**
- * Manages the lifecycle of database migrations: applying, planning, and tracking status.
- *
- * The runner reads migration files from a directory, compiles operations to SQL
- * for the target dialect, and maintains a journal table to track which migrations
- * have been applied. Each applied migration is checksummed to detect tampering.
- *
- * @example
- * ```typescript
- * const runner = new MigrationRunner(client, 'postgres', './migrations');
- *
- * // Apply all pending migrations
- * await runner.apply();
- *
- * // Apply up to a specific migration
- * await runner.apply('003_add_indexes');
- *
- * // Preview the SQL that would be generated
- * const sql = await runner.plan();
- *
- * // Check which migrations are applied
- * const statuses = await runner.status();
- * ```
- */
-export declare class MigrationRunner {
-    private client;
-    private dialect;
-    private migrationsDir;
-    static readonly BRAND: "tango.migrations.runner";
-    readonly __tangoBrand: typeof MigrationRunner.BRAND;
-    private compilerStrategy;
-    constructor(client: DBClient, dialect: Dialect, migrationsDir?: string, compilerStrategy?: CompilerStrategy);
-    /**
-     * Narrow an unknown value to `MigrationRunner`.
-     */
-    static isMigrationRunner(value: unknown): value is MigrationRunner;
-    /**
-     * Apply all pending migrations, optionally stopping at a specific migration ID.
-     * Migrations are applied in file-sort order. Already-applied migrations are skipped.
-     * Non-online migrations are wrapped in a transaction on Postgres.
-     */
-    apply(toId?: string): Promise<void>;
-    /**
-     * Generate a dry-run SQL plan for all migrations without executing anything.
-     * Useful for reviewing what SQL would be run before applying.
-     */
-    plan(): Promise<string>;
-    /**
-     * Return the applied/pending status of every migration found on disk.
-     */
-    status(): Promise<{
-        id: string;
-        applied: boolean;
-    }[]>;
-    private ensureJournal;
-    private listApplied;
-    private loadMigrations;
-    private applyMigration;
-    /**
-     * Compute a simple hash of the migration's operation list.
-     * Stored alongside each applied migration in the journal table to detect
-     * if a migration file has been modified after it was already applied.
-     * Uses a djb2-like hash over the JSON-serialized operations.
-     */
-    private hashJSON;
-    private compileOperation;
-}
-export {};

package/dist/runner-C97xT8_W.js

@@ -1,10 +0,0 @@
-import { __export } from "./chunk-BkvOhyD0.js";
-import { MigrationRunner } from "./MigrationRunner-DomrOZIn.js";
-
-//#region src/runner/index.ts
-var runner_exports = {};
-__export(runner_exports, { MigrationRunner: () => MigrationRunner });
-
-//#endregion
-export { runner_exports };
-//# sourceMappingURL=runner-C97xT8_W.js.map

package/dist/runner-C97xT8_W.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runner-C97xT8_W.js","names":[],"sources":["../src/runner/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { MigrationRunner } from './MigrationRunner';\n"],"mappings":""}

package/dist/runtime/loadModule.d.ts

@@ -1,18 +0,0 @@
-import { ModelRegistry } from '@danceroutine/tango-schema';
-/**
- * Load a module from a Tango app project root.
- *
- * TypeScript modules are loaded through jiti and JavaScript/ESM modules are loaded
- * through native dynamic import so published installs behave like end-user runtime.
- */
-export declare function loadModule(modulePath: string, options?: {
-    projectRoot?: string;
-    registry?: ModelRegistry;
-    moduleCache?: boolean;
-}): Promise<Record<string, unknown>>;
-/**
- * Load a module and return default export when present.
- */
-export declare function loadDefaultExport(modulePath: string, options?: {
-    projectRoot?: string;
-}): Promise<unknown>;

package/dist/schema/buildMigrationModelMetadataProjection.d.ts

@@ -1,3 +0,0 @@
-import type { ModelRegistry } from '@danceroutine/tango-schema';
-import type { ModelMetadataLike } from '../diff/diffSchema';
-export declare function buildMigrationModelMetadataProjection(registry: ModelRegistry): ModelMetadataLike[];

package/dist/strategies/CompilerStrategy.d.ts

@@ -1,42 +0,0 @@
-import type { CompilerFactory } from '../compilers/contracts/CompilerFactory';
-import type { Dialect } from '../domain/Dialect';
-import type { CustomMigrationOperation, MigrationOperation } from '../domain/MigrationOperation';
-import type { SQL } from '../compilers/contracts/SQL';
-import type { SQLCompiler } from '../compilers/contracts/SQLCompiler';
-type CompilerFactoryRegistry = Record<Dialect, CompilerFactory>;
-/**
- * Dialect-aware SQL compiler orchestration with optional custom-op handlers.
- */
-export declare class CompilerStrategy {
-    private readonly factories;
-    static readonly BRAND: "tango.migrations.compiler_strategy";
-    readonly __tangoBrand: typeof CompilerStrategy.BRAND;
-    private readonly compilerCache;
-    private readonly customHandlers;
-    constructor(factories: CompilerFactoryRegistry);
-    /**
-     * Narrow an unknown value to the dialect-aware migration compiler strategy.
-     */
-    static isCompilerStrategy(value: unknown): value is CompilerStrategy;
-    /**
-     * Prepare a batch of migration operations for a target dialect.
-     */
-    prepareOperations(dialect: Dialect, operations: MigrationOperation[]): MigrationOperation[];
-    /**
-     * Compile a migration operation to SQL for a target dialect.
-     */
-    compile(dialect: Dialect, operation: MigrationOperation): SQL[];
-    /**
-     * Register a handler for custom migration operations.
-     */
-    registerCustomHandler<TName extends string, TArgs extends object>(name: TName, handler: (dialect: Dialect, op: CustomMigrationOperation<TName, TArgs>) => SQL[]): this;
-    /**
-     * Resolve and cache a compiler instance for a dialect.
-     */
-    getCompiler(dialect: Dialect): SQLCompiler;
-}
-/**
- * Create the default compiler strategy with built-in dialect factories.
- */
-export declare function createDefaultCompilerStrategy(): CompilerStrategy;
-export {};

package/dist/strategies/IntrospectorStrategy.d.ts

@@ -1,34 +0,0 @@
-import type { DBClient, DatabaseIntrospector } from '../introspect/DatabaseIntrospector';
-import type { Dialect } from '../domain/Dialect';
-import type { DbSchema } from '../introspect/PostgresIntrospector';
-type IntrospectorFactory = {
-    create(): DatabaseIntrospector;
-};
-type IntrospectorFactoryRegistry = Record<Dialect, IntrospectorFactory>;
-/**
- * Dialect-aware schema introspection orchestration.
- */
-export declare class IntrospectorStrategy {
-    private readonly factories;
-    static readonly BRAND: "tango.migrations.introspector_strategy";
-    readonly __tangoBrand: typeof IntrospectorStrategy.BRAND;
-    private readonly introspectorCache;
-    constructor(factories: IntrospectorFactoryRegistry);
-    /**
-     * Narrow an unknown value to the dialect-aware schema introspection strategy.
-     */
-    static isIntrospectorStrategy(value: unknown): value is IntrospectorStrategy;
-    /**
-     * Introspect database schema using a dialect-specific introspector.
-     */
-    introspect(dialect: Dialect, client: DBClient): Promise<DbSchema>;
-    /**
-     * Resolve and cache an introspector instance for a dialect.
-     */
-    getIntrospector(dialect: Dialect): DatabaseIntrospector;
-}
-/**
- * Create the default introspector strategy with built-in dialect support.
- */
-export declare function createDefaultIntrospectorStrategy(): IntrospectorStrategy;
-export {};

package/dist/strategies-HwUWvmLC.js

@@ -1,16 +0,0 @@
-import { __export } from "./chunk-BkvOhyD0.js";
-import { CompilerStrategy, createDefaultCompilerStrategy } from "./CompilerStrategy-_AiXiyjS.js";
-import { IntrospectorStrategy, createDefaultIntrospectorStrategy } from "./IntrospectorStrategy-BEIG5GqA.js";
-
-//#region src/strategies/index.ts
-var strategies_exports = {};
-__export(strategies_exports, {
-	CompilerStrategy: () => CompilerStrategy,
-	IntrospectorStrategy: () => IntrospectorStrategy,
-	createDefaultCompilerStrategy: () => createDefaultCompilerStrategy,
-	createDefaultIntrospectorStrategy: () => createDefaultIntrospectorStrategy
-});
-
-//#endregion
-export { strategies_exports };
-//# sourceMappingURL=strategies-HwUWvmLC.js.map

package/dist/strategies-HwUWvmLC.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"strategies-HwUWvmLC.js","names":[],"sources":["../src/strategies/index.ts"],"sourcesContent":["/**\n * Domain boundary barrel: centralizes this subdomain's public contract.\n */\n\nexport { CompilerStrategy, createDefaultCompilerStrategy } from './CompilerStrategy';\nexport { IntrospectorStrategy, createDefaultIntrospectorStrategy } from './IntrospectorStrategy';\n"],"mappings":""}