@carlonicora/nestjs-neo4jsonapi 1.115.1 → 1.117.0

package/dist/foundations/content/entities/content.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContentDescriptor = void 0;
+exports.buildContentDescriptor = buildContentDescriptor;
+exports.getContentModel = getContentModel;
+const ai_status_1 = require("../../../common/enums/ai.status");
+const define_entity_1 = require("../../../common/helpers/define-entity");
+const registry_1 = require("../../../common/registries/registry");
+const user_meta_1 = require("../../user/entities/user.meta");
+const content_meta_1 = require("./content.meta");
+/**
+ * Builds the Content entity descriptor, optionally shaped by a
+ * {@link ContentExtensionConfig}.
+ *
+ * With NO config the descriptor is the exact wire contract of the legacy
+ * `ContentSerialiser`/`ContentModel` pair it replaces:
+ * - attributes: `name`, `abstract`, `tldr`
+ * - meta: `aiStatus`, `contentType`, `relevance`
+ * - relationships: `owner`, `author`
+ *
+ * Config effects:
+ * - `serialiseAuthor: false` removes the `author` relationship
+ * - `metaFields` adds one computed meta entry per entry, read from the Cypher
+ *   RETURN alias produced by {@link ContentCypherService}
+ * - `additionalRelationships` adds one relationship per entry, keyed by the
+ *   related model's `nodeName` (the key the Cypher RETURN alias
+ *   `content_<nodeName>` maps onto)
+ *
+ * @param config - Optional Content extension configuration
+ */
+function buildContentDescriptor(config) {
+    const relationships = {
+        owner: {
+            model: user_meta_1.ownerMeta,
+            direction: "in",
+            relationship: "PUBLISHED",
+            cardinality: "one",
+            dtoKey: "owner",
+            description: "The user who published/owns the underlying record.",
+        },
+    };
+    // Default true — the package wire has always carried `author`. Apps whose
+    // content has no distinct author (a360ai) switch it off via config.
+    if (config?.serialiseAuthor !== false) {
+        relationships.author = {
+            model: user_meta_1.authorMeta,
+            direction: "in",
+            relationship: "PUBLISHED",
+            cardinality: "one",
+            dtoKey: "author",
+            description: "The user who authored the underlying record.",
+        };
+    }
+    for (const relationship of config?.additionalRelationships ?? []) {
+        relationships[relationship.model.nodeName] = {
+            model: relationship.model,
+            direction: relationship.direction,
+            relationship: relationship.relationship,
+            cardinality: relationship.cardinality,
+            ...(relationship.dtoKey ? { dtoKey: relationship.dtoKey } : {}),
+        };
+    }
+    const computed = {
+        // Content carries no "contentType" property of its own — it is derived from
+        // the underlying node's Neo4j label at read time (old mapper: `params.data.labels[0]`).
+        contentType: {
+            compute: (params) => params.data?.labels?.[0],
+            meta: true,
+            description: 'The underlying Neo4j label of the record (e.g. "Article", "Document") — identifies which platform entity this content view represents.',
+        },
+        relevance: {
+            compute: (params) => (params.record.has("totalScore") ? Number(params.record.get("totalScore")) : 0),
+            meta: true,
+            description: "Relevance score computed against a reference entity by the relevancy engine. 0 outside a relevance query.",
+        },
+    };
+    for (const metaField of config?.metaFields ?? []) {
+        computed[metaField.key] = {
+            compute: (params) => params.record.has(metaField.key) ? (params.record.get(metaField.key) ?? undefined) : undefined,
+            meta: true,
+            description: metaField.description,
+        };
+    }
+    return (0, define_entity_1.defineEntity)()({
+        ...content_meta_1.contentMeta,
+        isCompanyScoped: true,
+        description: "A generic, read-only view over any AI-summarised platform record. Used for cross-type search, listing by owner, and relevance ranking against another entity — Content is never created or updated directly.",
+        chat: {
+            summary: (d) => d.name ?? d.id,
+            textSearchFields: ["name", "abstract", "tldr"],
+        },
+        fields: {
+            name: {
+                type: "string",
+                required: true,
+                description: "The title of the underlying record (document name, article title, etc.).",
+            },
+            abstract: {
+                type: "string",
+                description: "A short AI-generated abstract of the underlying record's content.",
+            },
+            tldr: {
+                type: "string",
+                description: "The AI-generated too-long-didn't-read summary of the underlying record.",
+            },
+            aiStatus: {
+                type: "string",
+                default: ai_status_1.AiStatus.Pending,
+                meta: true,
+                description: "The AI processing status of the underlying record (e.g. pending, in_progress, completed, failed).",
+            },
+        },
+        computed,
+        relationships,
+    });
+}
+/**
+ * Content Entity Descriptor (no extension config).
+ *
+ * This is the descriptor to register in a graph catalog and to import from
+ * consuming apps. The descriptor actually used for serialisation at runtime is
+ * built by `ContentModule.forRoot()` from the module's configuration and
+ * published through `modelRegistry` — read it with {@link getContentModel}.
+ */
+exports.ContentDescriptor = buildContentDescriptor();
+/**
+ * Get the Content model from the registry.
+ *
+ * `ContentModule.forRoot()` registers the CONFIGURED model (extension
+ * relationships, config-driven meta fields, optional author), so every read
+ * path must resolve the model through the registry rather than capturing
+ * {@link ContentDescriptor}.model at import time.
+ */
+function getContentModel() {
+    const model = registry_1.modelRegistry.get(content_meta_1.contentMeta.nodeName);
+    if (!model) {
+        throw new Error(`ContentModel not found in registry for nodeName: ${content_meta_1.contentMeta.nodeName}`);
+    }
+    return model;
+}
+//# sourceMappingURL=content.js.map

