@turtleclub/hooks 0.0.1

package/README.md

@@ -0,0 +1,50 @@
+# @turtledev/hooks
+
+React hooks and utilities for building applications with the Turtle ecosystem.
+
+## Installation
+
+```bash
+npm install @turtledev/hooks
+# or
+yarn add @turtledev/hooks
+# or
+bun add @turtledev/hooks
+```
+
+## Features
+
+- 🎣 **React Query hooks** for API endpoints
+- 🔧 **Utility functions** for chains, formatting, and numbers
+- 🔄 **Automatic caching** and persistence
+- 📝 **TypeScript** support with full type safety
+
+## Usage
+
+### API Hooks
+
+```typescript
+import { useOrganizations, useConfig } from "@turtledev/hooks";
+
+function MyComponent() {
+  const { data: organizations, isLoading } = useOrganizations();
+  
+  if (isLoading) return <div>Loading...</div>;
+  
+  return <div>{organizations?.name}</div>;
+}
+```
+
+## Available Hooks
+
+### Endpoints
+- `useOrganizations()` - Get organization data
+- `useOrganizationDeals()` - Get organization deals
+- `useOrganizationsDeals()` - Get all organizations deals
+- `useProjectTvl()` - Get project TVL data
+- `useExists()` - Check if user exists
+- `usePrepareSignup()` - Prepare signup process
+- `useSignup()` - Complete signup
+
+### Configuration
+- `useConfig()` - Get current API configuration

package/dist/index.cjs

@@ -0,0 +1,301 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  defaultQueryClient: () => defaultQueryClient,
+  useConfig: () => useConfig,
+  useEarnDeals: () => useEarnDeals,
+  useEarnRoute: () => useEarnRoute,
+  useEarnWalletBalances: () => useEarnWalletBalances,
+  useExists: () => useExists,
+  useOrganizationDeals: () => useOrganizationDeals,
+  useOrganizations: () => useOrganizations,
+  useOrganizationsDeals: () => useOrganizationsDeals,
+  usePrepareSignup: () => usePrepareSignup,
+  useProjectTvl: () => useProjectTvl,
+  useSignup: () => useSignup
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/hooks/useConfig.ts
+var import_api = require("@turtleclub/api");
+function useConfig() {
+  return import_api.defaultConfig;
+}
+
+// src/hooks/client.ts
+var import_query_sync_storage_persister = require("@tanstack/query-sync-storage-persister");
+var import_react_query = require("@tanstack/react-query");
+var import_react_query_persist_client = require("@tanstack/react-query-persist-client");
+var defaultQueryClient = new import_react_query.QueryClient({
+  defaultOptions: {
+    queries: {
+      refetchOnWindowFocus: false
+    }
+  }
+});
+if (typeof window !== "undefined") {
+  const localStoragePersister = (0, import_query_sync_storage_persister.createSyncStoragePersister)({
+    storage: window.localStorage,
+    key: "turtle-sdk"
+  });
+  (0, import_react_query_persist_client.persistQueryClient)({
+    queryClient: defaultQueryClient,
+    persister: localStoragePersister
+  });
+}
+
+// src/hooks/endpoints/useOrganizations.ts
+var import_react_query2 = require("@tanstack/react-query");
+var import_api2 = require("@turtleclub/api");
+function useOrganizations({
+  config,
+  queryClient
+} = {}) {
+  const defaultConfig2 = useConfig();
+  const query = (0, import_react_query2.useQuery)(
+    {
+      queryKey: ["organizations"],
+      queryFn: async () => {
+        return await (0, import_api2.organization)(config ?? defaultConfig2);
+      },
+      staleTime: 2 * 60 * 1e3,
+      refetchInterval: 1 * 60 * 1e3
+    },
+    queryClient ?? defaultQueryClient
+  );
+  return query;
+}
+
+// src/hooks/endpoints/useExists.ts
+var import_react_query3 = require("@tanstack/react-query");
+var import_api3 = require("@turtleclub/api");
+function useExists(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query3.useQuery)({
+    queryKey: ["exists", options?.user],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await (0, import_api3.exists)(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    refetchInterval: 1 * 60 * 1e3,
+    refetchOnWindowFocus: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useOrganizationDeals.ts
+var import_react_query4 = require("@tanstack/react-query");
+var import_api4 = require("@turtleclub/api");
+function useOrganizationDeals(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query4.useQuery)({
+    queryKey: ["organizationDeals", options?.organizationId],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await (0, import_api4.organizationDeals)(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    refetchInterval: 1 * 60 * 1e3
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useOrganizationsDeals.ts
+var import_react_query5 = require("@tanstack/react-query");
+var import_api5 = require("@turtleclub/api");
+function useOrganizationsDeals(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query5.useQuery)({
+    queryKey: ["organizationsDeals", options?.organizationIds],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await (0, import_api5.organizationsDeals)(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    refetchInterval: 1 * 60 * 1e3,
+    throwOnError: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/usePrepareSignup.ts
+var import_react_query6 = require("@tanstack/react-query");
+var import_api6 = require("@turtleclub/api");
+function usePrepareSignup(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query6.useQuery)({
+    queryKey: ["prepareSignup", options?.user],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await (0, import_api6.prepareSignup)(options, config ?? defaultConfig2);
+    },
+    enabled,
+    refetchInterval: 5 * 60 * 1e3
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useProjectTvl.ts
+var import_react_query7 = require("@tanstack/react-query");
+var import_api7 = require("@turtleclub/api");
+function useProjectTvl(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query7.useQuery)({
+    queryKey: ["projectTvl", options?.projects],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await (0, import_api7.projectTvl)(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 7 * 60 * 1e3,
+    refetchInterval: 5 * 60 * 1e3
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useSignup.ts
+var import_react_query8 = require("@tanstack/react-query");
+var import_api8 = require("@turtleclub/api");
+function useSignup(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const mutation = (0, import_react_query8.useMutation)(
+    {
+      mutationFn: async (signature) => {
+        if (!enabled) return null;
+        return await (0, import_api8.signup)({ ...options, signature }, config ?? defaultConfig2);
+      }
+    },
+    queryClient ?? defaultQueryClient
+  );
+  return mutation;
+}
+
+// src/hooks/endpoints/earn/useDeals.ts
+var import_react_query9 = require("@tanstack/react-query");
+var import_api9 = require("@turtleclub/api");
+function useEarnDeals(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query9.useQuery)({
+    queryKey: [
+      "earn-deals",
+      options?.campaignId,
+      options?.idFilter,
+      options?.protocolFilter
+    ],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await (0, import_api9.earnDeals)(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 60 * 1e3,
+    refetchInterval: 30 * 1e3,
+    refetchOnWindowFocus: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/earn/useRoute.ts
+var import_react_query10 = require("@tanstack/react-query");
+var import_api10 = require("@turtleclub/api");
+function useEarnRoute(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query10.useQuery)({
+    queryKey: [
+      "earnRoute",
+      options?.user,
+      options?.chain,
+      options?.slippage,
+      options?.tokenIn,
+      options?.tokenOut,
+      options?.amount
+    ],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await (0, import_api10.earnRoute)(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    // 2 minutes - longer stale time for transaction stability
+    refetchInterval: false,
+    // Disable automatic refetch to prevent transaction state reset
+    refetchOnWindowFocus: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/earn/useWalletBalances.ts
+var import_react_query11 = require("@tanstack/react-query");
+var import_api11 = require("@turtleclub/api");
+function useEarnWalletBalances(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = (0, import_react_query11.useQuery)(
+    {
+      queryKey: ["earnWalletBalances", options?.chain, options?.user],
+      queryFn: async () => {
+        if (!enabled) return null;
+        return await (0, import_api11.earnWalletBalances)(options, config ?? defaultConfig2);
+      },
+      enabled,
+      staleTime: 30 * 1e3,
+      refetchInterval: 15 * 1e3,
+      refetchOnWindowFocus: true
+    },
+    queryClient ?? defaultQueryClient
+  );
+  return query;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defaultQueryClient,
+  useConfig,
+  useEarnDeals,
+  useEarnRoute,
+  useEarnWalletBalances,
+  useExists,
+  useOrganizationDeals,
+  useOrganizations,
+  useOrganizationsDeals,
+  usePrepareSignup,
+  useProjectTvl,
+  useSignup
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/hooks/useConfig.ts","../src/hooks/client.ts","../src/hooks/endpoints/useOrganizations.ts","../src/hooks/endpoints/useExists.ts","../src/hooks/endpoints/useOrganizationDeals.ts","../src/hooks/endpoints/useOrganizationsDeals.ts","../src/hooks/endpoints/usePrepareSignup.ts","../src/hooks/endpoints/useProjectTvl.ts","../src/hooks/endpoints/useSignup.ts","../src/hooks/endpoints/earn/useDeals.ts","../src/hooks/endpoints/earn/useRoute.ts","../src/hooks/endpoints/earn/useWalletBalances.ts"],"sourcesContent":["// Hooks\nexport * from \"./hooks/useConfig\";\nexport * from \"./hooks/client\";\n\n// Endpoint hooks\nexport * from \"./hooks/endpoints/useOrganizations\";\nexport * from \"./hooks/endpoints/useExists\";\nexport * from \"./hooks/endpoints/useOrganizationDeals\";\nexport * from \"./hooks/endpoints/useOrganizationsDeals\";\nexport * from \"./hooks/endpoints/usePrepareSignup\";\nexport * from \"./hooks/endpoints/useProjectTvl\";\nexport * from \"./hooks/endpoints/useSignup\";\n\n// Earn hooks\nexport * from \"./hooks/endpoints/earn\";\n","import type { Config } from \"@turtleclub/api\";\nimport { defaultConfig } from \"@turtleclub/api\";\n\nexport function useConfig(): Config {\n  // Placeholder implementation - in real app this would use TurtleProvider context\n  return defaultConfig;\n}\n","import { createSyncStoragePersister } from \"@tanstack/query-sync-storage-persister\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { persistQueryClient } from \"@tanstack/react-query-persist-client\";\n\nexport const defaultQueryClient = new QueryClient({\n  defaultOptions: {\n    queries: {\n      refetchOnWindowFocus: false,\n    },\n  },\n});\n\n// Only persist on client side\nif (typeof window !== 'undefined') {\n  const localStoragePersister = createSyncStoragePersister({\n    storage: window.localStorage,\n    key: \"turtle-sdk\",\n  });\n\n  persistQueryClient({\n    queryClient: defaultQueryClient,\n    persister: localStoragePersister,\n  });\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, organization, type OrganizationResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseOrganizationsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useOrganizations({\n  config,\n  queryClient,\n}: UseOrganizationsOptions = {}): UseQueryResult<OrganizationResponse | null> {\n  const defaultConfig = useConfig();\n\n  const query = useQuery(\n    {\n      queryKey: [\"organizations\"],\n      queryFn: async () => {\n        return await organization(config ?? defaultConfig);\n      },\n      staleTime: 2 * 60 * 1000,\n      refetchInterval: 1 * 60 * 1000,\n    },\n    queryClient ?? defaultQueryClient\n  );\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, exists, type ExistsOptions } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseExistsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useExists(\n  options?: ExistsOptions,\n  { config, queryClient }: UseExistsOptions = {},\n): UseQueryResult<boolean | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"exists\", options?.user],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await exists(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000,\n    refetchInterval: 1 * 60 * 1000,\n    refetchOnWindowFocus: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, organizationDeals, type OrganizationDealsOptions, type OrganizationDealsResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseOrganizationDealsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useOrganizationDeals(\n  options?: OrganizationDealsOptions,\n  { config, queryClient }: UseOrganizationDealsOptions = {},\n): UseQueryResult<OrganizationDealsResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"organizationDeals\", options?.organizationId],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await organizationDeals(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000,\n    refetchInterval: 1 * 60 * 1000,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, organizationsDeals, type OrganizationsDealsOptions, type OrganizationsDealsResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseOrganizationsDealsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useOrganizationsDeals(\n  options?: OrganizationsDealsOptions,\n  { config, queryClient }: UseOrganizationsDealsOptions = {},\n): UseQueryResult<OrganizationsDealsResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"organizationsDeals\", options?.organizationIds],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await organizationsDeals(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000,\n    refetchInterval: 1 * 60 * 1000,\n    throwOnError: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, prepareSignup, type PrepareSignupOptions, type PrepareSignupResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UsePrepareSignupOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function usePrepareSignup(\n  options?: PrepareSignupOptions,\n  { config, queryClient }: UsePrepareSignupOptions = {},\n): UseQueryResult<PrepareSignupResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"prepareSignup\", options?.user],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await prepareSignup(options, config ?? defaultConfig);\n    },\n    enabled,\n    refetchInterval: 5 * 60 * 1000,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, projectTvl, type ProjectTvlOptions, type ProjectTvlResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseProjectTvlOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useProjectTvl(\n  options?: ProjectTvlOptions,\n  { config, queryClient }: UseProjectTvlOptions = {},\n): UseQueryResult<ProjectTvlResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"projectTvl\", options?.projects],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await projectTvl(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 7 * 60 * 1000,\n    refetchInterval: 5 * 60 * 1000,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import {\n  type QueryClient,\n  useMutation,\n  type UseMutationResult,\n  useQuery,\n} from \"@tanstack/react-query\";\nimport { type Config, signup, type SignupOptions } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseSignupOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useSignup(\n  options?: Omit<SignupOptions, \"signature\">,\n  { config, queryClient }: UseSignupOptions = {}\n): UseMutationResult<boolean | null, Error, string, unknown> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const mutation = useMutation(\n    {\n      mutationFn: async (signature: string) => {\n        if (!enabled) return null;\n\n        return await signup({ ...options, signature }, config ?? defaultConfig);\n      },\n    },\n    queryClient ?? defaultQueryClient\n  );\n\n  return mutation;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, earnDeals, type EarnDealsOptions, type EarnDealsResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"@/hooks/client\";\nimport { useConfig } from \"@/hooks/useConfig\";\n\nexport interface UseEarnDealsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useEarnDeals(\n  options?: EarnDealsOptions,\n  { config, queryClient }: UseEarnDealsOptions = {},\n): UseQueryResult<EarnDealsResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\n      \"earn-deals\",\n      options?.campaignId,\n      options?.idFilter,\n      options?.protocolFilter,\n    ],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await earnDeals(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 60 * 1000,\n    refetchInterval: 30 * 1000,\n    refetchOnWindowFocus: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, earnRoute, type EarnRouteOptions, type EarnRouteResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../../client\";\nimport { useConfig } from \"../../useConfig\";\n\nexport interface UseEarnRouteOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useEarnRoute(\n  options?: EarnRouteOptions,\n  { config, queryClient }: UseEarnRouteOptions = {},\n): UseQueryResult<EarnRouteResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\n      \"earnRoute\",\n      options?.user,\n      options?.chain,\n      options?.slippage,\n      options?.tokenIn,\n      options?.tokenOut,\n      options?.amount,\n    ],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await earnRoute(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000, // 2 minutes - longer stale time for transaction stability\n    refetchInterval: false, // Disable automatic refetch to prevent transaction state reset\n    refetchOnWindowFocus: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport {\n  type Config,\n  earnWalletBalances,\n  type EarnWalletBalancesOptions,\n  type EarnWalletBalancesResponse,\n} from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../../client\";\nimport { useConfig } from \"../../useConfig\";\n\nexport interface UseEarnWalletBalancesOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useEarnWalletBalances(\n  options?: EarnWalletBalancesOptions,\n  { config, queryClient }: UseEarnWalletBalancesOptions = {}\n): UseQueryResult<EarnWalletBalancesResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery(\n    {\n      queryKey: [\"earnWalletBalances\", options?.chain, options?.user],\n      queryFn: async () => {\n        if (!enabled) return null;\n\n        return await earnWalletBalances(options, config ?? defaultConfig);\n      },\n      enabled,\n      staleTime: 30 * 1000,\n      refetchInterval: 15 * 1000,\n      refetchOnWindowFocus: true,\n    },\n    queryClient ?? defaultQueryClient\n  );\n\n  return query;\n}\n"],"mappings":"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","names":["import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig","import_react_query","import_api","defaultConfig"]}

package/dist/index.js

@@ -0,0 +1,267 @@
+// src/hooks/useConfig.ts
+import { defaultConfig } from "@turtleclub/api";
+function useConfig() {
+  return defaultConfig;
+}
+
+// src/hooks/client.ts
+import { createSyncStoragePersister } from "@tanstack/query-sync-storage-persister";
+import { QueryClient } from "@tanstack/react-query";
+import { persistQueryClient } from "@tanstack/react-query-persist-client";
+var defaultQueryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      refetchOnWindowFocus: false
+    }
+  }
+});
+if (typeof window !== "undefined") {
+  const localStoragePersister = createSyncStoragePersister({
+    storage: window.localStorage,
+    key: "turtle-sdk"
+  });
+  persistQueryClient({
+    queryClient: defaultQueryClient,
+    persister: localStoragePersister
+  });
+}
+
+// src/hooks/endpoints/useOrganizations.ts
+import { useQuery } from "@tanstack/react-query";
+import { organization } from "@turtleclub/api";
+function useOrganizations({
+  config,
+  queryClient
+} = {}) {
+  const defaultConfig2 = useConfig();
+  const query = useQuery(
+    {
+      queryKey: ["organizations"],
+      queryFn: async () => {
+        return await organization(config ?? defaultConfig2);
+      },
+      staleTime: 2 * 60 * 1e3,
+      refetchInterval: 1 * 60 * 1e3
+    },
+    queryClient ?? defaultQueryClient
+  );
+  return query;
+}
+
+// src/hooks/endpoints/useExists.ts
+import { useQuery as useQuery2 } from "@tanstack/react-query";
+import { exists } from "@turtleclub/api";
+function useExists(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery2({
+    queryKey: ["exists", options?.user],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await exists(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    refetchInterval: 1 * 60 * 1e3,
+    refetchOnWindowFocus: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useOrganizationDeals.ts
+import { useQuery as useQuery3 } from "@tanstack/react-query";
+import { organizationDeals } from "@turtleclub/api";
+function useOrganizationDeals(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery3({
+    queryKey: ["organizationDeals", options?.organizationId],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await organizationDeals(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    refetchInterval: 1 * 60 * 1e3
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useOrganizationsDeals.ts
+import { useQuery as useQuery4 } from "@tanstack/react-query";
+import { organizationsDeals } from "@turtleclub/api";
+function useOrganizationsDeals(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery4({
+    queryKey: ["organizationsDeals", options?.organizationIds],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await organizationsDeals(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    refetchInterval: 1 * 60 * 1e3,
+    throwOnError: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/usePrepareSignup.ts
+import { useQuery as useQuery5 } from "@tanstack/react-query";
+import { prepareSignup } from "@turtleclub/api";
+function usePrepareSignup(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery5({
+    queryKey: ["prepareSignup", options?.user],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await prepareSignup(options, config ?? defaultConfig2);
+    },
+    enabled,
+    refetchInterval: 5 * 60 * 1e3
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useProjectTvl.ts
+import { useQuery as useQuery6 } from "@tanstack/react-query";
+import { projectTvl } from "@turtleclub/api";
+function useProjectTvl(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery6({
+    queryKey: ["projectTvl", options?.projects],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await projectTvl(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 7 * 60 * 1e3,
+    refetchInterval: 5 * 60 * 1e3
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/useSignup.ts
+import {
+  useMutation
+} from "@tanstack/react-query";
+import { signup } from "@turtleclub/api";
+function useSignup(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const mutation = useMutation(
+    {
+      mutationFn: async (signature) => {
+        if (!enabled) return null;
+        return await signup({ ...options, signature }, config ?? defaultConfig2);
+      }
+    },
+    queryClient ?? defaultQueryClient
+  );
+  return mutation;
+}
+
+// src/hooks/endpoints/earn/useDeals.ts
+import { useQuery as useQuery8 } from "@tanstack/react-query";
+import { earnDeals } from "@turtleclub/api";
+function useEarnDeals(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery8({
+    queryKey: [
+      "earn-deals",
+      options?.campaignId,
+      options?.idFilter,
+      options?.protocolFilter
+    ],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await earnDeals(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 60 * 1e3,
+    refetchInterval: 30 * 1e3,
+    refetchOnWindowFocus: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/earn/useRoute.ts
+import { useQuery as useQuery9 } from "@tanstack/react-query";
+import { earnRoute } from "@turtleclub/api";
+function useEarnRoute(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery9({
+    queryKey: [
+      "earnRoute",
+      options?.user,
+      options?.chain,
+      options?.slippage,
+      options?.tokenIn,
+      options?.tokenOut,
+      options?.amount
+    ],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+      return await earnRoute(options, config ?? defaultConfig2);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1e3,
+    // 2 minutes - longer stale time for transaction stability
+    refetchInterval: false,
+    // Disable automatic refetch to prevent transaction state reset
+    refetchOnWindowFocus: true
+  }, queryClient ?? defaultQueryClient);
+  return query;
+}
+
+// src/hooks/endpoints/earn/useWalletBalances.ts
+import { useQuery as useQuery10 } from "@tanstack/react-query";
+import {
+  earnWalletBalances
+} from "@turtleclub/api";
+function useEarnWalletBalances(options, { config, queryClient } = {}) {
+  const defaultConfig2 = useConfig();
+  const enabled = options !== void 0;
+  const query = useQuery10(
+    {
+      queryKey: ["earnWalletBalances", options?.chain, options?.user],
+      queryFn: async () => {
+        if (!enabled) return null;
+        return await earnWalletBalances(options, config ?? defaultConfig2);
+      },
+      enabled,
+      staleTime: 30 * 1e3,
+      refetchInterval: 15 * 1e3,
+      refetchOnWindowFocus: true
+    },
+    queryClient ?? defaultQueryClient
+  );
+  return query;
+}
+export {
+  defaultQueryClient,
+  useConfig,
+  useEarnDeals,
+  useEarnRoute,
+  useEarnWalletBalances,
+  useExists,
+  useOrganizationDeals,
+  useOrganizations,
+  useOrganizationsDeals,
+  usePrepareSignup,
+  useProjectTvl,
+  useSignup
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/hooks/useConfig.ts","../src/hooks/client.ts","../src/hooks/endpoints/useOrganizations.ts","../src/hooks/endpoints/useExists.ts","../src/hooks/endpoints/useOrganizationDeals.ts","../src/hooks/endpoints/useOrganizationsDeals.ts","../src/hooks/endpoints/usePrepareSignup.ts","../src/hooks/endpoints/useProjectTvl.ts","../src/hooks/endpoints/useSignup.ts","../src/hooks/endpoints/earn/useDeals.ts","../src/hooks/endpoints/earn/useRoute.ts","../src/hooks/endpoints/earn/useWalletBalances.ts"],"sourcesContent":["import type { Config } from \"@turtleclub/api\";\nimport { defaultConfig } from \"@turtleclub/api\";\n\nexport function useConfig(): Config {\n  // Placeholder implementation - in real app this would use TurtleProvider context\n  return defaultConfig;\n}\n","import { createSyncStoragePersister } from \"@tanstack/query-sync-storage-persister\";\nimport { QueryClient } from \"@tanstack/react-query\";\nimport { persistQueryClient } from \"@tanstack/react-query-persist-client\";\n\nexport const defaultQueryClient = new QueryClient({\n  defaultOptions: {\n    queries: {\n      refetchOnWindowFocus: false,\n    },\n  },\n});\n\n// Only persist on client side\nif (typeof window !== 'undefined') {\n  const localStoragePersister = createSyncStoragePersister({\n    storage: window.localStorage,\n    key: \"turtle-sdk\",\n  });\n\n  persistQueryClient({\n    queryClient: defaultQueryClient,\n    persister: localStoragePersister,\n  });\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, organization, type OrganizationResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseOrganizationsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useOrganizations({\n  config,\n  queryClient,\n}: UseOrganizationsOptions = {}): UseQueryResult<OrganizationResponse | null> {\n  const defaultConfig = useConfig();\n\n  const query = useQuery(\n    {\n      queryKey: [\"organizations\"],\n      queryFn: async () => {\n        return await organization(config ?? defaultConfig);\n      },\n      staleTime: 2 * 60 * 1000,\n      refetchInterval: 1 * 60 * 1000,\n    },\n    queryClient ?? defaultQueryClient\n  );\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, exists, type ExistsOptions } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseExistsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useExists(\n  options?: ExistsOptions,\n  { config, queryClient }: UseExistsOptions = {},\n): UseQueryResult<boolean | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"exists\", options?.user],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await exists(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000,\n    refetchInterval: 1 * 60 * 1000,\n    refetchOnWindowFocus: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, organizationDeals, type OrganizationDealsOptions, type OrganizationDealsResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseOrganizationDealsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useOrganizationDeals(\n  options?: OrganizationDealsOptions,\n  { config, queryClient }: UseOrganizationDealsOptions = {},\n): UseQueryResult<OrganizationDealsResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"organizationDeals\", options?.organizationId],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await organizationDeals(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000,\n    refetchInterval: 1 * 60 * 1000,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, organizationsDeals, type OrganizationsDealsOptions, type OrganizationsDealsResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseOrganizationsDealsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useOrganizationsDeals(\n  options?: OrganizationsDealsOptions,\n  { config, queryClient }: UseOrganizationsDealsOptions = {},\n): UseQueryResult<OrganizationsDealsResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"organizationsDeals\", options?.organizationIds],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await organizationsDeals(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000,\n    refetchInterval: 1 * 60 * 1000,\n    throwOnError: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, prepareSignup, type PrepareSignupOptions, type PrepareSignupResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UsePrepareSignupOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function usePrepareSignup(\n  options?: PrepareSignupOptions,\n  { config, queryClient }: UsePrepareSignupOptions = {},\n): UseQueryResult<PrepareSignupResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"prepareSignup\", options?.user],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await prepareSignup(options, config ?? defaultConfig);\n    },\n    enabled,\n    refetchInterval: 5 * 60 * 1000,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, projectTvl, type ProjectTvlOptions, type ProjectTvlResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseProjectTvlOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useProjectTvl(\n  options?: ProjectTvlOptions,\n  { config, queryClient }: UseProjectTvlOptions = {},\n): UseQueryResult<ProjectTvlResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\"projectTvl\", options?.projects],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await projectTvl(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 7 * 60 * 1000,\n    refetchInterval: 5 * 60 * 1000,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import {\n  type QueryClient,\n  useMutation,\n  type UseMutationResult,\n  useQuery,\n} from \"@tanstack/react-query\";\nimport { type Config, signup, type SignupOptions } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../client\";\nimport { useConfig } from \"../useConfig\";\n\nexport interface UseSignupOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useSignup(\n  options?: Omit<SignupOptions, \"signature\">,\n  { config, queryClient }: UseSignupOptions = {}\n): UseMutationResult<boolean | null, Error, string, unknown> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const mutation = useMutation(\n    {\n      mutationFn: async (signature: string) => {\n        if (!enabled) return null;\n\n        return await signup({ ...options, signature }, config ?? defaultConfig);\n      },\n    },\n    queryClient ?? defaultQueryClient\n  );\n\n  return mutation;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, earnDeals, type EarnDealsOptions, type EarnDealsResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"@/hooks/client\";\nimport { useConfig } from \"@/hooks/useConfig\";\n\nexport interface UseEarnDealsOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useEarnDeals(\n  options?: EarnDealsOptions,\n  { config, queryClient }: UseEarnDealsOptions = {},\n): UseQueryResult<EarnDealsResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\n      \"earn-deals\",\n      options?.campaignId,\n      options?.idFilter,\n      options?.protocolFilter,\n    ],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await earnDeals(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 60 * 1000,\n    refetchInterval: 30 * 1000,\n    refetchOnWindowFocus: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport { type Config, earnRoute, type EarnRouteOptions, type EarnRouteResponse } from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../../client\";\nimport { useConfig } from \"../../useConfig\";\n\nexport interface UseEarnRouteOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useEarnRoute(\n  options?: EarnRouteOptions,\n  { config, queryClient }: UseEarnRouteOptions = {},\n): UseQueryResult<EarnRouteResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery({\n    queryKey: [\n      \"earnRoute\",\n      options?.user,\n      options?.chain,\n      options?.slippage,\n      options?.tokenIn,\n      options?.tokenOut,\n      options?.amount,\n    ],\n    queryFn: async () => {\n      if (!enabled)\n        return null;\n\n      return await earnRoute(options, config ?? defaultConfig);\n    },\n    enabled,\n    staleTime: 2 * 60 * 1000, // 2 minutes - longer stale time for transaction stability\n    refetchInterval: false, // Disable automatic refetch to prevent transaction state reset\n    refetchOnWindowFocus: true,\n  }, queryClient ?? defaultQueryClient);\n\n  return query;\n}\n","import { type QueryClient, useQuery, type UseQueryResult } from \"@tanstack/react-query\";\nimport {\n  type Config,\n  earnWalletBalances,\n  type EarnWalletBalancesOptions,\n  type EarnWalletBalancesResponse,\n} from \"@turtleclub/api\";\nimport { defaultQueryClient } from \"../../client\";\nimport { useConfig } from \"../../useConfig\";\n\nexport interface UseEarnWalletBalancesOptions {\n  config?: Config;\n  queryClient?: QueryClient;\n}\n\nexport function useEarnWalletBalances(\n  options?: EarnWalletBalancesOptions,\n  { config, queryClient }: UseEarnWalletBalancesOptions = {}\n): UseQueryResult<EarnWalletBalancesResponse | null> {\n  const defaultConfig = useConfig();\n  const enabled = options !== undefined;\n\n  const query = useQuery(\n    {\n      queryKey: [\"earnWalletBalances\", options?.chain, options?.user],\n      queryFn: async () => {\n        if (!enabled) return null;\n\n        return await earnWalletBalances(options, config ?? defaultConfig);\n      },\n      enabled,\n      staleTime: 30 * 1000,\n      refetchInterval: 15 * 1000,\n      refetchOnWindowFocus: true,\n    },\n    queryClient ?? defaultQueryClient\n  );\n\n  return query;\n}\n"],"mappings":"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","names":["defaultConfig","useQuery","defaultConfig","useQuery","useQuery","defaultConfig","useQuery","useQuery","defaultConfig","useQuery","useQuery","defaultConfig","useQuery","useQuery","defaultConfig","useQuery","defaultConfig","useQuery","defaultConfig","useQuery","useQuery","defaultConfig","useQuery","useQuery","defaultConfig","useQuery"]}

package/package.json

@@ -0,0 +1,51 @@
+{
+   "name": "@turtleclub/hooks",
+   "type": "module",
+   "version": "0.0.1",
+   "license": "MIT",
+   "exports": {
+      ".": {
+         "import": "./dist/index.js",
+         "require": "./dist/index.cjs",
+         "types": "./src/index.ts"
+      }
+   },
+   "main": "dist/index.cjs",
+   "module": "dist/index.js",
+   "types": "src/index.ts",
+   "source": "src/index.ts",
+   "files": [
+      "dist",
+      "src"
+   ],
+   "scripts": {
+      "build": "tsup",
+      "dev:widget": "tsup --watch",
+      "dev": "tsup --watch",
+      "lint": "eslint . --max-warnings 0",
+      "type-check": "tsc --noEmit"
+   },
+   "dependencies": {
+      "@tanstack/query-sync-storage-persister": "^5.55.3",
+      "@tanstack/react-query": "^5.55.3",
+      "@tanstack/react-query-persist-client": "^5.55.3",
+      "@turtleclub/api": "workspace:*",
+      "@turtleclub/chains": "workspace:*",
+      "@turtleclub/utils": "workspace:*",
+      "@wagmi/core": "^2.17.2",
+      "react": "^19.1.0",
+      "wagmi": "^2.15.4",
+      "zod": "^3.25.17"
+   },
+   "devDependencies": {
+      "@types/react": "^19.1.5",
+      "tsup": "^8.5.0",
+      "typescript": "^5.8.3"
+   },
+   "peerDependencies": {
+      "react": ">=18.0.0"
+   },
+   "publishConfig": {
+      "access": "public"
+   }
+}

package/src/hooks/client.ts

@@ -0,0 +1,24 @@
+import { createSyncStoragePersister } from "@tanstack/query-sync-storage-persister";
+import { QueryClient } from "@tanstack/react-query";
+import { persistQueryClient } from "@tanstack/react-query-persist-client";
+
+export const defaultQueryClient = new QueryClient({
+  defaultOptions: {
+    queries: {
+      refetchOnWindowFocus: false,
+    },
+  },
+});
+
+// Only persist on client side
+if (typeof window !== 'undefined') {
+  const localStoragePersister = createSyncStoragePersister({
+    storage: window.localStorage,
+    key: "turtle-sdk",
+  });
+
+  persistQueryClient({
+    queryClient: defaultQueryClient,
+    persister: localStoragePersister,
+  });
+}

package/src/hooks/endpoints/earn/index.ts

@@ -0,0 +1,3 @@
+export * from "./useDeals";
+export * from "./useRoute";
+export * from "./useWalletBalances";

package/src/hooks/endpoints/earn/useDeals.ts

@@ -0,0 +1,38 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, earnDeals, type EarnDealsOptions, type EarnDealsResponse } from "@turtleclub/api";
+import { defaultQueryClient } from "@/hooks/client";
+import { useConfig } from "@/hooks/useConfig";
+
+export interface UseEarnDealsOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useEarnDeals(
+  options?: EarnDealsOptions,
+  { config, queryClient }: UseEarnDealsOptions = {},
+): UseQueryResult<EarnDealsResponse | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery({
+    queryKey: [
+      "earn-deals",
+      options?.campaignId,
+      options?.idFilter,
+      options?.protocolFilter,
+    ],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+
+      return await earnDeals(options, config ?? defaultConfig);
+    },
+    enabled,
+    staleTime: 60 * 1000,
+    refetchInterval: 30 * 1000,
+    refetchOnWindowFocus: true,
+  }, queryClient ?? defaultQueryClient);
+
+  return query;
+}

package/src/hooks/endpoints/earn/useRoute.ts

@@ -0,0 +1,41 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, earnRoute, type EarnRouteOptions, type EarnRouteResponse } from "@turtleclub/api";
+import { defaultQueryClient } from "../../client";
+import { useConfig } from "../../useConfig";
+
+export interface UseEarnRouteOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useEarnRoute(
+  options?: EarnRouteOptions,
+  { config, queryClient }: UseEarnRouteOptions = {},
+): UseQueryResult<EarnRouteResponse | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery({
+    queryKey: [
+      "earnRoute",
+      options?.user,
+      options?.chain,
+      options?.slippage,
+      options?.tokenIn,
+      options?.tokenOut,
+      options?.amount,
+    ],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+
+      return await earnRoute(options, config ?? defaultConfig);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1000, // 2 minutes - longer stale time for transaction stability
+    refetchInterval: false, // Disable automatic refetch to prevent transaction state reset
+    refetchOnWindowFocus: true,
+  }, queryClient ?? defaultQueryClient);
+
+  return query;
+}

package/src/hooks/endpoints/earn/useWalletBalances.ts

@@ -0,0 +1,40 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import {
+  type Config,
+  earnWalletBalances,
+  type EarnWalletBalancesOptions,
+  type EarnWalletBalancesResponse,
+} from "@turtleclub/api";
+import { defaultQueryClient } from "../../client";
+import { useConfig } from "../../useConfig";
+
+export interface UseEarnWalletBalancesOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useEarnWalletBalances(
+  options?: EarnWalletBalancesOptions,
+  { config, queryClient }: UseEarnWalletBalancesOptions = {}
+): UseQueryResult<EarnWalletBalancesResponse | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery(
+    {
+      queryKey: ["earnWalletBalances", options?.chain, options?.user],
+      queryFn: async () => {
+        if (!enabled) return null;
+
+        return await earnWalletBalances(options, config ?? defaultConfig);
+      },
+      enabled,
+      staleTime: 30 * 1000,
+      refetchInterval: 15 * 1000,
+      refetchOnWindowFocus: true,
+    },
+    queryClient ?? defaultQueryClient
+  );
+
+  return query;
+}

package/src/hooks/endpoints/index.ts

@@ -0,0 +1,8 @@
+export * from "./earn";
+export * from "./useExists";
+export * from "./useOrganizationDeals";
+export * from "./useOrganizations";
+export * from "./useOrganizationsDeals";
+export * from "./usePrepareSignup";
+export * from "./useProjectTvl";
+export * from "./useSignup";

package/src/hooks/endpoints/useExists.ts

@@ -0,0 +1,33 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, exists, type ExistsOptions } from "@turtleclub/api";
+import { defaultQueryClient } from "../client";
+import { useConfig } from "../useConfig";
+
+export interface UseExistsOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useExists(
+  options?: ExistsOptions,
+  { config, queryClient }: UseExistsOptions = {},
+): UseQueryResult<boolean | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery({
+    queryKey: ["exists", options?.user],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+
+      return await exists(options, config ?? defaultConfig);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1000,
+    refetchInterval: 1 * 60 * 1000,
+    refetchOnWindowFocus: true,
+  }, queryClient ?? defaultQueryClient);
+
+  return query;
+}

package/src/hooks/endpoints/useOrganizationDeals.ts

@@ -0,0 +1,32 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, organizationDeals, type OrganizationDealsOptions, type OrganizationDealsResponse } from "@turtleclub/api";
+import { defaultQueryClient } from "../client";
+import { useConfig } from "../useConfig";
+
+export interface UseOrganizationDealsOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useOrganizationDeals(
+  options?: OrganizationDealsOptions,
+  { config, queryClient }: UseOrganizationDealsOptions = {},
+): UseQueryResult<OrganizationDealsResponse | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery({
+    queryKey: ["organizationDeals", options?.organizationId],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+
+      return await organizationDeals(options, config ?? defaultConfig);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1000,
+    refetchInterval: 1 * 60 * 1000,
+  }, queryClient ?? defaultQueryClient);
+
+  return query;
+}

package/src/hooks/endpoints/useOrganizations.ts

@@ -0,0 +1,30 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, organization, type OrganizationResponse } from "@turtleclub/api";
+import { defaultQueryClient } from "../client";
+import { useConfig } from "../useConfig";
+
+export interface UseOrganizationsOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useOrganizations({
+  config,
+  queryClient,
+}: UseOrganizationsOptions = {}): UseQueryResult<OrganizationResponse | null> {
+  const defaultConfig = useConfig();
+
+  const query = useQuery(
+    {
+      queryKey: ["organizations"],
+      queryFn: async () => {
+        return await organization(config ?? defaultConfig);
+      },
+      staleTime: 2 * 60 * 1000,
+      refetchInterval: 1 * 60 * 1000,
+    },
+    queryClient ?? defaultQueryClient
+  );
+
+  return query;
+}

package/src/hooks/endpoints/useOrganizationsDeals.ts

@@ -0,0 +1,33 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, organizationsDeals, type OrganizationsDealsOptions, type OrganizationsDealsResponse } from "@turtleclub/api";
+import { defaultQueryClient } from "../client";
+import { useConfig } from "../useConfig";
+
+export interface UseOrganizationsDealsOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useOrganizationsDeals(
+  options?: OrganizationsDealsOptions,
+  { config, queryClient }: UseOrganizationsDealsOptions = {},
+): UseQueryResult<OrganizationsDealsResponse | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery({
+    queryKey: ["organizationsDeals", options?.organizationIds],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+
+      return await organizationsDeals(options, config ?? defaultConfig);
+    },
+    enabled,
+    staleTime: 2 * 60 * 1000,
+    refetchInterval: 1 * 60 * 1000,
+    throwOnError: true,
+  }, queryClient ?? defaultQueryClient);
+
+  return query;
+}

package/src/hooks/endpoints/usePrepareSignup.ts

@@ -0,0 +1,31 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, prepareSignup, type PrepareSignupOptions, type PrepareSignupResponse } from "@turtleclub/api";
+import { defaultQueryClient } from "../client";
+import { useConfig } from "../useConfig";
+
+export interface UsePrepareSignupOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function usePrepareSignup(
+  options?: PrepareSignupOptions,
+  { config, queryClient }: UsePrepareSignupOptions = {},
+): UseQueryResult<PrepareSignupResponse | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery({
+    queryKey: ["prepareSignup", options?.user],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+
+      return await prepareSignup(options, config ?? defaultConfig);
+    },
+    enabled,
+    refetchInterval: 5 * 60 * 1000,
+  }, queryClient ?? defaultQueryClient);
+
+  return query;
+}

package/src/hooks/endpoints/useProjectTvl.ts

@@ -0,0 +1,32 @@
+import { type QueryClient, useQuery, type UseQueryResult } from "@tanstack/react-query";
+import { type Config, projectTvl, type ProjectTvlOptions, type ProjectTvlResponse } from "@turtleclub/api";
+import { defaultQueryClient } from "../client";
+import { useConfig } from "../useConfig";
+
+export interface UseProjectTvlOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useProjectTvl(
+  options?: ProjectTvlOptions,
+  { config, queryClient }: UseProjectTvlOptions = {},
+): UseQueryResult<ProjectTvlResponse | null> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const query = useQuery({
+    queryKey: ["projectTvl", options?.projects],
+    queryFn: async () => {
+      if (!enabled)
+        return null;
+
+      return await projectTvl(options, config ?? defaultConfig);
+    },
+    enabled,
+    staleTime: 7 * 60 * 1000,
+    refetchInterval: 5 * 60 * 1000,
+  }, queryClient ?? defaultQueryClient);
+
+  return query;
+}

package/src/hooks/endpoints/useSignup.ts

@@ -0,0 +1,35 @@
+import {
+  type QueryClient,
+  useMutation,
+  type UseMutationResult,
+  useQuery,
+} from "@tanstack/react-query";
+import { type Config, signup, type SignupOptions } from "@turtleclub/api";
+import { defaultQueryClient } from "../client";
+import { useConfig } from "../useConfig";
+
+export interface UseSignupOptions {
+  config?: Config;
+  queryClient?: QueryClient;
+}
+
+export function useSignup(
+  options?: Omit<SignupOptions, "signature">,
+  { config, queryClient }: UseSignupOptions = {}
+): UseMutationResult<boolean | null, Error, string, unknown> {
+  const defaultConfig = useConfig();
+  const enabled = options !== undefined;
+
+  const mutation = useMutation(
+    {
+      mutationFn: async (signature: string) => {
+        if (!enabled) return null;
+
+        return await signup({ ...options, signature }, config ?? defaultConfig);
+      },
+    },
+    queryClient ?? defaultQueryClient
+  );
+
+  return mutation;
+}

package/src/hooks/index.ts

@@ -0,0 +1,2 @@
+export * from "./endpoints";
+export * from "./useConfig";

package/src/hooks/useConfig.ts

@@ -0,0 +1,7 @@
+import type { Config } from "@turtleclub/api";
+import { defaultConfig } from "@turtleclub/api";
+
+export function useConfig(): Config {
+  // Placeholder implementation - in real app this would use TurtleProvider context
+  return defaultConfig;
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+// Hooks
+export * from "./hooks/useConfig";
+export * from "./hooks/client";
+
+// Endpoint hooks
+export * from "./hooks/endpoints/useOrganizations";
+export * from "./hooks/endpoints/useExists";
+export * from "./hooks/endpoints/useOrganizationDeals";
+export * from "./hooks/endpoints/useOrganizationsDeals";
+export * from "./hooks/endpoints/usePrepareSignup";
+export * from "./hooks/endpoints/useProjectTvl";
+export * from "./hooks/endpoints/useSignup";
+
+// Earn hooks
+export * from "./hooks/endpoints/earn";