@fedify/webfinger 2.0.0-dev.0 → 2.0.0-dev.158

package/README.md

@@ -0,0 +1,141 @@
+<!-- deno-fmt-ignore-file -->
+
+@fedify/webfinger: WebFinger client library for ActivityPub
+===========================================================
+
+[![JSR][JSR badge]][JSR]
+[![npm][npm badge]][npm]
+
+This package provides a WebFinger client implementation for looking up
+ActivityPub actors and other resources in the fediverse.  It is part of the
+[Fedify] framework but can be used independently.
+
+[JSR]: https://jsr.io/@fedify/webfinger
+[JSR badge]: https://jsr.io/badges/@fedify/webfinger
+[npm]: https://www.npmjs.com/package/@fedify/webfinger
+[npm badge]: https://img.shields.io/npm/v/@fedify/webfinger?logo=npm
+[Fedify]: https://fedify.dev/
+
+
+Features
+--------
+
+ -  WebFinger resource lookup ([RFC 7033])
+ -  Support for `acct:` URI scheme
+ -  Automatic HTTPS URL construction
+ -  Configurable redirect handling
+ -  OpenTelemetry integration for tracing
+ -  Private IP address validation for security
+
+[RFC 7033]: https://datatracker.ietf.org/doc/html/rfc7033
+
+
+Installation
+------------
+
+~~~~ bash
+deno add jsr:@fedify/webfinger  # Deno
+npm add @fedify/webfinger       # npm
+pnpm add @fedify/webfinger      # pnpm
+yarn add @fedify/webfinger      # Yarn
+bun add @fedify/webfinger       # Bun
+~~~~
+
+
+Usage
+-----
+
+### Looking up a WebFinger resource
+
+You can look up a WebFinger resource using the `lookupWebFinger()` function:
+
+~~~~ typescript
+import { lookupWebFinger } from "@fedify/webfinger";
+
+// Look up by acct: URI
+const result = await lookupWebFinger("acct:alice@example.com");
+
+// Look up by URL
+const result2 = await lookupWebFinger("https://example.com/users/alice");
+~~~~
+
+### Working with the result
+
+The result is a `ResourceDescriptor` object containing the subject, aliases,
+properties, and links:
+
+~~~~ typescript
+import { lookupWebFinger } from "@fedify/webfinger";
+
+const result = await lookupWebFinger("acct:alice@example.com");
+if (result != null) {
+  console.log("Subject:", result.subject);
+  console.log("Aliases:", result.aliases);
+
+  // Find the ActivityPub actor URL
+  const actorLink = result.links?.find(
+    (link) => link.rel === "self" && link.type === "application/activity+json"
+  );
+  if (actorLink?.href != null) {
+    console.log("Actor URL:", actorLink.href);
+  }
+}
+~~~~
+
+### Configuration options
+
+The `lookupWebFinger()` function accepts various options:
+
+~~~~ typescript
+import { lookupWebFinger } from "@fedify/webfinger";
+
+const result = await lookupWebFinger("acct:alice@example.com", {
+  // Custom User-Agent header
+  userAgent: "MyApp/1.0",
+
+  // Maximum redirects to follow (default: 5)
+  maxRedirection: 3,
+
+  // AbortSignal for cancellation
+  signal: AbortSignal.timeout(5000),
+});
+~~~~
+
+
+API
+---
+
+### Functions
+
+ -  `lookupWebFinger(resource, options?)`: Looks up a WebFinger resource and
+    returns a `ResourceDescriptor` or `null` if not found.
+
+### Types
+
+ -  `ResourceDescriptor`: Describes a WebFinger resource with subject, aliases,
+    properties, and links.
+ -  `Link`: Represents a link in a WebFinger response with relation type, media
+    type, href, titles, and properties.
+ -  `LookupWebFingerOptions`: Options for the `lookupWebFinger()` function.
+
+
+Documentation
+-------------
+
+For comprehensive documentation, please refer to:
+
+ -  [WebFinger documentation](https://fedify.dev/manual/webfinger)
+ -  [API reference](https://jsr.io/@fedify/webfinger/doc/~)
+
+
+Related packages
+----------------
+
+ -  *@fedify/fedify*: The main Fedify framework
+ -  *@fedify/vocab*: Activity Vocabulary library
+
+
+License
+-------
+
+[MIT License](https://github.com/fedify-dev/fedify/blob/main/LICENSE)

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/webfinger",
-  "version": "2.0.0",
+  "version": "2.0.0-dev.158+628cd89e",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts"

package/dist/lookup.test.cjs

@@ -24,13 +24,151 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 }) : target, mod));
 
 //#endregion
