@pnp/sp 2.7.0 → 2.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (309) hide show
  1. package/LICENSE +25 -25
  2. package/appcatalog/index.d.ts +8 -8
  3. package/appcatalog/index.js +30 -30
  4. package/appcatalog/types.d.ts +81 -81
  5. package/appcatalog/types.js +177 -177
  6. package/appcatalog/web.d.ts +16 -16
  7. package/appcatalog/web.js +6 -6
  8. package/attachments/index.d.ts +2 -2
  9. package/attachments/index.js +2 -2
  10. package/attachments/item.d.ts +12 -12
  11. package/attachments/item.js +4 -4
  12. package/attachments/types.d.ts +92 -92
  13. package/attachments/types.js +240 -240
  14. package/batch.d.ts +17 -17
  15. package/batch.js +223 -223
  16. package/batch.js.map +1 -1
  17. package/clientside-pages/funcs.d.ts +22 -22
  18. package/clientside-pages/funcs.js +25 -25
  19. package/clientside-pages/index.d.ts +2 -2
  20. package/clientside-pages/index.js +2 -2
  21. package/clientside-pages/types.d.ts +496 -494
  22. package/clientside-pages/types.d.ts.map +1 -1
  23. package/clientside-pages/types.js +1496 -1485
  24. package/clientside-pages/types.js.map +1 -1
  25. package/clientside-pages/web.d.ts +41 -41
  26. package/clientside-pages/web.js +57 -57
  27. package/column-defaults/folder.d.ts +27 -27
  28. package/column-defaults/folder.js +82 -82
  29. package/column-defaults/index.d.ts +3 -3
  30. package/column-defaults/index.js +2 -2
  31. package/column-defaults/list.d.ts +19 -19
  32. package/column-defaults/list.js +198 -198
  33. package/column-defaults/types.d.ts +21 -21
  34. package/column-defaults/types.js +1 -1
  35. package/comments/clientside-page.d.ts +57 -57
  36. package/comments/clientside-page.d.ts.map +1 -1
  37. package/comments/clientside-page.js +136 -136
  38. package/comments/index.d.ts +2 -2
  39. package/comments/index.js +2 -2
  40. package/comments/item.d.ts +29 -29
  41. package/comments/item.js +47 -47
  42. package/comments/types.d.ts +107 -107
  43. package/comments/types.d.ts.map +1 -1
  44. package/comments/types.js +145 -145
  45. package/comments/types.js.map +1 -1
  46. package/content-types/index.d.ts +4 -4
  47. package/content-types/index.js +4 -4
  48. package/content-types/item.d.ts +12 -12
  49. package/content-types/item.js +4 -4
  50. package/content-types/list.d.ts +12 -12
  51. package/content-types/list.js +4 -4
  52. package/content-types/types.d.ts +107 -107
  53. package/content-types/types.js +166 -166
  54. package/content-types/web.d.ts +12 -12
  55. package/content-types/web.js +4 -4
  56. package/decorators.d.ts +11 -11
  57. package/decorators.js +28 -28
  58. package/features/index.d.ts +3 -3
  59. package/features/index.js +3 -3
  60. package/features/site.d.ts +12 -12
  61. package/features/site.js +4 -4
  62. package/features/types.d.ts +47 -47
  63. package/features/types.js +109 -109
  64. package/features/web.d.ts +12 -12
  65. package/features/web.js +4 -4
  66. package/fields/index.d.ts +4 -4
  67. package/fields/index.js +4 -4
  68. package/fields/list.d.ts +12 -12
  69. package/fields/list.js +4 -4
  70. package/fields/types.d.ts +368 -361
  71. package/fields/types.d.ts.map +1 -1
  72. package/fields/types.js +624 -609
  73. package/fields/types.js.map +1 -1
  74. package/fields/web.d.ts +17 -17
  75. package/fields/web.js +5 -5
  76. package/files/folder.d.ts +12 -12
  77. package/files/folder.js +4 -4
  78. package/files/index.d.ts +4 -4
  79. package/files/index.js +4 -4
  80. package/files/item.d.ts +12 -12
  81. package/files/item.js +4 -4
  82. package/files/types.d.ts +421 -421
  83. package/files/types.js +853 -853
  84. package/files/types.js.map +1 -1
  85. package/files/web.d.ts +35 -35
  86. package/files/web.js +15 -15
  87. package/folders/index.d.ts +4 -4
  88. package/folders/index.js +4 -4
  89. package/folders/item.d.ts +9 -9
  90. package/folders/item.js +4 -4
  91. package/folders/list.d.ts +12 -12
  92. package/folders/list.js +4 -4
  93. package/folders/types.d.ts +207 -207
  94. package/folders/types.js +433 -433
  95. package/folders/types.js.map +1 -1
  96. package/folders/web.d.ts +39 -39
  97. package/folders/web.js +15 -15
  98. package/forms/index.d.ts +2 -2
  99. package/forms/index.js +2 -2
  100. package/forms/list.d.ts +9 -9
  101. package/forms/list.js +4 -4
  102. package/forms/types.d.ts +35 -35
  103. package/forms/types.js +41 -41
  104. package/hubsites/index.d.ts +12 -12
  105. package/hubsites/index.js +15 -15
  106. package/hubsites/site.d.ts +26 -26
  107. package/hubsites/site.js +39 -39
  108. package/hubsites/types.d.ts +55 -55
  109. package/hubsites/types.js +53 -53
  110. package/hubsites/web.d.ts +21 -21
  111. package/hubsites/web.js +23 -23
  112. package/index.d.ts +14 -14
  113. package/index.js +13 -13
  114. package/items/index.d.ts +2 -2
  115. package/items/index.js +2 -2
  116. package/items/list.d.ts +9 -9
  117. package/items/list.js +4 -4
  118. package/items/types.d.ts +226 -219
  119. package/items/types.d.ts.map +1 -1
  120. package/items/types.js +549 -511
  121. package/items/types.js.map +1 -1
  122. package/lists/index.d.ts +2 -2
  123. package/lists/index.js +2 -2
  124. package/lists/types.d.ts +495 -495
  125. package/lists/types.js +522 -522
  126. package/lists/types.js.map +1 -1
  127. package/lists/web.d.ts +43 -43
  128. package/lists/web.js +27 -27
  129. package/navigation/index.d.ts +8 -8
  130. package/navigation/index.js +14 -14
  131. package/navigation/types.d.ts +154 -154
  132. package/navigation/types.js +219 -219
  133. package/navigation/web.d.ts +13 -13
  134. package/navigation/web.js +4 -4
  135. package/odata.d.ts +5 -5
  136. package/odata.js +90 -90
  137. package/odata.js.map +1 -1
  138. package/operations.d.ts +9 -9
  139. package/operations.js +63 -63
  140. package/package.json +4 -4
  141. package/presets/all.d.ts +72 -72
  142. package/presets/all.js +72 -72
  143. package/presets/core.d.ts +11 -11
  144. package/presets/core.js +11 -11
  145. package/profiles/index.d.ts +7 -7
  146. package/profiles/index.js +13 -13
  147. package/profiles/types.d.ts +357 -357
  148. package/profiles/types.js +454 -454
  149. package/readme.md +21 -21
  150. package/regional-settings/content-type.d.ts +7 -7
  151. package/regional-settings/content-type.js +4 -4
  152. package/regional-settings/field.d.ts +7 -7
  153. package/regional-settings/field.js +4 -4
  154. package/regional-settings/funcs.d.ts +2 -2
  155. package/regional-settings/funcs.js +8 -8
  156. package/regional-settings/index.d.ts +6 -6
  157. package/regional-settings/index.js +6 -6
  158. package/regional-settings/list.d.ts +7 -7
  159. package/regional-settings/list.js +4 -4
  160. package/regional-settings/types.d.ts +111 -111
  161. package/regional-settings/types.js +159 -159
  162. package/regional-settings/user-custom-actions.d.ts +7 -7
  163. package/regional-settings/user-custom-actions.js +4 -4
  164. package/regional-settings/web.d.ts +12 -12
  165. package/regional-settings/web.js +7 -7
  166. package/related-items/index.d.ts +1 -1
  167. package/related-items/index.js +1 -1
  168. package/related-items/types.d.ts +76 -76
  169. package/related-items/types.js +103 -103
  170. package/related-items/web.d.ts +12 -12
  171. package/related-items/web.js +9 -9
  172. package/rest.d.ts +44 -44
  173. package/rest.js +72 -72
  174. package/search/index.d.ts +30 -30
  175. package/search/index.js +25 -25
  176. package/search/query.d.ts +62 -62
  177. package/search/query.js +302 -302
  178. package/search/suggest.d.ts +76 -76
  179. package/search/suggest.js +66 -66
  180. package/search/types.d.ts +426 -426
  181. package/search/types.js +57 -57
  182. package/security/funcs.d.ts +43 -43
  183. package/security/funcs.js +142 -142
  184. package/security/index.d.ts +4 -4
  185. package/security/index.js +4 -4
  186. package/security/item.d.ts +7 -7
  187. package/security/item.js +14 -14
  188. package/security/list.d.ts +7 -7
  189. package/security/list.js +14 -14
  190. package/security/types.d.ts +318 -318
  191. package/security/types.js +399 -399
  192. package/security/web.d.ts +9 -9
  193. package/security/web.js +15 -15
  194. package/sharepointqueryable.d.ts +135 -135
  195. package/sharepointqueryable.js +265 -265
  196. package/sharing/file.d.ts +18 -18
  197. package/sharing/file.d.ts.map +1 -1
  198. package/sharing/file.js +116 -15
  199. package/sharing/file.js.map +1 -1
  200. package/sharing/folder.d.ts +9 -9
  201. package/sharing/folder.js +136 -136
  202. package/sharing/funcs.d.ts +62 -62
  203. package/sharing/funcs.js +239 -239
  204. package/sharing/funcs.js.map +1 -1
  205. package/sharing/index.d.ts +5 -5
  206. package/sharing/index.js +5 -5
  207. package/sharing/item.d.ts +16 -16
  208. package/sharing/item.js +15 -15
  209. package/sharing/types.d.ts +583 -583
  210. package/sharing/types.js +113 -113
  211. package/sharing/web.d.ts +19 -19
  212. package/sharing/web.js +76 -76
  213. package/site-designs/index.d.ts +8 -8
  214. package/site-designs/index.js +14 -14
  215. package/site-designs/types.d.ts +319 -319
  216. package/site-designs/types.js +203 -203
  217. package/site-designs/web.d.ts +25 -25
  218. package/site-designs/web.js +11 -11
  219. package/site-groups/index.d.ts +2 -2
  220. package/site-groups/index.js +2 -2
  221. package/site-groups/types.d.ts +89 -89
  222. package/site-groups/types.js +125 -125
  223. package/site-groups/web.d.ts +40 -40
  224. package/site-groups/web.js +30 -30
  225. package/site-scripts/index.d.ts +9 -9
  226. package/site-scripts/index.js +15 -15
  227. package/site-scripts/list.d.ts +12 -12
  228. package/site-scripts/list.js +24 -24
  229. package/site-scripts/types.d.ts +183 -183
  230. package/site-scripts/types.js +141 -141
  231. package/site-scripts/web.d.ts +13 -13
  232. package/site-scripts/web.js +5 -5
  233. package/site-users/index.d.ts +2 -2
  234. package/site-users/index.js +2 -2
  235. package/site-users/types.d.ts +138 -138
  236. package/site-users/types.js +122 -122
  237. package/site-users/web.d.ts +31 -31
  238. package/site-users/web.js +27 -27
  239. package/sites/index.d.ts +7 -7
  240. package/sites/index.js +13 -13
  241. package/sites/types.d.ts +147 -147
  242. package/sites/types.js +321 -321
  243. package/social/index.d.ts +10 -10
  244. package/social/index.js +13 -13
  245. package/social/types.d.ts +309 -309
  246. package/social/types.js +322 -322
  247. package/sphttpclient.d.ts +18 -18
  248. package/sphttpclient.js +189 -189
  249. package/splibconfig.d.ts +22 -22
  250. package/splibconfig.js +13 -13
  251. package/sputilities/index.d.ts +7 -7
  252. package/sputilities/index.js +13 -13
  253. package/sputilities/types.d.ts +130 -130
  254. package/sputilities/types.js +118 -118
  255. package/subscriptions/index.d.ts +2 -2
  256. package/subscriptions/index.js +2 -2
  257. package/subscriptions/list.d.ts +13 -13
  258. package/subscriptions/list.js +4 -4
  259. package/subscriptions/types.d.ts +54 -54
  260. package/subscriptions/types.js +111 -111
  261. package/taxonomy/index.d.ts +7 -7
  262. package/taxonomy/index.js +13 -13
  263. package/taxonomy/types.d.ts +200 -200
  264. package/taxonomy/types.js +347 -347
  265. package/taxonomy/types.js.map +1 -1
  266. package/telemetry.d.ts +12 -12
  267. package/telemetry.js +48 -48
  268. package/types.d.ts +218 -218
  269. package/types.js +79 -79
  270. package/user-custom-actions/index.d.ts +4 -4
  271. package/user-custom-actions/index.js +4 -4
  272. package/user-custom-actions/list.d.ts +12 -12
  273. package/user-custom-actions/list.js +4 -4
  274. package/user-custom-actions/site.d.ts +12 -12
  275. package/user-custom-actions/site.js +4 -4
  276. package/user-custom-actions/types.d.ts +82 -82
  277. package/user-custom-actions/types.js +93 -93
  278. package/user-custom-actions/web.d.ts +15 -15
  279. package/user-custom-actions/web.js +4 -4
  280. package/utils/escapeQueryStrValue.d.ts +1 -1
  281. package/utils/escapeQueryStrValue.js +19 -19
  282. package/utils/extractweburl.d.ts +1 -1
  283. package/utils/extractweburl.js +15 -15
  284. package/utils/file-names.d.ts +17 -17
  285. package/utils/file-names.js +38 -38
  286. package/utils/metadata.d.ts +5 -5
  287. package/utils/metadata.js +5 -5
  288. package/utils/objectToSPKeyValueCollection.d.ts +20 -20
  289. package/utils/objectToSPKeyValueCollection.js +16 -16
  290. package/utils/toResourcePath.d.ts +7 -7
  291. package/utils/toResourcePath.js +6 -6
  292. package/utils/toabsoluteurl.d.ts +7 -7
  293. package/utils/toabsoluteurl.js +61 -61
  294. package/views/index.d.ts +2 -2
  295. package/views/index.js +2 -2
  296. package/views/list.d.ts +23 -23
  297. package/views/list.js +8 -8
  298. package/views/types.d.ts +140 -140
  299. package/views/types.js +184 -184
  300. package/webparts/file.d.ts +15 -15
  301. package/webparts/file.js +6 -6
  302. package/webparts/index.d.ts +2 -2
  303. package/webparts/index.js +2 -2
  304. package/webparts/types.d.ts +83 -83
  305. package/webparts/types.js +117 -117
  306. package/webs/index.d.ts +16 -16
  307. package/webs/index.js +16 -16
  308. package/webs/types.d.ts +210 -210
  309. package/webs/types.js +295 -295
package/files/types.d.ts CHANGED
@@ -1,422 +1,422 @@
1
- import { _SharePointQueryableInstance, ISharePointQueryableInstance, _SharePointQueryableCollection, IDeleteableWithETag } from "../sharepointqueryable.js";
2
- import { IItem } from "../items/index.js";
3
- /**
4
- * Describes a collection of File objects
5
- *
6
- */
7
- export declare class _Files extends _SharePointQueryableCollection<IFileInfo[]> {
8
- /**
9
- * Gets a File by filename
10
- *
11
- * @param name The name of the file, including extension.
12
- */
13
- getByName(name: string): IFile;
14
- /**
15
- * Uploads a file. Not supported for batching
16
- *
17
- * @param url The folder-relative url of the file.
18
- * @param content The file contents
19
- * @param shouldOverWrite Should a file with the same name in the same location be overwritten? (default: true)
20
- * @returns The new File and the raw response.
21
- */
22
- add(url: string, content: any, shouldOverWrite?: boolean): Promise<IFileAddResult>;
23
- /**
24
- * Adds a file using the pound percent safe methods
25
- *
26
- * @param url Excoded url of the file
27
- * @param content The file content
28
- * @param parameters Additional parameters to control method behavior
29
- */
30
- addUsingPath(url: string, content: string | ArrayBuffer | Blob, parameters?: IAddUsingPathProps): Promise<IFileAddResult>;
31
- /**
32
- * Uploads a file. Not supported for batching
33
- *
34
- * @param url The folder-relative url of the file.
35
- * @param content The Blob file content to add
36
- * @param progress A callback function which can be used to track the progress of the upload
37
- * @param shouldOverWrite Should a file with the same name in the same location be overwritten? (default: true)
38
- * @param chunkSize The size of each file slice, in bytes (default: 10485760)
39
- * @returns The new File and the raw response.
40
- */
41
- addChunked(url: string, content: Blob, progress?: (data: IFileUploadProgressData) => void, shouldOverWrite?: boolean, chunkSize?: number): Promise<IFileAddResult>;
42
- /**
43
- * Adds a ghosted file to an existing list or document library. Not supported for batching.
44
- *
45
- * @param fileUrl The server-relative url where you want to save the file.
46
- * @param templateFileType The type of use to create the file.
47
- * @returns The template file that was added and the raw response.
48
- */
49
- addTemplateFile(fileUrl: string, templateFileType: TemplateFileType): Promise<IFileAddResult>;
50
- }
51
- export interface IFiles extends _Files {
52
- }
53
- export declare const Files: import("../sharepointqueryable.js").ISPInvokableFactory<IFiles>;
54
- /**
55
- * Describes a single File instance
56
- *
57
- */
58
- export declare class _File extends _SharePointQueryableInstance<IFileInfo> {
59
- delete: (this: import("../sharepointqueryable.js").ISharePointQueryable<any>, eTag?: string) => Promise<void>;
60
- /**
61
- * Gets a value that specifies the list item field values for the list item corresponding to the file.
62
- *
63
- */
64
- get listItemAllFields(): ISharePointQueryableInstance;
65
- /**
66
- * Gets a collection of versions
67
- *
68
- */
69
- get versions(): IVersions;
70
- /**
71
- * Approves the file submitted for content approval with the specified comment.
72
- * Only documents in lists that are enabled for content approval can be approved.
73
- *
74
- * @param comment The comment for the approval.
75
- */
76
- approve(comment?: string): Promise<void>;
77
- /**
78
- * Stops the chunk upload session without saving the uploaded data. Does not support batching.
79
- * If the file doesn’t already exist in the library, the partially uploaded file will be deleted.
80
- * Use this in response to user action (as in a request to cancel an upload) or an error or exception.
81
- * Use the uploadId value that was passed to the StartUpload method that started the upload session.
82
- * This method is currently available only on Office 365.
83
- *
84
- * @param uploadId The unique identifier of the upload session.
85
- */
86
- cancelUpload(uploadId: string): Promise<void>;
87
- /**
88
- * Checks the file in to a document library based on the check-in type.
89
- *
90
- * @param comment A comment for the check-in. Its length must be <= 1023.
91
- * @param checkinType The check-in type for the file.
92
- */
93
- checkin(comment?: string, checkinType?: CheckinType): Promise<void>;
94
- /**
95
- * Checks out the file from a document library.
96
- */
97
- checkout(): Promise<void>;
98
- /**
99
- * Copies the file to the destination url.
100
- *
101
- * @param url The absolute url or server relative url of the destination file path to copy to.
102
- * @param shouldOverWrite Should a file with the same name in the same location be overwritten?
103
- */
104
- copyTo(url: string, shouldOverWrite?: boolean): Promise<void>;
105
- /**
106
- * Copies the file by path to destination path.
107
- * Also works with different site collections.
108
- *
109
- * @param destUrl The absolute url or server relative url of the destination file path to copy to.
110
- * @param shouldOverWrite Should a file with the same name in the same location be overwritten?
111
- * @param keepBoth Keep both if file with the same name in the same location already exists? Only relevant when shouldOverWrite is set to false.
112
- */
113
- copyByPath(destUrl: string, shouldOverWrite: boolean, KeepBoth?: boolean): Promise<void>;
114
- /**
115
- * Denies approval for a file that was submitted for content approval.
116
- * Only documents in lists that are enabled for content approval can be denied.
117
- *
118
- * @param comment The comment for the denial.
119
- */
120
- deny(comment?: string): Promise<void>;
121
- /**
122
- * Moves the file to the specified destination url.
123
- *
124
- * @param url The absolute url or server relative url of the destination file path to move to.
125
- * @param moveOperations The bitwise MoveOperations value for how to move the file.
126
- */
127
- moveTo(url: string, moveOperations?: MoveOperations): Promise<void>;
128
- /**
129
- * Moves the file by path to the specified destination url.
130
- * Also works with different site collections.
131
- *
132
- * @param destUrl The absolute url or server relative url of the destination file path to move to.
133
- * @param shouldOverWrite Should a file with the same name in the same location be overwritten?
134
- * @param keepBoth Keep both if file with the same name in the same location already exists? Only relevant when shouldOverWrite is set to false.
135
- */
136
- moveByPath(destUrl: string, shouldOverWrite: boolean, KeepBoth?: boolean): Promise<void>;
137
- /**
138
- * Submits the file for content approval with the specified comment.
139
- *
140
- * @param comment The comment for the published file. Its length must be <= 1023.
141
- */
142
- publish(comment?: string): Promise<void>;
143
- /**
144
- * Moves the file to the Recycle Bin and returns the identifier of the new Recycle Bin item.
145
- *
146
- * @returns The GUID of the recycled file.
147
- */
148
- recycle(): Promise<string>;
149
- /**
150
- * Deletes the file object with options.
151
- *
152
- * @param parameters Specifies the options to use when deleting a file.
153
- */
154
- deleteWithParams(parameters: Partial<IFileDeleteParams>): Promise<void>;
155
- /**
156
- * Reverts an existing checkout for the file.
157
- *
158
- */
159
- undoCheckout(): Promise<void>;
160
- /**
161
- * Removes the file from content approval or unpublish a major version.
162
- *
163
- * @param comment The comment for the unpublish operation. Its length must be <= 1023.
164
- */
165
- unpublish(comment?: string): Promise<void>;
166
- /**
167
- * Checks to see if the file represented by this object exists
168
- *
169
- */
170
- exists(): Promise<boolean>;
171
- /**
172
- * Gets the contents of the file as text. Not supported in batching.
173
- *
174
- */
175
- getText(): Promise<string>;
176
- /**
177
- * Gets the contents of the file as a blob, does not work in Node.js. Not supported in batching.
178
- *
179
- */
180
- getBlob(): Promise<Blob>;
181
- /**
182
- * Gets the contents of a file as an ArrayBuffer, works in Node.js. Not supported in batching.
183
- */
184
- getBuffer(): Promise<ArrayBuffer>;
185
- /**
186
- * Gets the contents of a file as an ArrayBuffer, works in Node.js. Not supported in batching.
187
- */
188
- getJSON(): Promise<any>;
189
- /**
190
- * Sets the content of a file, for large files use setContentChunked. Not supported in batching.
191
- *
192
- * @param content The file content
193
- *
194
- */
195
- setContent(content: string | ArrayBuffer | Blob): Promise<IFile>;
196
- /**
197
- * Gets the associated list item for this file, loading the default properties
198
- */
199
- getItem<T>(...selects: string[]): Promise<IItem & T>;
200
- /**
201
- * Sets the contents of a file using a chunked upload approach. Not supported in batching.
202
- *
203
- * @param file The file to upload
204
- * @param progress A callback function which can be used to track the progress of the upload
205
- * @param chunkSize The size of each file slice, in bytes (default: 10485760)
206
- */
207
- setContentChunked(file: Blob, progress?: (data: IFileUploadProgressData) => void, chunkSize?: number): Promise<IFileAddResult>;
208
- /**
209
- * Starts a new chunk upload session and uploads the first fragment.
210
- * The current file content is not changed when this method completes.
211
- * The method is idempotent (and therefore does not change the result) as long as you use the same values for uploadId and stream.
212
- * The upload session ends either when you use the CancelUpload method or when you successfully
213
- * complete the upload session by passing the rest of the file contents through the ContinueUpload and FinishUpload methods.
214
- * The StartUpload and ContinueUpload methods return the size of the running total of uploaded data in bytes,
215
- * so you can pass those return values to subsequent uses of ContinueUpload and FinishUpload.
216
- * This method is currently available only on Office 365.
217
- *
218
- * @param uploadId The unique identifier of the upload session.
219
- * @param fragment The file contents.
220
- * @returns The size of the total uploaded data in bytes.
221
- */
222
- protected startUpload(uploadId: string, fragment: ArrayBuffer | Blob): Promise<number>;
223
- /**
224
- * Continues the chunk upload session with an additional fragment.
225
- * The current file content is not changed.
226
- * Use the uploadId value that was passed to the StartUpload method that started the upload session.
227
- * This method is currently available only on Office 365.
228
- *
229
- * @param uploadId The unique identifier of the upload session.
230
- * @param fileOffset The size of the offset into the file where the fragment starts.
231
- * @param fragment The file contents.
232
- * @returns The size of the total uploaded data in bytes.
233
- */
234
- protected continueUpload(uploadId: string, fileOffset: number, fragment: ArrayBuffer | Blob): Promise<number>;
235
- /**
236
- * Uploads the last file fragment and commits the file. The current file content is changed when this method completes.
237
- * Use the uploadId value that was passed to the StartUpload method that started the upload session.
238
- * This method is currently available only on Office 365.
239
- *
240
- * @param uploadId The unique identifier of the upload session.
241
- * @param fileOffset The size of the offset into the file where the fragment starts.
242
- * @param fragment The file contents.
243
- * @returns The newly uploaded file.
244
- */
245
- protected finishUpload(uploadId: string, fileOffset: number, fragment: ArrayBuffer | Blob): Promise<IFileAddResult>;
246
- }
247
- export interface IFile extends _File, IDeleteableWithETag {
248
- }
249
- export declare const File: import("../sharepointqueryable.js").ISPInvokableFactory<IFile>;
250
- /**
251
- * Describes a collection of Version objects
252
- *
253
- */
254
- export declare class _Versions extends _SharePointQueryableCollection {
255
- /**
256
- * Gets a version by id
257
- *
258
- * @param versionId The id of the version to retrieve
259
- */
260
- getById(versionId: number): IVersion;
261
- /**
262
- * Deletes all the file version objects in the collection.
263
- *
264
- */
265
- deleteAll(): Promise<void>;
266
- /**
267
- * Deletes the specified version of the file.
268
- *
269
- * @param versionId The ID of the file version to delete.
270
- */
271
- deleteById(versionId: number): Promise<void>;
272
- /**
273
- * Recycles the specified version of the file.
274
- *
275
- * @param versionId The ID of the file version to delete.
276
- */
277
- recycleByID(versionId: number): Promise<void>;
278
- /**
279
- * Deletes the file version object with the specified version label.
280
- *
281
- * @param label The version label of the file version to delete, for example: 1.2
282
- */
283
- deleteByLabel(label: string): Promise<void>;
284
- /**
285
- * Recycles the file version object with the specified version label.
286
- *
287
- * @param label The version label of the file version to delete, for example: 1.2
288
- */
289
- recycleByLabel(label: string): Promise<void>;
290
- /**
291
- * Creates a new file version from the file specified by the version label.
292
- *
293
- * @param label The version label of the file version to restore, for example: 1.2
294
- */
295
- restoreByLabel(label: string): Promise<void>;
296
- }
297
- export interface IVersions extends _Versions {
298
- }
299
- export declare const Versions: import("../sharepointqueryable.js").ISPInvokableFactory<IVersions>;
300
- /**
301
- * Describes a single Version instance
302
- *
303
- */
304
- export declare class _Version extends _SharePointQueryableInstance {
305
- delete: (this: import("../sharepointqueryable.js").ISharePointQueryable<any>, eTag?: string) => Promise<void>;
306
- }
307
- export interface IVersion extends _Version, IDeleteableWithETag {
308
- }
309
- export declare const Version: import("../sharepointqueryable.js").ISPInvokableFactory<IVersion>;
310
- /**
311
- * Types for document check in.
312
- * Minor = 0
313
- * Major = 1
314
- * Overwrite = 2
315
- */
316
- export declare enum CheckinType {
317
- Minor = 0,
318
- Major = 1,
319
- Overwrite = 2
320
- }
321
- /**
322
- * Describes file and result
323
- */
324
- export interface IFileAddResult {
325
- file: IFile;
326
- data: IFileInfo;
327
- }
328
- /**
329
- * File move opertions
330
- */
331
- export declare enum MoveOperations {
332
- /**
333
- * Produce an error if a file with the same name exists in the destination
334
- */
335
- None = 0,
336
- /**
337
- * Overwrite a file with the same name if it exists. Value is 1.
338
- */
339
- Overwrite = 1,
340
- /**
341
- * Complete the move operation even if supporting files are separated from the file. Value is 8.
342
- */
343
- AllowBrokenThickets = 8,
344
- /**
345
- * Boolean specifying whether to retain the source of the move's editor and modified by datetime.
346
- */
347
- RetainEditorAndModifiedOnMove = 2048
348
- }
349
- export declare enum TemplateFileType {
350
- StandardPage = 0,
351
- WikiPage = 1,
352
- FormPage = 2,
353
- ClientSidePage = 3
354
- }
355
- /**
356
- * Describes SharePoint file upload progress data
357
- */
358
- export interface IFileUploadProgressData {
359
- uploadId: string;
360
- stage: "starting" | "continue" | "finishing";
361
- blockNumber: number;
362
- totalBlocks: number;
363
- chunkSize: number;
364
- currentPointer: number;
365
- fileSize: number;
366
- }
367
- export interface IAddUsingPathProps {
368
- /**
369
- * Overwrite the file if it exists
370
- */
371
- Overwrite: boolean;
372
- /**
373
- * specifies whether to auto checkout on invalid Data. It'll be useful if the list contains validation whose requirements upload will not be able to meet.
374
- */
375
- AutoCheckoutOnInvalidData?: boolean;
376
- /**
377
- * Specifies a XOR hash of the file data which should be used to ensure end-2-end data integrity, base64 representation
378
- */
379
- XorHash?: string;
380
- }
381
- export interface IFileInfo {
382
- readonly "odata.id": string;
383
- CheckInComment: string;
384
- CheckOutType: number;
385
- ContentTag: string;
386
- CustomizedPageStatus: number;
387
- ETag: string;
388
- Exists: boolean;
389
- IrmEnabled: boolean;
390
- Length: string;
391
- Level: number;
392
- LinkingUri: string | null;
393
- LinkingUrl: string;
394
- ListId: string;
395
- MajorVersion: number;
396
- MinorVersion: number;
397
- Name: string;
398
- ServerRelativeUrl: string;
399
- SiteId: string;
400
- TimeCreated: string;
401
- TimeLastModified: string;
402
- Title: string | null;
403
- UIVersion: number;
404
- UIVersionLabel: string;
405
- UniqueId: string;
406
- WebId: string;
407
- }
408
- export interface IFileDeleteParams {
409
- /**
410
- * If true, delete or recyle a file when the LockType
411
- * value is SPLockType.Shared or SPLockType.None.
412
- * When false, delete or recycle the file when
413
- * the LockType value SPLockType.None.
414
- */
415
- BypassSharedLock: boolean;
416
- /**
417
- * Gets or sets a string value that allows SPfile delete and recycle methods
418
- * to target a file with a matching value. Use null to unconditionally delete the file.
419
- */
420
- ETagMatch: string;
421
- }
1
+ import { _SharePointQueryableInstance, ISharePointQueryableInstance, _SharePointQueryableCollection, IDeleteableWithETag } from "../sharepointqueryable.js";
2
+ import { IItem } from "../items/index.js";
3
+ /**
4
+ * Describes a collection of File objects
5
+ *
6
+ */
7
+ export declare class _Files extends _SharePointQueryableCollection<IFileInfo[]> {
8
+ /**
9
+ * Gets a File by filename
10
+ *
11
+ * @param name The name of the file, including extension.
12
+ */
13
+ getByName(name: string): IFile;
14
+ /**
15
+ * Uploads a file. Not supported for batching
16
+ *
17
+ * @param url The folder-relative url of the file.
18
+ * @param content The file contents
19
+ * @param shouldOverWrite Should a file with the same name in the same location be overwritten? (default: true)
20
+ * @returns The new File and the raw response.
21
+ */
22
+ add(url: string, content: any, shouldOverWrite?: boolean): Promise<IFileAddResult>;
23
+ /**
24
+ * Adds a file using the pound percent safe methods
25
+ *
26
+ * @param url Excoded url of the file
27
+ * @param content The file content
28
+ * @param parameters Additional parameters to control method behavior
29
+ */
30
+ addUsingPath(url: string, content: string | ArrayBuffer | Blob, parameters?: IAddUsingPathProps): Promise<IFileAddResult>;
31
+ /**
32
+ * Uploads a file. Not supported for batching
33
+ *
34
+ * @param url The folder-relative url of the file.
35
+ * @param content The Blob file content to add
36
+ * @param progress A callback function which can be used to track the progress of the upload
37
+ * @param shouldOverWrite Should a file with the same name in the same location be overwritten? (default: true)
38
+ * @param chunkSize The size of each file slice, in bytes (default: 10485760)
39
+ * @returns The new File and the raw response.
40
+ */
41
+ addChunked(url: string, content: Blob, progress?: (data: IFileUploadProgressData) => void, shouldOverWrite?: boolean, chunkSize?: number): Promise<IFileAddResult>;
42
+ /**
43
+ * Adds a ghosted file to an existing list or document library. Not supported for batching.
44
+ *
45
+ * @param fileUrl The server-relative url where you want to save the file.
46
+ * @param templateFileType The type of use to create the file.
47
+ * @returns The template file that was added and the raw response.
48
+ */
49
+ addTemplateFile(fileUrl: string, templateFileType: TemplateFileType): Promise<IFileAddResult>;
50
+ }
51
+ export interface IFiles extends _Files {
52
+ }
53
+ export declare const Files: import("../sharepointqueryable.js").ISPInvokableFactory<IFiles>;
54
+ /**
55
+ * Describes a single File instance
56
+ *
57
+ */
58
+ export declare class _File extends _SharePointQueryableInstance<IFileInfo> {
59
+ delete: (this: import("../sharepointqueryable.js").ISharePointQueryable<any>, eTag?: string) => Promise<void>;
60
+ /**
61
+ * Gets a value that specifies the list item field values for the list item corresponding to the file.
62
+ *
63
+ */
64
+ get listItemAllFields(): ISharePointQueryableInstance;
65
+ /**
66
+ * Gets a collection of versions
67
+ *
68
+ */
69
+ get versions(): IVersions;
70
+ /**
71
+ * Approves the file submitted for content approval with the specified comment.
72
+ * Only documents in lists that are enabled for content approval can be approved.
73
+ *
74
+ * @param comment The comment for the approval.
75
+ */
76
+ approve(comment?: string): Promise<void>;
77
+ /**
78
+ * Stops the chunk upload session without saving the uploaded data. Does not support batching.
79
+ * If the file doesn’t already exist in the library, the partially uploaded file will be deleted.
80
+ * Use this in response to user action (as in a request to cancel an upload) or an error or exception.
81
+ * Use the uploadId value that was passed to the StartUpload method that started the upload session.
82
+ * This method is currently available only on Office 365.
83
+ *
84
+ * @param uploadId The unique identifier of the upload session.
85
+ */
86
+ cancelUpload(uploadId: string): Promise<void>;
87
+ /**
88
+ * Checks the file in to a document library based on the check-in type.
89
+ *
90
+ * @param comment A comment for the check-in. Its length must be <= 1023.
91
+ * @param checkinType The check-in type for the file.
92
+ */
93
+ checkin(comment?: string, checkinType?: CheckinType): Promise<void>;
94
+ /**
95
+ * Checks out the file from a document library.
96
+ */
97
+ checkout(): Promise<void>;
98
+ /**
99
+ * Copies the file to the destination url.
100
+ *
101
+ * @param url The absolute url or server relative url of the destination file path to copy to.
102
+ * @param shouldOverWrite Should a file with the same name in the same location be overwritten?
103
+ */
104
+ copyTo(url: string, shouldOverWrite?: boolean): Promise<void>;
105
+ /**
106
+ * Copies the file by path to destination path.
107
+ * Also works with different site collections.
108
+ *
109
+ * @param destUrl The absolute url or server relative url of the destination file path to copy to.
110
+ * @param shouldOverWrite Should a file with the same name in the same location be overwritten?
111
+ * @param keepBoth Keep both if file with the same name in the same location already exists? Only relevant when shouldOverWrite is set to false.
112
+ */
113
+ copyByPath(destUrl: string, shouldOverWrite: boolean, KeepBoth?: boolean): Promise<void>;
114
+ /**
115
+ * Denies approval for a file that was submitted for content approval.
116
+ * Only documents in lists that are enabled for content approval can be denied.
117
+ *
118
+ * @param comment The comment for the denial.
119
+ */
120
+ deny(comment?: string): Promise<void>;
121
+ /**
122
+ * Moves the file to the specified destination url.
123
+ *
124
+ * @param url The absolute url or server relative url of the destination file path to move to.
125
+ * @param moveOperations The bitwise MoveOperations value for how to move the file.
126
+ */
127
+ moveTo(url: string, moveOperations?: MoveOperations): Promise<void>;
128
+ /**
129
+ * Moves the file by path to the specified destination url.
130
+ * Also works with different site collections.
131
+ *
132
+ * @param destUrl The absolute url or server relative url of the destination file path to move to.
133
+ * @param shouldOverWrite Should a file with the same name in the same location be overwritten?
134
+ * @param keepBoth Keep both if file with the same name in the same location already exists? Only relevant when shouldOverWrite is set to false.
135
+ */
136
+ moveByPath(destUrl: string, shouldOverWrite: boolean, KeepBoth?: boolean): Promise<void>;
137
+ /**
138
+ * Submits the file for content approval with the specified comment.
139
+ *
140
+ * @param comment The comment for the published file. Its length must be <= 1023.
141
+ */
142
+ publish(comment?: string): Promise<void>;
143
+ /**
144
+ * Moves the file to the Recycle Bin and returns the identifier of the new Recycle Bin item.
145
+ *
146
+ * @returns The GUID of the recycled file.
147
+ */
148
+ recycle(): Promise<string>;
149
+ /**
150
+ * Deletes the file object with options.
151
+ *
152
+ * @param parameters Specifies the options to use when deleting a file.
153
+ */
154
+ deleteWithParams(parameters: Partial<IFileDeleteParams>): Promise<void>;
155
+ /**
156
+ * Reverts an existing checkout for the file.
157
+ *
158
+ */
159
+ undoCheckout(): Promise<void>;
160
+ /**
161
+ * Removes the file from content approval or unpublish a major version.
162
+ *
163
+ * @param comment The comment for the unpublish operation. Its length must be <= 1023.
164
+ */
165
+ unpublish(comment?: string): Promise<void>;
166
+ /**
167
+ * Checks to see if the file represented by this object exists
168
+ *
169
+ */
170
+ exists(): Promise<boolean>;
171
+ /**
172
+ * Gets the contents of the file as text. Not supported in batching.
173
+ *
174
+ */
175
+ getText(): Promise<string>;
176
+ /**
177
+ * Gets the contents of the file as a blob, does not work in Node.js. Not supported in batching.
178
+ *
179
+ */
180
+ getBlob(): Promise<Blob>;
181
+ /**
182
+ * Gets the contents of a file as an ArrayBuffer, works in Node.js. Not supported in batching.
183
+ */
184
+ getBuffer(): Promise<ArrayBuffer>;
185
+ /**
186
+ * Gets the contents of a file as an ArrayBuffer, works in Node.js. Not supported in batching.
187
+ */
188
+ getJSON(): Promise<any>;
189
+ /**
190
+ * Sets the content of a file, for large files use setContentChunked. Not supported in batching.
191
+ *
192
+ * @param content The file content
193
+ *
194
+ */
195
+ setContent(content: string | ArrayBuffer | Blob): Promise<IFile>;
196
+ /**
197
+ * Gets the associated list item for this file, loading the default properties
198
+ */
199
+ getItem<T>(...selects: string[]): Promise<IItem & T>;
200
+ /**
201
+ * Sets the contents of a file using a chunked upload approach. Not supported in batching.
202
+ *
203
+ * @param file The file to upload
204
+ * @param progress A callback function which can be used to track the progress of the upload
205
+ * @param chunkSize The size of each file slice, in bytes (default: 10485760)
206
+ */
207
+ setContentChunked(file: Blob, progress?: (data: IFileUploadProgressData) => void, chunkSize?: number): Promise<IFileAddResult>;
208
+ /**
209
+ * Starts a new chunk upload session and uploads the first fragment.
210
+ * The current file content is not changed when this method completes.
211
+ * The method is idempotent (and therefore does not change the result) as long as you use the same values for uploadId and stream.
212
+ * The upload session ends either when you use the CancelUpload method or when you successfully
213
+ * complete the upload session by passing the rest of the file contents through the ContinueUpload and FinishUpload methods.
214
+ * The StartUpload and ContinueUpload methods return the size of the running total of uploaded data in bytes,
215
+ * so you can pass those return values to subsequent uses of ContinueUpload and FinishUpload.
216
+ * This method is currently available only on Office 365.
217
+ *
218
+ * @param uploadId The unique identifier of the upload session.
219
+ * @param fragment The file contents.
220
+ * @returns The size of the total uploaded data in bytes.
221
+ */
222
+ protected startUpload(uploadId: string, fragment: ArrayBuffer | Blob): Promise<number>;
223
+ /**
224
+ * Continues the chunk upload session with an additional fragment.
225
+ * The current file content is not changed.
226
+ * Use the uploadId value that was passed to the StartUpload method that started the upload session.
227
+ * This method is currently available only on Office 365.
228
+ *
229
+ * @param uploadId The unique identifier of the upload session.
230
+ * @param fileOffset The size of the offset into the file where the fragment starts.
231
+ * @param fragment The file contents.
232
+ * @returns The size of the total uploaded data in bytes.
233
+ */
234
+ protected continueUpload(uploadId: string, fileOffset: number, fragment: ArrayBuffer | Blob): Promise<number>;
235
+ /**
236
+ * Uploads the last file fragment and commits the file. The current file content is changed when this method completes.
237
+ * Use the uploadId value that was passed to the StartUpload method that started the upload session.
238
+ * This method is currently available only on Office 365.
239
+ *
240
+ * @param uploadId The unique identifier of the upload session.
241
+ * @param fileOffset The size of the offset into the file where the fragment starts.
242
+ * @param fragment The file contents.
243
+ * @returns The newly uploaded file.
244
+ */
245
+ protected finishUpload(uploadId: string, fileOffset: number, fragment: ArrayBuffer | Blob): Promise<IFileAddResult>;
246
+ }
247
+ export interface IFile extends _File, IDeleteableWithETag {
248
+ }
249
+ export declare const File: import("../sharepointqueryable.js").ISPInvokableFactory<IFile>;
250
+ /**
251
+ * Describes a collection of Version objects
252
+ *
253
+ */
254
+ export declare class _Versions extends _SharePointQueryableCollection {
255
+ /**
256
+ * Gets a version by id
257
+ *
258
+ * @param versionId The id of the version to retrieve
259
+ */
260
+ getById(versionId: number): IVersion;
261
+ /**
262
+ * Deletes all the file version objects in the collection.
263
+ *
264
+ */
265
+ deleteAll(): Promise<void>;
266
+ /**
267
+ * Deletes the specified version of the file.
268
+ *
269
+ * @param versionId The ID of the file version to delete.
270
+ */
271
+ deleteById(versionId: number): Promise<void>;
272
+ /**
273
+ * Recycles the specified version of the file.
274
+ *
275
+ * @param versionId The ID of the file version to delete.
276
+ */
277
+ recycleByID(versionId: number): Promise<void>;
278
+ /**
279
+ * Deletes the file version object with the specified version label.
280
+ *
281
+ * @param label The version label of the file version to delete, for example: 1.2
282
+ */
283
+ deleteByLabel(label: string): Promise<void>;
284
+ /**
285
+ * Recycles the file version object with the specified version label.
286
+ *
287
+ * @param label The version label of the file version to delete, for example: 1.2
288
+ */
289
+ recycleByLabel(label: string): Promise<void>;
290
+ /**
291
+ * Creates a new file version from the file specified by the version label.
292
+ *
293
+ * @param label The version label of the file version to restore, for example: 1.2
294
+ */
295
+ restoreByLabel(label: string): Promise<void>;
296
+ }
297
+ export interface IVersions extends _Versions {
298
+ }
299
+ export declare const Versions: import("../sharepointqueryable.js").ISPInvokableFactory<IVersions>;
300
+ /**
301
+ * Describes a single Version instance
302
+ *
303
+ */
304
+ export declare class _Version extends _SharePointQueryableInstance {
305
+ delete: (this: import("../sharepointqueryable.js").ISharePointQueryable<any>, eTag?: string) => Promise<void>;
306
+ }
307
+ export interface IVersion extends _Version, IDeleteableWithETag {
308
+ }
309
+ export declare const Version: import("../sharepointqueryable.js").ISPInvokableFactory<IVersion>;
310
+ /**
311
+ * Types for document check in.
312
+ * Minor = 0
313
+ * Major = 1
314
+ * Overwrite = 2
315
+ */
316
+ export declare enum CheckinType {
317
+ Minor = 0,
318
+ Major = 1,
319
+ Overwrite = 2
320
+ }
321
+ /**
322
+ * Describes file and result
323
+ */
324
+ export interface IFileAddResult {
325
+ file: IFile;
326
+ data: IFileInfo;
327
+ }
328
+ /**
329
+ * File move opertions
330
+ */
331
+ export declare enum MoveOperations {
332
+ /**
333
+ * Produce an error if a file with the same name exists in the destination
334
+ */
335
+ None = 0,
336
+ /**
337
+ * Overwrite a file with the same name if it exists. Value is 1.
338
+ */
339
+ Overwrite = 1,
340
+ /**
341
+ * Complete the move operation even if supporting files are separated from the file. Value is 8.
342
+ */
343
+ AllowBrokenThickets = 8,
344
+ /**
345
+ * Boolean specifying whether to retain the source of the move's editor and modified by datetime.
346
+ */
347
+ RetainEditorAndModifiedOnMove = 2048
348
+ }
349
+ export declare enum TemplateFileType {
350
+ StandardPage = 0,
351
+ WikiPage = 1,
352
+ FormPage = 2,
353
+ ClientSidePage = 3
354
+ }
355
+ /**
356
+ * Describes SharePoint file upload progress data
357
+ */
358
+ export interface IFileUploadProgressData {
359
+ uploadId: string;
360
+ stage: "starting" | "continue" | "finishing";
361
+ blockNumber: number;
362
+ totalBlocks: number;
363
+ chunkSize: number;
364
+ currentPointer: number;
365
+ fileSize: number;
366
+ }
367
+ export interface IAddUsingPathProps {
368
+ /**
369
+ * Overwrite the file if it exists
370
+ */
371
+ Overwrite: boolean;
372
+ /**
373
+ * specifies whether to auto checkout on invalid Data. It'll be useful if the list contains validation whose requirements upload will not be able to meet.
374
+ */
375
+ AutoCheckoutOnInvalidData?: boolean;
376
+ /**
377
+ * Specifies a XOR hash of the file data which should be used to ensure end-2-end data integrity, base64 representation
378
+ */
379
+ XorHash?: string;
380
+ }
381
+ export interface IFileInfo {
382
+ readonly "odata.id": string;
383
+ CheckInComment: string;
384
+ CheckOutType: number;
385
+ ContentTag: string;
386
+ CustomizedPageStatus: number;
387
+ ETag: string;
388
+ Exists: boolean;
389
+ IrmEnabled: boolean;
390
+ Length: string;
391
+ Level: number;
392
+ LinkingUri: string | null;
393
+ LinkingUrl: string;
394
+ ListId: string;
395
+ MajorVersion: number;
396
+ MinorVersion: number;
397
+ Name: string;
398
+ ServerRelativeUrl: string;
399
+ SiteId: string;
400
+ TimeCreated: string;
401
+ TimeLastModified: string;
402
+ Title: string | null;
403
+ UIVersion: number;
404
+ UIVersionLabel: string;
405
+ UniqueId: string;
406
+ WebId: string;
407
+ }
408
+ export interface IFileDeleteParams {
409
+ /**
410
+ * If true, delete or recyle a file when the LockType
411
+ * value is SPLockType.Shared or SPLockType.None.
412
+ * When false, delete or recycle the file when
413
+ * the LockType value SPLockType.None.
414
+ */
415
+ BypassSharedLock: boolean;
416
+ /**
417
+ * Gets or sets a string value that allows SPfile delete and recycle methods
418
+ * to target a file with a matching value. Use null to unconditionally delete the file.
419
+ */
420
+ ETagMatch: string;
421
+ }
422
422
  //# sourceMappingURL=types.d.ts.map