@ikonai/sdk-react-ui 1.0.69 → 1.0.71

package/app/use-ikon-app.d.ts

@@ -12,6 +12,8 @@ declare global {
             spaceId: string;
             backendUrl?: string;
             authUrl?: string;
+            devLoginToken?: string;
+            devLoginRunId?: string;
         };
         __IKON_LOCAL_IKON_SERVER_CONFIG__?: {
             enabled: boolean;
@@ -83,9 +85,9 @@ export interface UseIkonAppOptions {
      */
     liveSnapshot?: boolean;
     /**
-     * Boot snapshot: seed the build-time `boot-snapshot.json` (present when the app was bundled with
-     * `--snapshot`) before the WebSocket connects, for instant first paint on a first visit. Default:
-     * true. Set false to skip both the prefetch and the seed.
+     * Boot snapshot: seed the build-time `boot-snapshot.json` (present when the app enabled the
+     * `[BootSnapshot]` section in `ikon-config.toml`) before the WebSocket connects, for instant first
+     * paint on a first visit. Default: true. Set false to skip both the prefetch and the seed.
      */
     bootSnapshot?: boolean;
 }

package/auth/storage.d.ts

@@ -1,4 +1,9 @@
 import { AuthSession, AuthUser } from './types';
+/**
+ * Check whether a JWT token has expired by decoding its `exp` claim.
+ * Returns true when the token is expired or cannot be decoded.
+ */
+export declare function isTokenExpired(token: string): boolean;
 /**
  * Save the authenticated user session to localStorage.
  */
@@ -12,6 +17,15 @@ export declare function loadAuthSession(): AuthSession | null;
  * Clear the authenticated user session from localStorage.
  */
 export declare function clearAuthSession(): void;
+/**
+ * Mark dev auto-login as having been attempted for the given `ikon app run` id (stored in sessionStorage
+ * so it survives the logout's localStorage.clear() + reload). A no-op when no run id is available.
+ */
+export declare function markAutoLoginAttempted(runId: string | undefined): void;
+/**
+ * Read the run id for which dev auto-login was already attempted this tab, or null if none.
+ */
+export declare function getAutoLoginAttemptedRunId(): string | null;
 /**
  * Convert AuthSession to AuthUser.
  */

package/auth/types.d.ts

@@ -4,10 +4,13 @@
 export type LoginMethod = 'google' | 'facebook' | 'apple' | 'microsoft' | 'signicat' | 'linkedin' | 'github' | 'email' | 'passkey' | 'guest';
 /**
  * Authenticated user information.
+ *
+ * `provider` covers the interactive login methods plus 'anonymous' (guest backend session) and 'dev'
+ * (local `ikon app run` developer auto-login).
  */
 export interface AuthUser {
     id: string;
-    provider: LoginMethod | 'anonymous';
+    provider: LoginMethod | 'anonymous' | 'dev';
     token: string;
     authenticatedAt: number;
 }
@@ -31,13 +34,23 @@ export interface AuthConfig {
     backendUrl?: string;
     /** Optional custom auth URL. If not provided, derived from environment. */
     authUrl?: string;
+    /**
+     * Developer JWT injected by a local `ikon app run` to auto-login as the `ikon login` developer.
+     * Local dev only — never set in deployed builds.
+     */
+    devLoginToken?: string;
+    /**
+     * Unique id for the current `ikon app run`. Auto-login is suppressed once the user logs out within a
+     * run, but a new run mints a new id and re-enables it. Paired with {@link devLoginToken}.
+     */
+    devLoginRunId?: string;
 }
 /**
  * Stored session data in localStorage.
  */
 export interface AuthSession {
     token: string;
-    provider: LoginMethod | 'anonymous';
+    provider: LoginMethod | 'anonymous' | 'dev';
     authenticatedAt: number;
 }
 /**

package/index.d.ts

@@ -4,7 +4,6 @@ export { IkonUiSurface, IKON_UI_STREAM_CATEGORY, isIkonUiCategoryMatch, type Iko
 export { ParallaxView, type ParallaxViewProps } from './parallax-view';
 export { useIkonStyles, type IkonUiStyleSource } from './use-ikon-styles';
 export { useIkonUiStores } from './use-ikon-ui-stores';
-export { parseIkonUiInitPayload, normalizeIkonUiModuleList, readIkonUiModules, readIkonUiModulesFromSources, areIkonUiModuleListsEqual, type IkonUiInitInstruction, type IkonUiInitModulePayload, type IkonUiModuleList } from './modules';
 export { IKON_UI_BASE_MODULE, createBaseResolvers, loadBaseModule, registerBaseModule } from './base/base-module';
 export { IKON_UI_MEDIA_MODULE, IKON_UI_VIDEO_CANVAS_TYPE, IKON_UI_VIDEO_URL_PLAYER_TYPE, createMediaResolvers, loadMediaModule, registerMediaModule } from './media/media-module';
 export { IKON_UI_SHADERTOY_MODULE, IKON_UI_SHADERTOY_TYPE, createShadertoyRendererResolver, loadShadertoyModule, registerShadertoyModule } from './shadertoy/shadertoy-module';