Shared schemas

type AccountGrant = {
  id: GrantId
  clientId: string
  clientName: string
  orgId: OrgId
  orgName: string
  projectId?: ProjectId
  projectName?: string
  resource: string
  scopes: CloudScopeOut[]
  via: string
  createdAt: Timestamp
  lastUsedAt?: Timestamp
}

type ApiKey = {
  id: ApiKeyId
  orgId: OrgId
  name: string
  purpose?: string
  start: string
  scopes: CloudScopeOut[]
  projectId?: ProjectId
  status: 'active' | 'revoked' | …
  createdBy: UserId
  createdAt: Timestamp
  expiresAt?: Timestamp
  lastUsedAt?: Timestamp
  revokedAt?: Timestamp
}

type ApiKeyId = string

type AppFormatOut = 'iosApp' | 'iosAppArchive' | 'apk' | 'expoProject' | 'catalystApp' | …

type Appearance = 'light' | 'dark'

type Arch = 'arm64' | 'x86_64'

type ArtifactId = string

type ArtifactMetadata = {
  bundleId?: string
  version?: string
  build?: string
  urlSchemes?: string[]
  signing?: 'none' | ArtifactSigning
}

type ArtifactSigning = { credentialId: string; certificateSha256: string; schemes: string[]; verifier: string }

type AuthSessionId = string

type AuthSessionInfo = {
  id: AuthSessionId
  createdAt: Timestamp
  updatedAt: Timestamp
  expiresAt: Timestamp
  reauthenticatedAt?: Timestamp
  federated?: boolean
  ipAddress?: string
  userAgent?: string
  current: boolean
}

type BuildCacheOptions = { restore: boolean; save: boolean }

type BuildConfigurationIn = 'debug' | 'release'

type BuildEnvValues = Record<string, string>

type BuildFailure = { reason: string; message: string; stepId?: string }

type BuildId = string

type BuildLogLine = {
  seq: Seq
  at: Timestamp
  stepId?: string
  stream: 'stdout' | 'stderr' | 'runner' | 'controller' | …
  line: string
}

type BuildOsFamilyIn = 'ios' | 'android'

type BuildSourceInput =
  | {
      kind: 'git'
      url: string  // 1–2048 chars
      ref: GitRef
      submodules?: boolean
      lfs?: boolean
    }
  | { kind: 'tarball' }

type BuildTargetIn = 'simulator' | 'emulator' | 'deviceInternal' | 'store'

type BuildTrigger = {
  branch?: GitRef
  defaultBranch?: GitRef
  pullRequest?: integer  // ≥ 1
}

type ClaimName = string

type ClientBinding = {
  claim: 'client_id' | 'azp' | null
  allowed: string[]  // ≤ 32 items; each /^[\x21-\x7e]{1,256}$/
}

type CloudArtifact = {
  artifactId: ArtifactId
  projectId: ProjectId
  buildId: BuildId
  name: string
  format: AppFormatOut
  contentType: string
  bytes: integer
  sha256: string
  metadata: ArtifactMetadata
  createdAt: Timestamp
  expiresAt?: Timestamp
}

type CloudBuild = {
  buildId: BuildId
  projectId: ProjectId
  status: 'awaitingSource' | 'queued' | 'starting' | 'running' | 'succeeded' | 'failed' | 'errored' | 'canceled' | …
  statusDetail?: string
  source: CloudBuildSource
  osFamily: 'ios' | 'android' | …
  target: 'simulator' | 'emulator' | 'deviceInternal' | 'store' | …
  configuration?: 'debug' | 'release' | …
  appRoot?: string
  preset?: { id: string; version: string }
  toolchain?: string
  image?: { id: string; digest: string }
  attempt: integer
  timeoutMs: integer
  failure?: BuildFailure
  error?: ErrorBody
  artifactIds: ArtifactId[]
  metadata: Record<string, unknown>
  envNames?: string[]
  uploadId?: UploadId
  signingCredentialId?: CredentialId
  createdAt: Timestamp
  queuedAt?: Timestamp
  startedAt?: Timestamp
  endedAt?: Timestamp
}

type CloudBuildSource = { kind: 'git' | 'tarball' | …; url?: string; ref?: string; revision?: string }

type CloudRun = {
  runId: RunId
  projectId: ProjectId
  status: RunStatusOut
  shardCount: integer
  workers: integer
  shards: {
    queued: integer
    running: integer
    passed: integer
    failed: integer
    errored: integer
    timedOut: integer
    canceled: integer
  }
  stats: RunStats
  timeoutMs: integer
  createdAt: Timestamp
  startedAt?: Timestamp
  endedAt?: Timestamp
}

type CloudScope = 'runtime:read' | 'runtime:admin' | 'devices:read' | 'devices:acquire' | 'devices:drive' | 'apps:install' | 'apps:debug' | 'logs:read' | 'runs:read' | 'runs:report' | 'account:read' | 'account:write' | 'org:read' | 'org:manage' | 'projects:read' | 'projects:write' | 'keys:read' | 'keys:write' | 'usage:read' | 'builds:read' | 'builds:write' | 'artifacts:read' | 'artifacts:write' | 'signing:use' | 'admin:read' | 'admin:write'

type CloudScopeOut = 'runtime:read' | 'runtime:admin' | 'devices:read' | 'devices:acquire' | 'devices:drive' | 'apps:install' | 'apps:debug' | 'logs:read' | 'runs:read' | 'runs:report' | 'account:read' | 'account:write' | 'org:read' | 'org:manage' | 'projects:read' | 'projects:write' | 'keys:read' | 'keys:write' | 'usage:read' | 'builds:read' | 'builds:write' | 'artifacts:read' | 'artifacts:write' | 'signing:use' | 'admin:read' | 'admin:write' | …

type CloudShard = {
  shardId: ShardId
  runId: RunId
  index: integer
  total: integer
  status: RunStatusOut
  attempt: integer
  sessionIds: SessionId[]
  exitCode?: integer
  stats?: RunStats
  error?: ErrorBody
  startedAt?: Timestamp
  endedAt?: Timestamp
}

type CloudUpload = {
  uploadId: UploadId
  projectId: ProjectId
  purpose: string
  state: 'open' | 'complete' | 'expired' | …
  byteBudget: integer
  bytesGranted: integer
  maxFiles: integer
  filesGranted: integer
  expiresAt: Timestamp
}

type ConnectionId = string

type CredentialCertificate = {
  serial: string
  sha1: string
  sha256: string
  subject: string
  notBefore: Timestamp
  notAfter: Timestamp
  pem?: string
}

type CredentialId = string

type CredentialMetadata = {
  keyId?: string
  issuerId?: string
  teamId?: string
  appleCertificateId?: string
  keyAlias?: string
  generated?: boolean
  profiles?: CredentialProfile[]
  certificate?: CredentialCertificate
}

type CredentialProfile = { bundleId: string; uuid: string; name: string; type: string; expiresAt: Timestamp }

type CredentialProjectsIn = 'all' | ProjectId[]

type Decimal = string

type DeviceSpec = {
  platform: PlatformId
  deviceType?: string  // 1–128 chars
  os?: string  // 1–32 chars
  arch?: Arch
  variant?: string  // 1–64 chars
  locale?: string  // ≤ 35 chars; /^[A-Za-z]{2,8}(-[A-Za-z0-9]{1,8})*$/
  timeZone?: string  // 1–64 chars
  orientation?: Orientation
  appearance?: Appearance
  labels?: Record<string, string>
}

type DisplayName = string

type Email = string

type ErrorBody = {
  code: ErrorCodeOut
  message: string
  data: JsonObject
  retryable: boolean
  requestId: string
}

