From 2a39d594c7d4ae2baa849e66582b7db9cb909f89 Mon Sep 17 00:00:00 2001 From: xstraven <7582591+xstraven@users.noreply.github.com> Date: Wed, 18 Mar 2026 21:28:06 +0100 Subject: [PATCH] add proposal --- .gitignore | 3 + MVP_PLAN.md | 310 ++++++++++ README.md | 40 +- index.html | 12 + package-lock.json | 1473 +++++++++++++++++++++++++++++++++++++++++++++ package.json | 20 + src/app.ts | 107 ++++ src/identity.ts | 20 + src/main.ts | 11 + src/render.ts | 131 ++++ src/state.ts | 124 ++++ src/styles.css | 256 ++++++++ src/sync.ts | 64 ++ test.txt | 0 tsconfig.json | 15 + 15 files changed, 2585 insertions(+), 1 deletion(-) create mode 100644 .gitignore create mode 100644 MVP_PLAN.md create mode 100644 index.html create mode 100644 package-lock.json create mode 100644 package.json create mode 100644 src/app.ts create mode 100644 src/identity.ts create mode 100644 src/main.ts create mode 100644 src/render.ts create mode 100644 src/state.ts create mode 100644 src/styles.css create mode 100644 src/sync.ts delete mode 100644 test.txt create mode 100644 tsconfig.json diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..0ca39c0 --- /dev/null +++ b/.gitignore @@ -0,0 +1,3 @@ +node_modules +dist +.DS_Store diff --git a/MVP_PLAN.md b/MVP_PLAN.md new file mode 100644 index 0000000..ec0179d --- /dev/null +++ b/MVP_PLAN.md @@ -0,0 +1,310 @@ +# Minimal MVP Plan: P2P Poll App + +## Recommendation + +Build the MVP with: + +- Vanilla JS or TypeScript +- Vite for local dev/build +- Yjs for shared state +- `y-webrtc` for browser-to-browser sync +- `y-indexeddb` for local persistence/offline recovery + +This is the best fit for a small poll app because the data model is tiny, concurrent edits are possible, and Yjs already solves merge/conflict handling while `y-webrtc` gives a direct P2P transport with only signaling infrastructure. + +## Why This Stack + +### Recommended: Yjs + y-webrtc + +- Best balance of simplicity and correctness +- Clients connect directly over WebRTC +- No custom conflict-resolution logic needed +- Easy to add offline persistence +- Good fit for a single shared document/room + +### Not recommended for the first MVP + +#### PeerJS + +- Very simple transport layer +- But you must design and maintain your own replication and merge rules +- Fine for demos with a host-authoritative peer, weaker for true collaborative editing + +#### GUN + +- Fast to prototype realtime shared state +- But official tutorials commonly use a GUN peer/relay server for shared data +- For this app, its data model is less explicit than a CRDT and gives less control over vote semantics + +#### Automerge + +- Very capable CRDT and local-first model +- But heavier than needed for a single small poll +- Better choice if the project is expected to evolve into a richer collaborative app + +## MVP Scope + +Ship exactly one shared poll per room. + +Included: + +- Join a poll by opening a shared URL +- Add a new option +- Vote for one option +- Change your vote +- Realtime updates across peers +- Local persistence in the browser +- Basic connection status UI + +Excluded: + +- User accounts +- Multiple polls per room +- Option deletion/editing +- Authentication/authorization +- Rich presence +- Advanced discovery +- Production-grade TURN/signaling deployment + +## MVP UX + +Keep the interface intentionally small: + +- Poll title at the top +- Option list with vote counts +- One button per option to cast vote +- Small form to add an option +- Status line showing `connecting`, `connected`, or `offline` +- Small label showing which option you voted for + +Join model: + +- Room ID in the URL, e.g. `/?room=poll-demo` +- Users share the URL manually + +Identity model: + +- Generate a local `userId` once and store it in `localStorage` +- Optional local display name, also stored locally + +## Shared Data Model + +Use a single Yjs document per room. + +Suggested structure: + +- `poll` as a `Y.Map` +- `poll.title` as a string +- `poll.options` as a `Y.Map` +- `poll.votes` as a `Y.Map` + +Each option record: + +- `id` +- `label` +- `createdBy` +- `createdAt` + +Important design choice: + +Do not store vote counters as mutable shared numbers for the MVP. +Instead, derive counts from `votes`. + +Why: + +- A user changing vote becomes a single write: `votes[userId] = optionId` +- No double-counting logic +- Concurrent writes are easier to reason about +- Rendering counts from `votes` is trivial at this scale + +## Sync Model + +### Networking + +- Use `WebrtcProvider(roomId, ydoc)` +- Start with the default public signaling servers for local development +- If needed, swap to a self-hosted signaling server later without changing the app model + +### Persistence + +- Use `IndexeddbPersistence(roomId, ydoc)` +- This preserves state across reloads and helps when reconnecting after temporary disconnects + +### Conflict behavior + +- Concurrent option additions merge naturally +- Concurrent vote changes resolve at the per-user key level +- Tally is recalculated from the merged vote map + +## Suggested Project Structure + +```text +src/ + main.ts + app.ts + state.ts + sync.ts + render.ts + identity.ts + styles.css +index.html +``` + +Responsibilities: + +- `sync.ts`: create Yjs doc, WebRTC provider, IndexedDB provider +- `state.ts`: shared structures, add option, cast vote, selectors +- `identity.ts`: local `userId` and optional name +- `render.ts`: DOM updates +- `app.ts`: wire events to state and rendering + +## Implementation Plan + +### Phase 1: App shell + +- Create Vite app with vanilla TS or JS +- Add a minimal single-page UI +- Parse `room` from the URL +- Generate and persist `userId` + +Success check: + +- App loads +- Room ID appears in UI +- User can type in the form + +### Phase 2: Shared state + +- Add Yjs document +- Create root shared maps +- Seed default poll title if missing +- Observe document updates and re-render UI + +Success check: + +- State exists in one browser tab +- Refresh keeps local state when IndexedDB is enabled + +### Phase 3: P2P sync + +- Add `y-webrtc` +- Join room based on URL room ID +- Show connection status from provider events + +Success check: + +- Two browsers on different tabs/devices see the same options +- New options appear in near real time + +### Phase 4: Voting logic + +- Implement `castVote(optionId)` as `votes.set(userId, optionId)` +- Derive tallies from `votes` +- Highlight the local user’s current vote + +Success check: + +- Votes update live across peers +- Changing vote updates counts correctly + +### Phase 5: Basic hardening + +- Trim/validate option labels +- Prevent empty options +- Ignore duplicate labels case-insensitively for MVP +- Show simple offline/connecting text + +Success check: + +- Basic misuse does not break the UI +- Reconnect restores updates + +## Minimal API Surface + +These functions are enough for the first build: + +- `getRoomId(): string` +- `getUserId(): string` +- `initSync(roomId): AppSync` +- `ensurePollInitialized()` +- `addOption(label: string)` +- `castVote(optionId: string)` +- `getViewModel(): PollViewModel` +- `render(viewModel)` + +## Risks And MVP Mitigations + +### NAT / WebRTC connectivity + +Risk: + +- Some peer pairs may fail to connect in restrictive networks + +Mitigation: + +- Accept this for MVP +- Keep signaling configurable +- Add TURN only if testing shows frequent failures + +### Small public signaling dependency + +Risk: + +- Public signaling is fine for demos, not ideal for production + +Mitigation: + +- Treat it as replaceable infrastructure +- Self-host later if the prototype is kept + +### Duplicate or messy options + +Risk: + +- Users may add near-duplicate entries + +Mitigation: + +- Normalize labels +- Prevent exact duplicates for MVP + +### No trust/auth model + +Risk: + +- Any participant in the room can add options and vote + +Mitigation: + +- Accept for MVP +- Frame rooms as small trusted groups + +## Estimated MVP Size + +For one developer: + +- Initial prototype: 0.5 to 1 day +- Polished MVP with basic resilience: 1 to 2 days + +Rough code size: + +- 250 to 500 lines plus styles + +## Nice Next Steps After MVP + +- Copy-link button +- Participant list / presence +- Vote limit modes: single-choice or multi-choice +- Option editing/deletion +- QR code for room join +- Self-hosted signaling server +- PWA packaging for better offline behavior + +## Sources + +- PeerJS getting started: https://peerjs.com/client/getting-started +- Yjs collaborative editor guide: https://docs.yjs.dev/getting-started/a-collaborative-editor +- Yjs offline support: https://docs.yjs.dev/getting-started/allowing-offline-editing +- y-webrtc README: https://github.com/yjs/y-webrtc +- GUN tutorial showing shared data via a GUN peer: https://gun.eco/converse +- Automerge network sync: https://automerge.org/docs/tutorial/network-sync/ diff --git a/README.md b/README.md index 0217c70..5f0d796 100644 --- a/README.md +++ b/README.md @@ -1 +1,39 @@ -# P2P Poll App \ No newline at end of file +# P2P Poll App + +Small peer-to-peer polling app built with `Vite`, `TypeScript`, `Yjs`, `y-webrtc`, and `y-indexeddb`. + +## Features + +- single shared poll per room +- add options collaboratively +- one vote per user, changeable at any time +- peer-to-peer sync over WebRTC +- local browser persistence for refresh/reconnect recovery +- shareable room URL + +## Run locally + +```bash +npm install +npm run dev +``` + +Open the local URL in two tabs or browsers and use the same `?room=` query string to join the same poll. + +Example: + +```text +http://localhost:5173/?room=poll-demo +``` + +## Build + +```bash +npm run build +``` + +## Notes + +- The app uses public signaling through `y-webrtc` for MVP simplicity. +- Poll state is not stored on an application server. +- WebRTC connectivity can still depend on the network environment of the participating peers. diff --git a/index.html b/index.html new file mode 100644 index 0000000..70e1dc0 --- /dev/null +++ b/index.html @@ -0,0 +1,12 @@ + + + + + + P2P Poll + + +
+ + + diff --git a/package-lock.json b/package-lock.json new file mode 100644 index 0000000..4c28696 --- /dev/null +++ b/package-lock.json @@ -0,0 +1,1473 @@ +{ + "name": "p2p-poll-app", + "version": "0.1.0", + "lockfileVersion": 3, + "requires": true, + "packages": { + "": { + "name": "p2p-poll-app", + "version": "0.1.0", + "dependencies": { + "y-indexeddb": "^9.0.12", + "y-webrtc": "^10.3.0", + "yjs": "^13.6.27" + }, + "devDependencies": { + "typescript": "^5.9.2", + "vite": "^7.1.5" + } + }, + "node_modules/@esbuild/aix-ppc64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/aix-ppc64/-/aix-ppc64-0.27.4.tgz", + "integrity": "sha512-cQPwL2mp2nSmHHJlCyoXgHGhbEPMrEEU5xhkcy3Hs/O7nGZqEpZ2sUtLaL9MORLtDfRvVl2/3PAuEkYZH0Ty8Q==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "aix" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm/-/android-arm-0.27.4.tgz", + "integrity": "sha512-X9bUgvxiC8CHAGKYufLIHGXPJWnr0OCdR0anD2e21vdvgCI8lIfqFbnoeOz7lBjdrAGUhqLZLcQo6MLhTO2DKQ==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/android-arm64/-/android-arm64-0.27.4.tgz", + "integrity": "sha512-gdLscB7v75wRfu7QSm/zg6Rx29VLdy9eTr2t44sfTW7CxwAtQghZ4ZnqHk3/ogz7xao0QAgrkradbBzcqFPasw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/android-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/android-x64/-/android-x64-0.27.4.tgz", + "integrity": "sha512-PzPFnBNVF292sfpfhiyiXCGSn9HZg5BcAz+ivBuSsl6Rk4ga1oEXAamhOXRFyMcjwr2DVtm40G65N3GLeH1Lvw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-arm64/-/darwin-arm64-0.27.4.tgz", + "integrity": "sha512-b7xaGIwdJlht8ZFCvMkpDN6uiSmnxxK56N2GDTMYPr2/gzvfdQN8rTfBsvVKmIVY/X7EM+/hJKEIbbHs9oA4tQ==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/darwin-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/darwin-x64/-/darwin-x64-0.27.4.tgz", + "integrity": "sha512-sR+OiKLwd15nmCdqpXMnuJ9W2kpy0KigzqScqHI3Hqwr7IXxBp3Yva+yJwoqh7rE8V77tdoheRYataNKL4QrPw==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-arm64/-/freebsd-arm64-0.27.4.tgz", + "integrity": "sha512-jnfpKe+p79tCnm4GVav68A7tUFeKQwQyLgESwEAUzyxk/TJr4QdGog9sqWNcUbr/bZt/O/HXouspuQDd9JxFSw==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/freebsd-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/freebsd-x64/-/freebsd-x64-0.27.4.tgz", + "integrity": "sha512-2kb4ceA/CpfUrIcTUl1wrP/9ad9Atrp5J94Lq69w7UwOMolPIGrfLSvAKJp0RTvkPPyn6CIWrNy13kyLikZRZQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm/-/linux-arm-0.27.4.tgz", + "integrity": "sha512-aBYgcIxX/wd5n2ys0yESGeYMGF+pv6g0DhZr3G1ZG4jMfruU9Tl1i2Z+Wnj9/KjGz1lTLCcorqE2viePZqj4Eg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-arm64/-/linux-arm64-0.27.4.tgz", + "integrity": "sha512-7nQOttdzVGth1iz57kxg9uCz57dxQLHWxopL6mYuYthohPKEK0vU0C3O21CcBK6KDlkYVcnDXY099HcCDXd9dA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ia32": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ia32/-/linux-ia32-0.27.4.tgz", + "integrity": "sha512-oPtixtAIzgvzYcKBQM/qZ3R+9TEUd1aNJQu0HhGyqtx6oS7qTpvjheIWBbes4+qu1bNlo2V4cbkISr8q6gRBFA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-loong64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-loong64/-/linux-loong64-0.27.4.tgz", + "integrity": "sha512-8mL/vh8qeCoRcFH2nM8wm5uJP+ZcVYGGayMavi8GmRJjuI3g1v6Z7Ni0JJKAJW+m0EtUuARb6Lmp4hMjzCBWzA==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-mips64el": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-mips64el/-/linux-mips64el-0.27.4.tgz", + "integrity": "sha512-1RdrWFFiiLIW7LQq9Q2NES+HiD4NyT8Itj9AUeCl0IVCA459WnPhREKgwrpaIfTOe+/2rdntisegiPWn/r/aAw==", + "cpu": [ + "mips64el" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-ppc64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-ppc64/-/linux-ppc64-0.27.4.tgz", + "integrity": "sha512-tLCwNG47l3sd9lpfyx9LAGEGItCUeRCWeAx6x2Jmbav65nAwoPXfewtAdtbtit/pJFLUWOhpv0FpS6GQAmPrHA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-riscv64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-riscv64/-/linux-riscv64-0.27.4.tgz", + "integrity": "sha512-BnASypppbUWyqjd1KIpU4AUBiIhVr6YlHx/cnPgqEkNoVOhHg+YiSVxM1RLfiy4t9cAulbRGTNCKOcqHrEQLIw==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-s390x": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-s390x/-/linux-s390x-0.27.4.tgz", + "integrity": "sha512-+eUqgb/Z7vxVLezG8bVB9SfBie89gMueS+I0xYh2tJdw3vqA/0ImZJ2ROeWwVJN59ihBeZ7Tu92dF/5dy5FttA==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/linux-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/linux-x64/-/linux-x64-0.27.4.tgz", + "integrity": "sha512-S5qOXrKV8BQEzJPVxAwnryi2+Iq5pB40gTEIT69BQONqR7JH1EPIcQ/Uiv9mCnn05jff9umq/5nqzxlqTOg9NA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-arm64/-/netbsd-arm64-0.27.4.tgz", + "integrity": "sha512-xHT8X4sb0GS8qTqiwzHqpY00C95DPAq7nAwX35Ie/s+LO9830hrMd3oX0ZMKLvy7vsonee73x0lmcdOVXFzd6Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/netbsd-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/netbsd-x64/-/netbsd-x64-0.27.4.tgz", + "integrity": "sha512-RugOvOdXfdyi5Tyv40kgQnI0byv66BFgAqjdgtAKqHoZTbTF2QqfQrFwa7cHEORJf6X2ht+l9ABLMP0dnKYsgg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "netbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-arm64/-/openbsd-arm64-0.27.4.tgz", + "integrity": "sha512-2MyL3IAaTX+1/qP0O1SwskwcwCoOI4kV2IBX1xYnDDqthmq5ArrW94qSIKCAuRraMgPOmG0RDTA74mzYNQA9ow==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openbsd-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/openbsd-x64/-/openbsd-x64-0.27.4.tgz", + "integrity": "sha512-u8fg/jQ5aQDfsnIV6+KwLOf1CmJnfu1ShpwqdwC0uA7ZPwFws55Ngc12vBdeUdnuWoQYx/SOQLGDcdlfXhYmXQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/openharmony-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/openharmony-arm64/-/openharmony-arm64-0.27.4.tgz", + "integrity": "sha512-JkTZrl6VbyO8lDQO3yv26nNr2RM2yZzNrNHEsj9bm6dOwwu9OYN28CjzZkH57bh4w0I2F7IodpQvUAEd1mbWXg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/sunos-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/sunos-x64/-/sunos-x64-0.27.4.tgz", + "integrity": "sha512-/gOzgaewZJfeJTlsWhvUEmUG4tWEY2Spp5M20INYRg2ZKl9QPO3QEEgPeRtLjEWSW8FilRNacPOg8R1uaYkA6g==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "sunos" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-arm64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/win32-arm64/-/win32-arm64-0.27.4.tgz", + "integrity": "sha512-Z9SExBg2y32smoDQdf1HRwHRt6vAHLXcxD2uGgO/v2jK7Y718Ix4ndsbNMU/+1Qiem9OiOdaqitioZwxivhXYg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-ia32": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/win32-ia32/-/win32-ia32-0.27.4.tgz", + "integrity": "sha512-DAyGLS0Jz5G5iixEbMHi5KdiApqHBWMGzTtMiJ72ZOLhbu/bzxgAe8Ue8CTS3n3HbIUHQz/L51yMdGMeoxXNJw==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@esbuild/win32-x64": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/@esbuild/win32-x64/-/win32-x64-0.27.4.tgz", + "integrity": "sha512-+knoa0BDoeXgkNvvV1vvbZX4+hizelrkwmGJBdT17t8FNPwG2lKemmuMZlmaNQ3ws3DKKCxpb4zRZEIp3UxFCg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ], + "engines": { + "node": ">=18" + } + }, + "node_modules/@rollup/rollup-android-arm-eabi": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm-eabi/-/rollup-android-arm-eabi-4.59.0.tgz", + "integrity": "sha512-upnNBkA6ZH2VKGcBj9Fyl9IGNPULcjXRlg0LLeaioQWueH30p6IXtJEbKAgvyv+mJaMxSm1l6xwDXYjpEMiLMg==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-android-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-android-arm64/-/rollup-android-arm64-4.59.0.tgz", + "integrity": "sha512-hZ+Zxj3SySm4A/DylsDKZAeVg0mvi++0PYVceVyX7hemkw7OreKdCvW2oQ3T1FMZvCaQXqOTHb8qmBShoqk69Q==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "android" + ] + }, + "node_modules/@rollup/rollup-darwin-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-arm64/-/rollup-darwin-arm64-4.59.0.tgz", + "integrity": "sha512-W2Psnbh1J8ZJw0xKAd8zdNgF9HRLkdWwwdWqubSVk0pUuQkoHnv7rx4GiF9rT4t5DIZGAsConRE3AxCdJ4m8rg==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-darwin-x64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-darwin-x64/-/rollup-darwin-x64-4.59.0.tgz", + "integrity": "sha512-ZW2KkwlS4lwTv7ZVsYDiARfFCnSGhzYPdiOU4IM2fDbL+QGlyAbjgSFuqNRbSthybLbIJ915UtZBtmuLrQAT/w==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ] + }, + "node_modules/@rollup/rollup-freebsd-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-arm64/-/rollup-freebsd-arm64-4.59.0.tgz", + "integrity": "sha512-EsKaJ5ytAu9jI3lonzn3BgG8iRBjV4LxZexygcQbpiU0wU0ATxhNVEpXKfUa0pS05gTcSDMKpn3Sx+QB9RlTTA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-freebsd-x64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-freebsd-x64/-/rollup-freebsd-x64-4.59.0.tgz", + "integrity": "sha512-d3DuZi2KzTMjImrxoHIAODUZYoUUMsuUiY4SRRcJy6NJoZ6iIqWnJu9IScV9jXysyGMVuW+KNzZvBLOcpdl3Vg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "freebsd" + ] + }, + "node_modules/@rollup/rollup-linux-arm-gnueabihf": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-gnueabihf/-/rollup-linux-arm-gnueabihf-4.59.0.tgz", + "integrity": "sha512-t4ONHboXi/3E0rT6OZl1pKbl2Vgxf9vJfWgmUoCEVQVxhW6Cw/c8I6hbbu7DAvgp82RKiH7TpLwxnJeKv2pbsw==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm-musleabihf": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm-musleabihf/-/rollup-linux-arm-musleabihf-4.59.0.tgz", + "integrity": "sha512-CikFT7aYPA2ufMD086cVORBYGHffBo4K8MQ4uPS/ZnY54GKj36i196u8U+aDVT2LX4eSMbyHtyOh7D7Zvk2VvA==", + "cpu": [ + "arm" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-gnu/-/rollup-linux-arm64-gnu-4.59.0.tgz", + "integrity": "sha512-jYgUGk5aLd1nUb1CtQ8E+t5JhLc9x5WdBKew9ZgAXg7DBk0ZHErLHdXM24rfX+bKrFe+Xp5YuJo54I5HFjGDAA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-arm64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-arm64-musl/-/rollup-linux-arm64-musl-4.59.0.tgz", + "integrity": "sha512-peZRVEdnFWZ5Bh2KeumKG9ty7aCXzzEsHShOZEFiCQlDEepP1dpUl/SrUNXNg13UmZl+gzVDPsiCwnV1uI0RUA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-gnu/-/rollup-linux-loong64-gnu-4.59.0.tgz", + "integrity": "sha512-gbUSW/97f7+r4gHy3Jlup8zDG190AuodsWnNiXErp9mT90iCy9NKKU0Xwx5k8VlRAIV2uU9CsMnEFg/xXaOfXg==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-loong64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-loong64-musl/-/rollup-linux-loong64-musl-4.59.0.tgz", + "integrity": "sha512-yTRONe79E+o0FWFijasoTjtzG9EBedFXJMl888NBEDCDV9I2wGbFFfJQQe63OijbFCUZqxpHz1GzpbtSFikJ4Q==", + "cpu": [ + "loong64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-gnu/-/rollup-linux-ppc64-gnu-4.59.0.tgz", + "integrity": "sha512-sw1o3tfyk12k3OEpRddF68a1unZ5VCN7zoTNtSn2KndUE+ea3m3ROOKRCZxEpmT9nsGnogpFP9x6mnLTCaoLkA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-ppc64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-ppc64-musl/-/rollup-linux-ppc64-musl-4.59.0.tgz", + "integrity": "sha512-+2kLtQ4xT3AiIxkzFVFXfsmlZiG5FXYW7ZyIIvGA7Bdeuh9Z0aN4hVyXS/G1E9bTP/vqszNIN/pUKCk/BTHsKA==", + "cpu": [ + "ppc64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-gnu/-/rollup-linux-riscv64-gnu-4.59.0.tgz", + "integrity": "sha512-NDYMpsXYJJaj+I7UdwIuHHNxXZ/b/N2hR15NyH3m2qAtb/hHPA4g4SuuvrdxetTdndfj9b1WOmy73kcPRoERUg==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-riscv64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-riscv64-musl/-/rollup-linux-riscv64-musl-4.59.0.tgz", + "integrity": "sha512-nLckB8WOqHIf1bhymk+oHxvM9D3tyPndZH8i8+35p/1YiVoVswPid2yLzgX7ZJP0KQvnkhM4H6QZ5m0LzbyIAg==", + "cpu": [ + "riscv64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-s390x-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-s390x-gnu/-/rollup-linux-s390x-gnu-4.59.0.tgz", + "integrity": "sha512-oF87Ie3uAIvORFBpwnCvUzdeYUqi2wY6jRFWJAy1qus/udHFYIkplYRW+wo+GRUP4sKzYdmE1Y3+rY5Gc4ZO+w==", + "cpu": [ + "s390x" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-gnu/-/rollup-linux-x64-gnu-4.59.0.tgz", + "integrity": "sha512-3AHmtQq/ppNuUspKAlvA8HtLybkDflkMuLK4DPo77DfthRb71V84/c4MlWJXixZz4uruIH4uaa07IqoAkG64fg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-linux-x64-musl": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-linux-x64-musl/-/rollup-linux-x64-musl-4.59.0.tgz", + "integrity": "sha512-2UdiwS/9cTAx7qIUZB/fWtToJwvt0Vbo0zmnYt7ED35KPg13Q0ym1g442THLC7VyI6JfYTP4PiSOWyoMdV2/xg==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "linux" + ] + }, + "node_modules/@rollup/rollup-openbsd-x64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openbsd-x64/-/rollup-openbsd-x64-4.59.0.tgz", + "integrity": "sha512-M3bLRAVk6GOwFlPTIxVBSYKUaqfLrn8l0psKinkCFxl4lQvOSz8ZrKDz2gxcBwHFpci0B6rttydI4IpS4IS/jQ==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openbsd" + ] + }, + "node_modules/@rollup/rollup-openharmony-arm64": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-openharmony-arm64/-/rollup-openharmony-arm64-4.59.0.tgz", + "integrity": "sha512-tt9KBJqaqp5i5HUZzoafHZX8b5Q2Fe7UjYERADll83O4fGqJ49O1FsL6LpdzVFQcpwvnyd0i+K/VSwu/o/nWlA==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "openharmony" + ] + }, + "node_modules/@rollup/rollup-win32-arm64-msvc": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-arm64-msvc/-/rollup-win32-arm64-msvc-4.59.0.tgz", + "integrity": "sha512-V5B6mG7OrGTwnxaNUzZTDTjDS7F75PO1ae6MJYdiMu60sq0CqN5CVeVsbhPxalupvTX8gXVSU9gq+Rx1/hvu6A==", + "cpu": [ + "arm64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-ia32-msvc": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-ia32-msvc/-/rollup-win32-ia32-msvc-4.59.0.tgz", + "integrity": "sha512-UKFMHPuM9R0iBegwzKF4y0C4J9u8C6MEJgFuXTBerMk7EJ92GFVFYBfOZaSGLu6COf7FxpQNqhNS4c4icUPqxA==", + "cpu": [ + "ia32" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-gnu": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-gnu/-/rollup-win32-x64-gnu-4.59.0.tgz", + "integrity": "sha512-laBkYlSS1n2L8fSo1thDNGrCTQMmxjYY5G0WFWjFFYZkKPjsMBsgJfGf4TLxXrF6RyhI60L8TMOjBMvXiTcxeA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@rollup/rollup-win32-x64-msvc": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/@rollup/rollup-win32-x64-msvc/-/rollup-win32-x64-msvc-4.59.0.tgz", + "integrity": "sha512-2HRCml6OztYXyJXAvdDXPKcawukWY2GpR5/nxKp4iBgiO3wcoEGkAaqctIbZcNB6KlUQBIqt8VYkNSj2397EfA==", + "cpu": [ + "x64" + ], + "dev": true, + "license": "MIT", + "optional": true, + "os": [ + "win32" + ] + }, + "node_modules/@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "dev": true, + "license": "MIT" + }, + "node_modules/base64-js": { + "version": "1.5.1", + "resolved": "https://registry.npmjs.org/base64-js/-/base64-js-1.5.1.tgz", + "integrity": "sha512-AKpaYlHn8t4SVbOHCy+b5+KKgvR4vrsD8vbvrbiQJps7fKDTkjkDry6ji0rUJjC0kzbNePLwzxq8iypo41qeWA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/buffer": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/buffer/-/buffer-6.0.3.tgz", + "integrity": "sha512-FTiCpNxtwiZZHEZbcbTIcZjERVICn9yq/pDFkTl95/AxzD1naBctN7YO68riM/gLSDY7sdrMby8hofADYuuqOA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "base64-js": "^1.3.1", + "ieee754": "^1.2.1" + } + }, + "node_modules/debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", + "dependencies": { + "ms": "^2.1.3" + }, + "engines": { + "node": ">=6.0" + }, + "peerDependenciesMeta": { + "supports-color": { + "optional": true + } + } + }, + "node_modules/err-code": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/err-code/-/err-code-3.0.1.tgz", + "integrity": "sha512-GiaH0KJUewYok+eeY05IIgjtAe4Yltygk9Wqp1V5yVWLdhf0hYZchRjNIT9bb0mSwRcIusT3cx7PJUf3zEIfUA==", + "license": "MIT" + }, + "node_modules/esbuild": { + "version": "0.27.4", + "resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.27.4.tgz", + "integrity": "sha512-Rq4vbHnYkK5fws5NF7MYTU68FPRE1ajX7heQ/8QXXWqNgqqJ/GkmmyxIzUnf2Sr/bakf8l54716CcMGHYhMrrQ==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "bin": { + "esbuild": "bin/esbuild" + }, + "engines": { + "node": ">=18" + }, + "optionalDependencies": { + "@esbuild/aix-ppc64": "0.27.4", + "@esbuild/android-arm": "0.27.4", + "@esbuild/android-arm64": "0.27.4", + "@esbuild/android-x64": "0.27.4", + "@esbuild/darwin-arm64": "0.27.4", + "@esbuild/darwin-x64": "0.27.4", + "@esbuild/freebsd-arm64": "0.27.4", + "@esbuild/freebsd-x64": "0.27.4", + "@esbuild/linux-arm": "0.27.4", + "@esbuild/linux-arm64": "0.27.4", + "@esbuild/linux-ia32": "0.27.4", + "@esbuild/linux-loong64": "0.27.4", + "@esbuild/linux-mips64el": "0.27.4", + "@esbuild/linux-ppc64": "0.27.4", + "@esbuild/linux-riscv64": "0.27.4", + "@esbuild/linux-s390x": "0.27.4", + "@esbuild/linux-x64": "0.27.4", + "@esbuild/netbsd-arm64": "0.27.4", + "@esbuild/netbsd-x64": "0.27.4", + "@esbuild/openbsd-arm64": "0.27.4", + "@esbuild/openbsd-x64": "0.27.4", + "@esbuild/openharmony-arm64": "0.27.4", + "@esbuild/sunos-x64": "0.27.4", + "@esbuild/win32-arm64": "0.27.4", + "@esbuild/win32-ia32": "0.27.4", + "@esbuild/win32-x64": "0.27.4" + } + }, + "node_modules/fdir": { + "version": "6.5.0", + "resolved": "https://registry.npmjs.org/fdir/-/fdir-6.5.0.tgz", + "integrity": "sha512-tIbYtZbucOs0BRGqPJkshJUYdL+SDH7dVM8gjy+ERp3WAUjLEFJE+02kanyHtwjWOnwrKYBiwAmM0p4kLJAnXg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12.0.0" + }, + "peerDependencies": { + "picomatch": "^3 || ^4" + }, + "peerDependenciesMeta": { + "picomatch": { + "optional": true + } + } + }, + "node_modules/fsevents": { + "version": "2.3.3", + "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", + "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", + "dev": true, + "hasInstallScript": true, + "license": "MIT", + "optional": true, + "os": [ + "darwin" + ], + "engines": { + "node": "^8.16.0 || ^10.6.0 || >=11.0.0" + } + }, + "node_modules/get-browser-rtc": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/get-browser-rtc/-/get-browser-rtc-1.1.0.tgz", + "integrity": "sha512-MghbMJ61EJrRsDe7w1Bvqt3ZsBuqhce5nrn/XAwgwOXhcsz53/ltdxOse1h/8eKXj5slzxdsz56g5rzOFSGwfQ==", + "license": "MIT" + }, + "node_modules/ieee754": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/ieee754/-/ieee754-1.2.1.tgz", + "integrity": "sha512-dcyqhDvX1C46lXZcVqCpK+FtMRQVdIMN6/Df5js2zouUsqG7I6sFxitIC+7KYK29KdXOLHdu9zL4sFnoVQnqaA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "BSD-3-Clause" + }, + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" + }, + "node_modules/isomorphic.js": { + "version": "0.2.5", + "resolved": "https://registry.npmjs.org/isomorphic.js/-/isomorphic.js-0.2.5.tgz", + "integrity": "sha512-PIeMbHqMt4DnUP3MA/Flc0HElYjMXArsw1qwJZcm9sqR8mq3l8NYizFMty0pWwE/tzIGH3EKK5+jes5mAr85yw==", + "license": "MIT", + "funding": { + "type": "GitHub Sponsors ❤", + "url": "https://github.com/sponsors/dmonad" + } + }, + "node_modules/lib0": { + "version": "0.2.117", + "resolved": "https://registry.npmjs.org/lib0/-/lib0-0.2.117.tgz", + "integrity": "sha512-DeXj9X5xDCjgKLU/7RR+/HQEVzuuEUiwldwOGsHK/sfAfELGWEyTcf0x+uOvCvK3O2zPmZePXWL85vtia6GyZw==", + "license": "MIT", + "dependencies": { + "isomorphic.js": "^0.2.4" + }, + "bin": { + "0ecdsa-generate-keypair": "bin/0ecdsa-generate-keypair.js", + "0gentesthtml": "bin/gentesthtml.js", + "0serve": "bin/0serve.js" + }, + "engines": { + "node": ">=16" + }, + "funding": { + "type": "GitHub Sponsors ❤", + "url": "https://github.com/sponsors/dmonad" + } + }, + "node_modules/ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" + }, + "node_modules/nanoid": { + "version": "3.3.11", + "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", + "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "bin": { + "nanoid": "bin/nanoid.cjs" + }, + "engines": { + "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" + } + }, + "node_modules/picocolors": { + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", + "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==", + "dev": true, + "license": "ISC" + }, + "node_modules/picomatch": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.3.tgz", + "integrity": "sha512-5gTmgEY/sqK6gFXLIsQNH19lWb4ebPDLA4SdLP7dsWkIXHWlG66oPuVvXSGFPppYZz8ZDZq0dYYrbHfBCVUb1Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/postcss": { + "version": "8.5.8", + "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.5.8.tgz", + "integrity": "sha512-OW/rX8O/jXnm82Ey1k44pObPtdblfiuWnrd8X7GJ7emImCOstunGbXUpp7HdBrFQX6rJzn3sPT397Wp5aCwCHg==", + "dev": true, + "funding": [ + { + "type": "opencollective", + "url": "https://opencollective.com/postcss/" + }, + { + "type": "tidelift", + "url": "https://tidelift.com/funding/github/npm/postcss" + }, + { + "type": "github", + "url": "https://github.com/sponsors/ai" + } + ], + "license": "MIT", + "dependencies": { + "nanoid": "^3.3.11", + "picocolors": "^1.1.1", + "source-map-js": "^1.2.1" + }, + "engines": { + "node": "^10 || ^12 || >=14" + } + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/randombytes": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz", + "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==", + "license": "MIT", + "dependencies": { + "safe-buffer": "^5.1.0" + } + }, + "node_modules/readable-stream": { + "version": "3.6.2", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", + "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", + "license": "MIT", + "dependencies": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/rollup": { + "version": "4.59.0", + "resolved": "https://registry.npmjs.org/rollup/-/rollup-4.59.0.tgz", + "integrity": "sha512-2oMpl67a3zCH9H79LeMcbDhXW/UmWG/y2zuqnF2jQq5uq9TbM9TVyXvA4+t+ne2IIkBdrLpAaRQAvo7YI/Yyeg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@types/estree": "1.0.8" + }, + "bin": { + "rollup": "dist/bin/rollup" + }, + "engines": { + "node": ">=18.0.0", + "npm": ">=8.0.0" + }, + "optionalDependencies": { + "@rollup/rollup-android-arm-eabi": "4.59.0", + "@rollup/rollup-android-arm64": "4.59.0", + "@rollup/rollup-darwin-arm64": "4.59.0", + "@rollup/rollup-darwin-x64": "4.59.0", + "@rollup/rollup-freebsd-arm64": "4.59.0", + "@rollup/rollup-freebsd-x64": "4.59.0", + "@rollup/rollup-linux-arm-gnueabihf": "4.59.0", + "@rollup/rollup-linux-arm-musleabihf": "4.59.0", + "@rollup/rollup-linux-arm64-gnu": "4.59.0", + "@rollup/rollup-linux-arm64-musl": "4.59.0", + "@rollup/rollup-linux-loong64-gnu": "4.59.0", + "@rollup/rollup-linux-loong64-musl": "4.59.0", + "@rollup/rollup-linux-ppc64-gnu": "4.59.0", + "@rollup/rollup-linux-ppc64-musl": "4.59.0", + "@rollup/rollup-linux-riscv64-gnu": "4.59.0", + "@rollup/rollup-linux-riscv64-musl": "4.59.0", + "@rollup/rollup-linux-s390x-gnu": "4.59.0", + "@rollup/rollup-linux-x64-gnu": "4.59.0", + "@rollup/rollup-linux-x64-musl": "4.59.0", + "@rollup/rollup-openbsd-x64": "4.59.0", + "@rollup/rollup-openharmony-arm64": "4.59.0", + "@rollup/rollup-win32-arm64-msvc": "4.59.0", + "@rollup/rollup-win32-ia32-msvc": "4.59.0", + "@rollup/rollup-win32-x64-gnu": "4.59.0", + "@rollup/rollup-win32-x64-msvc": "4.59.0", + "fsevents": "~2.3.2" + } + }, + "node_modules/safe-buffer": { + "version": "5.2.1", + "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", + "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, + "node_modules/simple-peer": { + "version": "9.11.1", + "resolved": "https://registry.npmjs.org/simple-peer/-/simple-peer-9.11.1.tgz", + "integrity": "sha512-D1SaWpOW8afq1CZGWB8xTfrT3FekjQmPValrqncJMX7QFl8YwhrPTZvMCANLtgBwwdS+7zURyqxDDEmY558tTw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "buffer": "^6.0.3", + "debug": "^4.3.2", + "err-code": "^3.0.1", + "get-browser-rtc": "^1.1.0", + "queue-microtask": "^1.2.3", + "randombytes": "^2.1.0", + "readable-stream": "^3.6.0" + } + }, + "node_modules/source-map-js": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", + "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", + "dev": true, + "license": "BSD-3-Clause", + "engines": { + "node": ">=0.10.0" + } + }, + "node_modules/string_decoder": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", + "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", + "license": "MIT", + "dependencies": { + "safe-buffer": "~5.2.0" + } + }, + "node_modules/tinyglobby": { + "version": "0.2.15", + "resolved": "https://registry.npmjs.org/tinyglobby/-/tinyglobby-0.2.15.tgz", + "integrity": "sha512-j2Zq4NyQYG5XMST4cbs02Ak8iJUdxRM0XI5QyxXuZOzKOINmWurp3smXu3y5wDcJrptwpSjgXHzIQxR0omXljQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "fdir": "^6.5.0", + "picomatch": "^4.0.3" + }, + "engines": { + "node": ">=12.0.0" + }, + "funding": { + "url": "https://github.com/sponsors/SuperchupuDev" + } + }, + "node_modules/typescript": { + "version": "5.9.3", + "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz", + "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==", + "dev": true, + "license": "Apache-2.0", + "bin": { + "tsc": "bin/tsc", + "tsserver": "bin/tsserver" + }, + "engines": { + "node": ">=14.17" + } + }, + "node_modules/util-deprecate": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT" + }, + "node_modules/vite": { + "version": "7.3.1", + "resolved": "https://registry.npmjs.org/vite/-/vite-7.3.1.tgz", + "integrity": "sha512-w+N7Hifpc3gRjZ63vYBXA56dvvRlNWRczTdmCBBa+CotUzAPf5b7YMdMR/8CQoeYE5LX3W4wj6RYTgonm1b9DA==", + "dev": true, + "license": "MIT", + "dependencies": { + "esbuild": "^0.27.0", + "fdir": "^6.5.0", + "picomatch": "^4.0.3", + "postcss": "^8.5.6", + "rollup": "^4.43.0", + "tinyglobby": "^0.2.15" + }, + "bin": { + "vite": "bin/vite.js" + }, + "engines": { + "node": "^20.19.0 || >=22.12.0" + }, + "funding": { + "url": "https://github.com/vitejs/vite?sponsor=1" + }, + "optionalDependencies": { + "fsevents": "~2.3.3" + }, + "peerDependencies": { + "@types/node": "^20.19.0 || >=22.12.0", + "jiti": ">=1.21.0", + "less": "^4.0.0", + "lightningcss": "^1.21.0", + "sass": "^1.70.0", + "sass-embedded": "^1.70.0", + "stylus": ">=0.54.8", + "sugarss": "^5.0.0", + "terser": "^5.16.0", + "tsx": "^4.8.1", + "yaml": "^2.4.2" + }, + "peerDependenciesMeta": { + "@types/node": { + "optional": true + }, + "jiti": { + "optional": true + }, + "less": { + "optional": true + }, + "lightningcss": { + "optional": true + }, + "sass": { + "optional": true + }, + "sass-embedded": { + "optional": true + }, + "stylus": { + "optional": true + }, + "sugarss": { + "optional": true + }, + "terser": { + "optional": true + }, + "tsx": { + "optional": true + }, + "yaml": { + "optional": true + } + } + }, + "node_modules/ws": { + "version": "8.19.0", + "resolved": "https://registry.npmjs.org/ws/-/ws-8.19.0.tgz", + "integrity": "sha512-blAT2mjOEIi0ZzruJfIhb3nps74PRWTCz1IjglWEEpQl5XS/UNama6u2/rjFkDDouqr4L67ry+1aGIALViWjDg==", + "license": "MIT", + "optional": true, + "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 + } + } + }, + "node_modules/y-indexeddb": { + "version": "9.0.12", + "resolved": "https://registry.npmjs.org/y-indexeddb/-/y-indexeddb-9.0.12.tgz", + "integrity": "sha512-9oCFRSPPzBK7/w5vOkJBaVCQZKHXB/v6SIT+WYhnJxlEC61juqG0hBrAf+y3gmSMLFLwICNH9nQ53uscuse6Hg==", + "license": "MIT", + "dependencies": { + "lib0": "^0.2.74" + }, + "engines": { + "node": ">=16.0.0", + "npm": ">=8.0.0" + }, + "funding": { + "type": "GitHub Sponsors ❤", + "url": "https://github.com/sponsors/dmonad" + }, + "peerDependencies": { + "yjs": "^13.0.0" + } + }, + "node_modules/y-protocols": { + "version": "1.0.7", + "resolved": "https://registry.npmjs.org/y-protocols/-/y-protocols-1.0.7.tgz", + "integrity": "sha512-YSVsLoXxO67J6eE/nV4AtFtT3QEotZf5sK5BHxFBXso7VDUT3Tx07IfA6hsu5Q5OmBdMkQVmFZ9QOA7fikWvnw==", + "license": "MIT", + "dependencies": { + "lib0": "^0.2.85" + }, + "engines": { + "node": ">=16.0.0", + "npm": ">=8.0.0" + }, + "funding": { + "type": "GitHub Sponsors ❤", + "url": "https://github.com/sponsors/dmonad" + }, + "peerDependencies": { + "yjs": "^13.0.0" + } + }, + "node_modules/y-webrtc": { + "version": "10.3.0", + "resolved": "https://registry.npmjs.org/y-webrtc/-/y-webrtc-10.3.0.tgz", + "integrity": "sha512-KalJr7dCgUgyVFxoG3CQYbpS0O2qybegD0vI4bYnYHI0MOwoVbucED3RZ5f2o1a5HZb1qEssUKS0H/Upc6p1lA==", + "license": "MIT", + "dependencies": { + "lib0": "^0.2.42", + "simple-peer": "^9.11.0", + "y-protocols": "^1.0.6" + }, + "bin": { + "y-webrtc-signaling": "bin/server.js" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "type": "GitHub Sponsors ❤", + "url": "https://github.com/sponsors/dmonad" + }, + "optionalDependencies": { + "ws": "^8.14.2" + }, + "peerDependencies": { + "yjs": "^13.6.8" + } + }, + "node_modules/yjs": { + "version": "13.6.30", + "resolved": "https://registry.npmjs.org/yjs/-/yjs-13.6.30.tgz", + "integrity": "sha512-vv/9h42eCMC81ZHDFswuu/MKzkl/vyq1BhaNGfHyOonwlG4CJbQF4oiBBJPvfdeCt/PlVDWh7Nov9D34YY09uQ==", + "license": "MIT", + "dependencies": { + "lib0": "^0.2.99" + }, + "engines": { + "node": ">=16.0.0", + "npm": ">=8.0.0" + }, + "funding": { + "type": "GitHub Sponsors ❤", + "url": "https://github.com/sponsors/dmonad" + } + } + } +} diff --git a/package.json b/package.json new file mode 100644 index 0000000..cd7bf90 --- /dev/null +++ b/package.json @@ -0,0 +1,20 @@ +{ + "name": "p2p-poll-app", + "version": "0.1.0", + "private": true, + "type": "module", + "scripts": { + "dev": "vite", + "build": "tsc --noEmit && vite build", + "preview": "vite preview" + }, + "dependencies": { + "y-indexeddb": "^9.0.12", + "y-webrtc": "^10.3.0", + "yjs": "^13.6.27" + }, + "devDependencies": { + "typescript": "^5.9.2", + "vite": "^7.1.5" + } +} diff --git a/src/app.ts b/src/app.ts new file mode 100644 index 0000000..0ff4e98 --- /dev/null +++ b/src/app.ts @@ -0,0 +1,107 @@ +import { getUserId } from "./identity"; +import { renderApp } from "./render"; +import { addOption, castVote, createViewModel } from "./state"; +import { initSync } from "./sync"; + +const ROOM_PARAM = "room"; + +function createRoomId() { + const seed = typeof crypto.randomUUID === "function" + ? crypto.randomUUID().slice(0, 8) + : Math.random().toString(36).slice(2, 10); + + return `poll-${seed}`; +} + +function ensureRoomId() { + const url = new URL(window.location.href); + let roomId = url.searchParams.get(ROOM_PARAM)?.trim(); + + if (!roomId) { + roomId = createRoomId(); + url.searchParams.set(ROOM_PARAM, roomId); + window.history.replaceState({}, "", url); + } + + return roomId; +} + +export function initApp(container: HTMLElement) { + const roomId = ensureRoomId(); + const userId = getUserId(); + const sync = initSync(roomId); + let feedbackMessage = "Ready to collaborate."; + let feedbackTimer: number | undefined; + + const setFeedbackMessage = (message: string) => { + feedbackMessage = message; + render(); + + if (feedbackTimer) { + window.clearTimeout(feedbackTimer); + } + + feedbackTimer = window.setTimeout(() => { + feedbackMessage = "Ready to collaborate."; + render(); + }, 2400); + }; + + const render = () => { + const viewModel = createViewModel({ + meta: sync.meta, + options: sync.options, + votes: sync.votes, + roomId, + shareUrl: window.location.href, + connectionStatus: sync.getConnectionStatus(), + userId, + }); + + renderApp(container, viewModel, feedbackMessage, { + onSubmitOption: (label) => { + const result = addOption(sync.options, label, userId); + if (!result.ok) { + setFeedbackMessage(result.error); + return; + } + + setFeedbackMessage("Option added and syncing."); + }, + onVote: (optionId) => { + castVote(sync.votes, userId, optionId); + setFeedbackMessage("Vote updated."); + }, + onCopyLink: async () => { + try { + await navigator.clipboard.writeText(window.location.href); + setFeedbackMessage("Room link copied."); + } catch { + setFeedbackMessage("Could not copy the link in this browser."); + } + }, + }); + }; + + const rerender = () => render(); + const observe = () => rerender(); + + sync.doc.on("update", observe); + sync.persistence.once("synced", rerender); + sync.provider.on("status", rerender); + window.addEventListener("online", rerender); + window.addEventListener("offline", rerender); + + render(); + + return () => { + if (feedbackTimer) { + window.clearTimeout(feedbackTimer); + } + sync.doc.off("update", observe); + sync.provider.off("status", rerender); + window.removeEventListener("online", rerender); + window.removeEventListener("offline", rerender); + sync.destroy(); + }; +} diff --git a/src/identity.ts b/src/identity.ts new file mode 100644 index 0000000..a87bbab --- /dev/null +++ b/src/identity.ts @@ -0,0 +1,20 @@ +const USER_ID_KEY = "p2p-poll:user-id"; + +function createUserId() { + if (typeof crypto.randomUUID === "function") { + return crypto.randomUUID(); + } + + return `user-${Math.random().toString(36).slice(2, 10)}`; +} + +export function getUserId() { + const existing = localStorage.getItem(USER_ID_KEY); + if (existing) { + return existing; + } + + const next = createUserId(); + localStorage.setItem(USER_ID_KEY, next); + return next; +} diff --git a/src/main.ts b/src/main.ts new file mode 100644 index 0000000..a800e40 --- /dev/null +++ b/src/main.ts @@ -0,0 +1,11 @@ +import "./styles.css"; + +import { initApp } from "./app"; + +const container = document.querySelector("#app"); + +if (!container) { + throw new Error("App container not found."); +} + +initApp(container); diff --git a/src/render.ts b/src/render.ts new file mode 100644 index 0000000..5521d19 --- /dev/null +++ b/src/render.ts @@ -0,0 +1,131 @@ +import type { PollViewModel } from "./state"; + +interface RenderActions { + onSubmitOption: (label: string) => void; + onVote: (optionId: string) => void; + onCopyLink: () => void; +} + +function escapeHtml(value: string) { + return value + .replaceAll("&", "&") + .replaceAll("<", "<") + .replaceAll(">", ">") + .replaceAll('"', """) + .replaceAll("'", "'"); +} + +export function renderApp( + container: HTMLElement, + viewModel: PollViewModel, + feedbackMessage: string, + actions: RenderActions, +) { + const optionMarkup = viewModel.options.length + ? viewModel.options + .map((option) => { + const buttonLabel = option.isSelectedByMe ? "Selected" : "Vote"; + const selectedClass = option.isSelectedByMe ? "option-card selected" : "option-card"; + + return ` +
  • +
    +
    +

    ${escapeHtml(option.label)}

    +

    ${option.voteCount} vote${option.voteCount === 1 ? "" : "s"}

    +
    + +
    +
    • + `; + }) + .join("") + : ` +
  • + No options yet. Add the first one and it will sync to everyone in this room. +
    • + `; + + const statusClass = `status-pill ${viewModel.connectionStatus}`; + const myVoteLabel = viewModel.myVoteOptionId + ? "Your vote is currently synced." + : "You have not voted yet."; + + container.innerHTML = ` +
    +
    +
    +

    Peer-to-peer room

    +

    ${escapeHtml(viewModel.title)}

    +

    + Share the room link, add options, and vote live without a central app server storing poll state. +

    +
    +
    + ${viewModel.connectionStatus} +

    Room: ${escapeHtml(viewModel.roomId)}

    +
    +
    + + + +
    +
    +
    +

    Options

    +

    ${myVoteLabel}

    +
    +
    +
      ${optionMarkup}
    +
    + +
    +

    Add an option

    +
    + + +
    + +
    +
    + `; + + const addOptionForm = container.querySelector("#add-option-form"); + const optionInput = container.querySelector("#option-input"); + const copyLinkButton = container.querySelector("#copy-link-button"); + + addOptionForm?.addEventListener("submit", (event) => { + event.preventDefault(); + const label = optionInput?.value ?? ""; + actions.onSubmitOption(label); + }); + + copyLinkButton?.addEventListener("click", () => { + actions.onCopyLink(); + }); + + container.querySelectorAll("[data-option-id]").forEach((button) => { + button.addEventListener("click", () => { + const optionId = button.dataset.optionId; + if (optionId) { + actions.onVote(optionId); + } + }); + }); +} diff --git a/src/state.ts b/src/state.ts new file mode 100644 index 0000000..a9edc75 --- /dev/null +++ b/src/state.ts @@ -0,0 +1,124 @@ +import * as Y from "yjs"; + +export const DEFAULT_POLL_TITLE = "Shared Poll"; + +export type ConnectionStatus = "connecting" | "connected" | "offline"; + +export interface OptionRecord { + id: string; + label: string; + createdAt: number; + createdBy: string; +} + +export interface PollOptionViewModel extends OptionRecord { + voteCount: number; + isSelectedByMe: boolean; +} + +export interface PollViewModel { + title: string; + roomId: string; + shareUrl: string; + connectionStatus: ConnectionStatus; + options: PollOptionViewModel[]; + myVoteOptionId: string | null; +} + +const META_KEY_TITLE = "title"; + +function createOptionId() { + if (typeof crypto.randomUUID === "function") { + return crypto.randomUUID(); + } + + return `option-${Math.random().toString(36).slice(2, 10)}`; +} + +function normalizeLabel(label: string) { + return label.trim().replace(/\s+/g, " "); +} + +function getPollTitle(meta: Y.Map) { + return meta.get(META_KEY_TITLE) ?? DEFAULT_POLL_TITLE; +} + +export function ensurePollInitialized(meta: Y.Map) { + if (!meta.has(META_KEY_TITLE)) { + meta.set(META_KEY_TITLE, DEFAULT_POLL_TITLE); + } +} + +export function addOption( + options: Y.Map, + rawLabel: string, + userId: string, +) { + const label = normalizeLabel(rawLabel); + if (!label) { + return { ok: false as const, error: "Option label cannot be empty." }; + } + + const normalizedTarget = label.toLocaleLowerCase(); + const duplicate = Array.from(options.values()).some( + (option) => option.label.trim().toLocaleLowerCase() === normalizedTarget, + ); + + if (duplicate) { + return { ok: false as const, error: "That option already exists." }; + } + + const option: OptionRecord = { + id: createOptionId(), + label, + createdAt: Date.now(), + createdBy: userId, + }; + + options.set(option.id, option); + return { ok: true as const, optionId: option.id }; +} + +export function castVote(votes: Y.Map, userId: string, optionId: string) { + votes.set(userId, optionId); +} + +export function createViewModel(params: { + meta: Y.Map; + options: Y.Map; + votes: Y.Map; + roomId: string; + shareUrl: string; + connectionStatus: ConnectionStatus; + userId: string; +}): PollViewModel { + const { meta, options, votes, roomId, shareUrl, connectionStatus, userId } = + params; + + const tally = new Map(); + for (const optionId of votes.values()) { + tally.set(optionId, (tally.get(optionId) ?? 0) + 1); + } + + const myVoteOptionId = votes.get(userId) ?? null; + const sortedOptions = Array.from(options.values()).sort((left, right) => { + if (left.createdAt !== right.createdAt) { + return left.createdAt - right.createdAt; + } + + return left.label.localeCompare(right.label); + }); + + return { + title: getPollTitle(meta), + roomId, + shareUrl, + connectionStatus, + myVoteOptionId, + options: sortedOptions.map((option) => ({ + ...option, + voteCount: tally.get(option.id) ?? 0, + isSelectedByMe: myVoteOptionId === option.id, + })), + }; +} diff --git a/src/styles.css b/src/styles.css new file mode 100644 index 0000000..363e6c6 --- /dev/null +++ b/src/styles.css @@ -0,0 +1,256 @@ +:root { + font-family: "IBM Plex Sans", "Segoe UI", sans-serif; + color: #132238; + background: + radial-gradient(circle at top left, rgba(255, 190, 120, 0.55), transparent 28%), + radial-gradient(circle at top right, rgba(86, 201, 166, 0.3), transparent 24%), + linear-gradient(180deg, #f9f4e8 0%, #f4efe6 48%, #ece5d8 100%); + line-height: 1.5; + font-weight: 400; + color-scheme: light; +} + +* { + box-sizing: border-box; +} + +body { + margin: 0; + min-height: 100vh; +} + +button, +input { + font: inherit; +} + +button { + cursor: pointer; +} + +#app { + min-height: 100vh; +} + +.shell { + width: min(920px, calc(100% - 2rem)); + margin: 0 auto; + padding: 2rem 0 3rem; +} + +.hero { + display: flex; + justify-content: space-between; + gap: 1.5rem; + align-items: flex-start; + margin-bottom: 1.5rem; +} + +.hero-copy h1 { + margin: 0.15rem 0 0.5rem; + font-size: clamp(2.4rem, 6vw, 4rem); + line-height: 0.95; + letter-spacing: -0.05em; +} + +.hero-text, +.section-header p, +.feedback, +.option-meta, +.room-label { + color: #4a5a6a; +} + +.eyebrow { + margin: 0; + text-transform: uppercase; + letter-spacing: 0.16em; + font-size: 0.8rem; + color: #915f00; +} + +.hero-meta { + min-width: 15rem; + padding: 1rem 1.1rem; + border-radius: 1.2rem; + background: rgba(255, 255, 255, 0.68); + border: 1px solid rgba(19, 34, 56, 0.08); + backdrop-filter: blur(10px); +} + +.status-pill { + display: inline-flex; + align-items: center; + padding: 0.35rem 0.75rem; + border-radius: 999px; + font-weight: 700; + text-transform: capitalize; + font-size: 0.9rem; +} + +.status-pill.connected { + background: rgba(86, 201, 166, 0.18); + color: #135d43; +} + +.status-pill.connecting { + background: rgba(255, 190, 120, 0.22); + color: #8c5300; +} + +.status-pill.offline { + background: rgba(219, 82, 82, 0.16); + color: #8f1f1f; +} + +.panel { + margin-bottom: 1.25rem; + padding: 1.25rem; + border-radius: 1.3rem; + background: rgba(255, 255, 255, 0.78); + border: 1px solid rgba(19, 34, 56, 0.08); + box-shadow: 0 14px 40px rgba(19, 34, 56, 0.08); + backdrop-filter: blur(10px); +} + +.panel h2 { + margin: 0 0 0.45rem; + font-size: 1.1rem; +} + +.share-row, +.option-form, +.option-main { + display: flex; + gap: 0.75rem; +} + +.field-label { + display: block; + margin-bottom: 0.6rem; + font-weight: 700; +} + +.share-input, +.option-form input { + width: 100%; + min-width: 0; + border-radius: 0.95rem; + border: 1px solid rgba(19, 34, 56, 0.14); + background: rgba(255, 255, 255, 0.94); + padding: 0.85rem 1rem; + color: #132238; +} + +.share-input:focus, +.option-form input:focus { + outline: 2px solid rgba(255, 190, 120, 0.65); + outline-offset: 1px; +} + +.primary-button, +.secondary-button, +.vote-button { + border: none; + border-radius: 0.95rem; + padding: 0.85rem 1rem; + font-weight: 700; + transition: transform 150ms ease, box-shadow 150ms ease, background-color 150ms ease; +} + +.primary-button, +.vote-button { + background: #132238; + color: #f9f4e8; + box-shadow: 0 10px 20px rgba(19, 34, 56, 0.14); +} + +.secondary-button { + background: rgba(19, 34, 56, 0.08); + color: #132238; +} + +.primary-button:hover, +.secondary-button:hover, +.vote-button:hover { + transform: translateY(-1px); +} + +.options-list { + list-style: none; + margin: 1rem 0 0; + padding: 0; + display: grid; + gap: 0.75rem; +} + +.option-card, +.empty-state { + border-radius: 1.1rem; + padding: 1rem; + background: rgba(247, 244, 236, 0.95); + border: 1px solid rgba(19, 34, 56, 0.08); +} + +.option-card.selected { + border-color: rgba(86, 201, 166, 0.85); + background: rgba(232, 249, 242, 0.95); +} + +.option-main { + align-items: center; + justify-content: space-between; +} + +.option-label { + margin: 0; + font-size: 1.05rem; + font-weight: 700; +} + +.option-meta, +.feedback, +.room-label { + margin: 0.35rem 0 0; +} + +.section-header { + display: flex; + justify-content: space-between; + align-items: baseline; + gap: 1rem; +} + +.feedback { + min-height: 1.5rem; +} + +code { + font-family: "IBM Plex Mono", "SFMono-Regular", monospace; +} + +@media (max-width: 720px) { + .shell { + width: min(100% - 1rem, 920px); + padding-top: 1rem; + } + + .hero, + .share-row, + .option-form, + .option-main, + .section-header { + flex-direction: column; + } + + .hero-meta { + width: 100%; + min-width: 0; + } + + .primary-button, + .secondary-button, + .vote-button { + width: 100%; + } +} diff --git a/src/sync.ts b/src/sync.ts new file mode 100644 index 0000000..77f3af4 --- /dev/null +++ b/src/sync.ts @@ -0,0 +1,64 @@ +import { IndexeddbPersistence } from "y-indexeddb"; +import { WebrtcProvider } from "y-webrtc"; +import * as Y from "yjs"; + +import { type ConnectionStatus, ensurePollInitialized, type OptionRecord } from "./state"; + +export interface AppSync { + doc: Y.Doc; + meta: Y.Map; + options: Y.Map; + votes: Y.Map; + provider: WebrtcProvider; + persistence: IndexeddbPersistence; + getConnectionStatus: () => ConnectionStatus; + destroy: () => void; +} + +export function initSync(roomId: string): AppSync { + const doc = new Y.Doc(); + const meta = doc.getMap("poll-meta"); + const options = doc.getMap("poll-options"); + const votes = doc.getMap("poll-votes"); + + ensurePollInitialized(meta); + + let connectionStatus: ConnectionStatus = navigator.onLine ? "connecting" : "offline"; + const provider = new WebrtcProvider(roomId, doc); + const persistence = new IndexeddbPersistence(roomId, doc); + + const syncConnectionStatus = (status: ConnectionStatus) => { + connectionStatus = navigator.onLine ? status : "offline"; + }; + + const handleOnline = () => { + syncConnectionStatus(provider.connected ? "connected" : "connecting"); + }; + const handleOffline = () => { + connectionStatus = "offline"; + }; + + provider.on("status", (event: { connected: boolean }) => { + syncConnectionStatus(event.connected ? "connected" : "connecting"); + }); + + window.addEventListener("online", handleOnline); + window.addEventListener("offline", handleOffline); + + return { + doc, + meta, + options, + votes, + provider, + persistence, + getConnectionStatus: () => connectionStatus, + destroy: () => { + window.removeEventListener("online", handleOnline); + window.removeEventListener("offline", handleOffline); + persistence.destroy(); + provider.destroy(); + doc.destroy(); + }, + }; +} diff --git a/test.txt b/test.txt deleted file mode 100644 index e69de29..0000000 diff --git a/tsconfig.json b/tsconfig.json new file mode 100644 index 0000000..2746931 --- /dev/null +++ b/tsconfig.json @@ -0,0 +1,15 @@ +{ + "compilerOptions": { + "target": "ES2022", + "module": "ESNext", + "moduleResolution": "Bundler", + "lib": ["DOM", "DOM.Iterable", "ES2022"], + "strict": true, + "noEmit": true, + "esModuleInterop": true, + "skipLibCheck": true, + "allowSyntheticDefaultImports": true, + "useDefineForClassFields": true + }, + "include": ["src"] +}