@comapeo/core-react 6.4.0 → 7.1.0

package/dist/commonjs/lib/react-query/projects.d.ts

@@ -79,11 +79,19 @@ export declare function projectMemberByIdQueryOptions({ projectApi, projectId, d
 export declare function projectOwnRoleQueryOptions({ projectApi, projectId, }: {
     projectApi: MapeoProjectApi;
     projectId: string;
-}): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role<"a12a6702b93bd7ff" | "f7c150f5a3a9a855" | "012fd2d431c0bf60" | "9e6d29263cba36c9" | "8ced989b1904606b" | "08e4251e36f6e7ed">, Error, import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role<"a12a6702b93bd7ff" | "f7c150f5a3a9a855" | "012fd2d431c0bf60" | "9e6d29263cba36c9" | "8ced989b1904606b" | "08e4251e36f6e7ed">, readonly ["@comapeo/core-react", "projects", string, "role"]>, "queryFn"> & {
-    queryFn?: import("@tanstack/react-query").QueryFunction<import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role<"a12a6702b93bd7ff" | "f7c150f5a3a9a855" | "012fd2d431c0bf60" | "9e6d29263cba36c9" | "8ced989b1904606b" | "08e4251e36f6e7ed">, readonly ["@comapeo/core-react", "projects", string, "role"], never> | undefined;
+}): import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role & {
+    reason: string | undefined;
+}, Error, import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role & {
+    reason: string | undefined;
+}, readonly ["@comapeo/core-react", "projects", string, "role"]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role & {
+        reason: string | undefined;
+    }, readonly ["@comapeo/core-react", "projects", string, "role"], never> | undefined;
 } & {
     queryKey: readonly ["@comapeo/core-react", "projects", string, "role"] & {
-        [dataTagSymbol]: import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role<"a12a6702b93bd7ff" | "f7c150f5a3a9a855" | "012fd2d431c0bf60" | "9e6d29263cba36c9" | "8ced989b1904606b" | "08e4251e36f6e7ed">;
+        [dataTagSymbol]: import("@comapeo/core/dist/roles.js", { with: { "resolution-mode": "import" } }).Role & {
+            reason: string | undefined;
+        };
         [dataTagErrorSymbol]: Error;
     };
 };
@@ -158,6 +166,18 @@ export declare function leaveProjectMutationOptions({ clientApi, queryClient, }:
     networkMode: "always";
     retry: false;
 };
+export declare function importProjectCategoriesMutationOptions({ projectApi, projectId, queryClient, }: {
+    projectApi: MapeoProjectApi;
+    projectId: string;
+    queryClient: QueryClient;
+}): {
+    mutationFn: ({ filePath }: {
+        filePath: string;
+    }) => Promise<void>;
+    onSuccess: () => void;
+    networkMode: "always";
+    retry: false;
+};
 export declare function importProjectConfigMutationOptions({ projectApi, projectId, queryClient, }: {
     projectApi: MapeoProjectApi;
     projectId: string;
@@ -192,6 +212,19 @@ export declare function changeMemberRoleMutationOptions({ projectApi, projectId,
     networkMode: "always";
     retry: false;
 };
+export declare function removeProjectMemberMutationOptions({ projectApi, projectId, queryClient, }: {
+    projectApi: MapeoProjectApi;
+    projectId: string;
+    queryClient: QueryClient;
+}): {
+    mutationFn: ({ deviceId, reason }: {
+        deviceId: string;
+        reason?: string;
+    }) => Promise<void>;
+    onSuccess: () => void;
+    networkMode: "always";
+    retry: false;
+};
 export declare function createBlobMutationOptions({ projectApi, }: {
     projectApi: MapeoProjectApi;
 }): {

package/dist/commonjs/lib/react-query/projects.js

@@ -20,9 +20,11 @@ exports.addServerPeerMutationOptions = addServerPeerMutationOptions;
 exports.removeServerPeerMutationOptions = removeServerPeerMutationOptions;
 exports.createProjectMutationOptions = createProjectMutationOptions;
 exports.leaveProjectMutationOptions = leaveProjectMutationOptions;
+exports.importProjectCategoriesMutationOptions = importProjectCategoriesMutationOptions;
 exports.importProjectConfigMutationOptions = importProjectConfigMutationOptions;
 exports.updateProjectSettingsMutationOptions = updateProjectSettingsMutationOptions;
 exports.changeMemberRoleMutationOptions = changeMemberRoleMutationOptions;
+exports.removeProjectMemberMutationOptions = removeProjectMemberMutationOptions;
 exports.createBlobMutationOptions = createBlobMutationOptions;
 exports.startSyncMutationOptions = startSyncMutationOptions;
 exports.stopSyncMutationOptions = stopSyncMutationOptions;
@@ -222,6 +224,19 @@ function leaveProjectMutationOptions({ clientApi, queryClient, }) {
         },
     };
 }
+function importProjectCategoriesMutationOptions({ projectApi, projectId, queryClient, }) {
+    return {
+        ...(0, shared_js_1.baseMutationOptions)(),
+        mutationFn: ({ filePath }) => {
+            return projectApi.$importCategories({ filePath });
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: getProjectByIdQueryKey({ projectId }),
+            });
+        },
+    };
+}
 function importProjectConfigMutationOptions({ projectApi, projectId, queryClient, }) {
     return {
         ...(0, shared_js_1.baseMutationOptions)(),
@@ -264,6 +279,23 @@ function changeMemberRoleMutationOptions({ projectApi, projectId, queryClient, }
         },
     };
 }
