Calcul de scores d'anomalie et conversions astronomiques

⚠️ AVERTISSEMENT BÊTA

Cette API est en version bêta. Ne l'utilisez PAS pour des applications cliniques, critiques ou de sécurité.
Usage recommandé : Recherche et expérimentation uniquement.

Installation

npm install @thibeq/sdk

Démarrage rapide

import { ThibEqClient } from '@thibeq/sdk';

// Initialiser le client
const client = new ThibEqClient({
  baseUrl: 'http://api.thibequation.com',
  apiKey: 'your-api-key'
});

// Calculer un score ThibEquation
const result = await client.score({
  G: 0.6,  // Facteur Géométrique/Physique
  K: 0.7,  // Facteur Contextuel
  S: 0.4,  // Facteur Documentation
  C: 0.5   // Coefficient Fiabilité Témoin
});
console.log(`ThibScore: ${result.thibscore}`);

// Convertir des coordonnées astronomiques
const coords = await client.convert({
  lat: 46.03,
  lon: -73.11,
  utc: '2025-11-03T21:15:00Z',
  az: 257.3,
  alt: 42.1
});
console.log(`RA: ${coords.ra_h}h, Dec: ${coords.dec_deg}°`);

Fonctionnalités

Calcul de Score ThibEquation

La formule ThibEquation quantifie l'anomalie d'une observation :

ThibScore = (G × w_G + K × w_K + S × w_S) × C × 100

• G (0-1): Facteur Géométrique/Physique
• K (0-1): Facteur Contextuel
• S (0-1): Facteur Documentation
• C (0-1): Coefficient Fiabilité Témoin

Conversion de Coordonnées

Convertit des coordonnées horizontales (Azimut/Altitude) en coordonnées équatoriales (RA/Dec) avec calcul du Temps Sidéral Local (LST).

Gestion des Erreurs

Le SDK inclut des exceptions personnalisées :

import {
  ThibEqError,
  ThibEqAuthError,
  ThibEqValidationError,
  ThibEqNetworkError
} from '@thibeq/sdk';

try {
  const result = await client.score({
    G: 0.6, K: 0.7, S: 0.4, C: 0.5
  });
} catch (error) {
  if (error instanceof ThibEqAuthError) {
    console.error('Authentification échouée');
  } else if (error instanceof ThibEqValidationError) {
    console.error('Paramètres invalides:', error.message);
  } else if (error instanceof ThibEqNetworkError) {
    console.error('Erreur réseau:', error.message);
  }
}

Configuration Avancée

const client = new ThibEqClient({
  baseUrl: 'http://localhost:5000',
  apiKey: 'your-key',
  timeout: 10000,     // Timeout en ms (défaut: 5000)
  maxRetries: 3       // Tentatives en cas d'erreur 502/503 (défaut: 1)
});

Usage en CommonJS

const { ThibEqClient } = require('@thibeq/sdk');

const client = new ThibEqClient({
  baseUrl: 'http://localhost:5000',
  apiKey: 'your-key'
});

client.score({ G: 0.6, K: 0.7, S: 0.4, C: 0.5 })
  .then(result => console.log(result))
  .catch(error => console.error(error));

Développement

Installation des dépendances

npm install

Tests

# Tests unitaires
npm test

# Tests en mode watch
npm run test:watch

# Smoke test (nécessite une API en cours d'exécution)
npm run test:smoke

Linting et formatage

# Vérifier le code
npm run lint

# Corriger automatiquement
npm run lint:fix

# Vérifier le formatage
npm run format:check

# Formater le code
npm run format

Build

# Construire le package (CJS + types)
npm run build

Documentation

• Repository: https://github.com/Thib4204/thibequation-api
• Issues: https://github.com/Thib4204/thibequation-api/issues

Citation

Si vous utilisez ce SDK dans vos recherches, veuillez citer :

Thibodeau, Pascal. (2025). THIBEQUATION – Certificat de complétion 2025 (v4.0). Zenodo.

@software{thibodeau_thibequation_2025,
  author       = {Thibodeau, Pascal},
  title        = {THIBEQUATION – Certificat de complétion 2025 (v4.0)},
  year         = 2025,
  publisher    = {Zenodo},
  doi          = {10.5281/zenodo.17510899},
  url          = {https://doi.org/10.5281/zenodo.17510899}
}

Licence

MIT License - Voir le fichier LICENSE pour plus de détails.

Auteur

Pascal Thibodeau (Thib4204)

ThibEquation SDK JavaScript v0.1.0

⚠️ API en bêta - Pas d'usage clinique/critique