@flutchai/flutch-sdk 0.1.0

package/dist/endpoint-registry/endpoint.decorators.js

@@ -0,0 +1,115 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENDPOINT_METADATA_KEY = void 0;
+exports.Endpoint = Endpoint;
+exports.WithEndpoints = WithEndpoints;
+exports.getEndpointMetadata = getEndpointMetadata;
+exports.createEndpointDescriptors = createEndpointDescriptors;
+exports.findEndpointMethod = findEndpointMethod;
+exports.WithUIEndpoints = WithUIEndpoints;
+exports.UIEndpoint = UIEndpoint;
+exports.getUIEndpointClassMetadata = getUIEndpointClassMetadata;
+exports.getUIEndpointMethodsMetadata = getUIEndpointMethodsMetadata;
+exports.hasUIEndpoints = hasUIEndpoints;
+exports.registerUIEndpointsFromClass = registerUIEndpointsFromClass;
+require("reflect-metadata");
+exports.ENDPOINT_METADATA_KEY = "graph:endpoints";
+function Endpoint(name, options) {
+    return function (target, propertyKey, descriptor) {
+        const existingMetadata = Reflect.getMetadata(exports.ENDPOINT_METADATA_KEY, target.constructor) || [];
+        const metadata = {
+            name,
+            method: options.method,
+            methodName: propertyKey,
+            schema: options.schema,
+        };
+        existingMetadata.push(metadata);
+        Reflect.defineMetadata(exports.ENDPOINT_METADATA_KEY, existingMetadata, target.constructor);
+    };
+}
+function WithEndpoints(target) {
+    if (!Reflect.hasMetadata(exports.ENDPOINT_METADATA_KEY, target)) {
+        Reflect.defineMetadata(exports.ENDPOINT_METADATA_KEY, [], target);
+    }
+}
+function getEndpointMetadata(constructor) {
+    return Reflect.getMetadata(exports.ENDPOINT_METADATA_KEY, constructor) || [];
+}
+function createEndpointDescriptors(instance, metadata) {
+    return metadata.map(meta => ({
+        name: meta.name,
+        method: meta.method,
+        schema: meta.schema,
+        handler: async (ctx) => {
+            const method = instance[meta.methodName];
+            if (typeof method !== "function") {
+                throw new Error(`Method ${meta.methodName} not found on instance`);
+            }
+            return method.call(instance, ctx);
+        },
+    }));
+}
+function findEndpointMethod(constructor, endpointName) {
+    const metadata = getEndpointMetadata(constructor);
+    const endpoint = metadata.find(meta => meta.name === endpointName);
+    return endpoint === null || endpoint === void 0 ? void 0 : endpoint.methodName;
+}
+const UI_ENDPOINT_CLASS_METADATA_KEY = Symbol("ui_endpoint_class");
+const UI_ENDPOINT_METHOD_METADATA_KEY = Symbol("ui_endpoint_methods");
+function WithUIEndpoints(graphType) {
+    return function (constructor) {
+        Reflect.defineMetadata(UI_ENDPOINT_CLASS_METADATA_KEY, { graphType }, constructor);
+        return constructor;
+    };
+}
+function UIEndpoint(endpointName, method = "GET") {
+    return function (target, propertyKey, descriptor) {
+        const existingMethods = Reflect.getMetadata(UI_ENDPOINT_METHOD_METADATA_KEY, target.constructor) || [];
+        const methodMetadata = {
+            endpointName,
+            method,
+            methodName: propertyKey,
+        };
+        existingMethods.push(methodMetadata);
+        Reflect.defineMetadata(UI_ENDPOINT_METHOD_METADATA_KEY, existingMethods, target.constructor);
+        return descriptor;
+    };
+}
+function getUIEndpointClassMetadata(constructor) {
+    return (Reflect.getMetadata(UI_ENDPOINT_CLASS_METADATA_KEY, constructor) || null);
+}
+function getUIEndpointMethodsMetadata(constructor) {
+    return (Reflect.getMetadata(UI_ENDPOINT_METHOD_METADATA_KEY, constructor) || []);
+}
+function hasUIEndpoints(constructor) {
+    return getUIEndpointClassMetadata(constructor) !== null;
+}
+function registerUIEndpointsFromClass(endpointRegistry, EndpointClass, instance) {
+    const classMetadata = getUIEndpointClassMetadata(EndpointClass);
+    if (!classMetadata) {
+        return;
+    }
+    const methodsMetadata = getUIEndpointMethodsMetadata(EndpointClass);
+    if (methodsMetadata.length === 0) {
+        return;
+    }
+    console.log("🔧 DEBUG: registerUIEndpointsFromClass", {
+        hasInstance: !!instance,
+        willCreateNew: !instance,
+        className: EndpointClass.name,
+    });
+    const endpointInstance = instance || new EndpointClass();
+    const descriptors = methodsMetadata.map(meta => ({
+        name: meta.endpointName,
+        method: meta.method,
+        handler: async (ctx) => {
+            const method = endpointInstance[meta.methodName];
+            if (typeof method !== "function") {
+                throw new Error(`Method ${String(meta.methodName)} not found on instance`);
+            }
+            return method.call(endpointInstance, ctx);
+        },
+    }));
+    endpointRegistry.registerMultiple(classMetadata.graphType, descriptors);
+}
+//# sourceMappingURL=endpoint.decorators.js.map

