@linklabjs/core 0.1.0 → 0.1.2

package/dist/navigation/TrailParser.js

@@ -0,0 +1,180 @@
+/**
+ * TrailParser — Désérialise des représentations externes vers un Trail
+ *
+ * Trois sources supportées :
+ *
+ *   URL path   →  /cinema/people/Nolan/movies/Interstellar/actors
+ *   URL fluent →  cinema.people(Nolan).movies(Interstellar).actors
+ *   JSON       →  SerializedTrail (via Trail.from)
+ *
+ * Le parser est stateless — toutes les méthodes sont statiques.
+ * Il ne valide pas les entités contre le graphe — c'est le rôle du moteur.
+ */
+import { Trail } from './Trail.js';
+export class TrailParser {
+    // ── URL Path ───────────────────────────────────────────────
+    /**
+     * Parse un path HTTP en Trail.
+     *
+     * Convention :
+     *   /entity              → Frame(entity, UNRESOLVED)
+     *   /entity/id           → Frame(entity, id, RESOLVED)
+     *   /entity/id/other     → Frame(entity, id) + Frame(other, UNRESOLVED)
+     *
+     * Exemples :
+     *   /people                     → [people?]
+     *   /people/Nolan               → [people(Nolan)]
+     *   /people/Nolan/movies        → [people(Nolan)] → [movies?]
+     *   /people/Nolan/movies/2      → [people(Nolan)] → [movies(2)]
+     *   /cinema/people/Nolan/movies → [cinema] → [people(Nolan)] → [movies?]
+     *
+     * @param path  - URL path, avec ou sans slash initial
+     * @param init  - Contextes global/user à injecter
+     */
+    static fromPath(path, init = {}) {
+        const trail = Trail.create(init);
+        const parts = path.replace(/^\/+|\/+$/g, '').split('/').filter(Boolean);
+        let i = 0;
+        while (i < parts.length) {
+            const entity = parts[i];
+            const next = parts[i + 1];
+            // Si le prochain segment existe et n'est pas une entité connue
+            // (heuristique : commence par une lettre minuscule = entité, sinon = id)
+            const nextIsId = next !== undefined && !TrailParser.looksLikeEntity(next);
+            if (nextIsId) {
+                trail.push({ entity, id: TrailParser.coerceId(next), state: 'RESOLVED' });
+                i += 2;
+            }
+            else {
+                trail.push({ entity, state: 'UNRESOLVED' });
+                i += 1;
+            }
+        }
+        return trail;
+    }
+    /**
+     * Parse une expression fluente en Trail.
+     *
+     * Syntaxe :
+     *   entity                  → Frame(entity, UNRESOLVED)
+     *   entity(id)              → Frame(entity, id, RESOLVED)
+     *   entity.other            → Frame(entity) + Frame(other)
+     *   entity(id).other(id2)   → Frame(entity,id) + Frame(other,id2)
+     *
+     * Exemples :
+     *   people                         → [people?]
+     *   people(Nolan)                  → [people(Nolan)]
+     *   people(Nolan).movies           → [people(Nolan)] → [movies?]
+     *   cinema.people(Nolan).movies(2) → [cinema] → [people(Nolan)] → [movies(2)]
+     *
+     * @param expr  - Expression fluente
+     * @param init  - Contextes global/user à injecter
+     */
+    static fromFluent(expr, init = {}) {
+        const trail = Trail.create(init);
+        // Tokenise : split sur les points, mais pas ceux dans les parenthèses
+        const tokens = TrailParser.tokenizeFluent(expr);
+        for (const token of tokens) {
+            const frame = TrailParser.parseToken(token);
+            trail.push(frame);
+        }
+        return trail;
+    }
+    /**
+     * Sérialise un Trail en path HTTP.
+     *
+     * Exemple :
+     *   Trail([people(Nolan)][movies?])  →  /people/Nolan/movies
+     */
+    static toPath(trail) {
+        const parts = [];
+        for (const frame of trail.frames) {
+            parts.push(frame.entity);
+            if (frame.id !== undefined) {
+                parts.push(String(frame.id));
+            }
+        }
+        return '/' + parts.join('/');
+    }
+    /**
+     * Sérialise un Trail en expression fluente.
+     *
+     * Exemple :
+     *   Trail([people(Nolan)][movies?])  →  people(Nolan).movies
+     */
+    static toFluent(trail) {
+        return trail.frames
+            .map(f => f.id !== undefined ? `${f.entity}(${f.id})` : f.entity)
+            .join('.');
+    }
+    // ── Helpers privés ─────────────────────────────────────────
+    /**
+     * Heuristique : un segment ressemble-t-il à un nom d'entité ?
+     * Les entités commencent par une lettre minuscule et ne contiennent
+     * que des lettres, chiffres et tirets.
+     */
+    static looksLikeEntity(segment) {
+        return /^[a-z][a-zA-Z0-9-_]*$/.test(segment);
+    }
+    /**
+     * Essaie de convertir un id en nombre, sinon garde la string.
+     */
+    static coerceId(value) {
+        const n = Number(value);
+        return Number.isFinite(n) && value.trim() !== '' ? n : value;
+    }
+    /**
+     * Tokenise une expression fluente en segments.
+     * Préserve le contenu des parenthèses (les ids peuvent contenir des points).
+     *
+     * ex: "cinema.people(Nolan.Jr).movies"
+     *   → ["cinema", "people(Nolan.Jr)", "movies"]
+     */
+    static tokenizeFluent(expr) {
+        const tokens = [];
+        let current = '';
+        let depth = 0;
+        for (const ch of expr) {
+            if (ch === '(') {
+                depth++;
+                current += ch;
+            }
+            else if (ch === ')') {
+                depth--;
+                current += ch;
+            }
+            else if (ch === '.' && depth === 0) {
+                if (current)
+                    tokens.push(current);
+                current = '';
+            }
+            else {
+                current += ch;
+            }
+        }
+        if (current)
+            tokens.push(current);
+        return tokens;
+    }
+    /**
+     * Parse un token "entity" ou "entity(id)" en Frame.
+     */
+    static parseToken(token) {
+        const match = token.match(/^([^(]+)(?:\(([^)]*)\))?$/);
+        if (!match) {
+            // Token malformé — on le traite comme une entité sans id
+            return { entity: token, state: 'UNRESOLVED' };
+        }
+        const entity = match[1].trim();
+        const rawId = match[2];
+        if (rawId === undefined || rawId === '') {
+            return { entity, state: 'UNRESOLVED' };
+        }
+        return {
+            entity,
+            id: TrailParser.coerceId(rawId),
+            state: 'RESOLVED',
+        };
+    }
+}
+//# sourceMappingURL=TrailParser.js.map

