[Woo POS] Receipts: enable feature flag with analytics

[jaclync]

Fixes WOOPRD-536

• @jaclync registers new event properties in affected events after the PR is approved

Description

This pull request enabled the local POS receipts feature flag, and added analytics for tracking receipt sneding success and failure for non-POS and POS receipts.

Analytics Plan from WOOPRD-535

1. Adding eligible_for_pos_receipt property to pos_receipt_email_success and pos_receipt_email_failed events
   For this new event property:

• If the eligibility check is not performed (e.g. receipt cannot be sent because there is no stored order as a potential case in iOS, or the first order update API request fails before the WC version check), this property is not included.
• Value is a boolean when tracked.

2. Tracking error in pos_receipt_email_failed event
   If pos_receipt_email_failed event currently does not track the error, let's also include the error details for us to understand more about the failure events. The error is tracked the same way as we track errors in other events.

Feature Flag Updates:

• Experiments/Experiments/DefaultFeatureFlagService.swift: The pointOfSaleReceipts feature flag now always returns true, enabling this feature across all build configurations.

Error Handling Enhancements:

• WooCommerce/Classes/POS/Controllers/PointOfSaleOrderController.swift: Improved error handling in the sendReceipt method by introducing a custom error (PointOfSaleOrderControllerError.noOrder) and tracking analytics for success and failure scenarios with detailed properties.
• WooCommerce/Classes/POS/Models/PointOfSaleAggregateModel.swift: Removed error tracking logic from the sendReceipt method now that the tracking is in PointOfSaleOrderController, centralizing analytics tracking within the controller logic.

Analytics Tracking Testing:

• WooCommerce/WooCommerceTests/POS/Controllers/PointOfSaleOrderControllerTests.swift: Added tests to validate analytics tracking for receipt success and failure scenarios, including cases with and without eligibility for POS receipts.
• WooCommerce/WooCommerceTests/POS/Mocks/MockReceiptService.swift: Updated the MockReceiptService to simulate success or failure scenarios using the sendReceiptResult property, enabling more robust testing of receipt handling logic.

Steps to reproduce

Store with WC version < 10.0.0 (not eligible for POS receipts)

Prerequisite: the store is eligible for POS

• Go to the Menu tab
• Enter POS
• Add item(s) to cart, then check out
• Pay with card or cash
• In the success screen, tap Email receipt
• Enter a valid email and tap to send --> pos_receipt_email_success event should have a property eligible_for_pos_receipt: false
• In the success screen, tap Email receipt again
• Turn off network to simulate network error. Enter a valid email and tap to send --> pos_receipt_email_failed event should not have a property eligible_for_pos_receipt: false (because the order sync API request fails and returns early before eligibility check) and error properties

Store with WC version >= 10.0.0 (eligible for POS receipts)

Prerequisite: the store is eligible for POS, and POS feature is enabled in WC Settings > Advanced > Features

• Go to the Menu tab
• Enter POS
• Add item(s) to cart, then check out
• Pay with card or cash
• In the success screen, tap Email receipt
• Enter a valid email and tap to send --> pos_receipt_email_success event should have a property eligible_for_pos_receipt: true
• In the success screen, tap Email receipt again
• Turn off network to simulate network error. Enter a valid email and tap to send --> pos_receipt_email_failed event should not have a property eligible_for_pos_receipt: true (because the order sync API request fails and returns early before eligibility check) and error properties

Optional - Store with WC version >= 10.0.0 with eceipt sending error

Prerequisite: the store is eligible for POS, and POS feature is enabled in WC Settings > Advanced > Features. Receipt sending fails, this can be simulated by updating the template ID to an invalid one like customer_pose_completed_order

• Go to the Menu tab
• Enter POS
• Add item(s) to cart, then check out
• Pay with card or cash
• In the success screen, tap Email receipt
• Enter a valid email and tap to send --> pos_receipt_email_failed event should have a property eligible_for_pos_receipt: true with error properties like error_description: Yosemite.POSReceiptService.POSReceiptServiceError.sendReceiptFailed(underlyingError: Dotcom Error: [rest_invalid_param] Invalid parameter(s): template_id)

Testing information

I tested all cases above on iPad Pro 11in 3rd gen iOS 18.5.

---

• I have considered if this change warrants user-facing release notes and have added them to RELEASE-NOTES.txt if necessary.

[wpmobilebot]

📲 You can test the changes from this Pull Request in WooCommerce iOS Prototype by scanning the QR code below to install the corresponding build.

	App Name	WooCommerce iOS Prototype
	Build Number	30107
	Version	PR #15674
	Bundle ID	com.automattic.alpha.woocommerce
	Commit	fc2acea
	Installation URL	7tdbl4cihhu10

Automatticians: You can use our internal self-serve MC tool to give yourself access to those builds if needed.

[jaclync]

🗒️ This allows better tracking of the underlying error in pos_receipt_email_failed event, otherwise the error just showed Yosemite.POSReceiptService.POSReceiptServiceError.sendReceiptFailed.

[iamgabrielma]

Store with WC version >= 10.0.0

@jaclync what's the best way to test WC 10+? The WC Beta tester plugin only reaches to 9.9.0-rc.1 (or you can send me access to a test store if you have one 👍 )

[jaclync]

Store with WC version >= 10.0.0

@jaclync what's the best way to test WC 10+? The WC Beta tester plugin only reaches to 9.9.0-rc.1 (or you can send me access to a test store if you have one 👍 )

Apology for forgetting to link a test site, please check out the JN site linked in the comment in WOOPRD-535.

[iamgabrielma]

✅ Store with WC version < 10.0.0
✅ Store with WC version >= 10.0.0

Works well! Tested on simulator iPad Pro M4 iOS 18.3 🚢

[iamgabrielma]

💯

[jaclync]

Just registered pos_receipt_email_success and pos_receipt_email_failed events (they weren't validated/registered before) with the properties added in this PR, merging now.