node-tp2-vidar 1.0.0

package/.claude/settings.local.json

@@ -0,0 +1,7 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(node:*)"
+    ]
+  }
+}

package/.idea/Node-TP2.iml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="WEB_MODULE" version="4">
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$" />
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+  </component>
+</module>

package/.idea/SweepConfig.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="dev.sweep.assistant.components.SweepConfig">
+    <option name="autoApprovedTools">
+      <set>
+        <option value="list_files" />
+        <option value="read_file" />
+        <option value="search_files" />
+        <option value="find_usages" />
+        <option value="get_errors" />
+      </set>
+    </option>
+  </component>
+</project>

package/.idea/modules.xml

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/Node-TP2.iml" filepath="$PROJECT_DIR$/.idea/Node-TP2.iml" />
+    </modules>
+  </component>
+</project>

package/.idea/vcs.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="" vcs="Git" />
+  </component>
+</project>

package/README.md

@@ -0,0 +1,413 @@
+# node-tp2
+
+Package NPM combinant un générateur de **Lorem Ipsum** et un afficheur de cartes **Magic: The Gathering** via l'API publique Scryfall.
+
+---
+
+## Table des matières
+
+- [Installation](#installation)
+- [Partie 1 — Lorem Ipsum](#partie-1--lorem-ipsum)
+  - [Fonctionnement interne](#fonctionnement-interne)
+  - [Usage en JavaScript](#usage-en-javascript)
+  - [Usage via le DOM](#usage-via-le-dom)
+- [Partie 2 — Magic: The Gathering](#partie-2--magic-the-gathering)
+  - [Fonctionnement interne](#fonctionnement-interne-1)
+  - [Usage en JavaScript](#usage-en-javascript-1)
+  - [Usage via le DOM](#usage-via-le-dom-1)
+- [Exemple HTML complet](#exemple-html-complet)
+- [Référence API](#référence-api)
+- [Publier sur NPM](#publier-sur-npm)
+
+---
+
+## Installation
+
+```bash
+npm install node-tp2
+```
+
+Ou, en clonant le dépôt directement :
+
+```bash
+git clone https://github.com/VidarIvory/Node-TP2.git
+cd Node-TP2
+npm install
+```
+
+---
+
+## Partie 1 — Lorem Ipsum
+
+### Fonctionnement interne
+
+Le générateur s'appuie sur une liste de **~130 mots** inspirés du latin classique (tiré du *De Finibus Bonorum et Malorum* de Cicéron). Aucune dépendance externe n'est requise.
+
+Le processus de génération fonctionne en trois niveaux :
+
+```
+Mot  →  Phrase  →  Paragraphe  →  Texte final
+```
+
+| Niveau     | Détail                                         |
+|------------|------------------------------------------------|
+| Mot        | Tiré aléatoirement dans la liste de 130 mots   |
+| Phrase     | 5 à 14 mots, première lettre en majuscule, terminée par un point |
+| Paragraphe | 3 à 6 phrases assemblées                       |
+| Texte      | N paragraphes séparés par une ligne vide       |
+
+---
+
+### Usage en JavaScript
+
+```js
+const { Ipsum } = require('node-tp2');
+```
+
+#### Générer des paragraphes
+
+```js
+const lorem = new Ipsum({ paragrafs: 5 });
+
+console.log(lorem.text);
+// Affiche 5 paragraphes de texte latin aléatoire
+
+// L'objet est aussi directement convertible en chaîne
+console.log(String(lorem));
+console.log(`${lorem}`);
+```
+
+#### Générer un nombre précis de mots
+
+```js
+const lorem = new Ipsum({ words: 50 });
+
+console.log(lorem.text);
+// Affiche exactement 50 mots séparés par des espaces
+```
+
+#### Valeur par défaut
+
+Sans option, 1 paragraphe est généré :
+
+```js
+const lorem = new Ipsum();
+console.log(lorem.text); // 1 paragraphe
+```
+
+---
+
+### Usage via le DOM
+
+La méthode statique `Ipsum.init()` parcourt automatiquement la page HTML et remplit tous les éléments dont la classe contient le mot `ipsum`.
+
+**Appel unique à placer en fin de page ou dans un DOMContentLoaded :**
+
+```html
+<script>
+  const { Ipsum } = require('node-tp2');
+  Ipsum.init();
+</script>
+```
+
+#### Classes CSS reconnues
+
+| Classe CSS         | Comportement                                      |
+|--------------------|---------------------------------------------------|
+| `ipsum`            | Insère 3 paragraphes dans des balises `<p>`       |
+| `ipsum-p-{n}`      | Insère **n** paragraphes dans des balises `<p>`   |
+| `ipsum-w-{n}`      | Insère exactement **n** mots en texte brut        |
+
+#### Exemples HTML
+
+```html
+<!-- 3 paragraphes par défaut -->
+<div class="ipsum"></div>
+
+<!-- 12 paragraphes -->
+<div class="ipsum-p-12"></div>
+
+<!-- 122 mots -->
+<div class="ipsum-w-122"></div>
+```
+
+Résultat généré dans le DOM pour `ipsum-p-2` :
+
+```html
+<div class="ipsum-p-2">
+  <p>Lorem qui eos reiciendis error commodo itaque mollit quae.</p>
+  <p>Ratione omnis quaerat reprehenderit aut voluptatem veniam modi deserunt.</p>
+</div>
+```
+
+---
+
+## Partie 2 — Magic: The Gathering
+
+### Fonctionnement interne
+
+La classe `Mtg` communique avec l'[API publique Scryfall](https://scryfall.com/docs/api) pour récupérer les données d'une carte MTG au format JSON.
+
+Deux modes sont disponibles :
+
+| Mode          | Endpoint Scryfall appelé                          |
+|---------------|---------------------------------------------------|
+| Aléatoire     | `GET https://api.scryfall.com/cards/random`       |
+| Par édition   | `GET https://api.scryfall.com/cards/{ed}/{id}`    |
+
+Les paramètres `ed` et `id` correspondent au **code de l'édition** (ex: `dom`, `mh2`, `lea`) et au **numéro de collectionneur** de la carte dans cette édition.
+
+> Les codes d'édition Scryfall sont consultables sur [scryfall.com/sets](https://scryfall.com/sets).
+
+L'instance `Mtg` est **thenable** : elle peut être utilisée directement avec `await` ou `.then()`, sans appeler de méthode supplémentaire. La requête HTTP démarre dès la construction de l'objet.
+
+Compatibilité réseau :
+- Navigateur et Node.js 18+ : utilise `fetch` natif
+- Node.js < 18 : utilise le module `https` de la librairie standard
+
+---
+
+### Usage en JavaScript
+
+```js
+const { Mtg } = require('node-tp2');
+```
+
+#### Carte aléatoire
+
+```js
+const card = await new Mtg({ rand: true });
+
+console.log(card.name);         // "Black Lotus"
+console.log(card.type_line);    // "Artifact"
+console.log(card.set_name);     // "Limited Edition Alpha"
+```
+
+#### Carte spécifique (édition + numéro)
+
+```js
+// Carte #1 de l'édition "Dominaria" (code: dom)
+const card = await new Mtg({ ed: 'dom', id: 1 });
+
+console.log(card.name);         // "Karn, Scion of Urza"
+console.log(card.collector_number); // "1"
+```
+
+#### Avec `.then()` / `.catch()`
+
+```js
+new Mtg({ rand: true })
+  .then(card => console.log(card.name))
+  .catch(err => console.error('Erreur:', err.message));
+```
+
+#### Accéder aux données après résolution
+
+Une fois l'instance résolue, la carte est stockée dans `instance.card` :
+
+```js
+const mtg = new Mtg({ rand: true });
+await mtg;
+
+console.log(mtg.card.name);
+console.log(mtg.card.image_uris.normal); // URL de l'image
+```
+
+#### Structure de la réponse Scryfall (extrait)
+
+```json
+{
+  "name": "Karn, Scion of Urza",
+  "type_line": "Legendary Planeswalker — Karn",
+  "set": "dom",
+  "set_name": "Dominaria",
+  "collector_number": "1",
+  "image_uris": {
+    "normal": "https://cards.scryfall.io/normal/..."
+  }
+}
+```
+
+---
+
+### Usage via le DOM
+
+La méthode statique `Mtg.init()` parcourt la page et remplit automatiquement tous les éléments dont la classe commence par `mtg-`.
+
+```html
+<script>
+  const { Mtg } = require('node-tp2');
+  Mtg.init();
+</script>
+```
+
+#### Classes CSS reconnues
+
+| Classe CSS              | Comportement                                          |
+|-------------------------|-------------------------------------------------------|
+| `mtg-rand`              | Affiche une carte aléatoire                           |
+| `mtg-ed{code}-id{n}`   | Affiche la carte #n de l'édition dont le code est `code` |
+
+#### Exemples HTML
+
+```html
+<!-- Carte aléatoire -->
+<div class="mtg-rand"></div>
+
+<!-- Carte #122 de l'édition "Dominaria" (code: dom) -->
+<div class="mtg-eddom-id122"></div>
+
+<!-- Carte #45 de l'édition "Modern Horizons 2" (code: mh2) -->
+<div class="mtg-edmh2-id45"></div>
+```
+
+#### Rendu HTML généré
+
+Chaque `<div>` est rempli avec la structure suivante :
+
+```html
+<div class="mtg-card">
+  <img src="https://cards.scryfall.io/normal/..." alt="Nom de la carte" style="max-width:100%">
+  <div class="mtg-card-info">
+    <strong>Nom de la carte</strong>
+    <em>Type de la carte</em>
+    <span>Nom de l'édition — #Numéro</span>
+  </div>
+</div>
+```
+
+> En cas d'erreur (carte introuvable, réseau indisponible), l'élément affiche `Carte introuvable.` et l'erreur est loggée dans la console.
+
+---
+
+## Exemple HTML complet
+
+```html
+<!DOCTYPE html>
+<html lang="fr">
+<head>
+  <meta charset="UTF-8">
+  <title>Démo node-tp2</title>
+  <style>
+    body { font-family: sans-serif; max-width: 800px; margin: 2rem auto; padding: 0 1rem; }
+    .mtg-card { border: 1px solid #ccc; padding: 1rem; border-radius: 8px; max-width: 300px; }
+    .mtg-card-info { margin-top: .5rem; display: flex; flex-direction: column; gap: .25rem; }
+  </style>
+</head>
+<body>
+
+  <h1>Lorem Ipsum</h1>
+
+  <h2>Défaut (3 paragraphes)</h2>
+  <div class="ipsum"></div>
+
+  <h2>5 paragraphes</h2>
+  <div class="ipsum-p-5"></div>
+
+  <h2>20 mots</h2>
+  <div class="ipsum-w-20"></div>
+
+  <hr>
+
+  <h1>Magic: The Gathering</h1>
+
+  <h2>Carte aléatoire</h2>
+  <div class="mtg-rand"></div>
+
+  <h2>Karn, Scion of Urza (dom #1)</h2>
+  <div class="mtg-eddom-id1"></div>
+
+  <script src="https://unpkg.com/node-tp2/index.js"></script>
+  <script>
+    const { Ipsum, Mtg } = require('node-tp2');
+    Ipsum.init();
+    Mtg.init();
+  </script>
+
+</body>
+</html>
+```
+
+---
+
+## Référence API
+
+### `new Ipsum(options)`
+
+| Option       | Type   | Description                                 |
+|--------------|--------|---------------------------------------------|
+| `paragrafs`  | number | Nombre de paragraphes à générer (défaut: 1) |
+| `words`      | number | Nombre exact de mots à générer              |
+
+> Si les deux options sont fournies, `words` est prioritaire.
+
+**Propriétés de l'instance :**
+
+| Propriété | Type   | Description                         |
+|-----------|--------|-------------------------------------|
+| `text`    | string | Le texte généré                     |
+
+**Méthodes statiques :**
+
+| Méthode        | Description                                                   |
+|----------------|---------------------------------------------------------------|
+| `Ipsum.init()` | Scanne le DOM et remplit les éléments avec la classe `ipsum*` |
+
+---
+
+### `new Mtg(options)`
+
+| Option | Type    | Description                                          |
+|--------|---------|------------------------------------------------------|
+| `rand` | boolean | Si `true`, récupère une carte aléatoire              |
+| `ed`   | string  | Code de l'édition Scryfall (ex: `dom`, `mh2`, `lea`) |
+| `id`   | number  | Numéro de collectionneur de la carte dans l'édition  |
+
+> `ed` et `id` doivent être fournis ensemble. `rand: true` prend le dessus.
+
+**L'instance est thenable :** elle peut être passée directement à `await` ou `.then()`.
+
+**Propriétés de l'instance (après résolution) :**
+
+| Propriété | Type   | Description                              |
+|-----------|--------|------------------------------------------|
+| `card`    | object | Objet JSON complet retourné par Scryfall |
+
+**Méthodes statiques :**
+
+| Méthode      | Description                                                     |
+|--------------|-----------------------------------------------------------------|
+| `Mtg.init()` | Scanne le DOM et remplit les éléments avec la classe `mtg-*`   |
+
+---
+
+## Publier sur NPM
+
+```bash
+# 1. Se connecter à son compte NPM
+npm login
+
+# 2. Vérifier que le nom du package est disponible
+npm search node-tp2
+
+# 3. Publier
+npm publish
+
+# 4. Pour mettre à jour plus tard : incrémenter la version puis republier
+npm version patch   # 1.0.0 → 1.0.1
+npm version minor   # 1.0.0 → 1.1.0
+npm version major   # 1.0.0 → 2.0.0
+npm publish
+```
+
+> Le champ `"name"` dans `package.json` doit être unique sur le registre NPM. Si `node-tp2` est déjà pris, choisir un nom différent ou utiliser un scope : `@votre-username/node-tp2`.
+
+---
+
+## Auteur
+
+**Vidar Ivory** — [GitHub](https://github.com/VidarIvory)
+
+## Licence
+
+ISC

package/index.js

@@ -0,0 +1,209 @@
+'use strict';
+
+// ─── Word List ────────────────────────────────────────────────────────────────
+const WORD_LIST = [
+  'lorem', 'ipsum', 'dolor', 'sit', 'amet', 'consectetur', 'adipiscing', 'elit',
+  'sed', 'do', 'eiusmod', 'tempor', 'incididunt', 'ut', 'labore', 'et', 'dolore',
+  'magna', 'aliqua', 'enim', 'ad', 'minim', 'veniam', 'quis', 'nostrud',
+  'exercitation', 'ullamco', 'laboris', 'nisi', 'aliquip', 'ex', 'ea', 'commodo',
+  'consequat', 'duis', 'aute', 'irure', 'reprehenderit', 'voluptate', 'velit',
+  'esse', 'cillum', 'fugiat', 'nulla', 'pariatur', 'excepteur', 'sint', 'occaecat',
+  'cupidatat', 'non', 'proident', 'sunt', 'culpa', 'qui', 'officia', 'deserunt',
+  'mollit', 'anim', 'est', 'laborum', 'perspiciatis', 'unde', 'omnis', 'iste',
+  'natus', 'error', 'voluptatem', 'accusantium', 'doloremque', 'laudantium',
+  'totam', 'rem', 'aperiam', 'eaque', 'ipsa', 'quae', 'illo', 'inventore',
+  'veritatis', 'quasi', 'architecto', 'beatae', 'vitae', 'dicta', 'explicabo',
+  'nemo', 'ipsam', 'quia', 'voluptas', 'aspernatur', 'odit', 'aut', 'fugit',
+  'magni', 'dolores', 'eos', 'ratione', 'sequi', 'nesciunt', 'neque', 'porro',
+  'quisquam', 'dolorem', 'adipisci', 'numquam', 'eius', 'modi', 'tempora',
+  'quaerat', 'minima', 'nostrum', 'exercitationem', 'ullam', 'corporis', 'suscipit',
+  'laboriosam', 'quid', 'rerum', 'facilis', 'provident', 'similique', 'dignissimos',
+  'blanditiis', 'praesentium', 'voluptatum', 'deleniti', 'atque', 'corrupti',
+  'quos', 'maxime', 'placeat', 'facere', 'possimus', 'omnis', 'voluptas',
+  'assumenda', 'repellendus', 'temporibus', 'autem', 'quibusdam', 'officiis',
+  'debitis', 'rerum', 'necessitatibus', 'saepe', 'eveniet', 'voluptates',
+  'repudiandae', 'recusandae', 'itaque', 'earum', 'hic', 'tenetur', 'sapiente',
+  'delectus', 'reiciendis', 'voluptatibus', 'maiores', 'alias', 'consequatur',
+  'aut', 'perferendis', 'doloribus', 'asperiores', 'repellat'
+];
+
+// ─── Ipsum Class ──────────────────────────────────────────────────────────────
+class Ipsum {
+  constructor(options = {}) {
+    this.options = options;
+    this.text = this._generate();
+  }
+
+  _randomWord() {
+    return WORD_LIST[Math.floor(Math.random() * WORD_LIST.length)];
+  }
+
+  _generateSentence() {
+    const length = Math.floor(Math.random() * 10) + 5; // 5–14 words
+    const words = [];
+    for (let i = 0; i < length; i++) words.push(this._randomWord());
+    words[0] = words[0].charAt(0).toUpperCase() + words[0].slice(1);
+    return words.join(' ') + '.';
+  }
+
+  _generateParagraph() {
+    const sentenceCount = Math.floor(Math.random() * 4) + 3; // 3–6 sentences
+    const sentences = [];
+    for (let i = 0; i < sentenceCount; i++) sentences.push(this._generateSentence());
+    return sentences.join(' ');
+  }
+
+  _generateWords(count) {
+    const words = [];
+    for (let i = 0; i < count; i++) words.push(this._randomWord());
+    return words.join(' ');
+  }
+
+  _generate() {
+    if (this.options.words) {
+      return this._generateWords(this.options.words);
+    }
+    const count = this.options.paragrafs || 1;
+    const paragraphs = [];
+    for (let i = 0; i < count; i++) paragraphs.push(this._generateParagraph());
+    return paragraphs.join('\n\n');
+  }
+
+  toString() {
+    return this.text;
+  }
+
+  // Scans the DOM and fills elements based on their CSS class
+  static init() {
+    if (typeof document === 'undefined') return;
+
+    document.querySelectorAll('[class*="ipsum"]').forEach(el => {
+      const cls = el.className;
+      const pMatch = cls.match(/ipsum-p-(\d+)/);
+      const wMatch = cls.match(/ipsum-w-(\d+)/);
+
+      if (pMatch) {
+        const ipsum = new Ipsum({ paragrafs: parseInt(pMatch[1]) });
+        const paras = ipsum.text.split('\n\n');
+        el.innerHTML = paras.map(p => `<p>${p}</p>`).join('');
+      } else if (wMatch) {
+        const ipsum = new Ipsum({ words: parseInt(wMatch[1]) });
+        el.textContent = ipsum.text;
+      } else {
+        // Default: class="ipsum" → 3 paragraphs
+        const ipsum = new Ipsum({ paragrafs: 3 });
+        const paras = ipsum.text.split('\n\n');
+        el.innerHTML = paras.map(p => `<p>${p}</p>`).join('');
+      }
+    });
+  }
+}
+
+// ─── HTTP Helper ──────────────────────────────────────────────────────────────
+function httpGet(url) {
+  // Use native fetch if available (browser or Node 18+)
+  if (typeof fetch !== 'undefined') {
+    return fetch(url).then(r => {
+      if (!r.ok) throw new Error(`HTTP ${r.status}`);
+      return r.json();
+    });
+  }
+
+  // Fallback for older Node.js versions
+  return new Promise((resolve, reject) => {
+    const https = require('https');
+    https.get(url, res => {
+      let data = '';
+      res.on('data', chunk => (data += chunk));
+      res.on('end', () => {
+        try { resolve(JSON.parse(data)); }
+        catch (e) { reject(e); }
+      });
+    }).on('error', reject);
+  });
+}
+
+// ─── Mtg Class ────────────────────────────────────────────────────────────────
+class Mtg {
+  constructor(options = {}) {
+    this.options = options;
+    this.card = null;
+    this._promise = this._fetch();
+  }
+
+  _fetch() {
+    let url;
+
+    if (this.options.rand) {
+      url = 'https://api.scryfall.com/cards/random';
+    } else if (this.options.ed !== undefined && this.options.id !== undefined) {
+      // Scryfall: /cards/{set_code}/{collector_number}
+      url = `https://api.scryfall.com/cards/${this.options.ed}/${this.options.id}`;
+    } else {
+      return Promise.reject(new Error('MTG: provide { rand: true } or { ed, id }'));
+    }
+
+    return httpGet(url).then(card => {
+      this.card = card;
+      return card;
+    });
+  }
+
+  // Makes Mtg instances thenable (await new Mtg({...}))
+  then(resolve, reject) {
+    return this._promise.then(resolve, reject);
+  }
+
+  catch(reject) {
+    return this._promise.catch(reject);
+  }
+
+  static _renderCard(card, el) {
+    const img =
+      card.image_uris?.normal ||
+      card.card_faces?.[0]?.image_uris?.normal ||
+      '';
+
+    el.innerHTML = `
+      <div class="mtg-card">
+        ${img ? `<img src="${img}" alt="${card.name}" style="max-width:100%">` : ''}
+        <div class="mtg-card-info">
+          <strong>${card.name}</strong>
+          <em>${card.type_line || ''}</em>
+          <span>${card.set_name || ''} — #${card.collector_number || ''}</span>
+        </div>
+      </div>`;
+  }
+
+  // Scans the DOM and fills elements based on their CSS class
+  static init() {
+    if (typeof document === 'undefined') return;
+
+    document.querySelectorAll('[class*="mtg-"]').forEach(async el => {
+      const cls = el.className;
+      let mtgInstance;
+
+      if (cls.includes('mtg-rand')) {
+        mtgInstance = new Mtg({ rand: true });
+      } else {
+        // Matches: mtg-ed{set}-id{number}  e.g. mtg-ed12-id122  or  mtg-edMH2-id45
+        const match = cls.match(/mtg-ed(\w+)-id(\d+)/);
+        if (match) {
+          mtgInstance = new Mtg({ ed: match[1], id: match[2] });
+        }
+      }
+
+      if (mtgInstance) {
+        try {
+          const card = await mtgInstance;
+          Mtg._renderCard(card, el);
+        } catch (e) {
+          el.textContent = 'Carte introuvable.';
+          console.error(e);
+        }
+      }
+    });
+  }
+}
+
+module.exports = { Ipsum, Mtg };

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "node-tp2-vidar",
+  "version": "1.0.0",
+  "description": "Lorem ipsum generator and MTG card viewer via Scryfall API",
+  "homepage": "https://github.com/VidarIvory/Node-TP2#readme",
+  "bugs": {
+    "url": "https://github.com/VidarIvory/Node-TP2/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/VidarIvory/Node-TP2.git"
+  },
+  "license": "ISC",
+  "author": "Vidar Ivory",
+  "type": "commonjs",
+  "main": "index.js",
+  "keywords": ["lorem", "ipsum", "mtg", "magic", "scryfall", "generator"],
+  "scripts": {
+    "test": "node test.js"
+  }
+}

package/test.js

@@ -0,0 +1,27 @@
+'use strict';
+const { Ipsum, Mtg } = require('./index');
+
+// ─── Test Ipsum ───────────────────────────────────────────────────────────────
+console.log('=== IPSUM TESTS ===\n');
+
+const byParagrafs = new Ipsum({ paragrafs: 2 });
+console.log('2 paragraphs:');
+console.log(byParagrafs.text);
+console.log();
+
+const byWords = new Ipsum({ words: 10 });
+console.log('10 words:', byWords.text);
+console.log();
+
+// ─── Test Mtg ─────────────────────────────────────────────────────────────────
+console.log('=== MTG TESTS ===\n');
+
+const rand = new Mtg({ rand: true });
+rand
+  .then(card => console.log('Random card:', card.name, '—', card.set_name))
+  .catch(err => console.error('Error:', err.message));
+
+const specific = new Mtg({ ed: 'dom', id: 1 });
+specific
+  .then(card => console.log('Specific card (dom/1):', card.name))
+  .catch(err => console.error('Error:', err.message));