purplekit 1.0.0

package/README.md

@@ -0,0 +1,103 @@
+# Dataforge
+
+TypeORM database tooling with a small, opinionated CLI.
+
+Dataforge gives TypeORM projects a predictable workflow for creating databases,
+generating migrations, applying migrations, checking status, and running seeders.
+It stores project artifacts under `dataforge/` so migration and seed files stay grouped
+away from application code.
+
+## Install
+
+```bash
+npm install dataforge typeorm reflect-metadata
+```
+
+Install the database driver your project needs, for example:
+
+```bash
+npm install pg
+```
+
+## Quick Start
+
+```bash
+npx dataforge init
+```
+
+This creates:
+
+```text
+dataforge/
+  migrations/
+  seeds/
+  dataforge.config.ts
+```
+
+Edit `dataforge/dataforge.config.ts` with your TypeORM connection options, entities, and
+seed classes.
+
+## Commands
+
+```bash
+npx dataforge createdb
+npx dataforge dropdb
+npx dataforge status
+npx dataforge gen --name CreateUsers
+npx dataforge migrate
+npx dataforge migration
+npx dataforge seed
+```
+
+Useful options:
+
+```bash
+npx dataforge createdb --name app_dev
+npx dataforge dropdb --name app_dev
+npx dataforge status --name app_dev
+npx dataforge gen --name CreateUsers --force
+npx dataforge migrate --name CreateUsers1780000000000
+npx dataforge migrate --file dataforge/migrations/CreateUsers1780000000000/migration.ts
+npx dataforge seed --db app_dev
+```
+
+## Config
+
+```ts
+import type { DATAFORGE_CONFIGURATIONS } from 'dataforge';
+
+const config: DATAFORGE_CONFIGURATIONS = {
+  ENTITIES: ['src/**/*.schema.ts'],
+  SEEDS: [],
+
+  TYPE: 'postgres',
+  DATABASE_HOST: 'localhost',
+  DATABASE_PORT: 5432,
+  DATABASE_USERNAME: 'postgres',
+  DATABASE_PASSWORD: '',
+  DATABASE_NAME: 'app',
+  INITIAL_DATABASE: 'postgres',
+
+  SSL_MODE: false,
+  SSL_TYPE: 'light',
+  DATABASE_CA_CERT: './',
+  SYNCHRONIZE: false,
+  LOGGING: false,
+};
+
+export default config;
+```
+
+## Public API
+
+```ts
+import type { DATAFORGE_CONFIGURATIONS } from 'dataforge';
+import { seedEntities } from 'dataforge';
+```
+
+`seedEntities` is provided for building reusable seed classes.
+
+## Documentation
+
+The README is intentionally compact. Full guides, examples, and command details
+belong in the docs web app.

package/bin/dataforge

@@ -0,0 +1,2 @@
+#!/usr/bin/env sh
+node "$(dirname "$0")/../build/src/app.js" "$@"

package/build/src/app.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=app.d.ts.map

package/build/src/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC"}

package/build/src/app.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const commander_1 = require("commander");
+const features_1 = require("./features");
+// initialize the desc and info of the app
+commander_1.program
+    .name('dataforge')
+    .description('typeorm database actions wrapper')
+    .version('1.0.0', '-v, --cli-version', 'Output the dataforge CLI version.');
+// create core parts
+commander_1.program
+    .command('init')
+    .description('Setup required configurations, files and folders')
+    .action(() => (0, features_1.init)());
+// generate a new migration
+commander_1.program
+    .command('gen')
+    .description('Generate a new migrations file')
+    .option('--name <name>', 'Title/Name of the migration')
+    .option('-f, --force', 'Force the migration generation even if no changes exist')
+    .action((args) => (0, features_1.gen)(args));
+// create database
+commander_1.program
+    .command('createdb')
+    .description('Create a new database')
+    .option('--name <name>', 'Database name')
+    .action((args) => (0, features_1.createdb)(args));
+// drop database
+commander_1.program
+    .command('dropdb')
+    .description('Drop an existing database')
+    .option('--name <name>', 'Database name')
+    .action((args) => (0, features_1.dropdb)(args));
+// seed database
+commander_1.program
+    .command('seed')
+    .description('Populate an existing database with seed data')
+    .option('--db <db>', 'The name of the db to be seeded')
+    .action((args) => (0, features_1.seed)(args));
+// get the status of a database
+commander_1.program
+    .command('status')
+    .description('Get the status of an existing database')
+    .option('--name <name>', 'Database name')
+    .action((args) => (0, features_1.status)(args));
+// execute existing migrations
+commander_1.program
+    .command('migrate')
+    .description('Execute already existing migration files')
+    .option('--name <name>', 'Migration basename/class name without .ts')
+    .option('--db <database>', 'Database which migration should be applied to')
+    .option('--file <file>', 'The path to the migration file to be executed eg. dataforge/migrations/Mig1234563534')
+    .action((args) => (0, features_1.migrate)(args));
+// run the whole migration process
+commander_1.program
+    .command('migration')
+    .description('Generate a new migration file and execute it immediately')
+    .option('-a, --all', 'Run all migration files along with the newly generated migration')
+    .action((args) => (0, features_1.migration)(args));
+// start the app
+commander_1.program.parseAsync();
+//# sourceMappingURL=app.js.map

package/build/src/app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../../src/app.ts"],"names":[],"mappings":";;AAAA,4BAA0B;AAU1B,yCAAoC;AACpC,yCASoB;AAEpB,0CAA0C;AAC1C,mBAAO;KACJ,IAAI,CAAC,WAAW,CAAC;KACjB,WAAW,CAAC,kCAAkC,CAAC;KAC/C,OAAO,CAAC,OAAO,EAAE,mBAAmB,EAAE,mCAAmC,CAAC,CAAC;AAE9E,oBAAoB;AACpB,mBAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,kDAAkD,CAAC;KAC/D,MAAM,CAAC,GAAG,EAAE,CAAC,IAAA,eAAI,GAAE,CAAC,CAAC;AAExB,2BAA2B;AAC3B,mBAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,gCAAgC,CAAC;KAC7C,MAAM,CAAC,eAAe,EAAE,6BAA6B,CAAC;KACtD,MAAM,CACL,aAAa,EACb,yDAAyD,CAC1D;KACA,MAAM,CAAC,CAAC,IAAyB,EAAE,EAAE,CAAC,IAAA,cAAG,EAAC,IAAI,CAAC,CAAC,CAAC;AAEpD,kBAAkB;AAClB,mBAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,uBAAuB,CAAC;KACpC,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;KACxC,MAAM,CAAC,CAAC,IAAe,EAAE,EAAE,CAAC,IAAA,mBAAQ,EAAC,IAAI,CAAC,CAAC,CAAC;AAE/C,gBAAgB;AAChB,mBAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,2BAA2B,CAAC;KACxC,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;KACxC,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,iBAAM,EAAC,IAAI,CAAC,CAAC,CAAC;AAE3C,gBAAgB;AAChB,mBAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,8CAA8C,CAAC;KAC3D,MAAM,CAAC,WAAW,EAAE,iCAAiC,CAAC;KACtD,MAAM,CAAC,CAAC,IAAU,EAAE,EAAE,CAAC,IAAA,eAAI,EAAC,IAAI,CAAC,CAAC,CAAC;AAEtC,+BAA+B;AAC/B,mBAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,wCAAwC,CAAC;KACrD,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC;KACxC,MAAM,CAAC,CAAC,IAAe,EAAE,EAAE,CAAC,IAAA,iBAAM,EAAC,IAAI,CAAC,CAAC,CAAC;AAE7C,8BAA8B;AAC9B,mBAAO;KACJ,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,0CAA0C,CAAC;KACvD,MAAM,CAAC,eAAe,EAAE,2CAA2C,CAAC;KACpE,MAAM,CAAC,iBAAiB,EAAE,+CAA+C,CAAC;KAC1E,MAAM,CACL,eAAe,EACf,sFAAsF,CACvF;KACA,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE,CAAC,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC,CAAC;AAE5C,kCAAkC;AAClC,mBAAO;KACJ,OAAO,CAAC,WAAW,CAAC;KACpB,WAAW,CAAC,0DAA0D,CAAC;KACvE,MAAM,CACL,WAAW,EACX,kEAAkE,CACnE;KACA,MAAM,CAAC,CAAC,IAAe,EAAE,EAAE,CAAC,IAAA,oBAAS,EAAC,IAAI,CAAC,CAAC,CAAC;AAEhD,gBAAgB;AAChB,mBAAO,CAAC,UAAU,EAAE,CAAC"}

