@endora-commerce/mod-analytics 0.100.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Endora sp. z o.o. and the Endora Commerce contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,57 @@
+<!-- Generated by `pnpm --filter backend run manifests:generate`. Delete this line to take the file over; a README without it is never regenerated. -->
+
+# @endora-commerce/mod-analytics
+
+Server-side analytics aggregation and dashboard data feeds.
+
+## What this is
+
+An **Endora Commerce module package**. Its module id is `analytics` — the identity of record in the platform's registries, in its migrations and in its setting, permission and translation codes.
+
+A module is not imported by application code. The platform discovers the extension packages an instance has installed, reads the manifest on the root subpath and composes the module from it, so installing this package and starting the instance is the whole integration.
+
+## Entry points
+
+| Import | Contents |
+| --- | --- |
+| `@endora-commerce/mod-analytics` | the module manifest — its id, version, dependencies, settings and activation |
+| `@endora-commerce/mod-analytics/admin` | the Admin UI contribution: the screens, navigation and palette actions it adds |
+| `@endora-commerce/mod-analytics/backend` | the composition root the platform calls, with the entities, services, routes and workers it registers |
+| `@endora-commerce/mod-analytics/migrations` | the module’s own schema migrations, in the order the platform runs them |
+| `@endora-commerce/mod-analytics/tailwind.css` | the Tailwind source declaration for the admin code above |
+
+## Depends on
+
+Everything below is a **peer** dependency, so the application resolves exactly one copy of each — two copies of a host or of React are a runtime failure rather than a type error. An entry marked *optional* is needed only by the layers that use it.
+
+**Endora packages**
+
+- `@endora-commerce/admin-kit` — *optional*
+- `@endora-commerce/contracts`
+- `@endora-commerce/platform`
+
+**Third-party**
+
+- `@mikro-orm/core` ^6
+- `@mikro-orm/migrations` ^6
+- `@mikro-orm/postgresql` ^6
+- `fastify` ^5
+- `lucide-react` ^1 — *optional*
+- `react` ^19 — *optional*
+
+## What the tarball carries
+
+- `dist/` — the compiled JavaScript and its type declarations
+- `i18n/` — the translation bundles this package ships (`en`, `pl`), loaded by the platform
+- `docs/` — the package’s own pages in the Endora Commerce documentation site
+- `tailwind.css` — the Tailwind source declaration
+
+## Install
+
+```bash
+pnpm add @endora-commerce/mod-analytics
+```
+
+## Licence
+
+MIT — the text is in `LICENSE`, beside this file.

package/dist/admin/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * `analytics`' admin surface — one route and one sidebar entry, declared by the
+ * module that owns them (feature 091, Phase 4;
+ * `specs/091-module-owned-admin-surfaces/contracts/admin-contribution.md`).
+ *
+ * This is the **second batch** of the drain, and it was selected by the rule
+ * `research.md` §6 sets — ascending incoming cross-module reach — with the
+ * feasibility test batch one applied on top of it. `analytics` has **zero**
+ * admin cross-module reach in either direction, and it is the only remaining
+ * zero-incoming directory every one of whose host symbols
+ * `@endora-commerce/admin-kit` publishes: the other candidates at that rung
+ * reach either a Group A picker (`api_keys`, `comparisons`, `megamenu`, `blog`,
+ * `webhooks`) or the Group B session cluster (`payment_methods`, `promotions`),
+ * both of which `backend/scripts/ledgers/admin-surface.ts` records as
+ * unpublished with a retiring condition that is somebody else's merge request.
+ *
+ * **This entry exports data and nothing else** (R2), like every `./admin`
+ * layer: `check:module-boundary`'s D-171 rule designates a subpath as contract
+ * surface when it emits no runtime binding, and `./admin` deliberately does not
+ * qualify, so a consumer reaching into another module's `./admin` stays a
+ * counted boundary reach.
+ *
+ * **The component is a dynamic-import factory** (R6), so Vite has a split point
+ * whether or not anybody remembers to ask for one.
+ */
+import type { AdminContributions } from '@endora-commerce/admin-kit/contributions';
+export declare const contributions: AdminContributions;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AAKnF,eAAO,MAAM,aAAa,EAAE,kBA0C3B,CAAC"}

package/dist/admin/index.js

