@trycourier/courier 3.13.0 → 3.15.0

package/CHANGELOG.md

@@ -5,8 +5,17 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [Unreleased][unreleased]
 
-- adds support for granular timeouts for channel and providers
-- adds support for change and provider utm metadata (`channels.metadata.utm` and `providers.metadata.utm`) that augments action blocks links
+## [3.15.0]
+
+- adds support for audit events
+
+## [3.14.0]
+
+- adds support for token management
+
+## [3.13.1] - 2022-06-03
+
+- adds provider and channel timeout
 
 ## [3.12.0] - 2022-03-31
 
@@ -16,11 +25,12 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 - adds support for `audiences`
 
-
 ## [3.10.1] - 2022-03-20
+
 - adds support for messages timeout (`message.timeout`)
 
 ## [3.10.0] - 2020-03-24
+
 - adds support for messages brand_id (`message.brand_id`)
 
 ## [3.9.0] - 2022-03-17

package/lib/audiences/index.js

@@ -104,5 +104,5 @@ exports.audiences = function (options) { return ({
     get: getAudience(options),
     listAudiences: listAudiences(options),
     listMembers: listMembers(options),
-    put: putAudience(options),
+    put: putAudience(options)
 }); };

package/lib/audit-events/index.d.ts

@@ -0,0 +1,6 @@
+import { ICourierClientConfiguration } from "../types";
+import { IAuditEvent, ICourierGetAuditEventParams, ICourierListAuditEventsParams, ICourierListAuditEventsResponse } from "./types";
+export declare const auditEvents: (options: ICourierClientConfiguration) => {
+    get: (params: ICourierGetAuditEventParams) => Promise<IAuditEvent>;
+    list: (params: ICourierListAuditEventsParams) => Promise<ICourierListAuditEventsResponse>;
+};

package/lib/audit-events/index.js

@@ -0,0 +1,75 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditEvents = void 0;
+var list = function (options) {
+    return function (params) { 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("/audit-events", {
+                        params: {
+                            cursor: params.cursor
+                        }
+                    })];
+                case 1:
+                    res = _a.sent();
+                    return [2 /*return*/, res.data];
+            }
+        });
+    }); };
+};
+var get = function (options) {
+    return function (params) { 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("/audit-events/" + params.auditEventId)];
+                case 1:
+                    res = _a.sent();
+                    return [2 /*return*/, res.data];
+            }
+        });
+    }); };
+};
+exports.auditEvents = function (options) {
+    return {
+        get: get(options),
+        list: list(options)
+    };
+};

package/lib/audit-events/types.d.ts

@@ -0,0 +1,27 @@
+export interface ICourierListAuditEventsParams {
+    cursor?: string;
+}
+export interface ICourierGetAuditEventParams {
+    auditEventId: string;
+}
+export interface ICourierListAuditEventsResponse {
+    paging: {
+        cursor?: string;
+        more: boolean;
+    };
+    results: IAuditEvent[];
+}
+export interface IAuditEvent {
+    actor?: {
+        id?: string;
+        email?: string;
+    };
+    target?: {
+        id?: string;
+        email?: string;
+    };
+    auditEventId: string;
+    source: string;
+    timestamp: string;
+    type: string;
+}

package/lib/audit-events/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/automations/types.d.ts

