@pitcher/js-api 1.22.0-alpha.5 → 1.22.0-beta.0

package/lib/sdk/api/modules/dsr/env.dsr.d.ts

@@ -1,10 +1,11 @@
 import { DsrEnv } from './types.dsr';
 
 /**
- * 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.
+ * Fetches the necessary info for the app to know where it is embedded.
  *
- * ```
+ * Check out [usePitcherApi().getEnv()](../internal/functions/createHighLevelApi.md#getenv) for more information.
+ *
+ * @example
  * useDsr().getEnv()
- * ```
  */
 export declare function getEnv(): Promise<DsrEnv>;

package/lib/sdk/api/modules/dsr/index.d.ts

@@ -1,5 +1,16 @@
 import { DSR_MESSAGE_TYPES, DsrMessagePayloads } from './types.dsr';
 
-export declare function on(type: (typeof DSR_MESSAGE_TYPES)[keyof typeof DSR_MESSAGE_TYPES], handler: (data: DsrMessagePayloads[typeof type]) => Promise<void>): Promise<() => void>;
-export * from './env.dsr';
-export * from './loading.dsr';
+/**
+ * Subscribe to a given event type by its key.
+ *
+ * @param type The event type/key to subscribe to.
+ * @param handler The handler function to call when the event is emitted.
+ * @returns A Promise resolving to a cleanup function to unsubscribe from the event.
+ */
+declare function on(type: (typeof DSR_MESSAGE_TYPES)[keyof typeof DSR_MESSAGE_TYPES], handler: (data: DsrMessagePayloads[typeof type]) => Promise<void>): Promise<() => void>;
+declare const _default: {
+    embeddableReady(): Promise<void>;
+    getEnv(): Promise<import('./types.dsr').DsrEnv>;
+    on: typeof on;
+};
+export default _default;

package/lib/sdk/api/modules/dsr/loading.dsr.d.ts

@@ -1 +1,7 @@
-export declare function embeddable_ready(): Promise<void>;
+/**
+ * Signal to DSR that the app is ready to be shown.
+ *
+ * @example
+ * useDsr().embeddableReady()
+ */
+export declare function embeddableReady(): Promise<void>;

package/lib/sdk/api/modules/env.d.ts

@@ -1,6 +1,22 @@
 import { PitcherEnv } from '../../interfaces';
 import { User } from '../../../../types/openapi';
 
+/**
+ * Fetches the necessary info for the app to know where it is embedded.
+ *
+ * It contains information about:
+ * - user
+ * - instance
+ * - organization
+ * - security token to query Pitcher REST API
+ * - Salesforce connection information (if connected) including security token to query Salesforce REST API
+ * - Auth0 token information
+ *
+ * @example
+ * const env = usePitcherApi().getEnv().then((env) => {
+ *   console.log(env.pitcher.user.name)
+ * })
+ */
 export declare function getEnv(): Promise<PitcherEnv>;
 type UpdateEnvParams = Pick<User, 'language' | 'dark_mode'>;
 export declare function updateMyUser(payload: UpdateEnvParams): Promise<User>;

package/lib/sdk/api/modules/favorites.d.ts

@@ -1,8 +1,17 @@
 import { Favorite, FavoriteCreateRequest, PaginatedFavoriteList } from '../../../../types/openapi';
 import { GetFavoritesParams } from '../../../types/favorites';
 
+/**
+ * Get a list of favorites
+ */
 export declare function getFavorites(payload?: GetFavoritesParams): Promise<PaginatedFavoriteList>;
+/**
+ * Create a favorite
+ */
 export declare function createFavorite(payload: FavoriteCreateRequest): Promise<Favorite>;
+/**
+ * Delete a favorite
+ */
 export declare function deleteFavorite(payload: {
     favorite_id: Favorite['id'];
 }): Promise<void>;

package/lib/sdk/api/modules/feedback.d.ts

@@ -1,3 +1,6 @@
 import { SubmitUserFeedbackPayload } from '../../payload.types';
 
+/**
+ * Submit user feedback
+ */
 export declare function submitUserFeedback(payload: SubmitUserFeedbackPayload): Promise<any>;

