@backendkit-labs/http-client 0.1.0

package/dist/chunk-GZWQJKYR.cjs

@@ -0,0 +1,253 @@
+'use strict';
+
+var axios2 = require('axios');
+var result = require('@backendkit-labs/result');
+var circuitBreaker = require('@backendkit-labs/circuit-breaker');
+var pipeline = require('@backendkit-labs/pipeline');
+
+function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
+
+var axios2__default = /*#__PURE__*/_interopDefault(axios2);
+
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result) __defProp(target, key, result);
+  return result;
+};
+var CancelManager = class {
+  tokens = /* @__PURE__ */ new Map();
+  getOrCreate(key) {
+    const existing = this.tokens.get(key);
+    if (existing) return existing;
+    const source = axios2__default.default.CancelToken.source();
+    this.tokens.set(key, source);
+    return source;
+  }
+  cancel(key, reason) {
+    const source = this.tokens.get(key);
+    if (source) {
+      source.cancel(reason ?? `Request ${key} cancelled`);
+      this.tokens.delete(key);
+    }
+  }
+  cancelAll() {
+    for (const [key, source] of this.tokens) {
+      source.cancel(`Request ${key} cancelled`);
+    }
+    this.tokens.clear();
+  }
+  delete(key) {
+    this.tokens.delete(key);
+  }
+  has(key) {
+    return this.tokens.has(key);
+  }
+  get size() {
+    return this.tokens.size;
+  }
+};
+var DEFAULT_RETRY = {
+  attempts: 0,
+  delayMs: 100,
+  maxDelayMs: 5e3,
+  jitter: true,
+  shouldRetry: (e) => e.type === "network" || e.type === "timeout" || e.type === "http" && (e.status ?? 0) >= 500
+};
+var HttpClient = class {
+  axiosInstance;
+  cb;
+  pipeline;
+  retry;
+  cancelMgr = new CancelManager();
+  _metrics = {
+    requests: 0,
+    success: 0,
+    failed: 0,
+    cancelled: 0,
+    circuitOpen: 0,
+    retried: 0
+  };
+  constructor(config = {}) {
+    this.axiosInstance = axios2__default.default.create({
+      baseURL: config.baseURL,
+      timeout: config.timeout ?? 1e4,
+      headers: config.headers
+    });
+    if (config.circuitBreaker) {
+      const { name: cbName, ...cbRest } = config.circuitBreaker;
+      this.cb = new circuitBreaker.CircuitBreaker({
+        name: cbName ?? "http-client",
+        ...circuitBreaker.DEFAULT_CIRCUIT_BREAKER_CONFIG,
+        isFailure: circuitBreaker.isHttpServerError,
+        ...cbRest
+      });
+    }
+    const p = new pipeline.Pipeline();
+    for (const step of config.steps ?? []) p.pipe(step);
+    this.pipeline = p;
+    this.retry = config.retry ? { ...DEFAULT_RETRY, ...config.retry } : DEFAULT_RETRY;
+  }
+  // ── HTTP methods ──────────────────────────────────────────────────────────
+  get(url, config) {
+    return this.execute("GET", url, void 0, config);
+  }
+  post(url, data, config) {
+    return this.execute("POST", url, data, config);
+  }
+  put(url, data, config) {
+    return this.execute("PUT", url, data, config);
+  }
+  patch(url, data, config) {
+    return this.execute("PATCH", url, data, config);
+  }
+  delete(url, config) {
+    return this.execute("DELETE", url, void 0, config);
+  }
+  // ── Cancellation ──────────────────────────────────────────────────────────
+  cancelRequest(key) {
+    this.cancelMgr.cancel(key);
+    this._metrics.cancelled++;
+  }
+  cancelAll() {
+    const count = this.cancelMgr.size;
+    this.cancelMgr.cancelAll();
+    this._metrics.cancelled += count;
+  }
+  // ── Observability ─────────────────────────────────────────────────────────
+  getMetrics() {
+    return { ...this._metrics };
+  }
+  getCircuitBreakerState() {
+    return this.cb?.getState();
+  }
+  getCircuitBreakerMetrics() {
+    return this.cb?.getMetrics();
+  }
+  // ── Internal ──────────────────────────────────────────────────────────────
+  async execute(method, url, data, config = {}) {
+    this._metrics.requests++;
+    const initialCtx = {
+      url,
+      method,
+      data,
+      headers: config.headers ?? {},
+      params: config.params,
+      timeout: config.timeout,
+      cancelKey: config.cancelKey,
+      correlationId: config.correlationId
+    };
+    if (initialCtx.cancelKey) {
+      this.cancelMgr.getOrCreate(initialCtx.cancelKey);
+    }
+    const pipelineResult = await this.pipeline.run(initialCtx);
+    if (!pipelineResult.ok) {
+      this._metrics.failed++;
+      return result.fail(pipelineResult.error.cause);
+    }
+    const ctx = pipelineResult.value;
+    if (ctx.cancelKey && !this.cancelMgr.has(ctx.cancelKey)) {
+      this._metrics.failed++;
+      return result.fail({ type: "cancelled", message: `Request ${ctx.cancelKey} cancelled` });
+    }
+    const cancelToken = ctx.cancelKey ? this.cancelMgr.getOrCreate(ctx.cancelKey).token : void 0;
+    const rawCall = () => this.callAxios(ctx, cancelToken);
+    const cbCall = async () => {
+      if (!this.cb) return rawCall();
+      try {
+        return await this.cb.execute(rawCall);
+      } catch (e) {
+        if (e instanceof circuitBreaker.CircuitBreakerOpenError) {
+          this._metrics.circuitOpen++;
+          const err = { type: "circuit-open", message: e.message };
+          throw err;
+        }
+        throw e;
+      }
+    };
+    try {
+      const response = this.retry.attempts > 0 ? await this.withRetry(cbCall, this.retry) : await cbCall();
+      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);
+      this._metrics.success++;
+      return result.ok(response);
+    } catch (e) {
+      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);
+      const error = this.isHttpClientError(e) ? e : this.normalizeError(e);
+      if (error.type !== "circuit-open") this._metrics.failed++;
+      return result.fail(error);
+    }
+  }
+  async callAxios(ctx, cancelToken) {
+    const response = await this.axiosInstance.request({
+      url: ctx.url,
+      method: ctx.method,
+      data: ctx.data,
+      headers: ctx.headers,
+      params: ctx.params,
+      timeout: ctx.timeout,
+      cancelToken
+    });
+    return {
+      data: response.data,
+      status: response.status,
+      headers: response.headers
+    };
+  }
+  async withRetry(fn, config) {
+    let lastError;
+    for (let attempt = 0; attempt <= config.attempts; attempt++) {
+      try {
+        return await fn();
+      } catch (e) {
+        lastError = e;
+        if (attempt === config.attempts) break;
+        const error = this.isHttpClientError(e) ? e : this.normalizeError(e);
+        if (!config.shouldRetry(error, attempt)) break;
+        this._metrics.retried++;
+        const baseDelay = config.delayMs * Math.pow(2, attempt);
+        const jitter = config.jitter ? Math.random() * config.delayMs : 0;
+        const delay = Math.min(baseDelay + jitter, config.maxDelayMs);
+        await new Promise((resolve) => setTimeout(resolve, delay));
+      }
+    }
+    throw lastError;
+  }
+  normalizeError(error) {
+    if (axios2__default.default.isCancel(error)) {
+      return {
+        type: "cancelled",
+        message: error.message ?? "Request cancelled"
+      };
+    }
+    if (axios2__default.default.isAxiosError(error)) {
+      const code = error.code;
+      if (code === "ECONNABORTED" || code === "ETIMEDOUT") {
+        return { type: "timeout", message: error.message, cause: error };
+      }
+      if (!error.response) {
+        return { type: "network", message: error.message, cause: error };
+      }
+      return {
+        type: "http",
+        message: error.message,
+        status: error.response.status,
+        data: error.response.data,
+        cause: error
+      };
+    }
+    return { type: "network", message: "Unexpected error", cause: error };
+  }
+  isHttpClientError(e) {
+    return typeof e === "object" && e !== null && "type" in e && "message" in e && typeof e.type === "string";
+  }
+};
+
+exports.CancelManager = CancelManager;
+exports.HttpClient = HttpClient;
+exports.__decorateClass = __decorateClass;
+//# sourceMappingURL=chunk-GZWQJKYR.cjs.map
+//# sourceMappingURL=chunk-GZWQJKYR.cjs.map

