@float.js/core 2.0.1

package/dist/ai/index.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Float.js AI Module
+ * Native AI integration with streaming support
+ */
+interface AIProvider {
+    name: string;
+    chat(options: ChatOptions): Promise<AIResponse>;
+    stream(options: ChatOptions): AsyncIterable<string>;
+}
+interface ChatOptions {
+    model?: string;
+    messages: Message[];
+    temperature?: number;
+    maxTokens?: number;
+    system?: string;
+}
+interface Message {
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+}
+interface AIResponse {
+    content: string;
+    model: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+}
+/**
+ * OpenAI Provider
+ */
+declare class OpenAIProvider implements AIProvider {
+    name: string;
+    private apiKey;
+    private baseUrl;
+    constructor(options?: {
+        apiKey?: string;
+        baseUrl?: string;
+    });
+    chat(options: ChatOptions): Promise<AIResponse>;
+    stream(options: ChatOptions): AsyncIterable<string>;
+}
+/**
+ * Anthropic Provider
+ */
+declare class AnthropicProvider implements AIProvider {
+    name: string;
+    private apiKey;
+    private baseUrl;
+    constructor(options?: {
+        apiKey?: string;
+        baseUrl?: string;
+    });
+    chat(options: ChatOptions): Promise<AIResponse>;
+    stream(options: ChatOptions): AsyncIterable<string>;
+}
+/**
+ * AI Instance - Main entry point
+ */
+declare class FloatAI {
+    private providers;
+    private defaultProvider;
+    constructor();
+    register(provider: AIProvider): void;
+    use(name: string): this;
+    private getProvider;
+    /**
+     * Simple chat completion
+     */
+    chat(prompt: string, options?: Partial<ChatOptions>): Promise<string>;
+    /**
+     * Chat with message history
+     */
+    complete(options: ChatOptions): Promise<AIResponse>;
+    /**
+     * Stream chat completion
+     */
+    stream(prompt: string, options?: Partial<ChatOptions>): AsyncIterable<string>;
+    /**
+     * Stream with message history
+     */
+    streamChat(options: ChatOptions): AsyncIterable<string>;
+}
+declare const ai: FloatAI;
+/**
+ * Create a streaming response for API routes
+ */
+declare function streamResponse(iterable: AsyncIterable<string>, options?: {
+    headers?: Record<string, string>;
+}): Response;
+/**
+ * Create a Server-Sent Events response
+ */
+declare function sseResponse(iterable: AsyncIterable<string>, options?: {
+    headers?: Record<string, string>;
+}): Response;
+/**
+ * AI Action decorator for type-safe AI endpoints
+ */
+declare function aiAction<T extends Record<string, unknown>>(handler: (input: T) => Promise<string> | AsyncIterable<string>): (request: Request) => Promise<Response>;
+
+export { type AIProvider, type AIResponse, AnthropicProvider, type ChatOptions, type Message, OpenAIProvider, ai, aiAction, sseResponse, streamResponse };

package/dist/ai/index.js

