purplekit 1.0.4 → 1.0.6

package/README.md

@@ -13,12 +13,17 @@ away from application code.
 npm install purplekit typeorm reflect-metadata
 ```
 
-Install the database driver your project needs, for example:
+Purplekit supports **PostgreSQL**, **MySQL** and **MariaDB**, and requires
+Node.js 22.13 or newer.
+
+For PostgreSQL, install the driver:
 
 ```bash
 npm install pg
 ```
 
+The MySQL/MariaDB driver (`mysql2`) ships with Purplekit.
+
 ## Quick Start
 
 ```bash
@@ -35,7 +40,7 @@ purplekit/
 ```
 
 Edit `purplekit/purplekit.config.ts` with your TypeORM connection options, entities, and
-seed classes.
+seed classes. A `purplekit/purplekit.config.js` file works too.
 
 ## Commands
 
@@ -55,12 +60,21 @@ Useful options:
 npx purplekit createdb --name app_dev
 npx purplekit dropdb --name app_dev
 npx purplekit status --name app_dev
-npx purplekit gen --name CreateUsers --force
+npx purplekit migrate --db app_dev
 npx purplekit migrate --name CreateUsers1780000000000
 npx purplekit migrate --file purplekit/migrations/CreateUsers1780000000000/migration.ts
+npx purplekit migration --all
 npx purplekit seed --db app_dev
 ```
 
+- `gen` skips when there are no schema changes, and refuses to save a migration
+  that duplicates an existing one.
+- `migration` generates a migration and applies it right away; `--all` also runs
+  every other pending migration.
+- Database and migration names must start with a letter and contain only letters,
+  numbers and underscores.
+- Errors are printed to stderr and exit with code `1`.
+
 ## Config
 
 ```ts
@@ -79,7 +93,8 @@ const config: PURPLEKIT_CONFIGURATIONS = {
   INITIAL_DATABASE: 'postgres',
 
   SSL_MODE: false,
-  SSL_TYPE: 'light',
+  SSL_TYPE: 'light', // 'heavy' also supplies DATABASE_CA_CERT as the trusted CA
+  SSL_REJECT_UNAUTHORIZED: false, // true rejects servers whose certificate does not verify
   DATABASE_CA_CERT: './',
   SYNCHRONIZE: false,
   LOGGING: false,
@@ -88,14 +103,39 @@ const config: PURPLEKIT_CONFIGURATIONS = {
 export default config;
 ```
 
+`INITIAL_DATABASE` is the database Purplekit connects to for `createdb`, `dropdb`
+and `status`, so it must already exist. For MySQL or MariaDB, use:
+
+```ts
+  TYPE: 'mysql', // or 'mariadb'
+  DATABASE_PORT: 3306,
+  INITIAL_DATABASE: 'mysql',
+```
+
+With `SSL_MODE: true`, `SSL_TYPE: 'heavy'` passes `DATABASE_CA_CERT` to the driver.
+Certificates are only enforced when `SSL_REJECT_UNAUTHORIZED` is `true` (default
+`false`).
+
 ## Public API
 
 ```ts
 import type { PURPLEKIT_CONFIGURATIONS } from 'purplekit';
-import { seedEntities } from 'purplekit';
+import {
+  seedEntities,
+  createdb,
+  dropdb,
+  gen,
+  init,
+  migrate,
+  migration,
+  seed,
+  status,
+} from 'purplekit';
 ```
 
-`seedEntities` is provided for building reusable seed classes.
+`seedEntities` is provided for building reusable seed classes. The command
+handlers print their output and resolve to an exit code (`0` or `1`); they never
+exit your process.
 
 ## Documentation
 

package/build/src/app.js

@@ -1,64 +1,100 @@
 #!/usr/bin/env node
 "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 });
 require("reflect-metadata");
 const commander_1 = require("commander");
 const features_1 = require("./features");
