wisetrack 2.0.6 → 2.0.8

package/dist/cjs/types/event/wt-event.d.ts

@@ -1,109 +1,93 @@
 import { RevenueCurrency } from "./revenue-currency";
 type WTEventType = "default" | "revenue";
 export type EventParam = string | number | boolean;
-export declare namespace WTEvent {
+/**
+ * Represents an event that can be tracked.
+ *
+ * Use the static factory methods to create events:
+ * - `WTEvent.defaultEvent()` for default events
+ * - `WTEvent.revenueEvent()` for revenue/purchase events
+ *
+ * @example
+ * ```ts
+ * // Simple event
+ * const event1 = WTEvent.defaultEvent("signup");
+ *
+ * // Event with parameters
+ * const event2 = WTEvent.defaultEvent("signup", { method: "Google", platform: "web" });
+ *
+ * // Revenue event
+ * const purchase = WTEvent.revenueEvent("order_complete", 49.99, RevenueCurrency.USD, {
+ *   item_count: 3,
+ *   payment_method: "credit_card"
+ * });
+ *
+ * WiseTrack.instance.trackEvent(event1);
+ * ```
+ */
+export declare class WTEvent {
     /**
-     * Represents a generic custom event.
+     * The type of event.
+     * @internal
+     */
+    readonly type: WTEventType;
+    /**
+     * The name of the event.
+     */
+    readonly name: string;
+    /**
+     * Custom key-value parameters for the event.
+     */
+    readonly params: Record<string, EventParam>;
+    /**
+     * The revenue amount (only for revenue events).
+     */
+    readonly amount?: number;
+    /**
+     * The currency of the revenue (only for revenue events).
+     */
+    readonly currency?: RevenueCurrency;
+    /**
+     * Private constructor. Use static factory methods instead.
+     * @internal
+     */
+    private constructor();
+    /**
+     * Creates a default event for tracking default user actions.
      *
-     * Use this class to log custom actions performed by the user.
+     * @param name - The name of the event.
+     * @param params - Optional custom key-value parameters for the event.
+     * @returns A new WTEvent instance.
      *
      * @example
      * ```ts
-     * const event = new WTEvent.Default("signup");
-     * event.addParam("method", "Google");
+     * const event = WTEvent.defaultEvent("button_click", { button_id: "signup" });
      * WiseTrack.instance.trackEvent(event);
      * ```
      */
-    class Default {
-        /**
-         * The type of event.
-         * @internal
-         */
-        readonly type: WTEventType;
-        /**
-         * Optional custom key-value parameters for the event.
-         */
-        params?: Record<string, EventParam>;
-        /**
-         * The name of the event.
-         */
-        name: string;
-        /**
-         * Creates a new custom event.
-         * @param name - The name of the event.
-         */
-        constructor(name: string);
-        /**
-        * Adds a parameter to the event with validation.
-        *
-        * @param key - The parameter key (max 50 characters, cannot be "no_parameters").
-        * @param value - The parameter value (max 50 characters).
-        * @throws {WTEventValidationError} When validation fails.
-        *
-        * @example
-        * ```ts
-        * event.addParam("category", "electronics");
-        * event.addParam("item_count", 3);
-        * event.addParam("is_premium", true);
-        * ```
-        */
-        addParam(key: string, value: EventParam): void;
-        /**
-         * Adds multiple parameters at once with validation.
-         *
-         * @param params - Object containing key-value pairs to add.
-         * @throws {WTEventValidationError} When validation fails for any parameter.
-         */
-        addParams(params: Record<string, EventParam>): void;
-        /** @internal */
-        toJSON(): {
-            event_type: WTEventType;
-            event_name: string;
-            partner_params: Record<string, EventParam> | undefined;
-        };
-    }
+    static defaultEvent(name: string, params?: Record<string, EventParam>): WTEvent;
     /**
-     * Represents a revenue event with an amount and currency.
+     * Creates a revenue event for tracking purchases or monetary transactions.
      *
-     * Use this class to log purchases or monetary transactions.
+     * @param name - The name of the revenue event.
+     * @param amount - The amount of revenue.
+     * @param currency - The currency of the revenue.
+     * @param params - Optional custom key-value parameters for the event.
+     * @returns A new WTEvent instance.
      *
      * @example
      * ```ts
-     * const purchase = new WTEvent.Revenue("order_complete", 49.99, RevenueCurrency.USD);
-     * purchase.addParam("item_count", "3");
+     * const purchase = WTEvent.revenueEvent("purchase", 99.99, RevenueCurrency.USD, {
+     *   item_count: 3
+     * });
      * WiseTrack.instance.trackEvent(purchase);
      * ```
      */
-    class Revenue extends Default {
-        /**
-         * The type of event.
-         * @internal
-         */
-        readonly type: WTEventType;
-        /**
-         * The revenue amount.
-         */
-        amount: number;
-        /**
-         * The currency of the revenue.
-         */
-        currency: RevenueCurrency;
-        /**
-         * Creates a new revenue event.
-         *
-         * @param name - The name of the revenue event.
-         * @param amount - The amount of revenue.
-         * @param currency - The currency of the revenue.
-         */
-        constructor(name: string, amount: number, currency: RevenueCurrency);
-        /** @internal */
-        toJSON(): {
-            event_type: WTEventType;
-            event_name: string;
-            revenue: number;
-            currency: RevenueCurrency;
-            partner_params: Record<string, EventParam> | undefined;
-        };
-    }
+    static revenueEvent(name: string, amount: number, currency: RevenueCurrency, params?: Record<string, EventParam>): WTEvent;
+    /**
+     * Validates and sets multiple parameters.
+     * @internal
+     */
+    private validateAndSetParams;
 }
 export {};

package/dist/cjs/utils/logger.d.ts

@@ -1,7 +1,5 @@
 /** @internal */
-export declare abstract class WTLogEngine {
-    abstract log(level: string, prefix: string, ...args: any[]): void;
-}
+export type WTLogEngine = (level: string, prefix: string, args: any[]) => void;
 /**
  * Defines the available log levels for the SDK.
  *

package/dist/esm/constants/constants.d.ts

@@ -4,10 +4,9 @@ import { WTSDKEnvironment } from "./environments";
 export declare const WTConstants: {
     readonly SDK: {
         readonly PLATFORM: "web";
-        readonly VERSION: "2.0.5";
+        readonly VERSION: "2.0.8";
     };
     readonly CONFIG: {
-        readonly BASE_URL: "https://config.wisetrack.io";
         readonly DEFAULT_ENVIRONMENT: WTSDKEnvironment;
     };
     readonly DEFAULTS: {

package/dist/esm/constants/environments.d.ts

@@ -19,7 +19,7 @@ export declare const WTSDKEnvironment: {
 export type WTSDKEnvironment = (typeof WTSDKEnvironment)[keyof typeof WTSDKEnvironment];
 /** @internal */
 export declare const EnvironmentUtils: {
-    sdkEnvironment: WTSDKEnvironment;
+    readonly sdkEnvironment: WTSDKEnvironment;
     readonly needResponseDetails: boolean;
     readonly baseUrl: string;
 };

package/dist/esm/constants/resource-wrapper.d.ts

@@ -0,0 +1,5 @@
+/** @internal */
+export declare class ResourceWrapper {
+    static sdkEnvironment(env: string): void;
+    static sdkVersion(version: string): void;
+}

package/dist/esm/core/fields/event-fields-builder.d.ts

@@ -2,7 +2,7 @@ import { WTEvent } from "../../types/event/wt-event";
 import { FieldsBuilder } from "./fields-builder";
 /** @internal */
 export declare class EventFieldsBuilder extends FieldsBuilder {
-    event: WTEvent.Default | WTEvent.Revenue;
-    constructor(event: WTEvent.Default | WTEvent.Revenue);
+    event: WTEvent;
+    constructor(event: WTEvent);
     build(): Promise<Record<string, any>>;
 }

package/dist/esm/core/storage/storage-manager.d.ts

@@ -1,3 +1,4 @@
+import { WTSDKEnvironment } from "../../constants/environments";
 import { WTInitialConfig } from "../../types/config/initial-config";
 import { WTConfig } from "../../types/config/wt-config";
 import { RequestRecord } from "../caching/queue-data";
@@ -43,6 +44,10 @@ declare class StorageManager {
     set pendingRequestRecords(value: RequestRecord[]);
     get eventCount(): number;
     set eventCount(value: number);
+    get sdkEnvironment(): WTSDKEnvironment | null;
+    set sdkEnvironment(value: string);
+    get sdkVersion(): string;
+    set sdkVersion(value: string);
 }
 /** @internal */
 export declare const storageManager: StorageManager;

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

@@ -100,20 +100,22 @@ export declare class WiseTrack {
      * @example
      * ```ts
      * // Create a Default Event
-     * const defaultEvent = new WTEvent.Default("default-event");
-     * defaultEvent.addParam("key1", "value1");
-     * defaultEvent.addParam("key2", 123);
-     * defaultEvent.addParam("key3", true);
+     * const defaultEvent = new WTEvent.defaultEvent("default-event", {
+     *  key1: "value1",
+     *  key2: 123,
+     *  key3: true
+     * });
      * await WiseTrack.instance.trackEvent(defaultEvent);
      *
      * // Create a Revenue Event
-     * const revenueEvent = new WTEvent.Revenue("revenue-event", 100, "USD");
-     * revenueEvent.addParam("item_id", "item123");
-     * revenueEvent.addParam("quantity", 2);
+     * const revenueEvent = new WTEvent.revenueEvent("revenue-event", 100, "USD", {
+     *  item_id: "item123",
+     *  quantity: 2
+     * });
      * await WiseTrack.instance.trackEvent(revenueEvent);
      * ```
      */
-    trackEvent(event: WTEvent.Default | WTEvent.Revenue): Promise<void>;
+    trackEvent(event: WTEvent): Promise<void>;
     /** @internal */
     private getConfig;
     /** @internal */

package/dist/esm/core/wt-tracker.d.ts

@@ -8,7 +8,7 @@ declare class WTTracker {
     startTracking(): Promise<void>;
     stopTracking(): Promise<void>;
     checkPushToken(token: string): Promise<void>;
-    trackEvent(event: WTEvent.Default | WTEvent.Revenue): Promise<void>;
+    trackEvent(event: WTEvent): Promise<void>;
     private getCountryCode;
     private createAttribution;
     private checkFirstSession;

package/dist/esm/index.d.ts

@@ -1,6 +1,7 @@
+export { WTUserEnvironment } from "./constants/environments";
+export { ResourceWrapper } from "./constants/resource-wrapper";
 export { WiseTrack } from "./core/wisetrack";
 export { WTInitialConfig } from "./types/config/initial-config";
-export { WTEvent, EventParam } from "./types/event/wt-event";
-export { WTLogEngine, WTLogger, WTLogLevel } from "./utils/logger";
-export { WTUserEnvironment } from "./constants/environments";
 export { RevenueCurrency } from "./types/event/revenue-currency";
+export { EventParam, WTEvent } from "./types/event/wt-event";
+export { WTLogger, WTLogLevel } from "./utils/logger";