@solidxai/core 0.0.2

package/dist/services/file/s3-file.service.js

@@ -0,0 +1,187 @@
+"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 S3FileService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3FileService = void 0;
+const common_1 = require("@nestjs/common");
+const client_s3_1 = require("@aws-sdk/client-s3");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+const error_messages_1 = require("../../constants/error-messages");
+let S3FileService = S3FileService_1 = class S3FileService {
+    constructor() {
+        this.logger = new common_1.Logger(S3FileService_1.name);
+        this.s3ClientCache = new Map();
+        this.defaultRegion = null;
+        this.defaultBucket = null;
+        this.accessKey = null;
+        this.secretKey = null;
+    }
+    onModuleInit() {
+        this.initializeS3Credentials();
+    }
+    initializeS3Credentials() {
+        this.accessKey = process.env.S3_AWS_ACCESS_KEY || null;
+        this.secretKey = process.env.S3_AWS_SECRET_KEY || null;
+        this.defaultRegion = process.env.S3_AWS_REGION_NAME || null;
+        this.defaultBucket = process.env.S3_DEFAULT_BUCKET || null;
+        if (!this.accessKey || !this.secretKey) {
+            this.logger.warn('S3 credentials not fully configured. S3FileService will not be available.');
+            return;
+        }
+        if (this.defaultRegion) {
+            this.getOrCreateClient(this.defaultRegion);
+            this.logger.log(`S3FileService initialized successfully with default region: ${this.defaultRegion}`);
+        }
+        else {
+            this.logger.log('S3FileService initialized successfully (no default region, will use per-request region)');
+        }
+    }
+    getOrCreateClient(region) {
+        if (!this.accessKey || !this.secretKey) {
+            throw new Error(error_messages_1.ERROR_MESSAGES.S3_CLIENT_NOT_INITIALIZED);
+        }
+        let client = this.s3ClientCache.get(region);
+        if (!client) {
+            client = new client_s3_1.S3Client({
+                region,
+                credentials: {
+                    accessKeyId: this.accessKey,
+                    secretAccessKey: this.secretKey,
+                },
+            });
+            this.s3ClientCache.set(region, client);
+            this.logger.debug(`Created S3 client for region: ${region}`);
+        }
+        return client;
+    }
+    getS3Client(region) {
+        const effectiveRegion = region || this.defaultRegion;
+        if (!effectiveRegion) {
+            throw new Error('S3 region not specified and no default region configured. Please provide a region or set S3_AWS_REGION_NAME environment variable.');
+        }
+        return this.getOrCreateClient(effectiveRegion);
+    }
+    parsePath(path) {
+        const colonIndex = path.indexOf(':');
+        if (colonIndex > 0 && colonIndex < path.length - 1) {
+            return {
+                bucket: path.substring(0, colonIndex),
+                key: path.substring(colonIndex + 1),
+            };
+        }
+        if (this.defaultBucket) {
+            return { bucket: this.defaultBucket, key: path };
+        }
+        throw new Error(`Invalid S3 path format: "${path}". Expected format: "bucket:key" or set S3_DEFAULT_BUCKET environment variable.`);
+    }
+    async read(path, options) {
+        const s3Client = this.getS3Client(options?.region);
+        const { bucket, key } = this.parsePath(path);
+        const command = new client_s3_1.GetObjectCommand({ Bucket: bucket, Key: key });
+        const response = await s3Client.send(command);
+        const stream = response.Body;
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.from(chunk));
+        }
+        return Buffer.concat(chunks);
+    }
+    async readStream(path, options) {
+        const s3Client = this.getS3Client(options?.region);
+        const { bucket, key } = this.parsePath(path);
+        const command = new client_s3_1.GetObjectCommand({ Bucket: bucket, Key: key });
+        const response = await s3Client.send(command);
+        return response.Body;
+    }
+    async write(path, data, options) {
+        const region = options?.region || this.defaultRegion;
+        const s3Client = this.getS3Client(region);
+        const { bucket, key } = this.parsePath(path);
+        const command = new client_s3_1.PutObjectCommand({
+            Bucket: bucket,
+            Key: key,
+            Body: typeof data === 'string' ? Buffer.from(data) : data,
+            ContentType: options?.contentType,
+        });
+        await s3Client.send(command);
+        this.logger.debug(`File uploaded to S3: ${bucket}/${key}`);
+        return `https://${bucket}.s3.${region}.amazonaws.com/${key}`;
+    }
+    async writeStream(path, stream, options) {
+        const region = options?.region || this.defaultRegion;
+        const s3Client = this.getS3Client(region);
+        const { bucket, key } = this.parsePath(path);
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(Buffer.from(chunk));
+        }
+        const buffer = Buffer.concat(chunks);
+        const command = new client_s3_1.PutObjectCommand({
+            Bucket: bucket,
+            Key: key,
+            Body: buffer,
+            ContentType: options?.contentType,
+        });
+        await s3Client.send(command);
+        this.logger.debug(`File uploaded to S3 via stream: ${bucket}/${key}`);
+        return `https://${bucket}.s3.${region}.amazonaws.com/${key}`;
+    }
+    async delete(path, options) {
+        const s3Client = this.getS3Client(options?.region);
+        const { bucket, key } = this.parsePath(path);
+        const command = new client_s3_1.DeleteObjectCommand({ Bucket: bucket, Key: key });
+        await s3Client.send(command);
+        this.logger.debug(`File deleted from S3: ${bucket}/${key}`);
+    }
+    async exists(path, options) {
+        const s3Client = this.getS3Client(options?.region);
+        const { bucket, key } = this.parsePath(path);
+        try {
+            const command = new client_s3_1.HeadObjectCommand({ Bucket: bucket, Key: key });
+            await s3Client.send(command);
+            return true;
+        }
+        catch (error) {
+            if (error.name === 'NotFound' || error.$metadata?.httpStatusCode === 404) {
+                return false;
+            }
+            throw error;
+        }
+    }
+    async copy(sourcePath, destinationPath, options) {
+        const s3Client = this.getS3Client(options?.region);
+        if (options?.overwrite === false) {
+            const destinationExists = await this.exists(destinationPath, { region: options?.region });
+            if (destinationExists) {
+                throw new Error(`Destination file already exists: ${destinationPath}`);
+            }
+        }
+        const source = this.parsePath(sourcePath);
+        const destination = this.parsePath(destinationPath);
+        const command = new client_s3_1.CopyObjectCommand({
+            Bucket: destination.bucket,
+            Key: destination.key,
+            CopySource: `${source.bucket}/${source.key}`,
+            ContentType: options?.contentType,
+        });
+        await s3Client.send(command);
+        this.logger.debug(`File copied in S3: ${source.bucket}/${source.key} -> ${destination.bucket}/${destination.key}`);
+    }
+    async getUrl(path, options) {
+        const s3Client = this.getS3Client(options?.region);
+        const { bucket, key } = this.parsePath(path);
+        const command = new client_s3_1.GetObjectCommand({ Bucket: bucket, Key: key });
+        const expiresIn = options?.expiresIn || 3600;
+        return options.expiresIn > 0 ? (0, s3_request_presigner_1.getSignedUrl)(s3Client, command, { expiresIn }) : `https://${bucket}.s3.${options?.region || this.defaultRegion}.amazonaws.com/${key}`;
+    }
+};
+exports.S3FileService = S3FileService;
+exports.S3FileService = S3FileService = S3FileService_1 = __decorate([
+    (0, common_1.Injectable)()
+], S3FileService);
+//# sourceMappingURL=s3-file.service.js.map

