Huge News!Announcing our $40M Series B led by Abstract Ventures.Learn More →

@gravlabs/appwrite-hono-adapter-bun

Package Overview

Dependencies

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

@gravlabs/appwrite-hono-adapter-bun

This adapter allows you to run your Hono application on Appwrite's **`bun-1.0+`** runtime. **Caution:** this library is in active development and the API is subject to change.

0.5.0
latest
Source
npm

Version published: 4 months ago

Weekly downloads: 1

Maintainers: 0

Weekly downloads

Created: 4 months ago

Source

Appwrite Hono Adapter for Bun

This adapter allows you to run your Hono application on Appwrite's bun-1.0+ runtime. Caution: this library is in active development and the API is subject to change.

[!NOTE] Please carefully read the Requirements. Certain versions of this library will work with select Appwrite bun1.0+ runtimes.

Table of Contents

Installation

You can install it from the npm registry:

bun:
```
bun add hono @gravlabs/appwrite-hono-adapter-bun
```

Usage

Import serve from @gravlabs/appwrite-hono-adapter-bun and write your Hono code like usual. It supports most Hono middleware as well:

import { Hono } from "hono"
import { serve } from "@gravlabs/appwrite-hono-adapter-bun"
import { serveStatic } from "@gravlabs/appwrite-hono-adapter-bun/serveStatic"

const app = new Hono()

app.get("/static/*", serveStatic({
    root: './',
}))

app.get("/", (context) =>
    context.html(`
        <html>
            <h1>Hello world</h1>
        </html>
    `),
)

export default serve(app)

Middleware

Middleware that works for Hono will work with this middleware.

Static Middleware

Use the packaged serveStatic middleware to serve static files. It's best illustrated with an example. If your folder structure looks like so:

.
├── src
│   └── main.js // Appwrite function entry
├── static
│   ├── 1.jpg
│   └── 2.html

Your serveStatic middleware would look like so:

import { serveStatic } from "@gravlabs/appwrite-hono-adapter-bun/serveStatic"

app.use('/static/*', serveStatic({ root: './' }))

And with your folder structure looking like so:

.
└─ src
   ├─ main.js // Appwrite function entry
   └─ static
     ├─ 1.jpg
     └─ 2.html

Your serveStatic middleware would look like so:

import { serveStatic } from "@gravlabs/appwrite-hono-adapter-bun/serveStatic"

app.use('/static/*', serveStatic({ root: './src' }))

Astro Middleware Example

It's really convenient to create an Astro static site with just Appwrite functions:

1. Set up the Adapter

Add the adapter to your astro.config.mjs file.

import { defineConfig } from "astro/config"
import honoAstro from "hono-astro-adapter"

// https://astro.build/config
export default defineConfig({
	output: "server", // or hybrid if you want to use SSR and SSG
	adapter: honoAstro(),
})

2. Build your project

Build your project using the astro build command.

3. Import and set up your Appwrite hook

import { Hono } from "hono";
import { serve } from "@gravlabs/appwrite-hono-adapter-bun"
import { serveStatic } from "@gravlabs/appwrite-hono-adapter-bun/serveStatic"
import { handler as ssrHandler } from "./dist/server/entry.mjs"

const app = new Hono()

app.use("/*", serveStatic({ root: "./dist/client/" }))
app.use(ssrHandler)

export default serve(app)

Typings

You can use the log and error functions from the runtime, as well as have access to the original req and res by accessing the context.env in Hono. You can access the types from

import type { AppwriteBindings } from '@gravlabs/appwrite-hono-adapter-bun/types'

Requirements

Pleae check out which context methods you can use and then install the appropriate version.

Supported Appwrite Function API

Version	Supports	Doesn't Support
`< 1.0.0`	`res.send()` `res.json()` `res.empty()` `res.redirect()`	`res.text()` `res.binary()` `res.start()` `res.writeText()` `res.writeJson()` `res.writeBinary()` `res.end()`
`>=1.0.0 \|\| < 2.0.0`	`res.send()` `res.text()` `res.json()` `res.empty()` `res.redirect()` `res.binary()`	`res.start()` `res.writeText()` `res.writeJson()` `res.writeBinary()` `res.end()`
`>=2.0.0`	`res.send()` `res.text()` `res.json()` `res.empty()` `res.redirect()` `res.binary()` `res.start()` `res.writeText()` `res.writeJson()` `res.writeBinary()` `res.end()`

License

MIT

FAQs

What is @gravlabs/appwrite-hono-adapter-bun?

Is @gravlabs/appwrite-hono-adapter-bun popular?

Is @gravlabs/appwrite-hono-adapter-bun well maintained?

Package last updated on 12 Jul 2024

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install