@npaw/forge-react-native 9.7.5 → 10.0.0

package/ios/NPAWForgeTurboModule.mm

@@ -135,6 +135,16 @@ RCT_EXPORT_METHOD(trackSessionError : (NSString *)instanceId errorCode : (NSStri
   [ForgeModuleImpl.shared trackSessionError:instanceId errorCode:errorCode errorMessage:errorMessage metadata:metadata resolve:resolve reject:ForgeMakeReject(reject)];
 }
 
+RCT_EXPORT_METHOD(updateSession : (NSString *)instanceId metadata : (NSDictionary *)metadata resolve : (RCTPromiseResolveBlock)resolve reject : (RCTPromiseRejectBlock)reject)
+{
+  [ForgeModuleImpl.shared updateSession:instanceId metadata:metadata resolve:resolve reject:ForgeMakeReject(reject)];
+}
+
+RCT_EXPORT_METHOD(updateSessionMetrics : (NSString *)instanceId metrics : (NSDictionary *)metrics resolve : (RCTPromiseResolveBlock)resolve reject : (RCTPromiseRejectBlock)reject)
+{
+  [ForgeModuleImpl.shared updateSessionMetrics:instanceId metrics:metrics resolve:resolve reject:ForgeMakeReject(reject)];
+}
+
 RCT_EXPORT_METHOD(loginSuccess : (NSString *)instanceId userId : (NSString *)userId options : (NSDictionary *)options resolve : (RCTPromiseResolveBlock)resolve reject : (RCTPromiseRejectBlock)reject)
 {
   [ForgeModuleImpl.shared loginSuccess:instanceId userId:userId options:options resolve:resolve reject:ForgeMakeReject(reject)];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@npaw/forge-react-native",
-  "version": "9.7.5",
+  "version": "10.0.0",
   "description": "NPAW Forge analytics for React Native: New Architecture TurboModule facade over the native Forge Android/Apple SDKs.",
   "license": "SEE LICENSE IN LICENSE",
   "author": "Victor Soto <victor.soto@nicepeopleatwork.com>",

package/src/NPAWForge.ts

@@ -77,6 +77,28 @@ export class NPAWForge {
     return asOutcome(NativeNPAWForge.trackSessionError(this.instanceId, errorCode, errorMessage, metadata));
   }
 
+  /**
+   * Hot-updates session-level dimensions without a session boundary:
+   * `param1`..`param20` extraparams, `screenName`, or any dimension the NQS
+   * parameter registry marks updatable — new backend dimensions work without
+   * an SDK release. Identity keys are rejected (use the typed identity API);
+   * blank values are dropped because NQS never erases a session value.
+   * Requires the account's remote config to enable session updates.
+   */
+  updateSession(metadata: ForgeParams): Promise<ForgeOutcome> {
+    return asOutcome(NativeNPAWForge.updateSession(this.instanceId, metadata));
+  }
+
+  /**
+   * Reports numeric session metrics (account-registered custom metrics).
+   * Values aggregate server-side per the account's registered operation and
+   * settle on the session close row; re-sending an unchanged value is a
+   * no-op. Same remote-config gating as `updateSession`.
+   */
+  updateSessionMetrics(metrics: Record<string, number>): Promise<ForgeOutcome> {
+    return asOutcome(NativeNPAWForge.updateSessionMetrics(this.instanceId, metrics));
+  }
+
   // ---- identity ----
 
   loginSuccess(userId: string, options: ForgeParams = {}): Promise<ForgeOutcome> {

package/src/specs/NativeNPAWForge.ts

@@ -35,6 +35,9 @@ export interface Spec extends TurboModule {
     metadata: UnsafeObject
   ): Promise<UnsafeObject>;
 
+  updateSession(instanceId: string, metadata: UnsafeObject): Promise<UnsafeObject>;
+  updateSessionMetrics(instanceId: string, metrics: UnsafeObject): Promise<UnsafeObject>;
+
   // ---- identity ----
   loginSuccess(instanceId: string, userId: string, options: UnsafeObject): Promise<UnsafeObject>;
   loginFailed(instanceId: string, options: UnsafeObject): Promise<UnsafeObject>;

package/src/types.ts

@@ -83,6 +83,14 @@ export type ForgeConfig = {
   processEventsBeforeSessionStart?: boolean;
   preSessionEventQueueLimitEvents?: number;
   preSessionEventQueueMaxAgeMs?: number;
+  /**
+   * Logout guard window in milliseconds (session-update mode only): after
+   * `logout()` closes the session, the kernel holds the replacement session
+   * back for this long so a follow-up `loginSuccess` attaches its own
+   * session directly; events raised inside the window are buffered with
+   * their original timestamps. `0` disables the guard. Default 30 000.
+   */
+  logoutSessionGuardMs?: number;
   allowLocalHttpForTesting?: boolean;
   deviceUuid?: string;
   autoDeviceIdentityEnabled?: boolean;