Flutter et Dart

dart pub add valais_connect_gaspard     # projet Dart
flutter pub add valais_connect_gaspard  # application Flutter

import 'package:valais_connect_gaspard/valais_connect_gaspard.dart';

import 'package:flutter/material.dart';
import 'package:shared_preferences/shared_preferences.dart';
import 'package:valais_connect_gaspard/valais_connect_gaspard.dart';

const _tokenKey = 'gaspard_visitor_token';

final gaspard = GaspardClient(
  publishableKey: 'vcp_live_…',
  // Une origine déclarée pour la clé (ignorée sur Flutter web, où le navigateur l'envoie).
  origin: 'https://app.mon-ecole.ch',
);

class GaspardChat extends StatefulWidget {
  const GaspardChat({super.key});

  @override
  State<GaspardChat> createState() => _GaspardChatState();
}

class _GaspardChatState extends State<GaspardChat> {
  final _question = TextEditingController();
  String? _conversationId;
  String _answer = '';
  bool _busy = false;

  /// Restaure le jeton enregistré, ou demande le consentement et ouvre une session.
  Future<bool> _ensureSession() async {
    final prefs = await SharedPreferences.getInstance();
    final saved = prefs.getString(_tokenKey);
    if (saved != null) {
      gaspard.setVisitorToken(saved);
      final status = await gaspard.consent();
      if (status.given && status.upToDate) return true;
    }
    final notice = await gaspard.privacyNotice(locale: 'fr');
    if (!mounted) return false;
    final accepted = await showDialog<bool>(
      context: context,
      builder: (context) => AlertDialog(
        title: const Text('Confidentialité'),
        content: SingleChildScrollView(child: Text(notice.text)),
        actions: [
          TextButton(
            onPressed: () => Navigator.pop(context, false),
            child: const Text('Refuser'),
          ),
          FilledButton(
            onPressed: () => Navigator.pop(context, true),
            child: const Text('Accepter'),
          ),
        ],
      ),
    );
    if (accepted != true) return false;
    final session = await gaspard.openSession(consent: true, locale: 'fr');
    await prefs.setString(_tokenKey, session.token);
    return true;
  }

  Future<void> _send() async {
    final text = _question.text.trim();
    if (text.isEmpty || _busy) return;
    setState(() {
      _busy = true;
      _answer = '';
    });
    try {
      if (!await _ensureSession()) return;
      _conversationId ??= (await gaspard.startConversation(locale: 'fr')).id;
      await for (final event in gaspard.askStream(_conversationId!, text)) {
        switch (event) {
          case GaspardDelta(:final text):
            setState(() => _answer += text);
          case GaspardAnswerEvent(:final answer):
            setState(() => _answer = answer.text); // texte final, sources dans answer.sources
        }
      }
      _question.clear();
    } on GaspardException catch (error) {
      if (error.code == 'session_required' || error.status == 401) {
        // Jeton expiré ou effacé : on l'oublie, une nouvelle session sera ouverte.
        gaspard.setVisitorToken(null);
        (await SharedPreferences.getInstance()).remove(_tokenKey);
      }
      if (error.code == 'conversation_full') _conversationId = null;
      setState(() => _answer = error.isTransient
          ? 'Gaspard est très sollicité, réessayez dans un instant.'
          : 'Désolé, une erreur est survenue (${error.code}).');
    } finally {
      if (mounted) setState(() => _busy = false);
    }
  }

  @override
  Widget build(BuildContext context) => Column(
        children: [
          Expanded(child: SingleChildScrollView(child: Text(_answer))),
          TextField(
            controller: _question,
            maxLength: 2000,
            onSubmitted: (_) => _send(),
            decoration: InputDecoration(
              hintText: 'Votre question',
              suffixIcon: IconButton(
                icon: const Icon(Icons.send),
                onPressed: _busy ? null : _send,
              ),
            ),
          ),
        ],
      );
}

import 'dart:io';

import 'package:valais_connect_gaspard/valais_connect_gaspard.dart';

Future<void> main() async {
  final client = GaspardClient(apiKey: Platform.environment['GASPARD_API_KEY']);
  // Un client dérivé par utilisateur : seuls ses échanges lui sont visibles
  // (en-tête X-End-User ; seul un hachage à clé de l'identifiant est conservé).
  final gaspard = client.forEndUser('user-42');

  final conversation = await gaspard.startConversation(locale: 'fr', page: 'admissions');

  // Réponse complète…
  final answer = await gaspard.ask(conversation.id, 'Où étudier à Montréal ?');
  print(answer.text);

  // … ou au fil de l'écriture.
  await for (final event in gaspard.askStream(conversation.id, 'Et le logement ?')) {
    switch (event) {
      case GaspardDelta(:final text):
        stdout.write(text);
      case GaspardAnswerEvent(:final answer):
        print('\n${answer.listings.length} annonce(s), ${answer.remainingMessages} question(s) restantes');
    }
  }

  await gaspard.feedback(answer.messageId, GaspardRating.up);

  final found = await client.searchKnowledge(
    'Montréal universités',
    limit: 3,
    topics: [KnowledgeTopic.geography],
  );
  for (final passage in found.passages) {
    print('${passage.title} (${passage.score})');
  }

  client.close();
}

final gaspard = GaspardClient(apiKey: Platform.environment['VC_API_KEY']);

// Confiance : à la publication d'une annonce
final result = await gaspard.trust.assess([
  TrustListing(kind: 'housing', title: annonce.titre, description: annonce.texte,
      priceAmount: annonce.loyer, currency: 'XOF', countryCode: 'SN', city: 'Dakar'),
]);
if (result.assessments.first.withheld) {
  // à faire vérifier ; result.assessments.first.findings dit pourquoi
}

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

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

GaspardClient(
  apiKey: …,                 // ou publishableKey: … (exactement l'une des deux)
  origin: …,                 // clé publiable hors navigateur
  endUser: …,                // clé secrète : identifiant de votre utilisateur (1–128 caractères ASCII imprimables)
  baseUrl: Uri.parse('https://hubmix.dealmood-solutions.com'), // /v1/public est ajouté
  timeout: const Duration(seconds: 60),  // par requête ; pour un flux, jusqu'au début de la réponse
  maxRetries: 2,             // 0 pour désactiver les nouvelles tentatives
  userAgent: 'mon-app/2.1',  // défaut : gaspard-dart/1.1.0 (jamais envoyé dans un navigateur)
  httpClient: monClient,     // http.Client injecté (non fermé par close())
);