@litemetrics/client 0.1.0

package/dist/index.cjs

@@ -0,0 +1,241 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  LitemetricsClient: () => LitemetricsClient,
+  SitesClient: () => SitesClient,
+  createClient: () => createClient,
+  createSitesClient: () => createSitesClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_axios = __toESM(require("axios"), 1);
+var LitemetricsClient = class {
+  siteId;
+  endpoint;
+  http;
+  constructor(config) {
+    this.siteId = config.siteId;
+    this.endpoint = config.endpoint ?? "/api/stats";
+    const headers = { ...config.headers };
+    if (config.secretKey) {
+      headers["X-Litemetrics-Secret"] = config.secretKey;
+    }
+    this.http = import_axios.default.create({
+      baseURL: config.baseUrl.replace(/\/$/, ""),
+      headers
+    });
+  }
+  /** Change the active site ID */
+  setSiteId(siteId) {
+    this.siteId = siteId;
+  }
+  /** Get any metric */
+  async getStats(metric, options) {
+    const params = {
+      siteId: this.siteId,
+      metric
+    };
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.filters) params.filters = JSON.stringify(options.filters);
+    if (options?.compare) params.compare = "true";
+    const { data } = await this.http.get(this.endpoint, { params });
+    return data;
+  }
+  // ─── Convenience methods ──────────────────────────────────
+  async getPageviews(options) {
+    return this.getStats("pageviews", options);
+  }
+  async getVisitors(options) {
+    return this.getStats("visitors", options);
+  }
+  async getSessions(options) {
+    return this.getStats("sessions", options);
+  }
+  async getEvents(options) {
+    return this.getStats("events", options);
+  }
+  async getTopPages(options) {
+    return this.getStats("top_pages", options);
+  }
+  async getTopReferrers(options) {
+    return this.getStats("top_referrers", options);
+  }
+  async getTopCountries(options) {
+    return this.getStats("top_countries", options);
+  }
+  async getTopCities(options) {
+    return this.getStats("top_cities", options);
+  }
+  async getTopEvents(options) {
+    return this.getStats("top_events", options);
+  }
+  async getTopDevices(options) {
+    return this.getStats("top_devices", options);
+  }
+  async getTopBrowsers(options) {
+    return this.getStats("top_browsers", options);
+  }
+  async getTopOS(options) {
+    return this.getStats("top_os", options);
+  }
+  /** Fetch multiple metrics in parallel */
+  async getOverview(metrics = ["pageviews", "visitors", "sessions", "events"], options) {
+    const results = await Promise.all(
+      metrics.map((m) => this.getStats(m, options).then((r) => [m, r]))
+    );
+    return Object.fromEntries(results);
+  }
+  // ─── Time series ──────────────────────────────────────
+  async getTimeSeries(metric, options) {
+    const params = {
+      siteId: this.siteId,
+      metric: "timeseries",
+      tsMetric: metric
+    };
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.granularity) params.granularity = options.granularity;
+    const { data } = await this.http.get(this.endpoint, { params });
+    return data;
+  }
+  // ─── Event listing ──────────────────────────────────────
+  async getEventsList(options) {
+    const params = { siteId: this.siteId };
+    if (options?.type) params.type = options.type;
+    if (options?.eventName) params.eventName = options.eventName;
+    if (options?.visitorId) params.visitorId = options.visitorId;
+    if (options?.userId) params.userId = options.userId;
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.offset) params.offset = String(options.offset);
+    const { data } = await this.http.get("/api/events", { params });
+    return data;
+  }
+  // ─── User listing ──────────────────────────────────────
+  async getUsers(options) {
+    const params = { siteId: this.siteId };
+    if (options?.search) params.search = options.search;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.offset) params.offset = String(options.offset);
+    const { data } = await this.http.get("/api/users", { params });
+    return data;
+  }
+  async getUserDetail(visitorId) {
+    const params = { siteId: this.siteId };
+    const { data } = await this.http.get(`/api/users/${encodeURIComponent(visitorId)}`, { params });
+    return data.user;
+  }
+  async getUserEvents(visitorId, options) {
+    const params = { siteId: this.siteId };
+    if (options?.type) params.type = options.type;
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.offset) params.offset = String(options.offset);
+    const { data } = await this.http.get(`/api/users/${encodeURIComponent(visitorId)}/events`, { params });
+    return data;
+  }
+  // ─── Retention ──────────────────────────────────────
+  async getRetention(options) {
+    const params = {
+      siteId: this.siteId,
+      metric: "retention"
+    };
+    if (options?.period) params.period = options.period;
+    if (options?.weeks) params.weeks = String(options.weeks);
+    const { data } = await this.http.get(this.endpoint, { params });
+    return data;
+  }
+};
+function createClient(config) {
+  return new LitemetricsClient(config);
+}
+
+// src/sites.ts
+var import_axios2 = __toESM(require("axios"), 1);
+var SitesClient = class {
+  endpoint;
+  http;
+  constructor(config) {
+    this.endpoint = config.endpoint ?? "/api/sites";
+    this.http = import_axios2.default.create({
+      baseURL: config.baseUrl.replace(/\/$/, ""),
+      headers: {
+        "Content-Type": "application/json",
+        "X-Litemetrics-Admin-Secret": config.adminSecret
+      }
+    });
+  }
+  async listSites() {
+    const { data } = await this.http.get(this.endpoint);
+    return data;
+  }
+  async getSite(siteId) {
+    const { data } = await this.http.get(`${this.endpoint}/${siteId}`);
+    return data;
+  }
+  async createSite(body) {
+    const { data } = await this.http.post(this.endpoint, body);
+    return data;
+  }
+  async updateSite(siteId, body) {
+    const { data } = await this.http.put(`${this.endpoint}/${siteId}`, body);
+    return data;
+  }
+  async deleteSite(siteId) {
+    const { data } = await this.http.delete(`${this.endpoint}/${siteId}`);
+    return data;
+  }
+  async regenerateSecret(siteId) {
+    const { data } = await this.http.post(`${this.endpoint}/${siteId}/regenerate`);
+    return data;
+  }
+};
+function createSitesClient(config) {
+  return new SitesClient(config);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LitemetricsClient,
+  SitesClient,
+  createClient,
+  createSitesClient
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/sites.ts"],"sourcesContent":["export { LitemetricsClient, createClient } from './client';\nexport type { LitemetricsClientConfig, StatsOptions, TimeSeriesOptions, EventsListOptions, UsersListOptions, RetentionOptions } from './client';\n\nexport { SitesClient, createSitesClient } from './sites';\nexport type { SitesClientConfig } from './sites';\n\n// Re-export query types from core\nexport type {\n  Metric,\n  Period,\n  QueryResult,\n  QueryDataPoint,\n  Site,\n  CreateSiteRequest,\n  UpdateSiteRequest,\n  EventType,\n  EventListParams,\n  EventListResult,\n  EventListItem,\n  UserListParams,\n  UserListResult,\n  UserDetail,\n  Granularity,\n  TimeSeriesParams,\n  TimeSeriesResult,\n  TimeSeriesPoint,\n  RetentionParams,\n  RetentionResult,\n  RetentionCohort,\n} from '@litemetrics/core';\n","import axios, { type AxiosInstance } from 'axios';\nimport type { Metric, Period, Granularity, QueryResult, TimeSeriesResult, RetentionResult, EventListResult, UserListResult, UserDetail, EventType } from '@litemetrics/core';\n\nexport interface LitemetricsClientConfig {\n  /** Base URL of the Litemetrics server (e.g. \"https://analytics.myapp.com\") */\n  baseUrl: string;\n  /** Site ID to query */\n  siteId: string;\n  /** Secret key for authentication (sk_xxx) */\n  secretKey?: string;\n  /** Query endpoint path (default: \"/api/stats\") */\n  endpoint?: string;\n  /** Custom headers to include in requests */\n  headers?: Record<string, string>;\n}\n\nexport interface StatsOptions {\n  period?: Period;\n  dateFrom?: string;\n  dateTo?: string;\n  limit?: number;\n  filters?: Record<string, string>;\n  compare?: boolean;\n}\n\nexport interface RetentionOptions {\n  period?: Period;\n  weeks?: number;\n}\n\nexport interface EventsListOptions {\n  type?: EventType;\n  eventName?: string;\n  visitorId?: string;\n  userId?: string;\n  period?: Period;\n  dateFrom?: string;\n  dateTo?: string;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface TimeSeriesOptions {\n  period?: Period;\n  dateFrom?: string;\n  dateTo?: string;\n  granularity?: Granularity;\n}\n\nexport interface UsersListOptions {\n  search?: string;\n  limit?: number;\n  offset?: number;\n}\n\nexport class LitemetricsClient {\n  private siteId: string;\n  private endpoint: string;\n  private http: AxiosInstance;\n\n  constructor(config: LitemetricsClientConfig) {\n    this.siteId = config.siteId;\n    this.endpoint = config.endpoint ?? '/api/stats';\n\n    const headers: Record<string, string> = { ...config.headers };\n    if (config.secretKey) {\n      headers['X-Litemetrics-Secret'] = config.secretKey;\n    }\n\n    this.http = axios.create({\n      baseURL: config.baseUrl.replace(/\\/$/, ''),\n      headers,\n    });\n  }\n\n  /** Change the active site ID */\n  setSiteId(siteId: string): void {\n    this.siteId = siteId;\n  }\n\n  /** Get any metric */\n  async getStats(metric: Metric, options?: StatsOptions): Promise<QueryResult> {\n    const params: Record<string, string> = {\n      siteId: this.siteId,\n      metric,\n    };\n\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.filters) params.filters = JSON.stringify(options.filters);\n    if (options?.compare) params.compare = 'true';\n\n    const { data } = await this.http.get<QueryResult>(this.endpoint, { params });\n    return data;\n  }\n\n  // ─── Convenience methods ──────────────────────────────────\n\n  async getPageviews(options?: StatsOptions) { return this.getStats('pageviews', options); }\n  async getVisitors(options?: StatsOptions) { return this.getStats('visitors', options); }\n  async getSessions(options?: StatsOptions) { return this.getStats('sessions', options); }\n  async getEvents(options?: StatsOptions) { return this.getStats('events', options); }\n  async getTopPages(options?: StatsOptions) { return this.getStats('top_pages', options); }\n  async getTopReferrers(options?: StatsOptions) { return this.getStats('top_referrers', options); }\n  async getTopCountries(options?: StatsOptions) { return this.getStats('top_countries', options); }\n  async getTopCities(options?: StatsOptions) { return this.getStats('top_cities', options); }\n  async getTopEvents(options?: StatsOptions) { return this.getStats('top_events', options); }\n  async getTopDevices(options?: StatsOptions) { return this.getStats('top_devices', options); }\n  async getTopBrowsers(options?: StatsOptions) { return this.getStats('top_browsers', options); }\n  async getTopOS(options?: StatsOptions) { return this.getStats('top_os', options); }\n\n  /** Fetch multiple metrics in parallel */\n  async getOverview(\n    metrics: Metric[] = ['pageviews', 'visitors', 'sessions', 'events'],\n    options?: StatsOptions,\n  ): Promise<Record<Metric, QueryResult>> {\n    const results = await Promise.all(\n      metrics.map((m) => this.getStats(m, options).then((r) => [m, r] as const)),\n    );\n    return Object.fromEntries(results) as Record<Metric, QueryResult>;\n  }\n\n  // ─── Time series ──────────────────────────────────────\n\n  async getTimeSeries(\n    metric: 'pageviews' | 'visitors' | 'sessions',\n    options?: TimeSeriesOptions,\n  ): Promise<TimeSeriesResult> {\n    const params: Record<string, string> = {\n      siteId: this.siteId,\n      metric: 'timeseries',\n      tsMetric: metric,\n    };\n\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.granularity) params.granularity = options.granularity;\n\n    const { data } = await this.http.get<TimeSeriesResult>(this.endpoint, { params });\n    return data;\n  }\n\n  // ─── Event listing ──────────────────────────────────────\n\n  async getEventsList(options?: EventsListOptions): Promise<EventListResult> {\n    const params: Record<string, string> = { siteId: this.siteId };\n\n    if (options?.type) params.type = options.type;\n    if (options?.eventName) params.eventName = options.eventName;\n    if (options?.visitorId) params.visitorId = options.visitorId;\n    if (options?.userId) params.userId = options.userId;\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.offset) params.offset = String(options.offset);\n\n    const { data } = await this.http.get<EventListResult>('/api/events', { params });\n    return data;\n  }\n\n  // ─── User listing ──────────────────────────────────────\n\n  async getUsers(options?: UsersListOptions): Promise<UserListResult> {\n    const params: Record<string, string> = { siteId: this.siteId };\n\n    if (options?.search) params.search = options.search;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.offset) params.offset = String(options.offset);\n\n    const { data } = await this.http.get<UserListResult>('/api/users', { params });\n    return data;\n  }\n\n  async getUserDetail(visitorId: string): Promise<UserDetail> {\n    const params: Record<string, string> = { siteId: this.siteId };\n    const { data } = await this.http.get<{ user: UserDetail }>(`/api/users/${encodeURIComponent(visitorId)}`, { params });\n    return data.user;\n  }\n\n  async getUserEvents(visitorId: string, options?: EventsListOptions): Promise<EventListResult> {\n    const params: Record<string, string> = { siteId: this.siteId };\n\n    if (options?.type) params.type = options.type;\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.offset) params.offset = String(options.offset);\n\n    const { data } = await this.http.get<EventListResult>(`/api/users/${encodeURIComponent(visitorId)}/events`, { params });\n    return data;\n  }\n\n  // ─── Retention ──────────────────────────────────────\n\n  async getRetention(options?: RetentionOptions): Promise<RetentionResult> {\n    const params: Record<string, string> = {\n      siteId: this.siteId,\n      metric: 'retention',\n    };\n\n    if (options?.period) params.period = options.period;\n    if (options?.weeks) params.weeks = String(options.weeks);\n\n    const { data } = await this.http.get<RetentionResult>(this.endpoint, { params });\n    return data;\n  }\n}\n\n/** Create an LitemetricsClient instance */\nexport function createClient(config: LitemetricsClientConfig): LitemetricsClient {\n  return new LitemetricsClient(config);\n}\n","import axios, { type AxiosInstance } from 'axios';\nimport type { Site, CreateSiteRequest, UpdateSiteRequest } from '@litemetrics/core';\n\nexport interface SitesClientConfig {\n  /** Base URL of the Litemetrics server */\n  baseUrl: string;\n  /** Admin secret for authentication */\n  adminSecret: string;\n  /** Sites endpoint path (default: \"/api/sites\") */\n  endpoint?: string;\n}\n\nexport class SitesClient {\n  private endpoint: string;\n  private http: AxiosInstance;\n\n  constructor(config: SitesClientConfig) {\n    this.endpoint = config.endpoint ?? '/api/sites';\n\n    this.http = axios.create({\n      baseURL: config.baseUrl.replace(/\\/$/, ''),\n      headers: {\n        'Content-Type': 'application/json',\n        'X-Litemetrics-Admin-Secret': config.adminSecret,\n      },\n    });\n  }\n\n  async listSites(): Promise<{ sites: Site[]; total: number }> {\n    const { data } = await this.http.get(this.endpoint);\n    return data;\n  }\n\n  async getSite(siteId: string): Promise<{ site: Site }> {\n    const { data } = await this.http.get(`${this.endpoint}/${siteId}`);\n    return data;\n  }\n\n  async createSite(body: CreateSiteRequest): Promise<{ site: Site }> {\n    const { data } = await this.http.post(this.endpoint, body);\n    return data;\n  }\n\n  async updateSite(siteId: string, body: UpdateSiteRequest): Promise<{ site: Site }> {\n    const { data } = await this.http.put(`${this.endpoint}/${siteId}`, body);\n    return data;\n  }\n\n  async deleteSite(siteId: string): Promise<{ ok: boolean }> {\n    const { data } = await this.http.delete(`${this.endpoint}/${siteId}`);\n    return data;\n  }\n\n  async regenerateSecret(siteId: string): Promise<{ site: Site }> {\n    const { data } = await this.http.post(`${this.endpoint}/${siteId}/regenerate`);\n    return data;\n  }\n}\n\nexport function createSitesClient(config: SitesClientConfig): SitesClient {\n  return new SitesClient(config);\n}\n"],"mappings":"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","names":["axios","import_axios","axios"]}

package/dist/index.d.cts

@@ -0,0 +1,117 @@
+import { EventType, Period, Metric, QueryResult, Granularity, TimeSeriesResult, EventListResult, UserListResult, UserDetail, RetentionResult, Site, CreateSiteRequest, UpdateSiteRequest } from '@litemetrics/core';
+export { CreateSiteRequest, EventListItem, EventListParams, EventListResult, EventType, Granularity, Metric, Period, QueryDataPoint, QueryResult, RetentionCohort, RetentionParams, RetentionResult, Site, TimeSeriesParams, TimeSeriesPoint, TimeSeriesResult, UpdateSiteRequest, UserDetail, UserListParams, UserListResult } from '@litemetrics/core';
+
+interface LitemetricsClientConfig {
+    /** Base URL of the Litemetrics server (e.g. "https://analytics.myapp.com") */
+    baseUrl: string;
+    /** Site ID to query */
+    siteId: string;
+    /** Secret key for authentication (sk_xxx) */
+    secretKey?: string;
+    /** Query endpoint path (default: "/api/stats") */
+    endpoint?: string;
+    /** Custom headers to include in requests */
+    headers?: Record<string, string>;
+}
+interface StatsOptions {
+    period?: Period;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    filters?: Record<string, string>;
+    compare?: boolean;
+}
+interface RetentionOptions {
+    period?: Period;
+    weeks?: number;
+}
+interface EventsListOptions {
+    type?: EventType;
+    eventName?: string;
+    visitorId?: string;
+    userId?: string;
+    period?: Period;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    offset?: number;
+}
+interface TimeSeriesOptions {
+    period?: Period;
+    dateFrom?: string;
+    dateTo?: string;
+    granularity?: Granularity;
+}
+interface UsersListOptions {
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+declare class LitemetricsClient {
+    private siteId;
+    private endpoint;
+    private http;
+    constructor(config: LitemetricsClientConfig);
+    /** Change the active site ID */
+    setSiteId(siteId: string): void;
+    /** Get any metric */
+    getStats(metric: Metric, options?: StatsOptions): Promise<QueryResult>;
+    getPageviews(options?: StatsOptions): Promise<QueryResult>;
+    getVisitors(options?: StatsOptions): Promise<QueryResult>;
+    getSessions(options?: StatsOptions): Promise<QueryResult>;
+    getEvents(options?: StatsOptions): Promise<QueryResult>;
+    getTopPages(options?: StatsOptions): Promise<QueryResult>;
+    getTopReferrers(options?: StatsOptions): Promise<QueryResult>;
+    getTopCountries(options?: StatsOptions): Promise<QueryResult>;
+    getTopCities(options?: StatsOptions): Promise<QueryResult>;
+    getTopEvents(options?: StatsOptions): Promise<QueryResult>;
+    getTopDevices(options?: StatsOptions): Promise<QueryResult>;
+    getTopBrowsers(options?: StatsOptions): Promise<QueryResult>;
+    getTopOS(options?: StatsOptions): Promise<QueryResult>;
+    /** Fetch multiple metrics in parallel */
+    getOverview(metrics?: Metric[], options?: StatsOptions): Promise<Record<Metric, QueryResult>>;
+    getTimeSeries(metric: 'pageviews' | 'visitors' | 'sessions', options?: TimeSeriesOptions): Promise<TimeSeriesResult>;
+    getEventsList(options?: EventsListOptions): Promise<EventListResult>;
+    getUsers(options?: UsersListOptions): Promise<UserListResult>;
+    getUserDetail(visitorId: string): Promise<UserDetail>;
+    getUserEvents(visitorId: string, options?: EventsListOptions): Promise<EventListResult>;
+    getRetention(options?: RetentionOptions): Promise<RetentionResult>;
+}
+/** Create an LitemetricsClient instance */
+declare function createClient(config: LitemetricsClientConfig): LitemetricsClient;
+
+interface SitesClientConfig {
+    /** Base URL of the Litemetrics server */
+    baseUrl: string;
+    /** Admin secret for authentication */
+    adminSecret: string;
+    /** Sites endpoint path (default: "/api/sites") */
+    endpoint?: string;
+}
+declare class SitesClient {
+    private endpoint;
+    private http;
+    constructor(config: SitesClientConfig);
+    listSites(): Promise<{
+        sites: Site[];
+        total: number;
+    }>;
+    getSite(siteId: string): Promise<{
+        site: Site;
+    }>;
+    createSite(body: CreateSiteRequest): Promise<{
+        site: Site;
+    }>;
+    updateSite(siteId: string, body: UpdateSiteRequest): Promise<{
+        site: Site;
+    }>;
+    deleteSite(siteId: string): Promise<{
+        ok: boolean;
+    }>;
+    regenerateSecret(siteId: string): Promise<{
+        site: Site;
+    }>;
+}
+declare function createSitesClient(config: SitesClientConfig): SitesClient;
+
+export { type EventsListOptions, LitemetricsClient, type LitemetricsClientConfig, type RetentionOptions, SitesClient, type SitesClientConfig, type StatsOptions, type TimeSeriesOptions, type UsersListOptions, createClient, createSitesClient };

package/dist/index.d.ts

@@ -0,0 +1,117 @@
+import { EventType, Period, Metric, QueryResult, Granularity, TimeSeriesResult, EventListResult, UserListResult, UserDetail, RetentionResult, Site, CreateSiteRequest, UpdateSiteRequest } from '@litemetrics/core';
+export { CreateSiteRequest, EventListItem, EventListParams, EventListResult, EventType, Granularity, Metric, Period, QueryDataPoint, QueryResult, RetentionCohort, RetentionParams, RetentionResult, Site, TimeSeriesParams, TimeSeriesPoint, TimeSeriesResult, UpdateSiteRequest, UserDetail, UserListParams, UserListResult } from '@litemetrics/core';
+
+interface LitemetricsClientConfig {
+    /** Base URL of the Litemetrics server (e.g. "https://analytics.myapp.com") */
+    baseUrl: string;
+    /** Site ID to query */
+    siteId: string;
+    /** Secret key for authentication (sk_xxx) */
+    secretKey?: string;
+    /** Query endpoint path (default: "/api/stats") */
+    endpoint?: string;
+    /** Custom headers to include in requests */
+    headers?: Record<string, string>;
+}
+interface StatsOptions {
+    period?: Period;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    filters?: Record<string, string>;
+    compare?: boolean;
+}
+interface RetentionOptions {
+    period?: Period;
+    weeks?: number;
+}
+interface EventsListOptions {
+    type?: EventType;
+    eventName?: string;
+    visitorId?: string;
+    userId?: string;
+    period?: Period;
+    dateFrom?: string;
+    dateTo?: string;
+    limit?: number;
+    offset?: number;
+}
+interface TimeSeriesOptions {
+    period?: Period;
+    dateFrom?: string;
+    dateTo?: string;
+    granularity?: Granularity;
+}
+interface UsersListOptions {
+    search?: string;
+    limit?: number;
+    offset?: number;
+}
+declare class LitemetricsClient {
+    private siteId;
+    private endpoint;
+    private http;
+    constructor(config: LitemetricsClientConfig);
+    /** Change the active site ID */
+    setSiteId(siteId: string): void;
+    /** Get any metric */
+    getStats(metric: Metric, options?: StatsOptions): Promise<QueryResult>;
+    getPageviews(options?: StatsOptions): Promise<QueryResult>;
+    getVisitors(options?: StatsOptions): Promise<QueryResult>;
+    getSessions(options?: StatsOptions): Promise<QueryResult>;
+    getEvents(options?: StatsOptions): Promise<QueryResult>;
+    getTopPages(options?: StatsOptions): Promise<QueryResult>;
+    getTopReferrers(options?: StatsOptions): Promise<QueryResult>;
+    getTopCountries(options?: StatsOptions): Promise<QueryResult>;
+    getTopCities(options?: StatsOptions): Promise<QueryResult>;
+    getTopEvents(options?: StatsOptions): Promise<QueryResult>;
+    getTopDevices(options?: StatsOptions): Promise<QueryResult>;
+    getTopBrowsers(options?: StatsOptions): Promise<QueryResult>;
+    getTopOS(options?: StatsOptions): Promise<QueryResult>;
+    /** Fetch multiple metrics in parallel */
+    getOverview(metrics?: Metric[], options?: StatsOptions): Promise<Record<Metric, QueryResult>>;
+    getTimeSeries(metric: 'pageviews' | 'visitors' | 'sessions', options?: TimeSeriesOptions): Promise<TimeSeriesResult>;
+    getEventsList(options?: EventsListOptions): Promise<EventListResult>;
+    getUsers(options?: UsersListOptions): Promise<UserListResult>;
+    getUserDetail(visitorId: string): Promise<UserDetail>;
+    getUserEvents(visitorId: string, options?: EventsListOptions): Promise<EventListResult>;
+    getRetention(options?: RetentionOptions): Promise<RetentionResult>;
+}
+/** Create an LitemetricsClient instance */
+declare function createClient(config: LitemetricsClientConfig): LitemetricsClient;
+
+interface SitesClientConfig {
+    /** Base URL of the Litemetrics server */
+    baseUrl: string;
+    /** Admin secret for authentication */
+    adminSecret: string;
+    /** Sites endpoint path (default: "/api/sites") */
+    endpoint?: string;
+}
+declare class SitesClient {
+    private endpoint;
+    private http;
+    constructor(config: SitesClientConfig);
+    listSites(): Promise<{
+        sites: Site[];
+        total: number;
+    }>;
+    getSite(siteId: string): Promise<{
+        site: Site;
+    }>;
+    createSite(body: CreateSiteRequest): Promise<{
+        site: Site;
+    }>;
+    updateSite(siteId: string, body: UpdateSiteRequest): Promise<{
+        site: Site;
+    }>;
+    deleteSite(siteId: string): Promise<{
+        ok: boolean;
+    }>;
+    regenerateSecret(siteId: string): Promise<{
+        site: Site;
+    }>;
+}
+declare function createSitesClient(config: SitesClientConfig): SitesClient;
+
+export { type EventsListOptions, LitemetricsClient, type LitemetricsClientConfig, type RetentionOptions, SitesClient, type SitesClientConfig, type StatsOptions, type TimeSeriesOptions, type UsersListOptions, createClient, createSitesClient };

package/dist/index.js

@@ -0,0 +1,201 @@
+// src/client.ts
+import axios from "axios";
+var LitemetricsClient = class {
+  siteId;
+  endpoint;
+  http;
+  constructor(config) {
+    this.siteId = config.siteId;
+    this.endpoint = config.endpoint ?? "/api/stats";
+    const headers = { ...config.headers };
+    if (config.secretKey) {
+      headers["X-Litemetrics-Secret"] = config.secretKey;
+    }
+    this.http = axios.create({
+      baseURL: config.baseUrl.replace(/\/$/, ""),
+      headers
+    });
+  }
+  /** Change the active site ID */
+  setSiteId(siteId) {
+    this.siteId = siteId;
+  }
+  /** Get any metric */
+  async getStats(metric, options) {
+    const params = {
+      siteId: this.siteId,
+      metric
+    };
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.filters) params.filters = JSON.stringify(options.filters);
+    if (options?.compare) params.compare = "true";
+    const { data } = await this.http.get(this.endpoint, { params });
+    return data;
+  }
+  // ─── Convenience methods ──────────────────────────────────
+  async getPageviews(options) {
+    return this.getStats("pageviews", options);
+  }
+  async getVisitors(options) {
+    return this.getStats("visitors", options);
+  }
+  async getSessions(options) {
+    return this.getStats("sessions", options);
+  }
+  async getEvents(options) {
+    return this.getStats("events", options);
+  }
+  async getTopPages(options) {
+    return this.getStats("top_pages", options);
+  }
+  async getTopReferrers(options) {
+    return this.getStats("top_referrers", options);
+  }
+  async getTopCountries(options) {
+    return this.getStats("top_countries", options);
+  }
+  async getTopCities(options) {
+    return this.getStats("top_cities", options);
+  }
+  async getTopEvents(options) {
+    return this.getStats("top_events", options);
+  }
+  async getTopDevices(options) {
+    return this.getStats("top_devices", options);
+  }
+  async getTopBrowsers(options) {
+    return this.getStats("top_browsers", options);
+  }
+  async getTopOS(options) {
+    return this.getStats("top_os", options);
+  }
+  /** Fetch multiple metrics in parallel */
+  async getOverview(metrics = ["pageviews", "visitors", "sessions", "events"], options) {
+    const results = await Promise.all(
+      metrics.map((m) => this.getStats(m, options).then((r) => [m, r]))
+    );
+    return Object.fromEntries(results);
+  }
+  // ─── Time series ──────────────────────────────────────
+  async getTimeSeries(metric, options) {
+    const params = {
+      siteId: this.siteId,
+      metric: "timeseries",
+      tsMetric: metric
+    };
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.granularity) params.granularity = options.granularity;
+    const { data } = await this.http.get(this.endpoint, { params });
+    return data;
+  }
+  // ─── Event listing ──────────────────────────────────────
+  async getEventsList(options) {
+    const params = { siteId: this.siteId };
+    if (options?.type) params.type = options.type;
+    if (options?.eventName) params.eventName = options.eventName;
+    if (options?.visitorId) params.visitorId = options.visitorId;
+    if (options?.userId) params.userId = options.userId;
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.offset) params.offset = String(options.offset);
+    const { data } = await this.http.get("/api/events", { params });
+    return data;
+  }
+  // ─── User listing ──────────────────────────────────────
+  async getUsers(options) {
+    const params = { siteId: this.siteId };
+    if (options?.search) params.search = options.search;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.offset) params.offset = String(options.offset);
+    const { data } = await this.http.get("/api/users", { params });
+    return data;
+  }
+  async getUserDetail(visitorId) {
+    const params = { siteId: this.siteId };
+    const { data } = await this.http.get(`/api/users/${encodeURIComponent(visitorId)}`, { params });
+    return data.user;
+  }
+  async getUserEvents(visitorId, options) {
+    const params = { siteId: this.siteId };
+    if (options?.type) params.type = options.type;
+    if (options?.period) params.period = options.period;
+    if (options?.dateFrom) params.dateFrom = options.dateFrom;
+    if (options?.dateTo) params.dateTo = options.dateTo;
+    if (options?.limit) params.limit = String(options.limit);
+    if (options?.offset) params.offset = String(options.offset);
+    const { data } = await this.http.get(`/api/users/${encodeURIComponent(visitorId)}/events`, { params });
+    return data;
+  }
+  // ─── Retention ──────────────────────────────────────
+  async getRetention(options) {
+    const params = {
+      siteId: this.siteId,
+      metric: "retention"
+    };
+    if (options?.period) params.period = options.period;
+    if (options?.weeks) params.weeks = String(options.weeks);
+    const { data } = await this.http.get(this.endpoint, { params });
+    return data;
+  }
+};
+function createClient(config) {
+  return new LitemetricsClient(config);
+}
+
+// src/sites.ts
+import axios2 from "axios";
+var SitesClient = class {
+  endpoint;
+  http;
+  constructor(config) {
+    this.endpoint = config.endpoint ?? "/api/sites";
+    this.http = axios2.create({
+      baseURL: config.baseUrl.replace(/\/$/, ""),
+      headers: {
+        "Content-Type": "application/json",
+        "X-Litemetrics-Admin-Secret": config.adminSecret
+      }
+    });
+  }
+  async listSites() {
+    const { data } = await this.http.get(this.endpoint);
+    return data;
+  }
+  async getSite(siteId) {
+    const { data } = await this.http.get(`${this.endpoint}/${siteId}`);
+    return data;
+  }
+  async createSite(body) {
+    const { data } = await this.http.post(this.endpoint, body);
+    return data;
+  }
+  async updateSite(siteId, body) {
+    const { data } = await this.http.put(`${this.endpoint}/${siteId}`, body);
+    return data;
+  }
+  async deleteSite(siteId) {
+    const { data } = await this.http.delete(`${this.endpoint}/${siteId}`);
+    return data;
+  }
+  async regenerateSecret(siteId) {
+    const { data } = await this.http.post(`${this.endpoint}/${siteId}/regenerate`);
+    return data;
+  }
+};
+function createSitesClient(config) {
+  return new SitesClient(config);
+}
+export {
+  LitemetricsClient,
+  SitesClient,
+  createClient,
+  createSitesClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/sites.ts"],"sourcesContent":["import axios, { type AxiosInstance } from 'axios';\nimport type { Metric, Period, Granularity, QueryResult, TimeSeriesResult, RetentionResult, EventListResult, UserListResult, UserDetail, EventType } from '@litemetrics/core';\n\nexport interface LitemetricsClientConfig {\n  /** Base URL of the Litemetrics server (e.g. \"https://analytics.myapp.com\") */\n  baseUrl: string;\n  /** Site ID to query */\n  siteId: string;\n  /** Secret key for authentication (sk_xxx) */\n  secretKey?: string;\n  /** Query endpoint path (default: \"/api/stats\") */\n  endpoint?: string;\n  /** Custom headers to include in requests */\n  headers?: Record<string, string>;\n}\n\nexport interface StatsOptions {\n  period?: Period;\n  dateFrom?: string;\n  dateTo?: string;\n  limit?: number;\n  filters?: Record<string, string>;\n  compare?: boolean;\n}\n\nexport interface RetentionOptions {\n  period?: Period;\n  weeks?: number;\n}\n\nexport interface EventsListOptions {\n  type?: EventType;\n  eventName?: string;\n  visitorId?: string;\n  userId?: string;\n  period?: Period;\n  dateFrom?: string;\n  dateTo?: string;\n  limit?: number;\n  offset?: number;\n}\n\nexport interface TimeSeriesOptions {\n  period?: Period;\n  dateFrom?: string;\n  dateTo?: string;\n  granularity?: Granularity;\n}\n\nexport interface UsersListOptions {\n  search?: string;\n  limit?: number;\n  offset?: number;\n}\n\nexport class LitemetricsClient {\n  private siteId: string;\n  private endpoint: string;\n  private http: AxiosInstance;\n\n  constructor(config: LitemetricsClientConfig) {\n    this.siteId = config.siteId;\n    this.endpoint = config.endpoint ?? '/api/stats';\n\n    const headers: Record<string, string> = { ...config.headers };\n    if (config.secretKey) {\n      headers['X-Litemetrics-Secret'] = config.secretKey;\n    }\n\n    this.http = axios.create({\n      baseURL: config.baseUrl.replace(/\\/$/, ''),\n      headers,\n    });\n  }\n\n  /** Change the active site ID */\n  setSiteId(siteId: string): void {\n    this.siteId = siteId;\n  }\n\n  /** Get any metric */\n  async getStats(metric: Metric, options?: StatsOptions): Promise<QueryResult> {\n    const params: Record<string, string> = {\n      siteId: this.siteId,\n      metric,\n    };\n\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.filters) params.filters = JSON.stringify(options.filters);\n    if (options?.compare) params.compare = 'true';\n\n    const { data } = await this.http.get<QueryResult>(this.endpoint, { params });\n    return data;\n  }\n\n  // ─── Convenience methods ──────────────────────────────────\n\n  async getPageviews(options?: StatsOptions) { return this.getStats('pageviews', options); }\n  async getVisitors(options?: StatsOptions) { return this.getStats('visitors', options); }\n  async getSessions(options?: StatsOptions) { return this.getStats('sessions', options); }\n  async getEvents(options?: StatsOptions) { return this.getStats('events', options); }\n  async getTopPages(options?: StatsOptions) { return this.getStats('top_pages', options); }\n  async getTopReferrers(options?: StatsOptions) { return this.getStats('top_referrers', options); }\n  async getTopCountries(options?: StatsOptions) { return this.getStats('top_countries', options); }\n  async getTopCities(options?: StatsOptions) { return this.getStats('top_cities', options); }\n  async getTopEvents(options?: StatsOptions) { return this.getStats('top_events', options); }\n  async getTopDevices(options?: StatsOptions) { return this.getStats('top_devices', options); }\n  async getTopBrowsers(options?: StatsOptions) { return this.getStats('top_browsers', options); }\n  async getTopOS(options?: StatsOptions) { return this.getStats('top_os', options); }\n\n  /** Fetch multiple metrics in parallel */\n  async getOverview(\n    metrics: Metric[] = ['pageviews', 'visitors', 'sessions', 'events'],\n    options?: StatsOptions,\n  ): Promise<Record<Metric, QueryResult>> {\n    const results = await Promise.all(\n      metrics.map((m) => this.getStats(m, options).then((r) => [m, r] as const)),\n    );\n    return Object.fromEntries(results) as Record<Metric, QueryResult>;\n  }\n\n  // ─── Time series ──────────────────────────────────────\n\n  async getTimeSeries(\n    metric: 'pageviews' | 'visitors' | 'sessions',\n    options?: TimeSeriesOptions,\n  ): Promise<TimeSeriesResult> {\n    const params: Record<string, string> = {\n      siteId: this.siteId,\n      metric: 'timeseries',\n      tsMetric: metric,\n    };\n\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.granularity) params.granularity = options.granularity;\n\n    const { data } = await this.http.get<TimeSeriesResult>(this.endpoint, { params });\n    return data;\n  }\n\n  // ─── Event listing ──────────────────────────────────────\n\n  async getEventsList(options?: EventsListOptions): Promise<EventListResult> {\n    const params: Record<string, string> = { siteId: this.siteId };\n\n    if (options?.type) params.type = options.type;\n    if (options?.eventName) params.eventName = options.eventName;\n    if (options?.visitorId) params.visitorId = options.visitorId;\n    if (options?.userId) params.userId = options.userId;\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.offset) params.offset = String(options.offset);\n\n    const { data } = await this.http.get<EventListResult>('/api/events', { params });\n    return data;\n  }\n\n  // ─── User listing ──────────────────────────────────────\n\n  async getUsers(options?: UsersListOptions): Promise<UserListResult> {\n    const params: Record<string, string> = { siteId: this.siteId };\n\n    if (options?.search) params.search = options.search;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.offset) params.offset = String(options.offset);\n\n    const { data } = await this.http.get<UserListResult>('/api/users', { params });\n    return data;\n  }\n\n  async getUserDetail(visitorId: string): Promise<UserDetail> {\n    const params: Record<string, string> = { siteId: this.siteId };\n    const { data } = await this.http.get<{ user: UserDetail }>(`/api/users/${encodeURIComponent(visitorId)}`, { params });\n    return data.user;\n  }\n\n  async getUserEvents(visitorId: string, options?: EventsListOptions): Promise<EventListResult> {\n    const params: Record<string, string> = { siteId: this.siteId };\n\n    if (options?.type) params.type = options.type;\n    if (options?.period) params.period = options.period;\n    if (options?.dateFrom) params.dateFrom = options.dateFrom;\n    if (options?.dateTo) params.dateTo = options.dateTo;\n    if (options?.limit) params.limit = String(options.limit);\n    if (options?.offset) params.offset = String(options.offset);\n\n    const { data } = await this.http.get<EventListResult>(`/api/users/${encodeURIComponent(visitorId)}/events`, { params });\n    return data;\n  }\n\n  // ─── Retention ──────────────────────────────────────\n\n  async getRetention(options?: RetentionOptions): Promise<RetentionResult> {\n    const params: Record<string, string> = {\n      siteId: this.siteId,\n      metric: 'retention',\n    };\n\n    if (options?.period) params.period = options.period;\n    if (options?.weeks) params.weeks = String(options.weeks);\n\n    const { data } = await this.http.get<RetentionResult>(this.endpoint, { params });\n    return data;\n  }\n}\n\n/** Create an LitemetricsClient instance */\nexport function createClient(config: LitemetricsClientConfig): LitemetricsClient {\n  return new LitemetricsClient(config);\n}\n","import axios, { type AxiosInstance } from 'axios';\nimport type { Site, CreateSiteRequest, UpdateSiteRequest } from '@litemetrics/core';\n\nexport interface SitesClientConfig {\n  /** Base URL of the Litemetrics server */\n  baseUrl: string;\n  /** Admin secret for authentication */\n  adminSecret: string;\n  /** Sites endpoint path (default: \"/api/sites\") */\n  endpoint?: string;\n}\n\nexport class SitesClient {\n  private endpoint: string;\n  private http: AxiosInstance;\n\n  constructor(config: SitesClientConfig) {\n    this.endpoint = config.endpoint ?? '/api/sites';\n\n    this.http = axios.create({\n      baseURL: config.baseUrl.replace(/\\/$/, ''),\n      headers: {\n        'Content-Type': 'application/json',\n        'X-Litemetrics-Admin-Secret': config.adminSecret,\n      },\n    });\n  }\n\n  async listSites(): Promise<{ sites: Site[]; total: number }> {\n    const { data } = await this.http.get(this.endpoint);\n    return data;\n  }\n\n  async getSite(siteId: string): Promise<{ site: Site }> {\n    const { data } = await this.http.get(`${this.endpoint}/${siteId}`);\n    return data;\n  }\n\n  async createSite(body: CreateSiteRequest): Promise<{ site: Site }> {\n    const { data } = await this.http.post(this.endpoint, body);\n    return data;\n  }\n\n  async updateSite(siteId: string, body: UpdateSiteRequest): Promise<{ site: Site }> {\n    const { data } = await this.http.put(`${this.endpoint}/${siteId}`, body);\n    return data;\n  }\n\n  async deleteSite(siteId: string): Promise<{ ok: boolean }> {\n    const { data } = await this.http.delete(`${this.endpoint}/${siteId}`);\n    return data;\n  }\n\n  async regenerateSecret(siteId: string): Promise<{ site: Site }> {\n    const { data } = await this.http.post(`${this.endpoint}/${siteId}/regenerate`);\n    return data;\n  }\n}\n\nexport function createSitesClient(config: SitesClientConfig): SitesClient {\n  return new SitesClient(config);\n}\n"],"mappings":"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","names":["axios"]}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@litemetrics/client",
+  "version": "0.1.0",
+  "description": "Client-side SDK for querying Litemetrics analytics data",
+  "license": "MIT",
+  "author": "Metehan Kurucu",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/metehankurucu/litemetrics",
+    "directory": "packages/client"
+  },
+  "keywords": ["analytics", "litemetrics", "client", "dashboard", "query"],
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": ["dist"],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "dependencies": {
+    "@litemetrics/core": "0.1.0",
+    "axios": "^1.13.4"
+  },
+  "devDependencies": {
+    "tsup": "^8",
+    "typescript": "^5.7"
+  }
+}