@ikonai/sdk-react-ui 1.0.80 → 1.1.1

package/app/boot-snapshot-variant.d.ts

@@ -0,0 +1,8 @@
+import { BootSnapshotVariant } from '../../sdk/sdk-ui/src/index.ts';
+/**
+ * The one seed-axis rule shared by the early prefetch and the IkonUi construction in useIkonApp:
+ * disabled stays disabled; a signed-in load resolves through the SignedInSeeds rules (the route
+ * boot snapshots depict the app's PUBLIC entry views, which identity-split apps override there);
+ * everything else resolves through the guest axis.
+ */
+export declare function resolveBootSnapshotSeedVariant(bootSnapshot: boolean | undefined, signedInLikely: boolean): BootSnapshotVariant | false;

package/app/connection-state-renderer.d.ts

@@ -1,4 +1,4 @@
-import { ConnectionState, IkonClient } from '../../../sdk/src/index.ts';
+import { ConnectionState, IkonClient } from '../../sdk/sdk/src/index.ts';
 import { ReactNode } from 'react';
 import { IkonUiRegistry } from '../ikon-ui-registry';
 import { IkonUiStoreEntry } from '../surface';

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

@@ -1,4 +1,4 @@
-import { ConnectionState, IkonClient, TimeoutConfig, WebRTCTrackMapInfo } from '../../../sdk/src/index.ts';
+import { ConnectionState, IkonClient, TimeoutConfig, WebRTCTrackMapInfo } from '../../sdk/sdk/src/index.ts';
 import { RefObject } from 'react';
 import { AuthConfig, LoginMethod } from '../auth/types';
 import { IkonUiRegistry } from '../ikon-ui-registry';
@@ -7,9 +7,11 @@ import { IkonUiStoreEntry } from '../surface';
 declare global {
     interface Window {
         __IKON_AUTH_CONFIG__?: {
-            enabled: boolean;
             methods: LoginMethod[];
+            requireSignIn?: boolean;
             spaceId: string;
+            /** @deprecated Compat mirror of requireSignIn. */
+            enabled?: boolean;
             backendUrl?: string;
             authUrl?: string;
             devLoginToken?: string;
@@ -114,6 +116,12 @@ export interface UseIkonAppResult {
      * "at capacity" message (the offline overlay) rather than a transient offline/reconnecting state.
      */
     isServerFull: boolean;
+    /**
+     * True when the connect named a specific app session (`?ikon-session=`) that is no longer live.
+     * Terminal — the SDK does not retry and never falls back to a fresh session, so the app should
+     * say the session has ended rather than show a generic connection error.
+     */
+    isSessionExpired: boolean;
     /**
      * UI stores for rendering.
      */

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

@@ -1,4 +1,4 @@
-import { ConnectionState } from '../../../sdk/src/index.ts';
+import { ConnectionState } from '../../sdk/sdk/src/index.ts';
 import { UseIkonAppResult } from './use-ikon-app';
 /**
  * Result of useIkonDebug — same shape as the input `UseIkonAppResult` (so it can be spread

package/auth/auth-context.d.ts

@@ -8,7 +8,7 @@ export interface AuthProviderProps {
  * Authentication provider that manages auth state and provides auth methods.
  * This is a headless provider - it manages state only, no UI rendering.
  */
-export declare function AuthProvider({ children, config }: AuthProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function AuthProvider({ children, config }: AuthProviderProps): import("react").JSX.Element;
 /**
  * Hook to access the auth context.
  * Throws if used outside of AuthProvider.

package/auth/auth-service.d.ts

@@ -9,9 +9,11 @@ export interface OAuthCallbackResult {
 }
 /**
  * Authenticate anonymously with the Ikon auth service.
- * Returns a session with a token for anonymous users.
+ * Returns a session with a token for anonymous users. `flavor` names which not-signed-in identity
+ * to enter as — 'guest' (device-scoped) or 'global' (the space-wide shared identity); omitted =
+ * the space's preference, global first. The server enforces it against the space's login methods.
  */
-export declare function authenticateAnonymous(spaceId: string, authUrl: string): Promise<AuthSession>;
+export declare function authenticateAnonymous(spaceId: string, authUrl: string, flavor?: 'global' | 'guest'): Promise<AuthSession>;
 /**
  * Options for requesting a one-time login code via email.
  */

package/auth/index.d.ts

@@ -1,5 +1,5 @@
 export type { AuthConfig, AuthContextValue, AuthSession, AuthState, AuthUser, LoginMethod } from './types';
-export { clearAuthSession, loadAuthSession, saveAuthSession, sessionToUser } from './storage';
+export { clearAuthSession, isSignedInBootLikely, loadAuthSession, saveAuthSession, sessionToUser } from './storage';
 export { authenticateAnonymous, buildOAuthRedirectUrl, clearOAuthParams, getPasskeyAuthenticationOptions, getPasskeyRegistrationOptions, isPasskeySupported, parseOAuthCallback, parseOAuthError, sendLoginCode, verifyLoginCode, verifyPasskeyAuthentication, verifyPasskeyRegistration, type OAuthCallbackResult, type SendLoginCodeOptions, type VerifyLoginCodeOptions, } from './auth-service';
 export { AuthProvider, useAuth, useAuthOptional, type AuthProviderProps } from './auth-context';
 export { useAuthGuard, type UseAuthGuardOptions, type UseAuthGuardResult } from './use-auth-guard';

package/auth/storage.d.ts

@@ -13,6 +13,14 @@ export declare function saveAuthSession(session: AuthSession): void;
  * Returns null if no session exists or if the session has expired.
  */
 export declare function loadAuthSession(): AuthSession | null;
+/**
+ * Pre-auth heuristic for "this load will connect as a signed-in user": a stored non-anonymous
+ * session, or an OAuth callback in flight (the provider just redirected back with `ikon_token` in
+ * the URL — the session lands in localStorage only after the auth context mounts). Drives
+ * first-paint decisions (which boot-snapshot variant to prefetch) before AuthProvider resolves;
+ * post-auth code should use the real session object instead.
+ */
+export declare function isSignedInBootLikely(): boolean;
 /**
  * Clear the authenticated user session from localStorage.
  */

package/auth/types.d.ts

@@ -1,7 +1,9 @@
 /**
- * All supported login methods.
+ * All supported login methods. The two not-signed-in flavors: 'guest' enters as a device-scoped
+ * anonymous user (private per-visitor sessions); 'global' enters as the space-wide GLOBAL
+ * anonymous identity (all visitors collapse onto a shared app instance).
  */
-export type LoginMethod = 'google' | 'facebook' | 'apple' | 'microsoft' | 'signicat' | 'linkedin' | 'github' | 'email' | 'passkey' | 'guest';
+export type LoginMethod = 'google' | 'facebook' | 'apple' | 'microsoft' | 'signicat' | 'email' | 'passkey' | 'guest' | 'global';
 /**
  * Authenticated user information.
  *
@@ -27,9 +29,19 @@ export interface AuthState {
  * Authentication configuration.
  */
 export interface AuthConfig {
-    enabled: boolean;
     methods: LoginMethod[];
     spaceId: string;
+    /**
+     * When true, the frontend shows a mandatory sign-in wall before the app loads; listing 'guest' in
+     * {@link methods} adds a "Continue as guest" button to that wall. When false (the default) visitors
+     * enter immediately as an anonymous session and sign in on demand via ClientFunctions.LoginAsync —
+     * the AuthProvider is mounted either way, so sign-in is always available.
+     */
+    requireSignIn?: boolean;
+    /** @deprecated Compat mirror of {@link requireSignIn}; read by app source not yet migrated to the always-mounted AuthProvider. */
+    enabled?: boolean;
+    /** @deprecated Superseded by {@link requireSignIn}; anonymous-start is now the default. */
+    deferLogin?: boolean;
     /** Optional backend API URL. If not provided, derived from environment. */
     backendUrl?: string;
     /** Optional custom auth URL. If not provided, derived from environment. */
@@ -58,7 +70,7 @@ export interface AuthSession {
  */
 export interface AuthContextValue {
     state: AuthState;
-    login: (method: LoginMethod) => void;
+    login: (method: LoginMethod) => Promise<void>;
     logout: () => void;
     getToken: () => string | null;
     registerPasskey: (name?: string) => Promise<void>;

package/auth/use-auth-guard.d.ts

@@ -27,6 +27,16 @@ export interface UseAuthGuardResult {
      * Current auth error, if any.
      */
     error: string | null;
+    /**
+     * True when the login screen is showing in response to an on-demand prompt (ClientFunctions.LoginShowAsync
+     * or a login_required error) while the app is otherwise accessible — as opposed to a hard sign-in wall.
+     * Use it to offer a dismiss affordance.
+     */
+    isLoginPrompt: boolean;
+    /**
+     * Dismiss an on-demand login prompt and return to the app. No effect on a hard sign-in wall.
+     */
+    dismissLoginPrompt: () => void;
 }
 /**
  * Headless hook for route protection logic.

package/debug/debug-overlay.d.ts

@@ -21,4 +21,4 @@ export interface DebugOverlayProps {
 /**
  * The overlay component. Returns null unless `?ikon-debug-overlay=true` is set or `forceVisible`.
  */
-export declare function DebugOverlay({ state, forceVisible }: DebugOverlayProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function DebugOverlay({ state, forceVisible }: DebugOverlayProps): import("react").JSX.Element | null;

package/hooks/use-ikon-reactive.d.ts

@@ -1,4 +1,4 @@
-import { IkonClient } from '../../../sdk/src/index.ts';
+import { IkonClient } from '../../sdk/sdk/src/index.ts';
 /**
  * Subscribe to a server-side <c>Reactive&lt;T&gt;</c> and re-render whenever
  * the value changes. The hook returns the current value, starting from the

package/hooks/use-reactive.d.ts

@@ -1,4 +1,4 @@
-import { IkonClient } from '../../../sdk/src/index.ts';
+import { IkonClient } from '../../sdk/sdk/src/index.ts';
 /**
  * Subscribe to a server-side <c>Reactive&lt;T&gt;</c> by the C# member name it
  * was declared with. Resolves the stable id once via the framework function

package/i18n/i18n.d.ts

@@ -11,6 +11,6 @@ export interface I18nProviderProps<T> {
     defaultLanguage?: string;
     detectLanguage?: boolean;
 }
-export declare function I18nProvider<T extends object>({ children, translations, defaultLanguage, detectLanguage, }: I18nProviderProps<T>): import("react/jsx-runtime").JSX.Element;
+export declare function I18nProvider<T extends object>({ children, translations, defaultLanguage, detectLanguage, }: I18nProviderProps<T>): import("react").JSX.Element;
 export declare function useI18n<T extends object>(): I18nContextValue<T>;
 export {};

package/ikon-ui.d.ts

@@ -1,5 +1,5 @@
-import { IkonClient } from '../../sdk/src/index.ts';
-import { IkonUiCore, IkonUiCoreConfig, IkonUiStreamListener, IkonUiUpdateListener, UiStyleListener, UiStyleDeleteListener, UiStylePayload } from '../../sdk-ui/src/index.ts';
+import { IkonClient } from '../sdk/sdk/src/index.ts';
+import { IkonUiCore, IkonUiCoreConfig, IkonUiStreamListener, IkonUiUpdateListener, UiStyleListener, UiStyleDeleteListener, UiStylePayload } from '../sdk/sdk-ui/src/index.ts';
 import { IkonUiStoreEntry } from './surface';
 export interface IkonUiConfig {
     client?: IkonClient | null;

package/index.d.ts

@@ -9,7 +9,7 @@ export { IKON_UI_MEDIA_MODULE, IKON_UI_VIDEO_CANVAS_TYPE, IKON_UI_VIDEO_URL_PLAY
 export { IKON_UI_SHADERTOY_MODULE, IKON_UI_SHADERTOY_TYPE, createShadertoyRendererResolver, loadShadertoyModule, registerShadertoyModule } from './shadertoy/shadertoy-module';
 export { UiRenderer, type UiRendererProps, UiComponentRegistry, createComponentLibrary, useUiStore, useUiNode, renderChildren } from './renderer';
 export type { UiComponentRenderer, UiComponentLibrary, UiNode, UiRenderContext, UiComponentRendererProps, ParsedUiUpdate, UiSnapshot, UiFullSnapshot, UiDiffSnapshot, UiNodeDiff, TextDelta, UiNodeProps, UiUpdateType, UiStoreSnapshot } from './renderer';
-export { UiStreamStore, type UiStylePayload } from '../../sdk-ui/src/index.ts';
+export { UiStreamStore, type UiStylePayload } from '../sdk/sdk-ui/src/index.ts';
 export { renderMotionLetters } from './shared/render-motion-letters';
 export { type AuthConfig, type AuthContextValue, type AuthSession, type AuthState, type AuthUser, type LoginMethod, clearAuthSession, loadAuthSession, saveAuthSession, sessionToUser, authenticateAnonymous, buildOAuthRedirectUrl, clearOAuthParams, parseOAuthCallback, parseOAuthError, sendLoginCode, verifyLoginCode, type OAuthCallbackResult, type SendLoginCodeOptions, type VerifyLoginCodeOptions, AuthProvider, useAuth, useAuthOptional, type AuthProviderProps, useAuthGuard, type UseAuthGuardOptions, type UseAuthGuardResult, } from './auth';
 export { ConnectionStateRenderer, type ConnectedRenderProps, type ConnectionStateRendererProps, useIkonApp, type IkonUiModuleRegistration, type UseIkonAppOptions, type UseIkonAppResult, IkonApp, type IkonAppProps, type ConnectingOverlayProp, type ReconnectingOverlayProp, type OfflineOverlayProp, type AccessDeniedScreenProp, useIkonDebug, type UseIkonDebugResult, } from './app';
@@ -17,4 +17,4 @@ export { useLazyFont, useToasts, useIkonReactive, useReactive, type Toast } from
 export { I18nProvider, useI18n, type I18nContextValue, type I18nProviderProps } from './i18n';
 export { InspectOverlay, type InspectElementPayload } from './inspect/inspect-overlay';
 export { DebugOverlay, DEBUG_OVERLAY_ENABLED, type DebugOverlayProps } from './debug/debug-overlay';
-export { randomUuid } from '../../sdk/src/index.ts';
+export { randomUuid } from '../sdk/sdk/src/index.ts';