@carlonicora/nestjs-neo4jsonapi 0.0.1

package/dist/core/jsonapi/serialisers/jsonapi.paginator.js.map

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

package/dist/core/jsonapi/services/jsonapi.service.d.ts

@@ -0,0 +1,26 @@
+import { ConfigService } from "@nestjs/config";
+import { ClsService } from "nestjs-cls";
+import { BaseConfigInterface } from "../../../config/interfaces";
+import { DataModelInterface, JsonApiSerialiserFactory } from "../factories/jsonapi.serialiser.factory";
+import { JsonApiDataInterface } from "../interfaces/jsonapi.data.interface";
+import { JsonApiPaginator } from "../serialisers/jsonapi.paginator";
+export interface LoggingService {
+    error(message: string, ...args: any[]): void;
+    warn(message: string, ...args: any[]): void;
+    log(message: string, ...args: any[]): void;
+    debug(message: string, ...args: any[]): void;
+}
+export declare class JsonApiService {
+    private readonly serialiserFactory;
+    private readonly clsService;
+    private readonly configService;
+    constructor(serialiserFactory: JsonApiSerialiserFactory, clsService: ClsService, configService: ConfigService<BaseConfigInterface>);
+    private get apiConfig();
+    buildSingle<T extends DataModelInterface<any>>(model: T, record: any): Promise<any>;
+    buildList<T extends DataModelInterface<any>>(model: T, records: any[], paginator?: JsonApiPaginator): Promise<any>;
+    private _addToIncluded;
+    serialise<T, R extends JsonApiDataInterface>(data: T | T[], builder: R, url: string, paginator?: JsonApiPaginator): Promise<JsonApiDataInterface>;
+    private serialiseData;
+    private serialiseRelationship;
+}
+//# sourceMappingURL=jsonapi.service.d.ts.map

package/dist/core/jsonapi/services/jsonapi.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonapi.service.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/services/jsonapi.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,mBAAmB,EAAsB,MAAM,4BAA4B,CAAC;AACrF,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,yCAAyC,CAAC;AACvG,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGpE,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC7C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC5C,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAC3C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;CAC9C;AAED,qBACa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAFb,iBAAiB,EAAE,wBAAwB,EAC3C,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAGpE,OAAO,KAAK,SAAS,GAEpB;IAEK,WAAW,CAAC,CAAC,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAkBnF,SAAS,CAAC,CAAC,SAAS,kBAAkB,CAAC,GAAG,CAAC,EAC/C,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,GAAG,EAAE,EACd,SAAS,CAAC,EAAE,gBAAgB,GAC3B,OAAO,CAAC,GAAG,CAAC;IAUf,OAAO,CAAC,cAAc;IAqBhB,SAAS,CAAC,CAAC,EAAE,CAAC,SAAS,oBAAoB,EAC/C,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EACb,OAAO,EAAE,CAAC,EACV,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,gBAAgB,GAC3B,OAAO,CAAC,oBAAoB,CAAC;YA0ClB,aAAa;YAwJb,qBAAqB;CA+EpC"}

package/dist/core/jsonapi/services/jsonapi.service.js

