@pristine-ts/mysql-cli 2.0.16

package/dist/lib/esm/managers/mysql-migration.manager.js

@@ -0,0 +1,258 @@
+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 MysqlMigrationManager_1;
+import { inject, injectable, injectAll } from "tsyringe";
+import { traced } from "@pristine-ts/common";
+import { MigrationStateEnum } from "../enums/migration-state.enum";
+import { MigrationPlan } from "../models/migration-plan.model";
+import { MigrationPlanEntry } from "../models/migration-plan-entry.model";
+import { MigrationApplyResult } from "../models/migration-apply-result.model";
+import { MigrationApplyEntry } from "../models/migration-apply-entry.model";
+import { MysqlMigrationChecksumManager } from "./mysql-migration-checksum.manager";
+import { MysqlMigrationRecordManager } from "./mysql-migration-record.manager";
+import { MysqlMigrationRunner } from "./mysql-migration-runner.manager";
+import { MigrationInvalidNameError } from "../errors/migration-invalid-name.error";
+import { MigrationDuplicateNameError } from "../errors/migration-duplicate-name.error";
+import { MigrationChecksumMismatchError } from "../errors/migration-checksum-mismatch.error";
+import { MigrationOrphanedRecordError } from "../errors/migration-orphaned-record.error";
+import { MigrationExecutionError } from "../errors/migration-execution.error";
+/**
+ * Public orchestrator for migration operations. The CLI commands and any deploy-time
+ * runner should depend on this class — never on `MysqlMigrationRunner` /
+ * `MysqlMigrationRecordManager` directly.
+ *
+ * Discovery is DI-based: every migration registered with
+ * `@tag("MysqlMigrationInterface") @injectable()` and reachable through the AppModule's
+ * `importServices` graph is injected here via `@injectAll`. There is no filesystem
+ * scan at apply time, which means this works identically in a bundled Lambda and on
+ * a dev laptop.
+ */
+let MysqlMigrationManager = MysqlMigrationManager_1 = class MysqlMigrationManager {
+    constructor(registeredMigrations, mysqlConfigProviders, recordManager, runner, checksumManager, logHandler) {
+        this.registeredMigrations = registeredMigrations;
+        this.mysqlConfigProviders = mysqlConfigProviders;
+        this.recordManager = recordManager;
+        this.runner = runner;
+        this.checksumManager = checksumManager;
+        this.logHandler = logHandler;
+    }
+    status(configUniqueKeyname) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const tableName = yield this.resolveTableName(configUniqueKeyname);
+            yield this.recordManager.ensureTable(configUniqueKeyname, tableName);
+            return this.buildPlan(configUniqueKeyname, tableName);
+        });
+    }
+    verify(configUniqueKeyname) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const plan = yield this.status(configUniqueKeyname);
+            this.assertNoDrift(plan, configUniqueKeyname);
+            return plan;
+        });
+    }
+    apply(configUniqueKeyname, options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const dryRun = (options === null || options === void 0 ? void 0 : options.dryRun) === true;
+            const force = (options === null || options === void 0 ? void 0 : options.force) === true;
+            const tableName = yield this.resolveTableName(configUniqueKeyname);
+            yield this.recordManager.ensureTable(configUniqueKeyname, tableName);
+            const plan = yield this.buildPlan(configUniqueKeyname, tableName);
+            const result = new MigrationApplyResult();
+            result.configUniqueKeyname = configUniqueKeyname;
+            result.dryRun = dryRun;
+            if (force === false) {
+                this.assertNoDrift(plan, configUniqueKeyname);
+            }
+            else if (plan.hasDrift()) {
+                this.logHandler.warning("MysqlMigrationManager: proceeding past drift due to --force.", {
+                    highlights: {
+                        configUniqueKeyname,
+                        modified: plan.countByState(MigrationStateEnum.Modified),
+                        orphaned: plan.countByState(MigrationStateEnum.Orphaned),
+                    },
+                });
+            }
+            const migrationsByName = new Map(this.selectMigrations(configUniqueKeyname).map((m) => [m.name, m]));
+            for (const entry of plan.entries) {
+                if (entry.state === MigrationStateEnum.Applied) {
+                    result.skippedAlreadyApplied.push(entry.name);
+                    continue;
+                }
+                if (entry.state !== MigrationStateEnum.Pending) {
+                    // Modified or Orphaned — only reachable here under --force. Skip; the user is
+                    // explicitly accepting the drift, but we won't re-run modified migrations or
+                    // touch orphaned records.
+                    continue;
+                }
+                const migration = migrationsByName.get(entry.name);
+                if (migration === undefined) {
+                    // Defensive: a Pending entry by definition came from registeredMigrations.
+                    continue;
+                }
+                const sql = yield migration.up();
+                const checksum = this.checksumManager.compute(sql);
+                const applyEntry = new MigrationApplyEntry();
+                applyEntry.name = entry.name;
+                try {
+                    if (dryRun) {
+                        applyEntry.executionTimeMs = 0;
+                    }
+                    else {
+                        applyEntry.executionTimeMs = yield this.runner.execute(configUniqueKeyname, entry.name, sql);
+                        yield this.recordManager.recordApplied(configUniqueKeyname, tableName, {
+                            filename: entry.name,
+                            checksum,
+                            executionTimeMs: applyEntry.executionTimeMs,
+                        });
+                    }
+                    result.appliedMigrations.push(applyEntry);
+                }
+                catch (error) {
+                    applyEntry.executionTimeMs = 0;
+                    applyEntry.error = error instanceof MigrationExecutionError ? error.message : error.message;
+                    result.failedMigration = applyEntry;
+                    return result;
+                }
+            }
+            return result;
+        });
+    }
+    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);
+        });
+    }
+    resolveTableName(configUniqueKeyname) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const config = yield this.resolveConfig(configUniqueKeyname);
+            return (_a = config.migrationsTableName) !== null && _a !== void 0 ? _a : MysqlMigrationManager_1.DefaultTableName;
+        });
+    }
+    selectMigrations(configUniqueKeyname) {
+        const filtered = this.registeredMigrations.filter((migration) => {
+            if (migration.configUniqueKeynames === undefined) {
+                return true;
+            }
+            return migration.configUniqueKeynames.includes(configUniqueKeyname);
+        });
+        const seen = new Set();
+        for (const migration of filtered) {
+            if (MysqlMigrationManager_1.ValidNamePattern.test(migration.name) === false) {
+                throw new MigrationInvalidNameError(migration.name);
+            }
+            if (seen.has(migration.name)) {
+                throw new MigrationDuplicateNameError(migration.name, configUniqueKeyname);
+            }
+            seen.add(migration.name);
+        }
+        return [...filtered].sort((a, b) => a.name.localeCompare(b.name));
+    }
+    buildPlan(configUniqueKeyname, tableName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const plan = new MigrationPlan();
+            plan.configUniqueKeyname = configUniqueKeyname;
+            plan.tableName = tableName;
+            const selected = this.selectMigrations(configUniqueKeyname);
+            const records = yield this.recordManager.listApplied(configUniqueKeyname, tableName);
+            const recordsByName = new Map(records.map((r) => [r.filename, r]));
+            const seenNames = new Set();
+            for (const migration of selected) {
+                const sql = yield migration.up();
+                const diskChecksum = this.checksumManager.compute(sql);
+                const record = recordsByName.get(migration.name);
+                const entry = new MigrationPlanEntry();
+                entry.name = migration.name;
+                entry.diskChecksum = diskChecksum;
+                if (record === undefined) {
+                    entry.state = MigrationStateEnum.Pending;
+                }
+                else {
+                    entry.appliedChecksum = record.checksum;
+                    entry.appliedAt = record.appliedAt;
+                    entry.state = record.checksum === diskChecksum ? MigrationStateEnum.Applied : MigrationStateEnum.Modified;
+                }
+                plan.entries.push(entry);
+                seenNames.add(migration.name);
+            }
+            for (const record of records) {
+                if (seenNames.has(record.filename)) {
+                    continue;
+                }
+                const entry = new MigrationPlanEntry();
+                entry.name = record.filename;
+                entry.state = MigrationStateEnum.Orphaned;
+                entry.appliedChecksum = record.checksum;
+                entry.appliedAt = record.appliedAt;
+                plan.entries.push(entry);
+            }
+            plan.entries.sort((a, b) => a.name.localeCompare(b.name));
+            return plan;
+        });
+    }
+    assertNoDrift(plan, configUniqueKeyname) {
+        var _a, _b;
+        for (const entry of plan.entries) {
+            if (entry.state === MigrationStateEnum.Modified) {
+                throw new MigrationChecksumMismatchError(entry.name, configUniqueKeyname, (_a = entry.diskChecksum) !== null && _a !== void 0 ? _a : "", (_b = entry.appliedChecksum) !== null && _b !== void 0 ? _b : "");
+            }
+            if (entry.state === MigrationStateEnum.Orphaned) {
+                throw new MigrationOrphanedRecordError(entry.name, configUniqueKeyname);
+            }
+        }
+    }
+};
+MysqlMigrationManager.DefaultTableName = "pristine_migrations";
+MysqlMigrationManager.ValidNamePattern = /^\d+-[a-z0-9-]+$/;
+__decorate([
+    traced(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], MysqlMigrationManager.prototype, "status", null);
+__decorate([
+    traced(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String]),
+    __metadata("design:returntype", Promise)
+], MysqlMigrationManager.prototype, "verify", null);
+__decorate([
+    traced(),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [String, Object]),
+    __metadata("design:returntype", Promise)
+], MysqlMigrationManager.prototype, "apply", null);
+MysqlMigrationManager = MysqlMigrationManager_1 = __decorate([
+    injectable(),
+    __param(0, injectAll("MysqlMigrationInterface")),
+    __param(1, injectAll("MysqlConfigProviderInterface")),
+    __param(5, inject("LogHandlerInterface")),
+    __metadata("design:paramtypes", [Array, Array, MysqlMigrationRecordManager,
+        MysqlMigrationRunner,
+        MysqlMigrationChecksumManager, Object])
+], MysqlMigrationManager);
+export { MysqlMigrationManager };
+//# sourceMappingURL=mysql-migration.manager.js.map

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

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

