@cosmicdrift/kumiko-bundled-features 0.392.2 → 0.393.0

package/dist/inbound-mail-foundation/handlers/connect-account.write.js

@@ -26,7 +26,7 @@ export const connectAccountSchema = z.object({
         InboundMailAuthMethods.xoauth2,
         InboundMailAuthMethods.oauth,
     ]),
-    displayName: z.string().max(200),
+    displayName: z.string().trim().max(200),
     /** Mailbox address in plaintext; it is encrypted here. */
     address: z.string().min(1).max(320),
     /** "shared" = shared across the tenant (info@) · "user" = the caller's

package/dist/inbound-mail-foundation/handlers/update-account.write.js

@@ -20,7 +20,7 @@ export const updateAccountSchema = z.object({
         .optional(),
     /** Ops-Signal ("idle", "watching", "backoff:3", ...). */
     watchState: z.string().max(100).optional(),
-    displayName: z.string().max(200).optional(),
+    displayName: z.string().trim().max(200).optional(),
     /** Audit reason for metadata.headers, honored for the system identity only
      *  ("watch_supervisor", "oauth_refresh"); user callers get a role-derived reason. */
     reason: z.string().min(1).max(100).optional(),

package/dist/inbound-mail-foundation/i18n.js

@@ -27,6 +27,7 @@ export const INBOUND_MAIL_FOUNDATION_I18N = {
         en: "Disconnected",
     },
     "inboundMail.accounts.connectImap": { en: "Connect mailbox" },
+    "inboundMail.accounts.reconnect": { en: "Reconnect" },
     "inboundMail.accounts.edit": { en: "Rename" },
     "inboundMail.accounts.edit.submit": { en: "Save" },
     "inboundMail.accounts.disconnect": { en: "Disconnect" },

package/dist/inbound-mail-foundation/index.d.ts

