TypeScript SDK

npm install drex-sdk
export DREX_API_KEY="nace_sk_..."

import { DrexClient } from "drex-sdk";

const client = new DrexClient();

const job = await client.documents.parse({
  source: "https://example.com/report.pdf",
  page_ranges: [{ start: 1, end: 3 }],
  output: { formats: ["markdown", "blocks"] },
  chunking: { strategy: "page" },
  wait_seconds: 60,
});

console.log(job.result);

const job = await client.documents.split({
  source: "https://example.com/packet.pdf",
  classes: [
    { id: "invoice", label: "Invoice", description: "A supplier invoice" },
    { id: "receipt", label: "Receipt", description: "A payment receipt" },
  ],
  wait_seconds: 60,
});

const job = await client.documents.classify({
  source: "https://example.com/invoice.pdf",
  classes: [
    { id: "invoice", label: "Invoice", description: "A supplier invoice" },
    { id: "contract", label: "Contract", description: "A signed agreement between two parties" },
  ],
  granularity: "page",
  wait_seconds: 60,
});

const parsed = await client.documents.parse({
  source: "https://example.com/invoice.pdf",
  wait_seconds: 60,
});

const job = await client.documents.extract({
  source: { type: "parse_result", job_id: parsed.job_id },
  schema: {
    type: "object",
    properties: {
      invoice_number: { type: "string" },
      total: { type: "number" },
    },
    required: ["invoice_number", "total"],
  },
  wait_seconds: 60,
});

console.log((job.result as { data: unknown }).data); // { invoice_number: 'INV-1042', total: null }

const job = await client.documents.ground({
  source: "https://example.com/report.pdf",
  targets: [
    { id: "total", text: "1,200.50" },
    { id: "signer", text: "Jane Smith", hint: "Signed on behalf of the supplier" },
  ],
  wait_seconds: 60,
});

import { readFile } from "node:fs/promises";
import { workspaceFile } from "drex-sdk";

const file = await client.documents.upload(await readFile("invoice.pdf"), {
  file_name: "invoice.pdf",
  path: "invoices/invoice.pdf",
});

const job = await client.documents.extract({
  source: workspaceFile(file),
  schema: { type: "object", properties: { total: { type: "number" } } },
  wait_seconds: 60,
});

await client.jobs.list({ limit: 20, operation: "parse", status: "succeeded" });
for await (const job of client.jobs.iter()) { /* ... */ }
for await (const event of client.jobs.events(jobId)) console.log(event.status);
const { url } = await client.jobs.fileLink(jobId, "parse-images/<ref>");
await client.jobs.delete(jobId);

const saved = await client.extractionSchemas.create({
  name: "invoice",
  description: "Invoice header fields",
  schema: {
    type: "object",
    properties: { invoice_number: { type: "string" }, total: { type: "number" } },
  },
});
await client.extractionSchemas.list({ limit: 20 });
await client.extractionSchemas.get(saved.schema_id);
await client.extractionSchemas.createVersion(saved.schema_id, {
  schema: {
    type: "object",
    properties: { invoice_number: { type: "string" }, total: { type: "number" }, due_date: { type: "string" } },
  },
});
await client.extractionSchemas.listVersions(saved.schema_id);