@select-org/select-post-builder 1.4.1 → 1.5.0

package/dist/index.d.ts

@@ -41,6 +41,15 @@ declare type AppUserPayload = {
     email?: string;
 };
 
+/**
+ * `rejected` is the token the API just answered 401 to. Resolve a different
+ * token to replay that request once, or the same token or `null` to fail it.
+ * Concurrent 401s each ask, so share one refresh between them.
+ */
+export declare type AuthTokenRequest = {
+    readonly rejected?: string;
+};
+
 declare type BasePollOptionItem = {
     key: string;
     option_id: string;
@@ -135,8 +144,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 +155,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 {
@@ -181,6 +200,12 @@ export declare enum EditorTypes {
  */
 export declare const ensurePollMinimum: (items: PollChoiceItem[]) => PollChoiceItem[];
 
+/**
+ * The host's token source. The post builder calls it before every API request.
+ * Resolve `null` to send the request without credentials.
+ */
+export declare type GetAuthToken = (request: AuthTokenRequest) => Promise<string | null>;
+
 declare interface ImageInfo {
     width: number;
     height: number;
@@ -224,6 +249,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;
@@ -246,7 +274,10 @@ export declare interface PostBuilderConfig {
         mfs: string;
         fileStore: string;
     };
-    authToken: string;
+    /** Ignored when `getAuthToken` is given. */
+    authToken?: string;
+    /** A new function takes effect on the next request, without remounting editors. */
+    getAuthToken?: GetAuthToken;
     toI18N: (key: string) => string;
     i18nKeys?: Partial<PostBuilderI18nKeys>;
     logEvent: (name: string, properties: Record<string, unknown>) => void;
@@ -382,7 +413,7 @@ declare interface PostBuilderI18nKeys {
     uploadsInProgressKey: string;
 }
 
-export declare const PostBuilderProvider: ({ children, apiBaseURL, authToken, toI18N, i18nKeys, logEvent, allowSendWhileUploading, unauthenticatedMode, }: PostBuilderConfig) => JSX_2.Element;
+export declare const PostBuilderProvider: ({ children, apiBaseURL, authToken, getAuthToken, toI18N, i18nKeys, logEvent, allowSendWhileUploading, unauthenticatedMode, }: PostBuilderConfig) => JSX_2.Element;
 
 declare type PostCreationData = {
     body: string;
@@ -446,11 +477,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 +615,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).

package/dist/post-builder.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-BQv-TaVA.js");require("react");exports.EditorPlacement=e.EditorPlacement;exports.EditorTypes=e.EditorTypes;exports.PostBuilderEditor=e.PostBuilderEditor;exports.PostBuilderEvents=e.PostBuilderEvents;exports.PostBuilderProvider=e.PostBuilderProvider;exports.applyResolvedMediaItem=e.applyResolvedMediaItem;exports.applyResolvedMediaItemToHtml=e.applyResolvedMediaItemToHtml;exports.ensurePollMinimum=e.ensurePollMinimum;exports.stripPendingMediaFromHtml=e.stripPendingMediaFromHtml;exports.stripPendingMediaFromJsonBody=e.stripPendingMediaFromJsonBody;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("./index-8pZEwyr_.js");require("react");exports.EditorPlacement=e.EditorPlacement;exports.EditorTypes=e.EditorTypes;exports.PostBuilderEditor=e.PostBuilderEditor;exports.PostBuilderEvents=e.PostBuilderEvents;exports.PostBuilderProvider=e.PostBuilderProvider;exports.applyResolvedMediaItem=e.applyResolvedMediaItem;exports.applyResolvedMediaItemToHtml=e.applyResolvedMediaItemToHtml;exports.ensurePollMinimum=e.ensurePollMinimum;exports.pendingMediaUids=e.pendingMediaUids;exports.stripPendingMediaFromHtml=e.stripPendingMediaFromHtml;exports.stripPendingMediaFromJsonBody=e.stripPendingMediaFromJsonBody;

package/dist/post-builder.js

@@ -1,14 +1,15 @@
-import { E as i, a as o, P as d, b as r, c as t, d as l, e as m, f as n, s as p, h as P } from "./index-C2R4ewDG.mjs";
+import { E as a, a as d, P as o, b as r, c as t, d as l, e as m, f as n, p, s as P, h as M } from "./index-D7pfEQso.mjs";
 import "react";
 export {
-  i as EditorPlacement,
-  o as EditorTypes,
-  d as PostBuilderEditor,
+  a as EditorPlacement,
+  d as EditorTypes,
+  o as PostBuilderEditor,
   r as PostBuilderEvents,
   t as PostBuilderProvider,
   l as applyResolvedMediaItem,
   m as applyResolvedMediaItemToHtml,
   n as ensurePollMinimum,
-  p as stripPendingMediaFromHtml,
-  P as stripPendingMediaFromJsonBody
+  p as pendingMediaUids,
+  P as stripPendingMediaFromHtml,
+  M as stripPendingMediaFromJsonBody
 };