@dolphjs/testing 1.0.0 → 2.0.0

package/README.md

@@ -108,12 +108,11 @@ At enterprise scale — hundreds of spec files — `ts-jest` type-checking every
 - **`TestingRegistry.override(ServiceClass, mock)`** — seed a mock directly, for cases `createTestingApp`'s `overrides` doesn't cover.
 - **`TestingRegistry.get(ServiceClass)` / `.has(...)`** — read the current registry state.
 - **`TestingRegistry.reset()`** — clear every cached service. Call between test files, never mid-file.
-- **`createTestingApp({ components, overrides?, middlewares? })`** — see above. Returns `{ engine, get, close }`; `close()` is async — it closes the ephemeral server before resolving, so `afterAll(() => app.close())` is enough (Jest awaits the returned promise).
+- **`createTestingApp({ components, overrides?, middlewares?, connect? })`** — see above. Returns `{ engine, get, close }`; `close()` is async — it closes the ephemeral server before resolving, so `afterAll(() => app.close())` is enough (Jest awaits the returned promise).
 - **`createSqliteTestDataSource({ entities })`** — in-memory `better-sqlite3` TypeORM `DataSource`, entity classes passed directly (no glob strings, no `dolph_config.yaml`).
-- **`createSqliteTestSequelize()`** — in-memory `sqlite3` Sequelize instance; call `Model.init({...}, { sequelize })` against it yourself.
 - **`createMongoMemoryTestServer()`** — real ephemeral MongoDB via `mongodb-memory-server`; returns `{ uri, stop }`.
 
-The three DB helpers lazily `require()` their driver, so an app that only uses Mongoose never resolves `typeorm`/`sequelize`, and vice versa — install only what you use.
+The two DB helpers lazily `require()` their driver, so an app that only uses Mongoose never resolves `typeorm`, and vice versa — install only what you use.
 
 ## Development
 

package/dist/db/mongo-memory.d.ts