@@ -0,0 +1,277 @@
+"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.JsonApiService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_serialiser_factory_1 = require("../factories/jsonapi.serialiser.factory");
+let JsonApiService = class JsonApiService {
+    constructor(serialiserFactory, clsService, configService) {
+        this.serialiserFactory = serialiserFactory;
+        this.clsService = clsService;
+        this.configService = configService;
+    }
+    get apiConfig() {
+        return this.configService.get("api");
+    }
+    async buildSingle(model, record) {
+        const builder = this.serialiserFactory.create(model);
+        if (!record)
+            throw new common_1.HttpException(`not found`, common_1.HttpStatus.NOT_FOUND);
+        if (typeof record[`${builder.id}`] === "string")
+            return await this.serialise(record, builder.create(), `${this.apiConfig.url}${builder.endpoint}/${record[`${builder.id}`]}`);
+        return await this.serialise(record, builder.create(), `${this.apiConfig.url}${builder.endpoint}/${record[`${builder.id}`]}`);
+    }
+    async buildList(model, records, paginator) {
+        const builder = this.serialiserFactory.create(model);
+        // Use request URL from CLS if available, fallback to model endpoint
+        const requestUrl = this.clsService?.get("requestUrl");
+        const url = requestUrl || `${this.apiConfig.url}${builder.endpoint}${builder.endpointParameters}`;
+        return await this.serialise(records, builder.create(), url, paginator);
+    }
+    _addToIncluded(includedElements, newElements, paginator) {
+        const uniqueIdentifiers = new Set(includedElements.map((e) => `${e.type}-${e.id}`));
+        newElements.forEach((element) => {
+            // If include parameter was explicitly specified, filter based on includedType
+            if (paginator && paginator.includeSpecified) {
+                if (!paginator.includedType.includes(element.type)) {
+                    return; // Filter out types not in the include parameter
+                }
+            }
+            // If include not specified, allow all types (default behavior)
+            const identifier = `${element.type}-${element.id}`;
+            if (!uniqueIdentifiers.has(identifier)) {
+                includedElements.push(element);
+                uniqueIdentifiers.add(identifier);
+            }
+        });
+    }
+    async serialise(data, builder, url, paginator) {
+        const response = {
+            links: {
+                self: url,
+            },
+            data: undefined,
+        };
+        if (paginator && Array.isArray(data)) {
+            if (url) {
+                const links = paginator.generateLinks(data, url);
+                response.links.self = links.self;
+                if (links.next)
+                    response.links.next = links.next;
+                if (links.previous)
+                    response.links.prev = links.previous;
+            }
+            else {
+                delete response.links;
+            }
+        }
+        const included = [];
+        if (Array.isArray(data)) {
+            const serialisedResults = await Promise.all(data.map((item) => this.serialiseData(item, builder, paginator)));
+            response.data = serialisedResults.map((result) => result.serialisedData);
+            this._addToIncluded(included, [].concat(...serialisedResults.map((result) => result.includedElements)), paginator);
+        }
+        else {
+            const { serialisedData, includedElements } = await this.serialiseData(data, builder, paginator);
+            response.data = serialisedData;
+            this._addToIncluded(included, includedElements, paginator);
+        }
+        if (included.length > 0)
+            response.included = included;
+        return response;
+    }
+    async serialiseData(data, builder, paginator) {
+        const includedElements = [];
+        const serialisedData = {
+            type: builder.type,
+        };
+        if (typeof builder.id === "function") {
+            serialisedData.id = builder.id(data);
+        }
+        else {
+            serialisedData.id = data[builder.id];
+        }
+        if (builder.links) {
+            serialisedData.links = {
+                self: builder.links.self(data),
+            };
+        }
+        serialisedData.attributes = {};
+        for (const attribute of Object.keys(builder.attributes)) {
+            let includedField;
+            if (paginator) {
+                includedField = paginator.includedFields.find((includedField) => includedField.type === builder.type);
+            }
+            if (!paginator || !includedField || (includedField && includedField.fields.includes(attribute))) {
+                if (typeof builder.attributes[attribute] === "function") {
+                    serialisedData.attributes[attribute] = await builder.attributes[attribute](data);
+                }
+                else {
+                    serialisedData.attributes[attribute] = data[attribute];
+                }
+            }
+        }
+        if (builder.meta) {
+            serialisedData.meta = {};
+            for (const meta of Object.keys(builder.meta)) {
+                if (typeof builder.meta[meta] === "function") {
+                    serialisedData.meta[meta] = await builder.meta[meta](data);
+                }
+                else {
+                    serialisedData.meta[meta] = data[meta];
+                }
+            }
+        }
+        if (builder.relationships) {
+            serialisedData.relationships = {};
+            for (const [key, relationship] of Object.entries(builder.relationships)) {
+                let resourceLinkage = {};
+                const manyToManyRelationships = key.split("__");
+                if (relationship.resourceIdentifier) {
+                    const minimalData = {
+                        type: relationship.resourceIdentifier.type,
+                    };
+                    try {
+                        if (typeof relationship.resourceIdentifier.id === "function") {
+                            minimalData.id = relationship.resourceIdentifier.id(data);
+                        }
+                        else {
+                            minimalData.id = data[relationship.resourceIdentifier.id];
+                        }
+                        resourceLinkage = {
+                            data: minimalData,
+                        };
+                        if (relationship.links && relationship.links.related) {
+                            resourceLinkage.links = {
+                                related: relationship.links.related(data),
+                            };
+                        }
+                        serialisedData.relationships[relationship.name ?? key] = resourceLinkage;
+                    }
+                    catch (e) {
+                        console.error(e);
+                    }
+                }
+                else if (data[key]) {
+                    const { minimalData, relationshipLink, additionalIncludeds } = await this.serialiseRelationship(data[key], await relationship.data?.create(), paginator, relationship);
+                    resourceLinkage = relationship.forceSingle === true ? { data: minimalData[0] } : { data: minimalData };
+                    if (relationshipLink) {
+                        resourceLinkage.links = relationshipLink;
+                    }
+                    else if (relationship.links && relationship.links.related) {
+                        resourceLinkage.links = {
+                            related: relationship.links.related(data),
+                        };
+                    }
+                    if (!relationship.excluded && additionalIncludeds.length > 0)
+                        includedElements.push(...additionalIncludeds);
+                    serialisedData.relationships[relationship.name ?? key] = resourceLinkage;
+                }
+                else if (manyToManyRelationships.length > 1 &&
+                    data[manyToManyRelationships[0]] !== undefined &&
+                    data[manyToManyRelationships[0]].length > 0) {
+                    serialisedData.relationships[relationship.name ?? key] = { data: [] };
+                    for (const item of data[manyToManyRelationships[0]]) {
+                        const { minimalData, additionalIncludeds } = await this.serialiseRelationship(item[manyToManyRelationships[1]], await relationship.data?.create(), paginator, relationship);
+                        if (!relationship.excluded && additionalIncludeds.length > 0)
+                            includedElements.push(...additionalIncludeds);
+                        if (relationship.forceSingle === true) {
+                            serialisedData.relationships[relationship.name ?? key] = {
+                                data: minimalData,
+                            };
+                        }
+                        else {
+                            serialisedData.relationships[relationship.name ?? key].data.push(minimalData);
+                        }
+                    }
+                }
+                else if (relationship.links && relationship.links.related) {
+                    const related = relationship.links.related(data);
+                    if (related) {
+                        resourceLinkage.links = {
+                            related: related,
+                        };
+                        serialisedData.relationships[relationship.name ?? key] = resourceLinkage;
+                    }
+                }
+            }
+            if (Object.keys(serialisedData.relationships).length === 0)
+                delete serialisedData.relationships;
+        }
+        return {
+            serialisedData: serialisedData,
+            includedElements: includedElements,
+        };
+    }
+    async serialiseRelationship(data, builder, paginator, relationship) {
+        const response = {
+            minimalData: undefined,
+            relationshipLink: undefined,
+            additionalIncludeds: [],
+        };
+        if (Array.isArray(data)) {
+            // Check if this relationship has a dynamic factory
+            if (relationship?.dynamicFactory) {
+                const serialisedResults = await Promise.all(data.map(async (item) => {
+                    try {
+                        const dynamicSerializer = relationship.dynamicFactory.createDynamicRelationship(item);
+                        const dynamicBuilder = dynamicSerializer ? await dynamicSerializer.create() : null;
+                        const actualBuilder = dynamicBuilder || builder;
+                        return this.serialiseData(item, actualBuilder, paginator);
+                    }
+                    catch (error) {
+                        throw error;
+                    }
+                }));
+                const serialisedData = serialisedResults.map((result) => result.serialisedData);
+                const includedElements = serialisedResults.map((result) => result.includedElements).flat();
+                response.minimalData = serialisedData.map((result) => {
+                    return { type: result.type, id: result.id };
+                });
+                this._addToIncluded(response.additionalIncludeds, includedElements.concat(serialisedData));
+            }
+            else {
+                // Use Promise.all to handle async operations within map (original logic)
+                const serialisedResults = await Promise.all(data.map((item) => this.serialiseData(item, builder, paginator)));
+                const serialisedData = serialisedResults.map((result) => result.serialisedData);
+                const includedElements = serialisedResults.map((result) => result.includedElements).flat();
+                response.minimalData = serialisedData.map((result) => {
+                    return { type: result.type, id: result.id };
+                });
+                this._addToIncluded(response.additionalIncludeds, includedElements.concat(serialisedData));
+            }
+        }
+        else {
+            const { serialisedData, includedElements } = await this.serialiseData(data, builder, paginator);
+            response.minimalData = {
+                type: serialisedData.type,
+                id: serialisedData.id,
+            };
+            if (serialisedData.links) {
+                response.relationshipLink = {
+                    self: serialisedData.links.self,
+                };
+            }
+            this._addToIncluded(response.additionalIncludeds, [...includedElements, serialisedData]);
+        }
+        return response;
+    }
+};
+exports.JsonApiService = JsonApiService;
+exports.JsonApiService = JsonApiService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_serialiser_factory_1.JsonApiSerialiserFactory,
+        nestjs_cls_1.ClsService,
+        config_1.ConfigService])
+], JsonApiService);
+//# sourceMappingURL=jsonapi.service.js.map

