@pdfvector/instance-contract 0.0.7 → 0.0.9

package/.tsc/lib/index.d.ts

@@ -3,3 +3,5 @@ import * as contract from "./router";
 export { contract };
 export type ContractInputs = InferContractRouterInputs<typeof contract>;
 export type ContractOutputs = InferContractRouterOutputs<typeof contract>;
+export * from "./pdfvector-model";
+export * from "./pdfvector-model-schema";

package/.tsc/lib/index.js

@@ -1,2 +1,4 @@
 import * as contract from "./router";
 export { contract };
+export * from "./pdfvector-model";
+export * from "./pdfvector-model-schema";

package/.tsc/lib/pdfvector-model-schema.d.ts

@@ -0,0 +1,7 @@
+import { z } from "zod";
+export declare const pdfvectorModelSchema: z.ZodEnum<{
+    nano: "nano";
+    mini: "mini";
+    pro: "pro";
+    max: "max";
+}>;

package/.tsc/lib/pdfvector-model-schema.js

@@ -0,0 +1,2 @@
+import { z } from "zod";
+export const pdfvectorModelSchema = z.enum(["nano", "mini", "pro", "max"]);

package/.tsc/lib/pdfvector-model.d.ts

@@ -0,0 +1,3 @@
+import type { z } from "zod";
+import type { pdfvectorModelSchema } from "./pdfvector-model-schema";
+export type PDFVectorModel = z.infer<typeof pdfvectorModelSchema>;

package/.tsc/lib/router/authenticate/index.d.ts

@@ -0,0 +1 @@
+export * from "./validate-credential";

package/.tsc/lib/router/authenticate/index.js

@@ -0,0 +1 @@
+export * from "./validate-credential";

package/.tsc/lib/router/authenticate/validate-credential.d.ts

@@ -0,0 +1,6 @@
+import { z } from "zod";
+export declare const validateCredential: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodOptional<z.ZodObject<{}, z.core.$strip>>, z.ZodObject<{
+    status: z.ZodString;
+    version: z.ZodString;
+    timestamp: z.ZodString;
+}, z.core.$strip>, Record<never, never>, Record<never, never>>;

package/.tsc/lib/router/authenticate/validate-credential.js

@@ -0,0 +1,20 @@
+import { oc } from "@orpc/contract";
+import { z } from "zod";
+const inputSchema = z.object({}).optional();
+const outputSchema = z.object({
+    status: z.string().describe("Server status indicator"),
+    version: z.string().describe("Server version"),
+    timestamp: z.string().describe("Current server timestamp in ISO 8601 format"),
+});
+export const validateCredential = oc
+    .route({
+    summary: "Validate API credential",
+    description: "Verify that the API key is valid and the server is reachable. Returns basic server information.",
+    tags: ["Authenticate"],
+    spec: (op) => {
+        op.security = [{ bearerAuth: [] }];
+        return op;
+    },
+})
+    .input(inputSchema)
+    .output(outputSchema);

package/.tsc/lib/router/document/ask.d.ts

@@ -5,11 +5,11 @@ export declare const ask: import("@orpc/contract").ContractProcedureBuilderWithI
     base64: z.ZodOptional<z.ZodString>;
     question: z.ZodString;
     model: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        auto: "auto";
         nano: "nano";
         mini: "mini";
         pro: "pro";
         max: "max";