@@ -0,0 +1,46 @@
+/** The module's only route: the analytics dashboard. */
+const ROUTE_PATH = '/analytics';
+export const contributions = {
+    routes: [
+        {
+            path: ROUTE_PATH,
+            component: () => import('./pages/AnalyticsPage.js'),
+            // Read from the route this screen calls —
+            // `requireAdmin('analytics:read')` on
+            // `GET /api/v1/admin/analytics/summary` — and the same code the
+            // module's `open-analytics` palette action declares, which
+            // `check:action-route-permissions` holds to that route.
+            requiredPermission: 'analytics:read',
+            index: true,
+        },
+    ],
+    nav: [
+        {
+            to: ROUTE_PATH,
+            // Module-relative (R8), resolved in this module's own namespace out of
+            // `packages/modules/analytics/i18n/`. It was `appShell.nav.analytics` in
+            // the shared `_i18n` bundle, one of the four shared files a module author
+            // had to edit.
+            labelKey: 'nav.analytics.label',
+            // The icon the hand-written NAV entry carried. `LineChart` joins
+            // `KnownIconNameSchema` and `icon-map.ts` in this merge request so the
+            // sidebar renders the same glyph it did before the move; swapping to a
+            // name already on the allowlist would have been a visible change bought
+            // for nothing.
+            icon: 'LineChart',
+            section: 'analyticsAds',
+            // Below `google_analytics`' 200, which is the order the two had in the
+            // hand-written NAV: `/analytics` first, `/google-analytics` second. A
+            // module's entries still append to their section as a block until the
+            // host's own entries carry weights, so the pair now sits after
+            // `/linkedin-ads` and `/meta-ads` rather than before them — recorded in
+            // `admin/test/components/AppShell.analytics-nav.test.tsx` rather than
+            // left to be discovered.
+            weight: 100,
+            // The code that opens the screen, which is the only code this module's
+            // admin surface enforces — the dashboard is read-only.
+            requiredPermission: 'analytics:read',
+        },
+    ],
+};
+//# sourceMappingURL=index.js.map

package/dist/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/admin/index.ts"],"names":[],"mappings":"AA2BA,wDAAwD;AACxD,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,MAAM,CAAC,MAAM,aAAa,GAAuB;IAC/C,MAAM,EAAE;QACN;YACE,IAAI,EAAE,UAAU;YAChB,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,0BAA0B,CAAC;YACnD,0CAA0C;YAC1C,sCAAsC;YACtC,gEAAgE;YAChE,2DAA2D;YAC3D,wDAAwD;YACxD,kBAAkB,EAAE,gBAAgB;YACpC,KAAK,EAAE,IAAI;SACZ;KACF;IACD,GAAG,EAAE;QACH;YACE,EAAE,EAAE,UAAU;YACd,uEAAuE;YACvE,yEAAyE;YACzE,0EAA0E;YAC1E,eAAe;YACf,QAAQ,EAAE,qBAAqB;YAC/B,iEAAiE;YACjE,uEAAuE;YACvE,uEAAuE;YACvE,wEAAwE;YACxE,eAAe;YACf,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,cAAc;YACvB,uEAAuE;YACvE,sEAAsE;YACtE,sEAAsE;YACtE,+DAA+D;YAC/D,wEAAwE;YACxE,sEAAsE;YACtE,yBAAyB;YACzB,MAAM,EAAE,GAAG;YACX,uEAAuE;YACvE,uDAAuD;YACvD,kBAAkB,EAAE,gBAAgB;SACrC;KACF;CACF,CAAC"}

package/dist/admin/pages/AnalyticsPage.d.ts

@@ -0,0 +1,3 @@
+import { type ReactNode } from 'react';
+export default function AnalyticsPage(): ReactNode;
+//# sourceMappingURL=AnalyticsPage.d.ts.map

package/dist/admin/pages/AnalyticsPage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsPage.d.ts","sourceRoot":"","sources":["../../../src/admin/pages/AnalyticsPage.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA6C,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AA6BlF,MAAM,CAAC,OAAO,UAAU,aAAa,IAAI,SAAS,CA2JjD"}

package/dist/admin/pages/AnalyticsPage.js

