@carlonicora/nestjs-neo4jsonapi 6.7.0 → 6.9.0

package/dist/foundations/blog/services/blog-post.service.js

@@ -0,0 +1,276 @@
+"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.BlogPostService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const crypto_1 = require("crypto");
+const nestjs_cls_1 = require("nestjs-cls");
+const blocknote_service_1 = require("../../../core/blocknote/services/blocknote.service");
+const jsonapi_paginator_1 = require("../../../core/jsonapi/serialisers/jsonapi.paginator");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const blog_post_1 = require("../entities/blog-post");
+const blog_post_translation_repository_1 = require("../repositories/blog-post-translation.repository");
+const blog_post_repository_1 = require("../repositories/blog-post.repository");
+const reading_time_1 = require("../utils/reading-time");
+const slug_1 = require("../utils/slug");
+const blog_queue_service_1 = require("./blog-queue.service");
+const s3_client_key_service_1 = require("../../s3/services/s3-client-key.service");
+/** Largest page the public list serves (the web asks for 12 per "Load more" step). */
+const PUBLIC_MAX_PAGE_SIZE = 120;
+const RELATED_LIMIT = 3;
+/**
+ * Blog posts: admin writes (original language only), publishing, and the
+ * public reads that resolve one language per post.
+ */
+let BlogPostService = class BlogPostService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, blogPostRepository, clsService, blogPostTranslationRepository, blogQueueService, blockNoteService, configService, s3ClientKeys) {
+        super(jsonApiService, blogPostRepository, clsService, blog_post_1.BlogPostDescriptor.model);
+        this.blogPostRepository = blogPostRepository;
+        this.blogPostTranslationRepository = blogPostTranslationRepository;
+        this.blogQueueService = blogQueueService;
+        this.blockNoteService = blockNoteService;
+        this.configService = configService;
+        this.s3ClientKeys = s3ClientKeys;
+        this.descriptor = blog_post_1.BlogPostDescriptor;
+    }
+    /**
+     * Creates a draft with its original-language text, then queues the summary
+     * (unless the admin wrote one) and the translation into every other language.
+     */
+    async createFromDTO(params) {
+        // The controller validated the body against BlogPostPostDTO; the crud handler widens it to JsonApiDTOData.
+        const data = params.data;
+        const attributes = data.attributes;
+        // A client-sent image key is checked against the app's S3 key policy before it is stored and signed.
+        await this.s3ClientKeys?.assertClientKey({ key: attributes.coverImage });
+        const originalLanguage = attributes.originalLanguage;
+        const supportedLanguages = this._supportedLanguages();
+        if (!supportedLanguages.includes(originalLanguage))
+            throw new common_1.BadRequestException(`Unsupported language: ${originalLanguage}`);
+        const bodyText = this._plainText(attributes.body);
+        const slug = await this._uniqueSlug({ language: originalLanguage, text: attributes.title });
+        const summary = attributes.summary?.trim() ? attributes.summary : undefined;
+        await this.blogPostRepository.createWithOriginal({
+            id: data.id,
+            authorId: this.clsService.get("userId"),
+            originalLanguage,
+            coverImage: attributes.coverImage,
+            categoryIds: this._categoryIds(data),
+            translation: {
+                id: (0, crypto_1.randomUUID)(),
+                title: attributes.title,
+                slug,
+                summary,
+                body: attributes.body,
+                bodyText,
+                coverImageAlt: attributes.coverImageAlt,
+                readingMinutes: (0, reading_time_1.readingMinutes)(bodyText),
+            },
+        });
+        await this._queue({
+            postId: data.id,
+            generateSummary: !summary,
+            languages: supportedLanguages.filter((language) => language !== originalLanguage),
+        });
+        return this.findById({ id: data.id });
+    }
+    /**
+     * Updates the shared fields and the original-language text.
+     *
+     * - A published post keeps its slugs when the title changes (old links keep
+     *   working); an explicit `slug` is always applied.
+     * - Translation re-runs only when the original's text changed, and it
+     *   overwrites hand-edited translations.
+     * - The summary is regenerated when the body changed and the admin did not
+     *   edit the summary on this save, or when it was cleared.
+     */
+    async putFromDTO(params) {
+        // The controller validated the body against BlogPostPutDTO; the crud handler widens it to JsonApiDTOData.
+        const data = params.data;
+        const id = data.id;
+        const attributes = data.attributes;
+        // A client-sent image key is checked against the app's S3 key policy before it is stored and signed.
+        await this.s3ClientKeys?.assertClientKey({ key: attributes.coverImage });
+        const post = await this.blogPostRepository.findById({ id });
+        if (!post)
+            throw new common_1.NotFoundException(`Blog post ${id} not found`);
+        const original = await this.blogPostTranslationRepository.findOriginal({ postId: id });
+        if (!original)
+            throw new common_1.NotFoundException(`Blog post ${id} has no original text`);
+        const title = attributes.title;
+        const body = attributes.body;
+        // Omitted summary = untouched (keep the stored one); an empty string = cleared (regenerate).
+        const summary = attributes.summary === undefined ? original.summary : attributes.summary.trim() ? attributes.summary : undefined;
+        const coverImageAlt = attributes.coverImageAlt;
+        const bodyChanged = body !== original.body;
+        const summaryChanged = (summary ?? "") !== (original.summary ?? "");
+        const textChanged = bodyChanged ||
+            summaryChanged ||
+            title !== original.title ||
+            (coverImageAlt ?? "") !== (original.coverImageAlt ?? "");
+        let slug = original.slug;
+        if (attributes.slug?.trim()) {
+            slug = await this._uniqueSlug({
+                language: post.originalLanguage,
+                text: attributes.slug,
+                excludeTranslationId: original.id,
+            });
+        }
+        else if (!slug || (post.status !== "published" && title !== original.title)) {
+            slug = await this._uniqueSlug({
+                language: post.originalLanguage,
+                text: title,
+                excludeTranslationId: original.id,
+            });
+        }
+        const bodyText = this._plainText(body);
+        await this.blogPostRepository.updateShared({
+            id,
+            // Omitted cover = unchanged: the client only sends a key after a new upload.
+            coverImage: attributes.coverImage ?? post.coverImage,
+            categoryIds: this._categoryIds(data),
+        });
+        await this.blogPostTranslationRepository.updateText({
+            id: original.id,
+            title,
+            slug,
+            summary,
+            body,
+            bodyText,
+            coverImageAlt,
+            readingMinutes: (0, reading_time_1.readingMinutes)(bodyText),
+        });
+        if (textChanged) {
+            await this._queue({
+                postId: id,
+                generateSummary: !summary || (bodyChanged && !summaryChanged),
+                languages: this._supportedLanguages().filter((language) => language !== post.originalLanguage),
+            });
+        }
+        return this.findById({ id });
+    }
+    /** Deletes the post with every translation. */
+    async delete(params) {
+        const post = await this.blogPostRepository.findById({ id: params.id });
+        if (!post)
+            throw new common_1.NotFoundException(`Blog post ${params.id} not found`);
+        await this.blogPostRepository.deleteWithTranslations({ id: params.id });
+    }
+    /** Publishes (or republishes) a post. The first publish date is kept. */
+    async publish(params) {
+        const post = await this.blogPostRepository.findById({ id: params.id });
+        if (!post)
+            throw new common_1.NotFoundException(`Blog post ${params.id} not found`);
+        await this.blogPostRepository.setStatus({ id: params.id, status: "published" });
+        return this.findById({ id: params.id });
+    }
+    async unpublish(params) {
+        const post = await this.blogPostRepository.findById({ id: params.id });
+        if (!post)
+            throw new common_1.NotFoundException(`Blog post ${params.id} not found`);
+        if (post.status !== "published")
+            throw new common_1.BadRequestException(`Blog post ${params.id} is not published`);
+        await this.blogPostRepository.setStatus({ id: params.id, status: "unpublished" });
+        return this.findById({ id: params.id });
+    }
+    async findPublishedList(params) {
+        const paginator = new jsonapi_paginator_1.JsonApiPaginator(this._clampPublicPageSize(params.query));
+        const data = await this.blogPostRepository.findPublished({
+            language: params.language,
+            categorySlug: params.categorySlug || undefined,
+            term: params.search?.trim() || undefined,
+            cursor: paginator.generateCursor(),
+        });
+        return this.jsonApiService.buildList(blog_post_1.BlogPostDescriptor.model, data, paginator);
+    }
+    /** 404 for an unknown slug and for a draft or unpublished post. */
+    async findPublishedBySlug(params) {
+        const post = await this.blogPostRepository.findPublishedBySlug(params);
+        if (!post)
+            throw new common_1.NotFoundException(`Blog post ${params.slug} not found`);
+        return this.jsonApiService.buildSingle(blog_post_1.BlogPostDescriptor.model, post);
+    }
+    async findPublishedRelated(params) {
+        const post = await this.blogPostRepository.findPublishedBySlug(params);
+        if (!post)
+            throw new common_1.NotFoundException(`Blog post ${params.slug} not found`);
+        const data = await this.blogPostRepository.findPublishedRelated({
+            postId: post.id,
+            language: params.language,
+            limit: RELATED_LIMIT,
+        });
+        const paginator = new jsonapi_paginator_1.JsonApiPaginator();
+        return this.jsonApiService.buildList(blog_post_1.BlogPostDescriptor.model, data, paginator);
+    }
+    async _queue(params) {
+        if (!params.generateSummary && params.languages.length === 0)
+            return;
+        await this.blogQueueService.enqueuePost(params);
+    }
+    _supportedLanguages() {
+        return this.configService.get("i18n")?.supportedLanguages ?? ["en"];
+    }
+    _plainText(body) {
+        try {
+            return this.blockNoteService.convertToPlainText({ nodes: JSON.parse(body) });
+        }
+        catch {
+            throw new common_1.BadRequestException("The body is not valid BlockNote JSON");
+        }
+    }
+    _categoryIds(data) {
+        const items = data.relationships?.categories?.data;
+        return Array.isArray(items) ? items.map((item) => item.id) : [];
+    }
+    async _uniqueSlug(params) {
+        const base = (0, slug_1.slugify)(params.text);
+        const taken = await this.blogPostTranslationRepository.findSlugsWithPrefix({
+            language: params.language,
+            prefix: base,
+            excludeTranslationId: params.excludeTranslationId,
+        });
+        return (0, slug_1.uniqueSlug)(base, taken);
+    }
+    /**
+     * Anonymous visitors set page[size] through the URL ("Load more" grows it), so the
+     * public list caps it: an unbounded size would let anyone force a full-table read.
+     */
+    _clampPublicPageSize(query) {
+        if (!query)
+            return query;
+        const clamp = (value) => String(Math.min(Math.max(1, Number(value) || 1), PUBLIC_MAX_PAGE_SIZE));
+        const clamped = { ...query };
+        if (clamped["page[size]"] !== undefined)
+            clamped["page[size]"] = clamp(clamped["page[size]"]);
+        if (clamped.page?.size !== undefined)
+            clamped.page = { ...clamped.page, size: clamp(clamped.page.size) };
+        return clamped;
+    }
+};
+exports.BlogPostService = BlogPostService;
+exports.BlogPostService = BlogPostService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(7, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        blog_post_repository_1.BlogPostRepository,
+        nestjs_cls_1.ClsService,
+        blog_post_translation_repository_1.BlogPostTranslationRepository,
+        blog_queue_service_1.BlogQueueService,
+        blocknote_service_1.BlockNoteService,
+        config_1.ConfigService,
+        s3_client_key_service_1.S3ClientKeyService])
+], BlogPostService);
+//# sourceMappingURL=blog-post.service.js.map

package/dist/foundations/blog/services/blog-post.service.js.map

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

package/dist/foundations/blog/services/blog-queue.service.d.ts

@@ -0,0 +1,36 @@
+import { Queue } from "bullmq";
+import { BlogCategoryTranslationRepository } from "../repositories/blog-category-translation.repository";
+import { BlogPostTranslationRepository } from "../repositories/blog-post-translation.repository";
+/**
+ * Enqueues the blog's AI jobs (summary + translation).
+ *
+ * Every enqueue first creates (or keeps) one placeholder translation per target
+ * language in `pending`, so the admin sees "Translating…" at once.
+ *
+ * The payloads never carry `companyId`: the blog is platform content, so token
+ * usage is recorded against the post or category and no company is charged.
+ */
+export declare class BlogQueueService {
+    private readonly queue;
+    private readonly blogPostTranslationRepository;
+    private readonly blogCategoryTranslationRepository;
+    constructor(queue: Queue, blogPostTranslationRepository: BlogPostTranslationRepository, blogCategoryTranslationRepository: BlogCategoryTranslationRepository);
+    enqueuePost(params: {
+        postId: string;
+        generateSummary: boolean;
+        languages: string[];
+    }): Promise<void>;
+    enqueuePostLanguage(params: {
+        postId: string;
+        language: string;
+    }): Promise<void>;
+    enqueueCategory(params: {
+        categoryId: string;
+        languages: string[];
+    }): Promise<void>;
+    enqueueCategoryLanguage(params: {
+        categoryId: string;
+        language: string;
+    }): Promise<void>;
+}
+//# sourceMappingURL=blog-queue.service.d.ts.map

