omni-sync-sdk 0.7.3 → 0.7.5

package/README.md

@@ -205,6 +205,78 @@ console.log(product.variants); // ProductVariant[] (for VARIABLE products)
 console.log(product.inventory); // { total, reserved, available }
 ```
 
+#### Search Suggestions (Autocomplete)
+
+Get search suggestions for building autocomplete/search-as-you-type UI:
+
+```typescript
+import type { SearchSuggestions } from 'omni-sync-sdk';
+
+// Basic autocomplete
+const suggestions: SearchSuggestions = await omni.getSearchSuggestions('shirt');
+
+console.log(suggestions.products);
+// [{ id, name, image, basePrice, salePrice, type }]
+
+console.log(suggestions.categories);
+// [{ id, name, productCount }]
+
+// With custom limit (default: 5, max: 10)
+const suggestions = await omni.getSearchSuggestions('dress', 3);
+```
+
+**Search covers:** name, sku, description, categories, tags, and brands.
+
+**Example: Search Input with Suggestions**
+
+```typescript
+function SearchInput() {
+  const [query, setQuery] = useState('');
+  const [suggestions, setSuggestions] = useState<SearchSuggestions | null>(null);
+
+  // Debounce search requests
+  useEffect(() => {
+    if (query.length < 2) {
+      setSuggestions(null);
+      return;
+    }
+
+    const timer = setTimeout(async () => {
+      const results = await omni.getSearchSuggestions(query, 5);
+      setSuggestions(results);
+    }, 300);
+
+    return () => clearTimeout(timer);
+  }, [query]);
+
+  return (
+    <div>
+      <input
+        value={query}
+        onChange={(e) => setQuery(e.target.value)}
+        placeholder="Search products..."
+      />
+      {suggestions && (
+        <div className="suggestions">
+          {suggestions.products.map((product) => (
+            <a key={product.id} href={`/products/${product.id}`}>
+              <img src={product.image || '/placeholder.png'} alt={product.name} />
+              <span>{product.name}</span>
+              <span>${product.basePrice}</span>
+            </a>
+          ))}
+          {suggestions.categories.map((category) => (
+            <a key={category.id} href={`/category/${category.id}`}>
+              {category.name} ({category.productCount} products)
+            </a>
+          ))}
+        </div>
+      )}
+    </div>
+  );
+}
+```
+
 #### Product Type Definition
 
 ```typescript

package/dist/index.d.mts

@@ -113,6 +113,32 @@ interface ProductQueryParams {
     sortBy?: 'name' | 'createdAt' | 'updatedAt' | 'basePrice';
     sortOrder?: 'asc' | 'desc';
 }
