@wix/himalaya-cli 0.1631.0 → 0.1633.0

package/templates/branded-lite/tier5-src/himi-branded-lite-loyalty-rewards/index.ts

@@ -0,0 +1,208 @@
+// Member rewards use their own service, so a public offering can never hydrate a
+// balance or coupon. All private state is online-only, and every completion checks
+// the principal and business. Navigation parameters provide an ID, never a price.
+import { defineService, navigate } from "@himalaya/state";
+import { getLoyaltyProgram, listLoyaltyRewards, getCurrentMemberLoyaltyAccount, listMyLoyaltyCoupons, listMyReferralRewards, redeemMyLoyaltyReward,
+  type WixLoyaltyReward, type WixLoyaltyAccount, type WixLoyaltyCoupon, type WixLoyaltyProgram, type WixReferralReward } from "@himalaya/wix-loyalty";
+import { memberAccess, assertMemberAccess, type MemberAccess } from "../_shared/member-access.js";
+import { withOnlineWrites } from "../_shared/online-actions.js";
+import { copyParam, copyTemplate, stashCopy } from "../_shared/himi-copy.js";
+import { offeringRewardLabel, memberRewardCost, pointLabel } from "../_shared/loyalty-offerings.js";
+
+interface MemberRow { id: string; name: string; subtitle: string; eligibility: string; code: string; isCoupon: boolean; notCoupon: boolean; section: string }
+interface S {
+  hideLoading: boolean; hideContent: boolean; hideSignIn: boolean; hideError: boolean; error: string;
+  points: string; items: MemberRow[]; emptyText: string;
+  confirming: boolean; confirmation: string; selectedId: string; writeBusy: boolean; message: string;
+  referralError: string; resultCode: string; resultName: string;
+}
+const INITIAL: S = { hideLoading: false, hideContent: true, hideSignIn: true, hideError: true, error: "", points: "", items: [], emptyText: "",
+  referralError: "", confirming: false, confirmation: "", selectedId: "", writeBusy: false, message: "", resultCode: "", resultName: "" };
+const PRIVATE_KEYS = Object.keys(INITIAL) as (keyof S)[];
+const input = () => (globalThis as { himalaya?: { input?: Record<string, unknown>; readLifecycleVersion?: number } }).himalaya;
+const business = () => input()?.input?.__himiPreferenceBusiness;
+const object = (arg: unknown): Record<string, unknown> => arg && typeof arg === "object" ? arg as Record<string, unknown> : {};
+let generation = 0, writing = false, reviewing = false;
+let currency = "", restaurantScreen = "";
+let context: { member: MemberAccess; business: unknown; program: WixLoyaltyProgram; account: WixLoyaltyAccount; rewards: WixLoyaltyReward[]; coupons: WixLoyaltyCoupon[]; referrals: WixReferralReward[]; referralKnown: boolean } | undefined;
+let confirmation: { id: string; member: MemberAccess; business: unknown; cost: number } | undefined;
+let result: { generation: number; message: string; coupon?: WixLoyaltyCoupon } | undefined;
+// One confirmed write may await two independently replicated reads. Keep its
+// coupon and stop further spending until both reads reflect the transaction.
+let confirmed: { coupon: WixLoyaltyCoupon; balanceAfter?: number; redeemedAfter?: number } | undefined;
+const pointAmount = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value) && value >= 0;
+// An ambiguous write cannot be retried by another tap or refresh in this session.
+const uncertain = new Set<string>();
+const MAX_UNCERTAIN_REWARDS = 64;
+let uncertaintyOverflow = false;
+const blocked = (id: string) => !!confirmed || uncertaintyOverflow || uncertain.has(id);
+let uncertainPrincipal = "";
+const stamp = (member: MemberAccess) => JSON.stringify([member.email, member.scope, business()]);
+const couponReward = (reward: WixLoyaltyReward) => reward.type === "COUPON_REWARD" || reward.type === "COUPON";
+// These responses confirm the write was rejected. Timeouts (including HTTP 408),
+// 5xx and unclassified errors leave its outcome uncertain and must stay blocked.
+function definitiveRejection(error: unknown): boolean {
+  const status = /\bHTTP\s+(\d{3})\b/.exec(String(error))?.[1];
+  return !!status && ["400", "401", "403", "404", "409", "412", "422", "428", "429"].includes(status);
+}
+const guard = async (c: NonNullable<typeof context>) => {
+  await assertMemberAccess(c.member);
+  if (context !== c || business() !== c.business) throw new Error("Member access changed");
+};
+const signInState = (): S => ({ ...INITIAL, hideLoading: true, hideSignIn: false });
+function reconcile(c: NonNullable<typeof context>) {
+  if (!confirmed) return;
+  const points = c.account.points;
+  const debited = (confirmed.balanceAfter !== undefined && pointAmount(points?.balance) && points.balance <= confirmed.balanceAfter)
+    || (confirmed.redeemedAfter !== undefined && pointAmount(points?.redeemed) && points.redeemed >= confirmed.redeemedAfter);
+  if (debited && c.coupons.some(coupon => coupon.id === confirmed!.coupon.id)) confirmed = undefined;
+}
+function rows(c: NonNullable<typeof context>): Pick<S, "items" | "points" | "emptyText" | "referralError"> {
+  const unit = c.program.pointDefinition?.customName ?? "";
+  const balance = c.account.points?.balance;
+  const ordered = c.rewards.filter(r => r.active === true && !!r.id).map((reward, index) => {
+    const cost = memberRewardCost(reward, c.account.tier?.id);
+    return { reward, index, available: couponReward(reward) && !blocked(reward.id) && cost !== undefined && typeof balance === "number" && Number.isFinite(balance) && balance >= cost ? 1 : 0 };
+  }).sort((a, b) => b.available - a.available || a.index - b.index);
+  const rewards = ordered.map(({ reward }, index) => {
+    const cost = memberRewardCost(reward, c.account.tier?.id);
+    const eligibility = confirmed ? copyParam("loyalty.redeemedRefreshFailed", "Reward redeemed. Your balance couldn't be refreshed; refresh before redeeming again.")
+      : blocked(reward.id) ? copyParam("loyalty.redemptionUncertain", "Check your coupons: this redemption could not be confirmed.")
+      : reward.type === "DISCOUNT_AMOUNT" ? copyParam("loyalty.orderToRedeem", "Use this reward when placing an order.")
+      : !couponReward(reward) ? copyParam("loyalty.checkoutReward", "Use this reward at checkout.")
+      : cost === undefined ? copyParam("loyalty.notOnTier", "This reward is not available on your tier.")
+      : typeof balance !== "number" || !Number.isFinite(balance) ? copyParam("loyalty.pointsUnavailable", "Your points aren't available yet.")
+      : balance < cost ? copyTemplate("loyalty.pointsNeeded", "{points} more needed", { points: pointLabel(cost - balance, unit) })
+      : copyParam("loyalty.readyToRedeem", "Available to redeem");
+    return { id: reward.id, code: "", isCoupon: false, notCoupon: true, section: index === 0 ? copyParam("loyalty.rewardsHeading", "Rewards") : "", name: reward.name || copyParam("loyalty.rewardFallback", "Reward"), subtitle: offeringRewardLabel(reward, c.account.tier?.id, unit, currency), eligibility };
+  });
+  const knownCoupons = confirmed && !c.coupons.some(coupon => coupon.id === confirmed!.coupon.id) ? [...c.coupons, confirmed.coupon] : c.coupons;
+  const coupons = knownCoupons.filter(c => c.status === "ACTIVE" && !c.couponReference?.deleted && !!c.id && !!c.couponReference?.code)
+    .map(c => ({ id: c.id!, name: c.rewardName || copyParam("loyalty.rewardFallback", "Reward"), code: c.couponReference!.code! }));
+  const referralCoupons = c.referrals.filter(r => r.rewardType === "COUPON" && r.coupon?.status === "ACTIVE" && !!r.id && !!r.coupon.code)
+    .map(r => ({ id: `referral:${r.id}`, name: r.coupon!.couponSpecification?.name || copyParam("loyalty.referralReward", "Referral reward"), code: r.coupon!.code! }));
+  const allCoupons = [...coupons, ...referralCoupons];
+  const items: MemberRow[] = [...allCoupons.map((coupon, index) => ({ ...coupon, id: `coupon:${coupon.id}`, isCoupon: true, notCoupon: false, subtitle: "", eligibility: "", section: index === 0 ? copyParam("loyalty.claimedRewards", "Your coupons") : "" })), ...rewards];
+  return { items, referralError: c.referralKnown ? "" : copyParam("loyalty.referralsError", "Referral rewards couldn't be verified. Refresh to try again."), points: !confirmed && typeof balance === "number" && Number.isFinite(balance) ? pointLabel(balance, unit) : "",
+    emptyText: rewards.length || allCoupons.length ? "" : copyParam("loyalty.emptyText", "No rewards to redeem yet.") };
+}
+
+async function redeem(c: NonNullable<typeof context>, selected: NonNullable<typeof confirmation>, version: number) {
+  let coupon: WixLoyaltyCoupon | undefined;
+  let message = "";
+  try {
+    await guard(c);
+    const before = c.account.points;
+    // The server validates current member, active reward, tier and cost atomically.
+    const response = await redeemMyLoyaltyReward(selected.id);
+    await guard(c);
+    coupon = response.coupon;
+    if (!coupon?.id || !coupon.couponReference?.code) throw new Error("Redemption was not confirmed");
+    confirmed = { coupon, balanceAfter: pointAmount(before?.balance) ? Math.max(0, before.balance - selected.cost) : undefined,
+      redeemedAfter: pointAmount(before?.redeemed) ? before.redeemed + selected.cost : undefined };
+    message = copyParam("loyalty.redeemed", "Reward redeemed. Use this coupon at checkout.");
+    const [account, coupons] = await Promise.allSettled([getCurrentMemberLoyaltyAccount(), listMyLoyaltyCoupons()]);
+    await guard(c);
+    // A failed follow-up read cannot erase the successful coupon or retain a stale spendable balance.
+    c.account = account.status === "fulfilled" ? account.value.account ?? {} : {};
+    c.coupons = coupons.status === "fulfilled" ? coupons.value.loyaltyCoupons ?? [] : [];
+    reconcile(c);
+    if (confirmed || account.status === "rejected" || coupons.status === "rejected") message = copyParam("loyalty.redeemedRefreshFailed", "Reward redeemed. Your balance couldn't be refreshed; refresh before redeeming again.");
+  } catch (error) {
+    if (definitiveRejection(error)) {
+      c.account = {}; // The eligibility snapshot may have changed since confirmation.
+      message = copyParam("loyalty.cannotRedeem", "This reward can't be redeemed with your current points and tier.");
+    } else {
+      if (uncertain.size < MAX_UNCERTAIN_REWARDS) uncertain.add(selected.id);
+      else uncertaintyOverflow = true; // Fail closed instead of evicting an ambiguous operation.
+      message = copyParam("loyalty.redemptionFailed", "Couldn't confirm redemption. Check your coupons and balance before redeeming again. This action won't be retried automatically.");
+    }
+  } finally { writing = false; }
+  if (version !== generation || context !== c) { await svc.load(); return; }
+  try { await guard(c); result = { generation: version, message, coupon }; await svc.finishRedemption(); }
+  catch { await svc.load(); }
+}
+
+const register = withOnlineWrites(defineService, ["confirmRedemption"], { messageFields: ["message"] });
+const svc = register<S, {
+  prepare: (s: S) => S; load: (s: S, arg?: unknown) => Promise<S | undefined>;
+  reviewReward: (s: S, arg?: unknown) => Promise<S>; cancelRedemption: (s: S) => S;
+  confirmRedemption: (s: S) => S; finishRedemption: (s: S) => S;
+}>("himiBrandedLoyaltyRewards", {
+  state: INITIAL, notHydrated: PRIVATE_KEYS, notPersisted: PRIVATE_KEYS, perVisit: PRIVATE_KEYS,
+  actions: {
+    prepare: () => { generation++; context = undefined; confirmation = undefined; result = undefined; return { ...INITIAL }; },
+    load: async (s, arg) => {
+      stashCopy(arg);
+      if (writing) return s;
+      const version = ++generation; context = undefined; confirmation = undefined; result = undefined;
+      const args = object(arg);
+      if ("currency" in args) currency = typeof args.currency === "string" && /^[A-Z]{3}$/.test(args.currency) ? args.currency : "";
+      if ("restaurantScreen" in args) restaurantScreen = args.restaurantScreen === "himi_menu" ? "himi_menu" : "";
+      const site = business(), member = await memberAccess();
+      if (!member.email) return signInState();
+      if (!member.scope || (input()?.readLifecycleVersion ?? 0) < 1) return { ...INITIAL, hideLoading: true, hideError: false, error: copyParam("loyalty.updateApp", "Update the app to see your points securely.") };
+      if (uncertainPrincipal !== stamp(member)) { uncertain.clear(); uncertaintyOverflow = false; confirmed = undefined; uncertainPrincipal = stamp(member); }
+      try {
+        const [program, rewards, account, coupons, referrals] = await Promise.all([getLoyaltyProgram(), listLoyaltyRewards(), getCurrentMemberLoyaltyAccount(), listMyLoyaltyCoupons(),
+          listMyReferralRewards().then(value => ({ value, failed: false }), () => ({ value: undefined, failed: true }))]);
+        await assertMemberAccess(member);
+        if (business() !== site || version !== generation) return undefined;
+        const p = program.loyaltyProgram ?? program.program;
+        if (!p || p.status !== "ACTIVE" || p.premiumFeatures?.loyaltyProgram === false) throw new Error("Program unavailable");
+        if ((rewards.rewards !== undefined && !Array.isArray(rewards.rewards)) || (coupons.loyaltyCoupons !== undefined && !Array.isArray(coupons.loyaltyCoupons))) throw new Error("Incomplete member rewards response");
+        context = { member, business: site, program: p, account: account.account ?? {}, rewards: rewards.rewards ?? [], coupons: coupons.loyaltyCoupons ?? [], referrals: referrals.value?.referralRewards ?? [], referralKnown: !referrals.failed };
+        reconcile(context);
+        return { ...INITIAL, hideLoading: true, hideContent: false, ...rows(context) };
+      } catch {
+        if (version !== generation || business() !== site) return undefined;
+        const current = await memberAccess();
+        if (!current.email || stamp(current) !== stamp(member)) return signInState();
+        return { ...INITIAL, hideLoading: true, hideError: false, error: copyParam("loyalty.memberRewardsError", "Your rewards couldn't be loaded. Try again.") };
+      }
+    },
+    reviewReward: async (s, arg) => {
+      const c = context, id = object(arg).id;
+      if (!c || typeof id !== "string" || writing || reviewing || blocked(id)) return s;
+      const reward = c.rewards.find(r => r.id === id && r.active === true);
+      if (!reward) return s;
+      reviewing = true;
+      try {
+        await guard(c);
+        if (reward.type === "DISCOUNT_AMOUNT" && restaurantScreen) return navigate(s, { screenId: restaurantScreen });
+        if (!couponReward(reward)) return { ...s, message: copyParam("loyalty.checkoutReward", "Use this reward at checkout.") };
+        const [freshRewards, freshAccount] = await Promise.all([listLoyaltyRewards(), getCurrentMemberLoyaltyAccount()]);
+        await guard(c);
+        const fresh = freshRewards.rewards?.find(r => r.id === id && r.active === true);
+        if (!fresh || !freshAccount.account) throw new Error("Reward unavailable");
+        c.rewards = freshRewards.rewards!; c.account = freshAccount.account;
+        const cost = memberRewardCost(fresh, c.account.tier?.id), balance = c.account.points?.balance;
+        if (cost === undefined || typeof balance !== "number" || !Number.isFinite(balance) || balance < cost) return { ...s, ...rows(c), message: copyParam("loyalty.cannotRedeem", "This reward can't be redeemed with your current points and tier.") };
+        confirmation = { id, member: c.member, business: c.business, cost };
+        return { ...s, ...rows(c), selectedId: id, confirming: true, message: "", confirmation: copyTemplate("loyalty.confirmReward", "Redeem {name} for {points}?", { name: fresh.name || copyParam("loyalty.rewardFallback", "Reward"), points: pointLabel(cost, c.program.pointDefinition?.customName ?? "") }) };
+      } catch {
+        confirmation = undefined;
+        const current = await memberAccess();
+        if (context !== c || business() !== c.business || stamp(current) !== stamp(c.member)) return signInState();
+        return { ...s, confirming: false, message: copyParam("loyalty.cannotRedeem", "This reward can't be redeemed with your current points and tier.") }; }
+      finally { reviewing = false; }
+    },
+    cancelRedemption: s => { if (writing) return s; confirmation = undefined; return { ...s, confirming: false, selectedId: "", confirmation: "" }; },
+    confirmRedemption: s => {
+      const c = context, selected = confirmation;
+      if (!c || !selected || !s.confirming || writing || blocked(selected.id) || selected.business !== business() || selected.member !== c.member) return s;
+      writing = true; confirmation = undefined;
+      void redeem(c, selected, generation);
+      return { ...s, writeBusy: true, message: copyParam("loyalty.redeeming", "Redeeming…") };
+    },
+    finishRedemption: s => {
+      if (!result || result.generation !== generation || !context) return s;
+      const done = result; result = undefined;
+      return { ...s, hideLoading: true, hideContent: false, hideSignIn: true, hideError: true, ...rows(context), confirming: false, selectedId: "", confirmation: "", writeBusy: false, message: done.message,
+        resultCode: done.coupon?.couponReference?.code ?? "", resultName: done.coupon?.rewardName ?? "" };
+    },
+  },
+});
+svc.prepare();
+svc.load();
+export { svc };

