@casoon/trackr 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { H as HandlerConfig, P as PrivacyConfig, Q as QueryOptions, S as StorageAdapter, a as TrackrConfig, T as TrackrEvent } from './types-EaeYBDKE.js';
+export { init, track } from './client/index.js';
+export { createHandler } from './server/index.js';

package/dist/index.js

@@ -0,0 +1,14 @@
+import {
+  init,
+  track
+} from "./chunk-ABUPERUQ.js";
+import {
+  createHandler
+} from "./chunk-L3N32JO4.js";
+import "./chunk-7D4SUZUM.js";
+export {
+  createHandler,
+  init,
+  track
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/server/index.d.ts

@@ -0,0 +1,11 @@
+import { T as TrackrEvent, P as PrivacyConfig, H as HandlerConfig } from '../types-EaeYBDKE.js';
+
+declare function isBot(request: Request): boolean;
+
+declare function anonymizeIp(ip: string): string;
+declare function stripPii(url: string): string;
+declare function applyPrivacy(event: TrackrEvent, config: PrivacyConfig): TrackrEvent;
+
+declare function createHandler(config: HandlerConfig): (request: Request) => Promise<Response>;
+
+export { anonymizeIp, applyPrivacy, createHandler, isBot, stripPii };

package/dist/server/index.js

@@ -0,0 +1,16 @@
+import {
+  anonymizeIp,
+  applyPrivacy,
+  createHandler,
+  isBot,
+  stripPii
+} from "../chunk-L3N32JO4.js";
+import "../chunk-7D4SUZUM.js";
+export {
+  anonymizeIp,
+  applyPrivacy,
+  createHandler,
+  isBot,
+  stripPii
+};
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/storage/api.d.ts

@@ -0,0 +1,10 @@
+import { T as TrackrEvent, S as StorageAdapter } from '../types-EaeYBDKE.js';
+
+interface ApiConfig {
+    url: string;
+    headers?: Record<string, string>;
+    transform?: (event: TrackrEvent) => unknown;
+}
+declare function api(config: ApiConfig): StorageAdapter;
+
+export { api };

package/dist/storage/api.js

@@ -0,0 +1,22 @@
+import "../chunk-7D4SUZUM.js";
+
+// src/storage/api.ts
+function api(config) {
+  return {
+    async save(event) {
+      const body = config.transform ? config.transform(event) : event;
+      await fetch(config.url, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          ...config.headers
+        },
+        body: JSON.stringify(body)
+      });
+    }
+  };
+}
+export {
+  api
+};
+//# sourceMappingURL=api.js.map

package/dist/storage/api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/api.ts"],"sourcesContent":["import type { StorageAdapter, TrackrEvent } from \"../types.js\";\n\ninterface ApiConfig {\n  url: string;\n  headers?: Record<string, string>;\n  transform?: (event: TrackrEvent) => unknown;\n}\n\nexport function api(config: ApiConfig): StorageAdapter {\n  return {\n    async save(event: TrackrEvent): Promise<void> {\n      const body = config.transform ? config.transform(event) : event;\n      \n      await fetch(config.url, {\n        method: \"POST\",\n        headers: {\n          \"Content-Type\": \"application/json\",\n          ...config.headers\n        },\n        body: JSON.stringify(body)\n      });\n    }\n  };\n}\n"],"mappings":";;;AAQO,SAAS,IAAI,QAAmC;AACrD,SAAO;AAAA,IACL,MAAM,KAAK,OAAmC;AAC5C,YAAM,OAAO,OAAO,YAAY,OAAO,UAAU,KAAK,IAAI;AAE1D,YAAM,MAAM,OAAO,KAAK;AAAA,QACtB,QAAQ;AAAA,QACR,SAAS;AAAA,UACP,gBAAgB;AAAA,UAChB,GAAG,OAAO;AAAA,QACZ;AAAA,QACA,MAAM,KAAK,UAAU,IAAI;AAAA,MAC3B,CAAC;AAAA,IACH;AAAA,EACF;AACF;","names":[]}

package/dist/storage/postgres.d.ts

@@ -0,0 +1,10 @@
+import { S as StorageAdapter } from '../types-EaeYBDKE.js';
+
+interface PostgresClient {
+    query(text: string, values?: unknown[]): Promise<{
+        rows: unknown[];
+    }>;
+}
+declare function postgres(connectionStringOrClient: string | PostgresClient): StorageAdapter;
+
+export { postgres };

package/dist/storage/postgres.js

@@ -0,0 +1,67 @@
+import "../chunk-7D4SUZUM.js";
+
+// src/storage/postgres.ts
+function postgres(connectionStringOrClient) {
+  let client = null;
+  const getClient = async () => {
+    if (client) return client;
+    if (typeof connectionStringOrClient === "string") {
+      const pg = await import("../esm-O5HEMDRH.js");
+      const pool = new pg.default.Pool({ connectionString: connectionStringOrClient });
+      client = pool;
+      return pool;
+    }
+    client = connectionStringOrClient;
+    return client;
+  };
+  return {
+    async save(event) {
+      const db = await getClient();
+      await db.query(
+        `INSERT INTO trackr_events (type, name, url, referrer_domain, country, device, browser, session_id, props, ts)
+         VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, to_timestamp($10 / 1000.0))`,
+        [
+          event.type,
+          event.name || null,
+          event.url,
+          event.referrer || null,
+          event.country || null,
+          event.device || null,
+          event.browser || null,
+          event.sessionId || null,
+          JSON.stringify(event.props || {}),
+          event.ts
+        ]
+      );
+    },
+    async query(options) {
+      const db = await getClient();
+      const conditions = [];
+      const values = [];
+      let i = 1;
+      if (options.from) {
+        conditions.push(`ts >= $${i++}`);
+        values.push(options.from);
+      }
+      if (options.to) {
+        conditions.push(`ts <= $${i++}`);
+        values.push(options.to);
+      }
+      if (options.type) {
+        conditions.push(`type = $${i++}`);
+        values.push(options.type);
+      }
+      const where = conditions.length ? `WHERE ${conditions.join(" AND ")}` : "";
+      const limit = options.limit ? `LIMIT ${options.limit}` : "";
+      const result = await db.query(
+        `SELECT * FROM trackr_events ${where} ORDER BY ts DESC ${limit}`,
+        values
+      );
+      return result.rows;
+    }
+  };
+}
+export {
+  postgres
+};
+//# sourceMappingURL=postgres.js.map

package/dist/storage/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/storage/postgres.ts"],"sourcesContent":["import type { StorageAdapter, TrackrEvent, QueryOptions } from \"../types.js\";\n\ninterface PostgresClient {\n  query(text: string, values?: unknown[]): Promise<{ rows: unknown[] }>;\n}\n\nexport function postgres(connectionStringOrClient: string | PostgresClient): StorageAdapter {\n  let client: PostgresClient | null = null;\n  \n  const getClient = async (): Promise<PostgresClient> => {\n    if (client) return client;\n    \n    if (typeof connectionStringOrClient === \"string\") {\n      const pg = await import(\"pg\");\n      const pool = new pg.default.Pool({ connectionString: connectionStringOrClient });\n      client = pool;\n      return pool;\n    }\n    \n    client = connectionStringOrClient;\n    return client;\n  };\n  \n  return {\n    async save(event: TrackrEvent): Promise<void> {\n      const db = await getClient();\n      await db.query(\n        `INSERT INTO trackr_events (type, name, url, referrer_domain, country, device, browser, session_id, props, ts)\n         VALUES ($1, $2, $3, $4, $5, $6, $7, $8, $9, to_timestamp($10 / 1000.0))`,\n        [\n          event.type,\n          event.name || null,\n          event.url,\n          event.referrer || null,\n          event.country || null,\n          event.device || null,\n          event.browser || null,\n          event.sessionId || null,\n          JSON.stringify(event.props || {}),\n          event.ts\n        ]\n      );\n    },\n    \n    async query(options: QueryOptions): Promise<TrackrEvent[]> {\n      const db = await getClient();\n      const conditions: string[] = [];\n      const values: unknown[] = [];\n      let i = 1;\n      \n      if (options.from) {\n        conditions.push(`ts >= $${i++}`);\n        values.push(options.from);\n      }\n      if (options.to) {\n        conditions.push(`ts <= $${i++}`);\n        values.push(options.to);\n      }\n      if (options.type) {\n        conditions.push(`type = $${i++}`);\n        values.push(options.type);\n      }\n      \n      const where = conditions.length ? `WHERE ${conditions.join(\" AND \")}` : \"\";\n      const limit = options.limit ? `LIMIT ${options.limit}` : \"\";\n      \n      const result = await db.query(\n        `SELECT * FROM trackr_events ${where} ORDER BY ts DESC ${limit}`,\n        values\n      );\n      \n      return result.rows as TrackrEvent[];\n    }\n  };\n}\n"],"mappings":";;;AAMO,SAAS,SAAS,0BAAmE;AAC1F,MAAI,SAAgC;AAEpC,QAAM,YAAY,YAAqC;AACrD,QAAI,OAAQ,QAAO;AAEnB,QAAI,OAAO,6BAA6B,UAAU;AAChD,YAAM,KAAK,MAAM,OAAO,oBAAI;AAC5B,YAAM,OAAO,IAAI,GAAG,QAAQ,KAAK,EAAE,kBAAkB,yBAAyB,CAAC;AAC/E,eAAS;AACT,aAAO;AAAA,IACT;AAEA,aAAS;AACT,WAAO;AAAA,EACT;AAEA,SAAO;AAAA,IACL,MAAM,KAAK,OAAmC;AAC5C,YAAM,KAAK,MAAM,UAAU;AAC3B,YAAM,GAAG;AAAA,QACP;AAAA;AAAA,QAEA;AAAA,UACE,MAAM;AAAA,UACN,MAAM,QAAQ;AAAA,UACd,MAAM;AAAA,UACN,MAAM,YAAY;AAAA,UAClB,MAAM,WAAW;AAAA,UACjB,MAAM,UAAU;AAAA,UAChB,MAAM,WAAW;AAAA,UACjB,MAAM,aAAa;AAAA,UACnB,KAAK,UAAU,MAAM,SAAS,CAAC,CAAC;AAAA,UAChC,MAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAAA,IAEA,MAAM,MAAM,SAA+C;AACzD,YAAM,KAAK,MAAM,UAAU;AAC3B,YAAM,aAAuB,CAAC;AAC9B,YAAM,SAAoB,CAAC;AAC3B,UAAI,IAAI;AAER,UAAI,QAAQ,MAAM;AAChB,mBAAW,KAAK,UAAU,GAAG,EAAE;AAC/B,eAAO,KAAK,QAAQ,IAAI;AAAA,MAC1B;AACA,UAAI,QAAQ,IAAI;AACd,mBAAW,KAAK,UAAU,GAAG,EAAE;AAC/B,eAAO,KAAK,QAAQ,EAAE;AAAA,MACxB;AACA,UAAI,QAAQ,MAAM;AAChB,mBAAW,KAAK,WAAW,GAAG,EAAE;AAChC,eAAO,KAAK,QAAQ,IAAI;AAAA,MAC1B;AAEA,YAAM,QAAQ,WAAW,SAAS,SAAS,WAAW,KAAK,OAAO,CAAC,KAAK;AACxE,YAAM,QAAQ,QAAQ,QAAQ,SAAS,QAAQ,KAAK,KAAK;AAEzD,YAAM,SAAS,MAAM,GAAG;AAAA,QACtB,+BAA+B,KAAK,qBAAqB,KAAK;AAAA,QAC9D;AAAA,MACF;AAEA,aAAO,OAAO;AAAA,IAChB;AAAA,EACF;AACF;","names":[]}

