@linklabjs/core 0.1.0 → 0.1.2

package/dist/http/plugin.js

@@ -0,0 +1,217 @@
+/**
+ * LinkLab Fastify Plugin
+ *
+ * Transforme automatiquement chaque requête HTTP en Trail,
+ * résout la navigation via le graphe, et retourne une réponse
+ * HATEOAS Level 3 — liens générés automatiquement depuis le graphe.
+ *
+ * Usage minimal :
+ * ```typescript
+ * import Fastify from 'fastify'
+ * import { linklabPlugin } from '@linklab/http'
+ *
+ * const fastify = Fastify()
+ * await fastify.register(linklabPlugin, {
+ *   graph:  compiledGraph,
+ *   prefix: '/api'
+ * })
+ * await fastify.listen({ port: 3000 })
+ * ```
+ *
+ * Toutes ces routes fonctionnent sans configuration supplémentaire :
+ *   GET /api/people
+ *   GET /api/people/Nolan
+ *   GET /api/people/Nolan/movies
+ *   GET /api/people/Nolan/movies/1/actors
+ *
+ * Hooks disponibles sur chaque requête :
+ * ```typescript
+ * fastify.register(linklabPlugin, {
+ *   graph,
+ *   onEngine: (engine, req) => {
+ *     engine.hooks.on('access.check', async (ctx) => {
+ *       if (!ctx.trail.user.userId) {
+ *         return { cancelled: true, reason: 'unauthenticated' }
+ *       }
+ *     })
+ *   }
+ * })
+ * ```
+ */
+import fp from 'fastify-plugin';
+import { TrailParser } from '../navigation/TrailParser.js';
+import { NavigationEngine } from '../navigation/NavigationEngine.js';
+import { LinkBuilder } from './LinkBuilder.js';
+import { DataLoader } from '../runtime/DataLoader.js';
+import { defaultUserExtractor, } from './TrailRequest.js';
+// ── Helper — vérifie qu'un node est exposé ───────────────────
+// Un node sans flag exposed (graphe ancien) est considéré exposé
+// pour assurer la rétrocompatibilité.
+// Un node avec exposed: false est bloqué.
+function isExposed(graph, entity) {
+    const node = graph.nodes.find(n => n.id === entity);
+    if (!node)
+        return false;
+    // Rétrocompatibilité : si exposed n'est pas défini, on expose
+    if (node.exposed === undefined)
+        return true;
+    return node.exposed === true;
+}
+// ── Plugin ────────────────────────────────────────────────────
+const linklabPluginImpl = async (fastify, options) => {
+    const { graph, prefix = '', global = {}, extractUser = defaultUserExtractor, onEngine, dataLoader, transformData, } = options;
+    const linkBuilder = new LinkBuilder(graph, { prefix });
+    // compiledGraph peut être passé séparément (semantic graph + compiled graph distincts)
+    // ou graph peut lui-même être un CompiledGraph (avec .routes)
+    const effectiveCompiled = options.compiledGraph
+        ?? ('routes' in graph && Array.isArray(graph.routes) ? graph : null);
+    const loader = (dataLoader && effectiveCompiled)
+        ? new DataLoader(effectiveCompiled, dataLoader)
+        : null;
+    if (dataLoader && !effectiveCompiled) {
+        fastify.log.warn('[LinkLab] dataLoader ignoré : graph doit être un CompiledGraph (avec .routes)');
+    }
+    // ── Décorer chaque request avec trail + linkBuilder ─────────
+    fastify.decorateRequest('trail', null);
+    fastify.decorateRequest('linkBuilder', null);
+    // ── Hook preHandler — parse le Trail avant chaque requête ───
+    fastify.addHook('preHandler', async (req) => {
+        const userCtx = await extractUser(req);
+        const rawPath = req.url.split('?')[0];
+        const path = prefix ? rawPath.replace(new RegExp(`^${prefix}`), '') : rawPath;
+        const trail = TrailParser.fromPath(path, {
+            global: { ...global },
+            user: userCtx,
+        });
+        req.trail = trail;
+        req.linkBuilder = linkBuilder;
+    });
+    // ── Routes génériques — capture tous les paths ─────────────
+    const routePath = prefix ? `${prefix}/*` : '/*';
+    const rootPath = prefix || '/';
+    // Route pour le prefix exact ex: GET /api
+    fastify.get(rootPath, async (req, reply) => {
+        const links = buildRootLinks(graph, prefix);
+        return { data: null, _links: links, _trail: '', _meta: { entity: 'root', depth: 0, resolved: 0, timing: 0 } };
+    });
+    fastify.get(routePath, async (req, reply) => {
+        const trail = req.trail;
+        const start = Date.now();
+        // Trail vide = index — retourner les nœuds racines du graphe
+        if (trail.depth === 0) {
+            const rootLinks = buildRootLinks(graph, prefix);
+            return {
+                data: null,
+                _links: rootLinks,
+                _trail: '',
+                _meta: { entity: 'root', depth: 0, resolved: 0, timing: Date.now() - start },
+            };
+        }
+        // ── Vérifier que toutes les frames du Trail pointent vers des nodes exposés
+        // On vérifie chaque entité du Trail — si l'une est non exposée → 404.
+        // Cela couvre aussi les vues sémantiques : leur entité cible résolue
+        // est vérifiée au moment de la résolution du Trail.
+        for (const frame of trail.frames) {
+            if (!isExposed(graph, frame.entity)) {
+                reply.code(404);
+                return reply.send({
+                    error: 'NOT_FOUND',
+                    reason: `Entity '${frame.entity}' is not exposed`,
+                    _trail: TrailParser.toFluent(trail),
+                });
+            }
+        }
+        // ── Créer le moteur de navigation ─────────────────────────
+        const engine = NavigationEngine.forNavigation(graph, { trail });
+        // Laisser Netflix (ou tout autre app) brancher ses hooks
+        if (onEngine) {
+            await onEngine(engine, req);
+        }
+        // ── Résoudre le Trail ─────────────────────────────────────
+        const results = await engine.run(trail.depth + 1);
+        const lastResult = results[results.length - 1];
+        // ── Gérer les erreurs de navigation ───────────────────────
+        if (lastResult?.result?.type === 'FAIL') {
+            const reason = lastResult.result.reason ?? 'Navigation failed';
+            if (reason.includes('notfound') || reason.includes('Aucun chemin')) {
+                reply.code(404);
+                return reply.send({
+                    error: 'NOT_FOUND',
+                    reason,
+                    _trail: TrailParser.toFluent(trail),
+                });
+            }
+            if (reason.includes('forbidden') || reason.includes('denied') || reason.includes('unauthenticated')) {
+                reply.code(403);
+                return reply.send({
+                    error: 'FORBIDDEN',
+                    reason,
+                    _trail: TrailParser.toFluent(trail),
+                });
+            }
+            reply.code(400);
+            return reply.send({
+                error: 'BAD_REQUEST',
+                reason,
+                _trail: TrailParser.toFluent(trail),
+            });
+        }
+        // ── Charger les données via DataLoader ───────────────────
+        if (loader) {
+            await loader.load(engine.trail);
+        }
+        // ── Récupérer les données de la frame courante ────────────
+        const current = engine.trail.current;
+        const rawData = current?.data ?? null;
+        const data = transformData ? transformData(rawData, engine.trail) : rawData;
+        // ── Générer les liens HATEOAS ─────────────────────────────
+        const links = linkBuilder.from(engine.trail);
+        // Si data est une liste, enrichir chaque item avec ses liens
+        const isCollection = Array.isArray(data);
+        let responseData = data;
+        if (isCollection && data.length > 0) {
+            const itemLinks = linkBuilder.forItems(engine.trail, data);
+            responseData = data.map((item, i) => ({
+                ...item,
+                _links: itemLinks[i],
+            }));
+        }
+        // ── Construire la réponse ─────────────────────────────────
+        const resolved = engine.trail.frames.filter(f => f.state === 'RESOLVED').length;
+        return {
+            data: responseData,
+            _links: links,
+            _trail: TrailParser.toFluent(engine.trail),
+            _meta: {
+                entity: current?.entity ?? '',
+                depth: engine.trail.depth,
+                resolved,
+                timing: Date.now() - start,
+                count: isCollection ? data.length : undefined,
+            },
+        };
+    });
+};
+// ── Helper — liens racines ────────────────────────────────────
+// Filtre les nodes non exposés des liens racines.
+function buildRootLinks(graph, prefix) {
+    const hasIncoming = new Set(graph.edges.map(e => e.to));
+    const roots = graph.nodes.filter(n => !hasIncoming.has(n.id) && isExposed(graph, n.id));
+    const links = {
+        self: { href: prefix || '/', method: 'GET' }
+    };
+    for (const node of roots) {
+        links[node.id] = {
+            href: `${prefix}/${node.id}`,
+            method: 'GET',
+            rel: node.id,
+        };
+    }
+    return links;
+}
+// ── Export avec fastify-plugin (preserve encapsulation) ───────
+export const linklabPlugin = fp(linklabPluginImpl, {
+    fastify: '4.x || 5.x',
+    name: 'linklab',
+});
+//# sourceMappingURL=plugin.js.map

