@carlonicora/nestjs-neo4jsonapi 0.0.1

package/dist/common/interfaces/authenticated.request.interface.js

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

package/dist/common/interfaces/authenticated.request.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticated.request.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/authenticated.request.interface.ts"],"names":[],"mappings":""}

package/dist/common/interfaces/datamodel.interface.d.ts

@@ -0,0 +1,25 @@
+import { AbstractJsonApiSerialiser } from "../../core/jsonapi/abstracts/abstract.jsonapi.serialiser";
+import { JsonApiServiceInterface } from "../../core/jsonapi/interfaces/jsonapi.service.interface";
+export declare function getEndpoint(modelGetter: () => DataModelInterface<any>): string;
+export type SerialiserType = AbstractJsonApiSerialiser & JsonApiServiceInterface;
+export type DataMeta = {
+    type: string;
+    endpoint: string;
+    nodeName: string;
+    labelName: string;
+};
+export type DataModelInterface<T> = DataMeta & {
+    entity: T;
+    mapper: (params: {
+        data: any;
+        record: any;
+        entityFactory: any;
+        name?: string;
+    }) => T;
+    serialiser?: new (...args: any[]) => SerialiserType;
+    childrenTokens?: string[];
+    singleChildrenTokens?: string[];
+    dynamicChildrenPatterns?: string[];
+    dynamicSingleChildrenPatterns?: string[];
+};
+//# sourceMappingURL=datamodel.interface.d.ts.map

package/dist/common/interfaces/datamodel.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datamodel.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/datamodel.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,0DAA0D,CAAC;AACrG,OAAO,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AAElG,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,kBAAkB,CAAC,GAAG,CAAC,GAAG,MAAM,CAE9E;AAED,MAAM,MAAM,cAAc,GAAG,yBAAyB,GAAG,uBAAuB,CAAC;AAEjF,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,QAAQ,GAAG;IAC7C,MAAM,EAAE,CAAC,CAAC;IACV,MAAM,EAAE,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,GAAG,CAAC;QAAC,MAAM,EAAE,GAAG,CAAC;QAAC,aAAa,EAAE,GAAG,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,CAAC,CAAC;IACrF,UAAU,CAAC,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,cAAc,CAAC;IACpD,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,EAAE,CAAC;IAChC,uBAAuB,CAAC,EAAE,MAAM,EAAE,CAAC;IACnC,6BAA6B,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1C,CAAC"}

package/dist/common/interfaces/datamodel.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEndpoint = getEndpoint;
+function getEndpoint(modelGetter) {
+    return modelGetter().endpoint;
+}
+//# sourceMappingURL=datamodel.interface.js.map

package/dist/common/interfaces/datamodel.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datamodel.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/datamodel.interface.ts"],"names":[],"mappings":";;AAGA,kCAEC;AAFD,SAAgB,WAAW,CAAC,WAA0C;IACpE,OAAO,WAAW,EAAE,CAAC,QAAQ,CAAC;AAChC,CAAC"}

package/dist/common/interfaces/entity.descriptor.interface.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Entity Descriptor Interface
+ *
+ * Re-exports from entity.schema.interface.ts for the new schema-first approach.
+ * Use defineEntity() to create descriptors with automatic derivation of:
+ * - constraints (always UNIQUE id)
+ * - indexes (FULLTEXT from string fields)
+ * - field names, defaults, and required fields
+ *
+ * @example
+ * ```typescript
+ * import { defineEntity } from '../helpers/define-entity';
+ *
+ * export const GlossaryDescriptor = defineEntity<Glossary>()({
+ *   model: GlossaryModel,
+ *   fields: {
+ *     name: { type: 'string', required: true },
+ *     description: { type: 'string' },
+ *   },
+ *   relationships: {
+ *     author: { model: authorMeta, direction: 'in', relationship: 'PUBLISHED', cardinality: 'one' },
+ *     topic: { model: topicMeta, direction: 'out', relationship: 'RELEVANT_FOR', cardinality: 'many' },
+ *   },
+ * });
+ *
+ * // Access with autocomplete:
+ * GlossaryDescriptor.relationships.author
+ * GlossaryDescriptor.fieldNames
+ * GlossaryDescriptor.stringFields
+ * ```
+ */
+export type { CypherType, EntityDescriptor, EntitySchemaInput, FieldDef, RelationshipDef, } from "./entity.schema.interface";
+export { defineEntity } from "../helpers/define-entity";
+//# sourceMappingURL=entity.descriptor.interface.d.ts.map