-const __fedify_fixture = __toESM(require("@fedify/fixture"));
+const __logtape_logtape = __toESM(require("@logtape/logtape"));
+const __opentelemetry_api = __toESM(require("@opentelemetry/api"));
 const es_toolkit = __toESM(require("es-toolkit"));
 const node_assert_strict = __toESM(require("node:assert/strict"));
 const __fedify_vocab_runtime = __toESM(require("@fedify/vocab-runtime"));
-const __logtape_logtape = __toESM(require("@logtape/logtape"));
-const __opentelemetry_api = __toESM(require("@opentelemetry/api"));
 
+//#region ../fixture/dist/mod.js
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof require !== "undefined" ? require : a)[b] }) : x)(function(x) {
+	if (typeof require !== "undefined") return require.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function.");
+});
+const logger$1 = (0, __logtape_logtape.getLogger)(["fixture", "docloader"]);
+const testDefinitions = [];
+function test(name$1, options, fn) {
+	const def = typeof name$1 === "string" ? typeof options === "function" ? {
+		name: name$1,
+		fn: options
+	} : {
+		name: name$1,
+		...options,
+		fn
+	} : name$1;
+	testDefinitions.push(def);
+	if ("Deno" in globalThis) {
+		const func = def.fn;
+		Deno.test({
+			...def,
+			async fn(t) {
+				const records = [];
+				await (0, __logtape_logtape.configure)({
+					sinks: {
+						buffer(record) {
+							if (record.category.length > 1 && record.category[0] === "logtape" && record.category[1] === "meta") return;
+							records.push(record);
+						},
+						console: (0, __logtape_logtape.getConsoleSink)()
+					},
+					filters: {},
+					loggers: [{
+						category: [],
+						sinks: [Deno.env.get("LOG") === "always" ? "console" : "buffer"]
+					}]
+				});
+				try {
+					await func(t);
+				} catch (e) {
+					const consoleSink = (0, __logtape_logtape.getConsoleSink)();
+					for (const record of records) consoleSink(record);
+					throw e;
+				} finally {
+					await (0, __logtape_logtape.reset)();
+				}
+			}
+		});
+	} else if ("Bun" in globalThis) {
+		let failed = void 0;
+		async function step(defOrNameOrFn, fn$2) {
+			let def$1;
+			if (typeof defOrNameOrFn === "string") def$1 = {
+				name: defOrNameOrFn,
+				fn: fn$2
+			};
+			else if (typeof defOrNameOrFn === "function") def$1 = {
+				name: defOrNameOrFn.name,
+				fn: defOrNameOrFn
+			};
+			else def$1 = defOrNameOrFn;
+			if (def$1.ignore) return true;
+			try {
+				await def$1.fn({
+					name: def$1.name,
+					origin: "",
+					step
+				});
+			} catch (e) {
+				failed ??= e;
+				return false;
+			}
+			return true;
+		}
+		const ctx = {
+			name: def.name,
+			origin: "",
+			step
+		};
+		async function fn$1() {
+			await def.fn(ctx);
+			if (failed) throw failed;
+		}
+		const bunTest = Bun.jest(caller()).test;
+		if (def.ignore) bunTest.skip(def.name, fn$1);
+		else if (def.only) bunTest.only(def.name, fn$1);
+		else bunTest(def.name, fn$1);
+	} else try {
+		const { test: nodeTest } = __require("node:test");
+		nodeTest(def.name, {
+			only: def.only,
+			skip: def.ignore
+		}, async (t) => {
+			await def.fn(intoDenoTestContext(def.name, t));
+		});
+	} catch {}
+}
+function intoDenoTestContext(name$1, ctx) {
+	async function step(defOrNameOrFn, fn) {
+		let def;
+		if (typeof defOrNameOrFn === "string") def = {
+			name: defOrNameOrFn,
+			fn
+		};
+		else if (typeof defOrNameOrFn === "function") def = {
+			name: defOrNameOrFn.name,
+			fn: defOrNameOrFn
+		};
+		else def = defOrNameOrFn;
+		let failed = false;
+		await ctx.test(def.name, async (ctx2) => {
+			try {
+				await def.fn(intoDenoTestContext(def.name, ctx2));
+			} catch (e) {
+				failed = true;
+				throw e;
+			}
+		});
+		return failed;
+	}
+	const denoCtx = {
+		name: name$1,
+		origin: ctx.filePath ?? "",
+		step
+	};
+	return denoCtx;
+}
+/** Retrieve caller test file. */
+function caller() {
+	const Trace = Error;
+	const _ = Trace.prepareStackTrace;
+	Trace.prepareStackTrace = (_$1, stack$1) => stack$1;
+	const { stack } = /* @__PURE__ */ new Error();
+	Trace.prepareStackTrace = _;
+	const caller$1 = stack[2];
+	return caller$1.getFileName().replaceAll("\\", "/");
+}
+
+//#endregion
 //#region ../../node_modules/.pnpm/glob-to-regexp@0.4.1/node_modules/glob-to-regexp/index.js
 var require_glob_to_regexp = __commonJS({ "../../node_modules/.pnpm/glob-to-regexp@0.4.1/node_modules/glob-to-regexp/index.js"(exports, module) {
 	module.exports = function(glob$1, opts) {
@@ -1267,7 +1405,7 @@ var esm_default = FetchMock_default;
 //#endregion
 //#region deno.json
 var name = "@fedify/webfinger";
-var version = "2.0.0";
+var version = "2.0.0-dev.158+628cd89e";
 var license = "MIT";
 var exports$1 = { ".": "./src/mod.ts" };
 var description = "WebFinger client library for Fedify";
@@ -1421,7 +1559,7 @@ async function lookupWebFingerInternal(resource, options = {}) {
 
 //#endregion
 //#region src/lookup.test.ts
-(0, __fedify_fixture.test)({
+test({
 	name: "lookupWebFinger()",
 	sanitizeOps: false,
 	sanitizeResources: false,

package/dist/lookup.test.js

@@ -1,10 +1,9 @@
-import "node:module";
-import { test } from "@fedify/fixture";
+import { createRequire } from "node:module";
+import { configure, getConsoleSink, getLogger, reset } from "@logtape/logtape";
+import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 import { withTimeout } from "es-toolkit";
 import { deepStrictEqual } from "node:assert/strict";
 import { UrlError, getUserAgent, validatePublicUrl } from "@fedify/vocab-runtime";
-import { getLogger } from "@logtape/logtape";
-import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 
 //#region rolldown:runtime
 var __create = Object.create;
@@ -30,6 +29,146 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	value: mod,
 	enumerable: true
 }) : target, mod));
+var __require$1 = /* @__PURE__ */ createRequire(import.meta.url);
+
+//#endregion
+//#region ../fixture/dist/mod.js
+var __require = /* @__PURE__ */ ((x) => typeof __require$1 !== "undefined" ? __require$1 : typeof Proxy !== "undefined" ? new Proxy(x, { get: (a, b) => (typeof __require$1 !== "undefined" ? __require$1 : a)[b] }) : x)(function(x) {
+	if (typeof __require$1 !== "undefined") return __require$1.apply(this, arguments);
+	throw Error("Calling `require` for \"" + x + "\" in an environment that doesn't expose the `require` function.");
+});
+const logger$1 = getLogger(["fixture", "docloader"]);
+const testDefinitions = [];
+function test(name$1, options, fn) {
+	const def = typeof name$1 === "string" ? typeof options === "function" ? {
+		name: name$1,
+		fn: options
+	} : {
+		name: name$1,
+		...options,
+		fn
+	} : name$1;
+	testDefinitions.push(def);
+	if ("Deno" in globalThis) {
+		const func = def.fn;
+		Deno.test({
+			...def,
+			async fn(t) {
+				const records = [];
+				await configure({
+					sinks: {
+						buffer(record) {
+							if (record.category.length > 1 && record.category[0] === "logtape" && record.category[1] === "meta") return;
+							records.push(record);
+						},
+						console: getConsoleSink()
+					},
+					filters: {},
+					loggers: [{
+						category: [],
+						sinks: [Deno.env.get("LOG") === "always" ? "console" : "buffer"]
+					}]
+				});
+				try {
+					await func(t);
+				} catch (e) {
+					const consoleSink = getConsoleSink();
+					for (const record of records) consoleSink(record);
+					throw e;
+				} finally {
+					await reset();
+				}
+			}
+		});
+	} else if ("Bun" in globalThis) {
+		let failed = void 0;
+		async function step(defOrNameOrFn, fn$2) {
+			let def$1;
+			if (typeof defOrNameOrFn === "string") def$1 = {
+				name: defOrNameOrFn,
+				fn: fn$2
+			};
+			else if (typeof defOrNameOrFn === "function") def$1 = {
+				name: defOrNameOrFn.name,
+				fn: defOrNameOrFn
+			};
+			else def$1 = defOrNameOrFn;
+			if (def$1.ignore) return true;
+			try {
+				await def$1.fn({
+					name: def$1.name,
+					origin: "",
+					step
+				});
+			} catch (e) {
+				failed ??= e;
+				return false;
+			}
+			return true;
+		}
+		const ctx = {
+			name: def.name,
+			origin: "",
+			step
+		};
+		async function fn$1() {
+			await def.fn(ctx);
+			if (failed) throw failed;
+		}
+		const bunTest = Bun.jest(caller()).test;
+		if (def.ignore) bunTest.skip(def.name, fn$1);
+		else if (def.only) bunTest.only(def.name, fn$1);
+		else bunTest(def.name, fn$1);
+	} else try {
+		const { test: nodeTest } = __require("node:test");
+		nodeTest(def.name, {
+			only: def.only,
+			skip: def.ignore
+		}, async (t) => {
+			await def.fn(intoDenoTestContext(def.name, t));
+		});
+	} catch {}
+}
+function intoDenoTestContext(name$1, ctx) {
+	async function step(defOrNameOrFn, fn) {
+		let def;
+		if (typeof defOrNameOrFn === "string") def = {
+			name: defOrNameOrFn,
+			fn
+		};
+		else if (typeof defOrNameOrFn === "function") def = {
+			name: defOrNameOrFn.name,
+			fn: defOrNameOrFn
+		};
+		else def = defOrNameOrFn;
+		let failed = false;
+		await ctx.test(def.name, async (ctx2) => {
+			try {
+				await def.fn(intoDenoTestContext(def.name, ctx2));
+			} catch (e) {
+				failed = true;
+				throw e;
+			}
+		});
+		return failed;
+	}
+	const denoCtx = {
+		name: name$1,
+		origin: ctx.filePath ?? "",
+		step
+	};
+	return denoCtx;
+}
+/** Retrieve caller test file. */
+function caller() {
+	const Trace = Error;
+	const _ = Trace.prepareStackTrace;
+	Trace.prepareStackTrace = (_$1, stack$1) => stack$1;
+	const { stack } = /* @__PURE__ */ new Error();
+	Trace.prepareStackTrace = _;
+	const caller$1 = stack[2];
+	return caller$1.getFileName().replaceAll("\\", "/");
+}
 
 //#endregion
 //#region ../../node_modules/.pnpm/glob-to-regexp@0.4.1/node_modules/glob-to-regexp/index.js
@@ -1268,7 +1407,7 @@ var esm_default = FetchMock_default;
 //#endregion
 //#region deno.json
 var name = "@fedify/webfinger";
-var version = "2.0.0";
+var version = "2.0.0-dev.158+628cd89e";
 var license = "MIT";
 var exports = { ".": "./src/mod.ts" };
 var description = "WebFinger client library for Fedify";

package/dist/mod.cjs

@@ -27,7 +27,7 @@ const __opentelemetry_api = __toESM(require("@opentelemetry/api"));
 
 //#region deno.json
 var name = "@fedify/webfinger";
-var version = "2.0.0";
+var version = "2.0.0-dev.158+628cd89e";
 var license = "MIT";
 var exports$1 = { ".": "./src/mod.ts" };
 var description = "WebFinger client library for Fedify";

package/dist/mod.js

@@ -4,7 +4,7 @@ import { SpanKind, SpanStatusCode, trace } from "@opentelemetry/api";
 
 //#region deno.json
 var name = "@fedify/webfinger";
-var version = "2.0.0";
+var version = "2.0.0-dev.158+628cd89e";
 var license = "MIT";
 var exports = { ".": "./src/mod.ts" };
 var description = "WebFinger client library for Fedify";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/webfinger",
-  "version": "2.0.0-dev.0",
+  "version": "2.0.0-dev.158+628cd89e",
   "homepage": "https://fedify.dev/",
   "repository": {
     "type": "git",
@@ -60,7 +60,7 @@
     "@logtape/logtape": "^1.3.5",
     "@opentelemetry/api": "^1.9.0",
     "es-toolkit": "1.43.0",
-    "@fedify/vocab-runtime": "2.0.0"
+    "@fedify/vocab-runtime": "2.0.0-dev.158+628cd89e"
   },
   "scripts": {
     "build": "tsdown",