brainerce 1.2.0 → 1.3.0

package/dist/index.d.mts

@@ -1784,6 +1784,53 @@ interface ShippingRate {
     /** Service level (e.g., "ground", "express") - only for carrier rates */
     service?: string;
 }
+/**
+ * Pickup location details for local pickup orders.
+ */
+interface PickupLocation {
+    /** Rate ID for this pickup location (use for selectPickupLocation) */
+    id: string;
+    /** Pickup location name (e.g., "Main Store", "Tel Aviv Warehouse") */
+    name: string;
+    /** Shipping rate name */
+    rateName: string;
+    /** Location address */
+    address: {
+        line1: string;
+        line2?: string;
+        city: string;
+        region?: string;
+        postalCode: string;
+        country: string;
+    };
+    /** Contact phone */
+    phone?: string;
+    /** Business hours (e.g., "Sun-Thu 9:00-17:00") */
+    hours?: string;
+    /** Pickup instructions (e.g., "Enter through side door") */
+    instructions?: string;
+    /** Pickup fee as string (e.g., "0", "2.99") */
+    price: string;
+    /** Currency code */
+    currency: string;
+}
+/**
+ * Data required to select a pickup location during checkout.
+ */
+interface SelectPickupLocationDto {
+    /** The pickup rate ID (from getPickupLocations) */
+    pickupRateId: string;
+    /** Customer email (required) */
+    email: string;
+    /** Customer first name */
+    firstName?: string;
+    /** Customer last name */
+    lastName?: string;
+    /** Customer phone */
+    phone?: string;
+    /** Marketing consent */
+    acceptsMarketing?: boolean;
+}
 /**
  * Represents a checkout session for completing a purchase.
  *
@@ -1841,6 +1888,10 @@ interface Checkout {
     email?: string | null;
     /** Customer ID if linked to a customer account */
     customerId?: string | null;
+    /** Delivery method: "shipping" (default) or "pickup" */
+    deliveryType?: 'shipping' | 'pickup';
+    /** Pickup location details (when deliveryType is "pickup") */
+    pickupLocation?: PickupLocation | null;
     /** Shipping address (required before selecting shipping) */
     shippingAddress?: CheckoutAddress | null;
     /** Billing address (optional, defaults to shipping) */
@@ -2336,9 +2387,9 @@ type PaymentProvider = PaymentProviderConfig;
  *
  * const growProvider = providers.find(p => p.provider === 'grow');
  * if (growProvider) {
- *   // Grow uses iframe — no client-side SDK needed
- *   // createPaymentIntent() returns a payment URL as clientSecret
- *   // Show it in an iframe: <iframe src={paymentIntent.clientSecret} />
+ *   // Grow uses SDK wallet — load https://cdn.meshulam.co.il/sdk/gs.min.js
+ *   // createPaymentIntent() returns an authCode as clientSecret
+ *   // Call growPayment.init({...}) then growPayment.renderPaymentOptions(authCode)
  * }
  * ```
  */
@@ -2372,7 +2423,7 @@ interface PaymentConfig {
 interface PaymentIntent {
     /** Payment intent ID */
     id: string;
-    /** Client secret for completing payment on frontend. For Stripe: client secret (pi_xxx_secret_xxx). For Grow: payment page URL. */
+    /** Client secret for completing payment on frontend. For Stripe: client secret (pi_xxx_secret_xxx). For Grow: authCode for SDK wallet rendering. */
     clientSecret: string;
     /** Amount in display format (e.g., "99.99") */
     amount: string;
@@ -4906,6 +4957,45 @@ declare class BrainerceClient {
      * ```
      */
     selectShippingMethod(checkoutId: string, shippingRateId: string): Promise<Checkout>;
+    /**
+     * Get available pickup locations for a store.
+     * Returns empty array if no pickup locations are configured.
+     *
+     * @example
+     * ```typescript
+     * const locations = await client.getPickupLocations();
+     * if (locations.length > 0) {
+     *   // Show pickup option in checkout
+     * }
+     * ```
+     */
+    getPickupLocations(): Promise<PickupLocation[]>;
+    /**
+     * Set delivery type on checkout (shipping or pickup).
+     *
+     * @example
+     * ```typescript
+     * const checkout = await client.setDeliveryType('checkout_123', 'pickup');
+     * ```
+     */
+    setDeliveryType(checkoutId: string, deliveryType: 'shipping' | 'pickup'): Promise<Checkout>;
+    /**
+     * Select a pickup location for checkout.
+     * This sets the delivery type to "pickup", records customer info, and prepares for payment.
+     * Equivalent to setShippingAddress + selectShippingMethod for delivery orders.
+     *
+     * @example
+     * ```typescript
+     * const checkout = await client.selectPickupLocation('checkout_123', {
+     *   pickupRateId: 'rate_main_store',
+     *   email: 'customer@example.com',
+     *   firstName: 'John',
+     *   lastName: 'Doe',
+     * });
+     * // Now proceed to payment
+     * ```
+     */
+    selectPickupLocation(checkoutId: string, data: SelectPickupLocationDto): Promise<Checkout>;
     /**
      * Set billing address on checkout
      * Can optionally use shipping address as billing address
@@ -5073,6 +5163,19 @@ declare class BrainerceClient {
      * ```
      */
     getPaymentStatus(checkoutId: string): Promise<PaymentStatus>;
+    /**
+     * Confirm a Grow SDK payment from the frontend.
+     * Call this in the Grow SDK `onSuccess` callback to notify the backend
+     * that payment succeeded, triggering order creation.
+     *
+     * **Vibe-coded mode only** - requires connectionId
+     *
+     * @param checkoutId - The checkout ID
+     * @param confirmationNumber - Optional confirmation number from Grow onSuccess
+     */
+    confirmGrowPayment(checkoutId: string, confirmationNumber?: string): Promise<{
+        confirmed: boolean;
+    }>;
     /**
      * Wait for order creation after payment.
      *
@@ -6314,4 +6417,4 @@ declare function enableDevGuards(options?: {
     force?: boolean;
 }): void;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomerDto, 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 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 UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomerDto, 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 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 UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts

@@ -1784,6 +1784,53 @@ interface ShippingRate {
     /** Service level (e.g., "ground", "express") - only for carrier rates */
     service?: string;
 }
+/**
+ * Pickup location details for local pickup orders.
+ */
+interface PickupLocation {
+    /** Rate ID for this pickup location (use for selectPickupLocation) */
+    id: string;
+    /** Pickup location name (e.g., "Main Store", "Tel Aviv Warehouse") */
+    name: string;
+    /** Shipping rate name */
+    rateName: string;
+    /** Location address */
+    address: {
+        line1: string;
+        line2?: string;
+        city: string;
+        region?: string;
+        postalCode: string;
+        country: string;
+    };
+    /** Contact phone */
+    phone?: string;
+    /** Business hours (e.g., "Sun-Thu 9:00-17:00") */
+    hours?: string;
+    /** Pickup instructions (e.g., "Enter through side door") */
+    instructions?: string;
+    /** Pickup fee as string (e.g., "0", "2.99") */
+    price: string;
+    /** Currency code */
+    currency: string;
+}
+/**
+ * Data required to select a pickup location during checkout.
+ */
+interface SelectPickupLocationDto {
+    /** The pickup rate ID (from getPickupLocations) */
+    pickupRateId: string;
+    /** Customer email (required) */
+    email: string;
+    /** Customer first name */
+    firstName?: string;
+    /** Customer last name */
+    lastName?: string;
+    /** Customer phone */
+    phone?: string;
+    /** Marketing consent */
+    acceptsMarketing?: boolean;
+}
 /**
  * Represents a checkout session for completing a purchase.
  *
@@ -1841,6 +1888,10 @@ interface Checkout {
     email?: string | null;
     /** Customer ID if linked to a customer account */
     customerId?: string | null;
