@commercengine/storefront-sdk 0.10.0 → 0.10.2

package/dist/index.js

@@ -43,16 +43,14 @@ var ResponseUtils = class {
 	* Note: This can only be called once per response
 	*/
 	static async getText(response) {
-		const cloned = response.clone();
-		return await cloned.text();
+		return await response.clone().text();
 	}
 	/**
 	* Clone and read response as JSON (useful for debugging)
 	* Note: This can only be called once per response
 	*/
 	static async getJSON(response) {
-		const cloned = response.clone();
-		return await cloned.json();
+		return await response.clone().json();
 	}
 	/**
 	* Format response information for debugging
@@ -297,7 +295,7 @@ async function executeRequest(apiCall) {
 			status: 0,
 			statusText: "Network Error"
 		});
-		const errorResult = {
+		return {
 			data: null,
 			error: {
 				success: false,
@@ -307,7 +305,6 @@ async function executeRequest(apiCall) {
 			},
 			response: mockResponse
 		};
-		return errorResult;
 	}
 }
 /**
@@ -395,15 +392,6 @@ var BaseAPIClient = class {
 	getDefaultHeaders() {
 		return this.config.defaultHeaders;
 	}
-	/**
-	* Add middleware to the client
-	* This allows SDK extensions to add custom middleware like authentication
-	*
-	* @param middleware - Middleware to add to the client
-	*/
-	use(middleware) {
-		this.client.use(middleware);
-	}
 };
 /**
 * Generic URL utility functions for any SDK
@@ -414,8 +402,7 @@ var BaseAPIClient = class {
 */
 function getPathnameFromUrl(url) {
 	try {
-		const urlObj = new URL(url);
-		return urlObj.pathname;
+		return new URL(url).pathname;
 	} catch {
 		return url.split("?")[0] || url;
 	}
@@ -465,9 +452,7 @@ function isTokenExpired(token, bufferSeconds = 30) {
 	try {
 		const payload = decodeJwt(token);
 		if (!payload.exp) return true;
-		const currentTime = Math.floor(Date.now() / 1e3);
-		const expiryTime = payload.exp;
-		return currentTime >= expiryTime - bufferSeconds;
+		return Math.floor(Date.now() / 1e3) >= payload.exp - bufferSeconds;
 	} catch (error) {
 		console.warn("Failed to decode JWT token:", error);
 		return true;
@@ -480,8 +465,7 @@ function isTokenExpired(token, bufferSeconds = 30) {
 * @returns User ID (ulid) or null if token is invalid
 */
 function getUserIdFromToken(token) {
-	const userInfo = extractUserInfoFromToken(token);
-	return userInfo?.id || null;
+	return extractUserInfoFromToken(token)?.id || null;
 }
 /**
 * Check if user is logged in based on JWT token
@@ -490,8 +474,7 @@ function getUserIdFromToken(token) {
 * @returns True if user is logged in, false otherwise
 */
 function isUserLoggedIn(token) {
-	const userInfo = extractUserInfoFromToken(token);
-	return userInfo?.isLoggedIn || false;
+	return extractUserInfoFromToken(token)?.isLoggedIn || false;
 }
 /**
 * Check if user is anonymous based on JWT token
@@ -500,8 +483,7 @@ function isUserLoggedIn(token) {
 * @returns True if user is anonymous, false otherwise
 */
 function isUserAnonymous(token) {
-	const userInfo = extractUserInfoFromToken(token);
-	return userInfo?.isAnonymous || true;
+	return extractUserInfoFromToken(token)?.isAnonymous || true;
 }
 
 //#endregion
@@ -516,14 +498,13 @@ function isAnonymousAuthEndpoint(pathname) {
 * Check if a URL path is a login/register endpoint that returns tokens
 */
 function isTokenReturningEndpoint(pathname) {
-	const tokenEndpoints = [
+	return [
 		"/auth/login/password",
 		"/auth/register/phone",
 		"/auth/register/email",
 		"/auth/verify-otp",
 		"/auth/refresh-token"
-	];
-	return tokenEndpoints.some((endpoint) => pathname.endsWith(endpoint));
+	].some((endpoint) => pathname.endsWith(endpoint));
 }
 /**
 * Check if a URL path is the logout endpoint
@@ -626,8 +607,7 @@ var CookieTokenStorage = class {
 	}
 	getCookie(name) {
 		if (typeof document === "undefined") return null;
-		const value = `; ${document.cookie}`;
-		const parts = value.split(`; ${name}=`);
+		const parts = `; ${document.cookie}`.split(`; ${name}=`);
 		if (parts.length === 2) {
 			const cookieValue = parts.pop()?.split(";").shift();
 			return cookieValue ? decodeURIComponent(cookieValue) : null;
@@ -636,8 +616,7 @@ var CookieTokenStorage = class {
 	}
 	setCookie(name, value) {
 		if (typeof document === "undefined") return;
-		const encodedValue = encodeURIComponent(value);
-		let cookieString = `${name}=${encodedValue}`;
+		let cookieString = `${name}=${encodeURIComponent(value)}`;
 		if (this.options.maxAge) cookieString += `; Max-Age=${this.options.maxAge}`;
 		if (this.options.path) cookieString += `; Path=${this.options.path}`;
 		if (this.options.domain) cookieString += `; Domain=${this.options.domain}`;
@@ -689,8 +668,7 @@ function createAuthMiddleware(config) {
 						body: JSON.stringify({ refresh_token: refreshToken })
 					});
 					if (!response.ok) throw new Error(`Token refresh failed: ${response.status}`);
-					const data = await response.json();
-					newTokens = data.content;
+					newTokens = (await response.json()).content;
 				}
 				else {
 					const currentAccessToken = await config.tokenStorage.getAccessToken();
@@ -705,8 +683,7 @@ function createAuthMiddleware(config) {
 						}
 					});
 					if (!response.ok) throw new Error(`Anonymous token fallback failed: ${response.status}`);
-					const data = await response.json();
-					newTokens = data.content;
+					newTokens = (await response.json()).content;
 					console.info(`Token refreshed via anonymous fallback (${reason}) - user may need to re-authenticate for privileged operations`);
 				}
 				await config.tokenStorage.setAccessToken(newTokens.access_token);
@@ -752,8 +729,7 @@ function createAuthMiddleware(config) {
 					}
 				});
 				if (response.ok) {
-					const data = await response.json();
-					const tokens = data.content;
+					const tokens = (await response.json()).content;
 					if (tokens?.access_token && tokens?.refresh_token) {
 						await config.tokenStorage.setAccessToken(tokens.access_token);
 						await config.tokenStorage.setRefreshToken(tokens.refresh_token);
@@ -776,8 +752,7 @@ function createAuthMiddleware(config) {
 			const pathname = getPathnameFromUrl(request.url);
 			if (response.ok) {
 				if (isTokenReturningEndpoint(pathname) || isAnonymousAuthEndpoint(pathname)) try {
-					const data = await response.clone().json();
-					const content = data.content;
+					const content = (await response.clone().json()).content;
 					if (content?.access_token && content?.refresh_token) {
 						await config.tokenStorage.setAccessToken(content.access_token);
 						await config.tokenStorage.setRefreshToken(content.refresh_token);
@@ -813,9 +788,8 @@ function createAuthMiddleware(config) {
 * Helper function to create auth middleware with sensible defaults
 */
 function createDefaultAuthMiddleware(options) {
-	const tokenStorage = options.tokenStorage || (typeof localStorage !== "undefined" ? new BrowserTokenStorage() : new MemoryTokenStorage());
 	return createAuthMiddleware({
-		tokenStorage,
+		tokenStorage: options.tokenStorage || (typeof localStorage !== "undefined" ? new BrowserTokenStorage() : new MemoryTokenStorage()),
 		apiKey: options.apiKey,
 		baseUrl: options.baseUrl,
 		onTokensUpdated: options.onTokensUpdated,
@@ -847,8 +821,7 @@ let Environment = /* @__PURE__ */ function(Environment$1) {
 */
 function buildStorefrontURL(config) {
 	if (config.baseUrl) return config.baseUrl;
-	const env = config.environment || Environment.Production;
-	switch (env) {
+	switch (config.environment || Environment.Production) {
 		case Environment.Staging: return `https://staging.api.commercengine.io/api/v1/${config.storeId}/storefront`;
 		case Environment.Production:
 		default: return `https://prod.api.commercengine.io/api/v1/${config.storeId}/storefront`;
@@ -875,14 +848,16 @@ var StorefrontAPIClient = class extends BaseAPIClient {
 			environment: config.environment,
 			baseUrl: config.baseUrl
 		});
-		const headerTransformations = { customer_group_id: "x-customer-group-id" };
 		super({
 			baseUrl,
 			timeout: config.timeout,
 			defaultHeaders: config.defaultHeaders,
 			debug: config.debug,
 			logger: config.logger
-		}, baseUrl, headerTransformations);
+		}, baseUrl, {
+			customer_group_id: "x-customer-group-id",
+			debug_mode: "x-debug-mode"
+		});
 		this.config = { ...config };
 		this.setupStorefrontAuth();
 	}
@@ -906,8 +881,7 @@ var StorefrontAPIClient = class extends BaseAPIClient {
 				config.refreshToken = void 0;
 			}
 		} else this.client.use({ onRequest: async ({ request }) => {
-			const pathname = getPathnameFromUrl(request.url);
-			if (isAnonymousAuthEndpoint(pathname)) {
+			if (isAnonymousAuthEndpoint(getPathnameFromUrl(request.url))) {
 				if (config.apiKey) request.headers.set("X-Api-Key", config.apiKey);
 				if (config.accessToken) request.headers.set("Authorization", `Bearer ${config.accessToken}`);
 				return request;
@@ -1152,10 +1126,11 @@ var CatalogClient = class extends StorefrontAPIClient {
 	* console.log("Product with custom pricing:", slugData.product.price);
 	* ```
 	*/
-	async getProductDetail(pathParams, headers) {
+	async getProductDetail(pathParams, options, headers) {
 		const mergedHeaders = this.mergeHeaders(headers);
 		return this.executeRequest(() => this.client.GET("/catalog/products/{product_id_or_slug}", { params: {
 			path: pathParams,
+			query: options,
 			header: mergedHeaders
 		} }));
 	}
@@ -1192,10 +1167,11 @@ var CatalogClient = class extends StorefrontAPIClient {
 	* );
 	* ```
 	*/
-	async listProductVariants(pathParams, headers) {
+	async listProductVariants(pathParams, options, headers) {
 		const mergedHeaders = this.mergeHeaders(headers);
 		return this.executeRequest(() => this.client.GET("/catalog/products/{product_id}/variants", { params: {
 			path: pathParams,
+			query: options,
 			header: mergedHeaders
 		} }));
 	}
@@ -1226,10 +1202,11 @@ var CatalogClient = class extends StorefrontAPIClient {
 	* console.log("Stock:", data.variant.stock);
 	* ```
 	*/
-	async getVariantDetail(pathParams, headers) {
+	async getVariantDetail(pathParams, options, headers) {
 		const mergedHeaders = this.mergeHeaders(headers);
 		return this.executeRequest(() => this.client.GET("/catalog/products/{product_id}/variants/{variant_id}", { params: {
 			path: pathParams,
+			query: options,
 			header: mergedHeaders
 		} }));
 	}
@@ -1902,31 +1879,32 @@ var CartClient = class extends StorefrontAPIClient {
 		}));
 	}
 	/**
-	* Update shipping method
+	* Update fulfillment preference
 	*
 	* @param cartId - The ID of the cart
 	* @param body - The body of the request
 	* @returns Promise with updated cart
 	* @example
 	* ```typescript
-	* const { data, error } = await sdk.cart.updateShippingMethod(
+	* const { data, error } = await sdk.cart.updateFulfillmentPreference(
 	*   { id: "01H9CART12345ABCDE" },
 	*   {
-	*     shipping_method_id: "01H9SHIP12345FAST",
-	*     estimated_delivery_date: "2024-01-15"
+	*     fulfillment_type: "delivery",
+	*     shipping_provider_id: "01H9SHIP12345FAST",
+	*     courier_company_id: "01H9COY12345FAST", // Optional
 	*   }
 	* );
 	*
 	* if (error) {
-	*   console.error("Failed to update shipping method:", error.message);
+	*   console.error("Failed to update fulfillment preference:", error.message);
 	* } else {
-	*   console.log("Shipping method updated:", data.cart.shipping_method?.name);
-	*   console.log("Shipping cost:", data.cart.shipping_cost);
+	*   console.log("Fulfillment preference updated:", data.cart.fulfillment_preference?.fulfillment_type);
+	*   console.log("Shipping cost:", data.cart.shipping_amount);
 	* }
 	* ```
 	*/
-	async updateShippingMethod(cartId, body) {
-		return this.executeRequest(() => this.client.POST("/carts/{id}/shipping-method", {
+	async updateFulfillmentPreference(cartId, body) {
+		return this.executeRequest(() => this.client.POST("/carts/{id}/fulfillment-preference", {
 			params: { path: cartId },
 			body
 		}));
@@ -2241,8 +2219,12 @@ var AuthClient = class extends StorefrontAPIClient {
 	* }
 	* ```
 	*/
-	async loginWithPhone(body) {
-		return this.executeRequest(() => this.client.POST("/auth/login/phone", { body }));
+	async loginWithPhone(body, headers) {
+		const mergedHeaders = this.mergeHeaders(headers);
+		return this.executeRequest(() => this.client.POST("/auth/login/phone", {
+			body,
+			params: { header: mergedHeaders }
+		}));
 	}
 	/**
 	* Login with WhatsApp
@@ -2266,8 +2248,12 @@ var AuthClient = class extends StorefrontAPIClient {
 	* }
 	* ```
 	*/
-	async loginWithWhatsApp(body) {
-		return this.executeRequest(() => this.client.POST("/auth/login/whatsapp", { body }));
+	async loginWithWhatsApp(body, headers) {
+		const mergedHeaders = this.mergeHeaders(headers);
+		return this.executeRequest(() => this.client.POST("/auth/login/whatsapp", {
+			body,
+			params: { header: mergedHeaders }
+		}));
 	}
 	/**
 	* Login with email
@@ -2291,8 +2277,12 @@ var AuthClient = class extends StorefrontAPIClient {
 	* }
 	* ```
 	*/
-	async loginWithEmail(body) {
-		return this.executeRequest(() => this.client.POST("/auth/login/email", { body }));
+	async loginWithEmail(body, headers) {
+		const mergedHeaders = this.mergeHeaders(headers);
+		return this.executeRequest(() => this.client.POST("/auth/login/email", {
+			body,
+			params: { header: mergedHeaders }
+		}));
 	}
 	/**
 	* Login with password
@@ -2816,8 +2806,12 @@ var AuthClient = class extends StorefrontAPIClient {
 	* }
 	* ```
 	*/
-	async generateOtp(body) {
-		return this.executeRequest(() => this.client.POST("/auth/generate-otp", { body }));
+	async generateOtp(body, headers) {
+		const mergedHeaders = this.mergeHeaders(headers);
+		return this.executeRequest(() => this.client.POST("/auth/generate-otp", {
+			body,
+			params: { header: mergedHeaders }
+		}));
 	}
 	/**
 	* Check whether email or phone is already verified
@@ -3147,40 +3141,6 @@ var OrderClient = class extends StorefrontAPIClient {
 * Client for interacting with shipping endpoints
 */
 var ShippingClient = class extends StorefrontAPIClient {
-	/**
-	* Get shipping options for an order
-	*
-	* @param body - Shipping methods body
-	* @returns Promise with shipping options
-	* @example
-	* ```typescript
-	* const { data, error } = await sdk.shipping.getShippingMethods({
-	*   delivery_pincode: "400001",
-	*   cart_id: "cart_01H9XYZ12345ABCDE"
-	* });
-	*
-	* if (error) {
-	*   console.error("Failed to get shipping methods:", error.message);
-	* } else {
-	*   console.log("Is serviceable:", data.is_serviceable);
-	*   console.log("Available shipping methods:", data.shipping_methods?.length || 0);
-	*
-	*   data.shipping_methods?.forEach(method => {
-	*     console.log(`Method: ${method.name} (${method.shipping_type})`);
-	*     console.log(`Shipping cost: ${method.shipping_amount}`);
-	*     console.log(`Estimated delivery: ${method.estimated_delivery_days} days`);
-	*
-	*     method.courier_companies?.forEach(courier => {
-	*       console.log(`  - ${courier.name}: ${courier.shipping_amount} (${courier.mode})`);
-	*       console.log(`    Rating: ${courier.rating}/5, Recommended: ${courier.is_recommended}`);
-	*     });
-	*   });
-	* }
-	* ```
-	*/
-	async getShippingMethods(body) {
-		return this.executeRequest(() => this.client.POST("/shipping/shipping-methods", { body }));
-	}
 	/**
 	* Check pincode deliverability
 	*
@@ -3208,6 +3168,47 @@ var ShippingClient = class extends StorefrontAPIClient {
 	async checkPincodeDeliverability(pathParams) {
 		return this.executeRequest(() => this.client.GET("/shipping/serviceability/{pincode}", { params: { path: pathParams } }));
 	}
+	/**
+	* Get fulfillment options for an order
+	*
+	* @param body - Fulfillment options body containing cart_id and delivery_pincode
+	* @returns Promise with fulfillment options including collect and delivery methods
+	* @example
+	* ```typescript
+	* const { data, error } = await sdk.shipping.getFulfillmentOptions({
+	*   cart_id: "cart_01H9XYZ12345ABCDE",
+	*   delivery_pincode: "400001"
+	* });
+	*
+	* if (error) {
+	*   console.error("Failed to get fulfillment options:", error.message);
+	* } else {
+	*   // Check summary information
+	*   console.log("Collect available:", data.summary.collect_available);
+	*   console.log("Deliver available:", data.summary.deliver_available);
+	*   console.log("Recommended fulfillment type:", data.summary.recommended_fulfillment_type);
+	*
+	*   // Access collect options
+	*   if (data.collect && data.collect.length > 0) {
+	*     console.log("Available stores for collection:");
+	*     data.collect.forEach(store => {
+	*       console.log(`${store.name} - ${store.distance_km}km away, ETA: ${store.collect_eta_minutes} minutes`);
+	*     });
+	*   }
+	*
+	*   // Access delivery options
+	*   if (data.deliver && data.deliver.is_serviceable) {
+	*     console.log("Available shipping methods:");
+	*     data.deliver.shipping_methods.forEach(method => {
+	*       console.log(`${method.name} - ${method.shipping_amount}, ${method.estimated_delivery_days} days`);
+	*     });
+	*   }
+	* }
+	* ```
+	*/
+	async getFulfillmentOptions(body) {
+		return this.executeRequest(() => this.client.POST("/shipping/fulfillment-options", { body }));
+	}
 };
 
 //#endregion
@@ -3644,6 +3645,29 @@ var CustomerClient = class extends StorefrontAPIClient {
 	async listCustomerReviews(pathParams) {
 		return this.executeRequest(() => this.client.GET("/customers/{user_id}/reviews", { params: { path: pathParams } }));
 	}
+	/**
+	* List all saved payment methods for a customer
+	*
+	* @param pathParams - Path parameters
+	* @returns Promise with payment methods
+	*
+	* @example
+	* ```typescript
+	* const { data, error } = await sdk.customer.listSavedPaymentMethods({
+	*   customer_id: "customer_123"
+	* });
+	*
+	* if (error) {
+	*   console.error("Failed to list saved payment methods:", error);
+	*   return;
+	* }
+	*
+	* console.log("Saved payment methods:", data.saved_payment_methods);
+	* ```
+	*/
+	async listSavedPaymentMethods(pathParams) {
+		return this.executeRequest(() => this.client.GET("/customers/{customer_id}/payment-methods", { params: { path: pathParams } }));
+	}
 };
 
 //#endregion
@@ -3869,8 +3893,7 @@ var StorefrontSDK = class {
 	* @returns Customer ID or null if no token, invalid token, or user has no customer ID
 	*/
 	async getCustomerId() {
-		const userInfo = await this.getUserInfo();
-		return userInfo?.customerId || null;
+		return (await this.getUserInfo())?.customerId || null;
 	}
 	/**
 	* Get the customer group ID from the current access token
@@ -3878,8 +3901,7 @@ var StorefrontSDK = class {
 	* @returns Customer group ID or null if no token, invalid token, or user has no customer group
 	*/
 	async getCustomerGroupId() {
-		const userInfo = await this.getUserInfo();
-		return userInfo?.customerGroupId || null;
+		return (await this.getUserInfo())?.customerGroupId || null;
 	}
 	/**
 	* Set default headers for all clients