yutaapis 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lm Only
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,2 @@
+# yutaapis
+Módulo SDK TypeScript/JavaScript desenvolvido para consumo do Yuta APIs; em parceria com HutaoBot

package/lib/Routes/downloads/instagram.js

@@ -0,0 +1 @@
+export {};

package/lib/Routes/downloads/ytaudio2.js

@@ -0,0 +1,15 @@
+import { request } from "../../request.js";
+export default async function ytaudio2(opts) {
+    if (!opts.query) {
+        throw 'Parâmetro inválido - Está faltando';
+    }
+    return await request(opts.url, {
+        requestOptions: {
+            method: 'GET',
+            query: {
+                url: opts.query,
+            }
+        },
+        dataType: 'JSON'
+    }, 0, opts);
+}

package/lib/Routes/geradores/geradores.js

@@ -0,0 +1,12 @@
+import { request } from "../../request.js";
+export default async function geradores(opts, dataType) {
+    return await request(opts.url, {
+        requestOptions: {
+            method: 'GET',
+            query: {
+                text: opts.query
+            }
+        },
+        dataType: dataType
+    }, 0, opts);
+}

package/lib/Routes/ias/ias.js

@@ -0,0 +1,12 @@
+import { request } from "../../request.js";
+export default async function ias(opts, dataType) {
+    return await request(opts.url, {
+        requestOptions: {
+            method: 'GET',
+            query: {
+                query: opts.query,
+            }
+        },
+        dataType: dataType
+    }, 0, opts);
+}

package/lib/Routes/pesquisa/github-search.js

@@ -0,0 +1,21 @@
+import { request } from "../../request.js";
+export default async function gitstalk(opts) {
+    if (!opts.query) {
+        throw 'Parâmetro inválido - Está faltando';
+    }
+    try {
+        return await request(opts.url, {
+            requestOptions: {
+                method: 'GET',
+                query: {
+                    username: opts.query,
+                },
+            },
+            dataType: 'JSON'
+        }, 0, opts);
+    }
+    catch (error) {
+        throw new Error('API_ERROR: ' + error);
+    }
+}
+;

package/lib/Routes/pesquisa/wikipedia.js

@@ -0,0 +1,15 @@
+import { request } from "../../request.js";
+export default async function wiki(opts) {
+    if (!opts.query) {
+        throw 'Parâmetro inválido - Está faltando';
+    }
+    return await request(opts.url, {
+        requestOptions: {
+            method: 'GET',
+            query: {
+                query: opts.query,
+            }
+        },
+        dataType: 'JSON'
+    }, 0, opts);
+}

package/lib/Routes/pesquisa/yt-search.js

@@ -0,0 +1,20 @@
+import { request } from "../../request.js";
+export default async function ytsearch(opts) {
+    if (!opts.query) {
+        throw 'Parâmetro inválido - Está faltando';
+    }
+    try {
+        return await request(opts.url, {
+            requestOptions: {
+                method: 'GET',
+                query: {
+                    query: opts.query,
+                },
+            },
+            dataType: 'JSON'
+        }, 0, opts);
+    }
+    catch (error) {
+        throw new Error('API_ERROR: ' + error);
+    }
+}

package/lib/Utils/index.js

@@ -0,0 +1 @@
+export * from './validation.js';

package/lib/Utils/url.js

@@ -0,0 +1,6 @@
+export function urlFormatString(...args) {
+    if (!args.length || !Array.isArray(args)) {
+        throw new Error('Invalid arguments on formatUrl or is not defined');
+    }
+    return args.join('/');
+}

package/lib/Utils/validation.js

@@ -0,0 +1,10 @@
+/**
+ * Analisa se o token tem as características da API token do yuta.
+ * Ele vai checar se a string tem o tamnho adequado
+ * Se o começo é previsto igual o do token e etc
+ *
+ * @param apiToken Suposta API Token do Yuta
+ */
+export function isYutaApiToken(apiToken) {
+    return apiToken.startsWith('yuta_') && apiToken.length >= 30;
+}

package/lib/client.js

