@ikonai/sdk-react-ui 1.0.59 → 1.0.61

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

@@ -94,6 +94,12 @@ export interface UseIkonAppResult {
      * When set, the app should show an access denied screen instead of the normal UI.
      */
     accessDeniedReason: string | null;
+    /**
+     * True when the server rejected the connection because it is at capacity (the app instance
+     * reached its maximum client limit). Terminal — the SDK does not retry. The app should show an
+     * "at capacity" message (the offline overlay) rather than a transient offline/reconnecting state.
+     */
+    isServerFull: boolean;
     /**
      * UI stores for rendering.
      */
@@ -126,6 +132,11 @@ export interface UseIkonAppResult {
      * Whether the connection is ready to render UI.
      */
     isReady: boolean;
+    /**
+     * True when the backend asked the client to display the platform branding banner (set for
+     * low-tier app creators by the connect handshake). Defaults to false until connected.
+     */
+    brandingRequired: boolean;
     /**
      * True after `connectionState === 'connecting'` has lasted longer than the slow-connection
      * threshold (default 5s, configurable via `timeouts.slowConnectionThresholdMs`). The connecting

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

@@ -18,6 +18,10 @@ export interface UseIkonDebugResult {
     forcedError: string | null;
     /** Non-null when the access-denied override is active. */
     forcedAccessDenied: string | null;
+    /** True when the branding-banner override is active (forces the banner on regardless of tier). */
+    forcedBranding: boolean;
+    /** True when the debug-overlay override is active (forces the on-screen overlay visible). */
+    forcedDebugOverlay: boolean;
     /** True when the debug shortcuts are active in this environment. */
     debugEnabled: boolean;
 }
@@ -35,6 +39,8 @@ export interface UseIkonDebugResult {
  * - Digit4 → force `offline` (no error)
  * - Digit5 → force `offline` with synthetic error
  * - Digit6 → force access-denied (synthetic reason — exercises the accessDeniedScreen path)
+ * - Digit7 → toggle the platform branding banner (normally driven by the backend tier flag)
+ * - Digit8 → toggle the on-screen debug overlay (normally gated on `?ikon-debug-overlay=true`)
  * - Digit0 → clear all state overrides
  * - KeyE  → toggle empty-stores override (simulates "initial connection never produced UI")
  */

package/debug/debug-overlay.d.ts

@@ -0,0 +1,24 @@
+/**
+ * On-screen debug overlay, enabled with `?ikon-debug-overlay=true`.
+ *
+ * Surfaces the environment, connection-state timeline, and ALL captured JS errors + SDK log
+ * events directly on screen — invaluable for debugging on devices with no usable console
+ * (smart TVs, phones, kiosks). This is a DISTINCT opt-in from `ikon-debug` (verbose logging /
+ * devtools): debug mode does NOT force the visual overlay, since on a desktop you usually want
+ * a console, not a panel over the UI.
+ *
+ * Rendered automatically by {@link IkonApp} and the (deprecated) ConnectionStateRenderer, so
+ * apps get it for free; it returns null unless the param is set, making it zero-cost when off.
+ */
+export declare const DEBUG_OVERLAY_ENABLED: boolean;
+export interface DebugOverlayProps {
+    /** Current connection state, shown in the header. When 'connected'/'reconnecting' the panel
+     *  renders as a small collapsible corner badge instead of a full-screen panel. */
+    state?: string;
+    /** Force the overlay visible even without `?ikon-debug-overlay=true` (debug keyboard toggle). */
+    forceVisible?: boolean;
+}
+/**
+ * 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;

package/index.d.ts

@@ -17,3 +17,5 @@ export { ConnectionStateRenderer, type ConnectedRenderProps, type ConnectionStat
 export { useLazyFont, useToasts, useIkonReactive, useReactive, type Toast } from './hooks';
 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';