@statsig/statsig-node-core 0.14.1-rc.2512160223 → 0.14.1-rc.2512190311

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statsig/statsig-node-core",
-  "version": "0.14.1-rc.2512160223",
+  "version": "0.14.1-rc.2512190311",
   "main": "index.js",
   "scripts": {
     "test": "jest --colors"
@@ -55,13 +55,13 @@
     ]
   },
   "optionalDependencies": {
-    "@statsig/statsig-node-core-linux-x64-musl": "0.14.1-rc.2512160223",
-    "@statsig/statsig-node-core-linux-x64-gnu": "0.14.1-rc.2512160223",
-    "@statsig/statsig-node-core-win32-x64-msvc": "0.14.1-rc.2512160223",
-    "@statsig/statsig-node-core-darwin-x64": "0.14.1-rc.2512160223",
-    "@statsig/statsig-node-core-win32-ia32-msvc": "0.14.1-rc.2512160223",
-    "@statsig/statsig-node-core-linux-arm64-musl": "0.14.1-rc.2512160223",
-    "@statsig/statsig-node-core-linux-arm64-gnu": "0.14.1-rc.2512160223",
-    "@statsig/statsig-node-core-darwin-arm64": "0.14.1-rc.2512160223"
+    "@statsig/statsig-node-core-linux-x64-musl": "0.14.1-rc.2512190311",
+    "@statsig/statsig-node-core-linux-x64-gnu": "0.14.1-rc.2512190311",
+    "@statsig/statsig-node-core-win32-x64-msvc": "0.14.1-rc.2512190311",
+    "@statsig/statsig-node-core-darwin-x64": "0.14.1-rc.2512190311",
+    "@statsig/statsig-node-core-win32-ia32-msvc": "0.14.1-rc.2512190311",
+    "@statsig/statsig-node-core-linux-arm64-musl": "0.14.1-rc.2512190311",
+    "@statsig/statsig-node-core-linux-arm64-gnu": "0.14.1-rc.2512190311",
+    "@statsig/statsig-node-core-darwin-arm64": "0.14.1-rc.2512190311"
   }
 }

package/statsig-generated.d.ts

@@ -16,7 +16,7 @@ export declare class StatsigNapiInternal {
   initialize(): Promise<StatsigResult>
   shutdown(timeoutMs?: number | undefined | null): Promise<StatsigResult>
   flushEvents(): Promise<StatsigResult>
-  logEvent(user: StatsigUser, eventName: string, value?: string | number | null, metadata?: Record<string, string> | undefined | null): void
+  logEvent(user: StatsigUser, eventName: string, value?: string | number | null, metadata?: Record<string, string | number | boolean | null | undefined> | null | undefined): void
   forwardLogLineEvent(user: StatsigUser, logLevel: 'trace' | 'debug' |'log' | 'info' | 'warn' | 'error', value?: string | undefined | null, metadata?: Record<string, string> | undefined | null): void
   checkGate(user: StatsigUser, gateName: string, options?: FeatureGateEvaluationOptions | undefined | null): boolean
   __INTERNAL_getFeatureGate(user: StatsigUser, featureName: string, options?: FeatureGateEvaluationOptions | undefined | null): string

package/statsig_types.d.ts

@@ -1,7 +1,6 @@
 import { EvaluationDetails, SecondaryExposure } from './statsig-generated';
-export type TypedGet = <T = unknown>(key: string, fallback?: T) => TypedReturn<T>;
+export type TypedGet = <T = unknown>(key: string, defaultValue: T, typeGuard?: ((value: unknown) => value is T | null) | null) => T;
 export type UnknownGet = (key: string, fallback?: boolean | number | string | object | Array<any> | null) => unknown | null;
-export type TypedReturn<T = unknown> = T extends string ? string : T extends number ? number : T extends boolean ? boolean : T extends readonly unknown[] ? T : T extends object ? T : unknown;
 declare class BaseEvaluation {
     readonly name: string;
     readonly ruleID: string;

package/statsig_types.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Layer = exports.Experiment = exports.DynamicConfig = exports.FeatureGate = void 0;
+function _getTypeOf(x) {
+    return Array.isArray(x) ? 'array' : x === null ? 'null' : typeof x;
+}
 class BaseEvaluation {
     constructor(name, data) {
         var _a, _b, _c;
@@ -94,23 +97,32 @@ function _parseRawEvaluation(raw) {
         return {};
     }
 }
-function _isTypeMatch(a, b) {
-    const typeOf = (x) => Array.isArray(x) ? 'array' : x === null ? 'null' : typeof x;
-    return typeOf(a) === typeOf(b);
-}
 function _makeTypedGet(name, value, exposeFunc) {
-    return (param, fallback) => {
+    return (key, defaultValue, typeGuard = null) => {
         var _a;
-        const found = (_a = value[param]) !== null && _a !== void 0 ? _a : null;
-        if (found == null) {
-            return (fallback !== null && fallback !== void 0 ? fallback : null);
+        // @ts-ignore - intentionally matches legacy behavior exactly
+        defaultValue = defaultValue !== null && defaultValue !== void 0 ? defaultValue : null;
+        // Equivalent to legacy `this.getValue(key, defaultValue)`
+        const val = ((_a = value[key]) !== null && _a !== void 0 ? _a : defaultValue);
+        if (val == null) {
+            return defaultValue;
+        }
+        const expectedType = _getTypeOf(defaultValue);
+        const actualType = _getTypeOf(val);
+        if (typeGuard != null) {
+            if (typeGuard(val)) {
+                exposeFunc === null || exposeFunc === void 0 ? void 0 : exposeFunc(key);
+                return val;
+            }
+            console.warn(`[Statsig] Parameter type mismatch. '${name}.${key}' failed typeGuard. Expected '${expectedType}', got '${actualType}'`);
+            return defaultValue;
         }
-        if (fallback != null && !_isTypeMatch(found, fallback)) {
-            console.warn(`[Statsig] Parameter type mismatch. '${name}.${param}' was found to be type '${typeof found}' but fallback/return type is '${typeof fallback}'`);
-            return (fallback !== null && fallback !== void 0 ? fallback : null);
+        if (defaultValue == null || expectedType === actualType) {
+            exposeFunc === null || exposeFunc === void 0 ? void 0 : exposeFunc(key);
+            return val;
         }
-        exposeFunc === null || exposeFunc === void 0 ? void 0 : exposeFunc(param);
-        return found;
+        console.warn(`[Statsig] Parameter type mismatch. '${name}.${key}' was found to be type '${actualType}' but fallback/return type is '${expectedType}'`);
+        return defaultValue;
     };
 }
 function _makeUnknownGet(value, exposeFunc) {