@golocalinteractive/golocal-cloud-wrapper 1.0.14 → 1.0.15

package/README.md

@@ -1,6 +1,6 @@
 # Go Local Interactive Cloud Wrapper
 
-A React provider component for Go Local Interactive's cloud services with built-in styling.
+A React provider component for Go Local Interactive's cloud services with built-in styling and authentication middleware.
 
 ## Installation
 
@@ -26,6 +26,75 @@ function App() {
 }
 ```
 
+### Authentication Setup
+
+This package includes Auth0 authentication utilities and middleware helpers. To set up authentication in your Next.js app:
+
+#### 1. Environment Variables
+
+Add these to your `.env.local`:
+
+```env
+AUTH0_SECRET='use [openssl rand -hex 32] to generate a 32 bytes value'
+AUTH0_BASE_URL='http://localhost:3000'
+AUTH0_ISSUER_BASE_URL='https://YOUR_DOMAIN'
+AUTH0_CLIENT_ID='your_client_id'
+AUTH0_CLIENT_SECRET='your_client_secret'
+AUTH0_AUDIENCE='your_audience'
+```
+
+#### 2. Middleware Setup
+
+Create a `middleware.ts` file in your project root:
+
+```typescript
+import {
+  handleAuthMiddleware,
+  authMiddlewareMatcher,
+} from "@golocalinteractive/golocal-cloud-wrapper";
+
+export async function middleware(request: NextRequest) {
+  return handleAuthMiddleware(request);
+}
+
+export const config = {
+  matcher: authMiddlewareMatcher,
+};
+```
+
+#### 3. Auth API Routes
+
+Create `app/api/auth/[auth0]/route.ts`:
+
+```typescript
+import { handleAuth } from "@auth0/nextjs-auth0";
+
+export const GET = handleAuth;
+```
+
+#### 4. Login/Logout Links
+
+```jsx
+import { useUser } from "@auth0/nextjs-auth0/client";
+
+function AuthButtons() {
+  const { user, isLoading } = useUser();
+
+  if (isLoading) return <div>Loading...</div>;
+
+  if (user) {
+    return (
+      <div>
+        <span>Welcome {user.name}!</span>
+        <a href="/api/auth/logout">Logout</a>
+      </div>
+    );
+  }
+
+  return <a href="/api/auth/login">Login</a>;
+}
+```
+
 ### Manual CSS Import (Alternative)
 
 If you prefer to manually control CSS imports, you can import the styles separately: