@endora-commerce/mod-meta-ads 0.0.0-stage → 0.100.0

package/dist/backend/index.d.ts

@@ -0,0 +1,67 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { FastifyRequest } from 'fastify';
+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 type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import { StorefrontRevalidator } from '@endora-commerce/platform/http';
+import { MetaConfigService } from './services/meta-config.service.js';
+import { MetaCustomEventMappingsService, type MetaAuditContext } from './services/custom-event-mappings.service.js';
+import { MetaCustomEventMapping } from './entities/meta-custom-event-mapping.entity.js';
+/**
+ * `meta_ads` — the module that kept calling the storefront after it was
+ * switched off (feature 072, wave 2, T108).
+ *
+ * The routes were already gated: `plugin.ts` wrapped them in
+ * `defineModuleRoutes('meta_ads', …)`. The **subscription** was not. A root
+ * passed `onSettingChanged` as a bare `eventBus.on('settings.value_changed', …)`,
+ * so the handler stayed live regardless of the module's effective state, and
+ * every `meta_ads.*` settings change fired
+ *
+ *     revalidator.revalidate(['meta:config'])
+ *
+ * — an outbound HTTP POST to the storefront, asking it to rebuild a cache tag
+ * for a module that was serving nothing. Constitution XVII item 2 asks for
+ * EventBus subscriptions to go through `subscribeForModule` for exactly this
+ * reason, and `ctx.subscribe` is that wrapper, so the conversion closes it by
+ * construction rather than by remembering.
+ *
+ * The same shape is in `linkedin_ads`, `google_analytics` and
+ * `google_tag_manager`; the first is converted alongside this one.
+ *
+ * `auditLog` stops being optional. It is the append-only sink for mapping
+ * changes — the record of who altered the pixel's event mapping — and an
+ * optional audit sink defaults to *not recording*. Both roots passed one, so
+ * nothing was lost; this is the ninth time in this transition that shape has
+ * been removed rather than the ninth incident.
+ */
+interface MetaAdsServices {
+    readonly revalidator: StorefrontRevalidator;
+    readonly mappings: MetaCustomEventMappingsService;
+    readonly configService: MetaConfigService;
+    readonly invalidateConfig: () => void;
+}
+export interface MetaAdsCradle {
+    readonly emFactory: () => EntityManager;
+    readonly auditLogService: AuditPort;
+    readonly settingsReadPort: SettingsReadPort;
+    readonly requireAdmin: RequireAdminFactory;
+    /** How this composition names the acting admin; `null` for a non-admin caller. */
+    readonly adminAuditActorResolver: (request: FastifyRequest) => MetaAuditContext;
+    readonly metaAdsServices: MetaAdsServices;
+}
+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 MetaCustomEventMapping)[];
+export {};
+//# 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;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,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;AAC5E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EACL,8BAA8B,EAC9B,KAAK,gBAAgB,EACtB,MAAM,6CAA6C,CAAC;AAGrD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AAExF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,UAAU,eAAe;IACvB,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,8BAA8B,CAAC;IAClD,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;IACpC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC5C,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,kFAAkF;IAClF,QAAQ,CAAC,uBAAuB,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,gBAAgB,CAAC;IAChF,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CA6CvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,mCAEpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,56 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { StorefrontRevalidator } from '@endora-commerce/platform/http';
+import { MetaConfigService } from './services/meta-config.service.js';
+import { MetaCustomEventMappingsService, } from './services/custom-event-mappings.service.js';
+import { registerMetaAdsAdminRoutes } from './routes.admin.js';
+import { registerMetaAdsStorefrontRoutes } from './routes.storefront.js';
+import { MetaCustomEventMapping } from './entities/meta-custom-event-mapping.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        metaAdsServices: ctx
+            .asFunction(({ emFactory, auditLogService }) => {
+            const revalidator = new StorefrontRevalidator({
+                baseUrl: process.env['STOREFRONT_BASE_URL'],
+                secret: process.env['REVALIDATE_SECRET'],
+            });
+            const invalidateConfig = () => {
+                void revalidator.revalidate(['meta:config']);
+            };
+            const mappings = new MetaCustomEventMappingsService(emFactory, auditLogService, invalidateConfig);
+            const configService = new MetaConfigService(lazyPort(ctx, 'settingsReadPort'), (channelId) => mappings.loadForChannel(channelId));
+            return { revalidator, mappings, configService, invalidateConfig };
+        })
+            .singleton(),
+    });
+    ctx.subscribe('settings.value_changed', (payload) => {
+        const settingCode = payload.settingCode;
+        if (typeof settingCode !== 'string' || !settingCode.startsWith('meta_ads.'))
+            return;
+        ctx.cradle().metaAdsServices.invalidateConfig();
+    });
+    ctx.routes(async (app) => {
+        const { metaAdsServices, requireAdmin, adminAuditActorResolver } = ctx.cradle();
+        metaAdsServices.revalidator.setLogger(app.log);
+        await registerMetaAdsStorefrontRoutes(app, { configService: metaAdsServices.configService });
+        await registerMetaAdsAdminRoutes(app, {
+            mappings: metaAdsServices.mappings,
+            requireAdmin,
+            resolveAuditContext: adminAuditActorResolver,
+        });
+    });
+}
+/**
+ * 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 = [
+    MetaCustomEventMapping,
+];
+//# 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":"AAIA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAG5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AACtE,OAAO,EACL,8BAA8B,GAE/B,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,+BAA+B,EAAE,MAAM,wBAAwB,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gDAAgD,CAAC;AA+CxF,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC;QACd,eAAe,EAAE,GAAG;aACjB,UAAU,CACT,CAAC,EAAE,SAAS,EAAE,eAAe,EAAiB,EAAmB,EAAE;YACjE,MAAM,WAAW,GAAG,IAAI,qBAAqB,CAAC;gBAC5C,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC;gBAC3C,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;aACzC,CAAC,CAAC;YACH,MAAM,gBAAgB,GAAG,GAAS,EAAE;gBAClC,KAAK,WAAW,CAAC,UAAU,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;YAC/C,CAAC,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,8BAA8B,CACjD,SAAS,EACT,eAAe,EACf,gBAAgB,CACjB,CAAC;YACF,MAAM,aAAa,GAAG,IAAI,iBAAiB,CACzC,QAAQ,CAAmB,GAAG,EAAE,kBAAkB,CAAC,EACnD,CAAC,SAAS,EAAE,EAAE,CACd,QAAQ,CAAC,cAAc,CAAC,SAAS,CAAC,CACnC,CAAC;YACF,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC;QACpE,CAAC,CACF;aACA,SAAS,EAAE;KACf,CAAC,CAAC;IAEH,GAAG,CAAC,SAAS,CAAC,wBAAwB,EAAE,CAAC,OAAO,EAAE,EAAE;QAClD,MAAM,WAAW,GAAI,OAAqC,CAAC,WAAW,CAAC;QACvE,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC;YAAE,OAAO;QACpF,GAAG,CAAC,MAAM,EAAiB,CAAC,eAAe,CAAC,gBAAgB,EAAE,CAAC;IACjE,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,EAAE,eAAe,EAAE,YAAY,EAAE,uBAAuB,EAAE,GAC9D,GAAG,CAAC,MAAM,EAAiB,CAAC;QAC9B,eAAe,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC/C,MAAM,+BAA+B,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,eAAe,CAAC,aAAa,EAAE,CAAC,CAAC;QAC7F,MAAM,0BAA0B,CAAC,GAAG,EAAE;YACpC,QAAQ,EAAE,eAAe,CAAC,QAAQ;YAClC,YAAY;YACZ,mBAAmB,EAAE,uBAAuB;SAC7C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,sBAAsB;CACvB,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify';
+import type { MetaAuditContext, MetaCustomEventMappingsService } from './services/custom-event-mappings.service.js';
+export interface MetaAdsAdminDeps {
+    mappings: MetaCustomEventMappingsService;
+    requireAdmin: (permission?: string) => (req: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    resolveAuditContext: (req: FastifyRequest) => MetaAuditContext;
+}
+/**
+ * Admin routes for the Meta Ads module (feature 064, US4). Custom-event mapping
+ * CRUD plus the closed action catalogue that drives the admin picker.
+ *
+ * Per-channel Settings (Pixel ID, consent) are managed through the generic
+ * Settings admin surface, not here.
+ */
+export declare function registerMetaAdsAdminRoutes(app: FastifyInstance, deps: MetaAdsAdminDeps): Promise<void>;
+//# sourceMappingURL=routes.admin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.d.ts","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAO7E,OAAO,KAAK,EACV,gBAAgB,EAChB,8BAA8B,EAC/B,MAAM,6CAA6C,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,8BAA8B,CAAC;IACzC,YAAY,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,CAAC,GAAG,EAAE,cAAc,EAAE,KAAK,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnG,mBAAmB,EAAE,CAAC,GAAG,EAAE,cAAc,KAAK,gBAAgB,CAAC;CAChE;AAED;;;;;;GAMG;AACH,wBAAsB,0BAA0B,CAC9C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAkDf"}

