@pitcher/js-api 1.30.0 → 1.31.0

package/lib/sdk/interfaces.d.ts

@@ -49,7 +49,18 @@ export interface OrgConfigResponse {
     sentry_region: 'us' | 'eu';
 }
 export interface PitcherEnv {
-    mode: 'WEB' | 'IOS' | 'WINDOWS' | 'ANDROID';
+    /**
+     * The HOST the web layer is running inside — `mode` IS the platform, one value per OS.
+     *
+     * `WEB` is the browser; everything else is a NATIVE shell with a JS bridge and an offline
+     * mirror (`IOS` the iPad, `MACOS`/`WINDOWS`/`ANDROID` the Tauri desktop/Android shell). Never
+     * write `mode === 'IOS'` to mean "native" — use `isNativeHost(mode)` (`@sdk/platform`), which
+     * is `mode !== 'WEB'` so a host newer than this bundle still takes the native branch. Values are
+     * only ever ADDED to this union — never renamed or removed, apps in the field compare them. `IOS` stays
+     * the right test only for iPad HARDWARE: MultipeerConnectivity (peer session), the Salesforce
+     * Mobile SDK's SmartStore, on-device inference — subsystems no other host has.
+     */
+    mode: 'WEB' | 'IOS' | 'WINDOWS' | 'ANDROID' | 'MACOS';
     pitcher: {
         token_claims: Record<string, any>;
         organization: PitcherOrg;
@@ -78,6 +89,25 @@ export interface PitcherEnv {
     ui_locale?: string;
     device_locale?: string;
     sync_badge_value?: number;
+    /**
+     * Bridge capabilities the running native host advertises (PIT-7682). Only web posts to the API
+     * directly and needs no capability check — every NATIVE host (`isNativeHost(env.mode)`) routes
+     * requests through its own bridge handlers.
+     *
+     * That includes the **Tauri desktop/Android shell** (`pitcher-impact-tauri-ng`), which reports
+     * its own build target as `mode` (`MACOS` / `WINDOWS` / `ANDROID`) and states what it supports
+     * here. A host that omits a token behaves exactly like an old iPad build — consumers that treat
+     * absent as unsupported degrade it safely — so gaining a capability means implementing the
+     * forwarding first.
+     *
+     * Tokens are `<request_type>.<field>`, e.g. `share_canvas.brand_id`. Feature-detect on them
+     * rather than on `version`: an older host omits the key entirely, so **absent must be treated as
+     * unsupported**. The shape is not guaranteed either — it crosses a bridge from native code — so
+     * check `Array.isArray` before `.includes`, or a string value substring-matches the gate open.
+     * Defined natively in `BridgeCapabilities` (pitcher-impact-ios-ng); the strings are a permanent
+     * contract because web builds in the wild keep checking them.
+     */
+    capabilities?: string[];
 }
 export interface PitcherAPI extends Emitter<ApiEventMap> {
     request(type: string, body: any, callback: () => any): Promise<PitcherResponse>;

package/lib/sdk/main.d.ts

@@ -1,6 +1,7 @@
 import { ApiOptions } from './interfaces';
 import { createHighLevelApi } from './api/HighLevelApi';
 export * from './interfaces';
+export * from './platform';
 export * from './payload.types';
 export * from './api/modules/ui/types.ui';
 export * from './api/modules/admin/types.admin';
@@ -9,8 +10,39 @@ export * from './peer-connectivity';
 export declare let highLevelApi: ReturnType<typeof createHighLevelApi>;
 /**
  * Check out the returned object documentation for the list of available methods.
+ *
+ * `options` CONFIGURES THE SHARED SINGLETON — it is not component-scoped. The
+ * host app is expected to pass them exactly once at boot (slotty does this in
+ * `api/client.ts`, supplying the Sentry `errorLogger` and the org's `fetchMode`).
+ *
+ * A call with NO options is a plain accessor and must never rebuild: canvas-ui
+ * has ~40 bare `usePitcherApi()` call sites (composables, comment components,
+ * `useBroadcastRouteChange` on every sidebar navigation). Rebuilding on those
+ * reset the singleton to `LowLevelApi`'s constructor defaults — dropping the
+ * host's `fetchMode` back to 'postmessage' and silently replacing the Sentry
+ * errorLogger with a no-op for the rest of the session. Because `highLevelApi`
+ * is an exported `let` with ESM live binding, every later importer picked up the
+ * downgraded instance. Each rebuild also registered another never-removed
+ * `window` 'message' listener and fired another `subscribe`, so listeners grew
+ * without bound.
+ *
+ * If you need different options for one call site, use `createScopedPitcherApi`
+ * — do not pass options here.
  */
 export declare function usePitcherApi(options?: ApiOptions): ReturnType<typeof createHighLevelApi>;
+/**
+ * A DEDICATED api instance for a call site that needs different options, without
+ * touching the shared singleton every other consumer holds.
+ *
+ * Inherits whatever the host configured (so the Sentry errorLogger and casing
+ * survive) and applies `options` on top.
+ *
+ * Each instance registers its own `window` 'message' listener and its own
+ * `subscribe`, so create ONE per call site at module scope — never inside a
+ * component `setup()`, which would leak a listener per mount. Responses are
+ * matched by callback id and unknown ids are ignored, so instances coexist.
+ */
+export declare function createScopedPitcherApi(options?: ApiOptions): ReturnType<typeof createHighLevelApi>;
 /**
  * API methods available in the CatalogIQ default UI.
  *
@@ -234,6 +266,7 @@ export declare function useApi(options?: ApiOptions): {
         id: import('../main.lib').CanvasRetrieve["id"];
         fields?: string;
         lazy_sections?: boolean;
+        skip_error_toast?: boolean;
     }): Promise<import('../main.lib').CanvasRetrieve>;
     getSectionsByIds(payload: {
         canvas_id: import('../main.lib').CanvasRetrieve["id"];
@@ -246,6 +279,7 @@ export declare function useApi(options?: ApiOptions): {
     }>;
     shareCanvas(payload: {
         id: import('../main.lib').CanvasRetrieve["id"];
+        brand_id?: string;
     }): Promise<import('../main.lib').SharedLink>;
     getCanvasRecommendedFiles(payload: {
         canvas_id: import('../main.lib').CanvasRetrieve["id"];
@@ -541,6 +575,7 @@ export declare function useApi(options?: ApiOptions): {
             id: import('../main.lib').CanvasRetrieve["id"];
             fields?: string;
             lazy_sections?: boolean;
+            skip_error_toast?: boolean;
         }): Promise<import('../main.lib').CanvasRetrieve>;
         getSectionsByIds(payload: {
             canvas_id: import('../main.lib').CanvasRetrieve["id"];
@@ -553,6 +588,7 @@ export declare function useApi(options?: ApiOptions): {
         }>;
         shareCanvas(payload: {
             id: import('../main.lib').CanvasRetrieve["id"];
+            brand_id?: string;
         }): Promise<import('../main.lib').SharedLink>;
         getCanvasRecommendedFiles(payload: {
             canvas_id: import('../main.lib').CanvasRetrieve["id"];
@@ -787,6 +823,7 @@ export declare function useApi(options?: ApiOptions): {
         id: import('../main.lib').CanvasRetrieve["id"];
         fields?: string;
         lazy_sections?: boolean;
+        skip_error_toast?: boolean;
     }): Promise<import('../main.lib').CanvasRetrieve>;
     getSectionsByIds(payload: {
         canvas_id: import('../main.lib').CanvasRetrieve["id"];
@@ -799,6 +836,7 @@ export declare function useApi(options?: ApiOptions): {
     }>;
     shareCanvas(payload: {
         id: import('../main.lib').CanvasRetrieve["id"];
+        brand_id?: string;
     }): Promise<import('../main.lib').SharedLink>;
     getCanvasRecommendedFiles(payload: {
         canvas_id: import('../main.lib').CanvasRetrieve["id"];

package/lib/sdk/payload.types.d.ts

@@ -657,6 +657,38 @@ export interface AppsDbDeleteEntryPayload {
 export interface AppsDbPsqlPayload {
     query: string;
 }
+/**
+ * Page-level attribution for ONE cited file (PIT-8062).
+ *
+ * `page_indices` is **0-based** — the same base `openFile(fileId, pageIndex)`
+ * and the iOS `page_index` → `pdfPageIndex` bridge take, so a consumer passes
+ * the value straight through and only adds 1 for a user-facing label. The model
+ * emits 1-based page numbers (it echoes the label it was shown); next-core's
+ * pia-search route converts them exactly once, server-side.
+ */
+export interface PiaSearchCitation {
+    /**
+     * A file id that also appears in `cited_file_ids`.
+     *
+     * That superset relation is a **server guarantee**, not something this SDK
+     * enforces: next-core's pia-search route builds `cited_file_ids` as the union
+     * of the model's own list and every citation's `file_id`, so a file can be
+     * added by a citation but never removed by one. The SDK coerces the two
+     * fields independently and does not cross-check them — it has no way to tell a
+     * contract violation from a backend newer than itself.
+     */
+    file_id: string;
+    /**
+     * 0-based viewer page indices.
+     *
+     * The route emits them ascending, deduped, one entry per file and at most 5
+     * per file. Those are again **server** guarantees, restated here so a consumer
+     * knows what to expect; this SDK passes the array through untouched rather
+     * than re-normalizing it, so it cannot drift from whatever the route decides.
+     * A consumer that renders fixed-width chips should still cap what it draws.
+     */
+    page_indices: number[];
+}
 /**
  * Unified `piaSearchAnswer` result across both serving paths.
  */
@@ -669,6 +701,19 @@ export interface PiaSearchAnswerResult {
      * File ids (from the candidate context) the answer drew on. Online path only.
      */
     cited_file_ids?: string[];
+    /**
+     * Which page(s) of each cited file the answer was grounded in (PIT-8062).
+     * Online, document-grounded path only, and only when the instance has the
+     * `pia_search_page_citations` flag on.
+     *
+     * **Optional at RUNTIME, not merely in the types.** Consumers load this SDK
+     * from an unversioned CDN tag, so the bundle a rep runs may predate the field
+     * entirely; and a backend with the flag off omits it from the body. The key is
+     * absent in those cases — never `null`, never `[]`. A cited file with no page
+     * information still appears in `cited_file_ids`: degrade to a file-level
+     * citation, never to an empty state.
+     */
+    citations?: PiaSearchCitation[];
     /**
      * Model self-reported confidence. Online path only.
      */

package/lib/sdk/platform.d.ts

@@ -0,0 +1,27 @@
+import { PLATFORM_TYPE } from '../constants/cdp.const';
+import { PitcherEnv } from './interfaces';
+export type PitcherMode = PitcherEnv['mode'];
+export type PitcherPlatformType = (typeof PLATFORM_TYPE)[keyof typeof PLATFORM_TYPE];
+/** The one value a browser reports. Every other `mode` comes from a native shell's bridge. */
+export declare const WEB_MODE = "WEB";
+/**
+ * Is this host a NATIVE shell rather than a browser?
+ *
+ * `env.mode` names the platform (`WEB`, `IOS`, `MACOS`, `WINDOWS`, `ANDROID`). Only the browser
+ * builds (Impact web, Admin) ever say `WEB`; every other value is a shell that answers `getEnv`
+ * over a JS bridge and keeps an offline mirror. The distinction most platform branches actually
+ * want is "bridge + offline mirror or plain HTTP", NOT "iPad" — for years there was only one
+ * native host, so the two were spelled the same (`mode === 'IOS'`).
+ *
+ * **Backward and forward compatible by construction:** the check is `mode !== 'WEB'`, not a
+ * lookup in a closed list. An SDK or Slotty bundle built today keeps treating a host it has never
+ * heard of (a future `LINUX`, say) as native, so a new host never needs a lockstep web deploy to
+ * keep its offline paths, and an old host reporting `IOS` is unchanged.
+ *
+ * Use this wherever the branch means "the host answers this over its bridge / has local files /
+ * has no on-demand fetch". Keep a literal `mode === 'IOS'` ONLY for iPad HARDWARE — Multipeer
+ * peer session, the Salesforce Mobile SDK's SmartStore, on-device inference — which no other
+ * host implements and which answer `requestTypeDoesNotExists` there.
+ */
+export declare function isNativeHost(mode: PitcherMode | string | null | undefined): boolean;
+export declare function platformTypeForMode(mode: PitcherMode | string | null | undefined): PitcherPlatformType | undefined;

package/lib/sdk/platform.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/sdk/singleton-scope.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/sdk/utils/httpFetch.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/theme/canvasUiUnoPreset.test.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/types/app.d.ts

@@ -73,7 +73,9 @@ type AppTypeJsonOptions = {
         width?: number | string;
         height?: number | string;
     };
-    placement?: 'top-left' | 'top-center' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom-center' | 'bottom-right';
+    placement?: 'top-left' | 'top-center' | 'top-right' | 'left' | 'center' | 'right' | 'bottom-left' | 'bottom-center' | 'bottom-right'
+    /** canvas-popup only: full-width sheet sliding up from the bottom (the presentation-tools shell); `dimensions` are ignored. ui-global-popup apps fall back to `center`. */
+     | 'bottom-sheet';
     mode_config?: {
         fullscreen?: {
             show?: boolean;
@@ -92,6 +94,57 @@ type AppTypeJsonOptions = {
         };
     };
 };
+/**
+ * One field of an app's `secrets_schema`.
+ *
+ * `type` drives how Admin renders the input, and the rules differ by schema shape — see
+ * `client/src/admin/util/appSecrets.ts` and the vocabulary table in next-core's
+ * `api/protected/apps/[app_name]/secrets/README.md`. In short: a flat schema masks everything
+ * except an explicit `'text'`; a `_strategy` schema treats `'string'` as readable and `'password'`
+ * as masked. `required` is absent-means-true — only `false` marks a field optional.
+ */
+export type SecretFieldSchema = {
+    type?: 'string' | 'password' | 'text' | 'select';
+    description?: string;
+    required?: boolean;
+    /** `type: 'select'` only. */
+    options?: {
+        label: string;
+        value: string;
+    }[];
+};
+/** The `_strategy` entry: lets one app offer alternative credential sets (e.g. user/pass vs ECA). */
+export type SecretStrategySchema = {
+    key: string;
+    label: string;
+    default: string;
+    options: Record<string, {
+        label: string;
+    }>;
+};
+/** A schema with no `_strategy`: every entry is a field. The common case. */
+export type FlatSecretsSchema = Record<string, SecretFieldSchema>;
+/**
+ * A schema that offers alternative credential sets: the `_strategy` entry, plus one GROUP of
+ * fields per strategy key (e.g. `user_pass` and `eca` in sfdc-activity-tracking).
+ */
+export type StrategySecretsSchema = {
+    _strategy: SecretStrategySchema;
+    [group: string]: SecretStrategySchema | FlatSecretsSchema;
+};
+/**
+ * An app's `secrets_schema`, in either shape.
+ *
+ * A UNION, not an intersection: the two shapes disagree about what a value is, and `_strategy`
+ * cannot be both a {@link SecretFieldSchema} and a {@link SecretStrategySchema} — `options` alone
+ * is an array of `{label, value}` in one and a `Record<string, {label}>` in the other. Modelling it
+ * as one indexed object made every strategy schema unconstructible without a cast.
+ *
+ * Narrow with `secretsStrategyOf()` in `client/src/admin/util/appSecrets.ts` rather than testing
+ * `_strategy` for truthiness: under {@link FlatSecretsSchema} a field could legitimately be NAMED
+ * `_strategy`, and a truthiness test would then read that field as strategy config.
+ */
+export type SecretsSchema = FlatSecretsSchema | StrategySecretsSchema;
 export type AppJson = {
     name: string;
     display_name: string;
@@ -108,6 +161,7 @@ export type AppJson = {
     order_override?: number;
     has_multiple_routes?: boolean;
     configure_entry?: string;
+    secrets_schema?: SecretsSchema;
 };
 export type AppFile = File & {
     app_metadata?: AppJson;

package/lib/types/canvases.d.ts

@@ -4,6 +4,7 @@ export interface GetCanvasesParams {
     instance_id?: string;
     is_draft?: boolean;
     is_editable?: boolean;
+    is_master?: boolean;
     is_section?: boolean;
     is_template?: boolean;
     is_default?: boolean;
@@ -16,6 +17,20 @@ export interface GetCanvasesParams {
     id__in?: string;
     access_type?: string;
     template__id?: string;
+    /**
+     * `'member'` resolves visibility as a plain member even for admins/editors —
+     * only canvases distributed to the caller's groups, public ones, or their own
+     * are returned (PIT-8022). Honored by the next-core distributed endpoint;
+     * ignored (harmless) by the Django list endpoint and the iOS bridge.
+     */
+    scope?: 'member';
+    /**
+     * Skips the `COUNT(DISTINCT c.id)` pagination query. The response then
+     * reports `count: 0`, so only pass it when the caller does not paginate.
+     * Honored by the next-core distributed endpoint; ignored (harmless)
+     * elsewhere.
+     */
+    skip_count?: boolean;
 }
 export interface CanvasMetadataRetrieve {
     config: Record<string, any> & {

package/lib/types/launchDarkly.types.d.ts

@@ -1,4 +1,4 @@
-export type LaunchDarklyBooleanFlagKey = 'allow_ai_prompts_in_canvas_text' | 'allow_bulk_actions_canvases_files' | 'allow_content_grid_autofill' | 'allow_canvas_duplication' | 'allow_canvases_tables_columns_settings' | 'allow_table_column_resizing' | 'allow_creating_canvas_with_no_template' | 'allow_dynamic_data_table_for_scribble_component' | 'allow_html_for_scribble_component' | 'allow_embeddable_for_scribble_component' | 'allow_embeddable_hiding' | 'allow_multimedia_for_scribble_component' | 'allow_note_taking' | 'allow_rep_canvas_metadata_edit' | 'allow_rep_file_distributions' | 'allow_rep_file_rating' | 'allow_rep_file_upload' | 'allow_saving_annotations_in_personal_layer' | 'allow_user_to_edit_font_size_and_color_in_canvas_tokens' | 'are_sections_system_controlled' | 'enable_canvas_core_distributions' | 'copy_context_to_canvas' | 'copy_template_metadata_to_canvas' | 'disable_canvas_edit_for_reps' | 'disable_custom_tooltips' | 'disable_file_edit_content' | 'enable_inline_wopi_edit_button' | 'disable_fullscreen_canvas_builder' | 'disable_impact_web_browser_fullscreen' | 'disable_user_invitations' | 'display_section_list_name' | 'disable_download_canvas' | 'enable_ai_generated_thumbnails' | 'enable_analytics' | 'enable_app_developer_role' | 'enable_algolia_search' | 'enable_background_image_theme_options' | 'enable_better_canvas_builder_control_bars_on_zoom' | 'enable_bulk_update_file_attributes' | 'enable_canvas_as_home' | 'enable_canvas_blocks' | 'enable_canvas_node_debugging' | 'enable_canvas_freeze' | 'enable_canvas_locks' | 'enable_canvas_template_edit_in_impact' | 'enable_canvas_tokens' | 'enable_collaborations' | 'enable_collection_player_data_accessor' | 'enable_content_grid_data_accessor' | 'enable_content_translation' | 'enable_content_type_change_in_content_selector' | 'enable_cross_tab_instance_reload_for_ld_sync' | 'enable_create_section_from_section_template' | 'enable_custom_display_overrides' | 'enable_default_crm_shape' | 'enable_detailed_date_format' | 'enable_dsr_readonly_annotations' | 'enable_dnd_html_editor' | 'enable_dynamic_content_component' | 'enable_dynamic_data_table_component' | 'enable_custom_data_tables' | 'enable_embedded_video_autoplay' | 'enable_embedded_video' | 'enable_enhanced_canvas_drawer_app' | 'enable_enhanced_indicators' | 'enable_enhanced_section_execution_states' | 'enable_experimental_canvas_builder_dnd' | 'enable_extra_file_data' | 'enable_file_copy' | 'enable_file_pages_metadata' | 'enable_file_revisions' | 'enable_file_divisible_permission' | 'enable_folder_details_edit' | 'enable_folder_distributions' | 'enable_handlebar_template_support' | 'enable_height_in_component_theming' | 'enable_home_customization' | 'enable_hotspot_visibility' | 'enable_improved_canvas_node_updating' | 'enable_individual_users_in_file_distribution' | 'enable_inline_filter_options' | 'enable_insearch_in_section_selector' | 'enable_instance_cloner' | 'enable_advanced_cloner' | 'enable_content_promotion' | 'enable_instance_editor_role' | 'enable_instance_navigation_from_management' | 'enable_knock_notifications' | 'enable_maintain_section_theme_control' | 'enable_metadata_in_file_uploads_with_default_values' | 'enable_more_intuitive_component_spacing' | 'enable_multi_destination_upload' | 'enable_new_meeting_bar' | 'enable_provider_agnostic_meeting_bar' | 'enable_original_pdf_link' | 'enable_scale_content' | 'enable_sorting_in_tiptap_table' | 'enable_stt_dictation' | 'enable_cloud_stt_fallback' | 'enable_theme_assets' | 'enable_toc_enhancements_to_support_same_section_in_section_list' | 'enable_pia_assistant' | 'enable_pipe_character_multi_search' | 'enable_popup_apps' | 'enable_pre_send_validation' | 'enable_reorder_search' | 'enable_reorder_scribble_isolation' | 'enable_reorder_component_options_menu' | 'enable_resizable_multimedia_component' | 'enable_responsive_scribble_component' | 'enable_saved_canvases_filters' | 'enable_short_tag_column_in_tables' | 'enable_scribble_component' | 'enable_scribble_content_as_background' | 'enable_search_and_filters_in_multimedia_component' | 'enable_section_context_in_dsr' | 'enable_selectors_dnd' | 'enable_section_selector_edit_section' | 'enable_smart_folders' | 'enable_smart_folders_for_sections' | 'enable_smart_folders_in_section_selector' | 'enable_smart_folders_in_files' | 'enable_sorting_in_sections' | 'enable_suggested_tags' | 'enable_template_component_permissions' | 'enable_template_folders' | 'enable_theme_options_border_radius' | 'enable_themes' | 'hide_asset_uploader' | 'hide_user_feedback_widget' | 'include_files_content_in_print' | 'interpolate_rep_canvases_on_edit_mode' | 'is_timeline_component_allowed' | 'launch_in_full_screen_on_present_mode' | 'prefer_online_handlers' | 'restrict_owned_files_from_admins' | 'show_asset_manager_for_multimedia' | 'show_clear_all_annotations_button' | 'show_content_selector_list_view' | 'show_metadata_filters_in_all_canvas_things' | 'show_only_preview_mode_for_html_component' | 'show_popularity_icons' | 'use_core_endpoint_for_analytics' | 'convert_pptx_to_section_with_scribble_pdfjs' | 'use_short_url_for_shared_link' | 'use_zoho_instead_of_ms_wopi' | 'enable_new_section_list' | 'enable_sharebox_apps' | 'enable_sharebox_bulk_filtering' | 'enable_back_to_previous_location_in_canvas' | 'enable_crm_shape_for_external_links' | 'enable_adaptive_popup_apps' | 'enable_file_version_polling' | 'skip_pspdfkit_wait_for_high_res_thumbs' | 'enable_reactive_scribble_component_toolbar' | 'enable_embeddable_full_screen_mode' | 'enable_enhanced_user_management' | 'enable_impersonation' | 'enable_instance_admin_user_assignment' | 'keep_static_pptx_editable' | 'enable_canvas_pdf_dimensions' | 'enable_editable_pptx_of_canvas' | 'enable_editable_pptx_of_canvas_with_fonts' | 'enable_aspose_pptx_of_canvas' | 'enable_canvas_control_bars_collapse' | 'enable_rep_app_visibility_order' | 'enable_file_sharing_print_permissions' | 'enable_section_sharing_print_permissions' | 'enable_marketplace_tab' | 'enable_sfdc_account_visibility_for_canvases' | 'sfdc_offline_enabled' | 'enable_granular_permissions' | 'enable_hub_collections' | 'enable_hub_recommended_smart_folder' | 'enable_custom_user_properties';
+export type LaunchDarklyBooleanFlagKey = 'allow_ai_prompts_in_canvas_text' | 'allow_bulk_actions_canvases_files' | 'allow_content_grid_autofill' | 'allow_canvas_duplication' | 'allow_canvases_tables_columns_settings' | 'allow_table_column_resizing' | 'allow_creating_canvas_with_no_template' | 'allow_dynamic_data_table_for_scribble_component' | 'allow_html_for_scribble_component' | 'allow_embeddable_for_scribble_component' | 'allow_embeddable_hiding' | 'allow_multimedia_for_scribble_component' | 'allow_note_taking' | 'allow_rep_canvas_metadata_edit' | 'allow_rep_file_distributions' | 'allow_rep_file_rating' | 'allow_rep_file_upload' | 'allow_saving_annotations_in_personal_layer' | 'allow_user_to_edit_font_size_and_color_in_canvas_tokens' | 'are_sections_system_controlled' | 'enable_canvas_core_distributions' | 'copy_context_to_canvas' | 'copy_template_metadata_to_canvas' | 'disable_canvas_edit_for_reps' | 'disable_custom_tooltips' | 'disable_file_edit_content' | 'enable_inline_wopi_edit_button' | 'disable_fullscreen_canvas_builder' | 'disable_impact_web_browser_fullscreen' | 'disable_user_invitations' | 'display_section_list_name' | 'disable_download_canvas' | 'enable_ai_generated_thumbnails' | 'enable_analytics' | 'enable_app_developer_role' | 'enable_algolia_search' | 'enable_background_image_theme_options' | 'enable_better_canvas_builder_control_bars_on_zoom' | 'enable_bulk_update_file_attributes' | 'enable_canvas_as_home' | 'enable_canvas_blocks' | 'enable_canvas_node_debugging' | 'enable_canvas_freeze' | 'enable_canvas_locks' | 'enable_canvas_template_edit_in_impact' | 'enable_canvas_tokens' | 'enable_collaborations' | 'enable_collection_player_data_accessor' | 'enable_content_grid_data_accessor' | 'enable_content_translation' | 'enable_content_type_change_in_content_selector' | 'enable_cross_tab_instance_reload_for_ld_sync' | 'enable_create_section_from_section_template' | 'enable_custom_display_overrides' | 'enable_default_crm_shape' | 'enable_detailed_date_format' | 'enable_dsr_readonly_annotations' | 'enable_dnd_html_editor' | 'enable_dynamic_content_component' | 'enable_dynamic_data_table_component' | 'enable_custom_data_tables' | 'enable_embedded_video_autoplay' | 'enable_embedded_video' | 'enable_enhanced_canvas_drawer_app' | 'enable_enhanced_indicators' | 'enable_enhanced_section_execution_states' | 'enable_experimental_canvas_builder_dnd' | 'enable_extra_file_data' | 'enable_file_copy' | 'enable_file_pages_metadata' | 'enable_file_revisions' | 'enable_file_divisible_permission' | 'enable_folder_details_edit' | 'enable_folder_distributions' | 'enable_handlebar_template_support' | 'enable_height_in_component_theming' | 'enable_home_customization' | 'enable_hotspot_visibility' | 'enable_improved_canvas_node_updating' | 'enable_individual_users_in_file_distribution' | 'enable_inline_filter_options' | 'enable_insearch_in_section_selector' | 'enable_instance_cloner' | 'enable_advanced_cloner' | 'enable_content_promotion' | 'enable_instance_editor_role' | 'enable_instance_navigation_from_management' | 'enable_knock_notifications' | 'enable_maintain_section_theme_control' | 'enable_master_pitchdecks' | 'enable_metadata_in_file_uploads_with_default_values' | 'enable_more_intuitive_component_spacing' | 'enable_multi_destination_upload' | 'enable_new_meeting_bar' | 'enable_provider_agnostic_meeting_bar' | 'enable_original_pdf_link' | 'enable_scale_content' | 'enable_sorting_in_tiptap_table' | 'enable_stt_dictation' | 'enable_cloud_stt_fallback' | 'enable_theme_assets' | 'enable_toc_enhancements_to_support_same_section_in_section_list' | 'enable_pia_assistant' | 'enable_pipe_character_multi_search' | 'enable_popup_apps' | 'enable_pre_send_validation' | 'enable_reorder_search' | 'enable_reorder_scribble_isolation' | 'enable_reorder_component_options_menu' | 'enable_resizable_multimedia_component' | 'enable_responsive_scribble_component' | 'enable_saved_canvases_filters' | 'enable_short_tag_column_in_tables' | 'enable_scribble_component' | 'enable_scribble_content_as_background' | 'enable_search_and_filters_in_multimedia_component' | 'enable_section_context_in_dsr' | 'enable_selectors_dnd' | 'enable_section_selector_edit_section' | 'enable_smart_folders' | 'enable_smart_folders_for_sections' | 'enable_smart_folders_in_section_selector' | 'enable_smart_folders_in_files' | 'enable_sorting_in_sections' | 'enable_suggested_tags' | 'enable_template_component_permissions' | 'enable_template_folders' | 'enable_theme_options_border_radius' | 'enable_themes' | 'hide_asset_uploader' | 'hide_user_feedback_widget' | 'include_files_content_in_print' | 'interpolate_rep_canvases_on_edit_mode' | 'is_timeline_component_allowed' | 'launch_in_full_screen_on_present_mode' | 'prefer_online_handlers' | 'restrict_owned_files_from_admins' | 'show_asset_manager_for_multimedia' | 'show_clear_all_annotations_button' | 'show_content_selector_list_view' | 'show_metadata_filters_in_all_canvas_things' | 'show_only_preview_mode_for_html_component' | 'show_popularity_icons' | 'use_core_endpoint_for_analytics' | 'convert_pptx_to_section_with_scribble_pdfjs' | 'use_short_url_for_shared_link' | 'use_zoho_instead_of_ms_wopi' | 'enable_new_section_list' | 'enable_sharebox_apps' | 'enable_sharebox_bulk_filtering' | 'enable_back_to_previous_location_in_canvas' | 'enable_crm_shape_for_external_links' | 'enable_adaptive_popup_apps' | 'enable_file_version_polling' | 'skip_pspdfkit_wait_for_high_res_thumbs' | 'enable_reactive_scribble_component_toolbar' | 'enable_embeddable_full_screen_mode' | 'enable_enhanced_user_management' | 'enable_impersonation' | 'enable_instance_admin_user_assignment' | 'keep_static_pptx_editable' | 'enable_canvas_pdf_dimensions' | 'enable_editable_pptx_of_canvas' | 'enable_editable_pptx_of_canvas_with_fonts' | 'enable_aspose_pptx_of_canvas' | 'enable_canvas_control_bars_collapse' | 'enable_rep_app_visibility_order' | 'enable_file_sharing_print_permissions' | 'enable_section_sharing_print_permissions' | 'enable_marketplace_tab' | 'enable_sfdc_account_visibility_for_canvases' | 'sfdc_offline_enabled' | 'enable_granular_permissions' | 'enable_hub_recommended_smart_folder' | 'enable_custom_user_properties';
 export type LaunchDarklyNumberFlagKey = 'canvas_section_selector_page_size' | 'canvas_section_selector_selected_items_with_thumbnail_size';
 /** How PIA Search serves inference (PIT-6863). */
 export type PiaSearchMode = 'off' | 'on_device' | 'online';
@@ -45,6 +45,13 @@ export type CanvasManagerTableColumns = {
     canvases: CanvasManagerVisibility;
     section_templates: CanvasManagerVisibility;
     sections: CanvasManagerVisibility;
+    /**
+     * PIT-7488 — the master pitchdeck tab. Optional because the LD flag predates it and no
+     * environment configures it yet; `getVisibleColumns` degrades to "show every column" when the
+     * key is absent, so masters must NOT inherit the `canvases` config (hiding a column on the
+     * Pitchdecks tab would otherwise silently hide it here too).
+     */
+    master_canvases?: CanvasManagerVisibility;
 };
 export type LaunchDarklyEnv = {
     [K in LaunchDarklyBooleanFlagKey]?: boolean;

package/lib/types/organizationSettings.types.d.ts

@@ -40,6 +40,10 @@ export type OrganizationSettings = {
         enable_wizard_preview_button?: boolean;
         enable_edit_opens_completion_wizard?: boolean;
         enable_react_completion_wizard?: boolean;
+        enable_wizard_add_group?: boolean;
+        enable_presentation_tools?: boolean;
+        enable_hub_bottom_sheet?: boolean;
+        presentation_tools_frameless?: boolean;
         enable_toc_open_by_default?: boolean;
         use_canvas_exit_confirmation?: boolean;
         locks_polling_interval?: number;
@@ -60,6 +64,26 @@ export type OrganizationSettings = {
             }>;
         };
     };
+    /**
+     * PIT-7682 — open-ended list of brands the rep can pick from when creating a shared link.
+     * Supersedes the single-value `shared_link_brand_slug` / `canvas_dot_page_subdomain_to_use`
+     * keys, which stay readable as a fallback while instances are migrated.
+     *
+     * An instance-level list REPLACES the org-level one wholesale (that is how Django merges
+     * settings — its deep merge recurses into objects only), so never resolve it through
+     * `createPitcherSettings`, whose lodash `merge` combines arrays element-wise instead.
+     *
+     * Per entry: `id` is the stable reference sent to the API as `brand_id`, `name` is the
+     * rep-facing label, and at least one of `subdomain` (needs one-time Rebrandly setup) or
+     * `slug` (self-serve) must be set or the entry is skipped. `subdomain` wins over `slug`.
+     */
+    shared_link_brands?: {
+        id: string;
+        name?: string;
+        subdomain?: string;
+        slug?: string;
+        is_default?: boolean;
+    }[];
     allow_dsr_forwarding?: boolean;
     allow_revoke_shared_link?: boolean;
     enable_slotty_ui_asset_manager?: boolean;
@@ -81,6 +105,7 @@ export type OrganizationSettings = {
     minimum_event_duration_in_call?: number;
     enable_content_rating_in_call?: boolean;
     enable_speaker_notes?: boolean;
+    enable_account_only_meeting_notes?: boolean;
     display_metadata_filters_in_modal?: boolean;
     enable_js_api_recommended_files?: boolean;
     metadata_highlight_properties?: MetadataHighlightProperty[];
@@ -136,6 +161,10 @@ export type OrganizationSettings = {
     disable_postcall?: boolean;
     preserve_account_after_call_stop?: boolean;
     meeting_bar_show_meetings?: boolean;
+    postcall_event_hooks?: {
+        on_submit?: Record<string, string | number | boolean | null>;
+        on_cancel?: Record<string, string | number | boolean | null>;
+    };
     launch_in_present_mode_on_creation?: boolean;
     slotty_ui_route_config?: {
         name: string;

package/lib/util/aiSummary.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Parse a stored `metadata.aiAnalysis.summary` value into plain display text.
+ *
+ * `next-core`'s file-analysis.parse.ts prompts the model for a fenced
+ * ```json block and extracts `summary` on a successful JSON.parse — but on a
+ * JSON.parse failure (malformed model output) it falls back to storing the
+ * RAW text (the fence and all, sliced to 200 chars) directly as `summary`.
+ * That raw-fallback shape is what showed up as a literal ```json blob in the
+ * Hub's Summary section (PIT-8049). Handles three shapes:
+ *  (a) a plain string — the common, already-clean case
+ *  (b) a string containing a ```json fenced blob (complete OR truncated/
+ *      unterminated) whose JSON has a `summary` key
+ *  (c) an object carrying a `summary` field directly (recurses, so a
+ *      double-wrapped value is also unwrapped)
+ *
+ * This function's body (and its test suite) is identical to the Hub's
+ * `utils/fileMetadata.ts` copy — Hub (React) and canvas-ui (Vue) share no
+ * runtime code, so it's duplicated rather than shared. The surrounding FILES
+ * differ (helper order, doc comments); only `parseAiSummary` itself and the
+ * tests must stay in lockstep.
+ */
+export declare function parseAiSummary(value: unknown): string | undefined;
+/**
+ * Normalize a file's AI key messages to a string array. Prefers the newer
+ * `metadata.aiAnalysis.keyPoints`, falls back to legacy `metadata.key_messages`.
+ *
+ * Ported from the Hub's `utils/fileMetadata.ts` (PIT-8049 round 2) — data-only,
+ * no React/Vue-specific logic, so a straight copy.
+ */
+export declare function normalizeKeyMessages(metadata: Record<string, any> | null | undefined): string[];

package/lib/util/aiSummary.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/util/network.d.ts

@@ -1,5 +1,40 @@
 import { PaginatedData } from '../types/paginatedData';
+/** What the `*WithStatus` fetchers return: the rows, plus whether they are all of them. */
+export interface FetchAllResult<T> {
+    /** The fetched rows, capped at `maxLimit`. */
+    items: T[];
+    /** True when the server had more rows than the cap allowed us to fetch. */
+    truncated: boolean;
+    /** The server-reported total, regardless of the cap. */
+    total: number;
+}
+/**
+ * `fetchAll`, but the caller can tell whether it got everything.
+ *
+ * The cap has always been silent — a Sentry message nobody sees at the call
+ * site, and a plain array indistinguishable from a complete one, so callers
+ * that persist or present the result treat 2000 of 5000 rows as the whole
+ * library (PIT-8408). Use this wherever "is this all of it?" changes what the
+ * caller should do or show; `fetchAll` stays the shorthand for the rest.
+ */
+export declare const fetchAllWithStatus: <T>(reqFunction: (reqParams: any) => Promise<PaginatedData<T>>, reqParams?: any, maxLimit?: number) => Promise<FetchAllResult<T>>;
 export declare const fetchAll: <T>(reqFunction: (reqParams: any) => Promise<PaginatedData<T>>, reqParams?: any, maxLimit?: number) => Promise<T[]>;
+/**
+ * `fetchAllWithOffset`, but the caller can tell whether it got everything.
+ *
+ * The offset-based twin of `fetchAllWithStatus`, and it carried the same silent
+ * cap: a Sentry message nobody sees at the call site, and a plain array that a
+ * caller cannot distinguish from a complete one (PIT-8408). Use this wherever
+ * "is this all of it?" changes what the caller should do or show.
+ */
+export declare const fetchAllWithOffsetStatus: <T>(reqFunction: (reqParams: any) => Promise<{
+    pagination: {
+        limit: number;
+        offset: number;
+        total: number;
+    };
+    data: T[];
+}>, reqParams?: any, maxLimit?: number) => Promise<FetchAllResult<T>>;
 export declare const fetchAllWithOffset: <T>(reqFunction: (reqParams: any) => Promise<{
     pagination: {
         limit: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pitcher/js-api",
-  "version": "1.30.0",
+  "version": "1.31.0",
   "type": "module",
   "main": "js-api.umd.min.js",
   "module": "js-api.esm.js",

package/types/openapi/models/Canvas.d.ts

@@ -11,6 +11,7 @@ export type Canvas = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/CanvasCreate.d.ts

@@ -16,6 +16,7 @@ export type CanvasCreate = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/CanvasCreateRequest.d.ts

@@ -11,6 +11,7 @@ export type CanvasCreateRequest = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/CanvasRecommendedFile.d.ts

@@ -45,5 +45,5 @@ export type CanvasRecommendedFile = {
     readonly created_at: string;
     readonly created_by: MiniUser;
     readonly modified_at: string;
-    readonly modified_by: MiniUser;
+    readonly modified_by: MiniUser | null;
 };

package/types/openapi/models/CanvasRetrieve.d.ts

@@ -16,6 +16,7 @@ export type CanvasRetrieve = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/CanvasUpdate.d.ts

@@ -16,6 +16,7 @@ export type CanvasUpdate = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/CanvasUpdateRequest.d.ts

@@ -10,6 +10,7 @@ export type CanvasUpdateRequest = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/DeletedCanvas.d.ts

@@ -11,6 +11,7 @@ export type DeletedCanvas = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/File.d.ts

@@ -47,5 +47,5 @@ export type File = {
     readonly created_at: string;
     readonly created_by: MiniUser;
     readonly modified_at: string;
-    readonly modified_by: MiniUser;
+    readonly modified_by: MiniUser | null;
 };

package/types/openapi/models/PatchedCanvasUpdateRequest.d.ts

@@ -10,6 +10,7 @@ export type PatchedCanvasUpdateRequest = {
     is_template?: boolean;
     is_section?: boolean;
     is_block?: boolean;
+    is_master?: boolean;
     is_editable?: boolean;
     is_default?: boolean;
     metadata?: any;

package/types/openapi/models/SharedLink.d.ts

@@ -11,4 +11,10 @@ export type SharedLink = {
     readonly status: string;
     readonly url: string;
     short_url?: string | null;
+    /**
+     * PIT-7682 - CLIENT-SET, never returned by the API. Marks a link that was re-created without
+     * the rep's chosen brand after the server rejected it, so the UI can say the pick was not
+     * applied. Set by `canvas.api.ts` on web and by the iOS bridge handler (`brand_fallback_applied`).
+     */
+    brand_fallback_applied?: boolean;
 };