package/dist/lib/esm/models/migration-apply-entry.model.js

@@ -0,0 +1,7 @@
+/**
+ * One row of a `MigrationApplyResult`: the outcome of applying a single migration.
+ * `error` is populated only when the migration failed.
+ */
+export class MigrationApplyEntry {
+}
+//# sourceMappingURL=migration-apply-entry.model.js.map

package/dist/lib/esm/models/migration-apply-entry.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-apply-entry.model.js","sourceRoot":"","sources":["../../../../src/models/migration-apply-entry.model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,mBAAmB;CAI/B"}

package/dist/lib/esm/models/migration-apply-result.model.js

@@ -0,0 +1,14 @@
+/**
+ * Output of `MysqlMigrationManager.apply`. `appliedMigrations` is the in-order list
+ * of migrations that ran successfully. `skippedAlreadyApplied` is the list of
+ * names that were already in the database (no-op). `failedMigration` is set when
+ * the run halted on a failure — subsequent pending migrations were not attempted.
+ */
+export class MigrationApplyResult {
+    constructor() {
+        this.dryRun = false;
+        this.appliedMigrations = [];
+        this.skippedAlreadyApplied = [];
+    }
+}
+//# sourceMappingURL=migration-apply-result.model.js.map

package/dist/lib/esm/models/migration-apply-result.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-apply-result.model.js","sourceRoot":"","sources":["../../../../src/models/migration-apply-result.model.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,oBAAoB;IAAjC;QAES,WAAM,GAAY,KAAK,CAAC;QACxB,sBAAiB,GAA0B,EAAE,CAAC;QAC9C,0BAAqB,GAAa,EAAE,CAAC;IAE9C,CAAC;CAAA"}

