@risingwave/wavelet-cli 0.1.0

package/dist/codegen.d.ts

@@ -0,0 +1,3 @@
+import type { WaveletConfig } from '@risingwave/wavelet';
+export declare function generateClient(config: WaveletConfig): Promise<void>;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAwB,MAAM,qBAAqB,CAAA;AAI9E,wBAAsB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA0CzE"}

package/dist/codegen.js

@@ -0,0 +1,146 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateClient = generateClient;
+const node_fs_1 = require("node:fs");
+const pg_1 = __importDefault(require("pg"));
+const { Client } = pg_1.default;
+async function generateClient(config) {
+    const client = new Client({ connectionString: config.database });
+    await client.connect();
+    const viewTypes = [];
+    for (const viewName of Object.keys(config.views ?? {})) {
+        try {
+            // Query column info from RisingWave
+            const result = await client.query(`SELECT column_name, data_type FROM information_schema.columns WHERE table_name = $1 ORDER BY ordinal_position`, [viewName]);
+            const columns = result.rows.map((row) => ({
+                name: row.column_name,
+                tsType: pgTypeToTs(row.data_type),
+            }));
+            viewTypes.push({ name: viewName, columns });
+        }
+        catch {
+            // If we can't query schema, generate generic types
+            viewTypes.push({ name: viewName, columns: [] });
+        }
+    }
+    const streamTypes = [];
+    for (const [streamName, streamDef] of Object.entries(config.streams ?? {})) {
+        const columns = Object.entries(streamDef.columns).map(([name, type]) => ({
+            name,
+            tsType: columnTypeToTs(type),
+        }));
+        streamTypes.push({ name: streamName, columns });
+    }
+    await client.end();
+    const code = generateCode(viewTypes, streamTypes);
+    (0, node_fs_1.mkdirSync)('.wavelet', { recursive: true });
+    (0, node_fs_1.writeFileSync)('.wavelet/client.ts', code);
+}
+function generateCode(views, streams) {
+    let code = `// Auto-generated by wavelet generate - do not edit\n`;
+    code += `// Run 'npx wavelet generate' to regenerate\n\n`;
+    code += `import { WaveletClient } from '@risingwave/wavelet-sdk'\n`;
+    code += `import type { ViewHandle, StreamHandle, Diff, WaveletClientOptions } from '@risingwave/wavelet-sdk'\n\n`;
+    // View row types
+    for (const view of views) {
+        const typeName = pascalCase(view.name) + 'Row';
+        if (view.columns.length > 0) {
+            code += `export interface ${typeName} {\n`;
+            for (const col of view.columns) {
+                code += `  ${col.name}: ${col.tsType}\n`;
+            }
+            code += `}\n\n`;
+        }
+        else {
+            code += `export type ${typeName} = Record<string, unknown>\n\n`;
+        }
+    }
+    // Stream event types
+    for (const stream of streams) {
+        const typeName = pascalCase(stream.name) + 'Event';
+        code += `export interface ${typeName} {\n`;
+        for (const col of stream.columns) {
+            code += `  ${col.name}: ${col.tsType}\n`;
+        }
+        code += `}\n\n`;
+    }
+    // Typed client class
+    code += `export class TypedWaveletClient {\n`;
+    code += `  private client: WaveletClient\n\n`;
+    code += `  constructor(options: WaveletClientOptions) {\n`;
+    code += `    this.client = new WaveletClient(options)\n`;
+    code += `  }\n\n`;
+    // View accessors
+    code += `  views = {\n`;
+    for (const view of views) {
+        const typeName = pascalCase(view.name) + 'Row';
+        code += `    ${view.name}: this.client.view<${typeName}>('${view.name}'),\n`;
+    }
+    code += `  }\n\n`;
+    // Stream accessors
+    code += `  streams = {\n`;
+    for (const stream of streams) {
+        const typeName = pascalCase(stream.name) + 'Event';
+        code += `    ${stream.name}: this.client.stream<${typeName}>('${stream.name}'),\n`;
+    }
+    code += `  }\n`;
+    code += `}\n\n`;
+    // View name literal type
+    const viewNames = views.map(v => `'${v.name}'`).join(' | ');
+    code += `export type ViewName = ${viewNames || 'never'}\n\n`;
+    // React hook overloads
+    code += `// React hook overloads for type-safe useWavelet\n`;
+    code += `import type { UseWaveletResult } from '@risingwave/wavelet-sdk/react'\n\n`;
+    for (const view of views) {
+        const typeName = pascalCase(view.name) + 'Row';
+        code += `export declare function useWavelet(view: '${view.name}'): UseWaveletResult<${typeName}>\n`;
+    }
+    return code;
+}
+function pgTypeToTs(pgType) {
+    switch (pgType.toLowerCase()) {
+        case 'integer':
+        case 'bigint':
+        case 'smallint':
+        case 'real':
+        case 'double precision':
+        case 'numeric':
+        case 'float':
+        case 'int':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'jsonb':
+        case 'json':
+            return 'unknown';
+        case 'timestamp with time zone':
+        case 'timestamp without time zone':
+        case 'timestamptz':
+            return 'string';
+        default:
+            return 'string';
+    }
+}
+function columnTypeToTs(colType) {
+    switch (colType) {
+        case 'int':
+        case 'float':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'json':
+            return 'unknown';
+        default:
+            return 'string';
+    }
+}
+function pascalCase(str) {
+    return str
+        .split(/[_\s-]+/)
+        .map(s => s.charAt(0).toUpperCase() + s.slice(1))
+        .join('');
+}
+//# sourceMappingURL=codegen.js.map