@@ -5,7 +5,7 @@ export interface MongoMemoryTestServer {
 /**
  * Spins up a real, ephemeral MongoDB instance in-process for tests — no
  * mocked driver, no shared dev database. Pass `.uri` to `mongoose.connect()`
- * (or `autoInitMongo({ url: uri })`) in your test setup, and `.stop()` in
+ * in your test setup, and `.stop()` in
  * teardown. Requires `mongodb-memory-server` in the consuming app; lazily
  * required so apps that don't use Mongoose never pay to resolve it.
  */

package/dist/db/mongo-memory.js

@@ -4,7 +4,7 @@ exports.createMongoMemoryTestServer = createMongoMemoryTestServer;
 /**
  * Spins up a real, ephemeral MongoDB instance in-process for tests — no
  * mocked driver, no shared dev database. Pass `.uri` to `mongoose.connect()`
- * (or `autoInitMongo({ url: uri })`) in your test setup, and `.stop()` in
+ * in your test setup, and `.stop()` in
  * teardown. Requires `mongodb-memory-server` in the consuming app; lazily
  * required so apps that don't use Mongoose never pay to resolve it.
  */

package/dist/db/sqlite-typeorm.d.ts

@@ -8,7 +8,7 @@ export interface SqliteTestDataSourceOptions {
 /**
  * An in-memory, `better-sqlite3`-backed TypeORM `DataSource` for tests.
  *
- * Bypasses `autoInitTypeOrm`/`dolph_config.yaml` entirely — those exist to
+ * Bypasses `dolph_config.yaml` entirely — those exist to
  * wire a real database at app boot, which is unnecessary ceremony (and a
  * shared on-disk file mutation) for a test that just needs a throwaway
  * schema. Requires `typeorm` and `better-sqlite3` in the consuming app;

package/dist/db/sqlite-typeorm.js

@@ -4,7 +4,7 @@ exports.createSqliteTestDataSource = createSqliteTestDataSource;
 /**
  * An in-memory, `better-sqlite3`-backed TypeORM `DataSource` for tests.
  *
- * Bypasses `autoInitTypeOrm`/`dolph_config.yaml` entirely — those exist to
+ * Bypasses `dolph_config.yaml` entirely — those exist to
  * wire a real database at app boot, which is unnecessary ceremony (and a
  * shared on-disk file mutation) for a test that just needs a throwaway
  * schema. Requires `typeorm` and `better-sqlite3` in the consuming app;

package/dist/index.d.ts

@@ -4,6 +4,5 @@ export { createTestingApp } from './testing-app';
 export type { TestingApp, TestingAppOptions, ComponentRef, ServiceOverride } from './testing-app';
 export { createSqliteTestDataSource } from './db/sqlite-typeorm';
 export type { SqliteTestDataSourceOptions } from './db/sqlite-typeorm';
-export { createSqliteTestSequelize } from './db/sqlite-sequelize';
 export { createMongoMemoryTestServer } from './db/mongo-memory';
 export type { MongoMemoryTestServer } from './db/mongo-memory';

package/dist/index.js

@@ -1,14 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMongoMemoryTestServer = exports.createSqliteTestSequelize = exports.createSqliteTestDataSource = exports.createTestingApp = exports.TestingRegistry = void 0;
+exports.createMongoMemoryTestServer = exports.createSqliteTestDataSource = exports.createTestingApp = exports.TestingRegistry = void 0;
 var testing_registry_1 = require("./testing-registry");
 Object.defineProperty(exports, "TestingRegistry", { enumerable: true, get: function () { return testing_registry_1.TestingRegistry; } });
 var testing_app_1 = require("./testing-app");
 Object.defineProperty(exports, "createTestingApp", { enumerable: true, get: function () { return testing_app_1.createTestingApp; } });
 var sqlite_typeorm_1 = require("./db/sqlite-typeorm");
 Object.defineProperty(exports, "createSqliteTestDataSource", { enumerable: true, get: function () { return sqlite_typeorm_1.createSqliteTestDataSource; } });
-var sqlite_sequelize_1 = require("./db/sqlite-sequelize");
-Object.defineProperty(exports, "createSqliteTestSequelize", { enumerable: true, get: function () { return sqlite_sequelize_1.createSqliteTestSequelize; } });
 var mongo_memory_1 = require("./db/mongo-memory");
 Object.defineProperty(exports, "createMongoMemoryTestServer", { enumerable: true, get: function () { return mongo_memory_1.createMongoMemoryTestServer; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAGzB,sDAAiE;AAAxD,4HAAA,0BAA0B,OAAA;AAGnC,0DAAkE;AAAzD,6HAAA,yBAAyB,OAAA;AAElC,kDAAgE;AAAvD,2HAAA,2BAA2B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,uDAAqD;AAA5C,mHAAA,eAAe,OAAA;AAGxB,6CAAiD;AAAxC,+GAAA,gBAAgB,OAAA;AAGzB,sDAAiE;AAAxD,4HAAA,0BAA0B,OAAA;AAInC,kDAAgE;AAAvD,2HAAA,2BAA2B,OAAA"}

package/dist/testing-app.d.ts

@@ -20,15 +20,17 @@ export interface TestingAppOptions {
     components: ComponentRef[];
     /** Mocks seeded into the registry before `components` are resolved. */
     overrides?: ServiceOverride[];
-    /** Applied before route registration — same ordering as `DolphFactory`'s constructor. */
+    /** The `middlewares` option of `DolphFactory`, applied before routes. */
     middlewares?: RequestHandler[];
+    /** Connects the databases in `dolph_config.yaml` before returning. Off by default. */
+    connect?: boolean;
 }
 export interface TestingApp {
     /** A real, already-listening ephemeral server — hand it straight to supertest. */
     engine: Server;
     /** Reads a service instance (real or mocked) straight off the registry, for direct assertions. */
     get<T>(serviceClass: Ctor<T>): T | undefined;
-    /** Closes the ephemeral server and clears the process-wide registry. Call in `afterAll`. */
+    /** Closes the ephemeral server and any databases, and clears the process-wide registry. Call in `afterAll`. */
     close(): Promise<void>;
 }
 /**

package/dist/testing-app.js

@@ -23,7 +23,7 @@ const isLoader = (ref) => typeof ref === 'function' && ref.prototype === undefin
  * side effects.
  */
 async function createTestingApp(options) {
-    const { components, overrides = [], middlewares } = options;
+    const { components, overrides = [], middlewares, connect = false } = options;
     // 1. Seed mocks first — see the module-level doc comment on why ordering matters.
     for (const { service, useValue } of overrides) {
         dolph_1.GlobalServiceRegistry.set(service, useValue);
@@ -41,15 +41,19 @@ async function createTestingApp(options) {
             resolved.push(ref);
         }
     }
-    const factory = new dolph_1.DolphFactory(resolved, middlewares);
+    const factory = new dolph_1.DolphFactory(resolved, { middlewares });
+    if (connect) {
+        await factory.ready();
+    }
     const server = (0, http_1.createServer)(factory.engine()).listen(0);
     return {
         engine: server,
         get: (serviceClass) => dolph_1.GlobalServiceRegistry.get(serviceClass),
-        close: () => new Promise((resolve) => {
+        close: async () => {
             dolph_1.GlobalServiceRegistry._reset();
-            server.close(() => resolve());
-        }),
+            await new Promise((resolve) => server.close(() => resolve()));
+            await factory.stop();
+        },
     };
 }
 //# sourceMappingURL=testing-app.js.map

package/dist/testing-app.js.map

@@ -1 +1 @@
-{"version":3,"file":"testing-app.js","sourceRoot":"","sources":["../src/testing-app.ts"],"names":[],"mappings":";;AAyDA,4CAiCC;AA1FD,4BAA0B;AAC1B,+BAA4C;AAC5C,0CAAqE;AAmCrE,MAAM,QAAQ,GAAG,CAAC,GAAiB,EAAkD,EAAE,CACnF,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,gBAAgB,CAAC,OAA0B;IAC7D,MAAM,EAAE,UAAU,EAAE,SAAS,GAAG,EAAE,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE5D,kFAAkF;IAClF,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,SAAS,EAAE,CAAC;QAC5C,6BAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,2CAA2C;IAC3C,MAAM,QAAQ,GAAW,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,MAAM,GAAG,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,GAAY,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,oBAAY,CAAC,QAAe,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAA,mBAAY,EAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO;QACH,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,6BAAqB,CAAC,GAAG,CAAC,YAAY,CAAC;QAC9D,KAAK,EAAE,GAAG,EAAE,CACR,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;YAC1B,6BAAqB,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC;QAClC,CAAC,CAAC;KACT,CAAC;AACN,CAAC"}
+{"version":3,"file":"testing-app.js","sourceRoot":"","sources":["../src/testing-app.ts"],"names":[],"mappings":";;AA2DA,4CAsCC;AAjGD,4BAA0B;AAC1B,+BAA4C;AAC5C,0CAAqE;AAqCrE,MAAM,QAAQ,GAAG,CAAC,GAAiB,EAAkD,EAAE,CACnF,OAAO,GAAG,KAAK,UAAU,IAAI,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC;AAE7D;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,gBAAgB,CAAC,OAA0B;IAC7D,MAAM,EAAE,UAAU,EAAE,SAAS,GAAG,EAAE,EAAE,WAAW,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAE7E,kFAAkF;IAClF,KAAK,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,SAAS,EAAE,CAAC;QAC5C,6BAAqB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,yEAAyE;IACzE,0EAA0E;IAC1E,2CAA2C;IAC3C,MAAM,QAAQ,GAAW,EAAE,CAAC;IAC5B,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;QAC3B,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAChB,MAAM,GAAG,GAAG,MAAM,GAAG,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAE,GAAY,CAAC,CAAC;QAClE,CAAC;aAAM,CAAC;YACJ,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,oBAAY,CAAC,QAAe,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;IAEnE,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,MAAM,GAAG,IAAA,mBAAY,EAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAExD,OAAO;QACH,MAAM,EAAE,MAAM;QACd,GAAG,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,6BAAqB,CAAC,GAAG,CAAC,YAAY,CAAC;QAC9D,KAAK,EAAE,KAAK,IAAI,EAAE;YACd,6BAAqB,CAAC,MAAM,EAAE,CAAC;YAC/B,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACpE,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;QACzB,CAAC;KACJ,CAAC;AACN,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dolphjs/testing",
-    "version": "1.0.0",
+    "version": "2.0.0",
     "description": "Official testing utilities for DolphJS applications — fast, isolated unit tests and lightweight HTTP integration tests built for the framework's decoration-time DI model.",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -26,19 +26,15 @@
         "test:examples": "jest --config jest.examples.config.js"
     },
     "peerDependencies": {
-        "@dolphjs/dolph": ">=2.0.0",
+        "@dolphjs/dolph": ">=3.0.0",
         "reflect-metadata": "^0.1.13 || ^0.2.0",
         "mongodb-memory-server": ">=9.0.0",
-        "sequelize": ">=6.0.0",
         "typeorm": ">=0.3.0"
     },
     "peerDependenciesMeta": {
         "mongodb-memory-server": {
             "optional": true
         },
-        "sequelize": {
-            "optional": true
-        },
         "typeorm": {
             "optional": true
         }
@@ -53,7 +49,6 @@
         "mongodb-memory-server": "^9.2.0",
         "reflect-metadata": "^0.2.2",
         "rimraf": "^5.0.7",
-        "sequelize": "^6.37.3",
         "supertest": "^7.0.0",
         "ts-jest": "^29.2.3",
         "typeorm": "^0.3.20",

package/dist/db/sqlite-sequelize.d.ts

@@ -1,12 +0,0 @@
-import type { Sequelize } from 'sequelize';
-/**
- * An in-memory `sqlite3`-backed Sequelize instance for tests.
- *
- * Hands back a bare, connected instance only — Sequelize models are bound to
- * an instance at `Model.init({...}, { sequelize, ... })`, so re-attaching
- * already-initialized models the way `autoInitSql` does for a real app isn't
- * meaningful here. Call `Model.init` against the returned instance in your
- * test setup. Requires `sequelize` and `sqlite3` in the consuming app;
- * lazily required so apps that don't use Sequelize never pay to resolve them.
- */
-export declare function createSqliteTestSequelize(): Promise<Sequelize>;

package/dist/db/sqlite-sequelize.js

@@ -1,30 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createSqliteTestSequelize = createSqliteTestSequelize;
-/**
- * An in-memory `sqlite3`-backed Sequelize instance for tests.
- *
- * Hands back a bare, connected instance only — Sequelize models are bound to
- * an instance at `Model.init({...}, { sequelize, ... })`, so re-attaching
- * already-initialized models the way `autoInitSql` does for a real app isn't
- * meaningful here. Call `Model.init` against the returned instance in your
- * test setup. Requires `sequelize` and `sqlite3` in the consuming app;
- * lazily required so apps that don't use Sequelize never pay to resolve them.
- */
-async function createSqliteTestSequelize() {
-    let SequelizeCtor;
-    try {
-        ({ Sequelize: SequelizeCtor } = require('sequelize'));
-    }
-    catch {
-        throw new Error('`sequelize` is not installed. Run `npm i -D sequelize sqlite3` to use createSqliteTestSequelize().');
-    }
-    const sequelize = new SequelizeCtor({
-        dialect: 'sqlite',
-        storage: ':memory:',
-        logging: false,
-    });
-    await sequelize.authenticate();
-    return sequelize;
-}
-//# sourceMappingURL=sqlite-sequelize.js.map

package/dist/db/sqlite-sequelize.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sqlite-sequelize.js","sourceRoot":"","sources":["../../src/db/sqlite-sequelize.ts"],"names":[],"mappings":";;AAYA,8DAkBC;AA5BD;;;;;;;;;GASG;AACI,KAAK,UAAU,yBAAyB;IAC3C,IAAI,aAA+B,CAAC;IACpC,IAAI,CAAC;QACD,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,KAAK,CACX,oGAAoG,CACvG,CAAC;IACN,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,aAAa,CAAC;QAChC,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,UAAU;QACnB,OAAO,EAAE,KAAK;KACjB,CAAC,CAAC;IAEH,MAAM,SAAS,CAAC,YAAY,EAAE,CAAC;IAC/B,OAAO,SAAS,CAAC;AACrB,CAAC"}