@skylord123/node-red-pebble-timeline 1.0.0

package/pebble-timeline-config.html

@@ -0,0 +1,63 @@
+<script type="text/javascript">
+    RED.nodes.registerType('pebble-timeline-config', {
+        category: 'config',
+        defaults: {
+            name: { value: "" },
+            apiUrl: { value: "https://timeline-api.rebble.io", required: true }
+        },
+        credentials: {
+            timelineToken: { type: "password" }
+        },
+        label: function() {
+            return this.name || "Pebble Timeline Config";
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="pebble-timeline-config">
+    <div class="form-row">
+        <label for="node-config-input-name"><i class="fa fa-tag"></i> Name</label>
+        <input type="text" id="node-config-input-name" placeholder="Name">
+        <div class="form-tips">Optional name to identify this configuration in the flow</div>
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-apiUrl"><i class="fa fa-globe"></i> API URL</label>
+        <input type="text" id="node-config-input-apiUrl" placeholder="https://timeline-api.rebble.io">
+        <div class="form-tips">The URL of the Pebble Timeline API. The default URL (https://timeline-api.rebble.io) is
+            provided by the Rebble service which maintains Pebble functionality after official support ended.
+        </div>
+    </div>
+    <div class="form-row">
+        <label for="node-config-input-timelineToken"><i class="fa fa-key"></i> Timeline Token</label>
+        <input type="password" id="node-config-input-timelineToken">
+        <div class="form-tips">Your timeline token for authentication with the API. This token is used to authenticate
+            your app with the Pebble Timeline service.
+        </div>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="pebble-timeline-config">
+    <p>Configuration for connecting to the Pebble Timeline API.</p>
+
+    <h3>Details</h3>
+    <dl class="message-properties">
+        <dt>Name <span class="property-type">string</span></dt>
+        <dd>Optional name for this configuration. Used to identify this configuration in your flows.</dd>
+
+        <dt>API URL <span class="property-type">string</span></dt>
+        <dd>The URL of the Pebble Timeline API. Defaults to https://timeline-api.rebble.io, which is the Rebble service
+            that maintains Pebble functionality.
+        </dd>
+
+        <dt>Timeline Token <span class="property-type">string</span></dt>
+        <dd>Your timeline token for authentication with the API. This is used to authenticate your app with the timeline
+            service. Each token has its own separate list of pins, and pins are automatically cleaned up after one month.
+        </dd>
+    </dl>
+
+    <h3>References</h3>
+    <ul>
+        <li><a href="https://developer.pebble.com/guides/pebble-timeline/">Pebble Timeline Developer Guide</a></li>
+        <li><a href="https://rebble.io">Rebble.io - The community maintaining Pebble services</a></li>
+    </ul>
+</script>

package/pebble-timeline-config.js

@@ -0,0 +1,13 @@
+module.exports = function(RED) {
+    function PebbleTimelineConfigNode(n) {
+        RED.nodes.createNode(this, n);
+        this.name = n.name;
+        this.apiUrl = n.apiUrl;
+    }
+    
+    RED.nodes.registerType("pebble-timeline-config", PebbleTimelineConfigNode, {
+        credentials: {
+            timelineToken: { type: "password" }
+        }
+    });
+};

package/pebble-timeline-delete.html

@@ -0,0 +1,122 @@
+<script type="text/javascript">
+    RED.nodes.registerType('pebble-timeline-delete', {
+        category: 'Pebble',
+        color: '#1da1f2',
+        defaults: {
+            name: {value: ""},
+            config: {type: "pebble-timeline-config", required: true},
+
+            // Server override options
+            apiUrl: {value: "null"},
+            apiUrlType: {value: "jsonata"},
+
+            token: {value: "null"},
+            tokenType: {value: "jsonata"},
+
+            // Pin ID property
+            pinId: {value: "payload.id"},
+            pinIdType: {value: "msg"}
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "font-awesome/fa-trash-o",
+        label: function () {
+            return this.name || "Delete Timeline Pin";
+        },
+        oneditprepare: function () {
+            // Setup TypedInput for server override options
+            $("#node-input-apiUrl").typedInput({
+                types: ["msg", "flow", "global", "str", "jsonata"],
+                typeField: "#node-input-apiUrlType"
+            });
+
+            $("#node-input-token").typedInput({
+                types: ["msg", "flow", "global", "str", "jsonata"],
+                typeField: "#node-input-tokenType"
+            });
+
+            // Setup TypedInput for pinId
+            $("#node-input-pinId").typedInput({
+                types: ["msg", "flow", "global", "str", "jsonata"],
+                typeField: "#node-input-pinIdType"
+            });
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="pebble-timeline-delete">
+    <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-cog"></i> Config</label>
+        <input type="text" id="node-input-config">
+    </div>
+
+    <div class="form-section">
+        <div class="form-section-title">Server Overrides (Optional)</div>
+
+        <div class="form-row">
+            <label for="node-input-apiUrl"><i class="fa fa-globe"></i> API URL</label>
+            <input type="text" id="node-input-apiUrl" style="width: 70%">
+            <input type="hidden" id="node-input-apiUrlType">
+            <div class="form-tips">Override the API URL configured in the config node. Defaults to
+                https://timeline-api.rebble.io
+            </div>
+        </div>
+
+        <div class="form-row">
+            <label for="node-input-token"><i class="fa fa-key"></i> Token</label>
+            <input type="text" id="node-input-token" style="width: 70%">
+            <input type="hidden" id="node-input-tokenType">
+            <div class="form-tips">Override the timeline token configured in the config node</div>
+        </div>
+    </div>
+
+    <div class="form-row">
+        <label for="node-input-pinId"><i class="fa fa-id-card"></i> Pin ID</label>
+        <input type="text" id="node-input-pinId" style="width: 70%">
+        <input type="hidden" id="node-input-pinIdType">
+        <div class="form-tips">The ID of the pin to delete from the timeline. This must match exactly the ID that was
+            used when the pin was created.
+        </div>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="pebble-timeline-delete">
+    <p>Deletes a pin from the Pebble Timeline.</p>
+
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt>payload.id <span class="property-type">string</span></dt>
+        <dd>The ID of the pin to delete. This can be overridden by the node's configuration.</dd>
+        <dt>payload <span class="property-type">string</span></dt>
+        <dd>If payload is a string, it will be treated as the pin ID.</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">object</span></dt>
+        <dd>The result of the API call, including success status and any error information.</dd>
+        <dt>payload.success <span class="property-type">boolean</span></dt>
+        <dd>Whether the delete operation was successful.</dd>
+        <dt>payload.pinId <span class="property-type">string</span></dt>
+        <dd>The ID of the pin that was deleted or attempted to be deleted.</dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>This node deletes a pin from the Pebble Timeline. You need to provide the ID of the pin to delete.</p>
+    <p>You can configure the pin ID directly in the node or provide it in the input message. If both are provided, the
+        node's configuration takes precedence.</p>
+    <p>The pin will be deleted from both the Pebble Timeline service and the local storage for the current timeline token.</p>
+    <p>When deleting pins, the system also automatically cleans up any pins older than one month from all tokens to prevent the storage file from growing too large.</p>
+    <p>Note that once a pin ID has been deleted, it cannot be reused for future pins.</p>
+
+    <h3>References</h3>
+    <ul>
+        <li><a href="https://developer.pebble.com/guides/pebble-timeline/pin-structure/">Pebble Timeline Pin
+            Structure</a></li>
+    </ul>
+</script>

package/pebble-timeline-delete.js

@@ -0,0 +1,190 @@
+const axios = require('axios');
+const fs = require('fs-extra');
+const path = require('path');
+
+module.exports = function(RED) {
+    function PebbleTimelineDeleteNode(config) {
+        RED.nodes.createNode(this, config);
+        const node = this;
+
+        // Get the config node
+        const configNode = RED.nodes.getNode(config.config);
+        if (!configNode) {
+            node.error("No Pebble Timeline configuration found");
+            return;
+        }
+
+        // Make sure storage directory exists
+        const storageDir = path.join(RED.settings.userDir, 'pebble-timeline');
+        fs.ensureDirSync(storageDir);
+        const pinsFile = path.join(storageDir, 'timeline-pins.json');
+
+        // Load existing pins (organized by token)
+        let pinsData = {};
+        try {
+            if (fs.existsSync(pinsFile)) {
+                pinsData = JSON.parse(fs.readFileSync(pinsFile, 'utf8'));
+            }
+        } catch (error) {
+            node.warn(`Error loading pins file: ${error.message}`);
+        }
+
+        node.on('input', function(msg, send, done) {
+            // Backwards compatibility with Node-RED 0.x
+            send = send || function() { node.send.apply(node, arguments) };
+
+            // Get the pin ID to delete
+            let pinId;
+            // Process parameters in sequence
+            Promise.all([
+                new Promise(resolve => {
+                    RED.util.evaluateNodeProperty(config.pinId, config.pinIdType, node, msg, (err, result) => {
+                        if (err) {
+                            node.error(`Error evaluating pin ID: ${err.message}`, msg);
+                            if (done) done(err);
+                            return;
+                        }
+
+                        pinId = result;
+
+                        if (!pinId) {
+                            node.error("Pin ID is required", msg);
+                            if (done) done("Pin ID is required");
+                            return;
+                        }
+                        resolve();
+                    });
+                }),
+
+                // Check for server override options
+                new Promise(resolve => {
+                    if (config.apiUrl) {
+                        RED.util.evaluateNodeProperty(config.apiUrl, config.apiUrlType, node, msg, (err, result) => {
+                            if (!err && result) {
+                                node.apiUrlOverride = result;
+                            }
+                            resolve();
+                        });
+                    } else {
+                        resolve();
+                    }
+                }),
+
+                new Promise(resolve => {
+                    if (config.token) {
+                        RED.util.evaluateNodeProperty(config.token, config.tokenType, node, msg, (err, result) => {
+                            if (!err && result) {
+                                node.tokenOverride = result;
+                            }
+                            resolve();
+                        });
+                    } else {
+                        resolve();
+                    }
+                })
+            ]).then(() => {
+                // Use overrides if provided, otherwise use config node values
+                const apiUrl = `${node.apiUrlOverride || configNode.apiUrl}/v1/user/pins/${pinId}`;
+                const timelineToken = node.tokenOverride || configNode.credentials.timelineToken;
+
+                if (!timelineToken) {
+                    node.error("Timeline token is required", msg);
+                    if (done) done("Timeline token is required");
+                    return;
+                }
+
+                axios.delete(apiUrl, {
+                    headers: {
+                        'X-User-Token': timelineToken
+                    }
+                })
+                .then(response => {
+                    node.status({fill: "green", shape: "dot", text: "Pin deleted"});
+
+                    // Remove the pin from our local storage
+                    removePin(pinId);
+
+                    // Prepare the output message
+                    msg.payload = {
+                        success: true,
+                        pinId: pinId,
+                        response: response.data
+                    };
+
+                    send(msg);
+                    if (done) done();
+                })
+                .catch(error => {
+                    node.status({fill: "red", shape: "dot", text: "Error: " + (error.response ? error.response.status : error.message)});
+
+                    msg.payload = {
+                        success: false,
+                        pinId: pinId,
+                        error: error.message,
+                        response: error.response ? error.response.data : null
+                    };
+
+                    send(msg);
+                    if (done) done(error);
+                });
+            }).catch(err => {
+                if (done) done(err);
+            });
+        });
+
+        // Helper to remove a pin from local storage
+        function removePin(pinId) {
+            const timelineToken = node.tokenOverride || configNode.credentials.timelineToken;
+
+            // Check if this token has any pins
+            if (!pinsData[timelineToken]) {
+                return; // No pins for this token
+            }
+
+            // Remove the pin with the specified ID from this token's pins
+            const initialCount = pinsData[timelineToken].length;
+            pinsData[timelineToken] = pinsData[timelineToken].filter(p => p.id !== pinId);
+
+            // Clean up old pins (older than 1 month) from all tokens
+            cleanupOldPins();
+
+            // Only write if we actually removed something
+            if (pinsData[timelineToken].length !== initialCount) {
+                try {
+                    fs.writeFileSync(pinsFile, JSON.stringify(pinsData, null, 2));
+                } catch (error) {
+                    node.warn(`Error saving pins to file: ${error.message}`);
+                }
+            }
+        }
+
+        // Helper to clean up pins older than 1 month
+        function cleanupOldPins() {
+            const oneMonthAgo = new Date();
+            oneMonthAgo.setMonth(oneMonthAgo.getMonth() - 1);
+
+            // Iterate through all tokens
+            Object.keys(pinsData).forEach(token => {
+                // Filter out pins older than 1 month
+                const initialCount = pinsData[token].length;
+                pinsData[token] = pinsData[token].filter(pin => {
+                    const storedDate = new Date(pin._stored);
+                    return storedDate >= oneMonthAgo;
+                });
+
+                // Log if pins were removed
+                if (pinsData[token].length < initialCount) {
+                    node.debug(`Removed ${initialCount - pinsData[token].length} old pins for token ${token.substring(0, 8)}...`);
+                }
+            });
+        }
+
+        node.on('close', function() {
+            // Clean up any resources
+        });
+    }
+
+    RED.nodes.registerType("pebble-timeline-delete", PebbleTimelineDeleteNode, {
+        credentials: {}
+    });
+};

package/pebble-timeline-list.html

@@ -0,0 +1,151 @@
+<script type="text/javascript">
+    RED.nodes.registerType('pebble-timeline-list', {
+        category: 'Pebble',
+        color: '#1da1f2',
+        defaults: {
+            name: {value: ""},
+            config: {type: "pebble-timeline-config", required: true},
+
+            // Server override options
+            apiUrl: {value: "null"},
+            apiUrlType: {value: "jsonata"},
+
+            token: {value: "null"},
+            tokenType: {value: "jsonata"},
+
+            // Filter properties
+            startTime: {value: "payload.startTime"},
+            startTimeType: {value: "msg"},
+
+            endTime: {value: "payload.endTime"},
+            endTimeType: {value: "msg"}
+        },
+        inputs: 1,
+        outputs: 1,
+        icon: "font-awesome/fa-list",
+        label: function () {
+            return this.name || "List Timeline Pins";
+        },
+        oneditprepare: function () {
+            // Setup TypedInput for server override options
+            $("#node-input-apiUrl").typedInput({
+                types: ["msg", "flow", "global", "str", "jsonata"],
+                typeField: "#node-input-apiUrlType"
+            });
+
+            $("#node-input-token").typedInput({
+                types: ["msg", "flow", "global", "str", "jsonata"],
+                typeField: "#node-input-tokenType"
+            });
+
+            // Setup TypedInput for filter fields
+            $("#node-input-startTime").typedInput({
+                types: ["msg", "flow", "global", "str", "date", "jsonata"],
+                typeField: "#node-input-startTimeType"
+            });
+
+            $("#node-input-endTime").typedInput({
+                types: ["msg", "flow", "global", "str", "date", "jsonata"],
+                typeField: "#node-input-endTimeType"
+            });
+        }
+    });
+</script>
+
+<script type="text/html" data-template-name="pebble-timeline-list">
+    <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-cog"></i> Config</label>
+        <input type="text" id="node-input-config">
+    </div>
+
+    <div class="form-section">
+        <div class="form-section-title">Server Overrides (Optional)</div>
+
+        <div class="form-row">
+            <label for="node-input-apiUrl"><i class="fa fa-globe"></i> API URL</label>
+            <input type="text" id="node-input-apiUrl" style="width: 70%">
+            <input type="hidden" id="node-input-apiUrlType">
+            <div class="form-tips">Override the API URL configured in the config node. Defaults to
+                https://timeline-api.rebble.io
+            </div>
+        </div>
+
+        <div class="form-row">
+            <label for="node-input-token"><i class="fa fa-key"></i> Token</label>
+            <input type="text" id="node-input-token" style="width: 70%">
+            <input type="hidden" id="node-input-tokenType">
+            <div class="form-tips">Override the timeline token configured in the config node</div>
+        </div>
+    </div>
+
+    <div class="form-section">
+        <div class="form-section-title">Filter Options</div>
+
+        <div class="form-row">
+            <label for="node-input-startTime"><i class="fa fa-calendar"></i> Start Time</label>
+            <input type="text" id="node-input-startTime" style="width: 70%">
+            <input type="hidden" id="node-input-startTimeType">
+            <div class="form-tips">Filter pins with a time greater than or equal to this value. Use ISO date-time format
+                (e.g., 2023-01-01T00:00:00Z).
+            </div>
+        </div>
+
+        <div class="form-row">
+            <label for="node-input-endTime"><i class="fa fa-calendar"></i> End Time</label>
+            <input type="text" id="node-input-endTime" style="width: 70%">
+            <input type="hidden" id="node-input-endTimeType">
+            <div class="form-tips">Filter pins with a time less than or equal to this value. Use ISO date-time format
+                (e.g., 2023-01-31T23:59:59Z).
+            </div>
+        </div>
+    </div>
+</script>
+
+<script type="text/html" data-help-name="pebble-timeline-list">
+    <p>Lists pins that have been added to the Pebble Timeline.</p>
+
+    <h3>Inputs</h3>
+    <dl class="message-properties">
+        <dt class="optional">payload <span class="property-type">object</span></dt>
+        <dd>Optional filter criteria for the pins.</dd>
+        <dt class="optional">payload.startTime <span class="property-type">string | date</span></dt>
+        <dd>Filter pins with a time greater than or equal to this value. Use ISO date-time format.</dd>
+        <dt class="optional">payload.endTime <span class="property-type">string | date</span></dt>
+        <dd>Filter pins with a time less than or equal to this value. Use ISO date-time format.</dd>
+    </dl>
+
+    <h3>Outputs</h3>
+    <dl class="message-properties">
+        <dt>payload <span class="property-type">array</span></dt>
+        <dd>An array of pins that match the filter criteria.</dd>
+        <dt>count <span class="property-type">number</span></dt>
+        <dd>The number of pins that match the filter criteria.</dd>
+    </dl>
+
+    <h3>Details</h3>
+    <p>This node lists pins that have been successfully added to the Pebble Timeline. The pins are stored locally in the
+        Node-RED installation directory, organized by timeline token.</p>
+    <p>Only pins associated with the current timeline token will be listed. Each token maintains its own separate list of pins.</p>
+    <p>You can filter the pins by start and end times. The times should be in ISO date-time format (e.g.,
+        2023-01-01T12:00:00Z).</p>
+    <p>By default, if no filters are specified, all pins for the current token will be returned.</p>
+    <p>Pins older than one month are automatically cleaned up when listing pins to prevent the storage file from growing too large.</p>
+
+    <h4>Example Use Cases</h4>
+    <ul>
+        <li>List all upcoming events for the day</li>
+        <li>Filter pins for a specific date range for reporting</li>
+        <li>Show pins for a specific event type based on time criteria</li>
+    </ul>
+
+    <h3>References</h3>
+    <ul>
+        <li><a href="https://developer.pebble.com/guides/pebble-timeline/pin-structure/">Pebble Timeline Pin
+            Structure</a></li>
+    </ul>
+</script>