@endora-commerce/mod-cms 0.0.0-stage → 0.100.0

package/dist/backend/services/page-builder-registry.js

@@ -0,0 +1,220 @@
+// Page Builder component registry — feature 014 / T028, rebuilt on module
+// declarations by feature 096 (T209/T210).
+//
+// **It is populated from the composed modules' manifests, not from a call.**
+// Until 2026-09-03 it was populated by a single hand-written
+// `register('cms', …)` at `plugin.ts:90` which declared all 35 CMS names with
+// `ownerModule: 'cms'` — five of which are `catalog`'s, so the descriptor
+// answered the ownership question wrongly for every one of them and FR-010's
+// presence filter had nothing true to key on. Ownership is now stated once, in
+// the block's own `name`, by the module that owns it
+// (`contracts/block-definition.md` §1 and §4.1).
+//
+// The registry is React-free: it stores metadata only. The render functions
+// live in `@endora-commerce/cms-components` and the per-module packages, and
+// the storefront imports them directly.
+//
+// ## Two things it deliberately does not do
+//
+// **It does not merge categories at registration.** A merge performed there has
+// consumed composition order and can no longer answer differently when a module
+// is switched off — which is the whole of B12. Declarations are kept keyed by
+// their declaring module and folded at `describe()`, after the presence filter.
+//
+// **It applies no context admission.** `email` admitting into `newsletter` is
+// the *palette* derivation's rule, applied once through `contextAdmits`
+// (`contracts/block-definition.md` §4.1.1), so the wire shape keeps saying what
+// the manifests say and exactly one layer answers "which sections does the
+// newsletter palette have".
+import { DEFAULT_BREAKPOINTS } from '@endora-commerce/page-builder-core/types/responsive';
+/**
+ * Raised when two modules declare one block name.
+ *
+ * **D-31's collision requirement, and the reversal of defect D-d**: the old
+ * `register` warned and overwrote, which is last-writer-wins over a *persisted*
+ * identifier — one contributor's stored documents silently rendering as
+ * another's block. It has never been exercised because there was one
+ * contributor; there are now six.
+ *
+ * **Two contributors, never one registering twice.** The owner is compared, so
+ * a module re-declaring its own manifest is idempotent; a name that arrives
+ * from a second module id is the collision, and it is the only thing this error
+ * is for.
+ */
+export class DuplicateBlockNameError extends Error {
+    constructor(name, first, second) {
+        super(`[cms/page-builder-registry] Block name "${name}" is declared by both "${first}" and ` +
+            `"${second}". A block name is persisted and must have one owner — rename one of the ` +
+            'two declarations (`contracts/block-definition.md` §4.1).');
+        this.name = 'DuplicateBlockNameError';
+    }
+}
+export class PageBuilderRegistry {
+    components = new Map();
+    categories = [];
+    schemaVersion = 1;
+    breakpoints;
+    isModulePresent;
+    breakpointsResolver;
+    colorPaletteResolver;
+    constructor(options = {}) {
+        this.breakpoints = options.breakpoints ?? { ...DEFAULT_BREAKPOINTS };
+        this.isModulePresent = options.isModulePresent ?? (() => true);
+        for (const entry of options.manifests ?? []) {
+            this.registerManifest(entry.manifest);
+        }
+    }
+    /**
+     * Take one module's `blocks` and `blockCategories` declarations.
+     *
+     * The owner is the block name's first segment, which `defineModuleManifest`
+     * has already refused to let differ from the declaring module's `id`. It is
+     * read from the name rather than from the manifest so that the registry and
+     * the persisted document agree by construction.
+     */
+    registerManifest(manifest) {
+        for (const block of (manifest.blocks ?? [])) {
+            const existing = this.components.get(block.name);
+            // **The refusal's subject is two contributors**, which is what D-31 asks
+            // for and what defect D-d got wrong by warning and overwriting. One
+            // module registering twice — an idempotent re-composition, a harness
+            // calling a fixture once per test case — is not a collision, and refusing
+            // it produced the sentence `declared by both "x" and "x"`, which is
+            // self-evidently not one.
+            if (existing && existing.ownerModule !== manifest.id) {
+                throw new DuplicateBlockNameError(block.name, existing.ownerModule, manifest.id);
+            }
+            this.components.set(block.name, {
+                ownerModule: block.name.slice(0, block.name.indexOf('.')),
+                fields: block.fields,
+                contexts: [...block.contexts],
+                labelKey: block.labelKey,
+                ...(block.descriptionKey !== undefined ? { descriptionKey: block.descriptionKey } : {}),
+                category: block.category,
+                ...(block.defaultProps !== undefined ? { defaultProps: block.defaultProps } : {}),
+                ...(block.responsiveFields !== undefined
+                    ? { responsiveFields: [...block.responsiveFields] }
+                    : {}),
+                ...(block.previewIcon !== undefined ? { previewIcon: block.previewIcon } : {}),
+                ...(block.weight !== undefined ? { weight: block.weight } : {}),
+            });
+        }
+        for (const category of (manifest.blockCategories ?? [])) {
+            this.categories.push({ ...category, ownerModule: manifest.id });
+        }
+    }
+    setBreakpointsResolver(resolver) {
+        this.breakpointsResolver = resolver;
+    }
+    setColorPaletteResolver(resolver) {
+        this.colorPaletteResolver = resolver;
+    }
+    async resolveBreakpoints() {
+        if (this.breakpointsResolver) {
+            return this.breakpointsResolver();
+        }
+        return this.getBreakpoints();
+    }
+    isComponentRegistered(name) {
+        return this.components.has(name);
+    }
+    /**
+     * Every declared block name, **unfiltered by presence**.
+     *
+     * This answers "is this string a block name this platform knows", which the
+     * reference registries ask when they decide whether a stored node is a known
+     * embed. A switched-off module's blocks are still real names in stored
+     * documents, so filtering here would make a present document's node look
+     * unknown — a different question with a different right answer from the
+     * palette's.
+     */
+    knownNames() {
+        return new Set(this.components.keys());
+    }
+    getBreakpoints() {
+        return { ...this.breakpoints };
+    }
+    /**
+     * The metadata view used by `GET /api/v1/admin/cms/page-builder/config`.
+     *
+     * Filters to the effectively present modules and *then* folds the categories,
+     * in that order (`contracts/block-definition.md` §4.1). Both outputs are
+     * sorted by a function of the declarations alone, so the response is
+     * byte-identical under a re-composition or a reordering of `MODULES` — the
+     * D-45 property, which a fold at registration cannot have.
+     */
+    async describe() {
+        const breakpoints = await this.resolveBreakpoints();
+        const colorPalette = this.colorPaletteResolver ? await this.colorPaletteResolver() : [];
+        return {
+            schemaVersion: this.schemaVersion,
+            breakpoints,
+            colorPalette,
+            components: Array.from(this.components.entries())
+                .filter(([, reg]) => this.isModulePresent(reg.ownerModule))
+                .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+                .map(([name, reg]) => ({
+                name,
+                ownerModule: reg.ownerModule,
+                fields: reg.fields,
+                ...(reg.previewIcon !== undefined ? { previewIcon: reg.previewIcon } : {}),
+                contexts: reg.contexts ?? ['cms'],
+                ...(reg.labelKey !== undefined ? { labelKey: reg.labelKey } : {}),
+                ...(reg.descriptionKey !== undefined ? { descriptionKey: reg.descriptionKey } : {}),
+                ...(reg.category !== undefined ? { category: reg.category } : {}),
+                ...(reg.defaultProps !== undefined ? { defaultProps: reg.defaultProps } : {}),
+                ...(reg.responsiveFields !== undefined ? { responsiveFields: reg.responsiveFields } : {}),
+                ...(reg.weight !== undefined ? { weight: reg.weight } : {}),
+            })),
+            categories: this.foldCategories(),
+        };
+    }
+    /**
+     * Reduce every `(key, context)` group to one served record.
+     *
+     * `titleKey`, `weight` and `visible` come from **one** winning declaration and
+     * never field by field: a title from one module beside a weight from another
+     * is a presentation nobody wrote. The order is lowest `weight` first with an
+     * absent `weight` sorting after every declared one, ties broken by the
+     * declaring module's `id` ascending — a function of the declarations and of
+     * nothing else, so it is stable under re-composition
+     * (`contracts/block-definition.md` §1.1).
+     */
+    foldCategories() {
+        const groups = new Map();
+        for (const declaration of this.categories) {
+            if (!this.isModulePresent(declaration.ownerModule))
+                continue;
+            for (const context of declaration.contexts) {
+                const key = `${context} ${declaration.key}`;
+                const bucket = groups.get(key);
+                if (bucket)
+                    bucket.push(declaration);
+                else
+                    groups.set(key, [declaration]);
+            }
+        }
+        return [...groups.entries()]
+            .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+            .map(([key, declarations]) => {
+            const context = key.slice(0, key.indexOf(' '));
+            const winner = [...declarations].sort(compareCategoryDeclarations)[0];
+            return {
+                key: winner.key,
+                titleKey: winner.titleKey,
+                contexts: [context],
+                ...(winner.weight !== undefined ? { weight: winner.weight } : {}),
+                ...(winner.visible !== undefined ? { visible: winner.visible } : {}),
+                ownerModule: winner.ownerModule,
+            };
+        });
+    }
+}
+function compareCategoryDeclarations(a, b) {
+    const aw = a.weight ?? Number.POSITIVE_INFINITY;
+    const bw = b.weight ?? Number.POSITIVE_INFINITY;
+    if (aw !== bw)
+        return aw - bw;
+    return a.ownerModule < b.ownerModule ? -1 : a.ownerModule > b.ownerModule ? 1 : 0;
+}
+//# sourceMappingURL=page-builder-registry.js.map

