@cedvict/http-guardian-plugin-timeout 0.0.1-next.10

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+## 0.0.1-next.7
+
+- Initial prerelease.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cedvict
+
+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

@@ -0,0 +1,9 @@
+# @cedvict/http-guardian-plugin-timeout
+
+Request timeout plugin for http-guardian.
+
+## Usage
+
+```ts
+import { timeoutPlugin } from "@cedvict/http-guardian-plugin-timeout";
+```

package/dist/index.cjs

@@ -0,0 +1,31 @@
+'use strict';
+
+// src/index.ts
+function timeoutPlugin(opts) {
+  const ms = opts.ms;
+  const maxMs = opts.maxMs;
+  const applyTo = opts.applyTo ?? (() => true);
+  const guard = async (ctx, next) => {
+    if (!applyTo(ctx)) return next(ctx);
+    const existing = ctx.timeoutMs;
+    if (typeof existing === "number") {
+      if (typeof maxMs === "number") {
+        return next(Object.assign({}, ctx, { timeoutMs: Math.min(existing, maxMs) }));
+      }
+      return next(ctx);
+    }
+    const applied = typeof maxMs === "number" ? Math.min(ms, maxMs) : ms;
+    return next(Object.assign({}, ctx, { timeoutMs: applied }));
+  };
+  return {
+    name: "timeout",
+    apply: (draft) => {
+      draft.guards = [...draft.guards ?? [], guard];
+      draft.defaults = { ...draft.defaults ?? {}, timeoutMs: draft.defaults?.timeoutMs ?? ms };
+    }
+  };
+}
+
+exports.timeoutPlugin = timeoutPlugin;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AASO,SAAS,cAAc,IAAA,EAA+F;AAC3H,EAAA,MAAM,KAAK,IAAA,CAAK,EAAA;AAChB,EAAA,MAAM,QAAQ,IAAA,CAAK,KAAA;AACnB,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,KAAY,MAAM,IAAA,CAAA;AAEvC,EAAA,MAAM,KAAA,GAAe,OAAO,GAAA,EAAK,IAAA,KAAS;AACxC,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAG,CAAA,EAAG,OAAO,KAAK,GAAG,CAAA;AAElC,IAAA,MAAM,WAAW,GAAA,CAAI,SAAA;AACrB,IAAA,IAAI,OAAO,aAAa,QAAA,EAAU;AAChC,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAI,GAAA,EAAK,EAAE,SAAA,EAAW,IAAA,CAAK,GAAA,CAAI,QAAA,EAAU,KAAK,CAAA,EAAG,CAAmB,CAAA;AAAA,MAChG;AACA,MAAA,OAAO,KAAK,GAAG,CAAA;AAAA,IACjB;AAEA,IAAA,MAAM,OAAA,GAAU,OAAO,KAAA,KAAU,QAAA,GAAW,KAAK,GAAA,CAAI,EAAA,EAAI,KAAK,CAAA,GAAI,EAAA;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,EAAC,EAAG,KAAK,EAAE,SAAA,EAAW,OAAA,EAAS,CAAmB,CAAA;AAAA,EAC9E,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,KAAA,EAAO,CAAC,KAAA,KAAU;AAChB,MAAA,KAAA,CAAM,SAAS,CAAC,GAAI,MAAM,MAAA,IAAU,IAAK,KAAK,CAAA;AAC9C,MAAA,KAAA,CAAM,QAAA,GAAW,EAAE,GAAI,KAAA,CAAM,QAAA,IAAY,EAAC,EAAI,SAAA,EAAW,KAAA,CAAM,QAAA,EAAU,SAAA,IAAa,EAAA,EAAG;AAAA,IAC3F;AAAA,GACF;AACF","file":"index.cjs","sourcesContent":["import type { HttpPlugin } from \"@cedvict/http-guardian\";\nimport type { Guard } from \"@cedvict/http-guardian\";\nimport type { RequestContext } from \"@cedvict/http-guardian\";\n\n/**\n * Timeout plugin:\n * - sets a client default timeout (ctx.timeoutMs), while allowing per-request override\n * - does NOT replace user's AbortSignal; it only sets timeoutMs which core uses to abort safely.\n */\nexport function timeoutPlugin(opts: { ms: number; maxMs?: number; applyTo?: (ctx: RequestContext) => boolean } ): HttpPlugin {\n  const ms = opts.ms;\n  const maxMs = opts.maxMs;\n  const applyTo = opts.applyTo ?? (() => true);\n\n  const guard: Guard = async (ctx, next) => {\n    if (!applyTo(ctx)) return next(ctx);\n\n    const existing = ctx.timeoutMs;\n    if (typeof existing === \"number\") {\n      if (typeof maxMs === \"number\") {\n        return next(Object.assign({}, ctx, { timeoutMs: Math.min(existing, maxMs) }) as RequestContext);\n      }\n      return next(ctx);\n    }\n\n    const applied = typeof maxMs === \"number\" ? Math.min(ms, maxMs) : ms;\n    return next(Object.assign({}, ctx, { timeoutMs: applied }) as RequestContext);\n  };\n\n  return {\n    name: \"timeout\",\n    apply: (draft) => {\n      draft.guards = [...(draft.guards ?? []), guard];\n      draft.defaults = { ...(draft.defaults ?? {}), timeoutMs: draft.defaults?.timeoutMs ?? ms };\n    },\n  };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,14 @@
+import { RequestContext, HttpPlugin } from '@cedvict/http-guardian';
+
+/**
+ * Timeout plugin:
+ * - sets a client default timeout (ctx.timeoutMs), while allowing per-request override
+ * - does NOT replace user's AbortSignal; it only sets timeoutMs which core uses to abort safely.
+ */
+declare function timeoutPlugin(opts: {
+    ms: number;
+    maxMs?: number;
+    applyTo?: (ctx: RequestContext) => boolean;
+}): HttpPlugin;
+
+export { timeoutPlugin };

