npm - locallytics - Versions diffs - 0.0.1-beta.1 - Mend

locallytics 0.0.1-beta.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (38) hide show

package/README.md +499 -0
package/dist/cli/index.d.ts +3 -0
package/dist/cli/index.d.ts.map +1 -0
package/dist/cli/index.js +71 -0
package/dist/cli/index.js.map +1 -0
package/dist/src/client/index.d.ts +3 -0
package/dist/src/client/index.d.ts.map +1 -0
package/dist/src/client/index.js +41 -0
package/dist/src/client/index.js.map +1 -0
package/dist/src/db/index.d.ts +4 -0
package/dist/src/db/index.d.ts.map +1 -0
package/dist/src/db/index.js +26 -0
package/dist/src/db/index.js.map +1 -0
package/dist/src/db/postgres.d.ts +11 -0
package/dist/src/db/postgres.d.ts.map +1 -0
package/dist/src/db/postgres.js +63 -0
package/dist/src/db/postgres.js.map +1 -0
package/dist/src/db/sqlite.d.ts +11 -0
package/dist/src/db/sqlite.d.ts.map +1 -0
package/dist/src/db/sqlite.js +64 -0
package/dist/src/db/sqlite.js.map +1 -0
package/dist/src/index.d.ts +5 -0
package/dist/src/index.d.ts.map +1 -0
package/dist/src/index.js +4 -0
package/dist/src/index.js.map +1 -0
package/dist/src/server/data.d.ts +3 -0
package/dist/src/server/data.d.ts.map +1 -0
package/dist/src/server/data.js +36 -0
package/dist/src/server/data.js.map +1 -0
package/dist/src/server/handler.d.ts +5 -0
package/dist/src/server/handler.d.ts.map +1 -0
package/dist/src/server/handler.js +40 -0
package/dist/src/server/handler.js.map +1 -0
package/dist/src/types/index.d.ts +34 -0
package/dist/src/types/index.d.ts.map +1 -0
package/dist/src/types/index.js +2 -0
package/dist/src/types/index.js.map +1 -0
package/package.json +62 -0

package/README.md ADDED Viewed

@@ -0,0 +1,499 @@
+# Locallytics
+Self-hosted, privacy-first analytics for any JavaScript framework.
+- **Privacy-first** — No cookies, respects Do Not Track
+- **Self-hosted** — Your data in your database (PostgreSQL or SQLite)
+- **Framework-agnostic** — Works with Next.js, Remix, Express, Hono, etc.
+- **Simple** — Two main functions: `LocallyticsGrabber` and `LocallyticsData`
+- **Multiple formats** — Export analytics as JSON or CSV
+## Quick Start
+### 1. Install
+```bash
+npm install locallytics
+```
+### 2. Migrate Database
+Set your database URL and run migrations:
+```bash
+export DATABASE_URL="postgres://user:pass@localhost/db"
+# or
+export DATABASE_URL="./analytics.db"
+npx locallytics migrate
+```
+### 3. Create API Handler
+The handler uses Web Standard `Request`/`Response` - works in any framework.
+**Next.js:**
+```typescript
+// app/api/analytics/route.ts
+import { createHandler } from "locallytics";
+const handler = await createHandler({
+  database: process.env.DATABASE_URL!,
+});
+export const POST = handler.POST;
+```
+**Express:**
+```javascript
+import express from "express";
+import { createHandler } from "locallytics";
+const app = express();
+const analytics = await createHandler({
+  database: process.env.DATABASE_URL,
+});
+app.post("/api/analytics", async (req, res) => {
+  const response = await analytics.POST(req);
+  res.status(response.status).send(await response.text());
+});
+```
+**Hono:**
+```typescript
+import { Hono } from "hono";
+import { createHandler } from "locallytics";
+const app = new Hono();
+const analytics = await createHandler({
+  database: process.env.DATABASE_URL!,
+});
+app.post("/api/analytics", (c) => analytics.POST(c.req.raw));
+```
+### 4. Add Client Tracker
+Call `LocallyticsGrabber()` on page load to track pageviews.
+**Next.js (React):**
+```tsx
+// app/layout.tsx
+"use client";
+import { LocallyticsGrabber } from "locallytics/client";
+import { useEffect } from "react";
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    LocallyticsGrabber();
+  }, []);
+  return (
+    <html>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+**Vanilla JavaScript:**
+```html
+<script type="module">
+  import { LocallyticsGrabber } from "/node_modules/locallytics/dist/client/index.js";
+  LocallyticsGrabber();
+</script>
+```
+### 5. View Analytics
+Query analytics data on the server:
+```typescript
+// app/dashboard/page.tsx (Next.js)
+import { LocallyticsData } from "locallytics";
+export default async function Dashboard() {
+  const data = await LocallyticsData(
+    process.env.DATABASE_URL!,
+    "last7d" // "last24h" | "last7d" | "last30d"
+  );
+  return (
+    <div>
+      <p>{data.pageviews} pageviews</p>
+      <p>{data.uniqueVisitors} visitors</p>
+    </div>
+  );
+}
+```
+---
+## API Reference
+### `LocallyticsGrabber(options?)`
+Client-side function that tracks pageviews in the browser.
+**Usage:**
+```typescript
+import { LocallyticsGrabber } from "locallytics/client";
+LocallyticsGrabber({
+  endpoint: "/api/analytics", // default
+});
+```
+**Options:**
+| Option     | Type     | Default            | Description                    |
+| ---------- | -------- | ------------------ | ------------------------------ |
+| `endpoint` | `string` | `"/api/analytics"` | API endpoint to send data to   |
+**Data Collected:**
+Each pageview sends:
+- `pageUrl` — Current path
+- `referrer` — Where user came from
+- `sessionId` — Anonymous ID (localStorage)
+- `timestamp` — ISO timestamp
+**Privacy Features:**
+- **No cookies** — Uses localStorage only
+- **Respects DNT** — Tracking disabled when Do Not Track is on
+- **No PII** — Anonymous session IDs only
+---
+### `createHandler(config)`
+Creates API route handlers for receiving tracking data.
+**Usage:**
+```typescript
+import { createHandler } from "locallytics";
+const handler = await createHandler({
+  database: process.env.DATABASE_URL!,
+});
+export const POST = handler.POST;
+```
+**Config:**
+| Option     | Type     | Required | Description                    |
+| ---------- | -------- | -------- | ------------------------------ |
+| `database` | `string` | Yes      | Database connection string     |
+**Returns:**
+Object with a `POST` method that accepts Web Standard `Request` and returns `Response`.
+**Response Codes:**
+- `201` — Pageview recorded successfully
+- `204` — Tracking skipped (DNT enabled)
+- `400` — Invalid payload
+- `500` — Server error
+---
+### `LocallyticsData(databaseUrl, range, format?)`
+Queries analytics data from the database.
+**Usage:**
+```typescript
+import { LocallyticsData } from "locallytics";
+// Get JSON data (default)
+const data = await LocallyticsData(
+  process.env.DATABASE_URL!,
+  "last7d"
+);
+console.log(data.pageviews, data.uniqueVisitors);
+// Get CSV data
+const csv = await LocallyticsData(
+  process.env.DATABASE_URL!,
+  "last7d",
+  "csv"
+);
+console.log(csv); // CSV formatted string
+```
+**Parameters:**
+| Parameter     | Type                              | Required | Description                    |
+| ------------- | --------------------------------- | -------- | ------------------------------ |
+| `databaseUrl` | `string`                          | Yes      | Database connection string     |
+| `range`       | `"last24h"` \| `"last7d"` \| `"last30d"` | Yes      | Date range to query            |
+| `format`      | `"json"` \| `"csv"`               | No       | Output format (default: `"json"`) |
+**Returns (JSON format):**
+```typescript
+{
+  pageviews: number;          // Total pageviews
+  uniqueVisitors: number;     // Unique sessions
+  topPages: Array<{
+    page: string;             // Page URL
+    count: number;            // View count
+  }>;                         // Top 10 pages
+  dailyStats: Array<{
+    date: string;             // YYYY-MM-DD
+    views: number;            // Views that day
+  }>;
+}
+```
+**Returns (CSV format):**
+String with CSV formatted data including summary, top pages, and daily stats.
+---
+## CLI Commands
+### `migrate`
+Creates or updates database tables.
+```bash
+export DATABASE_URL="postgres://user:pass@localhost/db"
+npx locallytics migrate
+```
+### `reset`
+Drops and recreates all tables. **WARNING: This destroys all data!**
+```bash
+export DATABASE_URL="postgres://user:pass@localhost/db"
+npx locallytics reset
+```
+### `help`
+Shows available commands.
+```bash
+npx locallytics help
+```
+---
+## Database Support
+Locallytics supports PostgreSQL and SQLite. The database type is detected automatically from the connection string.
+### PostgreSQL
+**Connection String Format:**
+```
+postgres://user:password@host:port/database
+postgresql://user:password@host:port/database
+```
+**Example:**
+```bash
+export DATABASE_URL="postgres://myuser:mypass@localhost:5432/analytics"
+npx locallytics migrate
+```
+**Requirements:**
+- Install `pg` peer dependency: `npm install pg`
+### SQLite
+**Connection String Format:**
+```
+./path/to/database.db
+/absolute/path/to/database.db
+sqlite:///path/to/database.db
+```
+**Example:**
+```bash
+export DATABASE_URL="./analytics.db"
+npx locallytics migrate
+```
+**Requirements:**
+- Install `better-sqlite3` peer dependency: `npm install better-sqlite3`
+---
+## Privacy Features
+Locallytics is designed with privacy in mind:
+### No Cookies
+Uses localStorage for session IDs instead of cookies. No cookie banners required.
+### Respects Do Not Track
+When a user has Do Not Track (DNT) enabled in their browser:
+- Client-side tracker won't send data
+- Server-side handler won't record data
+### No Personal Information
+Only collects:
+- Page URLs
+- Referrer URLs
+- Anonymous session IDs (random UUIDs)
+- Timestamps
+No IP addresses, user agents, or any identifying information.
+### Self-Hosted
+All data stays in your database. No third-party services involved.
+---
+## Framework Examples
+### Next.js (App Router)
+See [examples/nextjs](./examples/nextjs) for complete example.
+**API Route:**
+```typescript
+// app/api/analytics/route.ts
+import { createHandler } from "locallytics";
+const handler = await createHandler({
+  database: process.env.DATABASE_URL!,
+});
+export const POST = handler.POST;
+```
+**Layout (Client Component):**
+```tsx
+// app/layout.tsx
+"use client";
+import { LocallyticsGrabber } from "locallytics/client";
+import { useEffect } from "react";
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  useEffect(() => {
+    LocallyticsGrabber();
+  }, []);
+  return (
+    <html>
+      <body>{children}</body>
+    </html>
+  );
+}
+```
+**Dashboard (Server Component):**
+```tsx
+// app/dashboard/page.tsx
+import { LocallyticsData } from "locallytics";
+export default async function Dashboard() {
+  const data = await LocallyticsData(process.env.DATABASE_URL!, "last7d");
+  return (
+    <div>
+      <h1>Analytics</h1>
+      <p>Pageviews: {data.pageviews}</p>
+      <p>Unique Visitors: {data.uniqueVisitors}</p>
+      <h2>Top Pages</h2>
+      <ul>
+        {data.topPages.map((page) => (
+          <li key={page.page}>
+            {page.page}: {page.count} views
+          </li>
+        ))}
+      </ul>
+    </div>
+  );
+}
+```
+### Express
+See [examples/express](./examples/express) for complete example.
+```javascript
+import express from "express";
+import { createHandler, LocallyticsData } from "locallytics";
+const app = express();
+const analytics = await createHandler({
+  database: process.env.DATABASE_URL,
+});
+app.post("/api/analytics", async (req, res) => {
+  const response = await analytics.POST(req);
+  res.status(response.status).send(await response.text());
+});
+app.get("/dashboard", async (req, res) => {
+  const data = await LocallyticsData(process.env.DATABASE_URL, "last7d");
+  res.json(data);
+});
+app.listen(3000);
+```
+### Remix
+```typescript
+// app/routes/api.analytics.ts
+import type { ActionFunction } from "@remix-run/node";
+import { createHandler } from "locallytics";
+const handler = await createHandler({
+  database: process.env.DATABASE_URL!,
+});
+export const action: ActionFunction = async ({ request }) => {
+  return handler.POST(request);
+};
+```
+### Hono
+```typescript
+import { Hono } from "hono";
+import { createHandler } from "locallytics";
+const app = new Hono();
+const analytics = await createHandler({
+  database: process.env.DATABASE_URL!,
+});
+app.post("/api/analytics", (c) => analytics.POST(c.req.raw));
+```
+---
+## TypeScript
+Locallytics is written in TypeScript and includes full type definitions.
+```typescript
+import type {
+  DateRange,
+  DataFormat,
+  AnalyticsResult,
+  GrabberOptions,
+  HandlerConfig,
+} from "locallytics";
+```
+---
+## License
+MIT

package/dist/cli/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js ADDED Viewed

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { createAdapter } from "../src/db/index.js";
+const commands = {
+    migrate: async () => {
+        const databaseUrl = process.env.DATABASE_URL;
+        if (!databaseUrl) {
+            console.error("❌ DATABASE_URL environment variable is required");
+            process.exit(1);
+        }
+        console.log("🔄 Running migration...");
+        try {
+            const adapter = await createAdapter(databaseUrl);
+            await adapter.migrate();
+            adapter.close();
+            console.log("✅ Migration completed successfully");
+        }
+        catch (error) {
+            console.error("❌ Migration failed:", error);
+            process.exit(1);
+        }
+    },
+    reset: async () => {
+        const databaseUrl = process.env.DATABASE_URL;
+        if (!databaseUrl) {
+            console.error("❌ DATABASE_URL environment variable is required");
+            process.exit(1);
+        }
+        console.log("⚠️  WARNING: This will delete all analytics data!");
+        console.log("🔄 Resetting database...");
+        try {
+            const adapter = await createAdapter(databaseUrl);
+            await adapter.reset();
+            adapter.close();
+            console.log("✅ Database reset successfully");
+        }
+        catch (error) {
+            console.error("❌ Reset failed:", error);
+            process.exit(1);
+        }
+    },
+    help: () => {
+        console.log(`
+Locallytics CLI - Database management tool
+Usage:
+  locallytics <command>
+Commands:
+  migrate    Create or update database tables
+  reset      Drop and recreate all tables (destroys data!)
+  help       Show this help message
+Environment Variables:
+  DATABASE_URL    Database connection string (required)
+Examples:
+  export DATABASE_URL="postgres://user:pass@localhost/db"
+  locallytics migrate
+  export DATABASE_URL="./analytics.db"
+  locallytics migrate
+    `);
+    },
+};
+const command = process.argv[2];
+if (!command || !commands[command]) {
+    commands.help();
+    process.exit(command ? 1 : 0);
+}
+commands[command]();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,QAAQ,GAAG;IACf,OAAO,EAAE,KAAK,IAAI,EAAE;QAClB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAE7C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,oCAAoC,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;YAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,KAAK,EAAE,KAAK,IAAI,EAAE;QAChB,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;QAE7C,IAAI,CAAC,WAAW,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAC;YACjE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,mDAAmD,CAAC,CAAC;QACjE,OAAO,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC;QAExC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;YACjD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC;YACtB,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,GAAG,CAAC,+BAA+B,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;YACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,IAAI,EAAE,GAAG,EAAE;QACT,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;KAoBX,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAA0B,CAAC;AAEzD,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,QAAQ,CAAC,IAAI,EAAE,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChC,CAAC;AAED,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC"}

package/dist/src/client/index.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { GrabberOptions } from "../types/index.js";
+export declare function LocallyticsGrabber(options?: GrabberOptions): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/client/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAmBxD,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,cAAmB,GAAG,IAAI,CA2BrE"}

package/dist/src/client/index.js ADDED Viewed

@@ -0,0 +1,41 @@
+function getSessionId() {
+    const key = "_locallytics_sid";
+    let sessionId = localStorage.getItem(key);
+    if (!sessionId) {
+        sessionId = crypto.randomUUID();
+        localStorage.setItem(key, sessionId);
+    }
+    return sessionId;
+}
+function respectsDNT() {
+    const dnt = navigator.doNotTrack || window.doNotTrack || navigator.msDoNotTrack;
+    return dnt === "1" || dnt === "yes";
+}
+export function LocallyticsGrabber(options = {}) {
+    if (typeof window === "undefined")
+        return;
+    if (respectsDNT())
+        return;
+    const endpoint = options.endpoint || "/api/analytics";
+    const payload = {
+        pageUrl: window.location.pathname + window.location.search,
+        referrer: document.referrer || null,
+        sessionId: getSessionId(),
+        timestamp: new Date().toISOString(),
+    };
+    const blob = new Blob([JSON.stringify(payload)], { type: "application/json" });
+    if (navigator.sendBeacon) {
+        navigator.sendBeacon(endpoint, blob);
+    }
+    else {
+        fetch(endpoint, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify(payload),
+            keepalive: true,
+        }).catch(() => {
+            // Silently fail if tracking request fails
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/client/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAEA,SAAS,YAAY;IACnB,MAAM,GAAG,GAAG,kBAAkB,CAAC;IAC/B,IAAI,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAE1C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,SAAS,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;QAChC,YAAY,CAAC,OAAO,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;IACvC,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,WAAW;IAClB,MAAM,GAAG,GAAG,SAAS,CAAC,UAAU,IAAK,MAAc,CAAC,UAAU,IAAK,SAAiB,CAAC,YAAY,CAAC;IAClG,OAAO,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,KAAK,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,UAA0B,EAAE;IAC7D,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IAC1C,IAAI,WAAW,EAAE;QAAE,OAAO;IAE1B,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,gBAAgB,CAAC;IAEtD,MAAM,OAAO,GAAG;QACd,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM;QAC1D,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,IAAI;QACnC,SAAS,EAAE,YAAY,EAAE;QACzB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAC;IAE/E,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;QACzB,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACvC,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,QAAQ,EAAE;YACd,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;YAC7B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACZ,0CAA0C;QAC5C,CAAC,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/dist/src/db/index.d.ts ADDED Viewed

@@ -0,0 +1,4 @@
+import type { DatabaseAdapter, DateRange } from "../types/index.js";
+export declare function createAdapter(databaseUrl: string): Promise<DatabaseAdapter>;
+export declare function getDateCutoff(range: DateRange): Date;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/db/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/db/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEpE,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAejF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAapD"}

package/dist/src/db/index.js ADDED Viewed

@@ -0,0 +1,26 @@
+export async function createAdapter(databaseUrl) {
+    if (databaseUrl.startsWith("postgres://") || databaseUrl.startsWith("postgresql://")) {
+        const { PostgresAdapter } = await import("./postgres.js");
+        return new PostgresAdapter(databaseUrl);
+    }
+    if (databaseUrl.endsWith(".db") || databaseUrl.endsWith(".sqlite") || databaseUrl.startsWith("sqlite://")) {
+        const { SQLiteAdapter } = await import("./sqlite.js");
+        const path = databaseUrl.replace("sqlite://", "");
+        return new SQLiteAdapter(path);
+    }
+    throw new Error(`Unsupported database URL: ${databaseUrl}. Supported formats: postgres://, sqlite:// or .db/.sqlite file path`);
+}
+export function getDateCutoff(range) {
+    const now = new Date();
+    switch (range) {
+        case "last24h":
+            return new Date(now.getTime() - 24 * 60 * 60 * 1000);
+        case "last7d":
+            return new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000);
+        case "last30d":
+            return new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000);
+        default:
+            throw new Error(`Invalid date range: ${range}`);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/src/db/index.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/db/index.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB;IACrD,IAAI,WAAW,CAAC,UAAU,CAAC,aAAa,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,eAAe,CAAC,EAAE,CAAC;QACrF,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1D,OAAO,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,WAAW,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC1G,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAClD,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM,IAAI,KAAK,CACb,6BAA6B,WAAW,sEAAsE,CAC/G,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAgB;IAC5C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,SAAS;YACZ,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QACvD,KAAK,QAAQ;YACX,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC3D,KAAK,SAAS;YACZ,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;QAC5D;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,KAAK,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC"}

