@hypequery/cli 1.23.0 → 1.24.0

package/dist/utils/telemetry/catalog-docs.js

@@ -27,7 +27,7 @@ export function renderTelemetryCatalog() {
     const parts = [
         '{/* Generated by pnpm --filter @hypequery/cli telemetry:docs. Do not edit this section by hand. */}',
         '## Event reference',
-        `Schema version: **${EVENT_SCHEMA_VERSION}**. Default collection is inactive. Debug or explicitly configured ingest mode emits command/crash lifecycle events, init and generation metrics, and dev/MCP session events. Cloud command and project-feature instrumentation follows separately.`,
+        `Schema version: **${EVENT_SCHEMA_VERSION}**. Unless opted out, the CLI sends command/crash lifecycle events, init and generation metrics, and dev/MCP session events to the first-party ingest proxy; debug mode prints them instead. Cloud command and project-feature instrumentation follows separately.`,
         'Unknown events, properties, record keys, flag names, enum values, and malformed identities or versions are rejected. No argument values, paths, names, SQL, messages, stacks, hosts, tenants, or credentials are permitted.',
         'Counts use inclusive integer ranges: 0, 1, 2–5, 6–20, 21–100, and 101 or more. Duration and nonzero size buckets include their lower bound and exclude their upper bound. Raw counts, durations, ports and byte sizes are never sent.',
         '### Common properties',

package/dist/utils/telemetry/config-schema.d.ts

@@ -1,5 +1,7 @@
 export declare const TELEMETRY_SCHEMA_VERSION = 1;
 export declare const TELEMETRY_DOCS_URL = "https://hypequery.com/docs/telemetry";
+/** First-party ingest proxy; `HYPEQUERY_TELEMETRY_URL` overrides it for staging or self-hosting. */
+export declare const DEFAULT_TELEMETRY_ENDPOINT = "https://hypequery.com/api/telemetry";
 export interface TelemetryConfig {
     readonly schema_version: typeof TELEMETRY_SCHEMA_VERSION;
     readonly enabled: boolean;

package/dist/utils/telemetry/config-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/config-schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AAEzE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,wBAAwB,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpD;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAyB1E"}
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/config-schema.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAC1C,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,oGAAoG;AACpG,eAAO,MAAM,0BAA0B,wCAAwC,CAAC;AAEhF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,OAAO,wBAAwB,CAAC;IACzD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,qBAAqB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACpD;AAED,mFAAmF;AACnF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAyB1E"}

package/dist/utils/telemetry/config-schema.js

@@ -1,6 +1,8 @@
 import { matchesTelemetryFormat } from './value-formats.js';
 export const TELEMETRY_SCHEMA_VERSION = 1;
 export const TELEMETRY_DOCS_URL = 'https://hypequery.com/docs/telemetry';
+/** First-party ingest proxy; `HYPEQUERY_TELEMETRY_URL` overrides it for staging or self-hosting. */
+export const DEFAULT_TELEMETRY_ENDPOINT = 'https://hypequery.com/api/telemetry';
 /** Reject malformed or future settings rather than silently enabling telemetry. */
 export function parseTelemetryConfig(input) {
     try {

package/dist/utils/telemetry/invocation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/invocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EAAyB,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAEtF,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAG3E,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC7E,MAAM,WAAW,iBAAkB,SAAQ,0BAA0B;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvD;AAED,uFAAuF;AACvF,qBAAa,mBAAmB;IAEV,QAAQ,CAAC,MAAM,EAAE,yBAAyB;IAD9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO;WAIM,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAuBpF,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CACvB"}
+{"version":3,"file":"invocation.d.ts","sourceRoot":"","sources":["../../../src/utils/telemetry/invocation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAG/E,OAAO,EAAyB,KAAK,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAGtF,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAG3E,MAAM,MAAM,yBAAyB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC7E,MAAM,WAAW,iBAAkB,SAAQ,0BAA0B;IACnE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC;IAC7C,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CACvD;AAED,uFAAuF;AACvF,qBAAa,mBAAmB;IAEV,QAAQ,CAAC,MAAM,EAAE,yBAAyB;IAD9D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqB;IAC/C,OAAO;WAIM,MAAM,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAqBpF,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IACnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CACvB"}

package/dist/utils/telemetry/invocation.js

@@ -2,6 +2,7 @@ import { collectEnvironment } from './environment.js';
 import { inspectProject } from './project-context.js';
 import { invocationIdentity } from './identity.js';
 import { resolveTelemetryState } from './opt-out.js';
+import { DEFAULT_TELEMETRY_ENDPOINT } from './config-schema.js';
 import { showTelemetryNotice } from './notice.js';
 import { TelemetryTransport } from './transport.js';
 import { getCliVersion } from '../cli-version.js';
@@ -16,12 +17,9 @@ export class TelemetryInvocation {
     static async create(options) {
         try {
             const env = options.env ?? process.env;
-            // Collection is staged until the first-party proxy and rollout are ready.
-            // Normal runs do not inspect projects or create identities just for telemetry.
-            if (!env.HYPEQUERY_TELEMETRY_URL && env.HYPEQUERY_TELEMETRY_DEBUG !== '1')
-                return null;
             if (options.command === 'telemetry')
                 return null;
+            // Opt-outs resolve before any project inspection or identity creation.
             const cliVersion = options.cliVersion ?? getCliVersion();
             const state = await resolveTelemetryState({ ...options, cliVersion });
             if (!state.enabled || !state.config)
@@ -31,7 +29,7 @@ export class TelemetryInvocation {
             const common = { ...environment, ...invocationIdentity(state.config, project), is_first_run: state.source === 'default' };
             const invocation = new TelemetryInvocation(common, {
                 ...options.transportOptions,
-                enabled: true, endpoint: env.HYPEQUERY_TELEMETRY_URL,
+                enabled: true, endpoint: env.HYPEQUERY_TELEMETRY_URL || DEFAULT_TELEMETRY_ENDPOINT,
                 debug: env.HYPEQUERY_TELEMETRY_DEBUG === '1',
             });
             await showTelemetryNotice({ ...options, enabled: true, isTTY: common.is_tty, isCI: common.is_ci });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/cli",
-  "version": "1.23.0",
+  "version": "1.24.0",
   "description": "CLI for scaffolding type-safe ClickHouse analytics, semantic datasets, React manifests, and deployments",
   "keywords": [
     "clickhouse",