@endora-commerce/mod-google-analytics 0.100.0

package/dist/backend/services/custom-events.service.js.map

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

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

@@ -0,0 +1,27 @@
+import { type GaStorefrontConfig, type GaStorefrontCustomEvent } from '@endora-commerce/contracts';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+/**
+ * Loader for a channel's enabled custom events, resolved into the storefront
+ * shape. Injected so the config service stays decoupled from the custom-events
+ * persistence (which lands in feature 049 US3). Defaults to an empty list until
+ * wired.
+ */
+export type CustomEventsLoader = (salesChannelId: string) => Promise<GaStorefrontCustomEvent[]>;
+/**
+ * Resolves the per-sales-channel Google Analytics configuration exposed to the
+ * storefront. Reads the module's Settings values (three-tier resolution) and
+ * folds in the channel's enabled custom events.
+ *
+ * A blank/absent Measurement ID means the channel is untracked (FR-004): the
+ * returned config has `enabled: false` and `measurementId: null` regardless of
+ * the master switch, so the storefront loads nothing for that channel.
+ */
+export declare class GaConfigService {
+    private readonly settings;
+    private readonly loadCustomEvents;
+    constructor(settings: SettingsReadPort, loadCustomEvents?: CustomEventsLoader);
+    getConfig(salesChannelId: string): Promise<GaStorefrontConfig>;
+    private readBool;
+    private readString;
+}
+//# sourceMappingURL=ga-config.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ga-config.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/ga-config.service.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAEzE;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,cAAc,EAAE,MAAM,KACnB,OAAO,CAAC,uBAAuB,EAAE,CAAC,CAAC;AAExC;;;;;;;;GAQG;AACH,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,gBAAgB;gBADhB,QAAQ,EAAE,gBAAgB,EAC1B,gBAAgB,GAAE,kBAAmC;IAGlE,SAAS,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;YAkDtD,QAAQ;YAYR,UAAU;CAWzB"}

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