package/dist/src/db/postgres.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import type { DatabaseAdapter, PageviewPayload, AnalyticsResult } from "../types/index.js";
+export declare class PostgresAdapter implements DatabaseAdapter {
+    private pool;
+    constructor(connectionString: string);
+    insert(data: PageviewPayload): Promise<void>;
+    query(since: Date): Promise<AnalyticsResult>;
+    migrate(): Promise<void>;
+    reset(): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=postgres.d.ts.map

package/dist/src/db/postgres.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"postgres.d.ts","sourceRoot":"","sources":["../../../src/db/postgres.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiB3F,qBAAa,eAAgB,YAAW,eAAe;IACrD,OAAO,CAAC,IAAI,CAAU;gBAEV,gBAAgB,EAAE,MAAM;IAI9B,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IAwC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,IAAI;CAGd"}

package/dist/src/db/postgres.js ADDED Viewed

@@ -0,0 +1,63 @@
+import pg from "pg";
+const { Pool } = pg;
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS pageviews (
+  id SERIAL PRIMARY KEY,
+  page_url TEXT NOT NULL,
+  referrer TEXT,
+  session_id TEXT NOT NULL,
+  created_at TIMESTAMP NOT NULL DEFAULT NOW()
+);
+CREATE INDEX IF NOT EXISTS idx_pageviews_created_at ON pageviews(created_at);
+CREATE INDEX IF NOT EXISTS idx_pageviews_session_id ON pageviews(session_id);
+`;
+export class PostgresAdapter {
+    pool;
+    constructor(connectionString) {
+        this.pool = new Pool({ connectionString });
+    }
+    async insert(data) {
+        await this.pool.query("INSERT INTO pageviews (page_url, referrer, session_id, created_at) VALUES ($1, $2, $3, $4)", [data.pageUrl, data.referrer, data.sessionId, new Date(data.timestamp)]);
+    }
+    async query(since) {
+        const [pageviewsResult, visitorsResult, topPagesResult, dailyStatsResult] = await Promise.all([
+            this.pool.query("SELECT COUNT(*) as count FROM pageviews WHERE created_at >= $1", [since]),
+            this.pool.query("SELECT COUNT(DISTINCT session_id) as count FROM pageviews WHERE created_at >= $1", [since]),
+            this.pool.query(`SELECT page_url as page, COUNT(*) as count
+         FROM pageviews
+         WHERE created_at >= $1
+         GROUP BY page_url
+         ORDER BY count DESC
+         LIMIT 10`, [since]),
+            this.pool.query(`SELECT DATE(created_at) as date, COUNT(*) as views
+         FROM pageviews
+         WHERE created_at >= $1
+         GROUP BY DATE(created_at)
+         ORDER BY date ASC`, [since]),
+        ]);
+        return {
+            pageviews: Number(pageviewsResult.rows[0].count),
+            uniqueVisitors: Number(visitorsResult.rows[0].count),
+            topPages: topPagesResult.rows.map((row) => ({
+                page: row.page,
+                count: Number(row.count),
+            })),
+            dailyStats: dailyStatsResult.rows.map((row) => ({
+                date: row.date.toISOString().split("T")[0],
+                views: Number(row.views),
+            })),
+        };
+    }
+    async migrate() {
+        await this.pool.query(SCHEMA);
+    }
+    async reset() {
+        await this.pool.query("DROP TABLE IF EXISTS pageviews CASCADE");
+        await this.migrate();
+    }
+    close() {
+        this.pool.end();
+    }
+}
+//# sourceMappingURL=postgres.js.map

package/dist/src/db/postgres.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../../src/db/postgres.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AAGpB,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAEpB,MAAM,MAAM,GAAG;;;;;;;;;;;CAWd,CAAC;AAEF,MAAM,OAAO,eAAe;IAClB,IAAI,CAAU;IAEtB,YAAY,gBAAwB;QAClC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAqB;QAChC,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CACnB,4FAA4F,EAC5F,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CACxE,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAW;QACrB,MAAM,CAAC,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,gBAAgB,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YAC5F,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,gEAAgE,EAAE,CAAC,KAAK,CAAC,CAAC;YAC1F,IAAI,CAAC,IAAI,CAAC,KAAK,CACb,kFAAkF,EAClF,CAAC,KAAK,CAAC,CACR;YACD,IAAI,CAAC,IAAI,CAAC,KAAK,CACb;;;;;kBAKU,EACV,CAAC,KAAK,CAAC,CACR;YACD,IAAI,CAAC,IAAI,CAAC,KAAK,CACb;;;;2BAImB,EACnB,CAAC,KAAK,CAAC,CACR;SACF,CAAC,CAAC;QAEH,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YAChD,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;YACpD,QAAQ,EAAE,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC1C,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;aACzB,CAAC,CAAC;YACH,UAAU,EAAE,gBAAgB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;gBAC9C,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC1C,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;aACzB,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAChE,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/src/db/sqlite.d.ts ADDED Viewed

@@ -0,0 +1,11 @@
+import type { DatabaseAdapter, PageviewPayload, AnalyticsResult } from "../types/index.js";
+export declare class SQLiteAdapter implements DatabaseAdapter {
+    private db;
+    constructor(path: string);
+    insert(data: PageviewPayload): Promise<void>;
+    query(since: Date): Promise<AnalyticsResult>;
+    migrate(): Promise<void>;
+    reset(): Promise<void>;
+    close(): void;
+}
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/src/db/sqlite.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../../src/db/sqlite.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAe3F,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,EAAE,CAAoB;gBAElB,IAAI,EAAE,MAAM;IAIlB,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAO5C,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC;IAwC5C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,KAAK,IAAI,IAAI;CAGd"}

package/dist/src/db/sqlite.js ADDED Viewed

@@ -0,0 +1,64 @@
+import Database from "better-sqlite3";
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS pageviews (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  page_url TEXT NOT NULL,
+  referrer TEXT,
+  session_id TEXT NOT NULL,
+  created_at DATETIME NOT NULL DEFAULT CURRENT_TIMESTAMP
+);
+CREATE INDEX IF NOT EXISTS idx_pageviews_created_at ON pageviews(created_at);
+CREATE INDEX IF NOT EXISTS idx_pageviews_session_id ON pageviews(session_id);
+`;
+export class SQLiteAdapter {
+    db;
+    constructor(path) {
+        this.db = new Database(path);
+    }
+    async insert(data) {
+        const stmt = this.db.prepare("INSERT INTO pageviews (page_url, referrer, session_id, created_at) VALUES (?, ?, ?, ?)");
+        stmt.run(data.pageUrl, data.referrer, data.sessionId, new Date(data.timestamp).toISOString());
+    }
+    async query(since) {
+        const sinceISO = since.toISOString();
+        const pageviews = this.db
+            .prepare("SELECT COUNT(*) as count FROM pageviews WHERE created_at >= ?")
+            .get(sinceISO);
+        const uniqueVisitors = this.db
+            .prepare("SELECT COUNT(DISTINCT session_id) as count FROM pageviews WHERE created_at >= ?")
+            .get(sinceISO);
+        const topPages = this.db
+            .prepare(`SELECT page_url as page, COUNT(*) as count
+         FROM pageviews
+         WHERE created_at >= ?
+         GROUP BY page_url
+         ORDER BY count DESC
+         LIMIT 10`)
+            .all(sinceISO);
+        const dailyStats = this.db
+            .prepare(`SELECT DATE(created_at) as date, COUNT(*) as views
+         FROM pageviews
+         WHERE created_at >= ?
+         GROUP BY DATE(created_at)
+         ORDER BY date ASC`)
+            .all(sinceISO);
+        return {
+            pageviews: pageviews.count,
+            uniqueVisitors: uniqueVisitors.count,
+            topPages,
+            dailyStats,
+        };
+    }
+    async migrate() {
+        this.db.exec(SCHEMA);
+    }
+    async reset() {
+        this.db.exec("DROP TABLE IF EXISTS pageviews");
+        await this.migrate();
+    }
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/src/db/sqlite.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../../src/db/sqlite.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAGtC,MAAM,MAAM,GAAG;;;;;;;;;;;CAWd,CAAC;AAEF,MAAM,OAAO,aAAa;IAChB,EAAE,CAAoB;IAE9B,YAAY,IAAY;QACtB,IAAI,CAAC,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,IAAqB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAC1B,wFAAwF,CACzF,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAChG,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,KAAW;QACrB,MAAM,QAAQ,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;QAErC,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE;aACtB,OAAO,CAAC,+DAA+D,CAAC;aACxE,GAAG,CAAC,QAAQ,CAAsB,CAAC;QAEtC,MAAM,cAAc,GAAG,IAAI,CAAC,EAAE;aAC3B,OAAO,CAAC,iFAAiF,CAAC;aAC1F,GAAG,CAAC,QAAQ,CAAsB,CAAC;QAEtC,MAAM,QAAQ,GAAG,IAAI,CAAC,EAAE;aACrB,OAAO,CACN;;;;;kBAKU,CACX;aACA,GAAG,CAAC,QAAQ,CAA2C,CAAC;QAE3D,MAAM,UAAU,GAAG,IAAI,CAAC,EAAE;aACvB,OAAO,CACN;;;;2BAImB,CACpB;aACA,GAAG,CAAC,QAAQ,CAA2C,CAAC;QAE3D,OAAO;YACL,SAAS,EAAE,SAAS,CAAC,KAAK;YAC1B,cAAc,EAAE,cAAc,CAAC,KAAK;YACpC,QAAQ;YACR,UAAU;SACX,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC;QAC/C,MAAM,IAAI,CAAC,OAAO,EAAE,CAAC;IACvB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;CACF"}

package/dist/src/index.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+export { LocallyticsGrabber } from "./client/index.js";
+export { LocallyticsData } from "./server/data.js";
+export { createHandler } from "./server/handler.js";
+export type { DateRange, DataFormat, AnalyticsResult, GrabberOptions, HandlerConfig, } from "./types/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/src/index.js ADDED Viewed

@@ -0,0 +1,4 @@
+export { LocallyticsGrabber } from "./client/index.js";
+export { LocallyticsData } from "./server/data.js";
+export { createHandler } from "./server/handler.js";
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/src/server/data.d.ts ADDED Viewed

@@ -0,0 +1,3 @@
+import type { DateRange, DataFormat, AnalyticsResult } from "../types/index.js";
+export declare function LocallyticsData(databaseUrl: string, range: DateRange, format?: DataFormat): Promise<AnalyticsResult | string>;
+//# sourceMappingURL=data.d.ts.map

package/dist/src/server/data.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../../src/server/data.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA2BhF,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,SAAS,EAChB,MAAM,GAAE,UAAmB,GAC1B,OAAO,CAAC,eAAe,GAAG,MAAM,CAAC,CAenC"}

package/dist/src/server/data.js ADDED Viewed

@@ -0,0 +1,36 @@
+import { createAdapter, getDateCutoff } from "../db/index.js";
+function formatAsCSV(data) {
+    const lines = [];
+    lines.push("# Summary");
+    lines.push("Metric,Value");
+    lines.push(`Total Pageviews,${data.pageviews}`);
+    lines.push(`Unique Visitors,${data.uniqueVisitors}`);
+    lines.push("");
+    lines.push("# Top Pages");
+    lines.push("Page,Views");
+    for (const page of data.topPages) {
+        lines.push(`${page.page},${page.count}`);
+    }
+    lines.push("");
+    lines.push("# Daily Stats");
+    lines.push("Date,Views");
+    for (const stat of data.dailyStats) {
+        lines.push(`${stat.date},${stat.views}`);
+    }
+    return lines.join("\n");
+}
+export async function LocallyticsData(databaseUrl, range, format = "json") {
+    const adapter = await createAdapter(databaseUrl);
+    const since = getDateCutoff(range);
+    try {
+        const data = await adapter.query(since);
+        if (format === "csv") {
+            return formatAsCSV(data);
+        }
+        return data;
+    }
+    finally {
+        adapter.close();
+    }
+}
+//# sourceMappingURL=data.js.map

package/dist/src/server/data.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"data.js","sourceRoot":"","sources":["../../../src/server/data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG9D,SAAS,WAAW,CAAC,IAAqB;IACxC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IACxB,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;IAChD,KAAK,CAAC,IAAI,CAAC,mBAAmB,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;IACrD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC1B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEf,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC5B,KAAK,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACzB,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACnC,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,WAAmB,EACnB,KAAgB,EAChB,SAAqB,MAAM;IAE3B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAExC,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/src/server/handler.d.ts ADDED Viewed

@@ -0,0 +1,5 @@
+import type { HandlerConfig } from "../types/index.js";
+export declare function createHandler(config: HandlerConfig): Promise<{
+    POST: (request: Request) => Promise<Response>;
+}>;
+//# sourceMappingURL=handler.d.ts.map

package/dist/src/server/handler.d.ts.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../../src/server/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAcvD,wBAAsB,aAAa,CAAC,MAAM,EAAE,aAAa;oBAG1B,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC;GA4BzD"}

package/dist/src/server/handler.js ADDED Viewed

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { createAdapter } from "../db/index.js";
+const PageviewSchema = z.object({
+    pageUrl: z.string(),
+    referrer: z.string().nullable(),
+    sessionId: z.string(),
+    timestamp: z.string(),
+});
+function respectsDNT(request) {
+    const dnt = request.headers.get("dnt") || request.headers.get("DNT");
+    return dnt === "1";
+}
+export async function createHandler(config) {
+    const adapter = await createAdapter(config.database);
+    const POST = async (request) => {
+        if (respectsDNT(request)) {
+            return new Response(null, { status: 204 });
+        }
+        try {
+            const body = await request.json();
+            const data = PageviewSchema.parse(body);
+            await adapter.insert(data);
+            return new Response(null, { status: 201 });
+        }
+        catch (error) {
+            if (error instanceof z.ZodError) {
+                return new Response(JSON.stringify({ error: "Invalid payload", details: error.errors }), {
+                    status: 400,
+                    headers: { "Content-Type": "application/json" },
+                });
+            }
+            return new Response(JSON.stringify({ error: "Internal server error" }), {
+                status: 500,
+                headers: { "Content-Type": "application/json" },
+            });
+        }
+    };
+    return { POST };
+}
+//# sourceMappingURL=handler.js.map

package/dist/src/server/handler.js.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"handler.js","sourceRoot":"","sources":["../../../src/server/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAG/C,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAC,CAAC;AAEH,SAAS,WAAW,CAAC,OAAgB;IACnC,MAAM,GAAG,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrE,OAAO,GAAG,KAAK,GAAG,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAqB;IACvD,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,KAAK,EAAE,OAAgB,EAAqB,EAAE;QACzD,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,CAAC;YAClC,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAExC,MAAM,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAE3B,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAChC,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE;oBACvF,MAAM,EAAE,GAAG;oBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;iBAChD,CAAC,CAAC;YACL,CAAC;YAED,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,uBAAuB,EAAE,CAAC,EAAE;gBACtE,MAAM,EAAE,GAAG;gBACX,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;aAChD,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC"}

package/dist/src/types/index.d.ts ADDED Viewed

@@ -0,0 +1,34 @@
+export type DateRange = "last24h" | "last7d" | "last30d";
+export type DataFormat = "json" | "csv";
+export interface PageviewPayload {
+    pageUrl: string;
+    referrer: string | null;
+    sessionId: string;
+    timestamp: string;
+}
+export interface AnalyticsResult {
+    pageviews: number;
+    uniqueVisitors: number;
+    topPages: Array<{
+        page: string;
+        count: number;
+    }>;
+    dailyStats: Array<{
+        date: string;
+        views: number;
+    }>;
+}
+export interface DatabaseAdapter {
+    insert(data: PageviewPayload): Promise<void>;
+    query(since: Date): Promise<AnalyticsResult>;
+    migrate(): Promise<void>;
+    reset(): Promise<void>;
+    close(): void;
+}
+export interface GrabberOptions {
+    endpoint?: string;
+}
+export interface HandlerConfig {
+    database: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/types/index.d.ts.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,KAAK,CAAC;AAExC,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,UAAU,EAAE,KAAK,CAAC;QAChB,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAC7C,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/src/types/index.js ADDED Viewed

	@@ -0,0 +1,2 @@
1	+ export {};
2	+ //# sourceMappingURL=index.js.map

package/dist/src/types/index.js.map ADDED Viewed

	@@ -0,0 +1 @@
1	+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":""}

package/package.json ADDED Viewed

@@ -0,0 +1,62 @@
+{
+  "name": "locallytics",
+  "version": "0.0.1-beta.1",
+  "description": "Self-hosted, privacy-first analytics for any JavaScript framework",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    }
+  },
+  "bin": {
+    "locallytics": "./dist/cli/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "biome check .",
+    "format": "biome format --write ."
+  },
+  "keywords": [
+    "analytics",
+    "privacy",
+    "self-hosted",
+    "pageviews",
+    "tracking"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.22.4"
+  },
+  "peerDependencies": {
+    "pg": "^8.11.0",
+    "better-sqlite3": "^9.4.0"
+  },
+  "peerDependenciesMeta": {
+    "pg": {
+      "optional": true
+    },
+    "better-sqlite3": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.5.3",
+    "@types/better-sqlite3": "^7.6.9",
+    "@types/node": "^20.11.16",
+    "@types/pg": "^8.11.0",
+    "typescript": "^5.3.3"
+  }
+}