@endora-commerce/mod-blog 0.100.0

package/dist/backend/index.js

@@ -0,0 +1,182 @@
+import { effectiveState, lazyPort } from '@endora-commerce/platform/kernel';
+import { BlogCacheService } from './services/blog-cache.js';
+import { BlogSettingsResolver, } from './services/blog-settings-resolver.js';
+import { BlogCategoryService } from './services/blog-category-service.js';
+import { BlogPostService } from './services/blog-post-service.js';
+import { BlogTagService } from './services/blog-tag-service.js';
+import { BlogStorefrontResolver, } from './services/blog-storefront-resolver.js';
+import { registerBlogAssetReferences } from './services/blog-asset-references.js';
+import { seedDefaultCategory } from './services/seed-default-category.js';
+import { seedBlogRoles } from './services/seed-roles.js';
+import { registerBlogAdminRoutes } from './routes.admin.js';
+import { registerBlogStorefrontRoutes } from './routes.storefront.js';
+import { registerBlogLanguageReferences } from './services/blog-language-reference.js';
+import { BlogCategory } from './entities/blog-category.entity.js';
+import { BlogCategoryLanguage } from './entities/blog-category-language.entity.js';
+import { BlogCategorySalesChannel } from './entities/blog-category-sales-channel.entity.js';
+import { BlogPost } from './entities/blog-post.entity.js';
+import { BlogPostCategory } from './entities/blog-post-category.entity.js';
+import { BlogPostLanguage } from './entities/blog-post-language.entity.js';
+import { BlogPostRelatedPost } from './entities/blog-post-related-post.entity.js';
+import { BlogPostRelatedProduct } from './entities/blog-post-related-product.entity.js';
+import { BlogPostSalesChannel } from './entities/blog-post-sales-channel.entity.js';
+import { BlogPostTag } from './entities/blog-post-tag.entity.js';
+import { BlogTag } from './entities/blog-tag.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        // Singletons, matching what the composition root constructed once at boot.
+        // They take `emFactory` rather than an `EntityManager`, so a single
+        // instance is correct in every request and every job: the fork happens per
+        // call and the tenant filter reads the ambient context at query time.
+        blogCacheService: ctx
+            .asFunction(({ redis }) => redis ? new BlogCacheService(redis, {}) : undefined)
+            .singleton(),
+        blogSettingsResolver: ctx
+            .asFunction(() => new BlogSettingsResolver(lazyPort(ctx, 'settingsReadPort')))
+            .singleton(),
+        blogPostService: ctx
+            .asFunction(({ emFactory, blogCacheService }) => new BlogPostService(emFactory, blogCacheService, lazyPort(ctx, 'dictionaryValidator')))
+            .singleton(),
+        blogCategoryService: ctx
+            .asFunction(({ emFactory, blogCacheService }) => new BlogCategoryService(emFactory, blogCacheService, lazyPort(ctx, 'dictionaryValidator')))
+            .singleton(),
+        blogTagService: ctx
+            .asFunction(({ emFactory, blogCacheService }) => new BlogTagService(emFactory, blogCacheService))
+            .singleton(),
+        blogStorefrontResolver: ctx
+            .asFunction(({ emFactory, blogSettingsResolver, blogStorefrontDeps, blogCacheService }) => new BlogStorefrontResolver(emFactory, blogSettingsResolver, blogStorefrontDeps ?? {}, blogCacheService))
+            .singleton(),
+    });
+    ctx.routes(async (app) => {
+        const { blogPostService, blogCategoryService, blogTagService, requireAdmin } = ctx.cradle();
+        await registerBlogAdminRoutes(app, {
+            postService: blogPostService,
+            categoryService: blogCategoryService,
+            tagService: blogTagService,
+            ...(requireAdmin ? { requireAdmin } : {}),
+        });
+    });
+    ctx.routes(async (app) => {
+        const { blogStorefrontResolver } = ctx.cradle();
+        await registerBlogStorefrontRoutes(app, { storefrontResolver: blogStorefrontResolver });
+    });
+    // R9 — a `blog.*` settings write wipes the storefront blog cache, so the next
+    // read picks up the new value.
+    ctx.subscribe('settings.value_changed', async (payload) => {
+        const code = payload?.settingCode;
+        if (code === undefined || !code.startsWith('blog.'))
+            return;
+        await ctx.cradle().blogCacheService?.invalidateAll();
+    });
+    /**
+     * The two asset-reference edges, contributed **unprobed** (D-68).
+     *
+     * Registered before any blog write can happen, so the Library's soft-delete
+     * path sees them from the first request on — and it keeps seeing them while
+     * `blog` is switched off, deliberately. `assets_library` consults the registry
+     * to refuse deleting an asset something still points at, and a deactivated
+     * module's posts and categories still embed assets: probing here would let an
+     * operator delete an asset a deactivated post references, and the damage would
+     * only surface as a broken image when `blog` comes back on. Off is meant to be
+     * non-destructive and reversible (Constitution XVII), which is why the
+     * registry's own enumeration policy is `honoured` rather than `skip` for these
+     * descriptors — a scanner is integrity, not a surface.
+     *
+     * A second hook rather than a line in the one below, because the two answer
+     * different questions: this one must run whatever the module's state, that one
+     * must not run while it is off. `product_feeds/backend.ts` is the shipped
+     * example of the same pair.
+     */
+    ctx.onBoot(() => {
+        const { assetReferenceRegistry, emFactory } = ctx.cradle();
+        registerBlogAssetReferences(assetReferenceRegistry, emFactory);
+    });
+    // Idempotent boot reconcilers (R11 / R8): on a rerun they preserve every
+    // admin edit and only fill in what is missing.
+    ctx.onBoot(async () => {
+        // Presence is decided here — first, and outside anything that could catch it
+        // (issue #146, D-68). These two seeds write rows: a category and two roles.
+        // A switched-off module writing at every boot is "behaves as if never
+        // installed" failing, and a boot hook has no caller to answer, so the
+        // question is asked rather than thrown. `runBootHooks` re-throws as
+        // `ModuleCompositionError`, which `index.ts` turns into `process.exit(1)`.
+        if (!effectiveState.isPresent('blog'))
+            return;
+        const { emFactory } = ctx.cradle();
+        await seedDefaultCategory(emFactory);
+        // Two ports into `admin_roles`, and they are different kinds of seam.
+        //
+        // `adminRolePort` is a **call**: it is where the two role rows are written
+        // since feature 075 drained this module's cross-module-import shard, in
+        // place of three raw SQL statements against `admin_roles`' own table. It is
+        // gated, so the seam fails closed — but `admin_roles` declares itself
+        // non-deactivatable, so the state that gate answers "no" in is one an
+        // operator cannot reach: the only way this composition runs without it is a
+        // deployment that never shipped it, and `composeModules` refuses that
+        // before the first module registers. Resolving it here rather than in a
+        // factory keeps it lazy, so composition asks the gate nothing.
+        //
+        // `systemRoleCodePort` is `admin_roles`' ungated contribution registry, so
+        // resolving it asks no gate at all — the probe above is this module's own
+        // answer about its own seeds, not a question about either seam's owner.
+        await seedBlogRoles(lazyPort(ctx, 'adminRolePort'), lazyPort(ctx, 'systemRoleCodePort'));
+    });
+    /**
+     * This module's rows carry a language code, so it answers "who still points at
+     * this language?" about its own tables (feature 077, D-87), where the owner used
+     * to count them with SQL naming this module's tables.
+     *
+     * A **contribution** hook: it pushes an inert descriptor into `languageReferenceRegistry`,
+     * an ungated registry, and carries no presence probe (D-62/D-68). Probing
+     * would be wrong in the dangerous direction — a switched-off module still owns
+     * the rows, so its language must still refuse the delete, which is the
+     * enumeration policy the registry states.
+     */
+    ctx.onBoot(() => {
+        registerBlogLanguageReferences(lazyPort(ctx, 'languageReferenceRegistry'), ctx.cradle().emFactory);
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform already reads, in two places: the boot-time
+ * loader (`src/packages/package-runtime.ts`, `exported['entities']`) and the
+ * static declaration reader (`scripts/lib/package-declarations.ts`), which is
+ * the third source of the `table→owner` map and the package pass of
+ * `check-entity-tenant-classification`. Until D-168 this file published eleven
+ * `export *` lines instead, which satisfied only the committed host registry —
+ * the one path that stops being taken the day this module is *installed*
+ * rather than linked, at which point the loader read `undefined`, returned
+ * `[]`, and registered zero entities without a word.
+ *
+ * The absence of a named export is the load-bearing half. With it,
+ * `import type { BlogPost } from '@endora-commerce/mod-blog/backend'` compiles
+ * in any consumer — ours, a deployment's, a stranger's — and only a check whose
+ * population is *this* repository could ever object. Without it, that import is
+ * TS2305 in the consumer's own tree, which is Principle I holding by
+ * construction. Nothing legitimate is lost: D-32 already forbids an ORM
+ * relation from another module into these classes, and every other cross-module
+ * read goes through a contract type. An `EntityClassLike[]` is a value the
+ * host's ORM registers and nothing else can usefully name.
+ *
+ * Identity matters more here than anywhere else in the package: MikroORM keys
+ * its metadata on the class, so a consumer that reached these files by a second
+ * specifier would register a second `BlogPost` and lose one of them at
+ * discovery (D-160.6, measured). One array behind one declared subpath is the
+ * only way in.
+ */
+export const entities = [
+    BlogCategory,
+    BlogCategoryLanguage,
+    BlogCategorySalesChannel,
+    BlogPost,
+    BlogPostCategory,
+    BlogPostLanguage,
+    BlogPostRelatedPost,
+    BlogPostRelatedProduct,
+    BlogPostSalesChannel,
+    BlogPostTag,
+    BlogTag,
+];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

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

package/dist/backend/routes.admin.d.ts

@@ -0,0 +1,12 @@
+import type { FastifyInstance } from 'fastify';
+import type { BlogCategoryService } from './services/blog-category-service.js';
+import type { BlogPostService } from './services/blog-post-service.js';
+import type { BlogTagService } from './services/blog-tag-service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export declare function registerBlogAdminRoutes(app: FastifyInstance, deps: {
+    postService: BlogPostService;
+    categoryService: BlogCategoryService;
+    tagService: BlogTagService;
+    requireAdmin?: RequireAdminFactory;
+}): Promise<void>;
+//# sourceMappingURL=routes.admin.d.ts.map

