Merge branch '2.x' into provides-inertia-props

Author: pascalbaljet

.github/ISSUE_TEMPLATE/0-bug-report.yml

@@ -0,0 +1,43 @@
+name: Bug Report
+description: "Submit an issue related to the Inertia Laravel adapter."
+body:
+  - type: markdown
+    attributes:
+      value: "Please read [our full contribution guide](https://laravel.com/docs/contributions#bug-reports) before submitting bug reports related to the Inertia Laravel adapter."
+  - type: input
+    attributes:
+      label: "PHP package version"
+      description: Provide the version of `inertiajs/inertia-laravel` you are using.
+      placeholder: 2.0.0
+    validations:
+      required: true
+  - type: checkboxes
+    attributes:
+      label: Inertia adapter(s) affected (if any)
+      description: Select any frontend adapters involved in this issue, if relevant.
+      options:
+        - label: React
+        - label: Vue 3
+        - label: Svelte
+        - label: Not Applicable
+  - type: textarea
+    attributes:
+      label: Backend stack
+      description: Provide details such as Laravel version, PHP version, and any relevant backend environment info.
+      placeholder: |
+        Laravel 12.x
+        PHP 8.4
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Describe the problem
+      description: Explain the behavior you're seeing that you think is a bug, and describe how you expect it to behave instead.
+    validations:
+      required: true
+  - type: textarea
+    attributes:
+      label: Steps to reproduce
+      description: Provide clear steps to reproduce the issue. Include a minimal code example that clearly shows the problem.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Feature Request
+    url: https://github.com/inertiajs/inertia/discussions/new?category=ideas
+    about: "For ideas or feature requests, start a new discussion"
+  - name: Support Questions & Other
+    url: https://github.com/inertiajs/inertia/discussions/new?category=help
+    about: "This repository is only for reporting bugs. If you have a question or need help using the library, click:"
+  - name: Documentation issue
+    url: https://github.com/inertiajs/inertiajs.com
+    about: For documentation issues, open a pull request at the inertiajs/inertiajs.com repository

.github/SECURITY.md

@@ -8,7 +8,7 @@ Only the latest major version receives security fixes.
 
 ## Reporting a Vulnerability
 
-If you discover a security vulnerability within Laravel, please send an email to Taylor Otwell at [email protected]. All security vulnerabilities will be promptly addressed.
+If you discover a security vulnerability within Inertia.js, please send an email to Taylor Otwell at [email protected]. All security vulnerabilities will be promptly addressed.
 
 ### Public PGP Key
 

CHANGELOG.md

@@ -1,9 +1,58 @@
 # Release Notes
 
-## [Unreleased](https://github.com/inertiajs/inertia-laravel/compare/v2.0.2...2.x)
+## [Unreleased](https://github.com/inertiajs/inertia-laravel/compare/v2.0.4...2.x)
 
 - Nothing!
 
