Wrapperless dart:html and friends

tool/input_sdk/lib/indexed_db/dart2js/indexed_db_dart2js.dart

+/**
+ * A client-side key-value store with support for indexes.
+ *
+ * Many browsers support IndexedDB—a web standard for
+ * an indexed database.
+ * By storing data on the client in an IndexedDB,
+ * a web app gets some advantages, such as faster performance and persistence.
+ * To find out which browsers support IndexedDB,
+ * refer to [Can I Use?](http://caniuse.com/#feat=indexeddb)
+ *
+ * In IndexedDB, each record is identified by a unique index or key,
+ * making data retrieval speedy.
+ * You can store structured data,
+ * such as images, arrays, and maps using IndexedDB.
+ * The standard does not specify size limits for individual data items
+ * or for the database itself, but browsers may impose storage limits.
+ *
+ * ## Using indexed_db
+ *
+ * The classes in this library provide an interface
+ * to the browser's IndexedDB, if it has one.
+ * To use this library in your code:
+ *
+ *     import 'dart:indexed_db';
+ *
+ * A web app can determine if the browser supports
+ * IndexedDB with [IdbFactory.supported]:
+ *
+ *     if (IdbFactory.supported)
+ *       // Use indexeddb.
+ *     else
+ *       // Find an alternative.
+ *
+ * Access to the browser's IndexedDB is provided by the app's top-level
+ * [Window] object, which your code can refer to with `window.indexedDB`.
+ * So, for example,
+ * here's how to use window.indexedDB to open a database:
+ *
+ *     Future open() {
+ *       return window.indexedDB.open('myIndexedDB',
+ *           version: 1,
+ *           onUpgradeNeeded: _initializeDatabase)
+ *         .then(_loadFromDB);
+ *     }
+ *     void _initializeDatabase(VersionChangeEvent e) {
+ *       ...
+ *     }
+ *     Future _loadFromDB(Database db) {
+ *       ...
+ *     }
+ *
+ *
+ * All data in an IndexedDB is stored within an [ObjectStore].
+ * To manipulate the database use [Transaction]s.
+ *
+ * ## Other resources
+ *
+ * Other options for client-side data storage include:
+ *
+ * * [Window.localStorage]—a
+ * basic mechanism that stores data as a [Map],
+ * and where both the keys and the values are strings.
+ *
+ * * [dart:web_sql]—a database that can be queried with SQL.
+ * 
+ * For a tutorial about using the indexed_db library with Dart,
+ * check out
+ * [Use IndexedDB](http://www.dartlang.org/docs/tutorials/indexeddb/).
+ *
+ * [IndexedDB reference](http://docs.webplatform.org/wiki/apis/indexeddb)
+ * provides wiki-style docs about indexedDB
+ */
+library dart.dom.indexed_db;
+
+import 'dart:async';
+import 'dart:html';
+import 'dart:html_common';
+import 'dart:_native_typed_data';
+import 'dart:typed_data';
+import 'dart:_js_helper' show Creates, Returns, JSName, Native;
+import 'dart:_foreign_helper' show JS;
+import 'dart:_interceptors' show Interceptor, JSExtendableArray;
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+// DO NOT EDIT - unless you are editing documentation as per:
+// https://code.google.com/p/dart/wiki/ContributingHTMLDocumentation
+// Auto-generated dart:svg library.
+
+
+
+
+
+class _KeyRangeFactoryProvider {
+
+  static KeyRange createKeyRange_only(/*Key*/ value) =>
+      _only(_class(), _translateKey(value));
+
+  static KeyRange createKeyRange_lowerBound(
+      /*Key*/ bound, [bool open = false]) =>
+      _lowerBound(_class(), _translateKey(bound), open);
+
+  static KeyRange createKeyRange_upperBound(
+      /*Key*/ bound, [bool open = false]) =>
+      _upperBound(_class(), _translateKey(bound), open);
+
+  static KeyRange createKeyRange_bound(/*Key*/ lower, /*Key*/ upper,
+      [bool lowerOpen = false, bool upperOpen = false]) =>
+      _bound(_class(), _translateKey(lower), _translateKey(upper),
+             lowerOpen, upperOpen);
+
+  static var _cachedClass;
+
+  static _class() {
+    if (_cachedClass != null) return _cachedClass;
+    return _cachedClass = _uncachedClass();
+  }
+
+  static _uncachedClass() =>
+    JS('var',
+       '''window.webkitIDBKeyRange || window.mozIDBKeyRange ||
+          window.msIDBKeyRange || window.IDBKeyRange''');
+
+  static _translateKey(idbkey) => idbkey;  // TODO: fixme.
+
+  static KeyRange _only(cls, value) =>
+       JS('KeyRange', '#.only(#)', cls, value);
+
+  static KeyRange _lowerBound(cls, bound, open) =>
+       JS('KeyRange', '#.lowerBound(#, #)', cls, bound, open);
+
+  static KeyRange _upperBound(cls, bound, open) =>
+       JS('KeyRange', '#.upperBound(#, #)', cls, bound, open);
+
+  static KeyRange _bound(cls, lower, upper, lowerOpen, upperOpen) =>
+       JS('KeyRange', '#.bound(#, #, #, #)',
+          cls, lower, upper, lowerOpen, upperOpen);
+}
+
+// Conversions for IDBKey.
+//
+// Per http://www.w3.org/TR/IndexedDB/#key-construct
+//
+// "A value is said to be a valid key if it is one of the following types: Array
+// JavaScript objects [ECMA-262], DOMString [WEBIDL], Date [ECMA-262] or float
+// [WEBIDL]. However Arrays are only valid keys if every item in the array is
+// defined and is a valid key (i.e. sparse arrays can not be valid keys) and if
+// the Array doesn't directly or indirectly contain itself. Any non-numeric
+// properties are ignored, and thus does not affect whether the Array is a valid
+// key. Additionally, if the value is of type float, it is only a valid key if
+// it is not NaN, and if the value is of type Date it is only a valid key if its
+// [[PrimitiveValue]] internal property, as defined by [ECMA-262], is not NaN."
+
+// What is required is to ensure that an Lists in the key are actually
+// JavaScript arrays, and any Dates are JavaScript Dates.
+
+
+/**
+ * Converts a native IDBKey into a Dart object.
+ *
+ * May return the original input.  May mutate the original input (but will be
+ * idempotent if mutation occurs).  It is assumed that this conversion happens
+ * on native IDBKeys on all paths that return IDBKeys from native DOM calls.
+ *
+ * If necessary, JavaScript Dates are converted into Dart Dates.
+ */
+_convertNativeToDart_IDBKey(nativeKey) {
+  containsDate(object) {
+    if (isJavaScriptDate(object)) return true;
+    if (object is List) {
+      for (int i = 0; i < object.length; i++) {
+        if (containsDate(object[i])) return true;
+      }
+    }
+    return false;  // number, string.
+  }
+  if (containsDate(nativeKey)) {
+    throw new UnimplementedError('Key containing DateTime');
+  }
+  // TODO: Cache conversion somewhere?
+  return nativeKey;
+}
+
+/**
+ * Converts a Dart object into a valid IDBKey.
+ *
+ * May return the original input.  Does not mutate input.
+ *
+ * If necessary, [dartKey] may be copied to ensure all lists are converted into
+ * JavaScript Arrays and Dart Dates into JavaScript Dates.
+ */
+_convertDartToNative_IDBKey(dartKey) {
+  // TODO: Implement.
+  return dartKey;
+}
+
+
+
+/// May modify original.  If so, action is idempotent.
+_convertNativeToDart_IDBAny(object) {
+  return convertNativeToDart_AcceptStructuredClone(object, mustCopy: false);
+}
+
+// TODO(sra): Add DateTime.
+const String _idbKey = 'JSExtendableArray|=Object|num|String';
+const _annotation_Creates_IDBKey = const Creates(_idbKey);
+const _annotation_Returns_IDBKey = const Returns(_idbKey);
+// Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DomName('IDBCursor')
+@Unstable()
+@Native("IDBCursor")
+class Cursor extends Interceptor {
+  @DomName('IDBCursor.delete')
+  Future delete() {
+   try {
+      return _completeRequest(_delete());
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBCursor.value')
+  Future update(value) {
+   try {
+      return _completeRequest(_update(value));
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @JSName('continue')
+  @DomName('IDBCursor.continue')
+  void next([Object key]) {
+    if (key == null) {
+      JS('void', '#.continue()', this);
+    } else {
+      JS('void', '#.continue(#)', this, key);
+    }
+  }
+    // To suppress missing implicit constructor warnings.
+  factory Cursor._() { throw new UnsupportedError("Not supported"); }
+
+  @DomName('IDBCursor.direction')
+  @DocsEditable()
+  final String direction;
+
+  @DomName('IDBCursor.key')
+  @DocsEditable()
+  @_annotation_Creates_IDBKey
+  @_annotation_Returns_IDBKey
+  final Object key;
+
+  @DomName('IDBCursor.primaryKey')
+  @DocsEditable()
+  @_annotation_Creates_IDBKey
+  @_annotation_Returns_IDBKey
+  final Object primaryKey;
+
+  @DomName('IDBCursor.source')
+  @DocsEditable()
+  @Creates('Null')
+  @Returns('ObjectStore|Index|Null')
+  final Object source;
+
+  @DomName('IDBCursor.advance')
+  @DocsEditable()
+  void advance(int count) native;
+
+  @DomName('IDBCursor.continuePrimaryKey')
+  @DocsEditable()
+  @Experimental() // untriaged
+  void continuePrimaryKey(Object key, Object primaryKey) native;
+
+  @JSName('delete')
+  @DomName('IDBCursor.delete')
+  @DocsEditable()
+  Request _delete() native;
+
+  @DomName('IDBCursor.update')
+  @DocsEditable()
+  Request _update(/*any*/ value) {
+    var value_1 = convertDartToNative_SerializedScriptValue(value);
+    return _update_1(value_1);
+  }
+  @JSName('update')
+  @DomName('IDBCursor.update')
+  @DocsEditable()
+  Request _update_1(value) native;
+
+}
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DocsEditable()
+@DomName('IDBCursorWithValue')
+@Unstable()
+@Native("IDBCursorWithValue")
+class CursorWithValue extends Cursor {
+  // To suppress missing implicit constructor warnings.
+  factory CursorWithValue._() { throw new UnsupportedError("Not supported"); }
+
+  @DomName('IDBCursorWithValue.value')
+  @DocsEditable()
+  dynamic get value => _convertNativeToDart_IDBAny(this._get_value);
+  @JSName('value')
+  @DomName('IDBCursorWithValue.value')
+  @DocsEditable()
+  @annotation_Creates_SerializedScriptValue
+  @annotation_Returns_SerializedScriptValue
+  final dynamic _get_value;
+}
+// Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DocsEditable()
+/**
+ * An indexed database object for storing client-side data
+ * in web apps.
+ */
+@DomName('IDBDatabase')
+@SupportedBrowser(SupportedBrowser.CHROME)
+@SupportedBrowser(SupportedBrowser.FIREFOX, '15')
+@SupportedBrowser(SupportedBrowser.IE, '10')
+@Experimental()
+@Unstable()
+@Native("IDBDatabase")
+class Database extends EventTarget {
+  @DomName('IDBDatabase.createObjectStore')
+  @DocsEditable()
+  ObjectStore createObjectStore(String name,
+      {String keyPath, bool autoIncrement}) {
+    var options = {};
+    if (keyPath != null) {
+      options['keyPath'] = keyPath;
+    }
+    if (autoIncrement != null) {
+      options['autoIncrement'] = autoIncrement;
+    }
+
+    return _createObjectStore(name, options);
+  }
+
+  Transaction transaction(storeName_OR_storeNames, String mode) {
+    if (mode != 'readonly' && mode != 'readwrite') {
+      throw new ArgumentError(mode);
+    }
+
+    // TODO(sra): Ensure storeName_OR_storeNames is a string or List<String>,
+    // and copy to JavaScript array if necessary.
+
+    // Try and create a transaction with a string mode.  Browsers that expect a
+    // numeric mode tend to convert the string into a number.  This fails
+    // silently, resulting in zero ('readonly').
+    return _transaction(storeName_OR_storeNames, mode);
+  }
+
+  Transaction transactionStore(String storeName, String mode) {
+    if (mode != 'readonly' && mode != 'readwrite') {
+      throw new ArgumentError(mode);
+    }
+    // Try and create a transaction with a string mode.  Browsers that expect a
+    // numeric mode tend to convert the string into a number.  This fails
+    // silently, resulting in zero ('readonly').
+    return _transaction(storeName, mode);
+  }
+
+  Transaction transactionList(List<String> storeNames, String mode) {
+    if (mode != 'readonly' && mode != 'readwrite') {
+      throw new ArgumentError(mode);
+    }
+    List storeNames_1 = convertDartToNative_StringArray(storeNames);
+    return _transaction(storeNames_1, mode);
+  }
+
+  Transaction transactionStores(DomStringList storeNames, String mode) {
+    if (mode != 'readonly' && mode != 'readwrite') {
+      throw new ArgumentError(mode);
+    }
+    return _transaction(storeNames, mode);
+  }
+
+  @JSName('transaction')
+  Transaction _transaction(stores, mode) native;
+
+  // To suppress missing implicit constructor warnings.
+  factory Database._() { throw new UnsupportedError("Not supported"); }
+
+  /**
+   * Static factory designed to expose `abort` events to event
+   * handlers that are not necessarily instances of [Database].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBDatabase.abortEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> abortEvent = const EventStreamProvider<Event>('abort');
+
+  /**
+   * Static factory designed to expose `close` events to event
+   * handlers that are not necessarily instances of [Database].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBDatabase.closeEvent')
+  @DocsEditable()
+  // https://www.w3.org/Bugs/Public/show_bug.cgi?id=22540
+  @Experimental()
+  static const EventStreamProvider<Event> closeEvent = const EventStreamProvider<Event>('close');
+
+  /**
+   * Static factory designed to expose `error` events to event
+   * handlers that are not necessarily instances of [Database].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBDatabase.errorEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> errorEvent = const EventStreamProvider<Event>('error');
+
+  /**
+   * Static factory designed to expose `versionchange` events to event
+   * handlers that are not necessarily instances of [Database].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBDatabase.versionchangeEvent')
+  @DocsEditable()
+  static const EventStreamProvider<VersionChangeEvent> versionChangeEvent = const EventStreamProvider<VersionChangeEvent>('versionchange');
+
+  @DomName('IDBDatabase.name')
+  @DocsEditable()
+  final String name;
+
+  @DomName('IDBDatabase.objectStoreNames')
+  @DocsEditable()
+  @Returns('DomStringList')
+  @Creates('DomStringList')
+  final List<String> objectStoreNames;
+
+  @DomName('IDBDatabase.version')
+  @DocsEditable()
+  @Creates('int|String|Null')
+  @Returns('int|String|Null')
+  final Object version;
+
+  @DomName('IDBDatabase.close')
+  @DocsEditable()
+  void close() native;
+
+  @DomName('IDBDatabase.createObjectStore')
+  @DocsEditable()
+  ObjectStore _createObjectStore(String name, [Map options]) {
+    if (options != null) {
+      var options_1 = convertDartToNative_Dictionary(options);
+      return _createObjectStore_1(name, options_1);
+    }
+    return _createObjectStore_2(name);
+  }
+  @JSName('createObjectStore')
+  @DomName('IDBDatabase.createObjectStore')
+  @DocsEditable()
+  ObjectStore _createObjectStore_1(name, options) native;
+  @JSName('createObjectStore')
+  @DomName('IDBDatabase.createObjectStore')
+  @DocsEditable()
+  ObjectStore _createObjectStore_2(name) native;
+
+  @DomName('IDBDatabase.deleteObjectStore')
+  @DocsEditable()
+  void deleteObjectStore(String name) native;
+
+  /// Stream of `abort` events handled by this [Database].
+  @DomName('IDBDatabase.onabort')
+  @DocsEditable()
+  Stream<Event> get onAbort => abortEvent.forTarget(this);
+
+  /// Stream of `close` events handled by this [Database].
+  @DomName('IDBDatabase.onclose')
+  @DocsEditable()
+  // https://www.w3.org/Bugs/Public/show_bug.cgi?id=22540
+  @Experimental()
+  Stream<Event> get onClose => closeEvent.forTarget(this);
+
+  /// Stream of `error` events handled by this [Database].
+  @DomName('IDBDatabase.onerror')
+  @DocsEditable()
+  Stream<Event> get onError => errorEvent.forTarget(this);
+
+  /// Stream of `versionchange` events handled by this [Database].
+  @DomName('IDBDatabase.onversionchange')
+  @DocsEditable()
+  Stream<VersionChangeEvent> get onVersionChange => versionChangeEvent.forTarget(this);
+}
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DomName('IDBFactory')
+@SupportedBrowser(SupportedBrowser.CHROME)
+@SupportedBrowser(SupportedBrowser.FIREFOX, '15')
+@SupportedBrowser(SupportedBrowser.IE, '10')
+@Experimental()
+@Unstable()
+@Native("IDBFactory")
+class IdbFactory extends Interceptor {
+  /**
+   * Checks to see if Indexed DB is supported on the current platform.
+   */
+  static bool get supported {
+    return JS('bool',
+        '!!(window.indexedDB || '
+        'window.webkitIndexedDB || '
+        'window.mozIndexedDB)');
+  }
+
+  @DomName('IDBFactory.open')
+  Future<Database> open(String name,
+      {int version, void onUpgradeNeeded(VersionChangeEvent),
+      void onBlocked(Event)}) {
+    if ((version == null) != (onUpgradeNeeded == null)) {
+      return new Future.error(new ArgumentError(
+          'version and onUpgradeNeeded must be specified together'));
+    }
+    try {
+      var request;
+      if (version != null) {
+        request = _open(name, version);
+      } else {
+        request = _open(name);
+      }
+
+      if (onUpgradeNeeded != null) {
+        request.onUpgradeNeeded.listen(onUpgradeNeeded);
+      }
+      if (onBlocked != null) {
+        request.onBlocked.listen(onBlocked);
+      }
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBFactory.deleteDatabase')
+  Future<IdbFactory> deleteDatabase(String name,
+      {void onBlocked(Event)}) {
+    try {
+      var request = _deleteDatabase(name);
+
+      if (onBlocked != null) {
+        request.onBlocked.listen(onBlocked);
+      }
+      var completer = new Completer.sync();
+      request.onSuccess.listen((e) {
+        completer.complete(this);
+      });
+      request.onError.listen(completer.completeError);
+      return completer.future;
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBFactory.getDatabaseNames')
+  @SupportedBrowser(SupportedBrowser.CHROME)
+  @Experimental()
+  Future<List<String>> getDatabaseNames() {
+    try {
+      var request = _webkitGetDatabaseNames();
+
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  /**
+   * Checks to see if getDatabaseNames is supported by the current platform.
+   */
+  bool get supportsDatabaseNames {
+    return supported && JS('bool',
+        '!!(#.getDatabaseNames || #.webkitGetDatabaseNames)', this, this);
+  }
+
+  // To suppress missing implicit constructor warnings.
+  factory IdbFactory._() { throw new UnsupportedError("Not supported"); }
+
+  @DomName('IDBFactory.cmp')
+  @DocsEditable()
+  int cmp(Object first, Object second) native;
+
+  @JSName('deleteDatabase')
+  @DomName('IDBFactory.deleteDatabase')
+  @DocsEditable()
+  OpenDBRequest _deleteDatabase(String name) native;
+
+  @JSName('open')
+  @DomName('IDBFactory.open')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @Creates('Database')
+  OpenDBRequest _open(String name, [int version]) native;
+
+  @JSName('webkitGetDatabaseNames')
+  @DomName('IDBFactory.webkitGetDatabaseNames')
+  @DocsEditable()
+  @SupportedBrowser(SupportedBrowser.CHROME)
+  @SupportedBrowser(SupportedBrowser.SAFARI)
+  @Experimental()
+  @Returns('Request')
+  @Creates('Request')
+  @Creates('DomStringList')
+  Request _webkitGetDatabaseNames() native;
+
+}
+
+
+/**
+ * Ties a request to a completer, so the completer is completed when it succeeds
+ * and errors out when the request errors.
+ */
+Future _completeRequest(Request request) {
+  var completer = new Completer.sync();
+  // TODO: make sure that completer.complete is synchronous as transactions
+  // may be committed if the result is not processed immediately.
+  request.onSuccess.listen((e) {
+    completer.complete(request.result);
+  });
+  request.onError.listen(completer.completeError);
+  return completer.future;
+}
+// Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DomName('IDBIndex')
+@Unstable()
+@Native("IDBIndex")
+class Index extends Interceptor {
+  @DomName('IDBIndex.count')
+  Future<int> count([key_OR_range]) {
+   try {
+      var request = _count(key_OR_range);
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBIndex.get')
+  Future get(key) {
+    try {
+      var request = _get(key);
+
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBIndex.getKey')
+  Future getKey(key) {
+    try {
+      var request = _getKey(key);
+
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  /**
+   * Creates a stream of cursors over the records in this object store.
+   *
+   * See also:
+   *
+   * * [ObjectStore.openCursor]
+   */
+  Stream<CursorWithValue> openCursor({key, KeyRange range, String direction,
+      bool autoAdvance}) {
+    var key_OR_range = null;
+    if (key != null) {
+      if (range != null) {
+        throw new ArgumentError('Cannot specify both key and range.');
+      }
+      key_OR_range = key;
+    } else {
+      key_OR_range = range;
+    }
+    var request;
+    if (direction == null) {
+      // FIXME: Passing in "next" should be unnecessary.
+      request = _openCursor(key_OR_range, "next");
+    } else {
+      request = _openCursor(key_OR_range, direction);
+    }
+    return ObjectStore._cursorStreamFromResult(request, autoAdvance);
+  }
+
+  /**
+   * Creates a stream of cursors over the records in this object store.
+   *
+   * See also:
+   *
+   * * [ObjectStore.openCursor]
+   */
+  Stream<Cursor> openKeyCursor({key, KeyRange range, String direction,
+      bool autoAdvance}) {
+    var key_OR_range = null;
+    if (key != null) {
+      if (range != null) {
+        throw new ArgumentError('Cannot specify both key and range.');
+      }
+      key_OR_range = key;
+    } else {
+      key_OR_range = range;
+    }
+    var request;
+    if (direction == null) {
+      // FIXME: Passing in "next" should be unnecessary.
+      request = _openKeyCursor(key_OR_range, "next");
+    } else {
+      request = _openKeyCursor(key_OR_range, direction);
+    }
+    return ObjectStore._cursorStreamFromResult(request, autoAdvance);
+  }
+
+    // To suppress missing implicit constructor warnings.
+  factory Index._() { throw new UnsupportedError("Not supported"); }
+
+  @DomName('IDBIndex.keyPath')
+  @DocsEditable()
+  @annotation_Creates_SerializedScriptValue
+  final Object keyPath;
+
+  @DomName('IDBIndex.multiEntry')
+  @DocsEditable()
+  final bool multiEntry;
+
+  @DomName('IDBIndex.name')
+  @DocsEditable()
+  final String name;
+
+  @DomName('IDBIndex.objectStore')
+  @DocsEditable()
+  final ObjectStore objectStore;
+
+  @DomName('IDBIndex.unique')
+  @DocsEditable()
+  final bool unique;
+
+  @JSName('count')
+  @DomName('IDBIndex.count')
+  @DocsEditable()
+  Request _count(Object key) native;
+
+  @JSName('get')
+  @DomName('IDBIndex.get')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @annotation_Creates_SerializedScriptValue
+  Request _get(Object key) native;
+
+  @JSName('getKey')
+  @DomName('IDBIndex.getKey')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @annotation_Creates_SerializedScriptValue
+  @Creates('ObjectStore')
+  Request _getKey(Object key) native;
+
+  @JSName('openCursor')
+  @DomName('IDBIndex.openCursor')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @Creates('Cursor')
+  Request _openCursor(Object range, [String direction]) native;
+
+  @JSName('openKeyCursor')
+  @DomName('IDBIndex.openKeyCursor')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @Creates('Cursor')
+  Request _openKeyCursor(Object range, [String direction]) native;
+
+}
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DomName('IDBKeyRange')
+@Unstable()
+@Native("IDBKeyRange")
+class KeyRange extends Interceptor {
+  @DomName('IDBKeyRange.only')
+  factory KeyRange.only(/*Key*/ value) =>
+      _KeyRangeFactoryProvider.createKeyRange_only(value);
+
+  @DomName('IDBKeyRange.lowerBound')
+  factory KeyRange.lowerBound(/*Key*/ bound, [bool open = false]) =>
+      _KeyRangeFactoryProvider.createKeyRange_lowerBound(bound, open);
+
+  @DomName('IDBKeyRange.upperBound')
+  factory KeyRange.upperBound(/*Key*/ bound, [bool open = false]) =>
+      _KeyRangeFactoryProvider.createKeyRange_upperBound(bound, open);
+
+  @DomName('KeyRange.bound')
+  factory KeyRange.bound(/*Key*/ lower, /*Key*/ upper,
+                            [bool lowerOpen = false, bool upperOpen = false]) =>
+      _KeyRangeFactoryProvider.createKeyRange_bound(
+          lower, upper, lowerOpen, upperOpen);
+
+  // To suppress missing implicit constructor warnings.
+  factory KeyRange._() { throw new UnsupportedError("Not supported"); }
+
+  @DomName('IDBKeyRange.lower')
+  @DocsEditable()
+  @annotation_Creates_SerializedScriptValue
+  final Object lower;
+
+  @DomName('IDBKeyRange.lowerOpen')
+  @DocsEditable()
+  final bool lowerOpen;
+
+  @DomName('IDBKeyRange.upper')
+  @DocsEditable()
+  @annotation_Creates_SerializedScriptValue
+  final Object upper;
+
+  @DomName('IDBKeyRange.upperOpen')
+  @DocsEditable()
+  final bool upperOpen;
+
+  @JSName('bound')
+  @DomName('IDBKeyRange.bound')
+  @DocsEditable()
+  static KeyRange bound_(Object lower, Object upper, [bool lowerOpen, bool upperOpen]) native;
+
+  @JSName('lowerBound')
+  @DomName('IDBKeyRange.lowerBound')
+  @DocsEditable()
+  static KeyRange lowerBound_(Object bound, [bool open]) native;
+
+  @JSName('only')
+  @DomName('IDBKeyRange.only')
+  @DocsEditable()
+  static KeyRange only_(Object value) native;
+
+  @JSName('upperBound')
+  @DomName('IDBKeyRange.upperBound')
+  @DocsEditable()
+  static KeyRange upperBound_(Object bound, [bool open]) native;
+
+}
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DomName('IDBObjectStore')
+@Unstable()
+@Native("IDBObjectStore")
+class ObjectStore extends Interceptor {
+
+  @DomName('IDBObjectStore.add')
+  Future add(value, [key]) {
+    try {
+      var request;
+      if (key != null) {
+        request = _add(value, key);
+      } else {
+        request = _add(value);
+      }
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBObjectStore.clear')
+  Future clear() {
+    try {
+      return _completeRequest(_clear());
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBObjectStore.delete')
+  Future delete(key_OR_keyRange){
+    try {
+      return _completeRequest(_delete(key_OR_keyRange));
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBObjectStore.count')
+  Future<int> count([key_OR_range]) {
+   try {
+      var request = _count(key_OR_range);
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBObjectStore.put')
+  Future put(value, [key]) {
+    try {
+      var request;
+      if (key != null) {
+        request = _put(value, key);
+      } else {
+        request = _put(value);
+      }
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  @DomName('IDBObjectStore.get')
+  Future getObject(key) {
+    try {
+      var request = _get(key);
+
+      return _completeRequest(request);
+    } catch (e, stacktrace) {
+      return new Future.error(e, stacktrace);
+    }
+  }
+
+  /**
+   * Creates a stream of cursors over the records in this object store.
+   *
+   * **The stream must be manually advanced by calling [Cursor.next] after
+   * each item or by specifying autoAdvance to be true.**
+   *
+   *     var cursors = objectStore.openCursor().listen(
+   *       (cursor) {
+   *         // ...some processing with the cursor
+   *         cursor.next(); // advance onto the next cursor.
+   *       },
+   *       onDone: () {
+   *         // called when there are no more cursors.
+   *         print('all done!');
+   *       });
+   *
+   * Asynchronous operations which are not related to the current transaction
+   * will cause the transaction to automatically be committed-- all processing
+   * must be done synchronously unless they are additional async requests to
+   * the current transaction.
+   */
+  @DomName('IDBObjectStore.openCursor')
+  Stream<CursorWithValue> openCursor({key, KeyRange range, String direction,
+      bool autoAdvance}) {
+    var key_OR_range = null;
+    if (key != null) {
+      if (range != null) {
+        throw new ArgumentError('Cannot specify both key and range.');
+      }
+      key_OR_range = key;
+    } else {
+      key_OR_range = range;
+    }
+
+    // TODO: try/catch this and return a stream with an immediate error.
+    var request;
+    if (direction == null) {
+      request = _openCursor(key_OR_range);
+    } else {
+      request = _openCursor(key_OR_range, direction);
+    }
+    return _cursorStreamFromResult(request, autoAdvance);
+  }
+
+  @DomName('IDBObjectStore.createIndex')
+  Index createIndex(String name, keyPath, {bool unique, bool multiEntry}) {
+    var options = {};
+    if (unique != null) {
+      options['unique'] = unique;
+    }
+    if (multiEntry != null) {
+      options['multiEntry'] = multiEntry;
+    }
+
+    return _createIndex(name, keyPath, options);
+  }
+
+  // To suppress missing implicit constructor warnings.
+  factory ObjectStore._() { throw new UnsupportedError("Not supported"); }
+
+  @DomName('IDBObjectStore.autoIncrement')
+  @DocsEditable()
+  final bool autoIncrement;
+
+  @DomName('IDBObjectStore.indexNames')
+  @DocsEditable()
+  @Returns('DomStringList')
+  @Creates('DomStringList')
+  final List<String> indexNames;
+
+  @DomName('IDBObjectStore.keyPath')
+  @DocsEditable()
+  @annotation_Creates_SerializedScriptValue
+  final Object keyPath;
+
+  @DomName('IDBObjectStore.name')
+  @DocsEditable()
+  final String name;
+
+  @DomName('IDBObjectStore.transaction')
+  @DocsEditable()
+  final Transaction transaction;
+
+  @DomName('IDBObjectStore.add')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @_annotation_Creates_IDBKey
+  Request _add(/*any*/ value, [/*any*/ key]) {
+    if (key != null) {
+      var value_1 = convertDartToNative_SerializedScriptValue(value);
+      var key_2 = convertDartToNative_SerializedScriptValue(key);
+      return _add_1(value_1, key_2);
+    }
+    var value_1 = convertDartToNative_SerializedScriptValue(value);
+    return _add_2(value_1);
+  }
+  @JSName('add')
+  @DomName('IDBObjectStore.add')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @_annotation_Creates_IDBKey
+  Request _add_1(value, key) native;
+  @JSName('add')
+  @DomName('IDBObjectStore.add')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @_annotation_Creates_IDBKey
+  Request _add_2(value) native;
+
+  @JSName('clear')
+  @DomName('IDBObjectStore.clear')
+  @DocsEditable()
+  Request _clear() native;
+
+  @JSName('count')
+  @DomName('IDBObjectStore.count')
+  @DocsEditable()
+  Request _count(Object key) native;
+
+  @DomName('IDBObjectStore.createIndex')
+  @DocsEditable()
+  Index _createIndex(String name, keyPath, [Map options]) {
+    if ((keyPath is String || keyPath == null) && options == null) {
+      return _createIndex_1(name, keyPath);
+    }
+    if (options != null && (keyPath is String || keyPath == null)) {
+      var options_1 = convertDartToNative_Dictionary(options);
+      return _createIndex_2(name, keyPath, options_1);
+    }
+    if ((keyPath is List<String> || keyPath == null) && options == null) {
+      List keyPath_1 = convertDartToNative_StringArray(keyPath);
+      return _createIndex_3(name, keyPath_1);
+    }
+    if (options != null && (keyPath is List<String> || keyPath == null)) {
+      List keyPath_1 = convertDartToNative_StringArray(keyPath);
+      var options_2 = convertDartToNative_Dictionary(options);
+      return _createIndex_4(name, keyPath_1, options_2);
+    }
+    throw new ArgumentError("Incorrect number or type of arguments");
+  }
+  @JSName('createIndex')
+  @DomName('IDBObjectStore.createIndex')
+  @DocsEditable()
+  Index _createIndex_1(name, String keyPath) native;
+  @JSName('createIndex')
+  @DomName('IDBObjectStore.createIndex')
+  @DocsEditable()
+  Index _createIndex_2(name, String keyPath, options) native;
+  @JSName('createIndex')
+  @DomName('IDBObjectStore.createIndex')
+  @DocsEditable()
+  Index _createIndex_3(name, List keyPath) native;
+  @JSName('createIndex')
+  @DomName('IDBObjectStore.createIndex')
+  @DocsEditable()
+  Index _createIndex_4(name, List keyPath, options) native;
+
+  @JSName('delete')
+  @DomName('IDBObjectStore.delete')
+  @DocsEditable()
+  Request _delete(Object key) native;
+
+  @DomName('IDBObjectStore.deleteIndex')
+  @DocsEditable()
+  void deleteIndex(String name) native;
+
+  @JSName('get')
+  @DomName('IDBObjectStore.get')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @annotation_Creates_SerializedScriptValue
+  Request _get(Object key) native;
+
+  @DomName('IDBObjectStore.index')
+  @DocsEditable()
+  Index index(String name) native;
+
+  @JSName('openCursor')
+  @DomName('IDBObjectStore.openCursor')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @Creates('Cursor')
+  Request _openCursor(Object range, [String direction]) native;
+
+  @DomName('IDBObjectStore.openKeyCursor')
+  @DocsEditable()
+  @Experimental() // untriaged
+  Request openKeyCursor(Object range, [String direction]) native;
+
+  @DomName('IDBObjectStore.put')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @_annotation_Creates_IDBKey
+  Request _put(/*any*/ value, [/*any*/ key]) {
+    if (key != null) {
+      var value_1 = convertDartToNative_SerializedScriptValue(value);
+      var key_2 = convertDartToNative_SerializedScriptValue(key);
+      return _put_1(value_1, key_2);
+    }
+    var value_1 = convertDartToNative_SerializedScriptValue(value);
+    return _put_2(value_1);
+  }
+  @JSName('put')
+  @DomName('IDBObjectStore.put')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @_annotation_Creates_IDBKey
+  Request _put_1(value, key) native;
+  @JSName('put')
+  @DomName('IDBObjectStore.put')
+  @DocsEditable()
+  @Returns('Request')
+  @Creates('Request')
+  @_annotation_Creates_IDBKey
+  Request _put_2(value) native;
+
+
+  /**
+   * Helper for iterating over cursors in a request.
+   */
+  static Stream<Cursor> _cursorStreamFromResult(Request request,
+      bool autoAdvance) {
+    // TODO: need to guarantee that the controller provides the values
+    // immediately as waiting until the next tick will cause the transaction to
+    // close.
+    var controller = new StreamController(sync: true);
+
+    //TODO: Report stacktrace once issue 4061 is resolved.
+    request.onError.listen(controller.addError);
+
+    request.onSuccess.listen((e) {
+      Cursor cursor = request.result;
+      if (cursor == null) {
+        controller.close();
+      } else {
+        controller.add(cursor);
+        if (autoAdvance == true && controller.hasListener) {
+          cursor.next();
+        }
+      }
+    });
+    return controller.stream;
+  }
+}
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DocsEditable()
+@DomName('IDBOpenDBRequest')
+@Unstable()
+@Native("IDBOpenDBRequest,IDBVersionChangeRequest")
+class OpenDBRequest extends Request {
+  // To suppress missing implicit constructor warnings.
+  factory OpenDBRequest._() { throw new UnsupportedError("Not supported"); }
+
+  /**
+   * Static factory designed to expose `blocked` events to event
+   * handlers that are not necessarily instances of [OpenDBRequest].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBOpenDBRequest.blockedEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> blockedEvent = const EventStreamProvider<Event>('blocked');
+
+  /**
+   * Static factory designed to expose `upgradeneeded` events to event
+   * handlers that are not necessarily instances of [OpenDBRequest].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBOpenDBRequest.upgradeneededEvent')
+  @DocsEditable()
+  static const EventStreamProvider<VersionChangeEvent> upgradeNeededEvent = const EventStreamProvider<VersionChangeEvent>('upgradeneeded');
+
+  /// Stream of `blocked` events handled by this [OpenDBRequest].
+  @DomName('IDBOpenDBRequest.onblocked')
+  @DocsEditable()
+  Stream<Event> get onBlocked => blockedEvent.forTarget(this);
+
+  /// Stream of `upgradeneeded` events handled by this [OpenDBRequest].
+  @DomName('IDBOpenDBRequest.onupgradeneeded')
+  @DocsEditable()
+  Stream<VersionChangeEvent> get onUpgradeNeeded => upgradeNeededEvent.forTarget(this);
+}
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DocsEditable()
+@DomName('IDBRequest')
+@Unstable()
+@Native("IDBRequest")
+class Request extends EventTarget {
+  // To suppress missing implicit constructor warnings.
+  factory Request._() { throw new UnsupportedError("Not supported"); }
+
+  /**
+   * Static factory designed to expose `error` events to event
+   * handlers that are not necessarily instances of [Request].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBRequest.errorEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> errorEvent = const EventStreamProvider<Event>('error');
+
+  /**
+   * Static factory designed to expose `success` events to event
+   * handlers that are not necessarily instances of [Request].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBRequest.successEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> successEvent = const EventStreamProvider<Event>('success');
+
+  @DomName('IDBRequest.error')
+  @DocsEditable()
+  final DomError error;
+
+  @DomName('IDBRequest.readyState')
+  @DocsEditable()
+  final String readyState;
+
+  @DomName('IDBRequest.result')
+  @DocsEditable()
+  dynamic get result => _convertNativeToDart_IDBAny(this._get_result);
+  @JSName('result')
+  @DomName('IDBRequest.result')
+  @DocsEditable()
+  @Creates('Null')
+  final dynamic _get_result;
+
+  @DomName('IDBRequest.source')
+  @DocsEditable()
+  @Creates('Null')
+  final Object source;
+
+  @DomName('IDBRequest.transaction')
+  @DocsEditable()
+  final Transaction transaction;
+
+  /// Stream of `error` events handled by this [Request].
+  @DomName('IDBRequest.onerror')
+  @DocsEditable()
+  Stream<Event> get onError => errorEvent.forTarget(this);
+
+  /// Stream of `success` events handled by this [Request].
+  @DomName('IDBRequest.onsuccess')
+  @DocsEditable()
+  Stream<Event> get onSuccess => successEvent.forTarget(this);
+}
+// Copyright (c) 2013, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DomName('IDBTransaction')
+@Unstable()
+@Native("IDBTransaction")
+class Transaction extends EventTarget {
+
+  /**
+   * Provides a Future which will be completed once the transaction has
+   * completed.
+   *
+   * The future will error if an error occurrs on the transaction or if the
+   * transaction is aborted.
+   */
+  Future<Database> get completed {
+    var completer = new Completer<Database>();
+
+    this.onComplete.first.then((_) {
+      completer.complete(db);
+    });
+
+    this.onError.first.then((e) {
+      completer.completeError(e);
+    });
+
+    this.onAbort.first.then((e) {
+      // Avoid completing twice if an error occurs.
+      if (!completer.isCompleted) {
+        completer.completeError(e);
+      }
+    });
+
+    return completer.future;
+  }
+
+  // To suppress missing implicit constructor warnings.
+  factory Transaction._() { throw new UnsupportedError("Not supported"); }
+
+  /**
+   * Static factory designed to expose `abort` events to event
+   * handlers that are not necessarily instances of [Transaction].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBTransaction.abortEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> abortEvent = const EventStreamProvider<Event>('abort');
+
+  /**
+   * Static factory designed to expose `complete` events to event
+   * handlers that are not necessarily instances of [Transaction].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBTransaction.completeEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> completeEvent = const EventStreamProvider<Event>('complete');
+
+  /**
+   * Static factory designed to expose `error` events to event
+   * handlers that are not necessarily instances of [Transaction].
+   *
+   * See [EventStreamProvider] for usage information.
+   */
+  @DomName('IDBTransaction.errorEvent')
+  @DocsEditable()
+  static const EventStreamProvider<Event> errorEvent = const EventStreamProvider<Event>('error');
+
+  @DomName('IDBTransaction.db')
+  @DocsEditable()
+  final Database db;
+
+  @DomName('IDBTransaction.error')
+  @DocsEditable()
+  final DomError error;
+
+  @DomName('IDBTransaction.mode')
+  @DocsEditable()
+  final String mode;
+
+  @DomName('IDBTransaction.abort')
+  @DocsEditable()
+  void abort() native;
+
+  @DomName('IDBTransaction.objectStore')
+  @DocsEditable()
+  ObjectStore objectStore(String name) native;
+
+  /// Stream of `abort` events handled by this [Transaction].
+  @DomName('IDBTransaction.onabort')
+  @DocsEditable()
+  Stream<Event> get onAbort => abortEvent.forTarget(this);
+
+  /// Stream of `complete` events handled by this [Transaction].
+  @DomName('IDBTransaction.oncomplete')
+  @DocsEditable()
+  Stream<Event> get onComplete => completeEvent.forTarget(this);
+
+  /// Stream of `error` events handled by this [Transaction].
+  @DomName('IDBTransaction.onerror')
+  @DocsEditable()
+  Stream<Event> get onError => errorEvent.forTarget(this);
+
+}
+// Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
+// for details. All rights reserved. Use of this source code is governed by a
+// BSD-style license that can be found in the LICENSE file.
+
+
+@DocsEditable()
+@DomName('IDBVersionChangeEvent')
+@Unstable()
+@Native("IDBVersionChangeEvent")
+class VersionChangeEvent extends Event {
+  // To suppress missing implicit constructor warnings.
+  factory VersionChangeEvent._() { throw new UnsupportedError("Not supported"); }
+
+  @DomName('IDBVersionChangeEvent.dataLoss')
+  @DocsEditable()
+  @Experimental() // untriaged
+  final String dataLoss;
+
+  @DomName('IDBVersionChangeEvent.dataLossMessage')
+  @DocsEditable()
+  @Experimental() // untriaged
+  final String dataLossMessage;
+
+  @DomName('IDBVersionChangeEvent.newVersion')
+  @DocsEditable()
+  @Creates('int|String|Null')
+  @Returns('int|String|Null')
+  final int newVersion;
+
+  @DomName('IDBVersionChangeEvent.oldVersion')
+  @DocsEditable()
+  @Creates('int|String|Null')
+  @Returns('int|String|Null')
+  final int oldVersion;
+}