package/dist/navigation/TrailParser.js.map

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

package/dist/navigation/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * navigation — Exports du module de navigation
+ */
+export { Trail } from './Trail.js';
+export { TrailParser } from './TrailParser.js';
+export { NavigationEngine } from './NavigationEngine.js';
+export { Resolver } from './Resolver.js';
+export { Scheduler } from './Scheduler.js';
+export type { TrailInit, SerializedTrail } from './Trail.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/navigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAY,YAAY,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAS,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAQ,gBAAgB,CAAA;AAE5C,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA"}

package/dist/navigation/index.js

@@ -0,0 +1,9 @@
+/**
+ * navigation — Exports du module de navigation
+ */
+export { Trail } from './Trail.js';
+export { TrailParser } from './TrailParser.js';
+export { NavigationEngine } from './NavigationEngine.js';
+export { Resolver } from './Resolver.js';
+export { Scheduler } from './Scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/navigation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/navigation/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAY,YAAY,CAAA;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAS,eAAe,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAQ,gBAAgB,CAAA"}

package/dist/providers/MockProvider.d.ts

@@ -0,0 +1,29 @@
+/**
+ * MockProvider - In-memory provider for testing
+ */
+import type { Provider } from '../types/index.js';
+export declare class MockProvider implements Provider {
+    private data;
+    constructor();
+    /**
+     * Set mock data for a table
+     */
+    setData(table: string, rows: any[]): void;
+    /**
+     * Execute query (simplified parsing)
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
+    /**
+     * Close (no-op for mock)
+     */
+    close(): Promise<void>;
+    /**
+     * Clear all data
+     */
+    clear(): void;
+    /**
+     * Get data for a table
+     */
+    getData(table: string): any[] | undefined;
+}
+//# sourceMappingURL=MockProvider.d.ts.map

package/dist/providers/MockProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockProvider.d.ts","sourceRoot":"","sources":["../../src/providers/MockProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAEjD,qBAAa,YAAa,YAAW,QAAQ;IAC3C,OAAO,CAAC,IAAI,CAAoB;;IAMhC;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAIzC;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IAwBnE;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,SAAS;CAG1C"}

