@endora-commerce/mod-linkedin-ads 0.100.0

package/dist/backend/index.d.ts

@@ -0,0 +1,58 @@
+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 { LinkedInConfigService } from './services/linkedin-config.service.js';
+import { LinkedInConversionMappingsService, type LinkedInAuditContext } from './services/conversion-mappings.service.js';
+import { LinkedInConversionMapping } from './entities/linkedin-conversion-mapping.entity.js';
+/**
+ * `linkedin_ads` — converted with `meta_ads`, which it is a near-copy of
+ * (feature 072, wave 2, T106).
+ *
+ * Same off-state leak, same fix: the routes were gated by `defineModuleRoutes`
+ * but the `settings.value_changed` subscription arrived from a root as a bare
+ * `eventBus.on`, so a switched-off module still answered every
+ * `linkedin_ads.*` settings change with an outbound storefront revalidation.
+ * `ctx.subscribe` is `subscribeForModule`, so the subscription now stops with
+ * the module.
+ *
+ * `auditLog` stops being optional here too — see the note in `meta_ads`.
+ *
+ * The two modules are converted in one commit rather than one after the other.
+ * They are the same forty lines twice over, both roots build them from adjacent
+ * blocks, and splitting them would have meant leaving the shared
+ * `adminAuditActorResolver` contribution half-introduced between commits.
+ */
+interface LinkedInAdsServices {
+    readonly revalidator: StorefrontRevalidator;
+    readonly mappings: LinkedInConversionMappingsService;
+    readonly configService: LinkedInConfigService;
+    readonly invalidateConfig: () => void;
+}
+export interface LinkedInAdsCradle {
+    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) => LinkedInAuditContext;
+    readonly linkedInAdsServices: LinkedInAdsServices;
+}
+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 LinkedInConversionMapping)[];
+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,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,iCAAiC,EACjC,KAAK,oBAAoB,EAC1B,MAAM,2CAA2C,CAAC;AAGnD,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAE7F;;;;;;;;;;;;;;;;;GAiBG;AAEH,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iCAAiC,CAAC;IACrD,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,gBAAgB,EAAE,MAAM,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,iBAAiB;IAChC,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,oBAAoB,CAAC;IACpF,QAAQ,CAAC,mBAAmB,EAAE,mBAAmB,CAAC;CACnD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAoDvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,sCAEpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,60 @@
+import { lazyPort } from '@endora-commerce/platform/kernel';
+import { StorefrontRevalidator } from '@endora-commerce/platform/http';
+import { LinkedInConfigService } from './services/linkedin-config.service.js';
+import { LinkedInConversionMappingsService, } from './services/conversion-mappings.service.js';
+import { registerLinkedInAdsAdminRoutes } from './routes.admin.js';
+import { registerLinkedInAdsStorefrontRoutes } from './routes.storefront.js';
+import { LinkedInConversionMapping } from './entities/linkedin-conversion-mapping.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        linkedInAdsServices: ctx
+            .asFunction(({ emFactory, auditLogService, }) => {
+            const revalidator = new StorefrontRevalidator({
+                baseUrl: process.env['STOREFRONT_BASE_URL'],
+                secret: process.env['REVALIDATE_SECRET'],
+            });
+            const invalidateConfig = () => {
+                void revalidator.revalidate(['linkedin:config']);
+            };
+            const mappings = new LinkedInConversionMappingsService(emFactory, auditLogService, invalidateConfig);
+            const configService = new LinkedInConfigService(lazyPort(ctx, 'settingsReadPort'), (channelId) => mappings.loadForChannel(channelId));
+            return { revalidator, mappings, configService, invalidateConfig };
+        })
+            .singleton(),
+    });
+    // Config edits propagate immediately rather than after the cache TTL — while
+    // the module is on.
+    ctx.subscribe('settings.value_changed', (payload) => {
+        const settingCode = payload.settingCode;
+        if (typeof settingCode !== 'string' || !settingCode.startsWith('linkedin_ads.'))
+            return;
+        ctx.cradle().linkedInAdsServices.invalidateConfig();
+    });
+    ctx.routes(async (app) => {
+        const { linkedInAdsServices, requireAdmin, adminAuditActorResolver } = ctx.cradle();
+        linkedInAdsServices.revalidator.setLogger(app.log);
+        await registerLinkedInAdsStorefrontRoutes(app, {
+            configService: linkedInAdsServices.configService,
+        });
+        await registerLinkedInAdsAdminRoutes(app, {
+            mappings: linkedInAdsServices.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 = [
+    LinkedInConversionMapping,
+];
+//# 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,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,iCAAiC,GAElC,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,8BAA8B,EAAE,MAAM,mBAAmB,CAAC;AACnE,OAAO,EAAE,mCAAmC,EAAE,MAAM,wBAAwB,CAAC;AAC7E,OAAO,EAAE,yBAAyB,EAAE,MAAM,kDAAkD,CAAC;AAsC7F,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC;QACd,mBAAmB,EAAE,GAAG;aACrB,UAAU,CACT,CAAC,EACC,SAAS,EACT,eAAe,GACG,EAAuB,EAAE;YAC3C,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,iBAAiB,CAAC,CAAC,CAAC;YACnD,CAAC,CAAC;YACF,MAAM,QAAQ,GAAG,IAAI,iCAAiC,CACpD,SAAS,EACT,eAAe,EACf,gBAAgB,CACjB,CAAC;YACF,MAAM,aAAa,GAAG,IAAI,qBAAqB,CAC7C,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,6EAA6E;IAC7E,oBAAoB;IACpB,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,eAAe,CAAC;YAAE,OAAO;QACxF,GAAG,CAAC,MAAM,EAAqB,CAAC,mBAAmB,CAAC,gBAAgB,EAAE,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,EAAE,mBAAmB,EAAE,YAAY,EAAE,uBAAuB,EAAE,GAClE,GAAG,CAAC,MAAM,EAAqB,CAAC;QAClC,mBAAmB,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnD,MAAM,mCAAmC,CAAC,GAAG,EAAE;YAC7C,aAAa,EAAE,mBAAmB,CAAC,aAAa;SACjD,CAAC,CAAC;QACH,MAAM,8BAA8B,CAAC,GAAG,EAAE;YACxC,QAAQ,EAAE,mBAAmB,CAAC,QAAQ;YACtC,YAAY;YACZ,mBAAmB,EAAE,uBAAuB;SAC7C,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,yBAAyB;CAC1B,CAAC"}

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

@@ -0,0 +1,16 @@
+import type { FastifyInstance, FastifyReply, FastifyRequest } from 'fastify';
+import type { LinkedInAuditContext, LinkedInConversionMappingsService } from './services/conversion-mappings.service.js';
+export interface LinkedInAdsAdminDeps {
+    mappings: LinkedInConversionMappingsService;
+    requireAdmin: (permission?: string) => (req: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    resolveAuditContext: (req: FastifyRequest) => LinkedInAuditContext;
+}
+/**
+ * Admin routes for the LinkedIn Ads module (feature 063, US3). Conversion-mapping
+ * CRUD plus the closed action catalogue that drives the admin picker.
+ *
+ * Per-channel Settings (Partner ID, consent, server-side, access token) are
+ * managed through the generic Settings admin surface, not here.
+ */
+export declare function registerLinkedInAdsAdminRoutes(app: FastifyInstance, deps: LinkedInAdsAdminDeps): 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;AAU7E,OAAO,KAAK,EACV,oBAAoB,EACpB,iCAAiC,EAClC,MAAM,2CAA2C,CAAC;AAEnD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,iCAAiC,CAAC;IAC5C,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,oBAAoB,CAAC;CACpE;AAED;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAClD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,oBAAoB,GACzB,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/backend/routes.admin.js

@@ -0,0 +1,31 @@
+import { LINKEDIN_TRIGGER_ACTIONS, createLinkedInConversionMappingSchema, updateLinkedInConversionMappingSchema, } from '@endora-commerce/contracts';
+import { LINKEDIN_ADS_READ_PERMISSION, LINKEDIN_ADS_WRITE_PERMISSION, } from '../manifest.js';
+/**
+ * Admin routes for the LinkedIn Ads module (feature 063, US3). Conversion-mapping
+ * CRUD plus the closed action catalogue that drives the admin picker.
+ *
+ * Per-channel Settings (Partner ID, consent, server-side, access token) are
+ * managed through the generic Settings admin surface, not here.
+ */
+export async function registerLinkedInAdsAdminRoutes(app, deps) {
+    const { mappings, requireAdmin, resolveAuditContext } = deps;
+    const BASE = '/api/v1/admin/linkedin-ads';
+    app.get(`${BASE}/action-catalogue`, { preHandler: requireAdmin(LINKEDIN_ADS_READ_PERMISSION) }, async () => ({ data: LINKEDIN_TRIGGER_ACTIONS }));
+    app.get(`${BASE}/conversion-mappings`, { preHandler: requireAdmin(LINKEDIN_ADS_READ_PERMISSION) }, async () => ({ data: await mappings.list() }));
+    app.get(`${BASE}/conversion-mappings/:id`, { preHandler: requireAdmin(LINKEDIN_ADS_READ_PERMISSION) }, async (request) => ({ data: await mappings.get(request.params.id) }));
+    app.post(`${BASE}/conversion-mappings`, { preHandler: requireAdmin(LINKEDIN_ADS_WRITE_PERMISSION) }, async (request, reply) => {
+        const body = createLinkedInConversionMappingSchema.parse(request.body);
+        const created = await mappings.create(body, resolveAuditContext(request));
+        return reply.status(201).send({ data: created });
+    });
+    app.patch(`${BASE}/conversion-mappings/:id`, { preHandler: requireAdmin(LINKEDIN_ADS_WRITE_PERMISSION) }, async (request) => {
+        const body = updateLinkedInConversionMappingSchema.parse(request.body);
+        const updated = await mappings.update(request.params.id, body, resolveAuditContext(request));
+        return { data: updated };
+    });
+    app.delete(`${BASE}/conversion-mappings/:id`, { preHandler: requireAdmin(LINKEDIN_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,wBAAwB,EACxB,qCAAqC,EACrC,qCAAqC,GACtC,MAAM,4BAA4B,CAAC;AACpC,OAAO,EACL,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,gBAAgB,CAAC;AAYxB;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,GAAoB,EACpB,IAA0B;IAE1B,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAAC;IAC7D,MAAM,IAAI,GAAG,4BAA4B,CAAC;IAE1C,GAAG,CAAC,GAAG,CACL,GAAG,IAAI,mBAAmB,EAC1B,EAAE,UAAU,EAAE,YAAY,CAAC,4BAA4B,CAAC,EAAE,EAC1D,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,wBAAwB,EAAE,CAAC,CACjD,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,GAAG,IAAI,sBAAsB,EAC7B,EAAE,UAAU,EAAE,YAAY,CAAC,4BAA4B,CAAC,EAAE,EAC1D,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAC9C,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,GAAG,IAAI,0BAA0B,EACjC,EAAE,UAAU,EAAE,YAAY,CAAC,4BAA4B,CAAC,EAAE,EAC1D,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,sBAAsB,EAC7B,EAAE,UAAU,EAAE,YAAY,CAAC,6BAA6B,CAAC,EAAE,EAC3D,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,qCAAqC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvE,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,0BAA0B,EACjC,EAAE,UAAU,EAAE,YAAY,CAAC,6BAA6B,CAAC,EAAE,EAC3D,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,IAAI,GAAG,qCAAqC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvE,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,MAAM,CACnC,OAAO,CAAC,MAAM,CAAC,EAAE,EACjB,IAAI,EACJ,mBAAmB,CAAC,OAAO,CAAC,CAC7B,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,MAAM,CACR,GAAG,IAAI,0BAA0B,EACjC,EAAE,UAAU,EAAE,YAAY,CAAC,6BAA6B,CAAC,EAAE,EAC3D,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,12 @@
+import type { FastifyInstance } from 'fastify';
+import type { LinkedInConfigService } from './services/linkedin-config.service.js';
+export interface LinkedInAdsStorefrontDeps {
+    configService: LinkedInConfigService;
+}
+/**
+ * Public storefront routes for the LinkedIn Ads module (feature 063). Wrapped by
+ * `defineModuleRoutes` in plugin.ts so they 503 when the module is disabled.
+ * Channel comes from the shared sales-channel resolver.
+ */
+export declare function registerLinkedInAdsStorefrontRoutes(app: FastifyInstance, deps: LinkedInAdsStorefrontDeps): 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,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAEnF,MAAM,WAAW,yBAAyB;IACxC,aAAa,EAAE,qBAAqB,CAAC;CACtC;AAED;;;;GAIG;AACH,wBAAsB,mCAAmC,CACvD,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,yBAAyB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAOf"}

package/dist/backend/routes.storefront.js

@@ -0,0 +1,15 @@
+import { getResolvedChannel } from '@endora-commerce/platform/kernel';
+/**
+ * Public storefront routes for the LinkedIn Ads module (feature 063). Wrapped by
+ * `defineModuleRoutes` in plugin.ts so they 503 when the module is disabled.
+ * Channel comes from the shared sales-channel resolver.
+ */
+export async function registerLinkedInAdsStorefrontRoutes(app, deps) {
+    // Per-channel public config for the browser. Never returns the access token.
+    app.get('/api/v1/storefront/linkedin-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;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,mCAAmC,CACvD,GAAoB,EACpB,IAA+B;IAE/B,6EAA6E;IAC7E,GAAG,CAAC,GAAG,CAAC,wCAAwC,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACzE,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/conversion-mappings.service.d.ts

@@ -0,0 +1,51 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type CreateLinkedInConversionMapping, type LinkedInConversionMapping as LinkedInConversionMappingDto, type LinkedInStorefrontMapping, type LinkedInTriggerAction, type UpdateLinkedInConversionMapping } from '@endora-commerce/contracts';
+/** Audit context resolved from the request at the route layer. */
+export interface LinkedInAuditContext {
+    actorAdminUserId: string | null;
+}
+export interface LinkedInAuditSink {
+    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 LinkedIn conversion mappings (feature 063,
+ * US3). Boundary validation lives in the Zod schemas at the route; this service
+ * owns the optimistic-version guard, persistence, and audit.
+ */
+export declare class LinkedInConversionMappingsService {
+    private readonly emFactory;
+    private readonly audit?;
+    /** Fired after a create/update/delete so callers can invalidate caches. */
+    private readonly onChange?;
+    constructor(emFactory: () => EntityManager, audit?: LinkedInAuditSink | undefined, 
+    /** Fired after a create/update/delete so callers can invalidate caches. */
+    onChange?: (() => void) | undefined);
+    list(): Promise<LinkedInConversionMappingDto[]>;
+    get(id: string): Promise<LinkedInConversionMappingDto>;
+    create(input: CreateLinkedInConversionMapping, ctx: LinkedInAuditContext): Promise<LinkedInConversionMappingDto>;
+    update(id: string, input: UpdateLinkedInConversionMapping, ctx: LinkedInAuditContext): Promise<LinkedInConversionMappingDto>;
+    remove(id: string, ctx: LinkedInAuditContext): Promise<void>;
+    /**
+     * Enabled mappings applicable to a channel (channel-scoped OR all-channels),
+     * in the storefront shape. A NULL `salesChannelId` means "every channel" by
+     * explicit design, not by fail-open (Principle XII).
+     */
+    loadForChannel(salesChannelId: string): Promise<LinkedInStorefrontMapping[]>;
+    /**
+     * Enabled mappings for one action on one channel, with the conversion rule
+     * URN resolved — server-side delivery addresses a rule by URN, not by the
+     * numeric id shown in Campaign Manager.
+     */
+    loadRuleUrnsFor(salesChannelId: string, triggerAction: LinkedInTriggerAction): Promise<string[]>;
+    private findEnabledForChannel;
+    private notFound;
+    private toDto;
+}
+//# sourceMappingURL=conversion-mappings.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"conversion-mappings.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/conversion-mappings.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAGL,KAAK,+BAA+B,EACpC,KAAK,yBAAyB,IAAI,4BAA4B,EAC9D,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,EAC1B,KAAK,+BAA+B,EACrC,MAAM,4BAA4B,CAAC;AAIpC,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,MAAM,WAAW,iBAAiB;IAChC,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,iCAAiC;IAE1C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC;IACvB,2EAA2E;IAC3E,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;gBAHT,SAAS,EAAE,MAAM,aAAa,EAC9B,KAAK,CAAC,EAAE,iBAAiB,YAAA;IAC1C,2EAA2E;IAC1D,QAAQ,CAAC,GAAE,MAAM,IAAI,aAAA;IAGlC,IAAI,IAAI,OAAO,CAAC,4BAA4B,EAAE,CAAC;IAM/C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAOtD,MAAM,CACV,KAAK,EAAE,+BAA+B,EACtC,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,4BAA4B,CAAC;IAqBlC,MAAM,CACV,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,+BAA+B,EACtC,GAAG,EAAE,oBAAoB,GACxB,OAAO,CAAC,4BAA4B,CAAC;IAyClC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBlE;;;;OAIG;IACG,cAAc,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,EAAE,CAAC;IAQlF;;;;OAIG;IACG,eAAe,CACnB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,qBAAqB,GACnC,OAAO,CAAC,MAAM,EAAE,CAAC;YAON,qBAAqB;IAWnC,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,KAAK;CAgBd"}

package/dist/backend/services/conversion-mappings.service.js

@@ -0,0 +1,155 @@
+import { ERROR_CODES, conversionRuleUrnFor, } from '@endora-commerce/contracts';
+import { HttpError } from '@endora-commerce/platform/http';
+import { LinkedInConversionMapping } from '../entities/linkedin-conversion-mapping.entity.js';
+/**
+ * CRUD + storefront resolution for LinkedIn conversion mappings (feature 063,
+ * US3). Boundary validation lives in the Zod schemas at the route; this service
+ * owns the optimistic-version guard, persistence, and audit.
+ */
+export class LinkedInConversionMappingsService {
+    emFactory;
+    audit;
+    onChange;
+    constructor(emFactory, audit, 
+    /** Fired after a create/update/delete so callers can invalidate caches. */
+    onChange) {
+        this.emFactory = emFactory;
+        this.audit = audit;
+        this.onChange = onChange;
+    }
+    async list() {
+        const em = this.emFactory();
+        const rows = await em.find(LinkedInConversionMapping, {}, { orderBy: { createdAt: 'asc' } });
+        return rows.map((r) => this.toDto(r));
+    }
+    async get(id) {
+        const em = this.emFactory();
+        const row = await em.findOne(LinkedInConversionMapping, { id });
+        if (!row)
+            throw this.notFound(id);
+        return this.toDto(row);
+    }
+    async create(input, ctx) {
+        const em = this.emFactory();
+        const row = em.create(LinkedInConversionMapping, {
+            salesChannelId: input.salesChannelId ?? null,
+            triggerAction: input.triggerAction,
+            conversionId: input.conversionId,
+            conversionRuleUrn: input.conversionRuleUrn ?? null,
+            enabled: input.enabled ?? true,
+        });
+        await em.persistAndFlush(row);
+        await this.audit?.record({
+            action: 'linkedin_ads.conversion_mapping.created',
+            objectType: 'linkedin_conversion_mapping',
+            objectId: row.id,
+            actorAdminUserId: ctx.actorAdminUserId,
+            stateAfter: { triggerAction: row.triggerAction, conversionId: row.conversionId },
+        });
+        this.onChange?.();
+        return this.toDto(row);
+    }
+    async update(id, input, ctx) {
+        const em = this.emFactory();
+        const row = await em.findOne(LinkedInConversionMapping, { id });
+        if (!row)
+            throw this.notFound(id);
+        if (row.version !== input.version) {
+            throw new HttpError(409, ERROR_CODES.VERSION_CONFLICT, 'Conversion mapping was modified concurrently.');
+        }
+        const before = {
+            triggerAction: row.triggerAction,
+            conversionId: row.conversionId,
+            enabled: row.enabled,
+        };
+        if (input.salesChannelId !== undefined)
+            row.salesChannelId = input.salesChannelId;
+        if (input.triggerAction !== undefined)
+            row.triggerAction = input.triggerAction;
+        if (input.conversionId !== undefined)
+            row.conversionId = input.conversionId;
+        if (input.conversionRuleUrn !== undefined)
+            row.conversionRuleUrn = input.conversionRuleUrn;
+        if (input.enabled !== undefined)
+            row.enabled = input.enabled;
+        row.version += 1;
+        await em.persistAndFlush(row);
+        await this.audit?.record({
+            action: 'linkedin_ads.conversion_mapping.updated',
+            objectType: 'linkedin_conversion_mapping',
+            objectId: row.id,
+            actorAdminUserId: ctx.actorAdminUserId,
+            stateBefore: before,
+            stateAfter: {
+                triggerAction: row.triggerAction,
+                conversionId: row.conversionId,
+                enabled: row.enabled,
+            },
+        });
+        this.onChange?.();
+        return this.toDto(row);
+    }
+    async remove(id, ctx) {
+        const em = this.emFactory();
+        const row = await em.findOne(LinkedInConversionMapping, { id });
+        if (!row)
+            throw this.notFound(id);
+        const before = { triggerAction: row.triggerAction, conversionId: row.conversionId };
+        await em.removeAndFlush(row);
+        await this.audit?.record({
+            action: 'linkedin_ads.conversion_mapping.deleted',
+            objectType: 'linkedin_conversion_mapping',
+            objectId: id,
+            actorAdminUserId: ctx.actorAdminUserId,
+            stateBefore: before,
+        });
+        this.onChange?.();
+    }
+    /**
+     * Enabled mappings applicable to a channel (channel-scoped OR all-channels),
+     * in the storefront shape. A NULL `salesChannelId` means "every channel" by
+     * explicit design, not by fail-open (Principle XII).
+     */
+    async loadForChannel(salesChannelId) {
+        const rows = await this.findEnabledForChannel(salesChannelId);
+        return rows.map((r) => ({
+            triggerAction: r.triggerAction,
+            conversionId: r.conversionId,
+        }));
+    }
+    /**
+     * Enabled mappings for one action on one channel, with the conversion rule
+     * URN resolved — server-side delivery addresses a rule by URN, not by the
+     * numeric id shown in Campaign Manager.
+     */
+    async loadRuleUrnsFor(salesChannelId, triggerAction) {
+        const rows = await this.findEnabledForChannel(salesChannelId);
+        return rows
+            .filter((r) => r.triggerAction === triggerAction)
+            .map((r) => r.conversionRuleUrn ?? conversionRuleUrnFor(r.conversionId));
+    }
+    async findEnabledForChannel(salesChannelId) {
+        const em = this.emFactory();
+        return em.find(LinkedInConversionMapping, { enabled: true, $or: [{ salesChannelId: null }, { salesChannelId }] }, { orderBy: { createdAt: 'asc' } });
+    }
+    notFound(id) {
+        return new HttpError(404, ERROR_CODES.NOT_FOUND, `Conversion mapping not found: ${id}`);
+    }
+    toDto(row) {
+        return {
+            id: row.id,
+            // `?? null` rather than a bare read: a freshly-created entity leaves an
+            // omitted optional property undefined, and JSON.stringify would drop the
+            // key entirely instead of sending the null the contract promises.
+            salesChannelId: row.salesChannelId ?? null,
+            triggerAction: row.triggerAction,
+            conversionId: row.conversionId,
+            conversionRuleUrn: row.conversionRuleUrn ?? null,
+            enabled: row.enabled,
+            version: row.version,
+            createdAt: row.createdAt.toISOString(),
+            updatedAt: row.updatedAt.toISOString(),
+        };
+    }
+}
+//# sourceMappingURL=conversion-mappings.service.js.map

package/dist/backend/services/conversion-mappings.service.js.map

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

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

@@ -0,0 +1,27 @@
+import { type LinkedInStorefrontConfig, type LinkedInStorefrontMapping } from '@endora-commerce/contracts';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+/**
+ * Loader for a channel's enabled conversion mappings in the storefront shape.
+ * Injected so the config service stays decoupled from mapping persistence.
+ */
+export type ConversionMappingsLoader = (salesChannelId: string) => Promise<LinkedInStorefrontMapping[]>;
+/**
+ * Resolves the per-sales-channel LinkedIn Ads configuration exposed to the
+ * storefront, from the module's Settings values plus the channel's enabled
+ * conversion mappings.
+ *
+ * A blank or absent Partner ID means the channel is untracked (FR-004): the
+ * returned config is fully disabled regardless of the master switch, so the
+ * storefront loads nothing. Every setting read degrades to its default rather
+ * than throwing — an unregistered or out-of-scope setting must not be able to
+ * fail a storefront render (FR-019).
+ */
+export declare class LinkedInConfigService {
+    private readonly settings;
+    private readonly loadMappings;
+    constructor(settings: SettingsReadPort, loadMappings?: ConversionMappingsLoader);
+    getConfig(salesChannelId: string): Promise<LinkedInStorefrontConfig>;
+    private readBool;
+    private readString;
+}
+//# sourceMappingURL=linkedin-config.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkedin-config.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/linkedin-config.service.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;;GAGG;AACH,MAAM,MAAM,wBAAwB,GAAG,CACrC,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,yBAAyB,EAAE,CAAC,CAAC;AAE1C;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAE9B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,YAAY;gBADZ,QAAQ,EAAE,gBAAgB,EAC1B,YAAY,GAAE,wBAAyC;IAGpE,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,CAAC;YAwB5D,QAAQ;YAYR,UAAU;CAWzB"}

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

@@ -0,0 +1,57 @@
+import { z } from 'zod';
+import { LINKEDIN_ADS_SETTING_CODES, LINKEDIN_DISABLED_CONFIG, } from '@endora-commerce/contracts';
+/**
+ * Resolves the per-sales-channel LinkedIn Ads configuration exposed to the
+ * storefront, from the module's Settings values plus the channel's enabled
+ * conversion mappings.
+ *
+ * A blank or absent Partner ID means the channel is untracked (FR-004): the
+ * returned config is fully disabled regardless of the master switch, so the
+ * storefront loads nothing. Every setting read degrades to its default rather
+ * than throwing — an unregistered or out-of-scope setting must not be able to
+ * fail a storefront render (FR-019).
+ */
+export class LinkedInConfigService {
+    settings;
+    loadMappings;
+    constructor(settings, loadMappings = async () => []) {
+        this.settings = settings;
+        this.loadMappings = loadMappings;
+    }
+    async getConfig(salesChannelId) {
+        const [enabled, partnerIdRaw, requireConsent] = await Promise.all([
+            this.readBool(LINKEDIN_ADS_SETTING_CODES.ENABLED, salesChannelId, false),
+            this.readString(LINKEDIN_ADS_SETTING_CODES.PARTNER_ID, salesChannelId, ''),
+            this.readBool(LINKEDIN_ADS_SETTING_CODES.REQUIRE_CONSENT, salesChannelId, true),
+        ]);
+        const partnerId = partnerIdRaw.trim() || null;
+        // Untracked channel: master switch off, or no partner id (FR-004). The
+        // operator's consent choice is still reported so the storefront's consent
+        // banner behaves consistently across channels.
+        if (!enabled || partnerId === null) {
+            return { ...LINKEDIN_DISABLED_CONFIG, requireConsent };
+        }
+        const [serverSide, conversionMappings] = await Promise.all([
+            this.readBool(LINKEDIN_ADS_SETTING_CODES.SERVER_SIDE_ENABLED, salesChannelId, false),
+            this.loadMappings(salesChannelId),
+        ]);
+        return { enabled: true, partnerId, requireConsent, serverSide, conversionMappings };
+    }
+    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=linkedin-config.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"linkedin-config.service.js","sourceRoot":"","sources":["../../../src/backend/services/linkedin-config.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,0BAA0B,EAC1B,wBAAwB,GAGzB,MAAM,4BAA4B,CAAC;AAWpC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,qBAAqB;IAEb;IACA;IAFnB,YACmB,QAA0B,EAC1B,eAAyC,KAAK,IAAI,EAAE,CAAC,EAAE;QADvD,aAAQ,GAAR,QAAQ,CAAkB;QAC1B,iBAAY,GAAZ,YAAY,CAA2C;IACvE,CAAC;IAEJ,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,MAAM,CAAC,OAAO,EAAE,YAAY,EAAE,cAAc,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAChE,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,CAAC;YACxE,IAAI,CAAC,UAAU,CAAC,0BAA0B,CAAC,UAAU,EAAE,cAAc,EAAE,EAAE,CAAC;YAC1E,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,eAAe,EAAE,cAAc,EAAE,IAAI,CAAC;SAChF,CAAC,CAAC;QAEH,MAAM,SAAS,GAAG,YAAY,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QAE9C,uEAAuE;QACvE,0EAA0E;QAC1E,+CAA+C;QAC/C,IAAI,CAAC,OAAO,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACnC,OAAO,EAAE,GAAG,wBAAwB,EAAE,cAAc,EAAE,CAAC;QACzD,CAAC;QAED,MAAM,CAAC,UAAU,EAAE,kBAAkB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACzD,IAAI,CAAC,QAAQ,CAAC,0BAA0B,CAAC,mBAAmB,EAAE,cAAc,EAAE,KAAK,CAAC;YACpF,IAAI,CAAC,YAAY,CAAC,cAAc,CAAC;SAClC,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACtF,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"}