@ikonai/sdk 1.0.49 → 1.0.50

package/media/ikon-image-capture.d.ts

@@ -6,6 +6,21 @@ export interface IkonImageCaptureRequest {
     width?: number;
     height?: number;
 }
+export type IkonNativeCameraFacing = 'user' | 'environment';
+/**
+ * Best-effort detection of a mobile browser. Used to decide whether the
+ * `<input type="file" capture>` flow will actually trigger the OS camera UI
+ * (mobile) or fall through to a regular file picker (desktop). Callers that
+ * support a headless fallback should prefer it on desktop.
+ */
+export declare function isMobileBrowserLikely(): boolean;
+export interface IkonNativeCameraCaptureRequest {
+    facing?: IkonNativeCameraFacing;
+    mime?: 'image/jpeg' | 'image/png';
+    quality?: number;
+    width?: number;
+    height?: number;
+}
 export interface IkonImageCaptureResult {
     mime: string;
     width: number;
@@ -20,4 +35,11 @@ export declare class IkonImageCapture {
     captureFromStream(stream: MediaStream, request?: IkonImageCaptureRequest): Promise<IkonImageCaptureResult>;
     private acquireCameraStream;
     captureFromCamera(request?: IkonImageCaptureRequest): Promise<IkonImageCaptureResult>;
+    /**
+     * Capture an image via the native OS camera UI (preview + shutter + front/back toggle on mobile,
+     * file picker on desktop). Implemented with a transient `<input type="file" capture>` and
+     * therefore must be invoked synchronously from a user gesture handler. Resolves to `null` if
+     * the user dismisses the picker without selecting/capturing.
+     */
+    captureFromNativeCamera(request?: IkonNativeCameraCaptureRequest): Promise<IkonImageCaptureResult | null>;
 }

package/media/index.d.ts

@@ -11,5 +11,5 @@ export { IkonVideoCapture } from './ikon-video-capture';
 export type { IkonVideoCaptureHandle, IkonVideoCaptureRequest, IkonVideoCaptureOptions, VideoCaptureSource } from './ikon-video-capture';
 export { IkonAudioCapture } from './ikon-audio-capture';
 export type { IkonAudioCaptureHandle, IkonAudioCaptureRequest, IkonAudioCaptureConfig, IkonAudioCaptureOptions } from './ikon-audio-capture';
-export { IkonImageCapture } from './ikon-image-capture';
-export type { IkonImageCaptureRequest, IkonImageCaptureResult } from './ikon-image-capture';
+export { IkonImageCapture, isMobileBrowserLikely } from './ikon-image-capture';
+export type { IkonImageCaptureRequest, IkonImageCaptureResult, IkonNativeCameraCaptureRequest, IkonNativeCameraFacing } from './ikon-image-capture';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ikonai/sdk",
-  "version": "1.0.49",
+  "version": "1.0.50",
   "type": "module",
   "main": "./index.js",
   "types": "./index.d.ts",

package/transport/web-socket-transport.d.ts

@@ -8,6 +8,7 @@ export declare class WebSocketTransport implements Transport {
     private keepaliveTimeout;
     private isClosed;
     private keepaliveResponseMessage;
+    private firstMessageResolver;
     private readonly keepaliveTimeoutMs;
     private readonly connectionTimeoutMs;
     private readonly callbacks;

package/transport/web-transport-transport.d.ts

@@ -28,6 +28,8 @@ export declare class WebTransportTransport implements Transport {
     private receiveDataView;
     private receiveDataViewBuffer;
     private keepaliveResponseMessage;
+    private firstMessageResolver;
+    private firstMessageRejecter;
     private readonly keepaliveTimeoutMs;
     private readonly connectionTimeoutMs;
     private readonly callbacks;

package/utils/debug-mode.d.ts

@@ -1,6 +1,7 @@
 /**
  * Initialize debug mode based on URL params (?ikon-debug=true or ?debug=true).
- * Call this early in SDK initialization.
+ * Call this early in SDK initialization. Idempotent — safe to call multiple
+ * times (e.g. once per IkonClient constructor); only the first call has effect.
  * Returns true if debug mode is enabled.
  */
 export declare function initializeDebugMode(): boolean;