@comapeo/core-react 3.0.0 → 3.2.0

package/dist/commonjs/hooks/client.d.ts

@@ -61,20 +61,37 @@ export declare function useIsArchiveDevice(): {
  * Update the device info for the current device.
  */
 export declare function useSetOwnDeviceInfo(): {
+    error: Error;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         name: string;
         deviceType: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).DeviceInfo["deviceType"];
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        name: string;
+        deviceType: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).DeviceInfo["deviceType"];
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Set or unset the current device as an archive device.
  */
 export declare function useSetIsArchiveDevice(): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        isArchiveDevice: boolean;
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         isArchiveDevice: boolean;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "pending" | "success" | "idle";
 };

package/dist/commonjs/hooks/client.js

@@ -77,8 +77,10 @@ function useIsArchiveDevice() {
 function useSetOwnDeviceInfo() {
     const queryClient = (0, react_query_1.useQueryClient)();
     const clientApi = useClientApi();
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, client_js_1.setOwnDeviceInfoMutationOptions)({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, client_js_1.setOwnDeviceInfoMutationOptions)({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Set or unset the current device as an archive device.
@@ -86,6 +88,8 @@ function useSetOwnDeviceInfo() {
 function useSetIsArchiveDevice() {
     const queryClient = (0, react_query_1.useQueryClient)();
     const clientApi = useClientApi();
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, client_js_1.setIsArchiveDeviceMutationOptions)({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, status, reset } = (0, react_query_1.useMutation)((0, client_js_1.setIsArchiveDeviceMutationOptions)({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }

package/dist/commonjs/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/commonjs/hooks/documents.js

@@ -148,13 +148,15 @@ function useManyDocs({ projectId, docType, includeDeleted, lang, }) {
 function useCreateDocument({ docType, projectId, }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = (0, projects_js_1.useSingleProject)({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, documents_js_1.createDocumentMutationOptions)({
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, documents_js_1.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.
@@ -165,13 +167,15 @@ function useCreateDocument({ docType, projectId, }) {
 function useUpdateDocument({ docType, projectId, }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = (0, projects_js_1.useSingleProject)({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, documents_js_1.updateDocumentMutationOptions)({
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, documents_js_1.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.
@@ -182,11 +186,13 @@ function useUpdateDocument({ docType, projectId, }) {
 function useDeleteDocument({ docType, projectId, }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = (0, projects_js_1.useSingleProject)({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, documents_js_1.deleteDocumentMutationOptions)({
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, documents_js_1.deleteDocumentMutationOptions)({
         docType,
         projectApi,
         projectId,
         queryClient,
     }));
-    return { mutate, reset, status };
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }

package/dist/commonjs/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", { with: { "resolution-mode": "import" } }).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/commonjs/hooks/invites.js

@@ -14,8 +14,10 @@ const projects_js_1 = require("./projects.js");
 function useAcceptInvite() {
     const queryClient = (0, react_query_1.useQueryClient)();
     const clientApi = (0, client_js_1.useClientApi)();
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, invites_js_1.acceptInviteMutationOptions)({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, invites_js_1.acceptInviteMutationOptions)({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Reject an invite that has been received.
@@ -23,8 +25,10 @@ function useAcceptInvite() {
 function useRejectInvite() {
     const queryClient = (0, react_query_1.useQueryClient)();
     const clientApi = (0, client_js_1.useClientApi)();
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, invites_js_1.rejectInviteMutationOptions)({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, invites_js_1.rejectInviteMutationOptions)({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Send an invite for a project.
@@ -34,8 +38,10 @@ function useRejectInvite() {
 function useSendInvite({ projectId }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = (0, projects_js_1.useSingleProject)({ projectId });
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, invites_js_1.sendInviteMutationOptions)({ projectApi, projectId, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, invites_js_1.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.
@@ -45,6 +51,8 @@ function useSendInvite({ projectId }) {
 function useRequestCancelInvite({ projectId }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = (0, projects_js_1.useSingleProject)({ projectId });
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, invites_js_1.requestCancelInviteMutationOptions)({ projectApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, invites_js_1.requestCancelInviteMutationOptions)({ projectApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }

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

@@ -250,36 +250,84 @@ export declare function useDocumentCreatedBy({ projectId, originalVersionId, }:
     error: Error | null;
     isRefetching: boolean;
 };
+/**
+ * Get the role for the current device in a specified project.
+ * This is a more convenient alternative to using the `useOwnDeviceInfo` and `useManyMembers` hooks.
+ *
+ * @param opts.projectId Project public ID
+ *
+ * @example
+ * ```tsx
+ * function BasicExample() {
+ *   const { data } = useOwnRoleInProject({
+ *     projectId: '...',
+ *   })
+ * }
+ * ```
+ */
+export declare function useOwnRoleInProject({ projectId }: {
+    projectId: string;
+}): {
+    data: import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role<"a12a6702b93bd7ff" | "f7c150f5a3a9a855" | "012fd2d431c0bf60" | "9e6d29263cba36c9" | "8ced989b1904606b" | "08e4251e36f6e7ed">;
+    error: Error | null;
+    isRefetching: boolean;
+};
 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: "error";
+} | {
+    error: null;
     mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
         baseUrl: string;
         dangerouslyAllowInsecureConnections?: boolean;
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    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.
@@ -289,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.
@@ -303,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", { with: { "resolution-mode": "import" } }).EditableProjectSettings, Error, {
         name?: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).ProjectSettings["name"];
         configMetadata?: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).ProjectSettings["configMetadata"];
         defaultPresets?: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).ProjectSettings["defaultPresets"];
     }, unknown>;
     reset: () => void;
-    status: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<import("@comapeo/core/dist/mapeo-project.js", { with: { "resolution-mode": "import" } }).EditableProjectSettings, Error, {
+        name?: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).ProjectSettings["name"];
+        configMetadata?: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).ProjectSettings["configMetadata"];
+        defaultPresets?: import("@comapeo/schema", { with: { "resolution-mode": "import" } }).ProjectSettings["defaultPresets"];
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Create a blob for a project.
@@ -319,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;
@@ -331,7 +398,22 @@ export declare function useCreateBlob({ projectId }: {
         metadata: import("@comapeo/core/dist/blob-api.js", { with: { "resolution-mode": "import" } }).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", { with: { "resolution-mode": "import" } }).Metadata;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
 };
 /**
  * Hook to subscribe to the current sync state.
@@ -369,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: "pending" | "error" | "success" | "idle";
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        autostopDataSyncAfter: number | null;
+    } | undefined, unknown>;
+    reset: () => void;
+    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/commonjs/hooks/projects.js

@@ -8,6 +8,7 @@ exports.useManyMembers = useManyMembers;
 exports.useIconUrl = useIconUrl;
 exports.useAttachmentUrl = useAttachmentUrl;
 exports.useDocumentCreatedBy = useDocumentCreatedBy;
+exports.useOwnRoleInProject = useOwnRoleInProject;
 exports.useAddServerPeer = useAddServerPeer;
 exports.useCreateProject = useCreateProject;
 exports.useLeaveProject = useLeaveProject;
@@ -268,11 +269,33 @@ function useDocumentCreatedBy({ projectId, originalVersionId, }) {
     const { data, error, isRefetching } = (0, react_query_1.useSuspenseQuery)((0, projects_js_1.documentCreatedByQueryOptions)({ projectApi, projectId, originalVersionId }));
     return { data, error, isRefetching };
 }
+/**
+ * Get the role for the current device in a specified project.
+ * This is a more convenient alternative to using the `useOwnDeviceInfo` and `useManyMembers` hooks.
+ *
+ * @param opts.projectId Project public ID
+ *
+ * @example
+ * ```tsx
+ * function BasicExample() {
+ *   const { data } = useOwnRoleInProject({
+ *     projectId: '...',
+ *   })
+ * }
+ * ```
+ */
+function useOwnRoleInProject({ projectId }) {
+    const { data: projectApi } = useSingleProject({ projectId });
+    const { data, error, isRefetching } = (0, react_query_1.useSuspenseQuery)((0, projects_js_1.projectOwnRoleQueryOptions)({ projectApi, projectId }));
+    return { data, error, isRefetching };
+}
 function useAddServerPeer({ projectId }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.addServerPeerMutationOptions)({ projectApi, projectId, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.addServerPeerMutationOptions)({ projectApi, projectId, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Create a new project.
@@ -280,8 +303,10 @@ function useAddServerPeer({ projectId }) {
 function useCreateProject() {
     const queryClient = (0, react_query_1.useQueryClient)();
     const clientApi = (0, client_js_1.useClientApi)();
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, projects_js_1.createProjectMutationOptions)({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.createProjectMutationOptions)({ clientApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Leave an existing project.
@@ -289,8 +314,10 @@ function useCreateProject() {
 function useLeaveProject() {
     const queryClient = (0, react_query_1.useQueryClient)();
     const clientApi = (0, client_js_1.useClientApi)();
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, projects_js_1.leaveProjectMutationOptions)({ clientApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.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 +327,10 @@ function useLeaveProject() {
 function useImportProjectConfig({ projectId }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, status, reset } = (0, react_query_1.useMutation)((0, projects_js_1.importProjectConfigMutationOptions)({ queryClient, projectApi, projectId }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.importProjectConfigMutationOptions)({ queryClient, projectApi, projectId }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Update the settings of a project.
@@ -311,8 +340,10 @@ function useImportProjectConfig({ projectId }) {
 function useUpdateProjectSettings({ projectId }) {
     const queryClient = (0, react_query_1.useQueryClient)();
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.updateProjectSettingsMutationOptions)({ projectApi, queryClient }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.updateProjectSettingsMutationOptions)({ projectApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 /**
  * Create a blob for a project.
@@ -321,8 +352,10 @@ function useUpdateProjectSettings({ projectId }) {
  */
 function useCreateBlob({ projectId }) {
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.createBlobMutationOptions)({ projectApi }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.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 +405,15 @@ function useDataSyncProgress({ projectId, }) {
 }
 function useStartSync({ projectId }) {
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.startSyncMutationOptions)({ projectApi }));
-    return { mutate, reset, status };
+    const { mutate, reset, status, error } = (0, react_query_1.useMutation)((0, projects_js_1.startSyncMutationOptions)({ projectApi }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }
 function useStopSync({ projectId }) {
     const { data: projectApi } = useSingleProject({ projectId });
-    const { mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.stopSyncMutationOptions)({ projectApi }));
-    return { mutate, reset, status };
+    const { error, mutate, reset, status } = (0, react_query_1.useMutation)((0, projects_js_1.stopSyncMutationOptions)({ projectApi }));
+    return status === 'error'
+        ? { error, mutate, reset, status }
+        : { error: null, mutate, reset, status };
 }

package/dist/commonjs/index.d.ts

@@ -3,6 +3,6 @@ export { useClientApi, useIsArchiveDevice, useOwnDeviceInfo, useSetIsArchiveDevi
 export { useCreateDocument, useDeleteDocument, useManyDocs, useSingleDocByDocId, useSingleDocByVersionId, useUpdateDocument, } from './hooks/documents.js';
 export { useAcceptInvite, useRejectInvite, useRequestCancelInvite, useSendInvite, } from './hooks/invites.js';
 export { useMapStyleUrl } from './hooks/maps.js';
-export { useAddServerPeer, useAttachmentUrl, useCreateBlob, useCreateProject, useDataSyncProgress, useDocumentCreatedBy, useIconUrl, useImportProjectConfig, useLeaveProject, useManyMembers, useManyProjects, useProjectSettings, useSingleMember, useSingleProject, useStartSync, useStopSync, useSyncState, useUpdateProjectSettings, } from './hooks/projects.js';
+export { useAddServerPeer, useAttachmentUrl, useCreateBlob, useCreateProject, useDataSyncProgress, useDocumentCreatedBy, useIconUrl, useImportProjectConfig, useLeaveProject, useManyMembers, useManyProjects, useOwnRoleInProject, useProjectSettings, useSingleMember, useSingleProject, useStartSync, useStopSync, useSyncState, useUpdateProjectSettings, } from './hooks/projects.js';
 export { type SyncState } from './lib/sync.js';
 export { type WriteableDocument, type WriteableDocumentType, type WriteableValue, } from './lib/types.js';