31 Commits

Author SHA1 Message Date
Gitea OpenCode Agent
59a4c1dd0c Fix issue #27: Add frontend testing
All checks were successful
Test / test (push) Successful in 1s
2026-10-14 16:30:59 +00:00
0541d82a85 Merge pull request 'Fix #21: entity-entry sizing problem' (#24) from ai/issue-21 into master
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m9s
Reviewed-on: #24
2026-10-14 16:20:15 +00:00
35252e0d13 Merge branch 'master' into ai/issue-21 2026-10-14 16:20:06 +00:00
8260c588ac Merge pull request 'Fix #19: Add unified campaign sync' (#22) from ai/issue-19 into master
Some checks failed
Build and Deploy Nuxt / build (push) Has been cancelled
Reviewed-on: #22
2026-10-14 16:19:57 +00:00
Gitea OpenCode Agent
b0acd689bb Fix issue #21: entity-entry sizing problem 2026-10-14 14:52:18 +00:00
Gitea OpenCode Agent
0a8452b3c8 Fix issue #19: Add unified campaign sync 2026-10-14 14:07:52 +00:00
9d9738b2b4 Merge pull request 'Fix #17: Foundry Module: Show pairing status' (#18) from ai/issue-17 into master
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m7s
Reviewed-on: #18
2026-10-14 13:02:23 +00:00
ce03b0bfb9 Merge branch 'master' into ai/issue-17 2026-10-14 13:02:15 +00:00
Gitea OpenCode Agent
ed0b9af00b Fix issue #17: Foundry Module: Show pairing status 2026-10-14 12:59:26 +00:00
9c6f59f937 Obsidian plugin
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m5s
(cherry picked from commit caeff595da)
2026-10-14 14:48:00 +02:00
5cd468ed24 Merge pull request 'Fix #15: Dragonroll Frontend: Map Viewer adjustmentes' (#16) from ai/issue-15 into master
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 53s
Reviewed-on: #16
2026-10-14 12:37:20 +00:00
Gitea OpenCode Agent
4a5b17c77c Fix issue #15: Dragonroll Frontend: Map Viewer adjustmentes 2026-10-14 12:35:05 +00:00
67ca4b0210 Merge pull request 'Fix #10: Add map support' (#11) from ai/issue-10 into master
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m3s
Reviewed-on: #11
2026-10-14 12:08:35 +00:00
ff4090412c Merge branch 'master' into ai/issue-10 2026-10-14 12:08:31 +00:00
445e97f2f8 Merge pull request 'Fix #12: Fix copy foundry code localization' (#13) from ai/issue-12 into master
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 50s
Reviewed-on: #13
2026-10-14 12:01:12 +00:00
dc6a04df8a Merge branch 'master' into ai/issue-12 2026-10-14 12:01:06 +00:00
0799dec5b3 Merge pull request 'Fix #8: Sync toggle on foundry' (#9) from ai/issue-8 into master
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 50s
Reviewed-on: #9
2026-10-14 12:00:17 +00:00
Gitea OpenCode Agent
8378e9b3e7 Fix issue #12: Fix copy foundry code localization 2026-10-14 11:57:34 +00:00
Gitea OpenCode Agent
bcd173d133 Fix issue #10: Add map support 2026-10-14 10:25:49 +00:00
Gitea OpenCode Agent
7d19a22a4b Fix issue #8: Sync toggle on foundry 2026-10-13 23:02:43 +00:00
af76cf1050 Things
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m6s
2026-10-13 22:50:51 +02:00
50828af674 Ye
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 54s
2026-10-12 01:05:46 +02:00
f3bf48ae54 Quote blocks have style
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 55s
2026-10-12 00:45:17 +02:00
d9ef18e82d Carets for folding headers
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 53s
2026-10-12 00:30:25 +02:00
9608582f9f Create window above
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 56s
2026-10-12 00:19:31 +02:00
f3fb4ad534 colors
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m7s
2026-10-11 22:50:37 +02:00
1fab8ce20d Bug fix
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 53s
2026-10-11 22:38:59 +02:00
1402045001 Foundry and discord bot
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m51s
2026-10-11 22:26:29 +02:00
a2b512699a Changed produciton url
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m44s
2026-06-21 00:54:55 +02:00
baee3c43b9 Good goy
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 47s
2026-06-08 11:24:57 +02:00
0fb4f01892 AI slop
All checks were successful
Build and Deploy Nuxt / build (push) Successful in 1m20s
2026-06-08 00:28:29 +02:00
110 changed files with 11414 additions and 412 deletions

View File

@@ -46,6 +46,12 @@ jobs:
docker build -t git.aranroig.com/${{ secrets.REGISTRY_USER }}/dragonroll-backend:latest ./backend docker build -t git.aranroig.com/${{ secrets.REGISTRY_USER }}/dragonroll-backend:latest ./backend
docker push git.aranroig.com/${{ secrets.REGISTRY_USER }}/dragonroll-backend:latest 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 - name: Copy files
run: | run: |
scp docker-compose.yml deploy@${{ secrets.DEPLOY_HOST}}:/var/www/app/ scp docker-compose.yml deploy@${{ secrets.DEPLOY_HOST}}:/var/www/app/

31
.gitea/workflows/test.yml Normal file
View File

@@ -0,0 +1,31 @@
name: Test
on:
push:
branches: ['**']
jobs:
test:
runs-on: docker
steps:
- name: Checkout
uses: actions/checkout@v4
- name: Setup Node
run: |
# The suite runs on Node's built-in test runner and needs Node 18+. The container the
# docker runner starts jobs in is not guaranteed to ship one, so fall back to the
# official LTS tarball. The tests themselves install no dependencies.
if node -e 'process.exit(Number(process.versions.node.split(".")[0]) >= 18 ? 0 : 1)' 2>/dev/null; then
node --version
else
apt-get update -y && apt-get install -y curl ca-certificates xz-utils
curl -fsSL https://nodejs.org/dist/v22.12.0/node-v22.12.0-linux-x64.tar.xz -o /tmp/node.tar.xz
tar -xJf /tmp/node.tar.xz -C /usr/local --strip-components=1
node --version
fi
- name: Run tests
run: npm test

1
.gitignore vendored
View File

@@ -1 +1,2 @@
node_modules node_modules
.env

582
AGENTS.md Normal file
View File

@@ -0,0 +1,582 @@
# 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 linter/formatter config, no Pinia/Vuex, and no
Vue Router pages (see §5.1 — the UI is a window manager, not routed pages). The only automated tests
are `tests/*.test.js` (`npm test`, Node's built-in runner), which exercise the Foundry module's sync
logic against stubbed Foundry globals.
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`.
`.gitea/workflows/test.yml` runs the `npm test` suite (frontend + Foundry module tests, no dependencies
installed) on every push to any branch, not just `master`.
## 2. Root layout
```
dragonroll/
├── backend/ Express API (CommonJS, entry: src/index.js)
├── frontend/ Nuxt 4 app (entry: app/app.vue)
├── obsidian-plugin/ Plain JavaScript Obsidian plugin for campaign note import/push
├── 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
├── tests/ `node --test` tests (Foundry module sync toggle)
├── 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
npm test # node --test tests/ (Foundry module sync logic, no dependencies)
```
There is no `start` script in either package and no lint command.
Verification = run the dev server and exercise the flow (`/api/test` returns a JSON hello);
`npm test` covers the Foundry character/item sync toggle and per-actor force sync.
### 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 Actor.js Item.js Map.js
│ FoundryLinkRequest.js DiscordLinkRequest.js DiscordGuildLink.js
├── routes/ user.js campaign.js note.js folder.js actor.js item.js map.js
│ foundry-link.js (token sync, mounted BEFORE auth) foundry.js (bridge proxy)
│ discord.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>`
│ ├── foundry.js requestFoundry(): reads the optional snapshot bridge
│ ├── foundry-fields.js shared asText/numberOr/plainText/stringList for the mappers
│ ├── actor-foundry.js foundryActorToCharacter(): Foundry actor document -> Actor fields
│ └── item-foundry.js foundryItemToItemData(): Foundry item document -> Item fields
└── 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`, `/api/actor`, `/api/item` and `/api/foundry`
(the read-only bridge proxy). `routes/foundry-link.js` is deliberately mounted **before** step 3 —
it authenticates with the per-campaign sync token instead of a Dragonroll login (see §4.1).
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
└───────< Actor (Foundry actors, when linked)
└───────< Item (Foundry gear + hand-made items)
└───────< Map (uploaded images + their grid settings)
```
| 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), `foundryWorldId` (unique, sparse), `foundryWorldTitle`, `foundrySystem`, `foundrySyncTokenHash` (`select: false`), `discordGuildId` |
| `Note` | `models/Note.js` | `title`, `content` (markdown source string), `campaign*` → Campaign, `folder` → Folder (null = root), `color` (hex string, sidebar entry background), `date` |
| `Folder` | `models/Folder.js` | `name*`, `campaign*` → Campaign, `parentFolder` → Folder (null = root), `color` (hex string, sidebar entry background), `date` |
| `Actor` | `models/Actor.js` | `name*`, `type` (`character`\|`npc`\|`creature`), `species`, `className`, `subclass`, `level`, `background`, `challengeRating`, `description`, `image`, `abilityScores{str..cha}`, `armorClass`, `speed`, `proficiencies`, `inventory[{name,quantity,weight}]` (flattened Foundry items, embedded — not `Item` docs), `traits`, `spells` (newline text), `campaign*` → Campaign, `foundryActorId` (unique per campaign), `date` |
| `Item` | `models/Item.js` | `name*`, `category` (`weapon`\|`armor`\|`shield`\|`adventuring-gear`\|`magic-item`\|`consumable`\|`tool`\|`treasure`\|`other`), `rarity` (`common`…`artifact`), `quantity`, `weight`, `properties`, `description`, `campaign*` → Campaign, `foundryItemId` (unique per campaign), `foundryNames` (names Foundry uses for it, keeps dedup stable across a Dragonroll rename), `date` |
| `Map` | `models/Map.js` | `name*`, `image` (filename in `src/uploads`), `gridSize` (cell size in image px), `offsetX`/`offsetY` (grid origin in image px), `scale` (distance one cell stands for), `campaign*` → Campaign, `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);
folder entries include `parentFolder` so clients can rebuild nested folder paths
`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?, color?}` — 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/update` — `{id*, name?, color?}` — partial, ownership checked
`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.
`GET /api/actor/list?campaign=` → `{status:'ok',actors}`
`POST /api/actor/create` — `{name*,campaign*,type?,species?,className?,subclass?,level?,background?,challengeRating?,description?}`
`POST /api/actor/update` — `{id*, name?, species?, className?, subclass?, level?, abilityScores?, armorClass?, speed?, proficiencies?, inventory?, traits?, spells?, image?}` — partial, ownership checked
`POST /api/actor/upload-image?actor=` — multipart field `image`
`POST /api/actor/delete` — `{id}`
`GET /api/item/list?campaign=` → `{status:'ok',items}`
`POST /api/item/create` — `{name*,campaign*,category?,rarity?,quantity?,weight?,properties?,description?}`
`POST /api/item/update` — `{id*, name?, category?, rarity?, quantity?, weight?, properties?, description?}` — partial, ownership checked. `''` for `quantity`/`weight` is ignored, like `/item/create`.
`POST /api/item/delete` — `{id}`
`GET /api/map/list?campaign=` → `{status:'ok',maps}`
`POST /api/map/create` — multipart (`image`) or JSON `{name*,campaign*,gridSize?,offsetX?,offsetY?,scale?}` → `{status:'ok',map}`
`POST /api/map/update` — `{id*, name?, gridSize?, offsetX?, offsetY?, scale?}`, partial, ownership checked. Send it as
multipart with an `image` field to replace the photo (multer reads the other fields from the form; JSON works too).
`POST /api/map/delete` — `{id}`
### 4.1 Foundry integration (actors, items)
`dragonroll-foundry/` holds the Foundry VTT module (`scripts/api.js`, loaded by `module.json`) and an
optional read-only snapshot bridge (`bridge/server.js`). The module talks to Dragonroll with a
per-campaign bearer token, **not** a Dragonroll login: `POST /api/foundry/link/complete` redeems a
pairing code, stores its hash on `Campaign.foundrySyncTokenHash` and hands the plain token to Foundry
once. Every sync route re-reads the campaign from that hash and rejects payloads whose `worldId` is
not `Campaign.foundryWorldId` (`syncCampaign` / `requestMatchesWorld`). CORS is opened for
`/api/foundry/sync*` and `/foundry/link/complete` in `src/index.js`, before the app-wide CORS.
`dragonroll-foundry/README.md` documents pairing, the bridge and its environment variables.
| Sync route (token) | Meaning |
|---|---|
| `POST /sync/snapshot` | `{worldId, actors[], items[], fullSync}` — upserts actors, world items and every item embedded in those actors; a `fullSync` also deletes actors/items that are gone |
| `POST /sync/item-snapshot` | `{worldId, items[]}` — live world-item edits, upsert only (never prunes) |
| `POST /sync/item-delete` | `{worldId, foundryItemId}` — a world item was deleted |
| `GET /sync/characters` | Actors the module applies back into Foundry |
| `GET /sync/items` | Items the module applies back into Foundry (creates world items for Dragonroll-authored ones) |
| `GET /sync/status` | The campaign a sync token belongs to; the module shows it in its **Dragonroll Pairing Status** setting and treats `unauthorized` as the campaign having unlinked the world |
| `POST /sync/map` / `POST /sync/map-item` | Store the id mapping after the module creates a document |
| `POST /sync/delete` | `{worldId, foundryActorId}` |
Rules worth knowing before editing this:
- **Identity** is `foundryActorId` / `foundryItemId` (unique per campaign, partial index so local
documents can leave it unset). A document carrying the `dragonroll-foundry.actorId` /
`dragonroll-foundry.itemId` flag adopts the matching Dragonroll row.
- **Items are deduplicated by name.** Foundry keeps the same gear once per carrier, so one Dragonroll
`Item` per name: the first document to claim it keeps the mapping, later copies just return it.
`foundryNames` remembers Foundry's names so a Dragonroll rename does not resurrect a duplicate.
`services/item-foundry.js` returns `null` for non-gear types (spells, classes, feats, species…),
which the sync skips.
- **`fullSync` preserves Dragonroll edits** (only new rows are overwritten); live Foundry events
overwrite. Item pruning requires the full snapshot, since only it sees world items and actor copies.
- **Autosync is a Foundry-side switch** (`autoSync` client setting, on by default): when off, the
module queues no CRUD push, runs no periodic reconcile and sends no startup snapshot; the actor
directory's `Dragonroll: Force Sync` entry still pushes the selected actors as an upsert
(`fullSync:false`, so it never prunes). The read-only bridge snapshot is not gated by it.
- **`pairingStatus` is a setting the module writes, not the GM**: the module settings sentence about
whether this world is connected comes from the stored sync token plus the answer from
`/sync/status` (checked at world start and every minute), and anything typed into it is replaced.
- `Actor.inventory` stays a flattened copy of the actor's embedded items; it is not linked to `Item`.
- `GET /api/foundry/*` (`routes/foundry.js`) is unrelated: a JWT-protected proxy over the read-only
bridge, only useful when `FOUNDRY_API_URL` is configured.
## 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}, map/MapViewerPane, 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. The note column shows the open notes, or the map anchored
on it (`AnchorMap` / `ActivePane` in `services/Content.js`); the sidebar's notes and maps buttons
switch between the two while both keep their state, and `viewer/map/MapViewerPane.vue` renders the
map there and inside the `map_viewer` window (a detached anchored map).
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: `ContentManager.vue` turns it on from a `watch(Campaign)`, `TopBar` off when leaving a campaign) and the anchored map: `ActivePane` (`'notes'`\|`'map'`), `AnchoredMap`, `SetActivePane`, `AnchorMap`, `ClearAnchoredMap` |
| `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` |
| `close-note` | note key (string) | `NoteContainer.vue` (removes the note from the open column only) |
| `delete-note` | note key (string) | `NoteContainer.vue`, `ContentSidebar.vue`, `NestedNoteList.vue` (real deletion: closes the note **and** removes it from the sidebar) |
| `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`
(`close-note` — the close button must not use `delete-note` or the sidebar entry disappears),
`NestedNoteList.vue` (`delete-note`, after `POST /note/delete`), `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.
### 5.9 Obsidian plugin
`obsidian-plugin/` is a plain JavaScript community plugin; copy `main.js` and `manifest.json` into
`<vault>/.obsidian/plugins/dragonroll-sync/` (details in its README). It signs in through
`POST /api/user/login`, saves the 48-hour JWT token in plugin data, and does not save the password.
The user selects a campaign from `GET /api/campaign/list`.
- **Import or refresh campaign notes** reads `/api/note/list` plus `/api/note/subfolder/list` and
creates/updates Markdown files under `Dragonroll/<Campaign>/`, preserving Dragonroll's folder tree.
- **Push active note to Dragonroll** creates a root campaign note or updates the note linked in its
frontmatter.
- `dragonrollId`, `dragonrollCampaign`, and `dragonrollTitle` frontmatter properties link imported
notes. They are omitted from content sent to Dragonroll. Per-note signatures detect local edits;
imports preserve modified local files, and push is explicit.
The plugin uses Obsidian's `requestUrl` helper, so the request path does not depend on browser CORS.
## 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.

View File

@@ -15,7 +15,7 @@ An open-source helper for role-playing games
# Dragonroll # Dragonroll
Dragonroll is an open source helper for role-playing games. Dragonroll is an open source connector for role-playing games.
## Features ## Features
@@ -24,6 +24,7 @@ Dragonroll is an open source helper for role-playing games.
- Play music during physical campaings - Play music during physical campaings
- Plan different encounters - Plan different encounters
- Manage different items and spells - Manage different items and spells
- Import and edit campaign notes in Obsidian with the [Dragonroll Sync plugin](obsidian-plugin/README.md)
- And so much more! - And so much more!
## Installation 🛠️ ## Installation 🛠️
@@ -49,3 +50,19 @@ or
``` ```
if you want to start the development environments if you want to start the development environments
## TODO
- Dragonroll <-> Foundry integration
- Dragonroll <-> Discord Bot integration
What to sync:
- Actors
- Monsters
- Items
- Notes
- Maps
- Music ?

View File

@@ -1,3 +1,5 @@
PORT=5000 PORT=5000
DB_URI=mongodb://10.1.1.7:27017/dragonroll 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

View File

@@ -40,13 +40,42 @@ require('./services/passport')(passport);
// CORS // CORS
app.use(cookieParser()); app.use(cookieParser());
app.use(cors({ // Services talk to Dragonroll from their own application (a Foundry world, an
// Obsidian vault, the Discord bot), so their link routes cannot be limited to
// one origin. What they may do is decided by the link code each of them holds.
const openCorsPaths = [
'/api/foundry/sync', '/foundry/sync',
'/api/link/start', '/link/start',
'/api/link/pickup', '/link/pickup',
];
const openCors = cors({
origin: true,
methods: ['GET', 'POST', 'OPTIONS'],
allowedHeaders: ['Authorization', 'Content-Type', 'X-Dragonroll-Discord-Bot-Secret'],
});
for (const path of openCorsPaths) {
app.use(path, openCors);
}
const appCors = cors({
origin: 'http://localhost:3000', origin: 'http://localhost:3000',
credentials: true, // if using cookies/auth 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) // ROUTES (NO AUTH)
app.use('/api/user', require('./routes/user')); app.use('/api/user', require('./routes/user'));
app.use('/api/discord', require('./routes/discord'));
// The one way every service (Foundry, Discord, Obsidian) links itself to a
// campaign: it asks for a sign-up link, a user opens it and picks the campaign.
// Each service authenticates with its own proof: the Discord bot with its
// secret, Foundry and Obsidian with the link code they were handed.
app.use('/api/link', require('./routes/service-link'));
app.use('/api/foundry', require('./routes/foundry-link'));
app.use('/foundry', require('./routes/foundry-link'));
// AUTH // AUTH
checkAuth = passport.authenticate('jwt', { session: false }); checkAuth = passport.authenticate('jwt', { session: false });
@@ -55,9 +84,13 @@ app.use(checkAuth);
// ROUTES WITH AUTH // ROUTES WITH AUTH
app.use('/api/campaign', require('./routes/campaign')); app.use('/api/campaign', require('./routes/campaign'));
app.use('/api/note', require('./routes/note')); 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/map', require('./routes/map'));
app.use('/api/foundry', require('./routes/foundry'));
/* /*
app.use('/campaign', require('./routes/campaign')); app.use('/campaign', require('./routes/campaign'));
app.use('/maps', require('./routes/map'));
app.use('/datagen', require('./routes/datagen')); app.use('/datagen', require('./routes/datagen'));
app.use('/admin', require('./routes/admin')); app.use('/admin', require('./routes/admin'));
*/ */

View 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);

View File

@@ -11,7 +11,14 @@ const CampaignSchema = new Schema({
required: true required: true
}, },
date: { type: Date, default: Date.now}, 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);

View 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);

View File

@@ -0,0 +1,19 @@
const mongoose = require('mongoose');
const Schema = mongoose.Schema;
const FolderSchema = new Schema({
name: { type: String, required: true },
campaign: {
type: Schema.Types.ObjectId,
ref: 'Campaign',
required: true
},
parentFolder: {
type: Schema.Types.ObjectId,
ref: 'Folder'
},
color: { type: String },
date: { type: Date, default: Date.now }
});
module.exports = mongoose.model('Folder', FolderSchema);

View File

@@ -0,0 +1,38 @@
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
},
foundryItemId: { type: String },
// Names Foundry uses for this item. Dragonroll may rename it, and the copies
// Foundry keeps sending still have to fold into this row instead of
// creating a second item under their original name.
foundryNames: { type: [String], default: [] },
date: { type: Date, default: Date.now }
});
ItemSchema.index(
{ campaign: 1, foundryItemId: 1 },
{ unique: true, partialFilterExpression: { foundryItemId: { $type: 'string' } } }
);
module.exports = mongoose.model('Item', ItemSchema);

23
backend/src/models/Map.js Normal file
View File

@@ -0,0 +1,23 @@
const mongoose = require('mongoose');
const Schema = mongoose.Schema;
const MapSchema = new Schema({
name: { type: String, required: true, trim: true },
// Uploaded image, served from /api/public/<filename>
image: { type: String, default: '' },
// Grid cell size in image pixels
gridSize: { type: Number, min: 1, default: 50 },
// Grid origin, in image pixels from the top left corner of the image
offsetX: { type: Number, default: 0 },
offsetY: { type: Number, default: 0 },
// Distance each grid cell stands for (feet, metres...)
scale: { type: Number, min: 0.01, default: 5 },
campaign: {
type: Schema.Types.ObjectId,
ref: 'Campaign',
required: true
},
date: { type: Date, default: Date.now }
});
module.exports = mongoose.model('Map', MapSchema);

View File

@@ -9,6 +9,11 @@ const NoteSchema = new Schema({
ref: 'Campaign', ref: 'Campaign',
required: true required: true
}, },
folder: {
type: Schema.Types.ObjectId,
ref: 'Folder'
},
color: { type: String },
date: { type: Date, default: Date.now } date: { type: Date, default: Date.now }
}); });

View File

@@ -0,0 +1,44 @@
const mongoose = require('mongoose');
const Schema = mongoose.Schema;
// One row per service installation that wants to use a campaign: a Foundry
// world, a Discord server, an Obsidian vault. Asking for a link resets the row
// to a fresh pending request, so a service always has one row and that row is
// also the record of the link that is active right now.
//
// The service starts the request and shows the sign-up link it gets back; a
// Dragonroll user then signs in through that link and picks the campaign. The
// service picks its credential up with the same code it was given.
const ServiceLinkRequestSchema = new Schema({
service: { type: String, enum: ['foundry', 'discord', 'obsidian'], required: true },
// Who is asking, in its own terms: Foundry world id, Discord guild id, vault id.
targetId: { type: String },
targetName: { type: String },
// The person who asked, as far as the service knows: GM name, Discord user...
targetUser: { type: String },
// Whatever else the service describes itself with (Foundry system and URL).
targetMeta: { type: Object },
codeHash: { type: String, required: true, unique: true },
campaign: { type: Schema.Types.ObjectId, ref: 'Campaign' },
dragonrollUser: { type: Schema.Types.ObjectId, ref: 'User' },
// 'pending' until a Dragonroll user picks a campaign through the sign-up
// link, 'linked' while that choice stands, 'revoked' once the campaign
// unlinked the service again.
state: { type: String, enum: ['pending', 'linked', 'revoked'], default: 'pending' },
// What the service gets when it picks the link up: the Foundry sync token,
// the Obsidian session. Dropped as soon as it has been delivered.
credentials: { type: Object, select: false },
createdAt: { type: Date, default: Date.now },
// Only a request nobody answers expires: an empty value keeps the link.
expiresAt: { type: Date },
linkedAt: { type: Date },
pickedUpAt: { type: Date },
// The Discord bot has confirmed this authorization in Discord.
notifiedAt: { type: Date }
});
ServiceLinkRequestSchema.index({ expiresAt: 1 }, { expireAfterSeconds: 0 });
ServiceLinkRequestSchema.index({ service: 1, targetId: 1 });
ServiceLinkRequestSchema.index({ campaign: 1, service: 1, state: 1 });
module.exports = mongoose.model('ServiceLinkRequest', ServiceLinkRequestSchema);

111
backend/src/routes/actor.js Normal file
View 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;

View File

