@astralibx/email-ui 2.0.0

package/README.md

@@ -0,0 +1,181 @@
+# @astralibx/email-ui
+
+Lit Web Components for email infrastructure admin UIs. Drop-in components for managing email accounts, automation rules, templates, and analytics -- built on native Custom Elements that work in any framework.
+
+Part of the [@astralibx](https://github.com/astralibx) email ecosystem:
+- `@astralibx/email-account-manager` -- account CRUD, health, warmup, SMTP, approval queues
+- `@astralibx/email-rule-engine` -- templates, rules, throttling, runner
+- `@astralibx/email-analytics` -- event recording, aggregation, time-series
+
+## Install
+
+```bash
+npm install @astralibx/email-ui
+```
+
+Peer dependency: `lit ^3.0.0` (included automatically).
+
+## Quick Start
+
+```typescript
+import { AlxConfig } from '@astralibx/email-ui';
+
+// One-time setup at app bootstrap
+AlxConfig.setup({
+  accountManagerApi: '/api/email-accounts',
+  ruleEngineApi: '/api/email-rules',
+  analyticsApi: '/api/analytics',
+  authToken: 'Bearer your-token',
+  theme: 'dark',
+});
+```
+
+```html
+<!-- Drop components anywhere in your HTML -->
+<alx-account-list></alx-account-list>
+<alx-analytics-overview date-from="2025-01-01" date-to="2025-01-31"></alx-analytics-overview>
+```
+
+## Framework Integration
+
+### Angular
+
+```typescript
+import { CUSTOM_ELEMENTS_SCHEMA, Component } from '@angular/core';
+import { AlxConfig } from '@astralibx/email-ui';
+
+AlxConfig.setup({ accountManagerApi: '/api/email-accounts', authToken: token, theme: 'dark' });
+
+@Component({
+  standalone: true,
+  schemas: [CUSTOM_ELEMENTS_SCHEMA],
+  template: `<alx-account-list (alx-account-selected)="onSelect($event)"></alx-account-list>`,
+})
+export class EmailAccountsComponent {
+  onSelect(event: CustomEvent) {
+    console.log('Selected account:', event.detail);
+  }
+}
+```
+
+### React / Next.js
+
+```tsx
+import { AlxConfig } from '@astralibx/email-ui';
+import { useEffect, useRef } from 'react';
+
+AlxConfig.setup({ accountManagerApi: '/api/email-accounts', authToken: token, theme: 'dark' });
+
+export default function EmailAccounts() {
+  const listRef = useRef<HTMLElement>(null);
+
+  useEffect(() => {
+    listRef.current?.addEventListener('alx-account-selected', (e: Event) => {
+      console.log('Selected:', (e as CustomEvent).detail);
+    });
+  }, []);
+
+  return <alx-account-list ref={listRef} />;
+}
+```
+
+### Plain HTML
+
+```html
+<script type="module">
+  import { AlxConfig } from 'https://cdn.example.com/@astralibx/email-ui/dist/index.js';
+
+  AlxConfig.setup({
+    accountManagerApi: 'https://api.example.com/email-accounts',
+    ruleEngineApi: 'https://api.example.com/email-rules',
+    analyticsApi: 'https://api.example.com/analytics',
+    authToken: 'Bearer your-token',
+    theme: 'dark',
+  });
+</script>
+
+<alx-account-list></alx-account-list>
+```
+
+## Components
+
+### Account Management (9)
+
+| Tag | Description |
+|-----|-------------|
+| `<alx-account-list>` | Paginated table with status, health, capacity, warmup indicators |
+| `<alx-account-form>` | Create/edit form with SMTP + IMAP config, provider selection |
+| `<alx-account-health>` | Health dashboard with scores, bounce rates, error trends |
+| `<alx-account-warmup>` | Warmup progress, day tracking, phase schedule |
+| `<alx-account-capacity>` | Aggregate + per-account daily limits and usage bars |
+| `<alx-smtp-tester>` | One-click SMTP connection test with result display |
+| `<alx-bounce-status>` | IMAP bounce check status, single or multi-account view |
+| `<alx-approval-queue>` | Pending drafts with approve/reject/bulk actions |
+| `<alx-global-settings>` | Timezone, dev mode, IMAP, approval, queue tuning |
+
+### Rule Engine (7)
+
+| Tag | Description |
+|-----|-------------|
+| `<alx-template-list>` | Template table with category/audience/platform filters |
+| `<alx-template-editor>` | MJML + Handlebars editor with live preview |
+| `<alx-rule-list>` | Rules with active toggle, stats, dry-run button |
+| `<alx-rule-editor>` | Condition builder, behavior config, template selection |
+| `<alx-run-history>` | Execution logs with expandable per-rule breakdown |
+| `<alx-throttle-settings>` | Global throttle limits (per-user daily/weekly, gap) |
+| `<alx-guide-panel>` | Collapsible built-in documentation panel |
+
+### Analytics (5)
+
+| Tag | Description |
+|-----|-------------|
+| `<alx-analytics-overview>` | Metric cards: sent, delivered, failed, bounced, opened, clicked |
+| `<alx-analytics-timeline>` | Bar chart of send volume (daily/weekly/monthly) |
+| `<alx-analytics-accounts>` | Sortable per-account performance table |
+| `<alx-analytics-rules>` | Sortable per-rule stats with error rates |
+| `<alx-analytics-engagement>` | Open/click/unsubscribe rates (SES tracking note) |
+
+## API-Only Usage
+
+Use the typed API clients without any UI components:
+
+```typescript
+import { AccountAPI, RuleAPI, AnalyticsAPI } from '@astralibx/email-ui/api';
+
+const accounts = new AccountAPI('/api/email-accounts');
+const list = await accounts.list({ page: 1, limit: 20 });
+```
+
+## Theming
+
+Override CSS custom properties on any component or a parent element:
+
+```css
+alx-account-list {
+  --alx-primary: #d4af37;
+  --alx-bg: #111;
+  --alx-surface: #1a1a1a;
+  --alx-border: #333;
+  --alx-text: #ccc;
+  --alx-text-muted: #888;
+  --alx-radius: 6px;
+  --alx-font-family: 'Inter', sans-serif;
+}
+```
+
+Built-in themes: `alxDarkTheme` and `alxLightTheme` are available as Lit CSS exports.
+
+## Documentation
+
+- [Configuration](docs/configuration.md) -- AlxConfig setup, auth tokens, all options
+- [Theming](docs/theming.md) -- CSS custom properties, dark/light themes, customization
+- [Account Components](docs/account-components.md) -- All 9 account management components
+- [Rule Components](docs/rule-components.md) -- All 7 rule engine components
+- [Analytics Components](docs/analytics-components.md) -- All 5 analytics components
+- [API Client](docs/api-client.md) -- Using AccountAPI, RuleAPI, AnalyticsAPI directly
+- [Framework Integration](docs/framework-integration.md) -- Angular, React, Vue, Next.js, plain HTML
+- [Events](docs/events.md) -- All custom events with names, detail types, examples
+
+## License
+
+MIT

package/dist/api.js

@@ -0,0 +1,9 @@
+import { A, a, H, c, R } from "./index-DSTzwYDP.js";
+export {
+  A as AccountAPI,
+  a as AnalyticsAPI,
+  H as HttpClient,
+  c as HttpClientError,
+  R as RuleAPI
+};
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/index-DSTzwYDP.js

@@ -0,0 +1,255 @@
+const API_KEY_MAP = {
+  accountManager: "accountManagerApi",
+  ruleEngine: "ruleEngineApi",
+  analytics: "analyticsApi"
+};
+const _AlxConfig = class _AlxConfig {
+  static setup(options) {
+    _AlxConfig.instance = { ...options };
+  }
+  static get() {
+    return { ..._AlxConfig.instance };
+  }
+  static getApiUrl(key) {
+    const prop = API_KEY_MAP[key];
+    return _AlxConfig.instance[prop] ?? "";
+  }
+  static getHeaders() {
+    const headers = {
+      "Content-Type": "application/json"
+    };
+    if (_AlxConfig.instance.authToken) {
+      headers["Authorization"] = _AlxConfig.instance.authToken;
+    }
+    return headers;
+  }
+  static setAuthToken(token) {
+    _AlxConfig.instance = { ..._AlxConfig.instance, authToken: token };
+  }
+};
+_AlxConfig.instance = {};
+let AlxConfig = _AlxConfig;
+class HttpClientError extends Error {
+  constructor(message, status, body) {
+    super(message);
+    this.status = status;
+    this.body = body;
+    this.name = "HttpClientError";
+  }
+}
+function buildQueryString(params) {
+  if (!params) return "";
+  const entries = Object.entries(params).filter(
+    ([, v]) => v !== void 0 && v !== null
+  );
+  if (entries.length === 0) return "";
+  const qs = new URLSearchParams();
+  for (const [key, value] of entries) {
+    qs.set(key, String(value));
+  }
+  return "?" + qs.toString();
+}
+async function handleResponse(response) {
+  if (!response.ok) {
+    let body;
+    try {
+      body = await response.json();
+    } catch {
+      body = await response.text().catch(() => null);
+    }
+    throw new HttpClientError(
+      `HTTP ${response.status}: ${response.statusText}`,
+      response.status,
+      body
+    );
+  }
+  if (response.status === 204) return void 0;
+  return response.json();
+}
+class HttpClient {
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  url(path, params) {
+    return this.baseUrl + path + buildQueryString(params);
+  }
+  async get(path, params) {
+    const response = await fetch(this.url(path, params), {
+      method: "GET",
+      headers: AlxConfig.getHeaders()
+    });
+    return handleResponse(response);
+  }
+  async post(path, body) {
+    const response = await fetch(this.url(path), {
+      method: "POST",
+      headers: AlxConfig.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return handleResponse(response);
+  }
+  async put(path, body) {
+    const response = await fetch(this.url(path), {
+      method: "PUT",
+      headers: AlxConfig.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return handleResponse(response);
+  }
+  async patch(path, body) {
+    const response = await fetch(this.url(path), {
+      method: "PATCH",
+      headers: AlxConfig.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return handleResponse(response);
+  }
+  async delete(path) {
+    const response = await fetch(this.url(path), {
+      method: "DELETE",
+      headers: AlxConfig.getHeaders()
+    });
+    return handleResponse(response);
+  }
+}
+class AccountAPI {
+  constructor(baseUrl) {
+    this.http = new HttpClient(baseUrl ?? AlxConfig.getApiUrl("accountManager"));
+  }
+  list(params) {
+    return this.http.get("/accounts", params);
+  }
+  getById(id) {
+    return this.http.get(`/accounts/${id}`);
+  }
+  create(data) {
+    return this.http.post("/accounts", data);
+  }
+  update(id, data) {
+    return this.http.put(`/accounts/${id}`, data);
+  }
+  remove(id) {
+    return this.http.delete(`/accounts/${id}`);
+  }
+  testConnection(id) {
+    return this.http.post(`/accounts/${id}/test`);
+  }
+  getHealth(id) {
+    return this.http.get(`/accounts/${id}/health`);
+  }
+  getAllHealth() {
+    return this.http.get("/accounts/health");
+  }
+  getCapacity() {
+    return this.http.get("/accounts/capacity");
+  }
+  getWarmupStatus(id) {
+    return this.http.get(`/accounts/${id}/warmup`);
+  }
+  startWarmup(id) {
+    return this.http.post(`/accounts/${id}/warmup/start`);
+  }
+  getSettings() {
+    return this.http.get("/settings");
+  }
+  updateSettings(data) {
+    return this.http.patch("/settings", data);
+  }
+  listIdentifiers(params) {
+    return this.http.get("/identifiers", params);
+  }
+  listDrafts(params) {
+    return this.http.get("/drafts", params);
+  }
+  approveDraft(id) {
+    return this.http.post(`/drafts/${id}/approve`);
+  }
+  rejectDraft(id) {
+    return this.http.post(`/drafts/${id}/reject`);
+  }
+  bulkApprove(ids) {
+    return this.http.post("/drafts/bulk-approve", { ids });
+  }
+}
+class RuleAPI {
+  constructor(baseUrl) {
+    this.http = new HttpClient(baseUrl ?? AlxConfig.getApiUrl("ruleEngine"));
+  }
+  listTemplates(params) {
+    return this.http.get("/templates", params);
+  }
+  createTemplate(data) {
+    return this.http.post("/templates", data);
+  }
+  updateTemplate(id, data) {
+    return this.http.put(`/templates/${id}`, data);
+  }
+  deleteTemplate(id) {
+    return this.http.delete(`/templates/${id}`);
+  }
+  previewTemplate(data) {
+    return this.http.post("/templates/preview", data);
+  }
+  listRules(params) {
+    return this.http.get("/rules", params);
+  }
+  createRule(data) {
+    return this.http.post("/rules", data);
+  }
+  updateRule(id, data) {
+    return this.http.put(`/rules/${id}`, data);
+  }
+  deleteRule(id) {
+    return this.http.delete(`/rules/${id}`);
+  }
+  toggleRule(id) {
+    return this.http.post(`/rules/${id}/toggle`);
+  }
+  dryRun(id) {
+    return this.http.post(`/rules/${id}/dry-run`);
+  }
+  triggerRun() {
+    return this.http.post("/runner");
+  }
+  getRunHistory(params) {
+    return this.http.get("/runner/logs", params);
+  }
+  getThrottleSettings() {
+    return this.http.get("/throttle");
+  }
+  updateThrottleSettings(data) {
+    return this.http.put("/throttle", data);
+  }
+}
+class AnalyticsAPI {
+  constructor(baseUrl) {
+    this.http = new HttpClient(baseUrl ?? AlxConfig.getApiUrl("analytics"));
+  }
+  getOverview(params) {
+    return this.http.get("/overview", params);
+  }
+  getTimeline(params) {
+    return this.http.get("/timeline", params);
+  }
+  getAccountStats(params) {
+    return this.http.get("/accounts", params);
+  }
+  getRuleStats(params) {
+    return this.http.get("/rules", params);
+  }
+  getTemplateStats(params) {
+    return this.http.get("/templates", params);
+  }
+  triggerAggregation(data) {
+    return this.http.post("/aggregate", data);
+  }
+}
+export {
+  AccountAPI as A,
+  HttpClient as H,
+  RuleAPI as R,
+  AnalyticsAPI as a,
+  AlxConfig as b,
+  HttpClientError as c
+};
+//# sourceMappingURL=index-DSTzwYDP.js.map

package/dist/index-DSTzwYDP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-DSTzwYDP.js","sources":["../src/config.ts","../src/api/http-client.ts","../src/api/account.api.ts","../src/api/rule.api.ts","../src/api/analytics.api.ts"],"sourcesContent":["export interface AlxConfigOptions {\n  accountManagerApi?: string;\n  ruleEngineApi?: string;\n  analyticsApi?: string;\n  authToken?: string;\n  theme?: 'dark' | 'light';\n  locale?: string;\n}\n\nconst API_KEY_MAP = {\n  accountManager: 'accountManagerApi',\n  ruleEngine: 'ruleEngineApi',\n  analytics: 'analyticsApi',\n} as const;\n\n/**\n * Global configuration singleton for @astralibx/email-ui.\n *\n * Call `AlxConfig.setup()` once at application startup to configure\n * API base URLs, auth tokens, and theme preferences.\n *\n * @example\n * ```typescript\n * AlxConfig.setup({\n *   accountManagerApi: '/api/email-accounts',\n *   ruleEngineApi: '/api/email-rules',\n *   analyticsApi: '/api/analytics',\n *   authToken: 'Bearer xxx',\n *   theme: 'dark',\n * });\n * ```\n */\nexport class AlxConfig {\n  private static instance: AlxConfigOptions = {};\n\n  static setup(options: AlxConfigOptions): void {\n    AlxConfig.instance = { ...options };\n  }\n\n  static get(): AlxConfigOptions {\n    return { ...AlxConfig.instance };\n  }\n\n  static getApiUrl(key: 'accountManager' | 'ruleEngine' | 'analytics'): string {\n    const prop = API_KEY_MAP[key];\n    return AlxConfig.instance[prop] ?? '';\n  }\n\n  static getHeaders(): Record<string, string> {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n    if (AlxConfig.instance.authToken) {\n      headers['Authorization'] = AlxConfig.instance.authToken;\n    }\n    return headers;\n  }\n\n  static setAuthToken(token: string): void {\n    AlxConfig.instance = { ...AlxConfig.instance, authToken: token };\n  }\n}\n","import { AlxConfig } from '../config.js';\n\nexport interface PaginationParams {\n  page?: number;\n  limit?: number;\n}\n\nexport interface ApiResponse<T> {\n  data: T;\n  status: number;\n}\n\nexport interface PaginatedResponse<T> {\n  data: T[];\n  total: number;\n  page: number;\n  limit: number;\n  totalPages: number;\n}\n\nexport class HttpClientError extends Error {\n  constructor(\n    message: string,\n    public readonly status: number,\n    public readonly body?: unknown,\n  ) {\n    super(message);\n    this.name = 'HttpClientError';\n  }\n}\n\nfunction buildQueryString(params?: Record<string, unknown>): string {\n  if (!params) return '';\n  const entries = Object.entries(params).filter(\n    ([, v]) => v !== undefined && v !== null,\n  );\n  if (entries.length === 0) return '';\n  const qs = new URLSearchParams();\n  for (const [key, value] of entries) {\n    qs.set(key, String(value));\n  }\n  return '?' + qs.toString();\n}\n\nasync function handleResponse<T>(response: Response): Promise<T> {\n  if (!response.ok) {\n    let body: unknown;\n    try {\n      body = await response.json();\n    } catch {\n      body = await response.text().catch(() => null);\n    }\n    throw new HttpClientError(\n      `HTTP ${response.status}: ${response.statusText}`,\n      response.status,\n      body,\n    );\n  }\n  if (response.status === 204) return undefined as T;\n  return response.json() as Promise<T>;\n}\n\nexport class HttpClient {\n  constructor(private baseUrl: string) {}\n\n  private url(path: string, params?: Record<string, unknown>): string {\n    return this.baseUrl + path + buildQueryString(params);\n  }\n\n  async get<T>(path: string, params?: Record<string, unknown>): Promise<T> {\n    const response = await fetch(this.url(path, params), {\n      method: 'GET',\n      headers: AlxConfig.getHeaders(),\n    });\n    return handleResponse<T>(response);\n  }\n\n  async post<T>(path: string, body?: unknown): Promise<T> {\n    const response = await fetch(this.url(path), {\n      method: 'POST',\n      headers: AlxConfig.getHeaders(),\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return handleResponse<T>(response);\n  }\n\n  async put<T>(path: string, body?: unknown): Promise<T> {\n    const response = await fetch(this.url(path), {\n      method: 'PUT',\n      headers: AlxConfig.getHeaders(),\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return handleResponse<T>(response);\n  }\n\n  async patch<T>(path: string, body?: unknown): Promise<T> {\n    const response = await fetch(this.url(path), {\n      method: 'PATCH',\n      headers: AlxConfig.getHeaders(),\n      body: body !== undefined ? JSON.stringify(body) : undefined,\n    });\n    return handleResponse<T>(response);\n  }\n\n  async delete<T>(path: string): Promise<T> {\n    const response = await fetch(this.url(path), {\n      method: 'DELETE',\n      headers: AlxConfig.getHeaders(),\n    });\n    return handleResponse<T>(response);\n  }\n}\n","import { AlxConfig } from '../config.js';\nimport { HttpClient, type PaginationParams } from './http-client.js';\n\n/**\n * API client for the @astralibx/email-account-manager backend.\n *\n * @example\n * ```typescript\n * const api = new AccountAPI();\n * const accounts = await api.list({ page: 1, limit: 20 });\n * ```\n */\nexport class AccountAPI {\n  private http: HttpClient;\n\n  constructor(baseUrl?: string) {\n    this.http = new HttpClient(baseUrl ?? AlxConfig.getApiUrl('accountManager'));\n  }\n\n  list(params?: PaginationParams & Record<string, unknown>): Promise<any> {\n    return this.http.get('/accounts', params);\n  }\n\n  getById(id: string): Promise<any> {\n    return this.http.get(`/accounts/${id}`);\n  }\n\n  create(data: Record<string, unknown>): Promise<any> {\n    return this.http.post('/accounts', data);\n  }\n\n  update(id: string, data: Record<string, unknown>): Promise<any> {\n    return this.http.put(`/accounts/${id}`, data);\n  }\n\n  remove(id: string): Promise<any> {\n    return this.http.delete(`/accounts/${id}`);\n  }\n\n  testConnection(id: string): Promise<any> {\n    return this.http.post(`/accounts/${id}/test`);\n  }\n\n  getHealth(id: string): Promise<any> {\n    return this.http.get(`/accounts/${id}/health`);\n  }\n\n  getAllHealth(): Promise<any> {\n    return this.http.get('/accounts/health');\n  }\n\n  getCapacity(): Promise<any> {\n    return this.http.get('/accounts/capacity');\n  }\n\n  getWarmupStatus(id: string): Promise<any> {\n    return this.http.get(`/accounts/${id}/warmup`);\n  }\n\n  startWarmup(id: string): Promise<any> {\n    return this.http.post(`/accounts/${id}/warmup/start`);\n  }\n\n  getSettings(): Promise<any> {\n    return this.http.get('/settings');\n  }\n\n  updateSettings(data: Record<string, unknown>): Promise<any> {\n    return this.http.patch('/settings', data);\n  }\n\n  listIdentifiers(params?: PaginationParams & Record<string, unknown>): Promise<any> {\n    return this.http.get('/identifiers', params);\n  }\n\n  listDrafts(params?: PaginationParams & Record<string, unknown>): Promise<any> {\n    return this.http.get('/drafts', params);\n  }\n\n  approveDraft(id: string): Promise<any> {\n    return this.http.post(`/drafts/${id}/approve`);\n  }\n\n  rejectDraft(id: string): Promise<any> {\n    return this.http.post(`/drafts/${id}/reject`);\n  }\n\n  bulkApprove(ids: string[]): Promise<any> {\n    return this.http.post('/drafts/bulk-approve', { ids });\n  }\n}\n","import { AlxConfig } from '../config.js';\nimport { HttpClient, type PaginationParams } from './http-client.js';\n\n/**\n * API client for the @astralibx/email-rule-engine backend.\n *\n * @example\n * ```typescript\n * const api = new RuleAPI();\n * const templates = await api.listTemplates({ page: 1, limit: 20 });\n * ```\n */\nexport class RuleAPI {\n  private http: HttpClient;\n\n  constructor(baseUrl?: string) {\n    this.http = new HttpClient(baseUrl ?? AlxConfig.getApiUrl('ruleEngine'));\n  }\n\n  listTemplates(params?: PaginationParams & Record<string, unknown>): Promise<any> {\n    return this.http.get('/templates', params);\n  }\n\n  createTemplate(data: Record<string, unknown>): Promise<any> {\n    return this.http.post('/templates', data);\n  }\n\n  updateTemplate(id: string, data: Record<string, unknown>): Promise<any> {\n    return this.http.put(`/templates/${id}`, data);\n  }\n\n  deleteTemplate(id: string): Promise<any> {\n    return this.http.delete(`/templates/${id}`);\n  }\n\n  previewTemplate(data: Record<string, unknown>): Promise<any> {\n    return this.http.post('/templates/preview', data);\n  }\n\n  listRules(params?: PaginationParams & Record<string, unknown>): Promise<any> {\n    return this.http.get('/rules', params);\n  }\n\n  createRule(data: Record<string, unknown>): Promise<any> {\n    return this.http.post('/rules', data);\n  }\n\n  updateRule(id: string, data: Record<string, unknown>): Promise<any> {\n    return this.http.put(`/rules/${id}`, data);\n  }\n\n  deleteRule(id: string): Promise<any> {\n    return this.http.delete(`/rules/${id}`);\n  }\n\n  toggleRule(id: string): Promise<any> {\n    return this.http.post(`/rules/${id}/toggle`);\n  }\n\n  dryRun(id: string): Promise<any> {\n    return this.http.post(`/rules/${id}/dry-run`);\n  }\n\n  triggerRun(): Promise<any> {\n    return this.http.post('/runner');\n  }\n\n  getRunHistory(params?: PaginationParams & Record<string, unknown>): Promise<any> {\n    return this.http.get('/runner/logs', params);\n  }\n\n  getThrottleSettings(): Promise<any> {\n    return this.http.get('/throttle');\n  }\n\n  updateThrottleSettings(data: Record<string, unknown>): Promise<any> {\n    return this.http.put('/throttle', data);\n  }\n}\n","import { AlxConfig } from '../config.js';\nimport { HttpClient } from './http-client.js';\n\n/**\n * API client for the @astralibx/email-analytics backend.\n *\n * @example\n * ```typescript\n * const api = new AnalyticsAPI();\n * const overview = await api.getOverview({ from: '2025-01-01', to: '2025-01-31' });\n * ```\n */\nexport class AnalyticsAPI {\n  private http: HttpClient;\n\n  constructor(baseUrl?: string) {\n    this.http = new HttpClient(baseUrl ?? AlxConfig.getApiUrl('analytics'));\n  }\n\n  getOverview(params?: Record<string, unknown>): Promise<any> {\n    return this.http.get('/overview', params);\n  }\n\n  getTimeline(params?: Record<string, unknown>): Promise<any> {\n    return this.http.get('/timeline', params);\n  }\n\n  getAccountStats(params?: Record<string, unknown>): Promise<any> {\n    return this.http.get('/accounts', params);\n  }\n\n  getRuleStats(params?: Record<string, unknown>): Promise<any> {\n    return this.http.get('/rules', params);\n  }\n\n  getTemplateStats(params?: Record<string, unknown>): Promise<any> {\n    return this.http.get('/templates', params);\n  }\n\n  triggerAggregation(data?: Record<string, unknown>): Promise<any> {\n    return this.http.post('/aggregate', data);\n  }\n}\n"],"names":[],"mappings":"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"}