package/dist/endpoint-registry/endpoint.decorators.js.map

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

package/dist/endpoint-registry/endpoint.registry.d.ts

@@ -0,0 +1,44 @@
+import { JSONSchema7 } from "json-schema";
+export interface RequestContext {
+    userId: string;
+    companyId?: string;
+    method: "GET" | "POST";
+    payload?: any;
+    channel: string;
+    platform?: string;
+}
+export interface DataEnvelope<T = any> {
+    schema: string;
+    data: T;
+    meta?: {
+        total?: number;
+        page?: number;
+        redirect?: string;
+        message?: string;
+    };
+}
+export type EndpointHandler = (ctx: RequestContext) => Promise<DataEnvelope>;
+export interface EndpointDescriptor {
+    name: string;
+    method: "GET" | "POST";
+    handler: EndpointHandler;
+    schema?: JSONSchema7;
+}
+export declare class EndpointRegistry {
+    private readonly logger;
+    private readonly endpoints;
+    register(graphType: string, endpoint: EndpointDescriptor): void;
+    registerMultiple(graphType: string, endpoints: EndpointDescriptor[]): void;
+    get(graphType: string, endpointName: string): EndpointDescriptor | undefined;
+    list(graphType: string): string[];
+    listEndpoints(graphType: string): string[];
+    listGraphTypes(): string[];
+    call(graphType: string, endpointName: string, context: RequestContext): Promise<DataEnvelope>;
+    getStats(): {
+        totalGraphTypes: number;
+        totalEndpoints: number;
+        endpointsByGraph: Record<string, number>;
+    };
+    clear(): void;
+    clearGraph(graphType: string): void;
+}

package/dist/endpoint-registry/endpoint.registry.js

