@outfitcanvas/fitview-sdk 1.0.1 → 1.0.2

package/README.md

@@ -20,7 +20,7 @@ import { FitViewClient, OutfitCanvasModel } from '@outfitcanvas/fitview-sdk';
 // Initialize the client
 const client = new FitViewClient({
   apiKey: 'pk_live_your_api_key_here',
-  baseURL: 'https://api.fitview.com', // Optional, defaults to production
+  baseURL: 'https://api.fitview.io', // Optional, defaults to production
 });
 
 // Generate a virtual try-on
@@ -53,7 +53,7 @@ Main client class for interacting with the FitView API.
 ```typescript
 const client = new FitViewClient({
   apiKey: string,              // Required: Your API key
-  baseURL?: string,            // Optional: API base URL (default: https://api.fitview.com)
+  baseURL?: string,            // Optional: API base URL (default: https://api.fitview.io)
   timeout?: number,            // Optional: Request timeout in ms (default: 300000)
   apiVersion?: string,         // Optional: API version (default: 'v1')
   maxRetries?: number,        // Optional: Retries for 429/5xx (default: 3, set 0 to disable)
@@ -528,6 +528,25 @@ The SDK provides specific error classes for different scenarios:
 - `FitViewTimeoutError` - Timeout errors
 - `FitViewNetworkError` - Network errors
 
+## Troubleshooting
+
+### `getaddrinfo ENOTFOUND api.fitview.io` (or similar)
+
+This means the hostname of the API could not be resolved (DNS failure). Common causes:
+
+1. **Wrong or placeholder base URL** – The default `baseURL` is `https://api.fitview.io`. If your API is hosted elsewhere (e.g. your own Cloud Run URL), set the correct URL when creating the client:
+   ```typescript
+   const client = new FitViewClient({
+     apiKey: process.env.FITVIEW_API_KEY!,
+     baseURL: process.env.FITVIEW_BASE_URL || 'https://your-actual-api.run.app',
+   });
+   ```
+   Or set the `FITVIEW_BASE_URL` environment variable (e.g. `https://fitview-api-xxxxx-uc.a.run.app` without `/api/v1`).
+
+2. **Network or DNS issues** – Firewall, VPN, or local DNS may block or fail to resolve the host. Try from another network or verify the API URL in a browser/curl.
+
+3. **Custom domain not set up** – If `api.fitview.io` is not yet configured in DNS for your environment, use the actual API URL provided by your dashboard or deployment (e.g. Cloud Run URL) as `baseURL`.
+
 ## Requirements
 
 - Node.js 18.0.0 or higher

package/dist/index.d.mts

@@ -284,7 +284,7 @@ interface FitViewClientOptions {
      */
     apiKey: string;
     /**
-     * Base URL of the API (default: https://api.fitview.com)
+     * Base URL of the API (default: https://api.fitview.io)
      */
     baseURL?: string;
     /**

package/dist/index.d.ts

@@ -284,7 +284,7 @@ interface FitViewClientOptions {
      */
     apiKey: string;
     /**
-     * Base URL of the API (default: https://api.fitview.com)
+     * Base URL of the API (default: https://api.fitview.io)
      */
     baseURL?: string;
     /**

package/dist/index.js

@@ -13678,7 +13678,7 @@ var FitViewClient = class {
       throw new Error("API key is required. Pass apiKey in the client options.");
     }
     this.apiKey = options.apiKey;
-    this.baseURL = (options.baseURL || "https://api.fitview.com").replace(/\/$/, "");
+    this.baseURL = (options.baseURL || "https://api.fitview.io").replace(/\/$/, "");
     this.timeout = options.timeout ?? 3e5;
     this.apiVersion = options.apiVersion || "v1";
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
@@ -13740,7 +13740,22 @@ var FitViewClient = class {
       signal.addEventListener("abort", () => controller.abort());
     }
     requestOptions.signal = controller.signal;
-    const response = await this.fetchImpl(url, requestOptions);
+    let response;
+    try {
+      response = await this.fetchImpl(url, requestOptions);
+    } catch (err) {
+      clearTimeout(timeoutId);
+      const msg = err?.message ?? String(err);
+      const code = err?.code ?? err?.cause?.code;
+      const isDnsFailure = code === "ENOTFOUND" || code === "ENODATA" || /getaddrinfo|ENOTFOUND|ENODATA|Could not resolve host/i.test(msg);
+      if (isDnsFailure) {
+        throw new FitViewNetworkError(
+          `Could not reach the API (${msg}). If you see ENOTFOUND for the API host, the base URL may be wrong: set baseURL in client options or FITVIEW_BASE_URL to your actual API URL (e.g. from your dashboard or Cloud Run).`,
+          err
+        );
+      }
+      throw new FitViewNetworkError(msg || "Network request failed", err);
+    }
     clearTimeout(timeoutId);
     const data = await response.json().catch(() => ({}));
     if (!response.ok) {

package/dist/index.mjs

@@ -8519,7 +8519,7 @@ var FitViewClient = class {
       throw new Error("API key is required. Pass apiKey in the client options.");
     }
     this.apiKey = options.apiKey;
-    this.baseURL = (options.baseURL || "https://api.fitview.com").replace(/\/$/, "");
+    this.baseURL = (options.baseURL || "https://api.fitview.io").replace(/\/$/, "");
     this.timeout = options.timeout ?? 3e5;
     this.apiVersion = options.apiVersion || "v1";
     this.maxRetries = options.maxRetries ?? DEFAULT_MAX_RETRIES;
@@ -8581,7 +8581,22 @@ var FitViewClient = class {
       signal.addEventListener("abort", () => controller.abort());
     }
     requestOptions.signal = controller.signal;
-    const response = await this.fetchImpl(url, requestOptions);
+    let response;
+    try {
+      response = await this.fetchImpl(url, requestOptions);
+    } catch (err) {
+      clearTimeout(timeoutId);
+      const msg = err?.message ?? String(err);
+      const code = err?.code ?? err?.cause?.code;
+      const isDnsFailure = code === "ENOTFOUND" || code === "ENODATA" || /getaddrinfo|ENOTFOUND|ENODATA|Could not resolve host/i.test(msg);
+      if (isDnsFailure) {
+        throw new FitViewNetworkError(
+          `Could not reach the API (${msg}). If you see ENOTFOUND for the API host, the base URL may be wrong: set baseURL in client options or FITVIEW_BASE_URL to your actual API URL (e.g. from your dashboard or Cloud Run).`,
+          err
+        );
+      }
+      throw new FitViewNetworkError(msg || "Network request failed", err);
+    }
     clearTimeout(timeoutId);
     const data = await response.json().catch(() => ({}));
     if (!response.ok) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@outfitcanvas/fitview-sdk",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "TypeScript SDK for FitView API - virtual try-on service",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -52,4 +52,4 @@
   "engines": {
     "node": ">=18.0.0"
   }
-}
+}