@solvapay/next 1.0.0-preview.9 → 1.0.1-preview.2

package/dist/middleware.d.ts

@@ -0,0 +1,178 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { AuthAdapter } from '@solvapay/auth';
+
+/**
+ * Next.js Middleware Helpers
+ *
+ * Helpers for creating authentication middleware in Next.js.
+ * Works with any AuthAdapter implementation (Supabase, custom, etc.)
+ */
+
+/**
+ * Configuration options for authentication middleware
+ */
+interface AuthMiddlewareOptions {
+    /**
+     * Auth adapter instance to use for extracting user IDs from requests
+     * You can use SupabaseAuthAdapter, MockAuthAdapter, or create your own
+     */
+    adapter: AuthAdapter;
+    /**
+     * Public routes that don't require authentication
+     * Routes are matched using pathname.startsWith()
+     */
+    publicRoutes?: string[];
+    /**
+     * Header name to store the user ID (default: 'x-user-id')
+     */
+    userIdHeader?: string;
+}
+/**
+ * Creates a Next.js middleware function for authentication
+ *
+ * This helper:
+ * 1. Uses the provided AuthAdapter to extract userId from requests
+ * 2. Handles public vs protected routes
+ * 3. Adds userId to request headers for downstream routes
+ * 4. Returns appropriate error responses for auth failures
+ *
+ * @param options - Configuration options
+ * @returns Next.js middleware function (can be exported as `middleware` or `proxy`)
+ *
+ * @example Next.js 15
+ * ```typescript
+ * // middleware.ts (at project root)
+ * import { createAuthMiddleware } from '@solvapay/next';
+ * import { SupabaseAuthAdapter } from '@solvapay/auth/supabase';
+ *
+ * const adapter = new SupabaseAuthAdapter({
+ *   jwtSecret: process.env.SUPABASE_JWT_SECRET!,
+ * });
+ *
+ * export const middleware = createAuthMiddleware({
+ *   adapter,
+ *   publicRoutes: ['/api/list-plans'],
+ * });
+ *
+ * export const config = {
+ *   matcher: ['/api/:path*'],
+ * };
+ * ```
+ *
+ * @example Next.js 16 with src/ folder
+ * ```typescript
+ * // src/proxy.ts (in src/ folder, not project root)
+ * import { createAuthMiddleware } from '@solvapay/next';
+ * import { SupabaseAuthAdapter } from '@solvapay/auth/supabase';
+ *
+ * const adapter = new SupabaseAuthAdapter({
+ *   jwtSecret: process.env.SUPABASE_JWT_SECRET!,
+ * });
+ *
+ * // Use 'proxy' export for Next.js 16 (no deprecation warning)
+ * export const proxy = createAuthMiddleware({
+ *   adapter,
+ *   publicRoutes: ['/api/list-plans'],
+ * });
+ *
+ * export const config = {
+ *   matcher: ['/api/:path*'],
+ * };
+ * ```
+ *
+ * @example Custom adapter
+ * ```typescript
+ * import { createAuthMiddleware } from '@solvapay/next';
+ * import type { AuthAdapter } from '@solvapay/auth';
+ *
+ * const myAdapter: AuthAdapter = {
+ *   async getUserIdFromRequest(req) {
+ *     // Your custom auth logic
+ *     return userId;
+ *   },
+ * };
+ *
+ * export const middleware = createAuthMiddleware({
+ *   adapter: myAdapter,
+ * });
+ * ```
+ *
+ * **File Location Notes:**
+ * - **Next.js 15**: Place `middleware.ts` at project root
+ * - **Next.js 16 without `src/` folder**: Place `middleware.ts` or `proxy.ts` at project root
+ * - **Next.js 16 with `src/` folder**: Place `src/proxy.ts` or `src/middleware.ts` (in `src/` folder, not root)
+ *
+ * **Note:** Next.js 16 renamed "middleware" to "proxy". You can export the return value as either
+ * `middleware` or `proxy` - both work, but `proxy` is recommended to avoid deprecation warnings.
+ */
+declare function createAuthMiddleware(options: AuthMiddlewareOptions): (request: NextRequest) => Promise<NextResponse<unknown>>;
+/**
+ * Configuration options for Supabase authentication middleware
+ */
+interface SupabaseAuthMiddlewareOptions {
+    /**
+     * Supabase JWT secret (from Supabase dashboard: Settings → API → JWT Secret)
+     * If not provided, will use SUPABASE_JWT_SECRET environment variable
+     */
+    jwtSecret?: string;
+    /**
+     * Public routes that don't require authentication
+     * Routes are matched using pathname.startsWith()
+     */
+    publicRoutes?: string[];
+    /**
+     * Header name to store the user ID (default: 'x-user-id')
+     */
+    userIdHeader?: string;
+}
+/**
+ * Creates a Next.js middleware function for Supabase authentication
+ *
+ * Convenience function that creates a SupabaseAuthAdapter and wraps it with createAuthMiddleware.
+ * Only use this if you're using Supabase - otherwise use createAuthMiddleware with your own adapter.
+ *
+ * Uses dynamic import to avoid requiring Supabase as a dependency in @solvapay/next.
+ *
+ * @param options - Configuration options
+ * @returns Next.js middleware function (can be exported as `middleware` or `proxy`)
+ *
+ * @example Next.js 15
+ * ```typescript
+ * // middleware.ts (at project root)
+ * import { createSupabaseAuthMiddleware } from '@solvapay/next';
+ *
+ * export const middleware = createSupabaseAuthMiddleware({
+ *   publicRoutes: ['/api/list-plans'],
+ * });
+ *
+ * export const config = {
+ *   matcher: ['/api/:path*'],
+ * };
+ * ```
+ *
+ * @example Next.js 16 with src/ folder
+ * ```typescript
+ * // src/proxy.ts (in src/ folder, not project root)
+ * import { createSupabaseAuthMiddleware } from '@solvapay/next';
+ *
+ * // Use 'proxy' export for Next.js 16 (no deprecation warning)
+ * export const proxy = createSupabaseAuthMiddleware({
+ *   publicRoutes: ['/api/list-plans'],
+ * });
+ *
+ * export const config = {
+ *   matcher: ['/api/:path*'],
+ * };
+ * ```
+ *
+ * **File Location Notes:**
+ * - **Next.js 15**: Place `middleware.ts` at project root
+ * - **Next.js 16 without `src/` folder**: Place `middleware.ts` or `proxy.ts` at project root
+ * - **Next.js 16 with `src/` folder**: Place `src/proxy.ts` or `src/middleware.ts` (in `src/` folder, not root)
+ *
+ * **Note:** Next.js 16 renamed "middleware" to "proxy". You can export the return value as either
+ * `middleware` or `proxy` - both work, but `proxy` is recommended to avoid deprecation warnings.
+ */
+declare function createSupabaseAuthMiddleware(options?: SupabaseAuthMiddlewareOptions): (request: NextRequest) => Promise<NextResponse<unknown>>;
+
+export { type AuthMiddlewareOptions, type SupabaseAuthMiddlewareOptions, createAuthMiddleware, createSupabaseAuthMiddleware };

