@spotsdev/sdk 1.0.0

package/dist/api/types.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Spots SDK Types
+ *
+ * Type sources:
+ * - Entity types (User, Spot, Post, etc.) → import from @prisma/client
+ * - DTO types (CreatePostDto, etc.) → import from @spotsdev/types
+ *
+ * This file provides type aliases for SDK convenience while maintaining
+ * single sources of truth:
+ * - Prisma schema for entities
+ * - OpenAPI spec for DTOs
+ */
+/**
+ * Standard API response wrapper from ResponseInterceptor
+ * All API responses are wrapped in this format
+ */
+export interface ApiResponse<T> {
+    success: boolean;
+    data: T;
+    timestamp: string;
+}
+/**
+ * Paginated response for list endpoints
+ * Used inside ApiResponse.data for paginated queries
+ */
+export interface PaginatedResponse<T> {
+    data: T[];
+    meta: {
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+        hasNextPage: boolean;
+        hasPreviousPage: boolean;
+    };
+}
+export * from '@spotsdev/types';
+export type { User, Spot, SpotPost, PostReply, PostResponse, PostUpvote, PostReport, Club, ClubMember, Conversation, Message, Notification, PostTemplate, Vibe, Interest, Intention, LifeSituation, FavoriteSpot, SpotImage, SpotVibe, SpotIntention, SpotClaim, SpotSubscription, City, Product, Order, OrderItem, Payment, InventoryLog, StripeConnectAccount, SpotType, SpotPostType, AccountStatus, ClaimStatus, ResponseStatus, ReportReason, ReportStatus, NotificationType, ProductType, ProductStatus, OrderStatus, PaymentProvider, PaymentStatus, FulfillmentType, InventoryChangeReason, } from '@prisma/client';
+import type { SendOtpDto, VerifyOtpDto, CreatePostDto, CreateReplyDto, CreateResponseDto, UpdateResponseDto, UpdateUserDto, UpvoteResponseDto, VerifyOtpWrappedResponseDto, CreateConversationDto, CreateMessageDto, ClaimSpotDto } from '@spotsdev/types';
+import type { SpotPost, PostTemplate } from '@prisma/client';
+export type SendOtpRequest = SendOtpDto;
+export type VerifyOtpRequest = VerifyOtpDto;
+export type CreatePostRequest = CreatePostDto;
+export type CreateReplyRequest = CreateReplyDto;
+export type RespondToPostRequest = CreateResponseDto;
+export type UpdateResponseRequest = UpdateResponseDto;
+export type UpdateProfileRequest = UpdateUserDto;
+export type CreateConversationRequest = CreateConversationDto;
+export type SendMessageRequest = CreateMessageDto;
+export type ClaimSpotRequest = ClaimSpotDto;
+export type UpvoteResponse = UpvoteResponseDto;
+export type AuthResponse = VerifyOtpWrappedResponseDto;
+export type Post = SpotPost;
+export type Template = PostTemplate;

package/dist/api/types.js