@@ -0,0 +1,66 @@
+import { z } from 'zod';
+import { GOOGLE_ANALYTICS_SETTING_CODES, } from '@endora-commerce/contracts';
+/**
+ * Resolves the per-sales-channel Google Analytics configuration exposed to the
+ * storefront. Reads the module's Settings values (three-tier resolution) and
+ * folds in the channel's enabled custom events.
+ *
+ * A blank/absent Measurement ID means the channel is untracked (FR-004): the
+ * returned config has `enabled: false` and `measurementId: null` regardless of
+ * the master switch, so the storefront loads nothing for that channel.
+ */
+export class GaConfigService {
+    settings;
+    loadCustomEvents;
+    constructor(settings, loadCustomEvents = async () => []) {
+        this.settings = settings;
+        this.loadCustomEvents = loadCustomEvents;
+    }
+    async getConfig(salesChannelId) {
+        const enabled = await this.readBool(GOOGLE_ANALYTICS_SETTING_CODES.ENABLED, salesChannelId, false);
+        const measurementIdRaw = await this.readString(GOOGLE_ANALYTICS_SETTING_CODES.MEASUREMENT_ID, salesChannelId, '');
+        const measurementId = measurementIdRaw.trim() || null;
+        const requireConsent = await this.readBool(GOOGLE_ANALYTICS_SETTING_CODES.REQUIRE_CONSENT, salesChannelId, true);
+        // Untracked channel: master switch off or no measurement id (FR-004).
+        if (!enabled || measurementId === null) {
+            return {
+                enabled: false,
+                measurementId: null,
+                enhancedEcommerce: false,
+                serverSide: false,
+                requireConsent,
+                customEvents: [],
+            };
+        }
+        const [enhancedEcommerce, serverSide, customEvents] = await Promise.all([
+            this.readBool(GOOGLE_ANALYTICS_SETTING_CODES.ENHANCED_ECOMMERCE_ENABLED, salesChannelId, false),
+            this.readBool(GOOGLE_ANALYTICS_SETTING_CODES.SERVER_SIDE_ENABLED, salesChannelId, false),
+            this.loadCustomEvents(salesChannelId),
+        ]);
+        return {
+            enabled: true,
+            measurementId,
+            enhancedEcommerce,
+            serverSide,
+            requireConsent,
+            customEvents,
+        };
+    }
+    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=ga-config.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ga-config.service.js","sourceRoot":"","sources":["../../../src/backend/services/ga-config.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,8BAA8B,GAG/B,MAAM,4BAA4B,CAAC;AAapC;;;;;;;;GAQG;AACH,MAAM,OAAO,eAAe;IAEP;IACA;IAFnB,YACmB,QAA0B,EAC1B,mBAAuC,KAAK,IAAI,EAAE,CAAC,EAAE;QADrD,aAAQ,GAAR,QAAQ,CAAkB;QAC1B,qBAAgB,GAAhB,gBAAgB,CAAqC;IACrE,CAAC;IAEJ,KAAK,CAAC,SAAS,CAAC,cAAsB;QACpC,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CACjC,8BAA8B,CAAC,OAAO,EACtC,cAAc,EACd,KAAK,CACN,CAAC;QACF,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,UAAU,CAC5C,8BAA8B,CAAC,cAAc,EAC7C,cAAc,EACd,EAAE,CACH,CAAC;QACF,MAAM,aAAa,GAAG,gBAAgB,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;QACtD,MAAM,cAAc,GAAG,MAAM,IAAI,CAAC,QAAQ,CACxC,8BAA8B,CAAC,eAAe,EAC9C,cAAc,EACd,IAAI,CACL,CAAC;QAEF,sEAAsE;QACtE,IAAI,CAAC,OAAO,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;YACvC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,aAAa,EAAE,IAAI;gBACnB,iBAAiB,EAAE,KAAK;gBACxB,UAAU,EAAE,KAAK;gBACjB,cAAc;gBACd,YAAY,EAAE,EAAE;aACjB,CAAC;QACJ,CAAC;QAED,MAAM,CAAC,iBAAiB,EAAE,UAAU,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACtE,IAAI,CAAC,QAAQ,CACX,8BAA8B,CAAC,0BAA0B,EACzD,cAAc,EACd,KAAK,CACN;YACD,IAAI,CAAC,QAAQ,CAAC,8BAA8B,CAAC,mBAAmB,EAAE,cAAc,EAAE,KAAK,CAAC;YACxF,IAAI,CAAC,gBAAgB,CAAC,cAAc,CAAC;SACtC,CAAC,CAAC;QAEH,OAAO;YACL,OAAO,EAAE,IAAI;YACb,aAAa;YACb,iBAAiB;YACjB,UAAU;YACV,cAAc;YACd,YAAY;SACb,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"}

package/dist/backend/services/ga4-mp-client.d.ts

@@ -0,0 +1,32 @@
+/**
+ * GA4 Measurement Protocol / server-side GTM client (feature 049, US4).
+ *
+ * Forwards a single analytics event server-side. Unlike the legacy
+ * `analytics/ga4-forwarder.ts` (fire-and-forget), this client THROWS on a
+ * non-2xx response or transport error so the BullMQ worker retries
+ * (Principle X / FR-024). `fetchFn` is injectable for tests.
+ */
+export interface Ga4MpDestination {
+    /** Server-side GTM container URL; blank ⇒ GA4 MP default endpoint. */
+    endpoint: string;
+    measurementId: string;
+    apiSecret: string;
+}
+export interface Ga4MpEvent {
+    clientId: string;
+    name: string;
+    params: Record<string, string | number | boolean>;
+    consent: {
+        analyticsStorage: 'granted' | 'denied';
+    };
+}
+export interface Ga4MpClientOptions {
+    fetchFn?: typeof fetch;
+    timeoutMs?: number;
+}
+export declare class Ga4MpClient {
+    private readonly options;
+    constructor(options?: Ga4MpClientOptions);
+    send(dest: Ga4MpDestination, event: Ga4MpEvent): Promise<void>;
+}
+//# sourceMappingURL=ga4-mp-client.d.ts.map

package/dist/backend/services/ga4-mp-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ga4-mp-client.d.ts","sourceRoot":"","sources":["../../../src/backend/services/ga4-mp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAClD,OAAO,EAAE;QAAE,gBAAgB,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,CAAC;CACrD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAID,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,GAAE,kBAAuB;IAEvD,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BrE"}

package/dist/backend/services/ga4-mp-client.js

@@ -0,0 +1,46 @@
+/**
+ * GA4 Measurement Protocol / server-side GTM client (feature 049, US4).
+ *
+ * Forwards a single analytics event server-side. Unlike the legacy
+ * `analytics/ga4-forwarder.ts` (fire-and-forget), this client THROWS on a
+ * non-2xx response or transport error so the BullMQ worker retries
+ * (Principle X / FR-024). `fetchFn` is injectable for tests.
+ */
+const MP_DEFAULT_BASE = 'https://www.google-analytics.com/mp/collect';
+export class Ga4MpClient {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async send(dest, event) {
+        const fetchFn = this.options.fetchFn ?? globalThis.fetch;
+        const base = dest.endpoint.trim() || MP_DEFAULT_BASE;
+        const url = `${base}?measurement_id=${encodeURIComponent(dest.measurementId)}` +
+            `&api_secret=${encodeURIComponent(dest.apiSecret)}`;
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), this.options.timeoutMs ?? 10_000);
+        try {
+            const res = await fetchFn(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json' },
+                signal: controller.signal,
+                body: JSON.stringify({
+                    client_id: event.clientId,
+                    consent: {
+                        ad_user_data: event.consent.analyticsStorage === 'granted' ? 'GRANTED' : 'DENIED',
+                        ad_personalization: event.consent.analyticsStorage === 'granted' ? 'GRANTED' : 'DENIED',
+                    },
+                    events: [{ name: event.name, params: event.params }],
+                }),
+            });
+            // GA4 MP returns 204 on success; treat any non-2xx as retryable.
+            if (!res.ok) {
+                throw new Error(`GA4 MP delivery failed with status ${res.status}`);
+            }
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+}
+//# sourceMappingURL=ga4-mp-client.js.map

