@fedify/lint 2.5.0-dev.2541 → 2.5.0-dev.2568

package/README.md

@@ -82,6 +82,10 @@ federation code:
  -  **`actor-id-required`**: Ensures all actors have an `id` property
  -  **`actor-id-mismatch`**: Validates that actor IDs match the expected URI
     from `Context.getActorUri()`
+ -  **`actor-preferred-username-required`**: Ensures actors expose a stable
+    `preferredUsername`
+ -  **`actor-profile-url-required`**: Ensures actors include a `url` (or
+    `urls`) pointing to their human-readable profile page
  -  **`actor-public-key-required`**: Ensures actors have public keys for
     HTTP Signatures
  -  **`actor-assertion-method-required`**: Validates assertion methods for

package/deno.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/lint",
-  "version": "2.5.0-dev.2541+d39a2437",
+  "version": "2.5.0-dev.2568+889927c4",
   "license": "MIT",
   "exports": {
     ".": "./src/mod.ts",

package/dist/index.cjs

@@ -24,7 +24,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_outbox_listener_delivery_required = require("./outbox-listener-delivery-required-yvQhmuwt.cjs");
+const require_outbox_listener_delivery_required = require("./outbox-listener-delivery-required-DaY8FcID.cjs");
 let _fxts_core = require("@fxts/core");
 let _typescript_eslint_parser = require("@typescript-eslint/parser");
 _typescript_eslint_parser = __toESM(_typescript_eslint_parser, 1);
@@ -34,29 +34,30 @@ _typescript_eslint_parser = __toESM(_typescript_eslint_parser, 1);
 * Provides lint rules for validating Fedify federation code.
 */
 const rules = {
-	[require_outbox_listener_delivery_required.RULE_IDS.actorIdMismatch]: require_outbox_listener_delivery_required.eslint$20,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorIdRequired]: require_outbox_listener_delivery_required.eslint$19,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyRequired]: require_outbox_listener_delivery_required.eslint$21,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyMismatch]: require_outbox_listener_delivery_required.eslint$22,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyRequired]: require_outbox_listener_delivery_required.eslint$23,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyMismatch]: require_outbox_listener_delivery_required.eslint$24,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$13,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$14,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyRequired]: require_outbox_listener_delivery_required.eslint$15,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$16,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyRequired]: require_outbox_listener_delivery_required.eslint$27,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$28,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyRequired]: require_outbox_listener_delivery_required.eslint$25,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyMismatch]: require_outbox_listener_delivery_required.eslint$26,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$17,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$18,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorIdMismatch]: require_outbox_listener_delivery_required.eslint$21,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorIdRequired]: require_outbox_listener_delivery_required.eslint$20,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyRequired]: require_outbox_listener_delivery_required.eslint$22,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyMismatch]: require_outbox_listener_delivery_required.eslint$23,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyRequired]: require_outbox_listener_delivery_required.eslint$24,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyMismatch]: require_outbox_listener_delivery_required.eslint$25,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$14,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$15,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyRequired]: require_outbox_listener_delivery_required.eslint$16,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$17,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyRequired]: require_outbox_listener_delivery_required.eslint$28,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$29,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyRequired]: require_outbox_listener_delivery_required.eslint$26,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyMismatch]: require_outbox_listener_delivery_required.eslint$27,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$18,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$19,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorSharedInboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$9,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorSharedInboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$10,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorUploadMediaPropertyRequired]: require_outbox_listener_delivery_required.eslint$7,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorUploadMediaPropertyMismatch]: require_outbox_listener_delivery_required.eslint$8,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorPublicKeyRequired]: require_outbox_listener_delivery_required.eslint$11,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorAssertionMethodRequired]: require_outbox_listener_delivery_required.eslint$29,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorPreferredUsernameRequired]: require_outbox_listener_delivery_required.eslint$12,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorAssertionMethodRequired]: require_outbox_listener_delivery_required.eslint$30,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorPreferredUsernameRequired]: require_outbox_listener_delivery_required.eslint$13,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorProfileUrlRequired]: require_outbox_listener_delivery_required.eslint$12,
 	[require_outbox_listener_delivery_required.RULE_IDS.collectionFilteringNotImplemented]: require_outbox_listener_delivery_required.eslint$6,
 	[require_outbox_listener_delivery_required.RULE_IDS.outboxListenerDeliveryRequired]: require_outbox_listener_delivery_required.eslint,
 	[require_outbox_listener_delivery_required.RULE_IDS.outboxListenerDeliveryNotAwaited]: require_outbox_listener_delivery_required.eslint$1,

package/dist/index.js

