@blixis-io/testing 0.0.0 → 0.1.3

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Michael Voeten
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,24 @@
-placeholder
+# `@blixis-io/testing`
+
+A thin testing layer on top of `@blixis-io/http`. Build a real application in a test, override providers with fakes, hit it with real requests.
+
+```bash
+npm install -D @blixis-io/testing
+```
+
+```ts
+import { Test } from "@blixis-io/testing";
+
+const app = await Test.createModule({ imports: [PostsModule] })
+  .override(PostRepository, { useValue: fakeRepo })
+  .compile();
+
+const res = await app.request("/posts");
+expect(res.status).toBe(200);
+
+await app.close();
+```
+
+`compile()` builds a full `HttpApplication`, exactly the way `createHttpApplication` would in production — nothing about request handling, validation, or guards is mocked. `.override()` swaps in a fake for one provider before the module graph resolves.
+
+Part of [Blixis Framework](https://github.com/blixis-io/framework) — full docs: [Testing](https://blixis-io.github.io/framework/concepts/testing/) · [API reference](https://blixis-io.github.io/framework/reference/blixis-testing/).

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { ModuleMetadata } from "@blixis-io/core";
+import { HttpApplication, HttpApplicationOptions } from "@blixis-io/http";
+import { ClassProvider, ExistingProvider, FactoryProvider, Token, ValueProvider } from "@blixis-io/di";
+//#region src/test-application.d.ts
+interface TestRequestInit extends Omit<RequestInit, "body"> {
+  body?: RequestInit["body"];
+  /** JSON-stringified into the body, with `content-type: application/json` set automatically. */
+  json?: unknown;
+}
+/** Thin sugar over `HttpApplication` for tests: a `request()` helper that builds absolute URLs and JSON bodies. */
+export declare class TestApplication {
+  private readonly app;
+  constructor(app: HttpApplication);
+  request(path: string, init?: TestRequestInit): Promise<Response>;
+  get<T>(token: Token<T>): T;
+  close(signal?: string): Promise<void>;
+}
+//#endregion
+//#region src/test-module-builder.d.ts
+type OverrideDefinition<T> = Omit<ClassProvider<T>, "provide"> | Omit<ValueProvider<T>, "provide"> | Omit<FactoryProvider<T>, "provide"> | Omit<ExistingProvider<T>, "provide">;
+export declare class TestModuleBuilder {
+  #private;
+  constructor(metadata: ModuleMetadata);
+  /** Replaces the provider registered under `token` with `definition`, applied before the module graph resolves. */
+  override<T>(token: Token<T>, definition: OverrideDefinition<T>): this;
+  compile(options?: Omit<HttpApplicationOptions, "overrides">): Promise<TestApplication>;
+}
+export declare const Test: {
+  createModule(metadata?: ModuleMetadata): TestModuleBuilder;
+};
+//#endregion
+export type { OverrideDefinition, TestRequestInit };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/test-application.ts","../src/test-module-builder.ts"],"mappings":";;;;UAGiB,wBAAwB,KAAK;EAC5C,OAAO;;EAEP;;;qBAMW;mBACkB;EAA7B,YAA6B,KAAK;EAE5B,QAAQ,cAAc,OAAM,kBAAuB,QAAQ;EAejE,IAAI,GAAG,OAAO,MAAM,KAAK;EAInB,MAAM,kBAAkB;;;;KC5BpB,mBAAmB,KAC3B,KAAK,cAAc,iBACnB,KAAK,cAAc,iBACnB,KAAK,gBAAgB,iBACrB,KAAK,iBAAiB;qBAEb;;EAIX,YAAY,UAAU;;EAKtB,SAAS,GAAG,OAAO,MAAM,IAAI,YAAY,mBAAmB;EAKtD,QAAQ,UAAS,KAAK,uCAA4C,QAAQ;;qBASrE;EACX,aAAY,WAAW,iBAAsB"}

package/dist/index.js

@@ -0,0 +1,70 @@
+import { Module } from "@blixis-io/core";
+import { createHttpApplication } from "@blixis-io/http";
+//#region src/test-application.ts
+const BASE_URL = "http://localhost";
+/** Thin sugar over `HttpApplication` for tests: a `request()` helper that builds absolute URLs and JSON bodies. */
+var TestApplication = class {
+	constructor(app) {
+		this.app = app;
+	}
+	async request(path, init = {}) {
+		const { json, headers, body, ...rest } = init;
+		const finalHeaders = new Headers(headers);
+		let finalBody = body;
+		if (json !== void 0) {
+			finalHeaders.set("content-type", "application/json");
+			finalBody = JSON.stringify(json);
+		}
+		return this.app.handle(new Request(new URL(path, BASE_URL), {
+			...rest,
+			headers: finalHeaders,
+			...finalBody !== void 0 ? { body: finalBody } : {}
+		}));
+	}
+	get(token) {
+		return this.app.get(token);
+	}
+	async close(signal) {
+		await this.app.close(signal);
+	}
+};
+//#endregion
+//#region \0@oxc-project+runtime@0.151.0/helpers/esm/decorate.js
+function __decorate(decorators, target, key, desc) {
+	var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+	if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+	else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+	return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+//#endregion
+//#region src/test-module-builder.ts
+var TestModuleBuilder = class {
+	#metadata;
+	#overrides = [];
+	constructor(metadata) {
+		this.#metadata = metadata;
+	}
+	/** Replaces the provider registered under `token` with `definition`, applied before the module graph resolves. */
+	override(token, definition) {
+		this.#overrides.push({
+			provide: token,
+			...definition
+		});
+		return this;
+	}
+	async compile(options = {}) {
+		let TestRootModule = class TestRootModule {};
+		TestRootModule = __decorate([Module(this.#metadata)], TestRootModule);
+		return new TestApplication(await createHttpApplication(TestRootModule, {
+			...options,
+			overrides: this.#overrides
+		}));
+	}
+};
+const Test = { createModule(metadata = {}) {
+	return new TestModuleBuilder(metadata);
+} };
+//#endregion
+export { Test, TestApplication, TestModuleBuilder };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/test-application.ts","../src/test-module-builder.ts"],"sourcesContent":["import type { HttpApplication } from \"@blixis-io/http\";\nimport type { Token } from \"@blixis-io/di\";\n\nexport interface TestRequestInit extends Omit<RequestInit, \"body\"> {\n  body?: RequestInit[\"body\"];\n  /** JSON-stringified into the body, with `content-type: application/json` set automatically. */\n  json?: unknown;\n}\n\nconst BASE_URL = \"http://localhost\";\n\n/** Thin sugar over `HttpApplication` for tests: a `request()` helper that builds absolute URLs and JSON bodies. */\nexport class TestApplication {\n  constructor(private readonly app: HttpApplication) {}\n\n  async request(path: string, init: TestRequestInit = {}): Promise<Response> {\n    const { json, headers, body, ...rest } = init;\n    const finalHeaders = new Headers(headers);\n    let finalBody = body;\n\n    if (json !== undefined) {\n      finalHeaders.set(\"content-type\", \"application/json\");\n      finalBody = JSON.stringify(json);\n    }\n\n    return this.app.handle(\n      new Request(new URL(path, BASE_URL), { ...rest, headers: finalHeaders, ...(finalBody !== undefined ? { body: finalBody } : {}) }),\n    );\n  }\n\n  get<T>(token: Token<T>): T {\n    return this.app.get(token);\n  }\n\n  async close(signal?: string): Promise<void> {\n    await this.app.close(signal);\n  }\n}\n","import type { ModuleMetadata } from \"@blixis-io/core\";\nimport { Module } from \"@blixis-io/core\";\nimport type { ClassProvider, ExistingProvider, FactoryProvider, Provider, Token, ValueProvider } from \"@blixis-io/di\";\nimport { createHttpApplication, type HttpApplicationOptions } from \"@blixis-io/http\";\nimport { TestApplication } from \"./test-application.js\";\n\nexport type OverrideDefinition<T> =\n  | Omit<ClassProvider<T>, \"provide\">\n  | Omit<ValueProvider<T>, \"provide\">\n  | Omit<FactoryProvider<T>, \"provide\">\n  | Omit<ExistingProvider<T>, \"provide\">;\n\nexport class TestModuleBuilder {\n  #metadata: ModuleMetadata;\n  #overrides: Provider[] = [];\n\n  constructor(metadata: ModuleMetadata) {\n    this.#metadata = metadata;\n  }\n\n  /** Replaces the provider registered under `token` with `definition`, applied before the module graph resolves. */\n  override<T>(token: Token<T>, definition: OverrideDefinition<T>): this {\n    this.#overrides.push({ provide: token, ...definition });\n    return this;\n  }\n\n  async compile(options: Omit<HttpApplicationOptions, \"overrides\"> = {}): Promise<TestApplication> {\n    @Module(this.#metadata)\n    class TestRootModule {}\n\n    const app = await createHttpApplication(TestRootModule, { ...options, overrides: this.#overrides });\n    return new TestApplication(app);\n  }\n}\n\nexport const Test = {\n  createModule(metadata: ModuleMetadata = {}): TestModuleBuilder {\n    return new TestModuleBuilder(metadata);\n  },\n};\n"],"mappings":";;;AASA,MAAM,WAAW;;AAGjB,IAAa,kBAAb,MAA6B;CAC3B,YAAY,KAAuC;EAAtB,KAAA,MAAA;CAAuB;CAEpD,MAAM,QAAQ,MAAc,OAAwB,CAAC,GAAsB;EACzE,MAAM,EAAE,MAAM,SAAS,MAAM,GAAG,SAAS;EACzC,MAAM,eAAe,IAAI,QAAQ,OAAO;EACxC,IAAI,YAAY;EAEhB,IAAI,SAAS,KAAA,GAAW;GACtB,aAAa,IAAI,gBAAgB,kBAAkB;GACnD,YAAY,KAAK,UAAU,IAAI;EACjC;EAEA,OAAO,KAAK,IAAI,OACd,IAAI,QAAQ,IAAI,IAAI,MAAM,QAAQ,GAAG;GAAE,GAAG;GAAM,SAAS;GAAc,GAAI,cAAc,KAAA,IAAY,EAAE,MAAM,UAAU,IAAI,CAAC;EAAG,CAAC,CAClI;CACF;CAEA,IAAO,OAAoB;EACzB,OAAO,KAAK,IAAI,IAAI,KAAK;CAC3B;CAEA,MAAM,MAAM,QAAgC;EAC1C,MAAM,KAAK,IAAI,MAAM,MAAM;CAC7B;AACF;;;;;;;;;;;ACzBA,IAAa,oBAAb,MAA+B;CAC7B;CACA,aAAyB,CAAC;CAE1B,YAAY,UAA0B;EACpC,KAAK,YAAY;CACnB;;CAGA,SAAY,OAAiB,YAAyC;EACpE,KAAK,WAAW,KAAK;GAAE,SAAS;GAAO,GAAG;EAAW,CAAC;EACtD,OAAO;CACT;CAEA,MAAM,QAAQ,UAAqD,CAAC,GAA6B;EAC/F,IACM,iBADN,MACM,eAAe,CAAC;EADrB,iBAAA,WAAA,CAAA,OAAO,KAAK,SAAS,CAAA,GAAA,cAAA;EAItB,OAAO,IAAI,gBAAgB,MADT,sBAAsB,gBAAgB;GAAE,GAAG;GAAS,WAAW,KAAK;EAAW,CAAC,CACpE;CAChC;AACF;AAEA,MAAa,OAAO,EAClB,aAAa,WAA2B,CAAC,GAAsB;CAC7D,OAAO,IAAI,kBAAkB,QAAQ;AACvC,EACF"}

package/package.json

@@ -1 +1,44 @@
-{ "name": "@blixis-io/testing", "version": "0.0.0", "description": "placeholder" }
+{
+  "name": "@blixis-io/testing",
+  "version": "0.1.3",
+  "description": "A thin testing layer on top of @blixis-io/http. Build a real application in a test, override providers with fakes, hit it with real requests.",
+  "license": "MIT",
+  "author": "Michael Voeten <michael@voeten.online>",
+  "homepage": "https://blixis-io.github.io/framework/",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/blixis-io/framework.git",
+    "directory": "packages/testing"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=24"
+  },
+  "keywords": [
+    "testing",
+    "http",
+    "typescript"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "@blixis-io/source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@blixis-io/core": "0.3.0",
+    "@blixis-io/di": "0.1.1",
+    "@blixis-io/http": "0.3.1"
+  },
+  "scripts": {
+    "typecheck": "tsc -p tsconfig.json",
+    "build": "rolldown -c"
+  }
+}