package/dist/backend/routes.admin.js

@@ -0,0 +1,31 @@
+import { META_TRIGGER_ACTIONS, createMetaCustomEventMappingSchema, updateMetaCustomEventMappingSchema, } from '@endora-commerce/contracts';
+import { META_ADS_READ_PERMISSION, META_ADS_WRITE_PERMISSION } from '../manifest.js';
+/**
+ * Admin routes for the Meta Ads module (feature 064, US4). Custom-event mapping
+ * CRUD plus the closed action catalogue that drives the admin picker.
+ *
+ * Per-channel Settings (Pixel ID, consent) are managed through the generic
+ * Settings admin surface, not here.
+ */
+export async function registerMetaAdsAdminRoutes(app, deps) {
+    const { mappings, requireAdmin, resolveAuditContext } = deps;
+    const BASE = '/api/v1/admin/meta-ads';
+    app.get(`${BASE}/action-catalogue`, { preHandler: requireAdmin(META_ADS_READ_PERMISSION) }, async () => ({ data: META_TRIGGER_ACTIONS }));
+    app.get(`${BASE}/custom-events`, { preHandler: requireAdmin(META_ADS_READ_PERMISSION) }, async () => ({ data: await mappings.list() }));
+    app.get(`${BASE}/custom-events/:id`, { preHandler: requireAdmin(META_ADS_READ_PERMISSION) }, async (request) => ({ data: await mappings.get(request.params.id) }));
+    app.post(`${BASE}/custom-events`, { preHandler: requireAdmin(META_ADS_WRITE_PERMISSION) }, async (request, reply) => {
+        const body = createMetaCustomEventMappingSchema.parse(request.body);
+        const created = await mappings.create(body, resolveAuditContext(request));
+        return reply.status(201).send({ data: created });
+    });
+    app.patch(`${BASE}/custom-events/:id`, { preHandler: requireAdmin(META_ADS_WRITE_PERMISSION) }, async (request) => {
+        const body = updateMetaCustomEventMappingSchema.parse(request.body);
+        const updated = await mappings.update(request.params.id, body, resolveAuditContext(request));
+        return { data: updated };
+    });
+    app.delete(`${BASE}/custom-events/:id`, { preHandler: requireAdmin(META_ADS_WRITE_PERMISSION) }, async (request, reply) => {
+        await mappings.remove(request.params.id, resolveAuditContext(request));
+        return reply.status(204).send();
+    });
+}
+//# sourceMappingURL=routes.admin.js.map