package/dist/backend/services/page-builder-registry.js.map

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

package/dist/backend/services/seed-hooks.d.ts

@@ -0,0 +1,22 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+export interface SeededHook {
+    code: string;
+    name: string;
+    description?: string;
+}
+export declare const SEEDED_HOOKS: ReadonlyArray<SeededHook>;
+export interface SeedHooksReconcileResult {
+    inserted: number;
+    preservedExisting: number;
+}
+/**
+ * Idempotent reconciler. Existing rows (matched by code) are preserved
+ * untouched — admin-edited names + descriptions survive every run.
+ * Missing seeded codes are inserted with `is_system=true`. Every seeded
+ * hook is also (re-)bound to every existing sales channel via
+ * `cms_hook_sales_channels` so the storefront's per-channel resolution
+ * sees the hook even after `sales_channels` was truncated (e.g. between
+ * test runs — the bindings cascade-deleted with the channels).
+ */
+export declare function reconcileSeededHooks(emFactory: () => EntityManager): Promise<SeedHooksReconcileResult>;
+//# sourceMappingURL=seed-hooks.d.ts.map

package/dist/backend/services/seed-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed-hooks.d.ts","sourceRoot":"","sources":["../../../src/backend/services/seed-hooks.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAI3D,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,YAAY,EAAE,aAAa,CAAC,UAAU,CA4BlD,CAAC;AAEF,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,aAAa,GAC7B,OAAO,CAAC,wBAAwB,CAAC,CA+CnC"}

