Skip to content

build: ship docs/oauth-scopes.md in the npm package [PLT-107543]#605

Merged
ninja-shreyash merged 1 commit into
mainfrom
build/ship-oauth-scopes-in-package
Jul 16, 2026
Merged

build: ship docs/oauth-scopes.md in the npm package [PLT-107543]#605
ninja-shreyash merged 1 commit into
mainfrom
build/ship-oauth-scopes-in-package

Conversation

@ninja-shreyash

Copy link
Copy Markdown
Contributor

Summary

Ships docs/oauth-scopes.md inside the npm package by adding it to the files field in package.json. One line, no code change.

Why

OAuth scopes are enforced server-side and appear nowhere in the shipped TypeScript types. Code that requests the wrong scopes compiles cleanly and then fails at runtime with a 401/403. Today the per-method scope reference (docs/oauth-scopes.md) exists in the repo but is not part of the published package, so consumers of the installed SDK (developers, IDEs, and AI coding agents) have no version-exact scope reference on disk. They have to know the GitHub URL and fetch it separately.

Adding the file to the package gives every install a scope reference that matches the installed version exactly, sitting right next to the .d.ts that developers already read at node_modules/@uipath/uipath-typescript/.

Impact

  • Tarball grows by ~10 kB (a 1.6 MB package), verified via npm pack --dry-run.
  • No code, no API change, no runtime effect.

Context

This unblocks a companion change in the uipath/skills repo (PR #1907), which slims the coded-apps skill's hand-maintained SDK docs and instead routes agents to the installed package. Per-method scopes are the one piece the package does not ship today; this closes that gap.

@ninja-shreyash
ninja-shreyash requested a review from a team July 15, 2026 13:56
@claude

claude Bot commented Jul 15, 2026

Copy link
Copy Markdown
Contributor

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

OAuth scopes are enforced server-side and appear nowhere in the shipped
types — code with missing scopes compiles cleanly and 403s at runtime.
Shipping the per-method scope table with the package gives developers,
IDEs, and coding agents a version-exact scope reference at
node_modules/@uipath/uipath-typescript/docs/oauth-scopes.md, next to
the .d.ts they already read. Verified via npm pack --dry-run (+10.2kB).

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@ninja-shreyash
ninja-shreyash force-pushed the build/ship-oauth-scopes-in-package branch from f92cb8b to d64c262 Compare July 16, 2026 10:12
@ninja-shreyash ninja-shreyash changed the title build: ship docs/oauth-scopes.md in the npm package build: ship docs/oauth-scopes.md in the npm package [PLT-107543] Jul 16, 2026
@claude

claude Bot commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

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

@ninja-shreyash
ninja-shreyash merged commit 8713e45 into main Jul 16, 2026
16 of 20 checks passed
@ninja-shreyash
ninja-shreyash deleted the build/ship-oauth-scopes-in-package branch July 16, 2026 11:23
@sonarqubecloud

Copy link
Copy Markdown

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