@comapeo/core-react 8.0.0 → 9.0.1

package/dist/commonjs/hooks/maps.js

@@ -1,9 +1,25 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.useMapStyleUrl = useMapStyleUrl;
+exports.useImportCustomMapFile = useImportCustomMapFile;
+exports.useRemoveCustomMapFile = useRemoveCustomMapFile;
+exports.useGetCustomMapInfo = useGetCustomMapInfo;
+exports.useManyReceivedMapShares = useManyReceivedMapShares;
+exports.useSingleReceivedMapShare = useSingleReceivedMapShare;
+exports.useDownloadReceivedMapShare = useDownloadReceivedMapShare;
+exports.useDeclineReceivedMapShare = useDeclineReceivedMapShare;
+exports.useAbortReceivedMapShareDownload = useAbortReceivedMapShareDownload;
+exports.useSendMapShare = useSendMapShare;
+exports.useCancelSentMapShare = useCancelSentMapShare;
+exports.useSingleSentMapShare = useSingleSentMapShare;
+const constants_js_1 = require("@comapeo/map-server/constants.js");
+const errors_js_1 = require("@comapeo/map-server/errors.js");
 const react_query_1 = require("@tanstack/react-query");
+const react_1 = require("react");
+const MapServer_js_1 = require("../contexts/MapServer.js");
+const MapShares_js_1 = require("../contexts/MapShares.js");
 const maps_js_1 = require("../lib/react-query/maps.js");
-const client_js_1 = require("./client.js");
+const mutation_result_js_1 = require("../lib/react-query/mutation-result.js");
 /**
  * Get a URL that points to a StyleJSON resource served by the embedded HTTP server.
  *
@@ -30,8 +46,249 @@ const client_js_1 = require("./client.js");
  * }
  * ```
  */
-function useMapStyleUrl({ refreshToken, } = {}) {
-    const clientApi = (0, client_js_1.useClientApi)();
-    const { data, error, isRefetching } = (0, react_query_1.useSuspenseQuery)((0, maps_js_1.mapStyleJsonUrlQueryOptions)({ clientApi, refreshToken }));
+function useMapStyleUrl() {
+    const mapServerApi = (0, MapServer_js_1.useMapServerApi)();
+    const { data, error, isRefetching } = (0, react_query_1.useSuspenseQuery)((0, maps_js_1.mapStyleJsonUrlQueryOptions)({ mapServerApi }));
     return { data, error, isRefetching };
 }
+/**
+ * Import a custom SMP map file, replacing any existing custom map. The mutation
+ * resolves once the file is successfully uploaded and processed by the server.
+ *
+ * @example
+ * ```tsx
+ * function MapImportExample() {
+ *   const { mutate: importMap } = useImportCustomMapFile()
+ *
+ * }
+ * ```
+ */
+function useImportCustomMapFile() {
+    const mapServerApi = (0, MapServer_js_1.useMapServerApi)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    const options = (0, maps_js_1.mapImportMutationOptions)({ mapServerApi, queryClient });
+    const result = (0, react_query_1.useMutation)(options);
+    return (0, mutation_result_js_1.filterMutationResult)(result);
+}
+function useRemoveCustomMapFile() {
+    const mapServerApi = (0, MapServer_js_1.useMapServerApi)();
+    const queryClient = (0, react_query_1.useQueryClient)();
+    const options = (0, maps_js_1.mapRemoveMutationOptions)({ mapServerApi, queryClient });
+    const result = (0, react_query_1.useMutation)(options);
+    return (0, mutation_result_js_1.filterMutationResult)(result);
+}
+function useGetCustomMapInfo() {
+    const mapServerApi = (0, MapServer_js_1.useMapServerApi)();
+    const { data, error, isRefetching } = (0, react_query_1.useQuery)((0, maps_js_1.mapInfoQueryOptions)({ mapServerApi, mapId: constants_js_1.CUSTOM_MAP_ID }));
+    return { data, error, isRefetching };
+}
+// ============================================
+// RECEIVER HOOKS
+// ============================================
+/**
+ * Get all map shares that the device has received. Automatically updates when
+ * new shares arrive or share states change.
+ *
+ * IMPORTANT: This hook will not trigger a re-render when download progress
+ * updates, only when the status changes. This is to avoid excessive re-renders
+ * during downloads. Use `useSingleReceivedMapShare` to get real-time updates on
+ * a specific share, including download progress.
+ *
+ * @example
+ * ```tsx
+ * function MapSharesList() {
+ *   const shares = useManyReceivedMapShares()
+ *
+ *   return shares.map(share => (
+ *     <div key={share.shareId}>
+ *       {share.mapName} from {share.senderDeviceName} - {share.state}
+ *     </div>
+ *   ))
+ * }
+ * ```
+ */
+function useManyReceivedMapShares() {
+    return (0, MapShares_js_1.useReceivedMapSharesState)();
+}
+/**
+ * Get a single received map share based on its shareId.
+ *
+ * @param opts.shareId ID of the map share
+ *
+ * @example
+ * ```tsx
+ * function MapShareDetail({ shareId }: { shareId: string }) {
+ *   const share = useSingleReceivedMapShare({ shareId })
+ *
+ *   return <div>{share.mapName} - {share.state}</div>
+ * }
+ * ```
+ */
+function useSingleReceivedMapShare({ shareId }) {
+    const mapShare = (0, MapShares_js_1.useReceivedMapSharesState)((0, react_1.useCallback)((shares) => shares.find((s) => s.shareId === shareId), [shareId]));
+    if (!mapShare) {
+        throw new Error(`Map share with id ${shareId} not found`);
+    }
+    return mapShare;
+}
+/**
+ * Accept and download a map share that has been received. The mutate promise
+ * resolves once the map _starts_ downloading, before it finishes downloading.
+ * Use `useManyMapShares` or `useSingleMapShare` to track download progress.
+ *
+ * Throws if the share is not in `status="pending"` or if the download fails to
+ * start (e.g. if the shareId if invalid).
+ *
+ * @example
+ * ```tsx
+ * function AcceptButton({ shareId }: { shareId: string }) {
+ *   const { mutate: accept } = useAcceptMapShare()
+ *
+ *   return <button onClick={() => accept({ shareId })}>Accept</button>
+ * }
+ * ```
+ */
+function useDownloadReceivedMapShare() {
+    const { download } = (0, MapShares_js_1.useReceivedMapSharesActions)();
+    const options = (0, maps_js_1.mapSharesMutationOptions)({ action: download });
+    const result = (0, react_query_1.useMutation)(options);
+    return (0, mutation_result_js_1.filterMutationResult)(result);
+}
+/**
+ * Decline a map share that has been received. Notifies the sender that the
+ * share was declined.
+ *
+ * Throws if the share is not with `status="pending"`
+ * Throws if shareId is invalid
+ * Throws if decline request fails (e.g. network error)
+ *
+ * @example
+ * ```tsx
+ * import { DeclineReason } from '@comapeo/core-react'
+ * function DeclineButton({ shareId }: { shareId: string }) {
+ *   const { mutate: decline } = useDeclineMapShare()
+ *
+ *   return (
+ *     <button onClick={() => decline({ shareId, reason: DeclineReason.user_rejected })}>
+ *       Decline
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+function useDeclineReceivedMapShare() {
+    const { decline } = (0, MapShares_js_1.useReceivedMapSharesActions)();
+    const options = (0, maps_js_1.mapSharesMutationOptions)({ action: decline });
+    const result = (0, react_query_1.useMutation)(options);
+    return (0, mutation_result_js_1.filterMutationResult)(result);
+}
+/**
+ * Abort an in-progress map share download.
+ *
+ * Throws if the share is not in `status="downloading"`
+ * Throws if shareId is invalid
+ *
+ * @example
+ * ```tsx
+ * function AbortButton({ shareId }: { shareId: string }) {
+ *   const { mutate: abort } = useAbortMapShareDownload()
+ *
+ *   return <button onClick={() => abort({ shareId })}>Cancel Download</button>
+ * }
+ * ```
+ */
+function useAbortReceivedMapShareDownload() {
+    const { abort } = (0, MapShares_js_1.useReceivedMapSharesActions)();
+    const options = (0, maps_js_1.mapSharesMutationOptions)({ action: abort });
+    const result = (0, react_query_1.useMutation)(options);
+    return (0, mutation_result_js_1.filterMutationResult)(result);
+}
+// ============================================
+// SENDER HOOKS
+// ============================================
+/**
+ * Share a map with a device. The mutation resolves immediately after sending
+ * the share offer, without waiting for the recipient to accept or reject. The
+ * mutation resolves with the created map share object, including its ID, which
+ * can be used to track the share status with `useSingleSentMapShare`.
+ *
+ * @param opts.projectId Public ID of project for sending the map share: you can only send map shares to users on the same project
+ *
+ * @example
+ * ```tsx
+ * function SendMapButton({ projectId, deviceId }: { projectId: string; deviceId: string }) {
+ *   const { mutate: send } = useSendMapShare({ projectId }, {
+ *     onSuccess: (mapShare) => {
+ *  	   console.log('Share sent with id', mapShare.shareId)
+ *     }
+ *   })
+ *
+ *   return (
+ *     <button onClick={() => send({ receiverDeviceId: deviceId, mapId: 'custom' })}>
+ *       Send Map
+ *     </button>
+ *   )
+ * }
+ * ```
+ */
+function useSendMapShare({ projectId }) {
+    const { createAndSend } = (0, MapShares_js_1.useSentMapSharesActions)();
+    const options = (0, maps_js_1.mapSharesMutationOptions)({ action: createAndSend, projectId });
+    const result = (0, react_query_1.useMutation)(options);
+    return (0, mutation_result_js_1.filterMutationResult)(result);
+}
+/**
+ * Cancel a map share that was previously sent. If the recipient has not yet
+ * started downloading the share, they will not be notified until they attempt
+ * to accept the share and begin downloading it. If they are already downloading
+ * the share, the download will be canceled before completion. If the download
+ * is already complete, this action will throw an error.
+ *
+ * @param opts.projectId Public ID of project to request the map share cancellation for.
+ *
+ * @example
+ * ```tsx
+ * function CancelShareButton({ projectId, shareId }: { projectId: string; shareId: string }) {
+ *   const { mutate: cancel } = useRequestCancelMapShare({ projectId })
+ *
+ *   return <button onClick={() => cancel({ shareId })}>Cancel Share</button>
+ * }
+ * ```
+ */
+function useCancelSentMapShare() {
+    const { cancel } = (0, MapShares_js_1.useSentMapSharesActions)();
+    const options = (0, maps_js_1.mapSharesMutationOptions)({ action: cancel });
+    const result = (0, react_query_1.useMutation)(options);
+    return (0, mutation_result_js_1.filterMutationResult)(result);
+}
+/**
+ * Track the status and progress of a sent map share. Returns the current state
+ * of the share, updated in real-time. When the recipient starts downloading, or
+ * if they decline the share, then the returned share will update.
+ *
+ * Throws if no share with the specified ID is found.
+ *
+ * @param opts.shareId ID of the sent map share
+ *
+ * @example
+ * ```tsx
+ * function SentShareStatus({ shareId }: { shareId: string }) {
+ *   const mapShare = useSingleSentMapShare({ shareId })
+ *
+ *   return (<div>
+ * 		<div>Share status: {mapShare.status}</div>
+ *    {mapShare.status === 'pending' && <div>Waiting for recipient to accept...</div>}
+ *   	{mapShare.status === 'downloading' && (<div>Download in progress: {mapShare.downloadProgress}%</div>)}
+ *   	{mapShare.status === 'declined' && <div>Share was declined by recipient</div>}
+ * 	  {mapShare.status === 'canceled' && <div>Share was canceled</div>}
+ *   </div>)
+ * }
+ * ```
+ */
+function useSingleSentMapShare({ shareId, }) {
+    const mapShare = (0, MapShares_js_1.useSentMapSharesState)((0, react_1.useCallback)((shares) => shares.find((s) => s.shareId === shareId), [shareId]));
+    if (!mapShare) {
+        throw new errors_js_1.errors.MAP_SHARE_NOT_FOUND(`Sent map share with id ${shareId} not found`);
+    }
+    return mapShare;
+}

package/dist/commonjs/index.d.ts

@@ -1,8 +1,11 @@
-export { ClientApiProvider } from './contexts/ClientApi.js';
+export { ComapeoCoreProvider } from './contexts/ComapeoCore.js';
 export { useClientApi, useIsArchiveDevice, useOwnDeviceInfo, useSetIsArchiveDevice, useSetOwnDeviceInfo, } from './hooks/client.js';
 export { useCreateDocument, useDeleteDocument, useManyDocs, usePresetsSelection, useSingleDocByDocId, useSingleDocByVersionId, useUpdateDocument, } from './hooks/documents.js';
 export { useAcceptInvite, useManyInvites, useRejectInvite, useRequestCancelInvite, useSendInvite, useSingleInvite, } from './hooks/invites.js';
-export { useMapStyleUrl } from './hooks/maps.js';
+export { useMapStyleUrl, useImportCustomMapFile, useRemoveCustomMapFile, useGetCustomMapInfo, useManyReceivedMapShares, useSingleReceivedMapShare, useDeclineReceivedMapShare, useDownloadReceivedMapShare, useAbortReceivedMapShareDownload, useSendMapShare, useCancelSentMapShare, useSingleSentMapShare, } from './hooks/maps.js';
+export type { SentMapShareState, ReceivedMapShareState, AbortMapShareOptions, CancelMapShareOptions, DeclineMapShareOptions, DownloadMapShareOptions, CreateAndSendMapShareOptions, } from './lib/map-shares-stores.js';
+export { DeclineReason } from './lib/map-shares-stores.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';
+export { HTTPError, isHTTPError } from './lib/http.js';

package/dist/commonjs/index.js

@@ -1,8 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.useExportZipFile = exports.useExportGeoJSON = exports.useChangeMemberRole = exports.useUpdateProjectSettings = exports.useSyncState = exports.useStopSync = exports.useStartSync = exports.useSingleProject = exports.useSingleMember = exports.useSetAutostopDataSyncTimeout = exports.useRemoveMember = exports.useRemoveServerPeer = exports.useProjectSettings = exports.useProjectOwnRoleChangeListener = exports.useOwnRoleInProject = exports.useManyProjects = exports.useManyMembers = exports.useLeaveProject = exports.useImportProjectConfig = exports.useImportProjectCategories = exports.useIconUrl = exports.useDocumentCreatedBy = exports.useDisconnectSyncServers = exports.useDataSyncProgress = exports.useCreateProject = exports.useCreateBlob = exports.useConnectSyncServers = exports.useAttachmentUrl = exports.useAddServerPeer = exports.useMapStyleUrl = exports.useSingleInvite = exports.useSendInvite = exports.useRequestCancelInvite = exports.useRejectInvite = exports.useManyInvites = exports.useAcceptInvite = exports.useUpdateDocument = exports.useSingleDocByVersionId = exports.useSingleDocByDocId = exports.usePresetsSelection = exports.useManyDocs = exports.useDeleteDocument = exports.useCreateDocument = exports.useSetOwnDeviceInfo = exports.useSetIsArchiveDevice = exports.useOwnDeviceInfo = exports.useIsArchiveDevice = exports.useClientApi = exports.ClientApiProvider = void 0;
-var ClientApi_js_1 = require("./contexts/ClientApi.js");
-Object.defineProperty(exports, "ClientApiProvider", { enumerable: true, get: function () { return ClientApi_js_1.ClientApiProvider; } });
+exports.useRemoveServerPeer = exports.useProjectSettings = exports.useProjectOwnRoleChangeListener = exports.useOwnRoleInProject = exports.useManyProjects = exports.useManyMembers = exports.useLeaveProject = exports.useImportProjectConfig = exports.useImportProjectCategories = exports.useIconUrl = exports.useDocumentCreatedBy = exports.useDisconnectSyncServers = exports.useDataSyncProgress = exports.useCreateProject = exports.useCreateBlob = exports.useConnectSyncServers = exports.useAttachmentUrl = exports.useAddServerPeer = exports.DeclineReason = exports.useSingleSentMapShare = exports.useCancelSentMapShare = exports.useSendMapShare = exports.useAbortReceivedMapShareDownload = exports.useDownloadReceivedMapShare = exports.useDeclineReceivedMapShare = exports.useSingleReceivedMapShare = exports.useManyReceivedMapShares = exports.useGetCustomMapInfo = exports.useRemoveCustomMapFile = exports.useImportCustomMapFile = exports.useMapStyleUrl = exports.useSingleInvite = exports.useSendInvite = exports.useRequestCancelInvite = exports.useRejectInvite = exports.useManyInvites = exports.useAcceptInvite = exports.useUpdateDocument = exports.useSingleDocByVersionId = exports.useSingleDocByDocId = exports.usePresetsSelection = exports.useManyDocs = exports.useDeleteDocument = exports.useCreateDocument = exports.useSetOwnDeviceInfo = exports.useSetIsArchiveDevice = exports.useOwnDeviceInfo = exports.useIsArchiveDevice = exports.useClientApi = exports.ComapeoCoreProvider = void 0;
+exports.isHTTPError = exports.HTTPError = exports.useExportZipFile = exports.useExportGeoJSON = exports.useChangeMemberRole = exports.useUpdateProjectSettings = exports.useSyncState = exports.useStopSync = exports.useStartSync = exports.useSingleProject = exports.useSingleMember = exports.useSetAutostopDataSyncTimeout = exports.useRemoveMember = void 0;
+var ComapeoCore_js_1 = require("./contexts/ComapeoCore.js");
+Object.defineProperty(exports, "ComapeoCoreProvider", { enumerable: true, get: function () { return ComapeoCore_js_1.ComapeoCoreProvider; } });
 var client_js_1 = require("./hooks/client.js");
 Object.defineProperty(exports, "useClientApi", { enumerable: true, get: function () { return client_js_1.useClientApi; } });
 Object.defineProperty(exports, "useIsArchiveDevice", { enumerable: true, get: function () { return client_js_1.useIsArchiveDevice; } });
@@ -26,6 +27,19 @@ Object.defineProperty(exports, "useSendInvite", { enumerable: true, get: functio
 Object.defineProperty(exports, "useSingleInvite", { enumerable: true, get: function () { return invites_js_1.useSingleInvite; } });
 var maps_js_1 = require("./hooks/maps.js");
 Object.defineProperty(exports, "useMapStyleUrl", { enumerable: true, get: function () { return maps_js_1.useMapStyleUrl; } });
+Object.defineProperty(exports, "useImportCustomMapFile", { enumerable: true, get: function () { return maps_js_1.useImportCustomMapFile; } });
+Object.defineProperty(exports, "useRemoveCustomMapFile", { enumerable: true, get: function () { return maps_js_1.useRemoveCustomMapFile; } });
+Object.defineProperty(exports, "useGetCustomMapInfo", { enumerable: true, get: function () { return maps_js_1.useGetCustomMapInfo; } });
+Object.defineProperty(exports, "useManyReceivedMapShares", { enumerable: true, get: function () { return maps_js_1.useManyReceivedMapShares; } });
+Object.defineProperty(exports, "useSingleReceivedMapShare", { enumerable: true, get: function () { return maps_js_1.useSingleReceivedMapShare; } });
+Object.defineProperty(exports, "useDeclineReceivedMapShare", { enumerable: true, get: function () { return maps_js_1.useDeclineReceivedMapShare; } });
+Object.defineProperty(exports, "useDownloadReceivedMapShare", { enumerable: true, get: function () { return maps_js_1.useDownloadReceivedMapShare; } });
+Object.defineProperty(exports, "useAbortReceivedMapShareDownload", { enumerable: true, get: function () { return maps_js_1.useAbortReceivedMapShareDownload; } });
+Object.defineProperty(exports, "useSendMapShare", { enumerable: true, get: function () { return maps_js_1.useSendMapShare; } });
+Object.defineProperty(exports, "useCancelSentMapShare", { enumerable: true, get: function () { return maps_js_1.useCancelSentMapShare; } });
+Object.defineProperty(exports, "useSingleSentMapShare", { enumerable: true, get: function () { return maps_js_1.useSingleSentMapShare; } });
+var map_shares_stores_js_1 = require("./lib/map-shares-stores.js");
+Object.defineProperty(exports, "DeclineReason", { enumerable: true, get: function () { return map_shares_stores_js_1.DeclineReason; } });
 var projects_js_1 = require("./hooks/projects.js");
 Object.defineProperty(exports, "useAddServerPeer", { enumerable: true, get: function () { return projects_js_1.useAddServerPeer; } });
 Object.defineProperty(exports, "useAttachmentUrl", { enumerable: true, get: function () { return projects_js_1.useAttachmentUrl; } });
@@ -56,3 +70,6 @@ Object.defineProperty(exports, "useUpdateProjectSettings", { enumerable: true, g
 Object.defineProperty(exports, "useChangeMemberRole", { enumerable: true, get: function () { return projects_js_1.useChangeMemberRole; } });
 Object.defineProperty(exports, "useExportGeoJSON", { enumerable: true, get: function () { return projects_js_1.useExportGeoJSON; } });
 Object.defineProperty(exports, "useExportZipFile", { enumerable: true, get: function () { return projects_js_1.useExportZipFile; } });
+var http_js_1 = require("./lib/http.js");
+Object.defineProperty(exports, "HTTPError", { enumerable: true, get: function () { return http_js_1.HTTPError; } });
+Object.defineProperty(exports, "isHTTPError", { enumerable: true, get: function () { return http_js_1.isHTTPError; } });

package/dist/commonjs/lib/http.d.ts

@@ -0,0 +1,45 @@
+import type { JsonValue } from 'type-fest';
+type HttpInit = RequestInit & {
+    json?: JsonValue;
+};
+type ResponsePromise = Promise<Response> & {
+    json<T = unknown>(): Promise<T>;
+    text(): Promise<string>;
+};
+type Input = string | URL;
+/**
+ * http - A minimal fetch wrapper to reduce some boilerplate.
+ *
+ * @example
+ * ```js
+ *   import { createHttp } from './http.js'
+ *   const http = createHttp(myCustomFetch)
+ *
+ *   const data = await http.get('https://api.example.com/items').json()
+ *   await http.post('https://api.example.com/items', { json: { name: 'foo' } }).json()
+ * ```
+ */
+declare function createHttp(fetchFn?: (input: string | URL, init?: RequestInit) => Promise<Response>): Record<"head" | "get" | "post" | "put" | "patch" | "delete", (input: Input, options?: HttpInit) => ResponsePromise>;
+type HTTPErrorObject = {
+    message?: string;
+    code?: string;
+    [key: string]: unknown;
+};
+/**
+ * HTTPError - Custom error class to represent HTTP errors with additional context.
+ */
+declare class HTTPError extends Error {
+    readonly response: Response;
+    readonly status: number;
+    readonly code: string;
+    [key: string]: unknown;
+    constructor(response: Response, { method, url, ...body }: {
+        method: string;
+        url: string;
+    } & HTTPErrorObject);
+}
+/**
+ * Type guard to check if an error is an instance of HTTPError.
+ */
+declare function isHTTPError(error: unknown): error is HTTPError;
+export { createHttp, HTTPError, isHTTPError };

package/dist/commonjs/lib/http.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HTTPError = void 0;
+exports.createHttp = createHttp;
+exports.isHTTPError = isHTTPError;
+const requestMethods = [
+    'get',
+    'post',
+    'put',
+    'patch',
+    'head',
+    'delete',
+];
+/**
+ * http - A minimal fetch wrapper to reduce some boilerplate.
+ *
+ * @example
+ * ```js
+ *   import { createHttp } from './http.js'
+ *   const http = createHttp(myCustomFetch)
+ *
+ *   const data = await http.get('https://api.example.com/items').json()
+ *   await http.post('https://api.example.com/items', { json: { name: 'foo' } }).json()
+ * ```
+ */
+function createHttp(fetchFn = globalThis.fetch) {
+    const alias = (method) => (input, options = {}) => {
+        const { json, headers, ...rest } = options;
+        const h = new Headers(headers);
+        if (json !== undefined) {
+            rest.body = JSON.stringify(json);
+            if (!h.has('content-type'))
+                h.set('content-type', 'application/json');
+        }
+        if (!h.has('accept'))
+            h.set('accept', 'application/json');
+        const responsePromise = fetchFn(input, {
+            ...rest,
+            method,
+            headers: h,
+        }).then((response) => {
+            if (!response.ok)
+                throw new HTTPError(response, { method, url: input.toString() });
+            return response;
+        });
+        responsePromise.json = () => responsePromise
+            .catch((e) => {
+            // For http errors, parse the body as json to get the error details, but rethrow other errors (e.g. network errors)
+            if (isHTTPError(e))
+                return e.response;
+            throw e;
+        })
+            .then(async (r) => {
+            if (r.status === 204)
+                return '';
+            const text = await r.text();
+            const parsed = text === '' ? '' : JSON.parse(text);
+            if (r.ok)
+                return parsed;
+            throw new HTTPError(r, {
+                method: options.method ?? 'GET',
+                url: input.toString(),
+                ...parsed,
+            });
+        });
+        responsePromise.text = () => responsePromise.then((r) => r.text());
+        return responsePromise;
+    };
+    const http = {};
+    for (const method of requestMethods) {
+        http[method] = alias(upperCase(method));
+    }
+    return http;
+}
+/**
+ * HTTPError - Custom error class to represent HTTP errors with additional context.
+ */
+class HTTPError extends Error {
+    response;
+    status;
+    code = 'UNKNOWN_ERROR';
+    constructor(response, { method, url, ...body }) {
+        const status = response.status || 500;
+        const message = body.message || `Request failed with ${status}: ${method} ${url}`;
+        super(message);
+        Object.assign(this, body);
+        // override status in body with status from response
+        this.status = status;
+        this.name = 'HTTPError';
+        this.response = response;
+    }
+}
+exports.HTTPError = HTTPError;
+/**
+ * Type guard to check if an error is an instance of HTTPError.
+ */
+function isHTTPError(error) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return error instanceof HTTPError || error?.name === HTTPError.name;
+}
+function upperCase(str) {
+    return str.toUpperCase();
+}

package/dist/commonjs/lib/map-shares-stores.d.ts

@@ -0,0 +1,80 @@
+import type { MapShare } from '@comapeo/core';
+import type { MapeoClientApi } from '@comapeo/ipc';
+import { type MapShareState as ServerMapShareState } from '@comapeo/map-server';
+import { type QueryClient } from '@tanstack/react-query';
+import type { Simplify } from 'type-fest';
+import type { MapServerApi } from '../contexts/MapServer.js';
+type DistributedIntersection<T, U> = U extends unknown ? Simplify<T & U> : never;
+export type ReceivedMapShareState = DistributedIntersection<Simplify<MapShare>, ServerMapShareState>;
+export type SentMapShareState = ServerMapShareState;
+export type ReceivedMapSharesStore = ReturnType<typeof createReceivedMapSharesStore>;
+export type SentMapSharesStore = ReturnType<typeof createSentMapSharesStore>;
+/** Known reasons for declining a map share */
+export declare const DeclineReason: {
+    /** User explicitly rejected the map share */
+    readonly user_rejected: "user_rejected";
+    /** Device storage is full */
+    readonly storage_full: "storage_full";
+};
+/** Options for downloading a received map share */
+export type DownloadMapShareOptions = {
+    /** ID of the map share to download */
+    shareId: string;
+};
+/** Options for declining a received map share */
+export type DeclineMapShareOptions = {
+    /** ID of the map share to decline */
+    shareId: string;
+    /** Reason for declining (e.g., 'user_rejected', 'storage_full') */
+    reason: (typeof DeclineReason)[keyof typeof DeclineReason] | (string & {});
+};
+/** Options for aborting an in-progress map share download */
+export type AbortMapShareOptions = {
+    /** ID of the map share download to abort */
+    shareId: string;
+};
+/** Options for creating and sending a map share */
+export type CreateAndSendMapShareOptions = {
+    /** Public ID of the project to send the share on behalf of */
+    projectId: string;
+    /** Device ID of the recipient */
+    receiverDeviceId: string;
+    /** ID of the map to share - not needed until we support multiple maps */
+    mapId?: string;
+};
+/** Options for canceling a sent map share */
+export type CancelMapShareOptions = {
+    /** ID of the map share to cancel */
+    shareId: string;
+};
+/**
+ * Store and actions for received map shares.
+ */
+export declare function createReceivedMapSharesStore({ clientApi, mapServerApi, queryClient, }: {
+    clientApi: MapeoClientApi;
+    mapServerApi: MapServerApi;
+    queryClient: QueryClient;
+}): {
+    subscribe: (listener: () => void) => () => boolean;
+    getSnapshot: () => ReceivedMapShareState[];
+    actions: {
+        download({ shareId }: DownloadMapShareOptions): Promise<void>;
+        decline({ shareId, reason }: DeclineMapShareOptions): Promise<void>;
+        abort({ shareId }: AbortMapShareOptions): Promise<void>;
+    };
+};
+/**
+ * Store and actions for sent map share.
+ */
+export declare function createSentMapSharesStore({ clientApi, mapServerApi, }: {
+    clientApi: MapeoClientApi;
+    mapServerApi: MapServerApi;
+}): {
+    subscribe: (listener: () => void) => () => boolean;
+    getSnapshot: () => ServerMapShareState[];
+    actions: {
+        createAndSend({ projectId, receiverDeviceId, mapId, }: CreateAndSendMapShareOptions): Promise<ServerMapShareState>;
+        cancel({ shareId }: CancelMapShareOptions): Promise<void>;
+    };
+};
+export {};