• HTML5 LocalStorage
• Cordova storage plugins
• Core Data (iOS)
• SQLite (Android)
• ..more

• MongoDB
• Redis

• MongoDB
• Redis
• Integrate with external databases

$fh.cloud({
  path: "/somePath",
  method: "POST|GET|PUT|DELETE", // optional - default GET
  contentType: "application/json", // optional - default shown
  data: { "username": "testuser"}, // optional - request body
  timeout: 60000 // optional - default shown
}, function(res) {
  // Success - your response will be in the "res" variable
}, function(msg,err) {
  // Failure
});

one

two

three

fhconfig.json

  // Registers the app for push notifications.
  $fh.push(function(e) {
      // your push message will be in `e.alert`
  }, function() {
    // successfully registered
  }, function(err) {
    // handle errors
  }, { // this next param is optional!
    alias: "user@example.com", // register the device with a unique user identifier. Allows pushing to single users
    categories: ["Curling", "Hurling"] // filter only certain categories of message to receive
  });

$fh.sync.init({
  "sync_frequency": 10, // How often to check for new data in seconds (default shown).
  // .. many more options available
});

shopping

{}

// Manage a dataset called `shopping`
// Options can be provided to override what was provided at init time
// Query params can be provided which get passed to the server, to filter the dataset retrieved. 
// Metadata about this dataset can also be provided, which also gets passed to the serverside. 
$fh.sync.manage('shopping', {/*options*/}, {/*query params*/}, {/* metadata */}, function(){
  // we've registered successfully
});

$fh.sync.notify(function(event) {
  var dataset_id = event.dataset_id; // if you are managing multiple datasets, it'll be useful to know which this event relates to
  // The notification message code we are responding to
  switch(event.code){
    case 'sync_complete':
    case 'local_update_applied':
      // at this point, it might make sense to do a list operation to update the UI using $fh.sync.doList (see below)
    case 'remote_update_failed':
      // There was an issue updating on the serverside - handle the error in event.message
    default:
      // there many other notification codes: client_storage_failed, sync_started, offline_update, collision_detected, remote_update_applied,
      // local_update_applied, delta_received, record_delta_received, sync_failed
  }
});

$fh.sync.doList('shopping', function(res) {
  /* where res will be
  {
    '1234' : { // where 1234 is the UID of the record
      hash : '1bd55262212c4ec2ac6ef20d8c8b03b3', // an MD5 hash of the record
      data : { name : "Oranges" } // the actual record data
    },
    // ... and potentially more records
  }
  */
});

$fh.sync.doCreate('shopping', { name : "Tomatoes" }, function(res) {
  // create was successful
});

$fh.sync.doUpdate('shopping', 1234, {name : "Grapes"}, function(){/*success*/});
$fh.sync.doRead('shopping', 1234, function(){/*success*/});
$fh.sync.doDelete('shopping', 1234, function(){/*success*/});

one

two

three

fhconfig.json

  // Registers the app for push notifications.
  JavaScript
  // LDAP or Platform User Example
  $fh.auth({
    "policyId": "myLDAP", // UD of an auth policy configured in Admin->Auth Policies
    "clientToken": "yourAppId", // get this by doing $fh.getFHParams().appid
    // When using with Platform or LDAP login:
    "params": { // the parameters associated with the requested auth policy
      "userId": "joe@bloggs.com",
      "password": "password"
    }
  }, function (res) {
    var sessionToken = res.sessionToken; // An identifier for this session
    var authResponse = res.authResponse; // Auth info returned from the auth service - if any
  }, function (msg, err) {
    // something as gone wrong. If err.message === "user_purge_data" or "device_purge_data",
    // the user has been flagged for erasing
  });
  

  var myFavourite = { type : "apples" }; // note JSON values need to be stringified before saving
  $fh.cache({
    act : "save", key : "favouriteFruit", value : JSON.stringify(myFavourite), expire : 60
  }, function(err, res){
    // check for err - otherwise cache save succeeded.
  });
  // then read back your value
  $fh.cache({
    act : "load", key : "favouriteFruit"
  }, function(err, res){
    console.log(JSON.parse(res));
    // res will be { type : "apples " }
  });
  

  $fh.db({
    act : "create", type : "fruit", fields : { name : "apples", price : 10.99 }
  }, function(err, data){ /* check for err - otherwise save succeeded. `data.guid` is the newly created id. */ );
  // now read back an item
  $fh.db({
    act : "read", type : "fruit", guid : "4e563ea44fe8e7fc19000002"
  }, function(err, data){
    /* Data will be:
    {
      fields : { name : "apples", price : 10.99 },
      guid : "4e563ea44fe8e7fc19000002",
      type : "fruit"
    } */
  });
  // list all fruit
  $fh.db({
    act : "list", type : "fruit"
  }, function(err, listResult){ /* listResult.fields contains an array of data like in the "create" example */ });
  // now update the price
  $fh.db({
    act : "update", type : "fruit", guid : "4e563ea44fe8e7fc19000002", fields : { price : 11.99 } // only the price will change
  }, function(err, updateResult){ /* updateResult is like the "create" example above */ });
  // then delete the row
  $fh.db({
    act : "delete", type : "fruit", guid : "4e563ea44fe8e7fc19000002"
  }, function(err, deletedEntry){ /* deletedEntry is like the "create" example above */ });