@pristine-ts/mysql-cli 2.0.16

package/dist/lib/cjs/managers/mysql-migration-record.manager.js

@@ -0,0 +1,96 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+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.MysqlMigrationRecordManager = void 0;
+const tsyringe_1 = require("tsyringe");
+const migration_record_model_1 = require("../models/migration-record.model");
+/**
+ * Owns the `pristine_migrations` bookkeeping table — creates it on demand, reads
+ * the applied rows back, and inserts a new row when a migration finishes.
+ *
+ * Uses the regular `MysqlClient` pool (no `multipleStatements` needed for any of
+ * these queries — they're single statements with parameter placeholders).
+ */
+let MysqlMigrationRecordManager = class MysqlMigrationRecordManager {
+    constructor(mysqlClient, logHandler) {
+        this.mysqlClient = mysqlClient;
+        this.logHandler = logHandler;
+    }
+    ensureTable(configUniqueKeyname, tableName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sql = `CREATE TABLE IF NOT EXISTS \`${tableName}\` (
+      id                INT UNSIGNED NOT NULL AUTO_INCREMENT,
+      filename          VARCHAR(255) NOT NULL,
+      checksum          CHAR(64)     NOT NULL,
+      applied_at        DATETIME(3)  NOT NULL DEFAULT CURRENT_TIMESTAMP(3),
+      execution_time_ms INT UNSIGNED NULL,
+      PRIMARY KEY (id),
+      UNIQUE KEY uniq_filename (filename)
+    )`;
+            yield this.mysqlClient.executeSql(configUniqueKeyname, sql, []);
+            this.logHandler.debug("MysqlMigrationRecordManager: ensured bookkeeping table.", {
+                highlights: { tableName, configUniqueKeyname },
+            });
+        });
+    }
+    listApplied(configUniqueKeyname, tableName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sql = `SELECT id, filename, checksum, applied_at, execution_time_ms
+                 FROM \`${tableName}\`
+                 ORDER BY filename ASC`;
+            const rows = yield this.mysqlClient.executeSql(configUniqueKeyname, sql, []);
+            return rows.map((row) => {
+                var _a;
+                const record = new migration_record_model_1.MigrationRecord();
+                record.id = row.id;
+                record.filename = row.filename;
+                record.checksum = row.checksum;
+                record.appliedAt = row.applied_at instanceof Date ? row.applied_at : new Date(row.applied_at);
+                record.executionTimeMs = (_a = row.execution_time_ms) !== null && _a !== void 0 ? _a : undefined;
+                return record;
+            });
+        });
+    }
+    recordApplied(configUniqueKeyname, tableName, record) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const sql = `INSERT INTO \`${tableName}\` (filename, checksum, execution_time_ms)
+                 VALUES (?, ?, ?)`;
+            yield this.mysqlClient.executeSql(configUniqueKeyname, sql, [
+                record.filename,
+                record.checksum,
+                record.executionTimeMs,
+            ]);
+            this.logHandler.debug("MysqlMigrationRecordManager: recorded applied migration.", {
+                highlights: { tableName, configUniqueKeyname, filename: record.filename },
+            });
+        });
+    }
+};
+exports.MysqlMigrationRecordManager = MysqlMigrationRecordManager;
+exports.MysqlMigrationRecordManager = MysqlMigrationRecordManager = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)("MysqlClientInterface")),
+    __param(1, (0, tsyringe_1.inject)("LogHandlerInterface")),
+    __metadata("design:paramtypes", [Object, Object])
+], MysqlMigrationRecordManager);
+//# sourceMappingURL=mysql-migration-record.manager.js.map

package/dist/lib/cjs/managers/mysql-migration-record.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-migration-record.manager.js","sourceRoot":"","sources":["../../../../src/managers/mysql-migration-record.manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAA4C;AAG5C,6EAAiE;AAEjE;;;;;;GAMG;AAEI,IAAM,2BAA2B,GAAjC,MAAM,2BAA2B;IACtC,YACmD,WAAiC,EAClC,UAA+B;QAD9B,gBAAW,GAAX,WAAW,CAAsB;QAClC,eAAU,GAAV,UAAU,CAAqB;IAEjF,CAAC;IAEY,WAAW,CAAC,mBAA2B,EAAE,SAAiB;;YACrE,MAAM,GAAG,GAAG,gCAAgC,SAAS;;;;;;;;MAQnD,CAAC;YAEH,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAEhE,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,yDAAyD,EAAE;gBAC/E,UAAU,EAAE,EAAC,SAAS,EAAE,mBAAmB,EAAC;aAC7C,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,WAAW,CAAC,mBAA2B,EAAE,SAAiB;;YACrE,MAAM,GAAG,GAAG;0BACU,SAAS;uCACI,CAAC;YAEpC,MAAM,IAAI,GAML,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;YAErE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;;gBACtB,MAAM,MAAM,GAAG,IAAI,wCAAe,EAAE,CAAC;gBACrC,MAAM,CAAC,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;gBACnB,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;gBAC/B,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;gBAC/B,MAAM,CAAC,SAAS,GAAG,GAAG,CAAC,UAAU,YAAY,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;gBAC9F,MAAM,CAAC,eAAe,GAAG,MAAA,GAAG,CAAC,iBAAiB,mCAAI,SAAS,CAAC;gBAC5D,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC,CAAC;QACL,CAAC;KAAA;IAEY,aAAa,CACxB,mBAA2B,EAC3B,SAAiB,EACjB,MAAuE;;YAEvE,MAAM,GAAG,GAAG,iBAAiB,SAAS;kCACR,CAAC;YAE/B,MAAM,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,mBAAmB,EAAE,GAAG,EAAE;gBAC1D,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,QAAQ;gBACf,MAAM,CAAC,eAAe;aACvB,CAAC,CAAC;YAEH,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,0DAA0D,EAAE;gBAChF,UAAU,EAAE,EAAC,SAAS,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAC;aACxE,CAAC,CAAC;QACL,CAAC;KAAA;CACF,CAAA;AAnEY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,qBAAU,GAAE;IAGR,WAAA,IAAA,iBAAM,EAAC,sBAAsB,CAAC,CAAA;IAC9B,WAAA,IAAA,iBAAM,EAAC,qBAAqB,CAAC,CAAA;;GAHrB,2BAA2B,CAmEvC"}

package/dist/lib/cjs/managers/mysql-migration-runner.manager.js

@@ -0,0 +1,96 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+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.MysqlMigrationRunner = void 0;
+const tsyringe_1 = require("tsyringe");
+const promise_1 = require("mysql2/promise");
+const migration_execution_error_1 = require("../errors/migration-execution.error");
+/**
+ * Executes a single migration's SQL string against a target database. Opens a
+ * one-shot mysql2 connection with `multipleStatements: true` for the call and
+ * closes it in `finally` — does NOT touch the cached `MysqlClient` pool because
+ * flipping `multipleStatements` on the pool would leak to every other consumer
+ * of the client. A dedicated connection per migration is the cleanest isolation.
+ */
+let MysqlMigrationRunner = class MysqlMigrationRunner {
+    constructor(mysqlConfigProviders, logHandler) {
+        this.mysqlConfigProviders = mysqlConfigProviders;
+        this.logHandler = logHandler;
+    }
+    execute(configUniqueKeyname, migrationName, sql) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const config = yield this.resolveConfig(configUniqueKeyname);
+            const connection = yield (0, promise_1.createConnection)({
+                host: config.host,
+                port: config.port,
+                user: config.user,
+                password: config.password,
+                database: config.database,
+                debug: config.debug,
+                multipleStatements: true,
+            });
+            const startedAt = Date.now();
+            try {
+                yield connection.query(sql);
+                const executionTimeMs = Date.now() - startedAt;
+                this.logHandler.debug("MysqlMigrationRunner: migration executed successfully.", {
+                    highlights: { configUniqueKeyname, migrationName, executionTimeMs },
+                });
+                return executionTimeMs;
+            }
+            catch (error) {
+                this.logHandler.error("MysqlMigrationRunner: migration execution failed.", {
+                    highlights: { configUniqueKeyname, migrationName, error },
+                });
+                throw new migration_execution_error_1.MigrationExecutionError(migrationName, configUniqueKeyname, error);
+            }
+            finally {
+                try {
+                    yield connection.end();
+                }
+                catch (closeError) {
+                    this.logHandler.warning("MysqlMigrationRunner: failed to close migration connection cleanly.", {
+                        highlights: { configUniqueKeyname, migrationName, error: closeError },
+                    });
+                }
+            }
+        });
+    }
+    resolveConfig(configUniqueKeyname) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const provider = this.mysqlConfigProviders.find((p) => p.supports(configUniqueKeyname));
+            if (provider === undefined) {
+                throw new Error(`No MysqlConfigProvider supports the unique keyname "${configUniqueKeyname}".`);
+            }
+            return provider.getMysqlConfig(configUniqueKeyname);
+        });
+    }
+};
+exports.MysqlMigrationRunner = MysqlMigrationRunner;
+exports.MysqlMigrationRunner = MysqlMigrationRunner = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.injectAll)("MysqlConfigProviderInterface")),
+    __param(1, (0, tsyringe_1.inject)("LogHandlerInterface")),
+    __metadata("design:paramtypes", [Array, Object])
+], MysqlMigrationRunner);
+//# sourceMappingURL=mysql-migration-runner.manager.js.map

