purplekit 1.0.0

package/build/src/features/gen.js

@@ -0,0 +1,241 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasSchemaChanges = exports.saveMig = exports.getMetadata = exports.compareMig = exports.genMig = exports.generate = exports.gen = void 0;
+const typeorm_extension_1 = require("typeorm-extension");
+const create_ds_1 = require("../libs/create-ds");
+const print_1 = require("../libs/print");
+const config_1 = require("../config");
+const sanitize_1 = require("../libs/sanitize");
+const compare_mig_1 = require("../libs/compare-mig");
+Object.defineProperty(exports, "compareMig", { enumerable: true, get: function () { return compare_mig_1.compareMig; } });
+const migrate_1 = require("./migrate");
+const paths_1 = require("../libs/paths");
+const prettier_1 = __importDefault(require("prettier"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Detects pending schema changes by diffing entities against the database.
+ *
+ * @param ds - Initialized TypeORM data source.
+ * @returns Whether up or down migration queries would be generated.
+ */
+const hasSchemaChanges = (ds) => __awaiter(void 0, void 0, void 0, function* () {
+    const builder = ds.driver.createSchemaBuilder();
+    const sqlInMemory = yield builder.log();
+    const val = sqlInMemory.upQueries.length > 0 || sqlInMemory.downQueries.length > 0;
+    return val;
+});
+exports.hasSchemaChanges = hasSchemaChanges;
+/**
+ * Generates a migration preview from an initialized data source and formats it.
+ *
+ * @param ds - Initialized TypeORM data source to diff against.
+ * @param name - Migration class/name prefix.
+ * @param timestamp - Timestamp suffix TypeORM uses in the migration class.
+ * @returns Generated source, formatted source, and whether schema changes exist.
+ */
+const genMig = (ds, name, timestamp) => __awaiter(void 0, void 0, void 0, function* () {
+    const hasChanges = yield hasSchemaChanges(ds);
+    const result = yield (0, typeorm_extension_1.generateMigration)({
+        name,
+        timestamp,
+        dataSource: ds,
+        preview: true,
+    });
+    const formatted = yield prettier_1.default.format(result.content, {
+        parser: 'typescript',
+        singleQuote: true,
+        trailingComma: 'all',
+        tabWidth: 2,
+    });
+    return {
+        content: result.content,
+        formatted,
+        hasChanges,
+    };
+});
+exports.genMig = genMig;
+/**
+ * Persists a generated migration file, creating its parent folder first.
+ *
+ * @param location - Destination `migration.ts` path.
+ * @param content - TypeScript migration source to write.
+ */
+const saveMig = (location, content) => __awaiter(void 0, void 0, void 0, function* () {
+    yield fs.promises.mkdir(path.dirname(location), { recursive: true });
+    yield fs.promises.writeFile(location, content);
+    return void 0;
+});
+exports.saveMig = saveMig;
+/**
+ * Builds the generated migration name and location metadata.
+ *
+ * @param name - Optional migration name prefix; defaults to `Mig`.
+ * @returns Timestamped filename, TypeORM migration name, and target file path.
+ */
+const getMetadata = (name) => {
+    const timestamp = Date.now();
+    const migrationName = name !== null && name !== void 0 ? name : `Mig`;
+    const filename = `${migrationName}${timestamp}`;
+    const location = (0, paths_1.getMigrationLocation)(filename);
+    return {
+        location,
+        filename,
+        migrationName,
+        timestamp,
+    };
+};
+exports.getMetadata = getMetadata;
+/**
+ * Generates a migration file from current entity schemas.
+ *
+ * @param params - Generation options including target database, force flag,
+ * migration name prefix, and whether to save the file.
+ * @returns Generation outcome including title and whether changes were found.
+ */
+const generate = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (params = {}) {
+    var _a;
+    let initialized = false;
+    const ds = (0, create_ds_1.createDataSource)(params.db ? { database: params.db } : {});
+    const metadata = getMetadata(params.name);
+    try {
+        yield ds.initialize();
+        initialized = true;
+        const generated = yield genMig(ds, metadata.migrationName, metadata.timestamp);
+        if (!generated.hasChanges && !params.force) {
+            return {
+                generated: false,
+                more: {
+                    reason: 'no-changes',
+                    timestamp: metadata.timestamp,
+                    title: metadata.filename,
+                    saved: false,
+                    location: metadata.location,
+                },
+            };
+        }
+        const dialect = (0, compare_mig_1.getParserDialect)(config_1.cfg.TYPE);
+        const existing = yield (0, migrate_1.getMigrationFiles)();
+        const duplicate = yield (0, compare_mig_1.compareMig)(generated.content, existing, dialect);
+        if (duplicate) {
+            return {
+                generated: false,
+                more: {
+                    location: metadata.location,
+                    reason: 'duplicate-found',
+                    timestamp: metadata.timestamp,
+                    saved: false,
+                    title: metadata.filename,
+                    duplicateOf: duplicate.name,
+                },
+            };
+        }
+        if (params.save) {
+            yield saveMig(metadata.location, generated.formatted);
+        }
+        return {
+            generated: true,
+            more: {
+                location: metadata.location,
+                saved: (_a = params.save) !== null && _a !== void 0 ? _a : false,
+                timestamp: metadata.timestamp,
+                title: metadata.filename,
+                content: generated.formatted,
+            },
+        };
+    }
+    catch (e) {
+        const err = e instanceof Error ? e.message : JSON.stringify(e);
+        throw new Error(err);
+    }
+    finally {
+        if (initialized) {
+            yield ds.destroy();
+        }
+    }
+});
+exports.generate = generate;
+/**
+ * CLI handler for the `gen` command.
+ *
+ * @param args - CLI options for migration name and force flag.
+ */
+const gen = (args) => __awaiter(void 0, void 0, void 0, function* () {
+    const database = (0, sanitize_1.sanitize)(config_1.cfg.DATABASE_NAME);
+    const name = args.name ? (0, sanitize_1.sanitize)(args.name) : undefined;
+    try {
+        (0, print_1.print)(`Generating migration for ${database}...`);
+        const response = yield generate({
+            force: args.force,
+            db: database,
+            name: name,
+            save: true,
+        });
+        if (!response.generated) {
+            if (response.more.reason === 'no-changes') {
+                (0, print_1.print)('No schema changes detected — skipping migration generation');
+            }
+            else if (response.more.reason === 'duplicate-found') {
+                (0, print_1.printf)(`Duplicate migration found: ${response.more.duplicateOf}`);
+            }
+            else
+                throw new Error('Unknown generated response');
+        }
+        else {
+            (0, print_1.print)(`Migration for ${database} created successfully: ${response.more.title}`);
+        }
+        process.exit(0);
+    }
+    catch (e) {
+        const err = e instanceof Error ? e.message : JSON.stringify(e);
+        (0, print_1.printf)(`Migration generation failed: ${err}`);
+        process.exit(1);
+    }
+});
+exports.gen = gen;
+//# sourceMappingURL=gen.js.map

package/build/src/features/gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen.js","sourceRoot":"","sources":["../../../src/features/gen.ts"],"names":[],"mappings":"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"}

package/build/src/features/index.d.ts

@@ -0,0 +1,9 @@
+export { gen } from './gen';
+export { init } from './init';
+export { migrate } from './migrate';
+export { migration } from './migration';
+export { seed } from './seed';
+export { status } from './status';
+export { createdb } from './createdb';
+export { dropdb } from './dropdb';
+//# sourceMappingURL=index.d.ts.map

package/build/src/features/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAC5B,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

package/build/src/features/index.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dropdb = exports.createdb = exports.status = exports.seed = exports.migration = exports.migrate = exports.init = exports.gen = void 0;
+var gen_1 = require("./gen");
+Object.defineProperty(exports, "gen", { enumerable: true, get: function () { return gen_1.gen; } });
+var init_1 = require("./init");
+Object.defineProperty(exports, "init", { enumerable: true, get: function () { return init_1.init; } });
+var migrate_1 = require("./migrate");
+Object.defineProperty(exports, "migrate", { enumerable: true, get: function () { return migrate_1.migrate; } });
+var migration_1 = require("./migration");
+Object.defineProperty(exports, "migration", { enumerable: true, get: function () { return migration_1.migration; } });
+var seed_1 = require("./seed");
+Object.defineProperty(exports, "seed", { enumerable: true, get: function () { return seed_1.seed; } });
+var status_1 = require("./status");
+Object.defineProperty(exports, "status", { enumerable: true, get: function () { return status_1.status; } });
+var createdb_1 = require("./createdb");
+Object.defineProperty(exports, "createdb", { enumerable: true, get: function () { return createdb_1.createdb; } });
+var dropdb_1 = require("./dropdb");
+Object.defineProperty(exports, "dropdb", { enumerable: true, get: function () { return dropdb_1.dropdb; } });
+//# sourceMappingURL=index.js.map

package/build/src/features/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/index.ts"],"names":[],"mappings":";;;AAAA,6BAA4B;AAAnB,0FAAA,GAAG,OAAA;AACZ,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,qCAAoC;AAA3B,kGAAA,OAAO,OAAA;AAChB,yCAAwC;AAA/B,sGAAA,SAAS,OAAA;AAClB,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AACb,mCAAkC;AAAzB,gGAAA,MAAM,OAAA;AACf,uCAAsC;AAA7B,oGAAA,QAAQ,OAAA;AACjB,mCAAkC;AAAzB,gGAAA,MAAM,OAAA"}

package/build/src/features/init.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Creates Dataforge's opinionated project structure and starter config.
+ * Existing files are preserved so the command can be rerun safely.
+ */
+declare function init(): Promise<void>;
+export { init };
+//# sourceMappingURL=init.d.ts.map

package/build/src/features/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/features/init.ts"],"names":[],"mappings":"AAqDA;;;GAGG;AACH,iBAAe,IAAI,kBAYlB;AAED,OAAO,EAAE,IAAI,EAAE,CAAC"}

package/build/src/features/init.js

@@ -0,0 +1,118 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.init = init;
+const config_1 = require("../config");
+const constants_1 = require("../config/constants");
+const print_1 = require("../libs/print");
+const fs = __importStar(require("fs/promises"));
+const template = `import type { DATAFORGE_CONFIGURATIONS } from 'dataforge';
+
+const config: DATAFORGE_CONFIGURATIONS = {
+  ENTITIES: ['src/**/*.schema.ts'],
+  SEEDS: [],
+
+  TYPE: 'postgres',
+  SSL_MODE: false,
+  SSL_TYPE: 'light',
+  DATABASE_CA_CERT: './',
+  DATABASE_HOST: 'localhost',
+  DATABASE_PORT: 5432,
+  DATABASE_USERNAME: 'postgres',
+  DATABASE_PASSWORD: '',
+  DATABASE_NAME: 'app',
+  SYNCHRONIZE: false,
+  LOGGING: false,
+  INITIAL_DATABASE: 'postgres',
+};
+
+export default config;
+`;
+/**
+ * Ensures a directory exists without failing when it is already present.
+ *
+ * @param path - Directory path to create.
+ */
+function ensureDir(path) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield fs.mkdir(path, { recursive: true });
+    });
+}
+/**
+ * Writes a file only when it does not already exist.
+ *
+ * @param path - File path to create.
+ * @param content - Initial file content.
+ */
+function ensureFile(path_1) {
+    return __awaiter(this, arguments, void 0, function* (path, content = '') {
+        try {
+            yield fs.writeFile(path, content, { flag: 'wx' });
+        }
+        catch (e) {
+            const err = e;
+            if (err.code === 'EEXIST')
+                return;
+            throw e;
+        }
+    });
+}
+/**
+ * Creates Dataforge's opinionated project structure and starter config.
+ * Existing files are preserved so the command can be rerun safely.
+ */
+function init() {
+    return __awaiter(this, void 0, void 0, function* () {
+        (0, print_1.print)('initializing app');
+        yield ensureDir(config_1.cfg.ROOT);
+        yield ensureDir(config_1.cfg.MIGRATIONS_DIR);
+        yield ensureDir(config_1.cfg.SEEDS_DIR);
+        yield ensureFile(`${config_1.cfg.ROOT}/.gitkeep`);
+        yield ensureFile(`${config_1.cfg.MIGRATIONS_DIR}/.gitkeep`);
+        yield ensureFile(`${config_1.cfg.SEEDS_DIR}/.gitkeep`);
+        yield ensureFile(constants_1.DATAFORGE_CONFIG_TS, template);
+        (0, print_1.print)('initialized');
+    });
+}
+//# sourceMappingURL=init.js.map

