@dwk/host-meta 0.1.0-beta.0

package/LICENSE

@@ -0,0 +1,15 @@
+ISC License
+
+Copyright (c) 2026 David W. Keith
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,90 @@
+# `@dwk/host-meta`
+
+> Web Host Metadata (RFC 6415) host-meta discovery endpoint. Endpoint package.
+
+Part of the [`@dwk` IndieWeb + Solid cohort](../../README.md). See the
+[package specification](../../spec/packages/host-meta.md) for the full
+requirements.
+
+host-meta serves a host-wide resource-discovery document at
+`/.well-known/host-meta` (XRD) and `/.well-known/host-meta.json` (JRD): a set of
+top-level **`Link`** relations — at minimum an **`lrdd`** template pointing at
+the site's WebFinger endpoint. It is largely **superseded by**
+[`@dwk/webfinger`](../webfinger) for account discovery, but some fediverse and
+OpenID software still fetch host-meta to find the `lrdd` template before falling
+back to WebFinger.
+
+## Worker vs. static (why this package exists)
+
+host-meta is **borderline static**. A single-identity site can have its static
+site generator emit fixed `host-meta` + `host-meta.json` files and skip this
+package entirely. A Worker is justified only by:
+
+- **Content negotiation** between the XRD (`application/xrd+xml`) and JRD
+  (`application/jrd+json`) representations from the one `/.well-known/host-meta`
+  URL (RFC 6415 §3), plus a `?format=` override; and
+- a **dynamic `lrdd` template** pointing at this Worker's WebFinger endpoint.
+
+If neither is needed, prefer the static output and do not mount this package.
+
+## Usage
+
+```ts
+import { createHostMeta } from "@dwk/host-meta";
+
+const hostMeta = createHostMeta({
+  // Seeds an `lrdd` link templated to ...?resource={uri}
+  webfingerUrl: "https://example.com/.well-known/webfinger",
+  // Any additional static top-level links
+  links: [
+    {
+      rel: "author",
+      type: "text/html",
+      href: "https://example.com/about",
+    },
+  ],
+});
+
+// In your Worker's fetch handler, mount at both well-known paths:
+//   GET /.well-known/host-meta        → XRD by default
+//   GET /.well-known/host-meta.json   → JRD
+return hostMeta(request, env, ctx);
+```
+
+- The document is **request-invariant** — it is built once at construction from
+  config and served verbatim. `createHostMeta` **fails loudly** if neither
+  `webfingerUrl` nor any `links` is supplied; a host-meta that advertises
+  nothing is always a misconfiguration.
+- The two representations are **information-equivalent** (RFC 6415 §3): the XRD
+  and JRD render the same `subject`, `properties`, and `links`.
+
+### Content negotiation
+
+The representation is chosen, in priority order:
+
+1. an explicit `?format=json` / `?format=xml` query override;
+2. the request path — `/.well-known/host-meta.json` always returns JRD
+   (RFC 7033 §10.1);
+3. the `Accept` header — JRD only when `application/jrd+json` is *strictly*
+   preferred over `application/xrd+xml`; otherwise **XRD is the default** (for
+   ties, wildcards, and a missing header).
+
+Every response — success or error — carries `Access-Control-Allow-Origin: *`
+(discovery data is public) and `Vary: Accept`. `OPTIONS` returns a CORS
+preflight; non-`GET`/`HEAD` methods get **405**.
+
+## Design
+
+Pure and **stateless**: no Durable Object, no D1, and no required Cloudflare
+bindings — the document is config-supplied (composition contract), never read
+from the global environment. The serializers unit-test under Node without a
+Workers runtime. The JRD link shaping is reused from
+[`@dwk/webfinger`](../webfinger); the XRD serializer is the only surface new to
+this package.
+
+## Observability
+
+Discovery events are emitted through the injected `@dwk/log` `Logger`/`Metrics`
+seams (default no-op): `host-meta.served` with the negotiated `format`,
+`host-meta.rejected` for a `405`. The document is host-wide, so no request
+carries user data to redact.

