Skip to content

fix(docs): fill JSDoc gaps flagged by validation gate#593

Merged
Raina451 merged 1 commit into
chore/jsdoc-completeness-validationfrom
chore/fix-jsdoc-gaps
Jul 13, 2026
Merged

fix(docs): fill JSDoc gaps flagged by validation gate#593
Raina451 merged 1 commit into
chore/jsdoc-completeness-validationfrom
chore/fix-jsdoc-gaps

Conversation

@Raina451

Copy link
Copy Markdown
Collaborator

What

Documents every public API gap surfaced by the JSDoc validation gate (#592), so npm run docs:validate exits 0 and the jsdoc-validation CI check goes green.

Fixes

Missing docs (documented):

  • Error type guards (isUiPathError, isAuthenticationError, … getErrorDetails) — added @param/@returns
  • createAgentWithMethods — added the JSDoc block its 8 sibling factories already have
  • QueueServiceModel.getById / QueueService.getById — documented the options param
  • ConversationSessionMethods (startSession/getSession/endSession) — documented params
  • UiPath constructor — documented config

Doc bugs:

  • createEntityWithMethods@param entityMetadata renamed to the actual param entityData
  • QueueServiceModel.getAll — removed the unknown @signature block tag

Internal (excluded from public docs via @internal):

  • Telemetry exports (track, trackEvent, telemetryClient) — internal infra
  • Error-class constructors — users catch errors, never construct them

Notes

Generated with Claude Code

- Add missing @param/@returns to error type guards and getErrorDetails
- Add JSDoc to createAgentWithMethods; fix stale @param name on
  createEntityWithMethods
- Document QueueServiceModel.getById options param (model + service) and
  drop the unknown @Signature tag from getAll
- Document ConversationSessionMethods params and the UiPath constructor
- Mark internal telemetry exports and error-class constructors @internal

Clears all notDocumented findings; npm run docs:validate exits 0.

Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>
@Raina451 Raina451 changed the title docs: fill JSDoc gaps flagged by validation gate fix(docs): fill JSDoc gaps flagged by validation gate Jul 10, 2026
@Raina451
Raina451 changed the base branch from main to chore/jsdoc-completeness-validation July 10, 2026 07:48
@claude

claude Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

✅ No issues found. Checked for bugs and CLAUDE.md compliance.

@Raina451
Raina451 marked this pull request as ready for review July 10, 2026 07:52
@sonarqubecloud

Copy link
Copy Markdown

@claude

claude Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

✅ No issues found. Checked for bugs and CLAUDE.md compliance.

@Raina451
Raina451 merged commit 5dd3292 into chore/jsdoc-completeness-validation Jul 13, 2026
19 checks passed
@Raina451
Raina451 deleted the chore/fix-jsdoc-gaps branch July 13, 2026 08:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants