react-native-insider 7.1.0 → 8.0.0

package/ios/RNInsider/RNInsider.m

@@ -173,11 +173,11 @@ RCT_EXPORT_METHOD(setPhoneNumber:(NSString *)value) {
 RCT_EXPORT_METHOD(handleURL:(NSString *)value) {
     @try {
         NSURL *url = [NSURL URLWithString:value];
-        
+
         if (url == nil) {
             return;
         }
-        
+
         [Insider handleUrl:url];
     } @catch (NSException *e) {
         [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
@@ -421,11 +421,13 @@ RCT_EXPORT_METHOD(itemAddedToCart:(NSDictionary *)requiredFields optionalFields:
     }
 }
 
-RCT_EXPORT_METHOD(itemRemovedFromCart:(NSString *)productID customParameters:(NSArray *)customParameters) {
+RCT_EXPORT_METHOD(itemRemovedFromCart:(NSString *)productID saleID:(NSString *)saleID customParameters:(NSArray *)customParameters) {
     @try {
         NSDictionary<NSString *, id> *mappedCustomParameters = [RNUtils parseCustomParameters:customParameters];
 
-        if (mappedCustomParameters.count > 0) {
+        if (saleID.length > 0) {
+            [Insider itemRemovedFromCartWithProductID:productID saleID:saleID customParameters:mappedCustomParameters];
+        } else if (mappedCustomParameters.count > 0) {
             [Insider itemRemovedFromCartWithProductID:productID customParameters:mappedCustomParameters];
         } else {
             [Insider itemRemovedFromCartWithProductID:productID];
@@ -504,6 +506,38 @@ RCT_EXPORT_METHOD(getMessageCenterData:(NSInteger)limit startDate:(NSString *)st
     }
 }
 
+RCT_EXPORT_METHOD(getMessageCenterDataWithIdentifiers:(NSInteger)limit startDate:(NSString *)startDate endDate:(NSString *)endDate identifiers:(NSDictionary *)identifiers callback:(RCTResponseSenderBlock) callback) {
+    @try {
+        NSTimeInterval startDateEpoch = [startDate doubleValue] / 1000.0;
+        NSTimeInterval endDateEpoch = [endDate doubleValue] / 1000.0;
+        NSDate *start = [NSDate dateWithTimeIntervalSince1970:startDateEpoch];
+        NSDate *end = [NSDate dateWithTimeIntervalSince1970:endDateEpoch];
+
+        InsiderIdentifiers *insiderIdentifiers = [[InsiderIdentifiers alloc] init];
+        for (NSString *key in identifiers.allKeys) {
+            if ([key isEqualToString:ADD_EMAIL]) {
+                insiderIdentifiers.addEmail([identifiers objectForKey:key]);
+            } else if ([key isEqualToString:ADD_PHONE_NUMBER]) {
+                insiderIdentifiers.addPhoneNumber([identifiers objectForKey:key]);
+            } else if ([key isEqualToString:ADD_USER_ID]) {
+                insiderIdentifiers.addUserID([identifiers objectForKey:key]);
+            } else {
+                insiderIdentifiers.addCustomIdentifier(key, [identifiers objectForKey:key]);
+            }
+        }
+
+        [Insider getMessageCenterDataWithLimit:limit
+                                     startDate:start
+                                       endDate:end
+                                   identifiers:insiderIdentifiers
+                                       success:^(NSArray *messageCenterData) {
+            callback(@[messageCenterData ?: @[]]);
+        }];
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+    }
+}
+
 RCT_EXPORT_METHOD(getSmartRecommendation:(int)recommendationID locale:(NSString *)locale currency:(NSString *)currency smartRecommendation:(RCTResponseSenderBlock) smartRecommendation) {
     @try {
         [Insider getSmartRecommendationWithID:recommendationID locale:locale currency:currency smartRecommendation:^(NSDictionary *recommendation) {
@@ -635,7 +669,7 @@ RCT_EXPORT_METHOD(visitProductDetailPage:(NSDictionary *)requiredFields optional
     }
 }
 
-RCT_EXPORT_METHOD(visitCartPage:(NSArray *)products customParameters:(NSArray *)customParameters) {
+RCT_EXPORT_METHOD(visitCartPage:(NSArray *)products saleID:(NSString *)saleID customParameters:(NSArray *)customParameters) {
     @try {
         NSMutableArray<InsiderProduct *> *mappedProducts = [NSMutableArray array];
         for (NSDictionary *productDict in products) {
@@ -648,7 +682,9 @@ RCT_EXPORT_METHOD(visitCartPage:(NSArray *)products customParameters:(NSArray *)
 
         NSDictionary<NSString *, id> *mappedCustomParameters = [RNUtils parseCustomParameters:customParameters];
 
-        if (mappedCustomParameters.count > 0) {
+        if (saleID.length > 0) {
+            [Insider visitCartPageWithProducts:[mappedProducts copy] saleID:saleID customParameters:mappedCustomParameters];
+        } else if (mappedCustomParameters.count > 0) {
             [Insider visitCartPageWithProducts:[mappedProducts copy] customParameters:mappedCustomParameters];
         } else {
             [Insider visitCartPageWithProducts:[mappedProducts copy]];
@@ -839,6 +875,104 @@ RCT_EXPORT_METHOD(enableInAppMessages) {
     }
 }
 
+RCT_EXPORT_METHOD(getAppCardsCampaigns:(RCTResponseSenderBlock)callback) {
+    @try {
+        [[Insider appCards] getCampaigns:^(InsiderAppCardCampaignsResponseModel *campaignResponse, NSError *error) {
+            if (error) {
+                NSDictionary *errorDetails = [RNUtils appCardsErrorToDictionary:error];
+                callback(@[errorDetails]);
+            } else {
+                callback(@[[NSNull null], campaignResponse.toDictionary ?: @{}]);
+            }
+        }];
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+        callback(@[@{@"code": @"unknown", @"message": @"An unexpected error occurred."}]);
+    }
+}
+
+RCT_EXPORT_METHOD(markAppCardsAsRead:(NSArray<NSString *> *)appCardIds callback:(RCTResponseSenderBlock)callback) {
+    @try {
+        [[Insider appCards] markAsRead:[NSSet setWithArray:appCardIds] completion:^(NSError *error) {
+            if (error) {
+                NSDictionary *errorDetails = [RNUtils appCardsErrorToDictionary:error];
+                callback(@[errorDetails]);
+            } else {
+                callback(@[]);
+            }
+        }];
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+        callback(@[@{@"code": @"unknown", @"message": @"An unexpected error occurred."}]);
+    }
+}
+
+RCT_EXPORT_METHOD(markAppCardsAsUnread:(NSArray<NSString *> *)appCardIds callback:(RCTResponseSenderBlock)callback) {
+    @try {
+        [[Insider appCards] markAsUnread:[NSSet setWithArray:appCardIds] completion:^(NSError *error) {
+            if (error) {
+                NSDictionary *errorDetails = [RNUtils appCardsErrorToDictionary:error];
+                callback(@[errorDetails]);
+            } else {
+                callback(@[]);
+            }
+        }];
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+        callback(@[@{@"code": @"unknown", @"message": @"An unexpected error occurred."}]);
+    }
+}
+
+RCT_EXPORT_METHOD(deleteAppCards:(NSArray<NSString *> *)appCardIds callback:(RCTResponseSenderBlock)callback) {
+    @try {
+        [[Insider appCards] deleteAppCards:[NSSet setWithArray:appCardIds] completion:^(NSError *error) {
+            if (error) {
+                NSDictionary *errorDetails = [RNUtils appCardsErrorToDictionary:error];
+                callback(@[errorDetails]);
+            } else {
+                callback(@[]);
+            }
+        }];
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+        callback(@[@{@"code": @"unknown", @"message": @"An unexpected error occurred."}]);
+    }
+}
+
+RCT_EXPORT_METHOD(clickAppCardButton:(NSString *)appCardId data:(NSDictionary *)data) {
+    @try {
+        InsiderAppCardButtonModel *model = [[InsiderAppCardButtonModel alloc] initWithDictionary:data error:nil];
+        if (model) {
+            [model setAppCardId:appCardId];
+            [model click];
+        }
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+    }
+}
+
+RCT_EXPORT_METHOD(viewAppCard:(NSDictionary *)data) {
+    @try {
+        InsiderAppCardModel *model = [[InsiderAppCardModel alloc] initWithDictionary:data error:nil];
+        if (model) {
+            [model view];
+        }
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+    }
+}
+
+RCT_EXPORT_METHOD(clickAppCard:(NSDictionary *)data) {
+    @try {
+        InsiderAppCardModel *model = [[InsiderAppCardModel alloc] initWithDictionary:data error:nil];
+        if (model) {
+            [model click];
+        }
+    } @catch (NSException *e) {
+        [Insider sendError:e desc:[NSString stringWithFormat:@"%s:%d", __func__, __LINE__]];
+    }
+}
+
 -(void)insiderIDChangeListener:(NSString *) insiderID {
     @try {
         if (insiderID == nil) return;

package/ios/RNInsider/RNUtils.h

@@ -25,4 +25,7 @@
 
 + (nonnull NSDictionary<NSString *, id> *)parseCustomParameters:(nonnull NSArray *)customParameters;
 
++ (nonnull NSString *)mapAppCardsErrorCode:(nonnull NSError *)error;
++ (nonnull NSDictionary *)appCardsErrorToDictionary:(nonnull NSError *)error;
+
 @end

package/ios/RNInsider/RNUtils.m

@@ -283,4 +283,24 @@
     return mappedCustomParameters;
 }
 
++ (NSString *)mapAppCardsErrorCode:(NSError *)error {
+    if ([error.domain isEqualToString:InsiderAppCardsErrorDomain]) {
+        switch (error.code) {
+            case InsiderAppCardsErrorCodeSdkNotInitialized: return @"sdkNotInitialized";
+            case InsiderAppCardsErrorCodeInvalidParameter: return @"invalidParameter";
+            case InsiderAppCardsErrorCodeNetworkError: return @"networkError";
+            case InsiderAppCardsErrorCodeServerError: return @"serverError";
+            case InsiderAppCardsErrorCodeParseError: return @"parseError";
+            default: return @"unknown";
+        }
+    }
+    return @"unknown";
+}
+
++ (NSDictionary *)appCardsErrorToDictionary:(NSError *)error {
+    NSString *code = [self mapAppCardsErrorCode:error];
+    NSString *message = error.localizedDescription ?: @"An unexpected error occurred.";
+    return @{@"code": code, @"message": message};
+}
+
 @end

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "react-native-insider",
-    "version": "7.1.0",
+    "version": "8.0.0",
     "description": "React Native Insider SDK",
     "main": "index.js",
     "types": "index.d.ts",
@@ -35,4 +35,4 @@
             "<rootDir>/lib/"
         ]
     }
-}
+}

package/src/InsiderAppCard.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Represents the textual content of an app card.
+ *
+ * This model contains the title and description text that is displayed in the app card.
+ */
+export class InsiderAppCardContent {
+	/** Main title text of the app card. */
+	readonly title: string;
+
+	/** Description text of the app card. */
+	readonly description: string;
+}
+
+/**
+ * Represents an image associated with an app card.
+ *
+ * This model contains the image URL to be displayed in the app card.
+ */
+export class InsiderAppCardImage {
+	/** URL of the image to be displayed. */
+	readonly url: string;
+}
+
+/**
+ * Represents an action button within an app card.
+ *
+ * This model defines a button that can be displayed in an app card, containing text and an
+ * associated action that is executed when the button is tapped.
+ */
+export class InsiderAppCardButton {
+	/** Unique identifier for the button. */
+	readonly buttonId: string;
+
+	/** Identifier of the app card this button belongs to. */
+	readonly appCardId: string;
+
+	/** Display text shown on the button. */
+	readonly text: string;
+
+	/** Action to be executed when the button is tapped. */
+	readonly action?: InsiderAppCardAction;
+
+	/** Handles the button click action. */
+	click(): void;
+}
+
+/**
+ * Action type values for app card actions.
+ *
+ * - `"deep_link"`: deeplink navigation
+ * - `"open_settings"`: open system app settings
+ * - `"feedback"`: feedback action
+ */
+export type InsiderAppCardActionType = "deep_link" | "open_settings" | "feedback"
+
+/**
+ * Defines the interface for app card actions.
+ *
+ * Conforming types represent different actions that can be executed when a user interacts
+ * with an app card or button, such as opening a deeplink or navigating to app settings.
+ */
+export class InsiderAppCardAction {
+	/** Type of the action (deeplink, open settings, or feedback). */
+	readonly type: InsiderAppCardActionType;
+}
+
+/**
+ * Deeplink type values.
+ *
+ * - `"external"`: external URL
+ * - `"internal"`: internal app navigation
+ * - `"url_scheme"`: URL scheme
+ * - `"unknown"`: unknown type
+ */
+export type InsiderAppCardDeeplinkType = "external" | "internal" | "url_scheme" | "unknown"
+
+/**
+ * Represents a deeplink action that navigates to a specific location in the app or external URL.
+ *
+ * This action model contains the data needed to construct and execute a deeplink navigation,
+ * including key-value pairs that define the deeplink parameters.
+ */
+export class InsiderAppCardDeeplinkAction extends InsiderAppCardAction {
+	/** Key-value data containing deeplink related parameters. */
+	readonly keysAndValues: { key: string; value: string }[];
+
+	/** The deeplink type. */
+	readonly deeplinkType: InsiderAppCardDeeplinkType;
+
+	/** The deeplink URL. */
+	readonly url: string | null;
+
+	/** The parsed JSON data, or null if not available. */
+	readonly json: any | null;
+}
+
+/**
+ * Represents an action that opens the app's settings.
+ */
+export class InsiderAppCardOpenSettingsAction extends InsiderAppCardAction {
+}
+
+/**
+ * Represents a feedback action.
+ */
+export class InsiderAppCardFeedbackAction extends InsiderAppCardAction {
+}
+
+/**
+ * App card type values.
+ *
+ * - `"message"`: text-based app card
+ * - `"image"`: image-based app card
+ */
+export type InsiderAppCardType = "message" | "image"
+
+/**
+ * Represents a single app card.
+ *
+ * This model contains all the data for an app card, including its content,
+ * images, buttons, and associated actions. App cards can be either text-based or image-based.
+ */
+export class InsiderAppCard {
+	/** Unique identifier for the app card. */
+	readonly appCardId: string;
+
+	/** Type of the app card (text or image). */
+	readonly type: InsiderAppCardType;
+
+	/** Flag indicating whether the app card has been read by the user. */
+	readonly isRead: boolean;
+
+	/** Array of images associated with the app card. */
+	readonly images?: InsiderAppCardImage[];
+
+	/** Content model containing the title and description of the app card. */
+	readonly content?: InsiderAppCardContent;
+
+	/** Array of action buttons that can be displayed with the app card. */
+	readonly buttons?: InsiderAppCardButton[];
+
+	/**
+	 * Action to be executed when the app card is tapped.
+	 */
+	readonly action?: InsiderAppCardAction;
+
+
+	/** Marks the app card as read. */
+	markAsRead(completion: (error?: Error) => void): void;
+
+	/** Marks the app card as read and returns a promise. */
+	markAsRead(): Promise<void>;
+
+	/** Marks the app card as unread. */
+	markAsUnread(completion: (error?: Error) => void): void;
+
+	/** Marks the app card as unread and returns a promise. */
+	markAsUnread(): Promise<void>;
+
+	/** Deletes the app card. */
+	delete(completion: (error?: Error) => void): void;
+
+	/** Deletes the app card and returns a promise. */
+	delete(): Promise<void>;
+
+	/** Views the app card. */
+	view(): void;
+
+	/** Handles the app card click action. */
+	click(): void;
+}
+
+/**
+ * Represents the campaign response containing all app cards.
+ *
+ * This model is the root container for app cards data, holding an array of app card models
+ * that can be displayed in the app cards UI.
+ */
+export class InsiderAppCardsCampaignResponse {
+	/**
+	 * Array of app cards.
+	 *
+	 * Contains all app cards retrieved from the campaigns, including both read and unread app cards.
+	 */
+	readonly appCards: InsiderAppCard[];
+}