package/dist/common/interfaces/entity.descriptor.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.descriptor.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/entity.descriptor.interface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,QAAQ,EACR,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/common/interfaces/entity.descriptor.interface.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defineEntity = void 0;
+var define_entity_1 = require("../helpers/define-entity");
+Object.defineProperty(exports, "defineEntity", { enumerable: true, get: function () { return define_entity_1.defineEntity; } });
+//# sourceMappingURL=entity.descriptor.interface.js.map

package/dist/common/interfaces/entity.descriptor.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.descriptor.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/entity.descriptor.interface.ts"],"names":[],"mappings":";;;AAuCA,0DAAwD;AAA/C,6GAAA,YAAY,OAAA"}

package/dist/common/interfaces/entity.schema.interface.d.ts

@@ -0,0 +1,154 @@
+import { Type } from "@nestjs/common";
+import { DataMeta, DataModelInterface } from "./datamodel.interface";
+/**
+ * Neo4j/Cypher data types for field definitions
+ */
+export type CypherType = "string" | "number" | "boolean" | "datetime" | "json";
+/**
+ * Transformer function for field serialisation
+ * Receives the entity data and any injected services
+ */
+export type FieldTransformFn = (data: any, services: Record<string, any>) => Promise<any> | any;
+/**
+ * Field definition for entity schema
+ * Defines a single property with its type and constraints
+ */
+export interface FieldDef {
+    /** Neo4j/Cypher data type */
+    type: CypherType;
+    /** Whether the field is required (default: false) */
+    required?: boolean;
+    /** Default value to use when creating an entity */
+    default?: any;
+    /** If true, field goes to JSON:API meta instead of attributes (default: false) */
+    meta?: boolean;
+    /** Async transformer function for serialisation - receives data and injected services */
+    transform?: FieldTransformFn;
+}
+/**
+ * Function signature for computed field calculation
+ * @param params.data - The raw Neo4j node data
+ * @param params.record - The full Neo4j record (for accessing related data like totalScore)
+ * @param params.entityFactory - EntityFactory instance for creating related entities
+ * @param params.name - Optional name for the entity in the record
+ */
+export type ComputedFieldFn<T = any> = (params: {
+    data: any;
+    record: any;
+    entityFactory: any;
+    name?: string;
+}) => T;
+/**
+ * Computed field definition for runtime-calculated values
+ * These fields don't exist in Neo4j but are calculated from record data
+ */
+export interface ComputedFieldDef<T = any> {
+    /** Function to compute the field value */
+    compute: ComputedFieldFn<T>;
+    /** If true, field goes to JSON:API meta instead of attributes (default: false) */
+    meta?: boolean;
+}
+/**
+ * Relationship definition for entity schema
+ * Defines how this entity relates to another entity
+ */
+export interface RelationshipDef {
+    /** Metadata of the related entity */
+    model: DataMeta;
+    /** Direction: 'in' = (related)-[:REL]->(this), 'out' = (this)-[:REL]->(related) */
+    direction: "in" | "out";
+    /** Neo4j relationship type (e.g., "PUBLISHED", "RELEVANT_FOR") */
+    relationship: string;
+    /** Cardinality: 'one' for single, 'many' for collection */
+    cardinality: "one" | "many";
+    /** Context key for relationships whose value comes from CLS context (e.g., 'userId' for author) */
+    contextKey?: string;
+    /** DTO key override for the relationships object (e.g., 'topics' instead of relationship key 'topic') */
+    dtoKey?: string;
+}
+/**
+ * Input schema for defineEntity function
+ * This is the clean, declarative API for defining entities
+ *
+ * @template T - The entity type (e.g., Glossary)
+ * @template R - The relationships record type for autocomplete support
+ */
+export interface EntitySchemaInput<T, R extends Record<string, RelationshipDef> = Record<string, RelationshipDef>> {
+    /** JSON:API type (e.g., "glossaries") */
+    type: string;
+    /** API endpoint path (e.g., "glossaries") */
+    endpoint: string;
+    /** Neo4j node name/alias used in Cypher queries (e.g., "glossary") */
+    nodeName: string;
+    /** Neo4j label name (e.g., "Glossary") */
+    labelName: string;
+    /** Whether this entity belongs to a company (default: true). Set to false for generic/global entities. */
+    isCompanyScoped?: boolean;
+    /** Field definitions - keys must be valid entity properties */
+    fields: {
+        [K in keyof Partial<T>]?: FieldDef;
+    };
+    /** Relationship definitions with named keys for autocomplete */
+    relationships: R;
+    /** Computed fields - calculated at runtime from Neo4j record data */
+    computed?: {
+        [K in keyof Partial<T>]?: ComputedFieldDef;
+    };
+    /** Custom serializer class (only needed for special transformations like S3 URL signing) */
+    serialiser?: new (...args: any[]) => any;
+    /** Services to inject into auto-generated serialiser for field transformers */
+    injectServices?: Type<any>[];
+}
+/**
+ * Computed entity descriptor - output of defineEntity()
+ * Contains both the original schema and computed/derived values
+ *
+ * @template T - The entity type
+ * @template R - The relationships record type for autocomplete support
+ */
+export interface EntityDescriptor<T, R extends Record<string, RelationshipDef> = Record<string, RelationshipDef>> {
+    /** The data model interface (auto-generated with mapper, childrenTokens, etc.) */
+    model: DataModelInterface<T>;
+    /** Whether this entity belongs to a company. False for generic/global entities. */
+    isCompanyScoped: boolean;
+    /** Named relationships with autocomplete support (e.g., descriptor.relationships.author) */
+    relationships: R;
+    /** Relationship keys for autocomplete (e.g., descriptor.relationshipKeys.author returns "author") */
+    relationshipKeys: {
+        [K in keyof R]: K;
+    };
+    /** All field names (keys of fields) */
+    fieldNames: string[];
+    /** Fields with type: 'string' - used for FULLTEXT index */
+    stringFields: string[];
+    /** Fields with required: true */
+    requiredFields: string[];
+    /** Default values extracted from field definitions */
+    fieldDefaults: Record<string, any>;
+    /** Field definitions map for type lookup */
+    fields: {
+        [K in keyof Partial<T>]?: FieldDef;
+    };
+    /** Computed field definitions */
+    computed: {
+        [K in keyof Partial<T>]?: ComputedFieldDef;
+    };
+    /** Services to inject into auto-generated serialiser for field transformers */
+    injectServices: Type<any>[];
+    /** Always: [{ property: 'id', type: 'UNIQUE' }] */
+    constraints: Array<{
+        property: string;
+        type: "UNIQUE" | "EXISTS" | "NODE_KEY";
+    }>;
+    /** Auto-generated FULLTEXT index from string fields */
+    indexes: Array<{
+        name: string;
+        properties: string[];
+        type: "FULLTEXT" | "BTREE" | "TEXT";
+    }>;
+    /** Auto-generated index name: {nodeName}_search_index */
+    fulltextIndexName: string;
+    /** Default ordering for queries */
+    defaultOrderBy: string;
+}
+//# sourceMappingURL=entity.schema.interface.d.ts.map