package/build/src/config/constants.d.ts

@@ -0,0 +1,8 @@
+declare const DATAFORGE_ROOT = "dataforge";
+declare const DATAFORGE_CONFIG_TS = "dataforge/dataforge.config.ts";
+declare const DATAFORGE_CONFIG_JS = "dataforge/dataforge.config.js";
+declare const DATAFORGE_MIGRATIONS_DIR = "dataforge/migrations";
+declare const DATAFORGE_SEEDS_DIR = "dataforge/seeds";
+declare const DATAFORGE_MIGRATIONS_GLOB = "dataforge/migrations/**/*.{ts,js}";
+export { DATAFORGE_CONFIG_JS, DATAFORGE_CONFIG_TS, DATAFORGE_MIGRATIONS_DIR, DATAFORGE_MIGRATIONS_GLOB, DATAFORGE_ROOT, DATAFORGE_SEEDS_DIR, };
+//# sourceMappingURL=constants.d.ts.map

package/build/src/config/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,cAAc,cAAc,CAAC;AACnC,QAAA,MAAM,mBAAmB,kCAAkC,CAAC;AAC5D,QAAA,MAAM,mBAAmB,kCAAkC,CAAC;AAC5D,QAAA,MAAM,wBAAwB,yBAAyB,CAAC;AACxD,QAAA,MAAM,mBAAmB,oBAAoB,CAAC;AAC9C,QAAA,MAAM,yBAAyB,sCAAsC,CAAC;AAEtE,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,mBAAmB,GACpB,CAAC"}

package/build/src/config/constants.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATAFORGE_SEEDS_DIR = exports.DATAFORGE_ROOT = exports.DATAFORGE_MIGRATIONS_GLOB = exports.DATAFORGE_MIGRATIONS_DIR = exports.DATAFORGE_CONFIG_TS = exports.DATAFORGE_CONFIG_JS = void 0;
+const DATAFORGE_ROOT = 'dataforge';
+exports.DATAFORGE_ROOT = DATAFORGE_ROOT;
+const DATAFORGE_CONFIG_TS = 'dataforge/dataforge.config.ts';
+exports.DATAFORGE_CONFIG_TS = DATAFORGE_CONFIG_TS;
+const DATAFORGE_CONFIG_JS = 'dataforge/dataforge.config.js';
+exports.DATAFORGE_CONFIG_JS = DATAFORGE_CONFIG_JS;
+const DATAFORGE_MIGRATIONS_DIR = 'dataforge/migrations';
+exports.DATAFORGE_MIGRATIONS_DIR = DATAFORGE_MIGRATIONS_DIR;
+const DATAFORGE_SEEDS_DIR = 'dataforge/seeds';
+exports.DATAFORGE_SEEDS_DIR = DATAFORGE_SEEDS_DIR;
+const DATAFORGE_MIGRATIONS_GLOB = 'dataforge/migrations/**/*.{ts,js}';
+exports.DATAFORGE_MIGRATIONS_GLOB = DATAFORGE_MIGRATIONS_GLOB;
+//# sourceMappingURL=constants.js.map

package/build/src/config/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":";;;AAAA,MAAM,cAAc,GAAG,WAAW,CAAC;AAYjC,wCAAc;AAXhB,MAAM,mBAAmB,GAAG,+BAA+B,CAAC;AAQ1D,kDAAmB;AAPrB,MAAM,mBAAmB,GAAG,+BAA+B,CAAC;AAM1D,kDAAmB;AALrB,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAOtD,4DAAwB;AAN1B,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAS5C,kDAAmB;AARrB,MAAM,yBAAyB,GAAG,mCAAmC,CAAC;AAMpE,8DAAyB"}

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

@@ -0,0 +1,4 @@
+import { DATAFORGE_INTERNAL_CONFIGURATIONS } from '../types';
+declare const cfg: DATAFORGE_INTERNAL_CONFIGURATIONS;
+export { cfg };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,iCAAiC,EAAE,MAAM,SAAS,CAAC;AAyDtF,QAAA,MAAM,GAAG,EAAE,iCAOV,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,CAAC"}

package/build/src/config/index.js

@@ -0,0 +1,79 @@
+"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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cfg = void 0;
+const constants_1 = require("./constants");
+const node_module_1 = require("node:module");
+const node_fs_1 = require("node:fs");
+const path = __importStar(require("node:path"));
+const requireConfig = (0, node_module_1.createRequire)(path.join(process.cwd(), 'dataforge.config.cjs'));
+const defaults = {
+    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',
+};
+/**
+ * Loads the user-authored Dataforge config from the opinionated project config path.
+ * Supports TypeScript and JavaScript config files and returns an empty object
+ * when no config file has been initialized yet.
+ *
+ * @returns Partial user config to merge over defaults.
+ */
+function loadUserConfig() {
+    var _a;
+    for (const file of [constants_1.DATAFORGE_CONFIG_TS, constants_1.DATAFORGE_CONFIG_JS]) {
+        const location = path.resolve(process.cwd(), file);
+        if (!(0, node_fs_1.existsSync)(location))
+            continue;
+        const mod = requireConfig(location);
+        return (_a = mod.default) !== null && _a !== void 0 ? _a : mod;
+    }
+    return {};
+}
+const userConfig = loadUserConfig();
+const cfg = Object.assign(Object.assign(Object.assign({}, defaults), userConfig), { ROOT: constants_1.DATAFORGE_ROOT, MIGRATIONS_DIR: constants_1.DATAFORGE_MIGRATIONS_DIR, SEEDS_DIR: constants_1.DATAFORGE_SEEDS_DIR, MIGRATIONS: [constants_1.DATAFORGE_MIGRATIONS_GLOB] });
+exports.cfg = cfg;
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,2CAOqB;AACrB,6CAA4C;AAC5C,qCAAqC;AACrC,gDAAkC;AAElC,MAAM,aAAa,GAAG,IAAA,2BAAa,EAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CAAC,CAAC;AAEtF,MAAM,QAAQ,GAA6B;IACzC,QAAQ,EAAE,CAAC,oBAAoB,CAAC;IAChC,KAAK,EAAE,EAAE;IAET,IAAI,EAAE,UAAU;IAChB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,OAAO;IACjB,gBAAgB,EAAE,IAAI;IACtB,aAAa,EAAE,WAAW;IAC1B,aAAa,EAAE,IAAI;IACnB,iBAAiB,EAAE,UAAU;IAC7B,iBAAiB,EAAE,EAAE;IACrB,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;IAClB,OAAO,EAAE,KAAK;IACd,gBAAgB,EAAE,UAAU;CAC7B,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,cAAc;;IACrB,KAAK,MAAM,IAAI,IAAI,CAAC,+BAAmB,EAAE,+BAAmB,CAAC,EAAE,CAAC;QAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,CAAC;QACnD,IAAI,CAAC,IAAA,oBAAU,EAAC,QAAQ,CAAC;YAAE,SAAS;QAEpC,MAAM,GAAG,GAAG,aAAa,CAAC,QAAQ,CAEG,CAAC;QAEtC,OAAO,MAAA,GAAG,CAAC,OAAO,mCAAI,GAAG,CAAC;IAC5B,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;AAEpC,MAAM,GAAG,iDACJ,QAAQ,GACR,UAAU,KACb,IAAI,EAAE,0BAAc,EACpB,cAAc,EAAE,oCAAwB,EACxC,SAAS,EAAE,+BAAmB,EAC9B,UAAU,EAAE,CAAC,qCAAyB,CAAC,GACxC,CAAC;AAEO,kBAAG"}

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

@@ -0,0 +1,21 @@
+import { CREATE_DB } from '../types';
+/**
+ * Creates a database if it does not already exist.
+ * Idempotent — safe to run multiple times with the same name.
+ *
+ * @param name - Database name to create (expected to be sanitized).
+ * @returns Outcome status and whether the database was created.
+ */
+declare function create(name: string): Promise<{
+    status: 'created' | 'already-exists';
+    created: boolean;
+    error?: string;
+}>;
+/**
+ * CLI handler for the `createdb` command.
+ *
+ * @param args - CLI options; `name` defaults to `cfg.DATABASE_NAME`.
+ */
+declare function createdb(args: CREATE_DB): Promise<void>;
+export { createdb, create };
+//# sourceMappingURL=createdb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createdb.d.ts","sourceRoot":"","sources":["../../../src/features/createdb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAMpC;;;;;;GAMG;AACH,iBAAe,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3C,MAAM,EAAE,SAAS,GAAG,gBAAgB,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA2BD;AAED;;;;GAIG;AACH,iBAAe,QAAQ,CAAC,IAAI,EAAE,SAAS,iBAatC;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC"}