package/dist/chunk-GZWQJKYR.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/cancel-manager.ts","../src/core/http-client.ts"],"names":["axios","CircuitBreaker","DEFAULT_CIRCUIT_BREAKER_CONFIG","isHttpServerError","Pipeline","fail","CircuitBreakerOpenError","ok"],"mappings":"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","file":"chunk-GZWQJKYR.cjs","sourcesContent":["import axios from 'axios';\nimport type { CancelTokenSource } from 'axios';\n\nexport class CancelManager {\n  private readonly tokens = new Map<string, CancelTokenSource>();\n\n  getOrCreate(key: string): CancelTokenSource {\n    const existing = this.tokens.get(key);\n    if (existing) return existing;\n    const source = axios.CancelToken.source();\n    this.tokens.set(key, source);\n    return source;\n  }\n\n  cancel(key: string, reason?: string): void {\n    const source = this.tokens.get(key);\n    if (source) {\n      source.cancel(reason ?? `Request ${key} cancelled`);\n      this.tokens.delete(key);\n    }\n  }\n\n  cancelAll(): void {\n    for (const [key, source] of this.tokens) {\n      source.cancel(`Request ${key} cancelled`);\n    }\n    this.tokens.clear();\n  }\n\n  delete(key: string): void {\n    this.tokens.delete(key);\n  }\n\n  has(key: string): boolean {\n    return this.tokens.has(key);\n  }\n\n  get size(): number {\n    return this.tokens.size;\n  }\n}\n","import axios from 'axios';\nimport type { AxiosInstance, CancelToken } from 'axios';\nimport { ok, fail } from '@backendkit-labs/result';\nimport type { Result } from '@backendkit-labs/result';\nimport { CircuitBreaker, CircuitBreakerOpenError, DEFAULT_CIRCUIT_BREAKER_CONFIG, isHttpServerError } from '@backendkit-labs/circuit-breaker';\nimport type { CircuitBreakerConfig } from '@backendkit-labs/circuit-breaker';\nimport { Pipeline } from '@backendkit-labs/pipeline';\nimport { CancelManager } from './cancel-manager.js';\nimport type {\n  HttpClientConfig,\n  HttpClientError,\n  HttpCtx,\n  HttpMetrics,\n  HttpResponse,\n  RequestConfig,\n  RetryConfig,\n} from './types.js';\n\nconst DEFAULT_RETRY: Required<RetryConfig> = {\n  attempts:    0,\n  delayMs:     100,\n  maxDelayMs:  5_000,\n  jitter:      true,\n  shouldRetry: (e) =>\n    e.type === 'network' || e.type === 'timeout' || (e.type === 'http' && (e.status ?? 0) >= 500),\n};\n\nexport class HttpClient {\n  private readonly axiosInstance: AxiosInstance;\n  private readonly cb:            CircuitBreaker | undefined;\n  private readonly pipeline:      Pipeline<HttpCtx, HttpClientError>;\n  private readonly retry:         Required<RetryConfig>;\n  private readonly cancelMgr      = new CancelManager();\n  private readonly _metrics: HttpMetrics = {\n    requests: 0, success: 0, failed: 0, cancelled: 0, circuitOpen: 0, retried: 0,\n  };\n\n  constructor(config: HttpClientConfig = {}) {\n    this.axiosInstance = axios.create({\n      baseURL: config.baseURL,\n      timeout: config.timeout ?? 10_000,\n      headers: config.headers,\n    });\n\n    if (config.circuitBreaker) {\n      const { name: cbName, ...cbRest } = config.circuitBreaker;\n      this.cb = new CircuitBreaker({\n        name:      cbName ?? 'http-client',\n        ...DEFAULT_CIRCUIT_BREAKER_CONFIG,\n        isFailure: isHttpServerError,\n        ...cbRest,\n      } as CircuitBreakerConfig);\n    }\n\n    const p = new Pipeline<HttpCtx, HttpClientError>();\n    for (const step of config.steps ?? []) p.pipe(step);\n    this.pipeline = p;\n\n    this.retry = config.retry\n      ? { ...DEFAULT_RETRY, ...config.retry }\n      : DEFAULT_RETRY;\n  }\n\n  // ── HTTP methods ──────────────────────────────────────────────────────────\n\n  get<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('GET', url, undefined, config);\n  }\n\n  post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('POST', url, data, config);\n  }\n\n  put<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('PUT', url, data, config);\n  }\n\n  patch<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('PATCH', url, data, config);\n  }\n\n  delete<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    return this.execute<T>('DELETE', url, undefined, config);\n  }\n\n  // ── Cancellation ──────────────────────────────────────────────────────────\n\n  cancelRequest(key: string): void {\n    this.cancelMgr.cancel(key);\n    this._metrics.cancelled++;\n  }\n\n  cancelAll(): void {\n    const count = this.cancelMgr.size;\n    this.cancelMgr.cancelAll();\n    this._metrics.cancelled += count;\n  }\n\n  // ── Observability ─────────────────────────────────────────────────────────\n\n  getMetrics(): Readonly<HttpMetrics> {\n    return { ...this._metrics };\n  }\n\n  getCircuitBreakerState() {\n    return this.cb?.getState();\n  }\n\n  getCircuitBreakerMetrics() {\n    return this.cb?.getMetrics();\n  }\n\n  // ── Internal ──────────────────────────────────────────────────────────────\n\n  private async execute<T>(\n    method:  string,\n    url:     string,\n    data:    unknown,\n    config:  RequestConfig = {},\n  ): Promise<Result<HttpResponse<T>, HttpClientError>> {\n    this._metrics.requests++;\n\n    const initialCtx: HttpCtx = {\n      url,\n      method,\n      data,\n      headers:       config.headers ?? {},\n      params:        config.params,\n      timeout:       config.timeout,\n      cancelKey:     config.cancelKey,\n      correlationId: config.correlationId,\n    };\n\n    // Pre-register cancel token synchronously so callers can cancel before the request fires\n    if (initialCtx.cancelKey) {\n      this.cancelMgr.getOrCreate(initialCtx.cancelKey);\n    }\n\n    // Pre-request middleware pipeline\n    const pipelineResult = await this.pipeline.run(initialCtx);\n    if (!pipelineResult.ok) {\n      this._metrics.failed++;\n      return fail(pipelineResult.error.cause);\n    }\n\n    const ctx = pipelineResult.value;\n\n    // If the cancel key was cancelled during the pipeline, bail out immediately\n    if (ctx.cancelKey && !this.cancelMgr.has(ctx.cancelKey)) {\n      this._metrics.failed++;\n      return fail({ type: 'cancelled', message: `Request ${ctx.cancelKey} cancelled` });\n    }\n\n    const cancelToken = ctx.cancelKey\n      ? this.cancelMgr.getOrCreate(ctx.cancelKey).token\n      : undefined;\n\n    // Raw axios call — throws on any error\n    const rawCall = () => this.callAxios<T>(ctx, cancelToken);\n\n    // Circuit breaker wraps the raw call — throws CircuitBreakerOpenError when open\n    const cbCall = async (): Promise<HttpResponse<T>> => {\n      if (!this.cb) return rawCall();\n      try {\n        return await this.cb.execute(rawCall);\n      } catch (e) {\n        if (e instanceof CircuitBreakerOpenError) {\n          this._metrics.circuitOpen++;\n          const err: HttpClientError = { type: 'circuit-open', message: e.message };\n          throw err;\n        }\n        throw e;\n      }\n    };\n\n    try {\n      const response = this.retry.attempts > 0\n        ? await this.withRetry(cbCall, this.retry)\n        : await cbCall();\n\n      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);\n      this._metrics.success++;\n      return ok(response);\n    } catch (e) {\n      if (ctx.cancelKey) this.cancelMgr.delete(ctx.cancelKey);\n      const error = this.isHttpClientError(e) ? e : this.normalizeError(e);\n      if (error.type !== 'circuit-open') this._metrics.failed++;\n      return fail(error);\n    }\n  }\n\n  private async callAxios<T>(ctx: HttpCtx, cancelToken?: CancelToken): Promise<HttpResponse<T>> {\n    const response = await this.axiosInstance.request<T>({\n      url:         ctx.url,\n      method:      ctx.method,\n      data:        ctx.data,\n      headers:     ctx.headers,\n      params:      ctx.params,\n      timeout:     ctx.timeout,\n      cancelToken,\n    });\n\n    return {\n      data:    response.data,\n      status:  response.status,\n      headers: response.headers as Record<string, string>,\n    };\n  }\n\n  private async withRetry<T>(\n    fn:     () => Promise<T>,\n    config: Required<RetryConfig>,\n  ): Promise<T> {\n    let lastError: unknown;\n\n    for (let attempt = 0; attempt <= config.attempts; attempt++) {\n      try {\n        return await fn();\n      } catch (e) {\n        lastError = e;\n\n        if (attempt === config.attempts) break;\n\n        const error = this.isHttpClientError(e) ? e : this.normalizeError(e);\n        if (!config.shouldRetry(error, attempt)) break;\n\n        this._metrics.retried++;\n\n        const baseDelay = config.delayMs * Math.pow(2, attempt);\n        const jitter    = config.jitter ? Math.random() * config.delayMs : 0;\n        const delay     = Math.min(baseDelay + jitter, config.maxDelayMs);\n\n        await new Promise(resolve => setTimeout(resolve, delay));\n      }\n    }\n\n    throw lastError;\n  }\n\n  private normalizeError(error: unknown): HttpClientError {\n    if (axios.isCancel(error)) {\n      return {\n        type:    'cancelled',\n        message: (error as { message?: string }).message ?? 'Request cancelled',\n      };\n    }\n\n    if (axios.isAxiosError(error)) {\n      const code = error.code;\n      if (code === 'ECONNABORTED' || code === 'ETIMEDOUT') {\n        return { type: 'timeout', message: error.message, cause: error };\n      }\n      if (!error.response) {\n        return { type: 'network', message: error.message, cause: error };\n      }\n      return {\n        type:    'http',\n        message: error.message,\n        status:  error.response.status,\n        data:    error.response.data,\n        cause:   error,\n      };\n    }\n\n    return { type: 'network', message: 'Unexpected error', cause: error };\n  }\n\n  private isHttpClientError(e: unknown): e is HttpClientError {\n    return (\n      typeof e === 'object' &&\n      e !== null &&\n      'type' in e &&\n      'message' in e &&\n      typeof (e as HttpClientError).type === 'string'\n    );\n  }\n}\n"]}

package/dist/index.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+var chunkGZWQJKYR_cjs = require('./chunk-GZWQJKYR.cjs');
+
+// src/core/types.ts
+var HttpClientToken = class {
+  description;
+  symbol;
+  constructor(name) {
+    this.description = `HttpClient(${name})`;
+    this.symbol = /* @__PURE__ */ Symbol(`HttpClient(${name})`);
+  }
+};
+function defineHttpClient(name) {
+  return new HttpClientToken(name);
+}
+
+Object.defineProperty(exports, "CancelManager", {
+  enumerable: true,
+  get: function () { return chunkGZWQJKYR_cjs.CancelManager; }
+});
+Object.defineProperty(exports, "HttpClient", {
+  enumerable: true,
+  get: function () { return chunkGZWQJKYR_cjs.HttpClient; }
+});
+exports.HttpClientToken = HttpClientToken;
+exports.defineHttpClient = defineHttpClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types.ts"],"names":[],"mappings":";;;;;AAwEO,IAAM,kBAAN,MAAsB;AAAA,EAClB,WAAA;AAAA,EACA,MAAA;AAAA,EAIT,YAAY,IAAA,EAAc;AACxB,IAAA,IAAA,CAAK,WAAA,GAAc,cAAc,IAAI,CAAA,CAAA,CAAA;AACrC,IAAA,IAAA,CAAK,MAAA,mBAAc,MAAA,CAAO,CAAA,WAAA,EAAc,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,EACjD;AACF;AAEO,SAAS,iBAAiB,IAAA,EAA+B;AAC9D,EAAA,OAAO,IAAI,gBAAgB,IAAI,CAAA;AACjC","file":"index.cjs","sourcesContent":["import type { PipelineStep } from '@backendkit-labs/pipeline';\nimport type { CircuitBreakerOptions, CircuitBreakerState, CircuitBreakerMetrics } from '@backendkit-labs/circuit-breaker';\n\nexport type { CircuitBreakerState, CircuitBreakerMetrics };\n\nexport type HttpErrorType = 'http' | 'network' | 'cancelled' | 'circuit-open' | 'timeout';\n\nexport interface HttpClientError {\n  type:     HttpErrorType;\n  message:  string;\n  status?:  number;\n  data?:    unknown;\n  cause?:   unknown;\n}\n\nexport interface HttpResponse<T = unknown> {\n  data:    T;\n  status:  number;\n  headers: Record<string, string>;\n}\n\n/** Mutable context passed through the pre-request pipeline steps. */\nexport interface HttpCtx {\n  url:           string;\n  method:        string;\n  data?:         unknown;\n  headers:       Record<string, string>;\n  params?:       Record<string, unknown>;\n  timeout?:      number;\n  cancelKey?:    string;\n  correlationId?: string;\n}\n\nexport interface RequestConfig {\n  headers?:       Record<string, string>;\n  params?:        Record<string, unknown>;\n  timeout?:       number;\n  /** Key used to identify and cancel this request programmatically. */\n  cancelKey?:     string;\n  correlationId?: string;\n}\n\nexport interface RetryConfig {\n  /** Number of retry attempts after the first failure. */\n  attempts:    number;\n  delayMs?:    number;\n  maxDelayMs?: number;\n  jitter?:     boolean;\n  /** Return false to stop retrying on a specific error. */\n  shouldRetry?: (error: HttpClientError, attempt: number) => boolean;\n}\n\nexport interface HttpClientConfig {\n  baseURL?:       string;\n  timeout?:       number;\n  headers?:       Record<string, string>;\n  circuitBreaker?: CircuitBreakerOptions;\n  retry?:         RetryConfig;\n  /** Pre-request pipeline steps. Receive and transform the HttpCtx before the call is made. */\n  steps?:         PipelineStep<HttpCtx, HttpClientError>[];\n}\n\nexport interface HttpMetrics {\n  requests:    number;\n  success:     number;\n  failed:      number;\n  cancelled:   number;\n  circuitOpen: number;\n  retried:     number;\n}\n\n/** Typed injection token for named HTTP clients. */\nexport class HttpClientToken {\n  readonly description: string;\n  readonly symbol:      symbol;\n\n  declare readonly _phantom: never;\n\n  constructor(name: string) {\n    this.description = `HttpClient(${name})`;\n    this.symbol      = Symbol(`HttpClient(${name})`);\n  }\n}\n\nexport function defineHttpClient(name: string): HttpClientToken {\n  return new HttpClientToken(name);\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,44 @@
+import * as _backendkit_labs_circuit_breaker from '@backendkit-labs/circuit-breaker';
+export { CircuitBreakerMetrics, CircuitBreakerState } from '@backendkit-labs/circuit-breaker';
+import { Result } from '@backendkit-labs/result';
+import { H as HttpClientConfig, R as RequestConfig, a as HttpResponse, b as HttpClientError, c as HttpMetrics } from './types-x0zPV-KD.cjs';
+export { d as HttpClientToken, e as HttpCtx, f as HttpErrorType, g as RetryConfig, h as defineHttpClient } from './types-x0zPV-KD.cjs';
+import { CancelTokenSource } from 'axios';
+import '@backendkit-labs/pipeline';
+
+declare class HttpClient {
+    private readonly axiosInstance;
+    private readonly cb;
+    private readonly pipeline;
+    private readonly retry;
+    private readonly cancelMgr;
+    private readonly _metrics;
+    constructor(config?: HttpClientConfig);
+    get<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    put<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    patch<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    delete<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    cancelRequest(key: string): void;
+    cancelAll(): void;
+    getMetrics(): Readonly<HttpMetrics>;
+    getCircuitBreakerState(): _backendkit_labs_circuit_breaker.CircuitBreakerState | undefined;
+    getCircuitBreakerMetrics(): _backendkit_labs_circuit_breaker.CircuitBreakerMetrics | undefined;
+    private execute;
+    private callAxios;
+    private withRetry;
+    private normalizeError;
+    private isHttpClientError;
+}
+
+declare class CancelManager {
+    private readonly tokens;
+    getOrCreate(key: string): CancelTokenSource;
+    cancel(key: string, reason?: string): void;
+    cancelAll(): void;
+    delete(key: string): void;
+    has(key: string): boolean;
+    get size(): number;
+}
+
+export { CancelManager, HttpClient, HttpClientConfig, HttpClientError, HttpMetrics, HttpResponse, RequestConfig };

package/dist/index.d.ts

@@ -0,0 +1,44 @@
+import * as _backendkit_labs_circuit_breaker from '@backendkit-labs/circuit-breaker';
+export { CircuitBreakerMetrics, CircuitBreakerState } from '@backendkit-labs/circuit-breaker';
+import { Result } from '@backendkit-labs/result';
+import { H as HttpClientConfig, R as RequestConfig, a as HttpResponse, b as HttpClientError, c as HttpMetrics } from './types-x0zPV-KD.js';
+export { d as HttpClientToken, e as HttpCtx, f as HttpErrorType, g as RetryConfig, h as defineHttpClient } from './types-x0zPV-KD.js';
+import { CancelTokenSource } from 'axios';
+import '@backendkit-labs/pipeline';
+
+declare class HttpClient {
+    private readonly axiosInstance;
+    private readonly cb;
+    private readonly pipeline;
+    private readonly retry;
+    private readonly cancelMgr;
+    private readonly _metrics;
+    constructor(config?: HttpClientConfig);
+    get<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    post<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    put<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    patch<T>(url: string, data?: unknown, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    delete<T>(url: string, config?: RequestConfig): Promise<Result<HttpResponse<T>, HttpClientError>>;
+    cancelRequest(key: string): void;
+    cancelAll(): void;
+    getMetrics(): Readonly<HttpMetrics>;
+    getCircuitBreakerState(): _backendkit_labs_circuit_breaker.CircuitBreakerState | undefined;
+    getCircuitBreakerMetrics(): _backendkit_labs_circuit_breaker.CircuitBreakerMetrics | undefined;
+    private execute;
+    private callAxios;
+    private withRetry;
+    private normalizeError;
+    private isHttpClientError;
+}
+
+declare class CancelManager {
+    private readonly tokens;
+    getOrCreate(key: string): CancelTokenSource;
+    cancel(key: string, reason?: string): void;
+    cancelAll(): void;
+    delete(key: string): void;
+    has(key: string): boolean;
+    get size(): number;
+}
+
+export { CancelManager, HttpClient, HttpClientConfig, HttpClientError, HttpMetrics, HttpResponse, RequestConfig };

package/dist/index.js

@@ -0,0 +1,18 @@
+export { CancelManager, HttpClient } from './chunk-5RHNUUOY.js';
+
+// src/core/types.ts
+var HttpClientToken = class {
+  description;
+  symbol;
+  constructor(name) {
+    this.description = `HttpClient(${name})`;
+    this.symbol = /* @__PURE__ */ Symbol(`HttpClient(${name})`);
+  }
+};
+function defineHttpClient(name) {
+  return new HttpClientToken(name);
+}
+
+export { HttpClientToken, defineHttpClient };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/types.ts"],"names":[],"mappings":";;;AAwEO,IAAM,kBAAN,MAAsB;AAAA,EAClB,WAAA;AAAA,EACA,MAAA;AAAA,EAIT,YAAY,IAAA,EAAc;AACxB,IAAA,IAAA,CAAK,WAAA,GAAc,cAAc,IAAI,CAAA,CAAA,CAAA;AACrC,IAAA,IAAA,CAAK,MAAA,mBAAc,MAAA,CAAO,CAAA,WAAA,EAAc,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,EACjD;AACF;AAEO,SAAS,iBAAiB,IAAA,EAA+B;AAC9D,EAAA,OAAO,IAAI,gBAAgB,IAAI,CAAA;AACjC","file":"index.js","sourcesContent":["import type { PipelineStep } from '@backendkit-labs/pipeline';\nimport type { CircuitBreakerOptions, CircuitBreakerState, CircuitBreakerMetrics } from '@backendkit-labs/circuit-breaker';\n\nexport type { CircuitBreakerState, CircuitBreakerMetrics };\n\nexport type HttpErrorType = 'http' | 'network' | 'cancelled' | 'circuit-open' | 'timeout';\n\nexport interface HttpClientError {\n  type:     HttpErrorType;\n  message:  string;\n  status?:  number;\n  data?:    unknown;\n  cause?:   unknown;\n}\n\nexport interface HttpResponse<T = unknown> {\n  data:    T;\n  status:  number;\n  headers: Record<string, string>;\n}\n\n/** Mutable context passed through the pre-request pipeline steps. */\nexport interface HttpCtx {\n  url:           string;\n  method:        string;\n  data?:         unknown;\n  headers:       Record<string, string>;\n  params?:       Record<string, unknown>;\n  timeout?:      number;\n  cancelKey?:    string;\n  correlationId?: string;\n}\n\nexport interface RequestConfig {\n  headers?:       Record<string, string>;\n  params?:        Record<string, unknown>;\n  timeout?:       number;\n  /** Key used to identify and cancel this request programmatically. */\n  cancelKey?:     string;\n  correlationId?: string;\n}\n\nexport interface RetryConfig {\n  /** Number of retry attempts after the first failure. */\n  attempts:    number;\n  delayMs?:    number;\n  maxDelayMs?: number;\n  jitter?:     boolean;\n  /** Return false to stop retrying on a specific error. */\n  shouldRetry?: (error: HttpClientError, attempt: number) => boolean;\n}\n\nexport interface HttpClientConfig {\n  baseURL?:       string;\n  timeout?:       number;\n  headers?:       Record<string, string>;\n  circuitBreaker?: CircuitBreakerOptions;\n  retry?:         RetryConfig;\n  /** Pre-request pipeline steps. Receive and transform the HttpCtx before the call is made. */\n  steps?:         PipelineStep<HttpCtx, HttpClientError>[];\n}\n\nexport interface HttpMetrics {\n  requests:    number;\n  success:     number;\n  failed:      number;\n  cancelled:   number;\n  circuitOpen: number;\n  retried:     number;\n}\n\n/** Typed injection token for named HTTP clients. */\nexport class HttpClientToken {\n  readonly description: string;\n  readonly symbol:      symbol;\n\n  declare readonly _phantom: never;\n\n  constructor(name: string) {\n    this.description = `HttpClient(${name})`;\n    this.symbol      = Symbol(`HttpClient(${name})`);\n  }\n}\n\nexport function defineHttpClient(name: string): HttpClientToken {\n  return new HttpClientToken(name);\n}\n"]}

package/dist/nestjs/index.cjs

@@ -0,0 +1,78 @@
+'use strict';
+
+var chunkGZWQJKYR_cjs = require('../chunk-GZWQJKYR.cjs');
+var common = require('@nestjs/common');
+
+var HTTP_CLIENT_MODULE_OPTIONS = "HTTP_CLIENT_MODULE_OPTIONS";
+exports.HttpClientModule = class HttpClientModule {
+  static forRoot(options) {
+    const providers = options.clients.map(
+      ({ token, config }) => exports.HttpClientModule._clientProvider(token, config)
+    );
+    return {
+      module: exports.HttpClientModule,
+      providers,
+      exports: providers,
+      global: true
+    };
+  }
+  static forRootAsync(options) {
+    const asyncProvider = exports.HttpClientModule._asyncOptionsProvider(options);
+    const clientsProvider = {
+      provide: "HTTP_CLIENT_INSTANCES",
+      useFactory: (opts) => {
+        return opts.clients.map(({ token, config }) => ({
+          token,
+          instance: new chunkGZWQJKYR_cjs.HttpClient(config)
+        }));
+      },
+      inject: [HTTP_CLIENT_MODULE_OPTIONS]
+    };
+    const allProviders = [
+      asyncProvider,
+      clientsProvider
+    ];
+    return {
+      module: exports.HttpClientModule,
+      imports: options.imports ?? [],
+      providers: allProviders,
+      exports: allProviders,
+      global: true
+    };
+  }
+  static _clientProvider(token, config) {
+    return {
+      provide: token.symbol,
+      useFactory: () => new chunkGZWQJKYR_cjs.HttpClient(config)
+    };
+  }
+  static _asyncOptionsProvider(options) {
+    if (options.useFactory) {
+      return {
+        provide: HTTP_CLIENT_MODULE_OPTIONS,
+        useFactory: options.useFactory,
+        inject: options.inject ?? []
+      };
+    }
+    const cls = options.useExisting ?? options.useClass;
+    if (cls) {
+      return {
+        provide: HTTP_CLIENT_MODULE_OPTIONS,
+        useFactory: (factory) => factory.createHttpClientOptions(),
+        inject: [cls]
+      };
+    }
+    return {
+      provide: HTTP_CLIENT_MODULE_OPTIONS,
+      useValue: { clients: [] }
+    };
+  }
+};
+exports.HttpClientModule = chunkGZWQJKYR_cjs.__decorateClass([
+  common.Module({})
+], exports.HttpClientModule);
+var InjectHttpClient = (token) => common.Inject(token.symbol);
+
+exports.InjectHttpClient = InjectHttpClient;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/nestjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/nestjs/http-client.module.ts","../../src/nestjs/http-client.decorator.ts"],"names":["HttpClientModule","HttpClient","__decorateClass","Module","Inject"],"mappings":";;;;;AAUA,IAAM,0BAAA,GAA6B,4BAAA;AAGtBA,2BAAN,sBAAA,CAAuB;AAAA,EAC5B,OAAO,QAAQ,OAAA,EAAiD;AAC9D,IAAA,MAAM,SAAA,GAAwB,QAAQ,OAAA,CAAQ,GAAA;AAAA,MAAI,CAAC,EAAE,KAAA,EAAO,MAAA,OAC1DA,wBAAA,CAAiB,eAAA,CAAgB,OAAO,MAAM;AAAA,KAChD;AAEA,IAAA,OAAO;AAAA,MACL,MAAA,EAAUA,wBAAA;AAAA,MACV,SAAA;AAAA,MACA,OAAA,EAAU,SAAA;AAAA,MACV,MAAA,EAAU;AAAA,KACZ;AAAA,EACF;AAAA,EAEA,OAAO,aAAa,OAAA,EAAsD;AACxE,IAAA,MAAM,aAAA,GAAgBA,wBAAA,CAAiB,qBAAA,CAAsB,OAAO,CAAA;AAEpE,IAAA,MAAM,eAAA,GAA4B;AAAA,MAChC,OAAA,EAAY,uBAAA;AAAA,MACZ,UAAA,EAAY,CAAC,IAAA,KAAkC;AAC7C,QAAA,OAAO,KAAK,OAAA,CAAQ,GAAA,CAAI,CAAC,EAAE,KAAA,EAAO,QAAO,MAAO;AAAA,UAC9C,KAAA;AAAA,UACA,QAAA,EAAU,IAAIC,4BAAA,CAAW,MAAM;AAAA,SACjC,CAAE,CAAA;AAAA,MACJ,CAAA;AAAA,MACA,MAAA,EAAQ,CAAC,0BAA0B;AAAA,KACrC;AAEA,IAAA,MAAM,YAAA,GAA2B;AAAA,MAC/B,aAAA;AAAA,MACA;AAAA,KACF;AAEA,IAAA,OAAO;AAAA,MACL,MAAA,EAAUD,wBAAA;AAAA,MACV,OAAA,EAAU,OAAA,CAAQ,OAAA,IAAW,EAAC;AAAA,MAC9B,SAAA,EAAW,YAAA;AAAA,MACX,OAAA,EAAU,YAAA;AAAA,MACV,MAAA,EAAU;AAAA,KACZ;AAAA,EACF;AAAA,EAEA,OAAe,eAAA,CAAgB,KAAA,EAAwB,MAAA,EAAoC;AACzF,IAAA,OAAO;AAAA,MACL,SAAY,KAAA,CAAM,MAAA;AAAA,MAClB,UAAA,EAAY,MAAM,IAAIC,4BAAA,CAAW,MAAM;AAAA,KACzC;AAAA,EACF;AAAA,EAEA,OAAe,sBAAsB,OAAA,EAAiD;AACpF,IAAA,IAAI,QAAQ,UAAA,EAAY;AACtB,MAAA,OAAO;AAAA,QACL,OAAA,EAAY,0BAAA;AAAA,QACZ,YAAY,OAAA,CAAQ,UAAA;AAAA,QACpB,MAAA,EAAa,OAAA,CAAQ,MAAA,IAAU;AAAC,OAClC;AAAA,IACF;AAEA,IAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,WAAA,IAAe,OAAA,CAAQ,QAAA;AAC3C,IAAA,IAAI,GAAA,EAAK;AACP,MAAA,OAAO;AAAA,QACL,OAAA,EAAY,0BAAA;AAAA,QACZ,UAAA,EAAY,CAAC,OAAA,KAAsC,OAAA,CAAQ,uBAAA,EAAwB;AAAA,QACnF,MAAA,EAAY,CAAC,GAAqC;AAAA,OACpD;AAAA,IACF;AAEA,IAAA,OAAO;AAAA,MACL,OAAA,EAAU,0BAAA;AAAA,MACV,QAAA,EAAU,EAAE,OAAA,EAAS,EAAC;AAAE,KAC1B;AAAA,EACF;AACF;AAxEaD,wBAAA,GAANE,iCAAA,CAAA;AAAA,EADNC,aAAA,CAAO,EAAE;AAAA,CAAA,EACGH,wBAAA,CAAA;ACVN,IAAM,gBAAA,GAAmB,CAC9B,KAAA,KAC8BI,aAAA,CAAO,MAAM,MAAM","file":"index.cjs","sourcesContent":["import { Module, DynamicModule, Provider } from '@nestjs/common';\nimport type { Type, InjectionToken, OptionalFactoryDependency } from '@nestjs/common';\nimport { HttpClient } from '../core/http-client.js';\nimport type { HttpClientConfig, HttpClientToken } from '../core/types.js';\nimport type {\n  HttpClientModuleOptions,\n  HttpClientModuleAsyncOptions,\n  HttpClientOptionsFactory,\n} from './http-client.options.js';\n\nconst HTTP_CLIENT_MODULE_OPTIONS = 'HTTP_CLIENT_MODULE_OPTIONS';\n\n@Module({})\nexport class HttpClientModule {\n  static forRoot(options: HttpClientModuleOptions): DynamicModule {\n    const providers: Provider[] = options.clients.map(({ token, config }) =>\n      HttpClientModule._clientProvider(token, config),\n    );\n\n    return {\n      module:   HttpClientModule,\n      providers,\n      exports:  providers,\n      global:   true,\n    };\n  }\n\n  static forRootAsync(options: HttpClientModuleAsyncOptions): DynamicModule {\n    const asyncProvider = HttpClientModule._asyncOptionsProvider(options);\n\n    const clientsProvider: Provider = {\n      provide:    'HTTP_CLIENT_INSTANCES',\n      useFactory: (opts: HttpClientModuleOptions) => {\n        return opts.clients.map(({ token, config }) => ({\n          token,\n          instance: new HttpClient(config),\n        }));\n      },\n      inject: [HTTP_CLIENT_MODULE_OPTIONS],\n    };\n\n    const allProviders: Provider[] = [\n      asyncProvider,\n      clientsProvider,\n    ];\n\n    return {\n      module:   HttpClientModule,\n      imports:  options.imports ?? [],\n      providers: allProviders,\n      exports:  allProviders,\n      global:   true,\n    };\n  }\n\n  private static _clientProvider(token: HttpClientToken, config: HttpClientConfig): Provider {\n    return {\n      provide:    token.symbol,\n      useFactory: () => new HttpClient(config),\n    };\n  }\n\n  private static _asyncOptionsProvider(options: HttpClientModuleAsyncOptions): Provider {\n    if (options.useFactory) {\n      return {\n        provide:    HTTP_CLIENT_MODULE_OPTIONS,\n        useFactory: options.useFactory as (...args: unknown[]) => HttpClientModuleOptions | Promise<HttpClientModuleOptions>,\n        inject:     (options.inject ?? []) as (InjectionToken | OptionalFactoryDependency)[],\n      };\n    }\n\n    const cls = options.useExisting ?? options.useClass;\n    if (cls) {\n      return {\n        provide:    HTTP_CLIENT_MODULE_OPTIONS,\n        useFactory: (factory: HttpClientOptionsFactory) => factory.createHttpClientOptions(),\n        inject:     [cls as Type<HttpClientOptionsFactory>],\n      };\n    }\n\n    return {\n      provide:  HTTP_CLIENT_MODULE_OPTIONS,\n      useValue: { clients: [] } satisfies HttpClientModuleOptions,\n    };\n  }\n}\n","import { Inject } from '@nestjs/common';\nimport type { HttpClientToken } from '../core/types.js';\n\nexport const InjectHttpClient = (\n  token: HttpClientToken,\n): ReturnType<typeof Inject> => Inject(token.symbol);\n"]}

package/dist/nestjs/index.d.cts

@@ -0,0 +1,32 @@
+import { ModuleMetadata, Type, InjectionToken, OptionalFactoryDependency, DynamicModule, Inject } from '@nestjs/common';
+import { d as HttpClientToken, H as HttpClientConfig } from '../types-x0zPV-KD.cjs';
+import '@backendkit-labs/pipeline';
+import '@backendkit-labs/circuit-breaker';
+
+interface HttpClientDefinition {
+    token: HttpClientToken;
+    config: HttpClientConfig;
+}
+interface HttpClientModuleOptions {
+    clients: HttpClientDefinition[];
+}
+interface HttpClientOptionsFactory {
+    createHttpClientOptions(): Promise<HttpClientModuleOptions> | HttpClientModuleOptions;
+}
+interface HttpClientModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useFactory?: (...args: unknown[]) => Promise<HttpClientModuleOptions> | HttpClientModuleOptions;
+    useClass?: Type<HttpClientOptionsFactory>;
+    useExisting?: Type<HttpClientOptionsFactory>;
+    inject?: (InjectionToken | OptionalFactoryDependency)[];
+}
+
+declare class HttpClientModule {
+    static forRoot(options: HttpClientModuleOptions): DynamicModule;
+    static forRootAsync(options: HttpClientModuleAsyncOptions): DynamicModule;
+    private static _clientProvider;
+    private static _asyncOptionsProvider;
+}
+
+declare const InjectHttpClient: (token: HttpClientToken) => ReturnType<typeof Inject>;
+
+export { type HttpClientDefinition, HttpClientModule, type HttpClientModuleAsyncOptions, type HttpClientModuleOptions, type HttpClientOptionsFactory, InjectHttpClient };

package/dist/nestjs/index.d.ts

@@ -0,0 +1,32 @@
+import { ModuleMetadata, Type, InjectionToken, OptionalFactoryDependency, DynamicModule, Inject } from '@nestjs/common';
+import { d as HttpClientToken, H as HttpClientConfig } from '../types-x0zPV-KD.js';
+import '@backendkit-labs/pipeline';
+import '@backendkit-labs/circuit-breaker';
+
+interface HttpClientDefinition {
+    token: HttpClientToken;
+    config: HttpClientConfig;
+}
+interface HttpClientModuleOptions {
+    clients: HttpClientDefinition[];
+}
+interface HttpClientOptionsFactory {
+    createHttpClientOptions(): Promise<HttpClientModuleOptions> | HttpClientModuleOptions;
+}
+interface HttpClientModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    useFactory?: (...args: unknown[]) => Promise<HttpClientModuleOptions> | HttpClientModuleOptions;
+    useClass?: Type<HttpClientOptionsFactory>;
+    useExisting?: Type<HttpClientOptionsFactory>;
+    inject?: (InjectionToken | OptionalFactoryDependency)[];
+}
+
+declare class HttpClientModule {
+    static forRoot(options: HttpClientModuleOptions): DynamicModule;
+    static forRootAsync(options: HttpClientModuleAsyncOptions): DynamicModule;
+    private static _clientProvider;
+    private static _asyncOptionsProvider;
+}
+
+declare const InjectHttpClient: (token: HttpClientToken) => ReturnType<typeof Inject>;
+
+export { type HttpClientDefinition, HttpClientModule, type HttpClientModuleAsyncOptions, type HttpClientModuleOptions, type HttpClientOptionsFactory, InjectHttpClient };