@@ -0,0 +1,70 @@
+/**
+ * @license MIT
+ *
+ * Copyright 2026 Yuta & Hutao bot community
+ * Yuta APIs - Em parceria com HutaoBot
+ *
+ * @author Lm Only and Nk Petrov
+ */
+import { routes } from "./routes.js";
+import { isYutaApiToken } from "./Utils/index.js";
+const BASE_YUTA_API_URL = 'https://yuta-apis.xyz/api';
+export class YutaApis {
+    apiToken;
+    url;
+    config;
+    httpOptions;
+    get ias() {
+        const baseUrl = this.url;
+        if (!baseUrl) {
+            throw new Error('baseUrl is not defined');
+        }
+        return routes({
+            ...this.config,
+            route: 'ias'
+        }).ias;
+    }
+    get geradores() {
+        const baseUrl = this.url;
+        if (!baseUrl) {
+            throw new Error('baseUrl is not defined');
+        }
+        return routes({
+            ...this.config,
+            route: 'geradores'
+        }).geradores;
+    }
+    get downloads() {
+        const baseUrl = this.url;
+        if (!baseUrl) {
+            throw new Error('baseUrl is not defined');
+        }
+        return routes({
+            ...this.config,
+            route: 'downloads'
+        }).downloads;
+    }
+    get pesquisas() {
+        const baseUrl = this.url;
+        if (!baseUrl) {
+            throw new Error('baseUrl is not defined');
+        }
+        return routes({
+            ...this.config,
+            route: 'pesquisas'
+        }).pesquisas;
+    }
+    constructor(opts = {}) {
+        if (!opts.apiToken || !isYutaApiToken(String(opts.apiToken))) {
+            throw new Error('apiToken is not defined');
+        }
+        this.apiToken = opts.apiToken;
+        this.httpOptions = opts.httpOptions ?? {};
+        this.url = opts.httpOptions?.baseUrl ?? BASE_YUTA_API_URL;
+        this.config = {
+            headers: this.httpOptions?.headers ?? {},
+            apitoken: this.apiToken,
+            baseUrl: this.url
+        };
+    }
+}

package/lib/errors.js

@@ -0,0 +1,16 @@
+/**
+ * @license MIT
+ *
+ * Copyright 2026 Yuta & Hutao bot community
+ * Yuta APIs - Em parceria com HutaoBot
+ *
+ * @author Lm Only and Nk Petrov
+ */
+export class RequestError extends Error {
+    statusCode;
+    constructor(opts) {
+        super(opts.message);
+        this.statusCode = opts.statusCode;
+        Object.setPrototypeOf(this, RequestError.prototype);
+    }
+}

package/lib/index.js

@@ -0,0 +1,2 @@
+import { YutaApis } from './client.js';
+export default YutaApis;

package/lib/request.js

@@ -0,0 +1,60 @@
+/**
+ * @license MIT
+ *
+ * Copyright 2026 Yuta & Hutao bot community
+ * Yuta APIs - Em parceria com HutaoBot
+ *
+ * @author Lm Only and Nk Petrov
+ */
+import { request as httpRequest } from 'undici';
+import { RequestError } from './errors.js';
+async function getBodyByType(body, dataType) {
+    if (!dataType)
+        return (await body.text());
+    switch (dataType.toUpperCase()) {
+        case 'JSON': return (await body.json());
+        case 'TEXT': return (await body.text());
+        case 'BUFFER': return Buffer.from(await body.arrayBuffer());
+        default: return (await body.text());
+    }
+}
+export async function request(url, opts, redirectCount = 0, otherOpts) {
+    if (redirectCount > 5) {
+        throw new RequestError({ statusCode: 310, message: 'MAX_REDIRECTS' });
+    }
+    opts.requestOptions.query.apitoken = otherOpts.apitoken;
+    opts.requestOptions.headers = {
+        ...opts.requestOptions.headers,
+        ...otherOpts.headers,
+    };
+    const { statusCode, headers, body } = await httpRequest(url, opts.requestOptions);
+    if (statusCode >= 200 && statusCode < 300) {
+        return await getBodyByType(body, opts.dataType);
+    }
+    const locationHeader = headers.location;
+    if (statusCode >= 300 && statusCode < 400 && locationHeader) {
+        await body.dump();
+        const targetUrl = Array.isArray(locationHeader) ? locationHeader[0] : locationHeader;
+        return request(targetUrl, opts, redirectCount + 1, otherOpts);
+    }
+    /**
+     * Aqui é pra quando der erro e a API retornar algo
+     * Evitando retornar erro mal detalhado
+     * Mas se caso a API não retornar nada
+     * Segue pra erro desconhecido .
+     */
+    try {
+        const responseError = await getBodyByType(body, opts.dataType);
+        const hasResponseApi = Array.isArray(responseError) || typeof responseError !== 'undefined';
+        if (hasResponseApi) {
+            return responseError;
+        }
+    }
+    catch {
+        await body.dump().catch(() => { });
+    }
+    throw new RequestError({
+        statusCode,
+        message: 'REQ_FAILED',
+    });
+}