package/dist/common/interfaces/entity.schema.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.schema.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/entity.schema.interface.ts"],"names":[],"mappings":"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"}

package/dist/common/interfaces/entity.schema.interface.js

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

package/dist/common/interfaces/entity.schema.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.schema.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/entity.schema.interface.ts"],"names":[],"mappings":""}

package/dist/common/interfaces/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./authenticated.request.interface";
+export * from "./datamodel.interface";
+export * from "./entity.descriptor.interface";
+export * from "./entity.schema.interface";
+export * from "./message.interface";
+export * from "./token.usage.interface";
+export * from "./langchain.usage.interface";
+//# sourceMappingURL=index.d.ts.map

package/dist/common/interfaces/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,mCAAmC,CAAC;AAClD,cAAc,uBAAuB,CAAC;AACtC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,6BAA6B,CAAC"}

package/dist/common/interfaces/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("./authenticated.request.interface"), exports);
+__exportStar(require("./datamodel.interface"), exports);
+__exportStar(require("./entity.descriptor.interface"), exports);
+__exportStar(require("./entity.schema.interface"), exports);
+__exportStar(require("./message.interface"), exports);
+__exportStar(require("./token.usage.interface"), exports);
+__exportStar(require("./langchain.usage.interface"), exports);
+//# sourceMappingURL=index.js.map

