@endora-commerce/mod-seo 0.100.0

package/dist/backend/services/sitemap-generator.service.d.ts

@@ -0,0 +1,79 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { z } from 'zod';
+import { type CatalogCategoryReadPort, type CatalogProductReadPort, type CmsPageReadPort } from '@endora-commerce/contracts';
+import type { SalesChannelMembershipPort } from '@endora-commerce/platform/kernel';
+export interface SitemapGeneratorOptions {
+    /** Public origin used when no per-channel URL is configured. Defaults to env or localhost. */
+    baseUrl?: string;
+    /** How old the cache row may be before serve triggers a regenerate. */
+    staleAfterMs?: number;
+}
+export interface SitemapStatus {
+    generatedAt: Date | null;
+    byteSize: number | null;
+    urlCount: number | null;
+}
+export interface SitemapChannelStatus extends SitemapStatus {
+    salesChannelCode: string;
+    salesChannelName: string;
+    storefrontUrl: string;
+    storefrontUrlSource: 'setting' | 'env' | 'fallback';
+}
+/** Minimal port for the SettingsService — only the read we need. */
+export interface SitemapSettingsPort {
+    get<T>(code: string, salesChannelId: string, schema: z.ZodType<T>): Promise<T>;
+}
+export declare class SitemapGeneratorService {
+    private readonly emFactory;
+    private readonly settings;
+    /** What this channel contains, and what those rows are (feature 075, Phase C). */
+    private readonly membership;
+    private readonly catalogProducts;
+    private readonly catalogCategories;
+    private readonly cmsPages;
+    private readonly fallbackBaseUrl;
+    private readonly staleAfterMs;
+    constructor(emFactory: () => EntityManager, settings: SitemapSettingsPort | null, 
+    /** What this channel contains, and what those rows are (feature 075, Phase C). */
+    membership: SalesChannelMembershipPort, catalogProducts: CatalogProductReadPort, catalogCategories: CatalogCategoryReadPort, cmsPages: CmsPageReadPort, options?: SitemapGeneratorOptions);
+    /**
+     * Serve the sitemap for a single channel; regenerates inline when stale
+     * or when no cache row exists yet.
+     */
+    getOrGenerateForChannel(salesChannelCode: string): Promise<{
+        payload: string;
+        generatedAt: Date;
+    }>;
+    regenerateForChannel(salesChannelCode: string): Promise<{
+        payload: string;
+        generatedAt: Date;
+    }>;
+    getStatusForChannel(salesChannelCode: string): Promise<SitemapStatus>;
+    /**
+     * Per-channel admin overview: one row per active channel, with the
+     * cache stats (or NULLs when never generated) and the resolved
+     * storefront URL.
+     */
+    listChannelStatuses(): Promise<SitemapChannelStatus[]>;
+    private resolveStorefrontUrl;
+    private resolveStorefrontUrlSource;
+    /**
+     * What belongs to this channel, through the sanctioned bridge accessor
+     * (Constitution XII). This was three hand-written `SELECT`s against
+     * `sales_channel_products`, `sales_channel_categories` and
+     * `sales_channel_cms_pages` — the tables `SalesChannelMembershipPort`'s own
+     * doc comment says a module must not reach for, and the one cross-module
+     * read in this file that `check-module-boundary` could never have found,
+     * because raw SQL names no import specifier.
+     */
+    private collectChannelMemberIds;
+    /**
+     * Every member id, not the first page of them. `listEntityIdsForChannel` is
+     * paginated and defaults to 100; a sitemap wants the channel's whole
+     * catalogue, so the pages are walked to `total`. `total` is re-read on each
+     * call and the loop is bounded by it, so a concurrent membership write
+     * cannot spin it.
+     */
+    private allMemberIds;
+}
+//# sourceMappingURL=sitemap-generator.service.d.ts.map