package/dist/backend/routes.admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.admin.js","sourceRoot":"","sources":["../../src/backend/routes.admin.ts"],"names":[],"mappings":"AACA,OAAO,EACL,oBAAoB,EACpB,kCAAkC,EAClC,kCAAkC,GACnC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AAYrF;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,GAAoB,EACpB,IAAsB;IAEtB,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IAC7D,MAAM,IAAI,GAAG,wBAAwB,CAAC;IAEtC,GAAG,CAAC,GAAG,CACL,GAAG,IAAI,mBAAmB,EAC1B,EAAE,UAAU,EAAE,YAAY,CAAC,wBAAwB,CAAC,EAAE,EACtD,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,oBAAoB,EAAE,CAAC,CAC7C,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,GAAG,IAAI,gBAAgB,EACvB,EAAE,UAAU,EAAE,YAAY,CAAC,wBAAwB,CAAC,EAAE,EACtD,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAC9C,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,GAAG,IAAI,oBAAoB,EAC3B,EAAE,UAAU,EAAE,YAAY,CAAC,wBAAwB,CAAC,EAAE,EACtD,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CACrE,CAAC;IAEF,GAAG,CAAC,IAAI,CACN,GAAG,IAAI,gBAAgB,EACvB,EAAE,UAAU,EAAE,YAAY,CAAC,yBAAyB,CAAC,EAAE,EACvD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,kCAAkC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC1E,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnD,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,KAAK,CACP,GAAG,IAAI,oBAAoB,EAC3B,EAAE,UAAU,EAAE,YAAY,CAAC,yBAAyB,CAAC,EAAE,EACvD,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,kCAAkC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACpE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,IAAI,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QAC7F,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,MAAM,CACR,GAAG,IAAI,oBAAoB,EAC3B,EAAE,UAAU,EAAE,YAAY,CAAC,yBAAyB,CAAC,EAAE,EACvD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,mBAAmB,CAAC,OAAO,CAAC,CAAC,CAAC;QACvE,OAAO,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAClC,CAAC,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { FastifyInstance } from 'fastify';
+import type { MetaConfigService } from './services/meta-config.service.js';
+export interface MetaAdsStorefrontDeps {
+    configService: MetaConfigService;
+}
+/**
+ * Public storefront routes for the Meta Ads module (feature 064). Wrapped by
+ * `defineModuleRoutes` in plugin.ts so they 503 when the module is disabled.
+ */
+export declare function registerMetaAdsStorefrontRoutes(app: FastifyInstance, deps: MetaAdsStorefrontDeps): Promise<void>;
+//# sourceMappingURL=routes.storefront.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.d.ts","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,iBAAiB,CAAC;CAClC;AAED;;;GAGG;AACH,wBAAsB,+BAA+B,CACnD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,qBAAqB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAMf"}

