omni-sync-sdk 0.19.0 → 0.19.2

package/dist/index.d.mts

@@ -247,6 +247,14 @@ interface ProductVariant {
     salePrice?: string | null;
     /** Variant attributes (e.g., { "Color": "Red", "Size": "M" }) */
     attributes?: Record<string, string> | null;
+    /**
+     * Variant options as array (alternative to attributes).
+     * Use getVariantOptions(variant) helper for consistent access.
+     */
+    options?: Array<{
+        name: string;
+        value: string;
+    }>;
     inventory?: InventoryInfo | null;
     /** Variant image URL or image object */
     image?: string | {
@@ -322,11 +330,12 @@ interface InventoryInfo {
  */
 declare function isHtmlDescription(product: Pick<Product, 'descriptionFormat'> | null | undefined): boolean;
 /**
- * Get the product description ready for rendering
- * Returns an object with either `html` (for dangerouslySetInnerHTML) or `text` (for regular rendering)
+ * Get the product description ready for rendering.
+ * NOTE: Returns an OBJECT, not a string! Use product.description directly if you need the raw string.
+ * Returns { html: string } for HTML content, { text: string } for plain text, or null if no description.
  *
  * @param product - The product object
- * @returns Object with either { html: string } or { text: string } or null if no description
+ * @returns Object with either { html: string } or { text: string } or null - NOT a plain string!
  *
  * @example
  * ```tsx
@@ -406,12 +415,13 @@ interface FormatPriceOptions {
     asNumber?: boolean;
 }
 /**
- * Parse a price string and format it for display.
+ * Parse a price value and format it for display.
  *
  * All price fields in Cart, Checkout, and ShippingRate are strings (e.g., "29.99")
  * to preserve decimal precision. This helper simplifies formatting them.
+ * Also accepts numbers directly from helper functions like getProductPriceInfo().
  *
- * @param priceString - The price as a string (e.g., "29.99")
+ * @param priceString - The price as a string (e.g., "29.99") or number
  * @param options - Formatting options
  * @returns Formatted price string (e.g., "$29.99") or number if asNumber is true
  *
@@ -428,6 +438,10 @@ interface FormatPriceOptions {
  * // Get as number for calculations
  * formatPrice(item.unitPrice, { asNumber: true });   // 29.99
  *
+ * // Works with numbers from helper functions
+ * const { price } = getProductPriceInfo(product);
+ * formatPrice(price, { currency: 'USD' });           // "$29.99"
+ *
  * // With locale
  * formatPrice('1234.56', { locale: 'de-DE', currency: 'EUR' }); // "1.234,56 €"
  *
@@ -436,7 +450,7 @@ interface FormatPriceOptions {
  * formatPrice(null);       // "$0.00"
  * ```
  */
-declare function formatPrice(priceString: string | undefined | null, options?: FormatPriceOptions): string | number;
+declare function formatPrice(priceString: string | number | undefined | null, options?: FormatPriceOptions): string | number;
 /**
  * Get the effective price of a product (sale price if on sale, otherwise base price).
  * Returns the price as a NUMBER, not string.
@@ -615,6 +629,8 @@ interface ProductSuggestion {
     name: string;
     slug: string | null;
     image: string | null;
+    /** Effective price as string (salePrice if on sale, otherwise basePrice). */
+    price: string;
     /** Base price as string. Use parseFloat() for calculations. */
     basePrice: string;
     /** Sale price as string. Use parseFloat() for calculations. */
@@ -2109,6 +2125,8 @@ interface PaymentProviderConfig {
     /** Whether this is the default provider */
     isDefault: boolean;
 }
+/** Alias for PaymentProviderConfig for convenience */
+type PaymentProvider = PaymentProviderConfig;
 /**
  * All available payment providers for a store.
  * Use this to build dynamic payment UI based on what's configured.
@@ -2183,8 +2201,8 @@ interface PaymentIntent {
 interface PaymentStatus {
     /** Checkout ID */
     checkoutId: string;
-    /** Payment status: pending, succeeded, failed, canceled */
-    status: 'pending' | 'succeeded' | 'failed' | 'canceled';
+    /** Payment status: pending, processing, succeeded, failed, canceled */
+    status: 'pending' | 'processing' | 'succeeded' | 'failed' | 'canceled';
     /** Order ID if payment succeeded and order was created */
     orderId?: string;
     /** Order number if payment succeeded (e.g., "ORD-20260201-0001") */
@@ -3765,13 +3783,28 @@ declare class OmniSyncClient {
         message: string;
     }>;
     /**
-     * Get available OAuth providers for this store
-     * Works in vibe-coded and storefront modes
+     * Get available OAuth providers for this store.
+     * Returns an array of provider strings (not objects).
+     * Works in vibe-coded and storefront modes.
+     *
+     * @returns Object with `providers` array containing strings like 'GOOGLE', 'FACEBOOK', 'GITHUB'
      *
      * @example
      * ```typescript
      * const { providers } = await omni.getAvailableOAuthProviders();
-     * // providers: ['GOOGLE', 'FACEBOOK']
+     * // providers: ['GOOGLE', 'FACEBOOK'] - array of strings, not objects!
+     *
+     * // To display with friendly names:
+     * const providerNames: Record<string, string> = {
+     *   GOOGLE: 'Google',
+     *   FACEBOOK: 'Facebook',
+     *   GITHUB: 'GitHub'
+     * };
+     *
+     * providers.map(p => ({
+     *   provider: p,
+     *   name: providerNames[p] || p
+     * }));
      * ```
      */
     getAvailableOAuthProviders(): Promise<OAuthProvidersResponse>;
@@ -5448,4 +5481,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 Attribute, type AttributeOption, type AttributeSource, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type 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 PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type Attribute, type AttributeOption, type AttributeSource, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.d.ts

@@ -247,6 +247,14 @@ interface ProductVariant {
     salePrice?: string | null;
     /** Variant attributes (e.g., { "Color": "Red", "Size": "M" }) */
     attributes?: Record<string, string> | null;
+    /**
+     * Variant options as array (alternative to attributes).
+     * Use getVariantOptions(variant) helper for consistent access.
+     */
+    options?: Array<{
+        name: string;
+        value: string;
+    }>;
     inventory?: InventoryInfo | null;
     /** Variant image URL or image object */
     image?: string | {
@@ -322,11 +330,12 @@ interface InventoryInfo {
  */
 declare function isHtmlDescription(product: Pick<Product, 'descriptionFormat'> | null | undefined): boolean;
 /**
- * Get the product description ready for rendering
- * Returns an object with either `html` (for dangerouslySetInnerHTML) or `text` (for regular rendering)
+ * Get the product description ready for rendering.
+ * NOTE: Returns an OBJECT, not a string! Use product.description directly if you need the raw string.
+ * Returns { html: string } for HTML content, { text: string } for plain text, or null if no description.
  *
  * @param product - The product object
- * @returns Object with either { html: string } or { text: string } or null if no description
+ * @returns Object with either { html: string } or { text: string } or null - NOT a plain string!
  *
  * @example
  * ```tsx
@@ -406,12 +415,13 @@ interface FormatPriceOptions {
     asNumber?: boolean;
 }
 /**
- * Parse a price string and format it for display.
+ * Parse a price value and format it for display.
  *
  * All price fields in Cart, Checkout, and ShippingRate are strings (e.g., "29.99")
  * to preserve decimal precision. This helper simplifies formatting them.
+ * Also accepts numbers directly from helper functions like getProductPriceInfo().
  *
- * @param priceString - The price as a string (e.g., "29.99")
+ * @param priceString - The price as a string (e.g., "29.99") or number
  * @param options - Formatting options
  * @returns Formatted price string (e.g., "$29.99") or number if asNumber is true
  *
@@ -428,6 +438,10 @@ interface FormatPriceOptions {
  * // Get as number for calculations
  * formatPrice(item.unitPrice, { asNumber: true });   // 29.99
  *
+ * // Works with numbers from helper functions
+ * const { price } = getProductPriceInfo(product);
+ * formatPrice(price, { currency: 'USD' });           // "$29.99"
+ *
  * // With locale
  * formatPrice('1234.56', { locale: 'de-DE', currency: 'EUR' }); // "1.234,56 €"
  *
@@ -436,7 +450,7 @@ interface FormatPriceOptions {
  * formatPrice(null);       // "$0.00"
  * ```
  */
-declare function formatPrice(priceString: string | undefined | null, options?: FormatPriceOptions): string | number;
+declare function formatPrice(priceString: string | number | undefined | null, options?: FormatPriceOptions): string | number;
 /**
  * Get the effective price of a product (sale price if on sale, otherwise base price).
  * Returns the price as a NUMBER, not string.
@@ -615,6 +629,8 @@ interface ProductSuggestion {
     name: string;
     slug: string | null;
     image: string | null;
+    /** Effective price as string (salePrice if on sale, otherwise basePrice). */
+    price: string;
     /** Base price as string. Use parseFloat() for calculations. */
     basePrice: string;
     /** Sale price as string. Use parseFloat() for calculations. */
@@ -2109,6 +2125,8 @@ interface PaymentProviderConfig {
     /** Whether this is the default provider */
     isDefault: boolean;
 }
+/** Alias for PaymentProviderConfig for convenience */
+type PaymentProvider = PaymentProviderConfig;
 /**
  * All available payment providers for a store.
  * Use this to build dynamic payment UI based on what's configured.
@@ -2183,8 +2201,8 @@ interface PaymentIntent {
 interface PaymentStatus {
     /** Checkout ID */
     checkoutId: string;
-    /** Payment status: pending, succeeded, failed, canceled */
-    status: 'pending' | 'succeeded' | 'failed' | 'canceled';
+    /** Payment status: pending, processing, succeeded, failed, canceled */
+    status: 'pending' | 'processing' | 'succeeded' | 'failed' | 'canceled';
     /** Order ID if payment succeeded and order was created */
     orderId?: string;
     /** Order number if payment succeeded (e.g., "ORD-20260201-0001") */
@@ -3765,13 +3783,28 @@ declare class OmniSyncClient {
         message: string;
     }>;
     /**
-     * Get available OAuth providers for this store
-     * Works in vibe-coded and storefront modes
+     * Get available OAuth providers for this store.
+     * Returns an array of provider strings (not objects).
+     * Works in vibe-coded and storefront modes.
+     *
+     * @returns Object with `providers` array containing strings like 'GOOGLE', 'FACEBOOK', 'GITHUB'
      *
      * @example
      * ```typescript
      * const { providers } = await omni.getAvailableOAuthProviders();
-     * // providers: ['GOOGLE', 'FACEBOOK']
+     * // providers: ['GOOGLE', 'FACEBOOK'] - array of strings, not objects!
+     *
+     * // To display with friendly names:
+     * const providerNames: Record<string, string> = {
+     *   GOOGLE: 'Google',
+     *   FACEBOOK: 'Facebook',
+     *   GITHUB: 'GitHub'
+     * };
+     *
+     * providers.map(p => ({
+     *   provider: p,
+     *   name: providerNames[p] || p
+     * }));
      * ```
      */
     getAvailableOAuthProviders(): Promise<OAuthProvidersResponse>;
@@ -5448,4 +5481,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 Attribute, type AttributeOption, type AttributeSource, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type 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 PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };
+export { type AddToCartDto, type AppliedDiscount, type ApplyCouponDto, type Attribute, type AttributeOption, type AttributeSource, type Brand, type BulkInventoryResponse, type BulkSaveVariantsDto, type BulkSaveVariantsResponse, type BulkVariantInput, type Cart, type CartItem, type CartStatus, type Category, type CategorySuggestion, type Checkout, type CheckoutAddress, type CheckoutLineItem, type CheckoutPrefillData, type CheckoutStatus, type CompleteCheckoutResponse, type CompleteDraftDto, type ConfigureOAuthProviderDto as ConfigureOAuthProviderInput, type ConflictStatus, type ConnectorPlatform, type Coupon, type CouponCreateResponse, type CouponQueryParams, type CouponStatus, type CouponType, type CouponValidationWarning, type CreateAddressDto, type CreateAttributeDto as CreateAttributeInput, type CreateAttributeOptionDto as CreateAttributeOptionInput, type CreateBrandDto as CreateBrandInput, type CreateCategoryDto as CreateCategoryInput, type CreateCheckoutDto, type CreateCouponDto, type CreateCustomApiDto, type CreateCustomerDto, type CreateEmailTemplateDto as CreateEmailTemplateInput, type CreateGuestOrderDto, type CreateMetafieldDefinitionDto as CreateMetafieldDefinitionInput, type CreateOrderDto, type CreateProductDto, type CreateRefundDto, type CreateShippingRateDto as CreateShippingRateInput, type CreateShippingZoneDto as CreateShippingZoneInput, type CreateTagDto as CreateTagInput, type CreateTaxRateDto as CreateTaxRateInput, type CreateVariantDto, type CustomApiAuthType, type CustomApiConnectionStatus, type CustomApiCredentials, type CustomApiIntegration, type CustomApiSyncConfig, type CustomApiSyncDirection, type CustomApiTestResult, type Customer, type CustomerAddress, type CustomerAuthResponse, type CustomerOAuthProvider, type CustomerProfile, type CustomerQueryParams, type DeleteProductResponse, type DraftLineItem, type EditInventoryDto, type EmailDomain, type EmailEventSettings, type EmailEventType, type EmailSettings, type EmailTemplate, type EmailTemplatePreview, type EmailVerificationResponse, type ExtendReservationResponse, type FormatPriceOptions, type FulfillOrderDto, type GuestCheckoutStartResponse, type GuestOrderResponse, type InsufficientStockError, type InventoryInfo, type InventoryReservationStrategy, type InventorySyncStatus, type InventoryTrackingMode, type InvitationStatus, type InviteMemberDto as InviteMemberInput, type LocalCart, type LocalCartItem, type MergeCartsDto, type MetafieldConflict, type MetafieldConflictResolution, type MetafieldDefinition, type MetafieldPlatformMapping, type MetafieldType, type OAuthAuthorizeResponse, type OAuthCallbackResponse, type OAuthConnection, type OAuthConnectionsResponse, type OAuthProviderConfig, type OAuthProviderType, type OAuthProvidersResponse, type OmniSyncApiError, OmniSyncClient, type OmniSyncClientOptions, OmniSyncError, type Order, type OrderAddress, type OrderCustomer, type OrderItem, type OrderQueryParams, type OrderStatus, type PaginatedResponse, type PaymentConfig, type PaymentIntent, type PaymentProvider, type PaymentProviderConfig, type PaymentProvidersConfig, type PaymentStatus, type PlatformCouponCapabilities, type PreviewEmailTemplateDto as PreviewEmailTemplateInput, type Product, type ProductAttributeInput, type ProductAvailability, type ProductImage, type ProductMetafield, type ProductMetafieldValue, type ProductQueryParams, type ProductSuggestion, type ProductVariant, type PublishProductResponse, type ReconcileInventoryResponse, type Refund, type RefundLineItem, type RefundLineItemResponse, type RefundType, type RegisterCustomerDto, type ReservationInfo, type ResolveMetafieldConflictDto as ResolveMetafieldConflictInput, type ResolveSyncConflictDto as ResolveSyncConflictInput, type SearchSuggestions, type SelectShippingMethodDto, type SendInvoiceDto, type SetBillingAddressDto, type SetCheckoutCustomerDto, type SetShippingAddressDto, type SetShippingAddressResponse, type ShippingLine, type ShippingRate, type ShippingRateConfig, type ShippingRateType, type ShippingZone, type ShippingZoneQueryParams, type StockAvailabilityRequest, type StockAvailabilityResponse, type StockAvailabilityResult, type StoreInfo, type SyncConflict, type SyncConflictResolution, type SyncJob, type Tag, type TaxBreakdown, type TaxBreakdownItem, type TaxRate, type TaxonomyQueryParams, type TeamInvitation, type TeamInvitationsResponse, type TeamMember, type TeamMembersResponse, type TeamRole, type UpdateAddressDto, type UpdateAttributeDto as UpdateAttributeInput, type UpdateAttributeOptionDto as UpdateAttributeOptionInput, type UpdateBrandDto as UpdateBrandInput, type UpdateCartItemDto, type UpdateCategoryDto as UpdateCategoryInput, type UpdateCouponDto, type UpdateCustomApiDto, type UpdateCustomerDto, type UpdateDraftDto, type UpdateEmailSettingsDto as UpdateEmailSettingsInput, type UpdateEmailTemplateDto as UpdateEmailTemplateInput, type UpdateInventoryDto, type UpdateMemberRoleDto as UpdateMemberRoleInput, type UpdateMetafieldDefinitionDto as UpdateMetafieldDefinitionInput, type UpdateOAuthProviderDto as UpdateOAuthProviderInput, type UpdateOrderDto, type UpdateOrderShippingDto, type UpdateProductDto, type UpdateShippingRateDto as UpdateShippingRateInput, type UpdateShippingZoneDto as UpdateShippingZoneInput, type UpdateTagDto as UpdateTagInput, type UpdateTaxRateDto as UpdateTaxRateInput, type UpdateVariantDto, type UpdateVariantInventoryDto, type UpsertProductMetafieldDto as UpsertProductMetafieldInput, type VariantInventoryResponse, type VariantPlatformOverlay, type VariantStatus, type WaitForOrderOptions, type WaitForOrderResult, type WebhookEvent, type WebhookEventType, createWebhookHandler, formatPrice, getCartItemImage, getCartItemName, getCartTotals, getDescriptionContent, formatPrice as getPriceDisplay, getProductPrice, getProductPriceInfo, getStockStatus, getVariantOptions, getVariantPrice, isCouponApplicableToProduct, isHtmlDescription, isWebhookEventType, parseWebhookEvent, verifyWebhook };

package/dist/index.js

@@ -1379,13 +1379,28 @@ var OmniSyncClient = class {
   // Customer OAuth (Social Login)
   // ===================================================
   /**
-   * Get available OAuth providers for this store
-   * Works in vibe-coded and storefront modes
+   * Get available OAuth providers for this store.
+   * Returns an array of provider strings (not objects).
+   * Works in vibe-coded and storefront modes.
+   *
+   * @returns Object with `providers` array containing strings like 'GOOGLE', 'FACEBOOK', 'GITHUB'
    *
    * @example
    * ```typescript
    * const { providers } = await omni.getAvailableOAuthProviders();
-   * // providers: ['GOOGLE', 'FACEBOOK']
+   * // providers: ['GOOGLE', 'FACEBOOK'] - array of strings, not objects!
+   *
+   * // To display with friendly names:
+   * const providerNames: Record<string, string> = {
+   *   GOOGLE: 'Google',
+   *   FACEBOOK: 'Facebook',
+   *   GITHUB: 'GitHub'
+   * };
+   *
+   * providers.map(p => ({
+   *   provider: p,
+   *   name: providerNames[p] || p
+   * }));
    * ```
    */
   async getAvailableOAuthProviders() {
@@ -1741,10 +1756,32 @@ var OmniSyncClient = class {
    */
   async addToCart(cartId, item) {
     if (cartId === this.VIRTUAL_LOCAL_CART_ID) {
+      let productName = "Unknown Product";
+      let productPrice = "0";
+      let productImage;
+      try {
+        const product = await this.getProduct(item.productId);
+        productName = product.name;
+        productPrice = product.salePrice || product.basePrice;
+        productImage = product.images?.[0]?.url;
+        if (item.variantId && product.variants) {
+          const variant = product.variants.find((v) => v.id === item.variantId);
+          if (variant) {
+            productPrice = variant.salePrice || variant.price || productPrice;
+            if (variant.image) {
+              productImage = typeof variant.image === "string" ? variant.image : variant.image.url;
+            }
+          }
+        }
+      } catch {
+      }
       this.addToLocalCart({
         productId: item.productId,
         variantId: item.variantId,
-        quantity: item.quantity
+        quantity: item.quantity,
+        name: productName,
+        price: productPrice,
+        image: productImage
       });
       return this.localCartToCart(this.getLocalCart());
     }
@@ -4276,7 +4313,7 @@ function getStockStatus(inventory, options) {
   return options?.inStockText ?? "In Stock";
 }
 function formatPrice(priceString, options) {
-  const value = parseFloat(priceString || "0");
+  const value = typeof priceString === "number" ? priceString : parseFloat(priceString || "0");
   if (options?.asNumber) {
     return isNaN(value) ? 0 : value;
   }

package/dist/index.mjs

@@ -1342,13 +1342,28 @@ var OmniSyncClient = class {
   // Customer OAuth (Social Login)
   // ===================================================
   /**
-   * Get available OAuth providers for this store
-   * Works in vibe-coded and storefront modes
+   * Get available OAuth providers for this store.
+   * Returns an array of provider strings (not objects).
+   * Works in vibe-coded and storefront modes.
+   *
+   * @returns Object with `providers` array containing strings like 'GOOGLE', 'FACEBOOK', 'GITHUB'
    *
    * @example
    * ```typescript
    * const { providers } = await omni.getAvailableOAuthProviders();
-   * // providers: ['GOOGLE', 'FACEBOOK']
+   * // providers: ['GOOGLE', 'FACEBOOK'] - array of strings, not objects!
+   *
+   * // To display with friendly names:
+   * const providerNames: Record<string, string> = {
+   *   GOOGLE: 'Google',
+   *   FACEBOOK: 'Facebook',
+   *   GITHUB: 'GitHub'
+   * };
+   *
+   * providers.map(p => ({
+   *   provider: p,
+   *   name: providerNames[p] || p
+   * }));
    * ```
    */
   async getAvailableOAuthProviders() {
@@ -1704,10 +1719,32 @@ var OmniSyncClient = class {
    */
   async addToCart(cartId, item) {
     if (cartId === this.VIRTUAL_LOCAL_CART_ID) {
+      let productName = "Unknown Product";
+      let productPrice = "0";
+      let productImage;
+      try {
+        const product = await this.getProduct(item.productId);
+        productName = product.name;
+        productPrice = product.salePrice || product.basePrice;
+        productImage = product.images?.[0]?.url;
+        if (item.variantId && product.variants) {
+          const variant = product.variants.find((v) => v.id === item.variantId);
+          if (variant) {
+            productPrice = variant.salePrice || variant.price || productPrice;
+            if (variant.image) {
+              productImage = typeof variant.image === "string" ? variant.image : variant.image.url;
+            }
+          }
+        }
+      } catch {
+      }
       this.addToLocalCart({
         productId: item.productId,
         variantId: item.variantId,
-        quantity: item.quantity
+        quantity: item.quantity,
+        name: productName,
+        price: productPrice,
+        image: productImage
       });
       return this.localCartToCart(this.getLocalCart());
     }
@@ -4239,7 +4276,7 @@ function getStockStatus(inventory, options) {
   return options?.inStockText ?? "In Stock";
 }
 function formatPrice(priceString, options) {
-  const value = parseFloat(priceString || "0");
+  const value = typeof priceString === "number" ? priceString : parseFloat(priceString || "0");
   if (options?.asNumber) {
     return isNaN(value) ? 0 : value;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "omni-sync-sdk",
-  "version": "0.19.0",
+  "version": "0.19.2",
   "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",
@@ -16,14 +16,6 @@
     "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",
@@ -72,5 +64,12 @@
     "typescript": {
       "optional": true
     }
+  },
+  "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"
   }
-}
+}