feat(integrations): add subscription and donation metadata

[chickenn00dle]

Summary

• Implements get_metadata() for the Subscription contact metadata class with 13 get methods covering subscriber status, active count, dates, billing cycle, payments, product names, coupon codes, and cancellation reasons — all filtered to non-donation subscriptions only.
• Implements get_metadata() for the Donation class by extending Subscription, inverting the filter to donation-only, and adding donor status labels (Monthly/Yearly/Ex-* Donor), one-time donation fallbacks, and previous donation amount tracking.

Closes NPPD-1388

Test plan

1. Enabled the following in wp-config.php:

define( 'NEWSPACK_LOG_LEVEL', 3 );
define( `NEWSPACK_SYNC_METADATA_VERSION`, '1.0' );
define( 'NEWSPACK_INTEGRATIONS_SETTINGS_ENABLED', true );

2. Navigate to Audience > Integrations > ESP and confirm the donation and subscription fields listed in the linear task are available in the outgoing metadata section
3. Check them all and save, confirming they persist on reload
4. As a new reader, register to the site
5. Check the logs and verify the contact is synced with the relevant metadata in a default empty state (note you can also just check the connected ESP, however you may run into issues with merge field limits depending on the ESP):
   
6. As the same reader, purchase a one-time donation
7. Check the logs for another sync entry, this time with the donation status, product name, amount, and date populated
8. As the same reader, purchase a recurring donation
9. Check the logs for another sync entry, this time with all relevant donation fields populated (only end date and previous product/amount should be empty)
10. As the reader, purchase a non-donation subscription product
11. Check the logs for another sync entry, this time with all the relevant subscription fields populated (only end date, cancellation reason, and previous product fields should be empty)
12. Now cancel the subscription (either as the reader or manually as the admin)
13. Check the logs for another sync entry, this time the subscription status, count, end date, and reason should be populated
14. Finally, cancel the recurring donation
15. Check the logs for another sync entry, this time the donation status, count, and end date should be populated

🤖 Generated with Claude Code

[Copilot]

Pull request overview

Adds Reader Activation contact metadata for WooCommerce Subscriptions and Donations so ESP syncs can include richer subscription/donation lifecycle fields.

Changes:

• Implemented Subscription::get_metadata() with 13 subscription-related fields (status, counts, dates, billing, product, coupon, last payment, cancellation reason).
• Implemented Donation::get_metadata() by extending Subscription, filtering to donation-only, and adding donor status + one-time donation fallbacks and previous amount tracking.
• Added unit tests + expanded WooCommerce test mocks; added a shared date formatter in the Contact_Metadata base class and extra sync logging.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
tests/unit-tests/reader-activation-sync/class-test-subscription-metadata.php	New unit tests covering Subscription metadata fields and edge cases.
tests/unit-tests/reader-activation-sync/class-test-donation-metadata.php	New unit tests covering Donation metadata fields, donor labels, and switch/previous amount logic.
tests/mocks/wc-mocks.php	Extends WC mocks to support new metadata logic (products/items, coupons, related orders, order lookup).
includes/reader-activation/sync/contact-metadata/class-subscription.php	Implements Subscription metadata retrieval with caching and helpers.
includes/reader-activation/sync/contact-metadata/class-donation.php	Implements Donation metadata by reusing Subscription helpers + donation-specific fallbacks.
includes/reader-activation/sync/class-contact-sync.php	Adds additional logging around contact sync calls.
includes/reader-activation/sync/class-contact-metadata.php	Adds a shared date format constant and formatter helper.

Comments suppressed due to low confidence (1)

tests/mocks/wc-mocks.php:318

• The mock WC_Subscription::get_date() only accepts one parameter, but production WC_Subscription::get_date() is commonly called with a timezone/context argument (e.g., get_date('start','site')). The new Subscription metadata code passes a second argument, which can trigger warnings/errors in tests on newer PHP versions; update the mock signature to accept an optional second parameter (and ignore it).

	public function get_date( $type ) {
		return $this->data['dates'][ $type ] ?? 0;
	}

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Comments suppressed due to low confidence (1)

tests/mocks/wc-mocks.php:318

• WC_Subscription::get_date() in this test mock only accepts one argument, but the new metadata code calls $subscription->get_date( ..., 'site' ) (matching the real WooCommerce Subscriptions signature). In PHP 8 this will throw an ArgumentCountError in unit tests. Update the mock method signature to accept the optional timezone/context parameter (or use variadic args) and ignore it as needed so tests exercise the production call shape.

	public function get_date( $type ) {
		return $this->data['dates'][ $type ] ?? 0;
	}

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.