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

package/dist/backend/services/storefront-resolver.js

@@ -0,0 +1,329 @@
+import { walkAssetIds, walkBlockEmbeds, walkTemplateEmbeds } from './content-tree-walker.js';
+/** Recursion depth cap for InsertBlock/InsertTemplate inlining (per data-model.md / T082). */
+const EMBED_DEPTH_CAP = 3;
+/**
+ * How many published pages one channel's index answers with.
+ *
+ * A bound rather than a page size: the caller is a sitemap, Google's own
+ * ceiling is 50 000 URLs per file, and the storefront already caps its product
+ * enumeration at 5 000 for the same reason. A shop with more CMS pages than
+ * this has a sitemap-index problem rather than a listing problem, and adding a
+ * cursor before one exists would be a paging protocol with no reader.
+ */
+const PAGE_INDEX_LIMIT = 5000;
+function toChannelRow(channel) {
+    return { id: channel.id, code: channel.code, default_language: channel.defaultLanguage };
+}
+export class StorefrontResolver {
+    emFactory;
+    cache;
+    assetResolver = null;
+    constructor(emFactory, cache) {
+        this.emFactory = emFactory;
+        this.cache = cache;
+    }
+    setAssetResolver(resolver) {
+        this.assetResolver = resolver;
+    }
+    async resolveAssetsForTrees(trees) {
+        const resolver = this.assetResolver;
+        if (!resolver)
+            return {};
+        const ids = new Set();
+        for (const tree of trees)
+            walkAssetIds(tree, ids);
+        if (ids.size === 0)
+            return {};
+        const assets = {};
+        await Promise.all(Array.from(ids).map(async (assetId) => {
+            const resolved = await resolver(assetId);
+            if (resolved)
+                assets[assetId] = resolved;
+        }));
+        return assets;
+    }
+    async resolvePageBySlug(input) {
+        const em = this.emFactory();
+        const channel = toChannelRow(input.resolvedChannel);
+        const cacheLanguage = input.language ?? channel.default_language;
+        if (this.cache) {
+            const cached = await this.cache.getPage(input.slug, channel.code, cacheLanguage);
+            if (cached)
+                return cached;
+        }
+        const rows = (await em.execute(`select p.*
+       from cms_pages p
+       join cms_page_sales_channels cpsc on cpsc.page_id = p.id
+       where cpsc.sales_channel_id = ?
+         and cpsc.slug = ?
+         and p.status = 'published'
+         and p.active = true
+       limit 1`, [channel.id, input.slug]));
+        const page = rows[0];
+        if (!page)
+            return null;
+        const language = this.resolveLanguage(page, input.language, channel.default_language);
+        if (!language)
+            return null;
+        const data = page.content.languages?.[language] ?? {};
+        const embeds = await this.inlineEmbeds(em, channel, language, data);
+        const embedTrees = [
+            data,
+            ...Object.values(embeds.blocks).map((b) => b.content.data),
+            ...Object.values(embeds.templates).map((t) => t.content.data),
+        ];
+        const assets = await this.resolveAssetsForTrees(embedTrees);
+        const resolved = {
+            id: page.id,
+            slug: page.slug,
+            name: page.name,
+            language,
+            meta: {
+                title: page.meta_title?.[language] ?? null,
+                description: page.meta_description?.[language] ?? null,
+                keywords: page.meta_keywords?.[language] ?? null,
+            },
+            content: {
+                data,
+            },
+            embeds,
+            assets,
+        };
+        if (this.cache) {
+            await this.cache.setPage(input.slug, channel.code, cacheLanguage, resolved);
+        }
+        return resolved;
+    }
+    /**
+     * 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.
+     */
+    async listPublishedPages(input) {
+        const em = this.emFactory();
+        const rows = (await em.execute(`select cpsc.slug as slug, p.updated_at as updated_at
+       from cms_pages p
+       join cms_page_sales_channels cpsc on cpsc.page_id = p.id
+       where cpsc.sales_channel_id = ?
+         and p.status = 'published'
+         and p.active = true
+       order by cpsc.slug asc
+       limit ${PAGE_INDEX_LIMIT}`, [input.resolvedChannel.id]));
+        return rows.map((row) => ({
+            slug: row.slug,
+            updatedAt: new Date(row.updated_at).toISOString(),
+        }));
+    }
+    async resolveBlockByCode(input) {
+        const em = this.emFactory();
+        const channel = toChannelRow(input.resolvedChannel);
+        const cacheLanguage = input.language ?? channel.default_language;
+        if (this.cache) {
+            const cached = await this.cache.getBlock(input.code, channel.code, cacheLanguage);
+            if (cached)
+                return cached;
+        }
+        const rows = (await em.execute(`select b.*
+       from cms_blocks b
+       join cms_block_sales_channels cbsc on cbsc.block_id = b.id
+       where cbsc.sales_channel_id = ?
+         and cbsc.code = ?
+         and b.active = true
+       limit 1`, [channel.id, input.code]));
+        const block = rows[0];
+        if (!block)
+            return null;
+        const language = this.resolveLanguage(block, input.language, channel.default_language);
+        if (!language)
+            return null;
+        const resolved = {
+            id: block.id,
+            code: block.code,
+            language,
+            content: {
+                data: block.content.languages?.[language] ?? {},
+            },
+        };
+        if (this.cache) {
+            await this.cache.setBlock(input.code, channel.code, cacheLanguage, resolved);
+        }
+        return resolved;
+    }
+    async resolveHookByCode(input) {
+        const em = this.emFactory();
+        const channel = toChannelRow(input.resolvedChannel);
+        const cacheLanguage = input.language ?? channel.default_language;
+        if (this.cache) {
+            const cached = await this.cache.getHook(input.code, channel.code, cacheLanguage);
+            if (cached)
+                return cached;
+        }
+        const hookRows = (await em.execute(`select id::text, code, active
+       from cms_hooks
+       where code = ?
+       limit 1`, [input.code]));
+        const hook = hookRows[0];
+        if (!hook)
+            return null;
+        if (!hook.active) {
+            const empty = { hookCode: hook.code, blocks: [] };
+            if (this.cache)
+                await this.cache.setHook(input.code, channel.code, cacheLanguage, empty);
+            return empty;
+        }
+        const scopedRows = (await em.execute(`select 1
+       from cms_hook_sales_channels
+       where hook_id = ? and sales_channel_id = ?
+       limit 1`, [hook.id, channel.id]));
+        if (scopedRows.length === 0) {
+            const empty = { hookCode: hook.code, blocks: [] };
+            if (this.cache)
+                await this.cache.setHook(input.code, channel.code, cacheLanguage, empty);
+            return empty;
+        }
+        const blockRows = (await em.execute(`select b.*
+       from cms_hook_block_attachments a
+       join cms_blocks b on b.id = a.block_id
+       join cms_block_sales_channels cbsc on cbsc.block_id = b.id
+       where a.hook_id = ?
+         and cbsc.sales_channel_id = ?
+         and b.active = true
+       order by a.position asc, a.block_id asc`, [hook.id, channel.id]));
+        const blocks = [];
+        for (const block of blockRows) {
+            const language = this.resolveLanguage(block, input.language, channel.default_language);
+            if (!language)
+                continue;
+            blocks.push({
+                id: block.id,
+                code: block.code,
+                language,
+                content: {
+                    data: block.content.languages?.[language] ?? {},
+                },
+            });
+        }
+        const resolved = { hookCode: hook.code, blocks };
+        if (this.cache) {
+            await this.cache.setHook(input.code, channel.code, cacheLanguage, resolved);
+        }
+        return resolved;
+    }
+    /**
+     * 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.
+     */
+    async inlineEmbeds(em, channel, language, rootData) {
+        const resolvedBlocks = {};
+        const resolvedTemplates = {};
+        const visit = async (data, depth) => {
+            if (depth > EMBED_DEPTH_CAP)
+                return;
+            const blockCodes = Array.from(walkBlockEmbeds(data)).filter((code) => !(code in resolvedBlocks));
+            const templateCodes = Array.from(walkTemplateEmbeds(data)).filter((code) => !(code in resolvedTemplates));
+            const blocks = blockCodes.length > 0
+                ? await this.fetchBlocksByCodes(em, channel, blockCodes)
+                : [];
+            const templates = templateCodes.length > 0
+                ? await this.fetchTemplatesByCodes(em, channel, templateCodes)
+                : [];
+            const nextLayer = [];
+            for (const block of blocks) {
+                const blockLanguage = this.resolveLanguage(block, language, channel.default_language);
+                if (!blockLanguage)
+                    continue;
+                const blockData = block.content.languages?.[blockLanguage] ?? {};
+                resolvedBlocks[block.code] = {
+                    id: block.id,
+                    code: block.code,
+                    language: blockLanguage,
+                    content: {
+                        data: blockData,
+                    },
+                };
+                nextLayer.push(blockData);
+            }
+            for (const template of templates) {
+                const templateLanguage = this.resolveLanguage(template, language, channel.default_language);
+                if (!templateLanguage)
+                    continue;
+                const templateData = template.content.languages?.[templateLanguage] ?? {};
+                resolvedTemplates[template.code] = {
+                    id: template.id,
+                    code: template.code,
+                    language: templateLanguage,
+                    content: {
+                        data: templateData,
+                    },
+                };
+                nextLayer.push(templateData);
+            }
+            for (const child of nextLayer) {
+                await visit(child, depth + 1);
+            }
+        };
+        await visit(rootData, 1);
+        return { blocks: resolvedBlocks, templates: resolvedTemplates };
+    }
+    async fetchBlocksByCodes(em, channel, codes) {
+        if (codes.length === 0)
+            return [];
+        const placeholders = codes.map(() => '?').join(', ');
+        return (await em.execute(`select b.*
+       from cms_blocks b
+       join cms_block_sales_channels cbsc on cbsc.block_id = b.id
+       where cbsc.sales_channel_id = ?
+         and cbsc.code in (${placeholders})
+         and b.active = true`, [channel.id, ...codes]));
+    }
+    async fetchTemplatesByCodes(em, channel, codes) {
+        if (codes.length === 0)
+            return [];
+        const placeholders = codes.map(() => '?').join(', ');
+        return (await em.execute(`select t.*
+       from cms_templates t
+       join cms_template_sales_channels ctsc on ctsc.template_id = t.id
+       where ctsc.sales_channel_id = ?
+         and ctsc.code in (${placeholders})`, [channel.id, ...codes]));
+    }
+    resolveLanguage(page, requested, channelDefault) {
+        const available = page.content.languages ?? {};
+        const hasContent = (lang) => page.languages.includes(lang) && available[lang] !== undefined;
+        if (requested && hasContent(requested)) {
+            return requested;
+        }
+        if (hasContent(channelDefault)) {
+            return channelDefault;
+        }
+        // Final fallback: render in whatever language actually carries content so a
+        // published, channel-assigned page still resolves instead of 404-ing. This
+        // covers pages authored only in a non-default language (e.g. en-US content
+        // on a pl-PL-default channel) — without it, selecting such a page as the
+        // storefront home page silently falls back to the built-in landing page.
+        const firstDeclaredWithContent = page.languages.find((lang) => available[lang] !== undefined);
+        if (firstDeclaredWithContent) {
+            return firstDeclaredWithContent;
+        }
+        // Last resort for legacy data whose content keys are not mirrored in the
+        // `languages` array: fall back to the first populated content language.
+        return Object.keys(available)[0] ?? null;
+    }
+}
+//# sourceMappingURL=storefront-resolver.js.map

