const{Fragment:l,jsx:e,jsxs:n}=arguments[0];function _createMdxContent(r){const c={code:"code",figcaption:"figcaption",figure:"figure",h2:"h2",h3:"h3",li:"li",ol:"ol",p:"p",pre:"pre",span:"span",strong:"strong",ul:"ul",...r.components};return n(l,{children:[n(c.p,{children:["Hexagonal architecture (ports and adapters) is one of those patterns that sounds academic until you feel the payoff. In NestJS specifically, the payoff is ",e(c.strong,{children:"test speed"}),". When your command handler tests run in under 10ms with zero database, zero framework, and zero mocking libraries, the architecture has earned its keep."]}),"\n",e(c.p,{children:"Here's how I structure it, with real patterns from production NestJS codebases."}),"\n",e(c.h2,{children:"The folder structure"}),"\n",e(c.p,{children:"Every bounded context follows the same three-layer layout:"}),"\n",e(c.pre,{children:e(c.code,{children:"src/orders/\n core/\n entities/ # domain aggregates\n events/ # domain events\n exceptions/ # domain-specific errors\n ports/ # port interfaces + Symbol tokens\n value-objects/ # Email, Money, etc.\n application/\n commands/ # CQRS command handlers\n queries/ # CQRS query handlers\n event-handlers/ # domain event subscribers\n services/ # application services\n infra/\n repositories/ # Prisma adapter, in-memory adapter\n adapters/ # cross-context adapters (ACL)\n controllers/ # HTTP controllers\n"})}),"\n",n(c.p,{children:["The dependency rule: ",e(c.code,{children:"core/"})," imports nothing from ",e(c.code,{children:"application/"})," or ",e(c.code,{children:"infra/"}),". ",e(c.code,{children:"application/"})," imports from ",e(c.code,{children:"core/"})," but not ",e(c.code,{children:"infra/"}),". ",e(c.code,{children:"infra/"})," imports from both."]}),"\n",n(c.p,{children:["This isn't just organization — it's a compile-time guarantee. If your entity file imports ",e(c.code,{children:"PrismaService"}),", something is wrong and your IDE will show it."]}),"\n",e(c.h2,{children:"Ports: Symbol token + interface"}),"\n",n(c.p,{children:["A port is two things co-located in one file inside ",e(c.code,{children:"core/ports/"}),":"]}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"core/ports/order.repository.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"import"}),e(c.span,{style:{color:"#CBA6F7"},children:" type"}),e(c.span,{style:{color:"#9399B2"},children:" {"}),e(c.span,{style:{color:"#CDD6F4"},children:" Order "}),e(c.span,{style:{color:"#9399B2"},children:"}"}),e(c.span,{style:{color:"#CBA6F7"},children:" from"}),e(c.span,{style:{color:"#A6E3A1"},children:" '../entities/order.entity'"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" ORDER_REPOSITORY "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" Symbol"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'ORDER_REPOSITORY'"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" interface"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IOrderRepository"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" save"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"order"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Order"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#CBA6F7"},children:"void"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" findById"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"id"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:"Order "}),e(c.span,{style:{color:"#94E2D5"},children:"|"}),e(c.span,{style:{color:"#CBA6F7",fontStyle:"italic"},children:" null"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" findByCustomerId"}),e(c.span,{style:{color:"#9399B2"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" pagination"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#9399B2"},children:" {"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" page"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" number"}),e(c.span,{style:{color:"#9399B2"},children:";"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" limit"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" number"}),e(c.span,{style:{color:"#9399B2"},children:" },"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" )"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#9399B2"},children:"{"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" orders"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Order[]"}),e(c.span,{style:{color:"#9399B2"},children:";"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" total"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" number"}),e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"}"})})]})})]}),"\n",n(c.p,{children:["The ",e(c.code,{children:"Symbol"})," is the NestJS DI token. The ",e(c.code,{children:"interface"})," is the contract. They're co-located because they're always used together — you never import one without the other."]}),"\n",n(c.p,{children:["Why a ",e(c.code,{children:"Symbol"})," and not a string token? Symbols are globally unique. Two modules can both define an ",e(c.code,{children:"ORDER_REPOSITORY"})," Symbol and they'll never collide. String tokens like ",e(c.code,{children:"'ORDER_REPOSITORY'"})," will."]}),"\n",e(c.h2,{children:"Adapter variant 1: Prisma (production)"}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"infra/repositories/prisma-order.repository.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"@Injectable"}),e(c.span,{style:{color:"#FAB387"},children:"()"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" class"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" PrismaOrderRepository"}),e(c.span,{style:{color:"#CBA6F7"},children:" implements"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IOrderRepository"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" constructor"}),e(c.span,{style:{color:"#9399B2"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" @InjectTransactionHost"}),e(c.span,{style:{color:"#FAB387"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'orders'"}),e(c.span,{style:{color:"#FAB387"},children:")"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" private"}),e(c.span,{style:{color:"#CBA6F7"},children:" readonly"}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" txHost"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" TransactionHost"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" private"}),e(c.span,{style:{color:"#CBA6F7"},children:" readonly"}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" deferredEvents"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" DeferredEventBus"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:" {}"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" @Transactional"}),e(c.span,{style:{color:"#FAB387"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'orders'"}),e(c.span,{style:{color:"#FAB387"},children:")"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" save"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"order"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Order"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#CBA6F7"},children:"void"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" data "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CDD6F4"},children:" order"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"toPersistence"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" await"}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"txHost"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"tx"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"order"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"upsert"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" where"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#9399B2"},children:" {"}),e(c.span,{style:{color:"#CDD6F4"},children:" orderId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" data"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orderId "}),e(c.span,{style:{color:"#9399B2"},children:"},"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" create"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" data"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" update"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" data"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" for"}),e(c.span,{style:{color:"#CDD6F4"},children:" ("}),e(c.span,{style:{color:"#CBA6F7"},children:"const"}),e(c.span,{style:{color:"#CDD6F4"},children:" event "}),e(c.span,{style:{color:"#CBA6F7"},children:"of"}),e(c.span,{style:{color:"#CDD6F4"},children:" order"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"getUncommittedEvents"}),e(c.span,{style:{color:"#CDD6F4"},children:"()) "}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"deferredEvents"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"publish"}),e(c.span,{style:{color:"#CDD6F4"},children:"(event)"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" order"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"uncommit"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" findById"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"id"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:"Order "}),e(c.span,{style:{color:"#94E2D5"},children:"|"}),e(c.span,{style:{color:"#CBA6F7",fontStyle:"italic"},children:" null"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" row "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CBA6F7"},children:" await"}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"txHost"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"tx"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"order"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"findUnique"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" where"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#9399B2"},children:" {"}),e(c.span,{style:{color:"#CDD6F4"},children:" orderId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" id "}),e(c.span,{style:{color:"#9399B2"},children:"},"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#CDD6F4"},children:" row "}),e(c.span,{style:{color:"#94E2D5"},children:"?"}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"toDomain"}),e(c.span,{style:{color:"#CDD6F4"},children:"(row) "}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" null"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" private"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" toDomain"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"row"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" PrismaOrder"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Order"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#CDD6F4"},children:" Order"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"from"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#94E2D5"},children:" ..."}),e(c.span,{style:{color:"#CDD6F4"},children:"row"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" total"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" row"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"total"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#9399B2",fontStyle:"italic"},children:" // Prisma stores as string"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"}"})})]})})]}),"\n",e(c.p,{children:"Key details:"}),"\n",n(c.ul,{children:["\n",n(c.li,{children:[e(c.code,{children:"implements IOrderRepository"})," — the compiler enforces the contract. If you add a method to the port interface and forget to implement it here, the build breaks."]}),"\n",n(c.li,{children:[e(c.code,{children:"toDomain()"})," is the anti-corruption boundary. Prisma's row type never leaks into the domain layer."]}),"\n",n(c.li,{children:[e(c.code,{children:"@Transactional('orders')"})," wraps the save in a CLS-scoped transaction. Domain events are deferred until after the commit."]}),"\n"]}),"\n",e(c.h2,{children:"Adapter variant 2: in-memory (tests)"}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"infra/repositories/in-memory-order.repository.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" class"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" InMemoryOrderRepository"}),e(c.span,{style:{color:"#CBA6F7"},children:" implements"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IOrderRepository"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" orders"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Order[] "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CDD6F4"},children:" []"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" save"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"order"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Order"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#CBA6F7"},children:"void"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" idx "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"findIndex"}),e(c.span,{style:{color:"#CDD6F4"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" ("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"o"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#CDD6F4"},children:" o"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orderId "}),e(c.span,{style:{color:"#94E2D5"},children:"==="}),e(c.span,{style:{color:"#CDD6F4"},children:" order"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orderId"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" if"}),e(c.span,{style:{color:"#CDD6F4"},children:" (idx "}),e(c.span,{style:{color:"#94E2D5"},children:">="}),e(c.span,{style:{color:"#FAB387"},children:" 0"}),e(c.span,{style:{color:"#CDD6F4"},children:") "}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders[idx] "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CDD6F4"},children:" order"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CBA6F7"},children:" else"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"push"}),e(c.span,{style:{color:"#CDD6F4"},children:"(order)"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" findById"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"id"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:"Order "}),e(c.span,{style:{color:"#94E2D5"},children:"|"}),e(c.span,{style:{color:"#CBA6F7",fontStyle:"italic"},children:" null"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"find"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"o"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#CDD6F4"},children:" o"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orderId "}),e(c.span,{style:{color:"#94E2D5"},children:"==="}),e(c.span,{style:{color:"#CDD6F4"},children:" id) "}),e(c.span,{style:{color:"#94E2D5"},children:"??"}),e(c.span,{style:{color:"#CBA6F7"},children:" null"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" findByCustomerId"}),e(c.span,{style:{color:"#9399B2"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" pagination"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#9399B2"},children:" {"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" page"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" number"}),e(c.span,{style:{color:"#9399B2"},children:";"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" limit"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" number"}),e(c.span,{style:{color:"#9399B2"},children:" },"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" )"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#9399B2"},children:"{"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" orders"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Order[]"}),e(c.span,{style:{color:"#9399B2"},children:";"}),e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" total"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" number"}),e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" filtered "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"filter"}),e(c.span,{style:{color:"#CDD6F4"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" ("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"o"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#CDD6F4"},children:" o"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"customerId "}),e(c.span,{style:{color:"#94E2D5"},children:"==="}),e(c.span,{style:{color:"#CDD6F4"},children:" customerId"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" orders"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" filtered"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"slice"}),e(c.span,{style:{color:"#CDD6F4"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" (pagination"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"page "}),e(c.span,{style:{color:"#94E2D5"},children:"-"}),e(c.span,{style:{color:"#FAB387"},children:" 1"}),e(c.span,{style:{color:"#CDD6F4"},children:") "}),e(c.span,{style:{color:"#94E2D5"},children:"*"}),e(c.span,{style:{color:"#CDD6F4"},children:" pagination"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"limit"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" pagination"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"page "}),e(c.span,{style:{color:"#94E2D5"},children:"*"}),e(c.span,{style:{color:"#CDD6F4"},children:" pagination"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"limit"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" total"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" filtered"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"length"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" };"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" clear"}),e(c.span,{style:{color:"#9399B2"},children:"()"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" void"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CDD6F4"},children:" []"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"}"})})]})})]}),"\n",n(c.p,{children:["No decorators, no framework imports, no database. It's a plain TypeScript class that implements the same interface. The ",e(c.code,{children:"orders"})," array is public so tests can assert on the stored state directly."]}),"\n",e(c.h2,{children:"Adapter variant 3: cross-context (anti-corruption layer)"}),"\n",n(c.p,{children:["This is where hexagonal architecture really shines. When module A needs data from module B, it ",e(c.strong,{children:"doesn't import module B's entities or repositories"}),". Instead:"]}),"\n",n(c.ol,{children:["\n",n(c.li,{children:["Module A defines a port in its own ",e(c.code,{children:"core/ports/"}),", using its own vocabulary."]}),"\n",n(c.li,{children:["An adapter in module A's ",e(c.code,{children:"infra/adapters/"})," translates across the boundary."]}),"\n"]}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"core/ports/order-billing.port.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" ORDER_BILLING_PORT "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" Symbol"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'ORDER_BILLING_PORT'"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" interface"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IOrderBillingPort"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" getBalance"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:"Decimal"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" freezeBalance"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"params"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" orderId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" amount"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" })"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#CBA6F7"},children:"void"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" settleOrder"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"params"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" orderId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" amount"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" fee"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" })"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#CBA6F7"},children:"void"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"}"})})]})})]}),"\n",n(c.p,{children:["The port speaks the ",e(c.strong,{children:"order context's language"})," — ",e(c.code,{children:"orderId"}),", ",e(c.code,{children:"freezeBalance"}),", ",e(c.code,{children:"settleOrder"}),". It doesn't expose the billing module's internal concepts (ledger entries, journal posting, account codes)."]}),"\n",e(c.p,{children:"The adapter translates:"}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"infra/adapters/order-billing.adapter.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"@Injectable"}),e(c.span,{style:{color:"#FAB387"},children:"()"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" class"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" OrderBillingAdapter"}),e(c.span,{style:{color:"#CBA6F7"},children:" implements"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IOrderBillingPort"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" constructor"}),e(c.span,{style:{color:"#9399B2"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" @Inject"}),e(c.span,{style:{color:"#FAB387"},children:"("}),e(c.span,{style:{color:"#CDD6F4"},children:"BILLING_SERVICE"}),e(c.span,{style:{color:"#FAB387"},children:")"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" private"}),e(c.span,{style:{color:"#CBA6F7"},children:" readonly"}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" billing"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IBillingService"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:" {}"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" getBalance"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:"Decimal"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"billing"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"getBalance"}),e(c.span,{style:{color:"#CDD6F4"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" AccountQuery"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"customerBalance"}),e(c.span,{style:{color:"#CDD6F4"},children:"(customerId)"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" settleOrder"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:"params"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" orderId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" amount"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4",fontStyle:"italic"},children:" fee"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" })"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#CBA6F7"},children:"void"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" await"}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"billing"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"postTransaction"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" externalId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" params"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orderId"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" entries"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" ["})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" {"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" account"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" AccountQuery"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"customerBalance"}),e(c.span,{style:{color:"#CDD6F4"},children:"(params"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"customerId)"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" amount"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" params"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"amount"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"neg"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" },"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" {"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" account"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" AccountQuery"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"revenue"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" amount"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" params"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"fee"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" },"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" {"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" account"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" AccountQuery"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"providerPayable"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" amount"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" params"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"amount"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"sub"}),e(c.span,{style:{color:"#CDD6F4"},children:"(params"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"fee)"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" },"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" ]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"}"})})]})})]}),"\n",n(c.p,{children:["The adapter knows about both worlds — it maps the order port's vocabulary to the billing service's API. The order module never sees ",e(c.code,{children:"AccountQuery"}),", ",e(c.code,{children:"postTransaction"}),", or ledger entries. If the billing module changes its internal API, only this adapter needs updating."]}),"\n",n(c.p,{children:["For simpler cross-context calls, the adapter often uses the CQRS ",e(c.code,{children:"QueryBus"})," instead of a direct service injection:"]}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"infra/adapters/order-customer.adapter.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"@Injectable"}),e(c.span,{style:{color:"#FAB387"},children:"()"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" class"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" OrderCustomerAdapter"}),e(c.span,{style:{color:"#CBA6F7"},children:" implements"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IOrderCustomerPort"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" constructor"}),e(c.span,{style:{color:"#9399B2"},children:"("}),e(c.span,{style:{color:"#CBA6F7"},children:"private"}),e(c.span,{style:{color:"#CBA6F7"},children:" readonly"}),e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" queryBus"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" QueryBus"}),e(c.span,{style:{color:"#9399B2"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:" {}"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" getCustomersByIds"}),e(c.span,{style:{color:"#9399B2"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#EBA0AC",fontStyle:"italic"},children:" ids"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" string"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:"[]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" )"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" Promise"}),e(c.span,{style:{color:"#89DCEB"},children:"<"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:"CustomerSummary[]"}),e(c.span,{style:{color:"#89DCEB"},children:">"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#F38BA8"},children:" this"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"queryBus"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"execute"}),e(c.span,{style:{color:"#CDD6F4"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7",fontWeight:"bold"},children:" new"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" GetCustomersByIdsQuery"}),e(c.span,{style:{color:"#CDD6F4"},children:"(ids)"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"}"})})]})})]}),"\n",n(c.p,{children:["The ",e(c.code,{children:"QueryBus"})," ensures the two modules don't import each other. Module boundaries stay clean."]}),"\n",e(c.h2,{children:"Module as bounded context boundary"}),"\n",e(c.p,{children:"The NestJS module is where port-to-adapter bindings live:"}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"orders.module.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"@Module"}),e(c.span,{style:{color:"#FAB387"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" imports"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#FAB387"},children:" ["}),e(c.span,{style:{color:"#CDD6F4"},children:"CqrsModule"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#CDD6F4"},children:" BillingModule"}),e(c.span,{style:{color:"#FAB387"},children:"]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" providers"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#FAB387"},children:" ["})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#94E2D5"},children:" ..."}),e(c.span,{style:{color:"#CDD6F4"},children:"commandHandlers"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#94E2D5"},children:" ..."}),e(c.span,{style:{color:"#CDD6F4"},children:"queryHandlers"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#94E2D5"},children:" ..."}),e(c.span,{style:{color:"#CDD6F4"},children:"eventHandlers"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" {"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" provide"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" ORDER_REPOSITORY"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" useClass"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" PrismaOrderRepository"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" },"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" {"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" provide"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" ORDER_BILLING_PORT"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" useClass"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" OrderBillingAdapter"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" },"})}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" {"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" provide"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" ORDER_CUSTOMER_PORT"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" useClass"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" OrderCustomerAdapter"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" },"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" ]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#FAB387"},children:" exports"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#FAB387"},children:" ["}),e(c.span,{style:{color:"#CDD6F4"},children:"ORDER_REPOSITORY"}),e(c.span,{style:{color:"#FAB387"},children:"]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:"}"}),e(c.span,{style:{color:"#FAB387"},children:")"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:"export"}),e(c.span,{style:{color:"#CBA6F7"},children:" class"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" OrdersModule"}),e(c.span,{style:{color:"#9399B2"},children:" {}"})]})]})})]}),"\n",e(c.p,{children:"Swapping adapters is a one-line change. In tests, you don't even use the module — you instantiate handlers directly."}),"\n",e(c.p,{children:"For conditional adapter selection (e.g., a stub payment provider in non-production):"}),"\n",e(c.figure,{"data-rehype-pretty-code-figure":"",children:e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"{"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" provide"}),e(c.span,{style:{color:"#9399B2"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" PAYMENT_PROVIDER_PORT"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" useFactory"}),e(c.span,{style:{color:"#9399B2"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" ("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" config: ConfigService"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" stripe: StripeAdapter"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" stub"}),e(c.span,{style:{color:"#94E2D5"},children:"?:"}),e(c.span,{style:{color:"#CDD6F4"},children:" StubPaymentAdapter"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" ) "}),e(c.span,{style:{color:"#94E2D5"},children:"=>"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" if"}),e(c.span,{style:{color:"#CDD6F4"},children:" (stub "}),e(c.span,{style:{color:"#94E2D5"},children:"&&"}),e(c.span,{style:{color:"#CDD6F4"},children:" config"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"get"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'NODE_ENV'"}),e(c.span,{style:{color:"#CDD6F4"},children:") "}),e(c.span,{style:{color:"#94E2D5"},children:"!=="}),e(c.span,{style:{color:"#A6E3A1"},children:" 'production'"}),e(c.span,{style:{color:"#CDD6F4"},children:") "}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#CDD6F4"},children:" stub"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" }"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" return"}),e(c.span,{style:{color:"#CDD6F4"},children:" stripe"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" },"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" inject"}),e(c.span,{style:{color:"#9399B2"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" ["})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" ConfigService"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" StripeAdapter"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" {"}),e(c.span,{style:{color:"#CDD6F4"},children:" token"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" StubPaymentAdapter"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#CDD6F4"},children:" optional"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#FAB387"},children:" true"}),e(c.span,{style:{color:"#9399B2"},children:" },"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" ]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:"}"})})]})})}),"\n",e(c.h2,{children:"The testing payoff"}),"\n",e(c.p,{children:"Here's where it pays off. Command handler tests with zero framework:"}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"place-order.handler.spec.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"describe"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'PlaceOrderHandler'"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#9399B2"},children:" ()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" let"}),e(c.span,{style:{color:"#CDD6F4"},children:" handler"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" PlaceOrderHandler"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" let"}),e(c.span,{style:{color:"#CDD6F4"},children:" orderRepo"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" InMemoryOrderRepository"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" let"}),e(c.span,{style:{color:"#CDD6F4"},children:" billing"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" IOrderBillingPort"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" beforeEach"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" orderRepo "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CBA6F7",fontWeight:"bold"},children:" new"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" InMemoryOrderRepository"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" billing "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" getBalance"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#9399B2"},children:" ()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#CBA6F7",fontWeight:"bold"},children:" new"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'1000'"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" freezeBalance"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#9399B2"},children:" ()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#CBA6F7"},children:" undefined"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" settleOrder"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#9399B2"},children:" ()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#CBA6F7"},children:" undefined"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2"},children:" };"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" handler "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CBA6F7",fontWeight:"bold"},children:" new"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" PlaceOrderHandler"}),e(c.span,{style:{color:"#CDD6F4"},children:"(orderRepo"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#CDD6F4"},children:" billing)"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" it"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'creates an order and freezes the balance'"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#CBA6F7"},children:" async"}),e(c.span,{style:{color:"#9399B2"},children:" ()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" freezeSpy "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CDD6F4"},children:" vi"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"spyOn"}),e(c.span,{style:{color:"#CDD6F4"},children:"(billing"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#A6E3A1"},children:" 'freezeBalance'"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" result "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CBA6F7"},children:" await"}),e(c.span,{style:{color:"#CDD6F4"},children:" handler"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"execute"}),e(c.span,{style:{color:"#CDD6F4"},children:"("})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7",fontWeight:"bold"},children:" new"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" PlaceOrderCommand"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'customer-1'"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#CDD6F4"},children:" ["})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" {"}),e(c.span,{style:{color:"#CDD6F4"},children:" productId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#A6E3A1"},children:" 'p1'"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#CDD6F4"},children:" quantity"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#FAB387"},children:" 2"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#CDD6F4"},children:" price"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7",fontWeight:"bold"},children:" new"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'25'"}),e(c.span,{style:{color:"#CDD6F4"},children:") "}),e(c.span,{style:{color:"#9399B2"},children:"},"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" ])"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" )"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" expect"}),e(c.span,{style:{color:"#CDD6F4"},children:"(result"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orderId)"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"toBeDefined"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" expect"}),e(c.span,{style:{color:"#CDD6F4"},children:"(orderRepo"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders)"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"toHaveLength"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#FAB387"},children:"1"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" expect"}),e(c.span,{style:{color:"#CDD6F4"},children:"(orderRepo"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orders["}),e(c.span,{style:{color:"#FAB387"},children:"0"}),e(c.span,{style:{color:"#CDD6F4"},children:"]"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"status)"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"toBe"}),e(c.span,{style:{color:"#CDD6F4"},children:"(OrderStatus"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#FAB387"},children:"PENDING"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" expect"}),e(c.span,{style:{color:"#CDD6F4"},children:"(freezeSpy)"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"toHaveBeenCalledWith"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" orderId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" result"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#CDD6F4"},children:"orderId"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" customerId"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#A6E3A1"},children:" 'customer-1'"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" amount"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CBA6F7",fontWeight:"bold"},children:" new"}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" Decimal"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'50'"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:"}"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]})]})})]}),"\n",n(c.p,{children:["No ",e(c.code,{children:"TestingModule.compile()"}),". No database. No ",e(c.code,{children:"beforeAll"})," setup that takes 2 seconds. Just plain objects."]}),"\n",n(c.p,{children:["The ",e(c.code,{children:"InMemoryOrderRepository"})," is a real implementation of the port interface — it behaves correctly for find/save operations. The billing port is an inline object literal because we only need to verify it was called with the right arguments."]}),"\n",e(c.p,{children:"These tests run in under 10ms. You can have hundreds of them and your test suite stays fast."}),"\n",e(c.h3,{children:"The asymmetry with query tests"}),"\n",n(c.p,{children:["Query handlers intentionally skip this pattern. They inject ",e(c.code,{children:"PrismaService"})," directly and run ",e(c.code,{children:"findMany"})," with ",e(c.code,{children:"select"})," projections — no repository, no entity rehydration. So query tests are integration tests that need a real database."]}),"\n",e(c.p,{children:"This is intentional, not lazy. Query tests need to verify the actual SQL/Prisma query returns the right shape. Mocking Prisma would be testing your mocks, not your queries."}),"\n",n(c.figure,{"data-rehype-pretty-code-figure":"",children:[e(c.figcaption,{"data-rehype-pretty-code-title":"","data-language":"ts","data-theme":"catppuccin-mocha",children:"list-orders.handler.spec.ts"}),e(c.pre,{style:{backgroundColor:"#1e1e2e",color:"#cdd6f4"},tabIndex:"0","data-language":"ts","data-theme":"catppuccin-mocha",children:n(c.code,{"data-language":"ts","data-theme":"catppuccin-mocha",style:{display:"grid"},children:[e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2",fontStyle:"italic"},children:"// This IS an integration test — needs a test database"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"describe"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#A6E3A1"},children:"'ListOrdersHandler'"}),e(c.span,{style:{color:"#9399B2"},children:","}),e(c.span,{style:{color:"#9399B2"},children:" ()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" let"}),e(c.span,{style:{color:"#CDD6F4"},children:" handler"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" ListOrdersHandler"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" let"}),e(c.span,{style:{color:"#CDD6F4"},children:" prisma"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" PrismaService"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:" beforeAll"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#CBA6F7"},children:"async"}),e(c.span,{style:{color:"#9399B2"},children:" ()"}),e(c.span,{style:{color:"#94E2D5"},children:" =>"}),e(c.span,{style:{color:"#9399B2"},children:" {"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CBA6F7"},children:" const"}),e(c.span,{style:{color:"#CDD6F4"},children:" module "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#CBA6F7"},children:" await"}),e(c.span,{style:{color:"#CDD6F4"},children:" Test"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"createTestingModule"}),e(c.span,{style:{color:"#CDD6F4"},children:"("}),e(c.span,{style:{color:"#9399B2"},children:"{"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" imports"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" [PrismaModule]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" providers"}),e(c.span,{style:{color:"#94E2D5"},children:":"}),e(c.span,{style:{color:"#CDD6F4"},children:" [ListOrdersHandler]"}),e(c.span,{style:{color:"#9399B2"},children:","})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"compile"}),e(c.span,{style:{color:"#CDD6F4"},children:"()"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" handler "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" module"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"get"}),e(c.span,{style:{color:"#CDD6F4"},children:"(ListOrdersHandler)"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#CDD6F4"},children:" prisma "}),e(c.span,{style:{color:"#94E2D5"},children:"="}),e(c.span,{style:{color:"#F9E2AF",fontStyle:"italic"},children:" module"}),e(c.span,{style:{color:"#94E2D5"},children:"."}),e(c.span,{style:{color:"#89B4FA",fontStyle:"italic"},children:"get"}),e(c.span,{style:{color:"#CDD6F4"},children:"(PrismaService)"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:" }"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]}),"\n",e(c.span,{"data-line":"",children:" "}),"\n",e(c.span,{"data-line":"",children:e(c.span,{style:{color:"#9399B2",fontStyle:"italic"},children:" // seed data, run query, assert shape"})}),"\n",n(c.span,{"data-line":"",children:[e(c.span,{style:{color:"#9399B2"},children:"}"}),e(c.span,{style:{color:"#CDD6F4"},children:")"}),e(c.span,{style:{color:"#9399B2"},children:";"})]})]})})]}),"\n",n(c.p,{children:["The testing asymmetry is a feature: ",e(c.strong,{children:"commands test domain logic fast (in-memory), queries test data access correctly (real DB)"}),". Trying to unify them with one approach makes both worse."]})]})}return{default:function(l={}){const{wrapper:n}=l.components||{};return n?e(n,{...l,children:e(_createMdxContent,{...l})}):_createMdxContent(l)}};