package/dist/foundations/blog/services/blog-queue.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-queue.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/blog/services/blog-queue.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAG/B,OAAO,EAAE,iCAAiC,EAAE,MAAM,sDAAsD,CAAC;AACzG,OAAO,EAAE,6BAA6B,EAAE,MAAM,kDAAkD,CAAC;AAEjG;;;;;;;;GAQG;AACH,qBACa,gBAAgB;IAEE,OAAO,CAAC,QAAQ,CAAC,KAAK;IACjD,OAAO,CAAC,QAAQ,CAAC,6BAA6B;IAC9C,OAAO,CAAC,QAAQ,CAAC,iCAAiC;gBAFN,KAAK,EAAE,KAAK,EACvC,6BAA6B,EAAE,6BAA6B,EAC5D,iCAAiC,EAAE,iCAAiC;IAGjF,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASrG,mBAAmB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKhF,eAAe,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAWnF,uBAAuB,CAAC,MAAM,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;CAU/F"}

package/dist/foundations/blog/services/blog-queue.service.js

@@ -0,0 +1,79 @@
+"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.BlogQueueService = void 0;
+const bullmq_1 = require("@nestjs/bullmq");
+const common_1 = require("@nestjs/common");
+const bullmq_2 = require("bullmq");
+const queue_id_1 = require("../../../config/enums/queue.id");
+const blog_constants_1 = require("../blog.constants");
+const blog_category_translation_repository_1 = require("../repositories/blog-category-translation.repository");
+const blog_post_translation_repository_1 = require("../repositories/blog-post-translation.repository");
+/**
+ * Enqueues the blog's AI jobs (summary + translation).
+ *
+ * Every enqueue first creates (or keeps) one placeholder translation per target
+ * language in `pending`, so the admin sees "Translating…" at once.
+ *
+ * The payloads never carry `companyId`: the blog is platform content, so token
+ * usage is recorded against the post or category and no company is charged.
+ */
+let BlogQueueService = class BlogQueueService {
+    constructor(queue, blogPostTranslationRepository, blogCategoryTranslationRepository) {
+        this.queue = queue;
+        this.blogPostTranslationRepository = blogPostTranslationRepository;
+        this.blogCategoryTranslationRepository = blogCategoryTranslationRepository;
+    }
+    async enqueuePost(params) {
+        await this.blogPostTranslationRepository.ensurePending({ postId: params.postId, languages: params.languages });
+        await this.queue.add(blog_constants_1.BlogJobName.ProcessPost, {
+            postId: params.postId,
+            generateSummary: params.generateSummary,
+            languages: params.languages,
+        });
+    }
+    async enqueuePostLanguage(params) {
+        await this.blogPostTranslationRepository.ensurePending({ postId: params.postId, languages: [params.language] });
+        await this.queue.add(blog_constants_1.BlogJobName.TranslatePost, { postId: params.postId, language: params.language });
+    }
+    async enqueueCategory(params) {
+        await this.blogCategoryTranslationRepository.ensurePending({
+            categoryId: params.categoryId,
+            languages: params.languages,
+        });
+        await this.queue.add(blog_constants_1.BlogJobName.ProcessCategory, {
+            categoryId: params.categoryId,
+            languages: params.languages,
+        });
+    }
+    async enqueueCategoryLanguage(params) {
+        await this.blogCategoryTranslationRepository.ensurePending({
+            categoryId: params.categoryId,
+            languages: [params.language],
+        });
+        await this.queue.add(blog_constants_1.BlogJobName.TranslateCategory, {
+            categoryId: params.categoryId,
+            language: params.language,
+        });
+    }
+};
+exports.BlogQueueService = BlogQueueService;
+exports.BlogQueueService = BlogQueueService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, bullmq_1.InjectQueue)(queue_id_1.QueueId.BLOG)),
+    __metadata("design:paramtypes", [bullmq_2.Queue,
+        blog_post_translation_repository_1.BlogPostTranslationRepository,
+        blog_category_translation_repository_1.BlogCategoryTranslationRepository])
+], BlogQueueService);
+//# sourceMappingURL=blog-queue.service.js.map

