JavaScript et TypeScript

npm install @valais-connect/gaspard

import { Gaspard, GaspardError } from '@valais-connect/gaspard'; // ESM / TypeScript
const { Gaspard } = require('@valais-connect/gaspard');         // CommonJS

import express from 'express';
import { Gaspard, GaspardError } from '@valais-connect/gaspard';

const gaspard = new Gaspard({ apiKey: process.env.GASPARD_API_KEY! });
const app = express();
app.use(express.json());

app.post('/api/gaspard/conversations', async (req, res) => {
  const conversation = await gaspard.forEndUser(req.user.id).startConversation('fr', req.body.page);
  res.status(201).json(conversation);
});

app.post('/api/gaspard/conversations/:id/messages', async (req, res) => {
  try {
    const answer = await gaspard.forEndUser(req.user.id).ask(req.params.id, req.body.text);
    res.json(answer);
  } catch (error) {
    if (error instanceof GaspardError) {
      res.status(error.status || 502).json({ code: error.code, retryAfter: error.retryAfter });
    } else throw error;
  }
});

// app/api/gaspard/[id]/route.ts
import { Gaspard } from '@valais-connect/gaspard';

const gaspard = new Gaspard({ apiKey: process.env.GASPARD_API_KEY! });

export async function POST(request: Request, { params }: { params: Promise<{ id: string }> }) {
  const { id } = await params;
  const { text } = await request.json();
  const encoder = new TextEncoder();
  const body = new ReadableStream({
    async start(controller) {
      try {
        for await (const event of gaspard.askStream(id, text, undefined, { signal: request.signal })) {
          controller.enqueue(encoder.encode(JSON.stringify(event) + '\n'));
        }
        controller.close();
      } catch (error) {
        controller.error(error);
      }
    },
  });
  return new Response(body, { headers: { 'Content-Type': 'application/x-ndjson' } });
}

const forLea = gaspard.forEndUser('user-42');   // client dérivé, même configuration
await forLea.giveConsent(notice.version);       // après avoir montré la notice
await forLea.exportData();                      // droit d'accès
await forLea.eraseData();                       // droit à l'effacement
await gaspard.consent({ endUser: 'user-42' });  // ou appel par appel

import { Gaspard } from '@valais-connect/gaspard';

const gaspard = new Gaspard({ publishableKey: 'vcp_live_…' });

const saved = localStorage.getItem('gaspard-token');
if (saved) {
  gaspard.setVisitorToken(saved);
} else {
  const notice = await gaspard.privacyNotice('fr');
  if (!(await showNoticeAndAsk(notice.text))) throw new Error('Pas de consentement');
  const session = await gaspard.openSession({ consent: true, locale: 'fr', allowTraining: false });
  localStorage.setItem('gaspard-token', session.token);
}

const conversation = await gaspard.startConversation('fr', location.pathname.slice(0, 80));
const answer = await gaspard.ask(conversation.id, 'Que faire à Lyon ce week-end ?');

let text = '';
for await (const event of gaspard.askStream(conversation.id, 'Comment trouver un logement étudiant à Montréal ?')) {
  if (event.type === 'delta') {
    text += event.text;
    render(text);
  } else {
    showSources(event.answer.sources, event.answer.listings);
  }
}

const controller = new AbortController();
setTimeout(() => controller.abort(), 5000);
await gaspard.ask(id, 'Bonjour', undefined, { signal: controller.signal, requestId: 'commande-1234' });

const gaspard = new Gaspard({ apiKey: process.env.VC_API_KEY! });

// Confiance : une annonce suspecte avant de la publier
const { assessments } = await gaspard.trust.assess([
  { kind: 'housing', title: 'Studio centre-ville', description: 'Paiement par Western Union avant visite',
    priceAmount: 250, currency: 'EUR', countryCode: 'FR', city: 'Lyon', housingType: 'studio' },
]);
if (assessments[0]!.withheld) {
  // à faire vérifier par un modérateur ; assessments[0].findings dit pourquoi
}

// Tuteur : des cartes de révision
const { cards } = await gaspard.tutor.flashcards({
  lesson: { title: 'La photosynthèse', content: texteDuCours },
  count: 8,
  learner: { level: 'bachelor', countryCode: 'SN' },
  locale: 'fr',
});

// Embeddings : un vecteur par texte, dans le même ordre
const { embeddings, dimensions } = await gaspard.embeddings.create(['chambre à louer', 'room for rent']);

try {
  await gaspard.ask(id, question);
} catch (error) {
  if (error instanceof GaspardError && error.code === 'token_quota_exceeded') {
    console.warn(`Quota atteint, réessayer dans ${error.retryAfter} s (requête ${error.requestId})`);
  } else throw error;
}