@trycourier/courier 3.5.0 → 3.8.0

package/CHANGELOG.md

@@ -5,6 +5,19 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased][unreleased]
 
+## [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 types for the recipient property (`message.to`)
+
 ## [v3.5.0] - 2022-02-10
 
 - adds type for unroutable status

package/README.md

@@ -23,29 +23,142 @@ import { CourierClient } from "@trycourier/courier";
 
 const courier = CourierClient({ authorizationToken: "<AUTH_TOKEN>" }); // get from the Courier UI
 
+// Example: send a basic message to an email recipient
+const { requestId } = await courier.send({
+  message: {
+    to: {
+      data: {
+        name: "Marty",
+      },
+      email: "marty_mcfly@email.com",
+    },
+    content: {
+      title: "Back to the Future",
+      body: "Oh my {{name}}, we need 1.21 Gigawatts!",
+    },
+    routing: {
+      method: "single",
+      channels: ["email"],
+    },
+  },
+});
+
+// Example: send a basic message to an sms recipient
+const { requestId } = await courier.send({
+  message: {
+    to: {
+      data: {
+        name: "Jenny",
+      },
+      phone_number: "8675309",
+    },
+    content: {
+      title: "Back to the Future",
+      body: "Oh my {{name}}, we need 1.21 Gigawatts!",
+    },
+    routing: {
+      method: "single",
+      channels: ["sms"],
+    },
+  },
+});
+
+// Example: send a message to various recipients
+const { requestId } = await courier.send({
+  message: {
+    to: [
+      {
+        user_id: "<USER_ID>", // usually your system's User ID associated to a Courier profile
+        email: "test@email.com",
+        data: {
+          name: "some user's name",
+        },
+      },
+      {
+        email: "marty@email.com",
+        data: {
+          name: "Marty",
+        },
+      },
+      {
+        email: "doc_brown@email.com",
+        data: {
+          name: "Doc",
+        },
+      },
+      {
+        phone_number: "8675309",
+        data: {
+          name: "Jenny",
+        },
+      },
+    ],
+    content: {
+      title: "Back to the Future",
+      body: "Oh my {{name}}, we need 1.21 Gigawatts!",
+    },
+    routing: {
+      method: "all",
+      channels: ["sms", "email"],
+    },
+  },
+});
+
 // Example: send a message supporting email & SMS
-const { messageId } = await courier.send({
-  eventId: "<EVENT_ID>", // get from the Courier UI
-  recipientId: "<RECIPIENT_ID>", // usually your system's User ID
-  profile: {
-    email: "example@example.com",
-    phone_number: "555-228-3890",
+const { requestId } = await courier.send({
+  message: {
+    template: "<TEMPLATE_OR_EVENT_ID>", // get from the Courier UI
+    to: {
+      user_Id: "<USER_ID>", // usually your system's User ID
+      email: "example@example.com",
+      phone_number: "555-228-3890",
+    },
+    data: {}, // optional variables for merging into templates
   },
-  data: {}, // optional variables for merging into templates
 });
 
 // Example: send a message to a list
-const { messageId } = await courier.lists.send({
-  event: "<EVENT_ID>", // get from the Courier UI
-  list: "<LIST_ID>", // e.g. example.list.id
-  data: {}, // optional variables for merging into templates
+const { requestId } = await courier.send({
+  message: {
+    template: "<TEMPLATE_OR_EVENT_ID>", // get from the Courier UI
+    to: {
+      list_id: "<LIST_ID>", // e.g. your Courier List Id
+    },
+    data: {}, // optional variables for merging into templates
+  },
 });
 
 // Example: send a message to a pattern
-const { messageId } = await courier.lists.send({
-  event: "<EVENT_ID>", // get from the Courier UI
-  pattern: "<PATTERN>", // e.g. example.list.*
-  data: {}, // optional variables for merging into templates
+const { requestId } = await courier.send({
+  message: {
+    template: "<TEMPLATE_OR_EVENT_ID>", // get from the Courier UI
+    to: {
+      list_pattern: "<PATTERN>", // e.g. example.list.*
+    },
+    data: {}, // optional variables for merging into templates
+  },
+});
+
+// Example: send a message to a list, pattern and user
+const { requestId } = await courier.send({
+  message: {
+    to: [
+      {
+        list_pattern: "<PATTERN>", // e.g. example.list.*
+      },
+      {
+        list_id: "<LIST_ID>", // e.g. your Courier List Id
+      },
+      {
+        email: "test@email.com"
+      }
+    ]
+    },
+    routing: {
+      method: "single",
+      channels: ["email"],
+    },
+  },
 });
 ```
 
@@ -65,27 +178,32 @@ const courier = CourierClient({ authorizationToken: "<AUTH_TOKEN>" });
 
 async function run() {
   // Example: send a message
-  const { messageId } = await courier.send({
-    eventId: "<EVENT_ID>",
-    recipientId: "<RECIPIENT_ID>",
-    profile: {}, // optional
-    data: {}, // optional
-    brand: "<BRAND_ID>", //optional
-    preferences: {}, // optional
-    override: {}, // optional
+  const { requestId } = await courier.send({
+    message: {
+      template: "<TEMPLATE_OR_EVENT_ID>",
+      to: {
+        // optional
+        user_id: "<RECIPIENT_ID>",
+      },
+      data: {}, // optional
+      brand_id: "<BRAND_ID>", //optional
+      routing: {},
+      channels: {}, // optional
+      providers: {}, // optional
+    },
   });
-  console.log(messageId);
+  console.log(requestId);
 
   // Example: get a message status
-  const messageStatus = await courier.getMessage(messageId);
+  const messageStatus = await courier.getMessage(requestId);
   console.log(messageStatus);
 
   // Example: get a message history
-  const { results } = await courier.getMessageHistory(messageId);
+  const { results } = await courier.getMessageHistory(requestId);
   console.log(results);
 
   // Example: get a message output
-  const { results } = await courier.getMessageOutput(messageId);
+  const { results } = await courier.getMessageOutput(requestId);
   console.log(results);
 
   // Example: get all messages
@@ -433,11 +551,11 @@ const courier = CourierClient();
 const idempotencyKey = uuid4();
 
 async function run() {
-  const { messageId } = await courier.send(
+  const { requestId } = await courier.send(
     {
-      eventId: "<EVENT_ID>",
-      recipientId: "<RECIPIENT_ID>",
-      profile: {
+      template: "<TEMPLATE_OR_EVENT_ID>",
+      to: {
+        user_id: "<USER_ID>",
         email: "example@example.com",
         phone_number: "555-867-5309",
       },
@@ -449,7 +567,7 @@ async function run() {
       idempotencyKey,
     }
   );
-  console.log(messageId);
+  console.log(requestId);
 }
 
 run();

package/lib/client.js

@@ -97,8 +97,9 @@ 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:
                     res = _a.sent();

package/lib/send/types.d.ts

@@ -166,10 +166,6 @@ interface ElementalBaseNode {
 }
 export interface MessageData extends Record<string, any> {
 }
-interface ListRecipient {
-    list_id: string;
-    pattern?: string;
-}
 export declare type RuleType = "snooze" | "channel_preferences" | "status";
 export interface IRule<T extends RuleType> {
     type: T;
@@ -197,7 +193,36 @@ export interface IProfilePreferences {
     notifications: IPreferences;
     templateId?: string;
 }
-export interface UserRecipient extends Record<string, any> {
+interface InvalidListRecipient {
+    user_id: string;
+    list_pattern: string;
+}
+declare type ListRecipientType = Record<string, unknown> & {
+    [key in keyof InvalidListRecipient]?: never;
+};
+export interface ListRecipient extends ListRecipientType {
+    list_id?: string;
+    data?: MessageData;
+}
+interface InvalidListPatternRecipient {
+    user_id: string;
+    list_id: string;
+}
+declare type ListPatternRecipientType = Record<string, unknown> & {
+    [key in keyof InvalidListPatternRecipient]?: never;
+};
+export interface ListPatternRecipient extends ListPatternRecipientType {
+    list_pattern?: string;
+    data?: MessageData;
+}
+interface InvalidUserRecipient {
+    list_id: string;
+    list_pattern: string;
+}
+declare type UserRecipientType = Record<string, unknown> & {
+    [key in keyof InvalidUserRecipient]?: never;
+};
+export interface UserRecipient extends UserRecipientType {
     data?: MessageData;
     email?: string;
     locale?: string;
@@ -205,18 +230,20 @@ export interface UserRecipient extends Record<string, any> {
     phone_number?: string;
     preferences?: IProfilePreferences;
 }
-export declare type MessageRecipient = ListRecipient | UserRecipient;
+export declare type Recipient = ListRecipient | ListPatternRecipient | UserRecipient;
+export declare type MessageRecipient = Recipient | Recipient[];
 export interface ElementalContentSugar {
     body?: string;
     title?: string;
 }
 export declare type Content = ElementalContentSugar | ElementalContent;
 export interface BaseMessage {
-    to: MessageRecipient | MessageRecipient[];
-    data?: MessageData;
     channels?: MessageChannels;
+    data?: MessageData;
+    metadata?: MessageMetadata;
     providers?: MessageProviders;
     routing?: Routing;
+    to: MessageRecipient;
 }
 interface TrackingOverride {
     open: boolean;
@@ -290,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.5.0",
+  "version": "3.8.0",
   "description": "A node.js module for communicating with the Courier REST API.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -33,4 +33,4 @@
   "dependencies": {
     "axios": "^0.21.1"
   }
-}
+}