@carlonicora/nestjs-neo4jsonapi 4.3.2 → 4.5.0

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

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

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

@@ -0,0 +1,23 @@
+export * from "./handbook.module";
+export * from "./entities/handbook-page";
+export * from "./entities/handbook-page.meta";
+export * from "./entities/handbook-section";
+export * from "./entities/handbook-section.meta";
+export * from "./entities/handbook-thread";
+export * from "./entities/handbook-thread.meta";
+export * from "./entities/handbook-thread-message";
+export * from "./entities/handbook-thread-message.meta";
+export * from "./interfaces/handbook.config.interface";
+export * from "./repositories/handbook-page.repository";
+export * from "./repositories/handbook-section.repository";
+export * from "./repositories/handbook-thread.repository";
+export * from "./repositories/handbook-thread-message.repository";
+export * from "./services/handbook-page.service";
+export * from "./services/handbook-section.service";
+export * from "./services/handbook-ingest.service";
+export * from "./services/handbook-thread.service";
+export * from "./services/handbook-thread-message.service";
+export * from "./dtos/handbook-thread-post.dto";
+export * from "./dtos/handbook-thread-patch.dto";
+export * from "./dtos/handbook-thread-message-post.dto";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/foundations/handbook/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AACzC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,6BAA6B,CAAC;AAC5C,cAAc,kCAAkC,CAAC;AACjD,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,oCAAoC,CAAC;AACnD,cAAc,yCAAyC,CAAC;AACxD,cAAc,wCAAwC,CAAC;AACvD,cAAc,yCAAyC,CAAC;AACxD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,2CAA2C,CAAC;AAC1D,cAAc,mDAAmD,CAAC;AAClE,cAAc,kCAAkC,CAAC;AACjD,cAAc,qCAAqC,CAAC;AACpD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,iCAAiC,CAAC;AAChD,cAAc,kCAAkC,CAAC;AACjD,cAAc,yCAAyC,CAAC"}