package/dist/services/file/s3-file.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3-file.service.js","sourceRoot":"","sources":["../../../src/services/file/s3-file.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable, Logger, OnModuleInit } from '@nestjs/common';\nimport {\n  S3Client,\n  GetObjectCommand,\n  PutObjectCommand,\n  DeleteObjectCommand,\n  HeadObjectCommand,\n  CopyObjectCommand,\n} from '@aws-sdk/client-s3';\nimport { getSignedUrl } from '@aws-sdk/s3-request-presigner';\nimport { Readable } from 'stream';\nimport { IFileService, WriteOptions, CopyOptions, UrlOptions, ReadOptions, DeleteOptions, ExistsOptions } from './file-service.interface';\nimport { ERROR_MESSAGES } from 'src/constants/error-messages';\n\n/**\n * S3-based implementation of IFileService.\n * Handles file operations on AWS S3.\n *\n * Configuration via environment variables:\n * - S3_AWS_ACCESS_KEY: AWS access key ID\n * - S3_AWS_SECRET_KEY: AWS secret access key\n * - S3_AWS_REGION_NAME: AWS region\n * - S3_DEFAULT_BUCKET: Default bucket used when path has no \"bucket:\" prefix\n *\n * Path format: \"bucket:key\" or just \"key\" (falls back to S3_DEFAULT_BUCKET)\n */\n@Injectable()\nexport class S3FileService implements IFileService, OnModuleInit {\n  private readonly logger = new Logger(S3FileService.name);\n  private readonly s3ClientCache = new Map<string, S3Client>();\n  private defaultRegion: string | null = null;\n  private defaultBucket: string | null = null;\n  private accessKey: string | null = null;\n  private secretKey: string | null = null;\n\n  onModuleInit() {\n    this.initializeS3Credentials();\n  }\n\n  private initializeS3Credentials(): void {\n    this.accessKey = process.env.S3_AWS_ACCESS_KEY || null;\n    this.secretKey = process.env.S3_AWS_SECRET_KEY || null;\n    this.defaultRegion = process.env.S3_AWS_REGION_NAME || null;\n    this.defaultBucket = process.env.S3_DEFAULT_BUCKET || null;\n\n    if (!this.accessKey || !this.secretKey) {\n      this.logger.warn('S3 credentials not fully configured. S3FileService will not be available.');\n      return;\n    }\n\n    // Pre-initialize client for default region if available\n    if (this.defaultRegion) {\n      this.getOrCreateClient(this.defaultRegion);\n      this.logger.log(`S3FileService initialized successfully with default region: ${this.defaultRegion}`);\n    } else {\n      this.logger.log('S3FileService initialized successfully (no default region, will use per-request region)');\n    }\n  }\n\n  private getOrCreateClient(region: string): S3Client {\n    if (!this.accessKey || !this.secretKey) {\n      throw new Error(ERROR_MESSAGES.S3_CLIENT_NOT_INITIALIZED);\n    }\n\n    let client = this.s3ClientCache.get(region);\n    if (!client) {\n      client = new S3Client({\n        region,\n        credentials: {\n          accessKeyId: this.accessKey,\n          secretAccessKey: this.secretKey,\n        },\n      });\n      this.s3ClientCache.set(region, client);\n      this.logger.debug(`Created S3 client for region: ${region}`);\n    }\n    return client;\n  }\n\n  private getS3Client(region?: string): S3Client {\n    const effectiveRegion = region || this.defaultRegion;\n    if (!effectiveRegion) {\n      throw new Error('S3 region not specified and no default region configured. Please provide a region or set S3_AWS_REGION_NAME environment variable.');\n    }\n    return this.getOrCreateClient(effectiveRegion);\n  }\n\n  /**\n   * Parse path to extract bucket and key.\n   * Format: \"bucket:key\" or just \"key\" (falls back to S3_DEFAULT_BUCKET)\n   *\n   * @param path - Path in format \"bucket:key\" or just \"key\"\n   * @returns Object with bucket and key\n   * @throws Error if no bucket can be resolved\n   */\n  private parsePath(path: string): { bucket: string; key: string } {\n    const colonIndex = path.indexOf(':');\n    if (colonIndex > 0 && colonIndex < path.length - 1) {\n      return {\n        bucket: path.substring(0, colonIndex),\n        key: path.substring(colonIndex + 1),\n      };\n    }\n    if (this.defaultBucket) {\n      return { bucket: this.defaultBucket, key: path };\n    }\n    throw new Error(`Invalid S3 path format: \"${path}\". Expected format: \"bucket:key\" or set S3_DEFAULT_BUCKET environment variable.`);\n  }\n\n  /**\n   * Read file contents as Buffer\n   */\n  async read(path: string, options?: ReadOptions): Promise<Buffer> {\n    const s3Client = this.getS3Client(options?.region);\n    const { bucket, key } = this.parsePath(path);\n\n    const command = new GetObjectCommand({ Bucket: bucket, Key: key });\n    const response = await s3Client.send(command);\n\n    // Convert stream to buffer\n    const stream = response.Body as Readable;\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      chunks.push(Buffer.from(chunk));\n    }\n    return Buffer.concat(chunks);\n  }\n\n  /**\n   * Read file contents as a stream\n   */\n  async readStream(path: string, options?: ReadOptions): Promise<Readable> {\n    const s3Client = this.getS3Client(options?.region);\n    const { bucket, key } = this.parsePath(path);\n\n    const command = new GetObjectCommand({ Bucket: bucket, Key: key });\n    const response = await s3Client.send(command);\n\n    return response.Body as Readable;\n  }\n\n  /**\n   * Write data to S3\n   * @returns Public URL of the uploaded file\n   */\n  async write(path: string, data: Buffer | string, options?: WriteOptions): Promise<string> {\n    const region = options?.region || this.defaultRegion;\n    const s3Client = this.getS3Client(region);\n    const { bucket, key } = this.parsePath(path);\n\n    const command = new PutObjectCommand({\n      Bucket: bucket,\n      Key: key,\n      Body: typeof data === 'string' ? Buffer.from(data) : data,\n      ContentType: options?.contentType,\n    });\n\n    await s3Client.send(command);\n    this.logger.debug(`File uploaded to S3: ${bucket}/${key}`);\n    return `https://${bucket}.s3.${region}.amazonaws.com/${key}`;\n  }\n\n  /**\n   * Write a stream to S3\n   * @returns Public URL of the uploaded file\n   */\n  async writeStream(path: string, stream: Readable, options?: WriteOptions): Promise<string> {\n    const region = options?.region || this.defaultRegion;\n    const s3Client = this.getS3Client(region);\n    const { bucket, key } = this.parsePath(path);\n\n    // For streaming uploads, we need to collect the stream into a buffer\n    // For very large files, consider using @aws-sdk/lib-storage Upload class\n    const chunks: Buffer[] = [];\n    for await (const chunk of stream) {\n      chunks.push(Buffer.from(chunk));\n    }\n    const buffer = Buffer.concat(chunks);\n\n    const command = new PutObjectCommand({\n      Bucket: bucket,\n      Key: key,\n      Body: buffer,\n      ContentType: options?.contentType,\n    });\n\n    await s3Client.send(command);\n    this.logger.debug(`File uploaded to S3 via stream: ${bucket}/${key}`);\n    return `https://${bucket}.s3.${region}.amazonaws.com/${key}`;\n  }\n\n  /**\n   * Delete a file from S3\n   */\n  async delete(path: string, options?: DeleteOptions): Promise<void> {\n    const s3Client = this.getS3Client(options?.region);\n    const { bucket, key } = this.parsePath(path);\n\n    const command = new DeleteObjectCommand({ Bucket: bucket, Key: key });\n    await s3Client.send(command);\n    this.logger.debug(`File deleted from S3: ${bucket}/${key}`);\n  }\n\n  /**\n   * Check if file exists in S3\n   */\n  async exists(path: string, options?: ExistsOptions): Promise<boolean> {\n    const s3Client = this.getS3Client(options?.region);\n    const { bucket, key } = this.parsePath(path);\n\n    try {\n      const command = new HeadObjectCommand({ Bucket: bucket, Key: key });\n      await s3Client.send(command);\n      return true;\n    } catch (error: any) {\n      if (error.name === 'NotFound' || error.$metadata?.httpStatusCode === 404) {\n        return false;\n      }\n      throw error;\n    }\n  }\n\n  /**\n   * Copy a file within S3 (same or different bucket)\n   */\n  async copy(sourcePath: string, destinationPath: string, options?: CopyOptions): Promise<void> {\n    const s3Client = this.getS3Client(options?.region);\n\n    if (options?.overwrite === false) {\n      const destinationExists = await this.exists(destinationPath, { region: options?.region });\n      if (destinationExists) {\n        throw new Error(`Destination file already exists: ${destinationPath}`);\n      }\n    }\n\n    const source = this.parsePath(sourcePath);\n    const destination = this.parsePath(destinationPath);\n\n    const command = new CopyObjectCommand({\n      Bucket: destination.bucket,\n      Key: destination.key,\n      CopySource: `${source.bucket}/${source.key}`,\n      ContentType: options?.contentType,\n    });\n\n    await s3Client.send(command);\n    this.logger.debug(`File copied in S3: ${source.bucket}/${source.key} -> ${destination.bucket}/${destination.key}`);\n  }\n\n  /**\n   * Get a signed URL for the file\n   */\n  async getUrl(path: string, options?: UrlOptions): Promise<string> {\n    const s3Client = this.getS3Client(options?.region);\n    const { bucket, key } = this.parsePath(path);\n\n    const command = new GetObjectCommand({ Bucket: bucket, Key: key });\n    const expiresIn = options?.expiresIn || 3600; // Default 1 hour\n\n    return options.expiresIn > 0? getSignedUrl(s3Client, command, { expiresIn }) : `https://${bucket}.s3.${options?.region || this.defaultRegion}.amazonaws.com/${key}`;\n  }\n}\n"]}

package/dist/services/fixtures.service.d.ts

@@ -0,0 +1,13 @@
+import { SolidIntrospectService } from "./solid-introspect.service";
+import { ModuleMetadataHelperService } from "src/helpers/module-metadata-helper.service";
+export declare class FixturesService {
+    private readonly introspectService;
+    private readonly moduleMetadataHelper;
+    private readonly logger;
+    constructor(introspectService: SolidIntrospectService, moduleMetadataHelper: ModuleMetadataHelperService);
+    setupFixtures(moduleName: string, scenarioName: string): Promise<void>;
+    tearDownFixtures(moduleName: string, scenarioName: string): Promise<void>;
+    private loadScenario;
+    private loadModelService;
+}
+//# sourceMappingURL=fixtures.service.d.ts.map

package/dist/services/fixtures.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.service.d.ts","sourceRoot":"","sources":["../../src/services/fixtures.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,2BAA2B,EAAE,MAAM,4CAA4C,CAAC;AAYzF,qBACa,eAAe;IAIpB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAJzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;gBAGvC,iBAAiB,EAAE,sBAAsB,EACzC,oBAAoB,EAAE,2BAA2B;IAGhE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;IAoBtD,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;YAyBjD,YAAY;YA8BZ,gBAAgB;CASjC"}

package/dist/services/fixtures.service.js

@@ -0,0 +1,95 @@
+"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);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixturesService = void 0;
+const common_1 = require("@nestjs/common");
+const solid_introspect_service_1 = require("./solid-introspect.service");
+const module_metadata_helper_service_1 = require("../helpers/module-metadata-helper.service");
+const strings_1 = require("@angular-devkit/core/src/utils/strings");
+let FixturesService = class FixturesService {
+    constructor(introspectService, moduleMetadataHelper) {
+        this.introspectService = introspectService;
+        this.moduleMetadataHelper = moduleMetadataHelper;
+        this.logger = new common_1.Logger(this.constructor.name);
+    }
+    async setupFixtures(moduleName, scenarioName) {
+        const scenarioFixture = await this.loadScenario(moduleName, scenarioName);
+        if (!scenarioFixture?.models || scenarioFixture.models.length === 0) {
+            this.logger.warn(`No models found to setup for scenario: ${scenarioName} in module: ${moduleName}`);
+            return;
+        }
+        for (const modelFixture of scenarioFixture.models) {
+            const modelServiceInstance = await this.loadModelService(modelFixture.singularName);
+            try {
+                const createdInstance = await modelServiceInstance.create(modelFixture.data);
+                this.logger.log(`Successfully created fixture for model: ${modelFixture.singularName} with ID: ${createdInstance.id}`);
+            }
+            catch (error) {
+                this.logger.error(`Error creating fixture for model: ${modelFixture.singularName} - ${error.message}`);
+            }
+        }
+    }
+    async tearDownFixtures(moduleName, scenarioName) {
+        const scenarioFixture = await this.loadScenario(moduleName, scenarioName);
+        if (!scenarioFixture?.models || scenarioFixture.models.length === 0) {
+            this.logger.warn(`No models found to tear down for scenario: ${scenarioName} in module: ${moduleName}`);
+            return;
+        }
+        for (const modelFixture of scenarioFixture.models.reverse()) {
+            const modelServiceInstance = await this.loadModelService(modelFixture.singularName);
+            try {
+                const deleteCriteria = modelFixture.data;
+                await modelServiceInstance.delete(deleteCriteria);
+                this.logger.log(`Successfully deleted fixture for model: ${modelFixture.singularName}`);
+            }
+            catch (error) {
+                this.logger.error(`Error deleting fixture for model: ${modelFixture.singularName} - ${error.message}`);
+            }
+        }
+    }
+    async loadScenario(moduleName, scenarioName) {
+        const moduleMetadataConfiguration = await this.moduleMetadataHelper.getModuleMetadataConfiguration(await this.moduleMetadataHelper.getModuleMetadataFilePath(moduleName));
+        if (!moduleMetadataConfiguration) {
+            this.logger.error(`No module metadata configuration found for module: ${moduleName}`);
+            return;
+        }
+        this.logger.debug(`Module Metadata Configuration loaded for module: ${moduleName}`);
+        const allFixtures = moduleMetadataConfiguration?.fixtures;
+        this.logger.debug(`All Fixtures: ${JSON.stringify(allFixtures)}`);
+        if (!allFixtures?.scenarios.length || allFixtures?.scenarios.length === 0) {
+            this.logger.error(`No scenarios defined in the module metadata configuration for module: ${moduleName}`);
+            return;
+        }
+        const scenarioFixture = allFixtures.scenarios.find((scenario) => scenario.name === scenarioName);
+        if (!scenarioFixture) {
+            this.logger.error(`Scenario: ${scenarioName} not found in module metadata configuration for module: ${moduleName}`);
+            return;
+        }
+        this.logger.log(`Scenario: ${scenarioName} found with fixtures to setup.`);
+        return scenarioFixture;
+    }
+    async loadModelService(singularName) {
+        const modelServiceProvider = this.introspectService.getProvider(`${(0, strings_1.classify)(singularName)}Service`);
+        if (!modelServiceProvider) {
+            this.logger.error(`Model service provider not found for model: ${singularName}`);
+            return null;
+        }
+        this.logger.debug(`Model service provider found for model: ${singularName}`);
+        return modelServiceProvider.instance;
+    }
+};
+exports.FixturesService = FixturesService;
+exports.FixturesService = FixturesService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [solid_introspect_service_1.SolidIntrospectService,
+        module_metadata_helper_service_1.ModuleMetadataHelperService])
+], FixturesService);
+//# sourceMappingURL=fixtures.service.js.map

package/dist/services/fixtures.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.service.js","sourceRoot":"","sources":["../../src/services/fixtures.service.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable, Logger } from \"@nestjs/common\";\nimport { SolidIntrospectService } from \"./solid-introspect.service\";\nimport { ModuleMetadataHelperService } from \"src/helpers/module-metadata-helper.service\";\nimport { classify } from \"@angular-devkit/core/src/utils/strings\";\n\ninterface ScenarioFixture {\n    name: string;\n    models: {\n        singularName: string;\n        data: any;\n    }[];\n}\n\n// This service can contain common logic for fixtures setup and tear down\n@Injectable()\nexport class FixturesService {\n    private readonly logger = new Logger(this.constructor.name);\n\n    constructor(\n        private readonly introspectService: SolidIntrospectService,\n        private readonly moduleMetadataHelper: ModuleMetadataHelperService,\n    ) { }\n\n    async setupFixtures(moduleName: string, scenarioName: string) {\n        const scenarioFixture = await this.loadScenario(moduleName, scenarioName);\n        if (!scenarioFixture?.models || scenarioFixture.models.length === 0) {\n            this.logger.warn(`No models found to setup for scenario: ${scenarioName} in module: ${moduleName}`);\n            return;\n        }\n\n        // For each model in the fixtures, use introspectService to get model service\n        for (const modelFixture of scenarioFixture.models) {\n            const modelServiceInstance = await this.loadModelService(modelFixture.singularName);\n            try {\n                // Create the model instance in the database\n                const createdInstance = await modelServiceInstance.create(modelFixture.data);\n                this.logger.log(`Successfully created fixture for model: ${modelFixture.singularName} with ID: ${createdInstance.id}`);\n            } catch (error) {\n                this.logger.error(`Error creating fixture for model: ${modelFixture.singularName} - ${error.message}`);\n            }\n        }\n    }\n\n    async tearDownFixtures(moduleName: string, scenarioName: string) {\n        // Call delete on the modelService to remove the created fixtures, in reverse order\n        const scenarioFixture = await this.loadScenario(moduleName, scenarioName);\n        if (!scenarioFixture?.models || scenarioFixture.models.length === 0) {\n            this.logger.warn(`No models found to tear down for scenario: ${scenarioName} in module: ${moduleName}`);\n            return;\n        }\n\n        // For each model in reverse order\n        for (const modelFixture of scenarioFixture.models.reverse()) {\n            const modelServiceInstance = await this.loadModelService(modelFixture.singularName);\n\n            // Get the user key field for the model to identify the created instances\n            try {\n                // Assuming we have some way to identify the created instances, e.g., by a unique field in data\n                const deleteCriteria = modelFixture.data; // This should be adjusted based on actual criteria\n                await modelServiceInstance.delete(deleteCriteria);\n                this.logger.log(`Successfully deleted fixture for model: ${modelFixture.singularName}`);\n            } catch (error) {\n                this.logger.error(`Error deleting fixture for model: ${modelFixture.singularName} - ${error.message}`);\n            }\n        }\n\n    }\n\n    private async loadScenario(moduleName: string, scenarioName: string): Promise<ScenarioFixture | undefined> {\n        // Read the module metadata file based on module name\n        const moduleMetadataConfiguration = await this.moduleMetadataHelper.getModuleMetadataConfiguration(\n            await this.moduleMetadataHelper.getModuleMetadataFilePath(moduleName)\n        );\n        if (!moduleMetadataConfiguration) {\n            this.logger.error(`No module metadata configuration found for module: ${moduleName}`);\n            return;\n        }\n        this.logger.debug(`Module Metadata Configuration loaded for module: ${moduleName}`);\n\n        // Read the fixtures json from above file\n        const allFixtures = moduleMetadataConfiguration?.fixtures;\n        this.logger.debug(`All Fixtures: ${JSON.stringify(allFixtures)}`);\n        // Check if scenarios exists\n        if (!allFixtures?.scenarios.length || allFixtures?.scenarios.length === 0) {\n            this.logger.error(`No scenarios defined in the module metadata configuration for module: ${moduleName}`);\n            return;\n        }\n\n        // Find the fixtures for the given scenario\n        const scenarioFixture = allFixtures.scenarios.find((scenario: ScenarioFixture) => scenario.name === scenarioName);\n        if (!scenarioFixture) {\n            this.logger.error(`Scenario: ${scenarioName} not found in module metadata configuration for module: ${moduleName}`);\n            return;\n        }\n        this.logger.log(`Scenario: ${scenarioName} found with fixtures to setup.`);\n        return scenarioFixture;\n    }\n\n    private async loadModelService(singularName: string): Promise<any> {\n        const modelServiceProvider = this.introspectService.getProvider(`${classify(singularName)}Service`);\n        if (!modelServiceProvider) {\n            this.logger.error(`Model service provider not found for model: ${singularName}`);\n            return null;\n        }\n        this.logger.debug(`Model service provider found for model: ${singularName}`);\n        return modelServiceProvider.instance;\n    }\n}"]}

