cozy-client 27.3.0 → 27.5.0

package/CHANGELOG.md

@@ -3,6 +3,51 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [27.5.0](https://github.com/cozy/cozy-client/compare/v27.4.0...v27.5.0) (2021-12-01)
+
+
+### Features
+
+* Added referencedBy helpers ([2bd77e4](https://github.com/cozy/cozy-client/commit/2bd77e451eab26b85b21b41db522a7da6378672b))
+* Adding types around references ([6d9c8aa](https://github.com/cozy/cozy-client/commit/6d9c8aade0ece644674b9adfee1b08b8eff7482e))
+
+
+
+
+
+# [27.4.0](https://github.com/cozy/cozy-client/compare/v27.3.2...v27.4.0) (2021-11-25)
+
+
+### Features
+
+* onError Callback ([c5f65d3](https://github.com/cozy/cozy-client/commit/c5f65d33e0ab29a22b409365151173a3b7645b56))
+
+
+
+
+
+## [27.3.2](https://github.com/cozy/cozy-client/compare/v27.3.1...v27.3.2) (2021-11-17)
+
+
+### Bug Fixes
+
+* Login on RN iOS ([4b85b47](https://github.com/cozy/cozy-client/commit/4b85b475bf0c5b32f94a06e524fa7f0f5011f90e))
+
+
+
+
+
+## [27.3.1](https://github.com/cozy/cozy-client/compare/v27.3.0...v27.3.1) (2021-11-16)
+
+
+### Bug Fixes
+
+* Export Qualification ([3472bce](https://github.com/cozy/cozy-client/commit/3472bcec6ab3e19353a290e79189bf09c34b38b8))
+
+
+
+
+
 # [27.3.0](https://github.com/cozy/cozy-client/compare/v27.2.0...v27.3.0) (2021-11-16)
 
 

package/dist/CozyClient.js

@@ -128,7 +128,7 @@ var DOC_UPDATE = 'update';
  * @property {boolean} [autoHydrate]
  * @property {object} [oauth]
  * @property {Function} [onTokenRefresh]
- * @property {Function} [onTokenRefresh]
+ * @property {Function} [onError] - Default callback if a query is errored
  * @property  {Link}         [link]   - Backward compatibility
  * @property  {Array<Link>}  [links]  - List of links
  * @property  {object}       [schema] - Schema description for each doctypes
@@ -1276,10 +1276,32 @@ var CozyClient = /*#__PURE__*/function () {
               case 24:
                 _context8.prev = 24;
                 _context8.t0 = _context8["catch"](15);
-                this.dispatch((0, _store.receiveQueryError)(queryId, _context8.t0));
+                this.dispatch((0, _store.receiveQueryError)(queryId, _context8.t0)); // specific onError
+
+                if (!options.onError) {
+                  _context8.next = 31;
+                  break;
+                }
+
+                options.onError(_context8.t0); // defaulted onError
+
+                _context8.next = 36;
+                break;
+
+              case 31:
+                if (!this.options.onError) {
+                  _context8.next = 35;
+                  break;
+                }
+
+                this.options.onError(_context8.t0);
+                _context8.next = 36;
+                break;
+
+              case 35:
                 throw _context8.t0;
 
-              case 28:
+              case 36:
               case "end":
                 return _context8.stop();
             }
@@ -2256,6 +2278,21 @@ var CozyClient = /*#__PURE__*/function () {
         }));
       });
     }
+    /**
+     * At any time put an error function
+     *
+     * @param {Function} [onError] - Set a callback for queries which are errored
+     */
+
+  }, {
+    key: "setOnError",
+    value: function setOnError(onError) {
+      if (this.options && this.options.onError) {
+        throw new Error('On Error is already defined');
+      }
+
+      this.options.onError = onError;
+    }
   }, {
     key: "toJSON",
     value: function toJSON() {
@@ -2415,7 +2452,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 = "27.3.0";
+CozyClient.version = "27.5.0";
 
 _microee.default.mixin(CozyClient);
 

package/dist/CozyClient.spec.js

@@ -162,7 +162,6 @@ describe('CozyClient initialization', () => {
       })
     }
     const client = await CozyClient.fromOldOAuthClient(oldClient)
-    console.log({ stackClient: client.stackClient })
     expect(client.stackClient.uri).toBe(url)
     expect(client.stackClient.oauthOptions.clientID).toBe(oauth.clientID)
     expect(client.stackClient.token.accessToken).toBe(token.accessToken)
@@ -1402,6 +1401,54 @@ describe('CozyClient', () => {
         receiveQueryResult('allTodos', fakeResponse)
       )
     })
+
+    const setupOnError = () => {
+      const error = new TypeError('Failed to fetch')
+      requestHandler.mockReturnValueOnce(Promise.reject(error))
+      const onError = jest.fn().mockReturnValueOnce(() => true)
+      return onError
+    }
+
+    it('should call onError callback when an error is thrown. Callback passed as argument', async () => {
+      const onError = setupOnError()
+
+      await client.query(query, { as: 'allTodos', onError })
+      expect(onError).toBeCalled()
+    })
+
+    it('should call onError callback when an error is catched. It is passed during instantiation', async () => {
+      const onError = setupOnError()
+      const client = new CozyClient({ onError })
+
+      await client.query(query, { as: 'allTodos' })
+      expect(onError).toBeCalled()
+    })
+
+    it('should call onError callback when an error is catched. It is passed with setOnError', async () => {
+      const onError = setupOnError()
+      client.setOnError(onError)
+
+      await client.query(query, { as: 'allTodos' })
+      expect(onError).toBeCalled()
+    })
+
+    it('should throw an error when we call setOnError twice (or several times)', async () => {
+      const client = new CozyClient({})
+      const onError = () => true
+
+      const funcShouldThrow = () => client.setOnError(onError)
+      expect(funcShouldThrow).not.toThrow()
+      expect(funcShouldThrow).toThrow('On Error is already defined')
+    })
+
+    it('should throw an error when there is no onError callback', async () => {
+      const error = new TypeError('Failed to fetch')
+      requestHandler.mockReturnValueOnce(Promise.reject(error))
+
+      await expect(client.query(query, { as: 'allTodos' })).rejects.toThrow(
+        'Failed to fetch'
+      )
+    })
   })
 
   describe('queryAll', () => {

package/dist/associations/helpers.js

@@ -5,7 +5,7 @@ var _interopRequireDefault = require("@babel/runtime/helpers/interopRequireDefau
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.create = exports.resolveClass = exports.attachRelationships = exports.responseToRelationship = exports.pickTypeAndId = void 0;
+exports.getReferencedById = exports.getReferencedBy = exports.isReferencedById = exports.isReferencedBy = exports.create = exports.resolveClass = exports.attachRelationships = exports.responseToRelationship = exports.pickTypeAndId = void 0;
 
 var _defineProperty2 = _interopRequireDefault(require("@babel/runtime/helpers/defineProperty"));
 
@@ -25,6 +25,8 @@ var _HasManyInPlace = _interopRequireDefault(require("./HasManyInPlace"));
 
 var _HasManyFiles = _interopRequireDefault(require("./HasManyFiles"));
 
+var _types = require("../types");
+
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
 
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
@@ -124,5 +126,83 @@ var create = function create(target, _ref, accessors) {
 
   return new type(target, name, doctype, accessors);
 };
+/**
+ * Checks if the file is referenced by a specific doctype
+ *
+ * @param {IOCozyFile} file - io.cozy.files document
+ * @param {Doctype} referencedBy - Doctype where document is referenced
+ * @returns {boolean} If a reference is found
+ */
+
+
+exports.create = create;
+
+var isReferencedBy = function isReferencedBy(file, referencedBy) {
+  var _file$relationships, _file$relationships$r;
+
+  var references = (file === null || file === void 0 ? void 0 : (_file$relationships = file.relationships) === null || _file$relationships === void 0 ? void 0 : (_file$relationships$r = _file$relationships.referenced_by) === null || _file$relationships$r === void 0 ? void 0 : _file$relationships$r.data) || (file === null || file === void 0 ? void 0 : file.referenced_by) || [];
+  return references.some(function (reference) {
+    return reference.type === referencedBy;
+  });
+};
+/**
+ * Checks if the file is referenced by a specific doctype and a specific Id of that reference
+ *
+ * @param {IOCozyFile} file - io.cozy.files document
+ * @param {Doctype} referencedBy - Doctype where document is referenced
+ * @param {string} referencedId - Id of the referenced document
+ * @returns {boolean} If a reference is found
+ */
+
+
+exports.isReferencedBy = isReferencedBy;
+
+var isReferencedById = function isReferencedById(file, referencedBy, referencedId) {
+  var _file$relationships2, _file$relationships2$;
+
+  var references = (file === null || file === void 0 ? void 0 : (_file$relationships2 = file.relationships) === null || _file$relationships2 === void 0 ? void 0 : (_file$relationships2$ = _file$relationships2.referenced_by) === null || _file$relationships2$ === void 0 ? void 0 : _file$relationships2$.data) || (file === null || file === void 0 ? void 0 : file.referenced_by) || [];
+  return references.some(function (reference) {
+    return reference.type === referencedBy && reference.id === referencedId;
+  });
+};
+/**
+ * Get array of reference by an specific doctype
+ *
+ * @param {IOCozyFile} file - io.cozy.files document
+ * @param {Doctype} referencedBy - Doctype where document is referenced
+ * @returns {Reference[]} Array of references found
+ */
+
+
+exports.isReferencedById = isReferencedById;
+
+var getReferencedBy = function getReferencedBy(file, referencedBy) {
+  var _file$relationships3, _file$relationships3$;
+
+  var references = (file === null || file === void 0 ? void 0 : (_file$relationships3 = file.relationships) === null || _file$relationships3 === void 0 ? void 0 : (_file$relationships3$ = _file$relationships3.referenced_by) === null || _file$relationships3$ === void 0 ? void 0 : _file$relationships3$.data) || (file === null || file === void 0 ? void 0 : file.referenced_by) || [];
+  return references.filter(function (reference) {
+    return reference.type === referencedBy;
+  });
+};
+/**
+ * Get array of reference by an specific doctype and a specific Id of that reference
+ *
+ * @param {IOCozyFile} file - io.cozy.files document
+ * @param {Doctype} referencedBy - Doctype where document is referenced
+ * @param {string} referencedId - Id of the referenced document
+ * @returns {Reference[]} Array of the reference found
+ */
+
+
+exports.getReferencedBy = getReferencedBy;
+
+var getReferencedById = function getReferencedById(file, referencedBy, referencedId) {
+  var _file$relationships4, _file$relationships4$;
+
+  var references = (file === null || file === void 0 ? void 0 : (_file$relationships4 = file.relationships) === null || _file$relationships4 === void 0 ? void 0 : (_file$relationships4$ = _file$relationships4.referenced_by) === null || _file$relationships4$ === void 0 ? void 0 : _file$relationships4$.data) || (file === null || file === void 0 ? void 0 : file.referenced_by) || [];
+  return references.filter(function (reference) {
+    return reference.type === referencedBy && reference.id === referencedId;
+  });
+};
 
-exports.create = create;
+exports.getReferencedById = getReferencedById;

package/dist/associations/helpers.spec.js

@@ -1,123 +1,237 @@
-import { attachRelationships } from './helpers'
-
-describe('Attaching relationships', () => {
-  const tasks = {
-    data: [
-      { _id: 1, _type: 'io.cozy.tasks' },
-      { _id: 2, _type: 'io.cozy.tasks' }
-    ]
-  }
-  const todos = {
-    data: [
-      { _id: 3, _type: 'io.cozy.todos' },
-      { _id: 4, _type: 'io.cozy.todos' }
-    ]
-  }
-
-  it('should attach to a single document', () => {
-    const doc = {
-      _id: 1
+import {
+  attachRelationships,
+  isReferencedBy,
+  isReferencedById,
+  getReferencedBy,
+  getReferencedById
+} from './helpers'
+
+describe('Associations helpers', () => {
+  describe('Attaching relationships', () => {
+    const tasks = {
+      data: [
+        { _id: 1, _type: 'io.cozy.tasks' },
+        { _id: 2, _type: 'io.cozy.tasks' }
+      ]
     }
-    const relationships = {
-      1: {
-        tasks
-      }
+    const todos = {
+      data: [
+        { _id: 3, _type: 'io.cozy.todos' },
+        { _id: 4, _type: 'io.cozy.todos' }
+      ]
     }
-    const withRelationships = attachRelationships({ data: doc }, relationships)
-    expect(withRelationships.data.relationships).toEqual({
-      tasks
-    })
-  })
 
-  it('should attach to multiple document', () => {
-    const docs = [
-      {
+    it('should attach to a single document', () => {
+      const doc = {
         _id: 1
-      },
-      {
-        _id: 2
       }
-    ]
-    const relationships = {
-      1: {
+      const relationships = {
+        1: {
+          tasks
+        }
+      }
+      const withRelationships = attachRelationships(
+        { data: doc },
+        relationships
+      )
+      expect(withRelationships.data.relationships).toEqual({
         tasks
-      },
-      2: {
-        todos
+      })
+    })
+
+    it('should attach to multiple document', () => {
+      const docs = [
+        {
+          _id: 1
+        },
+        {
+          _id: 2
+        }
+      ]
+      const relationships = {
+        1: {
+          tasks
+        },
+        2: {
+          todos
+        }
       }
-    }
-    const withRelationships = attachRelationships({ data: docs }, relationships)
-    expect(withRelationships.data[0].relationships).toEqual({
-      tasks
+      const withRelationships = attachRelationships(
+        { data: docs },
+        relationships
+      )
+      expect(withRelationships.data[0].relationships).toEqual({
+        tasks
+      })
+      expect(withRelationships.data[1].relationships).toEqual({
+        todos
+      })
     })
-    expect(withRelationships.data[1].relationships).toEqual({
-      todos
+
+    it('should add missing relationships', () => {
+      const doc = {
+        _id: 1,
+        relationships: {
+          tasks
+        }
+      }
+      const relationships = {
+        1: {
+          tasks,
+          todos
+        }
+      }
+      const withRelationships = attachRelationships(
+        { data: doc },
+        relationships
+      )
+      expect(withRelationships.data.relationships.tasks).toEqual(tasks)
+      expect(withRelationships.data.relationships.todos).toEqual(todos)
     })
-  })
 
-  it('should add missing relationships', () => {
-    const doc = {
-      _id: 1,
-      relationships: {
-        tasks
+    it('should preserve existing relationships', () => {
+      const doc = {
+        _id: 1,
+        relationships: {
+          tasks
+        }
       }
-    }
-    const relationships = {
-      1: {
-        tasks,
-        todos
+      const relationships = {
+        1: {
+          todos
+        }
       }
-    }
-    const withRelationships = attachRelationships({ data: doc }, relationships)
-    expect(withRelationships.data.relationships.tasks).toEqual(tasks)
-    expect(withRelationships.data.relationships.todos).toEqual(todos)
-  })
+      const withRelationships = attachRelationships(
+        { data: doc },
+        relationships
+      )
+      expect(withRelationships.data.relationships.tasks).toEqual(tasks)
+      expect(withRelationships.data.relationships.todos).toEqual(todos)
+    })
 
-  it('should preserve existing relationships', () => {
-    const doc = {
-      _id: 1,
-      relationships: {
-        tasks
+    it('should work when there are no new relationships', () => {
+      const doc = {
+        _id: 1,
+        relationships: {
+          tasks
+        }
       }
-    }
-    const relationships = {
-      1: {
-        todos
+      const relationships = {
+        2: {
+          todos
+        }
       }
-    }
-    const withRelationships = attachRelationships({ data: doc }, relationships)
-    expect(withRelationships.data.relationships.tasks).toEqual(tasks)
-    expect(withRelationships.data.relationships.todos).toEqual(todos)
-  })
+      const withRelationships = attachRelationships(
+        { data: doc },
+        relationships
+      )
+      expect(withRelationships.data.relationships.tasks).toEqual(tasks)
+      expect(Object.keys(withRelationships.data.relationships).length).toEqual(
+        1
+      )
+    })
 
-  it('should work when there are no new relationships', () => {
-    const doc = {
-      _id: 1,
-      relationships: {
-        tasks
+    it('should attach relationships when the document has an empty relationship object', () => {
+      const doc = {
+        _id: 1,
+        relationships: {}
       }
-    }
-    const relationships = {
-      2: {
-        todos
+      const relationships = {
+        1: {
+          tasks
+        }
       }
-    }
-    const withRelationships = attachRelationships({ data: doc }, relationships)
-    expect(withRelationships.data.relationships.tasks).toEqual(tasks)
-    expect(Object.keys(withRelationships.data.relationships).length).toEqual(1)
+      const withRelationships = attachRelationships(
+        { data: doc },
+        relationships
+      )
+      expect(withRelationships.data.relationships.tasks).toEqual(tasks)
+    })
   })
 
-  it('should attach relationships when the document has an empty relationship object', () => {
-    const doc = {
-      _id: 1,
-      relationships: {}
-    }
-    const relationships = {
-      1: {
-        tasks
+  describe('referencedBy', () => {
+    const mockFile = {
+      _id: '123',
+      name: 'fakeFile',
+      relationships: {
+        referenced_by: {
+          data: [
+            {
+              id: '123',
+              type: 'io.cozy.contacts'
+            },
+            {
+              id: '456',
+              type: 'io.cozy.contacts'
+            }
+          ]
+        }
       }
     }
-    const withRelationships = attachRelationships({ data: doc }, relationships)
-    expect(withRelationships.data.relationships.tasks).toEqual(tasks)
+    describe('isReferencedBy', () => {
+      it('should return "true"', () => {
+        const result = isReferencedBy(mockFile, 'io.cozy.contacts')
+
+        expect(result).toBe(true)
+      })
+      it('should return "false"', () => {
+        const result = isReferencedBy(mockFile, 'io.cozy.xxx')
+
+        expect(result).toBe(false)
+      })
+    })
+
+    describe('isReferencedById', () => {
+      it('should return "true"', () => {
+        const result = isReferencedById(mockFile, 'io.cozy.contacts', '123')
+
+        expect(result).toBe(true)
+      })
+      it('should return "false"', () => {
+        const result = isReferencedById(mockFile, 'io.cozy.contacts', '789')
+
+        expect(result).toBe(false)
+      })
+    })
+
+    describe('getReferencedBy', () => {
+      it('should return correct array of reference', () => {
+        const result = getReferencedBy(mockFile, 'io.cozy.contacts')
+
+        expect(result).toEqual([
+          {
+            id: '123',
+            type: 'io.cozy.contacts'
+          },
+          {
+            id: '456',
+            type: 'io.cozy.contacts'
+          }
+        ])
+      })
+      it('should return empty array', () => {
+        const result = getReferencedBy(mockFile, 'io.cozy.xxx')
+
+        expect(result).toEqual([])
+      })
+    })
+
+    describe('getReferencedById', () => {
+      it('should return array of reference with only the reference with id "123"', () => {
+        const result = getReferencedById(mockFile, 'io.cozy.contacts', '123')
+
+        expect(result).toEqual([
+          {
+            id: '123',
+            type: 'io.cozy.contacts'
+          }
+        ])
+      })
+      it('should return empty array', () => {
+        const result = getReferencedById(mockFile, 'io.cozy.contacts', '789')
+
+        expect(result).toEqual([])
+      })
+    })
   })
 })

package/dist/associations/index.js

@@ -59,6 +59,30 @@ Object.defineProperty(exports, "create", {
     return _helpers.create;
   }
 });
+Object.defineProperty(exports, "isReferencedBy", {
+  enumerable: true,
+  get: function get() {
+    return _helpers.isReferencedBy;
+  }
+});
+Object.defineProperty(exports, "isReferencedById", {
+  enumerable: true,
+  get: function get() {
+    return _helpers.isReferencedById;
+  }
+});
+Object.defineProperty(exports, "getReferencedBy", {
+  enumerable: true,
+  get: function get() {
+    return _helpers.getReferencedBy;
+  }
+});
+Object.defineProperty(exports, "getReferencedById", {
+  enumerable: true,
+  get: function get() {
+    return _helpers.getReferencedById;
+  }
+});
 
 var _HasManyFiles = _interopRequireDefault(require("./HasManyFiles"));
 

package/dist/authentication/mobile.native.js

@@ -64,11 +64,26 @@ var authenticateWithReactNativeInAppBrowser = /*#__PURE__*/function () {
 
               var linkListener = function linkListener(_ref2) {
                 var url = _ref2.url;
+                var sanitizedUrl = url;
                 var accessCode = /\?access_code=(.+)$/.test(url);
                 var state = /\?state=(.+)$/.test(url);
 
                 if (accessCode || state) {
-                  resolve(url);
+                  if (_reactNative.Platform.OS === 'ios') {
+                    // On iOS, the # added to the URL by the stack for security
+                    // reason is encoded to %23. Because of this, URL().searchParams
+                    // is not working as expected since %23 is added to the param
+                    // instead of being ignored and assigned to the hash.
+                    // Let's convert back %23 to # manually.
+                    // I think the issue is related to Linking component but didn't
+                    // find any issues on github about it. Need to make a simple
+                    // reproduction case to create the issue.
+                    if (url.endsWith('%23')) {
+                      sanitizedUrl = url.replace(/%23$/, '#');
+                    }
+                  }
+
+                  resolve(sanitizedUrl);
                   removeListener();
 
                   _reactNativeInappbrowserReborn.InAppBrowser.close();

package/dist/hooks/useQuery.js

@@ -25,6 +25,8 @@ var _types = require("../types");
 
 var _context = require("../context");
 
+var _dsl = require("../queries/dsl");
+
 function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; }
 
 function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { (0, _defineProperty2.default)(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; }
@@ -41,15 +43,16 @@ var generateFetchMoreQueryDefinition = function generateFetchMoreQueryDefinition
 /**
  * Fetches a queryDefinition and returns the queryState
  *
- * @param  {object} queryDefinition - Definition created with Q()
+ * @param  {QueryDefinition} queryDefinition - Definition created with Q()
  *
- * @param  {object} options - Options
- * @param  {object} options.as - Name for the query [required]
- * @param  {boolean} options.enabled - If set to false, the query won't be executed
- * @param  {object} options.fetchPolicy - Fetch policy
- * @param  {object} options.singleDocData - If true, the "data" returned will be
+ * @typedef {object} UseQueryOptions
+ * @property  {object} as - Name for the query [required]
+ * @property  {boolean} enabled - If set to false, the query won't be executed
+ * @property  {object} fetchPolicy - Fetch policy
+ * @property  {object} singleDocData - If true, the "data" returned will be
  * a single doc instead of an array for single doc queries. Defaults to false for backward
  * compatibility but will be set to true in the future.
+ * @property {Function} onError - Callback if the query is errored
  *
  * @returns {UseQueryReturnValue}
  */

package/dist/hooks/useQuery.spec.jsx

@@ -1,13 +1,20 @@
 import { renderHook } from '@testing-library/react-hooks'
 
+import CozyClient from '../CozyClient'
+import CozyLink from '../CozyLink'
 import useQuery, { useQueries } from './useQuery'
 import { Q } from '../queries/dsl'
 
 import { setupClient, makeWrapper } from '../testing/utils'
 import simpsonsFixture from '../testing/simpsons.json'
 
-const setupQuery = ({ queryDefinition, queryOptions, storeQueries }) => {
-  const client = setupClient({ queries: storeQueries })
+const setupQuery = ({
+  customClient,
+  queryDefinition,
+  queryOptions,
+  storeQueries
+}) => {
+  const client = customClient || setupClient({ queries: storeQueries })
   const hookResult = renderHook(() => useQuery(queryDefinition, queryOptions), {
     wrapper: makeWrapper(client)
   })
@@ -159,6 +166,30 @@ describe('use query', () => {
     expect(lastCallArgs).toMatchObject({ skip: current.data.length })
     expect(fetchMoreResult).toEqual({ data: null })
   })
+
+  it('should call onError callback when an error is thrown. Callback passed as argument', async () => {
+    jest.spyOn(console, 'error').mockImplementation(() => null)
+    const requestHandler = jest.fn()
+    const client = new CozyClient({
+      links: [new CozyLink(requestHandler)]
+    })
+    const error = new TypeError('Failed to fetch')
+    requestHandler.mockReturnValue(Promise.reject(error))
+    const onError = jest.fn().mockReturnValue(() => true)
+    setupQuery({
+      customClient: client,
+      queryOptions: {
+        as: 'fake-query',
+        onError
+      },
+      queryDefinition: () => Q('io.cozy.todos')
+    })
+
+    // TODO find a better alternative
+    setTimeout(() => {
+      expect(onError).toBeCalled()
+    }, 100)
+  })
 })
 
 describe('use queries', () => {

package/dist/models/document/index.js

@@ -5,9 +5,27 @@ var _interopRequireWildcard = require("@babel/runtime/helpers/interopRequireWild
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.helpers = exports.themes = exports.locales = exports.default = void 0;
+Object.defineProperty(exports, "Qualification", {
+  enumerable: true,
+  get: function get() {
+    return _qualification.Qualification;
+  }
+});
+Object.defineProperty(exports, "setQualification", {
+  enumerable: true,
+  get: function get() {
+    return _qualification.setQualification;
+  }
+});
+Object.defineProperty(exports, "getQualification", {
+  enumerable: true,
+  get: function get() {
+    return _qualification.getQualification;
+  }
+});
+exports.helpers = exports.themes = exports.locales = void 0;
 
-var qualification = _interopRequireWildcard(require("./qualification"));
+var _qualification = require("./qualification");
 
 var locales = _interopRequireWildcard(require("./locales"));
 
@@ -19,6 +37,4 @@ exports.themes = themes;
 
 var helpers = _interopRequireWildcard(require("./documentTypeDataHelpers"));
 
-exports.helpers = helpers;
-var _default = qualification;
-exports.default = _default;
+exports.helpers = helpers;

package/dist/models/index.js

@@ -47,7 +47,7 @@ var contact = _interopRequireWildcard(require("./contact"));
 
 exports.contact = contact;
 
-var document = _interopRequireWildcard(require("./document/index"));
+var document = _interopRequireWildcard(require("./document"));
 
 exports.document = document;
 

package/dist/types.js

@@ -85,7 +85,8 @@ var _dsl = require("./queries/dsl");
  * @property {string} [as] - Name of the query
  * @property {Function} [fetchPolicy] - Fetch policy to bypass fetching based on what's already inside the state. See "Fetch policies"
  * @property {AutoUpdateOptions} [autoUpdate] - Options for the query auto update
- * @property {string} [options.update] - Does not seem to be used
+ * @property {string} [update] - Does not seem to be used
+ * @property {Function} [onError] - Callback when the query is errored
  */
 
 /**
@@ -98,12 +99,32 @@ var _dsl = require("./queries/dsl");
  */
 
 /**
- * A reference to a document (special case of a relationship used between photos and albums)
+ * A reference to a document
+ *
+ * @typedef {object} ReferencedByRelationship
+ * @property {RelationshipParent} [parent]
+ * @property {ReferencedBy} [referenced_by]
+ */
+
+/**
+ * @typedef {object} RelationshipParent
+ * @property {{related: string}} links
+ * @property {Reference} [data]
+ */
+
+/**
+ * @typedef {object} ReferencedBy
+ * @property {{self: string}} links
+ * @property {Reference[]|null} data
+ */
+
+/**
+ * A reference to a document
  * https://docs.cozy.io/en/cozy-doctypes/docs/io.cozy.files/#references
  *
  * @typedef {object} Reference
- * @property {string} _id - id of the document
- * @property {string} _type - doctype of the document
+ * @property {string} id - id of the document
+ * @property {string} type - doctype of the document
  */
 
 /**
@@ -124,7 +145,8 @@ var _dsl = require("./queries/dsl");
  * @property {string} [_type] - Type of the document
  * @property {string} [_rev] - Current revision of the document
  * @property {boolean} [_deleted] - When the document has been deleted
- * @property {object} [relationships] - Relationships of the document
+ * @property {ReferencedByRelationship} [relationships] - Relationships of the document
+ * @property {Reference[]} [referenced_by] - referenced by of another document
  */
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cozy-client",
-  "version": "27.3.0",
+  "version": "27.5.0",
   "license": "MIT",
   "main": "dist/index.node.js",
   "browser": "dist/index.js",
@@ -69,5 +69,5 @@
     "react-native-inappbrowser-reborn": "^3.5.1"
   },
   "sideEffects": false,
-  "gitHead": "a425c10bf4937c815beee378cfeca7a13ce728c2"
+  "gitHead": "4d49dc4e8d6fcb949cc5d28b5bc1f5bda126560d"
 }

package/types/CozyClient.d.ts

@@ -10,6 +10,10 @@ export type ClientOptions = {
     autoHydrate?: boolean;
     oauth?: object;
     onTokenRefresh?: Function;
+    /**
+     * - Default callback if a query is errored
+     */
+    onError?: Function;
     /**
      * - Schema description for each doctypes
      */
@@ -39,7 +43,7 @@ export type ClientOptions = {
  * @property {boolean} [autoHydrate]
  * @property {object} [oauth]
  * @property {Function} [onTokenRefresh]
- * @property {Function} [onTokenRefresh]
+ * @property {Function} [onError] - Default callback if a query is errored
  * @property  {Link}         [link]   - Backward compatibility
  * @property  {Array<Link>}  [links]  - List of links
  * @property  {object}       [schema] - Schema description for each doctypes
@@ -146,6 +150,10 @@ declare class CozyClient {
         autoHydrate?: boolean;
         oauth?: object;
         onTokenRefresh?: Function;
+        /**
+         * - Default callback if a query is errored
+         */
+        onError?: Function;
         /**
          * - If set to false, the client will not instantiate a Redux store automatically. Use this if you want to merge cozy-client's store with your own redux store. See [here](https://docs.cozy.io/en/cozy-client/react-integration/#1b-use-your-own-redux-store) for more information.
          */
@@ -640,6 +648,12 @@ declare class CozyClient {
      * @param {object} data - Data that is inserted in the store. Shape: { doctype: [data] }
      */
     setData(data: object): void;
+    /**
+     * At any time put an error function
+     *
+     * @param {Function} [onError] - Set a callback for queries which are errored
+     */
+    setOnError(onError?: Function): void;
     toJSON(): SnapshotClient;
 }
 declare namespace CozyClient {

package/types/associations/helpers.d.ts

@@ -7,3 +7,10 @@ export function create(target: any, { name, type, doctype }: {
     type: any;
     doctype: any;
 }, accessors: any): any;
+export function isReferencedBy(file: IOCozyFile, referencedBy: Doctype): boolean;
+export function isReferencedById(file: IOCozyFile, referencedBy: Doctype, referencedId: string): boolean;
+export function getReferencedBy(file: IOCozyFile, referencedBy: Doctype): Reference[];
+export function getReferencedById(file: IOCozyFile, referencedBy: Doctype, referencedId: string): Reference[];
+import { IOCozyFile } from "../types";
+import { Doctype } from "../types";
+import { Reference } from "../types";

package/types/associations/index.d.ts

@@ -6,4 +6,4 @@ import HasOneInPlace from "./HasOneInPlace";
 import HasManyInPlace from "./HasManyInPlace";
 import HasManyTriggers from "./HasManyTriggers";
 export { Association, HasManyFiles, HasMany, HasOne, HasOneInPlace, HasManyInPlace, HasManyTriggers };
-export { resolveClass, create } from "./helpers";
+export { resolveClass, create, isReferencedBy, isReferencedById, getReferencedBy, getReferencedById } from "./helpers";

package/types/hooks/useQuery.d.ts

@@ -1,24 +1,48 @@
 export function useQueries(querySpecs: any): {};
 export default useQuery;
+/**
+ * Fetches a queryDefinition and returns the queryState
+ */
+export type UseQueryOptions = {
+    /**
+     * - Name for the query [required]
+     */
+    as: object;
+    /**
+     * - If set to false, the query won't be executed
+     */
+    enabled: boolean;
+    /**
+     * - Fetch policy
+     */
+    fetchPolicy: object;
+    /**
+     * - If true, the "data" returned will be
+     * a single doc instead of an array for single doc queries. Defaults to false for backward
+     * compatibility but will be set to true in the future.
+     */
+    singleDocData: object;
+    /**
+     * - Callback if the query is errored
+     */
+    onError: Function;
+};
 /**
  * Fetches a queryDefinition and returns the queryState
  *
- * @param  {object} queryDefinition - Definition created with Q()
+ * @param  {QueryDefinition} queryDefinition - Definition created with Q()
  *
- * @param  {object} options - Options
- * @param  {object} options.as - Name for the query [required]
- * @param  {boolean} options.enabled - If set to false, the query won't be executed
- * @param  {object} options.fetchPolicy - Fetch policy
- * @param  {object} options.singleDocData - If true, the "data" returned will be
+ * @typedef {object} UseQueryOptions
+ * @property  {object} as - Name for the query [required]
+ * @property  {boolean} enabled - If set to false, the query won't be executed
+ * @property  {object} fetchPolicy - Fetch policy
+ * @property  {object} singleDocData - If true, the "data" returned will be
  * a single doc instead of an array for single doc queries. Defaults to false for backward
  * compatibility but will be set to true in the future.
+ * @property {Function} onError - Callback if the query is errored
  *
  * @returns {UseQueryReturnValue}
  */
-declare function useQuery(queryDefinition: object, options: {
-    as: object;
-    enabled: boolean;
-    fetchPolicy: object;
-    singleDocData: object;
-}): UseQueryReturnValue;
+declare function useQuery(queryDefinition: QueryDefinition, options: any): UseQueryReturnValue;
+import { QueryDefinition } from "../queries/dsl";
 import { UseQueryReturnValue } from "../types";

package/types/models/document/index.d.ts

@@ -1,6 +1,7 @@
-export default qualification;
-import * as qualification from "./qualification";
+import { Qualification } from "./qualification";
+import { setQualification } from "./qualification";
+import { getQualification } from "./qualification";
 import * as locales from "./locales";
 import * as themes from "./documentTypeData";
 import * as helpers from "./documentTypeDataHelpers";
-export { locales, themes, helpers };
+export { Qualification, setQualification, getQualification, locales, themes, helpers };

package/types/queries/referencedBy.d.ts

@@ -0,0 +1,7 @@
+export function isReferencedBy(file: IOCozyFile, referencedBy: Doctype): boolean;
+export function isReferencedById(file: IOCozyFile, referencedBy: Doctype, referencedId: string): boolean;
+export function getReferencedBy(file: IOCozyFile, referencedBy: Doctype): Reference[];
+export function getReferencedById(file: IOCozyFile, referencedBy: Doctype, referencedId: string): Reference[];
+import { IOCozyFile } from "../types";
+import { Doctype } from "../types";
+import { Reference } from "../types";

package/types/types.d.ts

@@ -64,24 +64,47 @@ export type QueryOptions = {
      * - Does not seem to be used
      */
     update?: string;
+    /**
+     * - Callback when the query is errored
+     */
+    onError?: Function;
 };
 export type FetchMoreAble = {
     fetchMore: Function;
 };
 export type UseQueryReturnValue = QueryState & FetchMoreAble;
 /**
- * A reference to a document (special case of a relationship used between photos and albums)
+ * A reference to a document
+ */
+export type ReferencedByRelationship = {
+    parent?: RelationshipParent;
+    referenced_by?: ReferencedBy;
+};
+export type RelationshipParent = {
+    links: {
+        related: string;
+    };
+    data?: Reference;
+};
+export type ReferencedBy = {
+    links: {
+        self: string;
+    };
+    data: Reference[] | null;
+};
+/**
+ * A reference to a document
  * https://docs.cozy.io/en/cozy-doctypes/docs/io.cozy.files/#references
  */
 export type Reference = {
     /**
      * - id of the document
      */
-    _id: string;
+    id: string;
     /**
      * - doctype of the document
      */
-    _type: string;
+    type: string;
 };
 export type ReferenceMap = {
     [x: string]: Reference[];
@@ -118,7 +141,11 @@ export type CozyClientDocument = {
     /**
      * - Relationships of the document
      */
-    relationships?: object;
+    relationships?: ReferencedByRelationship;
+    /**
+     * - referenced by of another document
+     */
+    referenced_by?: Reference[];
 };
 /**
  * - An io.cozy.files document