package/dist/foundations/blog/services/blog-queue.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-queue.service.js","sourceRoot":"","sources":["../../../../src/foundations/blog/services/blog-queue.service.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAA6C;AAC7C,2CAA4C;AAC5C,mCAA+B;AAC/B,6DAAyD;AACzD,sDAAgD;AAChD,+GAAyG;AACzG,uGAAiG;AAEjG;;;;;;;;GAQG;AAEI,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC3B,YAC8C,KAAY,EACvC,6BAA4D,EAC5D,iCAAoE;QAFzC,UAAK,GAAL,KAAK,CAAO;QACvC,kCAA6B,GAA7B,6BAA6B,CAA+B;QAC5D,sCAAiC,GAAjC,iCAAiC,CAAmC;IACpF,CAAC;IAEJ,KAAK,CAAC,WAAW,CAAC,MAAyE;QACzF,MAAM,IAAI,CAAC,6BAA6B,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QAC/G,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,4BAAW,CAAC,WAAW,EAAE;YAC5C,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,MAA4C;QACpE,MAAM,IAAI,CAAC,6BAA6B,CAAC,aAAa,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAChH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,4BAAW,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC;IACxG,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAmD;QACvE,MAAM,IAAI,CAAC,iCAAiC,CAAC,aAAa,CAAC;YACzD,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,4BAAW,CAAC,eAAe,EAAE;YAChD,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,uBAAuB,CAAC,MAAgD;QAC5E,MAAM,IAAI,CAAC,iCAAiC,CAAC,aAAa,CAAC;YACzD,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,SAAS,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC7B,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,4BAAW,CAAC,iBAAiB,EAAE;YAClD,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,QAAQ,EAAE,MAAM,CAAC,QAAQ;SAC1B,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AA1CY,4CAAgB;2BAAhB,gBAAgB;IAD5B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,oBAAW,EAAC,kBAAO,CAAC,IAAI,CAAC,CAAA;qCAAyB,cAAK;QACR,gEAA6B;QACzB,wEAAiC;GAJ5E,gBAAgB,CA0C5B"}

