btrz-api-client 8.59.0 → 8.61.0

package/lib/endpoints/inventory/external-wallets.js

@@ -21,7 +21,8 @@ var _require = require("../endpoints_helpers.js"),
  * @returns {{
  *   saldoMax: {
  *     all: function, get: function, create: function, update: function,
- *     nip: object, authorization: { create: function }, movements: { create: function }
+ *     nip: object, authorization: { create: function }, movements: { create: function },
+ *     statements: { create: function }
  *   }
  * }}
  */
@@ -34,7 +35,7 @@ function externalWalletsFactory(_ref) {
   /**
    * @type {{
    *   all: function, create: function, get: function, update: function,
-   *   nip: object, authorization: { create: function }, movements: object
+   *   nip: object, authorization: { create: function }, movements: object, statements: { create: function }
    * }}
    */
   var saldoMax = {
@@ -225,6 +226,39 @@ function externalWalletsFactory(_ref) {
           data: { movement: movement }
         });
       }
+    },
+    /** @type {{ create: function }} */
+    statements: {
+      /**
+       * POST /external-wallets/saldo-max/:walletId/statements — Saldo Max wallet statements (Inventory → ADO ConsultaSaldoHistorial).
+       * Optional `statementRequest`: `sendMail` (ADO may email history), `page` / `limit` (pagination strings per ADO).
+       * Response: `statement` plus `count`, `next`, `previous` (Inventory paginated shape).
+       * @param {Object} opts
+       * @param {string} [opts.token] - API key
+       * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+       * @param {string} opts.walletId - Saldo Max wallet id (idWallet)
+       * @param {{ sendMail?: boolean, page?: string, limit?: string }} [opts.statementRequest] -
+       *   optional body (sent as `{ statementRequest }` in JSON)
+       * @param {Object} [opts.headers] - Optional headers
+       * @returns {Promise<import("axios").AxiosResponse<{
+       *   statement: Object, count: number, next?: string, previous?: string
+       * }>>}
+       * @throws When response is 4xx/5xx (400 INVALID_WALLET_ID; 401; 404; 502; 503; 500)
+       */
+      create: function create(_ref9) {
+        var token = _ref9.token,
+            jwtToken = _ref9.jwtToken,
+            walletId = _ref9.walletId,
+            statementRequest = _ref9.statementRequest,
+            headers = _ref9.headers;
+
+        return client({
+          url: "/external-wallets/saldo-max/" + walletId + "/statements",
+          method: "post",
+          headers: authorizationHeaders({ token: token, jwtToken: jwtToken, internalAuthTokenProvider: internalAuthTokenProvider, headers: headers }),
+          data: statementRequest != null ? { statementRequest: statementRequest } : {}
+        });
+      }
     }
   };
 

package/lib/endpoints/notifications/pdfs.js

@@ -7,7 +7,7 @@ var _require = require("./../endpoints_helpers.js"),
 /**
  * Query params for GET pdf-templates-processing binary routes (btrz-api-notifications). Client uses type/family to resolve path.
  * @typedef {Object} PdfGetQuery
- * @property {string} type - Document type (e.g. product, giftCertificate, voucher, transaction, ssr, manifest, passengersManifest, order, shift, remainderSlip, exchange, invoice, locationClosure, parcelManifest, startingBalance, partialShiftDeposits, shiftLocationClosure, bankDepositSlip, terminalVoucher, manualTickets)
+ * @property {string} type - Document type (e.g. product, giftCertificate, voucher, transaction, ssr, manifest, passengersManifest, order, shift, remainderSlip, exchange, invoice, locationClosure, parcelManifest, startingBalance, partialShiftDeposits, shiftLocationClosure, bankDepositSlip, terminalVoucher, manualTickets, externalWalletVoucher)
  * @property {string} [family] - When type is "product": "ticket" | "reservation" | "paid in" | "paid out" | "parcel" | "flexpass" | "bundle"
  */
 
@@ -130,6 +130,9 @@ function pdfFactory(_ref) {
     if (query.type === "manualTickets") {
       url = "/pdf-manual-tickets/" + itemId;
     }
+    if (query.type === "externalWalletVoucher") {
+      url = "/pdf-external-wallet-voucher/" + itemId;
+    }
 
     return client.get(url, {
       params: query,

package/package.json

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

package/src/endpoints/inventory/external-wallets.js

@@ -20,7 +20,8 @@ const {
  * @returns {{
  *   saldoMax: {
  *     all: function, get: function, create: function, update: function,
- *     nip: object, authorization: { create: function }, movements: { create: function }
+ *     nip: object, authorization: { create: function }, movements: { create: function },
+ *     statements: { create: function }
  *   }
  * }}
  */
@@ -28,7 +29,7 @@ function externalWalletsFactory({client, internalAuthTokenProvider}) {
   /**
    * @type {{
    *   all: function, create: function, get: function, update: function,
-   *   nip: object, authorization: { create: function }, movements: object
+   *   nip: object, authorization: { create: function }, movements: object, statements: { create: function }
    * }}
    */
   const saldoMax = {
@@ -179,6 +180,33 @@ function externalWalletsFactory({client, internalAuthTokenProvider}) {
           data: {movement}
         });
       }
+    },
+    /** @type {{ create: function }} */
+    statements: {
+      /**
+       * POST /external-wallets/saldo-max/:walletId/statements — Saldo Max wallet statements (Inventory → ADO ConsultaSaldoHistorial).
+       * Optional `statementRequest`: `sendMail` (ADO may email history), `page` / `limit` (pagination strings per ADO).
+       * Response: `statement` plus `count`, `next`, `previous` (Inventory paginated shape).
+       * @param {Object} opts
+       * @param {string} [opts.token] - API key
+       * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+       * @param {string} opts.walletId - Saldo Max wallet id (idWallet)
+       * @param {{ sendMail?: boolean, page?: string, limit?: string }} [opts.statementRequest] -
+       *   optional body (sent as `{ statementRequest }` in JSON)
+       * @param {Object} [opts.headers] - Optional headers
+       * @returns {Promise<import("axios").AxiosResponse<{
+       *   statement: Object, count: number, next?: string, previous?: string
+       * }>>}
+       * @throws When response is 4xx/5xx (400 INVALID_WALLET_ID; 401; 404; 502; 503; 500)
+       */
+      create: ({token, jwtToken, walletId, statementRequest, headers}) => {
+        return client({
+          url: `/external-wallets/saldo-max/${walletId}/statements`,
+          method: "post",
+          headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+          data: statementRequest != null ? {statementRequest} : {}
+        });
+      }
     }
   };
 

package/src/endpoints/notifications/pdfs.js

@@ -6,7 +6,7 @@ const {
 /**
  * Query params for GET pdf-templates-processing binary routes (btrz-api-notifications). Client uses type/family to resolve path.
  * @typedef {Object} PdfGetQuery
- * @property {string} type - Document type (e.g. product, giftCertificate, voucher, transaction, ssr, manifest, passengersManifest, order, shift, remainderSlip, exchange, invoice, locationClosure, parcelManifest, startingBalance, partialShiftDeposits, shiftLocationClosure, bankDepositSlip, terminalVoucher, manualTickets)
+ * @property {string} type - Document type (e.g. product, giftCertificate, voucher, transaction, ssr, manifest, passengersManifest, order, shift, remainderSlip, exchange, invoice, locationClosure, parcelManifest, startingBalance, partialShiftDeposits, shiftLocationClosure, bankDepositSlip, terminalVoucher, manualTickets, externalWalletVoucher)
  * @property {string} [family] - When type is "product": "ticket" | "reservation" | "paid in" | "paid out" | "parcel" | "flexpass" | "bundle"
  */
 
@@ -126,6 +126,9 @@ function pdfFactory({
     if (query.type === "manualTickets") {
       url = `/pdf-manual-tickets/${itemId}`;
     }
+    if (query.type === "externalWalletVoucher") {
+      url = `/pdf-external-wallet-voucher/${itemId}`;
+    }
 
     return client.get(url, {
       params: query,

package/test/endpoints/inventory/external-wallets.test.js

@@ -188,5 +188,35 @@ describe("inventory/external-wallets", () => {
         movement
       });
     });
+
+    it("should post wallet statement with statementRequest (e.g. sendMail)", async () => {
+      const walletId = "wallet-stmt-1";
+      const statementRequest = {sendMail: true};
+
+      axiosMock.onPost(`/external-wallets/saldo-max/${walletId}/statements`).reply(expectRequest({
+        statusCode: 200, token, jwtToken, body: {statementRequest}
+      }));
+
+      return api.inventory.externalWallets.saldoMax.statements.create({
+        jwtToken,
+        token,
+        walletId,
+        statementRequest
+      });
+    });
+
+    it("should post wallet statement with empty body when statementRequest omitted", async () => {
+      const walletId = "wallet-stmt-2";
+
+      axiosMock.onPost(`/external-wallets/saldo-max/${walletId}/statements`).reply(expectRequest({
+        statusCode: 200, token, jwtToken, body: {}
+      }));
+
+      return api.inventory.externalWallets.saldoMax.statements.create({
+        jwtToken,
+        token,
+        walletId
+      });
+    });
   });
 });