@@ -0,0 +1,58 @@
+import { Fragment as _Fragment, jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useCallback, useEffect, useMemo, useState } from 'react';
+import { RefreshCw } from 'lucide-react';
+import { ApiError, apiClient, formatDateTime } from '@endora-commerce/admin-kit/lib';
+import { Alert, AlertDescription, Button, Card, CardContent, CardHeader, CardTitle, PageHeader, Select, Table, TableBody, TableCell, TableHead, TableHeader, TableRow, } from '@endora-commerce/admin-kit/ui';
+import { useTranslation } from '@endora-commerce/admin-kit/i18n';
+const RANGE_OPTION_VALUES = [7, 30, 90];
+export default function AnalyticsPage() {
+    const t = useTranslation('analytics');
+    const RANGE_OPTIONS = [
+        { value: 7, label: t('range.7days') },
+        { value: 30, label: t('range.30days') },
+        { value: 90, label: t('range.90days') },
+    ];
+    void RANGE_OPTION_VALUES;
+    const [rangeDays, setRangeDays] = useState(30);
+    const [summary, setSummary] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const window = useMemo(() => {
+        const to = new Date();
+        const from = new Date(to.getTime() - rangeDays * 24 * 60 * 60 * 1000);
+        return { fromIso: from.toISOString(), toIso: to.toISOString() };
+    }, [rangeDays]);
+    const refresh = useCallback(async () => {
+        setLoading(true);
+        setError(null);
+        try {
+            const qs = `?from=${encodeURIComponent(window.fromIso)}&to=${encodeURIComponent(window.toIso)}`;
+            const res = await apiClient.get(`/api/v1/admin/analytics/summary${qs}`);
+            setSummary(res.data);
+        }
+        catch (err) {
+            setError(err instanceof ApiError ? err.envelope.error.message : t('error.load'));
+        }
+        finally {
+            setLoading(false);
+        }
+    }, [window.fromIso, window.toIso, t]);
+    useEffect(() => {
+        void refresh();
+    }, [refresh]);
+    const dailyByDay = useMemo(() => groupDailyByDay(summary?.daily ?? []), [summary]);
+    const allTypes = useMemo(() => Array.from(new Set((summary?.daily ?? []).map((d) => d.type))).sort(), [summary]);
+    return (_jsxs(_Fragment, { children: [_jsx(PageHeader, { title: t('page.title'), description: _jsxs(_Fragment, { children: [t('page.descriptionPrefix'), " ", formatDateTime(window.fromIso), " \u2013", ' ', formatDateTime(window.toIso), "."] }), actions: _jsxs(_Fragment, { children: [_jsx(Select, { className: "w-auto", value: rangeDays, onChange: (e) => setRangeDays(Number(e.target.value)), children: RANGE_OPTIONS.map((opt) => (_jsx("option", { value: opt.value, children: opt.label }, opt.value))) }), _jsxs(Button, { variant: "outline", size: "sm", onClick: () => {
+                                void refresh();
+                            }, children: [_jsx(RefreshCw, {}), t('refresh')] })] }) }), error ? (_jsx(Alert, { variant: "destructive", className: "mb-4", children: _jsx(AlertDescription, { children: error }) })) : null, _jsxs(Card, { className: "mb-4", children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: t('totals.title') }) }), _jsx(CardContent, { children: loading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('loading') })) : !summary || summary.totalsByType.length === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('empty') })) : (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('column.eventType') }), _jsx(TableHead, { className: "text-right", children: t('column.count') })] }) }), _jsx(TableBody, { children: summary.totalsByType.map((row) => (_jsxs(TableRow, { children: [_jsx(TableCell, { className: "font-mono text-xs", children: row.type }), _jsx(TableCell, { className: "text-right", children: row.count.toLocaleString() })] }, row.type))) })] })) })] }), _jsxs(Card, { children: [_jsx(CardHeader, { children: _jsx(CardTitle, { children: t('daily.title') }) }), _jsx(CardContent, { children: loading ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('loading') })) : dailyByDay.size === 0 ? (_jsx("p", { className: "text-sm text-muted-foreground", children: t('empty') })) : (_jsxs(Table, { children: [_jsx(TableHeader, { children: _jsxs(TableRow, { children: [_jsx(TableHead, { children: t('column.day') }), allTypes.map((type) => (_jsx(TableHead, { className: "text-right font-mono text-xs", children: type }, type)))] }) }), _jsx(TableBody, { children: Array.from(dailyByDay.entries()).map(([day, counts]) => (_jsxs(TableRow, { children: [_jsx(TableCell, { children: day }), allTypes.map((type) => (_jsx(TableCell, { className: "text-right", children: (counts[type] ?? 0).toLocaleString() }, type)))] }, day))) })] })) })] })] }));
+}
+function groupDailyByDay(rows) {
+    const out = new Map();
+    for (const row of rows) {
+        const bucket = out.get(row.day) ?? {};
+        bucket[row.type] = row.count;
+        out.set(row.day, bucket);
+    }
+    return out;
+}
+//# sourceMappingURL=AnalyticsPage.js.map

