pantry-sdk
A type-safe helper library for interacting with the Pantry JSON storage API
works in both node, deno and browser
Notice: inactive baskets will be removed after 30 days
usage
First, import the library
import Pantry from "pantry-sdk";
// if you are using deno, add `npm:` specifier
import Pantry from "npm:pantry-sdk";
// you may want import via url
import Pantry from "https://esm.sh/pantry-sdk";Second, initialize the object with PantryID
const client = new Pantry("xxxx-xxxx-xxxx-xxxx-xxxx-xxxx");
// to enable a strict type check when use typescript, do this
const client = new Pantry<true>("xxxx-xxxx-xxxx-xxxx-xxxx-xxxx");
// this will disallow you to store something like Function and Date
// that cannot be represented in JSON formatThen, enjoy!
// The second parameter is the payload that you want your basket to have, it must be an object
// warning: this cannot an array. when typescript is used, it cannot pass the type check if you pass an array
await client.createBasket("ToDoList", { pending: [], complete: [] });
// This action will do a deep merge, rather than simply replace
const mergedToDoList = await client.updateBasket("ToDoList", { pending: ["Walk the Dog"] });
// Get the entire JSON as a parsed javascript object
const myToDoList = await client.getBasket("ToDoList");
// Delete the basket, this cannot be undone
await client.deleteBasket("ToDoList");Or you can use a shortcut to operate on a specific basket
const basket = client.useBasket("ToDoList2");
await basket.create({ pending: [], complete: [] });
const mergedToDoList = await basket.update({ pending: ["Walk the Dog"] });
const myToDoList = await basket.get();
await basket.delete();Get and set your account detail
// Get account detail information
const accountDetails = await client.getDetails();
// Update account information
const updatedAccountDetails = await client.updateDetails({ name: "pantry-sdk", description: "hello, world!" });use fetch
This library requires fetch to work, howerever if the fetch function
is not mounted in global, you can also do this:
import Pantry from "pantry-sdk";
import fetch from "cross-fetch";
const client = new Pantry("xxxx-xxxx-xxxx-xxxx-xxxx-xxxx", fetch);