package/dist/backend/services/seed-hooks.js

@@ -0,0 +1,94 @@
+// Seeded base Hook codes — feature 014 / R8 / T030.
+//
+// The 23 codes here are recognised natively by the storefront's named
+// insertion points. The reconciler is idempotent: re-running it preserves
+// admin-edited names + descriptions and re-creates a system Hook only if
+// it is somehow missing. Runs at composition time before HTTP routes
+// start serving (called from composition.ts), and inside the migration
+// (035_cms_init.ts) so first boot doesn't race.
+import { CmsHook } from '../entities/cms-hook.entity.js';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+export const SEEDED_HOOKS = [
+    {
+        code: 'header.top',
+        name: 'Header Top',
+        description: 'Top-of-page strip — phone number, free-shipping notice, etc.',
+    },
+    { code: 'homepage.top', name: 'Homepage Top', description: 'Above the homepage content.' },
+    { code: 'homepage.bottom', name: 'Homepage Bottom', description: 'Below the homepage content.' },
+    { code: 'footer.before', name: 'Footer Before' },
+    { code: 'footer.top', name: 'Footer Top' },
+    { code: 'footer.bottom', name: 'Footer Bottom' },
+    { code: 'footer.after', name: 'Footer After' },
+    { code: 'footer.copyright', name: 'Footer Copyright' },
+    { code: 'category.top', name: 'Category Page Top' },
+    { code: 'category.bottom', name: 'Category Page Bottom' },
+    { code: 'product.top', name: 'Product Page Top' },
+    { code: 'product.bottom', name: 'Product Page Bottom' },
+    { code: 'product.buttons.after', name: 'Product Page After Buttons Set' },
+    { code: 'search.top', name: 'Search Page Top' },
+    { code: 'search.bottom', name: 'Search Page Bottom' },
+    { code: 'page.top', name: 'Every Page Top' },
+    { code: 'page.bottom', name: 'Every Page Bottom' },
+    { code: 'cms.page.top', name: 'Every CMS Page Top' },
+    { code: 'cms.page.bottom', name: 'Every CMS Page Bottom' },
+    { code: 'login.top', name: 'Login Page Top' },
+    { code: 'login.bottom', name: 'Login Page Bottom' },
+    { code: 'register.top', name: 'Register Page Top' },
+    { code: 'register.bottom', name: 'Register Page Bottom' },
+];
+/**
+ * Idempotent reconciler. Existing rows (matched by code) are preserved
+ * untouched — admin-edited names + descriptions survive every run.
+ * Missing seeded codes are inserted with `is_system=true`. Every seeded
+ * hook is also (re-)bound to every existing sales channel via
+ * `cms_hook_sales_channels` so the storefront's per-channel resolution
+ * sees the hook even after `sales_channels` was truncated (e.g. between
+ * test runs — the bindings cascade-deleted with the channels).
+ */
+export async function reconcileSeededHooks(emFactory) {
+    // command-coverage-ignore: idempotent boot seed/reconcile of module-declared CMS
+    // hooks — a system-invariant repair, not an operator-initiated audited write.
+    const em = emFactory();
+    const existing = await em.find(CmsHook, { isSystem: true });
+    const existingByCode = new Map(existing.map((h) => [h.code, h]));
+    let inserted = 0;
+    for (const seed of SEEDED_HOOKS) {
+        if (existingByCode.has(seed.code))
+            continue;
+        const hook = em.create(CmsHook, {
+            name: seed.name,
+            code: seed.code,
+            active: true,
+            description: seed.description ?? null,
+            isSystem: true,
+        });
+        em.persist(hook);
+        inserted += 1;
+    }
+    if (inserted > 0)
+        await em.flush();
+    /**
+     * The channel ids come from the kernel's own entity, not from a
+     * `cross join "sales_channels"` (feature 075, D-87). `sales_channels` is the
+     * kernel's table since feature 072 moved the resolution machinery there, and
+     * a module relating into the kernel by ORM is the sanctioned access. The
+     * binding insert stays one set-based statement over this module's own two
+     * tables, with one ordinary binding per channel id.
+     */
+    const channelIds = (await em.find(SalesChannel, {}, { fields: ['id'] })).map((c) => c.id);
+    if (channelIds.length > 0) {
+        const channelValues = channelIds.map(() => '(?::uuid)').join(', ');
+        await em.execute(`insert into "cms_hook_sales_channels" ("hook_id", "sales_channel_id")
+       select h."id", c."id"
+       from "cms_hooks" h
+       cross join (values ${channelValues}) as c("id")
+       where h."is_system" = true
+         and not exists (
+           select 1 from "cms_hook_sales_channels" x
+           where x."hook_id" = h."id" and x."sales_channel_id" = c."id"
+         )`, channelIds);
+    }
+    return { inserted, preservedExisting: existing.length };
+}
+//# sourceMappingURL=seed-hooks.js.map

