feat: add Firebase simulator client and server examples, refactor port handling

Author: alextekartik

firebase_sim/example/example_io_client.dart

@@ -0,0 +1,16 @@
+import 'package:tekartik_firebase_sim/firebase_sim.dart';
+import 'package:tekartik_firebase_sim/src/firebase_sim.dart';
+import 'package:tekartik_firebase_test/menu/firebase_client_menu.dart';
+
+import 'vars_menu.dart';
+
+Future<void> main(List<String> args) async {
+  var firebase = getFirebaseSim(
+    uri: getFirebaseSimLocalhostUri(port: simPortKvValue),
+  );
+
+  await mainMenu(args, () {
+    firebaseMainMenu(context: FirebaseMainMenuContext(firebase: firebase));
+    varsMenu();
+  });
+}

firebase_sim/example/example_sim_client.dart

@@ -3,13 +3,13 @@
 import 'package:tekartik_firebase_local/firebase_local.dart';
 import 'package:tekartik_firebase_sim/firebase_sim_server.dart';
 
-import 'example_io_client.dart';
+import 'vars_menu.dart';
 
 Future<void> main(List<String> args) async {
   var firebaseSimServer = await firebaseSimServe(
     FirebaseLocal(),
     webSocketChannelServerFactory: webSocketChannelServerFactoryIo,
-    port: urlKvPort,
+    port: simPortKvValue,
   );
   print('url ${firebaseSimServer.url}');
 }

firebase_sim/example/example_io_server.dart renamed to firebase_sim/example/example_sim_server.dart

@@ -0,0 +1,17 @@
+import 'package:tekartik_app_dev_menu/dev_menu.dart';
+
+int? get simPortKvValue {
+  return int.tryParse(simPortKv.value ?? '');
+}
+
+var simPortKv = 'firebase_sim_example.sim.port'.kvFromVar();
+
+void varsMenu() {
+  keyValuesMenu('vars', [simPortKv]);
+}
+
+Future<void> main(List<String> args) async {
+  await mainMenu(args, () {
+    varsMenu();
+  });
+}

firebase_sim/example/vars_menu.dart

@@ -3,6 +3,8 @@ export 'src/firebase_sim.dart'
         FirebaseSim,
         getFirebaseSim,
         getFirebaseSimUrl,
+        getFirebaseSimPort,
+        getFirebaseSimLocalhostUri,
         firebaseSimDefaultPort,
         firebaseSimDefaultProjectId;
 export 'src/firebase_sim_client.dart' show FirebaseAppSim;

firebase_sim/lib/firebase_sim.dart

@@ -11,19 +11,32 @@ String get _defaultProjectId => 'sim';
 
 /// Default project ID for the tekartik firebase Sim.
 String firebaseSimDefaultProjectId = _defaultProjectId;
+const firebaseSimLocalhostBaseUrl = 'ws://localhost';
 
 /// The default port for the Firebase Simulator.
 final int firebaseSimDefaultPort = 4996;
 
 /// Get the default Firebase Simulator URL.
+// @deprecated
 String getFirebaseSimUrl({int? port}) {
+  return getFirebaseSimLocalhostUri(port: port).toString();
+}
+
+/// Get the default Firebase Simulator port.
+int getFirebaseSimPort([int? port]) {
   port ??= firebaseSimDefaultPort;
-  return 'ws://localhost:$port';
+  return port;
+}
+
+/// Get the default Firebase Simulator URL.
+Uri getFirebaseSimLocalhostUri({int? port}) {
+  var foundPort = getFirebaseSimPort(port);
+  return Uri.parse('$firebaseSimLocalhostBaseUrl:$foundPort');
 }
 
 /// Get firebase sim
 FirebaseSim getFirebaseSim({
-  Firebase? firebaseServer,
+  @Deprecated('Do no use') Firebase? firebaseServer,
   WebSocketChannelClientFactory? clientFactory,
   Uri? uri,
   String? localPath,

firebase_sim/lib/src/firebase_sim.dart

@@ -6,6 +6,7 @@ import 'package:tekartik_firebase/firebase.dart';
 import 'package:tekartik_firebase_sim/src/firebase_sim_message.dart';
 import 'package:tekartik_rpc/rpc_server.dart';
 
+import '../firebase_sim.dart';
 import 'log_utils.dart';
 
 var debugFirebaseSimServer = false; // devWarning(true);
@@ -19,6 +20,7 @@ Future<FirebaseSimServer> firebaseSimServe(
   List<FirebaseSimPlugin>? plugins,
   int? port,
 }) async {
+  port ??= firebaseSimDefaultPort;
   var services = [
     FirebaseSimServerCoreService(),
     if (plugins != null) ...plugins.map((plugin) => plugin.simService),