@ecomiq/core 0.1.9 → 1.0.0

package/dist/api.js

@@ -1,107 +1,123 @@
+import { z } from "zod";
 // src/libs/api.ts
-var DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
-var DEFAULT_API_VERSION = "v1";
+/**
+* Cliente HTTP de Ecomiq para servicios externos.
+* fetch nativo (funciona en Node, navegador y Cloudflare Workers)
+* + validación de respuestas con Zod.
+*/
+const DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
+const DEFAULT_API_VERSION = "v1";
+const PublicProblemDetailsSchema = z.object({
+	detail: z.string().trim().min(1).optional(),
+	code: z.string().trim().min(1).optional(),
+	traceId: z.string().optional()
+});
 var ApiError = class extends Error {
-  constructor(message, status, url, body) {
-    super(message);
-    this.status = status;
-    this.url = url;
-    this.body = body;
-    this.name = "ApiError";
-  }
-  status;
-  url;
-  body;
+	status;
+	url;
+	body;
+	code;
+	traceId;
+	constructor(message, status, url, body) {
+		super(message);
+		this.status = status;
+		this.url = url;
+		this.body = body;
+		this.name = "ApiError";
+		const problem = PublicProblemDetailsSchema.safeParse(body);
+		this.code = problem.success ? problem.data.code : void 0;
+		this.traceId = problem.success ? problem.data.traceId : void 0;
+	}
 };
-function resolveApiBaseUrl(baseUrl = DEFAULT_API_BASE_URL, version = DEFAULT_API_VERSION) {
-  const root = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
-  const segment = version.replace(/^\/+|\/+$/g, "");
-  if (!segment) return root;
-  return new URL(`${segment}/`, root).toString();
+/** Une baseUrl + version en la base efectiva del cliente, ej. https://storefront.ecomiq.pe/v1/ */
+function resolveApiBaseUrl(baseUrl = DEFAULT_API_BASE_URL, version = "v1") {
+	const root = baseUrl.endsWith("/") ? baseUrl : `${baseUrl}/`;
+	const segment = version.replace(/^\/+|\/+$/g, "");
+	if (!segment) return root;
+	return new URL(`${segment}/`, root).toString();
 }
+/**
+* Crea un cliente HTTP tipado con Zod.
+*
+* ```ts
+* const api = createApi()
+* const data = await api.get('settings', schema)
+* // → GET https://storefront.ecomiq.pe/v1/settings
+* ```
+*/
 function createApi(options = {}) {
-  const {
-    baseUrl = DEFAULT_API_BASE_URL,
-    version = DEFAULT_API_VERSION,
-    headers: baseHeaders = {},
-    timeoutMs = 1e4
-  } = options;
-  const effectiveBaseUrl = resolveApiBaseUrl(baseUrl, version);
-  async function request(method, path, schema, opts = {}) {
-    const url = new URL(path.replace(/^\//, ""), effectiveBaseUrl);
-    for (const [key, value] of Object.entries(opts.query ?? {})) {
-      if (value !== void 0) url.searchParams.set(key, String(value));
-    }
-    const controller = new AbortController();
-    const timeout = setTimeout(() => controller.abort(), timeoutMs);
-    if (opts.signal) opts.signal.addEventListener("abort", () => controller.abort(), { once: true });
-    const isFormData = typeof FormData !== "undefined" && opts.body instanceof FormData;
-    let response;
-    try {
-      response = await fetch(url.toString(), {
-        method,
-        headers: {
-          accept: "application/json",
-          ...opts.body !== void 0 && !isFormData ? { "content-type": "application/json" } : {},
-          ...baseHeaders,
-          ...opts.headers
-        },
-        body: opts.body === void 0 ? void 0 : isFormData ? opts.body : JSON.stringify(opts.body),
-        signal: controller.signal
-      });
-    } catch (err) {
-      throw new ApiError(
-        err instanceof DOMException && err.name === "AbortError" ? `Timeout tras ${timeoutMs}ms: ${url}` : `No se pudo conectar con ${url}`,
-        0,
-        url.toString()
-      );
-    } finally {
-      clearTimeout(timeout);
-    }
-    if (!response.ok) {
-      const bodyText2 = await response.text().catch(() => void 0);
-      let body = bodyText2;
-      if (bodyText2) {
-        try {
-          body = JSON.parse(bodyText2);
-        } catch {
-        }
-      }
-      throw new ApiError(`${method} ${url} \u2192 ${response.status}`, response.status, url.toString(), body);
-    }
-    const bodyText = await response.text();
-    let json = null;
-    if (bodyText.trim()) {
-      try {
-        json = JSON.parse(bodyText);
-      } catch {
-        throw new ApiError(
-          `Respuesta no JSON de ${url}`,
-          response.status,
-          url.toString(),
-          bodyText
-        );
-      }
-    }
-    const parsed = schema.safeParse(json);
-    if (!parsed.success) {
-      throw new ApiError(
-        `Respuesta inesperada de ${url}: ${parsed.error.issues[0]?.path.join(".")} ${parsed.error.issues[0]?.message}`,
-        response.status,
-        url.toString(),
-        json
-      );
-    }
-    return parsed.data;
-  }
-  return {
-    request,
-    get: (path, schema, opts) => request("GET", path, schema, opts),
-    post: (path, body, schema, opts) => request("POST", path, schema, { ...opts, body }),
-    postForm: (path, body, schema, opts) => request("POST", path, schema, { ...opts, body })
-  };
+	const { baseUrl = DEFAULT_API_BASE_URL, version = "v1", headers: baseHeaders = {}, timeoutMs = 1e4, fetch: send = (input, init) => fetch(input, init) } = options;
+	const effectiveBaseUrl = resolveApiBaseUrl(baseUrl, version);
+	async function request(method, path, schema, opts = {}) {
+		const url = new URL(path.replace(/^\//, ""), effectiveBaseUrl);
+		for (const [key, value] of Object.entries(opts.query ?? {})) if (value !== void 0) url.searchParams.set(key, String(value));
+		const controller = new AbortController();
+		const timeout = setTimeout(() => controller.abort(), timeoutMs);
+		const abort = () => controller.abort(opts.signal?.reason);
+		if (opts.signal?.aborted) abort();
+		else opts.signal?.addEventListener("abort", abort, { once: true });
+		const isFormData = typeof FormData !== "undefined" && opts.body instanceof FormData;
+		try {
+			controller.signal.throwIfAborted();
+			const response = await send(url.toString(), {
+				method,
+				headers: {
+					accept: "application/json",
+					...opts.body !== void 0 && !isFormData ? { "content-type": "application/json" } : {},
+					...baseHeaders,
+					...opts.headers
+				},
+				body: opts.body === void 0 ? void 0 : isFormData ? opts.body : JSON.stringify(opts.body),
+				signal: controller.signal
+			});
+			if (!response.ok) {
+				const bodyText = await response.text().catch(() => {
+					controller.signal.throwIfAborted();
+				});
+				let body = bodyText;
+				if (bodyText) try {
+					body = JSON.parse(bodyText);
+				} catch {}
+				const isProblemDetails = (response.headers.get("content-type")?.toLowerCase())?.includes("application/problem+json") === true;
+				let message = `${method} ${url} → ${response.status}`;
+				if (isProblemDetails) {
+					const problem = PublicProblemDetailsSchema.safeParse(body);
+					if (problem.success) {
+						if (problem.data.detail) message = problem.data.detail;
+						if (problem.data.code) message += ` (${problem.data.code})`;
+					}
+				}
+				throw new ApiError(message, response.status, url.toString(), body);
+			}
+			const bodyText = await response.text();
+			let json = null;
+			if (bodyText.trim()) try {
+				json = JSON.parse(bodyText);
+			} catch {
+				throw new ApiError(`Respuesta no JSON de ${url}`, response.status, url.toString(), bodyText);
+			}
+			const parsed = schema.safeParse(json);
+			if (!parsed.success) throw new ApiError(`Respuesta inesperada de ${url}: ${parsed.error.issues[0]?.path.join(".")} ${parsed.error.issues[0]?.message}`, response.status, url.toString(), json);
+			return parsed.data;
+		} catch (err) {
+			if (err instanceof ApiError) throw err;
+			throw new ApiError(controller.signal.aborted || err instanceof DOMException && err.name === "AbortError" ? `Timeout tras ${timeoutMs}ms: ${url}` : `No se pudo conectar con ${url}`, 0, url.toString());
+		} finally {
+			clearTimeout(timeout);
+			opts.signal?.removeEventListener("abort", abort);
+		}
+	}
+	return {
+		request,
+		get: (path, schema, opts) => request("GET", path, schema, opts),
+		post: (path, body, schema, opts) => request("POST", path, schema, {
+			...opts,
+			body
+		}),
+		postForm: (path, body, schema, opts) => request("POST", path, schema, {
+			...opts,
+			body
+		})
+	};
 }
-
 export { ApiError, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, createApi, resolveApiBaseUrl };
-//# sourceMappingURL=api.js.map
-//# sourceMappingURL=api.js.map