dnssd-advertise 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# dns-message
+
+## 1.0.0
+
+Initial Release.

package/LICENSE.md

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) Phil Pluckthun,
+Copyright (c) 650 Industries, Inc. (aka Expo),
+
+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.

package/README.md

@@ -0,0 +1,56 @@
+# dnssd-advertise
+
+A well-behaved Bonjour/DNS-SD service advertiser for Node.js, designed for long-running processes.
+
+- Aims to be compliant with [RFC 6762](https://datatracker.ietf.org/doc/html/rfc6762) and [RFC 6763](https://datatracker.ietf.org/doc/html/rfc6763#section-6)
+- Handles network interface changes, socket recovery, and re-announcements for long-running processes
+- Supports dual-stack IPv4 and IPv6 service announcement with NIC-scoped responses
+- Single dependency ([dns-message](https://github.com/kitten/dns-message) is bundled)
+
+## Quick Reference
+
+```javascript
+import { advertise } from 'dnssd-advertise';
+
+const stop = advertise({
+  name: 'My Service',
+  type: 'http',
+  protocol: 'tcp',
+  port: 3000,
+});
+
+process.on('exit', () => {
+  stop();
+});
+```
+
+### Conflict Resolution
+
+When a conflict is detected during probing, as per the specification, the name or hostname of your service may be altered:
+
+- When the `name` conflicts a 4-character hex ID is appended (e.g. `My Service (B0A1)`
+- When the `hostname` conflicts a number is appended to it (e.g. `my-hostname-2`)
+
+When a conflict is detected during announcing, the probing phase restarts with the same conflict resolution.
+
+## API Reference
+
+### `advertise(options): () => Promise<void>`
+
+Starts advertising a DNS-SD service on all available network interfaces.
+
+Returns a function that, when called, stops advertising and sends goodbye packets to remove the service from the network.
+Stopping the advertiser is, while preferred, optional as per the mDNS specification.
+
+#### Options
+
+| Option     | Type                       | Description                                                        |
+| ---------- | -------------------------- | ------------------------------------------------------------------ |
+| `name`     | `string`                   | Instance/display name of the service (e.g., "Living Room Speaker") |
+| `type`     | `string`                   | Service type without protocol (e.g., "http", "ssh", "airplay")     |
+| `protocol` | `'tcp' \| 'udp'`           | Protocol used by the service                                       |
+| `port`     | `number`                   | Port the service is listening on                                   |
+| `hostname` | `string`                   | Hostname to advertise (defaults to system hostname)                |
+| `subtypes` | `string[]`                 | Optional list of subtypes                                          |
+| `txt`      | `Record<string, TxtValue>` | Optional service metadata as key-value pairs                       |
+| `ttl`      | `number`                   | TTL for DNS records in seconds (defaults to 250s)                  |

package/dist/dnssd-advertise.d.ts

@@ -0,0 +1,28 @@
+type TxtValue = string | number | boolean | null | undefined;
+
+interface AdvertiseOptions {
+  /** Instance/display name of the service */
+  name: string;
+  /** Service type without protocol (e.g. "http") */
+  type: string;
+  /** Protocol used by the service (typically "tcp" or "udp") */
+  protocol: 'tcp' | 'udp' | (string & {});
+  /** Hostname of device offering the service */
+  hostname?: string;
+  /** Port the service is listening on */
+  port: number;
+  /** List of subtypes for selective discovery */
+  subtypes?: string[];
+  /** Service metadata */
+  txt?: Record<string, TxtValue>;
+  /** TTL to apply to service records */
+  ttl?: number;
+}
+interface AdvertiserHandle {
+  readonly promise: Promise<void>;
+  close(): Promise<void>;
+}
+declare function advertise(options: AdvertiseOptions): () => Promise<void>;
+
+export { advertise };
+export type { AdvertiseOptions, AdvertiserHandle };