package/dist/providers/MockProvider.js

@@ -0,0 +1,55 @@
+/**
+ * MockProvider - In-memory provider for testing
+ */
+export class MockProvider {
+    data;
+    constructor() {
+        this.data = new Map();
+    }
+    /**
+     * Set mock data for a table
+     */
+    setData(table, rows) {
+        this.data.set(table, rows);
+    }
+    /**
+     * Execute query (simplified parsing)
+     */
+    async query(sql, params = []) {
+        // Parse table name
+        const selectMatch = sql.match(/SELECT .* FROM (\w+)/i);
+        if (!selectMatch) {
+            return [];
+        }
+        const tableName = selectMatch[1];
+        const data = this.data.get(tableName) || [];
+        // Apply WHERE clause (simplified)
+        let filtered = data;
+        const whereMatch = sql.match(/WHERE (\w+) = \?/i);
+        if (whereMatch && params.length > 0) {
+            const column = whereMatch[1];
+            const value = params[0];
+            filtered = data.filter((row) => row[column] === value);
+        }
+        return filtered;
+    }
+    /**
+     * Close (no-op for mock)
+     */
+    async close() {
+        // No-op
+    }
+    /**
+     * Clear all data
+     */
+    clear() {
+        this.data.clear();
+    }
+    /**
+     * Get data for a table
+     */
+    getData(table) {
+        return this.data.get(table);
+    }
+}
+//# sourceMappingURL=MockProvider.js.map

package/dist/providers/MockProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockProvider.js","sourceRoot":"","sources":["../../src/providers/MockProvider.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,OAAO,YAAY;IACf,IAAI,CAAoB;IAEhC;QACE,IAAI,CAAC,IAAI,GAAG,IAAI,GAAG,EAAE,CAAA;IACvB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa,EAAE,IAAW;QAChC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAU,GAAW,EAAE,SAAgB,EAAE;QAClD,mBAAmB;QACnB,MAAM,WAAW,GAAG,GAAG,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACtD,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,EAAE,CAAA;QACX,CAAC;QAED,MAAM,SAAS,GAAG,WAAW,CAAC,CAAC,CAAC,CAAA;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,CAAA;QAE3C,kCAAkC;QAClC,IAAI,QAAQ,GAAG,IAAI,CAAA;QAEnB,MAAM,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACjD,IAAI,UAAU,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;YAC5B,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;YAEvB,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAA;QAC7D,CAAC;QAED,OAAO,QAAe,CAAA;IACxB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,QAAQ;IACV,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAA;IACnB,CAAC;IAED;;OAEG;IACH,OAAO,CAAC,KAAa;QACnB,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IAC7B,CAAC;CACF"}

package/dist/providers/PostgresProvider.d.ts

@@ -0,0 +1,46 @@
+/**
+ * PostgresProvider - PostgreSQL database provider with JSON fallback
+ *
+ * Dual-mode: real PostgreSQL or mock JSON files
+ */
+import type { Provider, ProviderConfig } from '../types/index.js';
+interface PostgresConfig extends ProviderConfig {
+    host?: string;
+    port?: number;
+    user?: string;
+    password?: string;
+    connectionString?: string;
+}
+export declare class PostgresProvider implements Provider {
+    private useMock;
+    private pool;
+    private dbPath;
+    private tables;
+    constructor(config: PostgresConfig);
+    /**
+     * Load tables from JSON files (mock mode)
+     */
+    private loadTables;
+    /**
+     * Execute query
+     */
+    query<T = any>(sql: string, params?: any[]): Promise<T[]>;
+    /**
+     * Execute query in mock mode
+     */
+    private queryMock;
+    /**
+     * Close connection
+     */
+    close(): Promise<void>;
+    /**
+     * Save data (mock mode only)
+     */
+    save(tableName: string, data: any[]): Promise<void>;
+    /**
+     * Get table data (mock mode only)
+     */
+    getTable(tableName: string): any[] | undefined;
+}
+export {};
+//# sourceMappingURL=PostgresProvider.d.ts.map

