GlobalLastUpdate Object

Provides atomic access to a global lastUpdate counter shared between C++ and Kotlin via a DirectByteBuffer backed by native memory.

Reads (GlobalLastUpdate.get) are JNI-free — they go straight to the shared native memory through the ByteBuffer. Atomic increments (GlobalLastUpdate.incAndGet) use a @CriticalNative JNI call (~25 ns, ~5x faster than regular JNI) into the C++ singleton.

TODO: When the compile SDK is bumped to 33+, replace the JNI increment with a fully JNI-free VarHandle.getAndAdd path via MethodHandles.byteBufferViewVarHandle(LongArray::class.java, ByteOrder.nativeOrder()). VarHandle provides atomic read-modify-write directly on a DirectByteBuffer without crossing the JNI boundary.

object GlobalLastUpdate

fun get(): ULong

fun incAndGet(): ULong