@remit/api-openapi-types 0.0.12 → 0.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-openapi-types",
-  "version": "0.0.12",
+  "version": "0.0.13",
   "type": "module",
   "main": "types.d.ts",
   "types": "types.d.ts",

package/types.d.ts

@@ -69,6 +69,18 @@ writer can reach is a vocabulary that lies about what the field means.
      * Phase of the initial account sync lifecycle
      */
     export type SyncPhase = "idle" | "discovering_mailboxes" | "syncing_inbox" | "syncing_others" | "complete" | "error";
+    /**
+     * Outcome of the most recent manifest check. `ok` when a manifest was fetched and validated, `failed` when it could not be, `disabled` when no manifest URL is configured or no check has ever run (RFC 037 D8).
+     */
+    export type SystemUpdateCheckStatus = "ok" | "failed" | "disabled";
+    /**
+     * Phase of an update run. Advances through the atomic update sequence; `checking` before anything is pulled, `committing` once the new version has answered the gate (RFC 037 R9, R11).
+     */
+    export type SystemUpdatePhase = "checking" | "pulling" | "snapshotting" | "stopping" | "starting" | "verifying" | "committing" | "rollingBack" | "recovering";
+    /**
+     * Terminal outcome of an update run. `null` while a run is in flight; `succeeded` when the new version committed, `rolledBack` when it did not and the previous version was restored, `rollbackFailed` when the restore itself failed and an operator shell is needed, `abandoned` when the run ended having changed nothing (RFC 037 R11).
+     */
+    export type SystemUpdateOutcome = "succeeded" | "rolledBack" | "rollbackFailed" | "abandoned";
     /**
      * IMAP namespace types per RFC 9051 Section 6.3.10
      */
@@ -1089,6 +1101,118 @@ never from a raw content-type line — parameters carry `name=` and
        */
       mailboxId?: UUID;
     }
+    /**
+     * The self-update resource: the running version, the outcome of the most recent manifest check, and the state of the current or last run. One read serves every interface state. The check block and the run block are independent by construction (RFC 037 D7).
+     */
+    export interface SystemUpdateResponse {
+      /**
+       * The version the instance is currently running, `vX.Y.Z` (or a non-release tag such as `latest`)
+       */
+      currentVersion: string;
+      /**
+       * Schema version the running instance is on, written by the wrapper at check time. The consent UI derives that applying a release runs a migration from `check.schemaVersion` being greater than this. Absent when unknown, so a state file written before this field existed still validates.
+       */
+      currentSchemaVersion?: number;
+      /**
+       * The most recent manifest check
+       */
+      check: SystemUpdateCheck;
+      /**
+       * The current or last update run, or `null` when no run has ever started
+       */
+      run: SystemUpdateRun | any;
+    }
+    /**
+     * The most recent manifest check. The check block is independent of the run block: a failed check never renders as a failed update. On `failed` the version fields are absent and an `error` sentence explains why; on `disabled` only the status is present.
+     */
+    export interface SystemUpdateCheck {
+      /**
+       * Outcome of the most recent manifest check
+       */
+      status: SystemUpdateCheckStatus;
+      /**
+       * When the manifest was last fetched, ISO 8601. Absent when the check is disabled.
+       */
+      lastCheckedAt?: string;
+      /**
+       * Latest release version named by the manifest, `vX.Y.Z`. Present when status is `ok`.
+       */
+      latestVersion?: string;
+      /**
+       * Publication date of the latest release, ISO 8601. Present when status is `ok`.
+       */
+      publishedAt?: string;
+      /**
+       * One authored sentence describing the latest release. Present when status is `ok`.
+       */
+      summary?: string;
+      /**
+       * URL of the release notes for the latest release. Present when status is `ok`.
+       */
+      releaseNotesUrl?: string;
+      /**
+       * Whether the latest release is newer than the running version. Present when status is `ok`.
+       */
+      updateAvailable?: boolean;
+      /**
+       * Schema version of the latest release, from the manifest. Compared against `currentSchemaVersion` to derive whether applying the release runs a migration. Absent when the manifest does not carry it, so a state file written before this field existed still validates.
+       */
+      schemaVersion?: number;
+      /**
+       * Plain sentence naming why the check failed. Present when status is `failed`.
+       */
+      error?: string;
+    }
+    /**
+     * The current or last update run. `null` when no run has ever started. `outcome` is `null` while a run is in flight. `message` and `logCommand` are rendered to the operator verbatim: a plain sentence naming the cause and a command that can be pasted into a shell to see more (RFC 037 Interface).
+     */
+    export interface SystemUpdateRun {
+      /**
+       * Opaque id of this run; the client persists it and treats subsequent request failures as an in-progress apply until the surface answers
+       */
+      runId: string;
+      /**
+       * Version the run started from, `vX.Y.Z`
+       */
+      fromVersion: string;
+      /**
+       * Version the run is installing, `vX.Y.Z`
+       */
+      targetVersion: string;
+      /**
+       * Phase the run is in
+       */
+      phase: SystemUpdatePhase;
+      /**
+       * Terminal outcome, or `null` while the run is in flight
+       */
+      outcome: SystemUpdateOutcome | any;
+      /**
+       * When the run started, ISO 8601
+       */
+      startedAt: string;
+      /**
+       * When the run state was last written, ISO 8601
+       */
+      updatedAt: string;
+      /**
+       * Plain sentence naming the current cause, rendered to the operator verbatim
+       */
+      message: string;
+      /**
+       * A command that can be pasted into a shell to see more, rendered to the operator verbatim
+       */
+      logCommand: string;
+    }
+    /**
+     * Request to install a specific release. `targetVersion` must equal the version the latest check reported; the backend passes exactly this one field across the control seam and resolves nothing else (RFC 037 R6).
+     */
+    export interface ApplyUpdateInput {
+      /**
+       * The release version to install, `vX.Y.Z`
+       */
+      targetVersion: string;
+    }
     /**
      * Represents an IMAP mailbox (folder). Contains IMAP-specific identifiers for message synchronization.
      */
