@postrun/react 1.1.0 → 1.3.0

package/README.md

@@ -104,9 +104,11 @@ returns the same `{ state, start, prepare, select, reset }` — `<Connect>` is j
 a thin render-prop wrapper over it. The hosted `/connect` page remains available
 as a no-SDK fallback (link to the `hosted_connect_url` from a `POST .../connect`).
 
-`onConnected` also auto-refetches your `useConnections` list, so the new account
-shows up with no manual refetch. Pass `onError(reason)` / `onCancelled()` if you'd
-rather react with callbacks than read `state.phase`.
+A successful connect auto-refetches your `useConnections` list, so the new account
+shows up with no manual refetch. Prefer callbacks to reading `state.phase`? Use
+`onSuccess()` (fires on success — `active` **or** `connected_pending`, ideal for
+"close the dialog"), `onConnected(connection)` (only `active`, hands you the bound
+connection), `onError(reason)`, and `onCancelled()`.
 
 **Multi-platform picker?** A session is pre-minted on mount, which is ideal for a
 dedicated button but would mint one per platform in a "pick a network" list. Set

package/dist/index.cjs

@@ -315,6 +315,7 @@ function useConnect({
   profileId,
   platform,
   onConnected,
+  onSuccess,
   onError,
   onCancelled,
   prepareOnMount = true
@@ -329,10 +330,12 @@ function useConnect({
   const preparingRef = react.useRef(false);
   const prepareGenRef = react.useRef(0);
   const onConnectedRef = react.useRef(onConnected);
+  const onSuccessRef = react.useRef(onSuccess);
   const onErrorRef = react.useRef(onError);
   const onCancelledRef = react.useRef(onCancelled);
   react.useEffect(() => {
     onConnectedRef.current = onConnected;
+    onSuccessRef.current = onSuccess;
     onErrorRef.current = onError;
     onCancelledRef.current = onCancelled;
   });
@@ -455,10 +458,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" });
@@ -553,6 +558,7 @@ function Connect({
   profileId,
   platform,
   onConnected,
+  onSuccess,
   onError,
   onCancelled,
   prepareOnMount,
@@ -562,6 +568,7 @@ function Connect({
     profileId,
     platform,
     onConnected,
+    onSuccess,
     onError,
     onCancelled,
     prepareOnMount
@@ -894,6 +901,37 @@ function useCreatePost(profileId) {
     connectedChannels: connected.map((connection) => connection.platform).filter(js.isPostPlatform)
   };
 }
+function useValidatePost(profileId) {
+  const { client, queryClient } = usePostrun();
+  const connections = useConnections(profileId);
+  const connected = connections.data?.data ?? [];
+  const mutation = reactQuery.useMutation(
+    {
+      mutationFn: async (input) => (await js.postsValidate({
+        client,
+        body: js.buildCreatePost({ ...input, profileId }, connected)
+      })).data
+    },
+    queryClient
+  );
+  const { mutateAsync } = mutation;
+  const validate = react.useCallback(
+    (input) => mutateAsync(input),
+    [mutateAsync]
+  );
+  const issues = mutation.data?.issues ?? [];
+  return {
+    validate,
+    // The server's verdict (undefined until the first call resolves).
+    publishable: mutation.data?.publishable,
+    issues,
+    isPending: mutation.isPending,
+    error: mutation.error,
+    // Connections must load before `validate` can resolve a channel.
+    isReady: connections.isSuccess,
+    connectedChannels: connected.map((connection) => connection.platform).filter(js.isPostPlatform)
+  };
+}
 function useUpdatePost(postId) {
   const { client, queryClient } = usePostrun();
   return reactQuery.useMutation(
@@ -1671,5 +1709,6 @@ exports.useSelectAccount = useSelectAccount;
 exports.useUpdateMedia = useUpdateMedia;
 exports.useUpdatePost = useUpdatePost;
 exports.useUpdateProfile = useUpdateProfile;
+exports.useValidatePost = useValidatePost;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map