+function removeProjectMemberMutationOptions({ projectApi, projectId, queryClient, }) {
+    return {
+        ...(0, shared_js_1.baseMutationOptions)(),
+        mutationFn: async ({ deviceId, reason }) => {
+            // Have to avoid passing `undefined` explicitly
+            // See https://github.com/digidem/rpc-reflector/issues/21
+            return reason
+                ? projectApi.$member.remove(deviceId, { reason })
+                : projectApi.$member.remove(deviceId);
+        },
+        onSuccess: () => {
+            queryClient.invalidateQueries({
+                queryKey: getMembersQueryKey({ projectId }),
+            });
+        },
+    };
+}
 function createBlobMutationOptions({ projectApi, }) {
     return {
         ...(0, shared_js_1.baseMutationOptions)(),

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

@@ -31,7 +31,7 @@ export declare function useSingleDocByDocId<D extends WriteableDocumentType>({ p
 }): {
     data: Extract<({
         schemaName: "track";
-        locations: import("@comapeo/schema/dist/schema/track.js").Position[];
+        locations: [import("@comapeo/schema/dist/schema/track.js").Position, import("@comapeo/schema/dist/schema/track.js").Position, ...import("@comapeo/schema/dist/schema/track.js").Position[]];
         observationRefs: {
             docId: string;
             versionId: string;
@@ -51,28 +51,14 @@ export declare function useSingleDocByDocId<D extends WriteableDocumentType>({ p
         links: string[];
         deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
-        schemaName: "observation";
-        lat?: number | undefined;
-        lon?: number | undefined;
-        attachments: import("@comapeo/schema/dist/schema/observation.js").Attachment[];
-        tags: {
+        schemaName: "remoteDetectionAlert";
+        detectionDateStart: string;
+        detectionDateEnd: string;
+        sourceId: string;
+        metadata: {
             [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
         };
-        metadata?: {
-            manualLocation?: boolean;
-            position?: import("@comapeo/schema/dist/schema/observation.js").Position;
-            lastSavedPosition?: import("@comapeo/schema/dist/schema/observation.js").Position;
-            positionProvider?: {
-                gpsAvailable?: boolean;
-                passiveAvailable?: boolean;
-                locationServicesEnabled: boolean;
-                networkAvailable?: boolean;
-            };
-        } | undefined;
-        presetRef?: {
-            docId: string;
-            versionId: string;
-        } | undefined;
+        geometry: import("@comapeo/schema/dist/schema/remoteDetectionAlert.js").Geometry;
         docId: string;
         versionId: string;
         originalVersionId: string;
@@ -104,6 +90,36 @@ export declare function useSingleDocByDocId<D extends WriteableDocumentType>({ p
         updatedAt: string;
         links: string[];
         deleted: boolean;
+    } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
+        schemaName: "observation";
+        lat?: number | undefined;
+        lon?: number | undefined;
+        attachments: import("@comapeo/schema/dist/schema/observation.js").Attachment[];
+        tags: {
+            [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
+        };
+        metadata?: {
+            manualLocation?: boolean;
+            position?: import("@comapeo/schema/dist/schema/observation.js").Position;
+            lastSavedPosition?: import("@comapeo/schema/dist/schema/observation.js").Position;
+            positionProvider?: {
+                gpsAvailable?: boolean;
+                passiveAvailable?: boolean;
+                locationServicesEnabled: boolean;
+                networkAvailable?: boolean;
+            };
+        } | undefined;
+        presetRef?: {
+            docId: string;
+            versionId: string;
+        } | undefined;
+        docId: string;
+        versionId: string;
+        originalVersionId: string;
+        createdAt: string;
+        updatedAt: string;
+        links: string[];
+        deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
         schemaName: "field";
         tagKey: string;
@@ -125,22 +141,6 @@ export declare function useSingleDocByDocId<D extends WriteableDocumentType>({ p
         updatedAt: string;
         links: string[];
         deleted: boolean;
-    } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
-        schemaName: "remoteDetectionAlert";
-        detectionDateStart: string;
-        detectionDateEnd: string;
-        sourceId: string;
-        metadata: {
-            [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
-        };
-        geometry: import("@comapeo/schema/dist/schema/remoteDetectionAlert.js").Geometry;
-        docId: string;
-        versionId: string;
-        originalVersionId: string;
-        createdAt: string;
-        updatedAt: string;
-        links: string[];
-        deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields), {
         schemaName: D;
     }>;
@@ -178,7 +178,7 @@ export declare function useSingleDocByVersionId<D extends WriteableDocumentType>
 }): {
     data: Extract<({
         schemaName: "track";
-        locations: import("@comapeo/schema/dist/schema/track.js").Position[];
+        locations: [import("@comapeo/schema/dist/schema/track.js").Position, import("@comapeo/schema/dist/schema/track.js").Position, ...import("@comapeo/schema/dist/schema/track.js").Position[]];
         observationRefs: {
             docId: string;
             versionId: string;
@@ -198,28 +198,14 @@ export declare function useSingleDocByVersionId<D extends WriteableDocumentType>
         links: string[];
         deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
-        schemaName: "observation";
-        lat?: number | undefined;
-        lon?: number | undefined;
-        attachments: import("@comapeo/schema/dist/schema/observation.js").Attachment[];
-        tags: {
+        schemaName: "remoteDetectionAlert";
+        detectionDateStart: string;
+        detectionDateEnd: string;
+        sourceId: string;
+        metadata: {
             [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
         };
-        metadata?: {
-            manualLocation?: boolean;
-            position?: import("@comapeo/schema/dist/schema/observation.js").Position;
-            lastSavedPosition?: import("@comapeo/schema/dist/schema/observation.js").Position;
-            positionProvider?: {
-                gpsAvailable?: boolean;
-                passiveAvailable?: boolean;
-                locationServicesEnabled: boolean;
-                networkAvailable?: boolean;
-            };
-        } | undefined;
-        presetRef?: {
-            docId: string;
-            versionId: string;
-        } | undefined;
+        geometry: import("@comapeo/schema/dist/schema/remoteDetectionAlert.js").Geometry;
         docId: string;
         versionId: string;
         originalVersionId: string;
@@ -251,6 +237,36 @@ export declare function useSingleDocByVersionId<D extends WriteableDocumentType>
         updatedAt: string;
         links: string[];
         deleted: boolean;
+    } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
+        schemaName: "observation";
+        lat?: number | undefined;
+        lon?: number | undefined;
+        attachments: import("@comapeo/schema/dist/schema/observation.js").Attachment[];
+        tags: {
+            [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
+        };
+        metadata?: {
+            manualLocation?: boolean;
+            position?: import("@comapeo/schema/dist/schema/observation.js").Position;
+            lastSavedPosition?: import("@comapeo/schema/dist/schema/observation.js").Position;
+            positionProvider?: {
+                gpsAvailable?: boolean;
+                passiveAvailable?: boolean;
+                locationServicesEnabled: boolean;
+                networkAvailable?: boolean;
+            };
+        } | undefined;
+        presetRef?: {
+            docId: string;
+            versionId: string;
+        } | undefined;
+        docId: string;
+        versionId: string;
+        originalVersionId: string;
+        createdAt: string;
+        updatedAt: string;
+        links: string[];
+        deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
         schemaName: "field";
         tagKey: string;
@@ -272,22 +288,6 @@ export declare function useSingleDocByVersionId<D extends WriteableDocumentType>
         updatedAt: string;
         links: string[];
         deleted: boolean;
-    } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields) | ({
-        schemaName: "remoteDetectionAlert";
-        detectionDateStart: string;
-        detectionDateEnd: string;
-        sourceId: string;
-        metadata: {
-            [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
-        };
-        geometry: import("@comapeo/schema/dist/schema/remoteDetectionAlert.js").Geometry;
-        docId: string;
-        versionId: string;
-        originalVersionId: string;
-        createdAt: string;
-        updatedAt: string;
-        links: string[];
-        deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields), {
         schemaName: D;
     }>;
@@ -336,7 +336,7 @@ export declare function useManyDocs<D extends WriteableDocumentType>({ projectId
 }): {
     data: Extract<({
         schemaName: "track";
-        locations: import("@comapeo/schema/dist/schema/track.js").Position[];
+        locations: [import("@comapeo/schema/dist/schema/track.js").Position, import("@comapeo/schema/dist/schema/track.js").Position, ...import("@comapeo/schema/dist/schema/track.js").Position[]];
         observationRefs: {
             docId: string;
             versionId: string;
@@ -356,28 +356,14 @@ export declare function useManyDocs<D extends WriteableDocumentType>({ projectId
         links: string[];
         deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields)[] | ({
-        schemaName: "observation";
-        lat?: number | undefined;
-        lon?: number | undefined;
-        attachments: import("@comapeo/schema/dist/schema/observation.js").Attachment[];
-        tags: {
+        schemaName: "remoteDetectionAlert";
+        detectionDateStart: string;
+        detectionDateEnd: string;
+        sourceId: string;
+        metadata: {
             [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
         };
-        metadata?: {
-            manualLocation?: boolean;
-            position?: import("@comapeo/schema/dist/schema/observation.js").Position;
-            lastSavedPosition?: import("@comapeo/schema/dist/schema/observation.js").Position;
-            positionProvider?: {
-                gpsAvailable?: boolean;
-                passiveAvailable?: boolean;
-                locationServicesEnabled: boolean;
-                networkAvailable?: boolean;
-            };
-        } | undefined;
-        presetRef?: {
-            docId: string;
-            versionId: string;
-        } | undefined;
+        geometry: import("@comapeo/schema/dist/schema/remoteDetectionAlert.js").Geometry;
         docId: string;
         versionId: string;
         originalVersionId: string;
@@ -409,6 +395,36 @@ export declare function useManyDocs<D extends WriteableDocumentType>({ projectId
         updatedAt: string;
         links: string[];
         deleted: boolean;
+    } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields)[] | ({
+        schemaName: "observation";
+        lat?: number | undefined;
+        lon?: number | undefined;
+        attachments: import("@comapeo/schema/dist/schema/observation.js").Attachment[];
+        tags: {
+            [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
+        };
+        metadata?: {
+            manualLocation?: boolean;
+            position?: import("@comapeo/schema/dist/schema/observation.js").Position;
+            lastSavedPosition?: import("@comapeo/schema/dist/schema/observation.js").Position;
+            positionProvider?: {
+                gpsAvailable?: boolean;
+                passiveAvailable?: boolean;
+                locationServicesEnabled: boolean;
+                networkAvailable?: boolean;
+            };
+        } | undefined;
+        presetRef?: {
+            docId: string;
+            versionId: string;
+        } | undefined;
+        docId: string;
+        versionId: string;
+        originalVersionId: string;
+        createdAt: string;
+        updatedAt: string;
+        links: string[];
+        deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields)[] | ({
         schemaName: "field";
         tagKey: string;
@@ -430,22 +446,6 @@ export declare function useManyDocs<D extends WriteableDocumentType>({ projectId
         updatedAt: string;
         links: string[];
         deleted: boolean;
-    } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields)[] | ({
-        schemaName: "remoteDetectionAlert";
-        detectionDateStart: string;
-        detectionDateEnd: string;
-        sourceId: string;
-        metadata: {
-            [k: string]: boolean | number | string | null | (boolean | number | string | null)[];
-        };
-        geometry: import("@comapeo/schema/dist/schema/remoteDetectionAlert.js").Geometry;
-        docId: string;
-        versionId: string;
-        originalVersionId: string;
-        createdAt: string;
-        updatedAt: string;
-        links: string[];
-        deleted: boolean;
     } & import("@comapeo/core/dist/datatype/index.js").DerivedDocFields)[], Array<{
         schemaName: D;
     }>>;

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

@@ -250,7 +250,9 @@ export declare function useDocumentCreatedBy({ projectId, originalVersionId, }:
 export declare function useOwnRoleInProject({ projectId }: {
     projectId: string;
 }): {
-    data: import("@comapeo/core/dist/roles.js").Role<"a12a6702b93bd7ff" | "f7c150f5a3a9a855" | "012fd2d431c0bf60" | "9e6d29263cba36c9" | "8ced989b1904606b" | "08e4251e36f6e7ed">;
+    data: import("@comapeo/core/dist/roles.js").Role & {
+        reason: string | undefined;
+    };
     error: Error | null;
     isRefetching: boolean;
 };
@@ -360,9 +362,38 @@ export declare function useLeaveProject(): {
     reset: () => void;
     status: "pending" | "success" | "idle";
 };
+/**
+ * Update the categories of a project using an external file.
+ *
+ * @param opts.projectId Public ID of the project to apply changes to.
+ */
+export declare function useImportProjectCategories({ projectId, }: {
+    projectId: string;
+}): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        filePath: string;
+    }, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, {
+        filePath: string;
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        filePath: string;
+    }, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, {
+        filePath: string;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
+};
 /**
  * Update the configuration of a project using an external file.
  *
+ * @deprecated Use `useImportProjectCategories` instead.
  * @param opts.projectId Public ID of the project to apply changes to.
  */
 export declare function useImportProjectConfig({ projectId }: {
@@ -449,6 +480,67 @@ export declare function useChangeMemberRole({ projectId }: {
     reset: () => void;
     status: "pending" | "success" | "idle";
 };
+/**
+ * Remove a member from a project, providing an optional reason for removal.
+ *
+ * Do NOT use this for removing your own device from a project. Use `useLeaveProject` instead.
+ *
+ * @param opts.projectId Project public ID
+ *
+ * @example
+ * ```tsx
+ * function BasicExample() {
+ *   const { mutate } = useRemoveMember({ projectId: '...' })
+ *   mutate({
+ *     deviceId: '...',
+ *     // Optional
+ *     reason: '...',
+ *   })
+ * }
+ * ```
+ */
+export declare function useRemoveMember({ projectId }: {
+    projectId: string;
+}): {
+    error: Error;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        deviceId: string;
+        reason?: string;
+    }, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, {
+        deviceId: string;
+        reason?: string;
+    }, unknown>;
+    reset: () => void;
+    status: "error";
+} | {
+    error: null;
+    mutate: import("@tanstack/react-query").UseMutateFunction<void, Error, {
+        deviceId: string;
+        reason?: string;
+    }, unknown>;
+    mutateAsync: import("@tanstack/react-query").UseMutateAsyncFunction<void, Error, {
+        deviceId: string;
+        reason?: string;
+    }, unknown>;
+    reset: () => void;
+    status: "pending" | "success" | "idle";
+};
+/**
+ * Set up listener for changes to your own role in a project.
+ * It is necessary to use this if you want the project role-related read hooks to update
+ * based on role change events that are received in the background.
+ *
+ * @example
+ * ```tsx
+ * function SomeComponent({ projectId }: { projectId: string }) {
+ *   useProjectOwnRoleChangeListener({ projectId })
+ * }
+ * ```
+ */
+export declare function useProjectOwnRoleChangeListener({ projectId, }: {
+    projectId: string;
+}): void;
 /**
  * Create a blob for a project.
  *

package/dist/esm/hooks/projects.js

@@ -1,6 +1,6 @@
 import { useMutation, useQueryClient, useSuspenseQuery, } from '@tanstack/react-query';
-import { useSyncExternalStore } from 'react';
-import { addServerPeerMutationOptions, changeMemberRoleMutationOptions, connectSyncServersMutationOptions, createBlobMutationOptions, createProjectMutationOptions, disconnectSyncServersMutationOptions, documentCreatedByQueryOptions, exportGeoJSONMutationOptions, exportZipFileMutationOptions, importProjectConfigMutationOptions, leaveProjectMutationOptions, mediaServerOriginQueryOptions, projectByIdQueryOptions, projectMemberByIdQueryOptions, projectMembersQueryOptions, projectOwnRoleQueryOptions, projectSettingsQueryOptions, projectsQueryOptions, removeServerPeerMutationOptions, setAutostopDataSyncTimeoutMutationOptions, startSyncMutationOptions, stopSyncMutationOptions, updateProjectSettingsMutationOptions, } from '../lib/react-query/projects.js';
+import { useEffect, useSyncExternalStore } from 'react';
+import { addServerPeerMutationOptions, changeMemberRoleMutationOptions, connectSyncServersMutationOptions, createBlobMutationOptions, createProjectMutationOptions, disconnectSyncServersMutationOptions, documentCreatedByQueryOptions, exportGeoJSONMutationOptions, exportZipFileMutationOptions, getMembersQueryKey, getProjectRoleQueryKey, importProjectCategoriesMutationOptions, importProjectConfigMutationOptions, leaveProjectMutationOptions, mediaServerOriginQueryOptions, projectByIdQueryOptions, projectMemberByIdQueryOptions, projectMembersQueryOptions, projectOwnRoleQueryOptions, projectSettingsQueryOptions, projectsQueryOptions, removeProjectMemberMutationOptions, removeServerPeerMutationOptions, setAutostopDataSyncTimeoutMutationOptions, startSyncMutationOptions, stopSyncMutationOptions, updateProjectSettingsMutationOptions, } from '../lib/react-query/projects.js';
 import { SyncStore } from '../lib/sync.js';
 import { getBlobUrl, getIconUrl } from '../lib/urls.js';
 import { useClientApi } from './client.js';
@@ -317,9 +317,27 @@ export function useLeaveProject() {
         ? { error, mutate, mutateAsync, reset, status }
         : { error: null, mutate, mutateAsync, reset, status };
 }
+/**
+ * Update the categories of a project using an external file.
+ *
+ * @param opts.projectId Public ID of the project to apply changes to.
+ */
+export function useImportProjectCategories({ projectId, }) {
+    const queryClient = useQueryClient();
+    const { data: projectApi } = useSingleProject({ projectId });
+    const { error, mutate, mutateAsync, reset, status } = useMutation(importProjectCategoriesMutationOptions({
+        queryClient,
+        projectApi,
+        projectId,
+    }));
+    return status === 'error'
+        ? { error, mutate, mutateAsync, reset, status }
+        : { error: null, mutate, mutateAsync, reset, status };
+}
 /**
  * Update the configuration of a project using an external file.
  *
+ * @deprecated Use `useImportProjectCategories` instead.
  * @param opts.projectId Public ID of the project to apply changes to.
  */
 export function useImportProjectConfig({ projectId }) {
@@ -365,6 +383,63 @@ export function useChangeMemberRole({ projectId }) {
         ? { error, mutate, mutateAsync, reset, status }
         : { error: null, mutate, mutateAsync, reset, status };
 }
+/**
+ * Remove a member from a project, providing an optional reason for removal.
+ *
+ * Do NOT use this for removing your own device from a project. Use `useLeaveProject` instead.
+ *
+ * @param opts.projectId Project public ID
+ *
+ * @example
+ * ```tsx
+ * function BasicExample() {
+ *   const { mutate } = useRemoveMember({ projectId: '...' })
+ *   mutate({
+ *     deviceId: '...',
+ *     // Optional
+ *     reason: '...',
+ *   })
+ * }
+ * ```
+ */
+export function useRemoveMember({ projectId }) {
+    const queryClient = useQueryClient();
+    const { data: projectApi } = useSingleProject({ projectId });
+    const { error, mutate, mutateAsync, reset, status } = useMutation(removeProjectMemberMutationOptions({ projectId, projectApi, queryClient }));
+    return status === 'error'
+        ? { error, mutate, mutateAsync, reset, status }
+        : { error: null, mutate, mutateAsync, reset, status };
+}
+/**
+ * Set up listener for changes to your own role in a project.
+ * It is necessary to use this if you want the project role-related read hooks to update
+ * based on role change events that are received in the background.
+ *
+ * @example
+ * ```tsx
+ * function SomeComponent({ projectId }: { projectId: string }) {
+ *   useProjectOwnRoleChangeListener({ projectId })
+ * }
+ * ```
+ */
+export function useProjectOwnRoleChangeListener({ projectId, }) {
+    const queryClient = useQueryClient();
+    const { data: projectApi } = useSingleProject({ projectId });
+    useEffect(() => {
+        function invalidateCache() {
+            queryClient.invalidateQueries({
+                queryKey: getMembersQueryKey({ projectId }),
+            });
+            queryClient.invalidateQueries({
+                queryKey: getProjectRoleQueryKey({ projectId }),
+            });
+        }
+        projectApi.addListener('own-role-change', invalidateCache);
+        return () => {
+            projectApi.removeListener('own-role-change', invalidateCache);
+        };
+    }, [projectApi, queryClient, projectId]);
+}
 /**
  * Create a blob for a project.
  *

package/dist/esm/index.d.ts

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

package/dist/esm/index.js

@@ -3,4 +3,4 @@ export { useClientApi, useIsArchiveDevice, useOwnDeviceInfo, useSetIsArchiveDevi
 export { useCreateDocument, useDeleteDocument, useManyDocs, usePresetsSelection, useSingleDocByDocId, useSingleDocByVersionId, useUpdateDocument, } from './hooks/documents.js';
 export { useAcceptInvite, useManyInvites, useRejectInvite, useRequestCancelInvite, useSendInvite, useSetUpInvitesListeners, useSingleInvite, } from './hooks/invites.js';
 export { useMapStyleUrl } from './hooks/maps.js';
-export { useAddServerPeer, useAttachmentUrl, useConnectSyncServers, useCreateBlob, useCreateProject, useDataSyncProgress, useDisconnectSyncServers, useDocumentCreatedBy, useIconUrl, useImportProjectConfig, useLeaveProject, useManyMembers, useManyProjects, useOwnRoleInProject, useProjectSettings, useRemoveServerPeer, useSetAutostopDataSyncTimeout, useSingleMember, useSingleProject, useStartSync, useStopSync, useSyncState, useUpdateProjectSettings, useChangeMemberRole, useExportGeoJSON, useExportZipFile, } from './hooks/projects.js';
+export { useAddServerPeer, useAttachmentUrl, useConnectSyncServers, useCreateBlob, useCreateProject, useDataSyncProgress, useDisconnectSyncServers, useDocumentCreatedBy, useIconUrl, useImportProjectCategories, useImportProjectConfig, useLeaveProject, useManyMembers, useManyProjects, useOwnRoleInProject, useProjectOwnRoleChangeListener, useProjectSettings, useRemoveServerPeer, useRemoveMember, useSetAutostopDataSyncTimeout, useSingleMember, useSingleProject, useStartSync, useStopSync, useSyncState, useUpdateProjectSettings, useChangeMemberRole, useExportGeoJSON, useExportZipFile, } from './hooks/projects.js';