@carlonicora/nestjs-neo4jsonapi 4.4.0 → 4.5.0

package/dist/foundations/handbook/controllers/handbook-thread.controller.js

@@ -0,0 +1,170 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookThreadController = void 0;
+const common_1 = require("@nestjs/common");
+const cache_invalidate_decorator_1 = require("../../../common/decorators/cache-invalidate.decorator");
+const jwt_auth_admin_guard_1 = require("../../../common/guards/jwt.auth.admin.guard");
+const crud_handlers_1 = require("../../../common/handlers/crud.handlers");
+const cache_service_1 = require("../../../core/cache/services/cache.service");
+const handbook_thread_message_post_dto_1 = require("../dtos/handbook-thread-message-post.dto");
+const handbook_thread_patch_dto_1 = require("../dtos/handbook-thread-patch.dto");
+const handbook_thread_post_dto_1 = require("../dtos/handbook-thread-post.dto");
+const handbook_thread_meta_1 = require("../entities/handbook-thread.meta");
+const handbook_thread_message_meta_1 = require("../entities/handbook-thread-message.meta");
+const handbook_thread_service_1 = require("../services/handbook-thread.service");
+/**
+ * Persisted handbook conversations.
+ *
+ * Developer documentation is administrator-only, enforced HERE and not merely
+ * by whatever admin layout a consumer's frontend happens to have.
+ * `AdminJwtAuthGuard` pushes the Administrator role into the required-roles set
+ * for every handler (common/guards/jwt.auth.admin.guard.ts — `_validateRoles`),
+ * so the read routes are gated too. No handler declares a guard of its own: a
+ * handler-level `@UseGuards` is the usual way a route quietly loses the admin
+ * check.
+ *
+ * Every mutation invalidates the whole `handbookthreads` type rather than one
+ * element: a new message reorders the list (the thread list is sorted by
+ * `updatedAt DESC`), so invalidating the single thread would leave a stale list
+ * cached.
+ */
+let HandbookThreadController = class HandbookThreadController {
+    constructor(handbookThreadService, cacheService) {
+        this.handbookThreadService = handbookThreadService;
+        this.cacheService = cacheService;
+        this.crud = (0, crud_handlers_1.createCrudHandlers)(() => this.handbookThreadService);
+    }
+    /**
+     * GET /handbookthreads — the current user's threads, most recently updated
+     * first. Owner scoping is enforced by the repository's `buildUserHasAccess`
+     * override, and the ordering is the descriptor default (`updatedAt DESC`).
+     */
+    async findAll(reply, query, search, fetchAll, orderBy) {
+        return this.crud.findAll(reply, { query, search, fetchAll, orderBy });
+    }
+    /**
+     * POST /handbookthreads — start a thread from its first question. The
+     * response is the thread with both messages of the opening turn included,
+     * so the client renders the new conversation without a second call.
+     */
+    async create(reply, body) {
+        const { question, handbookPageId } = body.data.attributes;
+        const response = await this.handbookThreadService.createWithFirstMessage({
+            question,
+            handbookPageId,
+        });
+        reply.send(response);
+    }
+    /**
+     * GET /handbookthreads/:handbookThreadId — one thread with every message it
+     * holds, in position order.
+     */
+    async findById(reply, handbookThreadId) {
+        const response = await this.handbookThreadService.findThreadWithMessages({ threadId: handbookThreadId });
+        reply.send(response);
+    }
+    /**
+     * PATCH /handbookthreads/:handbookThreadId — rename.
+     */
+    async patch(reply, body) {
+        return this.crud.patch(reply, body);
+    }
+    /**
+     * DELETE /handbookthreads/:handbookThreadId — remove the thread and its
+     * messages.
+     */
+    async delete(reply, handbookThreadId) {
+        return this.crud.delete(reply, handbookThreadId);
+    }
+    /**
+     * POST /handbookthreads/:handbookThreadId/handbookthreadmessages — ask a
+     * follow-up. Answers with the two new messages as a JSON:API list, the shape
+     * `AssistantController.append` returns.
+     */
+    async appendMessage(reply, handbookThreadId, body) {
+        const { question, handbookPageId } = body.data.attributes;
+        const response = await this.handbookThreadService.appendMessage({
+            threadId: handbookThreadId,
+            question,
+            handbookPageId,
+        });
+        reply.send(response);
+    }
+};
+exports.HandbookThreadController = HandbookThreadController;
+__decorate([
+    (0, common_1.Get)(handbook_thread_meta_1.handbookThreadMeta.endpoint),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)()),
+    __param(2, (0, common_1.Query)("search")),
+    __param(3, (0, common_1.Query)("fetchAll")),
+    __param(4, (0, common_1.Query)("orderBy")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, Boolean, String]),
+    __metadata("design:returntype", Promise)
+], HandbookThreadController.prototype, "findAll", null);
+__decorate([
+    (0, common_1.Post)(handbook_thread_meta_1.handbookThreadMeta.endpoint),
+    (0, cache_invalidate_decorator_1.CacheInvalidate)(handbook_thread_meta_1.handbookThreadMeta),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, handbook_thread_post_dto_1.HandbookThreadPostDTO]),
+    __metadata("design:returntype", Promise)
+], HandbookThreadController.prototype, "create", null);
+__decorate([
+    (0, common_1.Get)(`${handbook_thread_meta_1.handbookThreadMeta.endpoint}/:handbookThreadId`),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Param)("handbookThreadId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], HandbookThreadController.prototype, "findById", null);
+__decorate([
+    (0, common_1.Patch)(`${handbook_thread_meta_1.handbookThreadMeta.endpoint}/:handbookThreadId`),
+    (0, cache_invalidate_decorator_1.CacheInvalidate)(handbook_thread_meta_1.handbookThreadMeta),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, handbook_thread_patch_dto_1.HandbookThreadPatchDTO]),
+    __metadata("design:returntype", Promise)
+], HandbookThreadController.prototype, "patch", null);
+__decorate([
+    (0, common_1.Delete)(`${handbook_thread_meta_1.handbookThreadMeta.endpoint}/:handbookThreadId`),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    (0, cache_invalidate_decorator_1.CacheInvalidate)(handbook_thread_meta_1.handbookThreadMeta),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Param)("handbookThreadId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], HandbookThreadController.prototype, "delete", null);
+__decorate([
+    (0, common_1.Post)(`${handbook_thread_meta_1.handbookThreadMeta.endpoint}/:handbookThreadId/${handbook_thread_message_meta_1.handbookThreadMessageMeta.endpoint}`),
+    (0, cache_invalidate_decorator_1.CacheInvalidate)(handbook_thread_meta_1.handbookThreadMeta),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Param)("handbookThreadId")),
+    __param(2, (0, common_1.Body)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String, handbook_thread_message_post_dto_1.HandbookThreadMessagePostDTO]),
+    __metadata("design:returntype", Promise)
+], HandbookThreadController.prototype, "appendMessage", null);
+exports.HandbookThreadController = HandbookThreadController = __decorate([
+    (0, common_1.UseGuards)(jwt_auth_admin_guard_1.AdminJwtAuthGuard),
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [handbook_thread_service_1.HandbookThreadService,
+        cache_service_1.CacheService])
+], HandbookThreadController);
+//# sourceMappingURL=handbook-thread.controller.js.map

