/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this file,
 * You can obtain one at http://mozilla.org/MPL/2.0/.
 *
 * The origin of this IDL file is
 * http://dvcs.w3.org/hg/html-media/raw-file/default/media-source/media-source.html
 *
 * Copyright © 2012 W3C® (MIT, ERCIM, Keio), All Rights Reserved. W3C
 * liability, trademark and document use rules apply.
 */

enum SourceBufferAppendMode {
    "segments",
    "sequence"
};

[Pref="media.mediasource.enabled",
 Exposed=Window]
interface SourceBuffer : EventTarget {
  [SetterThrows]
  attribute SourceBufferAppendMode mode;
  readonly attribute boolean updating;
  [Throws]
  readonly attribute TimeRanges buffered;
  [SetterThrows]
  attribute double timestampOffset;
  //readonly attribute AudioTrackList audioTracks;
  //readonly attribute VideoTrackList videoTracks;
  //readonly attribute TextTrackList textTracks;
  [SetterThrows]
  attribute double appendWindowStart;
  [SetterThrows]
  attribute unrestricted double appendWindowEnd;
  attribute EventHandler onupdatestart;
  attribute EventHandler onupdate;
  attribute EventHandler onupdateend;
  attribute EventHandler onerror;
  attribute EventHandler onabort;
  [Throws]
  undefined appendBuffer(ArrayBuffer data);
  [Throws]
  undefined appendBuffer(ArrayBufferView data);
  //[Throws]
  //undefined appendStream(Stream stream, [EnforceRange] optional unsigned long long maxSize);
  [Throws]
  undefined abort();
  [Throws]
  undefined remove(double start, unrestricted double end);
};

// Mozilla extensions for experimental features
partial interface SourceBuffer {
  // Experimental function as proposed in:
  // https://github.com/w3c/media-source/issues/100 for promise proposal.
  [NewObject, Pref="media.mediasource.experimental.enabled"]
  Promise<undefined> appendBufferAsync(ArrayBuffer data);
  [NewObject, Pref="media.mediasource.experimental.enabled"]
  Promise<undefined> appendBufferAsync(ArrayBufferView data);
  [NewObject, Pref="media.mediasource.experimental.enabled"]
  Promise<undefined> removeAsync(double start, unrestricted double end);

  // Experimental function as proposed in:
  // https://github.com/w3c/media-source/issues/155
  [Throws]
  undefined changeType(DOMString type);
};