package/dist/lib/esm/models/migration-plan-entry.model.js

@@ -0,0 +1,7 @@
+/**
+ * One row of a `MigrationPlan`: the union view of a single migration as it appears
+ * to both the DI registry and the bookkeeping table. State combines the two views.
+ */
+export class MigrationPlanEntry {
+}
+//# sourceMappingURL=migration-plan-entry.model.js.map

package/dist/lib/esm/models/migration-plan-entry.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-plan-entry.model.js","sourceRoot":"","sources":["../../../../src/models/migration-plan-entry.model.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,OAAO,kBAAkB;CAY9B"}

package/dist/lib/esm/models/migration-plan.model.js

@@ -0,0 +1,20 @@
+import { MigrationStateEnum } from "../enums/migration-state.enum";
+/**
+ * Output of `MysqlMigrationManager.status` (and `verify` when no drift exists). The
+ * `entries` array is sorted lexicographically by `name`, matching apply order.
+ */
+export class MigrationPlan {
+    constructor() {
+        this.entries = [];
+    }
+    hasPending() {
+        return this.entries.some((entry) => entry.state === MigrationStateEnum.Pending);
+    }
+    hasDrift() {
+        return this.entries.some((entry) => entry.state === MigrationStateEnum.Modified || entry.state === MigrationStateEnum.Orphaned);
+    }
+    countByState(state) {
+        return this.entries.filter((entry) => entry.state === state).length;
+    }
+}
+//# sourceMappingURL=migration-plan.model.js.map

