@hypequery/cli 1.9.5 → 1.10.1

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAgLD,OAAO,EAAE,OAAO,EAAE,CAAC"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAkLD,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -78,6 +78,8 @@ program
     .option('--cache <provider>', 'Cache provider (memory|redis)')
     .option('--redis-url <url>', 'Redis connection URL')
     .option('--open', 'Open browser automatically')
+    .option('--ui-experimental', 'Serve the experimental query UI at /__dev (unstable, not for production use)')
+    .option('--no-telemetry', 'Disable anonymous playground usage telemetry')
     .option('--cors', 'Enable CORS')
     .option('--path <path>', 'Analytics directory (loads <path>/api.ts or <path>/queries.ts)')
     .option('-q, --quiet', 'Suppress startup messages')

package/dist/commands/dev.d.ts

@@ -8,6 +8,17 @@ export interface DevOptions {
     open?: boolean;
     cors?: boolean;
     path?: string;
+    /**
+     * Opt into the experimental query UI/gateway at /__dev. Off by default —
+     * the UI is not release-ready; behaviour and flag may change or go away.
+     */
+    uiExperimental?: boolean;
+    /**
+     * Anonymous playground usage telemetry. Commander sets this to `false` when
+     * `--no-telemetry` is passed; otherwise it is undefined (telemetry follows
+     * its usual endpoint/env gating).
+     */
+    telemetry?: boolean;
 }
 export declare function devCommand(file?: string, options?: DevOptions): Promise<void>;
 //# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,iBAyLvE"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AA8BA,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AA6BD,wBAAsB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,iBAkQvE"}

package/dist/commands/dev.js

@@ -26,6 +26,30 @@ function displayQueriesFileNotFoundError(commandName) {
     logger.indent(`hypequery ${commandName} ./path/to/api.ts`);
     logger.newline();
 }
