@formo/analytics-react-native 0.1.6 → 1.0.0

package/lib/typescript/module/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}

package/lib/typescript/module/utils/timestamp.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Get current time in ISO format
+ */
+export declare function getCurrentTimeFormatted(): string;
+/**
+ * Format date to YYYY-MM-DD HH:mm format for hashing
+ */
+export declare function toDateHourMinute(date: Date): string;
+/**
+ * Convert milliseconds to seconds
+ */
+export declare function millisecondsToSecond(ms: number): number;
+//# sourceMappingURL=timestamp.d.ts.map

package/lib/typescript/module/utils/timestamp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../../../src/utils/timestamp.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAOnD;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAEvD"}

package/lib/typescript/module/utils/trafficSource.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Traffic Source Utilities
+ * Parse UTM parameters and referral information from URLs
+ */
+import type { ITrafficSource } from "../types";
+/**
+ * Parse UTM parameters and referral info from URL
+ * Supports both web URLs (https://) and deep link URLs (myapp://)
+ */
+export declare function parseTrafficSource(url: string, customRefParams?: string[], pathPattern?: string): Partial<ITrafficSource>;
+/**
+ * Store traffic source in session storage
+ * Only stores if we have actual UTM or ref data
+ */
+export declare function storeTrafficSource(trafficSource: Partial<ITrafficSource>): void;
+/**
+ * Get stored traffic source from session
+ * Returns undefined if no traffic source is stored
+ */
+export declare function getStoredTrafficSource(): Partial<ITrafficSource> | undefined;
+/**
+ * Clear stored traffic source from session
+ */
+export declare function clearTrafficSource(): void;
+/**
+ * Merge stored traffic source with current context
+ * Stored traffic source is used as fallback - current context takes priority
+ */
+export declare function mergeWithStoredTrafficSource(context?: Record<string, unknown>): Record<string, unknown>;
+/**
+ * Update stored traffic source with incoming values. Per-field last-touch with
+ * fallback: non-empty incoming fields win, empty incoming fields preserve the
+ * previously stored value. This matches the Formo web SDK's behavior and
+ * prevents a non-marketing deep link (e.g. "myapp://home" with only a referrer
+ * and no UTM/ref) from destroying existing attribution data written by the
+ * Install Referrer flow or an earlier marketing deep link.
+ */
+export declare function updateStoredTrafficSource(incoming: Partial<ITrafficSource>): void;
+/**
+ * Merge a partial traffic source into the stored one, only filling in fields
+ * that are currently empty. Used by the Install Referrer flow so campaign data
+ * from the Play Store install referrer cannot clobber a deep-link attribution
+ * that arrived earlier in the same cold start.
+ */
+export declare function mergeTrafficSourceFill(incoming: Partial<ITrafficSource>): void;
+//# sourceMappingURL=trafficSource.d.ts.map

package/lib/typescript/module/utils/trafficSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trafficSource.d.ts","sourceRoot":"","sources":["../../../../src/utils/trafficSource.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,eAAe,CAAC,EAAE,MAAM,EAAE,EAC1B,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,cAAc,CAAC,CA8DzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAkB/E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAAC,cAAc,CAAC,GAAG,SAAS,CAU5E;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAOzC;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAYzB;AAaD;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,IAAI,CAmBN;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,OAAO,CAAC,cAAc,CAAC,GAChC,IAAI,CAqBN"}

package/lib/typescript/module/version.d.ts

@@ -0,0 +1,2 @@
+export declare const version = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/lib/typescript/module/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/package.json

@@ -1,15 +1,15 @@
 {
   "name": "@formo/analytics-react-native",
-  "version": "0.1.6",
+  "version": "1.0.0",
   "description": "Formo Analytics SDK for React Native - Track wallet events and user analytics in mobile dApps",
-  "packageManager": "pnpm@10.27.0",
+  "packageManager": "pnpm@11.1.1",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/getformo/sdk-react-native.git"
   },
   "main": "lib/commonjs/index.js",
   "module": "lib/module/index.js",
-  "types": "lib/typescript/index.d.ts",
+  "types": "lib/typescript/commonjs/index.d.ts",
   "react-native": "src/index.ts",
   "source": "src/index.ts",
   "files": [
@@ -21,9 +21,14 @@
   ],
   "exports": {
     ".": {
-      "import": "./lib/module/index.js",
-      "require": "./lib/commonjs/index.js",
-      "types": "./lib/typescript/index.d.ts"
+      "import": {
+        "types": "./lib/typescript/module/index.d.ts",
+        "default": "./lib/module/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/index.d.ts",
+        "default": "./lib/commonjs/index.js"
+      }
     }
   },
   "private": false,