package/build/src/features/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/features/init.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuES,oBAAI;AAvEb,qCAA+B;AAC/B,kDAAyD;AACzD,wCAAqC;AACrC,gDAAkC;AAElC,MAAM,QAAQ,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBhB,CAAC;AAEF;;;;GAIG;AACH,SAAe,SAAS,CAAC,IAAY;;QACnC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,CAAC;CAAA;AAED;;;;;GAKG;AACH,SAAe,UAAU;yDAAC,IAAY,EAAE,UAAkB,EAAE;QAC1D,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAA0B,CAAC;YACvC,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO;YAClC,MAAM,CAAC,CAAC;QACV,CAAC;IACH,CAAC;CAAA;AAED;;;GAGG;AACH,SAAe,IAAI;;QACjB,IAAA,aAAK,EAAC,kBAAkB,CAAC,CAAC;QAC1B,MAAM,SAAS,CAAC,YAAG,CAAC,IAAI,CAAC,CAAC;QAC1B,MAAM,SAAS,CAAC,YAAG,CAAC,cAAc,CAAC,CAAC;QACpC,MAAM,SAAS,CAAC,YAAG,CAAC,SAAS,CAAC,CAAC;QAE/B,MAAM,UAAU,CAAC,GAAG,YAAG,CAAC,IAAI,WAAW,CAAC,CAAC;QACzC,MAAM,UAAU,CAAC,GAAG,YAAG,CAAC,cAAc,WAAW,CAAC,CAAC;QACnD,MAAM,UAAU,CAAC,GAAG,YAAG,CAAC,SAAS,WAAW,CAAC,CAAC;QAE9C,MAAM,UAAU,CAAC,+BAAmB,EAAE,QAAQ,CAAC,CAAC;QAChD,IAAA,aAAK,EAAC,aAAa,CAAC,CAAC;IACvB,CAAC;CAAA"}