+## [v2.0.4](https://github.com/inertiajs/inertia-laravel/compare/v2.0.3...v2.0.4) - 2025-07-15
+
+### What's Changed
+
+* [2.x] Ability to perform a SSR request without a bundle by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/751
+* [2.x] Added `inertia:check-ssr` Artisan command and `isHealthy()` method on `HttpGateway` by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/752
+* [2.x] Refactor `HttpGateway` by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/754
+* [2.x] Support for checking if the component exists when rendering by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/749
+* [2.x] Refactored `ssr.dispatch_without_bundle` to `ssr.ensure_bundle_exists` by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/755
+* [2.x] Restore `testing.page_paths` and `testing.page_extensions` configs by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/756
+* GitHub issue template by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/757
+* update return type in Middleware share method by [@hosmelq](https://github.com/hosmelq) in https://github.com/inertiajs/inertia-laravel/pull/758
+* Fix project name in `SECURITY.md` by [@duncanmcclean](https://github.com/duncanmcclean) in https://github.com/inertiajs/inertia-laravel/pull/759
+* [2.x] Remove old version checks by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/763
+
+### New Contributors
+
+* [@hosmelq](https://github.com/hosmelq) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/758
+* [@duncanmcclean](https://github.com/duncanmcclean) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/759
+
+**Full Changelog**: https://github.com/inertiajs/inertia-laravel/compare/v2.0.3...v2.0.4
+
+## [v2.0.3](https://github.com/inertiajs/inertia-laravel/compare/v2.0.2...v2.0.3) - 2025-06-20
+
+### What's Changed
+
+* Run tests on Ubuntu 24.04 by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/735
+* Improve URL handling with support for trailing slashes by [@ljbw](https://github.com/ljbw) in https://github.com/inertiajs/inertia-laravel/pull/731
+* [2.x] Remove old LegacyTestResponse by [@nshiro](https://github.com/nshiro) in https://github.com/inertiajs/inertia-laravel/pull/736
+* [2.x] Introduce inertiaProps Method in TestResponseMacros for Improved Inertia.js Testing by [@ashokatheheroo](https://github.com/ashokatheheroo) in https://github.com/inertiajs/inertia-laravel/pull/700
+* [2.x] Remove check for `TestResponse` from Laravel <= 6.0 by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/743
+* [2.x] Check Vite manifest before Mix manifest by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/737
+* [2.x] Remove IDE helpers by [@ycs77](https://github.com/ycs77) in https://github.com/inertiajs/inertia-laravel/pull/675
+* [2.x] Allow deepMerge on custom properties by [@mpociot](https://github.com/mpociot) in https://github.com/inertiajs/inertia-laravel/pull/732
+* [2.x] Test helper for partial requests by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/738
+* [2.x] Support for a custom URL resolver by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/739
+* [2.x] Keep only partial data in mergeProps by [@vinnygambiny](https://github.com/vinnygambiny) in https://github.com/inertiajs/inertia-laravel/pull/745
+* [2.x] Refactor `mergeStrategies` argument to `matchOn()` method by [@pascalbaljet](https://github.com/pascalbaljet) in https://github.com/inertiajs/inertia-laravel/pull/747
+
+### New Contributors
+
+* [@ljbw](https://github.com/ljbw) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/731
+* [@nshiro](https://github.com/nshiro) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/736
+* [@ashokatheheroo](https://github.com/ashokatheheroo) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/700
+* [@mpociot](https://github.com/mpociot) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/732
+* [@vinnygambiny](https://github.com/vinnygambiny) made their first contribution in https://github.com/inertiajs/inertia-laravel/pull/745
+
+**Full Changelog**: https://github.com/inertiajs/inertia-laravel/compare/v2.0.2...v2.0.3
+
 ## [v2.0.2](https://github.com/inertiajs/inertia-laravel/compare/v2.0.1...v2.0.2) - 2025-04-10
 
 ### What's Changed

README.md

@@ -4,8 +4,8 @@
   <a href="https://github.com/inertiajs/inertia-laravel/releases">
     <img src="https://img.shields.io/github/release/inertiajs/inertia-laravel.svg?style=flat-square" alt="Latest Version">
   </a>
-  <a href="https://github.com/inertiajs/inertia-laravel/actions/workflows/tests.yml?query=workflow%3Atests+branch%3Amaster">
-    <img src="https://github.com/inertiajs/inertia-laravel/actions/workflows/tests.yml/badge.svg?branch=master" alt="Build Status">
+  <a href="https://github.com/inertiajs/inertia-laravel/actions/workflows/tests.yml">
+    <img src="https://github.com/inertiajs/inertia-laravel/actions/workflows/tests.yml/badge.svg" alt="Build Status">
   </a>
   <a href="https://packagist.org/packages/inertiajs/inertia-laravel">
     <img src="https://img.shields.io/packagist/dt/inertiajs/inertia-laravel.svg?style=flat-square" alt="Total Downloads">

composer.json

@@ -34,6 +34,7 @@
         "symfony/console": "^6.2|^7.0"
     },
     "require-dev": {
+        "guzzlehttp/guzzle": "^7.2",
         "roave/security-advisories": "dev-master",
         "orchestra/testbench": "^8.0|^9.2|^10.0",
         "mockery/mockery": "^1.3.3",

config/inertia.php

@@ -25,10 +25,45 @@
 
         'url' => env('INERTIA_SSR_URL', 'http://127.0.0.1:13714'),
 
+        'ensure_bundle_exists' => (bool) env('INERTIA_SSR_ENSURE_BUNDLE_EXISTS', true),
+
         // 'bundle' => base_path('bootstrap/ssr/ssr.mjs'),
 
     ],
 
+    /*
+    |--------------------------------------------------------------------------
+    | Pages
+    |--------------------------------------------------------------------------
+    |
+    | Set `ensure_pages_exist` to true if you want to enforce that Inertia page
+    | components exist on disk when rendering a page. This is useful for
+    | catching missing or misnamed components.
+    |
+    | The `page_paths` and `page_extensions` options define where to look
+    | for page components and which file extensions to consider.
+    |
+    */
+
+    'ensure_pages_exist' => false,
+
+    'page_paths' => [
+
+        resource_path('js/Pages'),
+
+    ],
+
+    'page_extensions' => [
+
+        'js',
+        'jsx',
+        'svelte',
+        'ts',
+        'tsx',
+        'vue',
+
+    ],
+
     /*
     |--------------------------------------------------------------------------
     | Testing
@@ -39,6 +74,10 @@
     | attempts to locate the component as a file relative to any of the
     | paths AND with any of the extensions specified here.
     |
+    | Note: In a future release, the `page_paths` and `page_extensions`
+    | options below will be removed. The root-level options above
+    | will be used for both application and testing purposes.
+    |
     */
 
     'testing' => [

helpers.php

@@ -6,7 +6,7 @@
      *
      * @param  null|string  $component
      * @param  array|\Illuminate\Contracts\Support\Arrayable  $props
-     * @return \Inertia\ResponseFactory|\Inertia\Response
+     * @return ($component is null ? \Inertia\ResponseFactory : \Inertia\Response)
      */
     function inertia($component = null, $props = [])
     {

src/Commands/CheckSsr.php

@@ -0,0 +1,44 @@
+<?php
+
+namespace Inertia\Commands;
+
+use Illuminate\Console\Command;
+use Inertia\Ssr\Gateway;
+use Inertia\Ssr\HasHealthCheck;
+use Symfony\Component\Console\Attribute\AsCommand;
+
+#[AsCommand(name: 'inertia:check-ssr')]
+class CheckSsr extends Command
+{
+    /**
+     * The console command name.
+     *
+     * @var string
+     */
+    protected $signature = 'inertia:check-ssr';
+
+    /**
+     * The console command description.
+     *
+     * @var string
+     */
+    protected $description = 'Check the Inertia SSR server health status';
+
+    /**
+     * check the SSR server via a Node process.
+     */
+    public function handle(Gateway $gateway): int
+    {
+        if (! $gateway instanceof HasHealthCheck) {
+            $this->error('The SSR gateway does not support health checks.');
+
+            return self::FAILURE;
+        }
+
+        ($check = $gateway->isHealthy())
+            ? $this->info('Inertia SSR server is running.')
+            : $this->error('Inertia SSR server is not running.');
+
+        return $check ? self::SUCCESS : self::FAILURE;
+    }
+}

src/ComponentNotFoundException.php

@@ -0,0 +1,7 @@
+<?php
+
+namespace Inertia;
+
+use InvalidArgumentException;
+
+class ComponentNotFoundException extends InvalidArgumentException {}