@ikonai/sdk 1.0.66 → 1.0.68

package/media/device-detection.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 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.
+ *
+ * Kept in its own dependency-free module so the eagerly-loaded capture function
+ * registrations can use it without statically pulling in the heavy image-capture
+ * pipeline (which is part of the lazily-loaded capture chunk).
+ */
+export declare function isMobileBrowserLikely(): boolean;

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

@@ -7,13 +7,7 @@ export interface IkonImageCaptureRequest {
     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 { isMobileBrowserLikely } from './device-detection';
 export interface IkonNativeCameraCaptureRequest {
     facing?: IkonNativeCameraFacing;
     mime?: 'image/jpeg' | 'image/png';

package/media/index.d.ts

@@ -11,5 +11,6 @@ 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, isMobileBrowserLikely } from './ikon-image-capture';
+export { IkonImageCapture } from './ikon-image-capture';
 export type { IkonImageCaptureRequest, IkonImageCaptureResult, IkonNativeCameraCaptureRequest, IkonNativeCameraFacing } from './ikon-image-capture';
+export { isMobileBrowserLikely } from './device-detection';

package/package.json

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

package/utils/query-params.d.ts

@@ -20,6 +20,7 @@
  * - ikon-inspect      Enable element inspection overlay (true)
  * - ikon-retry        Enable retry loops in auth/channel connect (default true; set false to fail fast)
  * - ikon-api          Route backend API calls through same-origin /ikon/api (default true on deployed apps; false to force direct calls to api.{env}.ikon.live; always off in local dev)
+ * - ikon-snapshot     Connect as a build-time snapshot client (true). Sets Context.IsSnapshot so app/Parallax code can branch on snapshot-mode rendering. Dev affordance for tuning the boot-snapshot UI.
  */
 export declare const IKON_PARAM_PROXY = "ikon-proxy";
 export declare const IKON_PARAM_WEBSOCKET = "ikon-websocket";
@@ -37,6 +38,7 @@ export declare const IKON_PARAM_DEBUG_OVERLAY = "ikon-debug-overlay";
 export declare const IKON_PARAM_AUTH = "ikon-auth";
 export declare const IKON_PARAM_RETRY = "ikon-retry";
 export declare const IKON_PARAM_API = "ikon-api";
+export declare const IKON_PARAM_SNAPSHOT = "ikon-snapshot";
 /**
  * Set an SDK query parameter in the URL via history.replaceState.
  */
@@ -67,3 +69,8 @@ export declare function getDebugOverlayParam(): boolean;
 export declare function getAuthSameOriginParam(): boolean;
 export declare function getRetryParam(): boolean;
 export declare function getApiParam(): boolean | null;
+/**
+ * Connect as a build-time snapshot client (`?ikon-snapshot=true`). Sets `Context.IsSnapshot` so
+ * the app / Parallax can render in snapshot mode. A dev affordance for tuning the boot-snapshot UI.
+ */
+export declare function getSnapshotParam(): boolean;