@kerebron/extension-server-hono 0.4.27 → 0.4.28

package/esm/HonoYjsMemAdapter.d.ts

@@ -0,0 +1,41 @@
+import { WSEvents } from './deps/jsr.io/@hono/hono/4.11.3/src/helper/websocket/index.js';
+import * as Y from 'yjs';
+import * as awarenessProtocol from 'y-protocols/awareness';
+import { HonoWsAdapter } from './mod.js';
+export declare const messageType: {
+    sync: number;
+    awareness: number;
+};
+export declare const docs: Map<string, Y.Doc>;
+/**
+ * Gets a Y.Doc by name, whether in memory or on disk
+ *
+ * @param {string} docname - the name of the Y.Doc to find or create
+ * @param {boolean} gc - whether to allow gc on the doc (applies only when created)
+ * @return {WSSharedDoc}
+ */
+export declare const getYDoc: (docname: string, gc?: boolean) => Y.Doc;
+export declare class SocketContext {
+    readonly room: Room;
+    readonly socket: WebSocket;
+    readonly controlledIds: Set<number>;
+    constructor(room: Room, socket: WebSocket);
+}
+export declare class Room {
+    readonly roomName: string;
+    readonly doc: Y.Doc;
+    readonly socketContexts: Map<WebSocket, SocketContext>;
+    awareness: awarenessProtocol.Awareness;
+    constructor(roomName: string, doc: Y.Doc);
+}
+export declare class HonoYjsMemAdapter implements HonoWsAdapter {
+    #private;
+    readonly sockets: Map<WebSocket, SocketContext>;
+    readonly rooms: Map<string, Room>;
+    constructor();
+    getRoomNames(): string[];
+    upgradeWebSocket(roomName: string): WSEvents<WebSocket>;
+    send(conn: WebSocket, m: Uint8Array): void;
+    receiveMessage(messageBytes: Uint8Array, conn: WebSocket): void;
+}
+//# sourceMappingURL=HonoYjsMemAdapter.d.ts.map

package/esm/HonoYjsMemAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"HonoYjsMemAdapter.d.ts","sourceRoot":"","sources":["../src/HonoYjsMemAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAa,QAAQ,EAAE,MAAM,+DAA+D,CAAC;AAEpG,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAI3D,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,WAAW;;;CAGvB,CAAC;AAEF,eAAO,MAAM,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAa,CAAC;AAIlD;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,GAAI,SAAS,MAAM,EAAE,YAAS,KAAG,CAAC,CAAC,GAWtD,CAAC;AAEF,qBAAa,aAAa;aAGI,IAAI,EAAE,IAAI;aAAkB,MAAM,EAAE,SAAS;IAFzE,SAAgB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAa;gBAE3B,IAAI,EAAE,IAAI,EAAkB,MAAM,EAAE,SAAS;CAE1E;AAED,qBAAa,IAAI;aAIa,QAAQ,EAAE,MAAM;aAAkB,GAAG,EAAE,CAAC,CAAC,GAAG;IAHxE,SAAgB,cAAc,EAAE,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAa;IAC1E,SAAS,EAAE,iBAAiB,CAAC,SAAS,CAAC;gBAEX,QAAQ,EAAE,MAAM,EAAkB,GAAG,EAAE,CAAC,CAAC,GAAG;CAuDzE;AAID,qBAAa,iBAAkB,YAAW,aAAa;;IACrD,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAa;IAC5D,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;;IAMlC,YAAY;IAIZ,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC,SAAS,CAAC;IAsEvD,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,EAAE,UAAU;IAUnC,cAAc,CAAC,YAAY,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS;CA8DzD"}

package/esm/HonoYjsMemAdapter.js

