btrz-api-client 9.12.0 → 9.14.0

package/lib/client.js

@@ -536,6 +536,10 @@ function createAccounts({
       client,
       internalAuthTokenProvider
     }),
+    qrMappings: require("./endpoints/accounts/qr-mappings.js")({
+      client,
+      internalAuthTokenProvider
+    }),
     emailSettings: require("./endpoints/accounts/email-settings.js")({
       client,
       internalAuthTokenProvider

package/lib/endpoints/accounts/qr-mappings.js

@@ -0,0 +1,167 @@
+const {
+  authorizationHeaders
+} = require("../endpoints_helpers.js");
+
+/**
+ * Query params for GET /qr-mappings (btrz-api-accounts). See get-handler getSpec().
+ * @typedef {Object} QrMappingsListQuery
+ * @property {number} [page] - 1-based page for pagination
+ */
+
+/**
+ * Factory for qr-mappings API (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ get: function, all: function, create: function, update: function, remove: function }}
+ */
+function qrMappingsFactory({
+  client,
+  internalAuthTokenProvider
+}) {
+  /**
+   * GET /qr-mappings/:qrMappingId - get a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.qrMappingId - QR mapping id (ObjectId)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function get({
+    token,
+    jwtToken,
+    qrMappingId,
+    headers
+  }) {
+    return client({
+      url: `/qr-mappings/${qrMappingId}`,
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      })
+    });
+  }
+
+  /**
+   * GET /qr-mappings - list QR mappings (paginated when page is provided).
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {QrMappingsListQuery} [opts.query] - Query params (page)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function all({
+    token,
+    jwtToken,
+    query = {},
+    headers
+  }) {
+    return client({
+      url: "/qr-mappings",
+      params: query,
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      })
+    });
+  }
+
+  /**
+   * POST /qr-mappings - create a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} opts.data - QR mapping payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function create({
+    token,
+    jwtToken,
+    data,
+    headers
+  }) {
+    return client({
+      url: "/qr-mappings",
+      method: "post",
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      }),
+      data
+    });
+  }
+
+  /**
+   * PUT /qr-mappings/:qrMappingId - update a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.qrMappingId - QR mapping id (ObjectId)
+   * @param {Object} opts.data - QR mapping payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function update({
+    token,
+    jwtToken,
+    qrMappingId,
+    data,
+    headers
+  }) {
+    return client({
+      url: `/qr-mappings/${qrMappingId}`,
+      method: "put",
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      }),
+      data
+    });
+  }
+
+  /**
+   * DELETE /qr-mappings/:qrMappingId - delete a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.qrMappingId - QR mapping id (ObjectId)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function remove({
+    qrMappingId,
+    token,
+    jwtToken,
+    headers
+  }) {
+    return client({
+      url: `/qr-mappings/${qrMappingId}`,
+      method: "delete",
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      })
+    });
+  }
+  return {
+    get,
+    all,
+    create,
+    update,
+    remove
+  };
+}
+module.exports = qrMappingsFactory;

package/lib/endpoints/btrzpay/prismaTerminals.js

@@ -7,7 +7,6 @@ const {
  * @typedef {Object} PrismaTerminalsQuery
  * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers
  * @property {boolean} [validateRefund] - (PUT refunds only) If true, fetch current state from Prisma before applying
- * @property {boolean} [validatePayment] - (PUT payments only) If true, validate payment against the provider
  */
 
 /**
@@ -335,7 +334,7 @@ function prismaTerminalsFactory({
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.id - Payment id (prismaPaymentId)
      * @param {Object} opts.prismaPayment - Prisma payment payload
-     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId, validatePayment)
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */

package/package.json

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

package/src/client.js

@@ -200,6 +200,7 @@ function createAccounts({baseURL, headers, timeout, overrideFn, internalAuthToke
     }),
     domains: require("./endpoints/accounts/domains.js")({client, internalAuthTokenProvider}),
     dynamicForms: require("./endpoints/accounts/dynamic-forms.js")({client, internalAuthTokenProvider}),
+    qrMappings: require("./endpoints/accounts/qr-mappings.js")({client, internalAuthTokenProvider}),
     emailSettings: require("./endpoints/accounts/email-settings.js")({client, internalAuthTokenProvider}),
     emailTemplates: require("./endpoints/accounts/email-templates.js")({client, internalAuthTokenProvider}),
     smsTemplates: require("./endpoints/accounts/sms-templates.js")({client, internalAuthTokenProvider}),

package/src/endpoints/accounts/qr-mappings.js

@@ -0,0 +1,107 @@
+const {authorizationHeaders} = require("../endpoints_helpers.js");
+
+/**
+ * Query params for GET /qr-mappings (btrz-api-accounts). See get-handler getSpec().
+ * @typedef {Object} QrMappingsListQuery
+ * @property {number} [page] - 1-based page for pagination
+ */
+
+/**
+ * Factory for qr-mappings API (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ get: function, all: function, create: function, update: function, remove: function }}
+ */
+function qrMappingsFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /qr-mappings/:qrMappingId - get a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.qrMappingId - QR mapping id (ObjectId)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function get({token, jwtToken, qrMappingId, headers}) {
+    return client({
+      url: `/qr-mappings/${qrMappingId}`,
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  /**
+   * GET /qr-mappings - list QR mappings (paginated when page is provided).
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {QrMappingsListQuery} [opts.query] - Query params (page)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function all({token, jwtToken, query = {}, headers}) {
+    return client({
+      url: "/qr-mappings",
+      params: query,
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  /**
+   * POST /qr-mappings - create a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {Object} opts.data - QR mapping payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function create({token, jwtToken, data, headers}) {
+    return client({
+      url: "/qr-mappings",
+      method: "post",
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      data
+    });
+  }
+
+  /**
+   * PUT /qr-mappings/:qrMappingId - update a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.qrMappingId - QR mapping id (ObjectId)
+   * @param {Object} opts.data - QR mapping payload
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function update({token, jwtToken, qrMappingId, data, headers}) {
+    return client({
+      url: `/qr-mappings/${qrMappingId}`,
+      method: "put",
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers}),
+      data
+    });
+  }
+
+  /**
+   * DELETE /qr-mappings/:qrMappingId - delete a QR mapping.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.qrMappingId - QR mapping id (ObjectId)
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse>}
+   */
+  function remove({qrMappingId, token, jwtToken, headers}) {
+    return client({
+      url: `/qr-mappings/${qrMappingId}`,
+      method: "delete",
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  return {get, all, create, update, remove};
+}
+
+module.exports = qrMappingsFactory;

package/src/endpoints/btrzpay/prismaTerminals.js

@@ -7,7 +7,6 @@ const {
  * @typedef {Object} PrismaTerminalsQuery
  * @property {string} [providerId] - Account provider (operator) ID; used by agencies/sellers
  * @property {boolean} [validateRefund] - (PUT refunds only) If true, fetch current state from Prisma before applying
- * @property {boolean} [validatePayment] - (PUT payments only) If true, validate payment against the provider
  */
 
 /**
@@ -213,7 +212,7 @@ function prismaTerminalsFactory({client, internalAuthTokenProvider}) {
      * @param {string} [opts.jwtToken] - JWT or internal auth symbol
      * @param {string} opts.id - Payment id (prismaPaymentId)
      * @param {Object} opts.prismaPayment - Prisma payment payload
-     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId, validatePayment)
+     * @param {PrismaTerminalsQuery} [opts.query] - Query params (providerId)
      * @param {Object} [opts.headers] - Optional headers
      * @returns {Promise<import("axios").AxiosResponse>}
      */

package/test/all.test.js

@@ -10,6 +10,7 @@ require("./endpoints/accounts/current-shifts.test.js");
 require("./endpoints/accounts/customers.js");
 require("./endpoints/accounts/domains.test.js");
 require("./endpoints/accounts/dynamic-forms.test.js");
+require("./endpoints/accounts/qr-mappings.test.js");
 require("./endpoints/accounts/email-templates.test.js");
 require("./endpoints/accounts/exchange-rates.test.js");
 require("./endpoints/accounts/exchange-receipts.test.js");

package/test/endpoints/accounts/qr-mappings.test.js

@@ -0,0 +1,73 @@
+const {axiosMock, expectRequest} = require("../../test-helpers.js");
+const api = require("../../../src/client.js").createApiClient({baseURL: "http://test.com"});
+
+describe("accounts/qr-mappings/", () => {
+  const token = "someToken";
+  const jwtToken = "I owe you a JWT token";
+
+  afterEach(() => {
+    axiosMock.restore();
+  });
+
+  it("should GET a list of qr mappings", () => {
+    axiosMock.onGet("/qr-mappings").reply(expectRequest({
+      statusCode: 200,
+      token
+    }));
+    return api.accounts.qrMappings.all({
+      token
+    });
+  });
+
+  it("should GET a list of qr mappings with page query", () => {
+    const query = {page: 2};
+    axiosMock.onGet("/qr-mappings").reply(expectRequest({
+      statusCode: 200,
+      token,
+      query
+    }));
+    return api.accounts.qrMappings.all({
+      token,
+      query
+    });
+  });
+
+  it("should GET the qr mapping", () => {
+    const qrMappingId = "123";
+    axiosMock.onGet(`/qr-mappings/${qrMappingId}`)
+      .reply(expectRequest({statusCode: 200, token}));
+    return api.accounts.qrMappings.get({token, jwtToken, qrMappingId});
+  });
+
+  it("should create qr mapping", () => {
+    const data = {name: "mapping", separator: "|", segments: []};
+    axiosMock.onPost("/qr-mappings").reply(expectRequest({statusCode: 200, token, jwtToken, body: data}));
+    return api.accounts.qrMappings.create({
+      jwtToken,
+      token,
+      data
+    });
+  });
+
+  it("should update qr mapping", () => {
+    const qrMappingId = "123";
+    const data = {name: "updated", separator: "-", segments: []};
+    axiosMock.onPut(`/qr-mappings/${qrMappingId}`).reply(expectRequest({statusCode: 200, token, jwtToken, body: data}));
+    return api.accounts.qrMappings.update({
+      jwtToken,
+      qrMappingId,
+      token,
+      data
+    });
+  });
+
+  it("should delete qr mapping", () => {
+    const qrMappingId = "123";
+    axiosMock.onDelete(`/qr-mappings/${qrMappingId}`).reply(expectRequest({statusCode: 200, token, jwtToken}));
+    return api.accounts.qrMappings.remove({
+      jwtToken,
+      qrMappingId,
+      token
+    });
+  });
+});