package/dist/backend/services/ga4-mp-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ga4-mp-client.js","sourceRoot":"","sources":["../../../src/backend/services/ga4-mp-client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAqBH,MAAM,eAAe,GAAG,6CAA6C,CAAC;AAEtE,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,UAA8B,EAAE;QAAhC,YAAO,GAAP,OAAO,CAAyB;IAAG,CAAC;IAEjE,KAAK,CAAC,IAAI,CAAC,IAAsB,EAAE,KAAiB;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,UAAU,CAAC,KAAK,CAAC;QACzD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,eAAe,CAAC;QACrD,MAAM,GAAG,GACP,GAAG,IAAI,mBAAmB,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC,EAAE;YAClE,eAAe,kBAAkB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAEtD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS,IAAI,MAAM,CAAC,CAAC;QACvF,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;gBAC7B,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,MAAM,EAAE,UAAU,CAAC,MAAM;gBACzB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,SAAS,EAAE,KAAK,CAAC,QAAQ;oBACzB,OAAO,EAAE;wBACP,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;wBACjF,kBAAkB,EAAE,KAAK,CAAC,OAAO,CAAC,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ;qBACxF;oBACD,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;iBACrD,CAAC;aACH,CAAC,CAAC;YACH,iEAAiE;YACjE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;gBACZ,MAAM,IAAI,KAAK,CAAC,sCAAsC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/backend/services/ss-delivery-queue.d.ts