package/dist/admin/pages/AnalyticsPage.js.map

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

package/dist/backend/entities/analytics-event.entity.d.ts

@@ -0,0 +1,30 @@
+import { OptionalProps } from '@mikro-orm/core';
+/**
+ * AnalyticsEvent (T237 / FR-110).
+ *
+ * Append-only event log. Storefront and admin POST batches into
+ * `/api/v1/analytics/events`; the admin dashboard reads aggregated
+ * counts from this table. The optional GA4 forwarder consumes the same
+ * stream when the feature flag is on.
+ *
+ * Indexes:
+ *   - `(occurred_at)`         — time-range queries dominate the dashboard
+ *   - `(type, occurred_at)`   — per-type time series
+ *   - `(sales_channel_id)`    — per-channel breakdowns
+ */
+export declare class AnalyticsEvent {
+    [OptionalProps]?: 'id' | 'occurredAt' | 'recordedAt' | 'salesChannelId' | 'customerAccountId' | 'organizationId' | 'sessionId' | 'properties' | 'requestId';
+    id: string;
+    type: string;
+    /** Storefront-supplied event timestamp; falls back to server `recordedAt`. */
+    occurredAt: Date;
+    recordedAt: Date;
+    salesChannelId?: string | null;
+    customerAccountId?: string | null;
+    organizationId?: string | null;
+    sessionId?: string | null;
+    properties?: Record<string, unknown> | null;
+    /** Mirror of the X-Request-Id header for cross-log correlation. */
+    requestId?: string | null;
+}
+//# sourceMappingURL=analytics-event.entity.d.ts.map

package/dist/backend/entities/analytics-event.entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-event.entity.d.ts","sourceRoot":"","sources":["../../../src/backend/entities/analytics-event.entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,aAAa,EAAwB,MAAM,iBAAiB,CAAC;AAIrF;;;;;;;;;;;;GAYG;AACH,qBAGa,cAAc;IACzB,CAAC,aAAa,CAAC,CAAC,EACZ,IAAI,GACJ,YAAY,GACZ,YAAY,GACZ,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,WAAW,GACX,YAAY,GACZ,WAAW,CAAC;IAGhB,EAAE,EAAE,MAAM,CAAgB;IAG1B,IAAI,EAAG,MAAM,CAAC;IAEd,8EAA8E;IAG9E,UAAU,EAAE,IAAI,CAAc;IAG9B,UAAU,EAAE,IAAI,CAAc;IAI9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG/B,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAGlC,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAG1B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAE5C,mEAAmE;IAEnE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B"}

package/dist/backend/entities/analytics-event.entity.js