package/dist/backend/routes.admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.d.ts","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAgB/C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AACvE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AA2C5E,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IACJ,WAAW,EAAE,eAAe,CAAC;IAC7B,eAAe,EAAE,mBAAmB,CAAC;IACrC,UAAU,EAAE,cAAc,CAAC;IAC3B,YAAY,CAAC,EAAE,mBAAmB,CAAC;CACpC,GACA,OAAO,CAAC,IAAI,CAAC,CA6Of"}

package/dist/backend/routes.admin.js

@@ -0,0 +1,148 @@
+import { createBlogCategoryRequestSchema, createBlogPostRequestSchema, createBlogTagRequestSchema, patchBlogCategoryRequestSchema, patchBlogPostRequestSchema, patchBlogTagRequestSchema, putBlogCategoryDescriptionRequestSchema, putBlogCategoryTreeMovesRequestSchema, putBlogPostContentRequestSchema, setBlogPostRelatedPostsRequestSchema, setBlogPostRelatedProductsRequestSchema, setBlogPostTagsRequestSchema, } from '@endora-commerce/contracts';
+import { z } from 'zod';
+const versionOnlySchema = z.object({ version: z.number().int() });
+const versionQuerySchema = z.object({
+    version: z.coerce.number().int().optional(),
+});
+/**
+ * DELETE doesn't carry a body (Fetch API limitation in some browsers),
+ * so the admin client can pass version as a query parameter. The backend
+ * accepts either form: body wins when present, query is the fallback.
+ */
+function readDeleteVersion(body, query) {
+    if (body && typeof body === 'object') {
+        const bv = body.version;
+        if (typeof bv === 'number')
+            return bv;
+    }
+    const q = versionQuerySchema.safeParse(query ?? {});
+    if (q.success)
+        return q.data.version;
+    return undefined;
+}
+const listFiltersSchema = z.object({
+    q: z.string().optional(),
+    status: z.enum(['draft', 'published', 'archived']).optional(),
+    salesChannelId: z.string().uuid().optional(),
+    categoryId: z.string().uuid().optional(),
+    tagId: z.string().uuid().optional(),
+    language: z.string().min(2).optional(),
+    page: z.coerce.number().int().positive().optional(),
+    perPage: z.coerce.number().int().positive().max(100).optional(),
+});
+const tagListFiltersSchema = z.object({
+    q: z.string().optional(),
+    page: z.coerce.number().int().positive().optional(),
+    perPage: z.coerce.number().int().positive().max(100).optional(),
+});
+export async function registerBlogAdminRoutes(app, deps) {
+    const requireRead = deps.requireAdmin?.('blog.read') ?? (async () => { });
+    const requireWrite = deps.requireAdmin?.('blog.write') ?? (async () => { });
+    // ── Posts ──────────────────────────────────────────────────────────
+    app.get('/api/v1/admin/blog/posts', { preHandler: requireRead }, async (request) => {
+        const filters = listFiltersSchema.parse(request.query ?? {});
+        return deps.postService.list(filters);
+    });
+    app.post('/api/v1/admin/blog/posts', { preHandler: requireWrite }, async (request, reply) => {
+        const body = createBlogPostRequestSchema.parse(request.body);
+        const created = await deps.postService.create(body);
+        return reply.code(201).send({ data: created });
+    });
+    app.get('/api/v1/admin/blog/posts/:id', { preHandler: requireRead }, async (request) => ({ data: await deps.postService.getById(request.params.id) }));
+    app.patch('/api/v1/admin/blog/posts/:id', { preHandler: requireWrite }, async (request) => {
+        const body = patchBlogPostRequestSchema.parse(request.body);
+        return { data: await deps.postService.patch(request.params.id, body) };
+    });
+    app.put('/api/v1/admin/blog/posts/:id/content', { preHandler: requireWrite }, async (request) => {
+        const body = putBlogPostContentRequestSchema.parse(request.body);
+        return { data: await deps.postService.setContent(request.params.id, body) };
+    });
+    app.put('/api/v1/admin/blog/posts/:id/tags', { preHandler: requireWrite }, async (request) => {
+        const body = setBlogPostTagsRequestSchema.parse(request.body);
+        return {
+            data: await deps.postService.setTags(request.params.id, body.tagIds, body.version),
+        };
+    });
+    app.put('/api/v1/admin/blog/posts/:id/related-posts', { preHandler: requireWrite }, async (request) => {
+        const body = setBlogPostRelatedPostsRequestSchema.parse(request.body);
+        return {
+            data: await deps.postService.setRelatedPosts(request.params.id, body.relatedPostIds, body.version),
+        };
+    });
+    app.put('/api/v1/admin/blog/posts/:id/related-products', { preHandler: requireWrite }, async (request) => {
+        const body = setBlogPostRelatedProductsRequestSchema.parse(request.body);
+        return {
+            data: await deps.postService.setRelatedProducts(request.params.id, body.productIds, body.version),
+        };
+    });
+    app.post('/api/v1/admin/blog/posts/:id/publish', { preHandler: requireWrite }, async (request) => {
+        const body = versionOnlySchema.parse(request.body ?? {});
+        return { data: await deps.postService.publish(request.params.id, body.version) };
+    });
+    app.post('/api/v1/admin/blog/posts/:id/unpublish', { preHandler: requireWrite }, async (request) => {
+        const body = versionOnlySchema.parse(request.body ?? {});
+        return { data: await deps.postService.unpublish(request.params.id, body.version) };
+    });
+    app.post('/api/v1/admin/blog/posts/:id/archive', { preHandler: requireWrite }, async (request) => {
+        const body = versionOnlySchema.parse(request.body ?? {});
+        return { data: await deps.postService.archive(request.params.id, body.version) };
+    });
+    app.delete('/api/v1/admin/blog/posts/:id', { preHandler: requireWrite }, async (request, reply) => {
+        const version = readDeleteVersion(request.body, request.query) ??
+            versionOnlySchema.parse(request.body ?? { version: 0 }).version;
+        const result = await deps.postService.softDelete(request.params.id, version);
+        return reply.code(200).send({ data: result });
+    });
+    app.get('/api/v1/admin/blog/posts/:id/inbound-references', { preHandler: requireRead }, async (request) => ({
+        data: await deps.postService.getInboundReferences(request.params.id),
+    }));
+    // ── Categories ─────────────────────────────────────────────────────
+    app.get('/api/v1/admin/blog/categories', { preHandler: requireRead }, async () => deps.categoryService.getTree());
+    app.get('/api/v1/admin/blog/categories/:id', { preHandler: requireRead }, async (request) => ({ data: await deps.categoryService.getById(request.params.id) }));
+    app.post('/api/v1/admin/blog/categories', { preHandler: requireWrite }, async (request, reply) => {
+        const body = createBlogCategoryRequestSchema.parse(request.body);
+        const created = await deps.categoryService.create(body);
+        return reply.code(201).send({ data: created });
+    });
+    app.patch('/api/v1/admin/blog/categories/:id', { preHandler: requireWrite }, async (request) => {
+        const body = patchBlogCategoryRequestSchema.parse(request.body);
+        return { data: await deps.categoryService.patch(request.params.id, body) };
+    });
+    app.put('/api/v1/admin/blog/categories/:id/description', { preHandler: requireWrite }, async (request) => {
+        const body = putBlogCategoryDescriptionRequestSchema.parse(request.body);
+        return { data: await deps.categoryService.setDescription(request.params.id, body) };
+    });
+    app.put('/api/v1/admin/blog/categories/tree', { preHandler: requireWrite }, async (request) => {
+        const body = putBlogCategoryTreeMovesRequestSchema.parse(request.body);
+        return await deps.categoryService.applyTreeMoves(body.moves);
+    });
+    app.delete('/api/v1/admin/blog/categories/:id', { preHandler: requireWrite }, async (request, reply) => {
+        const version = readDeleteVersion(request.body, request.query);
+        await deps.categoryService.softDelete(request.params.id, version);
+        return reply.code(204).send();
+    });
+    // ── Tags ───────────────────────────────────────────────────────────
+    app.get('/api/v1/admin/blog/tags', { preHandler: requireRead }, async (request) => {
+        const filters = tagListFiltersSchema.parse(request.query ?? {});
+        return deps.tagService.list(filters);
+    });
+    app.get('/api/v1/admin/blog/tags/:id', { preHandler: requireRead }, async (request) => ({ data: await deps.tagService.getById(request.params.id) }));
+    app.post('/api/v1/admin/blog/tags', { preHandler: requireWrite }, async (request, reply) => {
+        const body = createBlogTagRequestSchema.parse(request.body);
+        const created = await deps.tagService.create(body);
+        return reply.code(201).send({ data: created });
+    });
+    app.patch('/api/v1/admin/blog/tags/:id', { preHandler: requireWrite }, async (request) => {
+        const body = patchBlogTagRequestSchema.parse(request.body);
+        return { data: await deps.tagService.patch(request.params.id, body) };
+    });
+    app.delete('/api/v1/admin/blog/tags/:id', { preHandler: requireWrite }, async (request, reply) => {
+        const version = readDeleteVersion(request.body, request.query);
+        await deps.tagService.softDelete(request.params.id, version);
+        return reply.code(204).send();
+    });
+    app.get('/api/v1/admin/blog/tags/:id/inbound-references', { preHandler: requireRead }, async (request) => ({
+        data: await deps.tagService.getInboundReferences(request.params.id),
+    }));
+}
+//# sourceMappingURL=routes.admin.js.map