package/dist/http/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/http/plugin.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @linklab/core — Point d'entrée public
+ *
+ * Trois zones d'export, du plus utilisé au plus technique :
+ *
+ *   ┌─────────────────────────────────────────────────────────┐
+ *   │  API  — ce que 80% des utilisateurs importent           │
+ *   │  BUILD — pipeline schema → graph (setup, CI)            │
+ *   │  HTTP  — plugin Fastify HATEOAS (optionnel)             │
+ *   │  ADVANCED — internals pour extensions et tests          │
+ *   └─────────────────────────────────────────────────────────┘
+ *
+ * Usage typique :
+ *
+ *   import { Graph, Strategy } from '@linklab/core'
+ *
+ *   const cinema = new Graph(graphJson, { compiled, dataset }).domain()
+ *   const cast   = await cinema.movies(278).people
+ *   const route  = cinema.from('Pigalle').to('Alesia').path(Strategy.Comfort())
+ */
+export { Graph } from './api/Graph.js';
+export { Strategy } from './api/types.js';
+export type { PathResult, ResolvedPath, PathStep, QueryResult, PathBuilderOptions } from './api/types.js';
+export { PathBuilder } from './api/PathBuilder.js';
+export { SchemaExtractor } from './schema/SchemaExtractor.js';
+export { JsonSchemaExtractor } from './schema/JsonSchemaExtractor.js';
+export { SchemaAnalyzer } from './schema/SchemaAnalyzer.js';
+export { GraphBuilder } from './schema/GraphBuilder.js';
+export { GraphAssembler } from './graph/GraphAssembler.js';
+export { GraphCompiler } from './graph/GraphCompiler.js';
+export { GraphTrainer } from './graph/GraphTrainer.js';
+export { GraphOptimizer } from './graph/GraphOptimizer.js';
+export { GraphExtractor } from './graph/GraphExtractor.js';
+export { linklabPlugin } from './http/plugin.js';
+export { LinkBuilder } from './http/LinkBuilder.js';
+export type { LinklabPluginOptions } from './http/plugin.js';
+export { NavigationEngine } from './navigation/NavigationEngine.js';
+export { Resolver } from './navigation/Resolver.js';
+export { Scheduler } from './navigation/Scheduler.js';
+export { Trail } from './navigation/Trail.js';
+export { TrailParser } from './navigation/TrailParser.js';
+export { QueryEngine } from './runtime/QueryEngine.js';
+export { Engine } from './runtime/Engine.js';
+export { DataLoader } from './runtime/DataLoader.js';
+export { PostgresProvider } from './providers/PostgresProvider.js';
+export { MockProvider } from './providers/MockProvider.js';
+export type { PathFormatter } from './formatters/BaseFormatter.js';
+export { PathFinder } from './core/PathFinder.js';
+export type { Graph as GraphData, // renommé pour éviter le conflit avec la classe Graph
+GraphNode, GraphEdge, CompiledGraph, RouteInfo, Dictionary, Frame, Path, PathQuery } from './types/index.js';
+export type { MetricsMap, TrainingMetrics, UseCase } from './types/index.js';
+export { injectTelemetry, resetTelemetry, preloadTelemetry, shim } from './instrumentation/TelemetryShim.js';
+export type { TelemetryModule } from './instrumentation/TelemetryShim.js';
+export type { ExposeConfig } from './types/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAOH,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,YAAY,EACV,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,kBAAkB,EACnB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAQlD,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAQ1D,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AACnD,YAAY,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AAQ5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAGzD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAGpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAG1D,YAAY,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAGlE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAOjD,YAAY,EACV,KAAK,IAAI,SAAS,EAAE,sDAAsD;AAC1E,SAAS,EACT,SAAS,EACT,aAAa,EACb,SAAS,EACT,UAAU,EACV,KAAK,EACL,IAAI,EACJ,SAAS,EACV,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EAAE,UAAU,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAG5E,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,IAAI,EACL,MAAM,oCAAoC,CAAA;AAC3C,YAAY,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAA;AAEzE,YAAY,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,71 @@
+/**
+ * @linklab/core — Point d'entrée public
+ *
+ * Trois zones d'export, du plus utilisé au plus technique :
+ *
+ *   ┌─────────────────────────────────────────────────────────┐
+ *   │  API  — ce que 80% des utilisateurs importent           │
+ *   │  BUILD — pipeline schema → graph (setup, CI)            │
+ *   │  HTTP  — plugin Fastify HATEOAS (optionnel)             │
+ *   │  ADVANCED — internals pour extensions et tests          │
+ *   └─────────────────────────────────────────────────────────┘
+ *
+ * Usage typique :
+ *
+ *   import { Graph, Strategy } from '@linklab/core'
+ *
+ *   const cinema = new Graph(graphJson, { compiled, dataset }).domain()
+ *   const cast   = await cinema.movies(278).people
+ *   const route  = cinema.from('Pigalle').to('Alesia').path(Strategy.Comfort())
+ */
+// ══════════════════════════════════════════════════════════════
+//  API — Surface publique principale
+//  import { Graph, Strategy } from '@linklab/core'
+// ══════════════════════════════════════════════════════════════
+export { Graph } from './api/Graph.js';
+export { Strategy } from './api/types.js';
+// PathBuilder est retourné par graph.from() — exposé pour le typage
+export { PathBuilder } from './api/PathBuilder.js';
+// ══════════════════════════════════════════════════════════════
+//  BUILD — Pipeline schema → graph
+//  Usage : scripts de génération, CI, pipeline.ts
+//  import { SchemaExtractor, GraphCompiler } from '@linklab/core/build'
+// ══════════════════════════════════════════════════════════════
+export { SchemaExtractor } from './schema/SchemaExtractor.js';
+export { JsonSchemaExtractor } from './schema/JsonSchemaExtractor.js';
+export { SchemaAnalyzer } from './schema/SchemaAnalyzer.js';
+export { GraphBuilder } from './schema/GraphBuilder.js';
+export { GraphAssembler } from './graph/GraphAssembler.js';
+export { GraphCompiler } from './graph/GraphCompiler.js';
+export { GraphTrainer } from './graph/GraphTrainer.js';
+export { GraphOptimizer } from './graph/GraphOptimizer.js';
+export { GraphExtractor } from './graph/GraphExtractor.js';
+// ══════════════════════════════════════════════════════════════
+//  HTTP — Plugin Fastify HATEOAS
+//  Usage : apps serveur
+//  import { linklabPlugin } from '@linklab/core'
+// ══════════════════════════════════════════════════════════════
+export { linklabPlugin } from './http/plugin.js';
+export { LinkBuilder } from './http/LinkBuilder.js';
+// ══════════════════════════════════════════════════════════════
+//  ADVANCED — Internals pour extensions, providers, tests
+//  Stable mais sans garantie de compatibilité entre versions
+// ══════════════════════════════════════════════════════════════
+// Moteur de navigation bas niveau
+export { NavigationEngine } from './navigation/NavigationEngine.js';
+export { Resolver } from './navigation/Resolver.js';
+export { Scheduler } from './navigation/Scheduler.js';
+export { Trail } from './navigation/Trail.js';
+export { TrailParser } from './navigation/TrailParser.js';
+// Runtime
+export { QueryEngine } from './runtime/QueryEngine.js';
+export { Engine } from './runtime/Engine.js';
+export { DataLoader } from './runtime/DataLoader.js';
+// Providers
+export { PostgresProvider } from './providers/PostgresProvider.js';
+export { MockProvider } from './providers/MockProvider.js';
+// PathFinder — algorithme Dijkstra brut
+export { PathFinder } from './core/PathFinder.js';
+// ── Instrumentation — opt-in telemetry bridge ─────────────────────────────
+export { injectTelemetry, resetTelemetry, preloadTelemetry, shim } from './instrumentation/TelemetryShim.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,iEAAiE;AACjE,qCAAqC;AACrC,mDAAmD;AACnD,iEAAiE;AAEjE,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAA;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AASzC,oEAAoE;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAElD,iEAAiE;AACjE,mCAAmC;AACnC,kDAAkD;AAClD,wEAAwE;AACxE,iEAAiE;AAEjE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAA;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAA;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAE1D,iEAAiE;AACjE,iCAAiC;AACjC,wBAAwB;AACxB,iDAAiD;AACjD,iEAAiE;AAEjE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAGnD,iEAAiE;AACjE,0DAA0D;AAC1D,6DAA6D;AAC7D,iEAAiE;AAEjE,kCAAkC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAA;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAA;AACnD,OAAO,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AACrD,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAEzD,UAAU;AACV,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAEpD,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAK1D,wCAAwC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAqBjD,6EAA6E;AAC7E,OAAO,EACL,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,IAAI,EACL,MAAM,oCAAoC,CAAA"}

