@keq-request/exception 5.0.0-alpha.17 → 5.0.0-alpha.19

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 5.0.0-alpha.19
+
+### Patch Changes
+
+- 30b0848: rename validateResponse to validateStatusCode
+  - keq@5.0.0-alpha.19
+
+## 5.0.0-alpha.18
+
+### Minor Changes
+
+- 241a2ca: **Feat:** add a validateResponse middleware and plugin use to validate http response and throw standard exception
+
+### Patch Changes
+
+- Updated dependencies [cbc5d17]
+  - keq@5.0.0-alpha.18
+
 ## 5.0.0-alpha.17
 
 ### Patch Changes

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './throw-exception.js';
 export * from './catch-exception.js';
+export * from './validate-status-code.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA;AACpC,cAAc,2BAA2B,CAAA"}

package/dist/index.js

@@ -21,7 +21,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   catchException: () => catchException,
-  throwException: () => throwException
+  throwException: () => throwException,
+  validateStatusCode: () => validateStatusCode
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -43,4 +44,53 @@ function catchException(handler) {
     }
   };
 }
+
+// src/validate-status-code.ts
+var import_keq = require("keq");
+function validateStatusCode() {
+  return async (context, next) => {
+    await next();
+    const response = context.response;
+    if (!response) return;
+    const { status, statusText } = response;
+    if (status >= 200 && status < 300) return;
+    if (status >= 300 && status < 400) return;
+    if (status >= 400 && status < 500) {
+      switch (status) {
+        case 400:
+          throw new import_keq.BadRequestException(statusText);
+        case 401:
+          throw new import_keq.UnauthorizedException(statusText);
+        case 403:
+          throw new import_keq.ForbiddenException(statusText);
+        case 404:
+          throw new import_keq.NotFoundedException(statusText);
+        case 406:
+          throw new import_keq.NotAcceptableException(statusText);
+        case 409:
+          throw new import_keq.ConflictException(statusText);
+        case 412:
+          throw new import_keq.PreconditionFailedException(statusText);
+        case 418:
+          throw new import_keq.ImATeapotException(statusText);
+        default:
+          throw new import_keq.RequestException(status, statusText, false);
+      }
+    }
+    if (status >= 500) {
+      switch (status) {
+        case 500:
+          throw new import_keq.InternalServerErrorException(statusText);
+        case 502:
+          throw new import_keq.BadGatewayException(statusText);
+        case 503:
+          throw new import_keq.ServiceUnavailableException(statusText);
+        case 504:
+          throw new import_keq.GatewayTimeoutException(statusText);
+        default:
+          throw new import_keq.RequestException(status, statusText, true);
+      }
+    }
+  };
+}
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/throw-exception.ts","../src/catch-exception.ts"],"sourcesContent":["export * from './throw-exception.js'\nexport * from './catch-exception.js'\n","import { KeqContext, KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport type Check = (ctx: KeqContext) => Promisable<void>\n\nexport function throwException(check: Check): KeqMiddleware {\n  return async function throwException(ctx, next) {\n    await next()\n\n    await check(ctx)\n  }\n}\n","import { KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport function catchException(handler: (e: unknown) => Promisable<void>): KeqMiddleware {\n  return async function catchException(ctx, next) {\n    try {\n      await next()\n    } catch (err) {\n      await handler(err)\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,SAAS,eAAe,OAA6B;AAC1D,SAAO,eAAeA,gBAAe,KAAK,MAAM;AAC9C,UAAM,KAAK;AAEX,UAAM,MAAM,GAAG;AAAA,EACjB;AACF;;;ACRO,SAAS,eAAe,SAA0D;AACvF,SAAO,eAAeC,gBAAe,KAAK,MAAM;AAC9C,QAAI;AACF,YAAM,KAAK;AAAA,IACb,SAAS,KAAK;AACZ,YAAM,QAAQ,GAAG;AAAA,IACnB;AAAA,EACF;AACF;","names":["throwException","catchException"]}
+{"version":3,"sources":["../src/index.ts","../src/throw-exception.ts","../src/catch-exception.ts","../src/validate-status-code.ts"],"sourcesContent":["export * from './throw-exception.js'\nexport * from './catch-exception.js'\nexport * from './validate-status-code.js'\n","import { KeqContext, KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport type Check = (ctx: KeqContext) => Promisable<void>\n\nexport function throwException(check: Check): KeqMiddleware {\n  return async function throwException(ctx, next) {\n    await next()\n\n    await check(ctx)\n  }\n}\n","import { KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport function catchException(handler: (e: unknown) => Promisable<void>): KeqMiddleware {\n  return async function catchException(ctx, next) {\n    try {\n      await next()\n    } catch (err) {\n      await handler(err)\n    }\n  }\n}\n","import {\n  BadGatewayException,\n  BadRequestException,\n  ConflictException,\n  ForbiddenException,\n  GatewayTimeoutException,\n  InternalServerErrorException,\n  KeqMiddleware,\n  NotAcceptableException,\n  NotFoundedException,\n  PreconditionFailedException,\n  RequestException,\n  ServiceUnavailableException,\n  UnauthorizedException,\n  ImATeapotException,\n} from 'keq'\n\nexport function validateStatusCode(): KeqMiddleware {\n  return async (context, next) => {\n    await next()\n\n    const response = context.response\n    if (!response) return\n\n    const { status, statusText } = response\n\n    // 2xx success status codes - no error\n    if (status >= 200 && status < 300) return\n\n    // 3xx redirection status codes - no error (handled by fetch)\n    if (status >= 300 && status < 400) return\n\n    // 4xx client errors\n    if (status >= 400 && status < 500) {\n      switch (status) {\n      case 400:\n        throw new BadRequestException(statusText)\n      case 401:\n        throw new UnauthorizedException(statusText)\n      case 403:\n        throw new ForbiddenException(statusText)\n      case 404:\n        throw new NotFoundedException(statusText)\n      case 406:\n        throw new NotAcceptableException(statusText)\n      case 409:\n        throw new ConflictException(statusText)\n      case 412:\n        throw new PreconditionFailedException(statusText)\n      case 418:\n        throw new ImATeapotException(statusText)\n      default:\n        // Other 4xx errors, don't retry by default\n        throw new RequestException(status, statusText, false)\n      }\n    }\n\n    // 5xx server errors\n    if (status >= 500) {\n      switch (status) {\n      case 500:\n        throw new InternalServerErrorException(statusText)\n      case 502:\n        throw new BadGatewayException(statusText)\n      case 503:\n        throw new ServiceUnavailableException(statusText)\n      case 504:\n        throw new GatewayTimeoutException(statusText)\n      default:\n        // Other 5xx errors, retry by default\n        throw new RequestException(status, statusText, true)\n      }\n    }\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACMO,SAAS,eAAe,OAA6B;AAC1D,SAAO,eAAeA,gBAAe,KAAK,MAAM;AAC9C,UAAM,KAAK;AAEX,UAAM,MAAM,GAAG;AAAA,EACjB;AACF;;;ACRO,SAAS,eAAe,SAA0D;AACvF,SAAO,eAAeC,gBAAe,KAAK,MAAM;AAC9C,QAAI;AACF,YAAM,KAAK;AAAA,IACb,SAAS,KAAK;AACZ,YAAM,QAAQ,GAAG;AAAA,IACnB;AAAA,EACF;AACF;;;ACZA,iBAeO;AAEA,SAAS,qBAAoC;AAClD,SAAO,OAAO,SAAS,SAAS;AAC9B,UAAM,KAAK;AAEX,UAAM,WAAW,QAAQ;AACzB,QAAI,CAAC,SAAU;AAEf,UAAM,EAAE,QAAQ,WAAW,IAAI;AAG/B,QAAI,UAAU,OAAO,SAAS,IAAK;AAGnC,QAAI,UAAU,OAAO,SAAS,IAAK;AAGnC,QAAI,UAAU,OAAO,SAAS,KAAK;AACjC,cAAQ,QAAQ;AAAA,QAChB,KAAK;AACH,gBAAM,IAAI,+BAAoB,UAAU;AAAA,QAC1C,KAAK;AACH,gBAAM,IAAI,iCAAsB,UAAU;AAAA,QAC5C,KAAK;AACH,gBAAM,IAAI,8BAAmB,UAAU;AAAA,QACzC,KAAK;AACH,gBAAM,IAAI,+BAAoB,UAAU;AAAA,QAC1C,KAAK;AACH,gBAAM,IAAI,kCAAuB,UAAU;AAAA,QAC7C,KAAK;AACH,gBAAM,IAAI,6BAAkB,UAAU;AAAA,QACxC,KAAK;AACH,gBAAM,IAAI,uCAA4B,UAAU;AAAA,QAClD,KAAK;AACH,gBAAM,IAAI,8BAAmB,UAAU;AAAA,QACzC;AAEE,gBAAM,IAAI,4BAAiB,QAAQ,YAAY,KAAK;AAAA,MACtD;AAAA,IACF;AAGA,QAAI,UAAU,KAAK;AACjB,cAAQ,QAAQ;AAAA,QAChB,KAAK;AACH,gBAAM,IAAI,wCAA6B,UAAU;AAAA,QACnD,KAAK;AACH,gBAAM,IAAI,+BAAoB,UAAU;AAAA,QAC1C,KAAK;AACH,gBAAM,IAAI,uCAA4B,UAAU;AAAA,QAClD,KAAK;AACH,gBAAM,IAAI,mCAAwB,UAAU;AAAA,QAC9C;AAEE,gBAAM,IAAI,4BAAiB,QAAQ,YAAY,IAAI;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AACF;","names":["throwException","catchException"]}

package/dist/index.mjs

@@ -16,8 +16,72 @@ function catchException(handler) {
     }
   };
 }
+
+// src/validate-status-code.ts
+import {
+  BadGatewayException,
+  BadRequestException,
+  ConflictException,
+  ForbiddenException,
+  GatewayTimeoutException,
+  InternalServerErrorException,
+  NotAcceptableException,
+  NotFoundedException,
+  PreconditionFailedException,
+  RequestException,
+  ServiceUnavailableException,
+  UnauthorizedException,
+  ImATeapotException
+} from "keq";
+function validateStatusCode() {
+  return async (context, next) => {
+    await next();
+    const response = context.response;
+    if (!response) return;
+    const { status, statusText } = response;
+    if (status >= 200 && status < 300) return;
+    if (status >= 300 && status < 400) return;
+    if (status >= 400 && status < 500) {
+      switch (status) {
+        case 400:
+          throw new BadRequestException(statusText);
+        case 401:
+          throw new UnauthorizedException(statusText);
+        case 403:
+          throw new ForbiddenException(statusText);
+        case 404:
+          throw new NotFoundedException(statusText);
+        case 406:
+          throw new NotAcceptableException(statusText);
+        case 409:
+          throw new ConflictException(statusText);
+        case 412:
+          throw new PreconditionFailedException(statusText);
+        case 418:
+          throw new ImATeapotException(statusText);
+        default:
+          throw new RequestException(status, statusText, false);
+      }
+    }
+    if (status >= 500) {
+      switch (status) {
+        case 500:
+          throw new InternalServerErrorException(statusText);
+        case 502:
+          throw new BadGatewayException(statusText);
+        case 503:
+          throw new ServiceUnavailableException(statusText);
+        case 504:
+          throw new GatewayTimeoutException(statusText);
+        default:
+          throw new RequestException(status, statusText, true);
+      }
+    }
+  };
+}
 export {
   catchException,
-  throwException
+  throwException,
+  validateStatusCode
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/throw-exception.ts","../src/catch-exception.ts"],"sourcesContent":["import { KeqContext, KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport type Check = (ctx: KeqContext) => Promisable<void>\n\nexport function throwException(check: Check): KeqMiddleware {\n  return async function throwException(ctx, next) {\n    await next()\n\n    await check(ctx)\n  }\n}\n","import { KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport function catchException(handler: (e: unknown) => Promisable<void>): KeqMiddleware {\n  return async function catchException(ctx, next) {\n    try {\n      await next()\n    } catch (err) {\n      await handler(err)\n    }\n  }\n}\n"],"mappings":";AAMO,SAAS,eAAe,OAA6B;AAC1D,SAAO,eAAeA,gBAAe,KAAK,MAAM;AAC9C,UAAM,KAAK;AAEX,UAAM,MAAM,GAAG;AAAA,EACjB;AACF;;;ACRO,SAAS,eAAe,SAA0D;AACvF,SAAO,eAAeC,gBAAe,KAAK,MAAM;AAC9C,QAAI;AACF,YAAM,KAAK;AAAA,IACb,SAAS,KAAK;AACZ,YAAM,QAAQ,GAAG;AAAA,IACnB;AAAA,EACF;AACF;","names":["throwException","catchException"]}
+{"version":3,"sources":["../src/throw-exception.ts","../src/catch-exception.ts","../src/validate-status-code.ts"],"sourcesContent":["import { KeqContext, KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport type Check = (ctx: KeqContext) => Promisable<void>\n\nexport function throwException(check: Check): KeqMiddleware {\n  return async function throwException(ctx, next) {\n    await next()\n\n    await check(ctx)\n  }\n}\n","import { KeqMiddleware } from 'keq'\nimport { Promisable } from 'type-fest'\n\n\nexport function catchException(handler: (e: unknown) => Promisable<void>): KeqMiddleware {\n  return async function catchException(ctx, next) {\n    try {\n      await next()\n    } catch (err) {\n      await handler(err)\n    }\n  }\n}\n","import {\n  BadGatewayException,\n  BadRequestException,\n  ConflictException,\n  ForbiddenException,\n  GatewayTimeoutException,\n  InternalServerErrorException,\n  KeqMiddleware,\n  NotAcceptableException,\n  NotFoundedException,\n  PreconditionFailedException,\n  RequestException,\n  ServiceUnavailableException,\n  UnauthorizedException,\n  ImATeapotException,\n} from 'keq'\n\nexport function validateStatusCode(): KeqMiddleware {\n  return async (context, next) => {\n    await next()\n\n    const response = context.response\n    if (!response) return\n\n    const { status, statusText } = response\n\n    // 2xx success status codes - no error\n    if (status >= 200 && status < 300) return\n\n    // 3xx redirection status codes - no error (handled by fetch)\n    if (status >= 300 && status < 400) return\n\n    // 4xx client errors\n    if (status >= 400 && status < 500) {\n      switch (status) {\n      case 400:\n        throw new BadRequestException(statusText)\n      case 401:\n        throw new UnauthorizedException(statusText)\n      case 403:\n        throw new ForbiddenException(statusText)\n      case 404:\n        throw new NotFoundedException(statusText)\n      case 406:\n        throw new NotAcceptableException(statusText)\n      case 409:\n        throw new ConflictException(statusText)\n      case 412:\n        throw new PreconditionFailedException(statusText)\n      case 418:\n        throw new ImATeapotException(statusText)\n      default:\n        // Other 4xx errors, don't retry by default\n        throw new RequestException(status, statusText, false)\n      }\n    }\n\n    // 5xx server errors\n    if (status >= 500) {\n      switch (status) {\n      case 500:\n        throw new InternalServerErrorException(statusText)\n      case 502:\n        throw new BadGatewayException(statusText)\n      case 503:\n        throw new ServiceUnavailableException(statusText)\n      case 504:\n        throw new GatewayTimeoutException(statusText)\n      default:\n        // Other 5xx errors, retry by default\n        throw new RequestException(status, statusText, true)\n      }\n    }\n  }\n}\n"],"mappings":";AAMO,SAAS,eAAe,OAA6B;AAC1D,SAAO,eAAeA,gBAAe,KAAK,MAAM;AAC9C,UAAM,KAAK;AAEX,UAAM,MAAM,GAAG;AAAA,EACjB;AACF;;;ACRO,SAAS,eAAe,SAA0D;AACvF,SAAO,eAAeC,gBAAe,KAAK,MAAM;AAC9C,QAAI;AACF,YAAM,KAAK;AAAA,IACb,SAAS,KAAK;AACZ,YAAM,QAAQ,GAAG;AAAA,IACnB;AAAA,EACF;AACF;;;ACZA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAEA,SAAS,qBAAoC;AAClD,SAAO,OAAO,SAAS,SAAS;AAC9B,UAAM,KAAK;AAEX,UAAM,WAAW,QAAQ;AACzB,QAAI,CAAC,SAAU;AAEf,UAAM,EAAE,QAAQ,WAAW,IAAI;AAG/B,QAAI,UAAU,OAAO,SAAS,IAAK;AAGnC,QAAI,UAAU,OAAO,SAAS,IAAK;AAGnC,QAAI,UAAU,OAAO,SAAS,KAAK;AACjC,cAAQ,QAAQ;AAAA,QAChB,KAAK;AACH,gBAAM,IAAI,oBAAoB,UAAU;AAAA,QAC1C,KAAK;AACH,gBAAM,IAAI,sBAAsB,UAAU;AAAA,QAC5C,KAAK;AACH,gBAAM,IAAI,mBAAmB,UAAU;AAAA,QACzC,KAAK;AACH,gBAAM,IAAI,oBAAoB,UAAU;AAAA,QAC1C,KAAK;AACH,gBAAM,IAAI,uBAAuB,UAAU;AAAA,QAC7C,KAAK;AACH,gBAAM,IAAI,kBAAkB,UAAU;AAAA,QACxC,KAAK;AACH,gBAAM,IAAI,4BAA4B,UAAU;AAAA,QAClD,KAAK;AACH,gBAAM,IAAI,mBAAmB,UAAU;AAAA,QACzC;AAEE,gBAAM,IAAI,iBAAiB,QAAQ,YAAY,KAAK;AAAA,MACtD;AAAA,IACF;AAGA,QAAI,UAAU,KAAK;AACjB,cAAQ,QAAQ;AAAA,QAChB,KAAK;AACH,gBAAM,IAAI,6BAA6B,UAAU;AAAA,QACnD,KAAK;AACH,gBAAM,IAAI,oBAAoB,UAAU;AAAA,QAC1C,KAAK;AACH,gBAAM,IAAI,4BAA4B,UAAU;AAAA,QAClD,KAAK;AACH,gBAAM,IAAI,wBAAwB,UAAU;AAAA,QAC9C;AAEE,gBAAM,IAAI,iBAAiB,QAAQ,YAAY,IAAI;AAAA,MACrD;AAAA,IACF;AAAA,EACF;AACF;","names":["throwException","catchException"]}

package/dist/plugins/index.d.mts

@@ -0,0 +1,12 @@
+import { Plugin, Compiler } from '@keq-request/cli';
+
+interface Options {
+    modules?: string[];
+}
+declare class ValidateStatusCodePlugin implements Plugin {
+    private options;
+    constructor(options?: Options);
+    apply(compiler: Compiler): void;
+}
+
+export { ValidateStatusCodePlugin };

package/dist/plugins/index.d.ts

@@ -0,0 +1,12 @@
+import { Plugin, Compiler } from '@keq-request/cli';
+
+interface Options {
+    modules?: string[];
+}
+declare class ValidateStatusCodePlugin implements Plugin {
+    private options;
+    constructor(options?: Options);
+    apply(compiler: Compiler): void;
+}
+
+export { ValidateStatusCodePlugin };

package/dist/plugins/index.js

@@ -0,0 +1,93 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// plugins/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ValidateStatusCodePlugin: () => ValidateStatusCodePlugin
+});
+module.exports = __toCommonJS(index_exports);
+
+// plugins/validate-response.ts
+var import_cli = require("@keq-request/cli");
+var ValidateStatusCodePlugin = class _ValidateStatusCodePlugin {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  apply(compiler) {
+    if (this.options.modules && this.options.modules.length === 0) return;
+    compiler.hooks.afterShaking.tap(_ValidateStatusCodePlugin.name, () => {
+      if (!compiler.context.shaken) return;
+      const documents = compiler.context.shaken.documents;
+      compiler.context.shaken.documents = documents.map((document) => {
+        if (this.options.modules && !this.options.modules.includes(document.module.name)) {
+          return document;
+        }
+        const spec = document.specification;
+        if (!spec.paths || typeof spec.paths !== "object" || spec.paths === null) return document;
+        const paths = Object.fromEntries(
+          Object.entries(spec.paths).map(([path, pathItem]) => {
+            if (!pathItem || typeof pathItem !== "object" || pathItem === null) return [path, pathItem];
+            return [
+              path,
+              Object.fromEntries(
+                Object.entries(pathItem).map(([method, operation]) => {
+                  if (!operation || typeof operation !== "object" || operation === null) return [method, operation];
+                  const responses = operation.responses;
+                  if (!responses) return [method, operation];
+                  return [
+                    method,
+                    {
+                      ...operation,
+                      responses: Object.fromEntries(
+                        Object.entries(responses).filter(([statusCode]) => parseInt(statusCode, 10) < 400)
+                      )
+                    }
+                  ];
+                })
+              )
+            ];
+          })
+        );
+        return new import_cli.ApiDocumentV3_1({ ...spec, paths }, document.module);
+      });
+    });
+    compiler.hooks.afterCompileKeqRequest.tap(_ValidateStatusCodePlugin.name, (artifact) => {
+      artifact.addDependence("@keq-request/exception", ["validateResponse"]);
+      if (!this.options.modules) {
+        artifact.anchor.prepend("file:end", "request.use(validateResponse())\n");
+      } else {
+        artifact.anchor.prepend(
+          "file:end",
+          [
+            "request",
+            "  .useRouter()",
+            ...this.options.modules.map((moduleName) => `  .module(${JSON.stringify(moduleName)}, validateResponse())`),
+            ""
+          ].join("\n")
+        );
+      }
+      return artifact;
+    });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ValidateStatusCodePlugin
+});

package/dist/plugins/index.mjs

@@ -0,0 +1,66 @@
+// plugins/validate-response.ts
+import { ApiDocumentV3_1 } from "@keq-request/cli";
+var ValidateStatusCodePlugin = class _ValidateStatusCodePlugin {
+  constructor(options = {}) {
+    this.options = options;
+  }
+  apply(compiler) {
+    if (this.options.modules && this.options.modules.length === 0) return;
+    compiler.hooks.afterShaking.tap(_ValidateStatusCodePlugin.name, () => {
+      if (!compiler.context.shaken) return;
+      const documents = compiler.context.shaken.documents;
+      compiler.context.shaken.documents = documents.map((document) => {
+        if (this.options.modules && !this.options.modules.includes(document.module.name)) {
+          return document;
+        }
+        const spec = document.specification;
+        if (!spec.paths || typeof spec.paths !== "object" || spec.paths === null) return document;
+        const paths = Object.fromEntries(
+          Object.entries(spec.paths).map(([path, pathItem]) => {
+            if (!pathItem || typeof pathItem !== "object" || pathItem === null) return [path, pathItem];
+            return [
+              path,
+              Object.fromEntries(
+                Object.entries(pathItem).map(([method, operation]) => {
+                  if (!operation || typeof operation !== "object" || operation === null) return [method, operation];
+                  const responses = operation.responses;
+                  if (!responses) return [method, operation];
+                  return [
+                    method,
+                    {
+                      ...operation,
+                      responses: Object.fromEntries(
+                        Object.entries(responses).filter(([statusCode]) => parseInt(statusCode, 10) < 400)
+                      )
+                    }
+                  ];
+                })
+              )
+            ];
+          })
+        );
+        return new ApiDocumentV3_1({ ...spec, paths }, document.module);
+      });
+    });
+    compiler.hooks.afterCompileKeqRequest.tap(_ValidateStatusCodePlugin.name, (artifact) => {
+      artifact.addDependence("@keq-request/exception", ["validateResponse"]);
+      if (!this.options.modules) {
+        artifact.anchor.prepend("file:end", "request.use(validateResponse())\n");
+      } else {
+        artifact.anchor.prepend(
+          "file:end",
+          [
+            "request",
+            "  .useRouter()",
+            ...this.options.modules.map((moduleName) => `  .module(${JSON.stringify(moduleName)}, validateResponse())`),
+            ""
+          ].join("\n")
+        );
+      }
+      return artifact;
+    });
+  }
+};
+export {
+  ValidateStatusCodePlugin
+};

package/dist/validate-status-code.d.ts

@@ -0,0 +1,3 @@
+import { KeqMiddleware } from 'keq';
+export declare function validateStatusCode(): KeqMiddleware;
+//# sourceMappingURL=validate-status-code.d.ts.map

package/dist/validate-status-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-status-code.d.ts","sourceRoot":"","sources":["../src/validate-status-code.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,aAAa,EAQd,MAAM,KAAK,CAAA;AAEZ,wBAAgB,kBAAkB,IAAI,aAAa,CAyDlD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@keq-request/exception",
-  "version": "5.0.0-alpha.17",
+  "version": "5.0.0-alpha.19",
   "description": "Request exception for keq",
   "keywords": [
     "keq",
@@ -26,17 +26,27 @@
       "types": "./dist/index.d.ts",
       "require": "./dist/index.js",
       "import": "./dist/index.mjs"
+    },
+    "./plugins": {
+      "types": "./dist/plugins/index.d.ts",
+      "require": "./dist/plugins/index.js",
+      "import": "./dist/plugins/index.mjs"
     }
   },
   "dependencies": {
-    "type-fest": "^5.2.0"
+    "type-fest": "^5.3.0"
   },
   "devDependencies": {
-    "@types/node": "^20.19.24",
-    "keq": "5.0.0-alpha.17"
+    "@scalar/openapi-types": "^0.5.2",
+    "@types/node": "^20.19.25",
+    "@keq-request/cli": "5.0.0-alpha.19",
+    "keq": "5.0.0-alpha.19"
   },
   "peerDependencies": {
-    "keq": "^5.0.0-alpha.17"
+    "keq": "^5.0.0-alpha.19"
+  },
+  "optionalDependencies": {
+    "@keq-request/cli": "5.0.0-alpha.19"
   },
   "scripts": {
     "build": "tsup",

package/plugins/index.ts

@@ -0,0 +1 @@
+export * from './validate-response.js'

package/plugins/validate-response.ts

@@ -0,0 +1,87 @@
+import { ApiDocumentV3_1, Artifact, Compiler, Plugin } from '@keq-request/cli'
+import type { OpenAPIV3_1 } from '@scalar/openapi-types'
+
+
+interface Options {
+  modules?: string[]
+}
+
+export class ValidateStatusCodePlugin implements Plugin {
+  constructor(private options: Options = {}) {}
+
+  apply(compiler: Compiler): void {
+    if (this.options.modules && this.options.modules.length === 0) return
+
+    // remove 4xx and 5xx responses from OpenAPI documents
+    compiler.hooks.afterShaking.tap(ValidateStatusCodePlugin.name, () => {
+      if (!compiler.context.shaken) return
+
+      const documents = compiler.context.shaken.documents
+
+      compiler.context.shaken.documents = documents.map((document: ApiDocumentV3_1): ApiDocumentV3_1 => {
+        if (this.options.modules && !this.options.modules.includes(document.module.name)) {
+          return document
+        }
+
+        const spec: OpenAPIV3_1.Document = document.specification
+
+        if (!spec.paths || typeof spec.paths !== 'object' || spec.paths === null) return document
+
+        const paths = Object.fromEntries(
+          Object.entries(spec.paths)
+            .map(([path, pathItem]) => {
+              if (!pathItem || typeof pathItem !== 'object' || pathItem === null) return [path, pathItem]
+
+              return [
+                path,
+                Object.fromEntries(
+                  Object.entries(pathItem)
+                    .map(([method, operation]) => {
+                      if (!operation || typeof operation !== 'object' || operation === null) return [method, operation]
+
+                      const responses = operation.responses
+                      if (!responses) return [method, operation]
+
+                      return [
+                        method,
+                        {
+                          ...operation,
+
+                          responses: Object.fromEntries(
+                            Object.entries(responses)
+                              .filter(([statusCode]) => parseInt(statusCode, 10) < 400),
+                          ),
+                        },
+                      ]
+                    }),
+                ),
+              ]
+            }),
+        )
+
+        return new ApiDocumentV3_1({ ...spec, paths }, document.module)
+      })
+    })
+
+    // inject validateResponse middleware into generated code
+    compiler.hooks.afterCompileKeqRequest.tap(ValidateStatusCodePlugin.name, (artifact: Artifact) => {
+      artifact.addDependence('@keq-request/exception', ['validateResponse'])
+
+      if (!this.options.modules) {
+        artifact.anchor.prepend('file:end', 'request.use(validateResponse())\n')
+      } else {
+        artifact.anchor.prepend(
+          'file:end',
+          [
+            'request',
+            '  .useRouter()',
+            ...this.options.modules.map((moduleName) => `  .module(${JSON.stringify(moduleName)}, validateResponse())`),
+            '',
+          ].join('\n'),
+        )
+      }
+
+      return artifact
+    })
+  }
+}