@map-colonies/openapi-helpers 5.0.0 → 5.1.0

package/README.md

@@ -187,6 +187,87 @@ const response = await requestSender.sendRequest({
 
 The package supports all the operations defined in the OpenAPI schema, either by operation name, or by using the `sendRequest` function with the method, path and parameters.
 
+### Response Status Assertion
+
+The `expectResponseStatusFactory` provides TypeScript type narrowing for response status assertions in tests. This utility creates an assertion function that narrows the response type based on the expected status code, giving you full type safety when working with different response types.
+
+#### Usage
+
+```typescript
+import { expectResponseStatusFactory } from '@map-colonies/openapi-helpers/requestSender';
+import type { ExpectResponseStatus } from '@map-colonies/openapi-helpers/requestSender';
+import { describe, it, expect } from 'vitest';
+
+// Create the assertion function with the exported type
+const expectResponseStatus: ExpectResponseStatus = expectResponseStatusFactory(expect);
+
+it('should return user data on success', async () => {
+  const response = await requestSender.getUser({ pathParams: { id: '123' } });
+  
+  // Assert the status and narrow the type
+  expectResponseStatus(response, 200);
+  
+  // TypeScript now knows response is the 200 response type
+  // You can safely access response.body with full autocomplete
+  console.log(response.body.id);
+  console.log(response.body.name);
+});
+
+it('should handle error responses', async () => {
+  const response = await requestSender.getUser({ pathParams: { id: 'invalid' } });
+  
+  if (response.status === 404) {
+    expectResponseStatus(response, 404);
+    // TypeScript knows this is a 404 response
+    console.log(response.body.error);
+  }
+});
+```
+
+> [!TIP]
+> **Avoiding TS2775 Error**: When using `expectResponseStatusFactory`, you must provide an explicit type annotation using the exported `ExpectResponseStatus` type as shown above. This is required by TypeScript's strict mode for assertion functions.
+
+#### Reusable Setup
+
+To avoid repeating the setup in every test file, create a shared test utility:
+
+```typescript
+// test/utils/assertions.ts
+import { expectResponseStatusFactory } from '@map-colonies/openapi-helpers/requestSender';
+import type { ExpectResponseStatus } from '@map-colonies/openapi-helpers/requestSender';
+import { expect } from 'vitest';
+
+export const expectResponseStatus: ExpectResponseStatus = expectResponseStatusFactory(expect);
+```
+
+Then import and use it in your tests:
+
+```typescript
+// test/api.spec.ts
+import { expectResponseStatus } from './utils/assertions';
+
+it('should work', async () => {
+  const response = await requestSender.getUser({ pathParams: { id: '123' } });
+  expectResponseStatus(response, 200);
+  // TypeScript knows the exact response type
+});
+```
+
+#### How it works
+
+The `expectResponseStatusFactory` takes an expect function (from your test framework) and returns a function that:
+1. Asserts that the response status matches the expected status
+2. Narrows the TypeScript type of the response to only include the matching status code
+
+This is particularly useful when working with OpenAPI-generated types that have multiple possible response types (e.g., 200 success, 404 not found, 500 error). After calling `expectResponseStatus`, TypeScript will know exactly which response type you're working with.
+
+#### Benefits
+
+- **Type Safety**: Full TypeScript support with automatic type narrowing
+- **Autocomplete**: Get accurate autocomplete for response body based on the status code
+- **Test Clarity**: Combine assertion and type narrowing in a single function call
+- **Prevents Errors**: Catch type mismatches at compile time instead of runtime
+
 
 > [!IMPORTANT]
 > For the package to function properly, you need to make sure that the following values are configured in your `tsconfig.json` or `jsconfig.json` files under compilerOptions:

package/dist/requestSender/expect.d.ts

@@ -0,0 +1,38 @@
+type Status = number | string;
+interface Response {
+    status: Status;
+}
+interface Expect {
+    (actual: unknown): {
+        toBe: (expected: unknown) => void;
+    };
+}
+/**
+ * Type for the assertion function returned by expectResponseStatusFactory
+ * @public
+ */
+export type ExpectResponseStatus = <TResponse extends Response, TStatus extends TResponse['status']>(res: TResponse, expectedStatus: TStatus) => asserts res is Extract<TResponse, {
+    status: TStatus;
+}>;
+/**
+ * Creates a function to assert that the response status matches the expected status
+ * It forces TypeScript to narrow the response type based on the expected status
+ *
+ * @example
+ * ```typescript
+ * import { expectResponseStatusFactory } from '@map-colonies/openapi-helpers/requestSender';
+ * import type { ExpectResponseStatus } from '@map-colonies/openapi-helpers/requestSender';
+ * import { expect } from 'vitest';
+ *
+ * const expectResponseStatus: ExpectResponseStatus = expectResponseStatusFactory(expect);
+ *
+ * // Now use it in tests
+ * const response = await requestSender.getUser({ pathParams: { id: '123' } });
+ * expectResponseStatus(response, 200);
+ * // TypeScript now knows response is the 200 response type
+ * ```
+ * @public
+ */
+export declare function expectResponseStatusFactory(expect: Expect): ExpectResponseStatus;
+export {};
+//# sourceMappingURL=expect.d.ts.map

package/dist/requestSender/expect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect.d.ts","sourceRoot":"","sources":["../../src/requestSender/expect.ts"],"names":[],"mappings":"AAAA,KAAK,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9B,UAAU,QAAQ;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,MAAM;IACd,CAAC,MAAM,EAAE,OAAO,GAAG;QACjB,IAAI,EAAE,CAAC,QAAQ,EAAE,OAAO,KAAK,IAAI,CAAC;KACnC,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,SAAS,SAAS,QAAQ,EAAE,OAAO,SAAS,SAAS,CAAC,QAAQ,CAAC,EACjG,GAAG,EAAE,SAAS,EACd,cAAc,EAAE,OAAO,KACpB,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,SAAS,EAAE;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,oBAAoB,CAIhF"}

package/dist/requestSender/expect.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectResponseStatusFactory = expectResponseStatusFactory;
+/**
+ * Creates a function to assert that the response status matches the expected status
+ * It forces TypeScript to narrow the response type based on the expected status
+ *
+ * @example
+ * ```typescript
+ * import { expectResponseStatusFactory } from '@map-colonies/openapi-helpers/requestSender';
+ * import type { ExpectResponseStatus } from '@map-colonies/openapi-helpers/requestSender';
+ * import { expect } from 'vitest';
+ *
+ * const expectResponseStatus: ExpectResponseStatus = expectResponseStatusFactory(expect);
+ *
+ * // Now use it in tests
+ * const response = await requestSender.getUser({ pathParams: { id: '123' } });
+ * expectResponseStatus(response, 200);
+ * // TypeScript now knows response is the 200 response type
+ * ```
+ * @public
+ */
+function expectResponseStatusFactory(expect) {
+    return (res, expectedStatus) => {
+        expect(res.status).toBe(expectedStatus);
+    };
+}
+//# sourceMappingURL=expect.js.map

package/dist/requestSender/expect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expect.js","sourceRoot":"","sources":["../../src/requestSender/expect.ts"],"names":[],"mappings":";;AAwCA,kEAIC;AAvBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,2BAA2B,CAAC,MAAc;IACxD,OAAO,CAAC,GAAG,EAAE,cAAc,EAAE,EAAE;QAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC1C,CAAC,CAAC;AACJ,CAAC"}

package/dist/requestSender/requestSender.d.ts

@@ -1,7 +1,9 @@
 import type express from 'express';
 import { PathsTemplate, OperationsTemplate } from '../common/types';
+import { expectResponseStatusFactory } from './expect';
+import type { ExpectResponseStatus } from './expect';
 import type { RequestSender, RequestSenderOptions } from './types';
-export { RequestSender };
+export { RequestSender, expectResponseStatusFactory, ExpectResponseStatus };
 /**
  * Creates a request sender object that can be used to send fake HTTP requests using supertest based on an OpenAPI specification.
  * The openapi types should be generated using the openapi-typescript package.

package/dist/requestSender/requestSender.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requestSender.d.ts","sourceRoot":"","sources":["../../src/requestSender/requestSender.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,OAAO,EAAE,aAAa,EAAW,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,KAAK,EAAuD,aAAa,EAAiB,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAsFvI,OAAO,EAAE,aAAa,EAAE,CAAC;AAEzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,SAAS,aAAa,GAAG,KAAK,EAAE,UAAU,SAAS,kBAAkB,GAAG,KAAK,EAC1H,eAAe,EAAE,UAAU,SAAS,KAAK,GAAG,KAAK,GAAG,MAAM,EAC1D,GAAG,EAAE,OAAO,CAAC,WAAW,EACxB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAsB3C"}
+{"version":3,"file":"requestSender.d.ts","sourceRoot":"","sources":["../../src/requestSender/requestSender.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,OAAO,EAAE,aAAa,EAAW,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAC7E,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAuD,aAAa,EAAiB,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAsFvI,OAAO,EAAE,aAAa,EAAE,2BAA2B,EAAE,oBAAoB,EAAE,CAAC;AAE5E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAsB,mBAAmB,CAAC,KAAK,SAAS,aAAa,GAAG,KAAK,EAAE,UAAU,SAAS,kBAAkB,GAAG,KAAK,EAC1H,eAAe,EAAE,UAAU,SAAS,KAAK,GAAG,KAAK,GAAG,MAAM,EAC1D,GAAG,EAAE,OAAO,CAAC,WAAW,EACxB,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAsB3C"}

package/dist/requestSender/requestSender.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.expectResponseStatusFactory = void 0;
 exports.createRequestSender = createRequestSender;
 /**
  * @module requestSender
@@ -10,6 +11,8 @@ exports.createRequestSender = createRequestSender;
 const node_fs_1 = require("node:fs");
 const supertest_1 = __importDefault(require("supertest"));
 const oas_normalize_1 = __importDefault(require("oas-normalize"));
+const expect_1 = require("./expect");
+Object.defineProperty(exports, "expectResponseStatusFactory", { enumerable: true, get: function () { return expect_1.expectResponseStatusFactory; } });
 function sendRequest(app, options, internalOptions = {}) {
     const method = options.method;
     let actualPath = (internalOptions.baseUrl ?? '') + options.path;

package/dist/requestSender/requestSender.js.map

@@ -1 +1 @@
-{"version":3,"file":"requestSender.js","sourceRoot":"","sources":["../../src/requestSender/requestSender.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"requestSender.js","sourceRoot":"","sources":["../../src/requestSender/requestSender.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@map-colonies/openapi-helpers",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "A package that provides utilities for working with openapi files",
   "type": "commonjs",
   "exports": {
@@ -29,15 +29,15 @@
     "node": ">=24"
   },
   "dependencies": {
-    "@apidevtools/json-schema-ref-parser": "^14.1.1",
+    "@apidevtools/json-schema-ref-parser": "^15.0.0",
     "@commander-js/extra-typings": "^14.0.0",
     "change-case": "^5.4.4",
     "commander": "^14.0.0",
     "oas-normalize": "^15.0.0",
-    "ora": "^8.2.0",
+    "ora": "^9.0.0",
     "ts-essentials": "^10.1.1",
     "yaml": "^2.8.0",
-    "@map-colonies/read-pkg": "^1.0.0"
+    "@map-colonies/read-pkg": "^2.0.0"
   },
   "peerDependencies": {
     "@types/express": "^4.17.21",
@@ -46,18 +46,18 @@
     "supertest": "^7.0.0"
   },
   "devDependencies": {
-    "@types/supertest": "6.0.2",
-    "@types/node": "24.0.0",
+    "@types/supertest": "6.0.3",
+    "@types/node": "24.10.9",
     "@types/body-parser": "1.19.6",
     "openapi-types": "12.1.3",
-    "body-parser": "2.2.1",
+    "body-parser": "2.2.2",
     "eslint": "^9.39.1",
     "express": "5.2.1",
     "rimraf": "^6.1.2",
     "typescript": "5.9.3",
     "vitest": "^4.0.15",
     "@microsoft/api-extractor": "^7.55.2",
-    "@map-colonies/eslint-config": "^7.0.0",
+    "@map-colonies/eslint-config": "^7.1.0",
     "@map-colonies/tsconfig": "^2.0.0",
     "vitest-config": "^0.0.0"
   },