Fixed missing image dimensions in meta tags with non-local storage

[allouis]

ref https://linear.app/tryghost/issue/HKG-1865

• image dimension lookup in ghost_head routed any /content/images/ URL straight to storage.read(); with an S3-backed adapter (no local disk) read() threw a critical IncorrectUsageError, flooding logs on every page render and dropping social-meta image dimensions
• getImageSizeFromUrl now catches IncorrectUsageError and falls back to fetching the image over HTTP to determine dimensions
• local-disk happy path and existing error propagation (NotFoundError etc.) unchanged

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: 8ab48915-fa29-407c-91d9-2d7874a09226

📥 Commits

Reviewing files that changed from the base of the PR and between b842e8c and 9f029fd.

📒 Files selected for processing (5)

• ghost/core/core/server/adapters/storage/S3Storage.ts
• ghost/core/test/integration/adapters/storage/s3-storage.test.ts
• ghost/core/test/integration/importer/image-urls.test.js
• ghost/core/test/integration/lib/image/image-size-storage.test.ts
• ghost/core/test/unit/server/adapters/storage/s3-storage.test.ts

🚧 Files skipped from review as they are similar to previous changes (3)

• ghost/core/test/integration/adapters/storage/s3-storage.test.ts
• ghost/core/test/unit/server/adapters/storage/s3-storage.test.ts
• ghost/core/core/server/adapters/storage/S3Storage.ts

---

Walkthrough

S3Storage.read() previously always threw an IncorrectUsageError. It is replaced with a working implementation that validates options.path, constructs the S3 object key, issues a GetObjectCommand, converts the response body to a Buffer, and maps S3 not-found responses (NotFound/NoSuchKey) to a NotFoundError. Two new message constants are added for the empty-path and not-found cases. The isNotFound helper is narrowed from boolean to a TypeScript type guard. Unit tests replace the "unsupported" assertion with stubs covering the success path, 404 mapping, and missing-path validation. A new MinIO integration suite adds lifecycle-managed bucket tests covering binary safety, path mapping, error cases, and tenant-prefix isolation. Additional integration tests verify that the data importer correctly normalizes image URLs and that image-dimension resolution works when images are stored in S3.

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title clearly summarizes the main change: implementing S3 read support to fix missing image dimensions when using non-local storage adapters.
Description check	✅ Passed	The description is directly related to the changeset, explaining the problem (IncorrectUsageError with S3 storage), the solution (catching the error and falling back to HTTP), and the impact on existing functionality.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch attractor-fix-INC-300

---

_{Comment @coderabbitai help to get the list of available commands.}

[nx-cloud]

🤖 Nx Cloud AI Fix

Ensure the fix-ci command is configured to always run in your CI pipeline to get automatic fixes in future runs. For more information, please see https://nx.dev/ci/features/self-healing-ci

---

View your CI Pipeline Execution ↗ for commit 9f029fd

Command	Status	Duration	Result
nx run ghost:test:ci:legacy	✅ Succeeded	2m 59s	View ↗
nx build @tryghost/announcement-bar	✅ Succeeded	<1s	View ↗
nx build @tryghost/comments-ui	✅ Succeeded	<1s	View ↗
nx build @tryghost/activitypub	✅ Succeeded	1s	View ↗
nx build @tryghost/signup-form	✅ Succeeded	<1s	View ↗
nx build @tryghost/admin-toolbar	✅ Succeeded	<1s	View ↗
nx build @tryghost/sodo-search	✅ Succeeded	<1s	View ↗
nx build @tryghost/portal	✅ Succeeded	<1s	View ↗
Additional runs (6)	✅ Succeeded	...	View ↗

💡 Verify your cache is correct by running tasks in a sandbox. Read docs ↗

---

☁️ Nx Cloud last updated this comment at 2026-06-23 09:02:42 UTC