@swell/apps-sdk 1.0.140 → 1.0.142

package/dist/index.cjs

@@ -90,6 +90,7 @@ __export(index_exports, {
   adaptShopifyMenuData: () => adaptShopifyMenuData,
   arrayToObject: () => arrayToObject,
   cloneStorefrontResource: () => cloneStorefrontResource,
+  configureSdkLogger: () => configureSdkLogger,
   deferMenuItemUrlAndResource: () => deferMenuItemUrlAndResource,
   dehydrateSwellRefsInStorefrontResources: () => dehydrateSwellRefsInStorefrontResources,
   extractSettingsFromForm: () => extractSettingsFromForm,
@@ -213,6 +214,97 @@ var import_json52 = __toESM(require("json5"), 1);
 // src/resources.ts
 var import_lodash_es2 = require("lodash-es");
 
+// src/utils/logger.ts
+var logLevels = {
+  error: 0,
+  warn: 1,
+  info: 2,
+  debug: 3
+};
+var currentLogLevel = "warn";
+var currentTimestampFormat = "off";
+var isStructured = false;
+function configureSdkLogger(config = {}) {
+  if (config.level && logLevels[config.level] !== void 0) {
+    currentLogLevel = config.level;
+  }
+  if (config.timestamp) {
+    currentTimestampFormat = config.timestamp;
+  }
+  if (typeof config.structured === "boolean") {
+    isStructured = config.structured;
+  }
+}
+function getTimestamp() {
+  if (currentTimestampFormat === "iso") {
+    return (/* @__PURE__ */ new Date()).toISOString();
+  }
+  if (currentTimestampFormat === "unix") {
+    return Date.now();
+  }
+  return void 0;
+}
+function formatArgs(args) {
+  const timestamp = getTimestamp();
+  if (!isStructured) {
+    return timestamp !== void 0 ? [...args, `(${timestamp})`] : args;
+  }
+  let message = "";
+  let context = {};
+  const messageParts = [];
+  for (const arg of args) {
+    if (arg instanceof Error) {
+      context.error = {
+        name: arg.name,
+        message: arg.message,
+        stack: arg.stack
+      };
+    } else if (typeof arg === "object" && arg !== null && !Array.isArray(arg) && Object.getPrototypeOf(arg) === Object.prototype) {
+      Object.assign(context, arg);
+    } else {
+      messageParts.push(arg);
+    }
+  }
+  message = messageParts.map((part) => typeof part === "object" ? JSON.stringify(part) : part).join(" ");
+  const finalLogObject = {
+    message,
+    ...context,
+    ...timestamp && { timestamp }
+  };
+  return [finalLogObject];
+}
+var logger = {
+  error: (...args) => {
+    console.error(...formatArgs(args));
+  },
+  warn: (...args) => {
+    if (logLevels[currentLogLevel] >= logLevels.warn) {
+      console.warn(...formatArgs(args));
+    }
+  },
+  info: (...args) => {
+    if (logLevels[currentLogLevel] >= logLevels.info) {
+      console.info(...formatArgs(args));
+    }
+  },
+  debug: (...args) => {
+    if (logLevels[currentLogLevel] >= logLevels.debug) {
+      console.debug(...formatArgs(args));
+    }
+  }
+};
+function createTraceId(data) {
+  if (data === void 0) {
+    return Math.random().toString(36).substring(2, 10);
+  }
+  let hash = 5381;
+  for (let i = 0; i < data.length; i++) {
+    const char = data.charCodeAt(i);
+    hash = (hash << 5) + hash + char;
+  }
+  return (hash >>> 0).toString(16);
+}
+
 // src/liquid/utils.ts
 var import_liquidjs = require("liquidjs");
 
@@ -608,7 +700,7 @@ var StorefrontResource = class {
             return instance[prop];
           }
           instance._result = instance._get().catch((err) => {
-            console.log(err);
+            logger.error(err);
             return instance._getCollectionResultOrProp(instance, prop);
           });
         }
@@ -616,7 +708,7 @@ var StorefrontResource = class {
           return instance._result.then(() => {
             return instance._getCollectionResultOrProp(instance, prop);
           }).catch((err) => {
-            console.log(err);
+            logger.error(err);
             return null;
           });
         }
@@ -675,7 +767,7 @@ var StorefrontResource = class {
         }
         return result;
       }).catch((err) => {
-        console.log(err);
+        logger.error(err);
         return null;
       });
     }
@@ -853,7 +945,7 @@ var SwellStorefrontCollection = class _SwellStorefrontCollection extends SwellSt
         }
         return result;
       }).catch((err) => {
-        console.log(err);
+        logger.error(err);
         return null;
       });
     }
