@endora-commerce/mod-blog 0.100.0

package/dist/backend/services/blog-language-reference.d.ts

@@ -0,0 +1,18 @@
+import type { DictionaryReferenceRegistryPort } from '@endora-commerce/contracts';
+import type { EntityManager } from '@mikro-orm/postgresql';
+/**
+ * Who in `blog` still points at a language (feature 077, D-87).
+ *
+ * Two descriptors, one per table: `languages` used to count both itself, and
+ * `dictionaries`' orphan report joined both a second time. Both statements
+ * named this module's tables in strings no import-level boundary check can
+ * see.
+ *
+ * Contributed whatever this module's effective state, and blocking while it
+ * is off: a switched-off blog still owns rows carrying the language code, so
+ * deleting the language would leave them dangling the moment an operator
+ * switches the blog back on. That is the registry's stated enumeration
+ * policy, and the reason it is `honour` rather than `skip`.
+ */
+export declare function registerBlogLanguageReferences(registry: DictionaryReferenceRegistryPort, emFactory: () => EntityManager): void;
+//# sourceMappingURL=blog-language-reference.d.ts.map

package/dist/backend/services/blog-language-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-language-reference.d.ts","sourceRoot":"","sources":["../../../src/backend/services/blog-language-reference.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,+BAA+B,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,+BAA+B,EACzC,SAAS,EAAE,MAAM,aAAa,GAC7B,IAAI,CAuCN"}

package/dist/backend/services/blog-language-reference.js

@@ -0,0 +1,43 @@
+/**
+ * Who in `blog` still points at a language (feature 077, D-87).
+ *
+ * Two descriptors, one per table: `languages` used to count both itself, and
+ * `dictionaries`' orphan report joined both a second time. Both statements
+ * named this module's tables in strings no import-level boundary check can
+ * see.
+ *
+ * Contributed whatever this module's effective state, and blocking while it
+ * is off: a switched-off blog still owns rows carrying the language code, so
+ * deleting the language would leave them dangling the moment an operator
+ * switches the blog back on. That is the registry's stated enumeration
+ * policy, and the reason it is `honour` rather than `skip`.
+ */
+export function registerBlogLanguageReferences(registry, emFactory) {
+    registry.register({
+        ownerModuleId: 'blog',
+        consumer: 'blog',
+        tableName: 'blog_post_languages',
+        columnName: 'language',
+        blocking: true,
+        countReferences: async (code) => {
+            const rows = (await emFactory().execute(`select count(*)::int as n from "blog_post_languages" where "language" = ?`, [code]));
+            return rows[0]?.n ?? 0;
+        },
+        usedCodes: async () => (await emFactory().execute(`select "language" as code, count(*)::int as count
+           from "blog_post_languages" where "language" is not null group by "language"`)),
+    });
+    registry.register({
+        ownerModuleId: 'blog',
+        consumer: 'blog',
+        tableName: 'blog_category_languages',
+        columnName: 'language',
+        blocking: true,
+        countReferences: async (code) => {
+            const rows = (await emFactory().execute(`select count(*)::int as n from "blog_category_languages" where "language" = ?`, [code]));
+            return rows[0]?.n ?? 0;
+        },
+        usedCodes: async () => (await emFactory().execute(`select "language" as code, count(*)::int as count
+           from "blog_category_languages" where "language" is not null group by "language"`)),
+    });
+}
+//# sourceMappingURL=blog-language-reference.js.map

package/dist/backend/services/blog-language-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-language-reference.js","sourceRoot":"","sources":["../../../src/backend/services/blog-language-reference.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAAyC,EACzC,SAA8B;IAE9B,QAAQ,CAAC,QAAQ,CAAC;QAChB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,qBAAqB;QAChC,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACrC,2EAA2E,EAC3E,CAAC,IAAI,CAAC,CACP,CAAyB,CAAC;YAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,SAAS,EAAE,KAAK,IAAI,EAAE,CACpB,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACxB;uFAC+E,CAChF,CAA2C;KAC/C,CAAC,CAAC;IACH,QAAQ,CAAC,QAAQ,CAAC;QAChB,aAAa,EAAE,MAAM;QACrB,QAAQ,EAAE,MAAM;QAChB,SAAS,EAAE,yBAAyB;QACpC,UAAU,EAAE,UAAU;QACtB,QAAQ,EAAE,IAAI;QACd,eAAe,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC9B,MAAM,IAAI,GAAG,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACrC,+EAA+E,EAC/E,CAAC,IAAI,CAAC,CACP,CAAyB,CAAC;YAC3B,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,SAAS,EAAE,KAAK,IAAI,EAAE,CACpB,CAAC,MAAM,SAAS,EAAE,CAAC,OAAO,CACxB;2FACmF,CACpF,CAA2C;KAC/C,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/services/blog-post-service.d.ts

@@ -0,0 +1,79 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type BlogPostDetail, type BlogPostInboundReferencesResponse, type BlogPostStatus, type BlogPostSummary, type CreateBlogPostRequest, type DictionaryValidator, type PatchBlogPostRequest, type PutBlogPostContentRequest } from '@endora-commerce/contracts';
+import type { BlogCacheService } from './blog-cache.js';
+type PostListFilters = {
+    q?: string | undefined;
+    status?: BlogPostStatus | undefined;
+    salesChannelId?: string | undefined;
+    categoryId?: string | undefined;
+    tagId?: string | undefined;
+    language?: string | undefined;
+    page?: number | undefined;
+    perPage?: number | undefined;
+};
+/**
+ * BlogPostService — feature 016 / T033.
+ *
+ * Owns the full BlogPost CRUD + lifecycle + relations contract documented
+ * in `contracts/blog-admin-http.contract.md`. The service runs every
+ * write inside an `em.transactional(...)` block; the slug-collision
+ * helper acquires per-(channel, slug) advisory locks so a concurrent
+ * write cannot squeeze a duplicate past the partial unique indexes.
+ *
+ * The status state machine is documented in `data-model.md` § State
+ * transitions: draft → published (sets published_at if null), published
+ * → draft (preserves published_at), published ↔ archived. softDelete
+ * additionally detaches every blog_post_related_posts row where
+ * related_post_id = id (FR-028 / R5) so deleting an article does not
+ * orphan a parent post's strip — the storefront just sees a shorter
+ * list and the admin's confirmation dialog has already surfaced the
+ * affected parents.
+ */
+export declare class BlogPostService {
+    private readonly emFactory;
+    private readonly cache?;
+    private readonly dictionaryValidator?;
+    constructor(emFactory: () => EntityManager, cache?: BlogCacheService | undefined, dictionaryValidator?: DictionaryValidator | undefined);
+    list(filters: PostListFilters): Promise<{
+        data: BlogPostSummary[];
+        pagination: {
+            page: number;
+            perPage: number;
+            totalPages: number;
+            totalItems: number;
+        };
+    }>;
+    create(input: CreateBlogPostRequest): Promise<BlogPostDetail>;
+    getById(id: string): Promise<BlogPostDetail>;
+    patch(id: string, input: PatchBlogPostRequest): Promise<BlogPostDetail>;
+    setContent(id: string, input: PutBlogPostContentRequest): Promise<BlogPostDetail>;
+    setTags(id: string, tagIds: string[], version: number): Promise<BlogPostDetail>;
+    setRelatedPosts(id: string, relatedPostIds: string[], version: number): Promise<BlogPostDetail>;
+    setRelatedProducts(id: string, productIds: string[], version: number): Promise<BlogPostDetail>;
+    publish(id: string, version: number): Promise<BlogPostDetail>;
+    unpublish(id: string, version: number): Promise<BlogPostDetail>;
+    archive(id: string, version: number): Promise<BlogPostDetail>;
+    softDelete(id: string, version: number): Promise<{
+        detachedFromParents: string[];
+    }>;
+    getInboundReferences(id: string): Promise<BlogPostInboundReferencesResponse>;
+    private transitionStatus;
+    private findRow;
+    private assertVersion;
+    private getByIdInTx;
+    private toSummary;
+    private normaliseContent;
+    private toIso;
+    private toIsoNonNull;
+    private loadChannelIds;
+    private loadLanguages;
+    private validateLanguages;
+    private replaceChannels;
+    private replaceLanguages;
+    private replaceCategories;
+    private replaceTags;
+    private fallbackToDefaultCategory;
+    private invalidateCacheForPost;
+}
+export {};
+//# sourceMappingURL=blog-post-service.d.ts.map

package/dist/backend/services/blog-post-service.d.ts.map

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