package/dist/index.d.ts

@@ -0,0 +1,14 @@
+import { RequestContext, HttpPlugin } from '@cedvict/http-guardian';
+
+/**
+ * Timeout plugin:
+ * - sets a client default timeout (ctx.timeoutMs), while allowing per-request override
+ * - does NOT replace user's AbortSignal; it only sets timeoutMs which core uses to abort safely.
+ */
+declare function timeoutPlugin(opts: {
+    ms: number;
+    maxMs?: number;
+    applyTo?: (ctx: RequestContext) => boolean;
+}): HttpPlugin;
+
+export { timeoutPlugin };

package/dist/index.js

@@ -0,0 +1,29 @@
+// src/index.ts
+function timeoutPlugin(opts) {
+  const ms = opts.ms;
+  const maxMs = opts.maxMs;
+  const applyTo = opts.applyTo ?? (() => true);
+  const guard = async (ctx, next) => {
+    if (!applyTo(ctx)) return next(ctx);
+    const existing = ctx.timeoutMs;
+    if (typeof existing === "number") {
+      if (typeof maxMs === "number") {
+        return next(Object.assign({}, ctx, { timeoutMs: Math.min(existing, maxMs) }));
+      }
+      return next(ctx);
+    }
+    const applied = typeof maxMs === "number" ? Math.min(ms, maxMs) : ms;
+    return next(Object.assign({}, ctx, { timeoutMs: applied }));
+  };
+  return {
+    name: "timeout",
+    apply: (draft) => {
+      draft.guards = [...draft.guards ?? [], guard];
+      draft.defaults = { ...draft.defaults ?? {}, timeoutMs: draft.defaults?.timeoutMs ?? ms };
+    }
+  };
+}
+
+export { timeoutPlugin };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AASO,SAAS,cAAc,IAAA,EAA+F;AAC3H,EAAA,MAAM,KAAK,IAAA,CAAK,EAAA;AAChB,EAAA,MAAM,QAAQ,IAAA,CAAK,KAAA;AACnB,EAAA,MAAM,OAAA,GAAU,IAAA,CAAK,OAAA,KAAY,MAAM,IAAA,CAAA;AAEvC,EAAA,MAAM,KAAA,GAAe,OAAO,GAAA,EAAK,IAAA,KAAS;AACxC,IAAA,IAAI,CAAC,OAAA,CAAQ,GAAG,CAAA,EAAG,OAAO,KAAK,GAAG,CAAA;AAElC,IAAA,MAAM,WAAW,GAAA,CAAI,SAAA;AACrB,IAAA,IAAI,OAAO,aAAa,QAAA,EAAU;AAChC,MAAA,IAAI,OAAO,UAAU,QAAA,EAAU;AAC7B,QAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,IAAI,GAAA,EAAK,EAAE,SAAA,EAAW,IAAA,CAAK,GAAA,CAAI,QAAA,EAAU,KAAK,CAAA,EAAG,CAAmB,CAAA;AAAA,MAChG;AACA,MAAA,OAAO,KAAK,GAAG,CAAA;AAAA,IACjB;AAEA,IAAA,MAAM,OAAA,GAAU,OAAO,KAAA,KAAU,QAAA,GAAW,KAAK,GAAA,CAAI,EAAA,EAAI,KAAK,CAAA,GAAI,EAAA;AAClE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,MAAA,CAAO,EAAC,EAAG,KAAK,EAAE,SAAA,EAAW,OAAA,EAAS,CAAmB,CAAA;AAAA,EAC9E,CAAA;AAEA,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,SAAA;AAAA,IACN,KAAA,EAAO,CAAC,KAAA,KAAU;AAChB,MAAA,KAAA,CAAM,SAAS,CAAC,GAAI,MAAM,MAAA,IAAU,IAAK,KAAK,CAAA;AAC9C,MAAA,KAAA,CAAM,QAAA,GAAW,EAAE,GAAI,KAAA,CAAM,QAAA,IAAY,EAAC,EAAI,SAAA,EAAW,KAAA,CAAM,QAAA,EAAU,SAAA,IAAa,EAAA,EAAG;AAAA,IAC3F;AAAA,GACF;AACF","file":"index.js","sourcesContent":["import type { HttpPlugin } from \"@cedvict/http-guardian\";\nimport type { Guard } from \"@cedvict/http-guardian\";\nimport type { RequestContext } from \"@cedvict/http-guardian\";\n\n/**\n * Timeout plugin:\n * - sets a client default timeout (ctx.timeoutMs), while allowing per-request override\n * - does NOT replace user's AbortSignal; it only sets timeoutMs which core uses to abort safely.\n */\nexport function timeoutPlugin(opts: { ms: number; maxMs?: number; applyTo?: (ctx: RequestContext) => boolean } ): HttpPlugin {\n  const ms = opts.ms;\n  const maxMs = opts.maxMs;\n  const applyTo = opts.applyTo ?? (() => true);\n\n  const guard: Guard = async (ctx, next) => {\n    if (!applyTo(ctx)) return next(ctx);\n\n    const existing = ctx.timeoutMs;\n    if (typeof existing === \"number\") {\n      if (typeof maxMs === \"number\") {\n        return next(Object.assign({}, ctx, { timeoutMs: Math.min(existing, maxMs) }) as RequestContext);\n      }\n      return next(ctx);\n    }\n\n    const applied = typeof maxMs === \"number\" ? Math.min(ms, maxMs) : ms;\n    return next(Object.assign({}, ctx, { timeoutMs: applied }) as RequestContext);\n  };\n\n  return {\n    name: \"timeout\",\n    apply: (draft) => {\n      draft.guards = [...(draft.guards ?? []), guard];\n      draft.defaults = { ...(draft.defaults ?? {}), timeoutMs: draft.defaults?.timeoutMs ?? ms };\n    },\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@cedvict/http-guardian-plugin-timeout",
+  "version": "0.0.1-next.10",
+  "description": "Request timeout plugin for http-guardian.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "browser": "./dist/index.js",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cedvict/http-guardian.git"
+  },
+  "peerDependencies": {
+    "@cedvict/http-guardian": "^0.0.1-next.6"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "lint": "eslint . --max-warnings=0",
+    "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
+    "prepublishOnly": "npm -w @cedvict/http-guardian run build && npm run test && npm run lint && npm run typecheck && npm run build",
+    "prebuild": "npm -w @cedvict/http-guardian run build",
+    "pretypecheck": "npm -w @cedvict/http-guardian run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "eslint": "^9.0.0",
+    "typescript": "^5.4.0",
+    "tsup": "^8.0.0",
+    "vitest": "^1.5.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0"
+  },
+  "dependencies": {
+    "@cedvict/http-guardian": "^0.0.1-next.10"
+  }
+}