websocket-foundation v0.0.17

websocket-foundation

Socket.io & mongoDB based websocket server foundation.

Permissions

Default permissions

Entities

Every entity needs a schema to pass the validation step. The Schema is based on Ajv JSON schema validator.

The SocketAccess checks whether the entities exist and create collections if they don't. MongoDB collections are never deleted when you remove existing entities.

Default entities

Socket Access

All generated events expect an authentication. Authenticate yourself via user:login with credentials or userToken:

{
    "username": "",
    "password": ""
}

{
    "userToken": ""
}

Events

The SocketAccess will automatically generate events for your entities in combination with all of your operations and actions.

Example

You are creating a new entity document. The system will create events to communicate with the socket.

Actions

search

Search for specific ids or with multiple mongoDB AND filters.

{
    "ids": [],
    "limit": 50,
    "offset": 0,
    "sort": {},
    "filter": [
        {
            "key": "active",
            "value": true
        }
    ],
    "associations": {}
}

join, leave:

Just add the specific mongoDB document _id to the payload you want to join/leave.

create:

Expects an object payload with your entity required data.

{
    "_id": "6948DF80-14BD-4E04-8842-7668D9C001F1",
    "username": "test",
    "password": "alreadyHashedPassword",
    "firstName": "firstName",
    "lastName": "lastName",
    "email": "test@example.com",
    "active": true,
    "admin": true
}

delete:

Expects an array payload with ids.

{
    "ids": [
        "6948DF80-14BD-4E04-8842-7668D9C001F1",
        "6948DF80-14BD-4E04-8842-7668D9C001F2",
        "6948DF80-14BD-4E04-8842-7668D9C001F3"
    ]
}

replace, update:

Replace is replacing the whole collection entry, update is updating specific fields. Expects an object payload with your entity update/replace required data.