@@ -0,0 +1,89 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { Entity, Index, OptionalProps, PrimaryKey, Property } from '@mikro-orm/core';
+import { OrgScoped } from '@endora-commerce/platform/tenancy';
+import { randomUUID } from 'crypto';
+/**
+ * AnalyticsEvent (T237 / FR-110).
+ *
+ * Append-only event log. Storefront and admin POST batches into
+ * `/api/v1/analytics/events`; the admin dashboard reads aggregated
+ * counts from this table. The optional GA4 forwarder consumes the same
+ * stream when the feature flag is on.
+ *
+ * Indexes:
+ *   - `(occurred_at)`         — time-range queries dominate the dashboard
+ *   - `(type, occurred_at)`   — per-type time series
+ *   - `(sales_channel_id)`    — per-channel breakdowns
+ */
+let AnalyticsEvent = class AnalyticsEvent {
+    [OptionalProps];
+    id = randomUUID();
+    type;
+    /** Storefront-supplied event timestamp; falls back to server `recordedAt`. */
+    occurredAt = new Date();
+    recordedAt = new Date();
+    salesChannelId;
+    customerAccountId;
+    organizationId;
+    sessionId;
+    properties;
+    /** Mirror of the X-Request-Id header for cross-log correlation. */
+    requestId;
+};
+__decorate([
+    PrimaryKey({ type: 'uuid' }),
+    __metadata("design:type", String)
+], AnalyticsEvent.prototype, "id", void 0);
+__decorate([
+    Property({ type: 'string', length: 64 }),
+    __metadata("design:type", String)
+], AnalyticsEvent.prototype, "type", void 0);
+__decorate([
+    Property({ type: 'datetime' }),
+    Index(),
+    __metadata("design:type", Date)
+], AnalyticsEvent.prototype, "occurredAt", void 0);
+__decorate([
+    Property({ type: 'datetime', onCreate: () => new Date() }),
+    __metadata("design:type", Date)
+], AnalyticsEvent.prototype, "recordedAt", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    Index(),
+    __metadata("design:type", Object)
+], AnalyticsEvent.prototype, "salesChannelId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    __metadata("design:type", Object)
+], AnalyticsEvent.prototype, "customerAccountId", void 0);
+__decorate([
+    Property({ type: 'uuid', nullable: true }),
+    __metadata("design:type", Object)
+], AnalyticsEvent.prototype, "organizationId", void 0);
+__decorate([
+    Property({ type: 'string', length: 64, nullable: true }),
+    __metadata("design:type", Object)
+], AnalyticsEvent.prototype, "sessionId", void 0);
+__decorate([
+    Property({ type: 'json', nullable: true }),
+    __metadata("design:type", Object)
+], AnalyticsEvent.prototype, "properties", void 0);
+__decorate([
+    Property({ type: 'string', length: 64, nullable: true }),
+    __metadata("design:type", Object)
+], AnalyticsEvent.prototype, "requestId", void 0);
+AnalyticsEvent = __decorate([
+    OrgScoped(),
+    Entity({ tableName: 'analytics_events' }),
+    Index({ name: 'idx_analytics_events_type_occurred_at', properties: ['type', 'occurredAt'] })
+], AnalyticsEvent);
+export { AnalyticsEvent };
+//# sourceMappingURL=analytics-event.entity.js.map

package/dist/backend/entities/analytics-event.entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-event.entity.js","sourceRoot":"","sources":["../../../src/backend/entities/analytics-event.entity.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACrF,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEpC;;;;;;;;;;;;GAYG;AAII,IAAM,cAAc,GAApB,MAAM,cAAc;IACzB,CAAC,aAAa,CAAC,CASC;IAGhB,EAAE,GAAW,UAAU,EAAE,CAAC;IAG1B,IAAI,CAAU;IAEd,8EAA8E;IAG9E,UAAU,GAAS,IAAI,IAAI,EAAE,CAAC;IAG9B,UAAU,GAAS,IAAI,IAAI,EAAE,CAAC;IAI9B,cAAc,CAAiB;IAG/B,iBAAiB,CAAiB;IAGlC,cAAc,CAAiB;IAG/B,SAAS,CAAiB;IAG1B,UAAU,CAAkC;IAE5C,mEAAmE;IAEnE,SAAS,CAAiB;CAC3B,CAAA;AAhCC;IADC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;;0CACH;AAG1B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;;4CAC3B;AAKd;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IAC9B,KAAK,EAAE;8BACI,IAAI;kDAAc;AAG9B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC;8BAC/C,IAAI;kDAAc;AAI9B;IAFC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IAC1C,KAAK,EAAE;;sDACuB;AAG/B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;yDACT;AAGlC;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;sDACZ;AAG/B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDAC/B;AAG1B;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;kDACC;AAI5C;IADC,QAAQ,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;;iDAC/B;AA5Cf,cAAc;IAH1B,SAAS,EAAE;IACX,MAAM,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAE,CAAC;IACzC,KAAK,CAAC,EAAE,IAAI,EAAE,uCAAuC,EAAE,UAAU,EAAE,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC;GAChF,cAAc,CA6C1B"}

package/dist/backend/index.d.ts

