Lancement BaaS : SDK, CLI et facturation
Ontologie passe d'une plateforme visuelle a un runtime programmatique complet. Le SDK TypeScript, la CLI et le systeme de facturation DFU sont maintenant disponibles en preview publique.
Ce qui change
SDK TypeScript (@ontologie/sdk-client)
Un client type-safe pour integrer Ontologie dans vos applications :
import { createClient } from '@ontologie/sdk-client';
const client = createClient({
baseUrl: 'https://api.ontologie-growthsystemes.com',
apiKey: process.env.ONTOLOGIE_API_KEY,
workspaceId: 'votre-workspace-id',
});
// Requete avec filtres
const contracts = await client.ontology.query('Contract', {
filter: { status: { eq: 'active' }, amount: { gt: 10000 } },
orderBy: { field: 'amount', direction: 'desc' },
});
// Action gouvernee (dry-run → apply)
const plan = await client.actions.dryRun('Contract.approve', {
targetId: contracts.data[0].id,
});
await client.actions.apply(plan.planId, {
confirmed: true,
riskAcknowledged: true,
});
Schema DSL (@ontologie/schema)
Definissez votre modele metier en TypeScript :
import { objectType, string, number, enumType, action, compile } from '@ontologie/schema';
const Status = enumType('Status', ['draft', 'active', 'archived']);
const Contract = objectType('Contract', {
title: string().required().indexed(),
amount: number().required(),
status: Status.default('draft').mutableBy(['Contract.approve']),
});
const Approve = action('Contract.approve')
.when({ status: { eq: 'draft' } })
.risk('medium')
.roles(['manager']);
export default compile({ types: [Contract], actions: [Approve] });
CLI (@ontologie/cli)
30+ commandes pour le workflow developpeur :
npx ontologie schema push # Pousser le schema
npx ontologie schema diff # Voir les differences
npx ontologie query Contract # Requeter en CLI
npx ontologie actions dry-run Contract.approve --target $ID
npx ontologie actions apply --plan-id $PLAN_ID --confirm
Facturation DFU
- Gratuit localement : prototypez avec le mock-server sans compte
- Prepaid en cloud : achetez des packs DFU (a partir de $30 / 200K DFU)
- Pas d'abonnement : payez uniquement ce que vous consommez
- Budget controls : plafonds mensuels, quotidiens et par commande
Securite
Toute mutation passe par un plan signe : dry-run → inspection → apply. Chaque plan est :
- Signe cryptographiquement (HMAC)
- Lie a un actor specifique
- Expire selon le niveau de risque (1h / 24h / 7j)
- Verifie contre le schema actuel
Documentation
La nouvelle section SDK & CLI couvre :
- Schema DSL — Declarer vos entites et actions
- Requetes — ObjectSet, filtres, graphe
- Plans et Actions — Cycle de vie des mutations
- Erreurs — Codes et remediations
- Facturation — DFU, quotas, budgets
- Cas d'usage — 6 scenarios metier detailles
Prochaines etapes
- SDK TypeScript — Commencer
- Facturation — Comprendre les DFU
- Quickstart — Premier appel en 10 minutes