Skip to content

chore: fix docs deploy, patch advisories, support Laravel 13 - #167

Merged
ManukMinasyan merged 1 commit into
4.xfrom
chore/deps-and-docs-ci
Aug 19, 2026
Merged

chore: fix docs deploy, patch advisories, support Laravel 13#167
ManukMinasyan merged 1 commit into
4.xfrom
chore/deps-and-docs-ci

Conversation

@ManukMinasyan

Copy link
Copy Markdown
Contributor

Three related maintenance items on 4.x.

Docs deploy has been failing on every push

Deploy Docs has failed on every push to 4.x since #162 bumped better-sqlite3 to 13.0.3, including both fix merges today. docus@5.12.3 declares a better-sqlite3: 12.x peer, so npm ci aborts:

npm error Conflicting peer dependency: better-sqlite3@12.11.1
npm error peer better-sqlite3@"12.x" from docus@5.12.3

The docs site has not deployed since. Pinned back to ^12.11.1, the range docus supports. There is no newer docus: 5.12.3 is latest and still declares the same peer, so bumping forward was not an option.

Two open advisories in the docs lockfile

Both come from transitive deps, so they are fixed with overrides rather than direct bumps:

  • esbuild <0.28.1, arbitrary file read when running the dev server on Windows (dependabot alert build(deps): bump @nuxt/scripts from 1.3.0 to 1.3.1 in /docs #143). Pulled in by @nuxt/scripts, @nuxt/ui, @unhead/vue and vite; hoisted copy was 0.27.7, now 0.28.2.
  • sharp <0.35.0, inherited libvips CVEs (CVE-2026-33327, -33328, -35590, -35591). Reached through nuxt-og-image, which declares sharp: ^0.34.0; hoisted copy was 0.34.5, now 0.35.3.

npm audit --omit=dev went from 3 high severity vulnerabilities to 0.

Laravel 13 was never testable

Both open bug reports on this package (#156, #164) were filed against Laravel 13, which the dev constraints did not allow, so nothing verified the package there. Widened orchestra/testbench to ^10.11|^11.0 and the three Pest packages to ^4.0|^5.0, then added a Laravel 13 job to the matrix. The runtime require block is untouched: this only affects what the package can be tested against.

Verification

Locally, running exactly what CI runs:

  • npm ci in docs/ succeeds (this is the step that was failing)
  • npm run generate completes, 47 routes prerendered, build clean
  • npm audit --omit=dev: 0 vulnerabilities
  • L12 path (laravel/framework:12.* + testbench:10.*, prefer-stable): resolves L12.67 with Pest 4, 161 tests pass
  • L13 path (testbench:11.*): resolves L13.26 with Pest 5, 161 tests pass
  • vendor/bin/pint --test: passes
  • vendor/bin/phpstan analyse: 7 errors, the same seven places as before this branch (pre-existing)

Deploy Docs has failed on every push to 4.x since better-sqlite3 was bumped to
13.0.3 (#162). docus 5.12.3 declares a `better-sqlite3: 12.x` peer, so `npm ci`
died on ERESOLVE and the docs never deployed. Pinned back to ^12.11.1, which is
the range docus actually supports.

Patched the two open advisories the lockfile carried, via overrides because both
come from transitive deps:

- esbuild <0.28.1, arbitrary file read via the dev server (dependabot #143)
- sharp <0.35.0, inherited libvips CVEs (hoisted copy was 0.34.5)

`npm audit --omit=dev` now reports zero vulnerabilities, and `npm ci` plus
`npm run generate` both complete locally.

Both open issue reports on this package ran Laravel 13, which the dev
constraints did not allow. Widened testbench and Pest to accept 11.x/5.x
alongside 10.x/4.x, and added a Laravel 13 job to the test matrix. The suite
passes on both: 161 tests on L12.67 with Pest 4, and on L13.26 with Pest 5.
Copilot AI lite review requested due to automatic review settings August 19, 2026 12:51

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@ManukMinasyan
ManukMinasyan merged commit 71521ee into 4.x Aug 19, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants