@hyperdrive.bot/plugin-telemetry 0.1.2

package/bin/run.js

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+
+import {execute} from '@oclif/core'
+
+await execute({dir: import.meta.url})

package/dist/chunk-YMQEC245.js

@@ -0,0 +1,54 @@
+// src/config.ts
+import { createHash } from "crypto";
+import { hostname, userInfo } from "os";
+var GA4_MEASUREMENT_ID = true ? "__GA4_MEASUREMENT_ID__" : "__GA4_MEASUREMENT_ID__";
+var GA4_API_SECRET = true ? "__GA4_API_SECRET__" : "__GA4_API_SECRET__";
+var GA4_ENDPOINT = "https://www.google-analytics.com/mp/collect";
+function isConfigured() {
+  return typeof GA4_MEASUREMENT_ID === "string" && typeof GA4_API_SECRET === "string" && !GA4_MEASUREMENT_ID.startsWith("__") && !GA4_MEASUREMENT_ID.endsWith("__") && !GA4_API_SECRET.startsWith("__") && !GA4_API_SECRET.endsWith("__") && GA4_MEASUREMENT_ID.length > 0 && GA4_API_SECRET.length > 0;
+}
+function getPlatformGA4Config() {
+  return {
+    measurementId: GA4_MEASUREMENT_ID,
+    apiSecret: GA4_API_SECRET,
+    isConfigured: isConfigured()
+  };
+}
+function getClientId() {
+  const machineIdentifier = `${hostname()}:${userInfo().username}`;
+  const hash = createHash("sha256").update(machineIdentifier).digest("hex");
+  return hash.slice(0, 32);
+}
+
+// src/ga4-client.ts
+function sendEvent(event) {
+  if (!isConfigured()) return;
+  const url = `${GA4_ENDPOINT}?measurement_id=${GA4_MEASUREMENT_ID}&api_secret=${GA4_API_SECRET}`;
+  const body = JSON.stringify({
+    client_id: getClientId(),
+    events: [event]
+  });
+  const controller = new AbortController();
+  const timeout = setTimeout(() => controller.abort(), 5e3);
+  fetch(url, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body,
+    signal: controller.signal
+  }).then(() => {
+    clearTimeout(timeout);
+  }).catch(() => {
+    clearTimeout(timeout);
+  });
+}
+
+export {
+  GA4_MEASUREMENT_ID,
+  GA4_API_SECRET,
+  GA4_ENDPOINT,
+  isConfigured,
+  getPlatformGA4Config,
+  getClientId,
+  sendEvent
+};
+//# sourceMappingURL=chunk-YMQEC245.js.map

package/dist/chunk-YMQEC245.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts","../src/ga4-client.ts"],"sourcesContent":["import {createHash} from 'node:crypto'\nimport {hostname, userInfo} from 'node:os'\n\n/**\n * Build-time credential placeholders — esbuild `define` replaces these identifiers.\n * The typeof guard provides safe fallback when running via ts-node (tests).\n */\ndeclare const __GA4_MEASUREMENT_ID__: string\ndeclare const __GA4_API_SECRET__: string\n\n/**\n * GA4 Measurement ID — build-time placeholder.\n * CI replaces this value via tsup/esbuild define before publish.\n * When still set to the placeholder, sendEvent() no-ops.\n */\nexport const GA4_MEASUREMENT_ID: string =\n  typeof __GA4_MEASUREMENT_ID__ !== 'undefined' ? __GA4_MEASUREMENT_ID__ : '__GA4_MEASUREMENT_ID__'\n\n/**\n * GA4 API Secret — build-time placeholder.\n * CI replaces this value via tsup/esbuild define before publish.\n * When still set to the placeholder, sendEvent() no-ops.\n */\nexport const GA4_API_SECRET: string =\n  typeof __GA4_API_SECRET__ !== 'undefined' ? __GA4_API_SECRET__ : '__GA4_API_SECRET__'\n\n/**\n * GA4 Measurement Protocol endpoint\n */\nexport const GA4_ENDPOINT = 'https://www.google-analytics.com/mp/collect'\n\n/**\n * Check if GA4 credentials have been injected at build time.\n * Returns false when placeholders are still present (local dev without env vars).\n */\nexport function isConfigured(): boolean {\n  return (\n    typeof GA4_MEASUREMENT_ID === 'string' &&\n    typeof GA4_API_SECRET === 'string' &&\n    !GA4_MEASUREMENT_ID.startsWith('__') &&\n    !GA4_MEASUREMENT_ID.endsWith('__') &&\n    !GA4_API_SECRET.startsWith('__') &&\n    !GA4_API_SECRET.endsWith('__') &&\n    GA4_MEASUREMENT_ID.length > 0 &&\n    GA4_API_SECRET.length > 0\n  )\n}\n\n/**\n * Get the full GA4 platform configuration.\n *\n * @returns Object with measurementId, apiSecret, and isConfigured flag\n */\nexport function getPlatformGA4Config(): {measurementId: string; apiSecret: string; isConfigured: boolean} {\n  return {\n    measurementId: GA4_MEASUREMENT_ID,\n    apiSecret: GA4_API_SECRET,\n    isConfigured: isConfigured(),\n  }\n}\n\n/**\n * Generate a stable, anonymous client ID from the machine's hostname and username.\n * Returns 32 hex characters (truncated SHA-256 hash).\n * This provides a consistent identifier per machine without leaking PII.\n */\nexport function getClientId(): string {\n  const machineIdentifier = `${hostname()}:${userInfo().username}`\n  const hash = createHash('sha256').update(machineIdentifier).digest('hex')\n  return hash.slice(0, 32)\n}\n","import {GA4_MEASUREMENT_ID, GA4_API_SECRET, GA4_ENDPOINT, isConfigured, getClientId} from './config.js'\n\n/**\n * GA4 event structure for the Measurement Protocol\n */\nexport interface GA4Event {\n  name: string\n  params: Record<string, string | number>\n}\n\n/**\n * Send an event to GA4 via the Measurement Protocol.\n *\n * Fire-and-forget: this function returns void and never throws.\n * The HTTP request is not awaited — it runs in the background.\n * All errors (network, timeout, non-2xx) are silently swallowed.\n *\n * No-ops when GA4 credentials are still build-time placeholders.\n */\nexport function sendEvent(event: GA4Event): void {\n  if (!isConfigured()) return\n\n  const url = `${GA4_ENDPOINT}?measurement_id=${GA4_MEASUREMENT_ID}&api_secret=${GA4_API_SECRET}`\n\n  const body = JSON.stringify({\n    client_id: getClientId(),\n    events: [event],\n  })\n\n  const controller = new AbortController()\n  const timeout = setTimeout(() => controller.abort(), 5000)\n\n  fetch(url, {\n    method: 'POST',\n    headers: {'Content-Type': 'application/json'},\n    body,\n    signal: controller.signal,\n  })\n    .then(() => {\n      clearTimeout(timeout)\n    })\n    .catch(() => {\n      clearTimeout(timeout)\n      // Silently swallow all errors — fire-and-forget\n    })\n}\n"],"mappings":";AAAA,SAAQ,kBAAiB;AACzB,SAAQ,UAAU,gBAAe;AAc1B,IAAM,qBACX,OAAgD,2BAAyB;AAOpE,IAAM,iBACX,OAA4C,uBAAqB;AAK5D,IAAM,eAAe;AAMrB,SAAS,eAAwB;AACtC,SACE,OAAO,uBAAuB,YAC9B,OAAO,mBAAmB,YAC1B,CAAC,mBAAmB,WAAW,IAAI,KACnC,CAAC,mBAAmB,SAAS,IAAI,KACjC,CAAC,eAAe,WAAW,IAAI,KAC/B,CAAC,eAAe,SAAS,IAAI,KAC7B,mBAAmB,SAAS,KAC5B,eAAe,SAAS;AAE5B;AAOO,SAAS,uBAA0F;AACxG,SAAO;AAAA,IACL,eAAe;AAAA,IACf,WAAW;AAAA,IACX,cAAc,aAAa;AAAA,EAC7B;AACF;AAOO,SAAS,cAAsB;AACpC,QAAM,oBAAoB,GAAG,SAAS,CAAC,IAAI,SAAS,EAAE,QAAQ;AAC9D,QAAM,OAAO,WAAW,QAAQ,EAAE,OAAO,iBAAiB,EAAE,OAAO,KAAK;AACxE,SAAO,KAAK,MAAM,GAAG,EAAE;AACzB;;;ACnDO,SAAS,UAAU,OAAuB;AAC/C,MAAI,CAAC,aAAa,EAAG;AAErB,QAAM,MAAM,GAAG,YAAY,mBAAmB,kBAAkB,eAAe,cAAc;AAE7F,QAAM,OAAO,KAAK,UAAU;AAAA,IAC1B,WAAW,YAAY;AAAA,IACvB,QAAQ,CAAC,KAAK;AAAA,EAChB,CAAC;AAED,QAAM,aAAa,IAAI,gBAAgB;AACvC,QAAM,UAAU,WAAW,MAAM,WAAW,MAAM,GAAG,GAAI;AAEzD,QAAM,KAAK;AAAA,IACT,QAAQ;AAAA,IACR,SAAS,EAAC,gBAAgB,mBAAkB;AAAA,IAC5C;AAAA,IACA,QAAQ,WAAW;AAAA,EACrB,CAAC,EACE,KAAK,MAAM;AACV,iBAAa,OAAO;AAAA,EACtB,CAAC,EACA,MAAM,MAAM;AACX,iBAAa,OAAO;AAAA,EAEtB,CAAC;AACL;","names":[]}

package/dist/hooks/postrun.d.ts

@@ -0,0 +1,12 @@
+import { Hook } from '@oclif/core';
+
+/**
+ * oclif postrun hook — emits cli_command or cli_command_error GA4 events
+ * after every CLI command execution.
+ *
+ * Fire-and-forget: sendEvent() is called without await.
+ * The entire body is wrapped in try/catch to never propagate errors to oclif.
+ */
+declare const hook: Hook.Postrun;
+
+export { hook as default };

package/dist/hooks/postrun.js

@@ -0,0 +1,37 @@
+import {
+  sendEvent
+} from "../chunk-YMQEC245.js";
+
+// src/hooks/postrun.ts
+var hook = async function(options) {
+  try {
+    const command = options.Command?.id ?? "unknown";
+    const cli = options.config?.pjson?.name ?? "unknown";
+    const cliVersion = options.config?.pjson?.version ?? "unknown";
+    const plugin = options.Command?.plugin?.name ?? cli;
+    const os = process.platform;
+    const nodeVersion = process.version;
+    const params = {
+      command,
+      cli,
+      cli_version: cliVersion,
+      plugin,
+      os,
+      node_version: nodeVersion
+    };
+    if (options.error) {
+      const error = options.error;
+      const errorType = error.constructor?.name || "unknown";
+      params.error_type = errorType.slice(0, 100);
+      sendEvent({ name: "cli_command_error", params });
+    } else {
+      sendEvent({ name: "cli_command", params });
+    }
+  } catch {
+  }
+};
+var postrun_default = hook;
+export {
+  postrun_default as default
+};
+//# sourceMappingURL=postrun.js.map

package/dist/hooks/postrun.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/postrun.ts"],"sourcesContent":["import type {Hook} from '@oclif/core'\n\nimport {sendEvent} from '../ga4-client.js'\n\n/**\n * oclif postrun hook — emits cli_command or cli_command_error GA4 events\n * after every CLI command execution.\n *\n * Fire-and-forget: sendEvent() is called without await.\n * The entire body is wrapped in try/catch to never propagate errors to oclif.\n */\nconst hook: Hook.Postrun = async function (options) {\n  try {\n    const command = options.Command?.id ?? 'unknown'\n    const cli = options.config?.pjson?.name ?? 'unknown'\n    const cliVersion = options.config?.pjson?.version ?? 'unknown'\n    const plugin = options.Command?.plugin?.name ?? cli\n    const os = process.platform\n    const nodeVersion = process.version\n\n    const params: Record<string, string> = {\n      command,\n      cli,\n      cli_version: cliVersion,\n      plugin,\n      os,\n      node_version: nodeVersion,\n    }\n\n    if ((options as {error?: Error}).error) {\n      const error = (options as {error?: Error}).error!\n      const errorType = error.constructor?.name || 'unknown'\n      params.error_type = errorType.slice(0, 100)\n      sendEvent({name: 'cli_command_error', params})\n    } else {\n      sendEvent({name: 'cli_command', params})\n    }\n  } catch {\n    // Silently swallow all errors — the hook must never throw\n  }\n}\n\nexport default hook\n"],"mappings":";;;;;AAWA,IAAM,OAAqB,eAAgB,SAAS;AAClD,MAAI;AACF,UAAM,UAAU,QAAQ,SAAS,MAAM;AACvC,UAAM,MAAM,QAAQ,QAAQ,OAAO,QAAQ;AAC3C,UAAM,aAAa,QAAQ,QAAQ,OAAO,WAAW;AACrD,UAAM,SAAS,QAAQ,SAAS,QAAQ,QAAQ;AAChD,UAAM,KAAK,QAAQ;AACnB,UAAM,cAAc,QAAQ;AAE5B,UAAM,SAAiC;AAAA,MACrC;AAAA,MACA;AAAA,MACA,aAAa;AAAA,MACb;AAAA,MACA;AAAA,MACA,cAAc;AAAA,IAChB;AAEA,QAAK,QAA4B,OAAO;AACtC,YAAM,QAAS,QAA4B;AAC3C,YAAM,YAAY,MAAM,aAAa,QAAQ;AAC7C,aAAO,aAAa,UAAU,MAAM,GAAG,GAAG;AAC1C,gBAAU,EAAC,MAAM,qBAAqB,OAAM,CAAC;AAAA,IAC/C,OAAO;AACL,gBAAU,EAAC,MAAM,eAAe,OAAM,CAAC;AAAA,IACzC;AAAA,EACF,QAAQ;AAAA,EAER;AACF;AAEA,IAAO,kBAAQ;","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,59 @@
+export { run } from '@oclif/core';
+
+/**
+ * GA4 event structure for the Measurement Protocol
+ */
+interface GA4Event {
+    name: string;
+    params: Record<string, string | number>;
+}
+/**
+ * Send an event to GA4 via the Measurement Protocol.
+ *
+ * Fire-and-forget: this function returns void and never throws.
+ * The HTTP request is not awaited — it runs in the background.
+ * All errors (network, timeout, non-2xx) are silently swallowed.
+ *
+ * No-ops when GA4 credentials are still build-time placeholders.
+ */
+declare function sendEvent(event: GA4Event): void;
+
+/**
+ * GA4 Measurement ID — build-time placeholder.
+ * CI replaces this value via tsup/esbuild define before publish.
+ * When still set to the placeholder, sendEvent() no-ops.
+ */
+declare const GA4_MEASUREMENT_ID: string;
+/**
+ * GA4 API Secret — build-time placeholder.
+ * CI replaces this value via tsup/esbuild define before publish.
+ * When still set to the placeholder, sendEvent() no-ops.
+ */
+declare const GA4_API_SECRET: string;
+/**
+ * GA4 Measurement Protocol endpoint
+ */
+declare const GA4_ENDPOINT = "https://www.google-analytics.com/mp/collect";
+/**
+ * Check if GA4 credentials have been injected at build time.
+ * Returns false when placeholders are still present (local dev without env vars).
+ */
+declare function isConfigured(): boolean;
+/**
+ * Get the full GA4 platform configuration.
+ *
+ * @returns Object with measurementId, apiSecret, and isConfigured flag
+ */
+declare function getPlatformGA4Config(): {
+    measurementId: string;
+    apiSecret: string;
+    isConfigured: boolean;
+};
+/**
+ * Generate a stable, anonymous client ID from the machine's hostname and username.
+ * Returns 32 hex characters (truncated SHA-256 hash).
+ * This provides a consistent identifier per machine without leaking PII.
+ */
+declare function getClientId(): string;
+
+export { type GA4Event, GA4_API_SECRET, GA4_ENDPOINT, GA4_MEASUREMENT_ID, getClientId, getPlatformGA4Config, isConfigured, sendEvent };

package/dist/index.js

@@ -0,0 +1,23 @@
+import {
+  GA4_API_SECRET,
+  GA4_ENDPOINT,
+  GA4_MEASUREMENT_ID,
+  getClientId,
+  getPlatformGA4Config,
+  isConfigured,
+  sendEvent
+} from "./chunk-YMQEC245.js";
+
+// src/index.ts
+import { run } from "@oclif/core";
+export {
+  GA4_API_SECRET,
+  GA4_ENDPOINT,
+  GA4_MEASUREMENT_ID,
+  getClientId,
+  getPlatformGA4Config,
+  isConfigured,
+  run,
+  sendEvent
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export {run} from '@oclif/core'\nexport {sendEvent} from './ga4-client.js'\nexport type {GA4Event} from './ga4-client.js'\nexport {isConfigured, getClientId, getPlatformGA4Config, GA4_MEASUREMENT_ID, GA4_API_SECRET, GA4_ENDPOINT} from './config.js'\n"],"mappings":";;;;;;;;;;;AAAA,SAAQ,WAAU;","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@hyperdrive.bot/plugin-telemetry",
+  "version": "0.1.2",
+  "description": "Shared telemetry plugin for DevSquad CLIs — tracks command usage via GA4 Measurement Protocol",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "bin": {
+    "plugin-telemetry": "./bin/run.js"
+  },
+  "files": [
+    "/bin",
+    "/dist",
+    "/oclif.manifest.json"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "build:types": "tsc -b",
+    "test": "mocha",
+    "prepack": "npm run build && npx oclif manifest || true"
+  },
+  "oclif": {
+    "bin": "plugin-telemetry",
+    "commands": "./dist/commands",
+    "hooks": {
+      "postrun": "./dist/hooks/postrun"
+    },
+    "topicSeparator": " "
+  },
+  "peerDependencies": {
+    "@oclif/core": "^4"
+  },
+  "devDependencies": {
+    "@oclif/core": "^4",
+    "@types/chai": "^4",
+    "@types/mocha": "^10",
+    "@types/node": "^20",
+    "@types/sinon": "^17",
+    "chai": "^4",
+    "esmock": "^2.7.3",
+    "mocha": "^10",
+    "oclif": "^4",
+    "sinon": "^17",
+    "ts-node": "^10",
+    "tsup": "^8.5.1",
+    "typescript": "^5"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  }
+}