@remit/api-openapi-types 0.0.11 → 0.0.13

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remit/api-openapi-types",
-  "version": "0.0.11",
+  "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.
      */
@@ -2215,17 +2339,29 @@ standing to persist.
       dkimMismatch: boolean;
     }
     /**
-     * Present only when Remit auto-moved this message on body-sync (a confident, non-dry-run move). Absent means the message was not auto-moved by Remit — clients treat absence as no indicator.
+     * Present only when Remit auto-moved this message on body-sync. Two shapes share this model: a classifier placement move carries `action` + `fromPlacement` (Inbox/Junk direction); a standing-filter move carries `fromMailboxId` + `destinationMailboxId` + `filterId` (an arbitrary destination folder). Absent means the message was not auto-moved by Remit — clients treat absence as no indicator.
      */
     export interface AutoMovedInfo {
       /**
-       * Direction Remit moved the message: MoveToInbox | MoveToJunk. The implied destination lets the client tell whether the move is still in effect.
+       * Classifier move only: direction Remit moved the message — MoveToInbox | MoveToJunk. Absent for a standing-filter move, which names its destination via `destinationMailboxId` instead.
        */
-      action: PlacementAction;
+      action?: PlacementAction;
       /**
-       * Folder role the message was moved from: inbox | junk | other. Used to render "moved from Junk" and to resolve the undo target client-side via MailboxRole.
+       * Classifier move only: folder role the message was moved from — inbox | junk | other. Used to render "moved from Junk" and to resolve the undo target via MailboxRole. Absent for a standing-filter move, which names its source via `fromMailboxId`.
        */
-      fromPlacement: string;
+      fromPlacement?: string;
+      /**
+       * Standing-filter move only: the mailbox the message was moved out of. The undo target — the client resolves its display name for the badge and moves the message back here.
+       */
+      fromMailboxId?: UUID;
+      /**
+       * Standing-filter move only: the mailbox the filter moved the message into. The move is still in effect while the message sits here.
+       */
+      destinationMailboxId?: UUID;
+      /**
+       * Standing-filter move only: the filter that moved the message, for the Settings › Filters link. Undo does not disable it.
+       */
+      filterId?: UUID;
     }
     /**
      * Aggregate response for `searchThreads`. Carries the matching rows (`items`), a
@@ -2945,6 +3081,10 @@ server-capped window. `items` is omitted when `results=false` (count-only);
        * Remit's placement verdict, recorded when Remit decided to act (action != leave). Absent means left-in-place or synced before placement rolled out. Recorded in dry-run too, so the dark-ship distribution is queryable.
        */
       placementVerdict?: MessagePlacementVerdict;
+      /**
+       * Recorded when a standing filter moved this message at body-sync time (RFC 034). Absent means no filter moved it — a classifier move records `placementVerdict` instead, and a retroactive back-apply records neither. Drives the arbitrary-destination auto-moved badge and its undo.
+       */
+      filterMove?: MessageFilterMove;
       createdAt: number;
       updatedAt: number;
     }
@@ -3011,6 +3151,27 @@ server-capped window. `items` is omitted when `results=false` (count-only);
        */
       decidedAt: number;
     }
+    /**
+     * Recorded when a standing filter (RFC 034) moved this message at body-sync time. Present only for a real, index-time filter move, so the client can render the badge naming the destination, offer an undo back to the source folder, and link to the filter in Settings. A retroactive back-apply move attributes to no filter and never writes this (RFC 034 Decision 3.3).
+     */
+    export interface MessageFilterMove {
+      /**
+       * The standing filter that moved the message — lets the client link the badge to Settings › Filters.
+       */
+      filterId: UUID;
+      /**
+       * The mailbox the message was in before the filter moved it. The undo target: undo returns the message here and does not disable the filter.
+       */
+      sourceMailboxId: UUID;
+      /**
+       * The mailbox the filter moved the message into. The move is still in effect while the message sits here; any move away (undo or manual) clears the badge.
+       */
+      destinationMailboxId: UUID;
+      /**
+       * Body-sync timestamp the move was decided at (epoch millis).
+       */
+      decidedAt: number;
+    }
     /**
      * Core message metadata for API responses
      */
@@ -4050,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;
@@ -4489,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
    */
@@ -4920,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
@@ -5387,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;
@@ -5438,6 +5648,7 @@ export type Message = Components.Schemas.Message;
 export type MessageAuthResult = Components.Schemas.MessageAuthResult;
 export type MessageProviderSpam = Components.Schemas.MessageProviderSpam;
 export type MessagePlacementVerdict = Components.Schemas.MessagePlacementVerdict;
+export type MessageFilterMove = Components.Schemas.MessageFilterMove;
 export type MessageSummaryResponse = Components.Schemas.MessageSummaryResponse;
 export type EnvelopeResponse = Components.Schemas.EnvelopeResponse;
 export type EnvelopeAddressResponse = Components.Schemas.EnvelopeAddressResponse;
@@ -5488,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;