@mrclrchtr/supi-web 1.12.0 → 1.12.1

package/README.md

@@ -97,6 +97,6 @@ Skip step 1 if you already know the exact Context7 `library_id`.
 
 ## Context7 API key
 
-`web_docs_search` and `web_docs_fetch` use [Context7](https://context7.com/) through `@upstash/context7-sdk`.
+`web_docs_search` and `web_docs_fetch` call the [Context7 REST API](https://context7.com/) directly.
 
-If `CONTEXT7_API_KEY` is set in your environment, the SDK uses it automatically for higher rate limits. Without a key, the tools still work with lower defaults.
+Set `CONTEXT7_API_KEY` in your environment to authenticate with the Context7 API. Without a key, the tools will return an authentication error when called. Get a free API key at https://context7.com/dashboard.

package/node_modules/@mrclrchtr/supi-core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-core",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "SuPi core — shared infrastructure for SuPi extensions (XML context tags, config system)",
   "license": "MIT",
   "repository": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrclrchtr/supi-web",
-  "version": "1.12.0",
+  "version": "1.12.1",
   "description": "SuPi Web extension — fetch web pages as clean Markdown (web_fetch_md) and library docs via Context7 (web_docs_search, web_docs_fetch)",
   "license": "MIT",
   "repository": {
@@ -20,12 +20,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@upstash/context7-sdk": "^0.3.0",
     "jsdom": "^29.0.0",
     "@mozilla/readability": "^0.6.0",
     "turndown": "^7.2.0",
     "turndown-plugin-gfm": "^1.0.2",
-    "@mrclrchtr/supi-core": "1.12.0"
+    "@mrclrchtr/supi-core": "1.12.1"
   },
   "bundledDependencies": [
     "@mrclrchtr/supi-core"

package/src/context7-client.ts

@@ -1,12 +1,19 @@
 /**
- * Context7 API client — thin wrapper around @upstash/context7-sdk.
+ * Context7 API client — calls the Context7 REST API directly via fetch(),
+ * matching the official Context7 pi extension pattern.
  *
- * API key is read automatically from CONTEXT7_API_KEY env var by the SDK.
+ * API key is read from CONTEXT7_API_KEY env var. Without a key, requests are
+ * sent without an Authorization header; the API will return 401.
  */
 
-import { Context7, Context7Error } from "@upstash/context7-sdk";
+const BASE_URL = "https://context7.com/api";
 
-export { Context7Error };
+export class Context7Error extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "Context7Error";
+  }
+}
 
 export interface SearchResult {
   id: string;
@@ -24,11 +31,74 @@ export interface DocSnippet {
   source: string;
 }
 
-const client = new Context7();
+function authHeaders(): Record<string, string> {
+  const apiKey = process.env.CONTEXT7_API_KEY;
+  return apiKey ? { Authorization: `Bearer ${apiKey}` } : {};
+}
+
+async function parseErrorResponse(response: Response): Promise<string> {
+  try {
+    const json = (await response.json()) as { message?: string };
+    if (json.message) return json.message;
+  } catch {
+    // JSON parsing failed, fall through to status-based message
+  }
+
+  const hasKey = Boolean(process.env.CONTEXT7_API_KEY);
+  if (response.status === 429) {
+    return hasKey
+      ? "Rate limited or quota exceeded. Upgrade your plan at https://context7.com/plans for higher limits."
+      : "Rate limited or quota exceeded. Create a free API key at https://context7.com/dashboard for higher limits.";
+  }
+  if (response.status === 404) {
+    return "The library you are trying to access does not exist. Please try with a different library ID.";
+  }
+  if (response.status === 401) {
+    return "Invalid API key. Please check your API key. API keys should start with 'ctx7sk' prefix.";
+  }
+  return `Request failed with status ${response.status}. Please try again later.`;
+}
+
+interface ApiSearchResult {
+  id: string;
+  title: string;
+  description: string;
+  totalSnippets: number;
+  trustScore: number;
+  benchmarkScore: number;
+  versions?: string[];
+}
+
+interface ApiSearchResponse {
+  error?: string;
+  results: ApiSearchResult[];
+}
+
+function mapSearchResult(r: ApiSearchResult): SearchResult {
+  return {
+    id: r.id,
+    name: r.title,
+    description: r.description,
+    totalSnippets: r.totalSnippets,
+    trustScore: r.trustScore,
+    benchmarkScore: r.benchmarkScore,
+    versions: r.versions,
+  };
+}
 
 export async function searchLibrary(query: string, libraryName: string): Promise<SearchResult[]> {
-  const results = await client.searchLibrary(query, libraryName);
-  return results as unknown as SearchResult[];
+  const url = new URL(`${BASE_URL}/v2/libs/search`);
+  url.searchParams.set("query", query);
+  url.searchParams.set("libraryName", libraryName);
+
+  const response = await fetch(url, { headers: authHeaders() });
+
+  if (!response.ok) {
+    throw new Context7Error(await parseErrorResponse(response));
+  }
+
+  const data = (await response.json()) as ApiSearchResponse;
+  return (data.results ?? []).map(mapSearchResult);
 }
 
 export async function getContext(
@@ -36,6 +106,20 @@ export async function getContext(
   libraryId: string,
   raw?: boolean,
 ): Promise<string | DocSnippet[]> {
-  const options = raw ? ({ type: "json" } as const) : ({ type: "txt" } as const);
-  return client.getContext(query, libraryId, options) as Promise<string | DocSnippet[]>;
+  const url = new URL(`${BASE_URL}/v2/context`);
+  url.searchParams.set("query", query);
+  url.searchParams.set("libraryId", libraryId);
+
+  const response = await fetch(url, { headers: authHeaders() });
+
+  if (!response.ok) {
+    throw new Context7Error(await parseErrorResponse(response));
+  }
+
+  if (raw) {
+    const json = (await response.json()) as DocSnippet[];
+    return json;
+  }
+
+  return response.text();
 }

package/src/fetch.ts

@@ -2,7 +2,7 @@
  * HTTP fetching with content negotiation and Markdown sniffing.
  */
 
-// biome-ignore lint/nursery/noExcessiveLinesPerFile: expanded guessLanguage map pushes past the threshold; nursery rule, not stable
+// biome-ignore lint/style/noExcessiveLinesPerFile: expanded guessLanguage map pushes past the threshold; nursery rule, not stable
 const USER_AGENT = "Mozilla/5.0 (compatible; supi-web/1.0; +https://github.com/mrclrchtr/supi)";
 const ACCEPT_SIBLING = "text/markdown,text/plain;q=0.9,*/*;q=0.1";
 const DEFAULT_TIMEOUT_MS = 30_000;