@@ -0,0 +1,203 @@
+import * as Y from 'yjs';
+import * as syncProtocol from 'y-protocols/sync';
+import * as awarenessProtocol from 'y-protocols/awareness';
+import * as encoding from 'lib0/encoding';
+import * as decoding from 'lib0/decoding';
+export const messageType = {
+    sync: 0,
+    awareness: 1,
+};
+export const docs = new Map();
+const gcEnabled = false;
+/**
+ * Gets a Y.Doc by name, whether in memory or on disk
+ *
+ * @param {string} docname - the name of the Y.Doc to find or create
+ * @param {boolean} gc - whether to allow gc on the doc (applies only when created)
+ * @return {WSSharedDoc}
+ */
+export const getYDoc = (docname, gc = true) => {
+    if (docs.has(docname)) {
+        return docs.get(docname);
+    }
+    const ydoc = new Y.Doc({ gc: gcEnabled });
+    ydoc.gc = gc;
+    // if (persistence !== null) {
+    //   persistence.bindState(docname, doc)
+    // }
+    docs.set(docname, ydoc);
+    return ydoc;
+};
+export class SocketContext {
+    room;
+    socket;
+    controlledIds = new Set();
+    constructor(room, socket) {
+        this.room = room;
+        this.socket = socket;
+    }
+}
+export class Room {
+    roomName;
+    doc;
+    socketContexts = new Map();
+    awareness;
+    constructor(roomName, doc) {
+        this.roomName = roomName;
+        this.doc = doc;
+        this.awareness = new awarenessProtocol.Awareness(doc);
+        this.awareness.setLocalState(null);
+        this.awareness.on('update', ({ added, updated, removed }, conn) => {
+            const changedClients = added.concat(updated, removed);
+            if (conn !== null) {
+                const socketContext = this.socketContexts.get(conn);
+                if (socketContext) {
+                    added.forEach((clientID) => {
+                        socketContext.controlledIds.add(clientID);
+                    });
+                    removed.forEach((clientID) => {
+                        socketContext.controlledIds.delete(clientID);
+                    });
+                }
+            }
+            // broadcast awareness update
+            const encoder = encoding.createEncoder();
+            encoding.writeVarUint(encoder, messageType.awareness);
+            encoding.writeVarUint8Array(encoder, awarenessProtocol.encodeAwarenessUpdate(this.awareness, changedClients));
+            const buff = encoding.toUint8Array(encoder);
+            for (const socket of this.socketContexts.keys()) {
+                socket.send(buff);
+            }
+        });
+        doc.on('update', (update) => {
+            const encoder = encoding.createEncoder();
+            encoding.writeVarUint(encoder, messageType.sync);
+            syncProtocol.writeUpdate(encoder, update);
+            const message = encoding.toUint8Array(encoder);
+            for (const socket of this.socketContexts.keys()) {
+                socket.send(message);
+            }
+        });
+    }
+}
+const rooms = new Map();
+export class HonoYjsMemAdapter {
+    sockets = new Map();
+    rooms;
+    constructor() {
+        this.rooms = rooms;
+    }
+    getRoomNames() {
+        return Array.from(rooms.keys());
+    }
+    upgradeWebSocket(roomName) {
+        const doc = getYDoc(roomName, gcEnabled);
+        return {
+            onOpen: (evt, wsContext) => {
+                if (!wsContext.raw) {
+                    return;
+                }
+                if (!this.rooms.has(roomName)) {
+                    this.rooms.set(roomName, new Room(roomName, doc));
+                }
+                const room = this.rooms.get(roomName);
+                const socketContext = new SocketContext(room, wsContext.raw);
+                this.sockets.set(wsContext.raw, socketContext);
+                room.socketContexts.set(wsContext.raw, socketContext);
+                const encoder = encoding.createEncoder();
+                encoding.writeVarUint(encoder, messageType.sync);
+                syncProtocol.writeSyncStep1(encoder, doc);
+                this.send(wsContext.raw, encoding.toUint8Array(encoder));
+                const awarenessStates = room.awareness.getStates();
+                if (awarenessStates.size > 0) {
+                    const encoder = encoding.createEncoder();
+                    encoding.writeVarUint(encoder, messageType.awareness);
+                    encoding.writeVarUint8Array(encoder, awarenessProtocol.encodeAwarenessUpdate(room.awareness, Array.from(awarenessStates.keys())));
+                    this.send(wsContext.raw, encoding.toUint8Array(encoder));
+                }
+                // this.#forceReady();
+            },
+            onError: (evt, wsContext) => {
+                if (evt instanceof ErrorEvent) {
+                    if (evt.message.indexOf('Connection reset by peer') > -1) {
+                        return;
+                    }
+                    if (evt.message.indexOf('No response from ping frame.') > -1) {
+                        return;
+                    }
+                    console.warn(new Error('HonoYjsMemAdapter.onError: ' + evt.message, {
+                        cause: evt.error,
+                    }));
+                }
+            },
+            onMessage: (message, wsContext) => {
+                if (!wsContext.raw) {
+                    return;
+                }
+                this.receiveMessage(new Uint8Array(message.data), wsContext.raw);
+            },
+            onClose: (event, wsContext) => {
+                if (!wsContext.raw) {
+                    return;
+                }
+                this.#removeSocket(wsContext.raw);
+            },
+        };
+    }
+    send(conn, m) {
+        if (conn.readyState !== WebSocket.CONNECTING &&
+            conn.readyState !== WebSocket.OPEN) {
+            this.#terminate(conn);
+        }
+        conn.send(m);
+    }
+    receiveMessage(messageBytes, conn) {
+        try {
+            const socketContext = this.sockets.get(conn);
+            if (!socketContext) {
+                return;
+            }
+            const room = socketContext.room;
+            const encoder = encoding.createEncoder();
+            const decoder = decoding.createDecoder(messageBytes);
+            const type = decoding.readVarUint(decoder);
+            switch (type) {
+                case messageType.sync:
+                    encoding.writeVarUint(encoder, messageType.sync);
+                    syncProtocol.readSyncMessage(decoder, encoder, room.doc, conn);
+                    // If the `encoder` only contains the type of reply message and no
+                    // message, there is no need to send the message. When `encoder` only
+                    // contains the type of reply, its length is 1.
+                    if (encoding.length(encoder) > 1) {
+                        this.send(conn, encoding.toUint8Array(encoder));
+                    }
+                    break;
+                case messageType.awareness: {
+                    awarenessProtocol.applyAwarenessUpdate(room.awareness, decoding.readVarUint8Array(decoder), conn);
+                    break;
+                }
+            }
+        }
+        catch (err) {
+            console.error(err);
+            // room.doc.emit('error', [err]);
+        }
+    }
+    #terminate(socket) {
+        this.#removeSocket(socket);
+        socket.close();
+    }
+    #removeSocket(conn) {
+        const socketContext = this.sockets.get(conn);
+        if (socketContext) {
+            const room = socketContext.room;
+            room.socketContexts.delete(socketContext.socket);
+            awarenessProtocol.removeAwarenessStates(room.awareness, Array.from(socketContext.controlledIds), null);
+            if (room.socketContexts.size === 0) {
+                // TODO save to persistence
+                // TODO Destroy room
+            }
+            this.sockets.delete(conn);
+        }
+    }
+}

