@ikonai/sdk 1.0.80 → 1.1.0

package/connection/urls.d.ts

@@ -68,23 +68,17 @@ export declare function deriveAuthUrl(override?: string): Promise<string>;
  */
 export declare function parseQueryParams(): Record<string, string>;
 /**
- * Result of parsing URL path and query parameters.
+ * Result of parsing URL query parameters.
  */
 export interface UrlParams {
-    sessionId?: string;
-    channelKey?: string;
+    sessionIdentityHash?: string;
     parameters: Record<string, string>;
 }
 /**
- * Parse URL path and query parameters for browser authentication.
+ * Parse URL query parameters for browser authentication.
  *
- * URL path patterns:
- * - /s/[sessionId] → sessionId
- * - /c/[channelKey] → channelKey
- *
- * Query parameters → parameters dict (excluding OAuth-reserved params)
- *
- * @throws Error if both sessionId and channelKey are in the URL path
+ * `ikon-session` names the app session to join; the SDK-reserved params are kept out of the
+ * app-facing dict, along with the OAuth-reserved ones.
  */
 export declare function parseUrlParams(): UrlParams;
 /**
@@ -97,12 +91,7 @@ export declare function parseUrlParams(): UrlParams;
  */
 export declare function isCloudEnvironment(): boolean;
 /**
- * Get the initial path from the browser URL, stripping /c/[channelKey] or /s/[sessionId] prefix.
- * Returns just the app-specific path portion (e.g. "/buttons"), or "/" if no path remains.
+ * Get the initial path from the browser URL — the whole path, since the app owns all of it.
+ * Returns "/" when there is no path.
  */
 export declare function getInitialPath(): string;
-/**
- * Remove sessionId and channelKey path patterns from the URL.
- * Replaces /s/[sessionId] or /c/[channelKey] paths with root.
- */
-export declare function clearSessionParamsFromUrl(): void;

package/errors/index.d.ts

@@ -42,29 +42,17 @@ export declare class MaxRetriesExceededError extends ConnectionError {
     constructor(maxAttempts: number);
 }
 /**
- * Error thrown when cloud channel provisioning times out.
+ * Error thrown when cloud app-session provisioning times out.
  */
 export declare class ProvisioningTimeoutError extends AuthenticationError {
     constructor(timeoutMs: number);
 }
-/**
- * Error thrown when a channel with the specified key is not found.
- */
-export declare class ChannelNotFoundError extends AuthenticationError {
-    constructor(channelKey: string);
-}
 /**
  * Error thrown when no space is found for the given domain.
  */
 export declare class SpaceNotFoundError extends AuthenticationError {
     constructor(domain: string);
 }
-/**
- * Error thrown when no channels are available in the space.
- */
-export declare class NoChannelsError extends AuthenticationError {
-    constructor();
-}
 /**
  * Error thrown when the server denies access (HTTP 403).
  * For example, when a domain allowlist blocks the user's email domain.
@@ -73,6 +61,16 @@ export declare class AccessDeniedError extends AuthenticationError {
     readonly reason: string;
     constructor(message: string, reason: string);
 }
+/**
+ * Error thrown when `?ikon-session=<hash>` names a session that is not live (HTTP 404).
+ * Terminal — the SDK must not retry, and must not fall back to starting a fresh session: a
+ * link that silently lands the user somewhere other than the session it names is worse than
+ * a visible failure.
+ */
+export declare class SessionNotFoundError extends AuthenticationError {
+    readonly sessionIdentityHash: string;
+    constructor(sessionIdentityHash: string);
+}
 /**
  * Error thrown when the server is at capacity and rejects the connection (HTTP 429).
  * The instance has reached its maximum client limit. This is terminal — the SDK must not
@@ -81,6 +79,17 @@ export declare class AccessDeniedError extends AuthenticationError {
 export declare class ServerFullError extends AuthenticationError {
     constructor(message: string);
 }
+/**
+ * Error thrown when a connect-flow request fails with a server-side status (HTTP 5xx).
+ * Says the backend is having trouble and nothing about the caller's credentials — which is why
+ * it is not merely a nicer message: an AuthenticationError from connect reads as a stale session,
+ * and the response to that is to log the user out. A backend hiccup must not end a valid session.
+ * Transient, so the SDK retries it like any other connect failure.
+ */
+export declare class ServerUnavailableError extends AuthenticationError {
+    readonly status: number;
+    constructor(message: string, status: number);
+}
 /**
  * Error thrown when the browser is missing runtime features the SDK requires (e.g. a smart-TV
  * browser too old to run the app). Terminal — the SDK must not retry; the user needs a newer

package/functions/browser-functions.d.ts

@@ -1,4 +1,4 @@
-import { ClientType } from '../../../../shared/protocol/src/index.ts';
+import { ClientType } from '../../shared/protocol/src/index.ts';
 import { FunctionRegistry } from './function-registry';
 /**
  * Get the effective theme (user override > stored > system preference).

package/functions/function-registry.d.ts

@@ -1,4 +1,4 @@
-import { ProtocolMessage, ActionFunctionRegister, GlobalState, ClientInitialization } from '../../../../shared/protocol/src/index.ts';
+import { ProtocolMessage, ActionFunctionRegister, GlobalState, ClientInitialization } from '../../shared/protocol/src/index.ts';
 import { FunctionCallError, FunctionDefinition, FunctionHandler, NormalizedFunction } from './types';
 export interface RemoteFunction {
     id: string;

package/functions/types.d.ts

@@ -1,4 +1,4 @@
-import { ActionFunctionRegister } from '../../../../shared/protocol/src/index.ts';
+import { ActionFunctionRegister } from '../../shared/protocol/src/index.ts';
 export type PrimitiveValueKind = 'boolean' | 'number' | 'string';
 type PrimitiveDescriptor = {
     kind: PrimitiveValueKind;
@@ -44,7 +44,7 @@ export interface FunctionDefinition {
     returnType: ValueDescriptor;
     parameters?: FunctionParameterDefinition[];
 }
-export type FunctionHandler = (...parameters: unknown[]) => unknown | Promise<unknown>;
+export type FunctionHandler = (...parameters: unknown[]) => unknown;
 export interface FunctionResultWithData<T = unknown> {
     value: T;
     data: Uint8Array;