feat(cloud-functions): add realtime and callable functions token typing (#1683)

Author: CorieW

src/v1/cloud-functions.ts

@@ -104,8 +104,8 @@ export interface EventContext<Params = Record<string, string>> {
    * does not exist.
    */
   auth?: {
-    token: object;
     uid: string;
+    token: EventContextAuthToken;
   };
 
   /**
@@ -207,6 +207,29 @@ export interface EventContext<Params = Record<string, string>> {
   timestamp: string;
 }
 
+/**
+ * https://firebase.google.com/docs/reference/security/database#authtoken
+ */
+export interface EventContextAuthToken {
+  iss: string;
+  aud: string;
+  auth_time: number;
+  iat: number;
+  exp: number;
+  sub: string;
+  email?: string;
+  email_verified?: boolean;
+  phone_number?: string;
+  name?: string;
+  firebase?: {
+    identities?: {
+      [key: string]: string[];
+    };
+    sign_in_provider?: string;
+    tenant?: string;
+  };
+}
+
 /**
  * Resource is a standard format for defining a resource
  * (google.rpc.context.AttributeContext.Resource). In Cloud Functions, it is the