package/dist/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../src/codegen.ts"],"names":[],"mappings":"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"}

package/dist/config-loader.d.ts

@@ -0,0 +1,3 @@
+import type { WaveletConfig } from '@risingwave/wavelet';
+export declare function loadConfig(configPath: string): Promise<WaveletConfig>;
+//# sourceMappingURL=config-loader.d.ts.map

package/dist/config-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.d.ts","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAExD,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAe3E"}

package/dist/config-loader.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = loadConfig;
+const node_url_1 = require("node:url");
+const node_path_1 = require("node:path");
+async function loadConfig(configPath) {
+    const abs = (0, node_path_1.resolve)(configPath);
+    const mod = await import((0, node_url_1.pathToFileURL)(abs).href);
+    const config = mod.default ?? mod;
+    if (!config.database) {
+        throw new Error(`wavelet.config.ts must export a config with a 'database' field.\n` +
+            `Example:\n` +
+            `  import { defineConfig } from '@risingwave/wavelet'\n` +
+            `  export default defineConfig({ database: 'postgres://...' })`);
+    }
+    return config;
+}
+//# sourceMappingURL=config-loader.js.map

package/dist/config-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-loader.js","sourceRoot":"","sources":["../src/config-loader.ts"],"names":[],"mappings":";;AAIA,gCAeC;AAnBD,uCAAwC;AACxC,yCAAmC;AAG5B,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,MAAM,GAAG,GAAG,IAAA,mBAAO,EAAC,UAAU,CAAC,CAAA;IAC/B,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAA,wBAAa,EAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,IAAI,GAAG,CAAA;IAEjC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACb,mEAAmE;YACnE,YAAY;YACZ,wDAAwD;YACxD,+DAA+D,CAChE,CAAA;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,208 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const command = process.argv[2];
+const HELP = `
+wavelet - Subscribe to computed results, not raw rows.
+
+Usage:
+  wavelet <command> [options]
+
+Commands:
+  dev        Start local development server
+  generate   Generate typed client from view definitions
+  push       Sync view definitions to Wavelet server
+  status     Show current configuration and connection status
+  init       Initialize a new Wavelet project
+
+Options:
+  --config   Path to wavelet.config.ts (default: ./wavelet.config.ts)
+  --json     Output in JSON format
+  --help     Show this help message
+
+Examples:
+  wavelet init
+  wavelet dev
+  wavelet generate
+  wavelet push
+`;
+async function main() {
+    switch (command) {
+        case 'init':
+            await runInit();
+            break;
+        case 'dev':
+            await runDev();
+            break;
+        case 'generate':
+            await runGenerate();
+            break;
+        case 'push':
+            await runPush();
+            break;
+        case 'status':
+            await runStatus();
+            break;
+        case '--help':
+        case '-h':
+        case undefined:
+            console.log(HELP);
+            break;
+        default:
+            console.error(`Unknown command: '${command}'`);
+            console.error(`Run 'wavelet --help' for available commands.`);
+            process.exit(1);
+    }
+}
+async function runInit() {
+    const { writeFileSync, existsSync } = await import('node:fs');
+    if (existsSync('wavelet.config.ts')) {
+        console.log('wavelet.config.ts already exists. Skipping.');
+        return;
+    }
+    writeFileSync('wavelet.config.ts', `import { defineConfig, sql } from '@risingwave/wavelet'
+
+export default defineConfig({
+  database: process.env.WAVELET_DATABASE_URL ?? 'postgres://root@localhost:4566/dev',
+
+  streams: {
+    // Define your event streams here
+    // events: {
+    //   columns: {
+    //     user_id: 'string',
+    //     action: 'string',
+    //     value: 'int',
+    //   }
+    // }
+  },
+
+  views: {
+    // Define your materialized views here
+    // leaderboard: sql\`
+    //   SELECT user_id, SUM(value) as total
+    //   FROM events
+    //   GROUP BY user_id
+    //   ORDER BY total DESC
+    //   LIMIT 100
+    // \`,
+  },
+})
+`);
+    console.log('Created wavelet.config.ts');
+    console.log('');
+    console.log('Next steps:');
+    console.log('  1. Edit wavelet.config.ts to define your streams and views');
+    console.log('  2. Run: wavelet dev');
+}
+async function runDev() {
+    const { loadConfig } = await import('./config-loader.js');
+    const { ensureRisingWave } = await import('./risingwave-launcher.js');
+    const configPath = getConfigPath();
+    console.log(`Loading config from ${configPath}...`);
+    const config = await loadConfig(configPath);
+    // Ensure RisingWave is running
+    const rwProcess = await ensureRisingWave(config.database);
+    // Sync DDL before starting server
+    const { DdlManager, WaveletServer } = await import('@risingwave/wavelet-server');
+    const ddl = new DdlManager(config.database);
+    await ddl.connect();
+    console.log('\nSyncing streams and views...');
+    const actions = await ddl.sync(config);
+    printDdlActions(actions);
+    await ddl.close();
+    // Start server
+    const server = new WaveletServer(config);
+    await server.start();
+    const shutdown = async () => {
+        console.log('\nShutting down...');
+        await server.stop();
+        if (rwProcess) {
+            console.log('Stopping RisingWave...');
+            rwProcess.kill();
+        }
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+}
+async function runGenerate() {
+    const { loadConfig } = await import('./config-loader.js');
+    const { generateClient } = await import('./codegen.js');
+    const configPath = getConfigPath();
+    console.log(`Loading config from ${configPath}...`);
+    const config = await loadConfig(configPath);
+    await generateClient(config);
+    console.log('Generated .wavelet/client.ts');
+}
+async function runPush() {
+    const { loadConfig } = await import('./config-loader.js');
+    const configPath = getConfigPath();
+    console.log(`Loading config from ${configPath}...`);
+    const config = await loadConfig(configPath);
+    const { DdlManager } = await import('@risingwave/wavelet-server');
+    const ddl = new DdlManager(config.database);
+    await ddl.connect();
+    const actions = await ddl.sync(config);
+    await ddl.close();
+    const isJson = process.argv.includes('--json');
+    if (isJson) {
+        console.log(JSON.stringify({ actions }));
+    }
+    else {
+        printDdlActions(actions);
+    }
+}
+async function runStatus() {
+    const { loadConfig } = await import('./config-loader.js');
+    const configPath = getConfigPath();
+    try {
+        const config = await loadConfig(configPath);
+        const streamCount = Object.keys(config.streams ?? {}).length;
+        const viewCount = Object.keys(config.views ?? {}).length;
+        console.log(`Config:   ${configPath}`);
+        console.log(`Database: ${config.database.replace(/\/\/[^@]+@/, '//***@')}`);
+        console.log(`Streams:  ${streamCount}`);
+        console.log(`Views:    ${viewCount}`);
+        if (viewCount > 0) {
+            console.log('\nViews:');
+            for (const name of Object.keys(config.views ?? {})) {
+                console.log(`  - ${name}`);
+            }
+        }
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+}
+function printDdlActions(actions) {
+    const changed = actions.filter(a => a.type !== 'unchanged');
+    const unchanged = actions.filter(a => a.type === 'unchanged');
+    for (const action of actions) {
+        const icon = action.type === 'create' ? '+' : action.type === 'delete' ? '-' : ' ';
+        const label = `${action.resource} '${action.name}'`;
+        const detail = action.detail ? ` (${action.detail})` : '';
+        if (action.type === 'unchanged') {
+            console.log(`  ${icon} ${label}`);
+        }
+        else if (action.type === 'create') {
+            console.log(`  ${icon} ${label} - created${detail}`);
+        }
+        else if (action.type === 'delete') {
+            console.log(`  ${icon} ${label} - removed${detail}`);
+        }
+    }
+    console.log(`\n${changed.length} changed, ${unchanged.length} unchanged`);
+}
+function getConfigPath() {
+    const idx = process.argv.indexOf('--config');
+    if (idx !== -1 && process.argv[idx + 1]) {
+        return process.argv[idx + 1];
+    }
+    return './wavelet.config.ts';
+}
+main().catch((err) => {
+    console.error('Error:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/risingwave-launcher.d.ts

@@ -0,0 +1,3 @@
+import { type ChildProcess } from 'node:child_process';
+export declare function ensureRisingWave(connectionString: string): Promise<ChildProcess | null>;
+//# sourceMappingURL=risingwave-launcher.d.ts.map

package/dist/risingwave-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"risingwave-launcher.d.ts","sourceRoot":"","sources":["../src/risingwave-launcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKvE,wBAAsB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CA2B7F"}

package/dist/risingwave-launcher.js

@@ -0,0 +1,163 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureRisingWave = ensureRisingWave;
+const node_child_process_1 = require("node:child_process");
+const pg_1 = __importDefault(require("pg"));
+const { Client } = pg_1.default;
+async function ensureRisingWave(connectionString) {
+    // Try to connect to existing RisingWave
+    if (await isReachable(connectionString)) {
+        console.log('RisingWave is already running.');
+        return null;
+    }
+    console.log('RisingWave is not reachable. Attempting to start...');
+    // Try native binary first, then docker
+    const binary = findBinary();
+    if (binary) {
+        return startNative(binary);
+    }
+    if (hasDocker()) {
+        return startDocker();
+    }
+    console.error('Could not start RisingWave.\n\n' +
+        'Install one of:\n' +
+        '  brew tap risingwavelabs/risingwave && brew install risingwave\n' +
+        '  docker pull risingwavelabs/risingwave:latest\n\n' +
+        'Or start RisingWave manually and re-run wavelet dev.');
+    process.exit(1);
+}
+async function isReachable(connectionString) {
+    const client = new Client({ connectionString, connectionTimeoutMillis: 3000 });
+    try {
+        await client.connect();
+        await client.query('SELECT 1');
+        await client.end();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function findBinary() {
+    try {
+        const path = (0, node_child_process_1.execSync)('which risingwave', { encoding: 'utf-8' }).trim();
+        return path || null;
+    }
+    catch {
+        return null;
+    }
+}
+function hasDocker() {
+    try {
+        (0, node_child_process_1.execSync)('docker info', { stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function startNative(binaryPath) {
+    return new Promise((resolve, reject) => {
+        console.log(`Starting RisingWave (${binaryPath})...`);
+        const child = (0, node_child_process_1.spawn)(binaryPath, ['playground'], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            detached: false,
+        });
+        let started = false;
+        const onData = (data) => {
+            const text = data.toString();
+            if (!started && text.includes('ready to accept connections')) {
+                started = true;
+                console.log('RisingWave started (playground mode).');
+                resolve(child);
+            }
+        };
+        child.stdout?.on('data', onData);
+        child.stderr?.on('data', onData);
+        child.on('error', (err) => {
+            if (!started)
+                reject(err);
+        });
+        child.on('exit', (code) => {
+            if (!started)
+                reject(new Error(`RisingWave exited with code ${code}`));
+        });
+        // Fallback: poll for connectivity
+        const poll = setInterval(async () => {
+            if (started) {
+                clearInterval(poll);
+                return;
+            }
+            if (await isReachable('postgres://root@localhost:4566/dev')) {
+                started = true;
+                clearInterval(poll);
+                console.log('RisingWave started (playground mode).');
+                resolve(child);
+            }
+        }, 1000);
+        // Timeout after 30 seconds
+        setTimeout(() => {
+            if (!started) {
+                clearInterval(poll);
+                child.kill();
+                reject(new Error('RisingWave failed to start within 30 seconds.'));
+            }
+        }, 30000);
+    });
+}
+function startDocker() {
+    return new Promise((resolve, reject) => {
+        console.log('Starting RisingWave via Docker...');
+        // Remove stale container if exists
+        try {
+            (0, node_child_process_1.execSync)('docker rm -f wavelet-risingwave', { stdio: 'ignore' });
+        }
+        catch { }
+        const child = (0, node_child_process_1.spawn)('docker', [
+            'run', '--name', 'wavelet-risingwave',
+            '-p', '4566:4566',
+            'risingwavelabs/risingwave:latest',
+            'playground',
+        ], {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            detached: false,
+        });
+        let started = false;
+        // Poll for connectivity
+        const poll = setInterval(async () => {
+            if (started) {
+                clearInterval(poll);
+                return;
+            }
+            if (await isReachable('postgres://root@localhost:4566/dev')) {
+                started = true;
+                clearInterval(poll);
+                console.log('RisingWave started via Docker.');
+                resolve(child);
+            }
+        }, 1000);
+        child.on('error', (err) => {
+            if (!started) {
+                clearInterval(poll);
+                reject(err);
+            }
+        });
+        child.on('exit', (code) => {
+            if (!started) {
+                clearInterval(poll);
+                reject(new Error(`Docker exited with code ${code}`));
+            }
+        });
+        setTimeout(() => {
+            if (!started) {
+                clearInterval(poll);
+                child.kill();
+                reject(new Error('RisingWave Docker container failed to start within 60 seconds.'));
+            }
+        }, 60000);
+    });
+}
+//# sourceMappingURL=risingwave-launcher.js.map

package/dist/risingwave-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"risingwave-launcher.js","sourceRoot":"","sources":["../src/risingwave-launcher.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@risingwave/wavelet-cli",
+  "version": "0.1.0",
+  "description": "Wavelet CLI - manage views, generate types, run dev server",
+  "bin": {
+    "wavelet": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts"
+  },
+  "dependencies": {
+    "@risingwave/wavelet": "0.1.0",
+    "@risingwave/wavelet-server": "0.1.0",
+    "pg": "^8.13.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "typescript": "^5.7.0",
+    "@types/pg": "^8.11.0"
+  },
+  "license": "Apache-2.0"
+}

package/src/codegen.ts

@@ -0,0 +1,167 @@
+import { writeFileSync, mkdirSync } from 'node:fs'
+import pg from 'pg'
+import type { WaveletConfig, SqlFragment, ViewDef } from '@risingwave/wavelet'
+
+const { Client } = pg
+
+export async function generateClient(config: WaveletConfig): Promise<void> {
+  const client = new Client({ connectionString: config.database })
+  await client.connect()
+
+  const viewTypes: { name: string; columns: { name: string; tsType: string }[] }[] = []
+
+  for (const viewName of Object.keys(config.views ?? {})) {
+    try {
+      // Query column info from RisingWave
+      const result = await client.query(
+        `SELECT column_name, data_type FROM information_schema.columns WHERE table_name = $1 ORDER BY ordinal_position`,
+        [viewName]
+      )
+
+      const columns = result.rows.map((row: any) => ({
+        name: row.column_name,
+        tsType: pgTypeToTs(row.data_type),
+      }))
+
+      viewTypes.push({ name: viewName, columns })
+    } catch {
+      // If we can't query schema, generate generic types
+      viewTypes.push({ name: viewName, columns: [] })
+    }
+  }
+
+  const streamTypes: { name: string; columns: { name: string; tsType: string }[] }[] = []
+
+  for (const [streamName, streamDef] of Object.entries(config.streams ?? {})) {
+    const columns = Object.entries(streamDef.columns).map(([name, type]) => ({
+      name,
+      tsType: columnTypeToTs(type),
+    }))
+    streamTypes.push({ name: streamName, columns })
+  }
+
+  await client.end()
+
+  const code = generateCode(viewTypes, streamTypes)
+
+  mkdirSync('.wavelet', { recursive: true })
+  writeFileSync('.wavelet/client.ts', code)
+}
+
+function generateCode(
+  views: { name: string; columns: { name: string; tsType: string }[] }[],
+  streams: { name: string; columns: { name: string; tsType: string }[] }[]
+): string {
+  let code = `// Auto-generated by wavelet generate - do not edit\n`
+  code += `// Run 'npx wavelet generate' to regenerate\n\n`
+  code += `import { WaveletClient } from '@risingwave/wavelet-sdk'\n`
+  code += `import type { ViewHandle, StreamHandle, Diff, WaveletClientOptions } from '@risingwave/wavelet-sdk'\n\n`
+
+  // View row types
+  for (const view of views) {
+    const typeName = pascalCase(view.name) + 'Row'
+    if (view.columns.length > 0) {
+      code += `export interface ${typeName} {\n`
+      for (const col of view.columns) {
+        code += `  ${col.name}: ${col.tsType}\n`
+      }
+      code += `}\n\n`
+    } else {
+      code += `export type ${typeName} = Record<string, unknown>\n\n`
+    }
+  }
+
+  // Stream event types
+  for (const stream of streams) {
+    const typeName = pascalCase(stream.name) + 'Event'
+    code += `export interface ${typeName} {\n`
+    for (const col of stream.columns) {
+      code += `  ${col.name}: ${col.tsType}\n`
+    }
+    code += `}\n\n`
+  }
+
+  // Typed client class
+  code += `export class TypedWaveletClient {\n`
+  code += `  private client: WaveletClient\n\n`
+  code += `  constructor(options: WaveletClientOptions) {\n`
+  code += `    this.client = new WaveletClient(options)\n`
+  code += `  }\n\n`
+
+  // View accessors
+  code += `  views = {\n`
+  for (const view of views) {
+    const typeName = pascalCase(view.name) + 'Row'
+    code += `    ${view.name}: this.client.view<${typeName}>('${view.name}'),\n`
+  }
+  code += `  }\n\n`
+
+  // Stream accessors
+  code += `  streams = {\n`
+  for (const stream of streams) {
+    const typeName = pascalCase(stream.name) + 'Event'
+    code += `    ${stream.name}: this.client.stream<${typeName}>('${stream.name}'),\n`
+  }
+  code += `  }\n`
+  code += `}\n\n`
+
+  // View name literal type
+  const viewNames = views.map(v => `'${v.name}'`).join(' | ')
+  code += `export type ViewName = ${viewNames || 'never'}\n\n`
+
+  // React hook overloads
+  code += `// React hook overloads for type-safe useWavelet\n`
+  code += `import type { UseWaveletResult } from '@risingwave/wavelet-sdk/react'\n\n`
+  for (const view of views) {
+    const typeName = pascalCase(view.name) + 'Row'
+    code += `export declare function useWavelet(view: '${view.name}'): UseWaveletResult<${typeName}>\n`
+  }
+
+  return code
+}
+
+function pgTypeToTs(pgType: string): string {
+  switch (pgType.toLowerCase()) {
+    case 'integer':
+    case 'bigint':
+    case 'smallint':
+    case 'real':
+    case 'double precision':
+    case 'numeric':
+    case 'float':
+    case 'int':
+      return 'number'
+    case 'boolean':
+      return 'boolean'
+    case 'jsonb':
+    case 'json':
+      return 'unknown'
+    case 'timestamp with time zone':
+    case 'timestamp without time zone':
+    case 'timestamptz':
+      return 'string'
+    default:
+      return 'string'
+  }
+}
+
+function columnTypeToTs(colType: string): string {
+  switch (colType) {
+    case 'int':
+    case 'float':
+      return 'number'
+    case 'boolean':
+      return 'boolean'
+    case 'json':
+      return 'unknown'
+    default:
+      return 'string'
+  }
+}
+
+function pascalCase(str: string): string {
+  return str
+    .split(/[_\s-]+/)
+    .map(s => s.charAt(0).toUpperCase() + s.slice(1))
+    .join('')
+}

package/src/config-loader.ts

@@ -0,0 +1,20 @@
+import { pathToFileURL } from 'node:url'
+import { resolve } from 'node:path'
+import type { WaveletConfig } from '@risingwave/wavelet'
+
+export async function loadConfig(configPath: string): Promise<WaveletConfig> {
+  const abs = resolve(configPath)
+  const mod = await import(pathToFileURL(abs).href)
+  const config = mod.default ?? mod
+
+  if (!config.database) {
+    throw new Error(
+      `wavelet.config.ts must export a config with a 'database' field.\n` +
+      `Example:\n` +
+      `  import { defineConfig } from '@risingwave/wavelet'\n` +
+      `  export default defineConfig({ database: 'postgres://...' })`
+    )
+  }
+
+  return config
+}

package/src/index.ts

@@ -0,0 +1,233 @@
+#!/usr/bin/env node
+
+const command = process.argv[2]
+
+const HELP = `
+wavelet - Subscribe to computed results, not raw rows.
+
+Usage:
+  wavelet <command> [options]
+
+Commands:
+  dev        Start local development server
+  generate   Generate typed client from view definitions
+  push       Sync view definitions to Wavelet server
+  status     Show current configuration and connection status
+  init       Initialize a new Wavelet project
+
+Options:
+  --config   Path to wavelet.config.ts (default: ./wavelet.config.ts)
+  --json     Output in JSON format
+  --help     Show this help message
+
+Examples:
+  wavelet init
+  wavelet dev
+  wavelet generate
+  wavelet push
+`
+
+async function main() {
+  switch (command) {
+    case 'init':
+      await runInit()
+      break
+    case 'dev':
+      await runDev()
+      break
+    case 'generate':
+      await runGenerate()
+      break
+    case 'push':
+      await runPush()
+      break
+    case 'status':
+      await runStatus()
+      break
+    case '--help':
+    case '-h':
+    case undefined:
+      console.log(HELP)
+      break
+    default:
+      console.error(`Unknown command: '${command}'`)
+      console.error(`Run 'wavelet --help' for available commands.`)
+      process.exit(1)
+  }
+}
+
+async function runInit() {
+  const { writeFileSync, existsSync } = await import('node:fs')
+
+  if (existsSync('wavelet.config.ts')) {
+    console.log('wavelet.config.ts already exists. Skipping.')
+    return
+  }
+
+  writeFileSync('wavelet.config.ts', `import { defineConfig, sql } from '@risingwave/wavelet'
+
+export default defineConfig({
+  database: process.env.WAVELET_DATABASE_URL ?? 'postgres://root@localhost:4566/dev',
+
+  streams: {
+    // Define your event streams here
+    // events: {
+    //   columns: {
+    //     user_id: 'string',
+    //     action: 'string',
+    //     value: 'int',
+    //   }
+    // }
+  },
+
+  views: {
+    // Define your materialized views here
+    // leaderboard: sql\`
+    //   SELECT user_id, SUM(value) as total
+    //   FROM events
+    //   GROUP BY user_id
+    //   ORDER BY total DESC
+    //   LIMIT 100
+    // \`,
+  },
+})
+`)
+
+  console.log('Created wavelet.config.ts')
+  console.log('')
+  console.log('Next steps:')
+  console.log('  1. Edit wavelet.config.ts to define your streams and views')
+  console.log('  2. Run: wavelet dev')
+}
+
+async function runDev() {
+  const { loadConfig } = await import('./config-loader.js')
+  const { ensureRisingWave } = await import('./risingwave-launcher.js')
+  const configPath = getConfigPath()
+
+  console.log(`Loading config from ${configPath}...`)
+  const config = await loadConfig(configPath)
+
+  // Ensure RisingWave is running
+  const rwProcess = await ensureRisingWave(config.database)
+
+  // Sync DDL before starting server
+  const { DdlManager, WaveletServer } = await import('@risingwave/wavelet-server')
+  const ddl = new DdlManager(config.database)
+  await ddl.connect()
+
+  console.log('\nSyncing streams and views...')
+  const actions = await ddl.sync(config)
+  printDdlActions(actions)
+  await ddl.close()
+
+  // Start server
+  const server = new WaveletServer(config)
+  await server.start()
+
+  const shutdown = async () => {
+    console.log('\nShutting down...')
+    await server.stop()
+    if (rwProcess) {
+      console.log('Stopping RisingWave...')
+      rwProcess.kill()
+    }
+    process.exit(0)
+  }
+  process.on('SIGINT', shutdown)
+  process.on('SIGTERM', shutdown)
+}
+
+async function runGenerate() {
+  const { loadConfig } = await import('./config-loader.js')
+  const { generateClient } = await import('./codegen.js')
+  const configPath = getConfigPath()
+
+  console.log(`Loading config from ${configPath}...`)
+  const config = await loadConfig(configPath)
+
+  await generateClient(config)
+  console.log('Generated .wavelet/client.ts')
+}
+
+async function runPush() {
+  const { loadConfig } = await import('./config-loader.js')
+  const configPath = getConfigPath()
+
+  console.log(`Loading config from ${configPath}...`)
+  const config = await loadConfig(configPath)
+
+  const { DdlManager } = await import('@risingwave/wavelet-server')
+  const ddl = new DdlManager(config.database)
+  await ddl.connect()
+
+  const actions = await ddl.sync(config)
+  await ddl.close()
+
+  const isJson = process.argv.includes('--json')
+  if (isJson) {
+    console.log(JSON.stringify({ actions }))
+  } else {
+    printDdlActions(actions)
+  }
+}
+
+async function runStatus() {
+  const { loadConfig } = await import('./config-loader.js')
+  const configPath = getConfigPath()
+
+  try {
+    const config = await loadConfig(configPath)
+    const streamCount = Object.keys(config.streams ?? {}).length
+    const viewCount = Object.keys(config.views ?? {}).length
+
+    console.log(`Config:   ${configPath}`)
+    console.log(`Database: ${config.database.replace(/\/\/[^@]+@/, '//***@')}`)
+    console.log(`Streams:  ${streamCount}`)
+    console.log(`Views:    ${viewCount}`)
+
+    if (viewCount > 0) {
+      console.log('\nViews:')
+      for (const name of Object.keys(config.views ?? {})) {
+        console.log(`  - ${name}`)
+      }
+    }
+  } catch (err: any) {
+    console.error(`Error: ${err.message}`)
+    process.exit(1)
+  }
+}
+
+function printDdlActions(actions: { type: string; resource: string; name: string; detail?: string }[]): void {
+  const changed = actions.filter(a => a.type !== 'unchanged')
+  const unchanged = actions.filter(a => a.type === 'unchanged')
+
+  for (const action of actions) {
+    const icon = action.type === 'create' ? '+' : action.type === 'delete' ? '-' : ' '
+    const label = `${action.resource} '${action.name}'`
+    const detail = action.detail ? ` (${action.detail})` : ''
+
+    if (action.type === 'unchanged') {
+      console.log(`  ${icon} ${label}`)
+    } else if (action.type === 'create') {
+      console.log(`  ${icon} ${label} - created${detail}`)
+    } else if (action.type === 'delete') {
+      console.log(`  ${icon} ${label} - removed${detail}`)
+    }
+  }
+
+  console.log(`\n${changed.length} changed, ${unchanged.length} unchanged`)
+}
+
+function getConfigPath(): string {
+  const idx = process.argv.indexOf('--config')
+  if (idx !== -1 && process.argv[idx + 1]) {
+    return process.argv[idx + 1]
+  }
+  return './wavelet.config.ts'
+}
+
+main().catch((err) => {
+  console.error('Error:', err.message)
+  process.exit(1)
+})

package/src/risingwave-launcher.ts

@@ -0,0 +1,177 @@
+import { execSync, spawn, type ChildProcess } from 'node:child_process'
+import pg from 'pg'
+
+const { Client } = pg
+
+export async function ensureRisingWave(connectionString: string): Promise<ChildProcess | null> {
+  // Try to connect to existing RisingWave
+  if (await isReachable(connectionString)) {
+    console.log('RisingWave is already running.')
+    return null
+  }
+
+  console.log('RisingWave is not reachable. Attempting to start...')
+
+  // Try native binary first, then docker
+  const binary = findBinary()
+  if (binary) {
+    return startNative(binary)
+  }
+
+  if (hasDocker()) {
+    return startDocker()
+  }
+
+  console.error(
+    'Could not start RisingWave.\n\n' +
+    'Install one of:\n' +
+    '  brew tap risingwavelabs/risingwave && brew install risingwave\n' +
+    '  docker pull risingwavelabs/risingwave:latest\n\n' +
+    'Or start RisingWave manually and re-run wavelet dev.'
+  )
+  process.exit(1)
+}
+
+async function isReachable(connectionString: string): Promise<boolean> {
+  const client = new Client({ connectionString, connectionTimeoutMillis: 3000 })
+  try {
+    await client.connect()
+    await client.query('SELECT 1')
+    await client.end()
+    return true
+  } catch {
+    return false
+  }
+}
+
+function findBinary(): string | null {
+  try {
+    const path = execSync('which risingwave', { encoding: 'utf-8' }).trim()
+    return path || null
+  } catch {
+    return null
+  }
+}
+
+function hasDocker(): boolean {
+  try {
+    execSync('docker info', { stdio: 'ignore' })
+    return true
+  } catch {
+    return false
+  }
+}
+
+function startNative(binaryPath: string): Promise<ChildProcess> {
+  return new Promise((resolve, reject) => {
+    console.log(`Starting RisingWave (${binaryPath})...`)
+    const child = spawn(binaryPath, ['playground'], {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      detached: false,
+    })
+
+    let started = false
+
+    const onData = (data: Buffer) => {
+      const text = data.toString()
+      if (!started && text.includes('ready to accept connections')) {
+        started = true
+        console.log('RisingWave started (playground mode).')
+        resolve(child)
+      }
+    }
+
+    child.stdout?.on('data', onData)
+    child.stderr?.on('data', onData)
+
+    child.on('error', (err) => {
+      if (!started) reject(err)
+    })
+
+    child.on('exit', (code) => {
+      if (!started) reject(new Error(`RisingWave exited with code ${code}`))
+    })
+
+    // Fallback: poll for connectivity
+    const poll = setInterval(async () => {
+      if (started) {
+        clearInterval(poll)
+        return
+      }
+      if (await isReachable('postgres://root@localhost:4566/dev')) {
+        started = true
+        clearInterval(poll)
+        console.log('RisingWave started (playground mode).')
+        resolve(child)
+      }
+    }, 1000)
+
+    // Timeout after 30 seconds
+    setTimeout(() => {
+      if (!started) {
+        clearInterval(poll)
+        child.kill()
+        reject(new Error('RisingWave failed to start within 30 seconds.'))
+      }
+    }, 30000)
+  })
+}
+
+function startDocker(): Promise<ChildProcess> {
+  return new Promise((resolve, reject) => {
+    console.log('Starting RisingWave via Docker...')
+
+    // Remove stale container if exists
+    try {
+      execSync('docker rm -f wavelet-risingwave', { stdio: 'ignore' })
+    } catch {}
+
+    const child = spawn('docker', [
+      'run', '--name', 'wavelet-risingwave',
+      '-p', '4566:4566',
+      'risingwavelabs/risingwave:latest',
+      'playground',
+    ], {
+      stdio: ['ignore', 'pipe', 'pipe'],
+      detached: false,
+    })
+
+    let started = false
+
+    // Poll for connectivity
+    const poll = setInterval(async () => {
+      if (started) {
+        clearInterval(poll)
+        return
+      }
+      if (await isReachable('postgres://root@localhost:4566/dev')) {
+        started = true
+        clearInterval(poll)
+        console.log('RisingWave started via Docker.')
+        resolve(child)
+      }
+    }, 1000)
+
+    child.on('error', (err) => {
+      if (!started) {
+        clearInterval(poll)
+        reject(err)
+      }
+    })
+
+    child.on('exit', (code) => {
+      if (!started) {
+        clearInterval(poll)
+        reject(new Error(`Docker exited with code ${code}`))
+      }
+    })
+
+    setTimeout(() => {
+      if (!started) {
+        clearInterval(poll)
+        child.kill()
+        reject(new Error('RisingWave Docker container failed to start within 60 seconds.'))
+      }
+    }, 60000)
+  })
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src"]
+}