@eribbey/homebridge-ntfy 1.1.0

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/NOTICE

@@ -0,0 +1,16 @@
+@eribbey/homebridge-ntfy
+Copyright 2026 Evan Ribbey
+
+This product includes software originally developed as "homebridge-ntfy"
+by Emil Löfblom (https://github.com/emilof/homebridge-ntfy), licensed under
+the Apache License, Version 2.0.
+
+This is a maintained fork of that project. Changes made in this fork include:
+
+  - Support for publishing to a custom (self-hosted or SaaS) ntfy server
+    instead of only the official https://ntfy.sh server.
+  - Authentication support via access token or username/password.
+  - More detailed logging of failed publish requests.
+
+The original work remains available under the Apache License, Version 2.0,
+a copy of which is included in the LICENSE file.

package/README.md

@@ -0,0 +1,213 @@
+# Homebridge Ntfy
+
+[![npm](https://img.shields.io/npm/v/@eribbey/homebridge-ntfy/latest?label=latest)](https://www.npmjs.com/package/@eribbey/homebridge-ntfy)
+[![npm](https://img.shields.io/npm/dt/@eribbey/homebridge-ntfy)](https://www.npmjs.com/package/@eribbey/homebridge-ntfy)
+
+> Maintained fork of [emilof/homebridge-ntfy](https://github.com/emilof/homebridge-ntfy), published as
+> [`@eribbey/homebridge-ntfy`](https://www.npmjs.com/package/@eribbey/homebridge-ntfy). Adds support for custom
+> (self-hosted or SaaS) ntfy servers and authentication. The upstream project is no longer actively maintained.
+
+This plugin allows you to send notifications through ntfy (https://ntfy.sh) directly from HomeKit. It works by creating a momentary switch, that when turned on, sends a message via ntfy. Once the message has been sent, the switch automatically returns to its off state.
+
+Messages are sent through the official ntfy.sh server by default, but you can point the plugin at your own self-hosted or SaaS ntfy server instead. See [Custom server](#custom-server).
+
+This is especially useful if you want to send a notification to your device when a particular event occurs. Simply create a HomeKit automation that is triggered by the desired event or condition, and set the action to turn on the switch.
+
+## Prerequisites
+
+- Homebridge installed
+- The ntfy app installed on your device
+- Optional: a self-hosted or SaaS ntfy server, if you'd rather not use the official ntfy.sh server
+
+## Installation
+
+### Option 1: Homebridge UI
+
+Go to the 'Plugins' page, search for `@eribbey/homebridge-ntfy`, and click 'Install'.
+
+### Option 2: Manually
+
+Run the following command to install the plugin globally:
+
+    $ sudo npm install @eribbey/homebridge-ntfy -g
+
+### Migrating from `homebridge-ntfy`
+
+This fork uses the same platform identifier (`NtfyPlatform`) as upstream, so your existing
+`platforms` config block works unchanged. To switch over:
+
+1. Uninstall `homebridge-ntfy`.
+2. Install `@eribbey/homebridge-ntfy`.
+3. Restart Homebridge.
+
+Because Homebridge caches accessories per plugin, the switches are re-created under the new
+plugin. They keep the same names, but any HomeKit automations referencing them may need to be
+re-pointed at the new accessories.
+
+## Configuration
+
+### Option 1: Homebridge UI
+
+The easiest way to configure the plugin is to use the config UI in Homebridge. It will be displayed automatically after you've installed the plugin. If not, it can be found under the 'More Menu' `⋮` for the 'Homebridge Ntfy' plugin.
+
+### Option 2: Manually
+
+An alternative is to edit the Homebridge JSON config file manually by adding the following config to the `platforms` array:
+
+```json
+{
+  "platform": "NtfyPlatform",
+  "messages": [
+    {
+      "name": "Send warning message",
+      "topic": "my-private-topic-9yfxy",
+      "message": "Warning message text"
+    }
+  ]
+}
+```
+
+## Config Properties
+
+| Property              | Type      | Required | Description                                                               |
+| --------------------- | --------- | -------- | ------------------------------------------------------------------------- |
+| `platform`            | `string`  | Yes      | Platform identifier. **Do not change this line**                          |
+| `serverUrl`           | `string`  | No       | Base URL of the ntfy server to publish to. A base path is supported for servers behind a reverse proxy, e.g. `https://home.example.com/ntfy`. Default: **https://ntfy.sh**. |
+| `authType`            | `string`  | No       | Authentication method to use when publishing: `none`, `token` or `basic`. Default: **none**. [[More info](https://docs.ntfy.sh/publish/#authentication)] |
+| `accessToken`         | `string`  | Yes/No   | Required if `authType` is set to `token`. [[More info](https://docs.ntfy.sh/config/#access-tokens)] |
+| `username`            | `string`  | Yes/No   | Required if `authType` is set to `basic`.                                 |
+| `password`            | `string`  | Yes/No   | Required if `authType` is set to `basic`.                                 |
+| `messages`            | `array`   | Yes      | List of messages/switch accessories to setup in HomeKit.                  |
+| └ `name`         | `string`  | Yes      | Name of the switch shown in the Home app.                                 |
+| └ `useJson`      | `boolean` | No       | Set to `true` to use ntfy JSON format. See parameter `json`. Default: **false**. |
+| └ `topic`        | `string`  | Yes/No   | Required if `useJson` is set to `false`.                                  |
+| └ `title`        | `string`  | No       | Title of the notification sent to the device.                             |
+| └ `message`      | `string`  | No       | Message text of the notification sent to the device.                      |
+| └ `priority`     | `string`  | No       | Priority of the message. Default: **default**. [[More info](https://docs.ntfy.sh/publish/#message-priority)] |
+| └ `tags`         | `string`  | No       | Tag message with emoji or text tag. A comma-separated list of tag names. [[More info](https://docs.ntfy.sh/emojis)] |
+| └ `json`         | `string`  | Yes/No   | Required if `useJson` is set to `true`. For advanced users ONLY. The value must be a valid JSON string (escaped) and adhere to ntfy's JSON message format. [[More info](https://docs.ntfy.sh/subscribe/api/#json-message-format)] |
+| └ `cooldownTime` | `number`  | No       | Minimum time before this message can be sent again. Default: no cooldown. |
+
+### Example config
+
+In the example below, two switch accessories have been configured. The first one has high priority and the second one has a emoji (tag) and cooldown set.
+
+```json
+{
+  "platform": "NtfyPlatform",
+  "messages": [
+    {
+      "name": "Send warning message",
+      "topic": "my-private-topic-9yfxy",
+      "title": "Warning title",
+      "message": "High priority warning message",
+      "priority": "high"
+    },
+    {
+      "name": "Send alert message",
+      "topic": "my-private-topic-9yfxy",
+      "title": "Alert title",
+      "message": "Alert with emoji that can be triggered once every 10 seconds at most",
+      "tags": "warning",
+      "cooldownTime": 10000
+    }
+  ]
+}
+```
+
+## Custom server
+
+By default the plugin publishes to the official server at `https://ntfy.sh`. Set `serverUrl` to use your own self-hosted or SaaS server instead. The URL is the base address of the server, not a topic URL — the topic from each message is appended automatically.
+
+```json
+{
+  "platform": "NtfyPlatform",
+  "serverUrl": "https://ntfy.home.example.com",
+  "messages": [
+    {
+      "name": "Send warning message",
+      "topic": "home-alerts",
+      "message": "Warning message text"
+    }
+  ]
+}
+```
+
+If no protocol is given, `https` is assumed. A base path is kept, so a server behind a reverse proxy such as `https://home.example.com/ntfy` works too. If the URL can't be parsed, the plugin logs an error and falls back to `https://ntfy.sh`.
+
+### Authentication
+
+Self-hosted servers usually have access control enabled, and the official server needs authentication for protected topics. Set `authType` to `token` or `basic` and supply the matching credentials. ([Read more](https://docs.ntfy.sh/publish/#authentication))
+
+Using an access token:
+
+```json
+{
+  "platform": "NtfyPlatform",
+  "serverUrl": "https://ntfy.home.example.com",
+  "authType": "token",
+  "accessToken": "tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2",
+  "messages": [
+    {
+      "name": "Send warning message",
+      "topic": "home-alerts",
+      "message": "Warning message text"
+    }
+  ]
+}
+```
+
+Using a username and password:
+
+```json
+{
+  "platform": "NtfyPlatform",
+  "serverUrl": "https://ntfy.home.example.com",
+  "authType": "basic",
+  "username": "homebridge",
+  "password": "your-password",
+  "messages": [
+    {
+      "name": "Send warning message",
+      "topic": "home-alerts",
+      "message": "Warning message text"
+    }
+  ]
+}
+```
+
+Credentials are sent as an `Authorization` header on every request, so use `https` for any server reachable outside your local network. If the credentials are incomplete, the plugin logs an error and sends requests unauthenticated. When the server rejects the credentials, the resulting `401`/`403` is reported in the Homebridge log.
+
+Authentication applies to JSON format messages as well.
+
+## JSON message config
+
+When 'Use JSON format' is enabled, you have the ability to set a custom config (JSON) for your messages. Using this format will unlock more advanced features that cannot be configured using the standard Homebridge plugin config UI. The value must be a valid JSON string and adhere to ntfy's JSON message format. ([Read more](https://docs.ntfy.sh/subscribe/api/#json-message-format)). 
+
+Note: Use the plugin config UI when setting the JSON message config. If you're editing the Homebridge config, the JSON message config (stored in `json`) must be escaped first.
+
+### Example JSON message config
+
+In the example below, a message has been configured to have two action buttons. Pressing the first one opens a webpage, and pressing the second one calls a server endpoint with a pre-configured payload.
+
+```json
+{
+  "topic": "my-private-topic-9yfxy",
+  "title": "Adjust A/C",
+  "message": "You left the house. Turn down the A/C?",
+  "actions": [
+    {
+      "action": "view",
+      "label": "Open portal",
+      "url": "https://home.nest.com/",
+      "clear": true
+    },
+    {
+      "action": "http",
+      "label": "Turn down",
+      "url": "https://api.nest.com/",
+      "body": "{\"temperature\": 65}"
+    }
+  ]
+}
+```

package/config.schema.json

@@ -0,0 +1,219 @@
+{
+  "pluginAlias": "NtfyPlatform",
+  "pluginType": "platform",
+  "singular": true,
+  "schema": {
+    "type": "object",
+    "properties": {
+      "name": {
+        "title": "Name",
+        "type": "string",
+        "default": "Homebridge Ntfy"
+      },
+      "serverUrl": {
+        "title": "Server URL",
+        "description": "Base URL of the ntfy server to publish to. Leave empty to use the official server at https://ntfy.sh. A base path is supported for servers behind a reverse proxy, e.g. https://home.example.com/ntfy.",
+        "placeholder": "https://ntfy.sh",
+        "type": "string"
+      },
+      "authType": {
+        "title": "Authentication",
+        "description": "How to authenticate when publishing. Self-hosted servers usually require this, and the official server needs it for protected topics. [<a href=\"https://docs.ntfy.sh/publish/#authentication\" target=\"_blank\">More info</a>]",
+        "type": "string",
+        "default": "none",
+        "oneOf": [
+          {
+            "title": "None",
+            "const": "none"
+          },
+          {
+            "title": "Access token",
+            "const": "token"
+          },
+          {
+            "title": "Username and password",
+            "const": "basic"
+          }
+        ]
+      },
+      "accessToken": {
+        "title": "Access token <strong><font color=\"red\" class=\"text-danger\">*</font></strong>",
+        "description": "Access token used to publish to the server. [<a href=\"https://docs.ntfy.sh/config/#access-tokens\" target=\"_blank\">More info</a>]",
+        "placeholder": "tk_AgQdq7mVBoFD37zQVN29RhuMzNIz2",
+        "type": "string",
+        "x-schema-form": {
+          "type": "password"
+        },
+        "condition": {
+          "functionBody": "return model.authType === 'token';"
+        }
+      },
+      "username": {
+        "title": "Username <strong><font color=\"red\" class=\"text-danger\">*</font></strong>",
+        "description": "Username of an account allowed to publish to the topic.",
+        "type": "string",
+        "condition": {
+          "functionBody": "return model.authType === 'basic';"
+        }
+      },
+      "password": {
+        "title": "Password <strong><font color=\"red\" class=\"text-danger\">*</font></strong>",
+        "description": "Password for the account above.",
+        "type": "string",
+        "x-schema-form": {
+          "type": "password"
+        },
+        "condition": {
+          "functionBody": "return model.authType === 'basic';"
+        }
+      },
+      "messages": {
+        "type": "array",
+        "items": {
+          "type": "object",
+          "properties": {
+            "name": {
+              "title": "Name",
+              "description": "Name of the switch shown in the Home app.",
+              "type": "string"
+            },
+            "useJson": {
+              "title": "Use JSON format",
+              "description": "For advanced users ONLY! Using JSON will give you more options and the ability to utilize more features in ntfy.",
+              "type": "boolean",
+              "default": false
+            },
+            "topic": {
+              "title": "Topic <strong><font color=\"red\" class=\"text-danger\">*</font></strong>",
+              "description": "Topic to publish message to. <strong>Important:</strong> Topics are public on ntfy's server and can be read by anyone, so pick a name that is hard for others to guess.",
+              "placeholder": "my-topic-2fd8cffa",
+              "type": "string",
+              "condition": {
+								"functionBody": "return !model.messages[arrayIndices].useJson;"
+							}
+            },
+            "title": {
+              "title": "Title",
+              "description": "Title of the message.",
+              "type": "string",
+              "condition": {
+								"functionBody": "return !model.messages[arrayIndices].useJson;"
+							}
+            },
+            "message": {
+              "title": "Message",
+              "description": "The message text.",
+              "type": "string",
+              "condition": {
+								"functionBody": "return !model.messages[arrayIndices].useJson;"
+							}
+            },
+            "priority": {
+              "title": "Priority",
+              "description": "Priority of the message. [<a href=\"https://docs.ntfy.sh/publish/#message-priority\" target=\"_blank\">More info</a>]",
+              "type": "string",
+              "oneOf": [
+                {
+                  "title": "Max",
+                  "const": "max"
+                },
+                {
+                  "title": "High",
+                  "const": "high"
+                },
+                {
+                  "title": "Default",
+                  "const": "default"
+                },
+                {
+                  "title": "Low",
+                  "const": "low"
+                },
+                {
+                  "title": "Min",
+                  "const": "min"
+                }              
+              ],
+              "condition": {
+								"functionBody": "return !model.messages[arrayIndices].useJson;"
+							}
+            },
+            "tags": {
+              "title": "Tags",
+              "description": "Tag message with emoji or text tag. A comma separated list of tag names. [<a href=\"https://docs.ntfy.sh/emojis\" target=\"_blank\">More info</a>]",
+              "type": "string",
+              "condition": {
+								"functionBody": "return !model.messages[arrayIndices].useJson;"
+							}
+            },
+            "json": {
+              "title": "JSON message config <strong><font color=\"red\" class=\"text-danger\">*</font></strong>",
+              "description": "Input must be a valid JSON string and adhere to ntfy's JSON message format. [<a href=\"https://docs.ntfy.sh/subscribe/api/#json-message-format\" target=\"_blank\">More info</a>]",
+              "type": "string",
+              "condition": {
+								"functionBody": "return model.messages[arrayIndices].useJson;"
+							}
+            },
+            "cooldownTime": {
+              "title": "Cooldown time (millis)",
+              "description": "Minimum time before this message can be sent again. Default: off",
+              "type": "integer"
+            }
+          },
+          "required": ["name"],
+          "if": {
+            "properties": {
+              "useJson": { "const": true }
+            }
+          },
+          "then": {
+            "required": ["json"]
+          },
+          "else": {
+            "required": ["topic"]
+          }
+        }
+      }
+    },
+    "required": ["name"]
+  },
+  "layout": [
+    {
+      "type": "fieldset",
+      "title": "Server",
+      "expandable": true,
+      "expanded": true,
+      "items": [
+        "serverUrl",
+        "authType",
+        "accessToken",
+        "username",
+        "password"
+      ]
+    },
+    {
+      "type": "array",
+      "title": "Messages",
+      "key": "messages",
+      "items": [
+        {
+          "type": "section",
+          "items": [
+            "messages[].name",
+            "messages[].useJson",
+            "messages[].topic",
+            "messages[].title",
+            "messages[].message",
+            "messages[].priority",
+            "messages[].tags",
+            {
+              "key": "messages[].json",
+              "type": "textarea"
+            },
+            "messages[].cooldownTime"
+          ]
+        }
+      ]
+    }
+  ]
+}

package/dist/const.d.ts

@@ -0,0 +1,3 @@
+export declare const PLATFORM_NAME = "NtfyPlatform";
+export declare const PLUGIN_NAME = "@eribbey/homebridge-ntfy";
+export declare const DEFAULT_SERVER_URL = "https://ntfy.sh";

package/dist/const.js

@@ -0,0 +1,4 @@
+export const PLATFORM_NAME = 'NtfyPlatform';
+export const PLUGIN_NAME = '@eribbey/homebridge-ntfy';
+export const DEFAULT_SERVER_URL = 'https://ntfy.sh';
+//# sourceMappingURL=const.js.map

package/dist/const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"const.js","sourceRoot":"","sources":["../src/const.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,cAAc,CAAC;AAE5C,MAAM,CAAC,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAEtD,MAAM,CAAC,MAAM,kBAAkB,GAAG,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import type { API } from 'homebridge';
+declare const _default: (api: API) => void;
+export default _default;

package/dist/index.js

@@ -0,0 +1,6 @@
+import { NtfyPlatform } from './platform.js';
+import { PLATFORM_NAME } from './const.js';
+export default (api) => {
+    api.registerPlatform(PLATFORM_NAME, NtfyPlatform);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAe,CAAC,GAAQ,EAAE,EAAE;IAC1B,GAAG,CAAC,gBAAgB,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC,CAAC"}

package/dist/ntfy-client.d.ts

@@ -0,0 +1,22 @@
+import type { Logging } from 'homebridge';
+import type { NtfyAuth } from './types.js';
+export interface MessageRequest {
+    topic: string;
+    message?: string;
+    title?: string;
+    tags?: string;
+    priority?: number;
+}
+export declare class NtfyClient {
+    private readonly log;
+    private readonly serverAddress;
+    private readonly authHeader?;
+    constructor(log: Logging, serverAddress: string, auth?: NtfyAuth);
+    sendMessage(request: MessageRequest | string): Promise<void>;
+    private sendMessageRequest;
+    private sendMessageJson;
+    private baseHeaders;
+    private buildAuthHeader;
+    private logRequestError;
+    private isMessageRequest;
+}

package/dist/ntfy-client.js

@@ -0,0 +1,85 @@
+import axios from 'axios';
+export class NtfyClient {
+    log;
+    serverAddress;
+    authHeader;
+    constructor(log, serverAddress, auth) {
+        this.log = log;
+        this.serverAddress = serverAddress;
+        this.authHeader = this.buildAuthHeader(auth);
+    }
+    async sendMessage(request) {
+        if (this.isMessageRequest(request)) {
+            return this.sendMessageRequest(request);
+        }
+        else if (typeof request === 'string') {
+            return this.sendMessageJson(request);
+        }
+        else {
+            this.log.error('Unknown request type:', request);
+        }
+    }
+    async sendMessageRequest(request) {
+        this.log.debug('Sending ntfy request:', request);
+        const url = `${this.serverAddress}/${request.topic}`;
+        const body = request.message;
+        const headers = this.baseHeaders();
+        if (request.title) {
+            headers.Title = request.title;
+        }
+        if (request.priority) {
+            headers.Priority = request.priority.toString();
+        }
+        if (request.tags) {
+            headers.Tags = request.tags;
+        }
+        await axios.post(url, body, { headers })
+            .then(response => {
+            this.log.debug('Success! Result:', response.data);
+        })
+            .catch(error => {
+            this.logRequestError(error);
+        });
+    }
+    async sendMessageJson(json) {
+        this.log.debug('Sending ntfy JSON request:', JSON.parse(json));
+        await axios.post(this.serverAddress, json, { headers: this.baseHeaders() })
+            .then(response => {
+            this.log.debug('Success! Result:', response.data);
+        })
+            .catch(error => {
+            this.logRequestError(error);
+        });
+    }
+    baseHeaders() {
+        return this.authHeader ? { Authorization: this.authHeader } : {};
+    }
+    buildAuthHeader(auth) {
+        if (!auth) {
+            return undefined;
+        }
+        if (auth.type === 'token') {
+            return `Bearer ${auth.accessToken}`;
+        }
+        const credentials = Buffer.from(`${auth.username}:${auth.password ?? ''}`).toString('base64');
+        return `Basic ${credentials}`;
+    }
+    logRequestError(error) {
+        if (axios.isAxiosError(error) && error.response) {
+            const { status, data } = error.response;
+            const details = typeof data === 'string' ? data : JSON.stringify(data);
+            if (status === 401 || status === 403) {
+                this.log.error(`ntfy request failed: ${status} - the server rejected the credentials. `
+                    + 'Check the authentication settings and that the token or user is allowed to publish to this topic.', details);
+                return;
+            }
+            this.log.error(`ntfy request failed: ${status}`, details);
+            return;
+        }
+        this.log.error('ntfy request failed:', error instanceof Error ? error.message : error);
+    }
+    isMessageRequest(obj) {
+        return typeof obj.topic === 'string';
+    }
+}
+//# sourceMappingURL=ntfy-client.js.map

package/dist/ntfy-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ntfy-client.js","sourceRoot":"","sources":["../src/ntfy-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAY1B,MAAM,OAAO,UAAU;IAIF;IACA;IAJF,UAAU,CAAU;IAErC,YACmB,GAAY,EACZ,aAAqB,EACtC,IAAe;QAFE,QAAG,GAAH,GAAG,CAAS;QACZ,kBAAa,GAAb,aAAa,CAAQ;QAGtC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,OAAgC;QAChD,IAAI,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC;YACnC,OAAO,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YACvC,OAAO,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,kBAAkB,CAAC,OAAuB;QACtD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;QAEjD,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,aAAa,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QAErD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC;QAE7B,MAAM,OAAO,GAA2B,IAAI,CAAC,WAAW,EAAE,CAAC;QAC3D,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAChC,CAAC;QACD,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACrB,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACjD,CAAC;QACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC9B,CAAC;QAED,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,CAAC;aACrC,IAAI,CAAC,QAAQ,CAAC,EAAE;YACf,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC;aACD,KAAK,CAAC,KAAK,CAAC,EAAE;YACb,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,IAAY;QACxC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,4BAA4B,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAE/D,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;aACxE,IAAI,CAAC,QAAQ,CAAC,EAAE;YACf,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,kBAAkB,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC;aACD,KAAK,CAAC,KAAK,CAAC,EAAE;YACb,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC,CAAC,CAAC;IACP,CAAC;IAEO,WAAW;QACjB,OAAO,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IACnE,CAAC;IAEO,eAAe,CAAC,IAAe;QACrC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;YAC1B,OAAO,UAAU,IAAI,CAAC,WAAW,EAAE,CAAC;QACtC,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC9F,OAAO,SAAS,WAAW,EAAE,CAAC;IAChC,CAAC;IAEO,eAAe,CAAC,KAAc;QACpC,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YAChD,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,QAAQ,CAAC;YACxC,MAAM,OAAO,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;YAEvE,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;gBACrC,IAAI,CAAC,GAAG,CAAC,KAAK,CACZ,wBAAwB,MAAM,0CAA0C;sBACtE,mGAAmG,EACrG,OAAO,CACR,CAAC;gBACF,OAAO;YACT,CAAC;YAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wBAAwB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;YAC1D,OAAO;QACT,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACzF,CAAC;IAEO,gBAAgB,CAAC,GAAY;QACnC,OAAO,OAAQ,GAA0B,CAAC,KAAK,KAAK,QAAQ,CAAC;IAC/D,CAAC;CACF"}

package/dist/platform.d.ts

@@ -0,0 +1,16 @@
+import type { API, Characteristic, DynamicPlatformPlugin, Logging, PlatformAccessory, PlatformConfig, Service } from 'homebridge';
+export declare class NtfyPlatform implements DynamicPlatformPlugin {
+    readonly log: Logging;
+    readonly config: PlatformConfig;
+    readonly api: API;
+    readonly Service: typeof Service;
+    readonly Characteristic: typeof Characteristic;
+    private readonly accessories;
+    private readonly discoveredCacheUUIDs;
+    constructor(log: Logging, config: PlatformConfig, api: API);
+    configureAccessory(accessory: PlatformAccessory): void;
+    private registerAccessories;
+    private resolveServerUrl;
+    private resolveAuth;
+    private validateMessage;
+}

package/dist/platform.js

@@ -0,0 +1,108 @@
+import { SwitchAccessory } from './switch-accessory.js';
+import { DEFAULT_SERVER_URL, PLATFORM_NAME, PLUGIN_NAME } from './const.js';
+import { NtfyClient } from './ntfy-client.js';
+import { isValidJson, normalizeServerUrl } from './utils.js';
+export class NtfyPlatform {
+    log;
+    config;
+    api;
+    Service;
+    Characteristic;
+    accessories = new Map();
+    discoveredCacheUUIDs = [];
+    constructor(log, config, api) {
+        this.log = log;
+        this.config = config;
+        this.api = api;
+        this.Service = api.hap.Service;
+        this.Characteristic = api.hap.Characteristic;
+        this.log.debug('Finished initializing platform:', config.name);
+        this.api.on('didFinishLaunching', () => {
+            log.debug('Registering accessories...');
+            this.registerAccessories();
+        });
+    }
+    configureAccessory(accessory) {
+        this.log.debug('Loading accessory from cache:', accessory.displayName);
+        this.accessories.set(accessory.UUID, accessory);
+    }
+    registerAccessories() {
+        const config = this.config;
+        const serverUrl = this.resolveServerUrl(config);
+        this.log.info('Using ntfy server:', serverUrl);
+        const ntfyClient = new NtfyClient(this.log, serverUrl, this.resolveAuth(config));
+        if (config.messages) {
+            for (const message of config.messages) {
+                if (!this.validateMessage(message)) {
+                    continue;
+                }
+                const uuid = this.api.hap.uuid.generate(message.name);
+                const existingAccessory = this.accessories.get(uuid);
+                if (existingAccessory) {
+                    this.log.debug('Restoring existing accessory from cache:', existingAccessory.displayName);
+                    new SwitchAccessory(this, existingAccessory, ntfyClient, message);
+                }
+                else {
+                    this.log.debug('Adding new accessory:', message.name);
+                    const accessory = new this.api.platformAccessory(message.name, uuid);
+                    new SwitchAccessory(this, accessory, ntfyClient, message);
+                    this.api.registerPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
+                }
+                this.discoveredCacheUUIDs.push(uuid);
+            }
+        }
+        for (const [uuid, accessory] of this.accessories) {
+            if (!this.discoveredCacheUUIDs.includes(uuid)) {
+                this.log.debug('Removing existing accessory from cache:', accessory.displayName);
+                this.api.unregisterPlatformAccessories(PLUGIN_NAME, PLATFORM_NAME, [accessory]);
+            }
+        }
+    }
+    resolveServerUrl(config) {
+        const serverUrl = normalizeServerUrl(config.serverUrl);
+        if (config.serverUrl?.trim() && !serverUrl) {
+            this.log.error(`Invalid server URL - falling back to ${DEFAULT_SERVER_URL}:`, config.serverUrl);
+        }
+        return serverUrl ?? DEFAULT_SERVER_URL;
+    }
+    resolveAuth(config) {
+        switch (config.authType) {
+            case 'token':
+                if (!config.accessToken) {
+                    this.log.error('Access token authentication is selected but no access token is configured. Sending requests unauthenticated.');
+                    return undefined;
+                }
+                return { type: 'token', accessToken: config.accessToken };
+            case 'basic':
+                if (!config.username || !config.password) {
+                    this.log.error('Username/password authentication is selected but the credentials are incomplete. Sending requests unauthenticated.');
+                    return undefined;
+                }
+                return { type: 'basic', username: config.username, password: config.password };
+            default:
+                return undefined;
+        }
+    }
+    validateMessage(message) {
+        let error;
+        if (message.useJson) {
+            if (!message.json) {
+                error = 'Invalid JSON message config - \'json\' is missing:';
+            }
+            else if (!isValidJson(message.json)) {
+                error = 'Invalid JSON message config - \'json\' is malformed:';
+            }
+        }
+        else {
+            if (!message.topic) {
+                error = 'Invalid JSON message config - \'topic\' is missing:';
+            }
+        }
+        if (error) {
+            this.log.error(error, message.name);
+            return false;
+        }
+        return true;
+    }
+}
+//# sourceMappingURL=platform.js.map

package/dist/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../src/platform.ts"],"names":[],"mappings":"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"}

package/dist/switch-accessory.d.ts

@@ -0,0 +1,21 @@
+import type { PlatformAccessory } from 'homebridge';
+import type { NtfyClient } from './ntfy-client.js';
+import type { NtfyPlatform } from './platform.js';
+import type { Message } from './types.js';
+export declare class SwitchAccessory {
+    private readonly platform;
+    private readonly accessory;
+    private readonly ntfyClient;
+    private readonly message;
+    private log;
+    private service;
+    private onCharacteristic;
+    private isOn;
+    private inCooldown;
+    constructor(platform: NtfyPlatform, accessory: PlatformAccessory, ntfyClient: NtfyClient, message: Message);
+    private setOn;
+    private getOn;
+    private sendMessage;
+    private triggerCooldown;
+    private resetSwitch;
+}

package/dist/switch-accessory.js

@@ -0,0 +1,90 @@
+import { wait } from './utils.js';
+export class SwitchAccessory {
+    platform;
+    accessory;
+    ntfyClient;
+    message;
+    log;
+    service;
+    onCharacteristic;
+    isOn = false;
+    inCooldown = false;
+    constructor(platform, accessory, ntfyClient, message) {
+        this.platform = platform;
+        this.accessory = accessory;
+        this.ntfyClient = ntfyClient;
+        this.message = message;
+        this.log = platform.log;
+        // Set accessory information
+        const infoService = this.accessory.getService(this.platform.Service.AccessoryInformation);
+        if (infoService) {
+            infoService
+                .setCharacteristic(this.platform.Characteristic.Manufacturer, 'Homebridge Ntfy')
+                .setCharacteristic(this.platform.Characteristic.Model, 'Notification Switch')
+                .setCharacteristic(this.platform.Characteristic.SerialNumber, 'N/A');
+        }
+        this.service = this.accessory.getService(this.platform.Service.Switch) || this.accessory.addService(this.platform.Service.Switch);
+        this.service.setCharacteristic(this.platform.Characteristic.Name, this.message.name);
+        this.onCharacteristic = this.service.getCharacteristic(this.platform.Characteristic.On);
+        // Register handlers for the On/Off Characteristic
+        this.onCharacteristic
+            .onSet(this.setOn.bind(this))
+            .onGet(this.getOn.bind(this));
+    }
+    async setOn(value) {
+        this.log.debug('setOn:', value);
+        this.isOn = value;
+        this.onCharacteristic.updateValue(this.isOn);
+        if (this.inCooldown) {
+            this.log.info('Still in cooldown:', this.message.name);
+            await wait(250);
+            this.resetSwitch();
+            return;
+        }
+        if (this.isOn) {
+            this.triggerCooldown(this.message.cooldownTime);
+            await this.sendMessage();
+            this.resetSwitch();
+        }
+    }
+    async getOn() {
+        return this.isOn;
+    }
+    async sendMessage() {
+        let request;
+        if (!this.message.useJson && this.message.topic) {
+            request = {
+                topic: this.message.topic,
+                title: this.message.title,
+                message: this.message.message,
+                priority: this.message.priority,
+                tags: this.message.tags,
+            };
+        }
+        else if (this.message.useJson && this.message.json) {
+            request = this.message.json;
+        }
+        else {
+            this.log.info('Nothing to send. Check configuration for:', this.message.name);
+            return;
+        }
+        await this.ntfyClient.sendMessage(request);
+        this.log.info('Message sent:', this.message.name);
+    }
+    async triggerCooldown(cooldownTime = 0) {
+        if (cooldownTime <= 0) {
+            return;
+        }
+        this.log.debug('Entering cooldown:', this.message.name);
+        this.inCooldown = true;
+        await wait(cooldownTime);
+        this.inCooldown = false;
+        this.log.debug('Exited cooldown:', this.message.name);
+    }
+    resetSwitch() {
+        this.log.debug('Resetting switch:', this.message.name);
+        this.isOn = false;
+        this.onCharacteristic.updateValue(this.isOn);
+    }
+}
+//# sourceMappingURL=switch-accessory.js.map

package/dist/switch-accessory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-accessory.js","sourceRoot":"","sources":["../src/switch-accessory.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,27 @@
+import { PlatformConfig } from 'homebridge';
+export type AuthType = 'none' | 'token' | 'basic';
+export interface NtfyPlatformConfig extends PlatformConfig {
+    serverUrl?: string;
+    authType?: AuthType;
+    accessToken?: string;
+    username?: string;
+    password?: string;
+    messages: Message[];
+}
+export interface NtfyAuth {
+    type: Exclude<AuthType, 'none'>;
+    accessToken?: string;
+    username?: string;
+    password?: string;
+}
+export interface Message {
+    name: string;
+    topic?: string;
+    title?: string;
+    message?: string;
+    priority?: number;
+    tags?: string;
+    useJson?: boolean;
+    json?: string;
+    cooldownTime?: number;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+export declare const wait: (delay: number) => Promise<void>;
+export declare const isValidJson: (str: string) => boolean;
+/**
+ * Normalizes a user supplied ntfy server address into a base URL without a
+ * trailing slash. Assumes https when no protocol is given and keeps any base
+ * path, so servers behind a reverse proxy (e.g. https://home.example.com/ntfy)
+ * keep working. Returns undefined when the address cannot be parsed.
+ */
+export declare const normalizeServerUrl: (url?: string) => string | undefined;

package/dist/utils.js

@@ -0,0 +1,37 @@
+export const wait = (delay) => new Promise((resolve) => {
+    setTimeout(resolve, delay);
+});
+export const isValidJson = (str) => {
+    try {
+        JSON.parse(str);
+        return true;
+    }
+    catch (e) {
+        return false;
+    }
+};
+/**
+ * Normalizes a user supplied ntfy server address into a base URL without a
+ * trailing slash. Assumes https when no protocol is given and keeps any base
+ * path, so servers behind a reverse proxy (e.g. https://home.example.com/ntfy)
+ * keep working. Returns undefined when the address cannot be parsed.
+ */
+export const normalizeServerUrl = (url) => {
+    const trimmed = url?.trim();
+    if (!trimmed) {
+        return undefined;
+    }
+    const withProtocol = /^[a-z][a-z0-9+.-]*:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+    let parsed;
+    try {
+        parsed = new URL(withProtocol);
+    }
+    catch (e) {
+        return undefined;
+    }
+    if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {
+        return undefined;
+    }
+    return `${parsed.origin}${parsed.pathname.replace(/\/+$/, '')}`;
+};
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAa,EAAiB,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IAC5E,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AAC7B,CAAC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,GAAW,EAAE,EAAE;IACzC,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAY,EAAsB,EAAE;IACrE,MAAM,OAAO,GAAG,GAAG,EAAE,IAAI,EAAE,CAAC;IAC5B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,YAAY,GAAG,0BAA0B,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,OAAO,EAAE,CAAC;IAE/F,IAAI,MAAW,CAAC;IAChB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IACjC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,IAAI,MAAM,CAAC,QAAQ,KAAK,OAAO,IAAI,MAAM,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;AAClE,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "@eribbey/homebridge-ntfy",
+  "displayName": "Homebridge Ntfy",
+  "type": "module",
+  "version": "1.1.0",
+  "description": "Homebridge plugin to send notifications through ntfy from HomeKit, with support for custom self-hosted servers and authentication",
+  "author": "Evan Ribbey",
+  "contributors": [
+    "Emil Löfblom (https://github.com/emilof)"
+  ],
+  "license": "Apache-2.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://git.ribbey.net/evan/homebridge-ntfy#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://git.ribbey.net/evan/homebridge-ntfy.git"
+  },
+  "bugs": {
+    "url": "https://git.ribbey.net/evan/homebridge-ntfy/issues"
+  },
+  "keywords": [
+    "homebridge",
+    "homebridge-plugin",
+    "ntfy",
+    "ntfy-sh",
+    "notifications",
+    "self-hosted"
+  ],
+  "main": "dist/index.js",
+  "engines": {
+    "node": "^20.18.0 || ^22.10.0 || ^24.0.0",
+    "homebridge": "^1.8.0 || ^2.0.0-beta.0"
+  },
+  "scripts": {
+    "build": "rimraf ./dist && tsc",
+    "lint": "eslint . --max-warnings=0",
+    "prepublishOnly": "npm run lint && npm run build",
+    "watch": "npm run build && npm link && nodemon"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@types/node": "^24.10.2",
+    "eslint": "^9.39.1",
+    "homebridge": "^2.0.0-beta.55",
+    "nodemon": "^3.1.11",
+    "rimraf": "^6.1.2",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.49.0"
+  },
+  "dependencies": {
+    "axios": "^1.13.2",
+    "homebridge-lib": "^7.2.0"
+  }
+}