@basedone/core 0.2.3 → 0.2.4

package/dist/{chunk-SKX4VGEN.mjs → chunk-NVL2HX2H.mjs}

@@ -988,6 +988,148 @@ var CustomerEcommerceClient = class extends BaseEcommerceClient {
   async getPaymentMethods() {
     return this.get("/api/marketplace/payments/methods");
   }
+  // ============================================================================
+  // GEM System API
+  // ============================================================================
+  /**
+   * Get user's gem balance
+   * 
+   * Returns the current gem balance including total gems, available gems,
+   * and gems expiring soon. Gems are earned at 100 per $1 of revenue.
+   * 
+   * @returns Current gem balance with USD equivalent
+   * 
+   * @example
+   * ```typescript
+   * const balance = await client.getGemBalance();
+   * console.log(`You have ${balance.totalGems} gems (${balance.usdEquivalent} USD)`);
+   * console.log(`${balance.expiringSoon} gems expiring soon`);
+   * ```
+   */
+  async getGemBalance() {
+    return this.get("/api/gems/balance");
+  }
+  /**
+   * Get gem transaction history
+   * 
+   * Returns paginated history of gem transactions including earning,
+   * spending, and expiration events.
+   * 
+   * @param params - Query parameters for filtering and pagination
+   * @returns Paginated gem history
+   * 
+   * @example
+   * ```typescript
+   * // Get all history
+   * const history = await client.getGemHistory({ limit: 20, offset: 0 });
+   * 
+   * // Get only earned gems
+   * const earned = await client.getGemHistory({ type: "earn", limit: 10 });
+   * 
+   * // Get only spent gems
+   * const spent = await client.getGemHistory({ type: "spend", limit: 10 });
+   * 
+   * history.items.forEach(item => {
+   *   console.log(`${item.type}: ${item.amount} gems - ${item.createdAt}`);
+   * });
+   * ```
+   */
+  async getGemHistory(params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/gems/history${queryString}`);
+  }
+  /**
+   * Get gems that are expiring soon
+   * 
+   * Returns gem batches that will expire within the specified number of days.
+   * Useful for prompting users to spend gems before they expire.
+   * 
+   * @param params - Query parameters (days: default 30, max 180)
+   * @returns Expiring gem batches with countdown info
+   * 
+   * @example
+   * ```typescript
+   * // Get gems expiring in next 30 days (default)
+   * const expiring = await client.getExpiringGems();
+   * 
+   * // Get gems expiring in next 7 days
+   * const urgent = await client.getExpiringGems({ days: 7 });
+   * 
+   * if (expiring.totalExpiring > 0) {
+   *   console.log(`${expiring.totalExpiring} gems expiring soon!`);
+   *   expiring.batches.forEach(batch => {
+   *     console.log(`${batch.amount} gems expire in ${batch.daysUntilExpiry} days`);
+   *   });
+   * }
+   * ```
+   */
+  async getExpiringGems(params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/gems/expiring${queryString}`);
+  }
+  // ============================================================================
+  // Browsing Location API
+  // ============================================================================
+  /**
+   * Get user's browsing location
+   * 
+   * Returns the user's saved delivery location for geo-based product filtering.
+   * This location is used to show products from merchants that ship to the area.
+   * 
+   * @returns Current browsing location or null if not set
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getBrowsingLocation();
+   * if (result.location) {
+   *   console.log(`Delivery to: ${result.location.city}, ${result.location.country}`);
+   * }
+   * ```
+   */
+  async getBrowsingLocation() {
+    return this.get("/api/user/browsing-location");
+  }
+  /**
+   * Save user's browsing location
+   * 
+   * Sets the user's delivery location for geo-based product filtering.
+   * Products will be filtered to show only items from merchants that ship to this location.
+   * 
+   * @param request - Location data from Google Places or manual input
+   * @returns The saved location
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.saveBrowsingLocation({
+   *   formattedAddress: "Singapore, Singapore",
+   *   city: "Singapore",
+   *   country: "SG",
+   *   latitude: 1.3521,
+   *   longitude: 103.8198
+   * });
+   * console.log(`Location saved: ${result.location.formattedAddress}`);
+   * ```
+   */
+  async saveBrowsingLocation(request) {
+    return this.post("/api/user/browsing-location", request);
+  }
+  /**
+   * Clear user's browsing location
+   * 
+   * Removes the user's saved delivery location. Products will no longer
+   * be filtered by shipping destination.
+   * 
+   * @returns Success response
+   * 
+   * @example
+   * ```typescript
+   * await client.clearBrowsingLocation();
+   * console.log("Location cleared - showing all products");
+   * ```
+   */
+  async clearBrowsingLocation() {
+    return this.delete("/api/user/browsing-location");
+  }
 };
 
 // lib/ecommerce/client/merchant.ts
