---
title: Features OIP
slug: oip-next/eIIM-bonnes-pratiques-de-conception
icon: {"lucideIcon":"📘"}
createdAt: 2026-03-19T09:26:56.000Z
---

# FeatureOptions

```typescript
type FeatureOptions = {
  service?: {
    url: string;
    apiKey: string;
  };
  rabbitmq?: {
    messageBuilder: (response: unknown) => {
      message: unknown;
      queue: string;
    };
  };
  onUpdateTaskState?: (args: {
    error?: string;
    metadata?: unknown;
    state: {
      status: string;
      statusCode: number;
    };
  }) => Promise<void>;
};
```

## Options

### service

Configuration du service externe utilisé par la feature.

```typescript
service?: {
  url: string;
  apiKey: string;
}
```

Usage :

- endpoint d’un service tiers&#x20;
- authentification API

### `rabbitmq`

Configuration de publication d’événements.

```typescript
rabbitmq?: {
  messageBuilder: (response: unknown) => {
    message: unknown;
    queue: string;
  };
}
```

`messageBuilder` doit au minimum renvoyer :

- `message`&#x20;
- `queue`&#x20;

### `onUpdateTaskState`

Handler optionnel de mise à jour d’état de task.

```typescript
onUpdateTaskState?: (args: {
  error?: string;
  metadata?: unknown;
  state: { status: string; statusCode: number };
}) => Promise<void>;
```

Le paramètre `taskState` permet de définir les statuts à appliquer à la task pendant l’exécution de la feature.

## When to use

Utiliser `taskState` si la feature :

- démarre un traitement traçable&#x20;
- doit notifier un succès&#x20;
- doit notifier un échec

### Exemple

```typescript
const taskState = {
  starting: { status: 'STARTED', statusCode: 102 },
  success: { status: 'DONE', statusCode: 200 },
  failure: { status: 'FAILED', statusCode: 500 }
};
```
