feat(alpha): wire connect→snapshot→disconnect end-to-end (v0.1.0-alpha.1)

First Internal Alpha build per DEC-001. Closes the milestone of 'Flutter UI calls Rust via the typed bridge, Rust connects to a TeamSpeak-compatible server through tsclientlib, returns a typed snapshot, and disconnects cleanly.' Audio remains Beta scope. Promotions from PoC: poc/tsclientlib-connect-spike → crates/chanora_protocol/ New product code: crates/chanora_protocol/src/{dto.rs,adapter.rs} — typed boundary over tsclientlib. Tokio task owns the Connection; public handle communicates via mpsc/oneshot. No tsclientlib types cross out of the crate (SAD-067 / SysDes-011 / SysDes-029). core/chanora_core/src/lib.rs — ChanoraSession composes the protocol crate, enforces the DEC-006 single-connection invariant. crates/chanora_bridge/src/{api.rs,frb_generated.rs} — FRB 2.12.0 bridge per DEC-014. cdylib + staticlib + rlib. Typed BridgeSnapshot / BridgeChannel / BridgeClient / BridgeError DTOs. Process-wide OnceLock<Runtime> + OnceLock<ChanoraSession>. flutter_rust_bridge.yaml at repo root. apps/chanora_flutter/lib/main.dart — Alpha UI: server form, connect button, channel tree, disconnect. apps/chanora_flutter/lib/l10n/app_{en,zh}.arb expanded with the Alpha key set; ARB metadata reaffirms ADR-008 for server-provided content. Generated Dart bindings under apps/chanora_flutter/lib/src/rust/. Empirical verification (2026-05-14): Workspace: cargo check + cargo test clean (workspace tests: all green). Bridge cdylib: target/release/libchanora_bridge.so produced (~15 MB). Flutter: flutter analyze clean; flutter test runs 3/3 green including the alpha_e2e_test that drives the full Dart → FRB → chanora_bridge → chanora_core → chanora_protocol → tsclientlib → UDP → cn.teamspeak.app path. The captured logcat/stdout shows the tsproto resender transitioning Connected → Disconnecting → Disconnected on clean teardown. Architecture changes: - Removed the chanora_core ↔ chanora_bridge cyclic dependency. chanora_core no longer knows the bridge exists; the bridge maps from CoreError. - chanora_bridge crate's #![forbid(unsafe_code)] lint relaxed because FRB-generated glue legitimately uses unsafe at the FFI boundary. Hand-written code remains unsafe-free. Open follow-ups (NOT in this Alpha): - Audio capture/playback wiring into chanora_audio (Beta scope per DEC-001). - Identity persistence via chanora_storage (currently regenerated on every connect). - Per-message diagnostics + redaction (chanora_diagnostics still scaffold). - Reconnect / network-loss recovery. - Mobile (Android) build of the bridge cdylib + UI verification.
2026-05-14 21:37:06 +08:00
parent e0f34009d9
commit 4915ec0a1b
30 changed files with 7504 additions and 206 deletions
@@ -0,0 +1,454 @@
+// GENERATED CODE - DO NOT MODIFY BY HAND
+// coverage:ignore-file
+// ignore_for_file: type=lint
+// ignore_for_file: unused_element, deprecated_member_use, deprecated_member_use_from_same_package, use_function_type_syntax_for_parameters, unnecessary_const, avoid_init_to_null, invalid_override_different_default_values_named, prefer_expression_function_bodies, annotate_overrides, invalid_annotation_target, unnecessary_question_mark
+
+part of 'lib.dart';
+
+// **************************************************************************
+// FreezedGenerator
+// **************************************************************************
+
+// dart format off
+T _$identity<T>(T value) => value;
+/// @nodoc
+mixin _$BridgeError {
+
+
+
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is BridgeError);
+}
+
+
+@override
+int get hashCode => runtimeType.hashCode;
+
+@override
+String toString() {
+  return 'BridgeError()';
+}
+
+
+}
+
+/// @nodoc
+class $BridgeErrorCopyWith<$Res>  {
+$BridgeErrorCopyWith(BridgeError _, $Res Function(BridgeError) __);
+}
+
+
+/// Adds pattern-matching-related methods to [BridgeError].
+extension BridgeErrorPatterns on BridgeError {
+/// A variant of `map` that fallback to returning `orElse`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeMap<TResult extends Object?>({TResult Function( BridgeError_InvalidCommand value)?  invalidCommand,TResult Function( BridgeError_Connection value)?  connection,TResult Function( BridgeError_NotConnected value)?  notConnected,TResult Function( BridgeError_AlreadyConnected value)?  alreadyConnected,TResult Function( BridgeError_Unmapped value)?  unmapped,required TResult orElse(),}){
+final _that = this;
+switch (_that) {
+case BridgeError_InvalidCommand() when invalidCommand != null:
+return invalidCommand(_that);case BridgeError_Connection() when connection != null:
+return connection(_that);case BridgeError_NotConnected() when notConnected != null:
+return notConnected(_that);case BridgeError_AlreadyConnected() when alreadyConnected != null:
+return alreadyConnected(_that);case BridgeError_Unmapped() when unmapped != null:
+return unmapped(_that);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// Callbacks receives the raw object, upcasted.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case final Subclass2 value:
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult map<TResult extends Object?>({required TResult Function( BridgeError_InvalidCommand value)  invalidCommand,required TResult Function( BridgeError_Connection value)  connection,required TResult Function( BridgeError_NotConnected value)  notConnected,required TResult Function( BridgeError_AlreadyConnected value)  alreadyConnected,required TResult Function( BridgeError_Unmapped value)  unmapped,}){
+final _that = this;
+switch (_that) {
+case BridgeError_InvalidCommand():
+return invalidCommand(_that);case BridgeError_Connection():
+return connection(_that);case BridgeError_NotConnected():
+return notConnected(_that);case BridgeError_AlreadyConnected():
+return alreadyConnected(_that);case BridgeError_Unmapped():
+return unmapped(_that);}
+}
+/// A variant of `map` that fallback to returning `null`.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case final Subclass value:
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? mapOrNull<TResult extends Object?>({TResult? Function( BridgeError_InvalidCommand value)?  invalidCommand,TResult? Function( BridgeError_Connection value)?  connection,TResult? Function( BridgeError_NotConnected value)?  notConnected,TResult? Function( BridgeError_AlreadyConnected value)?  alreadyConnected,TResult? Function( BridgeError_Unmapped value)?  unmapped,}){
+final _that = this;
+switch (_that) {
+case BridgeError_InvalidCommand() when invalidCommand != null:
+return invalidCommand(_that);case BridgeError_Connection() when connection != null:
+return connection(_that);case BridgeError_NotConnected() when notConnected != null:
+return notConnected(_that);case BridgeError_AlreadyConnected() when alreadyConnected != null:
+return alreadyConnected(_that);case BridgeError_Unmapped() when unmapped != null:
+return unmapped(_that);case _:
+  return null;
+
+}
+}
+/// A variant of `when` that fallback to an `orElse` callback.
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return orElse();
+/// }
+/// ```
+
+@optionalTypeArgs TResult maybeWhen<TResult extends Object?>({TResult Function( String field0)?  invalidCommand,TResult Function( String field0)?  connection,TResult Function()?  notConnected,TResult Function()?  alreadyConnected,TResult Function( String field0)?  unmapped,required TResult orElse(),}) {final _that = this;
+switch (_that) {
+case BridgeError_InvalidCommand() when invalidCommand != null:
+return invalidCommand(_that.field0);case BridgeError_Connection() when connection != null:
+return connection(_that.field0);case BridgeError_NotConnected() when notConnected != null:
+return notConnected();case BridgeError_AlreadyConnected() when alreadyConnected != null:
+return alreadyConnected();case BridgeError_Unmapped() when unmapped != null:
+return unmapped(_that.field0);case _:
+  return orElse();
+
+}
+}
+/// A `switch`-like method, using callbacks.
+///
+/// As opposed to `map`, this offers destructuring.
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case Subclass2(:final field2):
+///     return ...;
+/// }
+/// ```
+
+@optionalTypeArgs TResult when<TResult extends Object?>({required TResult Function( String field0)  invalidCommand,required TResult Function( String field0)  connection,required TResult Function()  notConnected,required TResult Function()  alreadyConnected,required TResult Function( String field0)  unmapped,}) {final _that = this;
+switch (_that) {
+case BridgeError_InvalidCommand():
+return invalidCommand(_that.field0);case BridgeError_Connection():
+return connection(_that.field0);case BridgeError_NotConnected():
+return notConnected();case BridgeError_AlreadyConnected():
+return alreadyConnected();case BridgeError_Unmapped():
+return unmapped(_that.field0);}
+}
+/// A variant of `when` that fallback to returning `null`
+///
+/// It is equivalent to doing:
+/// ```dart
+/// switch (sealedClass) {
+///   case Subclass(:final field):
+///     return ...;
+///   case _:
+///     return null;
+/// }
+/// ```
+
+@optionalTypeArgs TResult? whenOrNull<TResult extends Object?>({TResult? Function( String field0)?  invalidCommand,TResult? Function( String field0)?  connection,TResult? Function()?  notConnected,TResult? Function()?  alreadyConnected,TResult? Function( String field0)?  unmapped,}) {final _that = this;
+switch (_that) {
+case BridgeError_InvalidCommand() when invalidCommand != null:
+return invalidCommand(_that.field0);case BridgeError_Connection() when connection != null:
+return connection(_that.field0);case BridgeError_NotConnected() when notConnected != null:
+return notConnected();case BridgeError_AlreadyConnected() when alreadyConnected != null:
+return alreadyConnected();case BridgeError_Unmapped() when unmapped != null:
+return unmapped(_that.field0);case _:
+  return null;
+
+}
+}
+
+}
+
+/// @nodoc
+
+
+class BridgeError_InvalidCommand extends BridgeError {
+  const BridgeError_InvalidCommand(this.field0): super._();
+  
+
+ final  String field0;
+
+/// Create a copy of BridgeError
+/// with the given fields replaced by the non-null parameter values.
+@JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+$BridgeError_InvalidCommandCopyWith<BridgeError_InvalidCommand> get copyWith => _$BridgeError_InvalidCommandCopyWithImpl<BridgeError_InvalidCommand>(this, _$identity);
+
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is BridgeError_InvalidCommand&&(identical(other.field0, field0) || other.field0 == field0));
+}
+
+
+@override
+int get hashCode => Object.hash(runtimeType,field0);
+
+@override
+String toString() {
+  return 'BridgeError.invalidCommand(field0: $field0)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class $BridgeError_InvalidCommandCopyWith<$Res> implements $BridgeErrorCopyWith<$Res> {
+  factory $BridgeError_InvalidCommandCopyWith(BridgeError_InvalidCommand value, $Res Function(BridgeError_InvalidCommand) _then) = _$BridgeError_InvalidCommandCopyWithImpl;
+@useResult
+$Res call({
+ String field0
+});
+
+
+
+
+}
+/// @nodoc
+class _$BridgeError_InvalidCommandCopyWithImpl<$Res>
+    implements $BridgeError_InvalidCommandCopyWith<$Res> {
+  _$BridgeError_InvalidCommandCopyWithImpl(this._self, this._then);
+
+  final BridgeError_InvalidCommand _self;
+  final $Res Function(BridgeError_InvalidCommand) _then;
+
+/// Create a copy of BridgeError
+/// with the given fields replaced by the non-null parameter values.
+@pragma('vm:prefer-inline') $Res call({Object? field0 = null,}) {
+  return _then(BridgeError_InvalidCommand(
+null == field0 ? _self.field0 : field0 // ignore: cast_nullable_to_non_nullable
+as String,
+  ));
+}
+
+
+}
+
+/// @nodoc
+
+
+class BridgeError_Connection extends BridgeError {
+  const BridgeError_Connection(this.field0): super._();
+  
+
+ final  String field0;
+
+/// Create a copy of BridgeError
+/// with the given fields replaced by the non-null parameter values.
+@JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+$BridgeError_ConnectionCopyWith<BridgeError_Connection> get copyWith => _$BridgeError_ConnectionCopyWithImpl<BridgeError_Connection>(this, _$identity);
+
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is BridgeError_Connection&&(identical(other.field0, field0) || other.field0 == field0));
+}
+
+
+@override
+int get hashCode => Object.hash(runtimeType,field0);
+
+@override
+String toString() {
+  return 'BridgeError.connection(field0: $field0)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class $BridgeError_ConnectionCopyWith<$Res> implements $BridgeErrorCopyWith<$Res> {
+  factory $BridgeError_ConnectionCopyWith(BridgeError_Connection value, $Res Function(BridgeError_Connection) _then) = _$BridgeError_ConnectionCopyWithImpl;
+@useResult
+$Res call({
+ String field0
+});
+
+
+
+
+}
+/// @nodoc
+class _$BridgeError_ConnectionCopyWithImpl<$Res>
+    implements $BridgeError_ConnectionCopyWith<$Res> {
+  _$BridgeError_ConnectionCopyWithImpl(this._self, this._then);
+
+  final BridgeError_Connection _self;
+  final $Res Function(BridgeError_Connection) _then;
+
+/// Create a copy of BridgeError
+/// with the given fields replaced by the non-null parameter values.
+@pragma('vm:prefer-inline') $Res call({Object? field0 = null,}) {
+  return _then(BridgeError_Connection(
+null == field0 ? _self.field0 : field0 // ignore: cast_nullable_to_non_nullable
+as String,
+  ));
+}
+
+
+}
+
+/// @nodoc
+
+
+class BridgeError_NotConnected extends BridgeError {
+  const BridgeError_NotConnected(): super._();
+  
+
+
+
+
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is BridgeError_NotConnected);
+}
+
+
+@override
+int get hashCode => runtimeType.hashCode;
+
+@override
+String toString() {
+  return 'BridgeError.notConnected()';
+}
+
+
+}
+
+
+
+
+/// @nodoc
+
+
+class BridgeError_AlreadyConnected extends BridgeError {
+  const BridgeError_AlreadyConnected(): super._();
+  
+
+
+
+
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is BridgeError_AlreadyConnected);
+}
+
+
+@override
+int get hashCode => runtimeType.hashCode;
+
+@override
+String toString() {
+  return 'BridgeError.alreadyConnected()';
+}
+
+
+}
+
+
+
+
+/// @nodoc
+
+
+class BridgeError_Unmapped extends BridgeError {
+  const BridgeError_Unmapped(this.field0): super._();
+  
+
+ final  String field0;
+
+/// Create a copy of BridgeError
+/// with the given fields replaced by the non-null parameter values.
+@JsonKey(includeFromJson: false, includeToJson: false)
+@pragma('vm:prefer-inline')
+$BridgeError_UnmappedCopyWith<BridgeError_Unmapped> get copyWith => _$BridgeError_UnmappedCopyWithImpl<BridgeError_Unmapped>(this, _$identity);
+
+
+
+@override
+bool operator ==(Object other) {
+  return identical(this, other) || (other.runtimeType == runtimeType&&other is BridgeError_Unmapped&&(identical(other.field0, field0) || other.field0 == field0));
+}
+
+
+@override
+int get hashCode => Object.hash(runtimeType,field0);
+
+@override
+String toString() {
+  return 'BridgeError.unmapped(field0: $field0)';
+}
+
+
+}
+
+/// @nodoc
+abstract mixin class $BridgeError_UnmappedCopyWith<$Res> implements $BridgeErrorCopyWith<$Res> {
+  factory $BridgeError_UnmappedCopyWith(BridgeError_Unmapped value, $Res Function(BridgeError_Unmapped) _then) = _$BridgeError_UnmappedCopyWithImpl;
+@useResult
+$Res call({
+ String field0
+});
+
+
+
+
+}
+/// @nodoc
+class _$BridgeError_UnmappedCopyWithImpl<$Res>
+    implements $BridgeError_UnmappedCopyWith<$Res> {
+  _$BridgeError_UnmappedCopyWithImpl(this._self, this._then);
+
+  final BridgeError_Unmapped _self;
+  final $Res Function(BridgeError_Unmapped) _then;
+
+/// Create a copy of BridgeError
+/// with the given fields replaced by the non-null parameter values.
+@pragma('vm:prefer-inline') $Res call({Object? field0 = null,}) {
+  return _then(BridgeError_Unmapped(
+null == field0 ? _self.field0 : field0 // ignore: cast_nullable_to_non_nullable
+as String,
+  ));
+}
+
+
+}
+
+// dart format on