@@ -2651,6 +2793,7 @@ var ProductSortBy = /* @__PURE__ */ ((ProductSortBy2) => {
   ProductSortBy2["PRICE_DESC"] = "price_desc";
   ProductSortBy2["POPULAR"] = "popular";
   ProductSortBy2["FEATURED"] = "featured";
+  ProductSortBy2["NEARBY"] = "nearby";
   return ProductSortBy2;
 })(ProductSortBy || {});
 var ReviewSortBy = /* @__PURE__ */ ((ReviewSortBy2) => {

package/dist/ecommerce.d.mts

@@ -410,7 +410,9 @@ declare enum ProductSortBy {
     /** Sort by popularity */
     POPULAR = "popular",
     /** Sort by featured status */
-    FEATURED = "featured"
+    FEATURED = "featured",
+    /** Sort by proximity to user location (requires lat/lng) */
+    NEARBY = "nearby"
 }
 /**
  * Review sort by enum
@@ -1292,6 +1294,12 @@ interface ListProductsParams extends PaginationParams {
     sortBy?: ProductSortBy;
     /** Filter by active status */
     isActive?: boolean;
+    /** Filter by destination country (ISO 2-letter code) - only show products from merchants that ship here */
+    country?: string;
+    /** User latitude for proximity sorting (used with sortBy=nearby) */
+    lat?: number;
+    /** User longitude for proximity sorting (used with sortBy=nearby) */
+    lng?: number;
 }
 /**
  * Create product request
@@ -1893,6 +1901,41 @@ interface CalculateShippingRequest {
     /** Order subtotal in USDC */
     orderSubtotal: number;
 }
+/**
+ * Gem history type filter
+ */
+type GemHistoryTypeFilter = "earn" | "spend" | "all";
+/**
+ * Get gem history parameters
+ */
+interface GetGemHistoryParams extends PaginationParams {
+    /** Filter by transaction type */
+    type?: GemHistoryTypeFilter;
+}
+/**
+ * Get expiring gems parameters
+ */
+interface GetExpiringGemsParams {
+    /** Number of days ahead to check (default: 30, max: 180) */
+    days?: number;
+}
+/**
+ * Save browsing location request
+ */
+interface SaveBrowsingLocationRequest {
+    /** Full display address from Google Places */
+    formattedAddress: string;
+    /** City name */
+    city: string;
+    /** State/Province (optional) */
+    stateProvince?: string;
+    /** ISO 2-letter country code (e.g., "SG", "US") */
+    country: string;
+    /** Latitude coordinate */
+    latitude: number;
+    /** Longitude coordinate */
+    longitude: number;
+}
 
 /**
  * Ecommerce API Response Types
@@ -2882,6 +2925,147 @@ interface ProcessPaymentResponse {
     /** Error code */
     errorCode?: string;
 }