package/dist/common/interfaces/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oEAAkD;AAClD,wDAAsC;AACtC,gEAA8C;AAC9C,4DAA0C;AAC1C,sDAAoC;AACpC,0DAAwC;AACxC,8DAA4C"}

package/dist/common/interfaces/langchain.usage.interface.d.ts

@@ -0,0 +1,21 @@
+/**
+ * LangChain v1.0 Usage Metadata Interface
+ * Represents token usage information returned by LLM providers
+ *
+ * @see https://js.langchain.com/docs/how_to/chat_token_usage_tracking/
+ */
+export interface UsageMetadata {
+    /**
+     * Number of tokens used in the input/prompt
+     */
+    input_tokens: number;
+    /**
+     * Number of tokens generated in the output/completion
+     */
+    output_tokens: number;
+    /**
+     * Total tokens used (input + output)
+     */
+    total_tokens: number;
+}
+//# sourceMappingURL=langchain.usage.interface.d.ts.map

package/dist/common/interfaces/langchain.usage.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.usage.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/langchain.usage.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB"}

package/dist/common/interfaces/langchain.usage.interface.js

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

package/dist/common/interfaces/langchain.usage.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"langchain.usage.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/langchain.usage.interface.ts"],"names":[],"mappings":""}

package/dist/common/interfaces/message.interface.d.ts

@@ -0,0 +1,6 @@
+import { AgentMessageType } from "../enums/agentmessage.type";
+export interface MessageInterface {
+    type: AgentMessageType;
+    content: string;
+}
+//# sourceMappingURL=message.interface.d.ts.map

package/dist/common/interfaces/message.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/message.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAE9D,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,gBAAgB,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/common/interfaces/message.interface.js

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

package/dist/common/interfaces/message.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/message.interface.ts"],"names":[],"mappings":""}

package/dist/common/interfaces/token.usage.interface.d.ts

@@ -0,0 +1,5 @@
+export interface TokenUsageInterface {
+    input: number;
+    output: number;
+}
+//# sourceMappingURL=token.usage.interface.d.ts.map

package/dist/common/interfaces/token.usage.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.usage.interface.d.ts","sourceRoot":"","sources":["../../../src/common/interfaces/token.usage.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB"}

package/dist/common/interfaces/token.usage.interface.js

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

package/dist/common/interfaces/token.usage.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"token.usage.interface.js","sourceRoot":"","sources":["../../../src/common/interfaces/token.usage.interface.ts"],"names":[],"mappings":""}

package/dist/common/registries/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./registry";
+//# sourceMappingURL=index.d.ts.map