package/build/src/features/migrate.d.ts

@@ -0,0 +1,83 @@
+import { MIGRATE } from '../types';
+import { DataSource } from 'typeorm';
+type MigrationResult = {
+    migrated: boolean;
+    status: 'migrated' | 'already-migrated' | 'no-migrations';
+};
+export type MigrationItem = {
+    name: string;
+    parentPath: string;
+    exists: boolean;
+    file: string;
+};
+/**
+ * Lists migration directories under the configured migrations directory and whether each
+ * contains a `migration.ts` file.
+ *
+ * @returns An array of {@link MigrationItem} entries, one per migration folder.
+ */
+declare function getMigrationFiles(): Promise<MigrationItem[]>;
+/**
+ * Checks whether a migration has already been recorded in the database.
+ * Queries the `migrations` table via a dialect-specific command.
+ *
+ * @param ds - Initialized TypeORM data source.
+ * @param name - Migration folder name to look up.
+ * @returns Whether the migration name exists in the migrations table.
+ */
+declare function hasMigration(ds: DataSource, name: string): Promise<boolean>;
+/**
+ * Resolves which local migrations still need to run against the database.
+ * Opens a data source, discovers migration folders (optionally
+ * scoped to `name`), and filters out entries that are missing or already recorded.
+ *
+ * @param name - Optional migration folder name; when omitted, all folders are considered.
+ * @param db - Optional database override for the migration lookup.
+ * @returns Pending {@link MigrationItem} entries; empty when none apply.
+ * @throws When the data source cannot connect or migration lookup fails.
+ */
+declare function getMigrationsToRun(name?: string, db?: string): Promise<MigrationItem[]>;
+/**
+ * Runs pending migrations discovered via {@link getMigrationsToRun}.
+ * When `name` is omitted, runs every unmigrated folder under the configured migrations directory.
+ *
+ * @param name - Optional migration folder name to run a single migration.
+ * @param db - Optional database override for migration discovery and execution.
+ * @returns Outcome with `migrated` flag and status (`migrated` or `no-migrations`).
+ * @throws When migration discovery or execution fails.
+ */
+declare function runMigrationByName(name?: string, db?: string): Promise<MigrationResult>;
+/**
+ * Runs all migrations registered on the configured TypeORM data source.
+ * Initializes the data source, executes pending migrations in a single
+ * transaction, then destroys the connection.
+ *
+ * @param db - Optional database override for the TypeORM data source.
+ * @returns Outcome with `migrated` flag and status (`migrated` or `no-migrations`).
+ * @throws When initialization or migration execution fails.
+ */
+declare function runMigrationByConfig(db?: string): Promise<MigrationResult>;
+/**
+ * Resolves a migration folder name and `migration.ts` path from a CLI path input.
+ * Accepts either a migration directory or a direct path to `migration.ts`.
+ * Validates that the folder name is class-style and ends with a 13-digit timestamp.
+ *
+ * @param input - Migration folder or file path from `--file`.
+ * @returns The migration name and normalized path to `migration.ts`.
+ * @throws When the name is invalid or the migration file does not exist.
+ */
+declare function getMigrationNameFromPath(input: string): {
+    name: string;
+    path: string;
+};
+/**
+ * CLI handler for the `migrate` command.
+ * Runs pending migrations via {@link runMigrationByName}. When `--file` is
+ * provided, resolves the migration name from the path first.
+ * Prints the outcome to stdout and exits with code 0 or 1.
+ *
+ * @param args - CLI options; `--name` scopes to one migration folder, `--file` to a folder or `migration.ts` path.
+ */
+declare function migrate(args: MIGRATE): Promise<void>;
+export { migrate, runMigrationByConfig, runMigrationByName, getMigrationsToRun, hasMigration, getMigrationFiles, getMigrationNameFromPath, };
+//# sourceMappingURL=migrate.d.ts.map

package/build/src/features/migrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.d.ts","sourceRoot":"","sources":["../../../src/features/migrate.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAOrC,KAAK,eAAe,GAAG;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,UAAU,GAAG,kBAAkB,GAAG,eAAe,CAAC;CAC3D,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;GAKG;AACH,iBAAe,iBAAiB,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAgB3D;AAED;;;;;;;GAOG;AACH,iBAAe,YAAY,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,oBAmBvD;AAED;;;;;;;;;GASG;AACH,iBAAe,kBAAkB,CAC/B,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,EAAE,CAAC,CA0C1B;AAED;;;;;;;;GAQG;AACH,iBAAe,kBAAkB,CAC/B,IAAI,CAAC,EAAE,MAAM,EACb,EAAE,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,eAAe,CAAC,CAwC1B;AAED;;;;;;;;GAQG;AACH,iBAAe,oBAAoB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CA6BzE;AAED;;;;;;;;GAQG;AACH,iBAAS,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CA2BA;AAED;;;;;;;GAOG;AACH,iBAAe,OAAO,CAAC,IAAI,EAAE,OAAO,iBAuBnC;AAED,OAAO,EACL,OAAO,EACP,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,wBAAwB,GACzB,CAAC"}