package/dist/foundations/handbook/controllers/handbook-thread.controller.js.map

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

package/dist/foundations/handbook/controllers/handbook.controller.d.ts

@@ -0,0 +1,29 @@
+import { FastifyReply } from "fastify";
+import { CacheService } from "../../../core/cache/services/cache.service";
+import { AuditService } from "../../audit/services/audit.service";
+import { HandbookIngestService } from "../services/handbook-ingest.service";
+import { HandbookPageService } from "../services/handbook-page.service";
+import { HandbookSectionService } from "../services/handbook-section.service";
+/**
+ * Developer documentation is administrator-only, enforced HERE and not merely by
+ * whatever admin layout a consumer's frontend happens to have. AdminJwtAuthGuard
+ * pushes the Administrator role into the required-roles set for every handler
+ * (common/guards/jwt.auth.admin.guard.ts — `_validateRoles`), so read routes are
+ * gated too.
+ */
+export declare class HandbookController {
+    private readonly handbookPageService;
+    private readonly handbookSectionService;
+    private readonly handbookIngestService;
+    private readonly cacheService;
+    private readonly auditService;
+    private readonly crud;
+    private readonly sections;
+    constructor(handbookPageService: HandbookPageService, handbookSectionService: HandbookSectionService, handbookIngestService: HandbookIngestService, cacheService: CacheService, auditService: AuditService);
+    findAll(reply: FastifyReply, query: any, search?: string, fetchAll?: boolean, orderBy?: string): Promise<void>;
+    findAllSections(reply: FastifyReply, query: any, search?: string, fetchAll?: boolean, orderBy?: string): Promise<void>;
+    sync(reply: FastifyReply): Promise<void>;
+    findById(reply: FastifyReply, handbookPageId: string): Promise<void>;
+    delete(reply: FastifyReply, handbookPageId: string): Promise<void>;
+}
+//# sourceMappingURL=handbook.controller.d.ts.map

package/dist/foundations/handbook/controllers/handbook.controller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/controllers/handbook.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAKvC,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAGlE,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAE9E;;;;;;GAMG;AACH,qBAEa,kBAAkB;IAK3B,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IACvC,OAAO,CAAC,QAAQ,CAAC,qBAAqB;IACtC,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAR/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAsD;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAyD;gBAG/D,mBAAmB,EAAE,mBAAmB,EACxC,sBAAsB,EAAE,sBAAsB,EAC9C,qBAAqB,EAAE,qBAAqB,EAC5C,YAAY,EAAE,YAAY,EAC1B,YAAY,EAAE,YAAY;IAIvC,OAAO,CACJ,KAAK,EAAE,YAAY,EACjB,KAAK,EAAE,GAAG,EACF,MAAM,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,MAAM;IAM9B,eAAe,CACZ,KAAK,EAAE,YAAY,EACjB,KAAK,EAAE,GAAG,EACF,MAAM,CAAC,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,EACnB,OAAO,CAAC,EAAE,MAAM;IAS9B,IAAI,CAAQ,KAAK,EAAE,YAAY;IAO/B,QAAQ,CAAQ,KAAK,EAAE,YAAY,EAA2B,cAAc,EAAE,MAAM;IAOpF,MAAM,CAAQ,KAAK,EAAE,YAAY,EAA2B,cAAc,EAAE,MAAM;CAGzF"}

package/dist/foundations/handbook/controllers/handbook.controller.js

