Blueprints: Improve error handling for deeplink failures

[ivan-ottinger]

Related issues

• Resolves STU-1209

Proposed Changes

• add user-friendly error messages when Blueprint deeplink open fails
• add related tests

Before	After

Testing Instructions

1. Check out the PR branch and build the app with npm install && npm start.
2. Try opening first two broken Blueprint deeplinks at https://jsbin.com/kulaqijega/1/edit?html,css,output or try these:

## "Please check the link and try again." (non-network errors)

# Invalid base64 JSON (parse failure)
wp-studio://add-site?blueprint=bm90LXZhbGlkLWpzb24=

# Invalid blueprint URL (malformed URL)
wp-studio://add-site?blueprint_url=not-a-url

# Valid JSON but invalid blueprint schema
wp-studio://add-site?blueprint=eyJmb28iOiJiYXIifQ==

## "Could not connect to the server..." (network error)

# Non-existent host (ENOTFOUND)
wp-studio://add-site?blueprint_url=https%3A%2F%2Fthis-domain-does-not-exist-xyz123.example%2Fblueprint.json

3. Both should open an user-friendly error message with option to see the exact error message in the Studio app logs.

Pre-merge Checklist

• Have you checked for TypeScript, React or other console errors?

[epeicher]

Thanks @ivan-ottinger for improving this! I have tested it, and I can see the new error messages.

Although I'm not sure I like the double Failed to load Blueprint and then The Blueprint could not be loaded. and not displaying the returned error message. I would be interested in others' views on those

Network Error	Invalid Blueprint error

[katinthehatsite]

Although I'm not sure I like the double Failed to load Blueprint and then The Blueprint could not be loaded. and not displaying the returned error message. I would be interested in others' views on those

I agree with this assessment, although I think we don't necessarily need the exact error message in this window as as it will be in the logs as well. We should definitely adjust the repetitive wording though.

[wpmobilebot]

📊 Performance Test Results

Comparing 2ddee34 vs trunk

site-editor

Metric	trunk	2ddee34	Diff	Change
load	2844.00 ms	2844.00 ms	0.00 ms	⚪ 0.0%

site-startup

Metric	trunk	2ddee34	Diff	Change
siteCreation	8065.00 ms	7076.00 ms	-989.00 ms	🟢 -12.3%
siteStartup	3919.00 ms	3926.00 ms	+7.00 ms	🔴 0.2%

---

Results are median values from multiple test runs.

Legend: 🟢 Improvement (faster) | 🔴 Regression (slower) | ⚪ No change

[ivan-ottinger]

Thank you for your reviews, Kat & Roberto! I agree the message seemed redundant and have removed it in 4a205f0.

---

jsbin.com with the test links is down at the moment so I have added some more test links directly to the PR description (in case you would like to test the PR again). 🙂