package/templates/branded-lite/tier5-src/himi-store-product/index.ts

@@ -439,7 +439,7 @@ function derive(s: S): S {
 let cartBadgeEpoch = 0;
 
 // A digital product with no options sells through the App Store once the platform sells Wix Stores
-// items there (`storesAppleSalesEnabled`), through StartItemPayment or the app's own eCom order.
+// items there (`storesAppleSalesEnabled`): wix-iap StartItemPayment places and charges its order.
 // Until then, and for any other product, an App Store route only blocks the regular checkout.
 const SELLS_THROUGH_APPLE = storesAppleSalesEnabled();
 const WIX_STORES_APP = "215238eb-22a5-4c36-9e7b-e7c08025e04e";

package/templates/gym-fitness/tier5-src/himi-store-product/index.ts

@@ -467,7 +467,7 @@ function derive(s: S): S {
 let cartBadgeEpoch = 0;
 
 // A digital product with no options sells through the App Store once the platform sells Wix Stores
-// items there (`storesAppleSalesEnabled`), through StartItemPayment or the app's own eCom order.
+// items there (`storesAppleSalesEnabled`): wix-iap StartItemPayment places and charges its order.
 // Until then, and for any other product, an App Store route only blocks the regular checkout.
 const SELLS_THROUGH_APPLE = storesAppleSalesEnabled();
 const WIX_STORES_APP = "215238eb-22a5-4c36-9e7b-e7c08025e04e";

package/templates/portfolio-creative/tier5-src/himi-store-product/index.ts

@@ -467,7 +467,7 @@ function derive(s: S): S {
 let cartBadgeEpoch = 0;
 
 // A digital product with no options sells through the App Store once the platform sells Wix Stores
-// items there (`storesAppleSalesEnabled`), through StartItemPayment or the app's own eCom order.
+// items there (`storesAppleSalesEnabled`): wix-iap StartItemPayment places and charges its order.
 // Until then, and for any other product, an App Store route only blocks the regular checkout.
 const SELLS_THROUGH_APPLE = storesAppleSalesEnabled();
 const WIX_STORES_APP = "215238eb-22a5-4c36-9e7b-e7c08025e04e";

package/templates/retail-store/tier5-src/himi-store-product/index.ts

@@ -439,7 +439,7 @@ function derive(s: S): S {
 let cartBadgeEpoch = 0;
 
 // A digital product with no options sells through the App Store once the platform sells Wix Stores
-// items there (`storesAppleSalesEnabled`), through StartItemPayment or the app's own eCom order.
+// items there (`storesAppleSalesEnabled`): wix-iap StartItemPayment places and charges its order.
 // Until then, and for any other product, an App Store route only blocks the regular checkout.
 const SELLS_THROUGH_APPLE = storesAppleSalesEnabled();
 const WIX_STORES_APP = "215238eb-22a5-4c36-9e7b-e7c08025e04e";