auth.createUser() incorrect types: cannot link provider on account creation

[brettwillis]

[REQUIRED] Step 2: Describe your environment

• Operating System version: N/A
• Firebase SDK version: 12.0.0
• Firebase Product: auth
• Node.js version: N/A
• NPM version: N/A

[REQUIRED] Step 3: Describe the problem

The types for auth.createUser() (i.e. CreateRequest) inherit from UpdateRequest and therefore inherit types for providerToLink and providersToUnlink. However these parameters are not supported (they are ignored) by the underlying POST /accounts REST API.

firebase-admin-node/src/auth/auth-config.ts

Line 234 in 910460d

export interface CreateRequest extends UpdateRequest {

This is a misrepresentation. Based on the REST API, provider credentials cannot be linked while creating an account, only on a subsequent POST /accounts:update request.

While we're at it the UpdateRequest type does not include custom claims, which is supported by the /accounts:update REST API. See #1882.