Maybe this will help some developers; I've found the issue, at least on my end.
TLDR: My previous hunch was correct. If you're not developing using native Swift/Obj-C you might be looking at needing an entire framework change to accommodate the Triple Lens.
Here's a quick fix if your app is a native iOS app:
Using AVCaptureDiscoverySession, list out all of your cameras. AVCaptureDeviceTypeBuiltInTripleCamera should be one of them if you're on iPhone 14 Pro; usually, this is index 7. You need to select this rather than the "rear camera" (index 0) when starting up your capture session, in order to use the Triple Camera functionality. It should auto-handle focusing and swapping between the lens (you can actually select only the Macro Lens / ultra-wide lens as well, but that removes the ability to let iOS's backend handle the lens swapping).
Here's why it's bad if you're not developing for native iOS (i.e., Flutter/Qt/Xamarin/React Native):
I'll use Qt as an example, since that's what is giving me trouble. The LTS version of Qt 5 has enumerations for only the "front" and "rear" cameras. When you use Qt to access the available cameras, it only lists out Apple's designators for those two cams (indices 0 and 1), and will only let you choose from those two lenses. If I try to force my camera object to use a device ID like the Triple Camera one, it forces it back into the default "rear camera" state, presumably because Qt 5 doesn't support controls for it. This means that I simply cannot use the Triple Camera through Qt. It seems like I would have to create an entirely new interface that pulls the camera directly from apple's native camera or change to another framework. There's a lot of reasons one could infer about why neither solution is desirable for a business that has an established codebase.
Check if your framework supports using Macro Lens/ Triple Cam device ids.
What could Apple do to mitigate this?
I'll be honest, as a dev myself it is frustrating that the Triple Camera isn't just interfaced to the "rear camera" device ID by default on the iPhone 14 Pro. I cannot imagine a scenario where an app that uses the camera in a one-dimensional way (i.e., an app that isn't used to gain extreme control over the camera) would not just want to use the Triple Cam like the default one. Releasing a new phone with an incredibly long minimum focus distance that requires special control to use up close is, in my opinion, bad foresight considering most APIs use the "general-purpose" rear camera accessor.
You may be asking "Why did no one care about this with the iPhone 13 Pro?" and that's because the minimum focus distance for the iPhone 13 Pro's normal camera was short enough that it didn't break document scanning apps. No one noticed it then, so no one thought to try and swap to the Triple Cam in their apps. But now that the 14 Pro increased that distance so much, it seems like the solution should be "let people who try to use the general purpose rear camera on the iPhone 14 Pro have their API calls redirected to the Triple Camera."