+/**
+ * Product suggestion for autocomplete
+ */
+interface ProductSuggestion {
+    id: string;
+    name: string;
+    image: string | null;
+    basePrice: number;
+    salePrice?: number | null;
+    type: 'SIMPLE' | 'VARIABLE';
+}
+/**
+ * Category suggestion for autocomplete
+ */
+interface CategorySuggestion {
+    id: string;
+    name: string;
+    productCount: number;
+}
+/**
+ * Search suggestions response (autocomplete)
+ */
+interface SearchSuggestions {
+    products: ProductSuggestion[];
+    categories: CategorySuggestion[];
+}
 interface PaginatedResponse<T> {
     data: T[];
     meta: {
@@ -1100,6 +1126,27 @@ declare class OmniSyncClient {
      * Works in vibe-coded, storefront (public), and admin mode
      */
     getProduct(productId: string): Promise<Product>;
+    /**
+     * Get search suggestions for autocomplete
+     * Returns matching products and categories for quick search UI
+     * Works in vibe-coded and storefront mode
+     *
+     * @param query - Search query (minimum 1 character)
+     * @param limit - Maximum number of results (default 5, max 10)
+     * @returns Products and categories matching the query
+     *
+     * @example
+     * ```typescript
+     * // Basic autocomplete
+     * const suggestions = await omni.getSearchSuggestions('shirt');
+     * console.log(suggestions.products); // [{ id, name, image, basePrice, type }]
+     * console.log(suggestions.categories); // [{ id, name, productCount }]
+     *
+     * // With custom limit
+     * const suggestions = await omni.getSearchSuggestions('dress', 3);
+     * ```
+     */
+    getSearchSuggestions(query: string, limit?: number): Promise<SearchSuggestions>;
     /**
      * Create a new product
      */
@@ -1583,6 +1630,7 @@ declare class OmniSyncClient {
     getCustomerByEmail(email: string): Promise<Customer | null>;
     /**
      * Login an existing customer (returns JWT token)
+     * Works in vibe-coded, storefront, and admin mode
      *
      * @example
      * ```typescript
@@ -1594,6 +1642,7 @@ declare class OmniSyncClient {
     loginCustomer(email: string, password: string): Promise<CustomerAuthResponse>;
     /**
      * Register a new customer with password (creates account)
+     * Works in vibe-coded, storefront, and admin mode
      *
      * @example
      * ```typescript
@@ -1608,10 +1657,34 @@ declare class OmniSyncClient {
     registerCustomer(data: RegisterCustomerDto): Promise<CustomerAuthResponse>;
     /**
      * Request a password reset email for a customer
+     * Works in vibe-coded, storefront, and admin mode
      */
     forgotPassword(email: string): Promise<{
         message: string;
     }>;
+    /**
+     * Get the current logged-in customer's profile
+     * Requires a customer token to be set via setCustomerToken()
+     * Works in vibe-coded, storefront, and admin mode
+     *
+     * @example
+     * ```typescript
+     * // After login/register, set the token
+     * omni.setCustomerToken(auth.token);
+     *
+     * // Then get the profile
+     * const profile = await omni.getCustomerProfile();
+     * console.log('Customer:', profile.email);
+     * ```
+     */
+    getCustomerProfile(): Promise<{
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+        phone?: string;
+        emailVerified: boolean;
+    }>;
     /**
      * Get all addresses for a customer
      */
@@ -2275,4 +2348,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 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 };
+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 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 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 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

@@ -113,6 +113,32 @@ interface ProductQueryParams {
     sortBy?: 'name' | 'createdAt' | 'updatedAt' | 'basePrice';
     sortOrder?: 'asc' | 'desc';
 }
+/**
+ * Product suggestion for autocomplete
+ */
+interface ProductSuggestion {
+    id: string;
+    name: string;
+    image: string | null;
+    basePrice: number;
+    salePrice?: number | null;
+    type: 'SIMPLE' | 'VARIABLE';
+}
+/**
+ * Category suggestion for autocomplete
+ */
+interface CategorySuggestion {
+    id: string;
+    name: string;
+    productCount: number;
+}
+/**
+ * Search suggestions response (autocomplete)
+ */
+interface SearchSuggestions {
+    products: ProductSuggestion[];
+    categories: CategorySuggestion[];
+}
 interface PaginatedResponse<T> {
     data: T[];
     meta: {
@@ -1100,6 +1126,27 @@ declare class OmniSyncClient {
      * Works in vibe-coded, storefront (public), and admin mode
      */
     getProduct(productId: string): Promise<Product>;
+    /**
+     * Get search suggestions for autocomplete
+     * Returns matching products and categories for quick search UI
+     * Works in vibe-coded and storefront mode
+     *
+     * @param query - Search query (minimum 1 character)
+     * @param limit - Maximum number of results (default 5, max 10)
+     * @returns Products and categories matching the query
+     *
+     * @example
+     * ```typescript
+     * // Basic autocomplete
+     * const suggestions = await omni.getSearchSuggestions('shirt');
+     * console.log(suggestions.products); // [{ id, name, image, basePrice, type }]
+     * console.log(suggestions.categories); // [{ id, name, productCount }]
+     *
+     * // With custom limit
+     * const suggestions = await omni.getSearchSuggestions('dress', 3);
+     * ```
+     */
+    getSearchSuggestions(query: string, limit?: number): Promise<SearchSuggestions>;
     /**
      * Create a new product
      */
@@ -1583,6 +1630,7 @@ declare class OmniSyncClient {
     getCustomerByEmail(email: string): Promise<Customer | null>;
     /**
      * Login an existing customer (returns JWT token)
+     * Works in vibe-coded, storefront, and admin mode
      *
      * @example
      * ```typescript
@@ -1594,6 +1642,7 @@ declare class OmniSyncClient {
     loginCustomer(email: string, password: string): Promise<CustomerAuthResponse>;
     /**
      * Register a new customer with password (creates account)
+     * Works in vibe-coded, storefront, and admin mode
      *
      * @example
      * ```typescript
@@ -1608,10 +1657,34 @@ declare class OmniSyncClient {
     registerCustomer(data: RegisterCustomerDto): Promise<CustomerAuthResponse>;
     /**
      * Request a password reset email for a customer
+     * Works in vibe-coded, storefront, and admin mode
      */
     forgotPassword(email: string): Promise<{
         message: string;
     }>;
+    /**
+     * Get the current logged-in customer's profile
+     * Requires a customer token to be set via setCustomerToken()
+     * Works in vibe-coded, storefront, and admin mode
+     *
+     * @example
+     * ```typescript
+     * // After login/register, set the token
+     * omni.setCustomerToken(auth.token);
+     *
+     * // Then get the profile
+     * const profile = await omni.getCustomerProfile();
+     * console.log('Customer:', profile.email);
+     * ```
+     */
+    getCustomerProfile(): Promise<{
+        id: string;
+        email: string;
+        firstName?: string;
+        lastName?: string;
+        phone?: string;
+        emailVerified: boolean;
+    }>;
     /**
      * Get all addresses for a customer
      */
@@ -2275,4 +2348,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 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 };
+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 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 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 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

@@ -354,6 +354,54 @@ var OmniSyncClient = class {
     }
     return this.adminRequest("GET", `/api/v1/products/${productId}`);
   }
+  /**
+   * Get search suggestions for autocomplete
+   * Returns matching products and categories for quick search UI
+   * Works in vibe-coded and storefront mode
+   *
+   * @param query - Search query (minimum 1 character)
+   * @param limit - Maximum number of results (default 5, max 10)
+   * @returns Products and categories matching the query
+   *
+   * @example
+   * ```typescript
+   * // Basic autocomplete
+   * const suggestions = await omni.getSearchSuggestions('shirt');
+   * console.log(suggestions.products); // [{ id, name, image, basePrice, type }]
+   * console.log(suggestions.categories); // [{ id, name, productCount }]
+   *
+   * // With custom limit
+   * const suggestions = await omni.getSearchSuggestions('dress', 3);
+   * ```
+   */
+  async getSearchSuggestions(query, limit) {
+    if (!query || query.trim().length === 0) {
+      return { products: [], categories: [] };
+    }
+    const queryParams = { q: query, limit };
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        "/search/suggestions",
+        void 0,
+        queryParams
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "GET",
+        "/search/suggestions",
+        void 0,
+        queryParams
+      );
+    }
+    return this.adminRequest(
+      "GET",
+      "/api/v1/search/suggestions",
+      void 0,
+      queryParams
+    );
+  }
   /**
    * Create a new product
    */
@@ -975,6 +1023,7 @@ var OmniSyncClient = class {
   }
   /**
    * Login an existing customer (returns JWT token)
+   * Works in vibe-coded, storefront, and admin mode
    *
    * @example
    * ```typescript
@@ -984,6 +1033,12 @@ var OmniSyncClient = class {
    * ```
    */
   async loginCustomer(email, password) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/login", {
+        email,
+        password
+      });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/customers/login", {
         email,
@@ -997,6 +1052,7 @@ var OmniSyncClient = class {
   }
   /**
    * Register a new customer with password (creates account)
+   * Works in vibe-coded, storefront, and admin mode
    *
    * @example
    * ```typescript
@@ -1009,6 +1065,9 @@ var OmniSyncClient = class {
    * ```
    */
   async registerCustomer(data) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/register", data);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/customers/register", data);
     }
@@ -1016,8 +1075,14 @@ var OmniSyncClient = class {
   }
   /**
    * Request a password reset email for a customer
+   * Works in vibe-coded, storefront, and admin mode
    */
   async forgotPassword(email) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/forgot-password", {
+        email
+      });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/customers/forgot-password", {
         email
@@ -1027,6 +1092,36 @@ var OmniSyncClient = class {
       email
     });
   }
+  /**
+   * Get the current logged-in customer's profile
+   * Requires a customer token to be set via setCustomerToken()
+   * Works in vibe-coded, storefront, and admin mode
+   *
+   * @example
+   * ```typescript
+   * // After login/register, set the token
+   * omni.setCustomerToken(auth.token);
+   *
+   * // Then get the profile
+   * const profile = await omni.getCustomerProfile();
+   * console.log('Customer:', profile.email);
+   * ```
+   */
+  async getCustomerProfile() {
+    if (!this.customerToken) {
+      throw new OmniSyncError("Customer token is required. Call setCustomerToken() first.", 401);
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me");
+    }
+    throw new OmniSyncError(
+      "getCustomerProfile() is not available in admin mode. Use getCustomer(id) instead.",
+      400
+    );
+  }
   /**
    * Get all addresses for a customer
    */

package/dist/index.mjs

@@ -329,6 +329,54 @@ var OmniSyncClient = class {
     }
     return this.adminRequest("GET", `/api/v1/products/${productId}`);
   }
+  /**
+   * Get search suggestions for autocomplete
+   * Returns matching products and categories for quick search UI
+   * Works in vibe-coded and storefront mode
+   *
+   * @param query - Search query (minimum 1 character)
+   * @param limit - Maximum number of results (default 5, max 10)
+   * @returns Products and categories matching the query
+   *
+   * @example
+   * ```typescript
+   * // Basic autocomplete
+   * const suggestions = await omni.getSearchSuggestions('shirt');
+   * console.log(suggestions.products); // [{ id, name, image, basePrice, type }]
+   * console.log(suggestions.categories); // [{ id, name, productCount }]
+   *
+   * // With custom limit
+   * const suggestions = await omni.getSearchSuggestions('dress', 3);
+   * ```
+   */
+  async getSearchSuggestions(query, limit) {
+    if (!query || query.trim().length === 0) {
+      return { products: [], categories: [] };
+    }
+    const queryParams = { q: query, limit };
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest(
+        "GET",
+        "/search/suggestions",
+        void 0,
+        queryParams
+      );
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest(
+        "GET",
+        "/search/suggestions",
+        void 0,
+        queryParams
+      );
+    }
+    return this.adminRequest(
+      "GET",
+      "/api/v1/search/suggestions",
+      void 0,
+      queryParams
+    );
+  }
   /**
    * Create a new product
    */
@@ -950,6 +998,7 @@ var OmniSyncClient = class {
   }
   /**
    * Login an existing customer (returns JWT token)
+   * Works in vibe-coded, storefront, and admin mode
    *
    * @example
    * ```typescript
@@ -959,6 +1008,12 @@ var OmniSyncClient = class {
    * ```
    */
   async loginCustomer(email, password) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/login", {
+        email,
+        password
+      });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/customers/login", {
         email,
@@ -972,6 +1027,7 @@ var OmniSyncClient = class {
   }
   /**
    * Register a new customer with password (creates account)
+   * Works in vibe-coded, storefront, and admin mode
    *
    * @example
    * ```typescript
@@ -984,6 +1040,9 @@ var OmniSyncClient = class {
    * ```
    */
   async registerCustomer(data) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/register", data);
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/customers/register", data);
     }
@@ -991,8 +1050,14 @@ var OmniSyncClient = class {
   }
   /**
    * Request a password reset email for a customer
+   * Works in vibe-coded, storefront, and admin mode
    */
   async forgotPassword(email) {
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("POST", "/customers/forgot-password", {
+        email
+      });
+    }
     if (this.storeId && !this.apiKey) {
       return this.storefrontRequest("POST", "/customers/forgot-password", {
         email
@@ -1002,6 +1067,36 @@ var OmniSyncClient = class {
       email
     });
   }
+  /**
+   * Get the current logged-in customer's profile
+   * Requires a customer token to be set via setCustomerToken()
+   * Works in vibe-coded, storefront, and admin mode
+   *
+   * @example
+   * ```typescript
+   * // After login/register, set the token
+   * omni.setCustomerToken(auth.token);
+   *
+   * // Then get the profile
+   * const profile = await omni.getCustomerProfile();
+   * console.log('Customer:', profile.email);
+   * ```
+   */
+  async getCustomerProfile() {
+    if (!this.customerToken) {
+      throw new OmniSyncError("Customer token is required. Call setCustomerToken() first.", 401);
+    }
+    if (this.isVibeCodedMode()) {
+      return this.vibeCodedRequest("GET", "/customers/me");
+    }
+    if (this.storeId && !this.apiKey) {
+      return this.storefrontRequest("GET", "/customers/me");
+    }
+    throw new OmniSyncError(
+      "getCustomerProfile() is not available in admin mode. Use getCustomer(id) instead.",
+      400
+    );
+  }
   /**
    * Get all addresses for a customer
    */

package/package.json

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