@select-org/select-post-builder 1.4.0 → 1.4.2

package/dist/index.d.ts

@@ -135,8 +135,10 @@ declare type CreatePostCallbackPayload = {
     /**
      * Per-item upload state for media the host may need to persist. Populated
      * when `allowSendWhileUploading` is on OR `unauthenticatedMode` is on, for
-     * items with blob: URLs at submit time. Each entry always carries `blob`
-     * (the source File for host persistence). For in-flight uploads
+     * media still uploading (or deferred) at submit time, keyed by the payload
+     * item's `key`. `blob` is the source File for host persistence; it is absent
+     * for a remote-URL upload (GIF or image search, pasted image URL), whose
+     * placeholder item uses the remote URL. For in-flight uploads
      * (allowSendWhileUploading), `promise` resolves to the final hosted item and
      * `abort` cancels the underlying axios request. For deferred blobs
      * (unauthenticatedMode) both `promise` and `abort` are undefined — the bytes
@@ -144,10 +146,18 @@ declare type CreatePostCallbackPayload = {
      * via `resumeDeferredUploads`.
      */
     pendingUploads?: Map<string, {
-        blob: File | Blob;
+        blob?: File | Blob;
         promise?: Promise<PostCreationMediaItem | PollPostMediaOptionItem>;
         abort?: () => void;
     }>;
+    /**
+     * Present only for a Blog post sent while a link preview card is still loading.
+     * `payload.htmlBody` has those cards removed; this resolves, within about 5 s, to
+     * the HTML with each card filled from its resolved metadata, and cards that failed
+     * or timed out removed. It never rejects. A host that ignores it saves the link
+     * without a card instead of an empty box.
+     */
+    pendingHtmlBody?: Promise<string>;
 };
 
 export declare interface DraftRehydrateRequestDetail {
@@ -224,6 +234,9 @@ declare enum NewPostType {
     NEW_COMMENT_MEDIA = "new:comment:media"
 }
 
+/** Uids of the media nodes `stripPendingMediaFromJsonBody` removes. */
+export declare function pendingMediaUids(jsonBody: JSONContent_2 | undefined): Set<string>;
+
 declare type PollChoiceItem = PollPostTextOptionItem | PollPostMediaOptionItem;
 
 declare type PollPostMediaOptionItem = BasePollOptionItem & PostCreationMediaItem;
@@ -446,11 +459,12 @@ declare enum SpecialType {
 
 /**
  * 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
+ * did not complete (data-src missing or blob:-prefixed, or data-uid in
+ * `pendingUids` from `pendingMediaUids`). 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;
+export declare function stripPendingMediaFromHtml(html: string | undefined, pendingUids?: ReadonlySet<string>): string | undefined;
 
 /**
  * Walks the editor JSON and removes media nodes whose upload did not complete
@@ -583,7 +597,7 @@ declare module '@tiptap/core' {
              * (`attrs.deferred === true`). Map key = node uid; value = the raw
              * File/Blob for file-kind nodes, which the host persists from
              * `pendingUploads` across the auth redirect. URL-kind deferred nodes are
-             * NOT surfaced via `pendingUploads` (getPendingUpload requires a blob) —
+             * NOT surfaced via `pendingUploads` (no blob and no upload in flight) —
              * their remote URL rides in the doc JSON on `attrs.src`, so the host
              * supplies that string here from the persisted node. Nodes with no entry
              * in the map are deleted (bytes unrecoverable — the host toasts separately).