/**
 * > [!NOTE]
 * > Install using `bunx shadcn@latest add @remix-utils/middleware-session`.
 *
 * The session middleware let's you save a session object in the Router context so you can access it in any loader and ensure you're always working with the same Session instance.
 *
 * ```ts
 * import { createSessionMiddleware } from "remix-utils/middleware/session";
 * ```
 *
 * To use it, you need to create a session storage object and pass it to the middleware.
 *
 * ```ts
 * import { createCookieSessionStorage } from "react-router";
 *
 * let sessionStorage = createCookieSessionStorage({
 * 	cookie: createCookie("session", { path: "/", sameSite: "lax" }),
 * });
 *
 * let [sessionMiddleware, getSession] = createSessionMiddleware(sessionStorage);
 * ```
 *
 * Then you can use the `sessionMiddleware` in your `app/root.tsx` function.
 *
 * ```ts
 * import { sessionMiddleware } from "~/middleware/session.server";
 *
 * export const middleware: Route.MiddlewareFunction[] = [sessionMiddleware];
 * ```
 *
 * And you can use the `getSession` function in your loaders to get the session object.
 *
 * ```ts
 * import { getSession } from "~/middleware/session.server";
 *
 * export async function loader({ context }: Route.LoaderArgs) {
 * 	let session = await getSession(context);
 * 	let user = await getUser();
 * 	session.set("user", user);
 * 	return json({ user });
 * }
 * ```
 *
 * By default the middleware will automaticaly commit the session at the end of the request, but you can customize this behavior by passing a second argument to the `createSessionMiddleware` function.
 *
 * ```ts
 * let [sessionMiddleware, getSession] = createSessionMiddleware(sessionStorage, shouldCommit);
 * ```
 *
 * The `shouldCommit` function will be called at the end of the request with the previous session data and the session data before the request, if it returns `true` the session will be committed, if it returns `false` the session will be discarded.
 *
 * If you want to commit the session only if the session data changed you can use a library like `dequal` to compare the session data.
 *
 * ```ts
 * import { dequal } from "dequal";
 *
 * let [sessionMiddleware, getSession] = createSessionMiddleware(
 * 	sessionStorage,
 * 	(previous, next) => !dequal(previous, next), // Only commit if session changed
 * );
 * ```
 *
 * Or you can use a custom function to compare the session data, maybe only if some specific fields changed.
 *
 * ```ts
 * let [sessionMiddleware, getSession] = createSessionMiddleware(sessionStorage, (previous, next) => {
 * 	return current.user.id !== previous.user.id;
 * });
 * ```
 *
 * @author [Sergio Xalambrí](https://sergiodxa.com)
 * @module Middleware/Session
 */
import type { MiddlewareFunction, RouterContextProvider, Session, SessionData, SessionStorage } from "react-router";
import type { MiddlewareGetter } from "./utils.js";
/**
 * Creates a session middleware that uses the provided session storage object
 * to manage session data.
 *
 * The session middleware will read the session data from the request cookies,
 * and store it in the context for the rest of the middleware or loaders and
 * actions to use.
 *
 * After the middleware chain is done, the session data will be compared to the
 * initial data, and if it changed, the session will be commited to the storage
 * and a Set-Cookie header will be added to the response.
 *
 * This middleware also helps implement rolling sessions by setting the session
 * cookie on every response.
 *
 * @param sessionStorage The session storage object used by the middleware
 * @param shouldCommit A function that compares the previous and next session data
 * to determine if it changed and needs to be commited. Defaults to a function that always returns true.
 * @returns The session middleware and a function to get the session from the context
 *
 * @example
 * // app/middleware/session.ts
 * import { sessionStorage } from "~/session";
 * import { createSessionMiddleware } from "remix-utils";
 *
 * export const [sessionMiddleware, getSession] =
 *   createSessionMiddleware(sessionStorage);
 *
 * // app/root.tsx
 * import { sessionMiddleware } from "~/middleware/session";
 * export const middleware: Route.MiddlewareFunction[] = [sessionMiddleware];
 *
 * // app/routes/_index.tsx
 * import { getSession } from "~/middleware/session";
 *
 * export async function loader({ context }: Route.LoaderArgs) {
 *   let session = getSession(context);
 *   session.set("key", "value"); // This will be commited automatically
 *   return { data: session.get("data") };
 * }
 *
 * @example
 * // app/middleware/session.ts
 * import { createCookieSessionStorage } from "react-router";
 * import { createSessionMiddleware } from "remix-utils/middleware/session";
 *
 * export const [sessionMiddleware, getSession] =
 *   createSessionMiddleware((request, context) => {
 *   let url = new URL(request.url);
 *   let domain = url.hostname === "localhost" ? undefined : url.hostname;
 *   return createCookieSessionStorage({
 *     cookie: createCookie("session", { domain })
 *   })
 * });
 */
export declare function createSessionMiddleware<Data = SessionData, FlashData = Data>(sessionStorage: SessionStorage<Data, FlashData> | createSessionMiddleware.SessionStorageGetter<Data, FlashData>, shouldCommit?: createSessionMiddleware.ShouldCommitFunction<Data>): createSessionMiddleware.ReturnType<Data, FlashData>;
export declare namespace createSessionMiddleware {
    /**
     * A function that returns a session storage object for the given request and
     * context.
     * @param request The request object
     * @param context The router context
     * @returns A session storage object
     */
    type SessionStorageGetter<Data, FlashData> = (request: Request, context: Readonly<RouterContextProvider>) => SessionStorage<Data, FlashData>;
    /**
     * A function that compares the previous and next session data to determine
     * if it changed and needs to be committed.
     * @param prev The previous session data
     * @param next The next session data
     * @returns A boolean indicating if the session should be committed
     */
    type ShouldCommitFunction<Data> = (prev: Partial<Data>, next: Partial<Data>) => boolean;
    type ReturnType<Data, FlashData> = [
        MiddlewareFunction<Response>,
        MiddlewareGetter<Session<Data, FlashData>>
    ];
}