@carlonicora/nestjs-neo4jsonapi 6.6.2 → 6.8.0

package/dist/foundations/blog/repositories/blog-category-translation.repository.js

@@ -0,0 +1,199 @@
+"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.BlogCategoryTranslationRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const ai_status_1 = require("../../../common/enums/ai.status");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const blog_category_meta_1 = require("../entities/blog-category.meta");
+const blog_category_translation_1 = require("../entities/blog-category-translation");
+const blog_category_translation_meta_1 = require("../entities/blog-category-translation.meta");
+const translation = blog_category_translation_meta_1.blogCategoryTranslationMeta.nodeName;
+const translationLabel = blog_category_translation_meta_1.blogCategoryTranslationMeta.labelName;
+const categoryLabel = blog_category_meta_1.blogCategoryMeta.labelName;
+let BlogCategoryTranslationRepository = class BlogCategoryTranslationRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = blog_category_translation_1.BlogCategoryTranslationDescriptor;
+    }
+    /**
+     * The original-language translation of a category.
+     */
+    async findOriginal(params) {
+        const query = this.neo4j.initQuery({ serialiser: blog_category_translation_1.BlogCategoryTranslationDescriptor.model });
+        query.queryParams = { ...query.queryParams, categoryId: params.categoryId };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${translation}.isOriginal = true
+      AND EXISTS {
+        MATCH (${translation})<-[:HAS_TRANSLATION]-(:${categoryLabel} {id: $categoryId})
+      }
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readOne(query);
+    }
+    /**
+     * The translation of a category in one language (original, AI, manual or placeholder).
+     */
+    async findByCategoryAndLanguage(params) {
+        const query = this.neo4j.initQuery({ serialiser: blog_category_translation_1.BlogCategoryTranslationDescriptor.model });
+        query.queryParams = { ...query.queryParams, categoryId: params.categoryId, language: params.language };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${translation}.language = $language
+      AND EXISTS {
+        MATCH (${translation})<-[:HAS_TRANSLATION]-(:${categoryLabel} {id: $categoryId})
+      }
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readOne(query);
+    }
+    /**
+     * Every category slug in one language starting with `prefix`, for the collision suffix.
+     * `excludeTranslationId` leaves out the record being re-slugged.
+     */
+    async findSlugsWithPrefix(params) {
+        const query = this.neo4j.initQuery({ serialiser: blog_category_translation_1.BlogCategoryTranslationDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            language: params.language,
+            prefix: params.prefix,
+            excludeTranslationId: params.excludeTranslationId ?? null,
+        };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WHERE ${translation}.language = $language
+      AND ${translation}.slug STARTS WITH $prefix
+      AND ($excludeTranslationId IS NULL OR ${translation}.id <> $excludeTranslationId)
+      RETURN ${translation}
+    `;
+        const translations = await this.neo4j.readMany(query);
+        return translations.map((item) => item.slug).filter((slug) => !!slug);
+    }
+    /**
+     * Creates (or keeps) one placeholder per non-original language and marks it pending.
+     */
+    async ensurePending(params) {
+        if (params.languages.length === 0)
+            return;
+        await this.neo4j.executeInTransaction([
+            {
+                query: `
+          MATCH (category:${categoryLabel} {id: $categoryId})
+          UNWIND $languages AS language
+          WITH category, language
+          WHERE language <> category.originalLanguage
+          MERGE (category)-[:HAS_TRANSLATION]->(${translation}:${translationLabel} {language: language})
+          ON CREATE SET
+            ${translation}.id = randomUUID(),
+            ${translation}.isOriginal = false,
+            ${translation}.source = $source,
+            ${translation}.createdAt = datetime()
+          SET ${translation}.aiStatus = $aiStatus, ${translation}.updatedAt = datetime()
+        `,
+                params: {
+                    categoryId: params.categoryId,
+                    languages: params.languages,
+                    source: "ai",
+                    aiStatus: ai_status_1.AiStatus.Pending,
+                },
+            },
+        ]);
+    }
+    /**
+     * Sets the AI status of the given non-original languages of a category.
+     */
+    async setAiStatus(params) {
+        if (params.languages.length === 0)
+            return;
+        await this.neo4j.executeInTransaction([
+            {
+                query: `
+          MATCH (:${categoryLabel} {id: $categoryId})-[:HAS_TRANSLATION]->(${translation}:${translationLabel})
+          WHERE ${translation}.language IN $languages
+          AND ${translation}.isOriginal = false
+          SET ${translation}.aiStatus = $aiStatus, ${translation}.updatedAt = datetime()
+        `,
+                params: { categoryId: params.categoryId, languages: params.languages, aiStatus: params.aiStatus },
+            },
+        ]);
+    }
+    /**
+     * Rewrites the text of one category translation. A `manual` source also marks the record
+     * completed, so a hand-edited language is served even if its job had failed.
+     */
+    async updateText(params) {
+        await this.neo4j.executeInTransaction([
+            {
+                query: `
+          MATCH (${translation}:${translationLabel} {id: $id})
+          SET ${translation}.name = $name,
+            ${translation}.slug = $slug,
+            ${translation}.description = $description,
+            ${translation}.updatedAt = datetime()
+          ${params.source ? `SET ${translation}.source = $source` : ""}
+          ${params.source === "manual" ? `SET ${translation}.aiStatus = $completedStatus` : ""}
+        `,
+                params: {
+                    id: params.id,
+                    name: params.name,
+                    slug: params.slug,
+                    description: params.description ?? null,
+                    source: params.source ?? null,
+                    completedStatus: ai_status_1.AiStatus.Completed,
+                },
+            },
+        ]);
+    }
+    /**
+     * Upserts the AI translation of a category in one non-original language.
+     */
+    async writeAiTranslation(params) {
+        await this.neo4j.executeInTransaction([
+            {
+                query: `
+          MATCH (category:${categoryLabel} {id: $categoryId})
+          WHERE category.originalLanguage <> $language
+          MERGE (category)-[:HAS_TRANSLATION]->(${translation}:${translationLabel} {language: $language})
+          ON CREATE SET
+            ${translation}.id = randomUUID(),
+            ${translation}.isOriginal = false,
+            ${translation}.createdAt = datetime()
+          SET ${translation}.source = $source,
+            ${translation}.aiStatus = $aiStatus,
+            ${translation}.name = $name,
+            ${translation}.slug = $slug,
+            ${translation}.description = $description,
+            ${translation}.translatedAt = datetime(),
+            ${translation}.updatedAt = datetime()
+        `,
+                params: {
+                    categoryId: params.categoryId,
+                    language: params.language,
+                    source: "ai",
+                    aiStatus: ai_status_1.AiStatus.Completed,
+                    name: params.name,
+                    slug: params.slug,
+                    description: params.description ?? null,
+                },
+            },
+        ]);
+    }
+};
+exports.BlogCategoryTranslationRepository = BlogCategoryTranslationRepository;
+exports.BlogCategoryTranslationRepository = BlogCategoryTranslationRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], BlogCategoryTranslationRepository);
+//# sourceMappingURL=blog-category-translation.repository.js.map

package/dist/foundations/blog/repositories/blog-category-translation.repository.js.map

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

package/dist/foundations/blog/repositories/blog-category.repository.d.ts

@@ -0,0 +1,56 @@
+import { ClsService } from "nestjs-cls";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { BlogCategory, BlogCategoryDescriptor } from "../entities/blog-category";
+export declare class BlogCategoryRepository extends AbstractRepository<BlogCategory, typeof BlogCategoryDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<BlogCategory, {
+        translations: {
+            model: import("../../..").DataMeta;
+            direction: "out";
+            relationship: string;
+            cardinality: "many";
+            required: false;
+            description: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * Admin list. A category has no text of its own (name and description live
+     * on its translations), so the inherited find would ignore `term`: a search
+     * matches any language version through the translation full-text index.
+     */
+    find(params: Parameters<AbstractRepository<BlogCategory, typeof BlogCategoryDescriptor.relationships>["find"]>[0]): Promise<any[]>;
+    createWithOriginal(params: {
+        id: string;
+        originalLanguage: string;
+        image?: string;
+        translation: {
+            id: string;
+            name: string;
+            slug: string;
+            description?: string;
+        };
+    }): Promise<void>;
+    /**
+     * Full update of the language-independent fields: a missing image clears it.
+     */
+    updateShared(params: {
+        id: string;
+        image?: string;
+    }): Promise<void>;
+    /**
+     * Deletes the category, its translations and its post edges. Posts stay.
+     */
+    deleteWithTranslations(params: {
+        id: string;
+    }): Promise<void>;
+    /**
+     * Every category with its text in $language (completed translation, otherwise the original),
+     * ordered by name. Unpaginated by design: the category set is small and bounded.
+     */
+    findPublicList(params: {
+        language: string;
+    }): Promise<BlogCategory[]>;
+}
+//# sourceMappingURL=blog-category.repository.d.ts.map

package/dist/foundations/blog/repositories/blog-category.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-category.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/blog/repositories/blog-category.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AAEvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AASjF,qBACa,sBAAuB,SAAQ,kBAAkB,CAC5D,YAAY,EACZ,OAAO,sBAAsB,CAAC,aAAa,CAC5C;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;;OAA0B;gBAE3C,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;;;OAIG;IACG,IAAI,CACR,MAAM,EAAE,UAAU,CAAC,kBAAkB,CAAC,YAAY,EAAE,OAAO,sBAAsB,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IA4BxG,kBAAkB,CAAC,MAAM,EAAE;QAC/B,EAAE,EAAE,MAAM,CAAC;QACX,gBAAgB,EAAE,MAAM,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,WAAW,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC/E,GAAG,OAAO,CAAC,IAAI,CAAC;IAwCjB;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAYzE;;OAEG;IACG,sBAAsB,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAenE;;;OAGG;IACG,cAAc,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;CA0B5E"}

package/dist/foundations/blog/repositories/blog-category.repository.js

@@ -0,0 +1,166 @@
+"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.BlogCategoryRepository = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_cls_1 = require("nestjs-cls");
+const ai_status_1 = require("../../../common/enums/ai.status");
+const abstract_repository_1 = require("../../../core/neo4j/abstracts/abstract.repository");
+const build_fulltext_term_1 = require("../../../core/neo4j/helpers/build-fulltext-term");
+const neo4j_service_1 = require("../../../core/neo4j/services/neo4j.service");
+const security_service_1 = require("../../../core/security/services/security.service");
+const blog_category_1 = require("../entities/blog-category");
+const blog_category_meta_1 = require("../entities/blog-category.meta");
+const blog_category_translation_1 = require("../entities/blog-category-translation");
+const blog_category_translation_meta_1 = require("../entities/blog-category-translation.meta");
+const category = blog_category_meta_1.blogCategoryMeta.nodeName;
+const categoryLabel = blog_category_meta_1.blogCategoryMeta.labelName;
+const translationLabel = blog_category_translation_meta_1.blogCategoryTranslationMeta.labelName;
+let BlogCategoryRepository = class BlogCategoryRepository extends abstract_repository_1.AbstractRepository {
+    constructor(neo4j, securityService, clsService) {
+        super(neo4j, securityService, clsService);
+        this.descriptor = blog_category_1.BlogCategoryDescriptor;
+    }
+    /**
+     * Admin list. A category has no text of its own (name and description live
+     * on its translations), so the inherited find would ignore `term`: a search
+     * matches any language version through the translation full-text index.
+     */
+    async find(params) {
+        if (!params.term)
+            return super.find(params);
+        const query = this.neo4j.initQuery({
+            cursor: params.cursor,
+            serialiser: blog_category_1.BlogCategoryDescriptor.model,
+            fetchAll: params.fetchAll,
+        });
+        query.queryParams = { ...query.queryParams, term: (0, build_fulltext_term_1.buildFulltextTerm)(params.term) };
+        query.query += `
+      CALL db.index.fulltext.queryNodes("${blog_category_translation_1.BlogCategoryTranslationDescriptor.fulltextIndexName}", $term) YIELD node, score
+      MATCH (${category}:${categoryLabel})-[:HAS_TRANSLATION]->(node)
+      WITH ${category}, max(score) AS score
+      CALL {
+        WITH ${category}
+        ${this.buildDefaultMatch()}
+        RETURN true AS ${category}_fulltextAccess
+        LIMIT 1
+      }
+      WITH ${category}, score
+      ORDER BY score DESC
+      {CURSOR}
+      ${this.buildReturnStatement()}
+    `;
+        return this.neo4j.readMany(query);
+    }
+    async createWithOriginal(params) {
+        await this.neo4j.executeInTransaction([
+            {
+                query: `
+          CREATE (${category}:${categoryLabel} {
+            id: $id,
+            originalLanguage: $originalLanguage,
+            image: $image,
+            createdAt: datetime(),
+            updatedAt: datetime()
+          })
+          CREATE (translation:${translationLabel} {
+            id: $translationId,
+            language: $originalLanguage,
+            isOriginal: true,
+            source: $source,
+            aiStatus: $aiStatus,
+            name: $name,
+            slug: $slug,
+            description: $description,
+            createdAt: datetime(),
+            updatedAt: datetime()
+          })
+          CREATE (${category})-[:HAS_TRANSLATION]->(translation)
+        `,
+                params: {
+                    id: params.id,
+                    originalLanguage: params.originalLanguage,
+                    image: params.image ?? null,
+                    translationId: params.translation.id,
+                    source: "original",
+                    aiStatus: ai_status_1.AiStatus.Completed,
+                    name: params.translation.name,
+                    slug: params.translation.slug,
+                    description: params.translation.description ?? null,
+                },
+            },
+        ]);
+    }
+    /**
+     * Full update of the language-independent fields: a missing image clears it.
+     */
+    async updateShared(params) {
+        await this.neo4j.executeInTransaction([
+            {
+                query: `
+          MATCH (${category}:${categoryLabel} {id: $id})
+          SET ${category}.image = $image, ${category}.updatedAt = datetime()
+        `,
+                params: { id: params.id, image: params.image ?? null },
+            },
+        ]);
+    }
+    /**
+     * Deletes the category, its translations and its post edges. Posts stay.
+     */
+    async deleteWithTranslations(params) {
+        await this.neo4j.executeInTransaction([
+            {
+                query: `
+          MATCH (${category}:${categoryLabel} {id: $id})
+          OPTIONAL MATCH (${category})-[:HAS_TRANSLATION]->(translation:${translationLabel})
+          WITH ${category}, collect(translation) AS translations
+          FOREACH (item IN translations | DETACH DELETE item)
+          DETACH DELETE ${category}
+        `,
+                params: { id: params.id },
+            },
+        ]);
+    }
+    /**
+     * Every category with its text in $language (completed translation, otherwise the original),
+     * ordered by name. Unpaginated by design: the category set is small and bounded.
+     */
+    async findPublicList(params) {
+        const query = this.neo4j.initQuery({ serialiser: blog_category_1.BlogCategoryDescriptor.model });
+        query.queryParams = {
+            ...query.queryParams,
+            language: params.language,
+            completedStatus: ai_status_1.AiStatus.Completed,
+        };
+        query.query += `
+      ${this.buildDefaultMatch()}
+      WITH ${category},
+        head([(${category})-[:HAS_TRANSLATION]->(localised:${translationLabel}) WHERE localised.language = $language AND localised.aiStatus = $completedStatus | localised]) AS localised
+      WITH ${category},
+        coalesce(localised, head([(${category})-[:HAS_TRANSLATION]->(original:${translationLabel}) WHERE original.isOriginal = true | original])) AS t
+      WITH ${category}, t
+      ORDER BY toLower(t.name) ASC
+      RETURN ${category},
+        t.language AS resolvedLanguage,
+        t.name AS resolvedName,
+        t.slug AS resolvedSlug,
+        t.description AS resolvedDescription
+    `;
+        return this.neo4j.readMany(query);
+    }
+};
+exports.BlogCategoryRepository = BlogCategoryRepository;
+exports.BlogCategoryRepository = BlogCategoryRepository = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [neo4j_service_1.Neo4jService, security_service_1.SecurityService, nestjs_cls_1.ClsService])
+], BlogCategoryRepository);
+//# sourceMappingURL=blog-category.repository.js.map

package/dist/foundations/blog/repositories/blog-category.repository.js.map

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

package/dist/foundations/blog/repositories/blog-post-translation.repository.d.ts

@@ -0,0 +1,88 @@
+import { ClsService } from "nestjs-cls";
+import { AiStatus } from "../../../common/enums/ai.status";
+import { AbstractRepository } from "../../../core/neo4j/abstracts/abstract.repository";
+import { Neo4jService } from "../../../core/neo4j/services/neo4j.service";
+import { SecurityService } from "../../../core/security/services/security.service";
+import { BlogTranslationSource } from "../blog.constants";
+import { BlogPostTranslation, BlogPostTranslationDescriptor } from "../entities/blog-post-translation";
+export declare class BlogPostTranslationRepository extends AbstractRepository<BlogPostTranslation, typeof BlogPostTranslationDescriptor.relationships> {
+    protected readonly descriptor: import("../../..").EntityDescriptor<BlogPostTranslation, {
+        post: {
+            model: import("../../..").DataMeta;
+            direction: "in";
+            relationship: string;
+            cardinality: "one";
+            description: string;
+        };
+    }>;
+    constructor(neo4j: Neo4jService, securityService: SecurityService, clsService: ClsService);
+    /**
+     * The original-language translation of a post.
+     */
+    findOriginal(params: {
+        postId: string;
+    }): Promise<BlogPostTranslation | null>;
+    /**
+     * The translation of a post in one language (original, AI, manual or placeholder).
+     */
+    findByPostAndLanguage(params: {
+        postId: string;
+        language: string;
+    }): Promise<BlogPostTranslation | null>;
+    /**
+     * Every slug in one language (across all posts) starting with `prefix`, for the `-2`, `-3`
+     * collision suffix. `excludeTranslationId` leaves out the record being re-slugged.
+     */
+    findSlugsWithPrefix(params: {
+        language: string;
+        prefix: string;
+        excludeTranslationId?: string;
+    }): Promise<string[]>;
+    /**
+     * Creates (or keeps) one placeholder per non-original language and marks it pending, so the
+     * admin sees "Translating..." at once. Existing records keep their text until the job writes.
+     */
+    ensurePending(params: {
+        postId: string;
+        languages: string[];
+    }): Promise<void>;
+    /**
+     * Sets the AI status of the given non-original languages of a post.
+     */
+    setAiStatus(params: {
+        postId: string;
+        languages: string[];
+        aiStatus: AiStatus;
+    }): Promise<void>;
+    /**
+     * Rewrites the text of one translation and bumps the post's updatedAt. A `manual` source also
+     * marks the record completed, so a hand-edited language is served even if its job had failed.
+     */
+    updateText(params: {
+        id: string;
+        title: string;
+        slug: string;
+        summary?: string;
+        body: string;
+        bodyText: string;
+        coverImageAlt?: string;
+        readingMinutes: number;
+        source?: BlogTranslationSource;
+    }): Promise<void>;
+    /**
+     * Upserts the AI translation of a post in one non-original language: source "ai", status
+     * completed, translatedAt now. Overwrites any manual edit, by design.
+     */
+    writeAiTranslation(params: {
+        postId: string;
+        language: string;
+        title: string;
+        slug: string;
+        summary?: string;
+        body: string;
+        bodyText: string;
+        coverImageAlt?: string;
+        readingMinutes: number;
+    }): Promise<void>;
+}
+//# sourceMappingURL=blog-post-translation.repository.d.ts.map

package/dist/foundations/blog/repositories/blog-post-translation.repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-post-translation.repository.d.ts","sourceRoot":"","sources":["../../../../src/foundations/blog/repositories/blog-post-translation.repository.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mDAAmD,CAAC;AACvF,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,OAAO,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAOvG,qBACa,6BAA8B,SAAQ,kBAAkB,CACnE,mBAAmB,EACnB,OAAO,6BAA6B,CAAC,aAAa,CACnD;IACC,SAAS,CAAC,QAAQ,CAAC,UAAU;;;;;;;;OAAiC;gBAElD,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU;IAIzF;;OAEG;IACG,YAAY,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAiBnF;;OAEG;IACG,qBAAqB,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAiB9G;;;OAGG;IACG,mBAAmB,CAAC,MAAM,EAAE;QAChC,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsBrB;;;OAGG;IACG,aAAa,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BnF;;OAEG;IACG,WAAW,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,EAAE,QAAQ,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBrG;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE;QACvB,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,qBAAqB,CAAC;KAChC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmCjB;;;OAGG;IACG,kBAAkB,CAAC,MAAM,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,cAAc,EAAE,MAAM,CAAC;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC;CAuClB"}