@hypequery/cli 1.2.1 → 1.3.0

package/README.md

@@ -108,6 +108,17 @@ Options:
 - `--tables <names>`: comma-separated table list
 - `--exclude-tables <names>`: comma-separated tables to exclude
 
+### `hypequery generate:manifest`
+
+Generates a static React hook route manifest from an exported HypeQuery API.
+
+```bash
+npx hypequery generate:manifest analytics/api.ts --output analytics/hypequery-manifest.json
+```
+
+The output is the exact serializable JSON returned by `api.manifest()`, including
+semantic keys such as `dataset:orders`.
+
 ## Non-interactive Setup
 
 `hypequery init --no-interactive` reads:

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;AAMpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAuHD,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;AAOpC,QAAA,MAAM,OAAO,SAAgB,CAAC;AAa9B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;EAKpE;AAgID,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/cli.js

@@ -5,6 +5,7 @@ import { initCommand } from './commands/init.js';
 import { devCommand } from './commands/dev.js';
 import { generateCommand } from './commands/generate.js';
 import { generateDatasetsCommand } from './commands/generate-datasets.js';
+import { generateManifestCommand } from './commands/generate-manifest.js';
 const program = new Command();
 function getCliVersion() {
     try {
@@ -97,6 +98,13 @@ program
     .action(runCommand(async (options) => {
     await generateDatasetsCommand(options);
 }));
+program
+    .command('generate:manifest <api>')
+    .description('Generate a static React hook manifest from a hypequery API module')
+    .option('-o, --output <path>', 'Output JSON file (default: analytics/hypequery-manifest.json)')
+    .action(runCommand(async (api, options) => {
+    await generateManifestCommand(api, options);
+}));
 // Help command
 program
     .command('help [command]')
@@ -126,6 +134,7 @@ program.on('--help', () => {
     console.log('  hypequery generate --output analytics/schema.ts');
     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('');
     console.log('Docs: https://hypequery.com/docs');
 });

package/dist/commands/generate-manifest.d.ts

@@ -0,0 +1,5 @@
+export interface GenerateManifestOptions {
+    output?: string;
+}
+export declare function generateManifestCommand(apiPath: string | undefined, options?: GenerateManifestOptions): Promise<void>;
+//# sourceMappingURL=generate-manifest.d.ts.map

package/dist/commands/generate-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-manifest.d.ts","sourceRoot":"","sources":["../../src/commands/generate-manifest.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,GAAE,uBAA4B,iBAyBtC"}

package/dist/commands/generate-manifest.js

@@ -0,0 +1,21 @@
+import { mkdir, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { loadApiModule } from '../utils/load-api.js';
+import { logger } from '../utils/logger.js';
+export async function generateManifestCommand(apiPath, options = {}) {
+    if (!apiPath) {
+        throw new Error('Missing API module path.\n\n' +
+            'Usage: hypequery generate:manifest analytics/api.ts --output analytics/hypequery-manifest.json');
+    }
+    const outputPath = options.output ?? 'analytics/hypequery-manifest.json';
+    const api = await loadApiModule(apiPath);
+    if (!api || typeof api.manifest !== 'function') {
+        throw new Error(`Invalid API module: ${apiPath}\n\n` +
+            `The exported API must provide a manifest() method. ` +
+            `Export the value returned by createAPI() or initServe(...).serve(...).`);
+    }
+    const manifest = api.manifest();
+    await mkdir(path.dirname(outputPath), { recursive: true });
+    await writeFile(outputPath, `${JSON.stringify(manifest, null, 2)}\n`, 'utf8');
+    logger.success(`Manifest written to ${outputPath}`);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/cli",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Command-line interface for hypequery",
   "license": "Apache-2.0",
   "type": "module",
@@ -32,11 +32,11 @@
   "devDependencies": {
     "@types/node": "^20.11.30",
     "@types/prompts": "^2.4.9",
-    "@vitest/coverage-v8": "^2.1.6",
+    "@vitest/coverage-v8": "^3.2.6",
     "typescript": "^5.7.3",
-    "vitest": "^2.1.6",
+    "vitest": "^3.2.6",
     "@hypequery/clickhouse": "2.1.2",
-    "@hypequery/serve": "0.5.0"
+    "@hypequery/serve": "0.6.0"
   },
   "repository": {
     "type": "git",