omni-sync-sdk 0.14.3 → 0.16.0

package/README.md

@@ -16,6 +16,39 @@ yarn add omni-sync-sdk
 
 ---
 
+## Quick Reference - Helper Functions
+
+The SDK exports these utility functions for common UI tasks:
+
+| Function                                       | Purpose                                | Example                                        |
+| ---------------------------------------------- | -------------------------------------- | ---------------------------------------------- |
+| `formatPrice(amount, currency?, locale?)`      | Format prices for display              | `formatPrice(99.99, 'USD')` → `$99.99`         |
+| `getPriceDisplay(amount, currency?, locale?)`  | Alias for `formatPrice`                | Same as above                                  |
+| `getDescriptionContent(product)`               | Get product description (HTML or text) | `getDescriptionContent(product)`               |
+| `isHtmlDescription(product)`                   | Check if description is HTML           | `isHtmlDescription(product)` → `true/false`    |
+| `getStockStatus(variant)`                      | Get human-readable stock status        | `getStockStatus(variant)` → `"In Stock"`       |
+| `isCouponApplicableToProduct(coupon, product)` | Check if coupon applies                | `isCouponApplicableToProduct(coupon, product)` |
+
+```typescript
+import {
+  formatPrice,
+  getPriceDisplay, // Alias for formatPrice
+  getDescriptionContent,
+  getStockStatus,
+} from 'omni-sync-sdk';
+
+// Format price for display
+const priceText = formatPrice(product.basePrice, 'USD'); // "$99.99"
+
+// Get product description (handles HTML vs plain text)
+const description = getDescriptionContent(product);
+
+// Get stock status text
+const stockText = getStockStatus(product.variants[0]); // "In Stock", "Low Stock", "Out of Stock"
+```
+
+---
+
 ## ⚠️ CRITICAL: Payment Integration Required!
 
 **Your store will NOT work without payment integration.** The store owner has already configured payment providers (Stripe/PayPal) - you just need to implement the payment page.
@@ -1349,9 +1382,74 @@ if (error) {
 }
 ```
 
-#### Check Payment Status
+#### After Payment: Success Page Pattern (Recommended)
+
+**Important:** Orders are created asynchronously via webhook after Stripe confirms payment.
+This typically takes 1-5 seconds, but can vary. Follow these best practices:
+
+**Option 1: Optimistic Success Page (Recommended - Used by Amazon, Shopify, AliExpress)**
+
+Show success immediately without waiting for orderId. This is the industry standard:
+
+```typescript
+// In your payment form, after stripe.confirmPayment() succeeds:
+const { error } = await stripe.confirmPayment({
+  elements,
+  confirmParams: {
+    return_url: `${window.location.origin}/checkout/success?checkout_id=${checkout.id}`,
+  },
+});
+
+// On /checkout/success page - show confirmation IMMEDIATELY:
+export default function CheckoutSuccessPage() {
+  const checkoutId = new URLSearchParams(window.location.search).get('checkout_id');
+
+  return (
+    <div className="text-center py-12">
+      <h1 className="text-2xl font-bold text-green-600">Payment Received!</h1>
+      <p className="mt-4">Your order is being processed.</p>
+      <p className="mt-2 text-gray-600">
+        Confirmation #{checkoutId?.slice(-8).toUpperCase()}
+      </p>
+      <p className="mt-4">A confirmation email will be sent shortly.</p>
+      <a href="/orders" className="mt-6 inline-block text-blue-600">
+        View Your Orders →
+      </a>
+    </div>
+  );
+}
+```
+
+**Option 2: Wait for Order (For SPAs that need orderId)**
+
+Use `waitForOrder()` to poll in the background with exponential backoff:
+
+```typescript
+// After payment succeeds, wait for order creation (max 30 seconds)
+const result = await omni.waitForOrder(checkout.id, {
+  maxWaitMs: 30000, // 30 seconds max
+  onPollAttempt: (attempt, status) => {
+    console.log(`Checking order status... (attempt ${attempt})`);
+  },
+  onOrderReady: (status) => {
+    // Called immediately when order is created
+    console.log('Order ready:', status.orderNumber);
+  },
+});
+
+if (result.success) {
+  // Order was created within timeout
+  window.location.href = `/orders/${result.status.orderId}`;
+} else {
+  // Order not created yet - show optimistic success anyway
+  // The email will be sent when order is ready
+  showSuccessMessage('Payment received! Order confirmation coming soon.');
+}
+```
+
+**Option 3: Simple Status Check (Single poll)**
 
-After redirect or for polling:
+For simple use cases where you just want to check once:
 
 ```typescript
 const status = await omni.getPaymentStatus(checkout.id);