package/dist/backend/routes.admin.js.map

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

package/dist/backend/routes.storefront.d.ts

@@ -0,0 +1,6 @@
+import type { FastifyInstance } from 'fastify';
+import type { BlogStorefrontResolver } from './services/blog-storefront-resolver.js';
+export declare function registerBlogStorefrontRoutes(app: FastifyInstance, deps: {
+    storefrontResolver: BlogStorefrontResolver;
+}): Promise<void>;
+//# sourceMappingURL=routes.storefront.d.ts.map

package/dist/backend/routes.storefront.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.d.ts","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAkB,MAAM,SAAS,CAAC;AAK/D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAYrF,wBAAsB,4BAA4B,CAChD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE;IAAE,kBAAkB,EAAE,sBAAsB,CAAA;CAAE,GACnD,OAAO,CAAC,IAAI,CAAC,CAgDf"}

package/dist/backend/routes.storefront.js

@@ -0,0 +1,72 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { z } from 'zod';
+import { HttpError } from '@endora-commerce/platform/http';
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+const bySlugQuerySchema = z.object({
+    slug: z.string().min(1).max(160),
+    page: z.coerce.number().int().positive().optional(),
+});
+const tagByCodeQuerySchema = z.object({
+    code: z.string().min(1).max(64),
+    page: z.coerce.number().int().positive().optional(),
+});
+export async function registerBlogStorefrontRoutes(app, deps) {
+    app.get('/api/v1/blog/by-channel', async (request) => {
+        const { language } = readContext(request);
+        const resolved = await deps.storefrontResolver.getIndex({
+            resolvedChannel: resolvedChannel(request),
+            ...(language !== undefined ? { language } : {}),
+        });
+        if (!resolved) {
+            throw new HttpError(404, ERROR_CODES.BLOG_DISABLED, 'Blog is disabled or not configured.');
+        }
+        return { data: resolved };
+    });
+    app.get('/api/v1/blog/by-slug', async (request) => {
+        const query = bySlugQuerySchema.parse(request.query ?? {});
+        const { language } = readContext(request);
+        const resolved = await deps.storefrontResolver.getBySlug(query.slug, {
+            resolvedChannel: resolvedChannel(request),
+            ...(language !== undefined ? { language } : {}),
+            ...(query.page !== undefined ? { page: query.page } : {}),
+        });
+        if (!resolved) {
+            throw new HttpError(404, ERROR_CODES.BLOG_POST_NOT_FOUND, 'No blog Post or Category at that slug, or the blog is disabled in this scope.');
+        }
+        return { data: resolved };
+    });
+    app.get('/api/v1/blog/tag-by-code', async (request) => {
+        const query = tagByCodeQuerySchema.parse(request.query ?? {});
+        const { language } = readContext(request);
+        const resolved = await deps.storefrontResolver.getTagByCode(query.code, {
+            resolvedChannel: resolvedChannel(request),
+            ...(language !== undefined ? { language } : {}),
+            ...(query.page !== undefined ? { page: query.page } : {}),
+        });
+        if (!resolved) {
+            throw new HttpError(404, ERROR_CODES.BLOG_TAG_NOT_FOUND, 'No blog Tag at that code, or the blog is disabled in this scope.');
+        }
+        return { data: resolved };
+    });
+}
+function readContext(request) {
+    const headers = request.headers;
+    const language = readHeader(headers['x-blog-language']) ??
+        readHeader(headers['accept-language'])?.split(',')[0]?.trim();
+    return { language };
+}
+/**
+ * Read the sales channel already resolved by the sales-channel resolver
+ * middleware for this request. Feature 053: routes no longer re-parse the
+ * `x-sales-channel` header nor re-query `sales_channels`.
+ */
+function resolvedChannel(request) {
+    const ch = getResolvedChannel(request);
+    return { id: ch.id, code: ch.code, defaultLanguage: ch.defaultLanguage };
+}
+function readHeader(value) {
+    if (Array.isArray(value))
+        return value[0];
+    return value;
+}
+//# sourceMappingURL=routes.storefront.js.map