package/dist/backend/services/sitemap-generator.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sitemap-generator.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/sitemap-generator.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAGL,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAE3B,KAAK,eAAe,EACrB,MAAM,4BAA4B,CAAC;AAEpC,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AA2CnF,MAAM,WAAW,uBAAuB;IACtC,8FAA8F;IAC9F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,IAAI,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,oBAAqB,SAAQ,aAAa;IACzD,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,SAAS,GAAG,KAAK,GAAG,UAAU,CAAC;CACrD;AAED,oEAAoE;AACpE,MAAM,WAAW,mBAAmB;IAClC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAChF;AAED,qBAAa,uBAAuB;IAKhC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAV3B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAGnB,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,mBAAmB,GAAG,IAAI;IACrD,kFAAkF;IACjE,UAAU,EAAE,0BAA0B,EACtC,eAAe,EAAE,sBAAsB,EACvC,iBAAiB,EAAE,uBAAuB,EAC1C,QAAQ,EAAE,eAAe,EAC1C,OAAO,GAAE,uBAA4B;IASvC;;;OAGG;IACG,uBAAuB,CAC3B,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,IAAI,CAAA;KAAE,CAAC;IAS5C,oBAAoB,CACxB,gBAAgB,EAAE,MAAM,GACvB,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,IAAI,CAAA;KAAE,CAAC;IA8F5C,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAW3E;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC;YA0B9C,oBAAoB;YAKpB,0BAA0B;IAyBxC;;;;;;;;OAQG;YACW,uBAAuB;IAarC;;;;;;OAMG;YACW,YAAY;CAgB3B"}

package/dist/backend/services/sitemap-generator.service.js

@@ -0,0 +1,293 @@
+import { z } from 'zod';
+import { ANONYMOUS_PRODUCT_AUDIENCE, isProductVisibleTo, } from '@endora-commerce/contracts';
+import { SalesChannel } from '@endora-commerce/platform/kernel';
+import { SitemapCache } from '../entities/sitemap-cache.entity.js';
+/**
+ * SitemapGeneratorService — per-channel sitemap.
+ *
+ * One sitemap is produced per active Sales Channel. Membership-bridge
+ * tables (`sales_channel_products`, `sales_channel_categories`,
+ * `sales_channel_cms_pages`) decide what each channel's sitemap contains
+ * so a crawler hitting `https://channel-a.example.com/sitemap.xml` does
+ * not see URLs that only belong to channel B.
+ *
+ * Storefront origin used when stamping URLs is read from the per-channel
+ * setting `sales_channels.storefront_url` (see the sales_channels module
+ * manifest); empty value falls back to the `STOREFRONT_BASE_URL` env, then
+ * to `http://localhost:3000`.
+ *
+ * Cache: one row per channel in `sitemap_cache`, keyed by the channel
+ * `code` (varchar(32)). Regenerate is per-channel; the public route
+ * resolves the channel from the request scope and serves that row.
+ *
+ * Anonymous-visible only: products with `visibility != 'public'` and
+ * archived/deleted rows are excluded so we don't leak internal SKUs into
+ * crawlers.
+ *
+ * Feature 075, Phase C — the three entity reads go through their owners'
+ * published read ports and the membership lookup through
+ * `salesChannelMembershipPort`, which is the sanctioned bridge accessor of
+ * Constitution XII. Both were the same defect in two disguises: the entity
+ * reads were imports no gate can reach, and the membership read was three
+ * hand-written `SELECT`s against `sales_channel_products`,
+ * `sales_channel_categories` and `sales_channel_cms_pages` — which
+ * `check-module-boundary` cannot see at all, because raw SQL names no
+ * specifier. `catalog` and `cms` are binding dependencies: a sitemap that
+ * silently drops every product URL still parses as a sitemap, which is exactly
+ * why it must not be produced.
+ */
+const DEFAULT_STALE_AFTER_MS = 6 * 60 * 60 * 1000; // 6 hours
+const STOREFRONT_URL_SETTING = 'sales_channels.storefront_url';
+/** How many member ids one bridge read fetches. The port's own default is 100. */
+const MEMBERSHIP_PAGE_SIZE = 500;
+export class SitemapGeneratorService {
+    emFactory;
+    settings;
+    membership;
+    catalogProducts;
+    catalogCategories;
+    cmsPages;
+    fallbackBaseUrl;
+    staleAfterMs;
+    constructor(emFactory, settings, 
+    /** What this channel contains, and what those rows are (feature 075, Phase C). */
+    membership, catalogProducts, catalogCategories, cmsPages, options = {}) {
+        this.emFactory = emFactory;
+        this.settings = settings;
+        this.membership = membership;
+        this.catalogProducts = catalogProducts;
+        this.catalogCategories = catalogCategories;
+        this.cmsPages = cmsPages;
+        this.fallbackBaseUrl =
+            options.baseUrl ??
+                process.env['STOREFRONT_BASE_URL'] ??
+                'http://localhost:3000';
+        this.staleAfterMs = options.staleAfterMs ?? DEFAULT_STALE_AFTER_MS;
+    }
+    /**
+     * Serve the sitemap for a single channel; regenerates inline when stale
+     * or when no cache row exists yet.
+     */
+    async getOrGenerateForChannel(salesChannelCode) {
+        const em = this.emFactory();
+        const cache = await em.findOne(SitemapCache, { key: salesChannelCode });
+        if (cache && Date.now() - cache.generatedAt.getTime() < this.staleAfterMs) {
+            return { payload: cache.payload, generatedAt: cache.generatedAt };
+        }
+        return this.regenerateForChannel(salesChannelCode);
+    }
+    async regenerateForChannel(salesChannelCode) {
+        // command-coverage-ignore: idempotent lifecycle reconciler/seed — a system-
+        // invariant repair, not an operator-initiated audited write.
+        const em = this.emFactory();
+        const channel = await em.findOne(SalesChannel, { code: salesChannelCode });
+        if (channel === null) {
+            throw new Error(`Unknown sales channel code "${salesChannelCode}".`);
+        }
+        const baseUrl = await this.resolveStorefrontUrl(channel);
+        const memberIds = await this.collectChannelMemberIds(channel.id);
+        // Each read keeps the filter and the ordering the SQL spelled. `liveOnly`
+        // and `activeOnly` are the port's names for the `deleted_at is null` and
+        // `status = 'active'` halves; `visibility`, `archivedAt`, `isActive` and
+        // `active` are columns on the records, so those predicates stay here — the
+        // same conditions, evaluated one layer up.
+        const products = (await this.catalogProducts.findByIds([...memberIds.products], {
+            liveOnly: true,
+            activeOnly: true,
+        }))
+            // Issue #227 — `visibility === 'public'` was here, and it is not the
+            // whole answer: an operator can save `public` **with** a non-empty
+            // `allowed_organization_ids`, which restricts the row to the
+            // organisations it names whatever the visibility column says. A sitemap
+            // is read by crawlers, so the audience is the anonymous one, and
+            // `isProductVisibleTo` answers both columns for it — the `public` half
+            // unchanged, the allow-list half for the first time.
+            .filter((p) => isProductVisibleTo(p, ANONYMOUS_PRODUCT_AUDIENCE) && p.archivedAt === null)
+            .sort((a, b) => b.updatedAt.getTime() - a.updatedAt.getTime());
+        // Feature 068 — a deactivated category is not a customer-reachable URL, so
+        // it must not be advertised to crawlers.
+        const categories = (await this.catalogCategories.findByIds([...memberIds.categories], { liveOnly: true }))
+            .filter((c) => c.isActive)
+            .sort((a, b) => a.sortOrder - b.sortOrder);
+        const cmsPages = (await this.cmsPages.findByIds([...memberIds.cmsPages]))
+            .filter((page) => page.status === 'published' && page.active)
+            .sort((a, b) => a.slug.localeCompare(b.slug));
+        const urls = [];
+        for (const c of categories) {
+            urls.push({
+                loc: `${baseUrl}/c/${c.slug}`,
+                lastmod: c.updatedAt,
+                changefreq: 'weekly',
+                priority: 0.7,
+            });
+        }
+        for (const page of cmsPages) {
+            urls.push({
+                loc: `${baseUrl}/${page.slug}`,
+                lastmod: page.publishedAt ?? page.updatedAt,
+                changefreq: 'monthly',
+                priority: 0.5,
+            });
+        }
+        for (const p of products) {
+            urls.push({
+                loc: `${baseUrl}/p/${p.slug}`,
+                lastmod: p.updatedAt,
+                changefreq: 'daily',
+                priority: 0.8,
+            });
+        }
+        const payload = renderSitemap(urls);
+        const now = new Date();
+        const cache = await em.findOne(SitemapCache, { key: salesChannelCode });
+        if (cache) {
+            cache.payload = payload;
+            cache.urlCount = urls.length;
+            cache.byteSize = Buffer.byteLength(payload, 'utf8');
+            cache.generatedAt = now;
+        }
+        else {
+            em.create(SitemapCache, {
+                key: salesChannelCode,
+                payload,
+                urlCount: urls.length,
+                byteSize: Buffer.byteLength(payload, 'utf8'),
+                generatedAt: now,
+            });
+        }
+        await em.flush();
+        return { payload, generatedAt: now };
+    }
+    async getStatusForChannel(salesChannelCode) {
+        const em = this.emFactory();
+        const cache = await em.findOne(SitemapCache, { key: salesChannelCode });
+        if (!cache)
+            return { generatedAt: null, byteSize: null, urlCount: null };
+        return {
+            generatedAt: cache.generatedAt,
+            byteSize: cache.byteSize,
+            urlCount: cache.urlCount,
+        };
+    }
+    /**
+     * Per-channel admin overview: one row per active channel, with the
+     * cache stats (or NULLs when never generated) and the resolved
+     * storefront URL.
+     */
+    async listChannelStatuses() {
+        const em = this.emFactory();
+        const channels = await em.find(SalesChannel, { active: true }, { orderBy: { systemDefault: 'desc', code: 'asc' } });
+        const out = [];
+        for (const channel of channels) {
+            const cache = await em.findOne(SitemapCache, { key: channel.code });
+            const { url, source } = await this.resolveStorefrontUrlSource(channel);
+            out.push({
+                salesChannelCode: channel.code,
+                salesChannelName: pickName(channel),
+                storefrontUrl: url,
+                storefrontUrlSource: source,
+                generatedAt: cache?.generatedAt ?? null,
+                byteSize: cache?.byteSize ?? null,
+                urlCount: cache?.urlCount ?? null,
+            });
+        }
+        return out;
+    }
+    // --- internals -----------------------------------------------------------
+    async resolveStorefrontUrl(channel) {
+        const { url } = await this.resolveStorefrontUrlSource(channel);
+        return trimTrailingSlash(url);
+    }
+    async resolveStorefrontUrlSource(channel) {
+        if (this.settings) {
+            try {
+                const fromSetting = await this.settings.get(STOREFRONT_URL_SETTING, channel.id, z.string());
+                if (fromSetting && fromSetting.trim() !== '') {
+                    return { url: fromSetting.trim(), source: 'setting' };
+                }
+            }
+            catch {
+                // Not registered or out of scope — fall through to env / fallback.
+            }
+        }
+        const fromEnv = process.env['STOREFRONT_BASE_URL'];
+        if (fromEnv && fromEnv.trim() !== '') {
+            return { url: fromEnv.trim(), source: 'env' };
+        }
+        return { url: this.fallbackBaseUrl, source: 'fallback' };
+    }
+    /**
+     * What belongs to this channel, through the sanctioned bridge accessor
+     * (Constitution XII). This was three hand-written `SELECT`s against
+     * `sales_channel_products`, `sales_channel_categories` and
+     * `sales_channel_cms_pages` — the tables `SalesChannelMembershipPort`'s own
+     * doc comment says a module must not reach for, and the one cross-module
+     * read in this file that `check-module-boundary` could never have found,
+     * because raw SQL names no import specifier.
+     */
+    async collectChannelMemberIds(salesChannelId) {
+        const [products, categories, cmsPages] = await Promise.all([
+            this.allMemberIds(salesChannelId, 'product'),
+            this.allMemberIds(salesChannelId, 'category'),
+            this.allMemberIds(salesChannelId, 'cms-page'),
+        ]);
+        return { products, categories, cmsPages };
+    }
+    /**
+     * Every member id, not the first page of them. `listEntityIdsForChannel` is
+     * paginated and defaults to 100; a sitemap wants the channel's whole
+     * catalogue, so the pages are walked to `total`. `total` is re-read on each
+     * call and the loop is bounded by it, so a concurrent membership write
+     * cannot spin it.
+     */
+    async allMemberIds(salesChannelId, entityType) {
+        const ids = new Set();
+        for (let page = 0;; page += 1) {
+            const { entityIds, total } = await this.membership.listEntityIdsForChannel(salesChannelId, entityType, page, MEMBERSHIP_PAGE_SIZE);
+            for (const id of entityIds)
+                ids.add(id);
+            if (entityIds.length === 0 || ids.size >= total)
+                return ids;
+        }
+    }
+}
+function renderSitemap(urls) {
+    const items = urls.map((u) => `  <url><loc>${escapeXml(u.loc)}</loc><lastmod>${u.lastmod.toISOString()}</lastmod>` +
+        `<changefreq>${u.changefreq}</changefreq><priority>${u.priority.toFixed(1)}</priority></url>`);
+    return [
+        '<?xml version="1.0" encoding="UTF-8"?>',
+        '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',
+        ...items,
+        '</urlset>',
+        '',
+    ].join('\n');
+}
+function escapeXml(value) {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&apos;');
+}
+function trimTrailingSlash(s) {
+    return s.endsWith('/') ? s.slice(0, -1) : s;
+}
+function pickName(channel) {
+    const map = channel.name ?? {};
+    const codes = [];
+    if (channel.defaultLanguage)
+        codes.push(channel.defaultLanguage);
+    codes.push('en', 'en-US', 'pl', 'pl-PL');
+    for (const code of codes) {
+        const v = map[code];
+        if (typeof v === 'string' && v)
+            return v;
+    }
+    for (const v of Object.values(map)) {
+        if (typeof v === 'string' && v)
+            return v;
+    }
+    return channel.code;
+}
+//# sourceMappingURL=sitemap-generator.service.js.map

