ci(docs): auto-publish TypeDoc API reference to gh-pages

.github/workflows/chaos.yml

@@ -27,6 +27,9 @@ jobs:
       - name: Install dependencies
         run: npm ci
 
+      - name: Generate Prisma client
+        run: npx prisma generate
+
       - name: Verify Docker is available
         run: docker info
 

.github/workflows/ci.yml

@@ -33,7 +33,7 @@ jobs:
           cache: npm
       - run: npm ci || npm install
       - run: npx prisma generate
-      - run: docker compose -f docker-compose.test.yml up -d --build
+      - run: docker compose -f docker-compose.test.yml up -d --build --wait
       - run: npm run test:integration
         env:
           DATABASE_URL: postgresql://wraith:wraith@localhost:55432/wraith_test

.github/workflows/typedoc.yml

@@ -20,7 +20,7 @@ jobs:
           cache: npm
       - run: npm ci || npm install
       - run: npx prisma generate
-      - run: npx typedoc
+      - run: npm run docs
       - name: Deploy to gh-pages
         uses: peaceiris/actions-gh-pages@v3
         with:

README.md

@@ -68,7 +68,7 @@ cp .env.example .env
 
 **Testnet setup** (quick start):
 
-```env
+```bash
 DATABASE_URL="postgresql://wraith:wraith@localhost:5432/wraith"
 STELLAR_NETWORK="testnet"
 # SOROBAN_RPC_URL is optional on testnet — the default public endpoint is used automatically
@@ -81,7 +81,7 @@ PORT=3000
 
 **Mainnet setup** (production):
 
-```env
+```bash
 DATABASE_URL="postgresql://wraith:wraith@localhost:5432/wraith"
 STELLAR_NETWORK="mainnet"
 # Required on mainnet — no free public Soroban RPC exists

jest.chaos.config.js

@@ -1,10 +1,12 @@
 /** @type {import('jest').Config} */
 module.exports = {
-  preset: "ts-jest",
   testEnvironment: "node",
   roots: ["<rootDir>/tests/chaos"],
   testMatch: ["**/*.test.ts"],
   moduleFileExtensions: ["ts", "js", "json"],
+  transform: {
+    "^.+\\.tsx?$": ["ts-jest", { tsconfig: "tsconfig.test.json" }],
+  },
   clearMocks: true,
   testTimeout: 300_000, // 5 minutes — Docker build + full chaos scenario
 };

openapi.yaml

@@ -23,7 +23,7 @@ paths:
           content:
             application/json:
               schema:
-                type: object
+                type: object  
                 required: [ok, uptime]
                 properties:
                   ok: