Foundry and discord bot
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m51s
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m51s
This commit is contained in:
@@ -46,6 +46,12 @@ jobs:
|
||||
docker build -t git.aranroig.com/${{ secrets.REGISTRY_USER }}/dragonroll-backend:latest ./backend
|
||||
docker push git.aranroig.com/${{ secrets.REGISTRY_USER }}/dragonroll-backend:latest
|
||||
|
||||
- name: Build discord bot
|
||||
run: |
|
||||
docker build -t git.aranroig.com/${{ secrets.REGISTRY_USER }}/dragonroll-discord-bot:latest \
|
||||
./discord-bot
|
||||
docker push git.aranroig.com/${{ secrets.REGISTRY_USER }}/dragonroll-discord-bot:latest
|
||||
|
||||
- name: Copy files
|
||||
run: |
|
||||
scp docker-compose.yml deploy@${{ secrets.DEPLOY_HOST}}:/var/www/app/
|
||||
|
||||
3
.gitignore
vendored
3
.gitignore
vendored
@@ -1 +1,2 @@
|
||||
node_modules
|
||||
node_modules
|
||||
.env
|
||||
471
AGENTS.md
Normal file
471
AGENTS.md
Normal file
@@ -0,0 +1,471 @@
|
||||
# AGENTS.md — Dragonroll
|
||||
|
||||
Read this file before touching the code. It is a complete map of the project: layout, architecture,
|
||||
data model, API, conventions and known landmines. You should not need to explore the rest of the repo
|
||||
to make a correct change.
|
||||
|
||||
## 1. What this is
|
||||
|
||||
**Dragonroll** is a free/open-source helper for tabletop RPG campaigns (notes, campaigns, folders,
|
||||
dice widgets, shared markdown, sounds). It is a two-app monorepo:
|
||||
|
||||
- `backend/` — Node + **Express 5** + **Mongoose 9** (MongoDB) REST API, JWT auth. CommonJS.
|
||||
- `frontend/` — **Nuxt 4 / Vue 3** client (Composition API, `<script setup>`), SCSS, axios, marked, mitt, motion.
|
||||
|
||||
There is **no** database seeding, no ORM migrations, no test suite, no linter/formatter config, no
|
||||
Pinia/Vuex, and no Vue Router pages (see §5.1 — the UI is a window manager, not routed pages).
|
||||
|
||||
Git: default branch `master`, hosted on a self-hosted Gitea (`git.aranroig.com/BinarySandia04/Dragonroll`).
|
||||
CI (`.gitea/workflows/deploy.yml`) builds two Docker images on every push to `master`, pushes them to
|
||||
`git.aranroig.com/<user>/dragonroll-{frontend,backend}:latest`, copies `docker-compose.yml` +
|
||||
`nginx.conf` to the deploy host and runs `docker compose pull && up -d`.
|
||||
|
||||
## 2. Root layout
|
||||
|
||||
```
|
||||
dragonroll/
|
||||
├── backend/ Express API (CommonJS, entry: src/index.js)
|
||||
├── frontend/ Nuxt 4 app (entry: app/app.vue)
|
||||
├── docker-compose.yml nginx :3000 -> frontend :3000, /api -> backend :5000
|
||||
├── nginx.conf reverse proxy rules for the compose stack
|
||||
├── ecosystem.config.js PM2 config (stale: runs `npm start`, which does not exist — see §9)
|
||||
├── .gitea/workflows/deploy.yml
|
||||
├── static/media/ README logo images only
|
||||
├── package.json root: only `concurrently`, used by `npm run dev`
|
||||
└── README.md install/run instructions are STALE (see §9)
|
||||
```
|
||||
|
||||
## 3. Commands
|
||||
|
||||
```bash
|
||||
npm install # root: installs `concurrently` only
|
||||
npm install --prefix backend
|
||||
npm install --prefix frontend # runs `nuxt prepare` via postinstall
|
||||
|
||||
npm run dev # both apps: backend (nodemon, :5000) + frontend (nuxt dev, :3000)
|
||||
# also runs the Foundry VTT start script from root .env
|
||||
# (FOUNDRY_START_SCRIPT, via scripts/run-foundry.js)
|
||||
npm --prefix backend run dev # backend only
|
||||
npm --prefix frontend run dev # frontend only
|
||||
npm --prefix frontend run build # nuxt build --dotenv .env.production
|
||||
npm --prefix frontend run preview
|
||||
```
|
||||
|
||||
There is no `start` script in either package, no test command, and no lint command.
|
||||
Verification = run the dev server and exercise the flow (`/api/test` returns a JSON hello).
|
||||
|
||||
### Environment files
|
||||
|
||||
| File | Contents | Notes |
|
||||
|---|---|---|
|
||||
| `.env` (root) | `FOUNDRY_START_SCRIPT=<path to Foundry VTT start.sh>` | gitignored; consumed by `scripts/run-foundry.js` during `npm run dev` |
|
||||
| `backend/.env` | `PORT=5000`, `DB_URI=mongodb://localhost:27017/dragonroll`, `NODE_ENV=development` | gitignored |
|
||||
| `backend/.env.production` | same shape, `DB_URI=mongodb://192.168.1.7:27017/dragonroll` | **committed** |
|
||||
| `frontend/.env` | `NUXT_PUBLIC_API_BASE_URL=http://localhost:5000/api` | gitignored |
|
||||
| `frontend/.env.production` | `NUXT_PUBLIC_API_BASE_URL=https://dragonroll.aranroig.com/api` | **committed** |
|
||||
|
||||
`backend/src/index.js` loads `.env.$NODE_ENV` when `NODE_ENV` is set, otherwise plain `.env`.
|
||||
`PORT` is read from env but **ignored**: the server always listens on 5000.
|
||||
|
||||
## 4. Backend
|
||||
|
||||
```
|
||||
backend/src/
|
||||
├── index.js app bootstrap: dotenv, static uploads, json limits (50mb),
|
||||
│ passport init, CORS, route mounting, listen(5000)
|
||||
├── db.js connectDB() -> mongoose.connect(process.env.DB_URI)
|
||||
├── models/ User.js Campaign.js Note.js Folder.js
|
||||
├── routes/ user.js campaign.js note.js folder.js
|
||||
├── services/
|
||||
│ ├── keys.js { secret: "putyoursecrethere" } <- JWT secret, hardcoded
|
||||
│ ├── passport.js JwtStrategy: Bearer token -> User.findById(jwt_payload._id)
|
||||
│ ├── middleware.js isAdmin — imported by routes/user.js but applied to no route yet
|
||||
│ ├── rate-limiter.js express-rate-limit: 150 req / 60 min, applied to /user/login and /user/setup
|
||||
│ └── storage.js multer diskStorage -> backend/src/uploads/, filename `<field>-<timestamp><ext>`
|
||||
└── uploads/ created on demand, gitignored, served PUBLICLY at /api/public
|
||||
```
|
||||
|
||||
### Auth chain (order matters, `src/index.js`)
|
||||
|
||||
1. `/api/public/*` → static file serving of `src/uploads` (no auth).
|
||||
2. `app.use('/api/user', routes/user)` → **mounted before the JWT guard**, so the whole user router is
|
||||
reachable unauthenticated. Individual handlers that need a user call
|
||||
`passport.authenticate('jwt', {session:false})` inline (`/upload-avatar`, `/update-settings`,
|
||||
`/get-settings`).
|
||||
3. `checkAuth = passport.authenticate('jwt', { session: false })` — note the **missing declaration**
|
||||
(implicit global). Everything mounted after this is JWT-protected.
|
||||
4. `/api/campaign`, `/api/note`, `/api/folder`.
|
||||
|
||||
JWT: signed in `POST /api/user/login` with payload `{ _id, username, name, email, admin, settings }`,
|
||||
`expiresIn: 172800` (48h). `req.user` is the Mongoose `User` document, so routes use `req.user.id`.
|
||||
|
||||
### Response convention
|
||||
|
||||
Every endpoint returns HTTP 200 with a JSON envelope; there is almost no real status-code usage:
|
||||
|
||||
```jsonc
|
||||
{ "status": "ok", ...payload }
|
||||
{ "status": "error", "msg": "errors.internal" } // msg is an i18n KEY, not prose
|
||||
```
|
||||
|
||||
Common `msg` keys: `errors.missing-data`, `errors.notfound`, `errors.internal`, `unauthorized`,
|
||||
`login.errors.invalid-credentials`, `register.errors.email-username-exists`. The frontend checks
|
||||
`response.data.status !== 'ok'`. `GET /user/has-admin` uses a special `status: "init"` to mean
|
||||
"no admin exists yet → show first-run registration".
|
||||
|
||||
### Authorization model
|
||||
|
||||
Single-tenant per user: a campaign belongs to `createdBy`, everything else hangs off a campaign.
|
||||
`note.js` and `folder.js` define a local helper:
|
||||
|
||||
```js
|
||||
async function userOwnsCampaign(campaignId, userId) { ... } // duplicated in both files
|
||||
```
|
||||
|
||||
Ownership is enforced per handler. `settings`, `color`, `description` and `User.settings` are schemaless
|
||||
`Object`/free-form fields.
|
||||
|
||||
### Data model
|
||||
|
||||
```
|
||||
User ──< Campaign ──< Note ──?> Folder ──?> Folder (parentFolder, self-ref)
|
||||
└───────< Folder
|
||||
```
|
||||
|
||||
| Model | File | Fields |
|
||||
|---|---|---|
|
||||
| `User` | `models/User.js` | `name*`, `username*` (unique), `email*` (unique), `password` (bcrypt hash, 10 salt rounds), `date`, `admin` (bool, default false), `image`, `setupCode`, `settings` (Object) |
|
||||
| `Campaign` | `models/Campaign.js` | `name*`, `description`, `color`, `createdBy*` → User, `date`, `settings` (Object) |
|
||||
| `Note` | `models/Note.js` | `title`, `content` (markdown source string), `campaign*` → Campaign, `folder` → Folder (null = root), `date` |
|
||||
| `Folder` | `models/Folder.js` | `name*`, `campaign*` → Campaign, `parentFolder` → Folder (null = root), `date` |
|
||||
|
||||
`*` = required. Notes and folders are ordered by `date: -1` everywhere.
|
||||
|
||||
### API reference
|
||||
|
||||
`POST /api/user/register` — body `{username,email,name,password}`. First registered user becomes
|
||||
`admin: true`. (Currently broken: see §9.)
|
||||
|
||||
`GET /api/user/verify-setup?code=` — `{status:'ok',code}` | `{status:'error',msg:'not-exists'}`
|
||||
|
||||
`POST /api/user/setup?code=` — rate limited. Body `{name,username,email,password}` completes an
|
||||
invited account (`setupCode` is cleared).
|
||||
|
||||
`POST /api/user/login` — rate limited. Body `{usermail,password}` (accepts username **or** email) →
|
||||
`{status:'ok', token, msg:'success'}`.
|
||||
|
||||
`POST /api/user/upload-avatar` — multipart field `image`, JWT required → stores filename on `User.image`.
|
||||
Fetch the file from `/api/public/<filename>`.
|
||||
|
||||
`GET /api/user/retrieve-avatar?username=` → `{status:'ok', image}`
|
||||
|
||||
`GET /api/user/has-admin` → `status: 'ok' | 'init' | 'error'`
|
||||
|
||||
`POST /api/user/update-settings` — JWT inline. Body `{ settings: {...} }` (whole object replaced).
|
||||
`GET /api/user/get-settings` — JWT inline → `{status:'ok', settings}`
|
||||
|
||||
`POST /api/campaign/create` — `{name,description,color,settings}` → `{status:'ok',campaign}`
|
||||
`GET /api/campaign/list` → `{status:'ok',campaigns}`
|
||||
`GET /api/campaign/retrieve/:id` → `{status:'ok',campaign}` (401 when no `req.user.id`)
|
||||
|
||||
`GET /api/note/list?campaign=` → `{status:'ok', folders, notes}` — notes with `folder: null` (roots)
|
||||
`GET /api/note/subfolder/list?campaign=&folder=` → `{status:'ok', subfolders, notes}`
|
||||
`POST /api/note/create` — `{title*,content,campaign*,folder?}` (folder validated against campaign)
|
||||
`POST /api/note/update` — `{id*, title?, content?, folder?}` — partial, ownership checked
|
||||
`POST /api/note/delete` — `{id}` — **no ownership check** (§9)
|
||||
|
||||
`GET /api/folder/list?campaign=` → `{status:'ok',folders}`
|
||||
`POST /api/folder/create` — `{name*,campaign*}`
|
||||
`POST /api/folder/rename` — `{id*,name*}`
|
||||
`POST /api/folder/delete` — `{id}` — recursive: notes inside are moved to root (`folder: null`),
|
||||
subfolders re-parented to null then deleted.
|
||||
|
||||
`GET /api/test` — health check.
|
||||
|
||||
## 5. Frontend
|
||||
|
||||
```
|
||||
frontend/
|
||||
├── nuxt.config.ts css order (colors, fonts, main, callouts), runtimeConfig.public
|
||||
│ {apiBaseUrl, gitCommit, gitTag, gitBranch, buildDate}, @nuxtjs/i18n module,
|
||||
│ vite.optimizeDeps; git info harvested at build time via execSync
|
||||
├── 18n.config.ts vue-i18n fallbackLocale 'en'
|
||||
├── i18n/locales/ en/ es/ ca/ (+ empty en.json, es.json, ca.json for the nuxt module)
|
||||
├── public/ img/ icons/{iconoir/{regular,solid},Pixelarticons,ui} sounds/ fonts/{5e,amiri,...}
|
||||
│ → served at /img, /icons, /sounds, /fonts
|
||||
└── app/ Nuxt 4 source root (`~/` and `@/` both alias here)
|
||||
├── app.vue real entry: theme setup + start() boot logic + 5 managers
|
||||
├── assets/css/ colors.scss (theme maps → CSS vars), fonts.scss (5e-style font families),
|
||||
│ main.scss (globals, scrollbars, .icon), callouts.scss (Obsidian-like callouts)
|
||||
├── components/
|
||||
│ ├── managers/ WindowManager, ContentManager, ToastManager, TooltipManager, ContextMenuManager
|
||||
│ ├── windows/ ExampleWindow (template to copy), Login, Register, MainMenu, Settings,
|
||||
│ │ CreateCampaign, RenameNote, NewFolder + partials/{WindowHandle,
|
||||
│ │ FixedBottomButtons, BigIconTemplate}
|
||||
│ ├── partials/ ContentSidebar, NestedNoteList, CampaignEntry, EditUserPartial, Spinner,
|
||||
│ │ VersionRender
|
||||
│ ├── layouts/ IconButton, Dropdown, Tabs, ColorPicker (reusable UI atoms)
|
||||
│ └── viewer/ TopBar, statusbar/{StatusBar,FetchStatus}, topbar/{TopSearchBar,SearchResult},
|
||||
│ content/{Content,NoteContainer,Note}, widgets/{TableWidget,TestWidget,
|
||||
│ inline/RollWidgetInline,display/RollWidgetDisplay}
|
||||
├── composables/ useTheme.ts (theme+accent singletons, localStorage, data-* attrs),
|
||||
│ useEmitter.ts (BROKEN, see §9)
|
||||
├── plugins/ api.ts (inject runtimeConfig apiBaseUrl into the axios instance), i18n.ts
|
||||
└── services/ plain ES modules holding reactive module state (the app has no store)
|
||||
```
|
||||
|
||||
### 5.1 It is not a routed app
|
||||
|
||||
There is no `app/pages/`. `app/app.vue` renders a fixed shell of managers. "Screens" are either:
|
||||
|
||||
- **Windows** — floating, draggable/resizable overlays (login, main menu, settings…), or
|
||||
- **Content** — the campaign workspace (`TopBar` + `ContentSidebar` + note column + `StatusBar`),
|
||||
shown when `Campaign` state is non-null.
|
||||
|
||||
Boot sequence (`app.vue` → `start()`):
|
||||
|
||||
```
|
||||
GetUser() (JWT in localStorage, un-expired)?
|
||||
├─ yes → RestoreCampaign() (localStorage.selectedCampaignId) → on failure open 'main_menu'
|
||||
└─ no → HasAdmin() ? open 'login' : open 'register' {firstTime:true}
|
||||
```
|
||||
|
||||
### 5.2 The window system (most important thing to understand)
|
||||
|
||||
`app/services/WindowDefinitions.js` is the **registry**: key = window type, value =
|
||||
`{ title: 'i18n.key', component: () => import('~/components/windows/X.vue'), movable, close?, back?, ... }`.
|
||||
Adding a window = add an entry here **and** a component in `app/components/windows/`.
|
||||
|
||||
`app/services/Windows.js` is the runtime. Module-level state: `windows = ref([])`, auto-incrementing
|
||||
`currentId`, `currentIndex` z-index counter. Key exports:
|
||||
|
||||
`CreateWindow(type, data)` (one instance per type — duplicates are ignored),
|
||||
`CreateChildWindow(parentId, type, data)` (child dies with parent), `ClearWindow({type}|{id})`
|
||||
(recursive over `children`), `ClearAll()`, `GetWindowWithId(id)`, `GetFirstWindowId(type)`,
|
||||
`CallWindow(id, callableName, arg)`, `SetSize/SetPosition/SetMinSize/SetMaxSize/SetResizable/
|
||||
SetMovable/ResetPosition(id,'center')/SetOnTop/Top`, `getComponent(type)` (cached `defineAsyncComponent`),
|
||||
and `SetupHandle(id, handleRef)` which wires raw DOM mouse listeners for drag/resize.
|
||||
|
||||
Contract a window component must fulfil (copy `ExampleWindow.vue`):
|
||||
|
||||
```vue
|
||||
<script setup>
|
||||
import { SetupHandle, SetSize, ResetPosition, Top } from '@/services/Windows';
|
||||
import WindowHandle from './partials/WindowHandle.vue';
|
||||
const handle = ref(null), wrapper = ref(null);
|
||||
const props = defineProps(['data']); // 'data' = merged {type,id,...WindowDefinitions entry,...CreateWindow data}
|
||||
const id = props.data.id;
|
||||
onMounted(() => {
|
||||
Top(wrapper); SetupHandle(id, handle);
|
||||
SetSize(id, { width: 500, height: 380 }); ResetPosition(id, 'center');
|
||||
});
|
||||
</script>
|
||||
<template>
|
||||
<div class="window-wrapper" :id="'window-wrapper-' + id" ref="wrapper">
|
||||
<WindowHandle :window="id" ref="handle"></WindowHandle>
|
||||
<!-- body -->
|
||||
</div>
|
||||
</template>
|
||||
```
|
||||
|
||||
DOM id conventions that `Windows.js`, `WindowHandle.vue` and drag/resize depend on — do not rename:
|
||||
`window-wrapper-{id}`, `window-handle-{id}`, `window-resize-handle-{id}`, `context-menu`, `mouse-tooltip`.
|
||||
|
||||
`WindowHandle.vue` reads `title` (translated at mount via `$t`), `close` and `back` off the window
|
||||
object, exposes `setupHandle()`, and plays `/sounds/close.wav` when closed.
|
||||
|
||||
### 5.3 Services (`app/services/`) — the state layer
|
||||
|
||||
Plain modules with module-scope `ref()`s imported directly. No DI, no Pinia. Singleton by import.
|
||||
|
||||
| Service | Provides |
|
||||
|---|---|
|
||||
| `Server.js` | axios instance (fallback baseURL `http://localhost:5000/api`), `initApi(baseURL)` called by `plugins/api.ts`, request interceptor adding `Authorization: Bearer <localStorage.token>`, `getBaseUrl()`. Default export is a factory: call `Server()` then `.get/.post`. |
|
||||
| `User.js` | `UserStatus` ref, `GetUser()` (decodes JWT, auto-logout on `exp`), `SetUser(token)`, `LoadUser`, `LogoutUser`, `IsAdmin`, `HasAdmin()`, `GetUserSetting(key)` / `SetUserSetting(key,value)` (server-backed, in `User.settings`) |
|
||||
| `Campaign.js` | `useCampaignService()` → `Campaign` (`useState('campaign')`), `SetCampaign(data)` (also writes `localStorage.selectedCampaignId`), `RestoreCampaign()` |
|
||||
| `Content.js` | `ShowContent` ref (drives the campaign workspace). `SetShowContent` is exported but unused — `ContentManager.vue` sets it from a `watch(Campaign)` and never turns it back off |
|
||||
| `Emitter.js` | `export const emitter = mitt()` — the app-wide event bus |
|
||||
| `Toaster.js` | `DisplayToast(color, text, duration)` → emits `toast`; `ToastManager.vue` renders it |
|
||||
| `Tooltip.js` | `SetupTooltip()`, `AddTooltip(el, text, {max_width})` (stores on `el._dr_tooltip`), polled visibility via `elementsFromPoint` |
|
||||
| `ContextMenu.js` | `SetupContextMenu()`, `AddContextMenu(el, items, {dropdown:true})`, `ShowContextMenu(items)`, `HideContextMenu()`. Items: `{name, icon?, action?, divider?}` or `{name, context:[...]}` for a submenu; built imperatively into `#context-menu` with `motion` animations |
|
||||
| `Sound.js` | `AddSound(rootEl)` binds `/sounds/snap.wav` to every `.sound-click` inside `rootEl` |
|
||||
| `Marker.js` | marked `Marked` instance + custom extensions, `ParseMarkdown(src)`, `GetWidget(kind,name)` (§5.4) |
|
||||
| `ActionRegistry.js` | `register({id,label,description,execute,isActive?})`, `unregister`, `search(q)` (diacritic-insensitive, prefix-first sort), `execute(id,params)` — powers the command palette |
|
||||
| `Windows.js` / `WindowDefinitions.js` | §5.2 |
|
||||
| `widgets/DiceParser.js` | recursive-descent dice evaluator (§5.5) |
|
||||
|
||||
### 5.4 Markdown → Vue widgets
|
||||
|
||||
`Marker.js` registers three marked extensions:
|
||||
|
||||
| Syntax | Level | Output |
|
||||
|---|---|---|
|
||||
| `@name\n<content>\n@end` | block | `<div class="vue-component-display" data-component data-content>` |
|
||||
| `@name[text]` | inline | `<span class="vue-component-inline" data-component data-content>` |
|
||||
| `[[target]]` | inline | `<span class="vue-link" data-href>` (renders the literal text `Link`) |
|
||||
|
||||
`Note.vue` renders the HTML with `v-html`, then in a `setTimeout(...,0)` calls `mountComponents()`,
|
||||
which `querySelectorAll('.vue-component-display'|'.vue-component-inline')` and mounts each node with a
|
||||
**separate** `createApp(GetWidget(kind, el.dataset.component), { content: el.dataset.content })`.
|
||||
Widgets are therefore isolated mini-apps: they receive only `content` (a string) and must not rely on
|
||||
the parent app's provides/injection.
|
||||
|
||||
Registering a widget = add an entry to `widget_map` in `Marker.js`:
|
||||
|
||||
```js
|
||||
const widget_map = {
|
||||
inline: { roll: () => import("~/components/viewer/widgets/inline/RollWidgetInline.vue") },
|
||||
display: { roll: () => import("~/components/viewer/widgets/display/RollWidgetDisplay.vue") },
|
||||
};
|
||||
```
|
||||
|
||||
`Note.vue` also: handles `Ctrl/Cmd+E` (toggle edit/preview, saves on exit) and `Ctrl/Cmd+S` (save via
|
||||
`POST /note/update`), tracks dirty state (white dot in the vertical title strip), and wires
|
||||
Obsidian-style collapsible callouts (`setupCallout()`/`toggleCallout()` + `callouts.scss`).
|
||||
|
||||
### 5.5 Dice grammar (`DiceParser.js`)
|
||||
|
||||
`parse(expr) -> { total, steps[] }`. Tokens: `\d*d\d+` with optional `adv|dis|kh<N>|kl<N>`, integers,
|
||||
`+ - * / ( )`, unary minus. `adv`/`dis` roll 2dN and keep max/min; `kh`/`kl` keep highest/lowest N.
|
||||
Division is `Math.floor`. Guards: count 1–1000, sides 2–10000. `steps` are `{type:'op'|'const'|'dice'}`
|
||||
and `RollWidgetDisplay.vue` turns them into the visual breakdown (kept/dropped/max/min classes).
|
||||
|
||||
### 5.6 Event bus contract
|
||||
|
||||
Every listener in the app (there are only these six `emitter.on` call sites):
|
||||
|
||||
| Event | Payload | Listened by |
|
||||
|---|---|---|
|
||||
| `toast` | `{color,text,duration}` | `ToastManager.vue` |
|
||||
| `push-note` | `{key,title,text,date}` | `NoteContainer.vue` |
|
||||
| `delete-note` | note key (string) | `NoteContainer.vue` |
|
||||
| `title-updated` | `{key,title}` | `Note.vue`, `NoteContainer.vue` |
|
||||
| `status-bar-update` | `{text,icon}` | `FetchStatus.vue` |
|
||||
|
||||
Emitters: `Toaster.js` (`toast`), `ContentSidebar` / `TopSearchBar` (`push-note`), `Note.vue` /
|
||||
`NestedNoteList.vue` (`delete-note`), `ContentSidebar` (`title-updated`), `FetchStatus` (self-test emit).
|
||||
|
||||
**Orphan events** — emitted, never subscribed to anywhere (the matching handlers `handleNoteCreated` /
|
||||
`handleNoteRenamed` exist in `ContentSidebar.vue` but were never wired with `emitter.on`; see §9.17):
|
||||
|
||||
| Event | Emitted by | Intended handler |
|
||||
|---|---|---|
|
||||
| `note-created` | `ContentSidebar.createNote`, `TopSearchBar` | `ContentSidebar.handleNoteCreated` (dead) |
|
||||
| `note-renamed` | `RenameNoteWindow.vue` | `ContentSidebar.handleNoteRenamed` (dead) |
|
||||
| `folder-saved` | `NewFolderWindow.vue` | none — sidebar refreshes only via `@reload-notes` from `NestedNoteList` |
|
||||
|
||||
So "create note" currently works because the sidebar mutates its own list, and folder changes need an
|
||||
explicit `fetchCampaignNotes()`. If you rely on an event, check a listener exists.
|
||||
|
||||
Note object shape in the UI layer is `{ key, title, text, date }` (mapped from the API's
|
||||
`{_id,title,content,date}`); convert at the boundary as `ContentSidebar.fetchCampaignNotes` does.
|
||||
|
||||
### 5.7 Theming, fonts, icons, sounds
|
||||
|
||||
- `useTheme.ts` owns `theme` (`'light'|'dark'`) and `accent` (`'katlum'`, type currently narrow) as
|
||||
module singletons, persists to `localStorage`, and sets `data-theme` / `data-accent` on `<html>`.
|
||||
`app.vue` calls `setupTheme()` then forces `setTheme('dark')` on mount.
|
||||
- `colors.scss` holds Sass maps `dark`/`light` (and accents `katlum`/`solus`/`silang`) emitted as
|
||||
**`--color-*` CSS variables**. Always style with `var(--color-...)` (`background`,
|
||||
`window-background`, `button-hover`, `text`, `border`, `icon-invert`, …), never hardcode hex.
|
||||
- Icons are inverted via `filter: invert(var(--color-icon-invert))` — white SVGs + `.icon` class.
|
||||
Reference either as public assets (`/icons/iconoir/regular/xmark.svg`, `/icons/ui/...`,
|
||||
`/icons/Pixelarticons/white/close.svg`) or from the `pixelarticons` npm package
|
||||
(`import SearchIcon from 'pixelarticons/svg/search.svg'`).
|
||||
- Fonts (`fonts.scss` + `public/fonts/5e`): `BookInsanityRemake` (body default), `MrEavesRemake`
|
||||
(headings/window titles), `ScalySansRemake`, `NodestoCapsCondensed`, `SolberaImitationRemake`, etc.
|
||||
- Sounds in `public/sounds/`: `snap.wav` (the `.sound-click` default), `close.wav`, `click.wav`,
|
||||
`dice.wav`, `roll1.wav`, `roll2.wav`, `notify.wav`, `drums.wav`, `lock.wav`, `doors/`.
|
||||
|
||||
### 5.8 i18n
|
||||
|
||||
Locales: `en` (default), `es`, `ca`. Files live at `frontend/i18n/locales/<lang>/<namespace>.json`, and
|
||||
`app/plugins/i18n.ts` globs them and nests each under its **filename** — so the key is
|
||||
`<file>.<path>`, e.g. `i18n/locales/en/main-menu.json` → `$t('main-menu.create-campaign')`.
|
||||
Namespaces in use: `general`, `login`, `register`, `main-menu`, `settings`, `windows`, `campaigns`
|
||||
(`campaigns` currently only exists for `en`). Call it as `$t(...)` in templates or via `useI18n()` in
|
||||
script; `WindowDefinitions` stores raw keys (`title: 'windows.login'`) and `WindowHandle` translates them.
|
||||
|
||||
**Adding a string = add it to all three locales** (`en`, `es`, `ca`); the Nuxt i18n module is also
|
||||
configured (`nuxt.config.ts`, `langDir: 'locales/'`, `vueI18n: './i18n.config.ts'`) but its locale files
|
||||
(`locales/en.json` etc.) are empty `{}` — the custom plugin is what components actually consume.
|
||||
|
||||
## 6. Conventions
|
||||
|
||||
- **Backend**: CommonJS `require`/`module.exports`; files in `services/` are shared infra, `routes/`
|
||||
are thin Express routers, `models/` one Mongoose schema per file exporting `mongoose.model(...)`.
|
||||
Every handler is `try/catch` → `{status:'error', msg:'errors.internal'}` + `console.error`.
|
||||
Route logic helpers (like `userOwnsCampaign`) are duplicated per router file today — match that
|
||||
style unless you refactor both at once.
|
||||
- **Frontend**: Vue 3 `<script setup>`; PascalCase exported functions in `services/` (`CreateWindow`,
|
||||
`GetUser`), camelCase locals; PascalCase component filenames; `kebab-case` DOM ids that services
|
||||
depend on. Both `~/` and `@/` aliases appear in imports (both resolve to `app/`) — follow whatever
|
||||
the neighbouring file uses.
|
||||
- Components talk to the API through `Server()` directly (there is no api-layer abstraction); `await`
|
||||
or `.then` both appear.
|
||||
- Code comments are mixed English and Catalan ("Moure aixo", "Programar un resizer mitjanament
|
||||
competent") — do not "translate" unrelated comments while editing.
|
||||
- No formatter: keep diffs minimal and local; the codebase is deliberately rough.
|
||||
|
||||
## 7. Recipes
|
||||
|
||||
**New API resource**: add `models/X.js`, `routes/x.js` (with `userOwnsCampaign`-style ownership checks
|
||||
and the `{status,msg}` envelope), then `app.use('/api/x', require('./routes/x'))` in `src/index.js`
|
||||
**after** the `checkAuth` line if it needs auth.
|
||||
|
||||
**New window**: entry in `WindowDefinitions.js` → component in `app/components/windows/` following
|
||||
§5.2 → open with `CreateWindow('type', data)` or `CreateChildWindow(parentId, 'type', data)` → strings
|
||||
in `i18n/locales/*/windows.json`.
|
||||
|
||||
**New markdown widget**: component in `app/components/viewer/widgets/{inline|display}/`, register in
|
||||
`widget_map` in `Marker.js`, consume the `content` prop.
|
||||
|
||||
**New command-palette action**: `register({id,label,description,execute,isActive?})` from
|
||||
`~/services/ActionRegistry` (see `registerCreateNoteAction` in `TopSearchBar.vue`); palette opens with
|
||||
`Ctrl/Cmd+K` or `/`.
|
||||
|
||||
**New theme color**: add the key to *both* `dark` and `light` maps in `colors.scss`, use
|
||||
`var(--color-<key>)`.
|
||||
|
||||
## 8. Port map
|
||||
|
||||
`frontend dev :3000` · `backend :5000` (hardcoded) · MongoDB `:27017` · nginx `:3000 → 80` inside
|
||||
compose, proxying `/` → `frontend:3000`, `/api/` → `backend:5000`.
|
||||
|
||||
## 9. Known landmines (verified in code — do not "fix" silently, but never make them worse)
|
||||
|
||||
1. `README.md` tells you to run `./install.sh` and `./start.sh`; **neither script exists** in the repo.
|
||||
2. `frontend/README.md` says the frontend is **React**. It is Nuxt/Vue 3.
|
||||
3. `services/keys.js` ships a hardcoded JWT secret `"putyoursecrethere"`, used in prod.
|
||||
4. `src/index.js` sets CORS `origin: 'http://localhost:3000'` only — the production origin
|
||||
(`https://dragonroll.aranroig.com`) is not whitelisted; in production the nginx same-origin proxy
|
||||
is what hides this.
|
||||
5. `POST /api/user/register` responds `{status:'ok', code: setupCode}` but `setupCode` is not defined
|
||||
in that scope → ReferenceError → caught → the first-run registration actually returns
|
||||
`errors.internal`. Fix carefully: the register UI (`RegisterWindow.vue`) drives the first-admin flow.
|
||||
6. `POST /api/note/delete` has **no ownership check** (any authenticated user can delete any note id).
|
||||
`folder.js` and the other `note.js` handlers do check.
|
||||
7. `composables/useEmitter.ts` reads `$emitter` from `useNuxtApp()`, but **no plugin provides it** —
|
||||
always import `{ emitter }` from `~/services/Emitter` instead.
|
||||
8. `ecosystem.config.js` runs `npm start` in both apps; neither package defines a `start` script → PM2
|
||||
would fail. Compose/nginx is the real deployment path.
|
||||
9. `/api/user/*` is entirely mounted before the JWT guard (see §4); new user routes are public unless
|
||||
they call `passport.authenticate('jwt', {session:false})` inline.
|
||||
10. `checkAuth` in `src/index.js` is assigned without `const` (implicit global).
|
||||
11. `ClearAll()` in `Windows.js` iterates `Object.keys(windows)` (the ref object, not `.value`) — it
|
||||
does not behave like the name suggests.
|
||||
12. `GetWidget`/`getComponent` caches are process-global and never invalidated; new widget/window types
|
||||
need a dev-server restart if HMR misbehaves.
|
||||
13. `Windows.js` `SetupHandle` attaches `mousemove`/`mouseup` listeners on `document` for **every**
|
||||
window and never removes them; they early-return on `win.movable` but still accumulate.
|
||||
14. `Note.vue` mounts widgets with `createApp` and never unmounts them — leaked apps remain when note
|
||||
content is re-rendered.
|
||||
15. `User.js` (frontend) treats the JWT as the user cache: `settings` changes require
|
||||
`SetUserSetting`/`GetUserSetting` round-trips, the token payload goes stale.
|
||||
16. `.env.production` files (both apps) are committed and contain internal hosts.
|
||||
17. `note-created`, `note-renamed` and `folder-saved` are emitted with **no subscribers**; the sidebar's
|
||||
`handleNoteCreated` / `handleNoteRenamed` are unwired dead code (§5.6). The sidebar refreshes its
|
||||
tree only on `campaignId` change, on mount, on the manual refresh button, or on `@reload-notes`
|
||||
from `NestedNoteList.vue`.
|
||||
18. `SetShowContent` (`services/Content.js`) and `services/middleware.js`'s `isAdmin` are exported /
|
||||
imported but never used; `ContentManager.vue` never hides the workspace again once shown.
|
||||
@@ -1,3 +1,5 @@
|
||||
PORT=5000
|
||||
DB_URI=mongodb://192.168.1.7:27017/dragonroll
|
||||
NODE_ENV=production
|
||||
NODE_ENV=production
|
||||
DRAGONROLL_DISCORD_BOT_SECRET=test
|
||||
DRAGONROLL_FRONTEND_URL=https://dragonroll.aranroig.com
|
||||
|
||||
@@ -40,13 +40,34 @@ require('./services/passport')(passport);
|
||||
// CORS
|
||||
app.use(cookieParser());
|
||||
|
||||
app.use(cors({
|
||||
const foundryCorsPaths = [
|
||||
'/api/foundry/link/complete', '/foundry/link/complete',
|
||||
'/api/foundry/sync', '/foundry/sync',
|
||||
];
|
||||
const foundryCors = cors({
|
||||
origin: true,
|
||||
methods: ['GET', 'POST', 'OPTIONS'],
|
||||
allowedHeaders: ['Authorization', 'Content-Type'],
|
||||
});
|
||||
app.use('/api/foundry/link/complete', foundryCors);
|
||||
app.use('/foundry/link/complete', foundryCors);
|
||||
app.use('/api/foundry/sync', foundryCors);
|
||||
app.use('/foundry/sync', foundryCors);
|
||||
|
||||
const appCors = cors({
|
||||
origin: 'http://localhost:3000',
|
||||
credentials: true, // if using cookies/auth
|
||||
}));
|
||||
});
|
||||
app.use((req, res, next) => {
|
||||
if (foundryCorsPaths.some((path) => req.path === path || req.path.startsWith(`${path}/`))) return next();
|
||||
appCors(req, res, next);
|
||||
});
|
||||
|
||||
// ROUTES (NO AUTH)
|
||||
app.use('/api/user', require('./routes/user'));
|
||||
app.use('/api/discord', require('./routes/discord'));
|
||||
app.use('/api/foundry', require('./routes/foundry-link'));
|
||||
app.use('/foundry', require('./routes/foundry-link'));
|
||||
|
||||
// AUTH
|
||||
checkAuth = passport.authenticate('jwt', { session: false });
|
||||
@@ -56,6 +77,9 @@ app.use(checkAuth);
|
||||
app.use('/api/campaign', require('./routes/campaign'));
|
||||
app.use('/api/note', require('./routes/note'));
|
||||
app.use('/api/folder', require('./routes/folder'));
|
||||
app.use('/api/actor', require('./routes/actor'));
|
||||
app.use('/api/item', require('./routes/item'));
|
||||
app.use('/api/foundry', require('./routes/foundry'));
|
||||
/*
|
||||
app.use('/campaign', require('./routes/campaign'));
|
||||
app.use('/maps', require('./routes/map'));
|
||||
@@ -70,4 +94,4 @@ app.get("/api/test", (req, res) => {
|
||||
|
||||
app.listen(5000, () => {
|
||||
console.log("Server running on port 5000");
|
||||
});
|
||||
});
|
||||
|
||||
47
backend/src/models/Actor.js
Normal file
47
backend/src/models/Actor.js
Normal file
@@ -0,0 +1,47 @@
|
||||
const mongoose = require('mongoose');
|
||||
const Schema = mongoose.Schema;
|
||||
|
||||
const ActorSchema = new Schema({
|
||||
name: { type: String, required: true, trim: true },
|
||||
type: { type: String, enum: ['character', 'npc', 'creature'], default: 'character' },
|
||||
species: { type: String, default: '' },
|
||||
className: { type: String, default: '' },
|
||||
subclass: { type: String, default: '' },
|
||||
level: { type: Number, min: 1, max: 20, default: 1 },
|
||||
background: { type: String, default: '' },
|
||||
challengeRating: { type: String, default: '' },
|
||||
description: { type: String, default: '' },
|
||||
image: { type: String, default: '' },
|
||||
abilityScores: {
|
||||
str: { type: Number, min: 1, max: 30, default: 10 },
|
||||
dex: { type: Number, min: 1, max: 30, default: 10 },
|
||||
con: { type: Number, min: 1, max: 30, default: 10 },
|
||||
int: { type: Number, min: 1, max: 30, default: 10 },
|
||||
wis: { type: Number, min: 1, max: 30, default: 10 },
|
||||
cha: { type: Number, min: 1, max: 30, default: 10 }
|
||||
},
|
||||
armorClass: { type: Number, min: 0, default: 10 },
|
||||
speed: { type: Number, min: 0, default: 30 },
|
||||
proficiencies: { type: String, default: '' },
|
||||
inventory: [{
|
||||
name: { type: String, trim: true, default: '' },
|
||||
quantity: { type: Number, min: 1, default: 1 },
|
||||
weight: { type: Number, min: 0, default: 0 }
|
||||
}],
|
||||
traits: { type: String, default: '' },
|
||||
spells: { type: String, default: '' },
|
||||
campaign: {
|
||||
type: Schema.Types.ObjectId,
|
||||
ref: 'Campaign',
|
||||
required: true
|
||||
},
|
||||
foundryActorId: { type: String },
|
||||
date: { type: Date, default: Date.now }
|
||||
});
|
||||
|
||||
ActorSchema.index(
|
||||
{ campaign: 1, foundryActorId: 1 },
|
||||
{ unique: true, partialFilterExpression: { foundryActorId: { $type: 'string' } } }
|
||||
);
|
||||
|
||||
module.exports = mongoose.model('Actor', ActorSchema);
|
||||
@@ -11,7 +11,14 @@ const CampaignSchema = new Schema({
|
||||
required: true
|
||||
},
|
||||
date: { type: Date, default: Date.now},
|
||||
settings: { type: Object }
|
||||
settings: { type: Object },
|
||||
foundryWorldId: { type: String, unique: true, sparse: true },
|
||||
foundryWorldTitle: { type: String },
|
||||
foundrySystem: { type: String },
|
||||
foundrySyncTokenHash: { type: String, select: false },
|
||||
// Discord server ("guild") this campaign is linked to. A campaign serves
|
||||
// at most one guild, and a guild selects one campaign.
|
||||
discordGuildId: { type: String, index: true }
|
||||
});
|
||||
|
||||
module.exports = mongoose.model('Campaign', CampaignSchema);
|
||||
module.exports = mongoose.model('Campaign', CampaignSchema);
|
||||
|
||||
11
backend/src/models/DiscordGuildLink.js
Normal file
11
backend/src/models/DiscordGuildLink.js
Normal file
@@ -0,0 +1,11 @@
|
||||
const mongoose = require('mongoose');
|
||||
const Schema = mongoose.Schema;
|
||||
|
||||
const DiscordGuildLinkSchema = new Schema({
|
||||
guildId: { type: String, required: true, unique: true, index: true },
|
||||
discordUserId: { type: String, required: true },
|
||||
dragonrollUser: { type: Schema.Types.ObjectId, ref: 'User', required: true },
|
||||
connectedAt: { type: Date, default: Date.now }
|
||||
});
|
||||
|
||||
module.exports = mongoose.model('DiscordGuildLink', DiscordGuildLinkSchema);
|
||||
20
backend/src/models/DiscordLinkRequest.js
Normal file
20
backend/src/models/DiscordLinkRequest.js
Normal file
@@ -0,0 +1,20 @@
|
||||
const mongoose = require('mongoose');
|
||||
const Schema = mongoose.Schema;
|
||||
|
||||
const DiscordLinkRequestSchema = new Schema({
|
||||
codeHash: { type: String, required: true, unique: true },
|
||||
guildId: { type: String, required: true },
|
||||
guildName: { type: String, required: true },
|
||||
discordUserId: { type: String, required: true },
|
||||
discordUserName: { type: String, required: true },
|
||||
dragonrollUser: { type: Schema.Types.ObjectId, ref: 'User' },
|
||||
createdAt: { type: Date, default: Date.now },
|
||||
expiresAt: { type: Date, required: true },
|
||||
completedAt: { type: Date },
|
||||
// Quan el bot ja ha confirmat a Discord que aquesta autoritzacio s'ha fet.
|
||||
notifiedAt: { type: Date }
|
||||
});
|
||||
|
||||
DiscordLinkRequestSchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
|
||||
|
||||
module.exports = mongoose.model('DiscordLinkRequest', DiscordLinkRequestSchema);
|
||||
24
backend/src/models/FoundryLinkRequest.js
Normal file
24
backend/src/models/FoundryLinkRequest.js
Normal file
@@ -0,0 +1,24 @@
|
||||
const mongoose = require('mongoose');
|
||||
const Schema = mongoose.Schema;
|
||||
|
||||
const FoundryLinkRequestSchema = new Schema({
|
||||
codeHash: { type: String, required: true, unique: true },
|
||||
// Kept in clear text so the campaign settings screen can re-display a pending
|
||||
// pairing code after a reload or a backend restart. It is only ever returned
|
||||
// to the user who created the request and is cleared once the link completes.
|
||||
code: { type: String },
|
||||
source: { type: String, enum: ['dragonroll'], required: true },
|
||||
campaign: { type: Schema.Types.ObjectId, ref: 'Campaign' },
|
||||
createdBy: { type: Schema.Types.ObjectId, ref: 'User' },
|
||||
worldId: { type: String },
|
||||
worldTitle: { type: String },
|
||||
system: { type: String },
|
||||
foundryUrl: { type: String },
|
||||
createdAt: { type: Date, default: Date.now },
|
||||
expiresAt: { type: Date, required: true },
|
||||
completedAt: { type: Date }
|
||||
});
|
||||
|
||||
FoundryLinkRequestSchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
|
||||
|
||||
module.exports = mongoose.model('FoundryLinkRequest', FoundryLinkRequestSchema);
|
||||
28
backend/src/models/Item.js
Normal file
28
backend/src/models/Item.js
Normal file
@@ -0,0 +1,28 @@
|
||||
const mongoose = require('mongoose');
|
||||
const Schema = mongoose.Schema;
|
||||
|
||||
const ItemSchema = new Schema({
|
||||
name: { type: String, required: true, trim: true },
|
||||
category: {
|
||||
type: String,
|
||||
enum: ['weapon', 'armor', 'shield', 'adventuring-gear', 'magic-item', 'consumable', 'tool', 'treasure', 'other'],
|
||||
default: 'adventuring-gear'
|
||||
},
|
||||
rarity: {
|
||||
type: String,
|
||||
enum: ['common', 'uncommon', 'rare', 'very-rare', 'legendary', 'artifact'],
|
||||
default: 'common'
|
||||
},
|
||||
quantity: { type: Number, min: 1, default: 1 },
|
||||
weight: { type: Number, min: 0 },
|
||||
properties: { type: String, default: '' },
|
||||
description: { type: String, default: '' },
|
||||
campaign: {
|
||||
type: Schema.Types.ObjectId,
|
||||
ref: 'Campaign',
|
||||
required: true
|
||||
},
|
||||
date: { type: Date, default: Date.now }
|
||||
});
|
||||
|
||||
module.exports = mongoose.model('Item', ItemSchema);
|
||||
111
backend/src/routes/actor.js
Normal file
111
backend/src/routes/actor.js
Normal file
@@ -0,0 +1,111 @@
|
||||
const express = require('express');
|
||||
const router = express.Router();
|
||||
|
||||
const upload = require('../services/storage');
|
||||
|
||||
const Campaign = require('../models/Campaign');
|
||||
const Actor = require('../models/Actor');
|
||||
|
||||
async function userOwnsCampaign(campaignId, userId) {
|
||||
const campaign = await Campaign.findOne({ _id: campaignId, createdBy: userId }).lean();
|
||||
return Boolean(campaign);
|
||||
}
|
||||
|
||||
router.get('/list', async (req, res) => {
|
||||
try {
|
||||
const { campaign } = req.query;
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
if (!(await userOwnsCampaign(campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
|
||||
const actors = await Actor.find({ campaign }).sort({ name: 1 }).lean();
|
||||
res.json({ status: 'ok', actors });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/create', async (req, res) => {
|
||||
try {
|
||||
const { name, campaign, type, species, className, subclass, level, background, challengeRating, description } = req.body;
|
||||
if (!name?.trim() || !campaign) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
if (!(await userOwnsCampaign(campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
|
||||
const actor = await Actor.create({
|
||||
name: name.trim(), campaign, type, species, className, subclass,
|
||||
level: level === '' || level === undefined ? undefined : Number(level),
|
||||
background, challengeRating, description
|
||||
});
|
||||
res.json({ status: 'ok', actor });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/update', async (req, res) => {
|
||||
try {
|
||||
const { id, name, species, className, subclass, level, abilityScores, armorClass, speed, proficiencies, inventory, traits, spells, image } = req.body;
|
||||
if (!id) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
|
||||
const actor = await Actor.findById(id);
|
||||
if (!actor) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
if (!(await userOwnsCampaign(actor.campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
|
||||
if (name !== undefined) actor.name = String(name).trim();
|
||||
if (species !== undefined) actor.species = species;
|
||||
if (className !== undefined) actor.className = className;
|
||||
if (subclass !== undefined) actor.subclass = subclass;
|
||||
if (level !== undefined) actor.level = Number(level);
|
||||
if (abilityScores !== undefined) actor.abilityScores = abilityScores;
|
||||
if (armorClass !== undefined) actor.armorClass = Number(armorClass);
|
||||
if (speed !== undefined) actor.speed = Number(speed);
|
||||
if (proficiencies !== undefined) actor.proficiencies = proficiencies;
|
||||
if (inventory !== undefined) actor.inventory = inventory;
|
||||
if (traits !== undefined) actor.traits = traits;
|
||||
if (spells !== undefined) actor.spells = spells;
|
||||
if (image !== undefined) actor.image = String(image);
|
||||
|
||||
await actor.save();
|
||||
res.json({ status: 'ok', actor });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
// Upload actor image post
|
||||
router.post("/upload-image", upload.single("image"), async (req, res) => {
|
||||
try {
|
||||
const actorId = req.query.actor || req.body.actor;
|
||||
if (!actorId || !req.file) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
|
||||
const actor = await Actor.findById(actorId);
|
||||
if (!actor) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
if (!(await userOwnsCampaign(actor.campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
|
||||
actor.image = req.file.filename;
|
||||
await actor.save();
|
||||
res.json({ status: "ok", msg: "uploaded", actor });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: "error", msg: "internal" });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/delete', async (req, res) => {
|
||||
try {
|
||||
const { id } = req.body;
|
||||
if (!id) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
const actor = await Actor.findById(id);
|
||||
if (!actor) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
if (!(await userOwnsCampaign(actor.campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
await actor.deleteOne();
|
||||
res.json({ status: 'ok' });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
@@ -1,7 +1,25 @@
|
||||
const express = require('express')
|
||||
const router = express.Router();
|
||||
const crypto = require('node:crypto');
|
||||
|
||||
const Campaign = require("../models/Campaign");
|
||||
const FoundryLinkRequest = require('../models/FoundryLinkRequest');
|
||||
|
||||
const FOUNDRY_LINK_TTL_MS = 10 * 60 * 1000;
|
||||
|
||||
function foundryCodeHash(code) {
|
||||
return crypto.createHash('sha256').update(String(code ?? '').trim()).digest('hex');
|
||||
}
|
||||
|
||||
async function expirePendingFoundryLinks(campaignId, userId) {
|
||||
const filter = {
|
||||
source: 'dragonroll',
|
||||
campaign: campaignId,
|
||||
createdBy: userId,
|
||||
completedAt: null
|
||||
};
|
||||
await FoundryLinkRequest.updateMany(filter, { $set: { expiresAt: new Date() } });
|
||||
}
|
||||
|
||||
router.post('/create', async (req, res) => {
|
||||
try {
|
||||
@@ -21,6 +39,133 @@ router.post('/create', async (req, res) => {
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/update', async (req, res) => {
|
||||
try {
|
||||
const { id, name, color, settings } = req.body;
|
||||
if (!id) return res.json({ status: "error", msg: "errors.missing-data" });
|
||||
|
||||
const campaign = await Campaign.findOne({ _id: id, createdBy: req.user.id });
|
||||
if (!campaign) return res.json({ status: "error", msg: "errors.notfound" });
|
||||
|
||||
if (name !== undefined) {
|
||||
if (typeof name !== 'string' || !name.trim()) {
|
||||
return res.json({ status: "error", msg: "errors.missing-data" });
|
||||
}
|
||||
campaign.name = name.trim();
|
||||
}
|
||||
|
||||
if (color !== undefined) {
|
||||
if (typeof color !== 'string') return res.json({ status: "error", msg: "errors.missing-data" });
|
||||
campaign.color = color;
|
||||
}
|
||||
|
||||
if (settings !== undefined) {
|
||||
if (!settings || typeof settings !== 'object' || Array.isArray(settings)) {
|
||||
return res.json({ status: "error", msg: "errors.missing-data" });
|
||||
}
|
||||
campaign.settings = settings;
|
||||
}
|
||||
|
||||
await campaign.save();
|
||||
res.json({ status: "ok", campaign });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: "error", msg: "errors.internal" });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/foundry-link/start', async (req, res) => {
|
||||
try {
|
||||
const campaign = await Campaign.findOne({ _id: req.body.campaignId, createdBy: req.user.id });
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
|
||||
await expirePendingFoundryLinks(campaign._id, req.user.id);
|
||||
const code = crypto.randomBytes(24).toString('base64url');
|
||||
const expiresAt = new Date(Date.now() + FOUNDRY_LINK_TTL_MS);
|
||||
const request = await FoundryLinkRequest.create({
|
||||
codeHash: foundryCodeHash(code),
|
||||
code,
|
||||
source: 'dragonroll',
|
||||
campaign: campaign._id,
|
||||
createdBy: req.user.id,
|
||||
expiresAt
|
||||
});
|
||||
|
||||
res.set('Cache-Control', 'no-store');
|
||||
res.json({ status: 'ok', code, requestId: request.id, expiresAt });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.get('/foundry-link/status/:requestId', async (req, res) => {
|
||||
try {
|
||||
const request = await FoundryLinkRequest.findOne({
|
||||
_id: req.params.requestId,
|
||||
source: 'dragonroll',
|
||||
createdBy: req.user.id
|
||||
});
|
||||
if (!request) return res.json({ status: 'ok', state: 'expired' });
|
||||
if (!request.completedAt && request.expiresAt <= new Date()) {
|
||||
return res.json({ status: 'ok', state: 'expired' });
|
||||
}
|
||||
if (!request.completedAt) return res.json({ status: 'ok', state: 'pending' });
|
||||
|
||||
const campaign = await Campaign.findOne({ _id: request.campaign, createdBy: req.user.id });
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
res.json({ status: 'ok', state: 'complete', campaign });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
// Returns the still-valid pending pairing request for a campaign, so the
|
||||
// settings window can restore its pairing code across reloads and restarts.
|
||||
router.get('/foundry-link/pending', async (req, res) => {
|
||||
try {
|
||||
const campaign = await Campaign.findOne({ _id: req.query.campaignId, createdBy: req.user.id });
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
|
||||
const request = await FoundryLinkRequest.findOne({
|
||||
source: 'dragonroll',
|
||||
campaign: campaign._id,
|
||||
createdBy: req.user.id,
|
||||
completedAt: null,
|
||||
expiresAt: { $gt: new Date() }
|
||||
}).sort({ createdAt: -1 });
|
||||
if (!request) return res.json({ status: 'ok', request: null });
|
||||
|
||||
res.set('Cache-Control', 'no-store');
|
||||
res.json({
|
||||
status: 'ok',
|
||||
request: { requestId: request.id, code: request.code, expiresAt: request.expiresAt }
|
||||
});
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/foundry-unlink', async (req, res) => {
|
||||
try {
|
||||
const campaign = await Campaign.findOne({ _id: req.body.campaignId, createdBy: req.user.id });
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
|
||||
campaign.foundryWorldId = undefined;
|
||||
campaign.foundryWorldTitle = undefined;
|
||||
campaign.foundrySystem = undefined;
|
||||
campaign.set('foundrySyncTokenHash', undefined);
|
||||
await campaign.save();
|
||||
await expirePendingFoundryLinks(campaign._id, req.user.id);
|
||||
res.json({ status: 'ok', campaign });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.get('/list', async (req, res) => {
|
||||
try {
|
||||
const campaigns = await Campaign.find({ createdBy: req.user.id });
|
||||
|
||||
272
backend/src/routes/discord.js
Normal file
272
backend/src/routes/discord.js
Normal file
@@ -0,0 +1,272 @@
|
||||
const crypto = require('node:crypto');
|
||||
const express = require('express');
|
||||
const passport = require('passport');
|
||||
const router = express.Router();
|
||||
|
||||
const Actor = require('../models/Actor');
|
||||
const Campaign = require('../models/Campaign');
|
||||
const DiscordGuildLink = require('../models/DiscordGuildLink');
|
||||
const DiscordLinkRequest = require('../models/DiscordLinkRequest');
|
||||
const User = require('../models/User');
|
||||
|
||||
const LINK_TTL_MS = 10 * 60 * 1000;
|
||||
const NOTIFICATION_WINDOW_MS = 15 * 60 * 1000;
|
||||
const NOTIFICATION_LIMIT = 10;
|
||||
|
||||
function validGuildId(value) {
|
||||
return /^\d{5,25}$/.test(String(value ?? ''));
|
||||
}
|
||||
|
||||
function codeHash(code) {
|
||||
return crypto.createHash('sha256').update(String(code ?? '')).digest('hex');
|
||||
}
|
||||
|
||||
function requireBot(req, res, next) {
|
||||
const configuredSecret = process.env.DRAGONROLL_DISCORD_BOT_SECRET?.trim() || '';
|
||||
const suppliedSecret = req.get('x-dragonroll-discord-bot-secret') || '';
|
||||
const expected = Buffer.from(configuredSecret);
|
||||
const supplied = Buffer.from(suppliedSecret);
|
||||
|
||||
if (!expected.length || expected.length !== supplied.length || !crypto.timingSafeEqual(expected, supplied)) {
|
||||
return res.status(401).json({ status: 'error', msg: 'errors.unauthorized' });
|
||||
}
|
||||
return next();
|
||||
}
|
||||
|
||||
function frontendAuthorizeUrl() {
|
||||
const frontendUrl = (process.env.DRAGONROLL_FRONTEND_URL || 'http://localhost:3000').trim().replace(/\/+$/, '');
|
||||
return `${frontendUrl}/discord/authorize`;
|
||||
}
|
||||
|
||||
// La pantalla d'autorització l'serveix el frontend. El codi viatja al fragment de la URL i el
|
||||
// navegador no l'envia mai al servidor, així que els enllaços antics del bot arriben a la
|
||||
// pantalla sense codi i demanen de tornar a executar /dragonroll connect.
|
||||
router.get('/authorize', (req, res) => {
|
||||
res.set('Cache-Control', 'no-store');
|
||||
res.set('Referrer-Policy', 'no-referrer');
|
||||
res.set('X-Content-Type-Options', 'nosniff');
|
||||
res.redirect(302, frontendAuthorizeUrl());
|
||||
});
|
||||
|
||||
router.post('/link/start', requireBot, async (req, res) => {
|
||||
try {
|
||||
const { guildId, guildName, discordUserId, discordUserName } = req.body;
|
||||
if (!validGuildId(guildId) || !/^\d{5,25}$/.test(String(discordUserId ?? '')) || !guildName || !discordUserName) {
|
||||
return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
}
|
||||
|
||||
const code = crypto.randomBytes(32).toString('base64url');
|
||||
await DiscordLinkRequest.create({
|
||||
codeHash: codeHash(code),
|
||||
guildId: String(guildId),
|
||||
guildName: String(guildName).slice(0, 100),
|
||||
discordUserId: String(discordUserId),
|
||||
discordUserName: String(discordUserName).slice(0, 100),
|
||||
expiresAt: new Date(Date.now() + LINK_TTL_MS)
|
||||
});
|
||||
|
||||
res.json({ status: 'ok', code, expiresAt: new Date(Date.now() + LINK_TTL_MS) });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/link/details', async (req, res) => {
|
||||
try {
|
||||
res.set('Cache-Control', 'no-store');
|
||||
const request = await DiscordLinkRequest.findOne({
|
||||
codeHash: codeHash(req.body.code),
|
||||
expiresAt: { $gt: new Date() },
|
||||
completedAt: null
|
||||
}).lean();
|
||||
if (!request) return res.json({ status: 'error', msg: 'discord.errors.link-expired' });
|
||||
|
||||
res.json({ status: 'ok', guildName: request.guildName, discordUserName: request.discordUserName });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/link/complete', passport.authenticate('jwt', { session: false }), async (req, res) => {
|
||||
try {
|
||||
const request = await DiscordLinkRequest.findOneAndUpdate({
|
||||
codeHash: codeHash(req.body.code),
|
||||
expiresAt: { $gt: new Date() },
|
||||
completedAt: null
|
||||
}, {
|
||||
$set: { completedAt: new Date(), dragonrollUser: req.user.id }
|
||||
}, { new: true });
|
||||
if (!request) return res.json({ status: 'error', msg: 'discord.errors.link-expired' });
|
||||
|
||||
await Campaign.updateMany(
|
||||
{ discordGuildId: request.guildId, createdBy: { $ne: req.user.id } },
|
||||
{ $unset: { discordGuildId: 1 } }
|
||||
);
|
||||
|
||||
await DiscordGuildLink.findOneAndUpdate({ guildId: request.guildId }, {
|
||||
$set: {
|
||||
discordUserId: request.discordUserId,
|
||||
dragonrollUser: req.user.id,
|
||||
connectedAt: new Date()
|
||||
}
|
||||
}, { new: true, upsert: true, setDefaultsOnInsert: true });
|
||||
|
||||
res.json({ status: 'ok', guildName: request.guildName });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
async function dragonrollUserNames(requests) {
|
||||
const userIds = [...new Set(requests.map((request) => String(request.dragonrollUser ?? '')).filter(Boolean))];
|
||||
if (!userIds.length) return new Map();
|
||||
|
||||
const users = await User.find({ _id: { $in: userIds } }).select('username name').lean();
|
||||
return new Map(users.map((user) => [String(user._id), user.username || user.name]));
|
||||
}
|
||||
|
||||
// El bot reclama les autoritzacions ja fetes per confirmar-les a Discord. Marcar-les aqui
|
||||
// mateix evita que dos processos del bot confirmïn la mateixa vegada.
|
||||
router.post('/bot/link-requests/notifications', requireBot, async (req, res) => {
|
||||
try {
|
||||
const pending = await DiscordLinkRequest.find({
|
||||
completedAt: { $gte: new Date(Date.now() - NOTIFICATION_WINDOW_MS) },
|
||||
notifiedAt: null
|
||||
}).select('_id guildId guildName discordUserId discordUserName dragonrollUser')
|
||||
.limit(NOTIFICATION_LIMIT)
|
||||
.lean();
|
||||
|
||||
const claimed = [];
|
||||
for (const request of pending) {
|
||||
const taken = await DiscordLinkRequest.findOneAndUpdate(
|
||||
{ _id: request._id, notifiedAt: null },
|
||||
{ $set: { notifiedAt: new Date() } },
|
||||
{ new: true }
|
||||
).lean();
|
||||
if (taken) claimed.push(request);
|
||||
}
|
||||
|
||||
const names = await dragonrollUserNames(claimed);
|
||||
res.json({
|
||||
status: 'ok',
|
||||
notifications: claimed.map((request) => ({
|
||||
id: String(request._id),
|
||||
guildId: request.guildId,
|
||||
guildName: request.guildName,
|
||||
discordUserId: request.discordUserId,
|
||||
discordUserName: request.discordUserName,
|
||||
dragonrollUserName: names.get(String(request.dragonrollUser ?? '')) || null
|
||||
}))
|
||||
});
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.get('/bot/guild/:guildId/status', requireBot, async (req, res) => {
|
||||
try {
|
||||
if (!validGuildId(req.params.guildId)) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
const link = await DiscordGuildLink.findOne({ guildId: req.params.guildId }).lean();
|
||||
if (!link) return res.json({ status: 'ok', connected: false, campaign: null });
|
||||
|
||||
const campaign = await Campaign.findOne({
|
||||
discordGuildId: req.params.guildId,
|
||||
createdBy: link.dragonrollUser
|
||||
}).select('_id name').lean();
|
||||
res.json({ status: 'ok', connected: true, campaign });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.get('/bot/guild/:guildId/campaigns', requireBot, async (req, res) => {
|
||||
try {
|
||||
if (!validGuildId(req.params.guildId)) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
const link = await DiscordGuildLink.findOne({ guildId: req.params.guildId }).lean();
|
||||
if (!link) return res.json({ status: 'error', msg: 'discord.errors.not-connected' });
|
||||
|
||||
const campaigns = await Campaign.find({ createdBy: link.dragonrollUser })
|
||||
.select('_id name discordGuildId')
|
||||
.sort({ date: -1 })
|
||||
.lean();
|
||||
res.json({ status: 'ok', campaigns });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/bot/guild/:guildId/campaign', requireBot, async (req, res) => {
|
||||
try {
|
||||
const guildId = String(req.params.guildId);
|
||||
if (!validGuildId(guildId) || !req.body.campaignId) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
|
||||
const link = await DiscordGuildLink.findOne({ guildId }).lean();
|
||||
if (!link) return res.json({ status: 'error', msg: 'discord.errors.not-connected' });
|
||||
|
||||
const campaign = await Campaign.findOne({ _id: req.body.campaignId, createdBy: link.dragonrollUser });
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
|
||||
const conflict = await Campaign.findOne({ discordGuildId: guildId, _id: { $ne: campaign._id } }).lean();
|
||||
if (conflict && String(conflict.createdBy) !== String(link.dragonrollUser)) {
|
||||
return res.json({ status: 'error', msg: 'campaigns.errors.discord-guild-in-use' });
|
||||
}
|
||||
if (campaign.discordGuildId && campaign.discordGuildId !== guildId) {
|
||||
return res.json({ status: 'error', msg: 'discord.errors.campaign-already-linked' });
|
||||
}
|
||||
|
||||
await Campaign.updateMany(
|
||||
{ discordGuildId: guildId, createdBy: link.dragonrollUser, _id: { $ne: campaign._id } },
|
||||
{ $unset: { discordGuildId: 1 } }
|
||||
);
|
||||
campaign.discordGuildId = guildId;
|
||||
await campaign.save();
|
||||
|
||||
res.json({ status: 'ok', campaign: { id: String(campaign._id), name: campaign.name } });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.delete('/bot/guild/:guildId/campaign', requireBot, async (req, res) => {
|
||||
try {
|
||||
const guildId = String(req.params.guildId);
|
||||
if (!validGuildId(guildId)) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
const link = await DiscordGuildLink.findOne({ guildId }).lean();
|
||||
if (!link) return res.json({ status: 'error', msg: 'discord.errors.not-connected' });
|
||||
|
||||
const campaign = await Campaign.findOne({ discordGuildId: guildId, createdBy: link.dragonrollUser });
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
campaign.discordGuildId = undefined;
|
||||
await campaign.save();
|
||||
res.json({ status: 'ok', campaign: { id: String(campaign._id), name: campaign.name } });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.get('/bot/guild/:guildId/actors', requireBot, async (req, res) => {
|
||||
try {
|
||||
const guildId = String(req.params.guildId);
|
||||
if (!validGuildId(guildId)) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
const link = await DiscordGuildLink.findOne({ guildId }).lean();
|
||||
if (!link) return res.json({ status: 'error', msg: 'discord.errors.not-connected' });
|
||||
const campaign = await Campaign.findOne({ discordGuildId: guildId, createdBy: link.dragonrollUser }).select('_id name').lean();
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
|
||||
const actors = await Actor.find({ campaign: campaign._id }).sort({ name: 1 }).lean();
|
||||
res.json({ status: 'ok', campaign: { id: String(campaign._id), name: campaign.name }, actors });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
258
backend/src/routes/foundry-link.js
Normal file
258
backend/src/routes/foundry-link.js
Normal file
@@ -0,0 +1,258 @@
|
||||
const crypto = require('node:crypto');
|
||||
const express = require('express');
|
||||
const rateLimit = require('express-rate-limit');
|
||||
const mongoose = require('mongoose');
|
||||
const router = express.Router();
|
||||
|
||||
const Campaign = require('../models/Campaign');
|
||||
const Actor = require('../models/Actor');
|
||||
const FoundryLinkRequest = require('../models/FoundryLinkRequest');
|
||||
const { foundryActorToCharacter } = require('../services/actor-foundry');
|
||||
|
||||
const linkRateLimit = rateLimit({ windowMs: 15 * 60 * 1000, max: 20 });
|
||||
|
||||
function codeHash(code) {
|
||||
return crypto.createHash('sha256').update(String(code ?? '').trim()).digest('hex');
|
||||
}
|
||||
|
||||
function readSyncToken(req) {
|
||||
const match = /^Bearer\s+(.+)$/i.exec(req.get('authorization') || '');
|
||||
return match?.[1] || '';
|
||||
}
|
||||
|
||||
async function syncCampaign(req, res) {
|
||||
const token = readSyncToken(req);
|
||||
if (!token) {
|
||||
res.json({ status: 'error', msg: 'unauthorized' });
|
||||
return null;
|
||||
}
|
||||
|
||||
const campaign = await Campaign.findOne({ foundrySyncTokenHash: codeHash(token) });
|
||||
if (!campaign?.foundryWorldId) {
|
||||
res.json({ status: 'error', msg: 'unauthorized' });
|
||||
return null;
|
||||
}
|
||||
return campaign;
|
||||
}
|
||||
|
||||
function requestMatchesWorld(campaign, worldId) {
|
||||
return typeof worldId === 'string' && worldId === campaign.foundryWorldId;
|
||||
}
|
||||
|
||||
async function saveFoundryActor(campaign, source, fullSync = false) {
|
||||
const foundryActorId = String(source?._id || source?.id || '').trim().slice(0, 120);
|
||||
const fields = foundryActorToCharacter(source || {});
|
||||
if (!foundryActorId || !fields.name) return null;
|
||||
|
||||
let actor = await Actor.findOne({ campaign: campaign._id, foundryActorId });
|
||||
const dragonrollActorId = source?.flags?.['dragonroll-foundry']?.actorId;
|
||||
if (!actor && mongoose.isValidObjectId(dragonrollActorId)) {
|
||||
actor = await Actor.findOne({ _id: dragonrollActorId, campaign: campaign._id });
|
||||
}
|
||||
if (!actor) {
|
||||
const possibleMatches = await Actor.find({
|
||||
campaign: campaign._id,
|
||||
name: fields.name,
|
||||
foundryActorId: { $exists: false }
|
||||
}).limit(2);
|
||||
actor = possibleMatches.length === 1
|
||||
? possibleMatches[0]
|
||||
: new Actor({ campaign: campaign._id });
|
||||
}
|
||||
actor.foundryActorId = foundryActorId;
|
||||
// A full snapshot runs when a GM reconnects. Preserve existing Dragonroll
|
||||
// edits then; live Foundry change events continue to overwrite normally.
|
||||
if (!fullSync || actor.isNew) Object.assign(actor, fields);
|
||||
await actor.save();
|
||||
return { foundryActorId, actorId: actor.id };
|
||||
}
|
||||
|
||||
function readWorld(body) {
|
||||
const world = body?.world;
|
||||
if (!world || typeof world.id !== 'string' || !world.id.trim()) return null;
|
||||
|
||||
let foundryUrl = '';
|
||||
if (typeof world.url === 'string') {
|
||||
try {
|
||||
const url = new URL(world.url);
|
||||
if (url.protocol === 'http:' || url.protocol === 'https:') foundryUrl = url.origin;
|
||||
} catch {}
|
||||
}
|
||||
|
||||
return {
|
||||
worldId: world.id.trim().slice(0, 120),
|
||||
worldTitle: typeof world.title === 'string' ? world.title.trim().slice(0, 200) : '',
|
||||
system: typeof world.system === 'string' ? world.system.trim().slice(0, 120) : '',
|
||||
foundryUrl
|
||||
};
|
||||
}
|
||||
|
||||
async function attachWorldToCampaign(campaign, world) {
|
||||
const linkedElsewhere = await Campaign.findOne({
|
||||
foundryWorldId: world.worldId,
|
||||
_id: { $ne: campaign._id }
|
||||
}).select('_id');
|
||||
if (linkedElsewhere) return false;
|
||||
|
||||
campaign.foundryWorldId = world.worldId;
|
||||
campaign.foundryWorldTitle = world.worldTitle;
|
||||
campaign.foundrySystem = world.system;
|
||||
if (world.foundryUrl) {
|
||||
const settings = campaign.settings && typeof campaign.settings === 'object' ? campaign.settings : {};
|
||||
const integrations = settings.integrations && typeof settings.integrations === 'object'
|
||||
? settings.integrations
|
||||
: {};
|
||||
campaign.settings = {
|
||||
...settings,
|
||||
integrations: {
|
||||
...integrations,
|
||||
foundryUrl: integrations.foundryUrl || world.foundryUrl
|
||||
}
|
||||
};
|
||||
}
|
||||
await campaign.save();
|
||||
return true;
|
||||
}
|
||||
|
||||
async function expireOtherPendingLinks(campaignId, userId, requestId) {
|
||||
await FoundryLinkRequest.updateMany({
|
||||
source: 'dragonroll',
|
||||
campaign: campaignId,
|
||||
createdBy: userId,
|
||||
completedAt: null,
|
||||
_id: { $ne: requestId }
|
||||
}, { $set: { expiresAt: new Date() } });
|
||||
}
|
||||
|
||||
router.post('/link/complete', linkRateLimit, async (req, res) => {
|
||||
try {
|
||||
const world = readWorld(req.body);
|
||||
if (!world || typeof req.body.code !== 'string' || !req.body.code.trim()) {
|
||||
return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
}
|
||||
|
||||
const request = await FoundryLinkRequest.findOne({
|
||||
codeHash: codeHash(req.body.code),
|
||||
source: 'dragonroll',
|
||||
expiresAt: { $gt: new Date() },
|
||||
completedAt: null
|
||||
});
|
||||
if (!request) return res.json({ status: 'error', msg: 'foundry.errors.link-expired' });
|
||||
|
||||
const campaign = await Campaign.findOne({ _id: request.campaign, createdBy: request.createdBy });
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
|
||||
const attached = await attachWorldToCampaign(campaign, world);
|
||||
if (!attached) return res.json({ status: 'error', msg: 'foundry.errors.world-already-linked' });
|
||||
|
||||
const syncToken = crypto.randomBytes(32).toString('base64url');
|
||||
campaign.foundrySyncTokenHash = codeHash(syncToken);
|
||||
await campaign.save();
|
||||
|
||||
request.worldId = world.worldId;
|
||||
request.worldTitle = world.worldTitle;
|
||||
request.system = world.system;
|
||||
request.foundryUrl = world.foundryUrl;
|
||||
request.completedAt = new Date();
|
||||
request.code = undefined; // Redeemed: keep only the hash from now on.
|
||||
await request.save();
|
||||
await expireOtherPendingLinks(campaign._id, request.createdBy, request._id);
|
||||
|
||||
const bridgeUrl = process.env.FOUNDRY_API_CLIENT_URL || process.env.FOUNDRY_API_URL;
|
||||
const pushToken = process.env.FOUNDRY_API_PUSH_TOKEN;
|
||||
res.set('Cache-Control', 'no-store');
|
||||
res.json({
|
||||
status: 'ok',
|
||||
world: { id: world.worldId, title: world.worldTitle, system: world.system },
|
||||
syncToken,
|
||||
bridgeConfig: bridgeUrl && pushToken ? { url: bridgeUrl, pushToken } : null
|
||||
});
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
if (err.code === 11000) return res.json({ status: 'error', msg: 'foundry.errors.world-already-linked' });
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/sync/snapshot', async (req, res) => {
|
||||
try {
|
||||
const campaign = await syncCampaign(req, res);
|
||||
if (!campaign) return;
|
||||
if (!requestMatchesWorld(campaign, req.body.worldId) || !Array.isArray(req.body.actors)) {
|
||||
return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
}
|
||||
|
||||
const actors = [];
|
||||
for (const source of req.body.actors) {
|
||||
const mapping = await saveFoundryActor(campaign, source, req.body.fullSync === true);
|
||||
if (mapping) actors.push(mapping);
|
||||
}
|
||||
if (req.body.fullSync === true) {
|
||||
const currentIds = req.body.actors
|
||||
.map((source) => String(source?._id || source?.id || '').trim())
|
||||
.filter(Boolean);
|
||||
await Actor.deleteMany({
|
||||
campaign: campaign._id,
|
||||
foundryActorId: { $exists: true, $nin: currentIds }
|
||||
});
|
||||
}
|
||||
res.json({ status: 'ok', actors });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/sync/delete', async (req, res) => {
|
||||
try {
|
||||
const campaign = await syncCampaign(req, res);
|
||||
if (!campaign) return;
|
||||
const foundryActorId = String(req.body.foundryActorId || '').trim();
|
||||
if (!requestMatchesWorld(campaign, req.body.worldId) || !foundryActorId) {
|
||||
return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
}
|
||||
|
||||
await Actor.deleteOne({ campaign: campaign._id, foundryActorId });
|
||||
res.json({ status: 'ok' });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.get('/sync/characters', async (req, res) => {
|
||||
try {
|
||||
const campaign = await syncCampaign(req, res);
|
||||
if (!campaign) return;
|
||||
const actors = await Actor.find({ campaign: campaign._id }).sort({ name: 1 }).lean();
|
||||
res.json({ status: 'ok', actors });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/sync/map', async (req, res) => {
|
||||
try {
|
||||
const campaign = await syncCampaign(req, res);
|
||||
if (!campaign) return;
|
||||
const { actorId, foundryActorId, worldId } = req.body;
|
||||
if (!requestMatchesWorld(campaign, worldId) || !actorId || !foundryActorId) {
|
||||
return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
}
|
||||
|
||||
const actor = await Actor.findOne({ _id: actorId, campaign: campaign._id });
|
||||
if (!actor) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
const existing = await Actor.findOne({ campaign: campaign._id, foundryActorId, _id: { $ne: actor._id } });
|
||||
if (existing) return res.json({ status: 'error', msg: 'foundry.errors.actor-already-synced' });
|
||||
|
||||
actor.foundryActorId = String(foundryActorId).trim().slice(0, 120);
|
||||
await actor.save();
|
||||
res.json({ status: 'ok', actor });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
27
backend/src/routes/foundry.js
Normal file
27
backend/src/routes/foundry.js
Normal file
@@ -0,0 +1,27 @@
|
||||
const express = require('express');
|
||||
const router = express.Router();
|
||||
const { requestFoundry } = require('../services/foundry');
|
||||
|
||||
async function proxy(path, res) {
|
||||
try {
|
||||
const result = await requestFoundry(path);
|
||||
res.status(result.status).json(result.data);
|
||||
} catch (err) {
|
||||
if (err.code === 'FOUNDRY_NOT_CONFIGURED') {
|
||||
return res.status(503).json({ status: 'error', msg: 'foundry.not-configured' });
|
||||
}
|
||||
|
||||
console.error(err);
|
||||
res.status(502).json({ status: 'error', msg: 'foundry.unavailable' });
|
||||
}
|
||||
}
|
||||
|
||||
router.get('/world', (req, res) => proxy('api/world', res));
|
||||
router.get('/actors', (req, res) => proxy('api/actors', res));
|
||||
router.get('/characters', (req, res) => proxy('api/characters', res));
|
||||
router.get('/items', (req, res) => proxy('api/items', res));
|
||||
router.get('/actors/:id/items', (req, res) => proxy(`api/actors/${encodeURIComponent(req.params.id)}/items`, res));
|
||||
router.get('/actors/:id', (req, res) => proxy(`api/actors/${encodeURIComponent(req.params.id)}`, res));
|
||||
router.get('/items/:id', (req, res) => proxy(`api/items/${encodeURIComponent(req.params.id)}`, res));
|
||||
|
||||
module.exports = router;
|
||||
60
backend/src/routes/item.js
Normal file
60
backend/src/routes/item.js
Normal file
@@ -0,0 +1,60 @@
|
||||
const express = require('express');
|
||||
const router = express.Router();
|
||||
|
||||
const Campaign = require('../models/Campaign');
|
||||
const Item = require('../models/Item');
|
||||
|
||||
async function userOwnsCampaign(campaignId, userId) {
|
||||
const campaign = await Campaign.findOne({ _id: campaignId, createdBy: userId }).lean();
|
||||
return Boolean(campaign);
|
||||
}
|
||||
|
||||
router.get('/list', async (req, res) => {
|
||||
try {
|
||||
const { campaign } = req.query;
|
||||
if (!campaign) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
if (!(await userOwnsCampaign(campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
|
||||
const items = await Item.find({ campaign }).sort({ name: 1 }).lean();
|
||||
res.json({ status: 'ok', items });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/create', async (req, res) => {
|
||||
try {
|
||||
const { name, campaign, category, rarity, quantity, weight, properties, description } = req.body;
|
||||
if (!name?.trim() || !campaign) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
if (!(await userOwnsCampaign(campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
|
||||
const item = await Item.create({
|
||||
name: name.trim(), campaign, category, rarity,
|
||||
quantity: quantity === '' || quantity === undefined ? 1 : Number(quantity),
|
||||
weight: weight === '' || weight === undefined ? undefined : Number(weight),
|
||||
properties, description
|
||||
});
|
||||
res.json({ status: 'ok', item });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
router.post('/delete', async (req, res) => {
|
||||
try {
|
||||
const { id } = req.body;
|
||||
if (!id) return res.json({ status: 'error', msg: 'errors.missing-data' });
|
||||
const item = await Item.findById(id);
|
||||
if (!item) return res.json({ status: 'error', msg: 'errors.notfound' });
|
||||
if (!(await userOwnsCampaign(item.campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
|
||||
await item.deleteOne();
|
||||
res.json({ status: 'ok' });
|
||||
} catch (err) {
|
||||
console.error(err);
|
||||
res.json({ status: 'error', msg: 'errors.internal' });
|
||||
}
|
||||
});
|
||||
|
||||
module.exports = router;
|
||||
82
backend/src/services/actor-foundry.js
Normal file
82
backend/src/services/actor-foundry.js
Normal file
@@ -0,0 +1,82 @@
|
||||
function numberOr(value, fallback) {
|
||||
const number = Number(value);
|
||||
return Number.isFinite(number) ? number : fallback;
|
||||
}
|
||||
|
||||
function asText(value) {
|
||||
return typeof value === 'string' ? value : '';
|
||||
}
|
||||
|
||||
function plainText(value) {
|
||||
return asText(value)
|
||||
.replace(/<br\s*\/?>/gi, '\n')
|
||||
.replace(/<\/p\s*>/gi, '\n')
|
||||
.replace(/<[^>]*>/g, ' ')
|
||||
.replace(/ /gi, ' ')
|
||||
.replace(/&/gi, '&')
|
||||
.replace(/</gi, '<')
|
||||
.replace(/>/gi, '>')
|
||||
.replace(/\s+\n/g, '\n')
|
||||
.trim();
|
||||
}
|
||||
|
||||
function traitList(value) {
|
||||
if (Array.isArray(value)) return value.map(asText).filter(Boolean);
|
||||
if (typeof value === 'string') return [value];
|
||||
return [];
|
||||
}
|
||||
|
||||
function foundryActorToCharacter(foundryActor) {
|
||||
const system = foundryActor.system || {};
|
||||
const details = system.details || {};
|
||||
const abilities = system.abilities || {};
|
||||
const attributes = system.attributes || {};
|
||||
const movement = attributes.movement || {};
|
||||
const items = Array.isArray(foundryActor.items) ? foundryActor.items : [];
|
||||
const classItem = items.find((item) => item.type === 'class');
|
||||
const subclassItem = items.find((item) => item.type === 'subclass');
|
||||
const backgroundItem = items.find((item) => item.type === 'background');
|
||||
const traits = system.traits || {};
|
||||
const savedDragonrollFields = foundryActor.flags?.['dragonroll-foundry'] || {};
|
||||
const savedDragonrollType = savedDragonrollFields.actorType;
|
||||
const foundryProficiencies = [
|
||||
...traitList(traits.languages?.value),
|
||||
...traitList(traits.armor?.value),
|
||||
...traitList(traits.weapon?.value),
|
||||
...traitList(traits.tool?.value)
|
||||
].join(', ');
|
||||
|
||||
return {
|
||||
name: asText(foundryActor.name).trim(),
|
||||
type: ['character', 'npc', 'creature'].includes(savedDragonrollType)
|
||||
? savedDragonrollType
|
||||
: (['character', 'npc', 'creature'].includes(foundryActor.type) ? foundryActor.type : 'character'),
|
||||
species: asText(details.race || details.species),
|
||||
className: asText(details.class || classItem?.name),
|
||||
subclass: asText(details.subclass || subclassItem?.name),
|
||||
level: numberOr(details.level ?? classItem?.system?.levels, 1),
|
||||
background: asText(details.background || backgroundItem?.name),
|
||||
challengeRating: String(details.cr ?? ''),
|
||||
description: plainText(details.biography?.value || details.biography),
|
||||
image: asText(foundryActor.img || foundryActor.image),
|
||||
abilityScores: Object.fromEntries(['str', 'dex', 'con', 'int', 'wis', 'cha'].map((key) => [
|
||||
key,
|
||||
numberOr(abilities[key]?.value, 10)
|
||||
])),
|
||||
armorClass: numberOr(attributes.ac?.value ?? attributes.ac, 10),
|
||||
speed: numberOr(movement.walk ?? movement.value, 30),
|
||||
proficiencies: foundryProficiencies || asText(savedDragonrollFields.proficiencies),
|
||||
traits: asText(savedDragonrollFields.traits),
|
||||
inventory: items
|
||||
.filter((item) => !['class', 'subclass', 'background', 'spell'].includes(item.type))
|
||||
.map((item) => ({
|
||||
name: asText(item.name).trim(),
|
||||
quantity: numberOr(item.system?.quantity, 1),
|
||||
weight: numberOr(item.system?.weight?.value ?? item.system?.weight, 0)
|
||||
}))
|
||||
.filter((item) => item.name),
|
||||
spells: items.filter((item) => item.type === 'spell').map((item) => asText(item.name)).filter(Boolean).join('\n')
|
||||
};
|
||||
}
|
||||
|
||||
module.exports = { foundryActorToCharacter };
|
||||
34
backend/src/services/foundry.js
Normal file
34
backend/src/services/foundry.js
Normal file
@@ -0,0 +1,34 @@
|
||||
async function requestFoundry(path) {
|
||||
const baseUrl = process.env.FOUNDRY_API_URL;
|
||||
const token = process.env.FOUNDRY_API_TOKEN;
|
||||
|
||||
if (!baseUrl || !token) {
|
||||
const error = new Error('Foundry API is not configured.');
|
||||
error.code = 'FOUNDRY_NOT_CONFIGURED';
|
||||
throw error;
|
||||
}
|
||||
|
||||
const normalizedBase = baseUrl.endsWith('/') ? baseUrl : `${baseUrl}/`;
|
||||
const url = new URL(path.replace(/^\/+/, ''), normalizedBase);
|
||||
const response = await fetch(url, {
|
||||
headers: {
|
||||
'Accept': 'application/json',
|
||||
'Authorization': `Bearer ${token}`
|
||||
},
|
||||
signal: AbortSignal.timeout(10000)
|
||||
});
|
||||
|
||||
const body = await response.text();
|
||||
let data;
|
||||
try {
|
||||
data = JSON.parse(body);
|
||||
} catch {
|
||||
const error = new Error('Foundry API returned an invalid response.');
|
||||
error.code = 'FOUNDRY_INVALID_RESPONSE';
|
||||
throw error;
|
||||
}
|
||||
|
||||
return { status: response.status, data };
|
||||
}
|
||||
|
||||
module.exports = { requestFoundry };
|
||||
7
discord-bot/.dockerignore
Normal file
7
discord-bot/.dockerignore
Normal file
@@ -0,0 +1,7 @@
|
||||
node_modules
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
npm-debug.log*
|
||||
Dockerfile
|
||||
.dockerignore
|
||||
14
discord-bot/.env.example
Normal file
14
discord-bot/.env.example
Normal file
@@ -0,0 +1,14 @@
|
||||
# Create a bot application at https://discord.com/developers/applications
|
||||
DISCORD_TOKEN=
|
||||
DISCORD_CLIENT_ID=
|
||||
|
||||
# Dragonroll API URL including /api. For local development:
|
||||
DRAGONROLL_API_URL=http://localhost:5000/api
|
||||
# Frontend address people open when they click the sign-in button in Discord. The
|
||||
# frontend then talks to the API above. Set this when the frontend is not reachable
|
||||
# at the API address.
|
||||
DRAGONROLL_FRONTEND_URL=http://localhost:3000
|
||||
|
||||
# Generate a long random value and set the same value in the backend
|
||||
# environment as DRAGONROLL_DISCORD_BOT_SECRET.
|
||||
DRAGONROLL_DISCORD_BOT_SECRET=replace-with-a-long-random-secret
|
||||
3
discord-bot/.gitignore
vendored
Normal file
3
discord-bot/.gitignore
vendored
Normal file
@@ -0,0 +1,3 @@
|
||||
.env
|
||||
node_modules/
|
||||
npm-debug.log*
|
||||
22
discord-bot/Dockerfile
Normal file
22
discord-bot/Dockerfile
Normal file
@@ -0,0 +1,22 @@
|
||||
# Use official Node.js runtime
|
||||
FROM node:20-alpine
|
||||
|
||||
# Create app directory
|
||||
WORKDIR /usr/src/app
|
||||
|
||||
# Copy package files first (better caching)
|
||||
COPY package*.json ./
|
||||
|
||||
# Install dependencies
|
||||
RUN npm ci --only=production
|
||||
|
||||
# Copy application source
|
||||
COPY . .
|
||||
|
||||
# Environment variable
|
||||
ENV NODE_ENV=production
|
||||
|
||||
# The bot only makes outbound connections (Discord gateway + Dragonroll API),
|
||||
# it does not listen on a port.
|
||||
# Start the application
|
||||
CMD ["node", "src/index.js"]
|
||||
48
discord-bot/README.md
Normal file
48
discord-bot/README.md
Normal file
@@ -0,0 +1,48 @@
|
||||
# Dragonroll Discord bot
|
||||
|
||||
A read-only Discord bot for consulting actors (characters, NPCs, and creatures) from Dragonroll. It talks to Dragonroll through authenticated API endpoints; it does not connect to MongoDB directly.
|
||||
|
||||
## Configure one campaign per Discord server
|
||||
|
||||
The bot can sit in as many Discord servers as you like. A Discord **Administrator** connects their own Dragonroll account with `/dragonroll connect`, signs in on Dragonroll’s site, then chooses one of their campaigns with `/dragonroll link`. The bot posts an ephemeral confirmation in Discord as soon as the authorization goes through. Dragonroll remembers the account and campaign for that guild. The bot never stores the Dragonroll user's password or token.
|
||||
|
||||
```
|
||||
Discord server A ──link──▶ Dragonroll campaign "Katlum" (account gm-a@example.com)
|
||||
Discord server B ──link──▶ Dragonroll campaign "Silang" (account gm-b@example.com)
|
||||
```
|
||||
|
||||
## Commands
|
||||
|
||||
- `/characters [type]` lists the linked campaign's actors, optionally filtered to characters, NPCs, or creatures.
|
||||
- `/character name public:true` shows the matching actor's portrait (when one has been uploaded), profile, ability scores, combat stats, proficiencies, traits, spells, and inventory. Type part of a name to pick it from the campaign's current roster. Set `public` to `true` to show the reply to everyone in the channel.
|
||||
- `/dragonroll connect` starts a short-lived Dragonroll sign-in and authorization link, and confirms here once somebody authorizes the server.
|
||||
- `/dragonroll link` lets a server administrator choose a campaign owned by the connected Dragonroll account. Type part of a campaign name to filter the choices.
|
||||
- `/dragonroll unlink` removes this server’s campaign link.
|
||||
- `/dragonroll status` shows the campaign linked to this server.
|
||||
- `/dragonroll refresh` rechecks the current connection and campaign in Dragonroll.
|
||||
|
||||
Replies are private by default. `/character` can be made public with its `public` option, so everyone in the channel can see the character sheet.
|
||||
|
||||
## Setup
|
||||
|
||||
1. Create a Discord application and bot in the [Discord Developer Portal](https://discord.com/developers/applications). It only needs permission to use application commands and send replies.
|
||||
2. Generate a long random shared secret. Set it as `DRAGONROLL_DISCORD_BOT_SECRET` in both the backend environment and the bot's `.env`. This authenticates the bot service; it is not a Dragonroll user account.
|
||||
3. Copy `.env.example` to `.env` and enter the Discord token, application id, API URL, frontend URL, and shared secret. `DRAGONROLL_API_URL` must be reachable by the bot. `DRAGONROLL_FRONTEND_URL` is the address people open when they click the sign-in button, and it defaults to `http://localhost:3000`. Keep `.env` private.
|
||||
4. Invite the bot to each server with the `bot` and `applications.commands` scopes. A Discord Administrator runs `/dragonroll connect`, opens the Dragonroll button, signs in and confirms the server link, then returns to Discord and runs `/dragonroll link` to select a campaign they own. Each campaign can be linked to one server at a time.
|
||||
5. Install packages and register the slash commands:
|
||||
|
||||
```sh
|
||||
npm install
|
||||
npm run deploy-commands
|
||||
```
|
||||
|
||||
Commands are registered globally, so every server the bot is in can use them. Global registration can take up to an hour to propagate; the bot also registers the commands itself as soon as it joins a server, and refreshes them in every server on each start so command changes reach guild commands too. For quick testing on one server only: `npm run deploy-commands -- --guild <server id>` (note that those guild commands then shadow the global ones in that server).
|
||||
6. From the repository root, start the backend, frontend, and Discord bot together:
|
||||
|
||||
```sh
|
||||
npm run dev
|
||||
```
|
||||
|
||||
To run only the bot, start the backend first and use `npm start` from `discord-bot/`.
|
||||
|
||||
The bot can start without any Dragonroll user account. It uses the shared service secret for guild-scoped API calls, so configure the secret in both environments before using Dragonroll commands. Dragonroll user credentials are entered only on Dragonroll's site and are not sent through Discord. The bot needs outbound access to both the Dragonroll API and Discord.
|
||||
327
discord-bot/package-lock.json
generated
Normal file
327
discord-bot/package-lock.json
generated
Normal file
@@ -0,0 +1,327 @@
|
||||
{
|
||||
"name": "dragonroll-discord-bot",
|
||||
"version": "1.0.0",
|
||||
"lockfileVersion": 3,
|
||||
"requires": true,
|
||||
"packages": {
|
||||
"": {
|
||||
"name": "dragonroll-discord-bot",
|
||||
"version": "1.0.0",
|
||||
"dependencies": {
|
||||
"discord.js": "^14.27.0",
|
||||
"dotenv": "^17.2.3"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=20"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/builders": {
|
||||
"version": "1.14.1",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/builders/-/builders-1.14.1.tgz",
|
||||
"integrity": "sha512-gSKkhXLqs96TCzk66VZuHHl8z2bQMJFGwrXC0f33ngK+FLNau4hU1PYny3DNJfNdSH+gVMzE85/d5FQ2BpcNwQ==",
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"@discordjs/formatters": "^0.6.2",
|
||||
"@discordjs/util": "^1.2.0",
|
||||
"@sapphire/shapeshift": "^4.0.0",
|
||||
"discord-api-types": "^0.38.40",
|
||||
"fast-deep-equal": "^3.1.3",
|
||||
"ts-mixer": "^6.0.4",
|
||||
"tslib": "^2.6.3"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/collection": {
|
||||
"version": "1.5.3",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/collection/-/collection-1.5.3.tgz",
|
||||
"integrity": "sha512-SVb428OMd3WO1paV3rm6tSjM4wC+Kecaa1EUGX7vc6/fddvw/6lg90z4QtCqm21zvVe92vMMDt9+DkIvjXImQQ==",
|
||||
"license": "Apache-2.0",
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/formatters": {
|
||||
"version": "0.6.2",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/formatters/-/formatters-0.6.2.tgz",
|
||||
"integrity": "sha512-y4UPwWhH6vChKRkGdMB4odasUbHOUwy7KL+OVwF86PvT6QVOwElx+TiI1/6kcmcEe+g5YRXJFiXSXUdabqZOvQ==",
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"discord-api-types": "^0.38.33"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/rest": {
|
||||
"version": "2.6.3",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/rest/-/rest-2.6.3.tgz",
|
||||
"integrity": "sha512-wvOylxNYJkwKjctS/Mn5GP1w9r3/rzyH+ThD1JlAca6zEdlHs8QWBBUQJpU5Q+W6DoIj/Ljh1IPlZs7hTU+UAg==",
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"@discordjs/collection": "^2.1.1",
|
||||
"@discordjs/util": "^1.2.0",
|
||||
"@sapphire/async-queue": "^1.5.3",
|
||||
"@sapphire/snowflake": "^3.5.5",
|
||||
"@vladfrangu/async_event_emitter": "^2.4.6",
|
||||
"discord-api-types": "^0.38.50",
|
||||
"magic-bytes.js": "^1.13.0",
|
||||
"tslib": "^2.6.3",
|
||||
"undici": "^6.27.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/rest/node_modules/@discordjs/collection": {
|
||||
"version": "2.1.1",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/collection/-/collection-2.1.1.tgz",
|
||||
"integrity": "sha512-LiSusze9Tc7qF03sLCujF5iZp7K+vRNEDBZ86FT9aQAv3vxMLihUvKvpsCWiQ2DJq1tVckopKm1rxomgNUc9hg==",
|
||||
"license": "Apache-2.0",
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/util": {
|
||||
"version": "1.2.0",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/util/-/util-1.2.0.tgz",
|
||||
"integrity": "sha512-3LKP7F2+atl9vJFhaBjn4nOaSWahZ/yWjOvA4e5pnXkt2qyXRCHLxoBQy81GFtLGCq7K9lPm9R517M1U+/90Qg==",
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"discord-api-types": "^0.38.33"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/ws": {
|
||||
"version": "1.2.3",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/ws/-/ws-1.2.3.tgz",
|
||||
"integrity": "sha512-wPlQDxEmlDg5IxhJPuxXr3Vy9AjYq5xCvFWGJyD7w7Np8ZGu+Mc+97LCoEc/+AYCo2IDpKioiH0/c/mj5ZR9Uw==",
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"@discordjs/collection": "^2.1.0",
|
||||
"@discordjs/rest": "^2.5.1",
|
||||
"@discordjs/util": "^1.1.0",
|
||||
"@sapphire/async-queue": "^1.5.2",
|
||||
"@types/ws": "^8.5.10",
|
||||
"@vladfrangu/async_event_emitter": "^2.2.4",
|
||||
"discord-api-types": "^0.38.1",
|
||||
"tslib": "^2.6.2",
|
||||
"ws": "^8.17.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=16.11.0"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@discordjs/ws/node_modules/@discordjs/collection": {
|
||||
"version": "2.1.1",
|
||||
"resolved": "https://registry.npmjs.org/@discordjs/collection/-/collection-2.1.1.tgz",
|
||||
"integrity": "sha512-LiSusze9Tc7qF03sLCujF5iZp7K+vRNEDBZ86FT9aQAv3vxMLihUvKvpsCWiQ2DJq1tVckopKm1rxomgNUc9hg==",
|
||||
"license": "Apache-2.0",
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/@sapphire/async-queue": {
|
||||
"version": "1.5.5",
|
||||
"resolved": "https://registry.npmjs.org/@sapphire/async-queue/-/async-queue-1.5.5.tgz",
|
||||
"integrity": "sha512-cvGzxbba6sav2zZkH8GPf2oGk9yYoD5qrNWdu9fRehifgnFZJMV+nuy2nON2roRO4yQQ+v7MK/Pktl/HgfsUXg==",
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">=v14.0.0",
|
||||
"npm": ">=7.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@sapphire/shapeshift": {
|
||||
"version": "4.0.0",
|
||||
"resolved": "https://registry.npmjs.org/@sapphire/shapeshift/-/shapeshift-4.0.0.tgz",
|
||||
"integrity": "sha512-d9dUmWVA7MMiKobL3VpLF8P2aeanRTu6ypG2OIaEv/ZHH/SUQ2iHOVyi5wAPjQ+HmnMuL0whK9ez8I/raWbtIg==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"fast-deep-equal": "^3.1.3",
|
||||
"lodash": "^4.17.21"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=v16"
|
||||
}
|
||||
},
|
||||
"node_modules/@sapphire/snowflake": {
|
||||
"version": "3.5.5",
|
||||
"resolved": "https://registry.npmjs.org/@sapphire/snowflake/-/snowflake-3.5.5.tgz",
|
||||
"integrity": "sha512-xzvBr1Q1c4lCe7i6sRnrofxeO1QTP/LKQ6A6qy0iB4x5yfiSfARMEQEghojzTNALDTcv8En04qYNIco9/K9eZQ==",
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">=v14.0.0",
|
||||
"npm": ">=7.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@types/node": {
|
||||
"version": "26.6.5",
|
||||
"resolved": "https://registry.npmjs.org/@types/node/-/node-26.6.5.tgz",
|
||||
"integrity": "sha512-uMzsv9stDdofIZBx4UGh4Z9ZgXnGC9seRDscilBcTHAeOFk67MZg/k9bWVfO+bk4qZmG+l52hRnLwUiH2LnJTg==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"undici-types": "~8.9.0"
|
||||
}
|
||||
},
|
||||
"node_modules/@types/ws": {
|
||||
"version": "8.18.2",
|
||||
"resolved": "https://registry.npmjs.org/@types/ws/-/ws-8.18.2.tgz",
|
||||
"integrity": "sha512-67MQl+fpWKVTT1NYdnmo3U4sc/xPo/zQBncVnI74qmQa0z/b+1g6iYqNmGCPbxO+zz2aklb08a0oHfegiVd0/w==",
|
||||
"license": "MIT",
|
||||
"dependencies": {
|
||||
"@types/node": "*"
|
||||
}
|
||||
},
|
||||
"node_modules/@vladfrangu/async_event_emitter": {
|
||||
"version": "2.4.7",
|
||||
"resolved": "https://registry.npmjs.org/@vladfrangu/async_event_emitter/-/async_event_emitter-2.4.7.tgz",
|
||||
"integrity": "sha512-Xfe6rpCTxSxfbswi/W/Pz7zp1WWSNn4A0eW4mLkQUewCrXXtMj31lCg+iQyTkh/CkusZSq9eDflu7tjEDXUY6g==",
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">=v14.0.0",
|
||||
"npm": ">=7.0.0"
|
||||
}
|
||||
},
|
||||
"node_modules/discord-api-types": {
|
||||
"version": "0.38.56",
|
||||
"resolved": "https://registry.npmjs.org/discord-api-types/-/discord-api-types-0.38.56.tgz",
|
||||
"integrity": "sha512-Hti4RZsGvF5C7SM8rF2MDHtIm0Hyfrlk84GpEA29nj91tvVVMvX+oQSCodu10t2ZcjFGofq8TX0YyC04B2E69Q==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/discord.js": {
|
||||
"version": "14.27.0",
|
||||
"resolved": "https://registry.npmjs.org/discord.js/-/discord.js-14.27.0.tgz",
|
||||
"integrity": "sha512-qHbFlFG2N7y3LjPySYsL6A1+BnX6bkTVgo842EX0CqVPk/KTMwZkojPHEXKsQUpWZNyz5BISNHK1cPpQw0+m4A==",
|
||||
"license": "Apache-2.0",
|
||||
"dependencies": {
|
||||
"@discordjs/builders": "^1.14.1",
|
||||
"@discordjs/collection": "1.5.3",
|
||||
"@discordjs/formatters": "^0.6.2",
|
||||
"@discordjs/rest": "^2.6.2",
|
||||
"@discordjs/util": "^1.2.0",
|
||||
"@discordjs/ws": "^1.2.3",
|
||||
"@sapphire/snowflake": "3.5.5",
|
||||
"discord-api-types": "^0.38.49",
|
||||
"fast-deep-equal": "3.1.3",
|
||||
"lodash.snakecase": "4.1.1",
|
||||
"magic-bytes.js": "^1.13.0",
|
||||
"tslib": "^2.6.3",
|
||||
"undici": "^6.27.0"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://github.com/discordjs/discord.js?sponsor"
|
||||
}
|
||||
},
|
||||
"node_modules/dotenv": {
|
||||
"version": "17.4.2",
|
||||
"resolved": "https://registry.npmjs.org/dotenv/-/dotenv-17.4.2.tgz",
|
||||
"integrity": "sha512-nI4U3TottKAcAD9LLud4Cb7b2QztQMUEfHbvhTH09bqXTxnSie8WnjPALV/WMCrJZ6UV/qHJ6L03OqO3LcdYZw==",
|
||||
"license": "BSD-2-Clause",
|
||||
"engines": {
|
||||
"node": ">=12"
|
||||
},
|
||||
"funding": {
|
||||
"url": "https://dotenvx.com"
|
||||
}
|
||||
},
|
||||
"node_modules/fast-deep-equal": {
|
||||
"version": "3.1.3",
|
||||
"resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz",
|
||||
"integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/lodash": {
|
||||
"version": "4.18.1",
|
||||
"resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz",
|
||||
"integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/lodash.snakecase": {
|
||||
"version": "4.1.1",
|
||||
"resolved": "https://registry.npmjs.org/lodash.snakecase/-/lodash.snakecase-4.1.1.tgz",
|
||||
"integrity": "sha512-QZ1d4xoBHYUeuouhEq3lk3Uq7ldgyFXGBhg04+oRLnIz8o9T65Eh+8YdroUwn846zchkA9yDsDl5CVVaV2nqYw==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/magic-bytes.js": {
|
||||
"version": "1.13.1",
|
||||
"resolved": "https://registry.npmjs.org/magic-bytes.js/-/magic-bytes.js-1.13.1.tgz",
|
||||
"integrity": "sha512-x5sn4UX2k5gCWlcfmoFwG4TPie8+dctESyqOBdhB5p6MsgWXdBKGmt9nXPObj/JI50TTL928lc5Yt1WntMn1bw==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/ts-mixer": {
|
||||
"version": "6.0.4",
|
||||
"resolved": "https://registry.npmjs.org/ts-mixer/-/ts-mixer-6.0.4.tgz",
|
||||
"integrity": "sha512-ufKpbmrugz5Aou4wcr5Wc1UUFWOLhq+Fm6qa6P0w0K5Qw2yhaUoiWszhCVuNQyNwrlGiscHOmqYoAox1PtvgjA==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/tslib": {
|
||||
"version": "2.8.1",
|
||||
"resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz",
|
||||
"integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==",
|
||||
"license": "0BSD"
|
||||
},
|
||||
"node_modules/undici": {
|
||||
"version": "6.29.0",
|
||||
"resolved": "https://registry.npmjs.org/undici/-/undici-6.29.0.tgz",
|
||||
"integrity": "sha512-R+RODBqp6i2pPflGdq+xIOUkl+RNfGgHwoinecKu/JCuf2uO06cOKoDbI2P7Dn6KcswdKwrczbU6IYJ6K8X+wg==",
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">=18.17"
|
||||
}
|
||||
},
|
||||
"node_modules/undici-types": {
|
||||
"version": "8.9.0",
|
||||
"resolved": "https://registry.npmjs.org/undici-types/-/undici-types-8.9.0.tgz",
|
||||
"integrity": "sha512-KTDyRTYX8sWmKXAikPHHSyc63CRPETMctyjKFupcC6OBLXT3xsN0e9aF7m+mIXutFWpUXuedtowG7iLOzp0kQg==",
|
||||
"license": "MIT"
|
||||
},
|
||||
"node_modules/ws": {
|
||||
"version": "8.22.0",
|
||||
"resolved": "https://registry.npmjs.org/ws/-/ws-8.22.0.tgz",
|
||||
"integrity": "sha512-Ydggc987+RO0AnWtZ/7Wq9FtNvcrL1b/RO0ud9mWjUPgDrsAAwQSF51sm2hm1XofbU/4jkpGEsLFsZZxU+1DOg==",
|
||||
"license": "MIT",
|
||||
"engines": {
|
||||
"node": ">=10.0.0"
|
||||
},
|
||||
"peerDependencies": {
|
||||
"bufferutil": "^4.0.1",
|
||||
"utf-8-validate": ">=5.0.2"
|
||||
},
|
||||
"peerDependenciesMeta": {
|
||||
"bufferutil": {
|
||||
"optional": true
|
||||
},
|
||||
"utf-8-validate": {
|
||||
"optional": true
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
18
discord-bot/package.json
Normal file
18
discord-bot/package.json
Normal file
@@ -0,0 +1,18 @@
|
||||
{
|
||||
"name": "dragonroll-discord-bot",
|
||||
"version": "1.0.0",
|
||||
"private": true,
|
||||
"description": "Discord slash commands for consulting Dragonroll campaign characters.",
|
||||
"main": "src/index.js",
|
||||
"scripts": {
|
||||
"start": "node src/index.js",
|
||||
"deploy-commands": "node src/deploy-commands.js"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=20"
|
||||
},
|
||||
"dependencies": {
|
||||
"discord.js": "^14.27.0",
|
||||
"dotenv": "^17.2.3"
|
||||
}
|
||||
}
|
||||
57
discord-bot/src/commands.js
Normal file
57
discord-bot/src/commands.js
Normal file
@@ -0,0 +1,57 @@
|
||||
const { InteractionContextType, SlashCommandBuilder } = require('discord.js');
|
||||
|
||||
// Every command needs a Dragonroll campaign, and campaigns are linked to
|
||||
// Discord servers, so none of them make sense in a DM.
|
||||
const guildOnly = (command) => command.setContexts(InteractionContextType.Guild);
|
||||
|
||||
const commands = [
|
||||
guildOnly(new SlashCommandBuilder()
|
||||
.setName('characters')
|
||||
.setDescription('List the characters of the Dragonroll campaign linked to this server.')
|
||||
.addStringOption((option) => option
|
||||
.setName('type')
|
||||
.setDescription('Filter by actor type.')
|
||||
.addChoices(
|
||||
{ name: 'All', value: 'all' },
|
||||
{ name: 'Characters', value: 'character' },
|
||||
{ name: 'NPCs', value: 'npc' },
|
||||
{ name: 'Creatures', value: 'creature' }
|
||||
))),
|
||||
guildOnly(new SlashCommandBuilder()
|
||||
.setName('character')
|
||||
.setDescription('Consult a character sheet from the Dragonroll campaign linked to this server.')
|
||||
.addStringOption((option) => option
|
||||
.setName('name')
|
||||
.setDescription('Character name (full or partial).')
|
||||
.setRequired(true)
|
||||
.setMaxLength(100)
|
||||
.setAutocomplete(true))
|
||||
.addBooleanOption((option) => option
|
||||
.setName('public')
|
||||
.setDescription('Show the character sheet to everyone in this channel.'))),
|
||||
guildOnly(new SlashCommandBuilder()
|
||||
.setName('dragonroll')
|
||||
.setDescription('Configure or check this server’s Dragonroll campaign.')
|
||||
.addSubcommand((subcommand) => subcommand
|
||||
.setName('connect')
|
||||
.setDescription('Connect your Dragonroll account to this server.'))
|
||||
.addSubcommand((subcommand) => subcommand
|
||||
.setName('link')
|
||||
.setDescription('Choose a campaign owned by the connected Dragonroll account.')
|
||||
.addStringOption((option) => option
|
||||
.setName('campaign')
|
||||
.setDescription('Campaign to use in this server.')
|
||||
.setRequired(true)
|
||||
.setAutocomplete(true)))
|
||||
.addSubcommand((subcommand) => subcommand
|
||||
.setName('unlink')
|
||||
.setDescription('Remove this server’s Dragonroll campaign link.'))
|
||||
.addSubcommand((subcommand) => subcommand
|
||||
.setName('status')
|
||||
.setDescription('Show the campaign linked to this server.'))
|
||||
.addSubcommand((subcommand) => subcommand
|
||||
.setName('refresh')
|
||||
.setDescription('Refresh this server’s Dragonroll connection status.')))
|
||||
];
|
||||
|
||||
module.exports = commands;
|
||||
41
discord-bot/src/config.js
Normal file
41
discord-bot/src/config.js
Normal file
@@ -0,0 +1,41 @@
|
||||
const dotenv = require('dotenv');
|
||||
|
||||
dotenv.config();
|
||||
|
||||
function required(name) {
|
||||
const value = process.env[name]?.trim();
|
||||
if (!value) throw new Error(`Missing required environment variable: ${name}`);
|
||||
return value;
|
||||
}
|
||||
|
||||
function apiUrl(value, name) {
|
||||
const url = value.trim().replace(/\/+$/, '');
|
||||
if (!/^https?:\/\//i.test(url)) throw new Error(`${name} must start with http:// or https://`);
|
||||
return url;
|
||||
}
|
||||
|
||||
// Frontend address, not the API: the sign-in page people open from Discord lives there.
|
||||
function frontendUrl(value, name) {
|
||||
const url = apiUrl(value, name).replace(/\/api$/i, '');
|
||||
if (!url) throw new Error(`${name} must be the Dragonroll frontend address, like http://localhost:3000`);
|
||||
return url;
|
||||
}
|
||||
|
||||
function getConfig() {
|
||||
const apiUrlValue = process.env.DRAGONROLL_API_URL || 'http://localhost:5000/api';
|
||||
const apiBaseUrl = apiUrl(apiUrlValue, 'DRAGONROLL_API_URL');
|
||||
const frontendBaseUrl = frontendUrl(
|
||||
process.env.DRAGONROLL_FRONTEND_URL || process.env.DRAGONROLL_PUBLIC_API_URL || 'http://localhost:3000',
|
||||
'DRAGONROLL_FRONTEND_URL'
|
||||
);
|
||||
|
||||
return {
|
||||
apiBaseUrl,
|
||||
frontendBaseUrl,
|
||||
discordBotSecret: process.env.DRAGONROLL_DISCORD_BOT_SECRET?.trim() || '',
|
||||
discordToken: required('DISCORD_TOKEN'),
|
||||
discordClientId: required('DISCORD_CLIENT_ID')
|
||||
};
|
||||
}
|
||||
|
||||
module.exports = { getConfig };
|
||||
44
discord-bot/src/deploy-commands.js
Normal file
44
discord-bot/src/deploy-commands.js
Normal file
@@ -0,0 +1,44 @@
|
||||
const { REST, Routes } = require('discord.js');
|
||||
const { getConfig } = require('./config');
|
||||
const commands = require('./commands');
|
||||
|
||||
// Global by default: the bot can be invited to any number of servers, and the
|
||||
// campaign it answers with is decided per server by Dragonroll.
|
||||
// Pass "--guild <server id>" while developing to see changes in one server at once.
|
||||
function routeFor(clientId, guildId) {
|
||||
return guildId
|
||||
? Routes.applicationGuildCommands(clientId, guildId)
|
||||
: Routes.applicationCommands(clientId);
|
||||
}
|
||||
|
||||
function parseGuildArg(argv) {
|
||||
const index = argv.indexOf('--guild');
|
||||
if (index === -1) return null;
|
||||
|
||||
const guildId = argv[index + 1];
|
||||
if (!guildId || guildId.startsWith('--')) {
|
||||
throw new Error('Usage: npm run deploy-commands -- --guild <discord server id>');
|
||||
}
|
||||
return guildId;
|
||||
}
|
||||
|
||||
async function deploy() {
|
||||
const config = getConfig();
|
||||
const guildId = parseGuildArg(process.argv.slice(2));
|
||||
const rest = new REST({ version: '10' }).setToken(config.discordToken);
|
||||
|
||||
await rest.put(routeFor(config.discordClientId, guildId), { body: commands.map((command) => command.toJSON()) });
|
||||
|
||||
if (guildId) {
|
||||
console.log(`Registered ${commands.length} commands in Discord server ${guildId}.`);
|
||||
return;
|
||||
}
|
||||
|
||||
console.log(`Registered ${commands.length} commands globally.`);
|
||||
console.log('New servers can take up to an hour to see them; the bot also registers them when it joins a server.');
|
||||
}
|
||||
|
||||
deploy().catch((error) => {
|
||||
console.error('Could not register Discord commands:', error.message);
|
||||
process.exitCode = 1;
|
||||
});
|
||||
117
discord-bot/src/dragonroll-api.js
Normal file
117
discord-bot/src/dragonroll-api.js
Normal file
@@ -0,0 +1,117 @@
|
||||
class CampaignNotLinkedError extends Error {
|
||||
constructor(guildId) {
|
||||
super(`No Dragonroll campaign is linked to Discord server ${guildId}.`);
|
||||
this.name = 'CampaignNotLinkedError';
|
||||
this.guildId = guildId;
|
||||
}
|
||||
}
|
||||
|
||||
class DragonrollNotConnectedError extends Error {
|
||||
constructor(guildId) {
|
||||
super(`No Dragonroll account is connected to Discord server ${guildId}.`);
|
||||
this.name = 'DragonrollNotConnectedError';
|
||||
this.guildId = guildId;
|
||||
}
|
||||
}
|
||||
|
||||
function createDragonrollApi(config) {
|
||||
async function request(path, options = {}) {
|
||||
if (!config.discordBotSecret) {
|
||||
throw new Error('Set DRAGONROLL_DISCORD_BOT_SECRET in the bot and backend environments before using Dragonroll commands.');
|
||||
}
|
||||
|
||||
const response = await fetch(`${config.apiBaseUrl}${path}`, {
|
||||
...options,
|
||||
headers: {
|
||||
...(options.body ? { 'Content-Type': 'application/json' } : {}),
|
||||
'X-Dragonroll-Discord-Bot-Secret': config.discordBotSecret,
|
||||
...options.headers
|
||||
}
|
||||
});
|
||||
|
||||
let payload;
|
||||
try {
|
||||
payload = await response.json();
|
||||
} catch {
|
||||
const error = new Error(`Dragonroll API returned an unreadable response (${response.status}).`);
|
||||
error.status = response.status;
|
||||
throw error;
|
||||
}
|
||||
|
||||
if (!response.ok || payload.status === 'error') {
|
||||
const error = new Error(payload.msg || `Dragonroll API request failed (${response.status}).`);
|
||||
error.status = response.status;
|
||||
error.code = payload.msg;
|
||||
throw error;
|
||||
}
|
||||
return payload;
|
||||
}
|
||||
|
||||
async function startAuthorization(guildId, guildName, discordUserId, discordUserName) {
|
||||
return request('/discord/link/start', {
|
||||
method: 'POST',
|
||||
body: JSON.stringify({ guildId, guildName, discordUserId, discordUserName })
|
||||
});
|
||||
}
|
||||
|
||||
async function claimLinkNotifications() {
|
||||
const payload = await request('/discord/bot/link-requests/notifications', { method: 'POST' });
|
||||
return Array.isArray(payload.notifications) ? payload.notifications : [];
|
||||
}
|
||||
|
||||
async function getStatus(guildId) { return request(`/discord/bot/guild/${encodeURIComponent(guildId)}/status`);
|
||||
}
|
||||
|
||||
async function listCampaigns(guildId) {
|
||||
const payload = await request(`/discord/bot/guild/${encodeURIComponent(guildId)}/campaigns`);
|
||||
if (!Array.isArray(payload.campaigns)) {
|
||||
throw new Error(payload.msg || 'Dragonroll returned an invalid campaign list.');
|
||||
}
|
||||
return payload.campaigns;
|
||||
}
|
||||
|
||||
async function linkCampaign(guildId, campaignId) {
|
||||
const payload = await request(`/discord/bot/guild/${encodeURIComponent(guildId)}/campaign`, {
|
||||
method: 'POST',
|
||||
body: JSON.stringify({ campaignId })
|
||||
});
|
||||
if (!payload.campaign) throw new Error('Dragonroll returned an invalid campaign link.');
|
||||
return payload.campaign;
|
||||
}
|
||||
|
||||
async function unlinkCampaign(guildId) {
|
||||
const current = await getCampaign(guildId);
|
||||
await request(`/discord/bot/guild/${encodeURIComponent(guildId)}/campaign`, { method: 'DELETE' });
|
||||
return current;
|
||||
}
|
||||
|
||||
async function getCampaign(guildId) {
|
||||
const key = String(guildId);
|
||||
const status = await getStatus(key);
|
||||
if (!status.connected) throw new DragonrollNotConnectedError(key);
|
||||
if (!status.campaign) throw new CampaignNotLinkedError(key);
|
||||
|
||||
const campaign = {
|
||||
id: String(status.campaign._id ?? status.campaign.id),
|
||||
name: status.campaign.name || 'Untitled campaign'
|
||||
};
|
||||
if (!campaign.id || campaign.id === 'undefined') throw new Error('Dragonroll returned an invalid campaign.');
|
||||
return campaign;
|
||||
}
|
||||
|
||||
async function listActors(guildId) {
|
||||
const payload = await request(`/discord/bot/guild/${encodeURIComponent(guildId)}/actors`);
|
||||
if (!Array.isArray(payload.actors) || !payload.campaign) {
|
||||
throw new Error(payload.msg || 'Dragonroll returned an invalid actor list.');
|
||||
}
|
||||
const campaign = {
|
||||
id: String(payload.campaign.id ?? payload.campaign._id),
|
||||
name: payload.campaign.name || 'Untitled campaign'
|
||||
};
|
||||
return { campaign, actors: payload.actors };
|
||||
}
|
||||
|
||||
return { startAuthorization, claimLinkNotifications, getStatus, getCampaign, listCampaigns, linkCampaign, unlinkCampaign, listActors };
|
||||
}
|
||||
|
||||
module.exports = { createDragonrollApi, CampaignNotLinkedError, DragonrollNotConnectedError };
|
||||
496
discord-bot/src/index.js
Normal file
496
discord-bot/src/index.js
Normal file
@@ -0,0 +1,496 @@
|
||||
const {
|
||||
ActionRowBuilder,
|
||||
ButtonBuilder,
|
||||
ButtonStyle,
|
||||
Client,
|
||||
EmbedBuilder,
|
||||
Events,
|
||||
GatewayIntentBits,
|
||||
MessageFlags,
|
||||
PermissionFlagsBits,
|
||||
REST,
|
||||
Routes
|
||||
} = require('discord.js');
|
||||
const { getConfig } = require('./config');
|
||||
const {
|
||||
createDragonrollApi,
|
||||
CampaignNotLinkedError,
|
||||
DragonrollNotConnectedError
|
||||
} = require('./dragonroll-api');
|
||||
const commands = require('./commands');
|
||||
|
||||
// Same lifetime as the authorization link on the backend.
|
||||
const LINK_REQUEST_TTL_MS = 10 * 60 * 1000;
|
||||
const LINK_NOTIFICATION_POLL_MS = 4000;
|
||||
|
||||
function abilityModifier(score) {
|
||||
const modifier = Math.floor((Number(score || 10) - 10) / 2);
|
||||
return `${modifier >= 0 ? '+' : ''}${modifier}`;
|
||||
}
|
||||
|
||||
function safeField(value, limit = 600) {
|
||||
const text = String(value || '').trim();
|
||||
if (!text) return '—';
|
||||
return text.length > limit ? `${text.slice(0, limit - 1)}…` : text;
|
||||
}
|
||||
|
||||
// Actor images are stored as a bare filename and served publicly at
|
||||
// `<api>/public/<filename>`, the same way the frontend renders them. An
|
||||
// absolute URL is used as-is if one ever gets saved.
|
||||
function actorImageUrl(image, publicBaseUrl) {
|
||||
const value = String(image || '').trim();
|
||||
if (!value) return null;
|
||||
if (/^https?:\/\//i.test(value)) return value;
|
||||
return `${publicBaseUrl.replace(/\/+$/, '')}/${encodeURIComponent(value)}`;
|
||||
}
|
||||
|
||||
function actorEmbed(actor, campaign, publicImageBaseUrl) {
|
||||
const abilities = actor.abilityScores || {};
|
||||
const abilityFields = [
|
||||
['💪 STR', 'str'], ['🏹 DEX', 'dex'], ['🛡️ CON', 'con'],
|
||||
['📚 INT', 'int'], ['👁️ WIS', 'wis'], ['✨ CHA', 'cha']
|
||||
].map(([name, key]) => {
|
||||
const score = abilities[key] ?? 10;
|
||||
return { name, value: `**${score}** · _${abilityModifier(score)}_`, inline: true };
|
||||
});
|
||||
const className = String(actor.className || actor.class || '').trim();
|
||||
const race = actor.species || actor.race;
|
||||
|
||||
const embed = new EmbedBuilder()
|
||||
.setTitle(safeField(actor.name, 256))
|
||||
.setColor(0x8c6bb1)
|
||||
.setDescription(safeField(actor.description, 1200))
|
||||
.setFooter({ text: safeField(`Campaign: ${campaign.name}`, 600) });
|
||||
|
||||
const imageUrl = actorImageUrl(actor.image, publicImageBaseUrl);
|
||||
if (imageUrl) embed.setImage(imageUrl);
|
||||
|
||||
embed.addFields(
|
||||
{ name: '🧬 Race', value: safeField(race), inline: true },
|
||||
{ name: '⚔️ Class', value: safeField([className, actor.level ? `Level ${actor.level}` : null].filter(Boolean).join(' · ')), inline: true }
|
||||
);
|
||||
if (actor.subclass) embed.addFields({ name: '✨ Subclass', value: safeField(actor.subclass), inline: true });
|
||||
embed.addFields(
|
||||
{ name: '📜 Background', value: safeField(actor.background), inline: true },
|
||||
{ name: '🛡️ Combat', value: `AC ${actor.armorClass ?? 10} · Speed ${actor.speed ?? 30} ft.`, inline: true },
|
||||
{ name: 'Ability scores', value: '\u200b' },
|
||||
...abilityFields
|
||||
);
|
||||
|
||||
if (actor.proficiencies) embed.addFields({ name: 'Proficiencies', value: safeField(actor.proficiencies) });
|
||||
if (actor.traits) embed.addFields({ name: 'Traits', value: safeField(actor.traits) });
|
||||
if (actor.spells) embed.addFields({ name: 'Spells', value: safeField(actor.spells) });
|
||||
|
||||
if (Array.isArray(actor.inventory) && actor.inventory.length) {
|
||||
const inventory = actor.inventory
|
||||
.map((item) => `${item.name || 'Item'} ×${item.quantity || 1}`)
|
||||
.join('\n');
|
||||
embed.addFields({ name: 'Inventory', value: safeField(inventory) });
|
||||
}
|
||||
|
||||
return embed;
|
||||
}
|
||||
|
||||
function findActor(actors, input) {
|
||||
const query = input.trim().toLocaleLowerCase();
|
||||
const exact = actors.find((actor) => actor.name.toLocaleLowerCase() === query);
|
||||
if (exact) return { actor: exact };
|
||||
|
||||
const matches = actors.filter((actor) => actor.name.toLocaleLowerCase().includes(query));
|
||||
if (matches.length === 1) return { actor: matches[0] };
|
||||
return { matches };
|
||||
}
|
||||
|
||||
async function main() {
|
||||
const config = getConfig();
|
||||
if (!config.discordBotSecret) {
|
||||
console.warn('DRAGONROLL_DISCORD_BOT_SECRET is not set; the bot will start, but Dragonroll commands will need it.');
|
||||
}
|
||||
const dragonroll = createDragonrollApi(config);
|
||||
const client = new Client({ intents: [GatewayIntentBits.Guilds] });
|
||||
const rest = new REST({ version: '10' }).setToken(config.discordToken);
|
||||
// Discord downloads character portraits itself, so they need to be absolute
|
||||
// URLs pointing at the backend's public uploads folder.
|
||||
const publicImageBaseUrl = `${config.apiBaseUrl}/public`;
|
||||
|
||||
// Reply, or edit the deferred reply, always without pinging anybody.
|
||||
async function respond(interaction, payload) {
|
||||
const body = { allowedMentions: { parse: [] }, ...payload };
|
||||
if (interaction.deferred || interaction.replied) return interaction.editReply(body);
|
||||
return interaction.reply({ ...body, flags: MessageFlags.Ephemeral });
|
||||
}
|
||||
|
||||
async function explainMissingCampaign(interaction, guildId) {
|
||||
await respond(interaction, {
|
||||
content: safeField([
|
||||
'This Discord server is not linked to a Dragonroll campaign yet.',
|
||||
`A server administrator can connect Dragonroll with \`/dragonroll connect\`, then choose a campaign with \`/dragonroll link\`. Server ID: \`${guildId}\`.`
|
||||
].join('\n'), 1800)
|
||||
});
|
||||
}
|
||||
|
||||
async function explainNotConnected(interaction, guildId) {
|
||||
await respond(interaction, {
|
||||
content: safeField([
|
||||
'No Dragonroll account is connected to this Discord server yet.',
|
||||
`A server administrator can run \`/dragonroll connect\` to sign in. Server ID: \`${guildId}\`.`
|
||||
].join('\n'), 1800)
|
||||
});
|
||||
}
|
||||
|
||||
// The /dragonroll connect interactions waiting for somebody to authorize on Dragonroll.
|
||||
// Their tokens stay usable for 15 minutes, longer than the authorization link lasts.
|
||||
const pendingLinkRequests = new Map();
|
||||
let linkNotificationTimer = null;
|
||||
|
||||
function linkRequestKey(guildId, discordUserId) {
|
||||
return `${guildId}:${discordUserId}`;
|
||||
}
|
||||
|
||||
function rememberLinkRequest(interaction) {
|
||||
for (const [key, pending] of pendingLinkRequests) {
|
||||
if (Date.now() - pending.requestedAt > LINK_REQUEST_TTL_MS) pendingLinkRequests.delete(key);
|
||||
}
|
||||
pendingLinkRequests.set(linkRequestKey(interaction.guildId, interaction.user.id), {
|
||||
interaction,
|
||||
requestedAt: Date.now()
|
||||
});
|
||||
|
||||
if (!linkNotificationTimer) {
|
||||
linkNotificationTimer = setInterval(() => {
|
||||
deliverLinkNotifications().catch((error) => {
|
||||
console.error('Could not confirm a Dragonroll authorization:', error.message);
|
||||
});
|
||||
}, LINK_NOTIFICATION_POLL_MS);
|
||||
linkNotificationTimer.unref();
|
||||
}
|
||||
}
|
||||
|
||||
async function confirmLinkRequest(interaction, notification) {
|
||||
const account = notification.dragonrollUserName ? ` \`${safeField(notification.dragonrollUserName, 40)}\`` : '';
|
||||
await interaction.followUp({
|
||||
content: safeField([
|
||||
`Your Dragonroll account${account} is now connected to **${safeField(notification.guildName, 100)}**.`,
|
||||
'Run `/dragonroll link` to choose which campaign this server can read.'
|
||||
].join('\n'), 1800),
|
||||
flags: MessageFlags.Ephemeral,
|
||||
allowedMentions: { parse: [] }
|
||||
});
|
||||
}
|
||||
|
||||
async function deliverLinkNotifications() {
|
||||
if (!config.discordBotSecret || !pendingLinkRequests.size) return;
|
||||
|
||||
const notifications = await dragonroll.claimLinkNotifications();
|
||||
for (const notification of notifications) {
|
||||
const key = linkRequestKey(notification.guildId, notification.discordUserId);
|
||||
const pending = pendingLinkRequests.get(key);
|
||||
pendingLinkRequests.delete(key);
|
||||
// Without the interaction that asked for this authorization there is nothing to
|
||||
// answer: the bot was restarted, and Dragonroll's own web page already told the
|
||||
// person what to do next.
|
||||
if (!pending) continue;
|
||||
|
||||
try {
|
||||
await confirmLinkRequest(pending.interaction, notification);
|
||||
} catch (error) {
|
||||
console.error(`Could not confirm the Dragonroll authorization for Discord user ${notification.discordUserId}:`, error.message);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
// Commands live on every server the bot joins: guild-scoped registration is
|
||||
// instant, unlike the global registration done by deploy-commands.
|
||||
async function registerCommandsIn(guildId) {
|
||||
try {
|
||||
await rest.put(Routes.applicationGuildCommands(config.discordClientId, guildId), {
|
||||
body: commands.map((command) => command.toJSON())
|
||||
});
|
||||
} catch (error) {
|
||||
console.error(`Could not register commands in Discord server ${guildId}:`, error.message);
|
||||
}
|
||||
}
|
||||
|
||||
async function showStatus(interaction, guildId) {
|
||||
const embed = new EmbedBuilder()
|
||||
.setTitle('Dragonroll link')
|
||||
.setColor(0x8c6bb1)
|
||||
.addFields({ name: 'This server', value: `${interaction.guild?.name || 'Unknown'} · \`${guildId}\`` });
|
||||
|
||||
let status;
|
||||
try {
|
||||
status = await dragonroll.getStatus(guildId);
|
||||
} catch (error) {
|
||||
console.error('Could not read the Dragonroll connection for this server:', error.message);
|
||||
embed.addFields({ name: 'Dragonroll account', value: 'Dragonroll could not be reached right now.' });
|
||||
await respond(interaction, { embeds: [embed] });
|
||||
return;
|
||||
}
|
||||
|
||||
embed.addFields(
|
||||
{ name: 'Dragonroll account', value: status.connected ? 'Connected' : 'Not connected.' },
|
||||
{ name: 'Campaign', value: status.campaign
|
||||
? `${status.campaign.name} · \`${status.campaign._id ?? status.campaign.id}\``
|
||||
: 'Not linked yet.' }
|
||||
);
|
||||
|
||||
if (!status.connected) {
|
||||
embed.setDescription('A server administrator can run /dragonroll connect to connect a Dragonroll account.');
|
||||
} else if (!status.campaign) {
|
||||
embed.setDescription('A server administrator can run /dragonroll link to choose a campaign.');
|
||||
}
|
||||
|
||||
await respond(interaction, { embeds: [embed] });
|
||||
}
|
||||
|
||||
client.once(Events.ClientReady, (readyClient) => {
|
||||
console.log(`Dragonroll character bot is online as ${readyClient.user.tag}, in ${readyClient.guilds.cache.size} servers.`);
|
||||
// Guild commands registered when the bot joined shadow global ones and
|
||||
// keep their old definition forever, so refresh them on every start to
|
||||
// propagate command changes (new options, autocomplete) to all servers.
|
||||
for (const guild of readyClient.guilds.cache.values()) registerCommandsIn(guild.id);
|
||||
});
|
||||
|
||||
client.on(Events.GuildCreate, (guild) => {
|
||||
console.log(`Added to Discord server ${guild.id} (${guild.name}).`);
|
||||
registerCommandsIn(guild.id);
|
||||
});
|
||||
|
||||
client.on(Events.InteractionCreate, (interaction) => {
|
||||
// One broken command should not take the bot down for every other server.
|
||||
handleInteraction(interaction).catch((error) => {
|
||||
console.error(`Could not answer ${interaction.commandName}:`, error.message);
|
||||
});
|
||||
});
|
||||
|
||||
async function respondCampaignChoices(interaction, guildId) {
|
||||
if (!interaction.memberPermissions?.has(PermissionFlagsBits.Administrator)) {
|
||||
await interaction.respond([]);
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
const query = interaction.options.getFocused().toLocaleLowerCase();
|
||||
const campaigns = await dragonroll.listCampaigns(guildId);
|
||||
const choices = campaigns
|
||||
.filter((campaign) => !campaign.discordGuildId || String(campaign.discordGuildId) === String(guildId))
|
||||
.filter((campaign) => String(campaign.name || '').toLocaleLowerCase().includes(query))
|
||||
.slice(0, 25)
|
||||
.map((campaign) => ({
|
||||
name: safeField(campaign.name, 100),
|
||||
value: String(campaign._id ?? campaign.id)
|
||||
}))
|
||||
.filter((choice) => choice.value && choice.value !== 'undefined');
|
||||
await interaction.respond(choices);
|
||||
} catch (error) {
|
||||
if (error.status !== 401 && error.code !== 'discord.errors.not-connected') {
|
||||
console.error('Could not list campaigns for Discord configuration:', error.message);
|
||||
}
|
||||
await interaction.respond([]);
|
||||
}
|
||||
}
|
||||
|
||||
// Character names for /character. Anyone who may read the campaign may use
|
||||
// the suggestions; when nothing is linked we answer with an empty list, as
|
||||
// autocomplete replies cannot carry an error message.
|
||||
async function respondActorChoices(interaction, guildId) {
|
||||
try {
|
||||
const query = interaction.options.getFocused().trim().toLocaleLowerCase();
|
||||
const { actors } = await dragonroll.listActors(guildId);
|
||||
const seen = new Set();
|
||||
const choices = actors
|
||||
.filter((actor) => String(actor.name || '').trim() && actor.name.length <= 100)
|
||||
.filter((actor) => actor.name.toLocaleLowerCase().includes(query))
|
||||
.map((actor) => ({
|
||||
name: safeField(actor.name, 100),
|
||||
value: actor.name
|
||||
}))
|
||||
.filter((choice) => !seen.has(choice.value) && seen.add(choice.value))
|
||||
.slice(0, 25);
|
||||
await interaction.respond(choices);
|
||||
} catch (error) {
|
||||
if (!(error instanceof DragonrollNotConnectedError)
|
||||
&& !(error instanceof CampaignNotLinkedError)
|
||||
&& error.status !== 401
|
||||
&& error.code !== 'discord.errors.not-connected') {
|
||||
console.error('Could not list characters for Discord autocomplete:', error.message);
|
||||
}
|
||||
await interaction.respond([]);
|
||||
}
|
||||
}
|
||||
|
||||
async function handleInteraction(interaction) {
|
||||
if (interaction.isAutocomplete()) {
|
||||
const guildId = interaction.guildId;
|
||||
if (!guildId) {
|
||||
await interaction.respond([]);
|
||||
return;
|
||||
}
|
||||
|
||||
if (interaction.commandName === 'character') {
|
||||
await respondActorChoices(interaction, guildId);
|
||||
return;
|
||||
}
|
||||
if (interaction.commandName === 'dragonroll' && interaction.options.getSubcommand() === 'link') {
|
||||
await respondCampaignChoices(interaction, guildId);
|
||||
return;
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (!interaction.isChatInputCommand()) return;
|
||||
if (!['characters', 'character', 'dragonroll'].includes(interaction.commandName)) return;
|
||||
|
||||
const guildId = interaction.guildId;
|
||||
if (!guildId) {
|
||||
await respond(interaction, { content: 'These commands only work inside a Discord server.' });
|
||||
return;
|
||||
}
|
||||
|
||||
if (interaction.commandName === 'dragonroll') {
|
||||
const subcommand = interaction.options.getSubcommand();
|
||||
if (['connect', 'link', 'unlink'].includes(subcommand)) {
|
||||
if (!interaction.memberPermissions?.has(PermissionFlagsBits.Administrator)) {
|
||||
await respond(interaction, { content: 'Only Discord server administrators can connect Dragonroll or change this campaign link.' });
|
||||
return;
|
||||
}
|
||||
|
||||
await interaction.deferReply({ flags: MessageFlags.Ephemeral });
|
||||
try {
|
||||
if (subcommand === 'connect') {
|
||||
const request = await dragonroll.startAuthorization(
|
||||
guildId,
|
||||
interaction.guild?.name || 'Discord server',
|
||||
interaction.user.id,
|
||||
interaction.user.username
|
||||
);
|
||||
const authorizationUrl = `${config.frontendBaseUrl}/discord/authorize#code=${encodeURIComponent(request.code)}`;
|
||||
const button = new ButtonBuilder()
|
||||
.setLabel('Sign in to Dragonroll')
|
||||
.setStyle(ButtonStyle.Link)
|
||||
.setURL(authorizationUrl);
|
||||
await respond(interaction, {
|
||||
content: 'Open Dragonroll to sign in and authorize this server. The link expires in 10 minutes.',
|
||||
components: [new ActionRowBuilder().addComponents(button)]
|
||||
});
|
||||
rememberLinkRequest(interaction);
|
||||
return;
|
||||
} else if (subcommand === 'link') {
|
||||
const campaignId = interaction.options.getString('campaign', true);
|
||||
const campaign = await dragonroll.linkCampaign(guildId, campaignId);
|
||||
await respond(interaction, {
|
||||
content: `This server is now linked to **${safeField(campaign.name, 180)}**.`,
|
||||
allowedMentions: { parse: [] }
|
||||
});
|
||||
} else {
|
||||
try {
|
||||
const campaign = await dragonroll.unlinkCampaign(guildId);
|
||||
await respond(interaction, {
|
||||
content: `Removed this server’s link to **${safeField(campaign.name, 180)}**.`,
|
||||
allowedMentions: { parse: [] }
|
||||
});
|
||||
} catch (error) {
|
||||
if (error instanceof CampaignNotLinkedError) {
|
||||
await respond(interaction, { content: 'This server does not have a linked campaign.' });
|
||||
return;
|
||||
}
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
} catch (error) {
|
||||
console.error(`Could not ${subcommand} the campaign for Discord server ${guildId}:`, error.message);
|
||||
let message = `I could not ${subcommand} this campaign link. Please try again.`;
|
||||
if (error instanceof DragonrollNotConnectedError || error.code === 'discord.errors.not-connected') {
|
||||
message = 'Connect a Dragonroll account first with /dragonroll connect.';
|
||||
} else if (error.status === 401 || error.message.includes('DRAGONROLL_DISCORD_BOT_SECRET')) {
|
||||
message = 'The bot API secret is missing or does not match the backend. Contact the bot operator.';
|
||||
} else if (error.code === 'campaigns.errors.discord-guild-in-use' || error.code === 'discord.errors.campaign-already-linked') {
|
||||
message = 'That campaign is already linked to another Discord server.';
|
||||
}
|
||||
await respond(interaction, { content: message });
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
await interaction.deferReply({ flags: MessageFlags.Ephemeral });
|
||||
await showStatus(interaction, guildId);
|
||||
return;
|
||||
}
|
||||
|
||||
const showCharacterPublicly = interaction.commandName === 'character'
|
||||
&& interaction.options.getBoolean('public');
|
||||
await interaction.deferReply(showCharacterPublicly ? {} : { flags: MessageFlags.Ephemeral });
|
||||
|
||||
try {
|
||||
const { campaign, actors } = await dragonroll.listActors(guildId);
|
||||
|
||||
if (interaction.commandName === 'characters') {
|
||||
const type = interaction.options.getString('type') || 'all';
|
||||
const filtered = type === 'all' ? actors : actors.filter((actor) => actor.type === type);
|
||||
if (!filtered.length) {
|
||||
await interaction.editReply({
|
||||
content: type === 'all'
|
||||
? `There are no characters in **${campaign.name}** yet.`
|
||||
: `There are no ${type === 'npc' ? 'NPCs' : `${type}s`} in **${campaign.name}**.`,
|
||||
allowedMentions: { parse: [] }
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
const shown = filtered.slice(0, 40);
|
||||
const lines = shown.map((actor) => {
|
||||
const details = [actor.species, actor.className, actor.level ? `Lv. ${actor.level}` : null]
|
||||
.filter(Boolean)
|
||||
.join(' · ');
|
||||
return `• **${actor.name}**${details ? ` — ${details}` : ''}`;
|
||||
});
|
||||
const embed = new EmbedBuilder()
|
||||
.setTitle(`Characters of ${campaign.name}`)
|
||||
.setColor(0x8c6bb1)
|
||||
.setDescription(safeField(lines.join('\n'), 4000))
|
||||
.setFooter({ text: filtered.length > shown.length
|
||||
? `Showing ${shown.length} of ${filtered.length}; use /character to look up a specific sheet.`
|
||||
: `${filtered.length} ${filtered.length === 1 ? 'entry' : 'entries'} · Use /character to inspect a sheet.` });
|
||||
await interaction.editReply({ embeds: [embed], allowedMentions: { parse: [] } });
|
||||
return;
|
||||
}
|
||||
|
||||
const name = interaction.options.getString('name', true);
|
||||
const result = findActor(actors, name);
|
||||
if (result.actor) {
|
||||
await interaction.editReply({ embeds: [actorEmbed(result.actor, campaign, publicImageBaseUrl)], allowedMentions: { parse: [] } });
|
||||
} else if (result.matches?.length > 1) {
|
||||
await interaction.editReply({
|
||||
content: safeField(`Several characters match **${name}**: ${result.matches.slice(0, 15).map((actor) => actor.name).join(', ')}. Try a more specific name.`, 1800),
|
||||
allowedMentions: { parse: [] }
|
||||
});
|
||||
} else {
|
||||
await interaction.editReply({
|
||||
content: `I couldn't find a character named **${name}**. Try \`/characters\` to see the campaign roster.`,
|
||||
allowedMentions: { parse: [] }
|
||||
});
|
||||
}
|
||||
} catch (error) {
|
||||
if (error instanceof DragonrollNotConnectedError) {
|
||||
await explainNotConnected(interaction, guildId);
|
||||
return;
|
||||
}
|
||||
if (error instanceof CampaignNotLinkedError) {
|
||||
await explainMissingCampaign(interaction, guildId);
|
||||
return;
|
||||
}
|
||||
console.error('Character lookup failed:', error.message);
|
||||
await interaction.editReply({
|
||||
content: 'I could not reach the Dragonroll campaign right now. Please try again in a moment.',
|
||||
allowedMentions: { parse: [] }
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
await client.login(config.discordToken);
|
||||
}
|
||||
|
||||
main().catch((error) => {
|
||||
console.error('Could not start Dragonroll Discord bot:', error.message);
|
||||
process.exitCode = 1;
|
||||
});
|
||||
@@ -18,4 +18,26 @@ services:
|
||||
|
||||
backend:
|
||||
image: git.aranroig.com/syndria98/dragonroll-backend:latest
|
||||
restart: always
|
||||
environment:
|
||||
# Shared service secret the Discord bot authenticates with
|
||||
# (header x-dragonroll-discord-bot-secret). Must match the bot's value.
|
||||
DRAGONROLL_DISCORD_BOT_SECRET: ${DRAGONROLL_DISCORD_BOT_SECRET}
|
||||
# Public address of the frontend: the /discord/authorize link people
|
||||
# open from Discord is built from this.
|
||||
DRAGONROLL_FRONTEND_URL: ${DRAGONROLL_FRONTEND_URL:-https://dragonroll.aranroig.com}
|
||||
restart: always
|
||||
|
||||
discord-bot:
|
||||
image: git.aranroig.com/syndria98/dragonroll-discord-bot:latest
|
||||
environment:
|
||||
DISCORD_TOKEN: ${DISCORD_TOKEN}
|
||||
DISCORD_CLIENT_ID: ${DISCORD_CLIENT_ID}
|
||||
DRAGONROLL_DISCORD_BOT_SECRET: ${DRAGONROLL_DISCORD_BOT_SECRET}
|
||||
# Must stay the public https address (through nginx) and not
|
||||
# http://backend:5000/api: character portraits are rendered in Discord
|
||||
# from <DRAGONROLL_API_URL>/public/<filename>.
|
||||
DRAGONROLL_API_URL: ${DRAGONROLL_API_URL:-https://dragonroll.aranroig.com/api}
|
||||
DRAGONROLL_FRONTEND_URL: ${DRAGONROLL_FRONTEND_URL:-https://dragonroll.aranroig.com}
|
||||
depends_on:
|
||||
- backend
|
||||
restart: always
|
||||
|
||||
111
dragonroll-foundry/README.md
Normal file
111
dragonroll-foundry/README.md
Normal file
@@ -0,0 +1,111 @@
|
||||
# Dragonroll Foundry integration
|
||||
|
||||
Foundry modules run in the game client, so the module cannot bind an HTTP port on the Foundry host.
|
||||
This integration uses a small companion bridge process on that host:
|
||||
|
||||
1. A linked GM client syncs character Actors directly with the Dragonroll campaign.
|
||||
2. The module publishes the active world's actor and item snapshot to the optional bridge.
|
||||
3. The bridge serves authenticated HTTP read endpoints that Dragonroll proxies under `/api/foundry/*`.
|
||||
|
||||
The Foundry module uses the client-side package API and hooks documented by Foundry: [module development](https://foundryvtt.com/article/module-development/).
|
||||
|
||||
## 1. Install the Foundry module
|
||||
|
||||
Copy the contents of this directory into
|
||||
`{Foundry user data}/Data/modules/dragonroll-foundry/`. Restart Foundry, then enable **Dragonroll
|
||||
Foundry API** in the world's module settings.
|
||||
|
||||
After linking a campaign, the module stores a client-only token for character synchronization that
|
||||
persists across Foundry restarts. If the optional bridge is configured, Dragonroll also sends its
|
||||
connection settings to the module.
|
||||
Existing clients continue using their saved bridge URL and publish token automatically. The module
|
||||
publishes at world startup and after actor or item changes, and sends a lightweight heartbeat once a
|
||||
minute. Its local JavaScript API remains available at
|
||||
`game.modules.get("dragonroll-foundry").api`.
|
||||
|
||||
## Link a Foundry world to a Dragonroll campaign
|
||||
|
||||
Open the campaign's **Settings → Integrations** tab in Dragonroll and create a pairing code. In the
|
||||
Foundry module settings, set **Dragonroll Endpoint** if you use a different Dragonroll server; it
|
||||
defaults to `https://dragonroll.aranroig.com` and the module adds `/api` automatically. Paste the
|
||||
code into **Dragonroll Campaign Pairing Code** and save. Codes expire after ten minutes and can only
|
||||
be used once.
|
||||
|
||||
Both sides of the pairing survive restarts: Dragonroll keeps a pending code on the campaign so the
|
||||
settings screen re-displays it after a page reload, the window being closed, or a server restart
|
||||
(until it expires or is used), and the Foundry module keeps a code it could not redeem yet — for
|
||||
example one pasted while Dragonroll was restarting — retrying it at world startup and once a minute
|
||||
until the world finishes linking.
|
||||
|
||||
For a local backend, use `http://localhost:5000`; the module omits `/api` and the backend accepts
|
||||
the local pairing route at its root. Character synchronization works without the optional snapshot
|
||||
bridge. Configure that bridge only if you also need the read-only world snapshot API described below.
|
||||
|
||||
The campaign settings show the linked world's title and system. A Foundry world can be linked to
|
||||
only one campaign at a time. The pairing endpoint accepts cross-origin requests from the Foundry
|
||||
client and uses the one-time code instead of a Dragonroll login token.
|
||||
|
||||
## Character synchronization
|
||||
|
||||
After linking, the GM client imports Foundry character, NPC, and creature Actors into the campaign.
|
||||
Creates, updates, and deletes sync in either direction; Dragonroll changes are applied in Foundry
|
||||
within about five seconds. The module currently creates Dragonroll characters in D&D 5e Foundry
|
||||
worlds. After updating an already-linked world to a version with character sync, create a fresh
|
||||
pairing code and enter it in Foundry once to issue the sync token.
|
||||
|
||||
## 2. Run the bridge on the Foundry host
|
||||
|
||||
The bridge uses only Node.js built-in modules and requires Node 18 or newer. Set separate random
|
||||
tokens for backend reads and Foundry snapshot publishing, then start it:
|
||||
|
||||
```sh
|
||||
export DRAGONROLL_FOUNDRY_READ_TOKEN='replace-with-a-long-random-read-token'
|
||||
export DRAGONROLL_FOUNDRY_PUSH_TOKEN='replace-with-a-different-long-random-publish-token'
|
||||
export DRAGONROLL_FOUNDRY_ALLOWED_ORIGINS='https://vtt.example.com'
|
||||
export DRAGONROLL_FOUNDRY_HOST='0.0.0.0'
|
||||
export DRAGONROLL_FOUNDRY_PORT='8787'
|
||||
npm start --prefix foundry/bridge
|
||||
```
|
||||
|
||||
Put the bridge behind HTTPS when it is reachable outside a trusted private network. The Foundry
|
||||
browser origin must be listed in `DRAGONROLL_FOUNDRY_ALLOWED_ORIGINS`; separate multiple origins with
|
||||
commas. The bridge binds to `0.0.0.0` by default so Dragonroll can reach it on another host. Restrict
|
||||
network access to the bridge port to Dragonroll and Foundry clients. If the reverse proxy serves the
|
||||
bridge under a path prefix, configure it to strip that prefix before forwarding requests to port 8787.
|
||||
|
||||
## 3. Configure Dragonroll's backend
|
||||
|
||||
Set these variables in the backend environment. `FOUNDRY_API_URL` is the bridge base URL reachable
|
||||
by the backend, without an API path. `FOUNDRY_API_CLIENT_URL` is optional and overrides the bridge
|
||||
URL sent to Foundry clients when they cannot reach the backend's bridge URL (for example, when the
|
||||
backend uses a private network address). `FOUNDRY_API_PUSH_TOKEN` must match the bridge's
|
||||
`DRAGONROLL_FOUNDRY_PUSH_TOKEN`:
|
||||
|
||||
```sh
|
||||
FOUNDRY_API_URL='https://vtt.example.com/dragonroll-bridge/'
|
||||
FOUNDRY_API_CLIENT_URL='https://vtt.example.com/dragonroll-bridge/'
|
||||
FOUNDRY_API_TOKEN='replace-with-the-bridge-read-token'
|
||||
FOUNDRY_API_PUSH_TOKEN='replace-with-the-bridge-publish-token'
|
||||
```
|
||||
|
||||
The backend exposes these JWT-protected routes when the optional snapshot bridge is configured:
|
||||
|
||||
| Dragonroll route | Data |
|
||||
|---|---|
|
||||
| `GET /api/foundry/world` | Active Foundry world metadata |
|
||||
| `GET /api/foundry/actors` | All world actors |
|
||||
| `GET /api/foundry/characters` | Actors with type `character` |
|
||||
| `GET /api/foundry/actors/:id` | One actor |
|
||||
| `GET /api/foundry/actors/:id/items` | Items embedded in an actor |
|
||||
| `GET /api/foundry/items` | World-level items |
|
||||
| `GET /api/foundry/items/:id` | One world-level item |
|
||||
|
||||
The bridge exposes the matching routes under `/api/*`, plus `GET /health`. Data routes require
|
||||
`Authorization: Bearer <read-token>`. Responses contain `{ status: "ok", data, world, syncedAt,
|
||||
ageSeconds, stale }`. The snapshot stays in memory; `stale` becomes true when the bridge has not
|
||||
received a GM heartbeat for more than two minutes. The bridge returns `503 foundry.not-ready` until a
|
||||
configured GM client has published its first snapshot.
|
||||
|
||||
World-level items come from Foundry's `game.items`; actor inventories come from each actor's embedded
|
||||
items collection. The API returns plain document data snapshots. This is a read-only integration: it
|
||||
does not create or update Foundry documents, and it does not persist the bridge cache across restarts.
|
||||
12
dragonroll-foundry/bridge/package.json
Normal file
12
dragonroll-foundry/bridge/package.json
Normal file
@@ -0,0 +1,12 @@
|
||||
{
|
||||
"name": "dragonroll-foundry-bridge",
|
||||
"private": true,
|
||||
"version": "0.1.0",
|
||||
"description": "Authenticated HTTP bridge between a Foundry client module and Dragonroll.",
|
||||
"scripts": {
|
||||
"start": "node server.js"
|
||||
},
|
||||
"engines": {
|
||||
"node": ">=18"
|
||||
}
|
||||
}
|
||||
233
dragonroll-foundry/bridge/server.js
Normal file
233
dragonroll-foundry/bridge/server.js
Normal file
@@ -0,0 +1,233 @@
|
||||
const http = require("node:http");
|
||||
const { timingSafeEqual } = require("node:crypto");
|
||||
|
||||
const host = process.env.DRAGONROLL_FOUNDRY_HOST || "0.0.0.0";
|
||||
const port = Number(process.env.DRAGONROLL_FOUNDRY_PORT || 8787);
|
||||
const readToken = process.env.DRAGONROLL_FOUNDRY_READ_TOKEN;
|
||||
const pushToken = process.env.DRAGONROLL_FOUNDRY_PUSH_TOKEN;
|
||||
const allowedOrigins = new Set(
|
||||
(process.env.DRAGONROLL_FOUNDRY_ALLOWED_ORIGINS || "http://localhost:30000")
|
||||
.split(",")
|
||||
.map((origin) => origin.trim())
|
||||
.filter(Boolean),
|
||||
);
|
||||
const maxBodySize = 50 * 1024 * 1024;
|
||||
|
||||
if (!readToken || !pushToken) {
|
||||
throw new Error("Set DRAGONROLL_FOUNDRY_READ_TOKEN and DRAGONROLL_FOUNDRY_PUSH_TOKEN before starting the bridge.");
|
||||
}
|
||||
|
||||
let snapshot = null;
|
||||
|
||||
function sendJson(response, status, body) {
|
||||
response.writeHead(status, { "Content-Type": "application/json; charset=utf-8" });
|
||||
response.end(JSON.stringify(body));
|
||||
}
|
||||
|
||||
function setCorsHeaders(request, response) {
|
||||
const origin = request.headers.origin;
|
||||
if (!origin) return true;
|
||||
if (!allowedOrigins.has(origin)) return false;
|
||||
|
||||
response.setHeader("Access-Control-Allow-Origin", origin);
|
||||
response.setHeader("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
|
||||
response.setHeader("Access-Control-Allow-Headers", "Authorization, Content-Type");
|
||||
response.setHeader("Vary", "Origin");
|
||||
return true;
|
||||
}
|
||||
|
||||
function hasBearerToken(request, expectedToken) {
|
||||
const match = /^Bearer\s+(.+)$/i.exec(request.headers.authorization || "");
|
||||
if (!match) return false;
|
||||
|
||||
const actual = Buffer.from(match[1]);
|
||||
const expected = Buffer.from(expectedToken);
|
||||
return actual.length === expected.length && timingSafeEqual(actual, expected);
|
||||
}
|
||||
|
||||
function readJson(request) {
|
||||
return new Promise((resolve, reject) => {
|
||||
const chunks = [];
|
||||
let bytes = 0;
|
||||
let tooLarge = false;
|
||||
|
||||
request.on("data", (chunk) => {
|
||||
bytes += chunk.length;
|
||||
if (bytes > maxBodySize) {
|
||||
tooLarge = true;
|
||||
chunks.length = 0;
|
||||
return;
|
||||
}
|
||||
if (!tooLarge) chunks.push(chunk);
|
||||
});
|
||||
|
||||
request.on("end", () => {
|
||||
if (tooLarge) {
|
||||
reject(Object.assign(new Error("Snapshot is too large."), { status: 413 }));
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
resolve(JSON.parse(Buffer.concat(chunks).toString("utf8")));
|
||||
} catch {
|
||||
reject(Object.assign(new Error("Request body must be valid JSON."), { status: 400 }));
|
||||
}
|
||||
});
|
||||
|
||||
request.on("error", reject);
|
||||
});
|
||||
}
|
||||
|
||||
function currentSnapshot(response) {
|
||||
if (!snapshot) {
|
||||
sendJson(response, 503, { status: "error", msg: "foundry.not-ready" });
|
||||
return null;
|
||||
}
|
||||
return snapshot;
|
||||
}
|
||||
|
||||
function sendData(response, data, current) {
|
||||
const ageMs = Date.now() - current.syncedAtMs;
|
||||
sendJson(response, 200, {
|
||||
status: "ok",
|
||||
data,
|
||||
world: current.world,
|
||||
syncedAt: new Date(current.syncedAtMs).toISOString(),
|
||||
ageSeconds: Math.floor(ageMs / 1000),
|
||||
stale: ageMs > 120000,
|
||||
});
|
||||
}
|
||||
|
||||
function decodePathSegment(segment) {
|
||||
try {
|
||||
return decodeURIComponent(segment);
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
const server = http.createServer(async (request, response) => {
|
||||
if (!setCorsHeaders(request, response)) {
|
||||
sendJson(response, 403, { status: "error", msg: "foundry.origin-not-allowed" });
|
||||
return;
|
||||
}
|
||||
|
||||
if (request.method === "OPTIONS") {
|
||||
response.writeHead(204);
|
||||
response.end();
|
||||
return;
|
||||
}
|
||||
|
||||
const pathname = new URL(request.url, "http://localhost").pathname;
|
||||
|
||||
if (request.method === "GET" && pathname === "/health") {
|
||||
sendJson(response, 200, {
|
||||
status: "ok",
|
||||
ready: Boolean(snapshot),
|
||||
syncedAt: snapshot ? new Date(snapshot.syncedAtMs).toISOString() : null,
|
||||
});
|
||||
return;
|
||||
}
|
||||
|
||||
if (request.method === "POST" && pathname === "/internal/snapshot") {
|
||||
if (!hasBearerToken(request, pushToken)) {
|
||||
sendJson(response, 401, { status: "error", msg: "unauthorized" });
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
const body = await readJson(request);
|
||||
if (!body.world?.id || !Array.isArray(body.actors) || !Array.isArray(body.items)
|
||||
|| !body.actorItems || typeof body.actorItems !== "object" || Array.isArray(body.actorItems)) {
|
||||
sendJson(response, 400, { status: "error", msg: "foundry.invalid-snapshot" });
|
||||
return;
|
||||
}
|
||||
|
||||
snapshot = {
|
||||
world: body.world,
|
||||
actors: body.actors,
|
||||
items: body.items,
|
||||
actorItems: body.actorItems,
|
||||
syncedAtMs: Date.now(),
|
||||
};
|
||||
sendJson(response, 200, { status: "ok", syncedAt: new Date(snapshot.syncedAtMs).toISOString() });
|
||||
} catch (error) {
|
||||
sendJson(response, error.status || 400, { status: "error", msg: "foundry.invalid-snapshot" });
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (request.method === "POST" && pathname === "/internal/heartbeat") {
|
||||
if (!hasBearerToken(request, pushToken)) {
|
||||
sendJson(response, 401, { status: "error", msg: "unauthorized" });
|
||||
return;
|
||||
}
|
||||
|
||||
try {
|
||||
const body = await readJson(request);
|
||||
if (!snapshot || !body.worldId || snapshot.world.id !== body.worldId) {
|
||||
sendJson(response, 409, { status: "error", msg: "foundry.not-ready" });
|
||||
return;
|
||||
}
|
||||
|
||||
snapshot.syncedAtMs = Date.now();
|
||||
sendJson(response, 200, { status: "ok", syncedAt: new Date(snapshot.syncedAtMs).toISOString() });
|
||||
} catch (error) {
|
||||
sendJson(response, error.status || 400, { status: "error", msg: "foundry.invalid-heartbeat" });
|
||||
}
|
||||
return;
|
||||
}
|
||||
|
||||
if (request.method !== "GET" || !pathname.startsWith("/api/")) {
|
||||
sendJson(response, 404, { status: "error", msg: "errors.notfound" });
|
||||
return;
|
||||
}
|
||||
|
||||
if (!hasBearerToken(request, readToken)) {
|
||||
sendJson(response, 401, { status: "error", msg: "unauthorized" });
|
||||
return;
|
||||
}
|
||||
|
||||
const current = currentSnapshot(response);
|
||||
if (!current) return;
|
||||
|
||||
if (pathname === "/api/world") return sendData(response, current.world, current);
|
||||
if (pathname === "/api/actors") return sendData(response, current.actors, current);
|
||||
if (pathname === "/api/characters") {
|
||||
return sendData(response, current.actors.filter((actor) => actor.type === "character"), current);
|
||||
}
|
||||
if (pathname === "/api/items") return sendData(response, current.items, current);
|
||||
|
||||
const actorItemsMatch = /^\/api\/actors\/([^/]+)\/items$/.exec(pathname);
|
||||
if (actorItemsMatch) {
|
||||
const actorId = decodePathSegment(actorItemsMatch[1]);
|
||||
if (!actorId) return sendJson(response, 400, { status: "error", msg: "errors.missing-data" });
|
||||
const actor = current.actors.find((entry) => entry._id === actorId || entry.id === actorId);
|
||||
if (!actor) return sendJson(response, 404, { status: "error", msg: "errors.notfound" });
|
||||
return sendData(response, current.actorItems[actorId] || [], current);
|
||||
}
|
||||
|
||||
const actorMatch = /^\/api\/actors\/([^/]+)$/.exec(pathname);
|
||||
if (actorMatch) {
|
||||
const actorId = decodePathSegment(actorMatch[1]);
|
||||
if (!actorId) return sendJson(response, 400, { status: "error", msg: "errors.missing-data" });
|
||||
const actor = current.actors.find((entry) => entry._id === actorId || entry.id === actorId);
|
||||
if (!actor) return sendJson(response, 404, { status: "error", msg: "errors.notfound" });
|
||||
return sendData(response, actor, current);
|
||||
}
|
||||
|
||||
const itemMatch = /^\/api\/items\/([^/]+)$/.exec(pathname);
|
||||
if (itemMatch) {
|
||||
const itemId = decodePathSegment(itemMatch[1]);
|
||||
if (!itemId) return sendJson(response, 400, { status: "error", msg: "errors.missing-data" });
|
||||
const item = current.items.find((entry) => entry._id === itemId || entry.id === itemId);
|
||||
if (!item) return sendJson(response, 404, { status: "error", msg: "errors.notfound" });
|
||||
return sendData(response, item, current);
|
||||
}
|
||||
|
||||
sendJson(response, 404, { status: "error", msg: "errors.notfound" });
|
||||
});
|
||||
|
||||
server.listen(port, host, () => {
|
||||
console.info(`Dragonroll Foundry bridge listening on ${host}:${port}`);
|
||||
});
|
||||
14
dragonroll-foundry/module.json
Normal file
14
dragonroll-foundry/module.json
Normal file
@@ -0,0 +1,14 @@
|
||||
{
|
||||
"id": "dragonroll-foundry",
|
||||
"title": "Dragonroll Foundry API",
|
||||
"description": "Links a Foundry world to a Dragonroll campaign and exposes a client-side API for world data.",
|
||||
"version": "0.3.0",
|
||||
"library": true,
|
||||
"compatibility": {
|
||||
"minimum": "12",
|
||||
"verified": "14"
|
||||
},
|
||||
"esmodules": [
|
||||
"scripts/api.js"
|
||||
]
|
||||
}
|
||||
731
dragonroll-foundry/scripts/api.js
Normal file
731
dragonroll-foundry/scripts/api.js
Normal file
@@ -0,0 +1,731 @@
|
||||
const MODULE_ID = "dragonroll-foundry";
|
||||
const SETTING_BRIDGE_URL = "bridgeUrl";
|
||||
const SETTING_PUSH_TOKEN = "pushToken";
|
||||
const SETTING_BRIDGE_CONFIG = "bridgeConfig";
|
||||
const SETTING_DRAGONROLL_API_URL = "dragonrollApiUrl";
|
||||
const SETTING_LINK_CODE = "linkCode";
|
||||
const SETTING_SYNC_TOKEN = "syncToken";
|
||||
let syncTimeout;
|
||||
let syncInProgress = false;
|
||||
let syncRequested = false;
|
||||
let handlingLinkCode = false;
|
||||
let updatingLinkCodeSetting = false;
|
||||
let linkRetriesDisabled = false;
|
||||
const FATAL_LINK_ERRORS = new Set([
|
||||
"foundry.errors.link-expired",
|
||||
"foundry.errors.world-already-linked",
|
||||
]);
|
||||
let actorSyncTimeout;
|
||||
let characterSyncRunning = false;
|
||||
let actorSyncErrorLogged = false;
|
||||
const syncingActorIds = new Set();
|
||||
const queuedActorChanges = new Map();
|
||||
|
||||
function getCollectionContents(collection, collectionName) {
|
||||
if (!collection) {
|
||||
throw new Error(`Foundry ${collectionName} collection is not available yet.`);
|
||||
}
|
||||
|
||||
return collection.contents;
|
||||
}
|
||||
|
||||
function toPlainData(document) {
|
||||
return document?.toObject() ?? null;
|
||||
}
|
||||
|
||||
const api = Object.freeze({
|
||||
/** Return metadata for the currently loaded world. */
|
||||
getWorld() {
|
||||
if (!game.world) return null;
|
||||
|
||||
return {
|
||||
id: game.world.id,
|
||||
title: game.world.title,
|
||||
system: game.system.id,
|
||||
url: window.location.origin,
|
||||
};
|
||||
},
|
||||
|
||||
/** Return plain data snapshots for all Actor documents in the active world. */
|
||||
getActors() {
|
||||
return getCollectionContents(game.actors, "actor").map(toPlainData);
|
||||
},
|
||||
|
||||
/** Return plain data snapshots for Actors whose system type is `character`. */
|
||||
getCharacters() {
|
||||
return getCollectionContents(game.actors, "actor")
|
||||
.filter((actor) => actor.type === "character")
|
||||
.map(toPlainData);
|
||||
},
|
||||
|
||||
/** Return one Actor snapshot, or null when its id is not in the active world. */
|
||||
getActor(actorId) {
|
||||
return toPlainData(game.actors?.get(actorId));
|
||||
},
|
||||
|
||||
/** Return plain data snapshots for world-level Item documents. */
|
||||
getItems() {
|
||||
return getCollectionContents(game.items, "item").map(toPlainData);
|
||||
},
|
||||
|
||||
/** Return one world-level Item snapshot, or null when its id is not in the active world. */
|
||||
getItem(itemId) {
|
||||
return toPlainData(game.items?.get(itemId));
|
||||
},
|
||||
|
||||
/** Return embedded Item snapshots belonging to an Actor, or null if the Actor is missing. */
|
||||
getActorItems(actorId) {
|
||||
const actor = game.actors?.get(actorId);
|
||||
if (!actor) return null;
|
||||
|
||||
return getCollectionContents(actor.items, "actor item").map(toPlainData);
|
||||
},
|
||||
});
|
||||
|
||||
Hooks.once("init", () => {
|
||||
game.settings.register(MODULE_ID, SETTING_BRIDGE_URL, {
|
||||
name: "Legacy bridge URL",
|
||||
scope: "client",
|
||||
config: false,
|
||||
type: String,
|
||||
default: "",
|
||||
});
|
||||
|
||||
game.settings.register(MODULE_ID, SETTING_PUSH_TOKEN, {
|
||||
name: "Legacy bridge publish token",
|
||||
scope: "client",
|
||||
config: false,
|
||||
type: String,
|
||||
default: "",
|
||||
});
|
||||
|
||||
game.settings.register(MODULE_ID, SETTING_BRIDGE_CONFIG, {
|
||||
name: "Bridge configuration",
|
||||
scope: "client",
|
||||
config: false,
|
||||
type: Object,
|
||||
default: {},
|
||||
});
|
||||
|
||||
game.settings.register(MODULE_ID, SETTING_SYNC_TOKEN, {
|
||||
name: "Character sync token",
|
||||
scope: "client",
|
||||
config: false,
|
||||
type: String,
|
||||
default: "",
|
||||
});
|
||||
|
||||
game.settings.register(MODULE_ID, SETTING_DRAGONROLL_API_URL, {
|
||||
name: "Dragonroll Endpoint",
|
||||
hint: "The Dragonroll server URL. The API path is added automatically.",
|
||||
scope: "client",
|
||||
config: true,
|
||||
type: String,
|
||||
default: "https://dragonroll.aranroig.com",
|
||||
});
|
||||
|
||||
game.settings.register(MODULE_ID, SETTING_LINK_CODE, {
|
||||
name: "Dragonroll Campaign Pairing Code",
|
||||
hint: "Paste a pairing code created in Dragonroll campaign settings.",
|
||||
scope: "client",
|
||||
config: true,
|
||||
type: String,
|
||||
default: "",
|
||||
onChange: handleLinkCodeChange,
|
||||
});
|
||||
|
||||
const module = game.modules.get(MODULE_ID);
|
||||
if (!module) {
|
||||
console.warn(`${MODULE_ID} | Could not register the public API: module was not found.`);
|
||||
return;
|
||||
}
|
||||
|
||||
module.api = api;
|
||||
console.info(`${MODULE_ID} | Public API registered.`);
|
||||
});
|
||||
|
||||
function dragonrollEndpoint(path) {
|
||||
const endpoint = game.settings.get(MODULE_ID, SETTING_DRAGONROLL_API_URL)?.trim();
|
||||
if (!endpoint) throw new Error("Set the Dragonroll endpoint in the Dragonroll Foundry module settings first.");
|
||||
|
||||
const apiBase = new URL(endpoint);
|
||||
const basePath = apiBase.pathname.replace(/\/+$/, "");
|
||||
const isLocalBackend = ["localhost", "127.0.0.1", "[::1]"].includes(apiBase.hostname)
|
||||
&& apiBase.port === "5000";
|
||||
const hasApiPath = basePath.endsWith("/api");
|
||||
apiBase.pathname = `${hasApiPath || isLocalBackend ? basePath : `${basePath}/api`}/`;
|
||||
apiBase.search = "";
|
||||
apiBase.hash = "";
|
||||
return new URL(path.replace(/^\/+/, ""), apiBase);
|
||||
}
|
||||
|
||||
async function postDragonroll(path, body, token = "") {
|
||||
const headers = { "Content-Type": "application/json" };
|
||||
if (token) headers.Authorization = `Bearer ${token}`;
|
||||
const response = await fetch(dragonrollEndpoint(path), {
|
||||
method: "POST",
|
||||
headers,
|
||||
body: JSON.stringify(body),
|
||||
});
|
||||
const result = await response.json();
|
||||
if (!response.ok || result.status !== "ok") {
|
||||
throw new Error(result.msg || `Dragonroll returned HTTP ${response.status}.`);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
async function getDragonroll(path, token) {
|
||||
const response = await fetch(dragonrollEndpoint(path), {
|
||||
headers: { Authorization: `Bearer ${token}` },
|
||||
});
|
||||
const result = await response.json();
|
||||
if (!response.ok || result.status !== "ok") {
|
||||
throw new Error(result.msg || `Dragonroll returned HTTP ${response.status}.`);
|
||||
}
|
||||
return result;
|
||||
}
|
||||
|
||||
function linkErrorMessage(error) {
|
||||
const messages = {
|
||||
"foundry.errors.link-expired": "The pairing code is invalid, expired, or already used.",
|
||||
"foundry.errors.world-already-linked": "This Foundry world is already linked to another campaign.",
|
||||
};
|
||||
return messages[error.message] || error.message;
|
||||
}
|
||||
|
||||
async function setLinkCode(value) {
|
||||
updatingLinkCodeSetting = true;
|
||||
try {
|
||||
await game.settings.set(MODULE_ID, SETTING_LINK_CODE, value);
|
||||
} finally {
|
||||
updatingLinkCodeSetting = false;
|
||||
}
|
||||
}
|
||||
|
||||
function handleLinkCodeChange(value) {
|
||||
if (updatingLinkCodeSetting || handlingLinkCode || !value?.trim()) return;
|
||||
linkRetriesDisabled = false;
|
||||
completeDragonrollCampaignLink(value.trim());
|
||||
}
|
||||
|
||||
async function completeDragonrollCampaignLink(code, options = {}) {
|
||||
if (handlingLinkCode) return;
|
||||
handlingLinkCode = true;
|
||||
const notifyOnError = options.notifyOnError !== false;
|
||||
try {
|
||||
if (!game.user?.isGM || !game.world) throw new Error("Open the world as a GM to link it.");
|
||||
const result = await postDragonroll("foundry/link/complete", { code, world: api.getWorld() });
|
||||
let syncTokenStored = false;
|
||||
if (result.syncToken) {
|
||||
try {
|
||||
await game.settings.set(MODULE_ID, SETTING_SYNC_TOKEN, result.syncToken);
|
||||
syncTokenStored = true;
|
||||
} catch (error) {
|
||||
console.error(`${MODULE_ID} | Could not save the character sync token.`, error);
|
||||
}
|
||||
}
|
||||
if (result.bridgeConfig?.url && result.bridgeConfig?.pushToken) {
|
||||
try {
|
||||
await game.settings.set(MODULE_ID, SETTING_BRIDGE_CONFIG, result.bridgeConfig);
|
||||
} catch (error) {
|
||||
console.error(`${MODULE_ID} | Could not save the bridge configuration.`, error);
|
||||
ui.notifications?.warn("The world was linked, but its bridge settings could not be saved on this client.");
|
||||
}
|
||||
}
|
||||
// Keep an unprocessed pairing code in the setting when its sync token could
|
||||
// not be saved, so the retry below can complete the link again.
|
||||
if (syncTokenStored || !result.syncToken) await setLinkCode("");
|
||||
if (!syncTokenStored) {
|
||||
ui.notifications?.warn("The world was linked, but character sync is unavailable. Update Dragonroll and link the world again.");
|
||||
}
|
||||
scheduleSnapshotSync(0);
|
||||
setTimeout(initializeCharacterSync, 0);
|
||||
ui.notifications?.info("This Foundry world is now linked to the Dragonroll campaign.");
|
||||
} catch (error) {
|
||||
console.error(`${MODULE_ID} | Could not complete the campaign link.`, error);
|
||||
// Expired or already-used codes will never redeem, so stop the background
|
||||
// retry; any error keeps retrying (the Dragonroll server may be restarting).
|
||||
linkRetriesDisabled = FATAL_LINK_ERRORS.has(error.message);
|
||||
if (notifyOnError) ui.notifications?.error(linkErrorMessage(error));
|
||||
} finally {
|
||||
handlingLinkCode = false;
|
||||
}
|
||||
}
|
||||
|
||||
// A pairing code entered while the Dragonroll server was unreachable (or just
|
||||
// before Foundry restarted) stays in the setting; redeem it on world start so
|
||||
// the connection survives restarts without typing the code in again.
|
||||
async function resumePendingDragonrollLink(options = {}) {
|
||||
if (handlingLinkCode || !game.user?.isGM || !game.world) return;
|
||||
const code = game.settings.get(MODULE_ID, SETTING_LINK_CODE)?.trim();
|
||||
if (code) await completeDragonrollCampaignLink(code, options);
|
||||
}
|
||||
|
||||
function scheduleSnapshotSync(delay = 500) {
|
||||
clearTimeout(syncTimeout);
|
||||
syncTimeout = setTimeout(publishSnapshot, delay);
|
||||
}
|
||||
|
||||
function getBridgeConfig() {
|
||||
const configured = game.settings.get(MODULE_ID, SETTING_BRIDGE_CONFIG);
|
||||
if (configured?.url?.trim() && configured?.pushToken?.trim()) return configured;
|
||||
|
||||
const legacy = {
|
||||
url: game.settings.get(MODULE_ID, SETTING_BRIDGE_URL)?.trim(),
|
||||
pushToken: game.settings.get(MODULE_ID, SETTING_PUSH_TOKEN)?.trim(),
|
||||
};
|
||||
return legacy.url && legacy.pushToken ? legacy : null;
|
||||
}
|
||||
|
||||
function getSyncToken() {
|
||||
return game.settings.get(MODULE_ID, SETTING_SYNC_TOKEN)?.trim() || "";
|
||||
}
|
||||
|
||||
function dragonrollActorId(actor) {
|
||||
return actor.getFlag?.(MODULE_ID, "actorId") || actor.flags?.[MODULE_ID]?.actorId || "";
|
||||
}
|
||||
|
||||
function serializeFoundryActor(actor) {
|
||||
const data = {
|
||||
...toPlainData(actor),
|
||||
items: actor.items?.contents?.map(toPlainData) || [],
|
||||
};
|
||||
if (data.img && !/^(https?:|data:|\/\/)/i.test(data.img)) {
|
||||
data.img = new URL(data.img, window.location.origin).toString();
|
||||
}
|
||||
return data;
|
||||
}
|
||||
|
||||
function isSupportedCharacterActor(actor) {
|
||||
const savedType = actor.getFlag?.(MODULE_ID, "actorType") || actor.flags?.[MODULE_ID]?.actorType;
|
||||
return ["character", "npc", "creature"].includes(savedType || actor.type);
|
||||
}
|
||||
|
||||
async function markActorItemsAsSynced(actor) {
|
||||
const updates = actor.items.contents
|
||||
.filter((item) => !item.getFlag?.(MODULE_ID, "syncedItem"))
|
||||
.map((item) => ({
|
||||
_id: item.id,
|
||||
[`flags.${MODULE_ID}.syncedItem`]: true,
|
||||
}));
|
||||
if (updates.length) {
|
||||
await withActorSyncSuppressed(actor, () => actor.updateEmbeddedDocuments("Item", updates));
|
||||
}
|
||||
}
|
||||
|
||||
async function withActorSyncSuppressed(actor, callback) {
|
||||
if (!actor?.id) return callback();
|
||||
syncingActorIds.add(actor.id);
|
||||
try {
|
||||
return await callback();
|
||||
} finally {
|
||||
syncingActorIds.delete(actor.id);
|
||||
}
|
||||
}
|
||||
|
||||
async function setDragonrollActorId(actor, actorId) {
|
||||
if (!actor || !actorId) return;
|
||||
await withActorSyncSuppressed(actor, () => actor.update({
|
||||
[`flags.${MODULE_ID}.actorId`]: String(actorId),
|
||||
[`flags.${MODULE_ID}.syncMutation`]: false,
|
||||
}));
|
||||
}
|
||||
|
||||
function reportActorSyncError(error) {
|
||||
if (actorSyncErrorLogged) return;
|
||||
actorSyncErrorLogged = true;
|
||||
console.warn(`${MODULE_ID} | Character sync failed and will retry.`, error);
|
||||
}
|
||||
|
||||
async function pushFoundryActors(actors, fullSync = false) {
|
||||
const token = getSyncToken();
|
||||
if (!token || !game.user?.isGM || !game.world || (!actors.length && !fullSync)) return;
|
||||
if (game.system.id !== "dnd5e") {
|
||||
throw new Error("Character sync currently requires the D&D 5e Foundry system.");
|
||||
}
|
||||
const supportedActors = actors.filter(isSupportedCharacterActor);
|
||||
|
||||
for (const actor of supportedActors) await markActorItemsAsSynced(actor);
|
||||
const result = await postDragonroll("foundry/sync/snapshot", {
|
||||
worldId: game.world.id,
|
||||
actors: supportedActors.map(serializeFoundryActor),
|
||||
fullSync,
|
||||
}, token);
|
||||
|
||||
for (const mapping of result.actors || []) {
|
||||
const actor = game.actors.get(mapping.foundryActorId);
|
||||
if (actor && dragonrollActorId(actor) !== mapping.actorId) {
|
||||
await setDragonrollActorId(actor, mapping.actorId);
|
||||
}
|
||||
}
|
||||
actorSyncErrorLogged = false;
|
||||
}
|
||||
|
||||
async function deleteDragonrollActor(foundryActorId) {
|
||||
const token = getSyncToken();
|
||||
if (!token || !game.world || !foundryActorId) return;
|
||||
await postDragonroll("foundry/sync/delete", {
|
||||
worldId: game.world.id,
|
||||
foundryActorId,
|
||||
}, token);
|
||||
}
|
||||
|
||||
function queueActorChange(kind, actor) {
|
||||
if (!actor || !game.user?.isGM || !getSyncToken()) return;
|
||||
if (syncingActorIds.has(actor.id) || actor.flags?.[MODULE_ID]?.syncMutation) return;
|
||||
|
||||
queuedActorChanges.set(actor.id, { kind, actor });
|
||||
clearTimeout(actorSyncTimeout);
|
||||
actorSyncTimeout = setTimeout(flushActorChanges, 400);
|
||||
}
|
||||
|
||||
async function flushActorChanges() {
|
||||
const changes = [...queuedActorChanges.values()];
|
||||
queuedActorChanges.clear();
|
||||
const deleted = changes.filter((change) => change.kind === "delete");
|
||||
const changed = changes.filter((change) => change.kind !== "delete");
|
||||
|
||||
try {
|
||||
for (const change of deleted) await deleteDragonrollActor(change.actor.id);
|
||||
await pushFoundryActors(changed.map((change) => change.actor));
|
||||
} catch (error) {
|
||||
reportActorSyncError(error);
|
||||
for (const change of changes) queuedActorChanges.set(change.actor.id, change);
|
||||
clearTimeout(actorSyncTimeout);
|
||||
actorSyncTimeout = setTimeout(flushActorChanges, 5000);
|
||||
}
|
||||
}
|
||||
|
||||
function getDragonrollImageUrl(image) {
|
||||
if (!image) return "";
|
||||
if (/^(https?:|data:|\/\/)/i.test(image)) return image;
|
||||
|
||||
const endpoint = new URL(game.settings.get(MODULE_ID, SETTING_DRAGONROLL_API_URL));
|
||||
const basePath = endpoint.pathname.replace(/\/+$/, "");
|
||||
endpoint.pathname = `${basePath.endsWith("/api") ? basePath : `${basePath}/api`}/public/${encodeURIComponent(image)}`;
|
||||
endpoint.search = "";
|
||||
endpoint.hash = "";
|
||||
return endpoint.toString();
|
||||
}
|
||||
|
||||
function makeFoundryCharacterData(entry) {
|
||||
const stats = entry.abilityScores || {};
|
||||
const items = [];
|
||||
if (entry.className) items.push({ name: entry.className, type: "class", system: { levels: Number(entry.level) || 1 } });
|
||||
if (entry.subclass) items.push({ name: entry.subclass, type: "subclass" });
|
||||
if (entry.background) items.push({ name: entry.background, type: "background" });
|
||||
for (const name of String(entry.spells || "").split("\n").map((value) => value.trim()).filter(Boolean)) {
|
||||
items.push({ name, type: "spell" });
|
||||
}
|
||||
for (const item of entry.inventory || []) {
|
||||
if (!item.name?.trim()) continue;
|
||||
items.push({
|
||||
name: item.name.trim(),
|
||||
type: "loot",
|
||||
system: { quantity: Number(item.quantity) || 1, weight: { value: Number(item.weight) || 0 } },
|
||||
});
|
||||
}
|
||||
|
||||
return {
|
||||
name: entry.name,
|
||||
type: entry.type === "character" ? "character" : "npc",
|
||||
img: getDragonrollImageUrl(entry.image) || undefined,
|
||||
system: {
|
||||
details: {
|
||||
race: entry.species || "",
|
||||
level: Number(entry.level) || 1,
|
||||
background: entry.background || "",
|
||||
biography: { value: entry.description || "" },
|
||||
cr: entry.challengeRating || "",
|
||||
},
|
||||
abilities: Object.fromEntries(["str", "dex", "con", "int", "wis", "cha"].map((key) => [
|
||||
key,
|
||||
{ value: Number(stats[key]) || 10 },
|
||||
])),
|
||||
attributes: {
|
||||
ac: { value: Number(entry.armorClass) || 10 },
|
||||
movement: { walk: Number(entry.speed) || 30 },
|
||||
},
|
||||
},
|
||||
items,
|
||||
flags: { [MODULE_ID]: {
|
||||
actorId: String(entry._id),
|
||||
actorType: entry.type,
|
||||
traits: entry.traits || "",
|
||||
proficiencies: entry.proficiencies || "",
|
||||
syncMutation: true,
|
||||
} },
|
||||
};
|
||||
}
|
||||
|
||||
function documentValue(document, path) {
|
||||
return path.split(".").reduce((value, key) => value?.[key], document);
|
||||
}
|
||||
|
||||
function characterUpdateData(entry) {
|
||||
const stats = entry.abilityScores || {};
|
||||
const updates = {
|
||||
name: entry.name,
|
||||
img: getDragonrollImageUrl(entry.image) || "icons/svg/mystery-man.svg",
|
||||
"system.details.race": entry.species || "",
|
||||
"system.details.level": Number(entry.level) || 1,
|
||||
"system.details.background": entry.background || "",
|
||||
"system.details.biography.value": entry.description || "",
|
||||
"system.details.cr": entry.challengeRating || "",
|
||||
[`flags.${MODULE_ID}.traits`]: entry.traits || "",
|
||||
[`flags.${MODULE_ID}.proficiencies`]: entry.proficiencies || "",
|
||||
"system.attributes.ac.value": Number(entry.armorClass) || 10,
|
||||
"system.attributes.movement.walk": Number(entry.speed) || 30,
|
||||
};
|
||||
for (const key of ["str", "dex", "con", "int", "wis", "cha"]) {
|
||||
updates[`system.abilities.${key}.value`] = Number(stats[key]) || 10;
|
||||
}
|
||||
return updates;
|
||||
}
|
||||
|
||||
async function reconcileEmbeddedItems(actor, entry) {
|
||||
const desired = [];
|
||||
if (entry.className) desired.push({ type: "class", name: entry.className, system: { levels: Number(entry.level) || 1 } });
|
||||
if (entry.subclass) desired.push({ type: "subclass", name: entry.subclass });
|
||||
if (entry.background) desired.push({ type: "background", name: entry.background });
|
||||
for (const name of String(entry.spells || "").split("\n").map((value) => value.trim()).filter(Boolean)) {
|
||||
desired.push({ type: "spell", name });
|
||||
}
|
||||
for (const item of entry.inventory || []) {
|
||||
if (item.name?.trim()) desired.push({
|
||||
type: "loot",
|
||||
name: item.name.trim(),
|
||||
system: { quantity: Number(item.quantity) || 1, weight: { value: Number(item.weight) || 0 } },
|
||||
});
|
||||
}
|
||||
|
||||
const retainedIds = new Set();
|
||||
for (const wanted of desired) {
|
||||
const existing = actor.items.contents.find((item) => item.name === wanted.name
|
||||
&& item.type === wanted.type && item.getFlag?.(MODULE_ID, "syncedItem"))
|
||||
|| actor.items.contents.find((item) => item.name === wanted.name
|
||||
&& item.getFlag?.(MODULE_ID, "syncedItem"));
|
||||
if (existing) {
|
||||
retainedIds.add(existing.id);
|
||||
const update = { _id: existing.id };
|
||||
const expected = { name: wanted.name };
|
||||
if (wanted.system?.levels !== undefined) expected["system.levels"] = wanted.system.levels;
|
||||
if (wanted.system?.quantity !== undefined) expected["system.quantity"] = wanted.system.quantity;
|
||||
if (wanted.system?.weight?.value !== undefined) expected["system.weight.value"] = wanted.system.weight.value;
|
||||
let changed = false;
|
||||
for (const [key, value] of Object.entries(expected)) {
|
||||
if (documentValue(existing, key) !== value) {
|
||||
update[key] = value;
|
||||
changed = true;
|
||||
}
|
||||
}
|
||||
if (changed) await actor.updateEmbeddedDocuments("Item", [update]);
|
||||
} else {
|
||||
const created = await actor.createEmbeddedDocuments("Item", [{
|
||||
...wanted,
|
||||
flags: { [MODULE_ID]: { syncedItem: true } },
|
||||
}]);
|
||||
for (const item of created) retainedIds.add(item.id);
|
||||
}
|
||||
}
|
||||
|
||||
const staleItemIds = actor.items.contents
|
||||
.filter((item) => item.getFlag?.(MODULE_ID, "syncedItem") && !retainedIds.has(item.id))
|
||||
.map((item) => item.id);
|
||||
if (staleItemIds.length) await actor.deleteEmbeddedDocuments("Item", staleItemIds);
|
||||
}
|
||||
|
||||
async function applyDragonrollCharacter(actor, entry) {
|
||||
const updates = characterUpdateData(entry);
|
||||
const changed = Object.entries(updates).some(([key, value]) => documentValue(actor, key) !== value);
|
||||
await withActorSyncSuppressed(actor, async () => {
|
||||
if (changed) await actor.update(updates);
|
||||
await reconcileEmbeddedItems(actor, entry);
|
||||
if (dragonrollActorId(actor) !== String(entry._id)
|
||||
|| actor.getFlag?.(MODULE_ID, "actorType") !== entry.type) {
|
||||
await actor.update({
|
||||
[`flags.${MODULE_ID}.actorId`]: String(entry._id),
|
||||
[`flags.${MODULE_ID}.actorType`]: entry.type,
|
||||
});
|
||||
}
|
||||
});
|
||||
}
|
||||
|
||||
async function mapDragonrollActor(actorId, foundryActorId) {
|
||||
const token = getSyncToken();
|
||||
return postDragonroll("foundry/sync/map", {
|
||||
worldId: game.world.id,
|
||||
actorId: String(actorId),
|
||||
foundryActorId: String(foundryActorId),
|
||||
}, token);
|
||||
}
|
||||
|
||||
async function createFoundryCharacter(entry) {
|
||||
if (game.system.id !== "dnd5e") {
|
||||
throw new Error("Character sync currently requires the D&D 5e Foundry system.");
|
||||
}
|
||||
const actor = await Actor.create(makeFoundryCharacterData(entry), { renderSheet: false });
|
||||
if (!actor) return;
|
||||
|
||||
await withActorSyncSuppressed(actor, async () => {
|
||||
await actor.update({ [`flags.${MODULE_ID}.syncMutation`]: false });
|
||||
});
|
||||
await mapDragonrollActor(entry._id, actor.id);
|
||||
}
|
||||
|
||||
async function reconcileDragonrollCharacters() {
|
||||
const token = getSyncToken();
|
||||
if (!token || !game.user?.isGM || !game.world || characterSyncRunning) return;
|
||||
characterSyncRunning = true;
|
||||
try {
|
||||
if (game.system.id !== "dnd5e") {
|
||||
throw new Error("Character sync currently requires the D&D 5e Foundry system.");
|
||||
}
|
||||
const result = await getDragonroll("foundry/sync/characters", token);
|
||||
const remoteActors = result.actors || [];
|
||||
const remoteById = new Map(remoteActors.map((actor) => [String(actor._id), actor]));
|
||||
const localByRemoteId = new Map(game.actors.contents
|
||||
.map((actor) => [String(dragonrollActorId(actor)), actor])
|
||||
.filter(([actorId]) => actorId));
|
||||
const retainedFoundryIds = new Set();
|
||||
|
||||
for (const entry of remoteActors) {
|
||||
let actor = entry.foundryActorId ? game.actors.get(entry.foundryActorId) : null;
|
||||
if (!actor) actor = localByRemoteId.get(String(entry._id));
|
||||
if (actor) {
|
||||
retainedFoundryIds.add(actor.id);
|
||||
await applyDragonrollCharacter(actor, entry);
|
||||
if (!entry.foundryActorId) await mapDragonrollActor(entry._id, actor.id);
|
||||
} else {
|
||||
await createFoundryCharacter(entry);
|
||||
}
|
||||
}
|
||||
|
||||
for (const actor of game.actors.contents) {
|
||||
const actorId = dragonrollActorId(actor);
|
||||
if (!actorId || retainedFoundryIds.has(actor.id) || remoteById.has(String(actorId))) continue;
|
||||
await withActorSyncSuppressed(actor, () => actor.delete());
|
||||
}
|
||||
actorSyncErrorLogged = false;
|
||||
} catch (error) {
|
||||
reportActorSyncError(error);
|
||||
} finally {
|
||||
characterSyncRunning = false;
|
||||
}
|
||||
}
|
||||
|
||||
async function initializeCharacterSync() {
|
||||
if (!getSyncToken() || !game.user?.isGM || !game.world) return;
|
||||
try {
|
||||
await pushFoundryActors(game.actors.contents, true);
|
||||
await reconcileDragonrollCharacters();
|
||||
} catch (error) {
|
||||
reportActorSyncError(error);
|
||||
scheduleDragonrollCharacterSync(15000);
|
||||
}
|
||||
}
|
||||
|
||||
function queueFoundryActorChange(kind, actor) {
|
||||
if (kind !== "delete" && (actor.flags?.[MODULE_ID]?.syncMutation || syncingActorIds.has(actor.id))) return;
|
||||
queueActorChange(kind, actor);
|
||||
}
|
||||
|
||||
async function publishSnapshot() {
|
||||
if (!game.user?.isGM || !game.world) return;
|
||||
if (syncInProgress) {
|
||||
syncRequested = true;
|
||||
return;
|
||||
}
|
||||
|
||||
const bridgeConfig = getBridgeConfig();
|
||||
if (!bridgeConfig) return;
|
||||
|
||||
syncInProgress = true;
|
||||
try {
|
||||
const actorItems = Object.fromEntries(
|
||||
game.actors.contents.map((actor) => [
|
||||
actor.id,
|
||||
actor.items.contents.map(toPlainData),
|
||||
]),
|
||||
);
|
||||
|
||||
const response = await fetch(new URL("internal/snapshot", `${bridgeConfig.url.replace(/\/+$/, "")}/`), {
|
||||
method: "POST",
|
||||
headers: {
|
||||
"Authorization": `Bearer ${bridgeConfig.pushToken}`,
|
||||
"Content-Type": "application/json",
|
||||
},
|
||||
body: JSON.stringify({
|
||||
world: api.getWorld(),
|
||||
actors: api.getActors(),
|
||||
items: api.getItems(),
|
||||
actorItems,
|
||||
}),
|
||||
});
|
||||
|
||||
if (!response.ok) {
|
||||
throw new Error(`Bridge returned HTTP ${response.status}.`);
|
||||
}
|
||||
} catch (error) {
|
||||
console.error(`${MODULE_ID} | Could not publish the world snapshot.`, error);
|
||||
scheduleSnapshotSync(15000);
|
||||
} finally {
|
||||
syncInProgress = false;
|
||||
if (syncRequested) {
|
||||
syncRequested = false;
|
||||
scheduleSnapshotSync();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
async function publishHeartbeat() {
|
||||
if (!game.user?.isGM || !game.world) return;
|
||||
|
||||
const bridgeConfig = getBridgeConfig();
|
||||
if (!bridgeConfig) return;
|
||||
|
||||
try {
|
||||
const response = await fetch(new URL("internal/heartbeat", `${bridgeConfig.url.replace(/\/+$/, "")}/`), {
|
||||
method: "POST",
|
||||
headers: {
|
||||
"Authorization": `Bearer ${bridgeConfig.pushToken}`,
|
||||
"Content-Type": "application/json",
|
||||
},
|
||||
body: JSON.stringify({ worldId: game.world.id }),
|
||||
});
|
||||
|
||||
if (response.status === 409 || response.status === 503) {
|
||||
scheduleSnapshotSync(0);
|
||||
return;
|
||||
}
|
||||
if (!response.ok) throw new Error(`Bridge returned HTTP ${response.status}.`);
|
||||
} catch (error) {
|
||||
console.warn(`${MODULE_ID} | Bridge heartbeat failed.`, error);
|
||||
scheduleSnapshotSync(15000);
|
||||
}
|
||||
}
|
||||
|
||||
Hooks.once("ready", () => {
|
||||
resumePendingDragonrollLink();
|
||||
setInterval(() => {
|
||||
if (linkRetriesDisabled) return;
|
||||
resumePendingDragonrollLink({ notifyOnError: false });
|
||||
}, 60000);
|
||||
scheduleSnapshotSync(0);
|
||||
setInterval(publishHeartbeat, 60000);
|
||||
setTimeout(initializeCharacterSync, 1000);
|
||||
setInterval(reconcileDragonrollCharacters, 5000);
|
||||
|
||||
for (const event of [
|
||||
"createActor", "updateActor", "deleteActor",
|
||||
"createItem", "updateItem", "deleteItem",
|
||||
]) {
|
||||
Hooks.on(event, (document) => {
|
||||
scheduleSnapshotSync();
|
||||
const actor = document.documentName === "Actor" ? document : document.parent;
|
||||
if (actor?.documentName === "Actor") {
|
||||
queueFoundryActorChange(event.startsWith("delete") ? "delete" : "upsert", actor);
|
||||
}
|
||||
});
|
||||
}
|
||||
});
|
||||
@@ -2,6 +2,7 @@
|
||||
import ContentManager from './components/managers/ContentManager.vue';
|
||||
import ToastManager from './components/managers/ToastManager.vue';
|
||||
import WindowManager from './components/managers/WindowManager.vue';
|
||||
import DiscordAuthorize from './components/views/DiscordAuthorize.vue';
|
||||
|
||||
import { CreateWindow } from '@/services/Windows'
|
||||
import { GetUser, HasAdmin } from './services/User';
|
||||
@@ -11,6 +12,11 @@ import { useCampaignService } from './services/Campaign';
|
||||
|
||||
const { RestoreCampaign } = useCampaignService();
|
||||
|
||||
// El bot de Discord enllaça amb aquesta pantalla; no és part de l'aplicació i no ha d'arrencar
|
||||
// les finestres normals.
|
||||
const requestUrl = useRequestURL();
|
||||
const isDiscordAuthorize = computed(() => requestUrl.pathname.replace(/\/+$/, '') === '/discord/authorize');
|
||||
|
||||
async function start(){
|
||||
if(GetUser()){
|
||||
const restoredCampaign = await RestoreCampaign();
|
||||
@@ -40,12 +46,15 @@ useHead({
|
||||
onMounted(() => {
|
||||
setupTheme();
|
||||
setTheme('dark');
|
||||
start();
|
||||
if(!isDiscordAuthorize.value){
|
||||
start();
|
||||
}
|
||||
})
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="viewer">
|
||||
<DiscordAuthorize v-if="isDiscordAuthorize"></DiscordAuthorize>
|
||||
<div v-else class="viewer">
|
||||
<ToastManager></ToastManager>
|
||||
<TooltipManager></TooltipManager>
|
||||
<ContextMenuManager></ContextMenuManager>
|
||||
|
||||
@@ -1,25 +1,23 @@
|
||||
<script setup>
|
||||
|
||||
import { onMounted, ref } from 'vue';
|
||||
import { computed, onMounted, ref } from 'vue';
|
||||
|
||||
import { AddSound } from '../../services/Sound';
|
||||
import { useCampaignService } from '~/services/Campaign';
|
||||
import { ClearWindow } from '~/services/Windows';
|
||||
import { ClearWindow, CreateChildWindow, GetFirstWindowId } from '~/services/Windows';
|
||||
const { SetCampaign } = useCampaignService();
|
||||
|
||||
const props = defineProps(['data']);
|
||||
const data = props.data;
|
||||
|
||||
const title = ref("");
|
||||
const title = computed(() => data.name);
|
||||
const campaignStyle = computed(() => data.color
|
||||
? { background: `linear-gradient(90deg, ${data.color}, ${data.color}44)` }
|
||||
: {});
|
||||
|
||||
const container = ref(null);
|
||||
|
||||
onMounted(() => {
|
||||
title.value = data.name;
|
||||
if (data.color && container.value) {
|
||||
container.value.style.background = `linear-gradient(90deg, ${data.color}, ${data.color}44)`;
|
||||
}
|
||||
|
||||
AddSound(container.value)
|
||||
});
|
||||
|
||||
@@ -27,11 +25,16 @@ function ViewCampaign(){
|
||||
SetCampaign(data);
|
||||
ClearWindow({type: "main_menu"});
|
||||
}
|
||||
|
||||
function OpenSettings(){
|
||||
ClearWindow({type: 'campaign_settings'});
|
||||
CreateChildWindow(GetFirstWindowId('main_menu'), 'campaign_settings', { campaign: data });
|
||||
}
|
||||
</script>
|
||||
|
||||
|
||||
<template>
|
||||
<div class="campaign-entry-container" ref="container">
|
||||
<div class="campaign-entry-container" ref="container" :style="campaignStyle">
|
||||
<div class="main-campaign-entry-container-inner">
|
||||
<img class="campaign-icon" src="/img/def-avatar.jpg" draggable="false">
|
||||
<div class="campaign-info">
|
||||
@@ -39,6 +42,7 @@ function ViewCampaign(){
|
||||
</div>
|
||||
|
||||
<div class="campaign-user-actions">
|
||||
<button class="btn-primary button-small sound-click" v-on:click.prevent="OpenSettings">{{ $t('main-menu.settings') }}</button>
|
||||
<button class="btn-primary button-small sound-click" v-on:click.prevent="ViewCampaign">{{ $t('general.open')}}</button>
|
||||
</div>
|
||||
</div>
|
||||
@@ -81,5 +85,7 @@ function ViewCampaign(){
|
||||
|
||||
.campaign-user-actions {
|
||||
margin-left: auto;
|
||||
display: flex;
|
||||
gap: 6px;
|
||||
}
|
||||
</style>
|
||||
|
||||
@@ -1,28 +1,43 @@
|
||||
<script setup>
|
||||
import { computed, onMounted, ref, watch } from 'vue';
|
||||
import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue';
|
||||
import { useI18n } from 'vue-i18n';
|
||||
|
||||
import { useCampaignService } from '~/services/Campaign.js';
|
||||
import { emitter } from '~/services/Emitter';
|
||||
import Server from '~/services/Server';
|
||||
import { CreateWindow } from '~/services/Windows';
|
||||
import { ClearWindow, CreateWindow, GetFirstWindowId } from '~/services/Windows';
|
||||
import { HideContextMenu, ShowContextMenu } from '~/services/ContextMenu';
|
||||
import NestedNoteList from './NestedNoteList.vue';
|
||||
|
||||
const { Campaign } = useCampaignService();
|
||||
const { t } = useI18n();
|
||||
const notes = ref([]);
|
||||
const folders = ref([]);
|
||||
const actors = ref([]);
|
||||
const items = ref([]);
|
||||
const loadingNotes = ref(false);
|
||||
const loadingEntries = ref(false);
|
||||
const notesError = ref('');
|
||||
const entriesError = ref('');
|
||||
const sidebarCollapsed = ref(false);
|
||||
const activeSection = ref('notes');
|
||||
const isDragOverSidebar = ref(false);
|
||||
const expandedFolderIds = ref([]);
|
||||
const expandedEntryIds = ref([]);
|
||||
const nestedNoteListRef = ref(null);
|
||||
let actorRefreshInterval;
|
||||
|
||||
async function handleSidebarDrop(event) {
|
||||
if (activeSection.value !== 'notes') return;
|
||||
const noteKey = event.dataTransfer.getData('text/plain');
|
||||
if (!noteKey) return;
|
||||
try {
|
||||
await Server().post('/note/update', { id: noteKey, folder: null });
|
||||
fetchCampaignNotes();
|
||||
if (nestedNoteListRef.value) {
|
||||
nestedNoteListRef.value.clearCacheAndReloadExpanded();
|
||||
} else {
|
||||
fetchCampaignNotes();
|
||||
}
|
||||
} catch (e) {}
|
||||
}
|
||||
|
||||
@@ -58,7 +73,13 @@ function handleNoteCreated(note) {
|
||||
};
|
||||
|
||||
notes.value = notes.value.filter((currentNote) => currentNote.key !== createdNote.key);
|
||||
notes.value.unshift(createdNote);
|
||||
|
||||
// Notes created inside a folder are added by NestedNoteList's own cache handler
|
||||
const noteFolderId = note.folder?._id ?? note.folder ?? null;
|
||||
if (!noteFolderId) {
|
||||
notes.value.unshift(createdNote);
|
||||
}
|
||||
|
||||
openNote(createdNote);
|
||||
}
|
||||
|
||||
@@ -70,6 +91,32 @@ function handleNoteRenamed(data) {
|
||||
emitter.emit('title-updated', { key: data.key, title: data.title });
|
||||
}
|
||||
|
||||
function handleNoteDeleted(noteKey) {
|
||||
notes.value = notes.value.filter(n => n.key !== noteKey);
|
||||
}
|
||||
|
||||
function handleFolderSaved() {
|
||||
fetchCampaignNotes();
|
||||
}
|
||||
|
||||
function handleFolderDeleted(folderId) {
|
||||
expandedFolderIds.value = expandedFolderIds.value.filter((id) => id !== folderId);
|
||||
}
|
||||
|
||||
function handleCampaignEntryCreated({ entityType, entry }) {
|
||||
if (!entry || (entry.campaign && String(entry.campaign) !== String(campaignId.value))) return;
|
||||
const list = entityType === 'actor' ? actors : items;
|
||||
list.value = [...list.value.filter((current) => current._id !== entry._id), entry]
|
||||
.sort((a, b) => a.name.localeCompare(b.name));
|
||||
}
|
||||
|
||||
function handleCampaignEntryUpdated({ entityType, entry }) {
|
||||
if (!entry) return;
|
||||
const list = entityType === 'actor' ? actors : items;
|
||||
list.value = list.value.map((current) => current._id === entry._id ? entry : current)
|
||||
.sort((a, b) => a.name.localeCompare(b.name));
|
||||
}
|
||||
|
||||
const campaignId = computed(() => {
|
||||
return Campaign.value?._id ?? Campaign.value?.id ?? null;
|
||||
});
|
||||
@@ -111,24 +158,97 @@ async function fetchCampaignNotes() {
|
||||
}
|
||||
}
|
||||
|
||||
async function createNote() {
|
||||
async function fetchCampaignEntries(entityType = activeSection.value, silent = false) {
|
||||
if (!campaignId.value || !['actors', 'items'].includes(entityType)) return;
|
||||
if (!silent) {
|
||||
loadingEntries.value = true;
|
||||
entriesError.value = '';
|
||||
}
|
||||
try {
|
||||
const collection = entityType === 'actors' ? 'actor' : 'item';
|
||||
const response = await Server().get(`/${collection}/list`, { params: { campaign: campaignId.value } });
|
||||
if (response.data.status !== 'ok') {
|
||||
if (!silent) entriesError.value = response.data.msg ?? t('campaigns.errors.load');
|
||||
return;
|
||||
}
|
||||
if (entityType === 'actors') {
|
||||
const previousById = new Map(actors.value.map((actor) => [actor._id, actor]));
|
||||
actors.value = response.data.actors;
|
||||
for (const actor of actors.value) {
|
||||
const previous = previousById.get(actor._id);
|
||||
if (previous && JSON.stringify(previous) !== JSON.stringify(actor)) {
|
||||
emitter.emit('campaign-entry-updated', { entityType: 'actor', entry: actor });
|
||||
}
|
||||
}
|
||||
} else {
|
||||
items.value = response.data.items;
|
||||
}
|
||||
} catch (error) {
|
||||
if (!silent) entriesError.value = t('campaigns.errors.load');
|
||||
} finally {
|
||||
if (!silent) loadingEntries.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
function selectSection(section) {
|
||||
activeSection.value = section;
|
||||
if (section === 'actors' || section === 'items') fetchCampaignEntries(section);
|
||||
}
|
||||
|
||||
function createEntry(entityType) {
|
||||
if (!campaignId.value) return;
|
||||
CreateWindow('create_campaign_entry', { entityType, campaign: campaignId.value });
|
||||
}
|
||||
|
||||
function entrySummary(actor) {
|
||||
const bits = [t(`campaigns.actor.types.${actor.type}`)];
|
||||
if (actor.species) bits.push(actor.species);
|
||||
if (actor.className) bits.push(actor.className);
|
||||
if (actor.level) bits.push(`${t('campaigns.actor.level-short')} ${actor.level}`);
|
||||
if (actor.challengeRating) bits.push(`${t('campaigns.actor.cr-short')} ${actor.challengeRating}`);
|
||||
return bits.join(' · ');
|
||||
}
|
||||
|
||||
function itemSummary(item) {
|
||||
return `${t(`campaigns.item.categories.${item.category}`)} · ${t(`campaigns.item.rarities.${item.rarity}`)} · ${t('campaigns.item.quantity-short')} ${item.quantity}`;
|
||||
}
|
||||
|
||||
function showEntryMenu(entry, entityType) {
|
||||
const collection = entityType === 'actor' ? 'actor' : 'item';
|
||||
ShowContextMenu([{
|
||||
name: t('campaigns.actions.delete'),
|
||||
icon: '/icons/iconoir/regular/trash.svg',
|
||||
action: async () => {
|
||||
try {
|
||||
const response = await Server().post(`/${collection}/delete`, { id: entry._id });
|
||||
if (response.data.status === 'ok') {
|
||||
if (entityType === 'actor') actors.value = actors.value.filter((actor) => actor._id !== entry._id);
|
||||
else items.value = items.value.filter((item) => item._id !== entry._id);
|
||||
}
|
||||
} catch (error) {} finally { HideContextMenu(); }
|
||||
}
|
||||
}]);
|
||||
}
|
||||
|
||||
function toggleEntryDetails(entryId) {
|
||||
expandedEntryIds.value = expandedEntryIds.value.includes(entryId)
|
||||
? expandedEntryIds.value.filter((id) => id !== entryId)
|
||||
: [...expandedEntryIds.value, entryId];
|
||||
}
|
||||
|
||||
async function openCharacterSheet(actor) {
|
||||
const existingWindowId = GetFirstWindowId('character_sheet');
|
||||
if (existingWindowId !== undefined) {
|
||||
ClearWindow({ id: existingWindowId });
|
||||
await nextTick();
|
||||
}
|
||||
CreateWindow('character_sheet', { actor });
|
||||
}
|
||||
|
||||
function createNote() {
|
||||
if (!Campaign.value) return;
|
||||
|
||||
const cid = Campaign.value?._id;
|
||||
|
||||
try {
|
||||
const response = await Server().post('/note/create', {
|
||||
title: 'New note',
|
||||
content: '',
|
||||
campaign: cid
|
||||
});
|
||||
|
||||
if (response.data.status !== 'ok') return;
|
||||
|
||||
emitter.emit('note-created', response.data.note);
|
||||
} catch (err) {
|
||||
console.log(err);
|
||||
}
|
||||
CreateWindow('new_note', { campaign: campaignId.value });
|
||||
}
|
||||
|
||||
function createFolder() {
|
||||
@@ -143,18 +263,46 @@ const rootNotes = computed(() => notes.value.filter(n => !n._folder));
|
||||
|
||||
watch(campaignId, (newVal) => {
|
||||
if (newVal) {
|
||||
actors.value = [];
|
||||
items.value = [];
|
||||
fetchCampaignNotes();
|
||||
if (activeSection.value === 'actors' || activeSection.value === 'items') fetchCampaignEntries(activeSection.value);
|
||||
} else {
|
||||
notes.value = [];
|
||||
folders.value = [];
|
||||
actors.value = [];
|
||||
items.value = [];
|
||||
notesError.value = '';
|
||||
entriesError.value = '';
|
||||
}
|
||||
});
|
||||
|
||||
onMounted(() => {
|
||||
emitter.on('note-created', handleNoteCreated);
|
||||
emitter.on('note-renamed', handleNoteRenamed);
|
||||
emitter.on('delete-note', handleNoteDeleted);
|
||||
emitter.on('folder-saved', handleFolderSaved);
|
||||
emitter.on('folder-deleted', handleFolderDeleted);
|
||||
emitter.on('campaign-entry-created', handleCampaignEntryCreated);
|
||||
emitter.on('campaign-entry-updated', handleCampaignEntryUpdated);
|
||||
|
||||
if (campaignId.value) {
|
||||
fetchCampaignNotes();
|
||||
}
|
||||
actorRefreshInterval = setInterval(() => {
|
||||
if (activeSection.value === 'actors' && campaignId.value) fetchCampaignEntries('actors', true);
|
||||
}, 5000);
|
||||
});
|
||||
|
||||
onBeforeUnmount(() => {
|
||||
clearInterval(actorRefreshInterval);
|
||||
emitter.off('note-created', handleNoteCreated);
|
||||
emitter.off('note-renamed', handleNoteRenamed);
|
||||
emitter.off('delete-note', handleNoteDeleted);
|
||||
emitter.off('folder-saved', handleFolderSaved);
|
||||
emitter.off('folder-deleted', handleFolderDeleted);
|
||||
emitter.off('campaign-entry-created', handleCampaignEntryCreated);
|
||||
emitter.off('campaign-entry-updated', handleCampaignEntryUpdated);
|
||||
});
|
||||
</script>
|
||||
|
||||
@@ -166,9 +314,9 @@ onMounted(() => {
|
||||
type="button"
|
||||
@click="toggleSidebar"
|
||||
:aria-expanded="(!sidebarCollapsed).toString()"
|
||||
aria-controls="campaign-notes-list"
|
||||
:title="sidebarCollapsed ? 'Expand notes' : 'Collapse notes'"
|
||||
:aria-label="sidebarCollapsed ? 'Expand notes' : 'Collapse notes'"
|
||||
aria-controls="campaign-section-list"
|
||||
:title="sidebarCollapsed ? t('campaigns.actions.expand-sidebar') : t('campaigns.actions.collapse-sidebar')"
|
||||
:aria-label="sidebarCollapsed ? t('campaigns.actions.expand-sidebar') : t('campaigns.actions.collapse-sidebar')"
|
||||
>
|
||||
<img
|
||||
class="sidebar-action-icon"
|
||||
@@ -180,72 +328,100 @@ onMounted(() => {
|
||||
|
||||
<button
|
||||
class="sidebar-action"
|
||||
type="button"
|
||||
@click="createNote"
|
||||
:disabled="!Campaign"
|
||||
title="New note"
|
||||
aria-label="New note"
|
||||
:class="{ selected: activeSection === 'notes' }"
|
||||
type="button" @click="selectSection('notes')"
|
||||
:title="t('campaigns.sections.notes')" :aria-label="t('campaigns.sections.notes')"
|
||||
:aria-pressed="(activeSection === 'notes').toString()"
|
||||
>
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/plus.svg" alt="" aria-hidden="true">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/book.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
|
||||
<button
|
||||
class="sidebar-action"
|
||||
type="button"
|
||||
@click="createFolder"
|
||||
:disabled="!Campaign"
|
||||
title="New folder"
|
||||
aria-label="New folder"
|
||||
:class="{ selected: activeSection === 'actors' }"
|
||||
type="button" @click="selectSection('actors')"
|
||||
:title="t('campaigns.sections.actors')" :aria-label="t('campaigns.sections.actors')"
|
||||
:aria-pressed="(activeSection === 'actors').toString()"
|
||||
>
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/folder.svg" alt="" aria-hidden="true">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/user.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
|
||||
<button
|
||||
class="sidebar-action"
|
||||
type="button"
|
||||
@click="fetchCampaignNotes"
|
||||
:disabled="!Campaign || loadingNotes"
|
||||
title="Refresh notes"
|
||||
aria-label="Refresh notes"
|
||||
:class="{ selected: activeSection === 'items' }"
|
||||
type="button" @click="selectSection('items')"
|
||||
:title="t('campaigns.sections.items')" :aria-label="t('campaigns.sections.items')"
|
||||
:aria-pressed="(activeSection === 'items').toString()"
|
||||
>
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/refresh.svg" alt="" aria-hidden="true">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/box.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
</nav>
|
||||
|
||||
<aside class="notes-sidebar" :class="{ collapsed: sidebarCollapsed }">
|
||||
<div class="sidebar-header">
|
||||
<div class="sidebar-copy">
|
||||
<span class="sidebar-eyebrow">Campaign</span>
|
||||
<strong class="sidebar-title">Notes</strong>
|
||||
<span class="sidebar-eyebrow">{{ t('campaigns.sidebar-label') }}</span>
|
||||
<strong class="sidebar-title">{{ t(`campaigns.sections.${activeSection}`) }}</strong>
|
||||
</div>
|
||||
<div class="sidebar-header-actions">
|
||||
<template v-if="activeSection === 'notes'">
|
||||
<button class="sidebar-action" type="button" @click="createNote" :disabled="!Campaign" :title="t('campaigns.actions.new-note')" :aria-label="t('campaigns.actions.new-note')">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/plus.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
<button class="sidebar-action" type="button" @click="createFolder" :disabled="!Campaign" :title="t('campaigns.actions.new-folder')" :aria-label="t('campaigns.actions.new-folder')">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/folder.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
<button class="sidebar-action" type="button" @click="fetchCampaignNotes" :disabled="!Campaign || loadingNotes" :title="t('campaigns.actions.refresh')" :aria-label="t('campaigns.actions.refresh')">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/refresh.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
</template>
|
||||
<template v-else>
|
||||
<button class="sidebar-action" type="button" @click="createEntry(activeSection === 'actors' ? 'actor' : 'item')" :disabled="!Campaign" :title="t('campaigns.actions.create', { section: t(`campaigns.sections.${activeSection}`).toLowerCase() })" :aria-label="t('campaigns.actions.create', { section: t(`campaigns.sections.${activeSection}`).toLowerCase() })">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/plus.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
<button class="sidebar-action" type="button" @click="fetchCampaignEntries(activeSection)" :disabled="!Campaign || loadingEntries" :title="t('campaigns.actions.refresh')" :aria-label="t('campaigns.actions.refresh')">
|
||||
<img class="sidebar-action-icon" src="/icons/iconoir/regular/refresh.svg" alt="" aria-hidden="true">
|
||||
</button>
|
||||
</template>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<div class="sidebar-list-drop-wrap" :class="{ 'drag-over': isDragOverSidebar }" id="campaign-notes-list" @dragenter.self="isDragOverSidebar = true" @dragleave.self="isDragOverSidebar = false" @dragover.prevent @drop.stop="handleSidebarDrop">
|
||||
<div v-if="loadingNotes" class="sidebar-state">
|
||||
Loading notes...
|
||||
</div>
|
||||
<div class="sidebar-list-drop-wrap" :class="{ 'drag-over': activeSection === 'notes' && isDragOverSidebar }" id="campaign-section-list" @dragenter.self="isDragOverSidebar = true" @dragleave.self="isDragOverSidebar = false" @dragover.prevent @drop.stop="handleSidebarDrop">
|
||||
<template v-if="activeSection === 'notes'">
|
||||
<div v-if="loadingNotes" class="sidebar-state">{{ t('campaigns.states.loading-notes') }}</div>
|
||||
<div v-else-if="notesError" class="sidebar-state error">{{ notesError }}</div>
|
||||
<div v-else-if="folders.length === 0 && notes.length === 0" class="sidebar-state">{{ t('campaigns.states.empty-notes') }}</div>
|
||||
<NestedNoteList v-else ref="nestedNoteListRef"
|
||||
:parent-folder-id="null" :folders="folders" :notes="rootNotes" :campaign-id="campaignId"
|
||||
:expanded-folder-ids="expandedFolderIds" @open-note="openNote"
|
||||
@reload-notes="fetchCampaignNotes" @toggle-expanded-folder="toggleExpandedFolder" />
|
||||
</template>
|
||||
|
||||
<div v-else-if="notesError" class="sidebar-state error">
|
||||
{{ notesError }}
|
||||
</div>
|
||||
<template v-else-if="activeSection === 'actors'">
|
||||
<div v-if="loadingEntries" class="sidebar-state">{{ t('campaigns.states.loading') }}</div>
|
||||
<div v-else-if="entriesError" class="sidebar-state error">{{ entriesError }}</div>
|
||||
<div v-else-if="actors.length === 0" class="sidebar-state">{{ t('campaigns.states.empty-actors') }}</div>
|
||||
<div v-for="actor in actors" :key="actor._id" class="entity-entry" role="button" tabindex="0" @click="openCharacterSheet(actor)" @keydown.enter="openCharacterSheet(actor)" @keydown.space.prevent="openCharacterSheet(actor)" @contextmenu.prevent="showEntryMenu(actor, 'actor')">
|
||||
<span class="entity-entry-name">{{ actor.name }}</span>
|
||||
<span class="entity-entry-meta">{{ entrySummary(actor) }}</span>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<div v-else-if="folders.length === 0 && notes.length === 0" class="sidebar-state">
|
||||
No notes in this campaign yet.
|
||||
</div>
|
||||
|
||||
<template v-else>
|
||||
<NestedNoteList ref="nestedNoteListRef"
|
||||
:parent-folder-id="null"
|
||||
:folders="folders"
|
||||
:notes="rootNotes"
|
||||
:campaign-id="campaignId"
|
||||
:expanded-folder-ids="expandedFolderIds"
|
||||
@open-note="openNote"
|
||||
@reload-notes="fetchCampaignNotes"
|
||||
@toggle-expanded-folder="toggleExpandedFolder"
|
||||
/>
|
||||
</template>
|
||||
</div>
|
||||
<template v-else>
|
||||
<div v-if="loadingEntries" class="sidebar-state">{{ t('campaigns.states.loading') }}</div>
|
||||
<div v-else-if="entriesError" class="sidebar-state error">{{ entriesError }}</div>
|
||||
<div v-else-if="items.length === 0" class="sidebar-state">{{ t('campaigns.states.empty-items') }}</div>
|
||||
<div v-for="item in items" :key="item._id" class="entity-entry" role="button" tabindex="0" :aria-expanded="expandedEntryIds.includes(item._id)" @click="toggleEntryDetails(item._id)" @keydown.enter="toggleEntryDetails(item._id)" @keydown.space.prevent="toggleEntryDetails(item._id)" @contextmenu.prevent="showEntryMenu(item, 'item')">
|
||||
<span class="entity-entry-name">{{ item.name }}</span>
|
||||
<span class="entity-entry-meta">{{ itemSummary(item) }}</span>
|
||||
<template v-if="expandedEntryIds.includes(item._id)">
|
||||
<span v-if="item.weight !== undefined" class="entity-entry-description">{{ item.weight }} lb</span>
|
||||
<span v-if="item.properties" class="entity-entry-description">{{ item.properties }}</span>
|
||||
<span v-if="item.description" class="entity-entry-description">{{ item.description }}</span>
|
||||
</template>
|
||||
</div>
|
||||
</template>
|
||||
</div>
|
||||
</aside>
|
||||
</div>
|
||||
</template>
|
||||
@@ -258,8 +434,8 @@ onMounted(() => {
|
||||
}
|
||||
|
||||
.sidebar-actions {
|
||||
width: 32px;
|
||||
min-width: 32px;
|
||||
width: 46px;
|
||||
min-width: 46px;
|
||||
padding: 8px 6px;
|
||||
border-right: 1px solid var(--color-border);
|
||||
background-color: var(--color-background-light);
|
||||
@@ -284,6 +460,11 @@ onMounted(() => {
|
||||
cursor: pointer;
|
||||
}
|
||||
|
||||
.sidebar-action.selected {
|
||||
background: var(--color-button-hover);
|
||||
border-color: var(--color-link);
|
||||
}
|
||||
|
||||
.sidebar-action:hover {
|
||||
background: var(--color-button-hover);
|
||||
}
|
||||
@@ -322,11 +503,16 @@ onMounted(() => {
|
||||
box-sizing: border-box;
|
||||
padding: 12px;
|
||||
display: flex;
|
||||
align-items: flex-start;
|
||||
gap: 10px;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 8px;
|
||||
border-bottom: 1px solid var(--color-border);
|
||||
}
|
||||
|
||||
.sidebar-header-actions { display: flex; align-items: center; gap: 4px; }
|
||||
.sidebar-header-actions .sidebar-action { width: 30px; height: 30px; }
|
||||
.sidebar-header-actions .sidebar-action-icon { width: 16px; height: 16px; }
|
||||
|
||||
.sidebar-copy {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
@@ -374,6 +560,17 @@ onMounted(() => {
|
||||
color: #9e2a2b;
|
||||
}
|
||||
|
||||
.entity-entry {
|
||||
width: 100%; padding: 9px 10px; border: 1px solid transparent; border-radius: 8px;
|
||||
background: transparent; color: var(--color-text); text-align: left; display: flex; flex-direction: column;
|
||||
gap: 3px; cursor: pointer;
|
||||
}
|
||||
.entity-entry:hover { border-color: var(--color-border); background: var(--color-background-soft); }
|
||||
.entity-entry:focus-visible { outline: 1px solid var(--color-link); }
|
||||
.entity-entry-name { font-weight: bold; }
|
||||
.entity-entry-meta, .entity-entry-description { font-size: 12px; opacity: 0.72; }
|
||||
.entity-entry-description { display: -webkit-box; -webkit-box-orient: vertical; -webkit-line-clamp: 2; overflow: hidden; }
|
||||
|
||||
@media (max-width: 900px) {
|
||||
.notes-sidebar {
|
||||
width: 220px;
|
||||
|
||||
@@ -1,5 +1,5 @@
|
||||
<script setup>
|
||||
import { ref, onMounted, watch } from 'vue';
|
||||
import { ref, onBeforeUnmount, onMounted, watch } from 'vue';
|
||||
import { emitter } from '~/services/Emitter';
|
||||
import Server from '~/services/Server';
|
||||
import { CreateWindow } from '~/services/Windows';
|
||||
@@ -40,8 +40,54 @@ watch(
|
||||
|
||||
onMounted(() => {
|
||||
loadExpandedFolders();
|
||||
emitter.on('note-created', handleNoteCreated);
|
||||
emitter.on('note-renamed', handleNoteRenamed);
|
||||
emitter.on('delete-note', handleNoteDeleted);
|
||||
emitter.on('folder-saved', handleFolderSaved);
|
||||
});
|
||||
|
||||
onBeforeUnmount(() => {
|
||||
emitter.off('note-created', handleNoteCreated);
|
||||
emitter.off('note-renamed', handleNoteRenamed);
|
||||
emitter.off('delete-note', handleNoteDeleted);
|
||||
emitter.off('folder-saved', handleFolderSaved);
|
||||
});
|
||||
|
||||
// Keep this instance's folder content cache in sync with changes made anywhere in the app.
|
||||
// The cache entry for a folder only lives on the instance that renders it, so every
|
||||
// instance listens and updates whichever entries it owns.
|
||||
function handleNoteCreated(note) {
|
||||
if (!note) return;
|
||||
const folderId = note.folder?._id ?? note.folder ?? null;
|
||||
const entry = folderId ? folderContentCache.value[folderId] : null;
|
||||
if (entry) {
|
||||
entry.notes.unshift({ key: note._id, title: note.title, text: note.content || '' });
|
||||
}
|
||||
}
|
||||
|
||||
function handleNoteRenamed(data) {
|
||||
if (!data) return;
|
||||
for (const entry of Object.values(folderContentCache.value)) {
|
||||
const note = entry.notes.find((n) => n.key === data.key);
|
||||
if (note) note.title = data.title;
|
||||
}
|
||||
}
|
||||
|
||||
function handleNoteDeleted(noteKey) {
|
||||
for (const entry of Object.values(folderContentCache.value)) {
|
||||
entry.notes = entry.notes.filter((n) => n.key !== noteKey);
|
||||
}
|
||||
}
|
||||
|
||||
function handleFolderSaved(folder) {
|
||||
const folderId = folder?._id ?? folder?.id;
|
||||
if (!folderId) return;
|
||||
for (const entry of Object.values(folderContentCache.value)) {
|
||||
const subfolder = entry.subfolders.find((f) => (f._id ?? f.id) === folderId);
|
||||
if (subfolder) subfolder.name = folder.name;
|
||||
}
|
||||
}
|
||||
|
||||
function loadFolderContents(folderId) {
|
||||
if (loadingFolders.has(folderId)) return;
|
||||
loadingFolders.add(folderId);
|
||||
@@ -86,7 +132,7 @@ async function handleDropNoteOnFolder(folderId, event) {
|
||||
|
||||
try {
|
||||
await Server().post('/note/update', { id: noteKey, folder: folderId });
|
||||
emit('reload-notes');
|
||||
clearCacheAndReloadExpanded();
|
||||
} catch (e) {}
|
||||
}
|
||||
|
||||
@@ -98,29 +144,23 @@ async function handleDropNoteOnRoot(event) {
|
||||
|
||||
try {
|
||||
await Server().post('/note/update', { id: noteKey, folder: null });
|
||||
emit('reload-notes');
|
||||
clearCacheAndReloadExpanded();
|
||||
} catch (e) {}
|
||||
}
|
||||
|
||||
// Called on reload — clears cache so expanded folders refetch fresh content
|
||||
// Called on reload — clears cache and refetches what this instance is responsible for,
|
||||
// then bubbles the reload up so ancestors (and eventually the sidebar) refresh too
|
||||
function clearCacheAndReloadExpanded() {
|
||||
const folderIdsToReLoad = [];
|
||||
if (props.level === 0) {
|
||||
for (const id of props.expandedFolderIds) {
|
||||
if (folderContentCache.value[id]) folderIdsToReLoad.push(id);
|
||||
delete folderContentCache.value[id];
|
||||
}
|
||||
} else if (props.parentFolderId && folderContentCache.value[props.parentFolderId]) {
|
||||
folderIdsToReLoad.push(props.parentFolderId);
|
||||
delete folderContentCache.value[props.parentFolderId];
|
||||
}
|
||||
const loadedIds = Object.keys(folderContentCache.value);
|
||||
|
||||
// Force reactivity by creating a new object
|
||||
folderContentCache.value = {};
|
||||
|
||||
for (const id of folderIdsToReLoad) {
|
||||
for (const id of loadedIds) {
|
||||
loadFolderContents(id);
|
||||
}
|
||||
|
||||
emit('reload-notes');
|
||||
}
|
||||
|
||||
// Exposed to parent components
|
||||
@@ -180,7 +220,7 @@ function renameNote(note) { CreateWindow('rename_note', { title: note.title, key
|
||||
async function deleteNote(note) {
|
||||
try {
|
||||
const response = await Server().post('/note/delete', { id: note.key });
|
||||
if (response.data.status === 'ok') { emit('reload-notes'); emitter.emit('delete-note', note.key); }
|
||||
if (response.data.status === 'ok') emitter.emit('delete-note', note.key);
|
||||
} catch (error) {} finally {
|
||||
HideContextMenu();
|
||||
}
|
||||
@@ -190,7 +230,10 @@ function renameFolder(folderId, name) { CreateWindow('new_folder', { folderId, c
|
||||
|
||||
async function deleteFolder(folderId) {
|
||||
const response = await Server().post('/folder/delete', { id: folderId });
|
||||
if (response.data.status === 'ok') emit('reload-notes');
|
||||
if (response.data.status === 'ok') {
|
||||
emitter.emit('folder-deleted', folderId);
|
||||
clearCacheAndReloadExpanded();
|
||||
}
|
||||
HideContextMenu();
|
||||
}
|
||||
|
||||
@@ -198,16 +241,13 @@ async function moveNoteToFolder(note, folderId) {
|
||||
try {
|
||||
const response = await Server().post('/note/update', { id: note.key, folder: folderId || null });
|
||||
if (response.data.status !== 'ok') return;
|
||||
emit('reload-notes');
|
||||
clearCacheAndReloadExpanded();
|
||||
} catch (e) {}
|
||||
HideContextMenu();
|
||||
}
|
||||
|
||||
async function createNoteInFolder(folderId) {
|
||||
try {
|
||||
const response = await Server().post('/note/create', { title: 'New note', content: '', campaign: props.campaignId, folder: folderId });
|
||||
if (response.data.status === 'ok') emit('reload-notes');
|
||||
} catch (e) {}
|
||||
function createNoteInFolder(folderId) {
|
||||
CreateWindow('new_note', { campaign: props.campaignId, folder: folderId });
|
||||
}
|
||||
</script>
|
||||
|
||||
@@ -251,10 +291,6 @@ async function createNoteInFolder(folderId) {
|
||||
@reload-notes="clearCacheAndReloadExpanded"
|
||||
@toggle-expanded-folder="toggleExpanded"
|
||||
/>
|
||||
|
||||
<div v-if="expandedFolderIds.includes(folder._id) && folderContentCache[folder._id] !== undefined && (getFolderNotes(folder._id).length === 0 && getFolderSubfolders(folder._id).length === 0)" class="sidebar-state">
|
||||
Empty folder
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
@@ -1,10 +1,16 @@
|
||||
<script setup>
|
||||
import TopSearchBar from './topbar/TopSearchBar.vue';
|
||||
import { useCampaignService } from '~/services/Campaign.js';
|
||||
import { ClearWindow, CreateWindow } from '~/services/Windows';
|
||||
|
||||
const campaignName = computed(() => {
|
||||
return 'Campaign';
|
||||
});
|
||||
const { Campaign } = useCampaignService();
|
||||
const campaignName = computed(() => Campaign.value?.name || 'Campaign');
|
||||
|
||||
function OpenCampaignSettings() {
|
||||
if (!Campaign.value) return;
|
||||
ClearWindow({ type: 'campaign_settings' });
|
||||
CreateWindow('campaign_settings', { campaign: Campaign.value });
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
@@ -18,7 +24,11 @@ const campaignName = computed(() => {
|
||||
<div class="center">
|
||||
<TopSearchBar></TopSearchBar>
|
||||
</div>
|
||||
<div class="right"></div>
|
||||
<div class="right">
|
||||
<button class="btn-primary settings-button sound-click" type="button" @click="OpenCampaignSettings">
|
||||
{{ $t('main-menu.settings') }}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
@@ -40,16 +50,25 @@ const campaignName = computed(() => {
|
||||
left: 6px;
|
||||
}
|
||||
|
||||
.left, .right {
|
||||
.left {
|
||||
flex: 1;
|
||||
}
|
||||
|
||||
.center {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
.right {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
align-items: center;
|
||||
gap: 8px;
|
||||
padding-right: 10px;
|
||||
justify-content: flex-end;
|
||||
flex: 1;
|
||||
padding: 0 10px;
|
||||
}
|
||||
|
||||
.settings-button {
|
||||
padding: 5px 10px;
|
||||
}
|
||||
|
||||
.top-bar-title {
|
||||
|
||||
@@ -5,6 +5,7 @@ import PlusIcon from 'pixelarticons/svg/plus.svg'
|
||||
import NoteSearchResult from './SearchResult.vue';
|
||||
import Server from '~/services/Server';
|
||||
import { emitter } from '~/services/Emitter';
|
||||
import { CreateWindow } from '~/services/Windows';
|
||||
import { register, search as searchActions, execute as executeAction } from '~/services/ActionRegistry';
|
||||
import { useCampaignService } from '~/services/Campaign.js';
|
||||
|
||||
@@ -41,20 +42,10 @@ function registerCreateNoteAction() {
|
||||
id: 'create_note',
|
||||
label: 'New note',
|
||||
description: 'Create a new note in the current campaign',
|
||||
execute: async () => {
|
||||
execute: () => {
|
||||
if (!Campaign.value) return;
|
||||
const campaignId = Campaign.value?._id ?? Campaign.value?.id;
|
||||
try {
|
||||
const response = await Server().post('/note/create', {
|
||||
title: 'New note',
|
||||
content: '',
|
||||
campaign: campaignId
|
||||
});
|
||||
if (response.data.status !== 'ok') return;
|
||||
emitter.emit('note-created', response.data.note);
|
||||
} catch (err) {
|
||||
console.error('[ActionRegistry] Failed to create note:', err);
|
||||
}
|
||||
CreateWindow('new_note', { campaign: campaignId });
|
||||
}
|
||||
};
|
||||
register(action);
|
||||
|
||||
260
frontend/app/components/views/DiscordAuthorize.vue
Normal file
260
frontend/app/components/views/DiscordAuthorize.vue
Normal file
@@ -0,0 +1,260 @@
|
||||
<script setup>
|
||||
import { onMounted, ref } from 'vue';
|
||||
import Server from '~/services/Server';
|
||||
import { GetUser, SetUser } from '~/services/User';
|
||||
import { AddSound } from '~/services/Sound';
|
||||
import Spinner from '../partials/Spinner.vue';
|
||||
|
||||
// Pantalla autònoma que el bot obre des de Discord: l'usuari s'identifica aquí
|
||||
// i autoritza el servidor de Discord que s'ha rebut per la URL.
|
||||
useHead({ title: 'Connect Dragonroll to Discord' });
|
||||
|
||||
const card = ref(null);
|
||||
|
||||
const code = ref('');
|
||||
const guildName = ref('');
|
||||
const discordUserName = ref('');
|
||||
const signedInAs = ref('');
|
||||
const connectedGuild = ref('');
|
||||
|
||||
// 'checking' | 'login' | 'approve' | 'connected' | 'error'
|
||||
const status = ref('checking');
|
||||
const messageKey = ref('');
|
||||
|
||||
const username = ref('');
|
||||
const password = ref('');
|
||||
const busy = ref(false);
|
||||
|
||||
function readCode() {
|
||||
const hash = new URLSearchParams(window.location.hash.slice(1));
|
||||
const search = new URLSearchParams(window.location.search);
|
||||
return hash.get('code') || search.get('code') || '';
|
||||
}
|
||||
|
||||
function ShowError(key) {
|
||||
messageKey.value = key;
|
||||
}
|
||||
|
||||
function PrepareApproval() {
|
||||
const user = GetUser();
|
||||
if (!user) {
|
||||
status.value = 'login';
|
||||
messageKey.value = '';
|
||||
return;
|
||||
}
|
||||
signedInAs.value = user.username || user.name || user.email || 'Dragonroll';
|
||||
status.value = 'approve';
|
||||
messageKey.value = '';
|
||||
}
|
||||
|
||||
async function LoadRequest() {
|
||||
const response = await Server().post('/discord/link/details', { code: code.value });
|
||||
const details = response.data;
|
||||
if (details.status !== 'ok') {
|
||||
status.value = 'error';
|
||||
ShowError('discord.errors.link-expired');
|
||||
return;
|
||||
}
|
||||
|
||||
guildName.value = details.guildName;
|
||||
discordUserName.value = details.discordUserName;
|
||||
PrepareApproval();
|
||||
}
|
||||
|
||||
async function SignIn() {
|
||||
busy.value = true;
|
||||
messageKey.value = '';
|
||||
try {
|
||||
const response = await Server().post('/user/login', {
|
||||
usermail: username.value,
|
||||
password: password.value
|
||||
});
|
||||
|
||||
if (response.data.status !== 'ok' || !response.data.token) {
|
||||
ShowError(response.data.msg || 'discord.errors.sign-in-failed');
|
||||
return;
|
||||
}
|
||||
|
||||
// El token passa al servei d'usuari perquè el client el reutilitzi en autoritzar.
|
||||
SetUser(response.data.token);
|
||||
password.value = '';
|
||||
PrepareApproval();
|
||||
} catch {
|
||||
ShowError('discord.errors.sign-in-failed');
|
||||
} finally {
|
||||
busy.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
async function Authorize() {
|
||||
busy.value = true;
|
||||
try {
|
||||
const response = await Server().post('/discord/link/complete', { code: code.value });
|
||||
|
||||
if (response.data.status !== 'ok') {
|
||||
status.value = 'error';
|
||||
ShowError('discord.errors.link-expired');
|
||||
return;
|
||||
}
|
||||
|
||||
connectedGuild.value = response.data.guildName;
|
||||
status.value = 'connected';
|
||||
messageKey.value = '';
|
||||
// El codi ja s'ha fet servir, treu-lo de la barra d'adreces.
|
||||
window.history.replaceState(null, '', window.location.pathname);
|
||||
} catch (error) {
|
||||
if (error?.response?.status === 401) {
|
||||
status.value = 'login';
|
||||
ShowError('discord.errors.session-expired');
|
||||
return;
|
||||
}
|
||||
status.value = 'error';
|
||||
ShowError('discord.errors.link-expired');
|
||||
} finally {
|
||||
busy.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
onMounted(() => {
|
||||
AddSound(card.value);
|
||||
code.value = readCode();
|
||||
|
||||
if (!code.value) {
|
||||
status.value = 'error';
|
||||
ShowError('discord.errors.missing-code');
|
||||
return;
|
||||
}
|
||||
|
||||
LoadRequest().catch(() => {
|
||||
status.value = 'error';
|
||||
ShowError('discord.errors.internal');
|
||||
});
|
||||
});
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="discord-authorize">
|
||||
<main class="authorize-card" ref="card">
|
||||
<h1>{{ $t('discord.title') }}</h1>
|
||||
|
||||
<p v-if="guildName" class="summary">
|
||||
{{ $t('discord.summary', { guild: guildName, user: discordUserName }) }}
|
||||
</p>
|
||||
<p v-else-if="status !== 'error'" class="summary">
|
||||
<Spinner v-if="status === 'checking'"></Spinner>
|
||||
<span v-else>{{ $t('discord.checking') }}</span>
|
||||
</p>
|
||||
|
||||
<form v-if="status === 'login'" v-on:submit.prevent="SignIn">
|
||||
<p>{{ $t('discord.sign-in-lead') }}</p>
|
||||
<div class="form-field">
|
||||
<label for="discord-authorize-usermail">{{ $t('login.username') }}</label>
|
||||
<input
|
||||
id="discord-authorize-usermail"
|
||||
type="text"
|
||||
:placeholder="$t('login.username-placeholder')"
|
||||
name="usermail"
|
||||
autocomplete="username"
|
||||
v-model="username"
|
||||
required
|
||||
>
|
||||
</div>
|
||||
<div class="form-field">
|
||||
<label for="discord-authorize-password">{{ $t('login.password') }}</label>
|
||||
<input
|
||||
id="discord-authorize-password"
|
||||
type="password"
|
||||
name="password"
|
||||
autocomplete="current-password"
|
||||
v-model="password"
|
||||
required
|
||||
>
|
||||
</div>
|
||||
<button class="btn-primary sound-click" type="submit" :disabled="busy">
|
||||
<Spinner v-if="busy"></Spinner>
|
||||
<span v-else>{{ $t('login.log-in') }}</span>
|
||||
</button>
|
||||
</form>
|
||||
|
||||
<section v-if="status === 'approve'">
|
||||
<p>{{ $t('discord.signed-in-as', { user: signedInAs }) }}</p>
|
||||
<p class="hint">{{ $t('discord.next-step') }}</p>
|
||||
<p class="hint">{{ $t('discord.replace-warning') }}</p>
|
||||
<button class="btn-primary sound-click" type="button" :disabled="busy" v-on:click="Authorize">
|
||||
<Spinner v-if="busy"></Spinner>
|
||||
<span v-else>{{ $t('discord.approve') }}</span>
|
||||
</button>
|
||||
</section>
|
||||
|
||||
<section v-if="status === 'connected'">
|
||||
<p class="success">{{ $t('discord.connected', { guild: connectedGuild }) }}</p>
|
||||
<p class="hint">{{ $t('discord.next-step') }}</p>
|
||||
</section>
|
||||
|
||||
<p v-if="messageKey" class="error" role="status">
|
||||
{{ $t(messageKey) }}
|
||||
</p>
|
||||
</main>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.discord-authorize {
|
||||
display: grid;
|
||||
place-items: center;
|
||||
width: 100%;
|
||||
min-height: 100vh;
|
||||
padding: 24px;
|
||||
box-sizing: border-box;
|
||||
background-color: var(--color-background);
|
||||
color: var(--color-text);
|
||||
}
|
||||
|
||||
.authorize-card {
|
||||
width: min(100%, 460px);
|
||||
padding: 28px;
|
||||
box-sizing: border-box;
|
||||
background-color: var(--color-window-background);
|
||||
border: 1px solid var(--color-window-border);
|
||||
border-radius: 12px;
|
||||
box-shadow: 0 8px 24px var(--color-window-shadow);
|
||||
text-align: center;
|
||||
user-select: none;
|
||||
}
|
||||
|
||||
.authorize-card h1 {
|
||||
margin-top: 0;
|
||||
font-family: 'MrEavesRemake', serif;
|
||||
font-size: 1.5rem;
|
||||
}
|
||||
|
||||
.authorize-card p {
|
||||
line-height: 1.5;
|
||||
}
|
||||
|
||||
.summary {
|
||||
color: var(--color-gray);
|
||||
}
|
||||
|
||||
form,
|
||||
section {
|
||||
margin-top: 18px;
|
||||
}
|
||||
|
||||
.hint {
|
||||
color: var(--color-gray);
|
||||
font-size: 0.95rem;
|
||||
}
|
||||
|
||||
.success {
|
||||
color: var(--color-green);
|
||||
}
|
||||
|
||||
.error {
|
||||
color: var(--color-red);
|
||||
}
|
||||
|
||||
button {
|
||||
width: 100%;
|
||||
}
|
||||
</style>
|
||||
356
frontend/app/components/windows/CampaignSettingsWindow.vue
Normal file
356
frontend/app/components/windows/CampaignSettingsWindow.vue
Normal file
@@ -0,0 +1,356 @@
|
||||
<script setup>
|
||||
import { onBeforeUnmount, onMounted, ref } from 'vue';
|
||||
import WindowHandle from './partials/WindowHandle.vue';
|
||||
import Tabs from '../layouts/Tabs.vue';
|
||||
import { SetupHandle, SetSize, ResetPosition, Top, SetResizable, SetMinSize } from '@/services/Windows';
|
||||
import Server from '~/services/Server';
|
||||
import { DisplayToast } from '~/services/Toaster';
|
||||
|
||||
const props = defineProps(['data']);
|
||||
const data = props.data;
|
||||
const campaign = data.campaign;
|
||||
|
||||
const handle = ref(null);
|
||||
const wrapper = ref(null);
|
||||
const saving = ref(false);
|
||||
const name = ref(campaign.name || '');
|
||||
const color = ref(campaign.color || '#6b6b6b');
|
||||
const settings = ref(campaign.settings && typeof campaign.settings === 'object' ? campaign.settings : {});
|
||||
const foundryUrl = ref(settings.value.integrations?.foundryUrl || '');
|
||||
const pairingCode = ref('');
|
||||
const requestId = ref('');
|
||||
const linking = ref(false);
|
||||
const id = data.id;
|
||||
let statusPoll;
|
||||
let checkingStatus = false;
|
||||
|
||||
const rows = [
|
||||
{ id: 'basic', value: 'campaigns.settings.tabs.basic' },
|
||||
{ id: 'integrations', value: 'campaigns.settings.tabs.integrations' }
|
||||
];
|
||||
|
||||
onMounted(() => {
|
||||
Top(wrapper);
|
||||
SetupHandle(id, handle);
|
||||
SetSize(id, { width: 560, height: 430 });
|
||||
ResetPosition(id, 'center');
|
||||
SetResizable(id, true);
|
||||
SetMinSize(id, { width: 440, height: 340 });
|
||||
ResumePendingFoundryLink();
|
||||
});
|
||||
|
||||
onBeforeUnmount(() => {
|
||||
clearInterval(statusPoll);
|
||||
});
|
||||
|
||||
function ApplyCampaignUpdate(updatedCampaign) {
|
||||
Object.assign(campaign, updatedCampaign);
|
||||
settings.value = updatedCampaign.settings || {};
|
||||
foundryUrl.value = settings.value.integrations?.foundryUrl || foundryUrl.value;
|
||||
}
|
||||
|
||||
function validFoundryUrl(value) {
|
||||
if (!value.trim()) return true;
|
||||
try {
|
||||
const url = new URL(value.trim());
|
||||
return url.protocol === 'http:' || url.protocol === 'https:';
|
||||
} catch {
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
async function SaveSettings() {
|
||||
if (!name.value.trim()) {
|
||||
DisplayToast('red', $t('campaigns.settings.errors.name-required'), 3000);
|
||||
return;
|
||||
}
|
||||
if (!validFoundryUrl(foundryUrl.value)) {
|
||||
DisplayToast('red', $t('campaigns.settings.errors.invalid-foundry-url'), 3000);
|
||||
return;
|
||||
}
|
||||
|
||||
saving.value = true;
|
||||
const updatedSettings = {
|
||||
...settings.value,
|
||||
integrations: {
|
||||
...(settings.value.integrations || {}),
|
||||
foundryUrl: foundryUrl.value.trim()
|
||||
}
|
||||
};
|
||||
|
||||
try {
|
||||
const response = await Server().post('/campaign/update', {
|
||||
id: campaign._id,
|
||||
name: name.value.trim(),
|
||||
color: color.value,
|
||||
settings: updatedSettings
|
||||
});
|
||||
|
||||
if (response.data.status !== 'ok') {
|
||||
DisplayToast('red', $t(response.data.msg || 'errors.internal'), 3000);
|
||||
return;
|
||||
}
|
||||
|
||||
ApplyCampaignUpdate(response.data.campaign);
|
||||
DisplayToast('green', $t('campaigns.settings.saved'), 3000);
|
||||
} catch {
|
||||
DisplayToast('red', $t('errors.internal'), 3000);
|
||||
} finally {
|
||||
saving.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
async function StartFoundryLink() {
|
||||
linking.value = true;
|
||||
try {
|
||||
const response = await Server().post('/campaign/foundry-link/start', { campaignId: campaign._id });
|
||||
if (response.data.status !== 'ok') {
|
||||
DisplayToast('red', $t(response.data.msg || 'errors.internal'), 3000);
|
||||
return;
|
||||
}
|
||||
|
||||
pairingCode.value = response.data.code;
|
||||
requestId.value = response.data.requestId;
|
||||
clearInterval(statusPoll);
|
||||
statusPoll = setInterval(CheckFoundryLinkStatus, 2500);
|
||||
} catch {
|
||||
DisplayToast('red', $t('errors.internal'), 3000);
|
||||
} finally {
|
||||
linking.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
// The pairing code lives server-side until it expires, so re-attach to it when
|
||||
// the window opens again after a reload, restart or closing the window.
|
||||
async function ResumePendingFoundryLink() {
|
||||
try {
|
||||
const response = await Server().get(`/campaign/foundry-link/pending?campaignId=${campaign._id}`);
|
||||
if (response.data.status !== 'ok' || !response.data.request) return;
|
||||
|
||||
pairingCode.value = response.data.request.code || '';
|
||||
requestId.value = response.data.request.requestId;
|
||||
clearInterval(statusPoll);
|
||||
statusPoll = setInterval(CheckFoundryLinkStatus, 2500);
|
||||
} catch {
|
||||
// Showing the stored pairing code is best-effort; ignore resume failures.
|
||||
}
|
||||
}
|
||||
|
||||
async function CheckFoundryLinkStatus() {
|
||||
if (!requestId.value || checkingStatus) return;
|
||||
checkingStatus = true;
|
||||
try {
|
||||
const response = await Server().get(`/campaign/foundry-link/status/${requestId.value}`);
|
||||
if (response.data.status !== 'ok' || response.data.state === 'expired') {
|
||||
clearInterval(statusPoll);
|
||||
pairingCode.value = '';
|
||||
requestId.value = '';
|
||||
const error = response.data.state === 'expired'
|
||||
? 'campaigns.settings.errors.link-expired'
|
||||
: response.data.msg || 'campaigns.settings.errors.link-expired';
|
||||
DisplayToast('red', $t(error), 3000);
|
||||
return;
|
||||
}
|
||||
if (response.data.state === 'complete') {
|
||||
ApplyCampaignUpdate(response.data.campaign);
|
||||
clearInterval(statusPoll);
|
||||
pairingCode.value = '';
|
||||
requestId.value = '';
|
||||
DisplayToast('green', $t('campaigns.settings.linked'), 3000);
|
||||
}
|
||||
} catch {
|
||||
// Keep polling while the Foundry module completes the pairing.
|
||||
} finally {
|
||||
checkingStatus = false;
|
||||
}
|
||||
}
|
||||
|
||||
async function UnlinkFoundry() {
|
||||
linking.value = true;
|
||||
try {
|
||||
const response = await Server().post('/campaign/foundry-unlink', { campaignId: campaign._id });
|
||||
if (response.data.status !== 'ok') {
|
||||
DisplayToast('red', $t(response.data.msg || 'errors.internal'), 3000);
|
||||
return;
|
||||
}
|
||||
|
||||
ApplyCampaignUpdate(response.data.campaign);
|
||||
DisplayToast('green', $t('campaigns.settings.unlinked'), 3000);
|
||||
} catch {
|
||||
DisplayToast('red', $t('errors.internal'), 3000);
|
||||
} finally {
|
||||
linking.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
async function CopyPairingCode() {
|
||||
try {
|
||||
await navigator.clipboard.writeText(pairingCode.value);
|
||||
DisplayToast('green', $t('campaigns.settings.code-copied'), 2000);
|
||||
} catch {
|
||||
DisplayToast('red', $t('campaigns.settings.errors.copy-code'), 3000);
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="window-wrapper" :id="'window-wrapper-' + id" ref="wrapper">
|
||||
<WindowHandle :window="id" ref="handle"></WindowHandle>
|
||||
|
||||
<div class="settings-body">
|
||||
<Tabs :rows="rows">
|
||||
<template #basic>
|
||||
<div class="settings-fields">
|
||||
<label class="field">
|
||||
<span>{{ $t('campaigns.settings.name') }}</span>
|
||||
<input v-model="name" type="text" maxlength="120" autocomplete="off">
|
||||
</label>
|
||||
<label class="field color-field">
|
||||
<span>{{ $t('campaigns.settings.color') }}</span>
|
||||
<input v-model="color" type="color">
|
||||
</label>
|
||||
</div>
|
||||
</template>
|
||||
<template #integrations>
|
||||
<div class="settings-fields">
|
||||
<div class="world-link">
|
||||
<div v-if="campaign.foundryWorldId" class="linked-world">
|
||||
<strong>{{ campaign.foundryWorldTitle || campaign.foundryWorldId }}</strong>
|
||||
<span v-if="campaign.foundrySystem">{{ campaign.foundrySystem }}</span>
|
||||
<button class="btn-primary sound-click" type="button" :disabled="linking" @click="UnlinkFoundry">
|
||||
{{ $t('campaigns.settings.unlink-foundry') }}
|
||||
</button>
|
||||
</div>
|
||||
<p v-else class="help-text standalone">{{ $t('campaigns.settings.no-foundry-world') }}</p>
|
||||
|
||||
<button class="btn-primary sound-click" type="button" :disabled="linking" @click="StartFoundryLink">
|
||||
{{ $t('campaigns.settings.start-foundry-link') }}
|
||||
</button>
|
||||
<p class="help-text standalone">{{ $t('campaigns.settings.start-foundry-link-help') }}</p>
|
||||
<div v-if="pairingCode" class="pairing-code">
|
||||
<code>{{ pairingCode }}</code>
|
||||
<button class="btn-primary sound-click" type="button" @click="CopyPairingCode">
|
||||
{{ $t('campaigns.settings.copy-code') }}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<label class="field">
|
||||
<span>{{ $t('campaigns.settings.foundry-url') }}</span>
|
||||
<input
|
||||
v-model="foundryUrl"
|
||||
type="url"
|
||||
placeholder="https://foundry.example.com"
|
||||
autocomplete="url"
|
||||
>
|
||||
</label>
|
||||
<p class="help-text">{{ $t('campaigns.settings.foundry-url-help') }}</p>
|
||||
</div>
|
||||
</template>
|
||||
</Tabs>
|
||||
<div class="actions">
|
||||
<button class="btn-primary sound-click" type="button" :disabled="saving" @click="SaveSettings">
|
||||
{{ saving ? $t('campaigns.settings.saving') : $t('general.save') }}
|
||||
</button>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped lang="scss">
|
||||
.window-wrapper {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
align-items: center;
|
||||
}
|
||||
|
||||
.settings-body {
|
||||
display: flex;
|
||||
flex: 1;
|
||||
flex-direction: column;
|
||||
min-height: 0;
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.settings-fields {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 18px;
|
||||
padding: 22px;
|
||||
}
|
||||
|
||||
.field {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 6px;
|
||||
}
|
||||
|
||||
input {
|
||||
width: 100%;
|
||||
box-sizing: border-box;
|
||||
padding: 8px 10px;
|
||||
border: 1px solid var(--color-border);
|
||||
border-radius: 6px;
|
||||
background: var(--color-background-soft);
|
||||
color: var(--color-text);
|
||||
font-size: 14px;
|
||||
}
|
||||
|
||||
.color-field input {
|
||||
width: 72px;
|
||||
height: 38px;
|
||||
padding: 3px;
|
||||
}
|
||||
|
||||
.help-text {
|
||||
margin: -10px 22px 0;
|
||||
color: var(--color-text);
|
||||
font-size: 13px;
|
||||
opacity: 0.75;
|
||||
}
|
||||
|
||||
.help-text.standalone {
|
||||
margin: 0;
|
||||
}
|
||||
|
||||
.world-link {
|
||||
display: flex;
|
||||
flex-direction: column;
|
||||
gap: 10px;
|
||||
padding-bottom: 14px;
|
||||
border-bottom: 1px solid var(--color-border);
|
||||
}
|
||||
|
||||
.linked-world {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
gap: 10px;
|
||||
flex-wrap: wrap;
|
||||
}
|
||||
|
||||
.linked-world span {
|
||||
opacity: 0.75;
|
||||
}
|
||||
|
||||
.pairing-code {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
justify-content: space-between;
|
||||
gap: 10px;
|
||||
padding: 10px;
|
||||
border: 1px solid var(--color-border);
|
||||
border-radius: 6px;
|
||||
}
|
||||
|
||||
.pairing-code code {
|
||||
user-select: text;
|
||||
overflow-wrap: anywhere;
|
||||
}
|
||||
|
||||
.actions {
|
||||
display: flex;
|
||||
justify-content: flex-end;
|
||||
padding: 12px 18px;
|
||||
border-top: 1px solid var(--color-border);
|
||||
}
|
||||
</style>
|
||||
399
frontend/app/components/windows/CharacterSheetWindow.vue
Normal file
399
frontend/app/components/windows/CharacterSheetWindow.vue
Normal file
@@ -0,0 +1,399 @@
|
||||
<script setup>
|
||||
import { computed, onBeforeUnmount, onMounted, ref } from 'vue';
|
||||
import { SetupHandle, SetSize, ResetPosition, ClearWindow, Top } from '@/services/Windows';
|
||||
import WindowHandle from './partials/WindowHandle.vue';
|
||||
import Server, { getBaseUrl } from '~/services/Server';
|
||||
import { emitter } from '~/services/Emitter';
|
||||
import { useI18n } from 'vue-i18n';
|
||||
|
||||
const props = defineProps(['data']);
|
||||
const id = props.data.id;
|
||||
const actorId = props.data.actor?._id;
|
||||
const handle = ref(null);
|
||||
const wrapper = ref(null);
|
||||
const editing = ref(false);
|
||||
const saving = ref(false);
|
||||
const error = ref('');
|
||||
const original = ref(null);
|
||||
const photoInput = ref(null);
|
||||
const uploadingPhoto = ref(false);
|
||||
const { t } = useI18n();
|
||||
|
||||
const abilityStats = [
|
||||
{ key: 'str', label: 'STR' }, { key: 'dex', label: 'DEX' }, { key: 'con', label: 'CON' },
|
||||
{ key: 'int', label: 'INT' }, { key: 'wis', label: 'WIS' }, { key: 'cha', label: 'CHA' }
|
||||
];
|
||||
|
||||
function normalizeActor(actor) {
|
||||
return {
|
||||
name: actor?.name ?? '',
|
||||
species: actor?.species ?? '',
|
||||
className: actor?.className ?? '',
|
||||
subclass: actor?.subclass ?? '',
|
||||
level: Number(actor?.level ?? 1),
|
||||
abilityScores: Object.fromEntries(abilityStats.map(({ key }) => [key, Number(actor?.abilityScores?.[key] ?? 10)])),
|
||||
armorClass: Number(actor?.armorClass ?? 10),
|
||||
speed: Number(actor?.speed ?? 30),
|
||||
proficiencies: actor?.proficiencies ?? '',
|
||||
inventory: (actor?.inventory ?? []).map((item) => ({
|
||||
name: item.name ?? '', quantity: Number(item.quantity ?? 1), weight: Number(item.weight ?? 0)
|
||||
})),
|
||||
traits: actor?.traits ?? '',
|
||||
spells: actor?.spells ?? '',
|
||||
image: actor?.image ?? ''
|
||||
};
|
||||
}
|
||||
|
||||
const form = ref(normalizeActor(props.data.actor));
|
||||
original.value = normalizeActor(props.data.actor);
|
||||
|
||||
onMounted(() => {
|
||||
Top(wrapper);
|
||||
SetupHandle(id, handle);
|
||||
SetSize(id, {
|
||||
width: Math.max(320, Math.min(900, window.innerWidth - 24)),
|
||||
height: Math.max(360, Math.min(700, window.innerHeight - 32))
|
||||
});
|
||||
ResetPosition(id, 'center');
|
||||
});
|
||||
|
||||
onBeforeUnmount(() => ClearWindow({ type: 'character_sheet' }));
|
||||
|
||||
function handleActorSync({ entityType, entry }) {
|
||||
if (entityType !== 'actor' || entry?._id !== actorId || editing.value) return;
|
||||
form.value = normalizeActor(entry);
|
||||
original.value = normalizeActor(entry);
|
||||
}
|
||||
|
||||
onMounted(() => emitter.on('campaign-entry-updated', handleActorSync));
|
||||
onBeforeUnmount(() => emitter.off('campaign-entry-updated', handleActorSync));
|
||||
|
||||
const proficiencyBonus = computed(() => Math.ceil(form.value.level / 4) + 1);
|
||||
const carryingCapacity = computed(() => form.value.abilityScores.str * 15);
|
||||
const carriedWeight = computed(() => form.value.inventory.reduce((total, item) => total + (Number(item.quantity) || 0) * (Number(item.weight) || 0), 0));
|
||||
const carryPercent = computed(() => Math.min(100, carryingCapacity.value ? (carriedWeight.value / carryingCapacity.value) * 100 : 0));
|
||||
|
||||
function abilityModifier(score) {
|
||||
const modifier = Math.floor((Number(score) - 10) / 2);
|
||||
return modifier >= 0 ? `+${modifier}` : String(modifier);
|
||||
}
|
||||
|
||||
const imageUrl = computed(() => {
|
||||
if (!form.value.image) return '';
|
||||
return /^(https?:|data:|\/\/)/i.test(form.value.image)
|
||||
? form.value.image
|
||||
: `${getBaseUrl()}/public/${form.value.image}`;
|
||||
});
|
||||
|
||||
function pickPhoto() {
|
||||
photoInput.value?.click();
|
||||
}
|
||||
|
||||
async function onPhotoSelected(event) {
|
||||
const file = event.target.files?.[0];
|
||||
event.target.value = '';
|
||||
if (!file || uploadingPhoto.value) return;
|
||||
uploadingPhoto.value = true;
|
||||
error.value = '';
|
||||
try {
|
||||
const formData = new FormData();
|
||||
formData.append('image', file);
|
||||
const response = await Server().post(`/actor/upload-image?actor=${actorId}`, formData, {
|
||||
headers: { "Content-Type": "multipart/form-data" }
|
||||
});
|
||||
if (response.data.status !== 'ok') {
|
||||
error.value = t('campaigns.character-sheet.photo-error');
|
||||
return;
|
||||
}
|
||||
// La foto es desa immediatament: manté original intacte perquè cancel·lar no la perdi
|
||||
form.value.image = response.data.actor?.image ?? form.value.image;
|
||||
original.value.image = form.value.image;
|
||||
emitter.emit('campaign-entry-updated', { entityType: 'actor', entry: response.data.actor });
|
||||
} catch (requestError) {
|
||||
error.value = t('campaigns.character-sheet.photo-error');
|
||||
} finally {
|
||||
uploadingPhoto.value = false;
|
||||
}
|
||||
}
|
||||
|
||||
function removePhoto() {
|
||||
form.value.image = '';
|
||||
}
|
||||
|
||||
function startEditing() {
|
||||
editing.value = true;
|
||||
error.value = '';
|
||||
}
|
||||
|
||||
function cancelEditing() {
|
||||
form.value = normalizeActor(original.value);
|
||||
editing.value = false;
|
||||
error.value = '';
|
||||
}
|
||||
|
||||
function addInventoryItem() {
|
||||
form.value.inventory.push({ name: '', quantity: 1, weight: 0 });
|
||||
}
|
||||
|
||||
function removeInventoryItem(index) {
|
||||
form.value.inventory.splice(index, 1);
|
||||
}
|
||||
|
||||
async function saveSheet() {
|
||||
if (!form.value.name.trim() || saving.value) return;
|
||||
saving.value = true;
|
||||
error.value = '';
|
||||
try {
|
||||
const payload = {
|
||||
id: actorId,
|
||||
...form.value,
|
||||
inventory: form.value.inventory.filter((item) => item.name.trim())
|
||||
};
|
||||
const response = await Server().post('/actor/update', payload);
|
||||
if (response.data.status !== 'ok') {
|
||||
error.value = t('campaigns.character-sheet.save-error');
|
||||
return;
|
||||
}
|
||||
original.value = normalizeActor(response.data.actor);
|
||||
form.value = normalizeActor(response.data.actor);
|
||||
editing.value = false;
|
||||
emitter.emit('campaign-entry-updated', { entityType: 'actor', entry: response.data.actor });
|
||||
} catch (requestError) {
|
||||
error.value = t('campaigns.character-sheet.save-error');
|
||||
} finally {
|
||||
saving.value = false;
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="window-wrapper sheet-window" :id="'window-wrapper-' + id" ref="wrapper">
|
||||
<WindowHandle :window="id" ref="handle" />
|
||||
<div class="sheet-body">
|
||||
<header class="sheet-hero">
|
||||
<div class="character-mark" aria-hidden="true">{{ form.name.slice(0, 1).toUpperCase() }}</div>
|
||||
<div class="character-identity">
|
||||
<input v-if="editing" v-model="form.name" class="character-name-input" required :aria-label="$t('campaigns.character-sheet.name')">
|
||||
<h1 v-else>{{ form.name }}</h1>
|
||||
<div class="identity-fields">
|
||||
<label v-if="editing" class="identity-field">
|
||||
<span>{{ $t('campaigns.character-sheet.class') }}</span><input v-model="form.className">
|
||||
</label>
|
||||
<span v-else class="identity-tag">{{ form.className || $t('campaigns.character-sheet.unset-class') }}</span>
|
||||
<label v-if="editing" class="identity-field">
|
||||
<span>{{ $t('campaigns.character-sheet.subclass') }}</span><input v-model="form.subclass">
|
||||
</label>
|
||||
<span v-else-if="form.subclass" class="identity-tag">{{ form.subclass }}</span>
|
||||
<label v-if="editing" class="identity-field level-field">
|
||||
<span>{{ $t('campaigns.character-sheet.level') }}</span><input v-model.number="form.level" type="number" min="1" max="20">
|
||||
</label>
|
||||
<span v-else class="identity-tag">{{ $t('campaigns.character-sheet.level') }} {{ form.level }}</span>
|
||||
<label v-if="editing" class="identity-field">
|
||||
<span>{{ $t('campaigns.character-sheet.species') }}</span><input v-model="form.species">
|
||||
</label>
|
||||
<span v-else class="identity-tag">{{ form.species || $t('campaigns.character-sheet.unset-species') }}</span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="sheet-actions">
|
||||
<button v-if="!editing" class="sheet-button" type="button" @click="startEditing">{{ $t('campaigns.character-sheet.edit') }}</button>
|
||||
<template v-else>
|
||||
<button class="sheet-button secondary" type="button" @click="cancelEditing">{{ $t('campaigns.character-sheet.cancel') }}</button>
|
||||
<button class="sheet-button primary" type="button" :disabled="saving" @click="saveSheet">
|
||||
{{ saving ? $t('campaigns.character-sheet.saving') : $t('campaigns.character-sheet.save') }}
|
||||
</button>
|
||||
</template>
|
||||
</div>
|
||||
</header>
|
||||
|
||||
<div v-if="error" class="sheet-error">{{ error }}</div>
|
||||
|
||||
<main class="sheet-grid">
|
||||
<div v-if="form.image || editing" class="sheet-portrait" :class="{ empty: !form.image }">
|
||||
<img v-if="form.image" :src="imageUrl" :alt="$t('campaigns.character-sheet.photo')">
|
||||
<button v-if="editing && !form.image" class="portrait-upload" type="button" :disabled="uploadingPhoto" @click="pickPhoto">
|
||||
{{ uploadingPhoto ? $t('campaigns.character-sheet.uploading-photo') : $t('campaigns.character-sheet.upload-photo') }}
|
||||
</button>
|
||||
<div v-if="editing && form.image" class="portrait-controls">
|
||||
<button type="button" :disabled="uploadingPhoto" @click="pickPhoto">
|
||||
{{ uploadingPhoto ? $t('campaigns.character-sheet.uploading-photo') : $t('campaigns.character-sheet.change-photo') }}
|
||||
</button>
|
||||
<button type="button" :disabled="uploadingPhoto" :aria-label="$t('campaigns.character-sheet.remove-photo')" @click="removePhoto">×</button>
|
||||
</div>
|
||||
<input ref="photoInput" class="photo-input" type="file" accept="image/*" @change="onPhotoSelected">
|
||||
</div>
|
||||
|
||||
<section class="sheet-panel abilities-panel">
|
||||
<h2>{{ $t('campaigns.character-sheet.ability-scores') }}</h2>
|
||||
<div class="ability-grid">
|
||||
<div v-for="stat in abilityStats" :key="stat.key" class="ability-card">
|
||||
<span class="ability-label">{{ stat.label }}</span>
|
||||
<input v-if="editing" v-model.number="form.abilityScores[stat.key]" type="number" min="1" max="30" :aria-label="stat.label">
|
||||
<strong v-else class="ability-score">{{ form.abilityScores[stat.key] }}</strong>
|
||||
<span class="ability-modifier">{{ abilityModifier(form.abilityScores[stat.key]) }}</span>
|
||||
</div>
|
||||
</div>
|
||||
<div class="proficiency-badge">
|
||||
<span>{{ $t('campaigns.character-sheet.proficiency-bonus') }}</span>
|
||||
<strong>+{{ proficiencyBonus }}</strong>
|
||||
</div>
|
||||
</section>
|
||||
|
||||
<section class="sheet-panel combat-panel">
|
||||
<h2>{{ $t('campaigns.character-sheet.combat') }}</h2>
|
||||
<div class="combat-stats">
|
||||
<div class="combat-stat">
|
||||
<span>{{ $t('campaigns.character-sheet.armor-class') }}</span>
|
||||
<input v-if="editing" v-model.number="form.armorClass" type="number" min="0">
|
||||
<strong v-else>{{ form.armorClass }}</strong>
|
||||
</div>
|
||||
<div class="combat-stat">
|
||||
<span>{{ $t('campaigns.character-sheet.speed') }}</span>
|
||||
<label v-if="editing" class="number-with-unit"><input v-model.number="form.speed" type="number" min="0"><small>ft</small></label>
|
||||
<strong v-else>{{ form.speed }} <small>ft</small></strong>
|
||||
</div>
|
||||
</div>
|
||||
<h3>{{ $t('campaigns.character-sheet.proficiencies') }}</h3>
|
||||
<textarea v-if="editing" v-model="form.proficiencies" rows="5" :placeholder="$t('campaigns.character-sheet.proficiencies-placeholder')" />
|
||||
<p v-else class="sheet-copy">{{ form.proficiencies || $t('campaigns.character-sheet.empty-proficiencies') }}</p>
|
||||
</section>
|
||||
|
||||
<section class="sheet-panel traits-panel">
|
||||
<h2>{{ $t('campaigns.character-sheet.traits') }}</h2>
|
||||
<textarea v-if="editing" v-model="form.traits" rows="5" :placeholder="$t('campaigns.character-sheet.traits-placeholder')" />
|
||||
<p v-else class="sheet-copy">{{ form.traits || $t('campaigns.character-sheet.empty-traits') }}</p>
|
||||
</section>
|
||||
|
||||
<section class="sheet-panel spells-panel">
|
||||
<h2>{{ $t('campaigns.character-sheet.spells') }}</h2>
|
||||
<textarea v-if="editing" v-model="form.spells" rows="5" :placeholder="$t('campaigns.character-sheet.spells-placeholder')" />
|
||||
<p v-else class="sheet-copy">{{ form.spells || $t('campaigns.character-sheet.empty-spells') }}</p>
|
||||
</section>
|
||||
|
||||
<section class="sheet-panel inventory-panel">
|
||||
<div class="panel-title-row">
|
||||
<h2>{{ $t('campaigns.character-sheet.inventory') }}</h2>
|
||||
<button v-if="editing" class="sheet-button secondary compact" type="button" @click="addInventoryItem">{{ $t('campaigns.character-sheet.add-item') }}</button>
|
||||
</div>
|
||||
<div class="weight-summary">
|
||||
<span>{{ $t('campaigns.character-sheet.carried-weight') }}</span>
|
||||
<strong>{{ carriedWeight.toFixed(1) }} / {{ carryingCapacity }} lb</strong>
|
||||
</div>
|
||||
<div class="weight-track"><div class="weight-fill" :style="{ width: `${carryPercent}%` }" /></div>
|
||||
<div class="inventory-table-wrap">
|
||||
<table class="inventory-table">
|
||||
<thead><tr>
|
||||
<th>{{ $t('campaigns.character-sheet.item-name') }}</th>
|
||||
<th>{{ $t('campaigns.character-sheet.quantity') }}</th>
|
||||
<th>{{ $t('campaigns.character-sheet.weight-each') }}</th>
|
||||
<th>{{ $t('campaigns.character-sheet.total-weight') }}</th>
|
||||
<th v-if="editing"><span class="sr-only">{{ $t('campaigns.character-sheet.actions') }}</span></th>
|
||||
</tr></thead>
|
||||
<tbody>
|
||||
<tr v-for="(item, index) in form.inventory" :key="index">
|
||||
<td><input v-if="editing" v-model="item.name" :aria-label="$t('campaigns.character-sheet.item-name')"><span v-else>{{ item.name }}</span></td>
|
||||
<td><input v-if="editing" v-model.number="item.quantity" type="number" min="1" :aria-label="$t('campaigns.character-sheet.quantity')"><span v-else>{{ item.quantity }}</span></td>
|
||||
<td><input v-if="editing" v-model.number="item.weight" type="number" min="0" step="0.1" :aria-label="$t('campaigns.character-sheet.weight-each')"><span v-else>{{ Number(item.weight).toFixed(1) }} lb</span></td>
|
||||
<td>{{ ((Number(item.quantity) || 0) * (Number(item.weight) || 0)).toFixed(1) }} lb</td>
|
||||
<td v-if="editing"><button class="remove-item" type="button" @click="removeInventoryItem(index)">×</button></td>
|
||||
</tr>
|
||||
<tr v-if="form.inventory.length === 0"><td :colspan="editing ? 5 : 4" class="empty-inventory">{{ $t('campaigns.character-sheet.empty-inventory') }}</td></tr>
|
||||
</tbody>
|
||||
</table>
|
||||
</div>
|
||||
</section>
|
||||
</main>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.sheet-window { min-width: 0; min-height: 0; }
|
||||
.sheet-body { width: 100%; min-height: 0; flex: 1; overflow: auto; padding: 16px; box-sizing: border-box; }
|
||||
.sheet-hero { display: flex; align-items: center; gap: 14px; padding: 4px 2px 16px; margin-bottom: 12px; border-bottom: 1px solid var(--color-border); }
|
||||
.character-mark { width: 56px; height: 56px; flex: 0 0 56px; display: grid; place-items: center; border-radius: 12px; background: var(--color-background-soft); color: var(--color-link); border: 1px solid var(--color-border); font: 28px MrEavesRemake; }
|
||||
.character-identity { flex: 1; min-width: 0; }
|
||||
.character-identity h1 { margin: 0 0 7px; font: 28px MrEavesRemake; overflow-wrap: anywhere; }
|
||||
.character-name-input { width: min(100%, 440px); font-size: 24px !important; font-family: MrEavesRemake !important; }
|
||||
.identity-fields { display: flex; align-items: center; flex-wrap: wrap; gap: 7px; }
|
||||
.identity-tag { padding: 4px 9px; border: 1px solid var(--color-border); border-radius: 999px; background: var(--color-background-soft); font-size: 12px; opacity: .9; }
|
||||
.identity-field { display: flex; align-items: center; gap: 5px; font-size: 11px; opacity: .8; }
|
||||
.identity-field input { width: 106px; }
|
||||
.identity-field.level-field input { width: 58px; }
|
||||
.sheet-actions { display: flex; align-items: center; gap: 7px; }
|
||||
.sheet-button { border: 1px solid var(--color-border); border-radius: 7px; padding: 7px 12px; background: var(--color-background-soft); color: var(--color-text); cursor: pointer; white-space: nowrap; }
|
||||
.sheet-button:hover { background: var(--color-button-hover); }
|
||||
.sheet-button.primary { background: var(--color-link); color: var(--color-background); border-color: var(--color-link); }
|
||||
.sheet-button:disabled { opacity: .55; cursor: wait; }
|
||||
.sheet-button.compact { padding: 5px 9px; font-size: 12px; }
|
||||
.sheet-grid { display: grid; grid-template-columns: minmax(200px, 34%) minmax(0, 1fr) minmax(0, 1fr); grid-template-rows: auto auto auto auto; gap: 11px; align-items: start; }
|
||||
.sheet-panel { min-width: 0; padding: 13px; border: 1px solid var(--color-border); border-radius: 10px; background: var(--color-background-light); box-shadow: 0 3px 12px var(--color-window-shadow); }
|
||||
.sheet-panel h2 { margin: 0 0 12px; padding-bottom: 7px; border-bottom: 1px solid var(--color-border); font: 17px MrEavesRemake; letter-spacing: .03em; }
|
||||
.sheet-panel h3 { margin: 13px 0 7px; font: 14px MrEavesRemake; }
|
||||
.sheet-portrait { grid-column: 1; grid-row: 1 / -1; position: relative; overflow: hidden; border: 1px solid var(--color-border); border-radius: 10px; background: var(--color-background-soft); }
|
||||
.sheet-portrait.empty { display: grid; place-items: center; min-height: 220px; border-style: dashed; }
|
||||
.sheet-portrait img { display: block; width: 100%; height: auto; }
|
||||
.portrait-upload { border: 0; padding: 8px 10px; background: transparent; color: var(--color-link); font-size: 12px; cursor: pointer; }
|
||||
.portrait-controls { position: absolute; inset: auto 0 0 0; display: flex; align-items: center; justify-content: space-between; gap: 6px; padding: 6px 7px; background: var(--color-background-soft); border-top: 1px solid var(--color-border); }
|
||||
.portrait-controls button { border: 1px solid var(--color-border); border-radius: 6px; padding: 4px 9px; background: var(--color-background-light); color: var(--color-text); font-size: 11px; cursor: pointer; }
|
||||
.portrait-controls button:last-child { flex: 0 0 auto; padding: 3px 8px; font-size: 15px; line-height: 1; }
|
||||
.portrait-controls button:hover { background: var(--color-button-hover); }
|
||||
.portrait-controls button:disabled { opacity: .55; cursor: wait; }
|
||||
.photo-input { display: none; }
|
||||
.abilities-panel { grid-column: 2 / -1; grid-row: 1; }
|
||||
.combat-panel { grid-column: 2; grid-row: 2; }
|
||||
.traits-panel { grid-column: 3; grid-row: 2; }
|
||||
.spells-panel { grid-column: 2 / -1; grid-row: 3; }
|
||||
.ability-grid { display: grid; grid-template-columns: repeat(6, minmax(0, 1fr)); gap: 7px; }
|
||||
.ability-card { min-height: 83px; padding: 8px 5px; display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 3px; border: 1px solid var(--color-border); border-radius: 8px; background: var(--color-background-soft); }
|
||||
.ability-label { font-size: 11px; font-weight: 700; letter-spacing: .08em; opacity: .75; }
|
||||
.ability-score { font: 25px MrEavesRemake; }
|
||||
.ability-modifier { min-width: 33px; text-align: center; padding: 2px 5px; border-radius: 999px; background: var(--color-background); font-size: 12px; }
|
||||
.ability-card input { width: 55px; text-align: center; font-size: 21px; }
|
||||
.proficiency-badge { display: flex; justify-content: space-between; align-items: center; margin-top: 9px; padding: 8px; border-radius: 8px; background: var(--color-background-soft); font-size: 12px; }
|
||||
.proficiency-badge strong { font-size: 15px; color: var(--color-link); }
|
||||
.combat-stats { display: grid; grid-template-columns: 1fr 1fr; gap: 8px; }
|
||||
.combat-stat { min-height: 72px; display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 5px; border: 1px solid var(--color-border); border-radius: 8px; background: var(--color-background-soft); }
|
||||
.combat-stat > span { font-size: 11px; text-transform: uppercase; letter-spacing: .05em; opacity: .72; }
|
||||
.combat-stat > strong { font: 25px MrEavesRemake; }
|
||||
.combat-stat small { font-size: 11px; opacity: .7; }
|
||||
.number-with-unit { display: flex; align-items: center; gap: 4px; }
|
||||
.number-with-unit input { width: 57px; }
|
||||
.sheet-copy { min-height: 74px; margin: 0; white-space: pre-wrap; overflow-wrap: anywhere; font-size: 13px; line-height: 1.45; opacity: .85; }
|
||||
input, textarea { box-sizing: border-box; max-width: 100%; padding: 6px 7px; border: 1px solid var(--color-border); border-radius: 6px; background: var(--color-background-soft); color: var(--color-text); font: inherit; }
|
||||
input:focus, textarea:focus { outline: none; border-color: var(--color-link); }
|
||||
textarea { resize: vertical; width: 100%; min-height: 88px; font-size: 12px; }
|
||||
.traits-panel, .spells-panel { min-height: 175px; }
|
||||
.panel-title-row { display: flex; justify-content: space-between; align-items: center; gap: 8px; }
|
||||
.panel-title-row h2 { flex: 1; }
|
||||
.weight-summary { display: flex; justify-content: space-between; align-items: center; gap: 8px; margin: 1px 0 7px; font-size: 12px; }
|
||||
.weight-summary strong { white-space: nowrap; }
|
||||
.weight-track { height: 5px; margin-bottom: 10px; overflow: hidden; border-radius: 999px; background: var(--color-background-soft); }
|
||||
.weight-fill { height: 100%; border-radius: inherit; background: var(--color-link); transition: width .2s ease; }
|
||||
.inventory-panel { grid-column: 2 / -1; grid-row: 4; }
|
||||
.inventory-table-wrap { overflow-x: auto; }
|
||||
.inventory-table { width: 100%; border-collapse: collapse; font-size: 12px; }
|
||||
.inventory-table th { padding: 6px 7px; text-align: left; font-weight: 600; opacity: .7; }
|
||||
.inventory-table td { padding: 5px 7px; border-top: 1px solid var(--color-border); }
|
||||
.inventory-table td input { width: 100%; min-width: 54px; }
|
||||
.inventory-table td:first-child input { min-width: 100px; }
|
||||
.inventory-table th:not(:first-child), .inventory-table td:not(:first-child) { text-align: center; }
|
||||
.empty-inventory { text-align: center !important; opacity: .65; }
|
||||
.remove-item { width: 24px; height: 24px; border: 0; border-radius: 5px; background: transparent; color: var(--color-text); font-size: 20px; cursor: pointer; }
|
||||
.remove-item:hover { background: var(--color-button-hover); }
|
||||
.sheet-error { padding: 7px 10px; margin-bottom: 10px; border-radius: 6px; color: var(--color-red); background: var(--color-background-soft); font-size: 12px; }
|
||||
.sr-only { position: absolute; width: 1px; height: 1px; padding: 0; margin: -1px; overflow: hidden; clip: rect(0, 0, 0, 0); white-space: nowrap; border: 0; }
|
||||
@media (max-width: 760px) {
|
||||
.sheet-grid { grid-template-columns: 1fr 1fr; grid-template-rows: none; }
|
||||
.sheet-portrait { grid-column: 1 / -1; grid-row: auto; }
|
||||
.abilities-panel { grid-column: 1 / -1; grid-row: auto; }
|
||||
.combat-panel, .traits-panel { grid-column: auto; grid-row: auto; }
|
||||
.spells-panel, .inventory-panel { grid-column: 1 / -1; grid-row: auto; }
|
||||
}
|
||||
@media (max-width: 520px) {
|
||||
.sheet-body { padding: 10px; }
|
||||
.sheet-hero { align-items: flex-start; flex-wrap: wrap; }
|
||||
.sheet-actions { margin-left: auto; }
|
||||
.sheet-grid { grid-template-columns: 1fr; }
|
||||
.ability-grid { grid-template-columns: repeat(3, minmax(0, 1fr)); }
|
||||
}
|
||||
</style>
|
||||
135
frontend/app/components/windows/CreateCampaignEntryWindow.vue
Normal file
135
frontend/app/components/windows/CreateCampaignEntryWindow.vue
Normal file
@@ -0,0 +1,135 @@
|
||||
<script setup>
|
||||
import { onBeforeUnmount, onMounted, ref } from 'vue';
|
||||
import { SetupHandle, SetSize, ResetPosition, ClearWindow } from '@/services/Windows';
|
||||
import WindowHandle from './partials/WindowHandle.vue';
|
||||
import Server from '~/services/Server';
|
||||
import { emitter } from '~/services/Emitter';
|
||||
|
||||
const props = defineProps(['data']);
|
||||
const data = props.data;
|
||||
const id = data.id;
|
||||
const handle = ref(null);
|
||||
const wrapper = ref(null);
|
||||
const saving = ref(false);
|
||||
const form = ref({
|
||||
name: '', type: 'character', species: '', className: '', level: '', background: '', challengeRating: '',
|
||||
category: 'adventuring-gear', rarity: 'common', quantity: 1, weight: '', properties: '', description: ''
|
||||
});
|
||||
|
||||
const isActor = data.entityType === 'actor';
|
||||
const endpoint = isActor ? '/actor/create' : '/item/create';
|
||||
|
||||
onMounted(() => {
|
||||
SetupHandle(id, handle);
|
||||
SetSize(id, isActor ? { width: 420, height: 220 } : { width: 500, height: 560 });
|
||||
ResetPosition(id, 'center');
|
||||
});
|
||||
|
||||
onBeforeUnmount(() => ClearWindow({ type: 'create_campaign_entry' }));
|
||||
|
||||
async function saveEntry() {
|
||||
if (!form.value.name.trim() || saving.value) return;
|
||||
saving.value = true;
|
||||
try {
|
||||
const payload = { name: form.value.name.trim(), campaign: data.campaign };
|
||||
if (!isActor) {
|
||||
for (const field of ['category', 'rarity', 'quantity', 'weight', 'properties', 'description']) {
|
||||
payload[field] = form.value[field];
|
||||
}
|
||||
}
|
||||
const response = await Server().post(endpoint, payload);
|
||||
if (response.data.status === 'ok') {
|
||||
emitter.emit('campaign-entry-created', { entityType: data.entityType, entry: response.data[isActor ? 'actor' : 'item'] });
|
||||
ClearWindow({ id });
|
||||
}
|
||||
} catch (error) {
|
||||
// Keep the form open so the user can retry.
|
||||
} finally {
|
||||
saving.value = false;
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="window-wrapper" :id="'window-wrapper-' + id" ref="wrapper">
|
||||
<WindowHandle :window="id" ref="handle" />
|
||||
<div class="body">
|
||||
<h3>{{ $t(isActor ? 'campaigns.actor.new' : 'campaigns.item.new') }}</h3>
|
||||
<form @submit.prevent="saveEntry">
|
||||
<label class="form-field">
|
||||
<span>{{ $t('campaigns.fields.name') }}</span>
|
||||
<input v-model="form.name" required autofocus autocomplete="off">
|
||||
</label>
|
||||
|
||||
<template v-if="!isActor">
|
||||
<div class="form-grid">
|
||||
<label class="form-field">
|
||||
<span>{{ $t('campaigns.item.category') }}</span>
|
||||
<select v-model="form.category">
|
||||
<option value="weapon">{{ $t('campaigns.item.categories.weapon') }}</option>
|
||||
<option value="armor">{{ $t('campaigns.item.categories.armor') }}</option>
|
||||
<option value="shield">{{ $t('campaigns.item.categories.shield') }}</option>
|
||||
<option value="adventuring-gear">{{ $t('campaigns.item.categories.adventuring-gear') }}</option>
|
||||
<option value="magic-item">{{ $t('campaigns.item.categories.magic-item') }}</option>
|
||||
<option value="consumable">{{ $t('campaigns.item.categories.consumable') }}</option>
|
||||
<option value="tool">{{ $t('campaigns.item.categories.tool') }}</option>
|
||||
<option value="treasure">{{ $t('campaigns.item.categories.treasure') }}</option>
|
||||
<option value="other">{{ $t('campaigns.item.categories.other') }}</option>
|
||||
</select>
|
||||
</label>
|
||||
<label class="form-field">
|
||||
<span>{{ $t('campaigns.item.rarity') }}</span>
|
||||
<select v-model="form.rarity">
|
||||
<option value="common">{{ $t('campaigns.item.rarities.common') }}</option>
|
||||
<option value="uncommon">{{ $t('campaigns.item.rarities.uncommon') }}</option>
|
||||
<option value="rare">{{ $t('campaigns.item.rarities.rare') }}</option>
|
||||
<option value="very-rare">{{ $t('campaigns.item.rarities.very-rare') }}</option>
|
||||
<option value="legendary">{{ $t('campaigns.item.rarities.legendary') }}</option>
|
||||
<option value="artifact">{{ $t('campaigns.item.rarities.artifact') }}</option>
|
||||
</select>
|
||||
</label>
|
||||
<label class="form-field">
|
||||
<span>{{ $t('campaigns.item.quantity') }}</span>
|
||||
<input v-model.number="form.quantity" type="number" min="1" required>
|
||||
</label>
|
||||
<label class="form-field">
|
||||
<span>{{ $t('campaigns.item.weight') }}</span>
|
||||
<input v-model="form.weight" type="number" min="0" step="0.1">
|
||||
</label>
|
||||
</div>
|
||||
<label class="form-field">
|
||||
<span>{{ $t('campaigns.item.properties') }}</span>
|
||||
<input v-model="form.properties" :placeholder="$t('campaigns.item.properties-placeholder')">
|
||||
</label>
|
||||
</template>
|
||||
|
||||
<label v-if="!isActor" class="form-field">
|
||||
<span>{{ $t('campaigns.fields.description') }}</span>
|
||||
<textarea v-model="form.description" rows="3" />
|
||||
</label>
|
||||
<div class="form-actions">
|
||||
<button class="btn-primary sound-click" type="submit" :disabled="saving">
|
||||
{{ saving ? $t('campaigns.actions.saving') : $t('campaigns.actions.submit') }}
|
||||
</button>
|
||||
</div>
|
||||
</form>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.window-wrapper { display: flex; align-items: center; flex-direction: column; }
|
||||
.body { width: 100%; padding: 10px 18px 16px; overflow-y: auto; }
|
||||
h3 { margin: 0 0 12px; font-family: MrEavesRemake; }
|
||||
form { display: flex; flex-direction: column; gap: 10px; }
|
||||
.form-field { min-width: 0; display: flex; flex-direction: column; gap: 4px; font-size: 13px; }
|
||||
.form-grid { display: grid; grid-template-columns: 1fr 1fr; gap: 10px; }
|
||||
input, select, textarea {
|
||||
box-sizing: border-box; width: 100%; padding: 7px 8px; border: 1px solid var(--color-border);
|
||||
border-radius: 6px; background: var(--color-background-soft); color: var(--color-text); font: inherit;
|
||||
}
|
||||
textarea { resize: vertical; }
|
||||
input:focus, select:focus, textarea:focus { outline: none; border-color: var(--color-link); }
|
||||
.form-actions { display: flex; justify-content: center; margin-top: 2px; }
|
||||
.form-actions button { width: 100%; max-width: 220px; }
|
||||
</style>
|
||||
129
frontend/app/components/windows/NewNoteWindow.vue
Normal file
129
frontend/app/components/windows/NewNoteWindow.vue
Normal file
@@ -0,0 +1,129 @@
|
||||
<script setup>
|
||||
import { onBeforeUnmount, onMounted, ref } from 'vue';
|
||||
import { SetupHandle, SetSize, ResetPosition, ClearWindow } from '@/services/Windows';
|
||||
import WindowHandle from './partials/WindowHandle.vue';
|
||||
import Server from '~/services/Server';
|
||||
import { emitter } from '~/services/Emitter';
|
||||
|
||||
const handle = ref(null);
|
||||
const wrapper = ref(null);
|
||||
|
||||
const props = defineProps(['data']);
|
||||
const data = props.data;
|
||||
|
||||
let id = data.id;
|
||||
|
||||
const newName = ref('');
|
||||
|
||||
onMounted(() => {
|
||||
SetupHandle(id, handle);
|
||||
SetSize(id, { width: 420, height: 200 });
|
||||
ResetPosition(id, 'center');
|
||||
});
|
||||
|
||||
onBeforeUnmount(() => {
|
||||
ClearWindow({ type: 'new_note' });
|
||||
});
|
||||
|
||||
function confirmCreate() {
|
||||
if (!newName.value.trim()) {
|
||||
return;
|
||||
}
|
||||
|
||||
Server().post('/note/create', {
|
||||
title: newName.value.trim(),
|
||||
content: '',
|
||||
campaign: data.campaign,
|
||||
folder: data.folder ?? null
|
||||
}).then((response) => {
|
||||
if (response.data.status !== 'ok') {
|
||||
return;
|
||||
}
|
||||
emitter.emit('note-created', response.data.note);
|
||||
ClearWindow({ id });
|
||||
}).catch(() => {});
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="window-wrapper" :id="'window-wrapper-' + id" ref="wrapper">
|
||||
<WindowHandle :window="id" ref="handle"></WindowHandle>
|
||||
|
||||
<div class="body">
|
||||
<h3>New Note</h3>
|
||||
<form v-on:submit.prevent="confirmCreate">
|
||||
<div class="form-field">
|
||||
<input
|
||||
type="text"
|
||||
v-model="newName"
|
||||
placeholder="Note title"
|
||||
autofocus
|
||||
autocomplete="off"
|
||||
>
|
||||
</div>
|
||||
<div class="form-actions">
|
||||
<button class="btn-primary sound-click" type="submit">Create</button>
|
||||
</div>
|
||||
</form>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<style scoped>
|
||||
.window-wrapper {
|
||||
display: flex;
|
||||
align-items: center;
|
||||
flex-direction: column;
|
||||
}
|
||||
|
||||
.body {
|
||||
width: 100%;
|
||||
padding: 10px;
|
||||
}
|
||||
|
||||
h3 {
|
||||
margin: 0 0 10px 10px;
|
||||
font-family: MrEavesRemake;
|
||||
}
|
||||
|
||||
form {
|
||||
margin-left: 10px;
|
||||
margin-right: 10px;
|
||||
}
|
||||
|
||||
.form-field {
|
||||
display: flex;
|
||||
flex-direction: row;
|
||||
width: 100%;
|
||||
}
|
||||
|
||||
.form-field > * {
|
||||
flex-grow: 1;
|
||||
}
|
||||
|
||||
input {
|
||||
width: 100%;
|
||||
padding: 6px 8px;
|
||||
border: 1px solid var(--color-border);
|
||||
border-radius: 6px;
|
||||
background: var(--color-background-soft);
|
||||
color: var(--color-text);
|
||||
font-size: 14px;
|
||||
}
|
||||
|
||||
input:focus {
|
||||
outline: none;
|
||||
border-color: var(--color-accent);
|
||||
}
|
||||
|
||||
.form-actions {
|
||||
display: flex;
|
||||
justify-content: center;
|
||||
margin-top: 10px;
|
||||
}
|
||||
|
||||
.form-actions button {
|
||||
width: 100%;
|
||||
max-width: 200px;
|
||||
}
|
||||
</style>
|
||||
@@ -35,6 +35,12 @@ const defWindows = {
|
||||
close: () => ClearWindow({type: 'create_campaign'}),
|
||||
movable: true
|
||||
},
|
||||
campaign_settings: {
|
||||
title: 'campaigns.settings.title',
|
||||
component: () => import('~/components/windows/CampaignSettingsWindow.vue'),
|
||||
close: () => ClearWindow({type: 'campaign_settings'}),
|
||||
movable: true
|
||||
},
|
||||
rename_note: {
|
||||
title: "Rename Note",
|
||||
component: () => import('~/components/windows/RenameNoteWindow.vue'),
|
||||
@@ -46,6 +52,24 @@ const defWindows = {
|
||||
component: () => import('~/components/windows/NewFolderWindow.vue'),
|
||||
close: () => ClearWindow({type: 'new_folder'}),
|
||||
movable: true
|
||||
},
|
||||
new_note: {
|
||||
title: "New Note",
|
||||
component: () => import('~/components/windows/NewNoteWindow.vue'),
|
||||
close: () => ClearWindow({type: 'new_note'}),
|
||||
movable: true
|
||||
},
|
||||
create_campaign_entry: {
|
||||
title: 'campaigns.create-entry',
|
||||
component: () => import('~/components/windows/CreateCampaignEntryWindow.vue'),
|
||||
close: () => ClearWindow({type: 'create_campaign_entry'}),
|
||||
movable: true
|
||||
},
|
||||
character_sheet: {
|
||||
title: 'campaigns.character-sheet.title',
|
||||
component: () => import('~/components/windows/CharacterSheetWindow.vue'),
|
||||
close: () => ClearWindow({type: 'character_sheet'}),
|
||||
movable: true
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
69
frontend/i18n/locales/ca/campaigns.json
Normal file
69
frontend/i18n/locales/ca/campaigns.json
Normal file
@@ -0,0 +1,69 @@
|
||||
{
|
||||
"create": {
|
||||
"name": "Nom", "description": "Descripció", "description-placeholder": "Escriu una breu descripció de la campanya...",
|
||||
"enter": "Introdueix el nom de la campanya...", "color": "Color d'accent", "success": "Campanya creada correctament!"
|
||||
},
|
||||
"settings": {
|
||||
"title": "Configuració de la campanya",
|
||||
"tabs": { "basic": "Bàsic", "integrations": "Integracions" },
|
||||
"name": "Nom de la campanya",
|
||||
"color": "Color de la campanya",
|
||||
"foundry-url": "URL de Foundry VTT",
|
||||
"foundry-url-help": "Introdueix l'URL base de la instància de Foundry VTT que executa el mòdul Dragonroll Foundry.",
|
||||
"no-foundry-world": "Aquesta campanya no té cap món de Foundry enllaçat.",
|
||||
"start-foundry-link": "Crea un codi per a Foundry",
|
||||
"start-foundry-link-help": "Copia aquest codi a l'opció Dragonroll Campaign Pairing Code del mòdul de Foundry. Dragonroll Endpoint utilitza https://dragonroll.aranroig.com de manera predeterminada. El codi caduca al cap de 10 minuts.",
|
||||
"unlink-foundry": "Desenllaça",
|
||||
"saved": "S'ha desat la configuració de la campanya.",
|
||||
"linked": "S'ha enllaçat el món de Foundry amb aquesta campanya.",
|
||||
"unlinked": "S'ha desenllaçat el món de Foundry d'aquesta campanya.",
|
||||
"code-copied": "S'ha copiat el codi d'enllaç.",
|
||||
"saving": "Desant...",
|
||||
"errors": {
|
||||
"name-required": "Introdueix un nom per a la campanya.",
|
||||
"invalid-foundry-url": "Introdueix una URL vàlida de Foundry VTT amb http o https.",
|
||||
"link-expired": "El codi d'enllaç ha caducat. Crea'n un de nou.",
|
||||
"copy-code": "No s'ha pogut copiar el codi d'enllaç."
|
||||
}
|
||||
},
|
||||
"sidebar-label": "Campanya",
|
||||
"sections": { "notes": "Notes", "actors": "Actors i personatges", "items": "Objectes" },
|
||||
"actions": {
|
||||
"new-note": "Nota nova", "new-folder": "Carpeta nova", "refresh": "Actualitza",
|
||||
"create": "Crea {section}", "submit": "Crea", "delete": "Suprimeix", "saving": "Desant...",
|
||||
"collapse-sidebar": "Redueix la barra lateral", "expand-sidebar": "Expandeix la barra lateral"
|
||||
},
|
||||
"states": {
|
||||
"loading": "Carregant...", "loading-notes": "Carregant notes...", "empty-notes": "Encara no hi ha notes en aquesta campanya.",
|
||||
"empty-actors": "Encara no hi ha actors ni personatges.", "empty-items": "Encara no hi ha objectes en aquesta campanya."
|
||||
},
|
||||
"errors": { "load": "No s'han pogut carregar les entrades de la campanya." },
|
||||
"create-entry": "Crea una entrada de campanya",
|
||||
"fields": { "name": "Nom", "description": "Descripció" },
|
||||
"actor": {
|
||||
"new": "Actor o personatge nou", "type": "Tipus", "species": "Espècie", "class": "Classe",
|
||||
"level": "Nivell", "level-short": "Nivell", "background": "Rerefons", "challenge-rating": "Grau de desafiament",
|
||||
"challenge-rating-placeholder": "Per exemple, 1/4 o 3", "cr-short": "GD",
|
||||
"types": { "character": "Personatge", "npc": "PNJ", "creature": "Criatura" }
|
||||
},
|
||||
"item": {
|
||||
"new": "Objecte nou", "category": "Categoria", "rarity": "Raresa", "quantity": "Quantitat",
|
||||
"quantity-short": "Quant.", "weight": "Pes (lb)", "properties": "Propietats", "properties-placeholder": "Per exemple, versàtil, subtil",
|
||||
"categories": {
|
||||
"weapon": "Arma", "armor": "Armadura", "shield": "Escut", "adventuring-gear": "Equip d'aventura",
|
||||
"magic-item": "Objecte màgic", "consumable": "Consumible", "tool": "Eina", "treasure": "Tresor", "other": "Altre"
|
||||
},
|
||||
"rarities": { "common": "Comuna", "uncommon": "Poc comuna", "rare": "Rara", "very-rare": "Molt rara", "legendary": "Llegendària", "artifact": "Artefacte" }
|
||||
},
|
||||
"character-sheet": {
|
||||
"title": "Fitxa de personatge", "name": "Nom del personatge", "class": "Classe", "subclass": "Subclasse", "unset-class": "Classe sense definir",
|
||||
"level": "Nivell", "species": "Espècie", "unset-species": "Espècie sense definir", "edit": "Edita la fitxa", "cancel": "Cancel·la",
|
||||
"saving": "Desant...", "save": "Desa la fitxa", "save-error": "No s'ha pogut desar aquesta fitxa de personatge.", "photo": "Foto", "upload-photo": "Pujar foto", "change-photo": "Canviar foto", "remove-photo": "Treure foto", "uploading-photo": "Pujant...", "photo-error": "No s'ha pogut pujar aquesta foto.", "ability-scores": "Característiques", "proficiency-bonus": "Bonificador de competència",
|
||||
"combat": "Combat", "armor-class": "Classe d'armadura", "speed": "Velocitat", "proficiencies": "Competències",
|
||||
"proficiencies-placeholder": "Afegeix salvacions, habilitats, armadures, armes, eines i idiomes...", "empty-proficiencies": "No hi ha competències afegides.",
|
||||
"traits": "Trets", "traits-placeholder": "Afegeix trets, capacitats i altres detalls...", "empty-traits": "No hi ha trets afegits.",
|
||||
"spells": "Conjurs", "spells-placeholder": "Escriu els conjurs, un per línia...", "empty-spells": "No hi ha conjurs afegits.",
|
||||
"inventory": "Inventari", "add-item": "Afegeix un objecte", "carried-weight": "Pes transportat", "item-name": "Objecte",
|
||||
"quantity": "Quant.", "weight-each": "Unitat (lb)", "total-weight": "Total (lb)", "actions": "Accions", "empty-inventory": "L'inventari és buit."
|
||||
}
|
||||
}
|
||||
18
frontend/i18n/locales/ca/discord.json
Normal file
18
frontend/i18n/locales/ca/discord.json
Normal file
@@ -0,0 +1,18 @@
|
||||
{
|
||||
"title": "Connectar Dragonroll amb Discord",
|
||||
"checking": "Comprovant aquesta sol·licitud d'autorització…",
|
||||
"summary": "Servidor de Discord: {guild}. Sol·licitat per {user}. Inicia sessió i confirma-ho només si confies en aquesta sol·licitud.",
|
||||
"sign-in-lead": "Inicia sessió amb el compte de Dragonroll que és propietari de la campanya que vols que utilitzi aquest servidor.",
|
||||
"signed-in-as": "Has iniciat sessió com a {user}.",
|
||||
"approve": "Autoritzar aquest servidor de Discord",
|
||||
"connected": "Dragonroll s'ha connectat a {guild}.",
|
||||
"next-step": "Torna a Discord i executa /dragonroll link per triar una campanya.",
|
||||
"replace-warning": "Autoritzar un altre compte de Dragonroll reemplaça la connexió actual i l'enllaç de campanya d'aquest servidor.",
|
||||
"errors": {
|
||||
"missing-code": "A aquest enllaç d'autorització li falta el codi. Executa /dragonroll connect a Discord de nou.",
|
||||
"link-expired": "Aquest enllaç d'autorització no és vàlid o ha caducat. Executa /dragonroll connect a Discord de nou.",
|
||||
"sign-in-failed": "No s'ha pogut iniciar sessió a Dragonroll. Revisa l'usuari i la contrasenya.",
|
||||
"session-expired": "La teva sessió de Dragonroll ha caducat. Inicia sessió de nou per continuar.",
|
||||
"internal": "No s'ha pogut carregar aquesta sol·licitud d'autorització."
|
||||
}
|
||||
}
|
||||
6
frontend/i18n/locales/ca/foundry.json
Normal file
6
frontend/i18n/locales/ca/foundry.json
Normal file
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"errors": {
|
||||
"link-expired": "El codi d'enllaç de Foundry no és vàlid, ha caducat o ja s'ha utilitzat.",
|
||||
"world-already-linked": "Aquest món de Foundry ja està enllaçat amb una altra campanya."
|
||||
}
|
||||
}
|
||||
@@ -1 +1,3 @@
|
||||
{}
|
||||
{
|
||||
"save": "Desa"
|
||||
}
|
||||
|
||||
@@ -6,4 +6,4 @@
|
||||
"edit-profile": "Editar perfil",
|
||||
"settings": "Configuració",
|
||||
"create-campaign": "Crear campanya"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -6,5 +6,70 @@
|
||||
"enter": "Enter campaign name here...",
|
||||
"color": "Accent color",
|
||||
"success": "Campaign created successfully!"
|
||||
},
|
||||
"settings": {
|
||||
"title": "Campaign settings",
|
||||
"tabs": { "basic": "Basic", "integrations": "Integrations" },
|
||||
"name": "Campaign name",
|
||||
"color": "Campaign color",
|
||||
"foundry-url": "Foundry VTT URL",
|
||||
"foundry-url-help": "Enter the base URL of the Foundry VTT instance running the Dragonroll Foundry module.",
|
||||
"no-foundry-world": "No Foundry world is linked to this campaign.",
|
||||
"start-foundry-link": "Create a code for Foundry",
|
||||
"start-foundry-link-help": "Copy this code into the Dragonroll Campaign Pairing Code setting in the Foundry module. The Dragonroll Endpoint defaults to https://dragonroll.aranroig.com. The code expires after 10 minutes.",
|
||||
"unlink-foundry": "Unlink",
|
||||
"saved": "Campaign settings saved.",
|
||||
"linked": "Foundry world linked to this campaign.",
|
||||
"unlinked": "Foundry world unlinked from this campaign.",
|
||||
"code-copied": "Pairing code copied.",
|
||||
"saving": "Saving...",
|
||||
"errors": {
|
||||
"name-required": "Enter a campaign name.",
|
||||
"invalid-foundry-url": "Enter a valid Foundry VTT URL using http or https.",
|
||||
"link-expired": "This pairing code expired. Create a new one.",
|
||||
"copy-code": "Unable to copy the pairing code."
|
||||
}
|
||||
},
|
||||
"sidebar-label": "Campaign",
|
||||
"sections": { "notes": "Notes", "actors": "Actors & Characters", "items": "Items" },
|
||||
"actions": {
|
||||
"new-note": "New note", "new-folder": "New folder", "refresh": "Refresh",
|
||||
"create": "Create {section}", "submit": "Create", "delete": "Delete", "saving": "Saving...",
|
||||
"collapse-sidebar": "Collapse sidebar", "expand-sidebar": "Expand sidebar"
|
||||
},
|
||||
"states": {
|
||||
"loading": "Loading...", "loading-notes": "Loading notes...", "empty-notes": "No notes in this campaign yet.",
|
||||
"empty-actors": "No actors or characters yet.", "empty-items": "No items in this campaign yet."
|
||||
},
|
||||
"errors": { "load": "Unable to load campaign entries." },
|
||||
"create-entry": "Create campaign entry",
|
||||
"fields": { "name": "Name", "description": "Description" },
|
||||
"actor": {
|
||||
"new": "New actor or character", "type": "Type", "species": "Species", "class": "Class",
|
||||
"level": "Level", "level-short": "Level", "background": "Background", "challenge-rating": "Challenge rating",
|
||||
"challenge-rating-placeholder": "For example, 1/4 or 3", "cr-short": "CR",
|
||||
"types": { "character": "Character", "npc": "NPC", "creature": "Creature" }
|
||||
},
|
||||
"item": {
|
||||
"new": "New item", "category": "Category", "rarity": "Rarity", "quantity": "Quantity",
|
||||
"quantity-short": "Qty", "weight": "Weight (lb)", "properties": "Properties", "properties-placeholder": "For example, versatile, finesse",
|
||||
"categories": {
|
||||
"weapon": "Weapon", "armor": "Armor", "shield": "Shield", "adventuring-gear": "Adventuring gear",
|
||||
"magic-item": "Magic item", "consumable": "Consumable", "tool": "Tool", "treasure": "Treasure", "other": "Other"
|
||||
},
|
||||
"rarities": { "common": "Common", "uncommon": "Uncommon", "rare": "Rare", "very-rare": "Very rare", "legendary": "Legendary", "artifact": "Artifact" }
|
||||
},
|
||||
"character-sheet": {
|
||||
"title": "Character Sheet", "name": "Character name", "class": "Class", "subclass": "Subclass", "unset-class": "Class not set",
|
||||
"level": "Level", "species": "Species", "unset-species": "Species not set", "edit": "Edit sheet", "cancel": "Cancel",
|
||||
"saving": "Saving...", "save": "Save sheet", "save-error": "Unable to save this character sheet.",
|
||||
"photo": "Photo", "upload-photo": "Upload photo", "change-photo": "Change photo", "remove-photo": "Remove photo",
|
||||
"uploading-photo": "Uploading...", "photo-error": "Unable to upload this photo.", "ability-scores": "Ability Scores", "proficiency-bonus": "Proficiency Bonus",
|
||||
"combat": "Combat", "armor-class": "Armor Class", "speed": "Speed", "proficiencies": "Proficiencies",
|
||||
"proficiencies-placeholder": "Add saving throws, skills, armor, weapons, tools, and languages...", "empty-proficiencies": "No proficiencies added.",
|
||||
"traits": "Traits", "traits-placeholder": "Add features, traits, and other character details...", "empty-traits": "No traits added.",
|
||||
"spells": "Spells", "spells-placeholder": "List spells, one per line...", "empty-spells": "No spells added.",
|
||||
"inventory": "Inventory", "add-item": "Add item", "carried-weight": "Carried weight", "item-name": "Item",
|
||||
"quantity": "Qty", "weight-each": "Each (lb)", "total-weight": "Total (lb)", "actions": "Actions", "empty-inventory": "Inventory is empty."
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
18
frontend/i18n/locales/en/discord.json
Normal file
18
frontend/i18n/locales/en/discord.json
Normal file
@@ -0,0 +1,18 @@
|
||||
{
|
||||
"title": "Connect Dragonroll to Discord",
|
||||
"checking": "Checking this authorization request…",
|
||||
"summary": "Discord server: {guild}. Requested by {user}. Sign in and confirm only if you trust this request.",
|
||||
"sign-in-lead": "Sign in to the Dragonroll account that owns the campaign you want this server to use.",
|
||||
"signed-in-as": "Signed in as {user}.",
|
||||
"approve": "Authorize this Discord server",
|
||||
"connected": "Dragonroll is connected to {guild}.",
|
||||
"next-step": "Return to Discord and run /dragonroll link to choose a campaign.",
|
||||
"replace-warning": "Authorizing a different Dragonroll account replaces this server's current connection and campaign link.",
|
||||
"errors": {
|
||||
"missing-code": "This authorization link is missing its code. Run /dragonroll connect in Discord again.",
|
||||
"link-expired": "This authorization link is invalid or expired. Run /dragonroll connect in Discord again.",
|
||||
"sign-in-failed": "Dragonroll sign in failed. Check your username and password.",
|
||||
"session-expired": "Your Dragonroll session has expired. Sign in again to continue.",
|
||||
"internal": "Could not load this authorization request."
|
||||
}
|
||||
}
|
||||
6
frontend/i18n/locales/en/foundry.json
Normal file
6
frontend/i18n/locales/en/foundry.json
Normal file
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"errors": {
|
||||
"link-expired": "This Foundry pairing code is invalid, expired, or already used.",
|
||||
"world-already-linked": "This Foundry world is already linked to another campaign."
|
||||
}
|
||||
}
|
||||
@@ -6,4 +6,4 @@
|
||||
"edit-profile": "Edit Profile",
|
||||
"settings": "Settings",
|
||||
"create-campaign": "Create Campaign"
|
||||
}
|
||||
}
|
||||
|
||||
69
frontend/i18n/locales/es/campaigns.json
Normal file
69
frontend/i18n/locales/es/campaigns.json
Normal file
@@ -0,0 +1,69 @@
|
||||
{
|
||||
"create": {
|
||||
"name": "Nombre", "description": "Descripción", "description-placeholder": "Escribe una breve descripción de la campaña...",
|
||||
"enter": "Introduce el nombre de la campaña...", "color": "Color de acento", "success": "¡Campaña creada correctamente!"
|
||||
},
|
||||
"settings": {
|
||||
"title": "Ajustes de la campaña",
|
||||
"tabs": { "basic": "Básico", "integrations": "Integraciones" },
|
||||
"name": "Nombre de la campaña",
|
||||
"color": "Color de la campaña",
|
||||
"foundry-url": "URL de Foundry VTT",
|
||||
"foundry-url-help": "Introduce la URL base de la instancia de Foundry VTT que ejecuta el módulo Dragonroll Foundry.",
|
||||
"no-foundry-world": "Esta campaña no tiene ningún mundo de Foundry vinculado.",
|
||||
"start-foundry-link": "Crear un código para Foundry",
|
||||
"start-foundry-link-help": "Copia este código en el ajuste Dragonroll Campaign Pairing Code del módulo de Foundry. Dragonroll Endpoint usa https://dragonroll.aranroig.com de forma predeterminada. El código caduca en 10 minutos.",
|
||||
"unlink-foundry": "Desvincular",
|
||||
"saved": "Se han guardado los ajustes de la campaña.",
|
||||
"linked": "El mundo de Foundry se ha vinculado a esta campaña.",
|
||||
"unlinked": "Se ha desvinculado el mundo de Foundry de esta campaña.",
|
||||
"code-copied": "Código de vinculación copiado.",
|
||||
"saving": "Guardando...",
|
||||
"errors": {
|
||||
"name-required": "Introduce un nombre para la campaña.",
|
||||
"invalid-foundry-url": "Introduce una URL válida de Foundry VTT con http o https.",
|
||||
"link-expired": "El código de vinculación ha caducado. Crea uno nuevo.",
|
||||
"copy-code": "No se pudo copiar el código de vinculación."
|
||||
}
|
||||
},
|
||||
"sidebar-label": "Campaña",
|
||||
"sections": { "notes": "Notas", "actors": "Actores y personajes", "items": "Objetos" },
|
||||
"actions": {
|
||||
"new-note": "Nueva nota", "new-folder": "Nueva carpeta", "refresh": "Actualizar",
|
||||
"create": "Crear {section}", "submit": "Crear", "delete": "Eliminar", "saving": "Guardando...",
|
||||
"collapse-sidebar": "Contraer barra lateral", "expand-sidebar": "Expandir barra lateral"
|
||||
},
|
||||
"states": {
|
||||
"loading": "Cargando...", "loading-notes": "Cargando notas...", "empty-notes": "Aún no hay notas en esta campaña.",
|
||||
"empty-actors": "Aún no hay actores ni personajes.", "empty-items": "Aún no hay objetos en esta campaña."
|
||||
},
|
||||
"errors": { "load": "No se pudieron cargar las entradas de la campaña." },
|
||||
"create-entry": "Crear entrada de campaña",
|
||||
"fields": { "name": "Nombre", "description": "Descripción" },
|
||||
"actor": {
|
||||
"new": "Nuevo actor o personaje", "type": "Tipo", "species": "Especie", "class": "Clase",
|
||||
"level": "Nivel", "level-short": "Nivel", "background": "Trasfondo", "challenge-rating": "Valor de desafío",
|
||||
"challenge-rating-placeholder": "Por ejemplo, 1/4 o 3", "cr-short": "VD",
|
||||
"types": { "character": "Personaje", "npc": "PNJ", "creature": "Criatura" }
|
||||
},
|
||||
"item": {
|
||||
"new": "Nuevo objeto", "category": "Categoría", "rarity": "Rareza", "quantity": "Cantidad",
|
||||
"quantity-short": "Cant.", "weight": "Peso (lb)", "properties": "Propiedades", "properties-placeholder": "Por ejemplo, versátil, sutil",
|
||||
"categories": {
|
||||
"weapon": "Arma", "armor": "Armadura", "shield": "Escudo", "adventuring-gear": "Equipo de aventura",
|
||||
"magic-item": "Objeto mágico", "consumable": "Consumible", "tool": "Herramienta", "treasure": "Tesoro", "other": "Otro"
|
||||
},
|
||||
"rarities": { "common": "Común", "uncommon": "Poco común", "rare": "Raro", "very-rare": "Muy raro", "legendary": "Legendario", "artifact": "Artefacto" }
|
||||
},
|
||||
"character-sheet": {
|
||||
"title": "Hoja de personaje", "name": "Nombre del personaje", "class": "Clase", "subclass": "Subclase", "unset-class": "Clase sin definir",
|
||||
"level": "Nivel", "species": "Especie", "unset-species": "Especie sin definir", "edit": "Editar hoja", "cancel": "Cancelar",
|
||||
"saving": "Guardando...", "save": "Guardar hoja", "save-error": "No se pudo guardar esta hoja de personaje.", "photo": "Foto", "upload-photo": "Subir foto", "change-photo": "Cambiar foto", "remove-photo": "Quitar foto", "uploading-photo": "Subiendo...", "photo-error": "No se pudo subir esta foto.", "ability-scores": "Características", "proficiency-bonus": "Bonificador por competencia",
|
||||
"combat": "Combate", "armor-class": "Clase de armadura", "speed": "Velocidad", "proficiencies": "Competencias",
|
||||
"proficiencies-placeholder": "Añade salvaciones, habilidades, armaduras, armas, herramientas e idiomas...", "empty-proficiencies": "No hay competencias añadidas.",
|
||||
"traits": "Rasgos", "traits-placeholder": "Añade rasgos, capacidades y otros detalles...", "empty-traits": "No hay rasgos añadidos.",
|
||||
"spells": "Conjuros", "spells-placeholder": "Escribe los conjuros, uno por línea...", "empty-spells": "No hay conjuros añadidos.",
|
||||
"inventory": "Inventario", "add-item": "Añadir objeto", "carried-weight": "Peso transportado", "item-name": "Objeto",
|
||||
"quantity": "Cant.", "weight-each": "Unidad (lb)", "total-weight": "Total (lb)", "actions": "Acciones", "empty-inventory": "El inventario está vacío."
|
||||
}
|
||||
}
|
||||
18
frontend/i18n/locales/es/discord.json
Normal file
18
frontend/i18n/locales/es/discord.json
Normal file
@@ -0,0 +1,18 @@
|
||||
{
|
||||
"title": "Conectar Dragonroll con Discord",
|
||||
"checking": "Comprobando esta solicitud de autorización…",
|
||||
"summary": "Servidor de Discord: {guild}. Solicitado por {user}. Inicia sesión y confirma solo si confías en esta solicitud.",
|
||||
"sign-in-lead": "Inicia sesión en la cuenta de Dragonroll que posee la campaña que quieres que use este servidor.",
|
||||
"signed-in-as": "Has iniciado sesión como {user}.",
|
||||
"approve": "Autorizar este servidor de Discord",
|
||||
"connected": "Dragonroll se ha conectado a {guild}.",
|
||||
"next-step": "Vuelve a Discord y ejecuta /dragonroll link para elegir una campaña.",
|
||||
"replace-warning": "Autorizar otra cuenta de Dragonroll reemplaza la conexión actual y el vínculo de campaña de este servidor.",
|
||||
"errors": {
|
||||
"missing-code": "A este enlace de autorización le falta el código. Ejecuta /dragonroll connect en Discord de nuevo.",
|
||||
"link-expired": "Este enlace de autorización no es válido o ha caducado. Ejecuta /dragonroll connect en Discord de nuevo.",
|
||||
"sign-in-failed": "No se ha podido iniciar sesión en Dragonroll. Revisa el usuario y la contraseña.",
|
||||
"session-expired": "Tu sesión de Dragonroll ha caducado. Inicia sesión de nuevo para continuar.",
|
||||
"internal": "No se ha podido cargar esta solicitud de autorización."
|
||||
}
|
||||
}
|
||||
6
frontend/i18n/locales/es/foundry.json
Normal file
6
frontend/i18n/locales/es/foundry.json
Normal file
@@ -0,0 +1,6 @@
|
||||
{
|
||||
"errors": {
|
||||
"link-expired": "El código de vinculación de Foundry no es válido, ha caducado o ya se ha usado.",
|
||||
"world-already-linked": "Este mundo de Foundry ya está vinculado a otra campaña."
|
||||
}
|
||||
}
|
||||
@@ -1 +1,3 @@
|
||||
{}
|
||||
{
|
||||
"save": "Guardar"
|
||||
}
|
||||
|
||||
@@ -6,4 +6,4 @@
|
||||
"edit-profile": "Editar perfil",
|
||||
"settings": "Configuración",
|
||||
"create-campaign": "Crear campanya"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -3,6 +3,6 @@
|
||||
"concurrently": "^9.2.1"
|
||||
},
|
||||
"scripts": {
|
||||
"dev": "concurrently -k -n BACKEND,FRONTEND -c blue,green \"DEBUG=* npm --prefix backend run dev\" \"npm --prefix frontend run dev\""
|
||||
"dev": "concurrently -k -n BACKEND,FRONTEND,DISCORD-BOT,FOUNDRY -c blue,green,yellow,magenta \"DEBUG=* npm --prefix backend run dev\" \"npm --prefix frontend run dev\" \"npm --prefix discord-bot start\" \"node scripts/run-foundry.js\""
|
||||
}
|
||||
}
|
||||
|
||||
31
scripts/run-foundry.js
Normal file
31
scripts/run-foundry.js
Normal file
@@ -0,0 +1,31 @@
|
||||
// Runs the Foundry Virtual Tabletop start script defined by FOUNDRY_START_SCRIPT
|
||||
// in the root .env file. Used by `npm run dev` via concurrently.
|
||||
const { spawn } = require('node:child_process');
|
||||
const fs = require('node:fs');
|
||||
const path = require('node:path');
|
||||
|
||||
try {
|
||||
process.loadEnvFile(path.join(__dirname, '..', '.env'));
|
||||
} catch {
|
||||
// No .env at the repo root: nothing to launch.
|
||||
}
|
||||
|
||||
const script = process.env.FOUNDRY_START_SCRIPT;
|
||||
|
||||
function idle(reason) {
|
||||
console.log(`[foundry] ${reason} — Foundry server not started.`);
|
||||
// Keep the process alive so concurrently (-k) does not kill the other dev servers.
|
||||
setInterval(() => {}, 1 << 30);
|
||||
}
|
||||
|
||||
if (!script) idle('FOUNDRY_START_SCRIPT is not set in .env');
|
||||
else if (!fs.existsSync(script)) idle(`start script not found: ${script}`);
|
||||
else {
|
||||
console.log(`[foundry] Running ${script}`);
|
||||
const child = spawn('sh', [script], { stdio: 'inherit', cwd: path.dirname(script) });
|
||||
child.on('exit', (code, signal) => {
|
||||
if (signal) process.exit(0); // killed together with `npm run dev`
|
||||
idle(`exited with code ${code}`);
|
||||
});
|
||||
child.on('error', (err) => idle(`failed to start: ${err.message}`));
|
||||
}
|
||||
Reference in New Issue
Block a user