@classytic/arc-testkit 0.1.0 → 0.1.2

package/dist/index.d.mts

@@ -1,54 +1,11 @@
-import { ArcModuleInput, CreateAppOptions } from "@classytic/arc/factory";
-import { FastifyInstance } from "fastify";
+import { BootModuleAppOptions as BootModuleAppOptions$1, BootModulesInput, ModuleTestApp as ModuleTestApp$1, TestkitContext as TestkitContext$1 } from "@classytic/arc/testing";
 import { Connection } from "mongoose";
 
 //#region src/index.d.ts
-/** The context a backend yields — a live connection + the URI it connects to. */
-interface BackendContext {
-  connection: Connection;
-  uri: string;
-}
-/**
- * A pluggable database backend. Structurally satisfied by
- * `@classytic/mongokit/testkit`'s `mongoMemoryBackend()` — no import of it in
- * the type, so arc-testkit never hard-depends on the kit (one-way: arc-testkit
- * consumes a backend by shape).
- */
-interface TestBackend {
-  setup(): Promise<{
-    ctx: BackendContext;
-    teardown: () => Promise<void>;
-  }>;
-}
-/** What a module factory receives — the live connection + its URI. */
-interface TestkitContext {
-  connection: Connection;
-  mongoUri: string;
-}
-type ModulesInput = ArcModuleInput | readonly ArcModuleInput[] | ((ctx: TestkitContext) => ArcModuleInput | readonly ArcModuleInput[] | Promise<ArcModuleInput | readonly ArcModuleInput[]>);
-interface BootModuleAppOptions {
-  /**
-   * Use a single-node replica set instead of a standalone mongod. Required when
-   * the module under test opens multi-document transactions. Ignored when a
-   * custom `backend` is supplied. Default false.
-   */
-  replset?: boolean;
-  /** Merged over the testkit defaults (`preset: 'testing'`, `auth: false`). */
-  app?: Partial<CreateAppOptions>;
-  /**
-   * Override the database backend. Default: `mongoMemoryBackend()` from
-   * `@classytic/mongokit/testkit`. Supply your own to point at a shared server,
-   * a real Atlas cluster, or a different kit's backend.
-   */
-  backend?: TestBackend;
-}
-interface ModuleTestApp {
-  app: FastifyInstance;
-  connection: Connection;
-  mongoUri: string;
-  /** Close app → tear the backend down (disconnect + stop server). Idempotent. */
-  close(): Promise<void>;
-}
+type TestkitContext = TestkitContext$1<Connection>;
+type ModulesInput = BootModulesInput<Connection>;
+type BootModuleAppOptions = BootModuleAppOptions$1<Connection>;
+type ModuleTestApp = ModuleTestApp$1<Connection>;
 declare function bootModuleApp(modules: ModulesInput, options?: BootModuleAppOptions): Promise<ModuleTestApp>;
 //#endregion
-export { BackendContext, BootModuleAppOptions, ModuleTestApp, ModulesInput, TestBackend, TestkitContext, bootModuleApp };
+export { BootModuleAppOptions, ModuleTestApp, ModulesInput, TestkitContext, bootModuleApp };

package/dist/index.mjs

@@ -1,73 +1,27 @@
-import { createApp } from "@classytic/arc/factory";
+import { bootModuleApp as bootModuleApp$1 } from "@classytic/arc/testing";
 //#region src/index.ts
 /**
-* `@classytic/arc-testkit` — boot a REAL arc app around the module(s) under
-* test, on a real (in-memory) database. The ecosystem's contributor contract:
-* **if your module boots green here, it composes into any arc host.**
+* @classytic/arc-testkit — boots a REAL arc app around the module(s) under
+* test on in-memory MongoDB. The contributor contract: if your module boots
+* green here, it composes into any arc vertical.
 *
-* ```ts
-* const t = await bootModuleApp(({ connection }) => [
-*   createAccountingModule({ connection, permissions }),
-* ]);
-* const res = await t.app.inject({ method: 'GET', url: '/accounting/accounts' });
-* await t.close();
-* ```
+*   const t = await bootModuleApp(({ connection }) => [
+*     createAccountingModule({ connection, country, permissions }),
+*   ]);
+*   const res = await t.app.inject({ method: 'GET', url: '/accounting/accounts' });
+*   const engine = t.exports<AccountingEngine>('accounting'); // typed module export
+*   await t.close();
 *
-* This is a thin generic core: `bootModuleApp` resolves the module list, opens a
-* database via a pluggable **backend**, and boots arc around it. The default
-* backend is `mongoMemoryBackend()` from `@classytic/mongokit/testkit` — loaded
-* via dynamic `import()` so `@classytic/mongokit` + `mongodb-memory-server` stay
-* OPTIONAL peers (needed only when you use the default backend). Pass your own
-* `backend` — e.g. one pointed at a shared server, or a real Atlas cluster — to
-* override it.
-*
-* Modules usually need the live DB connection in their deps, so the primary
-* input is a FACTORY receiving `{ connection, mongoUri }`. Plain module lists
-* are also accepted.
+* Since arc 2.22 the harness itself lives in `@classytic/arc/testing`
+* (upstreamed from this package — default-connection ownership, boot-failure
+* cleanup, idempotent close, the typed `exports()` accessor, `sensible: false`
+* and all). This package is now the MONGO-TYPED face of it: arc core stays
+* DB-agnostic (`connection: unknown` generic), the module fleet is Mongoose —
+* the wrapper pins `TConn = Connection` once so every module test gets a typed
+* connection with zero casts.
 */