package/dist/foundations/handbook/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./handbook.module"), exports);
+__exportStar(require("./entities/handbook-page"), exports);
+__exportStar(require("./entities/handbook-page.meta"), exports);
+__exportStar(require("./entities/handbook-section"), exports);
+__exportStar(require("./entities/handbook-section.meta"), exports);
+__exportStar(require("./entities/handbook-thread"), exports);
+__exportStar(require("./entities/handbook-thread.meta"), exports);
+__exportStar(require("./entities/handbook-thread-message"), exports);
+__exportStar(require("./entities/handbook-thread-message.meta"), exports);
+__exportStar(require("./interfaces/handbook.config.interface"), exports);
+__exportStar(require("./repositories/handbook-page.repository"), exports);
+__exportStar(require("./repositories/handbook-section.repository"), exports);
+__exportStar(require("./repositories/handbook-thread.repository"), exports);
+__exportStar(require("./repositories/handbook-thread-message.repository"), exports);
+__exportStar(require("./services/handbook-page.service"), exports);
+__exportStar(require("./services/handbook-section.service"), exports);
+__exportStar(require("./services/handbook-ingest.service"), exports);
+__exportStar(require("./services/handbook-thread.service"), exports);
+__exportStar(require("./services/handbook-thread-message.service"), exports);
+__exportStar(require("./dtos/handbook-thread-post.dto"), exports);
+__exportStar(require("./dtos/handbook-thread-patch.dto"), exports);
+__exportStar(require("./dtos/handbook-thread-message-post.dto"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/foundations/handbook/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2DAAyC;AACzC,gEAA8C;AAC9C,8DAA4C;AAC5C,mEAAiD;AACjD,6DAA2C;AAC3C,kEAAgD;AAChD,qEAAmD;AACnD,0EAAwD;AACxD,yEAAuD;AACvD,0EAAwD;AACxD,6EAA2D;AAC3D,4EAA0D;AAC1D,oFAAkE;AAClE,mEAAiD;AACjD,sEAAoD;AACpD,qEAAmD;AACnD,qEAAmD;AACnD,6EAA2D;AAC3D,kEAAgD;AAChD,mEAAiD;AACjD,0EAAwD"}

package/dist/foundations/handbook/interfaces/handbook.config.interface.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Where an application keeps the documentation this foundation ingests.
+ *
+ * `path` unset is the library default: the feature loads, mounts its routes and
+ * does nothing. `sync` refuses rather than guessing a directory, which is what
+ * keeps a deployed image — which ships no docs/ tree — inert.
+ */
+export interface HandbookModuleConfig {
+    /** Absolute, or relative to process.cwd(). */
+    path?: string;
+    /** Glob patterns, relative to `path`, excluded from the walk. e.g. ["it/**"] */
+    exclude?: string[];
+    /**
+     * Subdirectory of `path` holding the display translation, e.g. "it". Unset =
+     * English everywhere.
+     *
+     * The translation is SHOWN, never INDEXED: the tree it names must also be
+     * `exclude`d, so the English walk skips it, and the display pass writes only
+     * `displayTitle` / `displaySummary` / `displayContent` onto pages the English
+     * walk already created. Nothing in it is chunked, embedded or retrievable.
+     */
+    displayPath?: string;
+}
+export declare const HANDBOOK_CONFIG: unique symbol;
+export declare const DEFAULT_HANDBOOK_CONFIG: Required<HandbookModuleConfig>;
+//# sourceMappingURL=handbook.config.interface.d.ts.map

package/dist/foundations/handbook/interfaces/handbook.config.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook.config.interface.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/interfaces/handbook.config.interface.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAAC,oBAAoB,CAIlE,CAAC"}

package/dist/foundations/handbook/interfaces/handbook.config.interface.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_HANDBOOK_CONFIG = exports.HANDBOOK_CONFIG = void 0;
+exports.HANDBOOK_CONFIG = Symbol("HANDBOOK_CONFIG");
+exports.DEFAULT_HANDBOOK_CONFIG = {
+    path: "",
+    exclude: [],
+    displayPath: "",
+};
+//# sourceMappingURL=handbook.config.interface.js.map

package/dist/foundations/handbook/interfaces/handbook.config.interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook.config.interface.js","sourceRoot":"","sources":["../../../../src/foundations/handbook/interfaces/handbook.config.interface.ts"],"names":[],"mappings":";;;AAwBa,QAAA,eAAe,GAAG,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAE5C,QAAA,uBAAuB,GAAmC;IACrE,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,EAAE;IACX,WAAW,EAAE,EAAE;CAChB,CAAC"}

package/dist/foundations/handbook/processors/handbook.processor.d.ts

@@ -0,0 +1,22 @@
+import { WorkerHost } from "@nestjs/bullmq";
+import { ConfigService } from "@nestjs/config";
+import { Job } from "bullmq";
+import { ClsService } from "nestjs-cls";
+import { BaseConfigInterface } from "../../../config/interfaces/base.config.interface";
+import { AppLoggingService } from "../../../core/logging/services/logging.service";
+import { ChunkRepository } from "../../chunk/repositories/chunk.repository";
+import { HandbookPageService } from "../services/handbook-page.service";
+export declare class HandbookProcessor extends WorkerHost {
+    private readonly logger;
+    private readonly handbookPageService;
+    private readonly chunkRepository;
+    private readonly cls;
+    private readonly handbookJobName;
+    constructor(logger: AppLoggingService, handbookPageService: HandbookPageService, chunkRepository: ChunkRepository, cls: ClsService, configService: ConfigService<BaseConfigInterface>);
+    onActive(job: Job): void;
+    onError(job: Job): void;
+    onCompleted(job: Job): void;
+    process(job: Job): Promise<void>;
+    private _finalise;
+}
+//# sourceMappingURL=handbook.processor.d.ts.map

package/dist/foundations/handbook/processors/handbook.processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handbook.processor.d.ts","sourceRoot":"","sources":["../../../../src/foundations/handbook/processors/handbook.processor.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kDAAkD,CAAC;AACvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,gDAAgD,CAAC;AACnF,OAAO,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AAE5E,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE,qBACa,iBAAkB,SAAQ,UAAU;IAI7C,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB;IACpC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,GAAG;IANtB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAGtB,MAAM,EAAE,iBAAiB,EACzB,mBAAmB,EAAE,mBAAmB,EACxC,eAAe,EAAE,eAAe,EAChC,GAAG,EAAE,UAAU,EAChC,aAAa,EAAE,aAAa,CAAC,mBAAmB,CAAC;IAQnD,QAAQ,CAAC,GAAG,EAAE,GAAG;IAKjB,OAAO,CAAC,GAAG,EAAE,GAAG;IAKhB,WAAW,CAAC,GAAG,EAAE,GAAG;IAId,OAAO,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAiBxB,SAAS;CAyBxB"}

package/dist/foundations/handbook/processors/handbook.processor.js

@@ -0,0 +1,108 @@
+"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.HandbookProcessor = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const config_1 = require("@nestjs/config");
+const bullmq_2 = require("bullmq");
+const nestjs_cls_1 = require("nestjs-cls");
+const ai_status_1 = require("../../../common/enums/ai.status");
+const queue_id_1 = require("../../../config/enums/queue.id");
+const logging_service_1 = require("../../../core/logging/services/logging.service");
+const chunk_repository_1 = require("../../chunk/repositories/chunk.repository");
+const handbook_page_meta_1 = require("../entities/handbook-page.meta");
+const handbook_page_service_1 = require("../services/handbook-page.service");
+let HandbookProcessor = class HandbookProcessor extends bullmq_1.WorkerHost {
+    constructor(logger, handbookPageService, chunkRepository, cls, configService) {
+        super();
+        this.logger = logger;
+        this.handbookPageService = handbookPageService;
+        this.chunkRepository = chunkRepository;
+        this.cls = cls;
+        this.handbookJobName =
+            configService.get("jobNames", { infer: true })?.process?.HandbookPage ?? "process_handbookpage";
+    }
+    onActive(job) {
+        this.logger.debug(`Processing ${job.name} job`);
+    }
+    onError(job) {
+        this.logger.error(`Error processing ${job.name} job (ID: ${job.id}). Reason: ${job.failedReason}`);
+    }
+    onCompleted(job) {
+        this.logger.debug(`Completed ${job.name} job (ID: ${job.id})`);
+    }
+    async process(job) {
+        if (job.name !== this.handbookJobName) {
+            throw new Error(`Job ${job.name} not handled by HandbookProcessor`);
+        }
+        await this.cls.run(async () => {
+            this.cls.set("userId", job.data.userId);
+            this.cls.set("isAutomatedJob", true);
+            if (job.data.companyId) {
+                this.cls.set("companyId", job.data.companyId);
+            }
+            await this._finalise({ handbookPageId: job.data.id });
+        });
+    }
+    async _finalise(params) {
+        // Single-winner latch: ChunkService enqueues one finalise job per chunk, so a
+        // pending-chunk count only rejects jobs that run WHILE chunking is in flight.
+        // The claim subsumes that check.
+        const claimed = await this.chunkRepository.claimContentFinalisation({
+            id: params.handbookPageId,
+            nodeType: handbook_page_meta_1.handbookPageMeta.labelName,
+        });
+        if (!claimed)
+            return;
+        try {
+            await this.handbookPageService.updateAiStatus({
+                id: params.handbookPageId,
+                aiStatus: ai_status_1.AiStatus.Completed,
+            });
+        }
+        catch (error) {
+            // Release the latch, or a BullMQ retry finds it held and no-ops.
+            await this.chunkRepository.clearFinalisationClaim({
+                id: params.handbookPageId,
+                nodeType: handbook_page_meta_1.handbookPageMeta.labelName,
+            });
+            throw error;
+        }
+    }
+};
+exports.HandbookProcessor = HandbookProcessor;
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("active"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], HandbookProcessor.prototype, "onActive", null);
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("failed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], HandbookProcessor.prototype, "onError", null);
+__decorate([
+    (0, bullmq_1.OnWorkerEvent)("completed"),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [bullmq_2.Job]),
+    __metadata("design:returntype", void 0)
+], HandbookProcessor.prototype, "onCompleted", null);
+exports.HandbookProcessor = HandbookProcessor = __decorate([
+    (0, bullmq_1.Processor)(queue_id_1.QueueId.HANDBOOK_PAGE, { concurrency: 10, lockDuration: 1000 * 60 }),
+    __metadata("design:paramtypes", [logging_service_1.AppLoggingService,
+        handbook_page_service_1.HandbookPageService,
+        chunk_repository_1.ChunkRepository,
+        nestjs_cls_1.ClsService,
+        config_1.ConfigService])
+], HandbookProcessor);
+//# sourceMappingURL=handbook.processor.js.map

package/dist/foundations/handbook/processors/handbook.processor.js.map

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

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

@@ -0,0 +1,135 @@
+import { OnModuleInit } from "@nestjs/common";
+import { ClsService } from "nestjs-cls";
+import { AiStatus } from "../../../common/enums/ai.status";
+import { JsonApiCursorInterface } from "../../../core/jsonapi/interfaces/jsonapi.cursor.interface";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { FilterCriterion, SortCriterion } from "../../../core/neo4j/types/filter.criterion";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { HandbookPage, HandbookPageDescriptor } from "../entities/handbook-page";
+export declare class HandbookPageRepository extends AbstractRepository<HandbookPage, typeof HandbookPageDescriptor.relationships> implements OnModuleInit {
+    protected readonly descriptor: import("../../..").EntityDescriptor<HandbookPage, {}>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * `path` is the natural key of the ingest: the walk looks a page up by the
+     * file it came from. The descriptor only auto-creates the `id` constraint
+     * (common/helpers/define-entity.ts:387), so this one is declared here — the
+     * same place ChunkRepository declares its own indexes.
+     *
+     * `super.onModuleInit()` runs FIRST and is not optional: the base
+     * implementation is what turns the descriptor's `constraints` and `indexes`
+     * into real Neo4j objects. Overriding it without delegating would silently
+     * drop the `id` uniqueness constraint and the descriptor's FULLTEXT index —
+     * the bug NotificationRepository avoids by re-declaring its `id` constraint
+     * by hand. Delegating keeps the database config derived from the descriptor.
+     */
+    onModuleInit(): Promise<void>;
+    /**
+     * The list is a manual's table of contents, not an audit log.
+     *
+     * `AbstractRepository.find` orders by `descriptor.defaultOrderBy`, which
+     * `defineEntity` hardcodes to `updatedAt DESC` and exposes no way to override
+     * — so without this the rows arrive in reverse ingest order and `09-workflow`
+     * renders before `00-start-here`. The one ordering hook `find` does offer a
+     * caller is `orderByFields`, a multi-key `SortCriterion[]`; supplying a
+     * default for it puts `ORDER BY handbookPage.section ASC, handbookPage.order
+     * ASC` ahead of `{CURSOR}` in the inherited query and leaves the fulltext
+     * branch, the structured filters, the security snippet and the pagination
+     * exactly as the framework builds them.
+     *
+     * `order` is the repo-relative path, so sorting on it inside a section
+     * reproduces the filesystem, which is already meaningful. An explicit
+     * `orderBy` or `orderByFields` from the request still wins.
+     */
+    find(params: {
+        fetchAll?: boolean;
+        term?: string;
+        orderBy?: string;
+        orderByFields?: SortCriterion[];
+        filters?: FilterCriterion[];
+        cursor?: JsonApiCursorInterface;
+    }): Promise<HandbookPage[]>;
+    /** Every page, unpaginated — the ingest diffs the whole tree in one pass. */
+    findAllPages(): Promise<HandbookPage[]>;
+    findByPath(params: {
+        path: string;
+    }): Promise<HandbookPage | null>;
+    /**
+     * Provenance for one answer: the repo-relative path of the page each cited
+     * chunk belongs to, in the order the chunks were cited.
+     *
+     * This does NOT go through `readMany`, because the result is not a
+     * `HandbookPage` — it is one scalar column. Raw records never leave this
+     * method: the mapping to `string[]` happens here, and a row whose `path` is
+     * missing is dropped rather than returned as an empty string. A chunk whose
+     * page no longer exists simply does not match, so it disappears from the
+     * provenance list instead of appearing as a blank source.
+     */
+    findPathsByChunkIds(params: {
+        chunkIds: string[];
+    }): Promise<string[]>;
+    createPage(params: {
+        id: string;
+        path: string;
+        title: string;
+        content: string;
+        contentHash: string;
+        wordCount: number;
+        section: string;
+        order: string;
+        summary?: string;
+    }): Promise<void>;
+    updatePage(params: {
+        id: string;
+        title: string;
+        content: string;
+        contentHash: string;
+        wordCount: number;
+        section: string;
+        order: string;
+        summary?: string;
+    }): Promise<void>;
+    /**
+     * Index fields only — no content, no hash, no chunk work.
+     *
+     * The walk calls this for a page whose bytes did not change, so that a sync
+     * which only adds new index data (a README summary, a frontmatter `section`)
+     * costs nothing in embeddings. Bumping INGEST_FORMAT_VERSION instead would
+     * change every contentHash and re-embed the whole tree.
+     */
+    updateMetadata(params: {
+        id: string;
+        title: string;
+        section: string;
+        order: string;
+        summary?: string;
+    }): Promise<void>;
+    /**
+     * The display translation of one page — title, summary and body.
+     *
+     * Display fields ONLY. No content, no contentHash, no aiStatus, no chunk
+     * work: the page is indexed in English and shown in the display language, so
+     * a translation that arrives, changes or disappears must leave the retrieval
+     * store byte-for-byte as it was. Writing `content` here, or bumping the hash,
+     * would re-chunk and re-embed the page in the translated language and poison
+     * the index the handbook answers from.
+     *
+     * Every value is bound, and an absent one is bound as `null` rather than
+     * omitted: `null` CLEARS the property, which is what a page whose translation
+     * was deleted needs, and `undefined` is not a legal driver parameter.
+     */
+    updateDisplay(params: {
+        id: string;
+        displayTitle?: string;
+        displaySummary?: string;
+        displayContent?: string;
+    }): Promise<void>;
+    updateStatus(params: {
+        id: string;
+        aiStatus: AiStatus;
+    }): Promise<void>;
+    deletePage(params: {
+        id: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=handbook-page.repository.d.ts.map

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

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