@commercengine/pos 0.1.3 → 0.2.0

package/dist/index.d.ts

@@ -683,6 +683,46 @@ interface paths {
     patch?: never;
     trace?: never;
   };
+  "/pos/orders/{order_number}/payment-status": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve payment status
+     * @description Retrieve payment status of a paricular order.
+     */
+    get: operations["pos-get-payment-status"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/payments/payment-options": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List all payment options
+     * @description List all payment options
+     */
+    get: operations["pos-list-payment-options"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
 }
 interface components {
   schemas: {
@@ -1499,6 +1539,28 @@ interface components {
       associated_options: components["schemas"]["AssociatedOption"] | null;
       shipping?: components["schemas"]["ProductShipping"];
     };
+    /** JuspayPaymentGatewayParams */
+    JuspayPaymentGatewayParams: {
+      /**
+       * @description discriminator enum property added by openapi-typescript
+       * @enum {string}
+       */
+      payment_gateway: "JUSPAY";
+      /**
+       * @description `paymentPage` is the default option that you should select when using hyper-checkout
+       * @enum {string}
+       */
+      action: "paymentPage" | "paymentManagement";
+      /**
+       * @description Use `hyper-checkout` for Juspay hosted checkout
+       * @enum {string}
+       */
+      integration_type: "hyper-checkout" | "express-checkout";
+      /** @description This is the URL that the gateway will redirect to once payment processing is complete. This will be a GET request by default */
+      return_url: string;
+      /** @description The exact gateway reference ID that was set up in the integration */
+      gateway_reference_id: string;
+    };
     /**
      * MultiSelectAttribute
      * @description Attribute for multi-select values
@@ -1779,6 +1841,9 @@ interface components {
       limit: number;
       next_page: number | null;
     };
+    /** @enum {string} */
+    PaymentGateway: "PAYU" | "JUSPAY";
+    PaymentGatewayParams: components["schemas"]["PayuPaymentGatewayParams"] | components["schemas"]["JuspayPaymentGatewayParams"];
     /**
      * PaymentInfo
      * @description Common fields in all types of payments.
@@ -1797,6 +1862,38 @@ interface components {
       payment_method?: string | null;
       icon_url?: string | null;
     };
+    /** PayuPaymentGatewayParams */
+    PayuPaymentGatewayParams: {
+      /**
+       * @description discriminator enum property added by openapi-typescript
+       * @enum {string}
+       */
+      payment_gateway: "PAYU";
+      furl: string;
+      surl: string;
+    };
+    /** PayWithCard */
+    PayWithCard: {
+      /** @constant */
+      payment_mode: "CARD";
+    };
+    /** PayWithCash */
+    PayWithCash: {
+      /** @constant */
+      payment_mode: "CASH";
+    };
+    /** PayWithPaymentGateway */
+    PayWithPaymentGateway: {
+      /** @constant */
+      payment_mode: "PG";
+      payment_gateway: components["schemas"]["PaymentGateway"];
+      payment_gateway_params: components["schemas"]["PaymentGatewayParams"];
+    };
+    /** PayWithUPI */
+    PayWithUpi: {
+      /** @constant */
+      payment_mode: "UPI";
+    };
     /** PercentageDiscountRule */
     PercentageDiscountRule: {
       /** @constant */
@@ -2454,7 +2551,7 @@ interface operations {
       path?: never;
       cookie?: never;
     };
-    requestBody?: {
+    requestBody: {
       content: {
         "application/json": {
           device_id: string;
@@ -2491,7 +2588,7 @@ interface operations {
       path?: never;
       cookie?: never;
     };
-    requestBody?: {
+    requestBody: {
       content: {
         "application/json": {
           device_id: string;
@@ -2534,7 +2631,7 @@ interface operations {
       path?: never;
       cookie?: never;
     };
-    requestBody?: {
+    requestBody: {
       content: {
         "application/json": {
           device_id: string;
@@ -2601,7 +2698,7 @@ interface operations {
       path?: never;
       cookie?: never;
     };
-    requestBody?: {
+    requestBody: {
       content: {
         "application/json": {
           pairing_code: string;
@@ -2616,10 +2713,10 @@ interface operations {
         };
         content: {
           "application/json": {
-            message?: string;
-            success?: boolean;
-            content?: {
-              device?: components["schemas"]["PosDevice"];
+            message: string;
+            success: boolean;
+            content: {
+              device: components["schemas"]["PosDevice"];
             };
           };
         };
@@ -2635,7 +2732,7 @@ interface operations {
       path?: never;
       cookie?: never;
     };
-    requestBody?: {
+    requestBody: {
       content: {
         "application/json": {
           refresh_token: string;
@@ -2650,11 +2747,11 @@ interface operations {
         };
         content: {
           "application/json": {
-            message?: string;
-            success?: boolean;
-            content?: {
-              access_token?: string;
-              refresh_token?: string;
+            message: string;
+            success: boolean;
+            content: {
+              access_token: string;
+              refresh_token: string;
             };
           };
         };
@@ -2669,7 +2766,7 @@ interface operations {
       path?: never;
       cookie?: never;
     };
-    requestBody?: {
+    requestBody: {
       content: {
         "application/json": {
           /** @description A string representing the one-time password. */
@@ -2763,10 +2860,10 @@ interface operations {
         };
         content: {
           "application/json": {
-            message?: string;
-            success?: boolean;
-            content?: {
-              coupons?: components["schemas"]["Coupon"][];
+            message: string;
+            success: boolean;
+            content: {
+              coupons: components["schemas"]["Coupon"][];
             };
           };
         };
@@ -2795,10 +2892,10 @@ interface operations {
         };
         content: {
           "application/json": {
-            message?: string;
-            success?: boolean;
-            content?: {
-              promotions?: components["schemas"]["Promotion"][];
+            message: string;
+            success: boolean;
+            content: {
+              promotions: components["schemas"]["Promotion"][];
             };
           };
         };
@@ -3086,11 +3183,11 @@ interface operations {
         };
         content: {
           "application/json": {
-            message?: string;
-            success?: boolean;
-            content?: {
-              applicable_coupons?: components["schemas"]["ApplicableCoupon"][];
-              inapplicable_coupons?: components["schemas"]["InapplicableCoupon"][];
+            message: string;
+            success: boolean;
+            content: {
+              applicable_coupons: components["schemas"]["ApplicableCoupon"][];
+              inapplicable_coupons: components["schemas"]["InapplicableCoupon"][];
             };
           };
         };
@@ -3117,11 +3214,11 @@ interface operations {
         };
         content: {
           "application/json": {
-            message?: string;
-            success?: boolean;
-            content?: {
-              applicable_promotions?: components["schemas"]["ApplicablePromotion"][];
-              inapplicable_promotions?: components["schemas"]["InapplicablePromotion"][];
+            message: string;
+            success: boolean;
+            content: {
+              applicable_promotions: components["schemas"]["ApplicablePromotion"][];
+              inapplicable_promotions: components["schemas"]["InapplicablePromotion"][];
             };
           };
         };
@@ -3284,7 +3381,7 @@ interface operations {
       };
       cookie?: never;
     };
-    requestBody?: {
+    requestBody: {
       content: {
         "application/json": components["schemas"]["PosUpdateCustomerWithId"] | components["schemas"]["PosUpdateCustomerWithPhone"] | components["schemas"]["PosUpdateCustomerWithEmail"];
       };
@@ -3297,10 +3394,10 @@ interface operations {
         };
         content: {
           "application/json": {
-            message?: string;
-            success?: boolean;
-            content?: {
-              cart?: components["schemas"]["Cart"];
+            message: string;
+            success: boolean;
+            content: {
+              cart: components["schemas"]["Cart"];
             };
           };
         };
@@ -3813,7 +3910,7 @@ interface operations {
       content: {
         "application/json": {
           cart_id: string;
-        };
+        } & (components["schemas"]["PayWithCash"] | components["schemas"]["PayWithUpi"] | components["schemas"]["PayWithCard"] | components["schemas"]["PayWithPaymentGateway"]);
       };
     };
     responses: {
@@ -3838,6 +3935,71 @@ interface operations {
       401: components["responses"]["Unauthorized"];
     };
   };
+  "pos-get-payment-status": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description order number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            /** @default order details */
+            readonly message: string;
+            readonly success: boolean;
+            content: {
+              /** @enum {string} */
+              status: "pending" | "success" | "failed" | "partially_paid";
+              /** Format: double */
+              amount_paid: number;
+              /** Format: double */
+              amount_unpaid: number;
+              is_retry_available: boolean;
+            };
+          };
+        };
+      };
+      401: components["responses"]["Unauthorized"];
+      404: components["responses"]["NotFound"];
+    };
+  };
+  "pos-list-payment-options": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              payment_options?: ("CASH" | "UPI" | "CARD" | "PG")[];
+            };
+          };
+        };
+      };
+      401: components["responses"]["Unauthorized"];
+    };
+  };
   "order-created": {
     parameters: {
       query?: never;
@@ -4120,94 +4282,1826 @@ interface operations {
   };
 }
 //#endregion
-//#region ../sdk-core/dist/index.d.ts
-//#region src/types/api.d.ts
-
-/**
- * Core API response types shared across Commerce Engine SDKs
- */
-/**
- * Standard API error response structure
- */
-interface ApiErrorResponse {
-  success?: boolean;
-  error?: any;
-  code?: string;
-  message?: string;
-}
-/**
- * Generic API result type that wraps all SDK responses
- * Provides consistent error handling and response structure
- */
-type ApiResult<T> = {
-  data: T;
-  error: null;
-  response: Response;
-} | {
-  data: null;
-  error: ApiErrorResponse;
-  response: Response;
-};
-//#endregion
-//#region src/types/logger.d.ts
-/**
- * Logger-related types for Commerce Engine SDKs
- */
-/**
- * Debug logger function interface
- */
-interface DebugLoggerFn {
-  (level: "info" | "warn" | "error", message: string, data?: any): void;
-}
-//#endregion
-//#region src/types/config.d.ts
-/**
- * Base SDK configuration options for any OpenAPI-based SDK
- * Completely generic - no assumptions about the underlying API
- */
-interface BaseSDKOptions<TDefaultHeaders extends Record<string, any> = Record<string, any>> {
-  /**
-   * Base URL for the API
-   */
-  baseUrl?: string;
-  /**
-   * Optional timeout in milliseconds
-   */
-  timeout?: number;
-  /**
-   * Default headers to include with API requests
-   * These can be overridden at the method level
-   * Generic type allows each SDK to define its supported headers
-   */
-  defaultHeaders?: TDefaultHeaders;
-  /**
-   * Enable debug mode for detailed request/response logging
-   */
-  debug?: boolean;
-  /**
-   * Custom logger function for debug information
-   */
-  logger?: DebugLoggerFn;
-}
+//#region src/types/admin-pos.d.ts
 /**
- * Header configuration for SDK clients
- * Defines supported headers and optional transformations
+ * This file was auto-generated by openapi-typescript.
+ * Do not make direct changes to the file.
  */
-interface HeaderConfig<T extends Record<string, any>> {
-  /**
-   * Default headers from SDK configuration
-   */
-  defaultHeaders?: T;
-  /**
-   * Optional transformations to apply to header names
-   * Maps SDK parameter names to HTTP header names
-   */
-  transformations?: Record<keyof T, string>;
-}
-//#endregion
-//#region src/base-client.d.ts
-/**
- * Generic base API client that all Commerce Engine SDKs can extend
+
+interface paths$1 {
+  "/pos/catalog/inventories": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List all inventories
+     * @description List all inventories
+     */
+    get: operations$1["pos-list-inventories"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/catalog/inventories/activites": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List all inventories activities
+     * @description Lists all inventory related activities of stock movements. This provides a comprehensive audit trail of inventory operations such as receiving, reservations, adjustments, transfers, and sales.
+     */
+    get: operations$1["pos-list-inventories-activities"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/catalog/inventories/detail": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve inventory detail
+     * @description Retrieves inventory details for a specific product, product variant, or lot/batch based on the parameters provided.
+     */
+    get: operations$1["pos-get-inventory-detail"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/customers": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List all customers
+     * @description List all customers
+     */
+    get: operations$1["pos-get-admin-customers"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/customers/{id}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve customer detail
+     * @description Retrieve customer detail
+     */
+    get: operations$1["pos-get-admin-customers-id"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/orders": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List all orders
+     * @description List all orders
+     */
+    get: operations$1["pos-list-admin-orders"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/orders/{order_number}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve order details
+     * @description Retrieve order details
+     */
+    get: operations$1["pos-get-admin-order"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/orders/{order_number}/activity": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List all order activity
+     * @description List all order activity
+     */
+    get: operations$1["pos-list-order-activity"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/orders/{order_number}/invoice": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve order invoice
+     * @description Retrieve order invoice
+     */
+    get: operations$1["pos-get-order-invoice"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/orders/{order_number}/receipt": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve order receipt
+     * @description Retrieves a printable receipt for a specific order using the order number. This endpoint returns either structured JSON data or a formatted PDF, suitable for customer presentation. Response format (JSON or PDF) is determined by an optional query parameter (e.g. format=pdf or format=json).
+     */
+    get: operations$1["pos-get-order-receipt"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/orders/{order_number}/shipments": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve order shipments
+     * @description Retrieve order shipments
+     */
+    get: operations$1["pos-get-order-shipments"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/shipping/shipments": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * List all shipments
+     * @description List all shipments
+     */
+    get: operations$1["pos-list-shipments"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/shipping/shipments/{order_number}/check-inventory": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Check Inventory
+     * @description Check Inventory
+     */
+    get: operations$1["pos-check-inventory-for-order"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/shipping/shipments/{order_number}/refund-shortfall": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    put?: never;
+    /**
+     * Refund shortfall
+     * @description Refund shortfall
+     */
+    post: operations$1["pos-refund-shortfall-for-order"];
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/shipping/shipments/{reference_number}": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve shipment detail
+     * @description Retrieve shipment detail
+     */
+    get: operations$1["pos-get-shipment"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/shipping/shipments/{reference_number}/invoice": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    /**
+     * Retrieve shipment invoice
+     * @description Retrieve shipment invoice
+     */
+    get: operations$1["pos-get-shipment-invoice"];
+    put?: never;
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+  "/pos/shipping/shipments/{reference_number}/manual-update": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    get?: never;
+    /**
+     * Update shipment detail
+     * @description Update shipment detail
+     */
+    put: operations$1["pos-update-shipment"];
+    post?: never;
+    delete?: never;
+    options?: never;
+    head?: never;
+    patch?: never;
+    trace?: never;
+  };
+}
+interface components$1 {
+  schemas: {
+    /**
+     * BankTransfer
+     * @description Bank transfer payment - IMPS, NEFT, RTGS
+     */
+    BankTransfer: components$1["schemas"]["OrderPaymentInfo"] & {
+      /** @description masked account number
+       *     e.g. ************1234 */
+      bank_account_number?: string;
+      bank_name?: string;
+    };
+    /** BusinessInfo */
+    BusinessInfo: {
+      name?: string;
+      business_type?: string;
+      pan_number?: string;
+      gstin?: string;
+      is_registered_under_gst?: boolean;
+    };
+    /**
+     * CardPayment
+     * @description Payments using credit card, debit card
+     */
+    CardPayment: components$1["schemas"]["OrderPaymentInfo"] & {
+      /** @description masked card number
+       *     e.g. ************1111 */
+      card_number?: string;
+      /** @enum {unknown} */
+      card_type?: "Visa" | "Master Card" | "Rupay";
+    };
+    /** Customer */
+    Customer: components$1["schemas"]["CustomerInfo"] & {
+      business?: components$1["schemas"]["BusinessInfo"];
+      segments?: components$1["schemas"]["CustomerSegment"][];
+    };
+    /** CustomerAddress */
+    CustomerAddress: {
+      readonly id?: string;
+      first_name: string;
+      last_name?: string;
+      /** @description Two-letter code begin with a plus sign prefix that identifies different countries. By default it will be +91 if not provided.
+       *      */
+      country_code?: string;
+      /** @description 10 digit phone number without country code. */
+      phone: string;
+      email: string;
+      address_line1: string;
+      address_line2?: string | null;
+      landmark?: string | null;
+      pincode: string;
+      city: string;
+      state: string;
+      /** @enum {unknown} */
+      country: "India";
+      /** @description Use in shipping details only for third party. */
+      gstin?: string | null;
+      /** @description Use in shipping details only for third party. */
+      business_name?: string | null;
+      readonly is_phone_verified?: boolean;
+      readonly is_email_verified?: boolean;
+    };
+    /** CustomerDetail */
+    CustomerDetail: components$1["schemas"]["Customer"] & {
+      loyalty?: components$1["schemas"]["CustomerLoyalty"];
+      notification_preferences?: components$1["schemas"]["NotificationPreferences"];
+    };
+    /** CustomerInfo */
+    CustomerInfo: {
+      /** @description user id */
+      readonly id?: string;
+      first_name?: string;
+      last_name?: string;
+      readonly full_name?: string;
+      readonly profile_image_url?: string;
+      country_code?: string;
+      phone?: string;
+      email?: string;
+      readonly is_phone_verified?: boolean;
+      readonly is_email_verified?: boolean;
+      readonly is_whatsapp_verified?: boolean;
+      /** @enum {unknown} */
+      status?: "active" | "inactive" | "suspended" | "blocked";
+      /** Format: date-time */
+      readonly created_at?: string;
+      /** Format: date-time */
+      readonly modified_at?: string;
+      /** Format: date-time */
+      readonly last_seen?: string;
+      readonly kyc_status?: boolean;
+      readonly is_verified?: boolean;
+      tags?: string[];
+    };
+    /** CustomerLoyalty */
+    CustomerLoyalty: {
+      membership_number?: string;
+      /** @description total points earned within the current loyalty program. */
+      points_earned?: number;
+      /** @description total points redeemed within the current loyalty program. */
+      points_redeemed?: number;
+      /** @description total points available. */
+      points_balance?: number;
+      /** @description The total amount a customer has spent within the current loyalty program, excluding taxes, promotional discounts, and redeemed loyalty points. This value is used to determine tier eligibility and earning points calculation. */
+      total_spent?: number;
+      /** @description The total number of completed orders counted in the current loyalty program. */
+      total_orders?: number;
+      /** @description  The total amount a customer has spent across all time, regardless of loyalty program participation. This includes all completed orders and excludes taxes, promotional discounts, and redeemed points. */
+      lifetime_spent?: number;
+      /** @description The total number of completed orders across all time, regardless of loyalty program. */
+      lifetime_orders?: number;
+      /**
+       * Format: date-time
+       * @description  The date and time when the customer first enrolled in the loyalty program.
+       */
+      date_of_join?: string;
+      /**
+       * Format: date-time
+       * @description The date and time when the customer's current loyalty tier or program instance was assigned. This may change when tiers are upgraded, downgraded, or reassigned.
+       */
+      date_of_assign?: string | null;
+      /**
+       * Format: date-time
+       * @description  The date and time when the customer’s current loyalty program cycle will reset, at which points earned, points redeemed, balance points, total spent, total orders will be cleared.
+       */
+      date_of_reset?: string | null;
+      current_tier?: {
+        id?: string;
+        name?: string;
+      };
+      next_tier?: {
+        id?: string;
+        name?: string;
+        total_spent_threshold?: number | null;
+        total_orders_threshold?: number | null;
+      };
+    };
+    /** CustomerSegment */
+    CustomerSegment: {
+      id?: string;
+      name?: string;
+    };
+    /** InventoryActivity */
+    InventoryActivity: {
+      product_id?: string;
+      product_name?: string;
+      variant_id?: string;
+      variant_name?: string;
+      sku?: string;
+      warehouse_id?: string;
+      warehouse?: components$1["schemas"]["WarehouseBasicDetail"];
+      /** @enum {unknown} */
+      activity_type?: "add" | "reserve" | "reduce" | "adjust" | "update";
+      quantity?: number;
+      reason?: string;
+      lot_batch?: string;
+      /** Format: date */
+      mfg_date?: string;
+      /** Format: date */
+      exp_date?: string;
+      manufacturer?: string;
+      /** Format: date-time */
+      created_at?: string;
+      /** Format: date-time */
+      modified_at?: string;
+    };
+    /** InventoryDetail */
+    InventoryDetail: components$1["schemas"]["ItemWiseInventory"] & {
+      details?: components$1["schemas"]["WarehouseWiseInventory"][];
+    };
+    /**
+     * Invoice
+     * @description Invoice model
+     */
+    Invoice: {
+      invoice_number?: string;
+      /** Format: date-time */
+      invoice_date?: string;
+      /** @description Invoice Reference Number */
+      irn_number?: string;
+      /** @description Acknowledgement Number */
+      ack_number?: string;
+      /**
+       * Format: date-time
+       * @description Acknowledgement Date
+       */
+      ack_date?: string;
+      signed_qr_code?: string;
+      gatepass_barcode?: string;
+      seller_details?: components$1["schemas"]["Warehouse"];
+      billing_address?: components$1["schemas"]["CustomerAddress"];
+      shipping_address?: components$1["schemas"]["CustomerAddress"];
+      subtotal?: number;
+      shipping_amount?: number;
+      coupon_code?: string;
+      coupon_discount_percent?: number;
+      coupon_discount_amount?: number;
+      total_tax?: number;
+      grand_total?: number;
+      tax_summary?: {
+        tax_rate?: number;
+        taxable_value?: number;
+        igst?: number;
+        cgst?: number;
+        sgst?: number;
+      }[];
+      /** Format: date-time */
+      created_at?: string;
+      /** Format: date-time */
+      modified_at?: string;
+    };
+    /**
+     * InvoiceDetail
+     * @description InvoiceDetail model
+     */
+    InvoiceDetail: components$1["schemas"]["Invoice"] & {
+      items?: components$1["schemas"]["InvoiceItem"][];
+    };
+    /**
+     * InvoiceItem
+     * @description InvoiceItem model
+     */
+    InvoiceItem: {
+      sku?: string;
+      product_name?: string;
+      product_image_url?: string;
+      listing_price?: number;
+      selling_price?: number;
+      qty?: number;
+      free_qty?: number;
+      tax_type?: string;
+      tax_rate?: number;
+      hsncode?: string;
+      batch_number?: string;
+      expiry?: string;
+      amount?: number;
+    };
+    /** ItemWiseInventory */
+    ItemWiseInventory: {
+      product_id?: string;
+      product_name?: string;
+      variant_id?: string;
+      variant_name?: string;
+      sku?: string;
+      track_quantity?: boolean;
+      allow_backorder?: boolean;
+      track_lot_bacth?: boolean;
+      received_quantity?: number;
+      reserved_quantity?: number;
+      sold_quantity?: number;
+      adjusted_quantity?: number;
+      stock_quantity?: number;
+    };
+    /** LotBatchWiseInventory */
+    LotBatchWiseInventory: components$1["schemas"]["ItemWiseInventory"] & {
+      lot_batch?: string;
+      /** Format: date */
+      mfg_date?: string;
+      /** Format: date */
+      exp_date?: string;
+      manufacturer?: string;
+    };
+    /**
+     * LoyaltyPointPayment
+     * @description Loyalty point redemption.
+     */
+    LoyaltyPointPayment: components$1["schemas"]["OrderPaymentInfo"];
+    /**
+     * NetbankingPayment
+     * @description Payments using payment gateway netbanking option.
+     */
+    NetbankingPayment: components$1["schemas"]["OrderPaymentInfo"] & {
+      bank_name?: string;
+    };
+    /**
+     * NotificationChannelPreferences
+     * @description Set specific channel preferences
+     */
+    NotificationChannelPreferences: {
+      /**
+       * @description Indicates whether the user has opted to receive notifications via email.
+       * @default true
+       */
+      email: boolean;
+      /**
+       * @description Indicates whether the user has opted to receive notifications via SMS.
+       * @default true
+       */
+      sms: boolean;
+      /**
+       * @description Indicates whether the user has opted to receive notifications via WhatsApp.
+       * @default true
+       */
+      whatsapp: boolean;
+    };
+    /**
+     * NotificationPreferences
+     * @description Set channel preferences for each type of
+     */
+    NotificationPreferences: {
+      /** @description These notifications are typically critical for user engagement, providing updates, confirmations, or alerts related to their account activities. */
+      transactional?: components$1["schemas"]["NotificationChannelPreferences"];
+      /** @description These notifications aim to engage users with promotional content and enhance their overall experience with the platform. */
+      promotional?: components$1["schemas"]["NotificationChannelPreferences"];
+      /** @description These notifications are often sent periodically as part of a subscription service.
+       *      */
+      newsletter?: components$1["schemas"]["NotificationChannelPreferences"];
+    };
+    /** Order */
+    Order: {
+      order_number?: string;
+      /** Format: date-time */
+      order_date?: string;
+      /** @enum {string} */
+      status?: "draft" | "awaiting_approval" | "cancelled" | "shipped" | "delivered" | "awaiting_shipment";
+      /** @enum {string} */
+      payment_status?: "pending" | "success" | "failed" | "partially_paid" | "refunded";
+      /** Format: date-time */
+      payment_success_date?: string;
+      customer_id?: string;
+      customer_email?: string | null;
+      customer_phone?: string | null;
+      customer_note?: string | null;
+      is_promotion_applied?: boolean;
+      promotion_discount_amount?: number | null;
+      is_coupon_applied?: boolean;
+      coupon_code?: string | null;
+      /** Format: double */
+      coupon_discount_amount?: number | null;
+      on_subscription?: boolean;
+      /** Format: double */
+      subtotal?: number;
+      /** Format: double */
+      item_total_tax?: number;
+      /** Format: double */
+      subtotal_including_tax?: number;
+      /** Format: double */
+      shipping_amount?: number;
+      /** Format: double */
+      shipping_total_tax?: number;
+      /** Format: double */
+      shipping_amount_including_tax?: number;
+      /** Format: double */
+      total_tax?: number;
+      /** Format: double */
+      grand_total?: number;
+      loyalty_point_redeemed?: number;
+      credit_balance_used?: number;
+      /** Format: double */
+      to_be_paid?: number;
+      loyalty_point_earned?: number;
+      order_items_count?: number;
+      currency?: {
+        name?: string;
+        code?: string;
+        symbol?: string;
+      };
+      /** Format: date-time */
+      created_at?: string;
+      /** Format: date-time */
+      modified_at?: string;
+    };
+    /** OrderActivity */
+    OrderActivity: {
+      readonly activity_type?: string;
+      readonly order_status?: string;
+      comment: string;
+      /** @enum {unknown} */
+      readonly user_type?: "customer" | "admin" | "system";
+      readonly user_name?: string;
+      /** Format: date-time */
+      readonly created_at?: string;
+      /** Format: date-time */
+      readonly modified_at?: string;
+    };
+    /** OrderDetail */
+    OrderDetail: {
+      order_number?: string;
+      /** Format: date-time */
+      order_date?: string;
+      /** @enum {string} */
+      status?: "draft" | "awaiting_approval" | "cancelled" | "shipped" | "delivered" | "awaiting_shipment";
+      /** @enum {string} */
+      payment_status?: "pending" | "success" | "failed" | "partially_paid" | "refunded";
+      /** Format: date-time */
+      payment_success_date?: string;
+      customer_id?: string;
+      customer_email?: string | null;
+      customer_phone?: string | null;
+      customer_note?: string | null;
+      is_promotion_applied?: boolean;
+      promotion_discount_amount?: number | null;
+      is_coupon_applied?: boolean;
+      coupon_code?: string | null;
+      /** Format: double */
+      coupon_discount_amount?: number | null;
+      on_subscription?: boolean;
+      /** Format: double */
+      subtotal?: number;
+      /** Format: double */
+      item_total_tax?: number;
+      /** Format: double */
+      subtotal_including_tax?: number;
+      /** Format: double */
+      shipping_amount?: number;
+      /** Format: double */
+      shipping_total_tax?: number;
+      /** Format: double */
+      shipping_amount_including_tax?: number;
+      /** Format: double */
+      total_tax?: number;
+      /** Format: double */
+      grand_total?: number;
+      loyalty_point_redeemed?: number;
+      credit_balance_used?: number;
+      /** Format: double */
+      to_be_paid?: number;
+      loyalty_point_earned?: number;
+      order_items_count?: number;
+      order_items?: components$1["schemas"]["OrderItem"][];
+      billing_address?: components$1["schemas"]["CustomerAddress"];
+      shipping_address?: components$1["schemas"]["CustomerAddress"];
+      currency?: {
+        name?: string;
+        code?: string;
+        symbol?: string;
+      };
+      payments?: components$1["schemas"]["OrderPayment"][];
+      shipments?: components$1["schemas"]["OrderShipment"][];
+      /** Format: date-time */
+      created_at?: string;
+      /** Format: date-time */
+      modified_at?: string;
+    };
+    /** OrderItem */
+    OrderItem: {
+      readonly product_id?: string;
+      readonly product_name?: string;
+      readonly product_image_url?: string | null;
+      sku: string;
+      readonly on_offer?: boolean;
+      readonly on_promotion?: boolean;
+      on_subscription?: boolean;
+      subscription_plan?: string | null;
+      readonly subscription_interval?: number | null;
+      readonly subscription_frequency?: string | null;
+      quantity: number;
+      readonly free_quantity?: number;
+      readonly is_free_item?: boolean;
+      /** Format: double */
+      readonly selling_price?: number;
+      /** Format: double */
+      readonly listing_price?: number;
+      /** Format: double */
+      readonly promotion_discount_amount?: number;
+      /** Format: double */
+      readonly coupon_discount_amount?: number;
+      /** @enum {unknown} */
+      readonly tax_type?: "GST";
+      /** Format: float */
+      readonly tax_rate?: number;
+      /** Format: double */
+      readonly tax_amount?: number;
+      /** Format: double */
+      readonly shipping_additional_cost?: number;
+    };
+    /**
+     * OrderList
+     * @description order list model
+     */
+    OrderList: {
+      /** @description Unique number associated with the order. */
+      order_number?: string;
+      /**
+       * Format: date-time
+       * @description Date and time when the order was placed.
+       */
+      order_date?: string;
+      /**
+       * @description Current status of the order (e.g., "pending," "processing," "shipped," etc.).
+       * @enum {string}
+       */
+      status?: "draft" | "awaiting_approval" | "cancelled" | "shipped" | "delivered" | "awaiting_shipment" | "pending" | "payment_failed" | "schedule_requested";
+      /**
+       * @description Current payment status of the order (e.g., "pending," "success," "failed").
+       * @enum {string}
+       */
+      payment_status?: "pending" | "success" | "failed" | "partially_paid" | "refunded";
+      /** @description Date and time when the payment for the order was successfully processed. */
+      payment_success_date?: string | null;
+      /** @description Indicates whether the order has a refund associated with it or not. */
+      has_refund?: boolean;
+      /** @description Indicates whether the order includes subscription items. */
+      on_subscription?: boolean;
+      /**
+       * Format: double
+       * @description Total amount for the order, including all items, taxes, and discounts.
+       */
+      grand_total?: number;
+      /** @description Number of loyalty points redeemed in the order. */
+      loyalty_point_redeemed?: number;
+      /** @description Amount of credit balance used in the order. */
+      credit_balance_used?: number;
+      /**
+       * Format: double
+       * @description Amount remaining to be paid for the order.
+       */
+      to_be_paid?: number;
+      /** @description Total count of items included in the order. */
+      order_items_count?: number;
+      order_items?: components$1["schemas"]["OrderItem"][];
+      customer_id?: string;
+      customer_note?: string | null;
+      billing_address?: components$1["schemas"]["CustomerAddress"];
+      shipping_address?: components$1["schemas"]["CustomerAddress"];
+      loyalty_point_earned?: number;
+      currency?: {
+        name?: string;
+        code?: string;
+        symbol?: string;
+      };
+      /** Format: date-time */
+      created_at?: string;
+      /** Format: date-time */
+      modified_at?: string;
+    };
+    /**
+     * OrderPayment
+     * @description Order Payment
+     */
+    OrderPayment: components$1["schemas"]["CardPayment"] | components$1["schemas"]["NetbankingPayment"] | components$1["schemas"]["UpiPayment"] | components$1["schemas"]["WalletPayment"] | components$1["schemas"]["BankTransfer"] | components$1["schemas"]["LoyaltyPointPayment"];
+    /**
+     * OrderPaymentInfo
+     * @description Common fields in all types of payments.
+     */
+    OrderPaymentInfo: {
+      /** @enum {unknown} */
+      transaction_type?: "payment" | "refund";
+      request_number?: string;
+      /** Format: double */
+      amount?: number;
+      /** @enum {unknown} */
+      payment_status?: "pending" | "success" | "failed" | "partially_paid" | "refund_initiated";
+      /** Format: date-time */
+      payment_date?: string;
+      payment_reference_number?: string | null;
+      /** @enum {unknown} */
+      payment_method?: "Credit Card" | "Debit Card" | "Netbanking" | "UPI" | "Wallet" | "Loyalty Point" | "IMPS" | "NEFT" | "RTGS";
+      icon_url?: string;
+    };
+    /** OrderReceiptJsonFormat */
+    OrderReceiptJsonFormat: components$1["schemas"]["Order"] & {
+      billing_address?: components$1["schemas"]["CustomerAddress"];
+      shipping_address?: components$1["schemas"]["CustomerAddress"];
+      order_items?: components$1["schemas"]["OrderItem"][];
+      payments?: components$1["schemas"]["OrderPayment"][];
+    };
+    /**
+     * OrderShipment
+     * @description Order shipment model
+     */
+    OrderShipment: {
+      reference_number?: string;
+      /** @enum {unknown} */
+      status?: "pending" | "approved" | "shipped" | "delivered" | "cancelled";
+      total_weight?: number;
+      total_boxes?: number;
+      shipment_items_count?: number;
+      shipment_items?: components$1["schemas"]["ShipmentItem"][];
+      /** Format: double */
+      shipping_amount?: number;
+      /** Format: double */
+      shipping_tax_amount?: number;
+      /** Format: double */
+      shipping_amount_including_tax?: number;
+      courier_company_id?: string;
+      courier_company_name?: string;
+      shipping_label_url?: string;
+      awb_no?: string;
+      eta_delivery?: string;
+      /** Format: date-time */
+      shipped_date?: string;
+      /** Format: date-time */
+      delivered_date?: string;
+      cancellation_reason?: string;
+      /** Format: date-time */
+      created_at?: string;
+      /** Format: date-time */
+      modified_at?: string;
+    };
+    /** @description pagination metadata structure */
+    Pagination: {
+      total_records?: number;
+      total_pages?: number;
+      previous_page?: ((number | null) | null) | null;
+      /** @default 25 */
+      limit: number;
+      next_page?: ((number | null) | null) | null;
+    };
+    /** Shipment */
+    Shipment: components$1["schemas"]["ShipmentInfo"] & {
+      shipment_items?: components$1["schemas"]["ShipmentItem"][];
+    } & {
+      packing?: components$1["schemas"]["ShipmentPackaging"];
+    } & {
+      progression?: components$1["schemas"]["ShipmentProgression"][];
+    };
+    /** ShipmentBox */
+    ShipmentBox: {
+      box_name?: string;
+      box_length?: number;
+      box_width?: number;
+      box_height?: number;
+      box_weight?: number;
+      items_count?: number | null;
+      box_count?: number | null;
+    };
+    /** ShipmentDetail */
+    ShipmentDetail: {
+      order_number?: string;
+      /** Format: date-time */
+      order_date?: string;
+      order_status?: string;
+      /** @enum {unknown} */
+      payment_status?: "pending" | "success" | "failed";
+      customer_name?: string;
+      shipments?: components$1["schemas"]["Shipment"][];
+      /** @description dynamic values as per current status of the shipment. */
+      allowed_actions?: string[];
+    };
+    /** ShipmentInfo */
+    ShipmentInfo: {
+      order_number?: string;
+      order_status?: string;
+      shipment_number?: string;
+      warehouse_id?: string;
+      warehouse_name?: string;
+      status?: string;
+      total_weight?: number;
+      total_boxes?: number;
+      shipment_items_count?: number;
+      /** Format: double */
+      shipping_amount?: number;
+      /** Format: double */
+      shipping_tax_amount?: number;
+      /** Format: double */
+      shipping_amount_including_tax?: number;
+      courier_company_id?: string | null;
+      courier_company_name?: string | null;
+      courier_company_image_url?: string | null;
+      awb_no?: string | null;
+      shipping_label_url?: string | null;
+      eta_delivery?: string | null;
+      shipped_date?: string | null;
+      delivered_date?: string | null;
+      slo?: {
+        /** Format: date */
+        expected_date?: string;
+        /** Format: date */
+        actual_date?: string;
+        difference?: string;
+      };
+      cancellation_reason?: string | null;
+      customer_id?: string;
+      customer_name?: string;
+      shipping_address_line1?: string;
+      shipping_address_line2?: string;
+      shipping_landmark?: string;
+      shipping_pincode?: string;
+      shipping_city?: string;
+      shipping_state?: string;
+      created_at?: string;
+      modified_at?: string;
+    };
+    /**
+     * ShipmentItem
+     * @description Shipment item model
+     */
+    ShipmentItem: {
+      product_id: string;
+      readonly product_name?: string;
+      variant_id: string | null;
+      readonly variant_name?: string | null;
+      readonly product_image_url?: string | null;
+      readonly sku?: string;
+      quantity: number;
+      free_quantity?: number;
+      readonly is_free_item?: boolean;
+    };
+    /** ShipmentList */
+    ShipmentList: {
+      order_number?: string;
+    } & components$1["schemas"]["ShipmentInfo"];
+    /** ShipmentPackaging */
+    ShipmentPackaging: {
+      /** @enum {unknown} */
+      package_option?: "Automatic" | "Custom";
+      boxes_count?: number;
+      boxes?: components$1["schemas"]["ShipmentBox"][];
+    };
+    /** ShipmentProgression */
+    ShipmentProgression: {
+      readonly status?: string;
+      readonly is_current?: boolean;
+      readonly is_completed?: boolean;
+      /** Format: date-time */
+      readonly completion_date?: string;
+    };
+    /**
+     * UpiPayment
+     * @description UPI Payment
+     */
+    UpiPayment: components$1["schemas"]["OrderPaymentInfo"] & {
+      upi_id?: string;
+    };
+    /** WalletPayment */
+    WalletPayment: components$1["schemas"]["OrderPaymentInfo"] & {
+      wallet_name?: string;
+    };
+    /** Warehouse */
+    Warehouse: {
+      /** @description warehouse ulid */
+      readonly id: string;
+      /** @description legal name */
+      readonly name: string;
+      readonly gstin?: string;
+      readonly city: string;
+      readonly address_line1: string;
+      readonly address_line2?: string;
+      readonly larndmark?: string;
+      pincode: string;
+      state: string;
+      /** @description 10 digit number without country code. */
+      contact_phone: number;
+      /** Format: email */
+      contact_email: string;
+      /** @default false */
+      is_default: boolean;
+    };
+    /** WarehouseBasicDetail */
+    WarehouseBasicDetail: {
+      id?: string;
+      name?: string;
+      address_line1?: string;
+      pincode?: string;
+      city?: string;
+      state?: string;
+      is_default?: boolean;
+    };
+    /** WarehouseWiseInventory */
+    WarehouseWiseInventory: {
+      lot_bacth?: string;
+      /** Format: date */
+      mfg_date?: string;
+      /** Format: date */
+      exp_date?: string;
+      manufacturer?: string;
+      warehouse_id?: string;
+      warehouse?: components$1["schemas"]["WarehouseBasicDetail"];
+      received_quantity?: number;
+      reserved_quantity?: number;
+      sold_quantity?: number;
+      adjusted_quantity?: number;
+      stock_quantity?: number;
+    };
+  };
+  responses: never;
+  parameters: {
+    /** @description JSON object */
+    columnBasedFilters: string;
+    /** @description no of rows per page */
+    pageLimit: number;
+    /** @description page number of pagination list */
+    pageNumber: number;
+    /** @description search keyword */
+    searchKeyword: string;
+    /** @description JSON string format: {"field1":"asc", "field2":"desc"} */
+    sortByOptions: string;
+  };
+  requestBodies: never;
+  headers: never;
+  pathItems: never;
+}
+interface operations$1 {
+  "pos-list-inventories": {
+    parameters: {
+      query?: {
+        /** @description page number of pagination list */
+        page?: components$1["parameters"]["pageNumber"];
+        /** @description no of rows per page */
+        limit?: components$1["parameters"]["pageLimit"];
+        /** @description JSON string format: {"field1":"asc", "field2":"desc"} */
+        sort_by?: components$1["parameters"]["sortByOptions"];
+        /** @description JSON object */
+        filters?: components$1["parameters"]["columnBasedFilters"];
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              inventories?: (components$1["schemas"]["ItemWiseInventory"] | components$1["schemas"]["LotBatchWiseInventory"])[];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-list-inventories-activities": {
+    parameters: {
+      query?: {
+        /** @description page number of pagination list */
+        page?: components$1["parameters"]["pageNumber"];
+        /** @description no of rows per page */
+        limit?: components$1["parameters"]["pageLimit"];
+        /** @description JSON string format: {"field1":"asc", "field2":"desc"} */
+        sort_by?: components$1["parameters"]["sortByOptions"];
+        /** @description JSON object */
+        filters?: components$1["parameters"]["columnBasedFilters"];
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              activities?: components$1["schemas"]["InventoryActivity"][];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-get-inventory-detail": {
+    parameters: {
+      query: {
+        /** @description lot batch of selected productor or variant. */
+        lot_batch?: string;
+        /** @description Product Id */
+        product_id: string;
+        /** @description Variant Id */
+        variant_id?: string;
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              inventory?: components$1["schemas"]["InventoryDetail"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-get-admin-customers": {
+    parameters: {
+      query?: {
+        /** @description page number of pagination list */
+        page?: components$1["parameters"]["pageNumber"];
+        /** @description no of rows per page */
+        limit?: components$1["parameters"]["pageLimit"];
+        /** @description JSON object */
+        filters?: components$1["parameters"]["columnBasedFilters"];
+        /** @description JSON string format: {"field1":"asc", "field2":"desc"} */
+        sort_by?: components$1["parameters"]["sortByOptions"];
+        /** @description search keyword */
+        search?: components$1["parameters"]["searchKeyword"];
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              customers?: components$1["schemas"]["Customer"][];
+              pagination?: components$1["schemas"]["Pagination"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-get-admin-customers-id": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description Customer Id */
+        id: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              customer?: components$1["schemas"]["CustomerDetail"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-list-admin-orders": {
+    parameters: {
+      query?: {
+        /** @description page number of pagination list */
+        page?: components$1["parameters"]["pageNumber"];
+        /** @description no of rows per page */
+        limit?: components$1["parameters"]["pageLimit"];
+        /** @description JSON object */
+        filters?: components$1["parameters"]["columnBasedFilters"];
+        /** @description JSON string format: {"field1":"asc", "field2":"desc"} */
+        sort_by?: components$1["parameters"]["sortByOptions"];
+        /** @description search keyword */
+        search?: components$1["parameters"]["searchKeyword"];
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              orders?: components$1["schemas"]["OrderList"][];
+              pagination?: components$1["schemas"]["Pagination"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-get-admin-order": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description order number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              order?: components$1["schemas"]["OrderDetail"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-list-order-activity": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description order number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              activity?: components$1["schemas"]["OrderActivity"][];
+              pagination?: components$1["schemas"]["Pagination"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-get-order-invoice": {
+    parameters: {
+      query?: {
+        /** @description Response data format */
+        format?: "json" | "pdf";
+      };
+      header?: never;
+      path: {
+        /** @description order number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              invoices?: components$1["schemas"]["InvoiceDetail"][];
+            };
+          };
+          "application/pdf": Record<string, never>;
+        };
+      };
+    };
+  };
+  "pos-get-order-receipt": {
+    parameters: {
+      query?: {
+        /** @description Response data format */
+        format?: "json" | "pdf";
+      };
+      header?: never;
+      path: {
+        /** @description order number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              order_receipt?: components$1["schemas"]["OrderReceiptJsonFormat"];
+            };
+          };
+          "application/pdf": Record<string, never>;
+        };
+      };
+    };
+  };
+  "pos-get-order-shipments": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description order number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              shipment?: components$1["schemas"]["ShipmentDetail"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-list-shipments": {
+    parameters: {
+      query?: {
+        /** @description page number of pagination list */
+        page?: components$1["parameters"]["pageNumber"];
+        /** @description no of rows per page */
+        limit?: components$1["parameters"]["pageLimit"];
+        /** @description JSON object */
+        filters?: components$1["parameters"]["columnBasedFilters"];
+        /** @description JSON string format: {"field1":"asc", "field2":"desc"} */
+        sort_by?: components$1["parameters"]["sortByOptions"];
+        /** @description search keyword */
+        search?: components$1["parameters"]["searchKeyword"];
+      };
+      header?: never;
+      path?: never;
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              shipments?: components$1["schemas"]["ShipmentList"][];
+              pagination?: components$1["schemas"]["Pagination"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-check-inventory-for-order": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description Order number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              /** @enum {unknown} */
+              inventory_status?: "fulfilled" | "partially-fulfilled" | "not-fulfilled";
+              shipment_items?: components$1["schemas"]["ShipmentItem"][];
+              recommended_warehouses?: {
+                id?: string;
+                name?: string;
+                /** @enum {unknown} */
+                inventory_status?: "fulfilled" | "partially-fulfilled" | "not-fulfilled";
+              }[];
+              inventory_detail?: {
+                sku?: string;
+                total_quantity?: number;
+                warehouses?: {
+                  warehouse_id?: string;
+                  warehouse_name?: string;
+                  quantity?: number;
+                }[];
+              }[];
+              allowed_action?: string[];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-refund-shortfall-for-order": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description Order Number */
+        order_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: {
+      content: {
+        "application/json": {
+          items: {
+            sku: string;
+            quantity: number;
+            /** @default 0 */
+            free_quantity?: number;
+          }[];
+          /** @enum {unknown} */
+          payment_method: "original-payment-mode" | "bank-transfer";
+          /** @description required if payment_method = bank-transfer */
+          bank_account_id?: string | null;
+        };
+      };
+    };
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+          };
+        };
+      };
+    };
+  };
+  "pos-get-shipment": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description Shipment reference number */
+        reference_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              shipment?: components$1["schemas"]["ShipmentDetail"];
+            };
+          };
+        };
+      };
+    };
+  };
+  "pos-get-shipment-invoice": {
+    parameters: {
+      query?: {
+        /** @description Response data format */
+        format?: "json" | "pdf";
+      };
+      header?: never;
+      path: {
+        /** @description Shipment reference number */
+        reference_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: never;
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              invoice?: components$1["schemas"]["InvoiceDetail"];
+            };
+          };
+          "application/pdf": Record<string, never>;
+        };
+      };
+    };
+  };
+  "pos-update-shipment": {
+    parameters: {
+      query?: never;
+      header?: never;
+      path: {
+        /** @description Shipment reference number */
+        reference_number: string;
+      };
+      cookie?: never;
+    };
+    requestBody?: {
+      content: {
+        "application/json": {
+          status?: string;
+          warehouse_id?: string;
+          awb_no?: string;
+          courier_company_name?: string;
+          shipping_label_url?: string;
+          tracking_url?: string;
+          manual_shipping_charges?: number;
+          /** Format: date-time */
+          eta_delivery?: string;
+          /** Format: date-time */
+          shipped_date?: string;
+          /** Format: date-time */
+          out_for_delivery_date?: string;
+          /** Format: date-time */
+          delivered_date?: string;
+        };
+      };
+    };
+    responses: {
+      /** @description OK */
+      200: {
+        headers: {
+          [name: string]: unknown;
+        };
+        content: {
+          "application/json": {
+            message?: string;
+            success?: boolean;
+            content?: {
+              shipment?: components$1["schemas"]["ShipmentDetail"];
+            };
+          };
+        };
+      };
+    };
+  };
+}
+//#endregion
+//#region ../sdk-core/dist/index.d.ts
+//#region src/types/api.d.ts
+
+/**
+ * Core API response types shared across Commerce Engine SDKs
+ */
+/**
+ * Standard API error response structure
+ */
+interface ApiErrorResponse {
+  success?: boolean;
+  error?: any;
+  code?: string;
+  message?: string;
+}
+/**
+ * Generic API result type that wraps all SDK responses
+ * Provides consistent error handling and response structure
+ */
+type ApiResult<T> = {
+  data: T;
+  error: null;
+  response: Response;
+} | {
+  data: null;
+  error: ApiErrorResponse;
+  response: Response;
+};
+//#endregion
+//#region src/types/logger.d.ts
+/**
+ * Logger-related types for Commerce Engine SDKs
+ */
+/**
+ * Debug logger function interface
+ */
+interface DebugLoggerFn {
+  (level: "info" | "warn" | "error", message: string, data?: any): void;
+}
+//#endregion
+//#region src/types/config.d.ts
+/**
+ * Base SDK configuration options for any OpenAPI-based SDK
+ * Completely generic - no assumptions about the underlying API
+ */
+interface BaseSDKOptions<TDefaultHeaders extends Record<string, any> = Record<string, any>> {
+  /**
+   * Base URL for the API
+   */
+  baseUrl?: string;
+  /**
+   * Optional timeout in milliseconds
+   */
+  timeout?: number;
+  /**
+   * Default headers to include with API requests
+   * These can be overridden at the method level
+   * Generic type allows each SDK to define its supported headers
+   */
+  defaultHeaders?: TDefaultHeaders;
+  /**
+   * Enable debug mode for detailed request/response logging
+   */
+  debug?: boolean;
+  /**
+   * Custom logger function for debug information
+   */
+  logger?: DebugLoggerFn;
+}
+/**
+ * Header configuration for SDK clients
+ * Defines supported headers and optional transformations
+ */
+interface HeaderConfig<T extends Record<string, any>> {
+  /**
+   * Default headers from SDK configuration
+   */
+  defaultHeaders?: T;
+  /**
+   * Optional transformations to apply to header names
+   * Maps SDK parameter names to HTTP header names
+   */
+  transformations?: Record<keyof T, string>;
+}
+//#endregion
+//#region src/base-client.d.ts
+/**
+ * Generic base API client that all Commerce Engine SDKs can extend
  * Handles common functionality like middleware setup, request execution, and header management
  * Does NOT include token management - that's SDK-specific
  *
@@ -4274,6 +6168,13 @@ declare class BaseAPIClient<TPaths extends Record<string, any>, THeaders extends
    * @returns Current default headers
    */
   getDefaultHeaders(): THeaders | undefined;
+  /**
+   * Add middleware to the client
+   * This allows SDK extensions to add custom middleware like authentication
+   *
+   * @param middleware - Middleware to add to the client
+   */
+  use(middleware: any): void;
 }
 //#endregion
 //#region src/utils/url.d.ts
@@ -4449,11 +6350,12 @@ declare function mergeAndTransformHeaders<T extends Record<string, any> = Record
 //#endregion
 //#endregion
 //#region src/lib/client.d.ts
+type CombinedPaths = paths & paths$1;
 /**
  * POS API client that extends the generic BaseAPIClient
  * Adds Commerce Engine POS specific authentication and token management
  */
-declare class PosAPIClient extends BaseAPIClient<paths, SupportedDefaultHeaders> {
+declare class PosAPIClient extends BaseAPIClient<CombinedPaths, SupportedDefaultHeaders> {
   protected config: PosSDKOptions;
   private initializationPromise;
   /**
@@ -4515,6 +6417,16 @@ declare class PosAPIClient extends BaseAPIClient<paths, SupportedDefaultHeaders>
    * Initialize tokens in storage (private helper method)
    */
   private initializeTokens;
+  /**
+   * Get client typed for storefront POS operations (paths schema)
+   * This provides proper typing for storefront POS endpoints
+   */
+  get storefrontClient(): BaseAPIClient<paths, SupportedDefaultHeaders>["client"];
+  /**
+   * Get client typed for admin POS operations (AdminPaths schema)
+   * This provides proper typing for admin POS endpoints
+   */
+  get adminClient(): BaseAPIClient<paths$1, SupportedDefaultHeaders>["client"];
 }
 //#endregion
 //#region src/lib/utils/url.d.ts
@@ -4581,6 +6493,7 @@ type FreeShipingCouponPromotion = components['schemas']['FreeShipingCouponPromot
 type InapplicableCoupon = components['schemas']['InapplicableCoupon'];
 type InapplicablePromotion = components['schemas']['InapplicablePromotion'];
 type Item = components['schemas']['Item'];
+type JuspayPaymentGatewayParams = components['schemas']['JuspayPaymentGatewayParams'];
 type MultiSelectAttribute = components['schemas']['MultiSelectAttribute'];
 type NetbankingPayment = components['schemas']['NetbankingPayment'];
 type NumberAttribute = components['schemas']['NumberAttribute'];
@@ -4591,7 +6504,14 @@ type OrderPayment = components['schemas']['OrderPayment'];
 type OrderRefund = components['schemas']['OrderRefund'];
 type OrderShipment = components['schemas']['OrderShipment'];
 type Pagination = components['schemas']['Pagination'];
+type PayWithCard = components['schemas']['PayWithCard'];
+type PayWithCash = components['schemas']['PayWithCash'];
+type PayWithPaymentGateway = components['schemas']['PayWithPaymentGateway'];
+type PayWithUpi = components['schemas']['PayWithUpi'];
+type PaymentGateway = components['schemas']['PaymentGateway'];
+type PaymentGatewayParams = components['schemas']['PaymentGatewayParams'];
 type PaymentInfo = components['schemas']['PaymentInfo'];
+type PayuPaymentGatewayParams = components['schemas']['PayuPaymentGatewayParams'];
 type PercentageDiscountRule = components['schemas']['PercentageDiscountRule'];
 type PincodeServiceability = components['schemas']['PincodeServiceability'];
 type PosDevice = components['schemas']['PosDevice'];
@@ -4752,6 +6672,68 @@ type GetPosFulfillmentOptionsBody = NonNullable<paths['/pos/fulfillment-options'
 type CreatePosOrderResponse = paths['/pos/orders']['post']['responses'][200]['content']['application/json'];
 type CreatePosOrderContent = CreatePosOrderResponse['content'];
 type CreatePosOrderBody = NonNullable<paths['/pos/orders']['post']['requestBody']>['content']['application/json'];
+type PosGetPaymentStatusResponse = paths['/pos/orders/{order_number}/payment-status']['get']['responses'][200]['content']['application/json'];
+type PosGetPaymentStatusContent = PosGetPaymentStatusResponse['content'];
+type PosGetPaymentStatusPathParams = paths['/pos/orders/{order_number}/payment-status']['get']['parameters']['path'];
+type PosListPaymentOptionsResponse = paths['/pos/payments/payment-options']['get']['responses'][200]['content']['application/json'];
+type PosListPaymentOptionsContent = PosListPaymentOptionsResponse['content'];
+//#endregion
+//#region src/types/admin-pos-api-types.d.ts
+type PosListInventoriesResponse = paths$1['/pos/catalog/inventories']['get']['responses'][200]['content']['application/json'];
+type PosListInventoriesContent = PosListInventoriesResponse['content'];
+type PosListInventoriesQuery = paths$1['/pos/catalog/inventories']['get']['parameters']['query'];
+type PosListInventoriesActivitiesResponse = paths$1['/pos/catalog/inventories/activites']['get']['responses'][200]['content']['application/json'];
+type PosListInventoriesActivitiesContent = PosListInventoriesActivitiesResponse['content'];
+type PosListInventoriesActivitiesQuery = paths$1['/pos/catalog/inventories/activites']['get']['parameters']['query'];
+type PosGetInventoryDetailResponse = paths$1['/pos/catalog/inventories/detail']['get']['responses'][200]['content']['application/json'];
+type PosGetInventoryDetailContent = PosGetInventoryDetailResponse['content'];
+type PosGetInventoryDetailQuery = paths$1['/pos/catalog/inventories/detail']['get']['parameters']['query'];
+type PosGetAdminCustomersResponse = paths$1['/pos/customers']['get']['responses'][200]['content']['application/json'];
+type PosGetAdminCustomersContent = PosGetAdminCustomersResponse['content'];
+type PosGetAdminCustomersQuery = paths$1['/pos/customers']['get']['parameters']['query'];
+type PosGetAdminCustomersIdResponse = paths$1['/pos/customers/{id}']['get']['responses'][200]['content']['application/json'];
+type PosGetAdminCustomersIdContent = PosGetAdminCustomersIdResponse['content'];
+type PosGetAdminCustomersIdPathParams = paths$1['/pos/customers/{id}']['get']['parameters']['path'];
+type PosListAdminOrdersResponse = paths$1['/pos/orders']['get']['responses'][200]['content']['application/json'];
+type PosListAdminOrdersContent = PosListAdminOrdersResponse['content'];
+type PosListAdminOrdersQuery = paths$1['/pos/orders']['get']['parameters']['query'];
+type PosGetAdminOrderResponse = paths$1['/pos/orders/{order_number}']['get']['responses'][200]['content']['application/json'];
+type PosGetAdminOrderContent = PosGetAdminOrderResponse['content'];
+type PosGetAdminOrderPathParams = paths$1['/pos/orders/{order_number}']['get']['parameters']['path'];
+type PosListOrderActivityResponse = paths$1['/pos/orders/{order_number}/activity']['get']['responses'][200]['content']['application/json'];
+type PosListOrderActivityContent = PosListOrderActivityResponse['content'];
+type PosListOrderActivityPathParams = paths$1['/pos/orders/{order_number}/activity']['get']['parameters']['path'];
+type PosGetOrderInvoiceResponse = paths$1['/pos/orders/{order_number}/invoice']['get']['responses'][200]['content']['application/json'];
+type PosGetOrderInvoiceContent = PosGetOrderInvoiceResponse['content'];
+type PosGetOrderInvoiceQuery = paths$1['/pos/orders/{order_number}/invoice']['get']['parameters']['query'];
+type PosGetOrderInvoicePathParams = paths$1['/pos/orders/{order_number}/invoice']['get']['parameters']['path'];
+type PosGetOrderReceiptResponse = paths$1['/pos/orders/{order_number}/receipt']['get']['responses'][200]['content']['application/json'];
+type PosGetOrderReceiptContent = PosGetOrderReceiptResponse['content'];
+type PosGetOrderReceiptQuery = paths$1['/pos/orders/{order_number}/receipt']['get']['parameters']['query'];
+type PosGetOrderReceiptPathParams = paths$1['/pos/orders/{order_number}/receipt']['get']['parameters']['path'];
+type PosGetOrderShipmentsResponse = paths$1['/pos/orders/{order_number}/shipments']['get']['responses'][200]['content']['application/json'];
+type PosGetOrderShipmentsContent = PosGetOrderShipmentsResponse['content'];
+type PosGetOrderShipmentsPathParams = paths$1['/pos/orders/{order_number}/shipments']['get']['parameters']['path'];
+type PosListShipmentsResponse = paths$1['/pos/shipping/shipments']['get']['responses'][200]['content']['application/json'];
+type PosListShipmentsContent = PosListShipmentsResponse['content'];
+type PosListShipmentsQuery = paths$1['/pos/shipping/shipments']['get']['parameters']['query'];
+type PosCheckInventoryForOrderResponse = paths$1['/pos/shipping/shipments/{order_number}/check-inventory']['get']['responses'][200]['content']['application/json'];
+type PosCheckInventoryForOrderContent = PosCheckInventoryForOrderResponse['content'];
+type PosCheckInventoryForOrderPathParams = paths$1['/pos/shipping/shipments/{order_number}/check-inventory']['get']['parameters']['path'];
+type PosRefundShortfallForOrderResponse = paths$1['/pos/shipping/shipments/{order_number}/refund-shortfall']['post']['responses'][200]['content']['application/json'];
+type PosRefundShortfallForOrderPathParams = paths$1['/pos/shipping/shipments/{order_number}/refund-shortfall']['post']['parameters']['path'];
+type PosRefundShortfallForOrderBody = NonNullable<paths$1['/pos/shipping/shipments/{order_number}/refund-shortfall']['post']['requestBody']>['content']['application/json'];
+type PosGetShipmentResponse = paths$1['/pos/shipping/shipments/{reference_number}']['get']['responses'][200]['content']['application/json'];
+type PosGetShipmentContent = PosGetShipmentResponse['content'];
+type PosGetShipmentPathParams = paths$1['/pos/shipping/shipments/{reference_number}']['get']['parameters']['path'];
+type PosGetShipmentInvoiceResponse = paths$1['/pos/shipping/shipments/{reference_number}/invoice']['get']['responses'][200]['content']['application/json'];
+type PosGetShipmentInvoiceContent = PosGetShipmentInvoiceResponse['content'];
+type PosGetShipmentInvoiceQuery = paths$1['/pos/shipping/shipments/{reference_number}/invoice']['get']['parameters']['query'];
+type PosGetShipmentInvoicePathParams = paths$1['/pos/shipping/shipments/{reference_number}/invoice']['get']['parameters']['path'];
+type PosUpdateShipmentResponse = paths$1['/pos/shipping/shipments/{reference_number}/manual-update']['put']['responses'][200]['content']['application/json'];
+type PosUpdateShipmentContent = PosUpdateShipmentResponse['content'];
+type PosUpdateShipmentPathParams = paths$1['/pos/shipping/shipments/{reference_number}/manual-update']['put']['parameters']['path'];
+type PosUpdateShipmentBody = NonNullable<paths$1['/pos/shipping/shipments/{reference_number}/manual-update']['put']['requestBody']>['content']['application/json'];
 //#endregion
 //#region src/lib/pos.d.ts
 /**
@@ -4763,59 +6745,217 @@ declare class PosClient extends PosAPIClient {
    * Login with email address for POS device
    * @param body - Login credentials containing device ID and email
    * @returns Promise with OTP token and action
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.loginWithEmail({
+   *   device_id: "pos-device-123",
+   *   email: "staff@example.com"
+   * });
+   *
+   * if (error) {
+   *   console.error("Login failed:", error.message);
+   * } else {
+   *   console.log("OTP sent:", data.otp_token);
+   *   console.log("Action:", data.otp_action);
+   *   // Use the otp_token to verify OTP
+   * }
+   * ```
    */
   loginWithEmail(body: LoginPosDeviceWithEmailBody): Promise<ApiResult<LoginPosDeviceWithEmailContent>>;
   /**
    * Login with phone number for POS device
    * @param body - Login credentials containing device ID and phone
    * @returns Promise with OTP token and action
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.loginWithPhone({
+   *   device_id: "pos-device-123",
+   *   phone: "234567890",
+   *   country_code: "+91" // default is +91
+   * });
+   *
+   * if (error) {
+   *   console.error("Login failed:", error.message);
+   * } else {
+   *   console.log("OTP sent:", data.otp_token);
+   *   console.log("Action:", data.otp_action);
+   *   // Use the otp_token to verify OTP
+   * }
+   * ```
    */
   loginWithPhone(body: LoginPosDeviceWithPhoneBody): Promise<ApiResult<LoginPosDeviceWithPhoneContent>>;
   /**
    * Login with WhatsApp for POS device
    * @param body - Login credentials containing device ID and phone
    * @returns Promise with OTP token and action
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.loginWithWhatsapp({
+   *   device_id: "pos-device-123",
+   *   phone: "234567890",
+   *   country_code: "+91" // default is +91
+   * });
+   *
+   * if (error) {
+   *   console.error("WhatsApp login failed:", error.message);
+   * } else {
+   *   console.log("WhatsApp OTP sent:", data.otp_token);
+   *   console.log("Action:", data.otp_action);
+   *   // Use the otp_token to verify OTP
+   * }
+   * ```
    */
   loginWithWhatsapp(body: LoginPosDeviceWithWhatsappBody): Promise<ApiResult<LoginPosDeviceWithWhatsappContent>>;
   /**
    * Pair POS device with pairing code
    * @param body - Pairing code received via phone/email
    * @returns Promise with device information
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.pairDevice({
+   *   pairing_code: "ABC123"
+   * });
+   *
+   * if (error) {
+   *   console.error("Device pairing failed:", error.message);
+   * } else {
+   *   console.log("Device paired:", data.device.id);
+   *   console.log("Device name:", data.device.name);
+   *   // Store device_id for future use
+   * }
+   * ```
    */
   pairDevice(body: PairPosDeviceBody): Promise<ApiResult<PairPosDeviceContent>>;
   /**
    * Verify OTP for POS login
    * @param body - OTP verification data
    * @returns Promise with user info and tokens
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.verifyOtp({
+   *   otp_token: "otp-token-from-login",
+   *   otp: "123456",
+   *   otp_action: "login"
+   * });
+   *
+   * if (error) {
+   *   console.error("OTP verification failed:", error.message);
+   * } else {
+   *   console.log("Login successful:", data.user);
+   *   console.log("Access token:", data.access_token);
+   *   console.log("Refresh token:", data.refresh_token);
+   *   // Tokens are automatically stored by the SDK
+   * }
+   * ```
    */
   verifyOtp(body: VerifyPosLoginOtpBody): Promise<ApiResult<VerifyPosLoginOtpContent>>;
   /**
    * Refresh POS access token
    * @param body - Refresh token data
    * @returns Promise with new tokens
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.refreshAccessToken({
+   *   refresh_token: "refresh-token-here"
+   * });
+   *
+   * if (error) {
+   *   console.error("Token refresh failed:", error.message);
+   * } else {
+   *   console.log("New access token:", data.access_token);
+   *   console.log("New refresh token:", data.refresh_token);
+   *   // New tokens are automatically stored by the SDK
+   * }
+   * ```
    */
   refreshAccessToken(body: RefreshPosAccessTokenBody): Promise<ApiResult<RefreshPosAccessTokenContent>>;
   /**
    * Logout from POS device
    * @returns Promise with logout confirmation
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.logout();
+   *
+   * if (error) {
+   *   console.error("Logout failed:", error.message);
+   * } else {
+   *   console.log("Logout message:", data.message);
+   *   console.log("Success:", data.success);
+   *   // Tokens are automatically cleared by the SDK
+   * }
+   * ```
    */
   logout(): Promise<ApiResult<LogoutFromPosDeviceResponse>>;
   /**
    * Create a new cart
    * @param body - Cart creation data with items
    * @returns Promise with created cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.createCart({
+   *   items: [
+   *     {
+   *       product_id: "01H9XYZ12345ABCDE",
+   *       variant_id: null,
+   *       quantity: 2
+   *     },
+   *     {
+   *       product_id: "01H9ABC67890FGHIJ",
+   *       variant_id: "01H9XYZ67890KLMNO",
+   *       quantity: 1
+   *     }
+   *   ],
+   *   metadata: {
+   *     "source": "pos-terminal-1",
+   *     "staff_id": "staff-123"
+   *   }
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to create cart:", error.message);
+   * } else {
+   *   console.log("Cart created:", data.cart.id);
+   *   console.log("Cart total:", data.cart.grand_total);
+   * }
+   * ```
    */
   createCart(body: PosCreateCartBody): Promise<ApiResult<PosCreateCartContent>>;
   /**
    * Get cart details
    * @param pathParams - Cart ID
    * @returns Promise with cart details
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getCart({
+   *   id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get cart:", error.message);
+   * } else {
+   *   const cart = data.cart;
+   *   console.log("Cart total:", cart.grand_total);
+   *   console.log("Items count:", cart.cart_items.length);
+   * }
+   * ```
    */
   getCart(pathParams: PosGetCartPathParams): Promise<ApiResult<PosGetCartContent>>;
   /**
    * Delete cart (remove all items)
    * @param pathParams - Cart ID
    * @returns Promise with deletion confirmation
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.deleteCart({
+   *   id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to delete cart:", error.message);
+   * } else {
+   *   console.log("Cart deleted:", data.message);
+   * }
+   * ```
    */
   deleteCart(pathParams: PosDeleteCartPathParams): Promise<ApiResult<PosDeleteCartResponse>>;
   /**
@@ -4823,6 +6963,34 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Cart ID
    * @param body - Item update data
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * // Add item to cart
+   * const { data, error } = await pos.updateCart(
+   *   { id: "01H9CART12345ABCDE" },
+   *   {
+   *     product_id: "01H9XYZ12345ABCDE",
+   *     variant_id: null,
+   *     quantity: 3
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to update cart:", error.message);
+   * } else {
+   *   console.log("Cart updated:", data.cart.cart_items.length);
+   * }
+   *
+   * // Remove item from cart (set quantity to 0)
+   * const { data: removeData, error: removeError } = await pos.updateCart(
+   *   { id: "01H9CART12345ABCDE" },
+   *   {
+   *     product_id: "01H9XYZ12345ABCDE",
+   *     variant_id: null,
+   *     quantity: 0
+   *   }
+   * );
+   * ```
    */
   updateCart(pathParams: PosUpdateCartPathParams, body: PosUpdateCartBody): Promise<ApiResult<PosUpdateCartContent>>;
   /**
@@ -4830,18 +6998,114 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Cart ID
    * @param body - Address data (registered user IDs or guest addresses)
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * // For registered users with saved addresses
+   * const { data, error } = await pos.createCartAddress(
+   *   { id: "01H9CART12345ABCDE" },
+   *   {
+   *     billing_address_id: "01H9ADDR12345BILL",
+   *     shipping_address_id: "01H9ADDR12345SHIP"
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to update cart address:", error.message);
+   * } else {
+   *   console.log("Addresses updated:", data.message);
+   * }
+   *
+   * // For guest checkout with new addresses
+   * const { data: guestData, error: guestError } = await pos.createCartAddress(
+   *   { id: "01H9CART12345ABCDE" },
+   *   {
+   *     billing_address: {
+   *       first_name: "John",
+   *       last_name: "Doe",
+   *       email: "john@example.com",
+   *       phone: "9876543210",
+   *       country_code: "+91",
+   *       address_line1: "123 Main Street",
+   *       address_line2: "Apt 4B",
+   *       city: "Mumbai",
+   *       state: "Maharashtra",
+   *       pincode: "400001",
+   *       country: "India",
+   *       landmark: "Near Station",
+   *       tax_identification_number: null,
+   *       business_name: null
+   *     },
+   *     shipping_address: {
+   *       first_name: "John",
+   *       last_name: "Doe",
+   *       email: "john@example.com",
+   *       phone: "9876543210",
+   *       country_code: "+91",
+   *       address_line1: "456 Oak Avenue",
+   *       address_line2: null,
+   *       city: "Pune",
+   *       state: "Maharashtra",
+   *       pincode: "411001",
+   *       country: "India",
+   *       landmark: "Near Mall",
+   *       tax_identification_number: null,
+   *       business_name: null
+   *     }
+   *   }
+   * );
+   * ```
    */
   createCartAddress(pathParams: PosCreateCartAddressPathParams, body: PosCreateCartAddressBody): Promise<ApiResult<PosCreateCartAddressContent>>;
   /**
    * List all available coupons
    * @param headers - Optional header parameters (customer_group_id, etc.)
    * @returns Promise with available coupons
+   * @example
+   * ```typescript
+   * // Get all available coupons
+   * const { data, error } = await pos.listCoupons();
+   *
+   * if (error) {
+   *   console.error("Failed to get available coupons:", error.message);
+   * } else {
+   *   const coupons = data.coupons || [];
+   *   console.log("Available coupons:", coupons.length);
+   *   coupons.forEach(coupon => {
+   *     console.log("Coupon:", coupon.code, "Discount:", coupon.discount_amount);
+   *   });
+   * }
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.listCoupons({
+   *   "x-customer-group-id": "01H9GROUP12345ABC" // Override default SDK config
+   * });
+   * ```
    */
   listCoupons(headers?: PosListCouponsHeaderParams): Promise<ApiResult<PosListCouponsContent>>;
   /**
    * List all available promotions
    * @param headers - Optional header parameters (customer_group_id, etc.)
    * @returns Promise with available promotions
+   * @example
+   * ```typescript
+   * // Get all available promotions
+   * const { data, error } = await pos.listPromotions();
+   *
+   * if (error) {
+   *   console.error("Failed to get available promotions:", error.message);
+   * } else {
+   *   const promotions = data.promotions || [];
+   *   console.log("Available promotions:", promotions.length);
+   *   promotions.forEach(promotion => {
+   *     console.log("Promotion:", promotion.name, "Type:", promotion.promotion_type);
+   *   });
+   * }
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.listPromotions({
+   *   "x-customer-group-id": "01H9GROUP12345ABC" // Override default SDK config
+   * });
+   * ```
    */
   listPromotions(headers?: PosListPromotionsHeaderParams): Promise<ApiResult<PosListPromotionsContent>>;
   /**
@@ -4849,24 +7113,96 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Cart ID
    * @param body - Coupon code
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.applyCoupon(
+   *   { id: "01H9CART12345ABCDE" },
+   *   { coupon_code: "FLAT100OFF" }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to apply coupon:", error.message);
+   * } else {
+   *   console.log("Coupon applied, new total:", data.cart.grand_total);
+   *   console.log("Discount amount:", data.cart.coupon_discount_amount);
+   * }
+   * ```
    */
   applyCoupon(pathParams: PosApplyCouponPathParams, body: PosApplyCouponBody): Promise<ApiResult<PosApplyCouponContent>>;
   /**
    * Remove coupon from cart
    * @param pathParams - Cart ID
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.removeCoupon({
+   *   id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to remove coupon:", error.message);
+   * } else {
+   *   console.log("Coupon removed, new total:", data.cart.grand_total);
+   * }
+   * ```
    */
   removeCoupon(pathParams: PosRemoveCouponPathParams): Promise<ApiResult<PosRemoveCouponContent>>;
   /**
    * Evaluate applicable/inapplicable coupons for cart
    * @param pathParams - Cart ID
    * @returns Promise with coupon evaluation results
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.evaluateCoupons({
+   *   id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to evaluate coupons:", error.message);
+   * } else {
+   *   const applicable = data.applicable_coupons || [];
+   *   const inapplicable = data.inapplicable_coupons || [];
+   *
+   *   console.log("Applicable coupons:", applicable.length);
+   *   applicable.forEach(coupon => {
+   *     console.log(`- ${coupon.code}: Save $${coupon.estimated_discount}`);
+   *   });
+   *
+   *   console.log("Inapplicable coupons:", inapplicable.length);
+   *   inapplicable.forEach(coupon => {
+   *     console.log(`- ${coupon.code}: ${coupon.reason}`);
+   *   });
+   * }
+   * ```
    */
   evaluateCoupons(pathParams: PosEvaluateCouponsPathParams): Promise<ApiResult<PosEvaluateCouponsContent>>;
   /**
    * Evaluate applicable/inapplicable promotions for cart
    * @param pathParams - Cart ID
    * @returns Promise with promotion evaluation results
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.evaluatePromotions({
+   *   id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to evaluate promotions:", error.message);
+   * } else {
+   *   const applicable = data.applicable_promotions || [];
+   *   const inapplicable = data.inapplicable_promotions || [];
+   *
+   *   console.log("Applicable promotions:", applicable.length);
+   *   applicable.forEach(promo => {
+   *     console.log(`- ${promo.name}: ${promo.savings_message}`);
+   *   });
+   *
+   *   console.log("Inapplicable promotions:", inapplicable.length);
+   *   inapplicable.forEach(promo => {
+   *     console.log(`- ${promo.name}: ${promo.reason}`);
+   *   });
+   * }
+   * ```
    */
   evaluatePromotions(pathParams: PosEvaluatePromotionsPathParams): Promise<ApiResult<PosEvaluatePromotionsContent>>;
   /**
@@ -4874,12 +7210,38 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Cart ID
    * @param body - Credit balance amount to use
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.redeemCreditBalance(
+   *   { id: "01H9CART12345ABCDE" },
+   *   { credit_balance_used: 250.00 }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to redeem credit balance:", error.message);
+   * } else {
+   *   console.log("Credit applied, new total:", data.cart.grand_total);
+   *   console.log("Credit used:", data.cart.credit_balance_used);
+   * }
+   * ```
    */
   redeemCreditBalance(pathParams: PosRedeemCreditBalancePathParams, body: PosRedeemCreditBalanceBody): Promise<ApiResult<PosRedeemCreditBalanceContent>>;
   /**
    * Remove credit balance from cart
    * @param pathParams - Cart ID
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.removeCreditBalance({
+   *   id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to remove credit balance:", error.message);
+   * } else {
+   *   console.log("Credit balance removed, new total:", data.cart.grand_total);
+   * }
+   * ```
    */
   removeCreditBalance(pathParams: PosRemoveCreditBalancePathParams): Promise<ApiResult<PosRemoveCreditBalanceContent>>;
   /**
@@ -4887,12 +7249,38 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Cart ID
    * @param body - Loyalty points to redeem
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.redeemLoyaltyPoints(
+   *   { id: "01H9CART12345ABCDE" },
+   *   { loyalty_point_redeemed: 500 }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to redeem loyalty points:", error.message);
+   * } else {
+   *   console.log("Points redeemed, new total:", data.cart.grand_total);
+   *   console.log("Points redeemed:", data.cart.loyalty_points_redeemed);
+   * }
+   * ```
    */
   redeemLoyaltyPoints(pathParams: PosRedeemLoyaltyPointsPathParams, body: PosRedeemLoyaltyPointsBody): Promise<ApiResult<PosRedeemLoyaltyPointsContent>>;
   /**
    * Remove loyalty points from cart
    * @param pathParams - Cart ID
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.removeLoyaltyPoints({
+   *   id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to remove loyalty points:", error.message);
+   * } else {
+   *   console.log("Loyalty points removed, new total:", data.cart.grand_total);
+   * }
+   * ```
    */
   removeLoyaltyPoints(pathParams: PosRemoveLoyaltyPointsPathParams): Promise<ApiResult<PosRemoveLoyaltyPointsContent>>;
   /**
@@ -4900,12 +7288,51 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Cart ID
    * @param body - Fulfillment preference data
    * @returns Promise with confirmation
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.updateFulfillmentPreference(
+   *   { id: "01H9CART12345ABCDE" },
+   *   {
+   *     fulfillment_type: "delivery",
+   *     delivery_address_id: "01H9ADDR12345ABCDE"
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to update fulfillment preference:", error.message);
+   * } else {
+   *   console.log("Fulfillment preference updated:", data.message);
+   *   console.log("Success:", data.success);
+   * }
+   * ```
    */
   updateFulfillmentPreference(pathParams: PosUpdateFulfillmentPreferencePathParams, body: PosUpdateFulfillmentPreferenceBody): Promise<ApiResult<PosUpdateFulfillmentPreferenceResponse>>;
   /**
    * Get fulfillment options for cart
    * @param body - Cart data for fulfillment calculation
    * @returns Promise with fulfillment options
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getFulfillmentOptions({
+   *   cart_id: "01H9CART12345ABCDE",
+   *   delivery_address: {
+   *     street: "123 Main St",
+   *     city: "New York",
+   *     state: "NY",
+   *     zip_code: "10001",
+   *     country: "US"
+   *   }
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get fulfillment options:", error.message);
+   * } else {
+   *   console.log("Available fulfillment options:", data.options.length);
+   *   data.options.forEach(option => {
+   *     console.log(`${option.type}: ${option.name} - $${option.cost}`);
+   *   });
+   * }
+   * ```
    */
   getFulfillmentOptions(body: GetPosFulfillmentOptionsBody): Promise<ApiResult<GetPosFulfillmentOptionsContent>>;
   /**
@@ -4913,18 +7340,103 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Cart ID
    * @param body - Customer update data
    * @returns Promise with updated cart
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.updateCartCustomer(
+   *   { id: "01H9CART12345ABCDE" },
+   *   {
+   *     customer_id: "01H9CUST12345ABCDE",
+   *     customer_group_id: "01H9GROUP12345ABCDE"
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to update cart customer:", error.message);
+   * } else {
+   *   console.log("Cart customer updated:", data.cart.id);
+   *   console.log("Customer ID:", data.cart.customer_id);
+   *   console.log("Customer group:", data.cart.customer_group_id);
+   * }
+   * ```
    */
   updateCartCustomer(pathParams: UpdatePosCartCustomerPathParams, body: UpdatePosCartCustomerBody): Promise<ApiResult<UpdatePosCartCustomerContent>>;
   /**
    * Create order from cart
    * @param body - Order creation data
    * @returns Promise with created order
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.createOrder({
+   *   cart_id: "01H9CART12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to create order:", error.message);
+   * } else {
+   *   console.log("Order created:", data.order.id);
+   *   console.log("Payment required:", data.payment_required);
+   * }
+   * ```
    */
   createOrder(body: CreatePosOrderBody): Promise<ApiResult<CreatePosOrderContent>>;
+  /**
+   * List payment options
+   * @returns Promise with list of payment options
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.listPaymentOptions();
+   *
+   * if (error) {
+   *   console.error("Failed to list payment options:", error.message);
+   * } else {
+   *   console.log("Payment options:", data.payment_options);
+   * }
+   * ```
+   */
+  listPaymentOptions(): Promise<ApiResult<PosListPaymentOptionsContent>>;
+  /**
+   * Get payment status
+   * @param pathParams - Order number
+   * @returns Promise with payment status
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getPaymentStatus({ order_number: "1234567890" });
+   *
+   * if (error) {
+   *   console.error("Failed to get payment status:", error.message);
+   * } else {
+   *   console.log("Payment status:", data.status);
+   *   console.log("Amount paid:", data.amount_paid);
+   *   console.log("Amount unpaid:", data.amount_unpaid);
+   *   console.log("Retry available:", data.is_retry_available);
+   * }
+   * ```
+   */
+  getPaymentStatus(pathParams: PosGetPaymentStatusPathParams): Promise<ApiResult<PosGetPaymentStatusContent>>;
   /**
    * List all categories
    * @param query - Optional query parameters for filtering categories
    * @returns Promise with list of categories
+   * @example
+   * ```typescript
+   * // Basic category listing
+   * const { data, error } = await pos.listCategories();
+   *
+   * if (error) {
+   *   console.error("Failed to list categories:", error.message);
+   * } else {
+   *   console.log("Categories found:", data.categories?.length || 0);
+   *   data.categories?.forEach(category => {
+   *     console.log(`Category: ${category.name} - ${category.description}`);
+   *   });
+   * }
+   *
+   * // With pagination
+   * const { data: catData, error: catError } = await pos.listCategories({
+   *   page: 1,
+   *   limit: 10
+   * });
+   * ```
    */
   listCategories(query?: PosListCategoriesQuery): Promise<ApiResult<PosListCategoriesContent>>;
   /**
@@ -4932,6 +7444,42 @@ declare class PosClient extends PosAPIClient {
    * @param query - Optional query parameters for filtering products
    * @param headers - Optional header parameters
    * @returns Promise with list of products
+   * @example
+   * ```typescript
+   * // Basic product listing
+   * const { data, error } = await pos.listProducts();
+   *
+   * if (error) {
+   *   console.error("Failed to list products:", error.message);
+   * } else {
+   *   console.log("Products found:", data.products?.length || 0);
+   *   console.log("Pagination:", data.pagination);
+   *   data.products?.forEach(product => {
+   *     console.log(`Product: ${product.name} - $${product.price}`);
+   *   });
+   * }
+   *
+   * // With filtering and pagination
+   * const { data: filteredData, error: filteredError } = await pos.listProducts({
+   *   page: 1,
+   *   limit: 20,
+   *   sort_by: JSON.stringify({ "created_at": "desc" }),
+   *   category_slug: ["electronics", "smartphones"]
+   * });
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.listProducts(
+   *   {
+   *     page: 1,
+   *     limit: 20,
+   *     sort_by: JSON.stringify({ "created_at": "desc" }),
+   *     category_slug: ["electronics", "smartphones"]
+   *   },
+   *   {
+   *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
+   *   }
+   * );
+   * ```
    */
   listProducts(query?: PosListProductsQuery, headers?: PosListProductsHeaderParams): Promise<ApiResult<PosListProductsContent>>;
   /**
@@ -4939,6 +7487,43 @@ declare class PosClient extends PosAPIClient {
    * @param query - Query parameters with product IDs for cross-sell recommendations
    * @param headers - Optional header parameters
    * @returns Promise with cross-sell products
+   * @example
+   * ```typescript
+   * // Basic usage - get cross-sell products for cart items
+   * const { data, error } = await pos.listCrosssellProducts({
+   *   product_ids: ["prod_01H9XYZ12345ABCDE", "prod_01H9ABC67890FGHIJ"]
+   * });
+   *
+   * // Advanced usage with pagination and custom sorting
+   * const { data, error } = await pos.listCrosssellProducts({
+   *   product_ids: ["prod_01H9XYZ12345ABCDE"],
+   *   page: 1,
+   *   limit: 10,
+   *   sort_by: '{"price":"asc"}'
+   * });
+   *
+   * // Override customer group ID for this specific request
+   * const { data, error } = await pos.listCrosssellProducts(
+   *   {
+   *     product_ids: ["prod_01H9XYZ12345ABCDE"],
+   *     page: 1,
+   *     limit: 10
+   *   },
+   *   {
+   *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get cross-sell products:", error.message);
+   * } else {
+   *   console.log("Cross-sell products found:", data.products.length);
+   *   console.log("Pagination:", data.pagination);
+   *   data.products.forEach(product => {
+   *     console.log(`Product: ${product.name} - ${product.price}`);
+   *   });
+   * }
+   * ```
    */
   listCrosssellProducts(query: PosListCrosssellProductsQuery, headers?: PosListCrosssellProductsHeaderParams): Promise<ApiResult<PosListCrosssellProductsContent>>;
   /**
@@ -4946,6 +7531,41 @@ declare class PosClient extends PosAPIClient {
    * @param body - Search criteria and parameters
    * @param headers - Optional header parameters
    * @returns Promise with search results
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.searchProducts({
+   *   query: "smartphone",
+   *   filters: {
+   *     category: ["electronics", "mobile"],
+   *     price_range: { min: 100, max: 1000 },
+   *     brand: ["Apple", "Samsung"] // facet names depend on product configuration
+   *   },
+   *   page: 1,
+   *   limit: 20
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to search products:", error.message);
+   * } else {
+   *   console.log("Search results:", data.skus?.length || 0, "products found");
+   *   console.log("Facet distribution:", data.facet_distribution);
+   *   console.log("Price range:", data.facet_stats.price_range);
+   *   data.skus?.forEach(sku => {
+   *     console.log(`Found: ${sku.name} - ${sku.price}`);
+   *   });
+   * }
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.searchProducts(
+   *   {
+   *     query: "laptop",
+   *     filters: { category: ["computers"] }
+   *   },
+   *   {
+   *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
+   *   }
+   * );
+   * ```
    */
   searchProducts(body: PosSearchProductsBody, headers?: PosSearchProductsHeaderParams): Promise<ApiResult<PosSearchProductsContent>>;
   /**
@@ -4953,6 +7573,43 @@ declare class PosClient extends PosAPIClient {
    * @param query - Query parameters with product ID for similarity recommendations
    * @param headers - Optional header parameters
    * @returns Promise with similar products
+   * @example
+   * ```typescript
+   * // Basic usage - get similar products for a specific product
+   * const { data, error } = await pos.listSimilarProducts({
+   *   product_id: "prod_01H9XYZ12345ABCDE"
+   * });
+   *
+   * // Advanced usage with pagination and custom sorting
+   * const { data, error } = await pos.listSimilarProducts({
+   *   product_id: "prod_01H9XYZ12345ABCDE",
+   *   page: 1,
+   *   limit: 20,
+   *   sort_by: '{"relevance":"desc"}'
+   * });
+   *
+   * // Override customer group ID for this specific request
+   * const { data, error } = await pos.listSimilarProducts(
+   *   {
+   *     product_id: "prod_01H9XYZ12345ABCDE",
+   *     page: 1,
+   *     limit: 20
+   *   },
+   *   {
+   *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get similar products:", error.message);
+   * } else {
+   *   console.log("Similar products found:", data.products.length);
+   *   console.log("Pagination:", data.pagination);
+   *   data.products.forEach(product => {
+   *     console.log(`Similar: ${product.name} - ${product.price}`);
+   *   });
+   * }
+   * ```
    */
   listSimilarProducts(query: PosListSimilarProductsQuery, headers?: PosListSimilarProductsHeaderParams): Promise<ApiResult<PosListSimilarProductsContent>>;
   /**
@@ -4960,6 +7617,43 @@ declare class PosClient extends PosAPIClient {
    * @param query - Query parameters with product IDs for up-sell recommendations
    * @param headers - Optional header parameters
    * @returns Promise with up-sell products
+   * @example
+   * ```typescript
+   * // Basic usage - get up-sell products for cart items
+   * const { data, error } = await pos.listUpsellProducts({
+   *   product_ids: ["prod_01H9XYZ12345ABCDE"]
+   * });
+   *
+   * // Advanced usage with pagination and custom sorting
+   * const { data, error } = await pos.listUpsellProducts({
+   *   product_ids: ["prod_01H9XYZ12345ABCDE"],
+   *   page: 1,
+   *   limit: 15,
+   *   sort_by: '{"relevance":"desc"}'
+   * });
+   *
+   * // Override customer group ID for this specific request
+   * const { data, error } = await pos.listUpsellProducts(
+   *   {
+   *     product_ids: ["prod_01H9XYZ12345ABCDE"],
+   *     page: 1,
+   *     limit: 15
+   *   },
+   *   {
+   *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get up-sell products:", error.message);
+   * } else {
+   *   console.log("Up-sell products found:", data.products.length);
+   *   console.log("Pagination:", data.pagination);
+   *   data.products.forEach(product => {
+   *     console.log(`Up-sell: ${product.name} - ${product.price}`);
+   *   });
+   * }
+   * ```
    */
   listUpsellProducts(query: PosListUpsellProductsQuery, headers?: PosListUpsellProductsHeaderParams): Promise<ApiResult<PosListUpsellProductsContent>>;
   /**
@@ -4967,6 +7661,34 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Product ID or slug
    * @param headers - Optional header parameters
    * @returns Promise with product details
+   * @example
+   * ```typescript
+   * // Get product by ID
+   * const { data, error } = await pos.getProductDetail(
+   *   { product_id_or_slug: "prod_123" }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get product details:", error.message);
+   * } else {
+   *   console.log("Product:", data.product.name);
+   *   console.log("Price:", data.product.price);
+   *   console.log("Description:", data.product.description);
+   * }
+   *
+   * // Get product by slug
+   * const { data: slugData, error: slugError } = await pos.getProductDetail({
+   *   product_id_or_slug: "detox-candy"
+   * });
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.getProductDetail(
+   *   { product_id_or_slug: "detox-candy" },
+   *   {
+   *     "x-customer-group-id": "premium_customers" // Override default SDK config
+   *   }
+   * );
+   * ```
    */
   getProductDetail(pathParams: PosGetProductDetailPathParams, headers?: PosGetProductDetailHeaderParams): Promise<ApiResult<PosGetProductDetailContent>>;
   /**
@@ -4974,6 +7696,31 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Product ID
    * @param query - Optional query parameters for filtering reviews
    * @returns Promise with product reviews
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.listProductReviews(
+   *   { product_id: "prod_123" }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to list product reviews:", error.message);
+   * } else {
+   *   console.log("Reviews found:", data.reviews?.length || 0);
+   *   data.reviews?.forEach(review => {
+   *     console.log(`Review by ${review.customer_name}: ${review.rating}/5`);
+   *     console.log("Comment:", review.comment);
+   *   });
+   * }
+   *
+   * // With pagination
+   * const { data: reviewData, error: reviewError } = await pos.listProductReviews(
+   *   { product_id: "prod_123" },
+   *   {
+   *     page: 1,
+   *     limit: 5
+   *   }
+   * );
+   * ```
    */
   listProductReviews(pathParams: PosListProductReviewsPathParams, query?: PosListProductReviewsQuery): Promise<ApiResult<PosListProductReviewsContent>>;
   /**
@@ -4981,6 +7728,29 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Product ID
    * @param headers - Optional header parameters
    * @returns Promise with product variants
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.listProductVariants(
+   *   { product_id: "prod_123" }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to list product variants:", error.message);
+   * } else {
+   *   console.log("Variants found:", data.variants?.length || 0);
+   *   data.variants?.forEach(variant => {
+   *     console.log(`Variant: ${variant.name} - SKU: ${variant.sku} - Price: ${variant.price}`);
+   *   });
+   * }
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.listProductVariants(
+   *   { product_id: "prod_123" },
+   *   {
+   *     "x-customer-group-id": "wholesale_customers" // Override default SDK config
+   *   }
+   * );
+   * ```
    */
   listProductVariants(pathParams: PosListProductVariantsPathParams, headers?: PosListProductVariantsHeaderParams): Promise<ApiResult<PosListProductVariantsContent>>;
   /**
@@ -4988,6 +7758,35 @@ declare class PosClient extends PosAPIClient {
    * @param pathParams - Product ID and variant ID
    * @param headers - Optional header parameters
    * @returns Promise with variant details
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getVariantDetail(
+   *   {
+   *     product_id: "prod_123",
+   *     variant_id: "var_456"
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get variant details:", error.message);
+   * } else {
+   *   console.log("Variant:", data.variant.name);
+   *   console.log("SKU:", data.variant.sku);
+   *   console.log("Price:", data.variant.price);
+   *   console.log("Stock:", data.variant.stock);
+   * }
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.getVariantDetail(
+   *   {
+   *     product_id: "prod_123",
+   *     variant_id: "var_456"
+   *   },
+   *   {
+   *     "x-customer-group-id": "wholesale_customers" // Override default SDK config
+   *   }
+   * );
+   * ```
    */
   getVariantDetail(pathParams: PosGetVariantDetailPathParams, headers?: PosGetVariantDetailHeaderParams): Promise<ApiResult<PosGetVariantDetailContent>>;
   /**
@@ -4995,8 +7794,536 @@ declare class PosClient extends PosAPIClient {
    * @param query - Optional query parameters for filtering SKUs
    * @param headers - Optional header parameters
    * @returns Promise with list of SKUs
+   * @example
+   * ```typescript
+   * // Basic SKU listing
+   * const { data, error } = await pos.listSkus();
+   *
+   * if (error) {
+   *   console.error("Failed to list SKUs:", error.message);
+   * } else {
+   *   console.log("SKUs found:", data.skus?.length || 0);
+   *   console.log("Pagination:", data.pagination);
+   *   data.skus?.forEach(sku => {
+   *     console.log(`SKU: ${sku.sku} - Price: ${sku.price}`);
+   *   });
+   * }
+   *
+   * // With pagination
+   * const { data: skuData, error: skuError } = await pos.listSkus({
+   *   page: 1,
+   *   limit: 50
+   * });
+   *
+   * // Override customer group ID for this specific request
+   * const { data: overrideData, error: overrideError } = await pos.listSkus(
+   *   {
+   *     page: 1,
+   *     limit: 50
+   *   },
+   *   {
+   *     "x-customer-group-id": "01H9XYZ12345USERID" // Override default SDK config
+   *   }
+   * );
+   * ```
    */
   listSkus(query?: PosListSkusQuery, headers?: PosListSkusHeaderParams): Promise<ApiResult<PosListSkusContent>>;
+  /**
+   * List all inventories (Admin)
+   * @param query - Optional query parameters for filtering inventories
+   * @returns Promise with list of inventories
+   * @example
+   * ```typescript
+   * // Basic inventory listing
+   * const { data, error } = await pos.listInventories();
+   *
+   * if (error) {
+   *   console.error("Failed to list inventories:", error.message);
+   * } else {
+   *   console.log("Inventories found:", data.content?.inventories?.length || 0);
+   *   data.content?.inventories?.forEach(inventory => {
+   *     console.log(`Product: ${inventory.product_name} - Stock: ${inventory.stock_quantity}`);
+   *   });
+   * }
+   *
+   * // With pagination and filters
+   * const { data: filteredData, error: filteredError } = await pos.listInventories({
+   *   page: 1,
+   *   limit: 20,
+   *   sort_by: JSON.stringify({ "stock_quantity": "desc" }),
+   *   filters: JSON.stringify({ "product_name": "smartphone" })
+   * });
+   * ```
+   */
+  listInventories(query?: PosListInventoriesQuery): Promise<ApiResult<PosListInventoriesContent>>;
+  /**
+   * List all inventory activities (Admin)
+   * @param query - Optional query parameters for filtering inventory activities
+   * @returns Promise with list of inventory activities
+   * @example
+   * ```typescript
+   * // Basic inventory activities listing
+   * const { data, error } = await pos.listInventoryActivities();
+   *
+   * if (error) {
+   *   console.error("Failed to list inventory activities:", error.message);
+   * } else {
+   *   console.log("Activities found:", data.content?.activities?.length || 0);
+   *   data.content?.activities?.forEach(activity => {
+   *     console.log(`Activity: ${activity.activity_type} - Product: ${activity.product_name} - Quantity: ${activity.quantity}`);
+   *   });
+   * }
+   *
+   * // With pagination and filters
+   * const { data: filteredData, error: filteredError } = await pos.listInventoryActivities({
+   *   page: 1,
+   *   limit: 50,
+   *   sort_by: JSON.stringify({ "created_at": "desc" }),
+   *   filters: JSON.stringify({ "activity_type": "add" })
+   * });
+   * ```
+   */
+  listInventoryActivities(query?: PosListInventoriesActivitiesQuery): Promise<ApiResult<PosListInventoriesActivitiesContent>>;
+  /**
+   * Get inventory detail (Admin)
+   * @param query - Query parameters with product/variant information
+   * @returns Promise with inventory details
+   * @example
+   * ```typescript
+   * // Get inventory detail for a product
+   * const { data, error } = await pos.getInventoryDetail({
+   *   product_id: "01H9XYZ12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get inventory detail:", error.message);
+   * } else {
+   *   const inventory = data.content?.inventory;
+   *   console.log(`Product: ${inventory?.product_name}`);
+   *   console.log(`Stock: ${inventory?.stock_quantity}`);
+   *   console.log(`Warehouse details:`, inventory?.details);
+   * }
+   *
+   * // Get inventory detail for a product variant
+   * const { data: variantData, error: variantError } = await pos.getInventoryDetail({
+   *   product_id: "01H9XYZ12345ABCDE",
+   *   variant_id: "01H9ABC67890FGHIJ"
+   * });
+   *
+   * // Get inventory detail for a specific lot/batch
+   * const { data: batchData, error: batchError } = await pos.getInventoryDetail({
+   *   product_id: "01H9XYZ12345ABCDE",
+   *   lot_batch: "BATCH001"
+   * });
+   * ```
+   */
+  getInventoryDetail(query: PosGetInventoryDetailQuery): Promise<ApiResult<PosGetInventoryDetailContent>>;
+  /**
+   * List all customers (Admin)
+   * @param query - Optional query parameters for filtering customers
+   * @returns Promise with list of customers
+   * @example
+   * ```typescript
+   * // Basic customer listing
+   * const { data, error } = await pos.getCustomers();
+   *
+   * if (error) {
+   *   console.error("Failed to list customers:", error.message);
+   * } else {
+   *   console.log("Customers found:", data.content?.customers?.length || 0);
+   *   console.log("Pagination:", data.content?.pagination);
+   *   data.content?.customers?.forEach(customer => {
+   *     console.log(`Customer: ${customer.full_name} - Email: ${customer.email}`);
+   *   });
+   * }
+   *
+   * // With search and pagination
+   * const { data: searchData, error: searchError } = await pos.getCustomers({
+   *   page: 1,
+   *   limit: 20,
+   *   search: "john@example.com",
+   *   sort_by: JSON.stringify({ "created_at": "desc" })
+   * });
+   * ```
+   */
+  getCustomers(query?: PosGetAdminCustomersQuery): Promise<ApiResult<PosGetAdminCustomersContent>>;
+  /**
+   * Get customer details (Admin)
+   * @param pathParams - Customer ID
+   * @returns Promise with customer details
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getCustomer({
+   *   id: "01H9CUST12345ABCDE"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get customer:", error.message);
+   * } else {
+   *   const customer = data.content?.customer;
+   *   console.log(`Customer: ${customer?.full_name}`);
+   *   console.log(`Email: ${customer?.email}`);
+   *   console.log(`Phone: ${customer?.phone}`);
+   *   console.log(`Loyalty points: ${customer?.loyalty?.points_balance}`);
+   *   console.log(`Total spent: ${customer?.loyalty?.lifetime_spent}`);
+   * }
+   * ```
+   */
+  getCustomer(pathParams: PosGetAdminCustomersIdPathParams): Promise<ApiResult<PosGetAdminCustomersIdContent>>;
+  /**
+   * List all orders (Admin)
+   * @param query - Optional query parameters for filtering orders
+   * @returns Promise with list of orders
+   * @example
+   * ```typescript
+   * // Basic order listing
+   * const { data, error } = await pos.listOrders();
+   *
+   * if (error) {
+   *   console.error("Failed to list orders:", error.message);
+   * } else {
+   *   console.log("Orders found:", data.content?.orders?.length || 0);
+   *   console.log("Pagination:", data.content?.pagination);
+   *   data.content?.orders?.forEach(order => {
+   *     console.log(`Order: ${order.order_number} - Status: ${order.status} - Total: ${order.grand_total}`);
+   *   });
+   * }
+   *
+   * // With filters and pagination
+   * const { data: filteredData, error: filteredError } = await pos.listOrders({
+   *   page: 1,
+   *   limit: 50,
+   *   search: "ORD-2024",
+   *   filters: JSON.stringify({ "status": "delivered", "payment_status": "success" }),
+   *   sort_by: JSON.stringify({ "order_date": "desc" })
+   * });
+   * ```
+   */
+  listOrders(query?: PosListAdminOrdersQuery): Promise<ApiResult<PosListAdminOrdersContent>>;
+  /**
+   * Get order details (Admin)
+   * @param pathParams - Order number
+   * @returns Promise with order details
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getOrderDetail({
+   *   order_number: "ORD-2024-001234"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get order:", error.message);
+   * } else {
+   *   const order = data.content?.order;
+   *   console.log(`Order: ${order?.order_number}`);
+   *   console.log(`Status: ${order?.status}`);
+   *   console.log(`Payment Status: ${order?.payment_status}`);
+   *   console.log(`Total: ${order?.grand_total}`);
+   *   console.log(`Items:`, order?.order_items);
+   *   console.log(`Billing Address:`, order?.billing_address);
+   *   console.log(`Payments:`, order?.payments);
+   * }
+   * ```
+   */
+  getOrderDetail(pathParams: PosGetAdminOrderPathParams): Promise<ApiResult<PosGetAdminOrderContent>>;
+  /**
+   * List order activity (Admin)
+   * @param pathParams - Order number
+   * @returns Promise with order activities
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.listOrderActivity({
+   *   order_number: "ORD-2024-001234"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get order activity:", error.message);
+   * } else {
+   *   console.log("Activities found:", data.content?.activity?.length || 0);
+   *   data.content?.activity?.forEach(activity => {
+   *     console.log(`${activity.created_at}: ${activity.activity_type} - ${activity.comment}`);
+   *     console.log(`By: ${activity.user_name} (${activity.user_type})`);
+   *   });
+   * }
+   * ```
+   */
+  listOrderActivity(pathParams: PosListOrderActivityPathParams): Promise<ApiResult<PosListOrderActivityContent>>;
+  /**
+   * Get order invoice (Admin)
+   * @param pathParams - Order number
+   * @param query - Optional format parameter
+   * @returns Promise with order invoice
+   * @example
+   * ```typescript
+   * // Get invoice as JSON
+   * const { data, error } = await pos.getOrderInvoice(
+   *   { order_number: "ORD-2024-001234" },
+   *   { format: "json" }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get order invoice:", error.message);
+   * } else {
+   *   data.content?.invoices?.forEach(invoice => {
+   *     console.log(`Invoice: ${invoice.invoice_number}`);
+   *     console.log(`Date: ${invoice.invoice_date}`);
+   *     console.log(`Total: ${invoice.grand_total}`);
+   *     console.log(`Items:`, invoice.items);
+   *   });
+   * }
+   *
+   * // Get invoice as PDF
+   * const { data: pdfData, error: pdfError } = await pos.getOrderInvoice(
+   *   { order_number: "ORD-2024-001234" },
+   *   { format: "pdf" }
+   * );
+   * ```
+   */
+  getOrderInvoice(pathParams: PosGetOrderInvoicePathParams, query?: PosGetOrderInvoiceQuery): Promise<ApiResult<PosGetOrderInvoiceContent>>;
+  /**
+   * Get order receipt (Admin)
+   * @param pathParams - Order number
+   * @param query - Optional format parameter
+   * @returns Promise with order receipt
+   * @example
+   * ```typescript
+   * // Get receipt as JSON
+   * const { data, error } = await pos.getOrderReceipt(
+   *   { order_number: "ORD-2024-001234" },
+   *   { format: "json" }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get order receipt:", error.message);
+   * } else {
+   *   const receipt = data.content?.order_receipt;
+   *   console.log(`Order: ${receipt?.order_number}`);
+   *   console.log(`Date: ${receipt?.order_date}`);
+   *   console.log(`Total: ${receipt?.grand_total}`);
+   *   console.log(`Items:`, receipt?.order_items);
+   *   console.log(`Payments:`, receipt?.payments);
+   * }
+   *
+   * // Get receipt as PDF
+   * const { data: pdfData, error: pdfError } = await pos.getOrderReceipt(
+   *   { order_number: "ORD-2024-001234" },
+   *   { format: "pdf" }
+   * );
+   * ```
+   */
+  getOrderReceipt(pathParams: PosGetOrderReceiptPathParams, query?: PosGetOrderReceiptQuery): Promise<ApiResult<PosGetOrderReceiptContent>>;
+  /**
+   * Get order shipments (Admin)
+   * @param pathParams - Order number
+   * @returns Promise with order shipments
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getOrderShipments({
+   *   order_number: "ORD-2024-001234"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get order shipments:", error.message);
+   * } else {
+   *   const shipment = data.content?.shipment;
+   *   console.log(`Order: ${shipment?.order_number}`);
+   *   console.log(`Order Status: ${shipment?.order_status}`);
+   *   console.log(`Payment Status: ${shipment?.payment_status}`);
+   *   console.log(`Customer: ${shipment?.customer_name}`);
+   *   console.log(`Shipments:`, shipment?.shipments);
+   *   console.log(`Allowed Actions:`, shipment?.allowed_actions);
+   * }
+   * ```
+   */
+  getOrderShipments(pathParams: PosGetOrderShipmentsPathParams): Promise<ApiResult<PosGetOrderShipmentsContent>>;
+  /**
+   * List all shipments (Admin)
+   * @param query - Optional query parameters for filtering shipments
+   * @returns Promise with list of shipments
+   * @example
+   * ```typescript
+   * // Basic shipment listing
+   * const { data, error } = await pos.listShipments();
+   *
+   * if (error) {
+   *   console.error("Failed to list shipments:", error.message);
+   * } else {
+   *   console.log("Shipments found:", data.content?.shipments?.length || 0);
+   *   console.log("Pagination:", data.content?.pagination);
+   *   data.content?.shipments?.forEach(shipment => {
+   *     console.log(`Shipment: ${shipment.shipment_number} - Status: ${shipment.status}`);
+   *     console.log(`Order: ${shipment.order_number} - AWB: ${shipment.awb_no}`);
+   *   });
+   * }
+   *
+   * // With filters and search
+   * const { data: filteredData, error: filteredError } = await pos.listShipments({
+   *   page: 1,
+   *   limit: 25,
+   *   search: "SHIP-2024",
+   *   filters: JSON.stringify({ "status": "shipped" }),
+   *   sort_by: JSON.stringify({ "shipped_date": "desc" })
+   * });
+   * ```
+   */
+  listShipments(query?: PosListShipmentsQuery): Promise<ApiResult<PosListShipmentsContent>>;
+  /**
+   * Check inventory for order (Admin)
+   * @param pathParams - Order number
+   * @returns Promise with inventory check results
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.checkInventory({
+   *   order_number: "ORD-2024-001234"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to check inventory:", error.message);
+   * } else {
+   *   const inventory = data.content;
+   *   console.log(`Inventory Status: ${inventory?.inventory_status}`);
+   *   console.log(`Shipment Items:`, inventory?.shipment_items);
+   *   console.log(`Recommended Warehouses:`, inventory?.recommended_warehouses);
+   *   console.log(`Inventory Detail:`, inventory?.inventory_detail);
+   *   console.log(`Allowed Actions:`, inventory?.allowed_action);
+   * }
+   * ```
+   */
+  checkInventory(pathParams: PosCheckInventoryForOrderPathParams): Promise<ApiResult<PosCheckInventoryForOrderContent>>;
+  /**
+   * Refund shortfall for order (Admin)
+   * @param pathParams - Order number
+   * @param body - Refund details
+   * @returns Promise with refund confirmation
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.refundShortfall(
+   *   { order_number: "ORD-2024-001234" },
+   *   {
+   *     items: [
+   *       {
+   *         sku: "SKU-123",
+   *         quantity: 2,
+   *         free_quantity: 0
+   *       }
+   *     ],
+   *     payment_method: "original-payment-mode"
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to process refund:", error.message);
+   * } else {
+   *   console.log("Refund processed:", data.message);
+   *   console.log("Success:", data.success);
+   * }
+   *
+   * // Refund to bank transfer
+   * const { data: bankData, error: bankError } = await pos.refundShortfall(
+   *   { order_number: "ORD-2024-001234" },
+   *   {
+   *     items: [{ sku: "SKU-123", quantity: 1 }],
+   *     payment_method: "bank-transfer",
+   *     bank_account_id: "BANK_ACC_123"
+   *   }
+   * );
+   * ```
+   */
+  refundShortfall(pathParams: PosRefundShortfallForOrderPathParams, body: PosRefundShortfallForOrderBody): Promise<ApiResult<PosRefundShortfallForOrderResponse>>;
+  /**
+   * Get shipment details (Admin)
+   * @param pathParams - Shipment reference number
+   * @returns Promise with shipment details
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.getShipment({
+   *   reference_number: "SHIP-2024-001234"
+   * });
+   *
+   * if (error) {
+   *   console.error("Failed to get shipment:", error.message);
+   * } else {
+   *   const shipment = data.content?.shipment;
+   *   console.log(`Order: ${shipment?.order_number}`);
+   *   console.log(`Shipments:`, shipment?.shipments);
+   *   shipment?.shipments?.forEach(s => {
+   *     console.log(`  Shipment: ${s.shipment_number} - Status: ${s.status}`);
+   *     console.log(`  AWB: ${s.awb_no} - Courier: ${s.courier_company_name}`);
+   *     console.log(`  Items:`, s.shipment_items);
+   *   });
+   * }
+   * ```
+   */
+  getShipment(pathParams: PosGetShipmentPathParams): Promise<ApiResult<PosGetShipmentContent>>;
+  /**
+   * Get shipment invoice (Admin)
+   * @param pathParams - Shipment reference number
+   * @param query - Optional format parameter
+   * @returns Promise with shipment invoice
+   * @example
+   * ```typescript
+   * // Get shipment invoice as JSON
+   * const { data, error } = await pos.getShipmentInvoice(
+   *   { reference_number: "SHIP-2024-001234" },
+   *   { format: "json" }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to get shipment invoice:", error.message);
+   * } else {
+   *   const invoice = data.content?.invoice;
+   *   console.log(`Invoice: ${invoice?.invoice_number}`);
+   *   console.log(`Date: ${invoice?.invoice_date}`);
+   *   console.log(`Total: ${invoice?.grand_total}`);
+   *   console.log(`Items:`, invoice?.items);
+   * }
+   *
+   * // Get shipment invoice as PDF
+   * const { data: pdfData, error: pdfError } = await pos.getShipmentInvoice(
+   *   { reference_number: "SHIP-2024-001234" },
+   *   { format: "pdf" }
+   * );
+   * ```
+   */
+  getShipmentInvoice(pathParams: PosGetShipmentInvoicePathParams, query?: PosGetShipmentInvoiceQuery): Promise<ApiResult<PosGetShipmentInvoiceContent>>;
+  /**
+   * Update shipment details (Admin)
+   * @param pathParams - Shipment reference number
+   * @param body - Shipment update data
+   * @returns Promise with updated shipment
+   * @example
+   * ```typescript
+   * const { data, error } = await pos.updateShipment(
+   *   { reference_number: "SHIP-2024-001234" },
+   *   {
+   *     status: "shipped",
+   *     awb_no: "AWB123456789",
+   *     courier_company_name: "BlueDart",
+   *     shipping_label_url: "https://example.com/label.pdf",
+   *     tracking_url: "https://tracking.example.com/AWB123456789",
+   *     eta_delivery: "2024-01-15T10:00:00Z",
+   *     shipped_date: "2024-01-10T14:30:00Z"
+   *   }
+   * );
+   *
+   * if (error) {
+   *   console.error("Failed to update shipment:", error.message);
+   * } else {
+   *   console.log("Shipment updated successfully:", data.message);
+   *   const shipment = data.content?.shipment;
+   *   console.log(`Updated shipment status:`, shipment?.shipments?.[0]?.status);
+   * }
+   *
+   * // Update delivery status
+   * const { data: deliveryData, error: deliveryError } = await pos.updateShipment(
+   *   { reference_number: "SHIP-2024-001234" },
+   *   {
+   *     status: "delivered",
+   *     delivered_date: "2024-01-15T16:45:00Z"
+   *   }
+   * );
+   * ```
+   */
+  updateShipment(pathParams: PosUpdateShipmentPathParams, body: PosUpdateShipmentBody): Promise<ApiResult<PosUpdateShipmentContent>>;
 }
 //#endregion
 //#region src/lib/middleware/auth.d.ts
@@ -5254,5 +8581,5 @@ declare class PosSDK {
   getTenantId(): Promise<string | null>;
 }
 //#endregion
-export { AcceleratedRewardCouponPromotion, AcceleratedRewardRule, AdditionalProductDetails, ApiErrorResponse, ApiResult, ApplicableCoupon, ApplicablePromotion, AppliedCoupon, AppliedPromotion, AssociatedOption, AutoScaleBasedOnAmount, AutoScaleBasedOnQuantity, BankTransfer, BaseAPIClient, BaseSDKOptions, BooleanAttribute, BrowserTokenStorage, BuyXGetYCouponPromotion, BuyXGetYRule, BuyXGetYRuleBasedOnAmount, BuyXGetYRuleBasedOnQuantity, CardPayment, Cart, CartBasedServiceabilityCheck, CartItem, Category, CollectInStore, CollectInStoreFulfillment, ColorAttribute, ColorOption, Coupon, CouponPromotionCommonDetail, CouponType, CreatePosOrderBody, CreatePosOrderContent, CreatePosOrderResponse, Currency, CustomSlabsBasedOnAmount, CustomSlabsBasedOnQuantity, CustomerAddress, DateAttribute, DebugLogger, DebugLoggerFn, DeliveryFulfillment, DiscountBasedPromotion, DiscountCouponPromotion, DiscountRule, Environment, FixedAmountDiscountRule, FixedPriceCouponPromotion, FixedPricePromotion, FixedPriceRule, FixedPriceRuleBasedAmount, FixedPriceRuleBasedQuantity, FreeGoodCouponPromotion, FreeGoodsPromotion, FreeGoodsRule, FreeShipingCouponPromotion, GetPosFulfillmentOptionsBody, GetPosFulfillmentOptionsContent, GetPosFulfillmentOptionsResponse, HeaderConfig, InapplicableCoupon, InapplicablePromotion, Item, LoginPosDeviceWithEmailBody, LoginPosDeviceWithEmailContent, LoginPosDeviceWithEmailResponse, LoginPosDeviceWithPhoneBody, LoginPosDeviceWithPhoneContent, LoginPosDeviceWithPhoneResponse, LoginPosDeviceWithWhatsappBody, LoginPosDeviceWithWhatsappContent, LoginPosDeviceWithWhatsappResponse, LogoutFromPosDeviceResponse, MemoryTokenStorage, MultiSelectAttribute, NetbankingPayment, NumberAttribute, Order, OrderDetail, OrderItem, OrderPayment, OrderRefund, OrderShipment, Pagination, PairPosDeviceBody, PairPosDeviceContent, PairPosDeviceResponse, PaymentInfo, PercentageDiscountRule, PincodeServiceability, PosAPIClient, PosApplyCouponBody, PosApplyCouponContent, PosApplyCouponPathParams, PosApplyCouponResponse, PosClient, PosCreateCartAddressBody, PosCreateCartAddressContent, PosCreateCartAddressPathParams, PosCreateCartAddressResponse, PosCreateCartBody, PosCreateCartContent, PosCreateCartResponse, PosDeleteCartPathParams, PosDeleteCartResponse, PosDevice, PosEvaluateCouponsContent, PosEvaluateCouponsPathParams, PosEvaluateCouponsResponse, PosEvaluatePromotionsContent, PosEvaluatePromotionsPathParams, PosEvaluatePromotionsResponse, PosGetCartContent, PosGetCartPathParams, PosGetCartResponse, PosGetProductDetailContent, PosGetProductDetailHeaderParams, PosGetProductDetailPathParams, PosGetProductDetailResponse, PosGetVariantDetailContent, PosGetVariantDetailHeaderParams, PosGetVariantDetailPathParams, PosGetVariantDetailResponse, PosListCategoriesContent, PosListCategoriesQuery, PosListCategoriesResponse, PosListCouponsContent, PosListCouponsHeaderParams, PosListCouponsResponse, PosListCrosssellProductsContent, PosListCrosssellProductsHeaderParams, PosListCrosssellProductsQuery, PosListCrosssellProductsResponse, PosListProductReviewsContent, PosListProductReviewsPathParams, PosListProductReviewsQuery, PosListProductReviewsResponse, PosListProductVariantsContent, PosListProductVariantsHeaderParams, PosListProductVariantsPathParams, PosListProductVariantsResponse, PosListProductsContent, PosListProductsHeaderParams, PosListProductsQuery, PosListProductsResponse, PosListPromotionsContent, PosListPromotionsHeaderParams, PosListPromotionsResponse, PosListSimilarProductsContent, PosListSimilarProductsHeaderParams, PosListSimilarProductsQuery, PosListSimilarProductsResponse, PosListSkusContent, PosListSkusHeaderParams, PosListSkusQuery, PosListSkusResponse, PosListUpsellProductsContent, PosListUpsellProductsHeaderParams, PosListUpsellProductsQuery, PosListUpsellProductsResponse, PosRedeemCreditBalanceBody, PosRedeemCreditBalanceContent, PosRedeemCreditBalancePathParams, PosRedeemCreditBalanceResponse, PosRedeemLoyaltyPointsBody, PosRedeemLoyaltyPointsContent, PosRedeemLoyaltyPointsPathParams, PosRedeemLoyaltyPointsResponse, PosRemoveCouponContent, PosRemoveCouponPathParams, PosRemoveCouponResponse, PosRemoveCreditBalanceContent, PosRemoveCreditBalancePathParams, PosRemoveCreditBalanceResponse, PosRemoveLoyaltyPointsContent, PosRemoveLoyaltyPointsPathParams, PosRemoveLoyaltyPointsResponse, PosSDK, PosSDK as default, PosSDKOptions, PosSearchProductsBody, PosSearchProductsContent, PosSearchProductsHeaderParams, PosSearchProductsResponse, PosUpdateCartBody, PosUpdateCartContent, PosUpdateCartPathParams, PosUpdateCartResponse, PosUpdateCustomerWithEmail, PosUpdateCustomerWithId, PosUpdateCustomerWithPhone, PosUpdateFulfillmentPreferenceBody, PosUpdateFulfillmentPreferencePathParams, PosUpdateFulfillmentPreferenceResponse, PosUser, Product, ProductAttribute, ProductBundleItem, ProductCategory, ProductDetail, ProductImage, ProductPricing, ProductPromotion, ProductReview, ProductShipping, ProductSubscription, ProductVideo, Promotion, PromotionType, RefreshPosAccessTokenBody, RefreshPosAccessTokenContent, RefreshPosAccessTokenResponse, ResponseUtils, SearchProduct, Seo, ShipmentItem, SingleSelectAttribute, SingleSelectOption, SupportedDefaultHeaders, TextAttribute, type TokenStorage, UpdateCartItem, UpdatePosCartCustomerBody, UpdatePosCartCustomerContent, UpdatePosCartCustomerPathParams, UpdatePosCartCustomerResponse, UpiPayment, type UserInfo, Variant, VariantDetail, VariantOption, VerifyPosLoginOtpBody, VerifyPosLoginOtpContent, VerifyPosLoginOtpResponse, VolumeBasedCouponPromotion, VolumeBasedPromotion, VolumeBasedRule, WalletPayment, type components, createDebugMiddleware, createTimeoutMiddleware, executeRequest, extractRequestBody, getPathnameFromUrl, mergeAndTransformHeaders, mergeHeaders, type operations, type paths, transformHeaders };
+export { AcceleratedRewardCouponPromotion, AcceleratedRewardRule, AdditionalProductDetails, ApiErrorResponse, ApiResult, ApplicableCoupon, ApplicablePromotion, AppliedCoupon, AppliedPromotion, AssociatedOption, AutoScaleBasedOnAmount, AutoScaleBasedOnQuantity, BankTransfer, BaseAPIClient, BaseSDKOptions, BooleanAttribute, BrowserTokenStorage, BuyXGetYCouponPromotion, BuyXGetYRule, BuyXGetYRuleBasedOnAmount, BuyXGetYRuleBasedOnQuantity, CardPayment, Cart, CartBasedServiceabilityCheck, CartItem, Category, CollectInStore, CollectInStoreFulfillment, ColorAttribute, ColorOption, Coupon, CouponPromotionCommonDetail, CouponType, CreatePosOrderBody, CreatePosOrderContent, CreatePosOrderResponse, Currency, CustomSlabsBasedOnAmount, CustomSlabsBasedOnQuantity, CustomerAddress, DateAttribute, DebugLogger, DebugLoggerFn, DeliveryFulfillment, DiscountBasedPromotion, DiscountCouponPromotion, DiscountRule, Environment, FixedAmountDiscountRule, FixedPriceCouponPromotion, FixedPricePromotion, FixedPriceRule, FixedPriceRuleBasedAmount, FixedPriceRuleBasedQuantity, FreeGoodCouponPromotion, FreeGoodsPromotion, FreeGoodsRule, FreeShipingCouponPromotion, GetPosFulfillmentOptionsBody, GetPosFulfillmentOptionsContent, GetPosFulfillmentOptionsResponse, HeaderConfig, InapplicableCoupon, InapplicablePromotion, Item, JuspayPaymentGatewayParams, LoginPosDeviceWithEmailBody, LoginPosDeviceWithEmailContent, LoginPosDeviceWithEmailResponse, LoginPosDeviceWithPhoneBody, LoginPosDeviceWithPhoneContent, LoginPosDeviceWithPhoneResponse, LoginPosDeviceWithWhatsappBody, LoginPosDeviceWithWhatsappContent, LoginPosDeviceWithWhatsappResponse, LogoutFromPosDeviceResponse, MemoryTokenStorage, MultiSelectAttribute, NetbankingPayment, NumberAttribute, Order, OrderDetail, OrderItem, OrderPayment, OrderRefund, OrderShipment, Pagination, PairPosDeviceBody, PairPosDeviceContent, PairPosDeviceResponse, PayWithCard, PayWithCash, PayWithPaymentGateway, PayWithUpi, PaymentGateway, PaymentGatewayParams, PaymentInfo, PayuPaymentGatewayParams, PercentageDiscountRule, PincodeServiceability, PosAPIClient, PosApplyCouponBody, PosApplyCouponContent, PosApplyCouponPathParams, PosApplyCouponResponse, PosClient, PosCreateCartAddressBody, PosCreateCartAddressContent, PosCreateCartAddressPathParams, PosCreateCartAddressResponse, PosCreateCartBody, PosCreateCartContent, PosCreateCartResponse, PosDeleteCartPathParams, PosDeleteCartResponse, PosDevice, PosEvaluateCouponsContent, PosEvaluateCouponsPathParams, PosEvaluateCouponsResponse, PosEvaluatePromotionsContent, PosEvaluatePromotionsPathParams, PosEvaluatePromotionsResponse, PosGetCartContent, PosGetCartPathParams, PosGetCartResponse, PosGetPaymentStatusContent, PosGetPaymentStatusPathParams, PosGetPaymentStatusResponse, PosGetProductDetailContent, PosGetProductDetailHeaderParams, PosGetProductDetailPathParams, PosGetProductDetailResponse, PosGetVariantDetailContent, PosGetVariantDetailHeaderParams, PosGetVariantDetailPathParams, PosGetVariantDetailResponse, PosListCategoriesContent, PosListCategoriesQuery, PosListCategoriesResponse, PosListCouponsContent, PosListCouponsHeaderParams, PosListCouponsResponse, PosListCrosssellProductsContent, PosListCrosssellProductsHeaderParams, PosListCrosssellProductsQuery, PosListCrosssellProductsResponse, PosListPaymentOptionsContent, PosListPaymentOptionsResponse, PosListProductReviewsContent, PosListProductReviewsPathParams, PosListProductReviewsQuery, PosListProductReviewsResponse, PosListProductVariantsContent, PosListProductVariantsHeaderParams, PosListProductVariantsPathParams, PosListProductVariantsResponse, PosListProductsContent, PosListProductsHeaderParams, PosListProductsQuery, PosListProductsResponse, PosListPromotionsContent, PosListPromotionsHeaderParams, PosListPromotionsResponse, PosListSimilarProductsContent, PosListSimilarProductsHeaderParams, PosListSimilarProductsQuery, PosListSimilarProductsResponse, PosListSkusContent, PosListSkusHeaderParams, PosListSkusQuery, PosListSkusResponse, PosListUpsellProductsContent, PosListUpsellProductsHeaderParams, PosListUpsellProductsQuery, PosListUpsellProductsResponse, PosRedeemCreditBalanceBody, PosRedeemCreditBalanceContent, PosRedeemCreditBalancePathParams, PosRedeemCreditBalanceResponse, PosRedeemLoyaltyPointsBody, PosRedeemLoyaltyPointsContent, PosRedeemLoyaltyPointsPathParams, PosRedeemLoyaltyPointsResponse, PosRemoveCouponContent, PosRemoveCouponPathParams, PosRemoveCouponResponse, PosRemoveCreditBalanceContent, PosRemoveCreditBalancePathParams, PosRemoveCreditBalanceResponse, PosRemoveLoyaltyPointsContent, PosRemoveLoyaltyPointsPathParams, PosRemoveLoyaltyPointsResponse, PosSDK, PosSDK as default, PosSDKOptions, PosSearchProductsBody, PosSearchProductsContent, PosSearchProductsHeaderParams, PosSearchProductsResponse, PosUpdateCartBody, PosUpdateCartContent, PosUpdateCartPathParams, PosUpdateCartResponse, PosUpdateCustomerWithEmail, PosUpdateCustomerWithId, PosUpdateCustomerWithPhone, PosUpdateFulfillmentPreferenceBody, PosUpdateFulfillmentPreferencePathParams, PosUpdateFulfillmentPreferenceResponse, PosUser, Product, ProductAttribute, ProductBundleItem, ProductCategory, ProductDetail, ProductImage, ProductPricing, ProductPromotion, ProductReview, ProductShipping, ProductSubscription, ProductVideo, Promotion, PromotionType, RefreshPosAccessTokenBody, RefreshPosAccessTokenContent, RefreshPosAccessTokenResponse, ResponseUtils, SearchProduct, Seo, ShipmentItem, SingleSelectAttribute, SingleSelectOption, SupportedDefaultHeaders, TextAttribute, type TokenStorage, UpdateCartItem, UpdatePosCartCustomerBody, UpdatePosCartCustomerContent, UpdatePosCartCustomerPathParams, UpdatePosCartCustomerResponse, UpiPayment, type UserInfo, Variant, VariantDetail, VariantOption, VerifyPosLoginOtpBody, VerifyPosLoginOtpContent, VerifyPosLoginOtpResponse, VolumeBasedCouponPromotion, VolumeBasedPromotion, VolumeBasedRule, WalletPayment, type components, createDebugMiddleware, createTimeoutMiddleware, executeRequest, extractRequestBody, getPathnameFromUrl, mergeAndTransformHeaders, mergeHeaders, type operations, type paths, transformHeaders };
 //# sourceMappingURL=index.d.ts.map