feega 0.1.11 → 0.1.13

package/README.md

@@ -9,3 +9,9 @@ Starts feega's local mode on http://localhost:5173 and saves the canvas to `my-b
 Options: `--port <n>`, `--no-open`. `FEEGA_APP_BUNDLE=<path or url>` uses another bundle.
 
 AI keys: put them in the environment or in a `.env` in the folder you run `npx feega` from. Kie.ai, OpenRouter, the text LLM, Higgsfield, Wiro and ElevenLabs are supported; see the local mode docs for the variables.
+
+## Telemetry
+
+On start, `npx feega` sends one anonymous event to PostHog (EU): `npx_feega_started`, plus `npx_feega_active_day` on the first start of each day. Each carries the feega version, OS, CPU architecture, Node version and a random install id stored in `~/.feega/telemetry-id`. No IP or location is kept, and no canvas content, file names or paths are sent. The first run prints a one-line notice.
+
+Turn it off with `FEEGA_TELEMETRY=0` or `DO_NOT_TRACK=1`. It is also off when `CI` is set.

package/bin/feega.mjs

@@ -6,6 +6,7 @@ import { join } from 'node:path';
 import { Readable } from 'node:stream';
 import { pipeline } from 'node:stream/promises';
 
+import { sendTelemetry } from '../telemetry.mjs';
 import { MCP_ENTRY, USAGE, appDir, bundleSource, boundUrl, cachedVersions, freePort, isCached, latestAppVersion, markCached, mcpEnv, parseArgs, pickVersion } from '../launcher.mjs';
 
 const MIN_NODE_MAJOR = 22;
@@ -133,6 +134,13 @@ async function main() {
   }
 
   const { file, browser } = args;
+  const { version } = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+  void sendTelemetry({
+    home: homedir(),
+    env: process.env,
+    notify: (line) => console.error(line),
+    info: { version, platform: process.platform, arch: process.arch, node: process.versions.node }
+  });
   const port = await freePort(args.port);
 
   const url = boundUrl(port);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "feega",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "Run feega's infinite canvas locally, saved to a .feega file. No account, no database.",
   "license": "Apache-2.0",
   "type": "module",
@@ -9,7 +9,8 @@
   },
   "files": [
     "bin",
-    "launcher.mjs"
+    "launcher.mjs",
+    "telemetry.mjs"
   ],
   "engines": {
     "node": ">=22"

package/telemetry.mjs

@@ -0,0 +1,90 @@
+import { randomUUID } from 'node:crypto';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+const CAPTURE_URL = 'https://eu.i.posthog.com/capture/';
+const PUBLIC_KEY = 'phc_vyecfTVaAXEvHQYZoSzRzvsbPbQmafyeMGoeVJZYxvnA';
+const SEND_TIMEOUT_MS = 1500;
+const ID_FILE = 'telemetry-id';
+const DAY_FILE = 'telemetry-day';
+const OFF = '0';
+const ON = '1';
+
+export const EVENT = { started: 'npx_feega_started', activeDay: 'npx_feega_active_day' };
+
+export const NOTICE = 'feega: anonymous usage stats (version, OS, arch, Node version, random install id) are sent on start. Disable: FEEGA_TELEMETRY=0 or DO_NOT_TRACK=1.';
+
+export const isOptedOut = (env) => env.FEEGA_TELEMETRY === OFF || env.DO_NOT_TRACK === ON || Boolean(env.CI || env.VITEST);
+
+const configDir = (home) => join(home, '.feega');
+
+function readTrimmed(path) {
+  return existsSync(path) ? readFileSync(path, 'utf8').trim() : '';
+}
+
+export function installId(home) {
+  const path = join(configDir(home), ID_FILE);
+  const known = readTrimmed(path);
+  if (known) {
+    return known;
+  }
+
+  const id = randomUUID();
+  mkdirSync(configDir(home), { recursive: true });
+  writeFileSync(path, `${id}\n`);
+  return id;
+}
+
+export function buildEvent(event, id, info) {
+  return {
+    api_key: PUBLIC_KEY,
+    event,
+    distinct_id: id,
+    properties: {
+      version: info.version,
+      os: info.platform,
+      arch: info.arch,
+      node: info.node,
+      $process_person_profile: false,
+      $geoip_disable: true,
+      $ip: null
+    }
+  };
+}
+
+export const postEvent = (body) =>
+  fetch(CAPTURE_URL, {
+    method: 'POST',
+    headers: { 'content-type': 'application/json' },
+    body: JSON.stringify(body),
+    signal: AbortSignal.timeout(SEND_TIMEOUT_MS)
+  });
+
+function firstStartOfDay(home, today) {
+  const path = join(configDir(home), DAY_FILE);
+  if (readTrimmed(path) === today) {
+    return false;
+  }
+
+  writeFileSync(path, `${today}\n`);
+  return true;
+}
+
+const todayUtc = () => new Date().toISOString().slice(0, 10);
+
+export async function sendTelemetry({ home, info, env, send = postEvent, notify = () => {}, today = todayUtc() }) {
+  if (isOptedOut(env)) {
+    return;
+  }
+
+  try {
+    const firstRun = !existsSync(join(configDir(home), ID_FILE));
+    const id = installId(home);
+    if (firstRun) {
+      notify(NOTICE);
+    }
+
+    const events = firstStartOfDay(home, today) ? [EVENT.started, EVENT.activeDay] : [EVENT.started];
+    await Promise.all(events.map((event) => send(buildEvent(event, id, info))));
+  } catch {}
+}