@@ -0,0 +1,123 @@
+"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 __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookController = void 0;
+const common_1 = require("@nestjs/common");
+const audit_decorator_1 = require("../../../common/decorators/audit.decorator");
+const cache_invalidate_decorator_1 = require("../../../common/decorators/cache-invalidate.decorator");
+const jwt_auth_admin_guard_1 = require("../../../common/guards/jwt.auth.admin.guard");
+const crud_handlers_1 = require("../../../common/handlers/crud.handlers");
+const cache_service_1 = require("../../../core/cache/services/cache.service");
+const audit_service_1 = require("../../audit/services/audit.service");
+const handbook_page_meta_1 = require("../entities/handbook-page.meta");
+const handbook_section_meta_1 = require("../entities/handbook-section.meta");
+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");
+/**
+ * Developer documentation is administrator-only, enforced HERE and not merely by
+ * whatever admin layout a consumer's frontend happens to have. AdminJwtAuthGuard
+ * pushes the Administrator role into the required-roles set for every handler
+ * (common/guards/jwt.auth.admin.guard.ts — `_validateRoles`), so read routes are
+ * gated too.
+ */
+let HandbookController = class HandbookController {
+    constructor(handbookPageService, handbookSectionService, handbookIngestService, cacheService, auditService) {
+        this.handbookPageService = handbookPageService;
+        this.handbookSectionService = handbookSectionService;
+        this.handbookIngestService = handbookIngestService;
+        this.cacheService = cacheService;
+        this.auditService = auditService;
+        this.crud = (0, crud_handlers_1.createCrudHandlers)(() => this.handbookPageService);
+        this.sections = (0, crud_handlers_1.createCrudHandlers)(() => this.handbookSectionService);
+    }
+    async findAll(reply, query, search, fetchAll, orderBy) {
+        return this.crud.findAll(reply, { query, search, fetchAll, orderBy });
+    }
+    async findAllSections(reply, query, search, fetchAll, orderBy) {
+        return this.sections.findAll(reply, { query, search, fetchAll, orderBy });
+    }
+    // Declared BEFORE the :handbookPageId route so "sync" is never read as an id.
+    async sync(reply) {
+        await this.handbookIngestService.sync();
+        reply.send();
+    }
+    async findById(reply, handbookPageId) {
+        return this.crud.findById(reply, handbookPageId);
+    }
+    async delete(reply, handbookPageId) {
+        return this.crud.delete(reply, handbookPageId);
+    }
+};
+exports.HandbookController = HandbookController;
+__decorate([
+    (0, common_1.Get)(handbook_page_meta_1.handbookPageMeta.endpoint),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)()),
+    __param(2, (0, common_1.Query)("search")),
+    __param(3, (0, common_1.Query)("fetchAll")),
+    __param(4, (0, common_1.Query)("orderBy")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, Boolean, String]),
+    __metadata("design:returntype", Promise)
+], HandbookController.prototype, "findAll", null);
+__decorate([
+    (0, common_1.Get)(handbook_section_meta_1.handbookSectionMeta.endpoint),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Query)()),
+    __param(2, (0, common_1.Query)("search")),
+    __param(3, (0, common_1.Query)("fetchAll")),
+    __param(4, (0, common_1.Query)("orderBy")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object, String, Boolean, String]),
+    __metadata("design:returntype", Promise)
+], HandbookController.prototype, "findAllSections", null);
+__decorate([
+    (0, common_1.Post)(`${handbook_page_meta_1.handbookPageMeta.endpoint}/sync`),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    (0, cache_invalidate_decorator_1.CacheInvalidate)(handbook_page_meta_1.handbookPageMeta),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HandbookController.prototype, "sync", null);
+__decorate([
+    (0, common_1.Get)(`${handbook_page_meta_1.handbookPageMeta.endpoint}/:handbookPageId`),
+    (0, audit_decorator_1.Audit)(handbook_page_meta_1.handbookPageMeta, "handbookPageId"),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Param)("handbookPageId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], HandbookController.prototype, "findById", null);
+__decorate([
+    (0, common_1.Delete)(`${handbook_page_meta_1.handbookPageMeta.endpoint}/:handbookPageId`),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    (0, cache_invalidate_decorator_1.CacheInvalidate)(handbook_page_meta_1.handbookPageMeta, "handbookPageId"),
+    __param(0, (0, common_1.Res)()),
+    __param(1, (0, common_1.Param)("handbookPageId")),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, String]),
+    __metadata("design:returntype", Promise)
+], HandbookController.prototype, "delete", null);
+exports.HandbookController = HandbookController = __decorate([
+    (0, common_1.UseGuards)(jwt_auth_admin_guard_1.AdminJwtAuthGuard),
+    (0, common_1.Controller)(),
+    __metadata("design:paramtypes", [handbook_page_service_1.HandbookPageService,
+        handbook_section_service_1.HandbookSectionService,
+        handbook_ingest_service_1.HandbookIngestService,
+        cache_service_1.CacheService,
+        audit_service_1.AuditService])
+], HandbookController);
+//# sourceMappingURL=handbook.controller.js.map

package/dist/foundations/handbook/controllers/handbook.controller.js.map

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

package/dist/foundations/handbook/dtos/handbook-page.dto.d.ts

@@ -0,0 +1,11 @@
+export declare class HandbookPageDTO {
+    type: string;
+    id: string;
+}
+export declare class HandbookPageDataDTO {
+    data: HandbookPageDTO;
+}
+export declare class HandbookPageDataListDTO {
+    data: HandbookPageDTO[];
+}
+//# sourceMappingURL=handbook-page.dto.d.ts.map

package/dist/foundations/handbook/dtos/handbook-page.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-page.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-page.dto.ts"],"names":[],"mappings":"AAIA,qBAAa,eAAe;IAE1B,IAAI,EAAE,MAAM,CAAC;IAGb,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,qBAAa,mBAAmB;IAI9B,IAAI,EAAE,eAAe,CAAC;CACvB;AAED,qBAAa,uBAAuB;IAIlC,IAAI,EAAE,eAAe,EAAE,CAAC;CACzB"}

package/dist/foundations/handbook/dtos/handbook-page.dto.js

@@ -0,0 +1,45 @@
+"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.HandbookPageDataListDTO = exports.HandbookPageDataDTO = exports.HandbookPageDTO = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const handbook_page_meta_1 = require("../entities/handbook-page.meta");
+class HandbookPageDTO {
+}
+exports.HandbookPageDTO = HandbookPageDTO;
+__decorate([
+    (0, class_validator_1.Equals)(handbook_page_meta_1.handbookPageMeta.endpoint),
+    __metadata("design:type", String)
+], HandbookPageDTO.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], HandbookPageDTO.prototype, "id", void 0);
+class HandbookPageDataDTO {
+}
+exports.HandbookPageDataDTO = HandbookPageDataDTO;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookPageDTO),
+    __metadata("design:type", HandbookPageDTO)
+], HandbookPageDataDTO.prototype, "data", void 0);
+class HandbookPageDataListDTO {
+}
+exports.HandbookPageDataListDTO = HandbookPageDataListDTO;
+__decorate([
+    (0, class_validator_1.ValidateNested)({ each: true }),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookPageDTO),
+    __metadata("design:type", Array)
+], HandbookPageDataListDTO.prototype, "data", void 0);
+//# sourceMappingURL=handbook-page.dto.js.map

