@carlonicora/nestjs-neo4jsonapi 4.3.2 → 4.5.0

package/dist/foundations/handbook/services/handbook-thread.service.js

@@ -0,0 +1,297 @@
+"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 HandbookThreadService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HandbookThreadService = exports.HANDBOOK_TITLE_MAX_LENGTH = exports.HANDBOOK_MAX_MESSAGES_TO_LLM = void 0;
+const common_1 = require("@nestjs/common");
+const crypto_1 = require("crypto");
+const nestjs_cls_1 = require("nestjs-cls");
+const responder_service_1 = require("../../../agents/responder/services/responder.service");
+const agentmessage_type_1 = require("../../../common/enums/agentmessage.type");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const handbook_thread_1 = require("../entities/handbook-thread");
+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");
+const handbook_page_repository_1 = require("../repositories/handbook-page.repository");
+const handbook_thread_message_repository_1 = require("../repositories/handbook-thread-message.repository");
+const handbook_thread_repository_1 = require("../repositories/handbook-thread.repository");
+const handbook_thread_message_service_1 = require("./handbook-thread-message.service");
+/** How many prior turns are replayed to the responder as history. */
+exports.HANDBOOK_MAX_MESSAGES_TO_LLM = 20;
+/** Longest auto-generated title, when the responder supplies none. */
+exports.HANDBOOK_TITLE_MAX_LENGTH = 60;
+/**
+ * Persisted handbook conversations.
+ *
+ * The handbook chat deliberately does NOT go through the package `Assistant`.
+ * `Assistant` is `isCompanyScoped: true`, and a platform administrator — the
+ * only user this feature is for — has no Company, so a company-scoped thread
+ * would 404 for exactly that user. Company scoping stays strict; the thread
+ * lives here instead, global and owner-scoped.
+ *
+ * That is why `companyId` is read off CLS and passed through EXACTLY as found,
+ * `undefined` included. It is not defaulted, substituted or looked up.
+ * `ResponderService.run` types it `string | undefined`; token accounting
+ * already tolerates a company-less turn (TokenUsageRepository makes the
+ * `BELONGS_TO` edge conditional); and handbook retrieval never consults a
+ * company — the handbook branch of the source-query provider matches
+ * `(:HandbookPage)` and ignores tenancy altogether.
+ */
+let HandbookThreadService = HandbookThreadService_1 = class HandbookThreadService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, threads, clsService, responder, messages, messageRepository, pages) {
+        super(jsonApiService, threads, clsService, handbook_thread_1.HandbookThreadDescriptor.model);
+        this.threads = threads;
+        this.responder = responder;
+        this.messages = messages;
+        this.messageRepository = messageRepository;
+        this.pages = pages;
+        this.descriptor = handbook_thread_1.HandbookThreadDescriptor;
+        this.threadLogger = new common_1.Logger(HandbookThreadService_1.name);
+    }
+    /**
+     * Start a thread from its first question: create the thread, run the turn,
+     * persist both messages, and title the thread from the answer.
+     *
+     * The thread node is created FIRST — before the responder runs — so the two
+     * messages have a parent to hang from, exactly as
+     * `AssistantService.createWithFirstMessage` does. It is created with the
+     * fallback title and retitled once the answer exists, because the responder's
+     * title is only known after the turn.
+     */
+    async createWithFirstMessage(params) {
+        const threadId = (0, crypto_1.randomUUID)();
+        await this.createFromDTO({
+            data: {
+                type: handbook_thread_meta_1.handbookThreadMeta.type,
+                id: threadId,
+                attributes: { title: this.fallbackTitle(params.question) },
+            },
+        });
+        await this.writeMessage({ threadId, role: "user", content: params.question, position: 0, sources: [] });
+        const turn = await this.runTurn({
+            question: params.question,
+            history: [],
+            handbookPageId: params.handbookPageId,
+        });
+        await this.writeMessage({
+            threadId,
+            role: "assistant",
+            content: turn.answer,
+            position: 1,
+            sources: turn.sources,
+        });
+        // `patch` here is the OVERRIDE below, so the owner gate is applied to the
+        // retitle as well — the thread was created by this user a moment ago, so it
+        // always passes, but the rule stays in one place.
+        if (turn.title)
+            await this.patch({ id: threadId, title: turn.title });
+        this.threadLogger.log(`createWithFirstMessage: threadId=${threadId} questionLength=${params.question.length} sources=${turn.sources.length}`);
+        return this.findThreadWithMessages({ threadId });
+    }
+    /**
+     * Append a question to an existing thread and answer it with the thread's
+     * prior messages as history.
+     *
+     * Returns the two NEW messages as a JSON:API list — the shape
+     * `AssistantController.append` returns — so the client appends rather than
+     * re-renders. The full thread is one `GET /handbookthreads/:id` away.
+     */
+    async appendMessage(params) {
+        // Owner gate: `findById` applies `buildUserHasAccess`, so another user's
+        // thread is a 403 and an unknown id is a 404 — before anything is written.
+        await this.readOwnedThread({ threadId: params.threadId });
+        const priorMessages = await this.loadMessages({ threadId: params.threadId });
+        const position = await this.messageRepository.getNextPosition({ threadId: params.threadId });
+        const userMessageId = await this.writeMessage({
+            threadId: params.threadId,
+            role: "user",
+            content: params.question,
+            position,
+            sources: [],
+        });
+        const turn = await this.runTurn({
+            question: params.question,
+            history: priorMessages.slice(-exports.HANDBOOK_MAX_MESSAGES_TO_LLM).map((message) => ({
+                type: message.role === "assistant" ? agentmessage_type_1.AgentMessageType.Assistant : agentmessage_type_1.AgentMessageType.User,
+                content: message.content,
+            })),
+            handbookPageId: params.handbookPageId,
+        });
+        const assistantMessageId = await this.writeMessage({
+            threadId: params.threadId,
+            role: "assistant",
+            content: turn.answer,
+            position: position + 1,
+            sources: turn.sources,
+        });
+        await this.threads.touch({ id: params.threadId });
+        this.threadLogger.log(`appendMessage: threadId=${params.threadId} positions=${position}-${position + 1} history=${priorMessages.length}`);
+        const written = await this.messageRepository.findByIds({ ids: [userMessageId, assistantMessageId] });
+        return this.jsonApiService.buildList(handbook_thread_message_1.HandbookThreadMessageDescriptor.model, this.byPosition(written));
+    }
+    /**
+     * One thread with every message it holds, in position order.
+     *
+     * The messages ride in `included` through the descriptor's `messages`
+     * relationship — the same traversal that lets `AssistantController` return an
+     * assistant with its messages — so a client renders a selected thread in one
+     * call. They are sorted here because a Cypher `OPTIONAL MATCH` collects
+     * related nodes in no particular order.
+     */
+    async findThreadWithMessages(params) {
+        const thread = await this.readOwnedThread({ threadId: params.threadId });
+        thread.messages = this.byPosition(thread.messages ?? []);
+        return this.jsonApiService.buildSingle(handbook_thread_1.HandbookThreadDescriptor.model, thread);
+    }
+    /**
+     * Rename. Overridden ONLY to close an ordering hole in the inherited
+     * implementation: `AbstractService.patch` writes first and reads back
+     * afterwards, and `AbstractRepository.patch` matches on `id` alone — it never
+     * applies `buildUserHasAccess`. Without the read below, one administrator
+     * could rename another's thread and merely be refused the response.
+     */
+    async patch(params) {
+        await this.readOwnedThread({ threadId: params.id });
+        return super.patch(params);
+    }
+    /**
+     * Delete the thread and, through the repository override, its messages.
+     *
+     * Overridden because the inherited `AbstractService.delete` guards ownership
+     * with a COMPANY comparison — `(companyId ?? "") !== entity.company?.id`. A
+     * `HandbookThread` is `isCompanyScoped: false`, so `entity.company` is always
+     * undefined, and an administrator has no `companyId`: the comparison reduces
+     * to `"" !== undefined`, which is true, and EVERY delete would 403. The owner
+     * edge is the boundary here, and `readOwnedThread` is what enforces it.
+     */
+    async delete(params) {
+        await this.readOwnedThread({ threadId: params.id });
+        await this.threads.delete({ id: params.id });
+        this.threadLogger.log(`delete: threadId=${params.id}`);
+    }
+    /**
+     * Read a thread through the owner-scoped `findById`. A thread belonging to
+     * another user raises 403 from `_validateForbidden`; an id that matches
+     * nothing comes back null and becomes a 404 here.
+     */
+    async readOwnedThread(params) {
+        const thread = await this.threads.findById({ id: params.threadId });
+        if (!thread)
+            throw new common_1.NotFoundException();
+        return thread;
+    }
+    /**
+     * Run one handbook turn on the responder and resolve its citations to page
+     * paths.
+     *
+     * `userModuleIds: []` is not a stub: the documentation branch never runs the
+     * graph or the planner, and those two are the only readers of that list.
+     *
+     * `handbookPageId` is forwarded as `limitToHandbookPageId`, which the
+     * handbook source-query provider already honours by adding
+     * `WHERE data.id = $limitToHandbookPageId` to the `(:HandbookPage)` match.
+     * Passed through EXACTLY as received, `undefined` included: an absent value
+     * means retrieval spans the whole manual, which is the default a question
+     * asked while reading one page usually wants.
+     */
+    async runTurn(params) {
+        // `|| undefined` collapses the empty string a company-less CLS context can
+        // carry into the same absent value, so the responder sees one shape.
+        const companyId = this.clsService.get("companyId") || undefined;
+        const userId = this.clsService.get("userId");
+        const response = await this.responder.run({
+            companyId,
+            userId,
+            userModuleIds: [],
+            dataLimits: { handbookMode: true, limitToHandbookPageId: params.handbookPageId },
+            messages: params.history,
+            question: params.question,
+        });
+        const chunkIds = (response.sources ?? [])
+            .map((source) => source.chunkId)
+            .filter((chunkId) => typeof chunkId === "string" && chunkId.length > 0);
+        // The repository answers one path per RESOLVABLE chunk, in citation order;
+        // several chunks of the same page collapse here. A chunk whose page cannot
+        // be resolved never reaches this list, so no source is ever an empty string.
+        const paths = await this.pages.findPathsByChunkIds({ chunkIds });
+        return {
+            answer: response.answer?.answer ?? "",
+            title: response.answer?.title?.trim() ?? "",
+            sources: [...new Set(paths)],
+        };
+    }
+    /** Persist one message under a thread. Returns the new message's id. */
+    async writeMessage(params) {
+        const id = (0, crypto_1.randomUUID)();
+        await this.messages.createFromDTO({
+            data: {
+                type: handbook_thread_message_meta_1.handbookThreadMessageMeta.type,
+                id,
+                attributes: {
+                    role: params.role,
+                    content: params.content,
+                    position: params.position,
+                    sources: params.sources,
+                },
+                relationships: {
+                    thread: { data: { type: handbook_thread_meta_1.handbookThreadMeta.type, id: params.threadId } },
+                },
+            },
+        });
+        return id;
+    }
+    /** Every message of a thread, oldest first. */
+    async loadMessages(params) {
+        const messages = await this.messageRepository.findByRelated({
+            relationship: handbook_thread_message_1.HandbookThreadMessageDescriptor.relationshipKeys.thread,
+            id: params.threadId,
+            fetchAll: true,
+            orderBy: "position ASC",
+        });
+        return this.byPosition(messages);
+    }
+    /**
+     * Sort by `position` ascending. Applied even to results that were queried
+     * with an ORDER BY: the ordering clause sits ahead of the relationship
+     * traversal `buildReturnStatement()` appends, so it is not guaranteed to
+     * survive into the rows. Position is the only ordering the client can rely
+     * on, so it is asserted where the list is produced.
+     */
+    byPosition(messages) {
+        return [...messages].sort((a, b) => (a.position ?? 0) - (b.position ?? 0));
+    }
+    /**
+     * Title for a thread whose answer produced none: the question, trimmed to
+     * 60 characters on a word boundary. Mirrors `AssistantService.autoTitle`.
+     */
+    fallbackTitle(question) {
+        const trimmed = question.trim();
+        if (trimmed.length <= exports.HANDBOOK_TITLE_MAX_LENGTH)
+            return trimmed;
+        const truncated = trimmed.slice(0, exports.HANDBOOK_TITLE_MAX_LENGTH);
+        const lastSpace = truncated.lastIndexOf(" ");
+        return lastSpace > exports.HANDBOOK_TITLE_MAX_LENGTH / 2 ? truncated.slice(0, lastSpace).trim() : truncated.trim();
+    }
+};
+exports.HandbookThreadService = HandbookThreadService;
+exports.HandbookThreadService = HandbookThreadService = HandbookThreadService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        handbook_thread_repository_1.HandbookThreadRepository,
+        nestjs_cls_1.ClsService,
+        responder_service_1.ResponderService,
+        handbook_thread_message_service_1.HandbookThreadMessageService,
+        handbook_thread_message_repository_1.HandbookThreadMessageRepository,
+        handbook_page_repository_1.HandbookPageRepository])
+], HandbookThreadService);
+//# sourceMappingURL=handbook-thread.service.js.map