package/dist/foundations/blog/services/blog-settings.service.d.ts

@@ -0,0 +1,21 @@
+import { ClsService } from "nestjs-cls";
+import { JsonApiSingleDocument } from "../../../core/jsonapi/interfaces/jsonapi.document.interface";
+import { JsonApiService } from "../../../core/jsonapi/services/jsonapi.service";
+import { AbstractService } from "../../../core/neo4j/abstracts/abstract.service";
+import { BlogSettingsPutDTO } from "../dtos/blog-settings.put.dto";
+import { BlogSettings, BlogSettingsDescriptor } from "../entities/blog-settings";
+import { BlogSettingsRepository } from "../repositories/blog-settings.repository";
+/**
+ * The blog's singleton settings (the public list layout). Until an admin saves
+ * them, reads return the default `featured` layout under BLOG_SETTINGS_ID.
+ */
+export declare class BlogSettingsService extends AbstractService<BlogSettings, typeof BlogSettingsDescriptor.relationships> {
+    private readonly blogSettingsRepository;
+    protected readonly descriptor: import("../../..").EntityDescriptor<BlogSettings, {}>;
+    constructor(jsonApiService: JsonApiService, blogSettingsRepository: BlogSettingsRepository, clsService: ClsService);
+    getSettings(): Promise<JsonApiSingleDocument>;
+    saveSettings(params: {
+        data: BlogSettingsPutDTO["data"];
+    }): Promise<JsonApiSingleDocument>;
+}
+//# sourceMappingURL=blog-settings.service.d.ts.map

