Tombstone: Add remove method (#2116)

Author: pfefferle

.github/changelog/2116-from-description

@@ -0,0 +1,4 @@
+Significance: minor
+Type: added
+
+Adds support for virtual deletes and restores, allowing objects to be removed from the fediverse without being deleted locally.

includes/class-tombstone.php

@@ -207,4 +207,19 @@ public static function bury( $url ) {
 
 		\update_option( 'activitypub_tombstone_urls', $urls );
 	}
+
+	/**
+	 * Remove a URL from the local tombstone registry.
+	 *
+	 * Removes a URL from the local tombstone URL registry.
+	 * The URL is normalized before comparison to ensure consistent matching.
+	 * This marks the URL as no longer tombstoned for future local checks.
+	 *
+	 * @param string $url The URL to remove from the tombstone registry.
+	 */
+	public static function remove( $url ) {
+		$urls = \get_option( 'activitypub_tombstone_urls', array() );
+		$urls = \array_diff( $urls, array( normalize_url( $url ) ) );
+		\update_option( 'activitypub_tombstone_urls', $urls );
+	}
 }

tests/includes/class-test-tombstone.php

@@ -162,4 +162,24 @@ public function test_exists_local() {
 
 		\delete_option( 'activitypub_tombstone_urls' );
 	}
+
+	/**
+	 * Tests that the remove method removes a URL from the tombstone list,
+	 * so that exists_local returns false after removing.
+	 *
+	 * @covers ::remove
+	 */
+	public function test_remove() {
+		$url = 'https://fake.test/object/123';
+
+		Tombstone::bury( $url );
+
+		$response = Tombstone::exists_local( $url );
+		$this->assertTrue( $response );
+
+		Tombstone::remove( $url );
+
+		$response = Tombstone::exists_local( $url );
+		$this->assertFalse( $response );
+	}
 }