@formo/analytics 1.30.0 → 1.31.0

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

@@ -1,5 +1,11 @@
-import { FC } from "react";
-import { FormoAnalyticsProviderProps, IFormoAnalytics } from "./types";
+import { FC, ReactNode } from "react";
+import { IFormoAnalytics, Options } from "./types";
+export interface FormoAnalyticsProviderProps {
+    writeKey: string;
+    options?: Options;
+    disabled?: boolean;
+    children: ReactNode;
+}
 export declare const FormoAnalyticsContext: import("react").Context<IFormoAnalytics>;
 export declare const FormoAnalyticsProvider: FC<FormoAnalyticsProviderProps>;
 export declare const useFormo: () => IFormoAnalytics;

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

@@ -0,0 +1,10 @@
+export * from "./FormoAnalytics";
+export * from "./types";
+export { formofy } from "./initialization";
+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";
+export type { SolanaClientStore, SolanaClientState } from "./solana";
+//# sourceMappingURL=core.d.ts.map

package/dist/cjs/src/core.js

@@ -0,0 +1,36 @@
+"use strict";
+// React-free entry point.
+// Use this from non-React frameworks (Angular, Vue, Svelte, vanilla JS) to
+// avoid pulling the React provider into the dependency graph.
+//
+// Equivalent to the package root entry minus FormoAnalyticsProvider/useFormo
+// and the `window.formofy = formofy` side effect.
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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.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; } });
+var solana_1 = require("./solana");
+Object.defineProperty(exports, "SolanaManager", { enumerable: true, get: function () { return solana_1.SolanaManager; } });
+var solana_2 = require("./solana");
+Object.defineProperty(exports, "SOLANA_CHAIN_IDS", { enumerable: true, get: function () { return solana_2.SOLANA_CHAIN_IDS; } });
+Object.defineProperty(exports, "DEFAULT_SOLANA_CHAIN_ID", { enumerable: true, get: function () { return solana_2.DEFAULT_SOLANA_CHAIN_ID; } });
+Object.defineProperty(exports, "isSolanaChainId", { enumerable: true, get: function () { return solana_2.isSolanaChainId; } });
+//# sourceMappingURL=core.js.map

package/dist/cjs/src/event/EventFactory.d.ts

