@carlonicora/nestjs-neo4jsonapi 1.79.0 → 1.81.0

package/dist/core/model-manager/model-loader.js

@@ -0,0 +1,213 @@
+"use strict";
+/**
+ * Model Configuration Loader
+ *
+ * Loads and validates models.config.yaml, providing type-safe access to model configuration.
+ */
+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.ModelLoader = void 0;
+exports.getModelLoader = getModelLoader;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const common_1 = require("@nestjs/common");
+const logger = new common_1.Logger("ModelLoader");
+class ModelLoader {
+    constructor(configPath) {
+        this.config = null;
+        this.configPath = configPath || this.getDefaultConfigPath();
+    }
+    getDefaultConfigPath() {
+        const fromEnv = process.env.MODEL_CONFIG_PATH;
+        if (fromEnv) {
+            return fromEnv;
+        }
+        return path.join(process.cwd(), "config", "models.config.yaml");
+    }
+    load() {
+        if (this.config) {
+            return this.config;
+        }
+        const fullPath = path.resolve(this.configPath);
+        if (!fs.existsSync(fullPath)) {
+            throw new Error(`Model configuration file not found: ${fullPath}`);
+        }
+        try {
+            const fileContent = fs.readFileSync(fullPath, "utf-8");
+            const parsed = yaml.load(fileContent);
+            this.config = this.validateAndTransform(parsed);
+            logger.log(`Model configuration loaded from: ${fullPath}`);
+            logger.log(`Total models: ${this.config.registry.onnx.length} ONNX, ${this.config.registry.transformers.length} Transformers`);
+            return this.config;
+        }
+        catch (error) {
+            if (error instanceof Error && error.message.includes("not found")) {
+                throw error;
+            }
+            throw new Error(`Failed to parse model configuration: ${error}`);
+        }
+    }
+    validateAndTransform(parsed) {
+        const result = {
+            valid: true,
+            errors: [],
+            warnings: [],
+        };
+        // Validate top-level structure
+        if (!parsed.version) {
+            result.errors.push("Missing required field: version");
+        }
+        if (!parsed.registry) {
+            result.errors.push("Missing required field: registry");
+        }
+        if (!parsed.registry?.onnx) {
+            result.errors.push("Missing required field: registry.onnx");
+        }
+        if (!parsed.registry?.transformers) {
+            result.errors.push("Missing required field: registry.transformers");
+        }
+        // Validate ONNX models
+        const onnxModels = parsed.registry?.onnx || [];
+        onnxModels.forEach((model, index) => {
+            if (!model.name) {
+                result.errors.push(`ONNX model ${index}: Missing required field: name`);
+            }
+            if (!model.path) {
+                result.errors.push(`ONNX model ${model.name || index}: Missing required field: path`);
+            }
+            if (!model.version) {
+                result.errors.push(`ONNX model ${model.name || index}: Missing required field: version`);
+            }
+            if (!model.hash) {
+                result.errors.push(`ONNX model ${model.name || index}: Missing required field: hash`);
+            }
+            if (typeof model.priority !== "number") {
+                result.errors.push(`ONNX model ${model.name || index}: Missing required field: priority`);
+            }
+            if (typeof model.optional !== "boolean") {
+                result.errors.push(`ONNX model ${model.name || index}: Missing required field: optional`);
+            }
+            if (!model.modelId) {
+                result.errors.push(`ONNX model ${model.name || index}: Missing required field: modelId`);
+            }
+        });
+        // Validate Transformers models
+        const transformersModels = parsed.registry?.transformers || [];
+        transformersModels.forEach((model, index) => {
+            if (!model.name) {
+                result.errors.push(`Transformers model ${index}: Missing required field: name`);
+            }
+            if (!model.path) {
+                result.errors.push(`Transformers model ${model.name || index}: Missing required field: path`);
+            }
+            if (!model.version) {
+                result.errors.push(`Transformers model ${model.name || index}: Missing required field: version`);
+            }
+            if (!model.components || !Array.isArray(model.components)) {
+                result.errors.push(`Transformers model ${model.name || index}: Missing required field: components`);
+            }
+            if (typeof model.priority !== "number") {
+                result.errors.push(`Transformers model ${model.name || index}: Missing required field: priority`);
+            }
+            if (typeof model.optional !== "boolean") {
+                result.errors.push(`Transformers model ${model.name || index}: Missing required field: optional`);
+            }
+            if (!model.modelId) {
+                result.errors.push(`Transformers model ${model.name || index}: Missing required field: modelId`);
+            }
+            // Validate components
+            model.components?.forEach((component, cIndex) => {
+                if (!component.name) {
+                    result.errors.push(`Transformers model ${model.name || index}, component ${cIndex}: Missing required field: name`);
+                }
+                if (!component.file) {
+                    result.errors.push(`Transformers model ${model.name || index}, component ${cIndex}: Missing required field: file`);
+                }
+                if (!component.hash) {
+                    result.errors.push(`Transformers model ${model.name || index}, component ${cIndex}: Missing required field: hash`);
+                }
+            });
+        });
+        // If errors, throw
+        if (result.errors.length > 0) {
+            const errorSummary = result.errors.join("\n  - ");
+            throw new Error(`Model configuration validation failed:\n  - ${errorSummary}`);
+        }
+        // Log warnings
+        if (result.warnings.length > 0) {
+            logger.warn(`Model configuration warnings:\n  - ${result.warnings.join("\n  - ")}`);
+        }
+        // Return typed config
+        return {
+            version: parsed.version,
+            registry: {
+                onnx: onnxModels,
+                transformers: transformersModels,
+            },
+        };
+    }
+    getConfig() {
+        if (!this.config) {
+            return this.load();
+        }
+        return this.config;
+    }
+    getOnnxModels() {
+        return this.getConfig().registry.onnx;
+    }
+    getTransformersModels() {
+        return this.getConfig().registry.transformers;
+    }
+    getOnnxModelByName(name) {
+        return this.getOnnxModels().find((m) => m.name === name);
+    }
+    getTransformersModelByName(name) {
+        return this.getTransformersModels().find((m) => m.name === name);
+    }
+    getAllModels() {
+        const config = this.getConfig();
+        return [...config.registry.onnx, ...config.registry.transformers];
+    }
+}
+exports.ModelLoader = ModelLoader;
+let loaderInstance = null;
+function getModelLoader(configPath) {
+    if (!loaderInstance) {
+        loaderInstance = new ModelLoader(configPath);
+    }
+    return loaderInstance;
+}
+//# sourceMappingURL=model-loader.js.map

package/dist/core/model-manager/model-loader.js.map

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

package/dist/core/model-manager/model-manager.config.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Model Manager Configuration Types
+ *
+ * Defines the structure of models.config.yaml for type-safe configuration loading.
+ */
+export interface ModelConfig {
+    name: string;
+    modelId: string;
+    version: string;
+    hash: string;
+    priority: number;
+    optional: boolean;
+    description?: string;
+    loadInApi?: boolean;
+}
+export interface OnnxAdditionalFile {
+    path: string;
+    hash: string;
+}
+export interface OnnxModelConfig extends ModelConfig {
+    path: string;
+    additionalFiles?: OnnxAdditionalFile[];
+}
+export interface ModelComponent {
+    name: string;
+    file: string;
+    hash: string;
+}
+export interface TransformersModelConfig extends ModelConfig {
+    path: string;
+    components: ModelComponent[];
+}
+export type ModelConfigType = OnnxModelConfig | TransformersModelConfig;
+export interface ModelRegistry {
+    onnx: OnnxModelConfig[];
+    transformers: TransformersModelConfig[];
+}
+export interface ModelsConfig {
+    version: string;
+    registry: ModelRegistry;
+}
+/**
+ * Validation result for configuration
+ */
+export interface ConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Model loading status
+ */
+export interface ModelLoadStatus {
+    name: string;
+    framework: "onnx" | "transformers";
+    status: "pending" | "loading" | "loaded" | "failed";
+    error?: string;
+    loadTimeMs?: number;
+}
+/**
+ * Download progress
+ */
+export interface DownloadProgress {
+    modelName: string;
+    component?: string;
+    percent: number;
+    downloadedBytes: number;
+    totalBytes: number;
+    speed: string;
+}
+/**
+ * Model cache metadata
+ */
+export interface ModelCacheMetadata {
+    name: string;
+    version: string;
+    hash: string;
+    cachedAt: number;
+    filePath: string;
+}
+//# sourceMappingURL=model-manager.config.d.ts.map

package/dist/core/model-manager/model-manager.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.config.d.ts","sourceRoot":"","sources":["../../../src/core/model-manager/model-manager.config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACxC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uBAAwB,SAAQ,WAAW;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,cAAc,EAAE,CAAC;CAC9B;AAED,MAAM,MAAM,eAAe,GAAG,eAAe,GAAG,uBAAuB,CAAC;AAExE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,YAAY,EAAE,uBAAuB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,cAAc,CAAC;IACnC,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/core/model-manager/model-manager.config.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Model Manager Configuration Types
+ *
+ * Defines the structure of models.config.yaml for type-safe configuration loading.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=model-manager.config.js.map

package/dist/core/model-manager/model-manager.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.config.js","sourceRoot":"","sources":["../../../src/core/model-manager/model-manager.config.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}

package/dist/core/model-manager/model-manager.module.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Model Manager Module
+ *
+ * Provides the centralized ModelManagerService for managing all ML models.
+ * This module should be imported in the main app module.
+ *
+ * Marked as @Global() so ModelManagerService is available app-wide without
+ * explicit imports in every module.
+ */
+export declare class ModelManagerModule {
+}
+//# sourceMappingURL=model-manager.module.d.ts.map

package/dist/core/model-manager/model-manager.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.module.d.ts","sourceRoot":"","sources":["../../../src/core/model-manager/model-manager.module.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,qBAKa,kBAAkB;CAAG"}

