@stacksee/analytics 0.7.0 → 0.9.0

package/dist/providers/proxy/client.d.ts

@@ -0,0 +1,56 @@
+import { BaseEvent, EventContext } from '../../core/events/types.js';
+import { BaseAnalyticsProvider } from '../base.provider.js';
+import { ProxyBatchConfig, ProxyRetryConfig } from './types.js';
+export interface ProxyProviderConfig {
+    /**
+     * The endpoint to send events to (e.g., '/api/events')
+     */
+    endpoint: string;
+    /**
+     * Batching configuration
+     */
+    batch?: ProxyBatchConfig;
+    /**
+     * Retry configuration
+     */
+    retry?: ProxyRetryConfig;
+    /**
+     * Custom headers to include in requests
+     */
+    headers?: Record<string, string>;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+    /**
+     * Enable/disable the provider
+     */
+    enabled?: boolean;
+}
+export declare class ProxyProvider extends BaseAnalyticsProvider {
+    name: string;
+    private config;
+    private queue;
+    private flushTimer?;
+    private readonly batchSize;
+    private readonly batchInterval;
+    private readonly retryAttempts;
+    private readonly retryBackoff;
+    private readonly retryInitialDelay;
+    constructor(config: ProxyProviderConfig);
+    initialize(): Promise<void>;
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    track(event: BaseEvent, context?: EventContext): Promise<void>;
+    pageView(properties?: Record<string, unknown>, context?: EventContext): void;
+    reset(): Promise<void>;
+    shutdown(): Promise<void>;
+    /**
+     * Manually flush all queued events
+     */
+    flush(useBeacon?: boolean): Promise<void>;
+    private queueEvent;
+    private sendEvents;
+    private sendWithRetry;
+    private calculateRetryDelay;
+    private enrichContext;
+}

package/dist/providers/proxy/server.d.ts

@@ -0,0 +1,55 @@
+import { ServerAnalytics } from '../../server.js';
+/**
+ * Configuration for ingesting proxy events
+ */
+export interface IngestProxyEventsConfig {
+    /**
+     * Enrich context with server-side data
+     */
+    enrichContext?: (request: Request) => Record<string, unknown>;
+    /**
+     * Extract IP address from request
+     * Default: Uses standard headers (X-Forwarded-For, X-Real-IP)
+     */
+    extractIp?: (request: Request) => string | undefined;
+    /**
+     * Error handler
+     */
+    onError?: (error: unknown) => void;
+}
+/**
+ * Ingests events from ProxyProvider and replays them through server analytics
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router
+ * export async function POST(req: Request) {
+ *   await ingestProxyEvents(req, serverAnalytics);
+ *   return new Response('OK');
+ * }
+ *
+ * // With custom IP extraction
+ * export async function POST(req: Request) {
+ *   await ingestProxyEvents(req, serverAnalytics, {
+ *     extractIp: (req) => req.headers.get('cf-connecting-ip') // Cloudflare
+ *   });
+ *   return new Response('OK');
+ * }
+ * ```
+ */
+export declare function ingestProxyEvents<TEventMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TUserTraits extends Record<string, unknown> = Record<string, unknown>>(request: Request, analytics: ServerAnalytics<TEventMap, TUserTraits>, config?: IngestProxyEventsConfig): Promise<void>;
+/**
+ * Creates a Request handler for common frameworks
+ *
+ * @example
+ * ```typescript
+ * // Next.js App Router
+ * export const POST = createProxyHandler(serverAnalytics);
+ *
+ * // With custom config
+ * export const POST = createProxyHandler(serverAnalytics, {
+ *   extractIp: (req) => req.headers.get('cf-connecting-ip')
+ * });
+ * ```
+ */
+export declare function createProxyHandler<TEventMap extends Record<string, Record<string, unknown>> = Record<string, Record<string, unknown>>, TUserTraits extends Record<string, unknown> = Record<string, unknown>>(analytics: ServerAnalytics<TEventMap, TUserTraits>, config?: IngestProxyEventsConfig): (request: Request) => Promise<Response>;

package/dist/providers/proxy/types.d.ts