package/dist/backend/services/sitemap-generator.service.js.map

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

package/dist/manifest.d.ts

@@ -0,0 +1,169 @@
+/**
+ * SEO module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+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" | "invoice" | "email" | "newsletter")[];
+        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" | "invoice" | "email" | "newsletter")[];
+        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;
+};
+//# 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":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCnB,CAAC"}

package/dist/manifest.js

@@ -0,0 +1,49 @@
+import { defineModuleManifest } from '@endora-commerce/contracts';
+/**
+ * SEO module — manifest backfill (Module Lifecycle, feature 018).
+ *
+ * Predates the lifecycle system; this manifest is the static record
+ * required so the module participates in the registry. No install /
+ * uninstall hook today — the module's schema is owned by earlier
+ * platform-wide migrations.
+ */
+export const manifest = defineModuleManifest({
+    id: 'seo',
+    name: 'SEO',
+    description: 'SEO metadata management for catalog, CMS, and blog surfaces.',
+    version: '1.0.0',
+    // `auth` owns the `requireAdmin` port the admin routes are gated by. Feature
+    // 072 made it a container resolution rather than a constructor argument.
+    //
+    // `catalog` and `cms` arrived with feature 075 Phase C. Both edges were
+    // always real — the meta-tag resolver and the sitemap read their tables
+    // directly — and both are **binding**: a sitemap that silently drops every
+    // product or page URL still parses as a sitemap, and a crawler cannot tell
+    // it from a shop that genuinely sells nothing. Refusing is the honest
+    // answer. Meta tags likewise describe a page a customer can reach, which a
+    // switched-off `catalog` or `cms` no longer serves.
+    dependencies: ['auth', 'catalog', 'cms'],
+    settings: {
+        moduleCode: 'seo',
+        groups: [{ code: 'seo', name: 'SEO' }],
+        settings: [
+            {
+                // Feature 073 — the operator's activation control. Platform-wide.
+                code: 'seo.enabled',
+                name: 'SEO enabled',
+                description: 'Switches the meta-tag override screens, their API and the generated sitemap on or off. Nothing is dropped: overrides stay in the database and the sitemap regenerates from them when you switch it back on.',
+                groupCode: 'seo',
+                valueType: 'boolean',
+                defaultValue: true,
+            },
+        ],
+    },
+    // Feature 091 (Phase 4, batch 8) — this module ships a bundle now: its
+    // sidebar entry's `labelKey` is module-relative (R8) and resolves in this
+    // module's own namespace. Its screen's copy stays in `_i18n`'s `core`
+    // scope, which is batch 4's shape and not a new one.
+    i18n: { bundlesDir: 'i18n' },
+    docs: { dir: 'docs' },
+    activation: { settingCode: 'seo.enabled', default: true },
+});
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAElE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,oBAAoB,CAAC;IAC3C,EAAE,EAAE,KAAK;IACT,IAAI,EAAE,KAAK;IACX,WAAW,EACT,8DAA8D;IAChE,OAAO,EAAE,OAAO;IAChB,6EAA6E;IAC7E,yEAAyE;IACzE,EAAE;IACF,wEAAwE;IACxE,wEAAwE;IACxE,2EAA2E;IAC3E,2EAA2E;IAC3E,sEAAsE;IACtE,2EAA2E;IAC3E,oDAAoD;IACpD,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC;IACxC,QAAQ,EAAE;QACR,UAAU,EAAE,KAAK;QACjB,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACtC,QAAQ,EAAE;YACR;gBACE,kEAAkE;gBAClE,IAAI,EAAE,aAAa;gBACnB,IAAI,EAAE,aAAa;gBACnB,WAAW,EACT,6MAA6M;gBAC/M,SAAS,EAAE,KAAK;gBAChB,SAAS,EAAE,SAAS;gBACpB,YAAY,EAAE,IAAI;aACnB;SACF;KACF;IACD,uEAAuE;IACvE,0EAA0E;IAC1E,sEAAsE;IACtE,qDAAqD;IACrD,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE;IAC5B,IAAI,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE;IACrB,UAAU,EAAE,EAAE,WAAW,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,EAAE;CAC1D,CAAC,CAAC"}

package/dist/migrations/20260425T154404_seo_init.d.ts

@@ -0,0 +1,11 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * SEO module init (T235). Two tables:
+ *   - seo_meta_overrides: per-(entity, locale) editorial overrides.
+ *   - sitemap_cache: singleton cache row for the public XML sitemap.
+ */
+export declare class Migration20260425T154404SeoInit extends Migration {
+    up(): Promise<void>;
+    down(): Promise<void>;
+}
+//# sourceMappingURL=20260425T154404_seo_init.d.ts.map

package/dist/migrations/20260425T154404_seo_init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260425T154404_seo_init.d.ts","sourceRoot":"","sources":["../../src/migrations/20260425T154404_seo_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;GAIG;AACH,qBAAa,+BAAgC,SAAQ,SAAS;IAC7C,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC;IAkCnB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAIrC"}