Meteorify

A Dart package to interact with the Meteor framework.

Connect your web or flutter apps, written in Dart, to the Meteor framework.

Features

• Connect to Meteor server
• Use Meteor Subscriptions
• Meteor Authentication
• Call custom Methods on Meteor
• Access underlying databases

Dependency

Add this to your package's pubspec.yaml file:

dependencies:
  meteorify: ^1.0.7

Usage

Capturing the result of operations

You can use either the then-catchError or await syntax to capture the result of operations and handle errors.

I'll be using the await syntax in this documentation to keep it short and straight. You can use either catchError on Future object or try/catch syntax to catch errors.

Connection Operations

Connecting with Meteor

Using then-catchError:

import 'package:meteorify/meteorify.dart';

main() async{
  Meteor.connect('ws://example.meteor.com/websocket')
      .then((status){
          // Do something after connection is successful
      })
      .catchError((error){
          print(error);
          //Handle error
      });
}

Using await:

import 'package:meteorify/meteorify.dart';

main() async{
  try{
      var status = await Meteor.connect('ws://example.meteor.com/websocket');
      // Do something after connection is successful
  }catch(error){
      print(error);
      //Handle error
  }
}

Check connection status

var isConnected = Meteor.isConnected;		

Disconnect from server

Meteor.disconnect();

Listen for connection updates

Meteor.connectionListener = (ConnectionStatus connectionStatus){
  print(connectionStatus);
}



Subscriptions

Subscribe to Data

var subscriptionId = await Meteor.subscribe(subscriptionName);

Subscriptions with Parameters

var subscriptionId = await Meteor.subscribe(subscriptionName,args:[arg1,arg2]);

Unsubscribe from Data

await Meteor.unsubscribe(subscriptionId);

Get subscribed data/collection

SubscribedCollection collection = await Meteor.collection(collectionName);
//collection.find({selectors});
//collection.findAll();
//collection.findOne(id);

Authentication

Creating New Account

var userId = await Accounts.createUser(username,email,password,profileOptions);

Login

1. Login with password

   String loginToken = await Meteor.loginWithPassword(emailOrUsername,password);

2. Login with token

   String token = await Meteor.loginWithToken(loginToken);

3. Change Password (need to be logged in)

   String result = await Accounts.changePassword(oldPassword,newPassword);

4. Forgot Password

   String result = await Accounts.forgotPassword(email);

5. Reset Password

   String result = await Accounts.resetPassword(resetToken,newPassword);

6. Logout

   await Meteor.logout();

7. Get logged in userId

   String userId = Meteor.currentUserId;

8. Check if logged in

   bool isLoggedIn = Meteor.isLoggedIn();

9. Get current user as map

   Map<String,dynamic> currentUser = await Meteor.userAsMap();

Call Custom Methods

Defining custom methods in meteor server

export const helloWorld = new ValidatedMethod({
  name: 'hello',
  validate: new SimpleSchema({
    firstname: {type: String},
    lastname: {type: String},
  }).validator(),
  run({ firstname,lastname }) {
    const message = "hello "+firstname+" "+lastname;
    console.log(message);
    return message;
  },
});

Invoking custom methods

try{
  var result = await Meteor.call('hello',[{'firstname':'Shivam','lastname':'Arora'}]);
  print(result);
}catch(error){
  print(error);
}

Using Mongo Databases to manage data

Meteorify uses the mongo_dart package internally to provide access to actual database.

For more instructions regarding use of mongo_dart , visit their mongo_dart guide.

Get Meteor Database

import 'package:mongo_dart/mongo_dart.dart';

Db db = await Meteor.getMeteorDatabase();

Get custom database

import 'package:mongo_dart/mongo_dart.dart';

Db db = await Meteor.getCustomDatabase(dbUrl);
await db.open();

Get collection

import 'package:mongo_dart/mongo_dart.dart';

DbCollection collection = await db.collection('collectionName');