discord-bot-maker-runtime

Runtime partagé des bots générés par Discord Bot Maker.

Ce paquet contient toutes les fonctions génériques (envoi de messages et d'embeds, gestion des rôles et des salons, conditions sur les membres, variables persistées, utilitaires date/heure, planification, classements…) que le code exporté appelle. Grâce à lui, un bot exporté ne contient plus des milliers de lignes de moteur : il importe simplement discord-bot-maker-runtime comme dépendance, et son propre code reste court et lisible.

Contenu

• runtime — helpers Discord (sendReply, sendRichMessage, addRole, banMember, interpolate, formatInZone, scheduleDaily, formatLeaderboard, …) et le type partagé BlockContext.
• variableStore — readVariable / writeVariable, stockage clé/valeur persistant.

La couche base de données n'est pas ici : elle est générée dans chaque bot (src/lib/database.ts) car elle dépend du backend choisi (local/JSON, SQLite, Postgres, MySQL, Mongo).

Publier (à faire par le mainteneur de la plateforme)

Les bots exportés déclarent discord-bot-maker-runtime en dépendance. Pour que leur npm install réussisse, ce paquet doit être disponible sur le registre npm.

cd packages/runtime
npm run build        # compile src/ -> dist/
npm publish --access public

Garde le numéro de version aligné avec RUNTIME_PACKAGE_VERSION dans lib/compiler/runtime-package.ts (le compilateur y lit la version injectée dans le package.json de chaque bot). À chaque évolution du runtime, incrémente la version, republie, puis mets à jour cette constante.

Registre privé (alternative)

Si tu ne veux pas publier publiquement, héberge le paquet sur un registre privé (npm privé, GitHub Packages, Verdaccio) et adapte RUNTIME_PACKAGE / la config npm des bots en conséquence.

Développement local

Ce paquet est un workspace npm de la racine du dépôt (workspaces: ["packages/*"]), donc npm install à la racine crée un lien symbolique node_modules/discord-bot-maker-runtime → packages/runtime. C'est ce lien qui permet aux tests de compilation (assertGeneratedProjectTypeChecks) de résoudre le paquet sans publication. Après toute modification de src/, relance npm run build pour régénérer dist/.