locallytics 0.1.9 → 0.2.0

package/dist/index.js

@@ -1,7 +1,367 @@
-// Server exports
-// Client exports
-export { LocallyticsGrabber } from "./client/LocallyticsGrabber.js";
-export { createDatabase } from "./db/factory.js";
-export { LocallyticsData, locallytics } from "./server/index.js";
-export { LocallyticsError } from "./types/index.js";
-//# sourceMappingURL=index.js.map
+var import_node_module = require("node:module");
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __moduleCache = /* @__PURE__ */ new WeakMap;
+var __toCommonJS = (from) => {
+  var entry = __moduleCache.get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function")
+    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
+      get: () => from[key],
+      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+    }));
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  createLocallytics: () => createLocallytics
+});
+module.exports = __toCommonJS(exports_src);
+function toError(error) {
+  return error instanceof Error ? error : new Error(String(error));
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseMetadata(value) {
+  if (value == null) {
+    return;
+  }
+  if (isRecord(value)) {
+    return value;
+  }
+  if (typeof value === "string") {
+    try {
+      const parsed = JSON.parse(value);
+      return isRecord(parsed) ? parsed : undefined;
+    } catch {
+      return;
+    }
+  }
+  return;
+}
+function normalizeEventRow(row) {
+  return {
+    id: row.id,
+    type: String(row.type ?? ""),
+    timestamp: Number(row.timestamp ?? Date.now()),
+    sessionId: row.session_id ?? row.sessionId,
+    userId: row.user_id ?? row.userId,
+    metadata: parseMetadata(row.metadata)
+  };
+}
+function stringifyMetadata(metadata) {
+  return metadata ? JSON.stringify(metadata) : null;
+}
+function isDatabaseAdapter(database) {
+  return "insertEvent" in database && typeof database.insertEvent === "function" && "findEvents" in database && typeof database.findEvents === "function";
+}
+function isPostgresLikeDatabase(database) {
+  return "query" in database && typeof database.query === "function";
+}
+function isMysqlLikeDatabase(database) {
+  return "execute" in database && typeof database.execute === "function";
+}
+function isSqliteLikeDatabase(database) {
+  return "prepare" in database && typeof database.prepare === "function";
+}
+function createPostgresAdapter(database) {
+  let initialized = false;
+  async function ensureInitialized() {
+    if (initialized) {
+      return;
+    }
+    await database.query(`
+      CREATE TABLE IF NOT EXISTS locallytics_events (
+        id BIGSERIAL PRIMARY KEY,
+        type TEXT NOT NULL,
+        timestamp BIGINT NOT NULL,
+        session_id TEXT,
+        user_id TEXT,
+        metadata JSONB
+      )
+    `);
+    initialized = true;
+  }
+  return {
+    initialize: ensureInitialized,
+    async insertEvent(event) {
+      await ensureInitialized();
+      const result = await database.query(`
+          INSERT INTO locallytics_events (type, timestamp, session_id, user_id, metadata)
+          VALUES ($1, $2, $3, $4, $5::jsonb)
+          RETURNING id, type, timestamp, session_id, user_id, metadata
+        `, [
+        event.type,
+        event.timestamp,
+        event.sessionId ?? null,
+        event.userId ?? null,
+        stringifyMetadata(event.metadata)
+      ]);
+      const first = result.rows[0];
+      return first ? normalizeEventRow(first) : { ...event };
+    },
+    async findEvents() {
+      await ensureInitialized();
+      const result = await database.query(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          ORDER BY timestamp DESC
+        `);
+      return result.rows.map(normalizeEventRow);
+    }
+  };
+}
+function createMysqlAdapter(database) {
+  let initialized = false;
+  async function ensureInitialized() {
+    if (initialized) {
+      return;
+    }
+    await database.execute(`
+      CREATE TABLE IF NOT EXISTS locallytics_events (
+        id BIGINT AUTO_INCREMENT PRIMARY KEY,
+        type VARCHAR(255) NOT NULL,
+        timestamp BIGINT NOT NULL,
+        session_id VARCHAR(255),
+        user_id VARCHAR(255),
+        metadata JSON
+      )
+    `);
+    initialized = true;
+  }
+  return {
+    initialize: ensureInitialized,
+    async insertEvent(event) {
+      await ensureInitialized();
+      const [insertResult] = await database.execute(`
+          INSERT INTO locallytics_events (type, timestamp, session_id, user_id, metadata)
+          VALUES (?, ?, ?, ?, ?)
+        `, [
+        event.type,
+        event.timestamp,
+        event.sessionId ?? null,
+        event.userId ?? null,
+        stringifyMetadata(event.metadata)
+      ]);
+      const insertId = Number(insertResult.insertId ?? 0);
+      if (!insertId) {
+        return { ...event };
+      }
+      const [rows] = await database.execute(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          WHERE id = ?
+          LIMIT 1
+        `, [insertId]);
+      const first = rows[0];
+      return first ? normalizeEventRow(first) : { ...event, id: insertId };
+    },
+    async findEvents() {
+      await ensureInitialized();
+      const [rows] = await database.execute(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          ORDER BY timestamp DESC
+        `);
+      return rows.map(normalizeEventRow);
+    }
+  };
+}
+function createSqliteAdapter(database) {
+  let initialized = false;
+  function ensureInitialized() {
+    if (initialized) {
+      return;
+    }
+    database.prepare(`
+      CREATE TABLE IF NOT EXISTS locallytics_events (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        type TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        session_id TEXT,
+        user_id TEXT,
+        metadata TEXT
+      )
+    `).run();
+    initialized = true;
+  }
+  return {
+    initialize: ensureInitialized,
+    async insertEvent(event) {
+      ensureInitialized();
+      const insert = database.prepare(`
+          INSERT INTO locallytics_events (type, timestamp, session_id, user_id, metadata)
+          VALUES (?, ?, ?, ?, ?)
+        `);
+      const result = insert.run(event.type, event.timestamp, event.sessionId ?? null, event.userId ?? null, stringifyMetadata(event.metadata));
+      const insertId = Number(result.lastInsertRowid ?? 0);
+      const select = database.prepare(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          WHERE id = ?
+          LIMIT 1
+        `);
+      const row = select.get ? select.get(insertId) : select.all(insertId)[0];
+      return row ? normalizeEventRow(row) : { ...event, id: insertId };
+    },
+    async findEvents() {
+      ensureInitialized();
+      const rows = database.prepare(`
+            SELECT id, type, timestamp, session_id, user_id, metadata
+            FROM locallytics_events
+            ORDER BY timestamp DESC
+          `).all();
+      return rows.map(normalizeEventRow);
+    }
+  };
+}
+function createDatabaseAdapter(database) {
+  if (isDatabaseAdapter(database)) {
+    return database;
+  }
+  if (isPostgresLikeDatabase(database)) {
+    return createPostgresAdapter(database);
+  }
+  if (isMysqlLikeDatabase(database)) {
+    return createMysqlAdapter(database);
+  }
+  if (isSqliteLikeDatabase(database)) {
+    return createSqliteAdapter(database);
+  }
+  throw new Error("Unsupported database input. Use a pg Pool, mysql2 pool, better-sqlite3 Database, or a DatabaseAdapter.");
+}
+function createSessionId() {
+  return `session_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+function createLocallytics(config) {
+  const adapter = createDatabaseAdapter(config.database);
+  const listeners = new Set;
+  const isBrowser = typeof window !== "undefined";
+  let userId = config.userId;
+  let currentSessionId;
+  const queryState = {
+    events: [],
+    loading: false,
+    error: null,
+    loaded: false,
+    pending: undefined
+  };
+  function notify() {
+    for (const listener of listeners) {
+      listener();
+    }
+  }
+  function getSessionId() {
+    if (!config.sessionTracking) {
+      return;
+    }
+    if (!currentSessionId) {
+      currentSessionId = createSessionId();
+    }
+    return currentSessionId;
+  }
+  async function runQuery(force = false) {
+    if (!force && queryState.pending) {
+      return queryState.pending;
+    }
+    if (!force && isBrowser && queryState.loaded) {
+      return queryState.events;
+    }
+    queryState.loading = true;
+    queryState.error = null;
+    notify();
+    const pending = (async () => {
+      if (adapter.initialize) {
+        await adapter.initialize();
+      }
+      const events = await adapter.findEvents();
+      queryState.events = events;
+      queryState.loaded = true;
+      return events;
+    })().catch((error) => {
+      const normalized = toError(error);
+      queryState.error = normalized;
+      throw normalized;
+    }).finally(() => {
+      queryState.loading = false;
+      queryState.pending = undefined;
+      notify();
+    });
+    queryState.pending = pending;
+    return pending;
+  }
+  async function track(type, metadata) {
+    if (adapter.initialize) {
+      await adapter.initialize();
+    }
+    const event = {
+      type,
+      timestamp: Date.now(),
+      sessionId: getSessionId(),
+      userId,
+      metadata
+    };
+    const saved = await adapter.insertEvent(event);
+    if (isBrowser && queryState.loaded) {
+      queryState.events = [saved, ...queryState.events];
+      notify();
+    }
+    return saved;
+  }
+  function createQueryResult(promise) {
+    return {
+      get events() {
+        return queryState.events;
+      },
+      get loading() {
+        return queryState.loading;
+      },
+      get error() {
+        return queryState.error;
+      },
+      refresh: () => runQuery(true),
+      then: promise.then.bind(promise)
+    };
+  }
+  return {
+    track,
+    async trackPageView(route) {
+      const resolvedRoute = route ?? (typeof location !== "undefined" ? `${location.pathname}${location.search}` : "/");
+      return track("page_view", { route: resolvedRoute });
+    },
+    query() {
+      const promise = runQuery(!isBrowser);
+      return createQueryResult(promise);
+    },
+    setUserId(nextUserId) {
+      userId = nextUserId;
+    },
+    getUserId() {
+      return userId;
+    },
+    getSessionId,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+}

package/dist/index.mjs

@@ -0,0 +1,336 @@
+// src/index.ts
+function toError(error) {
+  return error instanceof Error ? error : new Error(String(error));
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function parseMetadata(value) {
+  if (value == null) {
+    return;
+  }
+  if (isRecord(value)) {
+    return value;
+  }
+  if (typeof value === "string") {
+    try {
+      const parsed = JSON.parse(value);
+      return isRecord(parsed) ? parsed : undefined;
+    } catch {
+      return;
+    }
+  }
+  return;
+}
+function normalizeEventRow(row) {
+  return {
+    id: row.id,
+    type: String(row.type ?? ""),
+    timestamp: Number(row.timestamp ?? Date.now()),
+    sessionId: row.session_id ?? row.sessionId,
+    userId: row.user_id ?? row.userId,
+    metadata: parseMetadata(row.metadata)
+  };
+}
+function stringifyMetadata(metadata) {
+  return metadata ? JSON.stringify(metadata) : null;
+}
+function isDatabaseAdapter(database) {
+  return "insertEvent" in database && typeof database.insertEvent === "function" && "findEvents" in database && typeof database.findEvents === "function";
+}
+function isPostgresLikeDatabase(database) {
+  return "query" in database && typeof database.query === "function";
+}
+function isMysqlLikeDatabase(database) {
+  return "execute" in database && typeof database.execute === "function";
+}
+function isSqliteLikeDatabase(database) {
+  return "prepare" in database && typeof database.prepare === "function";
+}
+function createPostgresAdapter(database) {
+  let initialized = false;
+  async function ensureInitialized() {
+    if (initialized) {
+      return;
+    }
+    await database.query(`
+      CREATE TABLE IF NOT EXISTS locallytics_events (
+        id BIGSERIAL PRIMARY KEY,
+        type TEXT NOT NULL,
+        timestamp BIGINT NOT NULL,
+        session_id TEXT,
+        user_id TEXT,
+        metadata JSONB
+      )
+    `);
+    initialized = true;
+  }
+  return {
+    initialize: ensureInitialized,
+    async insertEvent(event) {
+      await ensureInitialized();
+      const result = await database.query(`
+          INSERT INTO locallytics_events (type, timestamp, session_id, user_id, metadata)
+          VALUES ($1, $2, $3, $4, $5::jsonb)
+          RETURNING id, type, timestamp, session_id, user_id, metadata
+        `, [
+        event.type,
+        event.timestamp,
+        event.sessionId ?? null,
+        event.userId ?? null,
+        stringifyMetadata(event.metadata)
+      ]);
+      const first = result.rows[0];
+      return first ? normalizeEventRow(first) : { ...event };
+    },
+    async findEvents() {
+      await ensureInitialized();
+      const result = await database.query(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          ORDER BY timestamp DESC
+        `);
+      return result.rows.map(normalizeEventRow);
+    }
+  };
+}
+function createMysqlAdapter(database) {
+  let initialized = false;
+  async function ensureInitialized() {
+    if (initialized) {
+      return;
+    }
+    await database.execute(`
+      CREATE TABLE IF NOT EXISTS locallytics_events (
+        id BIGINT AUTO_INCREMENT PRIMARY KEY,
+        type VARCHAR(255) NOT NULL,
+        timestamp BIGINT NOT NULL,
+        session_id VARCHAR(255),
+        user_id VARCHAR(255),
+        metadata JSON
+      )
+    `);
+    initialized = true;
+  }
+  return {
+    initialize: ensureInitialized,
+    async insertEvent(event) {
+      await ensureInitialized();
+      const [insertResult] = await database.execute(`
+          INSERT INTO locallytics_events (type, timestamp, session_id, user_id, metadata)
+          VALUES (?, ?, ?, ?, ?)
+        `, [
+        event.type,
+        event.timestamp,
+        event.sessionId ?? null,
+        event.userId ?? null,
+        stringifyMetadata(event.metadata)
+      ]);
+      const insertId = Number(insertResult.insertId ?? 0);
+      if (!insertId) {
+        return { ...event };
+      }
+      const [rows] = await database.execute(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          WHERE id = ?
+          LIMIT 1
+        `, [insertId]);
+      const first = rows[0];
+      return first ? normalizeEventRow(first) : { ...event, id: insertId };
+    },
+    async findEvents() {
+      await ensureInitialized();
+      const [rows] = await database.execute(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          ORDER BY timestamp DESC
+        `);
+      return rows.map(normalizeEventRow);
+    }
+  };
+}
+function createSqliteAdapter(database) {
+  let initialized = false;
+  function ensureInitialized() {
+    if (initialized) {
+      return;
+    }
+    database.prepare(`
+      CREATE TABLE IF NOT EXISTS locallytics_events (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        type TEXT NOT NULL,
+        timestamp INTEGER NOT NULL,
+        session_id TEXT,
+        user_id TEXT,
+        metadata TEXT
+      )
+    `).run();
+    initialized = true;
+  }
+  return {
+    initialize: ensureInitialized,
+    async insertEvent(event) {
+      ensureInitialized();
+      const insert = database.prepare(`
+          INSERT INTO locallytics_events (type, timestamp, session_id, user_id, metadata)
+          VALUES (?, ?, ?, ?, ?)
+        `);
+      const result = insert.run(event.type, event.timestamp, event.sessionId ?? null, event.userId ?? null, stringifyMetadata(event.metadata));
+      const insertId = Number(result.lastInsertRowid ?? 0);
+      const select = database.prepare(`
+          SELECT id, type, timestamp, session_id, user_id, metadata
+          FROM locallytics_events
+          WHERE id = ?
+          LIMIT 1
+        `);
+      const row = select.get ? select.get(insertId) : select.all(insertId)[0];
+      return row ? normalizeEventRow(row) : { ...event, id: insertId };
+    },
+    async findEvents() {
+      ensureInitialized();
+      const rows = database.prepare(`
+            SELECT id, type, timestamp, session_id, user_id, metadata
+            FROM locallytics_events
+            ORDER BY timestamp DESC
+          `).all();
+      return rows.map(normalizeEventRow);
+    }
+  };
+}
+function createDatabaseAdapter(database) {
+  if (isDatabaseAdapter(database)) {
+    return database;
+  }
+  if (isPostgresLikeDatabase(database)) {
+    return createPostgresAdapter(database);
+  }
+  if (isMysqlLikeDatabase(database)) {
+    return createMysqlAdapter(database);
+  }
+  if (isSqliteLikeDatabase(database)) {
+    return createSqliteAdapter(database);
+  }
+  throw new Error("Unsupported database input. Use a pg Pool, mysql2 pool, better-sqlite3 Database, or a DatabaseAdapter.");
+}
+function createSessionId() {
+  return `session_${Date.now()}_${Math.random().toString(36).slice(2, 9)}`;
+}
+function createLocallytics(config) {
+  const adapter = createDatabaseAdapter(config.database);
+  const listeners = new Set;
+  const isBrowser = typeof window !== "undefined";
+  let userId = config.userId;
+  let currentSessionId;
+  const queryState = {
+    events: [],
+    loading: false,
+    error: null,
+    loaded: false,
+    pending: undefined
+  };
+  function notify() {
+    for (const listener of listeners) {
+      listener();
+    }
+  }
+  function getSessionId() {
+    if (!config.sessionTracking) {
+      return;
+    }
+    if (!currentSessionId) {
+      currentSessionId = createSessionId();
+    }
+    return currentSessionId;
+  }
+  async function runQuery(force = false) {
+    if (!force && queryState.pending) {
+      return queryState.pending;
+    }
+    if (!force && isBrowser && queryState.loaded) {
+      return queryState.events;
+    }
+    queryState.loading = true;
+    queryState.error = null;
+    notify();
+    const pending = (async () => {
+      if (adapter.initialize) {
+        await adapter.initialize();
+      }
+      const events = await adapter.findEvents();
+      queryState.events = events;
+      queryState.loaded = true;
+      return events;
+    })().catch((error) => {
+      const normalized = toError(error);
+      queryState.error = normalized;
+      throw normalized;
+    }).finally(() => {
+      queryState.loading = false;
+      queryState.pending = undefined;
+      notify();
+    });
+    queryState.pending = pending;
+    return pending;
+  }
+  async function track(type, metadata) {
+    if (adapter.initialize) {
+      await adapter.initialize();
+    }
+    const event = {
+      type,
+      timestamp: Date.now(),
+      sessionId: getSessionId(),
+      userId,
+      metadata
+    };
+    const saved = await adapter.insertEvent(event);
+    if (isBrowser && queryState.loaded) {
+      queryState.events = [saved, ...queryState.events];
+      notify();
+    }
+    return saved;
+  }
+  function createQueryResult(promise) {
+    return {
+      get events() {
+        return queryState.events;
+      },
+      get loading() {
+        return queryState.loading;
+      },
+      get error() {
+        return queryState.error;
+      },
+      refresh: () => runQuery(true),
+      then: promise.then.bind(promise)
+    };
+  }
+  return {
+    track,
+    async trackPageView(route) {
+      const resolvedRoute = route ?? (typeof location !== "undefined" ? `${location.pathname}${location.search}` : "/");
+      return track("page_view", { route: resolvedRoute });
+    },
+    query() {
+      const promise = runQuery(!isBrowser);
+      return createQueryResult(promise);
+    },
+    setUserId(nextUserId) {
+      userId = nextUserId;
+    },
+    getUserId() {
+      return userId;
+    },
+    getSessionId,
+    subscribe(listener) {
+      listeners.add(listener);
+      return () => {
+        listeners.delete(listener);
+      };
+    }
+  };
+}
+export {
+  createLocallytics
+};