---
title: Résoudre des métadonnées de session
slug: oip-next/TaZj-resoudre-des-metadonnees-de-session
icon: {"lucideIcon":"📘"}
createdAt: 2026-06-03T16:25:39.000Z
---

# Vue d'ensemble

`resolveMetadata` est une fonction de rappel optionnelle passée en paramètre de la fonction `start` via l'option `session.resolveMetadata` dans le fichier `server/index.mjs`. Elle est exécutée lors de la résolution de l'entité Project, au moment du décrochage sur l'OAV.

Elle permet de résoudre des métadonnées arbitraires qui seront enregistrées dans la session. Une fois stockées, ces métadonnées sont accessibles depuis n'importe quel middleware ou route personnalisée via `req.session.projects`.

# Prérequis

- Un projet utilisant le **framework OIP**
- Version **4.1.0 ou supérieure** de la bibliothèque `@fasstech/oip-starter-utils`

# La fonction de rappel `session.resolveMetadata`

## Signature

`resolveMetadata` est une propriété optionnelle de `ServerConfig.session` dont la signature est la suivante :

:::BlockQuote
*async* (args: \{ **projectId**: string; **sessionId**: string }) => **Object**
:::

Elle reçoit en argument un objet contenant :

- `projectId` : l'identifiant de l'entité Project résolue
- `sessionId` : l'identifiant de session courant
- `clientId` : l'identifiant de la connexion client (disponible à partir de la version 4.3.0)

La fonction doit retourner un objet dont la valeur résolue sera enregistrée dans `req.session.projects[i].metadata`.

## Flux d'exécution

1. Lors du décrochage sur l'OAV, la résolution de l'entité Project est déclenchée.
2. L'entité Project est résolue : le `projectId` est validé.
3. `resolveMetadata` est appelée avec `{ projectId, sessionId, clientId }`.
4. La valeur retournée est enregistrée dans `req.session.projects[i].metadata`.
5. Les métadonnées sont ensuite accessibles depuis tout middleware ou route personnalisée via `req.session.projects`.

## Implémentation

Déclarer `resolveMetadata` dans la configuration serveur et créer le fichier de rappel dédié. Les arguments `projectId`, `sessionId` et `clientId` sont disponibles pour effectuer les appels nécessaires (base de données, API tierce, etc.) et construire l'objet de métadonnées à retourner.

:::CodeblockTabs
index.mjs

```javascript
import { start } from "@fasstech/oip-starter-utils/server";
import { resolveMetadata } from "./resolve-metadata.mjs";

const serverConfig = {
  session: {
    // ...
    resolveMetadata
  }
  // ...
};

const { app } = await start(serverConfig);

// init your business logic here
void app;
```

resolve-metadata.mjs

```javascript
export const resolveMetadata = async ({ projectId, sessionId }) => {
  // resolve some data here

  const metadata = {
    something: 42
  };

  return metadata;
};
```
:::

## Accéder aux métadonnées depuis un middleware

### Structure de `req.session.projects`

Une fois `resolveMetadata` exécutée, l'objet session expose la structure suivante :

```javascript
req.session.projects: {
  projectId: string;
  clientId: string;
  metadata?: unknown;
}[]
```

### Récupérer les métadonnées du projet courant

Le projet courant est identifié via le header HTTP `x-fasst-project-id`, transmis automatiquement par le framework à chaque requête. Pour accéder aux métadonnées associées depuis un middleware ou une route personnalisée :

```javascript
const myMiddleware = (req, res, next) => {
  const projectId = req.get("x-fasst-project-id");
  const project = req.session.projects?.find((p) => p.projectId === projectId);
  const metadata = project?.metadata;

  // use metadata here

  next();
};
```

Ce pattern permet de cibler précisément le projet actif parmi l'ensemble des projets enregistrés en session.

# Résumé

- `resolveMetadata` est une fonction de rappel **optionnelle** à déclarer dans `ServerConfig.session`.
- Elle est appelée automatiquement lors de la résolution de l'entité Project au décrochage sur l'OAV.
- Elle reçoit `{ projectId, sessionId, clientId }` et doit retourner un objet.
- La valeur retournée est enregistrée dans `req.session.projects[i].metadata` et persiste pour la durée de la session.
- Les métadonnées sont accessibles depuis n'importe quel middleware ou route via `req.session.projects`, en filtrant sur le `projectId` transmis par le header `x-fasst-project-id`.
- Nécessite la version **4.1.0 ou supérieure** de `@fasstech/oip-starter-utils`.