package/dist/instrumentation/TelemetryShim.d.ts

@@ -0,0 +1,114 @@
+/**
+ * TelemetryShim.ts — Pont opt-in entre @linklab/core et @linklab/telemetry
+ *
+ * @linklab/core ne dépend PAS de @linklab/telemetry.
+ *
+ * Deux modes d'activation :
+ *
+ * 1. INJECTION (recommandé, toujours fiable) :
+ *    L'appelant qui connaît les deux packages injecte les modules directement.
+ *    Utilisé dans les tests (@linklab/telemetry) et en production (Netflix-backend).
+ *
+ *      import { injectTelemetry } from '@linklab/core'
+ *      import { SpanBuilder, traceBus } from '@linklab/telemetry'
+ *      injectTelemetry({ SpanBuilder, traceBus })
+ *
+ * 2. PRELOAD (production uniquement) :
+ *    Import dynamique — fonctionne si @linklab/telemetry est installé ET
+ *    accessible depuis le même module resolver que @linklab/core.
+ *    Ne pas utiliser dans les tests (résolution cross-package impossible sous Vitest).
+ *
+ *      import { preloadTelemetry } from '@linklab/core'
+ *      await preloadTelemetry()
+ *
+ * Sans activation → toutes les opérations sont des no-ops silencieux.
+ */
+interface MinimalSpanBuilder {
+    stepStart(step: string): this;
+    stepEnd(step: string): this;
+    addCacheEvent(event: {
+        level: 'L1' | 'L2' | 'MISS';
+        hit: boolean;
+        entity?: string;
+        promoted: boolean;
+        yoyo?: boolean;
+    }): this;
+    end(opts: {
+        rowCount: number;
+    }): MinimalSpan;
+    endWithError(err: Error, state: MinimalEngineState): MinimalSpan;
+    withPath?(path: string[]): this;
+    withFilters?(filters: Record<string, any>): this;
+    readonly routeKey: string;
+}
+interface MinimalSpan {
+    spanId: string;
+    traceId: string;
+    timestamp: number;
+    trail: string;
+    from: string;
+    to: string;
+    path: string[];
+    filters: Record<string, any>;
+    timings: any[];
+    totalMs: number;
+    cacheEvents: any[];
+    rowCount: number;
+    error?: any;
+    metrics?: any;
+}
+interface MinimalEngineState {
+    compiledGraphHash: string;
+    weights: Record<string, number>;
+    cacheState: {
+        l1HitRate: number;
+        l2HitRate: number;
+        globalHitRate: number;
+        yoyoEvents: number;
+    };
+}
+export interface TelemetryModule {
+    SpanBuilder: {
+        start(opts: {
+            trail: string;
+            from: string;
+            to: string;
+            traceId?: string;
+        }): MinimalSpanBuilder;
+    };
+    traceBus: {
+        emit(event: 'span:end' | 'span:error', span: MinimalSpan): void;
+    };
+}
+/**
+ * Injecte les composants de @linklab/telemetry dans le shim.
+ * Méthode universelle — fonctionne dans tous les contextes (tests, prod).
+ * Prend effet immédiatement et de manière synchrone.
+ */
+export declare function injectTelemetry(module: TelemetryModule): void;
+/**
+ * Réinitialise le shim — utile pour les tests d'isolation.
+ */
+export declare function resetTelemetry(): void;
+/**
+ * Précharge le module telemetry via import dynamique.
+ * Uniquement pour la production (Netflix-backend) où les deux packages
+ * partagent le même module resolver Node.js.
+ * Ne pas utiliser dans les tests — préférer injectTelemetry().
+ */
+export declare function preloadTelemetry(): Promise<void>;
+export declare const shim: {
+    startSpan(opts: {
+        trail: string;
+        from: string;
+        to: string;
+        traceId?: string;
+        path?: string[];
+        filters?: Record<string, any>;
+    }): MinimalSpanBuilder | null;
+    emitEnd(span: MinimalSpan): void;
+    emitError(span: MinimalSpan): void;
+    readonly active: boolean;
+};
+export type { MinimalSpanBuilder, MinimalSpan, MinimalEngineState };
+//# sourceMappingURL=TelemetryShim.d.ts.map