+/**
+ * Attempt to create the local gateway from @hypequery/gateway. The package is an
+ * optional dependency, so it may be absent; in that case we return null (with a
+ * hint) and `hypequery dev` still runs as a plain server.
+ */
+async function createGatewayIfAvailable(api, telemetryDisabled) {
+    try {
+        const { createGateway } = await import('@hypequery/gateway');
+        return (await createGateway(api, {
+            projectName: path.basename(process.cwd()),
+            devToken: process.env.HYPEQUERY_DEV_TOKEN,
+            telemetryDisabled,
+        }));
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('Cannot find') || message.includes('ERR_MODULE_NOT_FOUND')) {
+            logger.warn('Playground UI not installed. Install @hypequery/gateway to enable it.');
+            return null;
+        }
+        logger.warn(`Playground failed to start: ${message}`);
+        return null;
+    }
+}
 export async function devCommand(file, options = {}) {
     // Step 1: Find queries file
     const queriesFile = file
@@ -40,7 +64,43 @@ export async function devCommand(file, options = {}) {
     logger.info(`Found: ${path.relative(process.cwd(), queriesFile)}`);
     logger.newline();
     let currentServer = null;
+    let currentGateway = null;
+    let lifecycleOperation = Promise.resolve();
+    let shutdownRequested = false;
     const shouldWatch = options.watch !== false; // Default to true
+    const queueLifecycleOperation = (operation) => {
+        const queued = lifecycleOperation.then(operation, operation);
+        lifecycleOperation = queued.catch(() => undefined);
+        return queued;
+    };
+    const stopCurrentRuntime = async () => {
+        const gateway = currentGateway;
+        const server = currentServer;
+        // Clear references before awaiting teardown so a second signal or restart
+        // cannot stop the same resources twice.
+        currentGateway = null;
+        currentServer = null;
+        let teardownError;
+        if (gateway) {
+            try {
+                await gateway.shutdown();
+            }
+            catch (error) {
+                teardownError = error;
+            }
+        }
+        if (server) {
+            try {
+                await server.stop();
+            }
+            catch (error) {
+                teardownError ??= error;
+            }
+        }
+        if (teardownError) {
+            throw teardownError;
+        }
+    };
     const startServer = async () => {
         // Loading spinners for slow operations
         const compileSpinner = ora('Compiling queries...').start();
@@ -67,12 +127,19 @@ export async function devCommand(file, options = {}) {
             logger.header('hypequery dev');
             logger.success(`Registered ${queryCount} ${queryCount === 1 ? 'query' : 'queries'}`);
             logger.newline();
+            // The query UI is experimental and strictly opt-in; the default dev
+            // server is unchanged.
+            const gateway = options.uiExperimental
+                ? await createGatewayIfAvailable(api, options.telemetry === false)
+                : null;
+            currentGateway = gateway;
             // Start the server
-            const { serveDev } = await import('@hypequery/serve');
+            const { serveDev } = await import('@hypequery/serve/dev');
             currentServer = await serveDev(api, {
                 port: options.port,
                 hostname: options.hostname,
                 quiet: true,
+                mount: gateway?.mount,
             });
             const address = currentServer.server.address();
             const port = typeof address === 'object' && address ? address.port : options.port || 4000;
@@ -80,10 +147,14 @@ export async function devCommand(file, options = {}) {
             const baseUrl = `http://${hostname}:${port}`;
             const docsPath = api.docs?.path ?? '/docs';
             const openapiPath = api.openapi?.path ?? '/openapi.json';
-            logger.box([
+            const boxLines = [
                 `Docs:     ${baseUrl}${api.basePath ?? ''}${docsPath}`,
                 `OpenAPI:  ${baseUrl}${api.basePath ?? ''}${openapiPath}`,
-            ]);
+            ];
+            if (gateway?.uiAvailable) {
+                boxLines.unshift(`Playground: ${baseUrl}/__dev`);
+            }
+            logger.box(boxLines);
             logger.newline();
             logger.success(`Ready in ${process.uptime().toFixed(0)}ms`);
             logger.newline();
@@ -110,6 +181,16 @@ export async function devCommand(file, options = {}) {
             }
         }
         catch (error) {
+            // Gateway creation happens before serveDev so its mount can be passed to
+            // the server. If server startup (or any later setup) fails, tear down all
+            // resources acquired by this attempt before retrying or exiting.
+            try {
+                await stopCurrentRuntime();
+            }
+            catch (teardownError) {
+                const message = teardownError instanceof Error ? teardownError.message : String(teardownError);
+                logger.warn(`Failed to clean up dev server resources: ${message}`);
+            }
             // Stop spinners if they're still running
             if (compileSpinner.isSpinning) {
                 compileSpinner.fail('Failed to compile queries');
@@ -136,22 +217,29 @@ export async function devCommand(file, options = {}) {
             }
         }
     };
-    const restartServer = async () => {
-        if (currentServer) {
+    const restartServer = () => queueLifecycleOperation(async () => {
+        if (shutdownRequested)
+            return;
+        if (currentServer || currentGateway) {
             logger.newline();
             logger.reload('File changed, restarting...');
             logger.newline();
-            await currentServer.stop();
+            await stopCurrentRuntime();
         }
-        await startServer();
-    };
-    const shutdown = async () => {
+        if (!shutdownRequested) {
+            await startServer();
+        }
+    });
+    const shutdown = () => {
+        if (shutdownRequested)
+            return lifecycleOperation;
+        shutdownRequested = true;
         logger.newline();
         logger.info('Shutting down dev server...');
-        if (currentServer) {
-            await currentServer.stop();
-        }
-        process.exit(0);
+        return queueLifecycleOperation(async () => {
+            await stopCurrentRuntime();
+            process.exit(0);
+        });
     };
     // Start initial server
     await startServer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/cli",
-  "version": "1.9.5",
+  "version": "1.10.1",
   "description": "Command-line interface for hypequery",
   "license": "Apache-2.0",
   "type": "module",
@@ -19,8 +19,11 @@
     "open": "^10.0.0",
     "ora": "^8.0.1",
     "prompts": "^2.4.2",
-    "@hypequery/protocol": "0.9.0",
-    "@hypequery/deployment": "0.5.1"
+    "@hypequery/deployment": "0.5.1",
+    "@hypequery/protocol": "0.9.0"
+  },
+  "optionalDependencies": {
+    "@hypequery/gateway": "0.2.0"
   },
   "peerDependencies": {
     "@hypequery/clickhouse": "*",
@@ -37,8 +40,8 @@
     "@vitest/coverage-v8": "^3.2.6",
     "typescript": "^5.7.3",
     "vitest": "^3.2.6",
-    "@hypequery/clickhouse": "2.4.0",
-    "@hypequery/serve": "0.13.6"
+    "@hypequery/clickhouse": "2.5.0",
+    "@hypequery/serve": "0.14.0"
   },
   "repository": {
     "type": "git",