Add version properties to API objects

Author: zolkis

README.md

@@ -9,7 +9,7 @@ The following JavaScript APIs are aimed for handling Internet of Things (IoT) ap
   - [OCF API Test Suite](./ocf/test-suite/README.md)
 * [Bluetooth Smart API](./ble/README.md), exposing functionality for Bluetooth Peripheral mode
 * [Sensor API](./sensors/README.md), exposing sensor functionality supported on the device
-* [Board API](./board/README.md) provides low level interfaces for I/O operations supported by the device board, so that applications could implement support for new types of sensors that are not supported by the Sensor API.
+* [Board API](./board/README.md) providing low-level interfaces for I/O operations supported by the device board, so that applications could implement support for new types of sensors that are not supported by the Sensor API.
 
 Since implementations of these APIs exist also on constrained hardware, they might not support the latest [ECMAScript](http://www.ecma-international.org) versions. However, implementations should support at least [ECMAScript 5.1](http://www.ecma-international.org/ecma-262/5.1/). Examples are limited to ECMAScript 5.1 with the exception of using [Promises](#promise).
 

ble/README.md

@@ -46,6 +46,7 @@ This object is created and returned by `require`. It has the following read-only
 | `name`      | String | yes | `undefined` | the Bluetooth Device Name in scan responses |
 | `enabled`   | boolean | no | false | whether Bluetooth is enabled |
 | `services`  | array of [service objects](#service) | no | [] | Primary services on the device |
+| `version`   | string  | no      | `version` in[`package.json`](../package.json) | API version |
 
 | Event name        | Event callback argument |
 | ---               | ---                     |
@@ -80,6 +81,9 @@ The `enabled` property MUST be set to `true` if the Bluetooth Smart functionalit
 <a name="bd_services">
 The `services` property is a read-only array (sequence) of [`BluetoothService`](#service) objects that represents the primary GATT services on the device. A primary service is visible at device root level, and it may contain other services.
 
+<a name="version"></a>
+The `version` property is read-only, and provides the master API version, as specified in the `version` property of [`package.json`](../package.json).
+
 #### `BluetoothPeripheralDevice` events
 
 <a name="onstatechange"></a>

board/README.md

@@ -55,6 +55,7 @@ Represents a hardware board.
 | Property          | Type   | Optional | Default value | Represents |
 | ---               | ---    | ---      | ---           | ---        |
 | [`name`](#name)   | String | no       | `undefined`   | board name |
+| [`version`](#version) | String | no   | `versions.board` in [`package.json`](../package.json) | API version |
 
 | Method signature  | Description            |
 | ---               | ---                    |
@@ -72,6 +73,9 @@ Represents a hardware board.
 <a name="name"></a>
 The `name` property is read-only, and provides the board name.
 
+<a name="version"></a>
+The `version` property is read-only, and provides the provides the Board API version, as specified in the `versions.board` property of [`package.json`](../package.json).
+
 <a name="error"></a>
 Board errors are represented as augmented [`Error`](https://nodejs.org/api/errors.html#errors_class_error) objects. The following [`Error` names](https://nodejs.org/api/errors.html) are used for signaling issues:
 - `BoardDisconnectError`

ocf/README.md

@@ -43,13 +43,19 @@ var ocf = require(module);
 ```
 If the functionality is not supported by the platform, `require` should throw `NotSupportedError`. If there is no permission for using the functionality, `require` should throw `SecurityError`.
 
-When `require` is successful, it MUST return an object with the following methods.
+When `require` is successful, it MUST return an object with the following properties and methods.
+
+|Property    |Type     |Optional |Default value | Represents  |
+| ---        | ---     | ---     | ---          |
+| `version`  | string  | no      | `versions.ocf` in [`package.json`](../package.json) | API version |
 
 | Method signature                | Description                |
 | ---                             | ---                        |
 | [`start(mode, options)`](#ocfstart)| start the OCF stack     |
 | [`stop()`](#ocfstop)            | stop the OCF stack         |
 
+The `version` property is read only and provides the the OCF API specification, as specified in the `versions.ocf` property of [`package.json`](../package.json).
+
 <a name="ocfstart"></a>
 The `start(options)` method initializes the underlying platform and resolves with an API object providing OCF client, or server, or both client-server functionality.
 

versions.json renamed to package.json

@@ -3,10 +3,12 @@
   "description": "OCF JS API specifications and test suites",
 
   "version": "1.0",
-  "ocfApiVersion": "oic1.1.0-0",
-  "bleApiVersion": "1.0",
-  "boardApiVersion": "1.0",
-  "sensorApiVersion": "1.0",
+  "versions": {
+    "ocf": "oic1.1.0-0",
+    "ble": "1.0",
+    "board": "1.0",
+    "sensor": "1.0",
+  },
 
   "license": "Apache-2.0",