package/dist/lib/esm/models/migration-plan.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-plan.model.js","sourceRoot":"","sources":["../../../../src/models/migration-plan.model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAC;AAGjE;;;GAGG;AACH,MAAM,OAAO,aAAa;IAA1B;QAGS,YAAO,GAAyB,EAAE,CAAC;IAe5C,CAAC;IAbQ,UAAU;QACf,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAClF,CAAC;IAEM,QAAQ;QACb,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,kBAAkB,CAAC,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,kBAAkB,CAAC,QAAQ,CACtG,CAAC;IACJ,CAAC;IAEM,YAAY,CAAC,KAAyB;QAC3C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,MAAM,CAAC;IACtE,CAAC;CACF"}

package/dist/lib/esm/models/migration-record.model.js

@@ -0,0 +1,8 @@
+/**
+ * One row of the `pristine_migrations` bookkeeping table. Mirrors the schema exactly
+ * (snake_case in the database; the manager handles translation when reading rows
+ * back via `MysqlClient.executeSql`).
+ */
+export class MigrationRecord {
+}
+//# sourceMappingURL=migration-record.model.js.map

package/dist/lib/esm/models/migration-record.model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-record.model.js","sourceRoot":"","sources":["../../../../src/models/migration-record.model.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,eAAe;CAM3B"}

package/dist/lib/esm/models/models.js

@@ -0,0 +1,6 @@
+export * from "./migration-apply-entry.model";
+export * from "./migration-apply-result.model";
+export * from "./migration-plan-entry.model";
+export * from "./migration-plan.model";
+export * from "./migration-record.model";
+//# sourceMappingURL=models.js.map

package/dist/lib/esm/models/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../../../../src/models/models.ts"],"names":[],"mappings":"AAAA,cAAc,+BAA+B,CAAC;AAC9C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC"}

package/dist/lib/esm/mysql-cli.configuration-keys.js

@@ -0,0 +1,17 @@
+/**
+ * Typed configuration keys for `@pristine-ts/mysql-cli`. Use these constants with
+ * `@injectConfig` for autocomplete + rename safety, instead of typing the parameter
+ * name as a string.
+ *
+ * ```ts
+ * import {injectConfig} from "@pristine-ts/common";
+ * import {MysqlCliConfigurationKeys} from "@pristine-ts/mysql-cli";
+ *
+ * constructor(@injectConfig(MysqlCliConfigurationKeys.ScaffoldPath) path: string) {}
+ * ```
+ */
+export const MysqlCliConfigurationKeys = {
+    ScaffoldPath: "pristine.mysql-cli.scaffold.path",
+    ScaffoldBarrelPath: "pristine.mysql-cli.scaffold.barrelPath",
+};
+//# sourceMappingURL=mysql-cli.configuration-keys.js.map