package/build/src/features/createdb.js

@@ -0,0 +1,80 @@
+"use strict";
+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.createdb = createdb;
+exports.create = create;
+const get_commands_1 = require("../libs/get-commands");
+const config_1 = require("../config");
+const print_1 = require("../libs/print");
+const sanitize_1 = require("../libs/sanitize");
+const create_ds_1 = require("../libs/create-ds");
+/**
+ * Creates a database if it does not already exist.
+ * Idempotent — safe to run multiple times with the same name.
+ *
+ * @param name - Database name to create (expected to be sanitized).
+ * @returns Outcome status and whether the database was created.
+ */
+function create(name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const ds = (0, create_ds_1.createDataSource)();
+        let initialized = false;
+        try {
+            const createCommand = (0, get_commands_1.getCreateDbCommand)(name);
+            const checksCommand = (0, get_commands_1.getDbCheckCommand)();
+            yield ds.initialize();
+            initialized = true;
+            const rs = yield ds.query(checksCommand, [name]);
+            const exists = rs.length > 0;
+            if (!exists) {
+                yield ds.query(createCommand);
+                return { status: 'created', created: true };
+            }
+            else {
+                return { status: 'already-exists', created: false };
+            }
+        }
+        catch (e) {
+            const err = e instanceof Error ? e.message : 'Unable to serialize error';
+            throw new Error(err);
+        }
+        finally {
+            if (initialized) {
+                yield ds.destroy();
+            }
+        }
+    });
+}
+/**
+ * CLI handler for the `createdb` command.
+ *
+ * @param args - CLI options; `name` defaults to `cfg.DATABASE_NAME`.
+ */
+function createdb(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const name = (0, sanitize_1.sanitize)((_a = args.name) !== null && _a !== void 0 ? _a : config_1.cfg.DATABASE_NAME);
+        try {
+            const response = yield create(name);
+            if (response.status === 'created') {
+                (0, print_1.print)(`Database '${name}' created successfully`);
+            }
+            else
+                (0, print_1.print)(`Database '${name}' already exists`);
+        }
+        catch (e) {
+            const err = e instanceof Error ? e.message : 'Unable to serialize error';
+            (0, print_1.printf)(`Error creating database '${name}': ${err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=createdb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"createdb.js","sourceRoot":"","sources":["../../../src/features/createdb.ts"],"names":[],"mappings":";;;;;;;;;;;AAmES,4BAAQ;AAAE,wBAAM;AAnEzB,sDAA4E;AAE5E,qCAA+B;AAC/B,wCAA6C;AAC7C,8CAA2C;AAC3C,gDAAoD;AAEpD;;;;;;GAMG;AACH,SAAe,MAAM,CAAC,IAAY;;QAKhC,MAAM,EAAE,GAAG,IAAA,4BAAgB,GAAE,CAAC;QAC9B,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,aAAa,GAAG,IAAA,iCAAkB,EAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,aAAa,GAAG,IAAA,gCAAiB,GAAE,CAAC;YAE1C,MAAM,EAAE,CAAC,UAAU,EAAE,CAAC;YACtB,WAAW,GAAG,IAAI,CAAC;YAEnB,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;YAEjD,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAC9B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACN,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACtD,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACzE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;CAAA;AAED;;;;GAIG;AACH,SAAe,QAAQ,CAAC,IAAe;;;QACrC,MAAM,IAAI,GAAG,IAAA,mBAAQ,EAAC,MAAA,IAAI,CAAC,IAAI,mCAAI,YAAG,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAEpC,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAA,aAAK,EAAC,aAAa,IAAI,wBAAwB,CAAC,CAAC;YACnD,CAAC;;gBAAM,IAAA,aAAK,EAAC,aAAa,IAAI,kBAAkB,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,2BAA2B,CAAC;YACzE,IAAA,cAAM,EAAC,4BAA4B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CAAA"}

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

@@ -0,0 +1,18 @@
+import { DROP_DB } from '../types';
+/**
+ * Drops a database if it exists.
+ *
+ * @param name - Database name to drop (expected to be sanitized).
+ * @returns Whether the drop succeeded; includes `error` on failure.
+ */
+declare function drop(name: string): Promise<{
+    dropped: boolean;
+}>;
+/**
+ * CLI handler for the `dropdb` command.
+ *
+ * @param args - CLI options; `name` defaults to `cfg.DATABASE_NAME`.
+ */
+declare function dropdb(args: DROP_DB): Promise<void>;
+export { dropdb, drop };
+//# sourceMappingURL=dropdb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dropdb.d.ts","sourceRoot":"","sources":["../../../src/features/dropdb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAMlC;;;;;GAKG;AACH,iBAAe,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAkB/D;AAED;;;;GAIG;AACH,iBAAe,MAAM,CAAC,IAAI,EAAE,OAAO,iBAalC;AAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC"}

package/build/src/features/dropdb.js

@@ -0,0 +1,70 @@
+"use strict";
+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.dropdb = dropdb;
+exports.drop = drop;
+const print_1 = require("../libs/print");
+const config_1 = require("../config");
+const sanitize_1 = require("../libs/sanitize");
+const get_commands_1 = require("../libs/get-commands");
+const create_ds_1 = require("../libs/create-ds");
+/**
+ * Drops a database if it exists.
+ *
+ * @param name - Database name to drop (expected to be sanitized).
+ * @returns Whether the drop succeeded; includes `error` on failure.
+ */
+function drop(name) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const ds = (0, create_ds_1.createDataSource)();
+        let initialized = false;
+        try {
+            const command = (0, get_commands_1.getDropDbCommand)(name);
+            yield ds.initialize();
+            initialized = true;
+            yield ds.query(command);
+            return { dropped: true };
+        }
+        catch (e) {
+            const err = e instanceof Error ? e.message : 'Unable to serialize err';
+            throw new Error(err);
+        }
+        finally {
+            if (initialized) {
+                yield ds.destroy();
+            }
+        }
+    });
+}
+/**
+ * CLI handler for the `dropdb` command.
+ *
+ * @param args - CLI options; `name` defaults to `cfg.DATABASE_NAME`.
+ */
+function dropdb(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const name = (0, sanitize_1.sanitize)((_a = args.name) !== null && _a !== void 0 ? _a : config_1.cfg.DATABASE_NAME);
+        try {
+            const response = yield drop(name);
+            const msg = response.dropped
+                ? `Database '${name}' dropped successfully`
+                : `Couldn't drop Database '${name}'`;
+            (0, print_1.print)(msg);
+        }
+        catch (e) {
+            const err = e instanceof Error ? e.message : 'Unable to serialize err';
+            (0, print_1.printf)(`Error dropping '${name}': ${err}`);
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=dropdb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dropdb.js","sourceRoot":"","sources":["../../../src/features/dropdb.ts"],"names":[],"mappings":";;;;;;;;;;;AAqDS,wBAAM;AAAE,oBAAI;AArDrB,wCAA6C;AAE7C,qCAA+B;AAC/B,8CAA2C;AAC3C,sDAAuD;AACvD,gDAAoD;AAEpD;;;;;GAKG;AACH,SAAe,IAAI,CAAC,IAAY;;QAC9B,MAAM,EAAE,GAAG,IAAA,4BAAgB,GAAE,CAAC;QAC9B,IAAI,WAAW,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,IAAA,+BAAgB,EAAC,IAAI,CAAC,CAAC;YACvC,MAAM,EAAE,CAAC,UAAU,EAAE,CAAC;YACtB,WAAW,GAAG,IAAI,CAAC;YAEnB,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YACxB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC;YACvE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;gBAAS,CAAC;YACT,IAAI,WAAW,EAAE,CAAC;gBAChB,MAAM,EAAE,CAAC,OAAO,EAAE,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;CAAA;AAED;;;;GAIG;AACH,SAAe,MAAM,CAAC,IAAa;;;QACjC,MAAM,IAAI,GAAG,IAAA,mBAAQ,EAAC,MAAA,IAAI,CAAC,IAAI,mCAAI,YAAG,CAAC,aAAa,CAAC,CAAC;QACtD,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO;gBAC1B,CAAC,CAAC,aAAa,IAAI,wBAAwB;gBAC3C,CAAC,CAAC,2BAA2B,IAAI,GAAG,CAAC;YACvC,IAAA,aAAK,EAAC,GAAG,CAAC,CAAC;QACb,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,yBAAyB,CAAC;YACvE,IAAA,cAAM,EAAC,mBAAmB,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CAAA"}

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

@@ -0,0 +1,84 @@
+import { GENERATE_MIGRATIONS } from '../types';
+import { DataSource } from 'typeorm';
+import { compareMig } from '../libs/compare-mig';
+type MoreInfo = {
+    title: string;
+    saved: boolean;
+    timestamp: number;
+    location: string;
+};
+type Success = {
+    generated: true;
+    more: MoreInfo & {
+        content: string;
+    };
+};
+type Failure = {
+    generated: false;
+    more: {
+        reason: 'duplicate-found' | 'no-changes';
+        duplicateOf?: string;
+    } & MoreInfo;
+};
+type GeneratReturn = Success | Failure;
+/**
+ * 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.
+ */
+declare const hasSchemaChanges: (ds: DataSource) => Promise<boolean>;
+/**
+ * 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.
+ */
+declare const genMig: (ds: DataSource, name: string, timestamp: number) => Promise<{
+    content: string;
+    formatted: string;
+    hasChanges: boolean;
+}>;
+/**
+ * Persists a generated migration file, creating its parent folder first.
+ *
+ * @param location - Destination `migration.ts` path.
+ * @param content - TypeScript migration source to write.
+ */
+declare const saveMig: (location: string, content: string) => Promise<undefined>;
+/**
+ * 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.
+ */
+declare const getMetadata: (name?: string) => {
+    location: string;
+    filename: string;
+    migrationName: string;
+    timestamp: number;
+};
+type GenerateParams = {
+    db: string;
+    force: boolean | undefined;
+    name: string | undefined;
+    save: boolean | undefined;
+};
+/**
+ * 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.
+ */
+declare const generate: (params?: Partial<GenerateParams>) => Promise<GeneratReturn>;
+/**
+ * CLI handler for the `gen` command.
+ *
+ * @param args - CLI options for migration name and force flag.
+ */
+declare const gen: (args: GENERATE_MIGRATIONS) => Promise<never>;
+export { gen, generate, genMig, compareMig, getMetadata, saveMig, hasSchemaChanges, };
+//# sourceMappingURL=gen.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gen.d.ts","sourceRoot":"","sources":["../../../src/features/gen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAE9C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAGrC,OAAO,EAAE,UAAU,EAAoB,MAAM,oBAAoB,CAAC;AAOlE,KAAK,QAAQ,GAAG;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,KAAK,OAAO,GAAG;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,QAAQ,GAAG;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC,CAAC;AAEF,KAAK,OAAO,GAAG;IACb,SAAS,EAAE,KAAK,CAAC;IACjB,IAAI,EAAE;QACJ,MAAM,EAAE,iBAAiB,GAAG,YAAY,CAAC;QACzC,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,GAAG,QAAQ,CAAC;CACd,CAAC;AACF,KAAK,aAAa,GAAG,OAAO,GAAG,OAAO,CAAC;AAEvC;;;;;GAKG;AACH,QAAA,MAAM,gBAAgB,GAAU,IAAI,UAAU,qBAM7C,CAAC;AAEF;;;;;;;GAOG;AACH,QAAA,MAAM,MAAM,GAAU,IAAI,UAAU,EAAE,MAAM,MAAM,EAAE,WAAW,MAAM;;;;EAsBpE,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,OAAO,GAAU,UAAU,MAAM,EAAE,SAAS,MAAM,uBAIvD,CAAC;AAEF;;;;;GAKG;AACH,QAAA,MAAM,WAAW,GAAI,OAAO,MAAM;;;;;CAYjC,CAAC;AAEF,KAAK,cAAc,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAC3B,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,IAAI,EAAE,OAAO,GAAG,SAAS,CAAC;CAC3B,CAAC;AACF;;;;;;GAMG;AACH,QAAA,MAAM,QAAQ,GACZ,SAAQ,OAAO,CAAC,cAAc,CAAM,KACnC,OAAO,CAAC,aAAa,CAkEvB,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,GAAG,GAAU,MAAM,mBAAmB,mBA6B3C,CAAC;AAEF,OAAO,EACL,GAAG,EACH,QAAQ,EACR,MAAM,EACN,UAAU,EACV,WAAW,EACX,OAAO,EACP,gBAAgB,GACjB,CAAC"}