brainerce 1.46.2 → 1.47.3

package/dist/index.mjs

@@ -585,6 +585,7 @@ var BrainerceClient = class {
     this.proxyMode = options.proxyMode || false;
     this.analyticsBaseUrl = this.resolveAnalyticsBaseUrl(options.analyticsBaseUrl, resolvedBase);
     this.onAuthError = options.onAuthError;
+    this.onCartReset = options.onCartReset;
     this.hydrateSessionCart();
     this.detectRecoverCartFromUrl();
   }
@@ -1244,6 +1245,34 @@ var BrainerceClient = class {
     }
     throw new BrainerceError("getCategories is only available in vibe-coded mode", 400);
   }
+  /**
+   * Get one category by slug — the payload for a storefront category
+   * (collection) landing page: name, description HTML, meta, breadcrumb and
+   * product count. Fetch the products themselves with
+   * `getProducts({ categories: [category.id] })`. Vibe-coded mode only, like
+   * {@link getCategories}.
+   *
+   * @example
+   * ```typescript
+   * const category = await client.getCategoryBySlug('running-shoes').catch(() => null);
+   * if (!category) notFound();
+   * const { data: products } = await client.getProducts({ categories: [category.id] });
+   * ```
+   */
+  async getCategoryBySlug(slug, options) {
+    const headerOverrides = options?.locale ? { "Accept-Language": options.locale } : void 0;
+    const encodedSlug = encodePathSegment(slug);
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        `/categories/slug/${encodedSlug}`,
+        void 0,
+        void 0,
+        headerOverrides
+      );
+    }
+    throw new BrainerceError("getCategoryBySlug is only available in vibe-coded mode", 400);
+  }
   /**
    * Get available brands for filtering products
    * Works in vibe-coded mode
@@ -4155,14 +4184,17 @@ var BrainerceClient = class {
     const migrated = await this.migrateLocalCartToSession();
     if (migrated) return migrated;
     if (this.sessionCartId && this.sessionToken) {
+      const previousCartId = this.sessionCartId;
       try {
         const cart2 = await this.getCart(this.sessionCartId);
         if (cart2.status === "ACTIVE") {
           return cart2;
         }
         this.clearSessionCart();
+        this.onCartReset?.({ previousCartId, reason: "not_active" });
       } catch {
         this.clearSessionCart();
+        this.onCartReset?.({ previousCartId, reason: "not_found" });
       }
     }
     if (this.sessionToken) {
@@ -6391,20 +6423,23 @@ var BrainerceClient = class {
     );
   }
   // -------------------- Loyalty --------------------
-  // Storefront-mode only (storeId + customerToken). The backend exposes loyalty
-  // solely under /api/stores/:storeId/loyalty — there is no vibe-coded route, so
-  // these do NOT branch on isVibeCodedMode() (that would 404 silently).
+  // Available in both storefront mode (storeId + customerToken) and
+  // vibe-coded mode (salesChannelId + customerToken) — Phase 5 added the
+  // /api/vc/:connectionId/loyalty/* routes mirroring /api/stores/:storeId/loyalty.
   /**
    * Get the logged-in customer's loyalty status: enrollment, points balance,
-   * lifetime earned, and the program's display config (requires customerToken).
-   * Only available in storefront mode. `program` is null when the store has no
-   * loyalty program.
+   * lifetime earned, the program's display config, earned milestone `badges`,
+   * and the `paidMembership` subscription state (null for free members).
+   * Requires customerToken. Only available in storefront mode. `program` is
+   * null when the store has no loyalty program.
    *
    * @example
    * ```typescript
    * client.setCustomerToken(auth.token);
    * const status = await client.getLoyaltyStatus();
    * if (status.enrolled) console.log(`${status.pointsBalance} ${status.program?.pointsName}`);
+   * status.badges?.forEach((b) => console.log(`🏅 ${b.name}`));
+   * if (status.paidMembership?.status === 'ACTIVE') showPremiumPerks(status.paidMembership.plan);
    * ```
    */
   async getLoyaltyStatus() {
@@ -6414,10 +6449,16 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/loyalty/me");
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("GET", "/loyalty/me");
     }
