@risingwave/wavelet-sdk 0.1.0

package/dist/client.d.ts

@@ -0,0 +1,15 @@
+import type { WaveletClientOptions, ViewHandle, StreamHandle } from './types.js';
+export declare class WaveletClient {
+    private options;
+    private baseUrl;
+    private wsBaseUrl;
+    private tokenProvider;
+    constructor(options: WaveletClientOptions);
+    view<T = Record<string, unknown>>(name: string): ViewHandle<T>;
+    stream<T = Record<string, unknown>>(name: string): StreamHandle<T>;
+    private getView;
+    private subscribeView;
+    private emitEvent;
+    private emitBatch;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,UAAU,EAAE,YAAY,EAAwC,MAAM,YAAY,CAAA;AAGtH,qBAAa,aAAa;IAKZ,OAAO,CAAC,OAAO;IAJ3B,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,aAAa,CAAgC;gBAEjC,OAAO,EAAE,oBAAoB;IAmBjD,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC;IAO9D,MAAM,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAAC,CAAC,CAAC;YAOpD,OAAO;IA0BrB,OAAO,CAAC,aAAa;YAyEP,SAAS;YAkBT,SAAS;CAiBxB"}

package/dist/client.js

@@ -0,0 +1,161 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaveletClient = void 0;
+const types_js_1 = require("./types.js");
+class WaveletClient {
+    options;
+    baseUrl;
+    wsBaseUrl;
+    tokenProvider;
+    constructor(options) {
+        this.options = options;
+        // Normalize URLs
+        this.baseUrl = options.url.replace(/\/$/, '').replace(/^ws/, 'http');
+        this.wsBaseUrl = options.url.replace(/\/$/, '').replace(/^http/, 'ws');
+        if (typeof options.token === 'function') {
+            const fn = options.token;
+            this.tokenProvider = async () => {
+                const t = fn();
+                return t instanceof Promise ? t : t;
+            };
+        }
+        else if (typeof options.token === 'string') {
+            const t = options.token;
+            this.tokenProvider = async () => t;
+        }
+        else {
+            this.tokenProvider = null;
+        }
+    }
+    view(name) {
+        return {
+            get: (params) => this.getView(name, params),
+            subscribe: (handlers) => this.subscribeView(name, handlers),
+        };
+    }
+    stream(name) {
+        return {
+            emit: (data) => this.emitEvent(name, data),
+            emitBatch: (data) => this.emitBatch(name, data),
+        };
+    }
+    async getView(name, params) {
+        const url = new URL(`${this.baseUrl}/v1/views/${name}`);
+        if (params) {
+            for (const [k, v] of Object.entries(params)) {
+                url.searchParams.set(k, v);
+            }
+        }
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.tokenProvider) {
+            headers['Authorization'] = `Bearer ${await this.tokenProvider()}`;
+        }
+        const res = await fetch(url.toString(), { headers });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            if (res.status === 404)
+                throw new types_js_1.WaveletError(body.error ?? `View '${name}' not found`, 'VIEW_NOT_FOUND');
+            if (res.status === 401)
+                throw new types_js_1.WaveletError(body.error ?? 'Authentication required', 'AUTH_ERROR');
+            throw new types_js_1.WaveletError(body.error ?? `Server error: ${res.status}`, 'SERVER_ERROR');
+        }
+        const data = await res.json();
+        return data.rows;
+    }
+    subscribeView(name, handlers) {
+        let ws = null;
+        let closed = false;
+        let reconnectAttempt = 0;
+        const maxReconnectDelay = 30000;
+        let lastCursor = null;
+        const connect = async () => {
+            if (closed)
+                return;
+            let url = `${this.wsBaseUrl}/subscribe/${name}`;
+            if (this.tokenProvider) {
+                const token = await this.tokenProvider();
+                url += `?token=${encodeURIComponent(token)}`;
+            }
+            if (lastCursor) {
+                url += `${url.includes('?') ? '&' : '?'}cursor=${encodeURIComponent(lastCursor)}`;
+            }
+            ws = new WebSocket(url);
+            ws.onopen = () => {
+                reconnectAttempt = 0;
+            };
+            ws.onmessage = (event) => {
+                try {
+                    const msg = JSON.parse(typeof event.data === 'string' ? event.data : '');
+                    if (msg.type === 'diff') {
+                        lastCursor = msg.cursor;
+                        handlers.onData({
+                            cursor: msg.cursor,
+                            inserted: msg.inserted ?? [],
+                            updated: msg.updated ?? [],
+                            deleted: msg.deleted ?? [],
+                        });
+                    }
+                }
+                catch (err) {
+                    handlers.onError?.(new types_js_1.WaveletError(err.message, 'SERVER_ERROR'));
+                }
+            };
+            ws.onerror = () => {
+                // onclose will fire next
+            };
+            ws.onclose = (event) => {
+                if (closed)
+                    return;
+                if (event.code === 4000) {
+                    // Server rejected connection (auth error, view not found)
+                    handlers.onError?.(new types_js_1.WaveletError(event.reason, 'AUTH_ERROR'));
+                    return;
+                }
+                // Reconnect with exponential backoff
+                const delay = Math.min(1000 * Math.pow(2, reconnectAttempt), maxReconnectDelay);
+                reconnectAttempt++;
+                setTimeout(() => {
+                    handlers.onReconnect?.();
+                    connect();
+                }, delay);
+            };
+        };
+        connect();
+        return () => {
+            closed = true;
+            ws?.close();
+        };
+    }
+    async emitEvent(streamName, data) {
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.tokenProvider) {
+            headers['Authorization'] = `Bearer ${await this.tokenProvider()}`;
+        }
+        const res = await fetch(`${this.baseUrl}/v1/streams/${streamName}`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            throw new types_js_1.WaveletError(body.error ?? `Failed to emit to '${streamName}'`, 'SERVER_ERROR');
+        }
+    }
+    async emitBatch(streamName, data) {
+        const headers = { 'Content-Type': 'application/json' };
+        if (this.tokenProvider) {
+            headers['Authorization'] = `Bearer ${await this.tokenProvider()}`;
+        }
+        const res = await fetch(`${this.baseUrl}/v1/streams/${streamName}/batch`, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify(data),
+        });
+        if (!res.ok) {
+            const body = await res.json().catch(() => ({}));
+            throw new types_js_1.WaveletError(body.error ?? `Failed to batch emit to '${streamName}'`, 'SERVER_ERROR');
+        }
+    }
+}
+exports.WaveletClient = WaveletClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { WaveletClient } from './client.js';
+export type { WaveletClientOptions, ViewHandle, StreamHandle, Diff, Unsubscribe } from './types.js';
+//# 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":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,YAAY,EAAE,oBAAoB,EAAE,UAAU,EAAE,YAAY,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaveletClient = void 0;
+var client_js_1 = require("./client.js");
+Object.defineProperty(exports, "WaveletClient", { enumerable: true, get: function () { return client_js_1.WaveletClient; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA2C;AAAlC,0GAAA,aAAa,OAAA"}

package/dist/react.d.ts

@@ -0,0 +1,12 @@
+import { WaveletClient } from './client.js';
+import type { WaveletClientOptions } from './types.js';
+import { WaveletError } from './types.js';
+export declare function initWavelet(options: WaveletClientOptions): void;
+export declare function getClient(): WaveletClient;
+export interface UseWaveletResult<T> {
+    data: T[];
+    isLoading: boolean;
+    error: WaveletError | null;
+}
+export declare function useWavelet<T = Record<string, unknown>>(viewName: string, params?: Record<string, string>): UseWaveletResult<T>;
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAC3C,OAAO,KAAK,EAAQ,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAIzC,wBAAgB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE/D;AAED,wBAAgB,SAAS,IAAI,aAAa,CAQzC;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,IAAI,EAAE,CAAC,EAAE,CAAA;IACT,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;CAC3B;AAED,wBAAgB,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpD,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC9B,gBAAgB,CAAC,CAAC,CAAC,CAyDrB"}

package/dist/react.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initWavelet = initWavelet;
+exports.getClient = getClient;
+exports.useWavelet = useWavelet;
+const react_1 = require("react");
+const client_js_1 = require("./client.js");
+const types_js_1 = require("./types.js");
+let globalClient = null;
+function initWavelet(options) {
+    globalClient = new client_js_1.WaveletClient(options);
+}
+function getClient() {
+    if (!globalClient) {
+        throw new types_js_1.WaveletError('Wavelet client not initialized. Call initWavelet({ url: "..." }) first.', 'CONNECTION_ERROR');
+    }
+    return globalClient;
+}
+function useWavelet(viewName, params) {
+    const [data, setData] = (0, react_1.useState)([]);
+    const [isLoading, setIsLoading] = (0, react_1.useState)(true);
+    const [error, setError] = (0, react_1.useState)(null);
+    const dataRef = (0, react_1.useRef)([]);
+    (0, react_1.useEffect)(() => {
+        const client = getClient();
+        let cancelled = false;
+        // Initial fetch
+        client.view(viewName).get(params).then((rows) => {
+            if (cancelled)
+                return;
+            dataRef.current = rows;
+            setData(rows);
+            setIsLoading(false);
+        }).catch((err) => {
+            if (cancelled)
+                return;
+            setError(err instanceof types_js_1.WaveletError ? err : new types_js_1.WaveletError(err.message, 'SERVER_ERROR'));
+            setIsLoading(false);
+        });
+        // Subscribe to updates
+        const unsub = client.view(viewName).subscribe({
+            onData: (diff) => {
+                if (cancelled)
+                    return;
+                // Simple merge: this is a naive approach, replace with key-based merge in production
+                let current = [...dataRef.current];
+                // Remove deleted rows (by reference equality on all fields)
+                if (diff.deleted.length > 0) {
+                    const deletedJson = new Set(diff.deleted.map(r => JSON.stringify(r)));
+                    current = current.filter(r => !deletedJson.has(JSON.stringify(r)));
+                }
+                // Add inserted rows
+                current.push(...diff.inserted);
+                // For updates: remove old, add new (updates come as pairs)
+                current.push(...diff.updated);
+                dataRef.current = current;
+                setData(current);
+            },
+            onError: (err) => {
+                if (cancelled)
+                    return;
+                setError(err);
+            },
+        });
+        return () => {
+            cancelled = true;
+            unsub();
+        };
+    }, [viewName, JSON.stringify(params)]);
+    return { data, isLoading, error };
+}
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export interface WaveletClientOptions {
+    url: string;
+    token?: string | (() => string | Promise<string>);
+}
+export interface Diff<T = Record<string, unknown>> {
+    cursor: string;
+    inserted: T[];
+    updated: T[];
+    deleted: T[];
+}
+export interface ViewHandle<T = Record<string, unknown>> {
+    get(params?: Record<string, string>): Promise<T[]>;
+    subscribe(handlers: SubscribeHandlers<T>): Unsubscribe;
+}
+export interface StreamHandle<T = Record<string, unknown>> {
+    emit(data: T): Promise<void>;
+    emitBatch(data: T[]): Promise<void>;
+}
+export interface SubscribeHandlers<T> {
+    onData: (diff: Diff<T>) => void;
+    onError?: (error: WaveletError) => void;
+    onReconnect?: () => void;
+}
+export type Unsubscribe = () => void;
+export type WaveletErrorCode = 'AUTH_ERROR' | 'VIEW_NOT_FOUND' | 'CONNECTION_ERROR' | 'SERVER_ERROR';
+export declare class WaveletError extends Error {
+    readonly code: WaveletErrorCode;
+    constructor(message: string, code: WaveletErrorCode);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAA;CAClD;AAED,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAC/C,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,CAAC,EAAE,CAAA;IACb,OAAO,EAAE,CAAC,EAAE,CAAA;IACZ,OAAO,EAAE,CAAC,EAAE,CAAA;CACb;AAED,MAAM,WAAW,UAAU,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACrD,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAA;IAClD,SAAS,CAAC,QAAQ,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,WAAW,CAAA;CACvD;AAED,MAAM,WAAW,YAAY,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACvD,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC5B,SAAS,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAA;IAC/B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAA;IACvC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAA;CACzB;AAED,MAAM,MAAM,WAAW,GAAG,MAAM,IAAI,CAAA;AAEpC,MAAM,MAAM,gBAAgB,GAAG,YAAY,GAAG,gBAAgB,GAAG,kBAAkB,GAAG,cAAc,CAAA;AAEpG,qBAAa,YAAa,SAAQ,KAAK;aAGnB,IAAI,EAAE,gBAAgB;gBADtC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,gBAAgB;CAKzC"}

package/dist/types.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WaveletError = void 0;
+class WaveletError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = 'WaveletError';
+    }
+}
+exports.WaveletError = WaveletError;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAgCA,MAAa,YAAa,SAAQ,KAAK;IAGnB;IAFlB,YACE,OAAe,EACC,IAAsB;QAEtC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,SAAI,GAAJ,IAAI,CAAkB;QAGtC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAA;IAC5B,CAAC;CACF;AARD,oCAQC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@risingwave/wavelet-sdk",
+  "version": "0.1.0",
+  "description": "Wavelet TypeScript SDK - subscribe to computed results",
+  "homepage": "https://github.com/risingwavelabs/wavelet",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/risingwavelabs/wavelet.git",
+    "directory": "packages/sdk"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/react": "^19.2.14"
+  }
+}