perspectapi-ts-sdk 2.2.1 → 2.3.3

package/README.md

@@ -537,7 +537,29 @@ const session = await client.checkout.createCheckoutSession({
   priceId: 'price_1234567890',
   successUrl: 'https://myapp.com/success',
   cancelUrl: 'https://myapp.com/cancel',
-  customerEmail: 'customer@example.com'
+  customerEmail: 'customer@example.com',
+  currency: 'usd',
+  shipping_amount: 500,
+  shipping_address: {
+    country: 'US',
+    state: 'CA',
+    postal_code: '94110'
+  },
+  billing_address: {
+    country: 'US',
+    state: 'CA',
+    postal_code: '94110'
+  },
+  tax: {
+    strategy: 'manual_rates',
+    customer_identifier: 'acct-123',
+    customer_display_name: 'Acme Corp',
+    customer_exemption: {
+      status: 'exempt',
+      tax_id: '99-1234567',
+      tax_id_type: 'ein'
+    }
+  }
 });
 
 // Redirect user to checkout
@@ -545,6 +567,7 @@ window.location.href = session.data.url;
 
 // Get checkout session status
 const sessionStatus = await client.checkout.getCheckoutSession('cs_test_123');
+console.log(sessionStatus.data.tax?.amount); // Display assessed tax (if calculated)
 ```
 
 ### Contact Forms

package/dist/index.d.mts

@@ -426,6 +426,14 @@ type CheckoutMetadataValue = string | number | boolean | null | CheckoutMetadata
 type CheckoutMetadata = Record<string, CheckoutMetadataValue>;
 type CheckoutTaxStrategy = 'disabled' | 'gateway_auto' | 'manual_rates' | 'external_service';
 type CheckoutTaxExemptionStatus = 'none' | 'exempt' | 'reverse_charge';
+interface CheckoutAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+}
 interface CheckoutTaxCustomerExemptionRequest {
     status?: CheckoutTaxExemptionStatus;
     reason?: string;
@@ -474,6 +482,7 @@ interface CreateCheckoutSessionRequest {
     cancelUrl?: string;
     customer_email?: string;
     customerEmail?: string;
+    currency?: string;
     metadata?: CheckoutMetadata;
     mode?: 'payment' | 'subscription' | 'setup';
     automatic_tax?: {
@@ -483,12 +492,35 @@ interface CreateCheckoutSessionRequest {
         allowed_countries: string[];
     };
     billing_address_collection?: 'auto' | 'required';
+    shipping_amount?: number;
+    shippingAmount?: number;
+    shipping_address?: CheckoutAddress;
+    shippingAddress?: CheckoutAddress;
+    billing_address?: CheckoutAddress;
+    billingAddress?: CheckoutAddress;
     tax?: CheckoutTaxRequest;
 }
+interface CheckoutTaxBreakdownItem {
+    jurisdiction: string;
+    rate_percent: number;
+    tax_amount: number;
+    taxable_amount: number;
+    source: 'manual_map' | 'manual_percent' | 'gateway' | 'external';
+}
+interface CheckoutSessionTax {
+    amount: number;
+    currency: string;
+    strategy: CheckoutTaxStrategy;
+    exemption_applied: boolean;
+    exemption_status: CheckoutTaxExemptionStatus;
+    breakdown?: CheckoutTaxBreakdownItem[] | null;
+}
 interface CheckoutSession {
     id: string;
     url: string;
     status: string;
+    payment_status?: string;
+    tax?: CheckoutSessionTax | null;
 }
 interface ContactSubmission {
     id: string;
@@ -2347,6 +2379,22 @@ interface CheckoutSessionOptions {
     logger?: LoaderLogger;
     fallbackProducts?: Product[];
     metadata?: CheckoutMetadata;
+    /**
+     * Optional currency override; defaults to the currency defined on each Stripe price.
+     */
+    currency?: string;
+    /**
+     * Optional shipping amount (in the smallest currency unit).
+     */
+    shippingAmount?: number;
+    /**
+     * Shipping address forwarded to the checkout API for tax estimation.
+     */
+    shippingAddress?: CheckoutAddress;
+    /**
+     * Billing address forwarded to the checkout API for tax estimation.
+     */
+    billingAddress?: CheckoutAddress;
     /**
      * Optional resolver to convert a product record into a Stripe price ID.
      */
@@ -2364,4 +2412,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, type CacheConfig, CacheManager, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, DEFAULT_IMAGE_SIZES, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type ResponsiveImageSizes, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };
+export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, type CacheConfig, CacheManager, CategoriesClient, type Category, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, DEFAULT_IMAGE_SIZES, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type ResponsiveImageSizes, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };

package/dist/index.d.ts

@@ -426,6 +426,14 @@ type CheckoutMetadataValue = string | number | boolean | null | CheckoutMetadata
 type CheckoutMetadata = Record<string, CheckoutMetadataValue>;
 type CheckoutTaxStrategy = 'disabled' | 'gateway_auto' | 'manual_rates' | 'external_service';
 type CheckoutTaxExemptionStatus = 'none' | 'exempt' | 'reverse_charge';
+interface CheckoutAddress {
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+}
 interface CheckoutTaxCustomerExemptionRequest {
     status?: CheckoutTaxExemptionStatus;
     reason?: string;
@@ -474,6 +482,7 @@ interface CreateCheckoutSessionRequest {
     cancelUrl?: string;
     customer_email?: string;
     customerEmail?: string;
+    currency?: string;
     metadata?: CheckoutMetadata;
     mode?: 'payment' | 'subscription' | 'setup';
     automatic_tax?: {
@@ -483,12 +492,35 @@ interface CreateCheckoutSessionRequest {
         allowed_countries: string[];
     };
     billing_address_collection?: 'auto' | 'required';
+    shipping_amount?: number;
+    shippingAmount?: number;
+    shipping_address?: CheckoutAddress;
+    shippingAddress?: CheckoutAddress;
+    billing_address?: CheckoutAddress;
+    billingAddress?: CheckoutAddress;
     tax?: CheckoutTaxRequest;
 }
+interface CheckoutTaxBreakdownItem {
+    jurisdiction: string;
+    rate_percent: number;
+    tax_amount: number;
+    taxable_amount: number;
+    source: 'manual_map' | 'manual_percent' | 'gateway' | 'external';
+}
+interface CheckoutSessionTax {
+    amount: number;
+    currency: string;
+    strategy: CheckoutTaxStrategy;
+    exemption_applied: boolean;
+    exemption_status: CheckoutTaxExemptionStatus;
+    breakdown?: CheckoutTaxBreakdownItem[] | null;
+}
 interface CheckoutSession {
     id: string;
     url: string;
     status: string;
+    payment_status?: string;
+    tax?: CheckoutSessionTax | null;
 }
 interface ContactSubmission {
     id: string;
@@ -2347,6 +2379,22 @@ interface CheckoutSessionOptions {
     logger?: LoaderLogger;
     fallbackProducts?: Product[];
     metadata?: CheckoutMetadata;
+    /**
+     * Optional currency override; defaults to the currency defined on each Stripe price.
+     */
+    currency?: string;
+    /**
+     * Optional shipping amount (in the smallest currency unit).
+     */
+    shippingAmount?: number;
+    /**
+     * Shipping address forwarded to the checkout API for tax estimation.
+     */
+    shippingAddress?: CheckoutAddress;
+    /**
+     * Billing address forwarded to the checkout API for tax estimation.
+     */
+    billingAddress?: CheckoutAddress;
     /**
      * Optional resolver to convert a product record into a Stripe price ID.
      */
@@ -2364,4 +2412,4 @@ declare function createCheckoutSession(options: CheckoutSessionOptions): Promise
     error: string;
 }>;
 
-export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, type CacheConfig, CacheManager, CategoriesClient, type Category, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, DEFAULT_IMAGE_SIZES, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type ResponsiveImageSizes, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };
+export { type ApiError, type ApiKey, ApiKeysClient, type ApiResponse, AuthClient, type AuthResponse, BaseClient, type BlogPost, type CacheConfig, CacheManager, CategoriesClient, type Category, type CheckoutAddress, CheckoutClient, type CheckoutMetadata, type CheckoutMetadataValue, type CheckoutSession, type CheckoutSessionOptions, type CheckoutSessionTax, type CheckoutTaxBreakdownItem, type CheckoutTaxCustomerExemptionRequest, type CheckoutTaxExemptionStatus, type CheckoutTaxRequest, type CheckoutTaxStrategy, ContactClient, type ContactStatusResponse, type ContactSubmission, type ContactSubmitResponse, type Content, ContentClient, type ContentQueryParams, type ContentStatus, type ContentType, type CreateApiKeyRequest, type CreateCategoryRequest, type CreateCheckoutSessionRequest, type CreateContactRequest, type CreateContentRequest, type CreateNewsletterSubscriptionRequest, type CreateOrganizationRequest, type CreatePaymentGatewayRequest, type CreateProductRequest, type CreateSiteRequest, type CreateWebhookRequest, DEFAULT_IMAGE_SIZES, HttpClient, type HttpMethod, type ImageTransformOptions, InMemoryCacheAdapter, type LoadContentBySlugOptions, type LoadContentOptions, type LoadProductBySlugOptions, type LoadProductsOptions, type LoaderLogger, type LoaderOptions, type MediaItem, NewsletterClient, type NewsletterConfirmResponse, type NewsletterList, type NewsletterPreferences, type NewsletterStatusResponse, type NewsletterSubscribeResponse, type NewsletterSubscription, type NewsletterUnsubscribeRequest, type NewsletterUnsubscribeResponse, NoopCacheAdapter, type Organization, OrganizationsClient, type PaginatedResponse, type PaginationParams, type PaymentGateway, PerspectApiClient, type PerspectApiConfig, type Product, type ProductQueryParams, ProductsClient, type RequestOptions, type ResponsiveImageSizes, type SignInRequest, type SignUpRequest, type Site, SitesClient, type UpdateApiKeyRequest, type UpdateContentRequest, type User, type Webhook, WebhooksClient, buildImageUrl, createApiError, createCheckoutSession, createPerspectApiClient, PerspectApiClient as default, generateResponsiveImageHtml, generateResponsiveUrls, generateSizesAttribute, generateSrcSet, loadAllContent, loadContentBySlug, loadPages, loadPosts, loadProductBySlug, loadProducts, transformContent, transformMediaItem, transformProduct };

package/dist/index.js

@@ -106,13 +106,25 @@ var HttpClient = class {
   async request(endpoint, options = {}) {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
-    console.log(`[HTTP Client] Making ${options.method || "GET"} request to: ${url}`);
+    console.log(`[HTTP Client] ====== Request Details ======`);
+    console.log(`[HTTP Client] Method: ${options.method || "GET"}`);
     console.log(`[HTTP Client] Base URL: ${this.baseUrl}`);
     console.log(`[HTTP Client] Endpoint: ${endpoint}`);
     console.log(`[HTTP Client] Full URL: ${url}`);
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, options.params);
+      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      if (options.params.slug_prefix) {
+        console.log(`[HTTP Client] \u26A0\uFE0F slug_prefix detected: "${options.params.slug_prefix}"`);
+      }
+    }
+    const safeHeaders = { ...requestOptions.headers };
+    if (safeHeaders["Authorization"]) {
+      safeHeaders["Authorization"] = "Bearer [REDACTED]";
+    }
+    if (safeHeaders["X-API-Key"]) {
+      safeHeaders["X-API-Key"] = "[REDACTED]";
     }
+    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
@@ -166,16 +178,26 @@ var HttpClient = class {
    */
   buildUrl(endpoint, params) {
     const url = `${this.baseUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
+    console.log(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    console.log(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    console.log(`[HTTP Client - URL Builder] Combined URL (before params): ${url}`);
     if (!params || Object.keys(params).length === 0) {
+      console.log(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
+    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
     const searchParams = new URLSearchParams();
     Object.entries(params).forEach(([key, value]) => {
       if (value !== void 0 && value !== null) {
+        console.log(`[HTTP Client - URL Builder] Adding param: ${key}=${value}`);
         searchParams.append(key, String(value));
+      } else {
+        console.log(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
-    return `${url}?${searchParams.toString()}`;
+    const finalUrl = `${url}?${searchParams.toString()}`;
+    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    return finalUrl;
   }
   /**
    * Build request options
@@ -223,27 +245,42 @@ var HttpClient = class {
   async handleResponse(response) {
     const contentType = response.headers.get("content-type");
     const isJson = contentType?.includes("application/json");
+    console.log(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    console.log(`[HTTP Client - Response] Content-Type: ${contentType}`);
     let data;
     try {
       data = isJson ? await response.json() : await response.text();
     } catch (error) {
+      console.error(`[HTTP Client - Response] Failed to parse response:`, error);
       data = null;
     }
+    const dataStr = JSON.stringify(data);
+    if (dataStr && dataStr.length > 1e3) {
+      console.log(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1e3) + "...");
+    } else {
+      console.log(`[HTTP Client - Response] Data:`, data);
+    }
     if (!response.ok) {
+      console.error(`[HTTP Client - Response] Error response received`);
       const error = {
         message: data?.error || data?.message || `HTTP ${response.status}: ${response.statusText}`,
         status: response.status,
         code: data?.code,
         details: data
       };
+      console.error(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
     if (isJson && typeof data === "object") {
       if ("data" in data || "message" in data || "error" in data) {
-        return data;
+        const apiResponse = data;
+        console.log(`[HTTP Client - Response] Returning API response with success=${apiResponse.success}, data length=${Array.isArray(apiResponse.data) ? apiResponse.data.length : "N/A"}`);
+        return apiResponse;
       }
+      console.log(`[HTTP Client - Response] Wrapping response in data property`);
       return { data, success: true };
     }
+    console.log(`[HTTP Client - Response] Returning text response`);
     return { data, success: true };
   }
   /**
@@ -778,6 +815,13 @@ var ContentClient = class extends BaseClient {
     const endpoint = this.siteScopedEndpoint(siteName);
     const path = this.buildPath(endpoint);
     const normalizedParams = params ? { ...params } : void 0;
+    console.log("[PerspectAPI Content] Starting content fetch:", {
+      siteName,
+      endpoint,
+      path,
+      originalParams: params,
+      normalizedParams
+    });
     if (normalizedParams) {
       const validatedLimit = validateOptionalLimit(
         normalizedParams.limit,
@@ -797,14 +841,52 @@ var ContentClient = class extends BaseClient {
       } else {
         delete normalizedParams.page_type;
       }
+      console.log("[PerspectAPI Content] Parameters after validation:", {
+        normalizedParams,
+        validatedLimit,
+        validatedPageType
+      });
     }
-    return this.fetchWithCache(
+    console.log("[PerspectAPI Content] Cache details:", {
+      cacheEnabled: !!this.cache,
+      cachePolicy,
+      tags: this.buildContentTags(siteName)
+    });
+    const result = await this.fetchWithCache(
       endpoint,
       normalizedParams,
       this.buildContentTags(siteName),
       cachePolicy,
-      () => this.http.get(path, normalizedParams)
+      async () => {
+        console.log("[PerspectAPI Content] Making HTTP request:", {
+          method: "GET",
+          url: path,
+          params: normalizedParams
+        });
+        const response = await this.http.get(path, normalizedParams);
+        console.log("[PerspectAPI Content] HTTP response received:", {
+          success: response.success,
+          dataLength: response.data?.length ?? 0,
+          pagination: response.pagination,
+          error: response.error,
+          message: response.message
+        });
+        if (response.data?.length === 0) {
+          console.warn("[PerspectAPI Content] WARNING: Received 0 results for query:", {
+            siteName,
+            params: normalizedParams,
+            fullResponse: response
+          });
+        }
+        return response;
+      }
     );
+    console.log("[PerspectAPI Content] Final result:", {
+      success: result.success,
+      dataLength: result.data?.length ?? 0,
+      pagination: result.pagination
+    });
+    return result;
   }
   /**
    * Get content by ID
@@ -2573,6 +2655,10 @@ async function createCheckoutSession(options) {
     logger = noopLogger,
     fallbackProducts,
     metadata,
+    currency,
+    shippingAmount,
+    shippingAddress,
+    billingAddress,
     priceIdResolver,
     tax
   } = options;
@@ -2628,6 +2714,21 @@ async function createCheckoutSession(options) {
       mode: mode === "test" ? "payment" : "payment",
       metadata
     };
+    if (currency) {
+      checkoutData.currency = currency;
+    }
+    if (typeof shippingAmount === "number") {
+      checkoutData.shipping_amount = shippingAmount;
+      checkoutData.shippingAmount = shippingAmount;
+    }
+    if (shippingAddress) {
+      checkoutData.shipping_address = shippingAddress;
+      checkoutData.shippingAddress = shippingAddress;
+    }
+    if (billingAddress) {
+      checkoutData.billing_address = billingAddress;
+      checkoutData.billingAddress = billingAddress;
+    }
     if (resolvedTax) {
       checkoutData.tax = resolvedTax;
     }

package/dist/index.mjs

@@ -45,13 +45,25 @@ var HttpClient = class {
   async request(endpoint, options = {}) {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
-    console.log(`[HTTP Client] Making ${options.method || "GET"} request to: ${url}`);
+    console.log(`[HTTP Client] ====== Request Details ======`);
+    console.log(`[HTTP Client] Method: ${options.method || "GET"}`);
     console.log(`[HTTP Client] Base URL: ${this.baseUrl}`);
     console.log(`[HTTP Client] Endpoint: ${endpoint}`);
     console.log(`[HTTP Client] Full URL: ${url}`);
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, options.params);
+      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      if (options.params.slug_prefix) {
+        console.log(`[HTTP Client] \u26A0\uFE0F slug_prefix detected: "${options.params.slug_prefix}"`);
+      }
+    }
+    const safeHeaders = { ...requestOptions.headers };
+    if (safeHeaders["Authorization"]) {
+      safeHeaders["Authorization"] = "Bearer [REDACTED]";
+    }
+    if (safeHeaders["X-API-Key"]) {
+      safeHeaders["X-API-Key"] = "[REDACTED]";
     }
+    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
     let lastError;
     for (let attempt = 0; attempt <= this.retries; attempt++) {
       try {
@@ -105,16 +117,26 @@ var HttpClient = class {
    */
   buildUrl(endpoint, params) {
     const url = `${this.baseUrl}${endpoint.startsWith("/") ? "" : "/"}${endpoint}`;
+    console.log(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    console.log(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    console.log(`[HTTP Client - URL Builder] Combined URL (before params): ${url}`);
     if (!params || Object.keys(params).length === 0) {
+      console.log(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
+    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
     const searchParams = new URLSearchParams();
     Object.entries(params).forEach(([key, value]) => {
       if (value !== void 0 && value !== null) {
+        console.log(`[HTTP Client - URL Builder] Adding param: ${key}=${value}`);
         searchParams.append(key, String(value));
+      } else {
+        console.log(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
-    return `${url}?${searchParams.toString()}`;
+    const finalUrl = `${url}?${searchParams.toString()}`;
+    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    return finalUrl;
   }
   /**
    * Build request options
@@ -162,27 +184,42 @@ var HttpClient = class {
   async handleResponse(response) {
     const contentType = response.headers.get("content-type");
     const isJson = contentType?.includes("application/json");
+    console.log(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    console.log(`[HTTP Client - Response] Content-Type: ${contentType}`);
     let data;
     try {
       data = isJson ? await response.json() : await response.text();
     } catch (error) {
+      console.error(`[HTTP Client - Response] Failed to parse response:`, error);
       data = null;
     }
+    const dataStr = JSON.stringify(data);
+    if (dataStr && dataStr.length > 1e3) {
+      console.log(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1e3) + "...");
+    } else {
+      console.log(`[HTTP Client - Response] Data:`, data);
+    }
     if (!response.ok) {
+      console.error(`[HTTP Client - Response] Error response received`);
       const error = {
         message: data?.error || data?.message || `HTTP ${response.status}: ${response.statusText}`,
         status: response.status,
         code: data?.code,
         details: data
       };
+      console.error(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
     if (isJson && typeof data === "object") {
       if ("data" in data || "message" in data || "error" in data) {
-        return data;
+        const apiResponse = data;
+        console.log(`[HTTP Client - Response] Returning API response with success=${apiResponse.success}, data length=${Array.isArray(apiResponse.data) ? apiResponse.data.length : "N/A"}`);
+        return apiResponse;
       }
+      console.log(`[HTTP Client - Response] Wrapping response in data property`);
       return { data, success: true };
     }
+    console.log(`[HTTP Client - Response] Returning text response`);
     return { data, success: true };
   }
   /**
@@ -717,6 +754,13 @@ var ContentClient = class extends BaseClient {
     const endpoint = this.siteScopedEndpoint(siteName);
     const path = this.buildPath(endpoint);
     const normalizedParams = params ? { ...params } : void 0;
+    console.log("[PerspectAPI Content] Starting content fetch:", {
+      siteName,
+      endpoint,
+      path,
+      originalParams: params,
+      normalizedParams
+    });
     if (normalizedParams) {
       const validatedLimit = validateOptionalLimit(
         normalizedParams.limit,
@@ -736,14 +780,52 @@ var ContentClient = class extends BaseClient {
       } else {
         delete normalizedParams.page_type;
       }
+      console.log("[PerspectAPI Content] Parameters after validation:", {
+        normalizedParams,
+        validatedLimit,
+        validatedPageType
+      });
     }
-    return this.fetchWithCache(
+    console.log("[PerspectAPI Content] Cache details:", {
+      cacheEnabled: !!this.cache,
+      cachePolicy,
+      tags: this.buildContentTags(siteName)
+    });
+    const result = await this.fetchWithCache(
       endpoint,
       normalizedParams,
       this.buildContentTags(siteName),
       cachePolicy,
-      () => this.http.get(path, normalizedParams)
+      async () => {
+        console.log("[PerspectAPI Content] Making HTTP request:", {
+          method: "GET",
+          url: path,
+          params: normalizedParams
+        });
+        const response = await this.http.get(path, normalizedParams);
+        console.log("[PerspectAPI Content] HTTP response received:", {
+          success: response.success,
+          dataLength: response.data?.length ?? 0,
+          pagination: response.pagination,
+          error: response.error,
+          message: response.message
+        });
+        if (response.data?.length === 0) {
+          console.warn("[PerspectAPI Content] WARNING: Received 0 results for query:", {
+            siteName,
+            params: normalizedParams,
+            fullResponse: response
+          });
+        }
+        return response;
+      }
     );
+    console.log("[PerspectAPI Content] Final result:", {
+      success: result.success,
+      dataLength: result.data?.length ?? 0,
+      pagination: result.pagination
+    });
+    return result;
   }
   /**
    * Get content by ID
@@ -2512,6 +2594,10 @@ async function createCheckoutSession(options) {
     logger = noopLogger,
     fallbackProducts,
     metadata,
+    currency,
+    shippingAmount,
+    shippingAddress,
+    billingAddress,
     priceIdResolver,
     tax
   } = options;
@@ -2567,6 +2653,21 @@ async function createCheckoutSession(options) {
       mode: mode === "test" ? "payment" : "payment",
       metadata
     };
+    if (currency) {
+      checkoutData.currency = currency;
+    }
+    if (typeof shippingAmount === "number") {
+      checkoutData.shipping_amount = shippingAmount;
+      checkoutData.shippingAmount = shippingAmount;
+    }
+    if (shippingAddress) {
+      checkoutData.shipping_address = shippingAddress;
+      checkoutData.shippingAddress = shippingAddress;
+    }
+    if (billingAddress) {
+      checkoutData.billing_address = billingAddress;
+      checkoutData.billingAddress = billingAddress;
+    }
     if (resolvedTax) {
       checkoutData.tax = resolvedTax;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "2.2.1",
+  "version": "2.3.3",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client/content-client.ts

@@ -34,6 +34,15 @@ export class ContentClient extends BaseClient {
       ? { ...params }
       : undefined;
 
+    // Log initial request parameters
+    console.log('[PerspectAPI Content] Starting content fetch:', {
+      siteName,
+      endpoint,
+      path,
+      originalParams: params,
+      normalizedParams
+    });
+
     if (normalizedParams) {
       const validatedLimit = validateOptionalLimit(
         normalizedParams.limit,
@@ -54,15 +63,64 @@ export class ContentClient extends BaseClient {
       } else {
         delete normalizedParams.page_type;
       }
+
+      // Log parameter validation results
+      console.log('[PerspectAPI Content] Parameters after validation:', {
+        normalizedParams,
+        validatedLimit,
+        validatedPageType
+      });
     }
 
-    return this.fetchWithCache<PaginatedResponse<Content>>(
+    // Log cache information
+    console.log('[PerspectAPI Content] Cache details:', {
+      cacheEnabled: !!this.cache,
+      cachePolicy,
+      tags: this.buildContentTags(siteName)
+    });
+
+    const result = await this.fetchWithCache<PaginatedResponse<Content>>(
       endpoint,
       normalizedParams,
       this.buildContentTags(siteName),
       cachePolicy,
-      () => this.http.get(path, normalizedParams) as Promise<PaginatedResponse<Content>>
+      async () => {
+        console.log('[PerspectAPI Content] Making HTTP request:', {
+          method: 'GET',
+          url: path,
+          params: normalizedParams
+        });
+        
+        const response = await this.http.get(path, normalizedParams) as PaginatedResponse<Content>;
+        
+        console.log('[PerspectAPI Content] HTTP response received:', {
+          success: response.success,
+          dataLength: response.data?.length ?? 0,
+          pagination: response.pagination,
+          error: response.error,
+          message: response.message
+        });
+        
+        // Log more details if we got 0 results
+        if (response.data?.length === 0) {
+          console.warn('[PerspectAPI Content] WARNING: Received 0 results for query:', {
+            siteName,
+            params: normalizedParams,
+            fullResponse: response
+          });
+        }
+        
+        return response;
+      }
     );
+
+    console.log('[PerspectAPI Content] Final result:', {
+      success: result.success,
+      dataLength: result.data?.length ?? 0,
+      pagination: result.pagination
+    });
+
+    return result;
   }
 
   /**

package/src/loaders.ts

@@ -18,7 +18,8 @@ import type {
   CreateCheckoutSessionRequest,
   CheckoutSession,
   CheckoutMetadata,
-  CheckoutTaxRequest
+  CheckoutTaxRequest,
+  CheckoutAddress
 } from './types';
 import {
   MAX_API_QUERY_LIMIT,
@@ -585,6 +586,22 @@ export interface CheckoutSessionOptions {
   logger?: LoaderLogger;
   fallbackProducts?: Product[];
   metadata?: CheckoutMetadata;
+  /**
+   * Optional currency override; defaults to the currency defined on each Stripe price.
+   */
+  currency?: string;
+  /**
+   * Optional shipping amount (in the smallest currency unit).
+   */
+  shippingAmount?: number;
+  /**
+   * Shipping address forwarded to the checkout API for tax estimation.
+   */
+  shippingAddress?: CheckoutAddress;
+  /**
+   * Billing address forwarded to the checkout API for tax estimation.
+   */
+  billingAddress?: CheckoutAddress;
   /**
    * Optional resolver to convert a product record into a Stripe price ID.
    */
@@ -613,6 +630,10 @@ export async function createCheckoutSession(
     logger = noopLogger,
     fallbackProducts,
     metadata,
+    currency,
+    shippingAmount,
+    shippingAddress,
+    billingAddress,
     priceIdResolver,
     tax
   } = options;
@@ -686,6 +707,25 @@ export async function createCheckoutSession(
       metadata,
     };
 
+    if (currency) {
+      checkoutData.currency = currency;
+    }
+
+    if (typeof shippingAmount === 'number') {
+      checkoutData.shipping_amount = shippingAmount;
+      checkoutData.shippingAmount = shippingAmount;
+    }
+
+    if (shippingAddress) {
+      checkoutData.shipping_address = shippingAddress;
+      checkoutData.shippingAddress = shippingAddress;
+    }
+
+    if (billingAddress) {
+      checkoutData.billing_address = billingAddress;
+      checkoutData.billingAddress = billingAddress;
+    }
+
     if (resolvedTax) {
       checkoutData.tax = resolvedTax;
     }

package/src/types/index.ts

@@ -410,6 +410,15 @@ export type CheckoutTaxExemptionStatus =
   | 'exempt'
   | 'reverse_charge';
 
+export interface CheckoutAddress {
+  line1?: string;
+  line2?: string;
+  city?: string;
+  state?: string;
+  postal_code?: string;
+  country?: string;
+}
+
 export interface CheckoutTaxCustomerExemptionRequest {
   status?: CheckoutTaxExemptionStatus;
   reason?: string;
@@ -467,6 +476,7 @@ export interface CreateCheckoutSessionRequest {
   cancelUrl?: string;   // Alternative naming
   customer_email?: string;
   customerEmail?: string;  // Alternative naming
+  currency?: string;
   metadata?: CheckoutMetadata;
   mode?: 'payment' | 'subscription' | 'setup';
   automatic_tax?: {
@@ -476,13 +486,38 @@ export interface CreateCheckoutSessionRequest {
     allowed_countries: string[];
   };
   billing_address_collection?: 'auto' | 'required';
+  shipping_amount?: number;
+  shippingAmount?: number;
+  shipping_address?: CheckoutAddress;
+  shippingAddress?: CheckoutAddress;
+  billing_address?: CheckoutAddress;
+  billingAddress?: CheckoutAddress;
   tax?: CheckoutTaxRequest;
 }
 
+export interface CheckoutTaxBreakdownItem {
+  jurisdiction: string;
+  rate_percent: number;
+  tax_amount: number;
+  taxable_amount: number;
+  source: 'manual_map' | 'manual_percent' | 'gateway' | 'external';
+}
+
+export interface CheckoutSessionTax {
+  amount: number;
+  currency: string;
+  strategy: CheckoutTaxStrategy;
+  exemption_applied: boolean;
+  exemption_status: CheckoutTaxExemptionStatus;
+  breakdown?: CheckoutTaxBreakdownItem[] | null;
+}
+
 export interface CheckoutSession {
   id: string;
   url: string;
   status: string;
+  payment_status?: string;
+  tax?: CheckoutSessionTax | null;
 }
 
 // Contact Forms

package/src/utils/http-client.ts

@@ -68,14 +68,31 @@ export class HttpClient {
     const url = this.buildUrl(endpoint, options.params);
     const requestOptions = this.buildRequestOptions(options);
 
-    // Log the full request details
-    console.log(`[HTTP Client] Making ${options.method || 'GET'} request to: ${url}`);
+    // Enhanced logging for debugging
+    console.log(`[HTTP Client] ====== Request Details ======`);
+    console.log(`[HTTP Client] Method: ${options.method || 'GET'}`);
     console.log(`[HTTP Client] Base URL: ${this.baseUrl}`);
     console.log(`[HTTP Client] Endpoint: ${endpoint}`);
     console.log(`[HTTP Client] Full URL: ${url}`);
+    
     if (options.params) {
-      console.log(`[HTTP Client] Query params:`, options.params);
+      console.log(`[HTTP Client] Query params:`, JSON.stringify(options.params, null, 2));
+      
+      // Specifically log slug_prefix if present
+      if (options.params.slug_prefix) {
+        console.log(`[HTTP Client] ⚠️ slug_prefix detected: "${options.params.slug_prefix}"`);
+      }
+    }
+    
+    // Log headers (excluding sensitive data)
+    const safeHeaders: Record<string, any> = { ...requestOptions.headers };
+    if (safeHeaders['Authorization']) {
+      safeHeaders['Authorization'] = 'Bearer [REDACTED]';
+    }
+    if (safeHeaders['X-API-Key']) {
+      safeHeaders['X-API-Key'] = '[REDACTED]';
     }
+    console.log(`[HTTP Client] Headers:`, JSON.stringify(safeHeaders, null, 2));
 
     let lastError: Error;
     
@@ -146,18 +163,31 @@ export class HttpClient {
   private buildUrl(endpoint: string, params?: Record<string, any>): string {
     const url = `${this.baseUrl}${endpoint.startsWith('/') ? '' : '/'}${endpoint}`;
     
+    console.log(`[HTTP Client - URL Builder] Base URL: ${this.baseUrl}`);
+    console.log(`[HTTP Client - URL Builder] Endpoint: ${endpoint}`);
+    console.log(`[HTTP Client - URL Builder] Combined URL (before params): ${url}`);
+    
     if (!params || Object.keys(params).length === 0) {
+      console.log(`[HTTP Client - URL Builder] No params, returning: ${url}`);
       return url;
     }
 
+    console.log(`[HTTP Client - URL Builder] Processing params:`, params);
+    
     const searchParams = new URLSearchParams();
     Object.entries(params).forEach(([key, value]) => {
       if (value !== undefined && value !== null) {
+        console.log(`[HTTP Client - URL Builder] Adding param: ${key}=${value}`);
         searchParams.append(key, String(value));
+      } else {
+        console.log(`[HTTP Client - URL Builder] Skipping null/undefined param: ${key}`);
       }
     });
 
-    return `${url}?${searchParams.toString()}`;
+    const finalUrl = `${url}?${searchParams.toString()}`;
+    console.log(`[HTTP Client - URL Builder] Final URL: ${finalUrl}`);
+    
+    return finalUrl;
   }
 
   /**
@@ -215,20 +245,34 @@ export class HttpClient {
     const contentType = response.headers.get('content-type');
     const isJson = contentType?.includes('application/json');
 
+    console.log(`[HTTP Client - Response] Status: ${response.status} ${response.statusText}`);
+    console.log(`[HTTP Client - Response] Content-Type: ${contentType}`);
+
     let data: any;
     try {
       data = isJson ? await response.json() : await response.text();
     } catch (error) {
+      console.error(`[HTTP Client - Response] Failed to parse response:`, error);
       data = null;
     }
 
+    // Log response data (truncate if too large)
+    const dataStr = JSON.stringify(data);
+    if (dataStr && dataStr.length > 1000) {
+      console.log(`[HTTP Client - Response] Data (truncated):`, dataStr.substring(0, 1000) + '...');
+    } else {
+      console.log(`[HTTP Client - Response] Data:`, data);
+    }
+
     if (!response.ok) {
+      console.error(`[HTTP Client - Response] Error response received`);
       const error: ApiError = {
         message: data?.error || data?.message || `HTTP ${response.status}: ${response.statusText}`,
         status: response.status,
         code: data?.code,
         details: data,
       };
+      console.error(`[HTTP Client - Response] Throwing error:`, error);
       throw error;
     }
 
@@ -236,12 +280,16 @@ export class HttpClient {
     if (isJson && typeof data === 'object') {
       // If response has data property, return as-is
       if ('data' in data || 'message' in data || 'error' in data) {
-        return data as ApiResponse<T>;
+        const apiResponse = data as ApiResponse<T>;
+        console.log(`[HTTP Client - Response] Returning API response with success=${apiResponse.success}, data length=${Array.isArray(apiResponse.data) ? apiResponse.data.length : 'N/A'}`);
+        return apiResponse;
       }
       // Otherwise wrap in data property
+      console.log(`[HTTP Client - Response] Wrapping response in data property`);
       return { data: data as T, success: true };
     }
 
+    console.log(`[HTTP Client - Response] Returning text response`);
     return { data: data as T, success: true };
   }