@mparticle/web-sdk 2.26.2 → 2.26.4

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@mparticle/web-sdk",
-    "version": "2.26.2",
+    "version": "2.26.4",
     "description": "mParticle core SDK for web applications",
     "license": "Apache-2.0",
     "keywords": [

package/src/apiClient.ts

@@ -1,11 +1,12 @@
 import Constants from './constants';
 import Types from './types';
 import { BatchUploader } from './batchUploader';
-import { MParticleUser, MParticleWebSDK, SDKEvent } from './sdkRuntimeModels';
+import { MParticleWebSDK, SDKEvent } from './sdkRuntimeModels';
 import KitBlocker from './kitBlocking';
 import { Dictionary, getRampNumber, isEmpty, parseNumber } from './utils';
 import { IUploadObject } from './serverModel';
 import { MPForwarder } from './forwarders.interfaces';
+import { IMParticleUser } from './identity-user-interfaces';
 
 export type ForwardingStatsData = Dictionary<any>;
 
@@ -13,7 +14,7 @@ export interface IAPIClient {
     uploader: BatchUploader | null;
     queueEventForBatchUpload: (event: SDKEvent) => void;
     processQueuedEvents: () => void;
-    appendUserInfoToEvents: (user: MParticleUser, events: SDKEvent[]) => void;
+    appendUserInfoToEvents: (user: IMParticleUser, events: SDKEvent[]) => void;
     sendEventToServer: (event: SDKEvent, _options?: Dictionary<any>) => void;
     sendSingleEventToServer: (event: SDKEvent) => void;
     sendBatchForwardingStatsToServer: (

package/src/batchUploader.ts

@@ -1,21 +1,17 @@
 import { Batch } from '@mparticle/event-models';
 import Constants from './constants';
-import {
-    SDKEvent,
-    MParticleUser,
-    MParticleWebSDK,
-    SDKLoggerApi,
-} from './sdkRuntimeModels';
+import { SDKEvent, MParticleWebSDK, SDKLoggerApi } from './sdkRuntimeModels';
 import { convertEvents } from './sdkToEventsApiConverter';
 import Types from './types';
 import { getRampNumber, isEmpty } from './utils';
 import { SessionStorageVault, LocalStorageVault } from './vault';
-import { 
+import {
     AsyncUploader,
     FetchUploader,
     XHRUploader,
-    fetchPayload
+    fetchPayload,
 } from './uploaders';
+import { IMParticleUser } from './identity-user-interfaces';
 
 /**
  * BatchUploader contains all the logic to store/retrieve events and batches
@@ -205,7 +201,7 @@ export class BatchUploader {
      */
     private static createNewBatches(
         sdkEvents: SDKEvent[],
-        defaultUser: MParticleUser,
+        defaultUser: IMParticleUser,
         mpInstance: MParticleWebSDK
     ): Batch[] | null {
         if (!defaultUser || !sdkEvents || !sdkEvents.length) {

package/src/consent.ts

@@ -4,10 +4,11 @@ import {
     GDPRConsentState,
     PrivacyConsentState,
 } from '@mparticle/web-sdk';
-import { MParticleUser, MParticleWebSDK } from './sdkRuntimeModels';
+import { MParticleWebSDK } from './sdkRuntimeModels';
 import { Dictionary, isObject } from './utils';
 import KitFilterHelper from './kitFilterHelper';
 import Constants from './constants';
+import { IMParticleUser } from './identity-user-interfaces';
 
 const { CCPAPurpose } = Constants;
 
@@ -108,7 +109,7 @@ export interface IConsentState extends ConsentState {
 export interface IConsent {
     isEnabledForUserConsent: (
         consentRules: IConsentRules,
-        user: MParticleUser
+        user: IMParticleUser
     ) => boolean;
     createPrivacyConsent: ICreatePrivacyConsentFunction;
     createConsentState: (consentState?: ConsentState) => ConsentState;
@@ -123,7 +124,7 @@ export default function Consent(this: IConsent, mpInstance: MParticleWebSDK) {
     // forwarder should be initialized
     this.isEnabledForUserConsent = function(
         consentRules: IConsentRules,
-        user: MParticleUser
+        user: IMParticleUser
     ): boolean {
         if (
             !consentRules ||

package/src/forwarders.interfaces.ts

@@ -1,13 +1,12 @@
-import {
-    MParticleUser,
-    SDKEvent,
-    SDKEventCustomFlags,
-    SDKUserIdentity,
-} from './sdkRuntimeModels';
+import { SDKEvent, SDKEventCustomFlags } from './sdkRuntimeModels';
 import { Dictionary } from './utils';
 import { IKitConfigs } from './configAPIClient';
-import { UserAttributes } from './persistence.interfaces';
 import { IdentityApiData } from '@mparticle/web-sdk';
+import {
+    IMParticleUser,
+    ISDKUserIdentity,
+    UserAttributes,
+} from './identity-user-interfaces';
 
 // TODO: https://go.mparticle.com/work/SQDSDKS-6035
 export type Kit = Dictionary;
@@ -19,7 +18,7 @@ export interface UnregisteredKit {
     register(config): void;
 }
 
-// The state of the kit after being added to forwarderConstructors in the CDN 
+// The state of the kit after being added to forwarderConstructors in the CDN
 // or after registered to SDKConfig.kits via NPM
 export interface RegisteredKit {
     constructor(): void;
@@ -37,47 +36,50 @@ export interface ConfiguredKit
         testMode: boolean,
         trackerId: string | null,
         userAttributes: UserAttributes,
-        userIdentities: SDKUserIdentity,
+        userIdentities: ISDKUserIdentity,
         appVersion: string,
         appName: string,
         customFlags: SDKEventCustomFlags,
         clientId: string
     ): string;
     onIdentifyComplete(
-        user: MParticleUser,
+        user: IMParticleUser,
         filteredIdentityRequest: IdentityApiData
     ): string | KitMappedMethodFailure;
     onLoginComplete(
-        user: MParticleUser,
+        user: IMParticleUser,
         filteredIdentityRequest: IdentityApiData
     ): string | KitMappedMethodFailure;
     onLogoutComplete(
-        user: MParticleUser,
+        user: IMParticleUser,
         filteredIdentityRequest: IdentityApiData
     ): string | KitMappedMethodFailure;
     onModifyComplete(
-        user: MParticleUser,
+        user: IMParticleUser,
         filteredIdentityRequest: IdentityApiData
     ): string | KitMappedMethodFailure;
-    onUserIdentified(user: MParticleUser): string | KitMappedMethodFailure;
+    onUserIdentified(user: IMParticleUser): string | KitMappedMethodFailure;
     process(event: SDKEvent): string;
     setOptOut(isOptingOut: boolean): string | KitMappedMethodFailure;
     removeUserAttribute(key: string): string;
-    setUserAttribute(key: string, value:string): string;
+    setUserAttribute(key: string, value: string): string;
 
     // TODO: Convert type to enum during Identity migration
     // https://go.mparticle.com/work/SQDSDKS-5218
     setUserIdentity(id: UserIdentityId, type: UserIdentityType): void;
 
     // TODO: https://go.mparticle.com/work/SQDSDKS-5156
-    isSandbox: boolean;  
+    isSandbox: boolean;
     hasSandbox: boolean;
 }
 export interface KitMappedMethodFailure {
-    error: string
+    error: string;
 }
 
 export type UserIdentityId = string;
 export type UserIdentityType = number;
 
-export type forwardingStatsCallback = (forwarder: ConfiguredKit, event: SDKEvent) => void;
+export type forwardingStatsCallback = (
+    forwarder: ConfiguredKit,
+    event: SDKEvent
+) => void;

package/src/identity-user-interfaces.ts

@@ -0,0 +1,64 @@
+import {
+    AllUserAttributes,
+    IdentityCallback,
+    Product,
+    User,
+} from '@mparticle/web-sdk';
+import { SDKIdentityTypeEnum } from './identity.interfaces';
+import { MessageType } from './types.interfaces';
+import { BaseEvent } from './sdkRuntimeModels';
+
+// https://go.mparticle.com/work/SQDSDKS-5033
+// https://go.mparticle.com/work/SQDSDKS-6354
+export interface IMParticleUser extends User {
+    getAllUserAttributes(): any;
+    setUserTag(tagName: string, value?: any): void;
+    setUserAttribute(key: string, value: any): void;
+    getUserAudiences?(callback?: IdentityCallback): void;
+}
+
+export interface ISDKUserIdentity {
+    Identity: string;
+    Type: number;
+}
+
+export interface ISDKUserIdentityChanges {
+    New: ISDKUserIdentityChangeData;
+    Old: ISDKUserIdentityChangeData;
+}
+
+export interface ISDKUserIdentityChangeData {
+    IdentityType: SDKIdentityTypeEnum;
+    Identity: string;
+    CreatedThisBatch: boolean;
+    // https://go.mparticle.com/work/SQDSDKS-6438
+    Timestamp?: number;
+}
+
+export interface IUserIdentityChangeEvent extends BaseEvent {
+    messageType: MessageType.UserIdentityChange;
+    userIdentityChanges: ISDKUserIdentityChanges;
+}
+
+export interface ISDKUserAttributeChangeData {
+    UserAttributeName: string;
+    New: string;
+    Old: string;
+    Deleted: boolean;
+    IsNewAttribute: boolean;
+}
+
+export interface IUserAttributeChangeEvent extends BaseEvent {
+    messageType: MessageType.UserAttributeChange;
+    userAttributeChanges: ISDKUserAttributeChangeData;
+}
+
+export interface mParticleUserCart {
+    add(product: Product, logEvent: boolean): void;
+    remove(product: Product, logEvent: boolean): void;
+    clear(): void;
+    getCartProducts(): Product[];
+}
+
+// https://go.mparticle.com/work/SQDSDKS-5196
+export type UserAttributes = AllUserAttributes;

package/src/identity-utils.ts

@@ -3,7 +3,7 @@ import { Dictionary, parseNumber, isObject, generateHash } from './utils';
 import { BaseVault } from './vault';
 import Types from './types';
 import { IdentityApiData, UserIdentities, IdentityCallback } from '@mparticle/web-sdk';
-import { IdentityAPIMethod, MParticleWebSDK } from './sdkRuntimeModels';
+import { IdentityAPIMethod } from './identity.interfaces';
 
 const { Identify, Modify, Login, Logout } = Constants.IdentityMethods;
 

package/src/identity.interfaces.ts

@@ -0,0 +1,205 @@
+import {
+    IdentityApiData,
+    IdentityCallback,
+    MPID,
+    UserIdentities,
+} from '@mparticle/web-sdk';
+import AudienceManager from './audienceManager';
+import { ICachedIdentityCall, IKnownIdentities } from './identity-utils';
+import { BaseVault } from './vault';
+import { Dictionary, Environment, valueof } from './utils';
+import Constants from './constants';
+import {
+    IUserAttributeChangeEvent,
+    IUserIdentityChangeEvent,
+    IMParticleUser,
+    mParticleUserCart,
+} from './identity-user-interfaces';
+const { platform, sdkVendor, sdkVersion, HTTPCodes } = Constants;
+
+export type IdentityPreProcessResult = {
+    valid: boolean;
+    error?: string;
+};
+
+export type IdentityAPIMethod = valueof<typeof Constants.IdentityMethods>;
+
+export enum SDKIdentityTypeEnum {
+    other = 'other',
+    customerId = 'customerid',
+    facebook = 'facebook',
+    twitter = 'twitter',
+    google = 'google',
+    microsoft = 'microsoft',
+    yahoo = 'yahoo',
+    email = 'email',
+    alias = 'alias',
+    facebookCustomAudienceId = 'facebookcustomaudienceid',
+    otherId2 = 'other2',
+    otherId3 = 'other3',
+    otherId4 = 'other4',
+    otherId5 = 'other5',
+    otherId6 = 'other6',
+    otherId7 = 'other7',
+    otherId8 = 'other8',
+    otherId9 = 'other9',
+    otherId10 = 'other10',
+    mobileNumber = 'mobile_number',
+    phoneNumber2 = 'phone_number_2',
+    phoneNumber3 = 'phone_number_3',
+}
+
+export interface IIdentityAPIRequestData {
+    client_sdk: {
+        platform: typeof platform;
+        sdk_vendor: typeof sdkVendor;
+        sdk_version: typeof sdkVersion;
+    };
+    context: string | null;
+    environment: Environment;
+    request_id: string;
+    reqest_timestamp_unixtime_ms: number;
+    previous_mpid: MPID | null;
+    known_identities: IKnownIdentities;
+}
+
+export interface IIdentityAPIModifyRequestData
+    extends Omit<
+        IIdentityAPIRequestData,
+        'known_identities' | 'previous_mpid'
+    > {
+    identity_changes: IIdentityAPIIdentityChangeData[];
+}
+
+export interface IIdentityAPIIdentityChangeData {
+    identity_type: SDKIdentityTypeEnum;
+    old_value: string;
+    new_value: string;
+}
+
+export interface IIdentityRequest {
+    createIdentityRequest(
+        identityApiData: IdentityApiData,
+        platform: string,
+        sdkVendor: string,
+        sdkVersion: string,
+        deviceId: string,
+        context: string | null,
+        mpid: MPID
+    ): IIdentityAPIRequestData;
+    createModifyIdentityRequest(
+        currentUserIdentities: UserIdentities,
+        newUserIdentities: UserIdentities,
+        platform: string,
+        sdkVendor: string,
+        sdkVersion: string,
+        context: string | null
+    ): IIdentityAPIModifyRequestData;
+    createIdentityChanges(
+        previousIdentities: UserIdentities,
+        newIdentitie: UserIdentities
+    ): IIdentityAPIIdentityChangeData;
+    preProcessIdentityRequest(
+        identityApiData: IdentityApiData,
+        callback: IdentityCallback,
+        method: IdentityAPIMethod
+    ): IdentityPreProcessResult;
+}
+
+export interface IAliasRequest {
+    destinationMpid: MPID;
+    sourceMpid: MPID;
+    startTime: number;
+    endTime: number;
+    scope?: string;
+}
+
+export interface SDKIdentityApi {
+    HTTPCodes: typeof HTTPCodes;
+    identify?(
+        identityApiData?: IdentityApiData,
+        callback?: IdentityCallback
+    ): void;
+    login?(
+        identityApiData?: IdentityApiData,
+        callback?: IdentityCallback
+    ): void;
+    logout?(
+        identityApiData?: IdentityApiData,
+        callback?: IdentityCallback
+    ): void;
+    modify?(
+        identityApiData?: IdentityApiData,
+        callback?: IdentityCallback
+    ): void;
+    getCurrentUser?(): IMParticleUser;
+    getUser?(mpid: string): IMParticleUser;
+    getUsers?(): IMParticleUser[];
+    aliasUsers?(
+        aliasRequest?: IAliasRequest,
+        callback?: IdentityCallback
+    ): void;
+    createAliasRequest?(
+        sourceUser: IMParticleUser,
+        destinationUser: IMParticleUser
+    ): IAliasRequest;
+}
+
+export interface IIdentity {
+    audienceManager: AudienceManager;
+    idCache: BaseVault<Dictionary<ICachedIdentityCall>>;
+
+    IdentityAPI: SDKIdentityApi;
+    IdentityRequest: IIdentityRequest;
+
+    mParticleUser(mpid: MPID, IsLoggedIn: boolean): IMParticleUser;
+
+    checkIdentitySwap(
+        previousMPID: MPID,
+        currentMPID: MPID,
+        currentSessionMPIDs?: MPID[]
+    ): void;
+    createUserAttributeChange(
+        key: string,
+        newValue: string,
+        previousUserAttributeValue: string,
+        isNewAttribute: boolean,
+        deleted: boolean,
+        user: IMParticleUser
+    ): IUserAttributeChangeEvent;
+    createUserIdentityChange(
+        identityType: SDKIdentityTypeEnum,
+        newIdentity: string,
+        oldIdentity: string,
+        newCreatedThisBatch: boolean,
+        userInMemory: IMParticleUser
+    ): IUserIdentityChangeEvent;
+    parseIdentityResponse(
+        xhr: XMLHttpRequest,
+        previousMPID: MPID,
+        callback: IdentityCallback,
+        identityApiData: IdentityApiData,
+        method: IdentityAPIMethod,
+        knownIdentities: UserIdentities,
+        parsingCachedResponse: boolean
+    ): void;
+    sendUserAttributeChangeEvent(
+        attributeKey: string,
+        newUserAttributeValue: string,
+        previousUserAttributeValue: string,
+        isNewAttribute: boolean,
+        deleted: boolean,
+        user: IMParticleUser
+    ): void;
+    sendUserIdentityChangeEvent(
+        newUserIdentities: UserIdentities,
+        method: IdentityAPIMethod,
+        mpid: MPID,
+        prevUserIdentities: UserIdentities
+    ): void;
+
+    /**
+     * @deprecated
+     */
+    mParticleUserCart(mpid: MPID): mParticleUserCart;
+}