package/dist/backend/services/storefront-resolver.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,225 @@
+import { type ModuleCliCommand } from '@endora-commerce/contracts';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import { type PageBuilderBreakpoints } from '@endora-commerce/page-builder-core/types/responsive';
+export declare const CMS_PAGE_BUILDER_SETTING_CODES: {
+    readonly BREAKPOINT_TABLET_MIN: "cms.page_builder.breakpoint.tablet_min";
+    readonly BREAKPOINT_DESKTOP_MIN: "cms.page_builder.breakpoint.desktop_min";
+    readonly COLOR_PALETTE: "cms.page_builder.color_palette";
+};
+/**
+ * The deployment's reserved first path segments
+ * (`specs/105-cms-root-page-urls/` FR-031/FR-032;
+ * `contracts/cms-page-url.md` §5.2).
+ *
+ * A CMS page lives at the storefront root, `/{slug}`, so a page slugged
+ * `cart` saves, publishes and is never served: a root catch-all is Next's
+ * lowest-priority match and the storefront's own `/cart` wins. Nothing here
+ * creates that precedence and nothing may (§5.0) — this value is what lets the
+ * module tell the operator *before* the page disappears.
+ *
+ * **The value is the deployment's and the default is empty**, which is not a
+ * gap left open. The set is a fact about a *storefront's route table*; a
+ * headless backend serves storefronts it did not build, so a list shipped in
+ * `cms` would be a derived fact about a consumer written into the owner — stale
+ * the first time any client adds a route, and stale in the direction that fails
+ * open. The reference storefront publishes its own segments as
+ * `RESERVED_TOP_LEVEL_SEGMENTS` (`storefront/app/reserved-segments.ts`),
+ * reconciled against its route tree by `check:storefront-indexability`, and a
+ * deployment copies its value from there.
+ */
+export declare const CMS_SETTING_CODES: {
+    readonly RESERVED_SLUG_SEGMENTS: "cms.reserved_slug_segments";
+};
+export declare const cmsSettingsManifest: {
+    moduleCode: string;
+    groups: {
+        code: string;
+        name: string;
+        salesChannelCodes?: string[] | undefined;
+        isSystemProtected?: boolean | undefined;
+    }[];
+    settings: {
+        code: string;
+        name: string;
+        valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+        defaultValue: unknown;
+        description?: string | undefined;
+        groupCode?: string | undefined;
+        previousDefaultValues?: unknown[] | undefined;
+        salesChannelCodes?: string[] | undefined;
+        enumOptions?: string[] | undefined;
+        configurationType?: string | undefined;
+        hidden?: boolean | undefined;
+    }[];
+};
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("cms" | "newsletter" | "invoice" | "email")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("cms" | "newsletter" | "invoice" | "email")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+export declare function resolvePageBuilderBreakpointsFromEnv(): PageBuilderBreakpoints;
+/**
+ * The operator's pre-flight report for the block-name migration (feature 096,
+ * T410; `contracts/block-name-migration.md` §7).
+ *
+ * The body is `await import()`ed so the generated manifest index stays light —
+ * this file is loaded by every check and every composition, and the report pulls
+ * in the frozen rename map and the structural walk.
+ */
+export declare const cliCommands: ReadonlyArray<ModuleCliCommand<ModuleContext>>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EACtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAuB,KAAK,sBAAsB,EAAE,MAAM,qDAAqD,CAAC;AAEvH,eAAO,MAAM,8BAA8B;;;;CAIjC,CAAC;AAEX;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB;;CAEpB,CAAC;AA4DX,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;CAAW,CAAC;AAE5C,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAukBnB,CAAC;AAEH,wBAAgB,oCAAoC,IAAI,sBAAsB,CAS7E;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,EAAE,aAAa,CAAC,gBAAgB,CAAC,aAAa,CAAC,CAQtE,CAAC"}