+    /** Delivery method: "shipping" (default) or "pickup" */
+    deliveryType?: 'shipping' | 'pickup';
+    /** Pickup location details (when deliveryType is "pickup") */
+    pickupLocation?: PickupLocation | null;
     /** Shipping address (required before selecting shipping) */
     shippingAddress?: CheckoutAddress | null;
     /** Billing address (optional, defaults to shipping) */
@@ -2336,9 +2387,9 @@ type PaymentProvider = PaymentProviderConfig;
  *
  * const growProvider = providers.find(p => p.provider === 'grow');
  * if (growProvider) {
- *   // Grow uses iframe — no client-side SDK needed
- *   // createPaymentIntent() returns a payment URL as clientSecret
- *   // Show it in an iframe: <iframe src={paymentIntent.clientSecret} />
+ *   // Grow uses SDK wallet — load https://cdn.meshulam.co.il/sdk/gs.min.js
+ *   // createPaymentIntent() returns an authCode as clientSecret
+ *   // Call growPayment.init({...}) then growPayment.renderPaymentOptions(authCode)
  * }
  * ```
  */
@@ -2372,7 +2423,7 @@ interface PaymentConfig {
 interface PaymentIntent {
     /** Payment intent ID */
     id: string;
-    /** Client secret for completing payment on frontend. For Stripe: client secret (pi_xxx_secret_xxx). For Grow: payment page URL. */
+    /** Client secret for completing payment on frontend. For Stripe: client secret (pi_xxx_secret_xxx). For Grow: authCode for SDK wallet rendering. */
     clientSecret: string;
     /** Amount in display format (e.g., "99.99") */
     amount: string;
@@ -4906,6 +4957,45 @@ declare class BrainerceClient {
      * ```
      */
     selectShippingMethod(checkoutId: string, shippingRateId: string): Promise<Checkout>;
+    /**
+     * Get available pickup locations for a store.
+     * Returns empty array if no pickup locations are configured.
+     *
+     * @example
+     * ```typescript
+     * const locations = await client.getPickupLocations();
+     * if (locations.length > 0) {
+     *   // Show pickup option in checkout
+     * }
+     * ```
+     */
+    getPickupLocations(): Promise<PickupLocation[]>;
+    /**
+     * Set delivery type on checkout (shipping or pickup).
+     *
+     * @example
+     * ```typescript
+     * const checkout = await client.setDeliveryType('checkout_123', 'pickup');
+     * ```
+     */
+    setDeliveryType(checkoutId: string, deliveryType: 'shipping' | 'pickup'): Promise<Checkout>;
+    /**
+     * Select a pickup location for checkout.
+     * This sets the delivery type to "pickup", records customer info, and prepares for payment.
+     * Equivalent to setShippingAddress + selectShippingMethod for delivery orders.
+     *
+     * @example
+     * ```typescript
+     * const checkout = await client.selectPickupLocation('checkout_123', {
+     *   pickupRateId: 'rate_main_store',
+     *   email: 'customer@example.com',
+     *   firstName: 'John',
+     *   lastName: 'Doe',
+     * });
+     * // Now proceed to payment
+     * ```
+     */
+    selectPickupLocation(checkoutId: string, data: SelectPickupLocationDto): Promise<Checkout>;
     /**
      * Set billing address on checkout
      * Can optionally use shipping address as billing address
@@ -5073,6 +5163,19 @@ declare class BrainerceClient {
      * ```
      */
     getPaymentStatus(checkoutId: string): Promise<PaymentStatus>;
