@apso/cli 0.20.0 → 0.22.0

package/dist/lib/telemetry/telemetry.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.__testing = exports.shutdownTelemetry = exports.elapsedMs = exports.captureException = exports.track = exports.initTelemetry = void 0;
+const tslib_1 = require("tslib");
+/**
+ * CLI telemetry — usage analytics (PostHog) + error reporting (Sentry).
+ *
+ * Wired to the same Apso systems the web app and build engine use so CLI usage
+ * shows up in the same funnels. Fully opt-out:
+ *   - `apso config set telemetryDisabled true`
+ *   - env DO_NOT_TRACK=1  (honors the console.dev standard)
+ *   - env APSO_TELEMETRY_DISABLED=1
+ *
+ * Everything here is best-effort and MUST NOT throw or block a command. All
+ * public functions swallow their own errors. The PostHog project keys and the
+ * Sentry DSN are public client ingestion keys (the same class of token shipped
+ * to browsers), safe to bundle.
+ */
+const posthog_node_1 = require("posthog-node");
+const Sentry = tslib_1.__importStar(require("@sentry/node"));
+const crypto_1 = require("crypto");
+const os_1 = tslib_1.__importDefault(require("os"));
+const config_1 = require("../config");
+// Public ingestion keys (same tokens the browser/build-engine ship, per env).
+const POSTHOG_KEY_PROD = "phc_Es9UUMw8pOs7Bs21b5PhfC5Qdo94GpYVv8MfdrG12LC";
+const POSTHOG_KEY_STAGING = "phc_bkc33v3wo5LRvgPF6IdjsgDEDOwgJMz95MR2YIlvELk";
+const POSTHOG_HOST = "https://us.i.posthog.com";
+// Dedicated apsoai/apso-cli Sentry project DSN (public client key).
+const SENTRY_DSN_DEFAULT = "https://754ae10322af78af3edbb87b93383ebb@o4509208616435714.ingest.us.sentry.io/4511796852162560";
+let cliVersion = "0.0.0";
+try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    cliVersion = require("../../../package.json").version || cliVersion;
+}
+catch {
+    // ignore
+}
+let posthog = null;
+let enabled = false;
+let sentryOn = false;
+let distinctId = "cli-anonymous";
+let environment = "production";
+let startedAt = Date.now();
+function isDisabled(telemetryDisabled) {
+    if (process.env.DO_NOT_TRACK === "1" || process.env.DO_NOT_TRACK === "true")
+        return true;
+    if (process.env.APSO_TELEMETRY_DISABLED === "1")
+        return true;
+    return !!telemetryDisabled;
+}
+/** Stable, non-PII fallback id for logged-out users (no username, no MAC). */
+function anonMachineId() {
+    const seed = `${os_1.default.hostname()}|${os_1.default.platform()}|${os_1.default.arch()}`;
+    return "cli_" + (0, crypto_1.createHash)("sha256").update(seed).digest("hex").slice(0, 20);
+}
+/**
+ * Initialize telemetry. Call once at process start (init hook). Safe to call
+ * when disabled — it just no-ops everything downstream.
+ */
+function initTelemetry() {
+    var _a, _b, _c;
+    try {
+        startedAt = Date.now();
+        const cfg = config_1.globalConfig.read();
+        if (isDisabled(cfg.telemetryDisabled)) {
+            enabled = false;
+            return;
+        }
+        enabled = true;
+        environment = (cfg.apiUrl || "").includes("staging")
+            ? "staging"
+            : "production";
+        const creds = config_1.credentials.read();
+        distinctId = ((_a = creds === null || creds === void 0 ? void 0 : creds.user) === null || _a === void 0 ? void 0 : _a.id) || anonMachineId();
+        posthog = new posthog_node_1.PostHog(environment === "staging" ? POSTHOG_KEY_STAGING : POSTHOG_KEY_PROD, { host: POSTHOG_HOST, flushAt: 1, flushInterval: 0 });
+        if ((_b = creds === null || creds === void 0 ? void 0 : creds.user) === null || _b === void 0 ? void 0 : _b.email) {
+            // Attach identity so CLI events attribute to the same person as the app.
+            posthog.identify({
+                distinctId,
+                properties: { email: creds.user.email, name: creds.user.name },
+            });
+        }
+        const dsn = process.env.APSO_CLI_SENTRY_DSN || SENTRY_DSN_DEFAULT;
+        if (dsn) {
+            Sentry.init({
+                dsn,
+                environment,
+                release: `apso-cli@${cliVersion}`,
+                tracesSampleRate: 0,
+            });
+            Sentry.setUser({ id: distinctId, email: (_c = creds === null || creds === void 0 ? void 0 : creds.user) === null || _c === void 0 ? void 0 : _c.email });
+            Sentry.setTag("cli_version", cliVersion);
+            sentryOn = true;
+        }
+    }
+    catch {
+        enabled = false;
+    }
+}
+exports.initTelemetry = initTelemetry;
+function commonProps() {
+    return {
+        cli_version: cliVersion,
+        environment,
+        os: os_1.default.platform(),
+        arch: os_1.default.arch(),
+        node_version: process.version,
+        authenticated: distinctId !== anonMachineId() && !distinctId.startsWith("cli_"),
+    };
+}
+/** Emit a PostHog event. No-op when disabled. */
+function track(event, properties = {}) {
+    try {
+        if (!enabled || !posthog)
+            return;
+        posthog.capture({
+            distinctId,
+            event,
+            properties: { ...commonProps(), ...properties },
+        });
+    }
+    catch {
+        // never break a command over telemetry
+    }
+}
+exports.track = track;
+/** Report an exception to Sentry. No-op when disabled. */
+function captureException(err, context = {}) {
+    try {
+        if (!enabled || !sentryOn)
+            return;
+        Sentry.captureException(err, { extra: context });
+    }
+    catch {
+        // ignore
+    }
+}
+exports.captureException = captureException;
+/** Milliseconds since the process (CLI invocation) started. */
+function elapsedMs() {
+    return Date.now() - startedAt;
+}
+exports.elapsedMs = elapsedMs;
+/** Flush + close both clients. Call before the process exits. */
+async function shutdownTelemetry() {
+    try {
+        if (posthog)
+            await posthog.shutdown();
+    }
+    catch {
+        // ignore
+    }
+    try {
+        if (sentryOn)
+            await Sentry.close(2000);
+    }
+    catch {
+        // ignore
+    }
+}
+exports.shutdownTelemetry = shutdownTelemetry;
+exports.__testing = { isDisabled, anonMachineId };

