proto.io 0.0.172 → 0.0.174

package/dist/client.d.ts

@@ -1,7 +1,7 @@
-import { P as ProtoClient } from './internals/index-DchUjNEf.js';
-export { c as classExtends, e as isFile, a as isObject, i as isQuery, d as isRole, b as isUser } from './internals/index-DchUjNEf.js';
+import { P as ProtoClient } from './internals/index-uwXdnxqN.js';
+export { c as classExtends, e as isFile, a as isObject, i as isQuery, d as isRole, b as isUser } from './internals/index-uwXdnxqN.js';
 export { Decimal } from 'decimal.js';
-export { D as DeserializeOptions, S as SerializeOptions, d as TSerializable, e as deserialize, s as serialize } from './internals/index-BhWRmBiq.js';
+export { D as DeserializeOptions, S as SerializeOptions, d as TSerializable, e as deserialize, s as serialize } from './internals/index-CE5tdYK8.js';
 import '@o2ter/utils-js';
 import 'socket.io-client';
 import '@socket.io/component-emitter';

package/dist/client.js

@@ -2,9 +2,9 @@
 
 Object.defineProperty(exports, '__esModule', { value: true });
 
-var index = require('./internals/index-BJP46VGq.js');
+var index = require('./internals/index-S_gTMQBh.js');
 var Decimal = require('decimal.js');
-require('./internals/index-CVutVPmd.js');
+require('./internals/index-DXuW8UiB.js');
 require('lodash');
 require('./internals/private-CSB1Ep4g.js');
 require('@o2ter/utils-js');

package/dist/client.mjs

@@ -1,7 +1,7 @@
-import { c as ProtoClient } from './internals/index-D0hHgn2P.mjs';
-export { e as classExtends, d as deserialize, j as isFile, f as isObject, i as isQuery, h as isRole, g as isUser, s as serialize } from './internals/index-D0hHgn2P.mjs';
+import { c as ProtoClient } from './internals/index-R0gbIGc-.mjs';
+export { e as classExtends, d as deserialize, j as isFile, f as isObject, i as isQuery, h as isRole, g as isUser, s as serialize } from './internals/index-R0gbIGc-.mjs';
 export { Decimal } from 'decimal.js';
-import './internals/index-BYbMU-Ao.mjs';
+import './internals/index--ifyu-GL.mjs';
 import 'lodash';
 import './internals/private-BUpLAMZi.mjs';
 import '@o2ter/utils-js';

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 import * as socket_io from 'socket.io';
 import { Router } from 'express';
 import { Server } from '@o2ter/server-js';
-import { T as TSchema, _ as _TValue, P as ProtoService, a as ProtoServiceOptions, b as ProtoServiceKeyOptions } from './internals/index-BhWRmBiq.js';
-export { D as DeserializeOptions, S as SerializeOptions, c as TFileStorage, d as TSerializable, e as deserialize, s as serialize } from './internals/index-BhWRmBiq.js';
+import { T as TSchema, _ as _TValue, P as ProtoService, a as ProtoServiceOptions, b as ProtoServiceKeyOptions } from './internals/index-CE5tdYK8.js';
+export { D as DeserializeOptions, S as SerializeOptions, c as TFileStorage, d as TSerializable, e as deserialize, s as serialize } from './internals/index-CE5tdYK8.js';
 import Decimal from 'decimal.js';
 export { Decimal } from 'decimal.js';
-export { P as ProtoClient, c as classExtends, e as isFile, a as isObject, i as isQuery, d as isRole, b as isUser } from './internals/index-DchUjNEf.js';
+export { P as ProtoClient, c as classExtends, e as isFile, a as isObject, i as isQuery, d as isRole, b as isUser } from './internals/index-uwXdnxqN.js';
 import '@o2ter/utils-js';
 import 'jsonwebtoken';
 import 'lodash';
@@ -13,57 +13,129 @@ import 'node:stream';
 import 'socket.io-client';
 import '@socket.io/component-emitter';
 
+/**
+ * Schema definition utility functions.
+ */
 declare const schema: ((x: Record<string, TSchema>) => Record<string, TSchema>) & {
+    /**
+     * Defines a boolean schema.
+     * @param defaultValue - The default value for the boolean.
+     * @returns The boolean schema.
+     */
     boolean: (defaultValue?: boolean) => {
         readonly type: "boolean";
         readonly default: boolean | undefined;
     };
+    /**
+     * Defines a number schema.
+     * @param defaultValue - The default value for the number.
+     * @returns The number schema.
+     */
     number: (defaultValue?: number) => {
         readonly type: "number";
         readonly default: number | undefined;
     };
+    /**
+     * Defines a decimal schema.
+     * @param defaultValue - The default value for the decimal.
+     * @returns The decimal schema.
+     */
     decimal: (defaultValue?: Decimal) => {
         readonly type: "decimal";
         readonly default: Decimal | undefined;
     };
+    /**
+     * Defines a string schema.
+     * @param defaultValue - The default value for the string.
+     * @returns The string schema.
+     */
     string: (defaultValue?: string) => {
         readonly type: "string";
         readonly default: string | undefined;
     };
+    /**
+     * Defines a date schema.
+     * @param defaultValue - The default value for the date.
+     * @returns The date schema.
+     */
     date: (defaultValue?: Date) => {
         readonly type: "date";
         readonly default: Date | undefined;
     };
+    /**
+     * Defines an object schema.
+     * @param defaultValue - The default value for the object.
+     * @returns The object schema.
+     */
     object: <T extends Record<string, _TValue>>(defaultValue?: T) => {
         readonly type: "object";
         readonly default: T | undefined;
     };
+    /**
+     * Defines an array schema.
+     * @param defaultValue - The default value for the array.
+     * @returns The array schema.
+     */
     array: <T extends _TValue[]>(defaultValue?: T) => {
         readonly type: "array";
         readonly default: T | undefined;
     };
+    /**
+     * Defines a vector schema.
+     * @param dimension - The dimension of the vector.
+     * @param defaultValue - The default value for the vector.
+     * @returns The vector schema.
+     */
     vector: (dimension: number, defaultValue?: number[]) => {
         readonly type: "vector";
         readonly dimension: number;
         readonly default: number[] | undefined;
     };
+    /**
+     * Defines a shape schema.
+     * @param shape - The shape definition.
+     * @returns The shape schema.
+     */
     shape: (shape: Record<string, TSchema.DataType>) => {
         readonly type: "shape";
         readonly shape: Record<string, TSchema.DataType>;
     };
+    /**
+     * Defines a pointer schema.
+     * @param target - The target of the pointer.
+     * @returns The pointer schema.
+     */
     pointer: (target: string) => {
         readonly type: "pointer";
         readonly target: string;
     };
+    /**
+     * Defines a relation schema.
+     * @param target - The target of the relation.
+     * @param foreignField - The foreign field of the relation.
+     * @returns The relation schema.
+     */
     relation: (target: string, foreignField?: string) => {
         readonly type: "relation";
         readonly target: string;
         readonly foreignField: string | undefined;
     };
 };
+/**
+ * Creates a ProtoRoute.
+ * @param options - The options for the ProtoRoute.
+ * @returns A promise that resolves to a Router.
+ */
 declare const ProtoRoute: <E>(options: {
     proto: ProtoService<E> | (ProtoServiceOptions<E> & ProtoServiceKeyOptions);
 }) => Promise<Router>;
+/**
+ * Registers a ProtoSocket.
+ * @param proto - The ProtoService instance.
+ * @param server - The server instance.
+ * @param endpoint - The optional endpoint.
+ * @returns The socket.io instance.
+ */
 declare const registerProtoSocket: <E>(proto: ProtoService<E>, server: Server, endpoint?: string) => socket_io.Server<socket_io.DefaultEventsMap, socket_io.DefaultEventsMap, socket_io.DefaultEventsMap, any> | socket_io.Namespace<socket_io.DefaultEventsMap, socket_io.DefaultEventsMap, socket_io.DefaultEventsMap, any>;
 
 export { ProtoRoute, ProtoService, ProtoRoute as default, registerProtoSocket, schema };

package/dist/index.js

@@ -4,18 +4,18 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var _ = require('lodash');
 var serverJs = require('@o2ter/server-js');
-var random = require('./internals/random-Dytum6Nh.js');
+var random = require('./internals/random-DVOUDDGg.js');
 var _private = require('./internals/private-CSB1Ep4g.js');
 var utilsJs = require('@o2ter/utils-js');
