btrz-api-client 9.15.0 → 9.17.0

package/lib/endpoints/notifications/salesforce.js

@@ -7,7 +7,7 @@ const {
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
- * @returns {{ sms: { create: function } }}
+ * @returns {{ sms: { create: function, deliveries: { get: function } } }}
  */
 function salesforceFactory({
   client,
@@ -43,6 +43,35 @@ function salesforceFactory({
             headers
           })
         });
+      },
+      deliveries: {
+        /**
+         * GET /salesforce/sms/deliveries/{tokenId} - Marketing Cloud delivery status.
+         * messageId is resolved server-side from the account Salesforce settings.
+         * @param {Object} opts
+         * @param {string} [opts.token] - API key
+         * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+         * @param {string} opts.tokenId - Marketing Cloud tokenId from the accepted send
+         * @param {Object} [opts.headers] - Optional headers
+         * @returns {Promise<import("axios").AxiosResponse>}
+         */
+        get({
+          token,
+          jwtToken,
+          tokenId,
+          headers
+        }) {
+          return client({
+            url: `/salesforce/sms/deliveries/${tokenId}`,
+            method: "get",
+            headers: authorizationHeaders({
+              token,
+              jwtToken,
+              internalAuthTokenProvider,
+              headers
+            })
+          });
+        }
       }
     }
   };

package/lib/endpoints/operations/manifest.js

@@ -3,7 +3,6 @@ function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t =
 function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
 function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-/* eslint-disable max-len */
 const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
@@ -80,6 +79,25 @@ const {
  * @property {boolean} [bypassValidations] - If true, bypass driver validations
  */
 
+/**
+ * Query params for GET /manifests/item-capacity-over-limit (btrz-api-operations).
+ * @typedef {Object} ItemCapacityOverLimitQuery
+ * @property {string} itemId - Catalog item id (sourceItemId)
+ * @property {number|string} limit - Proposed Manifest Item Capacity Limit (>= 1)
+ * @property {number|string} [page] - Page number (>= 1)
+ */
+
+/**
+ * Query params for GET /manifests/item-capacity-used (btrz-api-operations).
+ * @typedef {Object} ItemCapacityUsedQuery
+ * @property {string} routeId - Route id
+ * @property {string} scheduleId - Schedule id (manifest schedule key)
+ * @property {string} date - Travel date yyyy-mm-dd
+ * @property {string} fromId - Origin station id
+ * @property {string} toId - Destination station id
+ * @property {string} [itemIds] - Optional comma-separated catalog item ids
+ */
+
 /**
  * Factory for manifests API (btrz-api-operations).
  * @param {Object} deps
@@ -209,6 +227,62 @@ function manifestFactory({
     });
   }
 
+  /**
+   * GET /manifests/item-capacity-over-limit - future manifests over a proposed item capacity limit.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {ItemCapacityOverLimitQuery} opts.query - itemId, limit, optional page
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function itemCapacityOverLimit({
+    token,
+    jwtToken,
+    query = {},
+    headers
+  }) {
+    return client({
+      url: "/manifests/item-capacity-over-limit",
+      method: "get",
+      params: query,
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      })
+    });
+  }
+
+  /**
+   * GET /manifests/item-capacity-used - path max qty used per attach-to-ticket item.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {ItemCapacityUsedQuery} opts.query - routeId, scheduleId, date, fromId, toId, optional itemIds
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function itemCapacityUsed({
+    token,
+    jwtToken,
+    query = {},
+    headers
+  }) {
+    return client({
+      url: "/manifests/item-capacity-used",
+      method: "get",
+      params: query,
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      })
+    });
+  }
+
   /**
    * GET /manifests/:manifestId - get manifest by id. API does not accept query params.
    * @param {Object} opts
@@ -1030,16 +1104,16 @@ function manifestFactory({
   };
 
   /**
-  * POST manifests/:manifestId/boarding/:stationId - board passengers at station.
-  * @param {Object} opts
-  * @param {string} [opts.token] - API key
-  * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-  * @param {Object} [opts.headers] - Optional headers
-  * @param {string} opts.manifestId - Manifest id
-  * @param {string} opts.stationId - Station id
-  * @param {Object} opts.data - Request body
-  * @returns {Promise<import("axios").AxiosResponse>}
-  */
+   * POST manifests/:manifestId/boarding/:stationId - board passengers at station.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.headers] - Optional headers
+   * @param {string} opts.manifestId - Manifest id
+   * @param {string} opts.stationId - Station id
+   * @param {Object} opts.data - Request body
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function stationBoarding({
     token,
     jwtToken,
@@ -1098,16 +1172,16 @@ function manifestFactory({
   }
 
   /**
-  * POST manifests/:manifestId/sales-closure/:stationId - close sales at station.
-  * @param {Object} opts
-  * @param {string} [opts.token] - API key
-  * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-  * @param {Object} [opts.headers] - Optional headers
-  * @param {string} opts.manifestId - Manifest id
-  * @param {string} opts.stationId - Station id
-  * @param {Object} opts.data - Request body
-  * @returns {Promise<import("axios").AxiosResponse>}
-  */
+   * POST manifests/:manifestId/sales-closure/:stationId - close sales at station.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} [opts.headers] - Optional headers
+   * @param {string} opts.manifestId - Manifest id
+   * @param {string} opts.stationId - Station id
+   * @param {Object} opts.data - Request body
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
   function stationSalesClosure({
     token,
     jwtToken,
@@ -1134,6 +1208,8 @@ function manifestFactory({
     get,
     getAll,
     getById,
+    itemCapacityOverLimit,
+    itemCapacityUsed,
     outlook,
     patch,
     save,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "btrz-api-client",
-  "version": "9.15.0",
+  "version": "9.17.0",
   "description": "Api client for Betterez endpoints",
   "main": "index.js",
   "scripts": {

package/src/endpoints/notifications/salesforce.js

@@ -7,7 +7,7 @@ const {
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
- * @returns {{ sms: { create: function } }}
+ * @returns {{ sms: { create: function, deliveries: { get: function } } }}
  */
 function salesforceFactory({
   client, internalAuthTokenProvider
@@ -34,6 +34,27 @@ function salesforceFactory({
           },
           headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
         });
+      },
+      deliveries: {
+        /**
+         * GET /salesforce/sms/deliveries/{tokenId} - Marketing Cloud delivery status.
+         * messageId is resolved server-side from the account Salesforce settings.
+         * @param {Object} opts
+         * @param {string} [opts.token] - API key
+         * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+         * @param {string} opts.tokenId - Marketing Cloud tokenId from the accepted send
+         * @param {Object} [opts.headers] - Optional headers
+         * @returns {Promise<import("axios").AxiosResponse>}
+         */
+        get({
+          token, jwtToken, tokenId, headers
+        }) {
+          return client({
+            url: `/salesforce/sms/deliveries/${tokenId}`,
+            method: "get",
+            headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+          });
+        }
       }
     }
   };

package/src/endpoints/operations/manifest.js

@@ -1,4 +1,4 @@
-/* eslint-disable max-len */
+
 const {
   authorizationHeaders
 } = require("./../endpoints_helpers.js");
@@ -75,6 +75,25 @@ const {
  * @property {boolean} [bypassValidations] - If true, bypass driver validations
  */
 
+/**
+ * Query params for GET /manifests/item-capacity-over-limit (btrz-api-operations).
+ * @typedef {Object} ItemCapacityOverLimitQuery
+ * @property {string} itemId - Catalog item id (sourceItemId)
+ * @property {number|string} limit - Proposed Manifest Item Capacity Limit (>= 1)
+ * @property {number|string} [page] - Page number (>= 1)
+ */
+
+/**
+ * Query params for GET /manifests/item-capacity-used (btrz-api-operations).
+ * @typedef {Object} ItemCapacityUsedQuery
+ * @property {string} routeId - Route id
+ * @property {string} scheduleId - Schedule id (manifest schedule key)
+ * @property {string} date - Travel date yyyy-mm-dd
+ * @property {string} fromId - Origin station id
+ * @property {string} toId - Destination station id
+ * @property {string} [itemIds] - Optional comma-separated catalog item ids
+ */
+
 /**
  * Factory for manifests API (btrz-api-operations).
  * @param {Object} deps
@@ -160,6 +179,42 @@ function manifestFactory({
     });
   }
 
+  /**
+   * GET /manifests/item-capacity-over-limit - future manifests over a proposed item capacity limit.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {ItemCapacityOverLimitQuery} opts.query - itemId, limit, optional page
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function itemCapacityOverLimit({token, jwtToken, query = {}, headers}) {
+    return client({
+      url: "/manifests/item-capacity-over-limit",
+      method: "get",
+      params: query,
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  /**
+   * GET /manifests/item-capacity-used - path max qty used per attach-to-ticket item.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {ItemCapacityUsedQuery} opts.query - routeId, scheduleId, date, fromId, toId, optional itemIds
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function itemCapacityUsed({token, jwtToken, query = {}, headers}) {
+    return client({
+      url: "/manifests/item-capacity-used",
+      method: "get",
+      params: query,
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
   /**
    * GET /manifests/:manifestId - get manifest by id. API does not accept query params.
    * @param {Object} opts
@@ -730,7 +785,7 @@ function manifestFactory({
     }
   };
 
-    /**
+  /**
    * POST manifests/:manifestId/boarding/:stationId - board passengers at station.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
@@ -741,16 +796,16 @@ function manifestFactory({
    * @param {Object} opts.data - Request body
    * @returns {Promise<import("axios").AxiosResponse>}
    */
-    function stationBoarding({token, jwtToken, headers, manifestId, stationId, data, query}) {
-      return client({
-        url: `/manifests/${manifestId}/boarding/${stationId}`,
-        method: "post",
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-        data,
-        params: query
-      });
-    }
-    
+  function stationBoarding({token, jwtToken, headers, manifestId, stationId, data, query}) {
+    return client({
+      url: `/manifests/${manifestId}/boarding/${stationId}`,
+      method: "post",
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      data,
+      params: query
+    });
+  }
+
   /**
    * POST manifests/:manifestId/dispatch/:stationId - dispatch manifest at station.
    * @param {Object} opts
@@ -762,17 +817,17 @@ function manifestFactory({
    * @param {Object} opts.data - Request body
    * @returns {Promise<import("axios").AxiosResponse>}
    */
-    function stationDispatch({token, jwtToken, headers, manifestId, stationId, data, query}) {
-      return client({
-        url: `/manifests/${manifestId}/dispatch/${stationId}`,
-        method: "post",
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-        data,
-        params: query
-      });
-    }
+  function stationDispatch({token, jwtToken, headers, manifestId, stationId, data, query}) {
+    return client({
+      url: `/manifests/${manifestId}/dispatch/${stationId}`,
+      method: "post",
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      data,
+      params: query
+    });
+  }
 
-            /**
+  /**
    * POST manifests/:manifestId/sales-closure/:stationId - close sales at station.
    * @param {Object} opts
    * @param {string} [opts.token] - API key
@@ -783,20 +838,22 @@ function manifestFactory({
    * @param {Object} opts.data - Request body
    * @returns {Promise<import("axios").AxiosResponse>}
    */
-    function stationSalesClosure({token, jwtToken, headers, manifestId, stationId, data, query}) {
-      return client({
-        url: `/manifests/${manifestId}/sales-closure/${stationId}`,
-        method: "post",
-        headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
-        data,
-        params: query
-      });
-    }
+  function stationSalesClosure({token, jwtToken, headers, manifestId, stationId, data, query}) {
+    return client({
+      url: `/manifests/${manifestId}/sales-closure/${stationId}`,
+      method: "post",
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      data,
+      params: query
+    });
+  }
 
   return {
     get,
     getAll,
     getById,
+    itemCapacityOverLimit,
+    itemCapacityUsed,
     outlook,
     patch,
     save,

package/test/endpoints/accounts/websales-config.test.js

@@ -31,40 +31,41 @@ describe("accounts/websales-config", () => {
       token,
       jwtToken,
       websalesConfigId,
-      "update": {
-        "websales_bgcolor": "",
-        "customCss": "updated custom css",
-        "socialSharing": false,
-        "fullpageLogoLink": "",
-        "fullpageHeadline": "",
-        "fullpageInfoHeadline": "",
-        "fullpageInfoDetails": "",
-        "waitingMessage": "",
-        "websales_logoredirecturl": "",
-        "disableBackButtonOnTripResults": false,
-        "forceLogin": false,
-        "lexiconKeys": {
-          "fullpageHeadline": {
-            "key": "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-fullpageHeadline",
-            "values": {
+      update: {
+        websales_bgcolor: "",
+        customCss: "updated custom css",
+        socialSharing: false,
+        fullpageLogoLink: "",
+        fullpageHeadline: "",
+        fullpageInfoHeadline: "",
+        fullpageInfoDetails: "",
+        waitingMessage: "",
+        websales_logoredirecturl: "",
+        disableBackButtonOnTripResults: false,
+        forceLogin: false,
+        disableSignUp: false,
+        lexiconKeys: {
+          fullpageHeadline: {
+            key: "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-fullpageHeadline",
+            values: {
               "en-us": "updated fullpageHeadline"
             }
           },
-          "fullpageInfoHeadline": {
-            "key": "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-fullpageInfoHeadline",
-            "values": {
+          fullpageInfoHeadline: {
+            key: "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-fullpageInfoHeadline",
+            values: {
               "en-us": "updated fullpageInfoHeadline"
             }
           },
-          "fullpageInfoDetails": {
-            "key": "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-fullpageInfoDetails",
-            "values": {
+          fullpageInfoDetails: {
+            key: "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-fullpageInfoDetails",
+            values: {
               "en-us": "fullpageInfoDetails"
             }
           },
-          "ssoErrorMsg": {
-            "key": "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-ssoErrorMsg",
-            "values": {
+          ssoErrorMsg: {
+            key: "624e08b5fdd69a15e973fcbc-websalesConfig-6261875eaad6f32745351fe2-ssoErrorMsg",
+            values: {
               "en-us": "updated ssoErrorMsg"
             }
           }

package/test/endpoints/notifications/salesforce.test.js

@@ -24,4 +24,15 @@ describe("notifications/salesforce", () => {
     };
     return api.notifications.salesforce.sms.create({token, jwtToken, sms});
   });
+
+  it("should get sms delivery status by tokenId", () => {
+    const tokenId = "tok-delivery-123";
+    axiosMock.onGet(`/salesforce/sms/deliveries/${tokenId}`).reply(({headers}) => {
+      if (headers["x-api-key"] === token && headers.authorization === `Bearer ${jwtToken}`) {
+        return [200, {response: {status: "Finished", tracking: []}}];
+      }
+      return [403];
+    });
+    return api.notifications.salesforce.sms.deliveries.get({token, jwtToken, tokenId});
+  });
 });

package/test/endpoints/operations/manifest.test.js

@@ -40,6 +40,41 @@ describe("operations/manifest", () => {
     });
   });
 
+  it("should get item capacity over limit manifests", async () => {
+    const query = {
+      itemId: "507f1f77bcf86cd799439011",
+      limit: 5,
+      page: 1
+    };
+    axiosMock.onGet("/manifests/item-capacity-over-limit").reply(expectRequest({
+      statusCode: 200, token, jwtToken
+    }));
+    const call = await api.operations.manifest.itemCapacityOverLimit({
+      token, jwtToken, query
+    });
+    assert.deepStrictEqual(call.config.params, query);
+    return call;
+  });
+
+  it("should get item capacity used on a path", async () => {
+    const query = {
+      routeId: "507f1f77bcf86cd799439011",
+      scheduleId: "5cab127c-2c70-4fea-9031-4131e2751cdb",
+      date: "2035-07-20",
+      fromId: "507f1f77bcf86cd799439012",
+      toId: "507f1f77bcf86cd799439013",
+      itemIds: "507f1f77bcf86cd799439014"
+    };
+    axiosMock.onGet("/manifests/item-capacity-used").reply(expectRequest({
+      statusCode: 200, token, jwtToken
+    }));
+    const call = await api.operations.manifest.itemCapacityUsed({
+      token, jwtToken, query
+    });
+    assert.deepStrictEqual(call.config.params, query);
+    return call;
+  });
+
   it("should get many manifests", () => {
     const data = {
       query: [{

package/types/endpoints/notifications/salesforce.d.ts

@@ -4,7 +4,7 @@ export = salesforceFactory;
  * @param {Object} deps
  * @param {import("axios").AxiosInstance} deps.client
  * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
- * @returns {{ sms: { create: function } }}
+ * @returns {{ sms: { create: function, deliveries: { get: function } } }}
  */
 declare function salesforceFactory({ client, internalAuthTokenProvider }: {
     client: import("axios").AxiosInstance;
@@ -14,5 +14,8 @@ declare function salesforceFactory({ client, internalAuthTokenProvider }: {
 }): {
     sms: {
         create: Function;
+        deliveries: {
+            get: Function;
+        };
     };
 };