lowlander 0.2.1 → 0.2.2

package/build/client/client.js

@@ -0,0 +1,317 @@
+import A from 'aberdeen';
+import DataPack from 'edinburgh/datapack';
+import { SERVER_MESSAGES, CLIENT_MESSAGES } from '../server/protocol.js';
+/** Set to 1-3 for increasing verbosity. */
+export let logLevel = 0;
+// Sentinel key in commitIds entries: on initial creation, only DEFAULT_COMMIT is set
+// (applies to all keys). Per-key entries are added on subsequent updates and take
+// precedence. On deletion, DEFAULT_COMMIT guards against stale re-creates.
+const DEFAULT_COMMIT = Symbol();
+/**
+ * WebSocket connection to a Lowlander server with type-safe RPC, automatic reconnection,
+ * and reactive updates.
+ *
+ * @typeParam T - The server-side API type (import from your server API file)
+ *
+ * @example
+ * ```ts
+ * import type * as API from './server/api.js';
+ * const conn = new Connection<typeof API>('ws://localhost:8080/');
+ *
+ * // Simple RPC - returns PromiseProxy
+ * const sum = conn.api.add(1, 2);
+ *
+ * // Server proxy for stateful APIs
+ * const auth = conn.api.authenticate('token');
+ * const secret = auth.serverProxy.getSecret();
+ *
+ * // Streaming with callbacks
+ * conn.api.streamData(data => console.log(data));
+ *
+ * // Use within Aberdeen reactive scopes
+ * $(() => {
+ *   dump(conn.isOnline());
+ *   dump(sum);
+ * });
+ * ```
+ */
+export class Connection {
+    url;
+    ws;
+    activeRequests = new Map();
+    requestCounter = 0;
+    reconnectAttempts = 0;
+    /** @internal */
+    _proxyCounter = 0;
+    onlineProxy = A.proxy(false);
+    /**
+     * Type-safe proxy to the server-side API. Methods return `PromiseProxy` objects
+     * that work reactively in Aberdeen scopes. `ServerProxy` returns include a
+     * `.serverProxy` property for accessing stateful server APIs.
+     */
+    api;
+    /**
+     * @param url - WebSocket URL (e.g., 'ws://localhost:8080/'), or a fake WebSocket object for testing
+     */
+    constructor(url) {
+        this.url = url;
+        this.api = new Proxy({ connection: this, requestId: undefined }, proxyHandlers);
+        this.connect();
+    }
+    /**
+     * Returns the current connection status. Reactive in Aberdeen scopes.
+     */
+    isOnline() { return this.onlineProxy.value; }
+    connect() {
+        const ws = this.ws = typeof this.url === 'string'
+            ? new WebSocket(this.url)
+            : this.url();
+        ws.binaryType = "arraybuffer";
+        if (logLevel >= 1)
+            console.log(`[lowlander] Connecting to WebSocket at ${typeof this.url === 'string' ? this.url : '[custom WebSocket]'}`);
+        ws.onopen = () => {
+            if (ws !== this.ws)
+                return; // No longer the current connection
+            if (logLevel >= 1)
+                console.log('[lowlander] WebSocket connected');
+            this.onlineProxy.value = true;
+            this.reconnectAttempts = 0;
+            for (const request of this.activeRequests.values()) {
+                request.resultProxy.busy = true;
+                this.ws.send(request.requestBuffer);
+            }
+        };
+        ws.onclose = () => {
+            if (ws !== this.ws)
+                return; // No longer the current connection
+            if (logLevel >= 1)
+                console.log('[lowlander] WebSocket disconnected');
+            this.reconnect();
+        };
+        ws.onerror = (error) => {
+            if (ws !== this.ws)
+                return; // No longer the current connection
+            console.error('WebSocket error:', error);
+            this.reconnect();
+        };
+        ws.onmessage = (event) => {
+            if (ws !== this.ws)
+                return; // No longer the current connection
+            const pack = new DataPack(new Uint8Array(event.data));
+            // console.log(`onmessage: ${pack}`);
+            const requestId = pack.readPositiveInt();
+            const request = this.activeRequests.get(requestId);
+            if (!request)
+                return; // Raced
+            const result = A.unproxy(request.resultProxy);
+            const type = pack.read();
+            if (typeof type === 'number') {
+                // It's a callback invocation
+                const callback = request.callbacks?.[type];
+                const args = [];
+                while (pack.readAvailable()) {
+                    args.push(pack.read());
+                }
+                callback(...args);
+                return;
+            }
+            // This packet type does not represent the result for a request
+            if (type === SERVER_MESSAGES.model_data) {
+                request.database ||= new Map();
+                request.commitIds ||= new Map();
+                const dbKeyHash = pack.readNumber();
+                const commitId = pack.readNumber();
+                const delta = pack.read({ model: function (linkHash) {
+                        const linkedModel = request.database.get(linkHash);
+                        if (!linkedModel)
+                            console.error('Unknown linked model hash ' + linkHash);
+                        return linkedModel;
+                    } });
+                if (logLevel >= 3)
+                    console.log('[lowlander] incoming model_data', requestId, dbKeyHash, commitId, delta);
+                // Schedule cleanup: after 15s, all out-of-order messages for this commitId
+                // must have arrived, so we can prune tracking entries at or below it.
+                setTimeout(() => this.pruneCommitIds(request, commitId), 15000);
+                let prevCommitIds = request.commitIds.get(dbKeyHash);
+                if (!delta) {
+                    // Stale delete: some key was already updated past this commitId
+                    if (prevCommitIds && commitId < Math.max(...prevCommitIds.values()))
+                        return;
+                    request.database.delete(dbKeyHash);
+                    // Record delete's commitId so stale creates arriving later are rejected
+                    request.commitIds.set(dbKeyHash, new Map([[DEFAULT_COMMIT, commitId]]));
+                    return;
+                }
+                let org = request.database.get(dbKeyHash);
+                if (org) {
+                    // Update existing object
+                    if (!prevCommitIds) {
+                        prevCommitIds = new Map();
+                        request.commitIds.set(dbKeyHash, prevCommitIds);
+                    }
+                    for (const key of Object.keys(delta)) {
+                        if (commitId < (prevCommitIds.get(key) ?? prevCommitIds.get(DEFAULT_COMMIT) ?? -1))
+                            continue;
+                        if (delta[key] && typeof delta[key] === 'object') {
+                            A.copy(org, key, delta[key]);
+                        }
+                        else {
+                            org[key] = delta[key];
+                        }
+                        prevCommitIds.set(key, commitId);
+                    }
+                }
+                else {
+                    // Create new object
+                    if (prevCommitIds && commitId < (prevCommitIds.get(DEFAULT_COMMIT) ?? -1))
+                        return; // Stale create
+                    request.database.set(dbKeyHash, A.proxy(delta));
+                    request.commitIds.set(dbKeyHash, new Map([[DEFAULT_COMMIT, commitId]]));
+                }
+                return;
+            }
+            // Each request should get one of these packet types as a response
+            if (type === SERVER_MESSAGES.error) {
+                const errorMessage = pack.readString();
+                request.resultProxy.error = new Error(errorMessage);
+                if (logLevel >= 2)
+                    console.log(`[lowlander] incoming error requestId=${requestId} message=${errorMessage}`);
+            }
+            else if (type === SERVER_MESSAGES.response || type === SERVER_MESSAGES.response_proxy) {
+                request.resultProxy.value = pack.read();
+                request.virtualSocketIds = pack.read();
+                request.hasServerProxy = type === SERVER_MESSAGES.response_proxy;
+                if (logLevel >= 2)
+                    console.log(`[lowlander] incoming response requestId=${requestId} value=${result.value} virtualSocketIds=${request.virtualSocketIds} hasServerProxy=${request.hasServerProxy}`);
+            }
+            else if (type === SERVER_MESSAGES.response_model) {
+                request.virtualSocketIds = pack.read(); // There must be at least one, for the model stream
+                const dbKey = pack.readNumber();
+                const obj = request.database?.get(dbKey);
+                if (logLevel >= 2)
+                    console.log(`[lowlander] incoming response_model requestId=${requestId} dbKey=${dbKey} obj=${obj}`);
+                if (obj) {
+                    request.resultProxy.value = A.proxy(obj);
+                }
+                else {
+                    request.resultProxy.error = new Error('Unknown database key ' + dbKey);
+                }
+            }
+            else {
+                throw new Error('Unknown message type ' + type);
+            }
+            // Common cleanup for all response types
+            if (!request.hasServerProxy && !request.virtualSocketIds?.length) {
+                this.activeRequests.delete(requestId);
+            }
+            if (!request.hasServerProxy) {
+                delete request.resultProxy.serverProxy;
+            }
+            request.resultProxy.busy = false;
+            if (request.resolve) {
+                // This does not happen on reconnect
+                if (result.error != null) {
+                    console.error(result.error);
+                    request.reject(result.error);
+                }
+                else {
+                    request.resolve(result.value);
+                }
+                delete request.resolve;
+                delete request.reject;
+            }
+        };
+    }
+    reconnect() {
+        this.ws = undefined;
+        this.onlineProxy.value = false;
+        if (typeof this.url !== 'string')
+            return; // No reconnect in test mode
+        // Reconnect with exponential backoff
+        const delay = Math.min(500 * Math.pow(2, this.reconnectAttempts), 20000);
+        this.reconnectAttempts++;
+        if (logLevel >= 1)
+            console.log(`[lowlander] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
+        setTimeout(this.connect.bind(this), delay);
+    }
+    pruneCommitIds(request, maxCommitId) {
+        if (!request.commitIds)
+            return;
+        for (const [hash, entry] of request.commitIds) {
+            for (const [key, cid] of entry) {
+                if (cid <= maxCommitId)
+                    entry.delete(key);
+            }
+            if (!entry.size)
+                request.commitIds.delete(hash);
+        }
+    }
+    /** @internal */
+    _createMethodStub(methodName, proxyId) {
+        return (...params) => {
+            const result = { busy: true };
+            const resultProxy = A.proxy(result);
+            const requestId = ++this.requestCounter;
+            const pack = new DataPack();
+            pack.write(requestId).write(CLIENT_MESSAGES.call).write(proxyId).write(methodName);
+            let callbacks;
+            pack.writeCollection("array", () => {
+                for (const param of params) {
+                    if (typeof param === 'function') {
+                        callbacks ||= [];
+                        pack.writeCustom('cb', callbacks.length);
+                        callbacks.push(param);
+                    }
+                    else {
+                        pack.write(param);
+                    }
+                }
+            });
+            const request = { resultProxy, requestBuffer: pack.toUint8Array(true), requestId, connection: this, callbacks };
+            result.serverProxy = new Proxy(request, proxyHandlers);
+            result.promise = new Promise((resolve, reject) => {
+                request.resolve = resolve;
+                request.reject = reject;
+            });
+            this.activeRequests.set(requestId, request);
+            if (logLevel >= 2)
+                console.log(`[lowlander] outgoing call requestId=${requestId} method=${methodName} params=`, params);
+            if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+                this.ws.send(request.requestBuffer);
+            }
+            A.clean(() => {
+                this.activeRequests.delete(requestId);
+                if (request.virtualSocketIds?.length || request.hasServerProxy) {
+                    if (logLevel >= 2)
+                        console.log(`[lowlander] outgoing cancel requestId=${request.requestId} virtualSocketIds=${request.virtualSocketIds} hasServerProxy=${request.hasServerProxy}`);
+                    const data = DataPack.createUint8Array(++this.requestCounter, CLIENT_MESSAGES.cancel, request.requestId, request.virtualSocketIds);
+                    this.ws?.send(data);
+                }
+            });
+            return resultProxy;
+        };
+    }
+}
+const proxyHandlers = {
+    get(target, prop) {
+        if (target.serverProxyCache?.has(prop)) {
+            return target.serverProxyCache.get(prop);
+        }
+        if (prop === 'then' || prop === 'catch' || prop === 'finally') {
+            // When someone awaits the proxy, we should not treat it as a remote method call
+            return undefined;
+        }
+        if (prop === 'constructor') {
+            return { name: 'ServerProxy-' + target.requestId };
+        }
+        const result = target.connection._createMethodStub(prop, target.requestId);
+        if (!target.serverProxyCache)
+            target.serverProxyCache = new Map();
+        target.serverProxyCache.set(prop, result);
+        return result;
+    },
+    has(_target, prop) {
+        return typeof prop === 'string' || prop === A.NO_COPY;
+    }
+};
+//# sourceMappingURL=client.js.map

package/build/client/client.js.map

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

package/build/examples/helloworld/client/js/admin.d.ts

@@ -0,0 +1,11 @@
+import 'mdui/mdui.css';
+import 'mdui/components/button.js';
+import 'mdui/components/dialog.js';
+import 'mdui/components/tabs.js';
+import 'mdui/components/tab.js';
+import 'mdui/components/tab-panel.js';
+import { ClientProxyObject } from 'lowlander/client';
+import type * as ServerAPI from '../../server/api.js';
+type API = ClientProxyObject<typeof ServerAPI>;
+export declare function showAdminModal(api: API): void;
+export {};

package/build/examples/helloworld/client/js/admin.js

@@ -0,0 +1,87 @@
+import 'mdui/mdui.css';
+import 'mdui/components/button.js';
+import 'mdui/components/dialog.js';
+import 'mdui/components/tabs.js';
+import 'mdui/components/tab.js';
+import 'mdui/components/tab-panel.js';
+import A from "aberdeen";
+const TOPICS = ['sockets', 'channels', 'workers', 'kv'];
+function formatDecodedBytes(value) {
+    let text = '';
+    for (const byte of value) {
+        const codePoint = byte;
+        const char = String.fromCodePoint(codePoint);
+        const printableAscii = codePoint >= 0x20 && codePoint <= 0x7e;
+        const whitespace = codePoint === 0x09 || codePoint === 0x0a || codePoint === 0x0d;
+        text += printableAscii || whitespace ? char : `<${codePoint}>`;
+    }
+    return text;
+}
+const tableStyle = A.insertCss({
+    '&': 'border-collapse:collapse text-align:left box-shadow: 0 0 20px rgba(0, 0, 0, 0.15);',
+    'tr:nth-child(even)': 'background-color:#0002;',
+    'td,th': 'padding: $1 $2; border-left: 1px solid #0002;',
+    'td:first-child,th:first-child': 'border-left:none',
+});
+export function showAdminModal(api) {
+    const refreshes = A.proxy(0);
+    const closed = A.proxy(false);
+    A.mount(document.body, () => {
+        if (A.peek(closed, 'value') || closed.value)
+            return;
+        A('mdui-dialog open= close-on-overlay-click= close-on-esc= headline="Lowlander Admin panel" closed=', () => closed.value = true, () => {
+            A('span slot=description mdui-tabs value=', TOPICS[0], () => {
+                for (const topic of TOPICS) {
+                    A('mdui-tab value=', topic, 'text=', topic);
+                }
+                for (const topic of TOPICS) {
+                    A('mdui-tab-panel slot=panel value=', topic, () => {
+                        const sockets = api.getDebugState(topic);
+                        refreshes.value;
+                        A(() => {
+                            const data = A.unproxy(sockets.value);
+                            if (!data)
+                                return;
+                            const keySet = new Set();
+                            for (const [, obj] of Object.entries(data)) {
+                                if (obj && typeof obj === 'object' && !(obj instanceof Uint8Array))
+                                    for (const k of Object.keys(obj))
+                                        keySet.add(k);
+                            }
+                            const cols = [...keySet];
+                            A('table', tableStyle, () => {
+                                A('tr', () => {
+                                    A('th text=#');
+                                    for (const k of cols)
+                                        A('th text=', k);
+                                });
+                                for (const [idx, obj] of Object.entries(data)) {
+                                    A('tr', () => {
+                                        A('td text=', idx);
+                                        for (const k of cols) {
+                                            const value = obj?.[k];
+                                            let text = '';
+                                            if (value instanceof Uint8Array) {
+                                                text = formatDecodedBytes(value);
+                                            }
+                                            else if (value !== null && value !== undefined) {
+                                                text = typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean'
+                                                    ? String(value)
+                                                    : JSON.stringify(value);
+                                            }
+                                            A('td text=', text);
+                                        }
+                                    });
+                                }
+                            });
+                        });
+                    });
+                }
+            });
+            const dialog = A();
+            A('mdui-button slot=action variant=text text=Update click=', () => refreshes.value++);
+            A('mdui-button slot=action variant=text text=Close click=', () => dialog.open = false);
+        });
+    });
+}
+//# sourceMappingURL=admin.js.map

package/build/examples/helloworld/client/js/admin.js.map

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

package/build/examples/helloworld/client/js/base.d.ts

@@ -0,0 +1,4 @@
+import 'mdui/mdui.css';
+import 'mdui/components/button.js';
+import 'mdui/components/fab.js';
+import 'mdui/components/text-field.js';

package/{examples/helloworld/client/js/base.ts → build/examples/helloworld/client/js/base.js}

@@ -3,81 +3,69 @@ import 'mdui/components/button.js';
 import 'mdui/components/fab.js';
 import 'mdui/components/text-field.js';
 import { alert } from 'mdui/functions/alert.js';
-import type * as API from '../../server/api.js';
 import { Connection } from 'lowlander/client';
 import A from 'aberdeen';
-
 import { setColorScheme } from 'mdui/functions/setColorScheme.js';
 // Generate a color scheme based on #0061a4 and set the <html> element to that color scheme
 setColorScheme('#ef6b00');
-
 A.setSpacingCssVars();
-
 const WEBSOCKET_URL = `ws://${location.hostname}:8080/`;
-
 // Create a WebSocket connection with type-safe RPC to the server API.
-const connection = new Connection<typeof API>(WEBSOCKET_URL);
+const connection = new Connection(WEBSOCKET_URL);
 const api = connection.api;
-A('h2#Online')
+A('h2#Online');
 // Create a reactive scope to render online status
 A(() => {
     A(connection.isOnline() ? 'text=yes' : 'text=no');
 });
-
 // Simple RPC call - returns a PromiseProxy that resolves to the result.
 const sum = api.add(1234, 6753);
-A('h2#Answer')
+A('h2#Answer');
 A.dump(sum);
-
 // Server proxy example - authenticate returns both a value and a stateful API object.
 const auth = api.authenticate('Frank');
 A('h2#AuthToken');
 A.dump(auth); // auth.value will become "secret" once authentication completes
-
-
 // Access the server-side UserAPI through the .serverProxy property.
 // Note that this proxy is usable immediately, even though the authentication
 // call is still in progress - the server will process requests in-order.
 // If authentication were to fail, so would any calls on the server proxy.
 const userApi = auth.serverProxy;
-
 // Call methods on the server proxy (returns PromiseProxy like regular RPC).
 const bio = userApi.getBio();
 A('h2#Bio');
 A.dump(bio); // bio.value will become "1:Frank"
-
 // Model streaming - returns a reactive proxy that updates when server-side model changes.
 const model = api.streamModel();
 A('h2#Model');
 A.dump(model); // Live model (and nested linked models) will appear in model.value
-
 A('h2#Toggle friend');
 const formBusy = A.proxy(false);
 const friendName = A.proxy('');
-A('form display:flex gap:$2', 'submit=', async (e: any) => {
+A('form display:flex gap:$2', 'submit=', async (e) => {
     e.preventDefault();
     formBusy.value = true;
     const found = await userApi.toggleFriend(friendName.value).promise;
     formBusy.value = false;
-    if (!found) alert({description: 'No such person: ' + friendName.value});
+    if (!found)
+        alert({ description: 'No such person: ' + friendName.value });
 }, () => {
     A('mdui-text-field label="Person name" bind=', friendName);
     A(() => {
-        if (formBusy.value) A('mdui-circular-progress');
-        else A('mdui-button type=submit #Toggle friend');
-    })
+        if (formBusy.value)
+            A('mdui-circular-progress');
+        else
+            A('mdui-button type=submit #Toggle friend');
+    });
 });
-
-
-
 // Socket streaming - server pushes data via callbacks.
-const data = A.proxy([] as number[]);
+const data = A.proxy([]);
 let dataIndex = 0;
 api.streamSomething(item => data[dataIndex++ % 20] = item);
 A('h2#Streamed data');
 A.dump(data);
-
 A('mdui-fab icon=admin_panel_settings text="Lowlander Admin" click=', async () => {
     const { showAdminModal } = await import('./admin');
     showAdminModal(api);
 });
+//# sourceMappingURL=base.js.map

package/build/examples/helloworld/client/js/base.js.map

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

package/build/examples/helloworld/server/api.d.ts

@@ -0,0 +1,40 @@
+import * as E from "edinburgh";
+import { ServerProxy, Socket } from "lowlander/server";
+export declare const getDebugState: typeof import("warpsocket/addon-loader").getDebugState;
+export declare function add(a: number, b: number): number;
+export declare class UserAPI {
+    userName: string;
+    constructor(userName: string);
+    get user(): Person;
+    getBio(): string;
+    toggleFriend(friendName: string): boolean;
+}
+export declare function authenticate(auth: string): Promise<ServerProxy<UserAPI, string>>;
+declare class Person extends E.Model<Person> {
+    static byName: E.PrimaryIndex<typeof Person, ["name"]>;
+    name: string;
+    age: number;
+    friends: Person[];
+    password: string;
+}
+export declare function resetTestData(deleteEverything: boolean): Promise<void>;
+export declare function streamModel(): {
+    _instance: E.Model<any> & {
+        name: string;
+        owner: {
+            name: string;
+            age: number;
+            friends: readonly {
+                name: string;
+                age: number;
+            }[];
+        };
+        createdAt: Date;
+    };
+    toString(): string;
+};
+export declare function incrOwnerAge(delta: number): Promise<void>;
+export declare function setOwnerAge(age: number): void;
+export declare function streamSomething(socket: Socket<number>): void;
+export {};
+//# sourceMappingURL=api.d.ts.map

package/build/examples/helloworld/server/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../../examples/helloworld/server/api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,WAAW,CAAC;AAC/B,OAAO,EAAE,WAAW,EAAoB,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAGzE,eAAO,MAAM,aAAa,wDAA2B,CAAC;AAGtD,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEhD;AAGD,qBAAa,OAAO;IACG,QAAQ,EAAE,MAAM;gBAAhB,QAAQ,EAAE,MAAM;IAEnC,IAAI,IAAI,IAAI,MAAM,CAIjB;IAED,MAAM;IAIN,YAAY,CAAC,UAAU,EAAE,MAAM;CAmBlC;AAGD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,yCAM9C;AAID,cACM,MAAO,SAAQ,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC;IAChC,MAAM,CAAC,MAAM,0CAA6B;IAC1C,IAAI,SAAqB;IACzB,GAAG,SAAqB;IACxB,OAAO,WAAoC;IAC3C,QAAQ,SAAqB;CAChC;AAeD,wBAAsB,aAAa,CAAC,gBAAgB,EAAE,OAAO,iBAiB5D;AA2BD,wBAAgB,WAAW;;;;;;;;;;;;;;EAG1B;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,iBAK/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,QAGtC;AAKD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,QASrD"}