@@ -0,0 +1,64 @@
+import { BaseEvent, EventContext } from '../../core/events/types.js';
+/**
+ * Proxy event types for batching and sending to server
+ */
+export type ProxyTrackEvent = {
+    type: "track";
+    event: BaseEvent;
+    context?: EventContext;
+};
+export type ProxyIdentifyEvent = {
+    type: "identify";
+    userId: string;
+    traits?: Record<string, unknown>;
+};
+export type ProxyPageViewEvent = {
+    type: "pageView";
+    properties?: Record<string, unknown>;
+    context?: EventContext;
+};
+export type ProxyResetEvent = {
+    type: "reset";
+};
+export type ProxyEvent = ProxyTrackEvent | ProxyIdentifyEvent | ProxyPageViewEvent | ProxyResetEvent;
+/**
+ * Payload sent to the proxy endpoint
+ */
+export interface ProxyPayload {
+    events: ProxyEvent[];
+}
+/**
+ * Configuration for batching behavior
+ */
+export interface ProxyBatchConfig {
+    /**
+     * Maximum number of events before auto-flush
+     * @default 10
+     */
+    size?: number;
+    /**
+     * Maximum time in ms before auto-flush
+     * @default 5000
+     */
+    interval?: number;
+}
+/**
+ * Configuration for retry behavior
+ */
+export interface ProxyRetryConfig {
+    /**
+     * Maximum retry attempts
+     * @default 3
+     */
+    attempts?: number;
+    /**
+     * Backoff strategy
+     * @default 'exponential'
+     */
+    backoff?: "exponential" | "linear";
+    /**
+     * Initial delay in ms
+     * @default 1000
+     */
+    initialDelay?: number;
+}

package/dist/providers/server.d.ts

@@ -5,3 +5,5 @@ export { BentoServerProvider } from './bento/server.js';
 export type { BentoServerConfig, BentoAnalyticsOptions } from './bento/server.js';
 export { PirschServerProvider } from './pirsch/server.js';
 export type { PirschServerConfig } from './pirsch/server.js';
+export { ingestProxyEvents, createProxyHandler } from './proxy/server.js';
+export type { IngestProxyEventsConfig } from './proxy/server.js';

package/dist/providers/server.js

