Skip to content

Commit 715b77a

Browse files
committed
feat: Add helpers for encrypted files
1 parent ff361d0 commit 715b77a

File tree

6 files changed

+140
-38
lines changed

6 files changed

+140
-38
lines changed

docs/api/cozy-client/interfaces/models.file.FileUploadOptions.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Conflict options
1414

1515
*Defined in*
1616

17-
[packages/cozy-client/src/models/file.js:496](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L496)
17+
[packages/cozy-client/src/models/file.js:527](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L527)
1818

1919
***
2020

@@ -26,7 +26,7 @@ Erase / rename
2626

2727
*Defined in*
2828

29-
[packages/cozy-client/src/models/file.js:495](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L495)
29+
[packages/cozy-client/src/models/file.js:526](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L526)
3030

3131
***
3232

@@ -38,7 +38,7 @@ The file Content-Type
3838

3939
*Defined in*
4040

41-
[packages/cozy-client/src/models/file.js:494](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L494)
41+
[packages/cozy-client/src/models/file.js:525](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L525)
4242

4343
***
4444

@@ -50,7 +50,7 @@ The dirId to upload the file to
5050

5151
*Defined in*
5252

53-
[packages/cozy-client/src/models/file.js:492](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L492)
53+
[packages/cozy-client/src/models/file.js:523](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L523)
5454

5555
***
5656

@@ -62,7 +62,7 @@ An object containing the metadata to attach
6262

6363
*Defined in*
6464

65-
[packages/cozy-client/src/models/file.js:493](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L493)
65+
[packages/cozy-client/src/models/file.js:524](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L524)
6666

6767
***
6868

@@ -74,4 +74,4 @@ The file name to upload
7474

7575
*Defined in*
7676

77-
[packages/cozy-client/src/models/file.js:491](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L491)
77+
[packages/cozy-client/src/models/file.js:522](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L522)

docs/api/cozy-client/modules/models.file.md

Lines changed: 97 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -44,7 +44,7 @@ Copies a file to a specified destination.
4444

4545
*Defined in*
4646

47-
[packages/cozy-client/src/models/file.js:664](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L664)
47+
[packages/cozy-client/src/models/file.js:695](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L695)
4848

4949
***
5050

@@ -68,7 +68,7 @@ Upload a file on a mobile
6868

6969
*Defined in*
7070

71-
[packages/cozy-client/src/models/file.js:601](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L601)
71+
[packages/cozy-client/src/models/file.js:632](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L632)
7272

7373
***
7474

@@ -99,7 +99,7 @@ that will process the download
9999

100100
*Defined in*
101101

102-
[packages/cozy-client/src/models/file.js:718](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L718)
102+
[packages/cozy-client/src/models/file.js:749](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L749)
103103

104104
***
105105

@@ -124,7 +124,7 @@ file object with path attribute
124124

125125
*Defined in*
126126

127-
[packages/cozy-client/src/models/file.js:138](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L138)
127+
[packages/cozy-client/src/models/file.js:169](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L169)
128128

129129
***
130130

@@ -145,7 +145,7 @@ file object with path attribute
145145

146146
*Defined in*
147147

148-
[packages/cozy-client/src/models/file.js:647](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L647)
148+
[packages/cozy-client/src/models/file.js:678](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L678)
149149

150150
***
151151

@@ -170,7 +170,7 @@ The files found by the rules
170170

171171
*Defined in*
172172

173-
[packages/cozy-client/src/models/file.js:258](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L258)
173+
[packages/cozy-client/src/models/file.js:289](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L289)
174174

175175
***
176176

@@ -194,7 +194,7 @@ Generate a file name for a revision
194194

195195
*Defined in*
196196

197-
[packages/cozy-client/src/models/file.js:481](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L481)
197+
[packages/cozy-client/src/models/file.js:512](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L512)
198198

199199
***
200200

@@ -219,7 +219,29 @@ A filename with the right suffix
219219

220220
*Defined in*
221221

