Documents

import Pdffillr from '@pdffillr/sdk';
import fs from 'fs';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// 1. upload() - store the PDF and receive a doc_id.
const doc = await client.sdk.docs.upload({
  file: fs.createReadStream('form.pdf'),
});
console.log('Uploaded:', doc.doc_id);

// 2. list() - see every document stored under this API key.
const allDocs = await client.sdk.docs.list();
console.log(`${allDocs.length} documents on file`);

// 3. getMetadata() - check fill status before triggering a fill.
const meta = await client.sdk.docs.getMetadata(doc.doc_id);
console.log('Fill status:', meta.fill_status);

// 4. getURL() - get a presigned URL for browser preview (valid 1 hour).
const { url } = await client.sdk.docs.getURL(doc.doc_id, { presigned: true });
console.log('Preview URL:', url);

// 5. delete() - remove the document and its S3 object permanently.
await client.sdk.docs.delete(doc.doc_id);
console.log('Deleted.');

import Pdffillr from '@pdffillr/sdk';
import fs from 'fs';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// Upload a PDF - the returned doc_id is used in all subsequent operations.
const doc = await client.sdk.docs.upload({
  file: fs.createReadStream('path/to/document.pdf'),
});
console.log('Uploaded doc_id:', doc.doc_id);

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// Default (presigned=false): returns the stored S3 key path.
const keyResult = await client.sdk.docs.getURL(42);
console.log('S3 key:', keyResult.url);

// presigned=true: returns a temporary URL valid for 1 hour.
// Use this when you need to serve the file directly in a browser.
const presignedResult = await client.sdk.docs.getURL(42, { presigned: true });
console.log('Presigned URL:', presignedResult.url);

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// Retrieve metadata for a single document by its doc_id.
const meta = await client.sdk.docs.getMetadata(42);

console.log('Filename:    ', meta.filename);
console.log('MIME type:   ', meta.mime_type);
console.log('Size:        ', meta.size_bytes, 'bytes');
console.log('Fill status: ', meta.fill_status);  // 'pending' | 'ready' | 'failed'
console.log('Uploaded at: ', meta.uploaded_at);

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// Returns all documents uploaded under this API key - newest first.
const docs = await client.sdk.docs.list();

docs.forEach((d) => {
  console.log(`[${d.fill_status}] ${d.doc_id} - ${d.filename}`);
  console.log(`  Size: ${d.size_bytes} bytes, Uploaded: ${d.uploaded_at}`);
});

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// Permanently delete a document and its associated S3 object.
// This cannot be undone.
await client.sdk.docs.delete(42);
console.log('Document 42 deleted.');

import Pdffillr from '@pdffillr/sdk';
import fs from 'fs';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// Step 1 - upload the blank PDF template.
const template = await client.sdk.docs.upload({
  file: fs.createReadStream('blank-form.pdf'),
});

// Step 2 - upload filled-info data to trigger the AI fill pipeline.
await client.sdk.docs.uploadFilledInfo({
  pdf_doc_id: template.doc_id,
  file: fs.createReadStream('filled-data.json'),
});
console.log('Fill job queued - polling for result...');

// Step 3 - poll pollFillResult() every 3-5 seconds until status is 'ready'.
let result;
do {
  await new Promise((r) => setTimeout(r, 3000));
  result = await client.sdk.docs.pollFillResult(template.doc_id);
} while (result.status === 'processing');

if (result.status === 'ready') {
  // Step 4 - download the filled PDF using the provided URL (expires 1 hr).
  console.log('Filled PDF ready:', result.url);
} else {
  console.error('Fill job failed:', result.error);
}

import Pdffillr from '@pdffillr/sdk';
import fs from 'fs';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'],
});

// 1. Upload the PDF to get a doc_id.
const doc = await client.sdk.docs.upload({
  file: fs.createReadStream('contract.pdf'),
});

// 2. Create a chat session.
const session = await client.sdk.chat.sessions.create({ title: 'Contract Review' });

// 3. Attach the document to the session.
//    Once attached, the AI can reference its content in all subsequent messages.
await client.sdk.chat.sessions.attachDocument(session.session_id, {
  doc_id: doc.doc_id,
});
console.log('Document attached - the AI can now reference it in this session.');

// You can attach multiple documents by calling attachDocument again with a new doc_id.