package/dist/foundations/blog/services/blog-settings.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-settings.service.d.ts","sourceRoot":"","sources":["../../../../src/foundations/blog/services/blog-settings.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,cAAc,EAAE,MAAM,gDAAgD,CAAC;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,gDAAgD,CAAC;AAEjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AAElF;;;GAGG;AACH,qBACa,mBAAoB,SAAQ,eAAe,CAAC,YAAY,EAAE,OAAO,sBAAsB,CAAC,aAAa,CAAC;IAK/G,OAAO,CAAC,QAAQ,CAAC,sBAAsB;IAJzC,SAAS,CAAC,QAAQ,CAAC,UAAU,wDAA0B;gBAGrD,cAAc,EAAE,cAAc,EACb,sBAAsB,EAAE,sBAAsB,EAC/D,UAAU,EAAE,UAAU;IAKlB,WAAW,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAM7C,YAAY,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC;CAKjG"}

package/dist/foundations/blog/services/blog-settings.service.js

@@ -0,0 +1,49 @@
+"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.BlogSettingsService = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const jsonapi_service_1 = require("../../../core/jsonapi/services/jsonapi.service");
+const abstract_service_1 = require("../../../core/neo4j/abstracts/abstract.service");
+const blog_constants_1 = require("../blog.constants");
+const blog_settings_1 = require("../entities/blog-settings");
+const blog_settings_repository_1 = require("../repositories/blog-settings.repository");
+/**
+ * The blog's singleton settings (the public list layout). Until an admin saves
+ * them, reads return the default `featured` layout under BLOG_SETTINGS_ID.
+ */
+let BlogSettingsService = class BlogSettingsService extends abstract_service_1.AbstractService {
+    constructor(jsonApiService, blogSettingsRepository, clsService) {
+        super(jsonApiService, blogSettingsRepository, clsService, blog_settings_1.BlogSettingsDescriptor.model);
+        this.blogSettingsRepository = blogSettingsRepository;
+        this.descriptor = blog_settings_1.BlogSettingsDescriptor;
+    }
+    async getSettings() {
+        const stored = await this.blogSettingsRepository.findSettings();
+        const settings = stored ?? { id: blog_constants_1.BLOG_SETTINGS_ID, listLayout: "featured" };
+        return this.jsonApiService.buildSingle(blog_settings_1.BlogSettingsDescriptor.model, settings);
+    }
+    async saveSettings(params) {
+        if (params.data.id !== blog_constants_1.BLOG_SETTINGS_ID)
+            throw new common_1.BadRequestException("Unknown blog settings id");
+        await this.blogSettingsRepository.upsert({ listLayout: params.data.attributes.listLayout });
+        return this.getSettings();
+    }
+};
+exports.BlogSettingsService = BlogSettingsService;
+exports.BlogSettingsService = BlogSettingsService = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [jsonapi_service_1.JsonApiService,
+        blog_settings_repository_1.BlogSettingsRepository,
+        nestjs_cls_1.ClsService])
+], BlogSettingsService);
+//# sourceMappingURL=blog-settings.service.js.map

