node-red-contrib-tractive 0.1.0 → 1.0.0

package/README.md

@@ -1,38 +1,112 @@
 # node-red-contrib-tractive
 
-A Node-RED palette for integrating [Tractive](https://tractive.com) GPS trackers into your flows.
+A Node-RED palette for the [Tractive](https://tractive.com) GPS tracker API. Monitor your pet's battery level, location, and history — and control LED and buzzer — directly from your flows.
 
 ## Installation
 
+Install via the Node-RED Palette Manager (search for `node-red-contrib-tractive`), or from the command line in your Node-RED data directory:
+
 ```bash
-cd ~/.node-red
 npm install node-red-contrib-tractive
 ```
 
-Or install directly from the Node-RED palette manager by searching for `node-red-contrib-tractive`.
-
 ## Nodes
 
-| Node | Description |
-|------|-------------|
-| `tractive-config` | Shared credentials node — stores your Tractive email/password securely |
-| `tractive-location` | Get the current GPS location of a tracker |
-| `tractive-tracker` | Get tracker info or hardware status (battery level, signal) |
-| `tractive-history` | Get location history for a tracker over a time window |
-| `tractive-pets` | Get all pets or a specific pet on the account |
-| `tractive-control` | Send commands to a tracker (live tracking on/off) |
+### tractive-config
+
+A configuration node that stores your Tractive account credentials. One config node per account — shared across all `tractive-tracker` nodes in your flow.
+
+| Field    | Description                         |
+|----------|-------------------------------------|
+| Email    | Your Tractive account email         |
+| Password | Your Tractive account password      |
+
+Authentication is performed automatically when the first operation runs.
+
+---
+
+### tractive-tracker
 
-## Usage
+Calls the Tractive API for a specific tracker. Configure the **Tracker ID** once (find it in the Tractive app under **Settings → Device → Device ID**) and select the operation.
 
-1. Add a **tractive-config** node and enter your Tractive account credentials.
-2. Connect any other Tractive node to the config node.
-3. Pass a `trackerID` in `msg.payload` or configure it directly on the node.
-4. Results are returned in `msg.payload`.
+#### Operations
 
-## Attribution
+| Operation               | Description                                              |
+|-------------------------|----------------------------------------------------------|
+| Get hardware            | Battery level and charging state                         |
+| Get location            | Latest GPS fix with coordinates and address              |
+| Get history             | Location history (requires `msg.from` and `msg.to`)      |
+| Live tracking ON / OFF  | Enable or disable 2.5-second position updates            |
+| LED ON / OFF            | Trigger the tracker's LED light                          |
+| Buzzer ON / OFF         | Trigger the tracker's buzzer                             |
+| Get pets                | List all pets on the account                             |
+| Get all trackers        | List all trackers on the account                         |
 
-Built on [tractive](https://github.com/FAXES/tractive) by [FAXES](https://github.com/FAXES) — ISC licence.
+#### Runtime overrides
+
+| Property        | Description                                    |
+|-----------------|------------------------------------------------|
+| `msg.trackerID` | Overrides the Tracker ID set in the node       |
+| `msg.operation` | Overrides the operation set in the node        |
+| `msg.from`      | Start timestamp in ms (Get history only)       |
+| `msg.to`        | End timestamp in ms (Get history only)         |
+
+#### Output
+
+`msg.payload` contains the raw API response object.
+
+#### Example — battery monitor
+
+```
+[inject every 5 min] → [tractive-tracker: getTrackerHardware] → [msg.payload.battery_level] → [display]
+```
+
+## JavaScript library
+
+The package also works as a standalone ESM library:
+
+```js
+import tractive from 'node-red-contrib-tractive';
+
+await tractive.connect('email@example.com', 'password');
+
+const hw = await tractive.getTrackerHardware('YOUR_TRACKER_ID');
+console.log(hw.battery_level); // e.g. 85
+
+const location = await tractive.getTrackerLocation('YOUR_TRACKER_ID');
+console.log(location.latlong); // e.g. [-33.86, 151.20]
+```
+
+### All functions
+
+```js
+// Account
+getAccountInfo()
+getAccountSubscriptions()
+getAccountSubscription(subscriptionID)
+getAccountShares()
+
+// Pet
+getPets()
+getPet(petID)
+
+// Tracker
+getAllTrackers()
+getTracker(trackerID)
+getTrackerLocation(trackerID)
+getTrackerHardware(trackerID)       // includes battery_level, charging_state
+getTrackerHistory(trackerID, from, to)  // from/to are timestamps in ms
+
+// Commands
+liveOn(trackerID)
+liveOff(trackerID)
+LEDOn(trackerID)
+LEDOff(trackerID)
+buzzerOn(trackerID)
+buzzerOff(trackerID)
+```
 
-## Licence
+## Notes
 
-MIT
+- Rate-limited requests (HTTP 4006) are automatically retried up to 3 times with a 2-second delay.
+- This package is not affiliated with or maintained by Tractive. Tractive is a registered trademark of Tractive GmbH.

package/index.js

@@ -1 +1,116 @@
-// Nodes registered here once built
+import * as tAccount from './src/account.js';
+import * as tPet from './src/pet.js';
+import * as tTracker from './src/tracker.js';
+import * as tCommands from './src/commands.js';
+
+const TractiveClient = "6536c228870a3c8857d452e8";
+
+globalThis.accountDetails = {
+    email: "",
+    password: ""
+};
+
+globalThis.gloOpts = {
+    method: "GET",
+    hostname: "graph.tractive.com",
+    path: ``,
+    headers: {
+        "X-Tractive-Client": TractiveClient,
+        "Authorization": `Bearer ${accountDetails.token}`,
+        "content-type": "application/json"
+    }
+};
+
+globalThis.isAuthenticated = function() {
+    if(accountDetails?.token) return true;
+    return false;
+}
+
+async function authenticate() {
+    const options = {
+        method: "POST",
+        headers: {
+            'X-Tractive-Client': TractiveClient,
+            'Content-Type': "application/json"
+        }
+    };
+
+    const url = `https://graph.tractive.com/4/auth/token?grant_type=tractive&platform_email=${encodeURIComponent(accountDetails.email)}&platform_token=${encodeURIComponent(accountDetails.password)}`;
+
+    try {
+        const res = await fetch(url, options);
+        const data = await res.json();
+        accountDetails.token = data.access_token;
+        accountDetails.uid = data.user_id;
+        globalThis.gloOpts = {
+            method: "GET",
+            hostname: "graph.tractive.com",
+            path: ``,
+            headers: {
+                "X-Tractive-Client": TractiveClient,
+                "Authorization": `Bearer ${accountDetails.token}`,
+                "content-type": "application/json"
+            }
+        };
+        return true;
+    } catch (err) {
+        return false;
+    }
+}
+
+async function connect(email, password) {
+    accountDetails.email = email;
+    accountDetails.password = password;
+    await authenticate();
+    return isAuthenticated() ? true : false;
+}
+
+async function getTrackerGeofences(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/tracker/${trackerID}/geofences`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}
+
+async function getGeofence(fenceID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/geofence/${fenceID}`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}
+
+export default {
+    connect,
+    isAuthenticated,
+    getTrackerGeofences,
+    getGeofence,
+    // Account
+    getAccountInfo: tAccount.getAccountInfo,
+    getAccountSubscriptions: tAccount.getAccountSubscriptions,
+    getAccountSubscription: tAccount.getAccountSubscription,
+    getAccountShares: tAccount.getAccountShares,
+    // Pet
+    getPets: tPet.getPets,
+    getPet: tPet.getPet,
+    // Tracker
+    getAllTrackers: tTracker.getAllTrackers,
+    getTracker: tTracker.getTracker,
+    getTrackerHistory: tTracker.getTrackerHistory,
+    getTrackerLocation: tTracker.getTrackerLocation,
+    getTrackerHardware: tTracker.getTrackerHardware,
+    // Commands
+    liveOn: tCommands.liveOn,
+    liveOff: tCommands.liveOff,
+    LEDOn: tCommands.LEDOn,
+    LEDOff: tCommands.LEDOff,
+    buzzerOn: tCommands.BuzzerOn,
+    buzzerOff: tCommands.BuzzerOff
+};

package/nodes/tractive-config.cjs

@@ -0,0 +1,25 @@
+module.exports = function (RED) {
+    // Import the ESM tractive module once at load time
+    let tractivePromise = import('../index.js').then(m => m.default);
+
+    function TractiveConfigNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        node.email = config.email;
+
+        node.getClient = async function () {
+            const tractive = await tractivePromise;
+            if (!tractive.isAuthenticated()) {
+                const ok = await tractive.connect(node.email, node.credentials.password);
+                if (!ok) throw new Error('Tractive authentication failed');
+            }
+            return tractive;
+        };
+    }
+
+    RED.nodes.registerType('tractive-config', TractiveConfigNode, {
+        credentials: {
+            password: { type: 'password' }
+        }
+    });
+};

package/nodes/tractive-config.html

@@ -0,0 +1,25 @@
+<script type="text/javascript">
+    RED.nodes.registerType('tractive-config', {
+        category: 'config',
+        defaults: {
+            email: { value: '', required: true }
+        },
+        credentials: {
+            password: { type: 'password' }
+        },
+        label: function () {
+            return this.email || 'Tractive Account';
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="tractive-config">
+    <div class="form-row">
+        <label for="node-config-input-email"><i class="fa fa-envelope"></i> Email</label>
+        <input type="email" id="node-config-input-email" placeholder="your@email.com" style="width:70%">
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-password"><i class="fa fa-lock"></i> Password</label>
+        <input type="password" id="node-config-input-password" style="width:70%">
+    </div>
+</script>

package/nodes/tractive-tracker.cjs

@@ -0,0 +1,74 @@
+module.exports = function (RED) {
+    function TractiveTrackerNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+        node.configNode = RED.nodes.getNode(config.config);
+        node.operation = config.operation;
+        node.trackerID = config.trackerID;
+
+        node.on('input', async function (msg) {
+            if (!node.configNode) {
+                node.error('No Tractive config selected', msg);
+                return;
+            }
+
+            const operation = msg.operation || node.operation;
+            const trackerID = msg.trackerID || node.trackerID;
+
+            try {
+                node.status({ fill: 'blue', shape: 'dot', text: operation });
+                const tractive = await node.configNode.getClient();
+
+                let result;
+                switch (operation) {
+                    case 'getAllTrackers':
+                        result = await tractive.getAllTrackers();
+                        break;
+                    case 'getTrackerLocation':
+                        result = await tractive.getTrackerLocation(trackerID);
+                        break;
+                    case 'getTrackerHardware':
+                        result = await tractive.getTrackerHardware(trackerID);
+                        break;
+                    case 'getTrackerHistory':
+                        result = await tractive.getTrackerHistory(trackerID, msg.from, msg.to);
+                        break;
+                    case 'getPets':
+                        result = await tractive.getPets();
+                        break;
+                    case 'liveOn':
+                        result = await tractive.liveOn(trackerID);
+                        break;
+                    case 'liveOff':
+                        result = await tractive.liveOff(trackerID);
+                        break;
+                    case 'LEDOn':
+                        result = await tractive.LEDOn(trackerID);
+                        break;
+                    case 'LEDOff':
+                        result = await tractive.LEDOff(trackerID);
+                        break;
+                    case 'buzzerOn':
+                        result = await tractive.buzzerOn(trackerID);
+                        break;
+                    case 'buzzerOff':
+                        result = await tractive.buzzerOff(trackerID);
+                        break;
+                    default:
+                        node.error(`Unknown operation: ${operation}`, msg);
+                        node.status({ fill: 'red', shape: 'ring', text: 'unknown operation' });
+                        return;
+                }
+
+                node.status({ fill: 'green', shape: 'dot', text: 'ok' });
+                msg.payload = result;
+                node.send(msg);
+            } catch (err) {
+                node.status({ fill: 'red', shape: 'ring', text: err.message });
+                node.error(err, msg);
+            }
+        });
+    }
+
+    RED.nodes.registerType('tractive-tracker', TractiveTrackerNode);
+};

package/nodes/tractive-tracker.html

@@ -0,0 +1,80 @@
+<script type="text/javascript">
+    const TRACKER_OPS = [
+        'getTrackerLocation', 'getTrackerHardware', 'getTrackerHistory',
+        'liveOn', 'liveOff', 'LEDOn', 'LEDOff', 'buzzerOn', 'buzzerOff'
+    ];
+
+    RED.nodes.registerType('tractive-tracker', {
+        category: 'Tractive',
+        color: '#6dbfde',
+        defaults: {
+            name:      { value: '' },
+            config:    { value: '', type: 'tractive-config', required: true },
+            operation: { value: 'getTrackerHardware', required: true },
+            trackerID: { value: '', validate: function(v) {
+                const op = document.getElementById('node-input-operation');
+                if (op && TRACKER_OPS.includes(op.value)) return v && v.trim().length > 0;
+                return true;
+            }}
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: 'font-awesome/fa-paw',
+        label: function () {
+            return this.name || this.operation || 'tractive';
+        },
+        oneditprepare: function () {
+            function toggleTrackerID() {
+                const op = document.getElementById('node-input-operation').value;
+                const row = document.getElementById('row-trackerID');
+                row.style.display = TRACKER_OPS.includes(op) ? '' : 'none';
+            }
+            document.getElementById('node-input-operation').addEventListener('change', toggleTrackerID);
+            toggleTrackerID();
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="tractive-tracker">
+    <div class="form-row">
+        <label for="node-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-input-name" placeholder="Name">
+    </div>
+    <div class="form-row">
+        <label for="node-input-config"><i class="fa fa-user"></i> Account</label>
+        <input type="text" id="node-input-config">
+    </div>
+    <div class="form-row" id="row-trackerID">
+        <label for="node-input-trackerID"><i class="fa fa-map-marker"></i> Tracker ID</label>
+        <input type="text" id="node-input-trackerID" placeholder="Find in Tractive app → Settings → Device">
+    </div>
+    <div class="form-row">
+        <label for="node-input-operation"><i class="fa fa-cog"></i> Operation</label>
+        <select id="node-input-operation" style="width:70%">
+            <optgroup label="Tracker">
+                <option value="getTrackerHardware">Get hardware (battery, charging)</option>
+                <option value="getTrackerLocation">Get location</option>
+                <option value="getTrackerHistory">Get history</option>
+            </optgroup>
+            <optgroup label="Commands">
+                <option value="liveOn">Live tracking ON</option>
+                <option value="liveOff">Live tracking OFF</option>
+                <option value="LEDOn">LED ON</option>
+                <option value="LEDOff">LED OFF</option>
+                <option value="buzzerOn">Buzzer ON</option>
+                <option value="buzzerOff">Buzzer OFF</option>
+            </optgroup>
+            <optgroup label="Account">
+                <option value="getPets">Get pets</option>
+                <option value="getAllTrackers">Get all trackers</option>
+            </optgroup>
+        </select>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="tractive-tracker">
+    <p>Calls the Tractive API for a configured tracker.</p>
+    <p><b>Tracker ID:</b> find it in the Tractive app under Settings → Device → Device ID.
+    Can be overridden at runtime with <code>msg.trackerID</code>.</p>
+    <p>For <b>Get history</b>, set <code>msg.from</code> and <code>msg.to</code> (Unix timestamps in ms).</p>
+</script>

package/package.json

@@ -1,21 +1,41 @@
 {
   "name": "node-red-contrib-tractive",
-  "version": "0.1.0",
-  "description": "Node-RED palette for Tractive GPS tracker integration",
+  "version": "1.0.0",
+  "description": "Node-RED palette for the Tractive GPS tracker API — monitor battery, location, and control LED/buzzer.",
   "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "node --test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elarochejoubert/tractive.git"
+  },
   "keywords": [
     "node-red",
     "tractive",
     "GPS",
     "tracker",
-    "pet"
+    "pet",
+    "tracking"
   ],
   "node-red": {
-    "nodes": {}
+    "version": ">=3.0.0",
+    "nodes": {
+      "tractive-config": "nodes/tractive-config.cjs",
+      "tractive-tracker": "nodes/tractive-tracker.cjs"
+    }
+  },
+  "author": "Edouard Laroche-Joubert",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/elarochejoubert/tractive/issues"
+  },
+  "homepage": "https://github.com/elarochejoubert/tractive#readme",
+  "engines": {
+    "node": ">=18"
   },
-  "author": "Edouard",
-  "license": "MIT",
-  "dependencies": {
-    "tractive": "^1.2.1"
+  "devDependencies": {
+    "undici": "^7.0.0"
   }
 }

package/src/account.js

@@ -0,0 +1,60 @@
+/**
+ * Gets Tractive account information.
+ * @returns {Object} Object
+ */
+export async function getAccountInfo() {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/user/${accountDetails.uid}`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}
+
+/**
+ * Get all account subscriptions
+ * @returns {Array} Array
+ */
+export async function getAccountSubscriptions() {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/user/${accountDetails.uid}/subscriptions`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}
+
+/**
+ * Get a subscription
+ * @param {String} subscriptionID 
+ * @returns {Object} Object
+ */
+export async function getAccountSubscription(subscriptionID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/subscription/${subscriptionID}`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}
+
+/**
+ * Get a list of accounts you share trackers with
+ * @returns {Array} Array
+ */
+export async function getAccountShares() {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/user/${accountDetails.uid}/shares`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}

package/src/commands.js

@@ -0,0 +1,76 @@
+const RATE_LIMIT_CODE = 4006;
+const RATE_LIMIT_DELAY_MS = 2000;
+const MAX_RETRIES = 3;
+
+async function commandFetch(url, retries = MAX_RETRIES) {
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    if (data?.code === RATE_LIMIT_CODE && retries > 0) {
+        await new Promise(resolve => setTimeout(resolve, RATE_LIMIT_DELAY_MS));
+        return commandFetch(url, retries - 1);
+    }
+    return data;
+}
+
+/**
+ * Toggle live tracking mode on for a tracker.
+ * @param {String} trackerID
+ * @returns {Object} Object
+ */
+export async function liveOn(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    return commandFetch(`https://graph.tractive.com/4/tracker/${trackerID}/command/live_tracking/on`);
+}
+
+/**
+ * Toggle live tracking mode off for a tracker.
+ * @param {String} trackerID
+ * @returns {Object} Object
+ */
+export async function liveOff(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    return commandFetch(`https://graph.tractive.com/4/tracker/${trackerID}/command/live_tracking/off`);
+}
+
+/**
+ * Turn the trackers LED light on for the specified tracker.
+ * @param {String} trackerID
+ * @returns {Object} Object
+ */
+export async function LEDOn(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    return commandFetch(`https://graph.tractive.com/4/tracker/${trackerID}/command/led_control/on`);
+}
+
+/**
+ * Turn the trackers LED light off for the specified tracker.
+ * @param {String} trackerID
+ * @returns {Object} Object
+ */
+export async function LEDOff(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    return commandFetch(`https://graph.tractive.com/4/tracker/${trackerID}/command/led_control/off`);
+}
+
+/**
+ * Turn the trackers buzzer sound on for the specified tracker.
+ * @param {String} trackerID
+ * @returns {Object} Object
+ */
+export async function BuzzerOn(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    return commandFetch(`https://graph.tractive.com/4/tracker/${trackerID}/command/buzzer_control/on`);
+}
+
+/**
+ * Turn the trackers buzzer sound off for the specified tracker.
+ * @param {String} trackerID
+ * @returns {Object} Object
+ */
+export async function BuzzerOff(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    return commandFetch(`https://graph.tractive.com/4/tracker/${trackerID}/command/buzzer_control/off`);
+}

package/src/pet.js

@@ -0,0 +1,32 @@
+/**
+ * Get a pet and it's data, includes attached tracker, type of animal, and other pet details.
+ * @param {String} petID 
+ * @returns {Object} Object
+ */
+export async function getPet(petID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/trackable_object/${petID}`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const parsedData = await res.json();
+    parsedData.details.profile_picture_link = `https://graph.tractive.com/4/media/resource/${parsedData.details.profile_picture_id}.jpg`;
+    parsedData.details.cover_picture_link = `https://graph.tractive.com/4/media/resource/${parsedData.details.cover_picture_id}.jpg`;
+    return parsedData;
+}
+
+/**
+ * Get a list of all pets on the account
+ * @returns {Array} Array
+ */
+export async function getPets() {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/user/${accountDetails.uid}/trackable_objects`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}

package/src/tracker.js

@@ -0,0 +1,93 @@
+/**
+ * Get an array of all trackers on the account
+ * @returns {Array}
+ */
+export async function getAllTrackers() {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/user/${accountDetails.uid}/trackers`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const trackers = await res.json();
+    return trackers;
+}
+
+/**
+ * Get the specified tracker
+ * @param {String} trackerID 
+ * @returns {Object} Object
+ */
+export async function getTracker(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/tracker/${trackerID}`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const tracker = await res.json();
+    return tracker;
+}
+
+/**
+ * Get the history of locations for a specified tracker
+ * @param {String} trackerID 
+ * @param {Number} from 
+ * @param {Number} to 
+ * @returns {Array} Array
+ */
+export async function getTrackerHistory(trackerID, from, to) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    let calcFrom = typeof from == "object" ? (from.getTime() / 1000).toFixed(0) : from;
+    let calcTo = typeof to == "object"  ? (to.getTime() / 1000).toFixed(0) : to;
+    const url = `https://graph.tractive.com/4/tracker/${encodeURIComponent(trackerID)}/positions?time_from=${encodeURIComponent(calcFrom)}&time_to=${encodeURIComponent(calcTo)}&format=json_segments`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const parsedData = await res.json();
+    return parsedData[0];
+}
+
+/**
+ * Get the latest position report for the tracker.
+ * @param {String} trackerID 
+ * @returns {Object} Object
+ */
+export async function getTrackerLocation(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/device_pos_report/${trackerID}`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    const addressUrl = `https://graph.tractive.com/4/platform/geo/address/location?latitude=${encodeURIComponent(data.latlong[0])}&longitude=${encodeURIComponent(data.latlong[1])}`;
+    try {
+        const addressRes = await fetch(addressUrl, {
+            method: gloOpts.method,
+            headers: gloOpts.headers
+        });
+        const address = await addressRes.json();
+        data.address = address;
+    } catch (err) {
+        // ignore address fetch error
+    }
+    return data;
+}
+
+/**
+ * Get the latest hardware report for the tracker.
+ * @param {String} trackerID 
+ * @returns {Object} Object
+ */
+export async function getTrackerHardware(trackerID) {
+    if(!isAuthenticated()) return console.log('Not authenticated.');
+    const url = `https://graph.tractive.com/4/device_hw_report/${trackerID}`;
+    const res = await fetch(url, {
+        method: gloOpts.method,
+        headers: gloOpts.headers
+    });
+    const data = await res.json();
+    return data;
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 Edouard
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.