refactor(event-handler): mark identity field as unknown in event

Author: dreamorosi

packages/event-handler/src/types/appsync-events.ts

@@ -162,7 +162,7 @@ type RouteOptions<T extends boolean | undefined = false> = {
 // #region Events
 
 type AppSyncEventsEvent = {
-  identity: null;
+  identity: unknown;
   result: null;
   request: {
     headers: Record<string, string>;
@@ -188,6 +188,11 @@ type AppSyncEventsEvent = {
 /**
  * Event type for AppSync Events publish events.
  *
+ * The `identity` field is marked as `unknown` because it varies based on the authentication type used in AppSync.
+ * When using an API key, it will be `null`. When using IAM, it will contain the AWS credentials of the user. When using Cognito,
+ * it will contain the Cognito user pool information. When using a Lambda authorizer, it will contain the information returned
+ * by the authorizer.
+ *
  * @example
  * ```json
  * {
@@ -243,6 +248,11 @@ type AppSyncEventsPublishEvent = AppSyncEventsEvent & {
 /**
  * Event type for AppSync Events subscribe events.
  *
+ * The `identity` field is marked as `unknown` because it varies based on the authentication type used in AppSync.
+ * When using an API key, it will be `null`. When using IAM, it will contain the AWS credentials of the user. When using Cognito,
+ * it will contain the Cognito user pool information. When using a Lambda authorizer, it will contain the information returned
+ * by the authorizer.
+ *
  * @example
  * ```json
  * {