package/dist/foundations/handbook/dtos/handbook-page.dto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-page.dto.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-page.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAA6E;AAC7E,uEAAkE;AAElE,MAAa,eAAe;CAM3B;AAND,0CAMC;AAJC;IADC,IAAA,wBAAM,EAAC,qCAAgB,CAAC,QAAQ,CAAC;;6CACrB;AAGb;IADC,IAAA,wBAAM,GAAE;;2CACE;AAGb,MAAa,mBAAmB;CAK/B;AALD,kDAKC;AADC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,eAAe,CAAC;8BACtB,eAAe;iDAAC;AAGxB,MAAa,uBAAuB;CAKnC;AALD,0DAKC;AADC;IAHC,IAAA,gCAAc,EAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAC9B,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,eAAe,CAAC;;qDACJ"}

package/dist/foundations/handbook/dtos/handbook-thread-message-post.dto.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Body of `POST /handbookthreads/:handbookThreadId/handbookthreadmessages`.
+ *
+ * The thread is named by the URL, so the payload carries only the question.
+ * `type` is checked against the MESSAGE meta — the resource being appended —
+ * not the thread's.
+ */
+export declare class HandbookThreadMessagePostAttributesDTO {
+    question: string;
+    /**
+     * Scopes the turn to a single handbook page. Optional and off by default: a
+     * question asked while reading one page usually needs the whole manual, and
+     * defaulting to restriction would silently hide the rest of it.
+     */
+    handbookPageId?: string;
+}
+export declare class HandbookThreadMessagePostDataDTO {
+    type: string;
+    attributes: HandbookThreadMessagePostAttributesDTO;
+}
+export declare class HandbookThreadMessagePostDTO {
+    data: HandbookThreadMessagePostDataDTO;
+}
+//# sourceMappingURL=handbook-thread-message-post.dto.d.ts.map

package/dist/foundations/handbook/dtos/handbook-thread-message-post.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message-post.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-thread-message-post.dto.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,qBAAa,sCAAsC;IAKjD,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IAGH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,gCAAgC;IAE3C,IAAI,EAAE,MAAM,CAAC;IAKb,UAAU,EAAE,sCAAsC,CAAC;CACpD;AAED,qBAAa,4BAA4B;IAIvC,IAAI,EAAE,gCAAgC,CAAC;CACxC"}

package/dist/foundations/handbook/dtos/handbook-thread-message-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.HandbookThreadMessagePostDTO = exports.HandbookThreadMessagePostDataDTO = exports.HandbookThreadMessagePostAttributesDTO = void 0;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const handbook_thread_message_meta_1 = require("../entities/handbook-thread-message.meta");
+/**
+ * Body of `POST /handbookthreads/:handbookThreadId/handbookthreadmessages`.
+ *
+ * The thread is named by the URL, so the payload carries only the question.
+ * `type` is checked against the MESSAGE meta — the resource being appended —
+ * not the thread's.
+ */
+class HandbookThreadMessagePostAttributesDTO {
+}
+exports.HandbookThreadMessagePostAttributesDTO = HandbookThreadMessagePostAttributesDTO;
+__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)
+], HandbookThreadMessagePostAttributesDTO.prototype, "question", void 0);
+__decorate([
+    (0, class_validator_1.IsOptional)(),
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], HandbookThreadMessagePostAttributesDTO.prototype, "handbookPageId", void 0);
+class HandbookThreadMessagePostDataDTO {
+}
+exports.HandbookThreadMessagePostDataDTO = HandbookThreadMessagePostDataDTO;
+__decorate([
+    (0, class_validator_1.Equals)(handbook_thread_message_meta_1.handbookThreadMessageMeta.endpoint),
+    __metadata("design:type", String)
+], HandbookThreadMessagePostDataDTO.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookThreadMessagePostAttributesDTO),
+    __metadata("design:type", HandbookThreadMessagePostAttributesDTO)
+], HandbookThreadMessagePostDataDTO.prototype, "attributes", void 0);
+class HandbookThreadMessagePostDTO {
+}
+exports.HandbookThreadMessagePostDTO = HandbookThreadMessagePostDTO;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookThreadMessagePostDataDTO),
+    __metadata("design:type", HandbookThreadMessagePostDataDTO)
+], HandbookThreadMessagePostDTO.prototype, "data", void 0);
+//# sourceMappingURL=handbook-thread-message-post.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-message-post.dto.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-thread-message-post.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDASyB;AACzB,2FAAqF;AAErF;;;;;;GAMG;AACH,MAAa,sCAAsC;CAelD;AAfD,wFAeC;AAVC;IAJC,IAAA,2BAAS,GAAE;IACX,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,MAAM,CAAC;;wEACD;AASjB;IAFC,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAM,GAAE;;8EACe;AAG1B,MAAa,gCAAgC;CAQ5C;AARD,4EAQC;AANC;IADC,IAAA,wBAAM,EAAC,wDAAyB,CAAC,QAAQ,CAAC;;8DAC9B;AAKb;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC;8BACvC,sCAAsC;oEAAC;AAGrD,MAAa,4BAA4B;CAKxC;AALD,oEAKC;AADC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,gCAAgC,CAAC;8BACvC,gCAAgC;0DAAC"}

package/dist/foundations/handbook/dtos/handbook-thread-patch.dto.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Body of `PATCH /handbookthreads/:handbookThreadId` — the rename.
+ *
+ * `title` is the only mutable attribute a client may send. The thread's
+ * messages and its owner edge are server-managed; `owner` is declared
+ * `immutable` on the descriptor so it cannot be re-pointed here either.
+ */
+export declare class HandbookThreadPatchAttributesDTO {
+    title: string;
+}
+export declare class HandbookThreadPatchDataDTO {
+    type: string;
+    id: string;
+    attributes: HandbookThreadPatchAttributesDTO;
+}
+export declare class HandbookThreadPatchDTO {
+    data: HandbookThreadPatchDataDTO;
+}
+//# sourceMappingURL=handbook-thread-patch.dto.d.ts.map

package/dist/foundations/handbook/dtos/handbook-thread-patch.dto.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-patch.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-thread-patch.dto.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,qBAAa,gCAAgC;IAK3C,KAAK,EAAE,MAAM,CAAC;CACf;AAED,qBAAa,0BAA0B;IAErC,IAAI,EAAE,MAAM,CAAC;IAGb,EAAE,EAAE,MAAM,CAAC;IAKX,UAAU,EAAE,gCAAgC,CAAC;CAC9C;AAED,qBAAa,sBAAsB;IAIjC,IAAI,EAAE,0BAA0B,CAAC;CAClC"}

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

@@ -0,0 +1,59 @@
+"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.HandbookThreadPatchDTO = exports.HandbookThreadPatchDataDTO = exports.HandbookThreadPatchAttributesDTO = 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 `PATCH /handbookthreads/:handbookThreadId` — the rename.
+ *
+ * `title` is the only mutable attribute a client may send. The thread's
+ * messages and its owner edge are server-managed; `owner` is declared
+ * `immutable` on the descriptor so it cannot be re-pointed here either.
+ */
+class HandbookThreadPatchAttributesDTO {
+}
+exports.HandbookThreadPatchAttributesDTO = HandbookThreadPatchAttributesDTO;
+__decorate([
+    (0, class_validator_1.IsDefined)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.MaxLength)(200),
+    __metadata("design:type", String)
+], HandbookThreadPatchAttributesDTO.prototype, "title", void 0);
+class HandbookThreadPatchDataDTO {
+}
+exports.HandbookThreadPatchDataDTO = HandbookThreadPatchDataDTO;
+__decorate([
+    (0, class_validator_1.Equals)(handbook_thread_meta_1.handbookThreadMeta.endpoint),
+    __metadata("design:type", String)
+], HandbookThreadPatchDataDTO.prototype, "type", void 0);
+__decorate([
+    (0, class_validator_1.IsUUID)(),
+    __metadata("design:type", String)
+], HandbookThreadPatchDataDTO.prototype, "id", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookThreadPatchAttributesDTO),
+    __metadata("design:type", HandbookThreadPatchAttributesDTO)
+], HandbookThreadPatchDataDTO.prototype, "attributes", void 0);
+class HandbookThreadPatchDTO {
+}
+exports.HandbookThreadPatchDTO = HandbookThreadPatchDTO;
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_validator_1.IsNotEmpty)(),
+    (0, class_transformer_1.Type)(() => HandbookThreadPatchDataDTO),
+    __metadata("design:type", HandbookThreadPatchDataDTO)
+], HandbookThreadPatchDTO.prototype, "data", void 0);
+//# sourceMappingURL=handbook-thread-patch.dto.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-patch.dto.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-thread-patch.dto.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAA6G;AAC7G,2EAAsE;AAEtE;;;;;;GAMG;AACH,MAAa,gCAAgC;CAM5C;AAND,4EAMC;AADC;IAJC,IAAA,2BAAS,GAAE;IACX,IAAA,4BAAU,GAAE;IACZ,IAAA,0BAAQ,GAAE;IACV,IAAA,2BAAS,EAAC,GAAG,CAAC;;+DACD;AAGhB,MAAa,0BAA0B;CAWtC;AAXD,gEAWC;AATC;IADC,IAAA,wBAAM,EAAC,yCAAkB,CAAC,QAAQ,CAAC;;wDACvB;AAGb;IADC,IAAA,wBAAM,GAAE;;sDACE;AAKX;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,gCAAgC,CAAC;8BACjC,gCAAgC;8DAAC;AAG/C,MAAa,sBAAsB;CAKlC;AALD,wDAKC;AADC;IAHC,IAAA,gCAAc,GAAE;IAChB,IAAA,4BAAU,GAAE;IACZ,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC;8BACjC,0BAA0B;oDAAC"}

package/dist/foundations/handbook/dtos/handbook-thread-post.dto.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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.
+ */
+export declare class HandbookThreadPostAttributesDTO {
+    question: string;
+    /**
+     * Scopes the turn to a single handbook page. Optional and off by default: a
+     * question asked while reading one page usually needs the whole manual, and
+     * defaulting to restriction would silently hide the rest of it.
+     */
+    handbookPageId?: string;
+}
+export declare class HandbookThreadPostDataDTO {
+    type: string;
+    attributes: HandbookThreadPostAttributesDTO;
+}
+export declare class HandbookThreadPostDTO {
+    data: HandbookThreadPostDataDTO;
+}
+//# sourceMappingURL=handbook-thread-post.dto.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handbook-thread-post.dto.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/dtos/handbook-thread-post.dto.ts"],"names":[],"mappings":"AAaA;;;;;;GAMG;AACH,qBAAa,+BAA+B;IAK1C,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IAGH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBAAa,yBAAyB;IAEpC,IAAI,EAAE,MAAM,CAAC;IAKb,UAAU,EAAE,+BAA+B,CAAC;CAC7C;AAED,qBAAa,qBAAqB;IAIhC,IAAI,EAAE,yBAAyB,CAAC;CACjC"}