@carlonicora/nestjs-neo4jsonapi 4.4.0 → 4.5.0

package/dist/foundations/handbook/dtos/handbook-thread-post.dto.js

@@ -0,0 +1,60 @@
+"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.HandbookThreadPostDTO = exports.HandbookThreadPostDataDTO = exports.HandbookThreadPostAttributesDTO = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const handbook_thread_meta_1 = require("../entities/handbook-thread.meta");
+/**
+ * Body of `POST /handbookthreads`.
+ *
+ * The thread is created FROM the first question, so the payload carries
+ * `question` and not `title`: the title is derived server-side from the
+ * answer the responder produces. No `id` — the server mints it.
+ */
+class HandbookThreadPostAttributesDTO {
+}
+exports.HandbookThreadPostAttributesDTO = HandbookThreadPostAttributesDTO;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(10_000),
+    __metadata("design:type", String)
+], HandbookThreadPostAttributesDTO.prototype, "question", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], HandbookThreadPostAttributesDTO.prototype, "handbookPageId", void 0);
+class HandbookThreadPostDataDTO {
+}
+exports.HandbookThreadPostDataDTO = HandbookThreadPostDataDTO;
+__decorate([
+    (0, class_validator_1.Equals)(handbook_thread_meta_1.handbookThreadMeta.endpoint),
+    __metadata("design:type", String)
+], HandbookThreadPostDataDTO.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookThreadPostAttributesDTO),
+    __metadata("design:type", HandbookThreadPostAttributesDTO)
+], HandbookThreadPostDataDTO.prototype, "attributes", void 0);
+class HandbookThreadPostDTO {
+}
+exports.HandbookThreadPostDTO = HandbookThreadPostDTO;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookThreadPostDataDTO),
+    __metadata("design:type", HandbookThreadPostDataDTO)
+], HandbookThreadPostDTO.prototype, "data", void 0);
+//# sourceMappingURL=handbook-thread-post.dto.js.map

package/dist/foundations/handbook/dtos/handbook-thread-post.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-post.dto.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-thread-post.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDASyB;AACzB,2EAAsE;AAEtE;;;;;;GAMG;AACH,MAAa,+BAA+B;CAe3C;AAfD,0EAeC;AAVC;IAJC,IAAA,2BAAS,GAAE;IACX,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,MAAM,CAAC;;iEACD;AASjB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,GAAE;;uEACe;AAG1B,MAAa,yBAAyB;CAQrC;AARD,8DAQC;AANC;IADC,IAAA,wBAAM,EAAC,yCAAkB,CAAC,QAAQ,CAAC;;uDACvB;AAKb;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,+BAA+B,CAAC;8BAChC,+BAA+B;6DAAC;AAG9C,MAAa,qBAAqB;CAKjC;AALD,sDAKC;AADC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,yBAAyB,CAAC;8BAChC,yBAAyB;mDAAC"}

package/dist/foundations/handbook/entities/handbook-page.d.ts

@@ -0,0 +1,25 @@
+import { Entity } from "../../../common";
+/**
+ * One markdown file of an application's own developer documentation.
+ *
+ * Global content: like HowTo, a HandbookPage has NO `BELONGS_TO Company` edge.
+ * Unlike HowTo it is developer-facing — every route is administrator-only and
+ * retrieval reaches it only in handbook mode.
+ */
+export type HandbookPage = Entity & {
+    path: string;
+    title: string;
+    content: string;
+    contentHash: string;
+    wordCount?: number;
+    aiStatus?: string;
+    section?: string;
+    order?: string;
+    summary?: string;
+    displayTitle?: string;
+    displaySummary?: string;
+    displayContent?: string;
+};
+export declare const HandbookPageDescriptor: import("../../../common").EntityDescriptor<HandbookPage, {}>;
+export type HandbookPageDescriptorType = typeof HandbookPageDescriptor;
+//# sourceMappingURL=handbook-page.d.ts.map

package/dist/foundations/handbook/entities/handbook-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-page.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-page.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,sBAAsB,8DA6CjC,CAAC;AAEH,MAAM,MAAM,0BAA0B,GAAG,OAAO,sBAAsB,CAAC"}

