@carlonicora/nestjs-neo4jsonapi 4.4.0 → 4.5.0

package/dist/foundations/handbook/repositories/handbook-page.repository.js

@@ -0,0 +1,245 @@
+"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.HandbookPageRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const ai_status_1 = require("../../../common/enums/ai.status");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const chunk_meta_1 = require("../../chunk/entities/chunk.meta");
+const handbook_page_1 = require("../entities/handbook-page");
+const handbook_page_meta_1 = require("../entities/handbook-page.meta");
+let HandbookPageRepository = class HandbookPageRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = handbook_page_1.HandbookPageDescriptor;
+    }
+    /**
+     * `path` is the natural key of the ingest: the walk looks a page up by the
+     * file it came from. The descriptor only auto-creates the `id` constraint
+     * (common/helpers/define-entity.ts:387), so this one is declared here — the
+     * same place ChunkRepository declares its own indexes.
+     *
+     * `super.onModuleInit()` runs FIRST and is not optional: the base
+     * implementation is what turns the descriptor's `constraints` and `indexes`
+     * into real Neo4j objects. Overriding it without delegating would silently
+     * drop the `id` uniqueness constraint and the descriptor's FULLTEXT index —
+     * the bug NotificationRepository avoids by re-declaring its `id` constraint
+     * by hand. Delegating keeps the database config derived from the descriptor.
+     */
+    async onModuleInit() {
+        await super.onModuleInit();
+        await this.neo4j.writeOne({
+            query: `CREATE CONSTRAINT handbookpage_path IF NOT EXISTS FOR (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName}) REQUIRE ${handbook_page_meta_1.handbookPageMeta.nodeName}.path IS UNIQUE`,
+        });
+    }
+    /**
+     * The list is a manual's table of contents, not an audit log.
+     *
+     * `AbstractRepository.find` orders by `descriptor.defaultOrderBy`, which
+     * `defineEntity` hardcodes to `updatedAt DESC` and exposes no way to override
+     * — so without this the rows arrive in reverse ingest order and `09-workflow`
+     * renders before `00-start-here`. The one ordering hook `find` does offer a
+     * caller is `orderByFields`, a multi-key `SortCriterion[]`; supplying a
+     * default for it puts `ORDER BY handbookPage.section ASC, handbookPage.order
+     * ASC` ahead of `{CURSOR}` in the inherited query and leaves the fulltext
+     * branch, the structured filters, the security snippet and the pagination
+     * exactly as the framework builds them.
+     *
+     * `order` is the repo-relative path, so sorting on it inside a section
+     * reproduces the filesystem, which is already meaningful. An explicit
+     * `orderBy` or `orderByFields` from the request still wins.
+     */
+    async find(params) {
+        const ordered = params.orderByFields?.length || params.orderBy;
+        return super.find({
+            ...params,
+            orderByFields: ordered
+                ? params.orderByFields
+                : [
+                    { field: "section", direction: "asc" },
+                    { field: "order", direction: "asc" },
+                ],
+        });
+    }
+    /** Every page, unpaginated — the ingest diffs the whole tree in one pass. */
+    async findAllPages() {
+        const query = this.neo4j.initQuery({ serialiser: handbook_page_1.HandbookPageDescriptor.model });
+        query.query = `
+      ${this.buildDefaultMatch()}
+      ORDER BY ${handbook_page_meta_1.handbookPageMeta.nodeName}.path ASC
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readMany(query);
+    }
+    async findByPath(params) {
+        const query = this.neo4j.initQuery({ serialiser: handbook_page_1.HandbookPageDescriptor.model });
+        query.queryParams = { ...query.queryParams, path: params.path };
+        query.query = `
+      ${this.buildDefaultMatch()}
+      WHERE ${handbook_page_meta_1.handbookPageMeta.nodeName}.path = $path
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readOne(query);
+    }
+    /**
+     * Provenance for one answer: the repo-relative path of the page each cited
+     * chunk belongs to, in the order the chunks were cited.
+     *
+     * This does NOT go through `readMany`, because the result is not a
+     * `HandbookPage` — it is one scalar column. Raw records never leave this
+     * method: the mapping to `string[]` happens here, and a row whose `path` is
+     * missing is dropped rather than returned as an empty string. A chunk whose
+     * page no longer exists simply does not match, so it disappears from the
+     * provenance list instead of appearing as a blank source.
+     */
+    async findPathsByChunkIds(params) {
+        if (params.chunkIds.length === 0)
+            return [];
+        const result = await this.neo4j.read(`
+      UNWIND $chunkIds AS chunkId
+      MATCH (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName})-[:HAS_CHUNK]->(${chunk_meta_1.chunkMeta.nodeName}:${chunk_meta_1.chunkMeta.labelName} {id: chunkId})
+      RETURN ${handbook_page_meta_1.handbookPageMeta.nodeName}.path AS path
+    `, { chunkIds: params.chunkIds });
+        return (result?.records ?? [])
+            .map((record) => record.get("path"))
+            .filter((path) => typeof path === "string" && path.length > 0);
+    }
+    async createPage(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = {
+            ...query.queryParams,
+            ...params,
+            // A page the index does not list has no summary. `null` clears the
+            // property in Cypher; `undefined` is not a legal driver parameter.
+            summary: params.summary ?? null,
+            aiStatus: ai_status_1.AiStatus.Pending,
+        };
+        query.query = `
+      CREATE (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName} {
+        id: $id,
+        path: $path,
+        title: $title,
+        content: $content,
+        contentHash: $contentHash,
+        wordCount: $wordCount,
+        aiStatus: $aiStatus,
+        section: $section,
+        order: $order,
+        summary: $summary,
+        createdAt: datetime(),
+        updatedAt: datetime()
+      })
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    async updatePage(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = {
+            ...query.queryParams,
+            ...params,
+            summary: params.summary ?? null,
+            aiStatus: ai_status_1.AiStatus.Pending,
+        };
+        query.query = `
+      MATCH (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName} {id: $id})
+      SET ${handbook_page_meta_1.handbookPageMeta.nodeName}.title = $title,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.content = $content,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.contentHash = $contentHash,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.wordCount = $wordCount,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.aiStatus = $aiStatus,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.section = $section,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.order = $order,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.summary = $summary,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.updatedAt = datetime()
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    /**
+     * Index fields only — no content, no hash, no chunk work.
+     *
+     * The walk calls this for a page whose bytes did not change, so that a sync
+     * which only adds new index data (a README summary, a frontmatter `section`)
+     * costs nothing in embeddings. Bumping INGEST_FORMAT_VERSION instead would
+     * change every contentHash and re-embed the whole tree.
+     */
+    async updateMetadata(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, ...params, summary: params.summary ?? null };
+        query.query = `
+      MATCH (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName} {id: $id})
+      SET ${handbook_page_meta_1.handbookPageMeta.nodeName}.title = $title,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.section = $section,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.order = $order,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.summary = $summary,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.updatedAt = datetime()
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    /**
+     * The display translation of one page — title, summary and body.
+     *
+     * Display fields ONLY. No content, no contentHash, no aiStatus, no chunk
+     * work: the page is indexed in English and shown in the display language, so
+     * a translation that arrives, changes or disappears must leave the retrieval
+     * store byte-for-byte as it was. Writing `content` here, or bumping the hash,
+     * would re-chunk and re-embed the page in the translated language and poison
+     * the index the handbook answers from.
+     *
+     * Every value is bound, and an absent one is bound as `null` rather than
+     * omitted: `null` CLEARS the property, which is what a page whose translation
+     * was deleted needs, and `undefined` is not a legal driver parameter.
+     */
+    async updateDisplay(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = {
+            ...query.queryParams,
+            id: params.id,
+            displayTitle: params.displayTitle ?? null,
+            displaySummary: params.displaySummary ?? null,
+            displayContent: params.displayContent ?? null,
+        };
+        query.query = `
+      MATCH (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName} {id: $id})
+      SET ${handbook_page_meta_1.handbookPageMeta.nodeName}.displayTitle = $displayTitle,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.displaySummary = $displaySummary,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.displayContent = $displayContent,
+          ${handbook_page_meta_1.handbookPageMeta.nodeName}.updatedAt = datetime()
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    async updateStatus(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, id: params.id, aiStatus: params.aiStatus };
+        query.query = `
+      MATCH (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName} {id: $id})
+      SET ${handbook_page_meta_1.handbookPageMeta.nodeName}.aiStatus = $aiStatus, ${handbook_page_meta_1.handbookPageMeta.nodeName}.updatedAt = datetime()
+    `;
+        await this.neo4j.writeOne(query);
+    }
+    async deletePage(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = { ...query.queryParams, id: params.id };
+        query.query = `
+      MATCH (${handbook_page_meta_1.handbookPageMeta.nodeName}:${handbook_page_meta_1.handbookPageMeta.labelName} {id: $id})
+      DETACH DELETE ${handbook_page_meta_1.handbookPageMeta.nodeName}
+    `;
+        await this.neo4j.writeOne(query);
+    }
+};
+exports.HandbookPageRepository = HandbookPageRepository;
+exports.HandbookPageRepository = HandbookPageRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], HandbookPageRepository);
+//# sourceMappingURL=handbook-page.repository.js.map