package/dist/backend/routes.storefront.js.map

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

package/dist/backend/services/blog-asset-references.d.ts

@@ -0,0 +1,4 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { AssetReferenceRegistryPort } from '@endora-commerce/contracts';
+export declare function registerBlogAssetReferences(registry: AssetReferenceRegistryPort, emFactory: () => EntityManager): void;
+//# sourceMappingURL=blog-asset-references.d.ts.map

package/dist/backend/services/blog-asset-references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-asset-references.d.ts","sourceRoot":"","sources":["../../../src/backend/services/blog-asset-references.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAGV,0BAA0B,EAC3B,MAAM,4BAA4B,CAAC;AAEpC,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,0BAA0B,EACpC,SAAS,EAAE,MAAM,aAAa,GAC7B,IAAI,CAGN"}

package/dist/backend/services/blog-asset-references.js

@@ -0,0 +1,79 @@
+// Blog → AssetReferenceRegistry descriptor — feature 016 / T018.
+//
+// Registers two reference edges with the Library Asset reference registry
+// so the Library's soft-delete path (feature 013 / FR-030) blocks deletion
+// of any asset still pointed at by:
+//
+//   - blog_categories.main_image_asset_id    (column-level reference)
+//   - jsonb references inside blog_posts.content or
+//     blog_categories.description (Page Builder asset embeds)
+//
+// The jsonb edge uses `jsonb_path_exists` driven by the GIN index
+// `idx_blog_posts_content_refs` and the matching index on
+// `blog_categories.description` (created via the GIN's content path).
+export function registerBlogAssetReferences(registry, emFactory) {
+    registry.register(blogMainImageReferenceDescriptor(emFactory));
+    registry.register(blogContentTreeReferenceDescriptor(emFactory));
+}
+function blogMainImageReferenceDescriptor(emFactory) {
+    return {
+        ownerModuleId: 'blog',
+        async findReferences(assetIds) {
+            if (assetIds.length === 0)
+                return [];
+            const em = emFactory();
+            const placeholders = assetIds.map(() => '?').join(', ');
+            const rows = (await em.execute(`select id::text as id, slug
+           from blog_categories
+          where main_image_asset_id in (${placeholders})
+            and deleted_at is null`, [...assetIds]));
+            return rows.map((r) => ({
+                kind: 'blog_category_main_image',
+                entityId: r.id,
+                label: `Blog category "${r.slug}"`,
+            }));
+        },
+    };
+}
+function blogContentTreeReferenceDescriptor(emFactory) {
+    return {
+        ownerModuleId: 'blog',
+        async findReferences(assetIds) {
+            if (assetIds.length === 0)
+                return [];
+            const em = emFactory();
+            const out = [];
+            for (const aidRaw of assetIds) {
+                // The asset id is a UUID; this regex is a defensive pre-filter to
+                // keep the literal-injected jsonpath safe (the same idiom feature
+                // 014's CMS asset-references uses).
+                const aid = aidRaw.replace(/[^0-9a-fA-F-]/g, '');
+                const path = `'$.** ? (@ == "${aid}")'::jsonpath`;
+                const rows = (await em.execute(`select id::text as id, slug, 'blog_post' as kind
+             from blog_posts
+            where deleted_at is null
+              and jsonb_path_exists(content, ${path})
+           union all
+           select id::text as id, slug, 'blog_category' as kind
+             from blog_categories
+            where deleted_at is null
+              and description is not null
+              and jsonb_path_exists(description, ${path})`));
+                for (const r of rows) {
+                    const label = r.kind === 'blog_post'
+                        ? `Blog post "${r.slug}"`
+                        : `Blog category description "${r.slug}"`;
+                    out.push({
+                        kind: r.kind === 'blog_post'
+                            ? 'blog_post_content'
+                            : 'blog_category_description',
+                        entityId: r.id,
+                        label,
+                    });
+                }
+            }
+            return out;
+        },
+    };
+}
+//# sourceMappingURL=blog-asset-references.js.map