+    /**
+     * Confirm a Grow SDK payment from the frontend.
+     * Call this in the Grow SDK `onSuccess` callback to notify the backend
+     * that payment succeeded, triggering order creation.
+     *
+     * **Vibe-coded mode only** - requires connectionId
+     *
+     * @param checkoutId - The checkout ID
+     * @param confirmationNumber - Optional confirmation number from Grow onSuccess
+     */
+    confirmGrowPayment(checkoutId: string, confirmationNumber?: string): Promise<{
+        confirmed: boolean;
+    }>;
     /**
      * Wait for order creation after payment.
      *
@@ -6314,4 +6417,4 @@ declare function enableDevGuards(options?: {
     force?: boolean;
 }): void;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomerDto, 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 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 UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, 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 CartItem, type CartNudge, type CartRecommendationsResponse, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, 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 CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, 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 EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type InviteStoreMemberDto as InviteStoreMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type Order, type OrderAddress, type OrderCustomer, type OrderDownloadLink, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PickupLocation, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductDiscountBadge, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductRecommendation, type ProductRecommendationsResponse, type ProductRelationType, type ProductSuggestion, type ProductVariant, type PublicMetafieldDefinition, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectPickupLocationDto, type SelectShippingMethodDto, type SendInvoiceDto, type SessionCartRef, type SetBillingAddressDto, type SetCheckoutCustomerDto, 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 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 UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, 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 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, enableDevGuards, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductMetafield, getProductMetafieldValue, getProductMetafieldsByType, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.js

@@ -3103,6 +3103,91 @@ var BrainerceClient = class {
       "checkout"
     );
   }
+  /**
+   * Get available pickup locations for a store.
+   * Returns empty array if no pickup locations are configured.
+   *
+   * @example
+   * ```typescript
+   * const locations = await client.getPickupLocations();
+   * if (locations.length > 0) {
+   *   // Show pickup option in checkout
+   * }
+   * ```
+   */
+  async getPickupLocations() {
+    if (this.isVibeCodedMode()) {
+      const result = await this.vibeCodedRequest(
+        "GET",
+        "/checkout/pickup-locations"
+      );
+      return result.pickupLocations;
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/checkout/pickup-locations");
+    }
+    return this.adminRequest("GET", "/api/v1/checkouts/pickup-locations");
+  }
+  /**
+   * Set delivery type on checkout (shipping or pickup).
+   *
+   * @example
+   * ```typescript
+   * const checkout = await client.setDeliveryType('checkout_123', 'pickup');
+   * ```
+   */
+  async setDeliveryType(checkoutId, deliveryType) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("PATCH", `/checkout/${checkoutId}/delivery-type`, {
+        deliveryType
+      });
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("PATCH", `/checkout/${checkoutId}/delivery-type`, {
+        deliveryType
+      });
+    }
+    return this.adminRequest("PATCH", `/api/v1/checkout/${checkoutId}/delivery-type`, {
+      deliveryType
+    });
+  }
+  /**
+   * Select a pickup location for checkout.
+   * This sets the delivery type to "pickup", records customer info, and prepares for payment.
+   * Equivalent to setShippingAddress + selectShippingMethod for delivery orders.
+   *
+   * @example
+   * ```typescript
+   * const checkout = await client.selectPickupLocation('checkout_123', {
+   *   pickupRateId: 'rate_main_store',
+   *   email: 'customer@example.com',
+   *   firstName: 'John',
+   *   lastName: 'Doe',
+   * });
+   * // Now proceed to payment
+   * ```
+   */
+  async selectPickupLocation(checkoutId, data) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/pickup-location`,
+        data
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/pickup-location`,
+        data
+      );
+    }
+    return this.adminRequest(
+      "PATCH",
+      `/api/v1/checkout/${checkoutId}/pickup-location`,
+      data
+    );
+  }
   /**
    * Set billing address on checkout
    * Can optionally use shipping address as billing address
@@ -3345,6 +3430,28 @@ var BrainerceClient = class {
     }
     return this.vibeCodedRequest("GET", `/checkout/${checkoutId}/payment-status`);
   }
+  /**
+   * Confirm a Grow SDK payment from the frontend.
+   * Call this in the Grow SDK `onSuccess` callback to notify the backend
+   * that payment succeeded, triggering order creation.
+   *
+   * **Vibe-coded mode only** - requires connectionId
+   *
+   * @param checkoutId - The checkout ID
+   * @param confirmationNumber - Optional confirmation number from Grow onSuccess
+   */
+  async confirmGrowPayment(checkoutId, confirmationNumber) {
+    if (!this.isVibeCodedMode()) {
+      throw new BrainerceError(
+        "confirmGrowPayment is only available in vibe-coded mode (use connectionId)",
+        400
+      );
+    }
+    return this.vibeCodedRequest("POST", "/payment/grow-confirm", {
+      checkoutId,
+      confirmationNumber
+    });
+  }
   /**
    * Wait for order creation after payment.
    *

package/dist/index.mjs

@@ -3045,6 +3045,91 @@ var BrainerceClient = class {
       "checkout"
     );
   }
+  /**
+   * Get available pickup locations for a store.
+   * Returns empty array if no pickup locations are configured.
+   *
+   * @example
+   * ```typescript
+   * const locations = await client.getPickupLocations();
+   * if (locations.length > 0) {
+   *   // Show pickup option in checkout
+   * }
+   * ```
+   */
+  async getPickupLocations() {
+    if (this.isVibeCodedMode()) {
+      const result = await this.vibeCodedRequest(
+        "GET",
+        "/checkout/pickup-locations"
+      );
+      return result.pickupLocations;
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/checkout/pickup-locations");
+    }
+    return this.adminRequest("GET", "/api/v1/checkouts/pickup-locations");
+  }
+  /**
+   * Set delivery type on checkout (shipping or pickup).
+   *
+   * @example
+   * ```typescript
+   * const checkout = await client.setDeliveryType('checkout_123', 'pickup');
+   * ```
+   */
+  async setDeliveryType(checkoutId, deliveryType) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("PATCH", `/checkout/${checkoutId}/delivery-type`, {
+        deliveryType
+      });
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("PATCH", `/checkout/${checkoutId}/delivery-type`, {
+        deliveryType
+      });
+    }
+    return this.adminRequest("PATCH", `/api/v1/checkout/${checkoutId}/delivery-type`, {
+      deliveryType
+    });
+  }
+  /**
+   * Select a pickup location for checkout.
+   * This sets the delivery type to "pickup", records customer info, and prepares for payment.
+   * Equivalent to setShippingAddress + selectShippingMethod for delivery orders.
+   *
+   * @example
+   * ```typescript
+   * const checkout = await client.selectPickupLocation('checkout_123', {
+   *   pickupRateId: 'rate_main_store',
+   *   email: 'customer@example.com',
+   *   firstName: 'John',
+   *   lastName: 'Doe',
+   * });
+   * // Now proceed to payment
+   * ```
+   */
+  async selectPickupLocation(checkoutId, data) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/pickup-location`,
+        data
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/pickup-location`,
+        data
+      );
+    }
+    return this.adminRequest(
+      "PATCH",
+      `/api/v1/checkout/${checkoutId}/pickup-location`,
+      data
+    );
+  }
   /**
    * Set billing address on checkout
    * Can optionally use shipping address as billing address
@@ -3287,6 +3372,28 @@ var BrainerceClient = class {
     }
     return this.vibeCodedRequest("GET", `/checkout/${checkoutId}/payment-status`);
   }
+  /**
+   * Confirm a Grow SDK payment from the frontend.
+   * Call this in the Grow SDK `onSuccess` callback to notify the backend
+   * that payment succeeded, triggering order creation.
+   *
+   * **Vibe-coded mode only** - requires connectionId
+   *
+   * @param checkoutId - The checkout ID
+   * @param confirmationNumber - Optional confirmation number from Grow onSuccess
+   */
+  async confirmGrowPayment(checkoutId, confirmationNumber) {
+    if (!this.isVibeCodedMode()) {
+      throw new BrainerceError(
+        "confirmGrowPayment is only available in vibe-coded mode (use connectionId)",
+        400
+      );
+    }
+    return this.vibeCodedRequest("POST", "/payment/grow-confirm", {
+      checkoutId,
+      confirmationNumber
+    });
+  }
   /**
    * Wait for order creation after payment.
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "brainerce",
-  "version": "1.2.0",
+  "version": "1.3.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",