@@ -1,3 +1,4 @@
+import { Message } from "../send/types";
 export declare type AutomationStepAction = "cancel" | "delay" | "send" | "send-list" | "update-profile";
 export declare type MergeAlgorithm = "replace" | "none" | "overwrite" | "soft-merge";
 export interface IAutomationStep {
@@ -23,6 +24,10 @@ export interface IAutomationSendStep extends IAutomationStep {
     recipient?: string;
     template?: string;
 }
+export interface IAutomationV2SendStep extends IAutomationStep {
+    action: "send";
+    message: Message;
+}
 export interface IAutomationSendListStep extends IAutomationStep {
     action: "send-list";
     brand?: string;
@@ -37,7 +42,7 @@ export interface IAutomationUpdateProfileStep extends IAutomationStep {
     profile: object;
     merge: MergeAlgorithm;
 }
-export declare type AutomationStep = IAutomationCancelStep | IAutomationDelayStep | IAutomationSendStep | IAutomationSendListStep | IAutomationUpdateProfileStep;
+export declare type AutomationStep = IAutomationCancelStep | IAutomationDelayStep | IAutomationSendStep | IAutomationV2SendStep | IAutomationSendListStep | IAutomationUpdateProfileStep;
 export interface IAutomation {
     cancelation_token?: string;
     steps: AutomationStep[];

package/lib/client.js

@@ -38,6 +38,7 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.client = void 0;
 var audiences_1 = require("./audiences");
+var audit_events_1 = require("./audit-events");
 var automations_1 = require("./automations");
 var brands_1 = require("./brands");
 var bulk_1 = require("./bulk");
@@ -46,6 +47,7 @@ var notifications_1 = require("./notifications");
 var preferences_1 = require("./preferences");
 var profile_1 = require("./profile");
 var send_1 = require("./send");
+var token_management_1 = require("./token-management");
 var getMessage = function (options) {
     return function (messageId) { return __awaiter(void 0, void 0, void 0, function () {
         var res;
@@ -99,8 +101,8 @@ var getMessages = function (options) {
                             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,
-                            tags: params === null || params === void 0 ? void 0 : params.tags,
-                        },
+                            tags: params === null || params === void 0 ? void 0 : params.tags
+                        }
                     })];
                 case 1:
                     res = _a.sent();
@@ -113,6 +115,7 @@ exports.client = function (options) {
     return {
         addRecipientToLists: profile_1.addRecipientToLists(options),
         audiences: audiences_1.audiences(options),
+        auditEvents: audit_events_1.auditEvents(options),
         automations: automations_1.automations(options),
         bulk: bulk_1.bulk(options),
         createBrand: brands_1.createBrand(options),
@@ -134,5 +137,6 @@ exports.client = function (options) {
         replaceBrand: brands_1.replaceBrand(options),
         replaceProfile: profile_1.replaceProfile(options),
         send: send_1.send(options),
+        tokenManagement: token_management_1.tokenManagement(options)
     };
 };

package/lib/token-management/index.d.ts

@@ -0,0 +1,12 @@
+import { ICourierClientConfiguration } from "../types";
+import { IDeleteUserTokenOpts, IGetUserTokenOpts, IGetUserTokenResponse, IGetUserTokensOpts, IPatchUserTokenOpts, IPutUserTokenOpts, IPutUserTokensOpts } from "./types";
+export declare const tokenManagement: (options: ICourierClientConfiguration) => {
+    deleteUserToken: (opts: IDeleteUserTokenOpts) => Promise<void>;
+    getUserToken: (opts: IGetUserTokenOpts) => Promise<IGetUserTokenResponse>;
+    getUserTokens: (opts: IGetUserTokensOpts) => Promise<{
+        tokens: IGetUserTokenResponse[];
+    }>;
+    patchUserToken: (opts: IPatchUserTokenOpts) => Promise<void>;
+    putUserToken: (opts: IPutUserTokenOpts) => Promise<void>;
+    putUserTokens: (opts: IPutUserTokensOpts) => Promise<void>;
+};

package/lib/token-management/index.js

@@ -0,0 +1,127 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (_) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tokenManagement = void 0;
+/** Associate a group of tokens with the supplied :user_id. Will overwrite any existing tokens associated with that user. */
+var putUserTokens = function (options) {
+    return function (opts) { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, options.httpClient.put("/users/" + opts.user_id + "/tokens", {
+                        tokens: opts.tokens
+                    })];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); };
+};
+/** Associate a token with the supplied :user_id. If token exists it's value will be replaced with the passed body, otherwise the token will be created. */
+var putUserToken = function (options) {
+    return function (opts) { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, options.httpClient.put("/users/" + opts.user_id + "/tokens/" + opts.token.token, opts.token)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); };
+};
+var patchUserToken = function (options) {
+    return function (opts) { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, options.httpClient.patch("/users/" + opts.user_id + "/tokens/" + opts.token, { patch: opts.patch })];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); };
+};
+var getUserToken = function (options) {
+    return function (opts) { 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("/users/" + opts.user_id + "/tokens/" + opts.token)];
+                case 1:
+                    res = _a.sent();
+                    return [2 /*return*/, res.data];
+            }
+        });
+    }); };
+};
+var getUserTokens = function (options) {
+    return function (opts) { 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("/users/" + opts.user_id + "/tokens")];
+                case 1:
+                    res = _a.sent();
+                    return [2 /*return*/, res.data];
+            }
+        });
+    }); };
+};
+var deleteUserToken = function (options) {
+    return function (opts) { return __awaiter(void 0, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0: return [4 /*yield*/, options.httpClient.delete("/users/" + opts.user_id + "/tokens/" + opts.token)];
+                case 1:
+                    _a.sent();
+                    return [2 /*return*/];
+            }
+        });
+    }); };
+};
+exports.tokenManagement = function (options) {
+    return {
+        deleteUserToken: deleteUserToken(options),
+        getUserToken: getUserToken(options),
+        getUserTokens: getUserTokens(options),
+        patchUserToken: patchUserToken(options),
+        putUserToken: putUserToken(options),
+        putUserTokens: putUserTokens(options)
+    };
+};

package/lib/token-management/types.d.ts

@@ -0,0 +1,56 @@
+export interface IUserToken {
+    token: string;
+    provider_key: "firebase-fcm" | "apn" | "expo" | "onesignal";
+    /** ISO 8601 Date. Set to false to disable expiration */
+    expiry_date?: string | false;
+    /** Additional properties to be passed to provider or to be generically associated with the token */
+    properties?: {
+        [key: string]: any;
+    };
+    device?: {
+        app_id?: string;
+        ad_id?: string;
+        device_id?: string;
+        platform?: string;
+        manufacturer?: string;
+        model?: string;
+    };
+    tracking?: {
+        os_version?: string;
+        ip?: string;
+        lat?: string;
+        long?: string;
+    };
+}
+export interface IGetUserTokenResponse extends IUserToken {
+    status: "active" | "unknown" | "failed" | "revoked";
+    status_reason?: string;
+}
+export interface IPutUserTokensOpts {
+    user_id: string;
+    tokens: IUserToken[];
+}
+export interface IPutUserTokenOpts {
+    user_id: string;
+    token: IUserToken;
+}
+export interface IPatchUserTokenOpts {
+    user_id: string;
+    token: string;
+    patch: Array<{
+        op: "replace" | "add" | "remove" | "copy" | "move" | "test";
+        path: string;
+        value?: string;
+    }>;
+}
+export interface IGetUserTokenOpts {
+    user_id: string;
+    token: string;
+}
+export interface IGetUserTokensOpts {
+    user_id: string;
+}
+export interface IDeleteUserTokenOpts {
+    user_id: string;
+    token: string;
+}

package/lib/token-management/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/types.d.ts

@@ -1,11 +1,13 @@
 import { AxiosRequestConfig } from "axios";
 import { ICourierClientAudiences } from "./audiences/types";
+import { auditEvents } from "./audit-events";
 import { ICourierClientAutomations } from "./automations/types";
 import { ICourierClientBulk } from "./bulk/types";
 import { ICourierClientLists, ICourierList, ICourierRecipientSubscriptionsResponse } from "./lists/types";
 import { ICourierClientNotifications } from "./notifications/types";
 import { ICourierClientPreferences, IRecipientPreferences } from "./preferences/types";
 import { Message } from "./send/types";
+import { tokenManagement } from "./token-management";
 export declare type HttpMethodClient = <T>(url: string, body?: object, config?: AxiosRequestConfig) => Promise<{
     data: T;
 }>;
@@ -288,6 +290,7 @@ export declare type SendResponse<T extends ICourierSendParameters | ICourierSend
 export interface ICourierClient {
     addRecipientToLists: (params: ICourierProfileListsPostParameters) => Promise<ICourierProfilePostResponse>;
     audiences: ICourierClientAudiences;
+    auditEvents: ReturnType<typeof auditEvents>;
     automations: ICourierClientAutomations;
     bulk: ICourierClientBulk;
     createBrand: (params: ICourierBrandParameters, config?: ICourierBrandPostConfig) => Promise<ICourierBrand>;
@@ -311,5 +314,6 @@ export interface ICourierClient {
     replaceBrand: (params: ICourierBrandPutParameters) => Promise<ICourierBrand>;
     replaceProfile: (params: ICourierProfilePutParameters) => Promise<ICourierProfilePutResponse>;
     send: <T extends ICourierSendParameters | ICourierSendMessageParameters>(params: T, config?: ICourierSendConfig) => Promise<SendResponse<T>>;
+    tokenManagement: ReturnType<typeof tokenManagement>;
 }
 export {};

package/package.json

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