package/dist/foundations/handbook/repositories/handbook-page.repository.js.map

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

package/dist/foundations/handbook/repositories/handbook-section.repository.d.ts

@@ -0,0 +1,36 @@
+import { OnModuleInit } from "@nestjs/common";
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { HandbookSection, HandbookSectionDescriptor } from "../entities/handbook-section";
+export declare class HandbookSectionRepository extends AbstractRepository<HandbookSection, typeof HandbookSectionDescriptor.relationships> implements OnModuleInit {
+    protected readonly descriptor: import("../../..").EntityDescriptor<HandbookSection, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * `key` is the natural key of the ingest. `super.onModuleInit()` runs FIRST
+     * and is not optional: the base implementation turns the descriptor's own
+     * constraints and indexes into real Neo4j objects, exactly as
+     * HandbookPageRepository documents.
+     */
+    onModuleInit(): Promise<void>;
+    /** Every section, unpaginated — there are ten of them. */
+    findAllSections(): Promise<HandbookSection[]>;
+    /**
+     * Sections are replaced wholesale on every sync: there are ten of them and
+     * diffing buys nothing. One statement, so a failed sync cannot leave the
+     * tree half-described.
+     */
+    replaceAll(params: {
+        sections: {
+            id: string;
+            key: string;
+            title: string;
+            summary?: string;
+            order: string;
+            displayTitle?: string;
+            displaySummary?: string;
+        }[];
+    }): Promise<void>;
+}
+//# sourceMappingURL=handbook-section.repository.d.ts.map

package/dist/foundations/handbook/repositories/handbook-section.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-section.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/repositories/handbook-section.repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAG1F,qBACa,yBACX,SAAQ,kBAAkB,CAAC,eAAe,EAAE,OAAO,yBAAyB,CAAC,aAAa,CAC1F,YAAW,YAAY;IAEvB,SAAS,CAAC,QAAQ,CAAC,UAAU,2DAA6B;gBAE9C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;;OAKG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAQnC,0DAA0D;IACpD,eAAe,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC;IAUnD;;;;OAIG;IACG,UAAU,CAAC,MAAM,EAAE;QACvB,QAAQ,EAAE;YACR,EAAE,EAAE,MAAM,CAAC;YACX,GAAG,EAAE,MAAM,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC;YACd,OAAO,CAAC,EAAE,MAAM,CAAC;YACjB,KAAK,EAAE,MAAM,CAAC;YACd,YAAY,CAAC,EAAE,MAAM,CAAC;YACtB,cAAc,CAAC,EAAE,MAAM,CAAC;SACzB,EAAE,CAAC;KACL,GAAG,OAAO,CAAC,IAAI,CAAC;CAiClB"}

package/dist/foundations/handbook/repositories/handbook-section.repository.js

@@ -0,0 +1,91 @@
+"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.HandbookSectionRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const handbook_section_1 = require("../entities/handbook-section");
+const handbook_section_meta_1 = require("../entities/handbook-section.meta");
+let HandbookSectionRepository = class HandbookSectionRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = handbook_section_1.HandbookSectionDescriptor;
+    }
+    /**
+     * `key` is the natural key of the ingest. `super.onModuleInit()` runs FIRST
+     * and is not optional: the base implementation turns the descriptor's own
+     * constraints and indexes into real Neo4j objects, exactly as
+     * HandbookPageRepository documents.
+     */
+    async onModuleInit() {
+        await super.onModuleInit();
+        await this.neo4j.writeOne({
+            query: `CREATE CONSTRAINT handbooksection_key IF NOT EXISTS FOR (${handbook_section_meta_1.handbookSectionMeta.nodeName}:${handbook_section_meta_1.handbookSectionMeta.labelName}) REQUIRE ${handbook_section_meta_1.handbookSectionMeta.nodeName}.key IS UNIQUE`,
+        });
+    }
+    /** Every section, unpaginated — there are ten of them. */
+    async findAllSections() {
+        const query = this.neo4j.initQuery({ serialiser: handbook_section_1.HandbookSectionDescriptor.model });
+        query.query = `
+      ${this.buildDefaultMatch()}
+      ORDER BY ${handbook_section_meta_1.handbookSectionMeta.nodeName}.order ASC
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readMany(query);
+    }
+    /**
+     * Sections are replaced wholesale on every sync: there are ten of them and
+     * diffing buys nothing. One statement, so a failed sync cannot leave the
+     * tree half-described.
+     */
+    async replaceAll(params) {
+        const query = this.neo4j.initQuery();
+        query.queryParams = {
+            ...query.queryParams,
+            // An absent optional is bound as `null`, never left `undefined`: the
+            // driver takes no `undefined`, and `null` is what writes "this section
+            // has no blurb / no translation" rather than a stale value.
+            sections: params.sections.map((section) => ({
+                ...section,
+                summary: section.summary ?? null,
+                displayTitle: section.displayTitle ?? null,
+                displaySummary: section.displaySummary ?? null,
+            })),
+        };
+        query.query = `
+      OPTIONAL MATCH (existing:${handbook_section_meta_1.handbookSectionMeta.labelName})
+      DETACH DELETE existing
+      WITH count(*) AS ignored
+      UNWIND $sections AS section
+      CREATE (${handbook_section_meta_1.handbookSectionMeta.nodeName}:${handbook_section_meta_1.handbookSectionMeta.labelName} {
+        id: section.id,
+        key: section.key,
+        title: section.title,
+        summary: section.summary,
+        order: section.order,
+        displayTitle: section.displayTitle,
+        displaySummary: section.displaySummary,
+        createdAt: datetime(),
+        updatedAt: datetime()
+      })
+    `;
+        await this.neo4j.writeOne(query);
+    }
+};
+exports.HandbookSectionRepository = HandbookSectionRepository;
+exports.HandbookSectionRepository = HandbookSectionRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], HandbookSectionRepository);
+//# sourceMappingURL=handbook-section.repository.js.map

package/dist/foundations/handbook/repositories/handbook-section.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-section.repository.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/repositories/handbook-section.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA0D;AAC1D,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,mEAA0F;AAC1F,6EAAwE;AAGjE,IAAM,yBAAyB,GAA/B,MAAM,yBACX,SAAQ,wCAAmF;IAK3F,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,4CAAyB,CAAC;IAI1D,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,KAAK,CAAC,YAAY,EAAE,CAAC;QAE3B,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YACxB,KAAK,EAAE,4DAA4D,2CAAmB,CAAC,QAAQ,IAAI,2CAAmB,CAAC,SAAS,aAAa,2CAAmB,CAAC,QAAQ,gBAAgB;SAC1L,CAAC,CAAC;IACL,CAAC;IAED,0DAA0D;IAC1D,KAAK,CAAC,eAAe;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,4CAAyB,CAAC,KAAK,EAAE,CAAC,CAAC;QACpF,KAAK,CAAC,KAAK,GAAG;QACV,IAAI,CAAC,iBAAiB,EAAE;iBACf,2CAAmB,CAAC,QAAQ;QACrC,IAAI,CAAC,oBAAoB,EAAE;KAC9B,CAAC;QACF,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU,CAAC,MAUhB;QACC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;QACrC,KAAK,CAAC,WAAW,GAAG;YAClB,GAAG,KAAK,CAAC,WAAW;YACpB,qEAAqE;YACrE,uEAAuE;YACvE,4DAA4D;YAC5D,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;gBAC1C,GAAG,OAAO;gBACV,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,IAAI;gBAChC,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;gBAC1C,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,IAAI;aAC/C,CAAC,CAAC;SACJ,CAAC;QACF,KAAK,CAAC,KAAK,GAAG;iCACe,2CAAmB,CAAC,SAAS;;;;gBAI9C,2CAAmB,CAAC,QAAQ,IAAI,2CAAmB,CAAC,SAAS;;;;;;;;;;;KAWxE,CAAC;QACF,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;CACF,CAAA;AAnFY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,mBAAU,GAAE;qCAOQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAN9E,yBAAyB,CAmFrC"}

package/dist/foundations/handbook/repositories/handbook-thread-message.repository.d.ts

@@ -0,0 +1,36 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { HandbookThreadMessage, HandbookThreadMessageDescriptor } from "../entities/handbook-thread-message";
+/**
+ * HandbookThreadMessageRepository
+ *
+ * A message carries no owner of its own: access is inherited from the parent
+ * thread's `CREATED_BY` edge. As with the thread there is no company filter to
+ * fall back on, so this override is the only thing standing between one
+ * administrator and another's conversation.
+ */
+export declare class HandbookThreadMessageRepository extends AbstractRepository<HandbookThreadMessage, typeof HandbookThreadMessageDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<HandbookThreadMessage, {
+        thread: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            required: true;
+            dtoKey: string;
+            immutable: true;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    protected buildUserHasAccess(): string;
+    /**
+     * Next free position under a thread: 0 for an empty thread, otherwise
+     * max(position) + 1. Mirrors `AssistantMessageRepository.getNextPosition`.
+     */
+    getNextPosition(params: {
+        threadId: string;
+    }): Promise<number>;
+}
+//# sourceMappingURL=handbook-thread-message.repository.d.ts.map

package/dist/foundations/handbook/repositories/handbook-thread-message.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/repositories/handbook-thread-message.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAEnF,OAAO,EAAE,qBAAqB,EAAE,+BAA+B,EAAE,MAAM,qCAAqC,CAAC;AAG7G;;;;;;;GAOG;AACH,qBACa,+BAAgC,SAAQ,kBAAkB,CACrE,qBAAqB,EACrB,OAAO,+BAA+B,CAAC,aAAa,CACrD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;OAAmC;gBAEpD,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAStC;;;OAGG;IACG,eAAe,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAcrE"}

package/dist/foundations/handbook/repositories/handbook-thread-message.repository.js

@@ -0,0 +1,63 @@
+"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.HandbookThreadMessageRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const handbook_thread_meta_1 = require("../entities/handbook-thread.meta");
+const handbook_thread_message_1 = require("../entities/handbook-thread-message");
+const handbook_thread_message_meta_1 = require("../entities/handbook-thread-message.meta");
+/**
+ * HandbookThreadMessageRepository
+ *
+ * A message carries no owner of its own: access is inherited from the parent
+ * thread's `CREATED_BY` edge. As with the thread there is no company filter to
+ * fall back on, so this override is the only thing standing between one
+ * administrator and another's conversation.
+ */
+let HandbookThreadMessageRepository = class HandbookThreadMessageRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = handbook_thread_message_1.HandbookThreadMessageDescriptor;
+    }
+    buildUserHasAccess() {
+        const { nodeName } = this.descriptor.model;
+        return `WITH ${nodeName}
+            WHERE EXISTS {
+              MATCH (${nodeName})<-[:HAS_MESSAGE]-(:${handbook_thread_meta_1.handbookThreadMeta.labelName})-[:CREATED_BY]->(:User {id: $currentUserId})
+            }
+            WITH ${nodeName}`;
+    }
+    /**
+     * Next free position under a thread: 0 for an empty thread, otherwise
+     * max(position) + 1. Mirrors `AssistantMessageRepository.getNextPosition`.
+     */
+    async getNextPosition(params) {
+        const result = await this.neo4j.read(`
+        MATCH (:${handbook_thread_meta_1.handbookThreadMeta.labelName} {id: $threadId})-[:HAS_MESSAGE]->(${handbook_thread_message_meta_1.handbookThreadMessageMeta.nodeName}:${handbook_thread_message_meta_1.handbookThreadMessageMeta.labelName})
+        RETURN coalesce(max(${handbook_thread_message_meta_1.handbookThreadMessageMeta.nodeName}.position), -1) + 1 AS next
+      `, { threadId: params.threadId });
+        const record = result.records[0];
+        if (!record)
+            return 0;
+        const value = record.get("next");
+        return typeof value?.toNumber === "function" ? value.toNumber() : Number(value ?? 0);
+    }
+};
+exports.HandbookThreadMessageRepository = HandbookThreadMessageRepository;
+exports.HandbookThreadMessageRepository = HandbookThreadMessageRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], HandbookThreadMessageRepository);
+//# sourceMappingURL=handbook-thread-message.repository.js.map

package/dist/foundations/handbook/repositories/handbook-thread-message.repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message.repository.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/repositories/handbook-thread-message.repository.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAA4C;AAC5C,2CAAwC;AACxC,2FAAuF;AACvF,8EAA0E;AAC1E,uFAAmF;AACnF,2EAAsE;AACtE,iFAA6G;AAC7G,2FAAqF;AAErF;;;;;;;GAOG;AAEI,IAAM,+BAA+B,GAArC,MAAM,+BAAgC,SAAQ,wCAGpD;IAGC,YAAY,KAAmB,EAAE,eAAgC,EAAE,UAAsB;QACvF,KAAK,CAAC,KAAK,EAAE,eAAe,EAAE,UAAU,CAAC,CAAC;QAHzB,eAAU,GAAG,yDAA+B,CAAC;IAIhE,CAAC;IAES,kBAAkB;QAC1B,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;QAC3C,OAAO,QAAQ,QAAQ;;uBAEJ,QAAQ,uBAAuB,yCAAkB,CAAC,SAAS;;mBAE/D,QAAQ,EAAE,CAAC;IAC5B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,MAA4B;QAChD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAClC;kBACY,yCAAkB,CAAC,SAAS,sCAAsC,wDAAyB,CAAC,QAAQ,IAAI,wDAAyB,CAAC,SAAS;8BAC/H,wDAAyB,CAAC,QAAQ;OACzD,EACD,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAC9B,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,CAAC;QACtB,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,OAAO,OAAO,KAAK,EAAE,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC;IACvF,CAAC;CACF,CAAA;AArCY,0EAA+B;0CAA/B,+BAA+B;IAD3C,IAAA,mBAAU,GAAE;qCAOQ,4BAAY,EAAmB,kCAAe,EAAc,uBAAU;GAN9E,+BAA+B,CAqC3C"}

package/dist/foundations/handbook/repositories/handbook-thread.repository.d.ts

@@ -0,0 +1,63 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { HandbookThread, HandbookThreadDescriptor } from "../entities/handbook-thread";
+/**
+ * HandbookThreadRepository
+ *
+ * `HandbookThread` is `isCompanyScoped: false`, so `buildDefaultMatch()` emits
+ * no company filter at all — the `CREATED_BY` owner edge asserted here is the
+ * ENTIRE security boundary. Without this override every administrator would
+ * read and mutate every other administrator's threads.
+ *
+ * `$currentUserId` is auto-injected into queryParams by
+ * `Neo4jService.initQuery()` (it reads `clsService.get("userId")`), exactly as
+ * `AssistantRepository` relies on.
+ */
+export declare class HandbookThreadRepository extends AbstractRepository<HandbookThread, typeof HandbookThreadDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<HandbookThread, {
+        owner: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "one";
+            required: false;
+            dtoKey: string;
+            contextKey: string;
+            immutable: true;
+        };
+        messages: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "many";
+            required: false;
+            dtoKey: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    protected buildUserHasAccess(): string;
+    /**
+     * Bump `updatedAt` so the thread list — ordered by the descriptor default
+     * `updatedAt DESC` — surfaces the conversation a user just spoke in. Neither
+     * creating a child message nor writing the `HAS_MESSAGE` edge touches the
+     * parent node, so without this an active thread would sink below a thread
+     * that was merely renamed.
+     */
+    touch(params: {
+        id: string;
+    }): Promise<void>;
+    /**
+     * Delete the thread AND its messages. `DETACH DELETE` on the thread alone
+     * would drop the `HAS_MESSAGE` edges and orphan every message node, which
+     * — because the messages are only ever reachable through their thread —
+     * means they could never be read or deleted again.
+     *
+     * Mirrors `AssistantRepository.delete`.
+     */
+    delete(params: {
+        id: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=handbook-thread.repository.d.ts.map

package/dist/foundations/handbook/repositories/handbook-thread.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/repositories/handbook-thread.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AAIvF;;;;;;;;;;;GAWG;AACH,qBACa,wBAAyB,SAAQ,kBAAkB,CAC9D,cAAc,EACd,OAAO,wBAAwB,CAAC,aAAa,CAC9C;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;;;;;;;;;;;OAA4B;gBAE7C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF,SAAS,CAAC,kBAAkB,IAAI,MAAM;IAStC;;;;;;OAMG;IACG,KAAK,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD;;;;;;;OAOG;IACG,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAUpD"}