@hypequery/cli 1.2.0 → 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/dist/generators/dataset-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dataset-generator.d.ts","sourceRoot":"","sources":["../../src/generators/dataset-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AA6MD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,iBAyDtE"}
+{"version":3,"file":"dataset-generator.d.ts","sourceRoot":"","sources":["../../src/generators/dataset-generator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAuPD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,iBAyDtE"}

package/dist/generators/dataset-generator.js

@@ -68,6 +68,38 @@ function isNumericColumn(column) {
         type.includes('double') ||
         type.includes('decimal'));
 }
+/**
+ * Check if a numeric column is more likely an identifier than an additive value.
+ */
+function isIdentifierColumn(column) {
+    const originalName = column.name;
+    const name = column.name.toLowerCase();
+    return (name === 'id' ||
+        name === 'uuid' ||
+        name.endsWith('_id') ||
+        originalName.endsWith('Id') ||
+        name.includes('uuid') ||
+        isTenantColumn(column));
+}
+/**
+ * Check if a numeric column is a coordinate that should not be summed or averaged.
+ */
+function isCoordinateColumn(column) {
+    const name = column.name.toLowerCase();
+    return (name === 'lat' ||
+        name === 'lng' ||
+        name === 'lon' ||
+        name === 'latitude' ||
+        name === 'longitude' ||
+        name.endsWith('_lat') ||
+        name.endsWith('_lng') ||
+        name.endsWith('_lon') ||
+        name.endsWith('_latitude') ||
+        name.endsWith('_longitude'));
+}
+function isMeasureCandidate(column) {
+    return isNumericColumn(column) && !isIdentifierColumn(column) && !isCoordinateColumn(column);
+}
 /**
  * Convert table name to PascalCase for dataset variable name
  */
@@ -122,8 +154,9 @@ async function generateDatasetForTable(client, tableName) {
             dimensionLines.push(`    ${fieldName}: dimension.${dimensionType}({ column: '${column.name}', label: '${label}' }),`);
         }
     }
-    // Generate measures (for numeric columns only)
-    const numericColumns = columns.filter(isNumericColumn).filter((c) => !isTenantColumn(c));
+    // Generate measures for numeric value columns only. IDs and coordinates stay
+    // dimensions because summing or averaging them is usually noise.
+    const numericColumns = columns.filter(isMeasureCandidate);
     const measureLines = [];
     if (numericColumns.length > 0) {
         measureLines.push(`    // Count measures`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hypequery/cli",
-  "version": "1.2.0",
+  "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",
-    "@hypequery/clickhouse": "2.1.0",
-    "@hypequery/serve": "0.3.0"
+    "vitest": "^3.2.6",
+    "@hypequery/clickhouse": "2.1.2",
+    "@hypequery/serve": "0.6.0"
   },
   "repository": {
     "type": "git",