# About
`@sodiumlabs/plume-url` is a module that allows you to easily use Plume URL.
# Installation
```sh
npm install @sodiumlabs/plume-url
```
# Links
- [Plume URL](https://url.sodiumlabs.xyz)
- [Plume URL documentation](https://url.sodiumlabs.xyz/docs)
- [Module references](#references)
- [Discord server](https://discord.gg/8PDXWSHH7k)
- [GitHub](https://github.com/sodium-labs/plume-url.js)
- [npm](https://npmjs.com/package/@sodiumlabs/plume-url)
- [Sodium Labs](https://sodiumlabs.xyz)
# Examples
If you are developing a Discord bot using `discord.js`, here is how to use Plume URL:
```js
const { Client } = require("discord.js");
const { PlumeURL } = require("@sodiumlabs/plume-url");
// Your discord.js client
const client = new Client({
/* ... */
});
// Attach PlumeURL to your client
client.plumeURL = new PlumeURL({ apiKey: "YOUR-API-KEY" });
```
You can now use Plume URL anywhere in your bot.
For example, in a slash command:
```js
const userId = "619838036846575617";
// Create a new URL
const data = await client.plumeURL.createURL({
url: "https://google.com",
customId: userId, // The custom ID allows your users to retrieve their URLs later
});
console.log(data);
// Search for the URLs you created
// You can filter by custom ID if needed
const urls = await client.plumeURL.search({ limit: 5, customId: userId });
console.log(urls);
```
# References
PlumeURL class methods.
You can find the types definitions on the [API documentation](https://url.sodiumlabs.xyz/docs).
```js
createURL(options: CreateURLOptions): Promise;
search({ customId, limit, page, expired }: SearchURLOptions): Promise;
getURL(id: string): Promise;
editURL(id: string, options: EditURLOptions): Promise;
deleteURL(id: string): Promise;
```
# Help
If you don't understand something in the documentation, are experiencing problems, or you just need a gentle nudge in the right direction, please don't hesitate to join our official [Discord Server](https://discord.gg/8PDXWSHH7k).