package/dist/providers/PostgresProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PostgresProvider.d.ts","sourceRoot":"","sources":["../../src/providers/PostgresProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAMjE,UAAU,cAAe,SAAQ,cAAc;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,qBAAa,gBAAiB,YAAW,QAAQ;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,IAAI,CAAmB;IAC/B,OAAO,CAAC,MAAM,CAAQ;IACtB,OAAO,CAAC,MAAM,CAAoB;gBAEtB,MAAM,EAAE,cAAc;IAiClC;;OAEG;IACH,OAAO,CAAC,UAAU;IAiBlB;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,GAAG,EAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;IA6BnE;;OAEG;YACW,SAAS;IAgCvB;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAS5B;;OAEG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAezD;;OAEG;IACH,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,GAAG,EAAE,GAAG,SAAS;CAO/C"}

package/dist/providers/PostgresProvider.js

@@ -0,0 +1,152 @@
+/**
+ * PostgresProvider - PostgreSQL database provider with JSON fallback
+ *
+ * Dual-mode: real PostgreSQL or mock JSON files
+ */
+import { ProviderError } from '../types/index.js';
+import * as fs from 'fs';
+import * as path from 'path';
+import { Pool } from 'pg';
+export class PostgresProvider {
+    useMock;
+    pool = null;
+    dbPath;
+    tables;
+    constructor(config) {
+        this.useMock = config.mock ?? false;
+        console.log(' useMock: ', this.useMock);
+        this.dbPath = config.database ? `./db/postgres/${config.database}` : './db/postgres';
+        this.tables = new Map();
+        if (!this.useMock) {
+            try {
+                // Try to load pg module
+                // const { Pool } = require('pg')
+                this.pool = new Pool({
+                    host: config.host ?? 'localhost',
+                    port: config.port ?? 5432,
+                    database: config.database,
+                    user: config.user ?? 'postgres',
+                    password: config.password,
+                    connectionString: config.connectionString
+                });
+                console.log(`🐘 Postgres connected: ${config.database}`);
+            }
+            catch (err) {
+                console.warn('⚠️  pg module not found, falling back to mock mode');
+                this.useMock = true;
+            }
+        }
+        if (this.useMock) {
+            console.log(`🐘 Postgres connected (MOCK mode): ${config.database}`);
+            this.loadTables();
+        }
+    }
+    /**
+     * Load tables from JSON files (mock mode)
+     */
+    loadTables() {
+        if (!fs.existsSync(this.dbPath)) {
+            this.tables = new Map();
+            return;
+        }
+        const files = fs.readdirSync(this.dbPath);
+        for (const file of files) {
+            if (file.endsWith('.json')) {
+                const tableName = file.replace('.json', '');
+                const content = fs.readFileSync(path.join(this.dbPath, file), 'utf-8');
+                this.tables.set(tableName, JSON.parse(content));
+            }
+        }
+    }
+    /**
+     * Execute query
+     */
+    async query(sql, params = []) {
+        if (this.useMock) {
+            return this.queryMock(sql, params);
+        }
+        if (!this.pool) {
+            throw new ProviderError('PostgreSQL pool not initialized');
+        }
+        try {
+            console.log('🐘 Postgres:', sql);
+            if (params.length > 0) {
+                console.log('   Params:', params);
+            }
+            const result = await this.pool.query(sql, params);
+            console.log(`✅ Postgres result: ${result.rows.length} rows`);
+            return result.rows;
+        }
+        catch (err) {
+            throw new ProviderError(`PostgreSQL query failed: ${err.message}`, {
+                sql,
+                params,
+                error: err
+            });
+        }
+    }
+    /**
+     * Execute query in mock mode
+     */
+    async queryMock(sql, params) {
+        console.log('🐘 Postgres:', sql);
+        if (params.length > 0) {
+            console.log('   Params:', params);
+        }
+        // Parse SQL (simplified)
+        const selectMatch = sql.match(/SELECT .* FROM (\w+)/i);
+        if (!selectMatch) {
+            console.log('✅ Postgres result (MOCK): 0 rows');
+            return [];
+        }
+        const tableName = selectMatch[1];
+        const data = this.tables.get(tableName) || [];
+        // Apply WHERE clause (simplified)
+        let filtered = data;
+        const whereMatch = sql.match(/WHERE (\w+)\.(\w+) = \$(\d+)/i);
+        if (whereMatch && params.length > 0) {
+            const column = whereMatch[2];
+            const paramIndex = parseInt(whereMatch[3]) - 1;
+            const value = params[paramIndex];
+            filtered = data.filter((row) => row[column] === value);
+        }
+        console.log(`✅ Postgres result (MOCK): ${filtered.length} rows`);
+        return filtered;
+    }
+    /**
+     * Close connection
+     */
+    async close() {
+        if (this.pool) {
+            await this.pool.end();
+            console.log('🐘 Postgres closed');
+        }
+        else {
+            console.log('🐘 Postgres closed');
+        }
+    }
+    /**
+     * Save data (mock mode only)
+     */
+    async save(tableName, data) {
+        if (!this.useMock) {
+            throw new ProviderError('Save only available in mock mode');
+        }
+        if (!fs.existsSync(this.dbPath)) {
+            fs.mkdirSync(this.dbPath, { recursive: true });
+        }
+        const filepath = path.join(this.dbPath, `${tableName}.json`);
+        fs.writeFileSync(filepath, JSON.stringify(data, null, 2));
+        this.tables.set(tableName, data);
+    }
+    /**
+     * Get table data (mock mode only)
+     */
+    getTable(tableName) {
+        if (!this.useMock) {
+            throw new ProviderError('getTable only available in mock mode');
+        }
+        return this.tables.get(tableName);
+    }
+}
+//# sourceMappingURL=PostgresProvider.js.map

