@remit/api-openapi-types 0.0.110 → 0.0.111

package/package.json

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

package/types.d.ts

@@ -253,6 +253,10 @@ current enum emitter anyway, so the wire contract uses the bare form.
      * Why a classification provider cannot run.
      */
     export type ClassificationUnrunnableReason = "NoBaseUrl" | "NoApiKey";
+    /**
+     * What a `Junk` verdict of one kind does (RFC 041). The owner picks one for `Spam` and one for `Phishing`.
+     */
+    export type SpamLabelPlacement = "MoveToSpam" | "WarnOnly";
     /**
      * Why a classification provider call gave no usable answer.
      */
@@ -265,6 +269,14 @@ current enum emitter anyway, so the wire contract uses the bare form.
      * Header-derived message category. Set by classifyByHeaders during body-sync. Defaults to `uncategorized`, which covers both a message that has not been classified yet and one the classifier declined to categorize; `Message.classificationState` is what tells those apart.
      */
     export type MessageCategory = "uncategorized" | "personal" | "newsletter" | "marketing" | "automated" | "transactional" | "social" | "coldOutreach";
+    /**
+     * What the spam service tells Remit to do with a checked message (RFC 041).
+     */
+    export type SpamAction = "None" | "Warn" | "Junk";
+    /**
+     * What the spam service suspects a checked message of (RFC 041).
+     */
+    export type SpamKind = "Spam" | "Phishing";
     /**
      * Sort order for list operations
      */
@@ -316,14 +328,6 @@ explained to the user as a failed delete.
      * The stage 1 rule that let a message through without a spam check, when the sender decided it (RFC 041).
      */
     export type SpamSenderScreenRule = "ReportedSender" | "NeverSpam" | "Vip" | "WellKnown" | "Newsletter";
-    /**
-     * What the spam service tells Remit to do with a checked message (RFC 041).
-     */
-    export type SpamAction = "None" | "Warn" | "Junk";
-    /**
-     * What the spam service suspects a checked message of (RFC 041).
-     */
-    export type SpamKind = "Spam" | "Phishing";
     /**
      * The stable name of one check the spam service ran and found something with (RFC 041). A client holds one sentence per name.
      */
@@ -360,10 +364,6 @@ distinguishable from a network failure without parsing prose.
      * Whether the header classifier has examined a message's body (issue #331). Persistence-level state on `Message`, deliberately off the wire: no response model carries it. It exists because `category` cannot answer this question — `uncategorized` is both the value a metadata-synced row starts at and the answer the classifier gives when it has nothing to say, so a guard reading `category` alone cannot tell "never examined" from "examined and declined" and re-reads the stored body on every sync pass forever.
      */
     export type MessageClassificationState = "NotExamined" | "Examined";
-    /**
-     * Sender-authenticity tier for a message, resolved at body-sync from the trusted Authentication-Results header and the sender's pair-keyed standing. First match wins, in tier order: `Impersonation`, `Aligned`, `Authenticated`, `Routine`, `NotChecked`, `Caution`. `NotEvaluated` is the sentinel for a message the derivation has never run on — it is the default and what every message written before this field existed carries, and it is distinct from `NotChecked`, which is a result.
-     */
-    export type AuthenticityVerdict = "NotEvaluated" | "NotChecked" | "Aligned" | "Authenticated" | "Routine" | "Caution" | "Impersonation";
     /**
      * Authentication verdict for a single auth mechanism, as reported in the Authentication-Results header.
      */
@@ -439,7 +439,7 @@ distinguishable from a network failure without parsing prose.
     /**
      * Known user-setting keys. Each maps, in the registry, to a required value kind and a zod schema. New keys are added deliberately by extending this enum and the registry — never as an ad-hoc column.
      */