@@ -0,0 +1,32 @@
+import { Queue, Worker, type Processor, type QueueOptions, type WorkerOptions } from 'bullmq';
+import type { Redis } from 'ioredis';
+import type { GaCollectRequest } from '@endora-commerce/contracts';
+/**
+ * BullMQ queue for server-side Google Analytics event delivery (feature 049,
+ * US4 / Principle X). The storefront `/collect` route is a pure producer: it
+ * validates and enqueues one job per event; this worker forwards each event to
+ * the channel's GA4 destination (Measurement Protocol or server-side GTM),
+ * throwing on failure so BullMQ retries. Idempotency key: `eventId`.
+ */
+export interface GaDeliveryJobData {
+    eventId: string;
+    salesChannelId: string;
+    clientId: string;
+    event: {
+        name: string;
+        params: Record<string, string | number | boolean>;
+    };
+    consent: {
+        analyticsStorage: 'granted' | 'denied';
+    };
+    occurredAt: string;
+}
+/**
+ * Producer callback exposed to the storefront route. Assigns an `eventId` per
+ * event, enqueues a delivery job for each, and returns how many were accepted.
+ */
+export type GaCollectEnqueuer = (salesChannelId: string, request: GaCollectRequest) => Promise<number>;
+export declare const GA_DELIVERY_QUEUE_NAME = "google_analytics.ss.deliver";
+export declare function createGaDeliveryQueue(redis: Redis, overrides?: Partial<QueueOptions>): Queue<GaDeliveryJobData>;
+export declare function createGaDeliveryWorker(redis: Redis, processor: Processor<GaDeliveryJobData>, overrides?: Partial<WorkerOptions>): Worker<GaDeliveryJobData>;
+//# sourceMappingURL=ss-delivery-queue.d.ts.map

package/dist/backend/services/ss-delivery-queue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ss-delivery-queue.d.ts","sourceRoot":"","sources":["../../../src/backend/services/ss-delivery-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAS,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,QAAQ,CAAC;AAE9F,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;KAAE,CAAC;IAC3E,OAAO,EAAE;QAAE,gBAAgB,EAAE,SAAS,GAAG,QAAQ,CAAA;KAAE,CAAC;IACpD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,gBAAgB,KACtB,OAAO,CAAC,MAAM,CAAC,CAAC;AAErB,eAAO,MAAM,sBAAsB,gCAAgC,CAAC;AAKpE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,KAAK,EACZ,SAAS,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAChC,KAAK,CAAC,iBAAiB,CAAC,CAY1B;AAED,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,KAAK,EACZ,SAAS,EAAE,SAAS,CAAC,iBAAiB,CAAC,EACvC,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,MAAM,CAAC,iBAAiB,CAAC,CAa3B"}

package/dist/backend/services/ss-delivery-queue.js

@@ -0,0 +1,29 @@
+import { Queue, Worker } from 'bullmq';
+import { enterSystemScope } from '@endora-commerce/platform/kernel';
+export const GA_DELIVERY_QUEUE_NAME = 'google_analytics.ss.deliver';
+const DEFAULT_ATTEMPTS = 8;
+const DEFAULT_BACKOFF = { type: 'exponential', delay: 1_000 };
+export function createGaDeliveryQueue(redis, overrides) {
+    const options = {
+        connection: redis,
+        defaultJobOptions: {
+            attempts: DEFAULT_ATTEMPTS,
+            backoff: DEFAULT_BACKOFF,
+            removeOnComplete: { count: 500 },
+            removeOnFail: { count: 5_000 },
+        },
+        ...overrides,
+    };
+    return new Queue(GA_DELIVERY_QUEUE_NAME, options);
+}
+export function createGaDeliveryWorker(redis, processor, overrides) {
+    const options = {
+        connection: redis,
+        concurrency: 8,
+        ...overrides,
+    };
+    // Feature 072 (T033) — the job establishes its own scope; it established
+    // nothing before.
+    return new Worker(GA_DELIVERY_QUEUE_NAME, (job) => enterSystemScope('google_analytics: server-side delivery', () => processor(job)), options);
+}
+//# sourceMappingURL=ss-delivery-queue.js.map

