@alienplatform/platform-api 1.3.5 → 1.4.1

package/src/models/operations/getworkspaceplan.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import * as models from "../index.js";
+
+export type GetWorkspacePlanRequest = {
+  /**
+   * Workspace name. Defaults to your last workspace (user auth) or your API key's workspace (token auth). When using an API key, if provided, must match the key's workspace.
+   */
+  workspace?: string | undefined;
+};
+
+/**
+ * Active plan id.
+ */
+export type GetWorkspacePlanResponse = {
+  planId: models.PlanId;
+};
+
+/** @internal */
+export type GetWorkspacePlanRequest$Outbound = {
+  workspace?: string | undefined;
+};
+
+/** @internal */
+export const GetWorkspacePlanRequest$outboundSchema: z.ZodType<
+  GetWorkspacePlanRequest$Outbound,
+  GetWorkspacePlanRequest
+> = z.object({
+  workspace: z.string().optional(),
+});
+
+export function getWorkspacePlanRequestToJSON(
+  getWorkspacePlanRequest: GetWorkspacePlanRequest,
+): string {
+  return JSON.stringify(
+    GetWorkspacePlanRequest$outboundSchema.parse(getWorkspacePlanRequest),
+  );
+}
+
+/** @internal */
+export const GetWorkspacePlanResponse$inboundSchema: z.ZodType<
+  GetWorkspacePlanResponse,
+  unknown
+> = z.object({
+  planId: models.PlanId$inboundSchema,
+});
+
+export function getWorkspacePlanResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetWorkspacePlanResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetWorkspacePlanResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetWorkspacePlanResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -2,9 +2,10 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+export * from "./acceptcloudformationcallback.js";
 export * from "./addworkspacemember.js";
+export * from "./cancelmanagersetup.js";
 export * from "./cancelpackage.js";
-export * from "./connectmanagertogooglecloud.js";
 export * from "./createapikey.js";
 export * from "./createcommand.js";
 export * from "./createdeployment.js";
@@ -24,19 +25,14 @@ export * from "./deletedomain.js";
 export * from "./deletemanager.js";
 export * from "./deleteproject.js";
 export * from "./deleteworkspace.js";
-export * from "./generatedeepstoretoken.js";
+export * from "./dismissworkspaceonboarding.js";
+export * from "./generatemanagertoken.js";
 export * from "./getapikey.js";
+export * from "./getcloudregions.js";
 export * from "./getcommand.js";
-export * from "./getcontainerattention.js";
-export * from "./getcontainerdefinitiondeployments.js";
-export * from "./getcontainermachines.js";
-export * from "./getcontaineroverview.js";
 export * from "./getdeployment.js";
-export * from "./getdeploymentcluster.js";
 export * from "./getdeploymentconnectioninfo.js";
-export * from "./getdeploymentcontainer.js";
 export * from "./getdeploymentgroup.js";
-export * from "./getdeploymentgroupmanager.js";
 export * from "./getdeploymentinfo.js";
 export * from "./getdeploymentstats.js";
 export * from "./getdomain.js";
@@ -47,22 +43,22 @@ export * from "./getmanagermanagementconfig.js";
 export * from "./getpackage.js";
 export * from "./getproject.js";
 export * from "./getprojectactiverelease.js";
-export * from "./getprojectbuildconfig.js";
+export * from "./getprojectdeploymentportaldomain.js";
+export * from "./getprojectgcpoauthprovider.js";
 export * from "./getprojecttemplateurls.js";
 export * from "./getrelease.js";
+export * from "./getresourcedeploymentdetail.js";
 export * from "./getworkspace.js";
+export * from "./getworkspaceplan.js";
 export * from "./importdeployment.js";
 export * from "./listapikeys.js";
+export * from "./listbillingauditlog.js";
 export * from "./listcommanddeployments.js";
 export * from "./listcommandnames.js";
 export * from "./listcommands.js";
-export * from "./listdeploymentcontainerevents.js";
-export * from "./listdeploymentcontainerinstanceevents.js";
-export * from "./listdeploymentcontainers.js";
 export * from "./listdeploymentfilterdeploymentgroups.js";
-export * from "./listdeploymentfilterplatforms.js";
+export * from "./listdeploymentfilterenvironments.js";
 export * from "./listdeploymentgroups.js";
-export * from "./listdeploymentmachines.js";
 export * from "./listdeployments.js";
 export * from "./listdomains.js";
 export * from "./listevents.js";
@@ -76,18 +72,27 @@ export * from "./listprojects.js";
 export * from "./listreleaseauthors.js";
 export * from "./listreleasebranches.js";
 export * from "./listreleases.js";
+export * from "./listresourcedeployments.js";
+export * from "./listresourceoverview.js";
 export * from "./listworkspacemembers.js";
 export * from "./listworkspaces.js";
 export * from "./pindeploymentrelease.js";
+export * from "./preparedeploymentstack.js";
 export * from "./provisionmanager.js";
 export * from "./rebuildpackages.js";
 export * from "./redeploydeployment.js";
+export * from "./refreshdomain.js";
 export * from "./removeworkspacemember.js";
 export * from "./reportmanagerheartbeat.js";
+export * from "./resolve.js";
+export * from "./resolvemanagergcpoauthprovider.js";
 export * from "./retrydeployment.js";
+export * from "./retrymanager.js";
+export * from "./retrymanagersetup.js";
 export * from "./revokeapikey.js";
 export * from "./syncacquire.js";
 export * from "./syncgitnamespaces.js";
+export * from "./synclist.js";
 export * from "./syncreconcile.js";
 export * from "./syncrelease.js";
 export * from "./updateapikey.js";
@@ -96,6 +101,7 @@ export * from "./updatedeploymentenvironmentvariables.js";
 export * from "./updatedeploymentgroup.js";
 export * from "./updatemanager.js";
 export * from "./updateproject.js";
+export * from "./updateprojectgcpoauthprovider.js";
 export * from "./updateuserprofile.js";
 export * from "./updateworkspace.js";
 export * from "./updateworkspacemember.js";

package/src/models/operations/listapikeys.ts

@@ -13,6 +13,10 @@ export type ListAPIKeysRequest = {
    * Workspace name. Defaults to your last workspace (user auth) or your API key's workspace (token auth). When using an API key, if provided, must match the key's workspace.
    */
   workspace?: string | undefined;
+  /**
+   * Filter by project ID or name.
+   */
+  project?: string | undefined;
   /**
    * Maximum number of items to return per page
    */
@@ -40,6 +44,7 @@ export type ListAPIKeysResponse = {
 /** @internal */
 export type ListAPIKeysRequest$Outbound = {
   workspace?: string | undefined;
+  project?: string | undefined;
   limit: number;
   cursor?: string | undefined;
 };
@@ -50,6 +55,7 @@ export const ListAPIKeysRequest$outboundSchema: z.ZodType<
   ListAPIKeysRequest
 > = z.object({
   workspace: z.string().optional(),
+  project: z.string().optional(),
   limit: z.int().default(20),
   cursor: z.string().optional(),
 });

package/src/models/operations/listbillingauditlog.ts

@@ -0,0 +1,73 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import * as models from "../index.js";
+
+export type ListBillingAuditLogRequest = {
+  /**
+   * Workspace name. Defaults to your last workspace (user auth) or your API key's workspace (token auth). When using an API key, if provided, must match the key's workspace.
+   */
+  workspace?: string | undefined;
+  limit?: number | undefined;
+  /**
+   * Cursor: id from the previous page.
+   */
+  before?: string | undefined;
+};
+
+/**
+ * Audit-log rows newest-first.
+ */
+export type ListBillingAuditLogResponse = {
+  items: Array<models.BillingAuditLogRow>;
+  nextCursor: string | null;
+};
+
+/** @internal */
+export type ListBillingAuditLogRequest$Outbound = {
+  workspace?: string | undefined;
+  limit: number;
+  before?: string | undefined;
+};
+
+/** @internal */
+export const ListBillingAuditLogRequest$outboundSchema: z.ZodType<
+  ListBillingAuditLogRequest$Outbound,
+  ListBillingAuditLogRequest
+> = z.object({
+  workspace: z.string().optional(),
+  limit: z.number().default(50),
+  before: z.string().optional(),
+});
+
+export function listBillingAuditLogRequestToJSON(
+  listBillingAuditLogRequest: ListBillingAuditLogRequest,
+): string {
+  return JSON.stringify(
+    ListBillingAuditLogRequest$outboundSchema.parse(listBillingAuditLogRequest),
+  );
+}
+
+/** @internal */
+export const ListBillingAuditLogResponse$inboundSchema: z.ZodType<
+  ListBillingAuditLogResponse,
+  unknown
+> = z.object({
+  items: z.array(models.BillingAuditLogRow$inboundSchema),
+  nextCursor: z.nullable(z.string()),
+});
+
+export function listBillingAuditLogResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<ListBillingAuditLogResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListBillingAuditLogResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListBillingAuditLogResponse' from JSON`,
+  );
+}

package/src/models/operations/listcommands.ts

@@ -52,6 +52,10 @@ export type ListCommandsRequest = {
    * Filter by command name
    */
   name?: string | undefined;
+  /**
+   * Search commands by name
+   */
+  search?: string | undefined;
   /**
    * Filter commands created after this date (ISO 8601)
    */
@@ -103,6 +107,7 @@ export type ListCommandsRequest$Outbound = {
   deploymentId?: string | undefined;
   state?: string | undefined;
   name?: string | undefined;
+  search?: string | undefined;
   createdAfter?: string | null | undefined;
   createdBefore?: string | null | undefined;
   include?: Array<string> | undefined;
@@ -120,6 +125,7 @@ export const ListCommandsRequest$outboundSchema: z.ZodType<
   deploymentId: z.string().optional(),
   state: State$outboundSchema.optional(),
   name: z.string().optional(),
+  search: z.string().optional(),
   createdAfter: z.nullable(z.date().transform(v => v.toISOString())).optional(),
   createdBefore: z.nullable(z.date().transform(v => v.toISOString()))
     .optional(),

package/src/models/operations/listdeploymentfilterenvironments.ts

@@ -0,0 +1,100 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v4";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type ListDeploymentFilterEnvironmentsRequest = {
+  /**
+   * Workspace name. Defaults to your last workspace (user auth) or your API key's workspace (token auth). When using an API key, if provided, must match the key's workspace.
+   */
+  workspace?: string | undefined;
+  /**
+   * Filter by project ID or name.
+   */
+  project?: string | undefined;
+};
+
+/**
+ * Represents the target cloud platform.
+ */
+export const ListDeploymentFilterEnvironmentsItem = {
+  Aws: "aws",
+  Gcp: "gcp",
+  Azure: "azure",
+  Kubernetes: "kubernetes",
+  Local: "local",
+  Test: "test",
+} as const;
+/**
+ * Represents the target cloud platform.
+ */
+export type ListDeploymentFilterEnvironmentsItem = ClosedEnum<
+  typeof ListDeploymentFilterEnvironmentsItem
+>;
+
+/**
+ * Distinct environments retrieved.
+ */
+export type ListDeploymentFilterEnvironmentsResponse = {
+  items: Array<ListDeploymentFilterEnvironmentsItem>;
+};
+
+/** @internal */
+export type ListDeploymentFilterEnvironmentsRequest$Outbound = {
+  workspace?: string | undefined;
+  project?: string | undefined;
+};
+
+/** @internal */
+export const ListDeploymentFilterEnvironmentsRequest$outboundSchema: z.ZodType<
+  ListDeploymentFilterEnvironmentsRequest$Outbound,
+  ListDeploymentFilterEnvironmentsRequest
+> = z.object({
+  workspace: z.string().optional(),
+  project: z.string().optional(),
+});
+
+export function listDeploymentFilterEnvironmentsRequestToJSON(
+  listDeploymentFilterEnvironmentsRequest:
+    ListDeploymentFilterEnvironmentsRequest,
+): string {
+  return JSON.stringify(
+    ListDeploymentFilterEnvironmentsRequest$outboundSchema.parse(
+      listDeploymentFilterEnvironmentsRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const ListDeploymentFilterEnvironmentsItem$inboundSchema: z.ZodEnum<
+  typeof ListDeploymentFilterEnvironmentsItem
+> = z.enum(ListDeploymentFilterEnvironmentsItem);
+
+/** @internal */
+export const ListDeploymentFilterEnvironmentsResponse$inboundSchema: z.ZodType<
+  ListDeploymentFilterEnvironmentsResponse,
+  unknown
+> = z.object({
+  items: z.array(ListDeploymentFilterEnvironmentsItem$inboundSchema),
+});
+
+export function listDeploymentFilterEnvironmentsResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  ListDeploymentFilterEnvironmentsResponse,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      ListDeploymentFilterEnvironmentsResponse$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'ListDeploymentFilterEnvironmentsResponse' from JSON`,
+  );
+}

package/src/models/operations/listdeploymentgroups.ts

@@ -4,9 +4,16 @@
 
 import * as z from "zod/v4";
 import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
-import * as models from "../index.js";
+
+export const ListDeploymentGroupsInclude = {
+  Project: "project",
+} as const;
+export type ListDeploymentGroupsInclude = ClosedEnum<
+  typeof ListDeploymentGroupsInclude
+>;
 
 export type ListDeploymentGroupsRequest = {
   /**
@@ -21,6 +28,10 @@ export type ListDeploymentGroupsRequest = {
    * Search deployment groups by name
    */
   search?: string | undefined;
+  /**
+   * Optional fields to include: project
+   */
+  include?: Array<ListDeploymentGroupsInclude> | undefined;
   /**
    * Maximum number of items to return per page
    */
@@ -31,6 +42,48 @@ export type ListDeploymentGroupsRequest = {
   cursor?: string | undefined;
 };
 
+/**
+ * Project info, included when ?include=project is used
+ */
+export type ListDeploymentGroupsProject = {
+  /**
+   * Project ID
+   */
+  id: string;
+  /**
+   * Project name
+   */
+  name: string;
+};
+
+export type ListDeploymentGroupsItem = {
+  /**
+   * Unique identifier for the deployment group.
+   */
+  id: string;
+  /**
+   * Deployment group name.
+   */
+  name: string;
+  /**
+   * Unique identifier for the project.
+   */
+  projectId: string;
+  /**
+   * Unique identifier for the workspace.
+   */
+  workspaceId: string;
+  /**
+   * Maximum number of deployments allowed in this deployment group
+   */
+  maxDeployments: number;
+  createdAt: Date;
+  /**
+   * Project info, included when ?include=project is used
+   */
+  project?: ListDeploymentGroupsProject | null | undefined;
+};
+
 /**
  * Paginated response
  */
@@ -38,18 +91,24 @@ export type ListDeploymentGroupsResponse = {
   /**
    * Items in this page
    */
-  items: Array<models.DeploymentGroup>;
+  items: Array<ListDeploymentGroupsItem>;
   /**
    * Cursor for the next page, null if last page
    */
   nextCursor: string | null;
 };
 
+/** @internal */
+export const ListDeploymentGroupsInclude$outboundSchema: z.ZodEnum<
+  typeof ListDeploymentGroupsInclude
+> = z.enum(ListDeploymentGroupsInclude);
+
 /** @internal */
 export type ListDeploymentGroupsRequest$Outbound = {
   workspace?: string | undefined;
   project?: string | undefined;
   search?: string | undefined;
+  include?: Array<string> | undefined;
   limit: number;
   cursor?: string | undefined;
 };
@@ -62,6 +121,7 @@ export const ListDeploymentGroupsRequest$outboundSchema: z.ZodType<
   workspace: z.string().optional(),
   project: z.string().optional(),
   search: z.string().optional(),
+  include: z.array(ListDeploymentGroupsInclude$outboundSchema).optional(),
   limit: z.int().default(20),
   cursor: z.string().optional(),
 });
@@ -76,12 +136,56 @@ export function listDeploymentGroupsRequestToJSON(
   );
 }
 
+/** @internal */
+export const ListDeploymentGroupsProject$inboundSchema: z.ZodType<
+  ListDeploymentGroupsProject,
+  unknown
+> = z.object({
+  id: z.string(),
+  name: z.string(),
+});
+
+export function listDeploymentGroupsProjectFromJSON(
+  jsonString: string,
+): SafeParseResult<ListDeploymentGroupsProject, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListDeploymentGroupsProject$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListDeploymentGroupsProject' from JSON`,
+  );
+}
+
+/** @internal */
+export const ListDeploymentGroupsItem$inboundSchema: z.ZodType<
+  ListDeploymentGroupsItem,
+  unknown
+> = z.object({
+  id: z.string(),
+  name: z.string(),
+  projectId: z.string(),
+  workspaceId: z.string(),
+  maxDeployments: z.int().default(100),
+  createdAt: z.iso.datetime({ offset: true }).transform(v => new Date(v)),
+  project: z.nullable(z.lazy(() => ListDeploymentGroupsProject$inboundSchema))
+    .optional(),
+});
+
+export function listDeploymentGroupsItemFromJSON(
+  jsonString: string,
+): SafeParseResult<ListDeploymentGroupsItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListDeploymentGroupsItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListDeploymentGroupsItem' from JSON`,
+  );
+}
+
 /** @internal */
 export const ListDeploymentGroupsResponse$inboundSchema: z.ZodType<
   ListDeploymentGroupsResponse,
   unknown
 > = z.object({
-  items: z.array(models.DeploymentGroup$inboundSchema),
+  items: z.array(z.lazy(() => ListDeploymentGroupsItem$inboundSchema)),
   nextCursor: z.nullable(z.string()),
 });
 

package/src/models/operations/listdeployments.ts

@@ -27,6 +27,7 @@ export const ListDeploymentsStatus = {
   Deleting: "deleting",
   DeleteFailed: "delete-failed",
   Deleted: "deleted",
+  Error: "error",
 } as const;
 /**
  * Deployment status in the deployment lifecycle
@@ -36,7 +37,7 @@ export type ListDeploymentsStatus = ClosedEnum<typeof ListDeploymentsStatus>;
 /**
  * Represents the target cloud platform.
  */
-export const ListDeploymentsPlatform = {
+export const ListDeploymentsEnvironment = {
   Aws: "aws",
   Gcp: "gcp",
   Azure: "azure",
@@ -47,8 +48,8 @@ export const ListDeploymentsPlatform = {
 /**
  * Represents the target cloud platform.
  */
-export type ListDeploymentsPlatform = ClosedEnum<
-  typeof ListDeploymentsPlatform
+export type ListDeploymentsEnvironment = ClosedEnum<
+  typeof ListDeploymentsEnvironment
 >;
 
 export const ListDeploymentsInclude = {
@@ -76,7 +77,7 @@ export type ListDeploymentsRequest = {
    */
   workspace?: string | undefined;
   /**
-   * Search deployments by name or deployment group name
+   * Search deployments by name, public subdomain, or deployment group name
    */
   search?: string | undefined;
   /**
@@ -84,9 +85,9 @@ export type ListDeploymentsRequest = {
    */
   status?: Array<ListDeploymentsStatus> | undefined;
   /**
-   * Filter deployments by platform
+   * Filter deployments by effective environment
    */
-  platform?: Array<ListDeploymentsPlatform> | undefined;
+  environment?: Array<ListDeploymentsEnvironment> | undefined;
   /**
    * Optional fields to include: release, deploymentGroup, project
    */
@@ -121,9 +122,9 @@ export const ListDeploymentsStatus$outboundSchema: z.ZodEnum<
 > = z.enum(ListDeploymentsStatus);
 
 /** @internal */
-export const ListDeploymentsPlatform$outboundSchema: z.ZodEnum<
-  typeof ListDeploymentsPlatform
-> = z.enum(ListDeploymentsPlatform);
+export const ListDeploymentsEnvironment$outboundSchema: z.ZodEnum<
+  typeof ListDeploymentsEnvironment
+> = z.enum(ListDeploymentsEnvironment);
 
 /** @internal */
 export const ListDeploymentsInclude$outboundSchema: z.ZodEnum<
@@ -138,7 +139,7 @@ export type ListDeploymentsRequest$Outbound = {
   workspace?: string | undefined;
   search?: string | undefined;
   status?: Array<string> | undefined;
-  platform?: Array<string> | undefined;
+  environment?: Array<string> | undefined;
   include?: Array<string> | undefined;
   limit: number;
   cursor?: string | undefined;
@@ -155,7 +156,7 @@ export const ListDeploymentsRequest$outboundSchema: z.ZodType<
   workspace: z.string().optional(),
   search: z.string().optional(),
   status: z.array(ListDeploymentsStatus$outboundSchema).optional(),
-  platform: z.array(ListDeploymentsPlatform$outboundSchema).optional(),
+  environment: z.array(ListDeploymentsEnvironment$outboundSchema).optional(),
   include: z.array(ListDeploymentsInclude$outboundSchema).optional(),
   limit: z.int().default(20),
   cursor: z.string().optional(),

package/src/models/operations/listdomains.ts

@@ -19,7 +19,7 @@ export type ListDomainsRequest = {
  * Retrieved domains.
  */
 export type ListDomainsResponse = {
-  domains: Array<models.Domain>;
+  domains: Array<models.DomainWithUsage>;
 };
 
 /** @internal */
@@ -48,7 +48,7 @@ export const ListDomainsResponse$inboundSchema: z.ZodType<
   ListDomainsResponse,
   unknown
 > = z.object({
-  domains: z.array(models.Domain$inboundSchema),
+  domains: z.array(models.DomainWithUsage$inboundSchema),
 });
 
 export function listDomainsResponseFromJSON(

package/src/models/operations/listevents.ts

@@ -17,6 +17,10 @@ export type ListEventsRequest = {
    * Filter by project ID or name.
    */
   project?: string | undefined;
+  /**
+   * Filter events to a single deployment.
+   */
+  deploymentId?: string | undefined;
   /**
    * Maximum number of items to return per page
    */
@@ -45,6 +49,7 @@ export type ListEventsResponse = {
 export type ListEventsRequest$Outbound = {
   workspace?: string | undefined;
   project?: string | undefined;
+  deploymentId?: string | undefined;
   limit: number;
   cursor?: string | undefined;
 };
@@ -56,6 +61,7 @@ export const ListEventsRequest$outboundSchema: z.ZodType<
 > = z.object({
   workspace: z.string().optional(),
   project: z.string().optional(),
+  deploymentId: z.string().optional(),
   limit: z.int().default(20),
   cursor: z.string().optional(),
 });