Add Discordjs

2026-09-04 22:10:35 -04:00
parent 998cb3521f
commit 693814f46b
85 changed files with 5945 additions and 28 deletions
@@ -0,0 +1,37 @@
+# bare-discord-js Production Implementation Plan
+
+This file mirrors the approved execution plan and is tracked in-repo as the implementation contract.
+
+## Goal
+- Provide `require('bare-discord-js')` and `import ... from 'bare-discord-js'` parity with official `discord.js` 14.27+ inside Bare.
+- Ensure end users install only one package and do not configure aliases/import maps manually.
+- Gate releases on strict parity verification.
+
+## Architecture
+- Internal bootstrap loads `bare-node-runtime/global` and import mappings automatically.
+- Dual entrypoints (`src/index.js` [CJS], `src/index.mjs` [ESM]) re-export official `discord.js`.
+- Compatibility adapters isolate runtime differences (WebSocket, TLS/HTTPS, zlib, crypto).
+- Patch manifest and automation scripts track upstream drift and compatibility work.
+
+## Delivery Phases
+1. Baseline inventory scripts for dependency and builtin mapping.
+2. Bootstrap loader and import-map encapsulation.
+3. Adapter and patch infrastructure.
+4. Build/packaging workflow (npm + optional bare-pack).
+5. Parity test harness (Node vs Bare behavior checks).
+6. Release verification and upstream sync automation.
+
+## Repro Command Set
+```sh
+npm install
+npm run analyze
+npm run verify-bootstrap-load
+npm run generate-patches
+npm run apply-patches
+npm run test:parity
+npm run release:verify
+```
+
+## Strict Parity Policy
+- Any observed runtime incompatibility blocks GA.
+- Voice/gateway/rest paths are all required unless explicitly re-scoped.