package/dist/providers/PostgresProvider.js.map

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

package/dist/runtime/CompiledGraphEngine.d.ts

@@ -0,0 +1,74 @@
+/**
+ * CompiledGraphEngine - Production engine using precompiled graph
+ *
+ * - O(1) route lookup
+ * - Automatic fallback
+ * - Live metrics
+ * - Hot reload support
+ */
+import type { CompiledGraph, Provider } from '../types/index.js';
+interface LiveMetrics {
+    path: string[];
+    executions: number;
+    successes: number;
+    failures: number;
+    totalTime: number;
+    avgTime: number;
+}
+export declare class CompiledGraphEngine {
+    private compiled;
+    private provider;
+    private liveMetrics;
+    private routeCache;
+    constructor(compiled: CompiledGraph, provider: Provider);
+    /**
+     * Build fast lookup cache
+     */
+    private buildRouteCache;
+    /**
+     * Execute query from -> to
+     */
+    query(from: string, to: string, data?: Record<string, any>): Promise<any[]>;
+    /**
+     * Execute path with JOINs
+     */
+    private executePath;
+    /**
+     * Find edge between nodes
+     */
+    private findEdge;
+    /**
+     * Fallback to alternative paths
+     */
+    private fallback;
+    /**
+     * Update live metrics
+     */
+    private updateMetrics;
+    /**
+     * Consider promoting a fallback to primary
+     */
+    private considerPromotion;
+    /**
+     * Get live statistics
+     */
+    getStats(): {
+        totalExecutions: number;
+        totalSuccesses: number;
+        successRate: string;
+        avgTime: string;
+        uniquePaths: number;
+        fastest?: LiveMetrics;
+        slowest?: LiveMetrics;
+    };
+    /**
+     * Export metrics for recompilation
+     */
+    exportMetrics(): Map<string, LiveMetrics>;
+    /**
+     * Hot reload compiled graph
+     */
+    reload(compiled: CompiledGraph): void;
+}
+export {};
+//# sourceMappingURL=CompiledGraphEngine.d.ts.map

package/dist/runtime/CompiledGraphEngine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompiledGraphEngine.d.ts","sourceRoot":"","sources":["../../src/runtime/CompiledGraphEngine.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAA0B,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AAExF,UAAU,WAAW;IACnB,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,QAAQ,CAAU;IAC1B,OAAO,CAAC,WAAW,CAA0B;IAC7C,OAAO,CAAC,UAAU,CAAwB;gBAE9B,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ;IAWvD;;OAEG;IACH,OAAO,CAAC,eAAe;IAWvB;;OAEG;IACG,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IA4BrF;;OAEG;YACW,WAAW;IA4BzB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAKhB;;OAEG;YACW,QAAQ;IA4BtB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA4BzB;;OAEG;IACH,QAAQ,IAAI;QACV,eAAe,EAAE,MAAM,CAAA;QACvB,cAAc,EAAE,MAAM,CAAA;QACtB,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,EAAE,MAAM,CAAA;QACf,WAAW,EAAE,MAAM,CAAA;QACnB,OAAO,CAAC,EAAE,WAAW,CAAA;QACrB,OAAO,CAAC,EAAE,WAAW,CAAA;KACtB;IAgCD;;OAEG;IACH,aAAa,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC;IAIzC;;OAEG;IACH,MAAM,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI;CAQtC"}