package/dist/lib/esm/mysql-cli.configuration-keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-cli.configuration-keys.js","sourceRoot":"","sources":["../../../src/mysql-cli.configuration-keys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,YAAY,EAAE,kCAAkC;IAChD,kBAAkB,EAAE,wCAAwC;CACpD,CAAC"}

package/dist/lib/esm/mysql-cli.module.js

@@ -0,0 +1,46 @@
+import { CommonModule } from "@pristine-ts/common";
+import { CliModule } from "@pristine-ts/cli";
+import { CoreModule } from "@pristine-ts/core";
+import { FileModule } from "@pristine-ts/file";
+import { LoggingModule } from "@pristine-ts/logging";
+import { MysqlModule } from "@pristine-ts/mysql";
+import { MysqlCliModuleKeyname } from "./mysql-cli.module.keyname";
+export * from "./commands/commands";
+export * from "./enums/enums";
+export * from "./errors/errors";
+export * from "./interfaces/interfaces";
+export * from "./managers/managers";
+export * from "./models/models";
+export * from "./mysql-cli.configuration-keys";
+export * from "./mysql-cli.module.keyname";
+export const MysqlCliModule = {
+    keyname: MysqlCliModuleKeyname,
+    importModules: [
+        CommonModule,
+        CoreModule,
+        CliModule,
+        FileModule,
+        LoggingModule,
+        MysqlModule,
+    ],
+    configurationDefinitions: [
+        {
+            // The directory `mysql:create` writes new migration files into. Resolved against
+            // `process.cwd()` at command time. Override per-project in pristine.config.ts.
+            parameterName: MysqlCliModuleKeyname + ".scaffold.path",
+            isRequired: false,
+            defaultValue: "src/sql-migrations",
+        },
+        {
+            // When set to a non-empty path, `mysql:create` auto-edits the file at this
+            // path to splice in the new import and class reference between marker
+            // comments. Empty string (the default) means "not configured" — the command
+            // prints manual registration instructions instead. Single field = single
+            // signal — no separate enable flag.
+            parameterName: MysqlCliModuleKeyname + ".scaffold.barrelPath",
+            isRequired: false,
+            defaultValue: "",
+        },
+    ],
+};
+//# sourceMappingURL=mysql-cli.module.js.map

package/dist/lib/esm/mysql-cli.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-cli.module.js","sourceRoot":"","sources":["../../../src/mysql-cli.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAkB,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAC,SAAS,EAAC,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,UAAU,EAAC,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAC,aAAa,EAAC,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAC,WAAW,EAAC,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAC,qBAAqB,EAAC,MAAM,4BAA4B,CAAC;AAEjE,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,4BAA4B,CAAC;AAE3C,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,OAAO,EAAE,qBAAqB;IAC9B,aAAa,EAAE;QACb,YAAY;QACZ,UAAU;QACV,SAAS;QACT,UAAU;QACV,aAAa;QACb,WAAW;KACZ;IACD,wBAAwB,EAAE;QACxB;YACE,iFAAiF;YACjF,+EAA+E;YAC/E,aAAa,EAAE,qBAAqB,GAAG,gBAAgB;YACvD,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,oBAAoB;SACnC;QACD;YACE,2EAA2E;YAC3E,sEAAsE;YACtE,4EAA4E;YAC5E,yEAAyE;YACzE,oCAAoC;YACpC,aAAa,EAAE,qBAAqB,GAAG,sBAAsB;YAC7D,UAAU,EAAE,KAAK;YACjB,YAAY,EAAE,EAAE;SACjB;KACF;CACF,CAAC"}

package/dist/lib/esm/mysql-cli.module.keyname.js

@@ -0,0 +1,2 @@
+export const MysqlCliModuleKeyname = "pristine.mysql-cli";
+//# sourceMappingURL=mysql-cli.module.keyname.js.map

package/dist/lib/esm/mysql-cli.module.keyname.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mysql-cli.module.keyname.js","sourceRoot":"","sources":["../../../src/mysql-cli.module.keyname.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAW,oBAAoB,CAAC"}