# AddPersistedOperationStore

Registers [IPersistedOperationStore](/docs/sdk-reference/persisted-operations/i-persisted-operation-store)
and [IPersistedOperationsService](/docs/sdk-reference/persisted-operations/i-persisted-operations-service)
on a host that does not serve GraphQL: a CI manifest uploader, admin tooling, a console client.
Declared on the static class `ServiceCollectionPersistedOperationsExtensions`; `configure` receives a
`PersistedOperationStoreBuilder`.

## Signatures

```csharp fragment
public static IServiceCollection AddPersistedOperationStore(
    this IServiceCollection services,
    Action<PersistedOperationStoreBuilder> configure);

// Obsolete: a compile error.
public static IServiceCollection AddPersistedOperationStore(
    this IServiceCollection services,
    string databaseConnectionString);

// Obsolete.
public static IServiceCollection AddPersistedOperationStore(
    this IServiceCollection services,
    string databaseConnectionString,
    string rabbitMqInvalidationConnectionString);

public sealed class PersistedOperationStoreBuilder
{
    public PersistedOperationStoreBuilder UseRabbitMqInvalidation(string connectionString);
    public PersistedOperationStoreBuilder SingleNode();
    public PersistedOperationStoreBuilder GateManagement(string? policy = null, string? roles = null);
    public PersistedOperationStoreBuilder GateManagementToAuthenticatedUsers();
}
```

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `services` | `IServiceCollection` | The service collection. The host also registers the Trax data layer (`AddTrax(t => t.AddEffects(e => e.UsePostgres(...)))`), which the store reads and writes through |
| `configure` | `Action<PersistedOperationStoreBuilder>` | Says how a change made through the store reaches the GraphQL nodes |

| `PersistedOperationStoreBuilder` method | Description |
|-----------------------------------------|-------------|
| `UseRabbitMqInvalidation(connectionString)` | Broadcast every change over the broker the GraphQL nodes use with their own `UseRabbitMqInvalidation`, so each empties its caches. Throws `ArgumentException` for a blank connection string |
| `SingleNode()` | Declare that no other process caches these operations: this one serves them itself, or nothing serves them while it writes. Nothing checks the claim; a GraphQL node elsewhere sees a change only when its cached entry reaches its maximum age |
| `GateManagement(policy, roles)` | Declare who may manage documents through this process's surfaces, the dashboard's pages. The same rules as [UsePersistedOperations](/docs/sdk-reference/persisted-operations/use-persisted-operations)' `GateManagement`: a policy or roles is required, a comma-separated role list is any of, repeated calls are all of. Without it the dashboard shows no management pages. Code calling the service with no person behind it is not gated |
| `GateManagementToAuthenticatedUsers()` | Let any authenticated person manage documents through the dashboard. Prefer `GateManagement` |

## Returns

The same `IServiceCollection`.

## Behavior

- Throws `ArgumentNullException` for a `null` argument, and `InvalidOperationException` when
  `configure` calls neither builder method or calls both. Both are thrown when
  `AddPersistedOperationStore` runs.
- The one-string overload is a compile error; called through reflection it throws as if
  `configure` did nothing. The two-string overload ignores the first string and forwards to
  `store => store.UseRabbitMqInvalidation(rabbitMqInvalidationConnectionString)`.
- Called alongside [UsePersistedOperations](/docs/sdk-reference/persisted-operations/use-persisted-operations)
  in one host, the GraphQL registration's validator replaces the no-op one.
- Called alongside `UsePersistedOperations` in one host, `UsePersistedOperations`' options are the
  ones in force, whichever call comes first: its gate, enforcement and invalidation. A store that
  declares no gate takes that one. A store whose `GateManagement` differs from the one
  `UsePersistedOperations` declares refuses the host at startup, naming both calls.

### Registered services

| Service | Lifetime | Implementation |
|---------|----------|----------------|
| `PersistedOperationsOptions` | Singleton (TryAdd) | Built with `SingleNode()` or the broker; `UsePersistedOperations` replaces it |
| `IPersistedOperationStore` | Singleton | `DbPersistedOperationStorage` |
| `IPersistedOperationsService` | Singleton (TryAdd) | The shared management service |
| `IPersistedOperationsManagementGate` | Scoped (TryAdd) | The declared management gate, evaluated with the caller's services |
| `IPersistedOperationValidator` | Singleton (TryAdd) | `NoOpPersistedOperationValidator` |
| `IPersistedOperationCache` | Singleton (TryAdd) | A no-op cache |
| `IPersistedOperationBroadcaster` | Singleton (TryAdd) | RabbitMQ with `UseRabbitMqInvalidation`, a no-op with `SingleNode` |
| `TimeProvider` | Singleton (TryAdd) | `TimeProvider.System` |

## Example

```csharp compile
services.AddPersistedOperationStore(store =>
    store.UseRabbitMqInvalidation(rabbitMqConnectionString).GateManagement(roles: "Deployer")
);
```

## See also

- [IPersistedOperationStore](/docs/sdk-reference/persisted-operations/i-persisted-operation-store)
- [IPersistedOperationsService](/docs/sdk-reference/persisted-operations/i-persisted-operations-service)
- [One node or many](/docs/api/persisted-operations#one-node-or-many)