@@ -1359,17 +1457,27 @@ const status = await omni.getPaymentStatus(checkout.id);
 // Returns:
 // {
 //   checkoutId: 'checkout_xxx',
-//   status: 'succeeded' | 'pending' | 'failed',
-//   orderId: 'order_xxx',      // Only if payment succeeded
-//   orderNumber: 'ORD-123',    // Only if payment succeeded
+//   status: 'succeeded' | 'pending' | 'failed' | 'canceled',
+//   orderId: 'order_xxx',      // Only if order was created
+//   orderNumber: 'ORD-123',    // Only if order was created
 //   error: 'Payment declined'  // Only if payment failed
 // }
 
-if (status.status === 'succeeded') {
+if (status.status === 'succeeded' && status.orderId) {
   window.location.href = `/order-confirmation/${status.orderId}`;
+} else if (status.status === 'succeeded') {
+  // Payment succeeded but order not created yet
+  showMessage('Payment received, processing your order...');
+} else if (status.status === 'failed') {
+  showError(status.error || 'Payment failed');
 }
 ```
 
+> **Why Optimistic Success?** Stripe webhooks typically arrive within 1-5 seconds,
+> but network issues can cause delays. Major e-commerce platforms (Amazon, Shopify)
+> show success immediately and send order details via email. This provides better UX
+> than making customers wait on a loading screen.
+
 #### Complete Checkout with Payment Example
 
 ```typescript

package/dist/index.d.mts

@@ -1263,12 +1263,13 @@ interface ShippingRate {
 /**
  * Represents a checkout session for completing a purchase.
  *
- * **Checkout Flow:**
- * 1. Create checkout from cart: `createCheckout({ cartId })`
- * 2. Set customer info: `setCheckoutCustomer(id, { email, ... })`
- * 3. Set shipping address: `setShippingAddress(id, address)` - returns available rates
- * 4. Select shipping method: `selectShippingMethod(id, rateId)`
- * 5. Complete checkout: `completeCheckout(id)` - creates the order
+ * **Simplified Checkout Flow (3 steps):**
+ * 1. Set shipping address (includes email): `setShippingAddress(id, { email, ...address })` - returns rates
+ * 2. Select shipping method: `selectShippingMethod(id, rateId)`
+ * 3. Pay with Stripe: `createPaymentIntent(id)` → `stripe.confirmPayment()` → Order created automatically!
+ *
+ * **Note:** Order is created automatically via webhook when payment succeeds.
+ * No need to call `completeCheckout()` - it happens automatically.
  *
  * **IMPORTANT: Price fields are strings**
  * All monetary fields (subtotal, discountAmount, shippingAmount, taxAmount, total)
@@ -1367,7 +1368,13 @@ interface SetCheckoutCustomerDto {
     phone?: string;
     acceptsMarketing?: boolean;
 }
+/**
+ * Shipping address with customer email (required for checkout).
+ * Email is included here to simplify the checkout flow - no need for separate setCheckoutCustomer call.
+ */
 interface SetShippingAddressDto {
+    /** Customer email (required) - used for order confirmation */
+    email: string;
     firstName: string;
     lastName: string;
     company?: string;
@@ -1378,8 +1385,23 @@ interface SetShippingAddressDto {
     postalCode: string;
     country: string;
     phone?: string;
+    /** Whether customer accepts marketing emails */
+    acceptsMarketing?: boolean;
 }
-interface SetBillingAddressDto extends SetShippingAddressDto {
+/**
+ * Billing address (email not required - already set in shipping address)
+ */
+interface SetBillingAddressDto {
+    firstName: string;
+    lastName: string;
+    company?: string;
+    line1: string;
+    line2?: string;
+    city: string;
+    region?: string;
+    postalCode: string;
+    country: string;
+    phone?: string;
     sameAsShipping?: boolean;
 }
 interface SelectShippingMethodDto {
@@ -1774,6 +1796,46 @@ interface PaymentStatus {
     /** Payment intent ID from provider */
     paymentIntentId?: string;
 }
+/**
+ * Options for waitForOrder method.
+ * Used when polling for order creation after payment.
+ */
+interface WaitForOrderOptions {
+    /**
+     * Maximum time to wait in milliseconds.
+     * Default: 30000 (30 seconds)
+     */
+    maxWaitMs?: number;
+    /**
+     * Initial delay between polls in milliseconds.
+     * Uses exponential backoff: 1s → 2s → 4s → 8s...
+     * Default: 1000 (1 second)
+     */
+    initialDelayMs?: number;
+    /**
+     * Callback fired when order is ready.
+     * Useful for updating UI without awaiting the full promise.
+     */
+    onOrderReady?: (status: PaymentStatus) => void;
+    /**
+     * Callback fired on each poll attempt.
+     * Useful for showing loading progress.
+     */
+    onPollAttempt?: (attempt: number, status: PaymentStatus) => void;
+}
+/**
+ * Result from waitForOrder method.
+ */
+interface WaitForOrderResult {
+    /** Whether the order was created within the timeout */
+    success: boolean;
+    /** Final payment status */
+    status: PaymentStatus;
+    /** Number of poll attempts made */
+    attempts: number;
+    /** Total time waited in milliseconds */
+    waitedMs: number;
+}
 /**
  * When inventory is reserved for customers.
  * Configured per vibe-coded connection by the store owner.
@@ -2965,12 +3027,16 @@ declare class OmniSyncClient {
      */
     setCheckoutCustomer(checkoutId: string, data: SetCheckoutCustomerDto): Promise<Checkout>;
     /**
-     * Set shipping address on checkout
-     * Returns the checkout and available shipping rates for the address
+     * Set shipping address on checkout (includes customer email).
+     * Returns the checkout and available shipping rates for the address.
+     *
+     * **This is the first step of the simplified checkout flow.**
+     * Email is required and will be used for order confirmation.
      *
      * @example
      * ```typescript
      * const { checkout, rates } = await omni.setShippingAddress('checkout_123', {
+     *   email: 'customer@example.com',  // Required!
      *   firstName: 'John',
      *   lastName: 'Doe',
      *   line1: '123 Main St',
@@ -3161,6 +3227,61 @@ declare class OmniSyncClient {
      * ```
      */
     getPaymentStatus(checkoutId: string): Promise<PaymentStatus>;
+    /**
+     * Wait for order creation after payment.
+     *
+     * **Important:** This is an optional utility for SPA apps that want to update the UI
+     * when the order is ready. For most use cases, you should show a success message
+     * immediately after payment and let the customer check their email or orders page.
+     *
+     * **Best Practice (Optimistic Success Page):**
+     * ```typescript
+     * // After stripe.confirmPayment() succeeds, redirect to success page immediately
+     * // Don't wait for orderId - show confirmation with checkoutId
+     * window.location.href = `/checkout/success?checkout_id=${checkoutId}`;
+     *
+     * // On success page, show "Payment received!" immediately
+     * // The order confirmation email will be sent automatically
+     * ```
+     *
+     * **When to use waitForOrder:**
+     * - SPA apps that want to show the order number without page reload
+     * - Apps that need the orderId for analytics or tracking
+     *
+     * **Vibe-coded mode only** - requires connectionId
+     *
+     * @param checkoutId - The checkout ID to wait for order creation
+     * @param options - Polling options (maxWaitMs, initialDelayMs, callbacks)
+     * @returns Result with success status, final payment status, and timing info
+     *
+     * @example
+     * ```typescript
+     * // Basic usage - wait up to 30 seconds
+     * const result = await omni.waitForOrder(checkoutId);
+     *
+     * if (result.success) {
+     *   console.log('Order created:', result.status.orderNumber);
+     * } else {
+     *   // Order not created yet - show success message anyway
+     *   console.log('Payment received, order is being processed...');
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With progress callback for UI updates
+     * const result = await omni.waitForOrder(checkoutId, {
+     *   maxWaitMs: 20000,
+     *   onPollAttempt: (attempt, status) => {
+     *     setLoadingMessage(`Confirming order... (attempt ${attempt})`);
+     *   },
+     *   onOrderReady: (status) => {
+     *     toast.success(`Order ${status.orderNumber} confirmed!`);
+     *   },
+     * });
+     * ```
+     */
+    waitForOrder(checkoutId: string, options?: WaitForOrderOptions): Promise<WaitForOrderResult>;
     private readonly LOCAL_CART_KEY;
     /**
      * Check if localStorage is available (browser environment)
@@ -3628,4 +3749,4 @@ declare function isWebhookEventType(event: WebhookEvent, type: WebhookEventType)
  */
 declare function createWebhookHandler(handlers: Partial<Record<WebhookEventType, (event: WebhookEvent) => Promise<void>>>): (payload: unknown) => Promise<void>;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, formatPrice as getPriceDisplay, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts

@@ -1263,12 +1263,13 @@ interface ShippingRate {
 /**
  * Represents a checkout session for completing a purchase.
  *
- * **Checkout Flow:**
- * 1. Create checkout from cart: `createCheckout({ cartId })`
- * 2. Set customer info: `setCheckoutCustomer(id, { email, ... })`
- * 3. Set shipping address: `setShippingAddress(id, address)` - returns available rates
- * 4. Select shipping method: `selectShippingMethod(id, rateId)`
- * 5. Complete checkout: `completeCheckout(id)` - creates the order
+ * **Simplified Checkout Flow (3 steps):**
+ * 1. Set shipping address (includes email): `setShippingAddress(id, { email, ...address })` - returns rates
+ * 2. Select shipping method: `selectShippingMethod(id, rateId)`
+ * 3. Pay with Stripe: `createPaymentIntent(id)` → `stripe.confirmPayment()` → Order created automatically!
+ *
+ * **Note:** Order is created automatically via webhook when payment succeeds.
+ * No need to call `completeCheckout()` - it happens automatically.
  *
  * **IMPORTANT: Price fields are strings**
  * All monetary fields (subtotal, discountAmount, shippingAmount, taxAmount, total)
@@ -1367,7 +1368,13 @@ interface SetCheckoutCustomerDto {
     phone?: string;
     acceptsMarketing?: boolean;
 }
+/**
+ * Shipping address with customer email (required for checkout).
+ * Email is included here to simplify the checkout flow - no need for separate setCheckoutCustomer call.
+ */
 interface SetShippingAddressDto {
+    /** Customer email (required) - used for order confirmation */
+    email: string;
     firstName: string;
     lastName: string;
     company?: string;
@@ -1378,8 +1385,23 @@ interface SetShippingAddressDto {
     postalCode: string;
     country: string;
     phone?: string;
+    /** Whether customer accepts marketing emails */
+    acceptsMarketing?: boolean;
 }
-interface SetBillingAddressDto extends SetShippingAddressDto {
+/**
+ * Billing address (email not required - already set in shipping address)
+ */
+interface SetBillingAddressDto {
+    firstName: string;
+    lastName: string;
+    company?: string;
+    line1: string;
+    line2?: string;
+    city: string;
+    region?: string;
+    postalCode: string;
+    country: string;
+    phone?: string;
     sameAsShipping?: boolean;
 }
 interface SelectShippingMethodDto {
@@ -1774,6 +1796,46 @@ interface PaymentStatus {
     /** Payment intent ID from provider */
     paymentIntentId?: string;
 }
+/**
+ * Options for waitForOrder method.
+ * Used when polling for order creation after payment.
+ */
+interface WaitForOrderOptions {
+    /**
+     * Maximum time to wait in milliseconds.
+     * Default: 30000 (30 seconds)
+     */
+    maxWaitMs?: number;
+    /**
+     * Initial delay between polls in milliseconds.
+     * Uses exponential backoff: 1s → 2s → 4s → 8s...
+     * Default: 1000 (1 second)
+     */
+    initialDelayMs?: number;
+    /**
+     * Callback fired when order is ready.
+     * Useful for updating UI without awaiting the full promise.
+     */
+    onOrderReady?: (status: PaymentStatus) => void;
+    /**
+     * Callback fired on each poll attempt.
+     * Useful for showing loading progress.
+     */
+    onPollAttempt?: (attempt: number, status: PaymentStatus) => void;
+}
+/**
+ * Result from waitForOrder method.
+ */
+interface WaitForOrderResult {
+    /** Whether the order was created within the timeout */
+    success: boolean;
+    /** Final payment status */
+    status: PaymentStatus;
+    /** Number of poll attempts made */
+    attempts: number;
+    /** Total time waited in milliseconds */
+    waitedMs: number;
+}
 /**
  * When inventory is reserved for customers.
  * Configured per vibe-coded connection by the store owner.
@@ -2965,12 +3027,16 @@ declare class OmniSyncClient {
      */
     setCheckoutCustomer(checkoutId: string, data: SetCheckoutCustomerDto): Promise<Checkout>;
     /**
-     * Set shipping address on checkout
-     * Returns the checkout and available shipping rates for the address
+     * Set shipping address on checkout (includes customer email).
+     * Returns the checkout and available shipping rates for the address.
+     *
+     * **This is the first step of the simplified checkout flow.**
+     * Email is required and will be used for order confirmation.
      *
      * @example
      * ```typescript
      * const { checkout, rates } = await omni.setShippingAddress('checkout_123', {
+     *   email: 'customer@example.com',  // Required!
      *   firstName: 'John',
      *   lastName: 'Doe',
      *   line1: '123 Main St',
@@ -3161,6 +3227,61 @@ declare class OmniSyncClient {
      * ```
      */
     getPaymentStatus(checkoutId: string): Promise<PaymentStatus>;
+    /**
+     * Wait for order creation after payment.
+     *
+     * **Important:** This is an optional utility for SPA apps that want to update the UI
+     * when the order is ready. For most use cases, you should show a success message
+     * immediately after payment and let the customer check their email or orders page.
+     *
+     * **Best Practice (Optimistic Success Page):**
+     * ```typescript
+     * // After stripe.confirmPayment() succeeds, redirect to success page immediately
+     * // Don't wait for orderId - show confirmation with checkoutId
+     * window.location.href = `/checkout/success?checkout_id=${checkoutId}`;
+     *
+     * // On success page, show "Payment received!" immediately
+     * // The order confirmation email will be sent automatically
+     * ```
+     *
+     * **When to use waitForOrder:**
+     * - SPA apps that want to show the order number without page reload
+     * - Apps that need the orderId for analytics or tracking
+     *
+     * **Vibe-coded mode only** - requires connectionId
+     *
+     * @param checkoutId - The checkout ID to wait for order creation
+     * @param options - Polling options (maxWaitMs, initialDelayMs, callbacks)
+     * @returns Result with success status, final payment status, and timing info
+     *
+     * @example
+     * ```typescript
+     * // Basic usage - wait up to 30 seconds
+     * const result = await omni.waitForOrder(checkoutId);
+     *
+     * if (result.success) {
+     *   console.log('Order created:', result.status.orderNumber);
+     * } else {
+     *   // Order not created yet - show success message anyway
+     *   console.log('Payment received, order is being processed...');
+     * }
+     * ```
+     *
+     * @example
+     * ```typescript
+     * // With progress callback for UI updates
+     * const result = await omni.waitForOrder(checkoutId, {
+     *   maxWaitMs: 20000,
+     *   onPollAttempt: (attempt, status) => {
+     *     setLoadingMessage(`Confirming order... (attempt ${attempt})`);
+     *   },
+     *   onOrderReady: (status) => {
+     *     toast.success(`Order ${status.orderNumber} confirmed!`);
+     *   },
+     * });
+     * ```
+     */
+    waitForOrder(checkoutId: string, options?: WaitForOrderOptions): Promise<WaitForOrderResult>;
     private readonly LOCAL_CART_KEY;
     /**
      * Check if localStorage is available (browser environment)
@@ -3628,4 +3749,4 @@ declare function isWebhookEventType(event: WebhookEvent, type: WebhookEventType)
  */
 declare function createWebhookHandler(handlers: Partial<Record<WebhookEventType, (event: WebhookEvent) => Promise<void>>>): (payload: unknown) => Promise<void>;
 
-export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateGuestOrderDto, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, 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 DraftLineItem, type EditInventoryDto, type EmailVerificationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncJob, type UpdateAddressDto, type UpdateCartItemDto, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateInventoryDto, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateVariantDto, type UpdateVariantInventoryDto, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getDescriptionContent, formatPrice as getPriceDisplay, getStockStatus, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.js

@@ -25,6 +25,7 @@ __export(index_exports, {
   createWebhookHandler: () => createWebhookHandler,
   formatPrice: () => formatPrice,
   getDescriptionContent: () => getDescriptionContent,
+  getPriceDisplay: () => formatPrice,
   getStockStatus: () => getStockStatus,
   isCouponApplicableToProduct: () => isCouponApplicableToProduct,
   isHtmlDescription: () => isHtmlDescription,
@@ -1897,12 +1898,16 @@ var OmniSyncClient = class {
     return this.adminRequest("PATCH", `/api/v1/checkout/${checkoutId}/customer`, data);
   }
   /**
-   * Set shipping address on checkout
-   * Returns the checkout and available shipping rates for the address
+   * Set shipping address on checkout (includes customer email).
+   * Returns the checkout and available shipping rates for the address.
+   *
+   * **This is the first step of the simplified checkout flow.**
+   * Email is required and will be used for order confirmation.
    *
    * @example
    * ```typescript
    * const { checkout, rates } = await omni.setShippingAddress('checkout_123', {
+   *   email: 'customer@example.com',  // Required!
    *   firstName: 'John',
    *   lastName: 'Doe',
    *   line1: '123 Main St',
@@ -2215,6 +2220,109 @@ var OmniSyncClient = class {
     }
     return this.vibeCodedRequest("GET", `/checkout/${checkoutId}/payment-status`);
   }
+  /**
+   * Wait for order creation after payment.
+   *
+   * **Important:** This is an optional utility for SPA apps that want to update the UI
+   * when the order is ready. For most use cases, you should show a success message
+   * immediately after payment and let the customer check their email or orders page.
+   *
+   * **Best Practice (Optimistic Success Page):**
+   * ```typescript
+   * // After stripe.confirmPayment() succeeds, redirect to success page immediately
+   * // Don't wait for orderId - show confirmation with checkoutId
+   * window.location.href = `/checkout/success?checkout_id=${checkoutId}`;
+   *
+   * // On success page, show "Payment received!" immediately
+   * // The order confirmation email will be sent automatically
+   * ```
+   *
+   * **When to use waitForOrder:**
+   * - SPA apps that want to show the order number without page reload
+   * - Apps that need the orderId for analytics or tracking
+   *
+   * **Vibe-coded mode only** - requires connectionId
+   *
+   * @param checkoutId - The checkout ID to wait for order creation
+   * @param options - Polling options (maxWaitMs, initialDelayMs, callbacks)
+   * @returns Result with success status, final payment status, and timing info
+   *
+   * @example
+   * ```typescript
+   * // Basic usage - wait up to 30 seconds
+   * const result = await omni.waitForOrder(checkoutId);
+   *
+   * if (result.success) {
+   *   console.log('Order created:', result.status.orderNumber);
+   * } else {
+   *   // Order not created yet - show success message anyway
+   *   console.log('Payment received, order is being processed...');
+   * }
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // With progress callback for UI updates
+   * const result = await omni.waitForOrder(checkoutId, {
+   *   maxWaitMs: 20000,
+   *   onPollAttempt: (attempt, status) => {
+   *     setLoadingMessage(`Confirming order... (attempt ${attempt})`);
+   *   },
+   *   onOrderReady: (status) => {
+   *     toast.success(`Order ${status.orderNumber} confirmed!`);
+   *   },
+   * });
+   * ```
+   */
+  async waitForOrder(checkoutId, options) {
+    if (!this.isVibeCodedMode()) {
+      throw new OmniSyncError(
+        "waitForOrder is only available in vibe-coded mode (use connectionId)",
+        400
+      );
+    }
+    const maxWaitMs = options?.maxWaitMs ?? 3e4;
+    const initialDelayMs = options?.initialDelayMs ?? 1e3;
+    const startTime = Date.now();
+    let attempts = 0;
+    let currentDelay = initialDelayMs;
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    while (Date.now() - startTime < maxWaitMs) {
+      attempts++;
+      const status = await this.getPaymentStatus(checkoutId);
+      options?.onPollAttempt?.(attempts, status);
+      if (status.status === "failed" || status.status === "canceled") {
+        return {
+          success: false,
+          status,
+          attempts,
+          waitedMs: Date.now() - startTime
+        };
+      }
+      if (status.status === "succeeded" && status.orderId) {
+        options?.onOrderReady?.(status);
+        return {
+          success: true,
+          status,
+          attempts,
+          waitedMs: Date.now() - startTime
+        };
+      }
+      const remainingTime = maxWaitMs - (Date.now() - startTime);
+      const sleepTime = Math.min(currentDelay, remainingTime, 8e3);
+      if (sleepTime > 0) {
+        await sleep(sleepTime);
+        currentDelay = Math.min(currentDelay * 2, 8e3);
+      }
+    }
+    const finalStatus = await this.getPaymentStatus(checkoutId);
+    return {
+      success: finalStatus.status === "succeeded" && !!finalStatus.orderId,
+      status: finalStatus,
+      attempts,
+      waitedMs: Date.now() - startTime
+    };
+  }
   /**
    * Check if localStorage is available (browser environment)
    */
@@ -2449,7 +2557,11 @@ var OmniSyncClient = class {
       const trackingResult = await this.startGuestCheckout();
       if (trackingResult.tracked) {
         await this.updateGuestCheckoutAddress(trackingResult.checkoutId, {
-          shippingAddress: cart.shippingAddress,
+          shippingAddress: {
+            ...cart.shippingAddress,
+            email: cart.customer.email
+            // Already validated above
+          },
           billingAddress: cart.billingAddress
         });
         const orderResult = await this.completeGuestCheckout(trackingResult.checkoutId, {
@@ -3110,6 +3222,7 @@ function isCouponApplicableToProduct(coupon, productId, productCategoryIds) {
   createWebhookHandler,
   formatPrice,
   getDescriptionContent,
+  getPriceDisplay,
   getStockStatus,
   isCouponApplicableToProduct,
   isHtmlDescription,

package/dist/index.mjs

@@ -1868,12 +1868,16 @@ var OmniSyncClient = class {
     return this.adminRequest("PATCH", `/api/v1/checkout/${checkoutId}/customer`, data);
   }
   /**
-   * Set shipping address on checkout
-   * Returns the checkout and available shipping rates for the address
+   * Set shipping address on checkout (includes customer email).
+   * Returns the checkout and available shipping rates for the address.
+   *
+   * **This is the first step of the simplified checkout flow.**
+   * Email is required and will be used for order confirmation.
    *
    * @example
    * ```typescript
    * const { checkout, rates } = await omni.setShippingAddress('checkout_123', {
+   *   email: 'customer@example.com',  // Required!
    *   firstName: 'John',
    *   lastName: 'Doe',
    *   line1: '123 Main St',
@@ -2186,6 +2190,109 @@ var OmniSyncClient = class {
     }
     return this.vibeCodedRequest("GET", `/checkout/${checkoutId}/payment-status`);
   }
+  /**
+   * Wait for order creation after payment.
+   *
+   * **Important:** This is an optional utility for SPA apps that want to update the UI
+   * when the order is ready. For most use cases, you should show a success message
+   * immediately after payment and let the customer check their email or orders page.
+   *
+   * **Best Practice (Optimistic Success Page):**
+   * ```typescript
+   * // After stripe.confirmPayment() succeeds, redirect to success page immediately
+   * // Don't wait for orderId - show confirmation with checkoutId
+   * window.location.href = `/checkout/success?checkout_id=${checkoutId}`;
+   *
+   * // On success page, show "Payment received!" immediately
+   * // The order confirmation email will be sent automatically
+   * ```
+   *
+   * **When to use waitForOrder:**
+   * - SPA apps that want to show the order number without page reload
+   * - Apps that need the orderId for analytics or tracking
+   *
+   * **Vibe-coded mode only** - requires connectionId
+   *
+   * @param checkoutId - The checkout ID to wait for order creation
+   * @param options - Polling options (maxWaitMs, initialDelayMs, callbacks)
+   * @returns Result with success status, final payment status, and timing info
+   *
+   * @example
+   * ```typescript
+   * // Basic usage - wait up to 30 seconds
+   * const result = await omni.waitForOrder(checkoutId);
+   *
+   * if (result.success) {
+   *   console.log('Order created:', result.status.orderNumber);
+   * } else {
+   *   // Order not created yet - show success message anyway
+   *   console.log('Payment received, order is being processed...');
+   * }
+   * ```
+   *
+   * @example
+   * ```typescript
+   * // With progress callback for UI updates
+   * const result = await omni.waitForOrder(checkoutId, {
+   *   maxWaitMs: 20000,
+   *   onPollAttempt: (attempt, status) => {
+   *     setLoadingMessage(`Confirming order... (attempt ${attempt})`);
+   *   },
+   *   onOrderReady: (status) => {
+   *     toast.success(`Order ${status.orderNumber} confirmed!`);
+   *   },
+   * });
+   * ```
+   */
+  async waitForOrder(checkoutId, options) {
+    if (!this.isVibeCodedMode()) {
+      throw new OmniSyncError(
+        "waitForOrder is only available in vibe-coded mode (use connectionId)",
+        400
+      );
+    }
+    const maxWaitMs = options?.maxWaitMs ?? 3e4;
+    const initialDelayMs = options?.initialDelayMs ?? 1e3;
+    const startTime = Date.now();
+    let attempts = 0;
+    let currentDelay = initialDelayMs;
+    const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+    while (Date.now() - startTime < maxWaitMs) {
+      attempts++;
+      const status = await this.getPaymentStatus(checkoutId);
+      options?.onPollAttempt?.(attempts, status);
+      if (status.status === "failed" || status.status === "canceled") {
+        return {
+          success: false,
+          status,
+          attempts,
+          waitedMs: Date.now() - startTime
+        };
+      }
+      if (status.status === "succeeded" && status.orderId) {
+        options?.onOrderReady?.(status);
+        return {
+          success: true,
+          status,
+          attempts,
+          waitedMs: Date.now() - startTime
+        };
+      }
+      const remainingTime = maxWaitMs - (Date.now() - startTime);
+      const sleepTime = Math.min(currentDelay, remainingTime, 8e3);
+      if (sleepTime > 0) {
+        await sleep(sleepTime);
+        currentDelay = Math.min(currentDelay * 2, 8e3);
+      }
+    }
+    const finalStatus = await this.getPaymentStatus(checkoutId);
+    return {
+      success: finalStatus.status === "succeeded" && !!finalStatus.orderId,
+      status: finalStatus,
+      attempts,
+      waitedMs: Date.now() - startTime
+    };
+  }
   /**
    * Check if localStorage is available (browser environment)
    */
@@ -2420,7 +2527,11 @@ var OmniSyncClient = class {
       const trackingResult = await this.startGuestCheckout();
       if (trackingResult.tracked) {
         await this.updateGuestCheckoutAddress(trackingResult.checkoutId, {
-          shippingAddress: cart.shippingAddress,
+          shippingAddress: {
+            ...cart.shippingAddress,
+            email: cart.customer.email
+            // Already validated above
+          },
           billingAddress: cart.billingAddress
         });
         const orderResult = await this.completeGuestCheckout(trackingResult.checkoutId, {
@@ -3080,6 +3191,7 @@ export {
   createWebhookHandler,
   formatPrice,
   getDescriptionContent,
+  formatPrice as getPriceDisplay,
   getStockStatus,
   isCouponApplicableToProduct,
   isHtmlDescription,

package/package.json

@@ -1,76 +1,76 @@
-{
-  "name": "omni-sync-sdk",
-  "version": "0.14.3",
-  "description": "Official SDK for building e-commerce storefronts with OmniSync Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
-  "main": "dist/index.js",
-  "module": "dist/index.mjs",
-  "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "require": "./dist/index.js",
-      "import": "./dist/index.mjs"
-    }
-  },
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "lint": "eslint \"src/**/*.ts\"",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "prepublishOnly": "pnpm build"
-  },
-  "keywords": [
-    "omni-sync",
-    "e-commerce",
-    "ecommerce",
-    "sdk",
-    "vibe-coding",
-    "vibe-coded",
-    "ai-commerce",
-    "storefront",
-    "headless-commerce",
-    "multi-platform",
-    "shopify",
-    "tiktok",
-    "cursor",
-    "lovable",
-    "v0",
-    "cart",
-    "checkout",
-    "products",
-    "sync"
-  ],
-  "author": "Omni-Sync Platform",
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/omni-sync/omni-sync-platform.git",
-    "directory": "packages/sdk"
-  },
-  "homepage": "https://omni-sync.com",
-  "bugs": {
-    "url": "https://github.com/omni-sync/omni-sync-platform/issues"
-  },
-  "devDependencies": {
-    "@types/node": "^25.0.3",
-    "@typescript-eslint/eslint-plugin": "^8.50.1",
-    "@typescript-eslint/parser": "^8.50.1",
-    "eslint": "^9.39.2",
-    "tsup": "^8.0.0",
-    "typescript": "^5.3.0",
-    "vitest": "^1.0.0"
-  },
-  "peerDependencies": {
-    "typescript": ">=4.7.0"
-  },
-  "peerDependenciesMeta": {
-    "typescript": {
-      "optional": true
-    }
-  }
-}
+{
+  "name": "omni-sync-sdk",
+  "version": "0.16.0",
+  "description": "Official SDK for building e-commerce storefronts with OmniSync Platform. Perfect for vibe-coded sites, AI-built stores (Cursor, Lovable, v0), and custom storefronts.",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "eslint \"src/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "omni-sync",
+    "e-commerce",
+    "ecommerce",
+    "sdk",
+    "vibe-coding",
+    "vibe-coded",
+    "ai-commerce",
+    "storefront",
+    "headless-commerce",
+    "multi-platform",
+    "shopify",
+    "tiktok",
+    "cursor",
+    "lovable",
+    "v0",
+    "cart",
+    "checkout",
+    "products",
+    "sync"
+  ],
+  "author": "Omni-Sync Platform",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/omni-sync/omni-sync-platform.git",
+    "directory": "packages/sdk"
+  },
+  "homepage": "https://omni-sync.com",
+  "bugs": {
+    "url": "https://github.com/omni-sync/omni-sync-platform/issues"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.3",
+    "@typescript-eslint/eslint-plugin": "^8.50.1",
+    "@typescript-eslint/parser": "^8.50.1",
+    "eslint": "^9.39.2",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0",
+    "vitest": "^1.0.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.7.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  }
+}