package/dist/backend/services/ss-delivery-queue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ss-delivery-queue.js","sourceRoot":"","sources":["../../../src/backend/services/ss-delivery-queue.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAyD,MAAM,QAAQ,CAAC;AAC9F,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AA6BpE,MAAM,CAAC,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAEpE,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAC3B,MAAM,eAAe,GAAG,EAAE,IAAI,EAAE,aAAsB,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAEvE,MAAM,UAAU,qBAAqB,CACnC,KAAY,EACZ,SAAiC;IAEjC,MAAM,OAAO,GAAiB;QAC5B,UAAU,EAAE,KAAK;QACjB,iBAAiB,EAAE;YACjB,QAAQ,EAAE,gBAAgB;YAC1B,OAAO,EAAE,eAAe;YACxB,gBAAgB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE;YAChC,YAAY,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;SAC/B;QACD,GAAG,SAAS;KACb,CAAC;IACF,OAAO,IAAI,KAAK,CAAoB,sBAAsB,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,KAAY,EACZ,SAAuC,EACvC,SAAkC;IAElC,MAAM,OAAO,GAAkB;QAC7B,UAAU,EAAE,KAAK;QACjB,WAAW,EAAE,CAAC;QACd,GAAG,SAAS;KACb,CAAC;IACF,yEAAyE;IACzE,kBAAkB;IAClB,OAAO,IAAI,MAAM,CACf,sBAAsB,EACtB,CAAC,GAAG,EAAE,EAAE,CAAC,gBAAgB,CAAC,wCAAwC,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,EACzF,OAAO,CACR,CAAC;AACJ,CAAC"}

package/dist/backend/services/ss-delivery.service.d.ts

@@ -0,0 +1,24 @@
+import type { Processor } from 'bullmq';
+import type { Queue } from 'bullmq';
+import { type GaCollectRequest } from '@endora-commerce/contracts';
+import type { SettingsReadPort } from '@endora-commerce/platform/kernel';
+import type { GaDeliveryJobData } from './ss-delivery-queue.js';
+import type { Ga4MpClient } from './ga4-mp-client.js';
+/**
+ * Server-side delivery orchestration (feature 049, US4).
+ *
+ * - `makeEnqueuer` returns the producer used by the `/collect` route: it assigns
+ *   an `eventId` per event (idempotency key) and enqueues one delivery job each.
+ *   Pure producer — no forwarding here (Principle X).
+ * - `makeProcessor` returns the BullMQ processor: it resolves the channel's
+ *   Measurement ID + endpoint + decrypted API secret from Settings and forwards
+ *   via the MP client, throwing on failure so BullMQ retries. Idempotent w.r.t.
+ *   retry (the destination call carries the stable `eventId` in params).
+ */
+export declare function makeEnqueuer(queue: Queue<GaDeliveryJobData>): (salesChannelId: string, request: GaCollectRequest) => Promise<number>;
+export interface ProcessorDeps {
+    settings: SettingsReadPort;
+    client: Ga4MpClient;
+}
+export declare function makeProcessor(deps: ProcessorDeps): Processor<GaDeliveryJobData>;
+//# sourceMappingURL=ss-delivery.service.d.ts.map

package/dist/backend/services/ss-delivery.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ss-delivery.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/ss-delivery.service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAkC,KAAK,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,iBAAiB,CAAC,IAC5C,gBAAgB,MAAM,EAAE,SAAS,gBAAgB,KAAG,OAAO,CAAC,MAAM,CAAC,CAqBlF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,MAAM,EAAE,WAAW,CAAC;CACrB;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC,iBAAiB,CAAC,CAiC/E"}

package/dist/backend/services/ss-delivery.service.js

