@buildspacestudio/cli 0.2.0 → 0.3.2

package/dist/lib/telemetry.js

@@ -0,0 +1,162 @@
+import { getTelemetryConfig, readConfig, resolveApiBaseUrl } from "./config.js";
+const CLI_VERSION = "0.2.1";
+const TELEMETRY_SEND_TIMEOUT_MS = 3000;
+const TELEMETRY_ENV_VAR = "BUILDSPACE_TELEMETRY";
+let _sessionId;
+let _pendingEvents = [];
+let _disabled;
+let _hasLoggedTrackEventFailure = false;
+function getSessionId() {
+    if (!_sessionId) {
+        const bytes = new Uint8Array(16);
+        crypto.getRandomValues(bytes);
+        _sessionId = Array.from(bytes)
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    return _sessionId;
+}
+function getPlatform() {
+    return process.platform;
+}
+function getRuntime() {
+    if (typeof Bun !== "undefined") {
+        return "bun";
+    }
+    return "node";
+}
+function computeLatencyBucket(ms) {
+    if (ms < 100) {
+        return "lt_100ms";
+    }
+    if (ms < 500) {
+        return "100ms_500ms";
+    }
+    if (ms < 1000) {
+        return "500ms_1s";
+    }
+    if (ms < 5000) {
+        return "1s_5s";
+    }
+    if (ms < 15_000) {
+        return "5s_15s";
+    }
+    return "gt_15s";
+}
+function isDisabledByEnv() {
+    const value = process.env[TELEMETRY_ENV_VAR];
+    if (value === undefined || value === "") {
+        return false;
+    }
+    return value === "0" || value.toLowerCase() === "false" || value.toLowerCase() === "off";
+}
+async function isEnabled() {
+    if (_disabled !== undefined) {
+        return !_disabled;
+    }
+    if (isDisabledByEnv()) {
+        _disabled = true;
+        return false;
+    }
+    try {
+        const telemetryConfig = await getTelemetryConfig();
+        _disabled = !telemetryConfig.enabled;
+        return telemetryConfig.enabled;
+    }
+    catch {
+        _disabled = true;
+        return false;
+    }
+}
+function logTrackEventFailure(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    if (_hasLoggedTrackEventFailure) {
+        return;
+    }
+    _hasLoggedTrackEventFailure = true;
+    console.error(`Telemetry error: ${message}`);
+}
+export function trackEvent(event, properties) {
+    return isEnabled()
+        .then((enabled) => {
+        if (!enabled) {
+            return;
+        }
+        _pendingEvents.push({
+            event,
+            occurredAt: new Date().toISOString(),
+            properties: {
+                platform: getPlatform(),
+                runtime: getRuntime(),
+                version: CLI_VERSION,
+                ...properties,
+            },
+        });
+    })
+        .catch((error) => {
+        logTrackEventFailure(error);
+    });
+}
+export function trackCommandStart(command, subcommand) {
+    const startedAt = Date.now();
+    trackEvent("cli.started", { command, subcommand });
+    return { startedAt };
+}
+export async function trackCommandEnd({ command, errorCode, startedAt, subcommand, success, }) {
+    const latencyBucket = computeLatencyBucket(Date.now() - startedAt);
+    const eventName = success ? "cli.command.completed" : "cli.command.failed";
+    await trackEvent(eventName, {
+        command,
+        errorCode: errorCode?.slice(0, 64),
+        latencyBucket,
+        subcommand,
+        success,
+    });
+}
+export async function flushTelemetry() {
+    if (_pendingEvents.length === 0) {
+        return;
+    }
+    if (!(await isEnabled())) {
+        _pendingEvents = [];
+        return;
+    }
+    const eventsToSend = [..._pendingEvents];
+    _pendingEvents = [];
+    try {
+        const config = await readConfig();
+        const pat = config.pat;
+        if (!pat) {
+            return;
+        }
+        const apiBaseUrl = resolveApiBaseUrl(config);
+        const anonymousId = config.telemetry?.anonymousId;
+        const body = JSON.stringify({
+            anonymousId,
+            events: eventsToSend,
+            sentAt: new Date().toISOString(),
+            sessionId: getSessionId(),
+        });
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), TELEMETRY_SEND_TIMEOUT_MS);
+        try {
+            await fetch(`${apiBaseUrl}/api/v1/telemetry/cli`, {
+                body,
+                headers: {
+                    Authorization: `Bearer ${pat}`,
+                    "Content-Type": "application/json",
+                },
+                method: "POST",
+                signal: controller.signal,
+            });
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    catch {
+        // Best-effort delivery — silently discard on failure
+    }
+}
+export { computeLatencyBucket };
+//# sourceMappingURL=telemetry.js.map

package/dist/lib/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sourceRoot":"","sources":["../../src/lib/telemetry.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@buildspacestudio/cli",
-  "version": "0.2.0",
+  "version": "0.3.2",
   "description": "Buildspace CLI for app creation, setup, deployment, and environment management",
   "license": "MIT",
   "repository": {