@spotsdev/sdk 1.3.3 → 1.5.0

package/dist/index.d.cts

@@ -0,0 +1,1718 @@
+import { AxiosInstance } from 'axios';
+import { PostType, AccountStatus, SpotType, ResponseStatus, ReportReason, NotificationType, ClaimStatus, ProductResponseDto, OrderStatus, SendOtpDto, VerifyOtpDto, CreatePostDto, CreateReplyDto, CreateResponseDto, UpdateResponseDto, UpdateUserDto, CreateConversationDto, CreateMessageDto, ClaimSpotDto, UpvoteResponseDto, VerifyOtpWrappedResponseDto, ApiResponse, PostStatusDto, ProductType, ProductStatus } from '@spotsdev/types';
+export * from '@spotsdev/types';
+import { UseMutationOptions, UseMutationResult, UseQueryOptions, UseQueryResult, UseInfiniteQueryOptions, UseInfiniteQueryResult } from '@tanstack/react-query';
+
+interface SDKConfig {
+    baseURL: string;
+    getAccessToken: () => string | null | Promise<string | null>;
+    refreshAccessToken?: () => Promise<string>;
+    onUnauthorized?: () => void;
+}
+declare function configureSDK(sdkConfig: SDKConfig): void;
+declare function getApiClient(): AxiosInstance;
+declare function getConfig(): SDKConfig;
+
+/**
+ * Spots SDK Entity Types
+ *
+ * These types mirror the Prisma schema entities but without @prisma/client dependency.
+ * This allows the SDK to work in React Native where Prisma is not available.
+ *
+ * IMPORTANT: Enum types are imported from @spotsdev/types (generated from OpenAPI spec).
+ * types.ts handles re-exporting from spots-types - this file only defines entity interfaces
+ * and SDK-specific types not in the OpenAPI spec.
+ */
+
+type SpotPostType = PostType;
+type ReportStatus = 'PENDING' | 'REVIEWED' | 'RESOLVED' | 'DISMISSED';
+interface UserVibe {
+    id: string;
+    name: string;
+    emoji: string | null;
+    slug?: string;
+    category?: string;
+}
+interface User {
+    id: string;
+    phone: string | null;
+    email: string | null;
+    name: string | null;
+    bio: string | null;
+    avatarUrl: string | null;
+    status: AccountStatus;
+    onboardingCompleted: boolean;
+    vibes?: UserVibe[];
+    lastActiveAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface Spot {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    address: string | null;
+    city: string | null;
+    country: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    lat?: number | null;
+    lng?: number | null;
+    type: SpotType;
+    googlePlaceId: string | null;
+    website: string | null;
+    phone: string | null;
+    imageUrl: string | null;
+    ownerId: string | null;
+    isVerified: boolean;
+    marketplaceEnabled: boolean;
+    createdAt: Date | string;
+    updatedAt: Date | string;
+}
+interface SpotPost {
+    id: string;
+    spotId: string;
+    userId: string;
+    postType: SpotPostType;
+    title: string;
+    content: string | null;
+    emoji: string | null;
+    expiresAt: Date | null;
+    status: 'ACTIVE' | 'FULFILLED' | 'EXPIRED' | 'DELETED';
+    upvoteCount: number;
+    responseCount: number;
+    replyCount: number;
+    createdAt: Date;
+    updatedAt: Date;
+    user?: User;
+    spot?: Spot;
+}
+interface PostReply {
+    id: string;
+    postId: string;
+    userId: string;
+    content: string;
+    createdAt: Date;
+    updatedAt: Date;
+    user?: User;
+}
+interface PostResponse {
+    id: string;
+    postId: string;
+    userId: string;
+    note: string | null;
+    status: ResponseStatus;
+    createdAt: Date;
+    updatedAt: Date;
+    user?: User;
+    post?: SpotPost;
+}
+interface PostUpvote {
+    id: string;
+    postId: string;
+    userId: string;
+    createdAt: Date;
+}
+/**
+ * PostUpvoter - user who upvoted a post (from /posts/:id/upvotes endpoint)
+ */
+interface PostUpvoter {
+    id: string;
+    userId: string;
+    name: string | null;
+    avatarUrl: string | null;
+    createdAt: Date;
+}
+/**
+ * PostUpvotesResponse - response from /posts/:id/upvotes endpoint
+ */
+interface PostUpvotesResponse {
+    data: PostUpvoter[];
+    meta: {
+        total: number;
+        limit: number;
+        offset: number;
+        hasMore: boolean;
+        currentUserUpvoted: boolean;
+        isPostAuthor: boolean;
+    };
+}
+interface PostReport {
+    id: string;
+    postId: string;
+    userId: string;
+    reason: ReportReason;
+    details: string | null;
+    status: ReportStatus;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface Club {
+    id: string;
+    name: string;
+    slug: string;
+    description: string | null;
+    imageUrl: string | null;
+    isPrivate: boolean;
+    createdById: string;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface ClubMember {
+    id: string;
+    clubId: string;
+    userId: string;
+    role: 'MEMBER' | 'ADMIN' | 'OWNER';
+    joinedAt: Date;
+}
+interface Conversation {
+    id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    participants?: User[];
+    messages?: Message[];
+}
+interface Message {
+    id: string;
+    conversationId: string;
+    senderId: string;
+    content: string;
+    createdAt: Date;
+    sender?: User;
+}
+interface Notification {
+    id: string;
+    userId: string;
+    type: NotificationType;
+    title: string;
+    body: string | null;
+    data: Record<string, unknown> | null;
+    isRead: boolean;
+    createdAt: Date;
+}
+interface PostTemplate {
+    id: string;
+    postType: SpotPostType;
+    emoji: string;
+    title: string;
+    placeholder: string | null;
+    isActive: boolean;
+    sortOrder: number;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface Vibe {
+    id: string;
+    name: string;
+    emoji: string | null;
+    createdAt: Date;
+}
+interface Interest {
+    id: string;
+    name: string;
+    emoji: string | null;
+    category: string | null;
+    createdAt: Date;
+}
+interface Intention {
+    id: string;
+    name: string;
+    emoji: string | null;
+    createdAt: Date;
+}
+interface LifeSituation {
+    id: string;
+    name: string;
+    emoji: string | null;
+    createdAt: Date;
+}
+interface FavoriteSpot {
+    id: string;
+    userId: string;
+    spotId: string;
+    createdAt: Date;
+    spot?: Spot;
+}
+interface SpotImage {
+    id: string;
+    spotId: string;
+    url: string;
+    caption: string | null;
+    sortOrder: number;
+    createdAt: Date;
+}
+interface SpotVibe {
+    id: string;
+    spotId: string;
+    vibeId: string;
+    vibe?: Vibe;
+}
+interface SpotIntention {
+    id: string;
+    spotId: string;
+    intentionId: string;
+    intention?: Intention;
+}
+interface SpotClaim {
+    id: string;
+    spotId: string;
+    userId: string;
+    status: ClaimStatus;
+    verificationMethod: string | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface SpotSubscription {
+    id: string;
+    spotId: string;
+    userId: string;
+    createdAt: Date;
+    spot?: Spot;
+}
+interface City {
+    id: string;
+    name: string;
+    country: string;
+    latitude: number;
+    longitude: number;
+    timezone: string | null;
+    createdAt: Date;
+}
+/**
+ * Paginated response with meta information
+ */
+interface PaginatedResponse<T> {
+    data: T[];
+    meta: PaginationMeta;
+}
+interface PaginationMeta {
+    total: number;
+    page: number;
+    limit: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+}
+type Product = ProductResponseDto;
+interface Order {
+    id: string;
+    spotId: string;
+    userId: string;
+    status: OrderStatus;
+    subtotal: number;
+    tax: number;
+    total: number;
+    currency: string;
+    notes: string | null;
+    metadata: Record<string, unknown> | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface OrderItem {
+    id: string;
+    orderId: string;
+    productId: string;
+    quantity: number;
+    unitPrice: number;
+    total: number;
+    createdAt: Date;
+}
+
+/**
+ * Spots SDK Types
+ *
+ * Type sources:
+ * - Entity types (User, Spot, Post, etc.) → from ./entities (local definitions)
+ * - DTO types (CreatePostDto, etc.) → import from @spots/types (OpenAPI generated)
+ *
+ * This file provides type aliases for SDK convenience.
+ */
+
+type SendOtpRequest = SendOtpDto;
+type VerifyOtpRequest = VerifyOtpDto;
+type CreatePostRequest = CreatePostDto;
+type CreateReplyRequest = CreateReplyDto;
+type RespondToPostRequest = CreateResponseDto;
+type UpdateResponseRequest = UpdateResponseDto;
+type UpdateProfileRequest = UpdateUserDto;
+type CreateConversationRequest = CreateConversationDto;
+type SendMessageRequest = CreateMessageDto;
+type ClaimSpotRequest = ClaimSpotDto;
+type UpvoteResponse = UpvoteResponseDto;
+type AuthResponse = VerifyOtpWrappedResponseDto;
+type Post = SpotPost;
+type Template = PostTemplate;
+/**
+ * Spot summary with activity indicators
+ * Returned by /users/me/spots-summary
+ */
+interface SpotSummary {
+    spotId: string;
+    spotName: string;
+    spotSlug: string;
+    spotType: string;
+    postCount: number;
+    unreadMessages: number;
+    pendingResponses: number;
+    lastActivity: string | null;
+    hasNewActivity: boolean;
+}
+/**
+ * Response meta for spots summary
+ */
+interface SpotsSummaryMeta {
+    totalSpots: number;
+    totalUnreadMessages: number;
+    totalPendingResponses: number;
+}
+/**
+ * Full response from /users/me/spots-summary
+ */
+interface SpotsSummaryResponse {
+    data: SpotSummary[];
+    meta: SpotsSummaryMeta;
+}
+
+/**
+ * Auth Mutation Hooks
+ *
+ * TanStack Query hooks for authentication operations.
+ */
+
+/**
+ * Send OTP to phone number
+ *
+ * @endpoint POST /auth/send-otp
+ */
+declare function useSendOtp(options?: Omit<UseMutationOptions<ApiResponse<{
+    sent: boolean;
+}>, Error, SendOtpRequest>, 'mutationFn'>): UseMutationResult<ApiResponse<{
+    sent: boolean;
+}>, Error, SendOtpRequest>;
+/**
+ * Verify OTP and authenticate
+ *
+ * @endpoint POST /auth/verify-otp
+ */
+declare function useVerifyOtp(options?: Omit<UseMutationOptions<AuthResponse, Error, VerifyOtpRequest>, 'mutationFn'>): UseMutationResult<AuthResponse, Error, VerifyOtpRequest>;
+/**
+ * Refresh access token
+ *
+ * @endpoint POST /auth/refresh
+ */
+declare function useRefreshToken(options?: Omit<UseMutationOptions<{
+    accessToken: string;
+}, Error, {
+    refreshToken: string;
+}>, 'mutationFn'>): UseMutationResult<{
+    accessToken: string;
+}, Error, {
+    refreshToken: string;
+}>;
+
+/**
+ * Users Query Hooks
+ *
+ * TanStack Query hooks for user-related operations.
+ */
+
+declare const userKeys: {
+    all: readonly ["users"];
+    me: () => readonly ["users", "me"];
+    stats: () => readonly ["users", "me", "stats"];
+    spotsSummary: () => readonly ["users", "me", "spots-summary"];
+    activity: (limit?: number) => readonly ["users", "me", "activity", number | undefined];
+    posts: (params?: {
+        page?: number;
+        limit?: number;
+    }) => readonly ["users", "me", "posts", {
+        page?: number;
+        limit?: number;
+    } | undefined];
+    clubs: () => readonly ["users", "me", "clubs"];
+    subscriptions: () => readonly ["users", "me", "subscriptions"];
+    blocked: () => readonly ["users", "me", "blocked"];
+    ownedSpots: () => readonly ["users", "me", "owned-spots"];
+    favorites: () => readonly ["users", "me", "favorites"];
+};
+/**
+ * Get current user's profile
+ *
+ * @endpoint GET /users/me
+ */
+declare function useCurrentUser(options?: Omit<UseQueryOptions<User>, 'queryKey' | 'queryFn'>): UseQueryResult<User>;
+/**
+ * Get current user's stats
+ *
+ * @endpoint GET /users/me/stats
+ * @deprecated This endpoint doesn't exist in the API. Use useUserSpotsSummary instead.
+ */
+declare function useUserStats(options?: Omit<UseQueryOptions<{
+    posts: number;
+    responses: number;
+    upvotes: number;
+}>, 'queryKey' | 'queryFn'>): UseQueryResult<{
+    posts: number;
+    responses: number;
+    upvotes: number;
+}>;
+/**
+ * Get current user's spots summary with activity indicators
+ *
+ * Returns list of spots where user has posted, with:
+ * - Post count per spot
+ * - Unread messages count
+ * - Pending responses count
+ * - Last activity timestamp
+ *
+ * @endpoint GET /users/me/spots-summary
+ */
+declare function useUserSpotsSummary(options?: Omit<UseQueryOptions<SpotsSummaryResponse>, 'queryKey' | 'queryFn'>): UseQueryResult<SpotsSummaryResponse>;
+/**
+ * Get current user's activity
+ *
+ * @endpoint GET /users/me/activity
+ */
+declare function useUserActivity(limit?: number, options?: Omit<UseQueryOptions<unknown[]>, 'queryKey' | 'queryFn'>): UseQueryResult<unknown[]>;
+/**
+ * Get current user's posts
+ *
+ * @endpoint GET /user/me/posts
+ */
+declare function useUserPosts(params?: {
+    page?: number;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<Post[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Post[]>;
+/**
+ * Get current user's clubs
+ *
+ * @endpoint GET /user/me/clubs
+ */
+declare function useUserClubs(options?: Omit<UseQueryOptions<Club[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Club[]>;
+/**
+ * Get current user's spot subscriptions
+ *
+ * @endpoint GET /user/me/subscriptions
+ */
+declare function useUserSubscriptions(options?: Omit<UseQueryOptions<SpotSubscription[]>, 'queryKey' | 'queryFn'>): UseQueryResult<SpotSubscription[]>;
+/**
+ * Get blocked users list
+ *
+ * @endpoint GET /user/me/blocked
+ */
+declare function useBlockedUsers(options?: Omit<UseQueryOptions<User[]>, 'queryKey' | 'queryFn'>): UseQueryResult<User[]>;
+/**
+ * Get current user's owned spots (for business owners)
+ *
+ * @endpoint GET /users/me/owned-spots
+ */
+declare function useOwnedSpots(options?: Omit<UseQueryOptions<Spot[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Spot[]>;
+/**
+ * Get current user's favorite spots
+ *
+ * @endpoint GET /users/me/favorites
+ */
+declare function useUserFavorites(options?: Omit<UseQueryOptions<FavoriteSpot[]>, 'queryKey' | 'queryFn'>): UseQueryResult<FavoriteSpot[]>;
+
+/**
+ * Spots Query Hooks
+ *
+ * TanStack Query hooks for spot-related operations.
+ */
+
+declare const spotKeys: {
+    all: readonly ["spots"];
+    lists: () => readonly ["spots", "list"];
+    list: (filters?: Record<string, unknown>) => readonly ["spots", "list", Record<string, unknown> | undefined];
+    details: () => readonly ["spots", "detail"];
+    detail: (id: string) => readonly ["spots", "detail", string];
+    bySlug: (slug: string) => readonly ["spots", "slug", string];
+    byQR: (qrCode: string) => readonly ["spots", "qr", string];
+    images: (spotId: string) => readonly ["spots", "detail", string, "images"];
+};
+/**
+ * Get all spots
+ *
+ * @endpoint GET /spots
+ */
+declare function useSpots(params?: {
+    limit?: number;
+    city?: string;
+    type?: string;
+    lat?: number;
+    lng?: number;
+    radius?: number;
+    search?: string;
+    vibes?: string;
+    cityId?: string;
+    page?: number;
+}, options?: Omit<UseQueryOptions<Spot[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Spot[]>;
+/**
+ * Get a spot by ID
+ *
+ * @endpoint GET /spots/{spotId}
+ */
+declare function useSpot(spotId: string, options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>): UseQueryResult<Spot>;
+/**
+ * Get a spot by slug
+ *
+ * @endpoint GET /spots/slug/{slug}
+ */
+declare function useSpotBySlug(slug: string, options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>): UseQueryResult<Spot>;
+/**
+ * Get a spot by QR code
+ *
+ * @endpoint GET /spots/qr/{qrCode}
+ */
+declare function useSpotByQR(qrCode: string, options?: Omit<UseQueryOptions<Spot>, 'queryKey' | 'queryFn'>): UseQueryResult<Spot>;
+/**
+ * Get images for a spot
+ *
+ * @endpoint GET /spots/{spotId}/images
+ */
+declare function useSpotImages(spotId: string, options?: Omit<UseQueryOptions<SpotImage[]>, 'queryKey' | 'queryFn'>): UseQueryResult<SpotImage[]>;
+/**
+ * Check if a spot is favorited by the current user
+ *
+ * @endpoint GET /spots/{spotId}/favorite
+ */
+declare function useSpotFavoriteStatus(spotId: string, options?: Omit<UseQueryOptions<{
+    isFavorite: boolean;
+}>, 'queryKey' | 'queryFn'>): UseQueryResult<{
+    isFavorite: boolean;
+}>;
+/**
+ * Params for infinite spots query
+ */
+interface InfiniteSpotsParams {
+    limit?: number;
+    city?: string;
+    cityId?: string;
+    type?: string;
+    templateSlugs?: string[];
+    vibeIds?: string[];
+    search?: string;
+}
+/**
+ * Infinite scroll query for spots
+ *
+ * @endpoint GET /spots (paginated)
+ * @returns Infinite query with pages of spots
+ */
+declare function useInfiniteSpots(params?: InfiniteSpotsParams, options?: Omit<UseInfiniteQueryOptions<PaginatedResponse<Spot>, Error, {
+    pages: PaginatedResponse<Spot>[];
+    pageParams: number[];
+}>, 'queryKey' | 'queryFn' | 'getNextPageParam' | 'initialPageParam'>): UseInfiniteQueryResult<{
+    pages: PaginatedResponse<Spot>[];
+    pageParams: number[];
+}, Error>;
+
+/**
+ * Posts Query Hooks
+ *
+ * TanStack Query hooks for post/board operations.
+ */
+
+declare const postKeys: {
+    all: readonly ["posts"];
+    lists: () => readonly ["posts", "list"];
+    list: (filters?: Record<string, unknown>) => readonly ["posts", "list", Record<string, unknown> | undefined];
+    bySpot: (spotId: string, filters?: Record<string, unknown>) => readonly ["posts", "spot", string, Record<string, unknown> | undefined];
+    details: () => readonly ["posts", "detail"];
+    detail: (id: string) => readonly ["posts", "detail", string];
+    responses: (postId: string) => readonly ["posts", "detail", string, "responses"];
+    status: (postId: string) => readonly ["posts", "detail", string, "status"];
+    upvotes: (postId: string, filters?: {
+        limit?: number;
+        offset?: number;
+    }) => readonly ["posts", "detail", string, "upvotes", {
+        limit?: number;
+        offset?: number;
+    } | undefined];
+};
+/**
+ * Get posts for a spot
+ *
+ * @endpoint GET /spots/{spotId}/posts
+ */
+declare function useSpotPosts(spotId: string, params?: {
+    postType?: string;
+    status?: string;
+    page?: number;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<Post[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Post[]>;
+/**
+ * Get a single post by ID
+ *
+ * @endpoint GET /posts/{postId}
+ */
+declare function usePost(postId: string, options?: Omit<UseQueryOptions<Post>, 'queryKey' | 'queryFn'>): UseQueryResult<Post>;
+/**
+ * Get responses for a post
+ *
+ * @endpoint GET /posts/{postId}/responses
+ */
+declare function usePostResponses(postId: string, options?: Omit<UseQueryOptions<PostResponse[]>, 'queryKey' | 'queryFn'>): UseQueryResult<PostResponse[]>;
+/**
+ * Get all posts (with filters)
+ *
+ * @endpoint GET /posts
+ */
+declare function usePosts(params?: {
+    postType?: string;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<Post[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Post[]>;
+/**
+ * Get user's status for a post (read/hidden/pinned)
+ *
+ * @endpoint GET /posts/{postId}/status
+ */
+declare function usePostStatus(postId: string, options?: Omit<UseQueryOptions<PostStatusDto>, 'queryKey' | 'queryFn'>): UseQueryResult<PostStatusDto>;
+/**
+ * Get upvotes for a post (list of users who upvoted)
+ *
+ * @endpoint GET /posts/{postId}/upvotes
+ */
+declare function usePostUpvotes(postId: string, params?: {
+    limit?: number;
+    offset?: number;
+}, options?: Omit<UseQueryOptions<PostUpvotesResponse>, 'queryKey' | 'queryFn'>): UseQueryResult<PostUpvotesResponse>;
+/**
+ * Get nearby posts feed
+ *
+ * @endpoint GET /posts/feed
+ */
+declare function usePostsFeed(params: {
+    lat: number;
+    lng: number;
+    radius?: number;
+    postType?: string;
+    cursor?: string;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<{
+    posts: Post[];
+    hasMore: boolean;
+    nextCursor?: string;
+}>, 'queryKey' | 'queryFn'>): UseQueryResult<{
+    posts: Post[];
+    hasMore: boolean;
+    nextCursor?: string;
+}>;
+
+/**
+ * Conversations Query Hooks
+ *
+ * TanStack Query hooks for conversation/messaging operations.
+ */
+
+declare const conversationKeys: {
+    all: readonly ["conversations"];
+    lists: () => readonly ["conversations", "list"];
+    list: () => readonly ["conversations", "list"];
+    details: () => readonly ["conversations", "detail"];
+    detail: (id: string) => readonly ["conversations", "detail", string];
+    messages: (conversationId: string, params?: {
+        before?: string;
+    }) => readonly ["conversations", "detail", string, "messages", {
+        before?: string;
+    } | undefined];
+};
+/**
+ * Get all conversations for current user
+ *
+ * @endpoint GET /conversations
+ */
+declare function useConversations(options?: Omit<UseQueryOptions<Conversation[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Conversation[]>;
+/**
+ * Get a single conversation with details
+ *
+ * @endpoint GET /conversations/{id}
+ */
+declare function useConversation(conversationId: string, options?: Omit<UseQueryOptions<Conversation>, 'queryKey' | 'queryFn'>): UseQueryResult<Conversation>;
+/**
+ * Get messages for a conversation
+ *
+ * @endpoint GET /conversations/{id}/messages
+ */
+declare function useConversationMessages(conversationId: string, params?: {
+    limit?: number;
+    before?: string;
+}, options?: Omit<UseQueryOptions<{
+    data: Message[];
+    meta: {
+        hasMore: boolean;
+        oldestMessageAt: string | null;
+    };
+}>, 'queryKey' | 'queryFn'>): UseQueryResult<{
+    data: Message[];
+    meta: {
+        hasMore: boolean;
+        oldestMessageAt: string | null;
+    };
+}>;
+
+/**
+ * Clubs Query Hooks
+ *
+ * TanStack Query hooks for club operations.
+ */
+
+declare const clubKeys: {
+    all: readonly ["clubs"];
+    bySpot: (spotId: string) => readonly ["clubs", "spot", string];
+    details: () => readonly ["clubs", "detail"];
+    detail: (id: string) => readonly ["clubs", "detail", string];
+    bySlug: (slug: string) => readonly ["clubs", "slug", string];
+    byUser: (userId: string) => readonly ["clubs", "user", string];
+    membership: (clubId: string, userId: string) => readonly ["clubs", "detail", string, "membership", string];
+};
+/**
+ * Get clubs for a spot
+ *
+ * @endpoint GET /clubs/spot/{spotId}
+ */
+declare function useClubsBySpot(spotId: string, options?: Omit<UseQueryOptions<Club[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Club[]>;
+/**
+ * Get a club by ID
+ *
+ * @endpoint GET /clubs/{id}
+ */
+declare function useClub(clubId: string, options?: Omit<UseQueryOptions<Club>, 'queryKey' | 'queryFn'>): UseQueryResult<Club>;
+/**
+ * Get a club by slug
+ *
+ * @endpoint GET /clubs/slug/{slug}
+ */
+declare function useClubBySlug(slug: string, options?: Omit<UseQueryOptions<Club>, 'queryKey' | 'queryFn'>): UseQueryResult<Club>;
+/**
+ * Get clubs for a user
+ *
+ * @endpoint GET /clubs/user/{userId}
+ */
+declare function useClubsByUser(userId: string, options?: Omit<UseQueryOptions<Club[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Club[]>;
+/**
+ * Get membership status for a user in a club
+ *
+ * @endpoint GET /clubs/{id}/membership/{userId}
+ */
+declare function useClubMembership(clubId: string, userId: string, options?: Omit<UseQueryOptions<{
+    isMember: boolean;
+    role?: string;
+}>, 'queryKey' | 'queryFn'>): UseQueryResult<{
+    isMember: boolean;
+    role?: string;
+}>;
+
+/**
+ * Templates Query Hooks
+ *
+ * TanStack Query hooks for post template operations.
+ */
+
+declare const templateKeys: {
+    all: readonly ["templates"];
+    lists: () => readonly ["templates", "list"];
+    list: (filters?: {
+        spotType?: string;
+    }) => readonly ["templates", "list", {
+        spotType?: string;
+    } | undefined];
+    details: () => readonly ["templates", "detail"];
+    detail: (id: string) => readonly ["templates", "detail", string];
+    bySlug: (slug: string) => readonly ["templates", "slug", string];
+};
+/**
+ * Get all templates
+ *
+ * @endpoint GET /templates
+ */
+declare function useTemplates(params?: {
+    spotType?: string;
+}, options?: Omit<UseQueryOptions<Template[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Template[]>;
+/**
+ * Get a template by ID
+ *
+ * @endpoint GET /templates/{templateId}
+ */
+declare function useTemplate(templateId: string, options?: Omit<UseQueryOptions<Template>, 'queryKey' | 'queryFn'>): UseQueryResult<Template>;
+/**
+ * Get a template by slug
+ *
+ * @endpoint GET /templates/slug/{slug}
+ */
+declare function useTemplateBySlug(slug: string, options?: Omit<UseQueryOptions<Template>, 'queryKey' | 'queryFn'>): UseQueryResult<Template>;
+
+/**
+ * Notifications Query Hooks
+ *
+ * TanStack Query hooks for notification operations.
+ */
+
+declare const notificationKeys: {
+    all: readonly ["notifications"];
+    lists: () => readonly ["notifications", "list"];
+    list: (params?: {
+        limit?: number;
+        unreadOnly?: boolean;
+    }) => readonly ["notifications", "list", {
+        limit?: number;
+        unreadOnly?: boolean;
+    } | undefined];
+    unreadCount: () => readonly ["notifications", "unreadCount"];
+};
+/**
+ * Get notifications for current user
+ *
+ * @endpoint GET /notifications
+ */
+declare function useNotifications(params?: {
+    limit?: number;
+    unreadOnly?: boolean;
+}, options?: Omit<UseQueryOptions<Notification[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Notification[]>;
+/**
+ * Get unread notification count
+ *
+ * @endpoint GET /notifications/unread-count
+ */
+declare function useUnreadNotificationCount(options?: Omit<UseQueryOptions<number>, 'queryKey' | 'queryFn'>): UseQueryResult<number>;
+
+/**
+ * Misc Query Hooks
+ *
+ * TanStack Query hooks for cities, vibes, and other reference data.
+ */
+
+declare const miscKeys: {
+    cities: () => readonly ["cities"];
+    vibes: () => readonly ["vibes"];
+    lifeSituations: () => readonly ["life-situations"];
+};
+/**
+ * Get all cities
+ *
+ * @endpoint GET /cities
+ */
+declare function useCities(options?: Omit<UseQueryOptions<City[]>, 'queryKey' | 'queryFn'>): UseQueryResult<City[]>;
+/**
+ * Get all vibes
+ *
+ * @endpoint GET /vibes
+ */
+declare function useVibes(options?: Omit<UseQueryOptions<Vibe[]>, 'queryKey' | 'queryFn'>): UseQueryResult<Vibe[]>;
+/**
+ * Get all life situations (for onboarding)
+ *
+ * @endpoint GET /life-situations
+ */
+declare function useLifeSituations(options?: Omit<UseQueryOptions<LifeSituation[]>, 'queryKey' | 'queryFn'>): UseQueryResult<LifeSituation[]>;
+
+/**
+ * Products Query Hooks
+ *
+ * TanStack Query hooks for product-related operations.
+ */
+
+declare const productKeys: {
+    all: readonly ["products"];
+    lists: () => readonly ["products", "list"];
+    list: (filters?: Record<string, unknown>) => readonly ["products", "list", Record<string, unknown> | undefined];
+    details: () => readonly ["products", "detail"];
+    detail: (id: string) => readonly ["products", "detail", string];
+    bySlug: (spotId: string, slug: string) => readonly ["products", "slug", string, string];
+    bySpot: (spotId: string) => readonly ["products", "spot", string];
+};
+interface ProductFilters {
+    spotId?: string;
+    type?: ProductType;
+    status?: ProductStatus;
+    limit?: number;
+    page?: number;
+}
+interface ProductWithSpot extends Product {
+    spot: Pick<Spot, 'id' | 'name' | 'slug'>;
+}
+/**
+ * Get products for a spot (public browse)
+ *
+ * @endpoint GET /spots/{spotId}/products
+ */
+declare function useSpotProducts(spotId: string, params?: {
+    type?: ProductType;
+    limit?: number;
+    page?: number;
+}, options?: Omit<UseQueryOptions<PaginatedResponse<Product>>, 'queryKey' | 'queryFn'>): UseQueryResult<PaginatedResponse<Product>>;
+/**
+ * Get a product by ID
+ *
+ * @endpoint GET /products/{productId}
+ */
+declare function useProduct(productId: string, options?: Omit<UseQueryOptions<ProductWithSpot>, 'queryKey' | 'queryFn'>): UseQueryResult<ProductWithSpot>;
+/**
+ * Get a product by slug (within a spot)
+ *
+ * @endpoint GET /spots/{spotId}/products/slug/{slug}
+ */
+declare function useProductBySlug(spotId: string, slug: string, options?: Omit<UseQueryOptions<ProductWithSpot>, 'queryKey' | 'queryFn'>): UseQueryResult<ProductWithSpot>;
+
+/**
+ * Orders Query Hooks
+ *
+ * TanStack Query hooks for order-related operations.
+ */
+
+declare const orderKeys: {
+    all: readonly ["orders"];
+    lists: () => readonly ["orders", "list"];
+    list: (filters?: Record<string, unknown>) => readonly ["orders", "list", Record<string, unknown> | undefined];
+    details: () => readonly ["orders", "detail"];
+    detail: (id: string) => readonly ["orders", "detail", string];
+    myOrders: () => readonly ["orders", "my"];
+    spotOrders: (spotId: string) => readonly ["orders", "spot", string];
+};
+interface OrderWithDetails extends Order {
+    items: (OrderItem & {
+        product: Pick<Product, 'id' | 'name' | 'slug' | 'type' | 'imageUrl'>;
+    })[];
+    spot: Pick<Spot, 'id' | 'name' | 'slug'>;
+}
+interface OrderFilters {
+    status?: OrderStatus;
+    limit?: number;
+    page?: number;
+}
+/**
+ * Get current user's orders (purchases)
+ *
+ * @endpoint GET /users/me/orders
+ */
+declare function useMyOrders(params?: OrderFilters, options?: Omit<UseQueryOptions<PaginatedResponse<OrderWithDetails>>, 'queryKey' | 'queryFn'>): UseQueryResult<PaginatedResponse<OrderWithDetails>>;
+/**
+ * Get a single order by ID
+ *
+ * @endpoint GET /orders/{orderId}
+ */
+declare function useOrder(orderId: string, options?: Omit<UseQueryOptions<OrderWithDetails>, 'queryKey' | 'queryFn'>): UseQueryResult<OrderWithDetails>;
+/**
+ * Get orders for a spot (seller view)
+ *
+ * @endpoint GET /seller/spots/{spotId}/orders
+ */
+declare function useSpotOrders(spotId: string, params?: OrderFilters, options?: Omit<UseQueryOptions<PaginatedResponse<OrderWithDetails>>, 'queryKey' | 'queryFn'>): UseQueryResult<PaginatedResponse<OrderWithDetails>>;
+
+/**
+ * Wallet Query Hooks
+ *
+ * TanStack Query hooks for wallet and redemption operations.
+ */
+
+type RedemptionStatus = 'PENDING' | 'REDEEMED' | 'EXPIRED' | 'CANCELLED' | 'VOID';
+interface WalletProduct {
+    id: string;
+    name: string;
+    type: string;
+    imageUrl: string | null;
+}
+interface WalletOrderItem {
+    product: WalletProduct;
+    quantity: number;
+    unitPrice: number;
+}
+interface WalletOrder {
+    id: string;
+    orderNumber: string;
+    spotId: string;
+    createdAt: string;
+    spot: {
+        id: string;
+        name: string;
+        slug: string;
+        address: string | null;
+    };
+}
+interface WalletRedemption {
+    id: string;
+    qrCode: string;
+    qrCodeUrl: string | null;
+    status: RedemptionStatus;
+    validFrom: string;
+    validUntil: string;
+    redeemedAt: string | null;
+    createdAt: string;
+    orderItem: WalletOrderItem & {
+        order: WalletOrder;
+    };
+}
+interface RedemptionLookup extends WalletRedemption {
+    redeemedBy: {
+        id: string;
+        name: string;
+    } | null;
+    spot: {
+        id: string;
+        name: string;
+    } | null;
+    orderItem: WalletOrderItem & {
+        order: WalletOrder & {
+            user: {
+                id: string;
+                name: string | null;
+                avatarUrl: string | null;
+            };
+        };
+    };
+}
+interface WalletHistoryResponse {
+    data: WalletRedemption[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    };
+}
+declare const walletKeys: {
+    all: readonly ["wallet"];
+    active: () => readonly ["wallet", "active"];
+    history: (page?: number) => readonly ["wallet", "history", number | undefined];
+    redemptions: () => readonly ["redemptions"];
+    lookup: (qrCode: string) => readonly ["redemptions", "lookup", string];
+    spotRedemptions: (spotId: string, page?: number) => readonly ["redemptions", "spot", string, number | undefined];
+};
+/**
+ * Get user's active wallet items (pending redemptions)
+ *
+ * @endpoint GET /wallet
+ */
+declare function useWallet(options?: Omit<UseQueryOptions<WalletRedemption[]>, 'queryKey' | 'queryFn'>): UseQueryResult<WalletRedemption[]>;
+/**
+ * Get user's wallet history (all redemptions)
+ *
+ * @endpoint GET /wallet/history
+ */
+declare function useWalletHistory(params?: {
+    page?: number;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<WalletHistoryResponse>, 'queryKey' | 'queryFn'>): UseQueryResult<WalletHistoryResponse>;
+/**
+ * Lookup redemption by QR code (for scanner)
+ *
+ * @endpoint GET /redemptions/lookup/:qrCode
+ */
+declare function useRedemptionLookup(qrCode: string, options?: Omit<UseQueryOptions<RedemptionLookup>, 'queryKey' | 'queryFn'>): UseQueryResult<RedemptionLookup>;
+/**
+ * Get spot's redemption history (for spot owner)
+ *
+ * @endpoint GET /spots/:spotId/redemptions
+ */
+declare function useSpotRedemptions(spotId: string, params?: {
+    page?: number;
+    limit?: number;
+}, options?: Omit<UseQueryOptions<WalletHistoryResponse>, 'queryKey' | 'queryFn'>): UseQueryResult<WalletHistoryResponse>;
+
+/**
+ * Users Mutation Hooks
+ *
+ * TanStack Query hooks for user mutation operations.
+ */
+
+/**
+ * Update current user's profile
+ *
+ * @endpoint PUT /users/me
+ */
+declare function useUpdateProfile(options?: Omit<UseMutationOptions<User, Error, UpdateProfileRequest>, 'mutationFn'>): UseMutationResult<User, Error, UpdateProfileRequest>;
+/**
+ * Upload avatar
+ *
+ * Uploads avatar file and updates user profile in one request.
+ *
+ * @endpoint POST /users/me/avatar
+ */
+declare function useUploadAvatar(options?: Omit<UseMutationOptions<{
+    avatarUrl: string;
+}, Error, FormData>, 'mutationFn'>): UseMutationResult<{
+    avatarUrl: string;
+}, Error, FormData>;
+/**
+ * Delete current user's account
+ *
+ * @endpoint DELETE /users/me
+ */
+declare function useDeleteAccount(options?: Omit<UseMutationOptions<void, Error, void>, 'mutationFn'>): UseMutationResult<void, Error, void>;
+/**
+ * Update user vibes
+ *
+ * @endpoint PUT /users/me/vibes
+ */
+declare function useUpdateVibes(options?: Omit<UseMutationOptions<User, Error, {
+    vibes: string[];
+}>, 'mutationFn'>): UseMutationResult<User, Error, {
+    vibes: string[];
+}>;
+/**
+ * Update user interests
+ *
+ * @endpoint PUT /user/me/interests
+ */
+declare function useUpdateInterests(options?: Omit<UseMutationOptions<User, Error, {
+    interests: string[];
+}>, 'mutationFn'>): UseMutationResult<User, Error, {
+    interests: string[];
+}>;
+/**
+ * Complete onboarding step
+ *
+ * @endpoint POST /user/me/onboarding-step
+ */
+declare function useCompleteOnboardingStep(options?: Omit<UseMutationOptions<User, Error, {
+    step: number;
+}>, 'mutationFn'>): UseMutationResult<User, Error, {
+    step: number;
+}>;
+/**
+ * Block a user
+ *
+ * @endpoint POST /users/{id}/block
+ */
+declare function useBlockUser(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+/**
+ * Unblock a user
+ *
+ * @endpoint DELETE /users/{id}/block
+ */
+declare function useUnblockUser(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+
+/**
+ * Posts Mutation Hooks
+ *
+ * TanStack Query hooks for post/board mutation operations.
+ */
+
+/**
+ * Create a new post
+ *
+ * @endpoint POST /spots/{spotId}/posts
+ */
+declare function useCreatePost(options?: Omit<UseMutationOptions<Post, Error, {
+    spotId: string;
+} & CreatePostRequest>, 'mutationFn'>): UseMutationResult<Post, Error, {
+    spotId: string;
+} & CreatePostRequest>;
+/**
+ * Update a post
+ *
+ * @endpoint PUT /posts/{postId}
+ */
+declare function useUpdatePost(options?: Omit<UseMutationOptions<Post, Error, {
+    postId: string;
+    title?: string;
+    content?: string;
+}>, 'mutationFn'>): UseMutationResult<Post, Error, {
+    postId: string;
+    title?: string;
+    content?: string;
+}>;
+/**
+ * Delete a post
+ *
+ * @endpoint DELETE /posts/{postId}
+ */
+declare function useDeletePost(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+/**
+ * Fulfill a post (mark as fulfilled)
+ *
+ * @endpoint PUT /posts/{postId}/fulfill
+ */
+declare function useFulfillPost(options?: Omit<UseMutationOptions<Post, Error, string>, 'mutationFn'>): UseMutationResult<Post, Error, string>;
+/**
+ * Upvote/unupvote a post
+ *
+ * @endpoint POST /posts/{postId}/upvote
+ */
+declare function useUpvotePost(options?: Omit<UseMutationOptions<UpvoteResponse, Error, string>, 'mutationFn'>): UseMutationResult<UpvoteResponse, Error, string>;
+/**
+ * Create a reply to a post
+ *
+ * @endpoint POST /posts/{postId}/reply
+ */
+declare function useCreateReply(options?: Omit<UseMutationOptions<unknown, Error, {
+    postId: string;
+} & CreateReplyRequest>, 'mutationFn'>): UseMutationResult<unknown, Error, {
+    postId: string;
+} & CreateReplyRequest>;
+/**
+ * Delete a reply
+ *
+ * @endpoint DELETE /replies/{replyId}
+ */
+declare function useDeleteReply(options?: Omit<UseMutationOptions<void, Error, {
+    replyId: string;
+    postId: string;
+}>, 'mutationFn'>): UseMutationResult<void, Error, {
+    replyId: string;
+    postId: string;
+}>;
+/**
+ * Respond to a post (express interest)
+ *
+ * @endpoint POST /posts/{postId}/respond
+ */
+declare function useRespondToPost(options?: Omit<UseMutationOptions<PostResponse, Error, {
+    postId: string;
+} & RespondToPostRequest>, 'mutationFn'>): UseMutationResult<PostResponse, Error, {
+    postId: string;
+} & RespondToPostRequest>;
+/**
+ * Accept or decline a response
+ *
+ * @endpoint PUT /responses/{responseId}
+ */
+declare function useUpdateResponse(options?: Omit<UseMutationOptions<PostResponse, Error, {
+    responseId: string;
+    postId: string;
+} & UpdateResponseRequest>, 'mutationFn'>): UseMutationResult<PostResponse, Error, {
+    responseId: string;
+    postId: string;
+} & UpdateResponseRequest>;
+/**
+ * Report a post
+ *
+ * @endpoint POST /posts/{postId}/report
+ */
+declare function useReportPost(options?: Omit<UseMutationOptions<void, Error, {
+    postId: string;
+    reason: string;
+    details?: string;
+}>, 'mutationFn'>): UseMutationResult<void, Error, {
+    postId: string;
+    reason: string;
+    details?: string;
+}>;
+interface PostStatusUpdate {
+    isRead?: boolean;
+    isHidden?: boolean;
+    isPinned?: boolean;
+}
+/**
+ * Update user's status for a post (read/hidden/pinned)
+ *
+ * @endpoint PUT /posts/{postId}/status
+ */
+declare function useUpdatePostStatus(options?: Omit<UseMutationOptions<PostStatusDto, Error, {
+    postId: string;
+} & PostStatusUpdate>, 'mutationFn'>): UseMutationResult<PostStatusDto, Error, {
+    postId: string;
+} & PostStatusUpdate>;
+
+/**
+ * Spots Mutation Hooks
+ *
+ * TanStack Query hooks for spot mutation operations.
+ */
+
+/**
+ * Create a new spot
+ *
+ * @endpoint POST /spots
+ */
+declare function useCreateSpot(options?: Omit<UseMutationOptions<Spot, Error, Partial<Spot>>, 'mutationFn'>): UseMutationResult<Spot, Error, Partial<Spot>>;
+/**
+ * Update a spot
+ *
+ * @endpoint PUT /spots/{spotId}
+ */
+declare function useUpdateSpot(options?: Omit<UseMutationOptions<Spot, Error, {
+    spotId: string;
+} & Partial<Spot>>, 'mutationFn'>): UseMutationResult<Spot, Error, {
+    spotId: string;
+} & Partial<Spot>>;
+/**
+ * Claim a spot (for business owners)
+ *
+ * @endpoint POST /spots/{spotId}/claim
+ */
+declare function useClaimSpot(options?: Omit<UseMutationOptions<{
+    claimId: string;
+}, Error, {
+    spotId: string;
+} & ClaimSpotRequest>, 'mutationFn'>): UseMutationResult<{
+    claimId: string;
+}, Error, {
+    spotId: string;
+} & ClaimSpotRequest>;
+/**
+ * Subscribe to a spot
+ *
+ * @endpoint POST /spots/{spotId}/subscribe
+ */
+declare function useSubscribeToSpot(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+/**
+ * Unsubscribe from a spot
+ *
+ * @endpoint DELETE /spots/{spotId}/subscribe
+ */
+declare function useUnsubscribeFromSpot(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+/**
+ * Toggle favorite status on a spot
+ *
+ * @endpoint POST /spots/{spotId}/favorite
+ */
+declare function useFavoriteSpot(options?: Omit<UseMutationOptions<{
+    isFavorite: boolean;
+}, Error, string>, 'mutationFn'>): UseMutationResult<{
+    isFavorite: boolean;
+}, Error, string>;
+/**
+ * Rate a spot
+ *
+ * @endpoint POST /spots/{spotId}/rate
+ */
+declare function useRateSpot(options?: Omit<UseMutationOptions<{
+    rating: number;
+}, Error, {
+    spotId: string;
+    rating: number;
+}>, 'mutationFn'>): UseMutationResult<{
+    rating: number;
+}, Error, {
+    spotId: string;
+    rating: number;
+}>;
+/**
+ * Report a spot
+ *
+ * @endpoint POST /spots/{spotId}/report
+ */
+declare function useReportSpot(options?: Omit<UseMutationOptions<{
+    success: boolean;
+}, Error, {
+    spotId: string;
+    reason: string;
+    details?: string;
+}>, 'mutationFn'>): UseMutationResult<{
+    success: boolean;
+}, Error, {
+    spotId: string;
+    reason: string;
+    details?: string;
+}>;
+
+/**
+ * Conversations Mutation Hooks
+ *
+ * TanStack Query hooks for conversation/messaging mutation operations.
+ */
+
+/**
+ * Create a new conversation
+ *
+ * @endpoint POST /conversations
+ */
+declare function useCreateConversation(options?: Omit<UseMutationOptions<Conversation, Error, CreateConversationRequest>, 'mutationFn'>): UseMutationResult<Conversation, Error, CreateConversationRequest>;
+/**
+ * Create or get direct conversation with a user
+ *
+ * @endpoint POST /conversations/direct
+ */
+declare function useCreateDirectConversation(options?: Omit<UseMutationOptions<Conversation, Error, {
+    userId: string;
+}>, 'mutationFn'>): UseMutationResult<Conversation, Error, {
+    userId: string;
+}>;
+/**
+ * Send a message in a conversation
+ *
+ * @endpoint POST /conversations/{id}/messages
+ */
+declare function useSendMessage(options?: Omit<UseMutationOptions<Message, Error, {
+    conversationId: string;
+} & SendMessageRequest>, 'mutationFn'>): UseMutationResult<Message, Error, {
+    conversationId: string;
+} & SendMessageRequest>;
+/**
+ * Mark conversation as read
+ *
+ * @endpoint PUT /conversations/{id}/read
+ */
+declare function useMarkConversationAsRead(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+/**
+ * Send typing indicator
+ *
+ * @endpoint POST /conversations/{id}/typing
+ */
+declare function useSendTypingIndicator(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+
+/**
+ * Clubs Mutation Hooks
+ *
+ * TanStack Query hooks for club mutation operations.
+ */
+
+/**
+ * Create a new club
+ *
+ * @endpoint POST /clubs
+ */
+declare function useCreateClub(options?: Omit<UseMutationOptions<Club, Error, {
+    spotId: string;
+    name: string;
+    description?: string;
+}>, 'mutationFn'>): UseMutationResult<Club, Error, {
+    spotId: string;
+    name: string;
+    description?: string;
+}>;
+/**
+ * Update a club
+ *
+ * @endpoint PUT /clubs/{id}
+ */
+declare function useUpdateClub(options?: Omit<UseMutationOptions<Club, Error, {
+    clubId: string;
+    name?: string;
+    description?: string;
+}>, 'mutationFn'>): UseMutationResult<Club, Error, {
+    clubId: string;
+    name?: string;
+    description?: string;
+}>;
+/**
+ * Join a club
+ *
+ * @endpoint POST /clubs/{id}/join
+ */
+declare function useJoinClub(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+/**
+ * Leave a club
+ *
+ * @endpoint POST /clubs/{id}/leave
+ */
+declare function useLeaveClub(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+
+/**
+ * Notifications Mutation Hooks
+ *
+ * TanStack Query hooks for notification mutation operations.
+ */
+
+/**
+ * Mark notifications as read
+ *
+ * @endpoint PUT /notifications/read
+ */
+declare function useMarkNotificationsRead(options?: Omit<UseMutationOptions<void, Error, {
+    notificationIds?: string[];
+}>, 'mutationFn'>): UseMutationResult<void, Error, {
+    notificationIds?: string[];
+}>;
+/**
+ * Register device token for push notifications
+ *
+ * @endpoint POST /device-tokens
+ */
+declare function useRegisterDeviceToken(options?: Omit<UseMutationOptions<void, Error, {
+    token: string;
+    platform: 'ios' | 'android' | 'web';
+}>, 'mutationFn'>): UseMutationResult<void, Error, {
+    token: string;
+    platform: 'ios' | 'android' | 'web';
+}>;
+/**
+ * Remove device token
+ *
+ * @endpoint DELETE /device-tokens
+ */
+declare function useRemoveDeviceToken(options?: Omit<UseMutationOptions<void, Error, {
+    token: string;
+}>, 'mutationFn'>): UseMutationResult<void, Error, {
+    token: string;
+}>;
+
+/**
+ * Products Mutation Hooks
+ *
+ * TanStack Query hooks for product mutation operations.
+ */
+
+interface CreateProductRequest {
+    spotId: string;
+    name: string;
+    description?: string;
+    type: ProductType;
+    price: number;
+    currency?: string;
+    stockQuantity?: number;
+    lowStockThreshold?: number;
+    validFrom?: string;
+    validUntil?: string;
+    deliveryRadiusKm?: number;
+    prepTimeMinutes?: number;
+    maxCapacity?: number;
+    eventDate?: string;
+    imageUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+interface UpdateProductRequest {
+    name?: string;
+    description?: string;
+    price?: number;
+    stockQuantity?: number;
+    lowStockThreshold?: number;
+    status?: ProductStatus;
+    validFrom?: string;
+    validUntil?: string;
+    deliveryRadiusKm?: number;
+    prepTimeMinutes?: number;
+    maxCapacity?: number;
+    eventDate?: string;
+    imageUrl?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Create a new product
+ *
+ * @endpoint POST /spots/{spotId}/products
+ */
+declare function useCreateProduct(options?: Omit<UseMutationOptions<Product, Error, CreateProductRequest>, 'mutationFn'>): UseMutationResult<Product, Error, CreateProductRequest>;
+/**
+ * Update a product
+ *
+ * @endpoint PUT /products/{productId}
+ */
+declare function useUpdateProduct(options?: Omit<UseMutationOptions<Product, Error, {
+    productId: string;
+    data: UpdateProductRequest;
+}>, 'mutationFn'>): UseMutationResult<Product, Error, {
+    productId: string;
+    data: UpdateProductRequest;
+}>;
+/**
+ * Delete a product
+ *
+ * @endpoint DELETE /products/{productId}
+ */
+declare function useDeleteProduct(options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>): UseMutationResult<void, Error, string>;
+/**
+ * Adjust product stock
+ *
+ * @endpoint POST /products/{productId}/stock
+ */
+declare function useAdjustStock(options?: Omit<UseMutationOptions<Product, Error, {
+    productId: string;
+    quantity: number;
+    reason: 'RESTOCK' | 'ADJUSTMENT';
+    notes?: string;
+}>, 'mutationFn'>): UseMutationResult<Product, Error, {
+    productId: string;
+    quantity: number;
+    reason: 'RESTOCK' | 'ADJUSTMENT';
+    notes?: string;
+}>;
+
+/**
+ * Orders Mutation Hooks
+ *
+ * TanStack Query hooks for order mutation operations.
+ */
+
+interface CartItem {
+    productId: string;
+    quantity: number;
+}
+interface CreateOrderRequest {
+    spotId: string;
+    items: CartItem[];
+    notes?: string;
+    deliveryAddress?: string;
+}
+interface CreateOrderResponse extends Order {
+    items: Array<{
+        id: string;
+        productId: string;
+        productName: string;
+        quantity: number;
+        unitPrice: number;
+        totalPrice: number;
+    }>;
+}
+interface PaymentIntentResponse {
+    clientSecret: string;
+    paymentIntentId: string;
+}
+interface CoinbaseChargeResponse {
+    chargeId: string;
+    chargeCode: string;
+    hostedUrl: string;
+}
+/**
+ * Create a new order
+ *
+ * @endpoint POST /orders
+ */
+declare function useCreateOrder(options?: Omit<UseMutationOptions<CreateOrderResponse, Error, CreateOrderRequest>, 'mutationFn'>): UseMutationResult<CreateOrderResponse, Error, CreateOrderRequest>;
+/**
+ * Create Stripe PaymentIntent for an order
+ *
+ * @endpoint POST /payments/stripe/intent/{orderId}
+ */
+declare function useCreateStripeIntent(options?: Omit<UseMutationOptions<PaymentIntentResponse, Error, string>, 'mutationFn'>): UseMutationResult<PaymentIntentResponse, Error, string>;
+/**
+ * Create Coinbase Commerce charge for an order
+ *
+ * @endpoint POST /payments/coinbase/charge/{orderId}
+ */
+declare function useCreateCoinbaseCharge(options?: Omit<UseMutationOptions<CoinbaseChargeResponse, Error, string>, 'mutationFn'>): UseMutationResult<CoinbaseChargeResponse, Error, string>;
+/**
+ * Update order status (seller action)
+ *
+ * @endpoint PUT /orders/{orderId}/status
+ */
+declare function useUpdateOrderStatus(options?: Omit<UseMutationOptions<OrderWithDetails, Error, {
+    orderId: string;
+    status: OrderStatus;
+}>, 'mutationFn'>): UseMutationResult<OrderWithDetails, Error, {
+    orderId: string;
+    status: OrderStatus;
+}>;
+/**
+ * Cancel an order (buyer action, only for pending orders)
+ *
+ * @endpoint POST /orders/{orderId}/cancel
+ */
+declare function useCancelOrder(options?: Omit<UseMutationOptions<OrderWithDetails, Error, string>, 'mutationFn'>): UseMutationResult<OrderWithDetails, Error, string>;
+
+/**
+ * Redemption Mutation Hooks
+ *
+ * TanStack Query mutations for redemption operations.
+ */
+
+interface RedeemRequest {
+    qrCode: string;
+    spotId?: string;
+    deviceInfo?: string;
+    latitude?: number;
+    longitude?: number;
+    notes?: string;
+}
+interface VoidRedemptionRequest {
+    reason: string;
+}
+/**
+ * Redeem a QR code (spot owner/staff action)
+ *
+ * @endpoint POST /redemptions/redeem
+ */
+declare function useRedeem(): UseMutationResult<WalletRedemption, Error, RedeemRequest>;
+/**
+ * Void a redemption (spot owner action)
+ *
+ * @endpoint PUT /redemptions/:id/void
+ */
+declare function useVoidRedemption(): UseMutationResult<WalletRedemption, Error, {
+    redemptionId: string;
+    reason: string;
+}>;
+
+export { type AuthResponse, type CartItem, type City, type ClaimSpotRequest, type Club, type ClubMember, type CoinbaseChargeResponse, type Conversation, type CreateConversationRequest, type CreateOrderRequest, type CreateOrderResponse, type CreatePostRequest, type CreateProductRequest, type CreateReplyRequest, type FavoriteSpot, type InfiniteSpotsParams, type Intention, type Interest, type LifeSituation, type Message, type Notification, type Order, type OrderFilters, type OrderItem, type OrderWithDetails, type PaginatedResponse, type PaginationMeta, type PaymentIntentResponse, type Post, type PostReply, type PostReport, type PostResponse, type PostTemplate, type PostUpvote, type PostUpvoter, type PostUpvotesResponse, type Product, type ProductFilters, type ProductWithSpot, type RedeemRequest, type RedemptionLookup, type RedemptionStatus, type ReportStatus, type RespondToPostRequest, type SDKConfig, type SendMessageRequest, type SendOtpRequest, type Spot, type SpotClaim, type SpotImage, type SpotIntention, type SpotPost, type SpotPostType, type SpotSubscription, type SpotSummary, type SpotVibe, type SpotsSummaryMeta, type SpotsSummaryResponse, type Template, type UpdateProductRequest, type UpdateProfileRequest, type UpdateResponseRequest, type UpvoteResponse, type User, type UserVibe, type VerifyOtpRequest, type Vibe, type VoidRedemptionRequest, type WalletHistoryResponse, type WalletOrder, type WalletOrderItem, type WalletProduct, type WalletRedemption, clubKeys, configureSDK, conversationKeys, getApiClient, getConfig, miscKeys, notificationKeys, orderKeys, postKeys, productKeys, spotKeys, templateKeys, useAdjustStock, useBlockUser, useBlockedUsers, useCancelOrder, useCities, useClaimSpot, useClub, useClubBySlug, useClubMembership, useClubsBySpot, useClubsByUser, useCompleteOnboardingStep, useConversation, useConversationMessages, useConversations, useCreateClub, useCreateCoinbaseCharge, useCreateConversation, useCreateDirectConversation, useCreateOrder, useCreatePost, useCreateProduct, useCreateReply, useCreateSpot, useCreateStripeIntent, useCurrentUser, useDeleteAccount, useDeletePost, useDeleteProduct, useDeleteReply, useFavoriteSpot, useFulfillPost, useInfiniteSpots, useJoinClub, useLeaveClub, useLifeSituations, useMarkConversationAsRead, useMarkNotificationsRead, useMyOrders, useNotifications, useOrder, useOwnedSpots, usePost, usePostResponses, usePostStatus, usePostUpvotes, usePosts, usePostsFeed, useProduct, useProductBySlug, useRateSpot, useRedeem, useRedemptionLookup, useRefreshToken, useRegisterDeviceToken, useRemoveDeviceToken, useReportPost, useReportSpot, useRespondToPost, useSendMessage, useSendOtp, useSendTypingIndicator, useSpot, useSpotByQR, useSpotBySlug, useSpotFavoriteStatus, useSpotImages, useSpotOrders, useSpotPosts, useSpotProducts, useSpotRedemptions, useSpots, useSubscribeToSpot, useTemplate, useTemplateBySlug, useTemplates, useUnblockUser, useUnreadNotificationCount, useUnsubscribeFromSpot, useUpdateClub, useUpdateInterests, useUpdateOrderStatus, useUpdatePost, useUpdatePostStatus, useUpdateProduct, useUpdateProfile, useUpdateResponse, useUpdateSpot, useUpdateVibes, useUploadAvatar, useUpvotePost, useUserActivity, useUserClubs, useUserFavorites, useUserPosts, useUserSpotsSummary, useUserStats, useUserSubscriptions, useVerifyOtp, useVibes, useVoidRedemption, useWallet, useWalletHistory, userKeys, walletKeys };