package/dist/backend/routes.storefront.js

@@ -0,0 +1,13 @@
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Public storefront routes for the Meta Ads module (feature 064). Wrapped by
+ * `defineModuleRoutes` in plugin.ts so they 503 when the module is disabled.
+ */
+export async function registerMetaAdsStorefrontRoutes(app, deps) {
+    app.get('/api/v1/storefront/meta-ads/config', async (request, reply) => {
+        const channel = getResolvedChannel(request);
+        const config = await deps.configService.getConfig(channel.id);
+        return reply.send({ data: config });
+    });
+}
+//# sourceMappingURL=routes.storefront.js.map

package/dist/backend/routes.storefront.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.storefront.js","sourceRoot":"","sources":["../../src/backend/routes.storefront.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AAOtE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,+BAA+B,CACnD,GAAoB,EACpB,IAA2B;IAE3B,GAAG,CAAC,GAAG,CAAC,oCAAoC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACrE,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9D,OAAO,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/backend/services/custom-event-mappings.service.d.ts

@@ -0,0 +1,40 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CreateMetaCustomEventMapping, type MetaCustomEventMapping as MetaCustomEventMappingDto, type MetaStorefrontMapping, type UpdateMetaCustomEventMapping } from '@endora-commerce/contracts';
+export interface MetaAuditContext {
+    actorAdminUserId: string | null;
+}
+export interface MetaAuditSink {
+    record(input: {
+        action: string;
+        objectType: string;
+        objectId: string;
+        actorAdminUserId?: string | null;
+        stateBefore?: Record<string, unknown>;
+        stateAfter?: Record<string, unknown>;
+    }): Promise<unknown>;
+}
+/**
+ * CRUD + storefront resolution for Meta custom-event mappings (feature 064,
+ * US4). Boundary validation lives in the Zod schemas at the route; this service
+ * owns the optimistic-version guard, persistence, and audit.
+ */
+export declare class MetaCustomEventMappingsService {
+    private readonly emFactory;
+    private readonly audit?;
+    private readonly onChange?;
+    constructor(emFactory: () => EntityManager, audit?: MetaAuditSink | undefined, onChange?: (() => void) | undefined);
+    list(): Promise<MetaCustomEventMappingDto[]>;
+    get(id: string): Promise<MetaCustomEventMappingDto>;
+    create(input: CreateMetaCustomEventMapping, ctx: MetaAuditContext): Promise<MetaCustomEventMappingDto>;
+    update(id: string, input: UpdateMetaCustomEventMapping, ctx: MetaAuditContext): Promise<MetaCustomEventMappingDto>;
+    remove(id: string, ctx: MetaAuditContext): Promise<void>;
+    /**
+     * Enabled mappings applicable to a channel (channel-scoped OR all-channels).
+     * A NULL `salesChannelId` means "every channel" by explicit design, not by
+     * fail-open (Principle XII).
+     */
+    loadForChannel(salesChannelId: string): Promise<MetaStorefrontMapping[]>;
+    private notFound;
+    private toDto;
+}
+//# sourceMappingURL=custom-event-mappings.service.d.ts.map

