0.0.2 • Published 10 months ago

owl-client v0.0.2

Weekly downloads
-
License
MIT
Repository
github
Last release
10 months ago

OWL never sleeps!

Tiny flagship real time web push notification / message service based on WebSocket. It works on cross browser, cross platform and cross environment. So, waiting for?

Usages

  • Real-time notification
  • Purchase alert
  • Web alert
  • Send LIVE notice
  • Live CHAT
  • Audio call
  • Video call
  • Screen shares
  • Reverse sharing (Live to Local)

Get Started

ES6

npm i -D owl-client

Play with CDN

<script src="//unpkg.com/owl-client" async></script>

Authentication

ES6

// ES6
import Owl from 'owl-client';

// Non-module / CDN
const Owl = window.Owl;

const msg = Owl.init('yourChannelName')

What is channel

Channel is kinda group chat or chat room. You will connect through the channel name your defined. All the data are passes through your channel.

Send your first message

Send message to everyone in the channel

msg.send('Hello world');

// or 

msg.send({
    type: "msg",
    text: "This is a JSON message"
})

Broadcast message to everyone except the sender

msg.broadcast({
    type: "msg",
    text: "This is a JSON message"
})

Send message to specific user

msg.to( 
    user, 
    { type: "msg", text: "This is a JSON message" }
    )

Receive your first message

msg.receive((msg) => {
    console.log('Just received', msg)
});

Other events

msg.connect((data) => {
    // Owl is connected
});

List of all events

connect

disconnect

error

receive

Send message using REST API

You can also send message using REST API following the method bellow

Using CURL

curl https://air.appdets.com/send -a 
   -H "Accept: application/json"
   -d "{\"channel\": \"yourChannelName\", \"message\": \"hello world\"}" 

Using JavaScript

(async function(){
    const req = await fetch('https://air.appdets.com/send', {
        method: "POST",
        headers: {
            "Content-Type": "application/json",
        },
        body: JSON.stringify({ channel: "yourChannelName",  message: "Hello world" })
    }) 

    const res = await req.json()
    console.log(res)
    // {
    // 	"success": true,
    // }
})()

Using WordPress

$response = wp_remote_post('https://air.appdets.com/send', [
    "headers" => [ 
        "Content-Type" =>
        
        "application/json",
    ],
    "body" => [
        "channel" => "yourChannelName",
        "message" => "hello world"
    ]
]); 

$responseBody = json_decode(wp_remote_retrieve_body( $response )); 
 

Early Bird Access!

This is on beta mode, so you have to apply for access before you start.

Please send a request mail to jafrandev@gmail.com with your proper explanation, like what and why you would like to use Owl for your purpose?

Here is a shortlist of question that we need from you;

  • What is your profession?
  • Why you would like to use Owl?
  • What is the basic cases of your usages?
  • How often you will send/receive data? Like N per day.
  • What is the maximum estimated byte size of your each message?

Contribution?

Ops, currently, contribution on this project is OFF. But you have any suggestion, please send us email at jafrandev@gmail.com

0.0.1

10 months ago

1.0.2

10 months ago

0.0.2

10 months ago

1.0.1

2 years ago

1.0.0

2 years ago