package/dist/lib/cjs/managers/mysql-migration-runner.manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-migration-runner.manager.js","sourceRoot":"","sources":["../../../../src/managers/mysql-migration-runner.manager.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAAA,uCAAuD;AACvD,4CAAgD;AAGhD,mFAA4E;AAE5E;;;;;;GAMG;AAEI,IAAM,oBAAoB,GAA1B,MAAM,oBAAoB;IAC/B,YAC8D,oBAAoD,EAChE,UAA+B;QADnB,yBAAoB,GAApB,oBAAoB,CAAgC;QAChE,eAAU,GAAV,UAAU,CAAqB;IAEjF,CAAC;IAEY,OAAO,CAAC,mBAA2B,EAAE,aAAqB,EAAE,GAAW;;YAClF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,mBAAmB,CAAC,CAAC;YAE7D,MAAM,UAAU,GAAG,MAAM,IAAA,0BAAgB,EAAC;gBACxC,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,kBAAkB,EAAE,IAAI;aACzB,CAAC,CAAC;YAEH,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,CAAC;gBACH,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;gBAE/C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,wDAAwD,EAAE;oBAC9E,UAAU,EAAE,EAAC,mBAAmB,EAAE,aAAa,EAAE,eAAe,EAAC;iBAClE,CAAC,CAAC;gBAEH,OAAO,eAAe,CAAC;YACzB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,mDAAmD,EAAE;oBACzE,UAAU,EAAE,EAAC,mBAAmB,EAAE,aAAa,EAAE,KAAK,EAAC;iBACxD,CAAC,CAAC;gBAEH,MAAM,IAAI,mDAAuB,CAAC,aAAa,EAAE,mBAAmB,EAAE,KAAc,CAAC,CAAC;YACxF,CAAC;oBAAS,CAAC;gBACT,IAAI,CAAC;oBACH,MAAM,UAAU,CAAC,GAAG,EAAE,CAAC;gBACzB,CAAC;gBAAC,OAAO,UAAU,EAAE,CAAC;oBACpB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,qEAAqE,EAAE;wBAC7F,UAAU,EAAE,EAAC,mBAAmB,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAC;qBACpE,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;KAAA;IAEa,aAAa,CAAC,mBAA2B;;YACrD,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC,CAAC;YAExF,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,MAAM,IAAI,KAAK,CAAC,uDAAuD,mBAAmB,IAAI,CAAC,CAAC;YAClG,CAAC;YAED,OAAO,QAAQ,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;QACtD,CAAC;KAAA;CACF,CAAA;AAzDY,oDAAoB;+BAApB,oBAAoB;IADhC,IAAA,qBAAU,GAAE;IAGR,WAAA,IAAA,oBAAS,EAAC,8BAA8B,CAAC,CAAA;IACzC,WAAA,IAAA,iBAAM,EAAC,qBAAqB,CAAC,CAAA;;GAHrB,oBAAoB,CAyDhC"}

package/dist/lib/cjs/managers/mysql-migration-scaffold.manager.js

