@adonisjs/inertia 4.0.0-next.8 → 4.0.0-next.9

package/build/{chunk-GLGCE7D6.js → chunk-XXMTGYB5.js}

@@ -260,7 +260,7 @@ var Inertia = class {
     this.#shouldEncryptHistory = config.encryptHistory ?? false;
     this.#cachedVersion = this.config.assetsVersion ? String(this.config.assetsVersion) : void 0;
   }
-  #sharedState;
+  #sharedStateProviders;
   #cachedRequestInfo;
   /**
    * Optional server-side renderer for SSR functionality
@@ -342,7 +342,11 @@ var Inertia = class {
    *
    * Handles both static strings and dynamic functions for the root view.
    *
-   * @returns The resolved root view template name
+   * @example
+   * ```js
+   * const viewName = this.#resolveRootView()
+   * this.ctx.view.render(viewName, { page: pageObject })
+   * ```
    */
   #resolveRootView() {
     return typeof this.config.rootView === "function" ? this.config.rootView(this.ctx) : this.config.rootView;
@@ -351,14 +355,37 @@ var Inertia = class {
    * Constructs and serializes the page props for a given component
    *
    * Handles both full page loads and partial requests with prop filtering.
+   * Merges shared state providers with page-specific props, and handles
+   * prop cherry-picking for partial reloads based on the `only` and `except` parameters.
    *
    * @param component - The component name being rendered
    * @param requestInfo - Information about the current request
    * @param pageProps - Raw page props to be processed
-   * @returns Promise resolving to processed props object with metadata
+   *
+   * @example
+   * ```js
+   * const result = await this.#buildPageProps('Dashboard', requestInfo, {
+   *   user: { name: 'John' },
+   *   posts: defer(() => getPosts())
+   * })
+   * ```
    */
-  #buildPageProps(component, requestInfo, pageProps) {
-    const finalProps = { ...this.#sharedState, ...pageProps };
+  async #buildPageProps(component, requestInfo, pageProps) {
+    let finalProps;
+    if (this.#sharedStateProviders) {
+      const sharedState = await Promise.all(
+        this.#sharedStateProviders.map((provider) => {
+          return typeof provider === "function" ? provider() : provider;
+        })
+      ).then((resolvedSharedState) => {
+        return resolvedSharedState.reduce((result, state) => {
+          return { ...result, ...state };
+        }, {});
+      });
+      finalProps = { ...sharedState, ...pageProps };
+    } else {
+      finalProps = { ...pageProps };
+    }
     if (requestInfo.partialComponent === component) {
       const only = requestInfo.onlyProps;
       const except = requestInfo.exceptProps ?? [];
@@ -376,10 +403,18 @@ var Inertia = class {
     return buildStandardVisitProps(finalProps, this.ctx.containerResolver);
   }
   /**
-   * Handle Inertia request by setting headers and returning page object
+   * Handle Inertia AJAX request by setting appropriate headers
+   *
+   * Sets the `X-Inertia` header to 'true' indicating this is an Inertia response,
+   * then returns the page object which will be serialized as JSON.
    *
    * @param pageObject - The page object to return
-   * @returns The page object with appropriate headers set
+   *
+   * @example
+   * ```js
+   * const pageObj = await this.page('Dashboard', props)
+   * return this.#handleInertiaRequest(pageObj)
+   * ```
    */
   #handleInertiaRequest(pageObject) {
     this.ctx.response.header(InertiaHeaders.Inertia, "true");
@@ -517,7 +552,10 @@ var Inertia = class {
    * ```
    */
   share(sharedState) {
-    this.#sharedState = { ...this.#sharedState, ...sharedState };
+    if (!this.#sharedStateProviders) {
+      this.#sharedStateProviders = [];
+    }
+    this.#sharedStateProviders.push(sharedState);
     return this;
   }
   /**

package/build/factories/main.js

@@ -4,7 +4,7 @@ import {
 import {
   Inertia,
   ServerRenderer
-} from "../chunk-GLGCE7D6.js";
+} from "../chunk-XXMTGYB5.js";
 import {
   InertiaHeaders
 } from "../chunk-DISC5OYC.js";

package/build/index.js

@@ -7,7 +7,7 @@ import {
   InertiaManager,
   ServerRenderer,
   symbols_exports
-} from "./chunk-GLGCE7D6.js";
+} from "./chunk-XXMTGYB5.js";
 import {
   InertiaHeaders
 } from "./chunk-DISC5OYC.js";

package/build/providers/inertia_provider.js

@@ -1,6 +1,6 @@
 import {
   InertiaManager
-} from "../chunk-GLGCE7D6.js";
+} from "../chunk-XXMTGYB5.js";
 import "../chunk-DISC5OYC.js";
 import "../chunk-4EZ2J6OA.js";
 import "../chunk-MLKGABMK.js";

package/build/src/inertia.d.ts

@@ -3,6 +3,7 @@ import type { HttpContext } from '@adonisjs/core/http';
 import { type ServerRenderer } from './server_renderer.js';
 import type { PageProps, PageObject, AsPageProps, RequestInfo, InertiaConfig, ComponentProps, SharedProps } from './types.js';
 import { defer, merge, always, optional, deepMerge } from './props.ts';
+import { type AsyncOrSync } from '@poppinss/utils/types';
 /**
  * Main class used to interact with Inertia
  *
@@ -165,7 +166,7 @@ export declare class Inertia<Pages> {
      *   .share({ permissions: userPermissions })
      * ```
      */
-    share(sharedState: PageProps): this;
+    share(sharedState: PageProps | (() => AsyncOrSync<PageProps>)): this;
     /**
      * Build a page object with processed props and metadata
      *

package/build/src/inertia_middleware.js

@@ -1,6 +1,6 @@
 import {
   InertiaManager
-} from "../chunk-GLGCE7D6.js";
+} from "../chunk-XXMTGYB5.js";
 import {
   InertiaHeaders
 } from "../chunk-DISC5OYC.js";
@@ -65,7 +65,7 @@ var BaseInertiaMiddleware = class {
     const inertiaContainer = await ctx.containerResolver.make(InertiaManager);
     ctx.inertia = inertiaContainer.createForRequest(ctx);
     if (this.share) {
-      ctx.inertia.share(await this.share(ctx));
+      ctx.inertia.share(() => this.share(ctx));
     }
   }
   /**

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@adonisjs/inertia",
   "description": "Official Inertia.js adapter for AdonisJS",
-  "version": "4.0.0-next.8",
+  "version": "4.0.0-next.9",
   "engines": {
     "node": ">=24.0.0"
   },