package/dist/core/jsonapi/services/jsonapi.service.js.map

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

package/dist/core/jsonapi/types/JsonApiIncludedFields.d.ts

@@ -0,0 +1,5 @@
+export type JsonApiIncludedFields = {
+    type: string;
+    fields: string[];
+};
+//# sourceMappingURL=JsonApiIncludedFields.d.ts.map

package/dist/core/jsonapi/types/JsonApiIncludedFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonApiIncludedFields.d.ts","sourceRoot":"","sources":["../../../../src/core/jsonapi/types/JsonApiIncludedFields.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC"}

package/dist/core/jsonapi/types/JsonApiIncludedFields.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=JsonApiIncludedFields.js.map

package/dist/core/jsonapi/types/JsonApiIncludedFields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JsonApiIncludedFields.js","sourceRoot":"","sources":["../../../../src/core/jsonapi/types/JsonApiIncludedFields.ts"],"names":[],"mappings":""}

package/dist/core/llm/abstracts/abstract.tools.d.ts

@@ -0,0 +1,62 @@
+import { DynamicStructuredTool } from "@langchain/core/tools";
+import { ToolsRecord } from "../utils/tools.utils";
+/**
+ * Abstract base class for Tools providers.
+ * Centralizes the `tools` getter and `getTools()` method.
+ *
+ * @typeParam TRecord - Typed interface for autocomplete support (keys = method names)
+ *
+ * @example
+ * ```typescript
+ * // 1. Define typed interface for autocomplete
+ * interface MyToolsRecord {
+ *   searchDocuments: DynamicStructuredTool;
+ *   analyzeText: DynamicStructuredTool;
+ * }
+ *
+ * // 2. Extend AbstractTools with your interface
+ * @Injectable()
+ * export class MyTools extends AbstractTools<MyToolsRecord> {
+ *   constructor(private readonly myService: MyService) {
+ *     super();
+ *   }
+ *
+ *   @Tool({
+ *     name: "search_documents",
+ *     description: "Search for documents",
+ *     schema: z.object({ query: z.string() }),
+ *   })
+ *   async searchDocuments({ query }: { query: string }) {
+ *     return this.myService.search(query);
+ *   }
+ *
+ *   @Tool({
+ *     name: "analyze_text",
+ *     description: "Analyze text content",
+ *     schema: z.object({ text: z.string() }),
+ *   })
+ *   async analyzeText({ text }: { text: string }) {
+ *     return this.myService.analyze(text);
+ *   }
+ * }
+ *
+ * // 3. Usage - pick individual tools with autocomplete
+ * tools: [this.myTools.tools.searchDocuments, this.lawTools.tools.findLawsByName]
+ *
+ * // Or pass all tools from one provider
+ * tools: this.myTools.getTools()
+ * ```
+ */
+export declare abstract class AbstractTools<TRecord = ToolsRecord> {
+    /**
+     * Object of tools keyed by method name - for picking individual tools.
+     * Provides autocomplete when TRecord is properly typed.
+     */
+    get tools(): TRecord;
+    /**
+     * Returns all @Tool decorated methods as an array.
+     * Use when you want to pass all tools from this provider at once.
+     */
+    getTools(): DynamicStructuredTool[];
+}
+//# sourceMappingURL=abstract.tools.d.ts.map

