@pitcher/js-api 1.26.1 → 1.27.1

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

@@ -1,14 +1,24 @@
-export type LaunchDarklyBooleanFlagKey = 'ai_code_generation_model' | 'ai_text_generation_model' | 'ai_image_generation_model' | 'ai_video_generation_model' | '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_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_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_multimedia_component_ai_images' | 'enable_new_meeting_bar' | 'enable_provider_agnostic_meeting_bar' | 'enable_original_pdf_link' | 'enable_scale_content' | 'enable_sorting_in_tiptap_table' | '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 = 'ai_image_generation_model' | 'ai_video_generation_model' | '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_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_multimedia_component_ai_images' | 'enable_new_meeting_bar' | 'enable_provider_agnostic_meeting_bar' | 'enable_original_pdf_link' | 'enable_scale_content' | 'enable_sorting_in_tiptap_table' | '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 LaunchDarklyNumberFlagKey = 'canvas_section_selector_page_size' | 'canvas_section_selector_selected_items_with_thumbnail_size';
-export type HubPiaSearchFlag = {
-    enabled: boolean;
-    model_for_pia_search: string;
-    model_for_pia_embedding: string;
+/** How PIA Search serves inference (PIT-6863). */
+export type PiaSearchMode = 'off' | 'on_device' | 'online';
+/**
+ * `pia_search_config` LD flag value — selects how PIA Search serves inference.
+ * Object-valued (not a bare boolean) so the mode can grow sibling config later
+ * without a second flag; `mode` is the only field today.
+ */
+export type PiaSearchConfig = {
+    mode?: PiaSearchMode;
 };
+/**
+ * Resolve the PIA Search mode from the `pia_search_config` flag: a valid `mode`
+ * wins; anything missing or invalid resolves to `'off'` (fail-closed).
+ */
+export declare function resolvePiaSearchMode(config: PiaSearchConfig | null | undefined): PiaSearchMode;
 type LaunchDarklyObjectFlags = {
     canvas_manager_table_columns: CanvasManagerTableColumns;
     context_crm_shape: Record<string, any>;
-    enable_hub_pia_search: HubPiaSearchFlag;
+    pia_search_config: PiaSearchConfig;
 };
 export type LaunchDarklyObjectFlagKey = keyof LaunchDarklyObjectFlags;
 export type LaunchDarklyStringFlagKey = keyof typeof _LaunchDarklyStringFlags;
@@ -21,7 +31,6 @@ declare const _LaunchDarklyStringFlags: {
     readonly dsr_remote_script_url: readonly ["https://anyvalidurl.xyz", ""];
     readonly ai_image_generation_model: readonly ["minimax/image-01", ""];
     readonly ai_video_generation_model: readonly ["minimax/video-01", ""];
-    readonly ai_text_generation_model: readonly ["anthropic/claude-4.6-sonnet", ""];
     readonly sharebox_format: readonly ["content-grid", "content-grid-default", "collection-player-default"];
 };
 type LaunchDarklyStringFlagValue<K extends LaunchDarklyStringFlagKey = LaunchDarklyStringFlagKey> = K extends LaunchDarklyStringFlagKey ? (typeof _LaunchDarklyStringFlags)[K][number] : never;

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

@@ -1,5 +1,15 @@
 import { TranslationOverrides } from './translations';
 import { MetadataHighlightProperty } from './metadataHighlightProperty';
+/**
+ * Forward stub for PIT-6124 content-recommendation matching. Maps a CRM/context
+ * source field to a canvas/file metadata key so recommendations can be filtered
+ * or ranked by metadata alignment.
+ */
+export type ContentMatchRule = {
+    source_field: string;
+    target_metadata_key: string;
+    required?: boolean;
+};
 type SmartFolderRuleAttribute = {
     name: string;
     type: 'string' | 'boolean' | 'number' | 'date' | 'array';
@@ -55,6 +65,8 @@ export type OrganizationSettings = {
     enable_multi_language?: boolean;
     enable_multipeer_connectivity?: boolean;
     enable_syncbox?: boolean;
+    enable_custom_folder_order?: boolean;
+    lazy_load_sections?: boolean;
     canvases_route_order?: number;
     content_browser_route_order?: number;
     assets_route_order?: number;
@@ -125,5 +137,11 @@ export type OrganizationSettings = {
         use_static_ip_proxy?: boolean;
         api_version?: string;
     };
+    ai_tasks?: {
+        disabled?: string[];
+    };
+    content_recommendation?: {
+        match_rules?: ContentMatchRule[];
+    };
 };
 export {};

package/lib/util/fullscreen.util.d.ts

@@ -10,7 +10,18 @@ export type DocumentWithFullscreen = Document & {
     webkitExitFullscreen?: () => Promise<void>;
     msExitFullscreen?: () => Promise<void>;
 };
-export declare function requestFullscreen(el?: FullscreenElement | null): Promise<void>;
+/**
+ * Request fullscreen on `el` (or the document root). Resolves `true` when fullscreen
+ * was actually entered, `false` when it was a no-op or blocked — e.g. inside an iframe
+ * whose `allow` lacks `fullscreen` (SFDC embed / app host), where the browser rejects
+ * with "TypeError: Disallowed by permissions policy". Swallowing that rejection keeps
+ * it from surfacing as an unhandled rejection (IMPACT-WEB-NG-GH/GG).
+ *
+ * IMPORTANT: resolution does NOT mean fullscreen is active — callers that run side
+ * effects on entering fullscreen (set state, broadcast events, reparent DOM, steal
+ * focus) MUST gate them on the returned boolean.
+ */
+export declare function requestFullscreen(el?: FullscreenElement | null): Promise<boolean>;
 export declare function exitFullscreen(): Promise<void>;
 export declare function toggleFullscreen(element: FullscreenElement): void;
 export declare function isFullscreen(): boolean;

package/lib/util/handlebars.d.ts

@@ -1,4 +1,22 @@
 export declare function renderTemplate(template: string, context?: Record<string, any>): string;
+/**
+ * Return a render context where the named `html`-typed custom user properties
+ * (`context.user.<field>`) are wrapped in `Handlebars.SafeString`, so a plain
+ * `{{user.field}}` renders the stored markup unescaped (parity with the disclosure
+ * HTML the field type is for) without authors needing triple-mustache.
+ *
+ * - Non-mutating: shallow-clones `context` and `context.user` only when a wrap happens,
+ *   so the persisted `canvas.context` is never touched (a `SafeString` would corrupt it
+ *   on save / JSON-serialize). The wrapped values live only in the transient render context.
+ * - Sanitized here before wrapping (defense-in-depth): values are also sanitized on input
+ *   (admin UI + CSV), but server-side write paths (SSO sync, direct API PATCH) bypass that,
+ *   and marking a value `SafeString` makes it render as trusted HTML — so re-sanitize at the
+ *   point we declare it safe. Idempotent on already-clean markup.
+ */
+type RenderContext = {
+    user?: Record<string, unknown>;
+} & Record<string, unknown>;
+export declare function withSafeHtmlUserProps(context?: RenderContext, htmlFieldNames?: string[]): RenderContext;
 export interface CustomHandlebarsHelper {
     name: string;
     code: string;
@@ -34,3 +52,4 @@ export declare function loadCustomHelpersFromApps(installedApps: Array<{
     registered: number;
     failed: number;
 };
+export {};

package/lib/util/network.d.ts

@@ -19,3 +19,24 @@ export declare function derivePatchRequestFields<T extends object>(current: T, u
     payload: Partial<T>;
 };
 export declare function requestStream(url: string, body: Record<string, any>, token: string, onStreamedChunk?: (chunk: string, response: string) => void, signal?: AbortSignal): Promise<string>;
+/**
+ * Split a raw SSE buffer on the `\n\n` event boundary. When `done`, the trailing
+ * fragment is flushed as a final event; otherwise it is returned in `rest` to be
+ * prepended to the next chunk.
+ */
+export declare function splitSseBuffer(buffer: string, done: boolean): {
+    events: string[];
+    rest: string;
+};
+/** Parse one SSE event block into its JSON payload; null for `[DONE]`, keep-alives, or non-JSON. */
+export declare function parseSseEvent(event: string): Record<string, unknown> | null;
+/**
+ * Consume the Bedrock SSE stream from `/core/api/protected/ai/ai-generation/stream`
+ * and accumulate text. The endpoint emits `data: {"type":"content_delta","delta":"…"}`
+ * frames, a `data: {"type":"error","error":"…"}` on failure, and a `data: [DONE]`
+ * terminator (PIT-7145). Calls `onText(delta, fullText)` per content chunk and
+ * returns the full text; throws on error frames / network failures. Replaces the
+ * legacy Replicate NDJSON parsing now that platform AI surfaces run on the
+ * `routine` tier (Bedrock).
+ */
+export declare function requestAiStream(url: string, body: Record<string, any>, token: string, onText?: (delta: string, fullText: string) => void, signal?: AbortSignal): Promise<string>;

package/lib/util/network.test.d.ts

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

package/lib/util/string.d.ts

@@ -3,3 +3,16 @@ export declare function prefixHttps(url: string): string;
 export declare function stripHtmlTags(htmlString: string | undefined): string;
 export declare function sanitizeHtml(htmlString: string | undefined): string;
 export declare function stripHtmlTagsAndTrim(htmlString: string | undefined): string;
+/**
+ * Allowlist-sanitize user-authored HTML that will be rendered as TRUSTED markup
+ * (e.g. an `html`-typed custom user property wrapped in a Handlebars `SafeString`,
+ * or shown via `v-html`). Uses DOMPurify with an explicit tag/attribute allowlist;
+ * DOMPurify additionally strips every `on*` handler and blocks dangerous URL schemes
+ * (`javascript:` etc.) on `href`. Prefer this over `sanitizeHtml` (a weak denylist)
+ * anywhere user HTML is rendered unescaped.
+ *
+ * DOMPurify needs a DOM; user HTML only renders client-side. With no `window`
+ * (Node/SSR) fall back to `stripHtmlTags` — a regex strip that needs no DOMParser,
+ * so it never throws and never emits raw markup (fail closed to inert text).
+ */
+export declare function sanitizeUserHtml(htmlString: string | undefined): string;

package/package.json

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

package/types/openapi/index.d.ts

@@ -146,6 +146,7 @@ export type { MetadataTemplateSection } from './models/MetadataTemplateSection';
 export type { MetadataTemplateSectionRequest } from './models/MetadataTemplateSectionRequest';
 export type { MiniCanvas } from './models/MiniCanvas';
 export type { MiniCanvasRequest } from './models/MiniCanvasRequest';
+export type { MiniCanvasWithTags } from './models/MiniCanvasWithTags';
 export type { MiniContentDistributionGroup } from './models/MiniContentDistributionGroup';
 export type { MiniContentDistributionGroupRequest } from './models/MiniContentDistributionGroupRequest';
 export type { MiniEnvironment } from './models/MiniEnvironment';

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

@@ -1,6 +1,6 @@
 import { AccessTypeEnum } from './AccessTypeEnum';
 import { Account } from './Account';
-import { MiniCanvas } from './MiniCanvas';
+import { MiniCanvasWithTags } from './MiniCanvasWithTags';
 import { MiniSharedLink } from './MiniSharedLink';
 import { MiniUser } from './MiniUser';
 export type Canvas = {
@@ -19,7 +19,7 @@ export type Canvas = {
     expires_at?: string | null;
     access_type?: AccessTypeEnum;
     thumbnail_url?: string | null;
-    readonly template: MiniCanvas;
+    readonly template: MiniCanvasWithTags;
     readonly shared_link: MiniSharedLink;
     account?: Account | null;
     folder_id?: string | null;

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

@@ -1,7 +1,7 @@
 import { AccessTypeEnum } from './AccessTypeEnum';
 import { Account } from './Account';
 import { CanvasSection } from './CanvasSection';
-import { MiniCanvas } from './MiniCanvas';
+import { MiniCanvasWithTags } from './MiniCanvasWithTags';
 import { MiniEvent } from './MiniEvent';
 import { MiniSharedLink } from './MiniSharedLink';
 import { MiniUser } from './MiniUser';
@@ -25,7 +25,7 @@ export type CanvasCreate = {
     access_type?: AccessTypeEnum;
     thumbnail_url?: string | null;
     instance_id: string;
-    readonly template: MiniCanvas;
+    readonly template: MiniCanvasWithTags;
     readonly sections: Array<CanvasSection>;
     readonly shared_link: MiniSharedLink;
     account?: Account | null;

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

@@ -1,7 +1,7 @@
 import { AccessTypeEnum } from './AccessTypeEnum';
 import { Account } from './Account';
 import { CanvasSection } from './CanvasSection';
-import { MiniCanvas } from './MiniCanvas';
+import { MiniCanvasWithTags } from './MiniCanvasWithTags';
 import { MiniEvent } from './MiniEvent';
 import { MiniSharedLink } from './MiniSharedLink';
 import { MiniUser } from './MiniUser';
@@ -25,8 +25,16 @@ export type CanvasRetrieve = {
     access_type?: AccessTypeEnum;
     thumbnail_url?: string | null;
     instance_id: string;
-    readonly template: MiniCanvas;
+    readonly template: MiniCanvasWithTags;
     readonly sections: Array<CanvasSection>;
+    /**
+     * Opt-in lazy section loading: present (instead of inline `sections`) only when
+     * the canvas was fetched with `?lazy_sections=true` AND the org/instance
+     * `lazy_load_sections` setting is on. Ordered referenced section IDs; the client
+     * hydrates bodies on demand via `getSectionsByIds`. Absent on every legacy
+     * (fully-expanded) response. Hand-added (additive) — preserve on type regen.
+     */
+    readonly section_ids?: Array<string>;
     readonly shared_link: MiniSharedLink;
     account?: Account | null;
     readonly events: Array<MiniEvent>;

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

@@ -1,7 +1,7 @@
 import { AccessTypeEnum } from './AccessTypeEnum';
 import { Account } from './Account';
 import { CanvasSection } from './CanvasSection';
-import { MiniCanvas } from './MiniCanvas';
+import { MiniCanvasWithTags } from './MiniCanvasWithTags';
 import { MiniEvent } from './MiniEvent';
 import { MiniSharedLink } from './MiniSharedLink';
 import { MiniUser } from './MiniUser';
@@ -25,7 +25,7 @@ export type CanvasUpdate = {
     access_type?: AccessTypeEnum;
     thumbnail_url?: string | null;
     instance_id: string;
-    readonly template: MiniCanvas;
+    readonly template: MiniCanvasWithTags;
     readonly sections: Array<CanvasSection>;
     readonly shared_link: MiniSharedLink;
     account?: Account | null;

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

@@ -1,6 +1,6 @@
 import { AccessTypeEnum } from './AccessTypeEnum';
 import { Account } from './Account';
-import { MiniCanvas } from './MiniCanvas';
+import { MiniCanvasWithTags } from './MiniCanvasWithTags';
 import { MiniSharedLink } from './MiniSharedLink';
 import { MiniUser } from './MiniUser';
 export type DeletedCanvas = {
@@ -19,7 +19,7 @@ export type DeletedCanvas = {
     expires_at?: string | null;
     access_type?: AccessTypeEnum;
     thumbnail_url?: string | null;
-    readonly template: MiniCanvas;
+    readonly template: MiniCanvasWithTags;
     readonly shared_link: MiniSharedLink;
     account?: Account | null;
     folder_id?: string | null;

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

@@ -5,6 +5,10 @@ export type FolderFolder = {
     readonly id: string;
     name: string;
     readonly thumbnail_url: string | null;
+    /**
+     * Manual custom-sort position among siblings. Null when no custom order is set.
+     */
+    order?: number | null;
     readonly folders_count: number;
     readonly files_count: number;
     readonly available_files_count: number;

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

@@ -10,6 +10,7 @@ import { MiniUser } from './MiniUser';
 export type FolderRetrieve = {
     readonly id: string;
     name: string;
+    readonly instance_id: string;
     readonly content_type: string;
     access_type?: AccessTypeEnum;
     rules?: Array<FolderRule>;

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

@@ -5,6 +5,7 @@
  * * `select` - Dropdown - Single Select
  * * `multi-select` - Dropdown - Multiple Select
  * * `checkbox` - Checkbox
+ * * `html` - HTML
  */
 export declare enum MetadataTemplateFieldTypeEnum {
     TEXT = "text",
@@ -12,5 +13,6 @@ export declare enum MetadataTemplateFieldTypeEnum {
     DATE = "date",
     SELECT = "select",
     MULTI_SELECT = "multi-select",
-    CHECKBOX = "checkbox"
+    CHECKBOX = "checkbox",
+    HTML = "html"
 }

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

@@ -0,0 +1,5 @@
+export type MiniCanvasWithTags = {
+    readonly id: string;
+    name: string;
+    readonly tags?: Array<string>;
+};