@@ -0,0 +1,217 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+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 };
+};
+var MysqlMigrationScaffoldManager_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MysqlMigrationScaffoldManager = void 0;
+const path_1 = __importDefault(require("path"));
+const fs_1 = require("fs");
+const tsyringe_1 = require("tsyringe");
+/**
+ * Generates a new `.sql-migrations.ts` file and optionally splices its registration
+ * into a marker-annotated migrations module file. Pure dev-time scaffolding — never
+ * touches the database, never resolved at runtime in production.
+ *
+ * Numbering: scans the target directory for files matching `<digits>-<slug>.sql-migrations.ts`,
+ * picks `max + 1`, and pads to the current width (default 2 digits, never narrows).
+ * If you cross 99 you'll want to rename existing files to 3-digit padding once; the
+ * scaffold respects whichever width it finds.
+ */
+let MysqlMigrationScaffoldManager = MysqlMigrationScaffoldManager_1 = class MysqlMigrationScaffoldManager {
+    constructor(logHandler) {
+        this.logHandler = logHandler;
+    }
+    create(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const slug = this.slugify(options.descriptiveName);
+            if (slug.length === 0) {
+                throw new Error(`Cannot scaffold a migration from an empty/symbol-only name: "${options.descriptiveName}".`);
+            }
+            yield fs_1.promises.mkdir(options.scaffoldPath, { recursive: true });
+            const existingPrefixes = yield this.listExistingNumberPrefixes(options.scaffoldPath);
+            const width = this.resolveWidth(existingPrefixes);
+            const nextNumber = (existingPrefixes.length === 0 ? 0 : Math.max(...existingPrefixes)) + 1;
+            const paddedNumber = nextNumber.toString().padStart(width, "0");
+            const migrationName = `${paddedNumber}-${slug}`;
+            const fileName = `${migrationName}.sql-migrations.ts`;
+            const filePath = path_1.default.join(options.scaffoldPath, fileName);
+            if (yield this.exists(filePath)) {
+                throw new Error(`Refusing to overwrite existing migration file at ${filePath}.`);
+            }
+            const className = this.buildClassName(slug, paddedNumber);
+            const fileContent = this.renderMigrationFile(className, migrationName, options.configUniqueKeynames);
+            yield fs_1.promises.writeFile(filePath, fileContent, "utf8");
+            let barrelUpdated = false;
+            if (options.barrelPath !== undefined) {
+                barrelUpdated = yield this.tryUpdateBarrel({
+                    barrelPath: options.barrelPath,
+                    scaffoldPath: options.scaffoldPath,
+                    migrationFileName: fileName,
+                    className,
+                });
+            }
+            return { filePath, className, migrationName, barrelUpdated };
+        });
+    }
+    renderMigrationFile(className, migrationName, configUniqueKeynames) {
+        const configLine = configUniqueKeynames === undefined || configUniqueKeynames.length === 0
+            ? `  // readonly configUniqueKeynames = ["__default__"];   // uncomment to scope to specific configs`
+            : `  readonly configUniqueKeynames = ${JSON.stringify(configUniqueKeynames)};`;
+        return `import {injectable} from "tsyringe";
+import {tag} from "@pristine-ts/common";
+import {MysqlMigrationInterface} from "@pristine-ts/mysql-cli";
+
+@tag("MysqlMigrationInterface")
+@injectable()
+export class ${className} implements MysqlMigrationInterface {
+  readonly name = "${migrationName}";
+${configLine}
+
+  up(): string {
+    return \`
+      -- write your SQL here
+    \`;
+  }
+}
+`;
+    }
+    buildClassName(slug, paddedNumber) {
+        const pascal = slug
+            .split("-")
+            .filter((part) => part.length > 0)
+            .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+            .join("");
+        return `${pascal}_${paddedNumber}`;
+    }
+    slugify(input) {
+        return input
+            .toLowerCase()
+            .replace(/[^a-z0-9]+/g, "-")
+            .replace(/^-+|-+$/g, "");
+    }
+    tryUpdateBarrel(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!(yield this.exists(options.barrelPath))) {
+                this.logHandler.warning("MysqlMigrationScaffoldManager: barrel file not found; skipping auto-edit.", {
+                    highlights: { barrelPath: options.barrelPath },
+                });
+                return false;
+            }
+            const original = yield fs_1.promises.readFile(options.barrelPath, "utf8");
+            if (original.indexOf(MysqlMigrationScaffoldManager_1.ImportsStart) === -1 ||
+                original.indexOf(MysqlMigrationScaffoldManager_1.ImportsEnd) === -1 ||
+                original.indexOf(MysqlMigrationScaffoldManager_1.ServicesStart) === -1 ||
+                original.indexOf(MysqlMigrationScaffoldManager_1.ServicesEnd) === -1) {
+                this.logHandler.warning("MysqlMigrationScaffoldManager: marker comments not found in barrel; skipping auto-edit.", {
+                    highlights: { barrelPath: options.barrelPath },
+                });
+                return false;
+            }
+            const relativeImport = this.relativeImportSpecifier(options.barrelPath, options.scaffoldPath, options.migrationFileName);
+            const importLine = `import {${options.className}} from "${relativeImport}";`;
+            const serviceLine = `${options.className},`;
+            const withImport = this.insertSortedBetween(original, MysqlMigrationScaffoldManager_1.ImportsStart, MysqlMigrationScaffoldManager_1.ImportsEnd, importLine);
+            const withService = this.insertSortedBetween(withImport, MysqlMigrationScaffoldManager_1.ServicesStart, MysqlMigrationScaffoldManager_1.ServicesEnd, serviceLine);
+            yield fs_1.promises.writeFile(options.barrelPath, withService, "utf8");
+            return true;
+        });
+    }
+    insertSortedBetween(source, startMarker, endMarker, newLine) {
+        var _a;
+        const lines = source.split("\n");
+        const startIndex = lines.findIndex((line) => line.trim() === startMarker);
+        const endIndex = lines.findIndex((line) => line.trim() === endMarker);
+        if (startIndex === -1 || endIndex === -1 || endIndex <= startIndex) {
+            return source;
+        }
+        const indent = ((_a = lines[startIndex].match(/^\s*/)) !== null && _a !== void 0 ? _a : [""])[0];
+        const existing = lines.slice(startIndex + 1, endIndex).filter((line) => line.trim().length > 0);
+        if (existing.some((line) => line.trim() === newLine.trim())) {
+            return source;
+        }
+        const merged = [...existing, `${indent}${newLine}`].sort((a, b) => a.trim().localeCompare(b.trim()));
+        return [
+            ...lines.slice(0, startIndex + 1),
+            ...merged,
+            ...lines.slice(endIndex),
+        ].join("\n");
+    }
+    relativeImportSpecifier(barrelPath, scaffoldPath, migrationFileName) {
+        const barrelDir = path_1.default.dirname(path_1.default.resolve(barrelPath));
+        const migrationAbs = path_1.default.resolve(scaffoldPath, migrationFileName);
+        let rel = path_1.default.relative(barrelDir, migrationAbs).replace(/\\/g, "/");
+        rel = rel.replace(/\.ts$/, "");
+        if (rel.startsWith(".") === false) {
+            rel = `./${rel}`;
+        }
+        return rel;
+    }
+    listExistingNumberPrefixes(dir) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!(yield this.exists(dir))) {
+                return [];
+            }
+            const entries = yield fs_1.promises.readdir(dir);
+            const prefixes = [];
+            for (const entry of entries) {
+                const match = MysqlMigrationScaffoldManager_1.FilenamePattern.exec(entry);
+                if (match) {
+                    prefixes.push(parseInt(match[1], 10));
+                }
+            }
+            return prefixes;
+        });
+    }
+    resolveWidth(existingPrefixes) {
+        if (existingPrefixes.length === 0) {
+            return 2;
+        }
+        const maxDigits = Math.max(...existingPrefixes.map((n) => n.toString().length));
+        return Math.max(2, maxDigits);
+    }
+    exists(filePath) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield fs_1.promises.access(filePath);
+                return true;
+            }
+            catch (_a) {
+                return false;
+            }
+        });
+    }
+};
+exports.MysqlMigrationScaffoldManager = MysqlMigrationScaffoldManager;
+MysqlMigrationScaffoldManager.FilenamePattern = /^(\d+)-([a-z0-9-]+)\.sql-migrations\.ts$/;
+MysqlMigrationScaffoldManager.ImportsStart = "// <pristine:migration-imports:start>";
+MysqlMigrationScaffoldManager.ImportsEnd = "// <pristine:migration-imports:end>";
+MysqlMigrationScaffoldManager.ServicesStart = "// <pristine:migration-services:start>";
+MysqlMigrationScaffoldManager.ServicesEnd = "// <pristine:migration-services:end>";
+exports.MysqlMigrationScaffoldManager = MysqlMigrationScaffoldManager = MysqlMigrationScaffoldManager_1 = __decorate([
+    (0, tsyringe_1.injectable)(),
+    __param(0, (0, tsyringe_1.inject)("LogHandlerInterface")),
+    __metadata("design:paramtypes", [Object])
+], MysqlMigrationScaffoldManager);
+//# sourceMappingURL=mysql-migration-scaffold.manager.js.map

package/dist/lib/cjs/managers/mysql-migration-scaffold.manager.js.map

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