-/** Load the default backend lazily so mongokit + memory-server stay optional. */
-async function defaultBackend(replset) {
-	try {
-		const { mongoMemoryBackend } = await import("@classytic/mongokit/testkit");
-		return mongoMemoryBackend({ replset });
-	} catch (err) {
-		throw new Error(`[arc-testkit] the default backend needs \`@classytic/mongokit\` (>=3.19.0) and \`mongodb-memory-server\` installed as devDependencies. Install them, or pass your own \`backend\` to bootModuleApp. Original error: ${err.message}`);
-	}
-}
-async function bootModuleApp(modules, options = {}) {
-	const { ctx, teardown } = await (options.backend ?? await defaultBackend(options.replset ?? false)).setup();
-	const testkitCtx = {
-		connection: ctx.connection,
-		mongoUri: ctx.uri
-	};
-	const resolved = typeof modules === "function" ? await modules(testkitCtx) : modules;
-	const list = Array.isArray(resolved) ? resolved : [resolved];
-	let app;
-	try {
-		app = await createApp({
-			preset: "testing",
-			auth: false,
-			sensible: false,
-			...options.app,
-			modules: list
-		});
-		await app.ready();
-	} catch (err) {
-		await teardown().catch(() => void 0);
-		throw err;
-	}
-	let closed = false;
-	return {
-		app,
-		connection: ctx.connection,
-		mongoUri: ctx.uri,
-		close: async () => {
-			if (closed) return;
-			closed = true;
-			await app.close().catch(() => void 0);
-			await teardown();
-		}
-	};
+function bootModuleApp(modules, options = {}) {
+	return bootModuleApp$1(modules, options);
 }
 //#endregion
 export { bootModuleApp };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@classytic/arc-testkit",
-  "version": "0.1.0",
-  "description": "Boot a real @classytic/arc app around the module(s) under test on in-memory MongoDB — the ecosystem test harness. If your arc module boots green here, it composes into any arc host.",
+  "version": "0.1.2",
+  "description": "Boot a real @classytic/arc app around the module(s) under test on in-memory MongoDB — the ecosystem test harness. Thin Mongo-typed wrapper over @classytic/arc/testing (arc 2.22+). If your arc module boots green here, it composes into any arc host.",
   "type": "module",
   "exports": {
     ".": {
@@ -28,24 +28,13 @@
     "lint": "biome check src/",
     "prepublishOnly": "node ../../scripts/prepublish-gate.mjs"
   },
+  "dependencies": {
+    "mongodb-memory-server": ">=10.0.0"
+  },
   "peerDependencies": {
-    "@classytic/arc": ">=2.20.0",
-    "@classytic/mongokit": ">=3.19.0",
-    "fastify": ">=5.0.0",
-    "mongodb-memory-server": ">=10.0.0",
+    "@classytic/arc": ">=2.22.0",
     "mongoose": ">=9.4.1"
   },
-  "peerDependenciesMeta": {
-    "@classytic/mongokit": {
-      "optional": true
-    },
-    "mongodb-memory-server": {
-      "optional": true
-    },
-    "mongoose": {
-      "optional": true
-    }
-  },
   "keywords": [
     "arc",
     "fastify",