@alpha.consultings/eloquent-orm.js 1.1.0 → 1.1.1

package/CHANGELOG.md

@@ -1,3 +1,11 @@
+## [1.1.1](https://github.com/MetalDz/Eloquent-ORM.js/compare/v1.1.0...v1.1.1) (2026-04-05)
+
+
+### Bug Fixes
+
+* use descriptive helper migration names for pivots and indexes ([13baedc](https://github.com/MetalDz/Eloquent-ORM.js/commit/13baedc78296de7c22e8f2ab1834411a738957d7))
+* use descriptive helper migration names for pivots and indexes ([7faeb4c](https://github.com/MetalDz/Eloquent-ORM.js/commit/7faeb4cf736c5c4f50429204c70713bb167cd5a9))
+
 # [1.1.0](https://github.com/MetalDz/Eloquent-ORM.js/compare/v1.0.11...v1.1.0) (2026-04-04)
 
 

package/PACKAGE-UPDATE-SUMMARY.md

@@ -1,6 +1,6 @@
 # Package Update Summary
 
-Version: `1.1.0`
+Version: `1.1.1`
 
 This file is the source of truth for the release-focused quick info block that appears in `README.md`.
 
@@ -14,22 +14,22 @@ npm run docs:sync-package-metadata
 
 <!-- release-lineup:start -->
 Latest Release:
-- `v1.0.11 latest`
+- `v1.1.1 latest`
 
 Old Release:
-- `v1.0.10`
+- `v1.0.11`
 <!-- release-lineup:end -->
 
 ## Latest Release Headline
 
 <!-- latest-package-headline:start -->
-- Minor release. The ORM now supports model-declared relational DDL metadata and safe PostgreSQL smart-update diffs that preserve unmanaged foreign keys.
+- Fix release. Migration helpers now use descriptive pivot and table-scoped index filenames instead of a generic `create_pivot_table` fallback.
 <!-- latest-package-headline:end -->
 
 ## Latest Release Summary
 
 <!-- latest-package-update:start -->
-- Add first-class model `database` metadata for foreign keys and indexes, emit relational DDL from the model source of truth, preserve unmanaged PostgreSQL foreign keys during smart-update diffs, keep the source-tree TypeScript contract on NodeNext while `dist/*` stays CommonJS, and restore `100%` statement, branch, function, and line coverage.
+- Keep the relational DDL and safe-diff model contract from `1.1.0`, fix migration helper generation so real `belongsToMany` pivots emit descriptive `create_<pivotTable>_table` files, group relational index helpers into table-scoped `add_<table>_indexes` migrations instead of a generic `create_pivot_table` fallback, and preserve the clean NodeNext source-tree, CommonJS `dist/*` build, and `100%` coverage baseline.
 <!-- latest-package-update:end -->
 
 ## Synced Quick Info
@@ -37,11 +37,11 @@ Old Release:
 <!-- package-quick-info:start -->
 Quick info:
 - Package: `@alpha.consultings/eloquent-orm.js`
-- Version: `v1.1.0`
-- Latest release: `v1.0.11 latest`
-- What's new: [Minor release. The ORM now supports model-declared relational DDL metadata and safe PostgreSQL smart-update diffs that preserve unmanaged foreign keys.](https://alphaconsultings.mintlify.app/release/latest-release-summary)
-- Old release: `v1.0.10`
-- Latest update: Add first-class model `database` metadata for foreign keys and indexes, emit relational DDL from the model source of truth, preserve unmanaged PostgreSQL foreign keys during smart-update diffs, keep the source-tree TypeScript contract on NodeNext while `dist/*` stays CommonJS, and restore `100%` statement, branch, function, and line coverage.
+- Version: `v1.1.1`
+- Latest release: `v1.1.1 latest`
+- What's new: [Fix release. Migration helpers now use descriptive pivot and table-scoped index filenames instead of a generic `create_pivot_table` fallback.](https://alphaconsultings.mintlify.app/release/latest-release-summary)
+- Old release: `v1.0.11`
+- Latest update: Keep the relational DDL and safe-diff model contract from `1.1.0`, fix migration helper generation so real `belongsToMany` pivots emit descriptive `create_<pivotTable>_table` files, group relational index helpers into table-scoped `add_<table>_indexes` migrations instead of a generic `create_pivot_table` fallback, and preserve the clean NodeNext source-tree, CommonJS `dist/*` build, and `100%` coverage baseline.
 - Official docs: https://alphaconsultings.mintlify.app
 - Quick start: https://alphaconsultings.mintlify.app/getting-started/quick-start
 - Release history: https://alphaconsultings.mintlify.app/release/history

package/README.md

@@ -17,11 +17,11 @@ Laravel-inspired ORM + CLI for Node.js + TypeScript with SQL and MongoDB runtime
 <!-- package-quick-info:start -->
 Quick info:
 - Package: `@alpha.consultings/eloquent-orm.js`
-- Version: `v1.1.0`
-- Latest release: `v1.0.11 latest`
-- What's new: [Minor release. The ORM now supports model-declared relational DDL metadata and safe PostgreSQL smart-update diffs that preserve unmanaged foreign keys.](https://alphaconsultings.mintlify.app/release/latest-release-summary)
-- Old release: `v1.0.10`
-- Latest update: Add first-class model `database` metadata for foreign keys and indexes, emit relational DDL from the model source of truth, preserve unmanaged PostgreSQL foreign keys during smart-update diffs, keep the source-tree TypeScript contract on NodeNext while `dist/*` stays CommonJS, and restore `100%` statement, branch, function, and line coverage.
+- Version: `v1.1.1`
+- Latest release: `v1.1.1 latest`
+- What's new: [Fix release. Migration helpers now use descriptive pivot and table-scoped index filenames instead of a generic `create_pivot_table` fallback.](https://alphaconsultings.mintlify.app/release/latest-release-summary)
+- Old release: `v1.0.11`
+- Latest update: Keep the relational DDL and safe-diff model contract from `1.1.0`, fix migration helper generation so real `belongsToMany` pivots emit descriptive `create_<pivotTable>_table` files, group relational index helpers into table-scoped `add_<table>_indexes` migrations instead of a generic `create_pivot_table` fallback, and preserve the clean NodeNext source-tree, CommonJS `dist/*` build, and `100%` coverage baseline.
 - Official docs: https://alphaconsultings.mintlify.app
 - Quick start: https://alphaconsultings.mintlify.app/getting-started/quick-start
 - Release history: https://alphaconsultings.mintlify.app/release/history

package/dist/cli/commands/makeMigration.js

@@ -51,6 +51,38 @@ function hasSameGeneratedBody(filePath, nextContent) {
 function pascalCase(name) {
     return name.charAt(0).toUpperCase() + name.slice(1);
 }
+function classifyExtraMigrationSql(sql) {
+    const createTableMatch = sql.match(/CREATE TABLE(?: IF NOT EXISTS)?\s+[`"]?([A-Za-z0-9_]+)/i);
+    if (createTableMatch) {
+        const tableName = createTableMatch[1];
+        return {
+            targetName: tableName,
+            fileSuffix: `create_${tableName}_table`,
+            headerLabel: tableName,
+            logLabel: "Pivot migration",
+            fallbackRollbackSql: `DROP TABLE IF EXISTS ${tableName};`,
+        };
+    }
+    const createIndexMatch = sql.match(/CREATE(?: UNIQUE)? INDEX(?: IF NOT EXISTS)?\s+[`"]?([A-Za-z0-9_]+)[`"]?\s+ON\s+[`"]?([A-Za-z0-9_]+)/i);
+    if (createIndexMatch) {
+        const indexName = createIndexMatch[1];
+        const tableName = createIndexMatch[2];
+        return {
+            targetName: tableName,
+            fileSuffix: `add_${tableName}_indexes`,
+            headerLabel: `${tableName} indexes`,
+            logLabel: "Helper migration",
+            fallbackRollbackSql: `DROP INDEX IF EXISTS ${indexName};`,
+        };
+    }
+    return {
+        targetName: "schema_extras",
+        fileSuffix: "add_schema_extras",
+        headerLabel: "schema extras",
+        logLabel: "Helper migration",
+        fallbackRollbackSql: "-- rollback SQL unavailable for schema extras",
+    };
+}
 function getBelongsToDependencies(schema, knownModels) {
     const deps = new Set();
     for (const value of Object.values(schema)) {
@@ -349,7 +381,8 @@ export async function down(db: { dropCollection(name: string): Promise<void> })
                         pendingPivotMigrations.set(`${connectionName}:${pivot.collectionName}`, {
                             connectionName,
                             migrationsDir,
-                            pivotTable: pivot.collectionName,
+                            fileSuffix: `create_${pivot.collectionName}_table`,
+                            logLabel: "Pivot migration",
                             content: pivotContent,
                         });
                     }
@@ -429,29 +462,24 @@ export async function down(db: { query(sql: string): Promise<void> }) {
             }
             if (pivotSeparate && extraTables.length > 0) {
                 for (const [pivotIndex, originalSql] of extraTables.entries()) {
-                    const match = originalSql.match(/CREATE TABLE(?: IF NOT EXISTS)?\s+[`"]?([A-Za-z0-9_]+)/i);
-                    const pivotTable = match?.[1] ?? "pivot";
-                    const safePivotSql = originalSql.replace(/`/g, "\\`");
-                    const safeRollbackPivotSql = (rollbackExtraTables[pivotIndex] ?? `DROP TABLE IF EXISTS ${pivotTable};`).replace(/`/g, "\\`");
-                    const pivotHeader = `/**
- * Auto-generated CREATE migration for ${pivotTable}
- * Connection: ${connectionName}
- * Mode: ${isTest ? "TEST" : "DEVELOPMENT"}
- * Generated at ${new Date().toISOString()}
- */`;
-                    const pivotContent = `${pivotHeader}
-export async function up(db: { query(sql: string): Promise<void> }) {
-  await db.query(\`${safePivotSql}\`);
-}
-
-export async function down(db: { query(sql: string): Promise<void> }) {
-  await db.query(\`${safeRollbackPivotSql}\`);
-}`;
-                    pendingPivotMigrations.set(`${connectionName}:${pivotTable}`, {
+                    const descriptor = classifyExtraMigrationSql(originalSql);
+                    const rollbackSql = rollbackExtraTables[pivotIndex] ?? descriptor.fallbackRollbackSql;
+                    const pendingKey = `${connectionName}:${descriptor.fileSuffix}`;
+                    const existingPending = pendingPivotMigrations.get(pendingKey);
+                    if (existingPending) {
+                        existingPending.upSql.push(originalSql);
+                        existingPending.downSql.unshift(rollbackSql);
+                        continue;
+                    }
+                    pendingPivotMigrations.set(pendingKey, {
                         connectionName,
                         migrationsDir,
-                        pivotTable,
-                        content: pivotContent,
+                        targetName: descriptor.targetName,
+                        fileSuffix: descriptor.fileSuffix,
+                        headerLabel: descriptor.headerLabel,
+                        logLabel: descriptor.logLabel,
+                        upSql: [originalSql],
+                        downSql: [rollbackSql],
                     });
                 }
             }
@@ -463,27 +491,47 @@ export async function down(db: { query(sql: string): Promise<void> }) {
         }
     }
     for (const pendingPivot of pendingPivotMigrations.values()) {
+        const content = pendingPivot.content ??
+            (() => {
+                const escapeForTemplateLiteral = (sql) => sql.replace(/\\/g, "\\\\").replace(/`/g, "\\`").replace(/\$\{/g, "\\${");
+                const header = `/**
+ * Auto-generated ${pendingPivot.logLabel === "Pivot migration" ? "CREATE migration" : "INDEX helper migration"} for ${pendingPivot.headerLabel}
+ * Connection: ${pendingPivot.connectionName}
+ * Mode: ${isTest ? "TEST" : "DEVELOPMENT"}
+ * Generated at ${new Date().toISOString()}
+ */`;
+                return `${header}
+export async function up(db: { query(sql: string): Promise<void> }) {
+  ${pendingPivot.upSql
+                    .map((sql) => `await db.query(\`${escapeForTemplateLiteral(sql)}\`);`)
+                    .join("\n  ")}
+}
+
+export async function down(db: { query(sql: string): Promise<void> }) {
+  ${pendingPivot.downSql
+                    .map((sql) => `await db.query(\`${escapeForTemplateLiteral(sql)}\`);`)
+                    .join("\n  ")}
+}`;
+            })();
         const allFiles = fs_1.default
             .readdirSync(pendingPivot.migrationsDir)
             .filter((f) => f.endsWith(".ts") || f.endsWith(".js"));
-        const existingPivotFiles = allFiles
-            .filter((f) => /_create_[A-Za-z0-9_]+_table\.ts$/.test(f))
-            .filter((f) => f.includes(`_create_${pendingPivot.pivotTable}_table.ts`));
-        if (pendingPivot.pivotTable !== "pivot") {
+        const existingPivotFiles = allFiles.filter((f) => f.includes(`_${pendingPivot.fileSuffix}.ts`));
+        if (pendingPivot.logLabel !== "Pivot migration") {
             const genericPivotFiles = allFiles.filter((f) => f.includes("_create_pivot_table.ts"));
             existingPivotFiles.push(...genericPivotFiles);
         }
         const uniquePivotFiles = [...new Set(existingPivotFiles)];
-        const unchangedPivot = uniquePivotFiles.find((fileName) => hasSameGeneratedBody(path_1.default.join(pendingPivot.migrationsDir, fileName), pendingPivot.content));
+        const unchangedPivot = uniquePivotFiles.find((fileName) => hasSameGeneratedBody(path_1.default.join(pendingPivot.migrationsDir, fileName), content));
         if (unchangedPivot) {
-            console.log(chalk_1.default.gray(`INFO: Pivot migration unchanged: ${unchangedPivot}`));
+            console.log(chalk_1.default.gray(`INFO: ${pendingPivot.logLabel} unchanged: ${unchangedPivot}`));
             continue;
         }
         const pivotTimestamp = nextTimestamp();
-        const pivotFile = `${pivotTimestamp}_create_${pendingPivot.pivotTable}_table.ts`;
+        const pivotFile = `${pivotTimestamp}_${pendingPivot.fileSuffix}.ts`;
         const pivotPath = path_1.default.join(pendingPivot.migrationsDir, pivotFile);
-        fs_1.default.writeFileSync(pivotPath, pendingPivot.content, "utf8");
-        console.log(chalk_1.default.green(`OK: Pivot migration saved: ${pivotPath}`));
+        fs_1.default.writeFileSync(pivotPath, content, "utf8");
+        console.log(chalk_1.default.green(`OK: ${pendingPivot.logLabel} saved: ${pivotPath}`));
     }
     try {
         await (0, ConnectionFactory_js_1.closeAllConnections)();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpha.consultings/eloquent-orm.js",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A Laravel Eloquent-inspired ORM Multi Driver SQL & NoSQL and Cache System and Artisan CLI like for Node.js Lovers",
   "keywords": [
     "orm",