package/dist/core/llm/abstracts/abstract.tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.tools.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/abstracts/abstract.tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAA8B,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,8BAAsB,aAAa,CAAC,OAAO,GAAG,WAAW;IACvD;;;OAGG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;OAGG;IACH,QAAQ,IAAI,qBAAqB,EAAE;CAGpC"}

package/dist/core/llm/abstracts/abstract.tools.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractTools = void 0;
+const tools_utils_1 = require("../utils/tools.utils");
+/**
+ * Abstract base class for Tools providers.
+ * Centralizes the `tools` getter and `getTools()` method.
+ *
+ * @typeParam TRecord - Typed interface for autocomplete support (keys = method names)
+ *
+ * @example
+ * ```typescript
+ * // 1. Define typed interface for autocomplete
+ * interface MyToolsRecord {
+ *   searchDocuments: DynamicStructuredTool;
+ *   analyzeText: DynamicStructuredTool;
+ * }
+ *
+ * // 2. Extend AbstractTools with your interface
+ * @Injectable()
+ * export class MyTools extends AbstractTools<MyToolsRecord> {
+ *   constructor(private readonly myService: MyService) {
+ *     super();
+ *   }
+ *
+ *   @Tool({
+ *     name: "search_documents",
+ *     description: "Search for documents",
+ *     schema: z.object({ query: z.string() }),
+ *   })
+ *   async searchDocuments({ query }: { query: string }) {
+ *     return this.myService.search(query);
+ *   }
+ *
+ *   @Tool({
+ *     name: "analyze_text",
+ *     description: "Analyze text content",
+ *     schema: z.object({ text: z.string() }),
+ *   })
+ *   async analyzeText({ text }: { text: string }) {
+ *     return this.myService.analyze(text);
+ *   }
+ * }
+ *
+ * // 3. Usage - pick individual tools with autocomplete
+ * tools: [this.myTools.tools.searchDocuments, this.lawTools.tools.findLawsByName]
+ *
+ * // Or pass all tools from one provider
+ * tools: this.myTools.getTools()
+ * ```
+ */
+class AbstractTools {
+    /**
+     * Object of tools keyed by method name - for picking individual tools.
+     * Provides autocomplete when TRecord is properly typed.
+     */
+    get tools() {
+        return (0, tools_utils_1.getToolsAsObject)(this);
+    }
+    /**
+     * Returns all @Tool decorated methods as an array.
+     * Use when you want to pass all tools from this provider at once.
+     */
+    getTools() {
+        return (0, tools_utils_1.getTools)(this);
+    }
+}
+exports.AbstractTools = AbstractTools;
+//# sourceMappingURL=abstract.tools.js.map

package/dist/core/llm/abstracts/abstract.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.tools.js","sourceRoot":"","sources":["../../../../src/core/llm/abstracts/abstract.tools.ts"],"names":[],"mappings":";;;AACA,sDAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,MAAsB,aAAa;IACjC;;;OAGG;IACH,IAAI,KAAK;QACP,OAAO,IAAA,8BAAgB,EAAC,IAAI,CAAuB,CAAC;IACtD,CAAC;IAED;;;OAGG;IACH,QAAQ;QACN,OAAO,IAAA,sBAAQ,EAAC,IAAI,CAAC,CAAC;IACxB,CAAC;CACF;AAhBD,sCAgBC"}

package/dist/core/llm/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./abstracts/abstract.tools";
+export * from "./llm.module";
+export * from "./services/embedder.service";
+export * from "./services/llm.service";
+export * from "./services/model.service";
+export * from "./services/vision.llm.service";
+export * from "./utils/tools.utils";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/llm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":"AAAA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,6BAA6B,CAAC;AAC5C,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC"}

package/dist/core/llm/index.js

@@ -0,0 +1,24 @@
+"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("./abstracts/abstract.tools"), exports);
+__exportStar(require("./llm.module"), exports);
+__exportStar(require("./services/embedder.service"), exports);
+__exportStar(require("./services/llm.service"), exports);
+__exportStar(require("./services/model.service"), exports);
+__exportStar(require("./services/vision.llm.service"), exports);
+__exportStar(require("./utils/tools.utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/llm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/llm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,+CAA6B;AAC7B,8DAA4C;AAC5C,yDAAuC;AACvC,2DAAyC;AACzC,gEAA8C;AAC9C,sDAAoC"}

package/dist/core/llm/llm.module.d.ts

@@ -0,0 +1,16 @@
+/**
+ * LLM Module
+ *
+ * Provides LLM (Large Language Model) integration services.
+ * Configuration is read from `baseConfig.ai` directly.
+ *
+ * Features:
+ * - Multi-provider support (OpenAI, OpenRouter, etc.)
+ * - Embeddings generation
+ * - Vision/image analysis
+ * - Model selection and configuration
+ * - Token usage tracking
+ */
+export declare class LLMModule {
+}
+//# sourceMappingURL=llm.module.d.ts.map

package/dist/core/llm/llm.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.module.d.ts","sourceRoot":"","sources":["../../../src/core/llm/llm.module.ts"],"names":[],"mappings":"AAQA;;;;;;;;;;;;GAYG;AACH,qBAKa,SAAS;CAAG"}

package/dist/core/llm/llm.module.js

@@ -0,0 +1,39 @@
+"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;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMModule = void 0;
+const common_1 = require("@nestjs/common");
+const embedder_service_1 = require("./services/embedder.service");
+const llm_service_1 = require("./services/llm.service");
+const model_service_1 = require("./services/model.service");
+const vision_llm_service_1 = require("./services/vision.llm.service");
+const LLM_SERVICES = [llm_service_1.LLMService, model_service_1.ModelService, embedder_service_1.EmbedderService, vision_llm_service_1.VisionLLMService];
+/**
+ * LLM Module
+ *
+ * Provides LLM (Large Language Model) integration services.
+ * Configuration is read from `baseConfig.ai` directly.
+ *
+ * Features:
+ * - Multi-provider support (OpenAI, OpenRouter, etc.)
+ * - Embeddings generation
+ * - Vision/image analysis
+ * - Model selection and configuration
+ * - Token usage tracking
+ */
+let LLMModule = class LLMModule {
+};
+exports.LLMModule = LLMModule;
+exports.LLMModule = LLMModule = __decorate([
+    (0, common_1.Global)(),
+    (0, common_1.Module)({
+        providers: LLM_SERVICES,
+        exports: LLM_SERVICES,
+    })
+], LLMModule);
+//# sourceMappingURL=llm.module.js.map

package/dist/core/llm/llm.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"llm.module.js","sourceRoot":"","sources":["../../../src/core/llm/llm.module.ts"],"names":[],"mappings":";;;;;;;;;AAAA,2CAAgD;AAChD,kEAA8D;AAC9D,wDAAoD;AACpD,4DAAwD;AACxD,sEAAiE;AAEjE,MAAM,YAAY,GAAG,CAAC,wBAAU,EAAE,4BAAY,EAAE,kCAAe,EAAE,qCAAgB,CAAC,CAAC;AAEnF;;;;;;;;;;;;GAYG;AAMI,IAAM,SAAS,GAAf,MAAM,SAAS;CAAG,CAAA;AAAZ,8BAAS;oBAAT,SAAS;IALrB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC;QACN,SAAS,EAAE,YAAY;QACvB,OAAO,EAAE,YAAY;KACtB,CAAC;GACW,SAAS,CAAG"}

package/dist/core/llm/services/embedder.service.d.ts

@@ -0,0 +1,10 @@
+import { ModelService } from "../../llm/services/model.service";
+export declare class EmbedderService {
+    private readonly modelService;
+    constructor(modelService: ModelService);
+    vectoriseText(params: {
+        text: string;
+    }): Promise<any>;
+    vectoriseTextBatch(texts: string[]): Promise<any[]>;
+}
+//# sourceMappingURL=embedder.service.d.ts.map

package/dist/core/llm/services/embedder.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embedder.service.d.ts","sourceRoot":"","sources":["../../../../src/core/llm/services/embedder.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAEhE,qBACa,eAAe;IACd,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAEjD,aAAa,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,GAAG,CAAC;IAIrD,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAG1D"}