@ikonai/sdk 0.0.10 → 0.0.11

package/channel/channel-manager.d.ts

@@ -123,8 +123,4 @@ export declare class ChannelManager {
      * Update and notify state change.
      */
     private setState;
-    /**
-     * Delay with abort support.
-     */
-    private delay;
 }

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

@@ -1,9 +1,7 @@
 import { ProtocolMessage } from '../../../../shared/generated/src/index.ts';
+import { BackendType } from '../connection/urls';
 import { ConnectionState } from './connection-state';
-/**
- * Backend environment type.
- */
-export type BackendType = 'production' | 'development';
+export type { BackendType };
 /**
  * Common connection options shared across all modes.
  */
@@ -70,7 +68,7 @@ export interface LocalConfig extends CommonConnectionConfig {
     userId?: string;
 }
 /**
- * Common options for cloud-based modes (browser and apiKey).
+ * Common options for cloud-based modes (apiKey and sessionToken).
  */
 export interface CloudConnectionConfig extends CommonConnectionConfig {
     /**
@@ -89,14 +87,6 @@ export interface CloudConnectionConfig extends CommonConnectionConfig {
      */
     provisioningTimeoutMs?: number;
 }
-/**
- * Configuration for browser authentication mode.
- * Use this when the app is hosted on Ikon's domain and user is logged in via browser.
- * Space is auto-discovered from the hostname subdomain.
- * User identity comes from the browser session cookie.
- */
-export interface BrowserConfig extends CloudConnectionConfig {
-}
 /**
  * Configuration for API key authentication mode.
  * Use this for programmatic/library access to cloud channels.
@@ -118,8 +108,8 @@ export interface ApiKeyConfig extends CloudConnectionConfig {
     externalUserId: string;
     /**
      * Backend environment. Defaults to 'production'.
-     * - 'production' → https://api.prod.ikon.live
-     * - 'development' → https://api.dev.ikon.live
+     * - 'production' → IKON_BACKEND_URL_PROD
+     * - 'development' → IKON_BACKEND_URL_DEV
      */
     backendType?: BackendType;
     /**
@@ -135,6 +125,25 @@ export interface ApiKeyConfig extends CloudConnectionConfig {
      */
     clientType?: number;
 }
+/**
+ * Configuration for session token authentication mode.
+ * Use this when the session token was obtained from IKON_AUTH_BASE_URL (OAuth) or /auth/anonymous.
+ * The JWT token already contains the internal userId - no additional mapping needed.
+ */
+export interface SessionTokenConfig extends CloudConnectionConfig {
+    /**
+     * JWT token from IKON_AUTH_BASE_URL or /auth/anonymous (contains internal userId).
+     */
+    token: string;
+    /**
+     * Space ID (from ikon-config.json, injected at build time).
+     */
+    spaceId: string;
+    /**
+     * Backend environment. Defaults to 'production'.
+     */
+    backendType?: BackendType;
+}
 /**
  * Timeout configuration for the SDK.
  */
