Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lukas-heinrich/appwrite-function-tools
A collection of utility functions and type definitions for Appwrite functions
https://github.com/lukas-heinrich/appwrite-function-tools
appwrite appwrite-function
Last synced: about 23 hours ago
JSON representation
A collection of utility functions and type definitions for Appwrite functions
- Host: GitHub
- URL: https://github.com/lukas-heinrich/appwrite-function-tools
- Owner: lukas-heinrich
- License: mit
- Created: 2025-02-09T15:43:25.000Z (1 day ago)
- Default Branch: main
- Last Pushed: 2025-02-09T16:00:19.000Z (1 day ago)
- Last Synced: 2025-02-09T16:35:44.843Z (1 day ago)
- Topics: appwrite, appwrite-function
- Language: TypeScript
- Homepage:
- Size: 0 Bytes
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Appwrite Functions Tools
[](https://opensource.org/licenses/MIT)
A TypeScript utility library for [Appwrite Functions](https://appwrite.io/docs/products/functions), providing type
definitions and utilities to interact with requests and handle errors.
⚠️ This package was designed to be used in different runtimes, but it has only been tested using `bun-1.0`. If you
notice any problems feel free to create a pull request.
## Features
- 🦺 Type definitions for Appwrite Functions
- 🛠️ Error handling utilities
- 🔍 Request validation utilities
- 📦 Lightweight path-based router using [route-recognizer](https://www.npmjs.com/package/route-recognizer)
## Usage
### Installation
```bash
# npm
npm install appwrite-function-tools
# pnpm
pnpm add appwrite-function-tools
# bun
bun add appwrite-function-tools
```
### Type Definitions
See the following example based on the appwrite starter function for a basic usage of the type definitions:
```ts
import { FunctionEntrypoint } from 'appwrite-function-tools';
export default async ({ req, res, log, error }: FunctionEntrypoint) => {
// ⬇️ Type Safe access to the request, response, logger and error handler
// You can use the Appwrite SDK to interact with other services
// For this example, we're using the Users service
const client = new Client()
.setEndpoint(Bun.env['APPWRITE_FUNCTION_API_ENDPOINT']) // ⬅️ Type Safe access to the environment variables
.setProject(Bun.env['APPWRITE_FUNCTION_PROJECT_ID'])
.setKey(req.headers['x-appwrite-key'] ?? '');
const users = new Users(client);
try {
const response = await users.list();
// Log messages and errors to the Appwrite Console
// These logs won't be seen by your end users
log(`Total users: ${response.total}`);
} catch (err) {
error('Could not list users: ' + asError(err).message); // ⬅️ Type Safe error handling
}
// The req object contains the request data
if (req.path === '/ping') {
// Use res object to respond with text(), json(), or binary()
// Don't forget to return a response!
return res.text('Pong');
}
return res.json({
motto: 'Build like a team of hundreds_',
learn: 'https://appwrite.io/docs',
connect: 'https://appwrite.io/discord',
getInspired: 'https://builtwith.appwrite.io',
});
};
```
To use the global types, you need to create a `global.d.ts` file in the root of your project. You may want to use it to
declare the environment variables or provide type safety for the Appwrite functions runtime without importing the types.
```ts
import type { FunctionEnvironment } from 'appwrite-function-tools';
// Declare Bun environment variables for the Appwrite functions runtime
declare module 'bun' {
interface Env extends FunctionEnvironment {}
}
export {};
```
### Validation and Routing
... Coming Soon