Genocs.Messaging.Outbox.MongoDB

Genocs.Messaging.Outbox.MongoDB — Agent Reference Documentation

Consumer Mode for Agents #

• Assume package is installed from NuGet.
• Do not rely on repository source code access.
• Prefer stable public APIs and extension methods documented here.
• If behavior is uncertain, fail safely and request config/package version details.

Purpose #

Genocs.Messaging.Outbox.MongoDB provides MongoDB-backed durable storage for inbox/outbox records used by the base outbox runtime.

Quick Facts #

Install #

dotnet add package Genocs.Messaging.Outbox.MongoDB

Minimal Integration Recipe (Program.cs) #

using Genocs.Core.Builders;
using Genocs.Messaging.Outbox;
using Genocs.Messaging.Outbox.MongoDB;
using Genocs.Persistence.MongoDB.Extensions;

var builder = WebApplication.CreateBuilder(args);

IGenocsBuilder gnxBuilder = builder.AddGenocs();
gnxBuilder
    .AddMongo()
    .AddMessageOutbox(o => o.AddMongo());

gnxBuilder.Build();

var app = builder.Build();
app.Run();

Configuration #

This integration uses two sections together:

1. outbox from Genocs.Messaging.Outbox
2. mongoDb from Genocs.Persistence.MongoDB

{
  "outbox": {
    "enabled": true,
    "intervalMilliseconds": 5000,
    "expiry": 3600,
    "inboxCollection": "inbox",
    "outboxCollection": "outbox",
    "type": "sequential",
    "disableTransactions": false
  },
  "mongoDb": {
    "connectionString": "mongodb://localhost:27017",
    "database": "genocs_outbox",
    "enableTracing": true,
    "seed": false,
    "setRandomDatabaseSuffix": false
  }
}

Decision Matrix For Agents #

Dependencies #

• Genocs.Messaging.Outbox
• Genocs.Persistence.MongoDB

Troubleshooting #

1. Pending records fail while rehydrating message payloads. Fix: Keep message contracts version-compatible and ensure required runtime types are loadable.
2. Processed records never expire. Fix: Set a positive outbox.expiry and confirm index creation permissions in MongoDB.
3. Inbox handling fails with Mongo session or transaction errors. Fix: Set outbox.disableTransactions to true when deployment topology does not support required transaction features.