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

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;
@@ -321,11 +336,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;
@@ -380,27 +415,14 @@ declare module '@tiptap/core' {
 
 declare module '@tiptap/core' {
     interface Commands<ReturnType> {
-        customLink: {
-            /**
-             * Insert a new link mark with preview
-             */
-            insertLink: (attrs: LinkMarkAttrs) => ReturnType;
-            /**
-             * Update an existing link mark with its preview
-             */
-            updateLink: (uid: string, attrs: Partial<Omit<LinkMarkAttrs, 'uid'>>) => ReturnType;
-            /**
-             * Update media node attributes by uid
-             */
-            updateLinkByUid: (uid: string, attrs: Partial<LinkMarkAttrs>) => ReturnType;
-            /**
-             * Delete link preview node by uid
-             */
-            deleteLinkByUid: (uid: string) => ReturnType;
-            /**
-             * Re-run unfurl resolution for existing links after content rehydration.
-             */
-            rehydrateLinkPreviews: () => ReturnType;
+        smartMediaUpload: {
+            insertMediaWithUpload: (params: {
+                source: File | Blob | string;
+                type: MediaNodeTypes;
+                mediaType?: MediaItemType;
+                caption?: string;
+                searchFrom?: ImageSearchFrom;
+            }) => ReturnType;
         };
     }
 }
@@ -453,14 +475,27 @@ 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;
+        customLink: {
+            /**
+             * Insert a new link mark with preview
+             */
+            insertLink: (attrs: LinkMarkAttrs) => ReturnType;
+            /**
+             * Update an existing link mark with its preview
+             */
+            updateLink: (uid: string, attrs: Partial<Omit<LinkMarkAttrs, 'uid'>>) => ReturnType;
+            /**
+             * Update media node attributes by uid
+             */
+            updateLinkByUid: (uid: string, attrs: Partial<LinkMarkAttrs>) => ReturnType;
+            /**
+             * Delete link preview node by uid
+             */
+            deleteLinkByUid: (uid: string) => ReturnType;
+            /**
+             * Re-run unfurl resolution for existing links after content rehydration.
+             */
+            rehydrateLinkPreviews: () => ReturnType;
         };
     }
 }