@@ -0,0 +1,52 @@
+import { randomUUID } from 'crypto';
+import { z } from 'zod';
+import { GOOGLE_ANALYTICS_SETTING_CODES } from '@endora-commerce/contracts';
+/**
+ * Server-side delivery orchestration (feature 049, US4).
+ *
+ * - `makeEnqueuer` returns the producer used by the `/collect` route: it assigns
+ *   an `eventId` per event (idempotency key) and enqueues one delivery job each.
+ *   Pure producer — no forwarding here (Principle X).
+ * - `makeProcessor` returns the BullMQ processor: it resolves the channel's
+ *   Measurement ID + endpoint + decrypted API secret from Settings and forwards
+ *   via the MP client, throwing on failure so BullMQ retries. Idempotent w.r.t.
+ *   retry (the destination call carries the stable `eventId` in params).
+ */
+export function makeEnqueuer(queue) {
+    return async (salesChannelId, request) => {
+        const occurredAt = new Date().toISOString();
+        let accepted = 0;
+        for (const event of request.events) {
+            const eventId = randomUUID();
+            await queue.add('deliver', {
+                eventId,
+                salesChannelId,
+                clientId: request.clientId,
+                event: { name: event.name, params: { ...event.params, ga_event_id: eventId } },
+                consent: request.consent,
+                occurredAt,
+            }, { jobId: eventId });
+            accepted += 1;
+        }
+        return accepted;
+    };
+}
+export function makeProcessor(deps) {
+    return async (job) => {
+        const { salesChannelId } = job.data;
+        const measurementId = await deps.settings.get(GOOGLE_ANALYTICS_SETTING_CODES.MEASUREMENT_ID, salesChannelId, z.string());
+        if (!measurementId.trim()) {
+            // Channel untracked — drop silently (do not retry a permanent no-op).
+            return;
+        }
+        const apiSecret = await deps.settings.get(GOOGLE_ANALYTICS_SETTING_CODES.SERVER_SIDE_API_SECRET, salesChannelId, z.string());
+        const endpoint = await deps.settings.get(GOOGLE_ANALYTICS_SETTING_CODES.SERVER_SIDE_ENDPOINT, salesChannelId, z.string());
+        await deps.client.send({ endpoint, measurementId, apiSecret }, {
+            clientId: job.data.clientId,
+            name: job.data.event.name,
+            params: job.data.event.params,
+            consent: job.data.consent,
+        });
+    };
+}
+//# sourceMappingURL=ss-delivery.service.js.map