-    throw new BrainerceError("getLoyaltyStatus is only available in storefront mode", 400);
+    throw new BrainerceError(
+      "getLoyaltyStatus is only available in vibe-coded or storefront mode",
+      400
+    );
   }
   /**
    * Enroll the logged-in customer in the store's loyalty program (requires
@@ -6436,10 +6477,16 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/loyalty/enroll");
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/loyalty/enroll");
     }
-    throw new BrainerceError("enrollInLoyalty is only available in storefront mode", 400);
+    throw new BrainerceError(
+      "enrollInLoyalty is only available in vibe-coded or storefront mode",
+      400
+    );
   }
   /**
    * List the rewards the customer can redeem points for (active rewards, cheapest
@@ -6458,10 +6505,16 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/loyalty/rewards/available");
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("GET", "/loyalty/rewards/available");
     }
-    throw new BrainerceError("getAvailableRewards is only available in storefront mode", 400);
+    throw new BrainerceError(
+      "getAvailableRewards is only available in vibe-coded or storefront mode",
+      400
+    );
   }
   /**
    * Redeem a reward: spends the customer's points and mints a one-time coupon
@@ -6481,10 +6534,16 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/loyalty/redeem", { rewardId });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/loyalty/redeem", { rewardId });
     }
-    throw new BrainerceError("redeemLoyaltyReward is only available in storefront mode", 400);
+    throw new BrainerceError(
+      "redeemLoyaltyReward is only available in vibe-coded or storefront mode",
+      400
+    );
   }
   /**
    * Report a social share, granting the SOCIAL_SHARE earning-rule bonus if the
@@ -6504,6 +6563,13 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "POST",
+        "/loyalty/social-share",
+        platform ? { platform } : {}
+      );
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest(
         "POST",
@@ -6511,7 +6577,10 @@ var BrainerceClient = class {
         platform ? { platform } : {}
       );
     }
-    throw new BrainerceError("reportSocialShare is only available in storefront mode", 400);
+    throw new BrainerceError(
+      "reportSocialShare is only available in vibe-coded or storefront mode",
+      400
+    );
   }
   /**
    * Public referral-link lookup: who referred the visitor and what welcome
@@ -6530,12 +6599,231 @@ var BrainerceClient = class {
    * ```
    */
   async getReferralInfo(code) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/loyalty/referral-info", void 0, {
+        code
+      });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("GET", "/loyalty/referral-info", void 0, {
         code
       });
     }
