@aura-stack/next 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Auth Stack Js
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,128 @@
+<div align="center">
+  
+<h1><b>@aura-stack/next</b></h1>
+
+**Aura Auth adapter and utilities for the Next.js ecosystem**
+
+[![npm version](https://img.shields.io/npm/v/@aura-stack/next.svg)](https://www.npmjs.com/package/@aura-stack/next)
+[![JSR version](https://jsr.io/badges/@aura-stack/next)](https://jsr.io/@aura-stack/next)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+[Official Docs](https://aura-stack-auth.vercel.app/docs) · [Next.js Package Docs](https://aura-stack-auth.vercel.app/docs/packages/next)
+
+</div>
+
+## Overview
+
+`@aura-stack/next` provides a high-level, type-safe integration for **Next.js** applications using **Aura Auth**. It is designed for maximum developer experience in the App Router, offering dedicated utilities for Server Components, Server Actions, Middleware, and Route Handlers.
+
+By utilizing a **"Concentrated API"** pattern, it optimizes core authentication logic for the Next.js runtime, automatically managing context-aware data like cookies and headers via `next/headers`.
+
+## Features
+
+- **App Router Optimized** — Full support for React Server Components (RSC) and Server Actions.
+- **Concentrated API** — Dedicated `auth.api` for Next.js that automates session fetching and redirects.
+- **Aggregated Client Entry** — Consolidated `import { ... } from "@aura-stack/next/client"` for all hooks and context.
+- **Type-safe by design** — Automatic type inference from your identity schema.
+
+## Installation
+
+```bash
+pnpm add @aura-stack/next
+```
+
+> [!NOTE]
+> Ensure you have `react` (>= 19.x) installed.
+
+## Quick Start
+
+### 1. Create Auth Instance
+
+Configure your auth instance in a shared file (e.g., `lib/auth.ts`).
+
+```ts
+import { createAuth } from "@aura-stack/next"
+
+export const auth = createAuth({
+  oauth: ["github"],
+})
+
+export const { api, core } = auth
+```
+
+### 2. Set Up Route Handler
+
+Configure the catch-all route in `app/api/auth/[...auth]/route.ts`.
+
+```tsx
+import { core } from "@/lib/auth"
+
+export const { GET, POST, PATCH } = core.handlers
+```
+
+### 3. Access Session (Server-side)
+
+Use the optimized API in your Server Components.
+
+```tsx
+import { api } from "@/lib/auth"
+
+export default async function Page() {
+  const session = await api.getSession()
+
+  if (!session) return <div>Not signed in</div>
+
+  return <div>Welcome, {session.user.name}</div>
+}
+```
+
+### 4. Configure Auth Client Instance and Auth Provider
+
+Wrap your application with the `AuthProvider` and pass it a configured Aura Auth client.
+
+```tsx
+import { createAuthClient, AuthProvider } from "@aura-stack/next/client"
+import type { PropsWithChildren } from "react"
+
+const client = createAuthClient({
+  /* your config */
+})
+
+export const App = ({ children }: PropsWithChildren) => {
+  return <AuthProvider client={client}>{children}</AuthProvider>
+}
+```
+
+### 5. Client-side Implementation
+
+Use the consolidated client entry for hooks and context.
+
+```tsx
+"use client"
+import { useSession } from "@aura-stack/next/client"
+
+export function Profile() {
+  const { session, status } = useSession()
+  if (status === "loading") return <p>Loading...</p>
+
+  return (
+    <div>
+      <p>Welcome, {session.user.name}!</p>
+    </div>
+  )
+}
+```
+
+## Documentation
+
+Visit the [**official documentation website**](https://aura-stack-auth.vercel.app).
+
+## License
+
+Licensed under the [MIT License](../../LICENSE). © [Aura Stack](https://github.com/aura-stack-ts)
+
+---
+
+<p align="center">
+  Made with ❤️ by <a href="https://github.com/aura-stack-ts">Aura Stack team</a>
+</p>

package/dist/@types/index.d.ts

@@ -0,0 +1,3 @@
+import { a as NextUpdateSessionReturn, i as NextUpdateSessionOptions, n as NextSignInReturn, r as NextSignOutReturn, t as NextSignInCredentials } from "../index-B0R6c-K9.js";
+export * from "@aura-stack/react/types";
+export { NextSignInCredentials, NextSignInReturn, NextSignOutReturn, NextUpdateSessionOptions, NextUpdateSessionReturn };

package/dist/@types/index.js

@@ -0,0 +1 @@
+export{};

package/dist/_core/cookies.cjs

@@ -0,0 +1 @@
+var e=require(`@aura-stack/react/cookies`);Object.keys(e).forEach(function(t){t!==`default`&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/_core/cookies.d.ts

@@ -0,0 +1 @@
+export * from "@aura-stack/react/cookies";

package/dist/_core/cookies.js

@@ -0,0 +1 @@
+export*from"@aura-stack/react/cookies";export{};

package/dist/_core/crypto.cjs

@@ -0,0 +1 @@
+var e=require(`@aura-stack/react/crypto`);Object.keys(e).forEach(function(t){t!==`default`&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/_core/crypto.d.ts

@@ -0,0 +1 @@
+export * from "@aura-stack/react/crypto";

package/dist/_core/crypto.js

@@ -0,0 +1 @@
+export*from"@aura-stack/react/crypto";export{};

package/dist/_core/identity.cjs

@@ -0,0 +1 @@
+var e=require(`@aura-stack/react/identity`);Object.keys(e).forEach(function(t){t!==`default`&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/_core/identity.d.ts

@@ -0,0 +1 @@
+export * from "@aura-stack/react/identity";

package/dist/_core/identity.js

@@ -0,0 +1 @@
+export*from"@aura-stack/react/identity";export{};

package/dist/_core/shared.cjs

@@ -0,0 +1 @@
+var e=require(`@aura-stack/react/shared`);Object.keys(e).forEach(function(t){t!==`default`&&!Object.prototype.hasOwnProperty.call(exports,t)&&Object.defineProperty(exports,t,{enumerable:!0,get:function(){return e[t]}})});

package/dist/_core/shared.d.ts

@@ -0,0 +1 @@
+export * from "@aura-stack/react/shared";

package/dist/_core/shared.js

@@ -0,0 +1 @@
+export*from"@aura-stack/react/shared";export{};

package/dist/client.cjs

@@ -0,0 +1 @@
+"use client";Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require(`@aura-stack/react`),t=require(`@aura-stack/react/context`),n=require(`next/navigation`),r=require(`react/jsx-runtime`);const i=({client:e,children:i,initialSession:a,redirect:o})=>{let s=(0,n.useRouter)();return(0,r.jsx)(t.AuthProvider,{client:e,initialSession:a,redirect:o??(e=>s.push(e)),children:i})};exports.AuthProvider=i,Object.defineProperty(exports,`createAuthClient`,{enumerable:!0,get:function(){return e.createAuthClient}}),Object.defineProperty(exports,`useAuthActions`,{enumerable:!0,get:function(){return e.useAuthActions}}),Object.defineProperty(exports,`useSession`,{enumerable:!0,get:function(){return e.useSession}}),Object.defineProperty(exports,`useSignIn`,{enumerable:!0,get:function(){return e.useSignIn}}),Object.defineProperty(exports,`useSignInCredentials`,{enumerable:!0,get:function(){return e.useSignInCredentials}}),Object.defineProperty(exports,`useSignOut`,{enumerable:!0,get:function(){return e.useSignOut}}),Object.defineProperty(exports,`useUpdateSession`,{enumerable:!0,get:function(){return e.useUpdateSession}});

package/dist/client.d.ts

@@ -0,0 +1,24 @@
+import { AuthClientOptions, AuthProviderProps, User, createAuthClient, useAuthActions, useSession, useSignIn, useSignInCredentials, useSignOut, useUpdateSession } from "@aura-stack/react";
+import { AuthProviderProps as AuthProviderProps$1 } from "@aura-stack/react/context";
+import * as _$react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/context.d.ts
+/**
+ * Wrapper component that provides authentication context for Next.js App Router applications.
+ * Falls back to `router.push` from `next/navigation` when no custom `redirect` prop is supplied.
+ *
+ * @example
+ * const client = createAuthClient({ baseURL: "http://localhost:3000" })
+ *
+ * <AuthProvider client={client}>
+ *   <App />
+ * </AuthProvider>
+ */
+declare const AuthProvider: <DefaultUser extends User = User>({
+  client,
+  children,
+  initialSession,
+  redirect
+}: AuthProviderProps$1<DefaultUser>) => _$react_jsx_runtime0.JSX.Element;
+//#endregion
+export { type AuthClientOptions, AuthProvider, type AuthProviderProps, createAuthClient, useAuthActions, useSession, useSignIn, useSignInCredentials, useSignOut, useUpdateSession };

package/dist/client.js

@@ -0,0 +1 @@
+"use client";import{createAuthClient as e,useAuthActions as t,useSession as n,useSignIn as r,useSignInCredentials as i,useSignOut as a,useUpdateSession as o}from"@aura-stack/react";import{AuthProvider as s}from"@aura-stack/react/context";import{useRouter as c}from"next/navigation";import{jsx as l}from"react/jsx-runtime";const u=({client:e,children:t,initialSession:n,redirect:r})=>{let i=c();return l(s,{client:e,initialSession:n,redirect:r??(e=>i.push(e)),children:t})};export{u as AuthProvider,e as createAuthClient,t as useAuthActions,n as useSession,r as useSignIn,i as useSignInCredentials,a as useSignOut,o as useUpdateSession};

package/dist/core-BDwHYePg.d.ts

@@ -0,0 +1,3 @@
+import * as import__aura_stack_react_types from "@aura-stack/react/types";
+//#endregion
+export { __exportAll as n, __reExport as r, core_d_exports as t };

package/dist/index-B0R6c-K9.d.ts

@@ -0,0 +1,45 @@
+import { n as __exportAll, r as __reExport, t as core_d_exports } from "./core-BDwHYePg.js";
+import { Prettify, SignInAPIOptions, SignInAPIReturn, SignInCredentialsAPIOptions, SignInCredentialsAPIReturn, SignOutAPIOptions, SignOutAPIReturn, UpdateSessionAPIOptions, UpdateSessionAPIReturn, User } from "@aura-stack/react/types";
+
+//#region src/@types/api.d.ts
+/**
+ * Return type for the Next.js server `api.signIn` helper (see `packages/next/src/lib/api.ts`).
+ * When `Options` includes `redirect: true`, the helper calls `redirect()` and the type is `never` because execution does not continue.
+ */
+type NextSignInReturn<Options extends SignInAPIOptions> = Options extends {
+  redirect: true;
+} ? never : Options extends {
+  redirectTo: string;
+} ? never : SignInAPIReturn;
+/**
+ * Return type for the Next.js server `api.signInCredentials` helper.
+ * Same `never` rule as {@link NextSignInReturn} when a server redirect is triggered via options.
+ */
+type NextSignInCredentials<Options extends SignInCredentialsAPIOptions> = Options extends {
+  redirect: true;
+} ? never : Options extends {
+  redirectTo: string;
+} ? never : SignInCredentialsAPIReturn;
+type NextUpdateSessionOptions<DefaultUser extends User = User> = Prettify<Omit<UpdateSessionAPIOptions<DefaultUser>, "headers"> & {
+  headers?: HeadersInit;
+}>;
+/**
+ * Return type for the Next.js server `api.updateSession` helper.
+ */
+type NextUpdateSessionReturn<Options extends NextUpdateSessionOptions<DefaultUser>, DefaultUser extends User = User> = Options extends {
+  redirect: true;
+} ? never : Options extends {
+  redirectTo: string;
+} ? never : UpdateSessionAPIReturn<DefaultUser>;
+/**
+ * Return type for the Next.js server `api.signOut` helper.
+ * When `Options` includes a `redirectTo` string and the core API performs a redirect response, Next’s `redirect()` is invoked and the type is `never`.
+ */
+type NextSignOutReturn<Options extends SignOutAPIOptions> = Options extends {
+  redirectTo: string;
+} ? never : SignOutAPIReturn;
+declare namespace index_d_exports {
+  export { NextSignInCredentials, NextSignInReturn, NextSignOutReturn, NextUpdateSessionOptions, NextUpdateSessionReturn };
+}
+//#endregion
+export { NextUpdateSessionReturn as a, NextUpdateSessionOptions as i, NextSignInReturn as n, NextSignOutReturn as r, NextSignInCredentials as t };