package/dist/middleware.js

@@ -0,0 +1,8 @@
+import {
+  createAuthMiddleware,
+  createSupabaseAuthMiddleware
+} from "./chunk-F7TBIH6W.js";
+export {
+  createAuthMiddleware,
+  createSupabaseAuthMiddleware
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solvapay/next",
-  "version": "1.0.0-preview.9",
+  "version": "1.0.1-preview.2",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -10,6 +10,11 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.js",
+      "require": "./dist/middleware.cjs"
     }
   },
   "files": [
@@ -29,24 +34,25 @@
   },
   "sideEffects": false,
   "dependencies": {
-    "@solvapay/auth": "1.0.0-preview.9",
-    "@solvapay/core": "1.0.0-preview.9",
-    "@solvapay/server": "1.0.0-preview.9"
+    "@solvapay/auth": "1.0.1-preview.2",
+    "@solvapay/core": "1.0.1-preview.2",
+    "@solvapay/server": "1.0.1-preview.2"
   },
   "peerDependencies": {
     "next": ">=13.0.0"
   },
   "devDependencies": {
-    "next": "^14.0.0",
-    "tsup": "^8.0.1",
-    "typescript": "^5.5.4",
-    "vitest": "^2.0.5",
+    "next": "^16.2.1",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.2",
     "@solvapay/test-utils": "0.0.0"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format esm,cjs --dts --tsconfig tsconfig.build.json --external next",
+    "build": "tsup src/index.ts src/middleware.ts --format esm,cjs --dts --tsconfig tsconfig.build.json --external next",
     "test": "vitest run || exit 0",
     "test:watch": "vitest",
-    "lint": "echo 'no lint yet'"
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix"
   }
 }