@@ -1,4 +1,4 @@
-import { A as eslint$21, C as eslint$3, D as eslint$13, E as eslint$12, M as name, N as version, O as eslint$10, S as eslint$2, T as eslint$5, _ as eslint$9, a as eslint$28, b as eslint$1, c as eslint$18, d as eslint$17, f as eslint$20, g as eslint$8, h as eslint$7, i as eslint$27, j as RULE_IDS, k as eslint$11, l as eslint$19, m as eslint$6, n as eslint$25, o as eslint$29, p as eslint$22, r as eslint$26, s as eslint$23, t as eslint$24, u as eslint$16, v as eslint$14, w as eslint$4, x as eslint, y as eslint$15 } from "./outbox-listener-delivery-required-wzZRR9jI.js";
+import { A as eslint$11, C as eslint$2, D as eslint$12, E as eslint$5, M as RULE_IDS, N as name, O as eslint$13, P as version, S as eslint, T as eslint$4, _ as eslint$8, a as eslint$29, b as eslint$15, c as eslint$18, d as eslint$17, f as eslint$20, g as eslint$7, h as eslint$6, i as eslint$28, j as eslint$21, k as eslint$10, l as eslint$19, m as eslint$22, n as eslint$26, o as eslint$30, p as eslint$23, r as eslint$27, s as eslint$24, t as eslint$25, u as eslint$16, v as eslint$9, w as eslint$3, x as eslint$1, y as eslint$14 } from "./outbox-listener-delivery-required-CwhiEW-i.js";
 import { fromEntries, keys, map, pipe } from "@fxts/core";
 import parser from "@typescript-eslint/parser";
 //#region src/index.ts
@@ -30,13 +30,14 @@ const rules = {
 	[RULE_IDS.actorPublicKeyRequired]: eslint$20,
 	[RULE_IDS.actorAssertionMethodRequired]: eslint$21,
 	[RULE_IDS.actorPreferredUsernameRequired]: eslint$22,
-	[RULE_IDS.collectionFilteringNotImplemented]: eslint$23,
-	[RULE_IDS.outboxListenerDeliveryRequired]: eslint$24,
-	[RULE_IDS.outboxListenerDeliveryNotAwaited]: eslint$25,
-	[RULE_IDS.mediaUploaderObjectUriRequired]: eslint$26,
-	[RULE_IDS.mediaUploaderAuthorizationRequired]: eslint$27,
-	[RULE_IDS.denoKvStoreDeprecated]: eslint$28,
-	[RULE_IDS.denoKvMessageQueueDeprecated]: eslint$29
+	[RULE_IDS.actorProfileUrlRequired]: eslint$23,
+	[RULE_IDS.collectionFilteringNotImplemented]: eslint$24,
+	[RULE_IDS.outboxListenerDeliveryRequired]: eslint$25,
+	[RULE_IDS.outboxListenerDeliveryNotAwaited]: eslint$26,
+	[RULE_IDS.mediaUploaderObjectUriRequired]: eslint$27,
+	[RULE_IDS.mediaUploaderAuthorizationRequired]: eslint$28,
+	[RULE_IDS.denoKvStoreDeprecated]: eslint$29,
+	[RULE_IDS.denoKvMessageQueueDeprecated]: eslint$30
 };
 const recommendedRuleIds = [RULE_IDS.actorIdMismatch, RULE_IDS.actorIdRequired];
 /**

package/dist/{outbox-listener-delivery-required-wzZRR9jI.js → outbox-listener-delivery-required-CwhiEW-i.js}

@@ -1,7 +1,7 @@
 import { always, every, head, isEmpty, isObject, negate, pipe, pipeLazy, prop, some, toArray, unless, when } from "@fxts/core";
 //#region deno.json
 var name = "@fedify/lint";
-var version = "2.5.0-dev.2541+d39a2437";
+var version = "2.5.0-dev.2568+889927c4";
 //#endregion
 //#region src/lib/const.ts
 /**
@@ -118,6 +118,16 @@ const properties = {
 		setter: "setActorDispatcher",
 		requiresIdentifier: false,
 		pluralName: "preferredUsernames"
+	},
+	url: {
+		name: "url",
+		path: ["url"],
+		setter: "setActorDispatcher",
+		requiresIdentifier: false,
+		pluralName: "urls",
+		reason: "remote fediverse software uses it as the link to the actor's profile page",
+		recommendation: "Set `url` (or the plural `urls` initializer) to the actor's human-readable profile URL.",
+		requireNonEmptyValue: true
 	}
 };
 /**
@@ -137,6 +147,7 @@ const RULE_IDS = {
 	actorPublicKeyRequired: "actor-public-key-required",
 	actorAssertionMethodRequired: "actor-assertion-method-required",
 	actorPreferredUsernameRequired: "actor-preferred-username-required",
+	actorProfileUrlRequired: "actor-profile-url-required",
 	actorIdMismatch: "actor-id-mismatch",
 	actorFollowingPropertyMismatch: "actor-following-property-mismatch",
 	actorFollowersPropertyMismatch: "actor-followers-property-mismatch",
@@ -163,15 +174,17 @@ const RULE_IDS = {
 *
 * @param name - The property name (e.g., "id", "inbox", "following")
 */