package/dist/common/registries/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/registries/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC"}

package/dist/common/registries/index.js

@@ -0,0 +1,18 @@
+"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("./registry"), exports);
+//# sourceMappingURL=index.js.map

package/dist/common/registries/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/registries/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B"}

package/dist/common/registries/registry.d.ts

@@ -0,0 +1,23 @@
+import { DataModelInterface } from "../interfaces/datamodel.interface";
+/**
+ * ModelRegistry - Global singleton for model registration
+ *
+ * NOT @Injectable because it must be instantiated and populated with models
+ * BEFORE NestJS bootstraps. Other services depend on models being registered first.
+ */
+export declare class ModelRegistry {
+    private models;
+    private labelNameIndex;
+    private typeIndex;
+    register(model: DataModelInterface<any>): void;
+    get(nodeName: string): DataModelInterface<any> | undefined;
+    getByLabelName(labelName: string): DataModelInterface<any> | undefined;
+    getByType(type: string): DataModelInterface<any> | undefined;
+    resolveModel(identifier: string): DataModelInterface<any> | undefined;
+    getAllModels(): DataModelInterface<any>[];
+}
+/**
+ * Global singleton instance - use this for model registration before bootstrap
+ */
+export declare const modelRegistry: ModelRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/common/registries/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/common/registries/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAEvE;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAA8C;IAC5D,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,SAAS,CAA8C;IAExD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC,GAAG,CAAC,GAAG,IAAI;IAM9C,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,SAAS;IAK1D,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,SAAS;IAItE,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,SAAS;IAI5D,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,kBAAkB,CAAC,GAAG,CAAC,GAAG,SAAS;IAgBrE,YAAY,IAAI,kBAAkB,CAAC,GAAG,CAAC,EAAE;CAGjD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,eAAsB,CAAC"}

package/dist/common/registries/registry.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.modelRegistry = exports.ModelRegistry = void 0;
+/**
+ * ModelRegistry - Global singleton for model registration
+ *
+ * NOT @Injectable because it must be instantiated and populated with models
+ * BEFORE NestJS bootstraps. Other services depend on models being registered first.
+ */
+class ModelRegistry {
+    constructor() {
+        this.models = new Map();
+        this.labelNameIndex = new Map();
+        this.typeIndex = new Map();
+    }
+    register(model) {
+        this.models.set(model.nodeName, model);
+        this.labelNameIndex.set(model.labelName.toLowerCase(), model);
+        this.typeIndex.set(model.type.toLowerCase(), model);
+    }
+    get(nodeName) {
+        const model = this.models.get(nodeName);
+        return model;
+    }
+    getByLabelName(labelName) {
+        return this.labelNameIndex.get(labelName.toLowerCase());
+    }
+    getByType(type) {
+        return this.typeIndex.get(type.toLowerCase());
+    }
+    resolveModel(identifier) {
+        // Try exact nodeName match first (backward compatibility)
+        let model = this.get(identifier);
+        if (model)
+            return model;
+        // Try labelName match (case insensitive)
+        model = this.getByLabelName(identifier);
+        if (model)
+            return model;
+        // Try type match (case insensitive)
+        model = this.getByType(identifier);
+        if (model)
+            return model;
+        return undefined;
+    }
+    getAllModels() {
+        return Array.from(this.models.values());
+    }
+}
+exports.ModelRegistry = ModelRegistry;
+/**
+ * Global singleton instance - use this for model registration before bootstrap
+ */
+exports.modelRegistry = new ModelRegistry();
+//# sourceMappingURL=registry.js.map

