@ikonai/sdk 1.8.0 → 1.11.0

package/client/connection-state.d.ts

@@ -35,3 +35,4 @@ export declare function isOffline(state: ConnectionState): boolean;
  * @deprecated The runtime no longer emits `offlineError`. Read `useIkonApp().error` to detect offline-with-error.
  */
 export declare function isError(state: ConnectionState): boolean;
+//# sourceMappingURL=connection-state.d.ts.map

package/client/connection-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-state.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk/src/client/connection-state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,eAAe;AACzB,wEAAwE;AACtE,MAAM,GACN,8BAA8B,GAC9B,YAAY;AACd,4FAA4F;GAC1F,gBAAgB,GAChB,WAAW,GACX,cAAc,GACd,SAAS;AACX,mHAAmH;GACjH,cAAc,CAAC;AAEnB;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEzD;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAEvD"}

package/client/endpoint-selector.d.ts

@@ -1,4 +1,4 @@
-import { Entrypoint, EntrypointType } from '../../shared/protocol/src/index.ts';
+import { Entrypoint, EntrypointType } from '@ikonai/protocol';
 import { HttpStreamMode } from '../transport/transport';
 import { LocalConfig } from './ikon-client-config';
 /**
@@ -172,3 +172,4 @@ export declare class EndpointSelector {
     private loadConnectTier;
     private setConnectTier;
 }
+//# sourceMappingURL=endpoint-selector.d.ts.map

package/client/endpoint-selector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-selector.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk/src/client/endpoint-selector.ts"],"names":[],"mappings":"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"}

package/client/ikon-client-config.d.ts

@@ -1,4 +1,4 @@
-import { ProtocolMessage } from '../../shared/protocol/src/index.ts';
+import { ProtocolMessage } from '@ikonai/protocol';
 import { BackendType } from '../connection/urls';
 import { ConnectionState } from './connection-state';
 import { IkonAudioPlaybackConfig } from '../media/ikon-audio-playback';
@@ -341,6 +341,14 @@ export interface IkonClientConfig {
      * Default: false
      */
     disableBrowserFunctions?: boolean;
+    /**
+     * Disable the sound-effect functions (`ikon.client.playSound` / `stopSound`) and
+     * the gesture-driven audio unlock they install on the first sound. For an app
+     * that plays its own audio, or one that never wants a media element touched
+     * inside its touch handlers. The other browser functions stay registered.
+     * Default: false
+     */
+    disableSoundFunctions?: boolean;
     /**
      * Force WebSocket transport only. When true, only WebSocket (and WebSocketProxy)
      * endpoint types are used. When false, WebSocket types are excluded.
@@ -410,3 +418,8 @@ export declare const DEFAULT_PROVISIONING_TIMEOUT_MS = 60000;
 export declare const OFFLINE_SOFT_RETRY_THRESHOLD_MS: number;
 export declare const RECONNECT_RETRY_INTERVAL_MS: number;
 export declare const JOIN_COMPLETION_TIMEOUT_MS = 10000;
+export declare const LIVENESS_BUDGET_DIVISOR = 3;
+export declare const MIN_LIVENESS_BUDGET_MS = 15000;
+export declare const CORROBORATED_LIVENESS_BUDGET_MS = 5000;
+export declare const OFFLINE_PROBE_TIMEOUT_MS = 3000;
+//# sourceMappingURL=ikon-client-config.d.ts.map

package/client/ikon-client-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ikon-client-config.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk/src/client/ikon-client-config.ts"],"names":[],"mappings":"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"}

package/client/ikon-client.d.ts

@@ -1,7 +1,8 @@
-import { EntrypointType, GlobalState, ProtocolMessage } from '../../shared/protocol/src/index.ts';
+import { EntrypointType, GlobalState, ProtocolMessage } from '@ikonai/protocol';
 import { WebRTCSignaling } from '../webrtc';
 import { FunctionRegistry } from '../functions/function-registry';
 import { ReactiveRegistry } from '../reactive/reactive-registry';
+import { BackendAccess, FeedbackClientConfiguration } from '../feedback/feedback-api';
 import { IkonMedia } from '../media/ikon-media';
 import { IkonMediaCapture } from '../media/ikon-media-capture';
 import { VisemeTracker } from '../media/viseme-tracker';
@@ -62,9 +63,20 @@ export interface ProtocolMessageSubscriptionOptions {
  * State handler callback type for state subscribers.
  */
 export type StateHandler = (state: ConnectionState) => void;
