particle-api-js 10.3.1 → 10.4.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "particle-api-js",
-  "version": "10.3.1",
+  "version": "10.4.1",
   "description": "Particle API Client",
   "main": "src/Particle.js",
   "scripts": {

package/src/Particle.js

@@ -2485,17 +2485,17 @@ class Particle {
      * @param {string} [options.org]       The Organization ID or slug. If not provided, the request will go to your sandbox account.
      * @param {string} options.ledgerName  Ledger name.
      * @param {string} options.scopeValue  Scope value.
-     * @param {object} options.data        The data to set to the instance
+     * @param {object} options.instance    The instance with the data
      * @param {Object} [options.headers]   Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
      * @param {Object} [options.context]   Request context.
      *
      * @returns {Promise<RequestResponse>} A promise that resolves to the updated ledger instance data.
      */
-    setLedgerInstance({ auth, org, ledgerName, scopeValue, data, headers, context }) {
+    setLedgerInstance({ auth, org, ledgerName, scopeValue, instance, headers, context }) {
         return this.put({
             uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}`),
             auth,
-            data: { data },
+            data: { instance },
             headers,
             context
         });
@@ -2550,6 +2550,57 @@ class Particle {
         });
     }
 
+    /**
+     * List ledger instance versions
+     *
+     * @param {Object} options                   The options for the ledger instance.
+     * @param {Auth}   [options.auth]            The access token or basic auth object. Can be ignored if provided in constructor
+     * @param {string} [options.org]             The Organization ID or slug. If not provided, the request will go to your sandbox account.
+     * @param {string} options.ledgerName        Ledger name.
+     * @param {string} options.scopeValue        Scope value.
+     * @param {string} [options.replacedBefore]  ISO date string to filter to instances replaced before this time
+     * @param {string} [options.replacedAfter]   ISO date string to filter to instances replaced after this time
+     * @param {Object} [options.headers]         Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
+     * @param {Object} [options.context]         Request context
+     *
+     * @returns {Promise<RequestResponse>} A promise that resolves to an array of ledger instance data.
+     */
+    listLedgerInstanceVersions({ auth, org, ledgerName, scopeValue, replacedBefore, replacedAfter, headers, context }) {
+        return this.get({
+            uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}/versions`),
+            query: {
+                replaced_before: replacedBefore,
+                replaced_after: replacedAfter
+            },
+            auth,
+            headers,
+            context
+        });
+    }
+
+    /**
+     * Get specific ledger instance version
+     *
+     * @param {Object} options             The options for the ledger instance.
+     * @param {Auth}   [options.auth]      The access token or basic auth object. Can be ignored if provided in constructor
+     * @param {string} [options.org]       The Organization ID or slug. If not provided, the request will go to your sandbox account.
+     * @param {string} options.ledgerName  Ledger name.
+     * @param {string} options.scopeValue  Scope value.
+     * @param {string} options.version     Version of the ledger instance
+     * @param {Object} [options.headers]   Key/Value pairs like `{ 'X-FOO': 'foo', X-BAR: 'bar' }` to send as headers.
+     * @param {Object} [options.context]   Request context
+     *
+     * @returns {Promise<RequestResponse>} A promise that resolves to the specified ledger instance data.
+     */
+    getLedgerInstanceVersion({ auth, org, ledgerName, scopeValue, version, headers, context }) {
+        return this.get({
+            uri: this._namespacedPath(org, `ledgers/${ledgerName}/instances/${scopeValue}/versions/${version}`),
+            auth,
+            headers,
+            context
+        });
+    }
+
     /**
      * Set default auth token that will be used in each method if `auth` is not provided
      * @param {Auth} auth The access token or basic auth object

package/test/Particle.spec.js

@@ -142,7 +142,10 @@ const props = {
         description: 'my ledger',
         direction: 'Downstream'
     },
-    scopeValue: '1234'
+    scopeValue: '1234',
+    instance: {
+        property: 'yes'
+    }
 };
 
 const product = 'ze-product-v1';
@@ -2869,8 +2872,8 @@ describe('ParticleAPI', () => {
                         uri: `/v1/orgs/${org}/ledgers/${props.ledgerName}/instances/${props.scopeValue}`,
                         auth: props.auth,
                         data: {
-                            data: {
-                                sentient: true
+                            instance: {
+                                property: 'yes'
                             }
                         }
                     });
@@ -2901,6 +2904,30 @@ describe('ParticleAPI', () => {
                 });
             });
         });
+
+        describe('listLedgerInstanceVersions', () => {
+            it('generates request', () => {
+                return api.listLedgerInstanceVersions(propsWithOrg).then((results) => {
+                    results.should.match({
+                        method: 'get',
+                        uri: `/v1/orgs/${org}/ledgers/${props.ledgerName}/instances/${props.scopeValue}/versions`,
+                        auth: props.auth
+                    });
+                });
+            });
+        });
+
+        describe('.getLedgerInstanceVersion', () => {
+            it('generates request', () => {
+                return api.getLedgerInstanceVersion(propsWithOrg).then((results) => {
+                    results.should.match({
+                        method: 'get',
+                        uri: `/v1/orgs/${org}/ledgers/${props.ledgerName}/instances/${props.scopeValue}/versions/${props.version}`,
+                        auth: props.auth
+                    });
+                });
+            });
+        });
     });
 
     describe('backwards-compatibility function aliases', () => {