@@ -0,0 +1,34 @@
+"use strict";
+/**
+ * Spots SDK Types
+ *
+ * Type sources:
+ * - Entity types (User, Spot, Post, etc.) → import from @prisma/client
+ * - DTO types (CreatePostDto, etc.) → import from @spotsdev/types
+ *
+ * This file provides type aliases for SDK convenience while maintaining
+ * single sources of truth:
+ * - Prisma schema for entities
+ * - OpenAPI spec for DTOs
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// ============================================================================
+// RE-EXPORTS FROM SOURCES
+// ============================================================================
+// Re-export all DTO types from @spotsdev/types (OpenAPI generated)
+__exportStar(require("@spotsdev/types"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYXBpL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7Ozs7Ozs7R0FXRzs7Ozs7Ozs7Ozs7Ozs7OztBQWdDSCwrRUFBK0U7QUFDL0UsMEJBQTBCO0FBQzFCLCtFQUErRTtBQUUvRSxtRUFBbUU7QUFDbkUsa0RBQWdDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTcG90cyBTREsgVHlwZXNcbiAqXG4gKiBUeXBlIHNvdXJjZXM6XG4gKiAtIEVudGl0eSB0eXBlcyAoVXNlciwgU3BvdCwgUG9zdCwgZXRjLikg4oaSIGltcG9ydCBmcm9tIEBwcmlzbWEvY2xpZW50XG4gKiAtIERUTyB0eXBlcyAoQ3JlYXRlUG9zdER0bywgZXRjLikg4oaSIGltcG9ydCBmcm9tIEBzcG90c2Rldi90eXBlc1xuICpcbiAqIFRoaXMgZmlsZSBwcm92aWRlcyB0eXBlIGFsaWFzZXMgZm9yIFNESyBjb252ZW5pZW5jZSB3aGlsZSBtYWludGFpbmluZ1xuICogc2luZ2xlIHNvdXJjZXMgb2YgdHJ1dGg6XG4gKiAtIFByaXNtYSBzY2hlbWEgZm9yIGVudGl0aWVzXG4gKiAtIE9wZW5BUEkgc3BlYyBmb3IgRFRPc1xuICovXG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIEFQSSBSRVNQT05TRSBUWVBFU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG4vKipcbiAqIFN0YW5kYXJkIEFQSSByZXNwb25zZSB3cmFwcGVyIGZyb20gUmVzcG9uc2VJbnRlcmNlcHRvclxuICogQWxsIEFQSSByZXNwb25zZXMgYXJlIHdyYXBwZWQgaW4gdGhpcyBmb3JtYXRcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBBcGlSZXNwb25zZTxUPiB7XG4gIHN1Y2Nlc3M6IGJvb2xlYW47XG4gIGRhdGE6IFQ7XG4gIHRpbWVzdGFtcDogc3RyaW5nO1xufVxuXG4vKipcbiAqIFBhZ2luYXRlZCByZXNwb25zZSBmb3IgbGlzdCBlbmRwb2ludHNcbiAqIFVzZWQgaW5zaWRlIEFwaVJlc3BvbnNlLmRhdGEgZm9yIHBhZ2luYXRlZCBxdWVyaWVzXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUGFnaW5hdGVkUmVzcG9uc2U8VD4ge1xuICBkYXRhOiBUW107XG4gIG1ldGE6IHtcbiAgICB0b3RhbDogbnVtYmVyO1xuICAgIHBhZ2U6IG51bWJlcjtcbiAgICBsaW1pdDogbnVtYmVyO1xuICAgIHRvdGFsUGFnZXM6IG51bWJlcjtcbiAgICBoYXNOZXh0UGFnZTogYm9vbGVhbjtcbiAgICBoYXNQcmV2aW91c1BhZ2U6IGJvb2xlYW47XG4gIH07XG59XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFJFLUVYUE9SVFMgRlJPTSBTT1VSQ0VTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbi8vIFJlLWV4cG9ydCBhbGwgRFRPIHR5cGVzIGZyb20gQHNwb3RzZGV2L3R5cGVzIChPcGVuQVBJIGdlbmVyYXRlZClcbmV4cG9ydCAqIGZyb20gJ0BzcG90c2Rldi90eXBlcyc7XG5cbi8vIFJlLWV4cG9ydCBlbnRpdHkgdHlwZXMgZnJvbSBAcHJpc21hL2NsaWVudFxuZXhwb3J0IHR5cGUge1xuICAvLyBNb2RlbHNcbiAgVXNlcixcbiAgU3BvdCxcbiAgU3BvdFBvc3QsXG4gIFBvc3RSZXBseSxcbiAgUG9zdFJlc3BvbnNlLFxuICBQb3N0VXB2b3RlLFxuICBQb3N0UmVwb3J0LFxuICBDbHViLFxuICBDbHViTWVtYmVyLFxuICBDb252ZXJzYXRpb24sXG4gIE1lc3NhZ2UsXG4gIE5vdGlmaWNhdGlvbixcbiAgUG9zdFRlbXBsYXRlLFxuICBWaWJlLFxuICBJbnRlcmVzdCxcbiAgSW50ZW50aW9uLFxuICBMaWZlU2l0dWF0aW9uLFxuICBGYXZvcml0ZVNwb3QsXG4gIFNwb3RJbWFnZSxcbiAgU3BvdFZpYmUsXG4gIFNwb3RJbnRlbnRpb24sXG4gIFNwb3RDbGFpbSxcbiAgU3BvdFN1YnNjcmlwdGlvbixcbiAgQ2l0eSxcbiAgLy8gTWFya2V0cGxhY2UgTW9kZWxzXG4gIFByb2R1Y3QsXG4gIE9yZGVyLFxuICBPcmRlckl0ZW0sXG4gIFBheW1lbnQsXG4gIEludmVudG9yeUxvZyxcbiAgU3RyaXBlQ29ubmVjdEFjY291bnQsXG4gIC8vIEVudW1zXG4gIFNwb3RUeXBlLFxuICBTcG90UG9zdFR5cGUsXG4gIEFjY291bnRTdGF0dXMsXG4gIENsYWltU3RhdHVzLFxuICBSZXNwb25zZVN0YXR1cyxcbiAgUmVwb3J0UmVhc29uLFxuICBSZXBvcnRTdGF0dXMsXG4gIE5vdGlmaWNhdGlvblR5cGUsXG4gIC8vIE1hcmtldHBsYWNlIEVudW1zXG4gIFByb2R1Y3RUeXBlLFxuICBQcm9kdWN0U3RhdHVzLFxuICBPcmRlclN0YXR1cyxcbiAgUGF5bWVudFByb3ZpZGVyLFxuICBQYXltZW50U3RhdHVzLFxuICBGdWxmaWxsbWVudFR5cGUsXG4gIEludmVudG9yeUNoYW5nZVJlYXNvbixcbn0gZnJvbSAnQHByaXNtYS9jbGllbnQnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBTREsgVFlQRSBBTElBU0VTXG4vLyBUaGVzZSBwcm92aWRlIGNvbnZlbmllbnQgbmFtZXMgdGhhdCBtYXRjaCBTREsgdXNhZ2UgcGF0dGVybnNcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuaW1wb3J0IHR5cGUge1xuICBTZW5kT3RwRHRvLFxuICBWZXJpZnlPdHBEdG8sXG4gIENyZWF0ZVBvc3REdG8sXG4gIENyZWF0ZVJlcGx5RHRvLFxuICBDcmVhdGVSZXNwb25zZUR0byxcbiAgVXBkYXRlUmVzcG9uc2VEdG8sXG4gIFVwZGF0ZVVzZXJEdG8sXG4gIFVwdm90ZVJlc3BvbnNlRHRvLFxuICBWZXJpZnlPdHBXcmFwcGVkUmVzcG9uc2VEdG8sXG4gIENyZWF0ZUNvbnZlcnNhdGlvbkR0byxcbiAgQ3JlYXRlTWVzc2FnZUR0byxcbiAgQ2xhaW1TcG90RHRvLFxufSBmcm9tICdAc3BvdHNkZXYvdHlwZXMnO1xuXG5pbXBvcnQgdHlwZSB7IFNwb3RQb3N0LCBQb3N0VGVtcGxhdGUgfSBmcm9tICdAcHJpc21hL2NsaWVudCc7XG5cbi8vIFJlcXVlc3QgdHlwZSBhbGlhc2VzIChtYXAgdG8gRFRPcylcbmV4cG9ydCB0eXBlIFNlbmRPdHBSZXF1ZXN0ID0gU2VuZE90cER0bztcbmV4cG9ydCB0eXBlIFZlcmlmeU90cFJlcXVlc3QgPSBWZXJpZnlPdHBEdG87XG5leHBvcnQgdHlwZSBDcmVhdGVQb3N0UmVxdWVzdCA9IENyZWF0ZVBvc3REdG87XG5leHBvcnQgdHlwZSBDcmVhdGVSZXBseVJlcXVlc3QgPSBDcmVhdGVSZXBseUR0bztcbmV4cG9ydCB0eXBlIFJlc3BvbmRUb1Bvc3RSZXF1ZXN0ID0gQ3JlYXRlUmVzcG9uc2VEdG87XG5leHBvcnQgdHlwZSBVcGRhdGVSZXNwb25zZVJlcXVlc3QgPSBVcGRhdGVSZXNwb25zZUR0bztcbmV4cG9ydCB0eXBlIFVwZGF0ZVByb2ZpbGVSZXF1ZXN0ID0gVXBkYXRlVXNlckR0bztcbmV4cG9ydCB0eXBlIENyZWF0ZUNvbnZlcnNhdGlvblJlcXVlc3QgPSBDcmVhdGVDb252ZXJzYXRpb25EdG87XG5leHBvcnQgdHlwZSBTZW5kTWVzc2FnZVJlcXVlc3QgPSBDcmVhdGVNZXNzYWdlRHRvO1xuZXhwb3J0IHR5cGUgQ2xhaW1TcG90UmVxdWVzdCA9IENsYWltU3BvdER0bztcblxuLy8gUmVzcG9uc2UgdHlwZSBhbGlhc2VzXG5leHBvcnQgdHlwZSBVcHZvdGVSZXNwb25zZSA9IFVwdm90ZVJlc3BvbnNlRHRvO1xuZXhwb3J0IHR5cGUgQXV0aFJlc3BvbnNlID0gVmVyaWZ5T3RwV3JhcHBlZFJlc3BvbnNlRHRvO1xuXG4vLyBFbnRpdHkgdHlwZSBhbGlhc2VzIChmb3IgYmFja3dhcmQgY29tcGF0aWJpbGl0eSlcbmV4cG9ydCB0eXBlIFBvc3QgPSBTcG90UG9zdDtcbmV4cG9ydCB0eXBlIFRlbXBsYXRlID0gUG9zdFRlbXBsYXRlO1xuIl19

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Spots SDK
+ *
+ * TypeScript SDK for the Spots API with TanStack Query hooks.
+ *
+ * @example
+ * ```tsx
+ * import { configureSDK, useCurrentUser, useSpots, useCreatePost } from '@spots/sdk';
+ *
+ * // Configure SDK with your API base URL and token management
+ * configureSDK({
+ *   baseURL: 'https://spots-api-psi.vercel.app',
+ *   getAccessToken: () => localStorage.getItem('accessToken'),
+ *   refreshAccessToken: async () => {
+ *     // Your token refresh logic
+ *     return newAccessToken;
+ *   },
+ *   onUnauthorized: () => {
+ *     // Handle unauthorized access
+ *     window.location.href = '/login';
+ *   },
+ * });
+ *
+ * // Use hooks in your components
+ * function App() {
+ *   const { data: user } = useCurrentUser();
+ *   const { data: spots } = useSpots();
+ *   const { mutate: createPost } = useCreatePost();
+ *   // ...
+ * }
+ * ```
+ */
+export { configureSDK, getApiClient, getConfig } from './api/client';
+export type { SDKConfig } from './api/client';
+export * from './api/types';
+export * from './api/queries';
+export * from './api/mutations';
+export * from './api/services';

package/dist/index.js

@@ -0,0 +1,73 @@
+"use strict";
+/**
+ * Spots SDK
+ *
+ * TypeScript SDK for the Spots API with TanStack Query hooks.
+ *
+ * @example
+ * ```tsx
+ * import { configureSDK, useCurrentUser, useSpots, useCreatePost } from '@spots/sdk';
+ *
+ * // Configure SDK with your API base URL and token management
+ * configureSDK({
+ *   baseURL: 'https://spots-api-psi.vercel.app',
+ *   getAccessToken: () => localStorage.getItem('accessToken'),
+ *   refreshAccessToken: async () => {
+ *     // Your token refresh logic
+ *     return newAccessToken;
+ *   },
+ *   onUnauthorized: () => {
+ *     // Handle unauthorized access
+ *     window.location.href = '/login';
+ *   },
+ * });
+ *
+ * // Use hooks in your components
+ * function App() {
+ *   const { data: user } = useCurrentUser();
+ *   const { data: spots } = useSpots();
+ *   const { mutate: createPost } = useCreatePost();
+ *   // ...
+ * }
+ * ```
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getConfig = exports.getApiClient = exports.configureSDK = void 0;
+// ============================================================================
+// API CLIENT
+// ============================================================================
+var client_1 = require("./api/client");
+Object.defineProperty(exports, "configureSDK", { enumerable: true, get: function () { return client_1.configureSDK; } });
+Object.defineProperty(exports, "getApiClient", { enumerable: true, get: function () { return client_1.getApiClient; } });
+Object.defineProperty(exports, "getConfig", { enumerable: true, get: function () { return client_1.getConfig; } });
+// ============================================================================
+// TYPES
+// ============================================================================
+__exportStar(require("./api/types"), exports);
+// ============================================================================
+// QUERY HOOKS
+// ============================================================================
+__exportStar(require("./api/queries"), exports);
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+__exportStar(require("./api/mutations"), exports);
+// ============================================================================
+// SERVICES (Plain async functions for testing/non-React)
+// ============================================================================
+__exportStar(require("./api/services"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBK0JHOzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILCtFQUErRTtBQUMvRSxhQUFhO0FBQ2IsK0VBQStFO0FBRS9FLHVDQUFxRTtBQUE1RCxzR0FBQSxZQUFZLE9BQUE7QUFBRSxzR0FBQSxZQUFZLE9BQUE7QUFBRSxtR0FBQSxTQUFTLE9BQUE7QUFHOUMsK0VBQStFO0FBQy9FLFFBQVE7QUFDUiwrRUFBK0U7QUFFL0UsOENBQTRCO0FBRTVCLCtFQUErRTtBQUMvRSxjQUFjO0FBQ2QsK0VBQStFO0FBRS9FLGdEQUE4QjtBQUU5QiwrRUFBK0U7QUFDL0UsaUJBQWlCO0FBQ2pCLCtFQUErRTtBQUUvRSxrREFBZ0M7QUFFaEMsK0VBQStFO0FBQy9FLHlEQUF5RDtBQUN6RCwrRUFBK0U7QUFFL0UsaURBQStCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTcG90cyBTREtcbiAqXG4gKiBUeXBlU2NyaXB0IFNESyBmb3IgdGhlIFNwb3RzIEFQSSB3aXRoIFRhblN0YWNrIFF1ZXJ5IGhvb2tzLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0c3hcbiAqIGltcG9ydCB7IGNvbmZpZ3VyZVNESywgdXNlQ3VycmVudFVzZXIsIHVzZVNwb3RzLCB1c2VDcmVhdGVQb3N0IH0gZnJvbSAnQHNwb3RzL3Nkayc7XG4gKlxuICogLy8gQ29uZmlndXJlIFNESyB3aXRoIHlvdXIgQVBJIGJhc2UgVVJMIGFuZCB0b2tlbiBtYW5hZ2VtZW50XG4gKiBjb25maWd1cmVTREsoe1xuICogICBiYXNlVVJMOiAnaHR0cHM6Ly9zcG90cy1hcGktcHNpLnZlcmNlbC5hcHAnLFxuICogICBnZXRBY2Nlc3NUb2tlbjogKCkgPT4gbG9jYWxTdG9yYWdlLmdldEl0ZW0oJ2FjY2Vzc1Rva2VuJyksXG4gKiAgIHJlZnJlc2hBY2Nlc3NUb2tlbjogYXN5bmMgKCkgPT4ge1xuICogICAgIC8vIFlvdXIgdG9rZW4gcmVmcmVzaCBsb2dpY1xuICogICAgIHJldHVybiBuZXdBY2Nlc3NUb2tlbjtcbiAqICAgfSxcbiAqICAgb25VbmF1dGhvcml6ZWQ6ICgpID0+IHtcbiAqICAgICAvLyBIYW5kbGUgdW5hdXRob3JpemVkIGFjY2Vzc1xuICogICAgIHdpbmRvdy5sb2NhdGlvbi5ocmVmID0gJy9sb2dpbic7XG4gKiAgIH0sXG4gKiB9KTtcbiAqXG4gKiAvLyBVc2UgaG9va3MgaW4geW91ciBjb21wb25lbnRzXG4gKiBmdW5jdGlvbiBBcHAoKSB7XG4gKiAgIGNvbnN0IHsgZGF0YTogdXNlciB9ID0gdXNlQ3VycmVudFVzZXIoKTtcbiAqICAgY29uc3QgeyBkYXRhOiBzcG90cyB9ID0gdXNlU3BvdHMoKTtcbiAqICAgY29uc3QgeyBtdXRhdGU6IGNyZWF0ZVBvc3QgfSA9IHVzZUNyZWF0ZVBvc3QoKTtcbiAqICAgLy8gLi4uXG4gKiB9XG4gKiBgYGBcbiAqL1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBBUEkgQ0xJRU5UXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCB7IGNvbmZpZ3VyZVNESywgZ2V0QXBpQ2xpZW50LCBnZXRDb25maWcgfSBmcm9tICcuL2FwaS9jbGllbnQnO1xuZXhwb3J0IHR5cGUgeyBTREtDb25maWcgfSBmcm9tICcuL2FwaS9jbGllbnQnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBUWVBFU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgKiBmcm9tICcuL2FwaS90eXBlcyc7XG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFFVRVJZIEhPT0tTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCAqIGZyb20gJy4vYXBpL3F1ZXJpZXMnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBNVVRBVElPTiBIT09LU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgKiBmcm9tICcuL2FwaS9tdXRhdGlvbnMnO1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBTRVJWSUNFUyAoUGxhaW4gYXN5bmMgZnVuY3Rpb25zIGZvciB0ZXN0aW5nL25vbi1SZWFjdClcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0ICogZnJvbSAnLi9hcGkvc2VydmljZXMnO1xuIl19

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@spotsdev/sdk",
+  "version": "1.0.0",
+  "description": "Shared TypeScript SDK for Spots API - TanStack Query hooks, API client, and utilities",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "generate": "prisma generate --schema=../spots-api/prisma/schema.prisma",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "spots",
+    "api",
+    "sdk",
+    "tanstack-query",
+    "react-query",
+    "typescript"
+  ],
+  "author": "SoulToSoul",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": "^5.0.0",
+    "axios": "^1.6.0",
+    "react": ">=18.0.0",
+    "zod": "^3.0.0"
+  },
+  "dependencies": {
+    "@spotsdev/types": "^1.0.0"
+  },
+  "devDependencies": {
+    "@spotsdev/types": "^1.0.0",
+    "@tanstack/react-query": "^5.0.0",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.0.0",
+    "axios": "^1.6.0",
+    "react": "^18.0.0",
+    "typescript": "^5.9.3",
+    "zod": "^3.0.0"
+  }
+}

package/src/api/client.ts

@@ -0,0 +1,78 @@
+import axios, { AxiosInstance, AxiosError, InternalAxiosRequestConfig } from 'axios';
+
+export interface SDKConfig {
+  baseURL: string;
+  getAccessToken: () => string | null | Promise<string | null>;
+  refreshAccessToken?: () => Promise<string>;
+  onUnauthorized?: () => void;
+}
+
+let config: SDKConfig | null = null;
+let apiClient: AxiosInstance | null = null;
+
+export function configureSDK(sdkConfig: SDKConfig): void {
+  config = sdkConfig;
+  apiClient = createApiClient(sdkConfig);
+}
+
+export function getApiClient(): AxiosInstance {
+  if (!apiClient) {
+    throw new Error('SDK not configured. Call configureSDK() first.');
+  }
+  return apiClient;
+}
+
+export function getConfig(): SDKConfig {
+  if (!config) {
+    throw new Error('SDK not configured. Call configureSDK() first.');
+  }
+  return config;
+}
+
+function createApiClient(sdkConfig: SDKConfig): AxiosInstance {
+  const client = axios.create({
+    baseURL: sdkConfig.baseURL,
+    headers: {
+      'Content-Type': 'application/json',
+    },
+  });
+
+  // Request interceptor - add auth token
+  client.interceptors.request.use(
+    async (requestConfig: InternalAxiosRequestConfig) => {
+      const token = await sdkConfig.getAccessToken();
+      if (token) {
+        requestConfig.headers.Authorization = `Bearer ${token}`;
+      }
+      return requestConfig;
+    },
+    (error) => Promise.reject(error)
+  );
+
+  // Response interceptor - handle 401
+  client.interceptors.response.use(
+    (response) => response,
+    async (error: AxiosError) => {
+      if (error.response?.status === 401) {
+        if (sdkConfig.refreshAccessToken) {
+          try {
+            const newToken = await sdkConfig.refreshAccessToken();
+            if (newToken && error.config) {
+              error.config.headers.Authorization = `Bearer ${newToken}`;
+              return client.request(error.config);
+            }
+          } catch {
+            sdkConfig.onUnauthorized?.();
+          }
+        } else {
+          sdkConfig.onUnauthorized?.();
+        }
+      }
+      return Promise.reject(error);
+    }
+  );
+
+  return client;
+}
+
+export { apiClient };

package/src/api/mutations/clubs.ts

@@ -0,0 +1,107 @@
+/**
+ * Clubs Mutation Hooks
+ *
+ * TanStack Query hooks for club mutation operations.
+ */
+
+import { useMutation, useQueryClient, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { clubKeys } from '../queries/clubs';
+import { userKeys } from '../queries/users';
+import type { Club, ApiResponse } from '../types';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new club
+ *
+ * @endpoint POST /api/v1/clubs
+ */
+export function useCreateClub(
+  options?: Omit<UseMutationOptions<Club, Error, { spotId: string; name: string; description?: string }>, 'mutationFn'>
+): UseMutationResult<Club, Error, { spotId: string; name: string; description?: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data): Promise<Club> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<Club>>('/api/v1/clubs', data);
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: clubKeys.bySpot(variables.spotId) });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Update a club
+ *
+ * @endpoint PUT /api/v1/clubs/{id}
+ */
+export function useUpdateClub(
+  options?: Omit<UseMutationOptions<Club, Error, { clubId: string; name?: string; description?: string }>, 'mutationFn'>
+): UseMutationResult<Club, Error, { clubId: string; name?: string; description?: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ clubId, ...data }): Promise<Club> => {
+      const client = getApiClient();
+      const response = await client.put<ApiResponse<Club>>(`/api/v1/clubs/${clubId}`, data);
+      return response.data.data;
+    },
+    onSuccess: (data, variables) => {
+      queryClient.setQueryData(clubKeys.detail(variables.clubId), data);
+    },
+    ...options,
+  });
+}
+
+/**
+ * Join a club
+ *
+ * @endpoint POST /api/v1/clubs/{id}/join
+ */
+export function useJoinClub(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (clubId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.post(`/api/v1/clubs/${clubId}/join`);
+    },
+    onSuccess: (_, clubId) => {
+      queryClient.invalidateQueries({ queryKey: clubKeys.detail(clubId) });
+      queryClient.invalidateQueries({ queryKey: userKeys.clubs() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Leave a club
+ *
+ * @endpoint POST /api/v1/clubs/{id}/leave
+ */
+export function useLeaveClub(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (clubId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.post(`/api/v1/clubs/${clubId}/leave`);
+    },
+    onSuccess: (_, clubId) => {
+      queryClient.invalidateQueries({ queryKey: clubKeys.detail(clubId) });
+      queryClient.invalidateQueries({ queryKey: userKeys.clubs() });
+    },
+    ...options,
+  });
+}

package/src/api/mutations/conversations.ts

@@ -0,0 +1,124 @@
+/**
+ * Conversations Mutation Hooks
+ *
+ * TanStack Query hooks for conversation/messaging mutation operations.
+ */
+
+import { useMutation, useQueryClient, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
+import { getApiClient } from '../client';
+import { conversationKeys } from '../queries/conversations';
+import type { Conversation, Message, CreateConversationRequest, SendMessageRequest, ApiResponse } from '../types';
+
+// ============================================================================
+// MUTATION HOOKS
+// ============================================================================
+
+/**
+ * Create a new conversation
+ *
+ * @endpoint POST /api/v1/conversations
+ */
+export function useCreateConversation(
+  options?: Omit<UseMutationOptions<Conversation, Error, CreateConversationRequest>, 'mutationFn'>
+): UseMutationResult<Conversation, Error, CreateConversationRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: CreateConversationRequest): Promise<Conversation> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<Conversation>>('/api/v1/conversations', data);
+      return response.data.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: conversationKeys.lists() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Create or get direct conversation with a user
+ *
+ * @endpoint POST /api/v1/conversations/direct
+ */
+export function useCreateDirectConversation(
+  options?: Omit<UseMutationOptions<Conversation, Error, { userId: string }>, 'mutationFn'>
+): UseMutationResult<Conversation, Error, { userId: string }> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (data: { userId: string }): Promise<Conversation> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<Conversation>>('/api/v1/conversations/direct', data);
+      return response.data.data;
+    },
+    onSuccess: () => {
+      queryClient.invalidateQueries({ queryKey: conversationKeys.lists() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Send a message in a conversation
+ *
+ * @endpoint POST /api/v1/conversations/{id}/messages
+ */
+export function useSendMessage(
+  options?: Omit<UseMutationOptions<Message, Error, { conversationId: string } & SendMessageRequest>, 'mutationFn'>
+): UseMutationResult<Message, Error, { conversationId: string } & SendMessageRequest> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async ({ conversationId, ...data }): Promise<Message> => {
+      const client = getApiClient();
+      const response = await client.post<ApiResponse<Message>>(`/api/v1/conversations/${conversationId}/messages`, data);
+      return response.data.data;
+    },
+    onSuccess: (_, variables) => {
+      queryClient.invalidateQueries({ queryKey: conversationKeys.messages(variables.conversationId) });
+      queryClient.invalidateQueries({ queryKey: conversationKeys.lists() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Mark conversation as read
+ *
+ * @endpoint PUT /api/v1/conversations/{id}/read
+ */
+export function useMarkConversationAsRead(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  const queryClient = useQueryClient();
+
+  return useMutation({
+    mutationFn: async (conversationId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.put(`/api/v1/conversations/${conversationId}/read`);
+    },
+    onSuccess: (_, conversationId) => {
+      queryClient.invalidateQueries({ queryKey: conversationKeys.detail(conversationId) });
+      queryClient.invalidateQueries({ queryKey: conversationKeys.lists() });
+    },
+    ...options,
+  });
+}
+
+/**
+ * Send typing indicator
+ *
+ * @endpoint POST /api/v1/conversations/{id}/typing
+ */
+export function useSendTypingIndicator(
+  options?: Omit<UseMutationOptions<void, Error, string>, 'mutationFn'>
+): UseMutationResult<void, Error, string> {
+  return useMutation({
+    mutationFn: async (conversationId: string): Promise<void> => {
+      const client = getApiClient();
+      await client.post(`/api/v1/conversations/${conversationId}/typing`);
+    },
+    ...options,
+  });
+}

package/src/api/mutations/index.ts

@@ -0,0 +1,29 @@
+/**
+ * Spots SDK Mutation Hooks Index
+ *
+ * Re-exports all mutation hooks.
+ */
+
+// Users
+export * from './users';
+
+// Posts
+export * from './posts';
+
+// Spots
+export * from './spots';
+
+// Conversations
+export * from './conversations';
+
+// Clubs
+export * from './clubs';
+
+// Notifications
+export * from './notifications';
+
+// Products (marketplace)
+export * from './products';
+
+// Orders (marketplace)
+export * from './orders';