@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.
Files changed (101) hide show
  1. package/js-api.esm.js +111 -6
  2. package/js-api.esm.js.map +1 -1
  3. package/js-api.umd.min.js +10 -10
  4. package/js-api.umd.min.js.map +1 -1
  5. package/lib/apps/browser/stores/api.d.ts +164 -104
  6. package/lib/apps/browser/stores/app.d.ts +6 -1
  7. package/lib/apps/browser/stores/upload.d.ts +30 -30
  8. package/lib/apps/canvas-builder/composables/useCanvas.d.ts +508 -421
  9. package/lib/apps/canvas-builder/composables/useCanvasHistory.d.ts +86 -74
  10. package/lib/apps/canvas-builder/composables/useCanvasTheme.d.ts +18 -20
  11. package/lib/apps/canvas-builder/composables/useContentSelector.d.ts +5 -5
  12. package/lib/apps/canvas-builder/composables/useInstalledEmbeddables.d.ts +4 -1
  13. package/lib/apps/canvas-builder/types/canvas.d.ts +1 -0
  14. package/lib/apps/canvas-builder/util/canvas.util.d.ts +1 -0
  15. package/lib/apps/content-selector/stores/app.d.ts +8 -1
  16. package/lib/components/CFileViewer/CFileViewer.use.d.ts +2 -4
  17. package/lib/components/CFileViewer/CFileViewerFullScreen.use.d.ts +1 -1
  18. package/lib/components/filters/filter.util.d.ts +1 -1
  19. package/lib/composables/instanceTagsActions.use.d.ts +14 -0
  20. package/lib/composables/recentFiles.use.d.ts +1 -1
  21. package/lib/composables/suggestedTags.use.d.ts +3 -0
  22. package/lib/composables/tableColumnsSettings.use.d.ts +25 -0
  23. package/lib/composables/useCanvasOverlay.d.ts +20 -0
  24. package/lib/composables/useConfirmation.d.ts +1 -0
  25. package/lib/composables/useElementHeightResize.d.ts +5 -0
  26. package/lib/composables/useFiles.d.ts +11 -0
  27. package/lib/constants/pitcherSettings.const.d.ts +4 -0
  28. package/lib/main.lib.d.ts +26 -20
  29. package/lib/sdk/api/HighLevelApi.d.ts +95 -2
  30. package/lib/sdk/api/modules/admin/canvas.admin.d.ts +24 -8
  31. package/lib/sdk/api/modules/admin/env.admin.d.ts +3 -2
  32. package/lib/sdk/api/modules/admin/files.admin.d.ts +10 -10
  33. package/lib/sdk/api/modules/admin/index.d.ts +20 -0
  34. package/lib/sdk/api/modules/admin/metadataTemplates.admin.d.ts +1 -2
  35. package/lib/sdk/api/modules/admin/types.admin.d.ts +94 -0
  36. package/lib/sdk/api/modules/canvas.d.ts +2 -4
  37. package/lib/sdk/api/modules/dsr/env.dsr.d.ts +4 -3
  38. package/lib/sdk/api/modules/dsr/index.d.ts +7 -0
  39. package/lib/sdk/api/modules/dsr/loading.dsr.d.ts +6 -0
  40. package/lib/sdk/api/modules/env.d.ts +16 -0
  41. package/lib/sdk/api/modules/favorites.d.ts +9 -0
  42. package/lib/sdk/api/modules/feedback.d.ts +3 -0
  43. package/lib/sdk/api/modules/files.d.ts +1 -2
  44. package/lib/sdk/api/modules/folders.d.ts +29 -0
  45. package/lib/sdk/api/modules/open.d.ts +6 -0
  46. package/lib/sdk/api/modules/sync.d.ts +1 -2
  47. package/lib/sdk/api/modules/ui/app-errors.ui.d.ts +12 -0
  48. package/lib/sdk/api/modules/ui/canvas.ui.d.ts +73 -0
  49. package/lib/sdk/api/modules/ui/content.ui.d.ts +36 -3
  50. package/lib/sdk/api/modules/ui/index.d.ts +114 -0
  51. package/lib/sdk/api/modules/ui/loading.ui.d.ts +15 -0
  52. package/lib/sdk/api/modules/ui/location.ui.d.ts +17 -0
  53. package/lib/sdk/api/modules/ui/post-call.ui.d.ts +25 -0
  54. package/lib/sdk/api/modules/ui/types.ui.d.ts +60 -0
  55. package/lib/sdk/api/modules/users.d.ts +4 -0
  56. package/lib/sdk/interfaces.d.ts +117 -0
  57. package/lib/sdk/main.d.ts +102 -6
  58. package/lib/sdk/payload.types.d.ts +132 -0
  59. package/lib/types/app.d.ts +11 -0
  60. package/lib/types/filter.d.ts +5 -0
  61. package/lib/types/instanceSettings.types.d.ts +8 -2
  62. package/lib/types/launchDarkly.types.d.ts +4 -4
  63. package/lib/types/organizationSettings.types.d.ts +4 -0
  64. package/lib/types/recentFiles.types.d.ts +4 -1
  65. package/lib/types/users.d.ts +13 -0
  66. package/lib/util/fullscreen.util.d.ts +1 -1
  67. package/lib/util/string.d.ts +1 -0
  68. package/package.json +1 -1
  69. package/types/openapi/index.d.ts +4 -5
  70. package/types/openapi/models/AccessTypeEnum.d.ts +3 -1
  71. package/types/openapi/models/Canvas.d.ts +1 -0
  72. package/types/openapi/models/CanvasCreate.d.ts +1 -0
  73. package/types/openapi/models/CanvasCreateRequest.d.ts +1 -0
  74. package/types/openapi/models/CanvasRetrieve.d.ts +1 -0
  75. package/types/openapi/models/CanvasUpdate.d.ts +1 -0
  76. package/types/openapi/models/CanvasUpdateRequest.d.ts +1 -0
  77. package/types/openapi/models/DeletedCanvas.d.ts +1 -0
  78. package/types/openapi/models/DeletedFolder.d.ts +3 -3
  79. package/types/openapi/models/Folder.d.ts +3 -3
  80. package/types/openapi/models/FolderCanvas.d.ts +11 -0
  81. package/types/openapi/models/FolderCreate.d.ts +7 -7
  82. package/types/openapi/models/FolderCreateRequest.d.ts +3 -2
  83. package/types/openapi/models/FolderFile.d.ts +2 -0
  84. package/types/openapi/models/FolderFolder.d.ts +4 -2
  85. package/types/openapi/models/FolderRetrieve.d.ts +7 -8
  86. package/types/openapi/models/FolderRule.d.ts +7 -0
  87. package/types/openapi/models/FolderRuleRequest.d.ts +7 -0
  88. package/types/openapi/models/FolderUpdate.d.ts +7 -8
  89. package/types/openapi/models/FolderUpdateRequest.d.ts +2 -0
  90. package/types/openapi/models/OperatorEnum.d.ts +64 -0
  91. package/types/openapi/models/PatchedCanvasUpdateRequest.d.ts +1 -0
  92. package/types/openapi/models/PatchedFolderUpdateRequest.d.ts +2 -0
  93. package/lib/apps/canvas-builder/util/tsUtils.d.ts +0 -3
  94. package/lib/composables/useDetailsView.d.ts +0 -19
  95. package/lib/types/templateActions.d.ts +0 -10
  96. package/lib/util/gesture.util.d.ts +0 -6
  97. package/types/openapi/models/FileRequest.d.ts +0 -16
  98. package/types/openapi/models/PSPDFKitAuthPayload.d.ts +0 -3
  99. package/types/openapi/models/PSPDFKitAuthPayloadRequest.d.ts +0 -3
  100. package/types/openapi/models/PSPDFKitToken.d.ts +0 -7
  101. 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/user';
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/dev.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
- * Fetches the config values for an installed app by its name.
5
+ * Get the metadata object of an app with a given name.
6
6
  *
7
- * ```
8
- * adminApi.getAppConfig({ app_name: 'my-app' })
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. LaunchDarkly flags are omitted for now as they are not yet used.
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 +1,7 @@
1
+ /**
2
+ * Signal to DSR that the app is ready to be shown.
3
+ *
4
+ * @example
5
+ * useDsr().embeddable_ready()
6
+ */
1
7
  export declare function 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>;
@@ -1,3 +1,6 @@
1
1
  import { SubmitUserFeedbackPayload } from '../../payload.types';
2
2
 
3
+ /**
4
+ * Submit user feedback
5
+ */
3
6
  export declare function submitUserFeedback(payload: SubmitUserFeedbackPayload): Promise<any>;