Quickstart

import { randomBytes, createHash, createHmac } from 'node:crypto';

const BASE_URL = process.env.PREUVE_AGENT_BASE_URL || 'https://preuve.ai';

function sha256Hex(value) {
  return createHash('sha256')
    .update(value || '')
    .digest('hex');
}

function canonicalQuery(searchParams) {
  const pairs = [...searchParams.entries()].filter(([k]) => k !== 'signature');
  pairs.sort((a, b) => a[0].localeCompare(b[0]) || a[1].localeCompare(b[1]));
  return pairs.map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(v)}`).join('&');
}

export async function signedFetch(method, path, bodyObject = null) {
  const url = new URL(path, BASE_URL);
  const body = bodyObject ? JSON.stringify(bodyObject) : '';
  const timestamp = new Date().toISOString();
  const nonce = randomBytes(16).toString('hex');
  const canonical = [
    method.toUpperCase(),
    url.pathname,
    canonicalQuery(url.searchParams),
    sha256Hex(body),
    timestamp,
    nonce,
  ].join('\n');
  const signature = `sha256=${createHmac('sha256', process.env.PREUVE_AGENT_SECRET)
    .update(canonical)
    .digest('hex')}`;

  const response = await fetch(url, {
    method,
    headers: {
      'content-type': 'application/json',
      'x-preuve-key': process.env.PREUVE_AGENT_KEY,
      'x-preuve-timestamp': timestamp,
      'x-preuve-nonce': nonce,
      'x-preuve-signature': signature,
    },
    body: body || undefined,
  });
  return response.json();
}

import { signedFetch } from './signedFetch.mjs';

const run = await signedFetch('POST', '/api/agent/analyses', {
  clientRunId: 'my-run-001',
  scanType: 'free',
  idea: 'A scheduling assistant that helps independent coffee shops coordinate weekly local supplier orders with lower waste.',
  targetMarket: 'Independent coffee shops',
  targetCountry: 'US',
  enrichmentMode: 'core',
  publish: true,
});

console.log(run.id, run.status);