@@ -0,0 +1,293 @@
+// src/ai/index.ts
+var OpenAIProvider = class {
+  name = "openai";
+  apiKey;
+  baseUrl;
+  constructor(options = {}) {
+    this.apiKey = options.apiKey || process.env.OPENAI_API_KEY || "";
+    this.baseUrl = options.baseUrl || "https://api.openai.com/v1";
+  }
+  async chat(options) {
+    const response = await fetch(`${this.baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify({
+        model: options.model || "gpt-4o-mini",
+        messages: options.system ? [{ role: "system", content: options.system }, ...options.messages] : options.messages,
+        temperature: options.temperature ?? 0.7,
+        max_tokens: options.maxTokens
+      })
+    });
+    const data = await response.json();
+    return {
+      content: data.choices[0].message.content,
+      model: data.model,
+      usage: data.usage ? {
+        promptTokens: data.usage.prompt_tokens,
+        completionTokens: data.usage.completion_tokens,
+        totalTokens: data.usage.total_tokens
+      } : void 0
+    };
+  }
+  async *stream(options) {
+    const response = await fetch(`${this.baseUrl}/chat/completions`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "Authorization": `Bearer ${this.apiKey}`
+      },
+      body: JSON.stringify({
+        model: options.model || "gpt-4o-mini",
+        messages: options.system ? [{ role: "system", content: options.system }, ...options.messages] : options.messages,
+        temperature: options.temperature ?? 0.7,
+        max_tokens: options.maxTokens,
+        stream: true
+      })
+    });
+    const reader = response.body?.getReader();
+    if (!reader) throw new Error("No response body");
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+      for (const line of lines) {
+        if (line.startsWith("data: ")) {
+          const data = line.slice(6);
+          if (data === "[DONE]") return;
+          try {
+            const parsed = JSON.parse(data);
+            const content = parsed.choices[0]?.delta?.content;
+            if (content) yield content;
+          } catch {
+          }
+        }
+      }
+    }
+  }
+};
+var AnthropicProvider = class {
+  name = "anthropic";
+  apiKey;
+  baseUrl;
+  constructor(options = {}) {
+    this.apiKey = options.apiKey || process.env.ANTHROPIC_API_KEY || "";
+    this.baseUrl = options.baseUrl || "https://api.anthropic.com/v1";
+  }
+  async chat(options) {
+    const response = await fetch(`${this.baseUrl}/messages`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey,
+        "anthropic-version": "2023-06-01"
+      },
+      body: JSON.stringify({
+        model: options.model || "claude-3-5-sonnet-20241022",
+        messages: options.messages.filter((m) => m.role !== "system"),
+        system: options.system || options.messages.find((m) => m.role === "system")?.content,
+        max_tokens: options.maxTokens || 4096,
+        temperature: options.temperature ?? 0.7
+      })
+    });
+    const data = await response.json();
+    return {
+      content: data.content[0].text,
+      model: data.model,
+      usage: data.usage ? {
+        promptTokens: data.usage.input_tokens,
+        completionTokens: data.usage.output_tokens,
+        totalTokens: data.usage.input_tokens + data.usage.output_tokens
+      } : void 0
+    };
+  }
+  async *stream(options) {
+    const response = await fetch(`${this.baseUrl}/messages`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        "x-api-key": this.apiKey,
+        "anthropic-version": "2023-06-01"
+      },
+      body: JSON.stringify({
+        model: options.model || "claude-3-5-sonnet-20241022",
+        messages: options.messages.filter((m) => m.role !== "system"),
+        system: options.system || options.messages.find((m) => m.role === "system")?.content,
+        max_tokens: options.maxTokens || 4096,
+        temperature: options.temperature ?? 0.7,
+        stream: true
+      })
+    });
+    const reader = response.body?.getReader();
+    if (!reader) throw new Error("No response body");
+    const decoder = new TextDecoder();
+    let buffer = "";
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      buffer += decoder.decode(value, { stream: true });
+      const lines = buffer.split("\n");
+      buffer = lines.pop() || "";
+      for (const line of lines) {
+        if (line.startsWith("data: ")) {
+          try {
+            const parsed = JSON.parse(line.slice(6));
+            if (parsed.type === "content_block_delta") {
+              yield parsed.delta.text;
+            }
+          } catch {
+          }
+        }
+      }
+    }
+  }
+};
+var FloatAI = class {
+  providers = /* @__PURE__ */ new Map();
+  defaultProvider = "openai";
+  constructor() {
+    if (process.env.OPENAI_API_KEY) {
+      this.register(new OpenAIProvider());
+      this.defaultProvider = "openai";
+    }
+    if (process.env.ANTHROPIC_API_KEY) {
+      this.register(new AnthropicProvider());
+      if (!process.env.OPENAI_API_KEY) {
+        this.defaultProvider = "anthropic";
+      }
+    }
+  }
+  register(provider) {
+    this.providers.set(provider.name, provider);
+  }
+  use(name) {
+    if (!this.providers.has(name)) {
+      throw new Error(`AI provider "${name}" not registered`);
+    }
+    this.defaultProvider = name;
+    return this;
+  }
+  getProvider() {
+    const provider = this.providers.get(this.defaultProvider);
+    if (!provider) {
+      throw new Error(`No AI provider configured. Set OPENAI_API_KEY or ANTHROPIC_API_KEY`);
+    }
+    return provider;
+  }
+  /**
+   * Simple chat completion
+   */
+  async chat(prompt, options = {}) {
+    const response = await this.getProvider().chat({
+      ...options,
+      messages: [{ role: "user", content: prompt }]
+    });
+    return response.content;
+  }
+  /**
+   * Chat with message history
+   */
+  async complete(options) {
+    return this.getProvider().chat(options);
+  }
+  /**
+   * Stream chat completion
+   */
+  stream(prompt, options = {}) {
+    return this.getProvider().stream({
+      ...options,
+      messages: [{ role: "user", content: prompt }]
+    });
+  }
+  /**
+   * Stream with message history
+   */
+  streamChat(options) {
+    return this.getProvider().stream(options);
+  }
+};
+var ai = new FloatAI();
+function streamResponse(iterable, options = {}) {
+  const encoder = new TextEncoder();
+  const stream = new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const chunk of iterable) {
+          controller.enqueue(encoder.encode(chunk));
+        }
+        controller.close();
+      } catch (error) {
+        controller.error(error);
+      }
+    }
+  });
+  return new Response(stream, {
+    headers: {
+      "Content-Type": "text/plain; charset=utf-8",
+      "Transfer-Encoding": "chunked",
+      "Cache-Control": "no-cache",
+      ...options.headers
+    }
+  });
+}
+function sseResponse(iterable, options = {}) {
+  const encoder = new TextEncoder();
+  const stream = new ReadableStream({
+    async start(controller) {
+      try {
+        for await (const chunk of iterable) {
+          controller.enqueue(encoder.encode(`data: ${JSON.stringify(chunk)}
+
+`));
+        }
+        controller.enqueue(encoder.encode("data: [DONE]\n\n"));
+        controller.close();
+      } catch (error) {
+        controller.error(error);
+      }
+    }
+  });
+  return new Response(stream, {
+    headers: {
+      "Content-Type": "text/event-stream",
+      "Cache-Control": "no-cache",
+      "Connection": "keep-alive",
+      ...options.headers
+    }
+  });
+}
+function aiAction(handler) {
+  return async (request) => {
+    try {
+      const input = await request.json();
+      const result = handler(input);
+      if (Symbol.asyncIterator in Object(result)) {
+        return streamResponse(result);
+      }
+      const content = await result;
+      return new Response(JSON.stringify({ content }), {
+        headers: { "Content-Type": "application/json" }
+      });
+    } catch (error) {
+      return new Response(
+        JSON.stringify({ error: error.message }),
+        { status: 500, headers: { "Content-Type": "application/json" } }
+      );
+    }
+  };
+}
+export {
+  AnthropicProvider,
+  OpenAIProvider,
+  ai,
+  aiAction,
+  sseResponse,
+  streamResponse
+};
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/ai/index.ts"],"sourcesContent":["/**\n * Float.js AI Module\n * Native AI integration with streaming support\n */\n\nexport interface AIProvider {\n  name: string;\n  chat(options: ChatOptions): Promise<AIResponse>;\n  stream(options: ChatOptions): AsyncIterable<string>;\n}\n\nexport interface ChatOptions {\n  model?: string;\n  messages: Message[];\n  temperature?: number;\n  maxTokens?: number;\n  system?: string;\n}\n\nexport interface Message {\n  role: 'user' | 'assistant' | 'system';\n  content: string;\n}\n\nexport interface AIResponse {\n  content: string;\n  model: string;\n  usage?: {\n    promptTokens: number;\n    completionTokens: number;\n    totalTokens: number;\n  };\n}\n\n/**\n * OpenAI Provider\n */\nexport class OpenAIProvider implements AIProvider {\n  name = 'openai';\n  private apiKey: string;\n  private baseUrl: string;\n\n  constructor(options: { apiKey?: string; baseUrl?: string } = {}) {\n    this.apiKey = options.apiKey || process.env.OPENAI_API_KEY || '';\n    this.baseUrl = options.baseUrl || 'https://api.openai.com/v1';\n  }\n\n  async chat(options: ChatOptions): Promise<AIResponse> {\n    const response = await fetch(`${this.baseUrl}/chat/completions`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify({\n        model: options.model || 'gpt-4o-mini',\n        messages: options.system \n          ? [{ role: 'system', content: options.system }, ...options.messages]\n          : options.messages,\n        temperature: options.temperature ?? 0.7,\n        max_tokens: options.maxTokens,\n      }),\n    });\n\n    const data = await response.json();\n    \n    return {\n      content: data.choices[0].message.content,\n      model: data.model,\n      usage: data.usage ? {\n        promptTokens: data.usage.prompt_tokens,\n        completionTokens: data.usage.completion_tokens,\n        totalTokens: data.usage.total_tokens,\n      } : undefined,\n    };\n  }\n\n  async *stream(options: ChatOptions): AsyncIterable<string> {\n    const response = await fetch(`${this.baseUrl}/chat/completions`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'Authorization': `Bearer ${this.apiKey}`,\n      },\n      body: JSON.stringify({\n        model: options.model || 'gpt-4o-mini',\n        messages: options.system \n          ? [{ role: 'system', content: options.system }, ...options.messages]\n          : options.messages,\n        temperature: options.temperature ?? 0.7,\n        max_tokens: options.maxTokens,\n        stream: true,\n      }),\n    });\n\n    const reader = response.body?.getReader();\n    if (!reader) throw new Error('No response body');\n\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() || '';\n\n      for (const line of lines) {\n        if (line.startsWith('data: ')) {\n          const data = line.slice(6);\n          if (data === '[DONE]') return;\n          \n          try {\n            const parsed = JSON.parse(data);\n            const content = parsed.choices[0]?.delta?.content;\n            if (content) yield content;\n          } catch {\n            // Skip invalid JSON\n          }\n        }\n      }\n    }\n  }\n}\n\n/**\n * Anthropic Provider\n */\nexport class AnthropicProvider implements AIProvider {\n  name = 'anthropic';\n  private apiKey: string;\n  private baseUrl: string;\n\n  constructor(options: { apiKey?: string; baseUrl?: string } = {}) {\n    this.apiKey = options.apiKey || process.env.ANTHROPIC_API_KEY || '';\n    this.baseUrl = options.baseUrl || 'https://api.anthropic.com/v1';\n  }\n\n  async chat(options: ChatOptions): Promise<AIResponse> {\n    const response = await fetch(`${this.baseUrl}/messages`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': this.apiKey,\n        'anthropic-version': '2023-06-01',\n      },\n      body: JSON.stringify({\n        model: options.model || 'claude-3-5-sonnet-20241022',\n        messages: options.messages.filter(m => m.role !== 'system'),\n        system: options.system || options.messages.find(m => m.role === 'system')?.content,\n        max_tokens: options.maxTokens || 4096,\n        temperature: options.temperature ?? 0.7,\n      }),\n    });\n\n    const data = await response.json();\n    \n    return {\n      content: data.content[0].text,\n      model: data.model,\n      usage: data.usage ? {\n        promptTokens: data.usage.input_tokens,\n        completionTokens: data.usage.output_tokens,\n        totalTokens: data.usage.input_tokens + data.usage.output_tokens,\n      } : undefined,\n    };\n  }\n\n  async *stream(options: ChatOptions): AsyncIterable<string> {\n    const response = await fetch(`${this.baseUrl}/messages`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        'x-api-key': this.apiKey,\n        'anthropic-version': '2023-06-01',\n      },\n      body: JSON.stringify({\n        model: options.model || 'claude-3-5-sonnet-20241022',\n        messages: options.messages.filter(m => m.role !== 'system'),\n        system: options.system || options.messages.find(m => m.role === 'system')?.content,\n        max_tokens: options.maxTokens || 4096,\n        temperature: options.temperature ?? 0.7,\n        stream: true,\n      }),\n    });\n\n    const reader = response.body?.getReader();\n    if (!reader) throw new Error('No response body');\n\n    const decoder = new TextDecoder();\n    let buffer = '';\n\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n\n      buffer += decoder.decode(value, { stream: true });\n      const lines = buffer.split('\\n');\n      buffer = lines.pop() || '';\n\n      for (const line of lines) {\n        if (line.startsWith('data: ')) {\n          try {\n            const parsed = JSON.parse(line.slice(6));\n            if (parsed.type === 'content_block_delta') {\n              yield parsed.delta.text;\n            }\n          } catch {\n            // Skip invalid JSON\n          }\n        }\n      }\n    }\n  }\n}\n\n/**\n * AI Instance - Main entry point\n */\nclass FloatAI {\n  private providers: Map<string, AIProvider> = new Map();\n  private defaultProvider: string = 'openai';\n\n  constructor() {\n    // Auto-register providers based on available API keys\n    if (process.env.OPENAI_API_KEY) {\n      this.register(new OpenAIProvider());\n      this.defaultProvider = 'openai';\n    }\n    if (process.env.ANTHROPIC_API_KEY) {\n      this.register(new AnthropicProvider());\n      if (!process.env.OPENAI_API_KEY) {\n        this.defaultProvider = 'anthropic';\n      }\n    }\n  }\n\n  register(provider: AIProvider): void {\n    this.providers.set(provider.name, provider);\n  }\n\n  use(name: string): this {\n    if (!this.providers.has(name)) {\n      throw new Error(`AI provider \"${name}\" not registered`);\n    }\n    this.defaultProvider = name;\n    return this;\n  }\n\n  private getProvider(): AIProvider {\n    const provider = this.providers.get(this.defaultProvider);\n    if (!provider) {\n      throw new Error(`No AI provider configured. Set OPENAI_API_KEY or ANTHROPIC_API_KEY`);\n    }\n    return provider;\n  }\n\n  /**\n   * Simple chat completion\n   */\n  async chat(prompt: string, options: Partial<ChatOptions> = {}): Promise<string> {\n    const response = await this.getProvider().chat({\n      ...options,\n      messages: [{ role: 'user', content: prompt }],\n    });\n    return response.content;\n  }\n\n  /**\n   * Chat with message history\n   */\n  async complete(options: ChatOptions): Promise<AIResponse> {\n    return this.getProvider().chat(options);\n  }\n\n  /**\n   * Stream chat completion\n   */\n  stream(prompt: string, options: Partial<ChatOptions> = {}): AsyncIterable<string> {\n    return this.getProvider().stream({\n      ...options,\n      messages: [{ role: 'user', content: prompt }],\n    });\n  }\n\n  /**\n   * Stream with message history\n   */\n  streamChat(options: ChatOptions): AsyncIterable<string> {\n    return this.getProvider().stream(options);\n  }\n}\n\n// Singleton instance\nexport const ai = new FloatAI();\n\n/**\n * Create a streaming response for API routes\n */\nexport function streamResponse(\n  iterable: AsyncIterable<string>,\n  options: { headers?: Record<string, string> } = {}\n): Response {\n  const encoder = new TextEncoder();\n  \n  const stream = new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const chunk of iterable) {\n          controller.enqueue(encoder.encode(chunk));\n        }\n        controller.close();\n      } catch (error) {\n        controller.error(error);\n      }\n    },\n  });\n\n  return new Response(stream, {\n    headers: {\n      'Content-Type': 'text/plain; charset=utf-8',\n      'Transfer-Encoding': 'chunked',\n      'Cache-Control': 'no-cache',\n      ...options.headers,\n    },\n  });\n}\n\n/**\n * Create a Server-Sent Events response\n */\nexport function sseResponse(\n  iterable: AsyncIterable<string>,\n  options: { headers?: Record<string, string> } = {}\n): Response {\n  const encoder = new TextEncoder();\n  \n  const stream = new ReadableStream({\n    async start(controller) {\n      try {\n        for await (const chunk of iterable) {\n          controller.enqueue(encoder.encode(`data: ${JSON.stringify(chunk)}\\n\\n`));\n        }\n        controller.enqueue(encoder.encode('data: [DONE]\\n\\n'));\n        controller.close();\n      } catch (error) {\n        controller.error(error);\n      }\n    },\n  });\n\n  return new Response(stream, {\n    headers: {\n      'Content-Type': 'text/event-stream',\n      'Cache-Control': 'no-cache',\n      'Connection': 'keep-alive',\n      ...options.headers,\n    },\n  });\n}\n\n/**\n * AI Action decorator for type-safe AI endpoints\n */\nexport function aiAction<T extends Record<string, unknown>>(\n  handler: (input: T) => Promise<string> | AsyncIterable<string>\n) {\n  return async (request: Request): Promise<Response> => {\n    try {\n      const input = await request.json() as T;\n      const result = handler(input);\n\n      if (Symbol.asyncIterator in Object(result)) {\n        return streamResponse(result as AsyncIterable<string>);\n      }\n\n      const content = await (result as Promise<string>);\n      return new Response(JSON.stringify({ content }), {\n        headers: { 'Content-Type': 'application/json' },\n      });\n    } catch (error) {\n      return new Response(\n        JSON.stringify({ error: (error as Error).message }),\n        { status: 500, headers: { 'Content-Type': 'application/json' } }\n      );\n    }\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/analytics/index.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Float.js - Built-in Analytics
+ *
+ * Zero-config privacy-focused analytics built into the framework.
+ * No external dependencies, no cookies, GDPR-compliant by default.
+ */
+interface PageView {
+    id: string;
+    timestamp: number;
+    pathname: string;
+    referrer?: string;
+    userAgent?: string;
+    country?: string;
+    device: 'desktop' | 'mobile' | 'tablet' | 'unknown';
+    browser: string;
+    os: string;
+    sessionId: string;
+    duration?: number;
+}
+interface WebVitals {
+    id: string;
+    timestamp: number;
+    pathname: string;
+    metrics: {
+        FCP?: number;
+        LCP?: number;
+        FID?: number;
+        CLS?: number;
+        TTFB?: number;
+        INP?: number;
+    };
+}
+interface CustomEvent {
+    id: string;
+    timestamp: number;
+    name: string;
+    pathname: string;
+    properties?: Record<string, string | number | boolean>;
+    sessionId: string;
+}
+interface AnalyticsData {
+    pageviews: PageView[];
+    vitals: WebVitals[];
+    events: CustomEvent[];
+}
+interface AnalyticsConfig {
+    /** Enable/disable analytics */
+    enabled: boolean;
+    /** Ignore paths (regex patterns) */
+    ignorePaths: (string | RegExp)[];
+    /** Max events in memory before flush */
+    maxBufferSize: number;
+    /** Flush interval in ms */
+    flushInterval: number;
+    /** Custom event handler */
+    onFlush?: (data: AnalyticsData) => Promise<void>;
+    /** Hash IP addresses for privacy */
+    hashIPs: boolean;
+    /** Track web vitals */
+    trackVitals: boolean;
+    /** Session timeout in minutes */
+    sessionTimeout: number;
+    /** GeoIP lookup */
+    geoIP: boolean;
+}
+interface AnalyticsSummary {
+    period: {
+        start: Date;
+        end: Date;
+    };
+    pageviews: {
+        total: number;
+        unique: number;
+        byPath: Record<string, number>;
+        byReferrer: Record<string, number>;
+        byDevice: Record<string, number>;
+        byBrowser: Record<string, number>;
+        byCountry: Record<string, number>;
+    };
+    vitals: {
+        avgFCP: number;
+        avgLCP: number;
+        avgFID: number;
+        avgCLS: number;
+        avgTTFB: number;
+        p75LCP: number;
+        p75FID: number;
+        p75CLS: number;
+    };
+    events: {
+        total: number;
+        byName: Record<string, number>;
+    };
+    sessions: {
+        total: number;
+        avgDuration: number;
+        bounceRate: number;
+    };
+}
+declare class AnalyticsEngine {
+    private config;
+    private buffer;
+    private flushTimer;
+    private sessions;
+    private allData;
+    constructor(config?: Partial<AnalyticsConfig>);
+    private startFlushTimer;
+    private shouldIgnore;
+    private getOrCreateSession;
+    /**
+     * Track a page view
+     */
+    trackPageview(req: Request, options?: {
+        country?: string;
+    }): PageView | null;
+    /**
+     * Track Web Vitals
+     */
+    trackVitals(pathname: string, metrics: WebVitals['metrics']): WebVitals | null;
+    /**
+     * Track custom event
+     */
+    trackEvent(name: string, properties?: Record<string, string | number | boolean>, req?: Request): CustomEvent | null;
+    private checkBufferSize;
+    /**
+     * Flush buffer to storage/handler
+     */
+    flush(): Promise<void>;
+    /**
+     * Get analytics summary
+     */
+    getSummary(startDate?: Date, endDate?: Date): AnalyticsSummary;
+    /**
+     * Get real-time stats (last 5 minutes)
+     */
+    getRealtime(): {
+        activeUsers: number;
+        pageviews: number;
+        topPages: Array<{
+            path: string;
+            count: number;
+        }>;
+    };
+    /**
+     * Export data as JSON
+     */
+    exportData(): AnalyticsData;
+    /**
+     * Clear all analytics data
+     */
+    clearData(): void;
+    /**
+     * Stop the analytics engine
+     */
+    stop(): void;
+}
+interface AnalyticsMiddlewareOptions {
+    config?: Partial<AnalyticsConfig>;
+    getCountry?: (req: Request) => string | undefined;
+}
+/**
+ * Get or create analytics engine
+ */
+declare function getAnalytics(config?: Partial<AnalyticsConfig>): AnalyticsEngine;
+/**
+ * Configure analytics
+ */
+declare function configureAnalytics(config: Partial<AnalyticsConfig>): AnalyticsEngine;
+/**
+ * Create analytics middleware
+ */
+declare function createAnalyticsMiddleware(options?: AnalyticsMiddlewareOptions): (req: Request, next: () => Promise<Response>) => Promise<Response>;
+/**
+ * Create analytics API handler
+ */
+declare function createAnalyticsHandler(): (req: Request) => Promise<Response>;
+declare const analyticsClientScript = "\n<script>\n(function() {\n  // Simple Web Vitals reporter\n  const endpoint = '/__float/analytics?action=vitals';\n  \n  function sendVitals(metrics) {\n    const body = JSON.stringify({\n      pathname: window.location.pathname,\n      metrics: metrics\n    });\n    \n    if (navigator.sendBeacon) {\n      navigator.sendBeacon(endpoint, body);\n    } else {\n      fetch(endpoint, { method: 'POST', body, keepalive: true });\n    }\n  }\n\n  // Observe LCP\n  if ('PerformanceObserver' in window) {\n    const vitals = {};\n    \n    // LCP\n    new PerformanceObserver((list) => {\n      const entries = list.getEntries();\n      const lastEntry = entries[entries.length - 1];\n      vitals.LCP = Math.round(lastEntry.startTime);\n    }).observe({ type: 'largest-contentful-paint', buffered: true });\n    \n    // FCP\n    new PerformanceObserver((list) => {\n      const entries = list.getEntries();\n      vitals.FCP = Math.round(entries[0].startTime);\n    }).observe({ type: 'paint', buffered: true });\n    \n    // CLS\n    let clsValue = 0;\n    new PerformanceObserver((list) => {\n      for (const entry of list.getEntries()) {\n        if (!entry.hadRecentInput) {\n          clsValue += entry.value;\n        }\n      }\n      vitals.CLS = clsValue;\n    }).observe({ type: 'layout-shift', buffered: true });\n    \n    // Send on page hide\n    document.addEventListener('visibilitychange', () => {\n      if (document.visibilityState === 'hidden') {\n        sendVitals(vitals);\n      }\n    });\n  }\n})();\n</script>\n";
+declare const analytics: {
+    engine: typeof getAnalytics;
+    configure: typeof configureAnalytics;
+    createMiddleware: typeof createAnalyticsMiddleware;
+    createHandler: typeof createAnalyticsHandler;
+    clientScript: string;
+    track: {
+        pageview: (req: Request, options?: {
+            country?: string;
+        }) => PageView | null;
+        event: (name: string, properties?: Record<string, string | number | boolean>, req?: Request) => CustomEvent | null;
+        vitals: (pathname: string, metrics: WebVitals["metrics"]) => WebVitals | null;
+    };
+};
+
+export { type AnalyticsConfig, type AnalyticsData, AnalyticsEngine, type AnalyticsMiddlewareOptions, type AnalyticsSummary, type CustomEvent, type PageView, type WebVitals, analytics, analyticsClientScript, configureAnalytics, createAnalyticsHandler, createAnalyticsMiddleware, analytics as default, getAnalytics };