@@ -175,17 +184,17 @@ export interface IkonClientConfig {
      * Use this when connecting to a local Ikon server.
      */
     local?: LocalConfig;
-    /**
-     * Browser-based authentication.
-     * Use this when the app is hosted on Ikon's domain and user is logged in via browser.
-     * Space is auto-discovered from hostname subdomain.
-     */
-    browser?: BrowserConfig;
     /**
      * API key authentication for programmatic access.
      * Use this for libraries, scripts, plugins that need to connect to cloud channels.
      */
     apiKey?: ApiKeyConfig;
+    /**
+     * Session token authentication for frontend apps.
+     * Use this when the token was obtained from IKON_AUTH_BASE_URL (OAuth) or /auth/anonymous.
+     * The token already contains the internal userId.
+     */
+    sessionToken?: SessionTokenConfig;
     /**
      * Timeout configuration.
      */

package/connection/authenticator.d.ts

@@ -1,23 +1,11 @@
 import { AuthResponse } from '../../../../shared/generated/src/index.ts';
-import { ApiKeyConfig, BrowserConfig, LocalConfig } from '../client/ikon-client-config';
+import { ApiKeyConfig, LocalConfig, SessionTokenConfig } from '../client/ikon-client-config';
 /**
  * Result of authentication - contains the AuthResponse from the server.
  */
 export interface AuthResult {
     authResponse: AuthResponse;
 }
-/**
- * Derive backend API URL from window.location.hostname.
- * - If hostname contains '.dev.' → https://api.dev.ikon.live
- * - Otherwise → https://api.prod.ikon.live
- */
-export declare function deriveBackendUrl(): string;
-/**
- * Extract space domain from hostname.
- * - First checks VITE_IKON_SPACE_DOMAIN env variable (via import.meta.env)
- * - Otherwise extracts first subdomain: myapp.dev.ikon.live → myapp
- */
-export declare function deriveSpaceDomain(): string;
 /**
  * Authenticate with a local Ikon server in development mode.
  *
@@ -26,18 +14,6 @@ export declare function deriveSpaceDomain(): string;
  * 2. GET /connect?token=jwt → get binary AuthResponse
  */
 export declare function authenticateLocal(config: LocalConfig, signal?: AbortSignal): Promise<AuthResult>;
-/**
- * Authenticate with the Ikon backend using browser session cookies.
- *
- * Flow:
- * 1. Parse URL query parameters (id → sessionId, ck → channelKey, all → parameters)
- * 2. Derive backend URL and space domain from hostname
- * 3. Fetch space info by domain
- * 4. Request channel
- * 5. POST /rooms/connect and poll until running
- * 6. Connect to the returned Ikon server URL
- */
-export declare function authenticateBrowser(config: BrowserConfig, signal?: AbortSignal): Promise<AuthResult>;
 /**
  * Authenticate with the Ikon backend using an API key.
  *
@@ -50,3 +26,15 @@ export declare function authenticateBrowser(config: BrowserConfig, signal?: Abor
  * 6. Connect to the returned Ikon server URL
  */
 export declare function authenticateApiKey(config: ApiKeyConfig, signal?: AbortSignal): Promise<AuthResult>;
+/**
+ * Authenticate with the Ikon backend using a pre-obtained session token.
+ * Use this when the token was obtained from auth.ikonai.com (OAuth) or /auth/anonymous.
+ *
+ * Flow:
+ * 1. Use provided token as Bearer auth for backend requests
+ * 2. GET /profiles/me?space={spaceId} to verify profile exists
+ * 3. Request channel
+ * 4. POST /rooms/connect and poll until running
+ * 5. Connect to the returned Ikon server URL
+ */
+export declare function authenticateSessionToken(config: SessionTokenConfig, signal?: AbortSignal): Promise<AuthResult>;

package/connection/urls.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Ikon platform URL constants and utilities.
+ */
+/**
+ * Backend environment type.
+ */
+export type BackendType = 'production' | 'development';
+export declare const IKON_BACKEND_URL_PROD = "https://api.prod.ikon.live";
+export declare const IKON_BACKEND_URL_DEV = "https://api.dev.ikon.live";
+export declare const IKON_AUTH_BASE_URL = "https://auth.ikonai.com";
+/**
+ * Get backend URL from BackendType.
+ */
+export declare function getBackendUrl(backendType?: BackendType): string;
+/**
+ * Derive backend API URL from window.location.hostname.
+ * - If hostname contains '.dev.' → IKON_BACKEND_URL_DEV
+ * - Otherwise → IKON_BACKEND_URL_PROD
+ */
+export declare function deriveBackendUrl(): string;
+/**
+ * Derive backend type from environment or window.location.hostname.
+ * - If VITE_IKON_BASE_URL env var contains '.dev.' → 'development'
+ * - If hostname contains '.dev.' → 'development'
+ * - Otherwise → 'production'
+ */
+export declare function deriveBackendType(): BackendType;
+/**
+ * Parse URL query parameters.
+ */
+export declare function parseQueryParams(): Record<string, string>;
+/**
+ * Result of parsing URL path and query parameters.
+ */
+export interface UrlParams {
+    sessionId?: string;
+    channelKey?: string;
+    parameters: Record<string, string>;
+}
+/**
+ * Parse URL path and 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
+ */
+export declare function parseUrlParams(): UrlParams;
+/**
+ * Check if running in a cloud environment (not localhost or local network).
+ * Returns false for:
+ * - localhost and 127.0.0.1
+ * - IPv6 localhost (::1)
+ * - Private network ranges (192.168.x.x, 10.x.x.x, 172.16-31.x.x)
+ * - SSR (typeof window === 'undefined')
+ */
+export declare function isCloudEnvironment(): boolean;

package/functions/types.d.ts

@@ -38,8 +38,9 @@ export interface FunctionParameterDefinition {
 export interface FunctionDefinition {
     name: string;
     description?: string;
-    inlineCall?: boolean;
-    callOnlyOnce?: boolean;
+    llmInlineResult?: boolean;
+    llmCallOnlyOnce?: boolean;
+    requiresInstance?: boolean;
     returnType: ValueDescriptor;
     parameters?: FunctionParameterDefinition[];
 }

package/index.d.ts

@@ -1,5 +1,5 @@
 export { IkonClient, type ProtocolMessageHandler, type StateHandler } from './client/ikon-client';
-export type { IkonClientConfig, LocalConfig, BrowserConfig, ApiKeyConfig, CloudConnectionConfig, CommonConnectionConfig, TimeoutConfig, BackendType } from './client/ikon-client-config';
+export type { IkonClientConfig, LocalConfig, ApiKeyConfig, SessionTokenConfig, CloudConnectionConfig, CommonConnectionConfig, TimeoutConfig, BackendType } from './client/ikon-client-config';
 export type { ConnectionState } from './client/connection-state';
 export { isConnecting, isConnected, isOffline, isError } from './client/connection-state';
 export { ChannelManager, type ChannelManagerConfig, type ChannelManagerState } from './channel/channel-manager';
@@ -16,3 +16,5 @@ export { initializeLogSink, setSendLogsCallback, getBufferedLogs, takeBufferedLo
 export type { LogSinkConfig } from './utils/logSink';
 export { FunctionRegistry, registerBrowserFunctions, isBrowserEnvironment, type FunctionRegistryConfig } from './functions';
 export type { ValueDescriptor, NormalizedValueDescriptor, PrimitiveValueKind, FunctionParameterDefinition, FunctionDefinition, FunctionHandler } from './functions';
+export { IKON_AUTH_BASE_URL, IKON_BACKEND_URL_PROD, IKON_BACKEND_URL_DEV, deriveBackendUrl, deriveBackendType, parseUrlParams, isCloudEnvironment, type UrlParams } from './connection/urls';
+export { getOrCreateDeviceId, clearDeviceId, extractUserIdFromToken } from './storage';