package/dist/foundations/handbook/entities/handbook-page.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookPageDescriptor = void 0;
+const common_1 = require("../../../common");
+const handbook_page_meta_1 = require("./handbook-page.meta");
+exports.HandbookPageDescriptor = (0, common_1.defineEntity)()({
+    ...handbook_page_meta_1.handbookPageMeta,
+    isCompanyScoped: false,
+    fields: {
+        path: { type: "string", required: true },
+        title: { type: "string", required: true },
+        content: { type: "string", required: true },
+        contentHash: { type: "string", required: true },
+        wordCount: { type: "number" },
+        aiStatus: { type: "string" },
+        /** The front matter `section`, falling back to the file's first path segment. */
+        section: { type: "string" },
+        /**
+         * The repo-relative path of the file, lowercased.
+         *
+         * Sorting on it inside a section reproduces the order of the tree on disk,
+         * because the directories — and the rulebook files inside them — carry
+         * numeric prefixes (`00-start-here`, `03-backend`, …). A string, not a
+         * number: nothing here does arithmetic, and a renamed file needs no
+         * renumbering of its neighbours.
+         */
+        order: { type: "string" },
+        /** The one-line description the tree's README index gives this path, when it has one. */
+        summary: { type: "string" },
+        /**
+         * The display translation of this page, when the tree ships one.
+         *
+         * Written by the ingest's display pass from `<path>/<displayPath>/<same
+         * relative path>`, and READ ONLY by the reading surface. Nothing here is
+         * chunked, embedded or retrievable: `content` stays the indexed English
+         * body, and `contentHash` is computed over the English file alone, so a
+         * translation that changes re-embeds nothing.
+         */
+        displayTitle: { type: "string" },
+        displaySummary: { type: "string" },
+        displayContent: { type: "string" },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=handbook-page.js.map

package/dist/foundations/handbook/entities/handbook-page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-page.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-page.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,6DAAwD;AAwB3C,QAAA,sBAAsB,GAAG,IAAA,qBAAY,GAAgB,CAAC;IACjE,GAAG,qCAAgB;IAEnB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAE5B,iFAAiF;QACjF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAE3B;;;;;;;;WAQG;QACH,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAEzB,yFAAyF;QACzF,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAE3B;;;;;;;;WAQG;QACH,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAClC,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACnC;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/handbook/entities/handbook-page.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const handbookPageMeta: DataMeta;
+//# sourceMappingURL=handbook-page.meta.d.ts.map

package/dist/foundations/handbook/entities/handbook-page.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-page.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-page.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,gBAAgB,EAAE,QAK9B,CAAC"}

package/dist/foundations/handbook/entities/handbook-page.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handbookPageMeta = void 0;
+exports.handbookPageMeta = {
+    type: "handbookpages",
+    endpoint: "handbookpages",
+    nodeName: "handbookPage",
+    labelName: "HandbookPage",
+};
+//# sourceMappingURL=handbook-page.meta.js.map

package/dist/foundations/handbook/entities/handbook-page.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-page.meta.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-page.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,gBAAgB,GAAa;IACxC,IAAI,EAAE,eAAe;IACrB,QAAQ,EAAE,eAAe;IACzB,QAAQ,EAAE,cAAc;IACxB,SAAS,EAAE,cAAc;CAC1B,CAAC"}

package/dist/foundations/handbook/entities/handbook-section.d.ts

@@ -0,0 +1,22 @@
+import { Entity } from "../../../common";
+/**
+ * One top-level directory of the configured documentation tree.
+ *
+ * Global content: like HandbookPage, a HandbookSection has NO `BELONGS_TO
+ * Company` edge — the tree belongs to the application, not to a tenant.
+ *
+ * A page names its section by the `section` key, not by an edge, so there is
+ * nothing to join and nothing to write per page. The ingest replaces EVERY
+ * section on each sync: there are ten of them and diffing buys nothing.
+ */
+export type HandbookSection = Entity & {
+    key: string;
+    title: string;
+    summary?: string;
+    order: string;
+    displayTitle?: string;
+    displaySummary?: string;
+};
+export declare const HandbookSectionDescriptor: import("../../../common").EntityDescriptor<HandbookSection, {}>;
+export type HandbookSectionDescriptorType = typeof HandbookSectionDescriptor;
+//# sourceMappingURL=handbook-section.d.ts.map

package/dist/foundations/handbook/entities/handbook-section.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-section.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-section.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;;;;;;;;GASG;AACH,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,yBAAyB,iEAqBpC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,OAAO,yBAAyB,CAAC"}

package/dist/foundations/handbook/entities/handbook-section.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookSectionDescriptor = void 0;
+const common_1 = require("../../../common");
+const handbook_section_meta_1 = require("./handbook-section.meta");
+exports.HandbookSectionDescriptor = (0, common_1.defineEntity)()({
+    ...handbook_section_meta_1.handbookSectionMeta,
+    isCompanyScoped: false,
+    fields: {
+        key: { type: "string", required: true },
+        title: { type: "string", required: true },
+        summary: { type: "string" },
+        order: { type: "string", required: true },
+        /**
+         * The display translation of the heading and its blurb, taken from the
+         * display tree's own README. Absent when no `displayPath` is configured,
+         * or when that README describes no such section.
+         */
+        displayTitle: { type: "string" },
+        displaySummary: { type: "string" },
+    },
+    relationships: {},
+});
+//# sourceMappingURL=handbook-section.js.map

package/dist/foundations/handbook/entities/handbook-section.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-section.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-section.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,mEAA8D;AAqBjD,QAAA,yBAAyB,GAAG,IAAA,qBAAY,GAAmB,CAAC;IACvE,GAAG,2CAAmB;IAEtB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACvC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACzC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAEzC;;;;WAIG;QACH,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAChC,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACnC;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/handbook/entities/handbook-section.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const handbookSectionMeta: DataMeta;
+//# sourceMappingURL=handbook-section.meta.d.ts.map

package/dist/foundations/handbook/entities/handbook-section.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-section.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-section.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,mBAAmB,EAAE,QAKjC,CAAC"}

package/dist/foundations/handbook/entities/handbook-section.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handbookSectionMeta = void 0;
+exports.handbookSectionMeta = {
+    type: "handbooksections",
+    endpoint: "handbooksections",
+    nodeName: "handbookSection",
+    labelName: "HandbookSection",
+};
+//# sourceMappingURL=handbook-section.meta.js.map

package/dist/foundations/handbook/entities/handbook-section.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-section.meta.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-section.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,mBAAmB,GAAa;IAC3C,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,kBAAkB;IAC5B,QAAQ,EAAE,iBAAiB;IAC3B,SAAS,EAAE,iBAAiB;CAC7B,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread-message.d.ts

@@ -0,0 +1,36 @@
+import { Entity } from "../../../common";
+import type { HandbookThread } from "./handbook-thread";
+export type HandbookThreadMessageRole = "user" | "assistant";
+/**
+ * One turn of a handbook conversation.
+ *
+ * `sources` holds repo-relative HandbookPage paths rather than `CITES` edges to
+ * `Chunk` nodes (the shape `AssistantMessage` uses). The handbook answer is
+ * attributed to the PAGE a reader can open, chunk boundaries are an ingest
+ * detail, and the paths are resolved once at write time — so a re-ingest that
+ * replaces the chunks leaves the rendered provenance intact.
+ *
+ * `isCompanyScoped: false` for the same reason as the thread; access is
+ * inherited from the parent thread's owner edge, enforced in
+ * `HandbookThreadMessageRepository.buildUserHasAccess()`.
+ */
+export type HandbookThreadMessage = Entity & {
+    role: HandbookThreadMessageRole;
+    content: string;
+    position: number;
+    sources?: string[];
+    thread?: HandbookThread;
+};
+export declare const HandbookThreadMessageDescriptor: import("../../../common").EntityDescriptor<HandbookThreadMessage, {
+    thread: {
+        model: import("../../../common").DataMeta;
+        direction: "in";
+        relationship: string;
+        cardinality: "one";
+        required: true;
+        dtoKey: string;
+        immutable: true;
+    };
+}>;
+export type HandbookThreadMessageDescriptorType = typeof HandbookThreadMessageDescriptor;
+//# sourceMappingURL=handbook-thread-message.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread-message.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAIxD,MAAM,MAAM,yBAAyB,GAAG,MAAM,GAAG,WAAW,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG;IAC3C,IAAI,EAAE,yBAAyB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB,CAAC;AAEF,eAAO,MAAM,+BAA+B;;;;;;;;;;EAuB1C,CAAC;AAEH,MAAM,MAAM,mCAAmC,GAAG,OAAO,+BAA+B,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread-message.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookThreadMessageDescriptor = void 0;
+const common_1 = require("../../../common");
+const handbook_thread_meta_1 = require("./handbook-thread.meta");
+const handbook_thread_message_meta_1 = require("./handbook-thread-message.meta");
+exports.HandbookThreadMessageDescriptor = (0, common_1.defineEntity)()({
+    ...handbook_thread_message_meta_1.handbookThreadMessageMeta,
+    isCompanyScoped: false,
+    fields: {
+        role: { type: "string", required: true },
+        content: { type: "string", required: true },
+        position: { type: "number", required: true },
+        sources: { type: "string[]" },
+    },
+    relationships: {
+        thread: {
+            model: handbook_thread_meta_1.handbookThreadMeta,
+            direction: "in",
+            relationship: "HAS_MESSAGE",
+            cardinality: "one",
+            required: true,
+            dtoKey: "thread",
+            immutable: true,
+        },
+    },
+});
+//# sourceMappingURL=handbook-thread-message.js.map

package/dist/foundations/handbook/entities/handbook-thread-message.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread-message.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AAEvD,iEAA4D;AAC5D,iFAA2E;AAyB9D,QAAA,+BAA+B,GAAG,IAAA,qBAAY,GAAyB,CAAC;IACnF,GAAG,wDAAyB;IAE5B,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3C,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC5C,OAAO,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;KAC9B;IAED,aAAa,EAAE;QACb,MAAM,EAAE;YACN,KAAK,EAAE,yCAAkB;YACzB,SAAS,EAAE,IAAI;YACf,YAAY,EAAE,aAAa;YAC3B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,QAAQ;YAChB,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread-message.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const handbookThreadMessageMeta: DataMeta;
+//# sourceMappingURL=handbook-thread-message.meta.d.ts.map

package/dist/foundations/handbook/entities/handbook-thread-message.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread-message.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,yBAAyB,EAAE,QAKvC,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread-message.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handbookThreadMessageMeta = void 0;
+exports.handbookThreadMessageMeta = {
+    type: "handbookthreadmessages",
+    endpoint: "handbookthreadmessages",
+    nodeName: "handbookThreadMessage",
+    labelName: "HandbookThreadMessage",
+};
+//# sourceMappingURL=handbook-thread-message.meta.js.map

package/dist/foundations/handbook/entities/handbook-thread-message.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message.meta.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread-message.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,yBAAyB,GAAa;IACjD,IAAI,EAAE,wBAAwB;IAC9B,QAAQ,EAAE,wBAAwB;IAClC,QAAQ,EAAE,uBAAuB;IACjC,SAAS,EAAE,uBAAuB;CACnC,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread.d.ts

@@ -0,0 +1,47 @@
+import { Entity } from "../../../common";
+import type { User } from "../../user/entities/user";
+import type { HandbookThreadMessage } from "./handbook-thread-message";
+/**
+ * One persisted handbook conversation: a title and an ordered list of messages.
+ *
+ * This is deliberately NOT the package `Assistant`. `Assistant` is
+ * `isCompanyScoped: true`, and the handbook chat exists for platform
+ * administrators — who have a Membership with `HAS_ROLE` and no `IN_COMPANY`,
+ * i.e. no Company at all. A company-scoped thread would 404 for exactly the
+ * user the feature is for, and relaxing `Assistant`'s scoping to accommodate
+ * that would weaken tenancy for every application built on the package.
+ *
+ * `isCompanyScoped: false` therefore removes the company filter, and the
+ * `CREATED_BY` owner edge becomes the WHOLE security boundary:
+ * `HandbookThreadRepository.buildUserHasAccess()` requires it on every read and
+ * every write. `contextKey: "userId"` attaches that edge from CLS on create, so
+ * a client can never nominate a different owner, and `immutable: true` keeps a
+ * later PUT from re-pointing it.
+ */
+export type HandbookThread = Entity & {
+    title: string;
+    owner?: User;
+    messages?: HandbookThreadMessage[];
+};
+export declare const HandbookThreadDescriptor: import("../../../common").EntityDescriptor<HandbookThread, {
+    owner: {
+        model: import("../../../common").DataMeta;
+        direction: "out";
+        relationship: string;
+        cardinality: "one";
+        required: false;
+        dtoKey: string;
+        contextKey: string;
+        immutable: true;
+    };
+    messages: {
+        model: import("../../../common").DataMeta;
+        direction: "out";
+        relationship: string;
+        cardinality: "many";
+        required: false;
+        dtoKey: string;
+    };
+}>;
+export type HandbookThreadDescriptorType = typeof HandbookThreadDescriptor;
+//# sourceMappingURL=handbook-thread.d.ts.map

package/dist/foundations/handbook/entities/handbook-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAIvE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,QAAQ,CAAC,EAAE,qBAAqB,EAAE,CAAC;CACpC,CAAC;AAEF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;EA6BnC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,OAAO,wBAAwB,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookThreadDescriptor = void 0;
+const common_1 = require("../../../common");
+const user_meta_1 = require("../../user/entities/user.meta");
+const handbook_thread_message_meta_1 = require("./handbook-thread-message.meta");
+const handbook_thread_meta_1 = require("./handbook-thread.meta");
+exports.HandbookThreadDescriptor = (0, common_1.defineEntity)()({
+    ...handbook_thread_meta_1.handbookThreadMeta,
+    isCompanyScoped: false,
+    fields: {
+        title: { type: "string", required: true },
+    },
+    relationships: {
+        owner: {
+            model: user_meta_1.ownerMeta,
+            direction: "out",
+            relationship: "CREATED_BY",
+            cardinality: "one",
+            required: false,
+            dtoKey: "created-by",
+            contextKey: "userId",
+            immutable: true,
+        },
+        messages: {
+            model: handbook_thread_message_meta_1.handbookThreadMessageMeta,
+            direction: "out",
+            relationship: "HAS_MESSAGE",
+            cardinality: "many",
+            required: false,
+            dtoKey: "messages",
+        },
+    },
+});
+//# sourceMappingURL=handbook-thread.js.map

package/dist/foundations/handbook/entities/handbook-thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AAEvD,6DAA0D;AAE1D,iFAA2E;AAC3E,iEAA4D;AAyB/C,QAAA,wBAAwB,GAAG,IAAA,qBAAY,GAAkB,CAAC;IACrE,GAAG,yCAAkB;IAErB,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;KAC1C;IAED,aAAa,EAAE;QACb,KAAK,EAAE;YACL,KAAK,EAAE,qBAAS;YAChB,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,YAAY;YAC1B,WAAW,EAAE,KAAK;YAClB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,YAAY;YACpB,UAAU,EAAE,QAAQ;YACpB,SAAS,EAAE,IAAI;SAChB;QACD,QAAQ,EAAE;YACR,KAAK,EAAE,wDAAyB;YAChC,SAAS,EAAE,KAAK;YAChB,YAAY,EAAE,aAAa;YAC3B,WAAW,EAAE,MAAM;YACnB,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,UAAU;SACnB;KACF;CACF,CAAC,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread.meta.d.ts

@@ -0,0 +1,3 @@
+import { DataMeta } from "../../../common/interfaces/datamodel.interface";
+export declare const handbookThreadMeta: DataMeta;
+//# sourceMappingURL=handbook-thread.meta.d.ts.map

package/dist/foundations/handbook/entities/handbook-thread.meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread.meta.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread.meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gDAAgD,CAAC;AAE1E,eAAO,MAAM,kBAAkB,EAAE,QAKhC,CAAC"}

package/dist/foundations/handbook/entities/handbook-thread.meta.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handbookThreadMeta = void 0;
+exports.handbookThreadMeta = {
+    type: "handbookthreads",
+    endpoint: "handbookthreads",
+    nodeName: "handbookThread",
+    labelName: "HandbookThread",
+};
+//# sourceMappingURL=handbook-thread.meta.js.map

package/dist/foundations/handbook/entities/handbook-thread.meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread.meta.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/entities/handbook-thread.meta.ts"],"names":[],"mappings":";;;AAEa,QAAA,kBAAkB,GAAa;IAC1C,IAAI,EAAE,iBAAiB;IACvB,QAAQ,EAAE,iBAAiB;IAC3B,QAAQ,EAAE,gBAAgB;IAC1B,SAAS,EAAE,gBAAgB;CAC5B,CAAC"}

package/dist/foundations/handbook/handbook.module.d.ts

@@ -0,0 +1,21 @@
+import { DynamicModule, OnModuleInit } from "@nestjs/common";
+import { ModelService } from "../../core/llm/services/model.service";
+import { AppLoggingService } from "../../core/logging/services/logging.service";
+import { HandbookModuleConfig } from "./interfaces/handbook.config.interface";
+/**
+ * HandbookModule — administrator-only RAG over an application's own markdown
+ * documentation, with persisted conversations.
+ *
+ * The queue is registered HERE rather than left to the consumer: the finalise
+ * job ChunkService enqueues per chunk is routed by label, so a foundation that
+ * does not register its own queue only works in applications that happen to
+ * register it for us.
+ */
+export declare class HandbookModule implements OnModuleInit {
+    private readonly modelService;
+    private readonly logger;
+    static forRoot(config?: HandbookModuleConfig): DynamicModule;
+    constructor(modelService: ModelService, logger: AppLoggingService);
+    onModuleInit(): void;
+}
+//# sourceMappingURL=handbook.module.d.ts.map

package/dist/foundations/handbook/handbook.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/handbook/handbook.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAU,YAAY,EAAY,MAAM,gBAAgB,CAAC;AAK/E,OAAO,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AACrE,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAUhF,OAAO,EAA4C,oBAAoB,EAAE,MAAM,wCAAwC,CAAC;AAYxH;;;;;;;;GAQG;AACH,qBACa,cAAe,YAAW,YAAY;IAiE/C,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM;IAjEzB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,oBAAoB,GAAG,aAAa;gBAgEzC,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,iBAAiB;IAG5C,YAAY;CAab"}

package/dist/foundations/handbook/handbook.module.js

@@ -0,0 +1,135 @@
+"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);
+};
+var HandbookModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookModule = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
+const responder_module_1 = require("../../agents/responder/responder.module");
+const conditional_service_decorator_1 = require("../../common/decorators/conditional-service.decorator");
+const registry_1 = require("../../common/registries/registry");
+const queue_id_1 = require("../../config/enums/queue.id");
+const model_service_1 = require("../../core/llm/services/model.service");
+const logging_service_1 = require("../../core/logging/services/logging.service");
+const audit_module_1 = require("../audit/audit.module");
+const chunk_module_1 = require("../chunk/chunk.module");
+const chunker_module_1 = require("../chunker/chunker.module");
+const handbook_controller_1 = require("./controllers/handbook.controller");
+const handbook_thread_controller_1 = require("./controllers/handbook-thread.controller");
+const handbook_page_1 = require("./entities/handbook-page");
+const handbook_section_1 = require("./entities/handbook-section");
+const handbook_thread_1 = require("./entities/handbook-thread");
+const handbook_thread_message_1 = require("./entities/handbook-thread-message");
+const handbook_config_interface_1 = require("./interfaces/handbook.config.interface");
+const handbook_processor_1 = require("./processors/handbook.processor");
+const handbook_page_repository_1 = require("./repositories/handbook-page.repository");
+const handbook_section_repository_1 = require("./repositories/handbook-section.repository");
+const handbook_thread_repository_1 = require("./repositories/handbook-thread.repository");
+const handbook_thread_message_repository_1 = require("./repositories/handbook-thread-message.repository");
+const handbook_ingest_service_1 = require("./services/handbook-ingest.service");
+const handbook_page_service_1 = require("./services/handbook-page.service");
+const handbook_section_service_1 = require("./services/handbook-section.service");
+const handbook_thread_service_1 = require("./services/handbook-thread.service");
+const handbook_thread_message_service_1 = require("./services/handbook-thread-message.service");
+/**
+ * HandbookModule — administrator-only RAG over an application's own markdown
+ * documentation, with persisted conversations.
+ *
+ * The queue is registered HERE rather than left to the consumer: the finalise
+ * job ChunkService enqueues per chunk is routed by label, so a foundation that
+ * does not register its own queue only works in applications that happen to
+ * register it for us.
+ */
+let HandbookModule = HandbookModule_1 = class HandbookModule {
+    static forRoot(config) {
+        const mergedConfig = { ...handbook_config_interface_1.DEFAULT_HANDBOOK_CONFIG, ...config };
+        const providers = [
+            { provide: handbook_config_interface_1.HANDBOOK_CONFIG, useValue: mergedConfig },
+            handbook_page_1.HandbookPageDescriptor.model.serialiser,
+            handbook_section_1.HandbookSectionDescriptor.model.serialiser,
+            handbook_thread_1.HandbookThreadDescriptor.model.serialiser,
+            handbook_thread_message_1.HandbookThreadMessageDescriptor.model.serialiser,
+            handbook_page_repository_1.HandbookPageRepository,
+            handbook_section_repository_1.HandbookSectionRepository,
+            handbook_thread_repository_1.HandbookThreadRepository,
+            handbook_thread_message_repository_1.HandbookThreadMessageRepository,
+            handbook_page_service_1.HandbookPageService,
+            handbook_section_service_1.HandbookSectionService,
+            handbook_ingest_service_1.HandbookIngestService,
+            handbook_thread_message_service_1.HandbookThreadMessageService,
+            handbook_thread_service_1.HandbookThreadService,
+            (0, conditional_service_decorator_1.createWorkerProvider)(handbook_processor_1.HandbookProcessor),
+        ];
+        return {
+            module: HandbookModule_1,
+            controllers: [handbook_controller_1.HandbookController, handbook_thread_controller_1.HandbookThreadController],
+            providers,
+            exports: [
+                handbook_page_repository_1.HandbookPageRepository,
+                handbook_section_repository_1.HandbookSectionRepository,
+                handbook_page_service_1.HandbookPageService,
+                handbook_section_service_1.HandbookSectionService,
+                handbook_ingest_service_1.HandbookIngestService,
+                handbook_thread_service_1.HandbookThreadService,
+                handbook_thread_message_service_1.HandbookThreadMessageService,
+            ],
+            imports: [
+                bullmq_1.BullModule.registerQueue({
+                    name: queue_id_1.QueueId.HANDBOOK_PAGE,
+                    defaultJobOptions: {
+                        attempts: 3,
+                        backoff: { type: "exponential", delay: 10_000 },
+                        removeOnComplete: true,
+                        removeOnFail: { age: 3600, count: 1000 },
+                    },
+                }),
+                bullmq_1.BullModule.registerQueue({
+                    name: queue_id_1.QueueId.CHUNK,
+                    defaultJobOptions: {
+                        attempts: 3,
+                        backoff: { type: "exponential", delay: 10_000 },
+                    },
+                }),
+                audit_module_1.AuditModule,
+                chunk_module_1.ChunkModule,
+                chunker_module_1.ChunkerModule,
+                // The handbook thread drives ResponderService directly rather than
+                // going through the package Assistant: Assistant is company-scoped and
+                // a platform administrator has no Company. ResponderModule declares no
+                // controllers of its own, so importing it mounts no routes.
+                responder_module_1.ResponderModule,
+            ],
+        };
+    }
+    constructor(modelService, logger) {
+        this.modelService = modelService;
+        this.logger = logger;
+    }
+    onModuleInit() {
+        registry_1.modelRegistry.register(handbook_page_1.HandbookPageDescriptor.model);
+        registry_1.modelRegistry.register(handbook_section_1.HandbookSectionDescriptor.model);
+        registry_1.modelRegistry.register(handbook_thread_1.HandbookThreadDescriptor.model);
+        registry_1.modelRegistry.register(handbook_thread_message_1.HandbookThreadMessageDescriptor.model);
+        // Say it once at boot rather than only when someone presses Sync: an
+        // installation with no AI configuration can browse pages it ingested
+        // earlier, but can never ingest again, and that is worth knowing before
+        // the button is pressed.
+        if (!this.modelService.isAiConfigured())
+            this.logger.warn("Handbook ingest is unavailable: no usable AI configuration.");
+    }
+};
+exports.HandbookModule = HandbookModule;
+exports.HandbookModule = HandbookModule = HandbookModule_1 = __decorate([
+    (0, common_1.Module)({}),
+    __metadata("design:paramtypes", [model_service_1.ModelService,
+        logging_service_1.AppLoggingService])
+], HandbookModule);
+//# sourceMappingURL=handbook.module.js.map