cozy-client 30.0.0 → 31.0.0

package/dist/CozyClient.js

@@ -2550,7 +2550,7 @@ var CozyClient = /*#__PURE__*/function () {
 CozyClient.hooks = CozyClient.hooks || {};
 CozyClient.fetchPolicies = _policies.default; //COZY_CLIENT_VERSION_PACKAGE in replaced by babel. See babel config
 
-CozyClient.version = "30.0.0";
+CozyClient.version = "31.0.0";
 
 _microee.default.mixin(CozyClient);
 

package/dist/models/dacc.js

@@ -5,7 +5,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.sendMeasureToDACC = exports.checkMeasureParams = void 0;
+exports.fetchAggregatesFromDACC = exports.buildAggregateParams = exports.sendMeasureToDACC = exports.checkMeasureParams = exports.isCorrectDateFormat = void 0;
 
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 
@@ -15,11 +15,31 @@ var _cozyLogger = _interopRequireDefault(require("cozy-logger"));
 
 var _types = require("../types");
 
+var _CozyClient = _interopRequireDefault(require("../CozyClient"));
+
+/**
+ * Check whether or not the given date is in YYYY-MM-DD format
+ *
+ * @param {string} date - The date to check
+ * @returns {boolean}
+ */
+var isCorrectDateFormat = function isCorrectDateFormat(date) {
+  try {
+    var parsedDate = new Date(Date.parse(date));
+    return !!parsedDate.toISOString().startsWith(date);
+  } catch (err) {
+    return false;
+  }
+};
 /**
  * Throw an errror if a DACC parameter is incorrect.
  *
  * @param { DACCMeasure} measure - The DACC measure
  */
+
+
+exports.isCorrectDateFormat = isCorrectDateFormat;
+
 var checkMeasureParams = function checkMeasureParams(measure) {
   var createdBy = measure.createdBy,
       measureName = measure.measureName,
@@ -41,9 +61,7 @@ var checkMeasureParams = function checkMeasureParams(measure) {
     throw new Error('Missing parameter: startDate');
   }
 
-  var parsedDate = new Date(Date.parse(startDate));
-
-  if (!parsedDate.toISOString().startsWith(startDate)) {
+  if (!isCorrectDateFormat(startDate)) {
     throw new Error('Date should be in YYYY-MM-DD format');
   }
 
@@ -62,7 +80,7 @@ var checkMeasureParams = function checkMeasureParams(measure) {
 /**
  * Send measures to a DACC through a remote doctype
  *
- * @param {object} client - The CozyClient instance
+ * @param {CozyClient} client - The CozyClient instance
  * @param {string} remoteDoctype - The remote doctype to use
  * @param {DACCMeasure} measure - The DACC measure
  */
@@ -80,7 +98,8 @@ var sendMeasureToDACC = /*#__PURE__*/function () {
             checkMeasureParams(measure);
             _context.next = 4;
             return client.getStackClient().fetchJSON('POST', "/remote/".concat(remoteDoctype), {
-              data: JSON.stringify(measure)
+              data: JSON.stringify(measure),
+              path: 'measure'
             });
 
           case 4:
@@ -105,5 +124,90 @@ var sendMeasureToDACC = /*#__PURE__*/function () {
     return _ref.apply(this, arguments);
   };
 }();
+/**
+ * Build parameters to request DACC aggregate
+ *
+ *
+ * @typedef Params - The unformatted DACC aggregate params
+ * @property {string} [measureName] - The measure name
+ * @property {string} [startDate]   - The measure start date
+ * @property {string} [endDate]     - The measure end date
+ *
+ * @param {Params} params - The unformatted DACC aggregate params
+ * @returns {DACCAggregatesParams}
+ */
+
+
+exports.sendMeasureToDACC = sendMeasureToDACC;
+
+var buildAggregateParams = function buildAggregateParams(params) {
+  var measureName = params.measureName;
+
+  if (!measureName || typeof measureName !== 'string') {
+    throw new Error('Missing or wrong type parameter: measureName');
+  }
+
+  var startDate = params.startDate || new Date(0).toISOString();
+  var endDate = params.endDate || new Date(Date.now()).toISOString();
+
+  if (!isCorrectDateFormat(startDate) || !isCorrectDateFormat(endDate)) {
+    (0, _cozyLogger.default)('error', "Date should be in YYYY-MM-DD format but received: startDate: ".concat(startDate, " | endDate: ").concat(endDate));
+    throw new Error('Date should be in YYYY-MM-DD format');
+  }
+
+  return {
+    measureName: measureName,
+    startDate: startDate,
+    endDate: endDate
+  };
+};
+/**
+ * Send measures to a DACC through a remote doctype
+ *
+ * @param {CozyClient} client - The CozyClient instance
+ * @param {string} remoteDoctype - The remote doctype to use
+ * @param {DACCAggregatesParams} params - The request params
+ */
+
+
+exports.buildAggregateParams = buildAggregateParams;
+
+var fetchAggregatesFromDACC = /*#__PURE__*/function () {
+  var _ref2 = (0, _asyncToGenerator2.default)( /*#__PURE__*/_regenerator.default.mark(function _callee2(client, remoteDoctype, params) {
+    var aggregateParams;
+    return _regenerator.default.wrap(function _callee2$(_context2) {
+      while (1) {
+        switch (_context2.prev = _context2.next) {
+          case 0:
+            _context2.prev = 0;
+            aggregateParams = buildAggregateParams(params);
+            _context2.next = 4;
+            return client.getStackClient().fetchJSON('POST', "/remote/".concat(remoteDoctype), {
+              data: JSON.stringify(aggregateParams),
+              path: 'aggregate'
+            });
+
+          case 4:
+            _context2.next = 10;
+            break;
+
+          case 6:
+            _context2.prev = 6;
+            _context2.t0 = _context2["catch"](0);
+            (0, _cozyLogger.default)('error', "Error while fetching aggregates to remote doctype: ".concat(_context2.t0.message));
+            throw _context2.t0;
+
+          case 10:
+          case "end":
+            return _context2.stop();
+        }
+      }
+    }, _callee2, null, [[0, 6]]);
+  }));
+
+  return function fetchAggregatesFromDACC(_x4, _x5, _x6) {
+    return _ref2.apply(this, arguments);
+  };
+}();
 
-exports.sendMeasureToDACC = sendMeasureToDACC;
+exports.fetchAggregatesFromDACC = fetchAggregatesFromDACC;

package/dist/models/dacc.spec.js

@@ -1,6 +1,6 @@
-import { checkMeasureParams } from './dacc'
+import { checkMeasureParams, buildAggregateParams } from './dacc'
 
-describe('dacc', () => {
+describe('checkMeasureParams', () => {
   const measure = {
     value: 42,
     measureName: 'theanswer',
@@ -104,3 +104,55 @@ describe('dacc', () => {
     ).toThrow()
   })
 })
+
+describe('buildAggregateParams', () => {
+  beforeAll(() => {
+    jest
+      .spyOn(global.Date, 'now')
+      .mockImplementation(() => new Date(2022, 5, 1).valueOf())
+  })
+  it('should throw if measure name is not correct', () => {
+    expect(() => buildAggregateParams({})).toThrow()
+    expect(() => buildAggregateParams({ measurName: 42 })).toThrow()
+  })
+
+  it('should throw if dates are not correct', () => {
+    expect(() =>
+      buildAggregateParams({
+        measureName: 'test',
+        startDate: 'Lundi 10 août 2021'
+      })
+    ).toThrow()
+    expect(() =>
+      buildAggregateParams({
+        measureName: 'test',
+        endDate: 'Lundi 10 août 2021'
+      })
+    ).toThrow()
+  })
+  it('should build dates if none provided', () => {
+    expect(buildAggregateParams({ measureName: 'test' })).toEqual({
+      measureName: 'test',
+      startDate: '1970-01-01T00:00:00.000Z',
+      endDate: new Date(2022, 5, 1).toISOString()
+    })
+  })
+  it('should build dates if startDate provided', () => {
+    expect(
+      buildAggregateParams({ measureName: 'test', startDate: '2021-08-10' })
+    ).toEqual({
+      measureName: 'test',
+      startDate: '2021-08-10',
+      endDate: new Date(2022, 5, 1).toISOString()
+    })
+  })
+  it('should build dates if endDate provided', () => {
+    expect(
+      buildAggregateParams({ measureName: 'test', endDate: '2022-05-02' })
+    ).toEqual({
+      measureName: 'test',
+      startDate: '1970-01-01T00:00:00.000Z',
+      endDate: '2022-05-02'
+    })
+  })
+})

package/dist/types.js

@@ -329,6 +329,15 @@ var _dsl = require("./queries/dsl");
  * @property {object} group3 - Should be a {key: value} where the key is set in the measure definition.
  */
 
+/**
+ * @typedef {object} DACCAggregatesParams
+ * See https://github.com/cozy/DACC
+ *
+ * @property {string} measureName - It must match an existing measure name on the DACC server
+ * @property {string} startDate - Start of the aggregation period. Should be in YYYY-MM-DD format
+ * @property {string} endDate - End of the aggregation period. Should be in YYYY-MM-DD format
+ */
+
 /**
  * Receives the URL to present to the user as a parameter, and should return a promise that resolves with the URL the user was redirected to after accepting the permissions.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozy-client",
-  "version": "30.0.0",
+  "version": "31.0.0",
   "license": "MIT",
   "main": "dist/index.node.js",
   "browser": "dist/index.js",
@@ -18,7 +18,7 @@
     "@types/jest": "^26.0.20",
     "@types/lodash": "^4.14.170",
     "btoa": "^1.2.1",
-    "cozy-stack-client": "^30.0.0",
+    "cozy-stack-client": "^31.0.0",
     "json-stable-stringify": "^1.0.1",
     "lodash": "^4.17.13",
     "microee": "^0.0.6",
@@ -73,5 +73,5 @@
     "react-native-ios11-devicecheck": "https://github.com/cozy/react-native-devicecheck#app-attest-v0.1"
   },
   "sideEffects": false,
-  "gitHead": "eb60edf72cb815882e8adb04e52a70c31f090e67"
+  "gitHead": "3d72a338ddcd4cfbedc9203634dff5125c5e3fd1"
 }

package/types/models/dacc.d.ts

@@ -1,3 +1,25 @@
+export function isCorrectDateFormat(date: string): boolean;
 export function checkMeasureParams(measure: DACCMeasure): void;
-export function sendMeasureToDACC(client: object, remoteDoctype: string, measure: DACCMeasure): Promise<void>;
+export function sendMeasureToDACC(client: CozyClient, remoteDoctype: string, measure: DACCMeasure): Promise<void>;
+export function buildAggregateParams(params: Params): DACCAggregatesParams;
+export function fetchAggregatesFromDACC(client: CozyClient, remoteDoctype: string, params: DACCAggregatesParams): Promise<void>;
+/**
+ * - The unformatted DACC aggregate params
+ */
+export type Params = {
+    /**
+     * - The measure name
+     */
+    measureName?: string;
+    /**
+     * - The measure start date
+     */
+    startDate?: string;
+    /**
+     * - The measure end date
+     */
+    endDate?: string;
+};
 import { DACCMeasure } from "../types";
+import CozyClient from "../CozyClient";
+import { DACCAggregatesParams } from "../types";

package/types/types.d.ts

@@ -390,6 +390,23 @@ export type DACCMeasure = {
      */
     group3: object;
 };
+/**
+ * See https://github.com/cozy/DACC
+ */
+export type DACCAggregatesParams = {
+    /**
+     * - It must match an existing measure name on the DACC server
+     */
+    measureName: string;
+    /**
+     * - Start of the aggregation period. Should be in YYYY-MM-DD format
+     */
+    startDate: string;
+    /**
+     * - End of the aggregation period. Should be in YYYY-MM-DD format
+     */
+    endDate: string;
+};
 /**
  * Receives the URL to present to the user as a parameter, and should return a promise that resolves with the URL the user was redirected to after accepting the permissions.
  */