package/dist/backend/services/seed-hooks.js.map

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

package/dist/backend/services/storefront-resolver.d.ts

@@ -0,0 +1,71 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CmsAssetEmbedResolution, CmsPageIndexEntry, CmsResolvedBlock, CmsResolvedHook, CmsResolvedPage } from '@endora-commerce/contracts';
+import type { CmsCache } from './cms-cache.js';
+export type CmsAssetResolver = (assetId: string) => Promise<CmsAssetEmbedResolution | null>;
+/**
+ * The request's resolved sales channel, handed in by the route from the
+ * canonical resolver, read via `getResolvedChannel()` — feature 053 / FR-002. The
+ * service no longer re-resolves the channel from the raw header.
+ */
+export type ResolvedChannel = {
+    id: string;
+    code: string;
+    defaultLanguage: string;
+};
+export declare class StorefrontResolver {
+    private readonly emFactory;
+    private readonly cache?;
+    private assetResolver;
+    constructor(emFactory: () => EntityManager, cache?: CmsCache | undefined);
+    setAssetResolver(resolver: CmsAssetResolver | null): void;
+    private resolveAssetsForTrees;
+    resolvePageBySlug(input: {
+        resolvedChannel: ResolvedChannel;
+        language?: string | undefined;
+        slug: string;
+    }): Promise<CmsResolvedPage | null>;
+    /**
+     * Every published page of one sales channel, at the slug that channel serves
+     * it under (feature 105, FR-021; `contracts/cms-page-url.md` §4.1).
+     *
+     * The join is `resolvePageBySlug`'s, minus the slug predicate: same table,
+     * same three conditions — the channel binding, `status = 'published'` and
+     * `active = true` — so a page this answer names is a page that endpoint
+     * serves, and a page it omits is one that would 404. A sitemap built from a
+     * looser query would advertise a URL the shop refuses, which is the state §4.1
+     * exists to make unreachable.
+     *
+     * The slug comes off `cms_page_sales_channels`, never off `cms_pages`: the
+     * address is per channel (Constitution XII), and the page row's own column is
+     * one value shared by all of them.
+     *
+     * Uncached, deliberately. `CmsCache` keys a page by `(slug, channel, language)`
+     * and is invalidated per slug on write, so an index cached beside it would
+     * survive every invalidation the module performs and go stale on the first
+     * publish. The read is one indexed join per sitemap build, which Next's own
+     * route cache already sits in front of.
+     */
+    listPublishedPages(input: {
+        resolvedChannel: ResolvedChannel;
+    }): Promise<CmsPageIndexEntry[]>;
+    resolveBlockByCode(input: {
+        resolvedChannel: ResolvedChannel;
+        language?: string | undefined;
+        code: string;
+    }): Promise<CmsResolvedBlock | null>;
+    resolveHookByCode(input: {
+        resolvedChannel: ResolvedChannel;
+        language?: string | undefined;
+        code: string;
+    }): Promise<CmsResolvedHook | null>;
+    /**
+     * Recursively inlines InsertBlock / InsertTemplate references found in the
+     * supplied Page Builder data tree. Capped at EMBED_DEPTH_CAP levels —
+     * cycles or deeper graphs degrade to placeholders rendered admin-side.
+     */
+    private inlineEmbeds;
+    private fetchBlocksByCodes;
+    private fetchTemplatesByCodes;
+    private resolveLanguage;
+}
+//# sourceMappingURL=storefront-resolver.d.ts.map

