@trycourier/courier 3.6.0 → 3.9.0

package/CHANGELOG.md

@@ -5,9 +5,22 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased][unreleased]
 
+## [3.9.0] - 2022-03-17
+
+- adds support for bulk messaging API v2 support
+
+## [3.8.0] - 2022-03-14
+
+- adds additional types for utm property (`message.metadata.utm`)
+
+## [v3.7.0] - 2022-03-11
+
+- adds additional types for the tags property (`message.metadata.tags`)
+- adds support for searching message by tags
+
 ## [v3.6.0] - 2022-02-10
 
-- adds additional type's for the recipient property (`message.to`)
+- adds additional types for the recipient property (`message.to`)
 
 ## [v3.5.0] - 2022-02-10
 
@@ -205,7 +218,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## v1.0.1 - 2019-07-12
 
-[unreleased]: https://github.com/trycourier/courier-node/compare/v3.5.0...HEAD
+[unreleased]: https://github.com/trycourier/courier-node/compare/v3.9.0...HEAD
+[v3.9.0]: https://github.com/trycourier/courier-node/compare/v3.8.0...v3.9.0
+[v3.8.0]: https://github.com/trycourier/courier-node/compare/v3.7.0...v3.8.0
+[v3.7.0]: https://github.com/trycourier/courier-node/compare/v3.6.0...v3.7.0
+[v3.6.0]: https://github.com/trycourier/courier-node/compare/v3.5.0...v3.6.0
 [v3.5.0]: https://github.com/trycourier/courier-node/compare/v3.4.0...v3.5.0
 [v3.4.0]: https://github.com/trycourier/courier-node/compare/v3.3.0...v3.4.0
 [v3.3.0]: https://github.com/trycourier/courier-node/compare/v3.2.1...v3.3.0

package/README.md

@@ -497,7 +497,7 @@ async function run() {
   await courier.notifications.cancelSubmission("notification1", "submission1");
 
   // Bulk Processing
-  // Example: create a job
+  // Example: create a job (API v1 semantics)
   const response = await courier.bulk.createJob({
     message: {
       event: "RR4NDQ7NZ24A8TKPWVBEDGE15E9A",
@@ -505,13 +505,23 @@ async function run() {
   });
   console.log(response);
 
+  // Example: create a job (API v2 semantics)
+  const response = await courier.bulk.createJob({
+    message: {
+      message: {
+        template: "RR4NDQ7NZ24A8TKPWVBEDGE15E9A",
+      },
+    },
+  });
+  console.log(response);
+
   // Example: get a job
   const response = await courier.bulk.getJob({
     jobId: "1-61efe386-6ff57552409e311b7a1f371f",
   });
   console.log(response);
 
-  // Example: Ingest users in a job
+  // Example: Ingest users in a job (API v1 semantics)
   const response = await courier.bulk.ingestUsers({
     jobId: "1-61efe386-6ff57552409e311b7a1f371f",
     users: [
@@ -524,6 +534,19 @@ async function run() {
   });
   console.log(response);
 
+  // Example: Ingest users in a job (API v2 semantics)
+  const response = await courier.bulk.ingestUsers({
+    jobId: "1-61efe386-6ff57552409e311b7a1f371f",
+    users: [
+      {
+        to: {
+          email: "tejas@courier.com",
+        },
+      },
+    ],
+  });
+  console.log(response);
+
   // Example: Run a job
   await courier.bulk.runJob({
     jobId: "1-61efe386-6ff57552409e311b7a1f371f",

package/lib/bulk/types.d.ts

@@ -1,11 +1,17 @@
 import { IRecipientPreferences } from "../preferences/types";
-export interface IInboundBulkMessage {
+import { Message, UserRecipient } from "../send/types";
+interface IInboundBulkMessageApiV1 {
     brand?: string;
     data?: object;
     event: string;
     locale?: string;
     override?: object;
 }
+declare type InboundBulkMessageApiV2 = Omit<Message, "to">;
+export interface IInboundBulkMessage extends IInboundBulkMessageApiV1 {
+    message?: InboundBulkMessageApiV2;
+}
+export declare type InboundBulkMessage = IInboundBulkMessage;
 export interface ICourierBulkConfig {
     idempotencyKey?: string;
     idempotencyExpiry?: number;
@@ -21,6 +27,7 @@ export interface IInboundBulkMessageUser {
     profile?: object;
     recipient?: string;
     data?: object;
+    to?: UserRecipient;
 }
 export declare type InboundBulkMessageUser = IInboundBulkMessageUser;
 export interface ICourierBulkIngestUsersParams {
@@ -74,3 +81,4 @@ export interface ICourierClientBulk {
     getJob: (params: ICourierBulkGetJobParams) => Promise<ICourierBulkGetJobResponse>;
     getJobUsers: (params: ICourierBulkGetJobUsersParams) => Promise<ICourierBulkGetJobUsersResponse>;
 }
+export {};

package/lib/client.js

@@ -97,7 +97,8 @@ var getMessages = function (options) {
                             messageId: params === null || params === void 0 ? void 0 : params.messageId,
                             notification: params === null || params === void 0 ? void 0 : params.notificationId,
                             recipient: params === null || params === void 0 ? void 0 : params.recipientId,
-                            status: params === null || params === void 0 ? void 0 : params.status
+                            status: params === null || params === void 0 ? void 0 : params.status,
+                            tags: params === null || params === void 0 ? void 0 : params.tags
                         }
                     })];
                 case 1:

package/lib/send/types.d.ts

@@ -238,11 +238,12 @@ export interface ElementalContentSugar {
 }
 export declare type Content = ElementalContentSugar | ElementalContent;
 export interface BaseMessage {
-    to: MessageRecipient;
-    data?: MessageData;
     channels?: MessageChannels;
+    data?: MessageData;
+    metadata?: MessageMetadata;
     providers?: MessageProviders;
     routing?: Routing;
+    to: MessageRecipient;
 }
 interface TrackingOverride {
     open: boolean;
@@ -316,15 +317,21 @@ export interface RoutingStrategyProvider<T = Record<string, any>> {
     config?: T;
     if?: string;
 }
-export interface ContentMessageMetadata {
+export interface MessageMetadata {
     event?: string;
+    tags?: string[];
+    utm?: {
+        source?: string;
+        medium?: string;
+        campaign?: string;
+        term?: string;
+        content?: string;
+    };
 }
 export interface ContentMessage extends BaseMessage {
     content: Content;
-    metadata?: ContentMessageMetadata;
 }
 export interface TemplateMessage extends BaseMessage {
-    brand?: string;
     template: string;
 }
 export declare type Message = ContentMessage | TemplateMessage;

package/lib/types.d.ts

@@ -96,6 +96,7 @@ export interface ICourierMessagesGetParameters {
     notificationId?: string;
     recipientId?: string;
     status?: string | string[];
+    tags?: string | string[];
 }
 export interface ICourierMessagesGetResponse {
     paging: ICourierPaging;
@@ -107,6 +108,7 @@ export interface ICourierMessagesGetResponse {
         recipient: string;
         sent?: number;
         status: string;
+        tags?: string[];
     }>;
 }
 export interface ICourierMessageGetResponse {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trycourier/courier",
-  "version": "3.6.0",
+  "version": "3.9.0",
   "description": "A node.js module for communicating with the Courier REST API.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",