@canarygate/sdk 0.1.1 → 0.1.2

package/README.md

@@ -69,7 +69,7 @@ Rollout evaluation hashes `userId` deterministically — the same user always ge
 | -------------------- | --------- | ----------------------- | ------------------------------------------------ |
 | `baseUrl`            | `string`  | `http://localhost:3001` | CanaryGate API base URL                          |
 | `environment`        | `string`  | —                       | Environment to evaluate flags against            |
-| `pollIntervalMs`     | `number`  | `30000`                 | Browser polling interval in ms. Set `0` to disable |
+| `pollIntervalMs`     | `number`  | `30000`                 | Browser polling interval in ms (clamped to a 3000ms minimum). Set `0` to disable |
 | `reconnectDelay`     | `number`  | `5000`                  | Initial SSE reconnect delay (ms)                 |
 | `maxReconnectDelay`  | `number`  | `30000`                 | Reconnect delay cap, exponential backoff (ms)    |
 | `heartbeatTimeoutMs` | `number`  | `65000`                 | Silence window before treating the stream as dead |

package/dist/{canary-gate-base-DzuUUPOC.d.mts → canary-gate-base-iXS3mVyK.d.mts}

@@ -16,6 +16,7 @@ type FlagEvaluationContext = {
 type CanaryGateOptions = {
     baseUrl?: string;
     environment?: string;
+    /** Browser polling interval in ms. Default: 30000; minimum enforced: 3000. Set 0 to disable. Server always uses SSE instead. */
     pollIntervalMs?: number;
     reconnectDelay?: number;
     maxReconnectDelay?: number;

package/dist/{canary-gate-base-DzuUUPOC.d.ts → canary-gate-base-iXS3mVyK.d.ts}

@@ -16,6 +16,7 @@ type FlagEvaluationContext = {
 type CanaryGateOptions = {
     baseUrl?: string;
     environment?: string;
+    /** Browser polling interval in ms. Default: 30000; minimum enforced: 3000. Set 0 to disable. Server always uses SSE instead. */
     pollIntervalMs?: number;
     reconnectDelay?: number;
     maxReconnectDelay?: number;

package/dist/{chunk-ECO47H4R.mjs → chunk-LMPIWD3Z.mjs}

@@ -43,6 +43,7 @@ function parseSseEventBlock(block) {
 var DEFAULT_MAX_RECONNECT_DELAY_MS = 3e4;
 var DEFAULT_HEARTBEAT_TIMEOUT_MS = 65e3;
 var DEFAULT_POLL_INTERVAL_MS = 3e4;
+var MIN_POLL_INTERVAL_MS = 3e3;
 function isAbortError(error) {
   return error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
 }
@@ -77,6 +78,12 @@ var CanaryGateBase = class {
     );
     this.heartbeatTimeoutMs = options.heartbeatTimeoutMs ?? DEFAULT_HEARTBEAT_TIMEOUT_MS;
     this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    if (options.pollIntervalMs !== void 0 && options.pollIntervalMs > 0 && options.pollIntervalMs < MIN_POLL_INTERVAL_MS) {
+      console.warn(
+        `[canarygate] pollIntervalMs must be at least ${MIN_POLL_INTERVAL_MS}ms; clamped to ${MIN_POLL_INTERVAL_MS}.`
+      );
+      this.pollIntervalMs = MIN_POLL_INTERVAL_MS;
+    }
     this.streamRetryDelay = this.reconnectDelay;
     this.anonId = anonIdFactory();
   }

package/dist/client.d.mts

@@ -1,4 +1,4 @@
-import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-DzuUUPOC.mjs';
+import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-iXS3mVyK.mjs';
 
 declare class CanaryGate extends CanaryGateBase {
     constructor(apiKey: string, options?: CanaryGateOptions);

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-DzuUUPOC.js';
+import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-iXS3mVyK.js';
 
 declare class CanaryGate extends CanaryGateBase {
     constructor(apiKey: string, options?: CanaryGateOptions);

package/dist/client.js

@@ -69,6 +69,7 @@ function parseSseEventBlock(block) {
 var DEFAULT_MAX_RECONNECT_DELAY_MS = 3e4;
 var DEFAULT_HEARTBEAT_TIMEOUT_MS = 65e3;
 var DEFAULT_POLL_INTERVAL_MS = 3e4;
+var MIN_POLL_INTERVAL_MS = 3e3;
 function isAbortError(error) {
   return error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
 }
@@ -103,6 +104,12 @@ var CanaryGateBase = class {
     );
     this.heartbeatTimeoutMs = options.heartbeatTimeoutMs ?? DEFAULT_HEARTBEAT_TIMEOUT_MS;
     this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    if (options.pollIntervalMs !== void 0 && options.pollIntervalMs > 0 && options.pollIntervalMs < MIN_POLL_INTERVAL_MS) {
+      console.warn(
+        `[canarygate] pollIntervalMs must be at least ${MIN_POLL_INTERVAL_MS}ms; clamped to ${MIN_POLL_INTERVAL_MS}.`
+      );
+      this.pollIntervalMs = MIN_POLL_INTERVAL_MS;
+    }
     this.streamRetryDelay = this.reconnectDelay;
     this.anonId = anonIdFactory();
   }

package/dist/client.mjs

@@ -1,6 +1,6 @@
 import {
   CanaryGateBase
-} from "./chunk-ECO47H4R.mjs";
+} from "./chunk-LMPIWD3Z.mjs";
 
 // src/client.ts
 var ANON_ID_KEY = "__cg_anon_id__";

package/dist/server.d.mts

@@ -1,4 +1,4 @@
-import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-DzuUUPOC.mjs';
+import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-iXS3mVyK.mjs';
 
 declare class CanaryGate extends CanaryGateBase {
     constructor(apiKey: string, options?: CanaryGateOptions);

package/dist/server.d.ts

@@ -1,4 +1,4 @@
-import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-DzuUUPOC.js';
+import { C as CanaryGateBase, a as CanaryGateOptions } from './canary-gate-base-iXS3mVyK.js';
 
 declare class CanaryGate extends CanaryGateBase {
     constructor(apiKey: string, options?: CanaryGateOptions);

package/dist/server.js

@@ -69,6 +69,7 @@ function parseSseEventBlock(block) {
 var DEFAULT_MAX_RECONNECT_DELAY_MS = 3e4;
 var DEFAULT_HEARTBEAT_TIMEOUT_MS = 65e3;
 var DEFAULT_POLL_INTERVAL_MS = 3e4;
+var MIN_POLL_INTERVAL_MS = 3e3;
 function isAbortError(error) {
   return error instanceof DOMException && error.name === "AbortError" || error instanceof Error && error.name === "AbortError";
 }
@@ -103,6 +104,12 @@ var CanaryGateBase = class {
     );
     this.heartbeatTimeoutMs = options.heartbeatTimeoutMs ?? DEFAULT_HEARTBEAT_TIMEOUT_MS;
     this.pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+    if (options.pollIntervalMs !== void 0 && options.pollIntervalMs > 0 && options.pollIntervalMs < MIN_POLL_INTERVAL_MS) {
+      console.warn(
+        `[canarygate] pollIntervalMs must be at least ${MIN_POLL_INTERVAL_MS}ms; clamped to ${MIN_POLL_INTERVAL_MS}.`
+      );
+      this.pollIntervalMs = MIN_POLL_INTERVAL_MS;
+    }
     this.streamRetryDelay = this.reconnectDelay;
     this.anonId = anonIdFactory();
   }

package/dist/server.mjs

@@ -1,6 +1,6 @@
 import {
   CanaryGateBase
-} from "./chunk-ECO47H4R.mjs";
+} from "./chunk-LMPIWD3Z.mjs";
 
 // src/server.ts
 var CanaryGate = class extends CanaryGateBase {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@canarygate/sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "CanaryGate SDK — feature flags with real-time SSE streaming",
   "exports": {
     "./client": {