package/dist/backend/services/storefront-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storefront-resolver.d.ts","sourceRoot":"","sources":["../../../src/backend/services/storefront-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EACV,uBAAuB,EACvB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,eAAe,EAEhB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,uBAAuB,GAAG,IAAI,CAAC,CAAC;AAiC5F;;;;GAIG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;CACzB,CAAC;AA0BF,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IAJzB,OAAO,CAAC,aAAa,CAAiC;gBAGnC,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,CAAC,EAAE,QAAQ,YAAA;IAGnC,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,IAAI,GAAG,IAAI;YAI3C,qBAAqB;IAkB7B,iBAAiB,CAAC,KAAK,EAAE;QAC7B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IA0DnC;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,kBAAkB,CAAC,KAAK,EAAE;QAC9B,eAAe,EAAE,eAAe,CAAC;KAClC,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAoB1B,kBAAkB,CAAC,KAAK,EAAE;QAC9B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;IAwC9B,iBAAiB,CAAC,KAAK,EAAE;QAC7B,eAAe,EAAE,eAAe,CAAC;QACjC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAC9B,IAAI,EAAE,MAAM,CAAC;KACd,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAuEnC;;;;OAIG;YACW,YAAY;YA0EZ,kBAAkB;YAkBlB,qBAAqB;IAiBnC,OAAO,CAAC,eAAe;CA6BxB"}