package/dist/common/registries/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/common/registries/registry.ts"],"names":[],"mappings":";;;AAEA;;;;;GAKG;AACH,MAAa,aAAa;IAA1B;QACU,WAAM,GAAG,IAAI,GAAG,EAAmC,CAAC;QACpD,mBAAc,GAAG,IAAI,GAAG,EAAmC,CAAC;QAC5D,cAAS,GAAG,IAAI,GAAG,EAAmC,CAAC;IAwCjE,CAAC;IAtCQ,QAAQ,CAAC,KAA8B;QAC5C,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QACvC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC;IACtD,CAAC;IAEM,GAAG,CAAC,QAAgB;QACzB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QACxC,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,cAAc,CAAC,SAAiB;QACrC,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,CAAC;IAEM,SAAS,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IAChD,CAAC;IAEM,YAAY,CAAC,UAAkB;QACpC,0DAA0D;QAC1D,IAAI,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QACjC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,yCAAyC;QACzC,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;QACxC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,oCAAoC;QACpC,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QACnC,IAAI,KAAK;YAAE,OAAO,KAAK,CAAC;QAExB,OAAO,SAAS,CAAC;IACnB,CAAC;IAEM,YAAY;QACjB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1C,CAAC;CACF;AA3CD,sCA2CC;AAED;;GAEG;AACU,QAAA,aAAa,GAAG,IAAI,aAAa,EAAE,CAAC"}

package/dist/common/repositories/ai.source.query.d.ts

@@ -0,0 +1,13 @@
+import { DataLimits } from "../types/data.limits";
+/**
+ * Helper function to build AI source queries.
+ * This is a generic implementation that can be extended by consuming apps.
+ */
+export declare const aiSourceQuery: (params: {
+    currentUserId?: string;
+    securityService?: any;
+    dataLimits: DataLimits;
+    returnsData?: boolean;
+    returnsKeyConcepts?: boolean;
+}) => string;
+//# sourceMappingURL=ai.source.query.d.ts.map

package/dist/common/repositories/ai.source.query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.source.query.d.ts","sourceRoot":"","sources":["../../../src/common/repositories/ai.source.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,QAAQ;IACpC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,GAAG,CAAC;IACtB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,WAcA,CAAC"}

package/dist/common/repositories/ai.source.query.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.aiSourceQuery = void 0;
+/**
+ * Helper function to build AI source queries.
+ * This is a generic implementation that can be extended by consuming apps.
+ */
+const aiSourceQuery = (params) => {
+    let response = ``;
+    if (params.returnsData) {
+        response += `
+      WITH data
+    `;
+    }
+    else if (params.returnsKeyConcepts) {
+        response += `
+      WITH keyconcept
+      `;
+    }
+    return response;
+};
+exports.aiSourceQuery = aiSourceQuery;
+//# sourceMappingURL=ai.source.query.js.map

package/dist/common/repositories/ai.source.query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.source.query.js","sourceRoot":"","sources":["../../../src/common/repositories/ai.source.query.ts"],"names":[],"mappings":";;;AAEA;;;GAGG;AACI,MAAM,aAAa,GAAG,CAAC,MAM7B,EAAE,EAAE;IACH,IAAI,QAAQ,GAAG,EAAE,CAAC;IAElB,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QACvB,QAAQ,IAAI;;KAEX,CAAC;IACJ,CAAC;SAAM,IAAI,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACrC,QAAQ,IAAI;;OAET,CAAC;IACN,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AApBW,QAAA,aAAa,iBAoBxB"}

package/dist/common/repositories/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./ai.source.query";
+//# sourceMappingURL=index.d.ts.map

package/dist/common/repositories/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/repositories/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/dist/common/repositories/index.js

@@ -0,0 +1,18 @@
+"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("./ai.source.query"), exports);
+//# sourceMappingURL=index.js.map

package/dist/common/repositories/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/repositories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC"}

package/dist/common/strategies/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./jwt.strategy";
+//# sourceMappingURL=index.d.ts.map

package/dist/common/strategies/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/common/strategies/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC"}

package/dist/common/strategies/index.js

@@ -0,0 +1,18 @@
+"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("./jwt.strategy"), exports);
+//# sourceMappingURL=index.js.map

package/dist/common/strategies/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/common/strategies/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B"}