@@ -0,0 +1,42 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import type { ModuleContext } from '@endora-commerce/platform/kernel';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+import { AnalyticsIngestService } from './services/analytics-ingest.service.js';
+import { AnalyticsQueryService } from './services/analytics-query.service.js';
+import { type AnalyticsForwarder } from './services/ga4-forwarder.js';
+import { AnalyticsEvent } from './entities/analytics-event.entity.js';
+/**
+ * `analytics` — the first wave-1 module whose conversion is only a conversion
+ * (feature 072, wave 1).
+ *
+ * No defect fell out of it and no other module had to move, which is worth
+ * noting because the two before it both spilled: `auth` pulled `admin_roles`
+ * in, and `currencies` pulled `dictionaries` and `languages`. This one owns its
+ * routes, owns its services, and nothing outside reads its handle — the shape
+ * the remaining sweep is hoping for.
+ *
+ * The GA4 forwarder is registered rather than defaulted inside the factory, so
+ * a test overrides it by re-registering the name instead of by passing an
+ * option through a factory it does not otherwise care about.
+ */
+export interface AnalyticsCradle {
+    readonly emFactory: () => EntityManager;
+    readonly requireAdmin: RequireAdminFactory;
+    readonly analyticsForwarder: AnalyticsForwarder;
+    readonly analyticsIngestService: AnalyticsIngestService;
+    readonly analyticsQueryService: AnalyticsQueryService;
+}
+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 AnalyticsEvent)[];
+//# 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,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAyB,KAAK,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,aAAa,CAAC;IACxC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAAC;IAC3C,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAChD,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB,CAAC;CACvD;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,CAyBvD;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,QAAQ,2BAEpB,CAAC"}

package/dist/backend/index.js

@@ -0,0 +1,39 @@
+import { registerAnalyticsRoutes } from './routes.js';
+import { AnalyticsIngestService } from './services/analytics-ingest.service.js';
+import { AnalyticsQueryService } from './services/analytics-query.service.js';
+import { buildForwarderFromEnv } from './services/ga4-forwarder.js';
+import { AnalyticsEvent } from './entities/analytics-event.entity.js';
+export function registerModule(ctx) {
+    ctx.di.register({
+        analyticsForwarder: ctx.asFunction(() => buildForwarderFromEnv(process.env)).singleton(),
+        analyticsIngestService: ctx
+            .asFunction(({ emFactory, analyticsForwarder }) => new AnalyticsIngestService(emFactory, analyticsForwarder))
+            .singleton(),
+        analyticsQueryService: ctx
+            .asFunction(({ emFactory }) => new AnalyticsQueryService(emFactory))
+            .singleton(),
+    });
+    ctx.routes(async (app) => {
+        const { analyticsIngestService, analyticsQueryService, requireAdmin } = ctx.cradle();
+        await registerAnalyticsRoutes(app, {
+            ingestService: analyticsIngestService,
+            queryService: analyticsQueryService,
+            requireAdmin,
+        });
+    });
+}
+/**
+ * The module's persisted entity classes, on the `./backend` subpath, as one
+ * array and **no named class export** (D-168).
+ *
+ * This is the shape the platform reads when the package is *installed*: the
+ * boot-time loader (`src/packages/package-runtime.ts`, `exported['entities']`)
+ * and the static declaration reader (`scripts/lib/package-declarations.ts`),
+ * which is the third source of `check:module-boundary`'s `table→owner` map and
+ * the package pass of `check-entity-tenant-classification`. A missing array is
+ * answered with `[]` — zero entities registered, no error anywhere.
+ */
+export const entities = [
+    AnalyticsEvent,
+];
+//# 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":"AAGA,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,qBAAqB,EAA2B,MAAM,6BAA6B,CAAC;AAC7F,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AAyBtE,MAAM,UAAU,cAAc,CAAC,GAAkB;IAC/C,GAAG,CAAC,EAAE,CAAC,QAAQ,CAAC;QACd,kBAAkB,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,qBAAqB,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,EAAE;QAExF,sBAAsB,EAAE,GAAG;aACxB,UAAU,CACT,CAAC,EAAE,SAAS,EAAE,kBAAkB,EAAmB,EAAE,EAAE,CACrD,IAAI,sBAAsB,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAC5D;aACA,SAAS,EAAE;QAEd,qBAAqB,EAAE,GAAG;aACvB,UAAU,CAAC,CAAC,EAAE,SAAS,EAAmB,EAAE,EAAE,CAAC,IAAI,qBAAqB,CAAC,SAAS,CAAC,CAAC;aACpF,SAAS,EAAE;KACf,CAAC,CAAC;IAEH,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACvB,MAAM,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,YAAY,EAAE,GACnE,GAAG,CAAC,MAAM,EAAmB,CAAC;QAChC,MAAM,uBAAuB,CAAC,GAAG,EAAE;YACjC,aAAa,EAAE,sBAAsB;YACrC,YAAY,EAAE,qBAAqB;YACnC,YAAY;SACb,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,cAAc;CACf,CAAC"}

