arky-sdk 0.3.29 → 0.3.32

package/dist/index.d.cts

@@ -22,7 +22,7 @@ interface HttpClientConfig {
     isAuthenticated?: () => boolean;
 }
 
-declare const SDK_VERSION = "0.3.28";
+declare const SDK_VERSION = "0.3.30";
 declare const SUPPORTED_FRAMEWORKS: readonly ["astro", "react", "vue", "svelte", "vanilla"];
 interface ApiConfig {
     httpClient: any;
@@ -30,12 +30,14 @@ interface ApiConfig {
     storageUrl: string;
     baseUrl: string;
     market: string;
+    locale: string;
     setToken: (tokens: any) => void;
     getToken: () => Promise<any> | any;
 }
 
 declare function createArkySDK(config: HttpClientConfig & {
     market: string;
+    locale?: string;
 }): {
     user: {
         updateUser(params: UpdateUserProfileParams, options?: RequestOptions): Promise<any>;
@@ -163,6 +165,8 @@ declare function createArkySDK(config: HttpClientConfig & {
     getBusinessId: () => string;
     setMarket: (market: string) => void;
     getMarket: () => string;
+    setLocale: (locale: string) => void;
+    getLocale: () => string;
     isAuthenticated: () => boolean;
     logout: () => void;
     setToken: (tokens: AuthTokens) => void;

package/dist/index.d.ts

@@ -22,7 +22,7 @@ interface HttpClientConfig {
     isAuthenticated?: () => boolean;
 }
 
-declare const SDK_VERSION = "0.3.28";
+declare const SDK_VERSION = "0.3.30";
 declare const SUPPORTED_FRAMEWORKS: readonly ["astro", "react", "vue", "svelte", "vanilla"];
 interface ApiConfig {
     httpClient: any;
@@ -30,12 +30,14 @@ interface ApiConfig {
     storageUrl: string;
     baseUrl: string;
     market: string;
+    locale: string;
     setToken: (tokens: any) => void;
     getToken: () => Promise<any> | any;
 }
 
 declare function createArkySDK(config: HttpClientConfig & {
     market: string;
+    locale?: string;
 }): {
     user: {
         updateUser(params: UpdateUserProfileParams, options?: RequestOptions): Promise<any>;
@@ -163,6 +165,8 @@ declare function createArkySDK(config: HttpClientConfig & {
     getBusinessId: () => string;
     setMarket: (market: string) => void;
     getMarket: () => string;
+    setLocale: (locale: string) => void;
+    getLocale: () => string;
     isAuthenticated: () => boolean;
     logout: () => void;
     setToken: (tokens: AuthTokens) => void;

package/dist/index.js

@@ -515,6 +515,193 @@ var createAnalyticsApi = (apiConfig) => {
   };
 };
 
+// src/utils/slug.ts
+var isUuid = (str) => {
+  const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+  return uuidRegex.test(str);
+};
+var formatIdOrSlug = (id, apiConfig) => {
+  if (isUuid(id)) {
+    return id;
+  }
+  if (id.includes(":")) {
+    return id;
+  }
+  return `${apiConfig.businessId}:${apiConfig.locale}:${id}`;
+};
+
+// src/utils/blocks.ts
+function getBlockLabel(block, locale = "en") {
+  if (!block) return "";
+  if (block.properties?.label) {
+    if (typeof block.properties.label === "object") {
+      return block.properties.label[locale] || block.properties.label.en || Object.values(block.properties.label)[0] || "";
+    }
+    if (typeof block.properties.label === "string") {
+      return block.properties.label;
+    }
+  }
+  return block.key?.replace(/_/g, " ").replace(/\b\w/g, (l) => l.toUpperCase()) || "";
+}
+function formatBlockValue(block) {
+  if (!block || block.value === null || block.value === void 0) {
+    return "";
+  }
+  switch (block.type) {
+    case "BOOLEAN":
+      return block.value ? "Yes" : "No";
+    case "NUMBER":
+      if (block.properties?.variant === "DATE" || block.properties?.variant === "DATE_TIME") {
+        try {
+          return new Date(block.value).toLocaleDateString();
+        } catch (e) {
+          return String(block.value);
+        }
+      }
+      return String(block.value);
+    case "RELATIONSHIP":
+      if (Array.isArray(block.value) && block.value.length > 0) {
+        const firstValue = block.value[0];
+        if (firstValue && firstValue.mimeType) {
+          return firstValue.name || firstValue.id || "Media";
+        }
+        return firstValue.title || firstValue.name || firstValue.id || "Entry";
+      }
+      return String(block.value);
+    default:
+      return String(block.value);
+  }
+}
+function prepareBlocksForSubmission(formData) {
+  const preparedBlocks = [];
+  Object.keys(formData).forEach((key) => {
+    if (formData[key] !== null && formData[key] !== void 0) {
+      preparedBlocks.push({
+        key,
+        value: [formData[key]]
+      });
+    }
+  });
+  return preparedBlocks;
+}
+function extractBlockValues(blocks) {
+  const values = {};
+  blocks.forEach((block) => {
+    if (block.value && block.value.length > 0) {
+      values[block.key] = block.value[0];
+    } else {
+      values[block.key] = null;
+    }
+  });
+  return values;
+}
+function getBlockTextValue(block, locale = "en") {
+  if (!block || !block.value || block.value.length === 0) return "";
+  const firstValue = block.value[0];
+  if (typeof firstValue === "object" && firstValue !== null) {
+    if (firstValue[locale]) return firstValue[locale];
+    if (firstValue.en) return firstValue.en;
+    const values = Object.values(firstValue);
+    return String(values[0] || "");
+  }
+  return String(firstValue);
+}
+var getBlockValue = (entry, blockKey) => {
+  if (!entry || !entry.blocks) return null;
+  const block = entry.blocks.find((f) => f.key === blockKey);
+  if (!block || !block.value || block.value.length === 0) return null;
+  return block.value[0];
+};
+var getBlockValues = (entry, blockKey) => {
+  if (!entry || !entry.blocks) return null;
+  const block = entry.blocks.find((f) => f.key === blockKey);
+  if (!block || !block.value || block.value.length === 0) return null;
+  return block.value;
+};
+function unwrapBlock(block, locale) {
+  if (!block?.type || block.value === void 0) return block;
+  if (block.type === "BLOCK") {
+    return block.value.map((obj) => {
+      const parsed = {};
+      for (const [k, v] of Object.entries(obj)) {
+        parsed[k] = unwrapBlock(v, locale);
+      }
+      return parsed;
+    });
+  }
+  const isLocalized = block.type === "TEXT";
+  const isList = block.properties?.ui === "list" || (block.properties?.maxValues ?? 1) > 1 || block.value.length > 1;
+  if (isList) {
+    return isLocalized ? block.value.map((v) => v[locale] || v["en"]) : [...block.value];
+  }
+  return isLocalized ? block.value[0][locale] || block.value[0]["en"] : block.value[0];
+}
+var getBlockObjectValues = (entry, blockKey, locale = "en") => {
+  if (!entry) {
+    return [];
+  }
+  const values = getBlockValues(entry, blockKey);
+  const parsed = values.map((obj) => {
+    const res = obj.value.reduce((acc, current) => {
+      acc[current.key] = unwrapBlock(current, locale);
+      return acc;
+    }, {});
+    return res;
+  });
+  return parsed;
+};
+var getBlockFromArray = (entry, blockKey, locale = "en") => {
+  if (!entry) {
+    return [];
+  }
+  const values = getBlockValues(entry, blockKey);
+  return values.reduce((acc, current) => {
+    acc[current.key] = unwrapBlock(current, locale);
+    return acc;
+  });
+};
+var getImageUrl = (imageBlock, isBlock = true, storageUrl = "https://storage.arky.io/dev") => {
+  if (!imageBlock) return null;
+  const isExternalUrl = (url) => {
+    return url.startsWith("http://") || url.startsWith("https://");
+  };
+  if (imageBlock.type === "RELATIONSHIP" && Array.isArray(imageBlock.value)) {
+    const mediaValue = imageBlock.value[0];
+    if (mediaValue && mediaValue.mimeType) {
+      if (mediaValue.resolutions && mediaValue.resolutions.original && mediaValue.resolutions.original.url) {
+        const url = mediaValue.resolutions.original.url;
+        return isExternalUrl(url) ? url : `${storageUrl}/${url}`;
+      }
+      if (mediaValue.url) {
+        return isExternalUrl(mediaValue.url) ? mediaValue.url : `${storageUrl}/${mediaValue.url}`;
+      }
+    }
+    return null;
+  }
+  if (isBlock) {
+    if (typeof imageBlock === "string") {
+      if (isExternalUrl(imageBlock)) {
+        return imageBlock;
+      }
+      return `${storageUrl}/${imageBlock}`;
+    }
+    if (imageBlock.url) {
+      if (isExternalUrl(imageBlock.url)) {
+        return imageBlock.url;
+      }
+      return `${storageUrl}/${imageBlock.url}`;
+    }
+  }
+  if (imageBlock.resolutions && imageBlock.resolutions.original && imageBlock.resolutions.original.url) {
+    const url = imageBlock.resolutions.original.url;
+    if (isExternalUrl(url)) {
+      return url;
+    }
+    return `${storageUrl}/${url}`;
+  }
+  return null;
+};
+
 // src/api/cms.ts
 var createCmsApi = (apiConfig) => {
   return {
@@ -540,10 +727,24 @@ var createCmsApi = (apiConfig) => {
       );
     },
     async getCollection(params, options) {
-      return apiConfig.httpClient.get(
-        `/v1/businesses/${apiConfig.businessId}/collections/${params.id}`,
+      const formattedId = formatIdOrSlug(params.id, apiConfig);
+      const response = await apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/collections/${formattedId}`,
         options
       );
+      return {
+        ...response,
+        getBlock(key) {
+          return getBlockFromArray(response, key, apiConfig.locale);
+        },
+        getBlockValues(key) {
+          return getBlockObjectValues(response, key, apiConfig.locale);
+        },
+        getImage(key) {
+          const block = getBlockFromArray(response, key, apiConfig.locale);
+          return getImageUrl(block, true, apiConfig.storageUrl);
+        }
+      };
     },
     async getCollections(params, options) {
       return apiConfig.httpClient.get(
@@ -605,8 +806,9 @@ var createCmsApi = (apiConfig) => {
       );
     },
     async getCollectionEntry(params, options) {
+      const formattedId = formatIdOrSlug(params.id, apiConfig);
       return apiConfig.httpClient.get(
-        `/v1/businesses/${apiConfig.businessId}/entries/${params.id}`,
+        `/v1/businesses/${apiConfig.businessId}/entries/${formattedId}`,
         options
       );
     },
@@ -631,8 +833,9 @@ var createCmsApi = (apiConfig) => {
     },
     // ===== COLLECTION SUBSCRIPTIONS =====
     async getCollectionSubscribers(params, options) {
+      const formattedId = formatIdOrSlug(params.id, apiConfig);
       return apiConfig.httpClient.get(
-        `/v1/businesses/${apiConfig.businessId}/collections/${params.id}/subscribers`,
+        `/v1/businesses/${apiConfig.businessId}/collections/${formattedId}/subscribers`,
         options
       );
     },
@@ -648,10 +851,13 @@ var createCmsApi = (apiConfig) => {
       );
     },
     async unsubscribeFromCollection(params, options) {
-      return apiConfig.httpClient.get(`/v1/businesses/${apiConfig.businessId}/collections/unsubscribe`, {
-        ...options,
-        params
-      });
+      return apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/collections/unsubscribe`,
+        {
+          ...options,
+          params
+        }
+      );
     }
   };
 };
@@ -681,10 +887,22 @@ var createEshopApi = (apiConfig) => {
       );
     },
     async getProduct(params, options) {
-      return apiConfig.httpClient.get(
-        `/v1/businesses/${apiConfig.businessId}/products/${params.id}`,
+      const formattedId = formatIdOrSlug(params.id, apiConfig);
+      const response = await apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/products/${formattedId}`,
         options
       );
+      return {
+        ...response,
+        getName() {
+          const locale = apiConfig.locale;
+          return response.name?.[locale] || response.name?.en || response.name || "";
+        },
+        getDescription() {
+          const locale = apiConfig.locale;
+          return response.description?.[locale] || response.description?.en || response.description || "";
+        }
+      };
     },
     async getProducts(params, options) {
       return apiConfig.httpClient.get(
@@ -753,7 +971,9 @@ var createEshopApi = (apiConfig) => {
         currency: params.currency,
         paymentMethod: params.paymentMethod,
         lines,
-        ...params.shippingMethodId && { shippingMethodId: params.shippingMethodId },
+        ...params.shippingMethodId && {
+          shippingMethodId: params.shippingMethodId
+        },
         ...params.promoCode && { promoCode: params.promoCode }
       };
       return apiConfig.httpClient.post(`/v1/payments/quote`, payload, options);
@@ -791,7 +1011,11 @@ var createReservationApi = (apiConfig) => {
     },
     async updateReservation(params, options) {
       const { id, ...payload } = params;
-      return apiConfig.httpClient.put(`/v1/reservations/${id}`, payload, options);
+      return apiConfig.httpClient.put(
+        `/v1/reservations/${id}`,
+        payload,
+        options
+      );
     },
     async checkout(params, options) {
       const payload = {
@@ -802,7 +1026,11 @@ var createReservationApi = (apiConfig) => {
         ...params.paymentMethod && { paymentMethod: params.paymentMethod },
         ...params.promoCode && { promoCode: params.promoCode }
       };
-      return apiConfig.httpClient.post(`/v1/reservations/checkout`, payload, options);
+      return apiConfig.httpClient.post(
+        `/v1/reservations/checkout`,
+        payload,
+        options
+      );
     },
     async getReservation(params, options) {
       return apiConfig.httpClient.get(`/v1/reservations/${params.id}`, {
@@ -870,10 +1098,22 @@ var createReservationApi = (apiConfig) => {
       );
     },
     async getService(params, options) {
-      return apiConfig.httpClient.get(
-        `/v1/businesses/${apiConfig.businessId}/services/${params.id}`,
+      const formattedId = formatIdOrSlug(params.id, apiConfig);
+      const response = await apiConfig.httpClient.get(
+        `/v1/businesses/${apiConfig.businessId}/services/${formattedId}`,
         options
       );
+      return {
+        ...response,
+        getName() {
+          const locale = apiConfig.locale;
+          return response.name?.[locale] || response.name?.en || response.name || "";
+        },
+        getDescription() {
+          const locale = apiConfig.locale;
+          return response.description?.[locale] || response.description?.en || response.description || "";
+        }
+      };
     },
     async getServices(params, options) {
       return apiConfig.httpClient.get(
@@ -967,178 +1207,6 @@ var createPaymentApi = (apiConfig) => {
   };
 };
 
-// src/utils/blocks.ts
-function getBlockLabel(block, locale = "en") {
-  if (!block) return "";
-  if (block.properties?.label) {
-    if (typeof block.properties.label === "object") {
-      return block.properties.label[locale] || block.properties.label.en || Object.values(block.properties.label)[0] || "";
-    }
-    if (typeof block.properties.label === "string") {
-      return block.properties.label;
-    }
-  }
-  return block.key?.replace(/_/g, " ").replace(/\b\w/g, (l) => l.toUpperCase()) || "";
-}
-function formatBlockValue(block) {
-  if (!block || block.value === null || block.value === void 0) {
-    return "";
-  }
-  switch (block.type) {
-    case "BOOLEAN":
-      return block.value ? "Yes" : "No";
-    case "NUMBER":
-      if (block.properties?.variant === "DATE" || block.properties?.variant === "DATE_TIME") {
-        try {
-          return new Date(block.value).toLocaleDateString();
-        } catch (e) {
-          return String(block.value);
-        }
-      }
-      return String(block.value);
-    case "RELATIONSHIP":
-      if (Array.isArray(block.value) && block.value.length > 0) {
-        const firstValue = block.value[0];
-        if (firstValue && firstValue.mimeType) {
-          return firstValue.name || firstValue.id || "Media";
-        }
-        return firstValue.title || firstValue.name || firstValue.id || "Entry";
-      }
-      return String(block.value);
-    default:
-      return String(block.value);
-  }
-}
-function prepareBlocksForSubmission(formData) {
-  const preparedBlocks = [];
-  Object.keys(formData).forEach((key) => {
-    if (formData[key] !== null && formData[key] !== void 0) {
-      preparedBlocks.push({
-        key,
-        value: [formData[key]]
-      });
-    }
-  });
-  return preparedBlocks;
-}
-function extractBlockValues(blocks) {
-  const values = {};
-  blocks.forEach((block) => {
-    if (block.value && block.value.length > 0) {
-      values[block.key] = block.value[0];
-    } else {
-      values[block.key] = null;
-    }
-  });
-  return values;
-}
-function getBlockTextValue(block, locale = "en") {
-  if (!block || !block.value || block.value.length === 0) return "";
-  const firstValue = block.value[0];
-  if (typeof firstValue === "object" && firstValue !== null) {
-    if (firstValue[locale]) return firstValue[locale];
-    if (firstValue.en) return firstValue.en;
-    const values = Object.values(firstValue);
-    return String(values[0] || "");
-  }
-  return String(firstValue);
-}
-var getBlockValue = (entry, blockKey) => {
-  if (!entry || !entry.blocks) return null;
-  const block = entry.blocks.find((f) => f.key === blockKey);
-  if (!block || !block.value || block.value.length === 0) return null;
-  return block.value[0];
-};
-var getBlockValues = (entry, blockKey) => {
-  if (!entry || !entry.blocks) return null;
-  const block = entry.blocks.find((f) => f.key === blockKey);
-  if (!block || !block.value || block.value.length === 0) return null;
-  return block.value;
-};
-function unwrapBlock(block, locale) {
-  if (!block?.type || block.value === void 0) return block;
-  if (block.type === "BLOCK") {
-    return block.value.map((obj) => {
-      const parsed = {};
-      for (const [k, v] of Object.entries(obj)) {
-        parsed[k] = unwrapBlock(v, locale);
-      }
-      return parsed;
-    });
-  }
-  const isLocalized = block.type === "TEXT";
-  const isList = block.properties?.ui === "list" || (block.properties?.maxValues ?? 1) > 1 || block.value.length > 1;
-  if (isList) {
-    return isLocalized ? block.value.map((v) => v[locale] || v["en"]) : [...block.value];
-  }
-  return isLocalized ? block.value[0][locale] || block.value[0]["en"] : block.value[0];
-}
-var getBlockObjectValues = (entry, blockKey, locale = "en") => {
-  if (!entry) {
-    return [];
-  }
-  const values = getBlockValues(entry, blockKey);
-  const parsed = values.map((obj) => {
-    const res = obj.value.reduce((acc, current) => {
-      acc[current.key] = unwrapBlock(current, locale);
-      return acc;
-    }, {});
-    return res;
-  });
-  return parsed;
-};
-var getBlockFromArray = (entry, blockKey, locale = "en") => {
-  if (!entry) {
-    return [];
-  }
-  const values = getBlockValues(entry, blockKey);
-  return values.reduce((acc, current) => {
-    acc[current.key] = unwrapBlock(current, locale);
-    return acc;
-  });
-};
-var getImageUrl = (imageBlock, isBlock = true, storageUrl = "https://storage.arky.io/dev") => {
-  if (!imageBlock) return null;
-  const isExternalUrl = (url) => {
-    return url.startsWith("http://") || url.startsWith("https://");
-  };
-  if (imageBlock.type === "RELATIONSHIP" && Array.isArray(imageBlock.value)) {
-    const mediaValue = imageBlock.value[0];
-    if (mediaValue && mediaValue.mimeType) {
-      if (mediaValue.resolutions && mediaValue.resolutions.original && mediaValue.resolutions.original.url) {
-        const url = mediaValue.resolutions.original.url;
-        return isExternalUrl(url) ? url : `${storageUrl}/${url}`;
-      }
-      if (mediaValue.url) {
-        return isExternalUrl(mediaValue.url) ? mediaValue.url : `${storageUrl}/${mediaValue.url}`;
-      }
-    }
-    return null;
-  }
-  if (isBlock) {
-    if (typeof imageBlock === "string") {
-      if (isExternalUrl(imageBlock)) {
-        return imageBlock;
-      }
-      return `${storageUrl}/${imageBlock}`;
-    }
-    if (imageBlock.url) {
-      if (isExternalUrl(imageBlock.url)) {
-        return imageBlock.url;
-      }
-      return `${storageUrl}/${imageBlock.url}`;
-    }
-  }
-  if (imageBlock.resolutions && imageBlock.resolutions.original && imageBlock.resolutions.original.url) {
-    const url = imageBlock.resolutions.original.url;
-    if (isExternalUrl(url)) {
-      return url;
-    }
-    return `${storageUrl}/${url}`;
-  }
-  return null;
-};
-
 // src/utils/currency.ts
 function getCurrencySymbol(currency) {
   const currencySymbols = {
@@ -1487,7 +1555,7 @@ async function injectSvgIntoElement(mediaObject, targetElement, className) {
 }
 
 // src/index.ts
-var SDK_VERSION = "0.3.28";
+var SDK_VERSION = "0.3.30";
 var SUPPORTED_FRAMEWORKS = [
   "astro",
   "react",
@@ -1496,8 +1564,9 @@ var SUPPORTED_FRAMEWORKS = [
   "vanilla"
 ];
 function createArkySDK(config) {
+  const locale = config.locale || "en";
   console.log(
-    `[Arky SDK v${SDK_VERSION}] Initializing with market: ${config.market}, businessId: ${config.businessId}`
+    `[Arky SDK v${SDK_VERSION}] Initializing with market: ${config.market}, businessId: ${config.businessId}, locale: ${locale}`
   );
   const httpClient = createHttpClient(config);
   const storageUrl = config.storageUrl || "https://storage.arky.io/dev";
@@ -1507,6 +1576,7 @@ function createArkySDK(config) {
     storageUrl,
     baseUrl: config.baseUrl,
     market: config.market,
+    locale,
     setToken: config.setToken,
     getToken: config.getToken
   };
@@ -1532,6 +1602,10 @@ function createArkySDK(config) {
       apiConfig.market = market;
     },
     getMarket: () => apiConfig.market,
+    setLocale: (locale2) => {
+      apiConfig.locale = locale2;
+    },
+    getLocale: () => apiConfig.locale,
     isAuthenticated: config.isAuthenticated || (() => false),
     logout: config.logout,
     setToken: config.setToken,