package/lib/sdk/api/modules/files.d.ts

@@ -2,7 +2,10 @@ import { File, FileRetrieve, PaginatedFileList, FileUpdateRequest } from '../../
 import { GetRecentFilesPayload, ListFilesPayload } from '../../payload.types';
 import { AllFileCreateRequest, DeviceFile } from '../../../types/files';
 
-export declare function getFiles(payload: ListFilesPayload): Promise<PaginatedFileList>;
+export declare function getFiles(payload: ListFilesPayload & {
+    filters?: Record<string, any>;
+    fields?: string;
+}): Promise<PaginatedFileList>;
 export declare function getRecentFiles(payload?: GetRecentFilesPayload): Promise<File[]>;
 export declare function downloadFile(payload: {
     file_id: File['id'];
@@ -11,7 +14,8 @@ export declare function getAppConfig(payload: {
     app_name: string;
 }): Promise<Record<string, any>>;
 export declare function getFile(payload: {
-    file_id: FileRetrieve['id'];
+    id?: FileRetrieve['id'];
+    file_id?: FileRetrieve['id'];
 }): Promise<FileRetrieve>;
 export declare function updateFile(payload: FileUpdateRequest & {
     id: File['id'];
@@ -23,9 +27,8 @@ export declare function createFile(payload: Omit<AllFileCreateRequest, 'instance
 /**
  * Dispatches iOS native file selector and returns the selected file.
  *
- * ```
+ * @example
  * // iOS only method to select a file from the device.
  * api.selectDeviceFile()
- * ```
  */
 export declare function selectDeviceFile(): Promise<DeviceFile>;

package/lib/sdk/api/modules/folders.d.ts

@@ -1,16 +1,45 @@
 import { File, Folder, FolderRetrieve, FolderCreateRequest, FolderUpdateRequest } from '../../../../types/openapi';
 
+/**
+ * Retrieves a folder by its ID.
+ * @param payload - An object containing the folder ID.
+ * @param payload.id - The ID of the folder to retrieve. Defaults to 'root'.
+ * @returns A promise that resolves to the retrieved folder.
+ */
 export declare function getFolder(payload?: {
     id: FolderRetrieve['id'];
 }): Promise<FolderRetrieve>;
+/**
+ * Creates a new folder.
+ * @param payload - The folder creation request payload, excluding the instance_id.
+ * @returns A promise that resolves to the created folder.
+ */
 export declare function createFolder(payload: Omit<FolderCreateRequest, 'instance_id'>): Promise<FolderRetrieve>;
 type UpdateFolderPayload = FolderUpdateRequest & {
     id: Folder['id'];
 };
+/**
+ * Updates an existing folder.
+ * @param payload - The folder update payload, including the folder ID and update data.
+ * @returns A promise that resolves to the updated folder.
+ */
 export declare function updateFolder(payload: UpdateFolderPayload): Promise<FolderRetrieve>;
+/**
+ * Deletes a folder.
+ * @param payload - An object containing the ID of the folder to delete.
+ * @param payload.folder_id - The ID of the folder to delete.
+ * @returns A promise that resolves when the folder is deleted.
+ */
 export declare function deleteFolder(payload: {
     folder_id: FolderRetrieve['id'];
 }): Promise<void>;
+/**
+ * Moves items (files or folders) to a target folder.
+ * @param payload - The payload containing the target folder ID and items to move.
+ * @param payload.target_folder_id - The ID of the target folder.
+ * @param payload.items - An array of items to move, each with an ID and type.
+ * @returns A promise that resolves to the updated target folder.
+ */
 export declare function moveFolderItems(payload: {
     target_folder_id: Folder['id'];
     items: {

package/lib/sdk/api/modules/open.d.ts

@@ -1,4 +1,10 @@
 import { OpenExternalUrlRequestPayload, OpenRequestPayload } from '../../payload.types';
 
+/**
+ * Open a file in the CatalogIQ instance.
+ */
 export declare function open(payload?: OpenRequestPayload): Promise<string>;
+/**
+ * Open external URL in a new tab. Works on both web and mobile.
+ */
 export declare function openExternalUrl(payload: OpenExternalUrlRequestPayload): Promise<void>;

package/lib/sdk/api/modules/sync.d.ts

@@ -1,9 +1,8 @@
 /**
  * Dispatches iOS only sync method for non-files.
  *
- * ```
+ * @example
  * // iOS only method to sync non-files from the server.
  * api.triggerNonFilesSync()
- * ```
  */
 export declare function triggerNonFilesSync(): Promise<void>;

package/lib/sdk/api/modules/ui/app-errors.ui.d.ts

@@ -1,3 +1,15 @@
 import { UiCaptureAppErrorRequest } from './types.ui';
 
-export declare function capture_app_error(payload: UiCaptureAppErrorRequest): Promise<void>;
+/**
+ * Send an app error to Pitcher sentry instance.
+ *
+ * @example
+ * try {
+ *   throw new Error('This is an error')
+ * } catch (error) {
+ *   useUi().capture_app_error(error)
+ * }
+ *
+ * @param payload error object to send to Pitcher sentry instance
+ */
+export declare function captureAppError(payload: UiCaptureAppErrorRequest): Promise<void>;

package/lib/sdk/api/modules/ui/canvas.ui.d.ts

@@ -1,9 +1,103 @@
-import { Canvas } from '../../../../../types/openapi';
-import { UiAppResizeRequest, UiCanvasNavigatePageReuqest, UiUpdateCanvasRequest } from './types.ui';
+import { CanvasRetrieve } from '../../../../../types/openapi';
+import { UiAppResizeRequest, UiCanvasNavigatePageRequest, UiUpdateCanvasRequest, UiSelectCanvasesRequest, UiSelectCanvasesResponse } from './types.ui';
 
-export declare function update_canvas(payload: UiUpdateCanvasRequest): Promise<Canvas>;
-export declare function app_loaded(): Promise<void>;
-export declare function app_resize(payload: UiAppResizeRequest): Promise<void>;
-export declare function canvas_navigate_next_page(): Promise<void>;
-export declare function canvas_navigate_previous_page(): Promise<void>;
-export declare function canvas_navigate_page(payload: UiCanvasNavigatePageReuqest): Promise<void>;
+/**
+ * Modify the currently loaded canvas. On the web it sends
+ * an [update_canvas](https://pitcher.readme.io/reference/update_canvas) request to the server.
+ *
+ * @param payload parts of the canvas object to update with fields to return
+ */
+export declare function updateCanvas(payload: UiUpdateCanvasRequest): Promise<CanvasRetrieve>;
+/**
+ * Notify the CatalogIQ instance that the app is loaded and ready to get the data. Triggering this method will trigger
+ * the `on_app_set_data` event.
+ *
+ * @example
+ * @example
+ * useUi().appLoaded()
+ */
+export declare function appLoaded(): Promise<void>;
+/**
+ * Resize the app iframe to a given height.
+ *
+ * Note that initial iframe height comes from the `app.json` manifest file. It can also be adjusted by the user when adding
+ * app component to the canvas. In case when the app must be temporarily resized to show larger ui elements it can read the
+ * user-set height from the [on_app_set_data](#on-app-set-data) event.
+ * @param payload object containing requested height of the iframe as the number of pixels
+ */
+export declare function appResize(payload: UiAppResizeRequest): Promise<void>;
+/**
+ * Navigate to the next page in the current canvas. Noop if the current page is the last one.
+ *
+ * @example
+ * useUi().canvasNavigateNextPage()
+ */
+export declare function canvasNavigateNextPage(): Promise<void>;
+/**
+ * Navigate to the previous page in the current canvas. Noop if the current page is the first one.
+ *
+ * @example
+ * useUi().canvasNavigatePreviousPage()
+ */
+export declare function canvasNavigatePreviousPage(): Promise<void>;
+/**
+ * Navigate to a specific canvas place in the current canvas. Despite the event and parameter name, it takes the component
+ * id that we want to put in view.
+ *
+ * @example
+ * const uiApi = useUi() // our useApi()
+ *
+ * let activeCanvas = null
+ * const unsubscribe = uiApi.on_app_set_data((data) => {
+ *   activeCanvas = data?.canvas
+ * })
+ *
+ * document.getElementById('my-button').addEventListener('click', () => {
+ *   const target = activeCanvas?.content?.data?.find((i: any) => i.data.app_name === 'my-target-app-id') || null
+ *   if (target) {
+ *     uiApi.canvasNavigatePage({ page: target.id })
+ *   }
+ * })
+ */
+export declare function canvasNavigatePage(payload: UiCanvasNavigatePageRequest): Promise<void>;
+/**
+ * Opens a modal to view a canvas by ID.
+ *
+ * ```
+ * onMounted(() => {
+ *   uiApi.openCanvasOverlay({
+ *     id: '01HH4RCBH631K4JDHWAQB0RPR6',
+ *     edit_mode: false,
+ *     fullscreen: true,
+ *   })
+ * })
+ * ```
+ */
+export declare function openCanvasOverlay(payload: {
+    id: CanvasRetrieve['id'];
+    edit_mode?: boolean;
+    fullscreen?: boolean;
+    component_id?: string;
+    section_id?: string;
+}): Promise<void>;
+/**
+ * Allows the user to select (and preselect) canvases from the instance.
+ *
+ * This method allows you to prompt the user to select canvases from the CatalogIQ
+ * instance and use that canvas selection in your application.
+ *
+ * @example
+ * const api = useApi() // or useUi() if you know that you 're in UI context
+ * api
+ *   .selectCanvases({
+ *     allowed_types: ['canvas','canvas-template','section','section-template'] // default ['canvas']
+ *     selections: [
+ *       { id: "01HCZ623YYRFJQ0F7B69VWE510" },
+ *       { id: "02HCZ623YYRFJQ0F7B69VWE510" },
+ *     ], // default []
+ *   })
+ *
+ * @param payload optional payload to preselect specific canvases
+ * @returns Promise with the user action and selected canvases
+ */
+export declare function selectCanvases(payload?: UiSelectCanvasesRequest): Promise<UiSelectCanvasesResponse>;

package/lib/sdk/api/modules/ui/content.ui.d.ts

@@ -1,7 +1,57 @@
 import { UiSelectContentRequest, UiSelectContentResponse, UiOpenRequest, UiToastRequest, UiPreselectSfdcMeetingIdRequest, UiPreselectSfdcMeetingIdResponse } from './types.ui';
 
+/**
+ * @hidden
+ * @deprecated
+ */
 export declare function ui_select_content(payload?: UiSelectContentRequest): Promise<UiSelectContentResponse>;
-export declare function select_content(payload?: UiSelectContentRequest): Promise<UiSelectContentResponse>;
+/**
+ * Allows the user to select (and preselect) content from the instance.
+ *
+ * Opens the content selector dialog to allow the user to select content and handle the outcome. This method allows you to
+ * prompt the user to select content from the CatalogIQ instance and use that content in your application.
+ *
+ * @example
+ * const api = useApi() // or useUi() if you know that you 're in UI context
+ * api
+ *   .selectContent({
+ *     selections: [
+ *       { fileId: "01HCZ623YYRFJQ0F7B69VWE510", type: "file" },
+ *       {
+ *         fileId: "01HD3XGZ5FN90QJGK7CH8TBZDF",
+ *         type: "page",
+ *         pageIndex: 2,
+ *       },
+ *     ],
+ *   })
+ *
+ * @param payload optional payload to preselect specific content
+ * @returns Promise with the user action and selected content
+ */
+export declare function selectContent(payload?: UiSelectContentRequest): Promise<UiSelectContentResponse>;
+/**
+ * Open a file in the CatalogIQ instance.
+ */
 export declare function open(payload: UiOpenRequest): Promise<void>;
+/**
+ * Show a toast message to the user.
+ *
+ * @example
+ * useUi().toast({ type: 'info', message: 'Hello, world!' })
+ */
 export declare function toast(payload: UiToastRequest): Promise<void>;
-export declare function preselect_sfdc_meeting_id(payload: UiPreselectSfdcMeetingIdRequest): Promise<UiPreselectSfdcMeetingIdResponse>;
+/**
+ * Preselect a meeting in the top meeting bar by Salesforce Meeting ID. From there, the user can easily start the meeting
+ * with a single click.
+ *
+ * @example
+ * const objectFetchedFromSalesforce = {
+ *   // fetch dynamically from Salesforce or provide in another way
+ *   EventId: '00U1r00000D1J1zEAF',
+ * }
+ * ui.preselectSfdcMeetingId({ eventId: objectFetchedFromSalesforce.EventId }).then((response) => {
+ *   // e.g. display advanced meeting details inside your app
+ *   console.log(response.event)
+ * })
+ */
+export declare function preselectSfdcMeetingId(payload: UiPreselectSfdcMeetingIdRequest): Promise<UiPreselectSfdcMeetingIdResponse>;

package/lib/sdk/api/modules/ui/index.d.ts

@@ -1,15 +1,152 @@
 import { UiMeetingCanceledPayload, UiCanvasUpdatedPayload, UiSectionListUpdatedPayload, UiAppSetDataPayload, UiAppUpdateDataPayload, UiBroadcastRequest, UiMessagePayloads } from './types.ui';
 
-export declare function on<T extends keyof UiMessagePayloads>(type: T, handler: (data: UiMessagePayloads[T]) => Promise<void>): Promise<() => void>;
-export declare function on_meeting_canceled(handler: (data: UiMeetingCanceledPayload) => Promise<void>): Promise<() => void>;
-export declare function on_canvas_updated(handler: (data: UiCanvasUpdatedPayload) => Promise<void>): Promise<() => void>;
-export declare function on_section_list_updated(handler: (data: UiSectionListUpdatedPayload) => Promise<void>): Promise<() => void>;
-export declare function on_app_set_data(handler: (data: UiAppSetDataPayload) => Promise<void>): Promise<() => void>;
-export declare function on_app_update_data(handler: (data: UiAppUpdateDataPayload) => Promise<void>): Promise<() => void>;
-export declare function ui_broadcast(payload: UiBroadcastRequest): Promise<void>;
-export * from './content.ui';
-export * from './loading.ui';
-export * from './location.ui';
-export * from './app-errors.ui';
-export * from './canvas.ui';
-export * from './post-call.ui';
+/**
+ * Subscribe to a given event type by its key.
+ *
+ * @example
+ * const unsubscribeFromSectionListUpdate = useUi().on('ui_section_list_updated', (event: object) => {
+ *   // handle event
+ * })
+ *
+ * // later
+ * unsubscribeFromSectionListUpdate.then(unsubscribe => unsubscribe())
+ *
+ * @param type The event type/key to subscribe to.
+ * @param handler The handler function to call when the event is emitted.
+ * @returns A Promise resolving to a cleanup function to unsubscribe from the event.
+ */
+declare function on<T extends keyof UiMessagePayloads>(type: T, handler: (data: UiMessagePayloads[T]) => Promise<void>): Promise<() => void>;
+/**
+ * Subscribe to the meeting canceled event.
+ *
+ * @example
+ * const unsubscribeFromMeetingCanceled = useUi().onMeetingCanceled((event: {
+ *   accountId?: string;
+ *   eventId?: string;
+ * }) => {
+ *   // handle event
+ * })
+ *
+ * // later
+ * unsubscribeFromMeetingCanceled.then(cancel => cancel())
+ *
+ * @param handler
+ * @returns A Promise resolving to a cleanup function to unsubscribe from the event.
+ */
+declare function onMeetingCanceled(handler: (data: UiMeetingCanceledPayload) => Promise<void>): Promise<() => void>;
+/**
+ * Subscribe to the canvas updated event. It is triggered when the current canvas of the app is updated.
+ *
+ * @example
+ * const unsubscribePromise = useUi().onCanvasUpdated((event: { canvas }) => {
+ *   // handle event
+ * })
+ *
+ * // later
+ * unsubscribePromise.then(unsubscribe => unsubscribe())
+ *
+ * @returns A Promise resolving to a cleanup function to unsubscribe from the event.
+ */
+declare function onCanvasUpdated(handler: (data: UiCanvasUpdatedPayload) => Promise<void>): Promise<() => void>;
+/**
+ * Subscribe to the section list updated event. It is triggered when the list of sections (products) in the current canvas
+ * is updated.
+ *
+ * @example
+ * const unsubscribePromise = useUi().onSectionListUpdated((event: { canvas }) => {
+ *   // handle event
+ * })
+ *
+ * // later
+ * unsubscribePromise.then(unsubscribe => unsubscribe())
+ *
+ * @returns A Promise resolving to a cleanup function to unsubscribe from the event.
+ */
+declare function onSectionListUpdated(handler: (data: UiSectionListUpdatedPayload) => Promise<void>): Promise<() => void>;
+/**
+ * Subscribe to the app set data event. It is triggered when the app data is set. This event is triggered when the app is
+ * loaded and in certain other cases after loading.
+ *
+ * This is the main event for the canvas app to receive data from the CatalogIQ instance and know about its environment.
+ *
+ * @example
+ * let user = null
+ * let isEditMode = null
+ * let activeCanvas = null
+ * let isPrintMode = false
+ * const unsubscribePromise = useUi().onAppSetData((data) => {
+ *   user = data?.user
+ *   isEditMode = data?.is_edit_mode
+ *   activeCanvas = data?.canvas
+ *   isPrintMode = data?.display_mode === 'print' || data?.client === 'dsr'
+ *   // ...mode logic...
+ * })
+ *
+ * // later
+ * unsubscribePromise.then(unsubscribe => unsubscribe())
+ *
+ * @returns A Promise resolving to a cleanup function to unsubscribe from the event.
+ */
+declare function onAppSetData(handler: (data: UiAppSetDataPayload) => Promise<void>): Promise<() => void>;
+/**
+ * Subscribe to the app update data event. It is triggered when the user changes from edit mode to view mode or vice versa
+ * and when the call is started or ended.
+ *
+ * @example
+ * let inCall = false
+ * let isEditMode = false
+ * const unsubscribePromise = useUi().onAppUpdateData((data) => {
+ *   isEditMode = data?.is_edit_mode
+ *   inCall = data?.in_call
+ *   // ...mode logic...
+ * })
+ *
+ * // later
+ * unsubscribePromise.then(unsubscribe => unsubscribe())
+ *
+ * @returns A Promise resolving to a cleanup function to unsubscribe from the event.
+ */
+declare function onAppUpdateData(handler: (data: UiAppUpdateDataPayload) => Promise<void>): Promise<() => void>;
+/**
+ * Broadcast event to the UI. Hidden from the documentation.
+ *
+ * @hidden
+ */
+declare function uiBroadcast(payload: UiBroadcastRequest): Promise<void>;
+declare const _default: {
+    completePostcall(payload: import('../../../../main.lib').UiCompletePostcallRequest): Promise<void>;
+    stopMeeting(): Promise<void>;
+    enablePostcallSubmit(): Promise<void>;
+    disablePostcallSubmit(): Promise<void>;
+    setPostcallStyle(payload: import('../../../../main.lib').UiSetPostcallStyleRequest): Promise<void>;
+    updateCanvas(payload: import('../../../../main.lib').UiUpdateCanvasRequest): Promise<import('../../../../main.lib').CanvasRetrieve>;
+    appLoaded(): Promise<void>;
+    appResize(payload: import('../../../../main.lib').UiAppResizeRequest): Promise<void>;
+    canvasNavigateNextPage(): Promise<void>;
+    canvasNavigatePreviousPage(): Promise<void>;
+    canvasNavigatePage(payload: import('../../../../main.lib').UiCanvasNavigatePageRequest): Promise<void>;
+    openCanvasOverlay(payload: {
+        id: import('../../../../main.lib').CanvasRetrieve["id"];
+        edit_mode?: boolean;
+        fullscreen?: boolean;
+        component_id?: string;
+        section_id?: string;
+    }): Promise<void>;
+    selectCanvases(payload?: import('../../../../main.lib').UiSelectCanvasesRequest): Promise<import('../../../../main.lib').UiSelectCanvasesResponse>;
+    captureAppError(payload: import('../../../../main.lib').UiCaptureAppErrorRequest): Promise<void>;
+    updateLocation(payload: import('../../../../main.lib').UpdateLocationPitcherEvent): Promise<any>;
+    embeddableReady(): Promise<void>;
+    ui_select_content(payload?: import('../../../../main.lib').UiSelectContentRequest): Promise<import('../../../../main.lib').UiSelectContentResponse>;
+    selectContent(payload?: import('../../../../main.lib').UiSelectContentRequest): Promise<import('../../../../main.lib').UiSelectContentResponse>;
+    open(payload: import('../../../../main.lib').UiOpenRequest): Promise<void>;
+    toast(payload: import('../../../../main.lib').UiToastRequest): Promise<void>;
+    preselectSfdcMeetingId(payload: import('../../../../main.lib').UiPreselectSfdcMeetingIdRequest): Promise<import('../../../../main.lib').UiPreselectSfdcMeetingIdResponse>;
+    on: typeof on;
+    onMeetingCanceled: typeof onMeetingCanceled;
+    onCanvasUpdated: typeof onCanvasUpdated;
+    onSectionListUpdated: typeof onSectionListUpdated;
+    onAppSetData: typeof onAppSetData;
+    onAppUpdateData: typeof onAppUpdateData;
+    uiBroadcast: typeof uiBroadcast;
+};
+export default _default;

package/lib/sdk/api/modules/ui/loading.ui.d.ts

@@ -1 +1,9 @@
-export declare function embeddable_ready(): Promise<void>;
+/**
+ * This event is used for appJson.module.canvas.start_in_loading_mode: true apps.
+ * A loading curtain is displayed until you call this event.
+ *
+ * @example
+ * useUi().embeddableReady()
+ *
+ */
+export declare function embeddableReady(): Promise<void>;

package/lib/sdk/api/modules/ui/location.ui.d.ts

@@ -1,3 +1,20 @@
 import { UpdateLocationPitcherEvent } from '../../../interfaces';
 
-export declare function update_location(payload: UpdateLocationPitcherEvent): Promise<any>;
+/**
+ * Navigate to another page in the CatalogIQ instance.
+ *
+ * [//]: # 'TODO: This is a very powerful event, we need to expand documentation here'
+ *
+ * @example
+ * const canvasId = '1234567890abcdef12345678' // obtain target canvasId
+ * useUi().updateLocation({
+ *   action: 'restore',
+ *   routes: {
+ *     'slotty-ui': {
+ *       path: '/canvases/saved-canvases/' + canvasId + '/build/present',
+ *       query: {},
+ *     },
+ *   },
+ * })
+ */
+export declare function updateLocation(payload: UpdateLocationPitcherEvent): Promise<any>;

package/lib/sdk/api/modules/ui/post-call.ui.d.ts

@@ -1,6 +1,37 @@
 import { UiCompletePostcallRequest, UiSetPostcallStyleRequest } from './types.ui';
 
-export declare function complete_postcall(payload: UiCompletePostcallRequest): Promise<void>;
-export declare function enable_postcall_submit(): Promise<void>;
-export declare function disable_postcall_submit(): Promise<void>;
-export declare function set_postcall_style(payload: UiSetPostcallStyleRequest): Promise<void>;
+/**
+ * Ends current meeting and shows postcall form.
+ *
+ * @example
+ * useUi().completePostcall({ was_successfully_submitted: true })
+ */
+export declare function completePostcall(payload: UiCompletePostcallRequest): Promise<void>;
+/**
+ * Ends current meeting and shows postcall form.
+ *
+ * @example
+ * useUi().stopMeeting()
+ */
+export declare function stopMeeting(): Promise<void>;
+/**
+ * Mark the postcall form as possible to submit by the user.
+ *
+ * @example
+ * useUi().enablePostcallSubmit()
+ */
+export declare function enablePostcallSubmit(): Promise<void>;
+/**
+ * Mark the postcall form as **not** possible to submit by the user. Useful while processing the form data.
+ *
+ * @example
+ * useUi().disablePostcallSubmit()
+ */
+export declare function disablePostcallSubmit(): Promise<void>;
+/**
+ * Change the height of the postcall form.
+ *
+ * @example
+ * useUi().setPostcallStyle({ height: 100 })
+ */
+export declare function setPostcallStyle(payload: UiSetPostcallStyleRequest): Promise<void>;