@endora-commerce/mod-blog 0.100.0

package/dist/migrations/20260506T081055_blog_init.js

@@ -0,0 +1,260 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Blog module — feature 016 / data-model.md.
+ *
+ * Schema changes (one atomic migration):
+ *   - new tables: blog_categories + blog_category_sales_channels +
+ *     blog_category_languages + blog_posts + blog_post_sales_channels +
+ *     blog_post_languages + blog_post_categories + blog_post_tags +
+ *     blog_post_related_posts + blog_post_related_products + blog_tags.
+ *   - GIN index on blog_posts.content (jsonb_path_ops) so the asset-reference
+ *     scan stays fast (R13).
+ *   - btree index on blog_posts(status, published_at DESC) drives the
+ *     storefront's "newest first" listing.
+ *   - btree index on blog_categories(parent_id, position) drives the
+ *     per-tree fetch.
+ *   - PARTIAL unique indexes on blog_post_sales_channels(sales_channel_id,
+ *     slug) WHERE deleted_at IS NULL and the analogous one on
+ *     blog_category_sales_channels — defensive guards for the cross-table
+ *     uniqueness contract documented in research.md § R3 (the cross-table
+ *     check itself runs at the service layer with a pg_advisory_xact_lock).
+ *   - PARTIAL unique on blog_tags(code) WHERE deleted_at IS NULL — global
+ *     tag-code uniqueness (R14).
+ *
+ * No seed rows; the seeded `Default` Category and the two seeded admin
+ * roles are inserted by runtime reconcilers in `services/seed-default-
+ * category.ts` and `services/seed-roles.ts` so admin edits across deploys
+ * stay safe (R8 + R11).
+ */
+export class Migration20260506T081055BlogInit extends Migration {
+    async up() {
+        // ────────────────────────────────────────────────────────────────────
+        // 1) blog_categories — adjacency-list tree
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_categories" (
+        "id" uuid not null,
+        "parent_id" uuid null,
+        "position" int not null default 0,
+        "name" jsonb not null default '{}'::jsonb,
+        "slug" varchar(160) not null,
+        "enabled" boolean not null default true,
+        "description" jsonb null,
+        "main_image_asset_id" uuid null,
+        "meta_title" jsonb null,
+        "meta_description" jsonb null,
+        "meta_keywords" jsonb null,
+        "is_system" boolean not null default false,
+        "version" int not null default 1,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        "deleted_at" timestamptz null,
+        constraint "blog_categories_pkey" primary key ("id"),
+        constraint "blog_categories_parent_fk" foreign key ("parent_id")
+          references "blog_categories" ("id") on delete no action,
+        constraint "blog_categories_main_image_fk" foreign key ("main_image_asset_id")
+          references "assets" ("id") on delete no action
+      );
+    `);
+        this.addSql('create index "idx_blog_categories_parent_position" on "blog_categories" ("parent_id", "position");');
+        this.addSql('create index "idx_blog_categories_main_image_asset" on "blog_categories" ("main_image_asset_id");');
+        this.addSql('create index "idx_blog_categories_is_system" on "blog_categories" ("is_system");');
+        this.addSql('create index "idx_blog_categories_deleted_at" on "blog_categories" ("deleted_at");');
+        // ────────────────────────────────────────────────────────────────────
+        // 2) blog_category_sales_channels (M2M + denormalised slug + deleted_at)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_category_sales_channels" (
+        "blog_category_id" uuid not null,
+        "sales_channel_id" uuid not null,
+        "slug" varchar(160) not null,
+        "deleted_at" timestamptz null,
+        constraint "blog_category_sales_channels_pkey"
+          primary key ("blog_category_id", "sales_channel_id"),
+        constraint "blog_category_sales_channels_category_fk" foreign key ("blog_category_id")
+          references "blog_categories" ("id") on delete cascade,
+        constraint "blog_category_sales_channels_channel_fk" foreign key ("sales_channel_id")
+          references "sales_channels" ("id") on delete cascade
+      );
+    `);
+        this.addSql(`create unique index "idx_blog_categories_slug_per_channel_uniq"
+         on "blog_category_sales_channels" ("sales_channel_id", "slug")
+         where "deleted_at" is null;`);
+        // ────────────────────────────────────────────────────────────────────
+        // 3) blog_category_languages (M2M)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_category_languages" (
+        "blog_category_id" uuid not null,
+        "language" varchar(8) not null,
+        constraint "blog_category_languages_pkey"
+          primary key ("blog_category_id", "language"),
+        constraint "blog_category_languages_category_fk" foreign key ("blog_category_id")
+          references "blog_categories" ("id") on delete cascade
+      );
+    `);
+        // ────────────────────────────────────────────────────────────────────
+        // 4) blog_posts
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_posts" (
+        "id" uuid not null,
+        "name" jsonb not null default '{}'::jsonb,
+        "slug" varchar(160) not null,
+        "active" boolean not null default true,
+        "status" varchar(16) not null default 'draft',
+        "published_at" timestamptz null,
+        "description" text null,
+        "meta_title" jsonb null,
+        "meta_description" jsonb null,
+        "meta_keywords" jsonb null,
+        "content" jsonb not null default '{}'::jsonb,
+        "version" int not null default 1,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        "deleted_at" timestamptz null,
+        constraint "blog_posts_pkey" primary key ("id")
+      );
+    `);
+        this.addSql(`create index "idx_blog_posts_status_published_at"
+         on "blog_posts" ("status", "published_at" desc);`);
+        this.addSql('create index "idx_blog_posts_deleted_at" on "blog_posts" ("deleted_at");');
+        this.addSql(`create index "idx_blog_posts_content_refs"
+         on "blog_posts" using gin ("content" jsonb_path_ops);`);
+        // ────────────────────────────────────────────────────────────────────
+        // 5) blog_post_sales_channels (M2M + denormalised slug + deleted_at)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_post_sales_channels" (
+        "blog_post_id" uuid not null,
+        "sales_channel_id" uuid not null,
+        "slug" varchar(160) not null,
+        "deleted_at" timestamptz null,
+        constraint "blog_post_sales_channels_pkey"
+          primary key ("blog_post_id", "sales_channel_id"),
+        constraint "blog_post_sales_channels_post_fk" foreign key ("blog_post_id")
+          references "blog_posts" ("id") on delete cascade,
+        constraint "blog_post_sales_channels_channel_fk" foreign key ("sales_channel_id")
+          references "sales_channels" ("id") on delete cascade
+      );
+    `);
+        this.addSql(`create unique index "idx_blog_posts_slug_per_channel_uniq"
+         on "blog_post_sales_channels" ("sales_channel_id", "slug")
+         where "deleted_at" is null;`);
+        // ────────────────────────────────────────────────────────────────────
+        // 6) blog_post_languages (M2M)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_post_languages" (
+        "blog_post_id" uuid not null,
+        "language" varchar(8) not null,
+        constraint "blog_post_languages_pkey"
+          primary key ("blog_post_id", "language"),
+        constraint "blog_post_languages_post_fk" foreign key ("blog_post_id")
+          references "blog_posts" ("id") on delete cascade
+      );
+    `);
+        // ────────────────────────────────────────────────────────────────────
+        // 7) blog_post_categories (M2M)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_post_categories" (
+        "blog_post_id" uuid not null,
+        "blog_category_id" uuid not null,
+        constraint "blog_post_categories_pkey"
+          primary key ("blog_post_id", "blog_category_id"),
+        constraint "blog_post_categories_post_fk" foreign key ("blog_post_id")
+          references "blog_posts" ("id") on delete cascade,
+        constraint "blog_post_categories_category_fk" foreign key ("blog_category_id")
+          references "blog_categories" ("id") on delete no action
+      );
+    `);
+        this.addSql(`create index "idx_blog_post_categories_category_id"
+         on "blog_post_categories" ("blog_category_id");`);
+        // ────────────────────────────────────────────────────────────────────
+        // 8) blog_tags
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_tags" (
+        "id" uuid not null,
+        "name" jsonb not null default '{}'::jsonb,
+        "description" jsonb null,
+        "code" varchar(64) not null,
+        "version" int not null default 1,
+        "created_at" timestamptz not null,
+        "updated_at" timestamptz not null,
+        "deleted_at" timestamptz null,
+        constraint "blog_tags_pkey" primary key ("id")
+      );
+    `);
+        this.addSql(`create unique index "idx_blog_tags_code_uniq"
+         on "blog_tags" ("code")
+         where "deleted_at" is null;`);
+        // ────────────────────────────────────────────────────────────────────
+        // 9) blog_post_tags (M2M, ordered)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_post_tags" (
+        "blog_post_id" uuid not null,
+        "blog_tag_id" uuid not null,
+        "position" int not null default 0,
+        constraint "blog_post_tags_pkey"
+          primary key ("blog_post_id", "blog_tag_id"),
+        constraint "blog_post_tags_post_fk" foreign key ("blog_post_id")
+          references "blog_posts" ("id") on delete cascade,
+        constraint "blog_post_tags_tag_fk" foreign key ("blog_tag_id")
+          references "blog_tags" ("id") on delete no action
+      );
+    `);
+        this.addSql(`create index "idx_blog_post_tags_tag_id"
+         on "blog_post_tags" ("blog_tag_id");`);
+        // ────────────────────────────────────────────────────────────────────
+        // 10) blog_post_related_posts (self-join, ordered)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_post_related_posts" (
+        "parent_post_id" uuid not null,
+        "related_post_id" uuid not null,
+        "position" int not null default 0,
+        constraint "blog_post_related_posts_pkey"
+          primary key ("parent_post_id", "related_post_id"),
+        constraint "blog_post_related_posts_parent_fk" foreign key ("parent_post_id")
+          references "blog_posts" ("id") on delete cascade,
+        constraint "blog_post_related_posts_related_fk" foreign key ("related_post_id")
+          references "blog_posts" ("id") on delete no action
+      );
+    `);
+        this.addSql(`create index "idx_blog_post_related_posts_related"
+         on "blog_post_related_posts" ("related_post_id");`);
+        // ────────────────────────────────────────────────────────────────────
+        // 11) blog_post_related_products (M2M to products, ordered)
+        // ────────────────────────────────────────────────────────────────────
+        this.addSql(`
+      create table "blog_post_related_products" (
+        "blog_post_id" uuid not null,
+        "product_id" uuid not null,
+        "position" int not null default 0,
+        constraint "blog_post_related_products_pkey"
+          primary key ("blog_post_id", "product_id"),
+        constraint "blog_post_related_products_post_fk" foreign key ("blog_post_id")
+          references "blog_posts" ("id") on delete cascade,
+        constraint "blog_post_related_products_product_fk" foreign key ("product_id")
+          references "products" ("id") on delete no action
+      );
+    `);
+    }
+    async down() {
+        this.addSql('drop table if exists "blog_post_related_products" cascade;');
+        this.addSql('drop table if exists "blog_post_related_posts" cascade;');
+        this.addSql('drop table if exists "blog_post_tags" cascade;');
+        this.addSql('drop table if exists "blog_tags" cascade;');
+        this.addSql('drop table if exists "blog_post_categories" cascade;');
+        this.addSql('drop table if exists "blog_post_languages" cascade;');
+        this.addSql('drop table if exists "blog_post_sales_channels" cascade;');
+        this.addSql('drop table if exists "blog_posts" cascade;');
+        this.addSql('drop table if exists "blog_category_languages" cascade;');
+        this.addSql('drop table if exists "blog_category_sales_channels" cascade;');
+        this.addSql('drop table if exists "blog_categories" cascade;');
+    }
+}
+//# sourceMappingURL=20260506T081055_blog_init.js.map

