@alpha.consultings/eloquent-orm.js 1.0.1

package/CHANGELOG.md

@@ -0,0 +1,73 @@
+## [1.0.1](https://github.com/MetalDz/Eloquent-ORM.js/compare/v1.0.0...v1.0.1) (2026-03-23)
+
+
+### Bug Fixes
+
+* align scoped package publish surface ([9b37348](https://github.com/MetalDz/Eloquent-ORM.js/commit/9b373489534325358d7c47b19cbe283687a51f48))
+
+# 1.0.0 (2026-03-23)
+
+
+### Bug Fixes
+
+* minor ([500edb3](https://github.com/MetalDz/Eloquent-ORM.js/commit/500edb3d834cbef454423eadc01c408efbc0daa1))
+* minor ([bba6fd9](https://github.com/MetalDz/Eloquent-ORM.js/commit/bba6fd93a5a2c5166aba9abac3751586a68ef63d))
+
+
+### Features
+
+* **cli,api:** add model registry generator and clean up model exports ([d51da62](https://github.com/MetalDz/Eloquent-ORM.js/commit/d51da629b1d31a2930c048a15526f7187360bc31))
+
+# Changelog
+
+## Unreleased
+
+### Factory createMany concurrency hardening
+
+- `Factory.createMany(count, callback, concurrency > 1)` now rejects on the first worker or callback failure.
+- Concurrent `createMany` no longer resolves with sparse/partial success arrays when one task fails.
+
+### Consumer migration note
+
+- If your code relied on partial success in concurrent mode, switch to an explicit best-effort flow:
+  - run per-item creation with `Promise.allSettled(...)`, or
+  - run sequentially and handle per-item errors manually.
+
+### makeModel update rollback safety
+
+- `make:model --with-migration` now writes non-destructive `down()` SQL for generated `update_*` migrations.
+- Update migrations now use `SchemaBuilder` inverse rollback SQL instead of unconditional `DROP TABLE`.
+- When inverse rollback SQL is unavailable, generated `down()` emits a no-op rollback comment instead of dropping the table.
+
+### migrateRun empty-detection robustness
+
+- `migrate:run` no longer relies on brittle migration file source-text regex to detect empty migrations.
+- Empty detection is now based on actual non-empty `db.query(...)` calls executed during `up()`.
+- Valid migrations that use variable SQL or non-template query forms are no longer skipped as false-empty.
+
+### ConnectionFactory cold-start race protection
+
+- `getConnection()` now deduplicates concurrent cold-start initialization per connection name using in-flight promises.
+- `getAdapter()` now deduplicates concurrent cold-start adapter initialization per connection name.
+- Failed initialization now clears in-flight state so retries can succeed cleanly.
+
+### SchemaBuilder default-string escaping hardening
+
+- `SchemaBuilder.columnSQL()` now uses safe default-literal formatting for `options.default`.
+- String defaults with single quotes are escaped (`'` -> `''`) in generated SQL.
+- Applies consistently to create SQL and smart-update add-column SQL generation.
+
+## Pre-release Notes
+
+### Breaking package-surface changes in `0.9.x`
+
+- Root exports were narrowed to the supported public API in [src/index.ts](/src/index.ts).
+- Deep imports into internal paths such as `@alpha.consultings/eloquent-orm.js/dist/core/*`, `@alpha.consultings/eloquent-orm.js/dist/cli/*`, or repo source paths are private and unsupported.
+- Internal connection helpers and config objects are no longer part of the root package surface.
+  - Removed from public root usage: `getConnection`, `getAdapter`, `closeAllConnections`, `resolveConnectionName`, `DriverAdapter`, `dbConfig`, and cache internals.
+- Generated consumer code now imports from `@alpha.consultings/eloquent-orm.js` package root instead of internal relative source paths.
+
+### Consumer action
+
+- Update app imports to use only documented root exports from `@alpha.consultings/eloquent-orm.js`.
+- Regenerate CLI-created models/factories/scenarios if they were produced before the package-surface hardening work.

package/README.md

@@ -0,0 +1,215 @@
+# Eloquent ORM JS
+
+Laravel-inspired ORM + CLI for Node.js + TypeScript with SQL and MongoDB runtime support.
+
+Package: `@alpha.consultings/eloquent-orm.js`
+
+## What this package gives you
+
+- SQL and MongoDB model persistence with a Laravel-like runtime API.
+- CLI generators for models, services, controllers, migrations, factories, and scenarios.
+- Migration and seed pipelines across test/CLI environments.
+- Built-in cache manager and cache-clearing utilities.
+- Relationship support (`belongsTo`, `hasMany`, `belongsToMany`, morph*).
+
+## Install
+
+```bash
+npm install @alpha.consultings/eloquent-orm.js
+```
+
+## Prerequisites
+
+<!-- supported-prerequisites:start -->
+The following versions are the current supported and CI-tested prerequisites.
+
+| Component | Supported / tested version |
+| --- | --- |
+| Node.js | `20.x` |
+| TypeScript | `^5.9.3` |
+| MySQL | `8.0` |
+| PostgreSQL | `16` |
+| MongoDB | `7` |
+| SQLite | `SQLite 3.x via better-sqlite3 12.2.0` |
+| Memcached | `1.6+ server, client package ^2.2.2` |
+<!-- supported-prerequisites:end -->
+
+Run commands with:
+
+```bash
+npx eloquent
+```
+
+## Quick start (CLI + runtime)
+
+### 1) Generate a model and migration
+
+```bash
+npx eloquent make:model User --with-migration
+```
+
+Note: command syntax is `eloquent make:model User`, not `eloquent: make: model`.
+
+### 2) Register models in your app bootstrap
+
+Express.js is the required runtime for HTTP-facing usage in this project and integrates without issues.
+
+```ts
+import { registerModels } from "@alpha.consultings/eloquent-orm.js";
+import { User } from "./app/models/User";
+import { Post } from "./app/models/Post";
+
+registerModels([User, Post]);
+```
+
+### 3) Run migrations
+
+```bash
+npx eloquent make:migration --all
+npx eloquent migrate:run --test --all-migrations
+```
+
+### 4) Optional cache bootstrap
+
+```ts
+import { setupCache } from "@alpha.consultings/eloquent-orm.js";
+setupCache(); // Memory/Staging/Production cache selector from env
+```
+
+## Common generator commands (runtime-focused)
+
+- `npx eloquent make:model User --with-migration`
+- `npx eloquent make:service User`
+- `npx eloquent make:controller User`
+- `npx eloquent make:seed User --count 10`
+- `npx eloquent make:migration --all`
+- `npx eloquent migrate:run`
+- `npx eloquent migrate:fresh --force --yes`
+- `npx eloquent db:seed --class BlogScenarioSeeder --test`
+
+## Runtime CRUD with generated models
+
+Use static safe-finders for targeted reads and creation, and use loaded instances for persistence updates.
+
+```ts
+import { User } from "./app/models/User";
+
+// List all
+const users = await new User().all();
+
+// Safe finder + query chain
+const recentActiveUsers = await User.where("is_active", true)
+  .orderBy("created_at", "desc")
+  .limit(20)
+  .get();
+
+const oneByEmail = await User.findOneBy("email", "alice@example.com");
+const byId = await User.find(10);
+
+// Create
+const created = await User.create({
+  name: "Alice",
+  email: "alice@example.com",
+});
+
+// Update via instance persistence
+if (created) {
+  created.update({ name: "Alice Johnson" });
+  await created.save();
+}
+
+// Patch directly if already persisted
+const persisted = await User.findOneBy("email", "alice@example.com");
+await persisted?.patch?.({ name: "Alice K." });
+
+// Delete
+await User.deleteById(1);
+
+// Bulk helpers
+await User.createMany([
+  { name: "Bob", email: "bob@example.com" },
+  { name: "Carol", email: "carol@example.com" },
+]);
+await User.updateMany([1, 2], { is_active: false });
+await User.deleteMany([1, 2]);
+```
+
+### Soft delete + restore
+
+Soft delete is supported by model mixins, and delete behavior is routed to `deleted_at` when that field is present in your schema/model state.
+
+```ts
+await User.deleteById(1);     // marks deleted_at
+await User.restoreById(1);    // clears deleted_at
+```
+
+If your model does not currently use soft-delete columns, keep delete/restore aligned with your schema.
+
+## Generating and using services
+
+```bash
+npx eloquent make:service User
+```
+
+Generated service (`app/services/UserService.ts`):
+
+```ts
+const service = new UserService();
+
+await service.all();
+await service.find(1);
+await service.create({ name: "Alice", email: "alice@example.com" });
+await service.update(1, { email: "new@example.com" });
+await service.delete(1);
+await service.restore(1);
+```
+
+This keeps controller code simple and centralizes persistence logic per domain entity.
+
+## Caching inside read/get flows
+
+`setupCache()` configures the active cache driver based on environment.
+For read-heavy endpoints, cache at service/query boundary using `CacheManager` (public API).
+
+```ts
+import { CacheManager, setupCache } from "@alpha.consultings/eloquent-orm.js";
+
+setupCache();
+
+export async function getActiveUsersFromCache() {
+  const key = "users:active:v1";
+  const cached = await CacheManager.get(key);
+  if (cached) return cached;
+
+  const users = await User.where("is_active", true).orderBy("created_at", "desc").get();
+  await CacheManager.set(key, users, 60);
+  return users;
+}
+
+export async function createUser(payload: Record<string, unknown>) {
+  const user = await User.create(payload);
+  await CacheManager.delete("users:active:v1"); // invalidate read cache after write
+  return user;
+}
+```
+
+CLI cache helpers:
+
+- `npx eloquent cache:stats` (inspect runtime cache stats)
+- `npx eloquent cache:clear` (clear all cache entries)
+
+## Documentation
+
+The full consumer documentation is organized around the main usage paths:
+
+- `Get Started`: installation, quick start, common scenarios, and cookbook guides
+- `Runtime`: CRUD, querying, models, controllers, services, and cache
+- `Test`: Jest/runtime testing, factories, seeds, scenarios, and pack smoke
+- `ORM`: relations, mixins, soft deletes, migrations, multi-connection strategy, and Mongo guidance
+- `CLI`: commands, generators, production-safety rules, and test matrix guidance
+
+Start with:
+
+- [docs/getting-started/quick-start.mdx](docs/getting-started/quick-start.mdx)
+- [docs/runtime/crud.mdx](docs/runtime/crud.mdx)
+- [docs/runtime/querying.mdx](docs/runtime/querying.mdx)

package/dist/Model.d.ts

@@ -0,0 +1,2 @@
+export { SqlModel, MongoModel, type ModelAttrs, type ModelInstance, } from "./core/model/BaseModel";
+//# sourceMappingURL=Model.d.ts.map

package/dist/Model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../src/Model.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,QAAQ,EACR,UAAU,EACV,KAAK,UAAU,EACf,KAAK,aAAa,GACnB,MAAM,wBAAwB,CAAC"}

package/dist/Model.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoModel = exports.SqlModel = void 0;
+var BaseModel_1 = require("./core/model/BaseModel");
+Object.defineProperty(exports, "SqlModel", { enumerable: true, get: function () { return BaseModel_1.SqlModel; } });
+Object.defineProperty(exports, "MongoModel", { enumerable: true, get: function () { return BaseModel_1.MongoModel; } });
+//# sourceMappingURL=Model.js.map

package/dist/Model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Model.js","sourceRoot":"","sources":["../src/Model.ts"],"names":[],"mappings":";;;AAAA,oDAKgC;AAJ9B,qGAAA,QAAQ,OAAA;AACR,uGAAA,UAAU,OAAA"}

package/dist/cli/commands/cacheClear.d.ts

@@ -0,0 +1,2 @@
+export declare function cacheClear(): Promise<void>;
+//# sourceMappingURL=cacheClear.d.ts.map

package/dist/cli/commands/cacheClear.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheClear.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/cacheClear.ts"],"names":[],"mappings":"AAKA,wBAAsB,UAAU,kBAsE/B"}

package/dist/cli/commands/cacheClear.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheClear = cacheClear;
+const CacheRegistry_1 = require("../../core/cache/CacheRegistry");
+const CacheAnalytics_1 = require("../../core/cache/CacheAnalytics");
+const CacheFallbackManager_1 = require("../../core/cache/CacheFallbackManager");
+const setupCache_1 = require("../../core/cache/setupCache");
+async function cacheClear() {
+    (0, setupCache_1.setupCache)();
+    const before = CacheRegistry_1.CacheRegistry.getStats();
+    const errors = [];
+    const fallbackDrivers = CacheFallbackManager_1.CacheFallbackManager.getDrivers();
+    try {
+        await CacheRegistry_1.CacheRegistry.clearAll();
+    }
+    catch (err) {
+        errors.push(`CacheManager clear failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    let fallbackClearResults = [];
+    let fallbackShutdownResults = [];
+    if (fallbackDrivers.length > 0) {
+        try {
+            fallbackClearResults = await CacheFallbackManager_1.CacheFallbackManager.clearAllDrivers();
+        }
+        catch (err) {
+            errors.push(`Fallback clear failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        try {
+            fallbackShutdownResults = await CacheFallbackManager_1.CacheFallbackManager.shutdownDrivers();
+        }
+        catch (err) {
+            errors.push(`Fallback shutdown failed: ${err instanceof Error ? err.message : String(err)}`);
+        }
+    }
+    CacheAnalytics_1.CacheAnalytics.reset();
+    const after = CacheRegistry_1.CacheRegistry.getStats();
+    console.log("cache:clear");
+    console.log(`  registry keys: ${before.keys} -> ${after.keys}`);
+    console.log(`  registry groups: ${before.groups} -> ${after.groups}`);
+    console.log("  analytics: reset");
+    if (fallbackDrivers.length > 0) {
+        const summary = fallbackClearResults
+            .map((r) => `${r.driver}:${r.ok ? "ok" : "fail"}`)
+            .join(", ");
+        console.log(`  fallback chain clear: ${summary || "no-op"}`);
+        const shutdownSummary = fallbackShutdownResults
+            .map((r) => `${r.driver}:${r.closed ? "closed" : "open"}`)
+            .join(", ");
+        console.log(`  fallback chain shutdown: ${shutdownSummary || "no-op"}`);
+    }
+    else {
+        console.log("  fallback driver: none");
+    }
+    const failedFallback = fallbackClearResults.filter((r) => !r.ok);
+    for (const failure of failedFallback) {
+        errors.push(`Fallback ${failure.driver} clear failed: ${failure.error ?? "unknown error"}`);
+    }
+    const failedShutdown = fallbackShutdownResults.filter((r) => !r.closed);
+    for (const failure of failedShutdown) {
+        errors.push(`Fallback ${failure.driver} shutdown failed: ${failure.error ?? "unknown error"}`);
+    }
+    if (errors.length > 0) {
+        console.error("  warnings:");
+        for (const err of errors) {
+            console.error(`  - ${err}`);
+        }
+    }
+}
+//# sourceMappingURL=cacheClear.js.map

package/dist/cli/commands/cacheClear.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheClear.js","sourceRoot":"","sources":["../../../src/cli/commands/cacheClear.ts"],"names":[],"mappings":";;AAKA,gCAsEC;AA3ED,kEAA+D;AAC/D,oEAAiE;AACjE,gFAA6E;AAC7E,4DAAyD;AAElD,KAAK,UAAU,UAAU;IAC9B,IAAA,uBAAU,GAAE,CAAC;IACb,MAAM,MAAM,GAAG,6BAAa,CAAC,QAAQ,EAAE,CAAC;IACxC,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,MAAM,eAAe,GAAG,2CAAoB,CAAC,UAAU,EAAE,CAAC;IAE1D,IAAI,CAAC;QACH,MAAM,6BAAa,CAAC,QAAQ,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,CAAC,IAAI,CACT,8BAA8B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CACjF,CAAC;IACJ,CAAC;IAED,IAAI,oBAAoB,GAA2D,EAAE,CAAC;IACtF,IAAI,uBAAuB,GAA+D,EAAE,CAAC;IAC7F,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,IAAI,CAAC;YACH,oBAAoB,GAAG,MAAM,2CAAoB,CAAC,eAAe,EAAE,CAAC;QACtE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,0BAA0B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAC7E,CAAC;QACJ,CAAC;QACD,IAAI,CAAC;YACH,uBAAuB,GAAG,MAAM,2CAAoB,CAAC,eAAe,EAAE,CAAC;QACzE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,IAAI,CACT,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAChF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,+BAAc,CAAC,KAAK,EAAE,CAAC;IACvB,MAAM,KAAK,GAAG,6BAAa,CAAC,QAAQ,EAAE,CAAC;IAEvC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,IAAI,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAChE,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,MAAM,OAAO,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,oBAAoB;aACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACjD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,2BAA2B,OAAO,IAAI,OAAO,EAAE,CAAC,CAAC;QAC7D,MAAM,eAAe,GAAG,uBAAuB;aAC5C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;aACzD,IAAI,CAAC,IAAI,CAAC,CAAC;QACd,OAAO,CAAC,GAAG,CAAC,8BAA8B,eAAe,IAAI,OAAO,EAAE,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,cAAc,GAAG,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACjE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,MAAM,kBAAkB,OAAO,CAAC,KAAK,IAAI,eAAe,EAAE,CAAC,CAAC;IAC9F,CAAC;IACD,MAAM,cAAc,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;IACxE,KAAK,MAAM,OAAO,IAAI,cAAc,EAAE,CAAC;QACrC,MAAM,CAAC,IAAI,CACT,YAAY,OAAO,CAAC,MAAM,qBAAqB,OAAO,CAAC,KAAK,IAAI,eAAe,EAAE,CAClF,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;YACzB,OAAO,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/commands/cacheStats.d.ts

@@ -0,0 +1,2 @@
+export declare function cacheStats(): Promise<void>;
+//# sourceMappingURL=cacheStats.d.ts.map

package/dist/cli/commands/cacheStats.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheStats.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/cacheStats.ts"],"names":[],"mappings":"AAYA,wBAAsB,UAAU,kBA2D/B"}

package/dist/cli/commands/cacheStats.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cacheStats = cacheStats;
+const CacheManager_1 = require("../../core/cache/CacheManager");
+const CacheRegistry_1 = require("../../core/cache/CacheRegistry");
+const CacheAnalytics_1 = require("../../core/cache/CacheAnalytics");
+const CacheFallbackManager_1 = require("../../core/cache/CacheFallbackManager");
+const setupCache_1 = require("../../core/cache/setupCache");
+function ratioPercent(hits, misses) {
+    const total = hits + misses;
+    if (total === 0)
+        return "0.00%";
+    return `${((hits / total) * 100).toFixed(2)}%`;
+}
+async function cacheStats() {
+    (0, setupCache_1.setupCache)();
+    const driver = CacheManager_1.CacheManager.getDriver();
+    const fallbackActive = CacheFallbackManager_1.CacheFallbackManager.getActiveDriver();
+    const fallbackDrivers = CacheFallbackManager_1.CacheFallbackManager.getDrivers();
+    const registry = CacheRegistry_1.CacheRegistry.getStats();
+    const analyticsRows = CacheAnalytics_1.CacheAnalytics.getStats();
+    const totalHits = analyticsRows.reduce((sum, row) => sum + row.hits, 0);
+    const totalMisses = analyticsRows.reduce((sum, row) => sum + row.misses, 0);
+    console.log("cache:stats");
+    console.log(`  manager driver: ${driver.constructor.name}`);
+    console.log(`  fallback driver: ${fallbackActive ? fallbackActive.constructor.name : "none"}`);
+    if (fallbackDrivers.length > 0) {
+        console.log(`  fallback chain: ${fallbackDrivers.map((d) => d.constructor.name).join(" -> ")}`);
+    }
+    else {
+        console.log("  fallback chain: none");
+    }
+    console.log(`  registry: models=${registry.models}, groups=${registry.groups}, keys=${registry.keys}`);
+    console.log(`  analytics: models=${analyticsRows.length}, hits=${totalHits}, misses=${totalMisses}, hit_rate=${ratioPercent(totalHits, totalMisses)}`);
+    if (registry.groupsByModel.length > 0) {
+        console.log("  registry by model:");
+        for (const row of registry.groupsByModel) {
+            console.log(`    - ${row.model}: groups=${row.groups}, keys=${row.keys}`);
+        }
+    }
+    if (analyticsRows.length > 0) {
+        console.log("  analytics by model:");
+        for (const row of analyticsRows) {
+            console.log(`    - ${row.model}: hits=${row.hits}, misses=${row.misses}, ttl=${row.ttl}, hit_rate=${ratioPercent(row.hits, row.misses)}`);
+        }
+    }
+    if (fallbackDrivers.length > 0) {
+        const shutdownResults = await CacheFallbackManager_1.CacheFallbackManager.shutdownDrivers();
+        const shutdownSummary = shutdownResults
+            .map((r) => `${r.driver}:${r.closed ? "closed" : "open"}`)
+            .join(", ");
+        console.log(`  fallback chain shutdown: ${shutdownSummary || "no-op"}`);
+    }
+}
+//# sourceMappingURL=cacheStats.js.map

package/dist/cli/commands/cacheStats.js.map

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

package/dist/cli/commands/dbSeed.d.ts

@@ -0,0 +1,16 @@
+import { type ConnectionName } from "../../core/connection/ConnectionFactory";
+/**
+ * db:seed
+ * Runs all seeders (or a specific seeder) in /database/seeds
+ */
+export declare function dbSeed(options: {
+    test?: boolean;
+    class?: string;
+    close?: boolean;
+    exit?: boolean;
+    connectionNames?: ConnectionName[];
+    auditCommand?: string;
+    silent?: boolean;
+    noHooks?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=dbSeed.d.ts.map

package/dist/cli/commands/dbSeed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dbSeed.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/dbSeed.ts"],"names":[],"mappings":"AAKA,OAAO,EAEL,KAAK,cAAc,EACpB,MAAM,yCAAyC,CAAC;AAejD;;;GAGG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE;IACpC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;IACnC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8LhB"}