dgra-bridge

SDK JavaScript pour DGRA Bridge — imprimer et piloter les périphériques locaux depuis une application web, sans écrire les appels HTTP à la main.

Prérequis : DGRA Bridge installé et lancé sur le PC (barre système). Le SDK ne remplace pas l’agent local.

Installation

npm install dgra-bridge

Utilisation

Récupère la clé API dans les paramètres de DGRA Bridge (icône barre système), puis :

import { DGRA } from "dgra-bridge";

const dgra = new DGRA({
  apiKey: "VOTRE_CLE",
});

// Santé du service
await dgra.status();

// Imprimantes disponibles
const printers = await dgra.printers();

// Impression texte
await dgra.print({
  type: "text",
  content: "Ticket caisse",
  cut: false,
});

// Impression ESC/POS (données en Base64)
await dgra.print({
  type: "escpos",
  data: "GSA...", // Base64
  cut: true,
});

// Tiroir-caisse
await dgra.cashDrawer.open();

Options

new DGRA({
  apiKey: "VOTRE_CLE",                 // obligatoire
  baseUrl: "http://127.0.0.1:9191",    // optionnel
  origin: "https://mon-application.com", // utile hors navigateur (Node / Electron)
});

Dans le navigateur, autorise l’origine de ton site dans DGRA Bridge (Applications autorisées).

CDN (sans bundler)

<script type="module">
  import { DGRA } from "https://cdn.jsdelivr.net/npm/[email protected]/+esm";

  const dgra = new DGRA({ apiKey: "VOTRE_CLE" });
  await dgra.print({ type: "text", content: "Hello" });
</script>

API du SDK

| Méthode | Description | |---------|-------------| | status() | État du bridge local | | printers() | Liste des imprimantes | | devices() | Liste des périphériques | | print({ type, content?, data?, printer?, cut? }) | Impression (text / escpos / raw) | | cashDrawer.open({ printer?, pin? }) | Ouverture du tiroir |

Dépannage

| Problème | À vérifier | |----------|------------| | Erreur réseau / fetch failed | DGRA Bridge est-il lancé ? | | 401 | Clé API incorrecte | | 403 | Origine du site non autorisée dans le tray | | Aucune imprimante | Pilote installé + imprimante par défaut dans Bridge |

Licence

MIT