package/dist/migrations/20260506T081055_blog_init.js.map

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

package/dist/migrations/20260903T101744_blog_namespace_block_names.d.ts

@@ -0,0 +1,6 @@
+import { Migration } from '@mikro-orm/migrations';
+export declare class Migration20260903T101744BlogNamespaceBlockNames extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260903T101744_blog_namespace_block_names.d.ts.map

package/dist/migrations/20260903T101744_blog_namespace_block_names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260903T101744_blog_namespace_block_names.d.ts","sourceRoot":"","sources":["../../src/migrations/20260903T101744_blog_namespace_block_names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAmDlD,qBAAa,+CAAgD,SAAQ,SAAS;IAC7D,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAMrC"}

package/dist/migrations/20260903T101744_blog_namespace_block_names.js

@@ -0,0 +1,58 @@
+import { Migration } from '@mikro-orm/migrations';
+import { FROZEN_BLOCK_RENAMES, FROZEN_BLOCK_RENAMES_INVERSE, applyRenameFunctionSql, createRenameFunctionSql, dropRenameFunctionSql, } from '@endora-commerce/page-builder-core/migration';
+/**
+ * Namespace the Page Builder block names stored in `blog`'s 2 `jsonb` columns
+ * — feature 096, T405 (`contracts/block-name-migration.md`).
+ *
+ * **The rewrite is structural, never textual.** Twelve of the 74 renamed names
+ * are ordinary English words that occur throughout shop content — `Row`,
+ * `Text`, `Image`, `Map`, `Button` among them — so a text substitution over the
+ * column would corrupt a `RawHtml` block's markup and every `alt` attribute in
+ * the shop. `pg_temp.rename_block_names_blog` descends the document and replaces the value of a
+ * `type` property in a **node** position and nothing else; the walk is
+ * generated from `FROZEN_BLOCK_RENAMES` by
+ * `@endora-commerce/page-builder-core/migration`, so five migrations share one
+ * definition of what a node is.
+ *
+ * **This migration belongs to `blog` because `blog` owns these tables**,
+ * not because it owns the new names (`contracts/block-name-migration.md` §2).
+ * Some of the names it writes belong to other modules; that creates no
+ * obligation on them and **no new manifest `dependencies` edge**, because a
+ * block name is a string value inside a JSONB document — not a foreign key and
+ * not a table identifier.
+ *
+ * **It cannot fail on its input.** A name the map does not hold is left
+ * byte-identical: an already-namespaced one and an unrecognised one alike,
+ * because the map's domain is bare and its codomain is dotted, so the two sets
+ * are disjoint. That is also what makes a second run rewrite nothing — FR-013
+ * is a property of the map rather than an outcome a branch has to remember to
+ * produce, and no dot test appears in this SQL.
+ *
+ * `down()` applies the inverse over the identical walk and is **exact for the
+ * frozen set**. It is partial by construction: a name with no pre-migration
+ * form — a block authored after the upgrade, a third party's `acme.Banner` —
+ * has nothing to return to and is left alone. That is correct, and it is why
+ * the operator pre-flight (§6) is a backup rather than a `down()`.
+ */
+/**
+ * Named per module: the five rename migrations may run on one pooled session,
+ * and a second `create function` over the same name fails. Each drops its own
+ * when it is done, and a rollback removes it with everything else — `pg_temp`
+ * DDL is transactional.
+ */
+const FN = 'rename_block_names_blog';
+export class Migration20260903T101744BlogNamespaceBlockNames extends Migration {
+    async up() {
+        this.addSql(createRenameFunctionSql(FN, FROZEN_BLOCK_RENAMES));
+        this.addSql(applyRenameFunctionSql(FN, 'blog_posts', 'content'));
+        this.addSql(applyRenameFunctionSql(FN, 'blog_categories', 'description'));
+        this.addSql(dropRenameFunctionSql(FN));
+    }
+    async down() {
+        this.addSql(createRenameFunctionSql(FN, FROZEN_BLOCK_RENAMES_INVERSE));
+        this.addSql(applyRenameFunctionSql(FN, 'blog_posts', 'content'));
+        this.addSql(applyRenameFunctionSql(FN, 'blog_categories', 'description'));
+        this.addSql(dropRenameFunctionSql(FN));
+    }
+}
+//# sourceMappingURL=20260903T101744_blog_namespace_block_names.js.map

