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

package/dist/index.d.ts

@@ -4,6 +4,21 @@ import { JSONContent as JSONContent_2 } from '@tiptap/core';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
+/**
+ * Walks the editor JSON and updates the media node whose `attrs.uid === itemKey`
+ * with the hosted URL + payload from a resolved upload result. Returns a new
+ * doc; never mutates the input. If no matching node is found, returns the input.
+ */
+export declare function applyResolvedMediaItem(jsonBody: JSONContent_2 | undefined, itemKey: string, resolvedItem: ResolvedMediaItem): JSONContent_2 | undefined;
+
+/**
+ * Walks a serialized htmlBody string, finds the `[data-media][data-uid=itemKey]`
+ * wrapper and rewrites it to point at the hosted URL + payload from a resolved
+ * upload result. Mirrors `applyResolvedMediaItem` for the JSON form. If no
+ * matching node is found, returns the input unchanged.
+ */
+export declare function applyResolvedMediaItemToHtml(html: string | undefined, itemKey: string, resolvedItem: ResolvedMediaItem_2): string | undefined;
+
 declare type AppUserPayload = {
     background: string;
     username: string;
@@ -60,6 +75,12 @@ declare type BaseProps = {
     disableNavigationWarning?: boolean;
     /** Tiptap JSONContent to pre-populate the editor with (takes precedence over localStorage draft) */
     initialContent?: JSONContent;
+    /**
+     * Initial tab to land on when the editor first mounts. Applied on first mount
+     * only — subsequent prop changes are ignored. Same semantics as `initialContent`.
+     * Default: `EditorTypes.Media`.
+     */
+    initialTab?: EditorTypes;
     /** When true, the submit/post button in the toolbar is hidden */
     hideSubmitButton?: boolean;
     /** Fires when the user switches between editor tabs (Media, Blog, Poll) */
@@ -87,6 +108,11 @@ declare type CreatePostCallbackPayload = {
     }>;
 };
 
+export declare interface DraftRehydrateRequestDetail {
+    groupId: string;
+    editorType?: EditorTypes;
+}
+
 export declare enum EditorPlacement {
     Feed = "Feed",
     Modal = "Modal",
@@ -101,6 +127,18 @@ export declare enum EditorTypes {
     Poll = "Poll"
 }
 
+/**
+ * Ensures a poll has at least two choices. The feed renderer requires >=2 to
+ * display a poll. When given exactly one choice, returns a two-element array
+ * by duplicating the choice with a fresh `option_id` and the appropriate
+ * `option_color`. When given zero or >=2, returns the input untouched.
+ *
+ * Used by `generatePollPostPayload` for fresh sends and by the host's resend
+ * path so that a failed-then-stripped poll draft (which can collapse to a
+ * single hosted item) still produces a renderable post.
+ */
+export declare const ensurePollMinimum: (items: PollChoiceItem[]) => PollChoiceItem[];
+
 declare interface ImageInfo {
     width: number;
     height: number;
@@ -205,7 +243,8 @@ export declare enum PostBuilderEvents {
     POST_PUBLISH_ATTEMPTED = "select:post_publish_attempted",
     POST_PUBLISH_SUCCESSFUL = "select:post_publish_success",
     POST_PUBLISH_FAILED = "select:post_publish_failed",
-    POST_SESSION_ROTATED = "select:post_session_rotated"
+    POST_SESSION_ROTATED = "select:post_session_rotated",
+    DRAFT_REHYDRATE_REQUEST = "select:draft_rehydrate_request"
 }
 
 declare interface PostBuilderI18nKeys {
@@ -321,11 +360,31 @@ export declare type PublishEventDetails = {
     failureReason?: string;
 };
 
+declare type ResolvedMediaItem = PostCreationMediaItem | PollPostMediaOptionItem;
+
+declare type ResolvedMediaItem_2 = PostCreationMediaItem | PollPostMediaOptionItem;
+
 declare enum SpecialType {
     POST = 0,
     FEATURED_POST = 1
 }
 
+/**
+ * Walks a serialized htmlBody string and removes media wrappers whose upload
+ * did not complete (data-src missing or blob:-prefixed). Empty
+ * `[data-media-group]` wrappers left behind are also removed. Mirrors
+ * `stripPendingMediaFromJsonBody` for the JSON form.
+ */
+export declare function stripPendingMediaFromHtml(html: string | undefined): string | undefined;
+
+/**
+ * Walks the editor JSON and removes media nodes whose upload did not complete
+ * (uploading: true OR src starts with 'blob:'). Also removes empty mediaGroup
+ * wrappers left behind. Used by failure / boot-GC paths to keep stripped drafts
+ * consistent with the items[] array.
+ */
+export declare function stripPendingMediaFromJsonBody(jsonBody: JSONContent_2 | undefined): JSONContent_2 | undefined;
+
 declare type WithModalProps = BaseProps & {
     openModal: boolean;
     onModalOpenChange: (open: boolean) => void;
@@ -422,6 +481,21 @@ 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: {
@@ -449,18 +523,3 @@ 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;
-        };
-    }
-}