dSock Go Client

Go client for dSock.

Installation

go get github.com/Cretezy/dSock-go

Usage

import "github.com/Cretezy/dSock-go"

dSockClient := dsock.NewClient(dSockUrl, dSockToken)

Create claim

Create a claim for user authentication.

claim, err := dSockClient.CreateClaim(dsock.CreateClaimOptions{
    User: "user",
    // optional
    Session:  "session",
    Id:       "id",
    Channels: []string{"channel"},
    // either or
    Duration:   30,         // in seconds
    Expiration: 1600000000, // in seconds since epoch
})

Send message

Send a message to a target (one or many clients).

err := dSockClient.SendMessage(dsock.SendMessageOptions{
    Type:    "text", // or `binary`
    Message: []byte("hello world"),
    // target (choose one or many)
    Target: dsock.Target{
        User:    "user",
        Session: "session",
        Id:      "id",
        Channel: "channel",
    },
})

Disconnecting

Disconnect a target (one or many clients).

err := dSockClient.Disconnect(dsock.DisconnectOptions{
    // target (choose one or many)
    Target: dsock.Target{
        User:    "user",
        Session: "session",
        Id:      "id",
        Channel: "channel",
    },
})

Info

Get claim and connection info from a target (one or many clients).

info, err := dSockClient.GetInfo(dsock.GetInfoOptions{
    // target (choose one or many)
    Target: dsock.Target{
        User:    "user",
        Session: "session",
        Id:      "id",
        Channel: "channel",
    },
})

Channels

Subscribe/unsubscribe a target to a channel (one or many clients).

err := dSockClient.SubscribeChannel(dsock.ChannelOptions{
    Channel: "new_channel",
    // Should claims also be subscribed?
    IgnoreClaims: true,
    // target (choose one or many)
    Target: dsock.Target{
        User:    "user",
        Session: "session",
        Id:      "id",
        Channel: "channel",
    },
})


err := dSockClient.UnsubscribeChannel(dsock.ChannelOptions{
    Channel: "remove_channel",
    // Should claims also be unsubscribed?
    IgnoreClaims: true,
    // target (choose one or many)
    Target: dsock.Target{
        User:    "user",
        Session: "session",
        Id:      "id",
        Channel: "channel",
    },
})

License

MIT