y-partyserver 0.0.26 → 0.0.28

package/dist/server/index.d.ts

@@ -29,4 +29,4 @@ declare class YServer<Env = unknown> extends Server<Env> {
   onConnect(conn: Connection<unknown>, _ctx: ConnectionContext): void;
 }
 
-export { YServer };
+export { type CallbackOptions, YServer };

package/dist/server/index.js

@@ -118,7 +118,6 @@ var YServer = class extends Server {
   // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access
   #ParentClass = Object.getPrototypeOf(this).constructor;
   document = new WSSharedDoc();
-  // eslint-disable-next-line @typescript-eslint/require-await
   async onLoad() {
     return;
   }

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/server/index.ts"],"sourcesContent":["import * as decoding from \"lib0/decoding\";\nimport * as encoding from \"lib0/encoding\";\nimport debounce from \"lodash.debounce\";\nimport { Server } from \"partyserver\";\nimport * as awarenessProtocol from \"y-protocols/awareness\";\nimport * as syncProtocol from \"y-protocols/sync\";\nimport { applyUpdate, encodeStateAsUpdate, Doc as YDoc } from \"yjs\";\n\nimport { handleChunked } from \"../shared/chunking\";\n\nimport type { Connection, ConnectionContext } from \"partyserver\";\n\nconst wsReadyStateConnecting = 0;\nconst wsReadyStateOpen = 1;\nconst wsReadyStateClosing = 2; // eslint-disable-line\nconst wsReadyStateClosed = 3; // eslint-disable-line\n\nconst messageSync = 0;\nconst messageAwareness = 1;\nconst messageAuth = 2; // eslint-disable-line\n\nfunction updateHandler(update: Uint8Array, origin: unknown, doc: WSSharedDoc) {\n  const encoder = encoding.createEncoder();\n  encoding.writeVarUint(encoder, messageSync);\n  syncProtocol.writeUpdate(encoder, update);\n  const message = encoding.toUint8Array(encoder);\n  doc.conns.forEach((_, conn) => send(doc, conn, message));\n}\n\nclass WSSharedDoc extends YDoc {\n  conns: Map<Connection, Set<number>>;\n  awareness: awarenessProtocol.Awareness;\n\n  constructor() {\n    super({ gc: true });\n\n    /**\n     * Maps from conn to set of controlled user ids. Delete all user ids from awareness when this conn is closed\n     */\n    this.conns = new Map();\n\n    this.awareness = new awarenessProtocol.Awareness(this);\n    this.awareness.setLocalState(null);\n\n    const awarenessChangeHandler = (\n      {\n        added,\n        updated,\n        removed\n      }: {\n        added: Array<number>;\n        updated: Array<number>;\n        removed: Array<number>;\n      },\n      conn: Connection | null // Origin is the connection that made the change\n    ) => {\n      const changedClients = added.concat(updated, removed);\n      if (conn !== null) {\n        const connControlledIDs =\n          /** @type {Set<number>} */ this.conns.get(conn);\n        if (connControlledIDs !== undefined) {\n          added.forEach((clientID) => {\n            connControlledIDs.add(clientID);\n          });\n          removed.forEach((clientID) => {\n            connControlledIDs.delete(clientID);\n          });\n        }\n      }\n      // broadcast awareness update\n      const encoder = encoding.createEncoder();\n      encoding.writeVarUint(encoder, messageAwareness);\n      encoding.writeVarUint8Array(\n        encoder,\n        awarenessProtocol.encodeAwarenessUpdate(this.awareness, changedClients)\n      );\n      const buff = encoding.toUint8Array(encoder);\n      this.conns.forEach((_, c) => {\n        send(this, c, buff);\n      });\n    };\n    this.awareness.on(\"update\", awarenessChangeHandler);\n    // @ts-expect-error - TODO: fix this\n    this.on(\"update\", updateHandler);\n  }\n}\n\nconst CALLBACK_DEFAULTS = {\n  debounceWait: 2000,\n  debounceMaxWait: 10000,\n  timeout: 5000\n};\n\nfunction readSyncMessage(\n  decoder: decoding.Decoder,\n  encoder: encoding.Encoder,\n  doc: YDoc,\n  transactionOrigin: Connection,\n  readOnly = false\n) {\n  const messageType = decoding.readVarUint(decoder);\n  switch (messageType) {\n    case syncProtocol.messageYjsSyncStep1:\n      syncProtocol.readSyncStep1(decoder, encoder, doc);\n      break;\n    case syncProtocol.messageYjsSyncStep2:\n      if (!readOnly)\n        syncProtocol.readSyncStep2(decoder, doc, transactionOrigin);\n      break;\n    case syncProtocol.messageYjsUpdate:\n      if (!readOnly) syncProtocol.readUpdate(decoder, doc, transactionOrigin);\n      break;\n    default:\n      throw new Error(\"Unknown message type\");\n  }\n  return messageType;\n}\n\nfunction closeConn(doc: WSSharedDoc, conn: Connection): void {\n  if (doc.conns.has(conn)) {\n    const controlledIds: Set<number> = doc.conns.get(conn)!;\n    doc.conns.delete(conn);\n    awarenessProtocol.removeAwarenessStates(\n      doc.awareness,\n      Array.from(controlledIds),\n      null\n    );\n  }\n  try {\n    conn.close();\n  } catch (e) {\n    console.warn(\"failed to close connection\", e);\n  }\n}\n\nfunction send(doc: WSSharedDoc, conn: Connection, m: Uint8Array) {\n  if (\n    conn.readyState !== undefined &&\n    conn.readyState !== wsReadyStateConnecting &&\n    conn.readyState !== wsReadyStateOpen\n  ) {\n    closeConn(doc, conn);\n  }\n  try {\n    conn.send(m);\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  } catch (e) {\n    closeConn(doc, conn);\n  }\n}\n\ninterface CallbackOptions {\n  debounceWait?: number;\n  debounceMaxWait?: number;\n  timeout?: number;\n}\n\nexport class YServer<Env = unknown> extends Server<Env> {\n  static callbackOptions: CallbackOptions = {};\n\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n  #ParentClass: typeof YServer = Object.getPrototypeOf(this).constructor;\n  readonly document = new WSSharedDoc();\n\n  // eslint-disable-next-line @typescript-eslint/require-await\n  async onLoad(): Promise<void> {\n    // to be implemented by the user\n    return;\n  }\n\n  async onSave(): Promise<void> {}\n\n  async onStart(): Promise<void> {\n    const src = await this.onLoad();\n    if (src != null) {\n      const state = encodeStateAsUpdate(src);\n      applyUpdate(this.document, state);\n    }\n\n    this.document.on(\n      \"update\",\n      debounce(\n        (_update: Uint8Array, _origin: Connection, _doc: YDoc) => {\n          try {\n            this.onSave().catch((err) => {\n              console.error(\"failed to persist:\", err);\n            });\n          } catch (err) {\n            console.error(\"failed to persist:\", err);\n          }\n        },\n        this.#ParentClass.callbackOptions.debounceWait ||\n          CALLBACK_DEFAULTS.debounceWait,\n        {\n          maxWait:\n            this.#ParentClass.callbackOptions.debounceMaxWait ||\n            CALLBACK_DEFAULTS.debounceMaxWait\n        }\n      )\n    );\n  }\n\n  onMessage = handleChunked((conn, message) => {\n    if (typeof message === \"string\") {\n      console.warn(\n        `Received non-binary message. Override onMessage on ${this.#ParentClass.name} to handle string messages if required`\n      );\n      return;\n    }\n    try {\n      const encoder = encoding.createEncoder();\n      // TODO: this type seems odd\n      const decoder = decoding.createDecoder(message as Uint8Array);\n      const messageType = decoding.readVarUint(decoder);\n      switch (messageType) {\n        case messageSync:\n          encoding.writeVarUint(encoder, messageSync);\n          readSyncMessage(\n            decoder,\n            encoder,\n            this.document,\n            conn,\n            // TODO: readonly conections\n            false\n          );\n\n          // If the `encoder` only contains the type of reply message and no\n          // message, there is no need to send the message. When `encoder` only\n          // contains the type of reply, its length is 1.\n          if (encoding.length(encoder) > 1) {\n            send(this.document, conn, encoding.toUint8Array(encoder));\n          }\n          break;\n        case messageAwareness: {\n          awarenessProtocol.applyAwarenessUpdate(\n            this.document.awareness,\n            decoding.readVarUint8Array(decoder),\n            conn\n          );\n          break;\n        }\n      }\n    } catch (err) {\n      console.error(err);\n      // @ts-expect-error - TODO: fix this\n      this.document.emit(\"error\", [err]);\n    }\n  });\n\n  onClose(\n    connection: Connection<unknown>,\n    _code: number,\n    _reason: string,\n    _wasClean: boolean\n  ): void | Promise<void> {\n    closeConn(this.document, connection);\n  }\n\n  // TODO: explore why onError gets triggered when a connection closes\n\n  onConnect(conn: Connection<unknown>, _ctx: ConnectionContext) {\n    // conn.binaryType = \"arraybuffer\"; // from y-websocket, breaks in our runtime\n\n    this.document.conns.set(conn, new Set());\n\n    // send sync step 1\n    const encoder = encoding.createEncoder();\n    encoding.writeVarUint(encoder, messageSync);\n    syncProtocol.writeSyncStep1(encoder, this.document);\n    send(this.document, conn, encoding.toUint8Array(encoder));\n    const awarenessStates = this.document.awareness.getStates();\n    if (awarenessStates.size > 0) {\n      const encoder = encoding.createEncoder();\n      encoding.writeVarUint(encoder, messageAwareness);\n      encoding.writeVarUint8Array(\n        encoder,\n        awarenessProtocol.encodeAwarenessUpdate(\n          this.document.awareness,\n          Array.from(awarenessStates.keys())\n        )\n      );\n      send(this.document, conn, encoding.toUint8Array(encoder));\n    }\n  }\n}\n"],"mappings":";;;;;AAAA,YAAY,cAAc;AAC1B,YAAY,cAAc;AAC1B,OAAO,cAAc;AACrB,SAAS,cAAc;AACvB,YAAY,uBAAuB;AACnC,YAAY,kBAAkB;AAC9B,SAAS,aAAa,qBAAqB,OAAO,YAAY;AAM9D,IAAM,yBAAyB;AAC/B,IAAM,mBAAmB;AAIzB,IAAM,cAAc;AACpB,IAAM,mBAAmB;AAGzB,SAAS,cAAc,QAAoB,QAAiB,KAAkB;AAC5E,QAAM,UAAmB,uBAAc;AACvC,EAAS,sBAAa,SAAS,WAAW;AAC1C,EAAa,yBAAY,SAAS,MAAM;AACxC,QAAM,UAAmB,sBAAa,OAAO;AAC7C,MAAI,MAAM,QAAQ,CAAC,GAAG,SAAS,KAAK,KAAK,MAAM,OAAO,CAAC;AACzD;AAEA,IAAM,cAAN,cAA0B,KAAK;AAAA,EAC7B;AAAA,EACA;AAAA,EAEA,cAAc;AACZ,UAAM,EAAE,IAAI,KAAK,CAAC;AAKlB,SAAK,QAAQ,oBAAI,IAAI;AAErB,SAAK,YAAY,IAAsB,4BAAU,IAAI;AACrD,SAAK,UAAU,cAAc,IAAI;AAEjC,UAAM,yBAAyB,CAC7B;AAAA,MACE;AAAA,MACA;AAAA,MACA;AAAA,IACF,GAKA,SACG;AACH,YAAM,iBAAiB,MAAM,OAAO,SAAS,OAAO;AACpD,UAAI,SAAS,MAAM;AACjB,cAAM;AAAA;AAAA,UACuB,KAAK,MAAM,IAAI,IAAI;AAAA;AAChD,YAAI,sBAAsB,QAAW;AACnC,gBAAM,QAAQ,CAAC,aAAa;AAC1B,8BAAkB,IAAI,QAAQ;AAAA,UAChC,CAAC;AACD,kBAAQ,QAAQ,CAAC,aAAa;AAC5B,8BAAkB,OAAO,QAAQ;AAAA,UACnC,CAAC;AAAA,QACH;AAAA,MACF;AAEA,YAAM,UAAmB,uBAAc;AACvC,MAAS,sBAAa,SAAS,gBAAgB;AAC/C,MAAS;AAAA,QACP;AAAA,QACkB,wCAAsB,KAAK,WAAW,cAAc;AAAA,MACxE;AACA,YAAM,OAAgB,sBAAa,OAAO;AAC1C,WAAK,MAAM,QAAQ,CAAC,GAAG,MAAM;AAC3B,aAAK,MAAM,GAAG,IAAI;AAAA,MACpB,CAAC;AAAA,IACH;AACA,SAAK,UAAU,GAAG,UAAU,sBAAsB;AAElD,SAAK,GAAG,UAAU,aAAa;AAAA,EACjC;AACF;AAEA,IAAM,oBAAoB;AAAA,EACxB,cAAc;AAAA,EACd,iBAAiB;AAAA,EACjB,SAAS;AACX;AAEA,SAAS,gBACP,SACA,SACA,KACA,mBACA,WAAW,OACX;AACA,QAAM,cAAuB,qBAAY,OAAO;AAChD,UAAQ,aAAa;AAAA,IACnB,KAAkB;AAChB,MAAa,2BAAc,SAAS,SAAS,GAAG;AAChD;AAAA,IACF,KAAkB;AAChB,UAAI,CAAC;AACH,QAAa,2BAAc,SAAS,KAAK,iBAAiB;AAC5D;AAAA,IACF,KAAkB;AAChB,UAAI,CAAC,SAAU,CAAa,wBAAW,SAAS,KAAK,iBAAiB;AACtE;AAAA,IACF;AACE,YAAM,IAAI,MAAM,sBAAsB;AAAA,EAC1C;AACA,SAAO;AACT;AAEA,SAAS,UAAU,KAAkB,MAAwB;AAC3D,MAAI,IAAI,MAAM,IAAI,IAAI,GAAG;AACvB,UAAM,gBAA6B,IAAI,MAAM,IAAI,IAAI;AACrD,QAAI,MAAM,OAAO,IAAI;AACrB,IAAkB;AAAA,MAChB,IAAI;AAAA,MACJ,MAAM,KAAK,aAAa;AAAA,MACxB;AAAA,IACF;AAAA,EACF;AACA,MAAI;AACF,SAAK,MAAM;AAAA,EACb,SAAS,GAAG;AACV,YAAQ,KAAK,8BAA8B,CAAC;AAAA,EAC9C;AACF;AAEA,SAAS,KAAK,KAAkB,MAAkB,GAAe;AAC/D,MACE,KAAK,eAAe,UACpB,KAAK,eAAe,0BACpB,KAAK,eAAe,kBACpB;AACA,cAAU,KAAK,IAAI;AAAA,EACrB;AACA,MAAI;AACF,SAAK,KAAK,CAAC;AAAA,EAEb,SAAS,GAAG;AACV,cAAU,KAAK,IAAI;AAAA,EACrB;AACF;AAQO,IAAM,UAAN,cAAqC,OAAY;AAAA,EACtD,OAAO,kBAAmC,CAAC;AAAA;AAAA,EAG3C,eAA+B,OAAO,eAAe,IAAI,EAAE;AAAA,EAClD,WAAW,IAAI,YAAY;AAAA;AAAA,EAGpC,MAAM,SAAwB;AAE5B;AAAA,EACF;AAAA,EAEA,MAAM,SAAwB;AAAA,EAAC;AAAA,EAE/B,MAAM,UAAyB;AAC7B,UAAM,MAAM,MAAM,KAAK,OAAO;AAC9B,QAAI,OAAO,MAAM;AACf,YAAM,QAAQ,oBAAoB,GAAG;AACrC,kBAAY,KAAK,UAAU,KAAK;AAAA,IAClC;AAEA,SAAK,SAAS;AAAA,MACZ;AAAA,MACA;AAAA,QACE,CAAC,SAAqB,SAAqB,SAAe;AACxD,cAAI;AACF,iBAAK,OAAO,EAAE,MAAM,CAAC,QAAQ;AAC3B,sBAAQ,MAAM,sBAAsB,GAAG;AAAA,YACzC,CAAC;AAAA,UACH,SAAS,KAAK;AACZ,oBAAQ,MAAM,sBAAsB,GAAG;AAAA,UACzC;AAAA,QACF;AAAA,QACA,KAAK,aAAa,gBAAgB,gBAChC,kBAAkB;AAAA,QACpB;AAAA,UACE,SACE,KAAK,aAAa,gBAAgB,mBAClC,kBAAkB;AAAA,QACtB;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAAA,EAEA,YAAY,cAAc,CAAC,MAAM,YAAY;AAC3C,QAAI,OAAO,YAAY,UAAU;AAC/B,cAAQ;AAAA,QACN,sDAAsD,KAAK,aAAa,IAAI;AAAA,MAC9E;AACA;AAAA,IACF;AACA,QAAI;AACF,YAAM,UAAmB,uBAAc;AAEvC,YAAM,UAAmB,uBAAc,OAAqB;AAC5D,YAAM,cAAuB,qBAAY,OAAO;AAChD,cAAQ,aAAa;AAAA,QACnB,KAAK;AACH,UAAS,sBAAa,SAAS,WAAW;AAC1C;AAAA,YACE;AAAA,YACA;AAAA,YACA,KAAK;AAAA,YACL;AAAA;AAAA,YAEA;AAAA,UACF;AAKA,cAAa,gBAAO,OAAO,IAAI,GAAG;AAChC,iBAAK,KAAK,UAAU,MAAe,sBAAa,OAAO,CAAC;AAAA,UAC1D;AACA;AAAA,QACF,KAAK,kBAAkB;AACrB,UAAkB;AAAA,YAChB,KAAK,SAAS;AAAA,YACL,2BAAkB,OAAO;AAAA,YAClC;AAAA,UACF;AACA;AAAA,QACF;AAAA,MACF;AAAA,IACF,SAAS,KAAK;AACZ,cAAQ,MAAM,GAAG;AAEjB,WAAK,SAAS,KAAK,SAAS,CAAC,GAAG,CAAC;AAAA,IACnC;AAAA,EACF,CAAC;AAAA,EAED,QACE,YACA,OACA,SACA,WACsB;AACtB,cAAU,KAAK,UAAU,UAAU;AAAA,EACrC;AAAA;AAAA,EAIA,UAAU,MAA2B,MAAyB;AAG5D,SAAK,SAAS,MAAM,IAAI,MAAM,oBAAI,IAAI,CAAC;AAGvC,UAAM,UAAmB,uBAAc;AACvC,IAAS,sBAAa,SAAS,WAAW;AAC1C,IAAa,4BAAe,SAAS,KAAK,QAAQ;AAClD,SAAK,KAAK,UAAU,MAAe,sBAAa,OAAO,CAAC;AACxD,UAAM,kBAAkB,KAAK,SAAS,UAAU,UAAU;AAC1D,QAAI,gBAAgB,OAAO,GAAG;AAC5B,YAAMA,WAAmB,uBAAc;AACvC,MAAS,sBAAaA,UAAS,gBAAgB;AAC/C,MAAS;AAAA,QACPA;AAAA,QACkB;AAAA,UAChB,KAAK,SAAS;AAAA,UACd,MAAM,KAAK,gBAAgB,KAAK,CAAC;AAAA,QACnC;AAAA,MACF;AACA,WAAK,KAAK,UAAU,MAAe,sBAAaA,QAAO,CAAC;AAAA,IAC1D;AAAA,EACF;AACF;","names":["encoder"]}
+{"version":3,"sources":["../../src/server/index.ts"],"sourcesContent":["import * as decoding from \"lib0/decoding\";\nimport * as encoding from \"lib0/encoding\";\nimport debounce from \"lodash.debounce\";\nimport { Server } from \"partyserver\";\nimport * as awarenessProtocol from \"y-protocols/awareness\";\nimport * as syncProtocol from \"y-protocols/sync\";\nimport { applyUpdate, encodeStateAsUpdate, Doc as YDoc } from \"yjs\";\n\nimport { handleChunked } from \"../shared/chunking\";\n\nimport type { Connection, ConnectionContext } from \"partyserver\";\n\nconst wsReadyStateConnecting = 0;\nconst wsReadyStateOpen = 1;\nconst wsReadyStateClosing = 2; // eslint-disable-line\nconst wsReadyStateClosed = 3; // eslint-disable-line\n\nconst messageSync = 0;\nconst messageAwareness = 1;\nconst messageAuth = 2; // eslint-disable-line\n\nfunction updateHandler(update: Uint8Array, origin: unknown, doc: WSSharedDoc) {\n  const encoder = encoding.createEncoder();\n  encoding.writeVarUint(encoder, messageSync);\n  syncProtocol.writeUpdate(encoder, update);\n  const message = encoding.toUint8Array(encoder);\n  doc.conns.forEach((_, conn) => send(doc, conn, message));\n}\n\nclass WSSharedDoc extends YDoc {\n  conns: Map<Connection, Set<number>>;\n  awareness: awarenessProtocol.Awareness;\n\n  constructor() {\n    super({ gc: true });\n\n    /**\n     * Maps from conn to set of controlled user ids. Delete all user ids from awareness when this conn is closed\n     */\n    this.conns = new Map();\n\n    this.awareness = new awarenessProtocol.Awareness(this);\n    this.awareness.setLocalState(null);\n\n    const awarenessChangeHandler = (\n      {\n        added,\n        updated,\n        removed\n      }: {\n        added: Array<number>;\n        updated: Array<number>;\n        removed: Array<number>;\n      },\n      conn: Connection | null // Origin is the connection that made the change\n    ) => {\n      const changedClients = added.concat(updated, removed);\n      if (conn !== null) {\n        const connControlledIDs =\n          /** @type {Set<number>} */ this.conns.get(conn);\n        if (connControlledIDs !== undefined) {\n          added.forEach((clientID) => {\n            connControlledIDs.add(clientID);\n          });\n          removed.forEach((clientID) => {\n            connControlledIDs.delete(clientID);\n          });\n        }\n      }\n      // broadcast awareness update\n      const encoder = encoding.createEncoder();\n      encoding.writeVarUint(encoder, messageAwareness);\n      encoding.writeVarUint8Array(\n        encoder,\n        awarenessProtocol.encodeAwarenessUpdate(this.awareness, changedClients)\n      );\n      const buff = encoding.toUint8Array(encoder);\n      this.conns.forEach((_, c) => {\n        send(this, c, buff);\n      });\n    };\n    this.awareness.on(\"update\", awarenessChangeHandler);\n    // @ts-expect-error - TODO: fix this\n    this.on(\"update\", updateHandler);\n  }\n}\n\nconst CALLBACK_DEFAULTS = {\n  debounceWait: 2000,\n  debounceMaxWait: 10000,\n  timeout: 5000\n};\n\nfunction readSyncMessage(\n  decoder: decoding.Decoder,\n  encoder: encoding.Encoder,\n  doc: YDoc,\n  transactionOrigin: Connection,\n  readOnly = false\n) {\n  const messageType = decoding.readVarUint(decoder);\n  switch (messageType) {\n    case syncProtocol.messageYjsSyncStep1:\n      syncProtocol.readSyncStep1(decoder, encoder, doc);\n      break;\n    case syncProtocol.messageYjsSyncStep2:\n      if (!readOnly)\n        syncProtocol.readSyncStep2(decoder, doc, transactionOrigin);\n      break;\n    case syncProtocol.messageYjsUpdate:\n      if (!readOnly) syncProtocol.readUpdate(decoder, doc, transactionOrigin);\n      break;\n    default:\n      throw new Error(\"Unknown message type\");\n  }\n  return messageType;\n}\n\nfunction closeConn(doc: WSSharedDoc, conn: Connection): void {\n  if (doc.conns.has(conn)) {\n    const controlledIds: Set<number> = doc.conns.get(conn)!;\n    doc.conns.delete(conn);\n    awarenessProtocol.removeAwarenessStates(\n      doc.awareness,\n      Array.from(controlledIds),\n      null\n    );\n  }\n  try {\n    conn.close();\n  } catch (e) {\n    console.warn(\"failed to close connection\", e);\n  }\n}\n\nfunction send(doc: WSSharedDoc, conn: Connection, m: Uint8Array) {\n  if (\n    conn.readyState !== undefined &&\n    conn.readyState !== wsReadyStateConnecting &&\n    conn.readyState !== wsReadyStateOpen\n  ) {\n    closeConn(doc, conn);\n  }\n  try {\n    conn.send(m);\n    // eslint-disable-next-line @typescript-eslint/no-unused-vars\n  } catch (e) {\n    closeConn(doc, conn);\n  }\n}\n\nexport interface CallbackOptions {\n  debounceWait?: number;\n  debounceMaxWait?: number;\n  timeout?: number;\n}\n\nexport class YServer<Env = unknown> extends Server<Env> {\n  static callbackOptions: CallbackOptions = {};\n\n  // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment, @typescript-eslint/no-unsafe-member-access\n  #ParentClass: typeof YServer = Object.getPrototypeOf(this).constructor;\n  readonly document = new WSSharedDoc();\n\n  async onLoad(): Promise<void> {\n    // to be implemented by the user\n    return;\n  }\n\n  async onSave(): Promise<void> {}\n\n  async onStart(): Promise<void> {\n    const src = await this.onLoad();\n    if (src != null) {\n      const state = encodeStateAsUpdate(src);\n      applyUpdate(this.document, state);\n    }\n\n    this.document.on(\n      \"update\",\n      debounce(\n        (_update: Uint8Array, _origin: Connection, _doc: YDoc) => {\n          try {\n            this.onSave().catch((err) => {\n              console.error(\"failed to persist:\", err);\n            });\n          } catch (err) {\n            console.error(\"failed to persist:\", err);\n          }\n        },\n        this.#ParentClass.callbackOptions.debounceWait ||\n          CALLBACK_DEFAULTS.debounceWait,\n        {\n          maxWait:\n            this.#ParentClass.callbackOptions.debounceMaxWait ||\n            CALLBACK_DEFAULTS.debounceMaxWait\n        }\n      )\n    );\n  }\n\n  onMessage = handleChunked((conn, message) => {\n    if (typeof message === \"string\") {\n      console.warn(\n        `Received non-binary message. Override onMessage on ${this.#ParentClass.name} to handle string messages if required`\n      );\n      return;\n    }\n    try {\n      const encoder = encoding.createEncoder();\n      // TODO: this type seems odd\n      const decoder = decoding.createDecoder(message as Uint8Array);\n      const messageType = decoding.readVarUint(decoder);\n      switch (messageType) {\n        case messageSync:\n          encoding.writeVarUint(encoder, messageSync);\n          readSyncMessage(\n            decoder,\n            encoder,\n            this.document,\n            conn,\n            // TODO: readonly conections\n            false\n          );\n\n          // If the `encoder` only contains the type of reply message and no\n          // message, there is no need to send the message. When `encoder` only\n          // contains the type of reply, its length is 1.\n          if (encoding.length(encoder) > 1) {\n            send(this.document, conn, encoding.toUint8Array(encoder));\n          }\n          break;\n        case messageAwareness: {\n          awarenessProtocol.applyAwarenessUpdate(\n            this.document.awareness,\n            decoding.readVarUint8Array(decoder),\n            conn\n          );\n          break;\n        }\n      }\n    } catch (err) {\n      console.error(err);\n      // @ts-expect-error - TODO: fix this\n      this.document.emit(\"error\", [err]);\n    }\n  });\n\n  onClose(\n    connection: Connection<unknown>,\n    _code: number,\n    _reason: string,\n    _wasClean: boolean\n  ): void | Promise<void> {\n    closeConn(this.document, connection);\n  }\n\n  // TODO: explore why onError gets triggered when a connection closes\n\n  onConnect(conn: Connection<unknown>, _ctx: ConnectionContext) {\n    // conn.binaryType = \"arraybuffer\"; // from y-websocket, breaks in our runtime\n\n    this.document.conns.set(conn, new Set());\n\n    // send sync step 1\n    const encoder = encoding.createEncoder();\n    encoding.writeVarUint(encoder, messageSync);\n    syncProtocol.writeSyncStep1(encoder, this.document);\n    send(this.document, conn, encoding.toUint8Array(encoder));\n    const awarenessStates = this.document.awareness.getStates();\n    if (awarenessStates.size > 0) {\n      const encoder = encoding.createEncoder();\n      encoding.writeVarUint(encoder, messageAwareness);\n      encoding.writeVarUint8Array(\n        encoder,\n        awarenessProtocol.encodeAwarenessUpdate(\n          this.document.awareness,\n          Array.from(awarenessStates.keys())\n        )\n      );\n      send(this.document, conn, encoding.toUint8Array(encoder));\n    }\n  }\n}\n"],"mappings":"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","names":["encoder"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "y-partyserver",
-  "version": "0.0.26",
+  "version": "0.0.28",
   "repository": {
     "type": "git",
     "url": "git://github.com/threepointone/partyserver.git"
@@ -46,13 +46,13 @@
   },
   "peerDependencies": {
     "@cloudflare/workers-types": "^4.20240729.0",
-    "partyserver": "^0.0.55",
+    "partyserver": "^0.0.56",
     "yjs": "^13.6.14"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20240909.0",
+    "@cloudflare/workers-types": "^4.20240925.0",
     "@types/lodash.debounce": "^4.0.9",
-    "partyserver": "^0.0.55",
+    "partyserver": "^0.0.56",
     "ws": "^8.18.0",
     "yjs": "^13.6.19"
   }