SDK TypeScript

En bref

Le SDK TypeScript permet d'integrer Ontologie dans vos applications de maniere programmatique et type-safe. Accedez a l'ensemble de la plateforme — ontologie, agents, knowledge, workflows, calendrier, dashboards, gouvernance, spreadsheets — avec un typage complet genere depuis votre modele.

Inspire du pattern OSDK : requetes lazy, types generes, subscriptions temps reel.

Ce que vous allez faire

• Installer le SDK et generer les types depuis votre ontologie
• Interroger et manipuler vos entites avec un builder type-safe
• Recevoir des mises a jour en temps reel via WebSocket
• Integrer l'agent IA, la knowledge base et les workflows dans vos apps
• Construire des interfaces React avec les hooks fournis

Packages

Le SDK est compose de 6 packages :

Package	Description
@dataforge/sdk-types	Types runtime purs — interfaces, erreurs, streaming. Zero dependance.
@dataforge/sdk-client	Client HTTP + WebSocket — createClient(), ObjectSet, CRUD, namespaces.
@dataforge/sdk-generator	CLI — genere les types TypeScript depuis le manifeste de l'ontologie.
@dataforge/react	Hooks React bases sur TanStack Query — useObjectSet, useAgent, etc.
@dataforge/oauth	OAuth2 PKCE — authentification browser-safe sans client secret.
@dataforge/sdk-python	Generateur Python — models Pydantic + client httpx.

Dependances entre packages

@dataforge/sdk-types          (zero deps)
       ^
       |
@dataforge/sdk-client          (depends on sdk-types)
       ^
       |  peer dep
@dataforge/react               (peer deps: react, @tanstack/react-query, sdk-client)

@dataforge/oauth               (standalone)
@dataforge/sdk-generator       (standalone)
@dataforge/sdk-python          (standalone)

Documentation complete

Portail Client
La documentation complete du SDK (quickstart, client, requetes, hooks React, Python, temps reel) est disponible sur le Portail Client.

Contactez votre interlocuteur commercial ou ecrivez a support@growthsystemes.com pour obtenir vos identifiants d'acces.

Compatibilite

Environnement	Requis
Node.js	>= 18
Navigateur	Tous (fetch natif requis)
TypeScript	>= 5.0 (recommande)
React	>= 18 (pour @dataforge/react)
Python	>= 3.9 (pour le SDK Python genere)

Resultat attendu

A la fin de ce parcours, vous disposerez d'un SDK type-safe connecte a votre ontologie, avec des types generes automatiquement, des requetes fluides et des mises a jour temps reel. Vos applications pourront lire, ecrire et reagir aux changements de donnees de maniere programmatique.

Besoin d'aide ?

Ecrivez-nous : Support et contact.