type ErrorCodeOut = 'VALIDATION' | 'CONTRACT_UNSUPPORTED' | 'UNAUTHENTICATED' | 'FORBIDDEN' | 'NOT_FOUND' | 'CONFLICT' | 'TIMEOUT' | 'RATE_LIMITED' | 'INTERNAL' | 'CAPABILITY_UNSUPPORTED' | 'CAPACITY_UNAVAILABLE' | 'HOST_LOST' | 'SESSION_NOT_READY' | 'SESSION_ENDED' | 'SESSION_BUSY' | 'DEVICE_SPEC_INVALID' | 'DEVICE_BOOT_FAILED' | 'DEVICE_LOST' | 'DEVICE_DRIVER_FAILED' | 'DEVICE_MEDIA_FAILED' | 'DEVICE_INPUT_UNAVAILABLE' | 'APP_NOT_INSTALLED' | 'APP_NOT_RUNNING' | 'APP_INSTALL_FAILED' | 'APP_LAUNCH_FAILED' | 'APP_CRASHED' | 'LOCATOR_NOT_FOUND' | 'LOCATOR_NOT_ACTIONABLE' | 'LOCATOR_STRICT_VIOLATION' | 'LOCATOR_REF_STALE' | 'SECRET_UNAVAILABLE' | 'JS_RUNTIME_UNAVAILABLE' | 'QUOTA_EXCEEDED' | 'ORG_SUSPENDED' | 'PROJECT_SUSPENDED' | 'SERVICE_SUSPENDED' | 'PROJECT_REQUIRED' | 'PLACEMENT_MISMATCH' | 'ENVIRONMENT_HOST_UNSUPPORTED' | 'ENVIRONMENT_XCODE_MISSING' | 'ENVIRONMENT_XCODE_SETUP_INCOMPLETE' | 'ENVIRONMENT_IOS_RUNTIME_MISSING' | 'ENVIRONMENT_ANDROID_SDK_MISSING' | 'ENVIRONMENT_ANDROID_IMAGE_MISSING' | 'ENVIRONMENT_ADB_UNAVAILABLE' | 'ENVIRONMENT_DRIVER_NOT_INSTALLED' | 'ENVIRONMENT_TOOL_MISSING' | 'ENVIRONMENT_UNVERIFIED' | 'ENVIRONMENT_DEVICE_HUB_ACTIVE' | 'ENVIRONMENT_GUI_SESSION_MISSING' | 'ENVIRONMENT_PORTS_UNAVAILABLE' | 'ENVIRONMENT_RESERVED_RESOURCE' | 'ENVIRONMENT_DISK_LOW' | 'ENVIRONMENT_PLATFORM_DISABLED' | …

type ExternalRef = string

type GitRef = string

type GrantId = string

type Invitation = {
  id: InvitationId
  orgId: OrgId
  email: string
  role: MemberRoleOut
  status: 'pending' | 'accepted' | 'revoked' | 'expired' | …
  invitedBy: UserId
  createdAt: Timestamp
  expiresAt: Timestamp
}

type InvitationId = string

type InvitationStatus = 'pending' | 'accepted' | 'revoked' | 'expired'

type IssuerCondition = { claim: ClaimName; op: 'eq' | 'glob' | 'in'; value: string | string[] }

type IssuerId = string

type JsonObject = Record<string, unknown>

type Member = { userId: UserId; email: string; name: string; role: MemberRoleOut; joinedAt: Timestamp }

type MemberRole = 'owner' | 'admin' | 'member'

type MemberRoleOut = 'owner' | 'admin' | 'member' | …

type Month = string

type OidcConnection = {
  id: ConnectionId
  ownerKind: 'org' | 'deployment' | …
  orgId?: OrgId
  mode: 'linked' | 'claim' | …
  name: string
  issuer: string
  clientId: string
  scopes: string[]
  allowedAlgs: ('EdDSA' | 'ES256' | 'RS256' | …)[]
  verifiedDomains: string[]
  status: 'active' | 'disabled' | …
  signInPath: string
  createdAt: Timestamp
  updatedAt: Timestamp
}

type Org = {
  id: OrgId
  name: string
  slug: string
  status: 'active' | 'suspended' | …
  placementScope: 'org' | 'project' | …
  createdAt: Timestamp
  role?: MemberRoleOut
}

type OrgId = string

type Orientation = 'portrait' | 'portraitUpsideDown' | 'landscapeLeft' | 'landscapeRight'

type PageCursor = string

type PageLimit = integer

type Password = string

type PlannedStep = {
  id: StepId
  version: integer  // 1–1000
  inputs: Record<string, unknown>
}

type PlatformId = string

type PresetId = string

type PresetOptions = Record<string, string | number | boolean>

type Project = {
  id: ProjectId
  orgId: OrgId
  slug: string
  name: string
  externalRef?: string
  archivedAt?: Timestamp
  createdAt: Timestamp
  updatedAt: Timestamp
}

type ProjectId = string

type QuotaClass = string

type QuotaDimension = 'placement_units' | 'devices' | 'queued_sessions' | 'builds' | 'test_shards' | 'projects' | 'storage_bytes' | 'device_seconds' | 'build_seconds' | 'test_run_seconds'

type QuotaLine = {
  scope: 'org' | 'project' | …
  projectId?: ProjectId
  kind: 'concurrency' | 'period' | …
  dimension: string
  class: string
  limit?: integer
  source: 'org' | 'plan' | 'project' | …
  inUse?: integer
  used?: Decimal
}

type ReceivedInvitation = {
  id: InvitationId
  orgId: OrgId
  orgName: string
  role: MemberRoleOut
  expiresAt: Timestamp
}

type RefPattern = string

type RelativePath = string

type RunId = string

type RunStats = {
  expected: integer
  unexpected: integer
  flaky: integer
  skipped: integer
  errored: integer
}

type RunStatusOut = 'queued' | 'running' | 'passed' | 'failed' | 'errored' | 'timedOut' | 'canceled' | …

type RunSuiteSource =
  | {
      dir: string  // 2–4096 chars
    }
  | {
      bundle: {
        bytes: integer  // 1–67108864
        sha256: string  // /^[0-9a-f]{64}$/
      }
    }

type Seq = integer

type SessionId = string

type ShardId = string

type SignedRequestOut = {
  method: 'GET' | 'PUT' | …
  url: string
  headers: Record<string, string>
  expiresAt: Timestamp
}

type SigningCredential = {
  credentialId: CredentialId
  orgId: OrgId
  kind: 'ascApiKey' | 'androidUploadKeystore' | 'iosDistributionIdentity' | …
  name: string
  status: 'active' | 'deleted' | …
  projects: 'all' | ProjectId[]
  allowTarballs: boolean
  parentId?: CredentialId
  version: integer
  createdBy: string
  createdAt: Timestamp
  updatedAt: Timestamp
  rotatedAt?: Timestamp
  lastUsedAt?: Timestamp
  deletedAt?: Timestamp
  sourceRefs: SourceRuleOut[]
  metadata: CredentialMetadata
}

type Slug = string

type SourceRuleIn = {
  repository: string  // 1–2048 chars
  refs: RefPattern[]  // 1–16 items
}

type SourceRuleOut = { repository: string; refs: string[] }

type StepId = string

type StepOverride = {
  op: 'insertBefore' | 'insertAfter' | 'replace' | 'remove' | …
  at: StepId
  step?: PlannedStep
}

type SubjectTemplate = string

type TimeoutMs = integer

type Timestamp = string

type TrustedIssuer = {
  id: IssuerId
  orgId: OrgId
  name: string
  issuer: string
  jwksUri: string
  audience: string
  acceptedTyp: string[]
  allowedAlgs: ('EdDSA' | 'ES256' | 'RS256' | …)[]
  clientBinding: { claim: string | null; allowed: string[] }
  conditions: { claim: string; op: 'eq' | 'glob' | 'in' | …; value: string | string[] }[]
  scopeSource: 'claim' | 'fixed' | …
  fixedScopes: CloudScopeOut[]
  scopeCeiling: CloudScopeOut[]
  subjectTemplate: string
  subtenantClaim?: string
  projectMapping: 'auto-create' | 'require-existing' | 'fixed' | …
  projectId?: ProjectId
  maxProjects?: integer
  maxTokenLifetimeSeconds: integer
  status: 'active' | 'suspended' | …
  preset?: string
  jwksFetchedAt?: Timestamp
  jwksError?: string
  createdAt: Timestamp
  updatedAt: Timestamp
}

type UploadId = string

type User = {
  id: UserId
  email: string
  name: string
  emailVerified: boolean
  image?: string
  createdAt: Timestamp
}

type UserId = string