@@ -63,6 +68,7 @@
     "react": ">=18.0.0",
     "react-native": ">=0.70.0",
     "react-native-device-info": ">=10.0.0",
+    "react-native-play-install-referrer": ">=1.1.8",
     "wagmi": ">=2.0.0"
   },
   "peerDependenciesMeta": {
@@ -81,66 +87,55 @@
     "react-native-device-info": {
       "optional": true
     },
+    "react-native-play-install-referrer": {
+      "optional": true
+    },
     "wagmi": {
       "optional": true
     }
   },
   "dependencies": {
-    "@react-native-community/netinfo": "^11.5.1",
+    "@react-native-community/netinfo": "12.0.1",
     "ethereum-cryptography": "3.2.0"
   },
   "devDependencies": {
-    "@babel/preset-env": "^7.29.0",
+    "@babel/preset-env": "^7.29.5",
     "@babel/preset-react": "^7.28.5",
     "@babel/preset-typescript": "^7.28.5",
     "@react-native-async-storage/async-storage": "^1.21.0",
-    "@react-native/babel-preset": "^0.77.0",
-    "@types/jest": "^29.5.12",
-    "@types/react": "^18.0.25",
-    "@typescript-eslint/eslint-plugin": "^8.57.2",
-    "@typescript-eslint/parser": "^8.57.2",
-    "babel-jest": "^29.7.0",
-    "eslint": "^10.1.0",
-    "expo-application": "^6.0.0",
-    "expo-device": "^7.0.0",
-    "jest": "^29.7.0",
-    "react": "^18.3.1",
-    "react-native": "^0.77.0",
-    "react-native-builder-bob": "^0.23.0",
+    "@react-native/babel-preset": "^0.85.3",
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.2.14",
+    "@typescript-eslint/eslint-plugin": "^8.59.3",
+    "@typescript-eslint/parser": "^8.59.3",
+    "babel-jest": "^30.4.1",
+    "eslint": "^10.3.0",
+    "expo-application": "^55.0.15",
+    "expo-device": "^55.0.17",
+    "jest": "^30.4.1",
+    "react": "^19.2.6",
+    "react-native": "^0.85.3",
+    "react-native-builder-bob": "^0.41.0",
     "react-native-device-info": "^14.0.0",
-    "typescript": "^5.7.3",
-    "typescript-eslint": "^8.57.2"
-  },
-  "pnpm": {
-    "overrides": {
-      "@react-native-community/cli": ">=17.0.1",
-      "@react-native-community/cli-server-api": ">=17.0.1",
-      "@xmldom/xmldom": ">=0.8.12",
-      "brace-expansion@1": ">=1.1.13 <2",
-      "brace-expansion@2": ">=2.0.3 <3",
-      "fast-xml-parser": ">=4.5.5",
-      "minimatch@3": ">=3.1.5 <4",
-      "minimatch@5": ">=5.1.9 <6",
-      "minimatch@9": ">=9.0.9 <10",
-      "minimatch@10": ">=10.2.4",
-      "node-forge": ">=1.4.0",
-      "picomatch@2": ">=2.3.2 <3",
-      "picomatch@3": ">=3.0.2 <4",
-      "picomatch@4": ">=4.0.4",
-      "semver@5": ">=7.7.4",
-      "semver@6": ">=7.7.4",
-      "tar": ">=7.5.13",
-      "undici": ">=6.24.1 <7",
-      "yaml@1": ">=1.10.3 <2",
-      "yaml@2": ">=2.8.3 <3"
-    }
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.3"
   },
   "react-native-builder-bob": {
     "source": "src",
     "output": "lib",
     "targets": [
-      "commonjs",
-      "module",
+      [
+        "commonjs",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
       [
         "typescript",
         {

package/src/FormoAnalytics.ts

@@ -8,6 +8,8 @@ import {
   EVENTS_API_HOST,
   EventType,
   LOCAL_ANONYMOUS_ID_KEY,
+  LOCAL_SESSION_ID_KEY,
+  LOCAL_SESSION_LAST_ACTIVITY_KEY,
   SESSION_USER_ID_KEY,
   CONSENT_OPT_OUT_KEY,
   TEventType,
@@ -132,14 +134,14 @@ export class FormoAnalytics implements IFormoAnalytics {
     const analytics = new FormoAnalytics(writeKey, options);
 
     // Capture attribution BEFORE lifecycle tracking so the first
-    // Application Installed/Opened events carry utm_*/ref/referrer context.
+    // Application Installed/Opened events carry utm_*/ref/referrer.
     //
-    // Deep-link initial URL is awaited because Linking.getInitialURL() is a
-    // fast native bridge call and we need its result before lifecycle events
-    // fire. The url-event subscription is set up synchronously for runtime
-    // deep links. Install-referrer capture (Play / AdServices) is fire-and-
-    // forget since it involves potentially-slow network I/O on iOS and is
-    // best-effort; it'll still populate attribution for subsequent events.
+    // Both are awaited so the stored traffic source is populated before
+    // lifecycle fires — that's what lets Application Installed report the
+    // web-to-mobile referrer (e.g. referrer=example.com). Deep-link initial URL
+    // is a fast native bridge call; the Android Play Install Referrer is a fast
+    // one-shot native call (and no-ops instantly when the native module or the
+    // platform isn't Android), so awaiting it does not meaningfully delay init.
     if (analytics.isAttributionEnabled("deeplinks")) {
       try {
         await analytics.startDeepLinkCapture();
@@ -149,12 +151,14 @@ export class FormoAnalytics implements IFormoAnalytics {
     }
 
     if (analytics.isAttributionEnabled("installReferrer")) {
-      captureInstallReferrer({
-        customRefParams: analytics.options.referral?.queryParams,
-        pathPattern: analytics.options.referral?.pathPattern,
-      }).catch((error) => {
+      try {
+        await captureInstallReferrer({
+          customRefParams: analytics.options.referral?.queryParams,
+          pathPattern: analytics.options.referral?.pathPattern,
+        });
+      } catch (error) {
         logger.debug("FormoAnalytics: install referrer capture failed", error);
-      });
+      }
     }
 
     // Initialize lifecycle tracking if enabled
@@ -256,6 +260,8 @@ export class FormoAnalytics implements IFormoAnalytics {
   public reset(): void {
     this.currentUserId = undefined;
     storage().remove(LOCAL_ANONYMOUS_ID_KEY);
+    storage().remove(LOCAL_SESSION_ID_KEY);
+    storage().remove(LOCAL_SESSION_LAST_ACTIVITY_KEY);
     storage().remove(SESSION_USER_ID_KEY);
     this.session.clear();
   }

package/src/constants/events.ts

@@ -24,3 +24,7 @@ export type TEventChannel = Lowercase<EventChannel>;
 // React Native SDK uses mobile channel
 export const CHANNEL: TEventChannel = "mobile";
 export const VERSION = "0";
+
+// Session inactivity timeout (30 min), matching the GA4/Segment default. A new
+// session_id is minted once the gap since the last tracked event exceeds this.
+export const SESSION_TIMEOUT_MS = 30 * 60 * 1000;

package/src/constants/storage.ts

@@ -5,8 +5,12 @@ export const STORAGE_PREFIX = "formo_rn_";
 export const LOCAL_ANONYMOUS_ID_KEY = "anonymous_id";
 export const LOCAL_APP_VERSION_KEY = "app_version";
 export const LOCAL_APP_BUILD_KEY = "app_build";
-// One-shot flag: set once the Install Referrer (Android) or AdServices (iOS)
-// attribution has been fetched, so we never call the native API again.
+// Session identifier + last-activity marker. Persisted so a session survives an
+// app restart, but expires after SESSION_TIMEOUT_MS of inactivity (see EventFactory).
+export const LOCAL_SESSION_ID_KEY = "session_id";
+export const LOCAL_SESSION_LAST_ACTIVITY_KEY = "session_last_activity";
+// One-shot flag: set once the Android Play Install Referrer attribution has
+// been fetched, so we never call the native API again.
 export const LOCAL_INSTALL_REFERRER_RESOLVED_KEY = "install_referrer_resolved";
 
 // Session storage keys (cleared on app restart)

package/src/lib/event/EventFactory.ts

@@ -25,7 +25,15 @@ try {
 } catch {
   // Not available
 }
-import { COUNTRY_LIST, LOCAL_ANONYMOUS_ID_KEY, CHANNEL, VERSION } from "../../constants";
+import {
+  COUNTRY_LIST,
+  LOCAL_ANONYMOUS_ID_KEY,
+  LOCAL_SESSION_ID_KEY,
+  LOCAL_SESSION_LAST_ACTIVITY_KEY,
+  SESSION_TIMEOUT_MS,
+  CHANNEL,
+  VERSION,
+} from "../../constants";
 import {
   Address,
   APIEvent,
@@ -65,6 +73,73 @@ function generateAnonymousId(key: string): string {
   return newId;
 }
 
+/**
+ * Get the current session id, or start a new one.
+ *
+ * A session persists across app restarts but expires after SESSION_TIMEOUT_MS of
+ * inactivity, at which point a fresh id is minted. Every call refreshes the
+ * last-activity marker.
+ *
+ * The mobile SDK owns its session_id rather than letting ingestion derive one.
+ * The events-gateway authorizer computes
+ * `hash(dailySalt + domain + sourceIp + userAgent)` — a design built for the
+ * web, where all three inputs carry real entropy. For a native app they all
+ * degenerate at once: there is no Origin header (so `domain` is the constant
+ * "unknown"), the HTTP User-Agent is the client library's (`okhttp/…`,
+ * `CFNetwork/… Darwin/…`) and is near-identical across users on the same app
+ * build, and carrier CGNAT puts many users behind one IP — so unrelated users
+ * collapse into a single session. Ingestion honours a body-provided session_id
+ * (`obj?.session_id || session_id` in handlerV0), which is the path used here.
+ */
+export function getSessionId(): string {
+  const now = Date.now();
+  const existingId = storage().get(LOCAL_SESSION_ID_KEY);
+  const lastActivityRaw = storage().get(LOCAL_SESSION_LAST_ACTIVITY_KEY);
+  const lastActivity = lastActivityRaw ? parseInt(lastActivityRaw, 10) : 0;
+
+  const isExpired =
+    !existingId || !lastActivity || now - lastActivity > SESSION_TIMEOUT_MS;
+  const sessionId = isExpired ? generateUUID() : existingId;
+
+  storage().set(LOCAL_SESSION_ID_KEY, sessionId);
+  storage().set(LOCAL_SESSION_LAST_ACTIVITY_KEY, String(now));
+
+  return sessionId;
+}
+
+/**
+ * Build a representative User-Agent string from structured device info.
+ *
+ * The ingestion pipeline classifies device / os / browser purely from the
+ * user_agent string; a mobile event with an empty UA is bucketed as "unknown".
+ * Platforms without a native UA (e.g. Expo, where DeviceInfo.getUserAgent() is
+ * unavailable) would otherwise report device=os=unknown. We synthesize a UA
+ * containing the tokens the classifier keys off (iphone/ipad/android + version)
+ * so mobile device and OS resolve correctly. Returns "" for unknown platforms.
+ */
+export function synthesizeUserAgent(info: {
+  os_name: string;
+  os_version: string;
+  device_model: string;
+  device_type: string;
+}): string {
+  const os = (info.os_name || "").toLowerCase();
+  const version = info.os_version || "";
+  const model = info.device_model || "";
+  const isTablet = info.device_type === "tablet";
+
+  if (os === "ios" || os === "ipados") {
+    const device = isTablet ? "iPad" : "iPhone";
+    const osVersion = version.replace(/\./g, "_");
+    return `Mozilla/5.0 (${device}; CPU ${device} OS ${osVersion} like Mac OS X) FormoAnalytics/ReactNative`;
+  }
+  if (os === "android") {
+    const formFactor = isTablet ? "Tablet" : "Mobile";
+    return `Mozilla/5.0 (Linux; Android ${version}; ${model}) ${formFactor} FormoAnalytics/ReactNative`;
+  }
+  return "";
+}
+
 /**
  * Event factory for React Native
  * Creates event payloads with mobile-specific context
@@ -218,14 +293,24 @@ class EventFactory implements IEventFactory {
           DeviceInfo.isTablet(),
         ]);
 
+        const device_type = isTablet ? "tablet" : "mobile";
+        const os_version = DeviceInfo.getSystemVersion();
         return {
           os_name: Platform.OS,
-          os_version: DeviceInfo.getSystemVersion(),
+          os_version,
           device_model: model,
           device_manufacturer: manufacturer,
           device_name: deviceName,
-          device_type: isTablet ? "tablet" : "mobile",
-          user_agent: userAgent,
+          device_type,
+          // Prefer the native UA; fall back to a synthesized one if unavailable.
+          user_agent:
+            userAgent ||
+            synthesizeUserAgent({
+              os_name: Platform.OS,
+              os_version,
+              device_model: model,
+              device_type,
+            }),
           app_name: DeviceInfo.getApplicationName(),
           app_version: DeviceInfo.getVersion(),
           app_build: DeviceInfo.getBuildNumber(),
@@ -240,14 +325,25 @@ class EventFactory implements IEventFactory {
     if (ExpoDevice || ExpoApplication) {
       try {
         const isTablet = ExpoDevice?.deviceType === ExpoDevice?.DeviceType?.TABLET;
+        const os_name = ExpoDevice?.osName || Platform.OS;
+        const os_version = ExpoDevice?.osVersion || String(Platform.Version);
+        const device_model = ExpoDevice?.modelName || "Unknown";
+        const device_type = isTablet ? "tablet" : "mobile";
         return {
-          os_name: ExpoDevice?.osName || Platform.OS,
-          os_version: ExpoDevice?.osVersion || String(Platform.Version),
-          device_model: ExpoDevice?.modelName || "Unknown",
+          os_name,
+          os_version,
+          device_model,
           device_manufacturer: ExpoDevice?.manufacturer || "Unknown",
           device_name: ExpoDevice?.deviceName || "Unknown Device",
-          device_type: isTablet ? "tablet" : "mobile",
-          user_agent: "",
+          device_type,
+          // Expo exposes no native UA; synthesize one so the pipeline can
+          // classify device/os (both are derived from the UA string).
+          user_agent: synthesizeUserAgent({
+            os_name,
+            os_version,
+            device_model,
+            device_type,
+          }),
           app_name: ExpoApplication?.applicationName || "",
           app_version: ExpoApplication?.nativeApplicationVersion || "",
           app_build: ExpoApplication?.nativeBuildVersion || "",
@@ -260,14 +356,21 @@ class EventFactory implements IEventFactory {
 
     // Final fallback - minimal info from Platform
     logger.debug("No device info modules available, using Platform defaults");
+    const os_name = Platform.OS;
+    const os_version = String(Platform.Version);
     return {
-      os_name: Platform.OS,
-      os_version: String(Platform.Version),
+      os_name,
+      os_version,
       device_model: "Unknown",
       device_manufacturer: "Unknown",
       device_name: "Unknown Device",
       device_type: "mobile",
-      user_agent: "",
+      user_agent: synthesizeUserAgent({
+        os_name,
+        os_version,
+        device_model: "Unknown",
+        device_type: "mobile",
+      }),
       app_name: "",
       app_version: "",
       app_build: "",
@@ -334,6 +437,7 @@ class EventFactory implements IEventFactory {
     };
 
     commonEventData.anonymous_id = generateAnonymousId(LOCAL_ANONYMOUS_ID_KEY);
+    commonEventData.session_id = getSessionId();
 
     // Handle address - convert undefined to null for consistency
     // Try EVM first, then Solana fallback (chainId is not always present here).
@@ -383,8 +487,12 @@ class EventFactory implements IEventFactory {
   ): Promise<IFormoEvent> {
     const props = { ...(properties ?? {}), name, ...(category && { category }) };
 
-    // Map screen name to page-equivalent context fields for Tinybird compatibility.
-    // page_path is omitted — Tinybird derives it from page_url via path().
+    // Map screen name to page-equivalent context fields so mobile screens flow
+    // through the same analytics as web page views. The screen name is emitted
+    // as-is in the app:// URL; the ingestion pipeline derives `origin` (from the
+    // app identifier in context — app_name / app_bundle_id) and `page_path` (by
+    // stripping the app:// scheme), so the SDK deliberately does NOT encode a
+    // host here (see backend mobile page-event handling, P-2070).
     // User-supplied context values take precedence (spread last).
     const screenContext: IFormoEventContext = {
       page_title: name,

package/src/lib/event/EventQueue.ts

@@ -168,6 +168,20 @@ export class EventQueue implements IEventQueue {
       `Event enqueued: ${getActionDescriptor(event.type, event.properties)}`
     );
 
+    // Per-event detail line for debugging (only prints when debug logging is on).
+    const ctx = (event.context ?? {}) as Record<string, unknown>;
+    logger.debug(
+      "Event detail:",
+      JSON.stringify({
+        type: event.type,
+        event: event.event,
+        session_id: event.session_id,
+        anonymous_id: event.anonymous_id,
+        user_agent: ctx.user_agent,
+        page_url: ctx.page_url,
+      })
+    );
+
     const hasReachedFlushAt = this.queue.length >= this.flushAt;
     const hasReachedQueueSize =
       this.queue.reduce(