@dimes-dot-fi/sdk 1.0.0

package/dist/react/index.mjs

@@ -0,0 +1,166 @@
+import {
+  executeQuote
+} from "../chunk-BRANC7OH.mjs";
+import {
+  DimesError
+} from "../chunk-LQ5LLBR6.mjs";
+
+// src/react/provider.tsx
+import { createContext, useContext } from "react";
+import { jsx } from "react/jsx-runtime";
+var DimesContext = createContext(null);
+function DimesProvider({ client, children }) {
+  return /* @__PURE__ */ jsx(DimesContext.Provider, { value: client, children });
+}
+function useDimesClient() {
+  const client = useContext(DimesContext);
+  if (!client) {
+    throw new DimesError("missing_provider", "useDimesClient must be used within a <DimesProvider>");
+  }
+  return client;
+}
+
+// src/react/use-quote.ts
+import { useCallback, useReducer } from "react";
+function reducer(state, action) {
+  switch (action.type) {
+    case "loading":
+      return { phase: "loading-draft", corrections: [], retries: 0 };
+    case "draftReady":
+      return { ...state, phase: "draft-ready", draft: action.draft };
+    case "promoting":
+      return { ...state, phase: "promoting" };
+    case "marketMoved":
+      return { ...state, phase: "market-moved" };
+    case "done":
+      return {
+        phase: "promoted",
+        offer: action.result.offer,
+        corrections: action.result.corrections,
+        retries: action.result.retries,
+        draft: state.draft
+      };
+    case "error":
+      return { ...state, phase: "error", error: action.error };
+    case "reset":
+      return { phase: "idle", corrections: [], retries: 0 };
+    default:
+      return state;
+  }
+}
+function useQuote() {
+  const client = useDimesClient();
+  const [state, dispatch] = useReducer(reducer, {
+    phase: "idle",
+    corrections: [],
+    retries: 0
+  });
+  const execute = useCallback(
+    async (params, options) => {
+      dispatch({ type: "loading" });
+      try {
+        const result = await executeQuote(client, params, {
+          ...options,
+          onDraftReady: (draft) => {
+            dispatch({ type: "draftReady", draft });
+            dispatch({ type: "promoting" });
+            options?.onDraftReady?.(draft);
+          },
+          onMarketMoved: (event) => {
+            dispatch({ type: "marketMoved" });
+            return options?.onMarketMoved?.(event);
+          },
+          onCorrection: (adj) => {
+            return options?.onCorrection?.(adj);
+          }
+        });
+        dispatch({ type: "done", result });
+        return result;
+      } catch (err) {
+        dispatch({ type: "error", error: err });
+        throw err;
+      }
+    },
+    [client]
+  );
+  const reset = useCallback(() => {
+    dispatch({ type: "reset" });
+  }, []);
+  return { state, execute, reset };
+}
+
+// src/react/use-markets.ts
+import { useQuery } from "@tanstack/react-query";
+function useMarkets(params, queryOptions) {
+  const client = useDimesClient();
+  return useQuery({
+    queryKey: ["dimes", "markets", params],
+    queryFn: () => client.getMarkets(params),
+    ...queryOptions
+  });
+}
+function useMarket(ticker, queryOptions) {
+  const client = useDimesClient();
+  return useQuery({
+    queryKey: ["dimes", "market", ticker],
+    queryFn: () => client.getMarket(ticker),
+    enabled: !!ticker,
+    ...queryOptions
+  });
+}
+
+// src/react/use-positions.ts
+import { useQuery as useQuery2 } from "@tanstack/react-query";
+function usePositions(params, queryOptions) {
+  const client = useDimesClient();
+  return useQuery2({
+    queryKey: ["dimes", "positions", params],
+    queryFn: () => client.getPositions(params),
+    ...queryOptions
+  });
+}
+
+// src/react/use-contract-info.ts
+import { useQuery as useQuery3 } from "@tanstack/react-query";
+function useContractInfo(queryOptions) {
+  const client = useDimesClient();
+  return useQuery3({
+    queryKey: ["dimes", "contractInfo"],
+    queryFn: () => client.getContractInfo(),
+    staleTime: Infinity,
+    ...queryOptions
+  });
+}
+
+// src/react/use-limits.ts
+import { useQuery as useQuery4 } from "@tanstack/react-query";
+function useLimits(queryOptions) {
+  const client = useDimesClient();
+  return useQuery4({
+    queryKey: ["dimes", "limits"],
+    queryFn: () => client.getLimits(),
+    ...queryOptions
+  });
+}
+
+// src/react/use-cancel-position.ts
+import { useMutation } from "@tanstack/react-query";
+function useCancelPosition(mutationOptions) {
+  const client = useDimesClient();
+  return useMutation({
+    mutationFn: (positionId) => client.cancelPosition(positionId),
+    ...mutationOptions
+  });
+}
+export {
+  DimesProvider,
+  useCancelPosition,
+  useContractInfo,
+  useDimesClient,
+  useLimits,
+  useMarket,
+  useMarkets,
+  usePositions,
+  useQuote
+};
+//# sourceMappingURL=index.mjs.map