package/dist/backend/services/custom-event-mappings.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-event-mappings.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/custom-event-mappings.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAEL,KAAK,4BAA4B,EACjC,KAAK,sBAAsB,IAAI,yBAAyB,EACxD,KAAK,qBAAqB,EAE1B,KAAK,4BAA4B,EAClC,MAAM,4BAA4B,CAAC;AAIpC,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,KAAK,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACjC,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACtC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CACtB;AAED;;;;GAIG;AACH,qBAAa,8BAA8B;IAEvC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAFT,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,CAAC,EAAE,aAAa,YAAA,EACrB,QAAQ,CAAC,GAAE,MAAM,IAAI,aAAA;IAGlC,IAAI,IAAI,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAM5C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAOnD,MAAM,CACV,KAAK,EAAE,4BAA4B,EACnC,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,yBAAyB,CAAC;IAoB/B,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,4BAA4B,EACnC,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,yBAAyB,CAAC;IAwC/B,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgB9D;;;;OAIG;IACG,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAa9E,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,KAAK;CAcd"}

package/dist/backend/services/custom-event-mappings.service.js

@@ -0,0 +1,134 @@
+import { ERROR_CODES, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { MetaCustomEventMapping } from '../entities/meta-custom-event-mapping.entity.js';
+/**
+ * CRUD + storefront resolution for Meta custom-event mappings (feature 064,
+ * US4). Boundary validation lives in the Zod schemas at the route; this service
+ * owns the optimistic-version guard, persistence, and audit.
+ */
+export class MetaCustomEventMappingsService {
+    emFactory;
+    audit;
+    onChange;
+    constructor(emFactory, audit, onChange) {
+        this.emFactory = emFactory;
+        this.audit = audit;
+        this.onChange = onChange;
+    }
+    async list() {
+        const em = this.emFactory();
+        const rows = await em.find(MetaCustomEventMapping, {}, { orderBy: { createdAt: 'asc' } });
+        return rows.map((r) => this.toDto(r));
+    }
+    async get(id) {
+        const em = this.emFactory();
+        const row = await em.findOne(MetaCustomEventMapping, { id });
+        if (!row)
+            throw this.notFound(id);
+        return this.toDto(row);
+    }
+    async create(input, ctx) {
+        const em = this.emFactory();
+        const row = em.create(MetaCustomEventMapping, {
+            salesChannelId: input.salesChannelId ?? null,
+            triggerAction: input.triggerAction,
+            eventName: input.eventName,
+            enabled: input.enabled ?? true,
+        });
+        await em.persistAndFlush(row);
+        await this.audit?.record({
+            action: 'meta_ads.custom_event.created',
+            objectType: 'meta_custom_event_mapping',
+            objectId: row.id,
+            actorAdminUserId: ctx.actorAdminUserId,
+            stateAfter: { triggerAction: row.triggerAction, eventName: row.eventName },
+        });
+        this.onChange?.();
+        return this.toDto(row);
+    }
+    async update(id, input, ctx) {
+        const em = this.emFactory();
+        const row = await em.findOne(MetaCustomEventMapping, { id });
+        if (!row)
+            throw this.notFound(id);
+        if (row.version !== input.version) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Custom event mapping was modified concurrently.');
+        }
+        const before = {
+            triggerAction: row.triggerAction,
+            eventName: row.eventName,
+            enabled: row.enabled,
+        };
+        if (input.salesChannelId !== undefined)
+            row.salesChannelId = input.salesChannelId;
+        if (input.triggerAction !== undefined)
+            row.triggerAction = input.triggerAction;
+        if (input.eventName !== undefined)
+            row.eventName = input.eventName;
+        if (input.enabled !== undefined)
+            row.enabled = input.enabled;
+        row.version += 1;
+        await em.persistAndFlush(row);
+        await this.audit?.record({
+            action: 'meta_ads.custom_event.updated',
+            objectType: 'meta_custom_event_mapping',
+            objectId: row.id,
+            actorAdminUserId: ctx.actorAdminUserId,
+            stateBefore: before,
+            stateAfter: {
+                triggerAction: row.triggerAction,
+                eventName: row.eventName,
+                enabled: row.enabled,
+            },
+        });
+        this.onChange?.();
+        return this.toDto(row);
+    }
+    async remove(id, ctx) {
+        const em = this.emFactory();
+        const row = await em.findOne(MetaCustomEventMapping, { id });
+        if (!row)
+            throw this.notFound(id);
+        const before = { triggerAction: row.triggerAction, eventName: row.eventName };
+        await em.removeAndFlush(row);
+        await this.audit?.record({
+            action: 'meta_ads.custom_event.deleted',
+            objectType: 'meta_custom_event_mapping',
+            objectId: id,
+            actorAdminUserId: ctx.actorAdminUserId,
+            stateBefore: before,
+        });
+        this.onChange?.();
+    }
+    /**
+     * Enabled mappings applicable to a channel (channel-scoped OR all-channels).
+     * A NULL `salesChannelId` means "every channel" by explicit design, not by
+     * fail-open (Principle XII).
+     */
+    async loadForChannel(salesChannelId) {
+        const em = this.emFactory();
+        const rows = await em.find(MetaCustomEventMapping, { enabled: true, $or: [{ salesChannelId: null }, { salesChannelId }] }, { orderBy: { createdAt: 'asc' } });
+        return rows.map((r) => ({
+            triggerAction: r.triggerAction,
+            eventName: r.eventName,
+        }));
+    }
+    notFound(id) {
+        return new HttpError(404, ERROR_CODES.NOT_FOUND, `Custom event mapping not found: ${id}`);
+    }
+    toDto(row) {
+        return {
+            id: row.id,
+            // `?? null` because a freshly-created entity leaves an omitted optional
+            // property undefined, and JSON.stringify would drop the key entirely.
+            salesChannelId: row.salesChannelId ?? null,
+            triggerAction: row.triggerAction,
+            eventName: row.eventName,
+            enabled: row.enabled,
+            version: row.version,
+            createdAt: row.createdAt.toISOString(),
+            updatedAt: row.updatedAt.toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=custom-event-mappings.service.js.map

package/dist/backend/services/custom-event-mappings.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"custom-event-mappings.service.js","sourceRoot":"","sources":["../../../src/backend/services/custom-event-mappings.service.ts"],"names":[],"mappings":"AACA,OAAO,EACL,WAAW,GAMZ,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iDAAiD,CAAC;AAiBzF;;;;GAIG;AACH,MAAM,OAAO,8BAA8B;IAEtB;IACA;IACA;IAHnB,YACmB,SAA8B,EAC9B,KAAqB,EACrB,QAAqB;QAFrB,cAAS,GAAT,SAAS,CAAqB;QAC9B,UAAK,GAAL,KAAK,CAAgB;QACrB,aAAQ,GAAR,QAAQ,CAAa;IACrC,CAAC;IAEJ,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC1F,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,KAAmC,EACnC,GAAqB;QAErB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,EAAE;YAC5C,cAAc,EAAE,KAAK,CAAC,cAAc,IAAI,IAAI;YAC5C,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;SAC/B,CAAC,CAAC;QACH,MAAM,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,MAAM,EAAE,+BAA+B;YACvC,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,GAAG,CAAC,EAAE;YAChB,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,UAAU,EAAE,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE;SAC3E,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CACV,EAAU,EACV,KAAmC,EACnC,GAAqB;QAErB,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,IAAI,GAAG,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,IAAI,SAAS,CACjB,GAAG,EACH,WAAW,CAAC,gBAAgB,EAC5B,iDAAiD,CAClD,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG;YACb,aAAa,EAAE,GAAG,CAAC,aAAa;YAChC,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;SACrB,CAAC;QAEF,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS;YAAE,GAAG,CAAC,cAAc,GAAG,KAAK,CAAC,cAAc,CAAC;QAClF,IAAI,KAAK,CAAC,aAAa,KAAK,SAAS;YAAE,GAAG,CAAC,aAAa,GAAG,KAAK,CAAC,aAAa,CAAC;QAC/E,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;QACnE,IAAI,KAAK,CAAC,OAAO,KAAK,SAAS;YAAE,GAAG,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;QAC7D,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACjB,MAAM,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QAE9B,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,MAAM,EAAE,+BAA+B;YACvC,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,GAAG,CAAC,EAAE;YAChB,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,WAAW,EAAE,MAAM;YACnB,UAAU,EAAE;gBACV,aAAa,EAAE,GAAG,CAAC,aAAa;gBAChC,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,OAAO,EAAE,GAAG,CAAC,OAAO;aACrB;SACF,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU,EAAE,GAAqB;QAC5C,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,sBAAsB,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7D,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;QAClC,MAAM,MAAM,GAAG,EAAE,aAAa,EAAE,GAAG,CAAC,aAAa,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,CAAC;QAC9E,MAAM,EAAE,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7B,MAAM,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,MAAM,EAAE,+BAA+B;YACvC,UAAU,EAAE,2BAA2B;YACvC,QAAQ,EAAE,EAAE;YACZ,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;YACtC,WAAW,EAAE,MAAM;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;IACpB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,cAAsB;QACzC,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,CACxB,sBAAsB,EACtB,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,cAAc,EAAE,IAAI,EAAE,EAAE,EAAE,cAAc,EAAE,CAAC,EAAE,EACtE,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAClC,CAAC;QACF,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACtB,aAAa,EAAE,CAAC,CAAC,aAAkC;YACnD,SAAS,EAAE,CAAC,CAAC,SAAS;SACvB,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,QAAQ,CAAC,EAAU;QACzB,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,SAAS,EAAE,mCAAmC,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IAEO,KAAK,CAAC,GAA2B;QACvC,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,wEAAwE;YACxE,sEAAsE;YACtE,cAAc,EAAE,GAAG,CAAC,cAAc,IAAI,IAAI;YAC1C,aAAa,EAAE,GAAG,CAAC,aAAkC;YACrD,SAAS,EAAE,GAAG,CAAC,SAAS;YACxB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;YACtC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;SACvC,CAAC;IACJ,CAAC;CACF"}

package/dist/backend/services/meta-config.service.d.ts

@@ -0,0 +1,22 @@
+import { type MetaStorefrontConfig, type MetaStorefrontMapping } from '@endora-commerce/contracts';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+/** Loader for a channel's enabled custom-event mappings in the storefront shape. */
+export type MetaCustomEventsLoader = (salesChannelId: string) => Promise<MetaStorefrontMapping[]>;
+/**
+ * Resolves the per-sales-channel Meta Ads configuration exposed to the
+ * storefront.
+ *
+ * A blank or absent Pixel ID means the channel is untracked (FR-004): the
+ * returned config is fully disabled regardless of the master switch. Every
+ * setting read degrades to its default rather than throwing — an incomplete
+ * settings catalogue must not be able to fail a storefront render (FR-013).
+ */
+export declare class MetaConfigService {
+    private readonly settings;
+    private readonly loadCustomEvents;
+    constructor(settings: SettingsReadPort, loadCustomEvents?: MetaCustomEventsLoader);
+    getConfig(salesChannelId: string): Promise<MetaStorefrontConfig>;
+    private readBool;
+    private readString;
+}
+//# sourceMappingURL=meta-config.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"meta-config.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/meta-config.service.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,EAC3B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE,oFAAoF;AACpF,MAAM,MAAM,sBAAsB,GAAG,CACnC,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAAC;AAEtC;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAE1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,GAAE,sBAAuC;IAGtE,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;YAuBxD,QAAQ;YAYR,UAAU;CAWzB"}

package/dist/backend/services/meta-config.service.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { META_ADS_SETTING_CODES, META_DISABLED_CONFIG, } from '@endora-commerce/contracts';
+/**
+ * Resolves the per-sales-channel Meta Ads configuration exposed to the
+ * storefront.
+ *
+ * A blank or absent Pixel ID means the channel is untracked (FR-004): the
+ * returned config is fully disabled regardless of the master switch. Every
+ * setting read degrades to its default rather than throwing — an incomplete
+ * settings catalogue must not be able to fail a storefront render (FR-013).
+ */
+export class MetaConfigService {
+    settings;
+    loadCustomEvents;
+    constructor(settings, loadCustomEvents = async () => []) {
+        this.settings = settings;
+        this.loadCustomEvents = loadCustomEvents;
+    }
+    async getConfig(salesChannelId) {
+        const [enabled, pixelIdRaw, requireConsent] = await Promise.all([
+            this.readBool(META_ADS_SETTING_CODES.ENABLED, salesChannelId, false),
+            this.readString(META_ADS_SETTING_CODES.PIXEL_ID, salesChannelId, ''),
+            this.readBool(META_ADS_SETTING_CODES.REQUIRE_CONSENT, salesChannelId, true),
+        ]);
+        const pixelId = pixelIdRaw.trim() || null;
+        // Untracked channel. The consent choice is still reported so the storefront
+        // banner behaves consistently across channels.
+        if (!enabled || pixelId === null) {
+            return { ...META_DISABLED_CONFIG, requireConsent };
+        }
+        return {
+            enabled: true,
+            pixelId,
+            requireConsent,
+            customEvents: await this.loadCustomEvents(salesChannelId),
+        };
+    }
+    async readBool(code, salesChannelId, fallback) {
+        try {
+            return await this.settings.get(code, salesChannelId, z.boolean());
+        }
+        catch {
+            return fallback;
+        }
+    }
+    async readString(code, salesChannelId, fallback) {
+        try {
+            return await this.settings.get(code, salesChannelId, z.string());
+        }
+        catch {
+            return fallback;
+        }
+    }
+}
+//# sourceMappingURL=meta-config.service.js.map

package/dist/backend/services/meta-config.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-config.service.js","sourceRoot":"","sources":["../../../src/backend/services/meta-config.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,GAGrB,MAAM,4BAA4B,CAAC;AAQpC;;;;;;;;GAQG;AACH,MAAM,OAAO,iBAAiB;IAET;IACA;IAFnB,YACmB,QAA0B,EAC1B,mBAA2C,KAAK,IAAI,EAAE,CAAC,EAAE;QADzD,aAAQ,GAAR,QAAQ,CAAkB;QAC1B,qBAAgB,GAAhB,gBAAgB,CAAyC;IACzE,CAAC;IAEJ,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,MAAM,CAAC,OAAO,EAAE,UAAU,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC9D,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC;YACpE,IAAI,CAAC,UAAU,CAAC,sBAAsB,CAAC,QAAQ,EAAE,cAAc,EAAE,EAAE,CAAC;YACpE,IAAI,CAAC,QAAQ,CAAC,sBAAsB,CAAC,eAAe,EAAE,cAAc,EAAE,IAAI,CAAC;SAC5E,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QAE1C,4EAA4E;QAC5E,+CAA+C;QAC/C,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;YACjC,OAAO,EAAE,GAAG,oBAAoB,EAAE,cAAc,EAAE,CAAC;QACrD,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,OAAO;YACP,cAAc;YACd,YAAY,EAAE,MAAM,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;SAC1D,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,IAAY,EACZ,cAAsB,EACtB,QAAiB;QAEjB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QACpE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,IAAY,EACZ,cAAsB,EACtB,QAAgB;QAEhB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACnE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;CACF"}