@hypequery/cli 1.11.0 → 1.12.1

package/README.md

@@ -25,6 +25,13 @@ Or install it once:
 npm install -D @hypequery/cli
 ```
 
+Ship it to Hypequery Cloud:
+
+```bash
+npx @hypequery/cli login
+npx @hypequery/cli deploy analytics/api.ts
+```
+
 ## Commands
 
 ### `hypequery init`
@@ -140,7 +147,9 @@ semantic keys such as `dataset:orders`.
 
 Builds a closed deployment bundle for an exported HypeQuery API. The bundle
 contains canonical deployment metadata, every referenced runtime artifact, and
-a manifest that binds their exact bytes and identities.
+a manifest that binds their exact bytes and identities. `hypequery deploy` runs
+this step for you; reach for it directly in CI pipelines that stage artifacts,
+or when you need the runtime options below.
 
 ```bash
 npx hypequery deployment:build analytics/api.ts
@@ -197,8 +206,9 @@ Use `--cloud-url <origin>` or `HYPEQUERY_CLOUD_URL` for a self-hosted or local
 Cloud instance. HTTPS is required except for loopback development origins.
 
 Once logged in, `hypequery deploy` automatically uses the stored endpoint and
-token. The deployment endpoint is returned by Cloud during the token exchange;
-it is the authenticated upload API, not the browser login endpoint. For
+token, and resolves the project and environment from the same stored profile.
+The deployment endpoint is returned by Cloud during the token exchange; it is
+the authenticated upload API, not the browser login endpoint. For
 non-interactive CI usage, set both `HYPEQUERY_API_TOKEN` and
 `HYPEQUERY_DEPLOYMENT_ENDPOINT` (or pass `--endpoint`).
 
@@ -223,6 +233,53 @@ npx hypequery logout
 If the stored profile is unreadable, `logout` still removes the local state and
 reports that the token was not revoked; it expires on its own.
 
+### `hypequery deploy`
+
+Builds a deployment bundle from an API module, prepares a target-bound release,
+and submits both. This is the primary Cloud workflow: sign in once, then deploy
+with one command.
+
+```bash
+npx hypequery login
+npx hypequery deploy analytics/api.ts
+```
+
+The bundle is written to `analytics/hypequery-deployment` and the release to
+`analytics/hypequery-deployment.release.json`. The target comes from the stored
+Cloud profile unless you override it:
+
+```bash
+npx hypequery deploy analytics/api.ts \
+  --project my-project \
+  --environment production
+```
+
+The deployment endpoint and token are resolved before the build, so a missing
+or expired login fails immediately rather than after bundling. The credential
+rules are the same as `hypequery deployment:submit` below.
+
+The three steps remain available individually as `deployment:build`,
+`deployment:release`, and `deployment:submit` for CI pipelines that stage
+artifacts, and for the cases `deploy` does not cover: `deploy` always builds the
+runtime artifact itself, so Python deployments and prebuilt runtime artifacts
+(`--runtime`, `--runtime-artifact`, `--runtime-file`) need `deployment:build`.
+
+Options:
+
+- `--project <project>`: target project identifier; defaults to the logged-in
+  target and must be paired with `--environment`
+- `--environment <environment>`: target environment identifier; defaults to the
+  logged-in target and must be paired with `--project`
+- `--bundle-output <directory>`: bundle directory, default
+  `analytics/hypequery-deployment`
+- `--release-output <path>`: release JSON path, default beside the bundle
+- `--endpoint <url>`: HTTPS submission endpoint; requires `HYPEQUERY_API_TOKEN`
+
+> **Deprecated:** `hypequery deploy <bundle> --release <file>` still submits a
+> prebuilt bundle and prints a deprecation warning. Use
+> `hypequery deployment:submit` instead. `--release` cannot be combined with
+> `--project`, `--environment`, `--bundle-output`, or `--release-output`.
+
 ### `hypequery deployment:release`
 
 Prepares a deterministic release request from a verified deployment bundle and