222-
[packages/cozy-client/src/models/file.js:451](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L451)
222+
[packages/cozy-client/src/models/file.js:482](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L482)
223+
224+
***
225+
226+
### getEncryptiondRef
227+
228+
**getEncryptiondRef**(`dir`): `boolean`
229+
230+
Returns folder encryption reference
231+
232+
*Parameters*
233+
234+
| Name | Type | Description |
235+
| :------ | :------ | :------ |
236+
| `dir` | `IOCozyFile` | io.cozy.files document |
237+
238+
*Returns*
239+
240+
`boolean`
241+
242+
*Defined in*
243+
244+
[packages/cozy-client/src/models/file.js:86](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L86)
223245

224246
***
225247

@@ -245,7 +267,7 @@ The full path of the file in the cozy
245267

246268
*Defined in*
247269

248-
[packages/cozy-client/src/models/file.js:293](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L293)
270+
[packages/cozy-client/src/models/file.js:324](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L324)
249271

250272
***
251273

@@ -269,7 +291,7 @@ id of the parent folder, if any
269291

270292
*Defined in*
271293

272-
[packages/cozy-client/src/models/file.js:152](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L152)
294+
[packages/cozy-client/src/models/file.js:183](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L183)
273295

274296
***
275297

@@ -293,7 +315,7 @@ A description of the status
293315

294316
*Defined in*
295317

296-
[packages/cozy-client/src/models/file.js:164](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L164)
318+
[packages/cozy-client/src/models/file.js:195](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L195)
297319

298320
***
299321

@@ -317,7 +339,7 @@ A doctype
317339

318340
*Defined in*
319341

320-
[packages/cozy-client/src/models/file.js:184](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L184)
342+
[packages/cozy-client/src/models/file.js:215](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L215)
321343

322344
***
323345

@@ -341,7 +363,7 @@ The mime-type of the target file, or an empty string is the target is not a file
341363

342364
*Defined in*
343365

344-
[packages/cozy-client/src/models/file.js:174](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L174)
366+
[packages/cozy-client/src/models/file.js:205](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L205)
345367

346368
***
347369

@@ -361,7 +383,7 @@ The mime-type of the target file, or an empty string is the target is not a file
361383

362384
*Defined in*
363385

364-
[packages/cozy-client/src/models/file.js:627](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L627)
386+
[packages/cozy-client/src/models/file.js:658](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L658)
365387

366388
***
367389

@@ -385,7 +407,7 @@ Whether the file's metadata attribute exists
385407

386408
*Defined in*
387409

388-
[packages/cozy-client/src/models/file.js:282](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L282)
410+
[packages/cozy-client/src/models/file.js:313](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L313)
389411

390412
***
391413

@@ -405,7 +427,7 @@ Whether the file's metadata attribute exists
405427

406428
*Defined in*
407429

408-
[packages/cozy-client/src/models/file.js:619](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L619)
430+
[packages/cozy-client/src/models/file.js:650](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L650)
409431

410432
***
411433

@@ -451,6 +473,50 @@ Whether the file is client-side encrypted
451473

452474
***
453475

476+
### isEncryptedFileOrFolder
477+
478+
**isEncryptedFileOrFolder**(`fileOrdir`): `boolean`
479+
480+
Whether the file or folder is client-side encrypted
481+
482+
*Parameters*
483+
484+
| Name | Type | Description |
485+
| :------ | :------ | :------ |
486+
| `fileOrdir` | `IOCozyFile` | io.cozy.files document |
487+
488+
*Returns*
489+
490+
`boolean`
491+
492+
*Defined in*
493+
494+
[packages/cozy-client/src/models/file.js:107](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L107)
495+
496+
***
497+
498+
### isEncryptedFolder
499+
500+
**isEncryptedFolder**(`dir`): `boolean`
501+
502+
Whether the folder is client-side encrypted
503+
504+
*Parameters*
505+
506+
| Name | Type | Description |
507+
| :------ | :------ | :------ |
508+
| `dir` | `IOCozyFile` | io.cozy.files document |
509+
510+
*Returns*
511+
512+
`boolean`
513+
514+
*Defined in*
515+
516+
[packages/cozy-client/src/models/file.js:97](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L97)
517+
518+
***
519+
454520
### isFile
455521

456522
**isFile**(`file`): `boolean`
@@ -487,7 +553,7 @@ Whether the file is client-side encrypted
487553

488554
*Defined in*
489555