package/dist/migrations/20260903T101744_blog_namespace_block_names.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260903T101744_blog_namespace_block_names.js","sourceRoot":"","sources":["../../src/migrations/20260903T101744_blog_namespace_block_names.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,sBAAsB,EACtB,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,8CAA8C,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH;;;;;GAKG;AACH,MAAM,EAAE,GAAG,yBAAyB,CAAC;AAErC,MAAM,OAAO,+CAAgD,SAAQ,SAAS;IACnE,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,uBAAuB,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;QACjE,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,EAAE,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAAC,CAAC;QAC1E,IAAI,CAAC,MAAM,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent — *"the `./migrations` export of
+ * @endora-commerce/mod-blog exports no 'migrations' array"*. Until D-168's
+ * merge request this file published only `export *`, so an installed `blog`
+ * did not merely lose its schema, it stopped the platform from booting; the
+ * defect was invisible because a workspace member is not an installed package
+ * and the committed host registry names the class directly. That is the same
+ * silence D-168 found on `./backend`, one subpath along.
+ *
+ * The **named** export stays, and the asymmetry with `./backend` is deliberate.
+ * `db/migrations-registry.generated.ts` imports each class by name from this
+ * specifier and hands it to `migration('blog', …)`, and a migration class name
+ * is contract in a way an entity class name is not: `mikro_orm_migrations`
+ * persists it, so it is a string every already-migrated database holds. It also
+ * carries none of the hazard D-168 removes — no module has a reason to name
+ * another module's migration, and doing so buys nothing an entity import buys.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created. The composer refuses a migration file
+ * no declared subpath covers for exactly that reason, but it cannot see whether
+ * the barrel behind the subpath actually carries the class — that is this
+ * file's job.
+ */
+import { Migration20260506T081055BlogInit } from './20260506T081055_blog_init.js';
+import { Migration20260903T101744BlogNamespaceBlockNames } from './20260903T101744_blog_namespace_block_names.js';
+export declare const migrations: (typeof Migration20260506T081055BlogInit)[];
+export { Migration20260506T081055BlogInit, Migration20260903T101744BlogNamespaceBlockNames, };
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,+CAA+C,EAAE,MAAM,iDAAiD,CAAC;AAElH,eAAO,MAAM,UAAU,6CAGtB,CAAC;AAEF,OAAO,EACL,gCAAgC,EAChC,+CAA+C,GAChD,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,37 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent — *"the `./migrations` export of
+ * @endora-commerce/mod-blog exports no 'migrations' array"*. Until D-168's
+ * merge request this file published only `export *`, so an installed `blog`
+ * did not merely lose its schema, it stopped the platform from booting; the
+ * defect was invisible because a workspace member is not an installed package
+ * and the committed host registry names the class directly. That is the same
+ * silence D-168 found on `./backend`, one subpath along.
+ *
+ * The **named** export stays, and the asymmetry with `./backend` is deliberate.
+ * `db/migrations-registry.generated.ts` imports each class by name from this
+ * specifier and hands it to `migration('blog', …)`, and a migration class name
+ * is contract in a way an entity class name is not: `mikro_orm_migrations`
+ * persists it, so it is a string every already-migrated database holds. It also
+ * carries none of the hazard D-168 removes — no module has a reason to name
+ * another module's migration, and doing so buys nothing an entity import buys.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created. The composer refuses a migration file
+ * no declared subpath covers for exactly that reason, but it cannot see whether
+ * the barrel behind the subpath actually carries the class — that is this
+ * file's job.
+ */
+import { Migration20260506T081055BlogInit } from './20260506T081055_blog_init.js';
+import { Migration20260903T101744BlogNamespaceBlockNames } from './20260903T101744_blog_namespace_block_names.js';
+export const migrations = [
+    Migration20260506T081055BlogInit,
+    Migration20260903T101744BlogNamespaceBlockNames,
+];
+export { Migration20260506T081055BlogInit, Migration20260903T101744BlogNamespaceBlockNames, };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,EAAE,gCAAgC,EAAE,MAAM,gCAAgC,CAAC;AAClF,OAAO,EAAE,+CAA+C,EAAE,MAAM,iDAAiD,CAAC;AAElH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,gCAAgC;IAChC,+CAA+C;CAChD,CAAC;AAEF,OAAO,EACL,gCAAgC,EAChC,+CAA+C,GAChD,CAAC"}