-const actorPropertyRequired = ({ setter, path, getter, requiresIdentifier = true }) => {
+const actorPropertyRequired = ({ setter, path, getter, requiresIdentifier = true, reason, recommendation: recommendationOverride }) => {
 	const propertyPath = path.join(".");
-	return `When \`${setter}\` is configured, the \`${propertyPath}\` property is recommended. ${getter == null ? `Set the \`${propertyPath}\` property directly on the actor object.` : `Use \`${getExpectedCall({
+	const defaultRecommendation = getter == null ? `Set the \`${propertyPath}\` property directly on the actor object.` : `Use \`${getExpectedCall({
 		ctxName: "Context",
 		methodName: getter,
 		idName: "identifier",
 		path: path.join("."),
 		requiresIdentifier
-	})}\` for the \`${propertyPath}\` property URI.`}`;
+	})}\` for the \`${propertyPath}\` property URI.`;
+	const recommendation = recommendationOverride ?? defaultRecommendation;
+	return `When \`${setter}\` is configured, the \`${propertyPath}\` property is recommended${reason == null ? "" : ` because ${reason}`}. ${recommendation}`;
 };
 /**
 * Generates error message for *-mismatch rules.
@@ -249,12 +262,20 @@ const isSetActorDispatcherCall = (node) => allOf(hasMemberExpressionCallee, hasI
 const hasMinParams = (min) => (fn) => fn.params.length >= min;
 //#endregion
 //#region src/lib/property-checker.ts
+const getKeyName = (node) => {
+	const key = node.key;
+	if (key.type === "Identifier" && !node.computed) return key.name;
+	if (key.type === "Literal" && typeof key.value === "string") return key.value;
+	return null;
+};
 /**
-* Checks if a node has a key with a specific name.
+* Checks if a node has a key with a specific name, whether the key is written
+* as an identifier (`url`) or as a string literal (`"url"` or `["url"]`).
+* Computed identifier keys stay dynamic and are not matched.
 */
-const hasKeyName = (propertyName) => (node) => pipe(node, prop("key"), allOf(isNodeType("Identifier"), pipeLazy(prop("name"), eq(propertyName))));
+const hasKeyName = (propertyName) => (node) => getKeyName(node) === propertyName;
 /**
-* Checks if a node is a Property with an Identifier key of a specific name.
+* Checks if a node is a Property with a specific key name.
 */
 const isPropertyWithName = (propertyName) => (node) => allOf(isNodeType("Property"), hasKeyName(propertyName))(node);
 /**
@@ -300,10 +321,26 @@ const unwrapTypeScriptExpression = (node) => {
 	}
 };
 const isNullLiteral = (node) => node.type === "Literal" && node.value === null;
+const isUndefinedExpression = (node) => node.type === "Identifier" && node.name === "undefined" || node.type === "UnaryExpression" && node.operator === "void";
 const isTombstoneExpression = (node) => node.type === "NewExpression" && node.callee.type === "Identifier" && node.callee.name === "Tombstone";
+/**
+* Checks whether a property initializer visibly carries a value.
+*
+* A `null` literal, `undefined`, `void`, or an empty array literal means
+* there is no value for rules that require a profile URL, even though the
+* property key is present.  TypeScript wrappers such as `as`, `satisfies`,
+* and non-null assertions are unwrapped first.
+*/
+const isNonEmptyInitializer = (node) => {
+	const value = node.type === "AssignmentPattern" ? node.right : node;
+	const expression = unwrapTypeScriptExpression(value);
+	if (isNullLiteral(expression) || isUndefinedExpression(expression)) return false;
+	if (expression.type === "ArrayExpression") return expression.elements.length > 0;
+	return true;
+};
 const checkBranchWith = (propertyChecker) => (branch) => {
 	const expression = unwrapTypeScriptExpression(branch);
-	if (isNullLiteral(expression) || isTombstoneExpression(expression)) return true;
+	if (isNullLiteral(expression) || isUndefinedExpression(expression) || isTombstoneExpression(expression)) return true;
 	return pipe(expression, cases(isNodeType("ConditionalExpression"), checkConditionalExpression(propertyChecker), pipeLazy(extractObjectExpression, cases(isObject, checkObjectExpression(propertyChecker), always(false)))));
 };
 /**
@@ -319,7 +356,10 @@ const extractObjectExpression = cases(isNodeType("NewExpression"), extractFirstO
 * @param propertyChecker The predicate function to check properties
 * @returns A function that checks the ReturnStatement
 */
