[Woo POS][Barcodes] Timeout a partial scan with no terminating character

[staskus]

Description

WOOMOB-765
Related Android PR: woocommerce/woocommerce-android#14255

If there's an unfinished scan, show the error row after waiting for the last inter-character timeout, not when the next character is received.

Solution

1. Add a timer in a barcode parser
2. If the inter-character timeout is triggered, show an error
3. Reset the timer if the scan is processed, canceled, or new character input is made

Steps to reproduce

Prerequisites: check the scanner settings to disable a terminating character or use an external keyboard for testing input without a terminator

1. Open POS
2. Connect a scanner with a disabled terminating character
3. Make a scan
4. Confirm the error row appears with "the scanner did not send an end-of-line character" error
5. Re-enable the terminating character
6. Confirm short barcode error, and non-existing errors continue to be shown

Testing information

Tested on iPadOS 26 with an Inateck scanner

Screenshots

ScreenRecording_07-26-2025.20-14-40_1.mov

---

• 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	pr15952-50872ac
	Version	22.9
	Bundle ID	com.automattic.alpha.woocommerce
	Commit	50872ac
	Installation URL	5qk4cqe49e0vg

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

[jaclync]

@staskus I brought the Android tablet + scanner to test i2 and don't have the iPad device for testing this PR today while working outside. Please let me know if it's urgent, and I can review the PR later today. Otherwise, I will review it tomorrow if it's still open.

[staskus]

@jaclync not urgent, good to merge by the end of the week.

[jaclync]

LGTM TIL about the barcode scanner terminating character and settings.

Tera 1200 has 5 terminator settings, I tried all of them and "None" and "Add Tab" resulted in an error while the other 3 (CR, LF, CR/LF) succeeded as expected.

scanner settings	result

[jaclync]

super nit: I think the convention in the code base before I started following it is *.versionNumber but it's really a minor detail that is internal to the code base.

Suggested change

	"pointOfSale.barcodeScan.error.incompleteScan2",
	"pointOfSale.barcodeScan.error.incompleteScan.2",

[jaclync]

nit: could there be a retain cycle between MockTimeProvider and MockTimer since they hold on to each other? Not sure if it's worth keeping one as weak var.

[staskus]

Good observation, it would create retain cycles. We can make it weak to avoid some issues in tests.

[jaclync]

super nit: the test function names feel like an interesting mix of snake & camel case 😆