@pitcher/js-api 1.21.0-beta.13 → 1.21.0-beta.15
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/js-api.esm.js +111 -6
- package/js-api.esm.js.map +1 -1
- package/js-api.umd.min.js +10 -10
- package/js-api.umd.min.js.map +1 -1
- package/lib/apps/browser/stores/api.d.ts +164 -104
- package/lib/apps/browser/stores/app.d.ts +6 -1
- package/lib/apps/browser/stores/upload.d.ts +30 -30
- package/lib/apps/canvas-builder/composables/useCanvas.d.ts +508 -421
- package/lib/apps/canvas-builder/composables/useCanvasHistory.d.ts +86 -74
- package/lib/apps/canvas-builder/composables/useCanvasTheme.d.ts +18 -20
- package/lib/apps/canvas-builder/composables/useContentSelector.d.ts +5 -5
- package/lib/apps/canvas-builder/composables/useInstalledEmbeddables.d.ts +4 -1
- package/lib/apps/canvas-builder/types/canvas.d.ts +1 -0
- package/lib/apps/canvas-builder/util/canvas.util.d.ts +1 -0
- package/lib/apps/content-selector/stores/app.d.ts +8 -1
- package/lib/components/CFileViewer/CFileViewer.use.d.ts +2 -4
- package/lib/components/CFileViewer/CFileViewerFullScreen.use.d.ts +1 -1
- package/lib/components/filters/filter.util.d.ts +1 -1
- package/lib/composables/instanceTagsActions.use.d.ts +14 -0
- package/lib/composables/recentFiles.use.d.ts +1 -1
- package/lib/composables/suggestedTags.use.d.ts +3 -0
- package/lib/composables/tableColumnsSettings.use.d.ts +25 -0
- package/lib/composables/useCanvasOverlay.d.ts +20 -0
- package/lib/composables/useConfirmation.d.ts +1 -0
- package/lib/composables/useElementHeightResize.d.ts +5 -0
- package/lib/composables/useFiles.d.ts +11 -0
- package/lib/constants/pitcherSettings.const.d.ts +4 -0
- package/lib/main.lib.d.ts +26 -20
- package/lib/sdk/api/HighLevelApi.d.ts +95 -2
- package/lib/sdk/api/modules/admin/canvas.admin.d.ts +24 -8
- package/lib/sdk/api/modules/admin/env.admin.d.ts +3 -2
- package/lib/sdk/api/modules/admin/files.admin.d.ts +10 -10
- package/lib/sdk/api/modules/admin/index.d.ts +20 -0
- package/lib/sdk/api/modules/admin/metadataTemplates.admin.d.ts +1 -2
- package/lib/sdk/api/modules/admin/types.admin.d.ts +94 -0
- package/lib/sdk/api/modules/canvas.d.ts +2 -4
- package/lib/sdk/api/modules/dsr/env.dsr.d.ts +4 -3
- package/lib/sdk/api/modules/dsr/index.d.ts +7 -0
- package/lib/sdk/api/modules/dsr/loading.dsr.d.ts +6 -0
- package/lib/sdk/api/modules/env.d.ts +16 -0
- package/lib/sdk/api/modules/favorites.d.ts +9 -0
- package/lib/sdk/api/modules/feedback.d.ts +3 -0
- package/lib/sdk/api/modules/files.d.ts +1 -2
- package/lib/sdk/api/modules/folders.d.ts +29 -0
- package/lib/sdk/api/modules/open.d.ts +6 -0
- package/lib/sdk/api/modules/sync.d.ts +1 -2
- package/lib/sdk/api/modules/ui/app-errors.ui.d.ts +12 -0
- package/lib/sdk/api/modules/ui/canvas.ui.d.ts +73 -0
- package/lib/sdk/api/modules/ui/content.ui.d.ts +36 -3
- package/lib/sdk/api/modules/ui/index.d.ts +114 -0
- package/lib/sdk/api/modules/ui/loading.ui.d.ts +15 -0
- package/lib/sdk/api/modules/ui/location.ui.d.ts +17 -0
- package/lib/sdk/api/modules/ui/post-call.ui.d.ts +25 -0
- package/lib/sdk/api/modules/ui/types.ui.d.ts +60 -0
- package/lib/sdk/api/modules/users.d.ts +4 -0
- package/lib/sdk/interfaces.d.ts +117 -0
- package/lib/sdk/main.d.ts +102 -6
- package/lib/sdk/payload.types.d.ts +132 -0
- package/lib/types/app.d.ts +11 -0
- package/lib/types/filter.d.ts +5 -0
- package/lib/types/instanceSettings.types.d.ts +8 -2
- package/lib/types/launchDarkly.types.d.ts +4 -4
- package/lib/types/organizationSettings.types.d.ts +4 -0
- package/lib/types/recentFiles.types.d.ts +4 -1
- package/lib/types/users.d.ts +13 -0
- package/lib/util/fullscreen.util.d.ts +1 -1
- package/lib/util/string.d.ts +1 -0
- package/package.json +1 -1
- package/types/openapi/index.d.ts +4 -5
- package/types/openapi/models/AccessTypeEnum.d.ts +3 -1
- package/types/openapi/models/Canvas.d.ts +1 -0
- package/types/openapi/models/CanvasCreate.d.ts +1 -0
- package/types/openapi/models/CanvasCreateRequest.d.ts +1 -0
- package/types/openapi/models/CanvasRetrieve.d.ts +1 -0
- package/types/openapi/models/CanvasUpdate.d.ts +1 -0
- package/types/openapi/models/CanvasUpdateRequest.d.ts +1 -0
- package/types/openapi/models/DeletedCanvas.d.ts +1 -0
- package/types/openapi/models/DeletedFolder.d.ts +3 -3
- package/types/openapi/models/Folder.d.ts +3 -3
- package/types/openapi/models/FolderCanvas.d.ts +11 -0
- package/types/openapi/models/FolderCreate.d.ts +7 -7
- package/types/openapi/models/FolderCreateRequest.d.ts +3 -2
- package/types/openapi/models/FolderFile.d.ts +2 -0
- package/types/openapi/models/FolderFolder.d.ts +4 -2
- package/types/openapi/models/FolderRetrieve.d.ts +7 -8
- package/types/openapi/models/FolderRule.d.ts +7 -0
- package/types/openapi/models/FolderRuleRequest.d.ts +7 -0
- package/types/openapi/models/FolderUpdate.d.ts +7 -8
- package/types/openapi/models/FolderUpdateRequest.d.ts +2 -0
- package/types/openapi/models/OperatorEnum.d.ts +64 -0
- package/types/openapi/models/PatchedCanvasUpdateRequest.d.ts +1 -0
- package/types/openapi/models/PatchedFolderUpdateRequest.d.ts +2 -0
- package/lib/apps/canvas-builder/util/tsUtils.d.ts +0 -3
- package/lib/composables/useDetailsView.d.ts +0 -19
- package/lib/types/templateActions.d.ts +0 -10
- package/lib/util/gesture.util.d.ts +0 -6
- package/types/openapi/models/FileRequest.d.ts +0 -16
- package/types/openapi/models/PSPDFKitAuthPayload.d.ts +0 -3
- package/types/openapi/models/PSPDFKitAuthPayloadRequest.d.ts +0 -3
- package/types/openapi/models/PSPDFKitToken.d.ts +0 -7
- package/types/openapi/models/PSPDFKitTokenRequest.d.ts +0 -3
package/lib/main.lib.d.ts
CHANGED
|
@@ -18,6 +18,7 @@ export { default as CDrawer } from './components/CDrawer/CDrawer.vue';
|
|
|
18
18
|
export { default as CDrawerContent } from './components/CDrawerContent/CDrawerContent.vue';
|
|
19
19
|
export { default as CDropdown } from './components/CDropdown/CDropdown.vue';
|
|
20
20
|
export { default as CErrorFullScreen } from './components/CError/CErrorFullScreen.vue';
|
|
21
|
+
export { default as CFileThumbnail } from './components/CFileThumbnail/CFileThumbnail.vue';
|
|
21
22
|
export { default as CIcon, type Props as CIconProps } from './components/CIcon/CIcon.vue';
|
|
22
23
|
export { default as CImage } from './components/CImage/CImage.vue';
|
|
23
24
|
export { default as CInput } from './components/CInput/CInput.vue';
|
|
@@ -89,6 +90,7 @@ export { default as CUserMenu } from './components/CUserMenu/CUserMenu.vue';
|
|
|
89
90
|
export { default as CList } from './components/CList/CList.vue';
|
|
90
91
|
export { default as CKnockNotificationsAppWrapper } from './components/CKnockNotificationsAppWrapper/CKnockNotificationsAppWrapper.vue';
|
|
91
92
|
export { default as CChip } from './components/CChip/CChip.vue';
|
|
93
|
+
export { default as CSettingsEditor } from './components/CSettingsEditor/CSettingsEditor.vue';
|
|
92
94
|
export { default as CanvasBuilderApp } from '@canvas-builder/App.vue';
|
|
93
95
|
export { type CanvasBuilderProps, CanvasBuilderMode } from '@canvas-builder/types/canvas';
|
|
94
96
|
export { default as Browser } from '@browser/App.vue';
|
|
@@ -100,44 +102,46 @@ export { default as useNotesApp } from '@notes/composables/useNotesApp';
|
|
|
100
102
|
export { default as useTheme } from './composables/useTheme';
|
|
101
103
|
export { default as useThemeVars } from './composables/useThemeVars';
|
|
102
104
|
export { default as useBindValidation } from './composables/useBindValidation';
|
|
105
|
+
export { default as useCanvasOverlay } from './composables/useCanvasOverlay';
|
|
103
106
|
export { default as useInfiniteScroll } from './composables/useInfiniteScroll';
|
|
104
107
|
export { default as useWindowEvents } from './composables/useWindowEvents';
|
|
105
|
-
export { default as useDetailsView } from './composables/useDetailsView';
|
|
106
108
|
export { default as useConfirmation } from './composables/useConfirmation';
|
|
107
109
|
export { default as useLocation } from './composables/useLocation';
|
|
108
110
|
export { default as useRecentFiles } from './composables/recentFiles.use';
|
|
109
111
|
export { default as useToast } from './composables/useToast';
|
|
112
|
+
export { default as useSuggestedTags } from './composables/suggestedTags.use';
|
|
110
113
|
export * from './plugins/vueQuery';
|
|
114
|
+
export * from './apps/canvas-builder/util/canvas.util';
|
|
115
|
+
export * from './apps/canvas-builder/util/tree';
|
|
116
|
+
export * from './components/filters/filter.util';
|
|
117
|
+
export * from './util/anchor';
|
|
111
118
|
export * from './util/array';
|
|
112
|
-
export * from './util/object';
|
|
113
|
-
export * from './util/userAgents';
|
|
114
|
-
export * from './util/image';
|
|
115
119
|
export * from './util/casing';
|
|
116
|
-
export * from './util/query';
|
|
117
|
-
export * from './util/reactive';
|
|
118
|
-
export * from './util/date';
|
|
119
|
-
export * from './util/number';
|
|
120
|
-
export * from './util/network';
|
|
121
|
-
export * from './util/tsHelpers';
|
|
122
120
|
export * from './util/color';
|
|
123
|
-
export * from './util/
|
|
121
|
+
export * from './util/date';
|
|
122
|
+
export * from './util/dev.util';
|
|
124
123
|
export * from './util/dom';
|
|
125
|
-
export * from './util/anchor';
|
|
126
|
-
export * from './util/translations';
|
|
127
|
-
export * from './util/message-event';
|
|
128
124
|
export * from './util/font.util';
|
|
129
|
-
export * from './util/timer';
|
|
130
|
-
export * from './components/filters/filter.util';
|
|
131
|
-
export * from './apps/canvas-builder/util/tree';
|
|
132
|
-
export * from './apps/canvas-builder/util/canvas.util';
|
|
133
|
-
export * from './util/navigation.util';
|
|
134
125
|
export * from './util/fullscreen.util';
|
|
126
|
+
export * from './util/image';
|
|
135
127
|
export * from './util/location.util';
|
|
136
|
-
export * from './util/
|
|
128
|
+
export * from './util/message-event';
|
|
129
|
+
export * from './util/navigation.util';
|
|
130
|
+
export * from './util/network';
|
|
131
|
+
export * from './util/number';
|
|
132
|
+
export * from './util/object';
|
|
133
|
+
export * from './util/query';
|
|
134
|
+
export * from './util/reactive';
|
|
135
|
+
export * from './util/timer';
|
|
136
|
+
export * from './util/translations';
|
|
137
|
+
export * from './util/tsHelpers';
|
|
138
|
+
export * from './util/user';
|
|
139
|
+
export * from './util/userAgents';
|
|
137
140
|
export * from './sdk/main';
|
|
138
141
|
export * from '../types/openapi';
|
|
139
142
|
export * from './components/CGlobalSearch/CGlobalSearch.types';
|
|
140
143
|
export * from './types/dataTable';
|
|
144
|
+
export * from './types/filter';
|
|
141
145
|
export * from './types/sfdc';
|
|
142
146
|
export * from './types/ts';
|
|
143
147
|
export * from './types/paginatedData';
|
|
@@ -159,6 +163,7 @@ export * from './types/call';
|
|
|
159
163
|
export * from './types/launchDarkly.types';
|
|
160
164
|
export * from './types/toast';
|
|
161
165
|
export * from './types/instanceSettings.types';
|
|
166
|
+
export * from './types/organizationSettings.types';
|
|
162
167
|
export * from './components/CConfigEditor/CConfigEditor.types';
|
|
163
168
|
export * from './constants/cdp.const';
|
|
164
169
|
export * from './constants/uploads.const';
|
|
@@ -167,6 +172,7 @@ export * from './constants/timers.const';
|
|
|
167
172
|
export * from './constants/url.const';
|
|
168
173
|
export * from './constants/conventions.const';
|
|
169
174
|
export * from './constants/config.const';
|
|
175
|
+
export * from './constants/pitcherSettings.const';
|
|
170
176
|
export * from './api/events/events.queries';
|
|
171
177
|
export * from './api/users/users.queries';
|
|
172
178
|
export * from './api/canvases/canvases.queries';
|
|
@@ -1,23 +1,116 @@
|
|
|
1
1
|
import { LowLevelApi } from './LowLevelApi';
|
|
2
2
|
import { PitcherEvent, ApiOptions } from '../interfaces';
|
|
3
3
|
import * as modules from '@sdk/api/modules';
|
|
4
|
+
/**
|
|
5
|
+
* Creates a high-level API instance and caches it. Reterns a new instance only if new options are provided.
|
|
6
|
+
*/
|
|
4
7
|
export declare function createHighLevelApi(options?: ApiOptions): {
|
|
8
|
+
/**
|
|
9
|
+
* Subscribe to a given event type by its key.
|
|
10
|
+
*
|
|
11
|
+
* @param {string} type - The event type to subscribe to.
|
|
12
|
+
* @param {(payload: PitcherEvent) => void} callback - The callback function to handle the event.
|
|
13
|
+
* @returns A Promise resolving to a cleanup function to unsubscribe from the event. * @example
|
|
14
|
+
*
|
|
15
|
+
* @example
|
|
16
|
+
* const unsubscribeFromSectionListUpdate = usePitcherApi().on('entered_fullscreen', (event: object) => {
|
|
17
|
+
* // handle event
|
|
18
|
+
* })
|
|
19
|
+
* // later
|
|
20
|
+
* unsubscribeFromSectionListUpdate()
|
|
21
|
+
*/
|
|
5
22
|
on: (type: string, callback: (payload: PitcherEvent) => void) => void;
|
|
23
|
+
/**
|
|
24
|
+
* Unsubscribe from a given event type by its key and the attached callback reference.
|
|
25
|
+
* @param {string} type - The event type to unsubscribe from.
|
|
26
|
+
* @param {(payload: PitcherEvent) => void} callback - The callback function reference to remove.
|
|
27
|
+
*
|
|
28
|
+
* @example
|
|
29
|
+
* const callback = (event: object) => {
|
|
30
|
+
* // handle event
|
|
31
|
+
* }
|
|
32
|
+
* usePitcherApi().on('entered_fullscreen', callback)
|
|
33
|
+
* // later
|
|
34
|
+
* usePitcherApi().off('entered_fullscreen', callback)
|
|
35
|
+
*/
|
|
6
36
|
off: (type: string, callback: (payload: PitcherEvent) => void) => void;
|
|
37
|
+
/**
|
|
38
|
+
* Make the entire CatalogIQ fullscreen.
|
|
39
|
+
*
|
|
40
|
+
* @example
|
|
41
|
+
* usePitcherApi().enterFullscreen()
|
|
42
|
+
*/
|
|
7
43
|
enterFullscreen: () => Promise<any>;
|
|
44
|
+
/**
|
|
45
|
+
* Exit fullscreen mode.
|
|
46
|
+
*
|
|
47
|
+
* @example
|
|
48
|
+
* usePitcherApi().exitFullscreen()
|
|
49
|
+
*/
|
|
8
50
|
exitFullscreen: () => Promise<any>;
|
|
51
|
+
/**
|
|
52
|
+
* Return is CatalogIQ in fullscreen.
|
|
53
|
+
*
|
|
54
|
+
* @example
|
|
55
|
+
* usePitcherApi().isFullscreen()
|
|
56
|
+
*/
|
|
57
|
+
isFullscreen: () => Promise<any>;
|
|
58
|
+
/**
|
|
59
|
+
* Log out the current user.
|
|
60
|
+
*
|
|
61
|
+
* @example
|
|
62
|
+
* usePitcherApi().logout()
|
|
63
|
+
*/
|
|
9
64
|
logout: () => Promise<any>;
|
|
65
|
+
/**
|
|
66
|
+
* Quit the current instance and go to the instance selection screen.
|
|
67
|
+
*
|
|
68
|
+
* @example
|
|
69
|
+
* usePitcherApi().quitInstance()
|
|
70
|
+
*/
|
|
10
71
|
quitInstance: () => Promise<any>;
|
|
72
|
+
/**
|
|
73
|
+
* Get the request types.
|
|
74
|
+
*
|
|
75
|
+
* @returns {Promise<any>}
|
|
76
|
+
*/
|
|
11
77
|
getRequestTypes: () => Promise<any>;
|
|
78
|
+
/**
|
|
79
|
+
* Broadcast an event to CatalogIQ.
|
|
80
|
+
* @param {PitcherEvent} event - The event to broadcast.
|
|
81
|
+
*
|
|
82
|
+
* @example
|
|
83
|
+
* usePitcherApi()
|
|
84
|
+
* .broadcast({
|
|
85
|
+
* type: "canvas_updated",
|
|
86
|
+
* body: { context: { myContextProperty: 'test' } },
|
|
87
|
+
* })
|
|
88
|
+
* .then(function (result) {
|
|
89
|
+
* useUi().toast({
|
|
90
|
+
* message: "Canvas Populated.",
|
|
91
|
+
* type: "info",
|
|
92
|
+
* })
|
|
93
|
+
* })
|
|
94
|
+
*/
|
|
12
95
|
broadcast: (event: PitcherEvent) => Promise<any>;
|
|
96
|
+
/**
|
|
97
|
+
* Subscribe to updates.
|
|
98
|
+
*
|
|
99
|
+
* @returns {Promise<void>}
|
|
100
|
+
*/
|
|
13
101
|
subscribe: () => Promise<any>;
|
|
102
|
+
/**
|
|
103
|
+
* Unsubscribe from updates.
|
|
104
|
+
*
|
|
105
|
+
* @returns {Promise<void>}
|
|
106
|
+
*/
|
|
14
107
|
unsubscribe: () => Promise<any>;
|
|
15
108
|
open(payload?: import('../payload.types').OpenRequestPayload): Promise<string>;
|
|
16
109
|
openExternalUrl(payload: import('../payload.types').OpenExternalUrlRequestPayload): Promise<void>;
|
|
17
110
|
getEnv(): Promise<import('../interfaces').PitcherEnv>;
|
|
18
111
|
updateMyUser(payload: {
|
|
19
|
-
language?: import('../../main.lib').LanguageEnum;
|
|
20
|
-
dark_mode?: boolean;
|
|
112
|
+
language?: import('../../main.lib').LanguageEnum | undefined;
|
|
113
|
+
dark_mode?: boolean | undefined;
|
|
21
114
|
}): Promise<import('../../main.lib').User>;
|
|
22
115
|
getLanguages(): Promise<modules.Language[]>;
|
|
23
116
|
getEvents(payload: Partial<import('../../main.lib').EventRequest>): Promise<import('../../main.lib').PaginatedData<import('../../main.lib').Event>>;
|
|
@@ -5,17 +5,16 @@ import { PaginatedData } from '../../../../types/paginatedData';
|
|
|
5
5
|
/**
|
|
6
6
|
* Creates a new canvas.
|
|
7
7
|
*
|
|
8
|
-
*
|
|
8
|
+
* @example
|
|
9
9
|
* adminApi.createCanvas({
|
|
10
10
|
* name: 'my new canvas';
|
|
11
11
|
* })
|
|
12
|
-
* ```
|
|
13
12
|
*/
|
|
14
13
|
export declare function createCanvas(payload: CanvasCreateRequest): Promise<CanvasRetrieve>;
|
|
15
14
|
/**
|
|
16
15
|
* Fetches a list of canvases to use in your app.
|
|
17
16
|
*
|
|
18
|
-
*
|
|
17
|
+
* @example
|
|
19
18
|
* // The `filters` object is a reserved payload key to transfer the metadata dict over the wire.
|
|
20
19
|
* adminApi.getCanvases({
|
|
21
20
|
* search: 'my search query',
|
|
@@ -26,7 +25,6 @@ export declare function createCanvas(payload: CanvasCreateRequest): Promise<Canv
|
|
|
26
25
|
* },
|
|
27
26
|
* fields: 'id,name,metadata',
|
|
28
27
|
* })
|
|
29
|
-
* ```
|
|
30
28
|
*/
|
|
31
29
|
export declare function getCanvases(payload: GetCanvasesParams & {
|
|
32
30
|
filters?: Record<string, any>;
|
|
@@ -35,12 +33,11 @@ export declare function getCanvases(payload: GetCanvasesParams & {
|
|
|
35
33
|
/**
|
|
36
34
|
* Fetches a canvas by id with the defined fields or all of them.
|
|
37
35
|
*
|
|
38
|
-
*
|
|
36
|
+
* @example
|
|
39
37
|
* // The `filters` object is a reserved payload key to transfer the metadata dict over the wire.
|
|
40
38
|
* adminApi.getCanvas({
|
|
41
39
|
* fields: 'id,name,metadata',
|
|
42
40
|
* })
|
|
43
|
-
* ```
|
|
44
41
|
*/
|
|
45
42
|
export declare function getCanvas(payload: {
|
|
46
43
|
id: CanvasRetrieve['id'];
|
|
@@ -49,7 +46,7 @@ export declare function getCanvas(payload: {
|
|
|
49
46
|
/**
|
|
50
47
|
* Updates a canvas by ID and returns the defined fields or all of them.
|
|
51
48
|
*
|
|
52
|
-
*
|
|
49
|
+
* @example
|
|
53
50
|
* // The fields param is appended to the URL as a query param.
|
|
54
51
|
* onMounted(() => {
|
|
55
52
|
* adminApi.updateCanvas({
|
|
@@ -60,10 +57,29 @@ export declare function getCanvas(payload: {
|
|
|
60
57
|
* console.log(res) // logs: { id: '01HH4RCBH631K4JDHWAQB0RPR6', name: 'To 3!' }
|
|
61
58
|
* })
|
|
62
59
|
* })
|
|
63
|
-
* ```
|
|
64
60
|
*/
|
|
65
61
|
export declare function updateCanvas(payload: PatchedCanvasUpdateRequest & {
|
|
66
62
|
id: CanvasRetrieve['id'];
|
|
67
63
|
instance_id?: Instance['id'];
|
|
68
64
|
fields?: string;
|
|
69
65
|
}): Promise<CanvasRetrieve>;
|
|
66
|
+
/**
|
|
67
|
+
* Opens a modal to view a canvas by ID.
|
|
68
|
+
*
|
|
69
|
+
* ```
|
|
70
|
+
* onMounted(() => {
|
|
71
|
+
* adminApi.openCanvasOverlay({
|
|
72
|
+
* id: '01HH4RCBH631K4JDHWAQB0RPR6',
|
|
73
|
+
* edit_mode: false,
|
|
74
|
+
* fullscreen: true,
|
|
75
|
+
* })
|
|
76
|
+
* })
|
|
77
|
+
* ```
|
|
78
|
+
*/
|
|
79
|
+
export declare function openCanvasOverlay(payload: {
|
|
80
|
+
id: CanvasRetrieve['id'];
|
|
81
|
+
edit_mode?: boolean;
|
|
82
|
+
fullscreen?: boolean;
|
|
83
|
+
component_id?: string;
|
|
84
|
+
section_id?: string;
|
|
85
|
+
}): Promise<void>;
|
|
@@ -3,8 +3,9 @@ import { AdminEnv } from './types.admin';
|
|
|
3
3
|
/**
|
|
4
4
|
* Fetches the necessary info for the app to know where it is embedded.
|
|
5
5
|
*
|
|
6
|
-
*
|
|
6
|
+
* Check out [usePitcherApi().getEnv()](../internal/functions/createHighLevelApi.md#getenv) for more information.
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
7
9
|
* adminApi.getEnv()
|
|
8
|
-
* ```
|
|
9
10
|
*/
|
|
10
11
|
export declare function getEnv(): Promise<AdminEnv>;
|
|
@@ -2,11 +2,13 @@ import { AdminSelectContentRequest, AdminSelectContentResponse } from './types.a
|
|
|
2
2
|
import { File, PaginatedFileList } from '../../../../../types/openapi';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
|
-
*
|
|
5
|
+
* Get the metadata object of an app with a given name.
|
|
6
6
|
*
|
|
7
|
-
*
|
|
8
|
-
*
|
|
9
|
-
*
|
|
7
|
+
* @param {object} payload - The payload object.
|
|
8
|
+
* @param {string} payload.app_name - `name` value from `app.json` of the app you want to get the metadata of.
|
|
9
|
+
*
|
|
10
|
+
* @example
|
|
11
|
+
* useAdmin().getAppConfig({ app_name: 'my-app' })
|
|
10
12
|
*/
|
|
11
13
|
export declare function getAppConfig(payload: {
|
|
12
14
|
app_name: string;
|
|
@@ -14,9 +16,8 @@ export declare function getAppConfig(payload: {
|
|
|
14
16
|
/**
|
|
15
17
|
* Fetches a file by ID.
|
|
16
18
|
*
|
|
17
|
-
*
|
|
19
|
+
* @example
|
|
18
20
|
* adminApi.getFile({ id: 'my-file-id' })
|
|
19
|
-
* ```
|
|
20
21
|
*/
|
|
21
22
|
export declare function getFile(payload: {
|
|
22
23
|
id: File['id'];
|
|
@@ -24,14 +25,14 @@ export declare function getFile(payload: {
|
|
|
24
25
|
/**
|
|
25
26
|
* Lists available files.
|
|
26
27
|
*
|
|
27
|
-
*
|
|
28
|
+
* @example
|
|
28
29
|
* adminApi.getFiles()
|
|
29
|
-
* ```
|
|
30
30
|
*/
|
|
31
31
|
export declare function getFiles(payload: Record<string, any>): Promise<PaginatedFileList>;
|
|
32
32
|
/**
|
|
33
33
|
* Opens a selector that allows you to select (and preselect) from your Pitcher uploaded content.
|
|
34
|
-
*
|
|
34
|
+
*
|
|
35
|
+
* @example
|
|
35
36
|
* const api = useApi() // or useAdmin() if you know that you 're in Admin app context
|
|
36
37
|
* api
|
|
37
38
|
* .select_content({
|
|
@@ -44,6 +45,5 @@ export declare function getFiles(payload: Record<string, any>): Promise<Paginate
|
|
|
44
45
|
* },
|
|
45
46
|
* ],
|
|
46
47
|
* })
|
|
47
|
-
* ```
|
|
48
48
|
*/
|
|
49
49
|
export declare function selectContent(payload: AdminSelectContentRequest): Promise<AdminSelectContentResponse>;
|
|
@@ -1,6 +1,19 @@
|
|
|
1
1
|
import { AdminToastRequest, ADMIN_MESSAGE_TYPES, AdminMessagePayloads } from './types.admin';
|
|
2
2
|
|
|
3
|
+
/**
|
|
4
|
+
* Subscribe to a given event type by its key.
|
|
5
|
+
*
|
|
6
|
+
* @param type The event type/key to subscribe to.
|
|
7
|
+
* @param handler The handler function to call when the event is emitted.
|
|
8
|
+
* @returns A Promise resolving to a cleanup function to unsubscribe from the event.
|
|
9
|
+
*/
|
|
3
10
|
declare function on(type: (typeof ADMIN_MESSAGE_TYPES)[keyof typeof ADMIN_MESSAGE_TYPES], handler: (data: AdminMessagePayloads[typeof type]) => Promise<void>): Promise<() => void>;
|
|
11
|
+
/**
|
|
12
|
+
* Show a toast message to the user. Compatible with the UI API version of this method.
|
|
13
|
+
*
|
|
14
|
+
* @example
|
|
15
|
+
* useAdmin().toast({ type: 'info', message: 'Hello, world!' })
|
|
16
|
+
*/
|
|
4
17
|
declare function toast(payload: AdminToastRequest): Promise<void>;
|
|
5
18
|
declare const _default: {
|
|
6
19
|
getAppConfig(payload: {
|
|
@@ -26,6 +39,13 @@ declare const _default: {
|
|
|
26
39
|
instance_id?: import('../../../../main.lib').Instance["id"];
|
|
27
40
|
fields?: string;
|
|
28
41
|
}): Promise<import('../../../../main.lib').CanvasRetrieve>;
|
|
42
|
+
openCanvasOverlay(payload: {
|
|
43
|
+
id: import('../../../../main.lib').CanvasRetrieve["id"];
|
|
44
|
+
edit_mode?: boolean;
|
|
45
|
+
fullscreen?: boolean;
|
|
46
|
+
component_id?: string;
|
|
47
|
+
section_id?: string;
|
|
48
|
+
}): Promise<void>;
|
|
29
49
|
getEnv(): Promise<import('./types.admin').AdminEnv>;
|
|
30
50
|
on: typeof on;
|
|
31
51
|
toast: typeof toast;
|
|
@@ -4,8 +4,7 @@ import { GetInstanceMetadataTemplatesPayload } from '../../../payload.types';
|
|
|
4
4
|
/**
|
|
5
5
|
* Fetches a list of metadata templates to use in your app. Instance is auto-injected by admin app if in instance scope.
|
|
6
6
|
*
|
|
7
|
-
*
|
|
7
|
+
* @example
|
|
8
8
|
* adminApi.getInstanceMetadataTemplates()
|
|
9
|
-
* ```
|
|
10
9
|
**/
|
|
11
10
|
export declare function getInstanceMetadataTemplates(payload?: GetInstanceMetadataTemplatesPayload): Promise<PaginatedMetadataTemplateList>;
|
|
@@ -14,6 +14,7 @@ export declare const ADMIN_API_METHOD_TYPES: {
|
|
|
14
14
|
readonly GET_APP_CONFIG: "admin_get_app_config";
|
|
15
15
|
readonly GET_CANVAS: "admin_get_canvas";
|
|
16
16
|
readonly GET_CANVASES: "admin_get_canvases";
|
|
17
|
+
readonly OPEN_CANVAS_OVERLAY: "admin_open_canvas_overlay";
|
|
17
18
|
readonly GET_ENV: "admin_get_env";
|
|
18
19
|
readonly GET_FILE: "admin_get_file";
|
|
19
20
|
readonly GET_FILES: "admin_get_files";
|
|
@@ -25,42 +26,135 @@ export declare const ADMIN_API_METHOD_TYPES: {
|
|
|
25
26
|
export type AdminMessagePayloads = {
|
|
26
27
|
[ADMIN_MESSAGE_TYPES.ENV_CHANGED]: AdminEnv;
|
|
27
28
|
};
|
|
29
|
+
/**
|
|
30
|
+
* Represents an admin request with a specific payload.
|
|
31
|
+
* @template Payload - The type of the payload data.
|
|
32
|
+
*/
|
|
28
33
|
export type AdminRequest<Payload = any> = {
|
|
34
|
+
/**
|
|
35
|
+
* Unique identifier for the request.
|
|
36
|
+
*/
|
|
29
37
|
id: string;
|
|
38
|
+
/**
|
|
39
|
+
* Type of the admin API request.
|
|
40
|
+
*/
|
|
30
41
|
type: (typeof ADMIN_API_TYPES)['ADMIN_REQUEST'];
|
|
42
|
+
/**
|
|
43
|
+
* Body of the request containing the method type and payload data.
|
|
44
|
+
*/
|
|
31
45
|
body: {
|
|
46
|
+
/**
|
|
47
|
+
* Type of the admin API method.
|
|
48
|
+
*/
|
|
32
49
|
type: (typeof ADMIN_API_METHOD_TYPES)[keyof typeof ADMIN_API_METHOD_TYPES];
|
|
50
|
+
/**
|
|
51
|
+
* Payload data for the request.
|
|
52
|
+
*/
|
|
33
53
|
data: Payload;
|
|
34
54
|
};
|
|
35
55
|
};
|
|
56
|
+
/**
|
|
57
|
+
* Represents a request to show a toast notification.
|
|
58
|
+
*/
|
|
36
59
|
export interface AdminToastRequest {
|
|
60
|
+
/**
|
|
61
|
+
* Type of the toast notification.
|
|
62
|
+
*/
|
|
37
63
|
type: 'info' | 'error' | 'warning' | 'success' | 'loading';
|
|
64
|
+
/**
|
|
65
|
+
* Message to be displayed in the toast.
|
|
66
|
+
*/
|
|
38
67
|
message: string;
|
|
68
|
+
/**
|
|
69
|
+
* Duration for which the toast should be displayed (optional).
|
|
70
|
+
*/
|
|
39
71
|
duration?: number;
|
|
72
|
+
/**
|
|
73
|
+
* Indicates if the toast can be closed manually (optional).
|
|
74
|
+
*/
|
|
40
75
|
closable?: boolean;
|
|
76
|
+
/**
|
|
77
|
+
* Indicates if the toast should remain visible when hovered over (optional).
|
|
78
|
+
*/
|
|
41
79
|
keepAliveOnHover?: boolean;
|
|
80
|
+
/**
|
|
81
|
+
* Indicates if an icon should be shown in the toast (optional).
|
|
82
|
+
*/
|
|
42
83
|
showIcon?: boolean;
|
|
43
84
|
}
|
|
85
|
+
/**
|
|
86
|
+
* Represents a request to select content.
|
|
87
|
+
*/
|
|
44
88
|
export type AdminSelectContentRequest = {
|
|
89
|
+
/**
|
|
90
|
+
* List of selections to be made (optional).
|
|
91
|
+
*/
|
|
45
92
|
selections?: Selection[];
|
|
46
93
|
};
|
|
94
|
+
/**
|
|
95
|
+
* Represents a response to a content selection request.
|
|
96
|
+
*/
|
|
47
97
|
export type AdminSelectContentResponse = {
|
|
98
|
+
/**
|
|
99
|
+
* Action taken by the user.
|
|
100
|
+
*/
|
|
48
101
|
user_action: 'cancelled' | 'selected';
|
|
102
|
+
/**
|
|
103
|
+
* Selected content, if any.
|
|
104
|
+
*/
|
|
49
105
|
content?: (ContentSelectorSelectedFile | ContentSelectorSelectedPage)[];
|
|
50
106
|
};
|
|
107
|
+
/**
|
|
108
|
+
* Represents an admin response with a specific payload.
|
|
109
|
+
* @template Response - The type of the response data.
|
|
110
|
+
*/
|
|
51
111
|
export type AdminResponse<Response = any> = {
|
|
112
|
+
/**
|
|
113
|
+
* Unique identifier for the response.
|
|
114
|
+
*/
|
|
52
115
|
id: string;
|
|
116
|
+
/**
|
|
117
|
+
* Type of the admin API response.
|
|
118
|
+
*/
|
|
53
119
|
type: (typeof ADMIN_API_TYPES)['ADMIN_RESPONSE'];
|
|
120
|
+
/**
|
|
121
|
+
* Body of the response containing the response data.
|
|
122
|
+
*/
|
|
54
123
|
body: Response;
|
|
55
124
|
};
|
|
125
|
+
/**
|
|
126
|
+
* Represents an admin message with a specific payload.
|
|
127
|
+
* @template Payload - The type of the message data.
|
|
128
|
+
*/
|
|
56
129
|
export type AdminMessage<Payload = any> = {
|
|
130
|
+
/**
|
|
131
|
+
* Unique identifier for the message.
|
|
132
|
+
*/
|
|
57
133
|
id: string;
|
|
134
|
+
/**
|
|
135
|
+
* Type of the admin message.
|
|
136
|
+
*/
|
|
58
137
|
type: typeof ADMIN_MESSAGE;
|
|
138
|
+
/**
|
|
139
|
+
* Body of the message containing the message type and payload data.
|
|
140
|
+
*/
|
|
59
141
|
body: {
|
|
142
|
+
/**
|
|
143
|
+
* Type of the admin message.
|
|
144
|
+
*/
|
|
60
145
|
type: (typeof ADMIN_MESSAGE_TYPES)[keyof typeof ADMIN_MESSAGE_TYPES];
|
|
146
|
+
/**
|
|
147
|
+
* Payload data for the message.
|
|
148
|
+
*/
|
|
61
149
|
data: Payload;
|
|
62
150
|
};
|
|
63
151
|
};
|
|
152
|
+
/**
|
|
153
|
+
* Represents the admin environment.
|
|
154
|
+
*/
|
|
64
155
|
export type AdminEnv = {
|
|
156
|
+
/**
|
|
157
|
+
* Pitcher environment settings.
|
|
158
|
+
*/
|
|
65
159
|
pitcher: PitcherEnv['pitcher'];
|
|
66
160
|
};
|
|
@@ -5,7 +5,7 @@ import { PaginatedData } from '../../../types/paginatedData';
|
|
|
5
5
|
/**
|
|
6
6
|
* Fetches a list of canvases to use in your app.
|
|
7
7
|
*
|
|
8
|
-
*
|
|
8
|
+
* @example
|
|
9
9
|
* // The `filters` object is a reserved payload key to transfer the metadata dict over the wire.
|
|
10
10
|
* api.getCanvases({
|
|
11
11
|
* search: 'my search query',
|
|
@@ -16,7 +16,6 @@ import { PaginatedData } from '../../../types/paginatedData';
|
|
|
16
16
|
* },
|
|
17
17
|
* fields: 'id,name,metadata',
|
|
18
18
|
* })
|
|
19
|
-
* ```
|
|
20
19
|
*/
|
|
21
20
|
export declare function getCanvases(payload: GetCanvasesParams & {
|
|
22
21
|
filters?: Record<string, any>;
|
|
@@ -29,7 +28,7 @@ export declare function deleteCanvas(payload: {
|
|
|
29
28
|
/**
|
|
30
29
|
* Updates a canvas by ID
|
|
31
30
|
*
|
|
32
|
-
*
|
|
31
|
+
* @example
|
|
33
32
|
* // The fields param is appended to the URL as a query param.
|
|
34
33
|
* onMounted(() => {
|
|
35
34
|
* PitcherAPI.updateCanvas({
|
|
@@ -40,7 +39,6 @@ export declare function deleteCanvas(payload: {
|
|
|
40
39
|
* console.log(res) // logs: { id: '01HH4RCBH631K4JDHWAQB0RPR6', name: 'To 3!' }
|
|
41
40
|
* })
|
|
42
41
|
* })
|
|
43
|
-
* ```
|
|
44
42
|
*/
|
|
45
43
|
export declare function updateCanvas(payload: PatchedCanvasUpdateRequest & {
|
|
46
44
|
id: CanvasRetrieve['id'];
|
|
@@ -1,10 +1,11 @@
|
|
|
1
1
|
import { DsrEnv } from './types.dsr';
|
|
2
2
|
|
|
3
3
|
/**
|
|
4
|
-
* Fetches the necessary info for the app to know where it is embedded.
|
|
4
|
+
* Fetches the necessary info for the app to know where it is embedded.
|
|
5
5
|
*
|
|
6
|
-
*
|
|
6
|
+
* Check out [usePitcherApi().getEnv()](../internal/functions/createHighLevelApi.md#getenv) for more information.
|
|
7
|
+
*
|
|
8
|
+
* @example
|
|
7
9
|
* useDsr().getEnv()
|
|
8
|
-
* ```
|
|
9
10
|
*/
|
|
10
11
|
export declare function getEnv(): Promise<DsrEnv>;
|
|
@@ -1,5 +1,12 @@
|
|
|
1
1
|
import { DSR_MESSAGE_TYPES, DsrMessagePayloads } from './types.dsr';
|
|
2
2
|
|
|
3
|
+
/**
|
|
4
|
+
* Subscribe to a given event type by its key.
|
|
5
|
+
*
|
|
6
|
+
* @param type The event type/key to subscribe to.
|
|
7
|
+
* @param handler The handler function to call when the event is emitted.
|
|
8
|
+
* @returns A Promise resolving to a cleanup function to unsubscribe from the event.
|
|
9
|
+
*/
|
|
3
10
|
declare function on(type: (typeof DSR_MESSAGE_TYPES)[keyof typeof DSR_MESSAGE_TYPES], handler: (data: DsrMessagePayloads[typeof type]) => Promise<void>): Promise<() => void>;
|
|
4
11
|
declare const _default: {
|
|
5
12
|
embeddable_ready(): Promise<void>;
|
|
@@ -1,6 +1,22 @@
|
|
|
1
1
|
import { PitcherEnv } from '../../interfaces';
|
|
2
2
|
import { User } from '../../../../types/openapi';
|
|
3
3
|
|
|
4
|
+
/**
|
|
5
|
+
* Fetches the necessary info for the app to know where it is embedded.
|
|
6
|
+
*
|
|
7
|
+
* It contains information about:
|
|
8
|
+
* - user
|
|
9
|
+
* - instance
|
|
10
|
+
* - organization
|
|
11
|
+
* - security token to query Pitcher REST API
|
|
12
|
+
* - Salesforce connection information (if connected) including security token to query Salesforce REST API
|
|
13
|
+
* - Auth0 token information
|
|
14
|
+
*
|
|
15
|
+
* @example
|
|
16
|
+
* const env = usePitcherApi().getEnv().then((env) => {
|
|
17
|
+
* console.log(env.pitcher.user.name)
|
|
18
|
+
* })
|
|
19
|
+
*/
|
|
4
20
|
export declare function getEnv(): Promise<PitcherEnv>;
|
|
5
21
|
type UpdateEnvParams = Pick<User, 'language' | 'dark_mode'>;
|
|
6
22
|
export declare function updateMyUser(payload: UpdateEnvParams): Promise<User>;
|
|
@@ -1,8 +1,17 @@
|
|
|
1
1
|
import { Favorite, FavoriteCreateRequest, PaginatedFavoriteList } from '../../../../types/openapi';
|
|
2
2
|
import { GetFavoritesParams } from '../../../types/favorites';
|
|
3
3
|
|
|
4
|
+
/**
|
|
5
|
+
* Get a list of favorites
|
|
6
|
+
*/
|
|
4
7
|
export declare function getFavorites(payload?: GetFavoritesParams): Promise<PaginatedFavoriteList>;
|
|
8
|
+
/**
|
|
9
|
+
* Create a favorite
|
|
10
|
+
*/
|
|
5
11
|
export declare function createFavorite(payload: FavoriteCreateRequest): Promise<Favorite>;
|
|
12
|
+
/**
|
|
13
|
+
* Delete a favorite
|
|
14
|
+
*/
|
|
6
15
|
export declare function deleteFavorite(payload: {
|
|
7
16
|
favorite_id: Favorite['id'];
|
|
8
17
|
}): Promise<void>;
|