btrz-api-client 9.20.0 → 9.22.0

package/lib/client.js

@@ -501,6 +501,10 @@ function createAccounts({
       client,
       internalAuthTokenProvider
     }),
+    auditRecords: require("./endpoints/accounts/audit-records.js")({
+      client,
+      internalAuthTokenProvider
+    }),
     application: require("./endpoints/accounts/application.js")({
       client,
       internalAuthTokenProvider

package/lib/endpoints/accounts/audit-records.js

@@ -0,0 +1,60 @@
+const {
+  authorizationHeaders
+} = require("./../endpoints_helpers.js");
+
+/**
+ * Factory for audit-records API (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ get: function }}
+ */
+function auditRecordsFactory({
+  client,
+  internalAuthTokenProvider
+}) {
+  /**
+   * GET /audit-records/:providerId/:folder/:itemId – get audit events for one object.
+   * Requires BETTEREZ_APP JWT. No query params.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.providerId - Account (provider) ID
+   * @param {string} opts.folder - Audit folder / entity name
+   * @param {string} opts.itemId - Audited object ID
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse<{
+   *   accountId: string,
+   *   folder: string,
+   *   objectId: string,
+   *   events: Array<{
+   *     ts: string,
+   *     userId: string,
+   *     operation: string,
+   *     changes: Array<{path: string, from: *, to: *}>
+   *   }>
+   * }>>}
+   */
+  function get({
+    token,
+    jwtToken,
+    providerId,
+    folder,
+    itemId,
+    headers
+  }) {
+    return client({
+      url: `/audit-records/${providerId}/${folder}/${itemId}`,
+      headers: authorizationHeaders({
+        token,
+        jwtToken,
+        internalAuthTokenProvider,
+        headers
+      })
+    });
+  }
+  return {
+    get
+  };
+}
+module.exports = auditRecordsFactory;

package/lib/endpoints/notifications/notify.js

@@ -32,12 +32,8 @@ const {
  * @typedef {Object} NotifyWhatsappPostData
  * @property {string} type - Document/template type (e.g. product, voucher, order)
  * @property {string} itemId - ObjectId of the item (24-char hex)
- * @property {string} [templateType] - Accounts template type when it differs from `type` (same enum as GET /sms-templates/types). Twilio only: the Salesforce branch uses the Meta approved template referenced by the account `waDefinitionKey`
  * @property {string} [to] - Recipient phone (E.164). Optional; derived from item when omitted. The Salesforce branch only supports Mexican numbers with the 52 country code (12 digits starting with 52)
- * @property {string} [lang] - ISO language code. Twilio only: used for template selection
- * @property {string} [channel] - Channel filter for template selection. Twilio only
  * @property {string} [family] - Required when type is 'product'. One of: ticket, reservation, paid in, paid out, parcel, flexpass, bundle
- * @property {string} [humanDate] - "mm" | "dd". Twilio only
  */
 
 /**
@@ -337,12 +333,12 @@ function notifyTicketFactory({
     whatsapp: {
       /**
        * POST /notify/whatsapp - sends WhatsApp notification specifying document type and id
-       * Uses the account's WhatsApp provider: for Twilio it uses the most relevant published SMS template;
-       * for Salesforce it uses a Meta approved WhatsApp template configured via `waDefinitionKey` in the account.
+       * Uses the account's WhatsApp provider: for Salesforce it uses a Meta approved WhatsApp template
+       * configured via `waDefinitionKey` in the account.
        * @param {Object} opts
        * @param {string} [opts.token] - API key
        * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-       * @param {NotifyWhatsappPostData} opts.data - Request body (type, itemId; optional templateType, to, lang, channel, family, humanDate)
+       * @param {NotifyWhatsappPostData} opts.data - Request body (type, itemId; optional to, family)
        * @param {Object} [opts.headers] - Optional headers
        * @returns {Promise<import("axios").AxiosResponse<{ success: boolean }>>}
        */

package/package.json

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

package/src/client.js

@@ -189,6 +189,7 @@ function createAccounts({baseURL, headers, timeout, overrideFn, internalAuthToke
     agencies: require("./endpoints/accounts/agencies.js")({client, internalAuthTokenProvider}),
     agencyTypes: require("./endpoints/accounts/agency-types.js")({client, internalAuthTokenProvider}),
     authorizedExternalMessaging: require("./endpoints/accounts/authorized-external-messaging.js")({client, internalAuthTokenProvider}),
+    auditRecords: require("./endpoints/accounts/audit-records.js")({client, internalAuthTokenProvider}),
     application: require("./endpoints/accounts/application.js")({client, internalAuthTokenProvider}),
     applications: require("./endpoints/accounts/applications.js")({client, internalAuthTokenProvider}),
     applicationSettings: require("./endpoints/accounts/application-settings.js")({client, internalAuthTokenProvider}),

package/src/endpoints/accounts/audit-records.js

@@ -0,0 +1,45 @@
+const {authorizationHeaders} = require("./../endpoints_helpers.js");
+
+/**
+ * Factory for audit-records API (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ get: function }}
+ */
+function auditRecordsFactory({client, internalAuthTokenProvider}) {
+  /**
+   * GET /audit-records/:providerId/:folder/:itemId – get audit events for one object.
+   * Requires BETTEREZ_APP JWT. No query params.
+   * @param {Object} opts
+   * @param {string} [opts.token] - API key
+   * @param {string} [opts.jwtToken] - JWT or internal auth symbol
+   * @param {string} opts.providerId - Account (provider) ID
+   * @param {string} opts.folder - Audit folder / entity name
+   * @param {string} opts.itemId - Audited object ID
+   * @param {Object} [opts.headers] - Optional headers
+   * @returns {Promise<import("axios").AxiosResponse<{
+   *   accountId: string,
+   *   folder: string,
+   *   objectId: string,
+   *   events: Array<{
+   *     ts: string,
+   *     userId: string,
+   *     operation: string,
+   *     changes: Array<{path: string, from: *, to: *}>
+   *   }>
+   * }>>}
+   */
+  function get({token, jwtToken, providerId, folder, itemId, headers}) {
+    return client({
+      url: `/audit-records/${providerId}/${folder}/${itemId}`,
+      headers: authorizationHeaders({token, jwtToken, internalAuthTokenProvider, headers})
+    });
+  }
+
+  return {
+    get
+  };
+}
+
+module.exports = auditRecordsFactory;

package/src/endpoints/notifications/notify.js

@@ -32,12 +32,8 @@ const {
  * @typedef {Object} NotifyWhatsappPostData
  * @property {string} type - Document/template type (e.g. product, voucher, order)
  * @property {string} itemId - ObjectId of the item (24-char hex)
- * @property {string} [templateType] - Accounts template type when it differs from `type` (same enum as GET /sms-templates/types). Twilio only: the Salesforce branch uses the Meta approved template referenced by the account `waDefinitionKey`
  * @property {string} [to] - Recipient phone (E.164). Optional; derived from item when omitted. The Salesforce branch only supports Mexican numbers with the 52 country code (12 digits starting with 52)
- * @property {string} [lang] - ISO language code. Twilio only: used for template selection
- * @property {string} [channel] - Channel filter for template selection. Twilio only
  * @property {string} [family] - Required when type is 'product'. One of: ticket, reservation, paid in, paid out, parcel, flexpass, bundle
- * @property {string} [humanDate] - "mm" | "dd". Twilio only
  */
 
 /**
@@ -247,12 +243,12 @@ function notifyTicketFactory({
     whatsapp: {
       /**
        * POST /notify/whatsapp - sends WhatsApp notification specifying document type and id
-       * Uses the account's WhatsApp provider: for Twilio it uses the most relevant published SMS template;
-       * for Salesforce it uses a Meta approved WhatsApp template configured via `waDefinitionKey` in the account.
+       * Uses the account's WhatsApp provider: for Salesforce it uses a Meta approved WhatsApp template
+       * configured via `waDefinitionKey` in the account.
        * @param {Object} opts
        * @param {string} [opts.token] - API key
        * @param {string} [opts.jwtToken] - JWT or internal auth symbol
-       * @param {NotifyWhatsappPostData} opts.data - Request body (type, itemId; optional templateType, to, lang, channel, family, humanDate)
+       * @param {NotifyWhatsappPostData} opts.data - Request body (type, itemId; optional to, family)
        * @param {Object} [opts.headers] - Optional headers
        * @returns {Promise<import("axios").AxiosResponse<{ success: boolean }>>}
        */

package/test/all.test.js

@@ -5,6 +5,7 @@ require("./endpoints/accounts/accounts.js");
 require("./endpoints/accounts/agencies.test.js");
 require("./endpoints/accounts/agency-types.test.js");
 require("./endpoints/accounts/application-settings.test.js");
+require("./endpoints/accounts/audit-records.test.js");
 require("./endpoints/accounts/applications.test.js");
 require("./endpoints/accounts/current-shifts.test.js");
 require("./endpoints/accounts/customers.js");

package/test/endpoints/accounts/audit-records.test.js

@@ -0,0 +1,54 @@
+const assert = require("node:assert/strict");
+const {axiosMock, expectRequest} = require("./../../test-helpers.js");
+const api = require("./../../../src/client.js").createApiClient({baseURL: "http://test.com"});
+
+describe("accounts/audit-records", () => {
+  const token = "I owe you a token";
+  const jwtToken = "secret";
+
+  afterEach(() => {
+    axiosMock.reset();
+  });
+
+  it("should GET audit records by providerId, folder, and itemId", () => {
+    const providerId = "507f1f77bcf86cd799439011";
+    const folder = "fares";
+    const itemId = "64f1aaaaaaaaaaaaaaaaaaaa";
+    const auditRecord = {
+      accountId: providerId,
+      folder,
+      objectId: itemId,
+      events: [{
+        ts: "2026-08-14T08:03:12.123Z",
+        userId: "user-1",
+        operation: "update",
+        changes: [{path: "name", from: "A", to: "B"}]
+      }]
+    };
+
+    axiosMock.onGet(`/audit-records/${providerId}/${folder}/${itemId}`)
+      .reply((config) => {
+        const result = expectRequest({
+          statusCode: 200,
+          token,
+          jwtToken,
+          requireJwtTokenOnGet: true
+        })(config);
+        if (result[0] !== 200) {
+          return result;
+        }
+        return [200, auditRecord];
+      });
+
+    return api.accounts.auditRecords.get({
+      token,
+      jwtToken,
+      providerId,
+      folder,
+      itemId
+    }).then((res) => {
+      assert.deepStrictEqual(res.status, 200);
+      assert.deepStrictEqual(res.data, auditRecord);
+    });
+  });
+});

package/types/endpoints/accounts/audit-records.d.ts

@@ -0,0 +1,16 @@
+export = auditRecordsFactory;
+/**
+ * Factory for audit-records API (btrz-api-accounts).
+ * @param {Object} deps
+ * @param {import("axios").AxiosInstance} deps.client
+ * @param {{ getToken: function(): string }} [deps.internalAuthTokenProvider]
+ * @returns {{ get: function }}
+ */
+declare function auditRecordsFactory({ client, internalAuthTokenProvider }: {
+    client: import("axios").AxiosInstance;
+    internalAuthTokenProvider?: {
+        getToken: () => string;
+    };
+}): {
+    get: Function;
+};