@endora-commerce/mod-seo 0.100.0

package/dist/backend/index.d.ts

@@ -0,0 +1,57 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { MetaTagResolverService } from './services/meta-tag-resolver.service.js';
+import { SitemapGeneratorService, type SitemapGeneratorOptions, type SitemapSettingsPort } from './services/sitemap-generator.service.js';
+import { SeoMetaOverride } from './entities/seo-meta-override.entity.js';
+import { SitemapCache } from './entities/sitemap-cache.entity.js';
+/**
+ * `seo` — the sitemap that only read its setting in production (feature 072,
+ * wave 2, T117).
+ *
+ * `SitemapGeneratorService` resolves a channel's base URL in three steps:
+ * the per-channel `sales_channels.storefront_url` setting, then
+ * `STOREFRONT_BASE_URL`, then a fallback. The settings port that makes the
+ * first step possible was an optional constructor argument, `composition.ts`
+ * passed one and `test-server.ts` did not — so under the harness that step has
+ * never existed and every sitemap URL has come from env or fallback.
+ *
+ * That is the `cms` shape again, in its quieter form: not an endpoint that
+ * 500s, but a resolution step that silently is not there, producing a
+ * plausible answer from the next rung down. Resolving `settingsReadPort` here
+ * gives both compositions the same three steps.
+ *
+ * `sitemapOptions` stays a contribution point rather than becoming env-derived.
+ * It is genuinely composition-specific — the harness pins `staleAfterMs: 0` so
+ * regeneration is deterministic and a fixed `baseUrl` so an assertion has
+ * something stable to match — and a module should not have to know which of its
+ * callers is a test.
+ *
+ * `auditLog` stops being optional: SEO overrides are admin writes, and an
+ * optional audit sink defaults to not recording.
+ */
+export interface SeoCradle {
+    readonly emFactory: () => EntityManager;
+    readonly auditLogService: AuditPort;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly settingsReadPort: SitemapSettingsPort;
+    /** Composition-specific sitemap tuning; `{}` in production. */
+    readonly sitemapOptions: SitemapGeneratorOptions;
+    readonly seoMetaResolver: MetaTagResolverService;
+    readonly seoSitemapService: SitemapGeneratorService;
+}
+export declare function registerModule(ctx: ModuleContext): void;
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export declare const entities: (typeof SeoMetaOverride | typeof SitemapCache)[];
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAO3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AAEtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EACL,uBAAuB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EACzB,MAAM,yCAAyC,CAAC;AAEjD,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAElE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IAC/C,+DAA+D;IAC/D,QAAQ,CAAC,cAAc,EAAE,uBAAuB,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,sBAAsB,CAAC;IACjD,QAAQ,CAAC,iBAAiB,EAAE,uBAAuB,CAAC;CACrD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA6DvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,kDAGpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,58 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { MetaTagResolverService } from './services/meta-tag-resolver.service.js';
+import { SitemapGeneratorService, } from './services/sitemap-generator.service.js';
+import { registerSeoRoutes } from './routes.js';
+import { SeoMetaOverride } from './entities/seo-meta-override.entity.js';
+import { SitemapCache } from './entities/sitemap-cache.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        sitemapOptions: ctx.asFunction(() => ({})).singleton(),
+        seoMetaResolver: ctx
+            .asFunction(({ emFactory, auditLogService }) => new MetaTagResolverService(emFactory, auditLogService, 
+        // Feature 075, Phase C. Never captured: the proxies resolve per
+        // call, so a switched-off owner answers 503 `MODULE_DISABLED` at
+        // the call rather than through a gate frozen at composition time.
+        lazyPort(ctx, 'catalogProductReadPort'), lazyPort(ctx, 'catalogCategoryReadPort'), lazyPort(ctx, 'cmsPageReadPort')))
+            .singleton(),
+        seoSitemapService: ctx
+            .asFunction(({ emFactory, sitemapOptions }) => new SitemapGeneratorService(emFactory, lazyPort(ctx, 'settingsReadPort'), lazyPort(ctx, 'salesChannelMembershipPort'), lazyPort(ctx, 'catalogProductReadPort'), lazyPort(ctx, 'catalogCategoryReadPort'), lazyPort(ctx, 'cmsPageReadPort'), sitemapOptions))
+            .singleton(),
+    });
+    ctx.di.providePort('seoMetaWritePort', ctx
+        .asFunction(({ seoMetaResolver }) => ({
+        async upsertProductMeta(input) {
+            await seoMetaResolver.upsertOverride({
+                entityType: 'product',
+                entityId: input.productId,
+                locale: input.locale,
+                ...(input.title !== undefined ? { title: input.title } : {}),
+                ...(input.description !== undefined ? { description: input.description } : {}),
+            });
+        },
+    }))
+        .singleton());
+    ctx.routes(async (app) => {
+        const { seoMetaResolver, seoSitemapService, requireAdmin } = ctx.cradle();
+        await registerSeoRoutes(app, {
+            metaResolver: seoMetaResolver,
+            sitemap: seoSitemapService,
+            requireAdmin,
+        });
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export const entities = [
+    SeoMetaOverride,
+    SitemapCache,
+];
+//# sourceMappingURL=index.js.map

package/dist/backend/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/backend/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAG5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EACL,uBAAuB,GAGxB,MAAM,yCAAyC,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,wCAAwC,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAuClE,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC;QACd,cAAc,EAAE,GAAG,CAAC,UAAU,CAAC,GAA4B,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE;QAE/E,eAAe,EAAE,GAAG;aACjB,UAAU,CACT,CAAC,EAAE,SAAS,EAAE,eAAe,EAAa,EAAE,EAAE,CAC5C,IAAI,sBAAsB,CACxB,SAAS,EACT,eAAe;QACf,gEAAgE;QAChE,iEAAiE;QACjE,kEAAkE;QAClE,QAAQ,CAAyB,GAAG,EAAE,wBAAwB,CAAC,EAC/D,QAAQ,CAA0B,GAAG,EAAE,yBAAyB,CAAC,EACjE,QAAQ,CAAkB,GAAG,EAAE,iBAAiB,CAAC,CAClD,CACJ;aACA,SAAS,EAAE;QAEd,iBAAiB,EAAE,GAAG;aACnB,UAAU,CACT,CAAC,EAAE,SAAS,EAAE,cAAc,EAAa,EAAE,EAAE,CAC3C,IAAI,uBAAuB,CACzB,SAAS,EACT,QAAQ,CAAsB,GAAG,EAAE,kBAAkB,CAAC,EACtD,QAAQ,CAA6B,GAAG,EAAE,4BAA4B,CAAC,EACvE,QAAQ,CAAyB,GAAG,EAAE,wBAAwB,CAAC,EAC/D,QAAQ,CAA0B,GAAG,EAAE,yBAAyB,CAAC,EACjE,QAAQ,CAAkB,GAAG,EAAE,iBAAiB,CAAC,EACjD,cAAc,CACf,CACJ;aACA,SAAS,EAAE;KACf,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,WAAW,CAChB,kBAAkB,EAClB,GAAG;SACA,UAAU,CAAC,CAAC,EAAE,eAAe,EAAa,EAAoB,EAAE,CAAC,CAAC;QACjE,KAAK,CAAC,iBAAiB,CAAC,KAAK;YAC3B,MAAM,eAAe,CAAC,cAAc,CAAC;gBACnC,UAAU,EAAE,SAAS;gBACrB,QAAQ,EAAE,KAAK,CAAC,SAAS;gBACzB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,CAAC,KAAK,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/E,CAAC,CAAC;QACL,CAAC;KACF,CAAC,CAAC;SACF,SAAS,EAAE,CACf,CAAC;IAEF,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,EAAE,eAAe,EAAE,iBAAiB,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,MAAM,EAAa,CAAC;QACrF,MAAM,iBAAiB,CAAC,GAAG,EAAE;YAC3B,YAAY,EAAE,eAAe;YAC7B,OAAO,EAAE,iBAAiB;YAC1B,YAAY;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,eAAe;IACf,YAAY;CACb,CAAC"}

package/dist/backend/routes.d.ts

@@ -0,0 +1,11 @@
+import type { FastifyInstance } from 'fastify';
+import type { MetaTagResolverService } from './services/meta-tag-resolver.service.js';
+import type { SitemapGeneratorService } from './services/sitemap-generator.service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export interface SeoRoutesDeps {
+    metaResolver: MetaTagResolverService;
+    sitemap: SitemapGeneratorService;
+    requireAdmin: RequireAdminFactory;
+}
+export declare function registerSeoRoutes(app: FastifyInstance, deps: SeoRoutesDeps): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACtF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yCAAyC,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAG5E,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,sBAAsB,CAAC;IACrC,OAAO,EAAE,uBAAuB,CAAC;IACjC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,IAAI,CAAC,CAgNf"}

package/dist/backend/routes.js

@@ -0,0 +1,158 @@
+import { seoEntityTypeSchema, upsertSeoMetaOverrideRequestSchema, } from '@endora-commerce/contracts';
+import { currentSalesChannel } from '@endora-commerce/platform/kernel';
+export async function registerSeoRoutes(app, deps) {
+    const { metaResolver, sitemap, requireAdmin } = deps;
+    // -- Public sitemap -------------------------------------------------------
+    //
+    // Resolves the channel from the request scope (filled by the
+    // SalesChannelResolverMiddleware via header / query / host map / system
+    // default). Each channel has its own cache row; if the resolver did not
+    // resolve a channel (e.g. middleware bypass in tests), we serve nothing.
+    app.get('/api/v1/catalog/sitemap.xml', { config: { streamingResponse: true } }, async (_request, reply) => {
+        const channel = currentSalesChannel();
+        if (!channel) {
+            reply
+                .status(503)
+                .header('Content-Type', 'application/xml; charset=utf-8')
+                .header('Cache-Control', 'no-store');
+            return '<?xml version="1.0" encoding="UTF-8"?>\n<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"/>\n';
+        }
+        const { payload } = await sitemap.getOrGenerateForChannel(channel.code);
+        reply
+            .header('Content-Type', 'application/xml; charset=utf-8')
+            .header('Cache-Control', 'public, max-age=3600');
+        return payload;
+    });
+    // -- Admin: per-channel listing ------------------------------------------
+    app.get('/api/v1/admin/seo/sitemap', { preHandler: requireAdmin('catalog:write') }, async () => {
+        const rows = await sitemap.listChannelStatuses();
+        return {
+            data: rows.map((r) => ({
+                salesChannelCode: r.salesChannelCode,
+                salesChannelName: r.salesChannelName,
+                storefrontUrl: r.storefrontUrl,
+                storefrontUrlSource: r.storefrontUrlSource,
+                generatedAt: r.generatedAt?.toISOString() ?? null,
+                urlCount: r.urlCount,
+                byteSize: r.byteSize,
+            })),
+        };
+    });
+    // -- Admin: per-channel regenerate ---------------------------------------
+    app.post('/api/v1/admin/seo/sitemap/:channelCode/regenerate', { preHandler: requireAdmin('catalog:write') }, async (request) => {
+        const { channelCode } = request.params;
+        const { generatedAt } = await sitemap.regenerateForChannel(channelCode);
+        const status = await sitemap.getStatusForChannel(channelCode);
+        return {
+            data: {
+                salesChannelCode: channelCode,
+                generatedAt: generatedAt.toISOString(),
+                urlCount: status.urlCount ?? 0,
+                byteSize: status.byteSize ?? 0,
+            },
+        };
+    });
+    // -- Admin: per-channel status -------------------------------------------
+    app.get('/api/v1/admin/seo/sitemap/:channelCode/status', { preHandler: requireAdmin('catalog:write') }, async (request) => {
+        const status = await sitemap.getStatusForChannel(request.params.channelCode);
+        return {
+            data: {
+                salesChannelCode: request.params.channelCode,
+                generatedAt: status.generatedAt?.toISOString() ?? null,
+                urlCount: status.urlCount,
+                byteSize: status.byteSize,
+            },
+        };
+    });
+    // -- Admin: preview / download cached XML --------------------------------
+    //
+    // `?download=1` flips Content-Disposition to attachment so the browser
+    // saves the XML; otherwise the response renders inline (the admin UI
+    // opens it in a new tab for preview).
+    app.get('/api/v1/admin/seo/sitemap/:channelCode/xml', { preHandler: requireAdmin('catalog:write'), config: { streamingResponse: true } }, async (request, reply) => {
+        const { channelCode } = request.params;
+        const { payload } = await sitemap.getOrGenerateForChannel(channelCode);
+        reply
+            .header('Content-Type', 'application/xml; charset=utf-8')
+            .header('Cache-Control', 'no-store');
+        const isDownload = typeof request.query.download === 'string' &&
+            request.query.download !== '' &&
+            request.query.download !== '0' &&
+            request.query.download.toLowerCase() !== 'false';
+        if (isDownload) {
+            reply.header('Content-Disposition', `attachment; filename="sitemap-${channelCode}.xml"`);
+        }
+        else {
+            reply.header('Content-Disposition', 'inline');
+        }
+        return payload;
+    });
+    // -- Meta editor ----------------------------------------------------------
+    app.get('/api/v1/admin/seo/meta/:entityType/:entityId', { preHandler: requireAdmin('catalog:write') }, async (request) => {
+        const entityType = seoEntityTypeSchema.parse(request.params.entityType);
+        const locale = request.query.locale ?? 'en-US';
+        const resolved = await metaResolver.resolve({
+            entityType,
+            entityId: request.params.entityId,
+            locale,
+        });
+        const override = await metaResolver.getOverride({
+            entityType,
+            entityId: request.params.entityId,
+            locale,
+        });
+        return {
+            data: {
+                resolved,
+                override: override
+                    ? {
+                        title: override.title ?? null,
+                        description: override.description ?? null,
+                        ogTitle: override.ogTitle ?? null,
+                        ogDescription: override.ogDescription ?? null,
+                        ogImageUrl: override.ogImageUrl ?? null,
+                    }
+                    : null,
+            },
+        };
+    });
+    app.put('/api/v1/admin/seo/meta/:entityType/:entityId', {
+        preHandler: requireAdmin('catalog:write'),
+        schema: { body: upsertSeoMetaOverrideRequestSchema },
+    }, async (request) => {
+        const entityType = seoEntityTypeSchema.parse(request.params.entityType);
+        const body = upsertSeoMetaOverrideRequestSchema.parse(request.body);
+        const row = await metaResolver.upsertOverride({
+            entityType,
+            entityId: request.params.entityId,
+            locale: body.locale,
+            ...(body.title !== undefined ? { title: body.title } : {}),
+            ...(body.description !== undefined ? { description: body.description } : {}),
+            ...(body.ogTitle !== undefined ? { ogTitle: body.ogTitle } : {}),
+            ...(body.ogDescription !== undefined ? { ogDescription: body.ogDescription } : {}),
+            ...(body.ogImageUrl !== undefined ? { ogImageUrl: body.ogImageUrl } : {}),
+        });
+        return {
+            data: {
+                id: row.id,
+                locale: row.locale,
+                title: row.title ?? null,
+                description: row.description ?? null,
+                ogTitle: row.ogTitle ?? null,
+                ogDescription: row.ogDescription ?? null,
+                ogImageUrl: row.ogImageUrl ?? null,
+            },
+        };
+    });
+    app.delete('/api/v1/admin/seo/meta/:entityType/:entityId', { preHandler: requireAdmin('catalog:write') }, async (request, reply) => {
+        const entityType = seoEntityTypeSchema.parse(request.params.entityType);
+        const locale = request.query.locale ?? 'en-US';
+        await metaResolver.deleteOverride({
+            entityType,
+            entityId: request.params.entityId,
+            locale,
+        });
+        return reply.status(204).send();
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/backend/routes.js.map

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

package/dist/backend/services/meta-tag-resolver.service.d.ts

@@ -0,0 +1,54 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { CatalogCategoryReadPort, CatalogCategoryRecord, CatalogProductReadPort, CatalogProductRecord, CmsPageReadPort, CmsPageRecord, ResolvedMeta, SeoEntityType } from '@endora-commerce/contracts';
+import type { AuditPort } from '@endora-commerce/platform/kernel';
+import { SeoMetaOverride } from '../entities/seo-meta-override.entity.js';
+export interface RuleBuilderInput {
+    product?: CatalogProductRecord;
+    category?: CatalogCategoryRecord;
+    cmsPage?: CmsPageRecord;
+}
+export declare class MetaTagResolverService {
+    #private;
+    private readonly emFactory;
+    private readonly auditLog;
+    /** The three rows a rule is derived from, asked of the modules that own them. */
+    private readonly catalogProducts;
+    private readonly catalogCategories;
+    private readonly cmsPages;
+    constructor(emFactory: () => EntityManager, auditLog: AuditPort | undefined, 
+    /** The three rows a rule is derived from, asked of the modules that own them. */
+    catalogProducts: CatalogProductReadPort, catalogCategories: CatalogCategoryReadPort, cmsPages: CmsPageReadPort);
+    resolve(input: {
+        entityType: SeoEntityType;
+        entityId: string;
+        locale: string;
+    }): Promise<ResolvedMeta>;
+    getOverride(input: {
+        entityType: SeoEntityType;
+        entityId: string;
+        locale: string;
+    }): Promise<SeoMetaOverride | null>;
+    upsertOverride(input: {
+        entityType: SeoEntityType;
+        entityId: string;
+        locale: string;
+        title?: string | null;
+        description?: string | null;
+        ogTitle?: string | null;
+        ogDescription?: string | null;
+        ogImageUrl?: string | null;
+    }): Promise<SeoMetaOverride>;
+    deleteOverride(input: {
+        entityType: SeoEntityType;
+        entityId: string;
+        locale: string;
+    }): Promise<void>;
+    private findOverride;
+    private loadRuleSource;
+}
+export declare function buildRuleMeta(entityType: SeoEntityType, source: RuleBuilderInput, locale: string): {
+    title: string;
+    description: string;
+    openGraph: ResolvedMeta['openGraph'];
+};
+//# sourceMappingURL=meta-tag-resolver.service.d.ts.map

package/dist/backend/services/meta-tag-resolver.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-tag-resolver.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/meta-tag-resolver.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D,OAAO,KAAK,EACV,uBAAuB,EACvB,qBAAqB,EACrB,sBAAsB,EACtB,oBAAoB,EACpB,eAAe,EACf,aAAa,EACb,YAAY,EACZ,aAAa,EACd,MAAM,4BAA4B,CAAC;AAGpC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAyB1E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAED,qBAAa,sBAAsB;;IAE/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,iFAAiF;IACjF,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBALR,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,SAAS,GAAG,SAAS;IAChD,iFAAiF;IAChE,eAAe,EAAE,sBAAsB,EACvC,iBAAiB,EAAE,uBAAuB,EAC1C,QAAQ,EAAE,eAAe;IAStC,OAAO,CAAC,KAAK,EAAE;QACnB,UAAU,EAAE,aAAa,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,YAAY,CAAC;IAuBnB,WAAW,CAAC,KAAK,EAAE;QACvB,UAAU,EAAE,aAAa,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,eAAe,GAAG,IAAI,CAAC;IAI7B,cAAc,CAAC,KAAK,EAAE;QAC1B,UAAU,EAAE,aAAa,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC5B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC5B,GAAG,OAAO,CAAC,eAAe,CAAC;IAqCtB,cAAc,CAAC,KAAK,EAAE;QAC1B,UAAU,EAAE,aAAa,CAAC;QAC1B,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,IAAI,CAAC;YASH,YAAY;YAOZ,cAAc;CAgC7B;AAED,wBAAgB,aAAa,CAC3B,UAAU,EAAE,aAAa,EACzB,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,MAAM,GACb;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAAA;CAAE,CAgD9E"}

package/dist/backend/services/meta-tag-resolver.service.js

@@ -0,0 +1,208 @@
+import { ERROR_CODES } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { recordAuditFromContext } from '@endora-commerce/platform/commands';
+import { SeoMetaOverride } from '../entities/seo-meta-override.entity.js';
+/**
+ * MetaTagResolverService (T235 / FR-101).
+ *
+ * Resolution order:
+ *   1. Look up the per-(entity, locale) override row.
+ *   2. If a field is set on the override, use it verbatim.
+ *   3. Otherwise fall back to the rule derived from the entity (Product
+ *      name + description, Category name, etc.).
+ *
+ * Locale fallback: if no override exists for the requested locale, try
+ * `en-US`, then return rule-only.
+ *
+ * The three rule sources arrive over their owners' published read ports
+ * (feature 075, Phase C) rather than out of `catalog`'s and `cms`' tables.
+ * Both edges fail closed, which is the answer a meta tag should get: the tags
+ * describe a page a customer can reach, and a switched-off `catalog` or `cms`
+ * means there is no such page to describe.
+ */
+const FALLBACK_LOCALE = 'en-US';
+const TITLE_MAX = 60;
+const DESCRIPTION_MAX = 160;
+export class MetaTagResolverService {
+    emFactory;
+    auditLog;
+    catalogProducts;
+    catalogCategories;
+    cmsPages;
+    constructor(emFactory, auditLog, 
+    /** The three rows a rule is derived from, asked of the modules that own them. */
+    catalogProducts, catalogCategories, cmsPages) {
+        this.emFactory = emFactory;
+        this.auditLog = auditLog;
+        this.catalogProducts = catalogProducts;
+        this.catalogCategories = catalogCategories;
+        this.cmsPages = cmsPages;
+    }
+    #audit(em, action, objectId, stateBefore, stateAfter) {
+        if (this.auditLog) {
+            recordAuditFromContext(this.auditLog, em, { action, objectType: 'seo_meta_override', objectId, stateBefore, stateAfter });
+        }
+    }
+    async resolve(input) {
+        const em = this.emFactory();
+        const ruleSource = await this.loadRuleSource(input.entityType, input.entityId);
+        const rule = buildRuleMeta(input.entityType, ruleSource, input.locale);
+        const override = await this.findOverride(em, input);
+        if (!override) {
+            return { ...rule, source: 'rule', locale: input.locale };
+        }
+        return {
+            title: override.title ?? rule.title,
+            description: override.description ?? rule.description,
+            openGraph: {
+                title: override.ogTitle ?? rule.openGraph.title,
+                description: override.ogDescription ?? rule.openGraph.description,
+                image: override.ogImageUrl ?? rule.openGraph.image,
+            },
+            source: 'override',
+            locale: input.locale,
+        };
+    }
+    async getOverride(input) {
+        return this.findOverride(this.emFactory(), input);
+    }
+    async upsertOverride(input) {
+        const em = this.emFactory();
+        // Validate the entity actually exists so an admin typo doesn't write a
+        // dangling row.
+        await this.loadRuleSource(input.entityType, input.entityId);
+        const existing = await em.findOne(SeoMetaOverride, {
+            entityType: input.entityType,
+            entityId: input.entityId,
+            locale: input.locale,
+        });
+        if (existing) {
+            if (input.title !== undefined)
+                existing.title = input.title;
+            if (input.description !== undefined)
+                existing.description = input.description;
+            if (input.ogTitle !== undefined)
+                existing.ogTitle = input.ogTitle;
+            if (input.ogDescription !== undefined)
+                existing.ogDescription = input.ogDescription;
+            if (input.ogImageUrl !== undefined)
+                existing.ogImageUrl = input.ogImageUrl;
+            this.#audit(em, 'seo_meta_override.upsert', existing.id, null, { entityType: existing.entityType, entityId: existing.entityId, locale: existing.locale });
+            await em.flush();
+            return existing;
+        }
+        const row = em.create(SeoMetaOverride, {
+            entityType: input.entityType,
+            entityId: input.entityId,
+            locale: input.locale,
+            ...(input.title !== undefined ? { title: input.title } : {}),
+            ...(input.description !== undefined ? { description: input.description } : {}),
+            ...(input.ogTitle !== undefined ? { ogTitle: input.ogTitle } : {}),
+            ...(input.ogDescription !== undefined ? { ogDescription: input.ogDescription } : {}),
+            ...(input.ogImageUrl !== undefined ? { ogImageUrl: input.ogImageUrl } : {}),
+        });
+        em.persist(row);
+        this.#audit(em, 'seo_meta_override.upsert', row.id, null, { entityType: row.entityType, entityId: row.entityId, locale: row.locale });
+        await em.flush();
+        return row;
+    }
+    async deleteOverride(input) {
+        const em = this.emFactory();
+        const row = await em.findOne(SeoMetaOverride, input);
+        if (row) {
+            this.#audit(em, 'seo_meta_override.delete', row.id, { entityType: row.entityType, entityId: row.entityId, locale: row.locale }, null);
+            await em.removeAndFlush(row);
+        }
+    }
+    async findOverride(em, input) {
+        return em.findOne(SeoMetaOverride, input);
+    }
+    async loadRuleSource(entityType, entityId) {
+        if (entityType === 'product') {
+            const product = await this.catalogProducts.findById(entityId);
+            if (!product) {
+                throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Product ${entityId} not found.`);
+            }
+            return { product };
+        }
+        if (entityType === 'category') {
+            // Feature 068 — meta tags describe a page a customer can reach: a
+            // deactivated (or deleted, never filtered here before) category has none.
+            // `liveOnly` is the port's name for the `deletedAt: null` half; `isActive`
+            // is a column on the record, so the other half stays a test here.
+            const category = await this.catalogCategories.findById(entityId, { liveOnly: true });
+            if (!category || !category.isActive) {
+                throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Category ${entityId} not found.`);
+            }
+            return { category };
+        }
+        if (entityType === 'cms_page') {
+            const cmsPage = await this.cmsPages.findById(entityId);
+            if (!cmsPage) {
+                throw new HttpError(404, ERROR_CODES.NOT_FOUND, `CMS page ${entityId} not found.`);
+            }
+            return { cmsPage };
+        }
+        // Exhaustiveness — every branch in `seoEntityTypeSchema` is handled above.
+        throw new HttpError(404, ERROR_CODES.NOT_FOUND, `Unknown entity type ${String(entityType)}.`);
+    }
+}
+export function buildRuleMeta(entityType, source, locale) {
+    if (entityType === 'product' && source.product) {
+        const name = pickLocale(source.product.name, locale);
+        const description = pickLocale(source.product.description, locale);
+        return {
+            title: trim(name, TITLE_MAX),
+            description: trim(description, DESCRIPTION_MAX),
+            openGraph: {
+                title: trim(name, TITLE_MAX),
+                description: trim(description, DESCRIPTION_MAX),
+                image: null,
+            },
+        };
+    }
+    if (entityType === 'category' && source.category) {
+        const name = pickLocale(source.category.name, locale);
+        const description = `Browse ${trim(name, 80)}.`;
+        return {
+            title: trim(name, TITLE_MAX),
+            description,
+            openGraph: {
+                title: trim(name, TITLE_MAX),
+                description,
+                image: null,
+            },
+        };
+    }
+    if (entityType === 'cms_page' && source.cmsPage) {
+        // Feature 014 — meta fields are per-language; fall back to the
+        // admin-facing `name` for title when no localized meta is set.
+        const title = pickLocale(source.cmsPage.metaTitle ?? null, locale) || source.cmsPage.name;
+        const description = pickLocale(source.cmsPage.metaDescription ?? null, locale);
+        return {
+            title: trim(title, TITLE_MAX),
+            description: trim(description, DESCRIPTION_MAX),
+            openGraph: {
+                title: trim(title, TITLE_MAX),
+                description: trim(description, DESCRIPTION_MAX),
+                image: null,
+            },
+        };
+    }
+    return {
+        title: '',
+        description: '',
+        openGraph: { title: '', description: '', image: null },
+    };
+}
+function pickLocale(value, locale) {
+    if (!value)
+        return '';
+    return value[locale] ?? value[FALLBACK_LOCALE] ?? Object.values(value)[0] ?? '';
+}
+function trim(value, max) {
+    if (value.length <= max)
+        return value;
+    return value.slice(0, max - 1).replace(/\s+\S*$/, '').trimEnd() + '…';
+}
+//# sourceMappingURL=meta-tag-resolver.service.js.map

package/dist/backend/services/meta-tag-resolver.service.js.map

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