@spotsdev/sdk 1.0.0 → 1.1.0

package/dist/index.d.ts

@@ -30,9 +30,8 @@
  * }
  * ```
  */
-export { configureSDK, getApiClient, getConfig } from './api/client';
 export type { SDKConfig } from './api/client';
+export { configureSDK, getApiClient, getConfig } from './api/client';
 export * from './api/types';
 export * from './api/queries';
 export * from './api/mutations';
-export * from './api/services';

package/dist/index.js

@@ -47,9 +47,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 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; } });
@@ -66,8 +63,4 @@ __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
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBK0JHOzs7Ozs7Ozs7Ozs7Ozs7OztBQU9ILHVDQUFrRTtBQUExRCxzR0FBQSxZQUFZLE9BQUE7QUFBRSxzR0FBQSxZQUFZLE9BQUE7QUFBRSxtR0FBQSxTQUFTLE9BQUE7QUFFN0MsK0VBQStFO0FBQy9FLFFBQVE7QUFDUiwrRUFBK0U7QUFFL0UsOENBQTJCO0FBRTNCLCtFQUErRTtBQUMvRSxjQUFjO0FBQ2QsK0VBQStFO0FBRS9FLGdEQUE2QjtBQUU3QiwrRUFBK0U7QUFDL0UsaUJBQWlCO0FBQ2pCLCtFQUErRTtBQUUvRSxrREFBK0IiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFNwb3RzIFNES1xuICpcbiAqIFR5cGVTY3JpcHQgU0RLIGZvciB0aGUgU3BvdHMgQVBJIHdpdGggVGFuU3RhY2sgUXVlcnkgaG9va3MuXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHRzeFxuICogaW1wb3J0IHsgY29uZmlndXJlU0RLLCB1c2VDdXJyZW50VXNlciwgdXNlU3BvdHMsIHVzZUNyZWF0ZVBvc3QgfSBmcm9tICdAc3BvdHMvc2RrJztcbiAqXG4gKiAvLyBDb25maWd1cmUgU0RLIHdpdGggeW91ciBBUEkgYmFzZSBVUkwgYW5kIHRva2VuIG1hbmFnZW1lbnRcbiAqIGNvbmZpZ3VyZVNESyh7XG4gKiAgIGJhc2VVUkw6ICdodHRwczovL3Nwb3RzLWFwaS1wc2kudmVyY2VsLmFwcCcsXG4gKiAgIGdldEFjY2Vzc1Rva2VuOiAoKSA9PiBsb2NhbFN0b3JhZ2UuZ2V0SXRlbSgnYWNjZXNzVG9rZW4nKSxcbiAqICAgcmVmcmVzaEFjY2Vzc1Rva2VuOiBhc3luYyAoKSA9PiB7XG4gKiAgICAgLy8gWW91ciB0b2tlbiByZWZyZXNoIGxvZ2ljXG4gKiAgICAgcmV0dXJuIG5ld0FjY2Vzc1Rva2VuO1xuICogICB9LFxuICogICBvblVuYXV0aG9yaXplZDogKCkgPT4ge1xuICogICAgIC8vIEhhbmRsZSB1bmF1dGhvcml6ZWQgYWNjZXNzXG4gKiAgICAgd2luZG93LmxvY2F0aW9uLmhyZWYgPSAnL2xvZ2luJztcbiAqICAgfSxcbiAqIH0pO1xuICpcbiAqIC8vIFVzZSBob29rcyBpbiB5b3VyIGNvbXBvbmVudHNcbiAqIGZ1bmN0aW9uIEFwcCgpIHtcbiAqICAgY29uc3QgeyBkYXRhOiB1c2VyIH0gPSB1c2VDdXJyZW50VXNlcigpO1xuICogICBjb25zdCB7IGRhdGE6IHNwb3RzIH0gPSB1c2VTcG90cygpO1xuICogICBjb25zdCB7IG11dGF0ZTogY3JlYXRlUG9zdCB9ID0gdXNlQ3JlYXRlUG9zdCgpO1xuICogICAvLyAuLi5cbiAqIH1cbiAqIGBgYFxuICovXG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIEFQSSBDTElFTlRcbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cblxuZXhwb3J0IHR5cGUge1NES0NvbmZpZ30gZnJvbSAnLi9hcGkvY2xpZW50J1xuZXhwb3J0IHtjb25maWd1cmVTREssIGdldEFwaUNsaWVudCwgZ2V0Q29uZmlnfSBmcm9tICcuL2FwaS9jbGllbnQnXG5cbi8vID09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT1cbi8vIFRZUEVTXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG5cbmV4cG9ydCAqIGZyb20gJy4vYXBpL3R5cGVzJ1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBRVUVSWSBIT09LU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgKiBmcm9tICcuL2FwaS9xdWVyaWVzJ1xuXG4vLyA9PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09XG4vLyBNVVRBVElPTiBIT09LU1xuLy8gPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PVxuXG5leHBvcnQgKiBmcm9tICcuL2FwaS9tdXRhdGlvbnMnXG4iXX0=

package/package.json

@@ -1,15 +1,11 @@
 {
   "name": "@spotsdev/sdk",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Shared TypeScript SDK for Spots API - TanStack Query hooks, API client, and utilities",
   "main": "dist/index.js",
+  "source": "src/index.ts",
   "types": "dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
-    }
-  },
+  "react-native": "src/index.ts",
   "files": [
     "dist",
     "src"
@@ -18,8 +14,6 @@
     "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": [
@@ -31,27 +25,18 @@
     "typescript"
   ],
   "author": "SoulToSoul",
-  "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
+  "license": "UNLICENSED",
   "peerDependencies": {
     "@tanstack/react-query": "^5.0.0",
     "axios": "^1.6.0",
-    "react": ">=18.0.0",
-    "zod": "^3.0.0"
+    "react": ">=18.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"
+    "typescript": "^5.7.0"
   }
 }

package/src/api/client.ts

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

package/src/api/entities.ts

@@ -0,0 +1,420 @@
+/**
+ * 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.
+ */
+
+// ============================================================================
+// ENUMS
+// ============================================================================
+
+export type SpotType =
+  | 'CAFE'
+  | 'RESTAURANT'
+  | 'BAR'
+  | 'PARK'
+  | 'BEACH'
+  | 'COWORKING'
+  | 'LIBRARY'
+  | 'GYM'
+  | 'MUSEUM'
+  | 'GALLERY'
+  | 'THEATER'
+  | 'CINEMA'
+  | 'MALL'
+  | 'MARKET'
+  | 'HOTEL'
+  | 'HOSTEL'
+  | 'OTHER'
+
+export type SpotPostType =
+  | 'CHECK_IN'
+  | 'LOOKING_FOR'
+  | 'OFFERING'
+  | 'QUESTION'
+  | 'EVENT'
+  | 'RECOMMENDATION'
+  | 'GENERAL'
+
+export type AccountStatus = 'ACTIVE' | 'SUSPENDED' | 'DELETED' | 'PENDING'
+
+export type ClaimStatus = 'PENDING' | 'APPROVED' | 'REJECTED'
+
+export type ResponseStatus = 'PENDING' | 'ACCEPTED' | 'DECLINED'
+
+export type ReportReason =
+  | 'SPAM'
+  | 'HARASSMENT'
+  | 'INAPPROPRIATE'
+  | 'SCAM'
+  | 'OTHER'
+
+export type ReportStatus = 'PENDING' | 'REVIEWED' | 'RESOLVED' | 'DISMISSED'
+
+export type NotificationType =
+  | 'POST_RESPONSE'
+  | 'POST_REPLY'
+  | 'POST_UPVOTE'
+  | 'RESPONSE_ACCEPTED'
+  | 'RESPONSE_DECLINED'
+  | 'NEW_MESSAGE'
+  | 'SYSTEM'
+
+// ============================================================================
+// ENTITY INTERFACES
+// ============================================================================
+
+export interface User {
+  id: string
+  phone: string | null
+  email: string | null
+  name: string | null
+  bio: string | null
+  avatarUrl: string | null
+  status: AccountStatus
+  onboardingCompleted: boolean
+  lastActiveAt: Date | null
+  createdAt: Date
+  updatedAt: Date
+}
+
+export 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
+  type: SpotType
+  googlePlaceId: string | null
+  website: string | null
+  phone: string | null
+  imageUrl: string | null
+  ownerId: string | null
+  isVerified: boolean
+  createdAt: Date
+  updatedAt: Date
+}
+
+export 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
+  // Relations (optional, populated by API)
+  user?: User
+  spot?: Spot
+}
+
+export interface PostReply {
+  id: string
+  postId: string
+  userId: string
+  content: string
+  createdAt: Date
+  updatedAt: Date
+  user?: User
+}
+
+export interface PostResponse {
+  id: string
+  postId: string
+  userId: string
+  note: string | null
+  status: ResponseStatus
+  createdAt: Date
+  updatedAt: Date
+  user?: User
+  post?: SpotPost
+}
+
+export interface PostUpvote {
+  id: string
+  postId: string
+  userId: string
+  createdAt: Date
+}
+
+/**
+ * PostUpvoter - user who upvoted a post (from /posts/:id/upvotes endpoint)
+ */
+export interface PostUpvoter {
+  id: string
+  userId: string
+  name: string | null
+  avatarUrl: string | null
+  createdAt: Date
+}
+
+/**
+ * PostUpvotesResponse - response from /posts/:id/upvotes endpoint
+ */
+export interface PostUpvotesResponse {
+  data: PostUpvoter[]
+  meta: {
+    total: number
+    limit: number
+    offset: number
+    hasMore: boolean
+    currentUserUpvoted: boolean
+    isPostAuthor: boolean
+  }
+}
+
+export interface PostReport {
+  id: string
+  postId: string
+  userId: string
+  reason: ReportReason
+  details: string | null
+  status: ReportStatus
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface Club {
+  id: string
+  name: string
+  slug: string
+  description: string | null
+  imageUrl: string | null
+  isPrivate: boolean
+  createdById: string
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface ClubMember {
+  id: string
+  clubId: string
+  userId: string
+  role: 'MEMBER' | 'ADMIN' | 'OWNER'
+  joinedAt: Date
+}
+
+export interface Conversation {
+  id: string
+  createdAt: Date
+  updatedAt: Date
+  participants?: User[]
+  messages?: Message[]
+}
+
+export interface Message {
+  id: string
+  conversationId: string
+  senderId: string
+  content: string
+  createdAt: Date
+  sender?: User
+}
+
+export interface Notification {
+  id: string
+  userId: string
+  type: NotificationType
+  title: string
+  body: string | null
+  data: Record<string, unknown> | null
+  isRead: boolean
+  createdAt: Date
+}
+
+export interface PostTemplate {
+  id: string
+  postType: SpotPostType
+  emoji: string
+  title: string
+  placeholder: string | null
+  isActive: boolean
+  sortOrder: number
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface Vibe {
+  id: string
+  name: string
+  emoji: string | null
+  createdAt: Date
+}
+
+export interface Interest {
+  id: string
+  name: string
+  emoji: string | null
+  category: string | null
+  createdAt: Date
+}
+
+export interface Intention {
+  id: string
+  name: string
+  emoji: string | null
+  createdAt: Date
+}
+
+export interface LifeSituation {
+  id: string
+  name: string
+  emoji: string | null
+  createdAt: Date
+}
+
+export interface FavoriteSpot {
+  id: string
+  userId: string
+  spotId: string
+  createdAt: Date
+  spot?: Spot
+}
+
+export interface SpotImage {
+  id: string
+  spotId: string
+  url: string
+  caption: string | null
+  sortOrder: number
+  createdAt: Date
+}
+
+export interface SpotVibe {
+  id: string
+  spotId: string
+  vibeId: string
+  vibe?: Vibe
+}
+
+export interface SpotIntention {
+  id: string
+  spotId: string
+  intentionId: string
+  intention?: Intention
+}
+
+export interface SpotClaim {
+  id: string
+  spotId: string
+  userId: string
+  status: ClaimStatus
+  verificationMethod: string | null
+  createdAt: Date
+  updatedAt: Date
+}
+
+export interface SpotSubscription {
+  id: string
+  spotId: string
+  userId: string
+  createdAt: Date
+  spot?: Spot
+}
+
+export interface City {
+  id: string
+  name: string
+  country: string
+  latitude: number
+  longitude: number
+  timezone: string | null
+  createdAt: Date
+}
+
+// ============================================================================
+// API RESPONSE TYPES
+// ============================================================================
+
+// NOTE: ApiResponse is re-exported from @spots/types in types.ts
+
+/**
+ * Paginated response with meta information
+ */
+export interface PaginatedResponse<T> {
+  data: T[]
+  meta: PaginationMeta
+}
+
+export interface PaginationMeta {
+  total: number
+  page: number
+  limit: number
+  totalPages: number
+  hasNextPage: boolean
+  hasPreviousPage: boolean
+}
+
+// ============================================================================
+// MARKETPLACE TYPES
+// ============================================================================
+
+export type ProductType = 'PHYSICAL' | 'DIGITAL' | 'SERVICE' | 'BUNDLE'
+
+export type ProductStatus = 'DRAFT' | 'ACTIVE' | 'SOLD_OUT' | 'ARCHIVED'
+
+export type OrderStatus =
+  | 'PENDING'
+  | 'CONFIRMED'
+  | 'PREPARING'
+  | 'READY'
+  | 'COMPLETED'
+  | 'CANCELLED'
+  | 'REFUNDED'
+
+export interface Product {
+  id: string
+  spotId: string
+  name: string
+  slug: string
+  description: string | null
+  type: ProductType
+  status: ProductStatus
+  price: number
+  currency: string
+  imageUrl: string | null
+  images: string[]
+  stock: number | null
+  maxQuantity: number
+  sortOrder: number
+  metadata: Record<string, unknown> | null
+  createdAt: Date
+  updatedAt: Date
+}
+
+export 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
+}
+
+export interface OrderItem {
+  id: string
+  orderId: string
+  productId: string
+  quantity: number
+  unitPrice: number
+  total: number
+  createdAt: Date
+}