+/**
+ * Gem source type - how gems were earned
+ */
+type GemSource = "BUILDER_CODE" | "PREDICTION" | "CARD_SPEND" | "MALL_SPEND" | "ADMIN" | "REFUND";
+/**
+ * Get gem balance response
+ */
+interface GetGemBalanceResponse {
+    /** User ID */
+    userId: string;
+    /** Total gems owned */
+    totalGems: number;
+    /** Available gems (not reserved) */
+    availableGems: number;
+    /** Gems expiring within 30 days */
+    expiringSoon: number;
+    /** Last balance update timestamp */
+    lastUpdated: string;
+    /** USD equivalent (totalGems / 100) */
+    usdEquivalent: number;
+    /** Conversion rate (gems per $1) */
+    conversionRate: number;
+}
+/**
+ * Gem history item type
+ */
+type GemHistoryType = "earn" | "spend" | "expire";
+/**
+ * Gem history item
+ */
+interface GemHistoryItem {
+    /** Transaction ID */
+    id: string;
+    /** Type of transaction */
+    type: GemHistoryType;
+    /** Amount of gems (positive for earn, negative for spend) */
+    amount: number;
+    /** Source type (for earn transactions) */
+    source?: GemSource;
+    /** Reason description (for spend transactions) */
+    reason?: string;
+    /** When the transaction occurred */
+    createdAt: string;
+    /** When the gems expire (for earn transactions) */
+    expiresAt?: string;
+}
+/**
+ * Get gem history response
+ */
+interface GetGemHistoryResponse {
+    /** History items */
+    items: GemHistoryItem[];
+    /** Total count of items */
+    total: number;
+    /** Pagination info */
+    pagination: {
+        /** Items per page */
+        limit: number;
+        /** Current offset */
+        offset: number;
+        /** Whether more items exist */
+        hasMore: boolean;
+    };
+}
+/**
+ * Expiring gem batch
+ */
+interface ExpiringGemBatch {
+    /** Batch ID */
+    id: string;
+    /** Remaining gems in batch */
+    amount: number;
+    /** How the gems were earned */
+    source: GemSource;
+    /** When the batch expires */
+    expiresAt: string;
+    /** When the batch was created */
+    createdAt: string;
+    /** Days until expiry */
+    daysUntilExpiry: number;
+}
+/**
+ * Get expiring gems response
+ */
+interface GetExpiringGemsResponse {
+    /** Total gems expiring within the query period */
+    totalExpiring: number;
+    /** Expiring batches */
+    batches: ExpiringGemBatch[];
+    /** Query parameters used */
+    queryParams: {
+        /** Days ahead that were queried */
+        days: number;
+    };
+}
+/**
+ * User's browsing location for geo-based product filtering
+ */
+interface BrowsingLocation {
+    /** Location ID */
+    id: string;
+    /** Full display address */
+    formattedAddress: string;
+    /** City name */
+    city: string;
+    /** State/Province (if applicable) */
+    stateProvince?: string | null;
+    /** ISO 2-letter country code */
+    country: string;
+    /** Latitude coordinate */
+    latitude: number;
+    /** Longitude coordinate */
+    longitude: number;
+    /** Last updated timestamp */
+    updatedAt: string;
+}
+/**
+ * Get browsing location response
+ */
+interface GetBrowsingLocationResponse {
+    /** User's saved browsing location (null if not set) */
+    location: BrowsingLocation | null;
+}
+/**
+ * Save browsing location response
+ */
+interface SaveBrowsingLocationResponse {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** The saved location */
+    location: BrowsingLocation;
+}
+/**
+ * Delete browsing location response
+ */
+interface DeleteBrowsingLocationResponse {
+    /** Whether the operation was successful */
+    success: boolean;
+    /** Success message */
+    message: string;
+}
 
 /**
  * Customer/End-User Ecommerce API Client
@@ -3482,6 +3666,128 @@ declare class CustomerEcommerceClient extends BaseEcommerceClient {
      * ```
      */
     getPaymentMethods(): Promise<GetPaymentMethodsResponse>;