package/dist/react/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/react/provider.tsx","../../src/react/use-quote.ts","../../src/react/use-markets.ts","../../src/react/use-positions.ts","../../src/react/use-contract-info.ts","../../src/react/use-limits.ts","../../src/react/use-cancel-position.ts"],"sourcesContent":["import { createContext, useContext, type ReactNode } from \"react\";\nimport type { DimesClient } from \"../client/dimes-client\";\nimport { DimesError } from \"../errors/dimes-error\";\n\n// eslint-disable-next-line @typescript-eslint/naming-convention\nconst DimesContext = createContext<DimesClient | null>(null);\n\nexport interface DimesProviderProps {\n  client: DimesClient;\n  children: ReactNode;\n}\n\n// eslint-disable-next-line @typescript-eslint/naming-convention, @typescript-eslint/explicit-function-return-type\nexport function DimesProvider({ client, children }: DimesProviderProps) {\n  return <DimesContext.Provider value={client}>{children}</DimesContext.Provider>;\n}\n\nexport function useDimesClient(): DimesClient {\n  const client = useContext(DimesContext);\n  if (!client) {\n    throw new DimesError(\"missing_provider\", \"useDimesClient must be used within a <DimesProvider>\");\n  }\n  return client;\n}\n","import { useCallback, useReducer } from \"react\";\nimport { executeQuote } from \"../quote/quote\";\nimport type { HintAdjustment } from \"../quote/quote-error-hints\";\nimport type { Offer } from \"../types\";\nimport type { QuoteOptions, QuoteParams, QuoteResult } from \"../types/quote\";\nimport { useDimesClient } from \"./provider\";\n\nexport type QuotePhase = \"idle\" | \"loading-draft\" | \"draft-ready\" | \"promoting\" | \"promoted\" | \"market-moved\" | \"error\";\n\nexport interface QuoteState {\n  phase: QuotePhase;\n  draft?: Offer;\n  offer?: Offer;\n  corrections: HintAdjustment[];\n  retries: number;\n  error?: unknown;\n}\n\ntype Action =\n  | { type: \"loading\" }\n  | { type: \"draftReady\"; draft: Offer }\n  | { type: \"promoting\" }\n  | { type: \"marketMoved\" }\n  | { type: \"done\"; result: QuoteResult }\n  | { type: \"error\"; error: unknown }\n  | { type: \"reset\" };\n\nfunction reducer(state: QuoteState, action: Action): QuoteState {\n  switch (action.type) {\n    case \"loading\":\n      return { phase: \"loading-draft\", corrections: [], retries: 0 };\n    case \"draftReady\":\n      return { ...state, phase: \"draft-ready\", draft: action.draft };\n    case \"promoting\":\n      return { ...state, phase: \"promoting\" };\n    case \"marketMoved\":\n      return { ...state, phase: \"market-moved\" };\n    case \"done\":\n      return {\n        phase: \"promoted\",\n        offer: action.result.offer,\n        corrections: action.result.corrections,\n        retries: action.result.retries,\n        draft: state.draft,\n      };\n    case \"error\":\n      return { ...state, phase: \"error\", error: action.error };\n    case \"reset\":\n      return { phase: \"idle\", corrections: [], retries: 0 };\n    default:\n      return state;\n  }\n}\n\nexport interface UseQuoteReturn {\n  state: QuoteState;\n  execute: (params: QuoteParams, options?: QuoteOptions) => Promise<QuoteResult>;\n  reset: () => void;\n}\n\nexport function useQuote(): UseQuoteReturn {\n  const client = useDimesClient();\n  const [state, dispatch] = useReducer(reducer, {\n    phase: \"idle\",\n    corrections: [],\n    retries: 0,\n  });\n\n  const execute = useCallback(\n    async (params: QuoteParams, options?: QuoteOptions): Promise<QuoteResult> => {\n      dispatch({ type: \"loading\" });\n\n      try {\n        const result = await executeQuote(client, params, {\n          ...options,\n          onDraftReady: (draft) => {\n            dispatch({ type: \"draftReady\", draft });\n            dispatch({ type: \"promoting\" });\n            options?.onDraftReady?.(draft);\n          },\n          onMarketMoved: (event) => {\n            dispatch({ type: \"marketMoved\" });\n            return options?.onMarketMoved?.(event);\n          },\n          onCorrection: (adj) => {\n            return options?.onCorrection?.(adj);\n          },\n        });\n\n        dispatch({ type: \"done\", result });\n        return result;\n      } catch (err) {\n        dispatch({ type: \"error\", error: err });\n        throw err;\n      }\n    },\n    [client],\n  );\n\n  const reset = useCallback(() => {\n    dispatch({ type: \"reset\" });\n  }, []);\n\n  return { state, execute, reset };\n}\n","import { useQuery, type UseQueryOptions, type UseQueryResult } from \"@tanstack/react-query\";\nimport type { GetMarketsParams } from \"../client/dimes-client\";\nimport type { Market, Paginated } from \"../types\";\nimport { useDimesClient } from \"./provider\";\n\nexport function useMarkets(\n  params?: GetMarketsParams,\n  queryOptions?: Partial<UseQueryOptions<Paginated<Market>>>,\n): UseQueryResult<Paginated<Market>> {\n  const client = useDimesClient();\n\n  return useQuery({\n    queryKey: [\"dimes\", \"markets\", params],\n    queryFn: () => client.getMarkets(params),\n    ...queryOptions,\n  });\n}\n\nexport function useMarket(ticker: string, queryOptions?: Partial<UseQueryOptions<Market>>): UseQueryResult<Market> {\n  const client = useDimesClient();\n\n  return useQuery({\n    queryKey: [\"dimes\", \"market\", ticker],\n    queryFn: () => client.getMarket(ticker),\n    enabled: !!ticker,\n    ...queryOptions,\n  });\n}\n","import { useQuery, type UseQueryOptions, type UseQueryResult } from \"@tanstack/react-query\";\nimport type { GetPositionsParams } from \"../client/dimes-client\";\nimport type { Position } from \"../types\";\nimport { useDimesClient } from \"./provider\";\n\nexport function usePositions(\n  params?: GetPositionsParams,\n  queryOptions?: Partial<UseQueryOptions<Position[]>>,\n): UseQueryResult<Position[]> {\n  const client = useDimesClient();\n\n  return useQuery({\n    queryKey: [\"dimes\", \"positions\", params],\n    queryFn: () => client.getPositions(params),\n    ...queryOptions,\n  });\n}\n","import { useQuery, type UseQueryOptions, type UseQueryResult } from \"@tanstack/react-query\";\nimport type { ContractInfo } from \"../types\";\nimport { useDimesClient } from \"./provider\";\n\nexport function useContractInfo(queryOptions?: Partial<UseQueryOptions<ContractInfo>>): UseQueryResult<ContractInfo> {\n  const client = useDimesClient();\n\n  return useQuery({\n    queryKey: [\"dimes\", \"contractInfo\"],\n    queryFn: () => client.getContractInfo(),\n    staleTime: Infinity,\n    ...queryOptions,\n  });\n}\n","import { useQuery, type UseQueryOptions, type UseQueryResult } from \"@tanstack/react-query\";\nimport type { CustomerLimit } from \"../types\";\nimport { useDimesClient } from \"./provider\";\n\nexport function useLimits(queryOptions?: Partial<UseQueryOptions<CustomerLimit>>): UseQueryResult<CustomerLimit> {\n  const client = useDimesClient();\n\n  return useQuery({\n    queryKey: [\"dimes\", \"limits\"],\n    queryFn: () => client.getLimits(),\n    ...queryOptions,\n  });\n}\n","import { useMutation, type UseMutationOptions, type UseMutationResult } from \"@tanstack/react-query\";\nimport { useDimesClient } from \"./provider\";\n\nexport function useCancelPosition(\n  mutationOptions?: Partial<UseMutationOptions<void, Error, string>>,\n): UseMutationResult<void, Error, string> {\n  const client = useDimesClient();\n\n  return useMutation({\n    mutationFn: (positionId: string) => client.cancelPosition(positionId),\n    ...mutationOptions,\n  });\n}\n"],"mappings":"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","names":["useQuery","useQuery","useQuery","useQuery","useQuery","useQuery"]}

