ygg-eu-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 fredodiable
+
+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,90 @@
+# Ygg-EU SDK
+
+[![npm version](https://img.shields.io/npm/v/ygg-eu-sdk.svg)](https://www.npmjs.com/package/ygg-eu-sdk)
+[![Build Status](https://github.com/fredodiable/ygg-eu-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/fredodiable/ygg-eu-sdk/actions)
+[![Dependencies](https://img.shields.io/badge/dependencies-0-success)](https://www.npmjs.com/package/ygg-eu-sdk)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
+
+Un SDK TypeScript pour l'API non officielle [yggapi.eu](https://yggapi.eu/).
+
+## ✨ Points forts
+
+- 🪶 **Ultra léger** : Empreinte minimale sur votre projet.
+- 🛡️ **Zéro Dépendance** : Utilise l'API `fetch` native.
+- 💪 **Type-Safe** : Développé en TypeScript pour une autocomplétion parfaite.
+- 🧪 **Fiable** : Couverture complète par tests unitaires et d'intégration.
+
+## 🚀 Installation
+
+```bash
+npm install ygg-eu-sdk
+```
+
+## 📖 Exemples d'utilisation
+
+### Initialisation
+
+#### En TypeScript (ESM)
+
+```typescript
+import { YggEuClient } from 'ygg-eu-sdk';
+
+const client = new YggEuClient({
+  //Paramètres optionnels
+  passkey: 'VOTRE_PASSKEY', // Requis uniquement pour le téléchargement
+  timeout: 5000, // Délai d'expiration en ms (par défaut 10s)
+});
+```
+
+#### En JavaScript (CommonJS)
+
+```javascript
+const { YggEuClient } = require('ygg-eu-sdk');
+
+const client = new YggEuClient({
+  // ...
+});
+```
+
+### 🔍 Rechercher un torrent
+
+#### Recherche minimal
+
+```typescript
+const results = await client.torrents.search({
+  q: 'Inception',
+});
+```
+
+#### Recherche détaillée
+
+```typescript
+import { YggCategory } from 'ygg-eu-sdk';
+
+const results = await client.torrents.search({
+  q: 'Altered Carbon',
+  category_id: YggCategory.VIDEOS_SERIE_TV,
+  season: 1,
+  per_page: 25,
+});
+```
+
+### 📝 Obtenir les détails
+
+```typescript
+const details = await client.torrents.getDetail(123);
+console.log(details.title);
+```
+
+### ⬇️ Télécharger un fichier .torrent
+
+```typescript
+import { writeFileSync } from 'fs';
+
+const torrentBuffer = await client.torrents.download(123);
+writeFileSync('test.torrent', Buffer.from(torrentBuffer));
+```
+
+## ⚖️ Licence
+
+Ce projet est sous licence **MIT**. Vous êtes libre de l'utiliser, de le modifier et de le distribuer, même à des fins commerciales. Voir le fichier [LICENSE](https://github.com/fredodiable/ygg-eu-sdk/blob/main/LICENSE) pour plus de détails.

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";var n=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var w=Object.prototype.hasOwnProperty;var m=(o,r)=>{for(var e in r)n(o,e,{get:r[e],enumerable:!0})},p=(o,r,e,a)=>{if(r&&typeof r=="object"||typeof r=="function")for(let t of h(r))!w.call(o,t)&&t!==e&&n(o,t,{get:()=>r[t],enumerable:!(a=l(r,t))||a.enumerable});return o};var d=o=>p(n({},"__esModule",{value:!0}),o);var f={};m(f,{YggEuClient:()=>i});module.exports=d(f);var i=class{baseUrl;passkey;timeout;constructor(r={}){this.baseUrl=r.baseUrl||"https://yggapi.eu",this.passkey=r.passkey,this.timeout=r.timeout||1e4}async request(r,e={}){let a=new AbortController,t=setTimeout(()=>a.abort(),this.timeout),u={Accept:"application/json","User-Agent":"ygg-eu-sdk/1.0.0",...e.headers};try{let s=await fetch(`${this.baseUrl}${r}`,{...e,headers:u,signal:a.signal});if(clearTimeout(t),!s.ok){let c=await s.json().catch(()=>({}));throw new Error(`YggApi ${s.status}: ${s.statusText}`,{cause:{status:s.status,detail:c}})}return await s.json()}catch(s){throw clearTimeout(t),s instanceof Error?s.name==="AbortError"?new Error("Request timeout"):s:new Error("An unknown error occurred",{cause:s})}}torrents={search:r=>{let e=new URLSearchParams;return Object.entries(r).forEach(([a,t])=>{t!==void 0&&e.append(a,t.toString())}),this.request(`/torrents?${e.toString()}`)},getDetails:r=>this.request(`/torrent/${r}`),download:async r=>{if(!this.passkey)throw new Error("Passkey is required for download");let e=await fetch(`${this.baseUrl}/torrent/${r}/download?passkey=${this.passkey}`,{headers:{"User-Agent":"ygg-eu-sdk/1.0.0"}});if(!e.ok)throw new Error(`Download failed: ${e.statusText}`);return await e.arrayBuffer()}}};0&&(module.exports={YggEuClient});

package/dist/index.d.cts

@@ -0,0 +1,106 @@
+/**
+ * Catégories officielles YGG
+ */
+declare enum YggCategory {
+    ALL = 0,
+    AUDIO = 2139,
+    AUDIO_KARAOKE = 2147,
+    AUDIO_MUSIQUE = 2148,
+    AUDIO_SAMPLES = 2149,
+    AUDIO_PODCAST_RADIO = 2150,
+    EBOOK = 2140,
+    EBOOK_AUDIO = 2151,
+    EBOOK_BD = 2152,
+    EBOOK_COMICS = 2153,
+    EBOOK_LIVRES = 2154,
+    EBOOK_MANGA = 2155,
+    EBOOK_PRESSE = 2156,
+    JEUX_VIDEO = 2142,
+    JEUX_LINUX = 2159,
+    JEUX_MACOS = 2160,
+    JEUX_WINDOWS = 2161,
+    JEUX_NINTENDO = 2163,
+    JEUX_SONY = 2164,
+    JEUX_SMARTPHONE = 2165,
+    JEUX_TABLETTE = 2166,
+    JEUX_AUTRE = 2167,
+    APPLICATIONS = 2144,
+    APPLICATIONS_LINUX = 2168,
+    APPLICATIONS_MACOS = 2169,
+    APPLICATIONS_WINDOWS = 2170,
+    APPLICATIONS_SMARTPHONE = 2171,
+    APPLICATIONS_TABLETTE = 2172,
+    APPLICATIONS_FORMATION = 2177,
+    VIDEOS = 2145,
+    VIDEOS_ANIMATION = 2178,
+    VIDEOS_ANIMATION_SERIE = 2179,
+    VIDEOS_CONCERT = 2180,
+    VIDEOS_DOCUMENTAIRE = 2181,
+    VIDEOS_EMISSION_TV = 2182,
+    VIDEOS_FILM = 2183,
+    VIDEOS_SERIE_TV = 2184,
+    VIDEOS_SPECTACLE = 2185,
+    VIDEOS_SPORT = 2186,
+    VIDEOS_CLIP_VIDEO = 2187,
+    GPS = 2143,
+    GPS_APPLICATIONS = 2173,
+    GPS_CARTES = 2174,
+    GPS_DIVERS = 2175,
+    IMPRIMANTE_3D = 2200,
+    IMPRIMANTE_3D_OBJETS = 2201,
+    IMPRIMANTE_3D_PERSONNAGES = 2202,
+    NULLED = 2210,
+    NULLED_WORDPRESS = 2211,
+    NULLED_SCRIPTS_PHP_CMS = 2212,
+    NULLED_MOBILE = 2213,
+    NULLED_DIVERS = 2214
+}
+interface SearchParams {
+    page?: number;
+    q?: string;
+    category_id?: YggCategory | number;
+    order_by?: 'uploaded_at' | 'seeders' | 'downloads';
+    per_page?: 25 | 50 | 100;
+    season?: number;
+    episode?: number;
+    type?: 'movie' | 'tv';
+    tmdb_id?: number;
+}
+interface TorrentResult {
+    id: number;
+    title: string;
+    seeders: number;
+    leechers: number;
+    downloads: number | undefined;
+    size: number;
+    category_id: number;
+    uploaded_at: string;
+    link: string;
+}
+interface TorrentDetails extends TorrentResult {
+    description: string | undefined;
+    hash: string | undefined;
+    updated_at: string;
+    type: string | undefined;
+    tmdb_id: number | undefined;
+}
+interface ClientConfig {
+    passkey?: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+
+declare class YggEuClient {
+    private readonly baseUrl;
+    private readonly passkey?;
+    private readonly timeout;
+    constructor(config?: ClientConfig);
+    private request;
+    torrents: {
+        search: (params: SearchParams) => Promise<TorrentResult[]>;
+        getDetails: (id: number) => Promise<TorrentDetails>;
+        download: (id: number) => Promise<ArrayBuffer>;
+    };
+}
+
+export { YggEuClient };

package/dist/index.d.ts

@@ -0,0 +1,106 @@
+/**
+ * Catégories officielles YGG
+ */
+declare enum YggCategory {
+    ALL = 0,
+    AUDIO = 2139,
+    AUDIO_KARAOKE = 2147,
+    AUDIO_MUSIQUE = 2148,
+    AUDIO_SAMPLES = 2149,
+    AUDIO_PODCAST_RADIO = 2150,
+    EBOOK = 2140,
+    EBOOK_AUDIO = 2151,
+    EBOOK_BD = 2152,
+    EBOOK_COMICS = 2153,
+    EBOOK_LIVRES = 2154,
+    EBOOK_MANGA = 2155,
+    EBOOK_PRESSE = 2156,
+    JEUX_VIDEO = 2142,
+    JEUX_LINUX = 2159,
+    JEUX_MACOS = 2160,
+    JEUX_WINDOWS = 2161,
+    JEUX_NINTENDO = 2163,
+    JEUX_SONY = 2164,
+    JEUX_SMARTPHONE = 2165,
+    JEUX_TABLETTE = 2166,
+    JEUX_AUTRE = 2167,
+    APPLICATIONS = 2144,
+    APPLICATIONS_LINUX = 2168,
+    APPLICATIONS_MACOS = 2169,
+    APPLICATIONS_WINDOWS = 2170,
+    APPLICATIONS_SMARTPHONE = 2171,
+    APPLICATIONS_TABLETTE = 2172,
+    APPLICATIONS_FORMATION = 2177,
+    VIDEOS = 2145,
+    VIDEOS_ANIMATION = 2178,
+    VIDEOS_ANIMATION_SERIE = 2179,
+    VIDEOS_CONCERT = 2180,
+    VIDEOS_DOCUMENTAIRE = 2181,
+    VIDEOS_EMISSION_TV = 2182,
+    VIDEOS_FILM = 2183,
+    VIDEOS_SERIE_TV = 2184,
+    VIDEOS_SPECTACLE = 2185,
+    VIDEOS_SPORT = 2186,
+    VIDEOS_CLIP_VIDEO = 2187,
+    GPS = 2143,
+    GPS_APPLICATIONS = 2173,
+    GPS_CARTES = 2174,
+    GPS_DIVERS = 2175,
+    IMPRIMANTE_3D = 2200,
+    IMPRIMANTE_3D_OBJETS = 2201,
+    IMPRIMANTE_3D_PERSONNAGES = 2202,
+    NULLED = 2210,
+    NULLED_WORDPRESS = 2211,
+    NULLED_SCRIPTS_PHP_CMS = 2212,
+    NULLED_MOBILE = 2213,
+    NULLED_DIVERS = 2214
+}
+interface SearchParams {
+    page?: number;
+    q?: string;
+    category_id?: YggCategory | number;
+    order_by?: 'uploaded_at' | 'seeders' | 'downloads';
+    per_page?: 25 | 50 | 100;
+    season?: number;
+    episode?: number;
+    type?: 'movie' | 'tv';
+    tmdb_id?: number;
+}
+interface TorrentResult {
+    id: number;
+    title: string;
+    seeders: number;
+    leechers: number;
+    downloads: number | undefined;
+    size: number;
+    category_id: number;
+    uploaded_at: string;
+    link: string;
+}
+interface TorrentDetails extends TorrentResult {
+    description: string | undefined;
+    hash: string | undefined;
+    updated_at: string;
+    type: string | undefined;
+    tmdb_id: number | undefined;
+}
+interface ClientConfig {
+    passkey?: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+
+declare class YggEuClient {
+    private readonly baseUrl;
+    private readonly passkey?;
+    private readonly timeout;
+    constructor(config?: ClientConfig);
+    private request;
+    torrents: {
+        search: (params: SearchParams) => Promise<TorrentResult[]>;
+        getDetails: (id: number) => Promise<TorrentDetails>;
+        download: (id: number) => Promise<ArrayBuffer>;
+    };
+}
+
+export { YggEuClient };

package/dist/index.js

@@ -0,0 +1 @@
+var a=class{baseUrl;passkey;timeout;constructor(r={}){this.baseUrl=r.baseUrl||"https://yggapi.eu",this.passkey=r.passkey,this.timeout=r.timeout||1e4}async request(r,t={}){let o=new AbortController,s=setTimeout(()=>o.abort(),this.timeout),n={Accept:"application/json","User-Agent":"ygg-eu-sdk/1.0.0",...t.headers};try{let e=await fetch(`${this.baseUrl}${r}`,{...t,headers:n,signal:o.signal});if(clearTimeout(s),!e.ok){let i=await e.json().catch(()=>({}));throw new Error(`YggApi ${e.status}: ${e.statusText}`,{cause:{status:e.status,detail:i}})}return await e.json()}catch(e){throw clearTimeout(s),e instanceof Error?e.name==="AbortError"?new Error("Request timeout"):e:new Error("An unknown error occurred",{cause:e})}}torrents={search:r=>{let t=new URLSearchParams;return Object.entries(r).forEach(([o,s])=>{s!==void 0&&t.append(o,s.toString())}),this.request(`/torrents?${t.toString()}`)},getDetails:r=>this.request(`/torrent/${r}`),download:async r=>{if(!this.passkey)throw new Error("Passkey is required for download");let t=await fetch(`${this.baseUrl}/torrent/${r}/download?passkey=${this.passkey}`,{headers:{"User-Agent":"ygg-eu-sdk/1.0.0"}});if(!t.ok)throw new Error(`Download failed: ${t.statusText}`);return await t.arrayBuffer()}}};export{a as YggEuClient};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "ygg-eu-sdk",
+  "version": "1.0.0",
+  "description": "SDK TypeScript léger et zéro-dépendance pour yggapi.eu",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "format": "prettier --check \"{src,tests}/**/*.ts\"",
+    "format:fix": "prettier --write \"{src,tests}/**/*.ts\"",
+    "lint": "eslint \"{src,tests}/**/*.ts\"",
+    "lint:fix": "eslint \"{src,tests}/**/*.ts\" --fix",
+    "test": "vitest run --project=unit",
+    "test:integration": "vitest run --project=integration",
+    "test:all": "vitest run",
+    "prepublishOnly": "npm run format && npm run lint && npm run test && npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fredodiable/ygg-eu-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fredodiable/ygg-eu-sdk/issues"
+  },
+  "homepage": "https://github.com/fredodiable/ygg-eu-sdk#readme",
+  "keywords": [
+    "ygg",
+    "api",
+    "sdk",
+    "typescript",
+    "torrent",
+    "yggapi"
+  ],
+  "author": "fredodiable",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-import": "^2.32.0",
+    "prettier": "^3.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.0.16"
+  }
+}