@uncover/sdk 0.1.0

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@uncover/sdk",
+  "version": "0.1.0",
+  "description": "JavaScript SDK for Uncover API",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "keywords": ["uncover", "api", "sdk"],
+  "author": "",
+  "license": "MIT",
+  "devDependencies": {
+    "@types/node": "^20.10.6",
+    "typescript": "^5.3.3"
+  }
+}

package/src/client.ts

@@ -0,0 +1,75 @@
+import type { SearchRequest, SearchResponse, SearchStatusResponse } from "./types.js";
+
+export class Uncover {
+  private apiKey: string;
+  private baseUrl: string;
+
+  constructor(apiKey: string, baseUrl: string = "https://api.uncover.dev") {
+    this.apiKey = apiKey;
+    this.baseUrl = baseUrl;
+  }
+
+  /**
+   * Search for problems mentioned on Reddit/Twitter about a topic
+   */
+  async search(request: SearchRequest): Promise<SearchResponse> {
+    const response = await fetch(`${this.baseUrl}/api/search`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${this.apiKey}`,
+      },
+      body: JSON.stringify(request),
+    });
+
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(`Search failed: ${error.error || "Unknown error"}`);
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Get the status and results of a search request
+   */
+  async getSearchStatus(requestId: string): Promise<SearchStatusResponse> {
+    const response = await fetch(`${this.baseUrl}/api/search/${requestId}`, {
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`,
+      },
+    });
+
+    if (!response.ok) {
+      const error = await response.json();
+      throw new Error(`Failed to get status: ${error.error || "Unknown error"}`);
+    }
+
+    return response.json();
+  }
+
+  /**
+   * Poll for search completion with timeout
+   */
+  async waitForSearch(
+    requestId: string,
+    timeoutMs: number = 30000,
+    pollIntervalMs: number = 1000
+  ): Promise<SearchStatusResponse> {
+    const startTime = Date.now();
+
+    while (Date.now() - startTime < timeoutMs) {
+      const status = await this.getSearchStatus(requestId);
+
+      if (status.status === "completed" || status.status === "failed") {
+        return status;
+      }
+
+      await new Promise((resolve) => setTimeout(resolve, pollIntervalMs));
+    }
+
+    throw new Error("Search request timed out");
+  }
+}
+
+export default Uncover;

package/src/index.ts

@@ -0,0 +1,10 @@
+export { Uncover, default } from "./client.js";
+export type {
+  SearchRequest,
+  SearchResponse,
+  SearchStatusResponse,
+  Problem,
+  Source,
+  SignupResponse,
+  SigninResponse,
+} from "./types.js";

package/src/types.ts

@@ -0,0 +1,61 @@
+export type Source = "reddit" | "twitter";
+
+export interface SearchRequest {
+  query: string;
+  sources: Source[];
+  limit?: number;
+}
+
+export interface Problem {
+  text: string;
+  frequency: number;
+  sentiment: string;
+}
+
+export interface SearchResponse {
+  requestId: string;
+  status: "pending" | "processing" | "completed" | "failed";
+  query: string;
+  sources: Source[];
+  problems?: Problem[];
+  summary?: string;
+  trends?: string[];
+  cost?: number;
+}
+
+export interface SearchStatusResponse {
+  requestId: string;
+  status: "pending" | "processing" | "completed" | "failed";
+  query: string;
+  sources: Source[];
+  problems?: Problem[];
+  summary?: string;
+  trends?: string[];
+  createdAt: string;
+}
+
+export interface SignupResponse {
+  user: {
+    id: string;
+    email: string;
+    name?: string;
+  };
+  apiKey: {
+    id: string;
+    key: string;
+    name: string;
+  };
+}
+
+export interface SigninResponse {
+  user: {
+    id: string;
+    email: string;
+    name?: string;
+  };
+  apiKeys: Array<{
+    id: string;
+    name: string;
+    createdAt: string;
+  }>;
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "moduleResolution": "node",
+    "target": "ES2020",
+    "module": "ES2020"
+  },
+  "include": ["src"],
+  "exclude": ["node_modules"]
+}