@pakento/cms-sdk 4.0.4 → 4.0.6

package/dist/index.mjs

@@ -1,46 +1,32 @@
 // src/services/api.ts
 import axios, { AxiosError } from "axios";
+
+// src/services/cache.ts
 import { Redis } from "@upstash/redis";
-var PakentoCMSAPI = class {
-  constructor(config) {
-    this.defaultTTL = 86400;
-    this.baseURL = process.env.PAKENTO_CMS_BASE_URL || "";
-    this.apiKey = process.env.PAKENTO_API_KEY || "";
-    if (config?.cacheTTL && typeof config.cacheTTL === "number") {
-      this.defaultTTL = config.cacheTTL;
-    }
+import { createHash } from "crypto";
+var CacheService = class {
+  constructor(defaultTTL, apiKey) {
+    this.defaultTTL = defaultTTL;
+    this.apiKeyHash = createHash("sha256").update(apiKey).digest("hex").substring(0, 8);
     if (process.env.UPSTASH_REDIS_REST_URL && process.env.UPSTASH_REDIS_REST_TOKEN) {
       this.redis = new Redis({
         url: process.env.UPSTASH_REDIS_REST_URL,
         token: process.env.UPSTASH_REDIS_REST_TOKEN
       });
     }
-    if (!this.baseURL || !this.apiKey) {
-      console.warn(
-        "[PakentoSDK] Variables de entorno PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes. Se validar\xE1n al hacer la petici\xF3n."
-      );
-    }
-    this.client = axios.create({
-      baseURL: this.baseURL,
-      headers: {
-        "Content-Type": "application/json",
-        Authorization: `users API-Key ${this.apiKey}`
-      }
-    });
-    this.client.interceptors.request.use(
-      (config2) => {
-        const fullUrl = `${config2.baseURL}${config2.url}`;
-        console.log(`\u{1F310} API Call: ${config2.method?.toUpperCase()} ${fullUrl}`);
-        return config2;
-      },
-      (error) => {
-        return Promise.reject(error);
-      }
-    );
   }
-  /**
-   * Obtiene datos desde cache si existen; de lo contrario llama a fetcher() y guarda.
-   */
+  generateParamsHash(params) {
+    const sortedParams = Object.keys(params).sort().reduce((acc, key) => {
+      acc[key] = params[key];
+      return acc;
+    }, {});
+    const paramsString = JSON.stringify(sortedParams);
+    return createHash("sha256").update(paramsString).digest("hex").substring(0, 16);
+  }
+  buildCacheKey(functionName, params = {}) {
+    const paramsHash = this.generateParamsHash(params);
+    return `pakento:${this.apiKeyHash}:${functionName}:${paramsHash}`;
+  }
   safeJsonParse(data) {
     try {
       return JSON.parse(data);
@@ -53,43 +39,215 @@ var PakentoCMSAPI = class {
   }
   async getCachedOrFetch(key, fetcher, ttl, skipCache = false) {
     if (!this.redis || skipCache) {
+      console.log(`[PakentoSDK] ${!this.redis ? "Redis no configurado" : "Saltando cache"} - llamando a API`);
       return fetcher();
     }
     try {
+      console.log(`[PakentoSDK] Buscando en cache: ${key}`);
       const cached = await this.redis.get(key);
       if (cached) {
+        console.log(`[PakentoSDK] \u2705 Cache hit para: ${key}`);
         const parsed = this.safeJsonParse(cached);
         if (parsed !== null) {
           return parsed;
+        } else {
+          console.warn(`[PakentoSDK] Error parseando cache para: ${key}`);
         }
+      } else {
+        console.log(`[PakentoSDK] \u274C Cache miss para: ${key}`);
       }
     } catch (err) {
       console.warn("[PakentoSDK] Error leyendo cache Redis", err);
     }
+    console.log(`[PakentoSDK] Llamando a API para: ${key}`);
     const result = await fetcher();
     try {
       await this.redis.set(key, this.serializeForCache(result), {
         ex: ttl ?? this.defaultTTL
       });
+      console.log(`[PakentoSDK] \u2705 Guardado en cache: ${key} (TTL: ${ttl ?? this.defaultTTL}s)`);
     } catch (err) {
       console.warn("[PakentoSDK] Error escribiendo cache Redis", err);
     }
     return result;
   }
-  /**
-   * Construye una llave única para el cache a partir del nombre de la
-   * consulta y los parámetros.
-   */
-  buildCacheKey(queryName, variables) {
-    const vars = typeof variables === "string" ? variables : JSON.stringify(variables ?? {});
-    return `${this.apiKey}-${queryName}:${vars}`;
+  async hasCache(functionName, params = {}) {
+    if (!this.redis) {
+      return false;
+    }
+    try {
+      const key = this.buildCacheKey(functionName, params);
+      const cached = await this.redis.get(key);
+      return cached !== null;
+    } catch (err) {
+      console.warn("[PakentoSDK] Error verificando cache", err);
+      return false;
+    }
+  }
+  getCacheKey(functionName, params = {}) {
+    return this.buildCacheKey(functionName, params);
+  }
+  async clearCache(functionName, params = {}) {
+    if (!this.redis) {
+      return false;
+    }
+    try {
+      const key = this.buildCacheKey(functionName, params);
+      await this.redis.del(key);
+      console.log(`[PakentoSDK] \u2705 Cache limpiado para: ${key}`);
+      return true;
+    } catch (err) {
+      console.warn("[PakentoSDK] Error limpiando cache", err);
+      return false;
+    }
+  }
+  async clearAllCache() {
+    if (!this.redis) {
+      return false;
+    }
+    try {
+      const pattern = `pakento:${this.apiKeyHash}:*`;
+      const keys = await this.redis.keys(pattern);
+      if (keys.length > 0) {
+        await this.redis.del(...keys);
+        console.log(`[PakentoSDK] \u2705 Cache limpiado para ${keys.length} keys`);
+      }
+      return true;
+    } catch (err) {
+      console.warn("[PakentoSDK] Error limpiando todo el cache", err);
+      return false;
+    }
+  }
+  async getCacheInfo(functionName, params = {}) {
+    if (!this.redis) {
+      return {
+        exists: false,
+        key: this.buildCacheKey(functionName, params)
+      };
+    }
+    try {
+      const key = this.buildCacheKey(functionName, params);
+      const exists = await this.redis.exists(key);
+      const ttl = exists ? await this.redis.ttl(key) : void 0;
+      return {
+        exists: exists === 1,
+        key,
+        ttl: ttl === -1 ? void 0 : ttl
+      };
+    } catch (err) {
+      console.warn("[PakentoSDK] Error obteniendo info del cache", err);
+      return {
+        exists: false,
+        key: this.buildCacheKey(functionName, params)
+      };
+    }
+  }
+};
+
+// src/services/api.ts
+import { z } from "zod";
+var PakentoCMSAPI = class {
+  constructor(config) {
+    this.defaultTTL = 86400;
+    this.baseURL = process.env.PAKENTO_CMS_BASE_URL || "";
+    this.apiKey = process.env.PAKENTO_API_KEY || "";
+    if (config?.cacheTTL && typeof config.cacheTTL === "number") {
+      this.defaultTTL = config.cacheTTL;
+    }
+    this.cache = new CacheService(this.defaultTTL, this.apiKey);
+    this.client = axios.create({
+      baseURL: this.baseURL,
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `users API-Key ${this.apiKey}`
+      }
+    });
+    this.client.interceptors.request.use(
+      (config2) => {
+        const fullUrl = `${config2.baseURL}${config2.url}`;
+        console.log(`\u{1F310} API Call: ${config2.method?.toUpperCase()} ${fullUrl}`);
+        return config2;
+      },
+      (error) => {
+        return Promise.reject(error);
+      }
+    );
+  }
+  // Centralized error handler
+  handleApiError(error, context) {
+    if (error instanceof AxiosError) {
+      const status = error.response?.status;
+      const responseMessage = error.response?.data?.message;
+      if (status === 401) return "API Key inv\xE1lida o expirada";
+      if (status === 404) return `${context} no encontrado`;
+      if (status && status >= 500) return "Error del servidor CMS";
+      return responseMessage || `Error de conexi\xF3n en ${context}: ${error.message}`;
+    } else if (error instanceof z.ZodError) {
+      return `Validaci\xF3n fallida: ${error.issues.map((e) => e.message).join(", ")}`;
+    } else if (error instanceof Error) {
+      return error.message;
+    }
+    return "Error desconocido";
+  }
+  // Generic GraphQL fetcher
+  async fetchGraphQL(query, variables, extractData) {
+    try {
+      const response = await this.client.post("/api/graphql", {
+        query,
+        variables
+      });
+      if (response.data.errors) {
+        const errorMessage = `GraphQL Error: ${response.data.errors[0].message}`;
+        return { data: null, error: true, errorMessage };
+      }
+      const data = extractData(response.data.data);
+      return { data, error: false, errorMessage: null };
+    } catch (error) {
+      const errorMessage = this.handleApiError(error, "GraphQL query");
+      return { data: null, error: true, errorMessage };
+    }
   }
   async getItems(params = {}) {
-    const { skipCache = false, cacheTTL, ...rest } = params;
-    const cacheKey = this.buildCacheKey("GetEcommerceItems", rest);
-    return this.getCachedOrFetch(
+    const itemsSchema = z.object({
+      where: z.object({
+        item_category_id: z.object({ equals: z.string().optional() }).optional(),
+        item_super_category_id: z.object({ equals: z.string().optional() }).optional(),
+        brand_id: z.object({ equals: z.string().optional() }).optional(),
+        id: z.object({ equals: z.string().optional() }).optional()
+      }).optional(),
+      onlyOffers: z.boolean().optional(),
+      onlyEcommerce: z.boolean().optional(),
+      limit: z.number().optional(),
+      page: z.number().optional(),
+      search: z.string().optional(),
+      sort: z.string().optional(),
+      minPrice: z.number().optional(),
+      maxPrice: z.number().optional(),
+      skipCache: z.boolean().optional(),
+      cacheTTL: z.number().optional()
+    });
+    const validatedParams = itemsSchema.safeParse(params);
+    if (!validatedParams.success) {
+      const errorMessage = this.handleApiError(
+        validatedParams.error,
+        "getItems validation"
+      );
+      return {
+        data: null,
+        items: [],
+        totalDocs: 0,
+        totalPages: 0,
+        prevPage: null,
+        nextPage: null,
+        error: true,
+        errorMessage
+      };
+    }
+    const { skipCache = false, cacheTTL, ...rest } = validatedParams.data;
+    const cacheKey = this.cache.buildCacheKey("GetEcommerceItems", rest);
+    return this.cache.getCachedOrFetch(
       cacheKey,
-      () => this.fetchItemsFromAPI(params),
+      () => this.fetchItemsFromAPI(rest),
       cacheTTL,
       skipCache
     );
@@ -107,136 +265,84 @@ var PakentoCMSAPI = class {
         errorMessage: "SDK no configurado: PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes."
       };
     }
-    try {
-      const whereConditions = {};
-      if (params.where?.item_category_id?.equals) {
-        whereConditions.item_category_id = {
-          equals: params.where.item_category_id.equals
-        };
-      }
-      if (params.where?.item_super_category_id?.equals) {
-        whereConditions.item_super_category_id = {
-          equals: params.where.item_super_category_id.equals
-        };
-      }
-      if (params.where?.brand_id?.equals) {
-        whereConditions.brand_id = {
-          equals: params.where.brand_id.equals
-        };
-      }
-      if (params.where?.id?.equals) {
-        whereConditions.id = {
-          equals: params.where.id.equals
-        };
-      }
-      const variables = {
-        onlyOffers: params.onlyOffers,
-        onlyEcommerce: params.onlyEcommerce,
-        limit: params.limit,
-        page: params.page,
-        search: params.search,
-        sort: params.sort,
-        minPrice: params.minPrice,
-        maxPrice: params.maxPrice
-      };
-      if (Object.keys(whereConditions).length > 0) {
-        variables.where = whereConditions;
-      }
-      const query = `
-        query GetEcommerceItems(
-          $where: EcommerceItemsWhere
-          $onlyOffers: Boolean
-          $onlyEcommerce: Boolean
-          $limit: Int
-          $page: Int
-          $search: String
-          $sort: String
-          $minPrice: Float
-          $maxPrice: Float
+    const query = `
+      query GetEcommerceItems(
+        $where: EcommerceItemsWhere
+        $onlyOffers: Boolean
+        $onlyEcommerce: Boolean
+        $limit: Int
+        $page: Int
+        $search: String
+        $sort: String
+        $minPrice: Float
+        $maxPrice: Float
+      ) {
+        GetEcommerceItems(
+          where: $where
+          onlyOffers: $onlyOffers
+          onlyEcommerce: $onlyEcommerce
+          limit: $limit
+          page: $page
+          search: $search
+          sort: $sort
+          minPrice: $minPrice
+          maxPrice: $maxPrice
         ) {
-          GetEcommerceItems(
-            where: $where
-            onlyOffers: $onlyOffers
-            onlyEcommerce: $onlyEcommerce
-            limit: $limit
-            page: $page
-            search: $search
-            sort: $sort
-            minPrice: $minPrice
-            maxPrice: $maxPrice
-          ) {
-            totalDocs
-            totalPages
-            prevPage
-            nextPage
-            docs {
-              id
-              name
-              featured
-              old_price
-              currency_prefix
-              description
-              price_text
-              price
-              brand_id
-              brand_name
-              cover_image_url
-              cover_image_thumbnail_url
-              item_category_name
-              item_category_id
-              images {
-                alt
-                url
-                thumbnail_url
-              }
+          totalDocs
+          totalPages
+          prevPage
+          nextPage
+          docs {
+            id
+            name
+            featured
+            old_price
+            currency_prefix
+            description
+            price_text
+            price
+            brand_id
+            brand_name
+            cover_image_url
+            cover_image_thumbnail_url
+            item_category_name
+            item_category_id
+            images {
+              alt
+              url
+              thumbnail_url
             }
           }
         }
-      `;
-      const response = await this.client.post("/api/graphql", {
-        query,
-        variables
-      });
-      if (response.data.errors) {
-        const errorMessage = `GraphQL Error: ${response.data.errors[0].message}`;
-        return {
-          data: null,
-          items: [],
-          totalDocs: 0,
-          totalPages: 0,
-          prevPage: null,
-          nextPage: null,
-          error: true,
-          errorMessage
-        };
       }
-      const rawData = response.data.data.GetEcommerceItems;
-      return {
-        data: rawData,
-        items: rawData.docs,
-        totalDocs: rawData.totalDocs,
-        totalPages: rawData.totalPages,
-        prevPage: rawData.prevPage,
-        nextPage: rawData.nextPage,
-        error: false,
-        errorMessage: null
+    `;
+    const whereConditions = {};
+    if (params.where?.item_category_id?.equals) {
+      whereConditions.item_category_id = {
+        equals: params.where.item_category_id.equals
       };
-    } catch (error) {
-      let errorMessage = "Error desconocido";
-      if (error instanceof AxiosError) {
-        const status = error.response?.status;
-        if (status === 401) {
-          errorMessage = "API Key inv\xE1lida o expirada";
-        } else if (status === 404) {
-          errorMessage = "Endpoint no encontrado";
-        } else if (status && status >= 500) {
-          errorMessage = "Error del servidor CMS";
-        } else {
-          errorMessage = `Error de conexi\xF3n: ${error.message}`;
-        }
-      } else if (error instanceof Error) {
-        errorMessage = error.message;
-      }
+    }
+    if (params.where?.item_super_category_id?.equals) {
+      whereConditions.item_super_category_id = {
+        equals: params.where.item_super_category_id.equals
+      };
+    }
+    if (params.where?.brand_id?.equals) {
+      whereConditions.brand_id = { equals: params.where.brand_id.equals };
+    }
+    if (params.where?.id?.equals) {
+      whereConditions.id = { equals: params.where.id.equals };
+    }
+    const variables = {
+      ...params,
+      where: Object.keys(whereConditions).length > 0 ? whereConditions : void 0
+    };
+    const { data, error, errorMessage } = await this.fetchGraphQL(
+      query,
+      variables,
+      (responseData) => responseData.GetEcommerceItems
+    );
+    if (error) {
       return {
         data: null,
         items: [],
@@ -248,6 +354,16 @@ var PakentoCMSAPI = class {
         errorMessage
       };
     }
+    return {
+      data,
+      items: data.docs,
+      totalDocs: data.totalDocs,
+      totalPages: data.totalPages,
+      prevPage: data.prevPage,
+      nextPage: data.nextPage,
+      error: false,
+      errorMessage: null
+    };
   }
   async getCategories(params = {}) {
     const {
@@ -255,8 +371,8 @@ var PakentoCMSAPI = class {
       cacheTTL,
       ...rest
     } = params;
-    const cacheKey = this.buildCacheKey("GetEcommerceCategories", rest);
-    return this.getCachedOrFetch(
+    const cacheKey = this.cache.buildCacheKey("GetEcommerceCategories", rest);
+    return this.cache.getCachedOrFetch(
       cacheKey,
       () => this.fetchCategoriesFromAPI(rest),
       cacheTTL,
@@ -272,64 +388,33 @@ var PakentoCMSAPI = class {
         errorMessage: "SDK no configurado: PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes."
       };
     }
-    try {
-      const query = `
-        query GetEcommerceCategories(
-          $where: EcommerceCategoriesWhere
-          $limit: Int
-          $page: Int
-          $sort: String
+    const query = `
+      query GetEcommerceCategories(
+        $where: EcommerceCategoriesWhere
+        $limit: Int
+        $page: Int
+        $sort: String
+      ) {
+        GetEcommerceCategories(
+          where: $where
+          limit: $limit
+          page: $page
+          sort: $sort
         ) {
-          GetEcommerceCategories(
-            where: $where
-            limit: $limit
-            page: $page
-            sort: $sort
-          ) {
-            docs {
-              id
-              name
-              image_url
-            }
+          docs {
+            id
+            name
+            image_url
           }
         }
-      `;
-      const response = await this.client.post("/api/graphql", {
-        query,
-        variables: params
-      });
-      if (response.data.errors) {
-        const errorMessage = `GraphQL Error: ${response.data.errors[0].message}`;
-        return {
-          data: null,
-          categories: [],
-          error: true,
-          errorMessage
-        };
-      }
-      const rawData = response.data.data.GetEcommerceCategories;
-      return {
-        data: rawData.docs,
-        categories: rawData.docs,
-        error: false,
-        errorMessage: null
-      };
-    } catch (error) {
-      let errorMessage = "Error desconocido";
-      if (error instanceof AxiosError) {
-        const status = error.response?.status;
-        if (status === 401) {
-          errorMessage = "API Key inv\xE1lida o expirada";
-        } else if (status === 404) {
-          errorMessage = "Endpoint no encontrado";
-        } else if (status && status >= 500) {
-          errorMessage = "Error del servidor CMS";
-        } else {
-          errorMessage = `Error de conexi\xF3n: ${error.message}`;
-        }
-      } else if (error instanceof Error) {
-        errorMessage = error.message;
       }
+    `;
+    const { data, error, errorMessage } = await this.fetchGraphQL(
+      query,
+      params,
+      (responseData) => responseData.GetEcommerceCategories
+    );
+    if (error) {
       return {
         data: null,
         categories: [],
@@ -337,11 +422,17 @@ var PakentoCMSAPI = class {
         errorMessage
       };
     }
+    return {
+      data: data.docs,
+      categories: data.docs,
+      error: false,
+      errorMessage: null
+    };
   }
   async getBrands(params = {}) {
     const { skipCache = false, cacheTTL, ...rest } = params;
-    const cacheKey = this.buildCacheKey("GetEcommerceBrands", rest);
-    return this.getCachedOrFetch(
+    const cacheKey = this.cache.buildCacheKey("GetEcommerceBrands", rest);
+    return this.cache.getCachedOrFetch(
       cacheKey,
       () => this.fetchBrandsFromAPI(rest),
       cacheTTL,
@@ -367,96 +458,45 @@ var PakentoCMSAPI = class {
         errorMessage: "SDK no configurado: PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes."
       };
     }
-    try {
-      const query = `
-        query GetEcommerceBrands(
-          $limit: Int
-          $page: Int
-          $sort: String
+    const query = `
+      query GetEcommerceBrands(
+        $limit: Int
+        $page: Int
+        $sort: String
+      ) {
+        GetEcommerceBrands(
+          limit: $limit
+          page: $page
+          sort: $sort
         ) {
-          GetEcommerceBrands(
-            limit: $limit
-            page: $page
-            sort: $sort
-          ) {
-            docs {
-              id
-              name
-              description
-              items_count
-              image_url
-              image_thumbnail_url
-              image_alt
-            }
-            hasNextPage
-            hasPrevPage
-            limit
-            nextPage
-            offset
-            page
-            pagingCounter
-            prevPage
-            totalDocs
-            totalPages
+          docs {
+            id
+            name
+            description
+            items_count
+            image_url
+            image_thumbnail_url
+            image_alt
           }
+          hasNextPage
+          hasPrevPage
+          limit
+          nextPage
+          offset
+          page
+          pagingCounter
+          prevPage
+          totalDocs
+          totalPages
         }
-      `;
-      const response = await this.client.post("/api/graphql", {
-        query,
-        variables: params
-      });
-      if (response.data.errors) {
-        const errorMessage = `GraphQL Error: ${response.data.errors[0].message}`;
-        return {
-          data: null,
-          brands: [],
-          hasNextPage: false,
-          hasPrevPage: false,
-          limit: 0,
-          nextPage: 0,
-          offset: 0,
-          page: 0,
-          pagingCounter: 0,
-          prevPage: 0,
-          totalDocs: 0,
-          totalPages: 0,
-          error: true,
-          errorMessage
-        };
-      }
-      const rawData = response.data.data.GetEcommerceBrands;
-      return {
-        data: rawData,
-        brands: rawData.docs,
-        hasNextPage: rawData.hasNextPage,
-        hasPrevPage: rawData.hasPrevPage,
-        limit: rawData.limit,
-        nextPage: rawData.nextPage,
-        offset: rawData.offset,
-        page: rawData.page,
-        pagingCounter: rawData.pagingCounter,
-        prevPage: rawData.prevPage,
-        totalDocs: rawData.totalDocs,
-        totalPages: rawData.totalPages,
-        error: false,
-        errorMessage: null
-      };
-    } catch (error) {
-      let errorMessage = "Error desconocido";
-      if (error instanceof AxiosError) {
-        const status = error.response?.status;
-        if (status === 401) {
-          errorMessage = "API Key inv\xE1lida o expirada";
-        } else if (status === 404) {
-          errorMessage = "Endpoint no encontrado";
-        } else if (status && status >= 500) {
-          errorMessage = "Error del servidor CMS";
-        } else {
-          errorMessage = `Error de conexi\xF3n: ${error.message}`;
-        }
-      } else if (error instanceof Error) {
-        errorMessage = error.message;
       }
+    `;
+    const { data, error, errorMessage } = await this.fetchGraphQL(
+      query,
+      params,
+      (responseData) => responseData.GetEcommerceBrands
+    );
+    if (error) {
       return {
         data: null,
         brands: [],
@@ -474,11 +514,27 @@ var PakentoCMSAPI = class {
         errorMessage
       };
     }
+    return {
+      data,
+      brands: data.docs,
+      hasNextPage: data.hasNextPage,
+      hasPrevPage: data.hasPrevPage,
+      limit: data.limit,
+      nextPage: data.nextPage,
+      offset: data.offset,
+      page: data.page,
+      pagingCounter: data.pagingCounter,
+      prevPage: data.prevPage,
+      totalDocs: data.totalDocs,
+      totalPages: data.totalPages,
+      error: false,
+      errorMessage: null
+    };
   }
   async getEntity(params = {}) {
     const { skipCache = false, cacheTTL, ...rest } = params;
-    const cacheKey = this.buildCacheKey("GetEntity", rest);
-    return this.getCachedOrFetch(
+    const cacheKey = this.cache.buildCacheKey("GetEntity", rest);
+    return this.cache.getCachedOrFetch(
       cacheKey,
       () => this.fetchEntityFromAPI(rest),
       cacheTTL,
@@ -494,81 +550,50 @@ var PakentoCMSAPI = class {
         errorMessage: "SDK no configurado: PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes."
       };
     }
-    try {
-      const query = `
-        query GetEntity {
-          GetEntity {
-            id
-            tin
-            name
-            web
-            address
-            country
-            city
-            currency_id
-            currency_name
-            currency_prefix
-            currency_suffix
-            logo_url
-            logo_alt
-            logo_thumbnail_url
-            logo_sizes_thumbnail_filename
-            logo_filename
-            logo_width
-            logo_height
-            logo_2_url
-            logo_2_alt
-            logo_2_thumbnail_url
-            logo_2_sizes_thumbnail_filename
-            logo_2_filename
-            logo_2_width
-            logo_2_height
-            featured_image_url
-            featured_image_alt
-            featured_image_thumbnail_url
-            featured_image_sizes_thumbnail_filename
-            featured_image_filename
-            featured_image_width
-            featured_image_height
-          }
-        }
-      `;
-      const response = await this.client.post("/api/graphql", {
-        query,
-        variables: params
-      });
-      if (response.data.errors) {
-        const errorMessage = `GraphQL Error: ${response.data.errors[0].message}`;
-        return {
-          data: null,
-          entity: null,
-          error: true,
-          errorMessage
-        };
-      }
-      const entityData = response.data.data.GetEntity;
-      return {
-        data: entityData,
-        entity: entityData,
-        error: false,
-        errorMessage: null
-      };
-    } catch (error) {
-      let errorMessage = "Error desconocido";
-      if (error instanceof AxiosError) {
-        const status = error.response?.status;
-        if (status === 401) {
-          errorMessage = "API Key inv\xE1lida o expirada";
-        } else if (status === 404) {
-          errorMessage = "Endpoint no encontrado";
-        } else if (status && status >= 500) {
-          errorMessage = "Error del servidor CMS";
-        } else {
-          errorMessage = `Error de conexi\xF3n: ${error.message}`;
+    const query = `
+      query GetEntity {
+        GetEntity {
+          id
+          tin
+          name
+          web
+          address
+          country
+          city
+          currency_id
+          currency_name
+          currency_prefix
+          currency_suffix
+          logo_url
+          logo_alt
+          logo_thumbnail_url
+          logo_sizes_thumbnail_filename
+          logo_filename
+          logo_width
+          logo_height
+          logo_2_url
+          logo_2_alt
+          logo_2_thumbnail_url
+          logo_2_sizes_thumbnail_filename
+          logo_2_filename
+          logo_2_width
+          logo_2_height
+          featured_image_url
+          featured_image_alt
+          featured_image_thumbnail_url
+          featured_image_sizes_thumbnail_filename
+          featured_image_filename
+          featured_image_width
+          featured_image_height
         }
-      } else if (error instanceof Error) {
-        errorMessage = error.message;
       }
+    `;
+    const { data, error, errorMessage } = await this.fetchGraphQL(
+      query,
+      params,
+      (responseData) => responseData.GetEntity
+    );
+    if (error) {
       return {
         data: null,
         entity: null,
@@ -576,49 +601,49 @@ var PakentoCMSAPI = class {
         errorMessage
       };
     }
+    return {
+      data,
+      entity: data,
+      error: false,
+      errorMessage: null
+    };
   }
   async createEcommerceOrder(params) {
     if (!this.baseURL || !this.apiKey) {
       return {
-        message: "SDK no configurado: PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes.",
-        error: true,
-        errorMessage: "SDK no configurado: PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes."
-      };
-    }
-    if (!params.name || !params.email) {
-      return {
-        message: "Faltan campos requeridos: name y email son obligatorios",
-        error: true,
-        errorMessage: "Faltan campos requeridos: name y email son obligatorios"
-      };
-    }
-    if (!params.items || !Array.isArray(params.items) || params.items.length === 0) {
-      return {
-        message: "Se requiere al menos un item en la orden",
+        message: "SDK no configurado",
         error: true,
-        errorMessage: "Se requiere al menos un item en la orden"
+        errorMessage: "SDK no configurado"
       };
     }
-    if (params.payment_method && params.payment_method !== "cash" && params.payment_method !== "transfer") {
-      return {
-        message: "M\xE9todo de pago no v\xE1lido",
-        error: true,
-        errorMessage: "M\xE9todo de pago no v\xE1lido"
-      };
-    }
-    for (const item of params.items) {
-      if (!item.id || !item.quantity || item.quantity <= 0) {
-        return {
-          message: "Cada item debe tener un id v\xE1lido y una cantidad mayor a 0",
-          error: true,
-          errorMessage: "Cada item debe tener un id v\xE1lido y una cantidad mayor a 0"
-        };
-      }
+    const orderSchema = z.object({
+      name: z.string().min(1),
+      email: z.string().email(),
+      phone: z.string().optional(),
+      notes: z.string().optional(),
+      tin: z.string().optional(),
+      items: z.array(
+        z.object({
+          id: z.number().positive(),
+          quantity: z.number().positive()
+        })
+      ).min(1),
+      delivery_address: z.string().optional(),
+      delivery_instructions: z.string().optional(),
+      payment_method: z.enum(["cash", "transfer"]).optional()
+    });
+    const validated = orderSchema.safeParse(params);
+    if (!validated.success) {
+      const errorMessage = this.handleApiError(
+        validated.error,
+        "createEcommerceOrder validation"
+      );
+      return { message: errorMessage, error: true, errorMessage };
     }
     try {
       const response = await this.client.post(
         "/api/orders/create-ecommerce-order",
-        params
+        validated.data
       );
       if (response.status === 200) {
         return {
@@ -628,36 +653,12 @@ var PakentoCMSAPI = class {
           errorMessage: null
         };
       } else {
-        return {
-          message: response.data.message || "Error al crear la orden",
-          error: true,
-          errorMessage: response.data.message || "Error al crear la orden"
-        };
+        const errorMessage = response.data.message || "Error al crear la orden";
+        return { message: errorMessage, error: true, errorMessage };
       }
     } catch (error) {
-      let errorMessage = "Error desconocido";
-      if (error instanceof AxiosError) {
-        const status = error.response?.status;
-        const responseMessage = error.response?.data?.message;
-        if (status === 400) {
-          errorMessage = responseMessage || "Datos de entrada inv\xE1lidos";
-        } else if (status === 401) {
-          errorMessage = "API Key inv\xE1lida o expirada";
-        } else if (status === 404) {
-          errorMessage = "Endpoint no encontrado";
-        } else if (status && status >= 500) {
-          errorMessage = "Error del servidor CMS";
-        } else {
-          errorMessage = responseMessage || `Error de conexi\xF3n: ${error.message}`;
-        }
-      } else if (error instanceof Error) {
-        errorMessage = error.message;
-      }
-      return {
-        message: errorMessage,
-        error: true,
-        errorMessage
-      };
+      const errorMessage = this.handleApiError(error, "createEcommerceOrder");
+      return { message: errorMessage, error: true, errorMessage };
     }
   }
   async executeCustomQuery(params) {
@@ -726,25 +727,24 @@ var PakentoCMSAPI = class {
         errorMessage: "SDK no configurado: PAKENTO_CMS_BASE_URL o PAKENTO_API_KEY faltantes."
       };
     }
-    if (!params.name || !params.email) {
-      return {
-        message: "Faltan campos requeridos: name y email son obligatorios",
-        error: true,
-        errorMessage: "Faltan campos requeridos: name y email son obligatorios"
-      };
-    }
-    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
-    if (!emailRegex.test(params.email)) {
-      return {
-        message: "Formato de email inv\xE1lido",
-        error: true,
-        errorMessage: "Formato de email inv\xE1lido"
-      };
+    const contactUsSchema = z.object({
+      name: z.string().min(1),
+      email: z.string().email(),
+      subject: z.string().optional(),
+      message: z.string().min(1)
+    });
+    const validated = contactUsSchema.safeParse(params);
+    if (!validated.success) {
+      const errorMessage = this.handleApiError(
+        validated.error,
+        "sendContactUsEmail validation"
+      );
+      return { message: errorMessage, error: true, errorMessage };
     }
     try {
       const response = await this.client.post(
         "/api/entities/send-contact-us-email",
-        params
+        validated.data
       );
       if (response.status === 200) {
         return {
@@ -753,38 +753,44 @@ var PakentoCMSAPI = class {
           errorMessage: null
         };
       } else {
-        return {
-          message: response.data.message || "Error al enviar el mensaje",
-          error: true,
-          errorMessage: response.data.message || "Error al enviar el mensaje"
-        };
+        const errorMessage = response.data.message || "Error al enviar el mensaje";
+        return { message: errorMessage, error: true, errorMessage };
       }
     } catch (error) {
-      let errorMessage = "Error desconocido";
-      if (error instanceof AxiosError) {
-        const status = error.response?.status;
-        const responseMessage = error.response?.data?.message;
-        if (status === 400) {
-          errorMessage = responseMessage || "Datos de entrada inv\xE1lidos";
-        } else if (status === 401) {
-          errorMessage = "API Key inv\xE1lida o expirada";
-        } else if (status === 404) {
-          errorMessage = "Endpoint no encontrado";
-        } else if (status && status >= 500) {
-          errorMessage = "Error del servidor CMS";
-        } else {
-          errorMessage = responseMessage || `Error de conexi\xF3n: ${error.message}`;
-        }
-      } else if (error instanceof Error) {
-        errorMessage = error.message;
-      }
-      return {
-        message: errorMessage,
-        error: true,
-        errorMessage
-      };
+      const errorMessage = this.handleApiError(error, "sendContactUsEmail");
+      return { message: errorMessage, error: true, errorMessage };
     }
   }
+  /**
+   * Verifica si existe cache para una función y parámetros específicos
+   */
+  async hasCache(functionName, params = {}) {
+    return this.cache.hasCache(functionName, params);
+  }
+  /**
+   * Obtiene la key de cache para una función y parámetros específicos
+   */
+  getCacheKey(functionName, params = {}) {
+    return this.cache.getCacheKey(functionName, params);
+  }
+  /**
+   * Limpia el cache para una función y parámetros específicos
+   */
+  async clearCache(functionName, params = {}) {
+    return this.cache.clearCache(functionName, params);
+  }
+  /**
+   * Limpia todo el cache relacionado con este API Key
+   */
+  async clearAllCache() {
+    return this.cache.clearAllCache();
+  }
+  /**
+   * Obtiene información del cache (útil para debugging)
+   */
+  async getCacheInfo(functionName, params = {}) {
+    return this.cache.getCacheInfo(functionName, params);
+  }
 };
 var pakentoCMSAPI = new PakentoCMSAPI();
 export {