@formo/analytics 1.22.0 → 1.24.0

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

@@ -94,6 +94,24 @@ export interface AutocaptureOptions {
      */
     chain?: boolean;
 }
+/**
+ * Configuration options for referral parameter parsing
+ */
+export interface ReferralOptions {
+    /**
+     * Custom query parameter names to check for referral codes
+     * @default ["ref", "referral", "refcode"]
+     * @example ["via", "referrer", "source"] - will check ?via=CODE, ?referrer=CODE, ?source=CODE
+     */
+    queryParams?: string[];
+    /**
+     * URL path pattern to extract referral code from
+     * Should be a regex string that matches the path segment containing the referral code
+     * The first capture group will be used as the referral code
+     * @example "/r/([^/]+)" - will extract "01K17FKB" from "https://glider.fi/r/01K17FKB"
+     */
+    pathPattern?: string;
+}
 export interface Options {
     provider?: EIP1193Provider;
     tracking?: boolean | TrackingOptions;
@@ -105,6 +123,15 @@ export interface Options {
      * @default true
      */
     autocapture?: boolean | AutocaptureOptions;
+    /**
+     * Custom API host for sending events through your own domain to bypass ad blockers
+     * - If not provided, events are sent directly to events.formo.so
+     * - When provided, events are sent to your custom endpoint which should forward them to Formo
+     * - Example: 'https://your-host-url.com/ingest' or '/api/analytics'
+     *
+     * See https://docs.formo.so/sdks/web#proxy for setup instructions
+     */
+    apiHost?: string;
     flushAt?: number;
     flushInterval?: number;
     retryCount?: number;
@@ -113,6 +140,12 @@ export interface Options {
         enabled?: boolean;
         levels?: LogLevel[];
     };
+    /**
+     * Configuration for referral parameter parsing from URLs
+     * Allows customizing how referral codes are detected from query parameters and URL paths
+     * @example { queryParams: ["via"], pathPattern: "/r/([^/]+)" }
+     */
+    referral?: ReferralOptions;
     ready?: (formo: IFormoAnalytics) => void;
 }
 export interface FormoAnalyticsProviderProps {

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

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

package/dist/esm/src/version.js

@@ -0,0 +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.24.0';
+//# sourceMappingURL=version.js.map