490-
[packages/cozy-client/src/models/file.js:638](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L638)
556+
[packages/cozy-client/src/models/file.js:669](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L669)
491557

492558
***
493559

@@ -531,7 +597,7 @@ Whether the file is supported by Only Office
531597

532598
*Defined in*
533599

534-
[packages/cozy-client/src/models/file.js:86](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L86)
600+
[packages/cozy-client/src/models/file.js:117](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L117)
535601

536602
***
537603

@@ -552,7 +618,7 @@ Whether the file is supported by Only Office
552618

553619
*Defined in*
554620

555-
[packages/cozy-client/src/models/file.js:611](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L611)
621+
[packages/cozy-client/src/models/file.js:642](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L642)
556622

557623
***
558624

@@ -576,7 +642,7 @@ Returns whether the file is a shortcut to a sharing
576642

577643
*Defined in*
578644

579-
[packages/cozy-client/src/models/file.js:204](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L204)
645+
[packages/cozy-client/src/models/file.js:235](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L235)
580646

581647
***
582648

@@ -600,7 +666,7 @@ Returns whether the sharing shortcut is new
600666

601667
*Defined in*
602668

603-
[packages/cozy-client/src/models/file.js:229](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L229)
669+
[packages/cozy-client/src/models/file.js:260](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L260)
604670

605671
***
606672

@@ -622,7 +688,7 @@ Returns whether the file is a shortcut to a sharing
622688

623689
*Defined in*
624690

625-
[packages/cozy-client/src/models/file.js:194](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L194)
691+
[packages/cozy-client/src/models/file.js:225](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L225)
626692

627693
***
628694

@@ -644,7 +710,7 @@ Returns whether the sharing shortcut is new
644710

645711
*Defined in*
646712

647-
[packages/cozy-client/src/models/file.js:218](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L218)
713+
[packages/cozy-client/src/models/file.js:249](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L249)
648714

649715
***
650716

@@ -666,7 +732,7 @@ true if the file is a shortcut
666732

667733
*Defined in*
668734

669-
[packages/cozy-client/src/models/file.js:111](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L111)
735+
[packages/cozy-client/src/models/file.js:142](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L142)
670736

671737
***
672738

@@ -701,7 +767,7 @@ Manage 4 cases :
701767
702768
*Defined in*
703769

704-
[packages/cozy-client/src/models/file.js:322](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L322)
770+
[packages/cozy-client/src/models/file.js:353](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L353)
705771

706772
***
707773

@@ -727,7 +793,7 @@ full normalized object
727793

728794
*Defined in*
729795

730-
[packages/cozy-client/src/models/file.js:124](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L124)
796+
[packages/cozy-client/src/models/file.js:155](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L155)
731797

732798
***
733799

@@ -754,7 +820,7 @@ The overrided file
754820

755821
*Defined in*
756822

757-
[packages/cozy-client/src/models/file.js:417](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L417)
823+
[packages/cozy-client/src/models/file.js:448](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L448)
758824

759825
***
760826

@@ -776,7 +842,7 @@ Read a file on a mobile
776842

777843
*Defined in*
778844

779-
[packages/cozy-client/src/models/file.js:554](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L554)
845+
[packages/cozy-client/src/models/file.js:585](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L585)
780846

781847
***
782848

@@ -802,7 +868,7 @@ The saved file
802868

803869
*Defined in*
804870

805-
[packages/cozy-client/src/models/file.js:244](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L244)
871+
[packages/cozy-client/src/models/file.js:275](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L275)
806872

807873
***
808874

@@ -826,7 +892,7 @@ But we want to exclude .txt and .md because the CozyUI Viewer can already show t
826892

827893
*Defined in*
828894

829-
[packages/cozy-client/src/models/file.js:101](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L101)
895+
[packages/cozy-client/src/models/file.js:132](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L132)
830896

831897
***
832898

@@ -886,4 +952,4 @@ If there is a conflict, then we apply the conflict strategy : `erase` or `rename
886952

887953
*Defined in*
888954

889-
[packages/cozy-client/src/models/file.js:514](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L514)
955+
[packages/cozy-client/src/models/file.js:545](https://github.com/cozy/cozy-client/blob/master/packages/cozy-client/src/models/file.js#L545)

0 commit comments

Comments
 (0)