# Javascript

> NPM package: [**`elara-services`**](https://npmjs.org/package/elara-services)

## Base

```javascript
const s = require("elara-services"), 
      services = new s("YOUR API KEY");
```

## Support

```javascript
let support = services.support;
// Returns the support link.
```

## Docs

```javascript
let docs = services.docs;
// Returns the docs page link.
```

## Ping

```javascript
let res= await services.ping();
if(res.status !== true) return console.log(res.message);
// Returns {status: true, time: 12345}
```

## Pastebin

```javascript
// GET

let res = await services.paste.get("ID");
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, key: "ID", content: "The paste content", url: "URL", title: "The title of the paste", created: "Date", expire: "Date"}

// ----------------------------------------------------------------
// POST

let res = await services.paste.post("Title", "Content"); 
// Optional ("title", "content", true) | 'true' is making the paste private
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, id: "ID", url: "URL"}
```

## Hastebin

```javascript
// GET

let res = await services.haste.get("ID");
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, id: "ID", url: "URL", content: "The data"}

// -----------------------------------------------------------

// POST

let res = await services.haste.post("Content");
// Optional ("content", {url: "hastebin URL", extension: "js"})
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, id: "ID", url: "URL"}
// -----------------------------------------------------------
```

## DBL([top.gg](https://top.gg/))

```javascript
// GET
//------------------------------------------------------------
let res = await services.api.dbl.get("Your DBL Token", "ID");
if(res.status !== true) return console.log(res.message);
console.log(res) // To see what it returns, too much there to list!

// -----------------------------------------------------------
// POST
let res = await services.api.dbl.post("Your DBL token", "ID", servers_count, shards_count);
// "shards_count" is optional.. 
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, message: "Stats posted to DBL(top.gg)"}
```

## Translate

```javascript
let res = await services.api.translate("to_Lang", "message to translate");
if(res.status !== true) return console.log(res.message);
// Returns: {
//    status: true,
//    message: "The trasnlated message",
//    extra: {
//        raw: {}, // The raw object for the translation
//        from: {
//            full: "English",
//            iso: "en"
//        },
//        to: {
//            full: "French",
//            iso: "fr"
//        }
//    }
//}
```

## Invites

```javascript
let res = await services.api.invites("type");
// Types: nitro, global, both (Default is both)
if(res.status !== true) return console.log(res.message);
// Returns
//- Nitro & Global: {status: true, invites: []} 
//- Both: {status: true, global: [], nitro: []}

```

## 8ball

```javascript
let res = await services.api.ball();
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, text: "OK", image: "URL"}
```

## NPM

```javascript
let res = await services.api.npm("package name");
if(res.status !== true) return console.log(res.message);
// Returns:
{
    status: true,
    name: "",
    url: "",
    tags: [],
    description: "",
    latest: "",
    maintainers: [],
    author: "",
    license: "",
    created: "",
    updated: "",
    pages: {
        bugs: "",
        home: "",
        download: "",
        repository: ""
    },
    readme: ""
}
```

## Facts

```javascript
let res = await services.api.facts("type");
// Types: random, all (Default is "random")
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, fact: "Random Fact"};
// or
// Returns: {status: true, facts: []} | If "all" is returned
```

## Time

```javascript
let res = await services.api.time("place", true);
// If true it will return all.
if(res.status !== true) return console.log(res.message);
// Returns: 
{
    status: true,
    name: "EST",
    place: "America/New_York"
}
// OR
{
    status: true,
    times: [] // Array of the supported times
}
```

## Dog Breeds

```javascript
let res = await services.api.dogbreed(optional_type, optional_breed);
// Types: list, random (default is random)
// Breeds: Use: "type: list" to see all of the supported breeds.
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, image: "URL"}
// OR
// Returns: {status: true, list: [], bot_fields: []}
// "bot_fields" are mapped out for Discord Bot embed fields
```

## Memes

```javascript
let res = await services.api.memes(optional_clean);
// optional_clean: boolean, if it's true it will only return clean memes, if false it will return everything
if(res.status !== true) return console.log(res.message);
// Returns: {status: true, image: "URL"}
```

## Discord.js-Docs

```javascript
let res = await services.api.docs("Search", "Project, default is normal d.js", "Branch, default is 'stable'");
if(res.status !== true) return console.log(res.message);
console.log(res); // To see what it returns.
```

## Platform

```javascript
// Mixer
let res = await services.api.platform.mixer("USERNAME");

// Twitch
let res = await services.api.platform.twitch("CLIENT-ID", "USERNAME OR USER ID");

// YouTube-Stats
let res = await services.api.platform.ytstats("CLIENT_ID", "CHANNEL_ID_OR_NAME");

// YouTube-Search
let res = await services.api.platform.ytsearch("CLIENT_ID", "Search Query", "type, default is 'video'");

// IMDB
let res = await services.api.platform.imdb("CLIENT_ID", "name of the show or movie");

// Fortnite
let res = await services.api.platform.fortnite("CLIENT_ID", "Username", "platform, default is 'pc'");

// Paladins
let res = await services.api.platform.paladins("DEV_ID", "DEV_AUTH", "USERNAME", "PLATFORM, default is 'pc'");

// Roblox
let res = await services.api.platform.roblox("Discord User ID");

// Roblox-Group
let res = await services.api.platform.robloxgroup("Group ID");

// Picarto
let res = await services.api.platform.picarto("username or ID");

if(res.status !== true) return console.log(res.message);
console.log(res); // To see what each of them returns
```

## Photos

```javascript
let res = await services.api.photos("type");
// Current types as of 1/15/2020
// cats, dogs, pugs, blobs, penguins, pandas, hugs, husky, cookies, pokes, garfield, cards, boops
if(res.status !== true) return console.log(res.message);
// Returns {status: true, image: "URL"}
```

## Math

```javascript
let res = await services.api.math("2+2");
if(res.status !== true) return console.log(res.message);
// Returns: 
{
    status: true, 
    answer: "Some answer"
}
```

## Auto Moderation

```javascript
// Image

let res = await services.automod.images("YOUR API TOKEN", ["image", "urls", "to", "check"], optional_percent);
// Default percent is: 89
if(res.status !== true) return console.log(res);
// Returns: 
{
    status: true, 
    images: [], // Returns any images that was filtered as "adult"
    full: [
    // Example object
    {
        percent: 90, 
        url: "URL", 
        raw: {} // Raw response from the moderatecontent API 
    }
    ]
}
// -----------------------------------------------------------------
// Words
let res = await services.automod.words("Message String", ["The", "filter", "word", "list"], optional_emojisList);
// optional_emojiList: Array of the emojis you want to see if they are included in the message string.
if(res.status !== true) return console.log(res);
// Returns: 
{
    status: true,
    filtered: ["Array of the filtered words in the message string"]
}

//------------------------------------------------------------------
// Links
let res = await services.automod.links("message string", options);
// options: {regexp: true, prefix: "."};
if(res.status !== true) return console.log(res);
// Returns:
{
    status: true,
    links: true,
    message: "The message string"
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://elara.gitbook.io/services/wrapper/js.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.