package/dist/foundations/handbook/services/handbook-thread.service.js.map

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

package/dist/foundations/how-to/controllers/how-to.controller.d.ts

@@ -12,11 +12,17 @@ export declare class HowToController {
     private readonly relationships;
     constructor(howToService: HowToService, cacheService: CacheService, auditService: AuditService);
     findAll(reply: FastifyReply, query: any, search?: string, fetchAll?: boolean, orderBy?: string): Promise<void>;
+    /**
+     * Re-queue every guide for chunking — without it a guide that was never
+     * chunked (or lost its chunks) has no route back into the index.
+     *
+     * Declared before the `:howToId` routes so "reindex" is never read as an id.
+     */
+    reindex(reply: FastifyReply): Promise<void>;
     findById(reply: FastifyReply, howToId: string): Promise<void>;
     create(reply: FastifyReply, body: HowToPostDTO): Promise<void>;
     update(reply: FastifyReply, body: HowToPutDTO): Promise<void>;
     delete(reply: FastifyReply, howToId: string): Promise<void>;
-    reindex(reply: FastifyReply): Promise<void>;
     addRelated(reply: FastifyReply, howToId: string, relatedId: string): Promise<void>;
     removeRelated(reply: FastifyReply, howToId: string, relatedId: string): Promise<void>;
 }

package/dist/foundations/how-to/controllers/how-to.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/controllers/how-to.controller.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAOvC,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,qBAEa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+C;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuD;gBAGlE,YAAY,EAAE,YAAY,EAC1B,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;IAO9B,QAAQ,CAAQ,KAAK,EAAE,YAAY,EAAoB,OAAO,EAAE,MAAM;IAMtE,MAAM,CAAQ,KAAK,EAAE,YAAY,EAAU,IAAI,EAAE,YAAY;IAe7D,MAAM,CAAQ,KAAK,EAAE,YAAY,EAAU,IAAI,EAAE,WAAW;IAe5D,MAAM,CAAQ,KAAK,EAAE,YAAY,EAAoB,OAAO,EAAE,MAAM;IAMpE,OAAO,CAAQ,KAAK,EAAE,YAAY;IAOlC,UAAU,CACP,KAAK,EAAE,YAAY,EACR,OAAO,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;IASjC,aAAa,CACV,KAAK,EAAE,YAAY,EACR,OAAO,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;CAKxC"}
+{"version":3,"file":"how-to.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/controllers/how-to.controller.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAOvC,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAErD,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D,qBAEa,eAAe;IAKxB,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAN/B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+C;IACpE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuD;gBAGlE,YAAY,EAAE,YAAY,EAC1B,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;IAKpC;;;;;OAKG;IAGG,OAAO,CAAQ,KAAK,EAAE,YAAY;IAOlC,QAAQ,CAAQ,KAAK,EAAE,YAAY,EAAoB,OAAO,EAAE,MAAM;IAMtE,MAAM,CAAQ,KAAK,EAAE,YAAY,EAAU,IAAI,EAAE,YAAY;IAe7D,MAAM,CAAQ,KAAK,EAAE,YAAY,EAAU,IAAI,EAAE,WAAW;IAe5D,MAAM,CAAQ,KAAK,EAAE,YAAY,EAAoB,OAAO,EAAE,MAAM;IAMpE,UAAU,CACP,KAAK,EAAE,YAAY,EACR,OAAO,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;IASjC,aAAa,CACV,KAAK,EAAE,YAAY,EACR,OAAO,EAAE,MAAM,EACb,SAAS,EAAE,MAAM;CAKxC"}