package/dist/instrumentation/TelemetryShim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryShim.d.ts","sourceRoot":"","sources":["../../src/instrumentation/TelemetryShim.ts"],"names":[],"mappings":"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"}

package/dist/instrumentation/TelemetryShim.js

@@ -0,0 +1,107 @@
+/**
+ * TelemetryShim.ts — Pont opt-in entre @linklab/core et @linklab/telemetry
+ *
+ * @linklab/core ne dépend PAS de @linklab/telemetry.
+ *
+ * Deux modes d'activation :
+ *
+ * 1. INJECTION (recommandé, toujours fiable) :
+ *    L'appelant qui connaît les deux packages injecte les modules directement.
+ *    Utilisé dans les tests (@linklab/telemetry) et en production (Netflix-backend).
+ *
+ *      import { injectTelemetry } from '@linklab/core'
+ *      import { SpanBuilder, traceBus } from '@linklab/telemetry'
+ *      injectTelemetry({ SpanBuilder, traceBus })
+ *
+ * 2. PRELOAD (production uniquement) :
+ *    Import dynamique — fonctionne si @linklab/telemetry est installé ET
+ *    accessible depuis le même module resolver que @linklab/core.
+ *    Ne pas utiliser dans les tests (résolution cross-package impossible sous Vitest).
+ *
+ *      import { preloadTelemetry } from '@linklab/core'
+ *      await preloadTelemetry()
+ *
+ * Sans activation → toutes les opérations sont des no-ops silencieux.
+ */
+// ── Registre interne ──────────────────────────────────────────────────────────
+let _module = null;
+let _attempted = false;
+// ── API d'injection ───────────────────────────────────────────────────────────
+/**
+ * Injecte les composants de @linklab/telemetry dans le shim.
+ * Méthode universelle — fonctionne dans tous les contextes (tests, prod).
+ * Prend effet immédiatement et de manière synchrone.
+ */
+export function injectTelemetry(module) {
+    _module = module;
+    _attempted = true; // bloquer tout preloadTelemetry() ultérieur
+}
+/**
+ * Réinitialise le shim — utile pour les tests d'isolation.
+ */
+export function resetTelemetry() {
+    _module = null;
+    _attempted = false;
+}
+/**
+ * Précharge le module telemetry via import dynamique.
+ * Uniquement pour la production (Netflix-backend) où les deux packages
+ * partagent le même module resolver Node.js.
+ * Ne pas utiliser dans les tests — préférer injectTelemetry().
+ */
+export async function preloadTelemetry() {
+    if (_attempted)
+        return;
+    _attempted = true;
+    try {
+        const specifier = '@linklab/telemetry';
+        const mod = await new Function('s', 'return import(s)')(specifier);
+        _module = mod;
+    }
+    catch {
+        _module = null;
+    }
+}
+// ── API du shim ───────────────────────────────────────────────────────────────
+export const shim = {
+    startSpan(opts) {
+        if (!_module)
+            return null;
+        try {
+            const builder = _module.SpanBuilder.start({
+                trail: opts.trail,
+                from: opts.from,
+                to: opts.to,
+                traceId: opts.traceId
+            });
+            if (opts.path)
+                builder.withPath?.(opts.path);
+            if (opts.filters)
+                builder.withFilters?.(opts.filters);
+            return builder;
+        }
+        catch {
+            return null;
+        }
+    },
+    emitEnd(span) {
+        if (!_module)
+            return;
+        try {
+            _module.traceBus.emit('span:end', span);
+        }
+        catch { }
+    },
+    emitError(span) {
+        if (!_module)
+            return;
+        try {
+            _module.traceBus.emit('span:error', span);
+        }
+        catch { }
+    },
+    get active() {
+        return _module !== null;
+    }
+};
+//# sourceMappingURL=TelemetryShim.js.map