package/dist/foundations/blog/services/blog-settings.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-settings.service.js","sourceRoot":"","sources":["../../../../src/foundations/blog/services/blog-settings.service.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,2CAAiE;AACjE,2CAAwC;AAExC,oFAAgF;AAChF,qFAAiF;AACjF,sDAAqD;AAErD,6DAAiF;AACjF,uFAAkF;AAElF;;;GAGG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAoB,SAAQ,kCAA0E;IAGjH,YACE,cAA8B,EACb,sBAA8C,EAC/D,UAAsB;QAEtB,KAAK,CAAC,cAAc,EAAE,sBAAsB,EAAE,UAAU,EAAE,sCAAsB,CAAC,KAAK,CAAC,CAAC;QAHvE,2BAAsB,GAAtB,sBAAsB,CAAwB;QAJ9C,eAAU,GAAG,sCAAsB,CAAC;IAQvD,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,YAAY,EAAE,CAAC;QAChE,MAAM,QAAQ,GAAG,MAAM,IAAK,EAAE,EAAE,EAAE,iCAAgB,EAAE,UAAU,EAAE,UAAU,EAAmB,CAAC;QAC9F,OAAO,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,sCAAsB,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,MAA4C;QAC7D,IAAI,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,iCAAgB;YAAE,MAAM,IAAI,4BAAmB,CAAC,0BAA0B,CAAC,CAAC;QACnG,MAAM,IAAI,CAAC,sBAAsB,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC,CAAC;QAC5F,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC;IAC5B,CAAC;CACF,CAAA;AAtBY,kDAAmB;8BAAnB,mBAAmB;IAD/B,IAAA,mBAAU,GAAE;qCAKO,gCAAc;QACW,iDAAsB;QACnD,uBAAU;GANb,mBAAmB,CAsB/B"}

package/dist/foundations/blog/utils/reading-time.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Reading time in whole minutes at 200 words per minute, never less than 1.
+ */
+export declare function readingMinutes(plainText: string): number;
+//# sourceMappingURL=reading-time.d.ts.map

package/dist/foundations/blog/utils/reading-time.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading-time.d.ts","sourceRoot":"","sources":["../../../../src/foundations/blog/utils/reading-time.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/foundations/blog/utils/reading-time.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readingMinutes = readingMinutes;
+const WORDS_PER_MINUTE = 200;
+/**
+ * Reading time in whole minutes at 200 words per minute, never less than 1.
+ */
+function readingMinutes(plainText) {
+    const words = (plainText ?? "").split(/\s+/).filter((word) => word.length > 0).length;
+    return Math.max(1, Math.ceil(words / WORDS_PER_MINUTE));
+}
+//# sourceMappingURL=reading-time.js.map

package/dist/foundations/blog/utils/reading-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reading-time.js","sourceRoot":"","sources":["../../../../src/foundations/blog/utils/reading-time.ts"],"names":[],"mappings":";;AAKA,wCAGC;AARD,MAAM,gBAAgB,GAAG,GAAG,CAAC;AAE7B;;GAEG;AACH,SAAgB,cAAc,CAAC,SAAiB;IAC9C,MAAM,KAAK,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;IACtF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,gBAAgB,CAAC,CAAC,CAAC;AAC1D,CAAC"}

package/dist/foundations/blog/utils/slug.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Lowercase kebab-case ASCII slug: diacritics stripped (NFKD), every run of characters outside
+ * [a-z0-9] collapsed to one dash, dashes trimmed from both ends, at most 80 characters.
+ * Returns "post" when nothing usable is left.
+ */
+export declare function slugify(text: string): string;
+/**
+ * Returns `base` when it is free, otherwise the first free `base-2`, `base-3`, ...
+ * `taken` is the list of slugs already used in the same language.
+ */
+export declare function uniqueSlug(base: string, taken: string[]): string;
+//# sourceMappingURL=slug.d.ts.map

package/dist/foundations/blog/utils/slug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.d.ts","sourceRoot":"","sources":["../../../../src/foundations/blog/utils/slug.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAW5C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAOhE"}

package/dist/foundations/blog/utils/slug.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugify = slugify;
+exports.uniqueSlug = uniqueSlug;
+const MAX_SLUG_LENGTH = 80;
+const EMPTY_SLUG = "post";
+/**
+ * Lowercase kebab-case ASCII slug: diacritics stripped (NFKD), every run of characters outside
+ * [a-z0-9] collapsed to one dash, dashes trimmed from both ends, at most 80 characters.
+ * Returns "post" when nothing usable is left.
+ */
+function slugify(text) {
+    const slug = (text ?? "")
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, MAX_SLUG_LENGTH)
+        .replace(/-+$/g, "");
+    return slug.length > 0 ? slug : EMPTY_SLUG;
+}
+/**
+ * Returns `base` when it is free, otherwise the first free `base-2`, `base-3`, ...
+ * `taken` is the list of slugs already used in the same language.
+ */
+function uniqueSlug(base, taken) {
+    const used = new Set(taken);
+    if (!used.has(base))
+        return base;
+    let suffix = 2;
+    while (used.has(`${base}-${suffix}`))
+        suffix++;
+    return `${base}-${suffix}`;
+}
+//# sourceMappingURL=slug.js.map