package/dist/backend/services/ss-delivery.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ss-delivery.service.js","sourceRoot":"","sources":["../../../src/backend/services/ss-delivery.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,8BAA8B,EAAyB,MAAM,4BAA4B,CAAC;AAKnG;;;;;;;;;;GAUG;AACH,MAAM,UAAU,YAAY,CAAC,KAA+B;IAC1D,OAAO,KAAK,EAAE,cAAsB,EAAE,OAAyB,EAAmB,EAAE;QAClF,MAAM,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC5C,IAAI,QAAQ,GAAG,CAAC,CAAC;QACjB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;YAC7B,MAAM,KAAK,CAAC,GAAG,CACb,SAAS,EACT;gBACE,OAAO;gBACP,cAAc;gBACd,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,EAAE;gBAC9E,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,UAAU;aACX,EACD,EAAE,KAAK,EAAE,OAAO,EAAE,CACnB,CAAC;YACF,QAAQ,IAAI,CAAC,CAAC;QAChB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,OAAO,KAAK,EAAE,GAAG,EAAE,EAAE;QACnB,MAAM,EAAE,cAAc,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC;QACpC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CAC3C,8BAA8B,CAAC,cAAc,EAC7C,cAAc,EACd,CAAC,CAAC,MAAM,EAAE,CACX,CAAC;QACF,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,EAAE,CAAC;YAC1B,sEAAsE;YACtE,OAAO;QACT,CAAC;QACD,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CACvC,8BAA8B,CAAC,sBAAsB,EACrD,cAAc,EACd,CAAC,CAAC,MAAM,EAAE,CACX,CAAC;QACF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,CACtC,8BAA8B,CAAC,oBAAoB,EACnD,cAAc,EACd,CAAC,CAAC,MAAM,EAAE,CACX,CAAC;QAEF,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,CACpB,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,EAAE,EACtC;YACE,QAAQ,EAAE,GAAG,CAAC,IAAI,CAAC,QAAQ;YAC3B,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI;YACzB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;YAC7B,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO;SAC1B,CACF,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,194 @@
+/**
+ * Google Analytics module (feature 049). Integrates the storefront with
+ * Google Analytics 4: per-sales-channel activation + Measurement ID, Enhanced
+ * Ecommerce, an optional server-side tagging delivery path (durable BullMQ
+ * worker — Principle X), and an admin custom-events builder. Per-channel
+ * configuration is stored through the Settings module; the Measurement Protocol
+ * API secret uses the `secret` value type (feature 043, AES-256-GCM at rest).
+ *
+ * Distinct from the legacy `analytics` module (internal first-party event log +
+ * env-gated forwarder), which this module supersedes for GA forwarding.
+ */
+export declare const googleAnalyticsSettingsManifest: {
+    moduleCode: string;
+    groups: {
+        code: string;
+        name: string;
+        salesChannelCodes?: string[] | undefined;
+        isSystemProtected?: boolean | undefined;
+    }[];
+    settings: {
+        code: string;
+        name: string;
+        valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+        defaultValue: unknown;
+        description?: string | undefined;
+        groupCode?: string | undefined;
+        previousDefaultValues?: unknown[] | undefined;
+        salesChannelCodes?: string[] | undefined;
+        enumOptions?: string[] | undefined;
+        configurationType?: string | undefined;
+        hidden?: boolean | undefined;
+    }[];
+};
+export declare const manifest: {
+    id: string;
+    name: string;
+    version: string;
+    dependencies: string[];
+    description?: string | undefined;
+    acknowledgedDependencies?: {
+        moduleId: string;
+        port: string;
+        reason: string;
+    }[] | undefined;
+    nonBindingDependencies?: {
+        moduleId: string;
+        name: string;
+        kind: "contributes-to" | "degrades-without" | "refuses-without";
+        reason: string;
+        whenAbsent?: string | undefined;
+    }[] | undefined;
+    activation?: {
+        settingCode: string;
+        default: boolean;
+    } | {
+        nonDeactivatable: true;
+        reason: string;
+    } | undefined;
+    settings?: {
+        moduleCode: string;
+        groups: {
+            code: string;
+            name: string;
+            salesChannelCodes?: string[] | undefined;
+            isSystemProtected?: boolean | undefined;
+        }[];
+        settings: {
+            code: string;
+            name: string;
+            valueType: "string" | "number" | "boolean" | "json" | "string_list" | "secret" | "credential_ref";
+            defaultValue: unknown;
+            description?: string | undefined;
+            groupCode?: string | undefined;
+            previousDefaultValues?: unknown[] | undefined;
+            salesChannelCodes?: string[] | undefined;
+            enumOptions?: string[] | undefined;
+            configurationType?: string | undefined;
+            hidden?: boolean | undefined;
+        }[];
+    } | undefined;
+    i18n?: {
+        bundlesDir: string;
+    } | undefined;
+    docs?: false | {
+        dir: string;
+    } | undefined;
+    demo?: false | {
+        summary: string;
+        seed: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoSeedResult>;
+        reset: (context: import("@endora-commerce/contracts").ModuleDemoContext<never>) => Promise<import("@endora-commerce/contracts").DemoResetResult>;
+        after?: readonly string[] | undefined;
+        package?: string | undefined;
+    } | undefined;
+    actions?: {
+        id: string;
+        labelKey: string;
+        icon: "Plus" | "Sparkles" | "Settings" | "Search" | "Boxes" | "Layers" | "Menu" | "PlusCircle" | "PlusSquare" | "FilePlus" | "FolderPlus" | "Upload" | "FileUp" | "CloudUpload" | "Download" | "FileDown" | "FileText" | "BookOpen" | "Rss" | "Package" | "Tag" | "ShoppingCart" | "Receipt" | "CreditCard" | "Users" | "UserPlus" | "Inbox" | "ListChecks" | "ClipboardList" | "Image" | "Video" | "LayoutDashboard" | "PanelLeft" | "KeyRound" | "ShieldCheck" | "Edit" | "Archive" | "Box" | "Truck" | "CircleDollarSign" | "Activity" | "LineChart" | "Smartphone" | "Webhook" | "Scale" | "PlugZap" | "PercentDiamond" | "Newspaper" | "Languages" | "Eraser" | "Warehouse" | "TrendingDown" | "Bell" | "PackageOpen" | "Building2" | "Store" | "ClipboardCheck";
+        targetRoute: string;
+        keywords: string[];
+        weight: number;
+        descriptionKey?: string | undefined;
+        requiredPermission?: string | undefined;
+    }[] | undefined;
+    permissions?: {
+        code: string;
+        label: string;
+        module?: string | undefined;
+        description?: string | undefined;
+        requires?: string[] | undefined;
+    }[] | undefined;
+    transactionalEmails?: {
+        code: string;
+        name: string;
+        variables: {
+            key: string;
+            label: string;
+            sampleValue?: string | undefined;
+            description?: string | undefined;
+        }[];
+        description?: string | undefined;
+        group?: string | undefined;
+    }[] | undefined;
+    capabilities?: string[] | undefined;
+    exclusiveCapabilities?: {
+        key: string;
+        errorCode: string;
+    }[] | undefined;
+    errorCodes?: {
+        code: string;
+        tokens?: string[] | undefined;
+    }[] | undefined;
+    blocks?: {
+        name: string;
+        labelKey: string;
+        category: string;
+        contexts: ("cms" | "invoice" | "email" | "newsletter")[];
+        fields: Record<string, {
+            type: "number" | "object" | "array" | "text" | "textarea" | "select" | "radio" | "external" | "uuid" | "richtext";
+            label?: string | undefined;
+            required?: boolean | undefined;
+            options?: {
+                label: string;
+                value: string | number;
+            }[] | undefined;
+            refKind?: string | undefined;
+        }>;
+        descriptionKey?: string | undefined;
+        defaultProps?: Record<string, unknown> | undefined;
+        responsiveFields?: string[] | undefined;
+        previewIcon?: string | undefined;
+        weight?: number | undefined;
+    }[] | undefined;
+    blockCategories?: {
+        key: string;
+        titleKey: string;
+        contexts: ("cms" | "invoice" | "email" | "newsletter")[];
+        weight?: number | undefined;
+        visible?: boolean | undefined;
+    }[] | undefined;
+    env?: {
+        name: string;
+        describes: {
+            en: string;
+            pl: string;
+        };
+        requirement: {
+            kind: "required";
+        } | {
+            kind: "requiredWhen";
+            input: string;
+            equals: string;
+        } | {
+            kind: "optional";
+            without: {
+                en: string;
+                pl: string;
+            };
+        };
+        secret: boolean;
+        generable: boolean;
+        owner: {
+            kind: "platform";
+        } | {
+            kind: "application";
+            application: "admin" | "backend" | "storefront";
+        } | {
+            kind: "module";
+            moduleId: string;
+        };
+        consumers: ("admin" | "backend" | "storefront")[];
+        addressOf: "admin" | "backend" | "storefront" | null;
+    }[] | undefined;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;CA2E1C,CAAC;AAEH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8CnB,CAAC"}