cozy-client 27.3.2 → 27.6.0

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/index.js

@@ -22,6 +22,10 @@ var _exportNames = {
   HasOneInPlace: true,
   HasManyInPlace: true,
   HasManyTriggers: true,
+  isReferencedBy: true,
+  isReferencedById: true,
+  getReferencedBy: true,
+  getReferencedById: true,
   dehydrate: true,
   generateWebLink: true,
   cancelable: true,
@@ -132,16 +136,40 @@ Object.defineProperty(exports, "HasManyTriggers", {
     return _associations.HasManyTriggers;
   }
 });
+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;
+  }
+});
 Object.defineProperty(exports, "dehydrate", {
   enumerable: true,
   get: function get() {
-    return _helpers.dehydrate;
+    return _helpers2.dehydrate;
   }
 });
 Object.defineProperty(exports, "generateWebLink", {
   enumerable: true,
   get: function get() {
-    return _helpers.generateWebLink;
+    return _helpers2.generateWebLink;
   }
 });
 Object.defineProperty(exports, "cancelable", {
@@ -248,7 +276,9 @@ var _dsl = require("./queries/dsl");
 
 var _associations = require("./associations");
 
-var _helpers = require("./helpers");
+var _helpers = require("./associations/helpers");
+
+var _helpers2 = require("./helpers");
 
 var _utils = require("./utils");
 

package/dist/models/file.js

@@ -8,7 +8,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.normalize = normalize;
 exports.ensureFilePath = ensureFilePath;
 exports.getParentFolderId = getParentFolderId;
-exports.doMobileUpload = exports.readMobileFile = exports.uploadFileWithConflictStrategy = exports.generateFileNameForRevision = exports.generateNewFileNameOnConflict = exports.overrideFileForPath = exports.move = exports.getFullpath = exports.hasMetadataAttribute = exports.isReferencedByAlbum = exports.fetchFilesByQualificationRules = exports.saveFileQualification = exports.isSharingShorcutNew = exports.isSharingShortcutNew = exports.isSharingShorcut = exports.isSharingShortcut = exports.getSharingShortcutTargetDoctype = exports.getSharingShortcutTargetMime = exports.getSharingShortcutStatus = exports.isShortcut = exports.shouldBeOpenedByOnlyOffice = exports.isOnlyOfficeFile = exports.isNote = exports.isDirectory = exports.isFile = exports.splitFilename = exports.ALBUMS_DOCTYPE = void 0;
+exports.isFromKonnector = exports.hasCertifications = exports.hasQualifications = exports.isPlainText = exports.doMobileUpload = exports.readMobileFile = exports.uploadFileWithConflictStrategy = exports.generateFileNameForRevision = exports.generateNewFileNameOnConflict = exports.overrideFileForPath = exports.move = exports.getFullpath = exports.hasMetadataAttribute = exports.isReferencedByAlbum = exports.fetchFilesByQualificationRules = exports.saveFileQualification = exports.isSharingShorcutNew = exports.isSharingShortcutNew = exports.isSharingShorcut = exports.isSharingShortcut = exports.getSharingShortcutTargetDoctype = exports.getSharingShortcutTargetMime = exports.getSharingShortcutStatus = exports.isShortcut = exports.shouldBeOpenedByOnlyOffice = exports.isOnlyOfficeFile = exports.isNote = exports.isDirectory = exports.isFile = exports.splitFilename = exports.ALBUMS_DOCTYPE = void 0;
 
 var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"));
 
@@ -976,5 +976,52 @@ var doMobileUpload = /*#__PURE__*/function () {
     return _ref12.apply(this, arguments);
   };
 }();
+/**
+ * @param {string} [mimeType=''] - Mime type of file
+ * @param {string} [fileName=''] - Name of file
+ * @returns {boolean}
+ */
+
+
+exports.doMobileUpload = doMobileUpload;
+
+var isPlainText = function isPlainText() {
+  var mimeType = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+  var fileName = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  return mimeType ? /^text\//.test(mimeType) : /\.(txt|md)$/.test(fileName);
+};
+/**
+ * @param {IOCozyFile} file - io.cozy.files document
+ * @returns {boolean}
+ */
+
+
+exports.isPlainText = isPlainText;
+
+var hasQualifications = function hasQualifications(file) {
+  return (0, _has.default)(file, 'metadata.qualification');
+};
+/**
+ * @param {IOCozyFile} file - io.cozy.files document
+ * @returns {boolean}
+ */
+
+
+exports.hasQualifications = hasQualifications;
+
+var hasCertifications = function hasCertifications(file) {
+  return (0, _get.default)(file, 'metadata.carbonCopy', false) || (0, _get.default)(file, 'metadata.electronicSafe', false);
+};
+/**
+ * @param {IOCozyFile} file - io.cozy.files document
+ * @returns {boolean}
+ */
+
+
+exports.hasCertifications = hasCertifications;
+
+var isFromKonnector = function isFromKonnector(file) {
+  return (0, _has.default)(file, 'cozyMetadata.sourceAccount');
+};
 
-exports.doMobileUpload = doMobileUpload;
+exports.isFromKonnector = isFromKonnector;

package/dist/models/file.spec.js

@@ -154,6 +154,53 @@ describe('File Model', () => {
     ).toBe(false)
   })
 