package/lib/routes.js

@@ -0,0 +1,71 @@
+/**
+ * @license MIT
+ *
+ * Copyright 2026 Yuta & Hutao bot community
+ * Yuta APIs - Em parceria com HutaoBot
+ *
+ * @author Lm Only and Nk Petrov
+ */
+import gitstalk from "./Routes/pesquisa/github-search.js";
+import ytsearch from "./Routes/pesquisa/yt-search.js";
+import ytaudio2 from "./Routes/downloads/ytaudio2.js";
+import wiki from "./Routes/pesquisa/wikipedia.js";
+import { urlFormatString } from "./Utils/url.js";
+import ias from "./Routes/ias/ias.js";
+import geradores from "./Routes/geradores/geradores.js";
+export function routes(opts) {
+    return {
+        pesquisas: {
+            ytsearch: async (query) => await ytsearch({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'yt-search')
+            }),
+            gitstalk: async (query) => await gitstalk({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'github-stalker')
+            }),
+            wiki: async (query) => await wiki({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'wiki-search')
+            })
+        },
+        downloads: {
+            ytaudio2: async (query) => await ytaudio2({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'ytaudio2')
+            }),
+        },
+        ias: {
+            gpt: async (query) => await ias({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'gpt')
+            }, 'JSON'),
+            gemini: async (query) => await ias({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'gemini')
+            }, 'JSON'),
+            gemini_pro: async (query) => await ias({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'gemini-pro')
+            }, 'JSON'),
+            geminivoz: async (query) => await ias({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'geminivoz')
+            }, 'BUFFER'),
+            perplexity_ai: async (query) => await ias({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'perplexity-ai')
+            }, 'JSON')
+        },
+        geradores: {
+            nick: async (query) => await geradores({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'gerar-nicks')
+            }, 'JSON'),
+            qrcode: async (query) => await geradores({
+                ...opts, query,
+                url: urlFormatString(opts.baseUrl, opts.route, 'qrcode')
+            }, 'BUFFER'),
+        }
+    };
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "yutaapis",
+  "version": "1.0.0",
+  "description": "Módulo TS/JavaScript que se conecta com a API Oficial do Yuta",
+  "keywords": [
+    "api",
+    "nodejs",
+    "web"
+  ],
+  "homepage": "https://github.com/Lm-Only/yutaapis#readme",
+  "bugs": {
+    "url": "https://github.com/Lm-Only/yutaapis/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Lm-Only/yutaapis.git"
+  },
+  "files": [
+    "lib"
+  ],
+  "license": "MIT",
+  "author": "Lm-Only",
+  "type": "module",
+  "main": "lib/index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1"
+  },
+  "devDependencies": {
+    "@types/node": "^26.4.0",
+    "dotenv": "^17.4.2",
+    "typescript": "^7.0.2"
+  },
+  "dependencies": {
+    "undici": "^8.10.0"
+  },
+  "allowScripts": {
+    "esbuild@0.28.2": true
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}