@formio/js 5.0.0-rc.43 → 5.0.0-rc.44
Sign up to get free protection for your applications and to get access to all the features.
- package/dist/formio.embed.js +1 -1
- package/dist/formio.embed.min.js +1 -1
- package/dist/formio.embed.min.js.LICENSE.txt +1 -1
- package/dist/formio.form.js +602 -580
- package/dist/formio.form.min.js +1 -1
- package/dist/formio.form.min.js.LICENSE.txt +1 -11
- package/dist/formio.full.js +605 -583
- package/dist/formio.full.min.js +1 -1
- package/dist/formio.full.min.js.LICENSE.txt +1 -11
- package/dist/formio.js +10 -11
- package/dist/formio.min.js +1 -1
- package/dist/formio.min.js.LICENSE.txt +1 -1
- package/dist/formio.utils.js +1 -1
- package/dist/formio.utils.min.js +1 -1
- package/dist/formio.utils.min.js.LICENSE.txt +1 -1
- package/lib/cjs/Element.js +2 -0
- package/lib/cjs/Form.js +3 -1
- package/lib/cjs/Webform.js +93 -15
- package/lib/cjs/WebformBuilder.js +8 -8
- package/lib/cjs/components/_classes/component/Component.js +25 -8
- package/lib/cjs/components/_classes/componentModal/ComponentModal.js +5 -4
- package/lib/cjs/components/_classes/input/Input.js +1 -1
- package/lib/cjs/components/_classes/multivalue/Multivalue.js +1 -1
- package/lib/cjs/components/_classes/nested/NestedComponent.js +4 -2
- package/lib/cjs/components/datagrid/DataGrid.js +1 -1
- package/lib/cjs/components/editgrid/EditGrid.js +3 -3
- package/lib/cjs/components/form/Form.js +1 -1
- package/lib/cjs/components/html/HTML.js +2 -2
- package/lib/cjs/components/html/fixtures/comp3.js +40 -0
- package/lib/cjs/components/html/fixtures/index.js +3 -1
- package/lib/cjs/components/radio/Radio.js +29 -10
- package/lib/cjs/components/radio/editForm/Radio.edit.data.js +20 -0
- package/lib/cjs/components/radio/fixtures/comp11.js +85 -0
- package/lib/cjs/components/radio/fixtures/index.js +3 -1
- package/lib/cjs/components/select/Select.js +3 -0
- package/lib/cjs/components/select/editForm/Select.edit.data.js +63 -1
- package/lib/cjs/components/signature/Signature.js +1 -1
- package/lib/cjs/components/textarea/TextArea.js +1 -1
- package/lib/cjs/formio.form.js +5 -1
- package/lib/cjs/providers/storage/s3.js +29 -1
- package/lib/mjs/Element.js +2 -0
- package/lib/mjs/Form.js +3 -1
- package/lib/mjs/Webform.js +98 -16
- package/lib/mjs/WebformBuilder.js +8 -8
- package/lib/mjs/components/_classes/component/Component.js +25 -8
- package/lib/mjs/components/_classes/componentModal/ComponentModal.js +5 -4
- package/lib/mjs/components/_classes/input/Input.js +1 -1
- package/lib/mjs/components/_classes/multivalue/Multivalue.js +1 -1
- package/lib/mjs/components/_classes/nested/NestedComponent.js +4 -2
- package/lib/mjs/components/datagrid/DataGrid.js +1 -1
- package/lib/mjs/components/editgrid/EditGrid.js +3 -3
- package/lib/mjs/components/form/Form.js +1 -1
- package/lib/mjs/components/html/HTML.js +2 -2
- package/lib/mjs/components/html/fixtures/comp3.js +38 -0
- package/lib/mjs/components/html/fixtures/index.js +2 -1
- package/lib/mjs/components/radio/Radio.js +29 -10
- package/lib/mjs/components/radio/editForm/Radio.edit.data.js +20 -0
- package/lib/mjs/components/radio/fixtures/comp11.js +83 -0
- package/lib/mjs/components/radio/fixtures/index.js +2 -1
- package/lib/mjs/components/select/Select.js +3 -0
- package/lib/mjs/components/select/editForm/Select.edit.data.js +59 -1
- package/lib/mjs/components/signature/Signature.js +1 -1
- package/lib/mjs/components/textarea/TextArea.js +1 -1
- package/lib/mjs/formio.form.js +3 -1
- package/lib/mjs/providers/storage/s3.js +6 -1
- package/package.json +7 -8
- package/types/builders.d.ts +0 -7
- package/types/components/_classes/component/component.d.ts +0 -175
- package/types/components/_classes/componentmodal/componentmodal.d.ts +0 -31
- package/types/components/_classes/field/field.d.ts +0 -5
- package/types/components/_classes/input/input.d.ts +0 -30
- package/types/components/_classes/multivalue/multivalue.d.ts +0 -16
- package/types/components/_classes/nested/nestedComponent.d.ts +0 -61
- package/types/components/_classes/widgetcomponent/widgetComponent.d.ts +0 -6
- package/types/components/components.d.ts +0 -69
- package/types/components/schema.d.ts +0 -174
- package/types/displays.d.ts +0 -7
- package/types/element.d.ts +0 -45
- package/types/eventEmitter.d.ts +0 -3
- package/types/form.d.ts +0 -18
- package/types/formbuilder.d.ts +0 -6
- package/types/formio.d.ts +0 -1236
- package/types/index.d.ts +0 -18
- package/types/licenses.d.ts +0 -7
- package/types/providers.d.ts +0 -8
- package/types/rulesEngine/conjunctions.d.ts +0 -7
- package/types/rulesEngine/operators.d.ts +0 -7
- package/types/rulesEngine/quckRules.d.ts +0 -7
- package/types/rulesEngine/rules.d.ts +0 -7
- package/types/rulesEngine/transformers.d.ts +0 -7
- package/types/rulesEngine/valueSources.d.ts +0 -7
- package/types/templates.d.ts +0 -8
- package/types/utils.d.ts +0 -157
- package/types/widgets.d.ts +0 -4
package/types/formio.d.ts
DELETED
@@ -1,1236 +0,0 @@
|
|
1
|
-
import EventEmitter from 'eventemitter3';
|
2
|
-
import Plugins from './Plugins';
|
3
|
-
|
4
|
-
export interface FormioLibrarySource {
|
5
|
-
type: string;
|
6
|
-
src: string;
|
7
|
-
}
|
8
|
-
|
9
|
-
/**
|
10
|
-
* The Formio class options interface.
|
11
|
-
*/
|
12
|
-
export interface FormioOptions {
|
13
|
-
/**
|
14
|
-
* The base API url of the Form.io Platform. Example: https://api.form.io
|
15
|
-
*/
|
16
|
-
base?: string;
|
17
|
-
/**
|
18
|
-
* The project API url of the Form.io Project. Example: https://examples.form.io
|
19
|
-
*/
|
20
|
-
project?: string;
|
21
|
-
useSessionToken?: boolean;
|
22
|
-
formOnly?: boolean;
|
23
|
-
}
|
24
|
-
/**
|
25
|
-
* The different path types for a project.
|
26
|
-
*/
|
27
|
-
export declare enum FormioPathType {
|
28
|
-
Subdirectories = 'Subdirectories',
|
29
|
-
Subdomains = 'Subdomains'
|
30
|
-
}
|
31
|
-
|
32
|
-
export interface ConditionalOptions {
|
33
|
-
/** If the field should show if the condition is true */
|
34
|
-
show?: boolean;
|
35
|
-
/** The field API key that it should compare its value against to determine if the condition is triggered. */
|
36
|
-
when?: string;
|
37
|
-
/** The value that should be checked against the comparison component */
|
38
|
-
eq?: string;
|
39
|
-
/** The JSON Logic to determine if this component is conditionally available.
|
40
|
-
* Fyi: http://jsonlogic.com/
|
41
|
-
*/
|
42
|
-
json?: Object;
|
43
|
-
}
|
44
|
-
|
45
|
-
export interface ValidateOptions {
|
46
|
-
/**
|
47
|
-
* If this component is required.
|
48
|
-
*/
|
49
|
-
required?: boolean;
|
50
|
-
|
51
|
-
/**
|
52
|
-
* For text input, this checks the minimum length of text for valid input
|
53
|
-
*/
|
54
|
-
minLength?: number;
|
55
|
-
|
56
|
-
/**
|
57
|
-
* For text input, this checks the maximum length of text for valid input
|
58
|
-
*/
|
59
|
-
maxLength?: number;
|
60
|
-
|
61
|
-
/**
|
62
|
-
* For text input, this checks the text agains a Regular expression pattern.
|
63
|
-
*/
|
64
|
-
pattern?: string;
|
65
|
-
|
66
|
-
/**
|
67
|
-
* A custom javascript based validation or a JSON object for using JSON Logic
|
68
|
-
*/
|
69
|
-
custom?: any;
|
70
|
-
|
71
|
-
/**
|
72
|
-
* If the custom validation should remain private (only the backend will see it and execute it).
|
73
|
-
*/
|
74
|
-
customPrivate?: boolean;
|
75
|
-
|
76
|
-
/**
|
77
|
-
* Minimum value for numbers
|
78
|
-
*/
|
79
|
-
min?: number;
|
80
|
-
|
81
|
-
/**
|
82
|
-
* Maximum value for numbers
|
83
|
-
*/
|
84
|
-
max?: number;
|
85
|
-
|
86
|
-
minSelectedCount?: number;
|
87
|
-
maxSelectedCount?: number;
|
88
|
-
minWords?: number;
|
89
|
-
maxWords?: number;
|
90
|
-
email?: boolean;
|
91
|
-
url?: boolean;
|
92
|
-
date?: boolean;
|
93
|
-
day?: boolean;
|
94
|
-
json?: string;
|
95
|
-
mask?: boolean;
|
96
|
-
minDate?: any;
|
97
|
-
maxDate?: any;
|
98
|
-
}
|
99
|
-
|
100
|
-
/**
|
101
|
-
* The Formio interface class. This is a minimalistic API library that allows you to work with the Form.io API's within JavaScript.
|
102
|
-
*
|
103
|
-
* ## Usage
|
104
|
-
* Creating an instance of Formio is simple, and takes only a path (URL String). The path can be different, depending on the desired output.
|
105
|
-
* The Formio instance can also access higher level operations, depending on how granular of a path you start with.
|
106
|
-
*
|
107
|
-
* ```ts
|
108
|
-
* var formio = new Formio(<endpoint>, [options]);
|
109
|
-
* ```
|
110
|
-
*
|
111
|
-
* Where **endpoint** is any valid API endpoint within Form.io. These URL's can provide a number of different methods depending on the granularity of the endpoint. This allows you to use the same interface but have access to different methods depending on how granular the endpoint url is.
|
112
|
-
* **options** is defined within the {link Formio.constructor} documentation.
|
113
|
-
*
|
114
|
-
* Here is an example of how this library can be used to load a form JSON from the Form.io API's
|
115
|
-
*
|
116
|
-
* ```ts
|
117
|
-
* const formio = new Formio('https://examples.form.io/example');
|
118
|
-
* formio.loadForm().then((form) => {
|
119
|
-
* console.log(form);
|
120
|
-
* });
|
121
|
-
* ```
|
122
|
-
*/
|
123
|
-
export declare class Formio {
|
124
|
-
path?: string | undefined;
|
125
|
-
options: FormioOptions;
|
126
|
-
/**
|
127
|
-
* The base API url of the Form.io Platform. Example: https://api.form.io
|
128
|
-
*/
|
129
|
-
static baseUrl: string;
|
130
|
-
/**
|
131
|
-
* The project API url of the Form.io Project. Example: https://examples.form.io
|
132
|
-
*/
|
133
|
-
static projectUrl: string;
|
134
|
-
/**
|
135
|
-
* The project url to use for Authentication.
|
136
|
-
*/
|
137
|
-
static authUrl: string;
|
138
|
-
/**
|
139
|
-
* The path type for the project.
|
140
|
-
*/
|
141
|
-
static pathType?: FormioPathType;
|
142
|
-
/**
|
143
|
-
* Set to true if the project url has been established with ```Formio.setProjectUrl()```
|
144
|
-
*/
|
145
|
-
static projectUrlSet: boolean;
|
146
|
-
/**
|
147
|
-
* The Form.io API Cache. This ensures that requests to the same API endpoint are cached.
|
148
|
-
*/
|
149
|
-
static cache: any;
|
150
|
-
/**
|
151
|
-
* The namespace used to save the Form.io Token's and variables within an application.
|
152
|
-
*/
|
153
|
-
static namespace: string;
|
154
|
-
/**
|
155
|
-
* Handles events fired within this SDK library.
|
156
|
-
*/
|
157
|
-
static events: EventEmitter;
|
158
|
-
/**
|
159
|
-
* Stores all of the libraries lazy loaded with ```Formio.requireLibrary``` method.
|
160
|
-
*/
|
161
|
-
static libraries: any;
|
162
|
-
/**
|
163
|
-
* The Library license for this application.
|
164
|
-
*/
|
165
|
-
static license: string;
|
166
|
-
/**
|
167
|
-
* A direct interface to the Form.io fetch polyfill.
|
168
|
-
*/
|
169
|
-
static fetch: any;
|
170
|
-
/**
|
171
|
-
* A direct interface to the Form.io fetch Headers polyfill.
|
172
|
-
*/
|
173
|
-
static Headers: any;
|
174
|
-
/**
|
175
|
-
* The rules definitions.
|
176
|
-
*/
|
177
|
-
static rulesEntities: any;
|
178
|
-
/**
|
179
|
-
* All of the auth tokens for this session.
|
180
|
-
*/
|
181
|
-
static tokens: any;
|
182
|
-
static config: any;
|
183
|
-
static icons: string;
|
184
|
-
/**
|
185
|
-
* The version of this library.
|
186
|
-
*/
|
187
|
-
static version: string;
|
188
|
-
static formOnly: boolean;
|
189
|
-
/**
|
190
|
-
* The base API url of the Form.io Platform. Example: https://api.form.io
|
191
|
-
*/
|
192
|
-
base: string;
|
193
|
-
/**
|
194
|
-
* The Projects Endpoint derived from the provided source.
|
195
|
-
*
|
196
|
-
* @example https://api.form.io/project
|
197
|
-
*/
|
198
|
-
projectsUrl: string;
|
199
|
-
/**
|
200
|
-
* A specific project endpoint derived from the provided source.
|
201
|
-
*
|
202
|
-
* @example https://examples.form.io
|
203
|
-
*/
|
204
|
-
projectUrl: string;
|
205
|
-
/**
|
206
|
-
* The Project ID found within the provided source.
|
207
|
-
*/
|
208
|
-
projectId: string;
|
209
|
-
/**
|
210
|
-
* A specific Role URL provided the source.
|
211
|
-
*
|
212
|
-
* @example https://examples.form.io/role/2342343234234234
|
213
|
-
*/
|
214
|
-
roleUrl: string;
|
215
|
-
/**
|
216
|
-
* The roles endpoint derived from the provided source.
|
217
|
-
*
|
218
|
-
* @example https://examples.form.io/role
|
219
|
-
*/
|
220
|
-
rolesUrl: string;
|
221
|
-
/**
|
222
|
-
* The roleID derieved from the provided source.
|
223
|
-
*/
|
224
|
-
roleId: string;
|
225
|
-
/**
|
226
|
-
* A specific form url derived from the provided source.
|
227
|
-
*
|
228
|
-
* @example https://examples.form.io/example
|
229
|
-
*/
|
230
|
-
formUrl: string;
|
231
|
-
/**
|
232
|
-
* The forms url derived from the provided source.
|
233
|
-
*
|
234
|
-
* @example https://example.form.io/form
|
235
|
-
*/
|
236
|
-
formsUrl: string;
|
237
|
-
/**
|
238
|
-
* The Form ID derived from the provided source.
|
239
|
-
*/
|
240
|
-
formId: string;
|
241
|
-
/**
|
242
|
-
* The submissions URL derived from the provided source.
|
243
|
-
*
|
244
|
-
* @example https://examples.form.io/example/submission
|
245
|
-
*/
|
246
|
-
submissionsUrl: string;
|
247
|
-
/**
|
248
|
-
* A specific submissions URL derived from a provided source.
|
249
|
-
*
|
250
|
-
* @example https://examples.form.io/example/submission/223423423423
|
251
|
-
*/
|
252
|
-
submissionUrl: string;
|
253
|
-
/**
|
254
|
-
* The submission ID provided a submission url.
|
255
|
-
*/
|
256
|
-
submissionId: string;
|
257
|
-
/**
|
258
|
-
* The actions url provided a form url as the source.
|
259
|
-
*
|
260
|
-
* @example https://examples.form.io/example/action
|
261
|
-
*/
|
262
|
-
actionsUrl: string;
|
263
|
-
/**
|
264
|
-
* The Action ID derived from a provided Action url.
|
265
|
-
*/
|
266
|
-
actionId: string;
|
267
|
-
/**
|
268
|
-
* A specific action api endoint.
|
269
|
-
*/
|
270
|
-
actionUrl: string;
|
271
|
-
vsUrl: string;
|
272
|
-
vId: string;
|
273
|
-
vUrl: string;
|
274
|
-
/**
|
275
|
-
* The query string derived from the provided src url.
|
276
|
-
*/
|
277
|
-
query: string;
|
278
|
-
/**
|
279
|
-
* The project type.
|
280
|
-
*/
|
281
|
-
pathType?: FormioPathType;
|
282
|
-
/**
|
283
|
-
* If this is a non-project url, such is the case for Open Source API.
|
284
|
-
*/
|
285
|
-
noProject: boolean;
|
286
|
-
/**
|
287
|
-
* @constructor
|
288
|
-
* @param {string} path - A project, form, and submission API Url.
|
289
|
-
* @param {FormioOptions} options - Available options to configure the Javascript API.
|
290
|
-
*/
|
291
|
-
constructor(path?: string | undefined, options?: FormioOptions);
|
292
|
-
/**
|
293
|
-
* Deletes a remote resource of any provided type.
|
294
|
-
*
|
295
|
-
* @param {string} type - The type of resource to delete. "submission", "form", etc.
|
296
|
-
* @param {object} options - The options passed to {@link Formio.request}
|
297
|
-
* @return {Promise<Response>}
|
298
|
-
*/
|
299
|
-
delete(type: string, opts?: any): any;
|
300
|
-
/**
|
301
|
-
* Returns the index (array of records) for any provided type.
|
302
|
-
*
|
303
|
-
* @param {string} type - The type of resource to fetch the index of. "submission", "form", etc.
|
304
|
-
* @param {object} query - A query object to pass to the request.
|
305
|
-
* @param {object} query.params - A map (key-value pairs) of URL query parameters to add to the url.
|
306
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
307
|
-
* @return {Promise<Response>}
|
308
|
-
*/
|
309
|
-
index(type: string, query?: any, opts?: any): any;
|
310
|
-
/**
|
311
|
-
* Save a document record using "upsert". If the document does not exist, it will be created, if the _id is provided,
|
312
|
-
* it will be updated.
|
313
|
-
*
|
314
|
-
* @param {string} type - The type of resource to fetch the index of. "submission", "form", etc.
|
315
|
-
* @param {object} data - The resource data object.
|
316
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
317
|
-
* @return {Promise<object>}
|
318
|
-
*/
|
319
|
-
save(type: string, data?: any, opts?: any): any;
|
320
|
-
/**
|
321
|
-
* @summary Load (GET) a document record.
|
322
|
-
*
|
323
|
-
* @param {string} type - The type of resource to fetch the index of. "submission", "form", etc.
|
324
|
-
* @param {object} query - A query object to pass to the request.
|
325
|
-
* @param {object} query.params - A map (key-value pairs) of URL query parameters to add to the url.
|
326
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
327
|
-
* @return {Promise<object>}
|
328
|
-
*/
|
329
|
-
load(type: string, query?: any, opts?: any): any;
|
330
|
-
/**
|
331
|
-
* @summary Call {@link Formio.makeRequest} for this Formio instance.
|
332
|
-
*
|
333
|
-
* @param {string} type - The request resource type. "submission", "form", etc.
|
334
|
-
* @param {string} url - The URL to request.
|
335
|
-
* @param {string} method - The request method. GET, PUT, POST, DELETE, or PATCH
|
336
|
-
* @param {object} data - The data to pass to the request (for PUT, POST, and PATCH methods)
|
337
|
-
* @param {object} options - An object of options to pass to the request method.
|
338
|
-
* @param {boolean} options.ignoreCache - To ignore internal caching of the request.
|
339
|
-
* @param {object} options.headers - An object of headers to pass along to the request.
|
340
|
-
* @param {boolean} options.noToken - If set to true, this will not include the Form.io x-jwt-token along with the request.
|
341
|
-
* @param {string} options.namespace - The Form.io namespace to prepend to all LocalStorage variables such as formioToken.
|
342
|
-
* @param {boolean} options.getHeaders - Set this if you wish to include the response headers with the return of this method.
|
343
|
-
* @return {Promise<Response>}
|
344
|
-
*/
|
345
|
-
makeRequest(type: string, url: string, method?: string, data?: any, opts?: any): any;
|
346
|
-
/**
|
347
|
-
* @summary Loads a project.
|
348
|
-
*
|
349
|
-
* ```ts
|
350
|
-
* const formio = new Formio('https://examples.form.io');
|
351
|
-
* formio.loadProject().then((project) => {
|
352
|
-
* console.log(project);
|
353
|
-
* });
|
354
|
-
* ```
|
355
|
-
*
|
356
|
-
* @param {object} query - Query parameters to pass to {@link Formio#load}.
|
357
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
358
|
-
* @return {Promise<Object>}
|
359
|
-
*/
|
360
|
-
loadProject(query?: any, opts?: any): any;
|
361
|
-
/**
|
362
|
-
* Saves or Updates a project.
|
363
|
-
*
|
364
|
-
* ### Create a new project
|
365
|
-
* ```ts
|
366
|
-
* const formio = new Formio();
|
367
|
-
* formio.saveProject({
|
368
|
-
* title: 'My Project',
|
369
|
-
* path: 'myproject',
|
370
|
-
* name: 'myproject'
|
371
|
-
* });
|
372
|
-
* ```
|
373
|
-
*
|
374
|
-
* ### Update an existing project
|
375
|
-
* ```ts
|
376
|
-
* const formio = new Formio('https://examples.form.io');
|
377
|
-
* formio.loadProject().then((project) => {
|
378
|
-
* project.title = 'Title changed';
|
379
|
-
* formio.saveProject(project).then(() => {
|
380
|
-
* console.log('Done saving project!');
|
381
|
-
* });
|
382
|
-
* });
|
383
|
-
* ```
|
384
|
-
*
|
385
|
-
* @param {object} data - The project JSON to create or update.
|
386
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
387
|
-
* @return {Promise<Object>}
|
388
|
-
*/
|
389
|
-
saveProject(data?: any, opts?: any): any;
|
390
|
-
/**
|
391
|
-
* Deletes a project
|
392
|
-
*
|
393
|
-
* ```ts
|
394
|
-
* const formio = new Formio('https://examples.form.io');
|
395
|
-
* formio.deleteProject();
|
396
|
-
* ```
|
397
|
-
*
|
398
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
399
|
-
* @return {Promise<Object>}
|
400
|
-
*/
|
401
|
-
deleteProject(opts?: any): any;
|
402
|
-
/**
|
403
|
-
* Loads a list of all projects.
|
404
|
-
*
|
405
|
-
* ```ts
|
406
|
-
* Formio.loadProjects().then((projects) => {
|
407
|
-
* console.log(projects);
|
408
|
-
* });
|
409
|
-
* ```
|
410
|
-
*
|
411
|
-
* @param {object} query - Query parameters similar to {@link Formio#load}.
|
412
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
413
|
-
* @return {*}
|
414
|
-
*/
|
415
|
-
static loadProjects(query?: any, opts?: any): any;
|
416
|
-
/**
|
417
|
-
* Loads a role within a project.
|
418
|
-
*
|
419
|
-
* ```ts
|
420
|
-
* const formio = new Formio('https://examples.form.io/role/234234234234');
|
421
|
-
* formio.loadRole().then((role) => {
|
422
|
-
* console.log(role);
|
423
|
-
* });
|
424
|
-
* ```
|
425
|
-
*
|
426
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
427
|
-
* @return {Promise<Object>}
|
428
|
-
*/
|
429
|
-
loadRole(opts?: any): any;
|
430
|
-
/**
|
431
|
-
* Create a new or Update an existing role within a project.
|
432
|
-
*
|
433
|
-
* ### Create new Role example
|
434
|
-
* ```ts
|
435
|
-
* const formio = new Formio('https://examples.form.io');
|
436
|
-
* formio.saveRole({
|
437
|
-
* title: 'Employee',
|
438
|
-
* description: 'A person who belongs to a company.'
|
439
|
-
* }).then((role) => {
|
440
|
-
* console.log(role);
|
441
|
-
* });
|
442
|
-
* ```
|
443
|
-
*
|
444
|
-
* ### Update existing role example
|
445
|
-
* ```ts
|
446
|
-
* const formio = new Formio('https://examples.form.io/role/234234234234234');
|
447
|
-
* formio.loadRole().then((role) => {
|
448
|
-
* role.title = 'Manager';
|
449
|
-
* formio.saveRole(role).then(() => {
|
450
|
-
* console.log('DONE');
|
451
|
-
* });
|
452
|
-
* });
|
453
|
-
* ```
|
454
|
-
*
|
455
|
-
* @param {object} role - The Role JSON to create or update.
|
456
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
457
|
-
* @return {Promise<Object>}
|
458
|
-
*/
|
459
|
-
saveRole(data?: any, opts?: any): any;
|
460
|
-
/**
|
461
|
-
* Deletes a role within a project.
|
462
|
-
*
|
463
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
464
|
-
* @return {Promise<Response>}
|
465
|
-
*/
|
466
|
-
deleteRole(opts?: any): any;
|
467
|
-
/**
|
468
|
-
* Load all roles within a project.
|
469
|
-
*
|
470
|
-
* ```ts
|
471
|
-
* const formio = new Formio('https://examples.form.io');
|
472
|
-
* formio.loadRoles().then((roles) => {
|
473
|
-
* console.log(roles);
|
474
|
-
* });
|
475
|
-
* ```
|
476
|
-
*
|
477
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
478
|
-
* @return {Promise<Response>}
|
479
|
-
*/
|
480
|
-
loadRoles(opts?: any): any;
|
481
|
-
/**
|
482
|
-
* Loads a form.
|
483
|
-
*
|
484
|
-
* ```ts
|
485
|
-
* const formio = new Formio('https://examples.form.io/example');
|
486
|
-
* formio.loadForm().then((form) => {
|
487
|
-
* console.log(form);
|
488
|
-
* });
|
489
|
-
* ```
|
490
|
-
*
|
491
|
-
* @param {object} query - Query parameters similar to {@link Formio#load}.
|
492
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
493
|
-
* @return {Promise<object>}
|
494
|
-
*/
|
495
|
-
loadForm(query?: any, opts?: any): any;
|
496
|
-
/**
|
497
|
-
* Create or Update a specific form.
|
498
|
-
*
|
499
|
-
* ### Create form example
|
500
|
-
* ```ts
|
501
|
-
* const formio = new Formio('https://examples.form.io');
|
502
|
-
* formio.saveForm({
|
503
|
-
* title: 'Employee',
|
504
|
-
* type: 'resource',
|
505
|
-
* path: 'employee',
|
506
|
-
* name: 'employee',
|
507
|
-
* components: [
|
508
|
-
* {
|
509
|
-
* type: 'textfield',
|
510
|
-
* key: 'firstName',
|
511
|
-
* label: 'First Name'
|
512
|
-
* },
|
513
|
-
* {
|
514
|
-
* type: 'textfield',
|
515
|
-
* key: 'lastName',
|
516
|
-
* label: 'Last Name'
|
517
|
-
* }
|
518
|
-
* ]
|
519
|
-
* });
|
520
|
-
* ```
|
521
|
-
*
|
522
|
-
* ### Update a form example
|
523
|
-
* ```ts
|
524
|
-
* const formio = new Formio('https://examples.form.io/example');
|
525
|
-
* formio.loadForm().then((form) => {
|
526
|
-
* form.title = 'Changed Title';
|
527
|
-
* formio.saveForm(form).then(() => {
|
528
|
-
* console.log('DONE!!!');
|
529
|
-
* });
|
530
|
-
* });
|
531
|
-
* ```
|
532
|
-
*
|
533
|
-
* @param {object} data - The Form JSON to create or update.
|
534
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
535
|
-
* @return {Promise<Object>}
|
536
|
-
*/
|
537
|
-
saveForm(data?: any, opts?: any): any;
|
538
|
-
/**
|
539
|
-
* Deletes a form.
|
540
|
-
*
|
541
|
-
* ```ts
|
542
|
-
* const formio = new Formio('https://examples.form.io/example');
|
543
|
-
* formio.deleteForm().then(() => {
|
544
|
-
* console.log('Deleted!');
|
545
|
-
* });
|
546
|
-
* ```
|
547
|
-
*
|
548
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
549
|
-
* @return {Promise<Response>}
|
550
|
-
*/
|
551
|
-
deleteForm(opts?: any): any;
|
552
|
-
/**
|
553
|
-
* Loads all forms within a project.
|
554
|
-
*
|
555
|
-
* ```ts
|
556
|
-
* const formio = new Formio('https://examples.form.io');
|
557
|
-
* formio.loadForms().then((forms) => {
|
558
|
-
* console.log(forms);
|
559
|
-
* });
|
560
|
-
* ```
|
561
|
-
*
|
562
|
-
* @param {object} query - Query parameters similar to {@link Formio#load}.
|
563
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
564
|
-
* @return {Promise<Response>}
|
565
|
-
*/
|
566
|
-
loadForms(query?: any, opts?: any): any;
|
567
|
-
/**
|
568
|
-
* Loads a specific submissionn.
|
569
|
-
*
|
570
|
-
* ```ts
|
571
|
-
* const formio = new Formio('https://examples.form.io/example/submission/23423423423423423');
|
572
|
-
* formio.loadSubmission().then((submission) => {
|
573
|
-
* console.log(submission);
|
574
|
-
* });
|
575
|
-
* ```
|
576
|
-
*
|
577
|
-
* @param {object} query - Query parameters similar to {@link Formio#load}.
|
578
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
579
|
-
* @return {Promise<object>}
|
580
|
-
*/
|
581
|
-
loadSubmission(query?: any, opts?: any): any;
|
582
|
-
/**
|
583
|
-
* Creates a new or Updates an existing submission.
|
584
|
-
*
|
585
|
-
* ### Create a new submission
|
586
|
-
* ```ts
|
587
|
-
* const formio = new Formio('https://examples.form.io/example');
|
588
|
-
* formio.saveSubmission({
|
589
|
-
* data: {
|
590
|
-
* firstName: 'Joe',
|
591
|
-
* lastName: 'Smith'
|
592
|
-
* }
|
593
|
-
* }).then((submission) => {
|
594
|
-
* // This will now be the complete submission object saved on the server.
|
595
|
-
* console.log(submission);
|
596
|
-
* });
|
597
|
-
* ```
|
598
|
-
*
|
599
|
-
* ### Update an existing submission
|
600
|
-
* ```ts
|
601
|
-
* const formio = new Formio('https://examples.form.io/example/submission/23423423423423423');
|
602
|
-
* formio.loadSubmission().then((submission) => {
|
603
|
-
* submission.data.lastName = 'Thompson';
|
604
|
-
* formio.saveSubmission(submission).then(() => {
|
605
|
-
* console.log('DONE');
|
606
|
-
* });
|
607
|
-
* });
|
608
|
-
* ```
|
609
|
-
*
|
610
|
-
* @param {object} data - The submission JSON object.
|
611
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
612
|
-
* @return {Promise<Object>}
|
613
|
-
*/
|
614
|
-
saveSubmission(data?: any, opts?: any): any;
|
615
|
-
/**
|
616
|
-
* Deletes a submission.
|
617
|
-
*
|
618
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
619
|
-
* @return {Promise<Response>}
|
620
|
-
*/
|
621
|
-
deleteSubmission(opts?: any): any;
|
622
|
-
/**
|
623
|
-
* Loads all submissions within a form.
|
624
|
-
*
|
625
|
-
* ```ts
|
626
|
-
* const formio = new Formio('https://examples.form.io/example');
|
627
|
-
* formio.loadSubmissions({
|
628
|
-
* params: {
|
629
|
-
* limit: 25,
|
630
|
-
* 'data.lastName__regex': 'smith'
|
631
|
-
* }
|
632
|
-
* }).then((submissions) => {
|
633
|
-
* // Should print out 25 submissions where the last name contains "smith".
|
634
|
-
* console.log(submissions);
|
635
|
-
* });
|
636
|
-
* ```
|
637
|
-
*
|
638
|
-
* @param {object} query - Query parameters similar to {@link Formio#load}.
|
639
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
640
|
-
* @return {Promise<Response>}
|
641
|
-
*/
|
642
|
-
loadSubmissions(query?: any, opts?: any): any;
|
643
|
-
/**
|
644
|
-
* Loads a form action.
|
645
|
-
*
|
646
|
-
* ```ts
|
647
|
-
* const formio = new Formio('https://examples.form.io/example/action/234234234234');
|
648
|
-
* formio.loadAction().then((action) => {
|
649
|
-
* console.log(action);
|
650
|
-
* });
|
651
|
-
* ```
|
652
|
-
*
|
653
|
-
* @param {object} query - Query parameters similar to {@link Formio#load}.
|
654
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
655
|
-
* @return {Promise<Object>}
|
656
|
-
*/
|
657
|
-
loadAction(query?: any, opts?: any): any;
|
658
|
-
/**
|
659
|
-
* Create a new or update an existing action.
|
660
|
-
*
|
661
|
-
* ### Create a new action for a form.
|
662
|
-
* ```ts
|
663
|
-
* const formio = new Formio('https://examples.form.io/example');
|
664
|
-
* formio.saveAction({
|
665
|
-
* data: {
|
666
|
-
* name: 'webhook',
|
667
|
-
* title: 'Webhook Action',
|
668
|
-
* method: ['create', 'update', 'delete'],
|
669
|
-
* handler: ['after'],
|
670
|
-
* condition: {},
|
671
|
-
* settings: {
|
672
|
-
* url: 'https://example.com',
|
673
|
-
* headers: [{}],
|
674
|
-
* block: false,
|
675
|
-
* forwardHeaders: false
|
676
|
-
* }
|
677
|
-
* }
|
678
|
-
* }).then((action) => {
|
679
|
-
* console.log(action);
|
680
|
-
* });
|
681
|
-
* ```
|
682
|
-
*
|
683
|
-
* ### Update an action
|
684
|
-
* ```ts
|
685
|
-
* const formio = new Formio('https://examples.form.io/example/action/234234234234');
|
686
|
-
* formio.loadAction().then((action) => {
|
687
|
-
* action.title = 'Updated title';
|
688
|
-
* formio.saveAction(action).then(() => {
|
689
|
-
* console.log('Done!');
|
690
|
-
* });
|
691
|
-
* });
|
692
|
-
* ```
|
693
|
-
*
|
694
|
-
* @param {object} data - The action JSON
|
695
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
696
|
-
* @return {Promise<Object>}
|
697
|
-
*/
|
698
|
-
saveAction(data?: any, opts?: any): any;
|
699
|
-
/**
|
700
|
-
* Delete an action
|
701
|
-
*
|
702
|
-
* ```ts
|
703
|
-
* const formio = new Formio('https://examples.form.io/example/action/234234234234');
|
704
|
-
* formio.deleteAction().then(() => {
|
705
|
-
* console.log('Action was deleted.');
|
706
|
-
* });
|
707
|
-
* ```
|
708
|
-
*
|
709
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
710
|
-
* @return {Promise<Response>}
|
711
|
-
*/
|
712
|
-
deleteAction(opts?: any): any;
|
713
|
-
/**
|
714
|
-
* Loads all actions within a form.
|
715
|
-
*
|
716
|
-
* ```ts
|
717
|
-
* const formio = new Formio('https://examples.form.io/example');
|
718
|
-
* formio.loadActions().then((actions) => {
|
719
|
-
* console.log(actions);
|
720
|
-
* });
|
721
|
-
* ```
|
722
|
-
*
|
723
|
-
* @param {object} query - Query parameters similar to {@link Formio#load}.
|
724
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
725
|
-
* @return {Promise<Response>}
|
726
|
-
*/
|
727
|
-
loadActions(query?: any, opts?: any): any;
|
728
|
-
/**
|
729
|
-
* Returns a list of available actions
|
730
|
-
*
|
731
|
-
* @return {Promise<Response>}
|
732
|
-
*/
|
733
|
-
availableActions(): any;
|
734
|
-
/**
|
735
|
-
* Returns the action information for a specific action, such as "save".
|
736
|
-
*
|
737
|
-
* ```ts
|
738
|
-
* const formio = new Formio('https://examples.form.io/example/actions/save');
|
739
|
-
* formio.actionInfo().then((info) => {
|
740
|
-
* console.log(info);
|
741
|
-
* });
|
742
|
-
* ```
|
743
|
-
*
|
744
|
-
* @param {string} name - The name of the action you would like to get information for. i.e. "save", "webhook", etc.
|
745
|
-
* @return {Promise<Response>}
|
746
|
-
*/
|
747
|
-
actionInfo(name: string): any;
|
748
|
-
/**
|
749
|
-
* Determine if a string ID is a valid MongoID.
|
750
|
-
*
|
751
|
-
* @param {string} id - The id that should be tested if it is avalid id.
|
752
|
-
* @return {boolean} - true if it is a valid MongoId, false otherwise.
|
753
|
-
*/
|
754
|
-
isObjectId(id: string): boolean;
|
755
|
-
/**
|
756
|
-
* Get the project ID of project.
|
757
|
-
*
|
758
|
-
* ```ts
|
759
|
-
* const formio = new Formio('https://examples.form.io');
|
760
|
-
* formio.getProjectId().then((projectId) => {
|
761
|
-
* console.log(projectId);
|
762
|
-
* };
|
763
|
-
* ```
|
764
|
-
*
|
765
|
-
* @return {Promise<string>}
|
766
|
-
*/
|
767
|
-
getProjectId(): any;
|
768
|
-
/**
|
769
|
-
* Get the ID of a form.
|
770
|
-
*
|
771
|
-
* ```ts
|
772
|
-
* const formio = new Formio('https://examples.form.io/example');
|
773
|
-
* formio.getFormId().then((formId) => {
|
774
|
-
* console.log(formId);
|
775
|
-
* });
|
776
|
-
* ```
|
777
|
-
*
|
778
|
-
* @return {Promise<string>}
|
779
|
-
*/
|
780
|
-
getFormId(): any;
|
781
|
-
/**
|
782
|
-
* Instance method for {@link Formio.currentUser}
|
783
|
-
*
|
784
|
-
* @param {object} options - Options to pass to {@link Formio.request}
|
785
|
-
* @return {Promise<object>}
|
786
|
-
*/
|
787
|
-
currentUser(options?: any): any;
|
788
|
-
/**
|
789
|
-
* Instance method for {@link Formio.accessInfo}
|
790
|
-
*
|
791
|
-
* @return {Promise<Response>}
|
792
|
-
*/
|
793
|
-
accessInfo(): any;
|
794
|
-
/**
|
795
|
-
* Sets OAuth Logout URL.
|
796
|
-
*
|
797
|
-
* @param {string} uri - Logout URL.
|
798
|
-
* @param {string} options.namespace - The localStorage namespace to use when retrieving tokens from storage.
|
799
|
-
* @return {string}
|
800
|
-
*/
|
801
|
-
oauthLogoutURI(uri: string, options: string | {
|
802
|
-
namespace: string;
|
803
|
-
}): string;
|
804
|
-
/**
|
805
|
-
* Returns the JWT token for this instance.
|
806
|
-
*
|
807
|
-
* @param {object} options - The following options are provided.
|
808
|
-
* @param {string} options.namespace - The localStorage namespace to use when retrieving tokens from storage.
|
809
|
-
* @return {string} - The JWT token for this user.
|
810
|
-
*/
|
811
|
-
getToken(options?: any): any;
|
812
|
-
/**
|
813
|
-
* Sets the JWT token for this instance.
|
814
|
-
*
|
815
|
-
* @param {string} token - The JWT token to set.
|
816
|
-
* @param {object} options - The following options are provided.
|
817
|
-
* @param {string} options.namespace - The localStorage namespace to use when retrieving tokens from storage.
|
818
|
-
* @return {string} - The JWT token that was set.
|
819
|
-
*/
|
820
|
-
setToken(token: any, options?: any): any;
|
821
|
-
/**
|
822
|
-
* Returns a temporary authentication token for single purpose token generation.
|
823
|
-
*
|
824
|
-
* @param {number|string} expire - The amount of seconds to wait before this temp token expires.
|
825
|
-
* @param {string} allowed - The allowed path string inn the format GET:/path
|
826
|
-
* @param {object} options - The options passed to {@link Formio#getToken}
|
827
|
-
*/
|
828
|
-
getTempToken(expire: any, allowed: string, options?: any): any;
|
829
|
-
/**
|
830
|
-
* Get a PDF download url for a submission, which will generate a new PDF of the submission. This method will first
|
831
|
-
* fetch a temporary download token, and then append this to the download url for this form.
|
832
|
-
*
|
833
|
-
* ```ts
|
834
|
-
* const formio = new Formio('https://examples.form.io/example/submission/324234234234234');
|
835
|
-
* formio.getDownloadUrl().then((url) => {
|
836
|
-
* console.log(url);
|
837
|
-
* });
|
838
|
-
* ```
|
839
|
-
*
|
840
|
-
* @param {object} [form] - The form JSON to fetch a download url for.
|
841
|
-
* @return {Promise<string>} - The download url.
|
842
|
-
*/
|
843
|
-
getDownloadUrl(form: any): any;
|
844
|
-
/**
|
845
|
-
* Returns the user permissions to a form and submission.
|
846
|
-
*
|
847
|
-
* @param user - The user or current user if undefined. For anonymous, use "null"
|
848
|
-
* @param form - The form or current form if undefined. For no form check, use "null"
|
849
|
-
* @param submission - The submisison or "index" if undefined.
|
850
|
-
*
|
851
|
-
* @return {{create: boolean, read: boolean, edit: boolean, delete: boolean}}
|
852
|
-
*/
|
853
|
-
userPermissions(user?: any, form?: any, submission?: any): Promise<any>;
|
854
|
-
/**
|
855
|
-
* `Determine if the current user can submit a form.
|
856
|
-
* @return {*}
|
857
|
-
*/
|
858
|
-
canSubmit(): Promise<any>;
|
859
|
-
getUrlParts(url: string): RegExpMatchArray | null;
|
860
|
-
uploadFile(storage: any, file: any, fileName: any, dir: any, progressCallback: any, url: any): any;
|
861
|
-
downloadFile(file: any): any;
|
862
|
-
deleteFile(file: any): any;
|
863
|
-
static getUrlParts(url: string, formio: any): RegExpMatchArray | null;
|
864
|
-
static serialize(obj: any, _interpolate?: any): string;
|
865
|
-
static getRequestArgs(formio: any, type: string, url: string, method?: any, data?: any, opts?: any): any;
|
866
|
-
static makeStaticRequest(url: string, method?: any, data?: any, opts?: any): any;
|
867
|
-
/**
|
868
|
-
* Make an API request and wrap that request with the Form.io Request plugin system. This is very similar to the
|
869
|
-
* {Formio.request} method with a difference being that it will pass the request through the Form.io request plugin.
|
870
|
-
*
|
871
|
-
* @param {Formio} formio - An instance of the Formio class.
|
872
|
-
* @param {string} type - The request resource type. "submission", "form", etc.
|
873
|
-
* @param {string} url - The URL to request.
|
874
|
-
* @param {string} method - The request method. GET, PUT, POST, DELETE, or PATCH
|
875
|
-
* @param {object} data - The data to pass to the request (for PUT, POST, and PATCH methods)
|
876
|
-
* @param {object} options - An object of options to pass to the request method.
|
877
|
-
* @param {boolean} options.ignoreCache - To ignore internal caching of the request.
|
878
|
-
* @param {object} options.headers - An object of headers to pass along to the request.
|
879
|
-
* @param {boolean} options.noToken - If set to true, this will not include the Form.io x-jwt-token along with the request.
|
880
|
-
* @param {string} options.namespace - The Form.io namespace to prepend to all LocalStorage variables such as formioToken.
|
881
|
-
* @param {boolean} options.getHeaders - Set this if you wish to include the response headers with the return of this method.
|
882
|
-
* @return {Promise<Response>}
|
883
|
-
*/
|
884
|
-
static makeRequest(formio: any, type: string, url: string, method?: string, data?: any, opts?: any): any;
|
885
|
-
/**
|
886
|
-
* Execute an API request to any external system. This is a wrapper around the Web fetch method.
|
887
|
-
*
|
888
|
-
* ```ts
|
889
|
-
* Formio.request('https://examples.form.io').then((form) => {
|
890
|
-
* console.log(form);
|
891
|
-
* });
|
892
|
-
* ```
|
893
|
-
*
|
894
|
-
* @param {string} url - The URL to request.
|
895
|
-
* @param {string} method - The request method. GET, PUT, POST, DELETE, or PATCH
|
896
|
-
* @param {object} data - The data to pass to the request (for PUT, POST, and PATCH methods)
|
897
|
-
* @param {Headers} header - An object of headers to pass to the request.
|
898
|
-
* @param {object} options - An object of options to pass to the request method.
|
899
|
-
* @param {boolean} options.ignoreCache - To ignore internal caching of the request.
|
900
|
-
* @param {object} options.headers - An object of headers to pass along to the request.
|
901
|
-
* @param {boolean} options.noToken - If set to true, this will not include the Form.io x-jwt-token along with the request.
|
902
|
-
* @param {string} options.namespace - The Form.io namespace to prepend to all LocalStorage variables such as formioToken.
|
903
|
-
* @param {boolean} options.getHeaders - Set this if you wish to include the response headers with the return of this method.
|
904
|
-
* @return {Promise<Response>|*}
|
905
|
-
*/
|
906
|
-
static request(url: string, method?: any, data?: any, header?: any, opts?: any): any;
|
907
|
-
static get token(): any;
|
908
|
-
static set token(token: any);
|
909
|
-
static useSessionToken(options: string | {
|
910
|
-
namespace: string;
|
911
|
-
}): void;
|
912
|
-
/**
|
913
|
-
* Sets the JWT in storage to be used within an application.
|
914
|
-
*
|
915
|
-
* @param {string} token - The JWT token to set.
|
916
|
-
* @param {object} options - Options as follows
|
917
|
-
* @param {string} options.namespace - The namespace to save the token within. i.e. "formio"
|
918
|
-
* @param {Formio} options.formio - The Formio instance.
|
919
|
-
* @return {Promise<object>|void}
|
920
|
-
*/
|
921
|
-
static setToken(token?: any, opts?: any): any;
|
922
|
-
/**
|
923
|
-
* Returns the token set within the application for the user.
|
924
|
-
*
|
925
|
-
* @param {object} options - The options as follows.
|
926
|
-
* @param {string} options.namespace - The namespace of the token you wish to fetch.
|
927
|
-
* @param {boolean} options.decode - If you would like the token returned as decoded JSON.
|
928
|
-
* @return {*}
|
929
|
-
*/
|
930
|
-
static getToken(options?: any): any;
|
931
|
-
/**
|
932
|
-
* Sets the current user within the application cache.
|
933
|
-
*
|
934
|
-
* @param {object} user - JSON object of the user you wish to set.
|
935
|
-
* @param {object} options - Options as follows
|
936
|
-
* @param {string} options.namespace - The namespace of the tokens
|
937
|
-
*/
|
938
|
-
static setUser(user: any, opts?: any): void;
|
939
|
-
/**
|
940
|
-
* Returns the user JSON.
|
941
|
-
*
|
942
|
-
* @param {object} options - Options as follows
|
943
|
-
* @param {string} namespace - The namespace of the tokens stored within this application.
|
944
|
-
* @return {object} - The user object.
|
945
|
-
*/
|
946
|
-
static getUser(options?: any): any;
|
947
|
-
/**
|
948
|
-
* Sets the BaseURL for the application.
|
949
|
-
*
|
950
|
-
* @description Every application developed using the JavaScript SDK must set both the {@link Formio.setBaseUrl} and
|
951
|
-
* {@link Formio.setProjectUrl} methods. These two functions ensure that every URL passed into the constructor of this
|
952
|
-
* class can determine the "project" context for which the application is running.
|
953
|
-
*
|
954
|
-
* Any Open Source server applications will set both the {@link Formio.setBaseUrl} and {@link Formio.setProjectUrl}
|
955
|
-
* values will be the same value.
|
956
|
-
*
|
957
|
-
* ```ts
|
958
|
-
* Formio.setBaseUrl('https://yourwebsite.com/forms');
|
959
|
-
* Formio.setProjectUrl('https://yourwebsite.com/forms/project');
|
960
|
-
*
|
961
|
-
* // Now the Formio constructor will know what is the "project" and what is the form alias name. Without setBaseUrl
|
962
|
-
* // and setProjectUrl, this would throw an error.
|
963
|
-
*
|
964
|
-
* const formio = new Formio('https://yourwebsite.com/forms/project/user');
|
965
|
-
* formio.loadForm().then((form) => {
|
966
|
-
* console.log(form);
|
967
|
-
* });
|
968
|
-
* ```
|
969
|
-
*
|
970
|
-
* @param {string} url - The URL of the Base API url.
|
971
|
-
*/
|
972
|
-
static setBaseUrl(url: string): void;
|
973
|
-
/**
|
974
|
-
* Returns the current base url described at {@link Formio.setBaseUrl}
|
975
|
-
*
|
976
|
-
* @return {string} - The base url of the application.
|
977
|
-
*/
|
978
|
-
static getBaseUrl(): string;
|
979
|
-
static setApiUrl(url: string): void;
|
980
|
-
static getApiUrl(): string;
|
981
|
-
static setAppUrl(url: string): void;
|
982
|
-
/**
|
983
|
-
* Sets the Project Url for the application. This is an important method that needs to be set for all applications. It
|
984
|
-
* is documented @ {@link Formio.setBaseUrl}.
|
985
|
-
*
|
986
|
-
* @param {string} url - The project api url.
|
987
|
-
*/
|
988
|
-
static setProjectUrl(url: string): void;
|
989
|
-
/**
|
990
|
-
* The Auth URL can be set to customize the authentication requests made from an application. By default, this is
|
991
|
-
* just the same value as {@link Formio.projectUrl}
|
992
|
-
*
|
993
|
-
* @param {string} url - The authentication url
|
994
|
-
*/
|
995
|
-
static setAuthUrl(url: string): void;
|
996
|
-
static getAppUrl(): string;
|
997
|
-
/**
|
998
|
-
* Returns the Project url described at {@link Formio.setProjectUrl}
|
999
|
-
*
|
1000
|
-
* @return {string|string} - The Project Url.
|
1001
|
-
*/
|
1002
|
-
static getProjectUrl(): string;
|
1003
|
-
/**
|
1004
|
-
* Clears the runtime internal API cache.
|
1005
|
-
*
|
1006
|
-
* @description By default, the Formio class will cache all API requests in memory so that any subsequent requests
|
1007
|
-
* using GET method will return the cached results as long as the API URl is the same as what was cached previously.
|
1008
|
-
* This cache can be cleared using this method as follows.
|
1009
|
-
*
|
1010
|
-
* ```ts
|
1011
|
-
* Formio.clearCache();
|
1012
|
-
* ```
|
1013
|
-
*
|
1014
|
-
* Or, if you just wish to clear a single request, then the {@link Formio.request#options.ignoreCache} option can be
|
1015
|
-
* provided when making an API request as follows.
|
1016
|
-
*
|
1017
|
-
* ```ts
|
1018
|
-
* Formio.loadForm({}, {
|
1019
|
-
* ignoreCache: true
|
1020
|
-
* }).then((form) => {
|
1021
|
-
* console.log(form);
|
1022
|
-
* });
|
1023
|
-
* ```
|
1024
|
-
*
|
1025
|
-
* Both of the following will ensure that a new request is made to the API server and that the results will not be
|
1026
|
-
* from the cached result.
|
1027
|
-
*/
|
1028
|
-
static clearCache(): void;
|
1029
|
-
/**
|
1030
|
-
* Return the access information about a Project, such as the Role ID's for that project, and if the server is
|
1031
|
-
* configured to do so, the Form and Resource access configurations that the authenticated user has access to.
|
1032
|
-
*
|
1033
|
-
* @description This is useful for an application to determine the UI for a specific user to identify which forms they have
|
1034
|
-
* access to submit or read.
|
1035
|
-
*
|
1036
|
-
* @param {Formio} formio - The Formio instance.
|
1037
|
-
* @return {Promise<Response>}
|
1038
|
-
*/
|
1039
|
-
static accessInfo(formio?: any): any;
|
1040
|
-
/**
|
1041
|
-
* Returns an array of roles for the project, which includes the ID's and names of those roles.
|
1042
|
-
*
|
1043
|
-
* @param {Formio} formio - The Formio instance.
|
1044
|
-
* @return {Promise<Response>}
|
1045
|
-
*/
|
1046
|
-
static projectRoles(formio?: any): any;
|
1047
|
-
/**
|
1048
|
-
* Return the currentUser object. This will fetch the user from the server and respond with the Submission JSON
|
1049
|
-
* of that user object.
|
1050
|
-
*
|
1051
|
-
* @param {Formio} formio - The Formio instance
|
1052
|
-
* @param {object} options - The options passed to {@link Formio.getUser}
|
1053
|
-
* @return {Promise<R>|*}
|
1054
|
-
*/
|
1055
|
-
static currentUser(formio?: any, options?: any): any;
|
1056
|
-
/**
|
1057
|
-
* Performs a logout of the Form.io application. This will reset all cache, as well as make a request to the logout
|
1058
|
-
* endpoint of the Form.io api platform.
|
1059
|
-
*
|
1060
|
-
* @param {Formio} formio - A Formio instance.
|
1061
|
-
* @param {object} options - Options passed to both {@link Formio.setToken} as well as {@link Formio.setUser}
|
1062
|
-
* @return {Promise<Response>}
|
1063
|
-
*/
|
1064
|
-
static logout(formio?: any, options?: any): any;
|
1065
|
-
/**
|
1066
|
-
* Returns the query passed to a page in JSON object format.
|
1067
|
-
*
|
1068
|
-
* @description For example, lets say you visit your application using
|
1069
|
-
* the url as follows.
|
1070
|
-
*
|
1071
|
-
* ```
|
1072
|
-
* https://yourapplication.com/?token=23423423423&username=Joe
|
1073
|
-
* ```
|
1074
|
-
*
|
1075
|
-
* The following code will provide your application with the following.
|
1076
|
-
*
|
1077
|
-
* ```ts
|
1078
|
-
* const query Formio.pageQuery();
|
1079
|
-
* console.log(query.token); // Will print 23423423423
|
1080
|
-
* console.log(query.username); // Will print Joe
|
1081
|
-
* ```
|
1082
|
-
*
|
1083
|
-
* @return {{}} - A JSON object representation of the query that was passed to the URL of an application.
|
1084
|
-
*/
|
1085
|
-
static pageQuery(): any;
|
1086
|
-
/**
|
1087
|
-
* Much like {@link Formio.currentUser}, but instead automatically injects the Bearer tokens into the headers to
|
1088
|
-
* perform a Token swap of the OAuth token which will then return the JWT token for that user.
|
1089
|
-
*
|
1090
|
-
* @param {Formio} formio - The Formio instance
|
1091
|
-
* @param {string} token - An OAuth Bearer token to use for a token swap between the OAuth provider and Form.io
|
1092
|
-
* @return {Promise<R>|*}
|
1093
|
-
*/
|
1094
|
-
static oAuthCurrentUser(formio: any, token: string): any;
|
1095
|
-
static oauthLogoutURI(uri: string, options: string | {
|
1096
|
-
namespace: string;
|
1097
|
-
}): string;
|
1098
|
-
/**
|
1099
|
-
* Perform a SAML initialization.
|
1100
|
-
*
|
1101
|
-
* @description Typically, you would use the {@link Formio.ssoInit} method to perform this function
|
1102
|
-
* since this method is an alias for the following.
|
1103
|
-
*
|
1104
|
-
* ```ts
|
1105
|
-
* Formio.samlInit();
|
1106
|
-
* Formio.ssoInit('saml'); // This is the exact same thing as calling Formio.samlInit
|
1107
|
-
* ```
|
1108
|
-
*
|
1109
|
-
* This method will return false if the process is just starting. The code below is a typical block of code that is
|
1110
|
-
* used to automatically trigger the SAML authentication process within your application using a Button component.
|
1111
|
-
*
|
1112
|
-
* ```ts
|
1113
|
-
* if (Formio.pageQuery().saml) {
|
1114
|
-
* const sso = Formio.samlInit();
|
1115
|
-
* if (sso) {
|
1116
|
-
* sso.then((user) => {
|
1117
|
-
* // The SSO user is now loaded!
|
1118
|
-
* console.log(user);
|
1119
|
-
* });
|
1120
|
-
* }
|
1121
|
-
* }
|
1122
|
-
* ```
|
1123
|
-
*
|
1124
|
-
* You can then place the following code withiin the "Custom" action of a Button component on your form.
|
1125
|
-
*
|
1126
|
-
* ```ts
|
1127
|
-
* Formio.samlInit();
|
1128
|
-
* ```
|
1129
|
-
*
|
1130
|
-
* Now when you click on this button, it will start the handshake process with SAML, and once it returns, will pass
|
1131
|
-
* a "saml" query parameter back to your application which will execute the code to load the current user from SAML.
|
1132
|
-
*
|
1133
|
-
* @param {object} options - Options to pass to the SAML initialization process.
|
1134
|
-
* @param {string} options.relay - The URL that will be used as the authentication "relay" that occurs during a SAML handshake process.
|
1135
|
-
* @return {boolean|Promise<Object>|void}
|
1136
|
-
*/
|
1137
|
-
static samlInit(options?: any): any;
|
1138
|
-
/**
|
1139
|
-
* Perform an Okta Authentication process using the {@link https://developer.okta.com/code/javascript/okta_auth_sdk|Okta SDK}.
|
1140
|
-
*
|
1141
|
-
* @description This method does require that you first include the Okta JavaScript SDK within your application as follows.
|
1142
|
-
*
|
1143
|
-
* First you need to include the Okta Authentication script.
|
1144
|
-
*
|
1145
|
-
* ```html
|
1146
|
-
* <script src="https://ok1static.oktacdn.com/assets/js/sdk/okta-auth-js/2.0.1/okta-auth-js.min.js" type="text/javascript"></script>
|
1147
|
-
* ```
|
1148
|
-
*
|
1149
|
-
* Then you can call this method as follows.
|
1150
|
-
*
|
1151
|
-
* ```ts
|
1152
|
-
* Formio.oktaInit();
|
1153
|
-
* ```
|
1154
|
-
*
|
1155
|
-
* @param {object} options - Options that are passed directly to the {@link https://github.com/okta/okta-auth-js#configuration-reference|Okta SDK constructor}
|
1156
|
-
* @param {constructor} options.OktaAuth - If the OktaAuth constructor is not provided global to the application, it can be provided to this method using this property.
|
1157
|
-
* @param {Formio} options.formio - The Formio instance.
|
1158
|
-
* @param {Array<string>} options.scopes - Scopes that are passed to the {@link https://github.com/okta/okta-auth-js#tokengetwithredirectoptions|getWithRedirect} method from the Okta SDK.
|
1159
|
-
* @return {Promise<Object>}
|
1160
|
-
*/
|
1161
|
-
static oktaInit(options?: any): Promise<unknown>;
|
1162
|
-
/**
|
1163
|
-
* A common static method to trigger any SSO processes. This method is really just an alias for other static methods.
|
1164
|
-
*
|
1165
|
-
* @param {('saml'|'okta')} type - The type of SSO to trigger. 'saml' is an alias for {@link Formio.samlInit}, and 'okta' is an alias for {@link Formio.oktaInit}.
|
1166
|
-
* @param {object} options - Options to pass to the specific sso methods
|
1167
|
-
* @return {*|Promise<Object>|boolean|void}
|
1168
|
-
*/
|
1169
|
-
static ssoInit(type: string, options?: any): any;
|
1170
|
-
/**
|
1171
|
-
* Lazy load a remote library dependency.
|
1172
|
-
*
|
1173
|
-
* @description This is useful for components that wish to lazy load a required library
|
1174
|
-
* by adding that library to the <scripts> section of the HTML webpage, and then provide a promise that will resolve
|
1175
|
-
* when the library becomes available for use.
|
1176
|
-
*
|
1177
|
-
* @example Load Google Maps API.
|
1178
|
-
* ```ts
|
1179
|
-
* Formio.requireLibrary('googleMaps', 'google.maps.Map', 'https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap', true).then(() => {
|
1180
|
-
* // Once the promise resolves, the following can now be used within your application.
|
1181
|
-
* const map = new google.maps.Map(document.getElementById("map"), {...});
|
1182
|
-
* });
|
1183
|
-
* ```
|
1184
|
-
*
|
1185
|
-
* @param {string} name - The internal name to give to the library you are loading. This is useful for caching the library for later use.
|
1186
|
-
* @param {string} property - The name of the global property that will be added to the global namespace once the library has been loaded. This is used to check to see if the property exists before resolving the promise that the library is ready for use.
|
1187
|
-
* @param {string} src - The URL of the library to lazy load.
|
1188
|
-
* @param {boolean} polling - Determines if polling should be used to determine if they library is ready to use. If set to false, then it will rely on a global callback called ${name}Callback where "name" is the first property passed to this method. When this is called, that will indicate when the library is ready. In most cases, you will want to pass true to this parameter to initiate a polling method to check for the library availability in the global context.
|
1189
|
-
* @return {Promise<object>} - A promise that will resolve when the plugin is ready to be used.
|
1190
|
-
*/
|
1191
|
-
static requireLibrary(name: string, property: string, src: string | Array<string> | FormioLibrarySource | Array<FormioLibrarySource>, polling?: boolean, onload?: (ready: Promise<any>) => void): any;
|
1192
|
-
/**
|
1193
|
-
* Determines if a lazy loaded library is ready to be used.
|
1194
|
-
*
|
1195
|
-
* @description Example: Let's assume that the example provided at {@link Formio.requireLibrary} was used elsewhere in your application.
|
1196
|
-
* You could now use the following within a separate place that will also resolve once the library is ready to be used.
|
1197
|
-
*
|
1198
|
-
* ```js
|
1199
|
-
* Formio.libraryReady('googleMaps').then(() => {
|
1200
|
-
* // Once the promise resolves, the following can now be used within your application.
|
1201
|
-
* const map = new google.maps.Map(document.getElementById("map"), {...});
|
1202
|
-
* });
|
1203
|
-
* ```
|
1204
|
-
*
|
1205
|
-
* @param {string} name - The name of the library to check.
|
1206
|
-
* @return {Promise<object>} - A promise that will resolve when the library is ready to be used.
|
1207
|
-
*/
|
1208
|
-
static libraryReady(name: string): any;
|
1209
|
-
/**
|
1210
|
-
* Clones the response from the API so that it cannot be mutated.
|
1211
|
-
*
|
1212
|
-
* @param response
|
1213
|
-
*/
|
1214
|
-
static cloneResponse(response: any): any;
|
1215
|
-
/**
|
1216
|
-
* Sets the project path type.
|
1217
|
-
*
|
1218
|
-
* @param type
|
1219
|
-
*/
|
1220
|
-
static setPathType(type: FormioPathType): void;
|
1221
|
-
static createForm(element: HTMLElement, form: any, options: any): any;
|
1222
|
-
static builder(element: HTMLElement, form: any, options: any): any;
|
1223
|
-
static use(plugin: any): void;
|
1224
|
-
|
1225
|
-
/**
|
1226
|
-
* Gets the project path type.
|
1227
|
-
*/
|
1228
|
-
static getPathType(): FormioPathType | undefined;
|
1229
|
-
static plugins: import('./Plugins').Plugin[];
|
1230
|
-
static deregisterPlugin: typeof Plugins.deregisterPlugin;
|
1231
|
-
static registerPlugin: typeof Plugins.registerPlugin;
|
1232
|
-
static getPlugin: typeof Plugins.getPlugin;
|
1233
|
-
static pluginWait: typeof Plugins.pluginWait;
|
1234
|
-
static pluginGet: typeof Plugins.pluginGet;
|
1235
|
-
static pluginAlter: typeof Plugins.pluginAlter;
|
1236
|
-
}
|