@@ -259,14 +316,16 @@ Options:
   logged-in target and must be paired with `--project`
 - `--output <path>`: release JSON path, default beside the bundle
 
-### `hypequery deploy`
+### `hypequery deployment:submit`
 
 Submits a verified deployment bundle with an already-prepared target-bound
 release. The command verifies both inputs again, requires their bundle
-identities to match, and streams only the files declared by the bundle.
+identities to match, and streams only the files declared by the bundle. Use it
+when the bundle and release were produced by an earlier pipeline step; for the
+ordinary path, use `hypequery deploy`.
 
 ```bash
-npx hypequery deploy analytics/hypequery-deployment \
+npx hypequery deployment:submit analytics/hypequery-deployment \
   --release analytics/hypequery-deployment.release.json
 ```
 

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;AAuBpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAoMD,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;AAyBpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAsND,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -7,7 +7,7 @@ import { generateCommand } from './commands/generate.js';
 import { generateDatasetsCommand } from './commands/generate-datasets.js';
 import { generateManifestCommand } from './commands/generate-manifest.js';
 import { buildDeploymentCommand, prepareDeploymentReleaseCommand, validateDeploymentCommand, } from './commands/deployment.js';
-import { deployCommand, } from './commands/deploy.js';
+import { deployCommand, submitDeploymentCommand, } from './commands/deploy.js';
 import { loginCommand, logoutCommand, } from './commands/login.js';
 const program = new Command();
 function getCliVersion() {
@@ -154,12 +154,24 @@ program
     await prepareDeploymentReleaseCommand(bundle, options);
 }));
 program
-    .command('deploy <bundle>')
-    .description('Submit a verified deployment bundle and release')
+    .command('deployment:submit <bundle>')
+    .description('Submit a prebuilt deployment bundle and release')
     .requiredOption('--release <path>', 'Target-bound release JSON path')
     .option('--endpoint <url>', 'HTTPS submission endpoint; requires HYPEQUERY_API_TOKEN')
     .action(runCommand(async (bundle, options) => {
-    await deployCommand(bundle, options);
+    await submitDeploymentCommand(bundle, options);
+}));
+program
+    .command('deploy <source>')
+    .description('Build, prepare, and deploy a Hypequery API module')
+    .option('--bundle-output <directory>', 'Bundle directory (default: analytics/hypequery-deployment)')
+    .option('--release-output <path>', 'Release JSON path (default: beside the bundle)')
+    .option('--project <project>', 'Target project identifier (advanced override)')
+    .option('--environment <environment>', 'Target environment identifier (advanced override)')
+    .option('--release <path>', 'Submit a prebuilt bundle with this release (legacy)')
+    .option('--endpoint <url>', 'HTTPS submission endpoint; requires HYPEQUERY_API_TOKEN')
+    .action(runCommand(async (source, options) => {
+    await deployCommand(source, options);
 }));
 // Help command
 program
@@ -193,10 +205,12 @@ program.on('--help', () => {
     console.log('  hypequery generate:types --output analytics/schema.ts');
     console.log('  hypequery generate:datasets');
     console.log('  hypequery generate:manifest analytics/api.ts --output analytics/hypequery-manifest.json');
+    console.log('  hypequery deploy analytics/api.ts');
+    console.log('  hypequery deploy analytics/api.ts --project my-project --environment production');
     console.log('  hypequery deployment:build analytics/api.ts');
     console.log('  hypequery deployment:validate analytics/hypequery-deployment');
     console.log('  hypequery deployment:release analytics/hypequery-deployment --project my-project --environment production');
-    console.log('  hypequery deploy analytics/hypequery-deployment --release analytics/hypequery-deployment.release.json');
+    console.log('  hypequery deployment:submit analytics/hypequery-deployment --release analytics/hypequery-deployment.release.json');
     console.log('');
     console.log('Docs: https://hypequery.com/docs');
 });

package/dist/commands/deploy.d.ts

@@ -1,13 +1,26 @@
 import { createHttpDeploymentUploadTransport, type DeploymentSubmissionResponse } from '../utils/deployment-upload.js';
 import { type StoredCloudCredential } from '../utils/cloud-credential-store.js';
