@firebase/remote-config 0.7.0 → 0.8.0-20260114160934

package/dist/remote-config-public.d.ts

@@ -136,6 +136,12 @@ export declare interface FetchResponse {
      * The version number of the config template fetched from the server.
      */
     templateVersion?: number;
+    /**
+     * Metadata for A/B testing and Remote Config Rollout experiments.
+     *
+     * @remarks Only defined for 200 responses.
+     */
+    experiments?: FirebaseExperimentDescription[];
 }
 
 /**
@@ -165,6 +171,20 @@ export declare type FetchStatus = 'no-fetch-yet' | 'success' | 'failure' | 'thro
  */
 export declare type FetchType = 'BASE' | 'REALTIME';
 
+/**
+ * Defines experiment and variant attached to a config parameter.
+ *
+ * @public
+ */
+export declare interface FirebaseExperimentDescription {
+    experimentId: string;
+    variantId: string;
+    experimentStartTime: string;
+    triggerTimeoutMillis: string;
+    timeToLiveMillis: string;
+    affectedParameterKeys?: string[];
+}
+
 /**
  * Defines a self-descriptive reference for config key-value pairs.
  *

package/dist/remote-config.d.ts

@@ -136,6 +136,12 @@ export declare interface FetchResponse {
      * The version number of the config template fetched from the server.
      */
     templateVersion?: number;
+    /**
+     * Metadata for A/B testing and Remote Config Rollout experiments.
+     *
+     * @remarks Only defined for 200 responses.
+     */
+    experiments?: FirebaseExperimentDescription[];
 }
 
 /**
@@ -165,6 +171,20 @@ export declare type FetchStatus = 'no-fetch-yet' | 'success' | 'failure' | 'thro
  */
 export declare type FetchType = 'BASE' | 'REALTIME';
 
+/**
+ * Defines experiment and variant attached to a config parameter.
+ *
+ * @public
+ */
+export declare interface FirebaseExperimentDescription {
+    experimentId: string;
+    variantId: string;
+    experimentStartTime: string;
+    triggerTimeoutMillis: string;
+    timeToLiveMillis: string;
+    affectedParameterKeys?: string[];
+}
+
 /**
  * Defines a self-descriptive reference for config key-value pairs.
  *

package/dist/src/abt/experiment.d.ts

@@ -0,0 +1,13 @@
+import { FirebaseExperimentDescription } from '../public_types';
+import { RemoteConfig } from '../remote_config';
+export declare class Experiment {
+    private storage;
+    private logger;
+    private analyticsProvider;
+    constructor(rc: RemoteConfig);
+    updateActiveExperiments(latestExperiments: FirebaseExperimentDescription[]): Promise<void>;
+    private createExperimentInfoMap;
+    private addActiveExperiments;
+    private removeInactiveExperiments;
+    private addExperimentToAnalytics;
+}

package/dist/src/errors.d.ts

@@ -35,7 +35,8 @@ export declare const enum ErrorCode {
     CONFIG_UPDATE_STREAM_ERROR = "stream-error",
     CONFIG_UPDATE_UNAVAILABLE = "realtime-unavailable",
     CONFIG_UPDATE_MESSAGE_INVALID = "update-message-invalid",
-    CONFIG_UPDATE_NOT_FETCHED = "update-not-fetched"
+    CONFIG_UPDATE_NOT_FETCHED = "update-not-fetched",
+    ANALYTICS_UNAVAILABLE = "analytics-unavailable"
 }
 interface ErrorParams {
     [ErrorCode.STORAGE_OPEN]: {
@@ -77,6 +78,9 @@ interface ErrorParams {
     [ErrorCode.CONFIG_UPDATE_NOT_FETCHED]: {
         originalErrorMessage: string;
     };
+    [ErrorCode.ANALYTICS_UNAVAILABLE]: {
+        originalErrorMessage: string;
+    };
 }
 export declare const ERROR_FACTORY: ErrorFactory<ErrorCode, ErrorParams>;
 export declare function hasErrorCode(e: Error, errorCode: ErrorCode): boolean;

package/dist/src/global_index.d.ts

@@ -255,6 +255,19 @@ interface RemoteConfig {
 interface FirebaseRemoteConfigObject {
     [key: string]: string;
 }
+/**
+ * Defines experiment and variant attached to a config parameter.
+ *
+ * @public
+ */
+interface FirebaseExperimentDescription {
+    experimentId: string;
+    variantId: string;
+    experimentStartTime: string;
+    triggerTimeoutMillis: string;
+    timeToLiveMillis: string;
+    affectedParameterKeys?: string[];
+}
 /**
  * Defines a successful response (200 or 304).
  *
@@ -291,6 +304,12 @@ interface FetchResponse {
      * The version number of the config template fetched from the server.
      */
     templateVersion?: number;