package/dist/services/genai/ingest-metadata.service.d.ts

@@ -0,0 +1,38 @@
+import { R2RHelperService } from './r2r-helper.service';
+export type FieldIngestionInfo = {
+    fieldName: string;
+    fieldChunkId?: string;
+    fieldHash?: string;
+};
+export type ModelIngestionInfo = {
+    modelName: string;
+    modelChunkId?: string;
+    modelHash?: string;
+    fields: FieldIngestionInfo[];
+};
+export type ModuleRAGIngestionInfo = {
+    moduleName?: string;
+    collectionId?: string;
+    documentId?: string;
+    documentHash?: string;
+    moduleChunkId?: string;
+    moduleHash?: string;
+    models: ModelIngestionInfo[];
+};
+export declare class IngestMetadataService {
+    private readonly r2rService;
+    private readonly logger;
+    private ragClient;
+    constructor(r2rService: R2RHelperService);
+    private _sha256OfJson;
+    private _oneLineBool;
+    private _shortList;
+    ingest(): Promise<void>;
+    private resolveRagCollectionForModule;
+    private deleteInsertRagDocumentForModuleMetadataJsonFile;
+    private deleteInsertRagChunkForModule;
+    private deleteInsertRagChunkForModel;
+    private _buildFieldTextAndMetadata;
+    private deleteInsertRagChunkForField;
+}
+//# sourceMappingURL=ingest-metadata.service.d.ts.map

package/dist/services/genai/ingest-metadata.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingest-metadata.service.d.ts","sourceRoot":"","sources":["../../../src/services/genai/ingest-metadata.service.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAKxD,MAAM,MAAM,kBAAkB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IAGtB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;IAGpB,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAChC,CAAC;AAEF,qBACa,qBAAqB;IAK1B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAJ/B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,SAAS,CAAY;gBAGR,UAAU,EAAE,gBAAgB;IAajD,OAAO,CAAC,aAAa;IAerB,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,UAAU;IAMZ,MAAM;YAwFE,6BAA6B;YAmD7B,gDAAgD;YAqDhD,6BAA6B;YAuG7B,4BAA4B;IAqI1C,OAAO,CAAC,0BAA0B;YA+NpB,4BAA4B;CA4D7C"}