-const checkReturnStatement = (propertyChecker) => (node) => pipe(node, prop("argument"), cases(isObject, checkBranchWith(propertyChecker), always(false)));
+const checkReturnStatement = (propertyChecker) => (node) => {
+	if (node.argument == null) return true;
+	return checkBranchWith(propertyChecker)(node.argument);
+};
 /**
 * Creates a function that recursively checks for a property in an AST node.
 * @param propertyChecker The predicate function to check properties
@@ -435,8 +475,9 @@ function createRequiredRule(config, description) {
 		const federationTracker = trackFederationVariables();
 		const dispatcherTracker = createDispatcherTracker(config.setter, federationTracker);
 		const actorDispatchers = [];
-		const propertyChecker = createPropertyChecker(Boolean)(config.path);
-		const pluralPropertyChecker = config.pluralName == null ? null : createPropertyChecker(Boolean)([...config.path.slice(0, -1), config.pluralName]);
+		const valueChecker = config.requireNonEmptyValue ? isNonEmptyInitializer : Boolean;
+		const propertyChecker = createPropertyChecker(valueChecker)(config.path);
+		const pluralPropertyChecker = config.pluralName == null ? null : createPropertyChecker(valueChecker)([...config.path.slice(0, -1), config.pluralName]);
 		const propertySearcher = createPropertySearcher(pluralPropertyChecker == null ? propertyChecker : (node) => propertyChecker(node) || pluralPropertyChecker(node));
 		return {
 			VariableDeclarator: federationTracker.VariableDeclarator,
@@ -481,7 +522,7 @@ function createRequiredRuleEslint(config) {
 	};
 }
 createRequiredRuleDeno(properties.assertionMethod);
-const eslint$29 = createRequiredRuleEslint(properties.assertionMethod);
+const eslint$30 = createRequiredRuleEslint(properties.assertionMethod);
 //#endregion
 //#region src/lib/mismatch.ts
 const isIdentifierWithName = (name) => (node) => allOf(isNodeType("Identifier"), isNodeName(name))(node);
@@ -560,39 +601,41 @@ const createMismatchRuleEslint = (config) => ({
 	}))
 });
 createMismatchRuleDeno(properties.featured);
-const eslint$28 = createMismatchRuleEslint(properties.featured);
+const eslint$29 = createMismatchRuleEslint(properties.featured);
 createRequiredRuleDeno(properties.featured);
-const eslint$27 = createRequiredRuleEslint(properties.featured);
+const eslint$28 = createRequiredRuleEslint(properties.featured);
 createMismatchRuleDeno(properties.featuredTags);
-const eslint$26 = createMismatchRuleEslint(properties.featuredTags);
+const eslint$27 = createMismatchRuleEslint(properties.featuredTags);
 createRequiredRuleDeno(properties.featuredTags);
-const eslint$25 = createRequiredRuleEslint(properties.featuredTags);
+const eslint$26 = createRequiredRuleEslint(properties.featuredTags);
 createMismatchRuleDeno(properties.followers);
-const eslint$24 = createMismatchRuleEslint(properties.followers);
+const eslint$25 = createMismatchRuleEslint(properties.followers);
 createRequiredRuleDeno(properties.followers);
-const eslint$23 = createRequiredRuleEslint(properties.followers);
+const eslint$24 = createRequiredRuleEslint(properties.followers);
 createMismatchRuleDeno(properties.following);
-const eslint$22 = createMismatchRuleEslint(properties.following);
+const eslint$23 = createMismatchRuleEslint(properties.following);
 createRequiredRuleDeno(properties.following);
-const eslint$21 = createRequiredRuleEslint(properties.following);
+const eslint$22 = createRequiredRuleEslint(properties.following);
 createMismatchRuleDeno(properties.id);
-const eslint$20 = createMismatchRuleEslint(properties.id);
+const eslint$21 = createMismatchRuleEslint(properties.id);
 createRequiredRuleDeno(properties.id);
-const eslint$19 = createRequiredRuleEslint(properties.id);
+const eslint$20 = createRequiredRuleEslint(properties.id);
 createMismatchRuleDeno(properties.inbox);
-const eslint$18 = createMismatchRuleEslint(properties.inbox);
+const eslint$19 = createMismatchRuleEslint(properties.inbox);
 createRequiredRuleDeno(properties.inbox);
-const eslint$17 = createRequiredRuleEslint(properties.inbox);
+const eslint$18 = createRequiredRuleEslint(properties.inbox);
 createMismatchRuleDeno(properties.liked);
-const eslint$16 = createMismatchRuleEslint(properties.liked);
+const eslint$17 = createMismatchRuleEslint(properties.liked);
 createRequiredRuleDeno(properties.liked);
-const eslint$15 = createRequiredRuleEslint(properties.liked);
+const eslint$16 = createRequiredRuleEslint(properties.liked);
 createMismatchRuleDeno(properties.outbox);
-const eslint$14 = createMismatchRuleEslint(properties.outbox);
+const eslint$15 = createMismatchRuleEslint(properties.outbox);
 createRequiredRuleDeno(properties.outbox);
-const eslint$13 = createRequiredRuleEslint(properties.outbox);
+const eslint$14 = createRequiredRuleEslint(properties.outbox);
 createRequiredRuleDeno(properties.preferredUsername);
-const eslint$12 = createRequiredRuleEslint(properties.preferredUsername);
+const eslint$13 = createRequiredRuleEslint(properties.preferredUsername);
+createRequiredRuleDeno(properties.url);
+const eslint$12 = createRequiredRuleEslint(properties.url);
 createRequiredRuleDeno(properties.publicKey);
 const eslint$11 = createRequiredRuleEslint(properties.publicKey);
 createMismatchRuleDeno(properties.sharedInbox);
@@ -2625,4 +2668,4 @@ const eslint = {
 	})
 };
 //#endregion
-export { eslint$29 as A, eslint$22 as C, eslint$26 as D, eslint$25 as E, name as M, version as N, eslint$27 as O, eslint$21 as S, eslint$24 as T, eslint$16 as _, eslint$4 as a, eslint$19 as b, eslint$7 as c, eslint$10 as d, eslint$11 as f, eslint$15 as g, eslint$14 as h, eslint$3 as i, RULE_IDS as j, eslint$28 as k, eslint$8 as l, eslint$13 as m, eslint$1 as n, eslint$5 as o, eslint$12 as p, eslint$2 as r, eslint$6 as s, eslint as t, eslint$9 as u, eslint$17 as v, eslint$23 as w, eslint$20 as x, eslint$18 as y };
+export { eslint$29 as A, eslint$22 as C, eslint$26 as D, eslint$25 as E, RULE_IDS as M, name as N, eslint$27 as O, version as P, eslint$21 as S, eslint$24 as T, eslint$16 as _, eslint$4 as a, eslint$19 as b, eslint$7 as c, eslint$10 as d, eslint$11 as f, eslint$15 as g, eslint$14 as h, eslint$3 as i, eslint$30 as j, eslint$28 as k, eslint$8 as l, eslint$13 as m, eslint$1 as n, eslint$5 as o, eslint$12 as p, eslint$2 as r, eslint$6 as s, eslint as t, eslint$9 as u, eslint$17 as v, eslint$23 as w, eslint$20 as x, eslint$18 as y };

package/dist/{outbox-listener-delivery-required-yvQhmuwt.cjs → outbox-listener-delivery-required-DaY8FcID.cjs}

@@ -1,7 +1,7 @@
 let _fxts_core = require("@fxts/core");
 //#region deno.json
 var name = "@fedify/lint";
-var version = "2.5.0-dev.2541+d39a2437";
+var version = "2.5.0-dev.2568+889927c4";
 //#endregion
 //#region src/lib/const.ts
 /**
@@ -118,6 +118,16 @@ const properties = {
 		setter: "setActorDispatcher",
 		requiresIdentifier: false,
 		pluralName: "preferredUsernames"
+	},
+	url: {
+		name: "url",
+		path: ["url"],
+		setter: "setActorDispatcher",
+		requiresIdentifier: false,
+		pluralName: "urls",
+		reason: "remote fediverse software uses it as the link to the actor's profile page",
+		recommendation: "Set `url` (or the plural `urls` initializer) to the actor's human-readable profile URL.",
+		requireNonEmptyValue: true
 	}
 };
 /**
@@ -137,6 +147,7 @@ const RULE_IDS = {
 	actorPublicKeyRequired: "actor-public-key-required",
 	actorAssertionMethodRequired: "actor-assertion-method-required",
 	actorPreferredUsernameRequired: "actor-preferred-username-required",
+	actorProfileUrlRequired: "actor-profile-url-required",
 	actorIdMismatch: "actor-id-mismatch",
 	actorFollowingPropertyMismatch: "actor-following-property-mismatch",
 	actorFollowersPropertyMismatch: "actor-followers-property-mismatch",
@@ -163,15 +174,17 @@ const RULE_IDS = {
 *
 * @param name - The property name (e.g., "id", "inbox", "following")
 */
