@mcp-z/oauth-microsoft
    Preparing search index...

    Class DcrOAuthProvider

    DCR Provider - Stateless OAuth provider for Dynamic Client Registration

    Unlike LoopbackOAuthProvider which manages token storage, DcrOAuthProvider is stateless:

    • Receives provider tokens from verification context (HTTP bearer auth)
    • Creates auth providers on-demand from tokens
    • Handles token refresh using Microsoft OAuth
    • No token storage dependency

    Pattern:

    const provider = new DcrOAuthProvider(config);
    const auth = provider.toAuthProvider(providerTokens);
    const accessToken = await auth.getAccessToken();
    Index
    • Auth middleware for HTTP servers with DCR bearer auth Validates bearer tokens and enriches extra with provider tokens

      Pattern:

      const provider = new DcrOAuthProvider({ ..., verifyEndpoint: 'http://localhost:3000/oauth/verify' });
      const middleware = provider.authMiddleware();
      const tools = toolFactories.map(f => f()).map(middleware.withToolAuth);
      const resources = resourceFactories.map(f => f()).map(middleware.withResourceAuth);
      const prompts = promptFactories.map(f => f()).map(middleware.withPromptAuth);

      Returns {
          withPromptAuth: <
              T extends { config: unknown; handler: unknown; name: string },
          >(
              module: T,
          ) => T;
          withResourceAuth: <
              T extends
                  {
                      config?: unknown;
                      handler: unknown;
                      name: string;
                      template?: unknown;
                  },
          >(
              module: T,
          ) => T;
          withToolAuth: <
              T extends { config: unknown; handler: unknown; name: string },
          >(
              module: T,
          ) => T;
      }

    • Get user email from Microsoft Graph API (with caching)

      Parameters

      • tokens: ProviderTokens

        Provider tokens to use for API call

      Returns Promise<string>

      User's email address

    • Refresh Microsoft access token using refresh token

      Parameters

      • refreshToken: string

        Microsoft refresh token

      Returns Promise<ProviderTokens>

      New provider tokens

    • Create Microsoft Graph auth provider from provider tokens

      This is the core stateless pattern - provider receives tokens from context (token verification, HTTP request) and creates auth provider on-demand.

      Parameters

      • tokens: ProviderTokens

        Provider tokens (Microsoft access/refresh tokens)

      Returns MicrosoftAuthProvider

      Microsoft Graph-compatible auth provider