package/dist/foundations/blog/utils/slug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slug.js","sourceRoot":"","sources":["../../../../src/foundations/blog/utils/slug.ts"],"names":[],"mappings":";;AAQA,0BAWC;AAMD,gCAOC;AAhCD,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B;;;;GAIG;AACH,SAAgB,OAAO,CAAC,IAAY;IAClC,MAAM,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;SACtB,SAAS,CAAC,MAAM,CAAC;SACjB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;SACrB,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,KAAK,CAAC,CAAC,EAAE,eAAe,CAAC;SACzB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAEvB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC;AAC7C,CAAC;AAED;;;GAGG;AACH,SAAgB,UAAU,CAAC,IAAY,EAAE,KAAe;IACtD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC;IAC5B,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAEjC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;QAAE,MAAM,EAAE,CAAC;IAC/C,OAAO,GAAG,IAAI,IAAI,MAAM,EAAE,CAAC;AAC7B,CAAC"}

package/dist/foundations/foundations.modules.d.ts

@@ -1,5 +1,6 @@
 import { DynamicModule, Type } from "@nestjs/common";
 import { AnalyticsModuleConfig } from "./analytics/interfaces/analytics.config.interface";
+import { BlogModuleConfig } from "./blog/interfaces/blog.config.interface";
 import { ContentExtensionConfig } from "./content/interfaces/content.extension.interface";
 import { ReferralModuleConfig } from "./referral/interfaces/referral.config.interface";
 import { EmailAutomationModuleConfig } from "./email-automation/interfaces/email-automation.config.interface";
@@ -20,6 +21,13 @@ export interface FoundationsModuleConfig {
     handbook?: HandbookModuleConfig;
     /** Optional configuration for the how-to feature module (opt-in public routes) */
     howTo?: HowToModuleConfig;
+    /**
+     * The blog feature module. OPT-IN: the blog mounts only when this key is
+     * present (`blog: {}` for the admin routes, `blog: { publicRoutes: true }`
+     * for the public reads too). Omitted, no blog controller, queue or worker is
+     * mounted, so an app with the permission gate on needs no Blog section seed.
+     */
+    blog?: BlogModuleConfig;
     /** Optional configuration for the email-automation feature module (the triggers the app declares) */
     emailAutomation?: EmailAutomationModuleConfig;
     /** Optional override for the analytics feature module (normally switched on by `ANALYTICS_ENABLED=true`) */

package/dist/foundations/foundations.modules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"foundations.modules.d.ts","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAS1F,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAGvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AAG9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAyBhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AAGrG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,kEAAkE;IAClE,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,kFAAkF;IAClF,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B,qGAAqG;IACrG,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,4GAA4G;IAC5G,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AA0DD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CA2BhE"}
+{"version":3,"file":"foundations.modules.d.ts","sourceRoot":"","sources":["../../src/foundations/foundations.modules.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAU,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mDAAmD,CAAC;AAM1F,OAAO,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAK3E,OAAO,EAAE,sBAAsB,EAAE,MAAM,kDAAkD,CAAC;AAE1F,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAGvF,OAAO,EAAE,2BAA2B,EAAE,MAAM,iEAAiE,CAAC;AAG9G,OAAO,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAEvF,OAAO,EAAE,iBAAiB,EAAE,MAAM,6CAA6C,CAAC;AAyBhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,2DAA2D,CAAC;AAGrG;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,kEAAkE;IAClE,YAAY,CAAC,EAAE,wBAAwB,CAAC;IACxC,gEAAgE;IAChE,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,kFAAkF;IAClF,KAAK,CAAC,EAAE,iBAAiB,CAAC;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,gBAAgB,CAAC;IACxB,qGAAqG;IACrG,eAAe,CAAC,EAAE,2BAA2B,CAAC;IAC9C,4GAA4G;IAC5G,SAAS,CAAC,EAAE,qBAAqB,CAAC;IAClC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;CACvB;AA0DD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBACa,iBAAiB;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,uBAAuB,GAAG,aAAa;CA6BhE"}