@ikonai/sdk-react-ui 1.8.0 → 1.10.0

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

@@ -2,6 +2,7 @@ import { ConnectionState, IkonClient } from '../../sdk/sdk/src/index.ts';
 import { ReactNode } from 'react';
 import { IkonUiRegistry } from '../ikon-ui-registry';
 import { IkonUiStoreEntry } from '../surface';
+import { DispatchActionOptions } from '../renderer';
 /**
  * Props passed to the renderConnected callback.
  */
@@ -9,7 +10,7 @@ export interface ConnectedRenderProps {
     stores: ReadonlyMap<string, IkonUiStoreEntry>;
     registry: IkonUiRegistry;
     client: IkonClient | null;
-    onAction: (actionId: string, payload: unknown) => void;
+    onAction: (actionId: string, payload: unknown, options?: DispatchActionOptions) => void;
     isReconnecting: boolean;
 }
 /**
@@ -27,7 +28,7 @@ export interface ConnectionStateRendererProps {
     stores: ReadonlyMap<string, IkonUiStoreEntry> | undefined;
     registry: IkonUiRegistry | null;
     client: IkonClient | null;
-    onAction: (actionId: string, payload: unknown) => void;
+    onAction: (actionId: string, payload: unknown, options?: DispatchActionOptions) => void;
     /**
      * @deprecated The runtime no longer emits `'idle'`; this callback never fires. The
      * prop stays for source-compatibility with apps that already pass it.
@@ -53,8 +54,7 @@ export interface ConnectionStateRendererProps {
      */
     renderOffline: () => ReactNode;
     /**
-     * Render when offline with an error message attached. Full-page replacement.
-     * Previously fired only for the dropped `'offlineError'` state; now fires when
+     * Render when offline with an error message attached. Full-page replacement. Fires when
      * `connectionState === 'offline'` and `error` (or `client.lastError`) is set.
      */
     renderError: (error: string | null) => ReactNode;

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

@@ -0,0 +1 @@
+export {};

package/app/ikon-app.d.ts

@@ -48,8 +48,8 @@ export interface IkonAppProps extends UseIkonAppResult {
  * />
  * ```
  *
- * Debug keyboard shortcuts (Ctrl+Shift+1..6, 0, E) are wired up automatically when SDK
- * debug mode is on (URL has `?ikon-debug=true`). See `useIkonDebug` for the full map.
- * No on-screen indicator is rendered for active overrides.
+ * Debug keyboard shortcuts are wired up automatically when SDK debug mode is on (URL has
+ * `?ikon-debug=true`); `useIkonDebug` holds the map. No on-screen indicator is rendered for
+ * active overrides.
  */
 export declare function IkonApp(props: IkonAppProps): ReactNode;

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

@@ -0,0 +1 @@
+export {};

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

@@ -1,6 +1,7 @@
 import { ConnectionState, IkonClient, TimeoutConfig, WebRTCTrackMapInfo } from '../../sdk/sdk/src/index.ts';
 import { RefObject } from 'react';
 import { AuthConfig, LoginMethod } from '../auth/types';
+import { DispatchActionOptions } from '../renderer';
 import { IkonUiRegistry } from '../ikon-ui-registry';
 import { IkonUi } from '../ikon-ui';
 import { IkonUiStoreEntry } from '../surface';
@@ -37,13 +38,10 @@ export type IkonUiModuleRegistration = (registry: IkonUiRegistry) => void;
  */
 export declare function mergeConnectParameters(urlParameters: Record<string, string>, appParameters?: Record<string, string>): Record<string, string>;
 /**
- * Who a session is for, as opposed to what it presents to prove it.
- *
- * A browser access token is worth 15 minutes and is renewed roughly every 13, and a renewal is the
- * same person holding a fresher credential. Keying the connection on the token's value made every
- * renewal look like a different session, so a signed-in app tore its IkonClient down and rebuilt it
- * every renewal period on a perfectly healthy network. Keying on the subject instead leaves only a
- * genuine change of user — or of sign-in method — forcing a reconnect.
+ * Who a session is for, as opposed to what it presents to prove it. A browser access token is
+ * renewed every few minutes, and a renewal is the same person holding a fresher credential, so the
+ * connection is keyed on the subject: only a genuine change of user, or of sign-in method, forces
+ * a reconnect.
  *
  * A token whose subject cannot be read falls back to the token itself: two credentials nobody can
  * identify must not be assumed to name the same person.
@@ -199,7 +197,7 @@ export interface UseIkonAppResult {
     /**
      * Action handler for UI interactions.
      */
-    onAction: (actionId: string, payload: unknown) => void;
+    onAction: (actionId: string, payload: unknown, options?: DispatchActionOptions) => void;
     /**
      * Whether the connection is ready to render UI.
      */

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

@@ -33,7 +33,7 @@ export interface UseIkonDebugResult {
  * `<IkonApp />` and want the same behavior.
  *
  * Shortcut map (all require Ctrl+Shift, `event.code`-based so layout-independent):
- * - Digit1 → force `connecting` (an internal 5s timer flips isConnectingSlow to true so you can see both phases without a second shortcut)
+ * - Digit1 → force `connecting` (an internal timer flips isConnectingSlow to true so you can see both phases without a second shortcut)
  * - Digit2 → force `connected`
  * - Digit3 → force `reconnecting`
  * - Digit4 → force `offline` (no error)

package/auth/index.d.ts

@@ -3,4 +3,4 @@ export { clearAuthSession, isSignedInBootLikely, loadAuthSession, saveAuthSessio
 export { authenticateAnonymous, buildOAuthRedirectUrl, clearOAuthParams, describeAuthError, exchangeOAuthCode, getPasskeyAuthenticationOptions, getPasskeyRegistrationOptions, isPasskeySupported, parseOAuthCallback, parseOAuthCodeCallback, parseOAuthError, revokeSessionOnServer, sendLoginCode, verifyLoginCode, verifyPasskeyAuthentication, verifyPasskeyRegistration, type OAuthCallbackResult, type OAuthErrorResult, 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';
-export { OAUTH_CONTINUE_PARAM, captureOAuthContinuation, completeOAuthContinuation, hasPendingOAuthContinuation } from './oauth-continuation';
+export { OAUTH_CONTINUE_PARAM, captureOAuthContinuation, completeOAuthContinuation, hasPendingOAuthContinuation, type OAuthContinuationOutcome } from './oauth-continuation';

package/auth/oauth-continuation.d.ts

@@ -23,6 +23,20 @@ export declare const OAUTH_CONTINUE_PARAM = "ikon-oauth";
  */
 export declare function captureOAuthContinuation(): boolean;
 export declare function hasPendingOAuthContinuation(): boolean;
+export type OAuthContinuationOutcome = 
+/** The browser is on its way to the consent screen. */
+{
+    status: 'handed-off';
+}
+/** The server said this person may not authorize here, and said why. Show it. */
+ | {
+    status: 'refused';
+    message: string;
+}
+/** Kept for a retry, or given up on — the pointer's own state says which. */
+ | {
+    status: 'pending';
+};
 /**
  * Report the completed sign-in and hand the browser to the consent screen.
  *
@@ -41,4 +55,4 @@ export declare function hasPendingOAuthContinuation(): boolean;
  * keeps the pointer so a later attempt can succeed, while a refusal from the server clears it, because
  * retrying a spent or expired authorization only traps the user in a flow that cannot finish.
  */
-export declare function completeOAuthContinuation(token: string | null): Promise<boolean>;
+export declare function completeOAuthContinuation(token: string | null): Promise<OAuthContinuationOutcome>;

package/index.d.ts

@@ -11,7 +11,7 @@ export { useSiblingClient, type UseSiblingClientResult } from './media/use-sibli
 export { useMicrophoneCapture, useCameraCapture, useScreenCapture, type UseMediaCaptureResult } from './media/use-media-capture';
 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 type { DispatchActionOptions, UiComponentRenderer, UiComponentLibrary, UiNode, UiRenderContext, UiComponentRendererProps, ParsedUiUpdate, UiSnapshot, UiFullSnapshot, UiDiffSnapshot, UiNodeDiff, TextDelta, UiNodeProps, UiUpdateType, UiStoreSnapshot } from './renderer';
 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';