@growsober/sdk 1.0.3 → 1.0.4

package/dist/api/mutations/event-chat.d.ts

@@ -62,45 +62,28 @@ export declare function useMarkMessagesAsRead(eventId: string): import("@tanstac
  */
 export declare function useSendEventChatMessage(eventId: string): import("@tanstack/react-query").UseMutationResult<{
     id: string;
-    chatId: string;
-    userId: string;
+    conversationId: string;
+    role: "USER" | "ASSISTANT" | "SYSTEM";
     content: string;
-    messageType: "TEXT" | "IMAGE" | "SYSTEM" | "ANNOUNCEMENT";
-    imageUrl?: string;
-    replyToId?: string;
-    isEdited: boolean;
-    isDeleted: boolean;
+    model?: Record<string, never>;
+    promptTokens?: Record<string, never>;
+    completionTokens?: Record<string, never>;
     createdAt: string;
-    updatedAt?: string;
-    userName?: string;
-    userImage?: string;
-    replyToContent?: string;
-    replyToUserName?: string;
 }, Error, {
     content: string;
-    messageType: "TEXT" | "IMAGE" | "SYSTEM" | "ANNOUNCEMENT";
-    imageUrl?: string;
-    replyToId?: string;
 }, unknown>;
 /**
  * Update a message
  */
 export declare function useUpdateEventChatMessage(eventId: string): import("@tanstack/react-query").UseMutationResult<{
     id: string;
-    chatId: string;
-    userId: string;
+    conversationId: string;
+    role: "USER" | "ASSISTANT" | "SYSTEM";
     content: string;
-    messageType: "TEXT" | "IMAGE" | "SYSTEM" | "ANNOUNCEMENT";
-    imageUrl?: string;
-    replyToId?: string;
-    isEdited: boolean;
-    isDeleted: boolean;
+    model?: Record<string, never>;
+    promptTokens?: Record<string, never>;
+    completionTokens?: Record<string, never>;
     createdAt: string;
-    updatedAt?: string;
-    userName?: string;
-    userImage?: string;
-    replyToContent?: string;
-    replyToUserName?: string;
 }, Error, {
     messageId: string;
 } & {

package/dist/api/mutations/index.d.ts

@@ -20,3 +20,4 @@ export * from './ambassadors';
 export * from './grow90';
 export * from './matching';
 export * from './event-chat';
+export * from './user-pins';

package/dist/api/mutations/index.js

@@ -36,4 +36,5 @@ __exportStar(require("./ambassadors"), exports);
 __exportStar(require("./grow90"), exports);
 __exportStar(require("./matching"), exports);
 __exportStar(require("./event-chat"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYXBpL211dGF0aW9ucy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7R0FJRzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILDBDQUF3QjtBQUN4Qix5Q0FBdUI7QUFDdkIsNkNBQTJCO0FBQzNCLDJDQUF5QjtBQUN6Qix5Q0FBdUI7QUFDdkIsNENBQTBCO0FBQzFCLHdDQUFzQjtBQUN0QixrREFBZ0M7QUFDaEMsMkNBQXlCO0FBQ3pCLGtEQUFnQztBQUNoQyw0Q0FBMEI7QUFDMUIsMENBQXdCO0FBQ3hCLHlDQUF1QjtBQUN2QixnREFBOEI7QUFDOUIsMkNBQXlCO0FBQ3pCLDZDQUEyQjtBQUMzQiwrQ0FBNkIiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIE11dGF0aW9uIEhvb2tzXG4gKlxuICogUmUtZXhwb3J0cyBhbGwgbXV0YXRpb24gaG9va3MgZm9yIEFQSSBlbmRwb2ludHMuXG4gKi9cblxuZXhwb3J0ICogZnJvbSAnLi9hZG1pbic7XG5leHBvcnQgKiBmcm9tICcuL2F1dGgnO1xuZXhwb3J0ICogZnJvbSAnLi9ib29raW5ncyc7XG5leHBvcnQgKiBmcm9tICcuL2V2ZW50cyc7XG5leHBvcnQgKiBmcm9tICcuL2h1YnMnO1xuZXhwb3J0ICogZnJvbSAnLi9saWJyYXJ5JztcbmV4cG9ydCAqIGZyb20gJy4vbWFwJztcbmV4cG9ydCAqIGZyb20gJy4vbm90aWZpY2F0aW9ucyc7XG5leHBvcnQgKiBmcm9tICcuL29mZmVycyc7XG5leHBvcnQgKiBmcm9tICcuL3N1YnNjcmlwdGlvbnMnO1xuZXhwb3J0ICogZnJvbSAnLi9zdXBwb3J0JztcbmV4cG9ydCAqIGZyb20gJy4vdXNlcnMnO1xuZXhwb3J0ICogZnJvbSAnLi9qYWNrJztcbmV4cG9ydCAqIGZyb20gJy4vYW1iYXNzYWRvcnMnO1xuZXhwb3J0ICogZnJvbSAnLi9ncm93OTAnO1xuZXhwb3J0ICogZnJvbSAnLi9tYXRjaGluZyc7XG5leHBvcnQgKiBmcm9tICcuL2V2ZW50LWNoYXQnO1xuIl19
+__exportStar(require("./user-pins"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYXBpL211dGF0aW9ucy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7R0FJRzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILDBDQUF3QjtBQUN4Qix5Q0FBdUI7QUFDdkIsNkNBQTJCO0FBQzNCLDJDQUF5QjtBQUN6Qix5Q0FBdUI7QUFDdkIsNENBQTBCO0FBQzFCLHdDQUFzQjtBQUN0QixrREFBZ0M7QUFDaEMsMkNBQXlCO0FBQ3pCLGtEQUFnQztBQUNoQyw0Q0FBMEI7QUFDMUIsMENBQXdCO0FBQ3hCLHlDQUF1QjtBQUN2QixnREFBOEI7QUFDOUIsMkNBQXlCO0FBQ3pCLDZDQUEyQjtBQUMzQiwrQ0FBNkI7QUFDN0IsOENBQTRCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBNdXRhdGlvbiBIb29rc1xuICpcbiAqIFJlLWV4cG9ydHMgYWxsIG11dGF0aW9uIGhvb2tzIGZvciBBUEkgZW5kcG9pbnRzLlxuICovXG5cbmV4cG9ydCAqIGZyb20gJy4vYWRtaW4nO1xuZXhwb3J0ICogZnJvbSAnLi9hdXRoJztcbmV4cG9ydCAqIGZyb20gJy4vYm9va2luZ3MnO1xuZXhwb3J0ICogZnJvbSAnLi9ldmVudHMnO1xuZXhwb3J0ICogZnJvbSAnLi9odWJzJztcbmV4cG9ydCAqIGZyb20gJy4vbGlicmFyeSc7XG5leHBvcnQgKiBmcm9tICcuL21hcCc7XG5leHBvcnQgKiBmcm9tICcuL25vdGlmaWNhdGlvbnMnO1xuZXhwb3J0ICogZnJvbSAnLi9vZmZlcnMnO1xuZXhwb3J0ICogZnJvbSAnLi9zdWJzY3JpcHRpb25zJztcbmV4cG9ydCAqIGZyb20gJy4vc3VwcG9ydCc7XG5leHBvcnQgKiBmcm9tICcuL3VzZXJzJztcbmV4cG9ydCAqIGZyb20gJy4vamFjayc7XG5leHBvcnQgKiBmcm9tICcuL2FtYmFzc2Fkb3JzJztcbmV4cG9ydCAqIGZyb20gJy4vZ3JvdzkwJztcbmV4cG9ydCAqIGZyb20gJy4vbWF0Y2hpbmcnO1xuZXhwb3J0ICogZnJvbSAnLi9ldmVudC1jaGF0JztcbmV4cG9ydCAqIGZyb20gJy4vdXNlci1waW5zJztcbiJdfQ==

package/dist/api/mutations/user-pins.d.ts

@@ -0,0 +1,132 @@
+/**
+ * User Pins Mutation Hooks
+ *
+ * TanStack Query mutation hooks for user pin operations.
+ * These hooks handle creating and deleting user pins
+ * ("I'm here now" / "I'll be there").
+ *
+ * @module api/mutations/user-pins
+ */
+import { UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { UserPinResponse, PinType } from '../queries/user-pins';
+export interface CreatePinRequest {
+    type: PinType;
+    latitude: number;
+    longitude: number;
+    locationName?: string;
+    activity: string;
+    venueId?: string;
+    scheduledTime?: string;
+    duration?: number;
+}
+/**
+ * Create a new user pin
+ *
+ * @description
+ * Creates a new pin showing where the user is or will be.
+ * Any existing active pin is automatically deactivated.
+ *
+ * Two types of pins:
+ * - HERE_NOW: User is currently at this location (default 1 hour duration)
+ * - SCHEDULED: User will be at this location at a specific time (default 2 hour duration)
+ *
+ * @endpoint POST /api/v1/user-pins
+ *
+ * @example
+ * Drop a "I'm here now" pin:
+ * ```tsx
+ * import { useCreateUserPin } from '@growsober/sdk';
+ *
+ * function DropPinButton({ location }) {
+ *   const createPin = useCreateUserPin();
+ *
+ *   const handleDropPin = () => {
+ *     createPin.mutate({
+ *       type: 'HERE_NOW',
+ *       latitude: location.lat,
+ *       longitude: location.lng,
+ *       locationName: 'Fabrica Coffee',
+ *       activity: 'Working remotely',
+ *       duration: 120, // 2 hours
+ *     });
+ *   };
+ *
+ *   return (
+ *     <Button onPress={handleDropPin} loading={createPin.isPending}>
+ *       Drop Pin
+ *     </Button>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * Schedule a pin for later:
+ * ```tsx
+ * import { useCreateUserPin } from '@growsober/sdk';
+ *
+ * function SchedulePinForm() {
+ *   const createPin = useCreateUserPin({
+ *     onSuccess: () => {
+ *       toast.show('Pin scheduled!');
+ *     },
+ *   });
+ *
+ *   const handleSchedule = (data) => {
+ *     createPin.mutate({
+ *       type: 'SCHEDULED',
+ *       latitude: data.venue.lat,
+ *       longitude: data.venue.lng,
+ *       locationName: data.venue.name,
+ *       venueId: data.venue.id,
+ *       activity: 'Coffee meetup',
+ *       scheduledTime: data.time.toISOString(),
+ *       duration: 90,
+ *     });
+ *   };
+ *
+ *   return <ScheduleForm onSubmit={handleSchedule} />;
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export declare function useCreateUserPin(options?: Omit<UseMutationOptions<UserPinResponse, Error, CreatePinRequest>, 'mutationFn'>): UseMutationResult<UserPinResponse, Error, CreatePinRequest>;
+/**
+ * Delete a user pin
+ *
+ * @description
+ * Deactivates a user pin. Users can only delete their own pins.
+ *
+ * @endpoint DELETE /api/v1/user-pins/:id
+ *
+ * @example
+ * ```tsx
+ * import { useDeleteUserPin } from '@growsober/sdk';
+ *
+ * function MyPinCard({ pin }) {
+ *   const deletePin = useDeleteUserPin({
+ *     onSuccess: () => {
+ *       toast.show('Pin removed');
+ *     },
+ *   });
+ *
+ *   return (
+ *     <Card>
+ *       <Text>{pin.activity}</Text>
+ *       <Text>At {pin.locationName}</Text>
+ *       <Button
+ *         onPress={() => deletePin.mutate(pin.id)}
+ *         loading={deletePin.isPending}
+ *       >
+ *         Remove Pin
+ *       </Button>
+ *     </Card>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export declare function useDeleteUserPin(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;

package/dist/api/mutations/user-pins.js

@@ -0,0 +1,158 @@
+"use strict";
+/**
+ * User Pins Mutation Hooks
+ *
+ * TanStack Query mutation hooks for user pin operations.
+ * These hooks handle creating and deleting user pins
+ * ("I'm here now" / "I'll be there").
+ *
+ * @module api/mutations/user-pins
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.useCreateUserPin = useCreateUserPin;
+exports.useDeleteUserPin = useDeleteUserPin;
+const react_query_1 = require("@tanstack/react-query");
+const client_1 = require("../client");
+const user_pins_1 = require("../queries/user-pins");
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+/**
+ * Create a new user pin
+ *
+ * @description
+ * Creates a new pin showing where the user is or will be.
+ * Any existing active pin is automatically deactivated.
+ *
+ * Two types of pins:
+ * - HERE_NOW: User is currently at this location (default 1 hour duration)
+ * - SCHEDULED: User will be at this location at a specific time (default 2 hour duration)
+ *
+ * @endpoint POST /api/v1/user-pins
+ *
+ * @example
+ * Drop a "I'm here now" pin:
+ * ```tsx
+ * import { useCreateUserPin } from '@growsober/sdk';
+ *
+ * function DropPinButton({ location }) {
+ *   const createPin = useCreateUserPin();
+ *
+ *   const handleDropPin = () => {
+ *     createPin.mutate({
+ *       type: 'HERE_NOW',
+ *       latitude: location.lat,
+ *       longitude: location.lng,
+ *       locationName: 'Fabrica Coffee',
+ *       activity: 'Working remotely',
+ *       duration: 120, // 2 hours
+ *     });
+ *   };
+ *
+ *   return (
+ *     <Button onPress={handleDropPin} loading={createPin.isPending}>
+ *       Drop Pin
+ *     </Button>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * Schedule a pin for later:
+ * ```tsx
+ * import { useCreateUserPin } from '@growsober/sdk';
+ *
+ * function SchedulePinForm() {
+ *   const createPin = useCreateUserPin({
+ *     onSuccess: () => {
+ *       toast.show('Pin scheduled!');
+ *     },
+ *   });
+ *
+ *   const handleSchedule = (data) => {
+ *     createPin.mutate({
+ *       type: 'SCHEDULED',
+ *       latitude: data.venue.lat,
+ *       longitude: data.venue.lng,
+ *       locationName: data.venue.name,
+ *       venueId: data.venue.id,
+ *       activity: 'Coffee meetup',
+ *       scheduledTime: data.time.toISOString(),
+ *       duration: 90,
+ *     });
+ *   };
+ *
+ *   return <ScheduleForm onSubmit={handleSchedule} />;
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+function useCreateUserPin(options) {
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (data) => {
+            const client = (0, client_1.getApiClient)();
+            const response = await client.post('/api/v1/user-pins', data);
+            return response.data;
+        },
+        onSuccess: () => {
+            // Invalidate pin queries to reflect new pin
+            queryClient.invalidateQueries({ queryKey: user_pins_1.userPinKeys.all });
+        },
+        ...options,
+    });
+}
+/**
+ * Delete a user pin
+ *
+ * @description
+ * Deactivates a user pin. Users can only delete their own pins.
+ *
+ * @endpoint DELETE /api/v1/user-pins/:id
+ *
+ * @example
+ * ```tsx
+ * import { useDeleteUserPin } from '@growsober/sdk';
+ *
+ * function MyPinCard({ pin }) {
+ *   const deletePin = useDeleteUserPin({
+ *     onSuccess: () => {
+ *       toast.show('Pin removed');
+ *     },
+ *   });
+ *
+ *   return (
+ *     <Card>
+ *       <Text>{pin.activity}</Text>
+ *       <Text>At {pin.locationName}</Text>
+ *       <Button
+ *         onPress={() => deletePin.mutate(pin.id)}
+ *         loading={deletePin.isPending}
+ *       >
+ *         Remove Pin
+ *       </Button>
+ *     </Card>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+function useDeleteUserPin(options) {
+    const queryClient = (0, react_query_1.useQueryClient)();
+    return (0, react_query_1.useMutation)({
+        mutationFn: async (pinId) => {
+            const client = (0, client_1.getApiClient)();
+            await client.delete(`/api/v1/user-pins/${pinId}`);
+        },
+        onSuccess: () => {
+            // Invalidate pin queries to reflect deletion
+            queryClient.invalidateQueries({ queryKey: user_pins_1.userPinKeys.all });
+        },
+        ...options,
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlci1waW5zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2FwaS9tdXRhdGlvbnMvdXNlci1waW5zLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7Ozs7R0FRRzs7QUFzR0gsNENBb0JDO0FBdUNELDRDQWdCQztBQS9LRCx1REFLK0I7QUFDL0Isc0NBQXlDO0FBQ3pDLG9EQUE2RTtBQWlCN0UsK0VBQStFO0FBQy9FLGlCQUFpQjtBQUNqQiwrRUFBK0U7QUFFL0U7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBdUVHO0FBQ0gsU0FBZ0IsZ0JBQWdCLENBQzlCLE9BR0M7SUFFRCxNQUFNLFdBQVcsR0FBRyxJQUFBLDRCQUFjLEdBQUUsQ0FBQztJQUVyQyxPQUFPLElBQUEseUJBQVcsRUFBQztRQUNqQixVQUFVLEVBQUUsS0FBSyxFQUFFLElBQXNCLEVBQTRCLEVBQUU7WUFDckUsTUFBTSxNQUFNLEdBQUcsSUFBQSxxQkFBWSxHQUFFLENBQUM7WUFDOUIsTUFBTSxRQUFRLEdBQUcsTUFBTSxNQUFNLENBQUMsSUFBSSxDQUFrQixtQkFBbUIsRUFBRSxJQUFJLENBQUMsQ0FBQztZQUMvRSxPQUFPLFFBQVEsQ0FBQyxJQUFJLENBQUM7UUFDdkIsQ0FBQztRQUNELFNBQVMsRUFBRSxHQUFHLEVBQUU7WUFDZCw0Q0FBNEM7WUFDNUMsV0FBVyxDQUFDLGlCQUFpQixDQUFDLEVBQUUsUUFBUSxFQUFFLHVCQUFXLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQztRQUMvRCxDQUFDO1FBQ0QsR0FBRyxPQUFPO0tBQ1gsQ0FBQyxDQUFDO0FBQ0wsQ0FBQztBQUVEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FvQ0c7QUFDSCxTQUFnQixnQkFBZ0IsQ0FDOUIsT0FBcUU7SUFFckUsTUFBTSxXQUFXLEdBQUcsSUFBQSw0QkFBYyxHQUFFLENBQUM7SUFFckMsT0FBTyxJQUFBLHlCQUFXLEVBQUM7UUFDakIsVUFBVSxFQUFFLEtBQUssRUFBRSxLQUFhLEVBQWlCLEVBQUU7WUFDakQsTUFBTSxNQUFNLEdBQUcsSUFBQSxxQkFBWSxHQUFFLENBQUM7WUFDOUIsTUFBTSxNQUFNLENBQUMsTUFBTSxDQUFDLHFCQUFxQixLQUFLLEVBQUUsQ0FBQyxDQUFDO1FBQ3BELENBQUM7UUFDRCxTQUFTLEVBQUUsR0FBRyxFQUFFO1lBQ2QsNkNBQTZDO1lBQzdDLFdBQVcsQ0FBQyxpQkFBaUIsQ0FBQyxFQUFFLFFBQVEsRUFBRSx1QkFBVyxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUM7UUFDL0QsQ0FBQztRQUNELEdBQUcsT0FBTztLQUNYLENBQUMsQ0FBQztBQUNMLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFVzZXIgUGlucyBNdXRhdGlvbiBIb29rc1xuICpcbiAqIFRhblN0YWNrIFF1ZXJ5IG11dGF0aW9uIGhvb2tzIGZvciB1c2VyIHBpbiBvcGVyYXRpb25zLlxuICogVGhlc2UgaG9va3MgaGFuZGxlIGNyZWF0aW5nIGFuZCBkZWxldGluZyB1c2VyIHBpbnNcbiAqIChcIkknbSBoZXJlIG5vd1wiIC8gXCJJJ2xsIGJlIHRoZXJlXCIpLlxuICpcbiAqIEBtb2R1bGUgYXBpL211dGF0aW9ucy91c2VyLXBpbnNcbiAqL1xuXG5pbXBvcnQge1xuICB1c2VNdXRhdGlvbixcbiAgVXNlTXV0YXRpb25PcHRpb25zLFxuICBVc2VNdXRhdGlvblJlc3VsdCxcbiAgdXNlUXVlcnlDbGllbnQsXG59IGZyb20gJ0B0YW5zdGFjay9yZWFjdC1xdWVyeSc7XG5pbXBvcnQgeyBnZXRBcGlDbGllbnQgfSBmcm9tICcuLi9jbGllbnQnO1xuaW1wb3J0IHsgdXNlclBpbktleXMsIFVzZXJQaW5SZXNwb25zZSwgUGluVHlwZSB9IGZyb20gJy4uL3F1ZXJpZXMvdXNlci1waW5zJztcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gUkVRVUVTVCBUWVBFU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgaW50ZXJmYWNlIENyZWF0ZVBpblJlcXVlc3Qge1xuICB0eXBlOiBQaW5UeXBlO1xuICBsYXRpdHVkZTogbnVtYmVyO1xuICBsb25naXR1ZGU6IG51bWJlcjtcbiAgbG9jYXRpb25OYW1lPzogc3RyaW5nO1xuICBhY3Rpdml0eTogc3RyaW5nO1xuICB2ZW51ZUlkPzogc3RyaW5nO1xuICBzY2hlZHVsZWRUaW1lPzogc3RyaW5nOyAvLyBJU08gZGF0ZSBzdHJpbmcsIHJlcXVpcmVkIGZvciBTQ0hFRFVMRUQgdHlwZVxuICBkdXJhdGlvbj86IG51bWJlcjsgLy8gbWludXRlcywgZGVmYXVsdCA2MCBmb3IgSEVSRV9OT1csIDEyMCBmb3IgU0NIRURVTEVEXG59XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIE1VVEFUSU9OIEhPT0tTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbi8qKlxuICogQ3JlYXRlIGEgbmV3IHVzZXIgcGluXG4gKlxuICogQGRlc2NyaXB0aW9uXG4gKiBDcmVhdGVzIGEgbmV3IHBpbiBzaG93aW5nIHdoZXJlIHRoZSB1c2VyIGlzIG9yIHdpbGwgYmUuXG4gKiBBbnkgZXhpc3RpbmcgYWN0aXZlIHBpbiBpcyBhdXRvbWF0aWNhbGx5IGRlYWN0aXZhdGVkLlxuICpcbiAqIFR3byB0eXBlcyBvZiBwaW5zOlxuICogLSBIRVJFX05PVzogVXNlciBpcyBjdXJyZW50bHkgYXQgdGhpcyBsb2NhdGlvbiAoZGVmYXVsdCAxIGhvdXIgZHVyYXRpb24pXG4gKiAtIFNDSEVEVUxFRDogVXNlciB3aWxsIGJlIGF0IHRoaXMgbG9jYXRpb24gYXQgYSBzcGVjaWZpYyB0aW1lIChkZWZhdWx0IDIgaG91ciBkdXJhdGlvbilcbiAqXG4gKiBAZW5kcG9pbnQgUE9TVCAvYXBpL3YxL3VzZXItcGluc1xuICpcbiAqIEBleGFtcGxlXG4gKiBEcm9wIGEgXCJJJ20gaGVyZSBub3dcIiBwaW46XG4gKiBgYGB0c3hcbiAqIGltcG9ydCB7IHVzZUNyZWF0ZVVzZXJQaW4gfSBmcm9tICdAZ3Jvd3NvYmVyL3Nkayc7XG4gKlxuICogZnVuY3Rpb24gRHJvcFBpbkJ1dHRvbih7IGxvY2F0aW9uIH0pIHtcbiAqICAgY29uc3QgY3JlYXRlUGluID0gdXNlQ3JlYXRlVXNlclBpbigpO1xuICpcbiAqICAgY29uc3QgaGFuZGxlRHJvcFBpbiA9ICgpID0+IHtcbiAqICAgICBjcmVhdGVQaW4ubXV0YXRlKHtcbiAqICAgICAgIHR5cGU6ICdIRVJFX05PVycsXG4gKiAgICAgICBsYXRpdHVkZTogbG9jYXRpb24ubGF0LFxuICogICAgICAgbG9uZ2l0dWRlOiBsb2NhdGlvbi5sbmcsXG4gKiAgICAgICBsb2NhdGlvbk5hbWU6ICdGYWJyaWNhIENvZmZlZScsXG4gKiAgICAgICBhY3Rpdml0eTogJ1dvcmtpbmcgcmVtb3RlbHknLFxuICogICAgICAgZHVyYXRpb246IDEyMCwgLy8gMiBob3Vyc1xuICogICAgIH0pO1xuICogICB9O1xuICpcbiAqICAgcmV0dXJuIChcbiAqICAgICA8QnV0dG9uIG9uUHJlc3M9e2hhbmRsZURyb3BQaW59IGxvYWRpbmc9e2NyZWF0ZVBpbi5pc1BlbmRpbmd9PlxuICogICAgICAgRHJvcCBQaW5cbiAqICAgICA8L0J1dHRvbj5cbiAqICAgKTtcbiAqIH1cbiAqIGBgYFxuICpcbiAqIEBleGFtcGxlXG4gKiBTY2hlZHVsZSBhIHBpbiBmb3IgbGF0ZXI6XG4gKiBgYGB0c3hcbiAqIGltcG9ydCB7IHVzZUNyZWF0ZVVzZXJQaW4gfSBmcm9tICdAZ3Jvd3NvYmVyL3Nkayc7XG4gKlxuICogZnVuY3Rpb24gU2NoZWR1bGVQaW5Gb3JtKCkge1xuICogICBjb25zdCBjcmVhdGVQaW4gPSB1c2VDcmVhdGVVc2VyUGluKHtcbiAqICAgICBvblN1Y2Nlc3M6ICgpID0+IHtcbiAqICAgICAgIHRvYXN0LnNob3coJ1BpbiBzY2hlZHVsZWQhJyk7XG4gKiAgICAgfSxcbiAqICAgfSk7XG4gKlxuICogICBjb25zdCBoYW5kbGVTY2hlZHVsZSA9IChkYXRhKSA9PiB7XG4gKiAgICAgY3JlYXRlUGluLm11dGF0ZSh7XG4gKiAgICAgICB0eXBlOiAnU0NIRURVTEVEJyxcbiAqICAgICAgIGxhdGl0dWRlOiBkYXRhLnZlbnVlLmxhdCxcbiAqICAgICAgIGxvbmdpdHVkZTogZGF0YS52ZW51ZS5sbmcsXG4gKiAgICAgICBsb2NhdGlvbk5hbWU6IGRhdGEudmVudWUubmFtZSxcbiAqICAgICAgIHZlbnVlSWQ6IGRhdGEudmVudWUuaWQsXG4gKiAgICAgICBhY3Rpdml0eTogJ0NvZmZlZSBtZWV0dXAnLFxuICogICAgICAgc2NoZWR1bGVkVGltZTogZGF0YS50aW1lLnRvSVNPU3RyaW5nKCksXG4gKiAgICAgICBkdXJhdGlvbjogOTAsXG4gKiAgICAgfSk7XG4gKiAgIH07XG4gKlxuICogICByZXR1cm4gPFNjaGVkdWxlRm9ybSBvblN1Ym1pdD17aGFuZGxlU2NoZWR1bGV9IC8+O1xuICogfVxuICogYGBgXG4gKlxuICogQHBhcmFtIG9wdGlvbnMgLSBUYW5TdGFjayBRdWVyeSBtdXRhdGlvbiBvcHRpb25zXG4gKiBAcmV0dXJucyBUYW5TdGFjayBRdWVyeSBtdXRhdGlvbiByZXN1bHRcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHVzZUNyZWF0ZVVzZXJQaW4oXG4gIG9wdGlvbnM/OiBPbWl0PFxuICAgIFVzZU11dGF0aW9uT3B0aW9uczxVc2VyUGluUmVzcG9uc2UsIEVycm9yLCBDcmVhdGVQaW5SZXF1ZXN0PixcbiAgICAnbXV0YXRpb25GbidcbiAgPlxuKTogVXNlTXV0YXRpb25SZXN1bHQ8VXNlclBpblJlc3BvbnNlLCBFcnJvciwgQ3JlYXRlUGluUmVxdWVzdD4ge1xuICBjb25zdCBxdWVyeUNsaWVudCA9IHVzZVF1ZXJ5Q2xpZW50KCk7XG5cbiAgcmV0dXJuIHVzZU11dGF0aW9uKHtcbiAgICBtdXRhdGlvbkZuOiBhc3luYyAoZGF0YTogQ3JlYXRlUGluUmVxdWVzdCk6IFByb21pc2U8VXNlclBpblJlc3BvbnNlPiA9PiB7XG4gICAgICBjb25zdCBjbGllbnQgPSBnZXRBcGlDbGllbnQoKTtcbiAgICAgIGNvbnN0IHJlc3BvbnNlID0gYXdhaXQgY2xpZW50LnBvc3Q8VXNlclBpblJlc3BvbnNlPignL2FwaS92MS91c2VyLXBpbnMnLCBkYXRhKTtcbiAgICAgIHJldHVybiByZXNwb25zZS5kYXRhO1xuICAgIH0sXG4gICAgb25TdWNjZXNzOiAoKSA9PiB7XG4gICAgICAvLyBJbnZhbGlkYXRlIHBpbiBxdWVyaWVzIHRvIHJlZmxlY3QgbmV3IHBpblxuICAgICAgcXVlcnlDbGllbnQuaW52YWxpZGF0ZVF1ZXJpZXMoeyBxdWVyeUtleTogdXNlclBpbktleXMuYWxsIH0pO1xuICAgIH0sXG4gICAgLi4ub3B0aW9ucyxcbiAgfSk7XG59XG5cbi8qKlxuICogRGVsZXRlIGEgdXNlciBwaW5cbiAqXG4gKiBAZGVzY3JpcHRpb25cbiAqIERlYWN0aXZhdGVzIGEgdXNlciBwaW4uIFVzZXJzIGNhbiBvbmx5IGRlbGV0ZSB0aGVpciBvd24gcGlucy5cbiAqXG4gKiBAZW5kcG9pbnQgREVMRVRFIC9hcGkvdjEvdXNlci1waW5zLzppZFxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c3hcbiAqIGltcG9ydCB7IHVzZURlbGV0ZVVzZXJQaW4gfSBmcm9tICdAZ3Jvd3NvYmVyL3Nkayc7XG4gKlxuICogZnVuY3Rpb24gTXlQaW5DYXJkKHsgcGluIH0pIHtcbiAqICAgY29uc3QgZGVsZXRlUGluID0gdXNlRGVsZXRlVXNlclBpbih7XG4gKiAgICAgb25TdWNjZXNzOiAoKSA9PiB7XG4gKiAgICAgICB0b2FzdC5zaG93KCdQaW4gcmVtb3ZlZCcpO1xuICogICAgIH0sXG4gKiAgIH0pO1xuICpcbiAqICAgcmV0dXJuIChcbiAqICAgICA8Q2FyZD5cbiAqICAgICAgIDxUZXh0PntwaW4uYWN0aXZpdHl9PC9UZXh0PlxuICogICAgICAgPFRleHQ+QXQge3Bpbi5sb2NhdGlvbk5hbWV9PC9UZXh0PlxuICogICAgICAgPEJ1dHRvblxuICogICAgICAgICBvblByZXNzPXsoKSA9PiBkZWxldGVQaW4ubXV0YXRlKHBpbi5pZCl9XG4gKiAgICAgICAgIGxvYWRpbmc9e2RlbGV0ZVBpbi5pc1BlbmRpbmd9XG4gKiAgICAgICA+XG4gKiAgICAgICAgIFJlbW92ZSBQaW5cbiAqICAgICAgIDwvQnV0dG9uPlxuICogICAgIDwvQ2FyZD5cbiAqICAgKTtcbiAqIH1cbiAqIGBgYFxuICpcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGFuU3RhY2sgUXVlcnkgbXV0YXRpb24gb3B0aW9uc1xuICogQHJldHVybnMgVGFuU3RhY2sgUXVlcnkgbXV0YXRpb24gcmVzdWx0XG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB1c2VEZWxldGVVc2VyUGluKFxuICBvcHRpb25zPzogT21pdDxVc2VNdXRhdGlvbk9wdGlvbnM8dm9pZCwgRXJyb3IsIHN0cmluZz4sICdtdXRhdGlvbkZuJz5cbik6IFVzZU11dGF0aW9uUmVzdWx0PHZvaWQsIEVycm9yLCBzdHJpbmc+IHtcbiAgY29uc3QgcXVlcnlDbGllbnQgPSB1c2VRdWVyeUNsaWVudCgpO1xuXG4gIHJldHVybiB1c2VNdXRhdGlvbih7XG4gICAgbXV0YXRpb25GbjogYXN5bmMgKHBpbklkOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+ID0+IHtcbiAgICAgIGNvbnN0IGNsaWVudCA9IGdldEFwaUNsaWVudCgpO1xuICAgICAgYXdhaXQgY2xpZW50LmRlbGV0ZShgL2FwaS92MS91c2VyLXBpbnMvJHtwaW5JZH1gKTtcbiAgICB9LFxuICAgIG9uU3VjY2VzczogKCkgPT4ge1xuICAgICAgLy8gSW52YWxpZGF0ZSBwaW4gcXVlcmllcyB0byByZWZsZWN0IGRlbGV0aW9uXG4gICAgICBxdWVyeUNsaWVudC5pbnZhbGlkYXRlUXVlcmllcyh7IHF1ZXJ5S2V5OiB1c2VyUGluS2V5cy5hbGwgfSk7XG4gICAgfSxcbiAgICAuLi5vcHRpb25zLFxuICB9KTtcbn1cbiJdfQ==

package/dist/api/queries/index.d.ts

@@ -22,3 +22,4 @@ export * from './ambassadors';
 export * from './grow90';
 export * from './matching';
 export * from './event-chat';
+export * from './user-pins';

package/dist/api/queries/index.js

@@ -38,4 +38,5 @@ __exportStar(require("./ambassadors"), exports);
 __exportStar(require("./grow90"), exports);
 __exportStar(require("./matching"), exports);
 __exportStar(require("./event-chat"), exports);
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYXBpL3F1ZXJpZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7O0dBSUc7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFSCwwQ0FBd0I7QUFDeEIseUNBQXVCO0FBQ3ZCLDZDQUEyQjtBQUMzQiwrQ0FBNkI7QUFDN0IsMkNBQXlCO0FBQ3pCLDJDQUF5QjtBQUN6Qix5Q0FBdUI7QUFDdkIsNENBQTBCO0FBQzFCLHdDQUFzQjtBQUN0QixrREFBZ0M7QUFDaEMsMkNBQXlCO0FBQ3pCLGtEQUFnQztBQUNoQyw0Q0FBMEI7QUFDMUIsMENBQXdCO0FBQ3hCLHlDQUF1QjtBQUN2QixnREFBOEI7QUFDOUIsMkNBQXlCO0FBQ3pCLDZDQUEyQjtBQUMzQiwrQ0FBNkIiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFF1ZXJ5IEhvb2tzXG4gKlxuICogUmUtZXhwb3J0cyBhbGwgcXVlcnkgaG9va3MgZm9yIEFQSSBlbmRwb2ludHMuXG4gKi9cblxuZXhwb3J0ICogZnJvbSAnLi9hZG1pbic7XG5leHBvcnQgKiBmcm9tICcuL2F1dGgnO1xuZXhwb3J0ICogZnJvbSAnLi9ib29raW5ncyc7XG5leHBvcnQgKiBmcm9tICcuL2J1c2luZXNzZXMnO1xuZXhwb3J0ICogZnJvbSAnLi9jaXRpZXMnO1xuZXhwb3J0ICogZnJvbSAnLi9ldmVudHMnO1xuZXhwb3J0ICogZnJvbSAnLi9odWJzJztcbmV4cG9ydCAqIGZyb20gJy4vbGlicmFyeSc7XG5leHBvcnQgKiBmcm9tICcuL21hcCc7XG5leHBvcnQgKiBmcm9tICcuL25vdGlmaWNhdGlvbnMnO1xuZXhwb3J0ICogZnJvbSAnLi9vZmZlcnMnO1xuZXhwb3J0ICogZnJvbSAnLi9zdWJzY3JpcHRpb25zJztcbmV4cG9ydCAqIGZyb20gJy4vc3VwcG9ydCc7XG5leHBvcnQgKiBmcm9tICcuL3VzZXJzJztcbmV4cG9ydCAqIGZyb20gJy4vamFjayc7XG5leHBvcnQgKiBmcm9tICcuL2FtYmFzc2Fkb3JzJztcbmV4cG9ydCAqIGZyb20gJy4vZ3JvdzkwJztcbmV4cG9ydCAqIGZyb20gJy4vbWF0Y2hpbmcnO1xuZXhwb3J0ICogZnJvbSAnLi9ldmVudC1jaGF0JztcbiJdfQ==
+__exportStar(require("./user-pins"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvYXBpL3F1ZXJpZXMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7O0dBSUc7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFSCwwQ0FBd0I7QUFDeEIseUNBQXVCO0FBQ3ZCLDZDQUEyQjtBQUMzQiwrQ0FBNkI7QUFDN0IsMkNBQXlCO0FBQ3pCLDJDQUF5QjtBQUN6Qix5Q0FBdUI7QUFDdkIsNENBQTBCO0FBQzFCLHdDQUFzQjtBQUN0QixrREFBZ0M7QUFDaEMsMkNBQXlCO0FBQ3pCLGtEQUFnQztBQUNoQyw0Q0FBMEI7QUFDMUIsMENBQXdCO0FBQ3hCLHlDQUF1QjtBQUN2QixnREFBOEI7QUFDOUIsMkNBQXlCO0FBQ3pCLDZDQUEyQjtBQUMzQiwrQ0FBNkI7QUFDN0IsOENBQTRCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBRdWVyeSBIb29rc1xuICpcbiAqIFJlLWV4cG9ydHMgYWxsIHF1ZXJ5IGhvb2tzIGZvciBBUEkgZW5kcG9pbnRzLlxuICovXG5cbmV4cG9ydCAqIGZyb20gJy4vYWRtaW4nO1xuZXhwb3J0ICogZnJvbSAnLi9hdXRoJztcbmV4cG9ydCAqIGZyb20gJy4vYm9va2luZ3MnO1xuZXhwb3J0ICogZnJvbSAnLi9idXNpbmVzc2VzJztcbmV4cG9ydCAqIGZyb20gJy4vY2l0aWVzJztcbmV4cG9ydCAqIGZyb20gJy4vZXZlbnRzJztcbmV4cG9ydCAqIGZyb20gJy4vaHVicyc7XG5leHBvcnQgKiBmcm9tICcuL2xpYnJhcnknO1xuZXhwb3J0ICogZnJvbSAnLi9tYXAnO1xuZXhwb3J0ICogZnJvbSAnLi9ub3RpZmljYXRpb25zJztcbmV4cG9ydCAqIGZyb20gJy4vb2ZmZXJzJztcbmV4cG9ydCAqIGZyb20gJy4vc3Vic2NyaXB0aW9ucyc7XG5leHBvcnQgKiBmcm9tICcuL3N1cHBvcnQnO1xuZXhwb3J0ICogZnJvbSAnLi91c2Vycyc7XG5leHBvcnQgKiBmcm9tICcuL2phY2snO1xuZXhwb3J0ICogZnJvbSAnLi9hbWJhc3NhZG9ycyc7XG5leHBvcnQgKiBmcm9tICcuL2dyb3c5MCc7XG5leHBvcnQgKiBmcm9tICcuL21hdGNoaW5nJztcbmV4cG9ydCAqIGZyb20gJy4vZXZlbnQtY2hhdCc7XG5leHBvcnQgKiBmcm9tICcuL3VzZXItcGlucyc7XG4iXX0=

package/dist/api/queries/user-pins.d.ts

@@ -0,0 +1,134 @@
+/**
+ * User Pins Query Hooks
+ *
+ * TanStack Query hooks for user pin read operations.
+ * These hooks handle fetching user pins for the map feature
+ * ("I'm here now" / "I'll be there").
+ *
+ * @module api/queries/user-pins
+ */
+import { UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+export type PinType = 'HERE_NOW' | 'SCHEDULED';
+export interface UserPinResponse {
+    id: string;
+    userId: string;
+    type: PinType;
+    latitude: number;
+    longitude: number;
+    locationName: string | null;
+    activity: string;
+    venueId: string | null;
+    scheduledTime: string | null;
+    expiresAt: string;
+    duration: number | null;
+    isActive: boolean;
+    createdAt: string;
+    user?: {
+        id: string;
+        name: string | null;
+        profileImage: string | null;
+    };
+    venue?: {
+        id: string;
+        name: string;
+        slug: string | null;
+    };
+}
+export interface NearbyPinsResponse {
+    pins: UserPinResponse[];
+    total: number;
+}
+/**
+ * Query key factory for user pin queries
+ */
+export declare const userPinKeys: {
+    all: readonly ["user-pins"];
+    nearby: (params: NearbyPinsParams) => readonly ["user-pins", "nearby", NearbyPinsParams];
+    me: () => readonly ["user-pins", "me"];
+};
+export interface NearbyPinsParams {
+    lat: number;
+    lng: number;
+    radius?: number;
+}
+/**
+ * Get nearby user pins
+ *
+ * @description
+ * Retrieves active user pins within a radius of a location.
+ * Shows where other GrowSober members are or will be.
+ *
+ * @endpoint GET /api/v1/user-pins/nearby
+ *
+ * @example
+ * ```tsx
+ * import { useNearbyPins } from '@growsober/sdk';
+ *
+ * function MapWithPins() {
+ *   const { data, isLoading } = useNearbyPins({
+ *     lat: 38.7097,
+ *     lng: -9.1367,
+ *     radius: 5, // 5km radius
+ *   });
+ *
+ *   return (
+ *     <Map>
+ *       {data?.pins.map(pin => (
+ *         <Marker
+ *           key={pin.id}
+ *           position={[pin.latitude, pin.longitude]}
+ *           icon={pin.type === 'HERE_NOW' ? 'here' : 'scheduled'}
+ *         >
+ *           <Popup>
+ *             <p>{pin.user?.name}</p>
+ *             <p>{pin.activity}</p>
+ *           </Popup>
+ *         </Marker>
+ *       ))}
+ *     </Map>
+ *   );
+ * }
+ * ```
+ *
+ * @param params - Location and radius parameters
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with nearby pins
+ */
+export declare function useNearbyPins(params: NearbyPinsParams, options?: Omit<UseQueryOptions<NearbyPinsResponse>, 'queryKey' | 'queryFn'>): UseQueryResult<NearbyPinsResponse>;
+/**
+ * Get current user's active pins
+ *
+ * @description
+ * Retrieves the authenticated user's active pins.
+ * Users can have at most one active pin at a time.
+ *
+ * @endpoint GET /api/v1/user-pins/me
+ *
+ * @example
+ * ```tsx
+ * import { useMyPins } from '@growsober/sdk';
+ *
+ * function MyPinStatus() {
+ *   const { data: pins, isLoading } = useMyPins();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   if (!pins?.length) {
+ *     return <Text>You haven't dropped a pin yet</Text>;
+ *   }
+ *
+ *   const pin = pins[0];
+ *   return (
+ *     <View>
+ *       <Text>You're at {pin.locationName}</Text>
+ *       <Text>Activity: {pin.activity}</Text>
+ *       <Text>Expires: {formatTime(pin.expiresAt)}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with user's active pins
+ */
+export declare function useMyPins(options?: Omit<UseQueryOptions<UserPinResponse[]>, 'queryKey' | 'queryFn'>): UseQueryResult<UserPinResponse[]>;

package/dist/api/queries/user-pins.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * User Pins Query Hooks
+ *
+ * TanStack Query hooks for user pin read operations.
+ * These hooks handle fetching user pins for the map feature
+ * ("I'm here now" / "I'll be there").
+ *
+ * @module api/queries/user-pins
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userPinKeys = void 0;
+exports.useNearbyPins = useNearbyPins;
+exports.useMyPins = useMyPins;
+const react_query_1 = require("@tanstack/react-query");
+const client_1 = require("../client");
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+/**
+ * Query key factory for user pin queries
+ */
+exports.userPinKeys = {
+    all: ['user-pins'],
+    nearby: (params) => [...exports.userPinKeys.all, 'nearby', params],
+    me: () => [...exports.userPinKeys.all, 'me'],
+};
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+/**
+ * Get nearby user pins
+ *
+ * @description
+ * Retrieves active user pins within a radius of a location.
+ * Shows where other GrowSober members are or will be.
+ *
+ * @endpoint GET /api/v1/user-pins/nearby
+ *
+ * @example
+ * ```tsx
+ * import { useNearbyPins } from '@growsober/sdk';
+ *
+ * function MapWithPins() {
+ *   const { data, isLoading } = useNearbyPins({
+ *     lat: 38.7097,
+ *     lng: -9.1367,
+ *     radius: 5, // 5km radius
+ *   });
+ *
+ *   return (
+ *     <Map>
+ *       {data?.pins.map(pin => (
+ *         <Marker
+ *           key={pin.id}
+ *           position={[pin.latitude, pin.longitude]}
+ *           icon={pin.type === 'HERE_NOW' ? 'here' : 'scheduled'}
+ *         >
+ *           <Popup>
+ *             <p>{pin.user?.name}</p>
+ *             <p>{pin.activity}</p>
+ *           </Popup>
+ *         </Marker>
+ *       ))}
+ *     </Map>
+ *   );
+ * }
+ * ```
+ *
+ * @param params - Location and radius parameters
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with nearby pins
+ */
+function useNearbyPins(params, options) {
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.userPinKeys.nearby(params),
+        queryFn: async () => {
+            const client = (0, client_1.getApiClient)();
+            const response = await client.get('/api/v1/user-pins/nearby', {
+                params: {
+                    lat: params.lat,
+                    lng: params.lng,
+                    radius: params.radius,
+                },
+            });
+            return response.data;
+        },
+        enabled: params.lat !== undefined && params.lng !== undefined,
+        staleTime: 30 * 1000, // 30 seconds - pins change frequently
+        ...options,
+    });
+}
+/**
+ * Get current user's active pins
+ *
+ * @description
+ * Retrieves the authenticated user's active pins.
+ * Users can have at most one active pin at a time.
+ *
+ * @endpoint GET /api/v1/user-pins/me
+ *
+ * @example
+ * ```tsx
+ * import { useMyPins } from '@growsober/sdk';
+ *
+ * function MyPinStatus() {
+ *   const { data: pins, isLoading } = useMyPins();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   if (!pins?.length) {
+ *     return <Text>You haven't dropped a pin yet</Text>;
+ *   }
+ *
+ *   const pin = pins[0];
+ *   return (
+ *     <View>
+ *       <Text>You're at {pin.locationName}</Text>
+ *       <Text>Activity: {pin.activity}</Text>
+ *       <Text>Expires: {formatTime(pin.expiresAt)}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with user's active pins
+ */
+function useMyPins(options) {
+    return (0, react_query_1.useQuery)({
+        queryKey: exports.userPinKeys.me(),
+        queryFn: async () => {
+            const client = (0, client_1.getApiClient)();
+            const response = await client.get('/api/v1/user-pins/me');
+            return response.data;
+        },
+        staleTime: 60 * 1000, // 1 minute
+        ...options,
+    });
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNlci1waW5zLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL2FwaS9xdWVyaWVzL3VzZXItcGlucy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7Ozs7Ozs7O0dBUUc7OztBQWdISCxzQ0FxQkM7QUFzQ0QsOEJBYUM7QUF0TEQsdURBQWtGO0FBQ2xGLHNDQUF5QztBQXVDekMsK0VBQStFO0FBQy9FLGFBQWE7QUFDYiwrRUFBK0U7QUFFL0U7O0dBRUc7QUFDVSxRQUFBLFdBQVcsR0FBRztJQUN6QixHQUFHLEVBQUUsQ0FBQyxXQUFXLENBQVU7SUFDM0IsTUFBTSxFQUFFLENBQUMsTUFBd0IsRUFBRSxFQUFFLENBQUMsQ0FBQyxHQUFHLG1CQUFXLENBQUMsR0FBRyxFQUFFLFFBQVEsRUFBRSxNQUFNLENBQVU7SUFDckYsRUFBRSxFQUFFLEdBQUcsRUFBRSxDQUFDLENBQUMsR0FBRyxtQkFBVyxDQUFDLEdBQUcsRUFBRSxJQUFJLENBQVU7Q0FDOUMsQ0FBQztBQVlGLCtFQUErRTtBQUMvRSxjQUFjO0FBQ2QsK0VBQStFO0FBRS9FOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0EwQ0c7QUFDSCxTQUFnQixhQUFhLENBQzNCLE1BQXdCLEVBQ3hCLE9BQTJFO0lBRTNFLE9BQU8sSUFBQSxzQkFBUSxFQUFDO1FBQ2QsUUFBUSxFQUFFLG1CQUFXLENBQUMsTUFBTSxDQUFDLE1BQU0sQ0FBQztRQUNwQyxPQUFPLEVBQUUsS0FBSyxJQUFpQyxFQUFFO1lBQy9DLE1BQU0sTUFBTSxHQUFHLElBQUEscUJBQVksR0FBRSxDQUFDO1lBQzlCLE1BQU0sUUFBUSxHQUFHLE1BQU0sTUFBTSxDQUFDLEdBQUcsQ0FBcUIsMEJBQTBCLEVBQUU7Z0JBQ2hGLE1BQU0sRUFBRTtvQkFDTixHQUFHLEVBQUUsTUFBTSxDQUFDLEdBQUc7b0JBQ2YsR0FBRyxFQUFFLE1BQU0sQ0FBQyxHQUFHO29CQUNmLE1BQU0sRUFBRSxNQUFNLENBQUMsTUFBTTtpQkFDdEI7YUFDRixDQUFDLENBQUM7WUFDSCxPQUFPLFFBQVEsQ0FBQyxJQUFJLENBQUM7UUFDdkIsQ0FBQztRQUNELE9BQU8sRUFBRSxNQUFNLENBQUMsR0FBRyxLQUFLLFNBQVMsSUFBSSxNQUFNLENBQUMsR0FBRyxLQUFLLFNBQVM7UUFDN0QsU0FBUyxFQUFFLEVBQUUsR0FBRyxJQUFJLEVBQUUsc0NBQXNDO1FBQzVELEdBQUcsT0FBTztLQUNYLENBQUMsQ0FBQztBQUNMLENBQUM7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FtQ0c7QUFDSCxTQUFnQixTQUFTLENBQ3ZCLE9BQTBFO0lBRTFFLE9BQU8sSUFBQSxzQkFBUSxFQUFDO1FBQ2QsUUFBUSxFQUFFLG1CQUFXLENBQUMsRUFBRSxFQUFFO1FBQzFCLE9BQU8sRUFBRSxLQUFLLElBQWdDLEVBQUU7WUFDOUMsTUFBTSxNQUFNLEdBQUcsSUFBQSxxQkFBWSxHQUFFLENBQUM7WUFDOUIsTUFBTSxRQUFRLEdBQUcsTUFBTSxNQUFNLENBQUMsR0FBRyxDQUFvQixzQkFBc0IsQ0FBQyxDQUFDO1lBQzdFLE9BQU8sUUFBUSxDQUFDLElBQUksQ0FBQztRQUN2QixDQUFDO1FBQ0QsU0FBUyxFQUFFLEVBQUUsR0FBRyxJQUFJLEVBQUUsV0FBVztRQUNqQyxHQUFHLE9BQU87S0FDWCxDQUFDLENBQUM7QUFDTCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBVc2VyIFBpbnMgUXVlcnkgSG9va3NcbiAqXG4gKiBUYW5TdGFjayBRdWVyeSBob29rcyBmb3IgdXNlciBwaW4gcmVhZCBvcGVyYXRpb25zLlxuICogVGhlc2UgaG9va3MgaGFuZGxlIGZldGNoaW5nIHVzZXIgcGlucyBmb3IgdGhlIG1hcCBmZWF0dXJlXG4gKiAoXCJJJ20gaGVyZSBub3dcIiAvIFwiSSdsbCBiZSB0aGVyZVwiKS5cbiAqXG4gKiBAbW9kdWxlIGFwaS9xdWVyaWVzL3VzZXItcGluc1xuICovXG5cbmltcG9ydCB7IHVzZVF1ZXJ5LCBVc2VRdWVyeU9wdGlvbnMsIFVzZVF1ZXJ5UmVzdWx0IH0gZnJvbSAnQHRhbnN0YWNrL3JlYWN0LXF1ZXJ5JztcbmltcG9ydCB7IGdldEFwaUNsaWVudCB9IGZyb20gJy4uL2NsaWVudCc7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFRZUEVTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB0eXBlIFBpblR5cGUgPSAnSEVSRV9OT1cnIHwgJ1NDSEVEVUxFRCc7XG5cbmV4cG9ydCBpbnRlcmZhY2UgVXNlclBpblJlc3BvbnNlIHtcbiAgaWQ6IHN0cmluZztcbiAgdXNlcklkOiBzdHJpbmc7XG4gIHR5cGU6IFBpblR5cGU7XG4gIGxhdGl0dWRlOiBudW1iZXI7XG4gIGxvbmdpdHVkZTogbnVtYmVyO1xuICBsb2NhdGlvbk5hbWU6IHN0cmluZyB8IG51bGw7XG4gIGFjdGl2aXR5OiBzdHJpbmc7XG4gIHZlbnVlSWQ6IHN0cmluZyB8IG51bGw7XG4gIHNjaGVkdWxlZFRpbWU6IHN0cmluZyB8IG51bGw7XG4gIGV4cGlyZXNBdDogc3RyaW5nO1xuICBkdXJhdGlvbjogbnVtYmVyIHwgbnVsbDtcbiAgaXNBY3RpdmU6IGJvb2xlYW47XG4gIGNyZWF0ZWRBdDogc3RyaW5nO1xuICB1c2VyPzoge1xuICAgIGlkOiBzdHJpbmc7XG4gICAgbmFtZTogc3RyaW5nIHwgbnVsbDtcbiAgICBwcm9maWxlSW1hZ2U6IHN0cmluZyB8IG51bGw7XG4gIH07XG4gIHZlbnVlPzoge1xuICAgIGlkOiBzdHJpbmc7XG4gICAgbmFtZTogc3RyaW5nO1xuICAgIHNsdWc6IHN0cmluZyB8IG51bGw7XG4gIH07XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgTmVhcmJ5UGluc1Jlc3BvbnNlIHtcbiAgcGluczogVXNlclBpblJlc3BvbnNlW107XG4gIHRvdGFsOiBudW1iZXI7XG59XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFFVRVJZIEtFWVNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuLyoqXG4gKiBRdWVyeSBrZXkgZmFjdG9yeSBmb3IgdXNlciBwaW4gcXVlcmllc1xuICovXG5leHBvcnQgY29uc3QgdXNlclBpbktleXMgPSB7XG4gIGFsbDogWyd1c2VyLXBpbnMnXSBhcyBjb25zdCxcbiAgbmVhcmJ5OiAocGFyYW1zOiBOZWFyYnlQaW5zUGFyYW1zKSA9PiBbLi4udXNlclBpbktleXMuYWxsLCAnbmVhcmJ5JywgcGFyYW1zXSBhcyBjb25zdCxcbiAgbWU6ICgpID0+IFsuLi51c2VyUGluS2V5cy5hbGwsICdtZSddIGFzIGNvbnN0LFxufTtcblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gUEFSQU0gVFlQRVNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IGludGVyZmFjZSBOZWFyYnlQaW5zUGFyYW1zIHtcbiAgbGF0OiBudW1iZXI7XG4gIGxuZzogbnVtYmVyO1xuICByYWRpdXM/OiBudW1iZXI7IC8vIGttLCBkZWZhdWx0IDVcbn1cblxuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuLy8gUVVFUlkgSE9PS1Ncbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuLyoqXG4gKiBHZXQgbmVhcmJ5IHVzZXIgcGluc1xuICpcbiAqIEBkZXNjcmlwdGlvblxuICogUmV0cmlldmVzIGFjdGl2ZSB1c2VyIHBpbnMgd2l0aGluIGEgcmFkaXVzIG9mIGEgbG9jYXRpb24uXG4gKiBTaG93cyB3aGVyZSBvdGhlciBHcm93U29iZXIgbWVtYmVycyBhcmUgb3Igd2lsbCBiZS5cbiAqXG4gKiBAZW5kcG9pbnQgR0VUIC9hcGkvdjEvdXNlci1waW5zL25lYXJieVxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c3hcbiAqIGltcG9ydCB7IHVzZU5lYXJieVBpbnMgfSBmcm9tICdAZ3Jvd3NvYmVyL3Nkayc7XG4gKlxuICogZnVuY3Rpb24gTWFwV2l0aFBpbnMoKSB7XG4gKiAgIGNvbnN0IHsgZGF0YSwgaXNMb2FkaW5nIH0gPSB1c2VOZWFyYnlQaW5zKHtcbiAqICAgICBsYXQ6IDM4LjcwOTcsXG4gKiAgICAgbG5nOiAtOS4xMzY3LFxuICogICAgIHJhZGl1czogNSwgLy8gNWttIHJhZGl1c1xuICogICB9KTtcbiAqXG4gKiAgIHJldHVybiAoXG4gKiAgICAgPE1hcD5cbiAqICAgICAgIHtkYXRhPy5waW5zLm1hcChwaW4gPT4gKFxuICogICAgICAgICA8TWFya2VyXG4gKiAgICAgICAgICAga2V5PXtwaW4uaWR9XG4gKiAgICAgICAgICAgcG9zaXRpb249e1twaW4ubGF0aXR1ZGUsIHBpbi5sb25naXR1ZGVdfVxuICogICAgICAgICAgIGljb249e3Bpbi50eXBlID09PSAnSEVSRV9OT1cnID8gJ2hlcmUnIDogJ3NjaGVkdWxlZCd9XG4gKiAgICAgICAgID5cbiAqICAgICAgICAgICA8UG9wdXA+XG4gKiAgICAgICAgICAgICA8cD57cGluLnVzZXI/Lm5hbWV9PC9wPlxuICogICAgICAgICAgICAgPHA+e3Bpbi5hY3Rpdml0eX08L3A+XG4gKiAgICAgICAgICAgPC9Qb3B1cD5cbiAqICAgICAgICAgPC9NYXJrZXI+XG4gKiAgICAgICApKX1cbiAqICAgICA8L01hcD5cbiAqICAgKTtcbiAqIH1cbiAqIGBgYFxuICpcbiAqIEBwYXJhbSBwYXJhbXMgLSBMb2NhdGlvbiBhbmQgcmFkaXVzIHBhcmFtZXRlcnNcbiAqIEBwYXJhbSBvcHRpb25zIC0gVGFuU3RhY2sgUXVlcnkgb3B0aW9uc1xuICogQHJldHVybnMgVGFuU3RhY2sgUXVlcnkgcmVzdWx0IHdpdGggbmVhcmJ5IHBpbnNcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHVzZU5lYXJieVBpbnMoXG4gIHBhcmFtczogTmVhcmJ5UGluc1BhcmFtcyxcbiAgb3B0aW9ucz86IE9taXQ8VXNlUXVlcnlPcHRpb25zPE5lYXJieVBpbnNSZXNwb25zZT4sICdxdWVyeUtleScgfCAncXVlcnlGbic+XG4pOiBVc2VRdWVyeVJlc3VsdDxOZWFyYnlQaW5zUmVzcG9uc2U+IHtcbiAgcmV0dXJuIHVzZVF1ZXJ5KHtcbiAgICBxdWVyeUtleTogdXNlclBpbktleXMubmVhcmJ5KHBhcmFtcyksXG4gICAgcXVlcnlGbjogYXN5bmMgKCk6IFByb21pc2U8TmVhcmJ5UGluc1Jlc3BvbnNlPiA9PiB7XG4gICAgICBjb25zdCBjbGllbnQgPSBnZXRBcGlDbGllbnQoKTtcbiAgICAgIGNvbnN0IHJlc3BvbnNlID0gYXdhaXQgY2xpZW50LmdldDxOZWFyYnlQaW5zUmVzcG9uc2U+KCcvYXBpL3YxL3VzZXItcGlucy9uZWFyYnknLCB7XG4gICAgICAgIHBhcmFtczoge1xuICAgICAgICAgIGxhdDogcGFyYW1zLmxhdCxcbiAgICAgICAgICBsbmc6IHBhcmFtcy5sbmcsXG4gICAgICAgICAgcmFkaXVzOiBwYXJhbXMucmFkaXVzLFxuICAgICAgICB9LFxuICAgICAgfSk7XG4gICAgICByZXR1cm4gcmVzcG9uc2UuZGF0YTtcbiAgICB9LFxuICAgIGVuYWJsZWQ6IHBhcmFtcy5sYXQgIT09IHVuZGVmaW5lZCAmJiBwYXJhbXMubG5nICE9PSB1bmRlZmluZWQsXG4gICAgc3RhbGVUaW1lOiAzMCAqIDEwMDAsIC8vIDMwIHNlY29uZHMgLSBwaW5zIGNoYW5nZSBmcmVxdWVudGx5XG4gICAgLi4ub3B0aW9ucyxcbiAgfSk7XG59XG5cbi8qKlxuICogR2V0IGN1cnJlbnQgdXNlcidzIGFjdGl2ZSBwaW5zXG4gKlxuICogQGRlc2NyaXB0aW9uXG4gKiBSZXRyaWV2ZXMgdGhlIGF1dGhlbnRpY2F0ZWQgdXNlcidzIGFjdGl2ZSBwaW5zLlxuICogVXNlcnMgY2FuIGhhdmUgYXQgbW9zdCBvbmUgYWN0aXZlIHBpbiBhdCBhIHRpbWUuXG4gKlxuICogQGVuZHBvaW50IEdFVCAvYXBpL3YxL3VzZXItcGlucy9tZVxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c3hcbiAqIGltcG9ydCB7IHVzZU15UGlucyB9IGZyb20gJ0Bncm93c29iZXIvc2RrJztcbiAqXG4gKiBmdW5jdGlvbiBNeVBpblN0YXR1cygpIHtcbiAqICAgY29uc3QgeyBkYXRhOiBwaW5zLCBpc0xvYWRpbmcgfSA9IHVzZU15UGlucygpO1xuICpcbiAqICAgaWYgKGlzTG9hZGluZykgcmV0dXJuIDxTcGlubmVyIC8+O1xuICpcbiAqICAgaWYgKCFwaW5zPy5sZW5ndGgpIHtcbiAqICAgICByZXR1cm4gPFRleHQ+WW91IGhhdmVuJ3QgZHJvcHBlZCBhIHBpbiB5ZXQ8L1RleHQ+O1xuICogICB9XG4gKlxuICogICBjb25zdCBwaW4gPSBwaW5zWzBdO1xuICogICByZXR1cm4gKFxuICogICAgIDxWaWV3PlxuICogICAgICAgPFRleHQ+WW91J3JlIGF0IHtwaW4ubG9jYXRpb25OYW1lfTwvVGV4dD5cbiAqICAgICAgIDxUZXh0PkFjdGl2aXR5OiB7cGluLmFjdGl2aXR5fTwvVGV4dD5cbiAqICAgICAgIDxUZXh0PkV4cGlyZXM6IHtmb3JtYXRUaW1lKHBpbi5leHBpcmVzQXQpfTwvVGV4dD5cbiAqICAgICA8L1ZpZXc+XG4gKiAgICk7XG4gKiB9XG4gKiBgYGBcbiAqXG4gKiBAcGFyYW0gb3B0aW9ucyAtIFRhblN0YWNrIFF1ZXJ5IG9wdGlvbnNcbiAqIEByZXR1cm5zIFRhblN0YWNrIFF1ZXJ5IHJlc3VsdCB3aXRoIHVzZXIncyBhY3RpdmUgcGluc1xuICovXG5leHBvcnQgZnVuY3Rpb24gdXNlTXlQaW5zKFxuICBvcHRpb25zPzogT21pdDxVc2VRdWVyeU9wdGlvbnM8VXNlclBpblJlc3BvbnNlW10+LCAncXVlcnlLZXknIHwgJ3F1ZXJ5Rm4nPlxuKTogVXNlUXVlcnlSZXN1bHQ8VXNlclBpblJlc3BvbnNlW10+IHtcbiAgcmV0dXJuIHVzZVF1ZXJ5KHtcbiAgICBxdWVyeUtleTogdXNlclBpbktleXMubWUoKSxcbiAgICBxdWVyeUZuOiBhc3luYyAoKTogUHJvbWlzZTxVc2VyUGluUmVzcG9uc2VbXT4gPT4ge1xuICAgICAgY29uc3QgY2xpZW50ID0gZ2V0QXBpQ2xpZW50KCk7XG4gICAgICBjb25zdCByZXNwb25zZSA9IGF3YWl0IGNsaWVudC5nZXQ8VXNlclBpblJlc3BvbnNlW10+KCcvYXBpL3YxL3VzZXItcGlucy9tZScpO1xuICAgICAgcmV0dXJuIHJlc3BvbnNlLmRhdGE7XG4gICAgfSxcbiAgICBzdGFsZVRpbWU6IDYwICogMTAwMCwgLy8gMSBtaW51dGVcbiAgICAuLi5vcHRpb25zLFxuICB9KTtcbn1cbiJdfQ==

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@growsober/sdk",
-  "version": "1.0.3",
+  "version": "1.0.4",
   "description": "Shared TypeScript SDK for GrowSober API - TanStack Query hooks, API client, and utilities",
   "main": "dist/index.js",
   "module": "dist/index.js",

package/src/api/mutations/index.ts

@@ -21,3 +21,4 @@ export * from './ambassadors';
 export * from './grow90';
 export * from './matching';
 export * from './event-chat';
+export * from './user-pins';

package/src/api/mutations/user-pins.ts

@@ -0,0 +1,186 @@
+/**
+ * User Pins Mutation Hooks
+ *
+ * TanStack Query mutation hooks for user pin operations.
+ * These hooks handle creating and deleting user pins
+ * ("I'm here now" / "I'll be there").
+ *
+ * @module api/mutations/user-pins
+ */
+
+import {
+  useMutation,
+  UseMutationOptions,
+  UseMutationResult,
+  useQueryClient,
+} from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { userPinKeys, UserPinResponse, PinType } from '../queries/user-pins';
+
+// ============================================================================
+// REQUEST TYPES
+// ============================================================================
+
+export interface CreatePinRequest {
+  type: PinType;
+  latitude: number;
+  longitude: number;
+  locationName?: string;
+  activity: string;
+  venueId?: string;
+  scheduledTime?: string; // ISO date string, required for SCHEDULED type
+  duration?: number; // minutes, default 60 for HERE_NOW, 120 for SCHEDULED
+}
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new user pin
+ *
+ * @description
+ * Creates a new pin showing where the user is or will be.
+ * Any existing active pin is automatically deactivated.
+ *
+ * Two types of pins:
+ * - HERE_NOW: User is currently at this location (default 1 hour duration)
+ * - SCHEDULED: User will be at this location at a specific time (default 2 hour duration)
+ *
+ * @endpoint POST /api/v1/user-pins
+ *
+ * @example
+ * Drop a "I'm here now" pin:
+ * ```tsx
+ * import { useCreateUserPin } from '@growsober/sdk';
+ *
+ * function DropPinButton({ location }) {
+ *   const createPin = useCreateUserPin();
+ *
+ *   const handleDropPin = () => {
+ *     createPin.mutate({
+ *       type: 'HERE_NOW',
+ *       latitude: location.lat,
+ *       longitude: location.lng,
+ *       locationName: 'Fabrica Coffee',
+ *       activity: 'Working remotely',
+ *       duration: 120, // 2 hours
+ *     });
+ *   };
+ *
+ *   return (
+ *     <Button onPress={handleDropPin} loading={createPin.isPending}>
+ *       Drop Pin
+ *     </Button>
+ *   );
+ * }
+ * ```
+ *
+ * @example
+ * Schedule a pin for later:
+ * ```tsx
+ * import { useCreateUserPin } from '@growsober/sdk';
+ *
+ * function SchedulePinForm() {
+ *   const createPin = useCreateUserPin({
+ *     onSuccess: () => {
+ *       toast.show('Pin scheduled!');
+ *     },
+ *   });
+ *
+ *   const handleSchedule = (data) => {
+ *     createPin.mutate({
+ *       type: 'SCHEDULED',
+ *       latitude: data.venue.lat,
+ *       longitude: data.venue.lng,
+ *       locationName: data.venue.name,
+ *       venueId: data.venue.id,
+ *       activity: 'Coffee meetup',
+ *       scheduledTime: data.time.toISOString(),
+ *       duration: 90,
+ *     });
+ *   };
+ *
+ *   return <ScheduleForm onSubmit={handleSchedule} />;
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useCreateUserPin(
+  options?: Omit<
+    UseMutationOptions<UserPinResponse, Error, CreatePinRequest>,
+    'mutationFn'
+  >
+): UseMutationResult<UserPinResponse, Error, CreatePinRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreatePinRequest): Promise<UserPinResponse> => {
+      const client = getApiClient();
+      const response = await client.post<UserPinResponse>('/api/v1/user-pins', data);
+      return response.data;
+    },
+    onSuccess: () => {
+      // Invalidate pin queries to reflect new pin
+      queryClient.invalidateQueries({ queryKey: userPinKeys.all });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Delete a user pin
+ *
+ * @description
+ * Deactivates a user pin. Users can only delete their own pins.
+ *
+ * @endpoint DELETE /api/v1/user-pins/:id
+ *
+ * @example
+ * ```tsx
+ * import { useDeleteUserPin } from '@growsober/sdk';
+ *
+ * function MyPinCard({ pin }) {
+ *   const deletePin = useDeleteUserPin({
+ *     onSuccess: () => {
+ *       toast.show('Pin removed');
+ *     },
+ *   });
+ *
+ *   return (
+ *     <Card>
+ *       <Text>{pin.activity}</Text>
+ *       <Text>At {pin.locationName}</Text>
+ *       <Button
+ *         onPress={() => deletePin.mutate(pin.id)}
+ *         loading={deletePin.isPending}
+ *       >
+ *         Remove Pin
+ *       </Button>
+ *     </Card>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query mutation options
+ * @returns TanStack Query mutation result
+ */
+export function useDeleteUserPin(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (pinId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.delete(`/api/v1/user-pins/${pinId}`);
+    },
+    onSuccess: () => {
+      // Invalidate pin queries to reflect deletion
+      queryClient.invalidateQueries({ queryKey: userPinKeys.all });
+    },
+    ...options,
+  });
+}

package/src/api/queries/index.ts

@@ -23,3 +23,4 @@ export * from './ambassadors';
 export * from './grow90';
 export * from './matching';
 export * from './event-chat';
+export * from './user-pins';

package/src/api/queries/user-pins.ts

@@ -0,0 +1,193 @@
+/**
+ * User Pins Query Hooks
+ *
+ * TanStack Query hooks for user pin read operations.
+ * These hooks handle fetching user pins for the map feature
+ * ("I'm here now" / "I'll be there").
+ *
+ * @module api/queries/user-pins
+ */
+
+import { useQuery, UseQueryOptions, UseQueryResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+
+// ============================================================================
+// TYPES
+// ============================================================================
+
+export type PinType = 'HERE_NOW' | 'SCHEDULED';
+
+export interface UserPinResponse {
+  id: string;
+  userId: string;
+  type: PinType;
+  latitude: number;
+  longitude: number;
+  locationName: string | null;
+  activity: string;
+  venueId: string | null;
+  scheduledTime: string | null;
+  expiresAt: string;
+  duration: number | null;
+  isActive: boolean;
+  createdAt: string;
+  user?: {
+    id: string;
+    name: string | null;
+    profileImage: string | null;
+  };
+  venue?: {
+    id: string;
+    name: string;
+    slug: string | null;
+  };
+}
+
+export interface NearbyPinsResponse {
+  pins: UserPinResponse[];
+  total: number;
+}
+
+// ============================================================================
+// QUERY KEYS
+// ============================================================================
+
+/**
+ * Query key factory for user pin queries
+ */
+export const userPinKeys = {
+  all: ['user-pins'] as const,
+  nearby: (params: NearbyPinsParams) => [...userPinKeys.all, 'nearby', params] as const,
+  me: () => [...userPinKeys.all, 'me'] as const,
+};
+
+// ============================================================================
+// PARAM TYPES
+// ============================================================================
+
+export interface NearbyPinsParams {
+  lat: number;
+  lng: number;
+  radius?: number; // km, default 5
+}
+
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+
+/**
+ * Get nearby user pins
+ *
+ * @description
+ * Retrieves active user pins within a radius of a location.
+ * Shows where other GrowSober members are or will be.
+ *
+ * @endpoint GET /api/v1/user-pins/nearby
+ *
+ * @example
+ * ```tsx
+ * import { useNearbyPins } from '@growsober/sdk';
+ *
+ * function MapWithPins() {
+ *   const { data, isLoading } = useNearbyPins({
+ *     lat: 38.7097,
+ *     lng: -9.1367,
+ *     radius: 5, // 5km radius
+ *   });
+ *
+ *   return (
+ *     <Map>
+ *       {data?.pins.map(pin => (
+ *         <Marker
+ *           key={pin.id}
+ *           position={[pin.latitude, pin.longitude]}
+ *           icon={pin.type === 'HERE_NOW' ? 'here' : 'scheduled'}
+ *         >
+ *           <Popup>
+ *             <p>{pin.user?.name}</p>
+ *             <p>{pin.activity}</p>
+ *           </Popup>
+ *         </Marker>
+ *       ))}
+ *     </Map>
+ *   );
+ * }
+ * ```
+ *
+ * @param params - Location and radius parameters
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with nearby pins
+ */
+export function useNearbyPins(
+  params: NearbyPinsParams,
+  options?: Omit<UseQueryOptions<NearbyPinsResponse>, 'queryKey' | 'queryFn'>
+): UseQueryResult<NearbyPinsResponse> {
+  return useQuery({
+    queryKey: userPinKeys.nearby(params),
+    queryFn: async (): Promise<NearbyPinsResponse> => {
+      const client = getApiClient();
+      const response = await client.get<NearbyPinsResponse>('/api/v1/user-pins/nearby', {
+        params: {
+          lat: params.lat,
+          lng: params.lng,
+          radius: params.radius,
+        },
+      });
+      return response.data;
+    },
+    enabled: params.lat !== undefined && params.lng !== undefined,
+    staleTime: 30 * 1000, // 30 seconds - pins change frequently
+    ...options,
+  });
+}
+
+/**
+ * Get current user's active pins
+ *
+ * @description
+ * Retrieves the authenticated user's active pins.
+ * Users can have at most one active pin at a time.
+ *
+ * @endpoint GET /api/v1/user-pins/me
+ *
+ * @example
+ * ```tsx
+ * import { useMyPins } from '@growsober/sdk';
+ *
+ * function MyPinStatus() {
+ *   const { data: pins, isLoading } = useMyPins();
+ *
+ *   if (isLoading) return <Spinner />;
+ *
+ *   if (!pins?.length) {
+ *     return <Text>You haven't dropped a pin yet</Text>;
+ *   }
+ *
+ *   const pin = pins[0];
+ *   return (
+ *     <View>
+ *       <Text>You're at {pin.locationName}</Text>
+ *       <Text>Activity: {pin.activity}</Text>
+ *       <Text>Expires: {formatTime(pin.expiresAt)}</Text>
+ *     </View>
+ *   );
+ * }
+ * ```
+ *
+ * @param options - TanStack Query options
+ * @returns TanStack Query result with user's active pins
+ */
+export function useMyPins(
+  options?: Omit<UseQueryOptions<UserPinResponse[]>, 'queryKey' | 'queryFn'>
+): UseQueryResult<UserPinResponse[]> {
+  return useQuery({
+    queryKey: userPinKeys.me(),
+    queryFn: async (): Promise<UserPinResponse[]> => {
+      const client = getApiClient();
+      const response = await client.get<UserPinResponse[]>('/api/v1/user-pins/me');
+      return response.data;
+    },
+    staleTime: 60 * 1000, // 1 minute
+    ...options,
+  });
+}