Merge pull request #44 from zolkis/gh-pages

New version of the Web NFC specification and the Security and Privacy document.

Author: anssiko

idl/draft.idl

@@ -1,3 +1,4 @@
+
 partial interface Navigator {
     readonly attribute NFC nfc;
 };
@@ -6,30 +7,38 @@ interface NFC {
     Promise<NFCAdapter> requestAdapter();
 };
 
-interface NFCAdapter : EventTarget {
-    attribute EventHandler onmessage;
-    Promise<void> send (NFCMessage message, optional NFCSendOptions options);
-};
+interface NFCAdapter {
+    Promise<void> pushMessage(NFCMessage message, optional NFCPushOptions options);
+    void cancelPush();
 
-interface NFCMessageEvent : Event {
-    readonly attribute NFCMessage message;
+    Promise<long> watch(NFCWatchOptions options, MessageCallback callback);
+    Promise<void> unwatch(long id);
 };
 
-[NoInterfaceObject]
-interface NFCMessage {
-    readonly attribute USVString     scope;
-    readonly attribute sequence<any> data; // (DOMString or URL or Blob or JSON)
+dictionary NFCPushOptions {
+    NFCDeviceType target;
+    long timeout;  // in ms, default (and max) is 10sec, UAs MAY shorten it
 };
 
-typedef (DOMString or URL or Blob or JSON) NFCData;
+enum NFCPushTarget { "tag", "peer", "any" };
 
-enum NFCTarget {
-    "tag",
-    "peer",
-    "any"
-};
+dictionary NFCWatchOptions {
+    USVString url;  // domain/path or URL pattern
+    USVString kind;
+    USVString type;
+    NFCWatchMode mode;
+}
 
-dictionary NFCSendOptions {
-    NFCTarget target;
+enum NFCWatchMode { "web-only", "all" };
+
+callback MessageCallback = void (NFCMessage message, USVString url);
+
+dictionary NFCRecord {
+    NFCRecordType kind;  // based on TNF + JSON
+    USVString type;  // IANA media type, with parameters
+    any data;  // null, string (text, url), Object (json), ArrayBuffer
 };
 
+typedef sequence<NFCRecord> NFCMessage;
+
+enum NFCRecordType { "empty", "text", "url", "json", "opaque" };