feat: add redirectUri option to middleware

[nicknisi]

Summary

• Add redirectUri option to authkitMiddleware() for dynamic redirect URI configuration
• Propagate redirectUri through context to getSignInUrl, getSignUpUrl, and getAuthorizationUrl
• Export AuthKitMiddlewareOptions type

Why

Closes #22. Users need to customize redirect URIs dynamically (e.g., Vercel preview deployments), matching the NextJS SDK behavior.

Notes

Priority order: explicit function param > middleware config > env var WORKOS_REDIRECT_URI

[greptile-apps]

Greptile Overview

Greptile Summary

Adds redirectUri configuration option to authkitMiddleware() enabling dynamic redirect URI customization for OAuth callbacks. This addresses the need for custom redirect URIs in dynamic environments like Vercel preview deployments.

Key Changes:

• Added redirectUri option to middleware configuration that propagates through context
• Updated getSignInUrl, getSignUpUrl, and getAuthorizationUrl to support redirect URI with proper priority: explicit parameter > middleware config > env var
• Exported AuthKitMiddlewareOptions type for public API usage
• Added comprehensive test coverage for the new functionality

Implementation Quality:

• Clean architecture following existing patterns in the codebase
• Proper TypeScript typing throughout
• Follows the same priority chain pattern as the NextJS SDK
• Well-documented with JSDoc comments and usage examples
• Backwards compatible - all parameters are optional

Confidence Score: 5/5

• This PR is safe to merge with no issues found
• The implementation is clean, well-tested, and follows established patterns. All changes are additive and backwards compatible. The priority chain (explicit param > middleware config > env var) is properly implemented with correct fallback logic using the nullish coalescing operator. Tests cover both scenarios (with and without redirectUri). No security concerns identified.
• No files require special attention

Important Files Changed

File Analysis

Filename	Score	Overview
src/server/middleware.ts	5/5	Added AuthKitMiddlewareOptions interface with optional redirectUri parameter, properly passes it to context
src/server/context.ts	5/5	Added optional redirectUri field to AuthKitServerContext interface
src/server/auth-helpers.ts	5/5	Added getRedirectUriFromContext() helper function to retrieve redirect URI from middleware context
src/server/server-functions.ts	5/5	Updated getSignInUrl, getSignUpUrl, and getAuthorizationUrl to support redirectUri parameter with proper priority fallback
src/server/index.ts	5/5	Exported AuthKitMiddlewareOptions type for public API
src/server/middleware.spec.ts	5/5	Added comprehensive test coverage for redirectUri option in middleware configuration

Sequence Diagram

sequenceDiagram
    participant User
    participant App
    participant Middleware
    participant Context
    participant ServerFn as Server Functions
    participant AuthKit as AuthKit SDK
    
    User->>App: Configure authkitMiddleware({redirectUri})
    App->>Middleware: Request with middleware config
    Middleware->>Context: Store redirectUri in context
    
    User->>ServerFn: Call getSignInUrl/getSignUpUrl/getAuthorizationUrl
    ServerFn->>Context: getRedirectUriFromContext()
    Context-->>ServerFn: Return middleware redirectUri (if set)
    
    alt Explicit redirectUri parameter provided
        ServerFn->>AuthKit: Pass explicit redirectUri
    else Middleware redirectUri available
        ServerFn->>AuthKit: Pass middleware redirectUri
    else No redirectUri specified
        ServerFn->>AuthKit: Use env var WORKOS_REDIRECT_URI
    end
    
    AuthKit-->>ServerFn: Return authorization URL
    ServerFn-->>User: Return URL with correct redirect URI

Loading

[greptile-apps]

_{6 files reviewed, no comments}

_{Edit Code Review Agent Settings | Greptile}