package/dist/lib/templates/go/header.eta

@@ -1,3 +1,4 @@
-// Code generated by APSO CLI. DO NOT EDIT.
-// This file is auto-generated - any changes will be overwritten.
-// Generated at: <%= new Date().toISOString() %>
+// Code generated by Apso CLI. DO NOT EDIT.
+// Generated with Apso (https://apso.ai)
+//
+// This file is auto-generated; changes will be overwritten on the next scaffold.

package/dist/lib/templates/header.eta

@@ -1,8 +1,6 @@
-<% /*
- * This file is generated by Apso.
+/**
+ * Generated with Apso (https://apso.ai)
  *
- * Generated at: <%= it.generatedAt %>
- * Generated by: <%= it.generatedBy %>
- *
- * Do not edit this file directly.
-*/ %>
+ * This file is auto-generated by the Apso CLI. Do not edit it directly;
+ * changes will be overwritten on the next scaffold.
+ */

package/dist/lib/templates/python/header.eta

@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
-# Generated: <%= it.generatedAt %>
-
-# Auto-generated by Apso CLI
-# DO NOT EDIT - This file is managed by Apso and will be overwritten on scaffold
+# Generated with Apso (https://apso.ai)
+#
+# This file is auto-generated by the Apso CLI. Do not edit it directly;
+# changes will be overwritten on the next scaffold.