@comapeo/core-react 3.1.0 → 3.2.0

package/dist/esm/hooks/documents.d.ts

@@ -119,13 +119,23 @@ export declare function useCreateDocument<D extends WriteableDocumentType>({ doc
     docType: D;
     projectId: string;
 }): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<import("../lib/types.js").WriteableDocument<D> & {
         forks: Array<string>;
     }, Error, {
         value: Omit<import("../lib/types.js").WriteableValue<D>, "schemaName">;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<import("../lib/types.js").WriteableDocument<D> & {
+        forks: Array<string>;
+    }, Error, {
+        value: Omit<import("../lib/types.js").WriteableValue<D>, "schemaName">;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Update a document within a project.
@@ -137,6 +147,7 @@ export declare function useUpdateDocument<D extends WriteableDocumentType>({ doc
     docType: D;
     projectId: string;
 }): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<import("../lib/types.js").WriteableDocument<D> & {
         forks: Array<string>;
     }, Error, {
@@ -144,7 +155,17 @@ export declare function useUpdateDocument<D extends WriteableDocumentType>({ doc
         value: Omit<import("../lib/types.js").WriteableValue<D>, "schemaName">;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<import("../lib/types.js").WriteableDocument<D> & {
+        forks: Array<string>;
+    }, Error, {
+        versionId: string;
+        value: Omit<import("../lib/types.js").WriteableValue<D>, "schemaName">;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Delete a document within a project.
@@ -156,12 +177,22 @@ export declare function useDeleteDocument<D extends WriteableDocumentType>({ doc
     docType: D;
     projectId: string;
 }): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<import("../lib/types.js").WriteableDocument<D> & {
+        forks: Array<string>;
+    }, Error, {
+        docId: string;
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<import("../lib/types.js").WriteableDocument<D> & {
         forks: Array<string>;
     }, Error, {
         docId: string;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };
 export {};

package/dist/esm/hooks/documents.js

@@ -140,13 +140,15 @@ export function useManyDocs({ projectId, docType, includeDeleted, lang, }) {
 export function useCreateDocument({ docType, projectId, }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(createDocumentMutationOptions({
+    const { error, mutate, reset, status } = useMutation(createDocumentMutationOptions({
         docType,
         projectApi,
         projectId,
         queryClient,
     }));
-    return { mutate, reset, status };
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Update a document within a project.
@@ -157,13 +159,15 @@ export function useCreateDocument({ docType, projectId, }) {
 export function useUpdateDocument({ docType, projectId, }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(updateDocumentMutationOptions({
+    const { error, mutate, reset, status } = useMutation(updateDocumentMutationOptions({
         docType,
         projectApi,
         projectId,
         queryClient,
     }));
-    return { mutate, reset, status };
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Delete a document within a project.
@@ -174,11 +178,13 @@ export function useUpdateDocument({ docType, projectId, }) {
 export function useDeleteDocument({ docType, projectId, }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(deleteDocumentMutationOptions({
+    const { error, mutate, reset, status } = useMutation(deleteDocumentMutationOptions({
         docType,
         projectApi,
         projectId,
         queryClient,
     }));
-    return { mutate, reset, status };
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }

package/dist/esm/hooks/invites.d.ts

@@ -2,21 +2,37 @@
  * Accept an invite that has been received.
  */
 export declare function useAcceptInvite(): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<string, Error, {
         inviteId: string;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<string, Error, {
+        inviteId: string;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Reject an invite that has been received.
  */
 export declare function useRejectInvite(): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        inviteId: string;
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         inviteId: string;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };
 /**
  * Send an invite for a project.
@@ -26,6 +42,7 @@ export declare function useRejectInvite(): {
 export declare function useSendInvite({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<"ACCEPT" | "REJECT" | "ALREADY", Error, {
         deviceId: string;
         roleDescription?: string;
@@ -33,7 +50,17 @@ export declare function useSendInvite({ projectId }: {
         roleName?: string;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<"ACCEPT" | "REJECT" | "ALREADY", Error, {
+        deviceId: string;
+        roleDescription?: string;
+        roleId: import("@comapeo/core/dist/roles.js").RoleIdForNewInvite;
+        roleName?: string;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Request a cancellation of an invite sent to another device.
@@ -43,9 +70,17 @@ export declare function useSendInvite({ projectId }: {
 export declare function useRequestCancelInvite({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        deviceId: string;
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         deviceId: string;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };

package/dist/esm/hooks/invites.js

@@ -8,8 +8,10 @@ import { useSingleProject } from './projects.js';
 export function useAcceptInvite() {
     const queryClient = useQueryClient();
     const clientApi = useClientApi();
-    const { mutate, status, reset } = useMutation(acceptInviteMutationOptions({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(acceptInviteMutationOptions({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Reject an invite that has been received.
@@ -17,8 +19,10 @@ export function useAcceptInvite() {
 export function useRejectInvite() {
     const queryClient = useQueryClient();
     const clientApi = useClientApi();
-    const { mutate, status, reset } = useMutation(rejectInviteMutationOptions({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(rejectInviteMutationOptions({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Send an invite for a project.
@@ -28,8 +32,10 @@ export function useRejectInvite() {
 export function useSendInvite({ projectId }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, status, reset } = useMutation(sendInviteMutationOptions({ projectApi, projectId, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(sendInviteMutationOptions({ projectApi, projectId, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Request a cancellation of an invite sent to another device.
@@ -39,6 +45,8 @@ export function useSendInvite({ projectId }) {
 export function useRequestCancelInvite({ projectId }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, status, reset } = useMutation(requestCancelInviteMutationOptions({ projectApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(requestCancelInviteMutationOptions({ projectApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }

package/dist/esm/hooks/projects.d.ts

@@ -275,33 +275,59 @@ export declare function useOwnRoleInProject({ projectId }: {
 export declare function useAddServerPeer({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         baseUrl: string;
         dangerouslyAllowInsecureConnections?: boolean;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        baseUrl: string;
+        dangerouslyAllowInsecureConnections?: boolean;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Create a new project.
  */
 export declare function useCreateProject(): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<string, Error, {
         name?: string;
         configPath?: string;
     } | undefined, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<string, Error, {
+        name?: string;
+        configPath?: string;
+    } | undefined, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Leave an existing project.
  */
 export declare function useLeaveProject(): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         projectId: string;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        projectId: string;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Update the configuration of a project using an external file.
@@ -311,11 +337,19 @@ export declare function useLeaveProject(): {
 export declare function useImportProjectConfig({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<Error[], Error, {
+        configPath: string;
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<Error[], Error, {
         configPath: string;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };
 /**
  * Update the settings of a project.
@@ -325,13 +359,23 @@ export declare function useImportProjectConfig({ projectId }: {
 export declare function useUpdateProjectSettings({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<import("@comapeo/core/dist/mapeo-project.js").EditableProjectSettings, Error, {
+        name?: import("@comapeo/schema").ProjectSettings["name"];
+        configMetadata?: import("@comapeo/schema").ProjectSettings["configMetadata"];
+        defaultPresets?: import("@comapeo/schema").ProjectSettings["defaultPresets"];
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<import("@comapeo/core/dist/mapeo-project.js").EditableProjectSettings, Error, {
         name?: import("@comapeo/schema").ProjectSettings["name"];
         configMetadata?: import("@comapeo/schema").ProjectSettings["configMetadata"];
         defaultPresets?: import("@comapeo/schema").ProjectSettings["defaultPresets"];
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };
 /**
  * Create a blob for a project.
@@ -341,6 +385,7 @@ export declare function useUpdateProjectSettings({ projectId }: {
 export declare function useCreateBlob({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<{
         driveId: string;
         name: string;
@@ -353,7 +398,22 @@ export declare function useCreateBlob({ projectId }: {
         metadata: import("@comapeo/core/dist/blob-api.js").Metadata;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<{
+        driveId: string;
+        name: string;
+        type: "photo" | "video" | "audio";
+        hash: string;
+    }, Error, {
+        original: string;
+        preview?: string;
+        thumbnail?: string;
+        metadata: import("@comapeo/core/dist/blob-api.js").Metadata;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Hook to subscribe to the current sync state.
@@ -391,16 +451,30 @@ export declare function useDataSyncProgress({ projectId, }: {
 export declare function useStartSync({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        autostopDataSyncAfter: number | null;
+    } | undefined, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         autostopDataSyncAfter: number | null;
     } | undefined, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };
 export declare function useStopSync({ projectId }: {
     projectId: string;
 }): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, void, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, void, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };

package/dist/esm/hooks/projects.js

@@ -271,8 +271,10 @@ export function useOwnRoleInProject({ projectId }) {
 export function useAddServerPeer({ projectId }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(addServerPeerMutationOptions({ projectApi, projectId, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(addServerPeerMutationOptions({ projectApi, projectId, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Create a new project.
@@ -280,8 +282,10 @@ export function useAddServerPeer({ projectId }) {
 export function useCreateProject() {
     const queryClient = useQueryClient();
     const clientApi = useClientApi();
-    const { mutate, status, reset } = useMutation(createProjectMutationOptions({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(createProjectMutationOptions({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Leave an existing project.
@@ -289,8 +293,10 @@ export function useCreateProject() {
 export function useLeaveProject() {
     const queryClient = useQueryClient();
     const clientApi = useClientApi();
-    const { mutate, status, reset } = useMutation(leaveProjectMutationOptions({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(leaveProjectMutationOptions({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Update the configuration of a project using an external file.
@@ -300,8 +306,10 @@ export function useLeaveProject() {
 export function useImportProjectConfig({ projectId }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, status, reset } = useMutation(importProjectConfigMutationOptions({ queryClient, projectApi, projectId }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(importProjectConfigMutationOptions({ queryClient, projectApi, projectId }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Update the settings of a project.
@@ -311,8 +319,10 @@ export function useImportProjectConfig({ projectId }) {
 export function useUpdateProjectSettings({ projectId }) {
     const queryClient = useQueryClient();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(updateProjectSettingsMutationOptions({ projectApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(updateProjectSettingsMutationOptions({ projectApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Create a blob for a project.
@@ -321,8 +331,10 @@ export function useUpdateProjectSettings({ projectId }) {
  */
 export function useCreateBlob({ projectId }) {
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(createBlobMutationOptions({ projectApi }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(createBlobMutationOptions({ projectApi }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 const PROJECT_SYNC_STORE_MAP = new WeakMap();
 function useSyncStore({ projectId }) {
@@ -372,11 +384,15 @@ export function useDataSyncProgress({ projectId, }) {
 }
 export function useStartSync({ projectId }) {
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(startSyncMutationOptions({ projectApi }));
-    return { mutate, reset, status };
+    const { mutate, reset, status, error } = useMutation(startSyncMutationOptions({ projectApi }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 export function useStopSync({ projectId }) {
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = useMutation(stopSyncMutationOptions({ projectApi }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = useMutation(stopSyncMutationOptions({ projectApi }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }