feat(contract, server)!: rewrite builders (#110)

* wip

* types tests

* wip

* 100% test coverage

* fix types

* fix types

* remove ~type and decorated method

* procedure builders

* rename

* router builders

* builder

* remove redundant method

* wip

* router

* wip

* fix isLazy

* procedure tests

* router tests

* builder tests

* 100% test coverage

* wip

* fixed

* fix types tests

* wip

* fix types

* ORPCErrorConstructorMap

* improve

* wip

* improve

* improve

* wip

* improve

* improve

* fix

* prefix lazy

* fix

* procedure implementer

* type tests

* tests

* index

* variants tests

* setRouterContract

* fix

* docs

* docs

* tests

* clear mock before each tests

* lint fixed

* fix docs

* fix restrict context

* fix types

* improve middlewares

Author: unnoq

apps/content/content/docs/contract-first.mdx

@@ -90,16 +90,15 @@ export type Outputs = InferContractRouterOutputs<typeof contract>
 With your contract defined, implement the server logic:
 
 ```ts twoslash
-import { os, ORPCError } from '@orpc/server'
+import { implement, ORPCError } from '@orpc/server'
 import { contract } from 'examples/contract'
 
-export const pub = os.contract(contract) // Ensure every implement must be match contract
-export const authed = os
+export const pub = implement(contract) // Ensure every implement must be match contract
+export const authed = pub
   .use(({ context, path, next }, input) => {
     /** put auth logic here */
     return next({})
   })
-  .contract(contract)
 
 export const router = pub.router({
   getUser: pub.getUser.handler(({ input, context }) => {

apps/content/content/docs/index.mdx

@@ -62,7 +62,7 @@ import { z } from 'zod'
 export type Context = { user?: { id: string } }
 
 // global pub, authed completely optional
-export const pub = os.context<Context>()
+export const pub = os.$context<Context>()
 export const authed = pub.use(({ context, path, next }, input) => {
   /** put auth logic here */
   return next({})
@@ -98,9 +98,7 @@ export const router = pub.router({
       )
       .use(async ({ context, path, next }, input) => {
         if (!context.user) {
-          throw new ORPCError({
-            code: 'UNAUTHORIZED',
-          })
+          throw new ORPCError('UNAUTHORIZED')
         }
 
         const result = await next({

apps/content/content/docs/openapi/generator.mdx

@@ -19,7 +19,7 @@ import { z } from 'zod'
 export type Context = { user?: { id: string } }
 
 // global pub, authed completely optional
-export const pub = os.context<Context>()
+export const pub = os.$context<Context>()
 export const authed = pub.use(({ context, path, next }, input) => {
   /** put auth logic here */
   return next({})

apps/content/content/docs/server/context.mdx

@@ -18,9 +18,9 @@ import { z } from 'zod'
 import { headers } from 'next/headers'
 
 type ORPCContext = { db: 'fake-db', user?: { id: string } }
-const base = os.context<ORPCContext>() // define `initial context`
+const base = os.$context<ORPCContext>() // define `initial context`
 
-const pub = os.context<ORPCContext>().use(async ({ context, path, next }, input) => {
+const pub = os.$context<ORPCContext>().use(async ({ context, path, next }, input) => {
     const headersList = await headers()
 
     // the `user` is `middleware context`, because it is created by middleware
@@ -58,13 +58,13 @@ const base = os.use(async ({ context, path, next }, input) => {
 })
 
 const authMid = os
-  .context<{ db: string }>() // this middleware depends on some context
+  .$context<{ db: string }>() // this middleware depends on some context
   .middleware(async ({ context, next, path }, input) => {
     const headersList = await headers()
     const user = headersList.get('Authorization') ? { id: 'example' } : undefined
 
     if (!user) {
-      throw new ORPCError({ code: 'UNAUTHORIZED' })
+      throw new ORPCError('UNAUTHORIZED')
     }
 
     return next({
@@ -108,11 +108,11 @@ import { OpenAPIServerlessHandler, OpenAPIServerHandler } from '@orpc/openapi/fe
 
 type ORPCContext = { user?: { id: string }, db: 'fake-db' }
 
-const base = os.context<ORPCContext>()
+const base = os.$context<ORPCContext>()
 
 const authMid = base.middleware(({ context, next, path }, input) => {
     if(!context.user) {
-        throw new ORPCError({ code: 'UNAUTHORIZED' })
+        throw new ORPCError('UNAUTHORIZED')
     }
 
     return next({

apps/content/content/docs/server/contract.mdx

@@ -78,18 +78,17 @@ export const contract = oc.router({
 All `server` features are available, except the input, output, and route parts, which are defined in the contract.
 
 ```ts twoslash
-import { os } from '@orpc/server'
+import { implement } from '@orpc/server'
 import { contract } from 'examples/contract'
 
 export type Context = { user?: { id: string } }
-export const base = os.context<Context>()
-export const pub = base.contract(contract) // Ensure every implement must be match contract
+export const base = implement(contract).$context<Context>()
+export const pub = base
 export const authed = base
   .use(({ context, path, next }, input) => {
     /** put auth logic here */
     return next({})
   })
-  .contract(contract)
 
 export const router = pub.router({
   getUser: pub.getUser.handler(({ input, context }) => {

apps/content/content/docs/server/error-handling.mdx

@@ -26,7 +26,7 @@ const createPost = os
     throw errors.CONFLICT({ data: { why: 'some reason' } })
 
     // is the same as, but this is not typed
-    throw new ORPCError({ code: 'CONFLICT', data: { why: 'some reason' } })
+    throw new ORPCError('CONFLICT', { data: { why: 'some reason' } })
 
     // throw errors.ANY_CODE()
   })
@@ -82,8 +82,7 @@ const ping = os
         }
     })
     .handler(({ input, context }) => {
-        throw new ORPCError({
-            code: 'NOT_FOUND',
+        throw new ORPCError('NOT_FOUND', {
             message: 'Not found',
             status: 404, // Optional: custom default behavior
             data: { something: 'include in the body and send to the client' } // pass data to the client

apps/content/content/docs/server/lazy.mdx

@@ -16,7 +16,7 @@ Here's how you can set up and use them:
 ```typescript twoslash
 import { os, call } from '@orpc/server'
 
-const pub = os.context<{ user?: { id: string } }>()
+const pub = os.$context<{ user?: { id: string } }>()
 
 // Define a router with lazy loading
 const router = pub.router({
@@ -48,7 +48,7 @@ const output = await call(router.lazy.getUser, { id: '123' })
 
    ```ts twoslash
     import { os } from '@orpc/server'
-    const pub = os.context<{ user?: { id: string } }>()
+    const pub = os.$context<{ user?: { id: string } }>()
 
     const lazy = pub.prefix('/some').lazy(() => import('examples/server'))
     ```

apps/content/content/docs/server/middleware.mdx

@@ -12,12 +12,11 @@ import { os, ORPCError } from '@orpc/server'
 
 export type Context = { user?: { id: string } }
 
-export const pub = os.context<Context>()
+export const pub = os.$context<Context>()
 
 const authMiddleware = pub.middleware(async ({ context, next, path }, input) => {
     if (!context.user) {
-        throw new ORPCError({
-            code: 'UNAUTHORIZED',
+        throw new ORPCError('UNAUTHORIZED', {
             message: 'You need to log in first',
         })
     }
@@ -86,13 +85,13 @@ type Context = {
     }
 }
 
-export const pub = os.context<Context>()
+export const pub = os.$context<Context>()
 
 // Any procedure using this middleware will infer context.user as NonNullable<typeof context['user']>
 const authMiddleware = pub
     .middleware(async ({ context, next, path }, input) => {
         if (!context.user) {
-            throw new ORPCError({ code: 'UNAUTHORIZED' })
+            throw new ORPCError('UNAUTHORIZED')
         }
 
         return next({

apps/content/content/docs/server/procedure.mdx

@@ -21,13 +21,11 @@ import { os, ORPCError } from '@orpc/server'
 
 // Define context type for full type inference
 const pub = os
-    .context<{user?: {id: string}}>()
-    .config({ // optional, change some default configuration
-        initialRoute: {
-            method: 'DELETE', // change default method to DELETE
-            inputStructure: 'detailed', // change default input structure to detailed
-            outputStructure: 'detailed' // change default output structure to detailed
-        }
+    .$context<{user?: {id: string}}>() // optional, set config
+    .$route({ // optional, change initial route
+        method: 'DELETE', // change default method to DELETE
+        inputStructure: 'detailed', // change default input structure to detailed
+        outputStructure: 'detailed' // change default output structure to detailed
     })
 
 const getUser = pub
@@ -40,8 +38,7 @@ const getUser = pub
 
         // Example: Authentication check
         if (!context.user) {
-            throw new ORPCError({
-                code: 'UNAUTHORIZED',
+            throw new ORPCError('UNAUTHORIZED', {
                 message: 'Authentication required'
             })
         }

apps/content/content/docs/server/server-action.mdx

@@ -43,7 +43,7 @@ When calling `.actionable()`, you can pass a context function that provides addi
 import { os } from '@orpc/server'
 import { z } from 'zod'
 
-const pub = os.context<{ db: string }>()
+const pub = os.$context<{ db: string }>()
 
 export const getting = pub
   .input(z.object({
@@ -77,7 +77,7 @@ const authed = os.use(async ({ next }) => {
   const user = headersList.get('Authorization') ? { id: 'example' } : undefined
 
   if (!user) {
-    throw new ORPCError({ code: 'UNAUTHORIZED' })
+    throw new ORPCError('UNAUTHORIZED')
   }
 
   return next({