package/dist/backend/services/blog-asset-references.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-asset-references.js","sourceRoot":"","sources":["../../../src/backend/services/blog-asset-references.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,0EAA0E;AAC1E,2EAA2E;AAC3E,oCAAoC;AACpC,EAAE;AACF,sEAAsE;AACtE,oDAAoD;AACpD,8DAA8D;AAC9D,EAAE;AACF,kEAAkE;AAClE,0DAA0D;AAC1D,sEAAsE;AAStE,MAAM,UAAU,2BAA2B,CACzC,QAAoC,EACpC,SAA8B;IAE9B,QAAQ,CAAC,QAAQ,CAAC,gCAAgC,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/D,QAAQ,CAAC,QAAQ,CAAC,kCAAkC,CAAC,SAAS,CAAC,CAAC,CAAC;AACnE,CAAC;AAED,SAAS,gCAAgC,CACvC,SAA8B;IAE9B,OAAO;QACL,aAAa,EAAE,MAAM;QACrB,KAAK,CAAC,cAAc,CAAC,QAAkB;YACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;YACvB,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAC5B;;0CAEkC,YAAY;mCACnB,EAC3B,CAAC,GAAG,QAAQ,CAAC,CACd,CAAwC,CAAC;YAC1C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACtB,IAAI,EAAE,0BAA0B;gBAChC,QAAQ,EAAE,CAAC,CAAC,EAAE;gBACd,KAAK,EAAE,kBAAkB,CAAC,CAAC,IAAI,GAAG;aACnC,CAAC,CAAC,CAAC;QACN,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,kCAAkC,CACzC,SAA8B;IAE9B,OAAO;QACL,aAAa,EAAE,MAAM;QACrB,KAAK,CAAC,cAAc,CAAC,QAAkB;YACrC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;YACrC,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;YACvB,MAAM,GAAG,GAAqB,EAAE,CAAC;YACjC,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE,CAAC;gBAC9B,kEAAkE;gBAClE,kEAAkE;gBAClE,oCAAoC;gBACpC,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;gBACjD,MAAM,IAAI,GAAG,kBAAkB,GAAG,eAAe,CAAC;gBAElD,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAC5B;;;+CAGqC,IAAI;;;;;;mDAMA,IAAI,GAAG,CACjD,CAAsD,CAAC;gBAExD,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;oBACrB,MAAM,KAAK,GACT,CAAC,CAAC,IAAI,KAAK,WAAW;wBACpB,CAAC,CAAC,cAAc,CAAC,CAAC,IAAI,GAAG;wBACzB,CAAC,CAAC,8BAA8B,CAAC,CAAC,IAAI,GAAG,CAAC;oBAC9C,GAAG,CAAC,IAAI,CAAC;wBACP,IAAI,EACF,CAAC,CAAC,IAAI,KAAK,WAAW;4BACpB,CAAC,CAAC,mBAAmB;4BACrB,CAAC,CAAC,2BAA2B;wBACjC,QAAQ,EAAE,CAAC,CAAC,EAAE;wBACd,KAAK;qBACN,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/services/blog-cache.d.ts

