brainerce 1.41.0 → 1.43.0

package/README.md

@@ -46,6 +46,7 @@ Every Brainerce storefront must include **all mandatory features** below. Featur
 | Forgot / reset password                                 | `client.forgotPassword()`, `client.resetPassword()`                                                           | ✅          |
 | OAuth sign-in buttons + callback handler                | `client.getAvailableOAuthProviders()`                                                                         | ✅          |
 | Account area (profile + order history)                  | `client.getMyProfile()`, `client.getMyOrders()`                                                               | ✅          |
+| Loyalty & rewards (points balance + tiers + redeem)     | `client.getLoyaltyStatus()`, `client.getAvailableRewards()`, `client.redeemLoyaltyReward(id)`, `client.reportSocialShare()` | conditional |
 | Global header: cart count + search autocomplete         | `client.getCart()`, `client.getSearchSuggestions(query)`                                                      | ✅          |
 | Discount banners + product badges                       | `client.getDiscountBanners()`, `client.getProductDiscountBadge(productId)`                                    | ✅          |
 | Product reviews on PDP + JSON-LD aggregateRating        | `client.listProductReviews(id)`, `client.submitProductReview(id, …)`                                          | ✅          |
@@ -376,7 +377,7 @@ await client.addToCart(cart.id, {
 
 Money on the wire is **always strings** (`priceDelta: "5.00"`). Validation failures arrive as a structured 400 envelope on `BrainerceError.details` with `code: 'MODIFIER_VALIDATION_FAILED'` and `errors[]` — see INTEGRATION-RULES.md "Modifier validation errors" for the full code list.
 
-Full rendering guide: [Core Integration §2.9](https://brainerce.com/docs/integration/core). Restaurant features (allergens, scheduled availability, nested combos to depth 3, downsell modifiers): [Optional Features "Restaurant / build-your-own products"](https://brainerce.com/docs/integration/optional).
+Full rendering guide: [Core Integration §2.9](https://brainerce.com/docs/integration/core). Restaurant features (scheduled availability, nested combos to depth 3, downsell modifiers): [Optional Features "Restaurant / build-your-own products"](https://brainerce.com/docs/integration/optional).
 
 ### Content (FAQ / Footer / Header / Announcements / Pages)
 
@@ -2479,6 +2480,25 @@ const intent = await client.createPaymentIntent(checkout.id);
 // }
 ```
 
+**Routing to a specific provider (`providerId`).** With `getPaymentProviders()` you
+render additive **express buttons** (e.g. PayPal as a `WALLET`) alongside the primary
+card form. When the buyer taps one, pass that provider's `id` so the charge routes to
+it instead of the store's default card processor:
+
+```typescript
+const { providers } = await client.getPaymentProviders();
+const paypal = providers.find((p) => p.isAdditive && p.provider === 'paypal');
+
+// Buyer tapped the PayPal express button:
+const intent = await client.createPaymentIntent(checkout.id, {
+  providerId: paypal.id,
+});
+```
+
+Omit `providerId` to settle through the primary card processor (`defaultProvider`).
+The platform scopes it to the store, so only that store's own installed providers are
+selectable.
+
 #### Confirm Payment with Stripe.js
 
 Use the client secret with Stripe.js to collect payment:
@@ -2893,6 +2913,44 @@ const { data: orders, meta } = await client.getMyOrders({
 });
 ```
 
+#### Loyalty & Rewards
+
+Storefront-mode only (requires `storeId` + `customerToken`). Let logged-in
+customers check their points balance, enroll, and redeem rewards for one-time
+coupons that apply at checkout.
+
+```typescript
+// Current status — points balance + program display config + tier progress.
+// `program`/`tier`/`nextTier` are null if the store has no loyalty program
+// (or no tiers configured / the customer hasn't reached one yet).
+const status = await client.getLoyaltyStatus();
+if (status.enrolled) {
+  console.log(`${status.pointsBalance} ${status.program?.pointsName}`);
+  if (status.nextTier) {
+    console.log(`${status.pointsToNextTier} to reach ${status.nextTier.name}`);
+  }
+}
+
+// Enroll (idempotent) — only if the program is ACTIVE. May grant a one-time
+// "join the program" bonus if the store has one configured.
+await client.enrollInLoyalty();
+
+// Rewards the customer can redeem, cheapest first (already filtered to ones
+// their current tier qualifies for).
+const rewards = await client.getAvailableRewards();
+
+// Redeem → spends points, returns a one-time coupon code to apply to the cart.
+// `discountType` tells you how to interpret `discountValue` (currency amount
+// for FIXED_DISCOUNT, 0-100 percent for PERCENT_DISCOUNT).
+const { couponCode, discountType, discountValue, pointsBalance } =
+  await client.redeemLoyaltyReward(rewards[0].id);
+await client.applyCoupon(cartId, couponCode);
+
+// Self-reported social share — grants the SOCIAL_SHARE bonus if configured
+// (once per customer).
+await client.reportSocialShare('instagram');
+```
+
 #### Auth Response Type
 
 ```typescript

package/dist/index.d.mts

@@ -248,6 +248,79 @@ interface CustomerProfile {
     createdAt: string;
     updatedAt: string;
 }
+/** The membership tier a customer currently holds, or is progressing toward. */
+interface LoyaltyTierSummary {
+    id: string;
+    name: string;
+    /** Ordering; higher = better tier. */
+    level: number;
+    /** Points-earning multiplier this tier grants (e.g. 1.5 = 50% more points per order). */
+    pointsMultiplier: number;
+}
+/** The next tier up, including what it takes to qualify. */
+interface LoyaltyNextTierSummary extends LoyaltyTierSummary {
+    qualificationType: 'SPEND' | 'POINTS';
+    /** Threshold in store currency (SPEND) or points (POINTS). */
+    qualificationThreshold: number;
+}
+/** A store's loyalty program status for a logged-in customer. */
+interface LoyaltyStatus {
+    /** Whether the customer has a membership in the program. */
+    enrolled: boolean;
+    /** Redeemable points balance (pending earns excluded). */
+    pointsBalance: number;
+    /** Total points ever earned (confirmed). */
+    lifetimeEarned: number;
+    /** Program display config, or null when the store has no loyalty program. */
+    program: {
+        /** Display name for points (e.g. "points", "coins"). */
+        pointsName: string;
+        /** Points needed to redeem one unit of store currency. */
+        currencyRatio: number;
+        status: 'DRAFT' | 'ACTIVE' | 'PAUSED';
+    } | null;
+    /** The customer's current tier, or null if untiered / no tiers configured. */
+    tier: LoyaltyTierSummary | null;
+    /** The next tier up, or null if already at the top tier (or no tiers configured). */
+    nextTier: LoyaltyNextTierSummary | null;
+    /** 0..1 progress toward nextTier; 1 if no nextTier and a tier is held. */
+    progressToNextTier: number;
+    /** Remaining spend/points needed to reach nextTier, or null if there's no nextTier. */
+    pointsToNextTier: number | null;
+}
+/** A reward a customer can redeem points for. */
+interface LoyaltyReward {
+    id: string;
+    name: string;
+    description: string | null;
+    /** Points required to redeem this reward. */
+    pointsCost: number;
+    /** FIXED_DISCOUNT: discountValue is a store-currency amount off. PERCENT_DISCOUNT: discountValue is a 0-100 percent off. */
+    type: 'FIXED_DISCOUNT' | 'PERCENT_DISCOUNT';
+    discountValue: number;
+    /** Minimum order amount for the coupon to apply, or null. */
+    minOrderAmount: number | null;
+    /** How many times a single customer may redeem this reward. */
+    maxUsesPerUser: number;
+    isActive: boolean;
+    /** Minimum tier level required to redeem this reward, or null for no restriction. */
+    minTierLevel: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Result of redeeming a reward — a one-time coupon plus the new balance. */
+interface RedeemRewardResult {
+    /** The minted one-time coupon code to apply at checkout. */
+    couponCode: string;
+    /** Matches the redeemed reward's `type` — tells you how to interpret discountValue. */
+    discountType: 'FIXED_DISCOUNT' | 'PERCENT_DISCOUNT';
+    /** Currency amount (FIXED_DISCOUNT) or percent 0-100 (PERCENT_DISCOUNT) the coupon is worth. */
+    discountValue: number;
+    /** Points spent on this redemption. */
+    pointsSpent: number;
+    /** The customer's remaining points balance after redemption. */
+    pointsBalance: number;
+}
 interface ProductMetafield {
     id: string;
     definitionId: string;
@@ -476,6 +549,14 @@ interface WriteProductReviewInput {
     rating: number;
     body?: string;
 }
+/**
+ * @deprecated Use `WriteProductReviewInput`. Customers no longer pass author info
+ * directly; it's derived from the authenticated customer profile.
+ */
+interface SubmitProductReviewInput extends WriteProductReviewInput {
+    authorName?: string;
+    authorEmail?: string;
+}
 /**
  * Returned by `client.getMyProductReview(productId)`. Tells the storefront which
  * UI to render: sign-in / not-eligible / submit / edit.
@@ -4850,7 +4931,13 @@ interface CheckoutCustomFieldDefinition {
     key: string;
     name: string;
     description?: string | null;
-    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE';
+    /**
+     * `IMAGE` renders a file-upload control; its value is the uploaded file URL
+     * (validated server-side to be a store-hosted upload). `GALLERY` and
+     * `MULTI_SELECT` are NOT supported for checkout fields — those are
+     * product-metafield-only (`ProductCustomizationField` / `MetafieldType`).
+     */
+    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE' | 'IMAGE';
     required: boolean;
     position: number;
     visibility: CheckoutFieldVisibility;
@@ -8095,6 +8182,16 @@ declare class BrainerceClient {
      * ```
      */
     createPaymentIntent(checkoutId: string, options?: {
+        /**
+         * Route the charge to a specific installed provider — pass the `id` from a
+         * `getPaymentProviders()` entry. This is how you wire an additive express
+         * button (e.g. PayPal as a `WALLET`): when the buyer taps it, call
+         * `createPaymentIntent(checkoutId, { providerId: m.id })`. Omit to settle
+         * through the store's primary card processor (`defaultProvider`). The
+         * platform scopes this to the store, so only that store's own installed
+         * providers are selectable.
+         */
+        providerId?: string;
         successUrl?: string;
         cancelUrl?: string;
         /**
@@ -8545,6 +8642,69 @@ declare class BrainerceClient {
         phone?: string;
         acceptsMarketing?: boolean;
     }): Promise<CustomerProfile>;
+    /**
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * client.setCustomerToken(auth.token);
+     * const status = await client.getLoyaltyStatus();
+     * if (status.enrolled) console.log(`${status.pointsBalance} ${status.program?.pointsName}`);
+     * ```
+     */
+    getLoyaltyStatus(): Promise<LoyaltyStatus>;
+    /**
+     * Enroll the logged-in customer in the store's loyalty program (requires
+     * customerToken). Idempotent — returns the same status shape as
+     * getLoyaltyStatus(). Only available in storefront mode.
+     *
+     * @example
+     * ```typescript
+     * const status = await client.enrollInLoyalty();
+     * ```
+     */
+    enrollInLoyalty(): Promise<LoyaltyStatus>;
+    /**
+     * List the rewards the customer can redeem points for (active rewards, cheapest
+     * first). Requires customerToken. Only available in storefront mode.
+     *
+     * @example
+     * ```typescript
+     * client.setCustomerToken(auth.token);
+     * const rewards = await client.getAvailableRewards();
+     * ```
+     */
+    getAvailableRewards(): Promise<LoyaltyReward[]>;
+    /**
+     * Redeem a reward: spends the customer's points and mints a one-time coupon
+     * that applies at checkout (requires customerToken). Only available in
+     * storefront mode.
+     *
+     * @example
+     * ```typescript
+     * const { couponCode, pointsBalance } = await client.redeemLoyaltyReward('rw_123');
+     * // apply couponCode to the cart at checkout
+     * ```
+     */
+    redeemLoyaltyReward(rewardId: string): Promise<RedeemRewardResult>;
+    /**
+     * Report a social share, granting the SOCIAL_SHARE earning-rule bonus if the
+     * store has one configured (requires customerToken). Self-reported — no
+     * share-tracking infra — and capped at once per customer per program. Only
+     * available in storefront mode.
+     *
+     * @example
+     * ```typescript
+     * await client.reportSocialShare('instagram');
+     * ```
+     */
+    reportSocialShare(platform?: string): Promise<{
+        awarded: boolean;
+        points: number;
+    }>;
     /**
      * Get the current customer's orders (requires customerToken)
      * Works in vibe-coded and storefront modes
@@ -9709,7 +9869,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.41.0";
+declare const SDK_VERSION = "1.42.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -9849,4 +10009,4 @@ declare function formatVariantPrice(variant: Pick<ProductVariant, 'price' | 'sal
 /** Format any numeric amount as currency. Useful for cart totals, fees, etc. */
 declare function formatMoney(amount: number, currency: string, locale?: string): string;
 
-export { type AddToCartDto, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryNode, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, safePaymentRedirect, stripHtml, verifyWebhook };
+export { type AddToCartDto, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryNode, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, safePaymentRedirect, stripHtml, verifyWebhook };

package/dist/index.d.ts

@@ -248,6 +248,79 @@ interface CustomerProfile {
     createdAt: string;
     updatedAt: string;
 }
+/** The membership tier a customer currently holds, or is progressing toward. */
+interface LoyaltyTierSummary {
+    id: string;
+    name: string;
+    /** Ordering; higher = better tier. */
+    level: number;
+    /** Points-earning multiplier this tier grants (e.g. 1.5 = 50% more points per order). */
+    pointsMultiplier: number;
+}
+/** The next tier up, including what it takes to qualify. */
+interface LoyaltyNextTierSummary extends LoyaltyTierSummary {
+    qualificationType: 'SPEND' | 'POINTS';
+    /** Threshold in store currency (SPEND) or points (POINTS). */
+    qualificationThreshold: number;
+}
+/** A store's loyalty program status for a logged-in customer. */
+interface LoyaltyStatus {
+    /** Whether the customer has a membership in the program. */
+    enrolled: boolean;
+    /** Redeemable points balance (pending earns excluded). */
+    pointsBalance: number;
+    /** Total points ever earned (confirmed). */
+    lifetimeEarned: number;
+    /** Program display config, or null when the store has no loyalty program. */
+    program: {
+        /** Display name for points (e.g. "points", "coins"). */
+        pointsName: string;
+        /** Points needed to redeem one unit of store currency. */
+        currencyRatio: number;
+        status: 'DRAFT' | 'ACTIVE' | 'PAUSED';
+    } | null;
+    /** The customer's current tier, or null if untiered / no tiers configured. */
+    tier: LoyaltyTierSummary | null;
+    /** The next tier up, or null if already at the top tier (or no tiers configured). */
+    nextTier: LoyaltyNextTierSummary | null;
+    /** 0..1 progress toward nextTier; 1 if no nextTier and a tier is held. */
+    progressToNextTier: number;
+    /** Remaining spend/points needed to reach nextTier, or null if there's no nextTier. */
+    pointsToNextTier: number | null;
+}
+/** A reward a customer can redeem points for. */
+interface LoyaltyReward {
+    id: string;
+    name: string;
+    description: string | null;
+    /** Points required to redeem this reward. */
+    pointsCost: number;
+    /** FIXED_DISCOUNT: discountValue is a store-currency amount off. PERCENT_DISCOUNT: discountValue is a 0-100 percent off. */
+    type: 'FIXED_DISCOUNT' | 'PERCENT_DISCOUNT';
+    discountValue: number;
+    /** Minimum order amount for the coupon to apply, or null. */
+    minOrderAmount: number | null;
+    /** How many times a single customer may redeem this reward. */
+    maxUsesPerUser: number;
+    isActive: boolean;
+    /** Minimum tier level required to redeem this reward, or null for no restriction. */
+    minTierLevel: number | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Result of redeeming a reward — a one-time coupon plus the new balance. */
+interface RedeemRewardResult {
+    /** The minted one-time coupon code to apply at checkout. */
+    couponCode: string;
+    /** Matches the redeemed reward's `type` — tells you how to interpret discountValue. */
+    discountType: 'FIXED_DISCOUNT' | 'PERCENT_DISCOUNT';
+    /** Currency amount (FIXED_DISCOUNT) or percent 0-100 (PERCENT_DISCOUNT) the coupon is worth. */
+    discountValue: number;
+    /** Points spent on this redemption. */
+    pointsSpent: number;
+    /** The customer's remaining points balance after redemption. */
+    pointsBalance: number;
+}
 interface ProductMetafield {
     id: string;
     definitionId: string;
@@ -476,6 +549,14 @@ interface WriteProductReviewInput {
     rating: number;
     body?: string;
 }
+/**
+ * @deprecated Use `WriteProductReviewInput`. Customers no longer pass author info
+ * directly; it's derived from the authenticated customer profile.
+ */
+interface SubmitProductReviewInput extends WriteProductReviewInput {
+    authorName?: string;
+    authorEmail?: string;
+}
 /**
  * Returned by `client.getMyProductReview(productId)`. Tells the storefront which
  * UI to render: sign-in / not-eligible / submit / edit.
@@ -4850,7 +4931,13 @@ interface CheckoutCustomFieldDefinition {
     key: string;
     name: string;
     description?: string | null;
-    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE';
+    /**
+     * `IMAGE` renders a file-upload control; its value is the uploaded file URL
+     * (validated server-side to be a store-hosted upload). `GALLERY` and
+     * `MULTI_SELECT` are NOT supported for checkout fields — those are
+     * product-metafield-only (`ProductCustomizationField` / `MetafieldType`).
+     */
+    type: 'TEXT' | 'TEXTAREA' | 'NUMBER' | 'BOOLEAN' | 'SELECT' | 'DATE' | 'IMAGE';
     required: boolean;
     position: number;
     visibility: CheckoutFieldVisibility;
@@ -8095,6 +8182,16 @@ declare class BrainerceClient {
      * ```
      */
     createPaymentIntent(checkoutId: string, options?: {
+        /**
+         * Route the charge to a specific installed provider — pass the `id` from a
+         * `getPaymentProviders()` entry. This is how you wire an additive express
+         * button (e.g. PayPal as a `WALLET`): when the buyer taps it, call
+         * `createPaymentIntent(checkoutId, { providerId: m.id })`. Omit to settle
+         * through the store's primary card processor (`defaultProvider`). The
+         * platform scopes this to the store, so only that store's own installed
+         * providers are selectable.
+         */
+        providerId?: string;
         successUrl?: string;
         cancelUrl?: string;
         /**
@@ -8545,6 +8642,69 @@ declare class BrainerceClient {
         phone?: string;
         acceptsMarketing?: boolean;
     }): Promise<CustomerProfile>;
+    /**
+     * 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.
+     *
+     * @example
+     * ```typescript
+     * client.setCustomerToken(auth.token);
+     * const status = await client.getLoyaltyStatus();
+     * if (status.enrolled) console.log(`${status.pointsBalance} ${status.program?.pointsName}`);
+     * ```
+     */
+    getLoyaltyStatus(): Promise<LoyaltyStatus>;
+    /**
+     * Enroll the logged-in customer in the store's loyalty program (requires
+     * customerToken). Idempotent — returns the same status shape as
+     * getLoyaltyStatus(). Only available in storefront mode.
+     *
+     * @example
+     * ```typescript
+     * const status = await client.enrollInLoyalty();
+     * ```
+     */
+    enrollInLoyalty(): Promise<LoyaltyStatus>;
+    /**
+     * List the rewards the customer can redeem points for (active rewards, cheapest
+     * first). Requires customerToken. Only available in storefront mode.
+     *
+     * @example
+     * ```typescript
+     * client.setCustomerToken(auth.token);
+     * const rewards = await client.getAvailableRewards();
+     * ```
+     */
+    getAvailableRewards(): Promise<LoyaltyReward[]>;
+    /**
+     * Redeem a reward: spends the customer's points and mints a one-time coupon
+     * that applies at checkout (requires customerToken). Only available in
+     * storefront mode.
+     *
+     * @example
+     * ```typescript
+     * const { couponCode, pointsBalance } = await client.redeemLoyaltyReward('rw_123');
+     * // apply couponCode to the cart at checkout
+     * ```
+     */
+    redeemLoyaltyReward(rewardId: string): Promise<RedeemRewardResult>;
+    /**
+     * Report a social share, granting the SOCIAL_SHARE earning-rule bonus if the
+     * store has one configured (requires customerToken). Self-reported — no
+     * share-tracking infra — and capped at once per customer per program. Only
+     * available in storefront mode.
+     *
+     * @example
+     * ```typescript
+     * await client.reportSocialShare('instagram');
+     * ```
+     */
+    reportSocialShare(platform?: string): Promise<{
+        awarded: boolean;
+        points: number;
+    }>;
     /**
      * Get the current customer's orders (requires customerToken)
      * Works in vibe-coded and storefront modes
@@ -9709,7 +9869,7 @@ declare class BrainerceError extends Error {
     constructor(message: string, statusCode: number, details?: unknown);
 }
 
-declare const SDK_VERSION = "1.41.0";
+declare const SDK_VERSION = "1.42.0";
 
 /**
  * Verify a webhook signature from Brainerce
@@ -9849,4 +10009,4 @@ declare function formatVariantPrice(variant: Pick<ProductVariant, 'price' | 'sal
 /** Format any numeric amount as currency. Useful for cart totals, fees, etc. */
 declare function formatMoney(amount: number, currency: string, locale?: string): string;
 
-export { type AddToCartDto, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryNode, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, safePaymentRedirect, stripHtml, verifyWebhook };
+export { type AddToCartDto, type AnnouncementContent, type AnnouncementSeverity, type AppliedDiscount, type ApplyCouponDto, type AttachModifierGroupInput, type Attribute, type AttributeOption, type AttributeSource, type BrainerceApiError, BrainerceClient, type BrainerceClientOptions, BrainerceError, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartAppliedDiscount, type CartBundleOffer, type CartBundlesResponse, type CartIncludeOption, type CartIncludeOptions, type CartItem, type CartItemModifierLine, type CartNudge, type CartRecommendationsResponse, type CartStatus, type CartUpgradeSuggestion, type CartUpgradesResponse, type CartWithIncludes, type Category, type CategoryNode, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutBumpsResponse, type CheckoutCustomFieldDefinition, type CheckoutFieldPricing, type CheckoutFieldVisibility, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type ContactFormFieldType, type ContactFormFieldValidation, type ContactFormPublic, type ContactFormPublicField, type ContactFormSummary, type Content, type ContentDataMap, type ContentStatus, type ContentSummary, type ContentType, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateContentInput, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateInquiryInput, type CreateInquiryResponse, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateModifierGroupInput, type CreateModifierInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DiscountBanner, type DiscountRuleType, type DownloadFile, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailTemplatesResponse, type EmailVerificationResponse, type ExtendReservationResponse, type FaqContent, type FaqItem, type FooterColumn, type FooterContent, type FooterLink, type FooterSocialLink, type FormatPriceOptions, type FormatProductPriceOptions, type FreeAllocationPolicy, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type HeaderContent, type HeaderCta, type HeaderLogo, type HeaderNavItem, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type ListModifierGroupsParams, type LocalCart, type LocalCartItem, type LockedVariant, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldType, type Modifier, type ModifierGroup, type ModifierSelection, type ModifierSelectionType, type ModifierValidationCode, type ModifierValidationError, type MyProductReview, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderBump, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type OrderStatusChange, type PageContent, type PageSeo, type PaginatedResponse, type PaymentClientSdk, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PaymentUrlOptions, type PickupLocation, type PlatformCouponCapabilities, type PlatformMetafieldMetadata, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductCustomizationField, type ProductDiscount, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductModifierGroupAttachment, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductReview, type ProductReviewAdmin, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, RTL_LOCALES, type RecommendationVariant, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type RichTextContent, SDK_VERSION, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomFieldsDto, type SetCheckoutCustomerDto, type SetDefinitionProductsDto as SetDefinitionProductsInput, type SetMetafieldPlatformsDto as SetMetafieldPlatformsInput, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingDestinations, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type StoreInvitation, type StoreInvitationDetails, type StoreMember, type StorePermission, type StoreRole, type StoreTeamResponse, type SubmitProductReviewInput, type SupportedLocaleObject, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttachmentInput, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateContentInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateModifierGroupInput, type UpdateModifierInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateStoreMemberDto as UpdateStoreMemberInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type UserStore, type UserStorePermissions, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, type WriteProductReviewInput, createWebhookHandler, deriveSeoDescription, enableDevGuards, formatMoney, formatPrice, formatProductPrice, formatVariantPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, getDirectionForLocale, formatPrice as getPriceDisplay, getProductCustomizationFields, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getProductSwatches, getStockStatus, getVariantOptions, getVariantPrice, isAllowedPaymentUrl, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, safePaymentRedirect, stripHtml, verifyWebhook };

package/dist/index.js

@@ -185,7 +185,7 @@ function isDevGuardsEnabled() {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.41.0";
+var SDK_VERSION = "1.42.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.brainerce.com";
@@ -6315,6 +6315,129 @@ var BrainerceClient = class {
       400
     );
   }
+  // -------------------- 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).
+  /**
+   * 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.
+   *
+   * @example
+   * ```typescript
+   * client.setCustomerToken(auth.token);
+   * const status = await client.getLoyaltyStatus();
+   * if (status.enrolled) console.log(`${status.pointsBalance} ${status.program?.pointsName}`);
+   * ```
+   */
+  async getLoyaltyStatus() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/loyalty/me");
+    }
+    throw new BrainerceError("getLoyaltyStatus is only available in storefront mode", 400);
+  }
+  /**
+   * Enroll the logged-in customer in the store's loyalty program (requires
+   * customerToken). Idempotent — returns the same status shape as
+   * getLoyaltyStatus(). Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const status = await client.enrollInLoyalty();
+   * ```
+   */
+  async enrollInLoyalty() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/loyalty/enroll");
+    }
+    throw new BrainerceError("enrollInLoyalty is only available in storefront mode", 400);
+  }
+  /**
+   * List the rewards the customer can redeem points for (active rewards, cheapest
+   * first). Requires customerToken. Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * client.setCustomerToken(auth.token);
+   * const rewards = await client.getAvailableRewards();
+   * ```
+   */
+  async getAvailableRewards() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/loyalty/rewards/available");
+    }
+    throw new BrainerceError("getAvailableRewards is only available in storefront mode", 400);
+  }
+  /**
+   * Redeem a reward: spends the customer's points and mints a one-time coupon
+   * that applies at checkout (requires customerToken). Only available in
+   * storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const { couponCode, pointsBalance } = await client.redeemLoyaltyReward('rw_123');
+   * // apply couponCode to the cart at checkout
+   * ```
+   */
+  async redeemLoyaltyReward(rewardId) {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/loyalty/redeem", { rewardId });
+    }
+    throw new BrainerceError("redeemLoyaltyReward is only available in storefront mode", 400);
+  }
+  /**
+   * Report a social share, granting the SOCIAL_SHARE earning-rule bonus if the
+   * store has one configured (requires customerToken). Self-reported — no
+   * share-tracking infra — and capped at once per customer per program. Only
+   * available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * await client.reportSocialShare('instagram');
+   * ```
+   */
+  async reportSocialShare(platform) {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "POST",
+        "/loyalty/social-share",
+        platform ? { platform } : {}
+      );
+    }
+    throw new BrainerceError("reportSocialShare is only available in storefront mode", 400);
+  }
   /**
    * Get the current customer's orders (requires customerToken)
    * Works in vibe-coded and storefront modes

package/dist/index.mjs

@@ -115,7 +115,7 @@ function isDevGuardsEnabled() {
 }
 
 // src/version.ts
-var SDK_VERSION = "1.41.0";
+var SDK_VERSION = "1.42.0";
 
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.brainerce.com";
@@ -6245,6 +6245,129 @@ var BrainerceClient = class {
       400
     );
   }
+  // -------------------- 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).
+  /**
+   * 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.
+   *
+   * @example
+   * ```typescript
+   * client.setCustomerToken(auth.token);
+   * const status = await client.getLoyaltyStatus();
+   * if (status.enrolled) console.log(`${status.pointsBalance} ${status.program?.pointsName}`);
+   * ```
+   */
+  async getLoyaltyStatus() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/loyalty/me");
+    }
+    throw new BrainerceError("getLoyaltyStatus is only available in storefront mode", 400);
+  }
+  /**
+   * Enroll the logged-in customer in the store's loyalty program (requires
+   * customerToken). Idempotent — returns the same status shape as
+   * getLoyaltyStatus(). Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const status = await client.enrollInLoyalty();
+   * ```
+   */
+  async enrollInLoyalty() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/loyalty/enroll");
+    }
+    throw new BrainerceError("enrollInLoyalty is only available in storefront mode", 400);
+  }
+  /**
+   * List the rewards the customer can redeem points for (active rewards, cheapest
+   * first). Requires customerToken. Only available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * client.setCustomerToken(auth.token);
+   * const rewards = await client.getAvailableRewards();
+   * ```
+   */
+  async getAvailableRewards() {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/loyalty/rewards/available");
+    }
+    throw new BrainerceError("getAvailableRewards is only available in storefront mode", 400);
+  }
+  /**
+   * Redeem a reward: spends the customer's points and mints a one-time coupon
+   * that applies at checkout (requires customerToken). Only available in
+   * storefront mode.
+   *
+   * @example
+   * ```typescript
+   * const { couponCode, pointsBalance } = await client.redeemLoyaltyReward('rw_123');
+   * // apply couponCode to the cart at checkout
+   * ```
+   */
+  async redeemLoyaltyReward(rewardId) {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("POST", "/loyalty/redeem", { rewardId });
+    }
+    throw new BrainerceError("redeemLoyaltyReward is only available in storefront mode", 400);
+  }
+  /**
+   * Report a social share, granting the SOCIAL_SHARE earning-rule bonus if the
+   * store has one configured (requires customerToken). Self-reported — no
+   * share-tracking infra — and capped at once per customer per program. Only
+   * available in storefront mode.
+   *
+   * @example
+   * ```typescript
+   * await client.reportSocialShare('instagram');
+   * ```
+   */
+  async reportSocialShare(platform) {
+    if (!this.customerToken && !this.proxyMode) {
+      throw new BrainerceError(
+        "Customer token required. Call setCustomerToken() after login.",
+        401
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "POST",
+        "/loyalty/social-share",
+        platform ? { platform } : {}
+      );
+    }
+    throw new BrainerceError("reportSocialShare is only available in storefront mode", 400);
+  }
   /**
    * Get the current customer's orders (requires customerToken)
    * Works in vibe-coded and storefront modes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.41.0",
+  "version": "1.43.0",
   "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",