@commercengine/pos 0.4.2 → 0.4.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -4
- package/dist/admin-types.d.mts +10 -2
- package/dist/index.d.mts +173 -70
- package/dist/index.mjs +107 -41
- package/dist/index.mjs.map +1 -1
- package/package.json +2 -2
package/dist/index.mjs.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.mjs","names":[],"sources":["../../sdk-core/dist/index.mjs","../src/lib/utils/jwt.ts","../src/lib/utils/auth.ts","../src/lib/middleware/auth.ts","../src/lib/utils/url.ts","../src/lib/client.ts","../src/lib/pos.ts","../src/index.ts"],"sourcesContent":["import createClient from \"openapi-fetch\";\n\n//#region src/middleware/debug.ts\n/**\n* Response utilities for debugging and working with Response objects\n*/\nvar ResponseUtils = class {\n\t/**\n\t* Get response headers as a plain object\n\t*/\n\tstatic getHeaders(response) {\n\t\treturn Object.fromEntries(response.headers.entries());\n\t}\n\t/**\n\t* Get specific header value\n\t*/\n\tstatic getHeader(response, name) {\n\t\treturn response.headers.get(name);\n\t}\n\t/**\n\t* Check if response was successful\n\t*/\n\tstatic isSuccess(response) {\n\t\treturn response.ok;\n\t}\n\t/**\n\t* Get response metadata\n\t*/\n\tstatic getMetadata(response) {\n\t\treturn {\n\t\t\tstatus: response.status,\n\t\t\tstatusText: response.statusText,\n\t\t\tok: response.ok,\n\t\t\turl: response.url,\n\t\t\tredirected: response.redirected,\n\t\t\ttype: response.type,\n\t\t\theaders: Object.fromEntries(response.headers.entries())\n\t\t};\n\t}\n\t/**\n\t* Clone and read response as text (useful for debugging)\n\t* Note: This can only be called once per response\n\t*/\n\tstatic async getText(response) {\n\t\treturn await response.clone().text();\n\t}\n\t/**\n\t* Clone and read response as JSON (useful for debugging)\n\t* Note: This can only be called once per response\n\t*/\n\tstatic async getJSON(response) {\n\t\treturn await response.clone().json();\n\t}\n\t/**\n\t* Format response information for debugging\n\t*/\n\tstatic format(response) {\n\t\tconst metadata = this.getMetadata(response);\n\t\treturn `${metadata.status} ${metadata.statusText} - ${metadata.url}`;\n\t}\n\t/**\n\t* Format response for logging purposes (enhanced version)\n\t*/\n\tstatic formatResponse(response) {\n\t\treturn {\n\t\t\tstatus: response.status,\n\t\t\tstatusText: response.statusText,\n\t\t\turl: response.url,\n\t\t\tok: response.ok\n\t\t};\n\t}\n};\n/**\n* Debug logging utilities\n*/\nvar DebugLogger = class {\n\tlogger;\n\tresponseTextCache = /* @__PURE__ */ new Map();\n\tconstructor(logger) {\n\t\tthis.logger = logger || ((level, message, data) => {\n\t\t\tconsole.log(`[${level.toUpperCase()}]`, message);\n\t\t\tif (data) console.log(data);\n\t\t});\n\t}\n\t/**\n\t* Log debug information about API request\n\t*/\n\tlogRequest(request, requestBody) {\n\t\tthis.logger(\"info\", \"API Request Debug Info\", {\n\t\t\tmethod: request.method,\n\t\t\turl: request.url,\n\t\t\theaders: Object.fromEntries(request.headers.entries()),\n\t\t\tbody: requestBody,\n\t\t\ttimestamp: (/* @__PURE__ */ new Date()).toISOString()\n\t\t});\n\t}\n\t/**\n\t* Log debug information about API response\n\t*/\n\tasync logResponse(response, responseBody) {\n\t\tif (responseBody && typeof responseBody === \"string\") this.responseTextCache.set(response.url, responseBody);\n\t\tthis.logger(\"info\", \"API Response Debug Info\", {\n\t\t\turl: response.url,\n\t\t\tstatus: response.status,\n\t\t\tstatusText: response.statusText,\n\t\t\tok: response.ok,\n\t\t\theaders: Object.fromEntries(response.headers.entries()),\n\t\t\tredirected: response.redirected,\n\t\t\ttype: response.type,\n\t\t\ttimestamp: (/* @__PURE__ */ new Date()).toISOString()\n\t\t});\n\t\tif (responseBody) this.logger(\"info\", \"API Response Data\", {\n\t\t\tdata: responseBody,\n\t\t\tcontentType: response.headers.get(\"content-type\"),\n\t\t\tcontentLength: response.headers.get(\"content-length\")\n\t\t});\n\t}\n\t/**\n\t* Log error information\n\t*/\n\tlogError(message, error) {\n\t\tthis.logger(\"error\", message, error);\n\t}\n\t/**\n\t* Get cached response text for a URL (if available)\n\t*/\n\tgetCachedResponseText(url) {\n\t\treturn this.responseTextCache.get(url) || null;\n\t}\n\t/**\n\t* Clear cached response texts\n\t*/\n\tclearCache() {\n\t\tthis.responseTextCache.clear();\n\t}\n\tinfo(message, data) {\n\t\tthis.logger(\"info\", message, data);\n\t}\n\twarn(message, data) {\n\t\tthis.logger(\"warn\", message, data);\n\t}\n\terror(message, data) {\n\t\tthis.logger(\"error\", message, data);\n\t}\n};\n/**\n* Extract request body for logging\n*/\nasync function extractRequestBody(request) {\n\tif (request.method === \"GET\" || request.method === \"HEAD\") return null;\n\ttry {\n\t\tconst clonedRequest = request.clone();\n\t\tconst contentType = request.headers.get(\"content-type\")?.toLowerCase();\n\t\tif (contentType?.startsWith(\"application/json\")) return await clonedRequest.json();\n\t\telse if (contentType?.startsWith(\"multipart/form-data\")) return \"[FormData - cannot display]\";\n\t\telse if (contentType?.startsWith(\"text/\")) return await clonedRequest.text();\n\t\treturn \"[Request body - unknown format]\";\n\t} catch (error) {\n\t\treturn \"[Request body unavailable]\";\n\t}\n}\n/**\n* Create debug middleware for openapi-fetch (internal use)\n* Enhanced version that combines original functionality with duration tracking\n*/\nfunction createDebugMiddleware(logger) {\n\tconst debugLogger = new DebugLogger(logger);\n\treturn {\n\t\tasync onRequest({ request }) {\n\t\t\trequest.__debugStartTime = Date.now();\n\t\t\tconst requestBody = await extractRequestBody(request);\n\t\t\tdebugLogger.logRequest(request, requestBody);\n\t\t\treturn request;\n\t\t},\n\t\tasync onResponse({ request, response }) {\n\t\t\tconst startTime = request.__debugStartTime;\n\t\t\tconst duration = startTime ? Date.now() - startTime : 0;\n\t\t\tconst cloned = response.clone();\n\t\t\tlet responseBody = null;\n\t\t\ttry {\n\t\t\t\tconst contentType = response.headers.get(\"content-type\")?.toLowerCase();\n\t\t\t\tif (contentType?.startsWith(\"application/json\")) responseBody = await cloned.json();\n\t\t\t\telse if (contentType?.startsWith(\"text/\")) responseBody = await cloned.text();\n\t\t\t} catch (error) {}\n\t\t\tawait debugLogger.logResponse(response, responseBody);\n\t\t\tif (duration > 0) debugLogger.info(`Request completed in ${duration}ms`, {\n\t\t\t\turl: request.url,\n\t\t\t\tmethod: request.method\n\t\t\t});\n\t\t\treturn response;\n\t\t},\n\t\tasync onError({ error, request }) {\n\t\t\tdebugLogger.logError(\"API Request Failed\", {\n\t\t\t\terror: {\n\t\t\t\t\tname: error instanceof Error ? error.name : \"Unknown\",\n\t\t\t\t\tmessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t\tstack: error instanceof Error ? error.stack : void 0\n\t\t\t\t},\n\t\t\t\trequest: {\n\t\t\t\t\tmethod: request.method,\n\t\t\t\t\turl: request.url,\n\t\t\t\t\theaders: Object.fromEntries(request.headers.entries())\n\t\t\t\t},\n\t\t\t\ttimestamp: (/* @__PURE__ */ new Date()).toISOString()\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n//#endregion\n//#region src/middleware/timeout.ts\n/**\n* Timeout middleware for Commerce Engine SDKs\n*/\n/**\n* Create timeout middleware for openapi-fetch\n* Adds configurable request timeout functionality\n* \n* @param timeoutMs - Timeout duration in milliseconds\n* @returns Middleware object with onRequest handler\n*/\nfunction createTimeoutMiddleware(timeoutMs) {\n\treturn { onRequest: async ({ request }) => {\n\t\tconst controller = new AbortController();\n\t\tconst timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\t\tif (request.signal) request.signal.addEventListener(\"abort\", () => controller.abort());\n\t\tconst newRequest = new Request(request, { signal: controller.signal });\n\t\tcontroller.signal.addEventListener(\"abort\", () => clearTimeout(timeoutId));\n\t\treturn newRequest;\n\t} };\n}\n\n//#endregion\n//#region src/middleware/headers.ts\n/**\n* Header transformation and merging utilities for Commerce Engine SDKs\n*/\n/**\n* Merge two header objects\n* Method-level headers take precedence over default headers\n*\n* @param defaultHeaders - Default headers from SDK configuration\n* @param methodHeaders - Headers passed to the specific method call\n* @returns Merged headers object\n*/\nfunction mergeHeaders(defaultHeaders, methodHeaders) {\n\tconst merged = {};\n\tif (defaultHeaders) Object.assign(merged, defaultHeaders);\n\tif (methodHeaders) Object.assign(merged, methodHeaders);\n\tObject.keys(merged).forEach((key) => {\n\t\tif (merged[key] === void 0) delete merged[key];\n\t});\n\treturn merged;\n}\n/**\n* Transform headers using a transformation mapping\n* Headers not in the transformation map are passed through unchanged\n*\n* @param headers - Headers object with original names\n* @param transformations - Mapping of original names to transformed names\n* @returns Headers object with transformed names\n*/\nfunction transformHeaders(headers, transformations) {\n\tconst transformed = {};\n\tfor (const [key, value] of Object.entries(headers)) if (value !== void 0) {\n\t\tconst headerName = transformations[key] || key;\n\t\ttransformed[headerName] = value;\n\t}\n\treturn transformed;\n}\n/**\n* Merge headers with transformation support\n* Transforms default headers, then merges with method headers\n*\n* @param defaultHeaders - Default headers from SDK configuration\n* @param methodHeaders - Headers passed to the specific method call\n* @param transformations - Mapping for header name transformations\n* @returns Merged headers object with transformations applied\n*/\nfunction mergeAndTransformHeaders(defaultHeaders, methodHeaders, transformations) {\n\tconst merged = {};\n\tif (defaultHeaders && transformations) {\n\t\tconst transformedDefaults = transformHeaders(defaultHeaders, transformations);\n\t\tObject.assign(merged, transformedDefaults);\n\t} else if (defaultHeaders) Object.assign(merged, defaultHeaders);\n\tif (methodHeaders) Object.assign(merged, methodHeaders);\n\tObject.keys(merged).forEach((key) => {\n\t\tif (merged[key] === void 0) delete merged[key];\n\t});\n\treturn merged;\n}\n\n//#endregion\n//#region src/utils/response.ts\n/**\n* Execute a request and handle the response consistently\n* This provides unified error handling and response processing across all SDKs\n*\n* @param apiCall - Function that executes the API request\n* @returns Promise with the API response in standardized format\n*/\nasync function executeRequest(apiCall) {\n\ttry {\n\t\tconst { data, error, response } = await apiCall();\n\t\tif (error) return {\n\t\t\tdata: null,\n\t\t\terror,\n\t\t\tresponse\n\t\t};\n\t\tif (data && data.content !== void 0) return {\n\t\t\tdata: data.content,\n\t\t\terror: null,\n\t\t\tresponse\n\t\t};\n\t\treturn {\n\t\t\tdata,\n\t\t\terror: null,\n\t\t\tresponse\n\t\t};\n\t} catch (err) {\n\t\tconst mockResponse = new Response(null, {\n\t\t\tstatus: 0,\n\t\t\tstatusText: \"Network Error\"\n\t\t});\n\t\treturn {\n\t\t\tdata: null,\n\t\t\terror: {\n\t\t\t\tsuccess: false,\n\t\t\t\tcode: \"NETWORK_ERROR\",\n\t\t\t\tmessage: \"Network error occurred\",\n\t\t\t\terror: err\n\t\t\t},\n\t\t\tresponse: mockResponse\n\t\t};\n\t}\n}\n\n//#endregion\n//#region src/base-client.ts\n/**\n* Base API client for Commerce Engine SDKs\n* Provides common functionality without token management\n*/\n/**\n* Generic base API client that all Commerce Engine SDKs can extend\n* Handles common functionality like middleware setup, request execution, and header management\n* Does NOT include token management - that's SDK-specific\n* \n* @template TPaths - OpenAPI paths type\n* @template THeaders - Supported default headers type\n*/\nvar BaseAPIClient = class {\n\tclient;\n\tconfig;\n\tbaseUrl;\n\theaderTransformations;\n\t/**\n\t* Create a new BaseAPIClient\n\t*\n\t* @param config - Configuration for the API client\n\t* @param baseUrl - The base URL for the API (must be provided by subclass)\n\t* @param headerTransformations - Header name transformations for this SDK\n\t*/\n\tconstructor(config, baseUrl, headerTransformations = {}) {\n\t\tthis.config = { ...config };\n\t\tthis.headerTransformations = headerTransformations;\n\t\tthis.baseUrl = baseUrl;\n\t\tthis.client = createClient({ baseUrl: this.baseUrl });\n\t\tthis.setupMiddleware();\n\t}\n\t/**\n\t* Set up all middleware for the client\n\t*/\n\tsetupMiddleware() {\n\t\tif (this.config.timeout) {\n\t\t\tconst timeoutMiddleware = createTimeoutMiddleware(this.config.timeout);\n\t\t\tthis.client.use(timeoutMiddleware);\n\t\t}\n\t\tif (this.config.debug) {\n\t\t\tconst debugMiddleware = createDebugMiddleware(this.config.logger);\n\t\t\tthis.client.use(debugMiddleware);\n\t\t}\n\t}\n\t/**\n\t* Get the base URL of the API\n\t*\n\t* @returns The base URL of the API\n\t*/\n\tgetBaseUrl() {\n\t\treturn this.baseUrl;\n\t}\n\t/**\n\t* Execute a request and handle the response consistently\n\t* This provides unified error handling and response processing\n\t*\n\t* @param apiCall - Function that executes the API request\n\t* @returns Promise with the API response in standardized format\n\t*/\n\tasync executeRequest(apiCall) {\n\t\treturn executeRequest(apiCall);\n\t}\n\t/**\n\t* Merge default headers with method-level headers\n\t* Method-level headers take precedence over default headers\n\t* Automatically applies SDK-specific header transformations\n\t*\n\t* @param methodHeaders - Headers passed to the specific method call\n\t* @returns Merged headers object with proper HTTP header names\n\t*/\n\tmergeHeaders(methodHeaders) {\n\t\treturn mergeAndTransformHeaders(this.config.defaultHeaders, methodHeaders, this.headerTransformations);\n\t}\n\t/**\n\t* Set default headers for the client\n\t*\n\t* @param headers - Default headers to set\n\t*/\n\tsetDefaultHeaders(headers) {\n\t\tthis.config.defaultHeaders = headers;\n\t}\n\t/**\n\t* Get current default headers\n\t*\n\t* @returns Current default headers\n\t*/\n\tgetDefaultHeaders() {\n\t\treturn this.config.defaultHeaders;\n\t}\n};\n\n//#endregion\n//#region src/utils/url.ts\n/**\n* Generic URL utility functions for any SDK\n*/\n/**\n* Extract pathname from URL\n* Useful for middleware that needs to inspect request paths\n*/\nfunction getPathnameFromUrl(url) {\n\ttry {\n\t\treturn new URL(url).pathname;\n\t} catch {\n\t\treturn url.split(\"?\")[0] || url;\n\t}\n}\n\n//#endregion\nexport { BaseAPIClient, DebugLogger, ResponseUtils, createDebugMiddleware, createTimeoutMiddleware, executeRequest, extractRequestBody, getPathnameFromUrl, mergeAndTransformHeaders, mergeHeaders, transformHeaders };","/**\n * Decode a JWT token payload without signature verification.\n * This is a lightweight replacement for jose's decodeJwt.\n *\n * @param token - The JWT token to decode\n * @returns The decoded payload\n * @throws Error if the token is malformed\n */\nfunction decodeJwt<T = Record<string, unknown>>(token: string): T {\n if (typeof token !== \"string\") {\n throw new Error(\"Invalid token: must be a string\");\n }\n\n const parts = token.split(\".\");\n if (parts.length !== 3) {\n throw new Error(\"Invalid token: must have 3 parts\");\n }\n\n const base64Url = parts[1];\n if (!base64Url) throw new Error(\"Invalid token: missing payload\");\n\n let base64 = base64Url.replace(/-/g, \"+\").replace(/_/g, \"/\");\n const padding = base64.length % 4;\n if (padding) base64 += \"=\".repeat(4 - padding);\n\n // UTF-8 safe decoding\n const binaryStr = atob(base64);\n const bytes = new Uint8Array(binaryStr.length);\n for (let i = 0; i < binaryStr.length; i++) {\n bytes[i] = binaryStr.charCodeAt(i);\n }\n\n const payload = JSON.parse(new TextDecoder().decode(bytes));\n if (typeof payload !== \"object\" || payload === null) {\n throw new Error(\"Invalid token: payload must be an object\");\n }\n\n return payload;\n}\n\n/**\n * JWT payload structure for POS tokens\n */\nexport interface JwtPayload {\n token_type: string;\n exp: number;\n iat: number;\n jti: string;\n ulid: string;\n username: string;\n email: string;\n phone: string;\n first_name: string;\n last_name: string;\n store_id: string;\n is_logged_in: boolean;\n roles: {\n role_id: string;\n role_name: string;\n location_id: string;\n location_name: string;\n }[];\n location: {\n id: string;\n name: string;\n };\n tenant_id: string;\n channel: {\n id: string;\n name: string;\n type: string;\n };\n sid: string;\n}\n\n/**\n * User information extracted from POS JWT token\n */\nexport interface UserInfo {\n id: string;\n username: string;\n email: string;\n phone: string;\n firstName: string;\n lastName: string;\n storeId: string;\n isLoggedIn: boolean;\n roles: {\n roleId: string;\n roleName: string;\n locationId: string;\n locationName: string;\n }[];\n location: {\n id: string;\n name: string;\n };\n tenantId: string;\n channel: {\n id: string;\n name: string;\n type: string;\n };\n sessionId: string;\n tokenExpiry: Date;\n tokenIssuedAt: Date;\n}\n\n/**\n * Decode and extract user information from a JWT token\n *\n * @param token - The JWT token to decode\n * @returns User information or null if token is invalid\n */\nexport function extractUserInfoFromToken(token: string): UserInfo | null {\n try {\n const payload = decodeJwt(token) as JwtPayload;\n\n return {\n id: payload.ulid,\n username: payload.username,\n email: payload.email,\n phone: payload.phone,\n firstName: payload.first_name,\n lastName: payload.last_name,\n storeId: payload.store_id,\n isLoggedIn: payload.is_logged_in,\n roles: payload.roles.map(role => ({\n roleId: role.role_id,\n roleName: role.role_name,\n locationId: role.location_id,\n locationName: role.location_name,\n })),\n location: {\n id: payload.location.id,\n name: payload.location.name,\n },\n tenantId: payload.tenant_id,\n channel: {\n id: payload.channel.id,\n name: payload.channel.name,\n type: payload.channel.type,\n },\n sessionId: payload.sid,\n tokenExpiry: new Date(payload.exp * 1000),\n tokenIssuedAt: new Date(payload.iat * 1000),\n };\n } catch (error) {\n console.warn(\"Failed to decode JWT token:\", error);\n return null;\n }\n}\n\n/**\n * Check if a JWT token is expired\n *\n * @param token - The JWT token to check\n * @param bufferSeconds - Buffer time in seconds (default: 30)\n * @returns True if token is expired or will expire within buffer time\n */\nexport function isTokenExpired(\n token: string,\n bufferSeconds: number = 30\n): boolean {\n try {\n const payload = decodeJwt<{ exp?: number }>(token);\n if (!payload.exp) return true;\n\n const currentTime = Math.floor(Date.now() / 1000);\n const expiryTime = payload.exp;\n\n // Consider token expired if it expires within the buffer time\n return currentTime >= expiryTime - bufferSeconds;\n } catch (error) {\n console.warn(\"Failed to decode JWT token:\", error);\n return true; // Treat invalid tokens as expired\n }\n}\n\n/**\n * Get the user ID from a JWT token\n *\n * @param token - The JWT token\n * @returns User ID (ulid) or null if token is invalid\n */\nexport function getUserIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.id || null;\n}\n\n/**\n * Check if user is logged in based on JWT token\n *\n * @param token - The JWT token\n * @returns True if user is logged in, false otherwise\n */\nexport function isUserLoggedIn(token: string): boolean {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.isLoggedIn || false;\n}\n\n/**\n * Check if user is authenticated (has valid POS token)\n * Checks the token for isLoggedIn status\n *\n * @param token - The JWT token\n * @returns True if user is authenticated with valid POS access\n */\nexport function isUserAuthenticated(token: string): boolean {\n const userInfo = extractUserInfoFromToken(token);\n return !!userInfo?.isLoggedIn;\n}\n\n\n/**\n * Get the location ID from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Location ID or null if token is invalid\n */\nexport function getLocationIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.location?.id || null;\n}\n\n/**\n * Get the role information from a POS JWT token for the current location\n *\n * @param token - The JWT token\n * @returns Role object for the current location, or null if token is invalid\n */\nexport function getRoleFromToken(token: string): {\n roleId: string;\n roleName: string;\n locationId: string;\n locationName: string;\n} | null {\n const userInfo = extractUserInfoFromToken(token);\n if (!userInfo?.roles || userInfo.roles.length === 0) return null;\n\n // Find role for current location, or return first role if location match not found\n const currentLocationRole = userInfo.roles.find(role => role.locationId === userInfo.location.id);\n return currentLocationRole || userInfo.roles[0] || null;\n}\n\n/**\n * Get the tenant ID from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Tenant ID or null if token is invalid\n */\nexport function getTenantIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.tenantId || null;\n}\n\n/**\n * Get the channel information from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Channel object with id, name, and type, or null if token is invalid\n */\nexport function getChannelFromToken(token: string): {\n id: string;\n name: string;\n type: string;\n} | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.channel || null;\n}\n\n/**\n * Get the session ID from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Session ID or null if token is invalid\n */\nexport function getSessionIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.sessionId || null;\n}\n","/**\n * Check if a URL path is a POS login endpoint that should use API key\n * Based on POS spec, only these 5 endpoints use X-Api-Key:\n * - /pos/auth/login/email\n * - /pos/auth/login/phone\n * - /pos/auth/login/whatsapp\n * - /pos/auth/pair-device\n * - /pos/auth/verify-otp\n */\nexport function isApiKeyEndpoint(pathname: string): boolean {\n const apiKeyEndpoints = [\n \"/pos/auth/login/email\",\n \"/pos/auth/login/phone\",\n \"/pos/auth/login/whatsapp\",\n \"/pos/auth/pair-device\",\n \"/pos/auth/verify-otp\",\n \"/pos/locations\",\n ];\n return apiKeyEndpoints.some((endpoint) => pathname.includes(endpoint));\n}\n\n/**\n * Check if a URL path is a POS endpoint that returns tokens\n * Based on POS spec, only these endpoints return tokens:\n * - /pos/auth/verify-otp (after OTP verification)\n * - /pos/auth/refresh-token\n */\nexport function isTokenReturningEndpoint(pathname: string): boolean {\n const tokenEndpoints = [\"/pos/auth/verify-otp\", \"/pos/auth/refresh-token\"];\n return tokenEndpoints.some((endpoint) => pathname.includes(endpoint));\n}\n\n/**\n * Check if a URL path is a POS logout endpoint\n */\nexport function isLogoutEndpoint(pathname: string): boolean {\n return (\n pathname.includes(\"/pos/auth/logout\") || pathname.includes(\"/pos/logout\")\n );\n}\n\n// Re-export JWT utilities from jwt.ts\nexport {\n isTokenExpired,\n extractUserInfoFromToken,\n getUserIdFromToken,\n isUserLoggedIn,\n isUserAuthenticated,\n getLocationIdFromToken,\n getRoleFromToken,\n getTenantIdFromToken,\n} from \"./jwt\";\nexport type { UserInfo, JwtPayload } from \"./jwt\";\n","import type { Middleware } from \"openapi-fetch\";\nimport { getPathnameFromUrl } from \"@commercengine/sdk-core\";\nimport {\n isApiKeyEndpoint,\n isTokenReturningEndpoint,\n isLogoutEndpoint,\n isTokenExpired,\n} from \"../utils/auth\";\n\n/**\n * Token storage interface for the POS auth middleware\n */\nexport interface TokenStorage {\n getAccessToken(): Promise<string | null>;\n setAccessToken(token: string): Promise<void>;\n getRefreshToken(): Promise<string | null>;\n setRefreshToken(token: string): Promise<void>;\n clearTokens(): Promise<void>;\n}\n\n/**\n * Simple in-memory token storage implementation\n */\nexport class MemoryTokenStorage implements TokenStorage {\n private accessToken: string | null = null;\n private refreshToken: string | null = null;\n\n async getAccessToken(): Promise<string | null> {\n return this.accessToken;\n }\n\n async setAccessToken(token: string): Promise<void> {\n this.accessToken = token;\n }\n\n async getRefreshToken(): Promise<string | null> {\n return this.refreshToken;\n }\n\n async setRefreshToken(token: string): Promise<void> {\n this.refreshToken = token;\n }\n\n async clearTokens(): Promise<void> {\n this.accessToken = null;\n this.refreshToken = null;\n }\n}\n\n/**\n * Browser localStorage token storage implementation for POS\n */\nexport class BrowserTokenStorage implements TokenStorage {\n private accessTokenKey: string;\n private refreshTokenKey: string;\n\n constructor(prefix: string = \"pos_\") {\n this.accessTokenKey = `${prefix}access_token`;\n this.refreshTokenKey = `${prefix}refresh_token`;\n }\n\n async getAccessToken(): Promise<string | null> {\n if (typeof localStorage === \"undefined\") return null;\n return localStorage.getItem(this.accessTokenKey);\n }\n\n async setAccessToken(token: string): Promise<void> {\n if (typeof localStorage !== \"undefined\") {\n localStorage.setItem(this.accessTokenKey, token);\n }\n }\n\n async getRefreshToken(): Promise<string | null> {\n if (typeof localStorage === \"undefined\") return null;\n return localStorage.getItem(this.refreshTokenKey);\n }\n\n async setRefreshToken(token: string): Promise<void> {\n if (typeof localStorage !== \"undefined\") {\n localStorage.setItem(this.refreshTokenKey, token);\n }\n }\n\n async clearTokens(): Promise<void> {\n if (typeof localStorage !== \"undefined\") {\n localStorage.removeItem(this.accessTokenKey);\n localStorage.removeItem(this.refreshTokenKey);\n }\n }\n}\n\n/**\n * Configuration for the POS auth middleware\n */\nexport interface PosAuthMiddlewareConfig {\n /**\n * Token storage implementation\n */\n tokenStorage: TokenStorage;\n\n /**\n * API key for X-Api-Key endpoints (login, pair-device, verify-otp)\n * Required for POS authentication flows and fallback scenarios\n */\n apiKey: string;\n\n /**\n * Base URL for the API (used for refresh token endpoint)\n */\n baseUrl: string;\n\n /**\n * Function to refresh tokens\n * Should make a call to the POS refresh token endpoint\n */\n refreshTokenFn?: (refreshToken: string) => Promise<{\n access_token: string;\n refresh_token: string;\n }>;\n\n /**\n * Callback when tokens are updated (login/refresh)\n */\n onTokensUpdated?: (accessToken: string, refreshToken: string) => void;\n\n /**\n * Callback when tokens are cleared (logout/error)\n */\n onTokensCleared?: () => void;\n}\n\n/**\n * Create POS authentication middleware for openapi-fetch\n *\n * POS Authentication Rules:\n * 1. API Key endpoints (X-Api-Key): login/email, login/phone, login/whatsapp, pair-device, verify-otp\n * 2. Bearer token endpoints: All other endpoints\n * 3. Token returning endpoints: verify-otp, refresh-token\n */\nexport function createPosAuthMiddleware(\n config: PosAuthMiddlewareConfig\n): Middleware {\n let isRefreshing = false;\n let refreshPromise: Promise<void> | null = null;\n let hasAssessedTokens = false;\n\n const assessTokenStateOnce = async (): Promise<void> => {\n // Skip if already assessed (tokenStorage is guaranteed to exist when middleware is created)\n if (hasAssessedTokens) return;\n\n hasAssessedTokens = true;\n\n try {\n const accessToken = await config.tokenStorage.getAccessToken();\n const refreshToken = await config.tokenStorage.getRefreshToken();\n\n // Case 1: Valid access token - do nothing\n if (accessToken && !isTokenExpired(accessToken)) {\n return;\n }\n\n // Case 2: Orphaned refresh token (no access token but refresh token exists)\n if (!accessToken && refreshToken) {\n // Clean up orphaned refresh token to prevent confusion\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\"Cleaned up orphaned refresh token in POS\");\n return;\n }\n\n // Case 3: Expired access token with valid refresh token\n if (accessToken && refreshToken && !isTokenExpired(refreshToken)) {\n try {\n await refreshTokens();\n console.info(\"POS tokens refreshed proactively on startup\");\n } catch (error) {\n // Refresh failed - both tokens are likely invalid, clear them\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\"POS tokens cleared after failed refresh on startup\");\n }\n return;\n }\n\n // Case 4: Both tokens expired or invalid - clear stale tokens\n if (\n (accessToken && isTokenExpired(accessToken)) ||\n (refreshToken && isTokenExpired(refreshToken))\n ) {\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\n \"POS stale tokens cleared on startup - user needs to re-authenticate\"\n );\n return;\n }\n\n // Case 5: No tokens at all - valid unauthenticated state\n if (!accessToken && !refreshToken) {\n // This is normal - user hasn't logged in or has logged out\n // No action needed, POS will work with API key endpoints\n return;\n }\n\n // Note: Unlike storefront, POS doesn't have anonymous fallback\n // Users must explicitly authenticate through login endpoints\n } catch (error) {\n // Silent fail - don't break the request flow\n console.warn(\"POS token state assessment failed:\", error);\n }\n };\n\n const refreshTokens = async (): Promise<void> => {\n if (isRefreshing && refreshPromise) {\n return refreshPromise;\n }\n\n isRefreshing = true;\n refreshPromise = (async () => {\n try {\n const refreshToken = await config.tokenStorage.getRefreshToken();\n\n if (!refreshToken || isTokenExpired(refreshToken)) {\n throw new Error(\"No valid refresh token available\");\n }\n\n let newTokens: { access_token: string; refresh_token: string };\n\n if (config.refreshTokenFn) {\n // Use provided refresh function\n newTokens = await config.refreshTokenFn(refreshToken);\n } else {\n // Default refresh implementation for POS\n const response = await fetch(\n `${config.baseUrl}/pos/auth/refresh-token`,\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${await config.tokenStorage.getAccessToken()}`,\n },\n body: JSON.stringify({ refresh_token: refreshToken }),\n }\n );\n\n if (!response.ok) {\n throw new Error(`POS token refresh failed: ${response.status}`);\n }\n\n const data = await response.json();\n newTokens = data.content || data;\n }\n\n // Store new tokens\n await config.tokenStorage.setAccessToken(newTokens.access_token);\n await config.tokenStorage.setRefreshToken(newTokens.refresh_token);\n\n // Notify callback\n config.onTokensUpdated?.(\n newTokens.access_token,\n newTokens.refresh_token\n );\n } catch (error) {\n console.error(\"POS token refresh failed:\", error);\n // Clear tokens on refresh failure\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n throw error;\n } finally {\n isRefreshing = false;\n refreshPromise = null;\n }\n })();\n\n return refreshPromise;\n };\n\n return {\n async onRequest({ request }) {\n const pathname = getPathnameFromUrl(request.url);\n\n // Assess token state once per middleware instance (POS session start)\n await assessTokenStateOnce();\n\n // Handle API Key endpoints (5 specific endpoints only)\n if (isApiKeyEndpoint(pathname)) {\n request.headers.set(\"X-Api-Key\", config.apiKey);\n return request;\n }\n\n // For all other endpoints, use Bearer token\n let accessToken = await config.tokenStorage.getAccessToken();\n\n // Check if token needs refresh\n if (accessToken && isTokenExpired(accessToken)) {\n try {\n await refreshTokens();\n accessToken = await config.tokenStorage.getAccessToken();\n } catch (error) {\n // If refresh fails, continue without token (will get 401)\n console.warn(\"Token refresh failed:\", error);\n accessToken = null;\n }\n }\n\n // Add Authorization header if we have a token\n if (accessToken) {\n request.headers.set(\"Authorization\", `Bearer ${accessToken}`);\n }\n\n return request;\n },\n\n async onResponse({ request, response }) {\n const pathname = getPathnameFromUrl(request.url);\n\n // Handle successful responses that return tokens (verify-otp, refresh-token)\n if (response.ok && isTokenReturningEndpoint(pathname)) {\n try {\n const data = await response.clone().json();\n const content = data.content || data;\n\n if (content?.access_token && content?.refresh_token) {\n await config.tokenStorage.setAccessToken(content.access_token);\n await config.tokenStorage.setRefreshToken(content.refresh_token);\n config.onTokensUpdated?.(\n content.access_token,\n content.refresh_token\n );\n }\n } catch (error) {\n console.warn(\"Failed to extract tokens from POS response:\", error);\n }\n } else if (response.ok && isLogoutEndpoint(pathname)) {\n // Clear tokens on successful logout\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n }\n\n // Handle 401 responses - retry once if token was expired\n if (response.status === 401 && !isApiKeyEndpoint(pathname)) {\n const currentToken = await config.tokenStorage.getAccessToken();\n\n // Only attempt refresh if we have a token and it's expired\n if (currentToken && isTokenExpired(currentToken, 0)) {\n try {\n await refreshTokens();\n\n // Retry the original request with new token\n const newToken = await config.tokenStorage.getAccessToken();\n if (newToken) {\n const retryRequest = request.clone();\n retryRequest.headers.set(\"Authorization\", `Bearer ${newToken}`);\n return fetch(retryRequest);\n }\n } catch (error) {\n // If refresh fails, let the original 401 response through\n console.warn(\"POS token refresh failed on 401 response:\", error);\n }\n }\n }\n\n // Handle 403 responses - token is blacklisted/revoked, clear all tokens\n if (response.status === 403 && !isApiKeyEndpoint(pathname)) {\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\n \"POS tokens cleared due to 403 - session revoked. This can happen when a user has more than 5 active sessions. Please re-authenticate.\"\n );\n }\n\n return response;\n },\n };\n}\n\n/**\n * Helper function to create POS auth middleware with sensible defaults\n */\nexport function createDefaultPosAuthMiddleware(options: {\n apiKey: string;\n baseUrl: string;\n tokenStorage?: TokenStorage;\n onTokensUpdated?: (accessToken: string, refreshToken: string) => void;\n onTokensCleared?: () => void;\n}): Middleware {\n const tokenStorage =\n options.tokenStorage ||\n (typeof localStorage !== \"undefined\"\n ? new BrowserTokenStorage()\n : new MemoryTokenStorage());\n\n return createPosAuthMiddleware({\n tokenStorage,\n apiKey: options.apiKey,\n baseUrl: options.baseUrl,\n onTokensUpdated: options.onTokensUpdated,\n onTokensCleared: options.onTokensCleared,\n });\n}\n","/**\n * Environment configuration for POS API\n */\nexport enum Environment {\n Development = \"dev\",\n Staging = \"staging\",\n Production = \"production\",\n}\n\n/**\n * Configuration for building POS API URLs\n */\nexport interface PosURLConfig {\n storeId: string;\n environment?: Environment;\n baseUrl?: string;\n}\n\n/**\n * Build the base URL for POS API requests\n *\n * @param config - URL configuration\n * @returns The base URL for POS API requests\n */\nexport function buildPosURL(config: PosURLConfig): string {\n // If custom baseUrl is provided, use it directly\n if (config.baseUrl) {\n return config.baseUrl.replace(/\\/$/, \"\"); // Remove trailing slash\n }\n\n // Build URL based on environment and store ID\n const env = config.environment || Environment.Production;\n\n switch (env) {\n case Environment.Staging:\n return `https://staging.api.commercengine.io/api/v1/${config.storeId}/storefront`;\n case Environment.Production:\n default:\n return `https://prod.api.commercengine.io/api/v1/${config.storeId}/storefront`;\n }\n}\n","import type { paths } from \"../types/pos\";\nimport type { paths as AdminPaths } from \"../types/admin-pos\";\nimport { BaseAPIClient, getPathnameFromUrl } from \"@commercengine/sdk-core\";\nimport { createDefaultPosAuthMiddleware } from \"./middleware/auth\";\nimport { isApiKeyEndpoint } from \"./utils/auth\";\nimport { buildPosURL } from \"./utils/url\";\nimport type { PosSDKOptions, SupportedDefaultHeaders } from \"../index\";\n\ntype CombinedPaths = paths & AdminPaths;\n\n/**\n * POS API client that extends the generic BaseAPIClient\n * Adds Commerce Engine POS specific authentication and token management\n */\nexport class PosAPIClient extends BaseAPIClient<\n CombinedPaths,\n SupportedDefaultHeaders\n> {\n protected config: PosSDKOptions;\n private initializationPromise: Promise<void> | null = null;\n\n /**\n * Validate required configuration parameters\n * @param config - Configuration to validate\n * @throws Error with descriptive message if validation fails\n */\n private static validateConfig(config: PosSDKOptions): void {\n const errors: string[] = [];\n\n // Required fields validation\n if (!config.storeId?.trim()) {\n errors.push(\"storeId is required and cannot be empty\");\n }\n\n if (!config.apiKey?.trim()) {\n errors.push(\n \"apiKey is required for POS authentication (needed for login, device pairing, and token refresh fallbacks)\"\n );\n }\n\n // Token configuration validation\n if (config.accessToken && !config.tokenStorage && !config.refreshToken) {\n errors.push(\n \"When providing accessToken without tokenStorage, consider providing refreshToken for token refresh capability\"\n );\n }\n\n if (config.refreshToken && !config.accessToken) {\n errors.push(\n \"refreshToken cannot be provided without accessToken (orphaned refresh token)\"\n );\n }\n\n if (config.refreshToken && !config.tokenStorage) {\n errors.push(\n \"refreshToken requires tokenStorage for automatic token management\"\n );\n }\n\n // Callback validation\n if (\n (config.onTokensUpdated || config.onTokensCleared) &&\n !config.tokenStorage\n ) {\n errors.push(\n \"Token callbacks (onTokensUpdated/onTokensCleared) require tokenStorage for automatic token management\"\n );\n }\n\n // URL validation\n if (config.baseUrl && !PosAPIClient.isValidUrl(config.baseUrl)) {\n errors.push(\"baseUrl must be a valid HTTP/HTTPS URL\");\n }\n\n if (errors.length > 0) {\n throw new Error(\n `POS SDK configuration validation failed:\\n- ${errors.join(\"\\n- \")}`\n );\n }\n }\n\n /**\n * Check if a string is a valid URL\n * @param url - URL string to validate\n * @returns True if valid URL\n */\n private static isValidUrl(url: string): boolean {\n try {\n const parsed = new URL(url);\n return parsed.protocol === \"http:\" || parsed.protocol === \"https:\";\n } catch {\n return false;\n }\n }\n\n /**\n * Create a new PosAPIClient\n *\n * @param config - Configuration for the API client\n */\n constructor(config: PosSDKOptions) {\n // Validate required configuration first (before calling super)\n PosAPIClient.validateConfig(config);\n\n // Build base URL from Commerce Engine config\n const baseUrl = buildPosURL({\n storeId: config.storeId,\n environment: config.environment,\n baseUrl: config.baseUrl,\n });\n\n // Header transformations for POS API\n const headerTransformations = {\n customer_group_id: \"x-customer-group-id\",\n debug_mode: \"x-debug-mode\",\n // Add any other header transformations here\n } as Record<keyof SupportedDefaultHeaders, string>;\n\n // Call parent constructor with generic config\n super(\n {\n baseUrl: baseUrl,\n timeout: config.timeout,\n defaultHeaders: config.defaultHeaders,\n debug: config.debug,\n logger: config.logger,\n },\n baseUrl,\n headerTransformations\n );\n\n // Store full config for POS-specific features\n this.config = { ...config };\n\n // Set up POS-specific auth middleware\n this.setupPosAuth();\n }\n\n /**\n * Set up POS-specific authentication middleware\n */\n private setupPosAuth(): void {\n const config = this.config as PosSDKOptions;\n\n // Set up auth middleware if token storage is provided\n if (config.tokenStorage) {\n const authMiddleware = createDefaultPosAuthMiddleware({\n apiKey: config.apiKey,\n baseUrl: this.getBaseUrl(),\n tokenStorage: config.tokenStorage,\n onTokensUpdated: config.onTokensUpdated,\n onTokensCleared: config.onTokensCleared,\n });\n this.client.use(authMiddleware);\n\n // If initial tokens were provided, store them in tokenStorage\n if (config.accessToken) {\n this.initializationPromise = this.initializeTokens(\n config.accessToken,\n config.refreshToken\n );\n // Clear the manual tokens since we're using storage\n config.accessToken = undefined;\n config.refreshToken = undefined;\n }\n } else {\n // For manual token management, add simple header injection middleware\n this.client.use({\n onRequest: async ({ request }) => {\n const pathname = getPathnameFromUrl(request.url);\n\n // For login endpoints, use API key\n if (isApiKeyEndpoint(pathname)) {\n request.headers.set(\"X-Api-Key\", config.apiKey);\n return request;\n }\n\n // For all other endpoints, prefer access token, fallback to API key\n if (config.accessToken) {\n request.headers.set(\n \"Authorization\",\n `Bearer ${config.accessToken}`\n );\n } else if (config.apiKey) {\n request.headers.set(\"X-Api-Key\", config.apiKey);\n }\n\n return request;\n },\n });\n }\n }\n\n /**\n * Get the authorization header value\n * If using token storage, gets the current token from storage\n * Otherwise returns the manual token\n *\n * @returns The Authorization header value or empty string if no token is set\n */\n public async getAuthorizationHeader(): Promise<string> {\n // Wait for initialization to complete if using token storage\n if (this.config.tokenStorage && this.initializationPromise) {\n await this.initializationPromise;\n }\n\n if (this.config.tokenStorage) {\n const token = await this.config.tokenStorage.getAccessToken();\n return token ? `Bearer ${token}` : \"\";\n }\n return this.config.accessToken ? `Bearer ${this.config.accessToken}` : \"\";\n }\n\n /**\n * Set authentication tokens\n *\n * @param accessToken - The access token (required)\n * @param refreshToken - The refresh token (optional)\n *\n * Behavior:\n * - If tokenStorage is provided: Stores tokens for automatic management\n * - If tokenStorage is not provided: Only stores access token for manual management\n */\n public async setTokens(\n accessToken: string,\n refreshToken?: string\n ): Promise<void> {\n if (this.config.tokenStorage) {\n // Automatic token management\n await this.config.tokenStorage.setAccessToken(accessToken);\n if (refreshToken) {\n await this.config.tokenStorage.setRefreshToken(refreshToken);\n }\n } else {\n // Manual token management - only access token\n this.config.accessToken = accessToken;\n if (refreshToken) {\n console.warn(\n \"Refresh token provided but ignored in manual token management mode. Use tokenStorage for automatic management.\"\n );\n }\n }\n }\n\n /**\n * Clear all authentication tokens\n *\n * Behavior:\n * - If tokenStorage is provided: Clears both access and refresh tokens from storage\n * - If tokenStorage is not provided: Clears the manual access token\n */\n public async clearTokens(): Promise<void> {\n if (this.config.tokenStorage) {\n await this.config.tokenStorage.clearTokens();\n } else {\n this.config.accessToken = undefined;\n }\n }\n\n /**\n * Set the X-Api-Key header\n *\n * @param apiKey - The API key to set\n */\n public setApiKey(apiKey: string): void {\n this.config.apiKey = apiKey;\n }\n\n /**\n * Initialize tokens in storage (private helper method)\n */\n private async initializeTokens(\n accessToken: string,\n refreshToken?: string\n ): Promise<void> {\n try {\n if (this.config.tokenStorage) {\n await this.config.tokenStorage.setAccessToken(accessToken);\n if (refreshToken) {\n await this.config.tokenStorage.setRefreshToken(refreshToken);\n }\n }\n } catch (error) {\n console.warn(\"Failed to initialize tokens in storage:\", error);\n }\n }\n\n /**\n * Get client typed for storefront POS operations (paths schema)\n * This provides proper typing for storefront POS endpoints\n */\n public get storefrontClient() {\n return this.client as BaseAPIClient<\n paths,\n SupportedDefaultHeaders\n >[\"client\"];\n }\n\n /**\n * Get client typed for admin POS operations (AdminPaths schema)\n * This provides proper typing for admin POS endpoints\n */\n public get adminClient() {\n return this.client as BaseAPIClient<\n AdminPaths,\n SupportedDefaultHeaders\n >[\"client\"];\n }\n}\n","import { PosAPIClient } from \"./client\";\nimport type { ApiResult } from \"@commercengine/sdk-core\";\nimport type {\n // Auth types\n LoginPosDeviceWithEmailBody,\n LoginPosDeviceWithEmailContent,\n LoginPosDeviceWithPhoneBody,\n LoginPosDeviceWithPhoneContent,\n LoginPosDeviceWithWhatsappBody,\n LoginPosDeviceWithWhatsappContent,\n PairPosDeviceContent,\n RefreshPosAccessTokenBody,\n RefreshPosAccessTokenContent,\n VerifyPosLoginOtpBody,\n VerifyPosLoginOtpContent,\n LogoutFromPosDeviceResponse,\n\n // Devices\n PairPosDeviceBody,\n ListPosDevicesContent,\n ClaimPosDevicePathParams,\n UnclaimPosDevicePathParams,\n ClaimPosDeviceResponse,\n UnclaimPosDeviceResponse,\n\n // Cart types\n PosCreateCartBody,\n PosCreateCartContent,\n PosGetCartPathParams,\n PosGetCartContent,\n PosDeleteCartPathParams,\n PosDeleteCartResponse,\n PosUpdateCartPathParams,\n PosUpdateCartBody,\n PosUpdateCartContent,\n PosGetUserCartPathParams,\n PosGetUserCartContent,\n\n // Cart address\n PosCreateCartAddressPathParams,\n PosCreateCartAddressBody,\n PosCreateCartAddressContent,\n\n // Coupons\n PosListCouponsContent,\n PosListCouponsHeaderParams,\n PosApplyCouponPathParams,\n PosApplyCouponBody,\n PosApplyCouponContent,\n PosRemoveCouponPathParams,\n PosRemoveCouponContent,\n PosEvaluateCouponsPathParams,\n PosEvaluateCouponsContent,\n\n // Promotions\n PosListPromotionsContent,\n PosListPromotionsHeaderParams,\n PosEvaluatePromotionsPathParams,\n PosEvaluatePromotionsContent,\n\n // Credit balance\n PosRedeemCreditBalancePathParams,\n PosRedeemCreditBalanceBody,\n PosRedeemCreditBalanceContent,\n PosRemoveCreditBalancePathParams,\n PosRemoveCreditBalanceContent,\n\n // Loyalty points\n PosRedeemLoyaltyPointsPathParams,\n PosRedeemLoyaltyPointsBody,\n PosRedeemLoyaltyPointsContent,\n PosRemoveLoyaltyPointsPathParams,\n PosRemoveLoyaltyPointsContent,\n\n // Fulfillment\n PosUpdateFulfillmentPreferencePathParams,\n PosUpdateFulfillmentPreferenceBody,\n PosUpdateFulfillmentPreferenceResponse,\n GetPosFulfillmentOptionsBody,\n GetPosFulfillmentOptionsContent,\n\n // Customer\n UpdatePosCartCustomerPathParams,\n UpdatePosCartCustomerBody,\n UpdatePosCartCustomerContent,\n\n // Orders\n CreatePosOrderBody,\n CreatePosOrderContent,\n\n // Payment\n PosGetPaymentStatusContent,\n PosGetPaymentStatusPathParams,\n\n // Catalog types\n PosListCategoriesContent,\n PosListCategoriesQuery,\n PosListProductsContent,\n PosListProductsQuery,\n PosListProductsHeaderParams,\n PosListCrosssellProductsContent,\n PosListCrosssellProductsQuery,\n PosListCrosssellProductsHeaderParams,\n PosSearchProductsBody,\n PosSearchProductsContent,\n PosSearchProductsHeaderParams,\n PosListSimilarProductsContent,\n PosListSimilarProductsQuery,\n PosListSimilarProductsHeaderParams,\n PosListUpsellProductsContent,\n PosListUpsellProductsQuery,\n PosListUpsellProductsHeaderParams,\n PosGetProductDetailPathParams,\n PosGetProductDetailQuery,\n PosGetProductDetailContent,\n PosGetProductDetailHeaderParams,\n PosListProductReviewsPathParams,\n PosListProductReviewsContent,\n PosListProductReviewsQuery,\n PosListProductVariantsPathParams,\n PosListProductVariantsQuery,\n PosListProductVariantsContent,\n PosListProductVariantsHeaderParams,\n PosGetVariantDetailPathParams,\n PosGetVariantDetailQuery,\n PosGetVariantDetailContent,\n PosGetVariantDetailHeaderParams,\n PosListSkusContent,\n PosListSkusQuery,\n PosListSkusHeaderParams,\n ListPosLocationsContent,\n GetPosUserPathParams,\n GetPosUserContent,\n UnclaimPosDeviceContent,\n ClaimPosDeviceContent,\n LoginPosDeviceWithEmailHeaderParams,\n LoginPosDeviceWithPhoneHeaderParams,\n LoginPosDeviceWithWhatsappHeaderParams,\n PosUpdateFulfillmentPreferenceContent,\n} from \"../types/pos-api-types\";\nimport type {\n // Admin Inventory types\n PosListInventoryContent,\n PosListInventoryQuery,\n PosListInventoryActivityContent,\n PosListInventoryActivityQuery,\n PosListInventoryDetailContent,\n PosListInventoryDetailQuery,\n\n // Admin Customer types\n PosListCustomersContent,\n PosListCustomersQuery,\n PosGetCustomerDetailContent,\n PosGetCustomerDetailPathParams,\n\n // Admin Order types\n PosListOrdersContent,\n PosListOrdersQuery,\n PosGetOrderDetailContent,\n PosGetOrderDetailPathParams,\n PosListOrderActivityContent,\n PosListOrderActivityPathParams,\n PosGetOrderInvoiceContent,\n PosGetOrderInvoiceQuery,\n PosGetOrderInvoicePathParams,\n PosGetOrderReceiptContent,\n PosGetOrderReceiptQuery,\n PosGetOrderReceiptPathParams,\n PosListOrderShipmentsContent,\n PosListOrderShipmentsPathParams,\n\n // Admin Shipment types\n PosListShipmentsContent,\n PosListShipmentsQuery,\n PosCheckOrderInventoryContent,\n PosCheckOrderInventoryPathParams,\n PosRefundShortfallResponse,\n PosRefundShortfallPathParams,\n PosRefundShortfallBody,\n PosGetShipmentDetailContent,\n PosGetShipmentDetailPathParams,\n PosGetShipmentInvoiceContent,\n PosGetShipmentInvoiceQuery,\n PosGetShipmentInvoicePathParams,\n PosUpdateShipmentContent,\n PosUpdateShipmentPathParams,\n PosUpdateShipmentBody,\n} from \"../types/admin-pos-api-types\";\n\n/**\n * Client for interacting with POS endpoints\n * Single client that handles all POS operations including auth, cart, orders, etc.\n */\nexport class PosClient extends PosAPIClient {\n // ===============================\n // AUTHENTICATION ENDPOINTS\n // ===============================\n\n /**\n * Login with email address\n * @param body - Login credentials containing location ID and email\n * @returns Promise with OTP token and action\n * @example\n * ```typescript\n * const { data, error } = await pos.loginWithEmail({\n * location_id: \"pos-location-123\",\n * email: \"staff@example.com\"\n * });\n *\n * if (error) {\n * console.error(\"Login failed:\", error.message);\n * } else {\n * console.log(\"OTP sent:\", data.otp_token);\n * console.log(\"Action:\", data.otp_action);\n * // Use the otp_token to verify OTP\n * }\n * ```\n */\n public async loginWithEmail(\n body: LoginPosDeviceWithEmailBody,\n headers?: LoginPosDeviceWithEmailHeaderParams\n ): Promise<ApiResult<LoginPosDeviceWithEmailContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/login/email\", {\n body: body,\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Login with phone number\n * @param body - Login credentials containing location ID and phone\n * @returns Promise with OTP token and action\n * @example\n * ```typescript\n * const { data, error } = await pos.loginWithPhone({\n * location_id: \"pos-location-123\",\n * phone: \"234567890\",\n * country_code: \"+91\" // default is +91\n * });\n *\n * if (error) {\n * console.error(\"Login failed:\", error.message);\n * } else {\n * console.log(\"OTP sent:\", data.otp_token);\n * console.log(\"Action:\", data.otp_action);\n * // Use the otp_token to verify OTP\n * }\n * ```\n */\n public async loginWithPhone(\n body: LoginPosDeviceWithPhoneBody,\n headers?: LoginPosDeviceWithPhoneHeaderParams\n ): Promise<ApiResult<LoginPosDeviceWithPhoneContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/login/phone\", {\n body,\n params: { header: mergedHeaders },\n })\n );\n }\n\n /**\n * Login with WhatsApp\n * @param body - Login credentials containing location ID and phone\n * @returns Promise with OTP token and action\n * @example\n * ```typescript\n * const { data, error } = await pos.loginWithWhatsapp({\n * location_id: \"pos-location-123\",\n * phone: \"234567890\",\n * country_code: \"+91\" // default is +91\n * });\n *\n * if (error) {\n * console.error(\"WhatsApp login failed:\", error.message);\n * } else {\n * console.log(\"WhatsApp OTP sent:\", data.otp_token);\n * console.log(\"Action:\", data.otp_action);\n * // Use the otp_token to verify OTP\n * }\n * ```\n */\n public async loginWithWhatsapp(\n body: LoginPosDeviceWithWhatsappBody,\n headers?: LoginPosDeviceWithWhatsappHeaderParams\n ): Promise<ApiResult<LoginPosDeviceWithWhatsappContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/login/whatsapp\", {\n body,\n params: { header: mergedHeaders },\n })\n );\n }\n\n /**\n * Verify OTP\n * @param body - OTP verification data\n * @returns Promise with user info and tokens\n * @example\n * ```typescript\n * const { data, error } = await pos.verifyOtp({\n * otp_token: \"otp-token-from-login\",\n * otp: \"123456\",\n * otp_action: \"login\"\n * });\n *\n * if (error) {\n * console.error(\"OTP verification failed:\", error.message);\n * } else {\n * console.log(\"Login successful:\", data.user);\n * console.log(\"Access token:\", data.access_token);\n * console.log(\"Refresh token:\", data.refresh_token);\n * // Tokens are automatically stored by the SDK\n * }\n * ```\n */\n public async verifyOtp(\n body: VerifyPosLoginOtpBody\n ): Promise<ApiResult<VerifyPosLoginOtpContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/verify-otp\", { body })\n );\n }\n\n /**\n * Refresh POS access token\n * @param body - Refresh token data\n * @returns Promise with new tokens\n * @example\n * ```typescript\n * const { data, error } = await pos.refreshAccessToken({\n * refresh_token: \"refresh-token-here\"\n * });\n *\n * if (error) {\n * console.error(\"Token refresh failed:\", error.message);\n * } else {\n * console.log(\"New access token:\", data.access_token);\n * console.log(\"New refresh token:\", data.refresh_token);\n * // New tokens are automatically stored by the SDK\n * }\n * ```\n */\n public async refreshAccessToken(\n body: RefreshPosAccessTokenBody\n ): Promise<ApiResult<RefreshPosAccessTokenContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/refresh-token\", { body })\n );\n }\n\n /**\n * Get POS user details\n * @param pathParams - User ID\n * @returns Promise with user details\n * @example\n * ```typescript\n * const { data, error } = await pos.getUser({\n * id: \"01H9USER12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get user:\", error.message);\n * } else {\n * console.log(\"User:\", data.user);\n * }\n * ```\n */\n public async getUser(\n pathParams: GetPosUserPathParams\n ): Promise<ApiResult<GetPosUserContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/users/{id}\", { params: { path: pathParams } })\n );\n }\n\n /**\n * Logout\n * @returns Promise with logout confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.logout();\n *\n * if (error) {\n * console.error(\"Logout failed:\", error.message);\n * } else {\n * console.log(\"Logout message:\", data.message);\n * console.log(\"Success:\", data.success);\n * // Tokens are automatically cleared by the SDK\n * }\n * ```\n */\n public async logout(): Promise<ApiResult<LogoutFromPosDeviceResponse>> {\n return this.executeRequest(() => this.client.POST(\"/pos/auth/logout\"));\n }\n\n // ===============================\n // DEVICE ENDPOINTS\n // ===============================\n\n /**\n * List store locations\n * @returns Promise with list of locations\n * @example\n * ```typescript\n * const { data, error } = await pos.listLocations();\n * if (error) {\n * console.error(\"Failed to list locations:\", error.message);\n * } else {\n * console.log(\"Locations:\", data.locations);\n * }\n * ```\n */\n public async listLocations(): Promise<ApiResult<ListPosLocationsContent>> {\n return this.executeRequest(() => this.client.GET(\"/pos/locations\"));\n }\n\n /**\n * List devices\n * @returns Promise with list of devices\n * @example\n * ```typescript\n * const { data, error } = await pos.listDevices();\n * if (error) {\n * console.error(\"Failed to list devices:\", error.message);\n * } else {\n * console.log(\"Devices:\", data.devices);\n * }\n * ```\n */\n public async listDevices(): Promise<ApiResult<ListPosDevicesContent>> {\n return this.executeRequest(() => this.client.GET(\"/pos/devices\"));\n }\n\n /**\n * Pair POS device with pairing code\n * @param body - Pairing code received via phone/email\n * @returns Promise with device information\n * @example\n * ```typescript\n * const { data, error } = await pos.pairDevice({\n * pairing_code: \"ABC123\"\n * });\n *\n * if (error) {\n * console.error(\"Device pairing failed:\", error.message);\n * } else {\n * console.log(\"Device paired:\", data.device.id);\n * console.log(\"Device name:\", data.device.name);\n * // Store device_id for future use\n * }\n * ```\n */\n public async pairDevice(\n body: PairPosDeviceBody\n ): Promise<ApiResult<PairPosDeviceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/pair-device\", { body })\n );\n }\n\n /**\n * Unclaim POS device - Unlinks a device from the user session\n * @param pathParams - Device ID\n * @returns Promise with unclaim confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.unclaimDevice({\n * id: \"01H9DEVICE12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to unclaim device:\", error.message);\n * } else {\n * console.log(\"Device unclaimed:\", data.message);\n * }\n * ```\n */\n public async unclaimDevice(\n pathParams: UnclaimPosDevicePathParams\n ): Promise<ApiResult<UnclaimPosDeviceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/devices/{id}/unclaim\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Claim POS device - Links a device to the user session\n * @param pathParams - Device ID\n * @returns Promise with claim confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.claimDevice({\n * id: \"01H9DEVICE12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to claim device:\", error.message);\n * } else {\n * console.log(\"Device claimed:\", data.message);\n * }\n * ```\n */\n public async claimDevice(\n pathParams: ClaimPosDevicePathParams\n ): Promise<ApiResult<ClaimPosDeviceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/devices/{id}/claim\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // CART ENDPOINTS\n // ===============================\n\n /**\n * Create a new cart\n * @param body - Cart creation data with items\n * @returns Promise with created cart\n * @example\n * ```typescript\n * const { data, error } = await pos.createCart({\n * items: [\n * {\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: null,\n * quantity: 2\n * },\n * {\n * product_id: \"01H9ABC67890FGHIJ\",\n * variant_id: \"01H9XYZ67890KLMNO\",\n * quantity: 1\n * }\n * ],\n * metadata: {\n * \"source\": \"pos-terminal-1\",\n * \"staff_id\": \"staff-123\"\n * }\n * });\n *\n * if (error) {\n * console.error(\"Failed to create cart:\", error.message);\n * } else {\n * console.log(\"Cart created:\", data.cart.id);\n * console.log(\"Cart total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async createCart(\n body: PosCreateCartBody\n ): Promise<ApiResult<PosCreateCartContent>> {\n return this.executeRequest(() => this.client.POST(\"/pos/carts\", { body }));\n }\n\n /**\n * Get cart details\n * @param pathParams - Cart ID\n * @returns Promise with cart details\n * @example\n * ```typescript\n * const { data, error } = await pos.getCart({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get cart:\", error.message);\n * } else {\n * const cart = data.cart;\n * console.log(\"Cart total:\", cart.grand_total);\n * console.log(\"Items count:\", cart.cart_items.length);\n * }\n * ```\n */\n public async getCart(\n pathParams: PosGetCartPathParams\n ): Promise<ApiResult<PosGetCartContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/{id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Get cart details by user ID\n * @param pathParams - User ID\n * @returns Promise with cart details\n * @example\n * ```typescript\n * const { data, error } = await pos.getUserCart({\n * user_id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get user cart:\", error.message);\n * } else {\n * console.log(\"User cart ID:\", data.cart.id);\n * console.log(\"Cart value:\", data.cart.subtotal_amount);\n * }\n * ```\n */\n public async getUserCart(\n pathParams: PosGetUserCartPathParams\n ): Promise<ApiResult<PosGetUserCartContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/users/{user_id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Delete cart (remove all items)\n * @param pathParams - Cart ID\n * @returns Promise with deletion confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.deleteCart({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to delete cart:\", error.message);\n * } else {\n * console.log(\"Cart deleted:\", data.message);\n * }\n * ```\n */\n public async deleteCart(\n pathParams: PosDeleteCartPathParams\n ): Promise<ApiResult<PosDeleteCartResponse>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Add/update cart item (set quantity to 0 to remove)\n * @param pathParams - Cart ID\n * @param body - Item update data\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * // Add item to cart\n * const { data, error } = await pos.updateCart(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: null,\n * quantity: 3\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update cart:\", error.message);\n * } else {\n * console.log(\"Cart updated:\", data.cart.cart_items.length);\n * }\n *\n * // Remove item from cart (set quantity to 0)\n * const { data: removeData, error: removeError } = await pos.updateCart(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: null,\n * quantity: 0\n * }\n * );\n * ```\n */\n public async updateCart(\n pathParams: PosUpdateCartPathParams,\n body: PosUpdateCartBody\n ): Promise<ApiResult<PosUpdateCartContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/items\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Update cart address (billing/shipping)\n * @param pathParams - Cart ID\n * @param body - Address data (registered user IDs or guest addresses)\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * // For registered users with saved addresses\n * const { data, error } = await pos.createCartAddress(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * billing_address_id: \"01H9ADDR12345BILL\",\n * shipping_address_id: \"01H9ADDR12345SHIP\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update cart address:\", error.message);\n * } else {\n * console.log(\"Addresses updated:\", data.message);\n * }\n *\n * // For guest checkout with new addresses\n * const { data: guestData, error: guestError } = await pos.createCartAddress(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * billing_address: {\n * first_name: \"John\",\n * last_name: \"Doe\",\n * email: \"john@example.com\",\n * phone: \"9876543210\",\n * country_code: \"+91\",\n * address_line1: \"123 Main Street\",\n * address_line2: \"Apt 4B\",\n * city: \"Mumbai\",\n * state: \"Maharashtra\",\n * pincode: \"400001\",\n * country: \"India\",\n * landmark: \"Near Station\",\n * tax_identification_number: null,\n * business_name: null\n * },\n * shipping_address: {\n * first_name: \"John\",\n * last_name: \"Doe\",\n * email: \"john@example.com\",\n * phone: \"9876543210\",\n * country_code: \"+91\",\n * address_line1: \"456 Oak Avenue\",\n * address_line2: null,\n * city: \"Pune\",\n * state: \"Maharashtra\",\n * pincode: \"411001\",\n * country: \"India\",\n * landmark: \"Near Mall\",\n * tax_identification_number: null,\n * business_name: null\n * }\n * }\n * );\n * ```\n */\n public async createCartAddress(\n pathParams: PosCreateCartAddressPathParams,\n body: PosCreateCartAddressBody\n ): Promise<ApiResult<PosCreateCartAddressContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/address\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n // ===============================\n // COUPON & PROMOTION ENDPOINTS\n // ===============================\n\n /**\n * List all available coupons\n * @param headers - Optional header parameters (customer_group_id, etc.)\n * @returns Promise with available coupons\n * @example\n * ```typescript\n * // Get all available coupons\n * const { data, error } = await pos.listCoupons();\n *\n * if (error) {\n * console.error(\"Failed to get available coupons:\", error.message);\n * } else {\n * const coupons = data.coupons || [];\n * console.log(\"Available coupons:\", coupons.length);\n * coupons.forEach(coupon => {\n * console.log(\"Coupon:\", coupon.code, \"Discount:\", coupon.discount_amount);\n * });\n * }\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listCoupons({\n * \"x-customer-group-id\": \"01H9GROUP12345ABC\" // Override default SDK config\n * });\n * ```\n */\n public async listCoupons(\n headers?: PosListCouponsHeaderParams\n ): Promise<ApiResult<PosListCouponsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/available-coupons\", {\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List all available promotions\n * @param headers - Optional header parameters (customer_group_id, etc.)\n * @returns Promise with available promotions\n * @example\n * ```typescript\n * // Get all available promotions\n * const { data, error } = await pos.listPromotions();\n *\n * if (error) {\n * console.error(\"Failed to get available promotions:\", error.message);\n * } else {\n * const promotions = data.promotions || [];\n * console.log(\"Available promotions:\", promotions.length);\n * promotions.forEach(promotion => {\n * console.log(\"Promotion:\", promotion.name, \"Type:\", promotion.promotion_type);\n * });\n * }\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listPromotions({\n * \"x-customer-group-id\": \"01H9GROUP12345ABC\" // Override default SDK config\n * });\n * ```\n */\n public async listPromotions(\n headers?: PosListPromotionsHeaderParams\n ): Promise<ApiResult<PosListPromotionsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/available-promotions\", {\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Apply coupon to cart\n * @param pathParams - Cart ID\n * @param body - Coupon code\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.applyCoupon(\n * { id: \"01H9CART12345ABCDE\" },\n * { coupon_code: \"FLAT100OFF\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to apply coupon:\", error.message);\n * } else {\n * console.log(\"Coupon applied, new total:\", data.cart.grand_total);\n * console.log(\"Discount amount:\", data.cart.coupon_discount_amount);\n * }\n * ```\n */\n public async applyCoupon(\n pathParams: PosApplyCouponPathParams,\n body: PosApplyCouponBody\n ): Promise<ApiResult<PosApplyCouponContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/coupon\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Remove coupon from cart\n * @param pathParams - Cart ID\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.removeCoupon({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to remove coupon:\", error.message);\n * } else {\n * console.log(\"Coupon removed, new total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async removeCoupon(\n pathParams: PosRemoveCouponPathParams\n ): Promise<ApiResult<PosRemoveCouponContent>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}/coupon\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Evaluate applicable/inapplicable coupons for cart\n * @param pathParams - Cart ID\n * @returns Promise with coupon evaluation results\n * @example\n * ```typescript\n * const { data, error } = await pos.evaluateCoupons({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to evaluate coupons:\", error.message);\n * } else {\n * const applicable = data.applicable_coupons || [];\n * const inapplicable = data.inapplicable_coupons || [];\n *\n * console.log(\"Applicable coupons:\", applicable.length);\n * applicable.forEach(coupon => {\n * console.log(`- ${coupon.code}: Save $${coupon.estimated_discount}`);\n * });\n *\n * console.log(\"Inapplicable coupons:\", inapplicable.length);\n * inapplicable.forEach(coupon => {\n * console.log(`- ${coupon.code}: ${coupon.reason}`);\n * });\n * }\n * ```\n */\n public async evaluateCoupons(\n pathParams: PosEvaluateCouponsPathParams\n ): Promise<ApiResult<PosEvaluateCouponsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/{id}/evaluate-coupons\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Evaluate applicable/inapplicable promotions for cart\n * @param pathParams - Cart ID\n * @returns Promise with promotion evaluation results\n * @example\n * ```typescript\n * const { data, error } = await pos.evaluatePromotions({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to evaluate promotions:\", error.message);\n * } else {\n * const applicable = data.applicable_promotions || [];\n * const inapplicable = data.inapplicable_promotions || [];\n *\n * console.log(\"Applicable promotions:\", applicable.length);\n * applicable.forEach(promo => {\n * console.log(`- ${promo.name}: ${promo.savings_message}`);\n * });\n *\n * console.log(\"Inapplicable promotions:\", inapplicable.length);\n * inapplicable.forEach(promo => {\n * console.log(`- ${promo.name}: ${promo.reason}`);\n * });\n * }\n * ```\n */\n public async evaluatePromotions(\n pathParams: PosEvaluatePromotionsPathParams\n ): Promise<ApiResult<PosEvaluatePromotionsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/{id}/evaluate-promotions\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // CREDIT BALANCE ENDPOINTS\n // ===============================\n\n /**\n * Apply credit balance to cart\n * @param pathParams - Cart ID\n * @param body - Credit balance amount to use\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.redeemCreditBalance(\n * { id: \"01H9CART12345ABCDE\" },\n * { credit_balance_used: 250.00 }\n * );\n *\n * if (error) {\n * console.error(\"Failed to redeem credit balance:\", error.message);\n * } else {\n * console.log(\"Credit applied, new total:\", data.cart.grand_total);\n * console.log(\"Credit used:\", data.cart.credit_balance_used);\n * }\n * ```\n */\n public async redeemCreditBalance(\n pathParams: PosRedeemCreditBalancePathParams,\n body: PosRedeemCreditBalanceBody\n ): Promise<ApiResult<PosRedeemCreditBalanceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/credit-balance\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Remove credit balance from cart\n * @param pathParams - Cart ID\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.removeCreditBalance({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to remove credit balance:\", error.message);\n * } else {\n * console.log(\"Credit balance removed, new total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async removeCreditBalance(\n pathParams: PosRemoveCreditBalancePathParams\n ): Promise<ApiResult<PosRemoveCreditBalanceContent>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}/credit-balance\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // LOYALTY POINTS ENDPOINTS\n // ===============================\n\n /**\n * Redeem loyalty points for cart\n * @param pathParams - Cart ID\n * @param body - Loyalty points to redeem\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.redeemLoyaltyPoints(\n * { id: \"01H9CART12345ABCDE\" },\n * { loyalty_point_redeemed: 500 }\n * );\n *\n * if (error) {\n * console.error(\"Failed to redeem loyalty points:\", error.message);\n * } else {\n * console.log(\"Points redeemed, new total:\", data.cart.grand_total);\n * console.log(\"Points redeemed:\", data.cart.loyalty_points_redeemed);\n * }\n * ```\n */\n public async redeemLoyaltyPoints(\n pathParams: PosRedeemLoyaltyPointsPathParams,\n body: PosRedeemLoyaltyPointsBody\n ): Promise<ApiResult<PosRedeemLoyaltyPointsContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/loyalty-points\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Remove loyalty points from cart\n * @param pathParams - Cart ID\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.removeLoyaltyPoints({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to remove loyalty points:\", error.message);\n * } else {\n * console.log(\"Loyalty points removed, new total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async removeLoyaltyPoints(\n pathParams: PosRemoveLoyaltyPointsPathParams\n ): Promise<ApiResult<PosRemoveLoyaltyPointsContent>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}/loyalty-points\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // FULFILLMENT ENDPOINTS\n // ===============================\n\n /**\n * Update cart fulfillment preference (delivery/pickup)\n * @param pathParams - Cart ID\n * @param body - Fulfillment preference data\n * @returns Promise with confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.updateFulfillmentPreference(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * fulfillment_type: \"delivery\",\n * delivery_address_id: \"01H9ADDR12345ABCDE\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update fulfillment preference:\", error.message);\n * } else {\n * console.log(\"Fulfillment preference updated:\", data.message);\n * console.log(\"Success:\", data.success);\n * }\n * ```\n */\n public async updateFulfillmentPreference(\n pathParams: PosUpdateFulfillmentPreferencePathParams,\n body: PosUpdateFulfillmentPreferenceBody\n ): Promise<ApiResult<PosUpdateFulfillmentPreferenceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/fulfillment-preference\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Get fulfillment options for cart\n * @param body - Cart data for fulfillment calculation\n * @returns Promise with fulfillment options\n * @example\n * ```typescript\n * const { data, error } = await pos.getFulfillmentOptions({\n * cart_id: \"01H9CART12345ABCDE\",\n * delivery_address: {\n * street: \"123 Main St\",\n * city: \"New York\",\n * state: \"NY\",\n * zip_code: \"10001\",\n * country: \"US\"\n * }\n * });\n *\n * if (error) {\n * console.error(\"Failed to get fulfillment options:\", error.message);\n * } else {\n * console.log(\"Available fulfillment options:\", data.options.length);\n * data.options.forEach(option => {\n * console.log(`${option.type}: ${option.name} - $${option.cost}`);\n * });\n * }\n * ```\n */\n public async getFulfillmentOptions(\n body: GetPosFulfillmentOptionsBody\n ): Promise<ApiResult<GetPosFulfillmentOptionsContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/fulfillment-options\", { body })\n );\n }\n\n // ===============================\n // CUSTOMER ENDPOINTS\n // ===============================\n\n /**\n * Update cart customer information\n * @param pathParams - Cart ID\n * @param body - Customer update data\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.updateCartCustomer(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * customer_id: \"01H9CUST12345ABCDE\",\n * customer_group_id: \"01H9GROUP12345ABCDE\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update cart customer:\", error.message);\n * } else {\n * console.log(\"Cart customer updated:\", data.cart.id);\n * console.log(\"Customer ID:\", data.cart.customer_id);\n * console.log(\"Customer group:\", data.cart.customer_group_id);\n * }\n * ```\n */\n public async updateCartCustomer(\n pathParams: UpdatePosCartCustomerPathParams,\n body: UpdatePosCartCustomerBody\n ): Promise<ApiResult<UpdatePosCartCustomerContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/update-customer\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n // ===============================\n // ORDER ENDPOINTS\n // ===============================\n\n /**\n * Create order from cart\n * @param body - Order creation data\n * @returns Promise with created order\n * @example\n * ```typescript\n * const { data, error } = await pos.createOrder({\n * cart_id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to create order:\", error.message);\n * } else {\n * console.log(\"Order created:\", data.order.id);\n * console.log(\"Payment required:\", data.payment_required);\n * }\n * ```\n */\n public async createOrder(\n body: CreatePosOrderBody\n ): Promise<ApiResult<CreatePosOrderContent>> {\n return this.executeRequest(() =>\n // USES storefrontClient to avoid path conflicts with admin. This is only required when same path exists for both storefront and admin.\n this.storefrontClient.POST(\"/pos/orders\", { body })\n );\n }\n\n // ===============================\n // PAYMENT ENDPOINTS\n // ===============================\n\n /**\n * Get payment status\n * @param pathParams - Order number\n * @returns Promise with payment status\n * @example\n * ```typescript\n * const { data, error } = await pos.getPaymentStatus({ order_number: \"1234567890\" });\n *\n * if (error) {\n * console.error(\"Failed to get payment status:\", error.message);\n * } else {\n * console.log(\"Payment status:\", data.status);\n * console.log(\"Amount paid:\", data.amount_paid);\n * console.log(\"Amount unpaid:\", data.amount_unpaid);\n * console.log(\"Retry available:\", data.is_retry_available);\n * }\n * ```\n */\n public async getPaymentStatus(\n pathParams: PosGetPaymentStatusPathParams\n ): Promise<ApiResult<PosGetPaymentStatusContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/payment-status\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // CATALOG ENDPOINTS\n // ===============================\n\n /**\n * List all categories\n * @param query - Optional query parameters for filtering categories\n * @returns Promise with list of categories\n * @example\n * ```typescript\n * // Basic category listing\n * const { data, error } = await pos.listCategories();\n *\n * if (error) {\n * console.error(\"Failed to list categories:\", error.message);\n * } else {\n * console.log(\"Categories found:\", data.categories?.length || 0);\n * data.categories?.forEach(category => {\n * console.log(`Category: ${category.name} - ${category.description}`);\n * });\n * }\n *\n * // With pagination\n * const { data: catData, error: catError } = await pos.listCategories({\n * page: 1,\n * limit: 10\n * });\n * ```\n */\n public async listCategories(\n query?: PosListCategoriesQuery\n ): Promise<ApiResult<PosListCategoriesContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/categories\", {\n params: { query },\n })\n );\n }\n\n /**\n * List all products\n * @param query - Optional query parameters for filtering products\n * @param headers - Optional header parameters\n * @returns Promise with list of products\n * @example\n * ```typescript\n * // Basic product listing\n * const { data, error } = await pos.listProducts();\n *\n * if (error) {\n * console.error(\"Failed to list products:\", error.message);\n * } else {\n * console.log(\"Products found:\", data.products?.length || 0);\n * console.log(\"Pagination:\", data.pagination);\n * data.products?.forEach(product => {\n * console.log(`Product: ${product.name} - $${product.price}`);\n * });\n * }\n *\n * // With filtering and pagination\n * const { data: filteredData, error: filteredError } = await pos.listProducts({\n * page: 1,\n * limit: 20,\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" }),\n * category_slug: [\"electronics\", \"smartphones\"]\n * });\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listProducts(\n * {\n * page: 1,\n * limit: 20,\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" }),\n * category_slug: [\"electronics\", \"smartphones\"]\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async listProducts(\n query?: PosListProductsQuery,\n headers?: PosListProductsHeaderParams\n ): Promise<ApiResult<PosListProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List cross-sell products\n * @param query - Query parameters with product IDs for cross-sell recommendations\n * @param headers - Optional header parameters\n * @returns Promise with cross-sell products\n * @example\n * ```typescript\n * // Basic usage - get cross-sell products for cart items\n * const { data, error } = await pos.listCrosssellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\", \"prod_01H9ABC67890FGHIJ\"]\n * });\n *\n * // Advanced usage with pagination and custom sorting\n * const { data, error } = await pos.listCrosssellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 10,\n * sort_by: '{\"price\":\"asc\"}'\n * });\n *\n * // Override customer group ID for this specific request\n * const { data, error } = await pos.listCrosssellProducts(\n * {\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 10\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get cross-sell products:\", error.message);\n * } else {\n * console.log(\"Cross-sell products found:\", data.products.length);\n * console.log(\"Pagination:\", data.pagination);\n * data.products.forEach(product => {\n * console.log(`Product: ${product.name} - ${product.price}`);\n * });\n * }\n * ```\n */\n public async listCrosssellProducts(\n query: PosListCrosssellProductsQuery,\n headers?: PosListCrosssellProductsHeaderParams\n ): Promise<ApiResult<PosListCrosssellProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/cross-sell\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Search products\n * @param body - Search criteria and parameters\n * @param headers - Optional header parameters\n * @returns Promise with search results\n * @example\n * ```typescript\n * const { data, error } = await pos.searchProducts({\n * query: \"smartphone\",\n * filters: {\n * category: [\"electronics\", \"mobile\"],\n * price_range: { min: 100, max: 1000 },\n * brand: [\"Apple\", \"Samsung\"] // facet names depend on product configuration\n * },\n * page: 1,\n * limit: 20\n * });\n *\n * if (error) {\n * console.error(\"Failed to search products:\", error.message);\n * } else {\n * console.log(\"Search results:\", data.skus?.length || 0, \"products found\");\n * console.log(\"Facet distribution:\", data.facet_distribution);\n * console.log(\"Price range:\", data.facet_stats.price_range);\n * data.skus?.forEach(sku => {\n * console.log(`Found: ${sku.name} - ${sku.price}`);\n * });\n * }\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.searchProducts(\n * {\n * query: \"laptop\",\n * filters: { category: [\"computers\"] }\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async searchProducts(\n body: PosSearchProductsBody,\n headers?: PosSearchProductsHeaderParams\n ): Promise<ApiResult<PosSearchProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/catalog/products/search\", {\n body,\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List similar products\n * @param query - Query parameters with product ID for similarity recommendations\n * @param headers - Optional header parameters\n * @returns Promise with similar products\n * @example\n * ```typescript\n * // Basic usage - get similar products for a specific product\n * const { data, error } = await pos.listSimilarProducts({\n * product_id: \"prod_01H9XYZ12345ABCDE\"\n * });\n *\n * // Advanced usage with pagination and custom sorting\n * const { data, error } = await pos.listSimilarProducts({\n * product_id: \"prod_01H9XYZ12345ABCDE\",\n * page: 1,\n * limit: 20,\n * sort_by: '{\"relevance\":\"desc\"}'\n * });\n *\n * // Override customer group ID for this specific request\n * const { data, error } = await pos.listSimilarProducts(\n * {\n * product_id: \"prod_01H9XYZ12345ABCDE\",\n * page: 1,\n * limit: 20\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get similar products:\", error.message);\n * } else {\n * console.log(\"Similar products found:\", data.products.length);\n * console.log(\"Pagination:\", data.pagination);\n * data.products.forEach(product => {\n * console.log(`Similar: ${product.name} - ${product.price}`);\n * });\n * }\n * ```\n */\n public async listSimilarProducts(\n query: PosListSimilarProductsQuery,\n headers?: PosListSimilarProductsHeaderParams\n ): Promise<ApiResult<PosListSimilarProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/similar\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List up-sell products\n * @param query - Query parameters with product IDs for up-sell recommendations\n * @param headers - Optional header parameters\n * @returns Promise with up-sell products\n * @example\n * ```typescript\n * // Basic usage - get up-sell products for cart items\n * const { data, error } = await pos.listUpsellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"]\n * });\n *\n * // Advanced usage with pagination and custom sorting\n * const { data, error } = await pos.listUpsellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 15,\n * sort_by: '{\"relevance\":\"desc\"}'\n * });\n *\n * // Override customer group ID for this specific request\n * const { data, error } = await pos.listUpsellProducts(\n * {\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 15\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get up-sell products:\", error.message);\n * } else {\n * console.log(\"Up-sell products found:\", data.products.length);\n * console.log(\"Pagination:\", data.pagination);\n * data.products.forEach(product => {\n * console.log(`Up-sell: ${product.name} - ${product.price}`);\n * });\n * }\n * ```\n */\n public async listUpsellProducts(\n query: PosListUpsellProductsQuery,\n headers?: PosListUpsellProductsHeaderParams\n ): Promise<ApiResult<PosListUpsellProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/up-sell\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Get product details\n * @param pathParams - Product ID or slug\n * @param headers - Optional header parameters\n * @returns Promise with product details\n * @example\n * ```typescript\n * // Get product by ID\n * const { data, error } = await pos.getProductDetail(\n * { product_id_or_slug: \"prod_123\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get product details:\", error.message);\n * } else {\n * console.log(\"Product:\", data.product.name);\n * console.log(\"Price:\", data.product.price);\n * console.log(\"Description:\", data.product.description);\n * }\n *\n * // Get product by slug\n * const { data: slugData, error: slugError } = await pos.getProductDetail({\n * product_id_or_slug: \"detox-candy\"\n * });\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.getProductDetail(\n * { product_id_or_slug: \"detox-candy\" },\n * {\n * \"x-customer-group-id\": \"premium_customers\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async getProductDetail(\n pathParams: PosGetProductDetailPathParams,\n query?: PosGetProductDetailQuery,\n headers?: PosGetProductDetailHeaderParams\n ): Promise<ApiResult<PosGetProductDetailContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/{product_id_or_slug}\", {\n params: {\n path: pathParams,\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List product reviews\n * @param pathParams - Product ID\n * @param query - Optional query parameters for filtering reviews\n * @returns Promise with product reviews\n * @example\n * ```typescript\n * const { data, error } = await pos.listProductReviews(\n * { product_id: \"prod_123\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to list product reviews:\", error.message);\n * } else {\n * console.log(\"Reviews found:\", data.reviews?.length || 0);\n * data.reviews?.forEach(review => {\n * console.log(`Review by ${review.customer_name}: ${review.rating}/5`);\n * console.log(\"Comment:\", review.comment);\n * });\n * }\n *\n * // With pagination\n * const { data: reviewData, error: reviewError } = await pos.listProductReviews(\n * { product_id: \"prod_123\" },\n * {\n * page: 1,\n * limit: 5\n * }\n * );\n * ```\n */\n public async listProductReviews(\n pathParams: PosListProductReviewsPathParams,\n query?: PosListProductReviewsQuery\n ): Promise<ApiResult<PosListProductReviewsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/{product_id}/reviews\", {\n params: {\n path: pathParams,\n query,\n },\n })\n );\n }\n\n /**\n * List product variants\n * @param pathParams - Product ID\n * @param headers - Optional header parameters\n * @returns Promise with product variants\n * @example\n * ```typescript\n * const { data, error } = await pos.listProductVariants(\n * { product_id: \"prod_123\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to list product variants:\", error.message);\n * } else {\n * console.log(\"Variants found:\", data.variants?.length || 0);\n * data.variants?.forEach(variant => {\n * console.log(`Variant: ${variant.name} - SKU: ${variant.sku} - Price: ${variant.price}`);\n * });\n * }\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listProductVariants(\n * { product_id: \"prod_123\" },\n * {\n * \"x-customer-group-id\": \"wholesale_customers\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async listProductVariants(\n pathParams: PosListProductVariantsPathParams,\n query?: PosListProductVariantsQuery,\n headers?: PosListProductVariantsHeaderParams\n ): Promise<ApiResult<PosListProductVariantsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/{product_id}/variants\", {\n params: {\n path: pathParams,\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Get variant details\n * @param pathParams - Product ID and variant ID\n * @param headers - Optional header parameters\n * @returns Promise with variant details\n * @example\n * ```typescript\n * const { data, error } = await pos.getVariantDetail(\n * {\n * product_id: \"prod_123\",\n * variant_id: \"var_456\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get variant details:\", error.message);\n * } else {\n * console.log(\"Variant:\", data.variant.name);\n * console.log(\"SKU:\", data.variant.sku);\n * console.log(\"Price:\", data.variant.price);\n * console.log(\"Stock:\", data.variant.stock);\n * }\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.getVariantDetail(\n * {\n * product_id: \"prod_123\",\n * variant_id: \"var_456\"\n * },\n * {\n * \"x-customer-group-id\": \"wholesale_customers\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async getVariantDetail(\n pathParams: PosGetVariantDetailPathParams,\n query?: PosGetVariantDetailQuery,\n headers?: PosGetVariantDetailHeaderParams\n ): Promise<ApiResult<PosGetVariantDetailContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\n \"/pos/catalog/products/{product_id}/variants/{variant_id}\",\n {\n params: {\n path: pathParams,\n query,\n header: mergedHeaders,\n },\n }\n )\n );\n }\n\n /**\n * List all SKUs\n * @param query - Optional query parameters for filtering SKUs\n * @param headers - Optional header parameters\n * @returns Promise with list of SKUs\n * @example\n * ```typescript\n * // Basic SKU listing\n * const { data, error } = await pos.listSkus();\n *\n * if (error) {\n * console.error(\"Failed to list SKUs:\", error.message);\n * } else {\n * console.log(\"SKUs found:\", data.skus?.length || 0);\n * console.log(\"Pagination:\", data.pagination);\n * data.skus?.forEach(sku => {\n * console.log(`SKU: ${sku.sku} - Price: ${sku.price}`);\n * });\n * }\n *\n * // With pagination\n * const { data: skuData, error: skuError } = await pos.listSkus({\n * page: 1,\n * limit: 50\n * });\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listSkus(\n * {\n * page: 1,\n * limit: 50\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async listSkus(\n query?: PosListSkusQuery,\n headers?: PosListSkusHeaderParams\n ): Promise<ApiResult<PosListSkusContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/skus\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n // ===============================\n // ADMIN ENDPOINTS\n // ===============================\n\n // ADMIN INVENTORY ENDPOINTS\n\n /**\n * List all inventories (Admin)\n * @param query - Optional query parameters for filtering inventories\n * @returns Promise with list of inventories\n * @example\n * ```typescript\n * // Basic inventory listing\n * const { data, error } = await pos.listInventories();\n *\n * if (error) {\n * console.error(\"Failed to list inventories:\", error.message);\n * } else {\n * console.log(\"Inventories found:\", data.content?.inventories?.length || 0);\n * data.content?.inventories?.forEach(inventory => {\n * console.log(`Product: ${inventory.product_name} - Stock: ${inventory.stock_quantity}`);\n * });\n * }\n *\n * // With pagination and filters\n * const { data: filteredData, error: filteredError } = await pos.listInventories({\n * page: 1,\n * limit: 20,\n * sort_by: JSON.stringify({ \"stock_quantity\": \"desc\" }),\n * filters: JSON.stringify({ \"product_name\": \"smartphone\" })\n * });\n * ```\n */\n public async listInventories(\n query?: PosListInventoryQuery\n ): Promise<ApiResult<PosListInventoryContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/inventories\", {\n params: { query },\n })\n );\n }\n\n /**\n * List all inventory activities (Admin)\n * @param query - Optional query parameters for filtering inventory activities\n * @returns Promise with list of inventory activities\n * @example\n * ```typescript\n * // Basic inventory activities listing\n * const { data, error } = await pos.listInventoryActivities();\n *\n * if (error) {\n * console.error(\"Failed to list inventory activities:\", error.message);\n * } else {\n * console.log(\"Activities found:\", data.content?.activities?.length || 0);\n * data.content?.activities?.forEach(activity => {\n * console.log(`Activity: ${activity.activity_type} - Product: ${activity.product_name} - Quantity: ${activity.quantity}`);\n * });\n * }\n *\n * // With pagination and filters\n * const { data: filteredData, error: filteredError } = await pos.listInventoryActivities({\n * page: 1,\n * limit: 50,\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" }),\n * filters: JSON.stringify({ \"activity_type\": \"add\" })\n * });\n * ```\n */\n public async listInventoryActivities(\n query?: PosListInventoryActivityQuery\n ): Promise<ApiResult<PosListInventoryActivityContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/inventories/activites\", {\n params: { query },\n })\n );\n }\n\n /**\n * Get inventory detail (Admin)\n * @param query - Query parameters with product/variant information\n * @returns Promise with inventory details\n * @example\n * ```typescript\n * // Get inventory detail for a product\n * const { data, error } = await pos.getInventoryDetail({\n * product_id: \"01H9XYZ12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get inventory detail:\", error.message);\n * } else {\n * const inventory = data.content?.inventory;\n * console.log(`Product: ${inventory?.product_name}`);\n * console.log(`Stock: ${inventory?.stock_quantity}`);\n * console.log(`Warehouse details:`, inventory?.details);\n * }\n *\n * // Get inventory detail for a product variant\n * const { data: variantData, error: variantError } = await pos.getInventoryDetail({\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: \"01H9ABC67890FGHIJ\"\n * });\n *\n * // Get inventory detail for a specific lot/batch\n * const { data: batchData, error: batchError } = await pos.getInventoryDetail({\n * product_id: \"01H9XYZ12345ABCDE\",\n * lot_batch: \"BATCH001\"\n * });\n * ```\n */\n public async getInventoryDetail(\n query: PosListInventoryDetailQuery\n ): Promise<ApiResult<PosListInventoryDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/inventories/detail\", {\n params: { query },\n })\n );\n }\n\n // ADMIN CUSTOMER ENDPOINTS\n\n /**\n * List all customers (Admin)\n * @param query - Optional query parameters for filtering customers\n * @returns Promise with list of customers\n * @example\n * ```typescript\n * // Basic customer listing\n * const { data, error } = await pos.getCustomers();\n *\n * if (error) {\n * console.error(\"Failed to list customers:\", error.message);\n * } else {\n * console.log(\"Customers found:\", data.content?.customers?.length || 0);\n * console.log(\"Pagination:\", data.content?.pagination);\n * data.content?.customers?.forEach(customer => {\n * console.log(`Customer: ${customer.full_name} - Email: ${customer.email}`);\n * });\n * }\n *\n * // With search and pagination\n * const { data: searchData, error: searchError } = await pos.getCustomers({\n * page: 1,\n * limit: 20,\n * search: \"john@example.com\",\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" })\n * });\n * ```\n */\n public async getCustomers(\n query?: PosListCustomersQuery\n ): Promise<ApiResult<PosListCustomersContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/customers\", {\n params: { query },\n })\n );\n }\n\n /**\n * Get customer details (Admin)\n * @param pathParams - Customer ID\n * @returns Promise with customer details\n * @example\n * ```typescript\n * const { data, error } = await pos.getCustomer({\n * id: \"01H9CUST12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get customer:\", error.message);\n * } else {\n * const customer = data.content?.customer;\n * console.log(`Customer: ${customer?.full_name}`);\n * console.log(`Email: ${customer?.email}`);\n * console.log(`Phone: ${customer?.phone}`);\n * console.log(`Loyalty points: ${customer?.loyalty?.points_balance}`);\n * console.log(`Total spent: ${customer?.loyalty?.lifetime_spent}`);\n * }\n * ```\n */\n public async getCustomer(\n pathParams: PosGetCustomerDetailPathParams\n ): Promise<ApiResult<PosGetCustomerDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/customers/{id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ADMIN ORDER ENDPOINTS\n\n /**\n * List all orders (Admin)\n * @param query - Optional query parameters for filtering orders\n * @returns Promise with list of orders\n * @example\n * ```typescript\n * // Basic order listing\n * const { data, error } = await pos.listOrders();\n *\n * if (error) {\n * console.error(\"Failed to list orders:\", error.message);\n * } else {\n * console.log(\"Orders found:\", data.content?.orders?.length || 0);\n * console.log(\"Pagination:\", data.content?.pagination);\n * data.content?.orders?.forEach(order => {\n * console.log(`Order: ${order.order_number} - Status: ${order.status} - Total: ${order.grand_total}`);\n * });\n * }\n *\n * // With filters and pagination\n * const { data: filteredData, error: filteredError } = await pos.listOrders({\n * page: 1,\n * limit: 50,\n * search: \"ORD-2024\",\n * filters: JSON.stringify({ \"status\": \"delivered\", \"payment_status\": \"success\" }),\n * sort_by: JSON.stringify({ \"order_date\": \"desc\" })\n * });\n * ```\n */\n public async listOrders(\n query?: PosListOrdersQuery\n ): Promise<ApiResult<PosListOrdersContent>> {\n return this.executeRequest(() =>\n // USES adminClient to avoid path conflicts with storefront. This is only required when same path exists for both storefront and admin.\n this.adminClient.GET(\"/pos/orders\", {\n params: { query },\n })\n );\n }\n\n /**\n * Get order details (Admin)\n * @param pathParams - Order number\n * @returns Promise with order details\n * @example\n * ```typescript\n * const { data, error } = await pos.getOrderDetail({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get order:\", error.message);\n * } else {\n * const order = data.content?.order;\n * console.log(`Order: ${order?.order_number}`);\n * console.log(`Status: ${order?.status}`);\n * console.log(`Payment Status: ${order?.payment_status}`);\n * console.log(`Total: ${order?.grand_total}`);\n * console.log(`Items:`, order?.order_items);\n * console.log(`Billing Address:`, order?.billing_address);\n * console.log(`Payments:`, order?.payments);\n * }\n * ```\n */\n public async getOrderDetail(\n pathParams: PosGetOrderDetailPathParams\n ): Promise<ApiResult<PosGetOrderDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * List order activity (Admin)\n * @param pathParams - Order number\n * @returns Promise with order activities\n * @example\n * ```typescript\n * const { data, error } = await pos.listOrderActivity({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get order activity:\", error.message);\n * } else {\n * console.log(\"Activities found:\", data.content?.activity?.length || 0);\n * data.content?.activity?.forEach(activity => {\n * console.log(`${activity.created_at}: ${activity.activity_type} - ${activity.comment}`);\n * console.log(`By: ${activity.user_name} (${activity.user_type})`);\n * });\n * }\n * ```\n */\n public async listOrderActivity(\n pathParams: PosListOrderActivityPathParams\n ): Promise<ApiResult<PosListOrderActivityContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/activity\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Get order invoice (Admin)\n * @param pathParams - Order number\n * @param query - Optional format parameter\n * @returns Promise with order invoice\n * @example\n * ```typescript\n * // Get invoice as JSON\n * const { data, error } = await pos.getOrderInvoice(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"json\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get order invoice:\", error.message);\n * } else {\n * data.content?.invoices?.forEach(invoice => {\n * console.log(`Invoice: ${invoice.invoice_number}`);\n * console.log(`Date: ${invoice.invoice_date}`);\n * console.log(`Total: ${invoice.grand_total}`);\n * console.log(`Items:`, invoice.items);\n * });\n * }\n *\n * // Get invoice as PDF\n * const { data: pdfData, error: pdfError } = await pos.getOrderInvoice(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"pdf\" }\n * );\n * ```\n */\n public async getOrderInvoice(\n pathParams: PosGetOrderInvoicePathParams,\n query?: PosGetOrderInvoiceQuery\n ): Promise<ApiResult<PosGetOrderInvoiceContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/invoice\", {\n params: { path: pathParams, query },\n })\n );\n }\n\n /**\n * Get order receipt (Admin)\n * @param pathParams - Order number\n * @param query - Optional format parameter\n * @returns Promise with order receipt\n * @example\n * ```typescript\n * // Get receipt as JSON\n * const { data, error } = await pos.getOrderReceipt(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"json\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get order receipt:\", error.message);\n * } else {\n * const receipt = data.content?.order_receipt;\n * console.log(`Order: ${receipt?.order_number}`);\n * console.log(`Date: ${receipt?.order_date}`);\n * console.log(`Total: ${receipt?.grand_total}`);\n * console.log(`Items:`, receipt?.order_items);\n * console.log(`Payments:`, receipt?.payments);\n * }\n *\n * // Get receipt as PDF\n * const { data: pdfData, error: pdfError } = await pos.getOrderReceipt(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"pdf\" }\n * );\n * ```\n */\n public async getOrderReceipt(\n pathParams: PosGetOrderReceiptPathParams,\n query?: PosGetOrderReceiptQuery\n ): Promise<ApiResult<PosGetOrderReceiptContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/receipt\", {\n params: { path: pathParams, query },\n })\n );\n }\n\n /**\n * Get order shipments (Admin)\n * @param pathParams - Order number\n * @returns Promise with order shipments\n * @example\n * ```typescript\n * const { data, error } = await pos.getOrderShipments({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get order shipments:\", error.message);\n * } else {\n * const shipment = data.content?.shipment;\n * console.log(`Order: ${shipment?.order_number}`);\n * console.log(`Order Status: ${shipment?.order_status}`);\n * console.log(`Payment Status: ${shipment?.payment_status}`);\n * console.log(`Customer: ${shipment?.customer_name}`);\n * console.log(`Shipments:`, shipment?.shipments);\n * console.log(`Allowed Actions:`, shipment?.allowed_actions);\n * }\n * ```\n */\n public async getOrderShipments(\n pathParams: PosListOrderShipmentsPathParams\n ): Promise<ApiResult<PosListOrderShipmentsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/shipments\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ADMIN SHIPMENT ENDPOINTS\n\n /**\n * List all shipments (Admin)\n * @param query - Optional query parameters for filtering shipments\n * @returns Promise with list of shipments\n * @example\n * ```typescript\n * // Basic shipment listing\n * const { data, error } = await pos.listShipments();\n *\n * if (error) {\n * console.error(\"Failed to list shipments:\", error.message);\n * } else {\n * console.log(\"Shipments found:\", data.content?.shipments?.length || 0);\n * console.log(\"Pagination:\", data.content?.pagination);\n * data.content?.shipments?.forEach(shipment => {\n * console.log(`Shipment: ${shipment.shipment_number} - Status: ${shipment.status}`);\n * console.log(`Order: ${shipment.order_number} - AWB: ${shipment.awb_no}`);\n * });\n * }\n *\n * // With filters and search\n * const { data: filteredData, error: filteredError } = await pos.listShipments({\n * page: 1,\n * limit: 25,\n * search: \"SHIP-2024\",\n * filters: JSON.stringify({ \"status\": \"shipped\" }),\n * sort_by: JSON.stringify({ \"shipped_date\": \"desc\" })\n * });\n * ```\n */\n public async listShipments(\n query?: PosListShipmentsQuery\n ): Promise<ApiResult<PosListShipmentsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/shipping/shipments\", {\n params: { query },\n })\n );\n }\n\n /**\n * Check inventory for order (Admin)\n * @param pathParams - Order number\n * @returns Promise with inventory check results\n * @example\n * ```typescript\n * const { data, error } = await pos.checkInventory({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to check inventory:\", error.message);\n * } else {\n * const inventory = data.content;\n * console.log(`Inventory Status: ${inventory?.inventory_status}`);\n * console.log(`Shipment Items:`, inventory?.shipment_items);\n * console.log(`Recommended Warehouses:`, inventory?.recommended_warehouses);\n * console.log(`Inventory Detail:`, inventory?.inventory_detail);\n * console.log(`Allowed Actions:`, inventory?.allowed_action);\n * }\n * ```\n */\n public async checkInventory(\n pathParams: PosCheckOrderInventoryPathParams\n ): Promise<ApiResult<PosCheckOrderInventoryContent>> {\n return this.executeRequest(() =>\n this.adminClient.GET(\n \"/pos/orders/{order_number}/check-inventory\",\n {\n params: { path: pathParams },\n }\n )\n );\n }\n\n /**\n * Refund shortfall for order (Admin)\n * @param pathParams - Order number\n * @param body - Refund details\n * @returns Promise with refund confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.refundShortfall(\n * { order_number: \"ORD-2024-001234\" },\n * {\n * items: [\n * {\n * sku: \"SKU-123\",\n * quantity: 2,\n * free_quantity: 0\n * }\n * ],\n * payment_method: \"original-payment-mode\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to process refund:\", error.message);\n * } else {\n * console.log(\"Refund processed:\", data.message);\n * console.log(\"Success:\", data.success);\n * }\n *\n * // Refund to bank transfer\n * const { data: bankData, error: bankError } = await pos.refundShortfall(\n * { order_number: \"ORD-2024-001234\" },\n * {\n * items: [{ sku: \"SKU-123\", quantity: 1 }],\n * payment_method: \"bank-transfer\",\n * bank_account_id: \"BANK_ACC_123\"\n * }\n * );\n * ```\n */\n public async refundShortfall(\n pathParams: PosRefundShortfallPathParams,\n body: PosRefundShortfallBody\n ): Promise<ApiResult<PosRefundShortfallResponse>> {\n return this.executeRequest(() =>\n this.client.POST(\n \"/pos/shipping/shipments/{order_number}/refund-shortfall\",\n {\n params: { path: pathParams },\n body,\n }\n )\n );\n }\n\n /**\n * Get shipment details (Admin)\n * @param pathParams - Shipment reference number\n * @returns Promise with shipment details\n * @example\n * ```typescript\n * const { data, error } = await pos.getShipment({\n * reference_number: \"SHIP-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get shipment:\", error.message);\n * } else {\n * const shipment = data.content?.shipment;\n * console.log(`Order: ${shipment?.order_number}`);\n * console.log(`Shipments:`, shipment?.shipments);\n * shipment?.shipments?.forEach(s => {\n * console.log(` Shipment: ${s.shipment_number} - Status: ${s.status}`);\n * console.log(` AWB: ${s.awb_no} - Courier: ${s.courier_company_name}`);\n * console.log(` Items:`, s.shipment_items);\n * });\n * }\n * ```\n */\n public async getShipment(\n pathParams: PosGetShipmentDetailPathParams\n ): Promise<ApiResult<PosGetShipmentDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/shipping/shipments/{reference_number}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Get shipment invoice (Admin)\n * @param pathParams - Shipment reference number\n * @param query - Optional format parameter\n * @returns Promise with shipment invoice\n * @example\n * ```typescript\n * // Get shipment invoice as JSON\n * const { data, error } = await pos.getShipmentInvoice(\n * { reference_number: \"SHIP-2024-001234\" },\n * { format: \"json\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get shipment invoice:\", error.message);\n * } else {\n * const invoice = data.content?.invoice;\n * console.log(`Invoice: ${invoice?.invoice_number}`);\n * console.log(`Date: ${invoice?.invoice_date}`);\n * console.log(`Total: ${invoice?.grand_total}`);\n * console.log(`Items:`, invoice?.items);\n * }\n *\n * // Get shipment invoice as PDF\n * const { data: pdfData, error: pdfError } = await pos.getShipmentInvoice(\n * { reference_number: \"SHIP-2024-001234\" },\n * { format: \"pdf\" }\n * );\n * ```\n */\n public async getShipmentInvoice(\n pathParams: PosGetShipmentInvoicePathParams,\n query?: PosGetShipmentInvoiceQuery\n ): Promise<ApiResult<PosGetShipmentInvoiceContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/shipping/shipments/{reference_number}/invoice\", {\n params: { path: pathParams, query },\n })\n );\n }\n\n /**\n * Update shipment details (Admin)\n * @param pathParams - Shipment reference number\n * @param body - Shipment update data\n * @returns Promise with updated shipment\n * @example\n * ```typescript\n * const { data, error } = await pos.updateShipment(\n * { reference_number: \"SHIP-2024-001234\" },\n * {\n * status: \"shipped\",\n * awb_no: \"AWB123456789\",\n * courier_company_name: \"BlueDart\",\n * shipping_label_url: \"https://example.com/label.pdf\",\n * tracking_url: \"https://tracking.example.com/AWB123456789\",\n * eta_delivery: \"2024-01-15T10:00:00Z\",\n * shipped_date: \"2024-01-10T14:30:00Z\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update shipment:\", error.message);\n * } else {\n * console.log(\"Shipment updated successfully:\", data.message);\n * const shipment = data.content?.shipment;\n * console.log(`Updated shipment status:`, shipment?.shipments?.[0]?.status);\n * }\n *\n * // Update delivery status\n * const { data: deliveryData, error: deliveryError } = await pos.updateShipment(\n * { reference_number: \"SHIP-2024-001234\" },\n * {\n * status: \"delivered\",\n * delivered_date: \"2024-01-15T16:45:00Z\"\n * }\n * );\n * ```\n */\n public async updateShipment(\n pathParams: PosUpdateShipmentPathParams,\n body: PosUpdateShipmentBody\n ): Promise<ApiResult<PosUpdateShipmentContent>> {\n return this.executeRequest(() =>\n this.client.PUT(\n \"/pos/shipping/shipments/{reference_number}/manual-update\",\n {\n params: { path: pathParams },\n body,\n }\n )\n );\n }\n}\n","import { PosAPIClient } from \"./lib/client\";\nimport { type BaseSDKOptions } from \"@commercengine/sdk-core\";\nimport { Environment } from \"./lib/utils/url\";\nimport { PosClient } from \"./lib/pos\";\nimport {\n type TokenStorage,\n MemoryTokenStorage,\n BrowserTokenStorage,\n} from \"./lib/middleware/auth\";\nimport {\n extractUserInfoFromToken,\n getUserIdFromToken,\n isUserLoggedIn,\n isUserAuthenticated,\n getLocationIdFromToken,\n getRoleFromToken,\n getTenantIdFromToken,\n type UserInfo,\n} from \"./lib/utils/jwt\";\nimport { ResponseUtils } from \"@commercengine/sdk-core\";\n\n/**\n * Supported default headers for POS API\n */\nexport interface SupportedDefaultHeaders {\n /**\n * Customer group ID used for pricing and promotions\n */\n customer_group_id?: string;\n /**\n * Debug mode header\n */\n debug_mode?: boolean;\n}\n\n/**\n * SDK initialization options for the POS API\n */\nexport interface PosSDKOptions extends BaseSDKOptions<SupportedDefaultHeaders> {\n /**\n * Store ID for the API requests\n */\n storeId: string;\n\n /**\n * Environment to use (defaults to Production)\n * Overrides baseUrl if provided\n */\n environment?: Environment;\n\n /**\n * Custom base URL (overrides environment if provided)\n * If not provided, will be built from storeId and environment\n */\n baseUrl?: string;\n\n /**\n * X-Api-Key for authentication endpoints that require API key\n * Required for login, pair-device, and verify-otp endpoints\n * Always required even when initializing with tokens (for refresh fallbacks)\n */\n apiKey: string;\n\n /**\n * Optional initial access token\n * - If tokenStorage is provided: Used as initial token value, then managed automatically\n * - If tokenStorage is not provided: Used for manual token management\n */\n accessToken?: string;\n\n /**\n * Optional initial refresh token\n * - Only used when tokenStorage is provided\n * - Allows initialization with both access and refresh tokens\n */\n refreshToken?: string;\n\n /**\n * Optional token storage for automatic token management\n * If provided, enables automatic token refresh and management\n */\n tokenStorage?: TokenStorage;\n\n /**\n * Callback when tokens are updated (login/refresh)\n */\n onTokensUpdated?: (accessToken: string, refreshToken: string) => void;\n\n /**\n * Callback when tokens are cleared (logout/error)\n */\n onTokensCleared?: () => void;\n}\n\n/**\n * Main SDK class for the POS API\n * Provides access to all POS endpoints through a single client\n */\nexport class PosSDK {\n /**\n * Client for all POS operations (auth, cart, orders, etc.)\n */\n public readonly pos: PosClient;\n\n /**\n * Create a new PosSDK instance\n *\n * @param options - Configuration options for the SDK\n */\n constructor(options: PosSDKOptions) {\n // Convert options to internal config format\n const config: PosSDKOptions = {\n storeId: options.storeId,\n environment: options.environment,\n baseUrl: options.baseUrl,\n accessToken: options.accessToken,\n refreshToken: options.refreshToken,\n apiKey: options.apiKey,\n timeout: options.timeout,\n tokenStorage: options.tokenStorage,\n onTokensUpdated: options.onTokensUpdated,\n onTokensCleared: options.onTokensCleared,\n defaultHeaders: options.defaultHeaders,\n debug: options.debug,\n logger: options.logger,\n };\n\n this.pos = new PosClient(config);\n }\n\n /**\n * Set authentication tokens for the client\n *\n * @param accessToken - The access token (required)\n * @param refreshToken - The refresh token (optional)\n *\n * Behavior:\n * - If tokenStorage is provided: Stores tokens for automatic management\n * - If tokenStorage is not provided: Only stores access token for manual management\n */\n public async setTokens(\n accessToken: string,\n refreshToken?: string\n ): Promise<void> {\n await this.pos.setTokens(accessToken, refreshToken);\n }\n\n /**\n * Clear all authentication tokens from the client\n *\n * Behavior:\n * - If tokenStorage is provided: Clears both access and refresh tokens from storage\n * - If tokenStorage is not provided: Clears the manual access token\n */\n public async clearTokens(): Promise<void> {\n await this.pos.clearTokens();\n }\n\n /**\n * Set the API key for the client\n *\n * @param apiKey - The API key to set\n */\n public setApiKey(apiKey: string): void {\n this.pos.setApiKey(apiKey);\n }\n\n /**\n * Get the current access token if available\n */\n public async getAccessToken(): Promise<string | null> {\n const header = await this.pos.getAuthorizationHeader();\n return header.startsWith(\"Bearer \") ? header.substring(7) : null;\n }\n\n /**\n * Set default headers for the client\n *\n * @param headers - Default headers to set\n */\n public setDefaultHeaders(headers: SupportedDefaultHeaders): void {\n this.pos.setDefaultHeaders(headers);\n }\n\n /**\n * Get current default headers\n */\n public getDefaultHeaders(): SupportedDefaultHeaders | undefined {\n return this.pos.getDefaultHeaders();\n }\n\n /**\n * Get user information from the current access token\n *\n * @returns User information extracted from JWT token, or null if no token or invalid token\n */\n public async getUserInfo(): Promise<UserInfo | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return extractUserInfoFromToken(token);\n }\n\n /**\n * Get the current user ID from the access token\n *\n * @returns User ID (ulid) or null if no token or invalid token\n */\n public async getUserId(): Promise<string | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getUserIdFromToken(token);\n }\n\n /**\n * Check if the current user is logged in\n *\n * @returns True if user is logged in, false otherwise\n */\n public async isLoggedIn(): Promise<boolean> {\n const token = await this.getAccessToken();\n if (!token) return false;\n return isUserLoggedIn(token);\n }\n\n /**\n * Check if the current user is authenticated with POS access\n * This verifies the user has valid device and role information\n *\n * @returns True if user is authenticated for POS operations\n */\n public async isAuthenticated(): Promise<boolean> {\n const token = await this.getAccessToken();\n if (!token) return false;\n return isUserAuthenticated(token);\n }\n\n /**\n * Get the location ID from the current access token\n * This is commonly needed for POS API requests\n *\n * @returns Location ID or null if no token or invalid token\n */\n public async getLocationId(): Promise<string | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getLocationIdFromToken(token);\n }\n\n /**\n * Get the role information from the current access token\n *\n * @returns Role object with roleId, roleName, locationId, and locationName, or null if no token or invalid token\n */\n public async getRole(): Promise<{\n roleId: string;\n roleName: string;\n locationId: string;\n locationName: string;\n } | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getRoleFromToken(token);\n }\n\n /**\n * Get the tenant ID from the current access token\n *\n * @returns Tenant ID or null if no token or invalid token\n */\n public async getTenantId(): Promise<string | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getTenantIdFromToken(token);\n }\n}\n\n// Export the main SDK class as default\nexport default PosSDK;\n\n// Export individual clients for advanced usage\nexport { PosAPIClient, PosClient, ResponseUtils };\n\n// Export environment enum\nexport { Environment } from \"./lib/utils/url\";\n\n// Export token storage types\nexport type { TokenStorage };\nexport { MemoryTokenStorage, BrowserTokenStorage };\n\n// Export ALL types from sdk-core\nexport type * from \"@commercengine/sdk-core\";\n\n// Export POS-specific JWT types\nexport type { UserInfo } from \"./lib/utils/jwt\";\n\n// Export API types for consumer usage\nexport type { components, operations, paths } from \"./types/pos\";\nexport type * from \"./types/pos-api-types\";\n"],"mappings":"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"}
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../../sdk-core/dist/index.mjs","../src/lib/utils/jwt.ts","../src/lib/utils/auth.ts","../src/lib/middleware/auth.ts","../src/lib/utils/url.ts","../src/lib/client.ts","../src/lib/pos.ts","../src/index.ts"],"sourcesContent":["import createClient from \"openapi-fetch\";\n\n//#region src/middleware/debug.ts\n/**\n* Response utilities for debugging and working with Response objects\n*/\nvar ResponseUtils = class {\n\t/**\n\t* Get response headers as a plain object\n\t*/\n\tstatic getHeaders(response) {\n\t\treturn Object.fromEntries(response.headers.entries());\n\t}\n\t/**\n\t* Get specific header value\n\t*/\n\tstatic getHeader(response, name) {\n\t\treturn response.headers.get(name);\n\t}\n\t/**\n\t* Check if response was successful\n\t*/\n\tstatic isSuccess(response) {\n\t\treturn response.ok;\n\t}\n\t/**\n\t* Get response metadata\n\t*/\n\tstatic getMetadata(response) {\n\t\treturn {\n\t\t\tstatus: response.status,\n\t\t\tstatusText: response.statusText,\n\t\t\tok: response.ok,\n\t\t\turl: response.url,\n\t\t\tredirected: response.redirected,\n\t\t\ttype: response.type,\n\t\t\theaders: Object.fromEntries(response.headers.entries())\n\t\t};\n\t}\n\t/**\n\t* Clone and read response as text (useful for debugging)\n\t* Note: This can only be called once per response\n\t*/\n\tstatic async getText(response) {\n\t\treturn await response.clone().text();\n\t}\n\t/**\n\t* Clone and read response as JSON (useful for debugging)\n\t* Note: This can only be called once per response\n\t*/\n\tstatic async getJSON(response) {\n\t\treturn await response.clone().json();\n\t}\n\t/**\n\t* Format response information for debugging\n\t*/\n\tstatic format(response) {\n\t\tconst metadata = this.getMetadata(response);\n\t\treturn `${metadata.status} ${metadata.statusText} - ${metadata.url}`;\n\t}\n\t/**\n\t* Format response for logging purposes (enhanced version)\n\t*/\n\tstatic formatResponse(response) {\n\t\treturn {\n\t\t\tstatus: response.status,\n\t\t\tstatusText: response.statusText,\n\t\t\turl: response.url,\n\t\t\tok: response.ok\n\t\t};\n\t}\n};\n/**\n* Debug logging utilities\n*/\nvar DebugLogger = class {\n\tlogger;\n\tconstructor(logger) {\n\t\tthis.logger = logger || ((level, message, data) => {\n\t\t\tconsole.log(`[${level.toUpperCase()}]`, message);\n\t\t\tif (data) console.log(data);\n\t\t});\n\t}\n\t/**\n\t* Log debug information about API request\n\t*/\n\tlogRequest(request, requestBody) {\n\t\tthis.logger(\"info\", \"API Request Debug Info\", {\n\t\t\tmethod: request.method,\n\t\t\turl: request.url,\n\t\t\theaders: Object.fromEntries(request.headers.entries()),\n\t\t\tbody: requestBody,\n\t\t\ttimestamp: (/* @__PURE__ */ new Date()).toISOString()\n\t\t});\n\t}\n\t/**\n\t* Log debug information about API response\n\t*/\n\tasync logResponse(response, responseBody) {\n\t\tthis.logger(\"info\", \"API Response Debug Info\", {\n\t\t\turl: response.url,\n\t\t\tstatus: response.status,\n\t\t\tstatusText: response.statusText,\n\t\t\tok: response.ok,\n\t\t\theaders: Object.fromEntries(response.headers.entries()),\n\t\t\tredirected: response.redirected,\n\t\t\ttype: response.type,\n\t\t\ttimestamp: (/* @__PURE__ */ new Date()).toISOString()\n\t\t});\n\t\tif (responseBody) this.logger(\"info\", \"API Response Data\", {\n\t\t\tdata: responseBody,\n\t\t\tcontentType: response.headers.get(\"content-type\"),\n\t\t\tcontentLength: response.headers.get(\"content-length\")\n\t\t});\n\t}\n\t/**\n\t* Log error information\n\t*/\n\tlogError(message, error) {\n\t\tthis.logger(\"error\", message, error);\n\t}\n\t/**\n\t* Compatibility shim retained for older internal callers.\n\t* Response bodies are no longer cached by the debug logger.\n\t*/\n\tgetCachedResponseText(_url) {\n\t\treturn null;\n\t}\n\t/**\n\t* Compatibility shim retained for older internal callers.\n\t* Response bodies are no longer cached by the debug logger.\n\t*/\n\tclearCache() {}\n\tinfo(message, data) {\n\t\tthis.logger(\"info\", message, data);\n\t}\n\twarn(message, data) {\n\t\tthis.logger(\"warn\", message, data);\n\t}\n\terror(message, data) {\n\t\tthis.logger(\"error\", message, data);\n\t}\n};\n/**\n* Extract request body for logging\n*/\nasync function extractRequestBody(request) {\n\tif (request.method === \"GET\" || request.method === \"HEAD\") return null;\n\ttry {\n\t\tconst clonedRequest = request.clone();\n\t\tconst contentType = request.headers.get(\"content-type\")?.toLowerCase();\n\t\tif (contentType?.startsWith(\"application/json\")) return await clonedRequest.json();\n\t\telse if (contentType?.startsWith(\"multipart/form-data\")) return \"[FormData - cannot display]\";\n\t\telse if (contentType?.startsWith(\"text/\")) return await clonedRequest.text();\n\t\treturn \"[Request body - unknown format]\";\n\t} catch (error) {\n\t\treturn \"[Request body unavailable]\";\n\t}\n}\n/**\n* Create debug middleware for openapi-fetch (internal use)\n* Enhanced version that combines original functionality with duration tracking\n*/\nfunction createDebugMiddleware(logger) {\n\tconst debugLogger = new DebugLogger(logger);\n\treturn {\n\t\tasync onRequest({ request }) {\n\t\t\trequest.__debugStartTime = Date.now();\n\t\t\tconst requestBody = await extractRequestBody(request);\n\t\t\tdebugLogger.logRequest(request, requestBody);\n\t\t\treturn request;\n\t\t},\n\t\tasync onResponse({ request, response }) {\n\t\t\tconst startTime = request.__debugStartTime;\n\t\t\tconst duration = startTime ? Date.now() - startTime : 0;\n\t\t\tconst cloned = response.clone();\n\t\t\tlet responseBody = null;\n\t\t\ttry {\n\t\t\t\tconst contentType = response.headers.get(\"content-type\")?.toLowerCase();\n\t\t\t\tif (contentType?.startsWith(\"application/json\")) responseBody = await cloned.json();\n\t\t\t\telse if (contentType?.startsWith(\"text/\")) responseBody = await cloned.text();\n\t\t\t} catch (error) {}\n\t\t\tawait debugLogger.logResponse(response, responseBody);\n\t\t\tif (duration > 0) debugLogger.info(`Request completed in ${duration}ms`, {\n\t\t\t\turl: request.url,\n\t\t\t\tmethod: request.method\n\t\t\t});\n\t\t\treturn response;\n\t\t},\n\t\tasync onError({ error, request }) {\n\t\t\tdebugLogger.logError(\"API Request Failed\", {\n\t\t\t\terror: {\n\t\t\t\t\tname: error instanceof Error ? error.name : \"Unknown\",\n\t\t\t\t\tmessage: error instanceof Error ? error.message : String(error),\n\t\t\t\t\tstack: error instanceof Error ? error.stack : void 0\n\t\t\t\t},\n\t\t\t\trequest: {\n\t\t\t\t\tmethod: request.method,\n\t\t\t\t\turl: request.url,\n\t\t\t\t\theaders: Object.fromEntries(request.headers.entries())\n\t\t\t\t},\n\t\t\t\ttimestamp: (/* @__PURE__ */ new Date()).toISOString()\n\t\t\t});\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n//#endregion\n//#region src/middleware/timeout.ts\n/**\n* Timeout middleware for Commerce Engine SDKs\n*/\n/**\n* Create timeout middleware for openapi-fetch\n* Adds configurable request timeout functionality\n* \n* @param timeoutMs - Timeout duration in milliseconds\n* @returns Middleware object with onRequest handler\n*/\nfunction createTimeoutMiddleware(timeoutMs) {\n\tconst timeouts = /* @__PURE__ */ new WeakMap();\n\tconst clearRequestTimeout = (signal) => {\n\t\tconst timeoutId = timeouts.get(signal);\n\t\tif (timeoutId) {\n\t\t\tclearTimeout(timeoutId);\n\t\t\ttimeouts.delete(signal);\n\t\t}\n\t};\n\treturn {\n\t\tonRequest: async ({ request }) => {\n\t\t\tconst controller = new AbortController();\n\t\t\tconst timeoutId = setTimeout(() => controller.abort(), timeoutMs);\n\t\t\tif (request.signal) request.signal.addEventListener(\"abort\", () => controller.abort(), { once: true });\n\t\t\tconst newRequest = new Request(request, { signal: controller.signal });\n\t\t\ttimeouts.set(newRequest.signal, timeoutId);\n\t\t\tcontroller.signal.addEventListener(\"abort\", () => clearRequestTimeout(newRequest.signal), { once: true });\n\t\t\treturn newRequest;\n\t\t},\n\t\tonResponse: async ({ request, response }) => {\n\t\t\tclearRequestTimeout(request.signal);\n\t\t\treturn response;\n\t\t},\n\t\tonError: async ({ request, error }) => {\n\t\t\tclearRequestTimeout(request.signal);\n\t\t\tthrow error;\n\t\t}\n\t};\n}\n\n//#endregion\n//#region src/middleware/headers.ts\n/**\n* Header transformation and merging utilities for Commerce Engine SDKs\n*/\n/**\n* Merge two header objects\n* Method-level headers take precedence over default headers\n*\n* @param defaultHeaders - Default headers from SDK configuration\n* @param methodHeaders - Headers passed to the specific method call\n* @returns Merged headers object\n*/\nfunction mergeHeaders(defaultHeaders, methodHeaders) {\n\tconst merged = {};\n\tif (defaultHeaders) Object.assign(merged, defaultHeaders);\n\tif (methodHeaders) Object.assign(merged, methodHeaders);\n\tObject.keys(merged).forEach((key) => {\n\t\tif (merged[key] === void 0) delete merged[key];\n\t});\n\treturn merged;\n}\n/**\n* Transform headers using a transformation mapping\n* Headers not in the transformation map are passed through unchanged\n*\n* @param headers - Headers object with original names\n* @param transformations - Mapping of original names to transformed names\n* @returns Headers object with transformed names\n*/\nfunction transformHeaders(headers, transformations) {\n\tconst transformed = {};\n\tfor (const [key, value] of Object.entries(headers)) if (value !== void 0) {\n\t\tconst headerName = transformations[key] || key;\n\t\ttransformed[headerName] = value;\n\t}\n\treturn transformed;\n}\n/**\n* Merge headers with transformation support\n* Transforms default headers, then merges with method headers\n*\n* @param defaultHeaders - Default headers from SDK configuration\n* @param methodHeaders - Headers passed to the specific method call\n* @param transformations - Mapping for header name transformations\n* @returns Merged headers object with transformations applied\n*/\nfunction mergeAndTransformHeaders(defaultHeaders, methodHeaders, transformations) {\n\tconst merged = {};\n\tif (defaultHeaders && transformations) {\n\t\tconst transformedDefaults = transformHeaders(defaultHeaders, transformations);\n\t\tObject.assign(merged, transformedDefaults);\n\t} else if (defaultHeaders) Object.assign(merged, defaultHeaders);\n\tif (methodHeaders) Object.assign(merged, methodHeaders);\n\tObject.keys(merged).forEach((key) => {\n\t\tif (merged[key] === void 0) delete merged[key];\n\t});\n\treturn merged;\n}\n\n//#endregion\n//#region src/utils/response.ts\n/**\n* Execute a request and handle the response consistently\n* This provides unified error handling and response processing across all SDKs\n*\n* @param apiCall - Function that executes the API request\n* @returns Promise with the API response in standardized format\n*/\nasync function executeRequest(apiCall) {\n\ttry {\n\t\tconst { data, error, response } = await apiCall();\n\t\tif (error) return {\n\t\t\tdata: null,\n\t\t\terror,\n\t\t\tresponse\n\t\t};\n\t\tif (data && data.content !== void 0) return {\n\t\t\tdata: data.content,\n\t\t\terror: null,\n\t\t\tresponse\n\t\t};\n\t\treturn {\n\t\t\tdata,\n\t\t\terror: null,\n\t\t\tresponse\n\t\t};\n\t} catch (err) {\n\t\tconst mockResponse = new Response(null, {\n\t\t\tstatus: 503,\n\t\t\tstatusText: \"Service Unavailable\"\n\t\t});\n\t\treturn {\n\t\t\tdata: null,\n\t\t\terror: {\n\t\t\t\tsuccess: false,\n\t\t\t\tcode: \"NETWORK_ERROR\",\n\t\t\t\tmessage: \"Network error occurred\",\n\t\t\t\terror: err\n\t\t\t},\n\t\t\tresponse: mockResponse\n\t\t};\n\t}\n}\n\n//#endregion\n//#region src/base-client.ts\n/**\n* Base API client for Commerce Engine SDKs\n* Provides common functionality without token management\n*/\n/**\n* Generic base API client that all Commerce Engine SDKs can extend\n* Handles common functionality like middleware setup, request execution, and header management\n* Does NOT include token management - that's SDK-specific\n* \n* @template TPaths - OpenAPI paths type\n* @template THeaders - Supported default headers type\n*/\nvar BaseAPIClient = class {\n\tclient;\n\tconfig;\n\tbaseUrl;\n\theaderTransformations;\n\t/**\n\t* Create a new BaseAPIClient\n\t*\n\t* @param config - Configuration for the API client\n\t* @param baseUrl - The base URL for the API (must be provided by subclass)\n\t* @param headerTransformations - Header name transformations for this SDK\n\t*/\n\tconstructor(config, baseUrl, headerTransformations = {}) {\n\t\tthis.config = { ...config };\n\t\tthis.headerTransformations = headerTransformations;\n\t\tthis.baseUrl = baseUrl;\n\t\tthis.client = createClient({ baseUrl: this.baseUrl });\n\t\tthis.setupMiddleware();\n\t}\n\t/**\n\t* Set up all middleware for the client\n\t*/\n\tsetupMiddleware() {\n\t\tif (this.config.timeout) {\n\t\t\tconst timeoutMiddleware = createTimeoutMiddleware(this.config.timeout);\n\t\t\tthis.client.use(timeoutMiddleware);\n\t\t}\n\t\tif (this.config.debug) {\n\t\t\tconst debugMiddleware = createDebugMiddleware(this.config.logger);\n\t\t\tthis.client.use(debugMiddleware);\n\t\t}\n\t}\n\t/**\n\t* Get the base URL of the API\n\t*\n\t* @returns The base URL of the API\n\t*/\n\tgetBaseUrl() {\n\t\treturn this.baseUrl;\n\t}\n\t/**\n\t* Execute a request and handle the response consistently\n\t* This provides unified error handling and response processing\n\t*\n\t* @param apiCall - Function that executes the API request\n\t* @returns Promise with the API response in standardized format\n\t*/\n\tasync executeRequest(apiCall) {\n\t\treturn executeRequest(apiCall);\n\t}\n\t/**\n\t* Merge default headers with method-level headers\n\t* Method-level headers take precedence over default headers\n\t* Automatically applies SDK-specific header transformations\n\t*\n\t* @param methodHeaders - Headers passed to the specific method call\n\t* @returns Merged headers object with proper HTTP header names\n\t*/\n\tmergeHeaders(methodHeaders) {\n\t\treturn mergeAndTransformHeaders(this.config.defaultHeaders, methodHeaders, this.headerTransformations);\n\t}\n\t/**\n\t* Set default headers for the client\n\t*\n\t* @param headers - Default headers to set\n\t*/\n\tsetDefaultHeaders(headers) {\n\t\tthis.config.defaultHeaders = headers;\n\t}\n\t/**\n\t* Get current default headers\n\t*\n\t* @returns Current default headers\n\t*/\n\tgetDefaultHeaders() {\n\t\treturn this.config.defaultHeaders;\n\t}\n};\n\n//#endregion\n//#region src/utils/url.ts\n/**\n* Generic URL utility functions for any SDK\n*/\n/**\n* Extract pathname from URL\n* Useful for middleware that needs to inspect request paths\n*/\nfunction getPathnameFromUrl(url) {\n\ttry {\n\t\treturn new URL(url).pathname;\n\t} catch {\n\t\treturn url.split(\"?\")[0] || url;\n\t}\n}\n\n//#endregion\nexport { BaseAPIClient, DebugLogger, ResponseUtils, createDebugMiddleware, createTimeoutMiddleware, executeRequest, extractRequestBody, getPathnameFromUrl, mergeAndTransformHeaders, mergeHeaders, transformHeaders };","/**\n * Decode a JWT token payload without signature verification.\n * This is a lightweight replacement for jose's decodeJwt.\n *\n * @param token - The JWT token to decode\n * @returns The decoded payload\n * @throws Error if the token is malformed\n */\nfunction decodeJwt<T = Record<string, unknown>>(token: string): T {\n if (typeof token !== \"string\") {\n throw new Error(\"Invalid token: must be a string\");\n }\n\n const parts = token.split(\".\");\n if (parts.length !== 3) {\n throw new Error(\"Invalid token: must have 3 parts\");\n }\n\n const base64Url = parts[1];\n if (!base64Url) throw new Error(\"Invalid token: missing payload\");\n\n let base64 = base64Url.replace(/-/g, \"+\").replace(/_/g, \"/\");\n const padding = base64.length % 4;\n if (padding) base64 += \"=\".repeat(4 - padding);\n\n // UTF-8 safe decoding\n const binaryStr = atob(base64);\n const bytes = new Uint8Array(binaryStr.length);\n for (let i = 0; i < binaryStr.length; i++) {\n bytes[i] = binaryStr.charCodeAt(i);\n }\n\n const payload = JSON.parse(new TextDecoder().decode(bytes));\n if (typeof payload !== \"object\" || payload === null) {\n throw new Error(\"Invalid token: payload must be an object\");\n }\n\n return payload;\n}\n\n/**\n * JWT payload structure for POS tokens\n */\nexport interface JwtPayload {\n token_type: string;\n exp: number;\n iat: number;\n jti: string;\n ulid: string;\n username: string;\n email: string;\n phone: string;\n first_name: string;\n last_name: string;\n store_id: string;\n is_logged_in: boolean;\n roles: {\n role_id: string;\n role_name: string;\n location_id: string;\n location_name: string;\n }[];\n location: {\n id: string;\n name: string;\n };\n tenant_id: string;\n channel: {\n id: string;\n name: string;\n type: string;\n };\n sid: string;\n}\n\n/**\n * User information extracted from POS JWT token\n */\nexport interface UserInfo {\n id: string;\n username: string;\n email: string;\n phone: string;\n firstName: string;\n lastName: string;\n storeId: string;\n isLoggedIn: boolean;\n roles: {\n roleId: string;\n roleName: string;\n locationId: string;\n locationName: string;\n }[];\n location: {\n id: string;\n name: string;\n };\n tenantId: string;\n channel: {\n id: string;\n name: string;\n type: string;\n };\n sessionId: string;\n tokenExpiry: Date;\n tokenIssuedAt: Date;\n}\n\n/**\n * Decode and extract user information from a JWT token\n *\n * @param token - The JWT token to decode\n * @returns User information or null if token is invalid\n */\nexport function extractUserInfoFromToken(token: string): UserInfo | null {\n try {\n const payload = decodeJwt(token) as JwtPayload;\n\n return {\n id: payload.ulid,\n username: payload.username,\n email: payload.email,\n phone: payload.phone,\n firstName: payload.first_name,\n lastName: payload.last_name,\n storeId: payload.store_id,\n isLoggedIn: payload.is_logged_in,\n roles: payload.roles.map(role => ({\n roleId: role.role_id,\n roleName: role.role_name,\n locationId: role.location_id,\n locationName: role.location_name,\n })),\n location: {\n id: payload.location.id,\n name: payload.location.name,\n },\n tenantId: payload.tenant_id,\n channel: {\n id: payload.channel.id,\n name: payload.channel.name,\n type: payload.channel.type,\n },\n sessionId: payload.sid,\n tokenExpiry: new Date(payload.exp * 1000),\n tokenIssuedAt: new Date(payload.iat * 1000),\n };\n } catch (error) {\n console.warn(\"Failed to decode JWT token:\", error);\n return null;\n }\n}\n\n/**\n * Check if a JWT token is expired\n *\n * @param token - The JWT token to check\n * @param bufferSeconds - Buffer time in seconds (default: 30)\n * @returns True if token is expired or will expire within buffer time\n */\nexport function isTokenExpired(\n token: string,\n bufferSeconds: number = 30\n): boolean {\n try {\n const payload = decodeJwt<{ exp?: number }>(token);\n if (!payload.exp) return true;\n\n const currentTime = Math.floor(Date.now() / 1000);\n const expiryTime = payload.exp;\n\n // Consider token expired if it expires within the buffer time\n return currentTime >= expiryTime - bufferSeconds;\n } catch (error) {\n console.warn(\"Failed to decode JWT token:\", error);\n return true; // Treat invalid tokens as expired\n }\n}\n\n/**\n * Get the user ID from a JWT token\n *\n * @param token - The JWT token\n * @returns User ID (ulid) or null if token is invalid\n */\nexport function getUserIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.id || null;\n}\n\n/**\n * Check if user is logged in based on JWT token\n *\n * @param token - The JWT token\n * @returns True if user is logged in, false otherwise\n */\nexport function isUserLoggedIn(token: string): boolean {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.isLoggedIn || false;\n}\n\n/**\n * Check if user is authenticated (has valid POS token)\n * Checks the token for isLoggedIn status\n *\n * @param token - The JWT token\n * @returns True if user is authenticated with valid POS access\n */\nexport function isUserAuthenticated(token: string): boolean {\n const userInfo = extractUserInfoFromToken(token);\n return !!userInfo?.isLoggedIn;\n}\n\n\n/**\n * Get the location ID from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Location ID or null if token is invalid\n */\nexport function getLocationIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.location?.id || null;\n}\n\n/**\n * Get the role information from a POS JWT token for the current location\n *\n * @param token - The JWT token\n * @returns Role object for the current location, or null if token is invalid\n */\nexport function getRoleFromToken(token: string): {\n roleId: string;\n roleName: string;\n locationId: string;\n locationName: string;\n} | null {\n const userInfo = extractUserInfoFromToken(token);\n if (!userInfo?.roles || userInfo.roles.length === 0) return null;\n\n // Find role for current location, or return first role if location match not found\n const currentLocationRole = userInfo.roles.find(role => role.locationId === userInfo.location.id);\n return currentLocationRole || userInfo.roles[0] || null;\n}\n\n/**\n * Get the tenant ID from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Tenant ID or null if token is invalid\n */\nexport function getTenantIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.tenantId || null;\n}\n\n/**\n * Get the channel information from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Channel object with id, name, and type, or null if token is invalid\n */\nexport function getChannelFromToken(token: string): {\n id: string;\n name: string;\n type: string;\n} | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.channel || null;\n}\n\n/**\n * Get the session ID from a POS JWT token\n *\n * @param token - The JWT token\n * @returns Session ID or null if token is invalid\n */\nexport function getSessionIdFromToken(token: string): string | null {\n const userInfo = extractUserInfoFromToken(token);\n return userInfo?.sessionId || null;\n}\n","/**\n * Check if a URL path is a POS login endpoint that should use API key\n * Based on POS spec, only these 5 endpoints use X-Api-Key:\n * - /pos/auth/login/email\n * - /pos/auth/login/phone\n * - /pos/auth/login/whatsapp\n * - /pos/auth/pair-device\n * - /pos/auth/verify-otp\n */\nexport function isApiKeyEndpoint(pathname: string): boolean {\n const apiKeyEndpoints = [\n \"/pos/auth/login/email\",\n \"/pos/auth/login/phone\",\n \"/pos/auth/login/whatsapp\",\n \"/pos/auth/pair-device\",\n \"/pos/auth/verify-otp\",\n \"/pos/locations\",\n ];\n return apiKeyEndpoints.some((endpoint) => pathname.includes(endpoint));\n}\n\n/**\n * Check if a URL path is a POS endpoint that returns tokens\n * Based on POS spec, only these endpoints return tokens:\n * - /pos/auth/verify-otp (after OTP verification)\n * - /pos/auth/refresh-token\n */\nexport function isTokenReturningEndpoint(pathname: string): boolean {\n const tokenEndpoints = [\"/pos/auth/verify-otp\", \"/pos/auth/refresh-token\"];\n return tokenEndpoints.some((endpoint) => pathname.includes(endpoint));\n}\n\n/**\n * Check if a URL path is a POS logout endpoint\n */\nexport function isLogoutEndpoint(pathname: string): boolean {\n return (\n pathname.includes(\"/pos/auth/logout\") || pathname.includes(\"/pos/logout\")\n );\n}\n\n// Re-export JWT utilities from jwt.ts\nexport {\n isTokenExpired,\n extractUserInfoFromToken,\n getUserIdFromToken,\n isUserLoggedIn,\n isUserAuthenticated,\n getLocationIdFromToken,\n getRoleFromToken,\n getTenantIdFromToken,\n} from \"./jwt\";\nexport type { UserInfo, JwtPayload } from \"./jwt\";\n","import type { Middleware } from \"openapi-fetch\";\nimport { getPathnameFromUrl } from \"@commercengine/sdk-core\";\nimport {\n isApiKeyEndpoint,\n isTokenReturningEndpoint,\n isLogoutEndpoint,\n isTokenExpired,\n} from \"../utils/auth\";\n\n/**\n * Token storage interface for the POS auth middleware\n */\nexport interface TokenStorage {\n getAccessToken(): Promise<string | null>;\n setAccessToken(token: string): Promise<void>;\n getRefreshToken(): Promise<string | null>;\n setRefreshToken(token: string): Promise<void>;\n clearTokens(): Promise<void>;\n}\n\n/**\n * Simple in-memory token storage implementation\n */\nexport class MemoryTokenStorage implements TokenStorage {\n private accessToken: string | null = null;\n private refreshToken: string | null = null;\n\n async getAccessToken(): Promise<string | null> {\n return this.accessToken;\n }\n\n async setAccessToken(token: string): Promise<void> {\n this.accessToken = token;\n }\n\n async getRefreshToken(): Promise<string | null> {\n return this.refreshToken;\n }\n\n async setRefreshToken(token: string): Promise<void> {\n this.refreshToken = token;\n }\n\n async clearTokens(): Promise<void> {\n this.accessToken = null;\n this.refreshToken = null;\n }\n}\n\n/**\n * Browser localStorage token storage implementation for POS\n */\nexport class BrowserTokenStorage implements TokenStorage {\n private accessTokenKey: string;\n private refreshTokenKey: string;\n\n constructor(prefix: string = \"pos_\") {\n this.accessTokenKey = `${prefix}access_token`;\n this.refreshTokenKey = `${prefix}refresh_token`;\n }\n\n async getAccessToken(): Promise<string | null> {\n if (typeof localStorage === \"undefined\") return null;\n return localStorage.getItem(this.accessTokenKey);\n }\n\n async setAccessToken(token: string): Promise<void> {\n if (typeof localStorage !== \"undefined\") {\n localStorage.setItem(this.accessTokenKey, token);\n }\n }\n\n async getRefreshToken(): Promise<string | null> {\n if (typeof localStorage === \"undefined\") return null;\n return localStorage.getItem(this.refreshTokenKey);\n }\n\n async setRefreshToken(token: string): Promise<void> {\n if (typeof localStorage !== \"undefined\") {\n localStorage.setItem(this.refreshTokenKey, token);\n }\n }\n\n async clearTokens(): Promise<void> {\n if (typeof localStorage !== \"undefined\") {\n localStorage.removeItem(this.accessTokenKey);\n localStorage.removeItem(this.refreshTokenKey);\n }\n }\n}\n\n/**\n * Configuration for the POS auth middleware\n */\nexport interface PosAuthMiddlewareConfig {\n /**\n * Token storage implementation\n */\n tokenStorage: TokenStorage;\n\n /**\n * API key for X-Api-Key endpoints (login, pair-device, verify-otp)\n * Required for POS authentication flows and fallback scenarios\n */\n apiKey: string;\n\n /**\n * Base URL for the API (used for refresh token endpoint)\n */\n baseUrl: string;\n\n /**\n * Function to refresh tokens\n * Should make a call to the POS refresh token endpoint\n */\n refreshTokenFn?: (refreshToken: string) => Promise<{\n access_token: string;\n refresh_token: string;\n }>;\n\n /**\n * Callback when tokens are updated (login/refresh)\n */\n onTokensUpdated?: (accessToken: string, refreshToken: string) => void;\n\n /**\n * Callback when tokens are cleared (logout/error)\n */\n onTokensCleared?: () => void;\n}\n\n/**\n * Create POS authentication middleware for openapi-fetch\n *\n * POS Authentication Rules:\n * 1. API Key endpoints (X-Api-Key): login/email, login/phone, login/whatsapp, pair-device, verify-otp\n * 2. Bearer token endpoints: All other endpoints\n * 3. Token returning endpoints: verify-otp, refresh-token\n */\nexport function createPosAuthMiddleware(\n config: PosAuthMiddlewareConfig\n): Middleware {\n let isRefreshing = false;\n let refreshPromise: Promise<void> | null = null;\n let hasAssessedTokens = false;\n\n const assessTokenStateOnce = async (): Promise<void> => {\n // Skip if already assessed (tokenStorage is guaranteed to exist when middleware is created)\n if (hasAssessedTokens) return;\n\n hasAssessedTokens = true;\n\n try {\n const accessToken = await config.tokenStorage.getAccessToken();\n const refreshToken = await config.tokenStorage.getRefreshToken();\n\n // Case 1: Valid access token - do nothing\n if (accessToken && !isTokenExpired(accessToken)) {\n return;\n }\n\n // Case 2: Orphaned refresh token (no access token but refresh token exists)\n if (!accessToken && refreshToken) {\n // Clean up orphaned refresh token to prevent confusion\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\"Cleaned up orphaned refresh token in POS\");\n return;\n }\n\n // Case 3: Expired access token with valid refresh token\n if (accessToken && refreshToken && !isTokenExpired(refreshToken)) {\n try {\n await refreshTokens();\n console.info(\"POS tokens refreshed proactively on startup\");\n } catch (error) {\n // Refresh failed - both tokens are likely invalid, clear them\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\"POS tokens cleared after failed refresh on startup\");\n }\n return;\n }\n\n // Case 4: Both tokens expired or invalid - clear stale tokens\n if (\n (accessToken && isTokenExpired(accessToken)) ||\n (refreshToken && isTokenExpired(refreshToken))\n ) {\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\n \"POS stale tokens cleared on startup - user needs to re-authenticate\"\n );\n return;\n }\n\n // Case 5: No tokens at all - valid unauthenticated state\n if (!accessToken && !refreshToken) {\n // This is normal - user hasn't logged in or has logged out\n // No action needed, POS will work with API key endpoints\n return;\n }\n\n // Note: Unlike storefront, POS doesn't have anonymous fallback\n // Users must explicitly authenticate through login endpoints\n } catch (error) {\n // Silent fail - don't break the request flow\n console.warn(\"POS token state assessment failed:\", error);\n }\n };\n\n const refreshTokens = async (): Promise<void> => {\n if (isRefreshing && refreshPromise) {\n return refreshPromise;\n }\n\n isRefreshing = true;\n refreshPromise = (async () => {\n try {\n const refreshToken = await config.tokenStorage.getRefreshToken();\n\n if (!refreshToken || isTokenExpired(refreshToken)) {\n throw new Error(\"No valid refresh token available\");\n }\n\n let newTokens: { access_token: string; refresh_token: string };\n\n if (config.refreshTokenFn) {\n // Use provided refresh function\n newTokens = await config.refreshTokenFn(refreshToken);\n } else {\n // Default refresh implementation for POS\n const response = await fetch(\n `${config.baseUrl}/pos/auth/refresh-token`,\n {\n method: \"POST\",\n headers: {\n \"Content-Type\": \"application/json\",\n Authorization: `Bearer ${await config.tokenStorage.getAccessToken()}`,\n },\n body: JSON.stringify({ refresh_token: refreshToken }),\n }\n );\n\n if (!response.ok) {\n throw new Error(`POS token refresh failed: ${response.status}`);\n }\n\n const data = await response.json();\n newTokens = data.content || data;\n }\n\n // Store new tokens\n await config.tokenStorage.setAccessToken(newTokens.access_token);\n await config.tokenStorage.setRefreshToken(newTokens.refresh_token);\n\n // Notify callback\n config.onTokensUpdated?.(\n newTokens.access_token,\n newTokens.refresh_token\n );\n } catch (error) {\n console.error(\"POS token refresh failed:\", error);\n // Clear tokens on refresh failure\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n throw error;\n } finally {\n isRefreshing = false;\n refreshPromise = null;\n }\n })();\n\n return refreshPromise;\n };\n\n return {\n async onRequest({ request }) {\n const pathname = getPathnameFromUrl(request.url);\n\n // Assess token state once per middleware instance (POS session start)\n await assessTokenStateOnce();\n\n // Handle API Key endpoints (5 specific endpoints only)\n if (isApiKeyEndpoint(pathname)) {\n request.headers.set(\"X-Api-Key\", config.apiKey);\n return request;\n }\n\n // For all other endpoints, use Bearer token\n let accessToken = await config.tokenStorage.getAccessToken();\n\n // Check if token needs refresh\n if (accessToken && isTokenExpired(accessToken)) {\n try {\n await refreshTokens();\n accessToken = await config.tokenStorage.getAccessToken();\n } catch (error) {\n // If refresh fails, continue without token (will get 401)\n console.warn(\"Token refresh failed:\", error);\n accessToken = null;\n }\n }\n\n // Add Authorization header if we have a token\n if (accessToken) {\n request.headers.set(\"Authorization\", `Bearer ${accessToken}`);\n }\n\n return request;\n },\n\n async onResponse({ request, response }) {\n const pathname = getPathnameFromUrl(request.url);\n\n // Handle successful responses that return tokens (verify-otp, refresh-token)\n if (response.ok && isTokenReturningEndpoint(pathname)) {\n try {\n const data = await response.clone().json();\n const content = data.content || data;\n\n if (content?.access_token && content?.refresh_token) {\n await config.tokenStorage.setAccessToken(content.access_token);\n await config.tokenStorage.setRefreshToken(content.refresh_token);\n config.onTokensUpdated?.(\n content.access_token,\n content.refresh_token\n );\n }\n } catch (error) {\n console.warn(\"Failed to extract tokens from POS response:\", error);\n }\n } else if (response.ok && isLogoutEndpoint(pathname)) {\n // Clear tokens on successful logout\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n }\n\n // Handle 401 responses - retry once if token was expired\n if (response.status === 401 && !isApiKeyEndpoint(pathname)) {\n const currentToken = await config.tokenStorage.getAccessToken();\n\n // Only attempt refresh if we have a token and it's expired\n if (currentToken && isTokenExpired(currentToken, 0)) {\n try {\n await refreshTokens();\n\n // Retry the original request with new token\n const newToken = await config.tokenStorage.getAccessToken();\n if (newToken) {\n const retryRequest = request.clone();\n retryRequest.headers.set(\"Authorization\", `Bearer ${newToken}`);\n return fetch(retryRequest);\n }\n } catch (error) {\n // If refresh fails, let the original 401 response through\n console.warn(\"POS token refresh failed on 401 response:\", error);\n }\n }\n }\n\n // Handle 403 responses - token is blacklisted/revoked, clear all tokens\n if (response.status === 403 && !isApiKeyEndpoint(pathname)) {\n await config.tokenStorage.clearTokens();\n config.onTokensCleared?.();\n console.info(\n \"POS tokens cleared due to 403 - session revoked. This can happen when a user has more than 5 active sessions. Please re-authenticate.\"\n );\n }\n\n return response;\n },\n };\n}\n\n/**\n * Helper function to create POS auth middleware with sensible defaults\n */\nexport function createDefaultPosAuthMiddleware(options: {\n apiKey: string;\n baseUrl: string;\n tokenStorage?: TokenStorage;\n onTokensUpdated?: (accessToken: string, refreshToken: string) => void;\n onTokensCleared?: () => void;\n}): Middleware {\n const tokenStorage =\n options.tokenStorage ||\n (typeof localStorage !== \"undefined\"\n ? new BrowserTokenStorage()\n : new MemoryTokenStorage());\n\n return createPosAuthMiddleware({\n tokenStorage,\n apiKey: options.apiKey,\n baseUrl: options.baseUrl,\n onTokensUpdated: options.onTokensUpdated,\n onTokensCleared: options.onTokensCleared,\n });\n}\n","/**\n * Environment configuration for POS API\n */\nexport enum Environment {\n Development = \"dev\",\n Staging = \"staging\",\n Production = \"production\",\n}\n\n/**\n * Configuration for building POS API URLs\n */\nexport interface PosURLConfig {\n storeId: string;\n environment?: Environment;\n baseUrl?: string;\n}\n\n/**\n * Build the base URL for POS API requests\n *\n * @param config - URL configuration\n * @returns The base URL for POS API requests\n */\nexport function buildPosURL(config: PosURLConfig): string {\n // If custom baseUrl is provided, use it directly\n if (config.baseUrl) {\n return config.baseUrl.replace(/\\/$/, \"\"); // Remove trailing slash\n }\n\n // Build URL based on environment and store ID\n const env = config.environment || Environment.Production;\n\n switch (env) {\n case Environment.Staging:\n return `https://staging.api.commercengine.io/api/v1/${config.storeId}/storefront`;\n case Environment.Production:\n default:\n return `https://prod.api.commercengine.io/api/v1/${config.storeId}/storefront`;\n }\n}\n","import type { paths } from \"../types/pos\";\nimport type { paths as AdminPaths } from \"../types/admin-pos\";\nimport { BaseAPIClient, getPathnameFromUrl } from \"@commercengine/sdk-core\";\nimport { createDefaultPosAuthMiddleware } from \"./middleware/auth\";\nimport { isApiKeyEndpoint } from \"./utils/auth\";\nimport { buildPosURL } from \"./utils/url\";\nimport type { PosSDKOptions, SupportedDefaultHeaders } from \"../index\";\n\ntype CombinedPaths = paths & AdminPaths;\n\n/**\n * POS API client that extends the generic BaseAPIClient\n * Adds Commerce Engine POS specific authentication and token management\n */\nexport class PosAPIClient extends BaseAPIClient<\n CombinedPaths,\n SupportedDefaultHeaders\n> {\n protected config: PosSDKOptions;\n private initializationPromise: Promise<void> | null = null;\n\n /**\n * Validate required configuration parameters\n * @param config - Configuration to validate\n * @throws Error with descriptive message if validation fails\n */\n private static validateConfig(config: PosSDKOptions): void {\n const errors: string[] = [];\n\n // Required fields validation\n if (!config.storeId?.trim()) {\n errors.push(\"storeId is required and cannot be empty\");\n }\n\n if (!config.apiKey?.trim()) {\n errors.push(\n \"apiKey is required for POS authentication (needed for login, device pairing, and token refresh fallbacks)\"\n );\n }\n\n // Token configuration validation\n if (config.accessToken && !config.tokenStorage && !config.refreshToken) {\n errors.push(\n \"When providing accessToken without tokenStorage, consider providing refreshToken for token refresh capability\"\n );\n }\n\n if (config.refreshToken && !config.accessToken) {\n errors.push(\n \"refreshToken cannot be provided without accessToken (orphaned refresh token)\"\n );\n }\n\n if (config.refreshToken && !config.tokenStorage) {\n errors.push(\n \"refreshToken requires tokenStorage for automatic token management\"\n );\n }\n\n // Callback validation\n if (\n (config.onTokensUpdated || config.onTokensCleared) &&\n !config.tokenStorage\n ) {\n errors.push(\n \"Token callbacks (onTokensUpdated/onTokensCleared) require tokenStorage for automatic token management\"\n );\n }\n\n // URL validation\n if (config.baseUrl && !PosAPIClient.isValidUrl(config.baseUrl)) {\n errors.push(\"baseUrl must be a valid HTTP/HTTPS URL\");\n }\n\n if (errors.length > 0) {\n throw new Error(\n `POS SDK configuration validation failed:\\n- ${errors.join(\"\\n- \")}`\n );\n }\n }\n\n /**\n * Check if a string is a valid URL\n * @param url - URL string to validate\n * @returns True if valid URL\n */\n private static isValidUrl(url: string): boolean {\n try {\n const parsed = new URL(url);\n return parsed.protocol === \"http:\" || parsed.protocol === \"https:\";\n } catch {\n return false;\n }\n }\n\n /**\n * Create a new PosAPIClient\n *\n * @param config - Configuration for the API client\n */\n constructor(config: PosSDKOptions) {\n // Validate required configuration first (before calling super)\n PosAPIClient.validateConfig(config);\n\n // Build base URL from Commerce Engine config\n const baseUrl = buildPosURL({\n storeId: config.storeId,\n environment: config.environment,\n baseUrl: config.baseUrl,\n });\n\n // Header transformations for POS API\n const headerTransformations = {\n customer_group_id: \"x-customer-group-id\",\n debug_mode: \"x-debug-mode\",\n // Add any other header transformations here\n } as Record<keyof SupportedDefaultHeaders, string>;\n\n // Call parent constructor with generic config\n super(\n {\n baseUrl: baseUrl,\n timeout: config.timeout,\n defaultHeaders: config.defaultHeaders,\n debug: config.debug,\n logger: config.logger,\n },\n baseUrl,\n headerTransformations\n );\n\n // Store full config for POS-specific features\n this.config = { ...config };\n\n // Set up POS-specific auth middleware\n this.setupPosAuth();\n }\n\n /**\n * Set up POS-specific authentication middleware\n */\n private setupPosAuth(): void {\n const config = this.config as PosSDKOptions;\n\n // Set up auth middleware if token storage is provided\n if (config.tokenStorage) {\n const authMiddleware = createDefaultPosAuthMiddleware({\n apiKey: config.apiKey,\n baseUrl: this.getBaseUrl(),\n tokenStorage: config.tokenStorage,\n onTokensUpdated: config.onTokensUpdated,\n onTokensCleared: config.onTokensCleared,\n });\n this.client.use(authMiddleware);\n\n // If initial tokens were provided, store them in tokenStorage\n if (config.accessToken) {\n this.initializationPromise = this.initializeTokens(\n config.accessToken,\n config.refreshToken\n );\n // Clear the manual tokens since we're using storage\n config.accessToken = undefined;\n config.refreshToken = undefined;\n }\n } else {\n // For manual token management, add simple header injection middleware\n this.client.use({\n onRequest: async ({ request }) => {\n const pathname = getPathnameFromUrl(request.url);\n\n // For login endpoints, use API key\n if (isApiKeyEndpoint(pathname)) {\n request.headers.set(\"X-Api-Key\", config.apiKey);\n return request;\n }\n\n // For all other endpoints, prefer access token, fallback to API key\n if (config.accessToken) {\n request.headers.set(\n \"Authorization\",\n `Bearer ${config.accessToken}`\n );\n } else if (config.apiKey) {\n request.headers.set(\"X-Api-Key\", config.apiKey);\n }\n\n return request;\n },\n });\n }\n }\n\n /**\n * Get the authorization header value\n * If using token storage, gets the current token from storage\n * Otherwise returns the manual token\n *\n * @returns The Authorization header value or empty string if no token is set\n */\n public async getAuthorizationHeader(): Promise<string> {\n // Wait for initialization to complete if using token storage\n if (this.config.tokenStorage && this.initializationPromise) {\n await this.initializationPromise;\n }\n\n if (this.config.tokenStorage) {\n const token = await this.config.tokenStorage.getAccessToken();\n return token ? `Bearer ${token}` : \"\";\n }\n return this.config.accessToken ? `Bearer ${this.config.accessToken}` : \"\";\n }\n\n /**\n * Set authentication tokens\n *\n * @param accessToken - The access token (required)\n * @param refreshToken - The refresh token (optional)\n *\n * Behavior:\n * - If tokenStorage is provided: Stores tokens for automatic management\n * - If tokenStorage is not provided: Only stores access token for manual management\n */\n public async setTokens(\n accessToken: string,\n refreshToken?: string\n ): Promise<void> {\n if (this.config.tokenStorage) {\n // Automatic token management\n await this.config.tokenStorage.setAccessToken(accessToken);\n if (refreshToken) {\n await this.config.tokenStorage.setRefreshToken(refreshToken);\n }\n } else {\n // Manual token management - only access token\n this.config.accessToken = accessToken;\n if (refreshToken) {\n console.warn(\n \"Refresh token provided but ignored in manual token management mode. Use tokenStorage for automatic management.\"\n );\n }\n }\n }\n\n /**\n * Clear all authentication tokens\n *\n * Behavior:\n * - If tokenStorage is provided: Clears both access and refresh tokens from storage\n * - If tokenStorage is not provided: Clears the manual access token\n */\n public async clearTokens(): Promise<void> {\n if (this.config.tokenStorage) {\n await this.config.tokenStorage.clearTokens();\n } else {\n this.config.accessToken = undefined;\n }\n }\n\n /**\n * Set the X-Api-Key header\n *\n * @param apiKey - The API key to set\n */\n public setApiKey(apiKey: string): void {\n this.config.apiKey = apiKey;\n }\n\n /**\n * Initialize tokens in storage (private helper method)\n */\n private async initializeTokens(\n accessToken: string,\n refreshToken?: string\n ): Promise<void> {\n try {\n if (this.config.tokenStorage) {\n await this.config.tokenStorage.setAccessToken(accessToken);\n if (refreshToken) {\n await this.config.tokenStorage.setRefreshToken(refreshToken);\n }\n }\n } catch (error) {\n console.warn(\"Failed to initialize tokens in storage:\", error);\n }\n }\n\n /**\n * Get client typed for storefront POS operations (paths schema)\n * This provides proper typing for storefront POS endpoints\n */\n public get storefrontClient() {\n return this.client as BaseAPIClient<\n paths,\n SupportedDefaultHeaders\n >[\"client\"];\n }\n\n /**\n * Get client typed for admin POS operations (AdminPaths schema)\n * This provides proper typing for admin POS endpoints\n */\n public get adminClient() {\n return this.client as BaseAPIClient<\n AdminPaths,\n SupportedDefaultHeaders\n >[\"client\"];\n }\n}\n","import { PosAPIClient } from \"./client\";\nimport type { ApiResult } from \"@commercengine/sdk-core\";\nimport type {\n // Auth types\n LoginPosDeviceWithEmailBody,\n LoginPosDeviceWithEmailContent,\n LoginPosDeviceWithPhoneBody,\n LoginPosDeviceWithPhoneContent,\n LoginPosDeviceWithWhatsappBody,\n LoginPosDeviceWithWhatsappContent,\n PairPosDeviceContent,\n RefreshPosAccessTokenBody,\n RefreshPosAccessTokenContent,\n VerifyPosLoginOtpBody,\n VerifyPosLoginOtpContent,\n LogoutFromPosDeviceResponse,\n\n // Devices\n PairPosDeviceBody,\n ListPosDevicesContent,\n ClaimPosDevicePathParams,\n UnclaimPosDevicePathParams,\n ClaimPosDeviceResponse,\n UnclaimPosDeviceResponse,\n\n // Cart types\n PosCreateCartBody,\n PosCreateCartContent,\n PosGetCartPathParams,\n PosGetCartContent,\n PosDeleteCartPathParams,\n PosDeleteCartResponse,\n PosUpdateCartPathParams,\n PosUpdateCartBody,\n PosUpdateCartContent,\n PosGetUserCartPathParams,\n PosGetUserCartContent,\n\n // Cart address\n PosCreateCartAddressPathParams,\n PosCreateCartAddressBody,\n PosCreateCartAddressContent,\n\n // Coupons\n PosListCouponsContent,\n PosListCouponsHeaderParams,\n PosApplyCouponPathParams,\n PosApplyCouponBody,\n PosApplyCouponContent,\n PosRemoveCouponPathParams,\n PosRemoveCouponContent,\n PosEvaluateCouponsPathParams,\n PosEvaluateCouponsContent,\n\n // Promotions\n PosListPromotionsContent,\n PosListPromotionsHeaderParams,\n PosEvaluatePromotionsPathParams,\n PosEvaluatePromotionsContent,\n\n // Credit balance\n PosRedeemCreditBalancePathParams,\n PosRedeemCreditBalanceBody,\n PosRedeemCreditBalanceContent,\n PosRemoveCreditBalancePathParams,\n PosRemoveCreditBalanceContent,\n\n // Loyalty points\n PosRedeemLoyaltyPointsPathParams,\n PosRedeemLoyaltyPointsBody,\n PosRedeemLoyaltyPointsContent,\n PosRemoveLoyaltyPointsPathParams,\n PosRemoveLoyaltyPointsContent,\n\n // Fulfillment\n PosUpdateFulfillmentPreferencePathParams,\n PosUpdateFulfillmentPreferenceBody,\n PosUpdateFulfillmentPreferenceResponse,\n GetPosFulfillmentOptionsBody,\n GetPosFulfillmentOptionsContent,\n\n // Customer\n UpdatePosCartCustomerPathParams,\n UpdatePosCartCustomerBody,\n UpdatePosCartCustomerContent,\n\n // Orders\n CreatePosOrderBody,\n CreatePosOrderContent,\n\n // Payment\n PosGetPaymentStatusContent,\n PosGetPaymentStatusPathParams,\n\n // Catalog types\n PosListCategoriesContent,\n PosListCategoriesQuery,\n PosListProductsContent,\n PosListProductsQuery,\n PosListProductsHeaderParams,\n PosListCrosssellProductsContent,\n PosListCrosssellProductsQuery,\n PosListCrosssellProductsHeaderParams,\n PosSearchProductsBody,\n PosSearchProductsContent,\n PosSearchProductsHeaderParams,\n PosListSimilarProductsContent,\n PosListSimilarProductsQuery,\n PosListSimilarProductsHeaderParams,\n PosListUpsellProductsContent,\n PosListUpsellProductsQuery,\n PosListUpsellProductsHeaderParams,\n PosGetProductDetailPathParams,\n PosGetProductDetailQuery,\n PosGetProductDetailContent,\n PosGetProductDetailHeaderParams,\n PosListProductReviewsPathParams,\n PosListProductReviewsContent,\n PosListProductReviewsQuery,\n PosListProductVariantsPathParams,\n PosListProductVariantsQuery,\n PosListProductVariantsContent,\n PosListProductVariantsHeaderParams,\n PosGetVariantDetailPathParams,\n PosGetVariantDetailQuery,\n PosGetVariantDetailContent,\n PosGetVariantDetailHeaderParams,\n PosListSkusContent,\n PosListSkusQuery,\n PosListSkusHeaderParams,\n ListPosLocationsContent,\n GetPosUserPathParams,\n GetPosUserContent,\n UnclaimPosDeviceContent,\n ClaimPosDeviceContent,\n LoginPosDeviceWithEmailHeaderParams,\n LoginPosDeviceWithPhoneHeaderParams,\n LoginPosDeviceWithWhatsappHeaderParams,\n PosUpdateFulfillmentPreferenceContent,\n} from \"../types/pos-api-types\";\nimport type {\n // Admin Inventory types\n PosListInventoryContent,\n PosListInventoryQuery,\n PosListInventoryActivityContent,\n PosListInventoryActivityQuery,\n PosListInventoryDetailContent,\n PosListInventoryDetailQuery,\n\n // Admin Customer types\n PosListCustomersContent,\n PosListCustomersQuery,\n PosGetCustomerDetailContent,\n PosGetCustomerDetailPathParams,\n\n // Admin Order types\n PosListOrdersContent,\n PosListOrdersQuery,\n PosGetOrderDetailContent,\n PosGetOrderDetailPathParams,\n PosListOrderActivityContent,\n PosListOrderActivityPathParams,\n PosGetOrderInvoiceContent,\n PosGetOrderInvoiceQuery,\n PosGetOrderInvoicePathParams,\n PosGetOrderReceiptContent,\n PosGetOrderReceiptQuery,\n PosGetOrderReceiptPathParams,\n PosListOrderShipmentsContent,\n PosListOrderShipmentsPathParams,\n\n // Admin Shipment types\n PosListShipmentsContent,\n PosListShipmentsQuery,\n PosCheckOrderInventoryContent,\n PosCheckOrderInventoryPathParams,\n PosRefundShortfallResponse,\n PosRefundShortfallPathParams,\n PosRefundShortfallBody,\n PosGetShipmentDetailContent,\n PosGetShipmentDetailPathParams,\n PosGetShipmentInvoiceContent,\n PosGetShipmentInvoiceQuery,\n PosGetShipmentInvoicePathParams,\n PosUpdateShipmentContent,\n PosUpdateShipmentPathParams,\n PosUpdateShipmentBody,\n} from \"../types/admin-pos-api-types\";\n\n/**\n * Client for interacting with POS endpoints\n * Single client that handles all POS operations including auth, cart, orders, etc.\n */\nexport class PosClient extends PosAPIClient {\n // ===============================\n // AUTHENTICATION ENDPOINTS\n // ===============================\n\n /**\n * Login with email address\n * @param body - Login credentials containing location ID and email\n * @returns Promise with OTP token and action\n * @example\n * ```typescript\n * const { data, error } = await pos.loginWithEmail({\n * location_id: \"pos-location-123\",\n * email: \"staff@example.com\"\n * });\n *\n * if (error) {\n * console.error(\"Login failed:\", error.message);\n * } else {\n * console.log(\"OTP sent:\", data.otp_token);\n * console.log(\"Action:\", data.otp_action);\n * // Use the otp_token to verify OTP\n * }\n * ```\n */\n public async loginWithEmail(\n body: LoginPosDeviceWithEmailBody,\n headers?: LoginPosDeviceWithEmailHeaderParams\n ): Promise<ApiResult<LoginPosDeviceWithEmailContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/login/email\", {\n body: body,\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Login with phone number\n * @param body - Login credentials containing location ID and phone\n * @returns Promise with OTP token and action\n * @example\n * ```typescript\n * const { data, error } = await pos.loginWithPhone({\n * location_id: \"pos-location-123\",\n * phone: \"234567890\",\n * country_code: \"+91\" // default is +91\n * });\n *\n * if (error) {\n * console.error(\"Login failed:\", error.message);\n * } else {\n * console.log(\"OTP sent:\", data.otp_token);\n * console.log(\"Action:\", data.otp_action);\n * // Use the otp_token to verify OTP\n * }\n * ```\n */\n public async loginWithPhone(\n body: LoginPosDeviceWithPhoneBody,\n headers?: LoginPosDeviceWithPhoneHeaderParams\n ): Promise<ApiResult<LoginPosDeviceWithPhoneContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/login/phone\", {\n body,\n params: { header: mergedHeaders },\n })\n );\n }\n\n /**\n * Login with WhatsApp\n * @param body - Login credentials containing location ID and phone\n * @returns Promise with OTP token and action\n * @example\n * ```typescript\n * const { data, error } = await pos.loginWithWhatsapp({\n * location_id: \"pos-location-123\",\n * phone: \"234567890\",\n * country_code: \"+91\" // default is +91\n * });\n *\n * if (error) {\n * console.error(\"WhatsApp login failed:\", error.message);\n * } else {\n * console.log(\"WhatsApp OTP sent:\", data.otp_token);\n * console.log(\"Action:\", data.otp_action);\n * // Use the otp_token to verify OTP\n * }\n * ```\n */\n public async loginWithWhatsapp(\n body: LoginPosDeviceWithWhatsappBody,\n headers?: LoginPosDeviceWithWhatsappHeaderParams\n ): Promise<ApiResult<LoginPosDeviceWithWhatsappContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/login/whatsapp\", {\n body,\n params: { header: mergedHeaders },\n })\n );\n }\n\n /**\n * Verify OTP\n * @param body - OTP verification data\n * @returns Promise with user info and tokens\n * @example\n * ```typescript\n * const { data, error } = await pos.verifyOtp({\n * otp_token: \"otp-token-from-login\",\n * otp: \"123456\",\n * otp_action: \"login\"\n * });\n *\n * if (error) {\n * console.error(\"OTP verification failed:\", error.message);\n * } else {\n * console.log(\"Login successful:\", data.user);\n * console.log(\"Access token:\", data.access_token);\n * console.log(\"Refresh token:\", data.refresh_token);\n * // Tokens are automatically stored by the SDK\n * }\n * ```\n */\n public async verifyOtp(\n body: VerifyPosLoginOtpBody\n ): Promise<ApiResult<VerifyPosLoginOtpContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/verify-otp\", { body })\n );\n }\n\n /**\n * Refresh POS access token\n * @param body - Refresh token data\n * @returns Promise with new tokens\n * @example\n * ```typescript\n * const { data, error } = await pos.refreshAccessToken({\n * refresh_token: \"refresh-token-here\"\n * });\n *\n * if (error) {\n * console.error(\"Token refresh failed:\", error.message);\n * } else {\n * console.log(\"New access token:\", data.access_token);\n * console.log(\"New refresh token:\", data.refresh_token);\n * // New tokens are automatically stored by the SDK\n * }\n * ```\n */\n public async refreshAccessToken(\n body: RefreshPosAccessTokenBody\n ): Promise<ApiResult<RefreshPosAccessTokenContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/refresh-token\", { body })\n );\n }\n\n /**\n * Get POS user details\n * @param pathParams - User ID\n * @returns Promise with user details\n * @example\n * ```typescript\n * const { data, error } = await pos.getUser({\n * id: \"01H9USER12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get user:\", error.message);\n * } else {\n * console.log(\"User:\", data.user);\n * }\n * ```\n */\n public async getUser(\n pathParams: GetPosUserPathParams\n ): Promise<ApiResult<GetPosUserContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/users/{id}\", { params: { path: pathParams } })\n );\n }\n\n /**\n * Logout\n * @returns Promise with logout confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.logout();\n *\n * if (error) {\n * console.error(\"Logout failed:\", error.message);\n * } else {\n * console.log(\"Logout message:\", data.message);\n * console.log(\"Success:\", data.success);\n * // Tokens are automatically cleared by the SDK\n * }\n * ```\n */\n public async logout(): Promise<ApiResult<LogoutFromPosDeviceResponse>> {\n return this.executeRequest(() => this.client.POST(\"/pos/auth/logout\"));\n }\n\n // ===============================\n // DEVICE ENDPOINTS\n // ===============================\n\n /**\n * List store locations\n * @returns Promise with list of locations\n * @example\n * ```typescript\n * const { data, error } = await pos.listLocations();\n * if (error) {\n * console.error(\"Failed to list locations:\", error.message);\n * } else {\n * console.log(\"Locations:\", data.locations);\n * }\n * ```\n */\n public async listLocations(): Promise<ApiResult<ListPosLocationsContent>> {\n return this.executeRequest(() => this.client.GET(\"/pos/locations\"));\n }\n\n /**\n * List devices\n * @returns Promise with list of devices\n * @example\n * ```typescript\n * const { data, error } = await pos.listDevices();\n * if (error) {\n * console.error(\"Failed to list devices:\", error.message);\n * } else {\n * console.log(\"Devices:\", data.devices);\n * }\n * ```\n */\n public async listDevices(): Promise<ApiResult<ListPosDevicesContent>> {\n return this.executeRequest(() => this.client.GET(\"/pos/devices\"));\n }\n\n /**\n * Pair POS device with pairing code\n * @param body - Pairing code received via phone/email\n * @returns Promise with device information\n * @example\n * ```typescript\n * const { data, error } = await pos.pairDevice({\n * pairing_code: \"ABC123\"\n * });\n *\n * if (error) {\n * console.error(\"Device pairing failed:\", error.message);\n * } else {\n * console.log(\"Device paired:\", data.device.id);\n * console.log(\"Device name:\", data.device.name);\n * // Store device_id for future use\n * }\n * ```\n */\n public async pairDevice(\n body: PairPosDeviceBody\n ): Promise<ApiResult<PairPosDeviceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/auth/pair-device\", { body })\n );\n }\n\n /**\n * Unclaim POS device - Unlinks a device from the user session\n * @param pathParams - Device ID\n * @returns Promise with unclaim confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.unclaimDevice({\n * id: \"01H9DEVICE12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to unclaim device:\", error.message);\n * } else {\n * console.log(\"Device unclaimed:\", data.message);\n * }\n * ```\n */\n public async unclaimDevice(\n pathParams: UnclaimPosDevicePathParams\n ): Promise<ApiResult<UnclaimPosDeviceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/devices/{id}/unclaim\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Claim POS device - Links a device to the user session\n * @param pathParams - Device ID\n * @returns Promise with claim confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.claimDevice({\n * id: \"01H9DEVICE12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to claim device:\", error.message);\n * } else {\n * console.log(\"Device claimed:\", data.message);\n * }\n * ```\n */\n public async claimDevice(\n pathParams: ClaimPosDevicePathParams\n ): Promise<ApiResult<ClaimPosDeviceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/devices/{id}/claim\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // CART ENDPOINTS\n // ===============================\n\n /**\n * Create a new cart\n * @param body - Cart creation data with items\n * @returns Promise with created cart\n * @example\n * ```typescript\n * const { data, error } = await pos.createCart({\n * items: [\n * {\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: null,\n * quantity: 2\n * },\n * {\n * product_id: \"01H9ABC67890FGHIJ\",\n * variant_id: \"01H9XYZ67890KLMNO\",\n * quantity: 1\n * }\n * ],\n * metadata: {\n * \"source\": \"pos-terminal-1\",\n * \"staff_id\": \"staff-123\"\n * }\n * });\n *\n * if (error) {\n * console.error(\"Failed to create cart:\", error.message);\n * } else {\n * console.log(\"Cart created:\", data.cart.id);\n * console.log(\"Cart total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async createCart(\n body: PosCreateCartBody\n ): Promise<ApiResult<PosCreateCartContent>> {\n return this.executeRequest(() => this.client.POST(\"/pos/carts\", { body }));\n }\n\n /**\n * Get cart details\n * @param pathParams - Cart ID\n * @returns Promise with cart details\n * @example\n * ```typescript\n * const { data, error } = await pos.getCart({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get cart:\", error.message);\n * } else {\n * const cart = data.cart;\n * console.log(\"Cart total:\", cart.grand_total);\n * console.log(\"Items count:\", cart.cart_items.length);\n * }\n * ```\n */\n public async getCart(\n pathParams: PosGetCartPathParams\n ): Promise<ApiResult<PosGetCartContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/{id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Get cart details by user ID\n * @param pathParams - User ID\n * @returns Promise with cart details\n * @example\n * ```typescript\n * const { data, error } = await pos.getUserCart({\n * user_id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get user cart:\", error.message);\n * } else {\n * console.log(\"User cart ID:\", data.cart.id);\n * console.log(\"Cart value:\", data.cart.subtotal_amount);\n * }\n * ```\n */\n public async getUserCart(\n pathParams: PosGetUserCartPathParams\n ): Promise<ApiResult<PosGetUserCartContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/users/{user_id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Delete cart (remove all items)\n * @param pathParams - Cart ID\n * @returns Promise with deletion confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.deleteCart({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to delete cart:\", error.message);\n * } else {\n * console.log(\"Cart deleted:\", data.message);\n * }\n * ```\n */\n public async deleteCart(\n pathParams: PosDeleteCartPathParams\n ): Promise<ApiResult<PosDeleteCartResponse>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Add/update cart item (set quantity to 0 to remove)\n * @param pathParams - Cart ID\n * @param body - Item update data\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * // Add item to cart\n * const { data, error } = await pos.updateCart(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: null,\n * quantity: 3\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update cart:\", error.message);\n * } else {\n * console.log(\"Cart updated:\", data.cart.cart_items.length);\n * }\n *\n * // Remove item from cart (set quantity to 0)\n * const { data: removeData, error: removeError } = await pos.updateCart(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: null,\n * quantity: 0\n * }\n * );\n * ```\n */\n public async updateCart(\n pathParams: PosUpdateCartPathParams,\n body: PosUpdateCartBody\n ): Promise<ApiResult<PosUpdateCartContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/items\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Update cart address (billing/shipping)\n * @param pathParams - Cart ID\n * @param body - Address data (registered user IDs or guest addresses)\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * // For registered users with saved addresses\n * const { data, error } = await pos.createCartAddress(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * billing_address_id: \"01H9ADDR12345BILL\",\n * shipping_address_id: \"01H9ADDR12345SHIP\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update cart address:\", error.message);\n * } else {\n * console.log(\"Addresses updated:\", data.message);\n * }\n *\n * // For guest checkout with new addresses\n * const { data: guestData, error: guestError } = await pos.createCartAddress(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * billing_address: {\n * first_name: \"John\",\n * last_name: \"Doe\",\n * email: \"john@example.com\",\n * phone: \"9876543210\",\n * country_code: \"+91\",\n * address_line1: \"123 Main Street\",\n * address_line2: \"Apt 4B\",\n * city: \"Mumbai\",\n * state: \"Maharashtra\",\n * pincode: \"400001\",\n * country: \"India\",\n * landmark: \"Near Station\",\n * tax_identification_number: null,\n * business_name: null\n * },\n * shipping_address: {\n * first_name: \"John\",\n * last_name: \"Doe\",\n * email: \"john@example.com\",\n * phone: \"9876543210\",\n * country_code: \"+91\",\n * address_line1: \"456 Oak Avenue\",\n * address_line2: null,\n * city: \"Pune\",\n * state: \"Maharashtra\",\n * pincode: \"411001\",\n * country: \"India\",\n * landmark: \"Near Mall\",\n * tax_identification_number: null,\n * business_name: null\n * }\n * }\n * );\n * ```\n */\n public async createCartAddress(\n pathParams: PosCreateCartAddressPathParams,\n body: PosCreateCartAddressBody\n ): Promise<ApiResult<PosCreateCartAddressContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/address\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n // ===============================\n // COUPON & PROMOTION ENDPOINTS\n // ===============================\n\n /**\n * List all available coupons\n * @param headers - Optional header parameters (customer_group_id, etc.)\n * @returns Promise with available coupons\n * @example\n * ```typescript\n * // Get all available coupons\n * const { data, error } = await pos.listCoupons();\n *\n * if (error) {\n * console.error(\"Failed to get available coupons:\", error.message);\n * } else {\n * const coupons = data.coupons || [];\n * console.log(\"Available coupons:\", coupons.length);\n * coupons.forEach(coupon => {\n * console.log(\"Coupon:\", coupon.code, \"Discount:\", coupon.discount_amount);\n * });\n * }\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listCoupons({\n * \"x-customer-group-id\": \"01H9GROUP12345ABC\" // Override default SDK config\n * });\n * ```\n */\n public async listCoupons(\n headers?: PosListCouponsHeaderParams\n ): Promise<ApiResult<PosListCouponsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/available-coupons\", {\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List all available promotions\n * @param headers - Optional header parameters (customer_group_id, etc.)\n * @returns Promise with available promotions\n * @example\n * ```typescript\n * // Get all available promotions\n * const { data, error } = await pos.listPromotions();\n *\n * if (error) {\n * console.error(\"Failed to get available promotions:\", error.message);\n * } else {\n * const promotions = data.promotions || [];\n * console.log(\"Available promotions:\", promotions.length);\n * promotions.forEach(promotion => {\n * console.log(\"Promotion:\", promotion.name, \"Type:\", promotion.promotion_type);\n * });\n * }\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listPromotions({\n * \"x-customer-group-id\": \"01H9GROUP12345ABC\" // Override default SDK config\n * });\n * ```\n */\n public async listPromotions(\n headers?: PosListPromotionsHeaderParams\n ): Promise<ApiResult<PosListPromotionsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/available-promotions\", {\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Apply coupon to cart\n * @param pathParams - Cart ID\n * @param body - Coupon code\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.applyCoupon(\n * { id: \"01H9CART12345ABCDE\" },\n * { coupon_code: \"FLAT100OFF\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to apply coupon:\", error.message);\n * } else {\n * console.log(\"Coupon applied, new total:\", data.cart.grand_total);\n * console.log(\"Discount amount:\", data.cart.coupon_discount_amount);\n * }\n * ```\n */\n public async applyCoupon(\n pathParams: PosApplyCouponPathParams,\n body: PosApplyCouponBody\n ): Promise<ApiResult<PosApplyCouponContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/coupon\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Remove coupon from cart\n * @param pathParams - Cart ID\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.removeCoupon({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to remove coupon:\", error.message);\n * } else {\n * console.log(\"Coupon removed, new total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async removeCoupon(\n pathParams: PosRemoveCouponPathParams\n ): Promise<ApiResult<PosRemoveCouponContent>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}/coupon\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Evaluate applicable/inapplicable coupons for cart\n * @param pathParams - Cart ID\n * @returns Promise with coupon evaluation results\n * @example\n * ```typescript\n * const { data, error } = await pos.evaluateCoupons({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to evaluate coupons:\", error.message);\n * } else {\n * const applicable = data.applicable_coupons || [];\n * const inapplicable = data.inapplicable_coupons || [];\n *\n * console.log(\"Applicable coupons:\", applicable.length);\n * applicable.forEach(coupon => {\n * console.log(`- ${coupon.code}: Save $${coupon.estimated_discount}`);\n * });\n *\n * console.log(\"Inapplicable coupons:\", inapplicable.length);\n * inapplicable.forEach(coupon => {\n * console.log(`- ${coupon.code}: ${coupon.reason}`);\n * });\n * }\n * ```\n */\n public async evaluateCoupons(\n pathParams: PosEvaluateCouponsPathParams\n ): Promise<ApiResult<PosEvaluateCouponsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/{id}/evaluate-coupons\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Evaluate applicable/inapplicable promotions for cart\n * @param pathParams - Cart ID\n * @returns Promise with promotion evaluation results\n * @example\n * ```typescript\n * const { data, error } = await pos.evaluatePromotions({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to evaluate promotions:\", error.message);\n * } else {\n * const applicable = data.applicable_promotions || [];\n * const inapplicable = data.inapplicable_promotions || [];\n *\n * console.log(\"Applicable promotions:\", applicable.length);\n * applicable.forEach(promo => {\n * console.log(`- ${promo.name}: ${promo.savings_message}`);\n * });\n *\n * console.log(\"Inapplicable promotions:\", inapplicable.length);\n * inapplicable.forEach(promo => {\n * console.log(`- ${promo.name}: ${promo.reason}`);\n * });\n * }\n * ```\n */\n public async evaluatePromotions(\n pathParams: PosEvaluatePromotionsPathParams\n ): Promise<ApiResult<PosEvaluatePromotionsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/carts/{id}/evaluate-promotions\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // CREDIT BALANCE ENDPOINTS\n // ===============================\n\n /**\n * Apply credit balance to cart\n * @param pathParams - Cart ID\n * @param body - Credit balance amount to use\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.redeemCreditBalance(\n * { id: \"01H9CART12345ABCDE\" },\n * { credit_balance_used: 250.00 }\n * );\n *\n * if (error) {\n * console.error(\"Failed to redeem credit balance:\", error.message);\n * } else {\n * console.log(\"Credit applied, new total:\", data.cart.grand_total);\n * console.log(\"Credit used:\", data.cart.credit_balance_used);\n * }\n * ```\n */\n public async redeemCreditBalance(\n pathParams: PosRedeemCreditBalancePathParams,\n body: PosRedeemCreditBalanceBody\n ): Promise<ApiResult<PosRedeemCreditBalanceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/credit-balance\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Remove credit balance from cart\n * @param pathParams - Cart ID\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.removeCreditBalance({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to remove credit balance:\", error.message);\n * } else {\n * console.log(\"Credit balance removed, new total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async removeCreditBalance(\n pathParams: PosRemoveCreditBalancePathParams\n ): Promise<ApiResult<PosRemoveCreditBalanceContent>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}/credit-balance\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // LOYALTY POINTS ENDPOINTS\n // ===============================\n\n /**\n * Redeem loyalty points for cart\n * @param pathParams - Cart ID\n * @param body - Loyalty points to redeem\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.redeemLoyaltyPoints(\n * { id: \"01H9CART12345ABCDE\" },\n * { loyalty_point_redeemed: 500 }\n * );\n *\n * if (error) {\n * console.error(\"Failed to redeem loyalty points:\", error.message);\n * } else {\n * console.log(\"Points redeemed, new total:\", data.cart.grand_total);\n * console.log(\"Points redeemed:\", data.cart.loyalty_points_redeemed);\n * }\n * ```\n */\n public async redeemLoyaltyPoints(\n pathParams: PosRedeemLoyaltyPointsPathParams,\n body: PosRedeemLoyaltyPointsBody\n ): Promise<ApiResult<PosRedeemLoyaltyPointsContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/loyalty-points\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Remove loyalty points from cart\n * @param pathParams - Cart ID\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.removeLoyaltyPoints({\n * id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to remove loyalty points:\", error.message);\n * } else {\n * console.log(\"Loyalty points removed, new total:\", data.cart.grand_total);\n * }\n * ```\n */\n public async removeLoyaltyPoints(\n pathParams: PosRemoveLoyaltyPointsPathParams\n ): Promise<ApiResult<PosRemoveLoyaltyPointsContent>> {\n return this.executeRequest(() =>\n this.client.DELETE(\"/pos/carts/{id}/loyalty-points\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // FULFILLMENT ENDPOINTS\n // ===============================\n\n /**\n * Update cart fulfillment preference (delivery/pickup)\n * @param pathParams - Cart ID\n * @param body - Fulfillment preference data\n * @returns Promise with confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.updateFulfillmentPreference(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * fulfillment_type: \"delivery\",\n * delivery_address_id: \"01H9ADDR12345ABCDE\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update fulfillment preference:\", error.message);\n * } else {\n * console.log(\"Fulfillment preference updated:\", data.message);\n * console.log(\"Success:\", data.success);\n * }\n * ```\n */\n public async updateFulfillmentPreference(\n pathParams: PosUpdateFulfillmentPreferencePathParams,\n body: PosUpdateFulfillmentPreferenceBody\n ): Promise<ApiResult<PosUpdateFulfillmentPreferenceContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/fulfillment-preference\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n /**\n * Get fulfillment options for cart\n * @param body - Cart data for fulfillment calculation\n * @returns Promise with fulfillment options\n * @example\n * ```typescript\n * const { data, error } = await pos.getFulfillmentOptions({\n * cart_id: \"01H9CART12345ABCDE\",\n * delivery_address: {\n * street: \"123 Main St\",\n * city: \"New York\",\n * state: \"NY\",\n * zip_code: \"10001\",\n * country: \"US\"\n * }\n * });\n *\n * if (error) {\n * console.error(\"Failed to get fulfillment options:\", error.message);\n * } else {\n * console.log(\"Available fulfillment options:\", data.options.length);\n * data.options.forEach(option => {\n * console.log(`${option.type}: ${option.name} - $${option.cost}`);\n * });\n * }\n * ```\n */\n public async getFulfillmentOptions(\n body: GetPosFulfillmentOptionsBody\n ): Promise<ApiResult<GetPosFulfillmentOptionsContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/fulfillment-options\", { body })\n );\n }\n\n // ===============================\n // CUSTOMER ENDPOINTS\n // ===============================\n\n /**\n * Update cart customer information\n * @param pathParams - Cart ID\n * @param body - Customer update data\n * @returns Promise with updated cart\n * @example\n * ```typescript\n * const { data, error } = await pos.updateCartCustomer(\n * { id: \"01H9CART12345ABCDE\" },\n * {\n * customer_id: \"01H9CUST12345ABCDE\",\n * customer_group_id: \"01H9GROUP12345ABCDE\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update cart customer:\", error.message);\n * } else {\n * console.log(\"Cart customer updated:\", data.cart.id);\n * console.log(\"Customer ID:\", data.cart.customer_id);\n * console.log(\"Customer group:\", data.cart.customer_group_id);\n * }\n * ```\n */\n public async updateCartCustomer(\n pathParams: UpdatePosCartCustomerPathParams,\n body: UpdatePosCartCustomerBody\n ): Promise<ApiResult<UpdatePosCartCustomerContent>> {\n return this.executeRequest(() =>\n this.client.POST(\"/pos/carts/{id}/update-customer\", {\n params: { path: pathParams },\n body,\n })\n );\n }\n\n // ===============================\n // ORDER ENDPOINTS\n // ===============================\n\n /**\n * Create order from cart\n * @param body - Order creation data\n * @returns Promise with created order\n * @example\n * ```typescript\n * const { data, error } = await pos.createOrder({\n * cart_id: \"01H9CART12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to create order:\", error.message);\n * } else {\n * console.log(\"Order created:\", data.order.id);\n * console.log(\"Payment required:\", data.payment_required);\n * }\n * ```\n */\n public async createOrder(\n body: CreatePosOrderBody\n ): Promise<ApiResult<CreatePosOrderContent>> {\n return this.executeRequest(() =>\n // USES storefrontClient to avoid path conflicts with admin. This is only required when same path exists for both storefront and admin.\n this.storefrontClient.POST(\"/pos/orders\", { body })\n );\n }\n\n // ===============================\n // PAYMENT ENDPOINTS\n // ===============================\n\n /**\n * Get payment status\n * @param pathParams - Order number\n * @returns Promise with payment status\n * @example\n * ```typescript\n * const { data, error } = await pos.getPaymentStatus({ order_number: \"1234567890\" });\n *\n * if (error) {\n * console.error(\"Failed to get payment status:\", error.message);\n * } else {\n * console.log(\"Payment status:\", data.status);\n * console.log(\"Amount paid:\", data.amount_paid);\n * console.log(\"Amount unpaid:\", data.amount_unpaid);\n * console.log(\"Retry available:\", data.is_retry_available);\n * }\n * ```\n */\n public async getPaymentStatus(\n pathParams: PosGetPaymentStatusPathParams\n ): Promise<ApiResult<PosGetPaymentStatusContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/payment-status\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ===============================\n // CATALOG ENDPOINTS\n // ===============================\n\n /**\n * List all categories\n * @param query - Optional query parameters for filtering categories\n * @returns Promise with list of categories\n * @example\n * ```typescript\n * // Basic category listing\n * const { data, error } = await pos.listCategories();\n *\n * if (error) {\n * console.error(\"Failed to list categories:\", error.message);\n * } else {\n * console.log(\"Categories found:\", data.categories?.length || 0);\n * data.categories?.forEach(category => {\n * console.log(`Category: ${category.name} - ${category.description}`);\n * });\n * }\n *\n * // With pagination\n * const { data: catData, error: catError } = await pos.listCategories({\n * page: 1,\n * limit: 10\n * });\n * ```\n */\n public async listCategories(\n query?: PosListCategoriesQuery\n ): Promise<ApiResult<PosListCategoriesContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/categories\", {\n params: { query },\n })\n );\n }\n\n /**\n * List all products\n * @param query - Optional query parameters for filtering products\n * @param headers - Optional header parameters\n * @returns Promise with list of products\n * @example\n * ```typescript\n * // Basic product listing\n * const { data, error } = await pos.listProducts();\n *\n * if (error) {\n * console.error(\"Failed to list products:\", error.message);\n * } else {\n * console.log(\"Products found:\", data.products?.length || 0);\n * console.log(\"Pagination:\", data.pagination);\n * data.products?.forEach(product => {\n * console.log(`Product: ${product.name} - $${product.price}`);\n * });\n * }\n *\n * // With filtering and pagination\n * const { data: filteredData, error: filteredError } = await pos.listProducts({\n * page: 1,\n * limit: 20,\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" }),\n * category_slug: [\"electronics\", \"smartphones\"]\n * });\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listProducts(\n * {\n * page: 1,\n * limit: 20,\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" }),\n * category_slug: [\"electronics\", \"smartphones\"]\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async listProducts(\n query?: PosListProductsQuery,\n headers?: PosListProductsHeaderParams\n ): Promise<ApiResult<PosListProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List cross-sell products\n * @param query - Query parameters with product IDs for cross-sell recommendations\n * @param headers - Optional header parameters\n * @returns Promise with cross-sell products\n * @example\n * ```typescript\n * // Basic usage - get cross-sell products for cart items\n * const { data, error } = await pos.listCrosssellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\", \"prod_01H9ABC67890FGHIJ\"]\n * });\n *\n * // Advanced usage with pagination and custom sorting\n * const { data, error } = await pos.listCrosssellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 10,\n * sort_by: '{\"price\":\"asc\"}'\n * });\n *\n * // Override customer group ID for this specific request\n * const { data, error } = await pos.listCrosssellProducts(\n * {\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 10\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get cross-sell products:\", error.message);\n * } else {\n * console.log(\"Cross-sell products found:\", data.products.length);\n * console.log(\"Pagination:\", data.pagination);\n * data.products.forEach(product => {\n * console.log(`Product: ${product.name} - ${product.price}`);\n * });\n * }\n * ```\n */\n public async listCrosssellProducts(\n query: PosListCrosssellProductsQuery,\n headers?: PosListCrosssellProductsHeaderParams\n ): Promise<ApiResult<PosListCrosssellProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/cross-sell\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Search products\n * @param body - Search criteria and parameters\n * @param headers - Optional header parameters\n * @returns Promise with search results including SKUs, facet distribution, facet stats, and pagination\n * @example\n * ```typescript\n * // Basic search\n * const { data, error } = await pos.searchProducts({\n * query: \"smartphone\",\n * page: 1,\n * limit: 20\n * });\n *\n * if (error) {\n * console.error(\"Failed to search products:\", error.message);\n * } else {\n * console.log(\"Search results:\", data.skus?.length || 0, \"products found\");\n * console.log(\"Facet distribution:\", data.facet_distribution);\n * console.log(\"Facet stats:\", data.facet_stats);\n * console.log(\"Pagination:\", data.pagination);\n *\n * data.skus?.forEach(sku => {\n * console.log(`Found: ${sku.product_name} - ${sku.pricing?.selling_price}`);\n * });\n * }\n *\n * // With filter (string expression — Meilisearch syntax)\n * const { data: filtered, error: filteredError } = await pos.searchProducts({\n * query: \"laptop\",\n * filter: \"pricing.selling_price 500 TO 2000 AND product_type = physical\",\n * sort: [\"pricing.selling_price:asc\"],\n * facets: [\"product_type\", \"categories.name\", \"tags\"],\n * page: 1,\n * limit: 10\n * });\n *\n * // With filter (array of conditions — combined with AND)\n * const { data: arrayFiltered, error: arrayError } = await pos.searchProducts({\n * query: \"shoes\",\n * filter: [\"product_type = physical\", \"rating >= 4\", \"stock_available > 0\"],\n * sort: [\"rating:desc\"],\n * facets: [\"*\"],\n * page: 1,\n * limit: 25\n * });\n *\n * // With filter (nested arrays — inner arrays use OR, outer uses AND)\n * const { data: nestedFiltered, error: nestedError } = await pos.searchProducts({\n * query: \"headphones\",\n * filter: [\n * \"pricing.selling_price 50 TO 300\",\n * [\"product_type = physical\", \"product_type = bundle\"]\n * ],\n * page: 1,\n * limit: 25\n * });\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.searchProducts(\n * {\n * query: \"laptop\",\n * filter: \"categories.name = computers\",\n * page: 1,\n * limit: 20\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async searchProducts(\n body: PosSearchProductsBody,\n headers?: PosSearchProductsHeaderParams\n ): Promise<ApiResult<PosSearchProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.POST(\"/pos/catalog/products/search\", {\n body,\n params: {\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List similar products\n * @param query - Query parameters with product ID for similarity recommendations\n * @param headers - Optional header parameters\n * @returns Promise with similar products\n * @example\n * ```typescript\n * // Basic usage - get similar products for a specific product\n * const { data, error } = await pos.listSimilarProducts({\n * product_id: \"prod_01H9XYZ12345ABCDE\"\n * });\n *\n * // Advanced usage with pagination and custom sorting\n * const { data, error } = await pos.listSimilarProducts({\n * product_id: \"prod_01H9XYZ12345ABCDE\",\n * page: 1,\n * limit: 20,\n * sort_by: '{\"relevance\":\"desc\"}'\n * });\n *\n * // Override customer group ID for this specific request\n * const { data, error } = await pos.listSimilarProducts(\n * {\n * product_id: \"prod_01H9XYZ12345ABCDE\",\n * page: 1,\n * limit: 20\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get similar products:\", error.message);\n * } else {\n * console.log(\"Similar products found:\", data.products.length);\n * console.log(\"Pagination:\", data.pagination);\n * data.products.forEach(product => {\n * console.log(`Similar: ${product.name} - ${product.price}`);\n * });\n * }\n * ```\n */\n public async listSimilarProducts(\n query: PosListSimilarProductsQuery,\n headers?: PosListSimilarProductsHeaderParams\n ): Promise<ApiResult<PosListSimilarProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/similar\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List up-sell products\n * @param query - Query parameters with product IDs for up-sell recommendations\n * @param headers - Optional header parameters\n * @returns Promise with up-sell products\n * @example\n * ```typescript\n * // Basic usage - get up-sell products for cart items\n * const { data, error } = await pos.listUpsellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"]\n * });\n *\n * // Advanced usage with pagination and custom sorting\n * const { data, error } = await pos.listUpsellProducts({\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 15,\n * sort_by: '{\"relevance\":\"desc\"}'\n * });\n *\n * // Override customer group ID for this specific request\n * const { data, error } = await pos.listUpsellProducts(\n * {\n * product_ids: [\"prod_01H9XYZ12345ABCDE\"],\n * page: 1,\n * limit: 15\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get up-sell products:\", error.message);\n * } else {\n * console.log(\"Up-sell products found:\", data.products.length);\n * console.log(\"Pagination:\", data.pagination);\n * data.products.forEach(product => {\n * console.log(`Up-sell: ${product.name} - ${product.price}`);\n * });\n * }\n * ```\n */\n public async listUpsellProducts(\n query: PosListUpsellProductsQuery,\n headers?: PosListUpsellProductsHeaderParams\n ): Promise<ApiResult<PosListUpsellProductsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/up-sell\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Get product details\n * @param pathParams - The path parameters. Accepts product ID or product slug.\n * @param headers - Optional header parameters\n * @returns Promise with product details\n * @example\n * ```typescript\n * // Get product by ID\n * const { data, error } = await pos.getProductDetail(\n * { product_id: \"prod_123\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get product details:\", error.message);\n * } else {\n * console.log(\"Product:\", data.product.name);\n * console.log(\"Price:\", data.product.pricing?.selling_price);\n * console.log(\"Description:\", data.product.short_description);\n * }\n *\n * // Get product by slug (also accepted in place of product_id)\n * const { data: slugData, error: slugError } = await pos.getProductDetail({\n * product_id: \"detox-candy\"\n * });\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.getProductDetail(\n * { product_id: \"detox-candy\" },\n * undefined,\n * {\n * \"x-customer-group-id\": \"premium_customers\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async getProductDetail(\n pathParams: PosGetProductDetailPathParams,\n query?: PosGetProductDetailQuery,\n headers?: PosGetProductDetailHeaderParams\n ): Promise<ApiResult<PosGetProductDetailContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/{product_id}\", {\n params: {\n path: pathParams,\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * List product reviews\n * @param pathParams - Product ID\n * @param query - Optional query parameters for filtering reviews\n * @returns Promise with product reviews\n * @example\n * ```typescript\n * const { data, error } = await pos.listProductReviews(\n * { product_id: \"prod_123\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to list product reviews:\", error.message);\n * } else {\n * console.log(\"Reviews found:\", data.reviews?.length || 0);\n * data.reviews?.forEach(review => {\n * console.log(`Review by ${review.customer_name}: ${review.rating}/5`);\n * console.log(\"Comment:\", review.comment);\n * });\n * }\n *\n * // With pagination\n * const { data: reviewData, error: reviewError } = await pos.listProductReviews(\n * { product_id: \"prod_123\" },\n * {\n * page: 1,\n * limit: 5\n * }\n * );\n * ```\n */\n public async listProductReviews(\n pathParams: PosListProductReviewsPathParams,\n query?: PosListProductReviewsQuery\n ): Promise<ApiResult<PosListProductReviewsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/{product_id}/reviews\", {\n params: {\n path: pathParams,\n query,\n },\n })\n );\n }\n\n /**\n * List product variants\n * @param pathParams - The path parameters. Accepts product ID or product slug.\n * @param headers - Optional header parameters\n * @returns Promise with product variants\n * @example\n * ```typescript\n * // By product ID\n * const { data, error } = await pos.listProductVariants(\n * { product_id: \"prod_123\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to list product variants:\", error.message);\n * } else {\n * console.log(\"Variants found:\", data.variants?.length || 0);\n * data.variants?.forEach(variant => {\n * console.log(`Variant: ${variant.name} - SKU: ${variant.sku} - Price: ${variant.pricing?.selling_price}`);\n * });\n * }\n *\n * // By product slug (also accepted in place of product_id)\n * const { data: slugData, error: slugError } = await pos.listProductVariants(\n * { product_id: \"detox-candy\" }\n * );\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listProductVariants(\n * { product_id: \"prod_123\" },\n * undefined,\n * {\n * \"x-customer-group-id\": \"wholesale_customers\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async listProductVariants(\n pathParams: PosListProductVariantsPathParams,\n query?: PosListProductVariantsQuery,\n headers?: PosListProductVariantsHeaderParams\n ): Promise<ApiResult<PosListProductVariantsContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/products/{product_id}/variants\", {\n params: {\n path: pathParams,\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n /**\n * Get variant details\n * @param pathParams - The path parameters. Accepts product ID or slug for product_id, and variant ID or slug for variant_id.\n * @param headers - Optional header parameters\n * @returns Promise with variant details\n * @example\n * ```typescript\n * // By product ID and variant ID\n * const { data, error } = await pos.getVariantDetail(\n * {\n * product_id: \"prod_123\",\n * variant_id: \"var_456\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get variant details:\", error.message);\n * } else {\n * console.log(\"Variant:\", data.variant.name);\n * console.log(\"SKU:\", data.variant.sku);\n * console.log(\"Price:\", data.variant.pricing?.selling_price);\n * console.log(\"Stock available:\", data.variant.stock_available);\n * }\n *\n * // By product slug and variant slug (also accepted in place of IDs)\n * const { data: slugData, error: slugError } = await pos.getVariantDetail(\n * {\n * product_id: \"detox-candy\",\n * variant_id: \"detox-candy-100g\"\n * }\n * );\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.getVariantDetail(\n * {\n * product_id: \"prod_123\",\n * variant_id: \"var_456\"\n * },\n * undefined,\n * {\n * \"x-customer-group-id\": \"wholesale_customers\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async getVariantDetail(\n pathParams: PosGetVariantDetailPathParams,\n query?: PosGetVariantDetailQuery,\n headers?: PosGetVariantDetailHeaderParams\n ): Promise<ApiResult<PosGetVariantDetailContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\n \"/pos/catalog/products/{product_id}/variants/{variant_id}\",\n {\n params: {\n path: pathParams,\n query,\n header: mergedHeaders,\n },\n }\n )\n );\n }\n\n /**\n * List all SKUs\n * @param query - Optional query parameters for filtering SKUs\n * @param headers - Optional header parameters\n * @returns Promise with list of SKUs\n * @example\n * ```typescript\n * // Basic SKU listing\n * const { data, error } = await pos.listSkus();\n *\n * if (error) {\n * console.error(\"Failed to list SKUs:\", error.message);\n * } else {\n * console.log(\"SKUs found:\", data.skus?.length || 0);\n * console.log(\"Pagination:\", data.pagination);\n * data.skus?.forEach(sku => {\n * console.log(`SKU: ${sku.sku} - Price: ${sku.price}`);\n * });\n * }\n *\n * // With pagination\n * const { data: skuData, error: skuError } = await pos.listSkus({\n * page: 1,\n * limit: 50\n * });\n *\n * // Override customer group ID for this specific request\n * const { data: overrideData, error: overrideError } = await pos.listSkus(\n * {\n * page: 1,\n * limit: 50\n * },\n * {\n * \"x-customer-group-id\": \"01H9XYZ12345USERID\" // Override default SDK config\n * }\n * );\n * ```\n */\n public async listSkus(\n query?: PosListSkusQuery,\n headers?: PosListSkusHeaderParams\n ): Promise<ApiResult<PosListSkusContent>> {\n const mergedHeaders = this.mergeHeaders(headers);\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/skus\", {\n params: {\n query,\n header: mergedHeaders,\n },\n })\n );\n }\n\n // ===============================\n // ADMIN ENDPOINTS\n // ===============================\n\n // ADMIN INVENTORY ENDPOINTS\n\n /**\n * List all inventories (Admin)\n * @param query - Optional query parameters for filtering inventories\n * @returns Promise with list of inventories\n * @example\n * ```typescript\n * // Basic inventory listing\n * const { data, error } = await pos.listInventories();\n *\n * if (error) {\n * console.error(\"Failed to list inventories:\", error.message);\n * } else {\n * console.log(\"Inventories found:\", data.content?.inventories?.length || 0);\n * data.content?.inventories?.forEach(inventory => {\n * console.log(`Product: ${inventory.product_name} - Stock: ${inventory.stock_quantity}`);\n * });\n * }\n *\n * // With pagination and filters\n * const { data: filteredData, error: filteredError } = await pos.listInventories({\n * page: 1,\n * limit: 20,\n * sort_by: JSON.stringify({ \"stock_quantity\": \"desc\" }),\n * filters: JSON.stringify({ \"product_name\": \"smartphone\" })\n * });\n * ```\n */\n public async listInventories(\n query?: PosListInventoryQuery\n ): Promise<ApiResult<PosListInventoryContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/inventories\", {\n params: { query },\n })\n );\n }\n\n /**\n * List all inventory activities (Admin)\n * @param query - Optional query parameters for filtering inventory activities\n * @returns Promise with list of inventory activities\n * @example\n * ```typescript\n * // Basic inventory activities listing\n * const { data, error } = await pos.listInventoryActivities();\n *\n * if (error) {\n * console.error(\"Failed to list inventory activities:\", error.message);\n * } else {\n * console.log(\"Activities found:\", data.content?.activities?.length || 0);\n * data.content?.activities?.forEach(activity => {\n * console.log(`Activity: ${activity.activity_type} - Product: ${activity.product_name} - Quantity: ${activity.quantity}`);\n * });\n * }\n *\n * // With pagination and filters\n * const { data: filteredData, error: filteredError } = await pos.listInventoryActivities({\n * page: 1,\n * limit: 50,\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" }),\n * filters: JSON.stringify({ \"activity_type\": \"add\" })\n * });\n * ```\n */\n public async listInventoryActivities(\n query?: PosListInventoryActivityQuery\n ): Promise<ApiResult<PosListInventoryActivityContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/inventories/activites\", {\n params: { query },\n })\n );\n }\n\n /**\n * Get inventory detail (Admin)\n * @param query - Query parameters with product/variant information\n * @returns Promise with inventory details\n * @example\n * ```typescript\n * // Get inventory detail for a product\n * const { data, error } = await pos.getInventoryDetail({\n * product_id: \"01H9XYZ12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get inventory detail:\", error.message);\n * } else {\n * const inventory = data.content?.inventory;\n * console.log(`Product: ${inventory?.product_name}`);\n * console.log(`Stock: ${inventory?.stock_quantity}`);\n * console.log(`Warehouse details:`, inventory?.details);\n * }\n *\n * // Get inventory detail for a product variant\n * const { data: variantData, error: variantError } = await pos.getInventoryDetail({\n * product_id: \"01H9XYZ12345ABCDE\",\n * variant_id: \"01H9ABC67890FGHIJ\"\n * });\n *\n * // Get inventory detail for a specific lot/batch\n * const { data: batchData, error: batchError } = await pos.getInventoryDetail({\n * product_id: \"01H9XYZ12345ABCDE\",\n * lot_batch: \"BATCH001\"\n * });\n * ```\n */\n public async getInventoryDetail(\n query: PosListInventoryDetailQuery\n ): Promise<ApiResult<PosListInventoryDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/catalog/inventories/detail\", {\n params: { query },\n })\n );\n }\n\n // ADMIN CUSTOMER ENDPOINTS\n\n /**\n * List all customers (Admin)\n * @param query - Optional query parameters for filtering customers\n * @returns Promise with list of customers\n * @example\n * ```typescript\n * // Basic customer listing\n * const { data, error } = await pos.getCustomers();\n *\n * if (error) {\n * console.error(\"Failed to list customers:\", error.message);\n * } else {\n * console.log(\"Customers found:\", data.content?.customers?.length || 0);\n * console.log(\"Pagination:\", data.content?.pagination);\n * data.content?.customers?.forEach(customer => {\n * console.log(`Customer: ${customer.full_name} - Email: ${customer.email}`);\n * });\n * }\n *\n * // With search and pagination\n * const { data: searchData, error: searchError } = await pos.getCustomers({\n * page: 1,\n * limit: 20,\n * search: \"john@example.com\",\n * sort_by: JSON.stringify({ \"created_at\": \"desc\" })\n * });\n * ```\n */\n public async getCustomers(\n query?: PosListCustomersQuery\n ): Promise<ApiResult<PosListCustomersContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/customers\", {\n params: { query },\n })\n );\n }\n\n /**\n * Get customer details (Admin)\n * @param pathParams - Customer ID\n * @returns Promise with customer details\n * @example\n * ```typescript\n * const { data, error } = await pos.getCustomer({\n * id: \"01H9CUST12345ABCDE\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get customer:\", error.message);\n * } else {\n * const customer = data.content?.customer;\n * console.log(`Customer: ${customer?.full_name}`);\n * console.log(`Email: ${customer?.email}`);\n * console.log(`Phone: ${customer?.phone}`);\n * console.log(`Loyalty points: ${customer?.loyalty?.points_balance}`);\n * console.log(`Total spent: ${customer?.loyalty?.lifetime_spent}`);\n * }\n * ```\n */\n public async getCustomer(\n pathParams: PosGetCustomerDetailPathParams\n ): Promise<ApiResult<PosGetCustomerDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/customers/{id}\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ADMIN ORDER ENDPOINTS\n\n /**\n * List all orders (Admin)\n * @param query - Optional query parameters for filtering orders\n * @returns Promise with list of orders\n * @example\n * ```typescript\n * // Basic order listing\n * const { data, error } = await pos.listOrders();\n *\n * if (error) {\n * console.error(\"Failed to list orders:\", error.message);\n * } else {\n * console.log(\"Orders found:\", data.content?.orders?.length || 0);\n * console.log(\"Pagination:\", data.content?.pagination);\n * data.content?.orders?.forEach(order => {\n * console.log(`Order: ${order.order_number} - Status: ${order.status} - Total: ${order.grand_total}`);\n * });\n * }\n *\n * // With filters and pagination\n * const { data: filteredData, error: filteredError } = await pos.listOrders({\n * page: 1,\n * limit: 50,\n * search: \"ORD-2024\",\n * filters: JSON.stringify({ \"status\": \"delivered\", \"payment_status\": \"success\" }),\n * sort_by: JSON.stringify({ \"order_date\": \"desc\" })\n * });\n * ```\n */\n public async listOrders(\n query?: PosListOrdersQuery\n ): Promise<ApiResult<PosListOrdersContent>> {\n return this.executeRequest(() =>\n // USES adminClient to avoid path conflicts with storefront. This is only required when same path exists for both storefront and admin.\n this.adminClient.GET(\"/pos/orders\", {\n params: { query },\n })\n );\n }\n\n /**\n * Get order details (Admin)\n * @param pathParams - Order number\n * @returns Promise with order details\n * @example\n * ```typescript\n * const { data, error } = await pos.getOrderDetail({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get order:\", error.message);\n * } else {\n * const order = data.content?.order;\n * console.log(`Order: ${order?.order_number}`);\n * console.log(`Status: ${order?.status}`);\n * console.log(`Payment Status: ${order?.payment_status}`);\n * console.log(`Total: ${order?.grand_total}`);\n * console.log(`Items:`, order?.order_items);\n * console.log(`Billing Address:`, order?.billing_address);\n * console.log(`Payments:`, order?.payments);\n * }\n * ```\n */\n public async getOrderDetail(\n pathParams: PosGetOrderDetailPathParams\n ): Promise<ApiResult<PosGetOrderDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * List order activity (Admin)\n * @param pathParams - Order number\n * @returns Promise with order activities\n * @example\n * ```typescript\n * const { data, error } = await pos.listOrderActivity({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get order activity:\", error.message);\n * } else {\n * console.log(\"Activities found:\", data.content?.activity?.length || 0);\n * data.content?.activity?.forEach(activity => {\n * console.log(`${activity.created_at}: ${activity.activity_type} - ${activity.comment}`);\n * console.log(`By: ${activity.user_name} (${activity.user_type})`);\n * });\n * }\n * ```\n */\n public async listOrderActivity(\n pathParams: PosListOrderActivityPathParams\n ): Promise<ApiResult<PosListOrderActivityContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/activity\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Get order invoice (Admin)\n * @param pathParams - Order number\n * @param query - Optional format parameter\n * @returns Promise with order invoice\n * @example\n * ```typescript\n * // Get invoice as JSON\n * const { data, error } = await pos.getOrderInvoice(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"json\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get order invoice:\", error.message);\n * } else {\n * data.content?.invoices?.forEach(invoice => {\n * console.log(`Invoice: ${invoice.invoice_number}`);\n * console.log(`Date: ${invoice.invoice_date}`);\n * console.log(`Total: ${invoice.grand_total}`);\n * console.log(`Items:`, invoice.items);\n * });\n * }\n *\n * // Get invoice as PDF\n * const { data: pdfData, error: pdfError } = await pos.getOrderInvoice(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"pdf\" }\n * );\n * ```\n */\n public async getOrderInvoice(\n pathParams: PosGetOrderInvoicePathParams,\n query?: PosGetOrderInvoiceQuery\n ): Promise<ApiResult<PosGetOrderInvoiceContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/invoice\", {\n params: { path: pathParams, query },\n })\n );\n }\n\n /**\n * Get order receipt (Admin)\n * @param pathParams - Order number\n * @param query - Optional format parameter\n * @returns Promise with order receipt\n * @example\n * ```typescript\n * // Get receipt as JSON\n * const { data, error } = await pos.getOrderReceipt(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"json\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get order receipt:\", error.message);\n * } else {\n * const receipt = data.content?.order_receipt;\n * console.log(`Order: ${receipt?.order_number}`);\n * console.log(`Date: ${receipt?.order_date}`);\n * console.log(`Total: ${receipt?.grand_total}`);\n * console.log(`Items:`, receipt?.order_items);\n * console.log(`Payments:`, receipt?.payments);\n * }\n *\n * // Get receipt as PDF\n * const { data: pdfData, error: pdfError } = await pos.getOrderReceipt(\n * { order_number: \"ORD-2024-001234\" },\n * { format: \"pdf\" }\n * );\n * ```\n */\n public async getOrderReceipt(\n pathParams: PosGetOrderReceiptPathParams,\n query?: PosGetOrderReceiptQuery\n ): Promise<ApiResult<PosGetOrderReceiptContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/receipt\", {\n params: { path: pathParams, query },\n })\n );\n }\n\n /**\n * Get order shipments (Admin)\n * @param pathParams - Order number\n * @returns Promise with order shipments\n * @example\n * ```typescript\n * const { data, error } = await pos.getOrderShipments({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get order shipments:\", error.message);\n * } else {\n * const shipment = data.content?.shipment;\n * console.log(`Order: ${shipment?.order_number}`);\n * console.log(`Order Status: ${shipment?.order_status}`);\n * console.log(`Payment Status: ${shipment?.payment_status}`);\n * console.log(`Customer: ${shipment?.customer_name}`);\n * console.log(`Shipments:`, shipment?.shipments);\n * console.log(`Allowed Actions:`, shipment?.allowed_actions);\n * }\n * ```\n */\n public async getOrderShipments(\n pathParams: PosListOrderShipmentsPathParams\n ): Promise<ApiResult<PosListOrderShipmentsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/orders/{order_number}/shipments\", {\n params: { path: pathParams },\n })\n );\n }\n\n // ADMIN SHIPMENT ENDPOINTS\n\n /**\n * List all shipments (Admin)\n * @param query - Optional query parameters for filtering shipments\n * @returns Promise with list of shipments\n * @example\n * ```typescript\n * // Basic shipment listing\n * const { data, error } = await pos.listShipments();\n *\n * if (error) {\n * console.error(\"Failed to list shipments:\", error.message);\n * } else {\n * console.log(\"Shipments found:\", data.content?.shipments?.length || 0);\n * console.log(\"Pagination:\", data.content?.pagination);\n * data.content?.shipments?.forEach(shipment => {\n * console.log(`Shipment: ${shipment.shipment_number} - Status: ${shipment.status}`);\n * console.log(`Order: ${shipment.order_number} - AWB: ${shipment.awb_no}`);\n * });\n * }\n *\n * // With filters and search\n * const { data: filteredData, error: filteredError } = await pos.listShipments({\n * page: 1,\n * limit: 25,\n * search: \"SHIP-2024\",\n * filters: JSON.stringify({ \"status\": \"shipped\" }),\n * sort_by: JSON.stringify({ \"shipped_date\": \"desc\" })\n * });\n * ```\n */\n public async listShipments(\n query?: PosListShipmentsQuery\n ): Promise<ApiResult<PosListShipmentsContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/shipping/shipments\", {\n params: { query },\n })\n );\n }\n\n /**\n * Check inventory for order (Admin)\n * @param pathParams - Order number\n * @returns Promise with inventory check results\n * @example\n * ```typescript\n * const { data, error } = await pos.checkInventory({\n * order_number: \"ORD-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to check inventory:\", error.message);\n * } else {\n * const inventory = data.content;\n * console.log(`Inventory Status: ${inventory?.inventory_status}`);\n * console.log(`Shipment Items:`, inventory?.shipment_items);\n * console.log(`Recommended Warehouses:`, inventory?.recommended_warehouses);\n * console.log(`Inventory Detail:`, inventory?.inventory_detail);\n * console.log(`Allowed Actions:`, inventory?.allowed_action);\n * }\n * ```\n */\n public async checkInventory(\n pathParams: PosCheckOrderInventoryPathParams\n ): Promise<ApiResult<PosCheckOrderInventoryContent>> {\n return this.executeRequest(() =>\n this.adminClient.GET(\n \"/pos/orders/{order_number}/check-inventory\",\n {\n params: { path: pathParams },\n }\n )\n );\n }\n\n /**\n * Refund shortfall for order (Admin)\n * @param pathParams - Order number\n * @param body - Refund details\n * @returns Promise with refund confirmation\n * @example\n * ```typescript\n * const { data, error } = await pos.refundShortfall(\n * { order_number: \"ORD-2024-001234\" },\n * {\n * items: [\n * {\n * sku: \"SKU-123\",\n * quantity: 2,\n * free_quantity: 0\n * }\n * ],\n * payment_method: \"original-payment-mode\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to process refund:\", error.message);\n * } else {\n * console.log(\"Refund processed:\", data.message);\n * console.log(\"Success:\", data.success);\n * }\n *\n * // Refund to bank transfer\n * const { data: bankData, error: bankError } = await pos.refundShortfall(\n * { order_number: \"ORD-2024-001234\" },\n * {\n * items: [{ sku: \"SKU-123\", quantity: 1 }],\n * payment_method: \"bank-transfer\",\n * bank_account_id: \"BANK_ACC_123\"\n * }\n * );\n * ```\n */\n public async refundShortfall(\n pathParams: PosRefundShortfallPathParams,\n body: PosRefundShortfallBody\n ): Promise<ApiResult<PosRefundShortfallResponse>> {\n return this.executeRequest(() =>\n this.client.POST(\n \"/pos/shipping/shipments/{order_number}/refund-shortfall\",\n {\n params: { path: pathParams },\n body,\n }\n )\n );\n }\n\n /**\n * Get shipment details (Admin)\n * @param pathParams - Shipment reference number\n * @returns Promise with shipment details\n * @example\n * ```typescript\n * const { data, error } = await pos.getShipment({\n * reference_number: \"SHIP-2024-001234\"\n * });\n *\n * if (error) {\n * console.error(\"Failed to get shipment:\", error.message);\n * } else {\n * const shipment = data.content?.shipment;\n * console.log(`Order: ${shipment?.order_number}`);\n * console.log(`Shipments:`, shipment?.shipments);\n * shipment?.shipments?.forEach(s => {\n * console.log(` Shipment: ${s.shipment_number} - Status: ${s.status}`);\n * console.log(` AWB: ${s.awb_no} - Courier: ${s.courier_company_name}`);\n * console.log(` Items:`, s.shipment_items);\n * });\n * }\n * ```\n */\n public async getShipment(\n pathParams: PosGetShipmentDetailPathParams\n ): Promise<ApiResult<PosGetShipmentDetailContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/shipping/shipments/{reference_number}\", {\n params: { path: pathParams },\n })\n );\n }\n\n /**\n * Get shipment invoice (Admin)\n * @param pathParams - Shipment reference number\n * @param query - Optional format parameter\n * @returns Promise with shipment invoice\n * @example\n * ```typescript\n * // Get shipment invoice as JSON\n * const { data, error } = await pos.getShipmentInvoice(\n * { reference_number: \"SHIP-2024-001234\" },\n * { format: \"json\" }\n * );\n *\n * if (error) {\n * console.error(\"Failed to get shipment invoice:\", error.message);\n * } else {\n * const invoice = data.content?.invoice;\n * console.log(`Invoice: ${invoice?.invoice_number}`);\n * console.log(`Date: ${invoice?.invoice_date}`);\n * console.log(`Total: ${invoice?.grand_total}`);\n * console.log(`Items:`, invoice?.items);\n * }\n *\n * // Get shipment invoice as PDF\n * const { data: pdfData, error: pdfError } = await pos.getShipmentInvoice(\n * { reference_number: \"SHIP-2024-001234\" },\n * { format: \"pdf\" }\n * );\n * ```\n */\n public async getShipmentInvoice(\n pathParams: PosGetShipmentInvoicePathParams,\n query?: PosGetShipmentInvoiceQuery\n ): Promise<ApiResult<PosGetShipmentInvoiceContent>> {\n return this.executeRequest(() =>\n this.client.GET(\"/pos/shipping/shipments/{reference_number}/invoice\", {\n params: { path: pathParams, query },\n })\n );\n }\n\n /**\n * Update shipment details (Admin)\n * @param pathParams - Shipment reference number\n * @param body - Shipment update data\n * @returns Promise with updated shipment\n * @example\n * ```typescript\n * const { data, error } = await pos.updateShipment(\n * { reference_number: \"SHIP-2024-001234\" },\n * {\n * status: \"shipped\",\n * awb_no: \"AWB123456789\",\n * courier_company_name: \"BlueDart\",\n * shipping_label_url: \"https://example.com/label.pdf\",\n * tracking_url: \"https://tracking.example.com/AWB123456789\",\n * eta_delivery: \"2024-01-15T10:00:00Z\",\n * shipped_date: \"2024-01-10T14:30:00Z\"\n * }\n * );\n *\n * if (error) {\n * console.error(\"Failed to update shipment:\", error.message);\n * } else {\n * console.log(\"Shipment updated successfully:\", data.message);\n * const shipment = data.content?.shipment;\n * console.log(`Updated shipment status:`, shipment?.shipments?.[0]?.status);\n * }\n *\n * // Update delivery status\n * const { data: deliveryData, error: deliveryError } = await pos.updateShipment(\n * { reference_number: \"SHIP-2024-001234\" },\n * {\n * status: \"delivered\",\n * delivered_date: \"2024-01-15T16:45:00Z\"\n * }\n * );\n * ```\n */\n public async updateShipment(\n pathParams: PosUpdateShipmentPathParams,\n body: PosUpdateShipmentBody\n ): Promise<ApiResult<PosUpdateShipmentContent>> {\n return this.executeRequest(() =>\n this.client.PUT(\n \"/pos/shipping/shipments/{reference_number}/manual-update\",\n {\n params: { path: pathParams },\n body,\n }\n )\n );\n }\n}\n","import { PosAPIClient } from \"./lib/client\";\nimport { type BaseSDKOptions } from \"@commercengine/sdk-core\";\nimport { Environment } from \"./lib/utils/url\";\nimport { PosClient } from \"./lib/pos\";\nimport {\n type TokenStorage,\n MemoryTokenStorage,\n BrowserTokenStorage,\n} from \"./lib/middleware/auth\";\nimport {\n extractUserInfoFromToken,\n getUserIdFromToken,\n isUserLoggedIn,\n isUserAuthenticated,\n getLocationIdFromToken,\n getRoleFromToken,\n getTenantIdFromToken,\n type UserInfo,\n} from \"./lib/utils/jwt\";\nimport { ResponseUtils } from \"@commercengine/sdk-core\";\n\n/**\n * Supported default headers for POS API\n */\nexport interface SupportedDefaultHeaders {\n /**\n * Customer group ID used for pricing and promotions\n */\n customer_group_id?: string;\n /**\n * Debug mode header\n */\n debug_mode?: boolean;\n}\n\n/**\n * SDK initialization options for the POS API\n */\nexport interface PosSDKOptions extends BaseSDKOptions<SupportedDefaultHeaders> {\n /**\n * Store ID for the API requests\n */\n storeId: string;\n\n /**\n * Environment to use (defaults to Production)\n * Overrides baseUrl if provided\n */\n environment?: Environment;\n\n /**\n * Custom base URL (overrides environment if provided)\n * If not provided, will be built from storeId and environment\n */\n baseUrl?: string;\n\n /**\n * X-Api-Key for authentication endpoints that require API key\n * Required for login, pair-device, and verify-otp endpoints\n * Always required even when initializing with tokens (for refresh fallbacks)\n */\n apiKey: string;\n\n /**\n * Optional initial access token\n * - If tokenStorage is provided: Used as initial token value, then managed automatically\n * - If tokenStorage is not provided: Used for manual token management\n */\n accessToken?: string;\n\n /**\n * Optional initial refresh token\n * - Only used when tokenStorage is provided\n * - Allows initialization with both access and refresh tokens\n */\n refreshToken?: string;\n\n /**\n * Optional token storage for automatic token management\n * If provided, enables automatic token refresh and management\n */\n tokenStorage?: TokenStorage;\n\n /**\n * Callback when tokens are updated (login/refresh)\n */\n onTokensUpdated?: (accessToken: string, refreshToken: string) => void;\n\n /**\n * Callback when tokens are cleared (logout/error)\n */\n onTokensCleared?: () => void;\n}\n\n/**\n * Main SDK class for the POS API\n * Provides access to all POS endpoints through a single client\n */\nexport class PosSDK {\n /**\n * Client for all POS operations (auth, cart, orders, etc.)\n */\n public readonly pos: PosClient;\n\n /**\n * Create a new PosSDK instance\n *\n * @param options - Configuration options for the SDK\n */\n constructor(options: PosSDKOptions) {\n // Convert options to internal config format\n const config: PosSDKOptions = {\n storeId: options.storeId,\n environment: options.environment,\n baseUrl: options.baseUrl,\n accessToken: options.accessToken,\n refreshToken: options.refreshToken,\n apiKey: options.apiKey,\n timeout: options.timeout,\n tokenStorage: options.tokenStorage,\n onTokensUpdated: options.onTokensUpdated,\n onTokensCleared: options.onTokensCleared,\n defaultHeaders: options.defaultHeaders,\n debug: options.debug,\n logger: options.logger,\n };\n\n this.pos = new PosClient(config);\n }\n\n /**\n * Set authentication tokens for the client\n *\n * @param accessToken - The access token (required)\n * @param refreshToken - The refresh token (optional)\n *\n * Behavior:\n * - If tokenStorage is provided: Stores tokens for automatic management\n * - If tokenStorage is not provided: Only stores access token for manual management\n */\n public async setTokens(\n accessToken: string,\n refreshToken?: string\n ): Promise<void> {\n await this.pos.setTokens(accessToken, refreshToken);\n }\n\n /**\n * Clear all authentication tokens from the client\n *\n * Behavior:\n * - If tokenStorage is provided: Clears both access and refresh tokens from storage\n * - If tokenStorage is not provided: Clears the manual access token\n */\n public async clearTokens(): Promise<void> {\n await this.pos.clearTokens();\n }\n\n /**\n * Set the API key for the client\n *\n * @param apiKey - The API key to set\n */\n public setApiKey(apiKey: string): void {\n this.pos.setApiKey(apiKey);\n }\n\n /**\n * Get the current access token if available\n */\n public async getAccessToken(): Promise<string | null> {\n const header = await this.pos.getAuthorizationHeader();\n return header.startsWith(\"Bearer \") ? header.substring(7) : null;\n }\n\n /**\n * Set default headers for the client\n *\n * @param headers - Default headers to set\n */\n public setDefaultHeaders(headers: SupportedDefaultHeaders): void {\n this.pos.setDefaultHeaders(headers);\n }\n\n /**\n * Get current default headers\n */\n public getDefaultHeaders(): SupportedDefaultHeaders | undefined {\n return this.pos.getDefaultHeaders();\n }\n\n /**\n * Get user information from the current access token\n *\n * @returns User information extracted from JWT token, or null if no token or invalid token\n */\n public async getUserInfo(): Promise<UserInfo | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return extractUserInfoFromToken(token);\n }\n\n /**\n * Get the current user ID from the access token\n *\n * @returns User ID (ulid) or null if no token or invalid token\n */\n public async getUserId(): Promise<string | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getUserIdFromToken(token);\n }\n\n /**\n * Check if the current user is logged in\n *\n * @returns True if user is logged in, false otherwise\n */\n public async isLoggedIn(): Promise<boolean> {\n const token = await this.getAccessToken();\n if (!token) return false;\n return isUserLoggedIn(token);\n }\n\n /**\n * Check if the current user is authenticated with POS access\n * This verifies the user has valid device and role information\n *\n * @returns True if user is authenticated for POS operations\n */\n public async isAuthenticated(): Promise<boolean> {\n const token = await this.getAccessToken();\n if (!token) return false;\n return isUserAuthenticated(token);\n }\n\n /**\n * Get the location ID from the current access token\n * This is commonly needed for POS API requests\n *\n * @returns Location ID or null if no token or invalid token\n */\n public async getLocationId(): Promise<string | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getLocationIdFromToken(token);\n }\n\n /**\n * Get the role information from the current access token\n *\n * @returns Role object with roleId, roleName, locationId, and locationName, or null if no token or invalid token\n */\n public async getRole(): Promise<{\n roleId: string;\n roleName: string;\n locationId: string;\n locationName: string;\n } | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getRoleFromToken(token);\n }\n\n /**\n * Get the tenant ID from the current access token\n *\n * @returns Tenant ID or null if no token or invalid token\n */\n public async getTenantId(): Promise<string | null> {\n const token = await this.getAccessToken();\n if (!token) return null;\n return getTenantIdFromToken(token);\n }\n}\n\n// Export the main SDK class as default\nexport default PosSDK;\n\n// Export individual clients for advanced usage\nexport { PosAPIClient, PosClient, ResponseUtils };\n\n// Export environment enum\nexport { Environment } from \"./lib/utils/url\";\n\n// Export token storage types\nexport type { TokenStorage };\nexport { MemoryTokenStorage, BrowserTokenStorage };\n\n// Export ALL types from sdk-core\nexport type * from \"@commercengine/sdk-core\";\n\n// Export POS-specific JWT types\nexport type { UserInfo } from \"./lib/utils/jwt\";\n\n// Export API types for consumer usage\nexport type { components, operations, paths } from \"./types/pos\";\nexport type * from \"./types/pos-api-types\";\n"],"mappings":"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"}
|