DAO factory API sketch

lib/dao-factory.js

@@ -328,6 +328,43 @@ module.exports = (function() {
     }).run()
   }
 
+  /**
+   * Create and insert multiple instances
+   *
+   * @param  {Array} values List of objects (key/value pairs) to create instances from
+   * @return {Object}       A promise which fires `success`, `error`, `complete` and `sql`.
+   *
+   * The `success` handler is passed a list of newly inserted models.
+   */
+  DaoFactory.prototype.bulkCreate = function(values, options) {
+    var factory = this
+    return this.bulkInsert(values.map(function(attrs) {
+      return factory.build(attrs, options)
+    })
+  }
+
+  /**
+   * Insert multiple instances
+   *
+   * @param  {Array} daos   List of built DAOs
+   * @return {Object}       A promise which fires `success`, `error`, `complete` and `sql`.
+   *
+   * The `success` handler is passed a list of newly inserted models.
+   */
+  DaoFactory.prototype.bulkInsert = function(daos, fields) {
+    // XXX: TODO
+  }
+
+  /**
+   * Delete multiple instances
+   *
+   * @param  {Object} options Options to describe the scope of the search.
+   * @return {Object}       A promise which fires `success`, `error`, `complete` and `sql`.
+   */
+  DaoFactory.prototype.bulkDelete = function(options) {
+    // XXX: TODO
+  }
+
   // private
 
   var query = function() {