@tanstack/cli 0.63.1 → 0.64.0

package/dist/cli.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 import { resolve } from 'node:path';
-import { Command, InvalidArgumentError } from 'commander';
+import { Command, InvalidArgumentError, Option } from 'commander';
 import { cancel, confirm, intro, isCancel, log } from '@clack/prompts';
 import chalk from 'chalk';
 import semver from 'semver';
@@ -37,6 +37,19 @@ function sanitizeIdList(values) {
         .map((value) => sanitizeId(value))
         .filter((value) => Boolean(value))));
 }
+const AGENT_FLAG = '--agent';
+function addHiddenAgentFlag(cmd) {
+    if (cmd.options.some((option) => option.long === AGENT_FLAG)) {
+        return cmd;
+    }
+    cmd.addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp());
+    return cmd;
+}
+function getInvocationTelemetryProperties() {
+    return {
+        invoked_by_agent: process.argv.includes(AGENT_FLAG),
+    };
+}
 function getStarterTelemetryProperties(value) {
     if (!value) {
         return {};
@@ -275,6 +288,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
         const startedAt = Date.now();
         currentTelemetry = telemetry;
         telemetry.captureCommandStarted(command, {
+            ...getInvocationTelemetryProperties(),
             ...opts.properties,
             cli_version: VERSION,
         });
@@ -295,6 +309,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
         .name(name)
         .description(`${appName} CLI`)
         .version(VERSION, '-v, --version', 'output the current version');
+    addHiddenAgentFlag(program);
     // Helper to create the create command action handler
     async function handleCreate(projectName, options) {
         try {
@@ -507,6 +522,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
     }
     // Helper to configure create command options
     function configureCreateCommand(cmd) {
+        addHiddenAgentFlag(cmd);
         cmd.argument('[project-name]', 'name of the project');
         if (!defaultFramework) {
             cmd.option('--framework <type>', `project framework (${availableFrameworks.join(', ')})`, (value) => {
@@ -624,6 +640,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
     program
         .command('libraries')
         .description('List TanStack libraries')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .option('--group <group>', `filter by group (${LIBRARY_GROUPS.join(', ')})`)
         .option('--json', 'output JSON for automation', false)
         .action(async (options) => {
@@ -681,6 +698,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
     program
         .command('doc')
         .description('Fetch a TanStack documentation page')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .argument('<library>', 'library ID (eg. query, router, table)')
         .argument('<path>', 'documentation path (eg. framework/react/overview)')
         .option('--docs-version <version>', 'docs version (default: latest)', 'latest')
@@ -757,6 +775,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
     program
         .command('search-docs')
         .description('Search TanStack documentation')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .argument('<query>', 'search query')
         .option('--library <id>', 'filter to specific library')
         .option('--framework <name>', 'filter to specific framework')
@@ -804,6 +823,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
     program
         .command('ecosystem')
         .description('List TanStack ecosystem partners')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .option('--category <category>', 'filter by category')
         .option('--library <id>', 'filter by TanStack library')
         .option('--json', 'output JSON for automation', false)
@@ -873,6 +893,7 @@ export function cli({ name, appName, forcedAddOns = [], forcedDeployment, defaul
     program
         .command('pin-versions')
         .description('Pin versions of the TanStack libraries')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('pin-versions', {}, async (telemetry) => {
@@ -943,6 +964,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     telemetryCommand
         .command('status')
         .description('Show anonymous telemetry status')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .option('--json', 'output JSON for automation', false)
         .action(async (options) => {
         const status = await getTelemetryStatus({ createIfMissing: true });
@@ -966,6 +988,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     telemetryCommand
         .command('enable')
         .description('Enable anonymous telemetry')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         await setTelemetryEnabled(true);
         console.log('Anonymous telemetry enabled');
@@ -973,6 +996,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     telemetryCommand
         .command('disable')
         .description('Disable anonymous telemetry')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         await setTelemetryEnabled(false);
         console.log('Anonymous telemetry disabled');
@@ -980,6 +1004,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     // === ADD SUBCOMMAND ===
     program
         .command('add')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .argument('[add-on...]', 'Name of the add-ons (or add-ons separated by spaces or commas)')
         .option('--forced', 'Force the add-on to be added', false)
         .action(async (addOns, options) => {
@@ -1032,6 +1057,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     addOnCommand
         .command('init')
         .description('Initialize an add-on from the current project')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('add-on:init', {}, async () => {
@@ -1046,6 +1072,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     addOnCommand
         .command('compile')
         .description('Update add-on from the current project')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('add-on:compile', {}, async () => {
@@ -1060,6 +1087,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     addOnCommand
         .command('dev')
         .description('Watch project files and continuously refresh .add-on and add-on.json')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('add-on:dev', {}, async () => {
@@ -1076,6 +1104,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     templateCommand
         .command('init')
         .description('Initialize a project template from the current project')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('template:init', {}, async () => {
@@ -1090,6 +1119,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     templateCommand
         .command('compile')
         .description('Compile the template JSON file for the current project')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('template:compile', {}, async () => {
@@ -1106,6 +1136,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     starterCommand
         .command('init')
         .description('Deprecated alias: initialize a project template')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('starter:init', {}, async () => {
@@ -1120,6 +1151,7 @@ Remove your node_modules directory and package lock file and re-install.`);
     starterCommand
         .command('compile')
         .description('Deprecated alias: compile the template JSON file')
+        .addOption(new Option(AGENT_FLAG, 'internal: invocation originated from an agent').hideHelp())
         .action(async () => {
         try {
             await runWithTelemetry('starter:compile', {}, async () => {

package/dist/telemetry.js

@@ -1,10 +1,12 @@
 import { version as nodeVersion } from 'node:process';
 import { getTelemetryStatus, markTelemetryNoticeSeen, TELEMETRY_NOTICE_VERSION, } from './telemetry-config.js';
-const POSTHOG_API_HOST = 'https://us.i.posthog.com';
-const POSTHOG_CAPTURE_ENDPOINT = `${POSTHOG_API_HOST}/capture/`;
-const POSTHOG_PROJECT_TOKEN = 'phc_xJ2VBahJBzy3BShLhuGpw7EyoSuQtgwXXvhE9BYtHuKQ';
+const TELEMETRY_TRANSPORT_ENDPOINT = 'https://www.google-analytics.com/g/collect';
+const TELEMETRY_PROPERTY_ID = 'G-JMT1Z50SPS';
 const TELEMETRY_NOTICE = 'TanStack CLI sends anonymous usage telemetry by default. It never sends project names, paths, raw search text, template URLs, add-on config values, or raw error messages. Disable it with `tanstack telemetry disable` or `TANSTACK_CLI_TELEMETRY_DISABLED=1`.';
 const TELEMETRY_TIMEOUT_MS = 1200;
+const TELEMETRY_VALUE_MAX_LENGTH = 500;
+const TELEMETRY_NUMERIC_PREFIX = 'epn.';
+const TELEMETRY_STRING_PREFIX = 'ep.';
 let telemetryStatusPromise;
 function getNodeMajorVersion() {
     return Number.parseInt(nodeVersion.replace(/^v/, '').split('.')[0] || '0', 10);
@@ -26,6 +28,57 @@ function cleanProperties(value) {
     }
     return value;
 }
+function truncateValue(value) {
+    return value.length > TELEMETRY_VALUE_MAX_LENGTH
+        ? `${value.slice(0, TELEMETRY_VALUE_MAX_LENGTH - 1)}…`
+        : value;
+}
+function normalizeParamKey(key) {
+    const normalized = key.replace(/[^a-zA-Z0-9_]/g, '_').replace(/^_+/, '');
+    const prefixed = /^[a-zA-Z]/.test(normalized)
+        ? normalized
+        : `p_${normalized || 'value'}`;
+    return prefixed.slice(0, 40);
+}
+function normalizeParamValue(value) {
+    if (value === undefined || value === null) {
+        return undefined;
+    }
+    if (typeof value === 'boolean') {
+        return value ? 1 : 0;
+    }
+    if (typeof value === 'number') {
+        return Number.isFinite(value) ? value : undefined;
+    }
+    if (typeof value === 'string') {
+        return truncateValue(value);
+    }
+    const cleaned = cleanProperties(value);
+    if (cleaned === undefined) {
+        return undefined;
+    }
+    return truncateValue(JSON.stringify(cleaned));
+}
+function createTelemetryRequestBody(event, distinctId, properties) {
+    const params = new URLSearchParams({
+        cid: distinctId,
+        en: event,
+        tid: TELEMETRY_PROPERTY_ID,
+        v: '2',
+    });
+    for (const [key, value] of Object.entries(properties)) {
+        const normalizedValue = normalizeParamValue(value);
+        if (normalizedValue === undefined) {
+            continue;
+        }
+        const normalizedKey = normalizeParamKey(key);
+        const paramName = typeof normalizedValue === 'number'
+            ? `${TELEMETRY_NUMERIC_PREFIX}${normalizedKey}`
+            : `${TELEMETRY_STRING_PREFIX}${normalizedKey}`;
+        params.append(paramName, String(normalizedValue));
+    }
+    return params.toString();
+}
 function getErrorCode(error) {
     if (!error || typeof error !== 'object') {
         return 'unknown_error';
@@ -63,17 +116,12 @@ async function postEvent(event, distinctId, properties) {
         controller.abort();
     }, TELEMETRY_TIMEOUT_MS);
     try {
-        await fetch(POSTHOG_CAPTURE_ENDPOINT, {
+        await fetch(TELEMETRY_TRANSPORT_ENDPOINT, {
             method: 'POST',
             headers: {
-                'Content-Type': 'application/json',
+                'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8',
             },
-            body: JSON.stringify({
-                api_key: POSTHOG_PROJECT_TOKEN,
-                distinct_id: distinctId,
-                event,
-                properties,
-            }),
+            body: createTelemetryRequestBody(event, distinctId, properties),
             signal: controller.signal,
         });
     }
@@ -171,7 +219,7 @@ export class TelemetryClient {
     }
     baseProperties() {
         return {
-            $lib: 'tanstack-cli',
+            client_lib: 'tanstack-cli',
             disabled_by: this.disabledBy,
             node_major: getNodeMajorVersion(),
             os_arch: process.arch,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tanstack/cli",
-  "version": "0.63.1",
+  "version": "0.64.0",
   "description": "TanStack CLI",
   "type": "module",
   "main": "./dist/index.js",
@@ -41,7 +41,7 @@
     "tempy": "^3.1.0",
     "validate-npm-package-name": "^7.0.0",
     "zod": "^3.24.2",
-    "@tanstack/create": "0.63.3"
+    "@tanstack/create": "0.63.4"
   },
   "devDependencies": {
     "@playwright/test": "^1.58.2",