+    /**
+     * Get user's gem balance
+     *
+     * Returns the current gem balance including total gems, available gems,
+     * and gems expiring soon. Gems are earned at 100 per $1 of revenue.
+     *
+     * @returns Current gem balance with USD equivalent
+     *
+     * @example
+     * ```typescript
+     * const balance = await client.getGemBalance();
+     * console.log(`You have ${balance.totalGems} gems (${balance.usdEquivalent} USD)`);
+     * console.log(`${balance.expiringSoon} gems expiring soon`);
+     * ```
+     */
+    getGemBalance(): Promise<GetGemBalanceResponse>;
+    /**
+     * Get gem transaction history
+     *
+     * Returns paginated history of gem transactions including earning,
+     * spending, and expiration events.
+     *
+     * @param params - Query parameters for filtering and pagination
+     * @returns Paginated gem history
+     *
+     * @example
+     * ```typescript
+     * // Get all history
+     * const history = await client.getGemHistory({ limit: 20, offset: 0 });
+     *
+     * // Get only earned gems
+     * const earned = await client.getGemHistory({ type: "earn", limit: 10 });
+     *
+     * // Get only spent gems
+     * const spent = await client.getGemHistory({ type: "spend", limit: 10 });
+     *
+     * history.items.forEach(item => {
+     *   console.log(`${item.type}: ${item.amount} gems - ${item.createdAt}`);
+     * });
+     * ```
+     */
+    getGemHistory(params?: GetGemHistoryParams): Promise<GetGemHistoryResponse>;
+    /**
+     * Get gems that are expiring soon
+     *
+     * Returns gem batches that will expire within the specified number of days.
+     * Useful for prompting users to spend gems before they expire.
+     *
+     * @param params - Query parameters (days: default 30, max 180)
+     * @returns Expiring gem batches with countdown info
+     *
+     * @example
+     * ```typescript
+     * // Get gems expiring in next 30 days (default)
+     * const expiring = await client.getExpiringGems();
+     *
+     * // Get gems expiring in next 7 days
+     * const urgent = await client.getExpiringGems({ days: 7 });
+     *
+     * if (expiring.totalExpiring > 0) {
+     *   console.log(`${expiring.totalExpiring} gems expiring soon!`);
+     *   expiring.batches.forEach(batch => {
+     *     console.log(`${batch.amount} gems expire in ${batch.daysUntilExpiry} days`);
+     *   });
+     * }
+     * ```
+     */
+    getExpiringGems(params?: GetExpiringGemsParams): Promise<GetExpiringGemsResponse>;
+    /**
+     * Get user's browsing location
+     *
+     * Returns the user's saved delivery location for geo-based product filtering.
+     * This location is used to show products from merchants that ship to the area.
+     *
+     * @returns Current browsing location or null if not set
+     *
+     * @example
+     * ```typescript
+     * const result = await client.getBrowsingLocation();
+     * if (result.location) {
+     *   console.log(`Delivery to: ${result.location.city}, ${result.location.country}`);
+     * }
+     * ```
+     */
+    getBrowsingLocation(): Promise<GetBrowsingLocationResponse>;
+    /**
+     * Save user's browsing location
+     *
+     * Sets the user's delivery location for geo-based product filtering.
+     * Products will be filtered to show only items from merchants that ship to this location.
+     *
+     * @param request - Location data from Google Places or manual input
+     * @returns The saved location
+     *
+     * @example
+     * ```typescript
+     * const result = await client.saveBrowsingLocation({
+     *   formattedAddress: "Singapore, Singapore",
+     *   city: "Singapore",
+     *   country: "SG",
+     *   latitude: 1.3521,
+     *   longitude: 103.8198
+     * });
+     * console.log(`Location saved: ${result.location.formattedAddress}`);
+     * ```
+     */
+    saveBrowsingLocation(request: SaveBrowsingLocationRequest): Promise<SaveBrowsingLocationResponse>;
+    /**
+     * Clear user's browsing location
+     *
+     * Removes the user's saved delivery location. Products will no longer
+     * be filtered by shipping destination.
+     *
+     * @returns Success response
+     *
+     * @example
+     * ```typescript
+     * await client.clearBrowsingLocation();
+     * console.log("Location cleared - showing all products");
+     * ```
+     */
+    clearBrowsingLocation(): Promise<DeleteBrowsingLocationResponse>;
 }
 
 /**
@@ -5196,4 +5502,4 @@ declare function calculateDiscountAmount(price: number, discountType: "PERCENTAG
  */
 declare function calculateFinalPrice(price: number, discountType: "PERCENTAGE" | "FIXED_AMOUNT", discountValue: number): number;
 
