messager is a service or self-hosted messaging queue.

messager is intended to:

• be a centralized, single messaging space for multi-project software systems;
• handle publish/subscribe, notify across multiple users, tokens, domains.

messager has clients for:

• NodeJS;
• Python.

The messager-server uses plurid to explore information as a 3D structure.

Contents

• About
• Client
  • Support
  • Configuration
• Server
  • Building
  • Testing
• Packages
• Codeophon

About

messager acts as a central messaging service. Once configured with a token, the messager client can point to the network endpoint, passing the token.

Client

Support

messager has client support for

• NodeJS
• Python

Server

Building

docker build \
    -t messager-server \
    -f ./configurations/production.dockerfile \
    --build-arg PORT=56965 \
    --build-arg MESSAGER_ENDPOINT_GRAPHQL=/ \
    --build-arg MESSAGER_DATABASE_TYPE=mongo \
    --build-arg MESSAGER_LOG_LEVEL=0 \
    --build-arg MESSAGER_QUIET=false \
    --build-arg MESSAGER_CUSTOM_LOGIC_USAGE=false \
    --build-arg MESSAGER_PRIVATE_USAGE=true \
    --build-arg MESSAGER_PRIVATE_OWNER_IDENTONYM=identonym \
    --build-arg MESSAGER_PRIVATE_OWNER_KEY=key \
    --build-arg MESSAGER_PRIVATE_TOKEN=secret-token \
    --build-arg MESSAGER_MONGO_USERNAME=admin \
    --build-arg MESSAGER_MONGO_PASSWORD=1234 \
    --build-arg MESSAGER_MONGO_ADDRESS=localhost:56966 \
    --build-arg MESSAGER_MONGO_CONNECTION_STRING= \
    --build-arg MESSAGER_TEST_MODE=true \
    --build-arg MESSAGER_OPTIMIZATION_BATCH_WRITE_SIZE=1000 \
    --build-arg MESSAGER_OPTIMIZATION_BATCH_WRITE_TIME=2000 \
    .

Run the container with --network="host" if running the database on the same host.

docker run \
    --network="host" \
    -d messager-server

Or run on a custom port (8855)

docker run \
    -d -p 8855:56965 \
    messager-server

Testing

The messager server can use MongoDB as a database. For testing purposes, mongo can run in a docker container.

docker pull mongo

docker run -d --name mongo-messager \
    -p 56966:27017 -e MONGO_INITDB_ROOT_USERNAME=admin \
    -e MONGO_INITDB_ROOT_PASSWORD=1234 mongo

Connect to the mongo instance with

mongodb://admin:1234@localhost:56966/?authSource=admin

to verify the connection.

Packages

@plurid/messager-server • the server application

@plurid/messager-client-javascript • the NodeJS client

@plurid/messager-client-python • the Python client

Codeophon

• licensing: delicense
• versioning: αver