@iebh/tera-fy 2.2.3 → 2.2.5
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.
- package/CHANGELOG.md +14 -0
- package/api.md +550 -530
- package/dist/lib/projectFile.d.ts +8 -0
- package/dist/lib/projectFile.js +26 -2
- package/dist/lib/projectFile.js.map +1 -1
- package/dist/lib/terafy.client.d.ts +2 -0
- package/dist/lib/terafy.client.js +2 -0
- package/dist/lib/terafy.client.js.map +1 -1
- package/dist/lib/terafy.server.d.ts +1 -0
- package/dist/lib/terafy.server.js +4 -0
- package/dist/lib/terafy.server.js.map +1 -1
- package/dist/terafy.es2019.js +2 -2
- package/dist/terafy.js +2 -2
- package/lib/projectFile.ts +37 -2
- package/lib/terafy.client.ts +2 -0
- package/lib/terafy.server.ts +4 -0
- package/package.json +1 -1
package/api.md
CHANGED
|
@@ -22,149 +22,151 @@
|
|
|
22
22
|
* [sizeFormatted][18]
|
|
23
23
|
* [mime][19]
|
|
24
24
|
* [meta][20]
|
|
25
|
-
* [
|
|
26
|
-
|
|
27
|
-
* [
|
|
25
|
+
* [isFolder][21]
|
|
26
|
+
* [files][22]
|
|
27
|
+
* [getContents][23]
|
|
28
28
|
* [Parameters][24]
|
|
29
|
-
* [
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
* [
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
* [
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
* [
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
* [
|
|
42
|
-
|
|
43
|
-
* [
|
|
44
|
-
* [
|
|
45
|
-
|
|
46
|
-
* [
|
|
29
|
+
* [setContents][25]
|
|
30
|
+
* [Parameters][26]
|
|
31
|
+
* [getRefs][27]
|
|
32
|
+
* [setRefs][28]
|
|
33
|
+
* [Parameters][29]
|
|
34
|
+
* [serialize][30]
|
|
35
|
+
* [deserialize][31]
|
|
36
|
+
* [Parameters][32]
|
|
37
|
+
* [TeraFy][33]
|
|
38
|
+
* [settings][34]
|
|
39
|
+
* [Properties][35]
|
|
40
|
+
* [events][36]
|
|
41
|
+
* [dom][37]
|
|
42
|
+
* [Properties][38]
|
|
43
|
+
* [methods][39]
|
|
44
|
+
* [plugins][40]
|
|
45
|
+
* [namespaces][41]
|
|
46
|
+
* [send][42]
|
|
47
47
|
* [Parameters][43]
|
|
48
|
-
* [
|
|
48
|
+
* [sendRaw][44]
|
|
49
49
|
* [Parameters][45]
|
|
50
|
-
* [
|
|
50
|
+
* [rpc][46]
|
|
51
51
|
* [Parameters][47]
|
|
52
|
-
* [
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
* [
|
|
56
|
-
|
|
57
|
-
* [
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
* [
|
|
63
|
-
|
|
64
|
-
* [
|
|
52
|
+
* [acceptMessage][48]
|
|
53
|
+
* [Parameters][49]
|
|
54
|
+
* [acceptPostboxes][50]
|
|
55
|
+
* [init][51]
|
|
56
|
+
* [Parameters][52]
|
|
57
|
+
* [detectMode][53]
|
|
58
|
+
* [injectComms][54]
|
|
59
|
+
* [handshakeLoop][55]
|
|
60
|
+
* [Parameters][56]
|
|
61
|
+
* [Properties][57]
|
|
62
|
+
* [injectStylesheet][58]
|
|
63
|
+
* [injectMethods][59]
|
|
64
|
+
* [debug][60]
|
|
65
65
|
* [Parameters][61]
|
|
66
|
-
* [
|
|
66
|
+
* [set][62]
|
|
67
67
|
* [Parameters][63]
|
|
68
|
-
* [
|
|
68
|
+
* [setIfDev][64]
|
|
69
69
|
* [Parameters][65]
|
|
70
|
-
* [
|
|
70
|
+
* [use][66]
|
|
71
71
|
* [Parameters][67]
|
|
72
|
-
* [
|
|
72
|
+
* [mixin][68]
|
|
73
73
|
* [Parameters][69]
|
|
74
|
-
* [
|
|
74
|
+
* [toggleDevMode][70]
|
|
75
75
|
* [Parameters][71]
|
|
76
|
-
* [
|
|
76
|
+
* [toggleFocus][72]
|
|
77
77
|
* [Parameters][73]
|
|
78
|
-
* [
|
|
78
|
+
* [getEntropicString][74]
|
|
79
79
|
* [Parameters][75]
|
|
80
|
-
* [
|
|
81
|
-
|
|
82
|
-
* [
|
|
80
|
+
* [selectProjectFile][76]
|
|
81
|
+
* [Parameters][77]
|
|
82
|
+
* [mountNamespace][78]
|
|
83
83
|
* [Parameters][79]
|
|
84
|
-
* [
|
|
84
|
+
* [Actual namespace mounting function designed to be overriden by plugins][80]
|
|
85
85
|
* [Parameters][81]
|
|
86
|
-
* [
|
|
86
|
+
* [unmountNamespace][82]
|
|
87
87
|
* [Parameters][83]
|
|
88
|
-
* [
|
|
89
|
-
* [
|
|
90
|
-
* [
|
|
91
|
-
* [
|
|
92
|
-
* [
|
|
93
|
-
* [
|
|
94
|
-
* [
|
|
95
|
-
* [
|
|
96
|
-
* [
|
|
97
|
-
|
|
98
|
-
* [
|
|
99
|
-
* [
|
|
100
|
-
* [
|
|
101
|
-
* [
|
|
102
|
-
|
|
103
|
-
* [
|
|
88
|
+
* [Actual namespace unmounting function designed to be overriden by plugins][84]
|
|
89
|
+
* [Parameters][85]
|
|
90
|
+
* [handshake][86]
|
|
91
|
+
* [Properties][87]
|
|
92
|
+
* [setServerVerbosity][88]
|
|
93
|
+
* [Parameters][89]
|
|
94
|
+
* [User][90]
|
|
95
|
+
* [Properties][91]
|
|
96
|
+
* [getUser][92]
|
|
97
|
+
* [getCredentials][93]
|
|
98
|
+
* [requireUser][94]
|
|
99
|
+
* [Parameters][95]
|
|
100
|
+
* [Project][96]
|
|
101
|
+
* [getProject][97]
|
|
102
|
+
* [getProjects][98]
|
|
103
|
+
* [setActiveProject][99]
|
|
104
104
|
* [Parameters][100]
|
|
105
|
-
* [
|
|
105
|
+
* [requireProject][101]
|
|
106
106
|
* [Parameters][102]
|
|
107
|
-
* [
|
|
107
|
+
* [selectProject][103]
|
|
108
108
|
* [Parameters][104]
|
|
109
|
-
* [
|
|
109
|
+
* [getNamespace][105]
|
|
110
110
|
* [Parameters][106]
|
|
111
|
-
* [
|
|
112
|
-
* [
|
|
113
|
-
* [
|
|
114
|
-
* [
|
|
115
|
-
* [
|
|
111
|
+
* [setNamespace][107]
|
|
112
|
+
* [Parameters][108]
|
|
113
|
+
* [listNamespaces][109]
|
|
114
|
+
* [Properties][110]
|
|
115
|
+
* [getProjectState][111]
|
|
116
116
|
* [Parameters][112]
|
|
117
|
-
* [
|
|
117
|
+
* [setProjectState][113]
|
|
118
118
|
* [Parameters][114]
|
|
119
|
-
* [
|
|
120
|
-
* [
|
|
121
|
-
|
|
122
|
-
* [
|
|
123
|
-
* [
|
|
124
|
-
* [
|
|
119
|
+
* [setProjectStateDefaults][115]
|
|
120
|
+
* [Parameters][116]
|
|
121
|
+
* [setProjectStateRefresh][117]
|
|
122
|
+
* [FileFilters][118]
|
|
123
|
+
* [Properties][119]
|
|
124
|
+
* [selectProjectFile][120]
|
|
125
125
|
* [Parameters][121]
|
|
126
|
-
* [
|
|
126
|
+
* [getProjectFiles][122]
|
|
127
127
|
* [Parameters][123]
|
|
128
|
-
* [
|
|
128
|
+
* [getProjectFileContents][124]
|
|
129
129
|
* [Parameters][125]
|
|
130
|
-
* [
|
|
130
|
+
* [getProjectFile][126]
|
|
131
131
|
* [Parameters][127]
|
|
132
|
-
* [
|
|
132
|
+
* [createProjectFile][128]
|
|
133
133
|
* [Parameters][129]
|
|
134
|
-
* [
|
|
134
|
+
* [moveProjectFile][130]
|
|
135
135
|
* [Parameters][131]
|
|
136
|
-
* [
|
|
136
|
+
* [deleteProjectFile][132]
|
|
137
137
|
* [Parameters][133]
|
|
138
|
-
* [
|
|
138
|
+
* [setProjectFileContents][134]
|
|
139
139
|
* [Parameters][135]
|
|
140
|
-
* [
|
|
140
|
+
* [createProjectFolder][136]
|
|
141
141
|
* [Parameters][137]
|
|
142
|
-
* [
|
|
142
|
+
* [deleteProjectFolder][138]
|
|
143
143
|
* [Parameters][139]
|
|
144
|
-
* [
|
|
144
|
+
* [selectProjectLibrary][140]
|
|
145
145
|
* [Parameters][141]
|
|
146
|
-
* [
|
|
146
|
+
* [getProjectLibrary][142]
|
|
147
147
|
* [Parameters][143]
|
|
148
|
-
* [
|
|
148
|
+
* [setProjectLibrary][144]
|
|
149
149
|
* [Parameters][145]
|
|
150
|
-
* [
|
|
150
|
+
* [projectLog][146]
|
|
151
151
|
* [Parameters][147]
|
|
152
|
-
* [
|
|
152
|
+
* [setPage][148]
|
|
153
153
|
* [Parameters][149]
|
|
154
|
-
* [
|
|
154
|
+
* [uiAlert][150]
|
|
155
155
|
* [Parameters][151]
|
|
156
|
-
* [
|
|
156
|
+
* [uiConfirm][152]
|
|
157
157
|
* [Parameters][153]
|
|
158
|
-
* [
|
|
158
|
+
* [uiPanic][154]
|
|
159
159
|
* [Parameters][155]
|
|
160
|
-
* [
|
|
160
|
+
* [uiProgress][156]
|
|
161
161
|
* [Parameters][157]
|
|
162
|
-
* [
|
|
162
|
+
* [uiPrompt][158]
|
|
163
163
|
* [Parameters][159]
|
|
164
|
-
* [
|
|
164
|
+
* [uiThrow][160]
|
|
165
165
|
* [Parameters][161]
|
|
166
|
-
* [
|
|
166
|
+
* [uiWindow][162]
|
|
167
167
|
* [Parameters][163]
|
|
168
|
+
* [uiSplat][164]
|
|
169
|
+
* [Parameters][165]
|
|
168
170
|
|
|
169
171
|
## ProjectFile
|
|
170
172
|
|
|
@@ -175,119 +177,131 @@ A project file fetched from TERA
|
|
|
175
177
|
The TERA compatible unique ID of the file
|
|
176
178
|
NOTE: This is computed each time from the Base64 of the file path
|
|
177
179
|
|
|
178
|
-
Type: [String][
|
|
180
|
+
Type: [String][166]
|
|
179
181
|
|
|
180
182
|
### sbId
|
|
181
183
|
|
|
182
184
|
The raw Supabase UUID of the file
|
|
183
185
|
|
|
184
|
-
Type: [String][
|
|
186
|
+
Type: [String][166]
|
|
185
187
|
|
|
186
188
|
### name
|
|
187
189
|
|
|
188
190
|
Relative name path (can contain prefix directories) for the human readable file name
|
|
189
191
|
|
|
190
|
-
Type: [String][
|
|
192
|
+
Type: [String][166]
|
|
191
193
|
|
|
192
194
|
### icon
|
|
193
195
|
|
|
194
196
|
CSS class to use as the file icon
|
|
195
197
|
|
|
196
|
-
Type: [String][
|
|
198
|
+
Type: [String][166]
|
|
197
199
|
|
|
198
200
|
### path
|
|
199
201
|
|
|
200
202
|
Full path to the file
|
|
201
203
|
This is also used as the unique identifier within the project
|
|
202
204
|
|
|
203
|
-
Type: [String][
|
|
205
|
+
Type: [String][166]
|
|
204
206
|
|
|
205
207
|
### url
|
|
206
208
|
|
|
207
209
|
Fully qualified URL to view / access / download the file from TERA
|
|
208
210
|
This will usually open an edit UI within the TERA site
|
|
209
211
|
|
|
210
|
-
Type: [String][
|
|
212
|
+
Type: [String][166]
|
|
211
213
|
|
|
212
214
|
### teraUrl
|
|
213
215
|
|
|
214
216
|
Rewrite of the URL where the absolute URL has been removed in place of a relative path, assuming the owner project is active
|
|
215
217
|
This is used to direct to the edit/view/download UI when the files project is active and is usually used in place of URL for TERA related operations
|
|
216
218
|
|
|
217
|
-
Type: [String][
|
|
219
|
+
Type: [String][166]
|
|
218
220
|
|
|
219
221
|
### parsedName
|
|
220
222
|
|
|
221
223
|
An object representing meta file parts of a file name
|
|
222
224
|
|
|
223
|
-
Type: [Object][
|
|
225
|
+
Type: [Object][167]
|
|
224
226
|
|
|
225
227
|
#### Properties
|
|
226
228
|
|
|
227
|
-
* `basename` **[String][
|
|
228
|
-
* `filename` **[String][
|
|
229
|
-
* `ext` **[String][
|
|
230
|
-
* `dirName` **[String][
|
|
229
|
+
* `basename` **[String][166]** The filename + extention (i.e. everything without directory name)
|
|
230
|
+
* `filename` **[String][166]** The file portion of the name (basename without the extension)
|
|
231
|
+
* `ext` **[String][166]** The extension portion of the name (always lower case)
|
|
232
|
+
* `dirName` **[String][166]** The directory path portion of the name
|
|
231
233
|
|
|
232
234
|
### created
|
|
233
235
|
|
|
234
236
|
A date representing when the file was created
|
|
235
237
|
|
|
236
|
-
Type: [Date][
|
|
238
|
+
Type: [Date][168]
|
|
237
239
|
|
|
238
240
|
### createdFormatted
|
|
239
241
|
|
|
240
242
|
A human readable, formatted version of "created"
|
|
241
243
|
|
|
242
|
-
Type: [String][
|
|
244
|
+
Type: [String][166]
|
|
243
245
|
|
|
244
246
|
### modified
|
|
245
247
|
|
|
246
248
|
A date representing when the file was created
|
|
247
249
|
|
|
248
|
-
Type: [Date][
|
|
250
|
+
Type: [Date][168]
|
|
249
251
|
|
|
250
252
|
### modifiedFormatted
|
|
251
253
|
|
|
252
254
|
A human readable, formatted version of "modified"
|
|
253
255
|
|
|
254
|
-
Type: [String][
|
|
256
|
+
Type: [String][166]
|
|
255
257
|
|
|
256
258
|
### accessed
|
|
257
259
|
|
|
258
260
|
A date representing when the file was last accessed
|
|
259
261
|
|
|
260
|
-
Type: [Date][
|
|
262
|
+
Type: [Date][168]
|
|
261
263
|
|
|
262
264
|
### accessedFormatted
|
|
263
265
|
|
|
264
266
|
A human readable, formatted version of "accessed"
|
|
265
267
|
|
|
266
|
-
Type: [String][
|
|
268
|
+
Type: [String][166]
|
|
267
269
|
|
|
268
270
|
### size
|
|
269
271
|
|
|
270
272
|
Size, in bytes, of the file
|
|
271
273
|
|
|
272
|
-
Type: [Number][
|
|
274
|
+
Type: [Number][169]
|
|
273
275
|
|
|
274
276
|
### sizeFormatted
|
|
275
277
|
|
|
276
278
|
A human readable, formatted version of the file size
|
|
277
279
|
|
|
278
|
-
Type: [String][
|
|
280
|
+
Type: [String][166]
|
|
279
281
|
|
|
280
282
|
### mime
|
|
281
283
|
|
|
282
284
|
The associated mime type for the file
|
|
283
285
|
|
|
284
|
-
Type: [String][
|
|
286
|
+
Type: [String][166]
|
|
285
287
|
|
|
286
288
|
### meta
|
|
287
289
|
|
|
288
290
|
Additional meta information for the file
|
|
289
291
|
|
|
290
|
-
Type: [Object][
|
|
292
|
+
Type: [Object][167]
|
|
293
|
+
|
|
294
|
+
### isFolder
|
|
295
|
+
|
|
296
|
+
Whether this is a folder or not
|
|
297
|
+
|
|
298
|
+
Type: [boolean][170]
|
|
299
|
+
|
|
300
|
+
### files
|
|
301
|
+
|
|
302
|
+
If it is a folder, it will have an array of files in the folder
|
|
303
|
+
|
|
304
|
+
Type: [Array][171]<[ProjectFile][1]>
|
|
291
305
|
|
|
292
306
|
### getContents
|
|
293
307
|
|
|
@@ -297,9 +311,9 @@ Fetch the raw file contents as a Blob
|
|
|
297
311
|
|
|
298
312
|
#### Parameters
|
|
299
313
|
|
|
300
|
-
* `options` **[Object][
|
|
314
|
+
* `options` **[Object][167]?** Additioanl options to mutate behaviour
|
|
301
315
|
|
|
302
|
-
Returns **[Promise][
|
|
316
|
+
Returns **[Promise][172]<[Blob][173]>** The eventual raw file contents as a Blob
|
|
303
317
|
|
|
304
318
|
### setContents
|
|
305
319
|
|
|
@@ -309,9 +323,9 @@ Overwrite the contents of a file with new content
|
|
|
309
323
|
|
|
310
324
|
#### Parameters
|
|
311
325
|
|
|
312
|
-
* `contents` **(File | [Blob][
|
|
326
|
+
* `contents` **(File | [Blob][173] | [FormData][174] | [Object][167] | [Array][171])** The new file contents
|
|
313
327
|
|
|
314
|
-
Returns **[Promise][
|
|
328
|
+
Returns **[Promise][172]\<void>** A promise which resolves when the operation has completed
|
|
315
329
|
|
|
316
330
|
### getRefs
|
|
317
331
|
|
|
@@ -319,7 +333,7 @@ Returns **[Promise][168]\<void>** A promise which resolves when the operation ha
|
|
|
319
333
|
|
|
320
334
|
Fetch the file contents as an array of Reflib refs
|
|
321
335
|
|
|
322
|
-
Returns **[Promise][
|
|
336
|
+
Returns **[Promise][172]<[Array][171]\<RefLibRef>>** An eventual array of RefLib references
|
|
323
337
|
|
|
324
338
|
### setRefs
|
|
325
339
|
|
|
@@ -331,16 +345,16 @@ Overwrite the contents of a file with a new collection of Reflib refs
|
|
|
331
345
|
|
|
332
346
|
* `refs` **[Array][171]\<RefLibRef>** Collection of references for the selected library
|
|
333
347
|
|
|
334
|
-
Returns **[Promise][
|
|
348
|
+
Returns **[Promise][172]\<void>** A promise which resolves when the operation has completed
|
|
335
349
|
|
|
336
350
|
### serialize
|
|
337
351
|
|
|
338
|
-
* **See**: [https://developer.mozilla.org/en-US/docs/Web/API/Web\_Workers\_API/Structured\_clone\_algorithm][
|
|
352
|
+
* **See**: [https://developer.mozilla.org/en-US/docs/Web/API/Web\_Workers\_API/Structured\_clone\_algorithm][175]
|
|
339
353
|
|
|
340
354
|
Compress a file state down into a serializable entity
|
|
341
355
|
By default this computes a Structured Clone which can be stringified
|
|
342
356
|
|
|
343
|
-
Returns **[Object][
|
|
357
|
+
Returns **[Object][167]** A Structured Clone compatible representation of this ProjectFile instance
|
|
344
358
|
|
|
345
359
|
### deserialize
|
|
346
360
|
|
|
@@ -350,7 +364,7 @@ as it's not included in the serialized output.
|
|
|
350
364
|
|
|
351
365
|
#### Parameters
|
|
352
366
|
|
|
353
|
-
* `data` **[Object][
|
|
367
|
+
* `data` **[Object][167]** An input object created via `ProjectFiles.serialize()` (MUST include a 'tera' property added manually)
|
|
354
368
|
|
|
355
369
|
Returns **[ProjectFile][1]** A ProjectFile instance setup against the deserializzed data
|
|
356
370
|
|
|
@@ -362,23 +376,23 @@ Main Tera-Fy Client (class singleton) to be used in a frontend browser
|
|
|
362
376
|
|
|
363
377
|
Various settings to configure behaviour
|
|
364
378
|
|
|
365
|
-
Type: [Object][
|
|
379
|
+
Type: [Object][167]
|
|
366
380
|
|
|
367
381
|
#### Properties
|
|
368
382
|
|
|
369
|
-
* `session` **[String][
|
|
370
|
-
* `devMode` **[Boolean][
|
|
371
|
-
* `verbosity` **[Number][
|
|
383
|
+
* `session` **[String][166]** Unique session signature for this instance of TeraFy, used to sign server messages, if falsy `getEntropicString(16)` is used to populate
|
|
384
|
+
* `devMode` **[Boolean][170]** Operate in Dev-Mode - i.e. force outer refresh when encountering an existing TeraFy instance + be more tolerent of weird iframe origins
|
|
385
|
+
* `verbosity` **[Number][169]** Verbosity level, the higher the more chatty TeraFY will be. Set to zero to disable all `debug()` call output
|
|
372
386
|
* `mode` **(`"detect"` | `"parent"` | `"child"` | `"popup"`)** How to communicate with TERA. 'parent' assumes that the parent of the current document is TERA, 'child' spawns an iFrame and uses TERA there, 'detect' tries parent and switches to `modeFallback` if communication fails
|
|
373
|
-
* `modeFallback` **[String][
|
|
374
|
-
* `modeOverrides` **[Object][
|
|
375
|
-
* `modeTimeout` **[Number][
|
|
376
|
-
* `siteUrl` **[String][
|
|
377
|
-
* `restrictOrigin` **[String][
|
|
378
|
-
* `List` **[Array][171]<[String][
|
|
379
|
-
* `handshakeInterval` **[Number][
|
|
380
|
-
* `handshakeTimeout` **[Number][
|
|
381
|
-
* `debugPaths` **[Array][171]<([String][
|
|
387
|
+
* `modeFallback` **[String][166]** Method to use when all method detection fails
|
|
388
|
+
* `modeOverrides` **[Object][167]<[Object][167]<[Function][176]>>** Functions to run when switching to specific modes, these are typically used to augment config. Called as `(config:Object)`
|
|
389
|
+
* `modeTimeout` **[Number][169]** How long entities have in 'detect' mode to identify themselves
|
|
390
|
+
* `siteUrl` **[String][166]** The TERA URL to connect to
|
|
391
|
+
* `restrictOrigin` **[String][166]** URL to restrict communications to
|
|
392
|
+
* `List` **[Array][171]<[String][166]>** of sandbox allowables for the embedded if in embed mode
|
|
393
|
+
* `handshakeInterval` **[Number][169]** Interval in milliseconds when sanning for a handshake
|
|
394
|
+
* `handshakeTimeout` **[Number][169]** Interval in milliseconds for when to give up trying to handshake
|
|
395
|
+
* `debugPaths` **[Array][171]<([String][166] | [Array][171]<[String][166]>)>?** List of paths (in either dotted or array notation) to enter debugging mode if a change is detected in dev mode e.g. `{debugPaths: ['foo.bar.baz']}`. This really slows down state writes so should only be used for debugging
|
|
382
396
|
|
|
383
397
|
### events
|
|
384
398
|
|
|
@@ -390,13 +404,13 @@ Type: Mitt
|
|
|
390
404
|
|
|
391
405
|
DOMElements for this TeraFy instance
|
|
392
406
|
|
|
393
|
-
Type: [Object][
|
|
407
|
+
Type: [Object][167]
|
|
394
408
|
|
|
395
409
|
#### Properties
|
|
396
410
|
|
|
397
411
|
* `el` **DOMElement** The main tera-fy div wrapper
|
|
398
412
|
* `iframe` **DOMElement** The internal iFrame element (if `settings.mode == 'child'`)
|
|
399
|
-
* `popup` **[Window][
|
|
413
|
+
* `popup` **[Window][177]** The popup window context (if `settings.mode == 'popup'`)
|
|
400
414
|
* `stylesheet` **DOMElement** The corresponding stylesheet
|
|
401
415
|
|
|
402
416
|
### methods
|
|
@@ -404,7 +418,7 @@ Type: [Object][165]
|
|
|
404
418
|
List of function stubs mapped from the server to here
|
|
405
419
|
This array is forms the reference of `TeraFy.METHOD()` objects to provide locally which will be mapped via `TeraFy.rpc(METHOD, ...args)`
|
|
406
420
|
|
|
407
|
-
Type: [Array][171]<[String][
|
|
421
|
+
Type: [Array][171]<[String][166]>
|
|
408
422
|
|
|
409
423
|
### plugins
|
|
410
424
|
|
|
@@ -418,7 +432,7 @@ Active namespaces we are subscribed to
|
|
|
418
432
|
Each key is the namespace name with the value as the local reactive \ observer \ object equivelent
|
|
419
433
|
The key string is always of the form `${ENTITY}::${ID}` e.g. `projects:1234`
|
|
420
434
|
|
|
421
|
-
Type: [Object][
|
|
435
|
+
Type: [Object][167]<[Object][167]>
|
|
422
436
|
|
|
423
437
|
### send
|
|
424
438
|
|
|
@@ -426,9 +440,9 @@ Send a message + wait for a response object
|
|
|
426
440
|
|
|
427
441
|
#### Parameters
|
|
428
442
|
|
|
429
|
-
* `message` **[Object][
|
|
443
|
+
* `message` **[Object][167]** Message object to send
|
|
430
444
|
|
|
431
|
-
Returns **[Promise][
|
|
445
|
+
Returns **[Promise][172]\<any>** A promise which resolves when the operation has completed with the remote reply
|
|
432
446
|
|
|
433
447
|
### sendRaw
|
|
434
448
|
|
|
@@ -437,7 +451,7 @@ This function does not return or wait for a reply - use `send()` for that
|
|
|
437
451
|
|
|
438
452
|
#### Parameters
|
|
439
453
|
|
|
440
|
-
* `message` **[Object][
|
|
454
|
+
* `message` **[Object][167]** Message object to send
|
|
441
455
|
|
|
442
456
|
### rpc
|
|
443
457
|
|
|
@@ -445,10 +459,10 @@ Call an RPC function in the server instance
|
|
|
445
459
|
|
|
446
460
|
#### Parameters
|
|
447
461
|
|
|
448
|
-
* `method` **[String][
|
|
462
|
+
* `method` **[String][166]** The method name to call
|
|
449
463
|
* `args` **...any?** Optional arguments to pass to the function
|
|
450
464
|
|
|
451
|
-
Returns **[Promise][
|
|
465
|
+
Returns **[Promise][172]\<any>** The resolved output of the server function
|
|
452
466
|
|
|
453
467
|
### acceptMessage
|
|
454
468
|
|
|
@@ -456,9 +470,9 @@ Accept an incoming message
|
|
|
456
470
|
|
|
457
471
|
#### Parameters
|
|
458
472
|
|
|
459
|
-
* `rawMessage` **[MessageEvent][
|
|
473
|
+
* `rawMessage` **[MessageEvent][178]** Raw message event to process
|
|
460
474
|
|
|
461
|
-
Returns **[Promise][
|
|
475
|
+
Returns **[Promise][172]** A promise which will resolve when the message has been processed
|
|
462
476
|
|
|
463
477
|
### acceptPostboxes
|
|
464
478
|
|
|
@@ -471,22 +485,22 @@ This function can only be called once and will return the existing init() worker
|
|
|
471
485
|
|
|
472
486
|
#### Parameters
|
|
473
487
|
|
|
474
|
-
* `options` **[Object][
|
|
488
|
+
* `options` **[Object][167]?** Additional options to merge into `settings` via `set`
|
|
475
489
|
|
|
476
|
-
Returns **[Promise][
|
|
490
|
+
Returns **[Promise][172]<[TeraFy][33]>** An eventual promise which will resovle with this terafy instance
|
|
477
491
|
|
|
478
492
|
### detectMode
|
|
479
493
|
|
|
480
494
|
Populate `settings.mode`
|
|
481
495
|
Try to communicate with a parent frame, if none assume we need to fallback to child mode
|
|
482
496
|
|
|
483
|
-
Returns **[Promise][
|
|
497
|
+
Returns **[Promise][172]<[String][166]>** A promise which will resolve with the detected mode to use
|
|
484
498
|
|
|
485
499
|
### injectComms
|
|
486
500
|
|
|
487
501
|
Find an existing active TERA server OR initalize one
|
|
488
502
|
|
|
489
|
-
Returns **[Promise][
|
|
503
|
+
Returns **[Promise][172]** A promise which will resolve when the loading has completed and we have found a parent TERA instance or initiallized a child
|
|
490
504
|
|
|
491
505
|
### handshakeLoop
|
|
492
506
|
|
|
@@ -494,20 +508,20 @@ Keep trying to handshake until the target responds
|
|
|
494
508
|
|
|
495
509
|
#### Parameters
|
|
496
510
|
|
|
497
|
-
* `options` **[Object][
|
|
511
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
498
512
|
|
|
499
513
|
#### Properties
|
|
500
514
|
|
|
501
|
-
* `handshakeInterval` **[Number][
|
|
502
|
-
* `handshakeTimeout` **[Number][
|
|
515
|
+
* `handshakeInterval` **[Number][169]?** Interval in milliseconds when sanning for a handshake, defaults to global setting
|
|
516
|
+
* `handshakeTimeout` **[Number][169]?** Interval in milliseconds for when to give up trying to handshake, defaults to global setting
|
|
503
517
|
|
|
504
|
-
Returns **[Promise][
|
|
518
|
+
Returns **[Promise][172]** A promise which will either resolve when the handshake is successful OR fail with 'TIMEOUT'
|
|
505
519
|
|
|
506
520
|
### injectStylesheet
|
|
507
521
|
|
|
508
522
|
Inject a local stylesheet to handle TERA server functionality
|
|
509
523
|
|
|
510
|
-
Returns **[Promise][
|
|
524
|
+
Returns **[Promise][172]** A promise which will resolve when the loading has completed and we have found a parent TERA instance or initiallized a child
|
|
511
525
|
|
|
512
526
|
### injectMethods
|
|
513
527
|
|
|
@@ -522,7 +536,7 @@ This function will only act if `settings.devMode` is truthy
|
|
|
522
536
|
|
|
523
537
|
* `msg` **...any?** Output to show
|
|
524
538
|
* `method` **(`"INFO"` | `"LOG"` | `"WARN"` | `"ERROR"`)** Logging method to use (optional, default `'LOG'`)
|
|
525
|
-
* `verboseLevel` **[Number][
|
|
539
|
+
* `verboseLevel` **[Number][169]** The verbosity level to trigger at. If `settings.verbosity` is lower than this, the message is ignored (optional, default `1`)
|
|
526
540
|
|
|
527
541
|
### set
|
|
528
542
|
|
|
@@ -531,13 +545,13 @@ This function also routes 'special' keys like `devMode` to their internal handle
|
|
|
531
545
|
|
|
532
546
|
#### Parameters
|
|
533
547
|
|
|
534
|
-
* `key` **([String][
|
|
548
|
+
* `key` **([String][166] | [Object][167])** Either a single setting key to set or an object to merge
|
|
535
549
|
* `value` **any** The value to set if `key` is a string
|
|
536
|
-
* `options` **[Object][
|
|
550
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
537
551
|
|
|
538
|
-
* `options.ignoreNullish` **[Boolean][
|
|
552
|
+
* `options.ignoreNullish` **[Boolean][170]** If falsy, this forces the setting of undefined or null values rather than ignoring them when specifying values by string (optional, default `true`)
|
|
539
553
|
|
|
540
|
-
Returns **[TeraFy][
|
|
554
|
+
Returns **[TeraFy][33]** This chainable terafy instance
|
|
541
555
|
|
|
542
556
|
### setIfDev
|
|
543
557
|
|
|
@@ -547,11 +561,11 @@ Set or merge settings - but only in dev mode and only if the value is not undefi
|
|
|
547
561
|
|
|
548
562
|
#### Parameters
|
|
549
563
|
|
|
550
|
-
* `key` **([String][
|
|
564
|
+
* `key` **([String][166] | [Object][167])** Either a single setting key to set or an object to merge
|
|
551
565
|
* `value` **any** The value to set if `key` is a string
|
|
552
|
-
* `options` **[Object][
|
|
566
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
553
567
|
|
|
554
|
-
Returns **[TeraFy][
|
|
568
|
+
Returns **[TeraFy][33]** This chainable terafy instance
|
|
555
569
|
|
|
556
570
|
### use
|
|
557
571
|
|
|
@@ -559,10 +573,10 @@ Include a TeraFy client plugin
|
|
|
559
573
|
|
|
560
574
|
#### Parameters
|
|
561
575
|
|
|
562
|
-
* `source` **([Function][
|
|
563
|
-
* `options` **[Object][
|
|
576
|
+
* `source` **([Function][176] | [Object][167] | [String][166])** Either the JS module class, singleton object or URL to fetch it from. Eventually constructed as invoked as `(teraClient:TeraFy, options:Object)`
|
|
577
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour during construction (pass options to init() to intialize later options)
|
|
564
578
|
|
|
565
|
-
Returns **[TeraFy][
|
|
579
|
+
Returns **[TeraFy][33]** This chainable terafy instance
|
|
566
580
|
|
|
567
581
|
### mixin
|
|
568
582
|
|
|
@@ -570,8 +584,8 @@ Internal function used by use() to merge an external declared singleton against
|
|
|
570
584
|
|
|
571
585
|
#### Parameters
|
|
572
586
|
|
|
573
|
-
* `target` **[Object][
|
|
574
|
-
* `source` **[Object][
|
|
587
|
+
* `target` **[Object][167]** Initalied class instance to extend
|
|
588
|
+
* `source` **[Object][167]** Initalized source object to extend from
|
|
575
589
|
|
|
576
590
|
### toggleDevMode
|
|
577
591
|
|
|
@@ -583,9 +597,9 @@ This function also accepts meta values:
|
|
|
583
597
|
|
|
584
598
|
#### Parameters
|
|
585
599
|
|
|
586
|
-
* `devModeEnabled` **(`"toggle"` | `"proxy"` | [Boolean][
|
|
600
|
+
* `devModeEnabled` **(`"toggle"` | `"proxy"` | [Boolean][170])** Optional boolean to force dev mode or specify other behaviour (optional, default `'toggle'`)
|
|
587
601
|
|
|
588
|
-
Returns **[TeraFy][
|
|
602
|
+
Returns **[TeraFy][33]** This chainable terafy instance
|
|
589
603
|
|
|
590
604
|
### toggleFocus
|
|
591
605
|
|
|
@@ -594,7 +608,7 @@ This is usually because the server component wants to perform some user activity
|
|
|
594
608
|
|
|
595
609
|
#### Parameters
|
|
596
610
|
|
|
597
|
-
* `isFocused` **([String][
|
|
611
|
+
* `isFocused` **([String][166] | [Boolean][170])** Whether to fullscreen the embedded component (optional, default `'toggle'`)
|
|
598
612
|
|
|
599
613
|
### getEntropicString
|
|
600
614
|
|
|
@@ -602,9 +616,9 @@ Generate random entropic character string in Base64
|
|
|
602
616
|
|
|
603
617
|
#### Parameters
|
|
604
618
|
|
|
605
|
-
* `maxLength` **[Number][
|
|
619
|
+
* `maxLength` **[Number][169]** Maximum lengh of the genrated string (optional, default `32`)
|
|
606
620
|
|
|
607
|
-
Returns **[String][
|
|
621
|
+
Returns **[String][166]** 
|
|
608
622
|
|
|
609
623
|
### selectProjectFile
|
|
610
624
|
|
|
@@ -616,7 +630,7 @@ This is an pre-requisite step for requireProject()
|
|
|
616
630
|
|
|
617
631
|
* `options` **any?** 
|
|
618
632
|
|
|
619
|
-
Returns **[Promise][
|
|
633
|
+
Returns **[Promise][172]** A promise which will resolve if the there is a user and they are logged in
|
|
620
634
|
|
|
621
635
|
## mountNamespace
|
|
622
636
|
|
|
@@ -625,17 +639,17 @@ This generally creates whatever framework flavoured reactive/observer/object is
|
|
|
625
639
|
|
|
626
640
|
### Parameters
|
|
627
641
|
|
|
628
|
-
* `name` **[String][
|
|
642
|
+
* `name` **[String][166]** The alias of the namespace, this should be alphanumeric + hyphens + underscores
|
|
629
643
|
|
|
630
|
-
Returns **[Promise][
|
|
644
|
+
Returns **[Promise][172]\<Reactive>** A promise which resolves to the reactive object
|
|
631
645
|
|
|
632
646
|
## Actual namespace mounting function designed to be overriden by plugins
|
|
633
647
|
|
|
634
648
|
### Parameters
|
|
635
649
|
|
|
636
|
-
* `name` **[String][
|
|
650
|
+
* `name` **[String][166]** The alias of the namespace, this should be alphanumeric + hyphens + underscores
|
|
637
651
|
|
|
638
|
-
Returns **[Promise][
|
|
652
|
+
Returns **[Promise][172]** A promise which resolves when the mount operation has completed
|
|
639
653
|
|
|
640
654
|
## unmountNamespace
|
|
641
655
|
|
|
@@ -644,17 +658,17 @@ This function will remove the namespace from `namespaces`, cleaning up any memor
|
|
|
644
658
|
|
|
645
659
|
### Parameters
|
|
646
660
|
|
|
647
|
-
* `name` **[String][
|
|
661
|
+
* `name` **[String][166]** The name of the namespace to unmount
|
|
648
662
|
|
|
649
|
-
Returns **[Promise][
|
|
663
|
+
Returns **[Promise][172]** A promise which resolves when the operation has completed
|
|
650
664
|
|
|
651
665
|
## Actual namespace unmounting function designed to be overriden by plugins
|
|
652
666
|
|
|
653
667
|
### Parameters
|
|
654
668
|
|
|
655
|
-
* `name` **[String][
|
|
669
|
+
* `name` **[String][166]** The name of the namespace to unmount
|
|
656
670
|
|
|
657
|
-
Returns **[Promise][
|
|
671
|
+
Returns **[Promise][172]** A promise which resolves when the operation has completed
|
|
658
672
|
|
|
659
673
|
## handshake
|
|
660
674
|
|
|
@@ -662,9 +676,9 @@ Return basic server information as a form of validation
|
|
|
662
676
|
|
|
663
677
|
### Properties
|
|
664
678
|
|
|
665
|
-
* `date` **[Date][
|
|
679
|
+
* `date` **[Date][168]** Server date
|
|
666
680
|
|
|
667
|
-
Returns **[Promise][
|
|
681
|
+
Returns **[Promise][172]<[Object][167]>** Basic promise result
|
|
668
682
|
|
|
669
683
|
## setServerVerbosity
|
|
670
684
|
|
|
@@ -672,7 +686,7 @@ RPC callback to set the server verbostiy level
|
|
|
672
686
|
|
|
673
687
|
### Parameters
|
|
674
688
|
|
|
675
|
-
* `verbosity` **[Number][
|
|
689
|
+
* `verbosity` **[Number][169]** The desired server verbosity level
|
|
676
690
|
|
|
677
691
|
## User
|
|
678
692
|
|
|
@@ -680,22 +694,22 @@ User / active session within TERA
|
|
|
680
694
|
|
|
681
695
|
### Properties
|
|
682
696
|
|
|
683
|
-
* `id` **[String][
|
|
684
|
-
* `email` **[String][
|
|
685
|
-
* `name` **[String][
|
|
686
|
-
* `isSubscribed` **[Boolean][
|
|
697
|
+
* `id` **[String][166]** Unique identifier of the user
|
|
698
|
+
* `email` **[String][166]** The email address of the current user
|
|
699
|
+
* `name` **[String][166]** The provided full name of the user
|
|
700
|
+
* `isSubscribed` **[Boolean][170]** Whether the active user has a TERA subscription
|
|
687
701
|
|
|
688
702
|
## getUser
|
|
689
703
|
|
|
690
704
|
Fetch the current session user
|
|
691
705
|
|
|
692
|
-
Returns **[Promise][
|
|
706
|
+
Returns **[Promise][172]<[User][90]>** The current logged in user or null if none
|
|
693
707
|
|
|
694
708
|
## getCredentials
|
|
695
709
|
|
|
696
710
|
Provide an object of credentials for 3rd party services like Firebase/Supabase
|
|
697
711
|
|
|
698
|
-
Returns **[Object][
|
|
712
|
+
Returns **[Object][167]** An object containing 3rd party service credentials
|
|
699
713
|
|
|
700
714
|
## requireUser
|
|
701
715
|
|
|
@@ -705,11 +719,11 @@ This is an pre-requisite step for requireProject()
|
|
|
705
719
|
|
|
706
720
|
### Parameters
|
|
707
721
|
|
|
708
|
-
* `options` **[Object][
|
|
722
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
709
723
|
|
|
710
|
-
* `options.forceRetry` **[Boolean][
|
|
724
|
+
* `options.forceRetry` **[Boolean][170]** Forcabily try to refresh the user state (optional, default `false`)
|
|
711
725
|
|
|
712
|
-
Returns **[Promise][
|
|
726
|
+
Returns **[Promise][172]<[User][90]>** The current logged in user or null if none
|
|
713
727
|
|
|
714
728
|
## Project
|
|
715
729
|
|
|
@@ -719,13 +733,13 @@ Project entry within TERA
|
|
|
719
733
|
|
|
720
734
|
Get the currently active project, if any
|
|
721
735
|
|
|
722
|
-
Returns **[Promise][
|
|
736
|
+
Returns **[Promise][172]<([Project][96] | null)>** The currently active project, if any
|
|
723
737
|
|
|
724
738
|
## getProjects
|
|
725
739
|
|
|
726
740
|
Get a list of projects the current session user has access to
|
|
727
741
|
|
|
728
|
-
Returns **[Promise][
|
|
742
|
+
Returns **[Promise][172]<[Array][171]<[Project][96]>>** Collection of projects the user has access to
|
|
729
743
|
|
|
730
744
|
## setActiveProject
|
|
731
745
|
|
|
@@ -733,7 +747,7 @@ Set the currently active project within TERA
|
|
|
733
747
|
|
|
734
748
|
### Parameters
|
|
735
749
|
|
|
736
|
-
* `project` **([Object][
|
|
750
|
+
* `project` **([Object][167] | [String][166])** The project to set as active - either the full Project object or its ID
|
|
737
751
|
|
|
738
752
|
## requireProject
|
|
739
753
|
|
|
@@ -742,14 +756,14 @@ Note that this function will percist in asking the uesr even if they try to canc
|
|
|
742
756
|
|
|
743
757
|
### Parameters
|
|
744
758
|
|
|
745
|
-
* `options` **[Object][
|
|
759
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
746
760
|
|
|
747
|
-
* `options.autoSetActiveProject` **[Boolean][
|
|
748
|
-
* `options.title` **[String][
|
|
749
|
-
* `options.noSelectTitle` **[String][
|
|
750
|
-
* `options.noSelectBody` **[String][
|
|
761
|
+
* `options.autoSetActiveProject` **[Boolean][170]** After selecting a project set that project as active in TERA (optional, default `true`)
|
|
762
|
+
* `options.title` **[String][166]** The title of the dialog to display (optional, default `"Select a project to work with"`)
|
|
763
|
+
* `options.noSelectTitle` **[String][166]** Dialog title when warning the user they need to select something (optional, default `'Select project'`)
|
|
764
|
+
* `options.noSelectBody` **[String][166]** Dialog body when warning the user they need to select something (optional, default `'A project needs to be selected to continue'`)
|
|
751
765
|
|
|
752
|
-
Returns **[Promise][
|
|
766
|
+
Returns **[Promise][172]<[Project][96]>** The active project
|
|
753
767
|
|
|
754
768
|
## selectProject
|
|
755
769
|
|
|
@@ -757,13 +771,13 @@ Prompt the user to select a project from those available
|
|
|
757
771
|
|
|
758
772
|
### Parameters
|
|
759
773
|
|
|
760
|
-
* `options` **[Object][
|
|
774
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
761
775
|
|
|
762
|
-
* `options.title` **[String][
|
|
763
|
-
* `options.allowCancel` **[Boolean][
|
|
764
|
-
* `options.setActive` **[Boolean][
|
|
776
|
+
* `options.title` **[String][166]** The title of the dialog to display (optional, default `"Select a project to work with"`)
|
|
777
|
+
* `options.allowCancel` **[Boolean][170]** Advertise cancelling the operation, the dialog can still be cancelled by closing it (optional, default `true`)
|
|
778
|
+
* `options.setActive` **[Boolean][170]** Also set the project as active when selected (optional, default `false`)
|
|
765
779
|
|
|
766
|
-
Returns **[Promise][
|
|
780
|
+
Returns **[Promise][172]<[Project][96]>** The active project
|
|
767
781
|
|
|
768
782
|
## getNamespace
|
|
769
783
|
|
|
@@ -772,9 +786,9 @@ This can be used for simpler apps which don't have their own reactive / observer
|
|
|
772
786
|
|
|
773
787
|
### Parameters
|
|
774
788
|
|
|
775
|
-
* `name` **[String][
|
|
789
|
+
* `name` **[String][166]** The alias of the namespace, this should be alphanumeric + hyphens + underscores
|
|
776
790
|
|
|
777
|
-
Returns **[Promise][
|
|
791
|
+
Returns **[Promise][172]<[Object][167]>** A promise which resolves to the namespace POJO state
|
|
778
792
|
|
|
779
793
|
## setNamespace
|
|
780
794
|
|
|
@@ -783,13 +797,13 @@ This can be used for simpler apps which don't have their own reactive / observer
|
|
|
783
797
|
|
|
784
798
|
### Parameters
|
|
785
799
|
|
|
786
|
-
* `name` **[String][
|
|
787
|
-
* `state` **[Object][
|
|
788
|
-
* `options` **[Object][
|
|
800
|
+
* `name` **[String][166]** The name of the namespace
|
|
801
|
+
* `state` **[Object][167]** The state to merge
|
|
802
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
789
803
|
|
|
790
804
|
* `options.method` **(`"merge"` | `"set"`)** How to handle the state. 'merge' (merge a partial state over the existing namespace state), 'set' (completely overwrite the existing namespace) (optional, default `'merge'`)
|
|
791
805
|
|
|
792
|
-
Returns **[Promise][
|
|
806
|
+
Returns **[Promise][172]<[Object][167]>** A promise which resolves to the namespace POJO state
|
|
793
807
|
|
|
794
808
|
## listNamespaces
|
|
795
809
|
|
|
@@ -797,9 +811,9 @@ Return a list of namespaces available to the current project
|
|
|
797
811
|
|
|
798
812
|
### Properties
|
|
799
813
|
|
|
800
|
-
* `name` **[String][
|
|
814
|
+
* `name` **[String][166]** The name of the namespace
|
|
801
815
|
|
|
802
|
-
Returns **[Promise][
|
|
816
|
+
Returns **[Promise][172]<[Array][171]<[Object][167]>>** Collection of available namespaces for the current project
|
|
803
817
|
|
|
804
818
|
## getProjectState
|
|
805
819
|
|
|
@@ -807,12 +821,12 @@ Return the current, full snapshot state of the active project
|
|
|
807
821
|
|
|
808
822
|
### Parameters
|
|
809
823
|
|
|
810
|
-
* `options` **[Object][
|
|
824
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
811
825
|
|
|
812
|
-
* `options.autoRequire` **[Boolean][
|
|
813
|
-
* `Paths` **[Array][171]<[String][
|
|
826
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing (optional, default `true`)
|
|
827
|
+
* `Paths` **[Array][171]<[String][166]>** to subscribe to e.g. \['/users/'],
|
|
814
828
|
|
|
815
|
-
Returns **[Promise][
|
|
829
|
+
Returns **[Promise][172]<[Object][167]>** The current project state snapshot
|
|
816
830
|
|
|
817
831
|
## setProjectState
|
|
818
832
|
|
|
@@ -824,13 +838,13 @@ Paths can be any valid Lodash.set() value such as:
|
|
|
824
838
|
|
|
825
839
|
### Parameters
|
|
826
840
|
|
|
827
|
-
* `path` **([String][
|
|
841
|
+
* `path` **([String][166] | [Array][171]<[String][166]>)** The sub-path within the project state to set
|
|
828
842
|
* `value` **any** The value to set
|
|
829
|
-
* `options` **[Object][
|
|
843
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
830
844
|
|
|
831
|
-
* `options.save` **[Boolean][
|
|
845
|
+
* `options.save` **[Boolean][170]** Save the changes to the server immediately, disable to queue up multiple writes (optional, default `true`)
|
|
832
846
|
|
|
833
|
-
Returns **[Promise][
|
|
847
|
+
Returns **[Promise][172]** A promise which resolves when the operation has been dispatched to the server
|
|
834
848
|
|
|
835
849
|
## setProjectStateDefaults
|
|
836
850
|
|
|
@@ -840,18 +854,18 @@ Set a nested value within the project state - just like `setProjectState()` - bu
|
|
|
840
854
|
|
|
841
855
|
### Parameters
|
|
842
856
|
|
|
843
|
-
* `path` **([String][
|
|
857
|
+
* `path` **([String][166] | [Array][171]<[String][166]>)** The sub-path within the project state to set
|
|
844
858
|
* `value` **any** The value to set
|
|
845
|
-
* `options` **[Object][
|
|
859
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour, see setProjectState() for the full list of supported options
|
|
846
860
|
|
|
847
|
-
Returns **[Promise][
|
|
861
|
+
Returns **[Promise][172]<[Boolean][170]>** A promise which resolves to whether any changes were made - True if defaults were applied, false otherwise
|
|
848
862
|
|
|
849
863
|
## setProjectStateRefresh
|
|
850
864
|
|
|
851
865
|
Force refetching the remote project state into local
|
|
852
866
|
This is only ever needed when saving large quantities of data that need to be immediately available
|
|
853
867
|
|
|
854
|
-
Returns **[Promise][
|
|
868
|
+
Returns **[Promise][172]** A promise which resolves when the operation has completed
|
|
855
869
|
|
|
856
870
|
## FileFilters
|
|
857
871
|
|
|
@@ -859,10 +873,10 @@ Data structure for a file filter
|
|
|
859
873
|
|
|
860
874
|
### Properties
|
|
861
875
|
|
|
862
|
-
* `library` **[Boolean][
|
|
863
|
-
* `filename` **[String][
|
|
864
|
-
* `basename` **[String][
|
|
865
|
-
* `ext` **[String][
|
|
876
|
+
* `library` **[Boolean][170]?** Restrict to library files only
|
|
877
|
+
* `filename` **[String][166]?** CSV of @momsfriendlydevco/match expressions to filter the filename by (filenames are the basename sans extension)
|
|
878
|
+
* `basename` **[String][166]?** CSV of @momsfriendlydevco/match expressions to filter the basename by
|
|
879
|
+
* `ext` **[String][166]?** CSV of @momsfriendlydevco/match expressions to filter the file extension by
|
|
866
880
|
|
|
867
881
|
## selectProjectFile
|
|
868
882
|
|
|
@@ -870,20 +884,22 @@ Prompt the user to select a library to operate on
|
|
|
870
884
|
|
|
871
885
|
### Parameters
|
|
872
886
|
|
|
873
|
-
* `options` **[Object][
|
|
887
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
874
888
|
|
|
875
|
-
* `options.title` **[String][
|
|
876
|
-
* `options.hint` **([String][
|
|
877
|
-
* `options.save` **[Boolean][
|
|
878
|
-
* `options.
|
|
879
|
-
* `options.
|
|
880
|
-
* `options.
|
|
881
|
-
* `options.
|
|
882
|
-
* `options.
|
|
883
|
-
* `options.
|
|
884
|
-
* `options.
|
|
889
|
+
* `options.title` **[String][166]** The title of the dialog to display (optional, default `"Select a file"`)
|
|
890
|
+
* `options.hint` **([String][166] | [Array][171]<[String][166]>)?** Hints to identify the file to select in array order of preference
|
|
891
|
+
* `options.save` **[Boolean][170]** Set to truthy if saving a new file, UI will adjust to allowing overwrite OR new file name input (optional, default `false`)
|
|
892
|
+
* `options.saveFilename` **[String][166]?** File name to save as, if omitted the hinting system is used otherwise 'My File.unknown' is assumed
|
|
893
|
+
* `options.filters` **[FileFilters][118]?** Optional file filters
|
|
894
|
+
* `options.allowUpload` **[Boolean][170]** Allow uploading new files (optional, default `true`)
|
|
895
|
+
* `options.allowRefresh` **[Boolean][170]** Allow the user to manually refresh the file list (optional, default `true`)
|
|
896
|
+
* `options.allowDownloadZip` **[Boolean][170]** Allow the user to download a Zip of all files (optional, default `true`)
|
|
897
|
+
* `options.allowCancel` **[Boolean][170]** Allow cancelling the operation. Will throw `'CANCEL'` as the promise rejection if acationed (optional, default `true`)
|
|
898
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing (optional, default `true`)
|
|
899
|
+
* `options.showHiddenFiles` **[Boolean][170]** Whether hidden data.json files should be shown (optional, default `false`)
|
|
900
|
+
* `options.filter` **[FileFilters][118]?** Optional file filters
|
|
885
901
|
|
|
886
|
-
Returns **[Promise][
|
|
902
|
+
Returns **[Promise][172]<[ProjectFile][1]>** The eventually selected file, if in save mode new files are created as stubs
|
|
887
903
|
|
|
888
904
|
## getProjectFiles
|
|
889
905
|
|
|
@@ -891,13 +907,13 @@ Fetch the files associated with a given project
|
|
|
891
907
|
|
|
892
908
|
### Parameters
|
|
893
909
|
|
|
894
|
-
* `options` **[Object][
|
|
910
|
+
* `options` **[Object][167]** Options which mutate behaviour
|
|
895
911
|
|
|
896
|
-
* `options.autoRequire` **[Boolean][
|
|
897
|
-
* `options.lazy` **[Boolean][
|
|
898
|
-
* `options.meta` **[Boolean][
|
|
912
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing (optional, default `true`)
|
|
913
|
+
* `options.lazy` **[Boolean][170]** If true, use the fastest method to retrieve the file list such as the cache. If false, force a refresh each time (optional, default `true`)
|
|
914
|
+
* `options.meta` **[Boolean][170]** Pull meta information for each file entity (optional, default `true`)
|
|
899
915
|
|
|
900
|
-
Returns **[Promise][
|
|
916
|
+
Returns **[Promise][172]<[Array][171]<[ProjectFile][1]>>** A collection of project files for the given project
|
|
901
917
|
|
|
902
918
|
## getProjectFileContents
|
|
903
919
|
|
|
@@ -905,8 +921,8 @@ Fetch the raw contents of a file by its ID
|
|
|
905
921
|
|
|
906
922
|
### Parameters
|
|
907
923
|
|
|
908
|
-
* `id` **[String][
|
|
909
|
-
* `options` **[Object][
|
|
924
|
+
* `id` **[String][166]?** File ID to retrieve the contents of
|
|
925
|
+
* `options` **[Object][167]?** Additioanl options to mutate behaviour
|
|
910
926
|
|
|
911
927
|
* `options.format` **(`"blob"` | `"json"`)** The format to retrieve the file in (optional, default `'blob'`)
|
|
912
928
|
|
|
@@ -918,13 +934,13 @@ Fetch a project file by its name
|
|
|
918
934
|
|
|
919
935
|
### Parameters
|
|
920
936
|
|
|
921
|
-
* `id` **[String][
|
|
922
|
-
* `options` **([Object][
|
|
937
|
+
* `id` **[String][166]** The name + relative directory path component
|
|
938
|
+
* `options` **([Object][167] | [String][166])?** Additional options to mutate behaviour, if a string is given `options.subkey` is assumed
|
|
923
939
|
|
|
924
|
-
* `options.subkey` **[String][
|
|
925
|
-
* `options.cache` **[Boolean][
|
|
940
|
+
* `options.subkey` **[String][166]?** If specified only the extracted subkey is returned rather than the full object
|
|
941
|
+
* `options.cache` **[Boolean][170]** Use the existing file cache if possible, set to false to force a refresh of files from the server first (optional, default `true`)
|
|
926
942
|
|
|
927
|
-
Returns **[Promise][
|
|
943
|
+
Returns **[Promise][172]<[ProjectFile][1]>** The eventual fetched ProjectFile (or requested subkey)
|
|
928
944
|
|
|
929
945
|
## createProjectFile
|
|
930
946
|
|
|
@@ -933,9 +949,9 @@ This creates an empty file which can then be written to
|
|
|
933
949
|
|
|
934
950
|
### Parameters
|
|
935
951
|
|
|
936
|
-
* `name` **[String][
|
|
952
|
+
* `name` **[String][166]** The name + relative directory path component
|
|
937
953
|
|
|
938
|
-
Returns **[Promise][
|
|
954
|
+
Returns **[Promise][172]<[ProjectFile][1]>** The eventual ProjectFile created
|
|
939
955
|
|
|
940
956
|
## moveProjectFile
|
|
941
957
|
|
|
@@ -944,17 +960,17 @@ The file's unique ID (UUID) remains the same, but its 'name' (relative path) and
|
|
|
944
960
|
|
|
945
961
|
### Parameters
|
|
946
962
|
|
|
947
|
-
* `sourceId` **[String][
|
|
948
|
-
* `newName` **[String][
|
|
963
|
+
* `sourceId` **[String][166]** The unique ID (UUID) of the file to move.
|
|
964
|
+
* `newName` **[String][166]** The new relative name for the file (e.g., "documents/report-final.pdf" or "image.png").
|
|
949
965
|
This path is relative to the project's root file directory.
|
|
950
|
-
* `options` **[Object][
|
|
966
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour.
|
|
951
967
|
|
|
952
|
-
* `options.autoRequire` **[Boolean][
|
|
953
|
-
* `options.overwrite` **[Boolean][
|
|
968
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing. (optional, default `true`)
|
|
969
|
+
* `options.overwrite` **[Boolean][170]** If true (default), moving a file to a `newName` that already exists will overwrite the existing file.
|
|
954
970
|
This aligns with the default behavior of the underlying Supabase storage `move` operation.
|
|
955
971
|
If set to false, the function would ideally check and prevent overwrite, but current implementation relies on underlying storage behavior. (optional, default `true`)
|
|
956
972
|
|
|
957
|
-
Returns **[Promise][
|
|
973
|
+
Returns **[Promise][172]<([ProjectFile][1] | null)>** A promise which resolves to the updated ProjectFile object for the moved file if found after the operation,
|
|
958
974
|
or null if the file could not be located post-move (e.g., if its ID changed unexpectedly or it was deleted).
|
|
959
975
|
|
|
960
976
|
## deleteProjectFile
|
|
@@ -963,9 +979,9 @@ Remove a project file by its ID
|
|
|
963
979
|
|
|
964
980
|
### Parameters
|
|
965
981
|
|
|
966
|
-
* `id` **[String][
|
|
982
|
+
* `id` **[String][166]** The File ID to remove
|
|
967
983
|
|
|
968
|
-
Returns **[Promise][
|
|
984
|
+
Returns **[Promise][172]** A promise which resolves when the operation has completed
|
|
969
985
|
|
|
970
986
|
## setProjectFileContents
|
|
971
987
|
|
|
@@ -973,18 +989,18 @@ Save (or overwrite) a file within a project
|
|
|
973
989
|
|
|
974
990
|
### Parameters
|
|
975
991
|
|
|
976
|
-
* `id` **([String][
|
|
977
|
-
* `contents` **(File | [Blob][
|
|
978
|
-
* `options` **[Object][
|
|
992
|
+
* `id` **([String][166] | [ProjectFile][1])?** ProjectFile or ID of the same to overwrite, if omitted a file is prompted for
|
|
993
|
+
* `contents` **(File | [Blob][173] | [FormData][174] | [Object][167] | [Array][171])** The new file contents
|
|
994
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
979
995
|
|
|
980
|
-
* `options.id` **([String][
|
|
981
|
-
* `options.autoRequire` **[Boolean][
|
|
982
|
-
* `options.hint` **([String][
|
|
983
|
-
* `options.filename` **[String][
|
|
984
|
-
* `options.title` **[String][
|
|
985
|
-
* `options.meta` **[Object][
|
|
996
|
+
* `options.id` **([String][166] | [ProjectFile][1])?** Alternate method to specify the file ID to save as, if omitted one will be prompted for
|
|
997
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing (optional, default `true`)
|
|
998
|
+
* `options.hint` **([String][166] | [Array][171]<[String][166]>)?** Hint(s) to store against the library. Generally corresponds to the current operation being performed - e.g. 'deduped'
|
|
999
|
+
* `options.filename` **[String][166]?** Suggested filename if `id` is unspecified
|
|
1000
|
+
* `options.title` **[String][166]** Dialog title if `id` is unspecified and a prompt is necessary (optional, default `'Save citation library'`)
|
|
1001
|
+
* `options.meta` **[Object][167]?** Optional meta data to merge into the file data
|
|
986
1002
|
|
|
987
|
-
Returns **[Promise][
|
|
1003
|
+
Returns **[Promise][172]** A promise which will resolve when the write operation has completed
|
|
988
1004
|
|
|
989
1005
|
## createProjectFolder
|
|
990
1006
|
|
|
@@ -994,16 +1010,16 @@ This operation is idempotent: if the folder (via its placeholder) already exists
|
|
|
994
1010
|
|
|
995
1011
|
### Parameters
|
|
996
1012
|
|
|
997
|
-
* `folderPath` **[String][
|
|
998
|
-
* `options` **[Object][
|
|
1013
|
+
* `folderPath` **[String][166]** The relative path of the folder to create (e.g., "myDocuments/reports").
|
|
1014
|
+
* `options` **[Object][167]?** Additional options.
|
|
999
1015
|
|
|
1000
|
-
* `options.autoRequire` **[Boolean][
|
|
1016
|
+
* `options.autoRequire` **[Boolean][170]** Automatically run `requireProject()` to ensure an active project context. (optional, default `true`)
|
|
1001
1017
|
|
|
1002
1018
|
<!---->
|
|
1003
1019
|
|
|
1004
|
-
* Throws **[Error][
|
|
1020
|
+
* Throws **[Error][179]** If no project is active (and autoRequire is false), or if folderPath is invalid, or if the creation fails.
|
|
1005
1021
|
|
|
1006
|
-
Returns **[Promise][
|
|
1022
|
+
Returns **[Promise][172]\<void>** A promise that resolves when the folder is created or ensured.
|
|
1007
1023
|
|
|
1008
1024
|
## deleteProjectFolder
|
|
1009
1025
|
|
|
@@ -1012,16 +1028,16 @@ This involves listing all files under the given folder path (prefix) and removin
|
|
|
1012
1028
|
|
|
1013
1029
|
### Parameters
|
|
1014
1030
|
|
|
1015
|
-
* `folderPath` **[String][
|
|
1016
|
-
* `options` **[Object][
|
|
1031
|
+
* `folderPath` **[String][166]** The relative path of the folder to delete (e.g., "myDocuments/reports").
|
|
1032
|
+
* `options` **[Object][167]?** Additional options.
|
|
1017
1033
|
|
|
1018
|
-
* `options.autoRequire` **[Boolean][
|
|
1034
|
+
* `options.autoRequire` **[Boolean][170]** Automatically run `requireProject()` to ensure an active project context. (optional, default `true`)
|
|
1019
1035
|
|
|
1020
1036
|
<!---->
|
|
1021
1037
|
|
|
1022
|
-
* Throws **[Error][
|
|
1038
|
+
* Throws **[Error][179]** If no project is active (and autoRequire is false), or if folderPath is invalid, or if deletion fails.
|
|
1023
1039
|
|
|
1024
|
-
Returns **[Promise][
|
|
1040
|
+
Returns **[Promise][172]\<null>** A promise that resolves with null when the folder and its contents are deleted.
|
|
1025
1041
|
|
|
1026
1042
|
## selectProjectLibrary
|
|
1027
1043
|
|
|
@@ -1029,19 +1045,19 @@ Prompt the user to select a library to operate on and return a array of referenc
|
|
|
1029
1045
|
|
|
1030
1046
|
### Parameters
|
|
1031
1047
|
|
|
1032
|
-
* `options` **[Object][
|
|
1048
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1033
1049
|
|
|
1034
|
-
* `options.title` **[String][
|
|
1035
|
-
* `options.hint` **([String][
|
|
1036
|
-
* `options.allowUpload` **[Boolean][
|
|
1037
|
-
* `options.allowRefresh` **[Boolean][
|
|
1038
|
-
* `options.allowDownloadZip` **[Boolean][
|
|
1039
|
-
* `options.allowCancel` **[Boolean][
|
|
1040
|
-
* `options.autoRequire` **[Boolean][
|
|
1041
|
-
* `options.filters` **[FileFilters][
|
|
1050
|
+
* `options.title` **[String][166]** The title of the dialog to display (optional, default `"Select a citation library"`)
|
|
1051
|
+
* `options.hint` **([String][166] | [Array][171]<[String][166]>)?** Hints to identify the library to select in array order of preference. Generally corresponds to the previous stage - e.g. 'deduped', 'review1', 'review2', 'dedisputed'
|
|
1052
|
+
* `options.allowUpload` **[Boolean][170]** Allow uploading new files (optional, default `true`)
|
|
1053
|
+
* `options.allowRefresh` **[Boolean][170]** Allow the user to manually refresh the file list (optional, default `true`)
|
|
1054
|
+
* `options.allowDownloadZip` **[Boolean][170]** Allow the user to download a Zip of all files (optional, default `true`)
|
|
1055
|
+
* `options.allowCancel` **[Boolean][170]** Allow cancelling the operation. Will throw `'CANCEL'` as the promise rejection if acationed (optional, default `true`)
|
|
1056
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing (optional, default `true`)
|
|
1057
|
+
* `options.filters` **[FileFilters][118]?** Optional file filters, defaults to citation library selection only
|
|
1042
1058
|
* `options` **...any?** Additional options - see `getProjectLibrary()`
|
|
1043
1059
|
|
|
1044
|
-
Returns **[Promise][
|
|
1060
|
+
Returns **[Promise][172]<[Array][171]\<Ref>>** A collection of references from the selected file
|
|
1045
1061
|
|
|
1046
1062
|
## getProjectLibrary
|
|
1047
1063
|
|
|
@@ -1049,15 +1065,15 @@ Fetch + convert a project file into a library of citations
|
|
|
1049
1065
|
|
|
1050
1066
|
### Parameters
|
|
1051
1067
|
|
|
1052
|
-
* `id` **[String][
|
|
1053
|
-
* `options` **[Object][
|
|
1068
|
+
* `id` **[String][166]** File ID to read
|
|
1069
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1054
1070
|
|
|
1055
|
-
* `options.format` **[String][
|
|
1056
|
-
* `options.autoRequire` **[Boolean][
|
|
1057
|
-
* `options.filter` **[Function][
|
|
1058
|
-
* `options.find` **[Function][
|
|
1071
|
+
* `options.format` **[String][166]** Format for the file. ENUM: 'pojo' (return a parsed JS collection), 'blob' (raw JS Blob object), 'file' (named JS File object) (optional, default `'json'`)
|
|
1072
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing (optional, default `true`)
|
|
1073
|
+
* `options.filter` **[Function][176]?** Optional async file filter, called each time as `(File:ProjectFile)`
|
|
1074
|
+
* `options.find` **[Function][176]?** Optional async final stage file filter to reduce all candidates down to one subject file
|
|
1059
1075
|
|
|
1060
|
-
Returns **([Promise][
|
|
1076
|
+
Returns **([Promise][172]<[Array][171]\<Ref>> | [Promise][172]\<any>)** A collection of references (default bevahiour) or a whatever format was requested
|
|
1061
1077
|
|
|
1062
1078
|
## setProjectLibrary
|
|
1063
1079
|
|
|
@@ -1065,33 +1081,33 @@ Save back a citation library from some input
|
|
|
1065
1081
|
|
|
1066
1082
|
### Parameters
|
|
1067
1083
|
|
|
1068
|
-
* `id` **[String][
|
|
1069
|
-
* `refs` **([Array][171]\<RefLibRef> | [Blob][
|
|
1070
|
-
* `options` **[Object][
|
|
1084
|
+
* `id` **[String][166]?** File ID to save back to, if omitted a file will be prompted for
|
|
1085
|
+
* `refs` **([Array][171]\<RefLibRef> | [Blob][173] | File)?** Collection of references for the selected library or the raw Blob/File
|
|
1086
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1071
1087
|
|
|
1072
|
-
* `options.id` **[String][
|
|
1073
|
-
* `options.refs` **([Array][171]\<RefLibRef> | [Blob][
|
|
1074
|
-
* `options.format` **[String][
|
|
1075
|
-
* `options.autoRequire` **[Boolean][
|
|
1076
|
-
* `options.hint` **[String][
|
|
1077
|
-
* `options.filename` **[String][
|
|
1078
|
-
* `options.title` **[String][
|
|
1079
|
-
* `options.overwrite` **[Boolean][
|
|
1080
|
-
* `options.meta` **[Object][
|
|
1088
|
+
* `options.id` **[String][166]?** Alternate method to specify the file ID to save as, if omitted one will be prompted for
|
|
1089
|
+
* `options.refs` **([Array][171]\<RefLibRef> | [Blob][173] | File)?** Alternate method to specify the refs to save as an array or raw Blob/File
|
|
1090
|
+
* `options.format` **[String][166]** Input format used. ENUM: 'pojo' (return a parsed JS collection), 'blob' (raw JS Blob object), 'file' (named JS File object) (optional, default `'json'`)
|
|
1091
|
+
* `options.autoRequire` **[Boolean][170]** Run `requireProject()` automatically before continuing (optional, default `true`)
|
|
1092
|
+
* `options.hint` **[String][166]?** Hint to store against the library. Generally corresponds to the current operation being performed - e.g. 'deduped'
|
|
1093
|
+
* `options.filename` **[String][166]?** Suggested filename if `id` is unspecified
|
|
1094
|
+
* `options.title` **[String][166]** Dialog title if `id` is unspecified and a prompt is necessary (optional, default `'Save citation library'`)
|
|
1095
|
+
* `options.overwrite` **[Boolean][170]** Allow existing file upsert (optional, default `true`)
|
|
1096
|
+
* `options.meta` **[Object][167]?** Optional meta data to merge into the file data
|
|
1081
1097
|
|
|
1082
|
-
Returns **[Promise][
|
|
1098
|
+
Returns **[Promise][172]** A promise which resolves when the save operation has completed
|
|
1083
1099
|
|
|
1084
1100
|
## projectLog
|
|
1085
1101
|
|
|
1086
1102
|
Create a log entry for the currently active project
|
|
1087
1103
|
|
|
1088
|
-
The required log object can be of various forms. See [https://tera-tools.com/api/logs.json][
|
|
1104
|
+
The required log object can be of various forms. See [https://tera-tools.com/api/logs.json][180] for the full list
|
|
1089
1105
|
|
|
1090
1106
|
### Parameters
|
|
1091
1107
|
|
|
1092
|
-
* `log` **[Object][
|
|
1108
|
+
* `log` **[Object][167]** The log entry to create
|
|
1093
1109
|
|
|
1094
|
-
Returns **[Promise][
|
|
1110
|
+
Returns **[Promise][172]** A promise which resolves when the operation has completed
|
|
1095
1111
|
|
|
1096
1112
|
## setPage
|
|
1097
1113
|
|
|
@@ -1100,10 +1116,10 @@ This is usually called by a tool nested within the tera-tools.com embed
|
|
|
1100
1116
|
|
|
1101
1117
|
### Parameters
|
|
1102
1118
|
|
|
1103
|
-
* `options` **([Object][
|
|
1119
|
+
* `options` **([Object][167] | [String][166])** Context information about the page, if this is a string, its assumed to popupate `url`
|
|
1104
1120
|
|
|
1105
|
-
* `options.path` **[String][
|
|
1106
|
-
* `options.title` **[String][
|
|
1121
|
+
* `options.path` **[String][166]?** The URL path segment to restore on next refresh
|
|
1122
|
+
* `options.title` **[String][166]?** The page title associated with the path
|
|
1107
1123
|
|
|
1108
1124
|
## uiAlert
|
|
1109
1125
|
|
|
@@ -1111,15 +1127,15 @@ Display simple text within TERA
|
|
|
1111
1127
|
|
|
1112
1128
|
### Parameters
|
|
1113
1129
|
|
|
1114
|
-
* `text` **[String][
|
|
1115
|
-
* `options` **[Object][
|
|
1130
|
+
* `text` **[String][166]?** Text to display, if specified this populates `options.body`
|
|
1131
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1116
1132
|
|
|
1117
|
-
* `options.body` **[String][
|
|
1118
|
-
* `options.isHtml` **[Boolean][
|
|
1119
|
-
* `options.title` **[String][
|
|
1133
|
+
* `options.body` **[String][166]** The body text to display (optional, default `"Alert!"`)
|
|
1134
|
+
* `options.isHtml` **[Boolean][170]** If falsy the text is rendered as plain-text otherwise it will be assumed as HTML content (optional, default `false`)
|
|
1135
|
+
* `options.title` **[String][166]** The title of the alert box (optional, default `'TERA'`)
|
|
1120
1136
|
* `options.buttons` **(`"ok"` | `false`)** Button set to use or falsy to disable (optional, default `'ok'`)
|
|
1121
1137
|
|
|
1122
|
-
Returns **[Promise][
|
|
1138
|
+
Returns **[Promise][172]** A promise which resolves when the alert has been dismissed
|
|
1123
1139
|
|
|
1124
1140
|
## uiConfirm
|
|
1125
1141
|
|
|
@@ -1127,14 +1143,14 @@ Present a simple ok/cancel dialog to the user
|
|
|
1127
1143
|
|
|
1128
1144
|
### Parameters
|
|
1129
1145
|
|
|
1130
|
-
* `text` **[String][
|
|
1131
|
-
* `options` **[Object][
|
|
1146
|
+
* `text` **[String][166]?** Text to display, if specified this populates `options.body`
|
|
1147
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1132
1148
|
|
|
1133
|
-
* `options.body` **[String][
|
|
1134
|
-
* `options.isHtml` **[Boolean][
|
|
1135
|
-
* `options.title` **[String][
|
|
1149
|
+
* `options.body` **[String][166]** The body text to display (optional, default `"Confirm?"`)
|
|
1150
|
+
* `options.isHtml` **[Boolean][170]** If falsy the text is rendered as plain-text otherwise it will be assumed as HTML content (optional, default `false`)
|
|
1151
|
+
* `options.title` **[String][166]** The title of the confirmation box (optional, default `'TERA'`)
|
|
1136
1152
|
|
|
1137
|
-
Returns **[Promise][
|
|
1153
|
+
Returns **[Promise][172]** A promise which resolves with `Promise.resolve('OK')` or rejects with `Promise.reject('CANCEL')`
|
|
1138
1154
|
|
|
1139
1155
|
## uiPanic
|
|
1140
1156
|
|
|
@@ -1142,7 +1158,7 @@ Trigger a fatal error, killing the outer TERA site
|
|
|
1142
1158
|
|
|
1143
1159
|
### Parameters
|
|
1144
1160
|
|
|
1145
|
-
* `text` **[String][
|
|
1161
|
+
* `text` **[String][166]?** Text to display
|
|
1146
1162
|
|
|
1147
1163
|
## uiProgress
|
|
1148
1164
|
|
|
@@ -1151,18 +1167,18 @@ All options are cumulative - i.e. they are merged with other options previously
|
|
|
1151
1167
|
|
|
1152
1168
|
### Parameters
|
|
1153
1169
|
|
|
1154
|
-
* `options` **([Object][
|
|
1170
|
+
* `options` **([Object][167] | [Boolean][170])?** Additional options to mutate behaviour, if boolean false `{close: true}` is assumed
|
|
1155
1171
|
|
|
1156
|
-
* `options.title` **[String][
|
|
1157
|
-
* `options.backdrop` **[String][
|
|
1158
|
-
* `options.body` **[String][
|
|
1159
|
-
* `options.bodyHtml` **[Boolean][
|
|
1160
|
-
* `options.close` **[Boolean][
|
|
1161
|
-
* `options.text` **[String][
|
|
1162
|
-
* `options.progress` **[Number][
|
|
1163
|
-
* `options.maxProgress` **[Number][
|
|
1172
|
+
* `options.title` **[String][166]** Window title, can only be set on the initial call (optional, default `'TERA'`)
|
|
1173
|
+
* `options.backdrop` **[String][166]** Set to `'static'` to prevent user being able to click outside the modal to close (optional, default `true`)
|
|
1174
|
+
* `options.body` **[String][166]** Window body text, can only be set on the initial call (optional, default `''`)
|
|
1175
|
+
* `options.bodyHtml` **[Boolean][170]** Treat body text as HTML (optional, default `false`)
|
|
1176
|
+
* `options.close` **[Boolean][170]** Close the existing dialog, if true the dialog is disposed and options reset (optional, default `false`)
|
|
1177
|
+
* `options.text` **[String][166]?** The text of the task being conducted
|
|
1178
|
+
* `options.progress` **[Number][169]?** The current progress of the task being conducted, this is assumed to be a value less than `maxProgress`
|
|
1179
|
+
* `options.maxProgress` **[Number][169]?** The maximum value that the progress can be
|
|
1164
1180
|
|
|
1165
|
-
Returns **[Promise][
|
|
1181
|
+
Returns **[Promise][172]** A promise which resolves when the dialog has been updated
|
|
1166
1182
|
|
|
1167
1183
|
## uiPrompt
|
|
1168
1184
|
|
|
@@ -1170,17 +1186,17 @@ Prompt the user for an input, responding with a Promisable value
|
|
|
1170
1186
|
|
|
1171
1187
|
### Parameters
|
|
1172
1188
|
|
|
1173
|
-
* `text` **[String][
|
|
1174
|
-
* `options` **[Object][
|
|
1189
|
+
* `text` **[String][166]?** Text to display, if specified this populates `options.body`
|
|
1190
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1175
1191
|
|
|
1176
|
-
* `options.body` **[String][
|
|
1177
|
-
* `options.isHtml` **[Boolean][
|
|
1178
|
-
* `options.value` **[String][
|
|
1179
|
-
* `options.title` **[String][
|
|
1180
|
-
* `options.placeholder` **[String][
|
|
1181
|
-
* `options.required` **[Boolean][
|
|
1192
|
+
* `options.body` **[String][166]?** Optional additional body text
|
|
1193
|
+
* `options.isHtml` **[Boolean][170]** If truthy, treat the body as HTML (optional, default `false`)
|
|
1194
|
+
* `options.value` **[String][166]?** Current or default value to display pre-filled
|
|
1195
|
+
* `options.title` **[String][166]** The dialog title to display (optional, default `'Input required'`)
|
|
1196
|
+
* `options.placeholder` **[String][166]?** Optional placeholder text
|
|
1197
|
+
* `options.required` **[Boolean][170]** Treat nullish or empty inputs as a cancel operation (optional, default `true`)
|
|
1182
1198
|
|
|
1183
|
-
Returns **[Promise][
|
|
1199
|
+
Returns **[Promise][172]\<any>** Either the eventual user value or a throw with `Promise.reject('CANCEL')`
|
|
1184
1200
|
|
|
1185
1201
|
## uiThrow
|
|
1186
1202
|
|
|
@@ -1188,7 +1204,7 @@ Catch an error using the TERA error handler
|
|
|
1188
1204
|
|
|
1189
1205
|
### Parameters
|
|
1190
1206
|
|
|
1191
|
-
* `error` **([Error][
|
|
1207
|
+
* `error` **([Error][179] | [Object][167] | [String][166])** Error to handle, generally an Error object but can be a POJO or a scalar string
|
|
1192
1208
|
|
|
1193
1209
|
Returns **Void** This function is fatal
|
|
1194
1210
|
|
|
@@ -1198,13 +1214,13 @@ Open a popup window containing a new site
|
|
|
1198
1214
|
|
|
1199
1215
|
### Parameters
|
|
1200
1216
|
|
|
1201
|
-
* `url` **[String][
|
|
1202
|
-
* `options` **[Object][
|
|
1217
|
+
* `url` **[String][166]** The URL to open
|
|
1218
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1203
1219
|
|
|
1204
|
-
* `options.width` **[Number][
|
|
1205
|
-
* `options.height` **[Number][
|
|
1206
|
-
* `options.center` **[Boolean][
|
|
1207
|
-
* `options.permissions` **[Object][
|
|
1220
|
+
* `options.width` **[Number][169]** The desired width of the window (optional, default `500`)
|
|
1221
|
+
* `options.height` **[Number][169]** The desired height of the window (optional, default `600`)
|
|
1222
|
+
* `options.center` **[Boolean][170]** Attempt to center the window on the screen (optional, default `true`)
|
|
1223
|
+
* `options.permissions` **[Object][167]?** Additional permissions to set on opening, defaults to a suitable set of permission for popups (see code)
|
|
1208
1224
|
|
|
1209
1225
|
Returns **WindowProxy** The opened window object (if `noopener` is not set in permissions)
|
|
1210
1226
|
|
|
@@ -1215,10 +1231,10 @@ This function is ideally called within a requestFocus() wrapper
|
|
|
1215
1231
|
|
|
1216
1232
|
### Parameters
|
|
1217
1233
|
|
|
1218
|
-
* `content` **(DOMElement | [String][
|
|
1219
|
-
* `options` **[Object][
|
|
1234
|
+
* `content` **(DOMElement | [String][166] | `false`)** Either a prepared DOM element or string to compile, set to falsy to remove existing content
|
|
1235
|
+
* `options` **[Object][167]?** Additional options to mutate behaviour
|
|
1220
1236
|
|
|
1221
|
-
* `options.logo` **([Boolean][
|
|
1237
|
+
* `options.logo` **([Boolean][170] | [String][166])** Add a logo to the output, if boolean true the Tera-tools logo is used otherwise specify a path or URL (optional, default `false`)
|
|
1222
1238
|
|
|
1223
1239
|
[1]: #projectfile
|
|
1224
1240
|
|
|
@@ -1260,318 +1276,322 @@ This function is ideally called within a requestFocus() wrapper
|
|
|
1260
1276
|
|
|
1261
1277
|
[20]: #meta
|
|
1262
1278
|
|
|
1263
|
-
[21]: #
|
|
1279
|
+
[21]: #isfolder
|
|
1264
1280
|
|
|
1265
|
-
[22]: #
|
|
1281
|
+
[22]: #files
|
|
1266
1282
|
|
|
1267
|
-
[23]: #
|
|
1283
|
+
[23]: #getcontents
|
|
1268
1284
|
|
|
1269
|
-
[24]: #parameters
|
|
1285
|
+
[24]: #parameters
|
|
1270
1286
|
|
|
1271
|
-
[25]: #
|
|
1287
|
+
[25]: #setcontents
|
|
1272
1288
|
|
|
1273
|
-
[26]: #
|
|
1289
|
+
[26]: #parameters-1
|
|
1274
1290
|
|
|
1275
|
-
[27]: #
|
|
1291
|
+
[27]: #getrefs
|
|
1276
1292
|
|
|
1277
|
-
[28]: #
|
|
1293
|
+
[28]: #setrefs
|
|
1278
1294
|
|
|
1279
|
-
[29]: #
|
|
1295
|
+
[29]: #parameters-2
|
|
1280
1296
|
|
|
1281
|
-
[30]: #
|
|
1297
|
+
[30]: #serialize
|
|
1282
1298
|
|
|
1283
|
-
[31]: #
|
|
1299
|
+
[31]: #deserialize
|
|
1284
1300
|
|
|
1285
|
-
[32]: #
|
|
1301
|
+
[32]: #parameters-3
|
|
1286
1302
|
|
|
1287
|
-
[33]: #
|
|
1303
|
+
[33]: #terafy
|
|
1288
1304
|
|
|
1289
|
-
[34]: #
|
|
1305
|
+
[34]: #settings
|
|
1290
1306
|
|
|
1291
|
-
[35]: #
|
|
1307
|
+
[35]: #properties-1
|
|
1292
1308
|
|
|
1293
|
-
[36]: #
|
|
1309
|
+
[36]: #events
|
|
1294
1310
|
|
|
1295
|
-
[37]: #
|
|
1311
|
+
[37]: #dom
|
|
1296
1312
|
|
|
1297
|
-
[38]: #
|
|
1313
|
+
[38]: #properties-2
|
|
1298
1314
|
|
|
1299
|
-
[39]: #
|
|
1315
|
+
[39]: #methods
|
|
1300
1316
|
|
|
1301
|
-
[40]: #
|
|
1317
|
+
[40]: #plugins
|
|
1302
1318
|
|
|
1303
|
-
[41]: #
|
|
1319
|
+
[41]: #namespaces
|
|
1304
1320
|
|
|
1305
|
-
[42]: #
|
|
1321
|
+
[42]: #send
|
|
1306
1322
|
|
|
1307
|
-
[43]: #parameters-
|
|
1323
|
+
[43]: #parameters-4
|
|
1308
1324
|
|
|
1309
|
-
[44]: #
|
|
1325
|
+
[44]: #sendraw
|
|
1310
1326
|
|
|
1311
|
-
[45]: #parameters-
|
|
1327
|
+
[45]: #parameters-5
|
|
1312
1328
|
|
|
1313
|
-
[46]: #
|
|
1329
|
+
[46]: #rpc
|
|
1314
1330
|
|
|
1315
|
-
[47]: #parameters-
|
|
1331
|
+
[47]: #parameters-6
|
|
1316
1332
|
|
|
1317
|
-
[48]: #
|
|
1333
|
+
[48]: #acceptmessage
|
|
1318
1334
|
|
|
1319
|
-
[49]: #
|
|
1335
|
+
[49]: #parameters-7
|
|
1320
1336
|
|
|
1321
|
-
[50]: #
|
|
1337
|
+
[50]: #acceptpostboxes
|
|
1322
1338
|
|
|
1323
|
-
[51]: #
|
|
1339
|
+
[51]: #init
|
|
1324
1340
|
|
|
1325
|
-
[52]: #
|
|
1341
|
+
[52]: #parameters-8
|
|
1326
1342
|
|
|
1327
|
-
[53]: #
|
|
1343
|
+
[53]: #detectmode
|
|
1328
1344
|
|
|
1329
|
-
[54]: #
|
|
1345
|
+
[54]: #injectcomms
|
|
1330
1346
|
|
|
1331
|
-
[55]: #
|
|
1347
|
+
[55]: #handshakeloop
|
|
1332
1348
|
|
|
1333
|
-
[56]: #
|
|
1349
|
+
[56]: #parameters-9
|
|
1334
1350
|
|
|
1335
|
-
[57]: #
|
|
1351
|
+
[57]: #properties-3
|
|
1336
1352
|
|
|
1337
|
-
[58]: #
|
|
1353
|
+
[58]: #injectstylesheet
|
|
1338
1354
|
|
|
1339
|
-
[59]: #
|
|
1355
|
+
[59]: #injectmethods
|
|
1340
1356
|
|
|
1341
|
-
[60]: #
|
|
1357
|
+
[60]: #debug
|
|
1342
1358
|
|
|
1343
|
-
[61]: #parameters-
|
|
1359
|
+
[61]: #parameters-10
|
|
1344
1360
|
|
|
1345
|
-
[62]: #
|
|
1361
|
+
[62]: #set
|
|
1346
1362
|
|
|
1347
|
-
[63]: #parameters-
|
|
1363
|
+
[63]: #parameters-11
|
|
1348
1364
|
|
|
1349
|
-
[64]: #
|
|
1365
|
+
[64]: #setifdev
|
|
1350
1366
|
|
|
1351
|
-
[65]: #parameters-
|
|
1367
|
+
[65]: #parameters-12
|
|
1352
1368
|
|
|
1353
|
-
[66]: #
|
|
1369
|
+
[66]: #use
|
|
1354
1370
|
|
|
1355
|
-
[67]: #parameters-
|
|
1371
|
+
[67]: #parameters-13
|
|
1356
1372
|
|
|
1357
|
-
[68]: #
|
|
1373
|
+
[68]: #mixin
|
|
1358
1374
|
|
|
1359
|
-
[69]: #parameters-
|
|
1375
|
+
[69]: #parameters-14
|
|
1360
1376
|
|
|
1361
|
-
[70]: #
|
|
1377
|
+
[70]: #toggledevmode
|
|
1362
1378
|
|
|
1363
|
-
[71]: #parameters-
|
|
1379
|
+
[71]: #parameters-15
|
|
1364
1380
|
|
|
1365
|
-
[72]: #
|
|
1381
|
+
[72]: #togglefocus
|
|
1366
1382
|
|
|
1367
|
-
[73]: #parameters-
|
|
1383
|
+
[73]: #parameters-16
|
|
1368
1384
|
|
|
1369
|
-
[74]: #
|
|
1385
|
+
[74]: #getentropicstring
|
|
1370
1386
|
|
|
1371
|
-
[75]: #parameters-
|
|
1387
|
+
[75]: #parameters-17
|
|
1372
1388
|
|
|
1373
|
-
[76]: #
|
|
1389
|
+
[76]: #selectprojectfile
|
|
1374
1390
|
|
|
1375
|
-
[77]: #parameters-
|
|
1391
|
+
[77]: #parameters-18
|
|
1376
1392
|
|
|
1377
|
-
[78]: #
|
|
1393
|
+
[78]: #mountnamespace
|
|
1378
1394
|
|
|
1379
|
-
[79]: #parameters-
|
|
1395
|
+
[79]: #parameters-19
|
|
1380
1396
|
|
|
1381
|
-
[80]: #
|
|
1397
|
+
[80]: #actual-namespace-mounting-function-designed-to-be-overriden-by-plugins
|
|
1382
1398
|
|
|
1383
|
-
[81]: #parameters-
|
|
1399
|
+
[81]: #parameters-20
|
|
1384
1400
|
|
|
1385
|
-
[82]: #
|
|
1401
|
+
[82]: #unmountnamespace
|
|
1386
1402
|
|
|
1387
|
-
[83]: #parameters-
|
|
1403
|
+
[83]: #parameters-21
|
|
1388
1404
|
|
|
1389
|
-
[84]: #
|
|
1405
|
+
[84]: #actual-namespace-unmounting-function-designed-to-be-overriden-by-plugins
|
|
1390
1406
|
|
|
1391
|
-
[85]: #
|
|
1407
|
+
[85]: #parameters-22
|
|
1392
1408
|
|
|
1393
|
-
[86]: #
|
|
1409
|
+
[86]: #handshake
|
|
1394
1410
|
|
|
1395
|
-
[87]: #
|
|
1411
|
+
[87]: #properties-4
|
|
1396
1412
|
|
|
1397
|
-
[88]: #
|
|
1413
|
+
[88]: #setserververbosity
|
|
1398
1414
|
|
|
1399
|
-
[89]: #
|
|
1415
|
+
[89]: #parameters-23
|
|
1400
1416
|
|
|
1401
|
-
[90]: #
|
|
1417
|
+
[90]: #user
|
|
1402
1418
|
|
|
1403
|
-
[91]: #
|
|
1419
|
+
[91]: #properties-5
|
|
1404
1420
|
|
|
1405
|
-
[92]: #
|
|
1421
|
+
[92]: #getuser
|
|
1406
1422
|
|
|
1407
|
-
[93]: #
|
|
1423
|
+
[93]: #getcredentials
|
|
1408
1424
|
|
|
1409
|
-
[94]: #
|
|
1425
|
+
[94]: #requireuser
|
|
1410
1426
|
|
|
1411
|
-
[95]: #
|
|
1427
|
+
[95]: #parameters-24
|
|
1412
1428
|
|
|
1413
|
-
[96]: #
|
|
1429
|
+
[96]: #project
|
|
1414
1430
|
|
|
1415
|
-
[97]: #
|
|
1431
|
+
[97]: #getproject
|
|
1416
1432
|
|
|
1417
|
-
[98]: #
|
|
1433
|
+
[98]: #getprojects
|
|
1418
1434
|
|
|
1419
|
-
[99]: #
|
|
1435
|
+
[99]: #setactiveproject
|
|
1420
1436
|
|
|
1421
|
-
[100]: #parameters-
|
|
1437
|
+
[100]: #parameters-25
|
|
1422
1438
|
|
|
1423
|
-
[101]: #
|
|
1439
|
+
[101]: #requireproject
|
|
1424
1440
|
|
|
1425
|
-
[102]: #parameters-
|
|
1441
|
+
[102]: #parameters-26
|
|
1426
1442
|
|
|
1427
|
-
[103]: #
|
|
1443
|
+
[103]: #selectproject
|
|
1428
1444
|
|
|
1429
|
-
[104]: #parameters-
|
|
1445
|
+
[104]: #parameters-27
|
|
1430
1446
|
|
|
1431
|
-
[105]: #
|
|
1447
|
+
[105]: #getnamespace
|
|
1432
1448
|
|
|
1433
|
-
[106]: #parameters-
|
|
1449
|
+
[106]: #parameters-28
|
|
1434
1450
|
|
|
1435
|
-
[107]: #
|
|
1451
|
+
[107]: #setnamespace
|
|
1436
1452
|
|
|
1437
|
-
[108]: #
|
|
1453
|
+
[108]: #parameters-29
|
|
1438
1454
|
|
|
1439
|
-
[109]: #
|
|
1455
|
+
[109]: #listnamespaces
|
|
1440
1456
|
|
|
1441
|
-
[110]: #
|
|
1457
|
+
[110]: #properties-6
|
|
1442
1458
|
|
|
1443
|
-
[111]: #
|
|
1459
|
+
[111]: #getprojectstate
|
|
1444
1460
|
|
|
1445
|
-
[112]: #parameters-
|
|
1461
|
+
[112]: #parameters-30
|
|
1446
1462
|
|
|
1447
|
-
[113]: #
|
|
1463
|
+
[113]: #setprojectstate
|
|
1448
1464
|
|
|
1449
|
-
[114]: #parameters-
|
|
1465
|
+
[114]: #parameters-31
|
|
1450
1466
|
|
|
1451
|
-
[115]: #
|
|
1467
|
+
[115]: #setprojectstatedefaults
|
|
1452
1468
|
|
|
1453
|
-
[116]: #
|
|
1469
|
+
[116]: #parameters-32
|
|
1454
1470
|
|
|
1455
|
-
[117]: #
|
|
1471
|
+
[117]: #setprojectstaterefresh
|
|
1456
1472
|
|
|
1457
|
-
[118]: #
|
|
1473
|
+
[118]: #filefilters
|
|
1458
1474
|
|
|
1459
|
-
[119]: #
|
|
1475
|
+
[119]: #properties-7
|
|
1460
1476
|
|
|
1461
|
-
[120]: #
|
|
1477
|
+
[120]: #selectprojectfile-1
|
|
1462
1478
|
|
|
1463
|
-
[121]: #parameters-
|
|
1479
|
+
[121]: #parameters-33
|
|
1464
1480
|
|
|
1465
|
-
[122]: #
|
|
1481
|
+
[122]: #getprojectfiles
|
|
1466
1482
|
|
|
1467
|
-
[123]: #parameters-
|
|
1483
|
+
[123]: #parameters-34
|
|
1468
1484
|
|
|
1469
|
-
[124]: #
|
|
1485
|
+
[124]: #getprojectfilecontents
|
|
1470
1486
|
|
|
1471
|
-
[125]: #parameters-
|
|
1487
|
+
[125]: #parameters-35
|
|
1472
1488
|
|
|
1473
|
-
[126]: #
|
|
1489
|
+
[126]: #getprojectfile
|
|
1474
1490
|
|
|
1475
|
-
[127]: #parameters-
|
|
1491
|
+
[127]: #parameters-36
|
|
1476
1492
|
|
|
1477
|
-
[128]: #
|
|
1493
|
+
[128]: #createprojectfile
|
|
1478
1494
|
|
|
1479
|
-
[129]: #parameters-
|
|
1495
|
+
[129]: #parameters-37
|
|
1480
1496
|
|
|
1481
|
-
[130]: #
|
|
1497
|
+
[130]: #moveprojectfile
|
|
1482
1498
|
|
|
1483
|
-
[131]: #parameters-
|
|
1499
|
+
[131]: #parameters-38
|
|
1484
1500
|
|
|
1485
|
-
[132]: #
|
|
1501
|
+
[132]: #deleteprojectfile
|
|
1486
1502
|
|
|
1487
|
-
[133]: #parameters-
|
|
1503
|
+
[133]: #parameters-39
|
|
1488
1504
|
|
|
1489
|
-
[134]: #
|
|
1505
|
+
[134]: #setprojectfilecontents
|
|
1490
1506
|
|
|
1491
|
-
[135]: #parameters-
|
|
1507
|
+
[135]: #parameters-40
|
|
1492
1508
|
|
|
1493
|
-
[136]: #
|
|
1509
|
+
[136]: #createprojectfolder
|
|
1494
1510
|
|
|
1495
|
-
[137]: #parameters-
|
|
1511
|
+
[137]: #parameters-41
|
|
1496
1512
|
|
|
1497
|
-
[138]: #
|
|
1513
|
+
[138]: #deleteprojectfolder
|
|
1498
1514
|
|
|
1499
|
-
[139]: #parameters-
|
|
1515
|
+
[139]: #parameters-42
|
|
1500
1516
|
|
|
1501
|
-
[140]: #
|
|
1517
|
+
[140]: #selectprojectlibrary
|
|
1502
1518
|
|
|
1503
|
-
[141]: #parameters-
|
|
1519
|
+
[141]: #parameters-43
|
|
1504
1520
|
|
|
1505
|
-
[142]: #
|
|
1521
|
+
[142]: #getprojectlibrary
|
|
1506
1522
|
|
|
1507
|
-
[143]: #parameters-
|
|
1523
|
+
[143]: #parameters-44
|
|
1508
1524
|
|
|
1509
|
-
[144]: #
|
|
1525
|
+
[144]: #setprojectlibrary
|
|
1510
1526
|
|
|
1511
|
-
[145]: #parameters-
|
|
1527
|
+
[145]: #parameters-45
|
|
1512
1528
|
|
|
1513
|
-
[146]: #
|
|
1529
|
+
[146]: #projectlog
|
|
1514
1530
|
|
|
1515
|
-
[147]: #parameters-
|
|
1531
|
+
[147]: #parameters-46
|
|
1516
1532
|
|
|
1517
|
-
[148]: #
|
|
1533
|
+
[148]: #setpage
|
|
1518
1534
|
|
|
1519
|
-
[149]: #parameters-
|
|
1535
|
+
[149]: #parameters-47
|
|
1520
1536
|
|
|
1521
|
-
[150]: #
|
|
1537
|
+
[150]: #uialert
|
|
1522
1538
|
|
|
1523
|
-
[151]: #parameters-
|
|
1539
|
+
[151]: #parameters-48
|
|
1524
1540
|
|
|
1525
|
-
[152]: #
|
|
1541
|
+
[152]: #uiconfirm
|
|
1526
1542
|
|
|
1527
|
-
[153]: #parameters-
|
|
1543
|
+
[153]: #parameters-49
|
|
1528
1544
|
|
|
1529
|
-
[154]: #
|
|
1545
|
+
[154]: #uipanic
|
|
1530
1546
|
|
|
1531
|
-
[155]: #parameters-
|
|
1547
|
+
[155]: #parameters-50
|
|
1532
1548
|
|
|
1533
|
-
[156]: #
|
|
1549
|
+
[156]: #uiprogress
|
|
1534
1550
|
|
|
1535
|
-
[157]: #parameters-
|
|
1551
|
+
[157]: #parameters-51
|
|
1536
1552
|
|
|
1537
|
-
[158]: #
|
|
1553
|
+
[158]: #uiprompt
|
|
1538
1554
|
|
|
1539
|
-
[159]: #parameters-
|
|
1555
|
+
[159]: #parameters-52
|
|
1540
1556
|
|
|
1541
|
-
[160]: #
|
|
1557
|
+
[160]: #uithrow
|
|
1542
1558
|
|
|
1543
|
-
[161]: #parameters-
|
|
1559
|
+
[161]: #parameters-53
|
|
1544
1560
|
|
|
1545
|
-
[162]: #
|
|
1561
|
+
[162]: #uiwindow
|
|
1546
1562
|
|
|
1547
|
-
[163]: #parameters-
|
|
1563
|
+
[163]: #parameters-54
|
|
1548
1564
|
|
|
1549
|
-
[164]:
|
|
1565
|
+
[164]: #uisplat
|
|
1550
1566
|
|
|
1551
|
-
[165]:
|
|
1567
|
+
[165]: #parameters-55
|
|
1552
1568
|
|
|
1553
|
-
[166]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/
|
|
1569
|
+
[166]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/String
|
|
1554
1570
|
|
|
1555
|
-
[167]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/
|
|
1571
|
+
[167]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Object
|
|
1556
1572
|
|
|
1557
|
-
[168]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/
|
|
1573
|
+
[168]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Date
|
|
1558
1574
|
|
|
1559
|
-
[169]: https://developer.mozilla.org/docs/Web/
|
|
1575
|
+
[169]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Number
|
|
1560
1576
|
|
|
1561
|
-
[170]: https://developer.mozilla.org/docs/Web/
|
|
1577
|
+
[170]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Boolean
|
|
1562
1578
|
|
|
1563
1579
|
[171]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Array
|
|
1564
1580
|
|
|
1565
|
-
[172]: https://developer.mozilla.org/
|
|
1581
|
+
[172]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Promise
|
|
1582
|
+
|
|
1583
|
+
[173]: https://developer.mozilla.org/docs/Web/API/Blob
|
|
1584
|
+
|
|
1585
|
+
[174]: https://developer.mozilla.org/docs/Web/API/FormData
|
|
1566
1586
|
|
|
1567
|
-
[
|
|
1587
|
+
[175]: https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
|
|
1568
1588
|
|
|
1569
|
-
[
|
|
1589
|
+
[176]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Statements/function
|
|
1570
1590
|
|
|
1571
|
-
[
|
|
1591
|
+
[177]: https://developer.mozilla.org/docs/Web/API/Window
|
|
1572
1592
|
|
|
1573
|
-
[
|
|
1593
|
+
[178]: https://developer.mozilla.org/docs/Web/API/MessageEvent
|
|
1574
1594
|
|
|
1575
|
-
[
|
|
1595
|
+
[179]: https://developer.mozilla.org/docs/Web/JavaScript/Reference/Global_Objects/Error
|
|
1576
1596
|
|
|
1577
|
-
[
|
|
1597
|
+
[180]: https://tera-tools.com/api/logs.json
|