package/dist/instrumentation/TelemetryShim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryShim.js","sourceRoot":"","sources":["../../src/instrumentation/TelemetryShim.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AA0DH,iFAAiF;AAEjF,IAAI,OAAO,GAA2B,IAAI,CAAA;AAC1C,IAAI,UAAU,GAAG,KAAK,CAAA;AAEtB,iFAAiF;AAEjF;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,MAAuB;IACrD,OAAO,GAAG,MAAM,CAAA;IAChB,UAAU,GAAG,IAAI,CAAA,CAAC,4CAA4C;AAChE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,GAAG,IAAI,CAAA;IACd,UAAU,GAAG,KAAK,CAAA;AACpB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB;IACpC,IAAI,UAAU;QAAE,OAAM;IACtB,UAAU,GAAG,IAAI,CAAA;IACjB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,oBAAoB,CAAA;QACtC,MAAM,GAAG,GAAG,MAAM,IAAI,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAAA;QAClE,OAAO,GAAG,GAAsB,CAAA;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,SAAS,CAAC,IAOT;QACC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAA;QACzB,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,KAAK,CAAC;gBACxC,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,OAAO,EAAE,IAAI,CAAC,OAAO;aACtB,CAAC,CAAA;YACF,IAAI,IAAI,CAAC,IAAI;gBAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC5C,IAAI,IAAI,CAAC,OAAO;gBAAE,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;YACrD,OAAO,OAAO,CAAA;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAA;QACb,CAAC;IACH,CAAC;IAED,OAAO,CAAC,IAAiB;QACvB,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,IAAI,CAAC;YACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;QACzC,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,SAAS,CAAC,IAAiB;QACzB,IAAI,CAAC,OAAO;YAAE,OAAM;QACpB,IAAI,CAAC;YACH,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAA;QAC3C,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IAED,IAAI,MAAM;QACR,OAAO,OAAO,KAAK,IAAI,CAAA;IACzB,CAAC;CACF,CAAA"}