package/dist/core/model-manager/model-manager.module.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Model Manager Module
+ *
+ * Provides the centralized ModelManagerService for managing all ML models.
+ * This module should be imported in the main app module.
+ *
+ * Marked as @Global() so ModelManagerService is available app-wide without
+ * explicit imports in every module.
+ */
+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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ModelManagerModule = void 0;
+const common_1 = require("@nestjs/common");
+const model_manager_service_1 = require("./model-manager.service");
+let ModelManagerModule = class ModelManagerModule {
+};
+exports.ModelManagerModule = ModelManagerModule;
+exports.ModelManagerModule = ModelManagerModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: [model_manager_service_1.ModelManagerService],
+        exports: [model_manager_service_1.ModelManagerService],
+    })
+], ModelManagerModule);
+//# sourceMappingURL=model-manager.module.js.map

package/dist/core/model-manager/model-manager.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.module.js","sourceRoot":"","sources":["../../../src/core/model-manager/model-manager.module.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;;;;;;;AAEH,2CAAgD;AAChD,mEAA8D;AAOvD,IAAM,kBAAkB,GAAxB,MAAM,kBAAkB;CAAG,CAAA;AAArB,gDAAkB;6BAAlB,kBAAkB;IAL9B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,CAAC,2CAAmB,CAAC;QAChC,OAAO,EAAE,CAAC,2CAAmB,CAAC;KAC/B,CAAC;GACW,kBAAkB,CAAG"}

package/dist/core/model-manager/model-manager.service.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Model Manager Service
+ *
+ * Centralized service for managing all ML models:
+ * - Loads models.config.yaml
+ * - Downloads models on startup (runtime)
+ * - Verifies SHA256 hashes
+ * - Checks version compatibility
+ * - Caches ONNX sessions and Transformers models
+ * - Provides unified interface for model access
+ */
+import { OnApplicationBootstrap } from "@nestjs/common";
+import { AppModeConfig } from "../../common/decorators/conditional-service.decorator";
+import * as ort from "onnxruntime-node";
+import type { ModelLoadStatus } from "./model-manager.config";
+export declare class ModelManagerService implements OnApplicationBootstrap {
+    private readonly appModeConfig?;
+    private readonly logger;
+    private readonly config;
+    private readonly cacheDir;
+    private readonly baseUrl;
+    private readonly verifyHash;
+    private readonly strictHash;
+    private readonly autoUpdate;
+    private onnxSessions;
+    private transformersModels;
+    private loadStatus;
+    private readyPromise;
+    private readyResolver;
+    constructor(appModeConfig?: AppModeConfig);
+    /**
+     * Check if running in worker mode.
+     * Defaults to worker mode if no app mode config (tests, standalone scripts).
+     */
+    private isWorkerMode;
+    /**
+     * Determine if a model should be loaded based on current app mode.
+     * - Worker mode: load all models
+     * - API mode: only load models marked with loadInApi: true
+     */
+    private shouldLoadModel;
+    onApplicationBootstrap(): Promise<void>;
+    private loadModel;
+    private loadOnnxModel;
+    private loadTransformersModel;
+    private needsDownload;
+    private downloadFile;
+    private verifyFileHash;
+    private computeHash;
+    private ensureCacheDir;
+    getOnnxSession(name: string): ort.InferenceSession | null;
+    getTransformersModel(name: string, component?: string): any | null;
+    isModelLoaded(name: string, framework: "onnx" | "transformers"): boolean;
+    getLoadedModels(): {
+        onnx: string[];
+        transformers: string[];
+    };
+    getLoadStatus(): ModelLoadStatus[];
+    /**
+     * Wait for all models to be loaded.
+     * Services that depend on models should call this before accessing them.
+     */
+    waitForReady(): Promise<void>;
+}
+//# sourceMappingURL=model-manager.service.d.ts.map

package/dist/core/model-manager/model-manager.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-manager.service.d.ts","sourceRoot":"","sources":["../../../src/core/model-manager/model-manager.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAA8B,sBAAsB,EAAY,MAAM,gBAAgB,CAAC;AAC9F,OAAO,EAA2B,aAAa,EAAE,MAAM,uDAAuD,CAAC;AAI/G,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAExC,OAAO,KAAK,EAKV,eAAe,EAChB,MAAM,wBAAwB,CAAC;AAEhC,qBACa,mBAAoB,YAAW,sBAAsB;IAsBhB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;IArB/E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAe;IACtC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IACrC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAU;IAGrC,OAAO,CAAC,YAAY,CAAgD;IAGpE,OAAO,CAAC,kBAAkB,CAA4C;IAGtE,OAAO,CAAC,UAAU,CAAyB;IAG3C,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,aAAa,CAAc;gBAE8B,aAAa,CAAC,EAAE,aAAa;IAsB9F;;;OAGG;IACH,OAAO,CAAC,YAAY;IAKpB;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAKjB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;YA8C/B,SAAS;YAuCT,aAAa;YAmEb,qBAAqB;YAyCrB,aAAa;YAiCb,YAAY;IAqF1B,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,cAAc;IAQtB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,GAAG,CAAC,gBAAgB,GAAG,IAAI;IAIzD,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAWlE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO;IAOxE,eAAe,IAAI;QAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE;IAO7D,aAAa,IAAI,eAAe,EAAE;IAIlC;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC"}