@basedone/core 0.2.1 → 0.2.3

package/dist/ecommerce.js

@@ -140,11 +140,13 @@ var BaseEcommerceClient = class {
       maxRetries: config.maxRetries || 3,
       retryBaseDelay: config.retryBaseDelay || 1e3,
       headers: config.headers,
-      enableRetry: config.enableRetry !== false
+      enableRetry: config.enableRetry !== false,
+      withCredentials: config.withCredentials || false
     };
     this.axiosInstance = axios__default.default.create({
       baseURL: this.config.baseURL,
       timeout: this.config.timeout,
+      withCredentials: this.config.withCredentials,
       headers: {
         "Content-Type": "application/json",
         ...this.config.headers
@@ -688,6 +690,34 @@ var CustomerEcommerceClient = class extends BaseEcommerceClient {
     return this.post("/api/marketplace/tax/calculate", request);
   }
   // ============================================================================
+  // Shipping Calculation API
+  // ============================================================================
+  /**
+   * Calculate shipping options for cart items
+   * 
+   * @param request - Cart items, merchant, and destination
+   * @returns Available shipping options with costs
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.calculateShippingOptions({
+   *   merchantId: "merchant_123",
+   *   cartItems: [
+   *     { productId: "prod_123", quantity: 2 }
+   *   ],
+   *   destinationCountry: "US",
+   *   orderSubtotal: 99.99
+   * });
+   * 
+   * result.shippingOptions.forEach(opt => {
+   *   console.log(opt.name, opt.cost, opt.estimatedDelivery);
+   * });
+   * ```
+   */
+  async calculateShippingOptions(request) {
+    return this.post("/api/marketplace/shipping/calculate", request);
+  }
+  // ============================================================================
   // Banners API
   // ============================================================================
   /**
@@ -831,6 +861,143 @@ var CustomerEcommerceClient = class extends BaseEcommerceClient {
     const queryString = params ? buildQueryString(params) : "";
     return this.get(`/api/marketplace/flash-sales/active${queryString}`);
   }
+  // ============================================================================
+  // Merchant Storefront API
+  // ============================================================================
+  /**
+   * Get public merchant profile
+   * 
+   * Fetches public information about a merchant for the storefront page.
+   * 
+   * @param merchantId - Merchant ID
+   * @returns Public merchant profile with stats
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getMerchantProfile("merchant_123");
+   * console.log(result.merchant.name, result.merchant.productCount);
+   * ```
+   */
+  async getMerchantProfile(merchantId) {
+    return this.get(`/api/marketplace/merchants/${merchantId}`);
+  }
+  /**
+   * List merchant products
+   * 
+   * Fetches products for a specific merchant with search, filter, and sort options.
+   * 
+   * @param merchantId - Merchant ID
+   * @param params - Query parameters for filtering and pagination
+   * @returns Paginated list of products
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getMerchantProducts("merchant_123", {
+   *   search: "laptop",
+   *   sortBy: "popular",
+   *   limit: 20,
+   * });
+   * 
+   * result.items.forEach(product => {
+   *   console.log(product.title, product.priceUSDC);
+   * });
+   * ```
+   */
+  async getMerchantProducts(merchantId, params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/marketplace/merchants/${merchantId}/products${queryString}`);
+  }
+  // ============================================================================
+  // Shop Following API
+  // ============================================================================
+  /**
+   * Check if following a merchant
+   * 
+   * @param merchantId - Merchant ID
+   * @returns Follow status with follow date if applicable
+   * 
+   * @example
+   * ```typescript
+   * const status = await client.isFollowingMerchant("merchant_123");
+   * if (status.isFollowing) {
+   *   console.log(`Following since ${status.followedAt}`);
+   * }
+   * ```
+   */
+  async isFollowingMerchant(merchantId) {
+    return this.get(`/api/marketplace/merchants/${merchantId}/follow`);
+  }
+  /**
+   * Follow a merchant
+   * 
+   * @param merchantId - Merchant ID to follow
+   * @returns Follow action result
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.followMerchant("merchant_123");
+   * console.log(result.message); // "Now following Awesome Store"
+   * ```
+   */
+  async followMerchant(merchantId) {
+    return this.post(`/api/marketplace/merchants/${merchantId}/follow`);
+  }
+  /**
+   * Unfollow a merchant
+   * 
+   * @param merchantId - Merchant ID to unfollow
+   * @returns Unfollow action result
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.unfollowMerchant("merchant_123");
+   * console.log(result.message); // "Unfollowed successfully"
+   * ```
+   */
+  async unfollowMerchant(merchantId) {
+    return this.delete(`/api/marketplace/merchants/${merchantId}/follow`);
+  }
+  /**
+   * Get list of followed merchants
+   * 
+   * @param params - Query parameters for pagination and sorting
+   * @returns Paginated list of followed merchants with their info
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getFollowedMerchants({ limit: 20, sortBy: "recent" });
+   * result.items.forEach(item => {
+   *   console.log(`${item.merchant.name} - followed on ${item.followedAt}`);
+   * });
+   * ```
+   */
+  async getFollowedMerchants(params) {
+    const queryString = params ? buildQueryString(params) : "";
+    return this.get(`/api/marketplace/following${queryString}`);
+  }
+  // ============================================================================
+  // Payment Methods
+  // ============================================================================
+  /**
+   * Get available payment methods
+   * 
+   * Returns the list of enabled payment methods that can be used during checkout.
+   * 
+   * @returns List of available payment methods with display info
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.getPaymentMethods();
+   * if (result.paymentsEnabled) {
+   *   result.methods.forEach(method => {
+   *     console.log(`${method.name}: ${method.description}`);
+   *   });
+   * }
+   * ```
+   */
+  async getPaymentMethods() {
+    return this.get("/api/marketplace/payments/methods");
+  }
 };
 
 // lib/ecommerce/client/merchant.ts
@@ -1365,6 +1532,192 @@ var MerchantEcommerceClient = class extends BaseEcommerceClient {
     return this.patch(`/api/marketplace/merchant/shipping/shipments/${shipmentId}`, request);
   }
   // ============================================================================
+  // Shipping Settings (Zones & Rates)
+  // ============================================================================
+  /**
+   * Get merchant shipping settings
+   * 
+   * @returns Shipping settings
+   * 
+   * @example
+   * ```typescript
+   * const { settings } = await client.getShippingSettings();
+   * console.log("Handling fee:", settings.defaultHandlingFee);
+   * ```
+   */
+  async getShippingSettings() {
+    return this.get("/api/marketplace/merchant/shipping/settings");
+  }
+  /**
+   * Update merchant shipping settings
+   * 
+   * @param request - Settings to update
+   * @returns Updated settings
+   * 
+   * @example
+   * ```typescript
+   * await client.updateShippingSettings({
+   *   defaultHandlingFee: 2.50,
+   *   freeShippingEnabled: true,
+   *   freeShippingThreshold: 100
+   * });
+   * ```
+   */
+  async updateShippingSettings(request) {
+    return this.post("/api/marketplace/merchant/shipping/settings", request);
+  }
+  /**
+   * List all shipping zones
+   * 
+   * @returns List of shipping zones with rate counts
+   * 
+   * @example
+   * ```typescript
+   * const { zones } = await client.listShippingZones();
+   * zones.forEach(z => console.log(z.name, z.countries.length, "countries"));
+   * ```
+   */
+  async listShippingZones() {
+    return this.get("/api/marketplace/merchant/shipping/zones");
+  }
+  /**
+   * Get a shipping zone by ID
+   * 
+   * @param zoneId - Zone ID
+   * @returns Zone with rates
+   * 
+   * @example
+   * ```typescript
+   * const { zone } = await client.getShippingZone("zone_123");
+   * console.log(zone.name, zone.rates?.length, "rates");
+   * ```
+   */
+  async getShippingZone(zoneId) {
+    return this.get(`/api/marketplace/merchant/shipping/zones/${zoneId}`);
+  }
+  /**
+   * Create a shipping zone
+   * 
+   * @param request - Zone data
+   * @returns Created zone
+   * 
+   * @example
+   * ```typescript
+   * const { zone } = await client.createShippingZone({
+   *   name: "Southeast Asia",
+   *   countries: ["SG", "MY", "TH", "ID", "PH", "VN"],
+   *   isDefault: false,
+   *   priority: 10
+   * });
+   * ```
+   */
+  async createShippingZone(request) {
+    return this.post("/api/marketplace/merchant/shipping/zones", request);
+  }
+  /**
+   * Update a shipping zone
+   * 
+   * @param zoneId - Zone ID
+   * @param request - Updated zone data
+   * @returns Updated zone
+   * 
+   * @example
+   * ```typescript
+   * await client.updateShippingZone("zone_123", {
+   *   countries: ["SG", "MY", "TH", "ID", "PH", "VN", "BN"]
+   * });
+   * ```
+   */
+  async updateShippingZone(zoneId, request) {
+    return this.put(`/api/marketplace/merchant/shipping/zones/${zoneId}`, request);
+  }
+  /**
+   * Delete a shipping zone
+   * 
+   * @param zoneId - Zone ID
+   * @returns Success response
+   * 
+   * @example
+   * ```typescript
+   * await client.deleteShippingZone("zone_123");
+   * ```
+   */
+  async deleteShippingZone(zoneId) {
+    return this.delete(`/api/marketplace/merchant/shipping/zones/${zoneId}`);
+  }
+  /**
+   * List shipping rates
+   * 
+   * @param zoneId - Optional zone ID to filter by
+   * @returns List of shipping rates
+   * 
+   * @example
+   * ```typescript
+   * // All rates
+   * const { rates } = await client.listShippingRates();
+   * 
+   * // Rates for a specific zone
+   * const { rates: zoneRates } = await client.listShippingRates("zone_123");
+   * ```
+   */
+  async listShippingRates(zoneId) {
+    const query = zoneId ? `?zoneId=${zoneId}` : "";
+    return this.get(`/api/marketplace/merchant/shipping/rates${query}`);
+  }
+  /**
+   * Create a shipping rate
+   * 
+   * @param request - Rate data
+   * @returns Created rate
+   * 
+   * @example
+   * ```typescript
+   * const { rate } = await client.createShippingRate({
+   *   zoneId: "zone_123",
+   *   name: "Standard Shipping",
+   *   baseRate: 5.00,
+   *   perKgRate: 1.50,
+   *   minDeliveryDays: 7,
+   *   maxDeliveryDays: 14
+   * });
+   * ```
+   */
+  async createShippingRate(request) {
+    return this.post("/api/marketplace/merchant/shipping/rates", request);
+  }
+  /**
+   * Update a shipping rate
+   * 
+   * @param rateId - Rate ID
+   * @param request - Updated rate data
+   * @returns Updated rate
+   * 
+   * @example
+   * ```typescript
+   * await client.updateShippingRate("rate_123", {
+   *   baseRate: 6.00,
+   *   freeAboveAmount: 75
+   * });
+   * ```
+   */
+  async updateShippingRate(rateId, request) {
+    return this.put(`/api/marketplace/merchant/shipping/rates/${rateId}`, request);
+  }
+  /**
+   * Delete a shipping rate
+   * 
+   * @param rateId - Rate ID
+   * @returns Success response
+   * 
+   * @example
+   * ```typescript
+   * await client.deleteShippingRate("rate_123");
+   * ```
+   */
+  async deleteShippingRate(rateId) {
+    return this.delete(`/api/marketplace/merchant/shipping/rates/${rateId}`);
+  }
+  // ============================================================================
   // Returns & Refunds
   // ============================================================================
   /**
@@ -1962,6 +2315,223 @@ var MerchantEcommerceClient = class extends BaseEcommerceClient {
   async exportTaxReport(reportId) {
     return this.get(`/api/marketplace/merchant/tax-reports/${reportId}/export`);
   }
+  // ============================================
+  // DROPSHIPPING APIs
+  // ============================================
+  /**
+   * List connected dropship suppliers
+   * 
+   * @returns Connected and available suppliers
+   * 
+   * @example
+   * ```typescript
+   * const { connected, available } = await client.listDropshipSuppliers();
+   * ```
+   */
+  async listDropshipSuppliers() {
+    return this.get("/api/marketplace/merchant/dropship/suppliers");
+  }
+  /**
+   * Connect a new dropship supplier
+   * 
+   * @param request - Supplier credentials
+   * @returns Connected supplier
+   * 
+   * @example
+   * ```typescript
+   * const supplier = await client.connectDropshipSupplier({
+   *   code: "CJ_DROPSHIPPING",
+   *   apiKey: "your-api-key"
+   * });
+   * ```
+   */
+  async connectDropshipSupplier(request) {
+    return this.post("/api/marketplace/merchant/dropship/suppliers", request);
+  }
+  /**
+   * Update dropship supplier settings
+   * 
+   * @param supplierId - Supplier ID
+   * @param request - Settings to update
+   * @returns Updated supplier
+   */
+  async updateDropshipSupplier(supplierId, request) {
+    return this.put(`/api/marketplace/merchant/dropship/suppliers/${supplierId}`, request);
+  }
+  /**
+   * Disconnect a dropship supplier
+   * 
+   * @param supplierId - Supplier ID
+   */
+  async disconnectDropshipSupplier(supplierId) {
+    return this.delete(`/api/marketplace/merchant/dropship/suppliers/${supplierId}`);
+  }
+  /**
+   * Search products from connected suppliers
+   * 
+   * @param request - Search parameters
+   * @returns Search results with pagination
+   * 
+   * @example
+   * ```typescript
+   * const results = await client.searchDropshipProducts({
+   *   supplierId: "supplier_123",
+   *   query: "wireless headphones",
+   *   limit: 20
+   * });
+   * ```
+   */
+  async searchDropshipProducts(request) {
+    return this.post("/api/marketplace/merchant/dropship/search", request);
+  }
+  /**
+   * Get dropship supplier categories
+   * 
+   * @param supplierId - Supplier ID
+   * @returns Category list
+   */
+  async getDropshipCategories(supplierId) {
+    return this.get(`/api/marketplace/merchant/dropship/categories?supplierId=${supplierId}`);
+  }
+  /**
+   * Get detailed product info from supplier
+   * 
+   * @param supplierId - Supplier ID
+   * @param externalProductId - Supplier's product ID
+   * @returns Product details with suggested pricing
+   */
+  async getDropshipProductDetails(supplierId, externalProductId) {
+    return this.get(
+      `/api/marketplace/merchant/dropship/products/${encodeURIComponent(externalProductId)}?supplierId=${supplierId}`
+    );
+  }
+  /**
+   * Import a product from supplier to your store
+   * 
+   * @param request - Import parameters
+   * @returns Created product IDs
+   * 
+   * @example
+   * ```typescript
+   * const result = await client.importDropshipProduct({
+   *   supplierId: "supplier_123",
+   *   externalProductId: "ext_product_456",
+   *   priceUSDC: 29.99,
+   *   title: "Custom Title"
+   * });
+   * ```
+   */
+  async importDropshipProduct(request) {
+    return this.post("/api/marketplace/merchant/dropship/import", request);
+  }
+  /**
+   * Bulk import products from supplier
+   * 
+   * @param request - Bulk import parameters
+   * @returns Import results
+   */
+  async bulkImportDropshipProducts(request) {
+    return this.post("/api/marketplace/merchant/dropship/import", request);
+  }
+  /**
+   * List imported dropship products
+   * 
+   * @param params - Filter parameters
+   * @returns Imported products list
+   */
+  async listDropshipProducts(params) {
+    const query = params ? `?${buildQueryString(params)}` : "";
+    return this.get(`/api/marketplace/merchant/dropship/import${query}`);
+  }
+  /**
+   * List dropship order links
+   * 
+   * @param params - Filter parameters
+   * @returns Order links with status summary
+   */
+  async listDropshipOrders(params) {
+    let query = "";
+    if (params) {
+      const queryParams = {};
+      if (params.status) {
+        queryParams.status = Array.isArray(params.status) ? params.status.join(",") : params.status;
+      }
+      if (params.limit) queryParams.limit = params.limit.toString();
+      if (params.offset) queryParams.offset = params.offset.toString();
+      query = `?${buildQueryString(queryParams)}`;
+    }
+    return this.get(`/api/marketplace/merchant/dropship/orders${query}`);
+  }
+  /**
+   * Forward orders to supplier
+   * 
+   * @param orderItemIds - Order item IDs to forward
+   * @returns Forward results
+   */
+  async forwardDropshipOrders(orderItemIds) {
+    return this.post("/api/marketplace/merchant/dropship/orders", {
+      action: "forward",
+      orderItemIds
+    });
+  }
+  /**
+   * Sync tracking for all pending dropship orders
+   * 
+   * @returns Sync results
+   */
+  async syncDropshipTracking() {
+    return this.post("/api/marketplace/merchant/dropship/orders", {
+      action: "sync"
+    });
+  }
+  /**
+   * Get order forwarding details for manual forwarding
+   * 
+   * @param orderItemId - Order item ID
+   * @returns Forwarding details
+   */
+  async getDropshipOrderDetails(orderItemId) {
+    return this.get(`/api/marketplace/merchant/dropship/orders/${orderItemId}/forward`);
+  }
+  /**
+   * Forward a single order item to supplier
+   * 
+   * @param orderItemId - Order item ID
+   * @returns Forward result
+   */
+  async forwardDropshipOrder(orderItemId) {
+    return this.post(`/api/marketplace/merchant/dropship/orders/${orderItemId}/forward`, {});
+  }
+  /**
+   * Get dropship settings
+   * 
+   * @returns Merchant dropship settings
+   */
+  async getDropshipSettings() {
+    return this.get("/api/marketplace/merchant/dropship/settings");
+  }
+  /**
+   * Update dropship settings
+   * 
+   * @param request - Settings to update
+   * @returns Updated settings
+   */
+  async updateDropshipSettings(request) {
+    return this.put("/api/marketplace/merchant/dropship/settings", request);
+  }
+  /**
+   * Sync dropship products and/or orders
+   * 
+   * @param type - Sync type (products, orders, all, single)
+   * @param dropshipProductId - For single product sync
+   * @returns Sync results
+   */
+  async syncDropship(type, dropshipProductId) {
+    return this.post("/api/marketplace/merchant/dropship/sync", {
+      type,
+      dropshipProductId
+    });
+  }
 };
 
 // lib/ecommerce/types/enums.ts
@@ -1979,6 +2549,8 @@ var OrderStatus = /* @__PURE__ */ ((OrderStatus2) => {
 })(OrderStatus || {});
 var PaymentMethod = /* @__PURE__ */ ((PaymentMethod2) => {
   PaymentMethod2["USDC_ESCROW"] = "USDC_ESCROW";
+  PaymentMethod2["BASEDPAY"] = "BASEDPAY";
+  PaymentMethod2["STRIPE"] = "STRIPE";
   PaymentMethod2["POINTS"] = "POINTS";
   return PaymentMethod2;
 })(PaymentMethod || {});

package/dist/ecommerce.mjs

@@ -1,2 +1,2 @@
-export { BannerType, BaseEcommerceClient, CustomerEcommerceClient, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, InventoryAuditAction, MerchantEcommerceClient, MerchantStatus, OrderStatus, PaymentMethod, PaymentStatus, ProductSortBy, ReturnStatus, ReviewSortBy, ReviewStatus, ShipmentStatus, SortOrder, TaxBehavior, TaxReportPeriodType, TaxReportStatus, TaxType, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './chunk-MVFO4WRF.mjs';
+export { BannerType, BaseEcommerceClient, CustomerEcommerceClient, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, InventoryAuditAction, MerchantEcommerceClient, MerchantStatus, OrderStatus, PaymentMethod, PaymentStatus, ProductSortBy, ReturnStatus, ReviewSortBy, ReviewStatus, ShipmentStatus, SortOrder, TaxBehavior, TaxReportPeriodType, TaxReportStatus, TaxType, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './chunk-SKX4VGEN.mjs';
 import './chunk-4UEJOM6W.mjs';

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { SpotToken, MarginTables, PerpsAssetCtx, SpotMeta, ExchangeClient, SuccessResponse, InfoClient } from '@nktkas/hyperliquid';
 import { Hex } from '@nktkas/hyperliquid/types';
 export { A as AllPerpsMeta, d as AssetIdUtils, B as BaseInstrument, I as InstrumentClient, M as MarketInstrument, c as PerpsInstrument, P as PerpsMeta, a as PerpsMetaAndAssetCtxs, b as PerpsUniverse, S as SpotInstrument, g as getAllPerpsMeta } from './client-CgmiTuEX.mjs';
-export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, FlashSale, FlashSaleItem, FlashSaleItemInput, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetCouponResponse, GetOrderResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProfileRequest, MerchantProfileResponse, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentStatus, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.mjs';
+export { ActiveFlashSalesResponse, AnalyticsOverview, ApiResponse, AppliedDiscount, Banner, BannerResponse, BannerType, BaseEcommerceClient, BaseEntity, CalculateCartDiscountsRequest, CalculateCartDiscountsResponse, CalculateShippingRequest, CalculateShippingResponse, CalculateTaxRequest, CalculateTaxResponse, CartItem, ConfirmEscrowDepositResponse, Coupon, CouponResponse, CouponUsage, CreateBannerRequest, CreateCouponRequest, CreateFlashSaleRequest, CreateOrderEventRequest, CreateOrderEventResponse, CreateOrderRequest, CreateOrderResponse, CreateProductRequest, CreateProductVariantRequest, CreateReviewRequest, CreateShippingMethodRequest, CreateShippingRateRequest, CreateShippingZoneRequest, CreateTaxNexusRequest, CreateTaxRuleRequest, CustomerEcommerceClient, CustomerMessagesResponse, CustomerSummary, DiscountMethod, DiscountScope, DiscountType, EcommerceApiError, EcommerceClientConfig, FlashSale, FlashSaleItem, FlashSaleItemInput, FollowActionResponse, FollowStatusResponse, FollowedMerchantSummary, GenerateTaxReportRequest, GetAnalyticsParams, GetAnalyticsResponse, GetCouponResponse, GetOrderResponse, GetPaymentMethodsResponse, GetProductMetricsResponse, GetProductResponse, GetTaxReportResponse, InventoryAuditAction, InventoryAuditEntry, ListActiveBannersParams, ListActiveFlashSalesParams, ListBannersResponse, ListCouponsResponse, ListCustomersParams, ListCustomersResponse, ListFollowingParams, ListFollowingResponse, ListInventoryAuditResponse, ListMediaAssetsResponse, ListMerchantProductsParams, ListMessagesResponse, ListOrdersParams, ListOrdersResponse, ListProductVariantsResponse, ListProductsParams, ListProductsResponse, ListReturnsResponse, ListReviewsParams, ListReviewsResponse, ListShipmentsResponse, ListShippingAddressesResponse, ListShippingMethodsResponse, ListShippingRatesResponse, ListShippingZonesResponse, ListTaxNexusResponse, ListTaxReportsParams, ListTaxReportsResponse, ListTaxRulesResponse, MediaAsset, MediaAssetResponse, Merchant, MerchantEcommerceClient, MerchantProductsResponse, MerchantProfileRequest, MerchantProfileResponse, MerchantShippingSettings, MerchantStatus, Message, MessageResponse, MessageStatsResponse, Order, OrderEvent, OrderItem, OrderReceiptResponse, OrderStatus, OrdersByStatus, PaginatedResponse, PaginationParams, Payment, PaymentMethod, PaymentMethodInfo, PaymentStatus, ProcessPaymentRequest, ProcessPaymentResponse, Product, ProductDimensions, ProductDiscountsResponse, ProductMetrics, ProductResponse, ProductReview, ProductSortBy, ProductVariant, ProductVariantResponse, PublicMerchantProfile, PublicMerchantProfileResponse, RecentOrderSummary, RespondToReviewRequest, Return, ReturnItem, ReturnResponse, ReturnStatus, RevenueByDay, ReviewResponse, ReviewSortBy, ReviewStatus, SendMessageRequest, Settlement, Shipment, ShipmentResponse, ShipmentStatus, ShippingAddress, ShippingAddressRequest, ShippingAddressResponse, ShippingMethod, ShippingMethodResponse, ShippingOption, ShippingRate, ShippingRateResponse, ShippingSettingsResponse, ShippingZone, ShippingZoneResponse, SortOrder, SuccessResponse, TaxBehavior, TaxBreakdownItem, TaxNexus, TaxNexusResponse, TaxReport, TaxReportDetails, TaxReportPeriodType, TaxReportResponse, TaxReportStatus, TaxRule, TaxRuleResponse, TaxSettings, TaxSettingsResponse, TaxType, TopProduct, TrackBannerRequest, UpdateBannerRequest, UpdateCouponRequest, UpdateFlashSaleRequest, UpdateOrderResponse, UpdateOrderStatusRequest, UpdateProductRequest, UpdateProductVariantRequest, UpdateShipmentRequest, UpdateShippingMethodRequest, UpdateShippingRateRequest, UpdateShippingSettingsRequest, UpdateShippingZoneRequest, UpdateTaxNexusRequest, UpdateTaxReportStatusRequest, UpdateTaxRuleRequest, UpdateTaxSettingsRequest, UserShippingAddress, ValidateDiscountRequest, ValidateDiscountResponse, buildQueryString, calculateDiscountAmount, calculateFinalPrice, formatPrice, getBackoffDelay, isRetryableError, isValidAddress, isValidEmail, parseError, retryWithBackoff, sleep, truncateAddress } from './ecommerce.mjs';
 import 'axios';
 
 declare function encodeSlug(slug: string): bigint;
@@ -527,7 +527,7 @@ declare const formatPriceForDisplay: ({ px, szDecimals, isSpot, }: {
  * @returns Formatted size as number (rounded down to szDecimals if exceeds)
  */
 declare const formatSizeForOrder: ({ sz, szDecimals, }: {
-    sz: number;
+    sz: number | string;
     szDecimals: number;
 }) => number;
 /**
@@ -597,6 +597,15 @@ interface WeekInfo {
  * @returns WeekInfo with weekNumber, startDate, and endDate
  */
 declare function getLatestCompletedWeek(currentTimestamp?: number, offset?: number, weekStartsOn?: DayOfWeek): WeekInfo;
+/**
+ * Gets week information from a week number.
+ * This is the inverse of getLatestCompletedWeek - it converts a week number to start/end dates.
+ *
+ * @param weekNumber - The week number (1-based, where week 1 starts at WEEK1_START_DATE)
+ * @param weekStartsOn - Day of week the week should start on. Defaults to Thursday.
+ * @returns WeekInfo with weekNumber, startDate, and endDate
+ */
+declare function getWeekInfoFromNumber(weekNumber: number, weekStartsOn?: DayOfWeek): WeekInfo;
 
 declare function isHip3Symbol(symbol: string | undefined): boolean;
 declare function getHip3Dex(symbol: string): string | null;
@@ -643,4 +652,4 @@ declare function isStableQuoteToken(coin: string): boolean;
 declare function getDisplayMarketSymbol(coin: string | undefined, showCollateralTokenSymbol?: boolean, collateralTokenSymbol?: string): string | undefined;
 declare function getDexFromCollateralTokenSymbol(collateralTokenSymbol: string): string | undefined;
 
-export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };
+export { type AirdropAllocationData, CloidClientCode, type CloidClientCodeId, CloidClientCodeNameById, type CloidData, DayOfWeek, type DexInfo, type ExtendedPerpsMeta, type MarketInfo, MetadataClient, PUP_TOKEN_ADDRESS, PUP_TOKEN_THRESHOLDS, type PerpDex, type PupEligibilityResult, ROOT_DEX, TARGET_APPROVED_MAX_BUILDER_FEE, TARGET_APPROVED_MAX_BUILDER_FEE_PERCENT, TESTNET_USDC_SPOT_TOKEN, type TokenInfo, USDC_SPOT_TOKEN, type UpheavalApiResponse, type UpheavalPosition, type UpheavalSnapshot, UserDexAbstractionTypes, type V3LPTokenInfo, type WeekInfo, WidgetType, WidgetTypeById, type WidgetTypeId, XP_BOOST_PERCENTAGES, buildCloid, calculateBoostPercentage, calculateTotalPupAmount, decodeSlug, enableHip3DexAbstractionWithAgent, encodeSlug, floorUtcDay, floorUtcHour, floorUtcMinutes, floorUtcWeek, formatPriceAndSize, formatPriceForDisplay, formatPriceForOrder, formatSizeForDisplay, formatSizeForOrder, getApprovalAmount, getClientCodeNameById, getCloid, getDexFromCollateralTokenSymbol, getDisplayMarketSymbol, getHip3Dex, getHip3DexAbstraction, getLatestCompletedWeek, getNextTierInfo, getPriceDecimals, getStaticCollateralTokenByDex, getStaticCollateralTokenSymbol, getWeekInfoFromNumber, getWidgetTypeById, isBasedCloid, isClientCode, isHip3Symbol, isMiniAppCloid, isMiniAppTriggeredCloid, isSpotSymbol, isStableQuoteToken, isTenantCloid, isTrackingIdCloid, isWidgetType, makeUtcRounder, normaliseSlug, normaliseTrackingId, normalizeAirdropAmount, parseCloid, setHip3DexAbstraction, stableQuoteTokens };