@zitadel/api 0.1.0-alpha.18 → 0.1.0-alpha.19

package/src/generated/endpoints/zitadelNextGen.ts

@@ -33,19 +33,16 @@ import type {
   CreateUser201,
   CreateUserBody,
   CreateUserParams,
-  DeleteFlowDefinitionParams,
-  DeleteTeamParams,
-  DeleteUserByIDParams,
   ExchangeHandoff200,
   ExchangeHandoffBody,
   ExchangeHandoffParams,
   GetAuthAttempt200,
   GetBrandingById200,
-  GetBrandingByIdParams,
   GetClaimStatus200,
   GetClaimStatusParams,
+  GetEvent200,
+  GetEventParams,
   GetFlowDefinition200,
-  GetFlowDefinitionParams,
   GetFlowStep200,
   GetHealthDefault,
   GetLiveDefault,
@@ -56,9 +53,7 @@ import type {
   GetSchemaById200,
   GetSchemaByIdParams,
   GetSession200,
-  GetSessionParams,
   GetTeam200,
-  GetTeamParams,
   GetUserByID200,
   GetUserByIDParams,
   InitClaim201,
@@ -66,6 +61,8 @@ import type {
   IssueChallengeBody,
   ListBranding200Item,
   ListBrandingParams,
+  ListEvents200,
+  ListEventsParams,
   ListFlowDefinitions200,
   ListFlowDefinitionsParams,
   ListSchemas200Item,
@@ -86,17 +83,13 @@ import type {
   QueryTeams200,
   QueryTeamsBody,
   QueryTeamsParams,
-  RevokeSessionParams,
   SetUserPasswordBody,
-  SetUserPasswordParams,
   SubmitFlowStep200,
   SubmitFlowStepBody,
   UpdateFlowDefinition200,
   UpdateFlowDefinitionBody,
-  UpdateFlowDefinitionParams,
   UpdateTeam200,
   UpdateTeamBody,
-  UpdateTeamParams,
   VerifyChallengeProof200,
   VerifyChallengeProofBody,
 } from "../model";
@@ -207,7 +200,7 @@ export const listUsers = async (
   });
 };
 
-export const getGetUserByIDUrl = (userId: string, params: GetUserByIDParams) => {
+export const getGetUserByIDUrl = (userId: string, params?: GetUserByIDParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
@@ -228,7 +221,7 @@ export const getGetUserByIDUrl = (userId: string, params: GetUserByIDParams) =>
  */
 export const getUserByID = async (
   userId: string,
-  params: GetUserByIDParams,
+  params?: GetUserByIDParams,
   options?: RequestInit,
 ): Promise<GetUserByID200> => {
   return customFetch<GetUserByID200>(getGetUserByIDUrl(userId, params), {
@@ -237,37 +230,21 @@ export const getUserByID = async (
   });
 };
 
-export const getDeleteUserByIDUrl = (userId: string, params: DeleteUserByIDParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/users/${userId}?${stringifiedParams}`
-    : `${getProxyPath()}/users/${userId}`;
+export const getDeleteUserByIDUrl = (userId: string) => {
+  return `${getProxyPath()}/users/${userId}`;
 };
 
 /**
  * @summary Delete user by ID
  */
-export const deleteUserByID = async (
-  userId: string,
-  params: DeleteUserByIDParams,
-  options?: RequestInit,
-): Promise<void> => {
-  return customFetch<void>(getDeleteUserByIDUrl(userId, params), {
+export const deleteUserByID = async (userId: string, options?: RequestInit): Promise<void> => {
+  return customFetch<void>(getDeleteUserByIDUrl(userId), {
     ...options,
     method: "DELETE",
   });
 };
 
-export const getListUserPasskeysUrl = (userId: string, params: ListUserPasskeysParams) => {
+export const getListUserPasskeysUrl = (userId: string, params?: ListUserPasskeysParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
@@ -288,7 +265,7 @@ export const getListUserPasskeysUrl = (userId: string, params: ListUserPasskeysP
  */
 export const listUserPasskeys = async (
   userId: string,
-  params: ListUserPasskeysParams,
+  params?: ListUserPasskeysParams,
   options?: RequestInit,
 ): Promise<ListUserPasskeys200> => {
   return customFetch<ListUserPasskeys200>(getListUserPasskeysUrl(userId, params), {
@@ -297,20 +274,8 @@ export const listUserPasskeys = async (
   });
 };
 
-export const getSetUserPasswordUrl = (userId: string, params: SetUserPasswordParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/users/${userId}/password?${stringifiedParams}`
-    : `${getProxyPath()}/users/${userId}/password`;
+export const getSetUserPasswordUrl = (userId: string) => {
+  return `${getProxyPath()}/users/${userId}/password`;
 };
 
 /**
@@ -319,10 +284,9 @@ export const getSetUserPasswordUrl = (userId: string, params: SetUserPasswordPar
 export const setUserPassword = async (
   userId: string,
   setUserPasswordBody: SetUserPasswordBody,
-  params: SetUserPasswordParams,
   options?: RequestInit,
 ): Promise<void> => {
-  return customFetch<void>(getSetUserPasswordUrl(userId, params), {
+  return customFetch<void>(getSetUserPasswordUrl(userId), {
     ...options,
     method: "PUT",
     headers: { "Content-Type": "application/json", ...options?.headers },
@@ -330,7 +294,7 @@ export const setUserPassword = async (
   });
 };
 
-export const getListUserTeamsUrl = (userId: string, params: ListUserTeamsParams) => {
+export const getListUserTeamsUrl = (userId: string, params?: ListUserTeamsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
@@ -359,7 +323,7 @@ returned.
  */
 export const listUserTeams = async (
   userId: string,
-  params: ListUserTeamsParams,
+  params?: ListUserTeamsParams,
   options?: RequestInit,
 ): Promise<ListUserTeams200> => {
   return customFetch<ListUserTeams200>(getListUserTeamsUrl(userId, params), {
@@ -906,20 +870,8 @@ export const exchangeHandoff = async (
   });
 };
 
-export const getGetSessionUrl = (sessionId: string, params: GetSessionParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/sessions/${sessionId}?${stringifiedParams}`
-    : `${getProxyPath()}/sessions/${sessionId}`;
+export const getGetSessionUrl = (sessionId: string) => {
+  return `${getProxyPath()}/sessions/${sessionId}`;
 };
 
 /**
@@ -934,29 +886,16 @@ against the same `session_id`) to restore a dropped assurance level.
  */
 export const getSession = async (
   sessionId: string,
-  params: GetSessionParams,
   options?: RequestInit,
 ): Promise<GetSession200> => {
-  return customFetch<GetSession200>(getGetSessionUrl(sessionId, params), {
+  return customFetch<GetSession200>(getGetSessionUrl(sessionId), {
     ...options,
     method: "GET",
   });
 };
 
-export const getRevokeSessionUrl = (sessionId: string, params: RevokeSessionParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/sessions/${sessionId}?${stringifiedParams}`
-    : `${getProxyPath()}/sessions/${sessionId}`;
+export const getRevokeSessionUrl = (sessionId: string) => {
+  return `${getProxyPath()}/sessions/${sessionId}`;
 };
 
 /**
@@ -972,12 +911,8 @@ invalidated.
 
  * @summary Revoke session
  */
-export const revokeSession = async (
-  sessionId: string,
-  params: RevokeSessionParams,
-  options?: RequestInit,
-): Promise<void> => {
-  return customFetch<void>(getRevokeSessionUrl(sessionId, params), {
+export const revokeSession = async (sessionId: string, options?: RequestInit): Promise<void> => {
+  return customFetch<void>(getRevokeSessionUrl(sessionId), {
     ...options,
     method: "DELETE",
   });
@@ -1099,7 +1034,7 @@ export const listSchemas = async (
   });
 };
 
-export const getGetSchemaByIdUrl = (id: string, params: GetSchemaByIdParams) => {
+export const getGetSchemaByIdUrl = (id: string, params?: GetSchemaByIdParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
@@ -1121,7 +1056,7 @@ export const getGetSchemaByIdUrl = (id: string, params: GetSchemaByIdParams) =>
  */
 export const getSchemaById = async (
   id: string,
-  params: GetSchemaByIdParams,
+  params?: GetSchemaByIdParams,
   options?: RequestInit,
 ): Promise<GetSchemaById200> => {
   return customFetch<GetSchemaById200>(getGetSchemaByIdUrl(id, params), {
@@ -1187,20 +1122,8 @@ export const listFlowDefinitions = async (
   });
 };
 
-export const getGetFlowDefinitionUrl = (id: string, params: GetFlowDefinitionParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/flow_definitions/${id}?${stringifiedParams}`
-    : `${getProxyPath()}/flow_definitions/${id}`;
+export const getGetFlowDefinitionUrl = (id: string) => {
+  return `${getProxyPath()}/flow_definitions/${id}`;
 };
 
 /**
@@ -1209,29 +1132,16 @@ export const getGetFlowDefinitionUrl = (id: string, params: GetFlowDefinitionPar
  */
 export const getFlowDefinition = async (
   id: string,
-  params: GetFlowDefinitionParams,
   options?: RequestInit,
 ): Promise<GetFlowDefinition200> => {
-  return customFetch<GetFlowDefinition200>(getGetFlowDefinitionUrl(id, params), {
+  return customFetch<GetFlowDefinition200>(getGetFlowDefinitionUrl(id), {
     ...options,
     method: "GET",
   });
 };
 
-export const getUpdateFlowDefinitionUrl = (id: string, params: UpdateFlowDefinitionParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/flow_definitions/${id}?${stringifiedParams}`
-    : `${getProxyPath()}/flow_definitions/${id}`;
+export const getUpdateFlowDefinitionUrl = (id: string) => {
+  return `${getProxyPath()}/flow_definitions/${id}`;
 };
 
 /**
@@ -1243,10 +1153,9 @@ If `flow_definition.status` is omitted, the current status is preserved
 export const updateFlowDefinition = async (
   id: string,
   updateFlowDefinitionBody: UpdateFlowDefinitionBody,
-  params: UpdateFlowDefinitionParams,
   options?: RequestInit,
 ): Promise<UpdateFlowDefinition200> => {
-  return customFetch<UpdateFlowDefinition200>(getUpdateFlowDefinitionUrl(id, params), {
+  return customFetch<UpdateFlowDefinition200>(getUpdateFlowDefinitionUrl(id), {
     ...options,
     method: "PUT",
     headers: { "Content-Type": "application/json", ...options?.headers },
@@ -1254,20 +1163,8 @@ export const updateFlowDefinition = async (
   });
 };
 
-export const getDeleteFlowDefinitionUrl = (id: string, params: DeleteFlowDefinitionParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/flow_definitions/${id}?${stringifiedParams}`
-    : `${getProxyPath()}/flow_definitions/${id}`;
+export const getDeleteFlowDefinitionUrl = (id: string) => {
+  return `${getProxyPath()}/flow_definitions/${id}`;
 };
 
 /**
@@ -1277,12 +1174,8 @@ If the flow definition is the last active flow definition for a given purpose, t
 
  * @summary Delete a flow definition by id
  */
-export const deleteFlowDefinition = async (
-  id: string,
-  params: DeleteFlowDefinitionParams,
-  options?: RequestInit,
-): Promise<void> => {
-  return customFetch<void>(getDeleteFlowDefinitionUrl(id, params), {
+export const deleteFlowDefinition = async (id: string, options?: RequestInit): Promise<void> => {
+  return customFetch<void>(getDeleteFlowDefinitionUrl(id), {
     ...options,
     method: "DELETE",
   });
@@ -1338,7 +1231,6 @@ export const getQueryTeamsUrl = (params: QueryTeamsParams) => {
 
 /**
  * Returns the teams of a project, paginated with a cursor.
-Teams of every lifecycle status are returned; each carries its `status`.
 
  * @summary Query teams
  */
@@ -1355,20 +1247,8 @@ export const queryTeams = async (
   });
 };
 
-export const getGetTeamUrl = (teamId: string, params: GetTeamParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/teams/${teamId}?${stringifiedParams}`
-    : `${getProxyPath()}/teams/${teamId}`;
+export const getGetTeamUrl = (teamId: string) => {
+  return `${getProxyPath()}/teams/${teamId}`;
 };
 
 /**
@@ -1376,31 +1256,15 @@ export const getGetTeamUrl = (teamId: string, params: GetTeamParams) => {
 
  * @summary Get team
  */
-export const getTeam = async (
-  teamId: string,
-  params: GetTeamParams,
-  options?: RequestInit,
-): Promise<GetTeam200> => {
-  return customFetch<GetTeam200>(getGetTeamUrl(teamId, params), {
+export const getTeam = async (teamId: string, options?: RequestInit): Promise<GetTeam200> => {
+  return customFetch<GetTeam200>(getGetTeamUrl(teamId), {
     ...options,
     method: "GET",
   });
 };
 
-export const getDeleteTeamUrl = (teamId: string, params: DeleteTeamParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/teams/${teamId}?${stringifiedParams}`
-    : `${getProxyPath()}/teams/${teamId}`;
+export const getDeleteTeamUrl = (teamId: string) => {
+  return `${getProxyPath()}/teams/${teamId}`;
 };
 
 /**
@@ -1415,31 +1279,15 @@ or doesn't exist succeeds without changing anything.
 
  * @summary Delete team
  */
-export const deleteTeam = async (
-  teamId: string,
-  params: DeleteTeamParams,
-  options?: RequestInit,
-): Promise<void> => {
-  return customFetch<void>(getDeleteTeamUrl(teamId, params), {
+export const deleteTeam = async (teamId: string, options?: RequestInit): Promise<void> => {
+  return customFetch<void>(getDeleteTeamUrl(teamId), {
     ...options,
     method: "DELETE",
   });
 };
 
-export const getUpdateTeamUrl = (teamId: string, params: UpdateTeamParams) => {
-  const normalizedParams = new URLSearchParams();
-
-  Object.entries(params || {}).forEach(([key, value]) => {
-    if (value !== undefined) {
-      normalizedParams.append(key, value === null ? "null" : value.toString());
-    }
-  });
-
-  const stringifiedParams = normalizedParams.toString();
-
-  return stringifiedParams.length > 0
-    ? `${getProxyPath()}/teams/${teamId}?${stringifiedParams}`
-    : `${getProxyPath()}/teams/${teamId}`;
+export const getUpdateTeamUrl = (teamId: string) => {
+  return `${getProxyPath()}/teams/${teamId}`;
 };
 
 /**
@@ -1450,10 +1298,9 @@ export const getUpdateTeamUrl = (teamId: string, params: UpdateTeamParams) => {
 export const updateTeam = async (
   teamId: string,
   updateTeamBody: UpdateTeamBody,
-  params: UpdateTeamParams,
   options?: RequestInit,
 ): Promise<UpdateTeam200> => {
-  return customFetch<UpdateTeam200>(getUpdateTeamUrl(teamId, params), {
+  return customFetch<UpdateTeam200>(getUpdateTeamUrl(teamId), {
     ...options,
     method: "PATCH",
     headers: { "Content-Type": "application/json", ...options?.headers },
@@ -1538,10 +1385,37 @@ export const listBranding = async (
   });
 };
 
-export const getGetBrandingByIdUrl = (id: string, params: GetBrandingByIdParams) => {
+export const getGetBrandingByIdUrl = (id: string) => {
+  return `${getProxyPath()}/branding/${id}`;
+};
+
+/**
+ * Retrieves a single branding revision, including its stored configuration.
+ * @summary Get a branding revision by ID
+ */
+export const getBrandingById = async (
+  id: string,
+  options?: RequestInit,
+): Promise<GetBrandingById200> => {
+  return customFetch<GetBrandingById200>(getGetBrandingByIdUrl(id), {
+    ...options,
+    method: "GET",
+  });
+};
+
+export const getListEventsUrl = (params: ListEventsParams) => {
   const normalizedParams = new URLSearchParams();
 
   Object.entries(params || {}).forEach(([key, value]) => {
+    const explodeParameters = ["category", "event_type"];
+
+    if (Array.isArray(value) && explodeParameters.includes(key)) {
+      value.forEach((v) => {
+        normalizedParams.append(key, v === null ? "null" : v.toString());
+      });
+      return;
+    }
+
     if (value !== undefined) {
       normalizedParams.append(key, value === null ? "null" : value.toString());
     }
@@ -1550,20 +1424,66 @@ export const getGetBrandingByIdUrl = (id: string, params: GetBrandingByIdParams)
   const stringifiedParams = normalizedParams.toString();
 
   return stringifiedParams.length > 0
-    ? `${getProxyPath()}/branding/${id}?${stringifiedParams}`
-    : `${getProxyPath()}/branding/${id}`;
+    ? `${getProxyPath()}/events?${stringifiedParams}`
+    : `${getProxyPath()}/events`;
 };
 
 /**
- * Retrieves a single branding revision, including its stored configuration.
- * @summary Get a branding revision by ID
+ * Returns project-scoped audit events, newest-first by keyset on
+`(created_at, id)` (ADR 027 / ADR 049). Pass `order=asc` for oldest-first.
+Requires `events.read`.
+
+Pre-claim projects return an empty list (events are stored but not
+visible until claim succeeds). Team-scoped credentials see only events
+whose emit-time `team_id` matches the credential team (enforced when
+team-scoped tokens exist).
+
+Clients discriminate each item via `event_type` (OpenAPI Event oneOf) —
+see docs/design/api/events-catalog.md.
+
+ * @summary List events
  */
-export const getBrandingById = async (
+export const listEvents = async (
+  params: ListEventsParams,
+  options?: RequestInit,
+): Promise<ListEvents200> => {
+  return customFetch<ListEvents200>(getListEventsUrl(params), {
+    ...options,
+    method: "GET",
+  });
+};
+
+export const getGetEventUrl = (id: string, params: GetEventParams) => {
+  const normalizedParams = new URLSearchParams();
+
+  Object.entries(params || {}).forEach(([key, value]) => {
+    if (value !== undefined) {
+      normalizedParams.append(key, value === null ? "null" : value.toString());
+    }
+  });
+
+  const stringifiedParams = normalizedParams.toString();
+
+  return stringifiedParams.length > 0
+    ? `${getProxyPath()}/events/${id}?${stringifiedParams}`
+    : `${getProxyPath()}/events/${id}`;
+};
+
+/**
+ * Loads a single event by `(project_id, id)`. Requires `events.read`.
+Events are not registered in `resource_scope_index`; project scope is
+required on the query (ADR 049). Misses and cross-project ids return 404.
+
+Pre-claim projects return 404 (stored events stay invisible until claim).
+
+ * @summary Get event by ID
+ */
+export const getEvent = async (
   id: string,
-  params: GetBrandingByIdParams,
+  params: GetEventParams,
   options?: RequestInit,
-): Promise<GetBrandingById200> => {
-  return customFetch<GetBrandingById200>(getGetBrandingByIdUrl(id, params), {
+): Promise<GetEvent200> => {
+  return customFetch<GetEvent200>(getGetEventUrl(id, params), {
     ...options,
     method: "GET",
   });