package/dist/foundations/how-to/controllers/how-to.controller.js

@@ -37,6 +37,16 @@ let HowToController = class HowToController {
     async findAll(reply, query, search, fetchAll, orderBy) {
         return this.crud.findAll(reply, { query, search, fetchAll, orderBy });
     }
+    /**
+     * Re-queue every guide for chunking — without it a guide that was never
+     * chunked (or lost its chunks) has no route back into the index.
+     *
+     * Declared before the `:howToId` routes so "reindex" is never read as an id.
+     */
+    async reindex(reply) {
+        await this.howToService.reindexAll();
+        reply.send();
+    }
     async findById(reply, howToId) {
         return this.crud.findById(reply, howToId);
     }
@@ -61,10 +71,6 @@ let HowToController = class HowToController {
     async delete(reply, howToId) {
         return this.crud.delete(reply, howToId);
     }
-    async reindex(reply) {
-        await this.howToService.reindexAll();
-        reply.send();
-    }
     async addRelated(reply, howToId, relatedId) {
         const response = await this.howToService.addRelated({ howToId, relatedId });
         reply.send(response);
@@ -86,6 +92,14 @@ __decorate([
     __metadata("design:paramtypes", [Object, Object, String, Boolean, String]),
     __metadata("design:returntype", Promise)
 ], HowToController.prototype, "findAll", null);
+__decorate([
+    (0, common_1.Post)(`${how_to_meta_1.howToMeta.endpoint}/reindex`),
+    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
+    __param(0, (0, common_1.Res)()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], HowToController.prototype, "reindex", null);
 __decorate([
     (0, common_1.Get)(`${how_to_meta_1.howToMeta.endpoint}/:howToId`),
     (0, audit_decorator_1.Audit)(how_to_meta_1.howToMeta, "howToId"),
@@ -124,14 +138,6 @@ __decorate([
     __metadata("design:paramtypes", [Object, String]),
     __metadata("design:returntype", Promise)
 ], HowToController.prototype, "delete", null);
-__decorate([
-    (0, common_1.Post)(`${how_to_meta_1.howToMeta.endpoint}/reindex`),
-    (0, common_1.HttpCode)(common_1.HttpStatus.NO_CONTENT),
-    __param(0, (0, common_1.Res)()),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [Object]),
-    __metadata("design:returntype", Promise)
-], HowToController.prototype, "reindex", null);
 __decorate([
     (0, common_1.Post)(`${how_to_meta_1.howToMeta.endpoint}/:howToId/related/:relatedId`),
     (0, cache_invalidate_decorator_1.CacheInvalidate)(how_to_meta_1.howToMeta, "howToId"),

package/dist/foundations/how-to/controllers/how-to.controller.js.map

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

package/dist/foundations/how-to/controllers/how-to.public.controller.d.ts

@@ -3,6 +3,13 @@ import { HowToService } from "../services/how-to.service";
 /**
  * Unauthenticated read surface for PUBLISHED help articles (draft = false).
  * Auth in this package is per-controller; omitting JwtAuthGuard makes these routes public.
+ *
+ * OPT-IN ONLY: this controller is registered exclusively by
+ * `HowToModule.forRoot({ publicRoutes: true })`. Importing `HowToModule`
+ * statically — or calling `forRoot()` with no arguments — mounts the
+ * authenticated `HowToController` alone, so no consumer publishes its guides by
+ * accident. The read filter is `draft IS NULL OR draft = false`, which means a
+ * guide created without a `draft` property is served here.
  */
 export declare class HowToPublicController {
     private readonly howToService;

package/dist/foundations/how-to/controllers/how-to.public.controller.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.public.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/controllers/how-to.public.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;GAGG;AACH,qBACa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAGjD,aAAa,CAAQ,KAAK,EAAE,YAAY,EAAW,KAAK,EAAE,GAAG,EAAiB,IAAI,CAAC,EAAE,MAAM;IAM3F,WAAW,CAAQ,KAAK,EAAE,YAAY,EAAsB,SAAS,EAAE,MAAM,EAAiB,IAAI,EAAE,MAAM;IAM1G,WAAW,CACR,KAAK,EAAE,YAAY,EACN,SAAS,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EAClB,KAAK,EAAE,GAAG;CAKtB"}
+{"version":3,"file":"how-to.public.controller.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/controllers/how-to.public.controller.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,qBACa,qBAAqB;IACpB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAAZ,YAAY,EAAE,YAAY;IAGjD,aAAa,CAAQ,KAAK,EAAE,YAAY,EAAW,KAAK,EAAE,GAAG,EAAiB,IAAI,CAAC,EAAE,MAAM;IAM3F,WAAW,CAAQ,KAAK,EAAE,YAAY,EAAsB,SAAS,EAAE,MAAM,EAAiB,IAAI,EAAE,MAAM;IAM1G,WAAW,CACR,KAAK,EAAE,YAAY,EACN,SAAS,EAAE,MAAM,EACtB,IAAI,EAAE,MAAM,EAClB,KAAK,EAAE,GAAG;CAKtB"}

package/dist/foundations/how-to/controllers/how-to.public.controller.js

@@ -19,6 +19,13 @@ const how_to_service_1 = require("../services/how-to.service");
 /**
  * Unauthenticated read surface for PUBLISHED help articles (draft = false).
  * Auth in this package is per-controller; omitting JwtAuthGuard makes these routes public.
+ *
+ * OPT-IN ONLY: this controller is registered exclusively by
+ * `HowToModule.forRoot({ publicRoutes: true })`. Importing `HowToModule`
+ * statically — or calling `forRoot()` with no arguments — mounts the
+ * authenticated `HowToController` alone, so no consumer publishes its guides by
+ * accident. The read filter is `draft IS NULL OR draft = false`, which means a
+ * guide created without a `draft` property is served here.
  */
 let HowToPublicController = class HowToPublicController {
     constructor(howToService) {

package/dist/foundations/how-to/controllers/how-to.public.controller.js.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.public.controller.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/controllers/how-to.public.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoE;AAEpE,yDAAoD;AACpD,+DAA0D;AAE1D;;;GAGG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAA6B,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAGrD,AAAN,KAAK,CAAC,aAAa,CAAQ,KAAmB,EAAW,KAAU,EAAiB,IAAa;QAC/F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAGK,AAAN,KAAK,CAAC,WAAW,CAAQ,KAAmB,EAAsB,SAAiB,EAAiB,IAAY;QAC9G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAGK,AAAN,KAAK,CAAC,WAAW,CACR,KAAmB,EACN,SAAiB,EACtB,IAAY,EAClB,KAAU;QAEnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;CACF,CAAA;AAzBY,sDAAqB;AAI1B;IADL,IAAA,YAAG,EAAC,UAAU,uBAAS,CAAC,QAAQ,EAAE,CAAC;IACf,WAAA,IAAA,YAAG,GAAE,CAAA;IAAuB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;;;;0DAGlF;AAGK;IADL,IAAA,YAAG,EAAC,UAAU,uBAAS,CAAC,QAAQ,mBAAmB,CAAC;IAClC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAuB,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAAqB,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;;;;wDAGlG;AAGK;IADL,IAAA,YAAG,EAAC,UAAU,uBAAS,CAAC,QAAQ,2BAA2B,CAAC;IAE1D,WAAA,IAAA,YAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAClB,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,GAAE,CAAA;;;;wDAIT;gCAxBU,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAEgC,6BAAY;GAD5C,qBAAqB,CAyBjC"}
+{"version":3,"file":"how-to.public.controller.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/controllers/how-to.public.controller.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoE;AAEpE,yDAAoD;AACpD,+DAA0D;AAE1D;;;;;;;;;;GAUG;AAEI,IAAM,qBAAqB,GAA3B,MAAM,qBAAqB;IAChC,YAA6B,YAA0B;QAA1B,iBAAY,GAAZ,YAAY,CAAc;IAAG,CAAC;IAGrD,AAAN,KAAK,CAAC,aAAa,CAAQ,KAAmB,EAAW,KAAU,EAAiB,IAAa;QAC/F,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAGK,AAAN,KAAK,CAAC,WAAW,CAAQ,KAAmB,EAAsB,SAAiB,EAAiB,IAAY;QAC9G,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,oBAAoB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACnF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IAGK,AAAN,KAAK,CAAC,WAAW,CACR,KAAmB,EACN,SAAiB,EACtB,IAAY,EAClB,KAAU;QAEnB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,eAAe,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACrF,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;CACF,CAAA;AAzBY,sDAAqB;AAI1B;IADL,IAAA,YAAG,EAAC,UAAU,uBAAS,CAAC,QAAQ,EAAE,CAAC;IACf,WAAA,IAAA,YAAG,GAAE,CAAA;IAAuB,WAAA,IAAA,cAAK,GAAE,CAAA;IAAc,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;;;;0DAGlF;AAGK;IADL,IAAA,YAAG,EAAC,UAAU,uBAAS,CAAC,QAAQ,mBAAmB,CAAC;IAClC,WAAA,IAAA,YAAG,GAAE,CAAA;IAAuB,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAAqB,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;;;;wDAGlG;AAGK;IADL,IAAA,YAAG,EAAC,UAAU,uBAAS,CAAC,QAAQ,2BAA2B,CAAC;IAE1D,WAAA,IAAA,YAAG,GAAE,CAAA;IACL,WAAA,IAAA,cAAK,EAAC,WAAW,CAAC,CAAA;IAClB,WAAA,IAAA,cAAK,EAAC,MAAM,CAAC,CAAA;IACb,WAAA,IAAA,cAAK,GAAE,CAAA;;;;wDAIT;gCAxBU,qBAAqB;IADjC,IAAA,mBAAU,GAAE;qCAEgC,6BAAY;GAD5C,qBAAqB,CAyBjC"}

package/dist/foundations/how-to/entities/how-to.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uDAiC1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC"}
+{"version":3,"file":"how-to.d.ts","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAGvD;;GAEG;AACH,MAAM,MAAM,KAAK,GAAG,MAAM,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,eAAe,uDA+F1B,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,OAAO,eAAe,CAAC"}

package/dist/foundations/how-to/entities/how-to.js

@@ -12,23 +12,70 @@ const how_to_meta_1 = require("./how-to.meta");
 exports.HowToDescriptor = (0, common_1.defineEntity)()({
     ...how_to_meta_1.howToMeta,
     isCompanyScoped: false,
+    description: "An in-app how-to/help guide (guida): a piece of onboarding/help documentation shown to users of the platform. Global content, visible to every company, optionally scoped to specific app pages via `pages`.",
+    chat: {
+        summary: (d) => d.name ?? d.id,
+        textSearchFields: ["name", "description"],
+    },
     fields: {
-        name: { type: "string", required: true },
-        description: { type: "string", required: true },
-        pages: { type: "string" },
-        abstract: { type: "string" },
-        tldr: { type: "string" },
-        aiStatus: { type: "string" },
-        howToType: { type: "string" },
-        slug: { type: "string" },
-        order: { type: "number" },
-        summary: { type: "string" },
-        tags: { type: "string[]" },
-        contextualKeys: { type: "string[]" },
-        draft: { type: "boolean" },
+        name: {
+            type: "string",
+            required: true,
+            description: 'The title of the how-to guide (e.g. "How to create a proceeding").',
+        },
+        description: {
+            type: "string",
+            required: true,
+            description: "The guide's body content, stored as BlockNote rich-text-editor JSON (not plain text). Converted to Markdown before AI chunking/indexing.",
+        },
+        pages: {
+            type: "string",
+            description: 'JSON-encoded array of in-app path fragments (e.g. ["/proceedings", "/documents"]) this guide is relevant for; used to surface contextual help suggestions based on the page the user is currently on.',
+        },
+        abstract: {
+            type: "string",
+            description: "A short AI-generated abstract of the guide's content, produced by the summarisation pass; empty until the guide has been processed.",
+        },
+        tldr: {
+            type: "string",
+            description: "The AI-generated too-long-didn't-read one-liner for the guide, used wherever the full abstract is too long to show.",
+        },
+        aiStatus: {
+            type: "string",
+            description: "AI chunking/indexing status of the guide content (pending, in_progress, completed, failed, ...), driving the background processing pipeline that makes the guide searchable/chat-queryable.",
+        },
+        howToType: {
+            type: "string",
+            description: "The documentation category of the article — one of tutorial, how-to, reference or explanation (the DTO rejects anything else). Combined with `slug` it addresses the article on the public knowledge-base routes, and it filters the published list.",
+        },
+        slug: {
+            type: "string",
+            description: "The URL-safe identifier of the article within its `howToType`; the (howToType, slug) pair uniquely addresses a published article on the public knowledge-base routes.",
+        },
+        order: {
+            type: "number",
+            description: "Manual sort position in the published knowledge base: published and related listings are ordered by `order` ascending, then by `name`.",
+        },
+        summary: {
+            type: "string",
+            description: "A short editor-written summary of the article, shown as its teaser in knowledge-base listings and previews.",
+        },
+        tags: {
+            type: "string[]",
+            description: "Free-form editorial tags used to label and group articles in the knowledge base.",
+        },
+        contextualKeys: {
+            type: "string[]",
+            description: 'Application context keys (e.g. "npc.editor") naming the in-app surfaces this article explains; used to offer the article contextually from where the user is working.',
+        },
+        draft: {
+            type: "boolean",
+            description: "The publication gate: while true the article is unpublished and excluded from every public read — the published list, the by-type-and-slug lookup and the related list all require `draft` to be false or unset.",
+        },
     },
     computed: {
         relevance: {
+            description: "Search relevance score of this guide for the current query, taken from the `score` column of a search query; undefined outside search results.",
             compute: (params) => {
                 if (!params.record.has("score"))
                     return undefined;

package/dist/foundations/how-to/entities/how-to.js.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,+CAA0C;AAwB1C;;;;;GAKG;AACU,QAAA,eAAe,GAAG,IAAA,qBAAY,GAAS,CAAC;IACnD,GAAG,uBAAS;IAEZ,eAAe,EAAE,KAAK;IAEtB,MAAM,EAAE;QACN,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QACxC,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC/C,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACzB,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC3B,IAAI,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QAC1B,cAAc,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE;QACpC,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;KAC3B;IAED,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAI,KAAK,EAAE,QAAQ;oBAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;YACpC,CAAC;SACF;KACF;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"how-to.js","sourceRoot":"","sources":["../../../../src/foundations/how-to/entities/how-to.ts"],"names":[],"mappings":";;;AAAA,4CAAuD;AACvD,+CAA0C;AAwB1C;;;;;GAKG;AACU,QAAA,eAAe,GAAG,IAAA,qBAAY,GAAS,CAAC;IACnD,GAAG,uBAAS;IAEZ,eAAe,EAAE,KAAK;IAEtB,WAAW,EACT,8MAA8M;IAEhN,IAAI,EAAE;QACJ,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE;QAC9B,gBAAgB,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC;KAC1C;IAED,MAAM,EAAE;QACN,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,oEAAoE;SAClF;QACD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EACT,0IAA0I;SAC7I;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uMAAuM;SAC1M;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,qIAAqI;SACxI;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,qHAAqH;SACxH;QACD,QAAQ,EAAE;YACR,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6LAA6L;SAChM;QACD,SAAS,EAAE;YACT,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,sPAAsP;SACzP;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,uKAAuK;SAC1K;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,wIAAwI;SAC3I;QACD,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,WAAW,EACT,6GAA6G;SAChH;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,kFAAkF;SAChG;QACD,cAAc,EAAE;YACd,IAAI,EAAE,UAAU;YAChB,WAAW,EACT,uKAAuK;SAC1K;QACD,KAAK,EAAE;YACL,IAAI,EAAE,SAAS;YACf,WAAW,EACT,kNAAkN;SACrN;KACF;IAED,QAAQ,EAAE;QACR,SAAS,EAAE;YACT,WAAW,EACT,gJAAgJ;YAClJ,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;gBAClB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;oBAAE,OAAO,SAAS,CAAC;gBAClD,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;gBACzC,IAAI,KAAK,EAAE,QAAQ;oBAAE,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC7C,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC;YACpC,CAAC;SACF;KACF;IAED,aAAa,EAAE,EAAE;CAClB,CAAC,CAAC"}

package/dist/foundations/how-to/how-to.module.d.ts

@@ -1,5 +1,40 @@
-import { OnModuleInit } from "@nestjs/common";
+import { DynamicModule, OnModuleInit } from "@nestjs/common";
+import { HowToModuleConfig } from "./interfaces/how-to.config.interface";
+/**
+ * HowToModule — authenticated CRUD over help articles, plus an OPT-IN
+ * unauthenticated read surface.
+ *
+ * The static metadata below mounts `HowToController` only, so importing the
+ * module as `HowToModule` (no `forRoot()`) publishes nothing: every route it
+ * adds is behind `JwtAuthGuard`.
+ *
+ * Defaults are deliberately inert: with `forRoot()` and no config,
+ * `HowToPublicController` is NOT registered and the three `public/howtos/*`
+ * routes do not exist. Those routes are unauthenticated by design and their
+ * read filter is `draft IS NULL OR draft = false`, which makes a guide created
+ * without a `draft` property world-readable — publishing a company's guides is
+ * an app-level policy decision, never a side effect of mounting the module.
+ *
+ * @example
+ * ```typescript
+ * // Inert (library default): authenticated CRUD only, no public routes
+ * HowToModule
+ * HowToModule.forRoot()
+ *
+ * // Public knowledge base: adds GET public/howtos and the article routes
+ * HowToModule.forRoot({ publicRoutes: true })
+ *
+ * // Through FoundationsModule, which mounts this module for you
+ * FoundationsModule.forRoot({ howTo: { publicRoutes: true } })
+ * ```
+ */
 export declare class HowToModule implements OnModuleInit {
+    /**
+     * Configure the HowToModule.
+     *
+     * @param config - Optional configuration merged over DEFAULT_HOW_TO_CONFIG
+     */
+    static forRoot(config?: HowToModuleConfig): DynamicModule;
     onModuleInit(): void;
 }
 //# sourceMappingURL=how-to.module.d.ts.map

package/dist/foundations/how-to/how-to.module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"how-to.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/how-to/how-to.module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAetD,qBAMa,WAAY,YAAW,YAAY;IAC9C,YAAY;CAGb"}
+{"version":3,"file":"how-to.module.d.ts","sourceRoot":"","sources":["../../../src/foundations/how-to/how-to.module.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAU,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAYrE,OAAO,EAAyB,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAKhG;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAgCa,WAAY,YAAW,YAAY;IAC9C;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,iBAAiB,GAAG,aAAa;IAezD,YAAY;CAGb"}