-const actorPropertyRequired = ({ setter, path, getter, requiresIdentifier = true }) => {
+const actorPropertyRequired = ({ setter, path, getter, requiresIdentifier = true, reason, recommendation: recommendationOverride }) => {
 	const propertyPath = path.join(".");
-	return `When \`${setter}\` is configured, the \`${propertyPath}\` property is recommended. ${getter == null ? `Set the \`${propertyPath}\` property directly on the actor object.` : `Use \`${getExpectedCall({
+	const defaultRecommendation = getter == null ? `Set the \`${propertyPath}\` property directly on the actor object.` : `Use \`${getExpectedCall({
 		ctxName: "Context",
 		methodName: getter,
 		idName: "identifier",
 		path: path.join("."),
 		requiresIdentifier
-	})}\` for the \`${propertyPath}\` property URI.`}`;
+	})}\` for the \`${propertyPath}\` property URI.`;
+	const recommendation = recommendationOverride ?? defaultRecommendation;
+	return `When \`${setter}\` is configured, the \`${propertyPath}\` property is recommended${reason == null ? "" : ` because ${reason}`}. ${recommendation}`;
 };
 /**
 * Generates error message for *-mismatch rules.
@@ -249,12 +262,20 @@ const isSetActorDispatcherCall = (node) => allOf(hasMemberExpressionCallee, hasI
 const hasMinParams = (min) => (fn) => fn.params.length >= min;
 //#endregion
 //#region src/lib/property-checker.ts
+const getKeyName = (node) => {
+	const key = node.key;
+	if (key.type === "Identifier" && !node.computed) return key.name;
+	if (key.type === "Literal" && typeof key.value === "string") return key.value;
+	return null;
+};
 /**
-* Checks if a node has a key with a specific name.
+* Checks if a node has a key with a specific name, whether the key is written
+* as an identifier (`url`) or as a string literal (`"url"` or `["url"]`).
+* Computed identifier keys stay dynamic and are not matched.
 */
