@oore/client 0.3.0 → 0.5.0

package/dist/generated/types.gen.d.ts

@@ -92,6 +92,18 @@ export type AppendBuildLogsRequest = {
 export type AppendBuildLogsResponse = {
     appended: number;
 };
+/**
+ * Which builds of a pipeline wait for a maintainer before a runner may
+ * claim them.
+ */
+export type ApprovalPolicy = {
+    /**
+     * Trigger events that need approval: `push`, `pull_request`,
+     * `tag_push`, `manual` or `schedule`. Empty means every build.
+     */
+    events?: Array<string>;
+    required: boolean;
+};
 export type Artifact = {
     artifact_type: ArtifactType;
     build_id: string;
@@ -184,6 +196,7 @@ export type BrowseLocalGitDirectoriesResponse = {
     suggestions: Array<LocalGitPathSuggestion>;
 };
 export type Build = {
+    approval?: null | BuildApproval;
     branch?: string | null;
     build_number: number;
     changelog?: string | null;
@@ -211,6 +224,33 @@ export type Build = {
     trigger_type: TriggerType;
     updated_at: number;
 };
+export type BuildApproval = {
+    decided_at?: number | null;
+    decided_by?: string | null;
+    reason?: string | null;
+    requested_at: number;
+    state: BuildApprovalState;
+};
+export type BuildApprovalRequest = {
+    reason?: string | null;
+};
+export type BuildApprovalResponse = {
+    build: Build;
+};
+/**
+ * Build approval state. Pending builds stay `queued` but no runner claims them.
+ */
+export type BuildApprovalState = 'pending' | 'approved' | 'rejected';
+/**
+ * `build` event on `GET /v1/events`: a build was created or changed.
+ */
+export type BuildChangedEvent = {
+    build_id: string;
+    build_number: number;
+    project_id: string;
+    status: BuildStatus;
+    updated_at: number;
+};
 export type BuildChangelogPreviewResponse = {
     base_commit?: string | null;
     markdown: string;
@@ -239,6 +279,10 @@ export type BuildEvent = {
     reason?: string | null;
     to_status: string;
 };
+/**
+ * Where a build's steps run.
+ */
+export type BuildIsolation = 'host' | 'vm';
 export type BuildLogChunk = {
     content: string;
     sequence: number;
@@ -251,6 +295,40 @@ export type BuildLogsResponse = {
 };
 export type BuildPlatform = 'android' | 'ios' | 'macos';
 export type BuildStatus = 'queued' | 'scheduled' | 'assigned' | 'running' | 'succeeded' | 'failed' | 'canceled' | 'timed_out' | 'expired';
+export type BuildTestFailure = {
+    duration_ms?: number | null;
+    /**
+     * The test failed, passed, then failed again within the history window.
+     */
+    flaky: boolean;
+    /**
+     * Recent builds of this pipeline that reported tests, oldest first, ending with this build.
+     */
+    history: Array<TestRunOutcome>;
+    message?: string | null;
+    name: string;
+    stack_trace?: string | null;
+    step: string;
+    suite: string;
+};
+export type BuildTestResultsResponse = {
+    failures: Array<BuildTestFailure>;
+    /**
+     * How many recent test-reporting builds the history and flaky check cover.
+     */
+    history_window: number;
+    summary?: null | BuildTestSummary;
+};
+/**
+ * Totals across every test report of a build.
+ */
+export type BuildTestSummary = {
+    duration_ms: number;
+    failed: number;
+    passed: number;
+    skipped: number;
+    total: number;
+};
 export type CancelBuildResponse = {
     build: Build;
 };
@@ -373,11 +451,13 @@ export type CreateNotificationChannelRequest = {
     url?: string | null;
 };
 export type CreatePipelineRequest = {
+    approval?: null | ApprovalPolicy;
     concurrency?: null | ConcurrencyPolicy;
     config_path?: string | null;
     config_path_explicit?: boolean | null;
     execution_config?: null | PipelineExecutionConfig;
     name: string;
+    timeout_minutes?: number | null;
     trigger_config?: null | TriggerConfig;
 };
 export type CreatePipelineResponse = {
@@ -452,6 +532,24 @@ export type EffectiveProjectRetentionResponse = {
     has_override: boolean;
     override_fields?: null | ProjectRetentionOverride;
 };
+/**
+ * `ready` event, the first event on every `GET /v1/events` connection.
+ * Clients refetch once on `ready` after a reconnect, since events sent while
+ * disconnected are not replayed.
+ */
+export type EventStreamReady = {
+    project_id?: string | null;
+    /**
+     * Whether this stream carries `runner` events.
+     */
+    runners: boolean;
+};
+/**
+ * `resync` event: events were dropped, so clients should refetch.
+ */
+export type EventStreamResync = {
+    reason: string;
+};
 export type ExternalAccessNetworkSettings = {
     allowed_origins: Array<string>;
     artifact_delivery_url?: string | null;
@@ -755,8 +853,16 @@ export type ListRepositoriesResponse = {
 };
 export type ListRunnersResponse = {
     online_total: number;
+    /**
+     * Builds waiting for a runner.
+     */
+    queued_total?: number;
     runners: Array<Runner>;
     total: number;
+    /**
+     * Queued builds whose `runs_on` labels no online runner has.
+     */
+    unmatched_queued_total?: number;
 };
 export type ListSecretsResponse = {
     secrets: Array<SecretSummary>;
@@ -888,6 +994,7 @@ export type OperatorIncident = {
 export type OperatorIncidentSeverity = 'info' | 'warning' | 'critical';
 export type OperatorIncidentStatus = 'open' | 'resolved';
 export type Pipeline = {
+    approval: ApprovalPolicy;
     concurrency: ConcurrencyPolicy;
     config_path: string;
     config_path_explicit: boolean;
@@ -897,6 +1004,10 @@ export type Pipeline = {
     id: string;
     name: string;
     project_id: string;
+    /**
+     * Minutes a running build may take before it is marked `timed_out`.
+     */
+    timeout_minutes: number;
     trigger_config: TriggerConfig;
     updated_at: number;
 };
@@ -941,9 +1052,14 @@ export type PipelineExecutionConfig = {
     commands: PipelineCommandStages;
     env?: Array<PipelineEnvVar>;
     flutter_version?: string | null;
+    isolation?: BuildIsolation;
     platform_build_args?: PlatformBuildArgs;
     platform_commands?: PlatformBuildCommands;
     platforms: Array<BuildPlatform>;
+    /**
+     * Runner labels a build needs, all of them. Empty means `macos`.
+     */
+    runs_on?: Array<string>;
 };
 export type PipelineGooglePlayPublishResponse = {
     config?: null | GooglePlayPublishConfig;
@@ -1068,6 +1184,10 @@ export type RegisterRunnerRequest = {
     capabilities?: {
         [key: string]: unknown;
     };
+    /**
+     * Operator labels for the new runner, added to the detected labels.
+     */
+    labels?: Array<string>;
     name: string;
 };
 export type RegisterRunnerResponse = {
@@ -1151,6 +1271,21 @@ export type ReleaseActivityEvent = ReleaseHistoryEntry & {
  * Where a maintainer approval is required, if anywhere.
  */
 export type ReleaseApprovalGate = 'none' | 'before_upload' | 'before_production';
+/**
+ * `release` event on `GET /v1/events`: a release was created or its state
+ * or rollout changed.
+ */
+export type ReleaseChangedEvent = {
+    build_id: string;
+    project_id: string;
+    release_id: string;
+    /**
+     * Fraction of users, 0..1.
+     */
+    rollout_fraction: number;
+    state: ReleaseState;
+    updated_at: number;
+};
 export type ReleaseDetailResponse = {
     history: Array<ReleaseHistoryEntry>;
     release: Release;
@@ -1209,9 +1344,11 @@ export type RepositoryWorkflowExecutionPreview = {
     commands: PipelineCommandStages;
     env_keys: Array<string>;
     flutter_version?: string | null;
+    isolation: BuildIsolation;
     platform_build_args: PlatformBuildArgs;
     platform_commands: PlatformBuildCommands;
     platforms: Array<BuildPlatform>;
+    runs_on?: Array<string>;
 };
 /**
  * Secret-free representation of a repository-owned pipeline config.
@@ -1264,12 +1401,27 @@ export type RotateSecretRequest = {
     value: string;
 };
 export type Runner = {
+    /**
+     * Set while a dependency cache purge waits for the runner to pick it up.
+     */
+    cache_purge_requested_at?: number | null;
     capabilities: {
         [key: string]: unknown;
     };
     created_at: number;
+    /**
+     * Labels an operator assigned to this runner.
+     */
+    custom_labels?: Array<string>;
+    disk_pressure?: null | RunnerDiskPressure;
     id: string;
+    /**
+     * Every label the scheduler matches `runs_on` against: the labels detected
+     * from capabilities plus `custom_labels`.
+     */
+    labels?: Array<string>;
     last_heartbeat_at?: number | null;
+    metrics?: null | RunnerMetrics;
     name: string;
     registered_by?: string | null;
     status: RunnerStatus;
@@ -1303,12 +1455,35 @@ export type RunnerAppStoreUploadCredentials = {
     key_id: string;
     private_key_pem: string;
 };
+/**
+ * `runner` event on `GET /v1/events`: a runner was registered, removed,
+ * renamed or changed status. Sent only to users who can read runners.
+ */
+export type RunnerChangedEvent = {
+    name: string;
+    /**
+     * True when the runner no longer exists; `status` is its last known one.
+     */
+    removed: boolean;
+    runner_id: string;
+    status: RunnerStatus;
+};
+export type RunnerDiskPressure = 'warning' | 'critical';
 export type RunnerHeartbeatRequest = {
     capabilities?: {
         [key: string]: unknown;
     };
+    metrics?: null | RunnerMetrics;
     status: string;
 };
+/**
+ * Heartbeat answer. Runners purge their dependency caches when
+ * `cache_purge_requested_at` is newer than their last purge, then report
+ * `capabilities.caches.purged_at` to clear the request.
+ */
+export type RunnerHeartbeatResponse = {
+    cache_purge_requested_at?: number | null;
+};
 export type RunnerIosProvisioningProfile = {
     bundle_id: string;
     profile_base64: string;
@@ -1340,6 +1515,30 @@ export type RunnerJobSecret = {
 export type RunnerJobSecretsResponse = {
     secrets: Array<RunnerJobSecret>;
 };
+/**
+ * Host utilisation a runner reports with each heartbeat.
+ */
+export type RunnerMetrics = {
+    /**
+     * Size of the runner's dependency caches, when measured.
+     */
+    cache_bytes?: number | null;
+    /**
+     * When the backend received these metrics. Set by the backend.
+     */
+    collected_at?: number | null;
+    /**
+     * One-minute load average as a share of logical CPUs, capped at 100.
+     */
+    cpu_percent: number;
+    /**
+     * Free space on the volume that holds build workspaces.
+     */
+    disk_free_bytes: number;
+    disk_total_bytes: number;
+    memory_total_bytes: number;
+    memory_used_bytes: number;
+};
 export type RunnerPolicyBlockReason = 'instance_paused' | 'repository_unavailable';
 /**
  * Publish work for the runner, fetched with the job-scoped grant.
@@ -1371,6 +1570,37 @@ export type RunnerPublishResult = {
     version_name?: string | null;
 };
 export type RunnerStatus = 'online' | 'offline' | 'busy' | 'draining';
+export type RunnerTestFailure = {
+    duration_ms?: number | null;
+    message?: string | null;
+    /**
+     * Full test name, including group names.
+     */
+    name: string;
+    stack_trace?: string | null;
+    /**
+     * Test file or suite, such as `test/login_test.dart`.
+     */
+    suite: string;
+};
+/**
+ * Test results parsed by the runner from one build step.
+ */
+export type RunnerTestReport = {
+    duration_ms: number;
+    failed: number;
+    /**
+     * Failed tests. The daemon keeps at most 500 per build.
+     */
+    failures: Array<RunnerTestFailure>;
+    passed: number;
+    skipped: number;
+    /**
+     * Step that produced the report, such as `build-2`.
+     */
+    step: string;
+    total: number;
+};
 export type RuntimeMode = 'local' | 'remote';
 export type RuntimeUpdateCheck = {
     detail?: string | null;
@@ -1403,6 +1633,20 @@ export type RuntimeUpdateStatus = {
     managed_service: boolean;
     phase: RuntimeUpdatePhase;
 };
+/**
+ * A cron schedule that starts a build on a branch.
+ */
+export type ScheduleTrigger = {
+    /**
+     * Branch to build. Defaults to the project's default branch.
+     */
+    branch?: string | null;
+    /**
+     * Five-field cron expression (`minute hour day month weekday`) in UTC,
+     * or `@hourly`, `@daily`, `@weekly`, `@monthly`.
+     */
+    cron: string;
+};
 export type ScmProvider = 'github' | 'gitlab' | 'local_git';
 export type SecretResponse = {
     secret: SecretSummary;
@@ -1552,9 +1796,43 @@ export type TestOidcConnectionResponse = {
     token_endpoint: string;
     userinfo_endpoint?: string | null;
 };
+/**
+ * One earlier run of a test in the same pipeline.
+ */
+export type TestRunOutcome = {
+    build_id: string;
+    build_number: number;
+    /**
+     * `failed`, or `passed` when the build reported tests and this one did not fail.
+     */
+    status: string;
+};
 export type TriggerConfig = {
+    /**
+     * Branch globs for push and pull request events. When only `tags` is
+     * set, branch events do not trigger.
+     */
     branches: Array<string>;
     events: Array<string>;
+    /**
+     * Push and pull request events trigger only when a changed file matches
+     * one of these globs (`**` spans directories).
+     */
+    paths?: Array<string>;
+    /**
+     * Push and pull request events are skipped when every changed file
+     * matches one of these globs.
+     */
+    paths_ignore?: Array<string>;
+    /**
+     * Cron schedules, evaluated in UTC.
+     */
+    schedules?: Array<ScheduleTrigger>;
+    /**
+     * Tag globs for tag push events. When only `branches` is set, tag
+     * events do not trigger.
+     */
+    tags?: Array<string>;
 };
 export type TriggerType = 'manual' | 'api' | 'webhook' | 'schedule';
 export type TrustedProxySettingsPublic = {
@@ -1629,12 +1907,14 @@ export type UpdatePipelineIosSigningRequest = {
     team_id?: string | null;
 };
 export type UpdatePipelineRequest = {
+    approval?: null | ApprovalPolicy;
     concurrency?: null | ConcurrencyPolicy;
     config_path?: string | null;
     config_path_explicit?: boolean | null;
     enabled?: boolean | null;
     execution_config?: null | PipelineExecutionConfig;
     name?: string | null;
+    timeout_minutes?: number | null;
     trigger_config?: null | TriggerConfig;
 };
 export type UpdateProjectMemberRequest = {
@@ -1673,6 +1953,10 @@ export type UpdateRetentionPolicyRequest = {
     max_builds_per_project?: number | null;
 };
 export type UpdateRunnerRequest = {
+    /**
+     * Replaces the runner's operator labels. Detected labels are kept.
+     */
+    custom_labels?: Array<string> | null;
     name?: string | null;
 };
 export type UpdateRunnerResponse = {
@@ -1715,11 +1999,13 @@ export type UserProfileResponse = {
 export type UserRole = 'owner' | 'admin' | 'developer' | 'qa_viewer';
 export type UserStatus = 'active' | 'disabled' | 'invited';
 export type ValidatePipelineRequest = {
+    approval?: null | ApprovalPolicy;
     concurrency?: null | ConcurrencyPolicy;
     config_path?: string | null;
     config_path_explicit?: boolean | null;
     execution_config?: null | PipelineExecutionConfig;
     repository_yaml?: string | null;
+    timeout_minutes?: number | null;
     trigger_config?: null | TriggerConfig;
 };
 export type ValidatePipelineResponse = {
@@ -2568,6 +2854,42 @@ export type GetBuildResponses = {
     200: BuildDetailResponse;
 };
 export type GetBuildResponse = GetBuildResponses[keyof GetBuildResponses];
+export type ApproveBuildData = {
+    /**
+     * Optional note for the audit log
+     */
+    body: BuildApprovalRequest;
+    path: {
+        /**
+         * Build ID
+         */
+        build_id: string;
+    };
+    query?: never;
+    url: '/v1/builds/{build_id}/approve';
+};
+export type ApproveBuildErrors = {
+    /**
+     * Not a project maintainer
+     */
+    403: ApiError;
+    /**
+     * Not found
+     */
+    404: ApiError;
+    /**
+     * Build is not waiting for approval
+     */
+    409: ApiError;
+};
+export type ApproveBuildError = ApproveBuildErrors[keyof ApproveBuildErrors];
+export type ApproveBuildResponses = {
+    /**
+     * Build approved and queued
+     */
+    200: BuildApprovalResponse;
+};
+export type ApproveBuildResponse = ApproveBuildResponses[keyof ApproveBuildResponses];
 export type ListArtifactsData = {
     body?: never;
     path: {
@@ -2672,6 +2994,42 @@ export type StreamBuildLogsResponses = {
     200: string;
 };
 export type StreamBuildLogsResponse = StreamBuildLogsResponses[keyof StreamBuildLogsResponses];
+export type RejectBuildData = {
+    /**
+     * Optional reason, shown on the build
+     */
+    body: BuildApprovalRequest;
+    path: {
+        /**
+         * Build ID
+         */
+        build_id: string;
+    };
+    query?: never;
+    url: '/v1/builds/{build_id}/reject';
+};
+export type RejectBuildErrors = {
+    /**
+     * Not a project maintainer
+     */
+    403: ApiError;
+    /**
+     * Not found
+     */
+    404: ApiError;
+    /**
+     * Build is not waiting for approval
+     */
+    409: ApiError;
+};
+export type RejectBuildError = RejectBuildErrors[keyof RejectBuildErrors];
+export type RejectBuildResponses = {
+    /**
+     * Build rejected and canceled
+     */
+    200: BuildApprovalResponse;
+};
+export type RejectBuildResponse = RejectBuildResponses[keyof RejectBuildResponses];
 export type RerunBuildData = {
     body?: never;
     path: {
@@ -2719,6 +3077,64 @@ export type CreateStreamTokenResponses = {
     200: StreamTokenResponse;
 };
 export type CreateStreamTokenResponse = CreateStreamTokenResponses[keyof CreateStreamTokenResponses];
+export type GetBuildTestResultsData = {
+    body?: never;
+    path: {
+        /**
+         * Build ID
+         */
+        build_id: string;
+    };
+    query?: never;
+    url: '/v1/builds/{build_id}/tests';
+};
+export type GetBuildTestResultsErrors = {
+    /**
+     * Build not found
+     */
+    404: ApiError;
+};
+export type GetBuildTestResultsError = GetBuildTestResultsErrors[keyof GetBuildTestResultsErrors];
+export type GetBuildTestResultsResponses = {
+    /**
+     * Test results
+     */
+    200: BuildTestResultsResponse;
+};
+export type GetBuildTestResultsResponse = GetBuildTestResultsResponses[keyof GetBuildTestResultsResponses];
+export type StreamEventsData = {
+    body?: never;
+    path?: never;
+    query?: {
+        /**
+         * Only send build and release events for this project
+         */
+        project_id?: string;
+    };
+    url: '/v1/events';
+};
+export type StreamEventsErrors = {
+    /**
+     * Missing or invalid token
+     */
+    401: ApiError;
+    /**
+     * No read access to the project
+     */
+    403: ApiError;
+    /**
+     * Too many open event streams
+     */
+    429: ApiError;
+};
+export type StreamEventsError = StreamEventsErrors[keyof StreamEventsErrors];
+export type StreamEventsResponses = {
+    /**
+     * SSE event stream
+     */
+    200: string;
+};
+export type StreamEventsResponse = StreamEventsResponses[keyof StreamEventsResponses];
 export type FrontendPairData = {
     body: FrontendPairRequest;
     path?: never;
@@ -5098,6 +5514,35 @@ export type UpdateRunnerResponses = {
     200: UpdateRunnerResponse;
 };
 export type UpdateRunnerResponse2 = UpdateRunnerResponses[keyof UpdateRunnerResponses];
+export type PurgeRunnerCachesData = {
+    body?: never;
+    path: {
+        /**
+         * Runner ID
+         */
+        runner_id: string;
+    };
+    query?: never;
+    url: '/v1/runners/{runner_id}/caches/purge';
+};
+export type PurgeRunnerCachesErrors = {
+    /**
+     * Insufficient permissions
+     */
+    403: ApiError;
+    /**
+     * Runner not found
+     */
+    404: ApiError;
+};
+export type PurgeRunnerCachesError = PurgeRunnerCachesErrors[keyof PurgeRunnerCachesErrors];
+export type PurgeRunnerCachesResponses = {
+    /**
+     * Purge requested
+     */
+    200: UpdateRunnerResponse;
+};
+export type PurgeRunnerCachesResponse = PurgeRunnerCachesResponses[keyof PurgeRunnerCachesResponses];
 export type ClaimJobData = {
     body: ClaimJobRequest;
     path: {
@@ -5131,9 +5576,9 @@ export type RunnerHeartbeatResponses = {
     /**
      * Heartbeat recorded
      */
-    204: void;
+    200: RunnerHeartbeatResponse;
 };
-export type RunnerHeartbeatResponse = RunnerHeartbeatResponses[keyof RunnerHeartbeatResponses];
+export type RunnerHeartbeatResponse2 = RunnerHeartbeatResponses[keyof RunnerHeartbeatResponses];
 export type GetJobStatusData = {
     body?: never;
     path: {
@@ -5570,6 +6015,43 @@ export type UpdateJobStatusResponses = {
     200: BuildDetailResponse;
 };
 export type UpdateJobStatusResponse = UpdateJobStatusResponses[keyof UpdateJobStatusResponses];
+export type ReportJobTestResultsData = {
+    body: RunnerTestReport;
+    path: {
+        /**
+         * Runner ID
+         */
+        runner_id: string;
+        /**
+         * Build/Job ID
+         */
+        job_id: string;
+    };
+    query?: never;
+    url: '/v1/runners/{runner_id}/jobs/{job_id}/test-results';
+};
+export type ReportJobTestResultsErrors = {
+    /**
+     * Runner does not match the assignment
+     */
+    403: ApiError;
+    /**
+     * Build not found
+     */
+    404: ApiError;
+    /**
+     * Build is not running
+     */
+    409: ApiError;
+};
+export type ReportJobTestResultsError = ReportJobTestResultsErrors[keyof ReportJobTestResultsErrors];
+export type ReportJobTestResultsResponses = {
+    /**
+     * Recorded
+     */
+    200: OkResponse;
+};
+export type ReportJobTestResultsResponse = ReportJobTestResultsResponses[keyof ReportJobTestResultsResponses];
 export type ListInstanceSecretsData = {
     body?: never;
     path?: never;