nitro 0.3.3

High-performance Native Modules for Flutter (Nitro Modules equivalent). Runtime support for .native.dart spec generated bridges.

0.3.3

• Improved: Ecosystem Sync — Synchronized to version 0.3.3.

0.3.2

• Improved: Ecosystem Sync — Synchronized to version 0.3.2.
• Improved: Nested @HybridStruct integration — Works seamlessly with nitro_generator 0.3.2, which now generates correct Pointer<NestedFfi> types, recursive freeFields(), and typed toNative()/toDart() for nested struct fields.
• Improved: Struct constructor styles — Generated FFI extensions respect positional and named constructor parameters as declared in your .native.dart spec, so toDart() calls always match the actual constructor signature.

0.3.1

• Improved: IsolatePool — persistent reply port — replaced per-call ReceivePort allocation with a single pool-level port kept alive for the pool's lifetime. Each call is tagged with a monotonically-increasing callId; a Map<int, Completer> demuxes responses without any OS port operation per call.

• Improved: IsolatePool — least-busy scheduling — replaced round-robin with a per-worker in-flight counter; the dispatcher always picks the worker with the fewest pending calls, preventing a slow JNI/FFI call from blocking the next task.

• Improved: IsolatePool — Completer.sync() — reply completers use Completer.sync() to deliver values in the same microtask as the port message, removing one extra microtask hop per async call.

• Improved: IsolatePool.dispose() — now idempotent; in-flight calls are completed with StateError so awaiting code never hangs; the reply port is closed and worker shutdown is signalled gracefully.

• New: IsolatePool tests — 21 tests covering pool creation, return values, error propagation, callId uniqueness, least-busy scheduling, dispose idempotency, in-flight cancellation, and stress scenarios.

• New: LazyRecordList<T> — record_codec.dart gains a ListBase<T> implementation backed by a raw Pointer<Uint8> and a pre-parsed offset table. Items are decoded on first access and cached; a NativeFinalizer backed by malloc.nativeFree frees the buffer on GC.

• New: RecordWriter.encodeIndexedList<T> — serialises a list of records into the indexed wire format: [int32 count | int64[count] byte_offsets | item_blobs...], enabling O(1) random access by the Dart reader.

• New: RecordWriter.encodeIndexedPrimitiveList<T> — same indexed format for primitive-typed lists.

• New: RecordReader.fromPayloadOffset(Pointer<Uint8>, int) — constructs a reader at an arbitrary byte offset within an existing payload, used by LazyRecordList to decode individual items on demand.

0.3.0

• Breaking: C++ Interface Pointer Generation — The C++ bridge generator now generates void* interface pointers instead of concrete class pointers for HybridObject types.
  • Impact: Existing C++ code that directly casts these pointers to concrete types will break and require updates.
  • Benefit: This change ensures compatibility with the new C++ build system and allows for more flexible native module integration.
• Improved: Memory Safety: FFI generated code now uses try-finally blocks for all async and sync record/struct return paths, ensuring malloc.free is called even if decoding fails.
• Improved: Thread Safety: The HybridObject implementation now enforces checkDisposed() guards on all native methods, including Fast variants, to prevent use-after-dispose crashes.
• Fixed: Fail-Fast Initialization: NitroRuntime now explicitly validates return codes from native initialization (e.g., Dart_InitializeApiDL). If initialization fails, a StateError is thrown immediately instead of failing silently later.

0.2.3

• Improved: Native Visibility Visibility: Updated nitro.h to include NITRO_EXPORT macros by default, ensuring all native symbols are correctly exported for FFI across iOS, Android, macOS, and Windows.
• Improved: Dependency Sync: Synchronized the Nitro ecosystem to version 0.2.3.

0.2.2

• Improved: annotation compatibility — verified full compatibility with Nitrogen 0.2.2's stable annotation resolution system, ensuring re-exported @NitroModule, @HybridStruct, and @HybridEnum annotations are correctly identified by the code generator.
• Added explicit void support in return types for all HybridObject methods.

0.2.1

• Moved all annotations to the separate nitro_annotations package to improve generator platform compatibility.
• Re-exported nitro_annotations for backward compatibility.
• Added explicit support for macos, windows, and linux to the plugin configuration to resolve pub.dev platform detection warnings.

0.2.0

• New: Binary RecordWriter and RecordReader Codec — Compact little-endian protocol for @HybridRecord types, replacing JSON text serialization with direct binary field access over raw uint8_t* buffers.
  • Wire format: int64 (8B), float64 (8B), bool (1B), String (4-byte length + UTF-8), nullable (1-byte tag), and list (4-byte count).
  • High-performance encodeList / decodeList for collections of records or primitives.
  • Retains dart:convert re-exports for Map<String, T> which still uses the JSON path.
• New: IsolatePool & NitroRuntime.init() — Fixed-size pool of persistent worker isolates with round-robin dispatch. Pre-warmed by init() to eliminate the ~1–5 ms Isolate.spawn overhead on every callAsync.
• New: NitroConfig Runtime Singleton — Configurable runtime behavior:
  • debugMode: Enables verbose logging of bridge calls, streams, isolates, and lifecycles.
  • logLevel: Granular control (none, error, warning, verbose).
  • logHandler: Custom sink for logs (e.g., Firebase, Sentry, Crashlytics).
  • slowCallThresholdUs: Configurable warning threshold for long-running async calls (default 16ms).
• Improved: NitroRuntime Robustness — Stream unpack errors are now always logged at error level with stack traces, ensuring they are never silently swallowed. Added debugLabel to streams for easier debugging.
• Fix: Style & Linting — Renamed internal state variables (e.g., _released → released) to follow Dart conventions for local variables.

0.1.0

• Initial release of Nitro runtime.
• Support for HybridObject, HybridStruct, and HybridEnum.
• Support for synchronous and asynchronous bridge calls.
• Unified FFI bridge support for Android and iOS.