@hypequery/cli 1.22.0 → 1.23.0

package/dist/utils/telemetry/catalog.d.ts

@@ -0,0 +1,1124 @@
+import { COMMAND_FLAGS, GLOBAL_FLAGS } from './domains.js';
+import { type Fields, type Properties } from './schema.js';
+export declare const EVENT_SCHEMA_VERSION = 1;
+export declare const COMMON_PROPERTIES: {
+    readonly schema_version: {
+        readonly kind: "enum";
+        readonly description: string;
+        readonly values: readonly [1];
+    };
+    readonly cli_version: {
+        readonly kind: "format";
+        readonly description: string;
+        readonly format: "version";
+    };
+    readonly node_version: {
+        readonly kind: "format";
+        readonly description: string;
+        readonly format: "node_version";
+    };
+    readonly os: {
+        readonly kind: "enum";
+        readonly description: string;
+        readonly values: readonly ["darwin", "linux", "win32", "aix", "freebsd", "openbsd", "sunos", "android", "unknown"];
+    };
+    readonly arch: {
+        readonly kind: "enum";
+        readonly description: string;
+        readonly values: readonly ["arm", "arm64", "ia32", "x64", "loong64", "mips", "mipsel", "ppc", "ppc64", "riscv64", "s390", "s390x", "unknown"];
+    };
+    readonly is_ci: {
+        readonly kind: "boolean";
+        readonly description: string;
+    };
+    readonly ci_name: {
+        readonly kind: "enum";
+        readonly description: string;
+        readonly values: readonly ["none", "github_actions", "gitlab", "circleci", "buildkite", "jenkins", "vercel", "netlify", "azure", "bitbucket", "teamcity", "travis", "codebuild", "unknown"];
+    };
+    readonly is_tty: {
+        readonly kind: "boolean";
+        readonly description: string;
+    };
+    readonly is_docker: {
+        readonly kind: "boolean";
+        readonly description: string;
+    };
+    readonly is_wsl: {
+        readonly kind: "boolean";
+        readonly description: string;
+    };
+    readonly package_manager: {
+        readonly kind: "enum";
+        readonly description: string;
+        readonly values: readonly ["npm", "pnpm", "yarn", "bun", "unknown"];
+    };
+    readonly package_manager_major: {
+        readonly kind: "format";
+        readonly description: string;
+        readonly format: "major_version";
+    } & {
+        readonly optional: true;
+    };
+    readonly invoked_via: {
+        readonly kind: "enum";
+        readonly description: string;
+        readonly values: readonly ["npx", "pnpm_dlx", "bunx", "global", "local_bin", "unknown"];
+    };
+    readonly install_id: {
+        readonly kind: "format";
+        readonly description: string;
+        readonly format: "uuid";
+    };
+    readonly project_id: {
+        readonly kind: "format";
+        readonly description: string;
+        readonly format: "hash";
+    } & {
+        readonly optional: true;
+    };
+    readonly session_id: {
+        readonly kind: "format";
+        readonly description: string;
+        readonly format: "uuid";
+    };
+    readonly is_first_run: {
+        readonly kind: "boolean";
+        readonly description: string;
+    };
+    readonly hypequery_packages: {
+        readonly kind: "record";
+        readonly description: string;
+        readonly fields: Record<"@hypequery/clickhouse" | "@hypequery/datasets" | "@hypequery/serve" | "@hypequery/react" | "@hypequery/cli" | "@hypequery/mcp" | "@hypequery/protocol" | "@hypequery/protocol-conformance" | "@hypequery/deployment", {
+            readonly kind: "format";
+            readonly description: string;
+            readonly format: "version";
+        } & {
+            readonly optional: true;
+        }>;
+    } & {
+        readonly optional: true;
+    };
+    readonly database: {
+        readonly kind: "enum";
+        readonly description: string;
+        readonly values: readonly ["clickhouse", "chdb", "bigquery", "unknown"];
+    };
+};
+/** Command-specific completion fields; absence means that stage was not reached. */
+export declare const COMMAND_PROPERTIES: {
+    readonly help: {
+        readonly help_topic: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["root", "init", "dev", "mcp", "generate", "generate:types", "generate:datasets", "generate:manifest", "login", "logout", "deploy", "deployment:build", "deployment:validate", "deployment:release", "deployment:submit", "deployment:status", "pull", "diff", "help", "version", "telemetry", "unknown"];
+        } & {
+            readonly optional: true;
+        };
+    };
+    readonly unknown: Record<string, never>;
+    readonly login: Record<string, never>;
+    readonly logout: Record<string, never>;
+    readonly deploy: Record<string, never>;
+    readonly "deployment:build": Record<string, never>;
+    readonly "deployment:validate": Record<string, never>;
+    readonly "deployment:release": Record<string, never>;
+    readonly "deployment:submit": Record<string, never>;
+    readonly "deployment:status": Record<string, never>;
+    readonly pull: Record<string, never>;
+    readonly diff: Record<string, never>;
+    readonly version: Record<string, never>;
+    readonly telemetry: Record<string, never>;
+    readonly init: {
+        readonly stage_reached: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["started", "database_selected", "connection_tested", "style_selected", "files_written", "dependencies_installed", "completed"];
+        } & {
+            readonly optional: true;
+        };
+        readonly failed_stage: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["started", "database_selected", "connection_tested", "style_selected", "files_written", "dependencies_installed", "completed"];
+        } & {
+            readonly optional: true;
+        };
+        readonly style: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["queries", "datasets"];
+        } & {
+            readonly optional: true;
+        };
+        readonly auth: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["none", "context"];
+        } & {
+            readonly optional: true;
+        };
+        readonly interactive: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly force: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly example: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly skip_connection: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly connection_result: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["ok", "failed", "skipped"];
+        } & {
+            readonly optional: true;
+        };
+        readonly chdb_failure_reason: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["not_installed", "engine_error"];
+        } & {
+            readonly optional: true;
+        };
+        readonly table_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly datasets_generated_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly table_selection: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["all", "list", "exclude", "prompt"];
+        } & {
+            readonly optional: true;
+        };
+        readonly env_file: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["created", "updated", "unchanged", "skipped"];
+        } & {
+            readonly optional: true;
+        };
+        readonly gitignore: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["created", "updated", "unchanged", "skipped"];
+        } & {
+            readonly optional: true;
+        };
+        readonly package_json_present: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly analytics_directory_present: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+    };
+    readonly dev: {};
+    readonly mcp: {
+        readonly mode: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["self_test", "serve"];
+        } & {
+            readonly optional: true;
+        };
+        readonly hosted: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly dataset_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly tenant_used: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly tenant_dataset_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+    };
+    readonly generate: {
+        readonly chdb_path_given: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly tables_filter_used: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly table_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly column_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly unsupported_type_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly unsupported_type_families: {
+            readonly kind: "enum_list";
+            readonly description: string;
+            readonly values: readonly ["AggregateFunction", "SimpleAggregateFunction", "Variant", "Dynamic", "Object", "JSON", "Nested", "Tuple", "Map", "Array", "Nullable", "LowCardinality", "Decimal", "Enum", "DateTime", "DateTime64", "unknown"];
+        } & {
+            readonly optional: true;
+        };
+        readonly custom_output: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+    };
+    readonly 'generate:types': {
+        readonly chdb_path_given: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly tables_filter_used: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly table_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly column_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly unsupported_type_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly unsupported_type_families: {
+            readonly kind: "enum_list";
+            readonly description: string;
+            readonly values: readonly ["AggregateFunction", "SimpleAggregateFunction", "Variant", "Dynamic", "Object", "JSON", "Nested", "Tuple", "Map", "Array", "Nullable", "LowCardinality", "Decimal", "Enum", "DateTime", "DateTime64", "unknown"];
+        } & {
+            readonly optional: true;
+        };
+        readonly custom_output: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+    };
+    readonly 'generate:datasets': {
+        readonly mode: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["write", "check", "diff"];
+        } & {
+            readonly optional: true;
+        };
+        readonly check_result: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["up_to_date", "out_of_date", "missing"];
+        } & {
+            readonly optional: true;
+        };
+        readonly force: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly tenant_column_used: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly tables_filter_used: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly exclude_filter_used: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+        readonly datasets_generated_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly warning_counts: {
+            readonly kind: "record";
+            readonly description: string;
+            readonly fields: Record<"tenant-key-candidate" | "tenant-column-missing", {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+            } & {
+                readonly optional: true;
+            }>;
+        } & {
+            readonly optional: true;
+        };
+    };
+    readonly 'generate:manifest': {
+        readonly query_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly endpoint_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        } & {
+            readonly optional: true;
+        };
+        readonly custom_output: {
+            readonly kind: "boolean";
+            readonly description: string;
+        } & {
+            readonly optional: true;
+        };
+    };
+};
+export declare const SESSION_START_PROPERTIES: {
+    readonly dev: {
+        readonly entry_type: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["hypequery.ts", "api.ts", "queries.ts", "explicit_file", "unknown"];
+        };
+        readonly watch: {
+            readonly kind: "boolean";
+            readonly description: string;
+        };
+        readonly cache_provider: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["none", "memory", "redis", "unknown"];
+        };
+        readonly cors: {
+            readonly kind: "boolean";
+            readonly description: string;
+        };
+        readonly open: {
+            readonly kind: "boolean";
+            readonly description: string;
+        };
+        readonly custom_port: {
+            readonly kind: "boolean";
+            readonly description: string;
+        };
+        readonly quiet: {
+            readonly kind: "boolean";
+            readonly description: string;
+        };
+    };
+    readonly mcp: {
+        readonly entry_type: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["hypequery.ts", "api.ts", "queries.ts", "explicit_file", "unknown"];
+        };
+        readonly mode: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["self_test", "serve"];
+        };
+        readonly dataset_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        };
+        readonly tenant_used: {
+            readonly kind: "boolean";
+            readonly description: string;
+        };
+        readonly tenant_dataset_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        };
+    };
+};
+export declare const SESSION_END_PROPERTIES: {
+    readonly dev: {
+        readonly reload_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        };
+        readonly reload_error_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        };
+        readonly load_failures: {
+            readonly kind: "record";
+            readonly description: string;
+            readonly fields: Record<"unknown" | "connection_failed" | "auth_failed" | "entrypoint_not_found" | "compile_error" | "prompt_cancelled" | "validation_failed" | "cloud_network_error" | "cloud_rejected" | "not_installed" | "engine_error" | "no_tables" | "no_datasets" | "tenant_required" | "load_error" | "output_missing" | "output_out_of_date" | "unknown_command" | "unknown_option", {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+            } & {
+                readonly optional: true;
+            }>;
+        };
+    };
+    readonly mcp: {
+        readonly tool_call_counts: {
+            readonly kind: "record";
+            readonly description: string;
+            readonly fields: Record<"list" | "query" | "describe", {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+            }>;
+        };
+        readonly error_count_bucket: {
+            readonly kind: "enum";
+            readonly description: string;
+            readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+        };
+    };
+};
+export declare const EVENT_CATALOG: {
+    readonly cli_command_completed: {
+        readonly purpose: "Measure command adoption, onboarding drop-off and release reliability. Exactly once per invocation; never emit for telemetry disable.";
+        readonly properties: {
+            readonly command: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["init", "dev", "mcp", "generate", "generate:types", "generate:datasets", "generate:manifest", "login", "logout", "deploy", "deployment:build", "deployment:validate", "deployment:release", "deployment:submit", "deployment:status", "pull", "diff", "help", "version", "telemetry", "unknown"];
+            };
+            readonly flags_used: {
+                readonly kind: "enum_list";
+                readonly description: string;
+                readonly values: readonly ("--path" | "--style" | "--database" | "--chdb-path" | "--auth" | "--all-tables" | "--tables" | "--exclude-tables" | "--no-example" | "--no-interactive" | "--force" | "--skip-connection" | "--port" | "--hostname" | "--no-watch" | "--no-cache" | "--cache" | "--redis-url" | "--open" | "--cors" | "--quiet" | "--tenant" | "--self-test" | "--url" | "--output" | "--tenant-column" | "--check" | "--diff" | "--cloud-url" | "--environment" | "--bundle-output" | "--release-output" | "--project" | "--no-source" | "--endpoint" | "--replace-restored" | "--mcp-config" | "--release" | "--no-telemetry" | "--help" | "--version")[];
+            };
+            readonly outcome: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["success", "failure", "cancelled", "interrupted"];
+            };
+            readonly duration_bucket: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["<100ms", "100ms-1s", "1s-10s", "10s-1m", "1m-10m", "10m-1h", "1h+"];
+            };
+            readonly error_code: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["unknown", "connection_failed", "auth_failed", "entrypoint_not_found", "compile_error", "prompt_cancelled", "validation_failed", "cloud_network_error", "cloud_rejected", "not_installed", "engine_error", "no_tables", "no_datasets", "tenant_required", "load_error", "output_missing", "output_out_of_date", "unknown_command", "unknown_option"];
+            } & {
+                readonly optional: true;
+            };
+        };
+        readonly variants: {
+            readonly help: {
+                readonly help_topic: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["root", "init", "dev", "mcp", "generate", "generate:types", "generate:datasets", "generate:manifest", "login", "logout", "deploy", "deployment:build", "deployment:validate", "deployment:release", "deployment:submit", "deployment:status", "pull", "diff", "help", "version", "telemetry", "unknown"];
+                } & {
+                    readonly optional: true;
+                };
+            };
+            readonly unknown: Record<string, never>;
+            readonly login: Record<string, never>;
+            readonly logout: Record<string, never>;
+            readonly deploy: Record<string, never>;
+            readonly "deployment:build": Record<string, never>;
+            readonly "deployment:validate": Record<string, never>;
+            readonly "deployment:release": Record<string, never>;
+            readonly "deployment:submit": Record<string, never>;
+            readonly "deployment:status": Record<string, never>;
+            readonly pull: Record<string, never>;
+            readonly diff: Record<string, never>;
+            readonly version: Record<string, never>;
+            readonly telemetry: Record<string, never>;
+            readonly init: {
+                readonly stage_reached: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["started", "database_selected", "connection_tested", "style_selected", "files_written", "dependencies_installed", "completed"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly failed_stage: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["started", "database_selected", "connection_tested", "style_selected", "files_written", "dependencies_installed", "completed"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly style: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["queries", "datasets"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly auth: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["none", "context"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly interactive: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly force: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly example: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly skip_connection: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly connection_result: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["ok", "failed", "skipped"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly chdb_failure_reason: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["not_installed", "engine_error"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly table_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly datasets_generated_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly table_selection: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["all", "list", "exclude", "prompt"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly env_file: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["created", "updated", "unchanged", "skipped"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly gitignore: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["created", "updated", "unchanged", "skipped"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly package_json_present: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly analytics_directory_present: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+            };
+            readonly dev: {};
+            readonly mcp: {
+                readonly mode: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["self_test", "serve"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly hosted: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly dataset_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly tenant_used: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly tenant_dataset_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+            };
+            readonly generate: {
+                readonly chdb_path_given: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly tables_filter_used: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly table_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly column_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly unsupported_type_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly unsupported_type_families: {
+                    readonly kind: "enum_list";
+                    readonly description: string;
+                    readonly values: readonly ["AggregateFunction", "SimpleAggregateFunction", "Variant", "Dynamic", "Object", "JSON", "Nested", "Tuple", "Map", "Array", "Nullable", "LowCardinality", "Decimal", "Enum", "DateTime", "DateTime64", "unknown"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly custom_output: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+            };
+            readonly 'generate:types': {
+                readonly chdb_path_given: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly tables_filter_used: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly table_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly column_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly unsupported_type_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly unsupported_type_families: {
+                    readonly kind: "enum_list";
+                    readonly description: string;
+                    readonly values: readonly ["AggregateFunction", "SimpleAggregateFunction", "Variant", "Dynamic", "Object", "JSON", "Nested", "Tuple", "Map", "Array", "Nullable", "LowCardinality", "Decimal", "Enum", "DateTime", "DateTime64", "unknown"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly custom_output: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+            };
+            readonly 'generate:datasets': {
+                readonly mode: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["write", "check", "diff"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly check_result: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["up_to_date", "out_of_date", "missing"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly force: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly tenant_column_used: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly tables_filter_used: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly exclude_filter_used: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+                readonly datasets_generated_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly warning_counts: {
+                    readonly kind: "record";
+                    readonly description: string;
+                    readonly fields: Record<"tenant-key-candidate" | "tenant-column-missing", {
+                        readonly kind: "enum";
+                        readonly description: string;
+                        readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                    } & {
+                        readonly optional: true;
+                    }>;
+                } & {
+                    readonly optional: true;
+                };
+            };
+            readonly 'generate:manifest': {
+                readonly query_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly endpoint_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                } & {
+                    readonly optional: true;
+                };
+                readonly custom_output: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                } & {
+                    readonly optional: true;
+                };
+            };
+        };
+    };
+    readonly cli_session_started: {
+        readonly purpose: "Measure development-server and MCP session configuration; never emit on every reload or request.";
+        readonly properties: {
+            readonly command: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["dev", "mcp"];
+            };
+        };
+        readonly variants: {
+            readonly dev: {
+                readonly entry_type: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["hypequery.ts", "api.ts", "queries.ts", "explicit_file", "unknown"];
+                };
+                readonly watch: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                };
+                readonly cache_provider: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["none", "memory", "redis", "unknown"];
+                };
+                readonly cors: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                };
+                readonly open: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                };
+                readonly custom_port: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                };
+                readonly quiet: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                };
+            };
+            readonly mcp: {
+                readonly entry_type: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["hypequery.ts", "api.ts", "queries.ts", "explicit_file", "unknown"];
+                };
+                readonly mode: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["self_test", "serve"];
+                };
+                readonly dataset_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                };
+                readonly tenant_used: {
+                    readonly kind: "boolean";
+                    readonly description: string;
+                };
+                readonly tenant_dataset_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                };
+            };
+        };
+    };
+    readonly cli_session_ended: {
+        readonly purpose: "Measure session duration and aggregated usage on shutdown, without individual requests or tool arguments.";
+        readonly properties: {
+            readonly command: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["dev", "mcp"];
+            };
+            readonly outcome: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["success", "failure", "cancelled", "interrupted"];
+            };
+            readonly duration_bucket: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["<100ms", "100ms-1s", "1s-10s", "10s-1m", "1m-10m", "10m-1h", "1h+"];
+            };
+        };
+        readonly variants: {
+            readonly dev: {
+                readonly reload_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                };
+                readonly reload_error_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                };
+                readonly load_failures: {
+                    readonly kind: "record";
+                    readonly description: string;
+                    readonly fields: Record<"unknown" | "connection_failed" | "auth_failed" | "entrypoint_not_found" | "compile_error" | "prompt_cancelled" | "validation_failed" | "cloud_network_error" | "cloud_rejected" | "not_installed" | "engine_error" | "no_tables" | "no_datasets" | "tenant_required" | "load_error" | "output_missing" | "output_out_of_date" | "unknown_command" | "unknown_option", {
+                        readonly kind: "enum";
+                        readonly description: string;
+                        readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                    } & {
+                        readonly optional: true;
+                    }>;
+                };
+            };
+            readonly mcp: {
+                readonly tool_call_counts: {
+                    readonly kind: "record";
+                    readonly description: string;
+                    readonly fields: Record<"list" | "query" | "describe", {
+                        readonly kind: "enum";
+                        readonly description: string;
+                        readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                    }>;
+                };
+                readonly error_count_bucket: {
+                    readonly kind: "enum";
+                    readonly description: string;
+                    readonly values: readonly ["0", "1", "2-5", "6-20", "21-100", "101+"];
+                };
+            };
+        };
+    };
+    readonly cli_crash: {
+        readonly purpose: "Measure uncaught failures by stable class and code, with no messages or stacks.";
+        readonly properties: {
+            readonly command: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["init", "dev", "mcp", "generate", "generate:types", "generate:datasets", "generate:manifest", "login", "logout", "deploy", "deployment:build", "deployment:validate", "deployment:release", "deployment:submit", "deployment:status", "pull", "diff", "help", "version", "telemetry", "unknown"];
+            };
+            readonly exception_class: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["Error", "TypeError", "RangeError", "SyntaxError", "ReferenceError", "URIError", "EvalError", "AggregateError", "unknown"];
+            };
+            readonly error_code: {
+                readonly kind: "enum";
+                readonly description: string;
+                readonly values: readonly ["unknown", "connection_failed", "auth_failed", "entrypoint_not_found", "compile_error", "prompt_cancelled", "validation_failed", "cloud_network_error", "cloud_rejected", "not_installed", "engine_error", "no_tables", "no_datasets", "tenant_required", "load_error", "output_missing", "output_out_of_date", "unknown_command", "unknown_option"];
+            };
+        };
+    };
+};
+export type TelemetryEventName = keyof typeof EVENT_CATALOG;
+type Definition<N extends TelemetryEventName> = typeof EVENT_CATALOG[N];
+type VariantProperties<V extends Record<string, Fields>> = {
+    [C in keyof V]: {
+        command: C;
+    } & Properties<V[C]>;
+}[keyof V];
+type CompletionFlags = {
+    [C in keyof typeof COMMAND_FLAGS]: {
+        command: C;
+        flags_used: readonly (typeof COMMAND_FLAGS[C][number] | typeof GLOBAL_FLAGS[number])[];
+    };
+}[keyof typeof COMMAND_FLAGS];
+export type TelemetryProperties<N extends TelemetryEventName> = Properties<typeof COMMON_PROPERTIES> & Properties<Definition<N>['properties']> & (Definition<N> extends {
+    variants: infer V extends Record<string, Fields>;
+} ? VariantProperties<V> : unknown) & (N extends 'cli_command_completed' ? CompletionFlags : unknown);
+export type TelemetryEvent = {
+    [N in TelemetryEventName]: {
+        readonly event: N;
+        readonly properties: TelemetryProperties<N>;
+    };
+}[TelemetryEventName];
+export {};
+//# sourceMappingURL=catalog.d.ts.map