package/esm/deps/jsr.io/@hono/hono/4.11.3/src/compose.d.ts

@@ -0,0 +1,15 @@
+import type { Context } from './context.js';
+import type { Env, ErrorHandler, Next, NotFoundHandler } from './types.js';
+/**
+ * Compose middleware functions into a single function based on `koa-compose` package.
+ *
+ * @template E - The environment type.
+ *
+ * @param {[[Function, unknown], unknown][] | [[Function]][]} middleware - An array of middleware functions and their corresponding parameters.
+ * @param {ErrorHandler<E>} [onError] - An optional error handler function.
+ * @param {NotFoundHandler<E>} [onNotFound] - An optional not-found handler function.
+ *
+ * @returns {(context: Context, next?: Next) => Promise<Context>} - A composed middleware function.
+ */
+export declare const compose: <E extends Env = Env>(middleware: [[Function, unknown], unknown][] | [[Function]][], onError?: ErrorHandler<E>, onNotFound?: NotFoundHandler<E>) => ((context: Context, next?: Next) => Promise<Context>);
+//# sourceMappingURL=compose.d.ts.map

package/esm/deps/jsr.io/@hono/hono/4.11.3/src/compose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compose.d.ts","sourceRoot":"","sources":["../../../../../../../src/deps/jsr.io/@hono/hono/4.11.3/src/compose.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAC3C,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAE1E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,SAAS,GAAG,GAAG,GAAG,EACzC,YAAY,CAAC,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,EAC7D,UAAU,YAAY,CAAC,CAAC,CAAC,EACzB,aAAa,eAAe,CAAC,CAAC,CAAC,KAC9B,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,KAAK,OAAO,CAAC,OAAO,CAAC,CAsDtD,CAAA"}

package/esm/deps/jsr.io/@hono/hono/4.11.3/src/compose.js

@@ -0,0 +1,64 @@
+/**
+ * Compose middleware functions into a single function based on `koa-compose` package.
+ *
+ * @template E - The environment type.
+ *
+ * @param {[[Function, unknown], unknown][] | [[Function]][]} middleware - An array of middleware functions and their corresponding parameters.
+ * @param {ErrorHandler<E>} [onError] - An optional error handler function.
+ * @param {NotFoundHandler<E>} [onNotFound] - An optional not-found handler function.
+ *
+ * @returns {(context: Context, next?: Next) => Promise<Context>} - A composed middleware function.
+ */
+export const compose = (middleware, onError, onNotFound) => {
+    return (context, next) => {
+        let index = -1;
+        return dispatch(0);
+        /**
+         * Dispatch the middleware functions.
+         *
+         * @param {number} i - The current index in the middleware array.
+         *
+         * @returns {Promise<Context>} - A promise that resolves to the context.
+         */
+        async function dispatch(i) {
+            if (i <= index) {
+                throw new Error('next() called multiple times');
+            }
+            index = i;
+            let res;
+            let isError = false;
+            let handler;
+            if (middleware[i]) {
+                handler = middleware[i][0][0];
+                context.req.routeIndex = i;
+            }
+            else {
+                handler = (i === middleware.length && next) || undefined;
+            }
+            if (handler) {
+                try {
+                    res = await handler(context, () => dispatch(i + 1));
+                }
+                catch (err) {
+                    if (err instanceof Error && onError) {
+                        context.error = err;
+                        res = await onError(err, context);
+                        isError = true;
+                    }
+                    else {
+                        throw err;
+                    }
+                }
+            }
+            else {
+                if (context.finalized === false && onNotFound) {
+                    res = await onNotFound(context);
+                }
+            }
+            if (res && (context.finalized === false || isError)) {
+                context.res = res;
+            }
+            return context;
+        }
+    };
+};