@api-wrappers/api-core 1.0.0 → 1.0.2

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 //#region src/types/common.d.ts
 type MaybePromise<T> = T | Promise<T>;
+type HeaderInput = HeadersInit;
 type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
 type QueryPrimitive = string | number | boolean;
 type QueryValue = QueryPrimitive | null | undefined | readonly (QueryPrimitive | null | undefined)[];
@@ -90,7 +91,7 @@ interface GraphQLRequestOptions<TVariables extends object = Record<string, unkno
    * Additional headers merged on top of `ClientConfig.defaultHeaders` for
    * this request only. `content-type: application/json` is always set.
    */
-  headers?: Record<string, string>;
+  headers?: HeaderInput;
   /**
    * Optional caller-provided abort signal. Composes with `timeoutMs`.
    */
@@ -175,6 +176,7 @@ interface ApiPlugin {
 }
 //#endregion
 //#region src/transport/types.d.ts
+type FetchLike = (input: string | URL | Request, init?: RequestInit) => Promise<Response>;
 interface Transport {
   execute(ctx: RequestContext): Promise<Response>;
 }
@@ -226,7 +228,7 @@ interface ClientConfig {
    * precedence. `content-type: application/json` is always present as the
    * lowest-priority default.
    */
-  defaultHeaders?: Record<string, string>;
+  defaultHeaders?: HeaderInput;
   /** Plugins registered for the lifetime of this client. */
   plugins?: ApiPlugin[];
   /**
@@ -241,7 +243,7 @@ interface ClientConfig {
    * Ignored when a custom `transport` is provided.
    * @example `import fetch from "node-fetch"; createClient({ fetch })`
    */
-  fetch?: typeof globalThis.fetch;
+  fetch?: FetchLike;
   /**
    * Default request timeout in ms. Overridable per-request via
    * `RequestOptions.timeoutMs`. Throws {@link TimeoutError} when exceeded.
@@ -303,7 +305,7 @@ interface RequestOptions {
    * These take precedence; `content-type: application/json` is always
    * present and is the lowest-priority default.
    */
-  headers?: Record<string, string>;
+  headers?: HeaderInput;
   /** Request body. Serialised to JSON by {@link fetchTransport}. Ignored for GET and HEAD. */
   body?: unknown;
   /**
@@ -480,6 +482,46 @@ declare class ApiError extends Error {
   constructor(message: string, status: number, responseBody?: unknown, cause?: unknown);
 }
 //#endregion
+//#region src/graphql/GraphQLRequestError.d.ts
+/**
+ * Thrown when a GraphQL server returns a well-formed HTTP 200 response that
+ * contains a non-empty `errors` array.
+ *
+ * Extends {@link ApiError} so that code catching `ApiError` also catches
+ * GraphQL-level failures. Callers that need to inspect the individual error
+ * objects can narrow with `instanceof GraphQLRequestError` and read
+ * `graphqlErrors`.
+ *
+ * When the server returns both `data` and `errors` (partial result), the
+ * partial data is available on `partialData` but the error is still thrown —
+ * callers must explicitly opt in to consuming partial results.
+ *
+ * @example
+ * ```ts
+ * import { GraphQLRequestError } from "@api-wrappers/api-core";
+ *
+ * try {
+ *   const data = await client.graphql<MyQuery>("/graphql", { query: QUERY });
+ * } catch (err) {
+ *   if (err instanceof GraphQLRequestError) {
+ *     for (const e of err.graphqlErrors) {
+ *       console.error(e.message, e.path);
+ *     }
+ *   }
+ * }
+ * ```
+ */
+declare class GraphQLRequestError extends ApiError {
+  /** The errors array from the GraphQL response envelope. */
+  readonly graphqlErrors: readonly GraphQLErrorDetail[];
+  /**
+   * Partial `data` returned alongside `errors`, if any. `undefined` when
+   * the server returned no `data` field.
+   */
+  readonly partialData: unknown;
+  constructor(errors: GraphQLErrorDetail[], partialData?: unknown, cause?: unknown);
+}
+//#endregion
 //#region src/errors/RateLimitError.d.ts
 declare class RateLimitError extends ApiError {
   readonly retryAfterMs: number | undefined;
@@ -492,6 +534,14 @@ declare class TimeoutError extends Error {
   constructor(message?: string, cause?: unknown);
 }
 //#endregion
+//#region src/errors/guards.d.ts
+type ApiCoreError = ApiError | RateLimitError | TimeoutError | GraphQLRequestError;
+declare function isApiError(error: unknown): error is ApiError;
+declare function isRateLimitError(error: unknown): error is RateLimitError;
+declare function isTimeoutError(error: unknown): error is TimeoutError;
+declare function isGraphQLRequestError(error: unknown): error is GraphQLRequestError;
+declare function isApiCoreError(error: unknown): error is ApiCoreError;
+//#endregion
 //#region src/plugins/auth/types.d.ts
 interface AuthPluginOptions {
   /**
@@ -672,46 +722,6 @@ interface TimeoutPluginOptions {
  */
 declare function createTimeoutPlugin(options: TimeoutPluginOptions): ApiPlugin;
 //#endregion
-//#region src/graphql/GraphQLRequestError.d.ts
-/**
- * Thrown when a GraphQL server returns a well-formed HTTP 200 response that
- * contains a non-empty `errors` array.
- *
- * Extends {@link ApiError} so that code catching `ApiError` also catches
- * GraphQL-level failures. Callers that need to inspect the individual error
- * objects can narrow with `instanceof GraphQLRequestError` and read
- * `graphqlErrors`.
- *
- * When the server returns both `data` and `errors` (partial result), the
- * partial data is available on `partialData` but the error is still thrown —
- * callers must explicitly opt in to consuming partial results.
- *
- * @example
- * ```ts
- * import { GraphQLRequestError } from "@api-wrappers/api-core";
- *
- * try {
- *   const data = await client.graphql<MyQuery>("/graphql", { query: QUERY });
- * } catch (err) {
- *   if (err instanceof GraphQLRequestError) {
- *     for (const e of err.graphqlErrors) {
- *       console.error(e.message, e.path);
- *     }
- *   }
- * }
- * ```
- */
-declare class GraphQLRequestError extends ApiError {
-  /** The errors array from the GraphQL response envelope. */
-  readonly graphqlErrors: readonly GraphQLErrorDetail[];
-  /**
-   * Partial `data` returned alongside `errors`, if any. `undefined` when
-   * the server returned no `data` field.
-   */
-  readonly partialData: unknown;
-  constructor(errors: GraphQLErrorDetail[], partialData?: unknown, cause?: unknown);
-}
-//#endregion
 //#region src/graphql/gql.d.ts
 /**
  * Lightweight GraphQL template tag.
@@ -728,12 +738,12 @@ declare function gql(chunks: TemplateStringsArray, ...values: unknown[]): string
  *
  * ```ts
  * import nodeFetch from "node-fetch";
- * createClient({ fetch: nodeFetch as typeof globalThis.fetch });
+ * createClient({ fetch: nodeFetch as FetchLike });
  * // — or set it directly on the transport:
- * const transport = createFetchTransport(nodeFetch as typeof globalThis.fetch);
+ * const transport = createFetchTransport(nodeFetch as FetchLike);
  * ```
  */
-declare function createFetchTransport(fetchFn?: typeof globalThis.fetch): Transport;
+declare function createFetchTransport(fetchFn?: FetchLike): Transport;
 /**
  * Default {@link Transport} backed by the global `fetch` API.
  *
@@ -763,7 +773,7 @@ declare function isPlainObject(value: unknown): value is Record<string, unknown>
  * Merges header objects left to right. Keys are normalized to
  * lowercase so merging is case-insensitive. Later sources win.
  */
-declare function mergeHeaders(...sources: (Record<string, string> | undefined)[]): Record<string, string>;
+declare function mergeHeaders(...sources: (HeaderInput | undefined)[]): Record<string, string>;
 //#endregion
 //#region src/utils/resolveUrl.d.ts
 /**
@@ -775,5 +785,5 @@ declare function resolveUrl(baseUrl: string, path: string): string;
 //#region src/utils/sleep.d.ts
 declare function sleep(ms: number): Promise<void>;
 //#endregion
-export { ApiError, type ApiPlugin, type ApiResponse, type AuthPluginOptions, BaseHttpClient, type CachePlugin, type CachePluginOptions, type CacheStore, type ClientConfig, type GraphQLErrorDetail, GraphQLRequestError, type GraphQLRequestOptions, type GraphQLResponse, type HttpMethod, type LoggerInterface, type LoggerPluginOptions, type MaybePromise, MemoryStore, PluginManager, type QueryParams, type QueryPrimitive, type QueryValue, RateLimitError, type RateLimitPluginOptions, type RequestContext, type RequestOptions, type ResponseContext, type ResponseType, type RetryConfig, type RetryPluginOptions, TimeoutError, type TimeoutPluginOptions, type Transport, buildUrl, createAuthPlugin, createCachePlugin, createClient, createFetchTransport, createLoggerPlugin, createRateLimitPlugin, createRetryPlugin, createTimeoutPlugin, fetchTransport, gql, isPlainObject, mergeHeaders, resolveUrl, sleep };
+export { type ApiCoreError, ApiError, type ApiPlugin, type ApiResponse, type AuthPluginOptions, BaseHttpClient, type CachePlugin, type CachePluginOptions, type CacheStore, type ClientConfig, type FetchLike, type GraphQLErrorDetail, GraphQLRequestError, type GraphQLRequestOptions, type GraphQLResponse, type HeaderInput, type HttpMethod, type LoggerInterface, type LoggerPluginOptions, type MaybePromise, MemoryStore, PluginManager, type QueryParams, type QueryPrimitive, type QueryValue, RateLimitError, type RateLimitPluginOptions, type RequestContext, type RequestOptions, type ResponseContext, type ResponseType, type RetryConfig, type RetryPluginOptions, TimeoutError, type TimeoutPluginOptions, type Transport, buildUrl, createAuthPlugin, createCachePlugin, createClient, createFetchTransport, createLoggerPlugin, createRateLimitPlugin, createRetryPlugin, createTimeoutPlugin, fetchTransport, gql, isApiCoreError, isApiError, isGraphQLRequestError, isPlainObject, isRateLimitError, isTimeoutError, mergeHeaders, resolveUrl, sleep };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/common.ts","../src/context/RequestContext.ts","../src/graphql/types.ts","../src/context/ResponseContext.ts","../src/plugin/types.ts","../src/transport/types.ts","../src/client/types.ts","../src/plugin/PluginManager.ts","../src/client/BaseHttpClient.ts","../src/client/createClient.ts","../src/errors/ApiError.ts","../src/errors/RateLimitError.ts","../src/errors/TimeoutError.ts","../src/plugins/auth/types.ts","../src/plugins/auth/authPlugin.ts","../src/plugins/cache/types.ts","../src/plugins/cache/cachePlugin.ts","../src/plugins/cache/memoryStore.ts","../src/plugins/logger/types.ts","../src/plugins/logger/loggerPlugin.ts","../src/plugins/rateLimit/types.ts","../src/plugins/rateLimit/rateLimitPlugin.ts","../src/plugins/retry/types.ts","../src/plugins/retry/retryPlugin.ts","../src/plugins/timeout/types.ts","../src/plugins/timeout/timeoutPlugin.ts","../src/graphql/GraphQLRequestError.ts","../src/graphql/gql.ts","../src/transport/fetchTransport.ts","../src/utils/buildUrl.ts","../src/utils/isPlainObject.ts","../src/utils/mergeHeaders.ts","../src/utils/resolveUrl.ts","../src/utils/sleep.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/common.ts","../src/context/RequestContext.ts","../src/graphql/types.ts","../src/context/ResponseContext.ts","../src/plugin/types.ts","../src/transport/types.ts","../src/client/types.ts","../src/plugin/PluginManager.ts","../src/client/BaseHttpClient.ts","../src/client/createClient.ts","../src/errors/ApiError.ts","../src/graphql/GraphQLRequestError.ts","../src/errors/RateLimitError.ts","../src/errors/TimeoutError.ts","../src/errors/guards.ts","../src/plugins/auth/types.ts","../src/plugins/auth/authPlugin.ts","../src/plugins/cache/types.ts","../src/plugins/cache/cachePlugin.ts","../src/plugins/cache/memoryStore.ts","../src/plugins/logger/types.ts","../src/plugins/logger/loggerPlugin.ts","../src/plugins/rateLimit/types.ts","../src/plugins/rateLimit/rateLimitPlugin.ts","../src/plugins/retry/types.ts","../src/plugins/retry/retryPlugin.ts","../src/plugins/timeout/types.ts","../src/plugins/timeout/timeoutPlugin.ts","../src/graphql/gql.ts","../src/transport/fetchTransport.ts","../src/utils/buildUrl.ts","../src/utils/isPlainObject.ts","../src/utils/mergeHeaders.ts","../src/utils/resolveUrl.ts","../src/utils/sleep.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -208,6 +208,12 @@ function buildUrl(base, query) {
 	return `${base}${base.includes("?") ? base.endsWith("?") || base.endsWith("&") ? "" : "&" : "?"}${qs}`;
 }
 //#endregion
+//#region src/utils/isJsonContentType.ts
+function isJsonContentType(contentType) {
+	const mediaType = contentType?.split(";", 1)[0]?.trim().toLowerCase();
+	return mediaType === "application/json" || mediaType?.endsWith("+json") === true;
+}
+//#endregion
 //#region src/utils/isPlainObject.ts
 function isPlainObject(value) {
 	if (typeof value !== "object" || value === null) return false;
@@ -225,9 +231,9 @@ const defaultFetch = (input, init) => {
 *
 * ```ts
 * import nodeFetch from "node-fetch";
-* createClient({ fetch: nodeFetch as typeof globalThis.fetch });
+* createClient({ fetch: nodeFetch as FetchLike });
 * // — or set it directly on the transport:
-* const transport = createFetchTransport(nodeFetch as typeof globalThis.fetch);
+* const transport = createFetchTransport(nodeFetch as FetchLike);
 * ```
 */
 function createFetchTransport(fetchFn = defaultFetch) {
@@ -279,8 +285,7 @@ function createFetchTransport(fetchFn = defaultFetch) {
 const fetchTransport = createFetchTransport();
 function serializeRequestBody(body, headers) {
 	if (isBodyInit(body)) return body;
-	const contentType = headers["content-type"] ?? "";
-	if (isPlainObject(body) || Array.isArray(body) || contentType.includes("json")) return JSON.stringify(body);
+	if (isPlainObject(body) || Array.isArray(body) || isJsonContentType(headers["content-type"])) return JSON.stringify(body);
 	return String(body);
 }
 function isBodyInit(body) {
@@ -303,10 +308,29 @@ function mergeHeaders(...sources) {
 	const result = {};
 	for (const source of sources) {
 		if (!source) continue;
-		for (const [key, value] of Object.entries(source)) result[key.toLowerCase()] = value;
+		if (isHeaders(source)) {
+			source.forEach((value, key) => {
+				result[key.toLowerCase()] = value;
+			});
+			continue;
+		}
+		if (Array.isArray(source)) {
+			for (const [key, value] of source) result[key.toLowerCase()] = value;
+			continue;
+		}
+		for (const [key, value] of Object.entries(source)) result[key.toLowerCase()] = String(value);
 	}
 	return result;
 }
+function isHeaders(source) {
+	return typeof Headers !== "undefined" && source instanceof Headers;
+}
+//#endregion
+//#region src/utils/normalizeRetryMaxAttempts.ts
+function normalizeRetryMaxAttempts(value) {
+	if (value === void 0 || !Number.isFinite(value)) return 1;
+	return Math.max(1, Math.floor(value));
+}
 //#endregion
 //#region src/utils/resolveUrl.ts
 /**
@@ -415,7 +439,7 @@ var BaseHttpClient = class {
 		await this.init();
 		const transport = this.config.transport ?? (this.config.fetch ? createFetchTransport(this.config.fetch) : fetchTransport);
 		const retryCfg = this.config.retry;
-		let maxAttempts = retryCfg?.maxAttempts ?? 1;
+		let maxAttempts = normalizeRetryMaxAttempts(retryCfg?.maxAttempts);
 		let baseDelay = retryCfg?.delayMs ?? 500;
 		let jitter = retryCfg?.jitter ?? true;
 		let retriableCodes = retryCfg?.retriableStatusCodes ?? DEFAULT_RETRIABLE_STATUS_CODES;
@@ -442,10 +466,15 @@ var BaseHttpClient = class {
 				await this.pluginManager.onError(err, getPluginErrorContext(err) ?? baseCtx);
 				throw err;
 			}
-			if (ctx.meta["retry.maxAttempts"] !== void 0) maxAttempts = ctx.meta["retry.maxAttempts"];
+			if (ctx.meta["retry.maxAttempts"] !== void 0) maxAttempts = normalizeRetryMaxAttempts(ctx.meta["retry.maxAttempts"]);
 			if (ctx.meta["retry.delayMs"] !== void 0) baseDelay = ctx.meta["retry.delayMs"];
 			if (ctx.meta["retry.jitter"] !== void 0) jitter = ctx.meta["retry.jitter"];
 			if (ctx.meta["retry.retriableStatusCodes"] !== void 0) retriableCodes = ctx.meta["retry.retriableStatusCodes"];
+			const retryCount = maxAttempts - 1 - attempt;
+			if (ctx.retryCount !== retryCount) ctx = {
+				...ctx,
+				retryCount
+			};
 			let rawResponse;
 			if (ctx.syntheticResponse) rawResponse = ctx.syntheticResponse;
 			else try {
@@ -472,16 +501,17 @@ var BaseHttpClient = class {
 				await this.pluginManager.onError(err, ctx);
 				throw err;
 			}
-			if (!rawResponse.ok) {
-				if (retriableCodes.includes(rawResponse.status) && attempt < maxAttempts - 1) {
-					if (rawResponse.status === 429) {
-						const wait = readRetryAfterMs(rawResponse);
+			const finalResponse = resCtx.response;
+			if (!finalResponse.ok) {
+				if (retriableCodes.includes(finalResponse.status) && attempt < maxAttempts - 1) {
+					if (finalResponse.status === 429) {
+						const wait = readRetryAfterMs(finalResponse);
 						await this.waitForRetry(attempt, wait ?? baseDelay, false);
 					} else await this.waitForRetry(attempt, baseDelay, jitter);
-					lastError = normalizeHttpError(rawResponse, resCtx.parsedBody);
+					lastError = normalizeHttpError(finalResponse, resCtx.parsedBody);
 					continue;
 				}
-				const err = normalizeHttpError(rawResponse, resCtx.parsedBody);
+				const err = normalizeHttpError(finalResponse, resCtx.parsedBody);
 				await this.pluginManager.onError(err, ctx);
 				throw err;
 			}
@@ -585,7 +615,7 @@ var BaseHttpClient = class {
 				...variables !== void 0 && { variables },
 				...operationName !== void 0 && { operationName }
 			},
-			headers,
+			headers: mergeHeaders(headers, { "content-type": "application/json" }),
 			signal,
 			timeoutMs,
 			cacheKey,
@@ -609,7 +639,7 @@ async function parseBody(response, responseType = "auto") {
 	if (responseType === "text") return text;
 	if (!text) return void 0;
 	if (responseType === "json") return JSON.parse(text);
-	if ((response.headers.get("content-type") ?? "").includes("application/json")) return JSON.parse(text);
+	if (isJsonContentType(response.headers.get("content-type"))) return JSON.parse(text);
 	return text;
 }
 function normalizeHttpError(response, body) {
@@ -645,6 +675,23 @@ function createClient(config) {
 	return new BaseHttpClient(config);
 }
 //#endregion
+//#region src/errors/guards.ts
+function isApiError(error) {
+	return error instanceof ApiError;
+}
+function isRateLimitError(error) {
+	return error instanceof RateLimitError;
+}
+function isTimeoutError(error) {
+	return error instanceof TimeoutError;
+}
+function isGraphQLRequestError(error) {
+	return error instanceof GraphQLRequestError;
+}
+function isApiCoreError(error) {
+	return isApiError(error) || isTimeoutError(error);
+}
+//#endregion
 //#region src/plugins/auth/authPlugin.ts
 /**
 * Adds an auth token header before each request. The token can be static or
@@ -722,7 +769,7 @@ function createCachePlugin(options = {}) {
 			const key = ctx.cacheKey ?? generateKey(ctx);
 			const cached = await store.get(key);
 			if (cached !== void 0) {
-				const syntheticResponse = new Response(JSON.stringify(cached), {
+				const syntheticResponse = new Response(serializeCachedBody(cached), {
 					status: 200,
 					headers: { "content-type": "application/json" }
 				});
@@ -783,8 +830,14 @@ function createCachePlugin(options = {}) {
 	};
 }
 function defaultCacheKey(ctx) {
-	const queryStr = ctx.query ? new URLSearchParams(Object.fromEntries(Object.entries(ctx.query).filter(([, v]) => v !== void 0).map(([k, v]) => [k, String(v)]))).toString() : "";
-	return `${ctx.method}:${ctx.url}${queryStr ? `?${queryStr}` : ""}`;
+	return `${ctx.method}:${buildUrl(ctx.url, ctx.query)}`;
+}
+function serializeCachedBody(value) {
+	try {
+		return JSON.stringify(value) ?? null;
+	} catch {
+		return null;
+	}
 }
 //#endregion
 //#region src/plugins/logger/loggerPlugin.ts
@@ -932,11 +985,20 @@ function createRetryPlugin(options = {}) {
 		name: "retry",
 		priority: 5,
 		beforeRequest(ctx) {
-			if (options.maxAttempts !== void 0) ctx.meta["retry.maxAttempts"] = options.maxAttempts;
-			if (options.delayMs !== void 0) ctx.meta["retry.delayMs"] = options.delayMs;
-			if (options.jitter !== void 0) ctx.meta["retry.jitter"] = options.jitter;
-			if (options.retriableStatusCodes !== void 0) ctx.meta["retry.retriableStatusCodes"] = options.retriableStatusCodes;
-			return ctx;
+			const meta = { ...ctx.meta };
+			let retryCount = ctx.retryCount;
+			if (options.maxAttempts !== void 0) {
+				meta["retry.maxAttempts"] = options.maxAttempts;
+				retryCount = normalizeRetryMaxAttempts(options.maxAttempts) - 1 - ctx.attempt;
+			}
+			if (options.delayMs !== void 0) meta["retry.delayMs"] = options.delayMs;
+			if (options.jitter !== void 0) meta["retry.jitter"] = options.jitter;
+			if (options.retriableStatusCodes !== void 0) meta["retry.retriableStatusCodes"] = options.retriableStatusCodes;
+			return {
+				...ctx,
+				meta,
+				retryCount
+			};
 		}
 	};
 }
@@ -1036,6 +1098,6 @@ function consumeTrailingWhitespace(source, index) {
 	return next;
 }
 //#endregion
-export { ApiError, BaseHttpClient, GraphQLRequestError, MemoryStore, PluginManager, RateLimitError, TimeoutError, buildUrl, createAuthPlugin, createCachePlugin, createClient, createFetchTransport, createLoggerPlugin, createRateLimitPlugin, createRetryPlugin, createTimeoutPlugin, fetchTransport, gql, isPlainObject, mergeHeaders, resolveUrl, sleep };
+export { ApiError, BaseHttpClient, GraphQLRequestError, MemoryStore, PluginManager, RateLimitError, TimeoutError, buildUrl, createAuthPlugin, createCachePlugin, createClient, createFetchTransport, createLoggerPlugin, createRateLimitPlugin, createRetryPlugin, createTimeoutPlugin, fetchTransport, gql, isApiCoreError, isApiError, isGraphQLRequestError, isPlainObject, isRateLimitError, isTimeoutError, mergeHeaders, resolveUrl, sleep };
 
 //# sourceMappingURL=index.mjs.map