package/dist/foundations/content/entities/content.js.map

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

package/dist/foundations/content/index.d.ts

@@ -1,9 +1,7 @@
 export { ContentModule } from "./content.module";
-export { Content } from "./entities/content.entity";
+export { buildContentDescriptor, Content, ContentDescriptor, ContentDescriptorType, getContentModel, } from "./entities/content";
 export { contentMeta } from "./entities/content.meta";
-export { ContentModel } from "./entities/content.model";
-export { createExtendedContentModel } from "./factories/content.model.factory";
-export { ContentExtensionConfig, ContentRelationshipExtension, CONTENT_EXTENSION_CONFIG, } from "./interfaces/content.extension.interface";
+export { ContentExtensionConfig, ContentMetaFieldExtension, ContentOwnerMatchPattern, ContentRelationshipExtension, CONTENT_DESCRIPTOR, CONTENT_EXTENSION_CONFIG, } from "./interfaces/content.extension.interface";
 export { ContentRepository } from "./repositories/content.repository";
 export { ContentCypherService } from "./services/content.cypher.service";
 export { ContentService } from "./services/content.service";

package/dist/foundations/content/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AAC/E,OAAO,EACL,sBAAsB,EACtB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/content/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EACL,sBAAsB,EACtB,OAAO,EACP,iBAAiB,EACjB,qBAAqB,EACrB,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EACL,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/foundations/content/index.js

@@ -1,15 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ContentService = exports.ContentCypherService = exports.ContentRepository = exports.CONTENT_EXTENSION_CONFIG = exports.createExtendedContentModel = exports.ContentModel = exports.contentMeta = exports.ContentModule = void 0;
+exports.ContentService = exports.ContentCypherService = exports.ContentRepository = exports.CONTENT_EXTENSION_CONFIG = exports.CONTENT_DESCRIPTOR = exports.contentMeta = exports.getContentModel = exports.ContentDescriptor = exports.buildContentDescriptor = exports.ContentModule = void 0;
 var content_module_1 = require("./content.module");
 Object.defineProperty(exports, "ContentModule", { enumerable: true, get: function () { return content_module_1.ContentModule; } });