+    /**
+     * Metadata for A/B testing and Remote Config Rollout experiments.
+     *
+     * @remarks Only defined for 200 responses.
+     */
+    experiments?: FirebaseExperimentDescription[];
 }
 /**
  * Options for Remote Config initialization.
@@ -652,4 +671,4 @@ declare global {
     }
 }
 
-export { ConfigUpdate, ConfigUpdateObserver, CustomSignals, FetchResponse, FetchStatus, FetchType, FirebaseRemoteConfigObject, LogLevel, RemoteConfig, RemoteConfigOptions, RemoteConfigSettings, Unsubscribe, Value, ValueSource, activate, ensureInitialized, fetchAndActivate, fetchConfig, getAll, getBoolean, getNumber, getRemoteConfig, getString, getValue, isSupported, onConfigUpdate, setCustomSignals, setLogLevel };
+export { ConfigUpdate, ConfigUpdateObserver, CustomSignals, FetchResponse, FetchStatus, FetchType, FirebaseExperimentDescription, FirebaseRemoteConfigObject, LogLevel, RemoteConfig, RemoteConfigOptions, RemoteConfigSettings, Unsubscribe, Value, ValueSource, activate, ensureInitialized, fetchAndActivate, fetchConfig, getAll, getBoolean, getNumber, getRemoteConfig, getString, getValue, isSupported, onConfigUpdate, setCustomSignals, setLogLevel };

package/dist/src/public_types.d.ts

@@ -54,6 +54,19 @@ export interface RemoteConfig {
 export interface FirebaseRemoteConfigObject {
     [key: string]: string;
 }
+/**
+ * Defines experiment and variant attached to a config parameter.
+ *
+ * @public
+ */
+export interface FirebaseExperimentDescription {
+    experimentId: string;
+    variantId: string;
+    experimentStartTime: string;
+    triggerTimeoutMillis: string;
+    timeToLiveMillis: string;
+    affectedParameterKeys?: string[];
+}
 /**
  * Defines a successful response (200 or 304).
  *
@@ -90,6 +103,12 @@ export interface FetchResponse {
      * The version number of the config template fetched from the server.
      */
     templateVersion?: number;
+    /**
+     * Metadata for A/B testing and Remote Config Rollout experiments.
+     *
+     * @remarks Only defined for 200 responses.
+     */
+    experiments?: FirebaseExperimentDescription[];
 }
 /**
  * Options for Remote Config initialization.

package/dist/src/remote_config.d.ts

@@ -20,6 +20,8 @@ import { StorageCache } from './storage/storage_cache';
 import { RemoteConfigFetchClient } from './client/remote_config_fetch_client';
 import { Storage } from './storage/storage';
 import { Logger } from '@firebase/logger';
+import { FirebaseAnalyticsInternalName } from '@firebase/analytics-interop-types';
+import { Provider } from '@firebase/component';
 import { RealtimeHandler } from './client/realtime_handler';
 /**
  * Encapsulates business logic mapping network and storage dependencies to the public SDK API.
@@ -48,6 +50,10 @@ export declare class RemoteConfig implements RemoteConfigType {
      * @internal
      */
     readonly _realtimeHandler: RealtimeHandler;
+    /**
+     * @internal
+     */
+    readonly _analyticsProvider: Provider<FirebaseAnalyticsInternalName>;
     /**
      * Tracks completion of initialization promise.
      * @internal
@@ -84,5 +90,9 @@ export declare class RemoteConfig implements RemoteConfigType {
     /**
      * @internal
      */
-    _realtimeHandler: RealtimeHandler);
+    _realtimeHandler: RealtimeHandler, 
+    /**
+     * @internal
+     */
+    _analyticsProvider: Provider<FirebaseAnalyticsInternalName>);
 }

package/dist/src/storage/storage.d.ts

@@ -43,7 +43,7 @@ export interface RealtimeBackoffMetadata {
  *
  * <p>This seems like a small price to avoid potentially subtle bugs caused by a typo.
  */
-type ProjectNamespaceKeyFieldValue = 'active_config' | 'active_config_etag' | 'last_fetch_status' | 'last_successful_fetch_timestamp_millis' | 'last_successful_fetch_response' | 'settings' | 'throttle_metadata' | 'custom_signals' | 'realtime_backoff_metadata' | 'last_known_template_version';
+type ProjectNamespaceKeyFieldValue = 'active_config' | 'active_config_etag' | 'active_experiments' | 'last_fetch_status' | 'last_successful_fetch_timestamp_millis' | 'last_successful_fetch_response' | 'settings' | 'throttle_metadata' | 'custom_signals' | 'realtime_backoff_metadata' | 'last_known_template_version';
 export declare function openDatabase(): Promise<IDBDatabase>;
 /**
  * Abstracts data persistence.
@@ -59,6 +59,8 @@ export declare abstract class Storage {
     setActiveConfig(config: FirebaseRemoteConfigObject): Promise<void>;
     getActiveConfigEtag(): Promise<string | undefined>;
     setActiveConfigEtag(etag: string): Promise<void>;
+    getActiveExperiments(): Promise<Set<string> | undefined>;
+    setActiveExperiments(experiments: Set<string>): Promise<void>;
     getThrottleMetadata(): Promise<ThrottleMetadata | undefined>;
     setThrottleMetadata(metadata: ThrottleMetadata): Promise<void>;
     deleteThrottleMetadata(): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@firebase/remote-config",
-  "version": "0.7.0",
+  "version": "0.8.0-20260114160934",
   "description": "The Remote Config package of the Firebase JS SDK",
   "author": "Firebase <firebase-support@google.com> (https://firebase.google.com/)",
   "main": "dist/index.cjs.js",
@@ -48,7 +48,7 @@
   },
   "license": "Apache-2.0",
   "devDependencies": {
-    "@firebase/app": "0.14.3",
+    "@firebase/app": "0.14.6",
     "rollup": "2.79.2",
     "rollup-plugin-dts": "5.3.1",
     "rollup-plugin-typescript2": "0.36.0",