@statsig/statsig-node-core 0.13.1-rc.2512020014 → 0.14.1-beta.2512170241

package/error_boundary.js

@@ -35,7 +35,8 @@ class ErrorBoundary {
     }
     static _onError(tag, error) {
         _tryConvertInvalidArgError(error);
-        console.error('Statsig::' + tag, error);
+        const printableTag = tag.replace('__INTERNAL_', '');
+        console.error('Statsig::' + printableTag, error);
     }
 }
 exports.ErrorBoundary = ErrorBoundary;

package/index.d.ts

@@ -1,6 +1,7 @@
-import { DynamicConfig, Experiment, Layer, ParameterStore, SdkEvent, StatsigNapiInternal, StatsigOptions, StatsigResult, StatsigUser } from './statsig-generated';
+import { DynamicConfigEvaluationOptions, ExperimentEvaluationOptions, FeatureGateEvaluationOptions, LayerEvaluationOptions, SdkEvent, StatsigNapiInternal, StatsigOptions, StatsigResult, StatsigUser } from './statsig-generated';
+import { DynamicConfig, Experiment, FeatureGate, Layer } from './statsig_types';
 export * from './statsig-generated';
-export { StatsigUser, Experiment, DynamicConfig, Layer, ParameterStore };
+export * from './statsig_types';
 export declare class Statsig extends StatsigNapiInternal {
     private static _sharedInstance;
     static shared(): Statsig;
@@ -11,4 +12,9 @@ export declare class Statsig extends StatsigNapiInternal {
     stopConsoleCapture(): void;
     shutdown(timeout_ms?: number): Promise<StatsigResult>;
     subscribe(eventName: SdkEvent, callback: (event: any) => void): string;
+    getFeatureGate(user: StatsigUser, gateName: string, options?: FeatureGateEvaluationOptions): FeatureGate;
+    getDynamicConfig(user: StatsigUser, configName: string, options?: DynamicConfigEvaluationOptions): DynamicConfig;
+    getExperiment(user: StatsigUser, experimentName: string, options?: ExperimentEvaluationOptions): Experiment;
+    getExperimentByGroupName(experimentName: string, groupName: string): Experiment;
+    getLayer(user: StatsigUser, layerName: string, options?: LayerEvaluationOptions): Layer;
 }

package/index.js

@@ -26,36 +26,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Statsig = exports.ParameterStore = exports.Layer = exports.DynamicConfig = exports.Experiment = exports.StatsigUser = void 0;
+exports.Statsig = void 0;
 const https_proxy_agent_1 = require("https-proxy-agent");
 const node_fetch_1 = __importDefault(require("node-fetch"));
 const console_capture_1 = require("./console_capture");
 const error_boundary_1 = require("./error_boundary");
 const statsig_generated_1 = require("./statsig-generated");
-Object.defineProperty(exports, "DynamicConfig", { enumerable: true, get: function () { return statsig_generated_1.DynamicConfig; } });
-Object.defineProperty(exports, "Experiment", { enumerable: true, get: function () { return statsig_generated_1.Experiment; } });
-Object.defineProperty(exports, "Layer", { enumerable: true, get: function () { return statsig_generated_1.Layer; } });
-Object.defineProperty(exports, "ParameterStore", { enumerable: true, get: function () { return statsig_generated_1.ParameterStore; } });
-Object.defineProperty(exports, "StatsigUser", { enumerable: true, get: function () { return statsig_generated_1.StatsigUser; } });
+const statsig_types_1 = require("./statsig_types");
 __exportStar(require("./statsig-generated"), exports);
+__exportStar(require("./statsig_types"), exports);
 const inspectSym = Symbol.for('nodejs.util.inspect.custom');
 // @ts-expect-error - prototype assignment
 statsig_generated_1.StatsigUser.prototype[inspectSym] = function () {
     return this.toJSON();
 };
 // @ts-expect-error - prototype assignment
-statsig_generated_1.Experiment.prototype[inspectSym] = function () {
-    return this.toJSON();
-};
-// @ts-expect-error - prototype assignment
-statsig_generated_1.DynamicConfig.prototype[inspectSym] = function () {
-    return this.toJSON();
-};
-// @ts-expect-error - prototype assignment
-statsig_generated_1.Layer.prototype[inspectSym] = function () {
-    return this.toJSON();
-};
-// @ts-expect-error - prototype assignment
 statsig_generated_1.ParameterStore.prototype[inspectSym] = function () {
     return this.toJSON();
 };
@@ -79,7 +64,7 @@ function createFetchFunc(options) {
         try {
             const res = yield (0, node_fetch_1.default)(url, {
                 method,
-                headers: Object.assign(Object.assign({}, headers), { 'Accept-Encoding': 'gzip, deflate, br' }),
+                headers: Object.assign({ 'accept-encoding': 'gzip, deflate, br' }, headers),
                 body: body ? Buffer.from(body) : undefined,
                 agent: proxyAgent,
             });
@@ -153,6 +138,26 @@ class Statsig extends statsig_generated_1.StatsigNapiInternal {
             }
         });
     }
