@ikonai/sdk 1.3.10 → 1.3.11

package/package.json

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

package/utils/query-params.d.ts

@@ -6,7 +6,8 @@
  * (e.g., "ikon-proxy" and "ikon_proxy" both work).
  *
  * Supported parameters:
- * - ikon-proxy        Force proxy mode on (true) or off (false)
+ * - ikon-proxy        Pin the connect tier: false = direct, true = the on-host proxy on 443,
+ *                     lb (or stream) = the app's own origin through the fleet proxy gateway
  * - ikon-websocket    Force WebSocket transport on (true) or off (false)
  * - ikon-webtransport Force WebTransport on (true); default is off. `false` is accepted for parity.
  * - ikon-debug        Enable SDK debug logging (true)
@@ -48,6 +49,15 @@ export declare const IKON_PARAM_SESSION = "ikon-session";
  */
 export declare function setSdkUrlParam(canonicalName: string, value: string): void;
 export declare function getProxyParam(): boolean | null;
+/**
+ * Which connect tier to pin, as an extension of the same parameter rather than a second one — there
+ * is one thing to remember and one thing to document.
+ *
+ * `lb` (and the friendlier alias `stream`) is what makes the same-origin stream tier testable at
+ * all: in `auto` mode a client only reaches it after failing the two above it, which is close to
+ * impossible to arrange deliberately.
+ */
+export declare function getProxyTierParam(): 'direct' | 'proxy' | 'lb' | null;
 export declare function getWebSocketParam(): boolean | null;
 export declare function getWebTransportParam(): boolean | null;
 export declare function getDebugParam(): boolean;