Installation
npm install parsefy zod hono
- parsefy: Parsefy SDK for document extraction
- zod: TypeScript-first schema validation library
- hono: Lightweight web framework for the edge (Cloudflare, Vercel, Deno)
Environment setup
export PARSEFY_API_KEY=pk_your_api_key
Basic setup
import { Hono } from 'hono';
import { Parsefy } from 'parsefy';
import * as z from 'zod';
const app = new Hono();
const client = new Parsefy();
const invoiceSchema = z.object({
// REQUIRED - triggers fallback if below confidence threshold
invoice_number: z.string().describe('The invoice number'),
total: z.number().describe('Total amount including tax'),
// OPTIONAL - won't trigger fallback if missing
date: z.string().optional().describe('Invoice date'),
vendor: z.string().optional().describe('Vendor name'),
});
app.post('/extract', async (c) => {
const formData = await c.req.formData();
const file = formData.get('file') as File;
if (!file) {
return c.json({ error: 'No file uploaded' }, 400);
}
const { object, error, metadata, verification } = await client.extract({
file,
schema: invoiceSchema,
confidenceThreshold: 0.85,
enableVerification: true,
});
if (error) {
return c.json({ error: error.message }, 422);
}
return c.json({
data: object,
confidence: object?._meta.confidence_score,
fieldConfidence: object?._meta.field_confidence,
credits: metadata.credits,
verification: verification,
});
});
export default app;
Cloudflare Workers
Deploy to Cloudflare Workers:// src/index.ts
import { Hono } from 'hono';
import { Parsefy } from 'parsefy';
import * as z from 'zod';
type Bindings = {
PARSEFY_API_KEY: string;
};
const app = new Hono<{ Bindings: Bindings }>();
const invoiceSchema = z.object({
// REQUIRED
invoice_number: z.string().describe('The invoice number'),
total: z.number().describe('Total amount including tax'),
// OPTIONAL
date: z.string().optional().describe('Invoice date'),
vendor: z.string().optional().describe('Vendor name'),
});
app.post('/extract', async (c) => {
const client = new Parsefy(c.env.PARSEFY_API_KEY);
const formData = await c.req.formData();
const file = formData.get('file') as File;
if (!file) {
return c.json({ error: 'No file uploaded' }, 400);
}
const { object, error, metadata, verification } = await client.extract({
file,
schema: invoiceSchema,
confidenceThreshold: 0.85,
enableVerification: true,
});
if (error) {
return c.json({ error: error.message }, 422);
}
return c.json({
data: object,
confidence: object?._meta.confidence_score,
fieldConfidence: object?._meta.field_confidence,
issues: object?._meta.issues,
credits: metadata.credits,
verification: verification,
});
});
export default app;
wrangler.toml:
name = "parsefy-worker"
main = "src/index.ts"
[vars]
PARSEFY_API_KEY = "pk_your_api_key"
Vercel Edge Functions
// api/extract.ts
import { Hono } from 'hono';
import { handle } from 'hono/vercel';
import { Parsefy } from 'parsefy';
import * as z from 'zod';
export const config = {
runtime: 'edge',
};
const app = new Hono().basePath('/api');
const client = new Parsefy();
const schema = z.object({
// REQUIRED
invoice_number: z.string().describe('The invoice number'),
total: z.number().describe('Total amount'),
// OPTIONAL
date: z.string().optional().describe('Invoice date'),
});
app.post('/extract', async (c) => {
const formData = await c.req.formData();
const file = formData.get('file') as File;
const { object, error, metadata, verification } = await client.extract({
file,
schema,
confidenceThreshold: 0.85,
enableVerification: true,
});
if (error) {
return c.json({ error: error.message }, 422);
}
return c.json({
data: object,
confidence: object?._meta.confidence_score,
fieldConfidence: object?._meta.field_confidence,
verification: verification,
});
});
export default handle(app);
Testing
curl -X POST http://localhost:3000/extract \
-F "file=@invoice.pdf"