package/package.json

@@ -0,0 +1,111 @@
+{
+  "name": "@dimes-dot-fi/sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for the Dimes prediction market API",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react/index.d.mts",
+        "default": "./dist/react/index.mjs"
+      },
+      "require": {
+        "types": "./dist/react/index.d.cts",
+        "default": "./dist/react/index.cjs"
+      }
+    },
+    "./contract": {
+      "import": {
+        "types": "./dist/contract/index.d.mts",
+        "default": "./dist/contract/index.mjs"
+      },
+      "require": {
+        "types": "./dist/contract/index.d.cts",
+        "default": "./dist/contract/index.cjs"
+      }
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "generate:types": "tsx scripts/generate-types.ts",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src tests && prettier --check src tests scripts",
+    "lint:fix": "eslint --fix src tests && prettier --write src tests scripts",
+    "format": "prettier --write src tests scripts",
+    "format:check": "prettier --check src tests scripts",
+    "knip": "knip",
+    "prepublishOnly": "pnpm lint && pnpm typecheck && pnpm test && pnpm build",
+    "release": "pnpm version patch && npm publish --access public",
+    "release:minor": "pnpm version minor && npm publish --access public",
+    "release:major": "pnpm version major && npm publish --access public"
+  },
+  "peerDependencies": {
+    "@tanstack/react-query": ">=5",
+    "react": ">=19",
+    "viem": ">=2"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/react-query": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.0",
+    "@eslint/eslintrc": "^3.3.0",
+    "@eslint/js": "^10.0.0",
+    "@tanstack/react-query": "^5.0.0",
+    "@types/humps": "^2.0.6",
+    "@types/react": "^19.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.0.0",
+    "@typescript-eslint/parser": "^8.0.0",
+    "eslint": "^9.0.0",
+    "eslint-config-prettier": "^10.0.0",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-better-max-params": "^1.0.0",
+    "eslint-plugin-check-file": "^2.0.0",
+    "eslint-plugin-import-x": "^4.0.0",
+    "eslint-plugin-simple-import-sort": "^12.0.0",
+    "globals": "^17.0.0",
+    "knip": "^6.4.0",
+    "openapi-typescript": "^7.0.0",
+    "prettier": "^3.8.0",
+    "react": "^19.0.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.8.0",
+    "viem": "^2.0.0",
+    "vitest": "^4.1.5"
+  },
+  "dependencies": {
+    "humps": "^2.0.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": ["esbuild", "unrs-resolver"]
+  }
+}