+var content_1 = require("./entities/content");
+Object.defineProperty(exports, "buildContentDescriptor", { enumerable: true, get: function () { return content_1.buildContentDescriptor; } });
+Object.defineProperty(exports, "ContentDescriptor", { enumerable: true, get: function () { return content_1.ContentDescriptor; } });
+Object.defineProperty(exports, "getContentModel", { enumerable: true, get: function () { return content_1.getContentModel; } });
 var content_meta_1 = require("./entities/content.meta");
 Object.defineProperty(exports, "contentMeta", { enumerable: true, get: function () { return content_meta_1.contentMeta; } });
-var content_model_1 = require("./entities/content.model");
-Object.defineProperty(exports, "ContentModel", { enumerable: true, get: function () { return content_model_1.ContentModel; } });
-var content_model_factory_1 = require("./factories/content.model.factory");
-Object.defineProperty(exports, "createExtendedContentModel", { enumerable: true, get: function () { return content_model_factory_1.createExtendedContentModel; } });
 var content_extension_interface_1 = require("./interfaces/content.extension.interface");
+Object.defineProperty(exports, "CONTENT_DESCRIPTOR", { enumerable: true, get: function () { return content_extension_interface_1.CONTENT_DESCRIPTOR; } });
 Object.defineProperty(exports, "CONTENT_EXTENSION_CONFIG", { enumerable: true, get: function () { return content_extension_interface_1.CONTENT_EXTENSION_CONFIG; } });
 var content_repository_1 = require("./repositories/content.repository");
 Object.defineProperty(exports, "ContentRepository", { enumerable: true, get: function () { return content_repository_1.ContentRepository; } });

package/dist/foundations/content/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/content/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AAEtB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,0DAAwD;AAA/C,6GAAA,YAAY,OAAA;AACrB,2EAA+E;AAAtE,mIAAA,0BAA0B,OAAA;AACnC,wFAIkD;AADhD,uIAAA,wBAAwB,OAAA;AAE1B,wEAAsE;AAA7D,uHAAA,iBAAiB,OAAA;AAC1B,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAC7B,8DAA4D;AAAnD,iHAAA,cAAc,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/content/index.ts"],"names":[],"mappings":";;;AAAA,mDAAiD;AAAxC,+GAAA,aAAa,OAAA;AACtB,8CAM4B;AAL1B,iHAAA,sBAAsB,OAAA;AAEtB,4GAAA,iBAAiB,OAAA;AAEjB,0GAAA,eAAe,OAAA;AAEjB,wDAAsD;AAA7C,2GAAA,WAAW,OAAA;AACpB,wFAOkD;AAFhD,iIAAA,kBAAkB,OAAA;AAClB,uIAAA,wBAAwB,OAAA;AAE1B,wEAAsE;AAA7D,uHAAA,iBAAiB,OAAA;AAC1B,4EAAyE;AAAhE,8HAAA,oBAAoB,OAAA;AAC7B,8DAA4D;AAAnD,iHAAA,cAAc,OAAA"}

package/dist/foundations/content/interfaces/content.extension.interface.d.ts

@@ -14,6 +14,65 @@ export interface ContentRelationshipExtension {
     /** Optional JSON:API key override (e.g., "topics" instead of "topic") */
     dtoKey?: string;
 }
