@ikonai/sdk 1.0.44 → 1.0.45

package/login/index.d.ts

@@ -0,0 +1,4 @@
+export { getLoginPromptState, setLoginPromptRequired, clearLoginPrompt, subscribe, setLoginPendingCall, consumeLoginPendingCall, PENDING_CALL_KEY } from './login-store';
+export type { LoginPromptState, LoginPendingCall } from './login-store';
+export { loginErrorInterceptor } from './login-error-interceptor';
+export { reprovisionAfterLogin, consumeLoginHandoff } from './reprovision';

package/login/login-error-interceptor.d.ts

@@ -0,0 +1,13 @@
+import { ErrorInterceptor } from '../functions/function-registry';
+/**
+ * Error interceptor for the deferred-login flow.
+ *
+ * When a function call fails with code "login_required":
+ * 1. Stashes the pending call in sessionStorage (for replay after page reload).
+ * 2. Sets the login prompt state to required (triggers the login dialog).
+ * 3. Returns null so the original promise rejects normally with the error.
+ *
+ * After the user logs in, the page reloads against the new endpoint.
+ * The app's mount logic reads the pending call from sessionStorage and auto-invokes it.
+ */
+export declare const loginErrorInterceptor: ErrorInterceptor;

package/login/login-store.d.ts

@@ -0,0 +1,17 @@
+export declare const PENDING_CALL_KEY = "ikon.login.pendingCall";
+export interface LoginPromptState {
+    required: boolean;
+    reason: string | null;
+}
+export interface LoginPendingCall {
+    functionName: string;
+    args: unknown[];
+}
+type Listener = () => void;
+export declare function getLoginPromptState(): LoginPromptState;
+export declare function setLoginPromptRequired(reason: string | null): void;
+export declare function clearLoginPrompt(): void;
+export declare function subscribe(listener: Listener): () => void;
+export declare function setLoginPendingCall(pending: LoginPendingCall): void;
+export declare function consumeLoginPendingCall(): LoginPendingCall | null;
+export {};

package/login/reprovision.d.ts

@@ -0,0 +1,22 @@
+import { consumeLoginPendingCall } from './login-store';
+/**
+ * Reprovision the client by reloading the page against a new server endpoint.
+ *
+ * The deferred-login handoff data (pending call, app route) lives in sessionStorage
+ * and survives the page reload. On reload, the app boots against the new endpoint
+ * (which now has a real user identity) and the app's mount logic can replay the
+ * pending call from sessionStorage via {@link consumeLoginHandoff}.
+ *
+ * This follows the same pattern as `ikon.client.logout` (clear + reload).
+ *
+ * @param connectUrl The full connect URL for the authenticated session.
+ */
+export declare function reprovisionAfterLogin(connectUrl: string): void;
+/**
+ * Check on app mount whether we just came back from a login reprovision.
+ * Returns the app route to restore and any pending call to replay.
+ */
+export declare function consumeLoginHandoff(): {
+    appRoute: string | null;
+    pendingCall: ReturnType<typeof consumeLoginPendingCall>;
+};

package/package.json

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

package/utils/query-params.d.ts

@@ -18,6 +18,8 @@
  * - ikon-video        Force video on (true) or off (false)
  * - ikon-webrtc       Force WebRTC on (true) or off (false)
  * - ikon-inspect      Enable element inspection overlay (true)
+ * - ikon-retry        Enable retry loops in auth/channel connect (default true; set false to fail fast)
+ * - ikon-api          Route backend API calls through same-origin /ikon/api path (true) instead of api.{env}.ikon.live
  */
 export declare const IKON_PARAM_PROXY = "ikon-proxy";
 export declare const IKON_PARAM_WEBSOCKET = "ikon-websocket";
@@ -31,6 +33,8 @@ export declare const IKON_PARAM_AUDIO = "ikon-audio";
 export declare const IKON_PARAM_VIDEO = "ikon-video";
 export declare const IKON_PARAM_WEBRTC = "ikon-webrtc";
 export declare const IKON_PARAM_INSPECT = "ikon-inspect";
+export declare const IKON_PARAM_RETRY = "ikon-retry";
+export declare const IKON_PARAM_API = "ikon-api";
 /**
  * Set an SDK query parameter in the URL via history.replaceState.
  */
@@ -45,3 +49,5 @@ export declare function getAudioParam(): boolean | null;
 export declare function getVideoParam(): boolean | null;
 export declare function getWebRtcParam(): boolean | null;
 export declare function getInspectParam(): boolean;
+export declare function getRetryParam(): boolean;
+export declare function getApiParam(): boolean | null;