@select-org/select-post-builder 1.1.45 → 1.1.47

package/dist/index.d.ts

@@ -39,16 +39,21 @@ declare type BaseProps = {
     hideGroupSelector?: boolean;
     isSubmitting?: boolean;
     clearOnSuccess?: boolean;
-    onCreatePost: (params: {
-        payload: Partial<PostCreationData>;
-        html: string;
-        json: JSONContent;
-        text: string;
-    }) => void;
+    onCreatePost: (params: CreatePostCallbackPayload) => void;
     onVoiceComment?: (params: {
         voiceUrl: string;
         voiceTime: number;
     }) => void;
+    /**
+     * Optional voice handoff for hosts that want to upload voice in their
+     * own pipeline. When provided AND `allowSendWhileUploading` is on, the
+     * comments-toolbar emits the recorded Blob via this callback instead of
+     * uploading sync via Filestore.uploadVoiceV2.
+     */
+    onVoiceRecord?: (params: {
+        blob: Blob;
+        voiceTime: number;
+    }) => void;
     onGroupSelect?: (groupId: string) => void;
     onDirtyStateChange?: (isDirty: boolean) => void;
     onReady?: (controls: PostBuilderControls) => void;
@@ -61,6 +66,27 @@ declare type BaseProps = {
     onEditorTabChange?: (tab: EditorTypes) => void;
 };
 
+declare type CreatePostCallbackPayload = {
+    payload: Partial<PostCreationData> & {
+        error?: string;
+    };
+    html: string;
+    json: JSONContent;
+    text: string;
+    /**
+     * Per-item upload state for in-flight media. Only populated when
+     * `allowSendWhileUploading` is on AND there are items with blob: URLs at
+     * submit time. Each entry: blob (the source File for host persistence),
+     * promise (resolves to the final hosted item), abort (cancel the underlying
+     * axios request).
+     */
+    pendingUploads?: Map<string, {
+        blob: File | Blob;
+        promise: Promise<PostCreationMediaItem | PollPostMediaOptionItem>;
+        abort: () => void;
+    }>;
+};
+
 export declare enum EditorPlacement {
     Feed = "Feed",
     Modal = "Modal",
@@ -144,6 +170,14 @@ export declare interface PostBuilderConfig {
     toI18N: (key: string) => string;
     i18nKeys?: Partial<PostBuilderI18nKeys>;
     logEvent: (name: string, properties: Record<string, unknown>) => void;
+    /**
+     * When true, allows Send to fire while media uploads are still in flight.
+     * The host must provide an `onCreatePost` handler that consumes the new
+     * `pendingUploads` field on the payload, and an `onVoiceRecord` prop on
+     * the editor for the voice handoff. Defaults to false; existing consumers
+     * are unaffected.
+     */
+    allowSendWhileUploading?: boolean;
 }
 
 export declare interface PostBuilderControls {
@@ -236,7 +270,7 @@ declare interface PostBuilderI18nKeys {
     uploadsInProgressKey: string;
 }
 
-export declare const PostBuilderProvider: ({ children, apiBaseURL, authToken, toI18N, i18nKeys, logEvent, }: PostBuilderConfig) => JSX_2.Element;
+export declare const PostBuilderProvider: ({ children, apiBaseURL, authToken, toI18N, i18nKeys, logEvent, allowSendWhileUploading, }: PostBuilderConfig) => JSX_2.Element;
 
 declare type PostCreationData = {
     body: string;
@@ -388,21 +422,6 @@ declare module '@tiptap/core' {
 }
 
 
-declare module '@tiptap/core' {
-    interface Commands<ReturnType> {
-        smartMediaUpload: {
-            insertMediaWithUpload: (params: {
-                source: File | Blob | string;
-                type: MediaNodeTypes;
-                mediaType?: MediaItemType;
-                caption?: string;
-                searchFrom?: ImageSearchFrom;
-            }) => ReturnType;
-        };
-    }
-}
-
-
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
         linkPreview: {
@@ -430,3 +449,18 @@ declare module '@tiptap/core' {
         };
     }
 }
+
+
+declare module '@tiptap/core' {
+    interface Commands<ReturnType> {
+        smartMediaUpload: {
+            insertMediaWithUpload: (params: {
+                source: File | Blob | string;
+                type: MediaNodeTypes;
+                mediaType?: MediaItemType;
+                caption?: string;
+                searchFrom?: ImageSearchFrom;
+            }) => ReturnType;
+        };
+    }
+}