@@ -0,0 +1,90 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var EndpointRegistry_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EndpointRegistry = void 0;
+const common_1 = require("@nestjs/common");
+let EndpointRegistry = EndpointRegistry_1 = class EndpointRegistry {
+    constructor() {
+        this.logger = new common_1.Logger(EndpointRegistry_1.name);
+        this.endpoints = new Map();
+    }
+    register(graphType, endpoint) {
+        if (!this.endpoints.has(graphType)) {
+            this.endpoints.set(graphType, new Map());
+        }
+        const graphEndpoints = this.endpoints.get(graphType);
+        graphEndpoints.set(endpoint.name, endpoint);
+        this.logger.debug(`Registered endpoint "${endpoint.name}" for graph type "${graphType}"`);
+    }
+    registerMultiple(graphType, endpoints) {
+        for (const endpoint of endpoints) {
+            this.register(graphType, endpoint);
+        }
+    }
+    get(graphType, endpointName) {
+        const graphEndpoints = this.endpoints.get(graphType);
+        return graphEndpoints === null || graphEndpoints === void 0 ? void 0 : graphEndpoints.get(endpointName);
+    }
+    list(graphType) {
+        const graphEndpoints = this.endpoints.get(graphType);
+        if (!graphEndpoints) {
+            return [];
+        }
+        return Array.from(graphEndpoints.keys());
+    }
+    listEndpoints(graphType) {
+        return this.list(graphType);
+    }
+    listGraphTypes() {
+        return Array.from(this.endpoints.keys());
+    }
+    async call(graphType, endpointName, context) {
+        const endpoint = this.get(graphType, endpointName);
+        if (!endpoint) {
+            throw new Error(`Endpoint "${endpointName}" not found for graph "${graphType}"`);
+        }
+        if (endpoint.method !== context.method) {
+            throw new Error(`Method mismatch: endpoint expects ${endpoint.method}, got ${context.method}`);
+        }
+        this.logger.debug(`Calling endpoint "${endpointName}" for graph "${graphType}" with method ${context.method}`);
+        try {
+            return await endpoint.handler(context);
+        }
+        catch (error) {
+            this.logger.error(`Error calling endpoint "${endpointName}" for graph "${graphType}":`, error);
+            throw error;
+        }
+    }
+    getStats() {
+        const stats = {
+            totalGraphTypes: this.endpoints.size,
+            totalEndpoints: 0,
+            endpointsByGraph: {},
+        };
+        for (const [graphType, endpoints] of this.endpoints) {
+            const count = endpoints.size;
+            stats.totalEndpoints += count;
+            stats.endpointsByGraph[graphType] = count;
+        }
+        return stats;
+    }
+    clear() {
+        this.endpoints.clear();
+        this.logger.debug("Cleared all endpoints from registry");
+    }
+    clearGraph(graphType) {
+        this.endpoints.delete(graphType);
+        this.logger.debug(`Cleared endpoints for graph type "${graphType}"`);
+    }
+};
+exports.EndpointRegistry = EndpointRegistry;
+exports.EndpointRegistry = EndpointRegistry = EndpointRegistry_1 = __decorate([
+    (0, common_1.Injectable)()
+], EndpointRegistry);
+//# sourceMappingURL=endpoint.registry.js.map

package/dist/endpoint-registry/endpoint.registry.js.map

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

package/dist/endpoint-registry/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./endpoint.registry";
+export * from "./endpoint.decorators";
+export * from "./ui-endpoints.discovery";

package/dist/endpoint-registry/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./endpoint.registry"), exports);
+__exportStar(require("./endpoint.decorators"), exports);
+__exportStar(require("./ui-endpoints.discovery"), exports);
+//# sourceMappingURL=index.js.map

package/dist/endpoint-registry/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/endpoint-registry/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,sDAAoC;AACpC,wDAAsC;AACtC,2DAAyC"}

package/dist/endpoint-registry/ui-endpoints.discovery.d.ts

@@ -0,0 +1,11 @@
+import { DiscoveryService, MetadataScanner } from "@nestjs/core";
+import { EndpointRegistry } from "./endpoint.registry";
+export declare class UIEndpointsDiscoveryService {
+    private readonly discoveryService;
+    private readonly metadataScanner;
+    private readonly endpointRegistry;
+    private readonly logger;
+    constructor(discoveryService: DiscoveryService, metadataScanner: MetadataScanner, endpointRegistry: EndpointRegistry);
+    discoverUIEndpoints(): Promise<void>;
+    private getUIEndpointMethodsCount;
+}

package/dist/endpoint-registry/ui-endpoints.discovery.js

@@ -0,0 +1,72 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var UIEndpointsDiscoveryService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UIEndpointsDiscoveryService = void 0;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const endpoint_registry_1 = require("./endpoint.registry");
+const endpoint_decorators_1 = require("./endpoint.decorators");
+let UIEndpointsDiscoveryService = UIEndpointsDiscoveryService_1 = class UIEndpointsDiscoveryService {
+    constructor(discoveryService, metadataScanner, endpointRegistry) {
+        this.discoveryService = discoveryService;
+        this.metadataScanner = metadataScanner;
+        this.endpointRegistry = endpointRegistry;
+        this.logger = new common_1.Logger(UIEndpointsDiscoveryService_1.name);
+    }
+    async discoverUIEndpoints() {
+        this.logger.log("Starting UI endpoints discovery...");
+        const providers = this.discoveryService.getProviders();
+        let registeredCount = 0;
+        let totalEndpoints = 0;
+        for (const provider of providers) {
+            try {
+                const { instance, metatype } = provider;
+                if (!metatype || !instance) {
+                    continue;
+                }
+                if ((0, endpoint_decorators_1.hasUIEndpoints)(metatype)) {
+                    this.logger.debug(`Found UI endpoints class: ${metatype.name}`);
+                    console.log("🔧 DEBUG: Discovery found instance", {
+                        className: metatype.name,
+                        hasInstance: !!instance,
+                        instanceType: typeof instance,
+                    });
+                    (0, endpoint_decorators_1.registerUIEndpointsFromClass)(this.endpointRegistry, metatype, instance);
+                    registeredCount++;
+                    const metadata = this.getUIEndpointMethodsCount(metatype);
+                    totalEndpoints += metadata;
+                    this.logger.log(`✅ Registered ${metadata} UI endpoints from ${metatype.name}`);
+                }
+            }
+            catch (error) {
+                this.logger.warn(`Failed to process provider: ${error.message}`);
+            }
+        }
+        this.logger.log(`🎉 UI endpoints discovery completed!`);
+        this.logger.log(`📊 Stats: ${registeredCount} classes, ${totalEndpoints} endpoints total`);
+        const stats = this.endpointRegistry.getStats();
+        this.logger.log(`📈 Registry: ${stats.totalGraphTypes} graph types, ${stats.totalEndpoints} endpoints`);
+    }
+    getUIEndpointMethodsCount(metatype) {
+        const { getUIEndpointMethodsMetadata } = require("./endpoint.decorators");
+        const methods = getUIEndpointMethodsMetadata(metatype);
+        return methods.length;
+    }
+};
+exports.UIEndpointsDiscoveryService = UIEndpointsDiscoveryService;
+exports.UIEndpointsDiscoveryService = UIEndpointsDiscoveryService = UIEndpointsDiscoveryService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [core_1.DiscoveryService,
+        core_1.MetadataScanner,
+        endpoint_registry_1.EndpointRegistry])
+], UIEndpointsDiscoveryService);
+//# sourceMappingURL=ui-endpoints.discovery.js.map

package/dist/endpoint-registry/ui-endpoints.discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-endpoints.discovery.js","sourceRoot":"","sources":["../../src/endpoint-registry/ui-endpoints.discovery.ts"],"names":[],"mappings":";;;;;;;;;;;;;AACA,2CAAoD;AACpD,uCAAiE;AACjE,2DAAuD;AACvD,+DAG+B;AAQxB,IAAM,2BAA2B,mCAAjC,MAAM,2BAA2B;IAGtC,YACmB,gBAAkC,EAClC,eAAgC,EAChC,gBAAkC;QAFlC,qBAAgB,GAAhB,gBAAgB,CAAkB;QAClC,oBAAe,GAAf,eAAe,CAAiB;QAChC,qBAAgB,GAAhB,gBAAgB,CAAkB;QALpC,WAAM,GAAG,IAAI,eAAM,CAAC,6BAA2B,CAAC,IAAI,CAAC,CAAC;IAMpE,CAAC;IAMJ,KAAK,CAAC,mBAAmB;QACvB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QAGtD,MAAM,SAAS,GAAG,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;QAEvD,IAAI,eAAe,GAAG,CAAC,CAAC;QACxB,IAAI,cAAc,GAAG,CAAC,CAAC;QAEvB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,QAAQ,CAAC;gBAGxC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;oBAC3B,SAAS;gBACX,CAAC;gBAGD,IAAI,IAAA,oCAAc,EAAC,QAAQ,CAAC,EAAE,CAAC;oBAC7B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;oBAChE,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE;wBAChD,SAAS,EAAE,QAAQ,CAAC,IAAI;wBACxB,WAAW,EAAE,CAAC,CAAC,QAAQ;wBACvB,YAAY,EAAE,OAAO,QAAQ;qBAC9B,CAAC,CAAC;oBAGH,IAAA,kDAA4B,EAC1B,IAAI,CAAC,gBAAgB,EACrB,QAAQ,EACR,QAAQ,CACT,CAAC;oBAEF,eAAe,EAAE,CAAC;oBAGlB,MAAM,QAAQ,GAAG,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;oBAC1D,cAAc,IAAI,QAAQ,CAAC;oBAE3B,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,gBAAgB,QAAQ,sBAAsB,QAAQ,CAAC,IAAI,EAAE,CAC9D,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,+BAA+B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACnE,CAAC;QACH,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,sCAAsC,CAAC,CAAC;QACxD,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,aAAa,eAAe,aAAa,cAAc,kBAAkB,CAC1E,CAAC;QAGF,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,CAAC;QAC/C,IAAI,CAAC,MAAM,CAAC,GAAG,CACb,gBAAgB,KAAK,CAAC,eAAe,iBAAiB,KAAK,CAAC,cAAc,YAAY,CACvF,CAAC;IACJ,CAAC;IAKO,yBAAyB,CAAC,QAAa;QAC7C,MAAM,EAAE,4BAA4B,EAAE,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;QAC1E,MAAM,OAAO,GAAG,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QACvD,OAAO,OAAO,CAAC,MAAM,CAAC;IACxB,CAAC;CACF,CAAA;AAlFY,kEAA2B;sCAA3B,2BAA2B;IADvC,IAAA,mBAAU,GAAE;qCAK0B,uBAAgB;QACjB,sBAAe;QACd,oCAAgB;GAN1C,2BAA2B,CAkFvC"}

package/dist/engine/api-call-tracer.utils.d.ts

@@ -0,0 +1,8 @@
+export interface TraceApiCallResult<TResult> {
+    result: TResult;
+    startedAt: number;
+    completedAt: number;
+    durationMs: number;
+}
+export declare function traceApiCall<TResult>(execute: () => Promise<TResult>): Promise<TraceApiCallResult<TResult>>;
+export declare function sanitizeTraceData(value: unknown, depth?: number, seen?: WeakSet<object>): unknown;

package/dist/engine/api-call-tracer.utils.js

@@ -0,0 +1,184 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceApiCall = traceApiCall;
+exports.sanitizeTraceData = sanitizeTraceData;
+const LangGraph = __importStar(require("@langchain/langgraph"));
+const common_1 = require("@nestjs/common");
+const logger = new common_1.Logger("ApiCallTracer");
+const MAX_STRING_LENGTH = 5000;
+const MAX_COLLECTION_LENGTH = 50;
+const MAX_DEPTH = 15;
+let cachedDispatch;
+let dispatchUnavailableLogged = false;
+async function traceApiCall(execute) {
+    const startedAt = Date.now();
+    dispatchApiTraceEvent("custom_api_call_start");
+    try {
+        const result = await execute();
+        const completedAt = Date.now();
+        const durationMs = completedAt - startedAt;
+        dispatchApiTraceEvent("custom_api_call_end", {
+            result: sanitizeTraceData(result),
+            startedAt,
+            completedAt,
+            durationMs,
+        });
+        return { result, startedAt, completedAt, durationMs };
+    }
+    catch (error) {
+        const failedAt = Date.now();
+        const durationMs = failedAt - startedAt;
+        dispatchApiTraceEvent("custom_api_call_error", {
+            error: sanitizeTraceError(error),
+            startedAt,
+            failedAt,
+            durationMs,
+        });
+        throw error;
+    }
+}
+function dispatchApiTraceEvent(eventName, payload) {
+    const dispatch = getLangGraphDispatch();
+    if (!dispatch) {
+        if (!dispatchUnavailableLogged) {
+            logger.debug("LangGraph dispatchCustomEvent is not available");
+            dispatchUnavailableLogged = true;
+        }
+        return;
+    }
+    try {
+        dispatch(eventName, payload);
+    }
+    catch (error) {
+        logger.warn("Failed to emit API trace event", {
+            error: error instanceof Error ? error.message : String(error),
+            eventName,
+        });
+    }
+}
+function getLangGraphDispatch() {
+    if (cachedDispatch !== undefined) {
+        return cachedDispatch;
+    }
+    const { dispatchCustomEvent } = LangGraph;
+    cachedDispatch =
+        typeof dispatchCustomEvent === "function" ? dispatchCustomEvent : null;
+    return cachedDispatch;
+}
+function sanitizeTraceData(value, depth = 0, seen = new WeakSet()) {
+    if (value === undefined) {
+        return undefined;
+    }
+    if (value === null) {
+        return null;
+    }
+    if (typeof value === "string") {
+        return value.length > MAX_STRING_LENGTH
+            ? `${value.slice(0, MAX_STRING_LENGTH)}…`
+            : value;
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (value instanceof Date) {
+        return value.toISOString();
+    }
+    if (value instanceof Error) {
+        return sanitizeTraceError(value);
+    }
+    if (depth >= MAX_DEPTH) {
+        return Array.isArray(value) ? "[Array]" : "[Object]";
+    }
+    if (typeof value === "object") {
+        if (seen.has(value)) {
+            return undefined;
+        }
+        seen.add(value);
+        if (Array.isArray(value)) {
+            return value
+                .map(item => sanitizeTraceData(item, depth + 1, seen))
+                .filter(item => item !== undefined);
+        }
+        if (value instanceof Set) {
+            return Array.from(value)
+                .map(item => sanitizeTraceData(item, depth + 1, seen))
+                .filter(item => item !== undefined);
+        }
+        if (value instanceof Map) {
+            const entries = {};
+            for (const [key, entryValue] of value.entries()) {
+                const sanitized = sanitizeTraceData(entryValue, depth + 1, seen);
+                if (sanitized !== undefined) {
+                    entries[String(key)] = sanitized;
+                }
+            }
+            return entries;
+        }
+        const result = {};
+        for (const [key, entryValue] of Object.entries(value)) {
+            const sanitized = sanitizeTraceData(entryValue, depth + 1, seen);
+            if (sanitized !== undefined) {
+                result[key] = sanitized;
+            }
+        }
+        return result;
+    }
+    return String(value);
+}
+function sanitizeTraceError(error) {
+    if (error instanceof Error) {
+        return {
+            name: error.name,
+            message: error.message,
+            stack: error.stack ? sanitizeTraceData(error.stack) : undefined,
+        };
+    }
+    if (typeof error === "string") {
+        return {
+            message: error.length > MAX_STRING_LENGTH
+                ? `${error.slice(0, MAX_STRING_LENGTH)}…`
+                : error,
+        };
+    }
+    return {
+        message: "Unknown error",
+        raw: sanitizeTraceData(error),
+    };
+}
+//# sourceMappingURL=api-call-tracer.utils.js.map

package/dist/engine/api-call-tracer.utils.js.map

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

package/dist/engine/event-processor.utils.d.ts

@@ -0,0 +1,49 @@
+import { IReasoningChain, IStoredMessageContent, IGraphTraceEvent } from "../shared-types";
+export interface LLMCallRecord {
+    modelId: string;
+    promptTokens: number;
+    completionTokens: number;
+    totalTokens: number;
+    timestamp: number;
+    nodeName?: string;
+}
+export interface StreamAccumulator {
+    streamedText: string;
+    reasoningChains: IReasoningChain[];
+    generation: IStoredMessageContent | null;
+    llmCalls: LLMCallRecord[];
+    traceEvents: IGraphTraceEvent[];
+    traceStartedAt: number | null;
+    traceCompletedAt: number | null;
+}
+export declare class EventProcessor {
+    private readonly logger;
+    createAccumulator(): StreamAccumulator;
+    private normalizeContentBlocks;
+    processEvent(acc: StreamAccumulator, event: any, onPartial?: (chunk: string) => void): void;
+    getResult(acc: StreamAccumulator): {
+        content: IStoredMessageContent;
+        metrics: {
+            modelCalls: Array<{
+                nodeName: string;
+                timestamp: number;
+                modelId: string;
+                promptTokens: number;
+                completionTokens: number;
+                totalTokens: number;
+                latencyMs: number;
+            }>;
+            apiCalls: any[];
+        } | null;
+        trace: {
+            events: IGraphTraceEvent[];
+            startedAt: number;
+            completedAt: number;
+            durationMs: number;
+            totalEvents: number;
+            totalModelCalls: number;
+        } | null;
+    };
+    private captureTraceEvent;
+    private normalizeTraceEvent;
+}