-const hasKeyName = (propertyName) => (node) => (0, _fxts_core.pipe)(node, (0, _fxts_core.prop)("key"), allOf(isNodeType("Identifier"), (0, _fxts_core.pipeLazy)((0, _fxts_core.prop)("name"), eq(propertyName))));
+const hasKeyName = (propertyName) => (node) => getKeyName(node) === propertyName;
 /**
-* Checks if a node is a Property with an Identifier key of a specific name.
+* Checks if a node is a Property with a specific key name.
 */
 const isPropertyWithName = (propertyName) => (node) => allOf(isNodeType("Property"), hasKeyName(propertyName))(node);
 /**
@@ -300,10 +321,26 @@ const unwrapTypeScriptExpression = (node) => {
 	}
 };
 const isNullLiteral = (node) => node.type === "Literal" && node.value === null;
+const isUndefinedExpression = (node) => node.type === "Identifier" && node.name === "undefined" || node.type === "UnaryExpression" && node.operator === "void";
 const isTombstoneExpression = (node) => node.type === "NewExpression" && node.callee.type === "Identifier" && node.callee.name === "Tombstone";
+/**
+* Checks whether a property initializer visibly carries a value.
+*
+* A `null` literal, `undefined`, `void`, or an empty array literal means
+* there is no value for rules that require a profile URL, even though the
+* property key is present.  TypeScript wrappers such as `as`, `satisfies`,
+* and non-null assertions are unwrapped first.
+*/
+const isNonEmptyInitializer = (node) => {
+	const value = node.type === "AssignmentPattern" ? node.right : node;
+	const expression = unwrapTypeScriptExpression(value);
+	if (isNullLiteral(expression) || isUndefinedExpression(expression)) return false;
+	if (expression.type === "ArrayExpression") return expression.elements.length > 0;
+	return true;
+};
 const checkBranchWith = (propertyChecker) => (branch) => {
 	const expression = unwrapTypeScriptExpression(branch);
-	if (isNullLiteral(expression) || isTombstoneExpression(expression)) return true;
+	if (isNullLiteral(expression) || isUndefinedExpression(expression) || isTombstoneExpression(expression)) return true;
 	return (0, _fxts_core.pipe)(expression, cases(isNodeType("ConditionalExpression"), checkConditionalExpression(propertyChecker), (0, _fxts_core.pipeLazy)(extractObjectExpression, cases(_fxts_core.isObject, checkObjectExpression(propertyChecker), (0, _fxts_core.always)(false)))));
 };
 /**
@@ -319,7 +356,10 @@ const extractObjectExpression = cases(isNodeType("NewExpression"), extractFirstO
 * @param propertyChecker The predicate function to check properties
 * @returns A function that checks the ReturnStatement
 */
