Skip to content

appwrite/sdk-for-deno

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Appwrite Deno SDK

⚠️ DEPRECATED: This SDK is deprecated. Please use the Appwrite Node.js SDK with Deno instead.

License Version Build Status Twitter Account Discord

🚨 Migration Notice

This Deno-specific SDK is now deprecated. Thanks to Deno's excellent Node.js compatibility, you can now use the official Appwrite Node.js SDK directly in your Deno applications.

Why migrate?

  • Better maintenance: The Node.js SDK is actively maintained and receives updates faster
  • Feature parity: Access to all the latest Appwrite features
  • Simplified ecosystem: One less SDK to maintain
  • Native compatibility: Deno's built-in Node.js compatibility makes this seamless

How to migrate

Instead of using this deprecated SDK, install and use the Appwrite Node.js SDK:

import * as sdk from "npm:node-appwrite";

That's it! The API is identical, so your existing code will work with minimal changes.

Learn more about Deno + Node.js compatibility


The information below is kept for historical reference but should not be used for new projects.

Appwrite

Installation

⚠️ Use the Node.js SDK instead: import * as sdk from "npm:node-appwrite";

Deprecated installation (do not use):

import * as sdk from "https://deno.land/x/appwrite/mod.ts";

Getting Started

Init your SDK

Initialize your SDK with your Appwrite server API endpoint and project ID which can be found in your project settings page and your new API secret Key from project's API keys section.

let client = new sdk.Client();

client
    .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
    .setProject('5df5acd0d48c2') // Your project ID
    .setKey('919c2d18fb5d4...a2ae413da83346ad2') // Your secret API key
    .setSelfSigned() // Use only on dev mode with a self-signed SSL cert
;

Make your first request

Once your SDK object is set, create any of the Appwrite service objects and choose any request to send. Full documentation for any service method you would like to use can be found in your SDK documentation or in the API References section.

let users = new sdk.Users(client);

let user = await users.create(ID.unique(), "[email protected]", "+123456789", "password", "Walter O'Brien");
console.log(user);

Full Example

import * as sdk from "https://deno.land/x/appwrite/mod.ts";

let client = new sdk.Client();
let users = new sdk.Users(client);

client
    .setEndpoint('https://[HOSTNAME_OR_IP]/v1') // Your API Endpoint
    .setProject('5df5acd0d48c2') // Your project ID
    .setKey('919c2d18fb5d4...a2ae413da83346ad2') // Your secret API key
    .setSelfSigned() // Use only on dev mode with a self-signed SSL cert
;

let user = await users.create(ID.unique(), "[email protected]", "+123456789", "password", "Walter O'Brien");
console.log(user);

Error Handling

The Appwrite Deno SDK raises AppwriteException object with message, code and response properties. You can handle any errors by catching AppwriteException and present the message to the user or handle it yourself based on the provided error information. Below is an example.

let users = new sdk.Users(client);

try {
    let user = await users.create(ID.unique(), "[email protected]", "+123456789", "password", "Walter O'Brien");
} catch(e) {
    console.log(e.message);
}

Learn more

You can use the following resources to learn more and get help

Minimal supported version for Deno SDK is 1.19.0.

Contribution

This library is auto-generated by Appwrite custom SDK Generator. To learn more about how you can help us improve this SDK, please check the contribution guide before sending a pull-request.

License

Please see the BSD-3-Clause license file for more information.

About

[READ-ONLY] Official Appwrite Deno SDK πŸ¦•

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors 11