@@ -1,100 +1,100 @@
-var g = Object.defineProperty;
-var p = (o, h, e) => h in o ? g(o, h, { enumerable: !0, configurable: !0, writable: !0, value: e }) : o[h] = e;
-var n = (o, h, e) => p(o, typeof h != "symbol" ? h + "" : h, e);
-import { B as f } from "../base.provider-AfFL5W_P.js";
-import { P as k } from "../server-DjEk1fUD.js";
-class b extends f {
-  constructor(e) {
-    super({ debug: e.debug, enabled: e.enabled });
-    n(this, "name", "Bento-Server");
-    n(this, "client");
-    n(this, "initialized", !1);
-    n(this, "config");
-    n(this, "currentUserEmail");
-    this.config = e;
+var f = Object.defineProperty;
+var y = (l, n, i) => n in l ? f(l, n, { enumerable: !0, configurable: !0, writable: !0, value: i }) : l[n] = i;
+var d = (l, n, i) => y(l, typeof n != "symbol" ? n + "" : n, i);
+import { B as p } from "../base.provider-AfFL5W_P.js";
+import { P as z } from "../server-DjEk1fUD.js";
+class v extends p {
+  constructor(i) {
+    super({ debug: i.debug, enabled: i.enabled });
+    d(this, "name", "Bento-Server");
+    d(this, "client");
+    d(this, "initialized", !1);
+    d(this, "config");
+    d(this, "currentUserEmail");
+    this.config = i;
   }
   async initialize() {
-    var e, i;
+    var i, e;
     if (this.isEnabled() && !this.initialized) {
       if (!this.config.siteUuid || typeof this.config.siteUuid != "string")
         throw new Error("Bento requires a siteUuid");
-      if (!((e = this.config.authentication) != null && e.publishableKey) || typeof this.config.authentication.publishableKey != "string")
+      if (!((i = this.config.authentication) != null && i.publishableKey) || typeof this.config.authentication.publishableKey != "string")
         throw new Error("Bento requires authentication.publishableKey");
-      if (!((i = this.config.authentication) != null && i.secretKey) || typeof this.config.authentication.secretKey != "string")
+      if (!((e = this.config.authentication) != null && e.secretKey) || typeof this.config.authentication.secretKey != "string")
         throw new Error("Bento requires authentication.secretKey");
       try {
-        const { Analytics: r } = await import("../bento-node-sdk.esm-C4HG7SVz.js"), { debug: a, enabled: s, ...l } = this.config;
-        this.client = new r(l), this.initialized = !0, this.log("Initialized successfully", {
+        const { Analytics: s } = await import("../bento-node-sdk.esm-C4HG7SVz.js"), { debug: a, enabled: t, ...o } = this.config;
+        this.client = new s(o), this.initialized = !0, this.log("Initialized successfully", {
           siteUuid: this.config.siteUuid
         });
-      } catch (r) {
+      } catch (s) {
         throw console.error(
           "[Bento-Server] Failed to initialize. Make sure @bentonow/bento-node-sdk is installed:",
-          r
-        ), r;
+          s
+        ), s;
       }
     }
   }
-  identify(e, i) {
+  identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = (i == null ? void 0 : i.email) || e;
-    this.currentUserEmail = r;
-    const a = i ? { ...i } : {};
+    const s = (e == null ? void 0 : e.email) || i;
+    this.currentUserEmail = s;
+    const a = e ? { ...e } : {};
     delete a.email, this.client.V1.addSubscriber({
-      email: r,
+      email: s,
       fields: a
-    }).catch((s) => {
-      console.error("[Bento-Server] Failed to identify user:", s);
-    }), this.log("Identified user", { userId: e, email: r, traits: i });
+    }).catch((t) => {
+      console.error("[Bento-Server] Failed to identify user:", t);
+    }), this.log("Identified user", { userId: i, email: s, traits: e });
   }
-  async track(e, i) {
-    var l, t, d;
+  async track(i, e) {
+    var o, r, h;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = ((l = i == null ? void 0 : i.user) == null ? void 0 : l.email) || this.currentUserEmail || ((t = i == null ? void 0 : i.user) == null ? void 0 : t.userId) || e.userId || "anonymous@unknown.com", a = {
-      ...e.properties,
-      category: e.category,
-      timestamp: e.timestamp || Date.now(),
-      ...e.sessionId && { sessionId: e.sessionId },
-      ...(i == null ? void 0 : i.page) && {
+    const s = ((o = e == null ? void 0 : e.user) == null ? void 0 : o.email) || this.currentUserEmail || ((r = e == null ? void 0 : e.user) == null ? void 0 : r.userId) || i.userId || "anonymous@unknown.com", a = {
+      ...i.properties,
+      category: i.category,
+      timestamp: i.timestamp || Date.now(),
+      ...i.sessionId && { sessionId: i.sessionId },
+      ...(e == null ? void 0 : e.page) && {
         page: {
-          path: i.page.path,
-          title: i.page.title,
-          referrer: i.page.referrer
+          path: e.page.path,
+          title: e.page.title,
+          referrer: e.page.referrer
         }
       },
-      ...(i == null ? void 0 : i.device) && { device: i.device },
-      ...(i == null ? void 0 : i.utm) && { utm: i.utm }
-    }, s = ((d = i == null ? void 0 : i.user) == null ? void 0 : d.traits) || {};
+      ...(e == null ? void 0 : e.device) && { device: e.device },
+      ...(e == null ? void 0 : e.utm) && { utm: e.utm }
+    }, t = ((h = e == null ? void 0 : e.user) == null ? void 0 : h.traits) || {};
     try {
       await this.client.V1.track({
-        email: r,
-        type: `$${e.action}`,
+        email: s,
+        type: `$${i.action}`,
         details: a,
-        fields: s
-      }), this.log("Tracked event", { event: e, context: i });
-    } catch (c) {
-      console.error("[Bento-Server] Failed to track event:", c);
+        fields: t
+      }), this.log("Tracked event", { event: i, context: e });
+    } catch (u) {
+      console.error("[Bento-Server] Failed to track event:", u);
     }
   }
-  pageView(e, i) {
-    var l, t;
+  pageView(i, e) {
+    var o, r;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = ((l = i == null ? void 0 : i.user) == null ? void 0 : l.email) || this.currentUserEmail || "anonymous@unknown.com", a = {
-      ...e,
-      ...(i == null ? void 0 : i.page) && {
-        path: i.page.path,
-        title: i.page.title,
-        referrer: i.page.referrer
+    const s = ((o = e == null ? void 0 : e.user) == null ? void 0 : o.email) || this.currentUserEmail || "anonymous@unknown.com", a = {
+      ...i,
+      ...(e == null ? void 0 : e.page) && {
+        path: e.page.path,
+        title: e.page.title,
+        referrer: e.page.referrer
       }
-    }, s = ((t = i == null ? void 0 : i.user) == null ? void 0 : t.traits) || {};
+    }, t = ((r = e == null ? void 0 : e.user) == null ? void 0 : r.traits) || {};
     this.client.V1.track({
-      email: r,
-      type: "$pageview",
+      email: s,
+      type: "$view",
       details: a,
-      fields: s
-    }).catch((d) => {
-      console.error("[Bento-Server] Failed to track page view:", d);
-    }), this.log("Tracked page view", { properties: e, context: i });
+      fields: t
+    }).catch((h) => {
+      console.error("[Bento-Server] Failed to track page view:", h);
+    }), this.log("Tracked page view", { properties: i, context: e });
   }
   async reset() {
     !this.isEnabled() || !this.initialized || !this.client || (this.currentUserEmail = void 0, this.log("Reset user session"));
@@ -103,14 +103,14 @@ class b extends f {
     this.client = void 0, this.initialized = !1, this.log("Shutdown complete");
   }
 }
-class w extends f {
-  constructor(e) {
-    super({ debug: e.debug, enabled: e.enabled });
-    n(this, "name", "Pirsch-Server");
-    n(this, "client");
-    n(this, "initialized", !1);
-    n(this, "config");
-    this.config = e;
+class E extends p {
+  constructor(i) {
+    super({ debug: i.debug, enabled: i.enabled });
+    d(this, "name", "Pirsch-Server");
+    d(this, "client");
+    d(this, "initialized", !1);
+    d(this, "config");
+    this.config = i;
   }
   async initialize() {
     if (this.isEnabled() && !this.initialized) {
@@ -119,106 +119,192 @@ class w extends f {
       if (!this.config.clientSecret || typeof this.config.clientSecret != "string")
         throw new Error("Pirsch requires a clientSecret (or access key)");
       try {
-        const { Pirsch: e } = await import("../index-bgxxv-IJ.js").then((s) => s.i), { debug: i, enabled: r, ...a } = this.config;
-        this.client = new e(a), this.initialized = !0, this.log("Initialized successfully", {
+        const { Pirsch: i } = await import("../index-bgxxv-IJ.js").then((t) => t.i), { debug: e, enabled: s, ...a } = this.config;
+        this.client = new i(a), this.initialized = !0, this.log("Initialized successfully", {
           hostname: this.config.hostname
         });
-      } catch (e) {
+      } catch (i) {
         throw console.error(
           "[Pirsch-Server] Failed to initialize. Make sure pirsch-sdk is installed:",
-          e
-        ), e;
+          i
+        ), i;
       }
     }
   }
-  identify(e, i) {
+  identify(i, e) {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = {
+    const s = {
       url: "https://identify",
       ip: "0.0.0.0",
       user_agent: "analytics-library"
     }, a = {
-      userId: e,
-      ...i && Object.fromEntries(
-        Object.entries(i).filter(
-          ([, s]) => typeof s == "string" || typeof s == "number" || typeof s == "boolean"
+      userId: i,
+      ...e && Object.fromEntries(
+        Object.entries(e).filter(
+          ([, t]) => typeof t == "string" || typeof t == "number" || typeof t == "boolean"
         )
       )
     };
-    this.client.event("user_identified", r, 0, a).catch((s) => {
-      console.error("[Pirsch-Server] Failed to track identify event:", s);
-    }), this.log("Identified user via event", { userId: e, traits: i });
+    this.client.event("user_identified", s, 0, a).catch((t) => {
+      console.error("[Pirsch-Server] Failed to track identify event:", t);
+    }), this.log("Identified user via event", { userId: i, traits: e });
   }
-  async track(e, i) {
-    var l, t, d, c;
+  async track(i, e) {
+    var o, r, h, u;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = {
-      url: ((l = i == null ? void 0 : i.page) == null ? void 0 : l.path) || "https://event",
+    const s = {
+      url: ((o = e == null ? void 0 : e.page) == null ? void 0 : o.path) || "https://event",
       ip: "0.0.0.0",
       // Server-side should provide real IP if available
       user_agent: "analytics-library",
       // Server-side should provide real UA if available
-      ...((t = i == null ? void 0 : i.page) == null ? void 0 : t.title) && { title: i.page.title },
-      ...((d = i == null ? void 0 : i.page) == null ? void 0 : d.referrer) && { referrer: i.page.referrer }
-    }, s = {
+      ...((r = e == null ? void 0 : e.page) == null ? void 0 : r.title) && { title: e.page.title },
+      ...((h = e == null ? void 0 : e.page) == null ? void 0 : h.referrer) && { referrer: e.page.referrer }
+    }, t = {
       ...Object.fromEntries(
-        Object.entries(e.properties).filter(
-          ([, u]) => typeof u == "string" || typeof u == "number" || typeof u == "boolean"
+        Object.entries(i.properties).filter(
+          ([, c]) => typeof c == "string" || typeof c == "number" || typeof c == "boolean"
         )
       ),
-      category: e.category,
-      timestamp: String(e.timestamp || Date.now()),
-      ...e.userId && { userId: e.userId },
-      ...e.sessionId && { sessionId: e.sessionId },
-      ...((c = i == null ? void 0 : i.user) == null ? void 0 : c.email) && { user_email: i.user.email }
+      category: i.category,
+      timestamp: String(i.timestamp || Date.now()),
+      ...i.userId && { userId: i.userId },
+      ...i.sessionId && { sessionId: i.sessionId },
+      ...((u = e == null ? void 0 : e.user) == null ? void 0 : u.email) && { user_email: e.user.email }
     };
     try {
-      await this.client.event(e.action, r, 0, s), this.log("Tracked event", { event: e, context: i });
-    } catch (u) {
-      console.error("[Pirsch-Server] Failed to track event:", u);
+      await this.client.event(i.action, s, 0, t), this.log("Tracked event", { event: i, context: e });
+    } catch (c) {
+      console.error("[Pirsch-Server] Failed to track event:", c);
     }
   }
-  pageView(e, i) {
-    var a, s, l;
+  pageView(i, e) {
+    var a, t, o;
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const r = {
-      url: ((a = i == null ? void 0 : i.page) == null ? void 0 : a.path) || "https://pageview",
+    const s = {
+      url: ((a = e == null ? void 0 : e.page) == null ? void 0 : a.path) || "https://pageview",
       ip: "0.0.0.0",
       // Server-side should provide real IP if available
       user_agent: "analytics-library",
       // Server-side should provide real UA if available
-      ...((s = i == null ? void 0 : i.page) == null ? void 0 : s.title) && { title: i.page.title },
-      ...((l = i == null ? void 0 : i.page) == null ? void 0 : l.referrer) && { referrer: i.page.referrer },
-      ...e && {
+      ...((t = e == null ? void 0 : e.page) == null ? void 0 : t.title) && { title: e.page.title },
+      ...((o = e == null ? void 0 : e.page) == null ? void 0 : o.referrer) && { referrer: e.page.referrer },
+      ...i && {
         tags: Object.fromEntries(
-          Object.entries(e).filter(
-            ([, t]) => typeof t == "string" || typeof t == "number" || typeof t == "boolean"
+          Object.entries(i).filter(
+            ([, r]) => typeof r == "string" || typeof r == "number" || typeof r == "boolean"
           )
         )
       }
     };
-    this.client.hit(r).catch((t) => {
-      console.error("[Pirsch-Server] Failed to track page view:", t);
-    }), this.log("Tracked page view", { properties: e, context: i });
+    this.client.hit(s).catch((r) => {
+      console.error("[Pirsch-Server] Failed to track page view:", r);
+    }), this.log("Tracked page view", { properties: i, context: e });
   }
   async reset() {
     if (!this.isEnabled() || !this.initialized || !this.client) return;
-    const e = {
+    const i = {
       url: "https://session-reset",
       ip: "0.0.0.0",
       user_agent: "analytics-library"
     };
-    await this.client.event("session_reset", e, 0, {}).catch((i) => {
-      console.error("[Pirsch-Server] Failed to track session reset:", i);
+    await this.client.event("session_reset", i, 0, {}).catch((e) => {
+      console.error("[Pirsch-Server] Failed to track session reset:", e);
     }), this.log("Reset user session");
   }
   async shutdown() {
     this.client = void 0, this.initialized = !1, this.log("Shutdown complete");
   }
 }
+async function g(l, n, i) {
+  var e, s;
+  try {
+    const a = await l.json();
+    if (!a.events || !Array.isArray(a.events))
+      throw new Error("Invalid payload: missing events array");
+    const t = i != null && i.extractIp ? i.extractIp(l) : m(l), o = i != null && i.enrichContext ? i.enrichContext(l) : {};
+    for (const r of a.events)
+      try {
+        switch (r.type) {
+          case "track": {
+            const h = {
+              ...r.context,
+              ...o,
+              device: {
+                ...(e = r.context) == null ? void 0 : e.device,
+                // Add IP (using type assertion for extended fields)
+                // biome-ignore lint/suspicious/noExplicitAny: IP field not in base device type
+                ...t ? { ip: t } : {}
+              }
+            };
+            await n.track(r.event.action, r.event.properties, {
+              userId: r.event.userId,
+              sessionId: r.event.sessionId,
+              // biome-ignore lint/suspicious/noExplicitAny: Generic context forwarding requires type assertion
+              context: h
+            });
+            break;
+          }
+          case "identify": {
+            n.identify(r.userId, r.traits);
+            break;
+          }
+          case "pageView": {
+            const h = {
+              ...r.context,
+              ...o,
+              device: {
+                ...(s = r.context) == null ? void 0 : s.device,
+                // biome-ignore lint/suspicious/noExplicitAny: IP field not in base device type
+                // Add IP (using type assertion for extended fields)
+                ...t ? { ip: t } : {}
+              }
+            };
+            n.pageView(r.properties, h);
+            break;
+          }
+          case "reset":
+            break;
+          default:
+            console.warn("[Proxy] Unknown event type:", r);
+        }
+      } catch (h) {
+        i != null && i.onError ? i.onError(h) : console.error("[Proxy] Failed to process event:", h);
+      }
+  } catch (a) {
+    throw i != null && i.onError ? i.onError(a) : console.error("[Proxy] Failed to ingest events:", a), a;
+  }
+}
+function m(l) {
+  var i;
+  const n = [
+    "x-forwarded-for",
+    "x-real-ip",
+    "cf-connecting-ip",
+    // Cloudflare
+    "x-client-ip",
+    "x-cluster-client-ip"
+  ];
+  for (const e of n) {
+    const s = l.headers.get(e);
+    if (s)
+      return (i = s.split(",")[0]) == null ? void 0 : i.trim();
+  }
+}
+function k(l, n) {
+  return async (i) => {
+    try {
+      return await g(i, l, n), new Response("OK", { status: 200 });
+    } catch (e) {
+      return console.error("[Proxy] Handler error:", e), new Response("Internal Server Error", { status: 500 });
+    }
+  };
+}
 export {
-  f as BaseAnalyticsProvider,
-  b as BentoServerProvider,
-  w as PirschServerProvider,
-  k as PostHogServerProvider
+  p as BaseAnalyticsProvider,
+  v as BentoServerProvider,
+  E as PirschServerProvider,
+  z as PostHogServerProvider,
+  k as createProxyHandler,
+  g as ingestProxyEvents
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stacksee/analytics",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "A highly typed, provider-agnostic analytics library for TypeScript applications",
   "type": "module",
   "exports": {
@@ -70,6 +70,10 @@
     "pnpm": ">=9.0.0",
     "node": ">=20"
   },
+  "dependencies": {
+    "@tailwindcss/vite": "^4.1.16",
+    "tailwindcss": "^4.1.16"
+  },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",