omni-sync-sdk 0.6.1 → 0.7.0

package/README.md

@@ -212,6 +212,7 @@ interface Product {
   id: string;
   name: string;
   description?: string | null;
+  descriptionFormat?: 'text' | 'html' | 'markdown'; // Format of description content
   sku: string;
   basePrice: number;
   salePrice?: number | null;
@@ -249,6 +250,31 @@ interface InventoryInfo {
 }
 ```
 
+#### Rendering Product Descriptions
+
+**IMPORTANT**: Product descriptions may contain HTML (from Shopify/WooCommerce) or plain text. Always check `descriptionFormat` before rendering:
+
+```tsx
+// Correct way to render product descriptions
+{
+  product.description &&
+    (product.descriptionFormat === 'html' ? (
+      // HTML content from Shopify/WooCommerce - render as HTML
+      <div dangerouslySetInnerHTML={{ __html: product.description }} />
+    ) : (
+      // Plain text - render normally
+      <p>{product.description}</p>
+    ));
+}
+```
+
+| Source Platform | descriptionFormat | Rendering                     |
+| --------------- | ----------------- | ----------------------------- |
+| Shopify         | `'html'`          | Use `dangerouslySetInnerHTML` |
+| WooCommerce     | `'html'`          | Use `dangerouslySetInnerHTML` |
+| TikTok          | `'text'`          | Render as plain text          |
+| Manual entry    | `'text'`          | Render as plain text          |
+
 ---
 
 ### Local Cart (Guest Users) - RECOMMENDED
@@ -472,6 +498,76 @@ interface GuestOrderResponse {
 
 ---
 
+### Tracked Guest Checkout (Optional)
+
+By default, guest checkouts are stored only in localStorage until the order is placed. If you want the store admin to see checkout sessions and abandoned carts, you can enable **Guest Checkout Tracking** in the connection settings.
+
+When enabled, checkout sessions are created on the server, allowing:
+- Visibility of checkout sessions in admin dashboard
+- Abandoned cart tracking
+- Future: abandoned cart recovery emails
+
+#### Check if Tracking is Available
+
+```typescript
+// When customer goes to checkout page
+const result = await omni.startGuestCheckout();
+
+if (result.tracked) {
+  // Tracking is enabled - use tracked flow
+  console.log('Checkout session created:', result.checkoutId);
+} else {
+  // Tracking not enabled - use regular flow
+  console.log('Using local-only checkout');
+}
+```
+
+#### Tracked Checkout Flow
+
+```typescript
+// 1. Start tracked checkout (sends cart items to server)
+const checkout = await omni.startGuestCheckout();
+
+if (checkout.tracked) {
+  // 2. Update with shipping address
+  await omni.updateGuestCheckoutAddress(checkout.checkoutId, {
+    shippingAddress: {
+      firstName: 'John',
+      lastName: 'Doe',
+      line1: '123 Main St',
+      city: 'New York',
+      postalCode: '10001',
+      country: 'US',
+    },
+  });
+
+  // 3. Complete the checkout
+  const order = await omni.completeGuestCheckout(checkout.checkoutId);
+  console.log('Order created:', order.orderId);
+} else {
+  // Fallback to regular guest checkout
+  const order = await omni.submitGuestOrder();
+}
+```
+
+#### Response Types
+
+```typescript
+type GuestCheckoutStartResponse =
+  | {
+      tracked: true;
+      checkoutId: string;
+      cartId: string;
+      message: string;
+    }
+  | {
+      tracked: false;
+      message: string;
+    };
+```
+
+---
+
 ### Server Cart (Registered Users)
 
 For logged-in customers who want cart sync across devices.
@@ -980,8 +1076,13 @@ export default function ProductPage({ params }: { params: { id: string } }) {
           ${product.salePrice || product.basePrice}
         </p>
 
+        {/* Render description based on format (HTML from Shopify/WooCommerce, text otherwise) */}
         {product.description && (
-          <p className="mt-4 text-gray-600">{product.description}</p>
+          product.descriptionFormat === 'html' ? (
+            <div className="mt-4 text-gray-600" dangerouslySetInnerHTML={{ __html: product.description }} />
+          ) : (
+            <p className="mt-4 text-gray-600">{product.description}</p>
+          )
         )}
 
         {/* Variant Selection */}
@@ -1832,6 +1933,7 @@ When building a store, implement these pages:
 - Handle loading states and errors
 - Persist cart ID in localStorage
 - Persist customer token after login
+- **Check `descriptionFormat` and render HTML with `dangerouslySetInnerHTML` when format is `'html'`**
 
 ### DON'T:
 
@@ -1840,6 +1942,7 @@ When building a store, implement these pages:
 - Skip implementing required pages
 - Write `const products = [...]` - use the API!
 - Use `@apply group` in CSS - Tailwind doesn't allow 'group' in @apply. Use `className="group"` on the element instead
+- **Render `product.description` as plain text without checking `descriptionFormat` - HTML will show as raw tags!**
 
 ---
 

package/dist/index.d.mts

@@ -640,6 +640,20 @@ interface GuestOrderResponse {
     total: number;
     message: string;
 }
+/**
+ * Response from starting a tracked guest checkout session
+ * If tracking is enabled, returns checkoutId and cartId
+ * If tracking is not enabled, returns tracked: false
+ */
+type GuestCheckoutStartResponse = {
+    tracked: true;
+    checkoutId: string;
+    cartId: string;
+    message: string;
+} | {
+    tracked: false;
+    message: string;
+};
 type CheckoutStatus = 'PENDING' | 'SHIPPING_SET' | 'PAYMENT_PENDING' | 'PAYMENT_PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED';
 interface CheckoutAddress {
     firstName: string;
@@ -1989,6 +2003,55 @@ declare class OmniSyncClient {
     submitGuestOrder(options?: {
         clearCartOnSuccess?: boolean;
     }): Promise<GuestOrderResponse>;
+    /**
+     * Start a tracked guest checkout session (if enabled on connection)
+     *
+     * This creates Cart + Checkout records on the server so the store admin
+     * can see checkout sessions and track abandoned carts.
+     *
+     * If tracking is not enabled for this connection, returns { tracked: false }.
+     * If tracking is enabled, returns { tracked: true, checkoutId, cartId }.
+     *
+     * @example
+     * ```typescript
+     * // When customer goes to checkout page
+     * const result = await omni.startGuestCheckout();
+     *
+     * if (result.tracked) {
+     *   // Store checkoutId for later use
+     *   console.log('Checkout tracked:', result.checkoutId);
+     *
+     *   // Update checkout with address
+     *   await omni.updateGuestCheckout(result.checkoutId, {
+     *     shippingAddress: { ... },
+     *   });
+     *
+     *   // Complete checkout
+     *   const order = await omni.completeGuestCheckout(result.checkoutId);
+     * } else {
+     *   // Tracking not enabled, use regular submitGuestOrder
+     *   const order = await omni.submitGuestOrder();
+     * }
+     * ```
+     */
+    startGuestCheckout(): Promise<GuestCheckoutStartResponse>;
+    /**
+     * Update a tracked guest checkout with shipping/billing address
+     * Use after startGuestCheckout() returns { tracked: true }
+     */
+    updateGuestCheckoutAddress(checkoutId: string, data: {
+        shippingAddress?: SetShippingAddressDto;
+        billingAddress?: SetBillingAddressDto;
+    }): Promise<Checkout>;
+    /**
+     * Complete a tracked guest checkout - creates the order
+     * Use after startGuestCheckout() and updateGuestCheckoutAddress()
+     */
+    completeGuestCheckout(checkoutId: string, options?: {
+        clearCartOnSuccess?: boolean;
+    }): Promise<{
+        orderId: string;
+    }>;
     /**
      * Create order from custom data (not from local cart)
      * Use this if you manage cart state yourself
@@ -2212,4 +2275,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 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 CustomerProfile, type CustomerQueryParams, type DraftLineItem, type EditInventoryDto, type FulfillOrderDto, type GuestOrderResponse, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, 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, isCouponApplicableToProduct, 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 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 CustomerProfile, type CustomerQueryParams, type DraftLineItem, type EditInventoryDto, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, 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, isCouponApplicableToProduct, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts

@@ -640,6 +640,20 @@ interface GuestOrderResponse {
     total: number;
     message: string;
 }
+/**
+ * Response from starting a tracked guest checkout session
+ * If tracking is enabled, returns checkoutId and cartId
+ * If tracking is not enabled, returns tracked: false
+ */
+type GuestCheckoutStartResponse = {
+    tracked: true;
+    checkoutId: string;
+    cartId: string;
+    message: string;
+} | {
+    tracked: false;
+    message: string;
+};
 type CheckoutStatus = 'PENDING' | 'SHIPPING_SET' | 'PAYMENT_PENDING' | 'PAYMENT_PROCESSING' | 'COMPLETED' | 'FAILED' | 'EXPIRED';
 interface CheckoutAddress {
     firstName: string;
@@ -1989,6 +2003,55 @@ declare class OmniSyncClient {
     submitGuestOrder(options?: {
         clearCartOnSuccess?: boolean;
     }): Promise<GuestOrderResponse>;
+    /**
+     * Start a tracked guest checkout session (if enabled on connection)
+     *
+     * This creates Cart + Checkout records on the server so the store admin
+     * can see checkout sessions and track abandoned carts.
+     *
+     * If tracking is not enabled for this connection, returns { tracked: false }.
+     * If tracking is enabled, returns { tracked: true, checkoutId, cartId }.
+     *
+     * @example
+     * ```typescript
+     * // When customer goes to checkout page
+     * const result = await omni.startGuestCheckout();
+     *
+     * if (result.tracked) {
+     *   // Store checkoutId for later use
+     *   console.log('Checkout tracked:', result.checkoutId);
+     *
+     *   // Update checkout with address
+     *   await omni.updateGuestCheckout(result.checkoutId, {
+     *     shippingAddress: { ... },
+     *   });
+     *
+     *   // Complete checkout
+     *   const order = await omni.completeGuestCheckout(result.checkoutId);
+     * } else {
+     *   // Tracking not enabled, use regular submitGuestOrder
+     *   const order = await omni.submitGuestOrder();
+     * }
+     * ```
+     */
+    startGuestCheckout(): Promise<GuestCheckoutStartResponse>;
+    /**
+     * Update a tracked guest checkout with shipping/billing address
+     * Use after startGuestCheckout() returns { tracked: true }
+     */
+    updateGuestCheckoutAddress(checkoutId: string, data: {
+        shippingAddress?: SetShippingAddressDto;
+        billingAddress?: SetBillingAddressDto;
+    }): Promise<Checkout>;
+    /**
+     * Complete a tracked guest checkout - creates the order
+     * Use after startGuestCheckout() and updateGuestCheckoutAddress()
+     */
+    completeGuestCheckout(checkoutId: string, options?: {
+        clearCartOnSuccess?: boolean;
+    }): Promise<{
+        orderId: string;
+    }>;
     /**
      * Create order from custom data (not from local cart)
      * Use this if you manage cart state yourself
@@ -2212,4 +2275,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 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 CustomerProfile, type CustomerQueryParams, type DraftLineItem, type EditInventoryDto, type FulfillOrderDto, type GuestOrderResponse, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, 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, isCouponApplicableToProduct, 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 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 CustomerProfile, type CustomerQueryParams, type DraftLineItem, type EditInventoryDto, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InventoryInfo, type InventorySyncStatus, type LocalCart, type LocalCartItem, type MergeCartsDto, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PlatformCouponCapabilities, type Product, type ProductAttributeInput, type ProductImage, type ProductQueryParams, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, 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, isCouponApplicableToProduct, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.js

@@ -1751,6 +1751,97 @@ var OmniSyncClient = class {
     }
     return result;
   }
+  /**
+   * Start a tracked guest checkout session (if enabled on connection)
+   *
+   * This creates Cart + Checkout records on the server so the store admin
+   * can see checkout sessions and track abandoned carts.
+   *
+   * If tracking is not enabled for this connection, returns { tracked: false }.
+   * If tracking is enabled, returns { tracked: true, checkoutId, cartId }.
+   *
+   * @example
+   * ```typescript
+   * // When customer goes to checkout page
+   * const result = await omni.startGuestCheckout();
+   *
+   * if (result.tracked) {
+   *   // Store checkoutId for later use
+   *   console.log('Checkout tracked:', result.checkoutId);
+   *
+   *   // Update checkout with address
+   *   await omni.updateGuestCheckout(result.checkoutId, {
+   *     shippingAddress: { ... },
+   *   });
+   *
+   *   // Complete checkout
+   *   const order = await omni.completeGuestCheckout(result.checkoutId);
+   * } else {
+   *   // Tracking not enabled, use regular submitGuestOrder
+   *   const order = await omni.submitGuestOrder();
+   * }
+   * ```
+   */
+  async startGuestCheckout() {
+    const cart = this.getLocalCart();
+    if (cart.items.length === 0) {
+      throw new OmniSyncError("Cart is empty", 400);
+    }
+    const response = await this.vibeCodedRequest(
+      "POST",
+      "/guest-checkout",
+      {
+        items: cart.items.map((item) => ({
+          productId: item.productId,
+          variantId: item.variantId,
+          quantity: item.quantity
+        })),
+        customer: cart.customer
+      }
+    );
+    return response;
+  }
+  /**
+   * Update a tracked guest checkout with shipping/billing address
+   * Use after startGuestCheckout() returns { tracked: true }
+   */
+  async updateGuestCheckoutAddress(checkoutId, data) {
+    let checkout = null;
+    if (data.shippingAddress) {
+      const result = await this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/shipping-address`,
+        data.shippingAddress
+      );
+      checkout = result.checkout;
+    }
+    if (data.billingAddress) {
+      checkout = await this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/billing-address`,
+        data.billingAddress
+      );
+    }
+    if (!checkout) {
+      throw new OmniSyncError("No address data provided", 400);
+    }
+    return checkout;
+  }
+  /**
+   * Complete a tracked guest checkout - creates the order
+   * Use after startGuestCheckout() and updateGuestCheckoutAddress()
+   */
+  async completeGuestCheckout(checkoutId, options) {
+    const result = await this.vibeCodedRequest(
+      "POST",
+      `/checkout/${checkoutId}/complete`,
+      {}
+    );
+    if (options?.clearCartOnSuccess !== false) {
+      this.clearLocalCart();
+    }
+    return result;
+  }
   /**
    * Create order from custom data (not from local cart)
    * Use this if you manage cart state yourself

package/dist/index.mjs

@@ -1726,6 +1726,97 @@ var OmniSyncClient = class {
     }
     return result;
   }
+  /**
+   * Start a tracked guest checkout session (if enabled on connection)
+   *
+   * This creates Cart + Checkout records on the server so the store admin
+   * can see checkout sessions and track abandoned carts.
+   *
+   * If tracking is not enabled for this connection, returns { tracked: false }.
+   * If tracking is enabled, returns { tracked: true, checkoutId, cartId }.
+   *
+   * @example
+   * ```typescript
+   * // When customer goes to checkout page
+   * const result = await omni.startGuestCheckout();
+   *
+   * if (result.tracked) {
+   *   // Store checkoutId for later use
+   *   console.log('Checkout tracked:', result.checkoutId);
+   *
+   *   // Update checkout with address
+   *   await omni.updateGuestCheckout(result.checkoutId, {
+   *     shippingAddress: { ... },
+   *   });
+   *
+   *   // Complete checkout
+   *   const order = await omni.completeGuestCheckout(result.checkoutId);
+   * } else {
+   *   // Tracking not enabled, use regular submitGuestOrder
+   *   const order = await omni.submitGuestOrder();
+   * }
+   * ```
+   */
+  async startGuestCheckout() {
+    const cart = this.getLocalCart();
+    if (cart.items.length === 0) {
+      throw new OmniSyncError("Cart is empty", 400);
+    }
+    const response = await this.vibeCodedRequest(
+      "POST",
+      "/guest-checkout",
+      {
+        items: cart.items.map((item) => ({
+          productId: item.productId,
+          variantId: item.variantId,
+          quantity: item.quantity
+        })),
+        customer: cart.customer
+      }
+    );
+    return response;
+  }
+  /**
+   * Update a tracked guest checkout with shipping/billing address
+   * Use after startGuestCheckout() returns { tracked: true }
+   */
+  async updateGuestCheckoutAddress(checkoutId, data) {
+    let checkout = null;
+    if (data.shippingAddress) {
+      const result = await this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/shipping-address`,
+        data.shippingAddress
+      );
+      checkout = result.checkout;
+    }
+    if (data.billingAddress) {
+      checkout = await this.vibeCodedRequest(
+        "PATCH",
+        `/checkout/${checkoutId}/billing-address`,
+        data.billingAddress
+      );
+    }
+    if (!checkout) {
+      throw new OmniSyncError("No address data provided", 400);
+    }
+    return checkout;
+  }
+  /**
+   * Complete a tracked guest checkout - creates the order
+   * Use after startGuestCheckout() and updateGuestCheckoutAddress()
+   */
+  async completeGuestCheckout(checkoutId, options) {
+    const result = await this.vibeCodedRequest(
+      "POST",
+      `/checkout/${checkoutId}/complete`,
+      {}
+    );
+    if (options?.clearCartOnSuccess !== false) {
+      this.clearLocalCart();
+    }
+    return result;
+  }
   /**
    * Create order from custom data (not from local cart)
    * Use this if you manage cart state yourself

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.6.1",
+  "version": "0.7.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",