+  describe('hasQualifications', () => {
+    it.each`
+      file                                                                      | result
+      ${{ name: 'file01', metadata: { qualification: { label: 'passport' } } }} | ${true}
+      ${{ name: 'file02', metadata: {} }}                                       | ${false}
+      ${{ name: 'file03' }}                                                     | ${false}
+    `(
+      `should test if a $file.name has a qualification or not`,
+      ({ file, result }) => {
+        expect(fileModel.hasQualifications(file)).toEqual(result)
+      }
+    )
+  })
+
+  describe('hasCertifications', () => {
+    it.each`
+      file                                                                          | result
+      ${{ name: 'file01', metadata: { carbonCopy: true } }}                         | ${true}
+      ${{ name: 'file02', metadata: { electronicSafe: true } }}                     | ${true}
+      ${{ name: 'file03', metadata: { carbonCopy: true, electronicSafe: false } }}  | ${true}
+      ${{ name: 'file04', metadata: { carbonCopy: false, electronicSafe: true } }}  | ${true}
+      ${{ name: 'file05', metadata: { carbonCopy: true, electronicSafe: true } }}   | ${true}
+      ${{ name: 'file06', metadata: { carbonCopy: false, electronicSafe: false } }} | ${false}
+      ${{ name: 'file07', metadata: {} }}                                           | ${false}
+      ${{ name: 'file08' }}                                                         | ${false}
+    `(
+      `should test if a $file.name has a certification or not`,
+      ({ file, result }) => {
+        expect(fileModel.hasCertifications(file)).toEqual(result)
+      }
+    )
+  })
+
+  describe('isFromKonnector', () => {
+    it.each`
+      file                                                                      | result
+      ${{ name: 'file01', cozyMetadata: { sourceAccount: 'sourceAccountId' } }} | ${true}
+      ${{ name: 'file02', cozyMetadata: {} }}                                   | ${false}
+      ${{ name: 'file03' }}                                                     | ${false}
+    `(
+      `should test if a $file.name is from connector or not`,
+      ({ file, result }) => {
+        expect(fileModel.isFromKonnector(file)).toEqual(result)
+      }
+    )
+  })
+
   describe('normalizeFile', () => {
     const id = 'uuid123'
     const type = 'directory'
@@ -183,34 +230,19 @@ describe('File Model', () => {
   })
 
   describe('splitFilename', () => {
-    const joinName = ({ filename, extension }) => filename + extension
-    const mkFile = expectation => ({
-      type: 'file',
-      name: joinName(expectation)
-    })
-    const { stringify } = JSON
-
-    const scenarios = [
-      { filename: 'file', extension: '.ext' },
-      { filename: 'file', extension: '' },
-      { filename: 'file.html', extension: '.ejs' },
-      { filename: 'file', extension: '.' },
-      { filename: 'file.', extension: '.' },
-      { filename: 'file.', extension: '.ext' },
-      { filename: '.file', extension: '' },
-      { filename: '.file', extension: '.ext' }
-    ]
-
-    for (const expectation of scenarios) {
-      it(`splits ${stringify(joinName(expectation))} into ${stringify(
-        expectation
-      )}`, () => {
-        expect(fileModel.splitFilename(mkFile(expectation))).toEqual(
-          expectation
-        )
-      })
-    }
-
+    it.each`
+      opts                                       | result
+      ${{ type: 'file', name: 'file.ext' }}      | ${{ filename: 'file', extension: '.ext' }}
+      ${{ type: 'file', name: 'file' }}          | ${{ filename: 'file', extension: '' }}
+      ${{ type: 'file', name: 'file.html.ext' }} | ${{ filename: 'file.html', extension: '.ext' }}
+      ${{ type: 'file', name: 'file.' }}         | ${{ filename: 'file', extension: '.' }}
+      ${{ type: 'file', name: 'file..' }}        | ${{ filename: 'file.', extension: '.' }}
+      ${{ type: 'file', name: 'file..ext' }}     | ${{ filename: 'file.', extension: '.ext' }}
+      ${{ type: 'file', name: '.file' }}         | ${{ filename: '.file', extension: '' }}
+      ${{ type: 'file', name: '.file.ext' }}     | ${{ filename: '.file', extension: '.ext' }}
+    `(`should splits $opts.name into $result`, ({ opts, result }) => {
+      expect(fileModel.splitFilename(opts)).toEqual(result)
+    })
     it('should throw an error if the file is not correct', () => {
       expect(() => fileModel.splitFilename({})).toThrow()
       expect(() => fileModel.splitFilename({ name: null })).toThrow()
@@ -510,48 +542,6 @@ describe('File Model', () => {
     })
   })
 
-  describe('splitFilename', () => {
-    const name = ({ filename, extension }) => filename + extension
-    const file = expectation => ({ type: 'file', name: name(expectation) })
-    const { stringify } = JSON
-
-    const scenarios = [
-      { filename: 'file', extension: '.ext' },
-      { filename: 'file', extension: '' },
-      { filename: 'file.html', extension: '.ejs' },
-      { filename: 'file', extension: '.' },
-      { filename: 'file.', extension: '.' },
-      { filename: 'file.', extension: '.ext' },
-      { filename: '.file', extension: '' },
-      { filename: '.file', extension: '.ext' }
-    ]
-
-    for (const expectation of scenarios) {
-      it(`splits ${stringify(name(expectation))} into ${stringify(
-        expectation
-      )}`, () => {
-        expect(fileModel.splitFilename(file(expectation))).toEqual(expectation)
-      })
-    }
-
-    it('should throw an error if the file is not correct', () => {
-      const file = {}
-
-      expect(() => fileModel.splitFilename(file)).toThrow()
-    })
-    it('should return only the folder name if its a folder', () => {
-      const file = {
-        name: 'foo',
-        type: 'directory'
-      }
-      const result = fileModel.splitFilename(file)
-      expect(result).toEqual({
-        filename: 'foo',
-        extension: ''
-      })
-    })
-  })
-
   describe('generateNewFileNameOnConflict', () => {
     it('should generate the right file name with _X', () => {
       const filename1 = fileModel.generateNewFileNameOnConflict('test')
@@ -663,6 +653,53 @@ describe('File Model', () => {
       })
     })
   })
+
+  describe('isPlainText', () => {
+    describe('using mime types', () => {
+      it('should match mime types starting with "text/"', () => {
+        expect(fileModel.isPlainText('text/plain')).toBe(true)
+        expect(fileModel.isPlainText('text/markdown')).toBe(true)
+        expect(fileModel.isPlainText('application/text')).toBe(false)
+        expect(fileModel.isPlainText('something/text/else')).toBe(false)
+        expect(fileModel.isPlainText('text/vnd.cozy.note+markdown')).toBe(true)
+      })
+
+      it('should not match complex text formats', () => {
+        expect(fileModel.isPlainText('application/msword')).toBe(false)
+        expect(
+          fileModel.isPlainText('application/vnd.oasis.opendocument.text')
+        ).toBe(false)
+        expect(
+          fileModel.isPlainText('application/x-iwork-pages-sffpages')
+        ).toBe(false)
+      })
+
+      it('should not use the filename if a mime type is present', () => {
+        expect(
+          fileModel.isPlainText('application/msword', 'iswearitstext.txt')
+        ).toBe(false)
+      })
+    })
+
+    describe('using file names', () => {
+      it('should match txt files', () => {
+        expect(fileModel.isPlainText(undefined, 'iswearitstext.txt')).toBe(true)
+      })
+
+      it('should match md files', () => {
+        expect(fileModel.isPlainText(undefined, 'markdown.md')).toBe(true)
+      })
+
+      it('should not match anything else', () => {
+        expect(fileModel.isPlainText(undefined, 'file.doc')).toBe(false)
+        expect(fileModel.isPlainText(undefined, 'file.docx')).toBe(false)
+        expect(fileModel.isPlainText(undefined, 'file.pages')).toBe(false)
+        expect(fileModel.isPlainText(undefined, 'file.odt')).toBe(false)
+        expect(fileModel.isPlainText(undefined, 'file.csv')).toBe(false)
+        expect(fileModel.isPlainText(undefined, 'file.vcf')).toBe(false)
+      })
+    })
+  })
 })
 
 describe('File qualification', () => {

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.2",
+  "version": "27.6.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": "826f995c85378bdcd76f3a62428c1d9857f0136d"
+  "gitHead": "4228ec1287e3b18892f2e57128a09a77e87cae2e"
 }

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/index.d.ts

@@ -18,6 +18,7 @@ import * as models from "./models";
 export { manifest, models };
 export { QueryDefinition, Q, Mutations, MutationTypes, getDoctypeFromOperation } from "./queries/dsl";
 export { Association, HasMany, HasOne, HasOneInPlace, HasManyInPlace, HasManyTriggers } from "./associations";
+export { isReferencedBy, isReferencedById, getReferencedBy, getReferencedById } from "./associations/helpers";
 export { dehydrate, generateWebLink } from "./helpers";
 export { cancelable, isQueryLoading, hasQueryBeenLoaded } from "./utils";
 export { queryConnect, queryConnectFlat, withClient } from "./hoc";

package/types/models/file.d.ts

@@ -57,6 +57,10 @@ export function generateFileNameForRevision(file: IOCozyFile, revision: object,
 export function uploadFileWithConflictStrategy(client: CozyClient, file: string | ArrayBuffer, options: FileUploadOptions): any;
 export function readMobileFile(fileURL: string): Promise<any>;
 export function doMobileUpload(client: CozyClient, fileURL: string, options: FileUploadOptions): Promise<any>;
+export function isPlainText(mimeType?: string, fileName?: string): boolean;
+export function hasQualifications(file: IOCozyFile): boolean;
+export function hasCertifications(file: IOCozyFile): boolean;
+export function isFromKonnector(file: IOCozyFile): boolean;
 export type FileUploadOptions = {
     /**
      * - The file name to upload

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";