-    throw new BrainerceError("getReferralInfo is only available in storefront mode", 400);
+    throw new BrainerceError(
+      "getReferralInfo is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
+  /**
+   * AI-recommended reward for the logged-in customer — "recommended for you"
+   * at the top of the rewards list (requires customerToken). The result is
+   * ALWAYS a real reward from the store's catalog (the AI only ranks; a
+   * hallucinated pick falls back to a deterministic choice). Returns
+   * `{ reward: null }` when the catalog is empty. Rate-limited (5/min per
+   * customer — it spends the merchant's AI credits). Only available in
+   * storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const { reward, reason } = await client.getRecommendedReward();
+   * if (reward) showRecommendation(reward, reason);
+   * ```
+   */
+  async getRecommendedReward() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        "/loyalty/rewards/recommended"
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "GET",
+        "/loyalty/rewards/recommended"
+      );
+    }
+    throw new BrainerceError(
+      "getRecommendedReward is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
+  /**
+   * List the paid membership plans the customer can subscribe to (requires
+   * customerToken). Empty when the store offers none or the program is not
+   * active. Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const plans = await client.getMembershipPlans();
+   * ```
+   */
+  async getMembershipPlans() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/loyalty/membership/plans");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/loyalty/membership/plans");
+    }
+    throw new BrainerceError(
+      "getMembershipPlans is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
+  /**
+   * List the customer's saved payment methods (display fields only — brand /
+   * last4 / expiry, never card data) for the membership subscribe flow.
+   * Requires customerToken. Cards are vaulted by checking out with
+   * `saveCard: true`. Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const methods = await client.getMySavedPaymentMethods();
+   * ```
+   */
+  async getMySavedPaymentMethods() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        "/loyalty/membership/payment-methods"
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "GET",
+        "/loyalty/membership/payment-methods"
+      );
+    }
+    throw new BrainerceError(
+      "getMySavedPaymentMethods is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
+  /**
+   * Subscribe the customer to a paid membership plan — charges the saved card
+   * IMMEDIATELY and starts the recurring cycle (requires customerToken).
+   * Throws a 409 with a `code` ('card_declined' | 'requires_action' | ...)
+   * when the charge fails; 3D-Secure challenges are not supported off-session
+   * and surface as `requires_action`. Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const membership = await client.subscribeToMembership({
+   *   planId: plan.id,
+   *   savedPaymentTokenId: method.id,
+   * });
+   * // membership.status === 'ACTIVE'
+   * ```
+   */
+  async subscribeToMembership(params) {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "POST",
+        "/loyalty/membership/subscribe",
+        params
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "POST",
+        "/loyalty/membership/subscribe",
+        params
+      );
+    }
+    throw new BrainerceError(
+      "subscribeToMembership is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
+  /**
+   * Cancel the customer's paid membership (requires customerToken).
+   * End-of-period semantics: perks continue until `nextBillingAt`, then the
+   * subscription ends without another charge (a PAST_DUE membership cancels
+   * immediately). Re-subscribing to the same plan before period end simply
+   * un-cancels. Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const membership = await client.cancelMembership();
+   * // membership.cancelAtPeriodEnd === true
+   * ```
+   */
+  async cancelMembership() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/loyalty/membership/cancel");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/loyalty/membership/cancel");
+    }
+    throw new BrainerceError(
+      "cancelMembership is only available in vibe-coded or storefront mode",
+      400
+    );
+  }
+  /**
+   * Mint a short-lived session for the embeddable loyalty widget (Phase 5) and
+   * return the ready-to-use iframe URL. Requires customerToken. The returned
+   * `embedUrl` is safe to drop straight into an `<iframe src>` — it carries a
+   * scoped ~15-minute session token, never the real customerToken. Re-call this
+   * before the iframe reloads (e.g. on page navigation) to refresh it.
+   *
+   * @example
+   * ```typescript
+   * const { embedUrl } = await client.getLoyaltyWidgetSession();
+   * // <iframe src={embedUrl} width="360" height="420" />
+   * ```
+   */
+  async getLoyaltyWidgetSession() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    let result;
+    if (this.isVibeCodedMode()) {
+      result = await this.vibeCodedRequest("POST", "/loyalty/widget-session");
+    } else if (this.storeId && !this.apiKey) {
+      result = await this.storefrontRequest("POST", "/loyalty/widget-session");
+    } else {
+      throw new BrainerceError(
+        "getLoyaltyWidgetSession is only available in vibe-coded or storefront mode",
+        400
+      );
+    }
+    return {
+      ...result,
+      embedUrl: `${this.baseUrl}/api/loyalty/embed/${encodePathSegment(result.storeId)}/${encodePathSegment(result.sessionId)}`
+    };
   }
   /**
    * Get the current customer's orders (requires customerToken)
@@ -8822,6 +9110,247 @@ function formatAmount(amount, currency, locale) {
   }
 }
 
+// src/jsonld.ts
+function absoluteUrl(siteUrl, path) {
+  if (!path) return void 0;
+  const base = siteUrl.replace(/\/+$/, "");
+  return path.startsWith("http") ? path : `${base}${path.startsWith("/") ? path : `/${path}`}`;
+}
+function stripHtml(html) {
+  return (html ?? "").replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
+}
+function buildArticleJsonLd(post, opts) {
+  const url = absoluteUrl(opts.siteUrl, opts.path ?? `/blog/${post.slug}`);
+  const result = {
+    "@context": "https://schema.org",
+    "@type": "Article",
+    headline: post.seoTitle ?? post.title,
+    name: post.title,
+    ...post.excerpt || post.seoDescription ? { description: post.seoDescription ?? post.excerpt } : {},
+    ...url ? { url, mainEntityOfPage: { "@type": "WebPage", "@id": url } } : {},
+    ...post.coverImageUrl ? { image: [post.coverImageUrl] } : {},
+    ...post.publishedAt ? { datePublished: post.publishedAt } : {},
+    dateModified: post.updatedAt,
+    ...post.author ? { author: { "@type": "Person", name: post.author } } : opts.organizationName ? { author: { "@type": "Organization", name: opts.organizationName } } : {},
+    ...opts.organizationName ? { publisher: { "@type": "Organization", name: opts.organizationName } } : {},
+    ...post.tags.length > 0 ? { keywords: post.tags.join(", ") } : {}
+  };
+  return result;
+}
+function buildProductJsonLd(product, opts) {
+  const url = absoluteUrl(
+    opts.siteUrl,
+    opts.path ?? (product.slug ? `/products/${product.slug}` : void 0)
+  );
+  const images = (product.images ?? []).map((img) => img.url).filter(Boolean);
+  const brand = opts.brandName ?? product.brands?.[0]?.name;
+  const description = stripHtml(product.description).slice(0, 5e3);
+  const effectivePrice = product.salePrice ?? product.basePrice;
+  const inStock = product.inventory ? (product.inventory.available ?? 0) > 0 : true;
+  const isVariable = product.type === "VARIABLE" && product.priceMin && product.priceMax;
+  const itemCondition = "https://schema.org/NewCondition";
+  const shippingDetails = (opts.shipping ?? []).filter((z) => z.amount !== null).map((z) => ({
+    "@type": "OfferShippingDetails",
+    shippingRate: { "@type": "MonetaryAmount", value: z.amount, currency: opts.currency },
+    shippingDestination: { "@type": "DefinedRegion", addressCountry: z.countries },
+    ...z.handlingTime != null || z.minDeliveryDays != null || z.maxDeliveryDays != null ? {
+      deliveryTime: {
+        "@type": "ShippingDeliveryTime",
+        ...z.handlingTime != null ? {
+          handlingTime: {
+            "@type": "QuantitativeValue",
+            minValue: 0,
+            maxValue: z.handlingTime
+          }
+        } : {},
+        ...z.minDeliveryDays != null || z.maxDeliveryDays != null ? {
+          transitTime: {
+            "@type": "QuantitativeValue",
+            minValue: z.minDeliveryDays ?? z.maxDeliveryDays,
+            maxValue: z.maxDeliveryDays ?? z.minDeliveryDays
+          }
+        } : {}
+      }
+    } : {}
+  }));
+  const offer = isVariable ? {
+    "@type": "AggregateOffer",
+    lowPrice: product.priceMin,
+    highPrice: product.priceMax,
+    priceCurrency: opts.currency,
+    availability: inStock ? "https://schema.org/InStock" : "https://schema.org/OutOfStock",
+    itemCondition,
+    ...shippingDetails.length > 0 ? { shippingDetails } : {},
+    ...url ? { url } : {}
+  } : {
+    "@type": "Offer",
+    price: effectivePrice,
+    priceCurrency: opts.currency,
+    availability: inStock ? "https://schema.org/InStock" : "https://schema.org/OutOfStock",
+    itemCondition,
+    // Only meaningful for an active sale price with a known end date —
+    // a regular (non-sale) price has no expiry to declare.
+    ...product.salePrice && product.salePriceEndsAt ? { priceValidUntil: product.salePriceEndsAt } : {},
+    ...shippingDetails.length > 0 ? { shippingDetails } : {},
+    ...url ? { url } : {}
+  };
+  return {
+    "@context": "https://schema.org",
+    "@type": "Product",
+    name: product.name,
+    ...description ? { description } : {},
+    ...images.length > 0 ? { image: images } : {},
+    ...url ? { url } : {},
+    sku: product.sku,
+    // Identifiers Google uses to match a product to its catalog — key for
+    // free merchant-listing eligibility without a Merchant Center feed.
+    ...product.gtin ? { gtin: product.gtin } : {},
+    ...product.mpn ? { mpn: product.mpn } : {},
+    ...brand ? { brand: { "@type": "Brand", name: brand } } : {},
+    offers: offer,
+    // Google policy: never emit an empty/zero rating block.
+    ...product.reviewCount && product.reviewCount > 0 && product.avgRating ? {
+      aggregateRating: {
+        "@type": "AggregateRating",
+        ratingValue: product.avgRating,
+        reviewCount: product.reviewCount
+      }
+    } : {}
+  };
+}
+function buildOrganizationJsonLd(store, opts) {
+  const sameAs = Object.values(store.socialLinks ?? {}).filter(Boolean);
+  return {
+    "@context": "https://schema.org",
+    "@type": "Organization",
+    name: store.name,
+    url: opts.siteUrl,
+    ...store.logo ? { logo: store.logo } : {},
+    ...store.metaDescription ? { description: store.metaDescription } : {},
+    ...store.contactEmail ? { email: store.contactEmail } : {},
+    ...store.contactPhone ? { telephone: store.contactPhone } : {},
+    ...sameAs.length > 0 ? { sameAs } : {}
+  };
+}
+function buildWebsiteJsonLd(store, opts) {
+  const base = opts.siteUrl.replace(/\/+$/, "");
+  const result = {
+    "@context": "https://schema.org",
+    "@type": "WebSite",
+    name: store.name,
+    url: opts.siteUrl
+  };
+  if (opts.searchUrlTemplate?.includes("{search_term_string}")) {
+    const tmpl = opts.searchUrlTemplate.startsWith("http") ? opts.searchUrlTemplate : `${base}${opts.searchUrlTemplate.startsWith("/") ? "" : "/"}${opts.searchUrlTemplate}`;
+    result.potentialAction = {
+      "@type": "SearchAction",
+      target: { "@type": "EntryPoint", urlTemplate: tmpl },
+      "query-input": "required name=search_term_string"
+    };
+  }
+  return result;
+}
+function buildCollectionPageJsonLd(category, opts) {
+  const url = absoluteUrl(opts.siteUrl, opts.path);
+  const description = category.metaDescription ?? (stripHtml(category.description) || void 0);
+  return {
+    "@context": "https://schema.org",
+    "@type": "CollectionPage",
+    name: category.name,
+    ...description ? { description } : {},
+    ...url ? { url, mainEntityOfPage: { "@type": "WebPage", "@id": url } } : {},
+    ...category.image ? { image: [category.image] } : {}
+  };
+}
+function buildBreadcrumbJsonLd(items) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items.map((item, index) => ({
+      "@type": "ListItem",
+      position: index + 1,
+      name: item.name,
+      item: item.url
+    }))
+  };
+}
+function jsonLdScriptProps(data) {
+  return {
+    type: "application/ld+json",
+    dangerouslySetInnerHTML: { __html: JSON.stringify(data).replace(/</g, "\\u003c") }
+  };
+}
+
+// src/sitemap.ts
+async function getBlogSitemapEntries(client, opts) {
+  const base = opts.siteUrl.replace(/\/+$/, "");
+  const basePath = opts.basePath ?? "/blog";
+  const pageSize = Math.min(opts.pageSize ?? 100, 100);
+  const maxEntries = opts.maxEntries ?? 5e3;
+  const posts = [];
+  let page = 1;
+  for (; ; ) {
+    const res = await client.blog.getPosts({ page, limit: pageSize });
+    posts.push(...res.data.map((p) => ({ slug: p.slug, updatedAt: p.updatedAt })));
+    if (page >= res.meta.totalPages || posts.length >= maxEntries) break;
+    page += 1;
+  }
+  const nonDefaultLocales = opts.locales?.filter((locale) => locale !== opts.defaultLocale) ?? [];
+  const entries = [];
+  entries.push({ url: `${base}${basePath}`, changeFrequency: "daily", priority: 0.7 });
+  for (const locale of nonDefaultLocales) {
+    entries.push({
+      url: `${base}/${locale}${basePath}`,
+      changeFrequency: "daily",
+      priority: 0.7
+    });
+  }
+  for (const post of posts.slice(0, maxEntries)) {
+    const lastModified = new Date(post.updatedAt);
+    entries.push({
+      url: `${base}${basePath}/${post.slug}`,
+      lastModified,
+      changeFrequency: "weekly",
+      priority: 0.6
+    });
+    for (const locale of nonDefaultLocales) {
+      entries.push({
+        url: `${base}/${locale}${basePath}/${post.slug}`,
+        lastModified,
+        changeFrequency: "weekly",
+        priority: 0.5
+      });
+    }
+  }
+  return entries;
+}
+async function getCategorySitemapEntries(client, opts) {
+  const base = opts.siteUrl.replace(/\/+$/, "");
+  const basePath = opts.basePath ?? "/category";
+  const nonDefaultLocales = opts.locales?.filter((l) => l !== opts.defaultLocale) ?? [];
+  const { categories } = await client.getCategories();
+  const slugs = [];
+  const walk = (nodes) => {
+    for (const node of nodes) {
+      if (node.slug) slugs.push(node.slug);
+      if (node.children?.length) walk(node.children);
+    }
+  };
+  walk(categories);
+  const entries = [];
+  for (const slug of slugs) {
+    entries.push({ url: `${base}${basePath}/${slug}`, changeFrequency: "daily", priority: 0.8 });
+    for (const locale of nonDefaultLocales) {
+      entries.push({
+        url: `${base}/${locale}${basePath}/${slug}`,
+        changeFrequency: "daily",
+        priority: 0.7
+      });
+    }
+  }
+  return entries;
+}
+
 // src/types.ts
 function isHtmlDescription(product) {
   if (product?.descriptionFormat === "html") return true;
@@ -8837,7 +9366,7 @@ function getDescriptionContent(product) {
   }
   return { text: product.description };
 }
-function stripHtml(html) {
+function stripHtml2(html) {
   if (!html) return "";
   return html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]+>/g, " ").replace(/&nbsp;/gi, " ").replace(/&amp;/gi, "&").replace(/&lt;/gi, "<").replace(/&gt;/gi, ">").replace(/&quot;/gi, '"').replace(/&#39;/gi, "'").replace(/&#x27;/gi, "'").replace(/&#x2F;/gi, "/").replace(/\s+/g, " ").trim();
 }
@@ -8846,7 +9375,7 @@ function deriveSeoDescription(product, options) {
   const maxLength = options?.maxLength ?? 160;
   const authored = (product.seoDescription ?? product.metaDescription ?? "").trim();
   if (authored) return authored;
-  const plain = stripHtml(product.description);
+  const plain = stripHtml2(product.description);
   if (plain) {
     if (plain.length <= maxLength) return plain;
     const sliceLength = maxLength - 1;
@@ -9067,6 +9596,12 @@ export {
   BrainerceError,
   RTL_LOCALES,
   SDK_VERSION,
+  buildArticleJsonLd,
+  buildBreadcrumbJsonLd,
+  buildCollectionPageJsonLd,
+  buildOrganizationJsonLd,
+  buildProductJsonLd,
+  buildWebsiteJsonLd,
   createWebhookHandler,
   deriveSeoDescription,
   enableDevGuards,
@@ -9074,9 +9609,11 @@ export {
   formatPrice,
   formatProductPrice,
   formatVariantPrice,
+  getBlogSitemapEntries,
   getCartItemImage,
   getCartItemName,
   getCartTotals,
+  getCategorySitemapEntries,
   getDescriptionContent,
   getDirectionForLocale,
   formatPrice as getPriceDisplay,
@@ -9094,8 +9631,9 @@ export {
   isCouponApplicableToProduct,
   isHtmlDescription,
   isWebhookEventType,
+  jsonLdScriptProps,
   parseWebhookEvent,
   safePaymentRedirect,
-  stripHtml,
+  stripHtml2 as stripHtml,
   verifyWebhook
 };