+/** How a dispatched UI action should be treated when the server refuses it. */
+export interface SendActionCallOptions {
+    /**
+     * The dispatch is a component's own bookkeeping rather than something a person did, so a refusal
+     * is not worth a person's attention: a controlled overlay reports itself closed as it unmounts,
+     * and when the whole subtree is going away the server has already retired that action. Such a
+     * failure is logged at debug instead of error.
+     */
+    bestEffort?: boolean;
+}
 /** The server-side outcome of a dispatched UI action (see {@link IkonClient.sendActionCallWithResult}). */
 export interface ActionOutcome {
     success: boolean;
+    /** Empty: the server keeps the exception in its own log, so a failure carries no reason here. */
     errorMessage: string;
 }
 export declare class IkonClient {
@@ -76,6 +88,13 @@ export declare class IkonClient {
     private _resumedSession;
     private _connectUrl;
     private _brandingRequired;
+    private _feedback;
+    private feedbackRequestHandler;
+    private feedbackButtonChoice;
+    private _feedbackSource;
+    private readonly feedbackSubscribers;
+    private _backendUrl;
+    private _backendToken;
     private currentState;
     private _activeEndpointType;
     private _fallbackTransportWarned;
@@ -102,6 +121,7 @@ export declare class IkonClient {
     private readonly _pendingActionAcks;
     private _ackRttMs;
     private readonly _actionIdByCallId;
+    private readonly _bestEffortCallIds;
     private readonly _pendingActionResults;
     private readonly endpointSelector;
     private readonly _webRtcReachability;
@@ -115,6 +135,7 @@ export declare class IkonClient {
     private boundOnline;
     private boundOffline;
     private boundAnchorClick;
+    private boundNotificationClick;
     private _globalState;
     private _globalStateReceived;
     private _channelsConnected;
@@ -129,8 +150,14 @@ export declare class IkonClient {
     private unregisterBrowserFunctions;
     private unregisterMediaCaptureFunctions;
     private unregisterSoundFunctions;
+    private unregisterDownloadFunctions;
+    private unregisterFeedbackFunctions;
+    private unregisterAccountFunctions;
+    private unregisterOfferedFeedbackFunctions;
+    private readonly captureFunctionsSupported;
     private unregisterLoginInterceptor;
     private nextProtocolPortId;
+    private _deliveringViaDataChannel;
     private nextProtocolSendPortId;
     private readonly _audioEnabled;
     private readonly _videoEnabled;
@@ -141,17 +168,24 @@ export declare class IkonClient {
     private _mediaCapture;
     private _mediaCapturePromise;
     private _visemeTracker;
+    private _visemeTrackerLoading;
+    private _visemeAvailable;
+    private _visemeLoadFailed;
     private _webRtcSignaling;
     private _webRtcConnectWatchdog;
     private _webRtcFallbackActive;
     private _webRtcRetryCount;
     private _webRtcRetryTimer;
+    private _webRtcIceRestartCount;
+    private _webRtcIceRestartTimer;
     private _webRtcAudioElements;
     private _webRtcAudioStreams;
     private _webRtcVideoStreams;
     private _webRtcTrackMap;
     private readonly _webRtcTrackMapListeners;
     private _pendingActiveAudioTracks;
+    private _offlineReportedAt;
+    private _offlineProbeInFlight;
     private _keepaliveLockAbort;
     private _fullReauthAttempted;
     private _softReconnectAttempted;
@@ -161,6 +195,7 @@ export declare class IkonClient {
     private _reconnectTimer;
     private _joinWatchdogTimer;
     private _serverStopped;
+    private _credentialRejected;
     private _hasBeenConnected;
     private _waitForExternalConnectUrl;
     private _externalConnectUrlCleanup;
@@ -188,7 +223,10 @@ export declare class IkonClient {
      * Viseme and other analyzer shape data ride the audio stream but carry no PCM,
      * so this is built independently of {@link media} and works the same over WebRTC
      * or the SDK playback pipeline. Poll {@link VisemeTracker.getCurrentVisemeValues}
-     * for interpolated mouth values. Returns `null` before audio is enabled.
+     * for interpolated mouth values. Returns `null` before audio is connected, and on
+     * the first reads after it: the tracker and its worker are built on first read, so
+     * apps that never read it never pay for them. A stream already playing by then is
+     * picked up from the global state.
      */
     get viseme(): VisemeTracker | null;
     /**
@@ -313,6 +351,24 @@ export declare class IkonClient {
      * branding banner (set for low-tier app creators). Defaults to false.
      */
     get brandingRequired(): boolean;
+    /**
+     * The feedback overlay settings for this user, or null when the overlay is not offered. `/init`
+     * sets them on authentication; the app server's `ikon.client.setFeedback` call replaces them,
+     * which is also how a local run, which has no `/init`, learns them.
+     */
+    get feedback(): FeedbackClientConfiguration | null;
+    /**
+     * The app server's decision on the feedback overlay (`ikon.client.setFeedback`). It replaces what
+     * `/init` said, and a later authentication whose `/init` names no feedback leaves it in place.
+     */
+    setFeedback(feedback: FeedbackClientConfiguration | null): void;
+    subscribeToFeedback(listener: (feedback: FeedbackClientConfiguration | null) => void): () => void;
+    /**
+     * Where the page reaches the backend on this user's behalf — the backend URL, the space and the
+     * current bearer token — or null when the connection has no space or no user token (an API-key
+     * client, a local run without a space).
+     */
+    get backendAccess(): BackendAccess | null;
     /**
      * Get the current GlobalState from the server.
      * Returns null if not yet received.
@@ -403,7 +459,7 @@ export declare class IkonClient {
      * Disconnect from the server.
      */
     disconnect(): void;
-    sendActionCall(actionId: string, payload?: string): void;
+    sendActionCall(actionId: string, payload?: string, options?: SendActionCallOptions): void;
     /**
      * Dispatch a UI action and resolve with the server handler's actual outcome — the
      * ActionResult the server emits when the handler finishes (the ActionCallAck is only a
@@ -446,6 +502,14 @@ export declare class IkonClient {
      * Routes to appropriate channel based on the message's opcode group.
      */
     sendProtocolMessage(message: ProtocolMessage): void;
+    /**
+     * Hand an error to the app's onError callback.
+     *
+     * For SDK subsystems (media playback, capture) whose failure leaves the connection itself
+     * intact: the client stays connected, so this callback is the only place the app can learn
+     * that a session went silent or blind.
+     */
+    reportError(error: Error): void;
     /**
      * Send a client context update to the server.
      * This notifies the server of changes to viewport size, theme, or timezone.
@@ -493,6 +557,27 @@ export declare class IkonClient {
      * Returns an unsubscribe function.
      */
     subscribeToState(handler: StateHandler): () => void;
+    /**
+     * Shows or hides the floating feedback button, and saves the choice as the person's preference for
+     * this app so it holds on their next visit. False, changing nothing, when feedback is not offered.
+     * Without a backend to save to, as on a local run, the choice lasts for this page.
+     */
+    setFeedbackButtonShown(shown: boolean): boolean;
+    /**
+     * Opens the feedback sheet exactly as the platform's feedback button does, with the screenshot
+     * taken now. For an app's own "Send feedback" control. False, and nothing opens, when feedback is
+     * not offered to this person or no `IkonApp` is on the page to show it.
+     */
+    requestFeedback(): boolean;
+    /**
+     * Installs what {@link requestFeedback} opens; the SDK's feedback controls do this while mounted.
+     * Returns a function that removes it again.
+     */
+    setFeedbackRequestHandler(handler: () => void): () => void;
+    private applyFeedback;
+    private syncOfferedFeedbackFunctions;
+    private configuredBackendUrl;
+    private recordBackendConfiguration;
     /**
      * Authenticate with the server.
      */
@@ -546,7 +631,7 @@ export declare class IkonClient {
      * worker path's tail, so the two no-Worker fallbacks connected without audio, video or WebRTC —
      * a silent client on exactly the browsers that already lack workers. */
     private finishMediaSetup;
-    private ensureVisemeTracker;
+    private loadVisemeTracker;
     /**
      * Builds and enables the custom (non-WebRTC) playback pipeline. This is the
      * backup path used when WebRTC is disabled or its signaling fails; the pipeline
@@ -557,6 +642,17 @@ export declare class IkonClient {
     private rememberWebRtcReachability;
     private clearWebRtcConnectWatchdog;
     private clearWebRtcRetry;
+    private clearWebRtcIceRestartTimer;
+    /**
+     * A route that died under a peer connection that is otherwise fine — the case a laptop changing
+     * interface produces, where every candidate pair is gone but the session is not. ICE often
+     * repairs this on its own, so wait out a grace period before spending a renegotiation; a restart
+     * that is not needed costs an offer/answer round trip and a fresh gather.
+     *
+     * Bounded, because a path that is genuinely gone must still reach the fallback rather than
+     * re-offering forever.
+     */
+    private scheduleWebRtcIceRestart;
     /**
      * A WebRTC-only failure (protocol channel still healthy) used to latch the session onto
      * custom playback forever, even when the network recovered seconds later. Retry a bounded
@@ -662,7 +758,18 @@ export declare class IkonClient {
     private requestExternalConnectUrl;
     private attemptReconnectOnVisible;
     private handleBrowserOffline;
-    private forceReconnectAfterOffline;
+    /**
+     * Corroborate an offline report from a socket that has nothing to do with the live one, because
+     * the budget above must clear the server's worst-case cadence and that is not prompt. A fresh
+     * connect over a vanished interface fails or times out; on a device that merely lies about being
+     * offline it succeeds.
+     *
+     * The result can only ever shorten the budget — nothing here tears a connection down — so a
+     * device whose platform also blocks new sockets still keeps its connection on the strength of
+     * the traffic still arriving.
+     */
+    private confirmOfflineReport;
+    private handleBrowserOnline;
     /**
      * Clear all timers.
      */
@@ -695,6 +802,16 @@ export declare class IkonClient {
      * every click made while we have no connection to tell.
      */
     private handleAnchorClick;
+    /**
+     * Move to a tapped notification's launch path, the way an in-app link click does. The SDK raises
+     * `ikon.notification-click` for a tap on a page notification and for every tap the push service
+     * worker hands back, action buttons included; the detail's `launchUrl` is already the tapped
+     * action's own path when it has one. Only same-origin, non-reserved paths are routed; anything
+     * else is left to a host listener. With no live connection the path is loaded as a new document,
+     * which reconnects on the way.
+     */
+    private handleNotificationClick;
+    private navigateInPlace;
     /**
      * Put the new route at the top, the way a document load would.
      *
@@ -754,6 +871,29 @@ export declare class IkonClient {
      * event.
      */
     private sendUrlChanged;
+    /**
+     * Put the liveness question to the wire instead of to our own state.
+     *
+     * `currentState` is this client's belief, and on a black-holed socket — a laptop moving between
+     * LAN and WiFi gets no FIN and no RST, so neither onclose nor onerror ever fires — that belief
+     * stays 'connected' for the whole watchdog window. The keepalive is the only thing here that has
+     * seen the wire.
+     *
+     * Every lifecycle signal goes through this one routine so the two topologies cannot drift apart:
+     * a check wired only to the main thread would silently do nothing for a client running its
+     * protocol in a worker.
+     *
+     * @param maxSilenceMs - Tightens the transport's watchdog for one deadline. Any inbound message
+     *   restores the negotiated budget, so a live link is never disturbed by being asked. Omitted,
+     *   this is the plain wall-clock verification a waking tab does.
+     */
+    private verifyLinkLiveness;
+    /**
+     * The longest silence a healthy link may show before a browser hint is worth acting on. The
+     * server owns the cadence, so this tracks it rather than pinning a constant that would
+     * false-positive on a large session — where a 60s gap between keepalives is entirely normal.
+     */
+    private getLivenessBudgetMs;
     /**
      * Check if the connection is still healthy after page was backgrounded.
      * If connection died while backgrounded, trigger reconnection.
@@ -791,3 +931,4 @@ export declare class IkonClient {
      */
     private handleExternalConnectUrl;
 }
+//# sourceMappingURL=ikon-client.d.ts.map

package/client/ikon-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ikon-client.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk/src/client/ikon-client.ts"],"names":[],"mappings":"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"}

package/connection/authenticator.d.ts

@@ -1,6 +1,7 @@
-import { AuthResponse, ClientEnvironment } from '../../shared/protocol/src/index.ts';
+import { AuthResponse, ClientEnvironment } from '@ikonai/protocol';
 import { ApiKeyConfig, LocalConfig, SessionTokenConfig } from '../client/ikon-client-config';
 import { ConnectTier, ProxyMode } from '../client/endpoint-selector';
+import { FeedbackClientConfiguration } from '../feedback/feedback-api';
 /**
  * Result of authentication - contains the AuthResponse from the server.
  */
@@ -15,7 +16,10 @@ export interface AuthResult {
     backendUrl?: string;
     authToken?: string;
     brandingRequired?: boolean;
+    /** Present when the active bundle enables feedback and the backend admitted this user. */
+    feedback?: FeedbackClientConfiguration;
 }
+export declare function readFeedbackConfiguration(value: unknown): FeedbackClientConfiguration | undefined;
 /**
  * Common authentication logic - fetch the connect URL and decode the AuthResponse.
  *
@@ -58,3 +62,4 @@ export declare function authenticateApiKey(config: ApiKeyConfig, signal?: AbortS
  * 3. Connect to the returned Ikon server URL
  */
 export declare function authenticateSessionToken(config: SessionTokenConfig, signal?: AbortSignal, proxyMode?: ProxyMode, learnedTier?: ConnectTier): Promise<AuthResult>;
+//# sourceMappingURL=authenticator.d.ts.map

package/connection/authenticator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticator.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk/src/connection/authenticator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwC,KAAK,YAAY,EAA+C,KAAK,iBAAiB,EAAmI,MAAM,kBAAkB,CAAC;AACjS,OAAO,EAAE,KAAK,YAAY,EAAmC,KAAK,WAAW,EAAE,KAAK,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC7I,OAAO,EAA0C,KAAK,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAIvH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AA8C5E;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,uCAAuC;IACvC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,oGAAoG;IACpG,eAAe,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,0FAA0F;IAC1F,QAAQ,CAAC,EAAE,2BAA2B,CAAC;CACxC;AA8FD,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,2BAA2B,GAAG,SAAS,CAMjG;AAmMD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAsC5J;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlG;AAkMD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA2FtG;AAwGD;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,GAAE,SAAkB,EAAE,WAAW,GAAE,WAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiC5K;AAMD;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE,kBAAkB,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,SAAS,GAAE,SAAkB,EAAE,WAAW,GAAE,WAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAOxL"}

package/connection/urls.d.ts

@@ -129,3 +129,4 @@ export declare function getInitialUrl(): string;
  * Returns "" off-browser, so callers must handle an absent value rather than navigate to it.
  */
 export declare function getUrlWithoutSession(): string;
+//# sourceMappingURL=urls.d.ts.map

package/connection/urls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk/src/connection/urls.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,aAAa,CAAC;AAGvD,eAAO,MAAM,qBAAqB,+BAA+B,CAAC;AAClE,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAGhE,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AAC5D,eAAO,MAAM,iBAAiB,gCAAgC,CAAC;AAE/D;;GAEG;AACH,eAAO,MAAM,kBAAkB,4BAA4B,CAAC;AA6E5D,6FAA6F;AAC7F,wBAAgB,oBAAoB,IAAI,MAAM,GAAG,IAAI,CAEpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIxE;AAeD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CAI/D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB1D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAqB/C;AAeD;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkBtE;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC,MAAM,CAAC,CAgBhE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYzD;AASD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAkBD;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,SAAS,CAgB1C;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CA8B5C;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAKvC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAKtC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAU7C"}

package/consent/consent-api.d.ts

@@ -0,0 +1,61 @@
+import { IkonClient } from '../client/ikon-client';
+/** Server function that returns the signed-in user's own consent answers. */
+export declare const CONSENT_LIST_FUNCTION_NAME = "ikon.platform.consent.list";
+/** Server function that records a yes for the signed-in user. */
+export declare const CONSENT_GRANT_FUNCTION_NAME = "ikon.platform.consent.grant";
+/** Server function that withdraws the signed-in user's yes. */
+export declare const CONSENT_REVOKE_FUNCTION_NAME = "ikon.platform.consent.revoke";
+/**
+ * Recording which features the user uses, whether actions succeed and how long they take. The App
+ * Privacy Template offers consent as the only basis for it, so measurement must not run until this
+ * is granted and must stop when it is withdrawn.
+ */
+export declare const CONSENT_USAGE_MEASUREMENT = "usage-measurement";
+/**
+ * Sending the user's personal data to an AI model provider. Apple requires the app to ask before
+ * personal data leaves for an AI provider; nothing about the purpose is iPhone-specific.
+ */
+export declare const CONSENT_AI_PROVIDER_PERSONAL_DATA = "ai-provider-personal-data";
+/**
+ * Where an answer stands. `not-asked` is the default for every purpose and is not a yes — it is kept
+ * apart from `denied` only so a screen can tell "ask them" from "they said no".
+ */
+export type ConsentState = 'not-asked' | 'granted' | 'denied';
+/** One user's answer to one consent question. */
+export interface ConsentRecord {
+    purpose: string;
+    state: ConsentState;
+    /** True only for an answer that is a yes today. */
+    granted: boolean;
+    /** ISO 8601 instant the user last answered, or null while they never have. */
+    decidedAt: string | null;
+}
+/** Every answer the signed-in user has given, keyed by purpose. */
+export type ConsentAnswers = Readonly<Record<string, ConsentRecord>>;
+/** The answer a purpose nobody has been asked about has. Never a yes. */
+export declare function notAskedConsent(purpose: string): ConsentRecord;
+/**
+ * Whether the user has consented to `purpose`. A purpose the answers do not mention is not granted —
+ * absence is never a yes, which is why this exists instead of reading `answers[purpose].granted`.
+ */
+export declare function isConsentGranted(answers: ConsentAnswers | null | undefined, purpose: string): boolean;
+/** The answer for `purpose`, or the not-asked default when there is none. */
+export declare function consentFor(answers: ConsentAnswers | null | undefined, purpose: string): ConsentRecord;
+/**
+ * Reads the signed-in user's own consent answers from the app.
+ *
+ * The app decides nothing here — the calling session is what identifies the user, so a client can
+ * only ever read its own answers, and a visitor the app cannot name gets an empty set.
+ */
+export declare function readConsent(client: IkonClient): Promise<ConsentAnswers>;
+/**
+ * Records the signed-in user's consent to `purpose`. Call it only for an answer the user actually
+ * gave. Rejects when there is no signed-in user to record it against.
+ */
+export declare function grantConsent(client: IkonClient, purpose: string): Promise<ConsentRecord>;
+/**
+ * Withdraws the signed-in user's consent to `purpose`. Recorded as an explicit no rather than
+ * erased, so the app knows not to ask again on the next screen.
+ */
+export declare function revokeConsent(client: IkonClient, purpose: string): Promise<ConsentRecord>;
+//# sourceMappingURL=consent-api.d.ts.map

package/consent/consent-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consent-api.d.ts","sourceRoot":"","sources":["../../../../sdk/sdk/src/consent/consent-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,0BAA0B,+BAA+B,CAAC;AAEvE,iEAAiE;AACjE,eAAO,MAAM,2BAA2B,gCAAgC,CAAC;AAEzE,+DAA+D;AAC/D,eAAO,MAAM,4BAA4B,iCAAiC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,sBAAsB,CAAC;AAE7D;;;GAGG;AACH,eAAO,MAAM,iCAAiC,8BAA8B,CAAC;AAE7E;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE9D,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,YAAY,CAAC;IACpB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,8EAA8E;IAC9E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B;AAED,mEAAmE;AACnE,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC;AAErE,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CAE9D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAErG;AAED,6EAA6E;AAC7E,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,SAAS,EAAE,OAAO,EAAE,MAAM,GAAG,aAAa,CAErG;AA0DD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,CAE7E;AAED;;;GAGG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQ9F;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAQ/F"}