+const config_1 = require("./config");
+const format_error_1 = require("./libs/format-error");
+const print_1 = require("./libs/print");
+const version_1 = require("./libs/version");
+/** Prints any error as a readable message and exits with code 1. */
+const fail = (e) => {
+    (0, print_1.printf)(`Error: ${(0, format_error_1.formatError)(e)}`);
+    process.exit(1);
+};
+// last-resort net so nothing ever surfaces as a raw stack trace
+process.on('unhandledRejection', fail);
+process.on('uncaughtException', fail);
+/**
+ * Wraps a command action so config problems and anything thrown outside a
+ * handler's own try/catch still reach the user as a message. Handlers return
+ * an exit code instead of exiting, so they stay safe to call as a library;
+ * only the CLI exits the process.
+ */
+const run = (action) => (args) => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        (0, config_1.assertConfigLoaded)();
+        const code = yield action(args);
+        process.exit(typeof code === 'number' ? code : 0);
+    }
+    catch (e) {
+        fail(e);
+    }
+});
 // initialize the desc and info of the app
 commander_1.program
     .name('purplekit')
     .description('typeorm database actions wrapper')
-    .version('1.0.0', '-v, --cli-version', 'Output the purplekit CLI version.');
+    .version((0, version_1.getVersion)(), '-v, --cli-version', 'Output the purplekit CLI version.');
 // create core parts
 commander_1.program
     .command('init')
     .description('Setup required configurations, files and folders')