@@ -4087,6 +4211,17 @@ declare namespace Paths {
       export type $200 = void;
     }
   }
+  namespace GetSystemUpdate {
+    namespace Responses {
+      export type $200 = void;
+    }
+  }
+  namespace ApplySystemUpdate {
+    export type RequestBody = Components.Schemas.ApplyUpdateInput;
+    namespace Responses {
+      export type $200 = void;
+    }
+  }
   namespace ListMailboxes {
     export interface PathParameters {
       accountId: Components.Schemas.UUID;
@@ -4526,6 +4661,22 @@ export interface OperationMethods {
     data?: any,
     config?: AxiosRequestConfig
   ): OperationResponse<Paths.GetConfig.Responses.$200>;
+  /**
+   * getSystemUpdate - Read the self-update resource: the running version, the outcome of the most recent manifest check, and the state of the current or last run. Owner-only, and absent (404) unless a manifest URL is configured (RFC 037 D7, D8).
+   */
+  'getSystemUpdate'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: any,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.GetSystemUpdate.Responses.$200>;
+  /**
+   * applySystemUpdate - Request installation of a specific release. Writes the request to the control seam and returns 202 with the same resource, including a runId. 409 when a run is in flight, 422 when the target is not the manifest's version. Owner-only, and absent (404) unless a manifest URL is configured (RFC 037 D7, D8).
+   */
+  'applySystemUpdate'(
+    parameters?: Parameters<UnknownParamsObject> | null,
+    data?: Paths.ApplySystemUpdate.RequestBody,
+    config?: AxiosRequestConfig
+  ): OperationResponse<Paths.ApplySystemUpdate.Responses.$200>;
   /**
    * listMailboxes
    */
@@ -4957,6 +5108,24 @@ export interface PathsDictionary {
       config?: AxiosRequestConfig
     ): OperationResponse<Paths.GetConfig.Responses.$200>;
   };
+  ['/system/update']: {
+    /**
+     * getSystemUpdate - Read the self-update resource: the running version, the outcome of the most recent manifest check, and the state of the current or last run. Owner-only, and absent (404) unless a manifest URL is configured (RFC 037 D7, D8).
+     */
+    'get'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: any,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.GetSystemUpdate.Responses.$200>;
+    /**
+     * applySystemUpdate - Request installation of a specific release. Writes the request to the control seam and returns 202 with the same resource, including a runId. 409 when a run is in flight, 422 when the target is not the manifest's version. Owner-only, and absent (404) unless a manifest URL is configured (RFC 037 D7, D8).
+     */
+    'post'(
+      parameters?: Parameters<UnknownParamsObject> | null,
+      data?: Paths.ApplySystemUpdate.RequestBody,
+      config?: AxiosRequestConfig
+    ): OperationResponse<Paths.ApplySystemUpdate.Responses.$200>;
+  };
   ['/accounts/{accountId}/mailboxes']: {
     /**
      * listMailboxes
@@ -5424,6 +5593,10 @@ export type AccountResponse = Components.Schemas.AccountResponse;
 export type AddressFlagBase = Components.Schemas.AddressFlagBase;
 export type MutedFlag = Components.Schemas.MutedFlag;
 export type FolderAppointment = Components.Schemas.FolderAppointment;
+export type SystemUpdateResponse = Components.Schemas.SystemUpdateResponse;
+export type SystemUpdateCheck = Components.Schemas.SystemUpdateCheck;
+export type SystemUpdateRun = Components.Schemas.SystemUpdateRun;
+export type ApplyUpdateInput = Components.Schemas.ApplyUpdateInput;
 export type Mailbox = Components.Schemas.Mailbox;
 export type MailboxResponse = Components.Schemas.MailboxResponse;
 export type CreateMailboxInput = Components.Schemas.CreateMailboxInput;
@@ -5526,6 +5699,9 @@ export type AccountConfigState = Components.Schemas.AccountConfigState;
 export type AccountAuthType = Components.Schemas.AccountAuthType;
 export type ConnectionState = Components.Schemas.ConnectionState;
 export type SyncPhase = Components.Schemas.SyncPhase;
+export type SystemUpdateCheckStatus = Components.Schemas.SystemUpdateCheckStatus;
+export type SystemUpdatePhase = Components.Schemas.SystemUpdatePhase;
+export type SystemUpdateOutcome = Components.Schemas.SystemUpdateOutcome;
 export type NamespaceType = Components.Schemas.NamespaceType;
 export type MailboxSyncStatus = Components.Schemas.MailboxSyncStatus;
 export type MailboxCursorState = Components.Schemas.MailboxCursorState;