package/dist/backend/plugin.d.ts

@@ -0,0 +1,24 @@
+import type { FastifyInstance } from 'fastify';
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { AnalyticsIngestService } from './services/analytics-ingest.service.js';
+import { AnalyticsQueryService } from './services/analytics-query.service.js';
+import { type AnalyticsForwarder } from './services/ga4-forwarder.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export interface AnalyticsModuleOptions {
+    emFactory: () => EntityManager;
+    requireAdmin: RequireAdminFactory;
+    /** Override for tests; defaults to the env-driven build. */
+    forwarder?: AnalyticsForwarder;
+    /** Override for tests; defaults to `process.env`. */
+    env?: NodeJS.ProcessEnv;
+}
+export interface AnalyticsModuleHandle {
+    ingestService: AnalyticsIngestService;
+    queryService: AnalyticsQueryService;
+    forwarder: AnalyticsForwarder;
+}
+export declare function analyticsModule(options: AnalyticsModuleOptions): {
+    plugin: (app: FastifyInstance) => Promise<void>;
+    handle: AnalyticsModuleHandle;
+};
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/backend/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,YAAY,EAAE,mBAAmB,CAAC;IAClC,4DAA4D;IAC5D,SAAS,CAAC,EAAE,kBAAkB,CAAC;IAC/B,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,sBAAsB,CAAC;IACtC,YAAY,EAAE,qBAAqB,CAAC;IACpC,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,MAAM,EAAE,CAAC,GAAG,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,EAAE,qBAAqB,CAAC;CAC/B,CAgBA"}

package/dist/backend/plugin.js