-export interface DeployOptions {
+import { buildDeploymentCommand, prepareDeploymentReleaseCommand } from './deployment.js';
+export interface SubmitDeploymentOptions {
     release?: string;
     endpoint?: string;
 }
-export interface DeployDependencies {
+export interface DeployOptions extends SubmitDeploymentOptions {
+    project?: string;
+    environment?: string;
+    bundleOutput?: string;
+    releaseOutput?: string;
+}
+export interface SubmitDeploymentDependencies {
     readonly env?: Readonly<Record<string, string | undefined>>;
     readonly createTransport?: typeof createHttpDeploymentUploadTransport;
     readonly loadCredential?: () => Promise<StoredCloudCredential | null>;
 }
-export declare function deployCommand(bundlePath: string | undefined, options?: DeployOptions, dependencies?: DeployDependencies): Promise<DeploymentSubmissionResponse>;
+export interface DeployDependencies extends SubmitDeploymentDependencies {
+    readonly buildDeployment?: typeof buildDeploymentCommand;
+    readonly prepareDeploymentRelease?: typeof prepareDeploymentReleaseCommand;
+    readonly submitDeployment?: typeof submitDeploymentCommand;
+}
+export declare function submitDeploymentCommand(bundlePath: string | undefined, options?: SubmitDeploymentOptions, dependencies?: SubmitDeploymentDependencies): Promise<DeploymentSubmissionResponse>;
+export declare function deployCommand(sourcePath: string | undefined, options?: DeployOptions, dependencies?: DeployDependencies): Promise<DeploymentSubmissionResponse>;
 //# sourceMappingURL=deploy.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,mCAAmC,EAEnC,KAAK,4BAA4B,EAElC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAK5C,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,mCAAmC,CAAC;IACtE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;CACvE;AA4DD,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,aAAkB,EAC3B,YAAY,GAAE,kBAAuB,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAoFvC"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AASA,OAAO,EACL,mCAAmC,EAEnC,KAAK,4BAA4B,EAElC,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EACL,sBAAsB,EACtB,+BAA+B,EAChC,MAAM,iBAAiB,CAAC;AAMzB,MAAM,WAAW,uBAAuB;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,aAAc,SAAQ,uBAAuB;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,mCAAmC,CAAC;IACtE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;CACvE;AAED,MAAM,WAAW,kBAAmB,SAAQ,4BAA4B;IACtE,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,sBAAsB,CAAC;IACzD,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,+BAA+B,CAAC;IAC3E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,uBAAuB,CAAC;CAC5D;AA8GD,wBAAsB,uBAAuB,CAC3C,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,uBAA4B,EACrC,YAAY,GAAE,4BAAiC,GAC9C,OAAO,CAAC,4BAA4B,CAAC,CAwDvC;AAmDD,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,aAAkB,EAC3B,YAAY,GAAE,kBAAuB,GACpC,OAAO,CAAC,4BAA4B,CAAC,CAmDvC"}

package/dist/commands/deploy.js

@@ -1,10 +1,13 @@
-import { constants, open } from 'node:fs/promises';
+import { access, constants, open } from 'node:fs/promises';
+import path from 'node:path';
 import { prepareProtocolDeploymentReleaseEnvelope, } from '@hypequery/protocol';
-import { verifyDeploymentBundle } from '../utils/deployment-bundle.js';
+import { DEPLOYMENT_BUNDLE_MANIFEST, verifyDeploymentBundle, } from '../utils/deployment-bundle.js';
 import { createHttpDeploymentUploadTransport, DeploymentUploadError, } from '../utils/deployment-upload.js';
 import { logger } from '../utils/logger.js';
 import { loadCloudCredential, } from '../utils/cloud-credential-store.js';
+import { buildDeploymentCommand, prepareDeploymentReleaseCommand, } from './deployment.js';
 const MAX_RELEASE_FILE_BYTES = 16 * 1024;
+const DEFAULT_BUNDLE_PATH = 'analytics/hypequery-deployment';
 const utf8Decoder = new TextDecoder('utf-8', { fatal: true });
 async function readReleaseFile(releasePath) {
     let handle;
@@ -61,15 +64,14 @@ function requiredConfiguration(value, message) {
         throw new Error(message);
     return value;
 }
-export async function deployCommand(bundlePath, options = {}, dependencies = {}) {
-    if (!bundlePath) {
-        throw new Error('Missing deployment bundle path.\n\n'
-            + 'Usage: hypequery deploy analytics/hypequery-deployment '
-            + '--release analytics/hypequery-deployment.release.json');
-    }
-    const releasePath = requiredConfiguration(options.release, 'Missing required --release <path>.');
+/**
+ * Resolves the submission endpoint and token. Kept separate from
+ * `submitDeploymentCommand` so `deployCommand` can run it as a preflight
+ * before the bundle build.
+ */
+async function resolveDeploymentCredential(endpointOption, dependencies) {
     const env = dependencies.env ?? process.env;
-    let deploymentEndpoint = options.endpoint ?? env.HYPEQUERY_DEPLOYMENT_ENDPOINT;
+    let deploymentEndpoint = endpointOption ?? env.HYPEQUERY_DEPLOYMENT_ENDPOINT;
     let token = env.HYPEQUERY_API_TOKEN;
     const hasExplicitEndpoint = Boolean(deploymentEndpoint);
     const hasExplicitToken = Boolean(token);
@@ -90,8 +92,19 @@ export async function deployCommand(bundlePath, options = {}, dependencies = {})
             token = credential.token;
         }
     }
-    deploymentEndpoint = requiredConfiguration(deploymentEndpoint, 'Missing deployment endpoint. Run `hypequery login`, pass --endpoint, or set HYPEQUERY_DEPLOYMENT_ENDPOINT.');
-    token = requiredConfiguration(token, 'Missing deployment credential. Run `hypequery login` or set HYPEQUERY_API_TOKEN.');
+    return {
+        endpoint: requiredConfiguration(deploymentEndpoint, 'Missing deployment endpoint. Run `hypequery login`, pass --endpoint, or set HYPEQUERY_DEPLOYMENT_ENDPOINT.'),
+        token: requiredConfiguration(token, 'Missing deployment credential. Run `hypequery login` or set HYPEQUERY_API_TOKEN.'),
+    };
+}
+export async function submitDeploymentCommand(bundlePath, options = {}, dependencies = {}) {
+    if (!bundlePath) {
+        throw new Error('Missing deployment bundle path.\n\n'
+            + 'Usage: hypequery deployment:submit analytics/hypequery-deployment '
+            + '--release analytics/hypequery-deployment.release.json');
+    }
+    const releasePath = requiredConfiguration(options.release, 'Missing required --release <path>.');
+    const { endpoint: deploymentEndpoint, token } = await resolveDeploymentCredential(options.endpoint, dependencies);
     let bundle;
     try {
         bundle = await verifyDeploymentBundle(bundlePath);
@@ -125,3 +138,87 @@ export async function deployCommand(bundlePath, options = {}, dependencies = {})
     logger.info(`Bundle identity: ${result.bundleIdentity}`);
     return result;
 }
+/**
+ * `deploy` takes an API module, but the deprecated form took a bundle
+ * directory. Dropping `--release` from an existing script would otherwise hand
+ * a bundle to the module loader and fail inside esbuild.
+ */
+async function rejectBundleDirectorySource(sourcePath) {
+    try {
+        await access(path.join(sourcePath, DEPLOYMENT_BUNDLE_MANIFEST));
+    }
+    catch {
+        return;
+    }
+    throw new Error(`Cannot deploy a prebuilt bundle directory: ${sourcePath}\n\n`
+        + '`hypequery deploy` takes the API module to build, for example '
+        + '`hypequery deploy analytics/api.ts`.\n'
+        + 'To upload this bundle, use `hypequery deployment:submit '
+        + `${sourcePath} --release <file>\`.`);
+}
+/**
+ * `deploy` exposes no runtime flags, so a runtime error from the shared build
+ * command would otherwise point at flags this command does not accept.
+ */
+function withRuntimeFlagHint(error) {
+    if (!(error instanceof Error) || !error.message.includes('--runtime'))
+        return error;
+    return new Error(`${error.message}\n\n`
+        + 'Runtime overrides are not available on `hypequery deploy`. Build with '
+        + '`hypequery deployment:build` (which accepts --runtime, --runtime-artifact, '
+        + 'and --runtime-file), then upload with `hypequery deployment:submit`.');
+}
+function rejectLegacyOrchestrationOptions(options) {
+    if (options.project !== undefined
+        || options.environment !== undefined
+        || options.bundleOutput !== undefined
+        || options.releaseOutput !== undefined) {
+        throw new Error('--release selects prebuilt submission mode and cannot be combined with '
+            + '--project, --environment, --bundle-output, or --release-output. '
+            + 'Use `hypequery deployment:submit` for explicit prebuilt uploads.');
+    }
+}
+export async function deployCommand(sourcePath, options = {}, dependencies = {}) {
+    if (!sourcePath) {
+        throw new Error('Missing API module path.\n\n'
+            + 'Usage: hypequery deploy analytics/api.ts');
+    }
+    if (options.release !== undefined) {
+        rejectLegacyOrchestrationOptions(options);
+        logger.warn('`hypequery deploy <bundle> --release <file>` is deprecated. '
+            + 'Use `hypequery deployment:submit <bundle> --release <file>` instead.');
+        return submitDeploymentCommand(sourcePath, {
+            release: options.release,
+            endpoint: options.endpoint,
+        }, dependencies);
+    }
+    await rejectBundleDirectorySource(sourcePath);
+    const bundlePath = options.bundleOutput ?? DEFAULT_BUNDLE_PATH;
+    const releasePath = options.releaseOutput
+        ?? `${bundlePath.replace(/[\\/]+$/, '')}.release.json`;
+    const build = dependencies.buildDeployment ?? buildDeploymentCommand;
+    const prepareRelease = dependencies.prepareDeploymentRelease
+        ?? prepareDeploymentReleaseCommand;
+    const submit = dependencies.submitDeployment ?? submitDeploymentCommand;
+    // Resolve credentials up front. Submission is the last step, so without this
+    // a missing or expired login only surfaces after a full bundle build.
+    await resolveDeploymentCredential(options.endpoint, dependencies);
+    try {
+        await build(sourcePath, { bundleOutput: bundlePath });
+    }
+    catch (error) {
+        throw withRuntimeFlagHint(error);
+    }
+    await prepareRelease(bundlePath, {
+        project: options.project,
+        environment: options.environment,
+        output: releasePath,
+    }, {
+        loadCredential: dependencies.loadCredential,
+        outputFlagLabel: '--release-output',
+    });
+    return submit(bundlePath, {
+        release: releasePath,
+        endpoint: options.endpoint,
+    }, dependencies);
+}

package/dist/commands/deployment.d.ts

@@ -17,6 +17,11 @@ export interface PrepareDeploymentReleaseOptions {
 }
 export interface PrepareDeploymentReleaseDependencies {
     loadCredential?: () => Promise<StoredCloudCredential | null>;
+    /**
+     * Flag name to quote in output-path errors. `hypequery deploy` delegates
+     * here but spells the same option `--release-output`.
+     */
+    outputFlagLabel?: string;
 }
 export declare function buildDeploymentCommand(apiPath: string | undefined, options?: BuildDeploymentOptions): Promise<ProtocolDeploymentContract>;
 export declare function validateDeploymentCommand(artifactPath: string | undefined): Promise<ProtocolDeploymentContract>;

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

@@ -1 +1 @@
-{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/commands/deployment.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EACvC,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAI5C,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oCAAoC;IACnD,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;CAC9D;AAoDD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAwIrC;AAED,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CA2ErC;AA0DD,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,+BAAoC,EAC7C,YAAY,GAAE,oCAAyC,GACtD,OAAO,CAAC,iCAAiC,CAAC,CAgE5C"}
+{"version":3,"file":"deployment.d.ts","sourceRoot":"","sources":["../../src/commands/deployment.ts"],"names":[],"mappings":"AAGA,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,iCAAiC,EACvC,MAAM,qBAAqB,CAAC;AAc7B,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,oCAAoC,CAAC;AAI5C,MAAM,WAAW,sBAAsB;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC5B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,+BAA+B;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oCAAoC;IACnD,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IAC7D;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAoDD,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CAwIrC;AAED,wBAAsB,yBAAyB,CAC7C,YAAY,EAAE,MAAM,GAAG,SAAS,GAC/B,OAAO,CAAC,0BAA0B,CAAC,CA2ErC;AAiED,wBAAsB,+BAA+B,CACnD,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,OAAO,GAAE,+BAAoC,EAC7C,YAAY,GAAE,oCAAyC,GACtD,OAAO,CAAC,iCAAiC,CAAC,CAkE5C"}

package/dist/commands/deployment.js

@@ -218,7 +218,7 @@ export async function validateDeploymentCommand(artifactPath) {
     logger.info(`Identity: ${digest}`);
     return contract;
 }
-function assertOutputOutsideBundle(bundlePath, outputPath) {
+function assertOutputOutsideBundle(bundlePath, outputPath, outputFlag) {
     const bundle = path.resolve(bundlePath);
     const output = path.resolve(outputPath);
     const relative = path.relative(bundle, output);
@@ -226,10 +226,10 @@ function assertOutputOutsideBundle(bundlePath, outputPath) {
         || relative.startsWith(`..${path.sep}`)
         || path.isAbsolute(relative);
     if (relative === '' || !outside) {
-        throw new Error('--output must be outside the closed deployment bundle directory.');
+        throw new Error(`${outputFlag} must be outside the closed deployment bundle directory.`);
     }
 }
-async function prospectiveRealPath(inputPath) {
+async function prospectiveRealPath(inputPath, outputFlag) {
     let current = path.resolve(inputPath);
     const missingSegments = [];
     for (;;) {
@@ -244,7 +244,7 @@ async function prospectiveRealPath(inputPath) {
             try {
                 const stat = await lstat(current);
                 if (stat.isSymbolicLink()) {
-                    throw new Error('--output must not traverse a dangling symbolic link.');
+                    throw new Error(`${outputFlag} must not traverse a dangling symbolic link.`);
                 }
             }
             catch (lstatError) {
@@ -261,11 +261,11 @@ async function prospectiveRealPath(inputPath) {
         }
     }
 }
-async function assertOutputIsNotSymbolicLink(outputPath) {
+async function assertOutputIsNotSymbolicLink(outputPath, outputFlag) {
     try {
         const outputStat = await lstat(outputPath);
         if (outputStat.isSymbolicLink()) {
-            throw new Error('--output must not be a symbolic link.');
+            throw new Error(`${outputFlag} must not be a symbolic link.`);
         }
     }
     catch (error) {
@@ -303,8 +303,9 @@ export async function prepareDeploymentReleaseCommand(bundlePath, options = {},
                 + '--project <project> and --environment <environment>.');
         }
     }
+    const outputFlag = dependencies.outputFlagLabel ?? '--output';
     const outputPath = options.output ?? `${bundlePath.replace(/[\\/]+$/, '')}.release.json`;
-    assertOutputOutsideBundle(bundlePath, outputPath);
+    assertOutputOutsideBundle(bundlePath, outputPath, outputFlag);
     let bundle;
     try {
         bundle = await verifyDeploymentBundle(bundlePath);
@@ -313,7 +314,7 @@ export async function prepareDeploymentReleaseCommand(bundlePath, options = {},
         throw new Error(`Cannot prepare a release from an invalid deployment bundle: ${bundlePath}\n\n`
             + (error instanceof Error ? error.message : String(error)));
     }
-    assertOutputOutsideBundle(bundle.directory, await prospectiveRealPath(outputPath));
+    assertOutputOutsideBundle(bundle.directory, await prospectiveRealPath(outputPath, outputFlag), outputFlag);
     const prepared = prepareProtocolDeploymentReleaseEnvelope({
         kind: 'hypequery-deployment-release',
         version: 1,
@@ -324,7 +325,7 @@ export async function prepareDeploymentReleaseCommand(bundlePath, options = {},
         },
     });
     await mkdir(path.dirname(outputPath), { recursive: true });
-    await assertOutputIsNotSymbolicLink(outputPath);
+    await assertOutputIsNotSymbolicLink(outputPath, outputFlag);
     await writeFile(outputPath, `${prepared.canonical}\n`, 'utf8');
     logger.success(`Deployment release written to ${outputPath}`);
     logger.info(`Target: ${project}/${environment}`);

package/dist/generators/index.d.ts

@@ -1,6 +1,6 @@
 import type { DatabaseType } from '../utils/detect-database.js';
-import { type ClickHouseGeneratorOptions } from './clickhouse.js';
-import { type ChdbGeneratorOptions } from './chdb.js';
+import type { ClickHouseGeneratorOptions } from './clickhouse.js';
+import type { ChdbGeneratorOptions } from './chdb.js';
 export type TypeGeneratorOptions = ClickHouseGeneratorOptions & ChdbGeneratorOptions;
 type GeneratorFn = (options: TypeGeneratorOptions) => Promise<void>;
 export declare function getTypeGenerator(dbType: DatabaseType): GeneratorFn;

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,EAA2B,KAAK,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAC3F,OAAO,EAAqB,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEzE,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,GAAG,oBAAoB,CAAC;AAErF,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAOpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAYlE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/generators/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC;AAClE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAC;AAEtD,MAAM,MAAM,oBAAoB,GAAG,0BAA0B,GAAG,oBAAoB,CAAC;AAErF,KAAK,WAAW,GAAG,CAAC,OAAO,EAAE,oBAAoB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAiBpE,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,WAAW,CAYlE"}

package/dist/generators/index.js

@@ -1,8 +1,16 @@
-import { generateClickHouseTypes } from './clickhouse.js';
-import { generateChdbTypes } from './chdb.js';
+// Loaded on demand. Both generators pull in `@hypequery/clickhouse/cli`, and importing
+// that eagerly puts it on the module graph of every command — a resolution failure there
+// took down even `hypequery --help`. Deferring it keeps the blast radius on the commands
+// that actually generate types.
 const generators = {
-    clickhouse: generateClickHouseTypes,
-    chdb: generateChdbTypes,
+    clickhouse: async (options) => {
+        const { generateClickHouseTypes } = await import('./clickhouse.js');
+        await generateClickHouseTypes(options);
+    },
+    chdb: async (options) => {
+        const { generateChdbTypes } = await import('./chdb.js');
+        await generateChdbTypes(options);
+    },
 };
 export function getTypeGenerator(dbType) {
     const generator = generators[dbType];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/cli",
-  "version": "1.11.0",
+  "version": "1.12.1",
   "description": "Command-line interface for hypequery",
   "license": "Apache-2.0",
   "type": "module",
@@ -20,27 +20,21 @@
     "ora": "^8.0.1",
     "prompts": "^2.4.2",
     "@hypequery/deployment": "0.6.0",
-    "@hypequery/protocol": "0.9.0"
+    "@hypequery/protocol": "0.9.0",
+    "@hypequery/clickhouse": "2.5.2"
   },
   "optionalDependencies": {
     "@napi-rs/keyring": "1.3.0"
   },
   "peerDependencies": {
-    "@hypequery/clickhouse": "*",
     "@hypequery/serve": "*"
   },
-  "peerDependenciesMeta": {
-    "@hypequery/clickhouse": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/node": "^20.11.30",
     "@types/prompts": "^2.4.9",
     "@vitest/coverage-v8": "^3.2.6",
     "typescript": "^5.7.3",
     "vitest": "^3.2.6",
-    "@hypequery/clickhouse": "2.5.2",
     "@hypequery/serve": "0.14.0"
   },
   "repository": {