cloudflare

JavaScript utils for Cloudflare dev services.

Install

npm install treeder/flaregun

Extra database features

In your workers or pages functions, initialize with the binding:

import { D1 } from 'flaregun'

// D1
let d1 = new D1(env.D1) // just adds some extra functionality to the built in d1 interface, you can still use it just as you normally would too.

// then you can use the new functions
// insert new data
await d1.insert('users', {name: 'Jimbo', email: 'x@y.com'})

// update a row
await d1.update('users', user.id, {name: 'Jim Bean'})

// querying
let users = await globals.d1.query('users', {
    where: [['orgID', '==', orgID], ['createdAt', '>', new Date(Date.now() - 48 * 60 * 60 * 1000)]],
})

Logging with Baselime

You will need to set a BASELIME_API_KEY environment variable.

In order to use Baselime's request grouping, make a new logger for each request, for instance in _worker.js or in your function:

import { BaselimeLogger } from 'flaregun/baselime-logger.js'
import { nanoid } from 'nanoid'

export default {
    async fetch(req, env, ctx) {
        const url = new URL(req.url)
        req.logger = new BaselimeLogger({
            service: `myservice-${env.ENV}`,
            apiKey: env.BASELIME_API_KEY,
            ctx: ctx,
            requestId: nanoid(),
            namespace: `${req.method} ${url.pathname}`,
            isLocal: env.IS_LOCAL, // this will print to console.log, but not send logs to Baselime
        })
        const startTime = Date.now()

        // DO STUFF HERE
        let res = new Response('hello world')
        
        // Then flush the logs
        const duration = Date.now() - startTime
        req.logger.logd("end of request", { duration }) // to use Baselime's duration feature
        ctx.waitUntil(req.logger.flush())
        return res
    },
}