flagmint-js-sdk 1.2.24 → 1.2.25

package/dist/sdk/core/client.d.ts

@@ -2,7 +2,6 @@ import { CacheAdapter, FeatureFlags } from '../core/helpers/types';
 import type { Transport } from '../core/transports/Transport';
 import { FlagValue } from '../core/evaluation/types';
 type TransportMode = 'auto' | 'websocket' | 'long-polling';
-type Environment = 'production' | 'staging' | 'development';
 export interface FlagClientOptions<C extends Record<string, any> = Record<string, any>> {
     apiKey: string;
     context?: C;
@@ -10,6 +9,19 @@ export interface FlagClientOptions<C extends Record<string, any> = Record<string
     persistContext?: boolean;
     transport?: Transport<C, any>;
     transportMode?: TransportMode;
+    /**
+     * Called when a non-fatal but noteworthy error occurs during or after initialization.
+     * The client always resolves ready() regardless — use this to show a degraded/fallback UI.
+     *
+     * Common cases:
+     *  - Auth failure (err.code === 'ERR_AUTH'): API key invalid; flags will be empty; getFlag() returns fallback values.
+     *  - Rate limited (err.code === 'ERR_RATE_LIMITED'): free-tier call limit exceeded; cached flags are served if available.
+     *    Check (err as any).resetTime for the reset timestamp string supplied by the server, if present.
+     *  - Degraded mode: transport failed but cached flags are available and being served.
+     *  - Context update error: re-evaluation after updateContext() failed; previous flags retained.
+     *
+     * Note: ready() will never throw. All errors are surfaced exclusively through this callback.
+     */
     onError?: (error: Error) => void;
     previewMode?: boolean;
     rawFlags?: Record<string, FlagValue>;
@@ -17,7 +29,9 @@ export interface FlagClientOptions<C extends Record<string, any> = Record<string
     cacheAdapter?: CacheAdapter<C>;
     restEndpoint?: string;
     wsEndpoint?: string;
-    env?: Environment;
+    debugLog?: boolean;
+    env?: string;
+    enableFlagmint: boolean;
 }
 type FlagUpdateCallback<T> = (flags: FeatureFlags<T>) => void;
 export declare class FlagClient<T = unknown, C extends Record<string, any> = Record<string, any>> {
@@ -38,6 +52,8 @@ export declare class FlagClient<T = unknown, C extends Record<string, any> = Rec
     private previewMode;
     private rawFlags;
     private cacheAdapter;
+    private env?;
+    private enableFlagmint?;
     private deferInitialization;
     private initializationOptions?;
     private isInitialized;

package/dist/sdk/core/helpers/logger.d.ts

@@ -2,6 +2,10 @@
  * Environment-aware logger that respects production restrictions
  */
 export declare const logger: {
+    canDebugLog: boolean;
+    setup: (options: {
+        debugLog?: boolean;
+    }) => void;
     log: (message: string, ...args: any[]) => void;
     error: (message: string, ...args: any[]) => void;
     warn: (message: string, ...args: any[]) => void;

package/dist/sdk/core/transports/WebsocketTransport.d.ts

@@ -12,6 +12,7 @@ export declare class WebSocketTransport<C, T> implements Transport<C, T> {
     private initialFlagsReceived;
     private initialFlagsPromise;
     private initialFlagsResolve;
+    private initialFlagsReject;
     private onFlagsUpdatedCallback?;
     private onConnectionStateCallback?;
     private retries;

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "flagmint-js-sdk",
-  "version": "1.2.24",
+  "version": "1.2.25",
   "description": "Framework-agnostic JavaScript SDK for managing feature flags in Flagmint applications.",
   "author": "Flagmint Team",
-  "license": "MIT",
+  "license": "BSD 3-Clause",
   "main": "dist/flagmint.cjs.js",
   "module": "dist/flagmint.es.js",
   "types": "dist/index.d.ts",