feat(LCAM-1282): central-user test metadata, GRR URL guard, build grouping identifier (v8)

[ashish0305]

What is this about?

Adds central-user test-metadata support to the BrowserStack WebdriverIO service on the v8 line, ported from ashish0305/webdriveriolc#1 into this extracted standalone repo (packages/browserstack-service/src).

• New BrowserStackSDK.setTestMetadata({ identifier, ... }) public API backed by a per-test-run TestMetadata store, gated on the app_lcnc central user (BROWSERSTACK_CENTRAL_USER). Metadata is attached to the TestFramework gRPC event and the reporter's BTCER payload.
• getCentralUser() central-user mode; its keys are merged into the TestHub product maps.
• APIUtils.updateURLSForGRR validates the GRR URL set via a hasValidGRRUrls type guard and no-ops (returns false) when incomplete — prevents the TypeError → prod-collector fallback.
• Sends grouping_identifier (BROWSERSTACK_BUILD_GROUPING_IDENTIFIER) on build launch.
• Forces result = 'skipped' for TestRunSkipped (mocha sets state = 'pending').

Verified locally on v8: npm run build passes and the full test suite is green (42/42 files). Supersedes the accidentally main-based PR #72.

Related Jira task/s

LCAM-1282 — App LCA SDK integration (WebdriverIO service, v8). Port of ashish0305/webdriveriolc#1.

Release (mandatory for every PR — required for the ready-for-review label)

Version bump: (required — tick exactly one)

• minor (backwards-compatible feature)
• patch (bug fix or other small change)

Release notes type: (optional)

• New Feature
• Bug Fix
• Other Improvement

Release notes (customer-facing): (optional but encouraged)

• Added support for attaching custom test metadata to test runs via BrowserStackSDK.setTestMetadata() for central-user integrations.

Release notes (internal): (required — engineer-facing; what actually changed / why)

• Port of support of setting metadata ashish0305/webdriveriolc#1 onto the v8 line of packages/browserstack-service: central-user (app_lcnc) test-metadata store + BrowserStackSDK.setTestMetadata(), central-user keys in the TestHub product maps, hasValidGRRUrls guard on updateURLSForGRR, grouping_identifier on build launch, and TestRunSkipped → result='skipped'.
• Updated testHub/utils, funnelInstrumentation, and testHubModule specs for the new app_lcnc product-map key / onBeforeTest instance arg.

Checklist

• Ready to review
• Has it been tested locally?

PR Validations

Run Tests: Comment RUN_TESTS to trigger sanity tests.

🤖 Generated with Claude Code