@@ -967,7 +1059,7 @@ var SwellStorefrontRecord = class extends SwellStorefrontResource {
         }
         return result;
       }).catch((err) => {
-        console.log(err);
+        logger.error(err);
         return null;
       });
     }
@@ -1001,15 +1093,25 @@ var SwellStorefrontSingleton = class extends SwellStorefrontResource {
   }
   async _get() {
     if (this._getter) {
+      const trace = createTraceId();
+      logger.debug("[SDK] Resource fetch start", {
+        resource: this.constructor.name,
+        hash: this._getterHash,
+        trace
+      });
       const getter = this._getter.bind(this);
       this._result = Promise.resolve().then(getter).then((result) => {
+        logger.debug("[SDK] Resource fetch end", {
+          hash: this._getterHash,
+          trace
+        });
         this._result = result;
         if (result) {
           Object.assign(this, result);
         }
         return result;
       }).catch((err) => {
-        console.log(err);
+        logger.error(err, { trace });
         return null;
       });
     }
@@ -7093,6 +7195,7 @@ var DEFAULT_OPTIONS = Object.freeze({
   ttl: DEFAULT_TTL
 });
 var NULL_VALUE = "__NULL__";
+var SWR_PROMISE_MAP = /* @__PURE__ */ new Map();
 var Cache = class {
   client;
   workerCtx;
@@ -7114,19 +7217,31 @@ var Cache = class {
    * This will always return the cached value immediately if exists
    */
   async fetchSWR(key, fetchFn, ttl = DEFAULT_SWR_TTL) {
+    const trace = createTraceId();
+    logger.debug("[SDK] Cache fetch start", { key, trace });
     const cacheValue = await this.client.get(key);
-    const promiseValue = Promise.resolve().then(fetchFn).then(resolveAsyncResources).then(async (value) => {
-      const isNull = value === null || value === void 0;
-      await this.client.set(key, isNull ? NULL_VALUE : value, ttl);
-      return value;
-    });
-    if (this.workerCtx?.waitUntil) {
-      this.workerCtx.waitUntil(promiseValue);
+    let promise = SWR_PROMISE_MAP.get(key);
+    if (promise === void 0) {
+      promise = Promise.resolve().then(fetchFn).then(resolveAsyncResources).then(async (value) => {
+        const isNull = value === null || value === void 0;
+        await this.client.set(key, isNull ? NULL_VALUE : value, ttl);
+        logger.debug("[SDK] Cache update done", { key, trace });
+        return value;
+      }).finally(() => {
+        SWR_PROMISE_MAP.delete(key);
+      });
+      SWR_PROMISE_MAP.set(key, promise);
+    }
+    if (typeof this.workerCtx?.waitUntil === "function") {
+      this.workerCtx.waitUntil(promise);
     }
     if (cacheValue !== void 0) {
+      logger.debug("[SDK] Cache check done", { status: "HIT", key, trace });
       return cacheValue === NULL_VALUE ? null : cacheValue;
     }
-    const result = await promiseValue;
+    logger.debug("[SDK] Cache check done", { status: "MISS", key, trace });
+    const result = await promise;
+    logger.debug("[SDK] Cache fetch end", { key, trace });
     return result;
   }
   async get(key) {
@@ -7501,8 +7616,12 @@ var Swell = class _Swell {
       queryParams,
       workerEnv,
       workerCtx,
+      logger: loggerConfig,
       ...clientProps
     } = params;
+    if (loggerConfig) {
+      configureSdkLogger(loggerConfig);
+    }
     this.url = url instanceof URL ? url : new URL(url || "");
     this.config = config;
     this.shopifyCompatibilityConfig = shopifyCompatibilityConfig;
@@ -7512,7 +7631,9 @@ var Swell = class _Swell {
     this.workerCtx = workerCtx;
     this.workerEnv = workerEnv;
     this.resourceLoadingIndicator = params.resourceLoadingIndicator;
-    console.log(`KV cache: ${this.workerEnv?.THEME ? "enabled" : "disabled"}`);
+    logger.info(
+      `[SDK] KV cache: ${this.workerEnv?.THEME ? "enabled" : "disabled"}`
+    );
     if (serverHeaders) {
       const { headers: headers2, swellHeaders: swellHeaders2 } = _Swell.formatHeaders(serverHeaders);
       this.headers = headers2;
@@ -7626,7 +7747,7 @@ var Swell = class _Swell {
       if (err instanceof Error) {
         err.message = `Swell: unable to load settings (${err.message})`;
       }
-      console.error(err);
+      logger.error(err);
     }
     return this.storefront.settings.get();
   }
@@ -7709,7 +7830,9 @@ var Swell = class _Swell {
           decodeURIComponent(this.swellHeaders["storefront-context"])
         );
       } catch (error) {
-        console.error("Failed to parse swell-storefront-context. Ignoring...");
+        logger.error(
+          "[SDK] Failed to parse swell-storefront-context. Ignoring..."
+        );
       }
     }
     return storefrontContext;
@@ -7739,7 +7862,7 @@ var Swell = class _Swell {
         return this.getRequestCache().fetchSWR(
           getCacheKey("request", [this.instanceId, method, url, id, data, opt]),
           () => {
-            console.log("Storefront request", { method, url, id, data });
+            logger.info("[SDK] Storefront request", { method, url, id, data });
             return storefrontRequest(method, url, id, data, opt);
           }
         );
@@ -7763,7 +7886,7 @@ var Swell = class _Swell {
    */
   getResourceCache() {
     let cache = resourceCaches.get(this.instanceId);
-    if (!cache) {
+    if (cache === void 0) {
       cache = new ResourceCache({
         kvStore: this.workerEnv?.THEME,
         workerCtx: this.workerCtx
@@ -7777,7 +7900,7 @@ var Swell = class _Swell {
    */
   getRequestCache() {
     let cache = requestCaches.get(this.instanceId);
-    if (!cache) {
+    if (cache === void 0) {
       cache = new RequestCache({
         kvStore: this.workerEnv?.THEME,
         workerCtx: this.workerCtx
@@ -7830,6 +7953,11 @@ var SwellBackendAPI = class {
     }
     const endpointUrl = String(url).startsWith("/") ? url.substring(1) : url;
     const requestUrl = `${this.apiHost}/${endpointUrl}${query}`;
+    const trace = createTraceId();
+    logger.debug("[SDK] Backend request start", {
+      query: `/${endpointUrl}${query}`,
+      trace
+    });
     const response = await fetch(requestUrl, requestOptions);
     const responseText = await response.text();
     let result;
@@ -7838,6 +7966,10 @@ var SwellBackendAPI = class {
     } catch {
       result = String(responseText || "").trim();
     }
+    logger.debug("[SDK] Backend request end", {
+      status: response.status,
+      trace
+    });
     if (response.status > 299) {
       throw new SwellError(result, {
         status: response.status,
@@ -8725,11 +8857,11 @@ function getRandomId() {
 }
 
 // src/menus.ts
-var import_lodash_es11 = require("lodash-es");
+var import_lodash_es12 = require("lodash-es");
 
 // src/theme.ts
 var import_json56 = __toESM(require("json5"), 1);
-var import_lodash_es10 = require("lodash-es");
+var import_lodash_es11 = require("lodash-es");
 
 // src/compatibility/shopify.ts
 var import_lodash_es7 = require("lodash-es");
@@ -17549,7 +17681,7 @@ var tags = {
 };
 function bindTags(liquidSwell) {
   Object.entries(tags).forEach(
-    ([tag, bind62]) => liquidSwell.registerTag(tag, bind62(liquidSwell))
+    ([tag, bind63]) => liquidSwell.registerTag(tag, bind63(liquidSwell))
   );
 }
 
@@ -17833,8 +17965,16 @@ var format_address_default = {
   ]
 };
 
-// src/liquid/filters/image_tag.ts
+// src/liquid/filters/handleize.ts
+var import_lodash_es10 = require("lodash-es");
 function bind40(_liquidSwell) {
+  return function filterHandleize(handle) {
+    return (0, import_lodash_es10.kebabCase)(handle);
+  };
+}
+
+// src/liquid/filters/image_tag.ts
+function bind41(_liquidSwell) {
   return function filterImageTag(imageUrl, ...params) {
     imageUrl = String(imageUrl || "");
     let {
@@ -17998,7 +18138,7 @@ var filterDefinition = {
 var image_url_default = filterDefinition;
 
 // src/liquid/filters/inline_asset_content.ts
-function bind41(liquidSwell) {
+function bind42(liquidSwell) {
   return async (assetPath) => {
     const config = await liquidSwell.theme.getThemeConfig(
       `theme/assets/${assetPath}`
@@ -18008,14 +18148,14 @@ function bind41(liquidSwell) {
 }
 
 // src/liquid/filters/json.ts
-function bind42(_liquidSwell) {
+function bind43(_liquidSwell) {
   return async function filterJson(input, space = 0) {
     return jsonStringifyAsync(input, space);
   };
 }
 
 // src/liquid/filters/json_pretty.ts
-function bind43(_liquidSwell) {
+function bind44(_liquidSwell) {
   return async function filterJsonPretty(input, space = 2) {
     const output = await jsonStringifyAsync(input, space);
     return `<pre>${output}</pre>`;
@@ -18032,7 +18172,7 @@ function getCountryCode(localCode) {
     return localCode.toUpperCase();
   }
 }
-function bind44(_liquidSwell) {
+function bind45(_liquidSwell) {
   return (localeCode) => {
     if (typeof localeCode !== "string") {
       return flags.US;
@@ -18043,7 +18183,7 @@ function bind44(_liquidSwell) {
 }
 
 // src/liquid/filters/money.ts
-function bind45(liquidSwell) {
+function bind46(liquidSwell) {
   return function filterMoney(value) {
     const amount = value instanceof MoneyDrop ? value.toFloat() : Number(value || 0);
     return liquidSwell.renderCurrency(amount);
@@ -18051,7 +18191,7 @@ function bind45(liquidSwell) {
 }
 
 // src/liquid/filters/money_with_currency.ts
-function bind46(liquidSwell) {
+function bind47(liquidSwell) {
   return function filterMoneyWithCurrency(value) {
     const { currency } = liquidSwell.theme.swell.getStorefrontLocalization();
     const amount = value instanceof MoneyDrop ? value.toFloat() : Number(value || 0);
@@ -18060,7 +18200,7 @@ function bind46(liquidSwell) {
 }
 
 // src/liquid/filters/money_without_currency.ts
-function bind47(liquidSwell) {
+function bind48(liquidSwell) {
   return function filterMoneyWithoutCurrency(value) {
     const amount = value instanceof MoneyDrop ? value.toFloat() : Number(value || 0);
     return liquidSwell.renderCurrency(amount).replace(/[^0-9.,]/g, "");
@@ -18068,7 +18208,7 @@ function bind47(liquidSwell) {
 }
 
 // src/liquid/filters/money_without_trailing_zeros.ts
-function bind48(liquidSwell) {
+function bind49(liquidSwell) {
   return function filterMoneyWithoutTrailingZeros(value) {
     const amount = value instanceof MoneyDrop ? value.toFloat() : Number(value || 0);
     return liquidSwell.renderCurrency(amount).split(".")[0].split(",")[0];
@@ -18076,21 +18216,21 @@ function bind48(liquidSwell) {
 }
 
 // src/liquid/filters/script_tag.ts
-function bind49(_liquidSwell) {
+function bind50(_liquidSwell) {
   return function filterScriptTag(assetUrl) {
     return `<script src="${assetUrl}" type="text/javascript"></script>`;
   };
 }
 
 // src/liquid/filters/stylesheet_tag.ts
-function bind50(_liquidSwell) {
+function bind51(_liquidSwell) {
   return function filterStyleSheetTag(assetUrl) {
     return `<link href="${assetUrl}" rel="stylesheet" type="text/css" media="all" />`;
   };
 }
 
 // src/liquid/filters/time_tag.ts
-function bind51(_liquidSwell) {
+function bind52(_liquidSwell) {
   const dateFilter = bind33(_liquidSwell);
   return (dateValue, ...params) => {
     const date = ensureDate(dateValue);
@@ -18101,7 +18241,7 @@ function bind51(_liquidSwell) {
 }
 
 // src/liquid/filters/translate.ts
-function bind52(liquidSwell) {
+function bind53(liquidSwell) {
   return async function filterTranslate(key, params) {
     const props = params && paramsToProps(params);
     const str = await liquidSwell.renderTranslation(key, props);
@@ -18110,7 +18250,7 @@ function bind52(liquidSwell) {
 }
 
 // src/liquid/filters/where.ts
-function bind53(_liquidSwell) {
+function bind54(_liquidSwell) {
   return function* filterWhere(arr, property, expected) {
     const results = [];
     const list = yield resolveEnumerable(arr);
@@ -18164,7 +18304,7 @@ function getSizesFromParam(param) {
     height: height ? Number(height) : void 0
   };
 }
-function bind54(liquidSwell) {
+function bind55(liquidSwell) {
   return async function filterAssetImgUrl(assetPath, size = "small") {
     const imageUrl = await liquidSwell.getAssetUrl(assetPath).then((url) => url || "");
     const sizes = getSizesFromParam(size);
@@ -18180,7 +18320,7 @@ function bind54(liquidSwell) {
 }
 
 // src/liquid/filters/shopify/hex_to_rgba.ts
-function bind55(_liquidSwell) {
+function bind56(_liquidSwell) {
   return (color, alpha) => {
     return ThemeColor.get(color).rgba(alpha || 1);
   };
@@ -18200,14 +18340,14 @@ var item_count_for_variant_default = {
 };
 
 // src/liquid/filters/shopify/payment_button.ts
-function bind56(_liquidSwell) {
+function bind57(_liquidSwell) {
   return (form) => {
     return null;
   };
 }
 
 // src/liquid/filters/shopify/payment_terms.ts
-function bind57(_liquidSwell) {
+function bind58(_liquidSwell) {
   return (form) => {
     return null;
   };
@@ -18309,7 +18449,7 @@ var svgs = {
 var placeholder_svgs_default = svgs;
 
 // src/liquid/filters/shopify/placeholder_svg_tag.ts
-function bind58(_liquidSwell) {
+function bind59(_liquidSwell) {
   return function filterPlaceholderSvgTag(name, className) {
     const svg = placeholder_svgs_default[name];
     if (typeof svg === "object" && svg !== null) {
@@ -18320,7 +18460,7 @@ function bind58(_liquidSwell) {
 }
 
 // src/liquid/filters/shopify/shopify_asset_url.ts
-function bind59(_liquidSwell) {
+function bind60(_liquidSwell) {
   return function filterShopifyAssetUrl(input) {
     if (typeof input === "string") {
       switch (input) {
@@ -18345,7 +18485,7 @@ function bind59(_liquidSwell) {
 }
 
 // src/liquid/filters/shopify/structured_data.ts
-function bind60(_liquidSwell) {
+function bind61(_liquidSwell) {
   return async function filterStructuredData(input) {
     let value = input;
     if (value instanceof StorefrontResource) {
@@ -18423,7 +18563,7 @@ function convertToSchemaOrgProductGroup(product) {
 }
 
 // src/liquid/filters/inline_editable.ts
-function bind61(_liquidSwell) {
+function bind62(_liquidSwell) {
   return (value, key) => {
     if (typeof value === "object" && "value" in value) {
       value = value.value;
@@ -18457,34 +18597,37 @@ var filters = {
   font_modify: bind38,
   font_url: bind39,
   format_address: format_address_default,
-  image_tag: bind40,
+  handle: bind40,
+  // alias
+  handleize: bind40,
+  image_tag: bind41,
   image_url: image_url_default,
-  inline_asset_content: bind41,
-  json: bind42,
-  json_pretty: bind43,
-  locale_flag: bind44,
-  money: bind45,
-  money_with_currency: bind46,
-  money_without_currency: bind47,
-  money_without_trailing_zeros: bind48,
-  script_tag: bind49,
-  stylesheet_tag: bind50,
-  time_tag: bind51,
-  translate: bind52,
-  t: bind52,
+  inline_asset_content: bind42,
+  json: bind43,
+  json_pretty: bind44,
+  locale_flag: bind45,
+  money: bind46,
+  money_with_currency: bind47,
+  money_without_currency: bind48,
+  money_without_trailing_zeros: bind49,
+  script_tag: bind50,
+  stylesheet_tag: bind51,
+  time_tag: bind52,
+  translate: bind53,
+  t: bind53,
   // alias
-  where: bind53,
+  where: bind54,
   // Shopify compatibility only
-  asset_img_url: bind54,
-  hex_to_rgba: bind55,
+  asset_img_url: bind55,
+  hex_to_rgba: bind56,
   item_count_for_variant: item_count_for_variant_default,
-  payment_button: bind56,
-  payment_terms: bind57,
-  placeholder_svg_tag: bind58,
-  shopify_asset_url: bind59,
-  structured_data: bind60,
+  payment_button: bind57,
+  payment_terms: bind58,
+  placeholder_svg_tag: bind59,
+  shopify_asset_url: bind60,
+  structured_data: bind61,
   // Swell only
-  inline_editable: bind61
+  inline_editable: bind62
 };
 function bindFilters(liquidSwell) {
   for (const [tag, handler] of Object.entries(filters)) {
@@ -18498,8 +18641,8 @@ function bindFilters(liquidSwell) {
     }
   }
 }
-function bindWithResolvedProps(liquidSwell, bind62, resolve = []) {
-  const handler = bind62(liquidSwell);
+function bindWithResolvedProps(liquidSwell, bind63, resolve = []) {
+  const handler = bind63(liquidSwell);
   if (!Array.isArray(resolve)) {
     return handler;
   }
@@ -19243,9 +19386,14 @@ var SwellTheme3 = class {
   }
   async initGlobals(pageId, altTemplate) {
     this.pageId = pageId;
+    const trace = createTraceId();
+    logger.debug("[SDK] Theme init start", { page: pageId, trace });
     await this.themeLoader.init(this.themeConfigs || void 0);
+    logger.debug("[SDK] ThemeLoader init done", { page: pageId, trace });
     const { store, session, menus, geo, configs } = await this.getSettingsAndConfigs();
+    logger.debug("[SDK] Theme settings load done", { page: pageId, trace });
     const { settings, request, page, cart, account, customer } = await this.resolvePageData(store, configs, pageId, altTemplate);
+    logger.debug("[SDK] Theme page data load done", { page: pageId, trace });
     this.page = page;
     const globals = {
       ...this.globalData,
@@ -19272,6 +19420,7 @@ var SwellTheme3 = class {
     if (this.shopifyCompatibility) {
       this.shopifyCompatibility.adaptQueryParams();
     }
+    logger.debug("[SDK] Theme init end", { page: pageId, trace });
   }
   setGlobals(globals) {
     if (this.shopifyCompatibility) {
@@ -19304,7 +19453,7 @@ var SwellTheme3 = class {
             try {
               configValue = import_json56.default.parse(config.file_data);
             } catch (err) {
-              console.error(`Error parsing ${configName} config: ${err}`);
+              logger.error(`Error parsing config`, err, { configName });
               configValue = {};
             }
             acc[configName] = configValue;
@@ -19391,7 +19540,7 @@ var SwellTheme3 = class {
           templateConfig?.file_data || "{}"
         );
       } catch (err) {
-        console.warn(err);
+        logger.warn(err);
       }
       if (pageSchema?.page) {
         const {
@@ -19591,7 +19740,7 @@ var SwellTheme3 = class {
       return languageConfig;
     }
     const localeShortCode = locale.split("-")[0];
-    return (0, import_lodash_es10.reduce)(
+    return (0, import_lodash_es11.reduce)(
       languageConfig,
       (acc, value, key) => {
         if (isObject2(value)) {
@@ -19615,15 +19764,15 @@ var SwellTheme3 = class {
             const translationEnd = translationParts.pop();
             const translationPath = translationParts.join(".");
             const translationConfigGlobal = this.globals.language;
-            acc[key] = (0, import_lodash_es10.get)(
+            acc[key] = (0, import_lodash_es11.get)(
               translationConfigGlobal,
               `${translationPath}.$locale.${locale}.${translationEnd}`
-            ) || (0, import_lodash_es10.get)(
+            ) || (0, import_lodash_es11.get)(
               translationConfigGlobal,
               `${translationPath}.$locale.${localeShortCode}.${translationEnd}`
-            ) || (0, import_lodash_es10.get)(translationConfigGlobal, translationKey) || value;
+            ) || (0, import_lodash_es11.get)(translationConfigGlobal, translationKey) || value;
           } else {
-            acc[key] = (0, import_lodash_es10.get)(languageConfig, `$locale.${locale}.${key}`) || (0, import_lodash_es10.get)(languageConfig, `$locale.${localeShortCode}.${key}`) || value;
+            acc[key] = (0, import_lodash_es11.get)(languageConfig, `$locale.${locale}.${key}`) || (0, import_lodash_es11.get)(languageConfig, `$locale.${localeShortCode}.${key}`) || value;
           }
         }
         return acc;
@@ -19696,7 +19845,7 @@ var SwellTheme3 = class {
       try {
         return import_json56.default.parse(localeConfig?.file_data || "{}");
       } catch (err) {
-        console.warn(err);
+        logger.warn(err);
       }
     }
     return {};
@@ -19865,10 +20014,20 @@ var SwellTheme3 = class {
       return "";
     }
     template = unescapeLiquidSyntax(template);
+    const trace = createTraceId();
     try {
-      return await this.liquidSwell.parseAndRender(template, data);
+      logger.debug("[SDK] Render template start", {
+        config: config.name,
+        trace
+      });
+      const result = await this.liquidSwell.parseAndRender(template, data);
+      logger.debug("[SDK] Render template end", {
+        config: config.name,
+        trace
+      });
+      return result;
     } catch (err) {
-      console.error(err);
+      logger.error(err);
       return `<!-- template render error: ${err.message} -->`;
     }
   }
@@ -19876,7 +20035,7 @@ var SwellTheme3 = class {
     try {
       return await this.liquidSwell.parseAndRender(templateString, data);
     } catch (err) {
-      console.error(err);
+      logger.error(err);
       return "";
     }
   }
@@ -19900,7 +20059,7 @@ var SwellTheme3 = class {
           );
         }
       } catch (err) {
-        console.warn(err);
+        logger.warn(err);
         return void 0;
       }
     } else if (config?.file_path?.endsWith(".liquid")) {
@@ -19953,11 +20112,10 @@ var SwellTheme3 = class {
       try {
         return import_json56.default.parse(content);
       } catch (err) {
-        console.log(
-          "Unable to render theme template",
-          config.file_path,
+        logger.error("[SDK] Unable to render theme template", {
+          file: config.file_path,
           content
-        );
+        });
         throw new PageError(err);
       }
     }
@@ -20214,7 +20372,7 @@ ${this.shopifyCompatibility.getContentForHeader()}`;
       try {
         schema = import_json56.default.parse(resolvedConfig?.file_data) || void 0;
       } catch (err) {
-        console.warn(err);
+        logger.warn(err);
       }
     }
     return schema;
@@ -20411,8 +20569,8 @@ ${this.shopifyCompatibility.getContentForHeader()}`;
     const keyParts = key?.split(".") || [];
     const keyName = keyParts.pop() || "";
     const keyPath = keyParts.join(".");
-    const langObject = (0, import_lodash_es10.get)(langConfig, keyPath);
-    let localeValue = (0, import_lodash_es10.get)(langObject?.[localeCode], keyName) || (0, import_lodash_es10.get)(langObject?.[localeCode.split("-")[0]], keyName) || langObject?.[keyName];
+    const langObject = (0, import_lodash_es11.get)(langConfig, keyPath);
+    let localeValue = (0, import_lodash_es11.get)(langObject?.[localeCode], keyName) || (0, import_lodash_es11.get)(langObject?.[localeCode.split("-")[0]], keyName) || langObject?.[keyName];
     if (data?.count !== void 0 && localeValue?.one) {
       localeValue = data.count === 1 ? localeValue.one : localeValue.other;
     }
@@ -20491,7 +20649,7 @@ function fillDefaultThemeSettings(themeSettings, editorSchemaSettings) {
   }
 }
 function resolveThemeSettings(theme, themeSettings, editorSchemaSettings) {
-  const settings = (0, import_lodash_es10.cloneDeep)(themeSettings);
+  const settings = (0, import_lodash_es11.cloneDeep)(themeSettings);
   if (settings.$locale) {
     const { locale } = theme.swell.getStorefrontLocalization();
     const localeConfig = settings.$locale[locale] || {};
@@ -20501,16 +20659,16 @@ function resolveThemeSettings(theme, themeSettings, editorSchemaSettings) {
       }
     }
   }
-  (0, import_lodash_es10.each)(settings, (value, key) => {
+  (0, import_lodash_es11.each)(settings, (value, key) => {
     const setting = (editorSchemaSettings && findEditorSetting(editorSchemaSettings, key)) ?? null;
     if (isObject2(value) && !(value instanceof StorefrontResource)) {
       switch (setting?.type) {
         case "color_scheme_group": {
-          (0, import_lodash_es10.each)(value, (scheme, schemeId) => {
+          (0, import_lodash_es11.each)(value, (scheme, schemeId) => {
             if (isObject2(scheme) && typeof scheme.settings === "object" && scheme.settings) {
               const settings2 = scheme.settings;
-              (0, import_lodash_es10.each)(settings2, (colorValue, colorId) => {
-                const fieldDef = (0, import_lodash_es10.find)(setting.fields, { id: colorId });
+              (0, import_lodash_es11.each)(settings2, (colorValue, colorId) => {
+                const fieldDef = (0, import_lodash_es11.find)(setting.fields, { id: colorId });
                 if (fieldDef?.type === "color" && colorValue) {
                   scheme.id = schemeId;
                   settings2[colorId] = new ThemeColor(colorValue);
@@ -20561,7 +20719,7 @@ function resolveThemeSettings(theme, themeSettings, editorSchemaSettings) {
 }
 function findThemeSettingsByType(type, themeSettings, editorSchemaSettings) {
   const foundSettings = [];
-  (0, import_lodash_es10.each)(themeSettings, (value, key) => {
+  (0, import_lodash_es11.each)(themeSettings, (value, key) => {
     if (isObject2(value) && !(value instanceof ThemeFont) && !(value instanceof StorefrontResource)) {
       foundSettings.push(
         ...findThemeSettingsByType(type, value, editorSchemaSettings)
@@ -20604,7 +20762,7 @@ function parseJsonConfig(config) {
   try {
     return import_json56.default.parse(config?.file_data || "{}");
   } catch (err) {
-    console.warn(err);
+    logger.warn(err);
     return {};
   }
 }
@@ -20692,13 +20850,20 @@ async function resolveMenuItems(theme, menuItems, options) {
 async function resolveMenuItemUrlAndResource(theme, item, options) {
   if (!item) return { url: "#invalid-link-item" };
   if (typeof item === "object" && item !== null) {
-    let { url, resource } = await getMenuItemUrlAndResource(theme, item);
-    const endsWithSlash = url.slice(-1) === "/";
-    if (options?.trailingSlash && !endsWithSlash && url.length > 1) {
-      url = url + "/";
-    }
-    if (!options?.trailingSlash && endsWithSlash && url.length > 1) {
-      url = url.slice(0, -1);
+    const { url: itemUrl, resource } = await getMenuItemUrlAndResource(
+      theme,
+      item
+    );
+    let url = itemUrl;
+    if (url.length > 1) {
+      const endsWithSlash = url.endsWith("/");
+      if (options?.trailingSlash) {
+        if (!endsWithSlash) {
+          url = url + "/";
+        }
+      } else if (endsWithSlash) {
+        url = url.slice(0, -1);
+      }
     }
     return { url, resource };
   } else {
@@ -20723,7 +20888,7 @@ function isChildItemActive(items) {
 }
 function getMenuItemValueId(value) {
   const fallback = typeof value === "string" ? value : "";
-  const slug = (0, import_lodash_es11.get)(value, "id", (0, import_lodash_es11.get)(value, "slug", fallback)) || "";
+  const slug = (0, import_lodash_es12.get)(value, "id", (0, import_lodash_es12.get)(value, "slug", fallback)) || "";
   return slug;
 }
 async function getMenuItemUrlAndResource(theme, menuItem) {
@@ -20740,43 +20905,40 @@ async function getMenuItemUrlAndResource(theme, menuItem) {
       return {
         url: getMenuItemStorefrontUrl(theme, "index")
       };
-    case "category" /* Category */:
+    case "category" /* Category */: {
       if (!id) {
         return {
           url: getMenuItemStorefrontUrl(theme, "categories/index")
         };
       }
-      return await deferMenuItemUrlAndResource(
-        theme,
-        "categories/category",
-        id
-      );
-    case "product" /* Product */:
+      return deferMenuItemUrlAndResource(theme, "categories/category", id);
+    }
+    case "product" /* Product */: {
       if (!id) {
         return {
           url: getMenuItemStorefrontUrl(theme, "products/index")
         };
       }
-      return await deferMenuItemUrlAndResource(theme, "products/product", id);
+      return deferMenuItemUrlAndResource(theme, "products/product", id);
+    }
+    case "product_list" /* ProductList */:
+      return {
+        url: getMenuItemStorefrontUrl(theme, "products/index")
+      };
     case "page" /* Page */:
-      return await deferMenuItemUrlAndResource(theme, "pages/page", id);
+      return deferMenuItemUrlAndResource(theme, "pages/page", id);
     case "blog" /* Blog */:
-      return await deferMenuItemUrlAndResource(
-        theme,
-        "blogs/blog",
-        id,
-        async (blog) => {
-          const blogCategory = new SwellStorefrontRecord(
-            theme.swell,
-            "content/blog-categories",
-            blog.category_id
-          );
-          return blogCategory.slug;
-        }
-      );
+      return deferMenuItemUrlAndResource(theme, "blogs/blog", id, (blog) => {
+        const blogCategory = new SwellStorefrontRecord(
+          theme.swell,
+          "content/blog-categories",
+          blog.category_id
+        );
+        return blogCategory.slug;
+      });
     case "blog_category" /* BlogCategory */:
-      return await deferMenuItemUrlAndResource(theme, "blogs/category", id);
-    case "content_list" /* ContentList */:
+      return deferMenuItemUrlAndResource(theme, "blogs/category", id);
+    case "content_list" /* ContentList */: {
       if (model) {
         const slug = model?.replace("content/", "");
         return {
@@ -20785,10 +20947,11 @@ async function getMenuItemUrlAndResource(theme, menuItem) {
         };
       }
       break;
-    case "content" /* Content */:
+    }
+    case "content" /* Content */: {
       if (model) {
         const collectionSlug = model?.replace("content/", "");
-        return await deferMenuItemUrlAndResource(
+        return deferMenuItemUrlAndResource(
           theme,
           "content/content",
           id,
@@ -20796,6 +20959,7 @@ async function getMenuItemUrlAndResource(theme, menuItem) {
         );
       }
       break;
+    }
     case "search" /* Search */:
       return {
         url: getMenuItemStorefrontUrl(theme, "search")
@@ -21075,6 +21239,7 @@ function getResourceQuery(slug, query) {
   adaptShopifyMenuData,
   arrayToObject,
   cloneStorefrontResource,
+  configureSdkLogger,
   deferMenuItemUrlAndResource,
   dehydrateSwellRefsInStorefrontResources,
   extractSettingsFromForm,