---
title: "Référence d'API — @nodefony/framework/grpc"
source: docs/api/framework/grpc.md
url: https://nodefony.net/docs/api/framework/grpc/
---


[Documentation](../../../) › [Référence d'API](../../) › [`@nodefony/framework`](../) › grpc

> Générée depuis les déclarations de types publiées de `@nodefony/framework` **10.0.0-beta.7** : exactement ce que reçoit une application qui l'installe. Cette page n'existe dans aucun dépôt — pour la corriger, on corrige le TSDoc du code.

## `@nodefony/framework/grpc`

`import { … } from "@nodefony/framework/grpc"` — 3 symboles.

### Classes (1)

#### `GrpcController`

```ts
abstract class GrpcController extends Controller
```

Classe de base d'un point d'entrée gRPC (ADR-0026 D1), jumelle de `RealtimeController` : marquée par `@GrpcService(Contrat)`, déclarée par `@controllers([...])`. Chaque méthode du contrat est une méthode de la classe, appelée par l'adaptateur Connect avec `(request, HandlerContext)` ; la logique métier vit dans un service injecté.

- `static assertScope(): void` — Vérifie la déclaration gRPC de la classe et fige ses routes — au démarrage (`Router.setController`), jamais à la première requête.
- `serveGrpc(): void | Promise<void>` — L'action de base de toute route gRPC : remet la requête et la réponse brutes à l'adaptateur, qui appelle la méthode du contrat et écrit la réponse.

### Fonctions (1)

#### `GrpcService`

```ts
function GrpcService<S extends DescService>(service: S): <C extends GrpcServiceClass<S>>(ctor: C) => C
```

Déclare un contrôleur comme le point d'entrée du service gRPC `service` (le descripteur généré par `buf`, ex. `EchoService` de `echo_pb.ts`).

### Types (1)

#### `GrpcServiceClass`

```ts
type GrpcServiceClass<S extends DescService> = new (...args: never[]) => GrpcController & ServiceImpl<S>
```

Une classe qui peut servir le contrat `S` : elle étend `GrpcController` et implémente CHAQUE méthode du contrat avec sa signature générée. Une méthode manquante ou mal typée ne compile pas.

---

[← Toutes les références d'API](../../)