+    getFeatureGate(user, gateName, options) {
+        const raw = this.__INTERNAL_getFeatureGate(user, gateName, options);
+        return new statsig_types_1.FeatureGate(gateName, raw);
+    }
+    getDynamicConfig(user, configName, options) {
+        const raw = this.__INTERNAL_getDynamicConfig(user, configName, options);
+        return new statsig_types_1.DynamicConfig(configName, raw);
+    }
+    getExperiment(user, experimentName, options) {
+        const raw = this.__INTERNAL_getExperiment(user, experimentName, options);
+        return new statsig_types_1.Experiment(experimentName, raw);
+    }
+    getExperimentByGroupName(experimentName, groupName) {
+        const raw = this.__INTERNAL_getExperimentByGroupName(experimentName, groupName);
+        return new statsig_types_1.Experiment(experimentName, raw);
+    }
+    getLayer(user, layerName, options) {
+        const raw = this.__INTERNAL_getLayer(user, layerName, options);
+        return new statsig_types_1.Layer((param) => this.__INTERNAL_logLayerParamExposure(raw, param), layerName, raw);
+    }
 }
 exports.Statsig = Statsig;
 Statsig._sharedInstance = null;

package/package.json

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

package/statsig-generated.d.ts

@@ -1,53 +1,5 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
-export declare class DynamicConfig {
-  name: string
-  value: Record<string, any>
-  ruleID: string
-  idType: string
-  details: EvaluationDetails
-  getValue(paramName: string, fallback?: boolean | number | string | object | Array<any> | null): any | null
-  get<T>(paramName: string, fallback: T): T
-  getRuleId(): string
-  getIdType(): string
-  getEvaluationDetails(): EvaluationDetails
-  getSecondaryExposures(): Array<SecondaryExposure> | null
-  toJSON(): Record<string, any>
-}
-
-export declare class Experiment {
-  name: string
-  value: Record<string, any>
-  ruleID: string
-  idType: string
-  groupName?: string
-  details: EvaluationDetails
-  getValue(paramName: string, fallback?: boolean | number | string | object | Array<any> | null): any | null
-  get<T>(paramName: string, fallback: T): T
-  getRuleId(): string
-  getIdType(): string
-  getGroupName(): string | null
-  getEvaluationDetails(): EvaluationDetails
-  getSecondaryExposures(): Array<SecondaryExposure> | null
-  toJSON(): Record<string, any>
-}
-
-export declare class Layer {
-  name: string
-  ruleID: string
-  groupName?: string
-  allocatedExperimentName?: string
-  value: Record<string, any>
-  details: EvaluationDetails
-  getValue(paramName: string, fallback?: boolean | number | string | object | Array<any> | null): any | null
-  get<T>(paramName: string, fallback: T): T
-  getRuleId(): string
-  getGroupName(): string | null
-  getEvaluationDetails(): EvaluationDetails
-  getSecondaryExposures(): Array<SecondaryExposure> | null
-  toJSON(): Record<string, any>
-}
-
 export declare class ParameterStore {
   name: string
   getValue<T>(paramName: string, fallback?: T): T
@@ -67,14 +19,15 @@ export declare class StatsigNapiInternal {
   logEvent(user: StatsigUser, eventName: string, value?: string | number | null, metadata?: Record<string, string> | undefined | null): 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
-  getFeatureGate(user: StatsigUser, featureName: string, options?: FeatureGateEvaluationOptions | undefined | null): FeatureGate
+  __INTERNAL_getFeatureGate(user: StatsigUser, featureName: string, options?: FeatureGateEvaluationOptions | undefined | null): string
   getFieldsNeededForGate(gateName: string): Array<string>
-  getDynamicConfig(user: StatsigUser, configName: string, options?: DynamicConfigEvaluationOptions | undefined | null): DynamicConfig
+  __INTERNAL_getDynamicConfig(user: StatsigUser, configName: string, options?: DynamicConfigEvaluationOptions | undefined | null): string
   getFieldsNeededForDynamicConfig(configName: string): Array<string>
-  getExperiment(user: StatsigUser, experimentName: string, options?: ExperimentEvaluationOptions | undefined | null): Experiment
-  getExperimentByGroupName(experimentName: string, groupName: string): Experiment
+  __INTERNAL_getExperiment(user: StatsigUser, experimentName: string, options?: ExperimentEvaluationOptions | undefined | null): string
+  __INTERNAL_getExperimentByGroupName(experimentName: string, groupName: string): string
   getFieldsNeededForExperiment(experimentName: string): Array<string>
-  getLayer(user: StatsigUser, layerName: string, options?: LayerEvaluationOptions | undefined | null): Layer
+  __INTERNAL_getLayer(user: StatsigUser, layerName: string, options?: LayerEvaluationOptions | undefined | null): string
+  __INTERNAL_logLayerParamExposure(raw: string, paramName: string): void
   getFieldsNeededForLayer(layerName: string): Array<string>
   identify(user: StatsigUser): void
   getParameterStore(user: StatsigUser, parameterStoreName: string, options?: ParameterStoreEvaluationOptions | undefined | null): ParameterStore
@@ -106,12 +59,12 @@ export declare class StatsigUser {
   static withCustomIDs(customIds: Record<string, string>): StatsigUser
   get customIDs(): Record<string, string> | null
   set customIDs(value: Record<string, string> | null)
-  get custom(): Record<string, string> | null
+  get custom(): Record<string, string | number | boolean | Array<string | number | boolean>> | null
   set custom(value: Record<string, string | number | boolean | Array<string | number | boolean>> | null)
-  get privateAttributes(): Record<string, string> | null
+  get privateAttributes(): Record<string, string | number | boolean | Array<string | number | boolean>> | null
   set privateAttributes(value: Record<string, string | number | boolean | Array<string | number | boolean>> | null)
   get statsigEnvironment(): Record<string, string> | null
-  set statsigEnvironment(value: { tier?: string, [key: string]: string | undefined } | null | undefined)
+  set statsigEnvironment(value: { tier?: string, [key: string]: string | undefined } | undefined)
   get userID(): string | null
   set userID(value: any)
   get email(): string | null
@@ -126,7 +79,7 @@ export declare class StatsigUser {
   set locale(value: any)
   get appVersion(): string | null
   set appVersion(value: any)
-  toJSON(): string
+  toJSON(): any
 }
 
 export declare function __internal__testDataStore(store: DataStore, path: string, value: string): Promise<[DataStoreResponse | undefined | null, boolean]>
@@ -148,6 +101,7 @@ export interface ClientInitResponseOptions {
   paramStoreFilter?: Set<string>
   removeIdType?: boolean
   removeDefaultValueGates?: boolean
+  responseFormat?: GCIRResponseFormat
 }
 
 export interface ConsoleCaptureOptions {
@@ -188,18 +142,16 @@ export interface ExperimentEvaluationOptions {
   userPersistedValues?: Record<string, any>
 }
 
-export interface FeatureGate {
-  name: string
-  value: boolean
-  ruleID: string
-  idType: string
-  details: EvaluationDetails
-}
-
 export interface FeatureGateEvaluationOptions {
   disableExposureLogging?: boolean
 }
 
+export declare const enum GCIRResponseFormat {
+  Initialize = 0,
+  InitializeWithSecondaryExposureMapping = 1,
+  InitializeV2 = 2
+}
+
 export interface LayerEvaluationOptions {
   disableExposureLogging?: boolean
   userPersistedValues?: Record<string, any>
@@ -275,6 +227,7 @@ export declare function statsigCaptureLogLine(level: string, payload: Array<stri
 
 export interface StatsigOptions {
   dataStore?: DataStore
+  dataStoreKeySchemaVersion?: 'v2' | 'v3'
   disableAllLogging?: boolean
   disableCountryLookup?: boolean
   disableNetwork?: boolean
@@ -320,9 +273,9 @@ export interface StatsigUserArgs {
   country?: string
   locale?: string
   appVersion?: string
-  statsigEnvironment?: { tier?: string, [key: string]: string | undefined } | null | undefined
+  statsigEnvironment?: { tier?: string, [key: string]: string | undefined } | undefined
   custom?: Record<string, string | number | boolean | Array<string | number | boolean> | null | undefined | Record<string, unknown>>
-  privateAttributes?: Record<string, string | number | boolean | Array<string | number | boolean> | null | Record<string, unknown>>
+  privateAttributes?: Record<string, string | number | boolean | Array<string | number | boolean> | Record<string, unknown>>
 }
 // ---- Manually defined typing section ----- 
 

package/statsig-generated.js

@@ -364,9 +364,6 @@ if (!nativeBinding) {
   throw new Error(`Failed to load native binding`)
 }
 
-module.exports.DynamicConfig = nativeBinding.DynamicConfig
-module.exports.Experiment = nativeBinding.Experiment
-module.exports.Layer = nativeBinding.Layer
 module.exports.ParameterStore = nativeBinding.ParameterStore
 module.exports.StatsigNapiInternal = nativeBinding.StatsigNapiInternal
 module.exports.StatsigUser = nativeBinding.StatsigUser
@@ -374,5 +371,6 @@ module.exports.__internal__testDataStore = nativeBinding.__internal__testDataSto
 module.exports.__internal__testObservabilityClient = nativeBinding.__internal__testObservabilityClient
 module.exports.__internal__testOutputLogger = nativeBinding.__internal__testOutputLogger
 module.exports.__internal__testPersistentStorage = nativeBinding.__internal__testPersistentStorage
+module.exports.GCIRResponseFormat = nativeBinding.GCIRResponseFormat
 module.exports.OverrideAdapterType = nativeBinding.OverrideAdapterType
 module.exports.statsigCaptureLogLine = nativeBinding.statsigCaptureLogLine

package/statsig_types.d.ts

@@ -0,0 +1,44 @@
+import { EvaluationDetails, SecondaryExposure } from './statsig-generated';
+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;
+declare class BaseEvaluation {
+    readonly name: string;
+    readonly ruleID: string;
+    readonly idType: string;
+    readonly details: EvaluationDetails;
+    readonly secondaryExposures: SecondaryExposure[];
+    constructor(name: string, data: Record<string, unknown>);
+    getEvaluationDetails(): EvaluationDetails;
+    getRuleId(): string;
+    getIdType(): string;
+    getSecondaryExposures(): SecondaryExposure[];
+}
+export declare class FeatureGate extends BaseEvaluation {
+    readonly value: boolean;
+    constructor(name: string, raw: string | null);
+}
+export declare class DynamicConfig extends BaseEvaluation {
+    readonly value: Record<string, unknown>;
+    readonly get: TypedGet;
+    readonly getValue: UnknownGet;
+    constructor(name: string, raw: string);
+}
+export declare class Experiment extends BaseEvaluation {
+    readonly groupName: string | null;
+    readonly value: Record<string, unknown>;
+    readonly get: TypedGet;
+    readonly getValue: UnknownGet;
+    constructor(name: string, raw: string);
+    getGroupName(): string | null;
+}
+export declare class Layer extends BaseEvaluation {
+    readonly groupName: string | null;
+    readonly allocatedExperimentName: string | null;
+    readonly __value: Record<string, unknown>;
+    readonly get: TypedGet;
+    readonly getValue: UnknownGet;
+    constructor(exposeFn: (param: string) => void, name: string, raw: string);
+    getGroupName(): string | null;
+    getAllocatedExperimentName(): string | null;
+}
+export {};

package/statsig_types.js

@@ -0,0 +1,158 @@
+"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;
+        this.secondaryExposures = [];
+        this.name = name;
+        this.ruleID = (_a = data.ruleID) !== null && _a !== void 0 ? _a : '';
+        this.idType = (_b = data.idType) !== null && _b !== void 0 ? _b : '';
+        this.details = _extractEvaluationDetails(data.details);
+        this.secondaryExposures =
+            (_c = data.secondaryExposures) !== null && _c !== void 0 ? _c : [];
+    }
+    getEvaluationDetails() {
+        return this.details;
+    }
+    getRuleId() {
+        return this.ruleID;
+    }
+    getIdType() {
+        return this.idType;
+    }
+    getSecondaryExposures() {
+        return this.secondaryExposures;
+    }
+}
+class FeatureGate extends BaseEvaluation {
+    constructor(name, raw) {
+        const data = _parseRawEvaluation(raw);
+        super(name, data);
+        this.value = data.value === true;
+    }
+}
+exports.FeatureGate = FeatureGate;
+class DynamicConfig extends BaseEvaluation {
+    constructor(name, raw) {
+        var _a;
+        const data = _parseRawEvaluation(raw);
+        super(name, data);
+        this.value = {};
+        this.value = (_a = data.value) !== null && _a !== void 0 ? _a : {};
+        this.get = _makeTypedGet(name, this.value);
+        this.getValue = _makeUnknownGet(this.value);
+    }
+}
+exports.DynamicConfig = DynamicConfig;
+class Experiment extends BaseEvaluation {
+    constructor(name, raw) {
+        var _a, _b;
+        const data = _parseRawEvaluation(raw);
+        super(name, data);
+        this.groupName = null;
+        this.value = {};
+        this.groupName = (_a = data.groupName) !== null && _a !== void 0 ? _a : null;
+        this.value = (_b = data.value) !== null && _b !== void 0 ? _b : {};
+        this.get = _makeTypedGet(name, this.value);
+        this.getValue = _makeUnknownGet(this.value);
+    }
+    getGroupName() {
+        return this.groupName;
+    }
+}
+exports.Experiment = Experiment;
+class Layer extends BaseEvaluation {
+    constructor(exposeFn, name, raw) {
+        var _a, _b, _c;
+        const data = _parseRawEvaluation(raw);
+        super(name, data);
+        this.groupName = null;
+        this.allocatedExperimentName = null;
+        this.__value = {};
+        this.__value = (_a = data.value) !== null && _a !== void 0 ? _a : {};
+        this.groupName = (_b = data.groupName) !== null && _b !== void 0 ? _b : null;
+        this.allocatedExperimentName =
+            (_c = data.allocatedExperimentName) !== null && _c !== void 0 ? _c : null;
+        this.get = _makeTypedGet(name, this.__value, exposeFn);
+        this.getValue = _makeUnknownGet(this.__value, exposeFn);
+    }
+    getGroupName() {
+        return this.groupName;
+    }
+    getAllocatedExperimentName() {
+        return this.allocatedExperimentName;
+    }
+}
+exports.Layer = Layer;
+function _parseRawEvaluation(raw) {
+    try {
+        return JSON.parse(raw !== null && raw !== void 0 ? raw : '{}');
+    }
+    catch (error) {
+        console.error(`[Statsig] Error parsing BaseEvaluation: ${error}`);
+        return {};
+    }
+}
+function _makeTypedGet(name, value, exposeFunc) {
+    return (key, defaultValue, typeGuard = null) => {
+        var _a;
+        // @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 (defaultValue == null || expectedType === actualType) {
+            exposeFunc === null || exposeFunc === void 0 ? void 0 : exposeFunc(key);
+            return val;
+        }
+        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) {
+    return (param, fallback) => {
+        var _a;
+        if (fallback === undefined) {
+            fallback = null;
+        }
+        if (param == null) {
+            return fallback;
+        }
+        if (value[param] != null) {
+            exposeFunc === null || exposeFunc === void 0 ? void 0 : exposeFunc(param);
+        }
+        return (_a = value[param]) !== null && _a !== void 0 ? _a : fallback;
+    };
+}
+function _extractEvaluationDetails(data) {
+    if (data == null) {
+        return {
+            reason: '',
+            lcut: 0,
+            receivedAt: 0,
+            version: 0,
+        };
+    }
+    return {
+        reason: data.reason,
+        lcut: data.lcut,
+        receivedAt: data.received_at,
+        version: data.version,
+    };
+}