package/docs/blog/index.md

@@ -0,0 +1,199 @@
+---
+title: Blog
+sidebar_position: 16
+description: Editorial Posts with Page Builder bodies, taxonomy (Categories + Tags), and storefront feeds
+---
+
+# Blog
+
+The Blog module owns the storefront's editorial blog surface — Posts,
+Categories, and Tags — composed in the same drag-and-drop **Page
+Builder** that ships with the [CMS module](../cms/index.md). Posts
+inherit the CMS Page's field shape (slug, status lifecycle, per-language
+content, SEO meta) and add blog-specific affordances: a parent Category
+tree, free-form Tags, ordered Related Posts, and ordered Related
+Products.
+
+| Entity         | Identifier             | Lifecycle                            | Embedded by                                              |
+| -------------- | ---------------------- | ------------------------------------ | -------------------------------------------------------- |
+| **Post**       | `slug` (per channel)   | `draft → published → archived`       | URL `<blog-prefix>/<slug>` on the storefront             |
+| **Category**   | `slug` (per channel)   | `enabled` flag, tree-structured      | URL `<blog-prefix>/<slug>` (siblings of Posts) and tiles |
+| **Tag**        | `code` (global)        | block-on-delete                      | URL `<blog-prefix>/tag/<code>` and per-Post chip strip   |
+
+## Entities and the reference graph
+
+```
+   blog_categories  ── parent_id ──┐ self-FK tree (NO ACTION)
+                          │       ▼
+                          ├─── blog_post_categories ───────► blog_posts
+                          │                                       │
+                          │                              ┌────────┼─────────┐
+                          ▼                              ▼        ▼         ▼
+              blog_post_categories                  blog_post_tags  blog_post_related_posts (self-FK)
+                                                          │                  │
+                                                          ▼                  │
+                                                      blog_tags              │
+                                                                             ▼
+                                                              blog_post_related_products → catalog.products
+```
+
+The schema lives entirely in `037_blog_init.ts` (eleven new tables, all
+prefixed `blog_*`) and never touches existing tables.
+
+## URLs and routing
+
+The storefront mounts a single Next.js catch-all under
+`storefront/app/(blog)/[[...slug]]/page.tsx`. The matcher reads the
+channel-resolved `blog.url_prefix` from the [Settings module](../settings/index.md)
+and dispatches:
+
+| URL pattern (after channel resolution) | Renders                              |
+| -------------------------------------- | ------------------------------------ |
+| `/<prefix>`                            | Blog index — latest N + first-level Categories |
+| `/<prefix>/tag/<code>`                 | Tag view — paginated cards for the Tag |
+| `/<prefix>/<slug>`                     | Category page (if the slug matches a `blog_categories.slug`) |
+| `/<prefix>/<slug>`                     | Post page (if the slug matches a `blog_posts.slug`) |
+
+The dispatch resolution happens in **one** backend call — `GET /api/v1/blog/by-slug?slug=…` — which returns a discriminated union (`{ kind: 'category' | 'post', … }`). Two channels MAY use the same slug for unrelated entities (channel context disambiguates).
+
+### Slug uniqueness
+
+Slug uniqueness is enforced **per `(sales_channel, slug)` across the
+union of `blog_posts` and `blog_categories`**:
+
+- DB-level partial unique indexes on each scope row (`*_sales_channels`)
+  catch any application bug that bypasses the service-level check.
+- The `BlogSlugCollision.assertSlugAvailable` helper acquires a
+  Postgres `pg_advisory_xact_lock` per `(channel, slug)` so a concurrent
+  save cannot squeeze a duplicate past the per-table indexes.
+- The literal `tag` is reserved as a slug (would collide with the
+  `<prefix>/tag/<code>` URL pattern).
+
+## Lifecycle
+
+### Posts
+
+```
+draft ─── publish ────► published ─── unpublish ───► draft
+                            │                           │
+                            │ archive                   │
+                            ▼                           ▼
+                        archived  ◄── unarchive ── (admin)
+```
+
+`published_at` is set on the first transition to `published` and
+preserved across subsequent unpublish / archive transitions (so re-
+publishing a post does not reset its publication date). A Post renders
+on the storefront when:
+
+```
+status = 'published'
+AND active = true
+AND deleted_at IS NULL
+AND requested-channel ∈ post.salesChannels
+AND blog.enabled[channel] = true
+```
+
+### Categories
+
+Categories carry a single `enabled` flag (no draft / publish). The seeded
+`Default` row is system-protected — admins can rename it, change its
+metadata, or detach it from channels, but it cannot be deleted.
+
+## Reference protection
+
+Five guards block destructive operations:
+
+1. **Tag delete with referencing posts** → 409 `BLOG_TAG_IN_USE`.
+2. **Category delete with referencing posts** → 409 `BLOG_CATEGORY_IN_USE`.
+3. **Category delete with child rows** → 409 `BLOG_CATEGORY_HAS_CHILDREN`.
+4. **Seeded `Default` Category delete** → 409 `BLOG_CATEGORY_PROTECTED`.
+5. **Library Asset soft-delete while embedded in a Post body or Category description** →
+   409 `ASSET_REFERENCED` (descriptors registered with the
+   [Assets Library reference registry](../assets-library/index.md#asset-reference-registry)).
+
+The Post-as-Related-Post relationship uses a different contract:
+**detach-on-delete**. When a Post is soft-deleted, every parent Post's
+`relatedPostIds` shrinks atomically. The admin sees a confirmation
+dialog listing the affected parents (driven by the
+`/posts/:id/inbound-references` probe).
+
+The Post-as-Related-Product relationship uses **soft-delete-+-storefront-filter**: a soft-deleted product is invisible on the next storefront read; the join row remains. A generic `ProductReferenceRegistry` may ship in a follow-up.
+
+## Settings
+
+| Code                  | Type    | Default | Notes                                                |
+| --------------------- | ------- | ------: | ---------------------------------------------------- |
+| `blog.enabled`        | boolean | `true`  | Disables the namespace per channel.                  |
+| `blog.url_prefix`     | string  | `blog`  | Single URL segment, `^[a-z0-9-]+$`. Reserved Next.js segments refused. |
+| `blog.latest_count`   | number  | `5`     | Latest posts on the index.                           |
+| `blog.posts_per_page` | number  | `12`    | Page size on Category and Tag views.                 |
+
+A change to any `blog.*` setting drops the platform-wide settings cache at the
+write seam and then fires an `EventBus` event, which wipes the storefront cache
+(see Cache strategy below).
+
+## Admin roles
+
+Two roles seed at first boot through `services/seed-roles.ts`:
+
+| Code              | Default name      | Permissions                                          |
+| ----------------- | ----------------- | ---------------------------------------------------- |
+| `blog_manager`    | Blog Manager      | `blog.read`, `blog.write`                            |
+| `content_manager` | Content Manager   | `blog.read`, `blog.write`, `cms.read`, `cms.write`   |
+
+Both are **system-protected**: `AdminRoleService.remove` refuses delete
+with 409 `ADMIN_ROLE_PROTECTED`. The reconciler preserves admin-edited
+names across reboots and only refreshes the canonical permissions
+array if it has drifted.
+
+## Storefront API
+
+| Method | Path                                  | Returns                                                  |
+| ------ | ------------------------------------- | -------------------------------------------------------- |
+| GET    | `/api/v1/blog/by-channel`             | `BlogIndexResponse` — latest N + first-level Categories  |
+| GET    | `/api/v1/blog/by-slug?slug=…`         | Discriminated `BlogBySlugResponse` (category / post)     |
+| GET    | `/api/v1/blog/tag-by-code?code=…`     | `BlogTagByCodeResponse` — paginated posts for the Tag    |
+
+All three:
+
+- read the resolved channel + language from request headers (`x-sales-channel`, `x-blog-language` / `accept-language`);
+- read `blog.*` settings from the channel-aware Settings service;
+- return `404 BLOG_DISABLED` (or `BLOG_POST_NOT_FOUND` / `BLOG_TAG_NOT_FOUND`) when the resolved scope has no matching content;
+- ride the [`BlogCacheService`](#cache-strategy) Redis read-through.
+
+## Cache strategy
+
+Keys live under `blog:v1:<channelCode>:<language>:` with four shapes:
+
+```
+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>
+```
+
+TTL: 5 minutes (aligned with the CMS module's cache).
+
+Invalidation:
+
+| Event                                  | Wipe                                            |
+| -------------------------------------- | ----------------------------------------------- |
+| Post / Category / Tag write            | `BlogCacheService.invalidateAll()`              |
+| Soft-delete or settings write          | `BlogCacheService.invalidateAll()` via EventBus |
+
+The granular `invalidatePost(channelCode, slug)` and friends are wired
+on the cache class for future surgical-invalidation work (coarse
+invalidation is correct at v1; rate of writes is low).
+
+## Cross-module dependencies
+
+| Module                                       | What the blog reads                                         |
+| -------------------------------------------- | ----------------------------------------------------------- |
+| [Settings](../settings/index.md)             | Four `blog.*` settings via `settings.service.get`           |
+| [Sales Channels](../sales_channels/index.md) | Channel resolution + language fallback                |
+| [Assets Library](../assets-library/index.md) | Asset URL signing + reference registry                |
+| [CMS](../cms/index.md)                       | Page Builder envelope (`cmsContentEnvelopeSchema`)          |
+| [Catalog](../catalog.md)                     | Product card resolution for Related Products                |
+
+The blog module never imports another module's internals — every cross-module read goes through a documented service port.