@ikonai/sdk 1.0.26 → 1.0.28

package/package.json

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

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

@@ -6,6 +6,7 @@ import { Transport, TransportConfig } from './transport';
 export declare class WebSocketTransport implements Transport {
     private ws;
     private keepaliveTimeout;
+    private isClosed;
     private keepaliveResponseMessage;
     private readonly keepaliveTimeoutMs;
     private readonly callbacks;

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

@@ -21,6 +21,7 @@ export declare class WebTransportTransport implements Transport {
     private writer;
     private keepaliveTimeout;
     private readLoopActive;
+    private isClosed;
     private receiveBuffer;
     private receiveBufferOffset;
     private receiveBufferLength;

package/utils/debug-mode.d.ts

@@ -1,5 +1,5 @@
 /**
- * Initialize debug mode based on URL params (?debug=true).
+ * Initialize debug mode based on URL params (?ikon-debug=true or ?debug=true).
  * Call this early in SDK initialization.
  * Returns true if debug mode is enabled.
  */
@@ -10,6 +10,6 @@ export declare function initializeDebugMode(): boolean;
 export declare function isDebugModeEnabled(): boolean;
 /**
  * Enable debug mode programmatically (e.g., from server's GlobalState.DebugMode).
- * Also updates the URL to contain debug=true query param.
+ * Also updates the URL to contain ikon-debug=true query param.
  */
 export declare function enableDebugMode(): void;

package/utils/query-params.d.ts

@@ -0,0 +1,35 @@
+/**
+ * SDK Query Parameters
+ *
+ * All SDK-internal query params use the "ikon-" prefix to avoid conflicts with
+ * client application query params. Both "-" and "_" word separators are accepted
+ * (e.g., "ikon-proxy" and "ikon_proxy" both work).
+ *
+ * Supported parameters:
+ * - ikon-proxy        Force proxy mode on (true) or off (false)
+ * - ikon-websocket    Force WebSocket transport on (true) or off (false)
+ * - ikon-webtransport Force WebTransport on (true) or off (false)
+ * - ikon-debug        Enable SDK debug logging (true)
+ * - ikon-lang         Override language detection (e.g., "en", "fi")
+ * - ikon-server-url   External connect URL for shareable preview links
+ * - ikon-git-source   Enable Git source deployment mode (true)
+ * - ikon-git-branch   Git branch for Git source deployment (e.g., "main")
+ */
+export declare const IKON_PARAM_PROXY = "ikon-proxy";
+export declare const IKON_PARAM_WEBSOCKET = "ikon-websocket";
+export declare const IKON_PARAM_WEBTRANSPORT = "ikon-webtransport";
+export declare const IKON_PARAM_DEBUG = "ikon-debug";
+export declare const IKON_PARAM_LANG = "ikon-lang";
+export declare const IKON_PARAM_SERVER_URL = "ikon-server-url";
+export declare const IKON_PARAM_GIT_SOURCE = "ikon-git-source";
+export declare const IKON_PARAM_GIT_BRANCH = "ikon-git-branch";
+/**
+ * Set an SDK query parameter in the URL via history.replaceState.
+ */
+export declare function setSdkUrlParam(canonicalName: string, value: string): void;
+export declare function getProxyParam(): boolean | null;
+export declare function getWebSocketParam(): boolean | null;
+export declare function getWebTransportParam(): boolean | null;
+export declare function getDebugParam(): boolean;
+export declare function getLangParam(): string | null;
+export declare function getServerUrlParam(): string | null;