@commercengine/storefront-sdk 0.8.1 → 0.9.0

package/dist/index.js

@@ -1,4 +1,4 @@
-import createClient from "openapi-fetch";
+import { BaseAPIClient, ResponseUtils, getPathnameFromUrl } from "@commercengine/sdk-core";
 import { decodeJwt } from "jose";
 
 //#region src/lib/jwt-utils.ts
@@ -85,17 +85,6 @@ function isUserAnonymous(token) {
 //#endregion
 //#region src/lib/auth-utils.ts
 /**
-* Extract pathname from URL
-*/
-function getPathnameFromUrl(url) {
-	try {
-		const urlObj = new URL(url);
-		return urlObj.pathname;
-	} catch {
-		return url.split("?")[0];
-	}
-}
-/**
 * Check if a URL path is an auth endpoint that should use API key
 */
 function isAnonymousAuthEndpoint(pathname) {
@@ -413,236 +402,12 @@ function createDefaultAuthMiddleware(options) {
 }
 
 //#endregion
-//#region src/lib/logger-utils.ts
+//#region src/lib/url-utils.ts
 /**
-* Response utilities for debugging and working with Response objects
+* URL utility functions for the Storefront SDK
 */
-var ResponseUtils = class {
-	/**
-	* Get response headers as a plain object
-	*/
-	static getHeaders(response) {
-		return Object.fromEntries(response.headers.entries());
-	}
-	/**
-	* Get specific header value
-	*/
-	static getHeader(response, name) {
-		return response.headers.get(name);
-	}
-	/**
-	* Check if response was successful
-	*/
-	static isSuccess(response) {
-		return response.ok;
-	}
-	/**
-	* Get response metadata
-	*/
-	static getMetadata(response) {
-		return {
-			status: response.status,
-			statusText: response.statusText,
-			ok: response.ok,
-			url: response.url,
-			redirected: response.redirected,
-			type: response.type,
-			headers: Object.fromEntries(response.headers.entries())
-		};
-	}
-	/**
-	* Clone and read response as text (useful for debugging)
-	* Note: This can only be called once per response
-	*/
-	static async getText(response) {
-		const cloned = response.clone();
-		return await cloned.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();
-	}
-	/**
-	* Format response information for debugging
-	*/
-	static format(response) {
-		const metadata = this.getMetadata(response);
-		return `${metadata.status} ${metadata.statusText} - ${metadata.url}`;
-	}
-};
 /**
-* Debug logging utilities
-*/
-var DebugLogger = class {
-	logger;
-	responseTextCache = /* @__PURE__ */ new Map();
-	constructor(logger) {
-		this.logger = logger || ((level, message, data) => {
-			console.log(`[${level.toUpperCase()}]`, message);
-			if (data) console.log(data);
-		});
-	}
-	/**
-	* Log debug information about API request
-	*/
-	logRequest(request, requestBody) {
-		this.logger("info", "API Request Debug Info", {
-			method: request.method,
-			url: request.url,
-			headers: Object.fromEntries(request.headers.entries()),
-			body: requestBody,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString()
-		});
-	}
-	/**
-	* Log debug information about API response
-	*/
-	async logResponse(response, responseBody) {
-		if (responseBody && typeof responseBody === "string") this.responseTextCache.set(response.url, responseBody);
-		this.logger("info", "API Response Debug Info", {
-			url: response.url,
-			status: response.status,
-			statusText: response.statusText,
-			ok: response.ok,
-			headers: Object.fromEntries(response.headers.entries()),
-			redirected: response.redirected,
-			type: response.type,
-			timestamp: (/* @__PURE__ */ new Date()).toISOString()
-		});
-		if (responseBody) this.logger("info", "API Response Data", {
-			data: responseBody,
-			contentType: response.headers.get("content-type"),
-			contentLength: response.headers.get("content-length")
-		});
-	}
-	/**
-	* Log error information
-	*/
-	logError(message, error) {
-		this.logger("error", message, error);
-	}
-	/**
-	* Get cached response text for a URL (if available)
-	*/
-	getCachedResponseText(url) {
-		return this.responseTextCache.get(url) || null;
-	}
-	/**
-	* Clear cached response texts
-	*/
-	clearCache() {
-		this.responseTextCache.clear();
-	}
-};
-/**
-* Extract request body for logging
-*/
-async function extractRequestBody(request) {
-	if (request.method === "GET" || request.method === "HEAD") return null;
-	try {
-		const clonedRequest = request.clone();
-		const contentType = request.headers.get("content-type")?.toLowerCase();
-		if (contentType?.startsWith("application/json")) return await clonedRequest.json();
-		else if (contentType?.startsWith("multipart/form-data")) return "[FormData - cannot display]";
-		else if (contentType?.startsWith("text/")) return await clonedRequest.text();
-		return "[Request body - unknown format]";
-	} catch (error) {
-		return "[Request body unavailable]";
-	}
-}
-/**
-* Create debug middleware for openapi-fetch (internal use)
-*/
-function createDebugMiddleware(logger) {
-	const debugLogger = new DebugLogger(logger);
-	return {
-		async onRequest({ request }) {
-			const requestBody = await extractRequestBody(request);
-			debugLogger.logRequest(request, requestBody);
-			return request;
-		},
-		async onResponse({ response }) {
-			const cloned = response.clone();
-			let responseBody = null;
-			try {
-				const contentType = response.headers.get("content-type")?.toLowerCase();
-				if (contentType?.startsWith("application/json")) responseBody = await cloned.json();
-				else if (contentType?.startsWith("text/")) responseBody = await cloned.text();
-			} catch (error) {}
-			await debugLogger.logResponse(response, responseBody);
-			return response;
-		},
-		async onError({ error, request }) {
-			debugLogger.logError("API Request Failed", {
-				error: {
-					name: error instanceof Error ? error.name : "Unknown",
-					message: error instanceof Error ? error.message : String(error),
-					stack: error instanceof Error ? error.stack : void 0
-				},
-				request: {
-					method: request.method,
-					url: request.url,
-					headers: Object.fromEntries(request.headers.entries())
-				},
-				timestamp: (/* @__PURE__ */ new Date()).toISOString()
-			});
-			throw error;
-		}
-	};
-}
-
-//#endregion
-//#region src/lib/header-utils.ts
-/**
-* Mapping of SDK header parameter names to actual HTTP header names
-* Only include headers that need transformation - others pass through as-is
-*/
-const HEADER_TRANSFORMATIONS = { customer_group_id: "x-customer-group-id" };
-/**
-* Transform SDK header parameters to actual HTTP header names
-* Headers not in the transformation map are passed through unchanged
-*
-* @param headers - Headers object with SDK parameter names
-* @returns Headers object with actual HTTP header names
-*/
-function transformHeaders(headers) {
-	const transformed = {};
-	for (const [key, value] of Object.entries(headers)) if (value !== void 0) {
-		const headerName = HEADER_TRANSFORMATIONS[key] || key;
-		transformed[headerName] = value;
-	}
-	return transformed;
-}
-/**
-* Merge default headers with method-level headers
-* Method-level headers take precedence over default headers
-* Automatically transforms SDK parameter names to HTTP header names
-*
-* @param defaultHeaders - Default headers from SDK configuration
-* @param methodHeaders - Headers passed to the specific method call
-* @returns Merged headers object with proper HTTP header names
-*/
-function mergeHeaders(defaultHeaders, methodHeaders) {
-	const merged = {};
-	if (defaultHeaders) {
-		const transformedDefaults = transformHeaders(defaultHeaders);
-		Object.assign(merged, transformedDefaults);
-	}
-	if (methodHeaders) Object.assign(merged, methodHeaders);
-	Object.keys(merged).forEach((key) => {
-		if (merged[key] === void 0) delete merged[key];
-	});
-	return merged;
-}
-
-//#endregion
-//#region src/lib/client.ts
-/**
-* Available API environments
+* Available API environments for Commerce Engine
 */
 let Environment = /* @__PURE__ */ function(Environment$1) {
 	/**
@@ -656,12 +421,26 @@ let Environment = /* @__PURE__ */ function(Environment$1) {
 	return Environment$1;
 }({});
 /**
-* Base API client for Storefront API
+* Build base URL for Storefront API
+*/
+function buildStorefrontURL(config) {
+	if (config.baseUrl) return config.baseUrl;
+	const env = config.environment || Environment.Production;
+	switch (env) {
+		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`;
+	}
+}
+
+//#endregion
+//#region src/lib/client.ts
+/**
+* Storefront API client that extends the generic BaseAPIClient
+* Adds Commerce Engine specific authentication and token management
 */
-var StorefrontAPIClient = class {
-	client;
+var StorefrontAPIClient = class extends BaseAPIClient {
 	config;
-	baseUrl;
 	initializationPromise = null;
 	/**
 	* Create a new StorefrontAPIClient
@@ -669,74 +448,51 @@ var StorefrontAPIClient = class {
 	* @param config - Configuration for the API client
 	*/
 	constructor(config) {
+		const baseUrl = buildStorefrontURL({
+			storeId: config.storeId,
+			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);
 		this.config = { ...config };
-		this.baseUrl = this.getBaseUrlFromConfig(this.config);
-		this.client = createClient({ baseUrl: this.baseUrl });
-		if (this.config.tokenStorage) {
+		this.setupStorefrontAuth();
+	}
+	/**
+	* Set up Storefront-specific authentication middleware
+	*/
+	setupStorefrontAuth() {
+		const config = this.config;
+		if (config.tokenStorage) {
 			const authMiddleware = createDefaultAuthMiddleware({
-				apiKey: this.config.apiKey,
-				baseUrl: this.baseUrl,
-				tokenStorage: this.config.tokenStorage,
-				onTokensUpdated: this.config.onTokensUpdated,
-				onTokensCleared: this.config.onTokensCleared
+				apiKey: config.apiKey,
+				baseUrl: this.getBaseUrl(),
+				tokenStorage: config.tokenStorage,
+				onTokensUpdated: config.onTokensUpdated,
+				onTokensCleared: config.onTokensCleared
 			});
 			this.client.use(authMiddleware);
-			if (this.config.accessToken) {
-				this.initializationPromise = this.initializeTokens(this.config.accessToken, this.config.refreshToken);
-				this.config.accessToken = void 0;
-				this.config.refreshToken = void 0;
+			if (config.accessToken) {
+				this.initializationPromise = this.initializeTokens(config.accessToken, config.refreshToken);
+				config.accessToken = void 0;
+				config.refreshToken = void 0;
 			}
 		} else this.client.use({ onRequest: async ({ request }) => {
 			const pathname = getPathnameFromUrl(request.url);
 			if (isAnonymousAuthEndpoint(pathname)) {
-				if (this.config.apiKey) request.headers.set("X-Api-Key", this.config.apiKey);
-				if (this.config.accessToken) request.headers.set("Authorization", `Bearer ${this.config.accessToken}`);
+				if (config.apiKey) request.headers.set("X-Api-Key", config.apiKey);
+				if (config.accessToken) request.headers.set("Authorization", `Bearer ${config.accessToken}`);
 				return request;
 			}
-			if (this.config.accessToken) request.headers.set("Authorization", `Bearer ${this.config.accessToken}`);
+			if (config.accessToken) request.headers.set("Authorization", `Bearer ${config.accessToken}`);
 			return request;
 		} });
-		if (this.config.timeout) this.setupTimeoutMiddleware();
-		if (this.config.debug) {
-			const debugMiddleware = createDebugMiddleware(this.config.logger);
-			this.client.use(debugMiddleware);
-		}
-	}
-	/**
-	* Set up timeout middleware
-	*/
-	setupTimeoutMiddleware() {
-		this.client.use({ onRequest: async ({ request }) => {
-			const controller = new AbortController();
-			const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
-			if (request.signal) request.signal.addEventListener("abort", () => controller.abort());
-			const newRequest = new Request(request, { signal: controller.signal });
-			controller.signal.addEventListener("abort", () => clearTimeout(timeoutId));
-			return newRequest;
-		} });
-	}
-	/**
-	* Constructs the base URL from the configuration
-	*
-	* @param config - The client configuration
-	* @returns The constructed base URL
-	*/
-	getBaseUrlFromConfig(config) {
-		if (config.baseUrl) return config.baseUrl;
-		const env = config.environment || Environment.Production;
-		switch (env) {
-			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`;
-		}
-	}
-	/**
-	* Get the base URL of the API
-	*
-	* @returns The base URL of the API
-	*/
-	getBaseUrl() {
-		return this.baseUrl;
 	}
 	/**
 	* Get the authorization header value
@@ -798,48 +554,6 @@ var StorefrontAPIClient = class {
 		this.config.apiKey = void 0;
 	}
 	/**
-	* Execute a request and handle the response
-	*
-	* @param apiCall - Function that executes the API request
-	* @returns Promise with the API response
-	*/
-	async executeRequest(apiCall) {
-		try {
-			const { data, error, response } = await apiCall();
-			if (error) return {
-				data: null,
-				error,
-				response
-			};
-			if (data && data.content !== void 0) return {
-				data: data.content,
-				error: null,
-				response
-			};
-			return {
-				data,
-				error: null,
-				response
-			};
-		} catch (err) {
-			const mockResponse = new Response(null, {
-				status: 0,
-				statusText: "Network Error"
-			});
-			const errorResult = {
-				data: null,
-				error: {
-					success: false,
-					code: "NETWORK_ERROR",
-					message: "Network error occurred",
-					error: err
-				},
-				response: mockResponse
-			};
-			return errorResult;
-		}
-	}
-	/**
 	* Initialize tokens in storage (private helper method)
 	*/
 	async initializeTokens(accessToken, refreshToken) {
@@ -852,16 +566,6 @@ var StorefrontAPIClient = class {
 			console.warn("Failed to initialize tokens in storage:", error);
 		}
 	}
-	/**
-	* Merge default headers with method-level headers
-	* Method-level headers take precedence over default headers
-	*
-	* @param methodHeaders - Headers passed to the specific method call
-	* @returns Merged headers object with proper HTTP header names
-	*/
-	mergeHeaders(methodHeaders) {
-		return mergeHeaders(this.config.defaultHeaders, methodHeaders);
-	}
 };
 
 //#endregion
@@ -3646,11 +3350,16 @@ var StorefrontSDK = class {
 	*/
 	store;
 	/**
+	* Centrally stored default headers for consistency
+	*/
+	defaultHeaders;
+	/**
 	* Create a new StorefrontSDK instance
 	*
 	* @param options - Configuration options for the SDK
 	*/
 	constructor(options) {
+		this.defaultHeaders = options.defaultHeaders;
 		const config = {
 			storeId: options.storeId,
 			environment: options.environment,
@@ -3810,26 +3519,23 @@ var StorefrontSDK = class {
 	* @param headers - Default headers to set (only supported headers allowed)
 	*/
 	setDefaultHeaders(headers) {
-		const newConfig = {
-			...this.catalog["config"],
-			defaultHeaders: headers
-		};
-		this.catalog["config"] = newConfig;
-		this.cart["config"] = newConfig;
-		this.auth["config"] = newConfig;
-		this.customer["config"] = newConfig;
-		this.helpers["config"] = newConfig;
-		this.shipping["config"] = newConfig;
-		this.order["config"] = newConfig;
-		this.store["config"] = newConfig;
+		this.defaultHeaders = headers;
+		this.catalog.setDefaultHeaders(headers);
+		this.cart.setDefaultHeaders(headers);
+		this.auth.setDefaultHeaders(headers);
+		this.customer.setDefaultHeaders(headers);
+		this.helpers.setDefaultHeaders(headers);
+		this.shipping.setDefaultHeaders(headers);
+		this.order.setDefaultHeaders(headers);
+		this.store.setDefaultHeaders(headers);
 	}
 	/**
 	* Get current default headers
 	*
-	* @returns Current default headers
+	* @returns Current default headers from central storage (always consistent)
 	*/
 	getDefaultHeaders() {
-		return this.catalog["config"].defaultHeaders;
+		return this.defaultHeaders;
 	}
 };
 var src_default = StorefrontSDK;