package/dist/config.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Configuration for {@link createHostMeta}: the WebFinger endpoint URL that
+ * seeds the `lrdd` template and/or a set of static top-level links, plus the
+ * optional logging/metrics seams. Per the composition contract the package
+ * never reads the global environment — every link arrives here, so a handler
+ * can be instantiated multiple times and tested in isolation.
+ */
+import { type Logger, type Metrics } from "@dwk/log";
+import type { Link } from "@dwk/webfinger";
+import { type HostMetaDocument } from "./document";
+/** Configuration passed to {@link createHostMeta}. */
+export interface HostMetaConfig {
+    /**
+     * The site's WebFinger endpoint URL (e.g.
+     * `https://example.com/.well-known/webfinger`). When supplied, an `lrdd` link
+     * templated to it (`…?resource={uri}`) is emitted first — the relation
+     * fediverse/OpenID software fetches host-meta to find before falling back to
+     * WebFinger. A URL already containing `{uri}` is used verbatim.
+     */
+    readonly webfingerUrl?: string;
+    /**
+     * Additional static top-level `Link` entries to advertise (e.g. `author`,
+     * `license`). Appended after the auto-generated `lrdd` link. At least one of
+     * {@link webfingerUrl} or `links` MUST be supplied, or {@link createHostMeta}
+     * throws at construction time.
+     */
+    readonly links?: readonly Link[];
+    /** Optional subject the metadata describes — the host itself (XRD `Subject`). */
+    readonly subject?: string;
+    /** Optional host-level properties; a `null` value means "present but absent". */
+    readonly properties?: Readonly<Record<string, string | null>>;
+    /**
+     * Logger for discovery events; defaults to a no-op. Wire a real logger (see
+     * `@dwk/log`) to surface which representation was served and why a request was
+     * rejected instead of swallowing them.
+     */
+    readonly logger?: Logger;
+    /**
+     * Metrics sink for discovery counters; defaults to a no-op. Wire an adapter
+     * (e.g. `analyticsEngineMetrics` from `@dwk/log`) to chart the same events the
+     * logger names — "served/min" by format, "rejection rate".
+     */
+    readonly metrics?: Metrics;
+}
+/** Configuration after defaults are filled and the document is pre-computed. */
+export interface ResolvedConfig {
+    /** The host-meta document, built once at construction (it never varies per request). */
+    readonly document: HostMetaDocument;
+    /** The XRD representation, serialized once at construction. */
+    readonly xrdBody: string;
+    /** The JRD representation, serialized once at construction. */
+    readonly jrdBody: string;
+    readonly logger: Logger;
+    readonly metrics: Metrics;
+}
+/**
+ * Validate and normalise a {@link HostMetaConfig}. Fails loudly when neither a
+ * WebFinger URL nor any static link is configured — a host-meta document that
+ * advertises nothing is always a misconfiguration, not a silently empty `XRD`.
+ * The document is computed once here (it is request-invariant) and reused for
+ * every response.
+ */
+export declare function resolveConfig(config: HostMetaConfig): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAA2B,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,UAAU,CAAC;AAC9E,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,EAAiB,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAIlE,sDAAsD;AACtD,MAAM,WAAW,cAAc;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,gFAAgF;AAChF,MAAM,WAAW,cAAc;IAC7B,wFAAwF;IACxF,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,+DAA+D;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA0BpE"}

package/dist/config.js

