Skip to content

docs: add yellow-sdk-codemod reference to compat SDK pages#127

Merged
alessio merged 3 commits intomasterfrom
docs/add-codemod-reference
Mar 13, 2026
Merged

docs: add yellow-sdk-codemod reference to compat SDK pages#127
alessio merged 3 commits intomasterfrom
docs/add-codemod-reference

Conversation

@ihsraham
Copy link
Collaborator

@ihsraham ihsraham commented Mar 13, 2026

Summary

  • Adds a callout box to the TypeScript Compat Overview page with scan/run usage examples and a link to the codemod repo.
  • Adds a tip admonition to the Migration Overview page pointing developers to the codemod before they start migrating manually.

The codemod tool lives at https://github.com/layer-3/yellow-sdk-codemod and automates the bulk of the @erc7824/nitrolite (v0.4-v0.5.3) to @yellow-org/sdk-compat migration.

Screengrabs

ScreenRecording2026-03-13at3 36 09PM-ezgif com-video-to-gif-converter

image

Test plan

  • Verify the Docusaurus :::tip admonition renders correctly on both pages
  • Confirm the codemod repo link resolves (currently private to the org)

Summary by CodeRabbit

  • Documentation
    • Added a new "Automate with Codemod" tip and a collapsible note for users already on older Nitrolite packages, guiding automated migration steps.
    • Documented that the codemod automates imports, client constructor updates, and auth field renames, included example scan/apply commands and a TODO pointer to follow-up checks and codemod README.

Add callout boxes linking to the codemod tool on the compat overview
and migration overview pages so developers migrating from v0.5.3 can
discover and use the automated migration tooling.
@ihsraham ihsraham requested a review from dpatsora as a code owner March 13, 2026 09:59
@coderabbitai
Copy link

coderabbitai bot commented Mar 13, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 5c4df39a-2948-47de-9e0f-88a4748fc5be

📥 Commits

Reviewing files that changed from the base of the PR and between 92afaf5 and 0b601c4.

📒 Files selected for processing (1)
  • docs/build/sdk/typescript-compat/overview.mdx
🚧 Files skipped from review as they are similar to previous changes (1)
  • docs/build/sdk/typescript-compat/overview.mdx

📝 Walkthrough

Walkthrough

Added documentation blocks to two TypeScript SDK compatibility docs describing the yellow-sdk-codemod and guidance for automated migration; no functional code or runtime changes.

Changes

Cohort / File(s) Summary
SDK Compatibility Documentation
docs/build/sdk/typescript-compat/migration-overview.mdx, docs/build/sdk/typescript-compat/overview.mdx
Inserted "Automate with Codemod" and a collapsible guidance block describing the yellow-sdk-codemod, its transform capabilities (imports, client constructors, auth renames), example scan/apply commands, TODO placeholders for context-sensitive fixes, and a pointer to the codemod README.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Suggested reviewers

  • dpatsora

Poem

🐇 I hop through docs with nimble feet,
I fold your imports tidy and neat.
Constructors leap, auth fields reframe,
A codemod dance to speed your name.
Pip-pip — the migration's tame! ✨

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately describes the main change: adding references to yellow-sdk-codemod documentation on the TypeScript Compat SDK pages, which matches the changeset content.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch docs/add-codemod-reference
📝 Coding Plan
  • Generate coding plan for human review comments

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 2

🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Inline comments:
In `@docs/build/sdk/typescript-compat/overview.mdx`:
- Around line 233-247: Update the codemod link and tip block in overview.mdx to
warn that the GitHub repo (https://github.com/layer-3/yellow-sdk-codemod) is
private or requires Layer 3 org access: amend the sentence that introduces the
codemod and the "Codemod available" tip to include a brief accessibility note
such as "Requires Layer 3 organization access" or replace the link with a public
alternative, and ensure the accompanying code example remains but is prefixed by
the accessibility note so readers know why the link may 404.
- Around line 238-244: Update the codemod usage instructions to include setup
and canonical invocation: explain how to obtain the codemod (either install via
npm/yarn with the package name or clone the repo and run npm install), then show
the canonical command to run the tool (replace the local path invocations like
`npx tsx src/cli.ts scan` and `npx tsx src/cli.ts run` with the published
package invocation or a repo-local invocation after cloning), and include any
prerequisite steps (e.g., git clone <repo>, cd <repo>, npm install) so readers
can reproduce the `scan` and `run` commands reliably.

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: c39c2792-c2b7-4b04-9685-b38540d8612c

📥 Commits

Reviewing files that changed from the base of the PR and between a1fb886 and 121dfc5.

📒 Files selected for processing (2)
  • docs/build/sdk/typescript-compat/migration-overview.mdx
  • docs/build/sdk/typescript-compat/overview.mdx

… context

Move the codemod reference to a collapsible section right below the
page intro so returning developers see it first. Add clone and install
steps so the CLI invocation makes sense without prior context.
Enhance the codemod section by adding detailed steps for cloning and installing the tool, and clarify the scanning and transformation commands for better usability during the migration from v0.5.3 to v1.0.0.
@alessio alessio added this pull request to the merge queue Mar 13, 2026
Merged via the queue into master with commit 295acfc Mar 13, 2026
9 checks passed
@alessio alessio deleted the docs/add-codemod-reference branch March 13, 2026 11:00
github-merge-queue bot pushed a commit that referenced this pull request Mar 13, 2026
## Summary

- Remove incorrect `@layer-3/nitrolite` references from codemod callouts
(that package was never published; old SDK was only
`@erc7824/nitrolite`)
- Add explicit clone + install steps to the overview collapsible so the
CLI commands have proper context

Follows up on #127.

## Test plan

- [ ] Verify both `.mdx` pages render correctly in Docusaurus
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.

2 participants