@@ -2,6 +2,28 @@ const express = require('express')
const router = express.Router(); const router = express.Router();
const Campaign = require("../models/Campaign"); const Campaign = require("../models/Campaign");
const User = require('../models/User');
const serviceLinks = require('../services/service-links');
// Every service links to a campaign through the same sign-up link
// (routes/service-link.js); a campaign only drops one of them again.
async function unlinkService(campaign, service) {
if (service === 'foundry') {
campaign.foundryWorldId = undefined;
campaign.foundryWorldTitle = undefined;
campaign.foundrySystem = undefined;
campaign.set('foundrySyncTokenHash', undefined);
} else if (service === 'discord') {
// The Discord account the bot answers to stays: the server is simply
// left without a campaign until somebody picks one again.
campaign.discordGuildId = undefined;
}
await campaign.save();
// A link a service still holds becomes invalid, and it finds that out the
// next time it asks where its link stands.
await serviceLinks.revokeServiceLink(service, campaign._id);
}
router.post('/create', async (req, res) => { router.post('/create', async (req, res) => {
try { try {
@@ -21,6 +43,84 @@ 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" });
}
});
// Which services a campaign has connected, and the account each of them was
// authorized with.
router.get('/services', 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 links = await serviceLinks.listLinkedServices(campaign._id);
const userIds = [...new Set(links.map((link) => String(link.dragonrollUser ?? '')).filter(Boolean))];
const users = userIds.length
? await User.find({ _id: { $in: userIds } }).select('username name').lean()
: [];
const names = new Map(users.map((user) => [String(user._id), user.username || user.name]));
res.json({
status: 'ok',
services: links.map((link) => ({
...link,
dragonrollUserName: names.get(String(link.dragonrollUser ?? '')) || null
}))
});
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/service-unlink', async (req, res) => {
try {
const service = String(req.body.service || '').trim();
if (!serviceLinks.isService(service)) return res.json({ status: 'error', msg: 'errors.missing-data' });
const campaign = await Campaign.findOne({ _id: req.body.campaignId, createdBy: req.user.id });
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
await unlinkService(campaign, service);
res.json({ status: 'ok', campaign, services: await serviceLinks.listLinkedServices(campaign._id) });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.get('/list', async (req, res) => { router.get('/list', async (req, res) => {
try { try {
const campaigns = await Campaign.find({ createdBy: req.user.id }); const campaigns = await Campaign.find({ createdBy: req.user.id });

View File

@@ -0,0 +1,182 @@
const express = require('express');
const router = express.Router();
const Actor = require('../models/Actor');
const Campaign = require('../models/Campaign');
const DiscordGuildLink = require('../models/DiscordGuildLink');
const ServiceLinkRequest = require('../models/ServiceLinkRequest');
const User = require('../models/User');
const serviceLinks = require('../services/service-links');
const NOTIFICATION_LIMIT = 10;
const requireBot = serviceLinks.requireDiscordBot;
function validGuildId(value) {
return /^\d{5,25}$/.test(String(value ?? ''));
}
// Connecting a Discord server is the service link of issue: the bot asks
// /api/link/start for a sign-up link, and whoever opens it signs in and picks the
// campaign this server may read. What is left here is what the bot needs once
// that link exists: confirming it in Discord and working with its campaign.
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 ServiceLinkRequest.find({
service: 'discord',
state: 'linked',
linkedAt: { $gte: new Date(Date.now() - serviceLinks.NOTIFICATION_WINDOW_MS) },
notifiedAt: null
}).select('_id targetId targetName targetUser targetMeta dragonrollUser campaign')
.limit(NOTIFICATION_LIMIT)
.lean();
const claimed = [];
for (const request of pending) {
const taken = await ServiceLinkRequest.findOneAndUpdate(
{ _id: request._id, notifiedAt: null },
{ $set: { notifiedAt: new Date() } },
{ new: true }
).lean();
if (taken) claimed.push(request);
}
const names = await dragonrollUserNames(claimed);
const campaignIds = [...new Set(claimed.map((request) => String(request.campaign ?? '')).filter(Boolean))];
const campaigns = campaignIds.length
? await Campaign.find({ _id: { $in: campaignIds } }).select('_id name').lean()
: [];
const campaignNames = new Map(campaigns.map((campaign) => [String(campaign._id), campaign.name]));
res.json({
status: 'ok',
notifications: claimed.map((request) => ({
id: String(request._id),
guildId: request.targetId,
guildName: request.targetName,
discordUserId: request.targetMeta?.userId || '',
discordUserName: request.targetUser,
dragonrollUserName: names.get(String(request.dragonrollUser ?? '')) || null,
campaignName: campaignNames.get(String(request.campaign ?? '')) || 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;

View File

@@ -0,0 +1,128 @@
const express = require('express');
const router = express.Router();
const Campaign = require('../models/Campaign');
const Folder = require('../models/Folder');
const Note = require('../models/Note');
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' });
const hasAccess = await userOwnsCampaign(campaign, req.user.id);
if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
const folders = await Folder.find({ campaign })
.select('_id name date color')
.sort({ date: -1 })
.lean();
res.json({ status: 'ok', folders });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/create', async (req, res) => {
try {
const { name, campaign } = req.body;
if (!name || !campaign) return res.json({ status: 'error', msg: 'errors.missing-data' });
const hasAccess = await userOwnsCampaign(campaign, req.user.id);
if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
const newFolder = new Folder({
name: name.trim(),
campaign
});
await newFolder.save();
res.json({ status: 'ok', folder: newFolder });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/update', async (req, res) => {
try {
const { id, name, color } = req.body;
if (!id) return res.json({ status: 'error', msg: 'errors.missing-data' });
const folder = await Folder.findById(id);
if (!folder) return res.json({ status: 'error', msg: 'errors.notfound' });
const hasAccess = await userOwnsCampaign(folder.campaign, req.user.id);
if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
if (name !== undefined) folder.name = String(name).trim();
if (color !== undefined) folder.color = color;
await folder.save();
res.json({ status: 'ok', folder });
} 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 folder = await Folder.findById(id);
if (!folder) return res.json({ status: 'error', msg: 'errors.notfound' });
const hasAccess = await userOwnsCampaign(folder.campaign, req.user.id);
if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
async function moveRecursive(folderId) {
const subfolders = await Folder.find({ parentFolder: folderId }).select('_id').lean();
await Note.updateMany(
{ folder: folderId },
{ $set: { folder: null, date: Date.now() } }
);
await Folder.deleteOne({ _id: folderId });
for (const sub of subfolders) {
await moveRecursive(sub._id);
}
}
await moveRecursive(id);
res.json({ status: 'ok' });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/rename', async (req, res) => {
try {
const { id, name } = req.body;
if (!id || !name) return res.json({ status: 'error', msg: 'errors.missing-data' });
const folder = await Folder.findById(id);
if (!folder) return res.json({ status: 'error', msg: 'errors.notfound' });
const hasAccess = await userOwnsCampaign(folder.campaign, req.user.id);
if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
folder.name = name.trim();
await folder.save();
res.json({ status: 'ok', folder });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
module.exports = router;

View File

@@ -0,0 +1,320 @@
const crypto = require('node:crypto');
const express = require('express');
const mongoose = require('mongoose');
const router = express.Router();
const Campaign = require('../models/Campaign');
const Actor = require('../models/Actor');
const Item = require('../models/Item');
const { foundryActorToCharacter } = require('../services/actor-foundry');
const { foundryItemToItemData } = require('../services/item-foundry');
// Upper bound for the Foundry names remembered per synced item (see Item model).
const MAX_FOUNDRY_NAMES = 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 };
}
// A snapshot carries world-level items plus the items embedded in every actor it
// sends. World items are listed first so they own a name before its copies.
function snapshotItemSources(body) {
const sources = [];
if (Array.isArray(body.items)) sources.push(...body.items);
if (Array.isArray(body.actors)) {
for (const actor of body.actors) {
if (Array.isArray(actor?.items)) sources.push(...actor.items);
}
}
return sources;
}
async function saveFoundryItem(campaign, source, fullSync = false) {
const foundryItemId = String(source?._id || source?.id || '').trim().slice(0, 120);
const fields = foundryItemToItemData(source || {});
if (!foundryItemId || !fields) return null;
let item = await Item.findOne({ campaign: campaign._id, foundryItemId });
const dragonrollItemId = source?.flags?.['dragonroll-foundry']?.itemId;
if (!item && mongoose.isValidObjectId(dragonrollItemId)) {
const flagged = await Item.findOne({ _id: dragonrollItemId, campaign: campaign._id });
// Only adopt a flagged item while no other Foundry document owns its mapping.
if (flagged && (!flagged.foundryItemId || flagged.foundryItemId === foundryItemId)) item = flagged;
}
if (!item) {
// The same gear exists more than once in Foundry: once in the world
// directory and once inside each actor carrying it. Keep a single
// Dragonroll item per name so inventories do not flood the Item list.
const sameName = await Item.find({
campaign: campaign._id,
$or: [{ name: fields.name }, { foundryNames: fields.name }]
}).limit(4);
const represented = sameName.find((candidate) => candidate.foundryItemId);
if (represented) return { foundryItemId, itemId: represented.id };
const unclaimed = sameName.filter((candidate) => !candidate.foundryItemId);
item = unclaimed.length === 1 ? unclaimed[0] : new Item({ campaign: campaign._id, name: fields.name });
}
item.foundryItemId = foundryItemId;
if (!fullSync || item.isNew) Object.assign(item, fields);
if (!item.foundryNames.includes(fields.name)) {
item.foundryNames = [...item.foundryNames, fields.name].slice(-MAX_FOUNDRY_NAMES);
}
await item.save();
return { foundryItemId, itemId: item.id };
}
async function syncFoundryItems(campaign, sources, fullSync = false) {
const items = [];
for (const source of sources) {
const mapping = await saveFoundryItem(campaign, source, fullSync);
if (mapping) items.push(mapping);
}
return items;
}
// Linking a world to a campaign happens through the sign-up link every service
// uses (routes/service-link.js); what stays here is the sync that world keeps up
// with the campaign once that link has handed it its token.
// The Foundry module shows this in its settings: the sync token alone only proves
// a link was made once, so the module asks which campaign it belongs to and hears
// back nothing but `unauthorized` once that campaign unlinks the world again.
router.get('/sync/status', async (req, res) => {
try {
const campaign = await syncCampaign(req, res);
if (!campaign) return;
res.set('Cache-Control', 'no-store');
res.json({
status: 'ok',
campaign: { id: campaign.id, name: campaign.name },
worldId: campaign.foundryWorldId
});
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/sync/snapshot', async (req, res) => {
try {
const campaign = await syncCampaign(req, res);
if (!campaign) return;
const actorSources = Array.isArray(req.body.actors) ? req.body.actors : null;
const itemSources = Array.isArray(req.body.items) ? req.body.items : null;
if (!requestMatchesWorld(campaign, req.body.worldId) || (!actorSources && !itemSources)) {
return res.json({ status: 'error', msg: 'errors.missing-data' });
}
const fullSync = req.body.fullSync === true;
const actors = [];
for (const source of actorSources || []) {
const mapping = await saveFoundryActor(campaign, source, fullSync);
if (mapping) actors.push(mapping);
}
const items = await syncFoundryItems(campaign, snapshotItemSources(req.body), fullSync);
if (fullSync && actorSources) {
const currentIds = actorSources
.map((source) => String(source?._id || source?.id || '').trim())
.filter(Boolean);
await Actor.deleteMany({
campaign: campaign._id,
foundryActorId: { $exists: true, $nin: currentIds }
});
}
// Pruning needs a full snapshot: only that request sees the world
// directory and every actor's copies at the same time.
if (fullSync && itemSources) {
const currentIds = snapshotItemSources(req.body)
.map((source) => String(source?._id || source?.id || '').trim())
.filter(Boolean);
await Item.deleteMany({
campaign: campaign._id,
foundryItemId: { $exists: true, $nin: currentIds }
});
}
res.json({ status: 'ok', actors, items });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
// Live Foundry item edits: upserts only, never prunes. Removing items that no
// longer exist is left to the full snapshot sent with the actors.
router.post('/sync/item-snapshot', async (req, res) => {
try {
const campaign = await syncCampaign(req, res);
if (!campaign) return;
if (!requestMatchesWorld(campaign, req.body.worldId) || !Array.isArray(req.body.items)) {
return res.json({ status: 'error', msg: 'errors.missing-data' });
}
res.json({ status: 'ok', items: await syncFoundryItems(campaign, req.body.items) });
} 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' });
}
});
// Only world-level Foundry items reach this route: an item dropped by an actor
// still exists in the world, and its actor snapshot overwrites the inventory.
router.post('/sync/item-delete', async (req, res) => {
try {
const campaign = await syncCampaign(req, res);
if (!campaign) return;
const foundryItemId = String(req.body.foundryItemId || '').trim();
if (!requestMatchesWorld(campaign, req.body.worldId) || !foundryItemId) {
return res.json({ status: 'error', msg: 'errors.missing-data' });
}
await Item.deleteOne({ campaign: campaign._id, foundryItemId });
res.json({ status: 'ok' });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.get('/sync/items', async (req, res) => {
try {
const campaign = await syncCampaign(req, res);
if (!campaign) return;
const items = await Item.find({ campaign: campaign._id }).sort({ name: 1 }).lean();
res.json({ status: 'ok', items });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/sync/map-item', async (req, res) => {
try {
const campaign = await syncCampaign(req, res);
if (!campaign) return;
const { itemId, foundryItemId, worldId } = req.body;
if (!requestMatchesWorld(campaign, worldId) || !itemId || !foundryItemId) {
return res.json({ status: 'error', msg: 'errors.missing-data' });
}
const item = await Item.findOne({ _id: itemId, campaign: campaign._id });
if (!item) return res.json({ status: 'error', msg: 'errors.notfound' });
const existing = await Item.findOne({ campaign: campaign._id, foundryItemId, _id: { $ne: item._id } });
if (existing) return res.json({ status: 'error', msg: 'foundry.errors.item-already-synced' });
item.foundryItemId = String(foundryItemId).trim().slice(0, 120);
await item.save();
res.json({ status: 'ok', item });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
module.exports = router;

View 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;

View File

@@ -0,0 +1,85 @@
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('/update', async (req, res) => {
try {
const { id, name, category, rarity, quantity, weight, properties, description } = 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' });
if (name !== undefined) item.name = String(name).trim();
if (category !== undefined) item.category = category;
if (rarity !== undefined) item.rarity = rarity;
if (quantity !== undefined && quantity !== '') item.quantity = Number(quantity);
if (weight !== undefined && weight !== '') item.weight = Number(weight);
if (properties !== undefined) item.properties = properties;
if (description !== undefined) item.description = description;
await item.save();
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;

95
backend/src/routes/map.js Normal file
View File

@@ -0,0 +1,95 @@
const express = require('express');
const router = express.Router();
const upload = require('../services/storage');
const Campaign = require('../models/Campaign');
const Map = require('../models/Map');
async function userOwnsCampaign(campaignId, userId) {
const campaign = await Campaign.findOne({ _id: campaignId, createdBy: userId }).lean();
return Boolean(campaign);
}
// Grid values arrive as strings when the request is a multipart form upload.
function toNumber(value, fallback) {
if (value === undefined || value === null || value === '') return fallback;
const number = Number(value);
return Number.isFinite(number) ? number : fallback;
}
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 maps = await Map.find({ campaign }).sort({ name: 1 }).lean();
res.json({ status: 'ok', maps });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/create', upload.single('image'), async (req, res) => {
try {
const { name, campaign, gridSize, offsetX, offsetY, scale } = 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 map = await Map.create({
name: name.trim(), campaign,
image: req.file ? req.file.filename : '',
gridSize: toNumber(gridSize, 50),
offsetX: toNumber(offsetX, 0),
offsetY: toNumber(offsetY, 0),
scale: toNumber(scale, 5)
});
res.json({ status: 'ok', map });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.post('/update', upload.single('image'), async (req, res) => {
try {
const { id, name, gridSize, offsetX, offsetY, scale } = req.body;
if (!id) return res.json({ status: 'error', msg: 'errors.missing-data' });
const map = await Map.findById(id);
if (!map) return res.json({ status: 'error', msg: 'errors.notfound' });
if (!(await userOwnsCampaign(map.campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
if (name !== undefined) map.name = String(name).trim();
if (gridSize !== undefined) map.gridSize = toNumber(gridSize, map.gridSize);
if (offsetX !== undefined) map.offsetX = toNumber(offsetX, map.offsetX);
if (offsetY !== undefined) map.offsetY = toNumber(offsetY, map.offsetY);
if (scale !== undefined) map.scale = toNumber(scale, map.scale);
if (req.file) map.image = req.file.filename;
await map.save();
res.json({ status: 'ok', map });
} 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 map = await Map.findById(id);
if (!map) return res.json({ status: 'error', msg: 'errors.notfound' });
if (!(await userOwnsCampaign(map.campaign, req.user.id))) return res.json({ status: 'error', msg: 'unauthorized' });
await map.deleteOne();
res.json({ status: 'ok' });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
module.exports = router;

View File

@@ -1,8 +1,9 @@
const express = require('express'); const express = require('express');
const router = express.Router(); const router = express.Router();
const Campaign = require("../models/Campaign"); const Campaign = require('../models/Campaign');
const Note = require("../models/Note"); const Note = require('../models/Note');
const Folder = require('../models/Folder');
async function userOwnsCampaign(campaignId, userId) { async function userOwnsCampaign(campaignId, userId) {
const campaign = await Campaign.findOne({ _id: campaignId, createdBy: userId }).lean(); const campaign = await Campaign.findOne({ _id: campaignId, createdBy: userId }).lean();
@@ -12,74 +13,116 @@ async function userOwnsCampaign(campaignId, userId) {
router.get('/list', async (req, res) => { router.get('/list', async (req, res) => {
try { try {
const { campaign } = req.query; const { campaign } = req.query;
if (!campaign) return res.json({ status: "error", msg: "errors.missing-data" }); if (!campaign) return res.json({ status: 'error', msg: 'errors.missing-data' });
const hasAccess = await userOwnsCampaign(campaign, req.user.id); const hasAccess = await userOwnsCampaign(campaign, req.user.id);
if (!hasAccess) return res.json({ status: "error", msg: "unauthorized" }); if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
const notes = await Note.find({ campaign }) const folders = await Folder.find({ campaign })
.select('_id title content date campaign') .select('_id name parentFolder date color')
.sort({ date: -1 }) .sort({ date: -1 })
.lean(); .lean();
res.json({ status: "ok", notes }); const rootNotes = await Note.find({ campaign, folder: null })
.select('_id title content date color')
.sort({ date: -1 })
.lean();
res.json({ status: 'ok', folders, notes: rootNotes });
} catch (err) { } catch (err) {
console.error(err); console.error(err);
res.json({ status: "error", msg: "errors.internal" }); res.json({ status: 'error', msg: 'errors.internal' });
}
});
router.get('/subfolder/list', async (req, res) => {
try {
const { campaign, folder } = req.query;
if (!campaign || !folder) return res.json({ status: 'error', msg: 'errors.missing-data' });
const hasAccess = await userOwnsCampaign(campaign, req.user.id);
if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
// Verify folder belongs to campaign
const folderDoc = await Folder.findOne({ _id: folder, campaign }).lean();
if (!folderDoc) return res.json({ status: 'error', msg: 'errors.notfound' });
const subfolders = await Folder.find({ campaign, parentFolder: folder })
.select('_id name date color')
.sort({ date: -1 })
.lean();
const notes = await Note.find({ campaign, folder: folder })
.select('_id title content date color')
.sort({ date: -1 })
.lean();
res.json({ status: 'ok', subfolders, notes });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
} }
}); });
router.post('/create', async (req, res) => { router.post('/create', async (req, res) => {
try { try {
const { title, content, campaign } = req.body; const { title, content, campaign, folder } = req.body;
const hasAccess = await userOwnsCampaign(campaign, req.user.id); if (!title || !campaign) return res.json({ status: 'error', msg: 'errors.missing-data' });
if (!hasAccess) return res.json({ status: "error", msg: "unauthorized" });
const newNote = new Note({ const hasAccess = await userOwnsCampaign(campaign, req.user.id);
title, if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
content,
campaign let effectiveFolder = null;
}); if (folder) {
const folderDoc = await Folder.findOne({ _id: folder, campaign }).lean();
if (!folderDoc) return res.json({ status: 'error', msg: 'errors.notfound' });
effectiveFolder = folder;
}
const newNote = new Note({ title, content, campaign, folder: effectiveFolder });
await newNote.save(); await newNote.save();
res.json({ status: "ok", note: newNote }); res.json({ status: 'ok', note: newNote });
} catch (err) { } catch (err) {
console.error(err); console.error(err);
res.json({ status: "error", msg: "errors.internal" }); res.json({ status: 'error', msg: 'errors.internal' });
} }
}); });
router.post('/update', async (req, res) => { router.post('/update', async (req, res) => {
try { try {
const { id, title, content } = req.body; const { id, title, content, folder, color } = req.body;
const note = await Note.findById(id); if (!id) return res.json({ status: 'error', msg: 'errors.missing-data' });
if (!note) return res.json({ status: "error", msg: "errors.notfound" });
const hasAccess = await userOwnsCampaign(note.campaign, req.user.id);
if (!hasAccess) return res.json({ status: "error", msg: "unauthorized" });
if(title) note.title = title; const note = await Note.findById(id);
note.content = content; if (!note) return res.json({ status: 'error', msg: 'errors.notfound' });
note.date = Date.now();
const hasAccess = await userOwnsCampaign(note.campaign, req.user.id);
if (!hasAccess) return res.json({ status: 'error', msg: 'unauthorized' });
if (title !== undefined) note.title = title;
if (content !== undefined) note.content = content;
if (folder !== undefined) note.folder = folder;
if (color !== undefined) note.color = color;
await note.save(); await note.save();
res.json({ status: "ok", note }); res.json({ status: 'ok', note });
} catch (err) { } catch (err) {
console.error(err); console.error(err);
res.json({ status: "error", msg: "errors.internal" }); res.json({ status: 'error', msg: 'errors.internal' });
} }
}); });
router.post('/delete', async (req, res) => { router.post('/delete', async (req, res) => {
try { try {
const { id } = req.body; const { id } = req.body;
const note = await Note.findById(id); if (!id) return res.json({ status: 'error', msg: 'errors.missing-data' });
if (!note) return res.json({ status: "error", msg: "errors.notfound" });
const hasAccess = await userOwnsCampaign(note.campaign, req.user.id);
if (!hasAccess) return res.json({ status: "error", msg: "unauthorized" });
await note.remove(); const result = await Note.deleteOne({ _id: id });
res.json({ status: "ok" }); if (result.deletedCount === 0) return res.json({ status: 'error', msg: 'errors.notfound' });
res.json({ status: 'ok' });
} catch (err) { } catch (err) {
console.error(err); console.error(err);
res.json({ status: "error", msg: "errors.internal" }); res.json({ status: 'error', msg: 'errors.internal' });
} }
}); });

View File

@@ -0,0 +1,209 @@
const crypto = require('node:crypto');
const express = require('express');
const jwt = require('jsonwebtoken');
const passport = require('passport');
const rateLimit = require('express-rate-limit');
const router = express.Router();
const Campaign = require('../models/Campaign');
const DiscordGuildLink = require('../models/DiscordGuildLink');
const secret = require('../services/keys').secret;
const serviceLinks = require('../services/service-links');
const linkRateLimit = rateLimit({ windowMs: 15 * 60 * 1000, max: 40 });
const GUILD_ID = /^\d{5,25}$/;
// What the sign-up screen shows about the request behind a code.
function publicRequest(request) {
return {
service: request.service,
serviceName: serviceLinks.serviceName(request.service),
targetName: request.targetName,
targetUser: request.targetUser,
system: request.targetMeta?.system || '',
expiresAt: request.expiresAt
};
}
// A session for a service that keeps working once the browser which authorised
// it is gone: Obsidian gets the same kind of session signing in gives, so its
// notes keep travelling over the routes they always used.
function userSession(user) {
const payload = {
_id: user._id,
username: user.username,
name: user.name,
email: user.email,
admin: user.admin,
settings: user.settings
};
return jwt.sign(payload, secret, { expiresIn: 172800 });
}
// A Foundry world tells Dragonroll who it is when it asks for its link, so the
// user only has to say which campaign the world may work on.
async function completeFoundryLink(campaign, request) {
const linkedElsewhere = await Campaign.findOne({
foundryWorldId: request.targetId,
_id: { $ne: campaign._id }
}).select('_id');
if (linkedElsewhere) return { msg: 'foundry.errors.world-already-linked' };
campaign.foundryWorldId = request.targetId;
campaign.foundryWorldTitle = request.targetName;
campaign.foundrySystem = request.targetMeta?.system || '';
const settings = campaign.settings && typeof campaign.settings === 'object' ? campaign.settings : {};
const integrations = settings.integrations && typeof settings.integrations === 'object' ? settings.integrations : {};
const foundryUrl = request.targetMeta?.url || '';
if (foundryUrl && !integrations.foundryUrl) {
campaign.settings = { ...settings, integrations: { ...integrations, foundryUrl } };
}
const syncToken = crypto.randomBytes(32).toString('base64url');
campaign.foundrySyncTokenHash = serviceLinks.codeHash(syncToken);
await campaign.save();
const bridgeUrl = process.env.FOUNDRY_API_CLIENT_URL || process.env.FOUNDRY_API_URL;
const pushToken = process.env.FOUNDRY_API_PUSH_TOKEN;
return {
credentials: {
syncToken,
bridgeConfig: bridgeUrl && pushToken ? { url: bridgeUrl, pushToken } : null
}
};
}
// The Discord account behind the request is the one the bot answers to; a new
// authorization takes the server over from whoever held it before.
async function completeDiscordLink(campaign, request, user) {
await Campaign.updateMany(
{ discordGuildId: request.targetId, createdBy: { $ne: user.id } },
{ $unset: { discordGuildId: 1 } }
);
await DiscordGuildLink.findOneAndUpdate({ guildId: request.targetId }, {
$set: {
discordUserId: request.targetMeta?.userId || request.targetId,
dragonrollUser: user.id,
connectedAt: new Date()
}
}, { new: true, upsert: true, setDefaultsOnInsert: true });
campaign.discordGuildId = request.targetId;
await campaign.save();
}
// A service asks for a sign-up link and shows it to whoever is sitting in front
// of it. Nothing is linked until a Dragonroll user opens that link, signs in and
// picks one of their campaigns.
router.post('/start', linkRateLimit, async (req, res) => {
try {
const service = String(req.body.service || '').trim();
if (!serviceLinks.isService(service)) return res.json({ status: 'error', msg: 'link.errors.unknown-service' });
// A service that can prove who it is gets its link checked: a Discord
// server is claimed by whoever runs the bot, not by whoever knows its id.
if (serviceLinks.isBotOnly(service) && !serviceLinks.isDiscordBot(req)) {
return res.status(401).json({ status: 'error', msg: 'errors.unauthorized' });
}
const target = serviceLinks.readTarget(req.body);
if (!target.targetId) return res.json({ status: 'error', msg: 'errors.missing-data' });
if (service === 'discord' && (!GUILD_ID.test(target.targetId) || !target.targetName || !target.targetUser)) {
return res.json({ status: 'error', msg: 'errors.missing-data' });
}
const link = await serviceLinks.startServiceLink(service, target);
res.set('Cache-Control', 'no-store');
res.json({ status: 'ok', service, code: link.code, linkUrl: link.url, expiresAt: link.expiresAt });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
// What a sign-up link is about, so the screen can name the world, Discord server
// or vault that is waiting, and the person who asked.
router.post('/details', async (req, res) => {
try {
res.set('Cache-Control', 'no-store');
const request = await serviceLinks.findServiceLinkByCode(req.body.code);
if (!request || serviceLinks.linkIsExpired(request)) {
return res.json({ status: 'error', msg: 'link.errors.expired' });
}
res.json({ status: 'ok', ...publicRequest(request) });
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
// The user who signs in through a link owns the campaigns listed there, so
// picking one of them is the whole authorization.
router.post('/complete', passport.authenticate('jwt', { session: false }), async (req, res) => {
try {
res.set('Cache-Control', 'no-store');
const request = await serviceLinks.findServiceLinkByCode(req.body.code);
if (!request || serviceLinks.linkIsExpired(request)) {
return res.json({ status: 'error', msg: 'link.errors.expired' });
}
const campaign = await Campaign.findOne({ _id: req.body.campaignId, createdBy: req.user.id });
if (!campaign) return res.json({ status: 'error', msg: 'errors.notfound' });
if (request.service === 'discord' && campaign.discordGuildId && campaign.discordGuildId !== request.targetId) {
return res.json({ status: 'error', msg: 'discord.errors.campaign-already-linked' });
}
if (request.service === 'foundry') {
const linked = await completeFoundryLink(campaign, request);
if (linked.msg) return res.json({ status: 'error', msg: linked.msg });
await serviceLinks.completeServiceLink(request, campaign, req.user, linked.credentials);
} else if (request.service === 'discord') {
await completeDiscordLink(campaign, request, req.user);
await serviceLinks.completeServiceLink(request, campaign, req.user);
} else {
await serviceLinks.completeServiceLink(request, campaign, req.user, { token: userSession(req.user) });
}
res.json({ status: 'ok', service: request.service, campaign: { id: campaign.id, name: campaign.name } });
} 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' });
}
});
// Where a link stands, and what the service that asked for it gets out of it.
// A credential is delivered once: a service that loses it asks for a new link.
router.post('/pickup', async (req, res) => {
try {
res.set('Cache-Control', 'no-store');
const request = await serviceLinks.findServiceLinkByCode(req.body.code);
if (!request || serviceLinks.linkIsExpired(request)) {
return res.json({ status: 'ok', state: 'expired' });
}
if (request.state !== 'linked') {
return res.json({ status: 'ok', state: request.state, campaign: null });
}
const campaign = await Campaign.findOne({ _id: request.campaign }).select('_id name').lean();
const credentials = await serviceLinks.takeServiceLinkCredentials(request);
res.json({
status: 'ok',
state: 'linked',
service: request.service,
campaign: campaign ? { id: String(campaign._id), name: campaign.name } : null,
syncToken: credentials?.syncToken || '',
bridgeConfig: credentials?.bridgeConfig || null,
token: credentials?.token || ''
});
} catch (err) {
console.error(err);
res.json({ status: 'error', msg: 'errors.internal' });
}
});
module.exports = router;

View File

@@ -0,0 +1,56 @@
const { numberOr, asText, plainText, stringList } = require('./foundry-fields');
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 = [
...stringList(traits.languages?.value),
...stringList(traits.armor?.value),
...stringList(traits.weapon?.value),
...stringList(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 };

View File

@@ -0,0 +1,32 @@
// Small helpers shared by the Foundry -> Dragonroll document mappers
// (services/actor-foundry.js and services/item-foundry.js).
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(/&nbsp;/gi, ' ')
.replace(/&amp;/gi, '&')
.replace(/&lt;/gi, '<')
.replace(/&gt;/gi, '>')
.replace(/\s+\n/g, '\n')
.trim();
}
function stringList(value) {
if (Array.isArray(value)) return value.map(asText).filter(Boolean);
if (typeof value === 'string') return [value];
return [];
}
module.exports = { numberOr, asText, plainText, stringList };

View 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 };

View File

@@ -0,0 +1,108 @@
const { numberOr, asText, plainText, stringList } = require('./foundry-fields');
// Foundry item types that are gear, mapped to a Dragonroll Item category.
// `equipment` is resolved into armor / shield from its armor type.
const CATEGORY_BY_FOUNDRY_TYPE = {
weapon: 'weapon',
equipment: 'equipment',
consumable: 'consumable',
tool: 'tool',
container: 'adventuring-gear',
loot: 'treasure',
// Item types from older D&D 5e system releases.
ammo: 'weapon',
potion: 'consumable',
poison: 'consumable',
scroll: 'consumable',
trinket: 'magic-item',
backpack: 'adventuring-gear'
};
// Foundry item types that are not gear: they never become Dragonroll items.
const NON_GEAR_FOUNDRY_TYPES = new Set([
'spell', 'class', 'subclass', 'background', 'feat', 'race', 'species', 'status', 'spellbook', 'language'
]);
// Item categories the Dragonroll Item model accepts.
const CATEGORIES = ['weapon', 'armor', 'shield', 'adventuring-gear', 'magic-item', 'consumable', 'tool', 'treasure', 'other'];
const RARITY_BY_FOUNDRY_VALUE = {
common: 'common',
uncommon: 'uncommon',
rare: 'rare',
'very-rare': 'very-rare',
veryrare: 'very-rare',
'very rare': 'very-rare',
legendary: 'legendary',
artifact: 'artifact'
};
// Fallback labels for weapon properties when the Foundry client did not send the
// ones from its own CONFIG (see serializeFoundryItem in the module).
const WEAPON_PROPERTY_LABELS = {
amm: 'ammunition',
fin: 'finesse',
foc: 'focus',
hvy: 'heavy',
lrp: 'long range',
lod: 'loading',
nid: 'noisy',
rch: 'reach',
rel: 'reload',
ret: 'retractable',
slo: 'slow firing',
thr: 'thrown',
thv: 'thrown',
two: 'two-handed',
ver: 'versatile'
};
function foundryItemRarity(foundryItem) {
const rarity = asText(foundryItem.system?.rarity).toLowerCase().trim();
return RARITY_BY_FOUNDRY_VALUE[rarity] || 'common';
}
// Returns null for Foundry documents that are not gear so the sync can skip them.
function foundryItemCategory(foundryItem, rarity) {
const type = asText(foundryItem.type).toLowerCase().trim();
if (NON_GEAR_FOUNDRY_TYPES.has(type)) return null;
if (type === 'equipment') {
return asText(foundryItem.system?.armor?.type).toLowerCase() === 'shield' ? 'shield' : 'armor';
}
const category = CATEGORY_BY_FOUNDRY_TYPE[type];
if (CATEGORIES.includes(category)) return category;
// Systems the module does not know about still get a usable Dragonroll item.
return rarity === 'common' ? 'other' : 'magic-item';
}
function foundryItemProperties(foundryItem) {
const provided = stringList(foundryItem.dragonroll?.properties);
if (provided.length) return provided.join(', ');
const properties = stringList(foundryItem.system?.properties?.value ?? foundryItem.system?.properties);
return properties.map((property) => {
const key = property.toLowerCase();
return Object.hasOwn(WEAPON_PROPERTY_LABELS, key) ? WEAPON_PROPERTY_LABELS[key] : property;
}).join(', ');
}
function foundryItemToItemData(foundryItem) {
const system = foundryItem.system || {};
const name = asText(foundryItem.name).trim();
const rarity = foundryItemRarity(foundryItem);
const category = foundryItemCategory(foundryItem, rarity);
if (!name || !category) return null;
return {
name,
category,
rarity,
quantity: Math.max(1, Math.trunc(numberOr(system.quantity, 1))),
weight: Math.max(0, numberOr(system.weight?.value ?? system.weight, 0)),
properties: foundryItemProperties(foundryItem),
description: plainText(system.description?.value ?? system.description)
};
}
module.exports = { foundryItemToItemData };

View File

@@ -0,0 +1,254 @@
const crypto = require('node:crypto');
const jwt = require('jsonwebtoken');
const ServiceLinkRequest = require('../models/ServiceLinkRequest');
const Campaign = require('../models/Campaign');
const keys = require('./keys');
// How long a sign-up link waits for somebody to open it.
const LINK_TTL_MS = 10 * 60 * 1000;
// How long the Discord bot can still confirm an authorization it was away for.
const NOTIFICATION_WINDOW_MS = 15 * 60 * 1000;
// The token the Obsidian plugin gets back is its long-lived credential: a plugin cannot ask
// somebody to open the sign-up link again every 48 hours. It carries the id of the link so that
// revoking the link works right away — see services/passport.js.
const OBSIDIAN_TOKEN_TTL = '365d';
// Every service that connects to a campaign does it the same way: it asks the
// backend for a sign-up link, shows it to the person sitting in front of it,
// and picks its credential up once a Dragonroll user has signed in through that
// link and chosen a campaign. `botOnly` services are the ones that can prove
// who they are to the backend; the others can only be trusted with their own
// link, which is why what they get from a link is decided by the user.
const SERVICES = {
foundry: { name: 'Foundry VTT' },
discord: { name: 'Discord', botOnly: true },
obsidian: { name: 'Obsidian' },
};
function isService(value) {
return Object.prototype.hasOwnProperty.call(SERVICES, value);
}
function serviceName(service) {
return SERVICES[service]?.name || service;
}
function isBotOnly(service) {
return SERVICES[service]?.botOnly === true;
}
function codeHash(code) {
return crypto.createHash('sha256').update(String(code ?? '').trim()).digest('hex');
}
function newLinkCode() {
return crypto.randomBytes(32).toString('base64url');
}
function frontendBaseUrl() {
return (process.env.DRAGONROLL_FRONTEND_URL || 'http://localhost:3000').trim().replace(/\/+$/, '');
}
// The sign-up link a service shows: it opens the Dragonroll page where somebody
// signs in and picks the campaign. The code travels in the fragment, so the
// browser never sends it to the server.
function signUpLinkUrl(service, code) {
return `${frontendBaseUrl()}/link/authorize?service=${encodeURIComponent(service)}#code=${encodeURIComponent(code)}`;
}
// The bot talks to the backend with a shared secret instead of a login, so a
// Discord server cannot be claimed by somebody who merely knows its id.
function isDiscordBot(req) {
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);
return !!expected.length
&& expected.length === supplied.length
&& crypto.timingSafeEqual(expected, supplied);
}
function requireDiscordBot(req, res, next) {
if (!isDiscordBot(req)) {
return res.status(401).json({ status: 'error', msg: 'errors.unauthorized' });
}
return next();
}
function readText(value, max) {
return typeof value === 'string' ? value.trim().slice(0, max) : '';
}
// Whatever else a service says about itself: the Foundry system it runs, the
// Discord user id behind the person who asked... Values are kept short and
// plain, because they come from a service and end up shown to a user.
function readMeta(source) {
const meta = {};
for (const [key, value] of Object.entries(source).slice(0, MAX_META_ENTRIES)) {
if (value === null || value === undefined || typeof value === 'boolean') {
if (typeof value === 'boolean') meta[key] = value;
continue;
}
if (typeof value !== 'string' && typeof value !== 'number') continue;
meta[key] = String(value).trim().slice(0, MAX_META_VALUE_LENGTH);
}
return meta;
}
// How a service describes itself: which world/server/vault is asking, on whose
// behalf, and the little that goes with it.
function readTarget(body) {
const source = body?.target && typeof body.target === 'object' ? body.target : {};
const target = {
targetId: readText(source.id, 120),
targetName: readText(source.name, 200),
targetUser: readText(source.user, 120),
targetMeta: source.meta && typeof source.meta === 'object' && !Array.isArray(source.meta)
? readMeta(source.meta)
: {}
};
if (typeof target.targetMeta.url === 'string') {
try {
const url = new URL(target.targetMeta.url);
target.targetMeta.url = url.protocol === 'http:' || url.protocol === 'https:' ? url.origin : '';
} catch {
target.targetMeta.url = '';
}
}
return target;
}
function linkIsExpired(request) {
return request?.state === 'pending' && (!request.expiresAt || request.expiresAt <= new Date());
}
// A service asking again reuses its own row: one world, one Discord server and
// one vault each have a single link, and asking for it replaces the last one.
async function startServiceLink(service, target) {
const code = newLinkCode();
const expiresAt = new Date(Date.now() + LINK_TTL_MS);
const request = await ServiceLinkRequest.findOneAndUpdate(
{ service: service, targetId: target.targetId },
{
$set: {
service: service,
targetId: target.targetId,
targetName: target.targetName,
targetUser: target.targetUser,
targetMeta: target.targetMeta,
codeHash: codeHash(code),
state: 'pending',
expiresAt: expiresAt
},
$unset: {
campaign: 1,
dragonrollUser: 1,
credentials: 1,
linkedAt: 1,
pickedUpAt: 1,
notifiedAt: 1
}
},
{ new: true, upsert: true, setDefaultsOnInsert: true }
);
return { request, code, url: signUpLinkUrl(service, code), expiresAt };
}
async function findServiceLinkByCode(code) {
if (!code) return null;
return ServiceLinkRequest.findOne({ codeHash: codeHash(code) }).select('+credentials').lean();
}
// The credential that belongs to a link is handed over once and then dropped:
// whoever loses it starts the link again from the service, which is where they
// got the link from in the first place.
async function takeServiceLinkCredentials(request) {
const credentials = request?.credentials || null;
if (!credentials) return null;
await ServiceLinkRequest.updateOne(
{ _id: request._id },
{ $set: { pickedUpAt: new Date() }, $unset: { credentials: 1 } }
);
return credentials;
}
// The user who owns the campaign picked it for this link.
async function completeServiceLink(request, campaign, user, credentials = null) {
request.campaign = campaign._id;
request.dragonrollUser = user.id;
request.state = 'linked';
request.linkedAt = new Date();
request.pickedUpAt = null;
request.notifiedAt = null;
request.credentials = credentials || undefined;
// An answered link is the record of a live connection: it stays until the
// service re-links or the campaign unlinks it.
request.expiresAt = null;
await request.save();
return request;
}
// A campaign dropping a service: the link stops being valid, and the service
// finds that out the next time it asks.
async function revokeServiceLink(service, campaignId) {
const result = await ServiceLinkRequest.updateMany(
{ service: service, campaign: campaignId, state: 'linked' },
{
$set: { state: 'revoked', campaign: null },
$unset: { credentials: 1, linkedAt: 1 }
}
);
return result.matchedCount;
}
// What a campaign has connected to it, newest link first and one row per
// service, so the campaign settings can list its services together.
async function listLinkedServices(campaignId) {
const links = await ServiceLinkRequest.find({ campaign: campaignId, state: 'linked' })
.sort({ linkedAt: -1 })
.lean();
const seen = new Set();
const services = [];
for (const link of links) {
if (seen.has(link.service)) continue;
seen.add(link.service);
services.push({
service: link.service,
name: serviceName(link.service),
targetId: link.targetId || '',
targetName: link.targetName || '',
targetUser: link.targetUser || '',
dragonrollUser: link.dragonrollUser || null,
linkedAt: link.linkedAt
});
}
return services;
}
module.exports = {
LINK_TTL_MS,
NOTIFICATION_WINDOW_MS,
SERVICES,
codeHash,
completeServiceLink,
findServiceLinkByCode,
isBotOnly,
isDiscordBot,
isService,
linkIsExpired,
listLinkedServices,
readTarget,
requireDiscordBot,
revokeServiceLink,
serviceName,
signUpLinkUrl,
startServiceLink,
takeServiceLinkCredentials
};

View File

@@ -0,0 +1,7 @@
node_modules
.env
.env.*
!.env.example
npm-debug.log*
Dockerfile
.dockerignore

14
discord-bot/.env.example Normal file
View 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
View File

@@ -0,0 +1,3 @@
.env
node_modules/
npm-debug.log*

22
discord-bot/Dockerfile Normal file
View 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
View 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
View 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
View 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"
}
}

View 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
View 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 };

View 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;
});

View File

@@ -0,0 +1,129 @@
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;
}
// The backend hands out the sign-up link the person opens to pick a campaign,
// so the bot never builds one itself: every service shows the same link.
async function startAuthorization(guildId, guildName, discordUserId, discordUserName) {
const payload = await request('/link/start', {
method: 'POST',
body: JSON.stringify({
service: 'discord',
target: {
id: String(guildId),
name: guildName,
user: discordUserName,
meta: { userId: String(discordUserId) }
}
})
});
if (!payload.linkUrl) throw new Error('Dragonroll did not provide a sign-up link. Update the Dragonroll backend.');
return payload;
}
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
View 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;
});

View File

@@ -18,4 +18,26 @@ services:
backend: backend:
image: git.aranroig.com/syndria98/dragonroll-backend:latest image: git.aranroig.com/syndria98/dragonroll-backend:latest
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 restart: always

View File

@@ -0,0 +1,177 @@
# 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 and world Items 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.
**Dragonroll Pairing Status** in the module settings always says whether this browser holds a pairing
and, once Dragonroll has answered `GET /api/foundry/sync/status`, which campaign the world is
connected to. It is written by the module, not by the GM: it appears as not connected until the world
is paired, names the campaign after a pairing or a check on world start and every minute afterwards,
gives the reason when a pairing code can never be redeemed, and says the world is no longer linked
once the campaign unlinks it. Because both the pairing code and the sync token are client settings,
another browser of the same world reads as not paired.
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 and item 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.
### Auto-sync, and sending one actor on purpose
**Dragonroll Auto-sync** in the module settings (on by default) is what keeps the campaign and this
world in step: actors and world items the GM creates, updates or deletes are sent to Dragonroll, and
both sides reconcile every few seconds. Turn it off to stop synchronizing altogether — nothing is
sent to the campaign, and Dragonroll stops rewriting those documents in Foundry, so the campaign
keeps whatever it already holds. Turn it back on to reconcile both sides again; the Foundry edits
queued while it was off are sent as the world catches up.
With autosync off — or any time a single character needs to cross over right now — right-click an
actor (or several selected ones) in the Foundry actor directory and pick **Dragonroll: Force Sync**.
Those actors, together with the gear carried inside them, are pushed to the campaign immediately even
when autosync is off. It is an upsert only: it never prunes the campaign's other actors, which a full
snapshot does and a forced sync never claims to. Actors Dragonroll does not import (anything that is
not a character, NPC or creature) are refused with a notification.
The optional read-only snapshot bridge is not affected: it keeps publishing the world snapshot behind
`/api/foundry/*`, which is never written into the campaign.
### Items
The campaign's Item list is synchronized with the world's gear, both ways:
- The GM sends the world item directory (`game.items`) with every snapshot, and world items created,
changed or deleted in Foundry are pushed as they happen. Items embedded in a character travel with
that character's snapshot instead.
- Gear is deduplicated by name: the same sword in the world directory and in three characters'
inventories becomes one Dragonroll item. Names Dragonroll renames away from are remembered on the
item (`foundryNames`), so Foundry's copies keep folding into it rather than coming back as a
duplicate. Spells, classes, subclasses, backgrounds, feats and species are not gear and are not
imported.
- Foundry owns the fields it sends (category from the item type, rarity, quantity, weight, weapon
properties, description). An item made by hand in Dragonroll is created in the world's item
directory on the next reconcile, mapped afterwards, and editing it in Dragonroll updates the Foundry
document.
- A full snapshot keeps Dragonroll edits on reconnect; live Foundry edits overwrite. Item removal is
pruned only by a full snapshot, so a live item push never deletes anything. Deleting a synced item in
Dragonroll removes its Foundry world copy on the next reconcile. Items that live only in an actor's
inventory are owned by that actor's snapshot: editing such an item in Dragonroll does not rewrite the
actor's copy.
The module calls these Dragonroll routes with the campaign sync token (no Dragonroll login):
| Route | Use |
|---|---|
| `POST /api/foundry/sync/snapshot` | Actors and world items upsert; `fullSync` also prunes |
| `POST /api/foundry/sync/item-snapshot` | Live world item edits, upsert only |
| `POST /api/foundry/sync/item-delete` | A world item was deleted |
| `GET /api/foundry/sync/characters` | Characters to apply back in Foundry |
| `GET /api/foundry/sync/items` | Items to apply back in Foundry |
| `GET /api/foundry/sync/status` | The campaign this world's token belongs to, for the module's pairing status |
| `POST /api/foundry/sync/map` / `map-item` | Store an id mapping after creating a document |
| `POST /api/foundry/sync/delete` | An actor was deleted |
Foundry documents keep the Dragonroll id in the `dragonroll-foundry.actorId` / `dragonroll-foundry.itemId`
flag, and world items are marked with `dragonroll-foundry.syncMutation` while Dragonroll writes them so
the write is not echoed back.
## 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.

View 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"
}
}

View 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}`);
});

View 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.4.0",
"library": true,
"compatibility": {
"minimum": "12",
"verified": "14"
},
"esmodules": [
"scripts/api.js"
]
}

File diff suppressed because it is too large Load Diff

View File

@@ -2,6 +2,7 @@
import ContentManager from './components/managers/ContentManager.vue'; import ContentManager from './components/managers/ContentManager.vue';
import ToastManager from './components/managers/ToastManager.vue'; import ToastManager from './components/managers/ToastManager.vue';
import WindowManager from './components/managers/WindowManager.vue'; import WindowManager from './components/managers/WindowManager.vue';
import ServiceLinkAuthorize from './components/views/ServiceLinkAuthorize.vue';
import { CreateWindow } from '@/services/Windows' import { CreateWindow } from '@/services/Windows'
import { GetUser, HasAdmin } from './services/User'; import { GetUser, HasAdmin } from './services/User';
@@ -11,6 +12,15 @@ import { useCampaignService } from './services/Campaign';
const { RestoreCampaign } = useCampaignService(); const { RestoreCampaign } = useCampaignService();
// Els serveis (Discord, Foundry, Obsidian) enllacen amb aquesta pantalla única; no són part
// de l'aplicació i no han d'arrencar les finestres normals. La ruta antiga de Discord també
// hi porta, perquè els enllaços que ja corren per Discord no queden morts.
const requestUrl = useRequestURL();
const isServiceLink = computed(() => {
const path = requestUrl.pathname.replace(/\/+$/, '');
return path === '/link/authorize' || path === '/discord/authorize';
});
async function start(){ async function start(){
if(GetUser()){ if(GetUser()){
const restoredCampaign = await RestoreCampaign(); const restoredCampaign = await RestoreCampaign();
@@ -40,12 +50,15 @@ useHead({
onMounted(() => { onMounted(() => {
setupTheme(); setupTheme();
setTheme('dark'); setTheme('dark');
start(); if(!isServiceLink.value){
start();
}
}) })
</script> </script>
<template> <template>
<div class="viewer"> <ServiceLinkAuthorize v-if="isServiceLink"></ServiceLinkAuthorize>
<div v-else class="viewer">
<ToastManager></ToastManager> <ToastManager></ToastManager>
<TooltipManager></TooltipManager> <TooltipManager></TooltipManager>
<ContextMenuManager></ContextMenuManager> <ContextMenuManager></ContextMenuManager>

View File

@@ -18,6 +18,7 @@ $themes: (
button-active: #202020cc, button-active: #202020cc,
toast-background: #202020, toast-background: #202020,
tooltip-background: #2a2a2a,
note-border: #202324, note-border: #202324,
@@ -33,7 +34,11 @@ $themes: (
green: #98c379, green: #98c379,
gray: #cccccc, gray: #cccccc,
icon-invert: 100% icon-invert: 100%,
search-background: #20202077,
search-background-container: #202020ee,
search-hover: #2a2a2a,
), ),
light: ( light: (
background: #ffffff, background: #ffffff,
@@ -51,6 +56,7 @@ $themes: (
button-active: #d4d4d4, button-active: #d4d4d4,
toast-background: #f0f0f0, toast-background: #f0f0f0,
tooltip-background: #f5f5f5,
note-border: #e0e0e0, note-border: #e0e0e0,
@@ -66,7 +72,11 @@ $themes: (
green: #98c379, green: #98c379,
gray: #cccccc, gray: #cccccc,
icon-invert: 0% icon-invert: 0%,
search-background: #f0f0f0aa,
search-background-container: #ffffffee,
search-hover: #e8e8e8,
) )
); );

View File

@@ -225,6 +225,23 @@ button:active {
font-weight: bold; font-weight: bold;
} }
/* Cites (> ...) a la vista prèvia d'una nota */
blockquote {
margin: 1em 0;
padding: 2px 0 2px 14px;
border-left: 3px solid var(--color-border-color);
font-style: italic;
opacity: 0.85;
}
blockquote blockquote {
margin: 0.5em 0;
}
blockquote p {
margin: 0.3em 0;
}
.text-icon { .text-icon {
height: 18px; height: 18px;
width: 18px; width: 18px;
@@ -364,3 +381,40 @@ span.artifact {
.green { .green {
color: var(--color-green); color: var(--color-green);
} }
/* Seccions col·lapsables (h1/h2/h3) a la vista prèvia d'una nota */
.fold-handle {
position: relative;
cursor: pointer;
user-select: none;
padding-left: 0.95em;
}
.fold-handle::before {
content: "";
position: absolute;
left: 0.1em;
top: 0.55em;
width: 0.3em;
height: 0.3em;
box-sizing: border-box;
border-right: 1px solid currentColor;
border-bottom: 1px solid currentColor;
opacity: 0;
transition: transform 0.15s ease, opacity 0.15s ease;
transform: rotate(45deg);
transform-origin: center;
}
.fold-handle:hover::before {
opacity: 0.7;
}
.fold.is-collapsed > .fold-handle::before {
opacity: 0.7;
transform: rotate(-45deg);
}
.fold.is-collapsed > .fold-body {
display: none;
}

View File

@@ -34,19 +34,28 @@ onMounted(() => {
z-index: 214748363; z-index: 214748363;
flex-direction: column; flex-direction: column;
background-color: var(--color-tooltip-background);
border: 1px solid var(--color-border);
overflow: visible;
.context-menu-divider {
height: 1px;
margin: 4px 0;
border-top: 1px solid var(--color-border);
background-color: transparent;
border: none;
}
.context-menu-element { .context-menu-element {
&:last-child { &:last-child {
border-width: 1px 1px 1px 1px; border-width: 1px 1px 1px 1px;
} }
border: solid 1px var(--color-border); border: solid 1px var(--color-border);
border-width: 1px 1px 0px 1px; border-width: 1px 1px 0px 1px;
padding: 3px 5px 3px 5px; padding: 6px 10px 6px 8px;
cursor: default; cursor: default;
user-select: none; user-select: none;
background-color: var(--tooltip-background); background-color: var(--color-tooltip-background);
transition: background-color 100ms; transition: background-color 100ms;
display: flex; display: flex;
align-items: center; align-items: center;
@@ -54,19 +63,37 @@ onMounted(() => {
span { span {
flex-grow: 1; flex-grow: 1;
padding-right: 20px; padding-right: 24px;
white-space: nowrap; white-space: nowrap;
} }
img { img {
filter: invert(1); filter: invert(1);
width: 18px; width: 16px;
height: 18px; height: 16px;
}
.context-menu-swatch {
width: 14px;
height: 14px;
flex-grow: 0;
padding-right: 0;
border-radius: 4px;
border: 1px solid var(--color-border);
flex-shrink: 0;
} }
&:hover { &:hover {
background-color: var(--color-background-softest); background-color: var(--color-background-softest);
} }
> .context-menu {
display: none !important;
}
&:hover > .context-menu {
display: flex !important;
}
} }
} }
</style> </style>

View File

@@ -1,25 +1,23 @@
<script setup> <script setup>
import { onMounted, ref } from 'vue'; import { computed, onMounted, ref } from 'vue';
import { AddSound } from '../../services/Sound'; import { AddSound } from '../../services/Sound';
import { useCampaignService } from '~/services/Campaign'; import { useCampaignService } from '~/services/Campaign';
import { ClearWindow } from '~/services/Windows'; import { ClearWindow, CreateChildWindow, GetFirstWindowId } from '~/services/Windows';
const { SetCampaign } = useCampaignService(); const { SetCampaign } = useCampaignService();
const props = defineProps(['data']); const props = defineProps(['data']);
const data = props.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); const container = ref(null);
onMounted(() => { 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) AddSound(container.value)
}); });
@@ -27,11 +25,16 @@ function ViewCampaign(){
SetCampaign(data); SetCampaign(data);
ClearWindow({type: "main_menu"}); ClearWindow({type: "main_menu"});
} }
function OpenSettings(){
ClearWindow({type: 'campaign_settings'});
CreateChildWindow(GetFirstWindowId('main_menu'), 'campaign_settings', { campaign: data });
}
</script> </script>
<template> <template>
<div class="campaign-entry-container" ref="container"> <div class="campaign-entry-container" ref="container" :style="campaignStyle">
<div class="main-campaign-entry-container-inner"> <div class="main-campaign-entry-container-inner">
<img class="campaign-icon" src="/img/def-avatar.jpg" draggable="false"> <img class="campaign-icon" src="/img/def-avatar.jpg" draggable="false">
<div class="campaign-info"> <div class="campaign-info">
@@ -39,6 +42,7 @@ function ViewCampaign(){
</div> </div>
<div class="campaign-user-actions"> <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> <button class="btn-primary button-small sound-click" v-on:click.prevent="ViewCampaign">{{ $t('general.open')}}</button>
</div> </div>
</div> </div>
@@ -47,7 +51,6 @@ function ViewCampaign(){
<style lang="scss" scoped> <style lang="scss" scoped>
.button-small { .button-small {
height: 32px;
padding: 10px; padding: 10px;
} }
@@ -82,5 +85,7 @@ function ViewCampaign(){
.campaign-user-actions { .campaign-user-actions {
margin-left: auto; margin-left: auto;
display: flex;
gap: 6px;
} }
</style> </style>

View File

@@ -1,106 +1,72 @@
<script setup> <script setup>
import { computed, onMounted, onUnmounted, 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 { useCampaignService } from '~/services/Campaign.js';
import { AnchorMap, AnchoredMap, ClearAnchoredMap, SetActivePane } from '~/services/Content.js';
import { emitter } from '~/services/Emitter'; import { emitter } from '~/services/Emitter';
import Server from '~/services/Server'; import Server from '~/services/Server';
import { ClearWindow, CreateWindow, GetFirstWindowId } from '~/services/Windows';
import { HideContextMenu, ShowContextMenu } from '~/services/ContextMenu';
import NestedNoteList from './NestedNoteList.vue';
const { Campaign } = useCampaignService(); const { Campaign } = useCampaignService();
const { t } = useI18n();
const notes = ref([]); const notes = ref([]);
const folders = ref([]);
const actors = ref([]);
const items = ref([]);
const maps = ref([]);
const entryLists = { actor: actors, item: items, map: maps };
const loadingNotes = ref(false); const loadingNotes = ref(false);
const loadingEntries = ref(false);
const notesError = ref(''); const notesError = ref('');
const entriesError = ref('');
const sidebarCollapsed = ref(false); const sidebarCollapsed = ref(false);
const activeSection = ref('notes');
const isDragOverSidebar = ref(false);
const expandedFolderIds = ref([]);
const expandedEntryIds = ref([]);
const nestedNoteListRef = ref(null);
let entryRefreshInterval;
const campaignId = computed(() => { async function handleSidebarDrop(event) {
return Campaign.value?._id ?? Campaign.value?.id ?? null; if (activeSection.value !== 'notes') return;
}); const noteKey = event.dataTransfer.getData('text/plain');
if (!noteKey) return;
const notesMeta = computed(() => {
const count = notes.value.length;
return `${count} ${count === 1 ? 'note' : 'notes'}`;
});
async function fetchCampaignNotes() {
if (!campaignId.value) {
notes.value = [];
notesError.value = '';
return;
}
loadingNotes.value = true;
notesError.value = '';
try { try {
const response = await Server().get('/note/list', { await Server().post('/note/update', { id: noteKey, folder: null });
params: { if (nestedNoteListRef.value) {
campaign: campaignId.value nestedNoteListRef.value.clearCacheAndReloadExpanded();
} } else {
}); fetchCampaignNotes();
if (response.data.status !== 'ok') {
notes.value = [];
notesError.value = response.data.msg ?? 'Unable to load notes.';
return;
} }
} catch (e) {}
}
notes.value = response.data.notes.map((note) => { function toggleExpandedFolder(folderId) {
return { const arr = expandedFolderIds.value;
key: note._id, const idx = arr.indexOf(folderId);
title: note.title, if (idx !== -1) {
text: note.content ?? '', arr.splice(idx, 1);
date: note.date } else {
}; arr.push(folderId);
});
} catch (error) {
notes.value = [];
notesError.value = 'Unable to load notes.';
} finally {
loadingNotes.value = false;
} }
} }
function toggleSidebar() { function isFolderExpanded(folderId) {
sidebarCollapsed.value = !sidebarCollapsed.value; return expandedFolderIds.value.includes(folderId);
} }
async function createNote() {
if (!Campaign.value) {
return;
}
const campaignId = 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.log(err);
}
}
function openNote(note) { function openNote(note) {
emitter.emit('push-note', note); emitter.emit('push-note', note);
} }
function handleNoteCreated(note) { function handleNoteCreated(note) {
if (!note) { if (!note) return;
return;
}
const noteCampaignId = note.campaign?._id ?? note.campaign ?? null; const noteCampaignId = note.campaign?._id ?? note.campaign ?? null;
if (campaignId.value && noteCampaignId && noteCampaignId !== campaignId.value) { if (campaignId.value && noteCampaignId && noteCampaignId !== campaignId.value) return;
return;
}
const createdNote = { const createdNote = {
key: note._id, key: note._id,
@@ -109,24 +75,309 @@ function handleNoteCreated(note) {
date: note.date date: note.date
}; };
notes.value = notes.value.filter((currentNote) => { notes.value = notes.value.filter((currentNote) => currentNote.key !== createdNote.key);
return currentNote.key !== createdNote.key;
}); // Notes created inside a folder are added by NestedNoteList's own cache handler
notes.value.unshift(createdNote); const noteFolderId = note.folder?._id ?? note.folder ?? null;
if (!noteFolderId) {
notes.value.unshift(createdNote);
}
openNote(createdNote); openNote(createdNote);
} }
function handleNoteRenamed(data) {
const note = notes.value.find(n => n.key === data.key);
if (note) {
note.title = data.title;
}
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 = entryLists[entityType];
if (!list) return;
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 = entryLists[entityType];
if (!list) return;
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;
});
async function fetchCampaignNotes() {
if (!campaignId.value) {
notes.value = [];
folders.value = [];
notesError.value = '';
return;
}
loadingNotes.value = true;
notesError.value = '';
try {
const response = await Server().get('/note/list', { params: { campaign: campaignId.value } });
if (response.data.status !== 'ok') {
notes.value = [];
folders.value = [];
notesError.value = response.data.msg ?? 'Unable to load notes.';
return;
}
folders.value = response.data.folders.map((folder) => ({
_id: folder._id, name: folder.name, date: folder.date, color: folder.color
}));
notes.value = response.data.notes.map((note) => {
return { key: note._id, title: note.title, text: note.content ?? '', date: note.date, color: note.color };
});
} catch (error) {
notes.value = [];
folders.value = [];
notesError.value = 'Unable to load notes.';
} finally {
loadingNotes.value = false;
}
}
function entryEntityType(section) {
if (section === 'actors') return 'actor';
if (section === 'items') return 'item';
if (section === 'maps') return 'map';
return null;
}
function isEntrySection(section) {
return entryEntityType(section) !== null;
}
async function fetchCampaignEntries(entityType = activeSection.value, silent = false) {
const kind = entryEntityType(entityType);
const list = entryLists[kind];
if (!campaignId.value || !list) return;
if (!silent) {
loadingEntries.value = true;
entriesError.value = '';
}
try {
const response = await Server().get(`/${kind}/list`, { params: { campaign: campaignId.value } });
if (response.data.status !== 'ok') {
if (!silent) entriesError.value = response.data.msg ?? t('campaigns.errors.load');
return;
}
const previousById = new Map(list.value.map((entry) => [entry._id, entry]));
list.value = response.data[entityType] ?? [];
// Tell open windows about Foundry changes landing behind them.
for (const entry of list.value) {
const previous = previousById.get(entry._id);
if (previous && JSON.stringify(previous) !== JSON.stringify(entry)) {
emitter.emit('campaign-entry-updated', { entityType: kind, entry });
}
}
} catch (error) {
if (!silent) entriesError.value = t('campaigns.errors.load');
} finally {
if (!silent) loadingEntries.value = false;
}
}
function selectSection(section) {
activeSection.value = section;
if (isEntrySection(section)) fetchCampaignEntries(section);
// The content area follows the sidebar: maps shows the anchored map, everything else the
// notes that are currently open.
SetActivePane(section === 'maps' && AnchoredMap.value ? 'map' : 'notes');
}
function createEntry(entityType) {
if (!campaignId.value) return;
if (entityType === 'map') {
CreateWindow('create_map', { campaign: 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 mapSummary(map) {
return t('campaigns.map.summary', { size: map.gridSize, scale: map.scale });
}
function editItem(entry) {
if (!campaignId.value) return;
CreateWindow('create_campaign_entry', { entityType: 'item', campaign: campaignId.value, entry });
}
function editMap(map) {
if (!campaignId.value) return;
CreateWindow('create_map', { campaign: campaignId.value, entry: map });
}
function showEntryMenu(entry, entityType) {
const list = entryLists[entityType];
const menuItems = [];
// Characters are edited in their sheet; items and maps get their window in edit mode.
if (entityType === 'item') {
menuItems.push({
name: t('campaigns.actions.edit'),
icon: '/icons/iconoir/regular/edit.svg',
action: () => { HideContextMenu(); editItem(entry); }
});
} else if (entityType === 'map') {
menuItems.push({
name: t('campaigns.actions.edit'),
icon: '/icons/iconoir/regular/edit.svg',
action: () => { HideContextMenu(); editMap(entry); }
});
}
menuItems.push({
name: t('campaigns.actions.delete'),
icon: '/icons/iconoir/regular/trash.svg',
action: async () => {
try {
const response = await Server().post(`/${entityType}/delete`, { id: entry._id });
if (response.data.status === 'ok' && list) {
list.value = list.value.filter((current) => current._id !== entry._id);
if (entityType === 'map' && isAnchoredMap(entry)) ClearAnchoredMap();
}
} catch (error) {} finally { HideContextMenu(); }
}
});
ShowContextMenu(menuItems);
}
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 });
}
// Maps are anchored on the note container instead of opening a window: the notes that were open
// stay open, and the sidebar's notes/maps buttons switch between the two.
function openMapViewer(map) {
if (!map) return;
const floatingViewer = GetFirstWindowId('map_viewer');
if (floatingViewer !== undefined) ClearWindow({ id: floatingViewer });
AnchorMap(map);
}
function isAnchoredMap(map) {
return AnchoredMap.value?._id === map._id;
}
function createNote() {
if (!Campaign.value) return;
CreateWindow('new_note', { campaign: campaignId.value });
}
function createFolder() {
CreateWindow('new_folder', { campaign: campaignId.value });
}
function toggleSidebar() {
sidebarCollapsed.value = !sidebarCollapsed.value;
}
const rootNotes = computed(() => notes.value.filter(n => !n._folder));
watch(campaignId, (newVal) => {
if (newVal) {
actors.value = [];
items.value = [];
maps.value = [];
ClearAnchoredMap();
fetchCampaignNotes();
if (isEntrySection(activeSection.value)) fetchCampaignEntries(activeSection.value);
} else {
notes.value = [];
folders.value = [];
actors.value = [];
items.value = [];
maps.value = [];
notesError.value = '';
entriesError.value = '';
ClearAnchoredMap();
}
});
onMounted(() => { onMounted(() => {
emitter.on('note-created', handleNoteCreated); 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();
}
entryRefreshInterval = setInterval(() => {
// Synced Foundry entries land in the background for both lists.
if ((activeSection.value === 'actors' || activeSection.value === 'items') && campaignId.value) {
fetchCampaignEntries(activeSection.value, true);
}
}, 5000);
}); });
onUnmounted(() => { onBeforeUnmount(() => {
clearInterval(entryRefreshInterval);
emitter.off('note-created', handleNoteCreated); 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);
}); });
watch(Campaign, () => {
fetchCampaignNotes();
}, { immediate: true });
</script> </script>
<template> <template>
@@ -137,9 +388,9 @@ watch(Campaign, () => {
type="button" type="button"
@click="toggleSidebar" @click="toggleSidebar"
:aria-expanded="(!sidebarCollapsed).toString()" :aria-expanded="(!sidebarCollapsed).toString()"
aria-controls="campaign-notes-list" aria-controls="campaign-section-list"
:title="sidebarCollapsed ? 'Expand notes' : 'Collapse notes'" :title="sidebarCollapsed ? t('campaigns.actions.expand-sidebar') : t('campaigns.actions.collapse-sidebar')"
:aria-label="sidebarCollapsed ? 'Expand notes' : 'Collapse notes'" :aria-label="sidebarCollapsed ? t('campaigns.actions.expand-sidebar') : t('campaigns.actions.collapse-sidebar')"
> >
<img <img
class="sidebar-action-icon" class="sidebar-action-icon"
@@ -151,59 +402,125 @@ watch(Campaign, () => {
<button <button
class="sidebar-action" class="sidebar-action"
type="button" :class="{ selected: activeSection === 'notes' }"
@click="createNote" type="button" @click="selectSection('notes')"
:disabled="!Campaign" :title="t('campaigns.sections.notes')" :aria-label="t('campaigns.sections.notes')"
title="New note" :aria-pressed="(activeSection === 'notes').toString()"
aria-label="New note"
> >
<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>
<button <button
class="sidebar-action" class="sidebar-action"
type="button" :class="{ selected: activeSection === 'actors' }"
@click="fetchCampaignNotes" type="button" @click="selectSection('actors')"
:disabled="!Campaign || loadingNotes" :title="t('campaigns.sections.actors')" :aria-label="t('campaigns.sections.actors')"
title="Refresh notes" :aria-pressed="(activeSection === 'actors').toString()"
aria-label="Refresh notes"
> >
<img class="sidebar-action-icon" src="/icons/iconoir/regular/refresh.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"
: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/box.svg" alt="" aria-hidden="true">
</button>
<button
class="sidebar-action"
:class="{ selected: activeSection === 'maps' }"
type="button" @click="selectSection('maps')"
:title="t('campaigns.sections.maps')" :aria-label="t('campaigns.sections.maps')"
:aria-pressed="(activeSection === 'maps').toString()"
>
<img class="sidebar-action-icon" src="/icons/iconoir/regular/map.svg" alt="" aria-hidden="true">
</button> </button>
</nav> </nav>
<aside class="notes-sidebar" :class="{ collapsed: sidebarCollapsed }"> <aside class="notes-sidebar" :class="{ collapsed: sidebarCollapsed }">
<div class="sidebar-header"> <div class="sidebar-header">
<div class="sidebar-copy"> <div class="sidebar-copy">
<span class="sidebar-eyebrow">Campaign</span> <span class="sidebar-eyebrow">{{ t('campaigns.sidebar-label') }}</span>
<strong class="sidebar-title">Notes</strong> <strong class="sidebar-title">{{ t(`campaigns.sections.${activeSection}`) }}</strong>
<span class="sidebar-meta">{{ notesMeta }}</span> </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(entryEntityType(activeSection))" :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> </div>
<div id="campaign-notes-list" class="sidebar-list"> <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">
<div v-if="loadingNotes" class="sidebar-state"> <template v-if="activeSection === 'notes'">
Loading notes... <div v-if="loadingNotes" class="sidebar-state">{{ t('campaigns.states.loading-notes') }}</div>
</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"> <template v-else-if="activeSection === 'actors'">
{{ notesError }} <div v-if="loadingEntries" class="sidebar-state">{{ t('campaigns.states.loading') }}</div>
</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="notes.length === 0" class="sidebar-state"> <template v-else-if="activeSection === 'items'">
No notes in this campaign yet. <div v-if="loadingEntries" class="sidebar-state">{{ t('campaigns.states.loading') }}</div>
</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-row">
<span class="entity-entry-name">{{ item.name }}</span>
<span v-if="item.foundryItemId" class="entity-entry-sync">{{ t('campaigns.synced') }}</span>
</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>
<template v-else> <template v-else>
<button <div v-if="loadingEntries" class="sidebar-state">{{ t('campaigns.states.loading') }}</div>
v-for="note in notes" <div v-else-if="entriesError" class="sidebar-state error">{{ entriesError }}</div>
:key="note.key" <div v-else-if="maps.length === 0" class="sidebar-state">{{ t('campaigns.states.empty-maps') }}</div>
type="button" <div v-for="map in maps" :key="map._id" class="entity-entry" :class="{ anchored: isAnchoredMap(map) }" role="button" tabindex="0" @click="openMapViewer(map)" @keydown.enter="openMapViewer(map)" @keydown.space.prevent="openMapViewer(map)" @contextmenu.prevent="showEntryMenu(map, 'map')">
class="note-link" <span class="entity-entry-name-row">
@click="openNote(note)" <span class="entity-entry-name">{{ map.name }}</span>
> <span v-if="isAnchoredMap(map)" class="entity-entry-sync">{{ t('campaigns.map.anchored') }}</span>
<span class="note-link-title">{{ note.title }}</span> </span>
</button> <span class="entity-entry-meta">{{ mapSummary(map) }}</span>
<span v-if="!map.image" class="entity-entry-description">{{ t('campaigns.map.no-image') }}</span>
</div>
</template> </template>
</div> </div>
</aside> </aside>
@@ -213,13 +530,13 @@ watch(Campaign, () => {
<style scoped> <style scoped>
.sidebar-shell { .sidebar-shell {
min-height: 0; min-height: 0;
flex-shrink: 0;
display: flex; display: flex;
flex-direction: row;
} }
.sidebar-actions { .sidebar-actions {
width: 32px; width: 46px;
min-width: 32px; min-width: 46px;
padding: 8px 6px; padding: 8px 6px;
border-right: 1px solid var(--color-border); border-right: 1px solid var(--color-border);
background-color: var(--color-background-light); background-color: var(--color-background-light);
@@ -244,6 +561,11 @@ watch(Campaign, () => {
cursor: pointer; cursor: pointer;
} }
.sidebar-action.selected {
background: var(--color-button-hover);
border-color: var(--color-link);
}
.sidebar-action:hover { .sidebar-action:hover {
background: var(--color-button-hover); background: var(--color-button-hover);
} }
@@ -260,8 +582,8 @@ watch(Campaign, () => {
} }
.notes-sidebar { .notes-sidebar {
width: 280px;
min-width: 280px; min-width: 280px;
width: 280px;
border-right: 1px solid var(--color-border); border-right: 1px solid var(--color-border);
background-color: var(--color-background-light); background-color: var(--color-background-light);
display: flex; display: flex;
@@ -282,11 +604,16 @@ watch(Campaign, () => {
box-sizing: border-box; box-sizing: border-box;
padding: 12px; padding: 12px;
display: flex; display: flex;
align-items: flex-start; align-items: center;
gap: 10px; justify-content: space-between;
gap: 8px;
border-bottom: 1px solid var(--color-border); 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 { .sidebar-copy {
display: flex; display: flex;
flex-direction: column; flex-direction: column;
@@ -305,7 +632,7 @@ watch(Campaign, () => {
word-break: break-word; word-break: break-word;
} }
.sidebar-list { .sidebar-list-drop-wrap {
width: 280px; width: 280px;
min-width: 280px; min-width: 280px;
box-sizing: border-box; box-sizing: border-box;
@@ -313,6 +640,14 @@ watch(Campaign, () => {
display: flex; display: flex;
flex-direction: column; flex-direction: column;
overflow-y: auto; overflow-y: auto;
gap: 2px;
transition: background-color 0.15s ease;
flex: 1;
min-height: 0;
}
.sidebar-list-drop-wrap.drag-over {
background: var(--color-button-hover);
} }
.sidebar-state { .sidebar-state {
@@ -326,34 +661,29 @@ watch(Campaign, () => {
color: #9e2a2b; color: #9e2a2b;
} }
.note-link { .entity-entry {
width: 100%; /* These rows are divs (the note and folder rows are buttons) and there is no global box-sizing
padding: 6px; reset, so without border-box the padding and border add onto the 100% width and the entry
margin: 0; sticks out of the sidebar. */
box-shadow: none; width: 100%; min-width: 0; box-sizing: border-box; padding: 9px 10px; border: 1px solid transparent;
border: none; border-radius: 8px;
display: flex; background: transparent; color: var(--color-text); text-align: left; display: flex; flex-direction: column;
flex-direction: column; gap: 3px; cursor: pointer;
align-items: flex-start;
text-align: left;
cursor: pointer;
transition: transform 0.15s ease, background-color 0.15s ease;
} }
.entity-entry:hover { border-color: var(--color-border); background: var(--color-background-soft); }
.note-link:hover { .entity-entry:focus-visible { outline: 1px solid var(--color-link); }
transform: translateX(2px); /* The map currently anchored on the note container. */
background: var(--color-background-light); .entity-entry.anchored { border-color: var(--color-link); background: var(--color-background-soft); }
} .entity-entry-name-row { display: flex; align-items: baseline; gap: 6px; min-width: 0; }
.entity-entry-name { font-weight: bold; min-width: 0; word-break: break-word; }
.note-link-title { .entity-entry-sync {
font-weight: 600; font-size: 10px;
word-break: break-word; letter-spacing: 0.04em;
} text-transform: uppercase;
opacity: 0.6;
.note-link-date {
font-size: 12px;
opacity: 0.7;
} }
.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) { @media (max-width: 900px) {
.notes-sidebar { .notes-sidebar {
@@ -362,7 +692,7 @@ watch(Campaign, () => {
} }
.sidebar-header, .sidebar-header,
.sidebar-list { .sidebar-list-drop-wrap {
width: 220px; width: 220px;
min-width: 220px; min-width: 220px;
} }

View File

@@ -109,7 +109,6 @@ onMounted(() => {
} }
.button-small { .button-small {
height: 32px;
padding: 10px; padding: 10px;
} }

View File

@@ -0,0 +1,382 @@
<script setup>
import { ref, onBeforeUnmount, onMounted, watch } from 'vue';
import { emitter } from '~/services/Emitter';
import Server from '~/services/Server';
import { CreateWindow } from '~/services/Windows';
import { ShowContextMenu, HideContextMenu } from '~/services/ContextMenu';
const props = defineProps({
folders: Array,
notes: Array,
campaignId: String,
level: { type: Number, default: 0 },
parentFolderId: String,
expandedFolderIds: { type: Array, default: () => [] }
});
const emit = defineEmits(['open-note', 'reload-notes']);
// Track which folder IDs have been requested to avoid duplicate requests
const loadingFolders = new Set();
const dragHoveredFolderId = ref(null);
// Preset colors for notes and folders (shown as swatches in the context menu)
const entryColors = [
{ name: 'Red', value: '#e74c3c' },
{ name: 'Orange', value: '#e67e22' },
{ name: 'Yellow', value: '#f1c40f' },
{ name: 'Green', value: '#2ecc71' },
{ name: 'Teal', value: '#1abc9c' },
{ name: 'Blue', value: '#3498db' },
{ name: 'Purple', value: '#9b59b6' },
{ name: 'Pink', value: '#fd79a8' }
];
// Cache of loaded folder contents — persists across reloads until cleared
// Each entry: { [folderId]: { notes: [], subfolders: [] } }
const folderContentCache = ref({});
function toggleExpanded(folderId) {
emit('toggle-expanded-folder', folderId);
}
watch(
() => props.expandedFolderIds,
() => {
if (props.level === 0) {
loadExpandedFolders();
}
},
{ deep: true }
);
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);
Server().get('/note/subfolder/list', { params: { campaign: props.campaignId, folder: folderId } })
.then(res => {
if (res.data.status !== 'ok') return;
folderContentCache.value[folderId] = {
notes: res.data.notes.map(n => ({ key: n._id, title: n.title, text: n.content || '', color: n.color })),
subfolders: res.data.subfolders || []
};
}).catch(() => {}).finally(() => {
loadingFolders.delete(folderId);
});
}
function getFolderNotes(folderId) {
return folderContentCache.value[folderId]?.notes || [];
}
function getFolderSubfolders(folderId) {
return folderContentCache.value[folderId]?.subfolders || [];
}
// Load contents for all currently-expanded folders
function loadExpandedFolders() {
const idsToLoad = props.level === 0
? props.expandedFolderIds
: (props.parentFolderId && props.expandedFolderIds.includes(props.parentFolderId) ? [props.parentFolderId] : []);
for (const id of idsToLoad) {
if (folderContentCache.value[id]) continue;
loadFolderContents(id);
}
}
async function handleDropNoteOnFolder(folderId, event) {
const noteKey = event.dataTransfer.getData('text/plain');
if (!noteKey || !folderId) return;
dragHoveredFolderId.value = null;
try {
await Server().post('/note/update', { id: noteKey, folder: folderId });
clearCacheAndReloadExpanded();
} catch (e) {}
}
async function handleDropNoteOnRoot(event) {
const noteKey = event.dataTransfer.getData('text/plain');
if (!noteKey) return;
dragHoveredFolderId.value = null;
try {
await Server().post('/note/update', { id: noteKey, folder: null });
clearCacheAndReloadExpanded();
} catch (e) {}
}
// 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 loadedIds = Object.keys(folderContentCache.value);
// Force reactivity by creating a new object
folderContentCache.value = {};
for (const id of loadedIds) {
loadFolderContents(id);
}
emit('reload-notes');
}
// Exposed to parent components
defineExpose({ clearCacheAndReloadExpanded });
function startDragNote(event, note) {
event.dataTransfer.setData('text/plain', note.key);
event.dataTransfer.effectAllowed = 'move';
}
function setDragHover(id) {
dragHoveredFolderId.value = id;
}
function clearDragHover() {
dragHoveredFolderId.value = null;
}
function buildNoteContextMenu(note) {
return [
{ name: 'Open', icon: '/icons/iconoir/regular/book.svg', action: () => emit('open-note', note) },
{ name: 'Rename', icon: '/icons/iconoir/regular/edit-pencil.svg', action: () => renameNote(note) },
{ name: 'Color', icon: '/icons/iconoir/regular/palette.svg', context: buildColorMenu('note', note) },
{
name: 'Move to Folder...', icon: '/icons/iconoir/regular/folder.svg',
context: buildMoveToMenu(note)
},
{ divider: true },
{ name: 'Delete', icon: '/icons/iconoir/regular/trash.svg', action: () => deleteNote(note) }
];
}
function buildFolderContextMenu(folder) {
if (!folder || !folder._id) return [];
return [
{ name: 'New Note Here', icon: '/icons/iconoir/regular/plus.svg', action: () => createNoteInFolder(folder._id) },
{ name: 'Rename', icon: '/icons/iconoir/regular/edit-pencil.svg', action: () => renameFolder(folder._id, folder.name) },
{ name: 'Color', icon: '/icons/iconoir/regular/palette.svg', context: buildColorMenu('folder', folder) },
{ name: 'Delete Folder', icon: '/icons/iconoir/regular/trash.svg', action: () => deleteFolder(folder._id) }
];
}
function buildColorMenu(kind, item) {
const colorItems = entryColors.map((color) => ({
name: color.name, color: color.value, action: () => setEntryColor(kind, item, color.value)
}));
colorItems.push({ divider: true });
colorItems.push({ name: 'Default', icon: '/icons/iconoir/regular/xmark-circle.svg', action: () => setEntryColor(kind, item, null) });
return colorItems;
}
async function setEntryColor(kind, item, color) {
const isNote = kind === 'note';
try {
const response = await Server().post(isNote ? '/note/update' : '/folder/update', {
id: isNote ? item.key : item._id,
color
});
if (response.data.status !== 'ok') return;
item.color = color;
} catch (e) {} finally {
HideContextMenu();
}
}
function entryColorStyle(item) {
return item.color ? { '--entry-color': item.color } : null;
}
let selectedNoteForMove = {};
function buildMoveToMenu(note) {
selectedNoteForMove = note;
const moveItems = (props.folders || []).map(folder => ({
name: folder.name, icon: '/icons/iconoir/regular/folder.svg', action: () => moveNoteToFolder(note, folder._id)
}));
if (moveItems.length > 0) moveItems.push({ divider: true });
moveItems.push({ name: '(Root)', icon: '/icons/iconoir/regular/book.svg', action: () => moveNoteToFolder(note, null) });
return moveItems;
}
function renameNote(note) { CreateWindow('rename_note', { title: note.title, key: note.key }); }
async function deleteNote(note) {
try {
const response = await Server().post('/note/delete', { id: note.key });
if (response.data.status === 'ok') emitter.emit('delete-note', note.key);
} catch (error) {} finally {
HideContextMenu();
}
}
function renameFolder(folderId, name) { CreateWindow('new_folder', { folderId, campaign: props.campaignId, name }); }
async function deleteFolder(folderId) {
const response = await Server().post('/folder/delete', { id: folderId });
if (response.data.status === 'ok') {
emitter.emit('folder-deleted', folderId);
clearCacheAndReloadExpanded();
}
HideContextMenu();
}
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;
clearCacheAndReloadExpanded();
} catch (e) {}
HideContextMenu();
}
function createNoteInFolder(folderId) {
CreateWindow('new_note', { campaign: props.campaignId, folder: folderId });
}
</script>
<template>
<div class="nested-list" :class="'level-' + level">
<!-- Folders at this level -->
<template v-for="folder in folders" :key="folder._id">
<div class="folder-item" :class="{ 'drag-over': dragHoveredFolderId === folder._id }"
@dragover.prevent="setDragHover(folder._id)"
@dragleave.self="clearDragHover"
@drop.stop="handleDropNoteOnFolder(folder._id, $event)">
<button type="button" class="folder-toggle" :class="{ 'has-color': !!folder.color }" :style="entryColorStyle(folder)" @click="toggleExpanded(folder._id)" @contextmenu.prevent="ShowContextMenu(buildFolderContextMenu(folder))">
<img
class="folder-arrow"
:src="expandedFolderIds.includes(folder._id) ? '/icons/iconoir/regular/nav-arrow-down.svg' : '/icons/iconoir/regular/nav-arrow-right.svg'"
alt="" aria-hidden="true"
>
<img class="folder-icon" src="/icons/iconoir/regular/folder.svg" alt="">
<span class="folder-name">{{ folder.name }}</span>
</button>
<div v-show="expandedFolderIds.includes(folder._id)"
class="folder-children" :class="{ 'drag-over': dragHoveredFolderId === folder._id }"
@dragover.prevent="setDragHover(folder._id)" @dragleave.self="clearDragHover"
@drop.stop="handleDropNoteOnFolder(folder._id, $event)">
<!-- Load contents now — cache will be populated on demand -->
<template v-if="expandedFolderIds.includes(folder._id) && !folderContentCache[folder._id]">
<div class="sidebar-state" style="font-size:13px;opacity:0.6;">Loading...</div>
</template>
<NestedNoteList
v-if="expandedFolderIds.includes(folder._id)"
:folders="getFolderSubfolders(folder._id)"
:notes="getFolderNotes(folder._id)"
:campaign-id="campaignId"
:level="level + 1"
:parent-folder-id="folder._id"
:expanded-folder-ids="expandedFolderIds"
@open-note="$emit('open-note', $event)"
@reload-notes="clearCacheAndReloadExpanded"
@toggle-expanded-folder="toggleExpanded"
/>
</div>
</div>
</template>
<!-- Notes at this level -->
<template v-for="note in notes" :key="note.key">
<button type="button" class="note-link" :class="{ 'has-color': !!note.color }" :style="entryColorStyle(note)" draggable="true" @dragstart="startDragNote($event, note)" @click.stop="$emit('open-note', note)" @contextmenu.prevent="ShowContextMenu(buildNoteContextMenu(note))">
<span class="note-link-title">{{ note.title }}</span>
</button>
</template>
<!-- Drop zone for root-level notes -->
<div v-if="level === 0" class="root-drop-zone" :class="{ 'drag-over': dragHoveredFolderId === 'root' }" @drop.stop="handleDropNoteOnRoot($event)">
</div>
<div v-if="folders.length === 0 && (!notes || notes.length === 0) && level === 0" class="sidebar-state">Empty</div>
</div>
</template>
<style scoped>
.nested-list { display: flex; flex-direction: column; gap: 2px; }
.folder-item { display: flex; flex-direction: column; cursor: default; border-radius: 10px; }
.folder-item.drag-over { background: var(--color-button-hover); }
.folder-toggle { width: 100%; padding: 6px 8px; margin: 0; border: none; background: transparent; display: flex; align-items: center; gap: 6px; cursor: grab; border-radius: 10px; color: var(--color-text); font-size: inherit; transition: background-color 0.15s ease; }
.folder-toggle:hover { background: var(--color-background-soft); }
.folder-toggle.has-color { background: color-mix(in srgb, var(--entry-color) 32%, transparent); }
.folder-toggle.has-color:hover { background: color-mix(in srgb, var(--entry-color) 50%, transparent); }
.folder-arrow { width: 14px; height: 14px; filter: invert(var(--color-icon-invert)); opacity: 0.5; }
.folder-icon { width: 16px; height: 16px; filter: invert(var(--color-icon-invert)); }
.folder-name { font-weight: 500; flex: 1; text-align: left; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.folder-children { padding-left: 20px; margin-top: 2px; cursor: default; }
.folder-children.drag-over { background: #ffffff22; border-radius: 10px; }
.note-link { width: 100%; padding: 6px; margin: 0; box-shadow: none; border: none; display: flex; flex-direction: column; align-items: flex-start; text-align: left; cursor: grab; border-radius: 8px; }
.note-link.has-color { background: color-mix(in srgb, var(--entry-color) 32%, transparent); }
.note-link.has-color:hover { background: color-mix(in srgb, var(--entry-color) 50%, transparent); }
.note-link-title { font-weight: 600; word-break: break-word; }
.sidebar-state { padding: 12px; border-radius: 10px; background: var(--color-background-soft); font-size: 14px; }
.root-drop-zone { min-height: 24px; position: relative; transition: background-color 0.15s ease, border-color 0.15s ease; border-radius: 10px; }
.root-drop-zone.drag-over { background: var(--color-button-hover); }
</style>

View File

@@ -1,47 +1,26 @@
<script setup> <script setup>
import TopSearchBar from './topbar/TopSearchBar.vue'; import TopSearchBar from './topbar/TopSearchBar.vue';
import { useCampaignService } from '~/services/Campaign'; import { useCampaignService } from '~/services/Campaign.js';
import { CreateWindow } from '~/services/Windows'; import { SetShowContent } from '~/services/Content.js';
import { SetShowContent } from '~/services/Content'; import { ClearWindow, CreateWindow } from '~/services/Windows';
const { Campaign, SetCampaign } = useCampaignService(); const { Campaign, SetCampaign } = useCampaignService();
const campaignName = computed(() => Campaign.value?.name || 'Campaign');
const campaignName = computed(() => { function OpenCampaignSettings() {
return Campaign.value?.name ?? 'Campaign'; if (!Campaign.value) return;
}); ClearWindow({ type: 'campaign_settings' });
CreateWindow('campaign_settings', { campaign: Campaign.value });
async function createNote() {
if (!Campaign.value) {
return;
}
const campaignId = Campaign.value?._id
try {
const response = await Server().post('/note/create', {
title: 'New note',
content: content.value,
campaign: campaignId
});
if (response.data.status !== 'ok') {
return;
}
emitter.emit('note-created', response.data.note);
} catch (err) {
error.value = 'Unable to create note.';
} finally {
isSaving.value = false;
}
} }
function exitToMainMenu() { function ExitCampaign() {
// Torn al menú principal: neteja la campanya (i el localStorage), amaga
// l'espai de treball i reobre el menú
ClearWindow({ type: 'campaign_settings' });
SetCampaign(null); SetCampaign(null);
SetShowContent(false); SetShowContent(false);
CreateWindow('main_menu'); CreateWindow('main_menu');
} }
</script> </script>
<template> <template>
@@ -56,13 +35,11 @@ function exitToMainMenu() {
<TopSearchBar></TopSearchBar> <TopSearchBar></TopSearchBar>
</div> </div>
<div class="right"> <div class="right">
<button class="top-bar-button sound-click" type="button" @click="exitToMainMenu"> <button class="btn-primary settings-button sound-click" type="button" @click="OpenCampaignSettings">
<img class="top-bar-button-icon" src="/icons/iconoir/regular/nav-arrow-left.svg" alt="" aria-hidden="true"> {{ $t('main-menu.settings') }}
<span>Main Menu</span>
</button> </button>
<button class="note-button sound-click" type="button" @click="createNote" :disabled="!Campaign"> <button class="btn-primary settings-button exit-button sound-click" type="button" @click="ExitCampaign">
<img class="note-button-icon" src="/icons/iconoir/regular/plus.svg" alt="" aria-hidden="true"> {{ $t('main-menu.exit') }}
<span>New Note</span>
</button> </button>
</div> </div>
</div> </div>
@@ -86,16 +63,26 @@ function exitToMainMenu() {
left: 6px; left: 6px;
} }
.left, .right { .left {
flex: 1; flex: 1;
} }
.center {
display: flex;
align-items: center;
}
.right { .right {
display: flex; display: flex;
justify-content: flex-end;
align-items: center; align-items: center;
justify-content: flex-end;
flex: 1;
padding: 0 10px;
gap: 8px; gap: 8px;
padding-right: 10px; }
.settings-button {
padding: 5px 10px;
} }
.top-bar-title { .top-bar-title {
@@ -105,27 +92,5 @@ function exitToMainMenu() {
font-weight: bold; font-weight: bold;
} }
.top-bar-button,
.note-button {
height: 30px;
padding: 0 12px;
border: 1px solid var(--color-border);
border-radius: 8px;
background: var(--color-background-soft);
display: inline-flex;
align-items: center;
gap: 8px;
cursor: pointer;
}
.note-button:disabled {
opacity: 0.5;
cursor: not-allowed;
}
.top-bar-button-icon,
.note-button-icon {
width: 16px;
height: 16px;
}
</style> </style>

View File

@@ -1,13 +1,30 @@
<script setup> <script setup>
import NoteContainer from './NoteContainer.vue'; import NoteContainer from './NoteContainer.vue';
import MapViewerPane from '../map/MapViewerPane.vue';
import { ActivePane, AnchoredMap, ClearAnchoredMap } from '~/services/Content.js';
import { useCampaignService } from '~/services/Campaign.js';
import { CreateWindow } from '~/services/Windows';
const { Campaign } = useCampaignService();
// Detaching gives the map back a floating window and shows the open notes again.
function DetachMap() {
const map = AnchoredMap.value;
if (!map) return;
ClearAnchoredMap();
CreateWindow('map_viewer', { map, campaign: Campaign.value?._id ?? null });
}
</script> </script>
<template> <template>
<div class="content"> <div class="content">
<NoteContainer> <NoteContainer v-show="ActivePane !== 'map'">
</NoteContainer> </NoteContainer>
<div v-if="AnchoredMap" v-show="ActivePane === 'map'" class="anchored-map">
<MapViewerPane :map="AnchoredMap" anchored @detach="DetachMap"></MapViewerPane>
</div>
<!-- PowerMod --> <!-- PowerMod -->
</div> </div>
</template> </template>
@@ -21,4 +38,14 @@ import NoteContainer from './NoteContainer.vue';
align-items: center; align-items: center;
} }
/* Hidden with v-show so the open notes stay mounted while the anchored map is displayed. */
.anchored-map {
width: 100%;
height: 100%;
min-width: 0;
flex-grow: 1;
display: flex;
flex-direction: column;
}
</style> </style>

View File

@@ -5,64 +5,122 @@ import { emitter } from '~/services/Emitter';
import { GetWidget, ParseMarkdown } from '~/services/Marker'; import { GetWidget, ParseMarkdown } from '~/services/Marker';
import Server from '~/services/Server'; import Server from '~/services/Server';
import { DisplayToast } from '~/services/Toaster'; import { DisplayToast } from '~/services/Toaster';
import { useI18n } from 'vue-i18n';
import TestWidget from '../widgets/TestWidget.vue'; import TestWidget from '../widgets/TestWidget.vue';
// import { GetNote, GetContent } from '@/services/Content'; // import { GetNote, GetContent } from '@/services/Content';
const props = defineProps(['text', 'title', 'noteKey']); const props = defineProps(['text', 'title', 'noteKey']);
const { t } = useI18n();
const noteContent = ref(null); // Markdown text const noteContent = ref(null); // Markdown text
const renderedContent = ref(null); // Container holding the compiled HTML (v-html)
const sourceText = ref(''); // Original markdown source, used for editing const sourceText = ref(''); // Original markdown source, used for editing
const displayText = ref(''); // Compiled HTML from markdown const displayText = ref(''); // Compiled HTML from markdown
const editingMode = ref(false); const editingMode = ref(false);
const editableTitle = ref(null);
const title = ref(props.title); const title = ref(props.title);
const displayTitle = ref(''); const isDirty = ref(false);
const showClose = ref(false);
let savedState = { text: '', title: '' };
function markDirty() {
isDirty.value = sourceText.value !== savedState.text || title.value !== savedState.title;
}
function closeNote(){ function closeNote(){
emitter.emit('delete-note', props.noteKey); // 'close-note' only closes the opened note; 'delete-note' is reserved for
// actual deletions (sidebar removal happens on that event instead)
emitter.emit('close-note', props.noteKey);
} }
const compiledMarkdown = computed(() => { const compiledMarkdown = computed(() => {
return ParseMarkdown(sourceText.value); return ParseMarkdown(sourceText.value);
}); });
// Apps de widget muntades sobre aquest node. Les guardem per desmuntar-les
// abans de re-renderitzar o en desmuntar la nota (evita instancies orfes i
// que Vue intenti parchar nodes ja eliminats).
const mountedApps = [];
function unmountComponents() {
for (const app of mountedApps) {
try {
app.unmount();
} catch (err) {
// El contenidor pot ja no ser al DOM; ignorem i netegim igualment.
}
}
mountedApps.length = 0;
}
function mountComponents() { function mountComponents() {
// Should no need more // Només dins d'aquesta nota: evitar muntar (o tornari a muntar) widgets
// d'altres notes obertes, que ja tenen la seva app.
const root = renderedContent.value;
if (!root) return;
const widget_types = ['display', 'inline']; const widget_types = ['display', 'inline'];
widget_types.forEach((widget_type) => { widget_types.forEach((widget_type) => {
const nodes = document.querySelectorAll('.vue-component-' + widget_type); const nodes = root.querySelectorAll('.vue-component-' + widget_type);
nodes.forEach(el => { nodes.forEach(el => {
const app = createApp(GetWidget(widget_type, el.dataset.component), { content: el.dataset.content }); const widget = GetWidget(widget_type, el.dataset.component);
app.mount(el); if (!widget) return; // widget desconegut: saltem en comptes de petar
try {
const app = createApp(widget, { content: el.dataset.content });
// Evita que un error dins del widget (p. ex. el parser de daus amb una
// expressio malformada) es converteixi en un error no controlat.
app.config.errorHandler = (err) => {
console.error('Widget error', el.dataset.component, err);
};
app.mount(el);
mountedApps.push(app);
} catch (err) {
console.error('Failed to mount widget', el.dataset.component, err);
}
}); });
}); });
} }
/// ///
function update(){ function update(){
// Desmuntem les apps anteriors mentre els seus nodes encara son al DOM;
// la reassignacio de displayText (v-html) eliminaria els contenidors i
// desmuntar-les despres fallaria sobre nodes desaccelats.
unmountComponents();
displayText.value = compiledMarkdown.value; displayText.value = compiledMarkdown.value;
setTimeout(() => { setTimeout(() => {
setupHeadings();
setupCallout() setupCallout()
mountComponents(); mountComponents();
}, 0); }, 0);
} }
watch(sourceText, (newText) => { watch(sourceText, markDirty);
// update();
}); watch(title, markDirty);
onMounted(() => { onMounted(() => {
sourceText.value = props.text; sourceText.value = props.text;
title.value = props.title; title.value = props.title;
displayTitle.value = props.title;
savedState = { text: props.text, title: props.title };
emitter.on('title-updated', handleTitleUpdate);
// window.addEventListener('keydown', handleKeydown); // window.addEventListener('keydown', handleKeydown);
setTimeout(() => setupCallout(), 0); setTimeout(() => setupCallout(), 0);
update(); update();
}); });
function handleTitleUpdate(data) {
if (data.key !== props.noteKey) return;
title.value = data.title;
savedState.title = data.title;
}
onUnmounted(() => { onUnmounted(() => {
emitter.off('title-updated', handleTitleUpdate);
// window.removeEventListener('keydown', handleKeydown); // window.removeEventListener('keydown', handleKeydown);
unmountComponents();
}); });
function handleKeydown(e) { function handleKeydown(e) {
@@ -73,6 +131,10 @@ function handleKeydown(e) {
if(!editingMode.value){ if(!editingMode.value){
update(); update();
SaveNote(); // Save when switching to display mode SaveNote(); // Save when switching to display mode
} else {
// Entrant en mode edicio, la vista prèvia (v-else) es destrueix;
// desmuntem els widgets per no deixar apps orfes.
unmountComponents();
} }
return; return;
} }
@@ -92,12 +154,17 @@ function SaveNote(){
title: title.value, title: title.value,
}).then((response) => { }).then((response) => {
if(response.data.status !== 'ok'){ if(response.data.status !== 'ok'){
// Handle error (e.g., show a notification) // El contingut no s'ha guardat: mantenem el punt de "no desar" i
// avisem en lloc d'empassar-nos l'error silenciosament.
isDirty.value = true;
DisplayToast('red', t(response.data.msg || 'general.notes.save-error'), 3000);
return; return;
} }
// DisplayToast('green', "Note saved successfully.", 500); savedState = { text: sourceText.value, title: title.value };
isDirty.value = false;
}).catch((error) => { }).catch((error) => {
// Handle error (e.g., show a notification) isDirty.value = true;
DisplayToast('red', t('general.notes.save-error'), 3000);
}); });
} }
@@ -146,17 +213,113 @@ function setupCallout() {
} }
} }
// --- Col·lapse de seccions (h1, h2, h3) a la vista prèvia ---
const editTitle = (e) => { // Agrupa el contingut sota cada capçalera fins la seguent del mateix nivell o
title.value = e.target.innerText; // superior, de manera que en fer clic sobre la capçalera es plegui tota la seva
// secció (les sub-seccions s'hi inclouen, estil Obsidian).
function headingLevel(el) {
const tag = el && el.tagName;
if (tag === 'H1') return 1;
if (tag === 'H2') return 2;
if (tag === 'H3') return 3;
return 0; // h4+ i la resta es tracten com a contingut normal
} }
function buildFoldTree(nodes) {
const pos = { i: 0 };
function parseSection(level) {
const heading = nodes[pos.i];
pos.i++;
const body = [];
while (pos.i < nodes.length) {
const lvl = headingLevel(nodes[pos.i]);
if (lvl && lvl <= level) break; // seguent secció del mateix nivell o superior
if (lvl) {
body.push(parseSection(lvl)); // sub-secció més profunda
} else {
body.push({ node: nodes[pos.i] });
pos.i++;
}
}
return { heading, body, level };
}
const top = [];
while (pos.i < nodes.length) {
const lvl = headingLevel(nodes[pos.i]);
if (lvl) {
top.push(parseSection(lvl));
} else {
top.push({ node: nodes[pos.i] });
pos.i++;
}
}
return top;
}
function renderFoldTree(items, target) {
for (const item of items) {
if (item.node) {
target.appendChild(item.node);
continue;
}
const wrapper = document.createElement('div');
wrapper.className = 'fold fold-h' + item.level;
item.heading.classList.add('fold-handle');
wrapper.appendChild(item.heading);
const body = document.createElement('div');
body.className = 'fold-body';
renderFoldTree(item.body, body);
wrapper.appendChild(body);
target.appendChild(wrapper);
}
}
function handleFoldClick(e) {
// No plegar quan es fa clic en un enllaç o se selecciona text
if (e.target.closest('a')) return;
const selection = window.getSelection();
if (selection && selection.toString()) return;
const handle = e.target.closest('.fold-handle');
if (!handle) return;
const wrapper = handle.parentElement;
if (!wrapper || !wrapper.classList.contains('fold')) return;
wrapper.classList.toggle('is-collapsed');
}
function setupHeadings() {
const container = renderedContent.value;
if (!container) return;
const nodes = Array.from(container.children);
if (!nodes.some((el) => headingLevel(el))) return;
const tree = buildFoldTree(nodes);
renderFoldTree(tree, container);
if (!container._foldBound) {
container.addEventListener('click', handleFoldClick);
container._foldBound = true;
}
}
</script> </script>
<template> <template>
<div class="note" @keydown="handleKeydown" tabindex="0"> <div class="note" @keydown="handleKeydown" tabindex="0">
<div class="note-stunt"> <div class="note-stunt">
<div class="close-button" v-on:click="closeNote"> <div class="unsaved-wrapper" v-if="isDirty">
<div class="unsaved-dot"></div>
<div class="close-button close-hidden" v-on:click="closeNote">
<img class="icon" src="/icons/Pixelarticons/white/close.svg" alt="My Happy SVG"/>
</div>
</div>
<div class="close-button" v-else v-on:click="closeNote">
<img class="icon" src="/icons/Pixelarticons/white/close.svg" alt="My Happy SVG"/> <img class="icon" src="/icons/Pixelarticons/white/close.svg" alt="My Happy SVG"/>
</div> </div>
<span>{{ title }}</span> <span>{{ title }}</span>
@@ -164,8 +327,8 @@ const editTitle = (e) => {
<div class="note-content-container"> <div class="note-content-container">
<textarea v-model="sourceText" class="full-editor" v-if="editingMode"></textarea> <textarea v-model="sourceText" class="full-editor" v-if="editingMode"></textarea>
<div v-else class="note-content" ref="noteContent"> <div v-else class="note-content" ref="noteContent">
<h1 contenteditable="true" ref="editableTitle" @input="editTitle">{{ displayTitle }}</h1> <h1>{{ title }}</h1>
<div ref="noteContent" v-html="displayText"></div> <div ref="renderedContent" v-html="displayText"></div>
</div> </div>
</div> </div>
@@ -184,6 +347,46 @@ const editTitle = (e) => {
user-select: none; user-select: none;
} }
.unsaved-wrapper {
position: relative;
margin-bottom: 5px;
width: 20px;
height: 20px;
}
.unsaved-dot {
width: 10px;
height: 10px;
border-radius: 50%;
background-color: #ffffff;
position: absolute;
top: 50%;
left: 50%;
transform: translate(-50%, -50%);
pointer-events: none;
}
.close-hidden {
opacity: 0;
visibility: hidden;
position: absolute;
top: 0;
left: 0;
width: 20px;
height: 20px;
margin-bottom: 0;
transition: opacity 0.15s ease, visibility 0.15s ease;
}
.unsaved-wrapper:hover .close-hidden {
opacity: 1;
visibility: visible;
}
.unsaved-wrapper:hover .unsaved-dot {
opacity: 0;
}
.full-editor { .full-editor {
width: 100%; width: 100%;
height: 100%; height: 100%;

View File

@@ -2,6 +2,7 @@
import { onMounted, onUnmounted, ref } from 'vue'; import { onMounted, onUnmounted, ref } from 'vue';
import Note from './Note.vue'; import Note from './Note.vue';
import { emitter } from '~/services/Emitter'; import { emitter } from '~/services/Emitter';
import { SetActivePane } from '~/services/Content.js';
let noteData = ref([]); let noteData = ref([]);
@@ -34,6 +35,9 @@ function pushNote(note){
} }
function handlePushNote(note) { function handlePushNote(note) {
// A note opened from the sidebar or the search palette always comes to the front, even when
// the content area is showing an anchored map.
SetActivePane('notes');
pushNote(note); pushNote(note);
} }
@@ -47,12 +51,23 @@ function handleDeleteNote(key) {
// Moure aixo // Moure aixo
onMounted(() => { onMounted(() => {
emitter.on("push-note", handlePushNote); emitter.on("push-note", handlePushNote);
emitter.on("close-note", handleDeleteNote);
emitter.on("delete-note", handleDeleteNote); emitter.on("delete-note", handleDeleteNote);
emitter.on("title-updated", handleTitleUpdated);
}); });
function handleTitleUpdated(data) {
const note = noteData.value.find(n => n.key === data.key);
if (note) {
note.title = data.title;
}
}
onUnmounted(() => { onUnmounted(() => {
emitter.off("push-note", handlePushNote); emitter.off("push-note", handlePushNote);
emitter.off("close-note", handleDeleteNote);
emitter.off("delete-note", handleDeleteNote); emitter.off("delete-note", handleDeleteNote);
emitter.off("title-updated", handleTitleUpdated);
}); });
</script> </script>

View File

@@ -0,0 +1,233 @@
<script setup>
import { computed, onBeforeUnmount, onMounted, ref, watch } from 'vue';
import { CreateWindow } from '@/services/Windows';
import { getBaseUrl } from '~/services/Server';
import { emitter } from '~/services/Emitter';
import { useCampaignService } from '~/services/Campaign.js';
// The map viewer without window chrome: it fills whatever flex column holds it, so the same
// component works inside MapViewerWindow.vue and anchored on the campaign content area.
const props = defineProps({
map: { type: Object, default: null },
// Anchored maps can be detached into a floating window; the window itself does not offer it.
anchored: { type: Boolean, default: false }
});
const emit = defineEmits(['detach']);
const { Campaign } = useCampaignService();
const campaignId = computed(() => Campaign.value?._id ?? Campaign.value?.id ?? null);
const map = ref(props.map ? { ...props.map } : null);
const viewport = ref(null);
const zoom = ref(1);
const pan = ref({ x: 0, y: 0 });
const imageSize = ref({ width: 0, height: 0 });
const showGrid = ref(true);
const dragging = ref(false);
const minZoom = 0.05;
const maxZoom = 8;
const imageUrl = computed(() => {
const image = map.value?.image;
if (!image) return '';
return /^(https?:|data:|\/\/)/i.test(image) ? image : `${getBaseUrl()}/public/${image}`;
});
const stageStyle = computed(() => ({
transform: `translate3d(${pan.value.x}px, ${pan.value.y}px, 0) scale(${zoom.value})`
}));
// The grid is drawn in screen space over the image so its lines stay one pixel wide at any zoom.
const gridStyle = computed(() => {
if (!showGrid.value || !imageSize.value.width) return { display: 'none' };
const cell = `${Math.max(1, Number(map.value?.gridSize) || 50) * zoom.value}px`;
return {
width: `${imageSize.value.width * zoom.value}px`,
height: `${imageSize.value.height * zoom.value}px`,
transform: `translate3d(${pan.value.x + (Number(map.value?.offsetX) || 0) * zoom.value}px, ${pan.value.y + (Number(map.value?.offsetY) || 0) * zoom.value}px, 0)`,
backgroundImage: `linear-gradient(to right, var(--color-link) 1px, transparent 1px), linear-gradient(to bottom, var(--color-link) 1px, transparent 1px)`,
backgroundSize: `${cell} ${cell}`
};
});
const zoomPercent = computed(() => `${Math.round(zoom.value * 100)}%`);
function clampZoom(value) {
if (!Number.isFinite(value)) return minZoom;
return Math.min(maxZoom, Math.max(minZoom, value));
}
function fitToWindow() {
const bounds = viewport.value?.getBoundingClientRect();
if (!bounds || !imageSize.value.width) return;
zoom.value = clampZoom(Math.min(bounds.width / imageSize.value.width, bounds.height / imageSize.value.height));
centerOn();
}
function centerOn() {
const bounds = viewport.value?.getBoundingClientRect();
if (!bounds || !imageSize.value.width) return;
pan.value = {
x: (bounds.width - imageSize.value.width * zoom.value) / 2,
y: (bounds.height - imageSize.value.height * zoom.value) / 2
};
}
function onImageLoaded(event) {
imageSize.value = { width: event.target.naturalWidth, height: event.target.naturalHeight };
fitToWindow();
}
// Zoom keeping the map point under `point` where it is.
function zoomAt(factor, point) {
const next = clampZoom(zoom.value * factor);
if (next === zoom.value) return;
const ratio = next / zoom.value;
pan.value = {
x: point.x - (point.x - pan.value.x) * ratio,
y: point.y - (point.y - pan.value.y) * ratio
};
zoom.value = next;
}
function onWheel(event) {
const bounds = viewport.value?.getBoundingClientRect();
if (!bounds) return;
zoomAt(event.deltaY < 0 ? 1.15 : 1 / 1.15, { x: event.clientX - bounds.left, y: event.clientY - bounds.top });
}
function zoomFromToolbar(incoming) {
const bounds = viewport.value?.getBoundingClientRect();
if (!bounds) return;
zoomAt(incoming ? 1.25 : 1 / 1.25, { x: bounds.width / 2, y: bounds.height / 2 });
}
let pointerId = null;
let lastPointer = { x: 0, y: 0 };
function onPointerDown(event) {
if (event.button !== 0 || !viewport.value) return;
dragging.value = true;
pointerId = event.pointerId;
lastPointer = { x: event.clientX, y: event.clientY };
viewport.value.setPointerCapture?.(event.pointerId);
}
function onPointerMove(event) {
if (!dragging.value || event.pointerId !== pointerId) return;
pan.value = { x: pan.value.x + (event.clientX - lastPointer.x), y: pan.value.y + (event.clientY - lastPointer.y) };
lastPointer = { x: event.clientX, y: event.clientY };
}
function onPointerUp(event) {
if (event.pointerId !== pointerId) return;
dragging.value = false;
pointerId = null;
viewport.value?.releasePointerCapture?.(event.pointerId);
}
function editMap() {
if (!map.value || !campaignId.value) return;
CreateWindow('create_map', { campaign: campaignId.value, entry: map.value });
}
function handleMapUpdated({ entityType, entry }) {
if (entityType !== 'map' || entry?._id !== map.value?._id) return;
const imageChanged = entry.image !== map.value.image;
map.value = { ...entry };
// A new image is fitted again by onImageLoaded; grid-only changes just move the overlay.
if (imageChanged) imageSize.value = { width: 0, height: 0 };
}
// A different map was anchored while this pane was already mounted.
watch(() => props.map, (incoming, previous) => {
if (incoming === previous) return;
map.value = incoming ? { ...incoming } : null;
imageSize.value = { width: 0, height: 0 };
});
onMounted(() => {
emitter.on('campaign-entry-updated', handleMapUpdated);
});
onBeforeUnmount(() => {
emitter.off('campaign-entry-updated', handleMapUpdated);
});
</script>
<template>
<div class="map-pane">
<div class="viewer-bar">
<div class="viewer-identity">
<strong>{{ map?.name }}</strong>
<span class="viewer-meta">{{ $t('campaigns.map.summary', { size: map?.gridSize, scale: map?.scale }) }}</span>
</div>
<div class="viewer-tools">
<button class="viewer-tool" :class="{ selected: showGrid }" type="button" :title="$t('campaigns.map.toggle-grid')"
:aria-label="$t('campaigns.map.toggle-grid')" :aria-pressed="showGrid.toString()" @click="showGrid = !showGrid">
<img class="tool-icon" src="/icons/iconoir/regular/view-grid.svg" alt="" aria-hidden="true">
</button>
<button class="viewer-tool" type="button" :title="$t('campaigns.map.zoom-out')" :aria-label="$t('campaigns.map.zoom-out')" @click="zoomFromToolbar(false)">
<img class="tool-icon" src="/icons/iconoir/regular/minus.svg" alt="" aria-hidden="true">
</button>
<span class="zoom-readout">{{ zoomPercent }}</span>
<button class="viewer-tool" type="button" :title="$t('campaigns.map.zoom-in')" :aria-label="$t('campaigns.map.zoom-in')" @click="zoomFromToolbar(true)">
<img class="tool-icon" src="/icons/iconoir/regular/plus.svg" alt="" aria-hidden="true">
</button>
<button class="viewer-tool" type="button" :title="$t('campaigns.map.fit')" :aria-label="$t('campaigns.map.fit')" @click="fitToWindow">
<img class="tool-icon" src="/icons/iconoir/regular/expand.svg" alt="" aria-hidden="true">
</button>
<button class="viewer-tool" type="button" :title="$t('campaigns.map.edit')" :aria-label="$t('campaigns.map.edit')" @click="editMap">
<img class="tool-icon" src="/icons/iconoir/regular/edit.svg" alt="" aria-hidden="true">
</button>
<button v-if="anchored" class="viewer-tool" type="button" :title="$t('campaigns.map.open-window')" :aria-label="$t('campaigns.map.open-window')"
@click="emit('detach')">
<img class="tool-icon" src="/icons/iconoir/regular/open-in-window.svg" alt="" aria-hidden="true">
</button>
</div>
</div>
<div
ref="viewport"
class="map-viewport"
:class="{ dragging }"
@wheel.prevent="onWheel"
@pointerdown="onPointerDown"
@pointermove="onPointerMove"
@pointerup="onPointerUp"
@pointercancel="onPointerUp"
>
<template v-if="imageUrl">
<img class="map-image" :src="imageUrl" :style="stageStyle" :alt="map?.name" draggable="false" @load="onImageLoaded">
<div class="map-grid" :style="gridStyle" aria-hidden="true"></div>
</template>
<div v-else class="map-empty">
{{ $t('campaigns.map.no-image') }}
<button class="map-edit" type="button" @click="editMap">{{ $t('campaigns.map.upload-photo') }}</button>
</div>
</div>
</div>
</template>
<style scoped>
.map-pane { width: 100%; flex: 1; min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; }
.viewer-bar { width: 100%; box-sizing: border-box; display: flex; align-items: center; justify-content: space-between; gap: 10px; padding: 8px 10px; border-bottom: 1px solid var(--color-border); background: var(--color-background-light); }
.viewer-identity { min-width: 0; display: flex; flex-direction: column; gap: 2px; }
.viewer-identity strong { font-family: MrEavesRemake; overflow-wrap: anywhere; }
.viewer-meta { font-size: 11px; opacity: .72; }
.viewer-tools { display: flex; align-items: center; gap: 4px; }
.viewer-tool { width: 30px; height: 30px; margin: 0; padding: 0; border: 1px solid var(--color-border); border-radius: 7px; background: var(--color-background-soft); display: flex; align-items: center; justify-content: center; cursor: pointer; }
.viewer-tool:hover { background: var(--color-button-hover); }
.viewer-tool.selected { border-color: var(--color-link); background: var(--color-button-hover); }
.tool-icon { width: 16px; height: 16px; filter: invert(var(--color-icon-invert)); }
.zoom-readout { min-width: 46px; text-align: center; font-size: 12px; }
.map-viewport { position: relative; width: 100%; flex: 1; min-height: 0; overflow: hidden; background-color: var(--color-background); cursor: grab; touch-action: none; }
.map-viewport.dragging { cursor: grabbing; }
.map-image { position: absolute; top: 0; left: 0; max-width: none; transform-origin: top left; user-select: none; }
.map-grid { position: absolute; top: 0; left: 0; opacity: .55; pointer-events: none; }
.map-empty { width: 100%; height: 100%; display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 8px; font-size: 13px; opacity: .8; }
.map-edit { border: 1px solid var(--color-border); border-radius: 7px; padding: 6px 11px; background: var(--color-background-soft); color: var(--color-text); font-size: 12px; cursor: pointer; }
.map-edit:hover { background: var(--color-button-hover); }
</style>

View File

@@ -0,0 +1,75 @@
<script setup>
defineProps({
title: { type: String, default: '' },
subtitle: { type: String, default: '' },
link: { type: String, default: '' },
icon: { type: String, default: '' }
});
const emit = defineEmits(['select']);
function handleSelect() {
emit('select', { title: props.title, subtitle: props.subtitle, link: props.link });
}
</script>
<template>
<button class="search-result" @click="handleSelect">
<div class="search-result-left">
<img v-if="icon" class="result-icon" :src="icon" alt="">
<span class="result-title">{{ title }}</span>
</div>
<span v-if="subtitle" class="result-subtitle">{{ subtitle }}</span>
</button>
</template>
<style scoped>
.search-result {
width: 100%;
display: flex;
align-items: center;
justify-content: space-between;
padding: 8px 12px;
background: none;
border: none;
border-radius: 4px;
cursor: pointer;
color: inherit;
text-align: left;
font-family: inherit;
font-size: 14px;
transition: background-color 0.1s ease;
}
.search-result:hover,
.search-result.selected {
background-color: var(--color-search-hover);
}
.search-result-left {
display: flex;
align-items: center;
gap: 8px;
min-width: 0;
}
.result-icon {
width: 14px;
height: 14px;
filter: invert(var(--color-icon-invert));
opacity: 0.6;
flex-shrink: 0;
}
.result-title {
white-space: nowrap;
overflow: hidden;
text-overflow: ellipsis;
}
.result-subtitle {
font-size: 12px;
opacity: 0.5;
flex-shrink: 0;
}
</style>

View File

@@ -1,110 +1,322 @@
<script setup> <script setup>
import { ref, onMounted, onUnmounted } from 'vue';
import SearchIcon from 'pixelarticons/svg/search.svg' import SearchIcon from 'pixelarticons/svg/search.svg'
/* import PlusIcon from 'pixelarticons/svg/plus.svg'
import { ref, onMounted } from 'vue'; import NoteSearchResult from './SearchResult.vue';
import { GetArrayContent, GetContent } from '@/services/Content'; import Server from '~/services/Server';
import useEmitter from '@/services/Emitter'; 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';
const emitter = useEmitter(); const { Campaign } = useCampaignService();
import NoteSearchElement from "@/components/topbar/NoteSearchElement.vue"; const inputText = ref('');
const notes = ref([]);
let noteLinks = ref([]); const showResults = ref(false);
let searchContainer = ref(null); const selectedIndex = ref(-1);
emitter.on("hide-search-container", () => { const focusInput = ref(null);
searchContainer.value.style.display = "none";
})
function updateList(event){ // ---- Keyboard shortcut to open search ----
let content = GetArrayContent(); function globalKeydown(e) {
let query = ""; const modKey = e.metaKey || e.ctrlKey;
if(event !== undefined) query = event.target.value; if ((modKey && e.key === 'k') || (e.key === '/' && !isInputFocused())) {
let filter = query.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toUpperCase().trim(); e.preventDefault();
focusInput.value?.focus();
}
if (e.key === 'Escape' && showResults.value) {
closeResults();
}
}
noteLinks.value = content.filter((noteInfo) => { function isInputFocused() {
return noteInfo["title"].normalize("NFD").replace(/[\u0300-\u036f]/g, "").toUpperCase().indexOf(filter) > -1; const tag = document.activeElement?.tagName.toLowerCase();
return tag === 'input' || tag === 'textarea' || document.activeElement?.isContentEditable;
}
// ---- Registration of create-note action (extensibile for future commands) ----
function registerCreateNoteAction() {
const action = {
id: 'create_note',
label: 'New note',
description: 'Create a new note in the current campaign',
execute: () => {
if (!Campaign.value) return;
const campaignId = Campaign.value?._id ?? Campaign.value?.id;
CreateWindow('new_note', { campaign: campaignId });
}
};
register(action);
}
// ---- Note search ----
async function fetchNotes() {
if (!Campaign.value) return;
const campaignId = Campaign.value?._id ?? Campaign.value?.id;
try {
const response = await Server().get('/note/list', { params: { campaign: campaignId } });
if (response.data.status !== 'ok') {
notes.value = [];
return;
}
notes.value = response.data.notes.map(n => ({
key: n._id,
title: n.title || 'Untitled',
date: n.date
}));
} catch (err) {
notes.value = [];
}
}
function openNote(note) {
emitter.emit('push-note', note);
closeResults();
}
// ---- Unified results: notes + command actions ----
function getCombinedResults(query) {
const combined = [];
if (query && query.trim().length > 0) {
const q = query.normalize("NFD").replace(/[\u036f]/g, "").toLowerCase().trim();
// Filter notes that match the query text
const matchingNotes = notes.value.filter(note => {
const title = (note.title || '').normalize("NFD").replace(/[\u036f]/g, "").toLowerCase();
return title.includes(q);
}); });
for (const note of matchingNotes) {
combined.push({ type: 'note', data: note });
}
// Search command actions
const matchedActions = searchActions(query);
for (const action of matchedActions) {
combined.push({ type: 'action', data: action });
}
} else if (query === '' || query === null) {
// Empty query - show all notes + all actions
for (const note of notes.value) {
combined.push({ type: 'note', data: note });
}
const allActions = searchActions('');
for (const action of allActions) {
combined.push({ type: 'action', data: action });
}
}
return combined;
} }
function searchFocus(event){ // ---- Input handling ----
if(GetContent() === undefined) return; function onInput(event) {
const query = event.target.value;
inputText.value = query;
selectedIndex.value = -1;
searchContainer.value.style.display = ""; if (!query || query.trim() === '') {
updateList(undefined); showResults.value = false;
return;
}
showResults.value = true;
} }
function onFocus() {
if (notes.value.length === 0) {
fetchNotes().then(() => {
showResults.value = true;
});
} else {
showResults.value = true;
}
}
function onBlur(event) {
// Delay closing to allow click on results
setTimeout(() => {
closeResults();
}, 150);
}
async function onKeydown(event) {
const combined = getCombinedResults(inputText.value);
if (event.key === 'ArrowDown') {
event.preventDefault();
selectedIndex.value = Math.min(selectedIndex.value + 1, combined.length - 1);
return;
}
if (event.key === 'ArrowUp') {
event.preventDefault();
selectedIndex.value = Math.max(selectedIndex.value - 1, 0);
return;
}
if (event.key === 'Enter') {
event.preventDefault();
if (selectedIndex.value >= 0) {
const item = combined[selectedIndex.value];
if (!item) return;
if (item.type === 'note') {
openNote(item.data);
} else if (item.type === 'action') {
executeAction(item.data.id);
closeResults();
}
}
}
if (event.key === 'Escape') {
closeResults();
}
}
function onSelect(result) {
if (!result) return;
if (result.link) {
const note = notes.value.find(n => n.key === result.link);
if (note) openNote(note);
}
closeResults();
}
function handleActionSelect(actionData) {
executeAction(actionData.id);
closeResults();
}
function closeResults() {
showResults.value = false;
selectedIndex.value = -1;
inputText.value = '';
}
// ---- Clean up register action on mount/unmount ----
onMounted(() => { onMounted(() => {
document.addEventListener('keydown', globalKeydown);
registerCreateNoteAction();
});
onUnmounted(() => {
document.removeEventListener('keydown', globalKeydown);
}); });
*/
</script> </script>
<template> <template>
<div class="top-search-container"> <div class="top-search-container">
<div class="top-search-box"> <div class="top-search-box">
<img class="icon search-icon" :src="SearchIcon" alt="My Happy SVG"/> <img class="icon search-icon" :src="SearchIcon" alt="" aria-hidden="true">
<!-- <input type="text" v-on:input="updateList" v-on:focus="searchFocus" class="search-prompt" placeholder="Buscar...">--> <input
<input type="text" class="search-prompt" placeholder="Buscar..."> ref="focusInput"
</div> type="text"
class="search-prompt"
<!-- <div class="search-container" ref="searchContainer" v-on:focusout="searchFocusout" style="display: none;">--> placeholder="Search or press Cmd+K..."
<div class="search-container" style="display: none;"> v-model="inputText"
<div class="search-container-list"> @input="onInput"
<!-- @focus="onFocus"
<NoteSearchElement v-for="element in noteLinks" :key="element.key" :title="element.title" :link="element.key"></NoteSearchElement> @blur="onBlur"
--> @keydown="onKeydown"
</div> autocomplete="off"
</div> spellcheck="false"
>
</div> </div>
<div class="search-container" v-if="showResults">
<template v-if="getCombinedResults(inputText).length === 0 && inputText.trim()">
<div class="search-empty">No results found</div>
</template>
<div class="search-container-list">
<NoteSearchResult
v-for="(item, index) in getCombinedResults(inputText)"
:key="(item.data.key || item.data.id) + '-' + index"
:title="item.type === 'note' ? item.data.title : item.data.label"
:subtitle="item.type === 'action' ? item.data.description : ''"
:link="item.type === 'note' ? item.data.key : null"
:icon="item.type === 'action' ? PlusIcon : ''"
:class="{ selected: index === selectedIndex }"
@select="onSelect"
@click.stop.prevent="() => { if (item.type === 'note') openNote(item.data); else handleActionSelect(item.data); }"
/>
</div>
</div>
</div>
</template> </template>
<style scoped> <style scoped>
.top-search-container { .top-search-container {
height: 100%; height: 100%;
align-items: center; align-items: center;
display: flex; display: flex;
position: relative;
} }
.top-search-box { .top-search-box {
align-items: center; align-items: center;
display: flex; display: flex;
background-color: var(--search-background); background-color: var(--color-search-background);
padding: 2px; padding: 2px;
border-radius: 5px; border-radius: 5px;
} }
.search-prompt { .search-prompt {
border: none; border: none;
padding: 5px; padding: 5px;
width: 30vw; width: 30vw;
max-width: 400px; max-width: 400px;
background: none; background: none;
margin-left: -5px; margin-left: -5px;
font-family: inherit;
} }
.search-prompt:focus { .search-prompt:focus {
outline: none; outline: none;
} }
.search-icon { .search-icon {
padding: 5px; padding: 5px;
filter: invert(var(--color-icon-invert));
} }
.search-container { .search-container {
position: absolute; position: absolute;
background-color: var(--search-background-container); background-color: var(--color-search-background-container);
top: 45px; top: 45px;
margin-left: auto; margin-left: auto;
margin-right: auto; margin-right: auto;
max-width: 800px; max-width: 600px;
max-height: 500px; max-height: 400px;
overflow-y: scroll; overflow-y: auto;
left: 0; left: 0;
right: 0; right: 0;
backdrop-filter: blur(15px); backdrop-filter: blur(15px);
border-radius: 10px; border-radius: 10px;
min-width: 400px; width: calc(30vw + 400px);
min-height: 500px; min-width: 320px;
z-index: 99999; z-index: 99999;
display: flex;
flex-direction: column;
}
.search-container-list {
display: flex;
flex-direction: column;
padding: 4px;
}
.search-empty {
padding: 16px;
text-align: center;
opacity: 0.5;
font-size: 14px;
} }
</style> </style>

View File

@@ -10,9 +10,14 @@ const steps = ref(null);
const stepsHtml = ref(""); const stepsHtml = ref("");
const rollDice = () => { const rollDice = () => {
const result = parse(props.content); try {
resultText.value = result.total; const result = parse(props.content);
stepsHtml.value = result.steps.map(renderStep).join(''); resultText.value = result.total;
stepsHtml.value = result.steps.map(renderStep).join('');
} catch (err) {
// Expressio de daus malformada: no fem petar el widget, nomes ho registrem.
console.error('Invalid roll expression', props.content, err);
}
}; };
const renderStep = (s) => { const renderStep = (s) => {

View File

@@ -8,10 +8,13 @@ const container = ref(null);
const resultText = ref(""); const resultText = ref("");
const rollDice = () => { const rollDice = () => {
console.log(props.content); try {
const result = parse(props.content); const result = parse(props.content);
console.log(result); resultText.value = result.total;
resultText.value = result.total; } catch (err) {
// Expressio de daus malformada: no fem petar el widget, nomes ho registrem.
console.error('Invalid roll expression', props.content, err);
}
}; };
onMounted(() => { onMounted(() => {

View File

@@ -0,0 +1,395 @@
<script setup>
import { computed, 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 única d'enllaç de serveis (Discord, Foundry, Obsidian): el servei demana
// l'enllaç al backend, l'usuari hi entra, s'identifica i tria la campanya que el
// servei podrà fer servir. Abans cada servei tenia la seva pròpia pantalla.
const card = ref(null);
const service = ref('');
const serviceName = ref('Dragonroll');
const code = ref('');
const targetName = ref('');
const targetUser = ref('');
const system = ref('');
const signedInAs = ref('');
const campaigns = ref([]);
const selectedCampaign = ref('');
const connectedCampaign = ref('');
// 'checking' | 'login' | 'pick' | 'connected' | 'error'
const status = ref('checking');
const messageKey = ref('');
const username = ref('');
const password = ref('');
const busy = ref(false);
// El nom propi del servei és l'últim recurs: el backend el dona amb la petició.
const serviceLabel = computed(() => serviceName.value || serviceNameOf(service.value));
// Cada servei explica d'una manera què és el que demana i què cal fer després.
const targetKey = computed(() => `link.target.${service.value || 'other'}`);
const nextKey = computed(() => `link.next.${service.value || 'other'}`);
function serviceNameOf(value) {
if (value === 'discord') return 'Discord';
if (value === 'foundry') return 'Foundry VTT';
if (value === 'obsidian') return 'Obsidian';
return 'Dragonroll';
}
// El codi viatja al fragment de la URL, així que el navegador no l'envia mai al
// servidor. El servei, que és qui demana l'enllaç, hi posa també el seu nom.
function readLinkParams() {
const hash = new URLSearchParams(window.location.hash.slice(1));
const search = new URLSearchParams(window.location.search);
return {
code: hash.get('code') || search.get('code') || '',
service: hash.get('service') || search.get('service') || ''
};
}
function ShowError(key) {
messageKey.value = key;
}
function AskForLogin() {
const user = GetUser();
if (!user) {
status.value = 'login';
messageKey.value = '';
return;
}
signedInAs.value = user.username || user.name || user.email || 'Dragonroll';
status.value = 'pick';
messageKey.value = '';
LoadCampaigns();
}
async function LoadLinkDetails() {
const response = await Server().post('/link/details', { code: code.value });
const details = response.data;
if (details.status !== 'ok') {
status.value = 'error';
ShowError('link.errors.expired');
return;
}
service.value = details.service || service.value;
serviceName.value = details.serviceName || serviceNameOf(service.value);
targetName.value = details.targetName || '';
targetUser.value = details.targetUser || '';
system.value = details.system || '';
AskForLogin();
}
async function LoadCampaigns() {
try {
const response = await Server().get('/campaign/list');
campaigns.value = (response.data.status === 'ok' && Array.isArray(response.data.campaigns))
? response.data.campaigns
: [];
if (campaigns.value.length === 1) selectedCampaign.value = String(campaigns.value[0]._id);
} catch {
campaigns.value = [];
}
}
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 || 'link.errors.sign-in-failed');
return;
}
// El token passa al servei d'usuari perquè el client el reutilitzi en connectar.
SetUser(response.data.token);
password.value = '';
AskForLogin();
} catch {
ShowError('link.errors.sign-in-failed');
} finally {
busy.value = false;
}
}
// A campaign that already has this very service on it is being re-connected, and
// saying so is what keeps the picker honest.
function AlreadyLinked(campaign) {
if (service.value === 'foundry') return !!campaign.foundryWorldId;
if (service.value === 'discord') return !!campaign.discordGuildId;
return false;
}
async function Connect() {
if (!selectedCampaign.value) {
ShowError('link.errors.no-campaign');
return;
}
busy.value = true;
messageKey.value = '';
try {
const response = await Server().post('/link/complete', {
code: code.value,
campaignId: selectedCampaign.value
});
if (response.data.status !== 'ok') {
ShowError(response.data.msg || 'link.errors.expired');
return;
}
connectedCampaign.value = response.data.campaign?.name || '';
status.value = 'connected';
// 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('link.errors.session-expired');
return;
}
ShowError('link.errors.internal');
} finally {
busy.value = false;
}
}
useHead({
title: computed(() => `Connect ${serviceLabel.value} to Dragonroll`)
});
onMounted(() => {
AddSound(card.value);
const params = readLinkParams();
code.value = params.code;
service.value = params.service || (window.location.pathname.startsWith('/discord') ? 'discord' : '');
if (!code.value) {
status.value = 'error';
ShowError('link.errors.missing-code');
return;
}
LoadLinkDetails().catch(() => {
status.value = 'error';
ShowError('link.errors.internal');
});
});
</script>
<template>
<div class="service-link">
<main class="link-card" ref="card">
<h1>{{ $t('link.title', { service: serviceLabel }) }}</h1>
<p v-if="targetName" class="summary">
{{ $t(targetKey, {
target: targetName,
user: targetUser,
system: system ? $t('link.system', { system }) : ''
}) }}
</p>
<p v-else-if="status !== 'error'" class="summary">
<Spinner v-if="status === 'checking'"></Spinner>
<span v-else>{{ $t('link.checking') }}</span>
</p>
<form v-if="status === 'login'" v-on:submit.prevent="SignIn">
<p>{{ $t('link.sign-in-lead', { service: serviceLabel }) }}</p>
<div class="form-field">
<label for="service-link-usermail">{{ $t('login.username') }}</label>
<input
id="service-link-usermail"
type="text"
:placeholder="$t('login.username-placeholder')"
name="usermail"
autocomplete="username"
v-model="username"
required
>
</div>
<div class="form-field">
<label for="service-link-password">{{ $t('login.password') }}</label>
<input
id="service-link-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 === 'pick'">
<p>{{ $t('link.signed-in-as', { user: signedInAs }) }}</p>
<p class="question">{{ $t('link.pick-campaign', { service: serviceLabel }) }}</p>
<p v-if="!campaigns.length" class="hint">{{ $t('link.no-campaigns') }}</p>
<ul v-else class="campaigns">
<li v-for="campaign in campaigns" :key="campaign._id">
<label class="campaign" :class="{ selected: selectedCampaign === String(campaign._id) }">
<input
type="radio"
name="campaign"
:value="String(campaign._id)"
v-model="selectedCampaign"
>
<span class="swatch" :style="{ backgroundColor: campaign.color || 'var(--color-accent)' }"></span>
<span class="campaign-name">{{ campaign.name }}</span>
<span v-if="AlreadyLinked(campaign)" class="badge">
{{ $t('link.already-linked', { service: serviceLabel }) }}
</span>
</label>
</li>
</ul>
<p class="hint">{{ $t('link.trust-warning', { service: serviceLabel }) }}</p>
<p class="hint">{{ $t('link.replace-warning') }}</p>
<button
class="btn-primary sound-click"
type="button"
:disabled="busy || !selectedCampaign"
v-on:click="Connect"
>
<Spinner v-if="busy"></Spinner>
<span v-else>{{ $t('link.connect', { service: serviceLabel }) }}</span>
</button>
</section>
<section v-if="status === 'connected'">
<p class="success">{{ $t('link.connected', { campaign: connectedCampaign }) }}</p>
<p class="hint">{{ $t(nextKey, { service: serviceLabel }) }}</p>
</section>
<p v-if="messageKey" class="error" role="status">
{{ $t(messageKey) }}
</p>
</main>
</div>
</template>
<style scoped>
.service-link {
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);
}
.link-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;
}
.link-card h1 {
margin-top: 0;
font-family: 'MrEavesRemake', serif;
font-size: 1.5rem;
}
.link-card p {
line-height: 1.5;
}
.summary {
color: var(--color-gray);
}
form,
section {
margin-top: 18px;
}
.question {
font-weight: bold;
}
.campaigns {
list-style: none;
margin: 0 0 14px 0;
padding: 0;
display: flex;
flex-direction: column;
gap: 8px;
text-align: left;
}
.campaign {
display: flex;
align-items: center;
gap: 10px;
padding: 10px;
border: 1px solid var(--color-border);
border-radius: 8px;
cursor: pointer;
}
.campaign.selected {
border-color: var(--color-accent);
background-color: var(--color-background-soft);
}
.swatch {
width: 14px;
height: 14px;
border-radius: 4px;
flex: 0 0 auto;
border: 1px solid var(--color-border);
}
.campaign-name {
flex: 1;
}
.badge {
font-size: 0.8rem;
color: var(--color-gray);
}
.hint {
color: var(--color-gray);
font-size: 0.95rem;
}
.success {
color: var(--color-green);
}
.error {
color: var(--color-red);
}
button {
width: 100%;
}
</style>

View File

@@ -0,0 +1,315 @@
<script setup>
import { 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 id = data.id;
// Els serveis s'enllacen tots igual: ells mostren un enllaç de Dragonroll i aquí
// només es mira què té connectat la campanya i se'n desenllaça el que calgui.
const services = ref([]);
const unlinked = ref('');
const rows = [
{ id: 'basic', value: 'campaigns.settings.tabs.basic' },
{ id: 'integrations', value: 'campaigns.settings.tabs.integrations' }
];
const serviceKeys = ['foundry', 'discord', 'obsidian'];
onMounted(() => {
Top(wrapper);
SetupHandle(id, handle);
SetSize(id, { width: 560, height: 430 });
ResetPosition(id, 'center');
SetResizable(id, true);
SetMinSize(id, { width: 440, height: 340 });
LoadServices();
});
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 LoadServices() {
try {
const response = await Server().get(`/campaign/services?campaignId=${campaign._id}`);
services.value = response.data.status === 'ok' && Array.isArray(response.data.services)
? response.data.services
: [];
} catch {
services.value = [];
}
}
function LinkFor(service) {
return services.value.find((link) => link.service === service) || null;
}
// El món de Foundry es descriu amb el que la campanya ja en sap, per si el món
// es va enllaçar abans que els serveis tinguessin un registre comú.
function ServiceTarget(service, link) {
if (link?.targetName) return link.targetName;
if (service === 'foundry' && campaign.foundryWorldTitle) return campaign.foundryWorldTitle;
if (service === 'discord' && campaign.discordGuildId) return campaign.discordGuildId;
return '';
}
function WhoConnected(link) {
return link?.dragonrollUserName ? $t('campaigns.settings.services.connected-by', { user: link.dragonrollUserName }) : '';
}
async function Unlink(service) {
unlinked.value = service;
try {
const response = await Server().post('/campaign/service-unlink', {
campaignId: campaign._id,
service
});
if (response.data.status !== 'ok') {
DisplayToast('red', $t(response.data.msg || 'errors.internal'), 3000);
return;
}
ApplyCampaignUpdate(response.data.campaign);
services.value = Array.isArray(response.data.services) ? response.data.services : [];
DisplayToast('green', $t('campaigns.settings.services.unlinked', {
service: $t(`campaigns.settings.services.${service}.name`)
}), 3000);
} catch {
DisplayToast('red', $t('errors.internal'), 3000);
} finally {
unlinked.value = '';
}
}
</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>
<p class="help-text standalone">{{ $t('campaigns.settings.services.help') }}</p>
<div class="settings-fields">
<div v-for="service in serviceKeys" :key="service" class="service">
<div class="service-head">
<strong>{{ $t(`campaigns.settings.services.${service}.name`) }}</strong>
<button
v-if="LinkFor(service)"
class="btn-primary sound-click"
type="button"
:disabled="unlinked !== ''"
@click="Unlink(service)"
>
{{ $t('campaigns.settings.services.unlink') }}
</button>
</div>
<p class="service-state" :class="{ linked: LinkFor(service) }">
{{ ServiceTarget(service, LinkFor(service)) || $t('campaigns.settings.services.not-connected') }}
<span v-if="WhoConnected(LinkFor(service))" class="who">
{{ WhoConnected(LinkFor(service)) }}
</span>
</p>
<p class="help-text standalone">
{{ $t(`campaigns.settings.services.${service}.how`) }}
</p>
</div>
</div>
<div class="settings-fields">
<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;
}
.service {
display: flex;
flex-direction: column;
gap: 6px;
padding-bottom: 14px;
border-bottom: 1px solid var(--color-border);
}
.service-head {
display: flex;
align-items: center;
justify-content: space-between;
gap: 10px;
}
.service-state {
margin: 0;
font-size: 14px;
overflow-wrap: anywhere;
}
.service-state.linked {
color: var(--color-green);
}
.who {
opacity: 0.75;
font-size: 13px;
}
.actions {
display: flex;
justify-content: flex-end;
padding: 12px 18px;
border-top: 1px solid var(--color-border);
}
</style>

View 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>

View File

@@ -0,0 +1,153 @@
<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);
// The window edits items when the sidebar passes one in; actors have their sheet.
const editing = data.entry || null;
const isActor = data.entityType === 'actor';
const endpoint = isActor ? '/actor/create' : (editing ? '/item/update' : '/item/create');
function initialForm() {
if (!editing) {
return {
name: '', type: 'character', species: '', className: '', level: '', background: '', challengeRating: '',
category: 'adventuring-gear', rarity: 'common', quantity: 1, weight: '', properties: '', description: ''
};
}
return {
name: editing.name ?? '', type: 'character', species: '', className: '', level: '', background: '', challengeRating: '',
category: editing.category ?? 'adventuring-gear', rarity: editing.rarity ?? 'common',
quantity: editing.quantity ?? 1, weight: editing.weight ?? '', properties: editing.properties ?? '',
description: editing.description ?? ''
};
}
const form = ref(initialForm());
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 = isActor
? { name: form.value.name.trim(), campaign: data.campaign }
: { name: form.value.name.trim(), ...(editing ? { id: editing._id } : { 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(editing ? 'campaign-entry-updated' : '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(editing ? 'campaigns.item.edit' : (isActor ? 'campaigns.actor.new' : 'campaigns.item.new')) }}</h3>
<p v-if="!isActor && editing?.foundryItemId" class="sync-note">{{ $t('campaigns.item.foundry-sync-note') }}</p>
<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(editing ? 'campaigns.actions.save' : '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; }
.sync-note { margin: -8px 0 12px; font-size: 12px; opacity: 0.72; }
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>

View File

@@ -0,0 +1,194 @@
<script setup>
import { onBeforeUnmount, onMounted, ref } from 'vue';
import { useI18n } from 'vue-i18n';
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';
const { t } = useI18n();
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 error = ref('');
const imageInput = ref(null);
// Passing an entry edits an existing map; otherwise this window creates one.
const editing = data.entry || null;
function initialForm() {
return {
name: editing?.name ?? '',
gridSize: Number(editing?.gridSize ?? 50),
offsetX: Number(editing?.offsetX ?? 0),
offsetY: Number(editing?.offsetY ?? 0),
scale: Number(editing?.scale ?? 5)
};
}
const form = ref(initialForm());
const selectedImage = ref(null);
let previewObjectUrl = null;
function serverImageUrl(image) {
if (!image) return '';
return /^(https?:|data:|\/\/)/i.test(image) ? image : `${getBaseUrl()}/public/${image}`;
}
const previewUrl = ref(serverImageUrl(editing?.image));
onMounted(() => {
Top(wrapper);
SetupHandle(id, handle);
SetSize(id, { width: 500, height: 600 });
ResetPosition(id, 'center');
});
onBeforeUnmount(() => {
ClearWindow({ type: 'create_map' });
if (previewObjectUrl) URL.revokeObjectURL(previewObjectUrl);
});
function pickImage() {
imageInput.value?.click();
}
function onImageSelected(event) {
const file = event.target.files?.[0];
event.target.value = '';
if (!file) return;
if (previewObjectUrl) URL.revokeObjectURL(previewObjectUrl);
previewObjectUrl = URL.createObjectURL(file);
selectedImage.value = file;
previewUrl.value = previewObjectUrl;
}
const numberFields = ['gridSize', 'offsetX', 'offsetY', 'scale'];
async function saveMap() {
if (!form.value.name.trim() || saving.value) return;
saving.value = true;
error.value = '';
try {
const body = new FormData();
body.append('name', form.value.name.trim());
if (editing) body.append('id', editing._id);
else body.append('campaign', data.campaign);
for (const field of numberFields) {
if (Number.isFinite(form.value[field])) body.append(field, String(form.value[field]));
}
if (selectedImage.value) body.append('image', selectedImage.value);
const response = await Server().post(editing ? '/map/update' : '/map/create', body, {
headers: { "Content-Type": "multipart/form-data" }
});
if (response.data.status !== 'ok') {
error.value = t('campaigns.map.save-error');
return;
}
emitter.emit(editing ? 'campaign-entry-updated' : 'campaign-entry-created', { entityType: 'map', entry: response.data.map });
ClearWindow({ id });
} catch (requestError) {
error.value = t('campaigns.map.save-error');
} 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(editing ? 'campaigns.map.edit' : 'campaigns.map.new') }}</h3>
<div v-if="error" class="form-error">{{ error }}</div>
<form @submit.prevent="saveMap">
<label class="form-field">
<span>{{ $t('campaigns.fields.name') }}</span>
<input v-model="form.name" required autofocus autocomplete="off">
</label>
<div class="form-field">
<span>{{ $t('campaigns.map.photo') }}</span>
<div class="image-picker" :class="{ empty: !previewUrl }">
<img v-if="previewUrl" :src="previewUrl" :alt="$t('campaigns.map.photo')">
<button class="pick-image sound-click" type="button" :disabled="saving" @click="pickImage">
{{ $t(previewUrl ? 'campaigns.map.change-photo' : 'campaigns.map.upload-photo') }}
</button>
</div>
<small class="field-help">{{ $t('campaigns.map.photo-hint') }}</small>
<input ref="imageInput" class="image-input" type="file" accept="image/*" @change="onImageSelected">
</div>
<div class="form-grid">
<label class="form-field">
<span>{{ $t('campaigns.map.grid-size') }}</span>
<input v-model.number="form.gridSize" type="number" min="1" step="1">
</label>
<label class="form-field">
<span>{{ $t('campaigns.map.scale') }}</span>
<!-- step="any": any decimal works, the 0.01 minimum alone keeps it positive -->
<input v-model.number="form.scale" type="number" min="0.01" step="any" inputmode="decimal">
</label>
<label class="form-field">
<span>{{ $t('campaigns.map.offset-x') }}</span>
<input v-model.number="form.offsetX" type="number" step="1">
</label>
<label class="form-field">
<span>{{ $t('campaigns.map.offset-y') }}</span>
<input v-model.number="form.offsetY" type="number" step="1">
</label>
</div>
<small class="field-help">{{ $t('campaigns.map.scale-help') }}</small>
<div class="form-actions">
<button class="btn-primary sound-click" type="submit" :disabled="saving">
{{ saving ? $t('campaigns.actions.saving') : $t('campaigns.actions.save') }}
</button>
</div>
</form>
</div>
</div>
</template>
<style scoped>
.window-wrapper { display: flex; align-items: center; flex-direction: column; }
/* Stretch so the outer margin insets the content instead of overflowing the window. */
.body {
flex: 1;
min-height: 0;
align-self: stretch;
box-sizing: border-box;
margin: 10px;
padding: 8px;
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 {
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;
}
input:focus { outline: none; border-color: var(--color-link); }
.image-picker {
min-height: 96px; display: flex; align-items: center; justify-content: center; overflow: hidden;
border: 1px solid var(--color-border); border-radius: 8px; background: var(--color-background-soft);
}
.image-picker.empty { border-style: dashed; }
.image-picker img { max-width: 100%; max-height: 180px; object-fit: contain; }
.pick-image {
border: 1px solid var(--color-border); border-radius: 6px; padding: 5px 10px; margin: 6px;
background: var(--color-background-light); color: var(--color-text); font-size: 12px; cursor: pointer;
}
.pick-image:hover { background: var(--color-button-hover); }
.pick-image:disabled { opacity: .55; cursor: wait; }
.image-input { display: none; }
.field-help { font-size: 11px; opacity: .72; }
.form-error { padding: 7px 10px; border-radius: 6px; color: var(--color-red); background: var(--color-background-soft); font-size: 12px; }
.form-actions { display: flex; justify-content: center; margin-top: 2px; }
.form-actions button { width: 100%; max-width: 220px; }
</style>

View File

@@ -0,0 +1,33 @@
<script setup>
import { onMounted, ref } from 'vue';
import { SetupHandle, SetSize, ResetPosition, Top } from '@/services/Windows';
import WindowHandle from './partials/WindowHandle.vue';
import MapViewerPane from '../viewer/map/MapViewerPane.vue';
const props = defineProps(['data']);
const id = props.data.id;
const handle = ref(null);
const wrapper = ref(null);
const map = props.data.map ? { ...props.data.map } : null;
onMounted(() => {
Top(wrapper);
SetupHandle(id, handle);
SetSize(id, {
width: Math.max(480, Math.min(1100, window.innerWidth - 24)),
height: Math.max(360, Math.min(760, window.innerHeight - 32))
});
ResetPosition(id, 'center');
});
</script>
<template>
<div class="window-wrapper viewer-window" :id="'window-wrapper-' + id" ref="wrapper">
<WindowHandle :window="id" ref="handle" />
<MapViewerPane :map="map" />
</div>
</template>
<style scoped>
.viewer-window { min-width: 320px; min-height: 0; }
</style>

View File

@@ -0,0 +1,136 @@
<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('');
const creating = !!data.name;
onMounted(() => {
newName.value = data.name || '';
SetupHandle(id, handle);
SetSize(id, { width: 420, height: 200 });
ResetPosition(id, 'center');
});
onBeforeUnmount(() => {
ClearWindow({ type: 'new_folder' });
});
function confirmSave() {
if (!newName.value.trim()) {
return;
}
const folderData = {
name: newName.value.trim(),
campaign: data.campaign
};
const url = creating ? '/folder/rename' : '/folder/create';
if (creating) {
folderData.id = data.folderId;
}
Server().post(url, folderData).then((response) => {
if (response.data.status !== 'ok') {
return;
}
emitter.emit('folder-saved', response.data.folder);
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>{{ creating ? 'Rename Folder' : 'New Folder' }}</h3>
<form v-on:submit.prevent="confirmSave">
<div class="form-field">
<input
type="text"
v-model="newName"
placeholder="Folder name"
autofocus
autocomplete="off"
>
</div>
<div class="form-actions">
<button class="btn-primary sound-click" type="submit">{{ creating ? 'Save' : '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>

View File

@@ -0,0 +1,130 @@
<script setup>
import { onBeforeUnmount, onMounted, ref } from 'vue';
import { SetupHandle, SetSize, ResetPosition, ClearWindow, Top } 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(() => {
Top(wrapper);
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>

View File

@@ -0,0 +1,127 @@
<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(() => {
newName.value = data.title || '';
SetupHandle(id, handle);
SetSize(id, { width: 420, height: 200 });
ResetPosition(id, 'center');
});
onBeforeUnmount(() => {
ClearWindow({ type: 'rename_note' });
});
function confirmRename() {
if (!newName.value.trim()) {
return;
}
Server().post('/note/update', {
id: data.key,
title: newName.value.trim(),
}).then((response) => {
if (response.data.status !== 'ok') {
return;
}
emitter.emit('note-renamed', { key: data.key, title: newName.value.trim() });
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>Rename Note</h3>
<form v-on:submit.prevent="confirmRename">
<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">Save</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>

View File

@@ -0,0 +1,54 @@
import { ref } from 'vue';
const actions = ref([]);
function register(action) {
if (!action.id || !action.execute) {
console.warn('[ActionRegistry] Action missing id or execute:', action);
return;
}
const existingIndex = actions.value.findIndex(a => a.id === action.id);
if (existingIndex !== -1) {
actions.value[existingIndex] = action;
} else {
actions.value.push(action);
}
}
function unregister(id) {
actions.value = actions.value.filter(a => a.id !== id);
}
function search(query) {
if (!query || query.trim() === '') return [];
const q = query.normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase().trim();
if (q === '') return [];
return actions.value.filter(action => {
if (typeof action.isActive === 'function' && !action.isActive()) {
return false;
}
const label = (action.label || '').normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
const description = (action.description || '').normalize("NFD").replace(/[\u0300-\u036f]/g, "").toLowerCase();
return label.includes(q) || description.includes(q);
}).sort((a, b) => {
const aLabel = (a.label || '').toLowerCase();
const bLabel = (b.label || '').toLowerCase();
const qLower = q;
const aStarts = aLabel.startsWith(qLower) ? 0 : 1;
const bStarts = bLabel.startsWith(qLower) ? 0 : 1;
return aStarts - bStarts || aLabel.localeCompare(bLabel);
});
}
function execute(id, params = {}) {
const action = actions.value.find(a => a.id === id);
if (action && action.execute) {
action.execute(params);
}
}
export { register, unregister, search, execute };
export default { register, unregister, search, execute };

View File

@@ -2,11 +2,38 @@ import { ref } from 'vue';
const ShowContent = ref(false); const ShowContent = ref(false);
// What the campaign workspace shows where the notes live: the open notes, or the map the
// sidebar anchored on the note container. 'notes' | 'map'
const ActivePane = ref('notes');
// The map anchored on the note container (a campaign entry of the sidebar's maps section).
const AnchoredMap = ref(null);
function SetShowContent(value) { function SetShowContent(value) {
ShowContent.value = value; ShowContent.value = value;
} }
function SetActivePane(value) {
ActivePane.value = value;
}
// Anchoring shows the map where the open notes are; they stay open and come back on 'notes'.
function AnchorMap(map) {
AnchoredMap.value = map ?? null;
ActivePane.value = AnchoredMap.value ? 'map' : 'notes';
}
function ClearAnchoredMap() {
AnchoredMap.value = null;
if (ActivePane.value === 'map') ActivePane.value = 'notes';
}
export { export {
ShowContent, ShowContent,
SetShowContent SetShowContent,
ActivePane,
AnchoredMap,
SetActivePane,
AnchorMap,
ClearAnchoredMap
} }

View File

@@ -27,6 +27,14 @@ function PopulateContext(val){
let elementNum = 0; let elementNum = 0;
val.forEach(element => { val.forEach(element => {
// Handle divider elements
if (element.divider) {
let contextMenuElement = document.createElement('div');
contextMenuElement.classList.add("context-menu-divider");
children.push(contextMenuElement);
return;
}
let contextMenuElement = document.createElement('div'); let contextMenuElement = document.createElement('div');
contextMenuElement.classList.add("context-menu-element"); contextMenuElement.classList.add("context-menu-element");
if(element.action) if(element.action)
@@ -36,7 +44,13 @@ function PopulateContext(val){
spanInfo.innerHTML = element.name; spanInfo.innerHTML = element.name;
contextMenuElement.appendChild(spanInfo); contextMenuElement.appendChild(spanInfo);
if(element.icon){ if(element.color){
let swatch = document.createElement('span');
swatch.classList.add("context-menu-swatch");
swatch.style.backgroundColor = element.color;
contextMenuElement.appendChild(swatch);
}
else if(element.icon){
let iconContextElement = document.createElement('img'); let iconContextElement = document.createElement('img');
iconContextElement.src = element.icon; iconContextElement.src = element.icon;
contextMenuElement.appendChild(iconContextElement); contextMenuElement.appendChild(iconContextElement);

View File

@@ -13,16 +13,30 @@ const componentCache = {
display: {} display: {}
} }
// Retorna null si el widget no està registrat (evita cridar
// defineAsyncComponent(undefined), que llençaria un TypeError i rebentaria
// tot el muntatge de notes).
const GetWidget = (type, name) => { const GetWidget = (type, name) => {
const loader = widget_map[type] && widget_map[type][name];
if (!loader) {
console.warn(`[Marker] Unknown widget "${name}" of type "${type}"; skipping.`);
return null;
}
if (!componentCache[type][name]) { if (!componentCache[type][name]) {
componentCache[type][name] = defineAsyncComponent( componentCache[type][name] = defineAsyncComponent(loader)
widget_map[type][name]
)
} }
return componentCache[type][name] return componentCache[type][name]
} }
// Escapa valors per inserir-los de forma segura dins d'un atribut HTML.
const escapeAttr = (value) => String(value ?? "")
.replace(/&/g, "&amp;")
.replace(/</g, "&lt;")
.replace(/>/g, "&gt;")
.replace(/"/g, "&quot;");
const marker = new Marked(); const marker = new Marked();
@@ -45,7 +59,7 @@ const extension = {
}, },
renderer(token) { renderer(token) {
return `<div class="vue-component-display" data-component="${token.name}" data-content="${token.text}"></div>`; return `<div class="vue-component-display" data-component="${escapeAttr(token.name)}" data-content="${escapeAttr(token.text)}"></div>`;
}, },
}; };
@@ -70,7 +84,7 @@ const inlineExtension = {
}, },
renderer(token) { renderer(token) {
return `<span class="vue-component-inline" data-component="${token.name}" data-content="${token.text}"></span>`; return `<span class="vue-component-inline" data-component="${escapeAttr(token.name)}" data-content="${escapeAttr(token.text)}"></span>`;
}, },
}; };
@@ -94,7 +108,7 @@ const linkExtension = {
}, },
renderer(token) { renderer(token) {
return `<span class="vue-link" data-href="${token.link}"></span>`; return `<span class="vue-link" data-href="${escapeAttr(token.link)}">Link</span>`;
}, },
}; };

View File

@@ -34,6 +34,54 @@ const defWindows = {
component: () => import('~/components/windows/CreateCampaignWindow.vue'), component: () => import('~/components/windows/CreateCampaignWindow.vue'),
close: () => ClearWindow({type: 'create_campaign'}), close: () => ClearWindow({type: 'create_campaign'}),
movable: true 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'),
close: () => ClearWindow({type: 'rename_note'}),
movable: true
},
new_folder: {
title: "New Folder",
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
},
create_map: {
title: 'windows.create-map',
component: () => import('~/components/windows/CreateMapWindow.vue'),
close: () => ClearWindow({type: 'create_map'}),
movable: true
},
map_viewer: {
title: 'windows.map-viewer',
component: () => import('~/components/windows/MapViewerWindow.vue'),
close: () => ClearWindow({type: 'map_viewer'}),
movable: true
} }
} }

View File

@@ -189,6 +189,7 @@ function GetPosition(id) {
function ResetPosition(id, pos) { function ResetPosition(id, pos) {
let win = GetWindowWithId(id); let win = GetWindowWithId(id);
if (!win) return;
let data = { x: win.x, y: win.y }; let data = { x: win.x, y: win.y };
if (data.x && data.y) { if (data.x && data.y) {

View File

@@ -0,0 +1,94 @@
{
"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.",
"saved": "S'ha desat la configuració de la campanya.",
"saving": "Desant...",
"services": {
"help": "Tots els serveis es connecten igual: demanen a Dragonroll un enllaç de registre, te'l mostren i tries aquesta campanya allà. Des d'aquí no es connecta res.",
"not-connected": "No connectat",
"unlink": "Desenllaça",
"unlinked": "{service} ja no està connectat amb aquesta campanya.",
"connected-by": "connectat per {user}",
"foundry": {
"name": "Foundry VTT",
"how": "Obre l'enllaç de Dragonroll des de la configuració del mòdul del teu món i tria aquesta campanya."
},
"discord": {
"name": "Discord",
"how": "Executa /dragonroll connect al teu servidor i tria aquesta campanya."
},
"obsidian": {
"name": "Obsidian",
"how": "Prem Connect to Dragonroll a la configuració del connector d'Obsidian i tria aquesta campanya."
}
},
"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."
}
},
"sidebar-label": "Campanya",
"synced": "Sincronitzat",
"sections": { "notes": "Notes", "actors": "Actors i personatges", "items": "Objectes", "maps": "Mapes" },
"actions": {
"new-note": "Nota nova", "new-folder": "Carpeta nova", "refresh": "Actualitza",
"create": "Crea {section}", "submit": "Crea", "edit": "Edita", "save": "Desa", "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.",
"empty-maps": "Encara no hi ha mapes 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", "edit": "Edita l'objecte", "foundry-sync-note": "Els canvis en aquest objecte també s'apliquen al món del Foundry vinculat.",
"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" }
},
"map": {
"new": "Mapa nou", "edit": "Edita el mapa",
"photo": "Imatge del mapa", "upload-photo": "Pujar imatge", "change-photo": "Canviar imatge",
"photo-hint": "Una foto o una digitalització del mapa. Es manté la imatge actual si no en tries una de nova.",
"grid-size": "Mida de la quadrícula (px)", "offset-x": "Desplaçament X (px)", "offset-y": "Desplaçament Y (px)",
"scale": "Escala (distància per cel·la)", "scale-help": "La distància que representa una cel·la de la quadrícula, com ara 5 peus.",
"summary": "Quadrícula de {size} px · {scale} per cel·la",
"save-error": "No s'ha pogut desar aquest mapa.",
"no-image": "Aquest mapa encara no té imatge.",
"zoom-in": "Apropar", "zoom-out": "Allunyar", "fit": "Ajustar a la finestra", "toggle-grid": "Mostrar la quadrícula",
"open-window": "Obre en una finestra", "anchored": "Ancorat"
},
"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."
}
}

View 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ó."
}
}

View File

@@ -0,0 +1,8 @@
{
"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.",
"actor-already-synced": "Un altre actor d'aquesta campanya ja està sincronitzat amb aquell actor del Foundry.",
"item-already-synced": "Un altre objecte d'aquesta campanya ja està sincronitzat amb aquell objecte del Foundry."
}
}

View File

@@ -1 +1,7 @@
{} {
"save": "Desa",
"notes": {
"saved": "Nota desada",
"save-error": "No s'ha pogut desar la nota"
}
}

View File

@@ -0,0 +1,35 @@
{
"title": "Connecta {service} amb Dragonroll",
"checking": "Comprovant aquest enllaç…",
"system": " · {system}",
"target": {
"discord": "Servidor de Discord: {target}. Sol·licitat per {user}.",
"foundry": "Món de Foundry: {target}{system}. Sol·licitat per {user}.",
"obsidian": "Vault d'Obsidian: {target}.",
"other": "{target} vol fer servir una de les teves campanyes."
},
"sign-in-lead": "Inicia sessió amb el compte de Dragonroll propietari de la campanya que ha de fer servir {service}.",
"signed-in-as": "Has iniciat sessió com a {user}.",
"pick-campaign": "Quina campanya pot fer servir {service}?",
"no-campaigns": "Aquest compte encara no té campanyes. Crea'n una primer a Dragonroll.",
"already-linked": "ja connectat a un {service}",
"connect": "Connecta aquesta campanya",
"connected": "Aquesta campanya ja està connectada amb {target}.",
"trust-warning": "Connecta només serveis de confiança: poden llegir i modificar el que conté la seva campanya.",
"replace-warning": "Connectar una campanya reemplaça el que aquest servei tenia connectat abans.",
"next": {
"discord": "Torna a Discord: el bot hi confirmarà la connexió.",
"foundry": "Torna a Foundry: el mòdul es connectarà sol.",
"obsidian": "Torna a Obsidian: el connector ho agafarà sol.",
"other": "Torna al servei d'on vens."
},
"errors": {
"missing-code": "A aquest enllaç li falta el codi. Demana'n un de nou al servei.",
"expired": "Aquest enllaç no és vàlid o ha caducat. Demana'n un de nou al servei.",
"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.",
"no-campaign": "Tria la campanya que ha de fer servir aquest servei.",
"notfound": "Aquesta campanya no és teva. Inicia sessió amb el compte propietari.",
"internal": "No s'ha pogut carregar aquest enllaç."
}
}

View File

@@ -3,5 +3,6 @@
"edit-profile": "Editar perfil", "edit-profile": "Editar perfil",
"create-campaign": "Crear campanya", "create-campaign": "Crear campanya",
"log-out": "Tanca la sessió", "log-out": "Tanca la sessió",
"settings": "Configuració" "settings": "Configuració",
"exit": "Sortir"
} }

View File

@@ -5,5 +5,7 @@
"example": "Finestra d'exemple", "example": "Finestra d'exemple",
"edit-profile": "Editar perfil", "edit-profile": "Editar perfil",
"settings": "Configuració", "settings": "Configuració",
"create-campaign": "Crear campanya" "create-campaign": "Crear campanya",
"create-map": "Crear mapa",
"map-viewer": "Mapa"
} }

View File

@@ -6,5 +6,95 @@
"enter": "Enter campaign name here...", "enter": "Enter campaign name here...",
"color": "Accent color", "color": "Accent color",
"success": "Campaign created successfully!" "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.",
"saved": "Campaign settings saved.",
"saving": "Saving...",
"services": {
"help": "Every service connects the same way: it asks Dragonroll for a sign-up link, shows it to you, and you pick this campaign there. Nothing connects from here.",
"not-connected": "Not connected",
"unlink": "Unlink",
"unlinked": "{service} is no longer connected to this campaign.",
"connected-by": "connected by {user}",
"foundry": {
"name": "Foundry VTT",
"how": "Open the Dragonroll link from the module settings of your world and pick this campaign."
},
"discord": {
"name": "Discord",
"how": "Run /dragonroll connect in your server and pick this campaign."
},
"obsidian": {
"name": "Obsidian",
"how": "Press Connect to Dragonroll in the Obsidian plugin settings and pick this campaign."
}
},
"errors": {
"name-required": "Enter a campaign name.",
"invalid-foundry-url": "Enter a valid Foundry VTT URL using http or https."
}
},
"sidebar-label": "Campaign",
"synced": "Synced",
"sections": { "notes": "Notes", "actors": "Actors & Characters", "items": "Items", "maps": "Maps" },
"actions": {
"new-note": "New note", "new-folder": "New folder", "refresh": "Refresh",
"create": "Create {section}", "submit": "Create", "edit": "Edit", "save": "Save", "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.",
"empty-maps": "No maps 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", "edit": "Edit item", "foundry-sync-note": "Changes to this item are also applied in the linked Foundry world.",
"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" }
},
"map": {
"new": "New map", "edit": "Edit map",
"photo": "Map image", "upload-photo": "Upload image", "change-photo": "Change image",
"photo-hint": "A photo or scan of the map. The current image is kept when you do not pick a new one.",
"grid-size": "Grid size (px)", "offset-x": "Offset X (px)", "offset-y": "Offset Y (px)",
"scale": "Scale (distance per cell)", "scale-help": "How much distance one grid cell stands for, like 5 feet.",
"summary": "{size} px grid · {scale} per cell",
"save-error": "Unable to save this map.",
"no-image": "This map has no image yet.",
"zoom-in": "Zoom in", "zoom-out": "Zoom out", "fit": "Fit to window", "toggle-grid": "Show grid",
"open-window": "Open in window", "anchored": "Anchored"
},
"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."
} }
} }

View 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."
}
}

View File

@@ -0,0 +1,8 @@
{
"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.",
"actor-already-synced": "Another actor in this campaign is already synced with that Foundry actor.",
"item-already-synced": "Another item in this campaign is already synced with that Foundry item."
}
}

View File

@@ -6,5 +6,9 @@
"save": "Save", "save": "Save",
"cancel": "Cancel", "cancel": "Cancel",
"delete": "Delete", "delete": "Delete",
"open": "Open" "open": "Open",
"notes": {
"saved": "Note saved",
"save-error": "Unable to save the note"
}
} }

View File

@@ -0,0 +1,35 @@
{
"title": "Connect {service} to Dragonroll",
"checking": "Checking this link…",
"system": " · {system}",
"target": {
"discord": "Discord server: {target}. Requested by {user}.",
"foundry": "Foundry world: {target}{system}. Requested by {user}.",
"obsidian": "Obsidian vault: {target}.",
"other": "{target} wants to use one of your campaigns."
},
"sign-in-lead": "Sign in with the Dragonroll account that owns the campaign {service} should use.",
"signed-in-as": "Signed in as {user}.",
"pick-campaign": "Which campaign may {service} use?",
"no-campaigns": "This account has no campaigns yet. Create one in Dragonroll first.",
"already-linked": "already connected to a {service}",
"connect": "Connect this campaign",
"connected": "This campaign is now connected to {target}.",
"trust-warning": "Only connect a service you trust: it can read and change what its campaign holds.",
"replace-warning": "Connecting a campaign replaces whatever this service was connected to before.",
"next": {
"discord": "Return to Discord: the bot confirms the connection there.",
"foundry": "Return to Foundry: the module connects on its own.",
"obsidian": "Return to Obsidian: the plugin picks this up on its own.",
"other": "Return to the service you came from."
},
"errors": {
"missing-code": "This link is missing its code. Ask the service for a new one.",
"expired": "This link is invalid or has expired. Ask the service for a new one.",
"sign-in-failed": "Dragonroll sign in failed. Check your username and password.",
"session-expired": "Your Dragonroll session has expired. Sign in again to continue.",
"no-campaign": "Choose the campaign this service should use.",
"notfound": "That campaign is not one of yours. Sign in with the account that owns it.",
"internal": "Could not load this link."
}
}

View File

@@ -3,5 +3,6 @@
"edit-profile": "Edit profile", "edit-profile": "Edit profile",
"create-campaign": "Create Campaign", "create-campaign": "Create Campaign",
"log-out": "Log out", "log-out": "Log out",
"settings": "Settings" "settings": "Settings",
"exit": "Exit"
} }

View File

@@ -5,5 +5,7 @@
"example": "Example Window", "example": "Example Window",
"edit-profile": "Edit Profile", "edit-profile": "Edit Profile",
"settings": "Settings", "settings": "Settings",
"create-campaign": "Create Campaign" "create-campaign": "Create Campaign",
"create-map": "Create Map",
"map-viewer": "Map"
} }

View File

@@ -0,0 +1,94 @@
{
"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.",
"saved": "Se han guardado los ajustes de la campaña.",
"saving": "Guardando...",
"services": {
"help": "Todos los servicios se conectan igual: piden a Dragonroll un enlace de registro, te lo muestran y eliges esta campaña allí. Desde aquí no se conecta nada.",
"not-connected": "Sin conectar",
"unlink": "Desvincular",
"unlinked": "{service} ya no está conectado a esta campaña.",
"connected-by": "conectado por {user}",
"foundry": {
"name": "Foundry VTT",
"how": "Abre el enlace de Dragonroll desde los ajustes del módulo de tu mundo y elige esta campaña."
},
"discord": {
"name": "Discord",
"how": "Ejecuta /dragonroll connect en tu servidor y elige esta campaña."
},
"obsidian": {
"name": "Obsidian",
"how": "Pulsa Connect to Dragonroll en los ajustes del plugin de Obsidian y elige esta campaña."
}
},
"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."
}
},
"sidebar-label": "Campaña",
"synced": "Sincronizado",
"sections": { "notes": "Notas", "actors": "Actores y personajes", "items": "Objetos", "maps": "Mapas" },
"actions": {
"new-note": "Nueva nota", "new-folder": "Nueva carpeta", "refresh": "Actualizar",
"create": "Crear {section}", "submit": "Crear", "edit": "Editar", "save": "Guardar", "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.",
"empty-maps": "Aún no hay mapas 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", "edit": "Editar objeto", "foundry-sync-note": "Los cambios en este objeto también se aplican al mundo de Foundry vinculado.",
"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" }
},
"map": {
"new": "Nuevo mapa", "edit": "Editar mapa",
"photo": "Imagen del mapa", "upload-photo": "Subir imagen", "change-photo": "Cambiar imagen",
"photo-hint": "Una foto o un escaneo del mapa. Se mantiene la imagen actual si no eliges una nueva.",
"grid-size": "Tamaño de la cuadrícula (px)", "offset-x": "Desplazamiento X (px)", "offset-y": "Desplazamiento Y (px)",
"scale": "Escala (distancia por celda)", "scale-help": "La distancia que representa una celda de la cuadrícula, como 5 pies.",
"summary": "Cuadrícula de {size} px · {scale} por celda",
"save-error": "No se pudo guardar este mapa.",
"no-image": "Este mapa aún no tiene imagen.",
"zoom-in": "Acercar", "zoom-out": "Alejar", "fit": "Ajustar a la ventana", "toggle-grid": "Mostrar cuadrícula",
"open-window": "Abrir en una ventana", "anchored": "Anclado"
},
"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."
}
}

View 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."
}
}

View File

@@ -0,0 +1,8 @@
{
"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.",
"actor-already-synced": "Otro actor de esta campaña ya está sincronizado con ese actor de Foundry.",
"item-already-synced": "Otro objeto de esta campaña ya está sincronizado con ese objeto de Foundry."
}
}

View File

@@ -1 +1,7 @@
{} {
"save": "Guardar",
"notes": {
"saved": "Nota guardada",
"save-error": "No se ha podido guardar la nota"
}
}

View File

@@ -0,0 +1,35 @@
{
"title": "Conectar {service} con Dragonroll",
"checking": "Comprobando este enlace…",
"system": " · {system}",
"target": {
"discord": "Servidor de Discord: {target}. Solicitado por {user}.",
"foundry": "Mundo de Foundry: {target}{system}. Solicitado por {user}.",
"obsidian": "Vault de Obsidian: {target}.",
"other": "{target} quiere usar una de tus campañas."
},
"sign-in-lead": "Inicia sesión con la cuenta de Dragonroll propietaria de la campaña que debe usar {service}.",
"signed-in-as": "Has iniciado sesión como {user}.",
"pick-campaign": "¿Qué campaña puede usar {service}?",
"no-campaigns": "Esta cuenta todavía no tiene campañas. Crea una primero en Dragonroll.",
"already-linked": "ya conectado a un {service}",
"connect": "Conectar esta campaña",
"connected": "Esta campaña ya está conectada a {target}.",
"trust-warning": "Conecta solo servicios de confianza: pueden leer y modificar lo que contenga su campaña.",
"replace-warning": "Conectar una campaña reemplaza lo que este servicio tuviera conectado antes.",
"next": {
"discord": "Vuelve a Discord: el bot confirmará la conexión allí.",
"foundry": "Vuelve a Foundry: el módulo se conectará solo.",
"obsidian": "Vuelve a Obsidian: el plugin lo detectará solo.",
"other": "Vuelve al servicio desde el que has venido."
},
"errors": {
"missing-code": "A este enlace le falta el código. Pide uno nuevo al servicio.",
"expired": "Este enlace no es válido o ha caducado. Pide uno nuevo al servicio.",
"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.",
"no-campaign": "Elige la campaña que debe usar este servicio.",
"notfound": "Esa campaña no es tuya. Inicia sesión con la cuenta propietaria.",
"internal": "No se ha podido cargar este enlace."
}
}

View File

@@ -3,5 +3,6 @@
"edit-profile": "Editar perfil", "edit-profile": "Editar perfil",
"create-campaign": "Crear campanya", "create-campaign": "Crear campanya",
"log-out": "Cerrar sesión", "log-out": "Cerrar sesión",
"settings": "Configuración" "settings": "Configuración",
"exit": "Salir"
} }

Some files were not shown because too many files have changed in this diff Show More