@dunx/testing 2.2.0 → 2.3.0

package/dist/index.js

@@ -148,12 +148,12 @@ var createTestServer = async (options) => {
   };
 };
 export {
-  testRoot,
-  testClient,
-  createTestServer,
+  RecordingLogger,
   createTestApp,
-  RecordingLogger
+  createTestServer,
+  testClient,
+  testRoot
 };
 
-//# debugId=1573B94CB0D606A564756E2164756E21
+//# debugId=542D5DFC23443AC664756E2164756E21
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -8,6 +8,6 @@
     "import {\n  collectModules,\n  readControllers,\n  type Ctor,\n  type ResolvedModule,\n} from '@dunx/core';\nimport {\n  discoverRoutes,\n  HttpFactory,\n  type HttpApp,\n  type HttpOptions,\n  type Middleware,\n} from '@dunx/http';\nimport { appOptions, testRoot, type TestAppOptions } from './app.js';\nimport { testClient, type TestClient } from './client.js';\n\nexport interface TestServerOptions\n  extends TestAppOptions, Omit<HttpOptions, 'port' | 'overrides'> {\n  /**\n   * `setGlobalPrefix`, applied before `listen()` so the client's URLs carry it.\n   *\n   * Explicitly `| undefined`, unlike the rest of the options: a suite that runs\n   * the same fixture prefixed and unprefixed passes a variable here, and under\n   * `exactOptionalPropertyTypes` that is otherwise a conditional spread. \"No\n   * prefix\" and \"absent\" mean the same thing, so nothing is lost by allowing it.\n   */\n  readonly prefix?: string | undefined;\n}\n\nexport interface TestServer extends TestClient {\n  readonly app: HttpApp;\n  /** `app.shutdown()` - stops the server, then tears the container down. */\n  close(): Promise<void>;\n}\n\nconst middlewareShaped = (ctor: Ctor<unknown>): boolean =>\n  typeof (ctor.prototype as { handle?: unknown } | undefined)?.handle ===\n  'function';\n\n/** Every class provider in the graph that implements `Middleware`. */\nconst declaredMiddleware = (\n  modules: readonly ResolvedModule[],\n): readonly Ctor<unknown>[] => {\n  const found: Ctor<unknown>[] = [];\n  for (const module of modules) {\n    for (const entry of module.options.providers ?? []) {\n      const ctor =\n        typeof entry === 'function'\n          ? entry\n          : entry.provider.kind === 'class'\n            ? entry.provider.ctor\n            : undefined;\n      if (ctor !== undefined && middlewareShaped(ctor)) found.push(ctor);\n    }\n  }\n  return found;\n};\n\n/**\n * The guards `@UseGuards` already puts in the route table. They are not global, so\n * omitting `middleware` costs them nothing and warning about them would be noise.\n */\nconst scopedGuards = (\n  app: HttpApp,\n  modules: readonly ResolvedModule[],\n): ReadonlySet<Ctor<Middleware>> => {\n  const applied = new Set<Ctor<Middleware>>();\n  for (const module of modules) {\n    for (const controller of readControllers(module)) {\n      for (const route of discoverRoutes(app.get(controller) as object)) {\n        for (const guard of route.guards ?? []) applied.add(guard);\n      }\n    }\n  }\n  return applied;\n};\n\n/**\n * The one silent way this harness can lie: `middleware` and `onError` default\n * away, so a suite that forgets them boots a server with no global guards and the\n * default error mapper, which still answers 200 where the application answers 401.\n * A first integration run of 12 pass / 10 fail is the reported cost of finding\n * that out by hand.\n *\n * So a `Middleware` implementation that is in the graph, is not attached by\n * `@UseGuards`, and was not passed here is worth one line on `console.warn` -\n * `console`, not the bound `Logger`, because a suite asserting on a\n * `RecordingLogger` should not see an entry the application never wrote.\n */\nconst warnAboutGlobals = (\n  app: HttpApp,\n  modules: readonly ResolvedModule[],\n): void => {\n  const declared = declaredMiddleware(modules);\n  if (declared.length === 0) return;\n  const scoped = scopedGuards(app, modules);\n  const orphaned = declared.filter(\n    (ctor) => !scoped.has(ctor as Ctor<Middleware>),\n  );\n  if (orphaned.length === 0) return;\n\n  console.warn(\n    `createTestServer: ${orphaned.map((ctor) => ctor.name).join(', ')} ` +\n      'implement Middleware and are in the graph under test, but no `middleware` ' +\n      'was supplied. If they are global in main.ts then this fixture is not the ' +\n      'application: no global guard runs and `onError` is the default mapper. ' +\n      'Export one httpOptions(config) and give it to both, or pass ' +\n      '`middleware: []` to say the omission is deliberate.',\n  );\n};\n\n/**\n * A **real** `Bun.serve` on port 0, with the same override semantics as\n * {@link createTestApp}. Nothing is faked: `Bun.serve` binds in about a\n * millisecond, and a fake would only be able to prove the parts of the request\n * path dunx wrote rather than the parts Bun owns - routing, params, method\n * dispatch, upgrades.\n *\n * ```ts\n * const server = await createTestServer({ modules: [ApiModule], prefix: 'api' });\n * const { status, body } = await server.json('api/users');\n * await server.close();\n * ```\n *\n * Request logging and boot logging are both **off** unless asked for: they are on by\n * default in production for good reasons, none of which apply to a suite that would\n * print one JSON line per assertion and one route table per file.\n *\n * **An `HttpOptions` field not passed is absent, not inherited from production.**\n * `middleware` (where global guards live) and `onError` are the two that change\n * what the application does, so pass the same object `main.ts` passes - one\n * exported `httpOptions(config)` spread into both. Omitting `middleware` in a graph\n * that declares a `Middleware` no `@UseGuards` attaches writes one line to\n * `console.warn`; `middleware: []` says the omission is deliberate.\n */\nexport const createTestServer = async (\n  options: TestServerOptions,\n): Promise<TestServer> => {\n  const { modules, overrides, prefix, requestLogging, bootLogging, ...http } =\n    options;\n\n  const root = testRoot(modules);\n  const app = await HttpFactory.create(root, {\n    ...http,\n    ...appOptions(overrides),\n    requestLogging: requestLogging ?? false,\n    // Off for the same reason: a suite that boots a server per file does not want a\n    // route table per file. A suite asserting on the table asks for it.\n    bootLogging: bootLogging ?? false,\n    port: 0,\n  });\n  if (http.middleware === undefined)\n    warnAboutGlobals(app, collectModules(root));\n  if (prefix !== undefined) app.setGlobalPrefix(prefix);\n\n  return {\n    ...testClient(await app.listen()),\n    app,\n    close: () => app.shutdown(),\n  };\n};\n"
   ],
   "mappings": ";;AAAA;AAAA;AAAA;AAAA;AAcA,MAAM,WAAW;AAAC;AAUlB,IAAM,SAAS,CACb,YACoC,MAAM,QAAQ,OAAO;AAOpD,IAAM,WAAW,CACtB,aACmB;AAAA,EACnB,QAAQ;AAAA,EACR,SAAS,OAAO,OAAO,IAAI,UAAU,CAAC,OAAO;AAC/C;AAGO,IAAM,aAAa,CACxB,cACgB,YAAY,EAAE,UAAU,IAAI,CAAC;AAiBxC,IAAM,gBAAgB,CAAC,YAC5B,WAAW,OAAO,SAAS,QAAQ,OAAO,GAAG,WAAW,QAAQ,SAAS,CAAC;;ACrC5E,IAAM,SAAS,CAAC,MAAc,SAAsB,IAAI,IAAI,MAAM,IAAI;AAEtE,IAAM,WAAW,CAAC,SAAgC;AAAA,EAChD,QAAQ,SAAS,SAAS;AAAA,EAC1B,IAAI,SAAS;AAAA,IAAW,OAAO;AAAA,EAE/B,MAAM,UAAU,IAAI,QAAQ,KAAK,OAAO;AAAA,EACxC,IAAI,CAAC,QAAQ,IAAI,cAAc,GAAG;AAAA,IAChC,QAAQ,IAAI,gBAAgB,kBAAkB;AAAA,EAChD;AAAA,EACA,OAAO,KAAK,MAAM,SAAS,MAAM,KAAK,UAAU,IAAI,EAAE;AAAA;AAYjD,IAAM,aAAa,CAAC,SAA6B;AAAA,EACtD;AAAA,EACA,SAAS,CAAC,OAAO,IAAI,OAAiB,CAAC,MACrC,MAAM,OAAO,KAAK,IAAI,GAAG,SAAS,IAAI,CAAC;AAAA,EACzC,MAAM,OAAU,OAAO,IAAI,OAAiB,CAAC,MAAgC;AAAA,IAC3E,MAAM,WAAW,MAAM,MAAM,OAAO,KAAK,IAAI,GAAG,SAAS,IAAI,CAAC;AAAA,IAI9D,MAAM,OAAO,MAAM,SAAS,KAAK;AAAA,IACjC,IAAI;AAAA,MACF,OAAO;AAAA,QACL,QAAQ,SAAS;AAAA,QACjB,SAAS,SAAS;AAAA,QAClB,MAAM,KAAK,MAAM,IAAI;AAAA,MACvB;AAAA,MACA,MAAM;AAAA,MACN,MAAM,OACJ,SAAS,KACL,kBACA,KAAK,SAAS,QAAQ,IAAI,cAAc,KAAK;AAAA;AAAA,IAC7C,KAAK,MAAM,GAAG,GAAG;AAAA,MACvB,MAAM,IAAI,MACR,GAAG,KAAK,UAAU,SAAS,OAAO,KAAK,IAAI,EAAE,uBAC3C,GAAG,SAAS,eAAe;AAAA;AAAA,qCAC3B,6BACJ;AAAA;AAAA;AAGN;;AC3EA;AAAA;AA2BO,MAAM,wBAAwB,OAAO;AAAA,EAEjC,WAAqB,SAAS;AAAA,EAC9B,UAAyB,CAAC;AAAA,EAEnC,OAAO,CAAC,YAAwB,QAAyB;AAAA,IACvD,KAAK,QAAQ,SAAS,SAAS,SAAS,MAAM;AAAA;AAAA,EAGhD,KAAK,CAAC,YAAwB,QAAyB;AAAA,IACrD,KAAK,QAAQ,SAAS,OAAO,SAAS,MAAM;AAAA;AAAA,EAG9C,IAAI,CAAC,YAAwB,QAAyB;AAAA,IACpD,KAAK,QAAQ,SAAS,MAAM,SAAS,MAAM;AAAA;AAAA,EAI7C,GAAG,CAAC,YAAwB,QAAyB;AAAA,IACnD,KAAK,QAAQ,SAAS,MAAM,SAAS,MAAM;AAAA;AAAA,EAG7C,IAAI,CAAC,YAAwB,QAAyB;AAAA,IACpD,KAAK,QAAQ,SAAS,MAAM,SAAS,MAAM;AAAA;AAAA,EAG7C,KAAK,CAAC,YAAwB,QAAyB;AAAA,IACrD,KAAK,QAAQ,SAAS,OAAO,SAAS,MAAM;AAAA;AAAA,EAG9C,KAAK,CAAC,YAAwB,QAAyB;AAAA,IACrD,KAAK,QAAQ,SAAS,OAAO,SAAS,MAAM;AAAA;AAAA,EAG9C,EAAE,CAAC,OAAyC;AAAA,IAC1C,OAAO,KAAK,QAAQ,OAAO,CAAC,UAAU,MAAM,UAAU,KAAK;AAAA;AAAA,EAG7D,KAAK,GAAS;AAAA,IACZ,KAAK,QAAQ,SAAS;AAAA;AAAA,EAGxB,OAAO,CACL,OACA,SACA,QACM;AAAA,IACN,KAAK,QAAQ,KAAK,EAAE,OAAO,SAAS,OAAO,CAAC;AAAA;AAEhD;;AC5EA;AAAA;AAAA;AAAA;AAMA;AAAA;AAAA;AAAA;AA6BA,IAAM,mBAAmB,CAAC,SACxB,OAAQ,KAAK,WAAgD,WAC7D;AAGF,IAAM,qBAAqB,CACzB,YAC6B;AAAA,EAC7B,MAAM,QAAyB,CAAC;AAAA,EAChC,WAAW,UAAU,SAAS;AAAA,IAC5B,WAAW,SAAS,OAAO,QAAQ,aAAa,CAAC,GAAG;AAAA,MAClD,MAAM,OACJ,OAAO,UAAU,aACb,QACA,MAAM,SAAS,SAAS,UACtB,MAAM,SAAS,OACf;AAAA,MACR,IAAI,SAAS,aAAa,iBAAiB,IAAI;AAAA,QAAG,MAAM,KAAK,IAAI;AAAA,IACnE;AAAA,EACF;AAAA,EACA,OAAO;AAAA;AAOT,IAAM,eAAe,CACnB,KACA,YACkC;AAAA,EAClC,MAAM,UAAU,IAAI;AAAA,EACpB,WAAW,UAAU,SAAS;AAAA,IAC5B,WAAW,cAAc,gBAAgB,MAAM,GAAG;AAAA,MAChD,WAAW,SAAS,eAAe,IAAI,IAAI,UAAU,CAAW,GAAG;AAAA,QACjE,WAAW,SAAS,MAAM,UAAU,CAAC;AAAA,UAAG,QAAQ,IAAI,KAAK;AAAA,MAC3D;AAAA,IACF;AAAA,EACF;AAAA,EACA,OAAO;AAAA;AAeT,IAAM,mBAAmB,CACvB,KACA,YACS;AAAA,EACT,MAAM,WAAW,mBAAmB,OAAO;AAAA,EAC3C,IAAI,SAAS,WAAW;AAAA,IAAG;AAAA,EAC3B,MAAM,SAAS,aAAa,KAAK,OAAO;AAAA,EACxC,MAAM,WAAW,SAAS,OACxB,CAAC,SAAS,CAAC,OAAO,IAAI,IAAwB,CAChD;AAAA,EACA,IAAI,SAAS,WAAW;AAAA,IAAG;AAAA,EAE3B,QAAQ,KACN,qBAAqB,SAAS,IAAI,CAAC,SAAS,KAAK,IAAI,EAAE,KAAK,IAAI,OAC9D,+EACA,8EACA,4EACA,iEACA,qDACJ;AAAA;AA2BK,IAAM,mBAAmB,OAC9B,YACwB;AAAA,EACxB,QAAQ,SAAS,WAAW,QAAQ,gBAAgB,gBAAgB,SAClE;AAAA,EAEF,MAAM,OAAO,SAAS,OAAO;AAAA,EAC7B,MAAM,MAAM,MAAM,YAAY,OAAO,MAAM;AAAA,OACtC;AAAA,OACA,WAAW,SAAS;AAAA,IACvB,gBAAgB,kBAAkB;AAAA,IAGlC,aAAa,eAAe;AAAA,IAC5B,MAAM;AAAA,EACR,CAAC;AAAA,EACD,IAAI,KAAK,eAAe;AAAA,IACtB,iBAAiB,KAAK,eAAe,IAAI,CAAC;AAAA,EAC5C,IAAI,WAAW;AAAA,IAAW,IAAI,gBAAgB,MAAM;AAAA,EAEpD,OAAO;AAAA,OACF,WAAW,MAAM,IAAI,OAAO,CAAC;AAAA,IAChC;AAAA,IACA,OAAO,MAAM,IAAI,SAAS;AAAA,EAC5B;AAAA;",
-  "debugId": "1573B94CB0D606A564756E2164756E21",
+  "debugId": "542D5DFC23443AC664756E2164756E21",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dunx/testing",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Test harness for dunx apps: a container with providers replaced in place, and a real Bun.serve on port 0",
   "keywords": [
     "bun",
@@ -51,8 +51,8 @@
     "@dunx/http": "workspace:*"
   },
   "peerDependencies": {
-    "@dunx/core": "^2.2.0",
-    "@dunx/http": "^2.2.0",
+    "@dunx/core": "^2.3.0",
+    "@dunx/http": "^2.3.0",
     "@types/bun": ">=1.3.0"
   },
   "peerDependenciesMeta": {