-export { type ActiveFlashSalesResponse, type AnalyticsOverview, type ApiResponse, type AppliedDiscount, type Banner, type BannerResponse, BannerType, BaseEcommerceClient, type BaseEntity, type CalculateCartDiscountsRequest, type CalculateCartDiscountsResponse, type CalculateShippingRequest, type CalculateShippingResponse, type CalculateTaxRequest, type CalculateTaxResponse, type CartItem, type ConfirmEscrowDepositResponse, type Coupon, type CouponResponse, type CouponUsage, type CreateBannerRequest, type CreateCouponRequest, type CreateFlashSaleRequest, type CreateOrderEventRequest, type CreateOrderEventResponse, type CreateOrderRequest, type CreateOrderResponse, type CreateProductRequest, type CreateProductVariantRequest, type CreateReviewRequest, type CreateShippingMethodRequest, type CreateShippingRateRequest, type CreateShippingZoneRequest, type CreateTaxNexusRequest, type CreateTaxRuleRequest, CustomerEcommerceClient, type CustomerMessagesResponse, type CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, type EcommerceClientConfig, type FlashSale, type FlashSaleItem, type FlashSaleItemInput, type FollowActionResponse, type FollowStatusResponse, type FollowedMerchantSummary, type GenerateTaxReportRequest, type GetAnalyticsParams, type GetAnalyticsResponse, type GetCouponResponse, type GetOrderResponse, type GetPaymentMethodsResponse, type GetProductMetricsResponse, type GetProductResponse, type GetTaxReportResponse, InventoryAuditAction, type InventoryAuditEntry, type ListActiveBannersParams, type ListActiveFlashSalesParams, type ListBannersResponse, type ListCouponsResponse, type ListCustomersParams, type ListCustomersResponse, type ListFollowingParams, type ListFollowingResponse, type ListInventoryAuditResponse, type ListMediaAssetsResponse, type ListMerchantProductsParams, type ListMessagesResponse, type ListOrdersParams, type ListOrdersResponse, type ListProductVariantsResponse, type ListProductsParams, type ListProductsResponse, type ListReturnsResponse, type ListReviewsParams, type ListReviewsResponse, type ListShipmentsResponse, type ListShippingAddressesResponse, type ListShippingMethodsResponse, type ListShippingRatesResponse, type ListShippingZonesResponse, type ListTaxNexusResponse, type ListTaxReportsParams, type ListTaxReportsResponse, type ListTaxRulesResponse, type MediaAsset, type MediaAssetResponse, type Merchant, MerchantEcommerceClient, type MerchantProductsResponse, type MerchantProfileRequest, type MerchantProfileResponse, type MerchantShippingSettings, MerchantStatus, type Message, type MessageResponse, type MessageStatsResponse, type Order, type OrderEvent, type OrderItem, type OrderReceiptResponse, OrderStatus, type OrdersByStatus, type PaginatedResponse, type PaginationParams, type Payment, PaymentMethod, type PaymentMethodInfo, PaymentStatus, type ProcessPaymentRequest, type ProcessPaymentResponse, type Product, type ProductDimensions, type ProductDiscountsResponse, type ProductMetrics, type ProductResponse, type ProductReview, ProductSortBy, type ProductVariant, type ProductVariantResponse, type PublicMerchantProfile, type PublicMerchantProfileResponse, type RecentOrderSummary, type RespondToReviewRequest, type Return, type ReturnItem, type ReturnResponse, ReturnStatus, type RevenueByDay, type ReviewResponse, ReviewSortBy, ReviewStatus, type SendMessageRequest, type Settlement, type Shipment, type ShipmentResponse, ShipmentStatus, type ShippingAddress$1 as ShippingAddress, type ShippingAddressRequest, type ShippingAddressResponse, type ShippingMethod, type ShippingMethodResponse, type ShippingOption, type ShippingRate, type ShippingRateResponse, type ShippingSettingsResponse, type ShippingZone, type ShippingZoneResponse, SortOrder, type SuccessResponse, TaxBehavior, type TaxBreakdownItem, type TaxNexus, type TaxNexusResponse, type TaxReport, type TaxReportDetails, TaxReportPeriodType, type TaxReportResponse, TaxReportStatus, type TaxRule, type TaxRuleResponse, type TaxSettings, type TaxSettingsResponse, TaxType, type TopProduct, type TrackBannerRequest, type UpdateBannerRequest, type UpdateCouponRequest, type UpdateFlashSaleRequest, type UpdateOrderResponse, type UpdateOrderStatusRequest, type UpdateProductRequest, type UpdateProductVariantRequest, type UpdateShipmentRequest, type UpdateShippingMethodRequest, type UpdateShippingRateRequest, type UpdateShippingSettingsRequest, type UpdateShippingZoneRequest, type UpdateTaxNexusRequest, type UpdateTaxReportStatusRequest, type UpdateTaxRuleRequest, type UpdateTaxSettingsRequest, type UserShippingAddress, type ValidateDiscountRequest, type ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress };
+export { type ActiveFlashSalesResponse, type AnalyticsOverview, type ApiResponse, type AppliedDiscount, type Banner, type BannerResponse, BannerType, BaseEcommerceClient, type BaseEntity, type BrowsingLocation, type CalculateCartDiscountsRequest, type CalculateCartDiscountsResponse, type CalculateShippingRequest, type CalculateShippingResponse, type CalculateTaxRequest, type CalculateTaxResponse, type CartItem, type ConfirmEscrowDepositResponse, type Coupon, type CouponResponse, type CouponUsage, type CreateBannerRequest, type CreateCouponRequest, type CreateFlashSaleRequest, type CreateOrderEventRequest, type CreateOrderEventResponse, type CreateOrderRequest, type CreateOrderResponse, type CreateProductRequest, type CreateProductVariantRequest, type CreateReviewRequest, type CreateShippingMethodRequest, type CreateShippingRateRequest, type CreateShippingZoneRequest, type CreateTaxNexusRequest, type CreateTaxRuleRequest, CustomerEcommerceClient, type CustomerMessagesResponse, type CustomerSummary, type DeleteBrowsingLocationResponse, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, type EcommerceClientConfig, type ExpiringGemBatch, type FlashSale, type FlashSaleItem, type FlashSaleItemInput, type FollowActionResponse, type FollowStatusResponse, type FollowedMerchantSummary, type GemHistoryItem, type GemHistoryType, type GemHistoryTypeFilter, type GemSource, type GenerateTaxReportRequest, type GetAnalyticsParams, type GetAnalyticsResponse, type GetBrowsingLocationResponse, type GetCouponResponse, type GetExpiringGemsParams, type GetExpiringGemsResponse, type GetGemBalanceResponse, type GetGemHistoryParams, type GetGemHistoryResponse, type GetOrderResponse, type GetPaymentMethodsResponse, type GetProductMetricsResponse, type GetProductResponse, type GetTaxReportResponse, InventoryAuditAction, type InventoryAuditEntry, type ListActiveBannersParams, type ListActiveFlashSalesParams, type ListBannersResponse, type ListCouponsResponse, type ListCustomersParams, type ListCustomersResponse, type ListFollowingParams, type ListFollowingResponse, type ListInventoryAuditResponse, type ListMediaAssetsResponse, type ListMerchantProductsParams, type ListMessagesResponse, type ListOrdersParams, type ListOrdersResponse, type ListProductVariantsResponse, type ListProductsParams, type ListProductsResponse, type ListReturnsResponse, type ListReviewsParams, type ListReviewsResponse, type ListShipmentsResponse, type ListShippingAddressesResponse, type ListShippingMethodsResponse, type ListShippingRatesResponse, type ListShippingZonesResponse, type ListTaxNexusResponse, type ListTaxReportsParams, type ListTaxReportsResponse, type ListTaxRulesResponse, type MediaAsset, type MediaAssetResponse, type Merchant, MerchantEcommerceClient, type MerchantProductsResponse, type MerchantProfileRequest, type MerchantProfileResponse, type MerchantShippingSettings, MerchantStatus, type Message, type MessageResponse, type MessageStatsResponse, type Order, type OrderEvent, type OrderItem, type OrderReceiptResponse, OrderStatus, type OrdersByStatus, type PaginatedResponse, type PaginationParams, type Payment, PaymentMethod, type PaymentMethodInfo, PaymentStatus, type ProcessPaymentRequest, type ProcessPaymentResponse, type Product, type ProductDimensions, type ProductDiscountsResponse, type ProductMetrics, type ProductResponse, type ProductReview, ProductSortBy, type ProductVariant, type ProductVariantResponse, type PublicMerchantProfile, type PublicMerchantProfileResponse, type RecentOrderSummary, type RespondToReviewRequest, type Return, type ReturnItem, type ReturnResponse, ReturnStatus, type RevenueByDay, type ReviewResponse, ReviewSortBy, ReviewStatus, type SaveBrowsingLocationRequest, type SaveBrowsingLocationResponse, type SendMessageRequest, type Settlement, type Shipment, type ShipmentResponse, ShipmentStatus, type ShippingAddress$1 as ShippingAddress, type ShippingAddressRequest, type ShippingAddressResponse, type ShippingMethod, type ShippingMethodResponse, type ShippingOption, type ShippingRate, type ShippingRateResponse, type ShippingSettingsResponse, type ShippingZone, type ShippingZoneResponse, SortOrder, type SuccessResponse, TaxBehavior, type TaxBreakdownItem, type TaxNexus, type TaxNexusResponse, type TaxReport, type TaxReportDetails, TaxReportPeriodType, type TaxReportResponse, TaxReportStatus, type TaxRule, type TaxRuleResponse, type TaxSettings, type TaxSettingsResponse, TaxType, type TopProduct, type TrackBannerRequest, type UpdateBannerRequest, type UpdateCouponRequest, type UpdateFlashSaleRequest, type UpdateOrderResponse, type UpdateOrderStatusRequest, type UpdateProductRequest, type UpdateProductVariantRequest, type UpdateShipmentRequest, type UpdateShippingMethodRequest, type UpdateShippingRateRequest, type UpdateShippingSettingsRequest, type UpdateShippingZoneRequest, type UpdateTaxNexusRequest, type UpdateTaxReportStatusRequest, type UpdateTaxRuleRequest, type UpdateTaxSettingsRequest, type UserShippingAddress, type ValidateDiscountRequest, type ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress };