@ecomiq/core 0.1.9 → 1.0.0

package/LICENSE

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

@@ -11,10 +11,10 @@ npm install @ecomiq/core
 ## Usage
 
 ```ts
-import { createClient, createApi } from '@ecomiq/core'
+import { createClient } from '@ecomiq/core'
 
 const api = createClient({
-  slug: 'mi-tienda',
+  domain: 'mi-tienda',
   baseUrl: 'https://storefront.ecomiq.pe',
 })
 
@@ -22,6 +22,43 @@ const settings = await api.getSettings()
 const products = await api.getProducts({ page: 1, pageSize: 12 })
 ```
 
+### GraphQL para lecturas seleccionadas
+
+`graphql()` convive con los métodos REST anteriores. Recibe el documento, un
+schema Zod para `data` y variables opcionales.
+
+```ts
+import { z } from 'zod'
+
+const SellerDataSchema = z.object({
+  seller: z.object({
+    id: z.string(),
+    name: z.string(),
+    slug: z.string(),
+  }),
+})
+
+const data = await api.graphql(
+  `
+    query Seller($slug: String!) {
+      seller(slug: $slug) {
+        id
+        name
+        slug
+      }
+    }
+  `,
+  SellerDataSchema,
+  { slug: 'acme' },
+)
+```
+
+El cliente hace `POST /graphql`, envía `x-Store-Domain` y lanza
+`GraphQLResponseError` cuando la respuesta contiene `errors`. El schema disponible
+ofrece `store`, `products`, `product`, `relatedProducts`, `collections`,
+`collection`, `sellers`, `seller` y `productReviews`. Las demás lecturas siguen
+disponibles por REST.
+
 Subpaths (opcional):
 
 ```ts

package/dist/_virtual/_rolldown/runtime-C6LprzCP.cjs

@@ -0,0 +1,22 @@
+// \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+exports.__toESM = __toESM;

package/dist/api.cjs

@@ -1,113 +1,128 @@
-'use strict';
-
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+let zod = require("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 = zod.z.object({
+	detail: zod.z.string().trim().min(1).optional(),
+	code: zod.z.string().trim().min(1).optional(),
+	traceId: zod.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
+		})
+	};
 }
-
 exports.ApiError = ApiError;
 exports.DEFAULT_API_BASE_URL = DEFAULT_API_BASE_URL;
 exports.DEFAULT_API_VERSION = DEFAULT_API_VERSION;
 exports.createApi = createApi;
 exports.resolveApiBaseUrl = resolveApiBaseUrl;
-//# sourceMappingURL=api.cjs.map
-//# sourceMappingURL=api.cjs.map

package/dist/api.d.cts

@@ -1,43 +1,40 @@
-import { z } from 'zod';
-
-/**
- * Cliente HTTP de Ecomiq para servicios externos.
- * fetch nativo (funciona en Node, navegador y Cloudflare Workers)
- * + validación de respuestas con Zod.
- */
-
-declare const DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
-declare const DEFAULT_API_VERSION = "v1";
-declare class ApiError extends Error {
-    readonly status: number;
-    readonly url: string;
-    readonly body?: unknown | undefined;
-    constructor(message: string, status: number, url: string, body?: unknown | undefined);
+import { z } from "zod";
+export declare const DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
+export declare const DEFAULT_API_VERSION = "v1";
+export declare class ApiError extends Error {
+  readonly status: number;
+  readonly url: string;
+  readonly body?: unknown;
+  readonly code?: string;
+  readonly traceId?: string;
+  constructor(message: string, status: number, url: string, body?: unknown);
 }
-interface CreateApiOptions {
-    /** Default: https://storefront.ecomiq.pe */
-    baseUrl?: string;
-    /** Segmento de path, default 'v1' → {baseUrl}/v1/... */
-    version?: string;
-    headers?: Record<string, string>;
-    timeoutMs?: number;
+export interface CreateApiOptions {
+  /** Default: https://storefront.ecomiq.pe */
+  baseUrl?: string;
+  /** Segmento de path, default 'v1' → {baseUrl}/v1/... */
+  version?: string;
+  headers?: Record<string, string>;
+  timeoutMs?: number;
+  /** Default: fetch global. El SDK de temas inyecta uno con caché del borde. */
+  fetch?: typeof fetch;
 }
 interface RequestOptions {
-    query?: Record<string, string | number | boolean | undefined>;
-    headers?: Record<string, string>;
-    signal?: AbortSignal;
+  query?: Record<string, string | number | boolean | undefined>;
+  headers?: Record<string, string>;
+  signal?: AbortSignal;
 }
-interface Api {
-    get<S extends z.ZodTypeAny>(path: string, schema: S, options?: RequestOptions): Promise<z.output<S>>;
-    post<S extends z.ZodTypeAny>(path: string, body: unknown, schema: S, options?: RequestOptions): Promise<z.output<S>>;
-    /** POST multipart; no fuerza `content-type: application/json`. */
-    postForm<S extends z.ZodTypeAny>(path: string, body: FormData, schema: S, options?: RequestOptions): Promise<z.output<S>>;
-    request<S extends z.ZodTypeAny>(method: string, path: string, schema: S, options?: RequestOptions & {
-        body?: unknown;
-    }): Promise<z.output<S>>;
+export interface Api {
+  get<S extends z.ZodTypeAny>(path: string, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+  post<S extends z.ZodTypeAny>(path: string, body: unknown, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+  /** POST multipart; no fuerza `content-type: application/json`. */
+  postForm<S extends z.ZodTypeAny>(path: string, body: FormData, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+  request<S extends z.ZodTypeAny>(method: string, path: string, schema: S, options?: RequestOptions & {
+    body?: unknown;
+  }): Promise<z.output<S>>;
 }
 /** Une baseUrl + version en la base efectiva del cliente, ej. https://storefront.ecomiq.pe/v1/ */
-declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
+export declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
 /**
  * Crea un cliente HTTP tipado con Zod.
  *
@@ -47,6 +44,5 @@ declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
  * // → GET https://storefront.ecomiq.pe/v1/settings
  * ```
  */
-declare function createApi(options?: CreateApiOptions): Api;
-
-export { type Api, ApiError, type CreateApiOptions, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, createApi, resolveApiBaseUrl };
+export declare function createApi(options?: CreateApiOptions): Api;
+export {};

package/dist/api.d.ts

@@ -1,43 +1,40 @@
-import { z } from 'zod';
-
-/**
- * Cliente HTTP de Ecomiq para servicios externos.
- * fetch nativo (funciona en Node, navegador y Cloudflare Workers)
- * + validación de respuestas con Zod.
- */
-
-declare const DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
-declare const DEFAULT_API_VERSION = "v1";
-declare class ApiError extends Error {
-    readonly status: number;
-    readonly url: string;
-    readonly body?: unknown | undefined;
-    constructor(message: string, status: number, url: string, body?: unknown | undefined);
+import { z } from "zod";
+export declare const DEFAULT_API_BASE_URL = "https://storefront.ecomiq.pe";
+export declare const DEFAULT_API_VERSION = "v1";
+export declare class ApiError extends Error {
+  readonly status: number;
+  readonly url: string;
+  readonly body?: unknown;
+  readonly code?: string;
+  readonly traceId?: string;
+  constructor(message: string, status: number, url: string, body?: unknown);
 }
-interface CreateApiOptions {
-    /** Default: https://storefront.ecomiq.pe */
-    baseUrl?: string;
-    /** Segmento de path, default 'v1' → {baseUrl}/v1/... */
-    version?: string;
-    headers?: Record<string, string>;
-    timeoutMs?: number;
+export interface CreateApiOptions {
+  /** Default: https://storefront.ecomiq.pe */
+  baseUrl?: string;
+  /** Segmento de path, default 'v1' → {baseUrl}/v1/... */
+  version?: string;
+  headers?: Record<string, string>;
+  timeoutMs?: number;
+  /** Default: fetch global. El SDK de temas inyecta uno con caché del borde. */
+  fetch?: typeof fetch;
 }
 interface RequestOptions {
-    query?: Record<string, string | number | boolean | undefined>;
-    headers?: Record<string, string>;
-    signal?: AbortSignal;
+  query?: Record<string, string | number | boolean | undefined>;
+  headers?: Record<string, string>;
+  signal?: AbortSignal;
 }
-interface Api {
-    get<S extends z.ZodTypeAny>(path: string, schema: S, options?: RequestOptions): Promise<z.output<S>>;
-    post<S extends z.ZodTypeAny>(path: string, body: unknown, schema: S, options?: RequestOptions): Promise<z.output<S>>;
-    /** POST multipart; no fuerza `content-type: application/json`. */
-    postForm<S extends z.ZodTypeAny>(path: string, body: FormData, schema: S, options?: RequestOptions): Promise<z.output<S>>;
-    request<S extends z.ZodTypeAny>(method: string, path: string, schema: S, options?: RequestOptions & {
-        body?: unknown;
-    }): Promise<z.output<S>>;
+export interface Api {
+  get<S extends z.ZodTypeAny>(path: string, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+  post<S extends z.ZodTypeAny>(path: string, body: unknown, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+  /** POST multipart; no fuerza `content-type: application/json`. */
+  postForm<S extends z.ZodTypeAny>(path: string, body: FormData, schema: S, options?: RequestOptions): Promise<z.output<S>>;
+  request<S extends z.ZodTypeAny>(method: string, path: string, schema: S, options?: RequestOptions & {
+    body?: unknown;
+  }): Promise<z.output<S>>;
 }
 /** Une baseUrl + version en la base efectiva del cliente, ej. https://storefront.ecomiq.pe/v1/ */
-declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
+export declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
 /**
  * Crea un cliente HTTP tipado con Zod.
  *
@@ -47,6 +44,5 @@ declare function resolveApiBaseUrl(baseUrl?: string, version?: string): string;
  * // → GET https://storefront.ecomiq.pe/v1/settings
  * ```
  */
-declare function createApi(options?: CreateApiOptions): Api;
-
-export { type Api, ApiError, type CreateApiOptions, DEFAULT_API_BASE_URL, DEFAULT_API_VERSION, createApi, resolveApiBaseUrl };
+export declare function createApi(options?: CreateApiOptions): Api;
+export {};