-    export type AccountSettingName = "Theme" | "Density" | "DefaultComposerFormat" | "PinnedFolders" | "AccountSignaturePlainText" | "AccountSignatureHtml" | "AccountDisplayName" | "AccountMuted" | "AccountComposeLanguages" | "MailboxDisplayName" | "MailboxMuted" | "FolderRoleAppointment" | "FolderRoleAppointmentLabel" | "MailboxRole" | "DefaultInvitationSenderAccountId" | "ClassificationPresetId" | "ClassificationModel" | "ClassificationBaseUrl" | "ClassificationApiKey" | "ClassificationEnabled" | "ClassificationDailyLimit" | "ClassificationUsage";
+    export type AccountSettingName = "Theme" | "Density" | "DefaultComposerFormat" | "PinnedFolders" | "AccountSignaturePlainText" | "AccountSignatureHtml" | "AccountDisplayName" | "AccountMuted" | "AccountComposeLanguages" | "MailboxDisplayName" | "MailboxMuted" | "FolderRoleAppointment" | "FolderRoleAppointmentLabel" | "MailboxRole" | "DefaultInvitationSenderAccountId" | "ClassificationPresetId" | "ClassificationModel" | "ClassificationBaseUrl" | "ClassificationApiKey" | "ClassificationEnabled" | "ClassificationDailyLimit" | "ClassificationUsage" | "SpamPlacementSpam" | "SpamPlacementPhishing";
     /**
      * Lifecycle of one applied configuration import. An import is Complete the moment every folder reference in the file has been bound to a real mailbox; until then it is Pending, waiting on the IMAP discovery that will produce those mailboxes.
      */
@@ -3861,6 +3861,10 @@ field on this resource rather than one more operation.
        * The classification provider in effect, `Unrunnable` when one is chosen but cannot run, or `NotConfigured`.
        */
       classification: ClassificationNotConfigured | ClassificationConfigured | ClassificationUnrunnable;
+      /**
+       * How Remit acts on spam verdicts.
+       */
+      spam: SpamSettings;
     }
     /**
      * A classification provider the reader can pick.
@@ -3987,6 +3991,37 @@ field on this resource rather than one more operation.
       presetId: ClassificationPresetId;
       reason: ClassificationUnrunnableReason;
     }
+    /**
+     * How Remit acts on spam verdicts for the caller.
+     */
+    export interface SpamSettings {
+      /**
+       * The thresholds in effect. They come from the deployment (`SPAM_CLEAN_BELOW` and `SPAM_AT`). `Unset` when the deployment uses rspamd, which applies its own.
+       */
+      thresholds: SpamThresholdsUnset | SpamThresholdsSet;
+      /**
+       * What a `Junk` verdict of kind `Spam` does.
+       */
+      spamPlacement: SpamLabelPlacement;
+      /**
+       * What a `Junk` verdict of kind `Phishing` does.
+       */
+      phishingPlacement: SpamLabelPlacement;
+    }
+    /**
+     * No thresholds are set, so every verdict's action is `None` and nothing moves.
+     */
+    export interface SpamThresholdsUnset {
+      state: "Unset";
+    }
+    /**
+     * The two scores that turn a spam score into an action: below `cleanBelow` nothing happens, from `spamAt` up the message goes to Junk, and between the two the owner is warned.
+     */
+    export interface SpamThresholdsSet {
+      state: "Set";
+      cleanBelow: number;
+      spamAt: number;
+    }
     /**
      * A change to the caller's settings. Every field is optional and absence means untouched.
      */
@@ -4019,6 +4054,14 @@ field on this resource rather than one more operation.
        * The most classification calls per mail account per UTC day. Needs a provider in effect, saved or inherited.
        */
       classificationDailyLimit?: number;
+      /**
+       * What a `Junk` verdict of kind `Spam` does: move the message to Junk, or warn only. Applies to mail arriving from now on.
+       */
+      spamPlacementSpam?: SpamLabelPlacement;
+      /**
+       * What a `Junk` verdict of kind `Phishing` does: move the message to Junk, or warn only. Applies to mail arriving from now on.
+       */
+      spamPlacementPhishing?: SpamLabelPlacement;
     }
     /**
      * The classification provider form as it stands, saved or not.
@@ -4100,6 +4143,14 @@ field on this resource rather than one more operation.
        */
       byLabel: ClassifierLabelCount[];
       corrections: ClassifierCorrections;