@@ -19,6 +19,14 @@ declare class EventFactory implements IEventFactory {
     private extractUTMParameters;
     private extractClickIdParameters;
     private extractReferralParameter;
+    /**
+     * Returns the document referrer with same-host referrers filtered out.
+     * Internal navigation populates `document.referrer` with the previous page
+     * on the same site, which is not an attribution signal — treating it as
+     * "external" would otherwise let an internal URL become the session's
+     * first-touch referrer after a direct landing.
+     */
+    private getExternalReferrer;
     private getTrafficSources;
     private getScreen;
     private generateContext;

package/dist/cjs/src/event/EventFactory.js

@@ -127,9 +127,29 @@ var EventFactory = /** @class */ (function () {
             }
             return "";
         };
+        /**
+         * Returns the document referrer with same-host referrers filtered out.
+         * Internal navigation populates `document.referrer` with the previous page
+         * on the same site, which is not an attribution signal — treating it as
+         * "external" would otherwise let an internal URL become the session's
+         * first-touch referrer after a direct landing.
+         */
+        this.getExternalReferrer = function () {
+            var _a;
+            var ref = document.referrer;
+            if (!ref)
+                return "";
+            try {
+                var currentHost = (_a = globalThis.location) === null || _a === void 0 ? void 0 : _a.hostname;
+                if (currentHost && new URL(ref).hostname === currentHost)
+                    return "";
+            }
+            catch (_b) { }
+            return ref;
+        };
         this.getTrafficSources = function (url) {
             var urlObj = new URL(url);
-            var contextTrafficSources = __assign(__assign(__assign({}, _this.extractUTMParameters(url)), _this.extractClickIdParameters(urlObj)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
+            var contextTrafficSources = __assign(__assign(__assign({}, _this.extractUTMParameters(url)), _this.extractClickIdParameters(urlObj)), { ref: _this.extractReferralParameter(urlObj), referrer: _this.getExternalReferrer() });
             var storedTrafficSources = (0, storage_1.session)().get(constants_1.SESSION_TRAFFIC_SOURCE_KEY) || {};
             var mergedClickIds = {};
             for (var _i = 0, CLICK_ID_PARAMS_2 = constants_2.CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_2.length; _i++) {
@@ -137,7 +157,12 @@ var EventFactory = /** @class */ (function () {
                 mergedClickIds[p] =
                     contextTrafficSources[p] || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources[p]) || "";
             }
-            var finalTrafficSources = __assign({ ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "", referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "", utm_campaign: contextTrafficSources.utm_campaign ||
+            var finalTrafficSources = __assign({ ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "", 
+                // Referrer is sticky (first-touch wins). Same-host referrers are already
+                // stripped by getExternalReferrer; the stored-first OR keeps the entry
+                // referrer pinned even if a later pageview reports a different external
+                // referrer (e.g. cross-domain return from an outbound click).
+                referrer: (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || contextTrafficSources.referrer || "", utm_campaign: contextTrafficSources.utm_campaign ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_campaign) ||
                     "", utm_content: contextTrafficSources.utm_content ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_content) ||

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

@@ -1,10 +1,3 @@
+export * from "./core";
 export * from "./FormoAnalyticsProvider";
-export * from "./FormoAnalytics";
-export * from "./types";
-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";
-export type { SolanaClientStore, SolanaClientState, } from "./solana";
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/index.js

@@ -14,20 +14,9 @@ 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.parsePrivyProperties = void 0;
 var initialization_1 = require("./initialization");
+__exportStar(require("./core"), exports);
 __exportStar(require("./FormoAnalyticsProvider"), exports);
-__exportStar(require("./FormoAnalytics"), exports);
-__exportStar(require("./types"), exports);
-var privy_1 = require("./privy");
-Object.defineProperty(exports, "parsePrivyProperties", { enumerable: true, get: function () { return privy_1.parsePrivyProperties; } });
-// Solana integration exports
-var solana_1 = require("./solana");
-Object.defineProperty(exports, "SolanaManager", { enumerable: true, get: function () { return solana_1.SolanaManager; } });
-var solana_2 = require("./solana");
-Object.defineProperty(exports, "SOLANA_CHAIN_IDS", { enumerable: true, get: function () { return solana_2.SOLANA_CHAIN_IDS; } });
-Object.defineProperty(exports, "DEFAULT_SOLANA_CHAIN_ID", { enumerable: true, get: function () { return solana_2.DEFAULT_SOLANA_CHAIN_ID; } });
-Object.defineProperty(exports, "isSolanaChainId", { enumerable: true, get: function () { return solana_2.isSolanaChainId; } });
 if (typeof window !== "undefined")
     window.formofy = initialization_1.formofy;
 //# sourceMappingURL=index.js.map

package/dist/cjs/src/types/base.d.ts

@@ -1,7 +1,6 @@
 import { LogLevel } from "../logger";
 import { IFormoEventContext, IFormoEventProperties, SignatureStatus, TransactionStatus } from "./events";
 import { EIP1193Provider } from "./provider";
-import { ReactNode } from "react";
 import { SolanaOptions } from "../solana/types";
 export type Nullable<T> = T | null;
 export type ChainID = number;
@@ -221,10 +220,4 @@ export interface Options {
     errorHandler?: (err: Error) => void;
     ready?: (formo: IFormoAnalytics) => void;
 }
-export interface FormoAnalyticsProviderProps {
-    writeKey: string;
-    options?: Options;
-    disabled?: boolean;
-    children: ReactNode;
-}
 //# sourceMappingURL=base.d.ts.map

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

@@ -1,2 +1,2 @@
-export declare const version = "1.30.0";
+export declare const version = "1.30.1";
 //# 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.30.0';
+exports.version = '1.30.1';
 //# sourceMappingURL=version.js.map

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

@@ -1,5 +1,11 @@
-import { FC } from "react";
-import { FormoAnalyticsProviderProps, IFormoAnalytics } from "./types";
+import { FC, ReactNode } from "react";
+import { IFormoAnalytics, Options } from "./types";
+export interface FormoAnalyticsProviderProps {
+    writeKey: string;
+    options?: Options;
+    disabled?: boolean;
+    children: ReactNode;
+}
 export declare const FormoAnalyticsContext: import("react").Context<IFormoAnalytics>;
 export declare const FormoAnalyticsProvider: FC<FormoAnalyticsProviderProps>;
 export declare const useFormo: () => IFormoAnalytics;

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

@@ -0,0 +1,10 @@
+export * from "./FormoAnalytics";
+export * from "./types";
+export { formofy } from "./initialization";
+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";
+export type { SolanaClientStore, SolanaClientState } from "./solana";
+//# sourceMappingURL=core.d.ts.map

package/dist/esm/src/core.js

@@ -0,0 +1,13 @@
+// React-free entry point.
+// Use this from non-React frameworks (Angular, Vue, Svelte, vanilla JS) to
+// avoid pulling the React provider into the dependency graph.
+//
+// Equivalent to the package root entry minus FormoAnalyticsProvider/useFormo
+// and the `window.formofy = formofy` side effect.
+export * from "./FormoAnalytics";
+export * from "./types";
+export { formofy } from "./initialization";
+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/event/EventFactory.d.ts

@@ -19,6 +19,14 @@ declare class EventFactory implements IEventFactory {
     private extractUTMParameters;
     private extractClickIdParameters;
     private extractReferralParameter;
+    /**
+     * Returns the document referrer with same-host referrers filtered out.
+     * Internal navigation populates `document.referrer` with the previous page
+     * on the same site, which is not an attribution signal — treating it as
+     * "external" would otherwise let an internal URL become the session's
+     * first-touch referrer after a direct landing.
+     */
+    private getExternalReferrer;
     private getTrafficSources;
     private getScreen;
     private generateContext;

package/dist/esm/src/event/EventFactory.js

@@ -121,9 +121,29 @@ var EventFactory = /** @class */ (function () {
             }
             return "";
         };
+        /**
+         * Returns the document referrer with same-host referrers filtered out.
+         * Internal navigation populates `document.referrer` with the previous page
+         * on the same site, which is not an attribution signal — treating it as
+         * "external" would otherwise let an internal URL become the session's
+         * first-touch referrer after a direct landing.
+         */
+        this.getExternalReferrer = function () {
+            var _a;
+            var ref = document.referrer;
+            if (!ref)
+                return "";
+            try {
+                var currentHost = (_a = globalThis.location) === null || _a === void 0 ? void 0 : _a.hostname;
+                if (currentHost && new URL(ref).hostname === currentHost)
+                    return "";
+            }
+            catch (_b) { }
+            return ref;
+        };
         this.getTrafficSources = function (url) {
             var urlObj = new URL(url);
-            var contextTrafficSources = __assign(__assign(__assign({}, _this.extractUTMParameters(url)), _this.extractClickIdParameters(urlObj)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
+            var contextTrafficSources = __assign(__assign(__assign({}, _this.extractUTMParameters(url)), _this.extractClickIdParameters(urlObj)), { ref: _this.extractReferralParameter(urlObj), referrer: _this.getExternalReferrer() });
             var storedTrafficSources = session().get(SESSION_TRAFFIC_SOURCE_KEY) || {};
             var mergedClickIds = {};
             for (var _i = 0, CLICK_ID_PARAMS_2 = CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_2.length; _i++) {
@@ -131,7 +151,12 @@ var EventFactory = /** @class */ (function () {
                 mergedClickIds[p] =
                     contextTrafficSources[p] || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources[p]) || "";
             }
-            var finalTrafficSources = __assign({ ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "", referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "", utm_campaign: contextTrafficSources.utm_campaign ||
+            var finalTrafficSources = __assign({ ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "", 
+                // Referrer is sticky (first-touch wins). Same-host referrers are already
+                // stripped by getExternalReferrer; the stored-first OR keeps the entry
+                // referrer pinned even if a later pageview reports a different external
+                // referrer (e.g. cross-domain return from an outbound click).
+                referrer: (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || contextTrafficSources.referrer || "", utm_campaign: contextTrafficSources.utm_campaign ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_campaign) ||
                     "", utm_content: contextTrafficSources.utm_content ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_content) ||

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

@@ -1,10 +1,3 @@
+export * from "./core";
 export * from "./FormoAnalyticsProvider";
-export * from "./FormoAnalytics";
-export * from "./types";
-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";
-export type { SolanaClientStore, SolanaClientState, } from "./solana";
 //# sourceMappingURL=index.d.ts.map

package/dist/esm/src/index.js

@@ -1,11 +1,6 @@
 import { formofy } from "./initialization";
+export * from "./core";
 export * from "./FormoAnalyticsProvider";
-export * from "./FormoAnalytics";
-export * from "./types";
-export { parsePrivyProperties } from "./privy";
-// Solana integration exports
-export { SolanaManager } from "./solana";
-export { SOLANA_CHAIN_IDS, DEFAULT_SOLANA_CHAIN_ID, isSolanaChainId } from "./solana";
 if (typeof window !== "undefined")
     window.formofy = formofy;
 //# sourceMappingURL=index.js.map

package/dist/esm/src/types/base.d.ts

@@ -1,7 +1,6 @@
 import { LogLevel } from "../logger";
 import { IFormoEventContext, IFormoEventProperties, SignatureStatus, TransactionStatus } from "./events";
 import { EIP1193Provider } from "./provider";
-import { ReactNode } from "react";
 import { SolanaOptions } from "../solana/types";
 export type Nullable<T> = T | null;
 export type ChainID = number;
@@ -221,10 +220,4 @@ export interface Options {
     errorHandler?: (err: Error) => void;
     ready?: (formo: IFormoAnalytics) => void;
 }
-export interface FormoAnalyticsProviderProps {
-    writeKey: string;
-    options?: Options;
-    disabled?: boolean;
-    children: ReactNode;
-}
 //# sourceMappingURL=base.d.ts.map

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

@@ -1,2 +1,2 @@
-export declare const version = "1.30.0";
+export declare const version = "1.30.1";
 //# 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.30.0';
+export var version = '1.30.1';
 //# sourceMappingURL=version.js.map