@alpha.consultings/eloquent-orm.js 1.0.8 → 1.0.10

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [1.0.10](https://github.com/MetalDz/Eloquent-ORM.js/compare/v1.0.9...v1.0.10) (2026-03-29)
+
+
+### Bug Fixes
+
+* make latest release summary mdx-safe for docs lint ([a4149bd](https://github.com/MetalDz/Eloquent-ORM.js/commit/a4149bd672972ed952c2e1d7d4092214d64ca058))
+* support nodenext local ts imports in cli ts runtime ([27d383e](https://github.com/MetalDz/Eloquent-ORM.js/commit/27d383e547034d5ab1978872af167e15abe36376))
+
+## [1.0.9](https://github.com/MetalDz/Eloquent-ORM.js/compare/v1.0.8...v1.0.9) (2026-03-28)
+
+
+### Bug Fixes
+
+* add esm-safe package entry and document nodenext imports ([ccf1105](https://github.com/MetalDz/Eloquent-ORM.js/commit/ccf11057385d0ad00530ad41ba34b41f575fae02))
+* patch dist cjs factory export after build ([2499e1a](https://github.com/MetalDz/Eloquent-ORM.js/commit/2499e1a08bc47835d59668a02e3cf6baa6b284d2))
+
 ## [1.0.8](https://github.com/MetalDz/Eloquent-ORM.js/compare/v1.0.7...v1.0.8) (2026-03-28)
 
 

package/PACKAGE-UPDATE-SUMMARY.md

@@ -1,6 +1,6 @@
 # Package Update Summary
 
-Version: `1.0.8`
+Version: `1.0.10`
 
 This file is the source of truth for the release-focused quick info block that appears in `README.md`.
 
@@ -14,16 +14,22 @@ npm run docs:sync-package-metadata
 
 <!-- release-lineup:start -->
 Latest Release:
-- `v1.0.8 latest`
+- `v1.0.10 latest`
 
 Old Release:
-- `v1.0.7`
+- `v1.0.9`
 <!-- release-lineup:end -->
 
+## Latest Release Headline
+
+<!-- latest-package-headline:start -->
+- Patched. Added an ESM-safe package entry for NodeNext consumers and stabilized CommonJS `Factory` export behavior.
+<!-- latest-package-headline:end -->
+
 ## Latest Release Summary
 
 <!-- latest-package-update:start -->
-- Document release behavior for `docs:` commits so semantic-release publishes documentation updates as patch releases.
+- Add an ESM-safe package entry for NodeNext consumers, keep CommonJS root imports from eagerly loading `Factory`, and verify installed-package ESM imports in pack-smoke.
 <!-- latest-package-update:end -->
 
 ## Synced Quick Info
@@ -31,11 +37,11 @@ Old Release:
 <!-- package-quick-info:start -->
 Quick info:
 - Package: `@alpha.consultings/eloquent-orm.js`
-- Version: `v1.0.8`
-- Latest release: `v1.0.8 latest`
-- What's new: Fix release
-- Old release: `v1.0.7`
-- Latest update: Document release behavior for `docs:` commits so semantic-release publishes documentation updates as patch releases.
+- Version: `v1.0.10`
+- Latest release: `v1.0.10 latest`
+- What's new: [Patched. Added an ESM-safe package entry for NodeNext consumers and stabilized CommonJS `Factory` export behavior.](https://alphaconsultings.mintlify.app/release/latest-release-summary)
+- Old release: `v1.0.9`
+- Latest update: Add an ESM-safe package entry for NodeNext consumers, keep CommonJS root imports from eagerly loading `Factory`, and verify installed-package ESM imports in pack-smoke.
 - Official docs: https://alphaconsultings.mintlify.app
 - Quick start: https://alphaconsultings.mintlify.app/getting-started/quick-start
 - Release history: https://alphaconsultings.mintlify.app/release/history
@@ -44,6 +50,7 @@ Quick info:
 
 ## Update Rule
 
+- Refresh the `latest-package-headline` summary on every fix, minor, or major release.
 - Refresh the `latest-package-update` summary on every fix, minor, or major release.
-- Keep the quick info short and focused on the most useful runtime or package changes.
-- Let the sync script refresh package name, version, docs URL, and README output.
+- Keep the headline short and linkable, and keep the detailed update exact and release-specific.
+- Let the sync script refresh package name, version, docs URL, README output, and the latest release summary docs page.

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.0.8`
-- Latest release: `v1.0.8 latest`
-- What's new: Fix release
-- Old release: `v1.0.7`
-- Latest update: Document release behavior for `docs:` commits so semantic-release publishes documentation updates as patch releases.
+- Version: `v1.0.10`
+- Latest release: `v1.0.10 latest`
+- What's new: [Patched. Added an ESM-safe package entry for NodeNext consumers and stabilized CommonJS `Factory` export behavior.](https://alphaconsultings.mintlify.app/release/latest-release-summary)
+- Old release: `v1.0.9`
+- Latest update: Add an ESM-safe package entry for NodeNext consumers, keep CommonJS root imports from eagerly loading `Factory`, and verify installed-package ESM imports in pack-smoke.
 - 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

@@ -186,6 +186,7 @@ async function makeMigration(modelName, options = {}) {
     }
     const loadedModels = [];
     const pendingPivotMigrations = new Map();
+    const failedFiles = new Set();
     const timestampSeed = new Date()
         .toISOString()
         .replace(/[-:.TZ]/g, "")
@@ -227,6 +228,7 @@ async function makeMigration(modelName, options = {}) {
             });
         }
         catch (err) {
+            failedFiles.add(file);
             console.error(chalk_1.default.red(`ERROR: Error processing ${file}:`));
             console.error(err instanceof Error ? err.message : err);
         }
@@ -454,6 +456,7 @@ export async function down(db: { query(sql: string): Promise<void> }) {
             }
         }
         catch (err) {
+            failedFiles.add(file);
             console.error(chalk_1.default.red(`ERROR: Error processing ${file}:`));
             console.error(err instanceof Error ? err.message : err);
         }
@@ -488,6 +491,16 @@ export async function down(db: { query(sql: string): Promise<void> }) {
     catch {
         console.warn(chalk_1.default.yellow("WARN: Could not close DB connections cleanly."));
     }
+    if (failedFiles.size > 0) {
+        const failureSummary = `ERROR: Migration generation failed for ${failedFiles.size} model` +
+            `${failedFiles.size === 1 ? "" : "s"}: ${[...failedFiles].join(", ")}`;
+        console.error(chalk_1.default.red(failureSummary));
+        if (options.exit !== false) {
+            process.exit(1);
+            return;
+        }
+        throw new Error(failureSummary);
+    }
     console.log(chalk_1.default.cyanBright(`OK: Migration generation complete in ${isTest ? "TEST" : "DEVELOPMENT"} mode.\n`));
     if (options.exit !== false) {
         process.exit(0);

package/dist/cli/utils/typescript/tsRuntime.js

@@ -23,13 +23,42 @@ const PACKAGE_NAME = (() => {
     }
 })();
 function resolveExistingModulePath(basePath) {
-    const candidates = [
-        basePath,
-        `${basePath}.ts`,
-        `${basePath}.js`,
-        path_1.default.join(basePath, "index.ts"),
-        path_1.default.join(basePath, "index.js"),
-    ];
+    const extension = path_1.default.extname(basePath).toLowerCase();
+    const withoutExtension = extension.length > 0 ? basePath.slice(0, -extension.length) : basePath;
+    const candidates = [];
+    const seen = new Set();
+    const addCandidate = (candidate) => {
+        if (seen.has(candidate)) {
+            return;
+        }
+        seen.add(candidate);
+        candidates.push(candidate);
+    };
+    if (extension === ".js" || extension === ".mjs" || extension === ".cjs") {
+        // NodeNext TypeScript source commonly imports local modules using `.js`
+        // specifiers even though the source file on disk is `.ts`.
+        addCandidate(`${withoutExtension}.ts`);
+        addCandidate(`${withoutExtension}.tsx`);
+        addCandidate(`${withoutExtension}.mts`);
+        addCandidate(`${withoutExtension}.cts`);
+    }
+    addCandidate(basePath);
+    if (!extension) {
+        addCandidate(`${basePath}.ts`);
+        addCandidate(`${basePath}.tsx`);
+        addCandidate(`${basePath}.mts`);
+        addCandidate(`${basePath}.cts`);
+        addCandidate(`${basePath}.js`);
+        addCandidate(`${basePath}.mjs`);
+        addCandidate(`${basePath}.cjs`);
+        addCandidate(path_1.default.join(basePath, "index.ts"));
+        addCandidate(path_1.default.join(basePath, "index.tsx"));
+        addCandidate(path_1.default.join(basePath, "index.mts"));
+        addCandidate(path_1.default.join(basePath, "index.cts"));
+        addCandidate(path_1.default.join(basePath, "index.js"));
+        addCandidate(path_1.default.join(basePath, "index.mjs"));
+        addCandidate(path_1.default.join(basePath, "index.cjs"));
+    }
     return candidates.find((candidate) => fs_1.default.existsSync(candidate)) ?? null;
 }
 function resolveLocalRequest(request, fromFilePath) {

package/dist/index.js

@@ -14,8 +14,7 @@ Object.defineProperty(exports, "MongoModel", { enumerable: true, get: function (
 Object.defineProperty(exports, "MorphRegistry", { enumerable: true, get: function () { return BaseModel_1.MorphRegistry; } });
 var PivotHelperMixin_1 = require("./core/orm/mixins/PivotHelperMixin");
 Object.defineProperty(exports, "PivotHelperMixin", { enumerable: true, get: function () { return PivotHelperMixin_1.PivotHelperMixin; } });
-var Factory_1 = require("./cli/utils/factories/Factory");
-Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return Factory_1.Factory; } });
+Object.defineProperty(exports, "Factory", { enumerable: true, get: function () { return require("./cli/utils/factories/Factory").Factory; } });
 var CoreModel_1 = require("./core/model/CoreModel");
 Object.defineProperty(exports, "CoreModel", { enumerable: true, get: function () { return CoreModel_1.CoreModel; } });
 var SchemaBlueprint_1 = require("./core/schema/SchemaBlueprint");

package/esm/Factory.mjs

@@ -0,0 +1,143 @@
+import { faker } from "@faker-js/faker";
+
+export class Factory {
+  faker = faker;
+
+  async create(attrs = {}, index = 0) {
+    const base = this.definition(index);
+    const merged = { ...base, ...attrs };
+
+    if (this.beforeCreate) {
+      const modified = await this.beforeCreate(merged, index);
+      if (modified && typeof modified === "object") {
+        Object.assign(merged, modified);
+      }
+    }
+
+    let instance = new this.model();
+
+    if (this.#hasInstanceCreate(instance)) {
+      const created = await instance.create(merged);
+      if (created) {
+        instance = created;
+      }
+    } else if (this.#hasStaticCreate(this.model)) {
+      return this.model.create(merged);
+    } else if (this.#hasInstanceSave(instance)) {
+      Object.assign(instance, merged);
+      await instance.save();
+    } else {
+      throw new Error(`Model '${this.model.name}' has no valid create/save method.`);
+    }
+
+    if (this.afterCreate) {
+      await this.afterCreate(instance);
+    }
+
+    return instance;
+  }
+
+  async createMany(count, callback, concurrency = 1) {
+    const results = [];
+
+    const executeCreate = async (index) => {
+      const model = await this.create({}, index);
+      if (callback) {
+        await callback(model, index);
+      }
+      results[index] = model;
+    };
+
+    if (concurrency <= 1) {
+      for (let index = 0; index < count; index += 1) {
+        await executeCreate(index);
+      }
+      return results;
+    }
+
+    let active = 0;
+    let index = 0;
+    let settled = false;
+
+    return new Promise((resolve, reject) => {
+      const maybeResolve = () => {
+        if (!settled && index >= count && active === 0) {
+          settled = true;
+          resolve(results);
+        }
+      };
+
+      const next = () => {
+        if (settled) {
+          return;
+        }
+
+        while (active < concurrency && index < count && !settled) {
+          const currentIndex = index++;
+          active += 1;
+
+          void executeCreate(currentIndex)
+            .catch((error) => {
+              if (settled) {
+                return;
+              }
+              settled = true;
+              reject(error);
+            })
+            .finally(() => {
+              active -= 1;
+              if (settled) {
+                return;
+              }
+              next();
+            });
+        }
+
+        maybeResolve();
+      };
+
+      next();
+    });
+  }
+
+  async related(factoryOrCtor, count = 1) {
+    const factory =
+      typeof factoryOrCtor === "function"
+        ? new factoryOrCtor()
+        : factoryOrCtor;
+
+    if (count === 1) {
+      return factory.create();
+    }
+
+    return factory.createMany(count);
+  }
+
+  async relatedPivot(
+    factory,
+    pivotTable,
+    foreignKey,
+    relatedKey,
+    foreignId,
+    relatedIds,
+    extraPivotAttrs
+  ) {
+    await factory.createPivot(foreignId, relatedIds, extraPivotAttrs);
+
+    console.log(
+      `[Pivot Attached] Table "${pivotTable}" (${foreignKey} -> ${relatedKey})`
+    );
+  }
+
+  #hasInstanceCreate(obj) {
+    return typeof obj?.create === "function";
+  }
+
+  #hasStaticCreate(ctor) {
+    return typeof ctor?.create === "function";
+  }
+
+  #hasInstanceSave(obj) {
+    return typeof obj?.save === "function";
+  }
+}

package/esm/index.mjs

@@ -0,0 +1,32 @@
+import cjsPackage from "../dist/index.js";
+import { Factory } from "./Factory.mjs";
+
+export { Factory };
+
+export const {
+  BaseModel,
+  Model,
+  SqlModel,
+  MongoModel,
+  MorphRegistry,
+  PivotHelperMixin,
+  CoreModel,
+  column,
+  validate,
+  relation,
+  mixin,
+  validateSchema,
+  SchemaValidator,
+  SchemaBuilder,
+  CacheManager,
+  setupCache,
+  registerModels,
+  isModelRegistered,
+  setModelRegistryStrictMode,
+  isModelRegistryStrictMode,
+} = cjsPackage;
+
+export default {
+  ...cjsPackage,
+  Factory,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alpha.consultings/eloquent-orm.js",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "A Laravel Eloquent-inspired ORM Multi Driver SQL & NoSQL and Cache System and Artisan CLI like for Node.js Lovers",
   "keywords": [
     "orm",
@@ -46,8 +46,15 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "import": "./esm/index.mjs",
       "require": "./dist/index.js",
-      "default": "./dist/index.js"
+      "default": "./esm/index.mjs"
+    },
+    "./Factory": {
+      "types": "./dist/cli/utils/factories/Factory.d.ts",
+      "import": "./esm/Factory.mjs",
+      "require": "./dist/cli/utils/factories/Factory.js",
+      "default": "./esm/Factory.mjs"
     },
     "./Model": {
       "types": "./dist/Model.d.ts",
@@ -61,6 +68,7 @@
   },
   "files": [
     "dist",
+    "esm/**/*",
     "src/cli/templates/**/*",
     "README.md",
     "CHANGELOG.md",
@@ -71,7 +79,7 @@
     "docs:sync-supported": "node scripts/sync-supported-versions.cjs",
     "docs:sync-config": "node scripts/sync-mintlify-configs.cjs",
     "clean": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
-    "build": "npm run docs:sync-package-metadata && npm run docs:sync-supported && npm run clean && tsc -p tsconfig.build.json",
+    "build": "npm run docs:sync-package-metadata && npm run docs:sync-supported && npm run clean && tsc -p tsconfig.build.json && node scripts/patch-dist-cjs-factory-entry.cjs",
     "typecheck": "tsc -p . --noEmit --skipLibCheck",
     "docs:dev": "npm run docs:sync-package-metadata && npm run docs:sync-config && node scripts/run-mintlify.cjs dev",
     "docs:build": "npm run docs:sync-package-metadata && npm run docs:sync-supported && npm run docs:sync-config && node scripts/run-mintlify.cjs validate",