+      /**
+       * Spam verdicts of action `Warn` or `Junk` per arrival day, action and kind, in date order. A day with none is absent.
+       */
+      spamByDay: SpamDayCount[];
+      /**
+       * Checked messages per spam score band of width 0.05, lowest first. A band with none is absent. Summing the bands from a threshold up counts the messages that threshold reaches.
+       */
+      spamScoreBands: SpamScoreBand[];
     }
     /**
      * Examined messages in one category.
@@ -4128,6 +4179,28 @@ field on this resource rather than one more operation.
        */
       categoryOverridden: number;
     }
+    /**
+     * Spam verdicts on mail that arrived on one day, for one action and kind.
+     */
+    export interface SpamDayCount {
+      /**
+       * The arrival day, YYYY-MM-DD, in the zone offset of `since`.
+       */
+      date: string;
+      /**
+       * `Warn` or `Junk`: the judge's action, before the owner's per-label setting.
+       */
+      action: SpamAction;
+      kind: SpamKind;
+      count: number;
+    }
+    /**
+     * Checked messages whose spam score falls in one band, `from` inclusive to `from + 0.05` exclusive; the last band includes 1.
+     */
+    export interface SpamScoreBand {
+      from: number;
+      count: number;
+    }
     /**
      * Tasks due in the requested window, in due order. Unpaginated: the window is the bound.
      */
@@ -6002,10 +6075,6 @@ either way and cannot tell which it received.
        * Structured sender-authenticity signal derived from DKIM headers at classification time. Absent for messages classified before this field was introduced — absence means no signal.
        */
       authenticity?: MessageAuthenticity;
-      /**
-       * Sender-authenticity tier resolved at body-sync. Defaults to `NotEvaluated`, the named pending state every message written before the derivation existed carries. Top-level rather than a member of `authenticity` on purpose: that blob is absent for all unsigned mail, so a guard keyed on its absence cannot tell "never derived" from "nothing to derive" and would re-derive unsigned mail forever.
-       */
-      authenticityVerdict: AuthenticityVerdict;
       /**
        * Provider authentication-results signal parsed from Authentication-Results header. Absent for messages synced before this field was introduced.
        */
@@ -6193,10 +6262,6 @@ either way and cannot tell which it received.
        * Structured sender-authenticity signal derived from DKIM headers at classification time. Absent for messages classified before this field was introduced — absence means no signal.
        */
       authenticity?: MessageAuthenticity;
-      /**
-       * Sender-authenticity tier resolved at body-sync. Defaults to `NotEvaluated`, the named pending state every message written before the derivation existed carries. Top-level rather than a member of `authenticity` on purpose: that blob is absent for all unsigned mail, so a guard keyed on its absence cannot tell "never derived" from "nothing to derive" and would re-derive unsigned mail forever.
-       */
-      authenticityVerdict: AuthenticityVerdict;
       /**
        * Provider authentication-results signal parsed from Authentication-Results header. Absent for messages synced before this field was introduced.
        */
