@npaw/forge-react-native 9.7.5 → 10.0.1

package/ios/ForgeModuleImpl.swift

@@ -194,6 +194,37 @@ public final class ForgeModuleImpl: NSObject {
         }
     }
 
+    // MARK: - Session updates
+
+    @objc public func updateSession(
+        _ instanceId: String,
+        metadata: [String: Any]?,
+        resolve: @escaping ForgeResolveBlock,
+        reject: @escaping ForgeRejectBlock
+    ) {
+        withInstance(instanceId, resolve: resolve, reject: reject) {
+            $0.updateSession(metadata ?? [:])
+        }
+    }
+
+    @objc public func updateSessionMetrics(
+        _ instanceId: String,
+        metrics: [String: Any]?,
+        resolve: @escaping ForgeResolveBlock,
+        reject: @escaping ForgeRejectBlock
+    ) {
+        var converted: [String: Double] = [:]
+        for (key, value) in metrics ?? [:] {
+            if let number = value as? NSNumber {
+                converted[key] = number.doubleValue
+            }
+        }
+        let numeric = converted
+        withInstance(instanceId, resolve: resolve, reject: reject) {
+            $0.updateSessionMetrics(numeric)
+        }
+    }
+
     // MARK: - Identity
 
     @objc public func loginSuccess(
@@ -1045,6 +1076,8 @@ public final class ForgeModuleImpl: NSObject {
                 builder.setPreSessionEventQueueLimitEvents((value as? NSNumber)?.intValue ?? 100)
             case "preSessionEventQueueMaxAgeMs":
                 builder.setPreSessionEventQueueMaxAgeMs((value as? NSNumber)?.int64Value ?? 0)
+            case "logoutSessionGuardMs":
+                builder.setLogoutSessionGuardMs((value as? NSNumber)?.int64Value ?? 30_000)
             case "allowLocalHttpForTesting":
                 builder.setLocalPlaintextTransportForTesting(value as? Bool ?? false)
             case "deviceUuid":
@@ -1086,6 +1119,7 @@ public final class ForgeModuleImpl: NSObject {
         record.redirectDurationMs = int64(map["redirectDurationMs"])
         record.redirectCount = int64(map["redirectCount"])
         record.networkProtocol = map["protocol"] as? String
+        record.requestType = map["requestType"] as? String
         record.requestBytes = int64(map["requestBytes"])
         record.responseBytes = int64(map["responseBytes"])
         return record

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.1",
   "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;
@@ -128,6 +136,13 @@ export type ForgeNetworkRequestRecord = {
   redirectDurationMs?: number;
   redirectCount?: number;
   protocol?: string;
+  /**
+   * Resource class of the request as reported by the observing host, e.g. a
+   * player adapter classifying its SDK's own downloads. Canonical lowercase
+   * tokens (`manifest`, `media_video`, `drm_license`, ...); the kernel caps
+   * it at 32 chars on the wire.
+   */
+  requestType?: string;
   requestBytes?: number;
   responseBytes?: number;
 };