@@ -0,0 +1,42 @@
+/**
+ * Configuration for {@link createHostMeta}: the WebFinger endpoint URL that
+ * seeds the `lrdd` template and/or a set of static top-level links, plus the
+ * optional logging/metrics seams. Per the composition contract the package
+ * never reads the global environment — every link arrives here, so a handler
+ * can be instantiated multiple times and tested in isolation.
+ */
+import { noopLogger, noopMetrics } from "@dwk/log";
+import { buildDocument } from "./document";
+import { serializeJrd } from "./jrd";
+import { serializeXrd } from "./xrd";
+/**
+ * Validate and normalise a {@link HostMetaConfig}. Fails loudly when neither a
+ * WebFinger URL nor any static link is configured — a host-meta document that
+ * advertises nothing is always a misconfiguration, not a silently empty `XRD`.
+ * The document is computed once here (it is request-invariant) and reused for
+ * every response.
+ */
+export function resolveConfig(config) {
+    const hasLinks = (config.links?.length ?? 0) > 0;
+    if (config.webfingerUrl === undefined && !hasLinks) {
+        throw new Error("@dwk/host-meta: configure `webfingerUrl` and/or `links` — a host-meta " +
+            "document must advertise at least one link.");
+    }
+    // The document is request-invariant, so both representations are serialized
+    // once here and reused verbatim for every response — no per-request XML
+    // serialization or JSON.stringify.
+    const document = buildDocument({
+        webfingerUrl: config.webfingerUrl,
+        links: config.links,
+        subject: config.subject,
+        properties: config.properties,
+    });
+    return {
+        document,
+        xrdBody: serializeXrd(document),
+        jrdBody: serializeJrd(document),
+        logger: config.logger ?? noopLogger,
+        metrics: config.metrics ?? noopMetrics,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAA6B,MAAM,UAAU,CAAC;AAG9E,OAAO,EAAE,aAAa,EAAyB,MAAM,YAAY,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,OAAO,CAAC;AAiDrC;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IACjD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,QAAQ,EAAE,CAAC;QACnD,MAAM,IAAI,KAAK,CACb,wEAAwE;YACtE,4CAA4C,CAC/C,CAAC;IACJ,CAAC;IAED,4EAA4E;IAC5E,wEAAwE;IACxE,mCAAmC;IACnC,MAAM,QAAQ,GAAG,aAAa,CAAC;QAC7B,YAAY,EAAE,MAAM,CAAC,YAAY;QACjC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IAEH,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC;QAC/B,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC;QAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,UAAU;QACnC,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,WAAW;KACvC,CAAC;AACJ,CAAC"}

package/dist/document.d.ts

@@ -0,0 +1,49 @@
+/**
+ * The host-meta document model (RFC 6415 §2): a host-wide set of top-level
+ * `Link`s plus optional `Subject`/`Property` metadata. The model is a single
+ * plain-data shape that **both** representations render from — the XRD
+ * (`application/xrd+xml`) serializer in `xrd.ts` and the JRD
+ * (`application/jrd+json`) serializer in `jrd.ts` — so the two are guaranteed
+ * information-equivalent (RFC 6415 §3).
+ *
+ * The `Link` type is reused verbatim from `@dwk/webfinger`: host-meta links are
+ * the same `rel`/`href`/`template`/`type`/`titles`/`properties` shape WebFinger
+ * already defines, so the JRD link-shaping is shared and only the XRD serializer
+ * is new (see the package spec).
+ */
+import type { Link } from "@dwk/webfinger";
+export type { Link };
+/**
+ * A resolved host-meta document. `links` is always present (it is the point of
+ * the document); `subject` and `properties` appear only when the operator
+ * configured them. This is what both serializers consume.
+ */
+export interface HostMetaDocument {
+    /** Optional subject the metadata describes — the host itself (XRD `Subject`). */
+    readonly subject?: string;
+    /** Optional host-level properties; a `null` value means "present but absent". */
+    readonly properties?: Readonly<Record<string, string | null>>;
+    /** The top-level link relations advertised for the host. */
+    readonly links: readonly Link[];
+}
+/**
+ * Build the `lrdd` `template` from a WebFinger endpoint URL. The Link-based
+ * Resource Descriptor Document template is the URL clients expand with the
+ * queried resource (`{uri}`) to reach per-account discovery (RFC 6415 §3,
+ * RFC 7033 §10.1). If the supplied URL already contains a `{uri}` placeholder it
+ * is used as-is; otherwise a `resource={uri}` query parameter is appended.
+ */
+export declare function lrddTemplate(webfingerUrl: string): string;
+/**
+ * Assemble the host-meta {@link HostMetaDocument} from the operator's inputs.
+ * When a WebFinger endpoint URL is supplied, an `lrdd` link templated to it is
+ * emitted **first** (the relation fediverse/OpenID software probes for before
+ * falling back to WebFinger), followed by any static operator-configured links.
+ */
+export declare function buildDocument(opts: {
+    readonly webfingerUrl?: string;
+    readonly links?: readonly Link[];
+    readonly subject?: string;
+    readonly properties?: Readonly<Record<string, string | null>>;
+}): HostMetaDocument;
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE3C,YAAY,EAAE,IAAI,EAAE,CAAC;AAErB;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9D,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;CACjC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE;IAClC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,IAAI,EAAE,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CAC/D,GAAG,gBAAgB,CAyBnB"}

package/dist/document.js

@@ -0,0 +1,54 @@
+/**
+ * The host-meta document model (RFC 6415 §2): a host-wide set of top-level
+ * `Link`s plus optional `Subject`/`Property` metadata. The model is a single
+ * plain-data shape that **both** representations render from — the XRD
+ * (`application/xrd+xml`) serializer in `xrd.ts` and the JRD
+ * (`application/jrd+json`) serializer in `jrd.ts` — so the two are guaranteed
+ * information-equivalent (RFC 6415 §3).
+ *
+ * The `Link` type is reused verbatim from `@dwk/webfinger`: host-meta links are
+ * the same `rel`/`href`/`template`/`type`/`titles`/`properties` shape WebFinger
+ * already defines, so the JRD link-shaping is shared and only the XRD serializer
+ * is new (see the package spec).
+ */
+/**
+ * Build the `lrdd` `template` from a WebFinger endpoint URL. The Link-based
+ * Resource Descriptor Document template is the URL clients expand with the
+ * queried resource (`{uri}`) to reach per-account discovery (RFC 6415 §3,
+ * RFC 7033 §10.1). If the supplied URL already contains a `{uri}` placeholder it
+ * is used as-is; otherwise a `resource={uri}` query parameter is appended.
+ */
+export function lrddTemplate(webfingerUrl) {
+    if (webfingerUrl.includes("{uri}"))
+        return webfingerUrl;
+    const separator = webfingerUrl.includes("?") ? "&" : "?";
+    return `${webfingerUrl}${separator}resource={uri}`;
+}
+/**
+ * Assemble the host-meta {@link HostMetaDocument} from the operator's inputs.
+ * When a WebFinger endpoint URL is supplied, an `lrdd` link templated to it is
+ * emitted **first** (the relation fediverse/OpenID software probes for before
+ * falling back to WebFinger), followed by any static operator-configured links.
+ */
+export function buildDocument(opts) {
+    const links = [];
+    if (opts.webfingerUrl !== undefined) {
+        links.push({
+            rel: "lrdd",
+            type: "application/jrd+json",
+            template: lrddTemplate(opts.webfingerUrl),
+        });
+    }
+    if (opts.links) {
+        links.push(...opts.links);
+    }
+    const document = { links };
+    if (opts.subject !== undefined) {
+        document.subject = opts.subject;
+    }
+    if (opts.properties && Object.keys(opts.properties).length > 0) {
+        document.properties = opts.properties;
+    }
+    return document;
+}
+//# sourceMappingURL=document.js.map

package/dist/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAoBH;;;;;;GAMG;AACH,MAAM,UAAU,YAAY,CAAC,YAAoB;IAC/C,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,YAAY,CAAC;IACxD,MAAM,SAAS,GAAG,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IACzD,OAAO,GAAG,YAAY,GAAG,SAAS,gBAAgB,CAAC;AACrD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,IAK7B;IACC,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,IAAI,IAAI,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC;YACT,GAAG,EAAE,MAAM;YACX,IAAI,EAAE,sBAAsB;YAC5B,QAAQ,EAAE,YAAY,CAAC,IAAI,CAAC,YAAY,CAAC;SAC1C,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC5B,CAAC;IAED,MAAM,QAAQ,GAIV,EAAE,KAAK,EAAE,CAAC;IACd,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QAC/B,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAClC,CAAC;IACD,IAAI,IAAI,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/D,QAAQ,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACxC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/handler.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The host-meta fetch handler (RFC 6415): a stateless `GET` endpoint, mountable
+ * at both `/.well-known/host-meta` and `/.well-known/host-meta.json`, that
+ * serves one request-invariant document in either the XRD (`application/xrd+xml`,
+ * the default) or JRD (`application/jrd+json`) representation depending on
+ * content negotiation. Discovery data is public, so every response carries
+ * permissive CORS (mirroring RFC 7033 §10.2).
+ */
+import { type HostMetaConfig } from "./config";
+/**
+ * Cloudflare bindings required by the host-meta handler: **none**. The document
+ * is config-supplied (composition contract), so this fragment is empty and
+ * contributes nothing to the composed Worker's `Env`.
+ */
+export type HostMetaEnv = Record<never, never>;
+/** A `fetch`-compatible Worker handler. */
+export type HostMetaHandler = (request: Request, env: HostMetaEnv, ctx: ExecutionContext) => Promise<Response>;
+/**
+ * Build the host-meta handler from configuration.
+ *
+ * The returned handler is mountable at `/.well-known/host-meta` and
+ * `/.well-known/host-meta.json`. It accepts `GET` (and `HEAD`) and returns
+ * `200` with the host-meta document: XRD by default, JRD when the client
+ * prefers it (`?format=json`, the `host-meta.json` path, or an Accept header
+ * favouring `application/jrd+json`). `OPTIONS` returns a CORS preflight; other
+ * methods get `405`. Fails loudly at construction if no link source is
+ * configured.
+ */
+export declare function createHostMeta(config: HostMetaConfig): HostMetaHandler;
+//# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,UAAU,CAAC;AAIlB;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE/C,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,CAC5B,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,WAAW,EAChB,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,QAAQ,CAAC,CAAC;AAqEvB;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,eAAe,CA+CtE"}

package/dist/handler.js

@@ -0,0 +1,109 @@
+/**
+ * The host-meta fetch handler (RFC 6415): a stateless `GET` endpoint, mountable
+ * at both `/.well-known/host-meta` and `/.well-known/host-meta.json`, that
+ * serves one request-invariant document in either the XRD (`application/xrd+xml`,
+ * the default) or JRD (`application/jrd+json`) representation depending on
+ * content negotiation. Discovery data is public, so every response carries
+ * permissive CORS (mirroring RFC 7033 §10.2).
+ */
+import {} from "@dwk/log";
+import { resolveConfig, } from "./config";
+import { HostMetaLogEvent } from "./log";
+import { negotiateFormat } from "./negotiation";
+/** Media type for an XRD document (RFC 6415 §2). */
+const XRD_CONTENT_TYPE = "application/xrd+xml; charset=utf-8";
+/** Media type for a JSON Resource Descriptor (RFC 7033 §10.2). */
+const JRD_CONTENT_TYPE = "application/jrd+json; charset=utf-8";
+const TEXT_CONTENT_TYPE = "text/plain; charset=utf-8";
+/**
+ * host-meta serves public discovery data to any origin, so every response —
+ * success or error — advertises permissive CORS, mirroring the WebFinger policy
+ * (RFC 7033 §10.2) it links to.
+ */
+const CORS_HEADERS = {
+    "access-control-allow-origin": "*",
+};
+/**
+ * Emit a structured event on both the logger and the metrics seam, which share
+ * one event vocabulary (see `@dwk/log`): `warn` for rejections, `info` for a
+ * served document.
+ */
+function emit(config, level, event, fields) {
+    config.logger[level](event, fields);
+    config.metrics.count(event, fields);
+}
+function documentResponse(body, contentLength, format, method) {
+    return new Response(method === "HEAD" ? null : body, {
+        status: 200,
+        headers: {
+            "content-type": format === "jrd" ? JRD_CONTENT_TYPE : XRD_CONTENT_TYPE,
+            // RFC 9110 §9.3.2: a HEAD response carries the same Content-Length the
+            // corresponding GET would, so it is set explicitly (the body is dropped
+            // for HEAD, which would otherwise omit the header).
+            "content-length": contentLength,
+            // The representation varies on the negotiated content type; advertise it
+            // so shared caches key XRD and JRD responses separately.
+            vary: "Accept",
+            ...CORS_HEADERS,
+        },
+    });
+}
+function errorResponse(status, message, extraHeaders) {
+    return new Response(message, {
+        status,
+        headers: {
+            "content-type": TEXT_CONTENT_TYPE,
+            ...CORS_HEADERS,
+            ...extraHeaders,
+        },
+    });
+}
+/**
+ * Build the host-meta handler from configuration.
+ *
+ * The returned handler is mountable at `/.well-known/host-meta` and
+ * `/.well-known/host-meta.json`. It accepts `GET` (and `HEAD`) and returns
+ * `200` with the host-meta document: XRD by default, JRD when the client
+ * prefers it (`?format=json`, the `host-meta.json` path, or an Accept header
+ * favouring `application/jrd+json`). `OPTIONS` returns a CORS preflight; other
+ * methods get `405`. Fails loudly at construction if no link source is
+ * configured.
+ */
+export function createHostMeta(config) {
+    const resolved = resolveConfig(config);
+    // Pre-serialized bodies and their byte lengths, computed once: nothing about
+    // the document varies per request, so a response is pure header assembly.
+    const byteLength = (body) => String(new TextEncoder().encode(body).length);
+    const representations = {
+        xrd: { body: resolved.xrdBody, length: byteLength(resolved.xrdBody) },
+        jrd: { body: resolved.jrdBody, length: byteLength(resolved.jrdBody) },
+    };
+    return async (request, _env, _ctx) => {
+        const method = request.method;
+        if (method === "OPTIONS") {
+            return new Response(null, {
+                status: 204,
+                headers: {
+                    ...CORS_HEADERS,
+                    "access-control-allow-methods": "GET, HEAD, OPTIONS",
+                    "access-control-allow-headers": "*",
+                },
+            });
+        }
+        if (method !== "GET" && method !== "HEAD") {
+            emit(resolved, "warn", HostMetaLogEvent.Rejected, {
+                reason: "method_not_allowed",
+            });
+            return errorResponse(405, "method_not_allowed: use GET", {
+                allow: "GET, HEAD, OPTIONS",
+            });
+        }
+        const url = new URL(request.url);
+        const isJsonPath = url.pathname.endsWith(".json");
+        const format = negotiateFormat(url, request.headers.get("accept"), isJsonPath);
+        const { body, length } = representations[format];
+        emit(resolved, "info", HostMetaLogEvent.Served, { format });
+        return documentResponse(body, length, format, method);
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `@dwk/host-meta` — Web Host Metadata (RFC 6415) host-meta discovery endpoint.
+ *
+ * Endpoint package: exports a factory returning a `fetch`-compatible handler,
+ * mountable at `/.well-known/host-meta` and `/.well-known/host-meta.json` so it
+ * composes with other `@dwk` packages in one Worker. It serves one host-wide
+ * resource-discovery document — a set of top-level `Link`s, at minimum an
+ * `lrdd` template pointing at the site's WebFinger endpoint — in either the XRD
+ * (`application/xrd+xml`, the default) or JRD (`application/jrd+json`)
+ * representation, chosen by content negotiation (RFC 6415 §3, RFC 7033 §10.1).
+ *
+ * It exists because host-meta is **borderline static**: a single-identity site
+ * can emit fixed files, but only request logic can negotiate XRD ⇄ JRD from the
+ * one URL and template a dynamic `lrdd` link. The package is pure and stateless
+ * — the document is config-supplied (a WebFinger URL and/or static links),
+ * never read from the global environment — so it ships no Durable Object and
+ * needs no bindings, and the serializers unit-test under Node without a Workers
+ * runtime. The XRD serializer is the only surface new to this package; the JRD
+ * link shaping is reused from `@dwk/webfinger`.
+ *
+ * @see spec/packages/host-meta.md
+ * @packageDocumentation
+ */
+export { createHostMeta } from "./handler";
+export type { HostMetaEnv, HostMetaHandler } from "./handler";
+export { resolveConfig, type HostMetaConfig, type ResolvedConfig, } from "./config";
+export { buildDocument, lrddTemplate, type HostMetaDocument, type Link, } from "./document";
+export { buildHostMetaJrd, serializeJrd, type HostMetaJrd } from "./jrd";
+export { serializeXrd, escapeXml, XRD_NAMESPACE } from "./xrd";
+export { negotiateFormat, type Format } from "./negotiation";
+export { HostMetaLogEvent } from "./log";
+export type { Logger, Metrics } from "@dwk/log";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAE9D,OAAO,EACL,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,cAAc,GACpB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,IAAI,GACV,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAE,KAAK,MAAM,EAAE,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AACzC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+/**
+ * `@dwk/host-meta` — Web Host Metadata (RFC 6415) host-meta discovery endpoint.
+ *
+ * Endpoint package: exports a factory returning a `fetch`-compatible handler,
+ * mountable at `/.well-known/host-meta` and `/.well-known/host-meta.json` so it
+ * composes with other `@dwk` packages in one Worker. It serves one host-wide
+ * resource-discovery document — a set of top-level `Link`s, at minimum an
+ * `lrdd` template pointing at the site's WebFinger endpoint — in either the XRD
+ * (`application/xrd+xml`, the default) or JRD (`application/jrd+json`)
+ * representation, chosen by content negotiation (RFC 6415 §3, RFC 7033 §10.1).
+ *
+ * It exists because host-meta is **borderline static**: a single-identity site
+ * can emit fixed files, but only request logic can negotiate XRD ⇄ JRD from the
+ * one URL and template a dynamic `lrdd` link. The package is pure and stateless
+ * — the document is config-supplied (a WebFinger URL and/or static links),
+ * never read from the global environment — so it ships no Durable Object and
+ * needs no bindings, and the serializers unit-test under Node without a Workers
+ * runtime. The XRD serializer is the only surface new to this package; the JRD
+ * link shaping is reused from `@dwk/webfinger`.
+ *
+ * @see spec/packages/host-meta.md
+ * @packageDocumentation
+ */
+export { createHostMeta } from "./handler";
+export { resolveConfig, } from "./config";
+export { buildDocument, lrddTemplate, } from "./document";
+export { buildHostMetaJrd, serializeJrd } from "./jrd";
+export { serializeXrd, escapeXml, XRD_NAMESPACE } from "./xrd";
+export { negotiateFormat } from "./negotiation";
+export { HostMetaLogEvent } from "./log";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAG3C,OAAO,EACL,aAAa,GAGd,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,aAAa,EACb,YAAY,GAGb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAoB,MAAM,OAAO,CAAC;AAEzE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE/D,OAAO,EAAE,eAAe,EAAe,MAAM,eAAe,CAAC;AAE7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC"}

package/dist/jrd.d.ts

@@ -0,0 +1,33 @@
+/**
+ * JRD (JSON Resource Descriptor) rendering of a host-meta document
+ * (RFC 7033 §10.1, the `host-meta.json` variant of RFC 6415). The host-meta
+ * `Link` objects are already the WebFinger JRD link shape — reused verbatim
+ * from `@dwk/webfinger` — so rendering is just assembling the top-level members
+ * and dropping any the document did not supply, mirroring `@dwk/webfinger`'s
+ * `buildJrd`. The XRD serializer (`xrd.ts`) renders the *same* document model,
+ * keeping the two representations information-equivalent.
+ */
+import type { HostMetaDocument, Link } from "./document";
+/**
+ * A fully-rendered host-meta JRD. `links` is always present (possibly empty);
+ * `subject` and `properties` appear only when the document supplied them, so the
+ * JSON stays minimal.
+ */
+export interface HostMetaJrd {
+    /** The subject the metadata describes, when configured. */
+    readonly subject?: string;
+    /** Host-level properties, when configured. */
+    readonly properties?: Readonly<Record<string, string | null>>;
+    /** The top-level link set. */
+    readonly links: readonly Link[];
+}
+/**
+ * Shape a {@link HostMetaDocument} into its {@link HostMetaJrd} object: carry
+ * through `subject`/`properties` only when present, and emit the links as-is
+ * (they are already JRD-shaped). Exposed so callers can embed the JRD object
+ * rather than re-parse the serialized string.
+ */
+export declare function buildHostMetaJrd(document: HostMetaDocument): HostMetaJrd;
+/** Serialize a host-meta document to a JRD (`application/jrd+json`) body. */
+export declare function serializeJrd(document: HostMetaDocument): string;
+//# sourceMappingURL=jrd.d.ts.map

package/dist/jrd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jrd.d.ts","sourceRoot":"","sources":["../src/jrd.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEzD;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9D,8BAA8B;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,IAAI,EAAE,CAAC;CACjC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,WAAW,CAaxE;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,CAE/D"}

package/dist/jrd.js

@@ -0,0 +1,30 @@
+/**
+ * JRD (JSON Resource Descriptor) rendering of a host-meta document
+ * (RFC 7033 §10.1, the `host-meta.json` variant of RFC 6415). The host-meta
+ * `Link` objects are already the WebFinger JRD link shape — reused verbatim
+ * from `@dwk/webfinger` — so rendering is just assembling the top-level members
+ * and dropping any the document did not supply, mirroring `@dwk/webfinger`'s
+ * `buildJrd`. The XRD serializer (`xrd.ts`) renders the *same* document model,
+ * keeping the two representations information-equivalent.
+ */
+/**
+ * Shape a {@link HostMetaDocument} into its {@link HostMetaJrd} object: carry
+ * through `subject`/`properties` only when present, and emit the links as-is
+ * (they are already JRD-shaped). Exposed so callers can embed the JRD object
+ * rather than re-parse the serialized string.
+ */
+export function buildHostMetaJrd(document) {
+    const jrd = { links: document.links };
+    if (document.subject !== undefined) {
+        jrd.subject = document.subject;
+    }
+    if (document.properties && Object.keys(document.properties).length > 0) {
+        jrd.properties = document.properties;
+    }
+    return jrd;
+}
+/** Serialize a host-meta document to a JRD (`application/jrd+json`) body. */
+export function serializeJrd(document) {
+    return JSON.stringify(buildHostMetaJrd(document));
+}
+//# sourceMappingURL=jrd.js.map

package/dist/jrd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jrd.js","sourceRoot":"","sources":["../src/jrd.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkBH;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA0B;IACzD,MAAM,GAAG,GAIL,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC9B,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACnC,GAAG,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACjC,CAAC;IACD,IAAI,QAAQ,CAAC,UAAU,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvE,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;IACvC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,QAA0B;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACpD,CAAC"}