@ikonai/sdk 1.0.30 → 1.0.32

package/client/ikon-client-config.d.ts

@@ -80,6 +80,14 @@ export interface LocalConfig extends CommonConnectionConfig {
      * get-or-create the user's profile before connecting.
      */
     token?: string;
+    /**
+     * Backend API URL for profile operations. If not provided, derived from environment.
+     */
+    backendUrl?: string;
+    /**
+     * Auth service URL for anonymous authentication. If not provided, derived from environment.
+     */
+    authUrl?: string;
 }
 /**
  * Common options for cloud-based modes (apiKey and sessionToken).

package/connection/urls.d.ts

@@ -18,14 +18,15 @@ export declare const IKON_AUTH_BASE_URL = "https://auth.ikonai.com";
  */
 export declare function getBackendUrl(backendType?: BackendType): string;
 /**
- * Derive backend API URL from environment or window.location.hostname.
+ * Derive backend API URL.
  * Priority:
- * 1. VITE_IKON_BACKEND_URL env var (set by .NET server during local dev)
- * 2. Local environment (localhost, LAN IPs) → IKON_BACKEND_URL_DEV
- * 3. Hostname contains '.dev.' → IKON_BACKEND_URL_DEV
- * 4. Default → IKON_BACKEND_URL_PROD
+ * 1. Explicit override (e.g. from config)
+ * 2. VITE_IKON_BACKEND_URL env var (set by .NET server during local dev)
+ * 3. Local environment (localhost, LAN IPs) → IKON_BACKEND_URL_DEV
+ * 4. Hostname contains '.dev.' → IKON_BACKEND_URL_DEV
+ * 5. Default → IKON_BACKEND_URL_PROD
  */
-export declare function deriveBackendUrl(): string;
+export declare function deriveBackendUrl(override?: string): string;
 /**
  * Derive backend type from environment or window.location.hostname.
  * Priority:
@@ -37,14 +38,15 @@ export declare function deriveBackendUrl(): string;
  */
 export declare function deriveBackendType(): BackendType;
 /**
- * Derive auth service URL from environment or window.location.hostname.
+ * Derive auth service URL.
  * Priority:
- * 1. VITE_IKON_AUTH_URL env var (set by .NET server during local dev)
- * 2. Local environment (localhost, LAN IPs) → IKON_AUTH_URL_DEV
- * 3. Hostname contains '.dev.' → IKON_AUTH_URL_DEV
- * 4. Default → IKON_AUTH_URL_PROD
+ * 1. Explicit override (e.g. from config)
+ * 2. VITE_IKON_AUTH_URL env var (set by .NET server during local dev)
+ * 3. Local environment (localhost, LAN IPs) → IKON_AUTH_URL_DEV
+ * 4. Hostname contains '.dev.' → IKON_AUTH_URL_DEV
+ * 5. Default → IKON_AUTH_URL_PROD
  */
-export declare function deriveAuthUrl(): string;
+export declare function deriveAuthUrl(override?: string): string;
 /**
  * Parse URL query parameters.
  */