@@ -9566,7 +9631,7 @@ reader organizes the event, none otherwise.
     config?: AxiosRequestConfig
   ): OperationResponse<Paths.TestClassificationProvider.Responses.$200>;
   /**
-   * ClassificationStatsOperations_getClassificationStats - Count what the classifier decided for mail that arrived on or after `since`, and how often the reader corrected it. Refused with 400 when `since` is not an ISO 8601 date-time with zone offset.
+   * ClassificationStatsOperations_getClassificationStats - Count what the classifier and the spam service decided for mail that arrived on or after `since`, and how often the reader corrected it. Refused with 400 when `since` is not an ISO 8601 date-time with zone offset.
    */
   'ClassificationStatsOperations_getClassificationStats'(
     parameters?: Parameters<Paths.GetClassificationStats.QueryParameters> | null,
@@ -10562,7 +10627,7 @@ reader organizes the event, none otherwise.
   };
   ['/classification-stats']: {
     /**
-     * ClassificationStatsOperations_getClassificationStats - Count what the classifier decided for mail that arrived on or after `since`, and how often the reader corrected it. Refused with 400 when `since` is not an ISO 8601 date-time with zone offset.
+     * ClassificationStatsOperations_getClassificationStats - Count what the classifier and the spam service decided for mail that arrived on or after `since`, and how often the reader corrected it. Refused with 400 when `since` is not an ISO 8601 date-time with zone offset.
      */
     'get'(
       parameters?: Parameters<Paths.GetClassificationStats.QueryParameters> | null,
@@ -12013,6 +12078,9 @@ export type ClassificationSources = Components.Schemas.ClassificationSources;
 export type ClassificationUsage = Components.Schemas.ClassificationUsage;
 export type ClassificationCostPriced = Components.Schemas.ClassificationCostPriced;
 export type ClassificationUnrunnable = Components.Schemas.ClassificationUnrunnable;
+export type SpamSettings = Components.Schemas.SpamSettings;
+export type SpamThresholdsUnset = Components.Schemas.SpamThresholdsUnset;
+export type SpamThresholdsSet = Components.Schemas.SpamThresholdsSet;
 export type UpdateUserSettingsInput = Components.Schemas.UpdateUserSettingsInput;
 export type ClassificationTestInput = Components.Schemas.ClassificationTestInput;
 export type ClassificationTestPassed = Components.Schemas.ClassificationTestPassed;
@@ -12021,6 +12089,8 @@ export type ClassifierStats = Components.Schemas.ClassifierStats;
 export type ClassifierCategoryCount = Components.Schemas.ClassifierCategoryCount;
 export type ClassifierLabelCount = Components.Schemas.ClassifierLabelCount;
 export type ClassifierCorrections = Components.Schemas.ClassifierCorrections;
+export type SpamDayCount = Components.Schemas.SpamDayCount;
+export type SpamScoreBand = Components.Schemas.SpamScoreBand;
 export type CalendarTaskListResponse = Components.Schemas.CalendarTaskListResponse;
 export type CalendarTask = Components.Schemas.CalendarTask;
 export type CalendarTaskResponse = Components.Schemas.CalendarTaskResponse;
@@ -12207,9 +12277,12 @@ export type ClassificationPresetGroup = Components.Schemas.ClassificationPresetG
 export type ClassificationAdapterShape = Components.Schemas.ClassificationAdapterShape;
 export type ClassificationValueSource = Components.Schemas.ClassificationValueSource;
 export type ClassificationUnrunnableReason = Components.Schemas.ClassificationUnrunnableReason;
+export type SpamLabelPlacement = Components.Schemas.SpamLabelPlacement;
 export type ClassificationFailureKind = Components.Schemas.ClassificationFailureKind;
 export type ClassificationField = Components.Schemas.ClassificationField;
 export type MessageCategory = Components.Schemas.MessageCategory;
+export type SpamAction = Components.Schemas.SpamAction;
+export type SpamKind = Components.Schemas.SpamKind;
 export type SortOrder = Components.Schemas.SortOrder;
 export type StarColor = Components.Schemas.StarColor;
 export type SenderTrust = Components.Schemas.SenderTrust;
@@ -12220,8 +12293,6 @@ export type MessageMutation = Components.Schemas.MessageMutation;
 export type PlacementAction = Components.Schemas.PlacementAction;
 export type PlacementConfidence = Components.Schemas.PlacementConfidence;
 export type SpamSenderScreenRule = Components.Schemas.SpamSenderScreenRule;
-export type SpamAction = Components.Schemas.SpamAction;
-export type SpamKind = Components.Schemas.SpamKind;
 export type SpamReasonName = Components.Schemas.SpamReasonName;
 export type SpamModelOutcome = Components.Schemas.SpamModelOutcome;
 export type SpamFailureKind = Components.Schemas.SpamFailureKind;
@@ -12229,7 +12300,6 @@ export type OutboxAttachmentState = Components.Schemas.OutboxAttachmentState;
 export type OutboxAttachmentRejectionReason = Components.Schemas.OutboxAttachmentRejectionReason;
 export type AddressFlagKey = Components.Schemas.AddressFlagKey;
 export type MessageClassificationState = Components.Schemas.MessageClassificationState;
-export type AuthenticityVerdict = Components.Schemas.AuthenticityVerdict;
 export type AuthResultVerdict = Components.Schemas.AuthResultVerdict;
 export type AddressRole = Components.Schemas.AddressRole;
 export type MediaType = Components.Schemas.MediaType;