@snowplow/react-native-tracker 0.2.0 → 1.1.0

package/dist/index.d.ts

@@ -3,62 +3,280 @@
  */
 declare type HttpMethod = 'post' | 'get';
 /**
- * HttpProtocol type
+ * DevicePlatform type
  */
-declare type HttpProtocol = 'https' | 'http';
+declare type DevicePlatform = 'web' | 'mob' | 'pc' | 'srv' | 'app' | 'tv' | 'cnsl' | 'iot';
 /**
- * The Subject Data
+ * LogLevel type
  */
-declare type SubjectData = {
+declare type LogLevel = 'off' | 'error' | 'debug' | 'verbose';
+/**
+ * BasisForProsessing
+ */
+declare type Basis = 'consent' | 'contract' | 'legal_obligation' | 'legitimate_interests' | 'public_task' | 'vital_interests';
+/**
+ * BufferOption
+ */
+declare type BufferOption = 'single' | 'default' | 'large';
+/**
+ * Trigger for MessageNotification event
+ */
+declare type Trigger = 'push' | 'location' | 'calendar' | 'timeInterval' | 'other';
+/**
+ * ScreenSize
+ */
+declare type ScreenSize = [number, number];
+/**
+ * SelfDescribing type
+ */
+declare type SelfDescribing = {
     /**
-     * user id
+     * Schema
      */
-    userId?: string;
+    schema: string;
     /**
-     * screen width (integer)
+     * Data
      */
-    screenWidth?: number;
+    data: Record<string, unknown>;
+};
+/**
+ * EventContext type
+ */
+declare type EventContext = SelfDescribing;
+/**
+ * NetworkConfiguration
+ */
+interface NetworkConfiguration {
     /**
-     * screen height (integer)
+     * The collector endpoint
+     *  - if the protocol is not included it defaults to https
      */
-    screenHeight?: number;
+    endpoint: string;
     /**
-     * color depth (integer)
+     * The Http Method to use when sending events to the collector
+     * @defaultValue 'post'
+     */
+    method?: HttpMethod;
+}
+/**
+ * TrackerConfiguration
+ */
+interface TrackerConfiguration {
+    /**
+     * Identifier of the app.
      */
-    colorDepth?: number;
+    appId?: string;
     /**
-     * timezone
+     * The device platform the tracker runs on.
+     * @defaultValue 'mob'
      */
-    timezone?: string;
+    devicePlatform?: DevicePlatform;
     /**
-     * language
+     * Whether payload JSON data should be base64 encoded.
+     * @defaultValue true
      */
-    language?: string;
+    base64Encoding?: boolean;
     /**
-     * IP address
+     * The log level of tracker logs.
+     * @defaultValue 'off'
+     */
+    logLevel?: LogLevel;
+    /**
+     * Whether application context is attached to tracked events.
+     * @defaultValue true
+     */
+    applicationContext?: boolean;
+    /**
+     * Whether platform context is attached to tracked events.
+     * @defaultValue true
+     */
+    platformContext?: boolean;
+    /**
+     * Whether geo-location context is attached to tracked events.
+     * @defaultValue false
+     */
+    geoLocationContext?: boolean;
+    /**
+     * Whether session context is attached to tracked events.
+     * @defaultValue true
+     */
+    sessionContext?: boolean;
+    /**
+     * Whether to attach a Deep Link entity to the first ScreenView tracked in the tracker after DeepLinkReceived event.
+     * @defaultValue true
+     */
+    deepLinkContext?: boolean;
+    /**
+     * Whether screen context is attached to tracked events.
+     * @defaultValue true
+     */
+    screenContext?: boolean;
+    /**
+     * Whether enable automatic tracking of ScreenView events.
+     * @defaultValue true
+     */
+    screenViewAutotracking?: boolean;
+    /**
+     * Whether enable automatic tracking of background and foreground transitions.
+     * @defaultValue false
+     */
+    lifecycleAutotracking?: boolean;
+    /**
+     * Whether enable automatic tracking of install event.
+     * @defaultValue true
+     */
+    installAutotracking?: boolean;
+    /**
+     * Whether enable crash reporting.
+     * @defaultValue true
+     */
+    exceptionAutotracking?: boolean;
+    /**
+     * Whether enable diagnostic reporting.
+     * @defaultValue false
+     */
+    diagnosticAutotracking?: boolean;
+}
+/**
+ * SessionConfiguration
+ */
+interface SessionConfiguration {
+    /**
+     * The amount of time in seconds before the session id is updated while the app is in the foreground
+     * @defaultValue 1800
+     */
+    foregroundTimeout: number;
+    /**
+     * The amount of time in seconds before the session id is updated while the app is in the background
+     * @defaultValue 1800
+     */
+    backgroundTimeout: number;
+}
+/**
+ * EmitterConfiguration
+ */
+interface EmitterConfiguration {
+    /**
+     * The buffer option for post requests.
+     * @defaultValue 'single'
+     */
+    bufferOption?: BufferOption;
+    /**
+     * Maximum number of events collected from the EventStore to be sent in a request.
+     * @defaultValue 150
+     */
+    emitRange?: number;
+    /**
+     *Maximum number of threads working in parallel in the tracker to send requests.
+     * @defaultValue 15
+     */
+    threadPoolSize?: number;
+    /**
+     * Maximum amount of bytes allowed to be sent in a payload in a POST request.
+     * @defaultValue 40000
+     */
+    byteLimitPost?: number;
+    /**
+     * Maximum amount of bytes allowed to be sent in a payload in a GET request.
+     * @defaultValue 40000
      */
-    ipAddress?: string;
+    byteLimitGet?: number;
+}
+/**
+ * SubjectConfiguration
+ */
+interface SubjectConfiguration {
+    [index: string]: unknown;
     /**
-     * user agent
+     * user id
      */
-    useragent?: string;
+    userId?: string | null;
     /**
      * network user id (UUIDv4)
      */
-    networkUserId?: string;
+    networkUserId?: string | null;
     /**
      * domain user id
      */
-    domainUserId?: string;
+    domainUserId?: string | null;
     /**
-     * viewport width (integer)
+     * The custom user-agent. It overrides the user-agent used by default.
      */
-    viewportWidth?: number;
+    useragent?: string | null;
     /**
-     * viewport height (integer)
+     * IP address
      */
-    viewportHeight?: number;
-};
+    ipAddress?: string | null;
+    /**
+     * The timezone label
+     */
+    timezone?: string | null;
+    /**
+     * The language set in the device
+     */
+    language?: string | null;
+    /**
+     * The screen resolution
+     */
+    screenResolution?: ScreenSize | null;
+    /**
+     * The screen viewport size
+     */
+    screenViewport?: ScreenSize | null;
+    /**
+     * color depth (integer)
+     */
+    colorDepth?: number | null;
+}
+/**
+ * GdprConfiguration
+ */
+interface GdprConfiguration {
+    /**
+     * Basis for processing
+     */
+    basisForProcessing: Basis;
+    /**
+     * ID of a GDPR basis document.
+     */
+    documentId: string;
+    /**
+     * Version of the document.
+     */
+    documentVersion: string;
+    /**
+     * Description of the document.
+     */
+    documentDescription: string;
+}
+/**
+ * Global Context
+ */
+interface GlobalContext {
+    /**
+     * tag
+     */
+    tag: string;
+    /**
+     * contexts
+     */
+    globalContexts: SelfDescribing[];
+}
+/**
+ * Global Contexts configuration
+ */
+declare type GCConfiguration = GlobalContext[];
+/**
+ * The TrackerControllerConfiguration
+ */
+interface TrackerControllerConfiguration {
+    trackerConfig?: TrackerConfiguration;
+    sessionConfig?: SessionConfiguration;
+    emitterConfig?: EmitterConfiguration;
+    subjectConfig?: SubjectConfiguration;
+    gdprConfig?: GdprConfiguration;
+    gcConfig?: GCConfiguration;
+}
 /**
  * ScreenView event properties
  * schema: iglu:com.snowplowanalytics.mobile/screen_view/jsonschema/1-0-0
@@ -67,28 +285,31 @@ declare type ScreenViewProps = {
     /**
      * The name of the screen viewed
      */
