site-vigil-visitors 0.1.3 → 0.3.0

package/README.md

@@ -23,16 +23,58 @@ For React projects:
 npm install react site-vigil-visitors
 ```
 
+### Automated setup (React)
+
+After installing, run:
+
+```bash
+npx site-vigil-visitors init
+```
+
+This prompts for your site ID, then adds the import and the `<SiteVigil />`
+component to your app entry file (`src/App.tsx`, `src/App.jsx`, `src/main.tsx`,
+or `src/main.jsx`). To skip the prompt:
+
+```bash
+npx site-vigil-visitors init --site-id=my-site
+```
+
+Running `init` again is safe — it does nothing if the snippet is already there.
+
+> npm runs install scripts non-interactively, so the setup cannot prompt for a
+> site ID during `npm install` itself. Always run `init` as a separate step.
+
+## Uninstalling
+
+Run the removal command **before** uninstalling the package (it needs the
+package to still be installed):
+
+```bash
+npx site-vigil-visitors remove
+npm uninstall site-vigil-visitors
+```
+
+`remove` scans every file under `src/` and strips all tracking code: import
+statements referencing this package and any `<SiteVigil />` elements (single- or
+multi-line, either quote style), including the legacy `<Tracking />` name used
+before v0.3.0. If a file still references the package in a
+way it cannot safely remove (for example custom `createTracker` usage), it
+lists that file for manual review.
+
+> npm 7+ no longer runs `preuninstall` scripts, so the package cannot clean up
+> automatically when you run `npm uninstall` — the `remove` command is the
+> supported way to do it.
+
 ## Quick start
 
 ### React
 
 ```tsx