-var index = require('./internals/index-BJP46VGq.js');
-var index$1 = require('./internals/index-CVutVPmd.js');
+var index = require('./internals/index-S_gTMQBh.js');
+var index$1 = require('./internals/index-DXuW8UiB.js');
 var jwt = require('jsonwebtoken');
 var node_buffer = require('node:buffer');
 var node_stream = require('node:stream');
 var node_crypto = require('node:crypto');
 var util = require('util');
 var cryptoJs = require('@o2ter/crypto-js');
-var index$2 = require('./internals/index-CzfsyXvb.js');
+var index$2 = require('./internals/index-Dc3V_Bzw.js');
 var queryType = require('query-types');
 var busboy = require('busboy');
 var Decimal = require('decimal.js');
@@ -186,6 +186,13 @@ const dispatcher = (proto, options, disableSecurity) => {
                 throw Error('No permission');
             return proto.storage.atomic((storage) => storage.updateOne(_validator.decodeQuery(normalize(query), 'update'), normalize(_validator.validateFields(query.className, update, 'update', random.QueryValidator.patterns.path))));
         },
+        async updateMany(query, update) {
+            random.QueryValidator.recursiveCheck(query, update);
+            const _validator = await validator();
+            if (!_validator.validateCLPs(query.className, 'update'))
+                throw Error('No permission');
+            return proto.storage.atomic((storage) => storage.updateMany(_validator.decodeQuery(normalize(query), 'update'), normalize(_validator.validateFields(query.className, update, 'update', random.QueryValidator.patterns.path))));
+        },
         async upsertOne(query, update, setOnInsert) {
             random.QueryValidator.recursiveCheck(query, update, setOnInsert);
             const _validator = await validator();
@@ -205,6 +212,25 @@ const dispatcher = (proto, options, disableSecurity) => {
                 }
             }
         },
+        async upsertMany(query, update, setOnInsert) {
+            random.QueryValidator.recursiveCheck(query, update, setOnInsert);
+            const _validator = await validator();
+            if (!_validator.validateCLPs(query.className, 'create', 'update'))
+                throw Error('No permission');
+            const _query = _validator.decodeQuery(normalize(query), 'update');
+            const _update = normalize(_validator.validateFields(query.className, update, 'update', random.QueryValidator.patterns.path));
+            const _setOnInsert = normalize(_validator.validateFields(query.className, setOnInsert, 'create', random.QueryValidator.patterns.name));
+            while (true) {
+                try {
+                    return await proto.storage.atomic((storage) => storage.upsertMany(_query, _update, _setOnInsert), { lockTable: query.className, retry: true });
+                }
+                catch (e) {
+                    if (proto.storage.isDuplicateIdError(e))
+                        continue;
+                    throw e;
+                }
+            }
+        },
         async deleteOne(query) {
             random.QueryValidator.recursiveCheck(query);
             const _validator = await validator();
@@ -386,7 +412,12 @@ class _ProtoQuery extends index.TQuery {
         if (!result)
             throw Error('Unable to insert document');
         if (_.isFunction(afterSave)) {
-            await afterSave(proxy(Object.setPrototypeOf({ object: result, context }, options?.session ?? this._proto)));
+            try {
+                await afterSave(proxy(Object.setPrototypeOf({ object: result.clone(), context }, options?.session ?? this._proto)));
+            }
+            catch (e) {
+                console.error(e);
+            }
         }
         return result;
     }
@@ -414,7 +445,14 @@ class _ProtoQuery extends index.TQuery {
                 matches: this[_private.PVK].options.matches,
             }, _.map(objects, x => _.fromPairs([...x._set_entries()])));
             if (_.isFunction(afterSave)) {
-                await Promise.all(_.map(objects, object => afterSave(proxy(Object.setPrototypeOf({ object, context }, options?.session ?? this._proto)))));
+                await Promise.all(_.map(objects, async (object) => {
+                    try {
+                        await afterSave(proxy(Object.setPrototypeOf({ object: object.clone(), context }, options?.session ?? this._proto)));
+                    }
+                    catch (e) {
+                        console.error(e);
+                    }
+                }));
             }
             return objects.length;
         }
@@ -439,10 +477,49 @@ class _ProtoQuery extends index.TQuery {
         }
         const result = this._objectMethods(await this._dispatcher(options).updateOne(this._queryOptions, update));
         if (result && _.isFunction(afterSave)) {
-            await afterSave(proxy(Object.setPrototypeOf({ object: result, context }, options?.session ?? this._proto)));
+            try {
+                await afterSave(proxy(Object.setPrototypeOf({ object: result.clone(), context }, options?.session ?? this._proto)));
+            }
+            catch (e) {
+                console.error(e);
+            }
         }
         return result;
     }
+    async updateMany(update, options) {
+        const context = options?.context ?? {};
+        const silent = _.castArray(options?.silent ?? []);
+        const beforeSave = _.includes(silent, 'beforeSave') ? null : this._proto[_private.PVK].triggers?.beforeSave?.[this.className];
+        const afterSave = _.includes(silent, 'afterSave') ? null : this._proto[_private.PVK].triggers?.afterSave?.[this.className];
+        if (_.isFunction(beforeSave) || _.isFunction(afterSave)) {
+            const objects = this._objectMethods(await utilsJs.asyncIterableToArray(this._dispatcher(options).find(this._queryOptions)));
+            if (_.isEmpty(objects))
+                return 0;
+            if (_.isFunction(beforeSave)) {
+                await Promise.all(_.map(objects, object => beforeSave(proxy(Object.setPrototypeOf({ object, context }, options?.session ?? this._proto)))));
+            }
+            if (!_.isFunction(afterSave)) {
+                return this._dispatcher(options).updateMany({
+                    ...this._queryOptions,
+                    filter: { _id: { $in: _.map(objects, x => x.objectId) } },
+                }, update);
+            }
+            const updated = _.compact(await Promise.all(_.map(objects, x => this._dispatcher(options).updateOne({
+                ...this._queryOptions,
+                filter: { _id: { $eq: x.objectId } },
+            }, update))));
+            await Promise.all(_.map(updated, async (object) => {
+                try {
+                    await afterSave(proxy(Object.setPrototypeOf({ object: object.clone(), context }, options?.session ?? this._proto)));
+                }
+                catch (e) {
+                    console.error(e);
+                }
+            }));
+            return updated.length;
+        }
+        return this._dispatcher(options).updateMany(this._queryOptions, update);
+    }
     async upsertOne(update, setOnInsert, options) {
         const context = options?.context ?? {};
         const silent = _.castArray(options?.silent ?? []);
@@ -477,10 +554,68 @@ class _ProtoQuery extends index.TQuery {
         if (!result)
             throw Error('Unable to upsert document');
         if (_.isFunction(afterSave)) {
-            await afterSave(proxy(Object.setPrototypeOf({ object: result, context }, options?.session ?? this._proto)));
+            try {
+                await afterSave(proxy(Object.setPrototypeOf({ object: result.clone(), context }, options?.session ?? this._proto)));
+            }
+            catch (e) {
+                console.error(e);
+            }
         }
         return result;
     }
+    async upsertMany(update, setOnInsert, options) {
+        const context = options?.context ?? {};
+        const silent = _.castArray(options?.silent ?? []);
+        const beforeSave = _.includes(silent, 'beforeSave') ? null : this._proto[_private.PVK].triggers?.beforeSave?.[this.className];
+        const afterSave = _.includes(silent, 'afterSave') ? null : this._proto[_private.PVK].triggers?.afterSave?.[this.className];
+        if (_.isFunction(beforeSave) || _.isFunction(afterSave)) {
+            const objects = this._objectMethods(await utilsJs.asyncIterableToArray(this._dispatcher(options).find(this._queryOptions)));
+            if (!_.isEmpty(objects) && _.isFunction(beforeSave)) {
+                await Promise.all(_.map(objects, object => beforeSave(proxy(Object.setPrototypeOf({ object, context }, options?.session ?? this._proto)))));
+            }
+            if (_.isEmpty(objects)) {
+                const result = await this._dispatcher(options).insert({
+                    className: this.className,
+                    includes: this[_private.PVK].options.includes,
+                    matches: this[_private.PVK].options.matches,
+                }, setOnInsert);
+                if (!result)
+                    throw Error('Unable to insert document');
+                if (_.isFunction(afterSave)) {
+                    try {
+                        await afterSave(proxy(Object.setPrototypeOf({ object: result.clone(), context }, options?.session ?? this._proto)));
+                    }
+                    catch (e) {
+                        console.error(e);
+                    }
+                }
+                return { updated: 0, inserted: 1 };
+            }
+            if (!_.isFunction(afterSave)) {
+                return {
+                    inserted: 0,
+                    updated: await this._dispatcher(options).updateMany({
+                        ...this._queryOptions,
+                        filter: { _id: { $in: _.map(objects, x => x.objectId) } },
+                    }, update),
+                };
+            }
+            const updated = _.compact(await Promise.all(_.map(objects, x => this._dispatcher(options).updateOne({
+                ...this._queryOptions,
+                filter: { _id: { $eq: x.objectId } },
+            }, update))));
+            await Promise.all(_.map(updated, async (object) => {
+                try {
+                    await afterSave(proxy(Object.setPrototypeOf({ object: object.clone(), context }, options?.session ?? this._proto)));
+                }
+                catch (e) {
+                    console.error(e);
+                }
+            }));
+            return { updated: updated.length, inserted: 0 };
+        }
+        return this._dispatcher(options).upsertMany(this._queryOptions, update, setOnInsert);
+    }
     async deleteOne(options) {
         const context = options?.context ?? {};
         const silent = _.castArray(options?.silent ?? []);
@@ -501,7 +636,12 @@ class _ProtoQuery extends index.TQuery {
             result = this._objectMethods(await this._dispatcher(options).deleteOne(this._queryOptions));
         }
         if (result && _.isFunction(afterDelete)) {
-            await afterDelete(proxy(Object.setPrototypeOf({ object: result, context }, options?.session ?? this._proto)));
+            try {
+                await afterDelete(proxy(Object.setPrototypeOf({ object: result.clone(), context }, options?.session ?? this._proto)));
+            }
+            catch (e) {
+                console.error(e);
+            }
         }
         return result;
     }
@@ -522,7 +662,14 @@ class _ProtoQuery extends index.TQuery {
                 filter: { _id: { $in: _.map(objects, x => x.objectId) } },
             });
             if (_.isFunction(afterDelete)) {
-                await Promise.all(_.map(objects, object => afterDelete(proxy(Object.setPrototypeOf({ object, context }, options?.session ?? this._proto)))));
+                await Promise.all(_.map(objects, async (object) => {
+                    try {
+                        await afterDelete(proxy(Object.setPrototypeOf({ object: object.clone(), context }, options?.session ?? this._proto)));
+                    }
+                    catch (e) {
+                        console.error(e);
+                    }
+                }));
             }
             return objects.length;
         }
