@postrun/react 1.1.0 → 1.2.0

package/dist/index.d.cts

@@ -341,6 +341,11 @@ interface UseConnectParams {
     /** Called once a connection is fully ACTIVE (an account is bound). The
      * connections list is auto-refetched too, so you rarely need to act here. */
     onConnected?: (connection: Connection) => void;
+    /** Called when the connect SUCCEEDS — `active` OR `connected_pending` (the
+     * grant landed but the account binds out-of-band / via a slow webhook). Use
+     * this to close your UI and let the auto-refetched list show the result;
+     * `onConnected` additionally hands you the bound connection on `active`. */
+    onSuccess?: () => void;
     /** Called when the attempt fails, with the typed reason. */
     onError?: (reason: ConnectErrorReason) => void;
     /** Called when the user closes the OAuth popup without finishing. The hook
@@ -419,7 +424,7 @@ interface UseConnectResult {
  * The hosted `/connect` page remains the fallback for callers NOT using this SDK
  * (a plain link to `hosted_connect_url`); this hook never redirects.
  */
-declare function useConnect({ profileId, platform, onConnected, onError, onCancelled, prepareOnMount, }: UseConnectParams): UseConnectResult;
+declare function useConnect({ profileId, platform, onConnected, onSuccess, onError, onCancelled, prepareOnMount, }: UseConnectParams): UseConnectResult;
 /**
  * List a profile's connected accounts. Pass a `filter` to narrow by `kind`
  * (`posting` = social, `ads`) or `status` — e.g. a composer fetches
@@ -539,6 +544,8 @@ interface ConnectProps {
     platform: ConnectablePlatform;
     /** Called once a connection is fully ACTIVE (an account is bound). */
     onConnected?: (connection: Connection) => void;
+    /** Called when the connect succeeds — `active` OR `connected_pending`. */
+    onSuccess?: () => void;
     /** Called when the attempt fails, with the typed reason. */
     onError?: (reason: ConnectErrorReason) => void;
     /** Called when the user closes the OAuth popup without finishing. */
@@ -580,7 +587,7 @@ interface ConnectProps {
  * The trigger MUST call `start()` directly in the click (it opens the popup
  * synchronously). Mount `<Connect>` inside a `<PostrunProvider>`.
  */
-declare function Connect({ profileId, platform, onConnected, onError, onCancelled, prepareOnMount, children, }: ConnectProps): ReactNode;
+declare function Connect({ profileId, platform, onConnected, onSuccess, onError, onCancelled, prepareOnMount, children, }: ConnectProps): ReactNode;
 
 type MediaUploadStatus = 'idle' | 'uploading' | 'processing' | 'ready' | 'failed';
 interface MediaUploadOptions {

package/dist/index.d.ts

@@ -341,6 +341,11 @@ interface UseConnectParams {
     /** Called once a connection is fully ACTIVE (an account is bound). The
      * connections list is auto-refetched too, so you rarely need to act here. */
     onConnected?: (connection: Connection) => void;
+    /** Called when the connect SUCCEEDS — `active` OR `connected_pending` (the
+     * grant landed but the account binds out-of-band / via a slow webhook). Use
+     * this to close your UI and let the auto-refetched list show the result;
+     * `onConnected` additionally hands you the bound connection on `active`. */
+    onSuccess?: () => void;
     /** Called when the attempt fails, with the typed reason. */
     onError?: (reason: ConnectErrorReason) => void;
     /** Called when the user closes the OAuth popup without finishing. The hook
@@ -419,7 +424,7 @@ interface UseConnectResult {
  * The hosted `/connect` page remains the fallback for callers NOT using this SDK
  * (a plain link to `hosted_connect_url`); this hook never redirects.
  */
-declare function useConnect({ profileId, platform, onConnected, onError, onCancelled, prepareOnMount, }: UseConnectParams): UseConnectResult;
+declare function useConnect({ profileId, platform, onConnected, onSuccess, onError, onCancelled, prepareOnMount, }: UseConnectParams): UseConnectResult;
 /**
  * List a profile's connected accounts. Pass a `filter` to narrow by `kind`
  * (`posting` = social, `ads`) or `status` — e.g. a composer fetches
@@ -539,6 +544,8 @@ interface ConnectProps {
     platform: ConnectablePlatform;
     /** Called once a connection is fully ACTIVE (an account is bound). */
     onConnected?: (connection: Connection) => void;
+    /** Called when the connect succeeds — `active` OR `connected_pending`. */
+    onSuccess?: () => void;
     /** Called when the attempt fails, with the typed reason. */
     onError?: (reason: ConnectErrorReason) => void;
     /** Called when the user closes the OAuth popup without finishing. */
@@ -580,7 +587,7 @@ interface ConnectProps {
  * The trigger MUST call `start()` directly in the click (it opens the popup
  * synchronously). Mount `<Connect>` inside a `<PostrunProvider>`.
  */
-declare function Connect({ profileId, platform, onConnected, onError, onCancelled, prepareOnMount, children, }: ConnectProps): ReactNode;
+declare function Connect({ profileId, platform, onConnected, onSuccess, onError, onCancelled, prepareOnMount, children, }: ConnectProps): ReactNode;
 
 type MediaUploadStatus = 'idle' | 'uploading' | 'processing' | 'ready' | 'failed';
 interface MediaUploadOptions {

package/dist/index.js

@@ -304,6 +304,7 @@ function useConnect({
   profileId,
   platform,
   onConnected,
+  onSuccess,
   onError,
   onCancelled,
   prepareOnMount = true
@@ -318,10 +319,12 @@ function useConnect({
   const preparingRef = useRef(false);
   const prepareGenRef = useRef(0);
   const onConnectedRef = useRef(onConnected);
+  const onSuccessRef = useRef(onSuccess);
   const onErrorRef = useRef(onError);
   const onCancelledRef = useRef(onCancelled);
   useEffect(() => {
     onConnectedRef.current = onConnected;
+    onSuccessRef.current = onSuccess;
     onErrorRef.current = onError;
     onCancelledRef.current = onCancelled;
   });
@@ -444,10 +447,12 @@ function useConnect({
           setState({ phase: "active", connection: outcome.connection });
           void queryClient.invalidateQueries({ queryKey: connectionKeys.lists() });
           onConnectedRef.current?.(outcome.connection);
+          onSuccessRef.current?.();
           return;
         case "connected_pending":
           setState({ phase: "connected_pending" });
           void queryClient.invalidateQueries({ queryKey: connectionKeys.lists() });
+          onSuccessRef.current?.();
           return;
         case "cancelled":
           setState({ phase: "cancelled" });
@@ -542,6 +547,7 @@ function Connect({
   profileId,
   platform,
   onConnected,
+  onSuccess,
   onError,
   onCancelled,
   prepareOnMount,
@@ -551,6 +557,7 @@ function Connect({
     profileId,
     platform,
     onConnected,
+    onSuccess,
     onError,
     onCancelled,
     prepareOnMount