@@ -9,7 +9,7 @@ export { type OAuthStatePayload, signOAuthState, type VerifyOAuthStateResult, ve
 export { isMailSendNotConfiguredError, isMailSendRejectedError, MailSendNotConfiguredError, MailSendRejectedError, type OutboundMailMessage, type OutboundMailSent, outboundMailMessageSchema, } from "./outbound-mail.ts";
 export { inboundMessagesProjectionTable, mailAccountsProjectionTable, mailThreadsProjectionTable, } from "./projection.ts";
 export { resolveInboundProviderForAccount, resolveInboundProviderForKey, } from "./provider-factory.ts";
-export { IMAP_CONNECT_SCREEN_ID, MAIL_ACCOUNT_EDIT_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_QN, } from "./screens.ts";
+export { IMAP_CONNECT_SCREEN_ID, IMAP_RECONNECT_SCREEN_ID, MAIL_ACCOUNT_EDIT_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_QN, } from "./screens.ts";
 export { MAIL_SEND_ERRORS, type MailSendFailure, type SendMailFromAccountContext, type SendMailFromAccountInput, sendMailFromAccount, } from "./send-from-account.ts";
 export { InboundAuthError, InboundCursorInvalidError, type InboundFetchResult, type InboundMailContext, type InboundMailProviderPlugin, type InboundOAuthFlow, InboundRateLimitError, InboundTransientError, isInboundAuthError, isInboundCursorInvalidError, isInboundMailProviderPlugin, isInboundRateLimitError, isInboundTransientError, type MailAccountRecord, type OAuthTokenSet, type RawInboundMessage, type SyncCursorPayload, } from "./types.ts";
 export { createInboundMailSupervisor, type InboundMailSupervisor, type InboundMailSupervisorDeps, } from "./watch-supervisor.ts";

package/dist/inbound-mail-foundation/index.js

@@ -10,7 +10,7 @@ export { signOAuthState, verifyOAuthState, } from "./oauth-state.js";
 export { isMailSendNotConfiguredError, isMailSendRejectedError, MailSendNotConfiguredError, MailSendRejectedError, outboundMailMessageSchema, } from "./outbound-mail.js";
 export { inboundMessagesProjectionTable, mailAccountsProjectionTable, mailThreadsProjectionTable, } from "./projection.js";
 export { resolveInboundProviderForAccount, resolveInboundProviderForKey, } from "./provider-factory.js";
-export { IMAP_CONNECT_SCREEN_ID, MAIL_ACCOUNT_EDIT_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_QN, } from "./screens.js";
+export { IMAP_CONNECT_SCREEN_ID, IMAP_RECONNECT_SCREEN_ID, MAIL_ACCOUNT_EDIT_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_QN, } from "./screens.js";
 export { MAIL_SEND_ERRORS, sendMailFromAccount, } from "./send-from-account.js";
 export { InboundAuthError, InboundCursorInvalidError, InboundRateLimitError, InboundTransientError, isInboundAuthError, isInboundCursorInvalidError, isInboundMailProviderPlugin, isInboundRateLimitError, isInboundTransientError, } from "./types.js";
 export { createInboundMailSupervisor, } from "./watch-supervisor.js";

package/dist/inbound-mail-foundation/screens.d.ts

@@ -4,6 +4,7 @@ export declare const MAIL_ACCOUNT_LIST_SCREEN_ID = "mail-accounts";
 export declare const MAIL_ACCOUNT_EDIT_SCREEN_ID = "mail-account-edit";
 export declare const MAIL_ACCOUNT_LIST_SCREEN_QN = "inbound-mail-foundation:screen:mail-accounts";
 export declare const IMAP_CONNECT_SCREEN_ID = "mail-account-connect-imap";
+export declare const IMAP_RECONNECT_SCREEN_ID = "mail-account-reconnect-imap";
 export declare const MAIL_ACCOUNT_STATUS_OPTION_KEY_PREFIX = "inboundMail.accounts.status.";
 export declare const mailAccountListScreen: ProjectionListScreenDefinition;
 export declare const mailAccountEditScreen: ActionFormScreenDefinition;

package/dist/inbound-mail-foundation/screens.js

@@ -7,6 +7,8 @@ export const MAIL_ACCOUNT_LIST_SCREEN_QN = "inbound-mail-foundation:screen:mail-
 // renderer drops a navigate action whose target screen is not mounted, so the toolbar button
 // only shows in apps that mount that provider.
 export const IMAP_CONNECT_SCREEN_ID = "mail-account-connect-imap";
+// Same reason for the row action "Reconnect" on an account with a sign-in error.
+export const IMAP_RECONNECT_SCREEN_ID = "mail-account-reconnect-imap";
 export const MAIL_ACCOUNT_STATUS_OPTION_KEY_PREFIX = "inboundMail.accounts.status.";
 // Same roles as the update/disconnect handlers: a screen rule wider than the
 // handlers would only render actions that 403.
@@ -54,6 +56,15 @@ export const mailAccountListScreen = {
             params: { map: { accountId: "id", displayName: "displayName" } },
             visible: { field: "status", ne: InboundMailAccountStatuses.disconnected },
         },
+        {
+            kind: "navigate",
+            id: "reconnect",
+            label: i18nKey("inboundMail.accounts.reconnect"),
+            screen: IMAP_RECONNECT_SCREEN_ID,
+            entityId: "id",
+            // The handler rejects accounts of other providers; the row condition cannot combine fields.
+            visible: { field: "status", eq: InboundMailAccountStatuses.authError },
+        },
         {
             kind: "writeHandler",
             id: "disconnect",

package/dist/inbound-provider-imap/connect-mailbox.d.ts

@@ -1,6 +1,7 @@
+import { type BeforeTransactionResult } from "@cosmicdrift/kumiko-framework/engine";
 import * as z from "zod";
 import { type ImapCredentialDocument } from "./credential-document.ts";
-declare const connectMailboxSchema: z.ZodObject<{
+export declare const connectMailboxSchema: z.ZodObject<{
     host: z.ZodString;
     port: z.ZodDefault<z.ZodNumber>;
     user: z.ZodString;
@@ -10,9 +11,13 @@ declare const connectMailboxSchema: z.ZodObject<{
     smtpHost: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>>>;
     smtpPort: z.ZodNumber;
 }, z.core.$strip>;
-type ConnectMailboxPayload = z.infer<typeof connectMailboxSchema>;
+type ConnectMailboxLoginFields = Pick<z.infer<typeof connectMailboxSchema>, "host" | "port" | "user" | "password" | "smtpHost" | "smtpPort">;
+export declare const CREDENTIAL_PREVIEW = "IMAP login";
 export declare function deriveSmtpHost(imapHost: string): string;
-export declare function credentialDocumentOf(payload: ConnectMailboxPayload): ImapCredentialDocument;
+export declare function credentialDocumentOf(payload: ConnectMailboxLoginFields): ImapCredentialDocument;
+export declare function checkMailboxLogin(doc: ImapCredentialDocument, log: {
+    warn(message: string, data?: Record<string, unknown>): void;
+}): Promise<BeforeTransactionResult<null>>;
 export declare const connectMailboxHandler: import("@cosmicdrift/kumiko-types/define-handler").WriteHandlerDefinition<"connect-mailbox", z.ZodObject<{
     host: z.ZodString;
     port: z.ZodDefault<z.ZodNumber>;

package/dist/inbound-provider-imap/connect-mailbox.js

@@ -14,10 +14,10 @@ import { SmtpFailureError, verifySmtpLogin } from "./smtp-client.js";
 // No `secure`: the password never crosses the wire in clear text, so a payload's secure:false is
 // stripped like any unknown key. IMAP uses implicit TLS; SMTP uses implicit TLS on 465 and
 // enforced STARTTLS on every other port.
-const connectMailboxSchema = imapCredentialDocumentSchema
+export const connectMailboxSchema = imapCredentialDocumentSchema
     .pick({ host: true, port: true, user: true })
     .extend({
-    displayName: z.string().min(1).max(200),
+    displayName: z.string().trim().min(1).max(200),
     address: z.email().max(320),
     password: z.string().min(1).max(1000),
     smtpHost: z.union([z.literal(""), smtpHostSchema]).nullish(),
@@ -29,7 +29,7 @@ const connectedAccountSchema = z.object({ accountId: z.string() });
 // BoringSSL (Bun) spells the handshake error WRONG_VERSION_NUMBER, OpenSSL (Node) with spaces.
 const TLS_FAILURE = /certificate|self[- ]signed|wrong[ _]version[ _]number|EPROTO|ERR_SSL|ERR_TLS/i;
 // A fixed preview: any slice of the JSON document would expose the host or the user.
-const CREDENTIAL_PREVIEW = "IMAP login";
+export const CREDENTIAL_PREVIEW = "IMAP login";
 const SECRET_TRANSACTION_REASON = "the credential secret is written on the request transaction so a failed account connect rolls it back too";
 // Most hosters name the outgoing server like the incoming one, or with smtp. for imap.
 export function deriveSmtpHost(imapHost) {
@@ -73,6 +73,24 @@ async function checkSmtpLogin(doc) {
         throw err;
     }
 }
+// Checks the IMAP login, then the SMTP login of the outgoing server; shared by connect and reconnect.
+export async function checkMailboxLogin(doc, log) {
+    try {
+        await connectOnce(doc, true);
+    }
+    catch (err) {
+        const { reason, i18nKey } = IMAP_CONNECT_ERRORS[imapConnectFailureOf(err)];
+        log.warn("imap connect check failed", { reason });
+        return writeFailure(new UnprocessableError(reason, { i18nKey }));
+    }
+    const smtpFailure = await checkSmtpLogin(doc);
+    if (smtpFailure) {
+        const { reason, i18nKey } = SMTP_CONNECT_ERRORS[smtpFailure];
+        log.warn("smtp connect check failed", { reason });
+        return writeFailure(new UnprocessableError(reason, { i18nKey, i18nParams: { port: doc.smtpPort } }));
+    }
+    return { isSuccess: true, data: null };
+}
 export const connectMailboxHandler = defineWriteHandler({
     name: "connect-mailbox",
     description: "Connects a shared IMAP mailbox with a password over implicit TLS: checks the IMAP login and the SMTP login of the outgoing server (given, or derived from the IMAP host) first, then creates the mail account and stores both servers, user and password as its credential secret in one step.",
@@ -84,24 +102,7 @@ export const connectMailboxHandler = defineWriteHandler({
     // used to scan ports or to guess passwords at someone else's mail server.
     rateLimit: { per: "tenant+handler", limit: 10, windowSeconds: 600 },
     escapeHatch: { grants: ["unsafeRaw"], reason: SECRET_TRANSACTION_REASON },
-    beforeTransaction: async (event, ctx) => {
-        const doc = credentialDocumentOf(event.payload);
-        try {
-            await connectOnce(doc, true);
-        }
-        catch (err) {
-            const { reason, i18nKey } = IMAP_CONNECT_ERRORS[imapConnectFailureOf(err)];
-            ctx.obs.log.warn("imap connect check failed", { reason });
-            return writeFailure(new UnprocessableError(reason, { i18nKey }));
-        }
-        const smtpFailure = await checkSmtpLogin(doc);
-        if (smtpFailure) {
-            const { reason, i18nKey } = SMTP_CONNECT_ERRORS[smtpFailure];
-            ctx.obs.log.warn("smtp connect check failed", { reason });
-            return writeFailure(new UnprocessableError(reason, { i18nKey, i18nParams: { port: doc.smtpPort } }));
-        }
-        return { isSuccess: true, data: null };
-    },
+    beforeTransaction: (event, ctx) => checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log),
     handler: async (event, ctx) => {
         const { displayName, address } = event.payload;
         const connected = await ctx.dispatch.write(InboundMailFoundationHandlers.connectAccount, {

package/dist/inbound-provider-imap/constants.d.ts

@@ -2,6 +2,16 @@ export declare const FEATURE_NAME = "inbound-provider-imap";
 export declare const IMAP_PROVIDER_KEY = "imap";
 export declare const ImapHandlers: {
     readonly connectMailbox: "inbound-provider-imap:write:connect-mailbox";
+    readonly reconnectMailbox: "inbound-provider-imap:write:reconnect-mailbox";
+};
+export declare const ImapQueries: {
+    readonly reconnectPrefill: "inbound-provider-imap:query:reconnect-prefill";
+};
+export declare const IMAP_RECONNECT_ERRORS: {
+    readonly notPasswordImap: {
+        readonly reason: "reconnect_not_password_imap";
+        readonly i18nKey: "inboundMail.imap.reconnect.errors.notPasswordImap";
+    };
 };
 export declare const IMAP_CONNECT_ERRORS: {
     readonly hostUnreachable: {

package/dist/inbound-provider-imap/constants.js

@@ -2,6 +2,16 @@ export const FEATURE_NAME = "inbound-provider-imap";
 export const IMAP_PROVIDER_KEY = "imap";
 export const ImapHandlers = {
     connectMailbox: "inbound-provider-imap:write:connect-mailbox",
+    reconnectMailbox: "inbound-provider-imap:write:reconnect-mailbox",
+};
+export const ImapQueries = {
+    reconnectPrefill: "inbound-provider-imap:query:reconnect-prefill",
+};
+export const IMAP_RECONNECT_ERRORS = {
+    notPasswordImap: {
+        reason: "reconnect_not_password_imap",
+        i18nKey: "inboundMail.imap.reconnect.errors.notPasswordImap",
+    },
 };
 export const IMAP_CONNECT_ERRORS = {
     hostUnreachable: {

package/dist/inbound-provider-imap/feature.js

@@ -32,7 +32,9 @@ import { FEATURE_NAME, IMAP_PROVIDER_KEY } from "./constants.js";
 import { readCredentialDocument } from "./credential-document.js";
 import { INBOUND_PROVIDER_IMAP_I18N } from "./i18n.js";
 import { assertUidValidity, coerceDate, connectOnce, createImapClient, IMAP_MAILBOX, imapMailHostGuard, mapImapError, parseImapCursor, toRawInboundMessage, } from "./imap-client.js";
-import { imapConnectScreen } from "./screens.js";
+import { reconnectMailboxHandler } from "./reconnect-mailbox.js";
+import { reconnectPrefillQuery } from "./reconnect-prefill.query.js";
+import { imapConnectScreen, imapReconnectScreen } from "./screens.js";
 import { sendFromImapAccount } from "./send-mail.js";
 export { IMAP_PROVIDER_KEY } from "./constants.js";
 export { setImapMailHostLookup } from "./imap-client.js";
@@ -198,7 +200,7 @@ export const imapInboundMailPlugin = {
 };
 export function createInboundProviderImapFeature() {
     return defineFeature(FEATURE_NAME, (r) => {
-        r.describe('Registers the `"imap"` provider for `inbound-mail-foundation` using imapflow — password/app-password auth covers classic IMAP hosts without any OAuth (plus an XOAUTH2 fallback consuming an access token from the secret slot). Incremental sync via a UIDVALIDITY:lastUid cursor (UIDVALIDITY change triggers a cursor-invalid full resync), initial backfill bounded by the foundation backfill window, and live push via IMAP IDLE for the watch supervisor. Tenant admins connect a mailbox through the "Connect mailbox" form on the mail accounts list (`connect-mailbox` checks the IMAP login and the SMTP login of the outgoing server first, then creates the account and its credential secret in one transaction); programmatic setups store the per-account connection JSON (host/port/secure/user/password, plus smtpHost/smtpPort for sending) in the account credential secret slot before the first sync. Implements the provider `send`: `sendMailFromAccount` sends over the SMTP server of the mailbox itself (implicit TLS, same login) with the mailbox address as From and stores a copy in its sent folder.');
+        r.describe('Registers the `"imap"` provider for `inbound-mail-foundation` using imapflow — password/app-password auth covers classic IMAP hosts without any OAuth (plus an XOAUTH2 fallback consuming an access token from the secret slot). Incremental sync via a UIDVALIDITY:lastUid cursor (UIDVALIDITY change triggers a cursor-invalid full resync), initial backfill bounded by the foundation backfill window, and live push via IMAP IDLE for the watch supervisor. Tenant admins connect a mailbox through the "Connect mailbox" form on the mail accounts list (`connect-mailbox` checks the IMAP login and the SMTP login of the outgoing server first, then creates the account and its credential secret in one transaction; `reconnect-mailbox` does the same check for an existing mailbox with a sign-in error and overwrites its credential secret); programmatic setups store the per-account connection JSON (host/port/secure/user/password, plus smtpHost/smtpPort for sending) in the account credential secret slot before the first sync. Implements the provider `send`: `sendMailFromAccount` sends over the SMTP server of the mailbox itself (implicit TLS, same login) with the mailbox address as From and stores a copy in its sent folder.');
         r.uiHints({
             displayLabel: "Inbound Mail · IMAP",
             category: "notifications",
@@ -209,7 +211,10 @@ export function createInboundProviderImapFeature() {
         r.envSchema(mailAllowedPrivateHostsEnvSchema);
         r.useExtension(INBOUND_MAIL_PROVIDER_EXTENSION, IMAP_PROVIDER_KEY, imapInboundMailPlugin);
         r.writeHandler(connectMailboxHandler);
+        r.writeHandler(reconnectMailboxHandler);
+        r.queryHandler(reconnectPrefillQuery);
         r.screen(imapConnectScreen);
+        r.screen(imapReconnectScreen);
         r.translations({ keys: INBOUND_PROVIDER_IMAP_I18N });
     }, { dedupeOptions: {} });
 }

package/dist/inbound-provider-imap/i18n.js

@@ -1,10 +1,12 @@
-import { IMAP_CONNECT_SCREEN_ID } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
+import { IMAP_CONNECT_SCREEN_ID, IMAP_RECONNECT_SCREEN_ID, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
 import { ACTION_FORM_ENTITY } from "@cosmicdrift/kumiko-framework/ui-types";
 import { fieldLabelKey } from "@cosmicdrift/kumiko-renderer/headless";
-import { FEATURE_NAME, IMAP_CONNECT_ERRORS, SMTP_CONNECT_ERRORS } from "./constants.js";
+import { FEATURE_NAME, IMAP_CONNECT_ERRORS, IMAP_RECONNECT_ERRORS, SMTP_CONNECT_ERRORS, } from "./constants.js";
 const formFieldKey = (field) => fieldLabelKey(FEATURE_NAME, ACTION_FORM_ENTITY, field);
 export const INBOUND_PROVIDER_IMAP_I18N = {
     [`screen:${IMAP_CONNECT_SCREEN_ID}.title`]: { en: "Connect mailbox" },
+    [`screen:${IMAP_RECONNECT_SCREEN_ID}.title`]: { en: "Reconnect mailbox" },
+    [formFieldKey("accountId")]: { en: "Mailbox" },
     [formFieldKey("displayName")]: { en: "Name" },
     [formFieldKey("address")]: { en: "Email address" },
     [formFieldKey("host")]: { en: "IMAP server" },
@@ -19,6 +21,13 @@ export const INBOUND_PROVIDER_IMAP_I18N = {
         en: "Replies go out from this address over your own mail server, with the same user name and password. Leave the field empty if the server is called like the IMAP server, with smtp. instead of imap. Usually 587, even when your provider lists 465/SSL.",
     },
     "inboundMail.imap.connect.submit": { en: "Check and connect" },
+    "inboundMail.imap.reconnect.hint": {
+        en: "The sign-in is checked before saving. Then the system fetches the mail again.",
+    },
+    "inboundMail.imap.reconnect.submit": { en: "Check and reconnect" },
+    [IMAP_RECONNECT_ERRORS.notPasswordImap.i18nKey]: {
+        en: "Only password IMAP mailboxes can be reconnected here.",
+    },
     [IMAP_CONNECT_ERRORS.hostUnreachable.i18nKey]: {
         en: "The IMAP server cannot be reached or is not allowed. Check the server name.",
     },

package/dist/inbound-provider-imap/reconnect-account.d.ts

@@ -0,0 +1,15 @@
+import type { TenantDb } from "@cosmicdrift/kumiko-framework/db";
+import { type WriteFailure } from "@cosmicdrift/kumiko-framework/errors";
+type ReconnectAccountRow = {
+    readonly id: string;
+    readonly provider: string;
+    readonly authMethod: string;
+    readonly displayName: string | null;
+    readonly status: string | null;
+};
+export type ReconnectAccountLookup = {
+    readonly isSuccess: true;
+    readonly row: ReconnectAccountRow;
+} | WriteFailure;
+export declare function findReconnectableAccount(db: Pick<TenantDb, "fetchOne">, accountId: string): Promise<ReconnectAccountLookup>;
+export {};

package/dist/inbound-provider-imap/reconnect-account.js

@@ -0,0 +1,20 @@
+// Loads the mailbox a reconnect targets. The db is tenant-scoped, so another tenant's account id
+// finds nothing.
+import { InboundMailAccountStatuses, InboundMailAuthMethods, mailAccountsProjectionTable, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
+import { failNotFound, failUnprocessable, UnprocessableError, writeFailure, } from "@cosmicdrift/kumiko-framework/errors";
+import { IMAP_PROVIDER_KEY, IMAP_RECONNECT_ERRORS } from "./constants.js";
+export async function findReconnectableAccount(db, accountId) {
+    const row = await db.fetchOne(mailAccountsProjectionTable, {
+        id: accountId,
+    });
+    if (!row)
+        return failNotFound("mail-account", accountId);
+    if (row.status === InboundMailAccountStatuses.disconnected) {
+        return failUnprocessable("account_disconnected", { accountId });
+    }
+    if (row.provider !== IMAP_PROVIDER_KEY || row.authMethod !== InboundMailAuthMethods.password) {
+        const { reason, i18nKey } = IMAP_RECONNECT_ERRORS.notPasswordImap;
+        return writeFailure(new UnprocessableError(reason, { i18nKey, details: { accountId } }));
+    }
+    return { isSuccess: true, row };
+}

package/dist/inbound-provider-imap/reconnect-mailbox.d.ts

@@ -0,0 +1,12 @@
+import * as z from "zod";
+export declare const reconnectMailboxHandler: import("@cosmicdrift/kumiko-types/define-handler").WriteHandlerDefinition<"reconnect-mailbox", z.ZodObject<{
+    host: z.ZodString;
+    port: z.ZodDefault<z.ZodNumber>;
+    user: z.ZodString;
+    password: z.ZodString;
+    smtpHost: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodString]>>>;
+    smtpPort: z.ZodNumber;
+    accountId: z.ZodUUID;
+}, z.core.$strip>, {
+    accountId: string;
+}, import("@cosmicdrift/kumiko-types/event-type-map").KumikoEventTypeMap, null>;

package/dist/inbound-provider-imap/reconnect-mailbox.js

@@ -0,0 +1,48 @@
+// reconnect-mailbox: new credentials for an existing password IMAP mailbox, typically after the
+// account went to auth_error. The login is checked before the transaction opens; only then the
+// account goes back to active and the credential secret of the same account is overwritten, both
+// on the request transaction, so a failure leaves status and secret as they were.
+import { InboundMailAccountStatuses, InboundMailFoundationHandlers, inboundCredentialSecretKey, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
+import { requireSecretsContext } from "@cosmicdrift/kumiko-bundled-features/secrets";
+import { defineWriteHandler, } from "@cosmicdrift/kumiko-framework/engine";
+import * as z from "zod";
+import { CREDENTIAL_PREVIEW, checkMailboxLogin, connectMailboxSchema, credentialDocumentOf, } from "./connect-mailbox.js";
+import { findReconnectableAccount } from "./reconnect-account.js";
+const reconnectMailboxSchema = connectMailboxSchema
+    .pick({ host: true, port: true, user: true, password: true, smtpHost: true, smtpPort: true })
+    .extend({ accountId: z.uuid() });
+const SECRET_TRANSACTION_REASON = "the credential secret is written on the request transaction so a failed reconnect rolls the account status back too";
+export const reconnectMailboxHandler = defineWriteHandler({
+    name: "reconnect-mailbox",
+    description: "Replaces the credentials of an existing password IMAP mailbox: checks the IMAP login and the SMTP login of the outgoing server first, then overwrites the credential secret of the same account and sets it back to active, keeping its threads and sync cursor.",
+    // The payload carries the plaintext password: as a tool call it would reach the model provider.
+    agent: { expose: false },
+    schema: reconnectMailboxSchema,
+    access: { roles: ["SystemAdmin", "TenantAdmin"] },
+    // Same cap as connect: each call opens a connection to a host the caller picks.
+    rateLimit: { per: "tenant+handler", limit: 10, windowSeconds: 600 },
+    escapeHatch: { grants: ["unsafeRaw"], reason: SECRET_TRANSACTION_REASON },
+    beforeTransaction: async (event, ctx) => {
+        const lookup = await findReconnectableAccount(ctx.db, event.payload.accountId);
+        if (!lookup.isSuccess)
+            return lookup;
+        return checkMailboxLogin(credentialDocumentOf(event.payload), ctx.obs.log);
+    },
+    handler: async (event, ctx) => {
+        const { accountId } = event.payload;
+        const reactivated = await ctx.dispatch.write(InboundMailFoundationHandlers.updateAccount, {
+            accountId,
+            status: InboundMailAccountStatuses.active,
+            watchState: "idle",
+        });
+        if (!reactivated.isSuccess)
+            return reactivated;
+        const secrets = requireSecretsContext({ secrets: ctx.services.secrets, user: ctx.user }, "reconnect-mailbox").withRunner(ctx.db.unsafeRaw());
+        await secrets.set(event.user.tenantId, inboundCredentialSecretKey(accountId), JSON.stringify(credentialDocumentOf(event.payload)), {
+            redact: () => CREDENTIAL_PREVIEW,
+            hint: `IMAP credentials for inbound mail account ${accountId}`,
+            updatedBy: event.user.id,
+        });
+        return { isSuccess: true, data: { accountId } };
+    },
+});

package/dist/inbound-provider-imap/reconnect-prefill.query.d.ts

@@ -0,0 +1,2 @@
+import type { QueryHandlerDef } from "@cosmicdrift/kumiko-framework/engine";
+export declare const reconnectPrefillQuery: QueryHandlerDef;

package/dist/inbound-provider-imap/reconnect-prefill.query.js

@@ -0,0 +1,31 @@
+// Initial values of the reconnect form: the server settings of the stored credential, never the
+// password. A missing or unreadable credential leaves the fields empty for the admin to fill in.
+import { inboundCredentialSecretKey } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
+import { requireSecretsContext } from "@cosmicdrift/kumiko-bundled-features/secrets";
+import * as z from "zod";
+import { FEATURE_NAME } from "./constants.js";
+import { parseImapCredentialDocument } from "./credential-document.js";
+import { findReconnectableAccount } from "./reconnect-account.js";
+const reconnectPrefillSchema = z.object({ accountId: z.uuid() }).strict();
+export const reconnectPrefillQuery = {
+    name: "reconnect-prefill",
+    schema: reconnectPrefillSchema,
+    access: { roles: ["SystemAdmin", "TenantAdmin"] },
+    // Only the reconnect form needs these settings; the agent has no write to use them with.
+    agent: { expose: false },
+    description: "Returns the server settings (IMAP host and port, user name, SMTP host and port) stored for a password IMAP mailbox without its password, or null when the mailbox is not found, disconnected or not a password IMAP mailbox; use it to prefill the reconnect form.",
+    handler: async (query, ctx) => {
+        const { accountId } = reconnectPrefillSchema.parse(query.payload);
+        const lookup = await findReconnectableAccount(ctx.db, accountId);
+        if (!lookup.isSuccess)
+            return null;
+        const secrets = requireSecretsContext({ secrets: ctx.services.secrets, user: ctx.user }, FEATURE_NAME);
+        const stored = await secrets.get(ctx.user.tenantId, inboundCredentialSecretKey(accountId));
+        const parsed = stored ? parseImapCredentialDocument(stored.reveal()) : undefined;
+        const displayName = lookup.row.displayName ?? "";
+        if (!parsed?.ok)
+            return { accountId, displayName };
+        const { host, port, user, smtpHost, smtpPort } = parsed.doc;
+        return { accountId, displayName, host, port, user, smtpHost, smtpPort };
+    },
+};

package/dist/inbound-provider-imap/screens.d.ts

@@ -1,2 +1,3 @@
 import type { ActionFormScreenDefinition } from "@cosmicdrift/kumiko-framework/ui-types";
 export declare const imapConnectScreen: ActionFormScreenDefinition;
+export declare const imapReconnectScreen: ActionFormScreenDefinition;

package/dist/inbound-provider-imap/screens.js

@@ -1,6 +1,6 @@
-import { IMAP_CONNECT_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_QN, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
+import { IMAP_CONNECT_SCREEN_ID, IMAP_RECONNECT_SCREEN_ID, MAIL_ACCOUNT_LIST_SCREEN_QN, } from "@cosmicdrift/kumiko-bundled-features/inbound-mail-foundation";
 import { i18nKey } from "@cosmicdrift/kumiko-framework/engine";
-import { ImapHandlers, SMTP_SUBMISSION_PORT } from "./constants.js";
+import { ImapHandlers, ImapQueries, SMTP_SUBMISSION_PORT } from "./constants.js";
 // Reached from the toolbar of the foundation's mail account list, never from the nav.
 export const imapConnectScreen = {
     id: IMAP_CONNECT_SCREEN_ID,
@@ -11,13 +11,22 @@ export const imapConnectScreen = {
         displayName: { type: "text", required: true, maxLength: 200 },
         address: { type: "text", required: true, maxLength: 320, format: "email" },
         host: { type: "text", required: true, maxLength: 255 },
-        port: { type: "number", integer: true, required: true, min: 1, max: 65535, default: 993 },
+        port: {
+            type: "number",
+            integer: true,
+            grouping: false,
+            required: true,
+            min: 1,
+            max: 65535,
+            default: 993,
+        },
         user: { type: "text", required: true, maxLength: 320 },
         password: { type: "text", required: true, format: "password", sensitive: true },
         smtpHost: { type: "text", maxLength: 255 },
         smtpPort: {
             type: "number",
             integer: true,
+            grouping: false,
             required: true,
             min: 1,
             max: 65535,
@@ -45,3 +54,65 @@ export const imapConnectScreen = {
     access: { roles: ["SystemAdmin", "TenantAdmin"] },
     dormant: true,
 };
+// Reached from the "Reconnect" row action of an account with a sign-in error. The record id comes
+// from the path; the load query returns the stored server settings, never the password.
+export const imapReconnectScreen = {
+    id: IMAP_RECONNECT_SCREEN_ID,
+    type: "actionForm",
+    agent: { expose: false },
+    handler: ImapHandlers.reconnectMailbox,
+    load: { query: ImapQueries.reconnectPrefill, idParam: "accountId" },
+    fields: {
+        accountId: { type: "text", required: true },
+        displayName: { type: "text", maxLength: 200 },
+        host: { type: "text", required: true, maxLength: 255 },
+        port: {
+            type: "number",
+            integer: true,
+            grouping: false,
+            required: true,
+            min: 1,
+            max: 65535,
+            default: 993,
+        },
+        user: { type: "text", required: true, maxLength: 320 },
+        password: { type: "text", required: true, format: "password", sensitive: true },
+        smtpHost: { type: "text", maxLength: 255 },
+        smtpPort: {
+            type: "number",
+            integer: true,
+            grouping: false,
+            required: true,
+            min: 1,
+            max: 65535,
+            default: SMTP_SUBMISSION_PORT,
+        },
+    },
+    layout: {
+        sections: [
+            {
+                title: i18nKey("inboundMail.imap.connect.server"),
+                description: i18nKey("inboundMail.imap.reconnect.hint"),
+                // The id only travels in the payload; the admin recognises the mailbox by its name.
+                fields: [
+                    { field: "accountId", visible: false },
+                    { field: "displayName", readOnly: true, submit: false },
+                    "host",
+                    "port",
+                    "user",
+                    "password",
+                ],
+            },
+            {
+                title: i18nKey("inboundMail.imap.connect.outgoing"),
+                description: i18nKey("inboundMail.imap.connect.outgoingHint"),
+                fields: ["smtpHost", "smtpPort"],
+            },
+        ],
+    },
+    submitLabel: i18nKey("inboundMail.imap.reconnect.submit"),
+    redirect: MAIL_ACCOUNT_LIST_SCREEN_QN,
+    cancelTarget: MAIL_ACCOUNT_LIST_SCREEN_QN,
+    access: { roles: ["SystemAdmin", "TenantAdmin"] },
+    dormant: true,
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cosmicdrift/kumiko-bundled-features",
-  "version": "0.392.2",
+  "version": "0.393.0",
   "description": "Built-in features — tenant, user, auth, delivery. The stuff you'd rewrite anyway, already typed.",
   "license": "MIT",
   "author": "Marc Frost <marc@cosmicdriftgamestudio.com>",
@@ -558,9 +558,9 @@
     }
   },
   "dependencies": {
-    "@cosmicdrift/kumiko-framework": "0.392.2",
-    "@cosmicdrift/kumiko-renderer": "0.392.2",
-    "@cosmicdrift/kumiko-types": "0.392.2",
+    "@cosmicdrift/kumiko-framework": "0.393.0",
+    "@cosmicdrift/kumiko-renderer": "0.393.0",
+    "@cosmicdrift/kumiko-types": "0.393.0",
     "@mollie/api-client": "^4.5.0",
     "@node-rs/argon2": "^2.0.2",
     "@tiptap/core": "^3.31.3",
@@ -1142,17 +1142,17 @@
   ],
   "devDependencies": {
     "@testing-library/user-event": "^14.6.1",
-    "@cosmicdrift/kumiko-locale-de": "0.392.2",
-    "@cosmicdrift/kumiko-locale-es": "0.392.2",
-    "@cosmicdrift/kumiko-locale-fr": "0.392.2",
-    "@cosmicdrift/kumiko-locale-it": "0.392.2",
-    "@cosmicdrift/kumiko-renderer-mail-html": "0.392.2",
+    "@cosmicdrift/kumiko-locale-de": "0.393.0",
+    "@cosmicdrift/kumiko-locale-es": "0.393.0",
+    "@cosmicdrift/kumiko-locale-fr": "0.393.0",
+    "@cosmicdrift/kumiko-locale-it": "0.393.0",
+    "@cosmicdrift/kumiko-renderer-mail-html": "0.393.0",
     "jsqr": "^1.4.0",
     "unpdf": "^1.8.1",
-    "@cosmicdrift/kumiko-testing": "0.392.2"
+    "@cosmicdrift/kumiko-testing": "0.393.0"
   },
   "peerDependencies": {
-    "@cosmicdrift/kumiko-testing": "0.392.2"
+    "@cosmicdrift/kumiko-testing": "0.393.0"
   },
   "peerDependenciesMeta": {
     "@cosmicdrift/kumiko-testing": {

package/src/inbound-mail-foundation/changes.json

@@ -1,4 +1,16 @@
 [
+  {
+    "version": "0.393.0",
+    "type": "improvement",
+    "title": "The mail account list offers Reconnect for accounts with a sign-in error",
+    "detail": "A new row action Reconnect opens the screen mail-account-reconnect-imap of inbound-provider-imap. It shows for every account with status auth_error and, like the Connect mailbox button, only renders in apps that mount that provider. New export IMAP_RECONNECT_SCREEN_ID. New key in all locale packages."
+  },
+  {
+    "version": "0.393.0",
+    "type": "fix",
+    "title": "Mailbox names are stored without surrounding spaces",
+    "detail": "connect-account and update-account trim displayName before storing it, so a name pasted with a leading space no longer shows and sorts with it. connect-account still accepts an empty name as before."
+  },
   {
     "version": "0.392.2",
     "type": "fix",

package/src/inbound-provider-imap/changes.json

@@ -1,4 +1,16 @@
 [
+  {
+    "version": "0.393.0",
+    "type": "improvement",
+    "title": "IMAP mailboxes with a sign-in error can be reconnected",
+    "detail": "The new write handler inbound-provider-imap:write:reconnect-mailbox (TenantAdmin, SystemAdmin, not exposed to the agent, 10 calls per tenant in 10 minutes) takes the account id plus host, port, user, password and the outgoing server, checks the IMAP and SMTP login like connect-mailbox, then overwrites the credential secret of the same account and sets it back to active in one transaction. A failed check changes nothing. It answers not found for an unknown account or one of another tenant, account_disconnected for a disconnected one and reconnect_not_password_imap for other providers. The form screen mail-account-reconnect-imap is prefilled by the query inbound-provider-imap:query:reconnect-prefill with the stored server settings, never the password. New keys in all locale packages."
+  },
+  {
+    "version": "0.393.0",
+    "type": "fix",
+    "title": "IMAP forms trim the mailbox name and show ports without digit grouping",
+    "detail": "connect-mailbox trims displayName and still requires a non-empty name. The port fields of the connect and reconnect forms show 993 or 13993 instead of 13.993 in locales with digit grouping."
+  },
   {
     "version": "0.392.1",
     "type": "fix",