brainerce 1.47.1 → 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();
   }
@@ -4183,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) {
@@ -6419,9 +6423,9 @@ 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, the program's display config, earned milestone `badges`,
@@ -6445,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
@@ -6467,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
@@ -6489,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
@@ -6512,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
@@ -6535,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",
@@ -6542,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
@@ -6561,12 +6599,20 @@ 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"
@@ -6590,13 +6636,22 @@ var BrainerceClient = class {
         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 storefront mode", 400);
+    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
@@ -6615,10 +6670,16 @@ var BrainerceClient = class {
         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 storefront mode", 400);
+    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 /
@@ -6638,6 +6699,12 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        "/loyalty/membership/payment-methods"
+      );
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest(
         "GET",
@@ -6645,7 +6712,7 @@ var BrainerceClient = class {
       );
     }
     throw new BrainerceError(
-      "getMySavedPaymentMethods is only available in storefront mode",
+      "getMySavedPaymentMethods is only available in vibe-coded or storefront mode",
       400
     );
   }
@@ -6672,6 +6739,13 @@ var BrainerceClient = class {
         401
       );
     }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "POST",
+        "/loyalty/membership/subscribe",
+        params
+      );
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest(
         "POST",
@@ -6679,7 +6753,10 @@ var BrainerceClient = class {
         params
       );
     }
-    throw new BrainerceError("subscribeToMembership is only available in storefront mode", 400);
+    throw new BrainerceError(
+      "subscribeToMembership is only available in vibe-coded or storefront mode",
+      400
+    );
   }
   /**
    * Cancel the customer's paid membership (requires customerToken).
@@ -6701,10 +6778,52 @@ var BrainerceClient = class {
         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 storefront mode", 400);
+    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)
@@ -9019,25 +9138,60 @@ function buildArticleJsonLd(post, opts) {
   return result;
 }
 function buildProductJsonLd(product, opts) {
-  const url = absoluteUrl(opts.siteUrl, opts.path ?? (product.slug ? `/products/${product.slug}` : void 0));
+  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 {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.47.1",
+  "version": "1.47.3",
   "description": "Official SDK for building e-commerce storefronts with Brainerce Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",