NEARBuilders / NEARBuilders/everything-dev

orpc-v2: migrate all six contracts to the v2 route builder

Open
#260 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

ready-for-agent
Dominant language
TypeScript
Stars
5
Forks
6
Avg merge
1m
Merged PRs (30d)
1

Description

Ticket ID: B3

Parent

#248 — orpc-v2: consolidate fork into everything-dev and migrate platform to oRPC v2 + Effect 4 (epic)

What to build

Stage B, step 3: migrate the six contract files (the api's base contract plus the five plugins' contracts) to the oRPC v2 route builder. Each file preloads the @orpc/openapi route extension (import "@orpc/openapi/extensions/route") so .route carries full OpenAPIMeta. Route paths, input/output schemas, and metadata (tags/summary/description) stay equivalent, and the contract tsconfig type-emission flow must still work.

Acceptance criteria

  • All six contracts on the v2 builder with the route extension preloaded
  • Generated OpenAPI spec equivalent to pre-migration (ignoring the OAS version field)
  • Contract type-emission flow green
  • No route/path/shape changes — wire-compatible

Blocked by

  • #259 — createPlugin restructure

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

After #259 is complete, locate the API base contract and five plugin contract files, then read their current builders and the preloaded @orpc/openapi route extension. Migrate all six to the oRPC v2 route builder without changing paths, schemas, or metadata. Verify the generated OpenAPI spec is equivalent and the contract tsconfig type-emission flow is green.

Written by the indexing model from the issue text.

Assessment

Tech stack
openapi, typescript
Domain
api
Issue type
Refactor
Difficulty
4/5
Estimated time
3-5 days
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.