@@ -0,0 +1,55 @@
+import type { Redis } from 'ioredis';
+/**
+ * Storefront read-through cache for the Blog module — feature 016 / T020.
+ *
+ * Mirrors feature 014's `CmsCache` and feature 015's `MegamenuCache` shape
+ * exactly: same key-prefix scheme, same default TTL, same SCAN-based
+ * coarse invalidation. Keys live under `blog:v1:<channelCode>:<language>`.
+ *
+ * Per `research.md` § R9 the cache holds four kinds of entry:
+ *
+ *   blog:v1:<channel>:<language>:index
+ *   blog:v1:<channel>:<language>:category:<slug>:p<page>
+ *   blog:v1:<channel>:<language>:post:<slug>
+ *   blog:v1:<channel>:<language>:tag:<code>:p<page>
+ *
+ * Invalidation is per-write (publishing a Post invalidates that post's
+ * key, every category page that contained it, every tag page that
+ * contained it, and the index for every channel the post is in). Settings
+ * writes invalidate the whole channel keyspace via `invalidateChannel`.
+ */
+export declare const BLOG_CACHE_KEY_PREFIX = "blog:v1:";
+export declare const BLOG_CACHE_DEFAULT_TTL_SECONDS: number;
+export interface BlogCacheOptions {
+    ttlSeconds?: number;
+    /** When false, get/set are short-circuit no-ops (useful for tests). */
+    enabled?: boolean;
+}
+export declare class BlogCacheService {
+    private readonly redis;
+    private readonly ttlSeconds;
+    private readonly enabled;
+    constructor(redis: Redis, options?: BlogCacheOptions);
+    static composeIndexKey(channelCode: string, language: string): string;
+    static composeCategoryKey(channelCode: string, language: string, slug: string, page: number): string;
+    static composePostKey(channelCode: string, language: string, slug: string): string;
+    static composeTagKey(channelCode: string, language: string, code: string, page: number): string;
+    get<T>(key: string): Promise<T | null>;
+    set<T>(key: string, payload: T): Promise<void>;
+    /** Drop one key (used after the post-by-slug write). */
+    invalidateKey(key: string): Promise<void>;
+    /** Drop every key under a channel + language scope. */
+    invalidateScope(channelCode: string, language: string): Promise<void>;
+    /** Drop every key under a channel (covers every language). Used on settings writes. */
+    invalidateChannel(channelCode: string): Promise<void>;
+    /** Drop the entire blog keyspace. Used by tests and by global config changes. */
+    invalidateAll(): Promise<void>;
+    /** Drop every entry that mentions a specific category slug across every language of a channel. */
+    invalidateCategory(channelCode: string, slug: string): Promise<void>;
+    /** Drop every entry that mentions a specific post slug across every language of a channel. */
+    invalidatePost(channelCode: string, slug: string): Promise<void>;
+    /** Drop every entry that mentions a specific tag code across every language of a channel. */
+    invalidateTag(channelCode: string, code: string): Promise<void>;
+    private scanDelete;
+}
+//# sourceMappingURL=blog-cache.d.ts.map

package/dist/backend/services/blog-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blog-cache.d.ts","sourceRoot":"","sources":["../../../src/backend/services/blog-cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAErC;;;;;;;;;;;;;;;;;;GAkBG;AAEH,eAAO,MAAM,qBAAqB,aAAa,CAAC;AAChD,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uEAAuE;IACvE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAMD,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,KAAK;IAHlC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAU;gBAEL,KAAK,EAAE,KAAK,EAAE,OAAO,GAAE,gBAAqB;IAKzE,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM;IAIrE,MAAM,CAAC,kBAAkB,CACvB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM;IAIT,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM;IAIlF,MAAM,CAAC,aAAa,CAClB,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,MAAM;IAIH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAYtC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,wDAAwD;IAClD,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK/C,uDAAuD;IACjD,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3E,uFAAuF;IACjF,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,iFAAiF;IAC3E,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC,kGAAkG;IAC5F,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1E,8FAA8F;IACxF,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQtE,6FAA6F;IACvF,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAIvD,UAAU;CASzB"}