Skip to content

A Cloudflare worker to generate OpenGraph banner, configured specifically for Digital Desa Profile Website.

License

Notifications You must be signed in to change notification settings

slainless/digides-ogimaker

Repository files navigation

digides-ogimaker

digides-ogimaker (Digital Desa OG Image Maker), a cloudflare worker to generate OpenGraph banner, configured specifically for Digital Desa Profile Website.

Using Hono for edge framework, while Go is used to draw the image.

Live at https://og-image-generator.digital-desa.workers.dev/.

Click here to view render example.

Note

Previous WASM version available at https://github.com/slainless/digides-ogimage.

Known issue

The worker will always (weirdly) throw error but not providing any meaningful error trace.

[wrangler:inf] GET / 200 OK (44ms)
✘ [ERROR] Uncaught (in promise) Response


✘ [ERROR] Uncaught (async) Error: #<Response>

But it's pretty much safe to ignore since it's uncaught and not affecting the service at all. I don't know why in hell would WebAssembly.Instance instantiation throws error.

Difference with previous repository

This project is built on top of WASIP1 instead of javascript WASM. The flow of data is greatly simplified, reading data from stdin and write to stdout. Since there is no necessity for memory reading yet, the WASI code is pretty simple.

Since previous version relies a lot on faulty implementations based on syscall/js, it's failed to create a proper stream from JPEG encoder to worker response output. It's not the case for this version since we are working directly on io.Writer provided by worker's TransformStream.

Rendering bug on previous repo is also fixed by default by changing the OS to WASIP1.

This project can also be built with tinygo easily with no code change, but it's not working properly in production (on worker); It will return broken image.

Performance

Managed to hit TTFB at average 0.2ms~0.5ms and streamed the response at average ~1s. The biggest bottleneck in this case is the JPEG encoder. IMAGE_QUALITY env can be used to set encoding output quality and possibly reduce encoding time (?).

Also, since we are streaming the result of JPEG encoder directly to WASI preopens stdout and worker environment piped it to the response body, we essentially created a true stream. This allows our service to be truly responsive by returning the first byte early and offsetting the penalty of long encoding time by slowing down and syncing the download timing with encoding process. This will also reduce the risk of timeout occuring on open-graph consumer and hopefully will resolve "image preview not showing" issue on some chat apps, which we think are caused by timeout.

Future plan

This repo is production ready, with WASM loaded correctly and service running.

Considering that cloudflare WebGPU API is not ready yet (and even then, it's only supported on Durable Objects), the only choice is to render using CPU. Not that I know how to program using WebGPU (I wish I have time to learn it), but it's the best option for graphic drawing in Cloudflare Worker.

I'm thinking of incorporating libvips either via C binding (if at all possible) or by running wasm runtime on Go to load another wasm, don't know if this is even possible.

About

A Cloudflare worker to generate OpenGraph banner, configured specifically for Digital Desa Profile Website.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published