+        auto: "auto";
     }>>>;
 }, z.core.$strip>, z.ZodObject<{
     markdown: z.ZodString;

package/.tsc/lib/router/document/ask.js

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
+import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
 import { getDefaultSpec } from "./get-default-spec";
 const askInputSchema = z.object({
     url: z
@@ -28,22 +29,20 @@ const askInputSchema = z.object({
         .min(4)
         .describe("The question to answer about the document"),
     model: z
-        .enum(["auto", "nano", "mini", "pro", "max"])
+        .enum(["auto", ...pdfvectorModelSchema.options])
         .optional()
         .default("auto")
         .describe("Model tier for answering the question. " +
         "'auto' (default): Automatically selects the best tier based on document page count and document complexity. " +
-        "'nano': Uses lightweight models (gpt-4o-mini, gemini-2.5-flash, claude-haiku-3-5, ...). Supports PDF, Word, Excel, CSV. " +
-        "'mini': Uses mid-range models (gpt-5-mini, gemini-3-flash, claude-haiku-4-5, ...). Supports PDF, Word, Excel, CSV. " +
-        "'pro': Uses capable models (gpt-5.2, gemini-3.1-pro, claude-sonnet-4-6, ...). Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': Uses the most powerful models (o3, claude-opus-4-6, ...). Supports PDF, Word, Excel, CSV, Image."),
+        "'nano': Uses lightweight models (likely better than GPT-5-nano). Supports PDF, Word, Excel, CSV. " +
+        "'mini': Uses mid-range models (likely better than GPT-5-mini). Supports PDF, Word, Excel, CSV. " +
+        "'pro': Uses capable models (likely better than GPT-5.2). Supports PDF, Word, Excel, CSV, Image. " +
+        "'max': Uses the most powerful models (likely better than Claude Opus 4.6). Supports PDF, Word, Excel, CSV, Image."),
 });
 const askOutputSchema = z
     .object({
     markdown: z.string().describe("The answer to the question"),
-    model: z
-        .enum(["nano", "mini", "pro", "max"])
-        .describe("Model tier used to answer the question. " +
+    model: pdfvectorModelSchema.describe("Model tier used to answer the question. " +
         "'nano': Supports PDF, Word, Excel, CSV. " +
         "'mini': Supports PDF, Word, Excel, CSV. " +
         "'pro': Supports PDF, Word, Excel, CSV, Image. " +
@@ -61,7 +60,7 @@ const requestExamples = {
     "Ask from URL": {
         summary: "Ask from URL",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
             question: "What are the main findings of this study?",
         },
     },
@@ -82,7 +81,7 @@ const requestExamples = {
     "Ask with lightweight models (nano)": {
         summary: "Ask with lightweight models (nano)",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
             question: "What is the title of this paper?",
             model: "nano",
         },
@@ -90,7 +89,7 @@ const requestExamples = {
     "Ask with powerful models (max)": {
         summary: "Ask with powerful models (max)",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
             question: "Provide a detailed analysis of the methodology used in this study.",
             model: "max",
         },
@@ -99,7 +98,7 @@ const requestExamples = {
 export const ask = oc
     .route({
     summary: "Ask a question about a document",
-    description: "Parse a document and answer a question about its content using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: "Parse a document and answer a question about its content using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Files up to 1000 pages and up to 500MB in size. Provide the document via file upload, a public URL, or a base64-encoded string.",
     tags: ["Document"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/document/extract.d.ts

@@ -1,18 +1,18 @@
 import { z } from "zod";
-export declare const extract: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+export declare const extract: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodObject<{
     url: z.ZodOptional<z.ZodURL>;
     file: z.ZodOptional<z.ZodFile>;
     base64: z.ZodOptional<z.ZodString>;
     prompt: z.ZodString;
     schema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
     model: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        auto: "auto";
         nano: "nano";
         mini: "mini";
         pro: "pro";
         max: "max";
+        auto: "auto";
     }>>>;
-}, z.core.$strip>, z.ZodObject<{
+}, z.core.$strip>>, z.ZodObject<{
     data: z.ZodUnknown;
     model: z.ZodEnum<{
         nano: "nano";

package/.tsc/lib/router/document/extract.js

@@ -1,7 +1,36 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
+import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
 import { getDefaultSpec } from "./get-default-spec";
-const extractInputSchema = z.object({
+// Support for dot-notation in multipart form-data
+function expandDotNotation(input) {
+    if (typeof input !== "object" || input === null)
+        return input;
+    const obj = input;
+    const dotKeys = Object.keys(obj).filter((k) => k.includes("."));
+    if (dotKeys.length === 0)
+        return input;
+    const result = { ...obj };
+    for (const key of dotKeys) {
+        const parts = key.split(".");
+        let current = result;
+        for (let i = 0; i < parts.length - 1; i++) {
+            const part = parts[i];
+            if (part === undefined)
+                continue;
+            if (!(part in current) || typeof current[part] !== "object") {
+                current[part] = {};
+            }
+            current = current[part];
+        }
+        const lastPart = parts[parts.length - 1];
+        if (lastPart !== undefined)
+            current[lastPart] = obj[key];
+        delete result[key];
+    }
+    return result;
+}
+const extractInputSchema = z.preprocess(expandDotNotation, z.object({
     url: z
         .url()
         .optional()
@@ -31,24 +60,22 @@ const extractInputSchema = z.object({
         .record(z.string(), z.unknown())
         .describe("JSON Schema describing the structure of the data to extract from the document"),
     model: z
-        .enum(["auto", "nano", "mini", "pro", "max"])
+        .enum(["auto", ...pdfvectorModelSchema.options])
         .optional()
         .default("auto")
         .describe("Model tier for extracting structured data. " +
         "'auto' (default): Automatically selects the best tier based on document page count and document complexity. " +
-        "'nano': Uses lightweight models (gpt-4o-mini, gemini-2.5-flash, claude-haiku-3-5, ...). Supports PDF, Word, Excel, CSV. " +
-        "'mini': Uses mid-range models (gpt-5-mini, gemini-3-flash, claude-haiku-4-5, ...). Supports PDF, Word, Excel, CSV. " +
-        "'pro': Uses capable models (gpt-5.2, gemini-3.1-pro, claude-sonnet-4-6, ...). Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': Uses the most powerful models (o3, claude-opus-4-6, ...). Supports PDF, Word, Excel, CSV, Image."),
-});
+        "'nano': Uses lightweight models (likely better than GPT-5-nano). Supports PDF, Word, Excel, CSV. " +
+        "'mini': Uses mid-range models (likely better than GPT-5-mini). Supports PDF, Word, Excel, CSV. " +
+        "'pro': Uses capable models (likely better than GPT-5.2). Supports PDF, Word, Excel, CSV, Image. " +
+        "'max': Uses the most powerful models (likely better than Claude Opus 4.6). Supports PDF, Word, Excel, CSV, Image."),
+}));
 const extractOutputSchema = z
     .object({
     data: z
         .unknown()
         .describe("Extracted structured data matching the provided JSON Schema"),
-    model: z
-        .enum(["nano", "mini", "pro", "max"])
-        .describe("Model tier used to extract the data. " +
+    model: pdfvectorModelSchema.describe("Model tier used to extract the data. " +
         "'nano': Supports PDF, Word, Excel, CSV. " +
         "'mini': Supports PDF, Word, Excel, CSV. " +
         "'pro': Supports PDF, Word, Excel, CSV, Image. " +
@@ -70,7 +97,7 @@ const requestExamples = {
     "Extract from URL": {
         summary: "Extract from URL",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
             prompt: "Extract the title, authors, and publication year from this research paper",
             schema: {
                 type: "object",
@@ -116,7 +143,7 @@ const requestExamples = {
 export const extract = oc
     .route({
     summary: "Extract structured data from a document",
-    description: "Parse a document and extract structured data matching a provided JSON Schema using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Provide the document via file upload, a public URL, or a base64-encoded string.",
+    description: "Parse a document and extract structured data matching a provided JSON Schema using AI. Supports PDF, Word (.docx), Excel (.xlsx), CSV, and Image (.png, .jpg) files. Files up to 1000 pages and up to 500MB in size. Provide the document via file upload, a public URL, or a base64-encoded string.",
     tags: ["Document"],
     spec: (op) => getDefaultSpec(op, requestExamples),
 })

package/.tsc/lib/router/document/parse.d.ts

@@ -4,11 +4,11 @@ export declare const parse: import("@orpc/contract").ContractProcedureBuilderWit
     file: z.ZodOptional<z.ZodFile>;
     base64: z.ZodOptional<z.ZodString>;
     model: z.ZodDefault<z.ZodOptional<z.ZodEnum<{
-        auto: "auto";
         nano: "nano";
         mini: "mini";
         pro: "pro";
         max: "max";
+        auto: "auto";
     }>>>;
 }, z.core.$strip>, z.ZodObject<{
     markdown: z.ZodString;

package/.tsc/lib/router/document/parse.js

@@ -1,5 +1,6 @@
 import { oc } from "@orpc/contract";
 import { z } from "zod";
+import { pdfvectorModelSchema } from "../../pdfvector-model-schema";
 import { getDefaultSpec } from "./get-default-spec";
 const parseInputSchema = z.object({
     url: z
@@ -24,15 +25,15 @@ const parseInputSchema = z.object({
         .optional()
         .describe("Base64-encoded document file content"),
     model: z
-        .enum(["auto", "nano", "mini", "pro", "max"])
+        .enum(["auto", ...pdfvectorModelSchema.options])
         .optional()
         .default("auto")
         .describe("Model tier for parsing. " +
-        "'auto' (default): Automatically selects the best parsing strategy with intelligent fallback. " +
-        "'nano': For simple documents with plain text content. Supports PDF, Word, Excel, CSV. " +
-        "'mini': For documents with tables and structured content. Supports PDF, Word, Excel, CSV. " +
-        "'pro': For documents up to ~50 pages with tables, handwritten text, figures, math, and Arabic. Supports PDF, Word, Excel, CSV, Image. " +
-        "'max': For large documents up to ~100MB / ~1000 pages with full Pro capabilities plus enhanced multilingual support. Supports PDF, Word, Excel, CSV, Image."),
+        "'auto' (default): Automatically selects the best parsing strategy with intelligent fallback. File up to 1000 pages, up to 500MB in size. Supports PDF, Word, Excel, CSV, Image. " +
+        "'nano': For simple documents with plain text content. File up to 30 pages, up to 10MB in size. Supports PDF, Word, Excel, CSV. " +
+        "'mini': For documents with tables and structured content. File up to 30 pages, up to 10MB in size. Supports PDF, Word, Excel, CSV. " +
+        "'pro': For documents up to 30 pages with tables, handwritten text, figures, math, and Arabic. File up to 30 pages, up to 40MB in size. Supports PDF, Word, Excel, CSV, Image. " +
+        "'max': For large documents with full Pro capabilities plus enhanced multilingual support. File up to 1000 pages, up to 500MB in size. Supports PDF, Word, Excel, CSV, Image."),
 });
 const parseOutputSchema = z
     .object({
@@ -41,9 +42,7 @@ const parseOutputSchema = z
         .number()
         .int()
         .describe("Total number of pages in the document"),
-    model: z
-        .enum(["nano", "mini", "pro", "max"])
-        .describe("Model tier used to parse the document. " +
+    model: pdfvectorModelSchema.describe("Model tier used to parse the document. " +
         "'nano': Supports PDF, Word, Excel, CSV. " +
         "'mini': Supports PDF, Word, Excel, CSV. " +
         "'pro': Supports PDF, Word, Excel, CSV, Image. " +
@@ -62,7 +61,7 @@ const requestExamples = {
     "Parse from URL": {
         summary: "Parse from URL",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
         },
     },
     "Parse from base64": {
@@ -80,21 +79,21 @@ const requestExamples = {
     "Parse with simple PDF (nano)": {
         summary: "Parse with simple PDF (nano)",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
             model: "nano",
         },
     },
     "Parse with small complex documents (pro)": {
         summary: "Parse with small complex documents (pro)",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
             model: "pro",
         },
     },
     "Parse with large complex documents (max)": {
         summary: "Parse with large complex documents (max)",
         value: {
-            url: "https://www.nature.com/articles/s41586-020-2196-x.pdf",
+            url: "https://drive.google.com/file/d/1nRBJK5Eh7pUy6DIHncwAp-pFq_Su8TTq/view?usp=share_link",
             model: "max",
         },
     },

package/.tsc/lib/router/index.d.ts

@@ -1,2 +1,3 @@
 export * as admin from "./admin";
+export * as authenticate from "./authenticate";
 export * as document from "./document";

package/.tsc/lib/router/index.js

@@ -1,2 +1,3 @@
 export * as admin from "./admin";
+export * as authenticate from "./authenticate";
 export * as document from "./document";

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # @pdfvector/instance-contract
 
+## 0.0.9
+### Patch Changes
+
+
+
+- [#63](https://github.com/phuctm97/pdfvector/pull/63) [`771f17f`](https://github.com/phuctm97/pdfvector/commit/771f17fc949800d4a44d4caed73322c6552cdbef) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Update example
+
+
+
+- [#60](https://github.com/phuctm97/pdfvector/pull/60) [`163b517`](https://github.com/phuctm97/pdfvector/commit/163b517715a63172a1fd3814128f2f78503a926b) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Using nova model
+
+## 0.0.8
+### Patch Changes
+
+
+
+- [#59](https://github.com/phuctm97/pdfvector/pull/59) [`66c1b55`](https://github.com/phuctm97/pdfvector/commit/66c1b558c674a95b9884fca3bffe1fe07e5ee10f) Thanks [@khanhduyvt0101](https://github.com/khanhduyvt0101)! - Update model and add disable libreoffice flag
+
 ## 0.0.7
 ### Patch Changes
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pdfvector/instance-contract",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "type": "module",
   "main": ".tsc/lib/index.js",
   "dependencies": {