Aller au contenu

TypeScript Universel & Core

Le package @unschema-graph/core fournit un moteur autonome et indépendant de tout framework frontend. L’export racine est utilisable en navigateur et testé principalement sous Node, avec un support best-effort pour Bun et Deno ; @unschema-graph/core/audit est quant à lui strictement réservé à Node.

pnpm

Fenêtre de terminal
pnpm add @unschema-graph/core zod

npm

Fenêtre de terminal
npm install @unschema-graph/core zod

yarn

Fenêtre de terminal
yarn add @unschema-graph/core zod

bun

Fenêtre de terminal
bun add @unschema-graph/core zod

Le moteur transforme vos entités typées en JSON-LD sécurisé via deux fonctions majeures : buildJsonLdGraph et serializeJsonLd.

import {
Article,
Organization,
buildJsonLdGraph,
serializeJsonLd,
} from '@unschema-graph/core';
// 1. Instanciation des entités typées et validées par Zod
const org = Organization({
'@id': '#organization',
name: 'Acme Corp',
url: 'https://mon-site.fr',
});
const article = Article({
headline: 'Schema.org universel avec Node.js',
image: 'https://mon-site.fr/cover.jpg',
datePublished: 'today',
author: 'Ada Lovelace',
publisher: '#organization',
});
// 2. Résolution des @id relatifs et création du @graph unifié
const graphPayload = buildJsonLdGraph([org, article], {
baseUrl: 'https://mon-site.fr',
graph: true,
});
// 3. Sérialisation Unicode sécurisée (protection anti-XSS)
const scriptContent = serializeJsonLd(graphPayload, { pretty: true });
console.log(scriptContent);
{
"@context": "https://schema.org",
"@graph": [
{
"@type": "Organization",
"@id": "https://mon-site.fr/#organization",
"name": "Acme Corp",
"url": "https://mon-site.fr"
},
{
"@type": "Article",
"headline": "Schema.org universel avec Node.js",
"image": "https://mon-site.fr/cover.jpg",
"datePublished": "2026-09-29T00:00:00.000Z",
"author": {
"@type": "Person",
"name": "Ada Lovelace"
},
"publisher": {
"@id": "https://mon-site.fr/#organization"
}
}
]
}

Vous pouvez définir les options de validation partagées et les valeurs par défaut des intégrations dès l’initialisation de votre application. buildJsonLdGraph() ne lit pas automatiquement baseUrl dans cette configuration ; transmettez-la dans GraphOptions lorsque vous composez un graphe avec Core.

import { setGlobalConfig } from '@unschema-graph/core';
setGlobalConfig({
onError: process.env.NODE_ENV === 'production' ? 'throw' : 'warn',
baseUrl: 'https://mon-site.fr',
});

Pour consulter ou réinitialiser la configuration :

import { getGlobalConfig, resetGlobalConfig } from '@unschema-graph/core';
const current = getGlobalConfig();
resetGlobalConfig();