-const checkReturnStatement = (propertyChecker) => (node) => (0, _fxts_core.pipe)(node, (0, _fxts_core.prop)("argument"), cases(_fxts_core.isObject, checkBranchWith(propertyChecker), (0, _fxts_core.always)(false)));
+const checkReturnStatement = (propertyChecker) => (node) => {
+	if (node.argument == null) return true;
+	return checkBranchWith(propertyChecker)(node.argument);
+};
 /**
 * Creates a function that recursively checks for a property in an AST node.
 * @param propertyChecker The predicate function to check properties
@@ -435,8 +475,9 @@ function createRequiredRule(config, description) {
 		const federationTracker = trackFederationVariables();
 		const dispatcherTracker = createDispatcherTracker(config.setter, federationTracker);
 		const actorDispatchers = [];
-		const propertyChecker = createPropertyChecker(Boolean)(config.path);
-		const pluralPropertyChecker = config.pluralName == null ? null : createPropertyChecker(Boolean)([...config.path.slice(0, -1), config.pluralName]);
+		const valueChecker = config.requireNonEmptyValue ? isNonEmptyInitializer : Boolean;
+		const propertyChecker = createPropertyChecker(valueChecker)(config.path);
+		const pluralPropertyChecker = config.pluralName == null ? null : createPropertyChecker(valueChecker)([...config.path.slice(0, -1), config.pluralName]);
 		const propertySearcher = createPropertySearcher(pluralPropertyChecker == null ? propertyChecker : (node) => propertyChecker(node) || pluralPropertyChecker(node));
 		return {
 			VariableDeclarator: federationTracker.VariableDeclarator,
@@ -481,7 +522,7 @@ function createRequiredRuleEslint(config) {
 	};
 }
 createRequiredRuleDeno(properties.assertionMethod);
-const eslint$29 = createRequiredRuleEslint(properties.assertionMethod);
+const eslint$30 = createRequiredRuleEslint(properties.assertionMethod);
 //#endregion
 //#region src/lib/mismatch.ts
 const isIdentifierWithName = (name) => (node) => allOf(isNodeType("Identifier"), isNodeName(name))(node);
@@ -560,39 +601,41 @@ const createMismatchRuleEslint = (config) => ({
 	}))
 });
 createMismatchRuleDeno(properties.featured);
-const eslint$28 = createMismatchRuleEslint(properties.featured);
+const eslint$29 = createMismatchRuleEslint(properties.featured);
 createRequiredRuleDeno(properties.featured);
-const eslint$27 = createRequiredRuleEslint(properties.featured);
+const eslint$28 = createRequiredRuleEslint(properties.featured);
 createMismatchRuleDeno(properties.featuredTags);
-const eslint$26 = createMismatchRuleEslint(properties.featuredTags);
+const eslint$27 = createMismatchRuleEslint(properties.featuredTags);
 createRequiredRuleDeno(properties.featuredTags);
-const eslint$25 = createRequiredRuleEslint(properties.featuredTags);
+const eslint$26 = createRequiredRuleEslint(properties.featuredTags);
 createMismatchRuleDeno(properties.followers);
-const eslint$24 = createMismatchRuleEslint(properties.followers);
+const eslint$25 = createMismatchRuleEslint(properties.followers);
 createRequiredRuleDeno(properties.followers);
-const eslint$23 = createRequiredRuleEslint(properties.followers);
+const eslint$24 = createRequiredRuleEslint(properties.followers);
 createMismatchRuleDeno(properties.following);
-const eslint$22 = createMismatchRuleEslint(properties.following);
+const eslint$23 = createMismatchRuleEslint(properties.following);
 createRequiredRuleDeno(properties.following);
-const eslint$21 = createRequiredRuleEslint(properties.following);
+const eslint$22 = createRequiredRuleEslint(properties.following);
 createMismatchRuleDeno(properties.id);
-const eslint$20 = createMismatchRuleEslint(properties.id);
+const eslint$21 = createMismatchRuleEslint(properties.id);
 createRequiredRuleDeno(properties.id);
-const eslint$19 = createRequiredRuleEslint(properties.id);
+const eslint$20 = createRequiredRuleEslint(properties.id);
 createMismatchRuleDeno(properties.inbox);
-const eslint$18 = createMismatchRuleEslint(properties.inbox);
+const eslint$19 = createMismatchRuleEslint(properties.inbox);
 createRequiredRuleDeno(properties.inbox);
-const eslint$17 = createRequiredRuleEslint(properties.inbox);
+const eslint$18 = createRequiredRuleEslint(properties.inbox);
 createMismatchRuleDeno(properties.liked);
-const eslint$16 = createMismatchRuleEslint(properties.liked);
+const eslint$17 = createMismatchRuleEslint(properties.liked);
 createRequiredRuleDeno(properties.liked);
-const eslint$15 = createRequiredRuleEslint(properties.liked);
+const eslint$16 = createRequiredRuleEslint(properties.liked);
 createMismatchRuleDeno(properties.outbox);
-const eslint$14 = createMismatchRuleEslint(properties.outbox);
+const eslint$15 = createMismatchRuleEslint(properties.outbox);
 createRequiredRuleDeno(properties.outbox);
-const eslint$13 = createRequiredRuleEslint(properties.outbox);
+const eslint$14 = createRequiredRuleEslint(properties.outbox);
 createRequiredRuleDeno(properties.preferredUsername);
-const eslint$12 = createRequiredRuleEslint(properties.preferredUsername);
+const eslint$13 = createRequiredRuleEslint(properties.preferredUsername);
+createRequiredRuleDeno(properties.url);
+const eslint$12 = createRequiredRuleEslint(properties.url);
 createRequiredRuleDeno(properties.publicKey);
 const eslint$11 = createRequiredRuleEslint(properties.publicKey);
 createMismatchRuleDeno(properties.sharedInbox);
@@ -2775,6 +2818,12 @@ Object.defineProperty(exports, "eslint$3", {
 		return eslint$3;
 	}
 });
+Object.defineProperty(exports, "eslint$30", {
+	enumerable: true,
+	get: function() {
+		return eslint$30;
+	}
+});
 Object.defineProperty(exports, "eslint$4", {
 	enumerable: true,
 	get: function() {

package/dist/oxlint.cjs

@@ -1,29 +1,30 @@
-const require_outbox_listener_delivery_required = require("./outbox-listener-delivery-required-yvQhmuwt.cjs");
+const require_outbox_listener_delivery_required = require("./outbox-listener-delivery-required-DaY8FcID.cjs");
 //#region src/oxlint.ts
 const rules = {
-	[require_outbox_listener_delivery_required.RULE_IDS.actorIdMismatch]: require_outbox_listener_delivery_required.eslint$20,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorIdRequired]: require_outbox_listener_delivery_required.eslint$19,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyRequired]: require_outbox_listener_delivery_required.eslint$21,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyMismatch]: require_outbox_listener_delivery_required.eslint$22,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyRequired]: require_outbox_listener_delivery_required.eslint$23,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyMismatch]: require_outbox_listener_delivery_required.eslint$24,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$13,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$14,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyRequired]: require_outbox_listener_delivery_required.eslint$15,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$16,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyRequired]: require_outbox_listener_delivery_required.eslint$27,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$28,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyRequired]: require_outbox_listener_delivery_required.eslint$25,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyMismatch]: require_outbox_listener_delivery_required.eslint$26,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$17,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$18,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorIdMismatch]: require_outbox_listener_delivery_required.eslint$21,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorIdRequired]: require_outbox_listener_delivery_required.eslint$20,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyRequired]: require_outbox_listener_delivery_required.eslint$22,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowingPropertyMismatch]: require_outbox_listener_delivery_required.eslint$23,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyRequired]: require_outbox_listener_delivery_required.eslint$24,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFollowersPropertyMismatch]: require_outbox_listener_delivery_required.eslint$25,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$14,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorOutboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$15,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyRequired]: require_outbox_listener_delivery_required.eslint$16,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorLikedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$17,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyRequired]: require_outbox_listener_delivery_required.eslint$28,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedPropertyMismatch]: require_outbox_listener_delivery_required.eslint$29,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyRequired]: require_outbox_listener_delivery_required.eslint$26,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorFeaturedTagsPropertyMismatch]: require_outbox_listener_delivery_required.eslint$27,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$18,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorInboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$19,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorSharedInboxPropertyRequired]: require_outbox_listener_delivery_required.eslint$9,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorSharedInboxPropertyMismatch]: require_outbox_listener_delivery_required.eslint$10,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorUploadMediaPropertyRequired]: require_outbox_listener_delivery_required.eslint$7,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorUploadMediaPropertyMismatch]: require_outbox_listener_delivery_required.eslint$8,
 	[require_outbox_listener_delivery_required.RULE_IDS.actorPublicKeyRequired]: require_outbox_listener_delivery_required.eslint$11,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorAssertionMethodRequired]: require_outbox_listener_delivery_required.eslint$29,
-	[require_outbox_listener_delivery_required.RULE_IDS.actorPreferredUsernameRequired]: require_outbox_listener_delivery_required.eslint$12,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorAssertionMethodRequired]: require_outbox_listener_delivery_required.eslint$30,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorPreferredUsernameRequired]: require_outbox_listener_delivery_required.eslint$13,
+	[require_outbox_listener_delivery_required.RULE_IDS.actorProfileUrlRequired]: require_outbox_listener_delivery_required.eslint$12,
 	[require_outbox_listener_delivery_required.RULE_IDS.collectionFilteringNotImplemented]: require_outbox_listener_delivery_required.eslint$6,
 	[require_outbox_listener_delivery_required.RULE_IDS.outboxListenerDeliveryRequired]: require_outbox_listener_delivery_required.eslint,
 	[require_outbox_listener_delivery_required.RULE_IDS.outboxListenerDeliveryNotAwaited]: require_outbox_listener_delivery_required.eslint$1,

package/dist/oxlint.js

@@ -1,4 +1,4 @@
-import { A as eslint$21, C as eslint$3, D as eslint$13, E as eslint$12, M as name, N as version, O as eslint$10, S as eslint$2, T as eslint$5, _ as eslint$9, a as eslint$28, b as eslint$1, c as eslint$18, d as eslint$17, f as eslint$20, g as eslint$8, h as eslint$7, i as eslint$27, j as RULE_IDS, k as eslint$11, l as eslint$19, m as eslint$6, n as eslint$25, o as eslint$29, p as eslint$22, r as eslint$26, s as eslint$23, t as eslint$24, u as eslint$16, v as eslint$14, w as eslint$4, x as eslint, y as eslint$15 } from "./outbox-listener-delivery-required-wzZRR9jI.js";
+import { A as eslint$11, C as eslint$2, D as eslint$12, E as eslint$5, M as RULE_IDS, N as name, O as eslint$13, P as version, S as eslint, T as eslint$4, _ as eslint$8, a as eslint$29, b as eslint$15, c as eslint$18, d as eslint$17, f as eslint$20, g as eslint$7, h as eslint$6, i as eslint$28, j as eslint$21, k as eslint$10, l as eslint$19, m as eslint$22, n as eslint$26, o as eslint$30, p as eslint$23, r as eslint$27, s as eslint$24, t as eslint$25, u as eslint$16, v as eslint$9, w as eslint$3, x as eslint$1, y as eslint$14 } from "./outbox-listener-delivery-required-CwhiEW-i.js";
 //#region src/oxlint.ts
 const rules = {
 	[RULE_IDS.actorIdMismatch]: eslint,
@@ -24,13 +24,14 @@ const rules = {
 	[RULE_IDS.actorPublicKeyRequired]: eslint$20,
 	[RULE_IDS.actorAssertionMethodRequired]: eslint$21,
 	[RULE_IDS.actorPreferredUsernameRequired]: eslint$22,
-	[RULE_IDS.collectionFilteringNotImplemented]: eslint$23,
-	[RULE_IDS.outboxListenerDeliveryRequired]: eslint$24,
-	[RULE_IDS.outboxListenerDeliveryNotAwaited]: eslint$25,
-	[RULE_IDS.mediaUploaderObjectUriRequired]: eslint$26,
-	[RULE_IDS.mediaUploaderAuthorizationRequired]: eslint$27,
-	[RULE_IDS.denoKvStoreDeprecated]: eslint$28,
-	[RULE_IDS.denoKvMessageQueueDeprecated]: eslint$29
+	[RULE_IDS.actorProfileUrlRequired]: eslint$23,
+	[RULE_IDS.collectionFilteringNotImplemented]: eslint$24,
+	[RULE_IDS.outboxListenerDeliveryRequired]: eslint$25,
+	[RULE_IDS.outboxListenerDeliveryNotAwaited]: eslint$26,
+	[RULE_IDS.mediaUploaderObjectUriRequired]: eslint$27,
+	[RULE_IDS.mediaUploaderAuthorizationRequired]: eslint$28,
+	[RULE_IDS.denoKvStoreDeprecated]: eslint$29,
+	[RULE_IDS.denoKvMessageQueueDeprecated]: eslint$30
 };
 const plugin = {
 	meta: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fedify/lint",
-  "version": "2.5.0-dev.2541+d39a2437",
+  "version": "2.5.0-dev.2568+889927c4",
   "description": "Fedify linting rules and plugins",
   "keywords": [
     "Fedify",
@@ -51,7 +51,7 @@
   ],
   "peerDependencies": {
     "eslint": ">=9.0.0",
-    "@fedify/fedify": "^2.5.0-dev.2541+d39a2437"
+    "@fedify/fedify": "^2.5.0-dev.2568+889927c4"
   },
   "peerDependenciesMeta": {
     "eslint": {
@@ -71,7 +71,7 @@
     "tsdown": "^0.22.0",
     "typescript": "^6.0.0",
     "@fedify/fixture": "2.0.0",
-    "@fedify/vocab": "2.5.0-dev.2541+d39a2437"
+    "@fedify/vocab": "2.5.0-dev.2568+889927c4"
   },
   "scripts": {
     "build:self": "tsdown",