@@ -0,0 +1,20 @@
+import { AnalyticsIngestService } from './services/analytics-ingest.service.js';
+import { AnalyticsQueryService } from './services/analytics-query.service.js';
+import { buildForwarderFromEnv, } from './services/ga4-forwarder.js';
+import { registerAnalyticsRoutes } from './routes.js';
+export function analyticsModule(options) {
+    const forwarder = options.forwarder ?? buildForwarderFromEnv(options.env ?? process.env);
+    const ingestService = new AnalyticsIngestService(options.emFactory, forwarder);
+    const queryService = new AnalyticsQueryService(options.emFactory);
+    return {
+        handle: { ingestService, queryService, forwarder },
+        plugin: async (app) => {
+            await registerAnalyticsRoutes(app, {
+                ingestService,
+                queryService,
+                requireAdmin: options.requireAdmin,
+            });
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/backend/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/backend/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AAChF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EACL,qBAAqB,GAEtB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAkBtD,MAAM,UAAU,eAAe,CAAC,OAA+B;IAI7D,MAAM,SAAS,GACb,OAAO,CAAC,SAAS,IAAI,qBAAqB,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACzE,MAAM,aAAa,GAAG,IAAI,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAC/E,MAAM,YAAY,GAAG,IAAI,qBAAqB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAElE,OAAO;QACL,MAAM,EAAE,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE;QAClD,MAAM,EAAE,KAAK,EAAE,GAAoB,EAAE,EAAE;YACrC,MAAM,uBAAuB,CAAC,GAAG,EAAE;gBACjC,aAAa;gBACb,YAAY;gBACZ,YAAY,EAAE,OAAO,CAAC,YAAY;aACnC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/backend/routes.d.ts

@@ -0,0 +1,11 @@
+import type { FastifyInstance } from 'fastify';
+import type { AnalyticsIngestService } from './services/analytics-ingest.service.js';
+import type { AnalyticsQueryService } from './services/analytics-query.service.js';
+import type { RequireAdminFactory } from '@endora-commerce/platform/kernel';
+export interface AnalyticsRoutesDeps {
+    ingestService: AnalyticsIngestService;
+    queryService: AnalyticsQueryService;
+    requireAdmin: RequireAdminFactory;
+}
+export declare function registerAnalyticsRoutes(app: FastifyInstance, deps: AnalyticsRoutesDeps): Promise<void>;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,wCAAwC,CAAC;AACrF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AACnF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kCAAkC,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,sBAAsB,CAAC;IACtC,YAAY,EAAE,qBAAqB,CAAC;IACpC,YAAY,EAAE,mBAAmB,CAAC;CACnC;AAED,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,eAAe,EACpB,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6Bf"}

package/dist/backend/routes.js

@@ -0,0 +1,22 @@
+import { analyticsSummaryQuerySchema, ingestAnalyticsBatchRequestSchema, } from '@endora-commerce/contracts';
+export async function registerAnalyticsRoutes(app, deps) {
+    const { ingestService, queryService, requireAdmin } = deps;
+    // Public ingest — accepts batches from storefront + admin. No auth gate by
+    // design (FR-110): we want anonymous browsing events, and the rate limiter
+    // already protects against floods.
+    app.post('/api/v1/analytics/events', { schema: { body: ingestAnalyticsBatchRequestSchema } }, async (request, reply) => {
+        const body = ingestAnalyticsBatchRequestSchema.parse(request.body);
+        const result = await ingestService.ingest({
+            events: body.events,
+            requestId: request.id,
+        });
+        reply.status(202);
+        return { data: result };
+    });
+    app.get('/api/v1/admin/analytics/summary', { preHandler: requireAdmin('analytics:read') }, async (request) => {
+        const query = analyticsSummaryQuerySchema.parse(request.query);
+        const summary = await queryService.summary(query);
+        return { data: summary };
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/backend/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../src/backend/routes.ts"],"names":[],"mappings":"AACA,OAAO,EACL,2BAA2B,EAC3B,iCAAiC,GAClC,MAAM,4BAA4B,CAAC;AAWpC,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,GAAoB,EACpB,IAAyB;IAEzB,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,GAAG,IAAI,CAAC;IAE3D,2EAA2E;IAC3E,2EAA2E;IAC3E,mCAAmC;IACnC,GAAG,CAAC,IAAI,CACN,0BAA0B,EAC1B,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,iCAAiC,EAAE,EAAE,EACvD,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE;QACvB,MAAM,IAAI,GAAG,iCAAiC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC;YACxC,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,SAAS,EAAE,OAAO,CAAC,EAAE;SACtB,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC,CACF,CAAC;IAEF,GAAG,CAAC,GAAG,CACL,iCAAiC,EACjC,EAAE,UAAU,EAAE,YAAY,CAAC,gBAAgB,CAAC,EAAE,EAC9C,KAAK,EAAE,OAAO,EAAE,EAAE;QAChB,MAAM,KAAK,GAAG,2BAA2B,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC/D,MAAM,OAAO,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IAC3B,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/backend/services/analytics-ingest.service.d.ts

@@ -0,0 +1,27 @@
+import type { EntityManager } from '@mikro-orm/postgresql';
+import { type IngestAnalyticsEvent } from '@endora-commerce/contracts';
+import type { AnalyticsForwarder } from './ga4-forwarder.js';
+/**
+ * AnalyticsIngestService (T237 / FR-110).
+ *
+ * Validates each event in the batch independently — a single bad row should
+ * not reject the whole batch. Persisted rows are also handed to the optional
+ * GA4 forwarder; the forwarder is best-effort and never blocks ingest.
+ */
+export interface IngestResult {
+    accepted: number;
+    rejected: Array<{
+        index: number;
+        reason: string;
+    }>;
+}
+export declare class AnalyticsIngestService {
+    private readonly emFactory;
+    private readonly forwarder?;
+    constructor(emFactory: () => EntityManager, forwarder?: AnalyticsForwarder | undefined);
+    ingest(input: {
+        events: IngestAnalyticsEvent[];
+        requestId?: string;
+    }): Promise<IngestResult>;
+}
+//# sourceMappingURL=analytics-ingest.service.d.ts.map

package/dist/backend/services/analytics-ingest.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analytics-ingest.service.d.ts","sourceRoot":"","sources":["../../../src/backend/services/analytics-ingest.service.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEnG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACpD;AAED,qBAAa,sBAAsB;IAE/B,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC;gBADV,SAAS,EAAE,MAAM,aAAa,EAC9B,SAAS,CAAC,EAAE,kBAAkB,YAAA;IAG3C,MAAM,CAAC,KAAK,EAAE;QAClB,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,GAAG,OAAO,CAAC,YAAY,CAAC;CAqC1B"}