Nostradamus Predicting Maelstroms

    TypeScript icon, indicating that this package has built-in type declarations

    1.0.12 • Public • Published


    A Node.js client for working with ServerlessHQ. Use this only if there isn't a premade adapter for the framework you are using.

    Getting Started

    1. npm install --save @serverlesshq/nodejs
    2. Create a client using your secret token from ServerlessHQ
    import Client from "@serverlesshq/nodejs"
    const client = new Client("secret token here")
    1. Enqueue a job
    // this will be useful for viewing analytics about your jobs
    const queueName = "anything/you/want"
    // the data your job needs to operate, can be any javascript object
    const jobPayload = { key: value }
    // the callback url to use to handle the job
    const callbackUrl = ""
    await client.enqueue({ queueName, payloadJSON, callbackUrl })
    1. Handle the callback request and perform the job
    // depending on the framework you are using this will be different
    // but you'll need some way to receive incoming requests to a specific endpoint'/api/queues/queue-name', (req, res) => {
        const webhookSignature = req.headers['shq-webhook-signature']
        const rawPayload = req.body
        // verify the request is coming from
        const jobPayload = client.verifyAndDecrypt(rawPayload, webhookSignature)
        if(!jobPayload) {
            res.status(200).json("{error: 'invalid signature'}")
        // actually do the job using data in jobPayload      

    End-to-End Encryption

    ServerlessHQ supports encrypting the job payload data so that our servers never have access to potentially sensitive information. To enable this feature simply set a 32 character encryption key using the environment variable SHQ_ENCRYPTION_KEY and the client library will automatically encrypt and decrypt the payload using this key.


    npm i @serverlesshq/nodejs

    DownloadsWeekly Downloads






    Unpacked Size

    25.2 kB

    Total Files


    Last publish


    • johncantrell97