+/**
+ * Describes how the Content → owner edge is matched in Cypher.
+ *
+ * Default (omitted): the historical directed single-type match
+ * `MATCH (content)<-[:PUBLISHED]-(content_owner:User)`.
+ */
+export interface ContentOwnerMatchPattern {
+    /**
+     * Neo4j relationship types accepted for the owner edge. Joined with `|`,
+     * so `["PUBLISHED", "FROM"]` becomes `[:PUBLISHED|FROM]`.
+     */
+    relationships: string[];
+    /**
+     * When true the pattern is undirected (`(content)-[:…]-(owner)`) instead of
+     * the default incoming direction (`(content)<-[:…]-(owner)`).
+     *
+     * Needed when the owner edge points different ways for different underlying
+     * labels — e.g. a360ai's Email rows, where the edge is
+     * `(email)-[:FROM]->(user)` while every other content type is
+     * `(user)-[:PUBLISHED]->(content)`.
+     */
+    undirected?: boolean;
+}
+/**
+ * Adds one config-driven computed meta field to Content, fed by an extra
+ * OPTIONAL MATCH appended to the Content RETURN statement.
+ *
+ * @example
+ * ```typescript
+ * // a360ai: expose the proceeding a memo belongs to as meta.proceedingId
+ * {
+ *   key: "proceedingId",
+ *   optionalMatch: "OPTIONAL MATCH (memoProceeding:Proceeding)-[:HAS_MEMO]->(content)",
+ *   returnAlias: "memoProceeding.id",
+ * }
+ * // → OPTIONAL MATCH (memoProceeding:Proceeding)-[:HAS_MEMO]->(content)
+ * // → RETURN …, memoProceeding.id AS proceedingId
+ * ```
+ */
+export interface ContentMetaFieldExtension {
+    /**
+     * JSON:API meta key AND the Cypher RETURN alias the value is read from
+     * (the descriptor's computed field reads `record.get(key)`).
+     */
+    key: string;
+    /**
+     * A complete Cypher clause appended verbatim before the RETURN — normally an
+     * `OPTIONAL MATCH …` binding the variable projected by `returnAlias`. It runs
+     * after the company/owner matches, so `content` is in scope.
+     */
+    optionalMatch: string;
+    /**
+     * The Cypher expression to project, WITHOUT the alias: it is emitted as
+     * `${returnAlias} AS ${key}`. For the example above, `"memoProceeding.id"`.
+     */
+    returnAlias: string;
+    /** Optional human-readable description for the graph catalog / chatbot. */
+    description?: string;
+}
 /**
  * Configuration for extending Content module with additional relationships.
  *
@@ -22,6 +81,10 @@ export interface ContentRelationshipExtension {
  * - Included in JSON:API serialization
  * - Mapped in entity results
  *
+ * Every key beyond `additionalRelationships` is optional and defaults to the
+ * package's historical behaviour, so omitting the config (or passing only
+ * `additionalRelationships`) leaves the Content wire and Cypher unchanged.
+ *
  * @example
  * ```typescript
  * const contentExtension: ContentExtensionConfig = {
@@ -36,13 +99,76 @@ export interface ContentRelationshipExtension {
  *   ],
  * };
  * ```
+ *
+ * @example
+ * ```typescript
+ * // a360ai's configuration — every non-default knob in one place
+ * const contentExtension: ContentExtensionConfig = {
+ *   additionalRelationships: [],
+ *   ownerMatchPattern: { relationships: ["PUBLISHED", "FROM"], undirected: true },
+ *   requireTldr: true,
+ *   metaFields: [
+ *     {
+ *       key: "proceedingId",
+ *       optionalMatch: "OPTIONAL MATCH (memoProceeding:Proceeding)-[:HAS_MEMO]->(content)",
+ *       returnAlias: "memoProceeding.id",
+ *     },
+ *   ],
+ *   serialiseAuthor: false,
+ * };
+ * ```
  */
 export interface ContentExtensionConfig {
     additionalRelationships: ContentRelationshipExtension[];
+    /**
+     * Overrides the Content → owner Cypher match.
+     *
+     * Default (omitted): `MATCH (content)<-[:PUBLISHED]-(content_owner:User)` —
+     * byte-identical to the pre-config behaviour.
+     *
+     * a360ai: `{ relationships: ["PUBLISHED", "FROM"], undirected: true }`.
+     */
+    ownerMatchPattern?: ContentOwnerMatchPattern;
+    /**
+     * When true, only records carrying a non-empty `tldr` are returned. The
+     * filter is applied BOTH to the default list match and to the `findByIds`
+     * lookup.
+     *
+     * Default (omitted / false): no tldr filter — every content record is
+     * returned, exactly as before.
+     *
+     * a360ai: `true` (Content is a view over AI-summarised records only).
+     */
+    requireTldr?: boolean;
+    /**
+     * Extra computed meta fields hydrated by additional OPTIONAL MATCH clauses.
+     *
+     * Default (omitted): no extra clauses and no extra meta keys.
+     *
+     * a360ai: the `proceedingId` entry documented on
+     * {@link ContentMetaFieldExtension}.
+     */
+    metaFields?: ContentMetaFieldExtension[];
+    /**
+     * Whether the `author` relationship is matched and serialised.
+     *
+     * Default (omitted / true): the `author` relationship is part of the wire and
+     * of the Cypher RETURN, as it has always been.
+     *
+     * a360ai: `false` — a360ai content has no author distinct from the owner and
+     * its wire contract pins relationships to `["owner"]`.
+     */
+    serialiseAuthor?: boolean;
 }
 /**
  * Injection token for Content extension configuration.
  * Use with @Optional() @Inject(CONTENT_EXTENSION_CONFIG) to make it optional.
  */
 export declare const CONTENT_EXTENSION_CONFIG: unique symbol;