-    screenName: string;
+    name: string;
+    /**
+     * The id(UUID) of screen that was viewed
+     */
+    id?: string;
     /**
      * The type of screen that was viewed
      */
-    screenType?: string;
+    type?: string;
     /**
-     * The type of transition that led to the screen being viewed
+     * The name of the previous screen that was viewed
      */
-    transitionType?: string;
-};
-/**
- * SelfDescribing event properties
- */
-declare type SelfDescribingProps = {
+    previousName?: string;
+    /**
+    * The id(UUID) of the previous screen that was viewed
+    */
+    previousId?: string;
     /**
-     * The schema of the event
+     * The type of the previous screen that was viewed
      */
-    schema: string;
+    previousType?: string;
     /**
-     * The event data
+     * The type of transition that led to the screen being viewed
      */
-    data: Record<string, unknown>;
+    transitionType?: string;
 };
 /**
  * Structured event properties
@@ -130,139 +351,403 @@ declare type PageViewProps = {
     /**
      * The referrer URL
      */
-    pageReferrer?: string;
+    referrer?: string;
 };
 /**
- * Context type
+ * Timing event properties
  */
-declare type EventContext = {
+declare type TimingProps = {
     /**
-     * The context schema
+     * The timing category
      */
-    schema: string;
+    category: string;
     /**
-     * The context data
+     * The timing variable
      */
-    data: Record<string, unknown>;
+    variable: string;
+    /**
+     * The time
+     */
+    timing: number;
+    /**
+     * The timing label
+     */
+    label?: string;
+};
+/**
+ * ConsentDocument properties
+ */
+interface ConsentDocument {
+    /**
+     * The consent document id
+     */
+    documentId: string;
+    /**
+     * The consent document version
+     */
+    version: string;
+    /**
+     * The consent document name
+     */
+    name?: string;
+    /**
+     * The consent document description
+     */
+    documentDescription?: string;
+}
+/**
+ * ConsentGranted event properties
+ */
+interface ConsentGrantedProps extends ConsentDocument {
+    /**
+     * The expiry (date-time string, e.g.: '2022-01-01T00:00:00Z')
+     */
+    expiry: string;
+}
+/**
+ * ConsentWithdrawn event properties
+ */
+interface ConsentWithdrawnProps extends ConsentDocument {
+    /**
+     * Whether user opts out of all data collection
+     */
+    all: boolean;
+}
+/**
+ * EcommerceItem
+ */
+declare type EcommerceItem = {
+    sku: string;
+    price: number;
+    quantity: number;
+    name?: string;
+    category?: string;
+    currency?: string;
+};
+/**
+ * EcommerceTransaction event properties
+ */
+declare type EcommerceTransactionProps = {
+    orderId: string;
+    totalValue: number;
+    items: EcommerceItem[];
+    affiliation?: string;
+    taxValue?: number;
+    shipping?: number;
+    city?: string;
+    state?: string;
+    country?: string;
+    currency?: string;
+};
+/**
+ * DeepLinkReceived event properties
+ * schema: iglu:com.snowplowanalytics.mobile/deep_link_received/jsonschema/1-0-0
+ */
+declare type DeepLinkReceivedProps = {
+    /**
+     * URL in the received deep-link.
+     */
+    url: string;
+    /**
+     * Referrer URL, source of this deep-link.
+     */
+    referrer?: string;
+};
+/**
+ * Attachment object that identify an attachment in the MessageNotification.
+ */
+declare type MessageNotificationAttachmentProps = {
+    identifier: string;
+    type: string;
+    url: string;
+};
+/**
+ * MessageNotification event properties
+ * schema: iglu:com.snowplowanalytics.mobile/message_notification/jsonschema/1-0-0
+ */
+declare type MessageNotificationProps = {
+    /**
+     * The action associated with the notification.
+     */
+    action?: string;
+    attachments?: MessageNotificationAttachmentProps[];
+    /**
+     * The notification's body.
+     */
+    body: string;
+    bodyLocArgs?: string[];
+    /**
+     * The key to the body string in the app's string resources to use to localize the body text to the user's current localization.
+     */
+    bodyLocKey?: string;
+    /**
+     * The category associated to the notification.
+     */
+    category?: string;
+    /**
+     * The application is notified of the delivery of the notification if it's in the foreground or background, the app will be woken up (iOS only).
+     */
+    contentAvailable?: boolean;
+    /**
+     * The group which this notification is part of.
+     */
+    group?: string;
+    /**
+     * The icon associated to the notification (Android only).
+     */
+    icon?: string;
+    /**
+     * The number of items this notification represent.
+     */
+    notificationCount?: number;
+    /**
+     * The time when the event of the notification occurred.
+     */
+    notificationTimestamp?: string;
+    /**
+     * The sound played when the device receives the notification.
+     */
+    sound?: string;
+    /**
+     * The notification's subtitle. (iOS only)
+     */
+    subtitle?: string;
+    /**
+     * An identifier similar to 'group' but usable for different purposes (Android only).
+     */
+    tag?: string;
+    /**
+     * An identifier similar to 'group' but usable for different purposes (iOS only).
+     */
+    threadIdentifier?: string;
+    /**
+     * The notification's title.
+     */
+    title: string;
+    /**
+     * Variable string values to be used in place of the format specifiers in titleLocArgs to use to localize the title text to the user's current localization.
+     */
+    titleLocArgs?: string[];
+    /**
+     * The key to the title string in the app's string resources to use to localize the title text to the user's current localization.
+     */
+    titleLocKey?: string;
+    /**
+     * The trigger that raised the notification message. Must be one of: push, location, calendar, timeInterval, other
+     */
+    trigger: Trigger;
 };
 /**
  * The ReactNativeTracker type
  */
 declare type ReactNativeTracker = {
     /**
-     * Sets or updates subject data
+     * Tracks a self-descibing event
      *
-     * @param argmap - The subject data to be set or updated
+     * @param argmap - The self-describing event properties
+     * @param contexts - The array of event contexts
      */
-    readonly setSubjectData: (argmap: SubjectData) => Promise<void>;
+    readonly trackSelfDescribingEvent: (argmap: SelfDescribing, contexts?: EventContext[]) => Promise<void>;
     /**
      * Tracks a screen-view event
      *
      * @param argmap - The screen-view event's properties
-     * @param ctxt - The array of event contexts
+     * @param contexts - The array of event contexts
      */
-    readonly trackScreenViewEvent: (argmap: ScreenViewProps, ctxt?: EventContext[]) => Promise<void>;
-    /**
-     * Tracks a self-descibing event
-     *
-     * @param argmap - The self-describing event properties
-     * @param ctxt - The array of event contexts
-     */
-    readonly trackSelfDescribingEvent: (argmap: SelfDescribingProps, ctxt: EventContext[]) => Promise<void>;
+    readonly trackScreenViewEvent: (argmap: ScreenViewProps, contexts?: EventContext[]) => Promise<void>;
     /**
      * Tracks a structured event
      *
      * @param argmap - The structured event properties
-     * @param ctxt - The array of event contexts
+     * @param contexts - The array of event contexts
      */
-    readonly trackStructuredEvent: (argmap: StructuredProps, ctxt: EventContext[]) => Promise<void>;
+    readonly trackStructuredEvent: (argmap: StructuredProps, contexts?: EventContext[]) => Promise<void>;
     /**
      * Tracks a page-view event
      *
      * @param argmap - The page-view event properties
-     * @param ctxt - The array of event contexts
+     * @param contexts - The array of event contexts
      */
-    readonly trackPageViewEvent: (argmap: PageViewProps, ctxt: EventContext[]) => Promise<void>;
-};
-/**
- * The optional configuration parameters of the tracker
- */
-interface OptTrackerConfig {
+    readonly trackPageViewEvent: (argmap: PageViewProps, contexts?: EventContext[]) => Promise<void>;
     /**
-     * The HTTP method used
-     * @defaultValue 'post'
+     * Tracks a timing event
+     *
+     * @param argmap - The timing event properties
+     * @param contexts - The array of event contexts
      */
-    method?: HttpMethod;
+    readonly trackTimingEvent: (argmap: TimingProps, contexts?: EventContext[]) => Promise<void>;
     /**
-     * The HTTP protocol used
-     * @defaultValue 'https'
+     * Tracks a consent-granted event
+     *
+     * @param argmap - The consent-granted event properties
+     * @param contexts - The array of event contexts
      */
-    protocol?: HttpProtocol;
+    readonly trackConsentGrantedEvent: (argmap: ConsentGrantedProps, contexts?: EventContext[]) => Promise<void>;
     /**
-     * Should event properties be base64 encoded where supported
-     * @defaultValue true
+     * Tracks a consent-withdrawn event
+     *
+     * @param argmap - The consent-withdrawn event properties
+     * @param contexts - The array of event contexts
      */
-    base64Encoded?: boolean;
+    readonly trackConsentWithdrawnEvent: (argmap: ConsentWithdrawnProps, contexts?: EventContext[]) => Promise<void>;
     /**
-     * Whether platform context are sent with all events
-     * @defaultValue true
+     * Tracks an ecommerce-transaction event
+     *
+     * @param argmap - The ecommerce-transaction event properties
+     * @param contexts - The array of event contexts
      */
-    platformContext?: boolean;
+    readonly trackEcommerceTransactionEvent: (argmap: EcommerceTransactionProps, contexts?: EventContext[]) => Promise<void>;
     /**
-     * Whether application context are sent with all events
-     * @defaultValue false
+     * Tracks a deep link received event
+     *
+     * @param argmap - The deep link received event properties
+     * @param contexts - The array of event contexts
      */
-    applicationContext?: boolean;
+    readonly trackDeepLinkReceivedEvent: (argmap: DeepLinkReceivedProps, contexts?: EventContext[]) => Promise<void>;
     /**
-     * Whether to automatically track transition from foreground to background
-     * @defaultValue false
+     * Tracks a message notification event
+     *
+     * @param argmap - The message notification event properties
+     * @param contexts - The array of event contexts
      */
-    lifecycleEvents?: boolean;
+    readonly trackMessageNotificationEvent: (argmap: MessageNotificationProps, contexts?: EventContext[]) => Promise<void>;
     /**
-     * Whether to send a screen context (info for current screen) to events
-     * @defaultValue true
+     * Removes global contexts
+     *
+     * @param tag - The tag of the global contexts to remove
      */
-    screenContext?: boolean;
+    readonly removeGlobalContexts: (tag: string) => Promise<void>;
     /**
-     * whether to add a session context to events
-     * @defaultValue true
+     * Adds global contexts
+     *
+     * @param gc - The global context to add
      */
-    sessionContext?: boolean;
+    readonly addGlobalContexts: (gc: GlobalContext) => Promise<void>;
     /**
-     * The session foreground timeout
-     * @defaultValue 600
+     * Sets the userId of the tracker subject
+     *
+     * @param newUid - The new userId
      */
-    foregroundTimeout?: number;
+    readonly setUserId: (newUid: string | null) => Promise<void>;
     /**
-     * The session background timeout
-     * @defaultValue 300
+     * Sets the networkUserId of the tracker subject
+     *
+     * @param newNuid - The new networkUserId
      */
-    backgroundTimeout?: number;
+    readonly setNetworkUserId: (newNuid: string | null) => Promise<void>;
     /**
-     * The session check interval
-     * @defaultValue 15
+     * Sets the domainUserId of the tracker subject
+     *
+     * @param newDuid - The new domainUserId
      */
-    checkInterval?: number;
+    readonly setDomainUserId: (newDuid: string | null) => Promise<void>;
     /**
-     * Whether install events will be tracked
-     * @defaultValue false
+     * Sets the ipAddress of the tracker subject
+     *
+     * @param newIp - The new ipAddress
      */
-    installTracking?: boolean;
-}
-/**
- * The configuration used for creating the tracker
- */
-interface TrackerConfig extends OptTrackerConfig {
+    readonly setIpAddress: (newIp: string | null) => Promise<void>;
     /**
-     * The collector endpoint
+     * Sets the useragent of the tracker subject
+     *
+     * @param newUagent - The new useragent
      */
-    endpoint: string;
+    readonly setUseragent: (newUagent: string | null) => Promise<void>;
     /**
-     * The app ID
+     * Sets the timezone of the tracker subject
+     *
+     * @param newTz - The new timezone
      */
-    appId: string;
-}
+    readonly setTimezone: (newTz: string | null) => Promise<void>;
+    /**
+     * Sets the language of the tracker subject
+     *
+     * @param newLang - The new language
+     */
+    readonly setLanguage: (newLang: string | null) => Promise<void>;
+    /**
+     * Sets the screenResolution of the tracker subject
+     *
+     * @param newRes - The new screenResolution
+     */
+    readonly setScreenResolution: (newRes: ScreenSize | null) => Promise<void>;
+    /**
+     * Sets the screenViewport of the tracker subject
+     *
+     * @param newView - The new screenViewport
+     */
+    readonly setScreenViewport: (newView: ScreenSize | null) => Promise<void>;
+    /**
+     * Sets the colorDepth of the tracker subject
+     *
+     * @param newColorD - The new colorDepth
+     */
+    readonly setColorDepth: (newLang: number | null) => Promise<void>;
+    /**
+     * Sets subject data
+     *
+     * @param config - The new subject data
+     */
+    readonly setSubjectData: (config: SubjectConfiguration) => Promise<void>;
+    /**
+     * Gets the dentifier for the user of the session
+     *
+     * @returns {Promise<string | undefined>}
+     */
+    readonly getSessionUserId: () => Promise<string | undefined>;
+    /**
+     * Gets the identifier for the session
+     *
+     * @returns {Promise<string | undefined>}
+     */
+    readonly getSessionId: () => Promise<string | undefined>;
+    /**
+     * Gets the index of the current session for this user
+     *
+     * @returns {Promise<number | undefined>}
+     */
+    readonly getSessionIndex: () => Promise<number | undefined>;
+    /**
+     * Gets whether the app is currently in background state
+     *
+     * @returns {Promise<boolean | undefined>}
+     */
+    readonly getIsInBackground: () => Promise<boolean | undefined>;
+    /**
+     * Gets the number of background transitions in the current session
+     *
+     * @returns {Promise<number | undefined>}
+     */
+    readonly getBackgroundIndex: () => Promise<number | undefined>;
+    /**
+     * Gets the number of foreground transitions in the current session.
+     *
+     * @returns {Promise<number | undefined>}
+     */
+    readonly getForegroundIndex: () => Promise<number | undefined>;
+};
 
-declare function createTracker(namespace: string, config: TrackerConfig): ReactNativeTracker;
+/**
+ * Creates a React Native Tracker object
+ *
+ * @param namespace {string} - The tracker namespace
+ * @param networkConfig {Object} - The network configuration
+ * @param control {Array} - The tracker controller configuration
+ * @returns The tracker object
+ */
+declare function createTracker(namespace: string, networkConfig: NetworkConfiguration, controllerConfig?: TrackerControllerConfiguration): ReactNativeTracker;
+/**
+ * Removes a tracker given its namespace
+ *
+ * @param trackerNamespace {string}
+ * @returns - A boolean promise
+ */
+declare function removeTracker(trackerNamespace: string): Promise<boolean>;
+/**
+ * Removes all trackers
+ *
+ * @returns - A boolean promise
+ */
+declare function removeAllTrackers(): Promise<boolean>;
 
-export { EventContext, HttpMethod, HttpProtocol, PageViewProps, ReactNativeTracker, ScreenViewProps, SelfDescribingProps, StructuredProps, SubjectData, TrackerConfig, createTracker };
+export { Basis, BufferOption, ConsentDocument, ConsentGrantedProps, ConsentWithdrawnProps, DeepLinkReceivedProps, DevicePlatform, EcommerceItem, EcommerceTransactionProps, EmitterConfiguration, EventContext, GCConfiguration, GdprConfiguration, GlobalContext, HttpMethod, LogLevel, MessageNotificationProps, NetworkConfiguration, PageViewProps, ReactNativeTracker, ScreenSize, ScreenViewProps, SelfDescribing, SessionConfiguration, StructuredProps, SubjectConfiguration, TimingProps, TrackerConfiguration, TrackerControllerConfiguration, Trigger, createTracker, removeAllTrackers, removeTracker };