Feedback

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

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'], // This is the default and can be omitted
});

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

// Step 2 - Create a session and run the AI fill pipeline.
const session = await client.sdk.chat.sessions.create({ title: 'KYC Form' });
// ...fill pipeline runs asynchronously...

// Step 3 - Once the filled PDF is stored, record the save event.
//    This tells the feedback loop exactly where the filled output lives.
await client.sdk.feedback.filledPdf.recordSaveEvent({
  filled_pdf_location: `filled-pdfs/${session.session_id}/output.pdf`,
  pdf_id: String(doc.doc_id),
  session_id: session.session_id,
});

// Step 4 - If the user reports an error via your UI, submit feedback.
await client.sdk.feedback.user.submit({
  session_id: session.session_id,
  pdf_id: String(doc.doc_id),
  field_name: 'Tax ID',
  field_type: 'text',
  page_number: 1,
  error_type: 'wrong_field',
  feedback: 'Value placed in Tax ID field but should have gone into the EIN field.',
});

console.log('Feedback loop complete - this session is now tracked for AI improvement.');

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'], // This is the default and can be omitted
});

// Call this on your server once the fill pipeline has completed
// and the filled PDF has been stored.
await client.sdk.feedback.filledPdf.recordSaveEvent({
  // Where the filled PDF is stored - S3 key, file path, or URL.
  filled_pdf_location: 'filled-pdfs/dev-123/session-abc/v1.pdf',

  // The ID of the blank PDF template used for this fill job.
  pdf_id: '42',

  // The session that produced this filled output.
  session_id: 'clx9f2k3n0000abc123xyz',
});

console.log('Save event recorded. The AI feedback loop can now track this output.');

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'], // This is the default and can be omitted
});

// Fetch all recorded versions for a specific document in a session.
const history = await client.sdk.feedback.filledPdf.getVersionHistory({
  pdf_id: '42',
  session_id: 'clx9f2k3n0000abc123xyz',
});

console.log('Version history retrieved successfully.');

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'], // This is the default and can be omitted
});

// Triggered when a user clicks "Report an issue" or "This is wrong" in your UI.
await client.sdk.feedback.user.submit({
  // Which session and PDF this report is about.
  session_id: 'clx9f2k3n0000abc123xyz',
  pdf_id: '42',

  // The specific field the user is reporting a problem with.
  field_name: 'Date of Birth',
  field_type: 'date',
  page_number: 2,

  // Optional: Provide bounding box coordinates of the field
  corners: { x1: 100, y1: 200, x2: 250, y2: 220 },

  // What kind of error occurred (see error_type values below).
  error_type: 'formatting',

  // A plain-English description of what went wrong.
  feedback: 'Date was filled as MM/DD/YYYY but form requires DD/MM/YYYY.',
});

console.log('Feedback submitted. This will appear in your admin analytics dashboard.');

import Pdffillr from '@pdffillr/sdk';

const client = new Pdffillr({
  apiKey: process.env['PDFFILLR_API_KEY'], // This is the default and can be omitted
});

// Fetch all feedback across your account.
const result = await client.sdk.feedback.user.list();

result.data?.forEach((item) => {
  console.log(`[${item.error_type}] "${item.field_name}" - ${item.feedback}`);
});

// Filter down to a specific PDF or session.
const forPdf     = await client.sdk.feedback.user.list({ pdf_id: '42' });
const forSession = await client.sdk.feedback.user.list({
  session_id: 'clx9f2k3n0000abc123xyz',
});

// Paginate through a large set of reports.
const page2 = await client.sdk.feedback.user.list({ page: 2, limit: 20 });
console.log(`Page 2 has ${page2.data?.length || 0} feedback items.`);