+/**
+ * Injection token carrying the descriptor that `ContentModule.forRoot()` built
+ * from the module configuration. The module registers `descriptor.model` in
+ * `modelRegistry` on init; read paths resolve it with `getContentModel()`.
+ */
+export declare const CONTENT_DESCRIPTOR: unique symbol;
 //# sourceMappingURL=content.extension.interface.d.ts.map

package/dist/foundations/content/interfaces/content.extension.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.extension.interface.d.ts","sourceRoot":"","sources":["../../../../src/foundations/content/interfaces/content.extension.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,8EAA8E;IAC9E,KAAK,EAAE,QAAQ,CAAC;IAEhB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;IAExB,+DAA+D;IAC/D,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;IAE5B,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,EAAE,4BAA4B,EAAE,CAAC;CACzD;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,eAAqC,CAAC"}
+{"version":3,"file":"content.extension.interface.d.ts","sourceRoot":"","sources":["../../../../src/foundations/content/interfaces/content.extension.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,8EAA8E;IAC9E,KAAK,EAAE,QAAQ,CAAC;IAEhB,sDAAsD;IACtD,YAAY,EAAE,MAAM,CAAC;IAErB,6DAA6D;IAC7D,SAAS,EAAE,IAAI,GAAG,KAAK,CAAC;IAExB,+DAA+D;IAC/D,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;IAE5B,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB;;;;;;;;OAQG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB,2EAA2E;IAC3E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,WAAW,sBAAsB;IACrC,uBAAuB,EAAE,4BAA4B,EAAE,CAAC;IAExD;;;;;;;OAOG;IACH,iBAAiB,CAAC,EAAE,wBAAwB,CAAC;IAE7C;;;;;;;;;OASG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,yBAAyB,EAAE,CAAC;IAEzC;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED;;;GAGG;AACH,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,eAA+B,CAAC"}

package/dist/foundations/content/interfaces/content.extension.interface.js

@@ -1,9 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CONTENT_EXTENSION_CONFIG = void 0;
+exports.CONTENT_DESCRIPTOR = exports.CONTENT_EXTENSION_CONFIG = void 0;
 /**
  * Injection token for Content extension configuration.
  * Use with @Optional() @Inject(CONTENT_EXTENSION_CONFIG) to make it optional.
  */
 exports.CONTENT_EXTENSION_CONFIG = Symbol("CONTENT_EXTENSION_CONFIG");
+/**
+ * Injection token carrying the descriptor that `ContentModule.forRoot()` built
+ * from the module configuration. The module registers `descriptor.model` in
+ * `modelRegistry` on init; read paths resolve it with `getContentModel()`.
+ */
+exports.CONTENT_DESCRIPTOR = Symbol("CONTENT_DESCRIPTOR");
 //# sourceMappingURL=content.extension.interface.js.map

package/dist/foundations/content/interfaces/content.extension.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"content.extension.interface.js","sourceRoot":"","sources":["../../../../src/foundations/content/interfaces/content.extension.interface.ts"],"names":[],"mappings":";;;AAiDA;;;GAGG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC"}
+{"version":3,"file":"content.extension.interface.js","sourceRoot":"","sources":["../../../../src/foundations/content/interfaces/content.extension.interface.ts"],"names":[],"mappings":";;;AAmLA;;;GAGG;AACU,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAE3E;;;;GAIG;AACU,QAAA,kBAAkB,GAAG,MAAM,CAAC,oBAAoB,CAAC,CAAC"}