package/dist/types-EaeYBDKE.d.ts

@@ -0,0 +1,38 @@
+interface TrackrEvent {
+    type: "pageview" | "event";
+    name?: string;
+    url: string;
+    referrer?: string;
+    country?: string;
+    device?: "desktop" | "mobile" | "tablet";
+    browser?: string;
+    sessionId?: string;
+    props?: Record<string, string | number | boolean>;
+    ts: number;
+}
+interface TrackrConfig {
+    endpoint: string;
+    debug?: boolean;
+}
+interface StorageAdapter {
+    save(event: TrackrEvent): Promise<void>;
+    query?(options: QueryOptions): Promise<TrackrEvent[]>;
+}
+interface QueryOptions {
+    from?: Date;
+    to?: Date;
+    type?: "pageview" | "event";
+    limit?: number;
+}
+interface PrivacyConfig {
+    anonymizeIp?: boolean;
+    stripPii?: boolean;
+    stripQueryParams?: string[];
+}
+interface HandlerConfig {
+    storage: StorageAdapter;
+    privacy?: PrivacyConfig;
+    botFilter?: boolean;
+}
+
+export type { HandlerConfig as H, PrivacyConfig as P, QueryOptions as Q, StorageAdapter as S, TrackrEvent as T, TrackrConfig as a };

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@casoon/trackr",
+  "version": "0.1.0",
+  "description": "Privacy-first, GDPR-native analytics for static sites.",
+  "author": "Joern Seidel <joern@casoon.de>",
+  "license": "LGPL-3.0-or-later",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client/index.d.ts",
+      "import": "./dist/client/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./storage/postgres": {
+      "types": "./dist/storage/postgres.d.ts",
+      "import": "./dist/storage/postgres.js"
+    },
+    "./storage/api": {
+      "types": "./dist/storage/api.d.ts",
+      "import": "./dist/storage/api.js"
+    }
+  },
+  "files": [
+    "dist",
+    "script.js",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "@types/pg": "^8.16.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "optionalDependencies": {
+    "pg": "^8.13.1"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "packageManager": "pnpm@9.15.1",
+  "volta": {
+    "node": "24.0.0"
+  }
+}