feat(bot): playback progress bar in nowplaying/songinfo embed

[LucasSantana-Dev]

Closes #1768

What

/nowplaying (and /songinfo) embeds now show a playback progress bar with elapsed/total timecodes, so a user can tell if a track is 10% or 90% done without guessing.

How

• buildTrackEmbed gains an optional options.progressBar param → rendered as a non-inline Progress field only when present.
• songinfo.execute (the shared renderer both commands use) snapshots the position via discord-player v7's built-in queue.node.createProgressBar({ length: 18, timecodes: true }) — reusing the library helper rather than hand-rolling a bar. Returns null for livestreams/no-duration tracks → field omitted.

Static snapshot at command time (matches the issue's ask); no message-edit loop.

Verify

• jest buildTrackEmbed nowplaying → 39/39 pass (Progress-field present/omitted; bar threaded from queue.node; null-for-livestream)
• type:check 0, eslint 0

Other buildTrackEmbed callers (queued/recommended/history) are unaffected — the param is optional and only songinfo passes it.

---

Summary by cubic

Adds a playback progress bar with elapsed/total timecodes to /nowplaying and /songinfo embeds so users can see how far a track has progressed. Implements #1768 as a one-time snapshot with no message update loop.

• New Features
  • buildTrackEmbed accepts options.progressBar and shows a non-inline "Progress" field when provided.
  • Both commands snapshot the bar via discord-player v7 queue.node.createProgressBar({ length: 18, timecodes: true }); omitted for livestreams or no-duration tracks.
  • Optional param keeps other buildTrackEmbed callers unchanged.

^{Written for commit 7474242. Summary will update on new commits.}

Summary by CodeRabbit

• New Features
  • Added playback progress bars to track information displayed by the /nowplaying and /songinfo commands.
  • Progress indicators show the current position for playing tracks.
  • Livestreams and tracks without a known position no longer display an unnecessary progress indicator.
  • Track embeds now present playback progress in a dedicated, easy-to-read field.

[coderabbitai]

📝 Walkthrough

Walkthrough

Music embeds now accept optional playback progress. /songinfo computes progress from the queue node and passes it to the embed builder, which conditionally renders a Progress field. Tests cover playing tracks, livestreams, and absent progress.

Changes

Music embed playback progress

Layer / File(s)	Summary
Progress-aware track embed contract packages/bot/src/utils/general/responseEmbeds/buildTrackEmbed.ts, packages/bot/src/utils/general/responseEmbeds/buildTrackEmbed.spec.ts	buildTrackEmbed accepts an optional progress bar and adds a non-inline Progress field when present; tests cover populated, missing, and null values.
Playback progress command integration packages/bot/src/functions/music/commands/songinfo.ts, packages/bot/src/functions/music/commands/nowplaying.spec.ts	/songinfo derives a timecoded progress bar from the queue node and passes it to buildTrackEmbed; nowplaying tests assert playing-track and livestream behavior.
Estimated code review effort: 3 (Moderate)	~20 minutes

Sequence Diagram(s)

sequenceDiagram
  participant MusicCommand
  participant GuildQueueNode
  participant createProgressBar
  participant buildTrackEmbed
  participant interactionReply
  MusicCommand->>GuildQueueNode: Read current playback position
  GuildQueueNode->>createProgressBar: Create timecoded progress bar
  createProgressBar-->>MusicCommand: Return progress bar or null
  MusicCommand->>buildTrackEmbed: Pass progressBar option
  buildTrackEmbed-->>MusicCommand: Build track embed
  MusicCommand->>interactionReply: Send embed response

Loading

Possibly related PRs

• LucasSantana-Dev/Lucky#503: Extends buildTrackEmbed with progress options and updates music command coverage.
• LucasSantana-Dev/Lucky#507: Migrates music commands to buildTrackEmbed, which this change further integrates.

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	The PR adds elapsed-time progress data to buildTrackEmbed and passes progress bars from queue playback state into bot embeds.
Out of Scope Changes check	✅ Passed	The changes stay focused on embed progress display and related tests, with no clear unrelated additions.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main change: adding playback progress bars to nowplaying and songinfo embeds.

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/1768-music-embed-progress

---

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Failed to generate code suggestions for PR

[github-actions]

	Warnings
⚠️	User-facing change without a CHANGELOG.md update. Add a line under ## [Unreleased] if this should appear in release notes. (Or apply the skip-changelog label if this PR does not affect end users.)

Generated by 🚫 dangerJS against 7474242

[cubic-dev-ai]

No issues found across 4 files

<sub>Auto-approved: Adds an optional progress bar field to nowplaying/songinfo embeds using discord-player's built-in helper. Isolated change with no impact on core logic; tests pass and existing callers unaffected.

Re-trigger cubic</sub>

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
100.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud