@pdfvector/client 0.0.28 → 0.0.30

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @pdfvector/client
 
+## 0.0.30
+### Patch Changes
+
+
+
+- [#240](https://github.com/phuctm97/pdfvector/pull/240) [`2c8691c`](https://github.com/phuctm97/pdfvector/commit/2c8691c9bbd251ff7b7a153fd4254d9360c11c08) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Add academic.parse to resolve academic paper IDs or provider URLs to public PDFs and parse them to markdown.
+
+- Updated dependencies []:
+  - @pdfvector/instance-client@0.0.50
+
+## 0.0.29
+### Patch Changes
+
+- Updated dependencies []:
+  - @pdfvector/instance-client@0.0.49
+
 ## 0.0.28
 ### Patch Changes
 

package/README.md

@@ -1,6 +1,6 @@
 # PDF Vector TypeScript/JavaScript SDK
 
-The official TypeScript/JavaScript SDK for the [PDF Vector](https://www.pdfvector.com) API: Parse PDF, Word, Image, and Excel documents to clean, structured markdown format, ask questions about documents using AI, extract structured data from documents with JSON Schema, search across multiple academic databases with a unified API, fetch specific publications by DOI, PubMed ID, ArXiv ID, and more, find relevant academic citations for paragraphs of text, explore paper citation graphs, find similar papers, and search for research grants across US, EU, and UK funding databases.
+The official TypeScript/JavaScript SDK for the [PDF Vector](https://www.pdfvector.com) API: Parse PDF, Word, Image, and Excel documents to clean, structured markdown format, ask questions about documents using AI, extract structured data from documents with JSON Schema, search across multiple academic databases with a unified API, fetch specific publications by DOI, PubMed ID, ArXiv ID, and more, convert academic paper IDs or provider URLs to markdown, find relevant academic citations for paragraphs of text, explore paper citation graphs, find similar papers, and search for research grants across US, EU, and UK funding databases.
 
 ## Installation
 
@@ -380,6 +380,36 @@ result.errors?.forEach((error) => {
 
 **Supported ID types:** DOI, PubMed ID, ArXiv ID, Semantic Scholar ID, ERIC ID, Europe PMC ID, OpenAlex ID.
 
+### Parse Academic Paper to Markdown
+
+Resolve a paper ID or provider URL to its public PDF and parse it into markdown. Uses the same per-page model pricing as Document Parse.
+
+```typescript
+const result = await client.academic.parse({
+  id: "1706.03762", // DOI, PubMed ID, ArXiv ID, Semantic Scholar ID, or provider URL
+  model: "auto",    // "auto" | "nano" | "mini" | "pro" | "max"
+});
+
+console.log(`Title: ${result.title}`);
+console.log(`Provider: ${result.detectedProvider}`);
+console.log(`PDF: ${result.pdfURL}`);
+console.log(result.markdown);
+console.log(`Pages: ${result.pageCount}, Credits: ${result.credits}`);
+```
+
+You can pass a provider URL instead of an ID:
+
+```typescript
+const result = await client.academic.parse({
+  url: "https://arxiv.org/abs/1706.03762",
+  model: "nano",
+});
+
+console.log(result.markdown);
+```
+
+Provide exactly one of `id` or `url`. If the paper cannot be found, has no public PDF, or the resolved PDF cannot be fetched, the API returns a typed `PDFVectorError` with a clear message and no parse credits are charged.
+
 ### Find Citations for a Paragraph
 
 Find relevant academic citations for each sentence in a paragraph using semantic similarity. Costs 2 credits per sentence analyzed.
@@ -573,6 +603,7 @@ console.log(resultB.documentId); // "doc-b"
 | Bank Statement Extract | 6 | 10 | 14 | 18 | /page |
 | Academic Search | 2 | 2 | 2 | 2 | /request |
 | Academic Fetch | 2 | 2 | 2 | 2 | /request |
+| Academic Parse | 1 | 2 | 4 | 8 | /page |
 | Academic Find Citations | 2 | 2 | 2 | 2 | /sentence |
 | Academic Paper Graph | 2+ | 2+ | 2+ | 2+ | /request |
 | Academic Similar Papers | 3 | 3 | 3 | 3 | /request |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdfvector/client",
-  "version": "0.0.28",
+  "version": "0.0.30",
   "type": "module",
   "description": "Official TypeScript/JavaScript SDK for PDF Vector API",
   "license": "MIT",
@@ -23,7 +23,7 @@
   },
   "main": ".tsc/lib/index.js",
   "dependencies": {
-    "@pdfvector/instance-client": "^0.0.48"
+    "@pdfvector/instance-client": "^0.0.50"
   },
   "files": [
     ".tsc",