package/dist/foundations/content/repositories/content.repository.d.ts

@@ -1,11 +1,22 @@
-import { Document } from "@langchain/core/documents";
 import { ConfigService } from "@nestjs/config";
 import { BaseConfigInterface } from "../../../config/interfaces";
 import { JsonApiCursorInterface } from "../../../core/jsonapi/interfaces/jsonapi.cursor.interface";
 import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
 import { SecurityService } from "../../../core/security/services/security.service";
-import { Content } from "../../content/entities/content.entity";
+import { Content } from "../../content/entities/content";
 import { ContentCypherService } from "../../content/services/content.cypher.service";
+/**
+ * Content is a virtual, multi-label aggregate (the labels come from
+ * `baseConfig.contentTypes`) with no single Neo4j label of its own, so the
+ * inherited AbstractRepository query builders — which assume one
+ * `${labelName}` match — cannot express these reads. Every method below is
+ * genuinely custom and delegates its Cypher fragments to ContentCypherService.
+ *
+ * ContentCypherService is also handed, as an instance, to
+ * RelevancyService/RelevancyRepository by ContentController (duck-typed as
+ * `cypherService: any`, calling `.userHasAccess()` / `.returnStatement()`) for
+ * the `/contents/:id/relevance` endpoint. Do not delete it.
+ */
 export declare class ContentRepository {
     private readonly neo4j;
     private readonly contentCypherService;
@@ -13,10 +24,6 @@ export declare class ContentRepository {
     private readonly configService;
     constructor(neo4j: Neo4jService, contentCypherService: ContentCypherService, securityService: SecurityService, configService: ConfigService<BaseConfigInterface>);
     private getContentTypes;
-    /**
-     * Get the ContentModel from registry (may be extended with additional childrenTokens)
-     */
-    private getContentModel;
     find(params: {
         fetchAll?: boolean;
         term?: string;
@@ -25,7 +32,7 @@ export declare class ContentRepository {
     }): Promise<Content[]>;
     findByIds(params: {
         contentIds: string[];
-    }): Promise<Document[]>;
+    }): Promise<Content[]>;
     findByOwner(params: {
         ownerId: string;
         term?: string;

package/dist/foundations/content/repositories/content.repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/content/repositories/content.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,OAAO,EAAE,mBAAmB,EAA+B,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAEhE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAGrF,qBACa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,KAAK,EAAE,YAAY,EACnB,oBAAoB,EAAE,oBAAoB,EAC1C,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAGpE,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,eAAe;IAQjB,IAAI,CAAC,MAAM,EAAE;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAyBhB,SAAS,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IAkBhE,WAAW,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC;CA0BF"}
+{"version":3,"file":"content.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/content/repositories/content.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAA+B,MAAM,4BAA4B,CAAC;AAC9F,OAAO,EAAE,sBAAsB,EAAE,MAAM,2DAA2D,CAAC;AACnG,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,OAAO,EAAmB,MAAM,gCAAgC,CAAC;AAE1E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAGrF;;;;;;;;;;;GAWG;AACH,qBACa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IACrC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAHb,KAAK,EAAE,YAAY,EACnB,oBAAoB,EAAE,oBAAoB,EAC1C,eAAe,EAAE,eAAe,EAChC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAGpE,OAAO,CAAC,eAAe;IAKjB,IAAI,CAAC,MAAM,EAAE;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAyBhB,SAAS,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAkB/D,WAAW,CAAC,MAAM,EAAE;QACxB,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,MAAM,CAAC,EAAE,sBAAsB,CAAC;KACjC;CA0BF"}

package/dist/foundations/content/repositories/content.repository.js

@@ -12,12 +12,24 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContentRepository = void 0;
 const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
-const registry_1 = require("../../../common/registries/registry");
 const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
 const security_service_1 = require("../../../core/security/services/security.service");
+const content_1 = require("../../content/entities/content");
 const content_meta_1 = require("../../content/entities/content.meta");
 const content_cypher_service_1 = require("../../content/services/content.cypher.service");
 const user_meta_1 = require("../../user/entities/user.meta");
+/**
+ * Content is a virtual, multi-label aggregate (the labels come from
+ * `baseConfig.contentTypes`) with no single Neo4j label of its own, so the
+ * inherited AbstractRepository query builders — which assume one
+ * `${labelName}` match — cannot express these reads. Every method below is
+ * genuinely custom and delegates its Cypher fragments to ContentCypherService.
+ *
+ * ContentCypherService is also handed, as an instance, to
+ * RelevancyService/RelevancyRepository by ContentController (duck-typed as
+ * `cypherService: any`, calling `.userHasAccess()` / `.returnStatement()`) for
+ * the `/contents/:id/relevance` endpoint. Do not delete it.
+ */
 let ContentRepository = class ContentRepository {
     constructor(neo4j, contentCypherService, securityService, configService) {
         this.neo4j = neo4j;
@@ -29,20 +41,10 @@ let ContentRepository = class ContentRepository {
         const types = this.configService.get("contentTypes")?.types ?? [];
         return types.length > 0 ? types : [content_meta_1.contentMeta.labelName];
     }
-    /**
-     * Get the ContentModel from registry (may be extended with additional childrenTokens)
-     */
-    getContentModel() {
-        const model = registry_1.modelRegistry.get(content_meta_1.contentMeta.nodeName);
-        if (!model) {
-            throw new Error(`ContentModel not found in registry for nodeName: ${content_meta_1.contentMeta.nodeName}`);
-        }
-        return model;
-    }
     async find(params) {
         const query = this.neo4j.initQuery({
             cursor: params.cursor,
-            serialiser: this.getContentModel(),
+            serialiser: (0, content_1.getContentModel)(),
             fetchAll: params.fetchAll,
         });
         query.queryParams = {
@@ -61,14 +63,14 @@ let ContentRepository = class ContentRepository {
         return this.neo4j.readMany(query);
     }
     async findByIds(params) {
-        const query = this.neo4j.initQuery({ serialiser: this.getContentModel() });
+        const query = this.neo4j.initQuery({ serialiser: (0, content_1.getContentModel)() });
         query.queryParams = {
             ...query.queryParams,
             ids: params.contentIds,
         };
         query.query += `
         MATCH (${content_meta_1.contentMeta.nodeName}:${this.getContentTypes().join("|")})-[:BELONGS_TO]->(company)
-        WHERE ${content_meta_1.contentMeta.nodeName}.id IN $ids
+        WHERE ${content_meta_1.contentMeta.nodeName}.id IN $ids${this.contentCypherService.tldrFilter()}
         ${this.securityService.userHasAccess({ validator: this.contentCypherService.userHasAccess })}
         ${this.contentCypherService.returnStatement()}
       `;
@@ -76,7 +78,7 @@ let ContentRepository = class ContentRepository {
     }
     async findByOwner(params) {
         const query = this.neo4j.initQuery({
-            serialiser: this.getContentModel(),
+            serialiser: (0, content_1.getContentModel)(),
             cursor: params.cursor,
             fetchAll: params.fetchAll,
         });
@@ -88,7 +90,7 @@ let ContentRepository = class ContentRepository {
         query.query += `
       ${this.contentCypherService.default()}
       ${this.securityService.userHasAccess({ validator: this.contentCypherService.userHasAccess })}
-      MATCH (${content_meta_1.contentMeta.nodeName})<-[:PUBLISHED]-(:${user_meta_1.ownerMeta.labelName} {id: $ownerId})
+      ${this.contentCypherService.ownerMatch({ target: `:${user_meta_1.ownerMeta.labelName} {id: $ownerId}` })}
 
       ORDER BY ${content_meta_1.contentMeta.nodeName}.${params.orderBy ? `${params.orderBy}` : `updatedAt DESC`}
       {CURSOR}

package/dist/foundations/content/repositories/content.repository.js.map

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

package/dist/foundations/content/services/content.cypher.service.d.ts

@@ -8,10 +8,29 @@ export declare class ContentCypherService {
     private readonly extension?;
     constructor(clsService: ClsService, configService: ConfigService<BaseConfigInterface>, extension?: ContentExtensionConfig);
     private getContentTypes;
+    /** Whether the `author` relationship is matched and returned (default: yes). */
+    private get serialiseAuthor();
     default(params?: {
         searchField: string;
         blockCompanyAndUser?: boolean;
     }): string;
+    /**
+     * The `requireTldr` filter as trailing `AND` predicates, for callers that
+     * already opened a WHERE clause of their own (e.g. `ContentRepository.findByIds`).
+     * Returns an empty string when the filter is disabled (the default).
+     */
+    tldrFilter(): string;
+    /**
+     * The Content → owner MATCH clause, driven by `ownerMatchPattern`.
+     *
+     * Default: `MATCH (content)<-[:PUBLISHED]-(<target>)`.
+     *
+     * @param params.target - The pattern's node body, e.g. `"content_owner:User"`
+     *   (bind an alias) or `":User {id: $ownerId}"` (filter without binding).
+     */
+    ownerMatch(params: {
+        target: string;
+    }): string;
     userHasAccess: (params?: {
         useTotalScore?: boolean;
     }) => string;

package/dist/foundations/content/services/content.cypher.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.cypher.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/content/services/content.cypher.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,EAA+B,MAAM,4BAA4B,CAAC;AAI9F,OAAO,EAAE,sBAAsB,EAA4B,MAAM,2CAA2C,CAAC;AAE7G,qBACa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAG9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAJV,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAGjD,SAAS,CAAC,EAAE,sBAAsB;IAGrD,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;IAWhF,aAAa,GAAI,SAAS;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KAAG,MAAM,CAO5D;IAEF,eAAe,GAAI,SAAS;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,YA6CrD;CACH"}
+{"version":3,"file":"content.cypher.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/content/services/content.cypher.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,EAA+B,MAAM,4BAA4B,CAAC;AAI9F,OAAO,EAAE,sBAAsB,EAA4B,MAAM,2CAA2C,CAAC;AAE7G,qBACa,oBAAoB;IAE7B,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,aAAa;IAG9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAJV,UAAU,EAAE,UAAU,EACtB,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC,EAGjD,SAAS,CAAC,EAAE,sBAAsB;IAGrD,OAAO,CAAC,eAAe;IAKvB,gFAAgF;IAChF,OAAO,KAAK,eAAe,GAE1B;IAED,OAAO,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,mBAAmB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM;IAiBhF;;;;OAIG;IACH,UAAU,IAAI,MAAM;IAQpB;;;;;;;OAOG;IACH,UAAU,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IAU9C,aAAa,GAAI,SAAS;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,KAAG,MAAM,CAO5D;IAEF,eAAe,GAAI,SAAS;QAAE,aAAa,CAAC,EAAE,OAAO,CAAA;KAAE,YA0ErD;CACH"}