@formo/analytics 1.34.0 → 1.35.0

package/dist/cjs/src/FormoAnalytics.d.ts

@@ -190,12 +190,12 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * // Basic identify
      * formo.identify({ address: '0x...', userId: 'user123' });
      *
-     * // Privy: pass the usePrivy() user with `{ privy: true }` to identify every
-     * // linked wallet under the user's DID in one call. Attribution stays on the
-     * // already-connected wallet when there is one, else Privy's primary
-     * // (user.wallet); pass `activeAddress` to pin a specific wallet.
+     * // Privy: pass the usePrivy() user to identify every linked wallet under
+     * // the user's DID in one call. Attribution stays on the already-connected
+     * // wallet when there is one, else Privy's primary (user.wallet); pass
+     * // `activeAddress` to pin a specific wallet.
      * const { user } = usePrivy();
-     * if (user) formo.identify(user, { privy: true });
+     * if (user) formo.identify(user);
      * ```
      */
     identify(user: PrivyUser, options?: {

package/dist/cjs/src/FormoAnalytics.js

@@ -75,7 +75,8 @@ var chain_1 = require("./utils/chain");
 var wagmi_1 = require("./wagmi");
 var solana_1 = require("./solana");
 var SolanaManager_1 = require("./solana/SolanaManager");
-var privy_1 = require("./privy");
+// Internal: the Privy identify is reached through identify(user), not exported.
+var utils_1 = require("./privy/utils");
 /**
  * Constants for provider switching reasons
  */
@@ -573,7 +574,7 @@ var FormoAnalytics = /** @class */ (function () {
                         // namespace before emitting. It reads this.currentAddress itself to
                         // preserve an already-connected wallet, so this dispatch is a thin
                         // pass-through and both entry points behave identically.
-                        return [4 /*yield*/, (0, privy_1.identifyPrivyUser)(this, maybeUser, {
+                        return [4 /*yield*/, (0, utils_1.identifyPrivyUser)(this, maybeUser, {
                                 activeAddress: opts.activeAddress,
                                 properties: opts.properties,
                             })];

package/dist/cjs/src/core.d.ts

@@ -1,8 +1,8 @@
 export * from "./FormoAnalytics";
 export * from "./types";
 export { formofy } from "./initialization";
-export { parsePrivyProperties, identifyPrivyUser } from "./privy";
-export type { IdentifyPrivyUserOptions, PrivyUser, PrivyLinkedAccount, PrivyAccountType, PrivyProfileProperties, PrivyWalletInfo, } from "./privy";
+export { parsePrivyProperties } from "./privy";
+export type { PrivyUser, PrivyLinkedAccount, PrivyAccountType, PrivyProfileProperties, PrivyWalletInfo, } from "./privy";
 export { SolanaManager } from "./solana";
 export { SOLANA_CHAIN_IDS, DEFAULT_SOLANA_CHAIN_ID, isSolanaChainId, } from "./solana";
 export type { SolanaOptions, SolanaCluster } from "./solana";

package/dist/cjs/src/core.js

@@ -20,14 +20,13 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isSolanaChainId = exports.DEFAULT_SOLANA_CHAIN_ID = exports.SOLANA_CHAIN_IDS = exports.SolanaManager = exports.identifyPrivyUser = exports.parsePrivyProperties = exports.formofy = void 0;
+exports.isSolanaChainId = exports.DEFAULT_SOLANA_CHAIN_ID = exports.SOLANA_CHAIN_IDS = exports.SolanaManager = exports.parsePrivyProperties = exports.formofy = void 0;
 __exportStar(require("./FormoAnalytics"), exports);
 __exportStar(require("./types"), exports);
 var initialization_1 = require("./initialization");
 Object.defineProperty(exports, "formofy", { enumerable: true, get: function () { return initialization_1.formofy; } });
 var privy_1 = require("./privy");
 Object.defineProperty(exports, "parsePrivyProperties", { enumerable: true, get: function () { return privy_1.parsePrivyProperties; } });
-Object.defineProperty(exports, "identifyPrivyUser", { enumerable: true, get: function () { return privy_1.identifyPrivyUser; } });
 var solana_1 = require("./solana");
 Object.defineProperty(exports, "SolanaManager", { enumerable: true, get: function () { return solana_1.SolanaManager; } });
 var solana_2 = require("./solana");

package/dist/cjs/src/privy/index.d.ts

@@ -1,14 +1,15 @@
 /**
  * Privy integration module
  *
- * Provides utilities for enriching wallet profiles with Privy user data:
- * `parsePrivyProperties` (low-level parsing) and `identifyPrivyUser` (identify
- * every linked wallet under the user's DID). The same behavior is also
- * available as `formo.identify(user, { privy: true })`.
+ * Exports `parsePrivyProperties`, which parses a Privy user into a flat
+ * properties object and the list of linked wallets without emitting anything -
+ * useful for inspecting or displaying what an identify would send.
+ *
+ * The identify itself is `formo.identify(user)`, which recognises a Privy user
+ * by shape. The function behind it lives in ./utils and is internal.
  *
  * This module is React-free so it can be used from the `core` entry.
  */
-export { parsePrivyProperties, identifyPrivyUser } from "./utils";
-export type { IdentifyPrivyUserOptions } from "./utils";
+export { parsePrivyProperties } from "./utils";
 export type { PrivyUser, PrivyLinkedAccount, PrivyAccountType, PrivyProfileProperties, PrivyWalletInfo, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/privy/index.js

@@ -2,16 +2,17 @@
 /**
  * Privy integration module
  *
- * Provides utilities for enriching wallet profiles with Privy user data:
- * `parsePrivyProperties` (low-level parsing) and `identifyPrivyUser` (identify
- * every linked wallet under the user's DID). The same behavior is also
- * available as `formo.identify(user, { privy: true })`.
+ * Exports `parsePrivyProperties`, which parses a Privy user into a flat
+ * properties object and the list of linked wallets without emitting anything -
+ * useful for inspecting or displaying what an identify would send.
+ *
+ * The identify itself is `formo.identify(user)`, which recognises a Privy user
+ * by shape. The function behind it lives in ./utils and is internal.
  *
  * This module is React-free so it can be used from the `core` entry.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.identifyPrivyUser = exports.parsePrivyProperties = void 0;
+exports.parsePrivyProperties = void 0;
 var utils_1 = require("./utils");
 Object.defineProperty(exports, "parsePrivyProperties", { enumerable: true, get: function () { return utils_1.parsePrivyProperties; } });
-Object.defineProperty(exports, "identifyPrivyUser", { enumerable: true, get: function () { return utils_1.identifyPrivyUser; } });
 //# sourceMappingURL=index.js.map

package/dist/cjs/src/privy/utils.d.ts

@@ -92,7 +92,7 @@ export interface IdentifyPrivyUserOptions {
  * chain namespace (clearing a stale EVM chain id when a Solana wallet becomes
  * active, and vice versa), so identifies aren't dropped by an `excludeChains`
  * gate and later events aren't paired with the wrong chain. This happens here,
- * so the direct helper and the `formo.identify(user, { privy: true })` form
+ * so the direct helper and the `formo.identify(user)` form
  * behave identically.
  *
  * Returns the active linked wallet's `{ address, chainType }` (the one now

package/dist/cjs/src/privy/utils.js

@@ -421,7 +421,7 @@ function parsePrivyProperties(user) {
  * chain namespace (clearing a stale EVM chain id when a Solana wallet becomes
  * active, and vice versa), so identifies aren't dropped by an `excludeChains`
  * gate and later events aren't paired with the wrong chain. This happens here,
- * so the direct helper and the `formo.identify(user, { privy: true })` form
+ * so the direct helper and the `formo.identify(user)` form
  * behave identically.
  *
  * Returns the active linked wallet's `{ address, chainType }` (the one now

package/dist/cjs/src/queue/EventQueue.js

@@ -80,7 +80,7 @@ var MIN_QUEUE_SIZE = 200; // 200 bytes
 // keepalive fetch requests. Payloads exceeding this are silently cancelled,
 // producing a TypeError: Failed to fetch that cannot be resolved by retrying.
 var KEEPALIVE_PAYLOAD_LIMIT = 64 * 1024; // 64kB
-var DEFAULT_FLUSH_INTERVAL = 1000 * 30; // 1 MINUTE
+var DEFAULT_FLUSH_INTERVAL = 1000 * 30; // 30 SECONDS
 var MAX_FLUSH_INTERVAL = 1000 * 300; // 5 MINUTES
 var MIN_FLUSH_INTERVAL = 1000 * 10; // 10 SECONDS
 var EventQueue = /** @class */ (function () {
@@ -148,7 +148,12 @@ var EventQueue = /** @class */ (function () {
         this.flushAt = (0, utils_1.clampNumber)(options.flushAt || DEFAULT_FLUSH_AT, MAX_FLUSH_AT, MIN_FLUSH_AT);
         this.maxQueueSize = (0, utils_1.clampNumber)(options.maxQueueSize || DEFAULT_QUEUE_SIZE, MAX_QUEUE_SIZE, MIN_QUEUE_SIZE);
         this.flushIntervalMs = (0, utils_1.clampNumber)(options.flushInterval || DEFAULT_FLUSH_INTERVAL, MAX_FLUSH_INTERVAL, MIN_FLUSH_INTERVAL);
-        this.flushed = true;
+        // Start un-flushed so the first event of the page load is sent
+        // immediately (see enqueue). Short visits — e.g. ad-click landings in
+        // mobile in-app browsers — often end with the webview process killed
+        // before any pagehide/visibilitychange fires, so an event that waits
+        // for the batch timer or a lifecycle flush is lost with the process.
+        this.flushed = false;
         this.errorHandler = options.errorHandler;
         this.pendingFlush = null;
         this.timer = null;
@@ -259,11 +264,11 @@ var EventQueue = /** @class */ (function () {
                         // before opt-out. Drop everything rather than send post-withdrawal.
                         if (this.canSend && !this.canSend()) {
                             this.clear();
-                            callback();
+                            safeCall(callback);
                             return [2 /*return*/, Promise.resolve()];
                         }
                         if (!this.queue.length) {
-                            callback();
+                            safeCall(callback);
                             return [2 /*return*/, Promise.resolve()];
                         }
                         if (!this.pendingFlush) return [3 /*break*/, 2];

package/dist/cjs/src/version.d.ts

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

package/dist/cjs/src/version.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // This file is auto-generated by scripts/update-version.js during npm version
 // Do not edit manually - it will be overwritten
-exports.version = '1.34.0';
+exports.version = '1.35.0';
 //# sourceMappingURL=version.js.map

package/dist/esm/src/FormoAnalytics.d.ts

@@ -190,12 +190,12 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * // Basic identify
      * formo.identify({ address: '0x...', userId: 'user123' });
      *
-     * // Privy: pass the usePrivy() user with `{ privy: true }` to identify every
-     * // linked wallet under the user's DID in one call. Attribution stays on the
-     * // already-connected wallet when there is one, else Privy's primary
-     * // (user.wallet); pass `activeAddress` to pin a specific wallet.
+     * // Privy: pass the usePrivy() user to identify every linked wallet under
+     * // the user's DID in one call. Attribution stays on the already-connected
+     * // wallet when there is one, else Privy's primary (user.wallet); pass
+     * // `activeAddress` to pin a specific wallet.
      * const { user } = usePrivy();
-     * if (user) formo.identify(user, { privy: true });
+     * if (user) formo.identify(user);
      * ```
      */
     identify(user: PrivyUser, options?: {

package/dist/esm/src/FormoAnalytics.js

@@ -72,7 +72,8 @@ import { parseChainId } from "./utils/chain";
 import { WagmiEventHandler } from "./wagmi";
 import { isSolanaChainId } from "./solana";
 import { SolanaManager } from "./solana/SolanaManager";
-import { identifyPrivyUser } from "./privy";
+// Internal: the Privy identify is reached through identify(user), not exported.
+import { identifyPrivyUser } from "./privy/utils";
 /**
  * Constants for provider switching reasons
  */

package/dist/esm/src/core.d.ts

@@ -1,8 +1,8 @@
 export * from "./FormoAnalytics";
 export * from "./types";
 export { formofy } from "./initialization";
-export { parsePrivyProperties, identifyPrivyUser } from "./privy";
-export type { IdentifyPrivyUserOptions, PrivyUser, PrivyLinkedAccount, PrivyAccountType, PrivyProfileProperties, PrivyWalletInfo, } from "./privy";
+export { parsePrivyProperties } from "./privy";
+export type { PrivyUser, PrivyLinkedAccount, PrivyAccountType, PrivyProfileProperties, PrivyWalletInfo, } from "./privy";
 export { SolanaManager } from "./solana";
 export { SOLANA_CHAIN_IDS, DEFAULT_SOLANA_CHAIN_ID, isSolanaChainId, } from "./solana";
 export type { SolanaOptions, SolanaCluster } from "./solana";

package/dist/esm/src/core.js

@@ -7,7 +7,7 @@
 export * from "./FormoAnalytics";
 export * from "./types";
 export { formofy } from "./initialization";
-export { parsePrivyProperties, identifyPrivyUser } from "./privy";
+export { parsePrivyProperties } from "./privy";
 export { SolanaManager } from "./solana";
 export { SOLANA_CHAIN_IDS, DEFAULT_SOLANA_CHAIN_ID, isSolanaChainId, } from "./solana";
 //# sourceMappingURL=core.js.map

package/dist/esm/src/privy/index.d.ts

@@ -1,14 +1,15 @@
 /**
  * Privy integration module
  *
- * Provides utilities for enriching wallet profiles with Privy user data:
- * `parsePrivyProperties` (low-level parsing) and `identifyPrivyUser` (identify
- * every linked wallet under the user's DID). The same behavior is also
- * available as `formo.identify(user, { privy: true })`.
+ * Exports `parsePrivyProperties`, which parses a Privy user into a flat
+ * properties object and the list of linked wallets without emitting anything -
+ * useful for inspecting or displaying what an identify would send.
+ *
+ * The identify itself is `formo.identify(user)`, which recognises a Privy user
+ * by shape. The function behind it lives in ./utils and is internal.
  *
  * This module is React-free so it can be used from the `core` entry.
  */
-export { parsePrivyProperties, identifyPrivyUser } from "./utils";
-export type { IdentifyPrivyUserOptions } from "./utils";
+export { parsePrivyProperties } from "./utils";
 export type { PrivyUser, PrivyLinkedAccount, PrivyAccountType, PrivyProfileProperties, PrivyWalletInfo, } from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/src/privy/index.js

@@ -1,12 +1,14 @@
 /**
  * Privy integration module
  *
- * Provides utilities for enriching wallet profiles with Privy user data:
- * `parsePrivyProperties` (low-level parsing) and `identifyPrivyUser` (identify
- * every linked wallet under the user's DID). The same behavior is also
- * available as `formo.identify(user, { privy: true })`.
+ * Exports `parsePrivyProperties`, which parses a Privy user into a flat
+ * properties object and the list of linked wallets without emitting anything -
+ * useful for inspecting or displaying what an identify would send.
+ *
+ * The identify itself is `formo.identify(user)`, which recognises a Privy user
+ * by shape. The function behind it lives in ./utils and is internal.
  *
  * This module is React-free so it can be used from the `core` entry.
  */
-export { parsePrivyProperties, identifyPrivyUser } from "./utils";
+export { parsePrivyProperties } from "./utils";
 //# sourceMappingURL=index.js.map

package/dist/esm/src/privy/utils.d.ts

@@ -92,7 +92,7 @@ export interface IdentifyPrivyUserOptions {
  * chain namespace (clearing a stale EVM chain id when a Solana wallet becomes
  * active, and vice versa), so identifies aren't dropped by an `excludeChains`
  * gate and later events aren't paired with the wrong chain. This happens here,
- * so the direct helper and the `formo.identify(user, { privy: true })` form
+ * so the direct helper and the `formo.identify(user)` form
  * behave identically.
  *
  * Returns the active linked wallet's `{ address, chainType }` (the one now

package/dist/esm/src/privy/utils.js

@@ -417,7 +417,7 @@ export function parsePrivyProperties(user) {
  * chain namespace (clearing a stale EVM chain id when a Solana wallet becomes
  * active, and vice versa), so identifies aren't dropped by an `excludeChains`
  * gate and later events aren't paired with the wrong chain. This happens here,
- * so the direct helper and the `formo.identify(user, { privy: true })` form
+ * so the direct helper and the `formo.identify(user)` form
  * behave identically.
  *
  * Returns the active linked wallet's `{ address, chainType }` (the one now

package/dist/esm/src/queue/EventQueue.js

@@ -74,7 +74,7 @@ var MIN_QUEUE_SIZE = 200; // 200 bytes
 // keepalive fetch requests. Payloads exceeding this are silently cancelled,
 // producing a TypeError: Failed to fetch that cannot be resolved by retrying.
 var KEEPALIVE_PAYLOAD_LIMIT = 64 * 1024; // 64kB
-var DEFAULT_FLUSH_INTERVAL = 1000 * 30; // 1 MINUTE
+var DEFAULT_FLUSH_INTERVAL = 1000 * 30; // 30 SECONDS
 var MAX_FLUSH_INTERVAL = 1000 * 300; // 5 MINUTES
 var MIN_FLUSH_INTERVAL = 1000 * 10; // 10 SECONDS
 var EventQueue = /** @class */ (function () {
@@ -142,7 +142,12 @@ var EventQueue = /** @class */ (function () {
         this.flushAt = clampNumber(options.flushAt || DEFAULT_FLUSH_AT, MAX_FLUSH_AT, MIN_FLUSH_AT);
         this.maxQueueSize = clampNumber(options.maxQueueSize || DEFAULT_QUEUE_SIZE, MAX_QUEUE_SIZE, MIN_QUEUE_SIZE);
         this.flushIntervalMs = clampNumber(options.flushInterval || DEFAULT_FLUSH_INTERVAL, MAX_FLUSH_INTERVAL, MIN_FLUSH_INTERVAL);
-        this.flushed = true;
+        // Start un-flushed so the first event of the page load is sent
+        // immediately (see enqueue). Short visits — e.g. ad-click landings in
+        // mobile in-app browsers — often end with the webview process killed
+        // before any pagehide/visibilitychange fires, so an event that waits
+        // for the batch timer or a lifecycle flush is lost with the process.
+        this.flushed = false;
         this.errorHandler = options.errorHandler;
         this.pendingFlush = null;
         this.timer = null;
@@ -253,11 +258,11 @@ var EventQueue = /** @class */ (function () {
                         // before opt-out. Drop everything rather than send post-withdrawal.
                         if (this.canSend && !this.canSend()) {
                             this.clear();
-                            callback();
+                            safeCall(callback);
                             return [2 /*return*/, Promise.resolve()];
                         }
                         if (!this.queue.length) {
-                            callback();
+                            safeCall(callback);
                             return [2 /*return*/, Promise.resolve()];
                         }
                         if (!this.pendingFlush) return [3 /*break*/, 2];

package/dist/esm/src/version.d.ts

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

package/dist/esm/src/version.js

@@ -1,4 +1,4 @@
 // This file is auto-generated by scripts/update-version.js during npm version
 // Do not edit manually - it will be overwritten
-export var version = '1.34.0';
+export var version = '1.35.0';
 //# sourceMappingURL=version.js.map