@@ -1445,8 +1592,8 @@ class ProtoService extends index.ProtoType {
     }
     async userRoles(user) {
         const self = this;
+        const { inheritKeys, resolver } = self[_private.PVK].options.roleResolver;
         const defaultResolver = async () => {
-            const inheritKeys = self[_private.PVK].options.roleResolver?.inheritKeys ?? [];
             const schema = self.schema;
             const userKeys = _.filter(inheritKeys, k => {
                 const type = random.resolveDataType(schema, 'Role', k);
@@ -1471,7 +1618,6 @@ class ProtoService extends index.ProtoType {
             }
             return roles;
         };
-        const resolver = self[_private.PVK].options.roleResolver?.resolver;
         if (resolver)
             return resolver(user, defaultResolver);
         return defaultResolver();
@@ -1779,7 +1925,9 @@ var classesRoute = (router, proto) => {
             case 'insert': return query.insert(attributes, opts);
             case 'insertMany': return query.insertMany(attributes, opts);
             case 'updateOne': return query.updateOne(update, opts);
+            case 'updateMany': return query.updateMany(update, opts);
             case 'upsertOne': return query.upsertOne(update, setOnInsert, opts);
+            case 'upsertMany': return query.upsertMany(update, setOnInsert, opts);
             case 'deleteOne': return query.deleteOne(opts);
             case 'deleteMany': return query.deleteMany(opts);
             default: throw Error('Invalid operation');
@@ -1883,6 +2031,16 @@ var classesRoute = (router, proto) => {
         const payload = proto.connect(req);
         await response(res, async () => payload.refs(payload.Object(name, id), { master: payload.isMaster }));
     });
+    router.patch('/classes/:name', serverJs.Server.text({ type: '*/*' }), async (req, res) => {
+        res.setHeader('Cache-Control', ['no-cache', 'no-store']);
+        const { name } = req.params;
+        const classes = proto.classes();
+        if (!_.includes(classes, name))
+            return void res.sendStatus(404);
+        const payload = proto.connect(req);
+        const update = _.mapValues(index.deserialize(req.body), v => ({ $set: v }));
+        await response(res, () => createQuery(payload, req, false).updateMany(update, { master: payload.isMaster }));
+    });
     router.patch('/classes/:name/:id', serverJs.Server.text({ type: '*/*' }), async (req, res) => {
         res.setHeader('Cache-Control', ['no-cache', 'no-store']);
         const { name, id } = req.params;
@@ -2274,19 +2432,84 @@ var configRoute = (router, proto) => {
 //  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 //  THE SOFTWARE.
 //
+/**
+ * Schema definition utility functions.
+ */
 const schema = _.assign((x) => x, {
+    /**
+     * Defines a boolean schema.
+     * @param defaultValue - The default value for the boolean.
+     * @returns The boolean schema.
+     */
     boolean: (defaultValue) => ({ type: 'boolean', default: defaultValue }),
+    /**
+     * Defines a number schema.
+     * @param defaultValue - The default value for the number.
+     * @returns The number schema.
+     */
     number: (defaultValue) => ({ type: 'number', default: defaultValue }),
+    /**
+     * Defines a decimal schema.
+     * @param defaultValue - The default value for the decimal.
+     * @returns The decimal schema.
+     */
     decimal: (defaultValue) => ({ type: 'decimal', default: defaultValue }),
+    /**
+     * Defines a string schema.
+     * @param defaultValue - The default value for the string.
+     * @returns The string schema.
+     */
     string: (defaultValue) => ({ type: 'string', default: defaultValue }),
+    /**
+     * Defines a date schema.
+     * @param defaultValue - The default value for the date.
+     * @returns The date schema.
+     */
     date: (defaultValue) => ({ type: 'date', default: defaultValue }),
+    /**
+     * Defines an object schema.
+     * @param defaultValue - The default value for the object.
+     * @returns The object schema.
+     */
     object: (defaultValue) => ({ type: 'object', default: defaultValue }),
+    /**
+     * Defines an array schema.
+     * @param defaultValue - The default value for the array.
+     * @returns The array schema.
+     */
     array: (defaultValue) => ({ type: 'array', default: defaultValue }),
+    /**
+     * Defines a vector schema.
+     * @param dimension - The dimension of the vector.
+     * @param defaultValue - The default value for the vector.
+     * @returns The vector schema.
+     */
     vector: (dimension, defaultValue) => ({ type: 'vector', dimension, default: defaultValue }),
+    /**
+     * Defines a shape schema.
+     * @param shape - The shape definition.
+     * @returns The shape schema.
+     */
     shape: (shape) => ({ type: 'shape', shape }),
+    /**
+     * Defines a pointer schema.
+     * @param target - The target of the pointer.
+     * @returns The pointer schema.
+     */
     pointer: (target) => ({ type: 'pointer', target }),
+    /**
+     * Defines a relation schema.
+     * @param target - The target of the relation.
+     * @param foreignField - The foreign field of the relation.
+     * @returns The relation schema.
+     */
     relation: (target, foreignField) => ({ type: 'relation', target, foreignField }),
 });
+/**
+ * Creates a ProtoRoute.
+ * @param options - The options for the ProtoRoute.
+ * @returns A promise that resolves to a Router.
+ */
 const ProtoRoute = async (options) => {
     const proto = options.proto instanceof ProtoService ? options.proto : new ProtoService(options.proto);
     await proto[_private.PVK].prepare();
@@ -2309,6 +2532,13 @@ const ProtoRoute = async (options) => {
     configRoute(router, proto);
     return router;
 };
+/**
+ * Registers a ProtoSocket.
+ * @param proto - The ProtoService instance.
+ * @param server - The server instance.
+ * @param endpoint - The optional endpoint.
+ * @returns The socket.io instance.
+ */
 const registerProtoSocket = (proto, server, endpoint) => {
     const io = endpoint ? server.socket().of(endpoint) : server.socket();
     io.on('connection', async (socket) => {