@aws-blocks/core 0.1.0

package/dist/telemetry/environment.js

@@ -0,0 +1,87 @@
+import { platform } from 'node:os';
+/**
+ * Detect the OS platform.
+ */
+export function detectOS() {
+    return platform();
+}
+/**
+ * Detect the Node.js version string (without the leading 'v').
+ */
+export function detectNodeVersion() {
+    return process.versions.node;
+}
+/**
+ * Detect whether the current process is running inside a CI/CD environment.
+ */
+export function isCI() {
+    return !!(process.env.CI ||
+        process.env.CONTINUOUS_INTEGRATION ||
+        process.env.BUILD_NUMBER ||
+        process.env.CODEBUILD_BUILD_ID ||
+        process.env.GITHUB_ACTIONS ||
+        process.env.GITLAB_CI ||
+        process.env.CIRCLECI ||
+        process.env.JENKINS_URL ||
+        process.env.TF_BUILD ||
+        process.env.BITBUCKET_BUILD_NUMBER ||
+        process.env.BUILDKITE);
+}
+/**
+ * Detect the package manager from npm_config_user_agent.
+ * Returns the raw user agent string (e.g., "npm/10.2.0 node/v22.0.0").
+ */
+export function detectPackageManager() {
+    return process.env.npm_config_user_agent || undefined;
+}
+/**
+ * Detect if the current execution is driven by an AI agent.
+ * Uses the "am-i-vibing" pattern and checks known environment variables.
+ */
+export function detectAgent() {
+    if (process.env.CLAUDECODE)
+        return 'claude-code';
+    if (process.env.CURSOR_TRACE_ID)
+        return 'cursor';
+    if (process.env.CODEX_CLI_VERSION || process.env.CODEX_SESSION_ID)
+        return 'codex';
+    if (process.env.CLINE_TASK_ID || process.env.CLINE_SESSION_ID)
+        return 'cline';
+    if (process.env.CODEIUM_EDITOR_APP_ROOT || process.env.WINDSURF_SESSION_ID)
+        return 'windsurf';
+    if (process.env.GEMINI_CLI)
+        return 'gemini-cli';
+    if (process.env.REPL_ID && process.env.REPL_OWNER)
+        return 'replit-agent';
+    if (process.env.AIDER_MODEL || process.env.AIDER_SESSION)
+        return 'aider';
+    if (process.env.CONTINUE_GLOBAL_DIR)
+        return 'continue';
+    if (process.env.ROOCODE_SESSION_ID || process.env.ROO_SESSION_ID)
+        return 'roo-code';
+    const awsExecEnv = process.env.AWS_EXECUTION_ENV || '';
+    if (awsExecEnv.toLowerCase().includes('amazonq'))
+        return 'amazon-q';
+    if (awsExecEnv.toLowerCase().includes('kiro'))
+        return 'kiro';
+    return undefined;
+}
+/**
+ * Collect all environment information needed for a telemetry event.
+ */
+export function collectEnvironment() {
+    const env = {
+        os: detectOS(),
+        nodeVersion: detectNodeVersion(),
+        ci: isCI(),
+    };
+    const packageManager = detectPackageManager();
+    if (packageManager) {
+        env.packageManager = packageManager;
+    }
+    const agent = detectAgent();
+    if (agent) {
+        env.agent = agent;
+    }
+    return env;
+}

package/dist/telemetry/identifiers.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Get or create a persistent installation ID.
+ * Stored at `~/.blocks/telemetry/installation-id`.
+ * Generated as UUID v4 on first use.
+ *
+ * On first creation, prints a one-time notice to stderr informing
+ * the user about telemetry collection.
+ */
+export declare function getInstallationId(): string;
+/**
+ * Get or create a persistent project ID.
+ * Stored in `.blocks/config.json` under `telemetry.projectId` in the project root (cwd).
+ * Generated as UUID v4 on first use.
+ */
+export declare function getProjectId(): string;
+/**
+ * Generate a fresh UUID v4 event ID.
+ */
+export declare function generateEventId(): string;
+//# sourceMappingURL=identifiers.d.ts.map

package/dist/telemetry/identifiers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identifiers.d.ts","sourceRoot":"","sources":["../../src/telemetry/identifiers.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAsB1C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAiCrC;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/telemetry/identifiers.js

@@ -0,0 +1,86 @@
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
+import { randomUUID } from 'node:crypto';
+const FIRST_RUN_NOTICE = `
+AWS Blocks collects anonymous usage data to improve the product.
+No customer content or PII is collected.
+To disable: npx blocks-telemetry --disable (or export AWS_BLOCKS_DISABLE_TELEMETRY=1)
+`;
+/**
+ * Get or create a persistent installation ID.
+ * Stored at `~/.blocks/telemetry/installation-id`.
+ * Generated as UUID v4 on first use.
+ *
+ * On first creation, prints a one-time notice to stderr informing
+ * the user about telemetry collection.
+ */
+export function getInstallationId() {
+    const filePath = join(homedir(), '.blocks', 'telemetry', 'installation-id');
+    try {
+        const existing = readFileSync(filePath, 'utf-8').trim();
+        if (existing)
+            return existing;
+    }
+    catch {
+        // File doesn't exist yet
+    }
+    const id = randomUUID();
+    try {
+        const dir = dirname(filePath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        writeFileSync(filePath, id, 'utf-8');
+    }
+    catch {
+        // If we can't persist, still return the generated ID for this session
+    }
+    process.stderr.write(FIRST_RUN_NOTICE + '\n');
+    return id;
+}
+/**
+ * Get or create a persistent project ID.
+ * Stored in `.blocks/config.json` under `telemetry.projectId` in the project root (cwd).
+ * Generated as UUID v4 on first use.
+ */
+export function getProjectId() {
+    const configPath = join(process.cwd(), '.blocks', 'config.json');
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        if (config.telemetry?.projectId)
+            return config.telemetry.projectId;
+    }
+    catch {
+        // File doesn't exist or invalid JSON
+    }
+    const id = randomUUID();
+    try {
+        const dir = dirname(configPath);
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+        // Preserve existing config if present
+        let config = {};
+        try {
+            const existing = readFileSync(configPath, 'utf-8');
+            config = JSON.parse(existing);
+        }
+        catch {
+            // No existing config
+        }
+        config.telemetry = { ...config.telemetry, projectId: id };
+        writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf-8');
+    }
+    catch {
+        // If we can't persist, still return the generated ID for this session
+    }
+    return id;
+}
+/**
+ * Generate a fresh UUID v4 event ID.
+ */
+export function generateEventId() {
+    return randomUUID();
+}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,6 @@
+export { trackCommand, classifyError } from './trackCommand.js';
+export { buildAndSendEvent, buildEvent } from './client.js';
+export type { CommandName, CommandState, BuildAndSendEventOptions } from './types.js';
+export { isTelemetryEnabled, getTelemetryStatus, getGlobalConfigPath, getProjectConfigPath, type TelemetryStatus, } from './consent.js';
+export { writeConfigTelemetry } from './config-writer.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5D,YAAY,EAAE,WAAW,EAAE,YAAY,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/telemetry/index.js

@@ -0,0 +1,4 @@
+export { trackCommand, classifyError } from './trackCommand.js';
+export { buildAndSendEvent, buildEvent } from './client.js';
+export { isTelemetryEnabled, getTelemetryStatus, getGlobalConfigPath, getProjectConfigPath, } from './consent.js';
+export { writeConfigTelemetry } from './config-writer.js';

package/dist/telemetry/telemetry.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry.test.d.ts.map

package/dist/telemetry/telemetry.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.test.d.ts","sourceRoot":"","sources":["../../src/telemetry/telemetry.test.ts"],"names":[],"mappings":""}