@noego/proper 0.2.2 → 0.3.0

package/bin/index.d.mts

@@ -6,6 +6,11 @@ interface MigrationConfig {
     migration_table: string;
     migration_folder: string;
     database: string;
+    /**
+     * Exact canonical migration keys whose historical rounded stamps are
+     * explicitly allowed. Proper remains strict for every other migration.
+     */
+    legacy_migration_keys?: readonly string[];
     /**
      * Folder containing one-shot ledger patch files. Defaults to a `patches`
      * sibling of `migration_folder` (e.g. `migrations` -> `patches`,

package/bin/index.d.ts

@@ -6,6 +6,11 @@ interface MigrationConfig {
     migration_table: string;
     migration_folder: string;
     database: string;
+    /**
+     * Exact canonical migration keys whose historical rounded stamps are
+     * explicitly allowed. Proper remains strict for every other migration.
+     */
+    legacy_migration_keys?: readonly string[];
     /**
      * Folder containing one-shot ledger patch files. Defaults to a `patches`
      * sibling of `migration_folder` (e.g. `migrations` -> `patches`,

package/bin/index.js

@@ -90,9 +90,6 @@ module.exports = __toCommonJS(index_exports);
 // framework/MigrationRunner.ts
 var import_fs6 = __toESM(require("fs"));
 
-// framework/MigrationDirectoryReader.ts
-var import_fs2 = __toESM(require("fs"));
-
 // framework/errors.ts
 var MigrationError = class _MigrationError extends Error {
   constructor(message) {
@@ -295,6 +292,71 @@ var CLIError = class _CLIError extends MigrationError {
   }
 };
 
+// framework/MigrationManifest.ts
+var import_fs = __toESM(require("fs"));
+var import_path = __toESM(require("path"));
+var MIGRATION_FILE_REGEX = /(?:\.(mysql|sqlite|pg))?\.(up|down)\.(sql|js)$/i;
+function isMigrationFile(fileName) {
+  return MIGRATION_FILE_REGEX.test(fileName);
+}
+function canonicalMigrationKey(value) {
+  return value.replace(MIGRATION_FILE_REGEX, "").toLowerCase();
+}
+function mintMigrationStamp(now = Date.now()) {
+  return now % 10 === 0 ? now + 1 : now;
+}
+function isHandStampedKey(key) {
+  const stamp = key.split("_")[0];
+  return /^\d+$/.test(stamp) && /000$/.test(stamp);
+}
+function resolveMigrationFile(directory, baseName, direction, dialect) {
+  const dialectExt = dialect === "sql" ? "mysql" : dialect;
+  const dialectFile = import_path.default.join(directory, `${baseName}.${dialectExt}.${direction}.sql`);
+  if (import_fs.default.existsSync(dialectFile)) return dialectFile;
+  const genericFile = import_path.default.join(directory, `${baseName}.${direction}.sql`);
+  if (import_fs.default.existsSync(genericFile)) return genericFile;
+  return null;
+}
+function loadMigrationManifest(directory, dialect) {
+  const manifest = /* @__PURE__ */ new Map();
+  if (!import_fs.default.existsSync(directory)) return manifest;
+  const files = import_fs.default.readdirSync(directory, { withFileTypes: true }).filter((f) => f.isFile()).map((f) => f.name).filter(isMigrationFile);
+  const uniqueKeys = /* @__PURE__ */ new Set();
+  files.forEach((file) => uniqueKeys.add(canonicalMigrationKey(file)));
+  uniqueKeys.forEach((key) => {
+    manifest.set(key, {
+      key,
+      upFile: resolveMigrationFile(directory, key, "up", dialect),
+      downFile: resolveMigrationFile(directory, key, "down", dialect)
+    });
+  });
+  return manifest;
+}
+
+// framework/MigrationConfig.ts
+function validateLegacyMigrationKeys(value) {
+  if (value === void 0) {
+    return;
+  }
+  if (!Array.isArray(value) || value.some((key) => !isExactCanonicalMigrationKey(key))) {
+    throw new ConfigurationError(
+      "legacy_migration_keys must be an array of nonempty exact canonical migration keys; filenames, paths, wildcards, and nonstrings are not allowed"
+    );
+  }
+}
+function isExactCanonicalMigrationKey(value) {
+  if (typeof value !== "string" || value.length === 0 || value !== value.trim()) {
+    return false;
+  }
+  if (value.includes("/") || value.includes("\\") || ["*", "?", "[", "]", "{", "}"].some((token) => value.includes(token))) {
+    return false;
+  }
+  return !isMigrationFile(value) && canonicalMigrationKey(value) === value;
+}
+
+// framework/MigrationDirectoryReader.ts
+var import_fs2 = __toESM(require("fs"));
+
 // framework/MigrationNode.ts
 var MigrationNode = class {
   constructor(name) {
@@ -426,47 +488,6 @@ var SqlMigrationBuilder = class {
   }
 };
 
-// framework/MigrationManifest.ts
-var import_fs = __toESM(require("fs"));
-var import_path = __toESM(require("path"));
-var MIGRATION_FILE_REGEX = /(?:\.(mysql|sqlite|pg))?\.(up|down)\.(sql|js)$/i;
-function isMigrationFile(fileName) {
-  return MIGRATION_FILE_REGEX.test(fileName);
-}
-function canonicalMigrationKey(value) {
-  return value.replace(MIGRATION_FILE_REGEX, "").toLowerCase();
-}
-function mintMigrationStamp(now = Date.now()) {
-  return now % 10 === 0 ? now + 1 : now;
-}
-function isHandStampedKey(key) {
-  const stamp = key.split("_")[0];
-  return /^\d+$/.test(stamp) && /000$/.test(stamp);
-}
-function resolveMigrationFile(directory, baseName, direction, dialect) {
-  const dialectExt = dialect === "sql" ? "mysql" : dialect;
-  const dialectFile = import_path.default.join(directory, `${baseName}.${dialectExt}.${direction}.sql`);
-  if (import_fs.default.existsSync(dialectFile)) return dialectFile;
-  const genericFile = import_path.default.join(directory, `${baseName}.${direction}.sql`);
-  if (import_fs.default.existsSync(genericFile)) return genericFile;
-  return null;
-}
-function loadMigrationManifest(directory, dialect) {
-  const manifest = /* @__PURE__ */ new Map();
-  if (!import_fs.default.existsSync(directory)) return manifest;
-  const files = import_fs.default.readdirSync(directory, { withFileTypes: true }).filter((f) => f.isFile()).map((f) => f.name).filter(isMigrationFile);
-  const uniqueKeys = /* @__PURE__ */ new Set();
-  files.forEach((file) => uniqueKeys.add(canonicalMigrationKey(file)));
-  uniqueKeys.forEach((key) => {
-    manifest.set(key, {
-      key,
-      upFile: resolveMigrationFile(directory, key, "up", dialect),
-      downFile: resolveMigrationFile(directory, key, "down", dialect)
-    });
-  });
-  return manifest;
-}
-
 // framework/MigrationDirectoryReader.ts
 var MigrationDirectoryReader = class {
   constructor(directory, read_strategy, sqlrunner, dialect = "sql") {
@@ -1851,6 +1872,7 @@ var MySQLMigrationRunner = class {
      */
     this.preflightPromise = null;
     this.lastPatchResults = [];
+    validateLegacyMigrationKeys(config.legacy_migration_keys);
   }
   setup() {
     return __async(this, null, function* () {
@@ -1956,11 +1978,13 @@ var MySQLMigrationRunner = class {
   }
   migrate(migrationNodes, forward) {
     return __async(this, null, function* () {
+      var _a;
       yield this.setup();
       if (forward) {
+        const legacyMigrationKeys = new Set((_a = this.config.legacy_migration_keys) != null ? _a : []);
         for (const node of migrationNodes) {
           const key = node.get_key();
-          if (isHandStampedKey(key) && !(yield node.status()).completed) {
+          if (isHandStampedKey(key) && !legacyMigrationKeys.has(key) && !(yield node.status()).completed) {
             throw new MigrationStampError(key);
           }
         }
@@ -2060,6 +2084,7 @@ var FileMigrationConfigReader = class {
     try {
       const fileContent = import_fs6.default.readFileSync(this.configFile);
       const config = JSON.parse(fileContent.toString());
+      validateLegacyMigrationKeys(config.legacy_migration_keys);
       if (!config.migration_folder) {
         throw ConfigurationError.missingRequiredProperty("migration_folder");
       }