-    .action(() => (0, features_1.init)());
+    .action(run(() => (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));
+    .action(run((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));
+    .action(run((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));
+    .action(run((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));
+    .action(run((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));
+    .action(run((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. purplekit/migrations/Mig1234563534')
-    .action((args) => (0, features_1.migrate)(args));
+    .option('--file <file>', 'Path to a migration folder or migration.ts, e.g. purplekit/migrations/CreateUsers1780000000000')
+    .action(run((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));
+    .action(run((args) => (0, features_1.migration)(args)));
 // start the app
-commander_1.program.parseAsync();
+commander_1.program.parseAsync().catch(fail);
 //# sourceMappingURL=app.js.map

package/build/src/app.js.map

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

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

@@ -4,5 +4,6 @@ declare const PURPLEKIT_CONFIG_JS = "purplekit/purplekit.config.js";
 declare const PURPLEKIT_MIGRATIONS_DIR = "purplekit/migrations";
 declare const PURPLEKIT_SEEDS_DIR = "purplekit/seeds";
 declare const PURPLEKIT_MIGRATIONS_GLOB = "purplekit/migrations/**/*.{ts,js}";
-export { PURPLEKIT_CONFIG_JS, PURPLEKIT_CONFIG_TS, PURPLEKIT_MIGRATIONS_DIR, PURPLEKIT_MIGRATIONS_GLOB, PURPLEKIT_ROOT, PURPLEKIT_SEEDS_DIR, };
+declare const SUPPORTED_TYPES: readonly ["postgres", "mysql", "mariadb"];
+export { SUPPORTED_TYPES, PURPLEKIT_CONFIG_JS, PURPLEKIT_CONFIG_TS, PURPLEKIT_MIGRATIONS_DIR, PURPLEKIT_MIGRATIONS_GLOB, PURPLEKIT_ROOT, PURPLEKIT_SEEDS_DIR, };
 //# sourceMappingURL=constants.d.ts.map

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

@@ -1 +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"}
+{"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,QAAA,MAAM,eAAe,2CAA4C,CAAC;AAElE,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,cAAc,EACd,mBAAmB,GACpB,CAAC"}

package/build/src/config/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PURPLEKIT_SEEDS_DIR = exports.PURPLEKIT_ROOT = exports.PURPLEKIT_MIGRATIONS_GLOB = exports.PURPLEKIT_MIGRATIONS_DIR = exports.PURPLEKIT_CONFIG_TS = exports.PURPLEKIT_CONFIG_JS = void 0;
+exports.PURPLEKIT_SEEDS_DIR = exports.PURPLEKIT_ROOT = exports.PURPLEKIT_MIGRATIONS_GLOB = exports.PURPLEKIT_MIGRATIONS_DIR = exports.PURPLEKIT_CONFIG_TS = exports.PURPLEKIT_CONFIG_JS = exports.SUPPORTED_TYPES = void 0;
 const PURPLEKIT_ROOT = 'purplekit';
 exports.PURPLEKIT_ROOT = PURPLEKIT_ROOT;
 const PURPLEKIT_CONFIG_TS = 'purplekit/purplekit.config.ts';
@@ -13,4 +13,6 @@ const PURPLEKIT_SEEDS_DIR = 'purplekit/seeds';
 exports.PURPLEKIT_SEEDS_DIR = PURPLEKIT_SEEDS_DIR;
 const PURPLEKIT_MIGRATIONS_GLOB = 'purplekit/migrations/**/*.{ts,js}';
 exports.PURPLEKIT_MIGRATIONS_GLOB = PURPLEKIT_MIGRATIONS_GLOB;
+const SUPPORTED_TYPES = ['postgres', 'mysql', 'mariadb'];
+exports.SUPPORTED_TYPES = SUPPORTED_TYPES;
 //# sourceMappingURL=constants.js.map

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

@@ -1 +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"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/config/constants.ts"],"names":[],"mappings":";;;AAAA,MAAM,cAAc,GAAG,WAAW,CAAC;AAejC,wCAAc;AAdhB,MAAM,mBAAmB,GAAG,+BAA+B,CAAC;AAW1D,kDAAmB;AAVrB,MAAM,mBAAmB,GAAG,+BAA+B,CAAC;AAS1D,kDAAmB;AARrB,MAAM,wBAAwB,GAAG,sBAAsB,CAAC;AAUtD,4DAAwB;AAT1B,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAY5C,kDAAmB;AAXrB,MAAM,yBAAyB,GAAG,mCAAmC,CAAC;AASpE,8DAAyB;AAP3B,MAAM,eAAe,GAAG,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAGhE,0CAAe"}

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

@@ -1,4 +1,10 @@
 import { PURPLEKIT_INTERNAL_CONFIGURATIONS } from '../types';
+/**
+ * Throws the config load error, if any, so commands never run against
+ * silently-defaulted settings when the user's config is broken. Also rejects
+ * database types purplekit does not support.
+ */
+declare function assertConfigLoaded(): void;
 declare const cfg: PURPLEKIT_INTERNAL_CONFIGURATIONS;
-export { cfg };
+export { cfg, assertConfigLoaded };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iCAAiC,EAClC,MAAM,SAAS,CAAC;AA+DjB,QAAA,MAAM,GAAG,EAAE,iCAOV,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,iCAAiC,EAClC,MAAM,SAAS,CAAC;AAiFjB;;;;GAIG;AACH,iBAAS,kBAAkB,SAO1B;AAID,QAAA,MAAM,GAAG,EAAE,iCAOV,CAAC;AAEF,OAAO,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC"}

package/build/src/config/index.js

@@ -34,6 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.cfg = void 0;
+exports.assertConfigLoaded = assertConfigLoaded;
 const constants_1 = require("./constants");
 const node_module_1 = require("node:module");
 const node_fs_1 = require("node:fs");
@@ -45,6 +46,7 @@ const defaults = {
     TYPE: 'postgres',
     SSL_MODE: false,
     SSL_TYPE: 'light',
+    SSL_REJECT_UNAUTHORIZED: false,
     DATABASE_CA_CERT: './',
     DATABASE_HOST: 'localhost',
     DATABASE_PORT: 5432,
@@ -76,7 +78,34 @@ function loadUserConfig() {
     }
     return {};
 }
-const userConfig = loadUserConfig();
+/**
+ * Error raised while loading the user config, kept so the CLI can report it
+ * as a normal message instead of crashing during module import.
+ */
+let configError = null;
+function safeLoadUserConfig() {
+    try {
+        return loadUserConfig();
+    }
+    catch (e) {
+        const detail = e instanceof Error ? e.message : String(e);
+        configError = new Error(`Unable to load the purplekit config (${constants_1.PURPLEKIT_CONFIG_TS} or ${constants_1.PURPLEKIT_CONFIG_JS}): ${detail}`);
+        return {};
+    }
+}
+/**
+ * Throws the config load error, if any, so commands never run against
+ * silently-defaulted settings when the user's config is broken. Also rejects
+ * database types purplekit does not support.
+ */
+function assertConfigLoaded() {
+    if (configError)
+        throw configError;
+    if (!constants_1.SUPPORTED_TYPES.includes(cfg.TYPE)) {
+        throw new Error(`Unsupported database TYPE '${String(cfg.TYPE)}' in the purplekit config. Supported types: ${constants_1.SUPPORTED_TYPES.join(', ')}.`);
+    }
+}
+const userConfig = safeLoadUserConfig();
 const cfg = Object.assign(Object.assign(Object.assign({}, defaults), userConfig), { ROOT: constants_1.PURPLEKIT_ROOT, MIGRATIONS_DIR: constants_1.PURPLEKIT_MIGRATIONS_DIR, SEEDS_DIR: constants_1.PURPLEKIT_SEEDS_DIR, MIGRATIONS: [constants_1.PURPLEKIT_MIGRATIONS_GLOB] });
 exports.cfg = cfg;
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIA,2CAOqB;AACrB,6CAA4C;AAC5C,qCAAqC;AACrC,gDAAkC;AAElC,MAAM,aAAa,GAAG,IAAA,2BAAa,EACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CACjD,CAAC;AAEF,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,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC;QAED,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/config/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA6Gc,gDAAkB;AAzGhC,2CAQqB;AACrB,6CAA4C;AAC5C,qCAAqC;AACrC,gDAAkC;AAElC,MAAM,aAAa,GAAG,IAAA,2BAAa,EACjC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,sBAAsB,CAAC,CACjD,CAAC;AAEF,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,uBAAuB,EAAE,KAAK;IAC9B,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,IAAI,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,OAAO,CAAC,SAAS,CAAC,CAAC;QACrB,CAAC;QAED,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;;;GAGG;AACH,IAAI,WAAW,GAAiB,IAAI,CAAC;AAErC,SAAS,kBAAkB;IACzB,IAAI,CAAC;QACH,OAAO,cAAc,EAAE,CAAC;IAC1B,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,MAAM,GAAG,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1D,WAAW,GAAG,IAAI,KAAK,CACrB,wCAAwC,+BAAmB,OAAO,+BAAmB,MAAM,MAAM,EAAE,CACpG,CAAC;QACF,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,kBAAkB;IACzB,IAAI,WAAW;QAAE,MAAM,WAAW,CAAC;IACnC,IAAI,CAAE,2BAAqC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,8BAA8B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,+CAA+C,2BAAe,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC3H,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;AAExC,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

@@ -16,6 +16,6 @@ declare function create(name: string): Promise<{
  *
  * @param args - CLI options; `name` defaults to `cfg.DATABASE_NAME`.
  */
-declare function createdb(args: CREATE_DB): Promise<void>;
+declare function createdb(args: CREATE_DB): Promise<0 | 1>;
 export { createdb, create };
 //# sourceMappingURL=createdb.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"createdb.d.ts","sourceRoot":"","sources":["../../../src/features/createdb.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAOpC;;;;;;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,CAwBD;AAED;;;;GAIG;AACH,iBAAe,QAAQ,CAAC,IAAI,EAAE,SAAS,kBAetC;AAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC"}

package/build/src/features/createdb.js

@@ -14,6 +14,7 @@ exports.create = create;
 const get_commands_1 = require("../libs/get-commands");
 const config_1 = require("../config");
 const print_1 = require("../libs/print");
+const format_error_1 = require("../libs/format-error");
 const sanitize_1 = require("../libs/sanitize");
 const create_ds_1 = require("../libs/create-ds");
 /**
@@ -42,10 +43,6 @@ function create(name) {
                 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();
@@ -61,19 +58,21 @@ function create(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);
+        const name = (_a = args.name) !== null && _a !== void 0 ? _a : config_1.cfg.DATABASE_NAME;
         try {
+            (0, sanitize_1.sanitize)(name, 'database name');
             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.`);
+            return 0;
         }
         catch (e) {
-            const err = e instanceof Error ? e.message : 'Unable to serialize error';
+            const err = (0, format_error_1.formatError)(e);
             (0, print_1.printf)(`Failed to create database '${name}': ${err}`);
-            process.exit(1);
+            return 1;
         }
     });
 }

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

@@ -1 +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,yBAAyB,CAAC,CAAC;YACpD,CAAC;;gBAAM,IAAA,aAAK,EAAC,aAAa,IAAI,mBAAmB,CAAC,CAAC;QACrD,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,8BAA8B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CAAA"}
+{"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,sDAAkD;AAClD,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;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,MAAA,IAAI,CAAC,IAAI,mCAAI,YAAG,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC;YACH,IAAA,mBAAQ,EAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YAEpC,IAAI,QAAQ,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAClC,IAAA,aAAK,EAAC,aAAa,IAAI,yBAAyB,CAAC,CAAC;YACpD,CAAC;;gBAAM,IAAA,aAAK,EAAC,aAAa,IAAI,mBAAmB,CAAC,CAAC;YACnD,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,IAAA,0BAAW,EAAC,CAAC,CAAC,CAAC;YAC3B,IAAA,cAAM,EAAC,8BAA8B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;YACtD,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;CAAA"}

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

@@ -13,6 +13,6 @@ declare function drop(name: string): Promise<{
  *
  * @param args - CLI options; `name` defaults to `cfg.DATABASE_NAME`.
  */
-declare function dropdb(args: DROP_DB): Promise<void>;
+declare function dropdb(args: DROP_DB): Promise<0 | 1>;
 export { dropdb, drop };
 //# sourceMappingURL=dropdb.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"dropdb.d.ts","sourceRoot":"","sources":["../../../src/features/dropdb.ts"],"names":[],"mappings":"AAEA,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,CAe/D;AAED;;;;GAIG;AACH,iBAAe,MAAM,CAAC,IAAI,EAAE,OAAO,kBAelC;AAED,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC"}

package/build/src/features/dropdb.js

@@ -12,6 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.dropdb = dropdb;
 exports.drop = drop;
 const print_1 = require("../libs/print");
+const format_error_1 = require("../libs/format-error");
 const config_1 = require("../config");
 const sanitize_1 = require("../libs/sanitize");
 const get_commands_1 = require("../libs/get-commands");
@@ -33,10 +34,6 @@ function drop(name) {
             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();
@@ -52,18 +49,20 @@ function drop(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);
+        const name = (_a = args.name) !== null && _a !== void 0 ? _a : config_1.cfg.DATABASE_NAME;
         try {
+            (0, sanitize_1.sanitize)(name, 'database name');
             const response = yield drop(name);
             const msg = response.dropped
                 ? `Database '${name}' dropped successfully.`
                 : `Database '${name}' was not dropped.`;
             (0, print_1.print)(msg);
+            return 0;
         }
         catch (e) {
-            const err = e instanceof Error ? e.message : 'Unable to serialize err';
+            const err = (0, format_error_1.formatError)(e);
             (0, print_1.printf)(`Failed to drop database '${name}': ${err}`);
-            process.exit(1);
+            return 1;
         }
     });
 }

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

@@ -1 +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,yBAAyB;gBAC5C,CAAC,CAAC,aAAa,IAAI,oBAAoB,CAAC;YAC1C,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,4BAA4B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CAAA"}
+{"version":3,"file":"dropdb.js","sourceRoot":"","sources":["../../../src/features/dropdb.ts"],"names":[],"mappings":";;;;;;;;;;;AAqDS,wBAAM;AAAE,oBAAI;AArDrB,wCAA6C;AAC7C,sDAAkD;AAElD,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;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,MAAA,IAAI,CAAC,IAAI,mCAAI,YAAG,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC;YACH,IAAA,mBAAQ,EAAC,IAAI,EAAE,eAAe,CAAC,CAAC;YAChC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,GAAG,GAAG,QAAQ,CAAC,OAAO;gBAC1B,CAAC,CAAC,aAAa,IAAI,yBAAyB;gBAC5C,CAAC,CAAC,aAAa,IAAI,oBAAoB,CAAC;YAC1C,IAAA,aAAK,EAAC,GAAG,CAAC,CAAC;YACX,OAAO,CAAC,CAAC;QACX,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,GAAG,GAAG,IAAA,0BAAW,EAAC,CAAC,CAAC,CAAC;YAC3B,IAAA,cAAM,EAAC,4BAA4B,IAAI,MAAM,GAAG,EAAE,CAAC,CAAC;YACpD,OAAO,CAAC,CAAC;QACX,CAAC;IACH,CAAC;CAAA"}

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

@@ -35,6 +35,7 @@ declare const hasSchemaChanges: (ds: DataSource) => Promise<boolean>;
  * @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.
+ * Both sources are empty when there is nothing to generate.
  */
 declare const genMig: (ds: DataSource, name: string, timestamp: number) => Promise<{
     content: string;
@@ -62,23 +63,22 @@ declare const getMetadata: (name?: string) => {
 };
 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.
+ * @param params - Generation options including target database, 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.
+ * @param args - CLI options for the migration name.
  */
-declare const gen: (args: GENERATE_MIGRATIONS) => Promise<never>;
+declare const gen: (args: GENERATE_MIGRATIONS) => Promise<0 | 1>;
 export { gen, generate, genMig, compareMig, getMetadata, saveMig, hasSchemaChanges, };
 //# sourceMappingURL=gen.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"gen.d.ts","sourceRoot":"","sources":["../../../src/features/gen.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAG9C,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;;;;;;;;GAQG;AACH,QAAA,MAAM,MAAM,GAAU,IAAI,UAAU,EAAE,MAAM,MAAM,EAAE,WAAW,MAAM;;;;EA2BpE,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,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,CA+DvB,CAAC;AAEF;;;;GAIG;AACH,QAAA,MAAM,GAAG,GAAU,MAAM,mBAAmB,mBA+B3C,CAAC;AAEF,OAAO,EACL,GAAG,EACH,QAAQ,EACR,MAAM,EACN,UAAU,EACV,WAAW,EACX,OAAO,EACP,gBAAgB,GACjB,CAAC"}

package/build/src/features/gen.js

@@ -49,6 +49,7 @@ exports.hasSchemaChanges = exports.saveMig = exports.getMetadata = exports.compa
 const typeorm_extension_1 = require("typeorm-extension");
 const create_ds_1 = require("../libs/create-ds");
 const print_1 = require("../libs/print");
+const format_error_1 = require("../libs/format-error");
 const config_1 = require("../config");
 const sanitize_1 = require("../libs/sanitize");
 const compare_mig_1 = require("../libs/compare-mig");
@@ -78,6 +79,7 @@ exports.hasSchemaChanges = hasSchemaChanges;
  * @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.
+ * Both sources are empty when there is nothing to generate.
  */
 const genMig = (ds, name, timestamp) => __awaiter(void 0, void 0, void 0, function* () {
     const hasChanges = yield hasSchemaChanges(ds);
@@ -87,6 +89,10 @@ const genMig = (ds, name, timestamp) => __awaiter(void 0, void 0, void 0, functi
         dataSource: ds,
         preview: true,
     });
+    // typeorm-extension returns no `content` when the schema is already in sync
+    if (!result.content) {
+        return { content: '', formatted: '', hasChanges };
+    }
     const formatted = yield prettier_1.default.format(result.content, {
         parser: 'typescript',
         singleQuote: true,
@@ -134,8 +140,8 @@ 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.
+ * @param params - Generation options including target database, 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 = {}) {
@@ -147,7 +153,7 @@ const generate = (...args_1) => __awaiter(void 0, [...args_1], void 0, function*
         yield ds.initialize();
         initialized = true;
         const generated = yield genMig(ds, metadata.migrationName, metadata.timestamp);
-        if (!generated.hasChanges && !params.force) {
+        if (!generated.content || !generated.hasChanges) {
             return {
                 generated: false,
                 more: {
@@ -189,10 +195,6 @@ const generate = (...args_1) => __awaiter(void 0, [...args_1], void 0, function*
             },
         };
     }
-    catch (e) {
-        const err = e instanceof Error ? e.message : JSON.stringify(e);
-        throw new Error(err);
-    }
     finally {
         if (initialized) {
             yield ds.destroy();
@@ -203,15 +205,14 @@ exports.generate = generate;
 /**
  * CLI handler for the `gen` command.
  *
- * @param args - CLI options for migration name and force flag.
+ * @param args - CLI options for the migration name.
  */
 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 {
+        const database = (0, sanitize_1.sanitize)(config_1.cfg.DATABASE_NAME, 'DATABASE_NAME');
+        const name = args.name ? (0, sanitize_1.sanitize)(args.name, 'migration name') : undefined;
         (0, print_1.print)(`Generating migration for '${database}'...`);
         const response = yield generate({
-            force: args.force,
             db: database,
             name: name,
             save: true,
@@ -221,7 +222,8 @@ const gen = (args) => __awaiter(void 0, void 0, void 0, function* () {
                 (0, print_1.print)('No schema changes detected. Migration generation skipped.');
             }
             else if (response.more.reason === 'duplicate-found') {
-                (0, print_1.printf)(`Duplicate migration found: ${response.more.duplicateOf}.`);
+                (0, print_1.printf)(`Migration not saved: it duplicates existing migration '${response.more.duplicateOf}'.`);
+                return 1;
             }
             else
                 throw new Error('Unknown generated response');
@@ -229,12 +231,12 @@ const gen = (args) => __awaiter(void 0, void 0, void 0, function* () {
         else {
             (0, print_1.print)(`Migration for '${database}' created successfully: ${response.more.title}.`);
         }
-        process.exit(0);
+        return 0;
     }
     catch (e) {
-        const err = e instanceof Error ? e.message : JSON.stringify(e);
+        const err = (0, format_error_1.formatError)(e);
         (0, print_1.printf)(`Failed to generate migration: ${err}`);
-        process.exit(1);
+        return 1;
     }
 });
 exports.gen = gen;