@forinda/kickjs-testing 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Felix Orinda
+
+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/dist/index.d.ts

@@ -0,0 +1,34 @@
+import { AppModuleClass, Container, ModuleRoutes } from '@forinda/kickjs-core';
+import { Application } from '@forinda/kickjs-http';
+
+/**
+ * Options for creating a test application.
+ * Disables helmet, cors, compression, and morgan by default.
+ */
+interface CreateTestAppOptions {
+    modules: AppModuleClass[];
+    overrides?: Record<symbol | string, any>;
+    port?: number;
+    apiPrefix?: string;
+    defaultVersion?: number;
+}
+/**
+ * Create an Application instance configured for testing.
+ * Resets the DI container, registers modules, applies overrides,
+ * and returns both the Application and its Express app.
+ */
+declare function createTestApp(options: CreateTestAppOptions): {
+    app: Application;
+    expressApp: any;
+    container: Container;
+};
+/**
+ * Build a quick TestModule that explicitly registers dependencies.
+ * Useful for integration tests that need to control the DI graph.
+ */
+declare function createTestModule(config: {
+    register: (container: Container) => void;
+    routes: () => ModuleRoutes | ModuleRoutes[];
+}): AppModuleClass;
+
+export { type CreateTestAppOptions, createTestApp, createTestModule };

package/dist/index.js

@@ -0,0 +1,49 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+
+// src/index.ts
+import { Container } from "@forinda/kickjs-core";
+import { Application } from "@forinda/kickjs-http";
+function createTestApp(options) {
+  Container.reset();
+  const container = Container.getInstance();
+  const app = new Application({
+    modules: options.modules,
+    port: options.port,
+    apiPrefix: options.apiPrefix,
+    defaultVersion: options.defaultVersion,
+    // Use minimal middleware for testing — no helmet, cors, compression, etc.
+    middleware: []
+  });
+  if (options.overrides) {
+    for (const token of Reflect.ownKeys(options.overrides)) {
+      container.registerInstance(token, options.overrides[token]);
+    }
+  }
+  app.setup();
+  return {
+    app,
+    expressApp: app.getExpressApp(),
+    container
+  };
+}
+__name(createTestApp, "createTestApp");
+function createTestModule(config) {
+  return class TestModule {
+    static {
+      __name(this, "TestModule");
+    }
+    register(container) {
+      config.register(container);
+    }
+    routes() {
+      return config.routes();
+    }
+  };
+}
+__name(createTestModule, "createTestModule");
+export {
+  createTestApp,
+  createTestModule
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  Container,\n  type AppModule,\n  type AppModuleClass,\n  type ModuleRoutes,\n} from '@forinda/kickjs-core'\nimport { Application, type ApplicationOptions } from '@forinda/kickjs-http'\n\n/**\n * Options for creating a test application.\n * Disables helmet, cors, compression, and morgan by default.\n */\nexport interface CreateTestAppOptions {\n  modules: AppModuleClass[]\n  overrides?: Record<symbol | string, any>\n  port?: number\n  apiPrefix?: string\n  defaultVersion?: number\n}\n\n/**\n * Create an Application instance configured for testing.\n * Resets the DI container, registers modules, applies overrides,\n * and returns both the Application and its Express app.\n */\nexport function createTestApp(options: CreateTestAppOptions): {\n  app: Application\n  expressApp: any\n  container: Container\n} {\n  Container.reset()\n  const container = Container.getInstance()\n\n  const app = new Application({\n    modules: options.modules,\n    port: options.port,\n    apiPrefix: options.apiPrefix,\n    defaultVersion: options.defaultVersion,\n    // Use minimal middleware for testing — no helmet, cors, compression, etc.\n    middleware: [],\n  })\n\n  // Apply DI overrides (e.g. mock repositories)\n  // Use Reflect.ownKeys to iterate both string and symbol keys\n  if (options.overrides) {\n    for (const token of Reflect.ownKeys(options.overrides)) {\n      container.registerInstance(token, options.overrides[token as any])\n    }\n  }\n\n  // Run setup without starting the HTTP server\n  app.setup()\n\n  return {\n    app,\n    expressApp: app.getExpressApp(),\n    container,\n  }\n}\n\n/**\n * Build a quick TestModule that explicitly registers dependencies.\n * Useful for integration tests that need to control the DI graph.\n */\nexport function createTestModule(config: {\n  register: (container: Container) => void\n  routes: () => ModuleRoutes | ModuleRoutes[]\n}): AppModuleClass {\n  return class TestModule implements AppModule {\n    register(container: Container) {\n      config.register(container)\n    }\n    routes() {\n      return config.routes()\n    }\n  } as AppModuleClass\n}\n"],"mappings":";;;;AAAA,SACEA,iBAIK;AACP,SAASC,mBAA4C;AAmB9C,SAASC,cAAcC,SAA6B;AAKzDC,YAAUC,MAAK;AACf,QAAMC,YAAYF,UAAUG,YAAW;AAEvC,QAAMC,MAAM,IAAIC,YAAY;IAC1BC,SAASP,QAAQO;IACjBC,MAAMR,QAAQQ;IACdC,WAAWT,QAAQS;IACnBC,gBAAgBV,QAAQU;;IAExBC,YAAY,CAAA;EACd,CAAA;AAIA,MAAIX,QAAQY,WAAW;AACrB,eAAWC,SAASC,QAAQC,QAAQf,QAAQY,SAAS,GAAG;AACtDT,gBAAUa,iBAAiBH,OAAOb,QAAQY,UAAUC,KAAAA,CAAa;IACnE;EACF;AAGAR,MAAIY,MAAK;AAET,SAAO;IACLZ;IACAa,YAAYb,IAAIc,cAAa;IAC7BhB;EACF;AACF;AAjCgBJ;AAuCT,SAASqB,iBAAiBC,QAGhC;AACC,SAAO,MAAMC,WAAAA;IApEf,OAoEeA;;;IACXC,SAASpB,WAAsB;AAC7BkB,aAAOE,SAASpB,SAAAA;IAClB;IACAqB,SAAS;AACP,aAAOH,OAAOG,OAAM;IACtB;EACF;AACF;AAZgBJ;","names":["Container","Application","createTestApp","options","Container","reset","container","getInstance","app","Application","modules","port","apiPrefix","defaultVersion","middleware","overrides","token","Reflect","ownKeys","registerInstance","setup","expressApp","getExpressApp","createTestModule","config","TestModule","register","routes"]}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@forinda/kickjs-testing",
+  "version": "0.3.0",
+  "description": "Test utilities, TestModule builder, and helpers for KickJS applications",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@forinda/kickjs-core": "0.3.0",
+    "@forinda/kickjs-http": "0.3.0"
+  },
+  "devDependencies": {
+    "@swc/core": "^1.7.28",
+    "@types/express": "^5.0.6",
+    "@types/node": "^24.5.2",
+    "express": "^5.1.0",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Felix Orinda",
+  "engines": {
+    "node": ">=20.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist .turbo",
+    "lint": "tsc --noEmit"
+  }
+}