@ikonai/sdk 1.0.31 → 1.0.33

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.
  */

package/index.js

@@ -4204,20 +4204,22 @@ const xe = {}, it = "https://api.prod.ikon.live", ot = "https://api.dev.ikon.liv
 function ps(t) {
   return t === "development" ? ot : it;
 }
-function Kt() {
-  const t = typeof import.meta < "u" ? xe?.VITE_IKON_BACKEND_URL : void 0;
-  return t || (typeof window > "u" ? it : !Nt() || window.location.hostname.includes(".dev.") ? ot : it);
+function Kt(t) {
+  if (t) return t;
+  const e = typeof import.meta < "u" ? xe.VITE_IKON_BACKEND_URL : void 0;
+  return e || (typeof window > "u" ? it : !Nt() || window.location.hostname.includes(".dev.") ? ot : it);
 }
 function Of() {
-  const t = typeof import.meta < "u" ? xe?.VITE_IKON_BACKEND_TYPE : void 0;
+  const t = typeof import.meta < "u" ? xe.VITE_IKON_BACKEND_TYPE : void 0;
   if (t === "development" || t === "production")
     return t;
-  const e = typeof import.meta < "u" ? xe?.VITE_IKON_BACKEND_URL : void 0;
+  const e = typeof import.meta < "u" ? xe.VITE_IKON_BACKEND_URL : void 0;
   return e ? e.includes(".dev.") ? "development" : "production" : typeof window > "u" ? "production" : Nt() ? window.location.hostname.includes(".dev.") ? "development" : "production" : "development";
 }
-function Nd() {
-  const t = typeof import.meta < "u" ? xe?.VITE_IKON_AUTH_URL : void 0;
-  return t || (typeof window > "u" ? Ht : !Nt() || window.location.hostname.includes(".dev.") ? $t : Ht);
+function Nd(t) {
+  if (t) return t;
+  const e = typeof import.meta < "u" ? xe.VITE_IKON_AUTH_URL : void 0;
+  return e || (typeof window > "u" ? Ht : !Nt() || window.location.hostname.includes(".dev.") ? $t : Ht);
 }
 function Ye() {
   if (typeof window > "u")
@@ -4447,12 +4449,12 @@ async function Fd(t, e) {
   const s = { ...Ye(), ...t.parameters }, i = t.deviceId ?? Ke();
   let o = t.userId, a = t.token;
   if (!o) {
-    const S = await Ud(t.spaceId, i, Nd(), e);
+    const S = await Ud(t.spaceId, i, Nd(t.authUrl), e);
     S && (o = S.userId, a = S.token);
   }
   if (o || (o = i, ee.debug("Using deviceId as userId fallback")), t.spaceId && a)
     if (t.token) {
-      const S = Kt(), _ = await fetch(`${S}/profiles/me?space=${encodeURIComponent(t.spaceId)}`, {
+      const S = Kt(t.backendUrl), _ = await fetch(`${S}/profiles/me?space=${encodeURIComponent(t.spaceId)}`, {
         method: "GET",
         headers: { Authorization: `Bearer ${a}` },
         signal: e
@@ -4462,7 +4464,7 @@ async function Fd(t, e) {
         throw new N(`Failed to get or create profile: ${_.status} ${E}`);
       }
     } else
-      await Od(Kt(), t.spaceId, a, e);
+      await Od(Kt(t.backendUrl), t.spaceId, a, e);
   const c = Pd({ ...t, parameters: s }, o), l = Ld(c), f = await fetch(`${n}/connect-token`, {
     method: "POST",
     headers: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikonai/sdk",
-  "version": "1.0.31",
+  "version": "1.0.33",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",