feat: serialize named tuples as dicts

[maffettone]

Take advantage of dependent PR in Tiled to serialize NamedTuple like objects as dictionaries.

Description

Add function to be consumed as default serialization.

Motivation and Context

This default functionality was removed from orjson in version 3.10, and causes problems with Bluesky use (e.g., hklpy).

How Has This Been Tested?

[maffettone]

Tagging @ambarb for visibility.

[danielballan]

I appreciate the effort to isolate and target this fix. Unfortunately, as we look toward migrating the facility off of mongo_normalized during 2025, this fix would be short-lived.

At the moment, databroker registers a custom endpoint with the Tiled FastAPI Router, POST /documents/{path}, which you are customizing here, and blueksy_tiled_plugins.CatalogOfBlueskyRuns.post_document calls it. But in the future (and already at HEX) the bluesky.callbacks.tiled_writer.TiledWriter will be used, and it will send metadata from the start document at the vanilla POST /metadata endpoint.

Other options:

• Make Tiled tolerate namedtuple and perhaps other by default. (I don't love this. I think orjson is right that there is no unambigous JSON serialization of namedtuple.)
• Merge this fix, and add tolerant JSON serialization into TiledWriter as well. Tiled would need a way to expose this in tiled.client.container.Container.new().
• In the Device, use a serializable type.