@trycourier/courier 2.7.0 → 3.2.0

package/CHANGELOG.md

@@ -5,6 +5,22 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased][unreleased]
 
+## [v3.2.0] - 2021-11-18
+
+- adds idempotency expiration support for send and send list endpoints
+
+## [v3.1.0] - 2021-11-16
+
+- Expose additional type definitions for `getMessage`
+
+## [v3.0.0] - 2021-11-02
+
+- fixes type definition for `getRecipientSubscriptions`
+
+## [v2.8.0] - 2021-10-29
+
+- adds GET /messages/{messageId}/output API
+
 ## [v2.7.0] - 2021-10-21
 
 - adds GET /messages/{messageId}/history API
@@ -169,7 +185,11 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## v1.0.1 - 2019-07-12
 
-[unreleased]: https://github.com/trycourier/courier-node/compare/v2.7.0...HEAD
+[unreleased]: https://github.com/trycourier/courier-node/compare/v3.2.0...HEAD
+[v3.2.0]: https://github.com/trycourier/courier-node/compare/v3.1.0...v3.2.0
+[v3.1.0]: https://github.com/trycourier/courier-node/compare/v3.0.0...v3.1.0
+[v3.0.0]: https://github.com/trycourier/courier-node/compare/v2.8.0...v3.0.0
+[v2.8.0]: https://github.com/trycourier/courier-node/compare/v2.7.0...v2.8.0
 [v2.7.0]: https://github.com/trycourier/courier-node/compare/v2.6.0...v2.7.0
 [v2.6.0]: https://github.com/trycourier/courier-node/compare/v2.4.0...v2.6.0
 [v2.4.0]: https://github.com/trycourier/courier-node/compare/v2.3.0...v2.4.0

package/README.md

@@ -84,6 +84,10 @@ async function run() {
   const { results } = await courier.getMessageHistory(messageId);
   console.log(results);
 
+  // Example: get a message output
+  const { results } = await courier.getMessageOutput(messageId);
+  console.log(results);
+
   // Example: get all messages
   const { paging, results } = await courier.getMessages();
   console.log(results);

package/lib/client.js

@@ -55,6 +55,10 @@ var send = function (options) {
                     if (config && config.idempotencyKey) {
                         axiosConfig.headers["Idempotency-Key"] = config.idempotencyKey;
                     }
+                    if (config && config.idempotencyExpiry) {
+                        axiosConfig.headers["x-idempotency-expiration"] =
+                            config.idempotencyExpiry;
+                    }
                     return [4 /*yield*/, options.httpClient.post("/send", {
                             brand: params.brand,
                             data: params.data,
@@ -97,6 +101,19 @@ var getMessageHistory = function (options) {
         });
     }); };
 };
+var getMessageOutput = function (options) {
+    return function (messageId) { return __awaiter(void 0, void 0, void 0, function () {
+        var res;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, options.httpClient.get("/messages/" + messageId + "/output")];
+                case 1:
+                    res = _a.sent();
+                    return [2 /*return*/, res.data];
+            }
+        });
+    }); };
+};
 var getMessages = function (options) {
     return function (params) { return __awaiter(void 0, void 0, void 0, function () {
         var res;
@@ -129,6 +146,7 @@ exports.client = function (options) {
         getBrands: brands_1.getBrands(options),
         getMessage: getMessage(options),
         getMessageHistory: getMessageHistory(options),
+        getMessageOutput: getMessageOutput(options),
         getMessages: getMessages(options),
         getProfile: profile_1.getProfile(options),
         getRecipientSubscriptions: profile_1.getRecipientSubscriptions(options),

package/lib/lists/index.js

@@ -192,6 +192,10 @@ var send = function (options) {
                     if (config && config.idempotencyKey) {
                         axiosConfig.headers["Idempotency-Key"] = config.idempotencyKey;
                     }
+                    if (config && config.idempotencyExpiry) {
+                        axiosConfig.headers["x-idempotency-expiration"] =
+                            config.idempotencyExpiry;
+                    }
                     return [4 /*yield*/, options.httpClient.post("/send/list", params, axiosConfig)];
                 case 1:
                     res = _a.sent();

package/lib/lists/types.d.ts

@@ -6,6 +6,10 @@ export interface ICourierList {
     name: string;
     updated?: number;
 }
+export interface ICourierRecipientSubscriptionsResponse {
+    paging: ICourierPaging;
+    results: ICourierList[];
+}
 export interface ICourierListPutParams {
     name: string;
     preferences?: {

package/lib/profile.d.ts

@@ -1,9 +1,9 @@
-import { ICourierList } from "./lists/types";
+import { ICourierRecipientSubscriptionsResponse } from "./lists/types";
 import { ICourierClientConfiguration, ICourierProfileDeleteParameters, ICourierProfileGetParameters, ICourierProfileGetResponse, ICourierProfileListsPostParameters, ICourierProfilePostConfig, ICourierProfilePostParameters, ICourierProfilePostResponse, ICourierProfilePutParameters, ICourierProfilePutResponse } from "./types";
 export declare const replaceProfile: (options: ICourierClientConfiguration) => (params: ICourierProfilePutParameters) => Promise<ICourierProfilePutResponse>;
 export declare const mergeProfile: (options: ICourierClientConfiguration) => (params: ICourierProfilePostParameters, config?: ICourierProfilePostConfig | undefined) => Promise<ICourierProfilePostResponse>;
 export declare const getProfile: (options: ICourierClientConfiguration) => (params: ICourierProfileGetParameters) => Promise<ICourierProfileGetResponse>;
 export declare const deleteProfile: (options: ICourierClientConfiguration) => (params: ICourierProfileDeleteParameters) => Promise<void>;
-export declare const getRecipientSubscriptions: (options: ICourierClientConfiguration) => (params: ICourierProfileGetParameters) => Promise<ICourierList[]>;
+export declare const getRecipientSubscriptions: (options: ICourierClientConfiguration) => (params: ICourierProfileGetParameters) => Promise<ICourierRecipientSubscriptionsResponse>;
 export declare const addRecipientToLists: (options: ICourierClientConfiguration) => (params: ICourierProfileListsPostParameters) => Promise<ICourierProfilePostResponse>;
 export declare const removeRecipientFromAllLists: (options: ICourierClientConfiguration) => (params: ICourierProfileGetParameters) => Promise<ICourierProfilePostResponse>;

package/lib/types.d.ts

@@ -1,6 +1,6 @@
 import { AxiosRequestConfig } from "axios";
 import { ICourierClientAutomations } from "./automations/types";
-import { ICourierClientLists, ICourierList } from "./lists/types";
+import { ICourierClientLists, ICourierList, ICourierRecipientSubscriptionsResponse } from "./lists/types";
 import { ICourierClientNotifications } from "./notifications/types";
 import { ICourierClientPreferences, IRecipientPreferences } from "./preferences/types";
 export declare type HttpMethodClient = <T>(url: string, body?: object, config?: AxiosRequestConfig) => Promise<{
@@ -31,6 +31,7 @@ export interface ICourierSendParameters {
 }
 export interface ICourierSendConfig {
     idempotencyKey?: string;
+    idempotencyExpiry?: number;
 }
 export interface ICourierSendResponse {
     messageId: string;
@@ -101,25 +102,40 @@ export interface ICourierMessagesGetResponse {
     }>;
 }
 export interface ICourierMessageGetResponse {
+    clicked?: number;
+    delivered?: number;
     enqueued?: number;
+    error?: string;
     event?: string;
     id: string;
+    idempotencyKey?: string;
+    listId?: string;
+    listMessageId?: string;
     notification?: string;
+    opened?: number;
     providers?: Array<{
         channel: {
-            name: string;
+            key?: string;
+            name?: string;
             template: string;
         };
+        clicked?: number;
+        delivered?: number;
+        error?: string;
         provider: string;
-        reference: {
-            "x-message-id": string;
+        reference?: {
+            [key: string]: string | number;
         };
         sent: number;
-        status: string;
+        status: MessageStatus;
     }>;
+    reason?: MessageStatusReason;
+    reasonCode?: MessageStatusReasonCode;
+    reasonDetails?: string;
     recipient: string;
+    runId?: string;
     sent?: number;
-    status: string;
+    status: MessageStatus;
 }
 export declare type MessageStatus = "CLICKED" | "DELIVERED" | "ENQUEUED" | "FILTERED" | "OPENED" | "SENT" | "SIMULATED" | "UNDELIVERABLE" | "UNMAPPED";
 export declare type MessageHistoryType = MessageStatus | "DELIVERING" | "FILTERED" | "MAPPED" | "PROFILE_LOADED" | "RENDERED";
@@ -188,6 +204,21 @@ export interface IProviderErrorMessageHistory extends IRoutedMessageHistory<"UND
 export interface ICourierMessageGetHistoryResponse {
     results: Array<IEnqueuedMessageHistory | IMappedMessageHistory | IProfileLoadedMessageHistory | IRenderedMessageHistory | IRoutedMessageHistory<RoutedMessageHistoryTypes> | IDeliveredMessageHistory | IProviderErrorMessageHistory | IUndeliverableMessageHistory>;
 }
+export interface IApiMessageOutputItem {
+    channel: string;
+    channel_id: string;
+    content: {
+        html?: string;
+        title?: string;
+        blocks?: any[];
+        body?: string;
+        subject?: string;
+        text?: string;
+    };
+}
+export interface ICourierMessageGetOutputResponse {
+    results: IApiMessageOutputItem[];
+}
 export interface ICourierProfileDeleteParameters {
     recipientId: string;
 }
@@ -250,10 +281,11 @@ export interface ICourierClient {
     }) => Promise<ICourierBrandGetAllResponse>;
     getMessage: (messageId: string) => Promise<ICourierMessageGetResponse>;
     getMessageHistory: (messageId: string) => Promise<ICourierMessageGetHistoryResponse>;
+    getMessageOutput: (messageId: string) => Promise<ICourierMessageGetOutputResponse>;
     getMessages: (params?: ICourierMessagesGetParameters) => Promise<ICourierMessagesGetResponse>;
     getProfile: (params: ICourierProfileGetParameters) => Promise<ICourierProfileGetResponse>;
     deleteProfile: (params: ICourierProfileDeleteParameters) => Promise<void>;
-    getRecipientSubscriptions: (params: ICourierProfileGetParameters) => Promise<ICourierList[]>;
+    getRecipientSubscriptions: (params: ICourierProfileGetParameters) => Promise<ICourierRecipientSubscriptionsResponse>;
     lists: ICourierClientLists;
     mergeProfile: (params: ICourierProfilePostParameters, config?: ICourierProfilePostConfig) => Promise<ICourierProfilePostResponse>;
     notifications: ICourierClientNotifications;

package/package.json

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