-import { Tracking } from 'site-vigil-visitors/react'
+import { SiteVigil } from 'site-vigil-visitors/react'
 
 export function App() {
   return (
-    <Tracking
+    <SiteVigil
       siteId="my-site"
       endpoint="https://t.site-vigil.com"
     />
@@ -70,12 +112,12 @@ tracker.trackEvent('cta_click', { label: 'Register' })
 ## React usage
 
 ```tsx
-import { Tracking } from 'site-vigil-visitors/react'
+import { SiteVigil } from 'site-vigil-visitors/react'
 
 export function App() {
   return (
     <>
-      <Tracking
+      <SiteVigil
         siteId="my-site"
         endpoint="https://t.site-vigil.com"
       />
@@ -90,12 +132,12 @@ export function App() {
 Here is a minimal Vite + React example using the package:
 
 ```tsx
-import { Tracking } from 'site-vigil-visitors/react'
+import { SiteVigil } from 'site-vigil-visitors/react'
 
 export default function App() {
   return (
     <div>
-      <Tracking
+      <SiteVigil
         siteId="demo-site"
         endpoint="https://t.site-vigil.com"
       />
@@ -133,11 +175,11 @@ Use the React wrapper inside a client component:
 ```tsx
 'use client'
 
-import { Tracking } from 'site-vigil-visitors/react'
+import { SiteVigil } from 'site-vigil-visitors/react'
 
 export default function TrackingClient() {
   return (
-    <Tracking
+    <SiteVigil
       siteId="next-app"
       endpoint="https://t.site-vigil.com"
     />

package/bin/cli.mjs

@@ -0,0 +1,284 @@
+#!/usr/bin/env node
+import { createInterface } from 'node:readline'
+import { readFile, writeFile, access, readdir } from 'node:fs/promises'
+import { join, relative } from 'node:path'
+
+const ENDPOINT = 'https://t.site-vigil.com'
+const PACKAGE = 'site-vigil-visitors'
+
+const CANDIDATES = [
+  'src/App.tsx',
+  'src/App.jsx',
+  'src/main.tsx',
+  'src/main.jsx',
+]
+
+const SOURCE_EXTENSIONS = ['.tsx', '.jsx', '.ts', '.js']
+
+// ---------------------------------------------------------------------------
+// shared helpers
+// ---------------------------------------------------------------------------
+
+async function findAppFile(cwd) {
+  for (const candidate of CANDIDATES) {
+    try {
+      await access(join(cwd, candidate))
+      return { path: join(cwd, candidate), rel: candidate }
+    } catch {}
+  }
+  return null
+}
+
+async function collectSourceFiles(dir, results = []) {
+  let entries
+  try {
+    entries = await readdir(dir, { withFileTypes: true })
+  } catch {
+    return results
+  }
+  for (const entry of entries) {
+    if (entry.name === 'node_modules' || entry.name.startsWith('.')) continue
+    const full = join(dir, entry.name)
+    if (entry.isDirectory()) {
+      await collectSourceFiles(full, results)
+    } else if (SOURCE_EXTENSIONS.some(ext => entry.name.endsWith(ext))) {
+      results.push(full)
+    }
+  }
+  return results
+}
+
+// ---------------------------------------------------------------------------
+// init
+// ---------------------------------------------------------------------------
+
+async function promptSiteId() {
+  const arg = process.argv.find(a => a.startsWith('--site-id='))
+  if (arg) return arg.slice('--site-id='.length).trim()
+
+  const rl = createInterface({ input: process.stdin, output: process.stdout })
+  return new Promise(resolve => {
+    rl.question('Enter your site ID (e.g. my-website): ', answer => {
+      rl.close()
+      resolve(answer.trim())
+    })
+  })
+}
+
+function detectQuote(content) {
+  const double = (content.match(/from "/g) || []).length
+  const single = (content.match(/from '/g) || []).length
+  return double > single ? '"' : "'"
+}
+
+function patchImports(content) {
+  if (new RegExp(`from ["']${PACKAGE}/react["']`).test(content)) return content
+  const matches = [...content.matchAll(/^import .+$/gm)]
+  if (!matches.length) return content
+  const q = detectQuote(content)
+  const last = matches.at(-1)
+  const pos = last.index + last[0].length
+  return (
+    content.slice(0, pos) +
+    `\nimport { SiteVigil } from ${q}${PACKAGE}/react${q}` +
+    content.slice(pos)
+  )
+}
+
+function hasComponent(content) {
+  // <Tracking> is the pre-0.3.0 component name
+  return /<(?:SiteVigil|Tracking)[\s/>]/.test(content)
+}
+
+function patchJsx(content, siteId) {
+  if (hasComponent(content)) return content
+
+  // Insert <Tracking /> as the last child of the file's final JSX closing tag —
+  // in a typical app entry file that is the root element of the main return.
+  const closers = [...content.matchAll(/^([ \t]*)<\/(?:[A-Za-z][\w.]*)?>[ \t]*\r?$/gm)]
+  if (!closers.length) return null
+
+  const last = closers.at(-1)
+  const closeIndent = last[1]
+
+  // Indent like the preceding sibling line when it sits deeper than the
+  // closing tag, otherwise one level further in than the closing tag.
+  const prevLine = content.slice(0, last.index).split('\n').filter(l => l.trim()).at(-1) ?? ''
+  const prevIndent = prevLine.match(/^[ \t]*/)[0]
+  const indent = prevIndent.length > closeIndent.length ? prevIndent : closeIndent + '    '
+
+  const trackingLine = `${indent}<SiteVigil siteId="${siteId}" endpoint="${ENDPOINT}" />\n`
+  return content.slice(0, last.index) + trackingLine + content.slice(last.index)
+}
+
+function printManual(siteId) {
+  console.log(`Add this import to your app entry file:
+
+  import { SiteVigil } from '${PACKAGE}/react'
+
+Then add the component inside your JSX tree:
+
+  <SiteVigil
+    siteId="${siteId}"
+    endpoint="${ENDPOINT}"
+  />
+`)
+}
+
+async function init() {
+  console.log(`${PACKAGE} init\n`)
+
+  const siteId = await promptSiteId()
+  if (!siteId) {
+    console.error('Error: site ID is required.')
+    process.exit(1)
+  }
+
+  const found = await findAppFile(process.cwd())
+  if (!found) {
+    console.log('Could not find src/App.tsx or src/main.tsx. Add manually:\n')
+    printManual(siteId)
+    return
+  }
+
+  console.log(`Found: ${found.rel}`)
+
+  let content = await readFile(found.path, 'utf-8')
+
+  if (hasComponent(content)) {
+    console.log(`\n<SiteVigil /> is already present in ${found.rel}. Nothing to do.`)
+    return
+  }
+
+  content = patchImports(content)
+  const patched = patchJsx(content, siteId)
+
+  if (!patched) {
+    console.log('Could not automatically patch JSX. Add manually:\n')
+    printManual(siteId)
+    return
+  }
+
+  await writeFile(found.path, patched, 'utf-8')
+
+  console.log(`
+Done! Added <SiteVigil /> to ${found.rel}.
+
+To verify:
+  1. Start your dev server
+  2. Open DevTools -> Network, filter for "t.site-vigil.com"
+  3. Reload - you should see a POST with status 200
+  4. Check your dashboard at https://app.site-vigil.com - a visit for "${siteId}" should be recorded
+`)
+}
+
+// ---------------------------------------------------------------------------
+// remove
+// ---------------------------------------------------------------------------
+
+function stripTracking(content) {
+  let result = content
+
+  // import lines referencing the package (any specifier, either quote style)
+  result = result.replace(
+    new RegExp(`^[ \\t]*import\\s[^\\n]*["']${PACKAGE}(?:/[^"']*)?["'][^\\n]*\\r?\\n?`, 'gm'),
+    ''
+  )
+
+  // <Tracking> is the pre-0.3.0 component name; keep stripping it so remove
+  // also cleans up sites integrated with older versions.
+  const NAMES = /SiteVigil|Tracking/
+
+  // <SiteVigil ... /> on its own line(s), self-closing (possibly multi-line)
+  result = result.replace(
+    new RegExp(`^[ \\t]*<(?:${NAMES.source})\\b[\\s\\S]*?/>[ \\t]*\\r?\\n?`, 'gm'), '')
+
+  // <SiteVigil>...</SiteVigil> with children, on its own line(s)
+  result = result.replace(
+    new RegExp(`^[ \\t]*<(${NAMES.source})\\b[\\s\\S]*?</\\1>[ \\t]*\\r?\\n?`, 'gm'), '')
+
+  // any inline occurrences that were not at the start of a line
+  result = result.replace(new RegExp(`<(?:${NAMES.source})\\b[\\s\\S]*?/>`, 'g'), '')
+  result = result.replace(new RegExp(`<(${NAMES.source})\\b[\\s\\S]*?</\\1>`, 'g'), '')
+
+  return result
+}
+
+async function remove() {
+  console.log(`${PACKAGE} remove\n`)
+
+  const cwd = process.cwd()
+  const files = await collectSourceFiles(join(cwd, 'src'))
+
+  if (!files.length) {
+    console.log('No source files found under src/. Nothing to do.')
+    return
+  }
+
+  const changed = []
+  const needsReview = []
+
+  for (const file of files) {
+    const content = await readFile(file, 'utf-8')
+    if (!content.includes(PACKAGE) && !hasComponent(content)) continue
+
+    const stripped = stripTracking(content)
+    if (stripped !== content) {
+      await writeFile(file, stripped, 'utf-8')
+      changed.push(relative(cwd, file))
+    }
+
+    if (/site-vigil|createTracker|<(?:SiteVigil|Tracking)\b/.test(stripped)) {
+      needsReview.push(relative(cwd, file))
+    }
+  }
+
+  if (changed.length) {
+    console.log('Removed tracking code from:')
+    for (const rel of changed) console.log(`  - ${rel}`)
+  } else {
+    console.log('No tracking code found in src/.')
+  }
+
+  if (needsReview.length) {
+    console.log('\nWarning: these files still reference the package and need manual review:')
+    for (const rel of needsReview) console.log(`  - ${rel}`)
+  }
+
+  console.log(`
+Now remove the package itself:
+
+  npm uninstall ${PACKAGE}
+`)
+}
+
+// ---------------------------------------------------------------------------
+// entry point
+// ---------------------------------------------------------------------------
+
+function printUsage() {
+  console.log(`Usage: npx ${PACKAGE} <command>
+
+Commands:
+  init      Add the <Tracking /> snippet to your app (prompts for a site ID,
+            or pass --site-id=my-site)
+  remove    Strip all tracking code from src/ (run BEFORE npm uninstall)
+`)
+}
+
+const command = process.argv[2] && !process.argv[2].startsWith('--')
+  ? process.argv[2]
+  : 'init'
+
+const run = { init, remove, uninstall: remove }[command]
+
+if (!run) {
+  console.error(`Unknown command: ${command}\n`)
+  printUsage()
+  process.exit(1)
+}
+
+run().catch(err => {
+  console.error(err.message)
+  process.exit(1)
+})

package/dist/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEnD,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;CAC/D;AAYD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,UAA6B,EAC7B,iBAAwB,GACzB,EAAE,aAAa,GAAG,OAAO,CA8DzB"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iBAAiB,CAAC,EAAE,OAAO,CAAA;CAC5B;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAEnD,MAAM,WAAW,OAAO;IACtB,KAAK,EAAE,MAAM,IAAI,CAAA;IACjB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,aAAa,EAAE,MAAM,IAAI,CAAA;IACzB,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,aAAa,KAAK,IAAI,CAAA;CAC/D;AAYD,wBAAgB,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,UAA6B,EAC7B,iBAAwB,GACzB,EAAE,aAAa,GAAG,OAAO,CA6EzB"}

package/dist/core.js

@@ -32,24 +32,39 @@ export function createTracker({ siteId, endpoint, sessionKey = 'tithij_session',
             ...metadata,
         };
         const body = JSON.stringify(payload);
+        if (typeof navigator.sendBeacon === 'function') {
+            const blob = new Blob([body], { type: 'application/json' });
+            if (navigator.sendBeacon(endpoint, blob))
+                return;
+        }
         void fetch(endpoint, {
             method: 'POST',
+            mode: 'cors',
+            credentials: 'omit',
             headers: { 'Content-Type': 'application/json' },
             body,
             keepalive: true,
         }).catch(() => { });
     };
-    const handleBeforeUnload = () => send('leave');
+    const handlePageLeave = () => send('leave');
+    const handleVisibilityChange = () => {
+        if (document.visibilityState === 'hidden')
+            handlePageLeave();
+    };
     return {
         start() {
             send('visit');
             if (includeLeaveEvent && isBrowser) {
-                window.addEventListener('beforeunload', handleBeforeUnload);
+                window.addEventListener('beforeunload', handlePageLeave);
+                window.addEventListener('pagehide', handlePageLeave);
+                document.addEventListener('visibilitychange', handleVisibilityChange);
             }
         },
         destroy() {
             if (includeLeaveEvent && isBrowser) {
-                window.removeEventListener('beforeunload', handleBeforeUnload);
+                window.removeEventListener('beforeunload', handlePageLeave);
+                window.removeEventListener('pagehide', handlePageLeave);
+                document.removeEventListener('visibilitychange', handleVisibilityChange);
             }
         },
         trackPageView() {

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAgBA,SAAS,eAAe;IACtB,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IAEzE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,EAAE,CAAA;IACrB,CAAC;IAED,OAAO,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,UAAU,GAAG,gBAAgB,EAC7B,iBAAiB,GAAG,IAAI,GACV;IACd,MAAM,SAAS,GACb,OAAO,MAAM,KAAK,WAAW;QAC7B,OAAO,QAAQ,KAAK,WAAW;QAC/B,OAAO,SAAS,KAAK,WAAW,CAAA;IAElC,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,SAAS;YAAE,OAAO,QAAQ,CAAA;QAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAC1D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;QAE7B,MAAM,EAAE,GAAG,eAAe,EAAE,CAAA;QAC5B,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;QAC7C,OAAO,EAAE,CAAA;IACX,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,WAA0B,EAAE,EAAE,EAAE;QAC5D,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,MAAM,OAAO,GAAG;YACd,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAC9B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM;YACN,SAAS,EAAE,YAAY,EAAE;YACzB,GAAG,QAAQ;SACZ,CAAA;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAEpC,KAAK,KAAK,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI;YACJ,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAE9C,OAAO;QACL,KAAK;YACH,IAAI,CAAC,OAAO,CAAC,CAAA;YAEb,IAAI,iBAAiB,IAAI,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;YAC7D,CAAC;QACH,CAAC;QACD,OAAO;YACL,IAAI,iBAAiB,IAAI,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAA;YAChE,CAAC;QACH,CAAC;QACD,aAAa;YACX,IAAI,CAAC,OAAO,CAAC,CAAA;QACf,CAAC;QACD,UAAU,CAAC,MAAc,EAAE,WAA0B,EAAE;YACrD,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACxB,CAAC;KACF,CAAA;AACH,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAgBA,SAAS,eAAe;IACtB,MAAM,UAAU,GAAG,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAA;IAEzE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,EAAE,CAAA;IACrB,CAAC;IAED,OAAO,WAAW,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;AACvE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAC5B,MAAM,EACN,QAAQ,EACR,UAAU,GAAG,gBAAgB,EAC7B,iBAAiB,GAAG,IAAI,GACV;IACd,MAAM,SAAS,GACb,OAAO,MAAM,KAAK,WAAW;QAC7B,OAAO,QAAQ,KAAK,WAAW;QAC/B,OAAO,SAAS,KAAK,WAAW,CAAA;IAElC,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,IAAI,CAAC,SAAS;YAAE,OAAO,QAAQ,CAAA;QAE/B,MAAM,QAAQ,GAAG,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QAC1D,IAAI,QAAQ;YAAE,OAAO,QAAQ,CAAA;QAE7B,MAAM,EAAE,GAAG,eAAe,EAAE,CAAA;QAC5B,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;QAC7C,OAAO,EAAE,CAAA;IACX,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,CAAC,MAAc,EAAE,WAA0B,EAAE,EAAE,EAAE;QAC5D,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,MAAM,OAAO,GAAG;YACd,MAAM;YACN,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAC9B,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,MAAM;YACN,SAAS,EAAE,YAAY,EAAE;YACzB,GAAG,QAAQ;SACZ,CAAA;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAEpC,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;YAC/C,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,kBAAkB,EAAE,CAAC,CAAA;YAC3D,IAAI,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,IAAI,CAAC;gBAAE,OAAM;QAClD,CAAC;QAED,KAAK,KAAK,CAAC,QAAQ,EAAE;YACnB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,MAAM;YACZ,WAAW,EAAE,MAAM;YACnB,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI;YACJ,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;IACpB,CAAC,CAAA;IAED,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;IAE3C,MAAM,sBAAsB,GAAG,GAAG,EAAE;QAClC,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ;YAAE,eAAe,EAAE,CAAA;IAC9D,CAAC,CAAA;IAED,OAAO;QACL,KAAK;YACH,IAAI,CAAC,OAAO,CAAC,CAAA;YAEb,IAAI,iBAAiB,IAAI,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,gBAAgB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAA;gBACxD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;gBACpD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAA;YACvE,CAAC;QACH,CAAC;QACD,OAAO;YACL,IAAI,iBAAiB,IAAI,SAAS,EAAE,CAAC;gBACnC,MAAM,CAAC,mBAAmB,CAAC,cAAc,EAAE,eAAe,CAAC,CAAA;gBAC3D,MAAM,CAAC,mBAAmB,CAAC,UAAU,EAAE,eAAe,CAAC,CAAA;gBACvD,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAAA;YAC1E,CAAC;QACH,CAAC;QACD,aAAa;YACX,IAAI,CAAC,OAAO,CAAC,CAAA;QACf,CAAC;QACD,UAAU,CAAC,MAAc,EAAE,WAA0B,EAAE;YACrD,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;QACxB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { type TrackerConfig } from './core.js';
-export interface TrackingProps extends TrackerConfig {
+export interface SiteVigilProps extends TrackerConfig {
 }
-export declare function Tracking({ siteId, endpoint, sessionKey, includeLeaveEvent, }: TrackingProps): null;
+export declare function SiteVigil({ siteId, endpoint, sessionKey, includeLeaveEvent, }: SiteVigilProps): null;
 //# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AAE7D,MAAM,WAAW,aAAc,SAAQ,aAAa;CAAG;AAEvD,wBAAgB,QAAQ,CAAC,EACvB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,iBAAiB,GAClB,EAAE,aAAa,QAiBf"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AACA,OAAO,EAAiB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAA;AAE7D,MAAM,WAAW,cAAe,SAAQ,aAAa;CAAG;AAExD,wBAAgB,SAAS,CAAC,EACxB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,iBAAiB,GAClB,EAAE,cAAc,QAiBhB"}

package/dist/react.js

@@ -1,6 +1,6 @@
 import { useEffect } from 'react';
 import { createTracker } from './core.js';
-export function Tracking({ siteId, endpoint, sessionKey, includeLeaveEvent, }) {
+export function SiteVigil({ siteId, endpoint, sessionKey, includeLeaveEvent, }) {
     useEffect(() => {
         const tracker = createTracker({
             siteId,

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAA;AAI7D,MAAM,UAAU,QAAQ,CAAC,EACvB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,iBAAiB,GACH;IACd,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,MAAM;YACN,QAAQ;YACR,UAAU;YACV,iBAAiB;SAClB,CAAC,CAAA;QAEF,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,OAAO,EAAE,CAAA;QACnB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAA;IAErD,OAAO,IAAI,CAAA;AACb,CAAC"}
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAA;AACjC,OAAO,EAAE,aAAa,EAAsB,MAAM,WAAW,CAAA;AAI7D,MAAM,UAAU,SAAS,CAAC,EACxB,MAAM,EACN,QAAQ,EACR,UAAU,EACV,iBAAiB,GACF;IACf,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,OAAO,GAAG,aAAa,CAAC;YAC5B,MAAM;YACN,QAAQ;YACR,UAAU;YACV,iBAAiB;SAClB,CAAC,CAAA;QAEF,OAAO,CAAC,KAAK,EAAE,CAAA;QAEf,OAAO,GAAG,EAAE;YACV,OAAO,CAAC,OAAO,EAAE,CAAA;QACnB,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAA;IAErD,OAAO,IAAI,CAAA;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "site-vigil-visitors",
-  "version": "0.1.3",
+  "version": "0.3.0",
   "description": "Lightweight browser visit tracking with optional React integration.",
   "license": "MIT",
   "type": "module",
@@ -19,7 +19,7 @@
     }
   },
   "bin": {
-    "site-vigil-visitors": "bin/init.mjs"
+    "site-vigil-visitors": "bin/cli.mjs"
   },
   "files": [
     "dist",

package/bin/init.mjs

@@ -1,124 +0,0 @@
-#!/usr/bin/env node
-import { createInterface } from 'node:readline'
-import { readFile, writeFile, access } from 'node:fs/promises'
-import { join } from 'node:path'
-
-const ENDPOINT = 'https://t.site-vigil.com'
-
-const CANDIDATES = [
-  'src/App.tsx',
-  'src/App.jsx',
-  'src/main.tsx',
-  'src/main.jsx',
-]
-
-async function findAppFile(cwd) {
-  for (const candidate of CANDIDATES) {
-    try {
-      await access(join(cwd, candidate))
-      return { path: join(cwd, candidate), rel: candidate }
-    } catch {}
-  }
-  return null
-}
-
-async function promptSiteId() {
-  const arg = process.argv.find(a => a.startsWith('--site-id='))
-  if (arg) return arg.slice('--site-id='.length).trim()
-
-  const rl = createInterface({ input: process.stdin, output: process.stdout })
-  return new Promise(resolve => {
-    rl.question('Enter your site ID (e.g. my-website): ', answer => {
-      rl.close()
-      resolve(answer.trim())
-    })
-  })
-}
-
-function patchImports(content) {
-  if (content.includes("from 'site-vigil-visitors/react'")) return content
-  const matches = [...content.matchAll(/^import .+$/gm)]
-  if (!matches.length) return content
-  const last = matches.at(-1)
-  const pos = last.index + last[0].length
-  return (
-    content.slice(0, pos) +
-    "\nimport { Tracking } from 'site-vigil-visitors/react'" +
-    content.slice(pos)
-  )
-}
-
-function patchJsx(content, siteId) {
-  if (content.includes('<Tracking ')) return content
-
-  // Match the first non-self-closing JSX opening tag (capital-letter component) and
-  // insert <Tracking /> as its first child, matching the sibling's indentation.
-  const firstParentTag = /^([ \t]+<[A-Z][^\n]*[^/]>)([ \t]*\n)([ \t]+<)/m
-  const m = content.match(firstParentTag)
-  if (!m) return null
-
-  const indent = m[3].match(/^([ \t]+)/)[1]
-  const trackingLine = `${indent}<Tracking siteId="${siteId}" endpoint="${ENDPOINT}" />\n`
-  return content.replace(firstParentTag, `$1$2${trackingLine}$3`)
-}
-
-function printManual(siteId) {
-  console.log(`Add this import to your app entry file:
-
-  import { Tracking } from 'site-vigil-visitors/react'
-
-Then add the component inside your JSX tree:
-
-  <Tracking
-    siteId="${siteId}"
-    endpoint="${ENDPOINT}"
-  />
-`)
-}
-
-async function main() {
-  console.log('site-vigil-visitors init\n')
-
-  const siteId = await promptSiteId()
-  if (!siteId) {
-    console.error('Error: site ID is required.')
-    process.exit(1)
-  }
-
-  const found = await findAppFile(process.cwd())
-  if (!found) {
-    console.log('Could not find src/App.tsx or src/main.tsx. Add manually:\n')
-    printManual(siteId)
-    return
-  }
-
-  console.log(`Found: ${found.rel}`)
-
-  let content = await readFile(found.path, 'utf-8')
-  content = patchImports(content)
-  const patched = patchJsx(content, siteId)
-
-  if (!patched) {
-    console.log('Could not automatically patch JSX. Add manually:\n')
-    printManual(siteId)
-    return
-  }
-
-  await writeFile(found.path, patched, 'utf-8')
-
-  console.log(`
-Done! Added <Tracking /> to ${found.rel}.
-
-To verify:
-  1. Start your dev server
-  2. Open DevTools → Network, filter for "t.site-vigil.com"
-  3. Reload — you should see a POST with status 200
-
-Note: make sure "${siteId}" is registered in your Supabase websites table (tracking_id column).
-`)
-}
-
-main().catch(err => {
-  console.error(err.message)
-  process.exit(1)
-})