tina4-nodejs 3.13.91 → 3.13.94

package/packages/core/dist/index.js

@@ -1297,11 +1297,14 @@ var init_sqlite = __esm({
         const pragma = schema && isIdentifier(schema) && isIdentifier(tbl) ? `PRAGMA ${schema}.table_info("${tbl}")` : `PRAGMA table_info("${table2}")`;
         const rows = this.db.prepare(pragma).all();
         return rows.map((r) => ({
+          // PRAGMA table_info reports `pk` as the 1-BASED POSITION within the primary
+          // key, not a boolean: a composite key gives pk=1, pk=2, ... Testing `=== 1`
+          // reported only the first column of a composite key.
           name: r.name,
           type: r.type,
           nullable: r.notnull === 0,
           default: r.dflt_value,
-          primaryKey: r.pk === 1
+          primaryKey: Number(r.pk) > 0
         }));
       }
       lastInsertId() {
@@ -4297,6 +4300,8 @@ var init_database = __esm({
       poolIndex = 0;
       /** Factory for creating new adapters (used by pool) */
       adapterFactory = null;
+      /** table -> primary-key column name (or null), introspected once */
+      _pkCache = /* @__PURE__ */ new Map();
       /**
        * Whether a standalone write auto-commits. ON by default — a write made
        * outside an explicit transaction commits on its own connection before
@@ -4555,29 +4560,112 @@ var init_database = __esm({
         }
         return result;
       }
-      /** Update rows in a table matching filter. */
+      /**
+       * The table's primary-key column, introspected once and cached.
+       *
+       * Uses the cross-engine getColumns() contract (v3.13.14, #48), which reports
+       * primaryKey per column on every adapter. Resolves to null when the table has
+       * no primary key or cannot be introspected.
+       */
+      async primaryKey(table2) {
+        if (!this._pkCache.has(table2)) {
+          let pk = [];
+          try {
+            const columns = await this.getColumns(table2);
+            pk = columns.filter((c) => c.primaryKey).map((c) => c.name);
+          } catch {
+            pk = [];
+          }
+          this._pkCache.set(table2, pk);
+        }
+        return this._pkCache.get(table2) ?? [];
+      }
+      /**
+       * A failed write must be loud.
+       *
+       * The adapters catch a SQL error and return { success: false, affectedRows: 0 },
+       * so a filterless update produced invalid SQL ("... WHERE ") and reported
+       * nothing rather than raising. A caller who does not inspect the result
+       * believes the write landed (audit feature 4, P1).
+       */
+      static assertWrote(result, verb, table2) {
+        if (result && result.success === false) {
+          throw new Error(
+            `${verb} failed on ${table2}: ${result.error ?? "unknown error"}`
+          );
+        }
+        return result;
+      }
+      /**
+       * Update rows. A write with no filter is an error, not a full-table write.
+       *
+       * With no explicit filter the primary key is taken out of `data` and used as
+       * the WHERE clause. With neither a filter nor a primary key in `data` this
+       * throws rather than silently changing nothing (audit feature 4, P1).
+       */
       async update(table2, data, filter, params) {
+        let effectiveFilter = filter ?? {};
+        let effectiveData = data;
+        if (Object.keys(effectiveFilter).length === 0) {
+          const pkColumns = await this.primaryKey(table2);
+          const missing = pkColumns.filter((c) => !(c in data));
+          if (pkColumns.length === 0 || missing.length > 0) {
+            throw new Error(
+              `update requires a filter or the complete primary key in the data; pass filter explicitly to update multiple rows (table=${table2}, primary key=[${pkColumns.join(", ")}], missing from data=[${missing.join(", ")}]). To empty a table use truncate(${table2}).`
+            );
+          }
+          effectiveData = { ...data };
+          const keyed = {};
+          for (const col of pkColumns) {
+            keyed[col] = effectiveData[col];
+            delete effectiveData[col];
+          }
+          if (Object.keys(effectiveData).length === 0) {
+            throw new Error(
+              `update was given only the primary key [${pkColumns.join(", ")}] and no columns to set (table=${table2})`
+            );
+          }
+          effectiveFilter = keyed;
+        }
         const adapter = this.getNextAdapter();
-        const result = adapter.updateAsync ? await adapter.updateAsync(table2, data, filter ?? {}, params) : adapter.update(table2, data, filter ?? {}, params);
+        const result = adapter.updateAsync ? await adapter.updateAsync(table2, effectiveData, effectiveFilter, params) : adapter.update(table2, effectiveData, effectiveFilter, params);
         if (this.autoCommit && !this.inExplicitTransaction()) {
           try {
             await adapterCommit(adapter);
           } catch {
           }
         }
-        return result;
+        return _Database.assertWrote(result, "update", table2);
       }
-      /** Delete rows from a table matching filter. */
+      /** Delete rows. A filterless delete throws; use truncate() to empty a table. */
       async delete(table2, filter, params) {
+        const effectiveFilter = filter ?? {};
+        if (!Array.isArray(effectiveFilter) && typeof effectiveFilter !== "string" && Object.keys(effectiveFilter).length === 0) {
+          throw new Error(
+            `delete requires a filter (table=${table2}). To remove every row use truncate(${table2}).`
+          );
+        }
         const adapter = this.getNextAdapter();
-        const result = adapter.deleteAsync ? await adapter.deleteAsync(table2, filter ?? {}, params) : adapter.delete(table2, filter ?? {}, params);
+        const result = adapter.deleteAsync ? await adapter.deleteAsync(table2, effectiveFilter, params) : adapter.delete(table2, effectiveFilter, params);
         if (this.autoCommit && !this.inExplicitTransaction()) {
           try {
             await adapterCommit(adapter);
           } catch {
           }
         }
-        return result;
+        return _Database.assertWrote(result, "delete", table2);
+      }
+      /** Remove every row. The explicit spelling of a whole-table delete. */
+      async truncate(table2) {
+        const adapter = this.getNextAdapter();
+        const result = adapter.deleteAsync ? await adapter.deleteAsync(table2, "1 = 1", []) : adapter.delete(table2, "1 = 1", []);
+        if (this.autoCommit && !this.inExplicitTransaction()) {
+          try {
+            await adapterCommit(adapter);
+          } catch {
+          }
+        }
+        return _Database.assertWrote(result, "truncate", table2);
       }
       /** Close all database connections (pool or single). */
       close() {
@@ -12121,6 +12209,7 @@ var init_logger = __esm({
 var auth_exports = {};
 __export(auth_exports, {
   Auth: () => Auth,
+  JWT_LEEWAY_SECONDS: () => JWT_LEEWAY_SECONDS,
   authMiddleware: () => authMiddleware,
   authenticateRequest: () => authenticateRequest,
   checkPassword: () => checkPassword,
@@ -12129,6 +12218,7 @@ __export(auth_exports, {
   getToken: () => getToken,
   hashPassword: () => hashPassword,
   refreshToken: () => refreshToken,
+  resolveAlgorithm: () => resolveAlgorithm,
   validToken: () => validToken,
   validateApiKey: () => validateApiKey
 });
@@ -12189,6 +12279,18 @@ function ensureDevSecret(cwd) {
   }
   return newSecret;
 }
+function unsupportedAlgorithmError(algorithm) {
+  return new Error(
+    `Unsupported JWT algorithm "${algorithm}". Tina4 signs with ${SUPPORTED_ALGORITHMS.join(", ")} (HMAC via node:crypto; RS256 needs a PEM key pair). Set TINA4_JWT_ALGORITHM to one of those.`
+  );
+}
+function resolveAlgorithm(algorithm) {
+  const chosen = (algorithm || process.env.TINA4_JWT_ALGORITHM || "HS256").trim();
+  if (!HMAC_DIGESTS.has(chosen) && !RSA_SIGN_ALGORITHMS.has(chosen)) {
+    throw unsupportedAlgorithmError(chosen);
+  }
+  return chosen;
+}
 function base64urlEncode(data) {
   return data.toString("base64").replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
 }
@@ -12211,7 +12313,7 @@ function getToken(payload, secretOrExpiresIn, expiresIn = 60, algorithm) {
   if (!resolvedSecret) {
     _warnBlankSecret();
   }
-  const resolvedAlgorithm = algorithm ?? process.env.TINA4_JWT_ALGORITHM ?? "HS256";
+  const resolvedAlgorithm = resolveAlgorithm(algorithm);
   const header = { alg: resolvedAlgorithm, typ: "JWT" };
   const now = Math.floor(Date.now() / 1e3);
   const claims = { ...payload, iat: now };
@@ -12229,19 +12331,27 @@ function validToken(token, secret, algorithm) {
   if (!resolvedSecret) {
     _warnBlankSecret();
   }
-  const resolvedAlgorithm = algorithm ?? process.env.TINA4_JWT_ALGORITHM ?? "HS256";
+  const resolvedAlgorithm = resolveAlgorithm(algorithm);
   try {
     const parts = token.split(".");
     if (parts.length !== 3) return null;
     const [h, p, sig] = parts;
+    const header = JSON.parse(base64urlDecode(h).toString());
+    if (header.alg !== resolvedAlgorithm) return null;
     const signingInput = `${h}.${p}`;
     if (!verifySignature(signingInput, sig, resolvedSecret, resolvedAlgorithm)) {
       return null;
     }
     const payload = JSON.parse(base64urlDecode(p).toString());
-    if (typeof payload.exp === "number" && Date.now() / 1e3 > payload.exp) {
+    const now = Date.now() / 1e3;
+    if (typeof payload.exp === "number" && now > payload.exp) {
       return null;
     }
+    if (Object.hasOwn(payload, "nbf")) {
+      const notBefore = payload.nbf;
+      if (typeof notBefore !== "number" || !Number.isFinite(notBefore)) return null;
+      if (now + JWT_LEEWAY_SECONDS < notBefore) return null;
+    }
     return payload;
   } catch {
     return null;
@@ -12257,32 +12367,33 @@ function getPayload(token) {
   }
 }
 function sign(input, secret, algorithm) {
-  if (algorithm === "HS256") {
-    const sig = createHmac2("sha256", secret).update(input).digest();
-    return base64urlEncode(sig);
+  const digest = HMAC_DIGESTS.get(algorithm);
+  if (digest) {
+    return base64urlEncode(createHmac2(digest, secret).update(input).digest());
   }
-  if (algorithm === "RS256") {
-    const signer = createSign("RSA-SHA256");
+  const rsaAlgorithm = RSA_SIGN_ALGORITHMS.get(algorithm);
+  if (rsaAlgorithm) {
+    const signer = createSign(rsaAlgorithm);
     signer.update(input);
-    const sig = signer.sign(secret);
-    return base64urlEncode(sig);
+    return base64urlEncode(signer.sign(secret));
   }
-  throw new Error(`Unsupported algorithm: ${algorithm}`);
+  throw unsupportedAlgorithmError(algorithm);
 }
 function verifySignature(input, sig, secret, algorithm) {
-  if (algorithm === "HS256") {
+  if (HMAC_DIGESTS.has(algorithm)) {
     const expected = sign(input, secret, algorithm);
     const a = Buffer.from(sig);
     const b = Buffer.from(expected);
     if (a.length !== b.length) return false;
     return timingSafeEqual(a, b);
   }
-  if (algorithm === "RS256") {
-    const verifier = createVerify("RSA-SHA256");
+  const rsaAlgorithm = RSA_SIGN_ALGORITHMS.get(algorithm);
+  if (rsaAlgorithm) {
+    const verifier = createVerify(rsaAlgorithm);
     verifier.update(input);
     return verifier.verify(secret, base64urlDecode(sig));
   }
-  throw new Error(`Unsupported algorithm: ${algorithm}`);
+  throw unsupportedAlgorithmError(algorithm);
 }
 function hashPassword(password, salt, iterations = 26e4) {
   const actualSalt = salt ?? randomBytes3(16).toString("hex");
@@ -12307,7 +12418,7 @@ function checkPassword(password, hash) {
     return false;
   }
 }
-function authMiddleware(secret, algorithm = "HS256") {
+function authMiddleware(secret, algorithm) {
   return (req2, res, next) => {
     const authHeader = req2.headers.authorization ?? "";
     if (!authHeader.startsWith("Bearer ")) {
@@ -12330,11 +12441,11 @@ function refreshToken(token, expiresIn = 60) {
   const { iat: _iat, exp: _exp, ...claims } = payload;
   return getToken(claims, expiresIn);
 }
-function authenticateRequest(headers, secret, algorithm = "HS256") {
+function authenticateRequest(headers, secret, algorithm) {
   const authHeader = headers.authorization ?? headers.Authorization ?? "";
   if (!authHeader.startsWith("Bearer ")) return null;
   const token = authHeader.slice(7);
-  if (validToken(token)) return getPayload(token);
+  if (validToken(token, secret, algorithm)) return getPayload(token);
   if (validateApiKey(token)) {
     return { _auth: "api_key" };
   }
@@ -12348,12 +12459,23 @@ function validateApiKey(provided, expected) {
   if (a.length !== b.length) return false;
   return timingSafeEqual(a, b);
 }
-var BLANK_SECRET_WARNING, Auth;
+var BLANK_SECRET_WARNING, HMAC_DIGESTS, RSA_SIGN_ALGORITHMS, SUPPORTED_ALGORITHMS, JWT_LEEWAY_SECONDS, Auth;
 var init_auth = __esm({
   "src/auth.ts"() {
     "use strict";
     init_dotenv();
     BLANK_SECRET_WARNING = "Auth: TINA4_SECRET is not set \u2014 JWT signing is insecure. Set TINA4_SECRET to a random value (e.g. `openssl rand -hex 32`) in your environment or .env before serving traffic. For LOCAL DEV, set TINA4_DEBUG=true and a per-machine secret is generated automatically into .env.local (gitignored). Seeing this warning means the run was NOT detected as dev \u2014 typically a container or CI without TINA4_DEBUG set, or TINA4_ENV=production.";
+    HMAC_DIGESTS = /* @__PURE__ */ new Map([
+      ["HS256", "sha256"],
+      ["HS384", "sha384"],
+      ["HS512", "sha512"]
+    ]);
+    RSA_SIGN_ALGORITHMS = /* @__PURE__ */ new Map([["RS256", "RSA-SHA256"]]);
+    SUPPORTED_ALGORITHMS = [
+      ...HMAC_DIGESTS.keys(),
+      ...RSA_SIGN_ALGORITHMS.keys()
+    ];
+    JWT_LEEWAY_SECONDS = 60;
     Auth = class {
       static getToken = getToken;
       static validToken = validToken;
@@ -13792,7 +13914,7 @@ function _generateFormToken(descriptor = "") {
 function _generateFormTokenValue(descriptor = "") {
   return new SafeString(_buildFormTokenJwt(descriptor));
 }
-var SafeString, KNOWN_TAGS, TERMINATOR_TAGS, JSON_UNSAFE_RE, JSON_UNSAFE_MAP, NUMERIC_RE, METHOD_CALL_RE, FN_CALL_RE, IS_NOT_RE, IS_RE, NOT_IN_RE, IN_RE, DIVISIBLE_BY_RE, FILTER_WITH_ARGS_RE, FILTER_COMPARISON_RE, TITLE_WORD_RE, STRIP_TAGS_RE, FORMAT_RE, LEADING_WS_RE, TRAILING_WS_RE, THOUSANDS_RE, LIVE_RE, LIVE_WS_RE, LIVE_SRC_RE, filterChainCache, pathParseCache, TEMPLATE_CACHE_MAX, TOKEN_RE, RAW_BLOCK_RE, VarRef, BUILTIN_FILTERS, _formTokenSessionId, Frond;
+var SafeString, KNOWN_TAGS, TERMINATOR_TAGS, GATEABLE_TAGS, BLOCK_TAG_ENDS, JSON_UNSAFE_RE, JSON_UNSAFE_MAP, NUMERIC_RE, METHOD_CALL_RE, FN_CALL_RE, IS_NOT_RE, IS_RE, NOT_IN_RE, IN_RE, DIVISIBLE_BY_RE, FILTER_WITH_ARGS_RE, FILTER_COMPARISON_RE, TITLE_WORD_RE, STRIP_TAGS_RE, FORMAT_RE, LEADING_WS_RE, TRAILING_WS_RE, THOUSANDS_RE, LIVE_RE, LIVE_WS_RE, LIVE_SRC_RE, filterChainCache, pathParseCache, TEMPLATE_CACHE_MAX, TOKEN_RE, RAW_BLOCK_RE, VarRef, BUILTIN_FILTERS, _formTokenSessionId, Frond;
 var init_engine = __esm({
   "../frond/src/engine.ts"() {
     "use strict";
@@ -13835,6 +13957,29 @@ var init_engine = __esm({
       "endset",
       "endspaceless"
     ]);
+    GATEABLE_TAGS = /* @__PURE__ */ new Set([
+      "autoescape",
+      "cache",
+      "for",
+      "from",
+      "if",
+      "import",
+      "include",
+      "live",
+      "macro",
+      "set",
+      "spaceless"
+    ]);
+    BLOCK_TAG_ENDS = {
+      autoescape: "endautoescape",
+      cache: "endcache",
+      for: "endfor",
+      if: "endif",
+      live: "endlive",
+      macro: "endmacro",
+      set: "endset",
+      spaceless: "endspaceless"
+    };
     JSON_UNSAFE_RE = /[<>&'\u2028\u2029]/g;
     JSON_UNSAFE_MAP = {
       "<": "\\u003c",
@@ -14470,42 +14615,27 @@ var init_engine = __esm({
             if (stripA && i + 1 < tokens.length && tokens[i + 1][0] === "TEXT") {
               tokens[i + 1] = ["TEXT", tokens[i + 1][1].replace(LEADING_WS_RE, "")];
             }
-            if (tag === "if") {
-              if (this._sandbox && this._allowedTags !== null && !this._allowedTags.has("if")) {
-                const skip = this.skipBlock(tokens, i, "if", "endif");
-                i = skip;
-              } else {
-                const [result, skip] = this.handleIf(tokens, i, context);
-                output.push(result);
-                i = skip;
-              }
+            if (!this.tagPermitted(tag)) {
+              i = this.skipDeniedTag(tokens, i, tag, content);
+            } else if (tag === "if") {
+              const [result, skip] = this.handleIf(tokens, i, context);
+              output.push(result);
+              i = skip;
             } else if (tag === "for") {
-              if (this._sandbox && this._allowedTags !== null && !this._allowedTags.has("for")) {
-                const skip = this.skipBlock(tokens, i, "for", "endfor");
-                i = skip;
-              } else {
-                const [result, skip] = this.handleFor(tokens, i, context);
-                output.push(result);
-                i = skip;
-              }
+              const [result, skip] = this.handleFor(tokens, i, context);
+              output.push(result);
+              i = skip;
             } else if (tag === "set") {
-              const isBlockSet = !content.includes("=");
-              if (this._sandbox && this._allowedTags !== null && !this._allowedTags.has("set")) {
-                i = isBlockSet ? this.skipBlock(tokens, i, "set", "endset") : i + 1;
-              } else if (isBlockSet) {
+              if (!content.includes("=")) {
                 i = this.handleSetBlock(tokens, i, context);
               } else {
                 this.handleSet(content, context);
                 i++;
               }
             } else if (tag === "include") {
-              if (this._sandbox && this._allowedTags !== null && !this._allowedTags.has("include")) {
-                i++;
-              } else {
-                const result = this.handleInclude(content, context);
-                output.push(result);
-                i++;
-              }
+              const result = this.handleInclude(content, context);
+              output.push(result);
+              i++;
             } else if (tag === "macro") {
               const skip = this.handleMacro(tokens, i, context);
               i = skip;
@@ -14550,6 +14680,41 @@ var init_engine = __esm({
         }
         return output.join("");
       }
+      /**
+       * May this filter RUN under the current sandbox?
+       *
+       * The escaping decision has to ask this rather than read the filter name out of
+       * the source. Node carries safety as a FLAG rather than as a value-level marker
+       * (Python and Ruby return a SafeString, PHP prepends a RAW_MARKER -- all three
+       * produced only by actually running the filter), so here the name alone was
+       * enough to suppress auto-escaping even when the filter was denied and skipped.
+       */
+      filterPermitted(name) {
+        if (!this._sandbox || this._allowedFilters === null) return true;
+        return this._allowedFilters.has(name);
+      }
+      /**
+       * May this tag run under the current sandbox?
+       *
+       * One gate for every tag, so the allow-list governs the whole tag vocabulary
+       * instead of the four names that happened to be checked individually.
+       */
+      tagPermitted(tag) {
+        if (!this._sandbox || this._allowedTags === null) return true;
+        if (!GATEABLE_TAGS.has(tag)) return true;
+        return this._allowedTags.has(tag);
+      }
+      /**
+       * Consume a denied tag WITHOUT running it, returning the index past its body.
+       *
+       * Advancing a single token past a body-owning tag would leave the body's tokens
+       * to render at the TOP level, leaking exactly the content the sandbox denied.
+       */
+      skipDeniedTag(tokens, start2, tag, content) {
+        const closeTag = BLOCK_TAG_ENDS[tag];
+        if (closeTag === void 0 || tag === "set" && content.includes("=")) return start2 + 1;
+        return this.skipBlock(tokens, start2, tag, closeTag);
+      }
       skipBlock(tokens, start2, openTag, closeTag) {
         let depth = 0;
         let i = start2 + 1;
@@ -14557,7 +14722,7 @@ var init_engine = __esm({
           if (tokens[i][0] === "BLOCK") {
             const [content] = stripTag(tokens[i][1]);
             const tag = content.split(/\s+/)[0] || "";
-            if (tag === openTag) depth++;
+            if (tag === openTag && !(openTag === "set" && content.includes("="))) depth++;
             else if (tag === closeTag) {
               if (depth === 0) return i + 1;
               depth--;
@@ -14742,11 +14907,11 @@ var init_engine = __esm({
         for (const [fname, rawArgs] of filters) {
           const args = rawArgs.map((a) => a instanceof VarRef ? evalExpr(a.name, context) : a);
           if (fname === "raw" || fname === "safe") {
-            isSafe = true;
+            if (this.filterPermitted(fname)) isSafe = true;
             continue;
           }
           if (fname === "escape" || fname === "e") {
-            isSafe = true;
+            if (this.filterPermitted(fname)) isSafe = true;
           }
           if (this._sandbox && this._allowedFilters !== null) {
             if (!this._allowedFilters.has(fname)) {
@@ -16557,858 +16722,128 @@ var init_rateLimiter = __esm({
   }
 });
 
-// src/messenger.ts
-import net2 from "node:net";
-import tls from "node:tls";
-import { readFileSync as readFileSync8 } from "node:fs";
-import { basename as basename2 } from "node:path";
+// src/devMailbox.ts
+import { mkdirSync as mkdirSync8, readdirSync as readdirSync6, readFileSync as readFileSync8, writeFileSync as writeFileSync6, unlinkSync as unlinkSync4, existsSync as existsSync10 } from "node:fs";
+import { join as join12 } from "node:path";
 import { randomUUID as randomUUID2 } from "node:crypto";
-function tlsRejectUnauthorized() {
-  return !isTruthy(process.env.TINA4_MAIL_TLS_INSECURE);
-}
-function readResponse(socket) {
-  return new Promise((resolve21, reject) => {
-    let buffer = "";
-    const onData = (chunk) => {
-      buffer += chunk.toString("utf-8");
-      const lines = buffer.split("\r\n");
-      for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.length < 3) continue;
-        const code = parseInt(line.substring(0, 3), 10);
-        if (line.length >= 4 && line[3] === " ") {
-          socket.removeListener("data", onData);
-          socket.removeListener("error", onError);
-          resolve21({ code, text: buffer.trim() });
-          return;
-        }
-      }
-    };
-    const onError = (err) => {
-      socket.removeListener("data", onData);
-      reject(err);
-    };
-    socket.on("data", onData);
-    socket.on("error", onError);
-  });
-}
-function sendCommand(socket, command) {
-  return new Promise((resolve21, reject) => {
-    socket.write(command + "\r\n", "utf-8", (err) => {
-      if (err) return reject(err);
-      readResponse(socket).then(resolve21, reject);
-    });
-  });
-}
-function buildMimeMessage(options) {
-  const boundary = `----=_Tina4_${Date.now()}_${Math.random().toString(36).substring(2)}`;
-  const altBoundary = `----=_Tina4Alt_${Date.now()}_${Math.random().toString(36).substring(2)}`;
-  const hasAttachments = options.attachments && options.attachments.length > 0;
-  const hasTextAlt = options.text !== void 0 && options.html;
-  const lines = [];
-  const fromHeader = options.fromName ? `"${options.fromName}" <${options.from}>` : options.from;
-  lines.push(`From: ${fromHeader}`);
-  lines.push(`To: ${options.to.join(", ")}`);
-  if (options.cc.length > 0) {
-    lines.push(`Cc: ${options.cc.join(", ")}`);
-  }
-  lines.push(`Subject: ${options.subject}`);
-  lines.push(`Date: ${(/* @__PURE__ */ new Date()).toUTCString()}`);
-  lines.push(`Message-ID: <${options.messageId}>`);
-  lines.push("MIME-Version: 1.0");
-  if (options.replyTo) {
-    lines.push(`Reply-To: ${options.replyTo}`);
-  }
-  if (options.headers) {
-    for (const [key, value] of Object.entries(options.headers)) {
-      lines.push(`${key}: ${value}`);
-    }
-  }
-  if (hasAttachments) {
-    lines.push(`Content-Type: multipart/mixed; boundary="${boundary}"`);
-    lines.push("");
-    lines.push(`--${boundary}`);
-    if (hasTextAlt) {
-      lines.push(`Content-Type: multipart/alternative; boundary="${altBoundary}"`);
-      lines.push("");
-      lines.push(`--${altBoundary}`);
-      lines.push("Content-Type: text/plain; charset=UTF-8");
-      lines.push("Content-Transfer-Encoding: 7bit");
-      lines.push("");
-      lines.push(options.text);
-      lines.push("");
-      lines.push(`--${altBoundary}`);
-      lines.push("Content-Type: text/html; charset=UTF-8");
-      lines.push("Content-Transfer-Encoding: 7bit");
-      lines.push("");
-      lines.push(options.body);
-      lines.push("");
-      lines.push(`--${altBoundary}--`);
-    } else {
-      const contentType = options.html ? "text/html" : "text/plain";
-      lines.push(`Content-Type: ${contentType}; charset=UTF-8`);
-      lines.push("Content-Transfer-Encoding: 7bit");
-      lines.push("");
-      lines.push(options.body);
-    }
-    for (const filePath of options.attachments) {
-      const fileName = basename2(filePath);
-      const fileData = readFileSync8(filePath);
-      const base64Data = fileData.toString("base64");
-      lines.push("");
-      lines.push(`--${boundary}`);
-      lines.push(`Content-Type: application/octet-stream; name="${fileName}"`);
-      lines.push("Content-Transfer-Encoding: base64");
-      lines.push(`Content-Disposition: attachment; filename="${fileName}"`);
-      lines.push("");
-      for (let i = 0; i < base64Data.length; i += 76) {
-        lines.push(base64Data.substring(i, i + 76));
-      }
-    }
-    lines.push("");
-    lines.push(`--${boundary}--`);
-  } else if (hasTextAlt) {
-    lines.push(`Content-Type: multipart/alternative; boundary="${altBoundary}"`);
-    lines.push("");
-    lines.push(`--${altBoundary}`);
-    lines.push("Content-Type: text/plain; charset=UTF-8");
-    lines.push("Content-Transfer-Encoding: 7bit");
-    lines.push("");
-    lines.push(options.text);
-    lines.push("");
-    lines.push(`--${altBoundary}`);
-    lines.push("Content-Type: text/html; charset=UTF-8");
-    lines.push("Content-Transfer-Encoding: 7bit");
-    lines.push("");
-    lines.push(options.body);
-    lines.push("");
-    lines.push(`--${altBoundary}--`);
-  } else {
-    const contentType = options.html ? "text/html" : "text/plain";
-    lines.push(`Content-Type: ${contentType}; charset=UTF-8`);
-    lines.push("");
-    lines.push(options.body);
-  }
-  return lines.join("\r\n");
-}
-function imapQuote(s) {
-  if (/^[a-zA-Z0-9_./-]+$/.test(s)) return s;
-  return '"' + s.replace(/\\/g, "\\\\").replace(/"/g, '\\"') + '"';
-}
-function imapReadLine(socket) {
-  return new Promise((resolve21, reject) => {
-    let buffer = "";
-    const onData = (chunk) => {
-      buffer += chunk.toString("utf-8");
-      const nlIndex = buffer.indexOf("\r\n");
-      if (nlIndex !== -1) {
-        socket.removeListener("data", onData);
-        socket.removeListener("error", onError);
-        resolve21(buffer);
+var DevMailbox;
+var init_devMailbox = __esm({
+  "src/devMailbox.ts"() {
+    "use strict";
+    DevMailbox = class {
+      mailboxDir;
+      constructor(mailboxDir) {
+        this.mailboxDir = mailboxDir ?? process.env.TINA4_MAILBOX_DIR ?? "data/mailbox";
       }
-    };
-    const onError = (err) => {
-      socket.removeListener("data", onData);
-      reject(err);
-    };
-    socket.on("data", onData);
-    socket.on("error", onError);
-  });
-}
-function imapCommand(socket, command) {
-  return new Promise((resolve21, reject) => {
-    imapTagCounter++;
-    const tag = `T${imapTagCounter}`;
-    const fullCommand = `${tag} ${command}\r
-`;
-    let buffer = "";
-    const onData = (chunk) => {
-      buffer += chunk.toString("utf-8");
-      if (buffer.includes(`${tag} OK`)) {
-        socket.removeListener("data", onData);
-        socket.removeListener("error", onError);
-        resolve21(buffer);
-        return;
+      /**
+       * Ensure a folder directory exists.
+       */
+      ensureFolder(folder) {
+        const dir = join12(this.mailboxDir, folder);
+        mkdirSync8(dir, { recursive: true });
+        return dir;
       }
-      if (buffer.includes(`${tag} NO`) || buffer.includes(`${tag} BAD`)) {
-        socket.removeListener("data", onData);
-        socket.removeListener("error", onError);
-        reject(new MessengerConnectionError(`IMAP command failed: ${command.split(" ")[0]} \u2192 ${buffer.trim()}`));
+      /**
+       * Capture an email to the dev mailbox instead of sending it.
+       *
+       * The parameter order MATCHES Messenger.send() on purpose. It did not before:
+       * send()'s 5th positional was `text` and capture()'s was `cc`, so the same call
+       * meant different things depending on which door it came through -- that mismatch
+       * IS nodejs#42.
+       *
+       * BREAKING: `text` is now the 5th positional. A caller passing cc positionally
+       * must move it. Aligning the two signatures is the fix; leaving them apart would
+       * preserve the bug.
+       */
+      capture(to, subject, body, html = false, text, cc = [], bcc = [], replyTo, attachments = [], from) {
+        const id = randomUUID2();
+        const toList = Array.isArray(to) ? to : [to];
+        const ccList = Array.isArray(cc) ? cc : cc ? [cc] : [];
+        const bccList = Array.isArray(bcc) ? bcc : bcc ? [bcc] : [];
+        const now = (/* @__PURE__ */ new Date()).toISOString();
+        const message = {
+          id,
+          type: "outbox",
+          from: from ?? process.env.TINA4_MAIL_FROM ?? "dev@localhost",
+          to: toList,
+          cc: ccList,
+          bcc: bccList,
+          reply_to: replyTo,
+          subject,
+          body,
+          text,
+          html,
+          attachments,
+          date: now,
+          read: false
+        };
+        const outboxDir = this.ensureFolder("outbox");
+        writeFileSync6(join12(outboxDir, `${id}.json`), JSON.stringify(message, null, 2));
+        const inboxDir = this.ensureFolder("inbox");
+        const inboxMessage = { ...message, type: "inbox" };
+        writeFileSync6(join12(inboxDir, `${id}.json`), JSON.stringify(inboxMessage, null, 2));
+        return { success: true, message: "Email captured to dev mailbox", id };
       }
-    };
-    const onError = (err) => {
-      socket.removeListener("data", onData);
-      reject(err);
-    };
-    socket.on("data", onData);
-    socket.on("error", onError);
-    socket.write(fullCommand, "utf-8");
-  });
-}
-function imapFail(method, err) {
-  const e = err instanceof Error ? err : new Error(String(err));
-  Log.error(`Messenger IMAP ${method}() failed: ${e.name}: ${e.message}`);
-  if (e instanceof MessengerConnectionError) return e;
-  return new MessengerConnectionError(`IMAP ${method} failed: ${e.message}`);
-}
-function parseSearchResponse(response) {
-  const match = response.match(/\* SEARCH (.+)/);
-  if (!match) return [];
-  return match[1].trim().split(/\s+/).filter((s) => /^\d+$/.test(s));
-}
-function parseHeaderResponse(uid, response) {
-  const headers = {};
-  const headerBlock = response.match(/\r\n([\s\S]*?)\r\n\)/);
-  if (headerBlock) {
-    const lines = headerBlock[1].split(/\r\n/);
-    let currentKey = "";
-    for (const line of lines) {
-      if (/^\s/.test(line) && currentKey) {
-        headers[currentKey] += " " + line.trim();
-      } else {
-        const colonIdx = line.indexOf(":");
-        if (colonIdx > 0) {
-          currentKey = line.substring(0, colonIdx).trim().toLowerCase();
-          headers[currentKey] = line.substring(colonIdx + 1).trim();
+      /**
+       * List messages from a folder (default: inbox).
+       */
+      inbox(limit = 50, offset = 0, folder = "inbox") {
+        const dir = this.ensureFolder(folder);
+        const results = [];
+        let files;
+        try {
+          files = readdirSync6(dir).filter((f) => f.endsWith(".json")).sort().reverse();
+        } catch {
+          return [];
         }
-      }
-    }
-  }
-  const seen = /\\Seen/i.test(response);
-  return {
-    uid,
-    subject: headers["subject"] ?? "",
-    from: headers["from"] ?? "",
-    to: headers["to"] ?? "",
-    date: headers["date"] ?? "",
-    snippet: "",
-    seen
-  };
-}
-function emptyFullMessage(uid) {
-  return { uid, subject: "", from: "", to: "", cc: "", date: "", bodyText: "", bodyHtml: "", headers: {} };
-}
-function parseFullMessage(uid, response) {
-  const bodyMatch = response.match(/\{(\d+)\}\r\n([\s\S]*)/);
-  const rawMessage = bodyMatch ? bodyMatch[2] : response;
-  const headerEnd = rawMessage.indexOf("\r\n\r\n");
-  const headerSection = headerEnd > 0 ? rawMessage.substring(0, headerEnd) : rawMessage;
-  const bodySection = headerEnd > 0 ? rawMessage.substring(headerEnd + 4) : "";
-  const headers = {};
-  const headerLines = headerSection.split(/\r\n/);
-  let currentKey = "";
-  for (const line of headerLines) {
-    if (/^\s/.test(line) && currentKey) {
-      headers[currentKey] += " " + line.trim();
-    } else {
-      const colonIdx = line.indexOf(":");
-      if (colonIdx > 0) {
-        currentKey = line.substring(0, colonIdx).trim().toLowerCase();
-        headers[currentKey] = line.substring(colonIdx + 1).trim();
-      }
-    }
-  }
-  const contentType = headers["content-type"] ?? "text/plain";
-  let bodyText = "";
-  let bodyHtml = "";
-  if (contentType.includes("multipart")) {
-    const boundaryMatch = contentType.match(/boundary="?([^";\s]+)"?/);
-    if (boundaryMatch) {
-      const boundary = boundaryMatch[1];
-      const parts = bodySection.split("--" + boundary);
-      for (const part of parts) {
-        if (part.trim() === "" || part.trim() === "--") continue;
-        const partHeaderEnd = part.indexOf("\r\n\r\n");
-        const partHeaders = partHeaderEnd > 0 ? part.substring(0, partHeaderEnd).toLowerCase() : "";
-        const partBody = partHeaderEnd > 0 ? part.substring(partHeaderEnd + 4).trim() : "";
-        if (partHeaders.includes("text/html")) {
-          bodyHtml = partBody;
-        } else if (partHeaders.includes("text/plain")) {
-          bodyText = partBody;
+        const sliced = files.slice(offset, offset + limit);
+        for (const file of sliced) {
+          try {
+            const msg = JSON.parse(readFileSync8(join12(dir, file), "utf-8"));
+            results.push(msg);
+          } catch {
+          }
         }
+        return results;
       }
-    }
-  } else if (contentType.includes("text/html")) {
-    bodyHtml = bodySection;
-  } else {
-    bodyText = bodySection;
-  }
-  bodyText = bodyText.replace(/\)\r\n[A-Z]\d+ OK.*$/s, "").trim();
-  bodyHtml = bodyHtml.replace(/\)\r\n[A-Z]\d+ OK.*$/s, "").trim();
-  return {
-    uid,
-    subject: headers["subject"] ?? "",
-    from: headers["from"] ?? "",
-    to: headers["to"] ?? "",
-    cc: headers["cc"] ?? "",
-    date: headers["date"] ?? "",
-    bodyText,
-    bodyHtml,
-    headers
-  };
-}
-var MessengerConnectionError, Messenger, imapTagCounter;
-var init_messenger = __esm({
-  "src/messenger.ts"() {
-    "use strict";
-    init_dotenv();
-    init_logger();
-    MessengerConnectionError = class extends Error {
-      constructor(message) {
-        super(message);
-        this.name = "MessengerConnectionError";
-      }
-    };
-    Messenger = class {
-      host;
-      port;
-      username;
-      password;
-      fromAddress;
-      fromName;
-      encryption;
-      useTls;
-      imapHost;
-      imapPort;
-      imapUser;
-      imapPass;
-      imapEncryption;
-      constructor(options) {
-        this.host = options?.host ?? process.env.TINA4_MAIL_HOST ?? "localhost";
-        this.port = options?.port ?? parseInt(process.env.TINA4_MAIL_PORT ?? "587", 10);
-        this.username = options?.username ?? process.env.TINA4_MAIL_USERNAME ?? "";
-        this.password = options?.password ?? process.env.TINA4_MAIL_PASSWORD ?? "";
-        this.fromAddress = options?.fromAddress ?? process.env.TINA4_MAIL_FROM ?? (this.username || "noreply@localhost");
-        this.fromName = options?.fromName ?? process.env.TINA4_MAIL_FROM_NAME ?? "";
-        const envEncryption = options?.encryption ?? process.env.TINA4_MAIL_ENCRYPTION;
-        if (envEncryption) {
-          this.encryption = envEncryption.toLowerCase();
-        } else if (options?.useTls !== void 0) {
-          this.encryption = options.useTls ? "tls" : "none";
-        } else {
-          this.encryption = "tls";
+      /**
+       * Read a single message by ID. Searches all folders.
+       */
+      read(msgId) {
+        const folders = ["inbox", "outbox"];
+        for (const folder of folders) {
+          const filePath = join12(this.mailboxDir, folder, `${msgId}.json`);
+          if (existsSync10(filePath)) {
+            try {
+              const msg = JSON.parse(readFileSync8(filePath, "utf-8"));
+              msg.read = true;
+              writeFileSync6(filePath, JSON.stringify(msg, null, 2));
+              return msg;
+            } catch {
+              return null;
+            }
+          }
         }
-        this.useTls = ["tls", "starttls"].includes(this.encryption);
-        this.imapHost = options?.imapHost ?? process.env.TINA4_MAIL_IMAP_HOST ?? "";
-        this.imapPort = options?.imapPort ?? parseInt(process.env.TINA4_MAIL_IMAP_PORT ?? "993", 10);
-        this.imapUser = options?.imapUser ?? process.env.TINA4_MAIL_IMAP_USERNAME ?? this.username;
-        this.imapPass = options?.imapPass ?? process.env.TINA4_MAIL_IMAP_PASSWORD ?? this.password;
-        this.imapEncryption = (options?.imapEncryption ?? process.env.TINA4_MAIL_IMAP_ENCRYPTION ?? "tls").toLowerCase();
+        return null;
       }
       /**
-       * Read-only IMAP encryption mode for inspection / tests.
-       * Returns one of "tls", "starttls", "none", "ssl".
+       * Count unread messages in the inbox.
        */
-      getImapEncryption() {
-        return this.imapEncryption;
-      }
-      /**
-       * Send an email via SMTP.
-       */
-      async send(to, subject, body, html = false, text, cc, bcc, replyTo, attachments, headers) {
-        const options = { to, subject, body, html, text, cc, bcc, replyTo, attachments, headers };
-        const toList = Array.isArray(options.to) ? options.to : [options.to];
-        const ccList = Array.isArray(options.cc) ? options.cc : options.cc ? [options.cc] : [];
-        const bccList = Array.isArray(options.bcc) ? options.bcc : options.bcc ? [options.bcc] : [];
-        const allRecipients = [...toList, ...ccList, ...bccList];
-        const messageId = `${randomUUID2()}@${this.host}`;
-        if (allRecipients.length === 0) {
-          return { success: false, message: "No recipients specified" };
-        }
-        if (!this.fromAddress) {
-          return { success: false, message: "No from address configured" };
-        }
-        try {
-          let socket;
-          if (this.port === 465) {
-            socket = tls.connect({ host: this.host, port: this.port, rejectUnauthorized: tlsRejectUnauthorized() });
-            await new Promise((resolve21, reject) => {
-              socket.once("secureConnect", resolve21);
-              socket.once("error", reject);
-            });
-          } else {
-            socket = net2.createConnection({ host: this.host, port: this.port });
-            await new Promise((resolve21, reject) => {
-              socket.once("connect", resolve21);
-              socket.once("error", reject);
-            });
-          }
-          const greeting = await readResponse(socket);
-          if (greeting.code !== 220) {
-            socket.destroy();
-            return { success: false, message: `SMTP greeting failed: ${greeting.text}` };
-          }
-          const ehlo = await sendCommand(socket, `EHLO ${this.host}`);
-          if (ehlo.code !== 250) {
-            socket.destroy();
-            return { success: false, message: `EHLO failed: ${ehlo.text}` };
-          }
-          if (this.useTls && this.port !== 465 && ehlo.text.includes("STARTTLS")) {
-            const starttls = await sendCommand(socket, "STARTTLS");
-            if (starttls.code !== 220) {
-              socket.destroy();
-              return { success: false, message: `STARTTLS failed: ${starttls.text}` };
-            }
-            const plainSocket = socket;
-            socket = tls.connect(
-              { socket: plainSocket, host: this.host, rejectUnauthorized: tlsRejectUnauthorized() }
-            );
-            await new Promise((resolve21, reject) => {
-              socket.once("secureConnect", resolve21);
-              socket.once("error", reject);
-            });
-            const ehlo2 = await sendCommand(socket, `EHLO ${this.host}`);
-            if (ehlo2.code !== 250) {
-              socket.destroy();
-              return { success: false, message: `EHLO after STARTTLS failed: ${ehlo2.text}` };
-            }
-          }
-          if (this.username && this.password) {
-            const auth = await sendCommand(socket, "AUTH LOGIN");
-            if (auth.code !== 334) {
-              socket.destroy();
-              return { success: false, message: `AUTH LOGIN failed: ${auth.text}` };
-            }
-            const userResp = await sendCommand(socket, Buffer.from(this.username).toString("base64"));
-            if (userResp.code !== 334) {
-              socket.destroy();
-              return { success: false, message: `AUTH username failed: ${userResp.text}` };
-            }
-            const passResp = await sendCommand(socket, Buffer.from(this.password).toString("base64"));
-            if (passResp.code !== 235) {
-              socket.destroy();
-              return { success: false, message: `AUTH password failed: ${passResp.text}` };
-            }
-          }
-          const mailFrom = await sendCommand(socket, `MAIL FROM:<${this.fromAddress}>`);
-          if (mailFrom.code !== 250) {
-            socket.destroy();
-            return { success: false, message: `MAIL FROM failed: ${mailFrom.text}` };
-          }
-          for (const recipient of allRecipients) {
-            const rcpt = await sendCommand(socket, `RCPT TO:<${recipient}>`);
-            if (rcpt.code !== 250 && rcpt.code !== 251) {
-              socket.destroy();
-              return { success: false, message: `RCPT TO <${recipient}> failed: ${rcpt.text}` };
-            }
-          }
-          const dataCmd = await sendCommand(socket, "DATA");
-          if (dataCmd.code !== 354) {
-            socket.destroy();
-            return { success: false, message: `DATA failed: ${dataCmd.text}` };
-          }
-          const mimeMessage = buildMimeMessage({
-            from: this.fromAddress,
-            fromName: this.fromName,
-            to: toList,
-            cc: ccList,
-            subject: options.subject,
-            body: options.body,
-            html: options.html ?? false,
-            text: options.text,
-            replyTo: options.replyTo,
-            attachments: options.attachments,
-            headers: options.headers,
-            messageId
-          });
-          const endData = await sendCommand(socket, mimeMessage + "\r\n.");
-          if (endData.code !== 250) {
-            socket.destroy();
-            return { success: false, message: `Message delivery failed: ${endData.text}` };
-          }
-          await sendCommand(socket, "QUIT");
-          socket.destroy();
-          return { success: true, message: "Email sent successfully", id: messageId };
-        } catch (err) {
-          const errMsg = err instanceof Error ? err.message : String(err);
-          return { success: false, message: `SMTP error: ${errMsg}` };
-        }
-      }
-      /**
-       * Test the SMTP connection without sending an email.
-       */
-      async testConnection() {
-        try {
-          let socket;
-          if (this.port === 465) {
-            socket = tls.connect({ host: this.host, port: this.port, rejectUnauthorized: tlsRejectUnauthorized() });
-            await new Promise((resolve21, reject) => {
-              socket.once("secureConnect", resolve21);
-              socket.once("error", reject);
-            });
-          } else {
-            socket = net2.createConnection({ host: this.host, port: this.port });
-            await new Promise((resolve21, reject) => {
-              socket.once("connect", resolve21);
-              socket.once("error", reject);
-            });
-          }
-          const greeting = await readResponse(socket);
-          if (greeting.code !== 220) {
-            socket.destroy();
-            return { success: false, message: `SMTP greeting failed: ${greeting.text}` };
-          }
-          const ehlo = await sendCommand(socket, `EHLO ${this.host}`);
-          if (ehlo.code !== 250) {
-            socket.destroy();
-            return { success: false, message: `EHLO failed: ${ehlo.text}` };
-          }
-          await sendCommand(socket, "QUIT");
-          socket.destroy();
-          return { success: true, message: `Connected to ${this.host}:${this.port}` };
-        } catch (err) {
-          const errMsg = err instanceof Error ? err.message : String(err);
-          return { success: false, message: `Connection failed: ${errMsg}` };
-        }
-      }
-      // ── IMAP (Read) ────────────────────────────────────────────
-      /**
-       * Connect to the IMAP server via raw TCP/TLS.
-       * Returns the socket and reads the greeting.
-       */
-      async imapConnect() {
-        if (!this.imapHost) {
-          throw new Error("IMAP host not configured (set imapHost or IMAP_HOST env)");
-        }
-        let socket;
-        const useTls = this.imapEncryption === "tls" || this.imapEncryption === "ssl" || this.imapEncryption === "" && this.imapPort === 993;
-        if (useTls) {
-          socket = tls.connect({ host: this.imapHost, port: this.imapPort, rejectUnauthorized: tlsRejectUnauthorized() });
-          await new Promise((resolve21, reject) => {
-            socket.once("secureConnect", resolve21);
-            socket.once("error", reject);
-          });
-        } else {
-          socket = net2.createConnection({ host: this.imapHost, port: this.imapPort });
-          await new Promise((resolve21, reject) => {
-            socket.once("connect", resolve21);
-            socket.once("error", reject);
-          });
-        }
-        await imapReadLine(socket);
-        if (this.imapUser && this.imapPass) {
-          const loginResp = await imapCommand(socket, `LOGIN ${imapQuote(this.imapUser)} ${imapQuote(this.imapPass)}`);
-          if (!loginResp.includes("OK")) {
-            socket.destroy();
-            throw new Error(`IMAP login failed: ${loginResp}`);
-          }
-        }
-        return socket;
-      }
-      /**
-       * Disconnect from IMAP cleanly.
-       */
-      async imapDisconnect(socket) {
-        try {
-          await imapCommand(socket, "LOGOUT");
-        } catch {
-        }
-        socket.destroy();
-      }
-      /**
-       * Fetch latest messages from a folder.
-       * Returns list of message summaries.
-       */
-      async inbox(limit = 20, offset = 0, folder = "INBOX") {
-        let socket;
-        try {
-          socket = await this.imapConnect();
-        } catch (err) {
-          throw imapFail("inbox", err);
-        }
-        try {
-          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
-          const searchResp = await imapCommand(socket, "SEARCH ALL");
-          const uids = parseSearchResponse(searchResp);
-          if (uids.length === 0) return [];
-          uids.reverse();
-          const selected = uids.slice(offset, offset + limit);
-          if (selected.length === 0) return [];
-          const messages = [];
-          for (const uid of selected) {
-            const fetchResp = await imapCommand(socket, `FETCH ${uid} (FLAGS BODY.PEEK[HEADER.FIELDS (FROM TO SUBJECT DATE)])`);
-            messages.push(parseHeaderResponse(uid, fetchResp));
-          }
-          return messages;
-        } catch (err) {
-          throw imapFail("inbox", err);
-        } finally {
-          await this.imapDisconnect(socket);
-        }
-      }
-      /**
-       * Read a single message by sequence number or UID.
-       */
-      async read(uid, folder = "INBOX") {
-        let socket;
-        try {
-          socket = await this.imapConnect();
-        } catch (err) {
-          throw imapFail("read", err);
-        }
-        try {
-          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
-          const fetchResp = await imapCommand(socket, `FETCH ${uid} (FLAGS BODY[])`);
-          if (!/\{\d+\}/.test(fetchResp)) {
-            return emptyFullMessage(uid);
-          }
-          await imapCommand(socket, `STORE ${uid} +FLAGS (\\Seen)`);
-          return parseFullMessage(uid, fetchResp);
-        } catch (err) {
-          throw imapFail("read", err);
-        } finally {
-          await this.imapDisconnect(socket);
-        }
-      }
-      /**
-       * Search messages using IMAP search criteria.
-       */
-      async search(folder = "INBOX", subject, sender, since, before, unseenOnly = false, limit = 50) {
-        const criteria = ["ALL"];
-        if (subject) criteria.push(`SUBJECT "${subject}"`);
-        if (sender) criteria.push(`FROM "${sender}"`);
-        if (since) criteria.push(`SINCE ${since}`);
-        if (before) criteria.push(`BEFORE ${before}`);
-        if (unseenOnly) criteria.push("UNSEEN");
-        const query = criteria.join(" ");
-        let socket;
-        try {
-          socket = await this.imapConnect();
-        } catch (err) {
-          throw imapFail("search", err);
-        }
-        try {
-          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
-          const searchResp = await imapCommand(socket, `SEARCH ${query}`);
-          const uids = parseSearchResponse(searchResp);
-          if (uids.length === 0) return [];
-          uids.reverse();
-          const messages = [];
-          for (const uid of uids.slice(0, limit)) {
-            const fetchResp = await imapCommand(socket, `FETCH ${uid} (FLAGS BODY.PEEK[HEADER.FIELDS (FROM TO SUBJECT DATE)])`);
-            messages.push(parseHeaderResponse(uid, fetchResp));
-          }
-          return messages;
-        } catch (err) {
-          throw imapFail("search", err);
-        } finally {
-          await this.imapDisconnect(socket);
-        }
-      }
-      /**
-       * Delete a message by UID.
-       */
-      async deleteMessage(uid, folder = "INBOX") {
-        const socket = await this.imapConnect();
-        try {
-          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
-          await imapCommand(socket, `STORE ${uid} +FLAGS (\\Deleted)`);
-          await imapCommand(socket, "EXPUNGE");
-        } finally {
-          await this.imapDisconnect(socket);
-        }
-      }
-      /**
-       * Mark a message as read.
-       */
-      async markRead(uid, folder = "INBOX") {
-        const socket = await this.imapConnect();
-        try {
-          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
-          await imapCommand(socket, `STORE ${uid} +FLAGS (\\Seen)`);
-        } finally {
-          await this.imapDisconnect(socket);
-        }
-      }
-      /**
-       * Count unseen messages in a folder.
-       */
-      async unread(folder = "INBOX") {
-        let socket;
-        try {
-          socket = await this.imapConnect();
-        } catch (err) {
-          throw imapFail("unread", err);
-        }
-        try {
-          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
-          const searchResp = await imapCommand(socket, "SEARCH UNSEEN");
-          return parseSearchResponse(searchResp).length;
-        } catch (err) {
-          throw imapFail("unread", err);
-        } finally {
-          await this.imapDisconnect(socket);
-        }
-      }
-      /**
-       * List available IMAP folders/mailboxes.
-       */
-      async folders() {
-        let socket;
-        try {
-          socket = await this.imapConnect();
-        } catch (err) {
-          throw imapFail("folders", err);
-        }
-        try {
-          const resp = await imapCommand(socket, 'LIST "" "*"');
-          const result = [];
-          for (const line of resp.split("\r\n")) {
-            const m = line.match(/\* LIST \([^)]*\) "[^"]*" "?([^"\r\n]+)"?/i);
-            if (m) result.push(m[1]);
-          }
-          return result;
-        } catch (err) {
-          throw imapFail("folders", err);
-        } finally {
-          await this.imapDisconnect(socket);
-        }
-      }
-      /**
-       * Test IMAP connectivity without reading.
-       */
-      async testImapConnection() {
-        try {
-          const socket = await this.imapConnect();
-          await this.imapDisconnect(socket);
-          return { success: true, message: `Connected to ${this.imapHost}:${this.imapPort}` };
-        } catch (err) {
-          const errMsg = err instanceof Error ? err.message : String(err);
-          return { success: false, message: `IMAP connection failed: ${errMsg}` };
-        }
-      }
-    };
-    imapTagCounter = 0;
-  }
-});
-
-// src/devMailbox.ts
-import { mkdirSync as mkdirSync8, readdirSync as readdirSync6, readFileSync as readFileSync9, writeFileSync as writeFileSync6, unlinkSync as unlinkSync4, existsSync as existsSync10 } from "node:fs";
-import { join as join12 } from "node:path";
-import { randomUUID as randomUUID3 } from "node:crypto";
-function createMessenger() {
-  const debug = process.env.TINA4_DEBUG;
-  const smtpHost = process.env.TINA4_MAIL_HOST;
-  const isProd = !isTruthy(debug) && process.env.NODE_ENV === "production";
-  if (isTruthy(debug)) {
-    return new DevMailbox();
-  }
-  if (!smtpHost) {
-    return new DevMailbox();
-  }
-  if (!isProd) {
-    return new DevMailbox();
-  }
-  return new Messenger();
-}
-var DevMailbox;
-var init_devMailbox = __esm({
-  "src/devMailbox.ts"() {
-    "use strict";
-    init_messenger();
-    init_dotenv();
-    DevMailbox = class {
-      mailboxDir;
-      constructor(mailboxDir) {
-        this.mailboxDir = mailboxDir ?? process.env.TINA4_MAILBOX_DIR ?? "data/mailbox";
-      }
-      /**
-       * Ensure a folder directory exists.
-       */
-      ensureFolder(folder) {
-        const dir = join12(this.mailboxDir, folder);
-        mkdirSync8(dir, { recursive: true });
-        return dir;
-      }
-      /**
-       * Capture an email to the dev mailbox instead of sending it.
-       */
-      capture(to, subject, body, html = false, cc = [], bcc = [], replyTo, attachments = [], from) {
-        const id = randomUUID3();
-        const toList = Array.isArray(to) ? to : [to];
-        const now = (/* @__PURE__ */ new Date()).toISOString();
-        const message = {
-          id,
-          type: "outbox",
-          from: from ?? process.env.TINA4_MAIL_FROM ?? "dev@localhost",
-          to: toList,
-          cc,
-          bcc,
-          reply_to: replyTo,
-          subject,
-          body,
-          html,
-          attachments,
-          date: now,
-          read: false
-        };
-        const outboxDir = this.ensureFolder("outbox");
-        writeFileSync6(join12(outboxDir, `${id}.json`), JSON.stringify(message, null, 2));
-        const inboxDir = this.ensureFolder("inbox");
-        const inboxMessage = { ...message, type: "inbox" };
-        writeFileSync6(join12(inboxDir, `${id}.json`), JSON.stringify(inboxMessage, null, 2));
-        return { success: true, message: "Email captured to dev mailbox", id };
-      }
-      /**
-       * List messages from a folder (default: inbox).
-       */
-      inbox(limit = 50, offset = 0, folder = "inbox") {
-        const dir = this.ensureFolder(folder);
-        const results = [];
-        let files;
-        try {
-          files = readdirSync6(dir).filter((f) => f.endsWith(".json")).sort().reverse();
-        } catch {
-          return [];
-        }
-        const sliced = files.slice(offset, offset + limit);
-        for (const file of sliced) {
-          try {
-            const msg = JSON.parse(readFileSync9(join12(dir, file), "utf-8"));
-            results.push(msg);
-          } catch {
-          }
-        }
-        return results;
-      }
-      /**
-       * Read a single message by ID. Searches all folders.
-       */
-      read(msgId) {
-        const folders = ["inbox", "outbox"];
-        for (const folder of folders) {
-          const filePath = join12(this.mailboxDir, folder, `${msgId}.json`);
-          if (existsSync10(filePath)) {
-            try {
-              const msg = JSON.parse(readFileSync9(filePath, "utf-8"));
-              msg.read = true;
-              writeFileSync6(filePath, JSON.stringify(msg, null, 2));
-              return msg;
-            } catch {
-              return null;
-            }
-          }
-        }
-        return null;
-      }
-      /**
-       * Count unread messages in the inbox.
-       */
-      unreadCount() {
-        const dir = this.ensureFolder("inbox");
-        let count = 0;
-        try {
-          const files = readdirSync6(dir).filter((f) => f.endsWith(".json"));
-          for (const file of files) {
-            try {
-              const msg = JSON.parse(readFileSync9(join12(dir, file), "utf-8"));
-              if (!msg.read) count++;
-            } catch {
-            }
-          }
-        } catch {
-        }
-        return count;
+      unreadCount() {
+        const dir = this.ensureFolder("inbox");
+        let count = 0;
+        try {
+          const files = readdirSync6(dir).filter((f) => f.endsWith(".json"));
+          for (const file of files) {
+            try {
+              const msg = JSON.parse(readFileSync8(join12(dir, file), "utf-8"));
+              if (!msg.read) count++;
+            } catch {
+            }
+          }
+        } catch {
+        }
+        return count;
       }
       /**
        * Delete a message by ID. Removes from all folders.
@@ -17473,7 +16908,7 @@ var init_devMailbox = __esm({
           const subject = subjects[i % subjects.length];
           const from = senders[i % senders.length];
           const date = new Date(Date.now() - i * 36e5).toISOString();
-          const id = randomUUID3();
+          const id = randomUUID2();
           const message = {
             id,
             type: "inbox",
@@ -18512,7 +17947,7 @@ var init_metrics = __esm({
 });
 
 // src/feedback.ts
-import { readFileSync as readFileSync11, existsSync as existsSync12 } from "node:fs";
+import { readFileSync as readFileSync10, existsSync as existsSync12 } from "node:fs";
 import { dirname as dirname5, join as join14, resolve as resolve8 } from "node:path";
 import { fileURLToPath } from "node:url";
 function feedbackEnabled() {
@@ -18653,7 +18088,7 @@ var init_feedback = __esm({
     handleFeedbackWidgetJs = (_req, res) => {
       let body;
       if (existsSync12(WIDGET_BUNDLE_PATH)) {
-        body = readFileSync11(WIDGET_BUNDLE_PATH);
+        body = readFileSync10(WIDGET_BUNDLE_PATH);
       } else {
         body = "console.warn('tina4-feedback-widget bundle not built yet');";
       }
@@ -20361,7 +19796,7 @@ __export(errorOverlay_exports, {
   renderErrorOverlay: () => renderErrorOverlay,
   renderProductionError: () => renderProductionError
 });
-import { readFileSync as readFileSync13, statSync as statSync10 } from "node:fs";
+import { readFileSync as readFileSync12, statSync as statSync10 } from "node:fs";
 import { resolve as resolve10 } from "node:path";
 function esc(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
@@ -20385,7 +19820,7 @@ function parseStack(stack) {
 function readSourceLines(filename, lineno) {
   try {
     const absPath = resolve10(filename);
-    const content = readFileSync13(absPath, "utf-8");
+    const content = readFileSync12(absPath, "utf-8");
     const allLines = content.split("\n");
     const start2 = Math.max(0, lineno - CONTEXT_LINES - 1);
     const end = Math.min(allLines.length, lineno + CONTEXT_LINES);
@@ -21649,8 +21084,8 @@ __export(context_exports, {
   fts5Supported: () => fts5Supported
 });
 import { DatabaseSync as DatabaseSync3 } from "node:sqlite";
-import { existsSync as existsSync14, mkdirSync as mkdirSync10, readFileSync as readFileSync14, readdirSync as readdirSync9, realpathSync as realpathSync2 } from "node:fs";
-import { basename as basename4, dirname as dirname7, extname as extname6, isAbsolute as isAbsolute5, join as join16, relative as relative4, resolve as resolve11 } from "node:path";
+import { existsSync as existsSync14, mkdirSync as mkdirSync10, readFileSync as readFileSync13, readdirSync as readdirSync9, realpathSync as realpathSync2 } from "node:fs";
+import { basename as basename3, dirname as dirname7, extname as extname6, isAbsolute as isAbsolute5, join as join16, relative as relative4, resolve as resolve11 } from "node:path";
 function fts5Supported() {
   try {
     const conn = new DatabaseSync3(":memory:");
@@ -21673,7 +21108,7 @@ function realResolve(abs) {
   } catch {
   }
   try {
-    return join16(realpathSync2(dirname7(abs)), basename4(abs));
+    return join16(realpathSync2(dirname7(abs)), basename3(abs));
   } catch {
     return abs;
   }
@@ -21786,7 +21221,7 @@ var init_context = __esm({
       // ── indexing ───────────────────────────────────────────────
       static chunksFor(label, text) {
         const ext = extname6(label).toLowerCase();
-        const special = SPECIAL_FILES.has(basename4(label).toLowerCase());
+        const special = SPECIAL_FILES.has(basename3(label).toLowerCase());
         if (CODE_EXTS.has(ext) || CONFIG_EXTS.has(ext) || special) {
           return chunkCode(text, label);
         }
@@ -21803,7 +21238,7 @@ var init_context = __esm({
         const stored = label != null ? String(label) : String(file);
         let text;
         try {
-          text = readFileSync14(file, "utf-8");
+          text = readFileSync13(file, "utf-8");
         } catch {
           return 0;
         }
@@ -21883,7 +21318,7 @@ var init_context = __esm({
         if (parts.some((seg) => SKIP_DIRS.has(seg)) || dirParts.some((seg) => seg.startsWith("."))) {
           return -1;
         }
-        if (!_Context.eligible(basename4(rel))) return -1;
+        if (!_Context.eligible(basename3(rel))) return -1;
         const stored = rel;
         if (!existsSync14(abs)) {
           this.conn.prepare("DELETE FROM chunks WHERE path = ?").run(stored);
@@ -21975,7 +21410,7 @@ var init_context = __esm({
 });
 
 // src/websocketBackplane.ts
-import { randomUUID as randomUUID4 } from "node:crypto";
+import { randomUUID as randomUUID3 } from "node:crypto";
 function createBackplane(url) {
   const backend = (process.env.TINA4_WS_BACKPLANE ?? "").trim().toLowerCase();
   switch (backend) {
@@ -22005,7 +21440,7 @@ function buildEnvelope(src, kind, message, opts = {}) {
   return envelope;
 }
 function randomInstanceId() {
-  return randomUUID4().replace(/-/g, "").slice(0, 16);
+  return randomUUID3().replace(/-/g, "").slice(0, 16);
 }
 var RedisBackplane, NATSBackplane, WS_BACKPLANE_CHANNEL, WsBackplaneManager;
 var init_websocketBackplane = __esm({
@@ -22233,7 +21668,7 @@ __export(websocket_exports, {
 });
 import { createServer } from "node:http";
 import { createHash as createHash4 } from "node:crypto";
-import { randomUUID as randomUUID5 } from "node:crypto";
+import { randomUUID as randomUUID4 } from "node:crypto";
 function computeAcceptKey(key) {
   return createHash4("sha1").update(key + MAGIC_STRING).digest("base64");
 }
@@ -22361,7 +21796,7 @@ function parseFrame(data) {
   return { fin: !!fin, opcode, payload: Buffer.from(payload), bytesConsumed: offset + payloadLen };
 }
 function createRouteConnection(socket, path8, headers, params, auth) {
-  const id = randomUUID5().slice(0, 8);
+  const id = randomUUID4().slice(0, 8);
   const send = (message) => {
     try {
       socket.write(buildFrame(OP_TEXT, Buffer.from(message, "utf-8")));
@@ -22918,7 +22353,7 @@ var init_websocket = __esm({
         }
         responseLines.push("", "");
         socket.write(responseLines.join("\r\n"));
-        const clientId = randomUUID5().slice(0, 8);
+        const clientId = randomUUID4().slice(0, 8);
         const client = {
           id: clientId,
           socket,
@@ -23206,7 +22641,7 @@ var init_websocket = __esm({
 
 // src/queueBackends/rabbitmqBackend.ts
 import { execFileSync } from "node:child_process";
-import { randomUUID as randomUUID6 } from "node:crypto";
+import { randomUUID as randomUUID5 } from "node:crypto";
 function parseAmqpUrl(url) {
   const config = {};
   let rest = url.replace(/^amqps:\/\//, "").replace(/^amqp:\/\//, "");
@@ -23650,7 +23085,7 @@ var init_rabbitmqBackend = __esm({
         }
       }
       push(queue, payload, _delay) {
-        const id = randomUUID6();
+        const id = randomUUID5();
         const now = (/* @__PURE__ */ new Date()).toISOString();
         const job = {
           id,
@@ -23689,7 +23124,7 @@ var init_rabbitmqBackend = __esm({
 
 // src/queueBackends/kafkaBackend.ts
 import { execFileSync as execFileSync2 } from "node:child_process";
-import { randomUUID as randomUUID7 } from "node:crypto";
+import { randomUUID as randomUUID6 } from "node:crypto";
 function kafkaSecurityConfig(env = process.env) {
   const mapping = [
     ["security.protocol", "SECURITY_PROTOCOL"],
@@ -23713,7 +23148,7 @@ var init_kafkaBackend = __esm({
     "use strict";
     API_PRODUCE = 0;
     API_FETCH = 1;
-    KafkaBackend = class {
+    KafkaBackend = class _KafkaBackend {
       brokers;
       groupId;
       constructor(config) {
@@ -24075,12 +23510,15 @@ var init_kafkaBackend = __esm({
             if (errCode === 0) {
               finish("__PUBLISHED__", 0);
             } else {
+              // Report the CODE, not just "it failed" \u2014 the caller decides
+              // whether it is retriable (3/5, the async topic-creation race)
+              // or fatal (e.g. 29 TOPIC_AUTHORIZATION_FAILED).
               process.stderr.write("Produce error code " + errCode);
-              finish("__ERROR__" + errCode, 0);
+              finish("__PRODUCEERROR__" + errCode, 0);
             }
           } catch (e) {
             process.stderr.write("produce parse: " + e.message);
-            finish("__ERROR__", 0);
+            finish("__PARSEERROR__produce: " + e.message, 0);
           }
           return;
         } else if (operation === "get") {
@@ -24094,6 +23532,7 @@ var init_kafkaBackend = __esm({
             pos += 4;                                   // throttleTimeMs (v1+)
             const topicCount = buffer.readInt32BE(pos); pos += 4;
             let out = "__EMPTY__";
+            let fatalCode = 0;
             for (let t = 0; t < topicCount; t++) {
               const tl = buffer.readInt16BE(pos); pos += 2 + tl;
               const pc = buffer.readInt32BE(pos); pos += 4;
@@ -24105,6 +23544,14 @@ var init_kafkaBackend = __esm({
                 const abortedCount = buffer.readInt32BE(pos); pos += 4;
                 if (abortedCount > 0) pos += abortedCount * 16; // (-1 => none, skip)
                 const recSetSize = buffer.readInt32BE(pos); pos += 4;
+                // 3 = UNKNOWN_TOPIC_OR_PARTITION, 5 = LEADER_NOT_AVAILABLE:
+                // "nothing to read here yet", which a consumer that starts
+                // before its producer hits on every cold start. Any OTHER code
+                // (29 TOPIC_AUTHORIZATION_FAILED, 13 STALE_CONTROLLER_EPOCH, \u2026)
+                // is a real failure and must NOT be reported as an empty queue.
+                if (errCode !== 0 && errCode !== 3 && errCode !== 5) {
+                  fatalCode = errCode;
+                }
                 if (errCode === 0 && recSetSize > 0) {
                   const val = firstRecordValue(buffer, pos, pos + recSetSize);
                   if (val !== null) out = val;
@@ -24112,21 +23559,33 @@ var init_kafkaBackend = __esm({
                 pos += recSetSize > 0 ? recSetSize : 0;
               }
             }
+            if (fatalCode !== 0) {
+              process.stderr.write("Fetch error code " + fatalCode);
+              finish("__FETCHERROR__" + fatalCode, 0);
+              return;
+            }
             finish(out, 0);
           } catch (e) {
+            // A parse failure is NOT an empty queue either \u2014 say so.
             process.stderr.write("fetch parse: " + e.message);
-            finish("__EMPTY__", 0);
+            finish("__PARSEERROR__fetch: " + e.message, 0);
           }
           return;
         }
       });
 
+      // Report the reason on STDOUT and exit 0. Writing it to stderr and
+      // exiting non-zero LOST it: stderr to a pipe is an async write and
+      // process.exit() truncates it, so the parent saw an empty stderr and fell
+      // back to execFileSync's message -- which embeds this entire script.
+      // stdout is flushed by finish()'s write callback, so it survives.
       sock.on("error", (err) => {
-        process.stderr.write(err.message);
-        finish("", 1);
+        finish("__TRANSPORTERROR__" + err.message, 0);
       });
 
-      var timer = setTimeout(() => { finish("", 1); }, 10000);
+      var timer = setTimeout(() => {
+        finish("__TRANSPORTERROR__timed out after 10s talking to " + host + ":" + port, 0);
+      }, 10000);
     `;
         try {
           const result = execFileSync2(process.execPath, ["-e", script], {
@@ -24135,12 +23594,51 @@ var init_kafkaBackend = __esm({
             stdio: ["pipe", "pipe", "pipe"]
           });
           return result;
-        } catch {
-          return "";
+        } catch (err) {
+          const e = err;
+          const reason = String(e.stderr ?? "").trim() || e.message || "unknown error";
+          const firstLine2 = reason.split("\n", 1)[0].slice(0, 200);
+          return "__TRANSPORTERROR__" + firstLine2;
+        }
+      }
+      /**
+       * Sleep synchronously between produce retries.
+       *
+       * `push()` is synchronous (the whole backend drives its socket through a child
+       * process), so there is no event loop to await on. `Atomics.wait` on a
+       * SharedArrayBuffer is the stdlib way to block a thread for a fixed time --
+       * no dependency, no busy-wait burning CPU.
+       */
+      static sleepSync(ms) {
+        const shared = new Int32Array(new SharedArrayBuffer(4));
+        Atomics.wait(shared, 0, 0, ms);
+      }
+      /**
+       * Turn a sentinel from the protocol child into a thrown error, or return.
+       *
+       * The wording matches the Python and PHP backends exactly -- the parity rule
+       * covers user-visible error messages, not just behaviour.
+       */
+      static assertNoError(result, operation, topic) {
+        const fatal = /^__(PRODUCEERROR|FETCHERROR)__(\d+)/.exec(result);
+        if (fatal) {
+          throw new Error(
+            `Kafka rejected the ${operation} for topic ${topic}: error code ${fatal[2]}`
+          );
+        }
+        if (result.startsWith("__TRANSPORTERROR__")) {
+          throw new Error(
+            `Kafka ${operation} for topic ${topic} failed: ` + result.slice("__TRANSPORTERROR__".length)
+          );
+        }
+        if (result.startsWith("__PARSEERROR__")) {
+          throw new Error(
+            `Kafka ${operation} for topic ${topic} returned an unreadable response: ` + result.slice("__PARSEERROR__".length)
+          );
         }
       }
       push(queue, payload, _delay) {
-        const id = randomUUID7();
+        const id = randomUUID6();
         const now = (/* @__PURE__ */ new Date()).toISOString();
         const job = {
           id,
@@ -24150,14 +23648,25 @@ var init_kafkaBackend = __esm({
           attempts: 0,
           delayUntil: null
         };
-        const result = this.execSync("publish", queue, JSON.stringify(job));
-        if (!result.includes("__PUBLISHED__")) {
-          throw new Error("Kafka publish failed");
+        const body = JSON.stringify(job);
+        let result = "";
+        for (let attempt = 1; attempt <= 10; attempt++) {
+          result = this.execSync("publish", queue, body);
+          if (result.includes("__PUBLISHED__")) {
+            return id;
+          }
+          const retriable = /^__PRODUCEERROR__(3|5)\b/.test(result);
+          if (!retriable || attempt === 10) {
+            break;
+          }
+          _KafkaBackend.sleepSync(200);
         }
-        return id;
+        _KafkaBackend.assertNoError(result, "produce", queue);
+        throw new Error(`Kafka publish failed for topic ${queue}: ${result || "no response"}`);
       }
       pop(queue) {
         const result = this.execSync("get", queue);
+        _KafkaBackend.assertNoError(result, "fetch", queue);
         if (!result || result === "__EMPTY__" || result === "__UNSUPPORTED__") return null;
         try {
           return JSON.parse(result);
@@ -24175,7 +23684,7 @@ var init_kafkaBackend = __esm({
 });
 
 // src/queueBackends/mongoBackend.ts
-import { randomUUID as randomUUID8 } from "node:crypto";
+import { randomUUID as randomUUID7 } from "node:crypto";
 import { execFileSync as execFileSync3 } from "node:child_process";
 var MongoBackend2;
 var init_mongoBackend = __esm({
@@ -24488,7 +23997,7 @@ var init_mongoBackend = __esm({
         }
       }
       push(queue, payload, delay) {
-        const id = randomUUID8();
+        const id = randomUUID7();
         const now = (/* @__PURE__ */ new Date()).toISOString();
         const job = {
           id,
@@ -24623,9 +24132,9 @@ var init_job = __esm({
 });
 
 // src/queueBackends/liteBackend.ts
-import { mkdirSync as mkdirSync11, readdirSync as readdirSync10, readFileSync as readFileSync15, writeFileSync as writeFileSync8, unlinkSync as unlinkSync5, existsSync as existsSync15 } from "node:fs";
+import { mkdirSync as mkdirSync11, readdirSync as readdirSync10, readFileSync as readFileSync14, writeFileSync as writeFileSync8, unlinkSync as unlinkSync5, existsSync as existsSync15 } from "node:fs";
 import { join as join17 } from "node:path";
-import { randomUUID as randomUUID9 } from "node:crypto";
+import { randomUUID as randomUUID8 } from "node:crypto";
 var LiteBackend;
 var init_liteBackend = __esm({
   "src/queueBackends/liteBackend.ts"() {
@@ -24677,7 +24186,7 @@ var init_liteBackend = __esm({
       }
       push(queue, payload, delay, priority) {
         const dir = this.ensureDir(queue);
-        const id = randomUUID9();
+        const id = randomUUID8();
         const now = (/* @__PURE__ */ new Date()).toISOString();
         const job = {
           id,
@@ -24713,7 +24222,7 @@ var init_liteBackend = __esm({
           const filePath = join17(dir, filename);
           let job;
           try {
-            job = JSON.parse(readFileSync15(filePath, "utf-8"));
+            job = JSON.parse(readFileSync14(filePath, "utf-8"));
           } catch {
             continue;
           }
@@ -24777,7 +24286,7 @@ var init_liteBackend = __esm({
           const filePath = join17(reservedDir, filename);
           let record;
           try {
-            record = JSON.parse(readFileSync15(filePath, "utf-8"));
+            record = JSON.parse(readFileSync14(filePath, "utf-8"));
           } catch {
             continue;
           }
@@ -24890,7 +24399,7 @@ var init_liteBackend = __esm({
         let count = 0;
         for (const file of files) {
           try {
-            const job = JSON.parse(readFileSync15(join17(scanDir, file), "utf-8"));
+            const job = JSON.parse(readFileSync14(join17(scanDir, file), "utf-8"));
             if (job.status === status2) count++;
           } catch {
           }
@@ -24947,7 +24456,7 @@ var init_liteBackend = __esm({
           const files = readdirSync10(dir).filter((f) => f.endsWith(".queue-data")).sort();
           for (const file of files) {
             try {
-              const job = JSON.parse(readFileSync15(join17(dir, file), "utf-8"));
+              const job = JSON.parse(readFileSync14(join17(dir, file), "utf-8"));
               const attempts = job.attempts || 0;
               if (attempts > 0 && attempts < maxRetries) {
                 results.push(job);
@@ -24973,7 +24482,7 @@ var init_liteBackend = __esm({
             const failedDir = join17(this.basePath, q, "failed");
             const filePath = join17(failedDir, `${jobId}.queue-data`);
             if (existsSync15(filePath)) {
-              const job = JSON.parse(readFileSync15(filePath, "utf-8"));
+              const job = JSON.parse(readFileSync14(filePath, "utf-8"));
               job.status = "pending";
               job.attempts = (job.attempts || 0) + 1;
               job.error = void 0;
@@ -24997,7 +24506,7 @@ var init_liteBackend = __esm({
           const files = readdirSync10(failedDir).filter((f) => f.endsWith(".queue-data")).sort();
           for (const file of files) {
             try {
-              const job = JSON.parse(readFileSync15(join17(failedDir, file), "utf-8"));
+              const job = JSON.parse(readFileSync14(join17(failedDir, file), "utf-8"));
               if ((job.attempts || 0) >= maxRetries) {
                 job.status = "dead";
                 results.push(job);
@@ -25031,7 +24540,7 @@ var init_liteBackend = __esm({
             const files = readdirSync10(dir).filter((f) => f.endsWith(".queue-data"));
             for (const file of files) {
               try {
-                const job = JSON.parse(readFileSync15(join17(dir, file), "utf-8"));
+                const job = JSON.parse(readFileSync14(join17(dir, file), "utf-8"));
                 if (job.status === status2) {
                   unlinkSync5(join17(dir, file));
                   count++;
@@ -25058,7 +24567,7 @@ var init_liteBackend = __esm({
           for (const file of files) {
             try {
               const filePath = join17(failedDir, file);
-              const job = JSON.parse(readFileSync15(filePath, "utf-8"));
+              const job = JSON.parse(readFileSync14(filePath, "utf-8"));
               if ((job.attempts || 0) >= maxRetries) {
                 continue;
               }
@@ -25090,7 +24599,7 @@ var init_liteBackend = __esm({
           const filePath = join17(dir, file);
           let job;
           try {
-            job = JSON.parse(readFileSync15(filePath, "utf-8"));
+            job = JSON.parse(readFileSync14(filePath, "utf-8"));
           } catch {
             continue;
           }
@@ -27580,7 +27089,7 @@ ${end}
 
 // src/devAdmin.ts
 import { cpus as osCpus } from "node:os";
-import { readFileSync as readFileSync19, writeFileSync as writeFileSync12, existsSync as existsSync19, readdirSync as readdirSync14, mkdirSync as mkdirSync14, copyFileSync, statSync as statSync15 } from "node:fs";
+import { readFileSync as readFileSync18, writeFileSync as writeFileSync12, existsSync as existsSync19, readdirSync as readdirSync14, mkdirSync as mkdirSync14, copyFileSync, statSync as statSync15 } from "node:fs";
 import { join as join21, dirname as dirname9, resolve as resolve15, relative as relative8 } from "node:path";
 import { fileURLToPath as fileURLToPath3 } from "node:url";
 import { timingSafeEqual as timingSafeEqual2 } from "node:crypto";
@@ -27766,7 +27275,7 @@ function resolveDevEnvVar(key) {
   if (live !== void 0 && live !== "") return live;
   const envPath = join21(process.cwd(), ".env");
   if (!existsSync19(envPath)) return "";
-  for (const line of readFileSync19(envPath, "utf-8").split("\n")) {
+  for (const line of readFileSync18(envPath, "utf-8").split("\n")) {
     const t = line.trim();
     if (!t || t.startsWith("#") || !t.includes("=")) continue;
     const eq = t.indexOf("=");
@@ -27776,7 +27285,7 @@ function resolveDevEnvVar(key) {
 }
 function upsertDevEnvVar(key, value) {
   const envPath = join21(process.cwd(), ".env");
-  const lines = existsSync19(envPath) ? readFileSync19(envPath, "utf-8").split("\n") : [];
+  const lines = existsSync19(envPath) ? readFileSync18(envPath, "utf-8").split("\n") : [];
   let found = false;
   const out = [];
   for (const line of lines) {
@@ -27809,7 +27318,7 @@ function parseEnvFile() {
   const envPath = join21(process.cwd(), ".env");
   const result = {};
   if (!existsSync19(envPath)) return result;
-  const lines = readFileSync19(envPath, "utf-8").split("\n");
+  const lines = readFileSync18(envPath, "utf-8").split("\n");
   for (const line of lines) {
     const trimmed = line.trim();
     if (!trimmed || trimmed.startsWith("#") || !trimmed.includes("=")) continue;
@@ -28166,7 +27675,7 @@ var init_devAdmin = __esm({
         for (const rel of ["../../../package.json", "../../package.json"]) {
           const p = resolve15(__dirname2, rel);
           if (existsSync19(p)) {
-            const pkg = JSON.parse(readFileSync19(p, "utf-8"));
+            const pkg = JSON.parse(readFileSync18(p, "utf-8"));
             if (pkg.version) return pkg.version;
           }
         }
@@ -28824,7 +28333,7 @@ var init_devAdmin = __esm({
             for (const filename of readdirSync14(queueDir).sort()) {
               if (!filename.endsWith(".queue-data")) continue;
               try {
-                const job = JSON.parse(readFileSync19(join21(queueDir, filename), "utf-8"));
+                const job = JSON.parse(readFileSync18(join21(queueDir, filename), "utf-8"));
                 jobs.push(mapQueueJob(job, topic, "pending"));
               } catch {
               }
@@ -29310,7 +28819,7 @@ var init_devAdmin = __esm({
       }
       try {
         const envPath = join21(process.cwd(), ".env");
-        const lines = existsSync19(envPath) ? readFileSync19(envPath, "utf-8").split("\n") : [];
+        const lines = existsSync19(envPath) ? readFileSync18(envPath, "utf-8").split("\n") : [];
         const keysFound = { TINA4_DATABASE_URL: false, TINA4_DATABASE_USERNAME: false, TINA4_DATABASE_PASSWORD: false };
         const newLines = [];
         for (const line of lines) {
@@ -29356,7 +28865,7 @@ var init_devAdmin = __esm({
           const metaFile = join21(entryPath, "meta.json");
           if (statSync15(entryPath).isDirectory() && existsSync19(metaFile)) {
             try {
-              const meta = JSON.parse(readFileSync19(metaFile, "utf-8"));
+              const meta = JSON.parse(readFileSync18(metaFile, "utf-8"));
               meta.id = entry;
               const srcDir = join21(entryPath, "src");
               if (existsSync19(srcDir)) {
@@ -29571,7 +29080,7 @@ var init_devAdmin = __esm({
         return;
       }
       try {
-        const content = readFileSync19(target, "utf-8");
+        const content = readFileSync18(target, "utf-8");
         const path8 = relative8(root, target);
         res.json({ path: path8, content, language: devAdminLanguage(path8), bytes: Buffer.byteLength(content, "utf-8") });
       } catch (e) {
@@ -29613,7 +29122,7 @@ var init_devAdmin = __esm({
         return;
       }
       try {
-        const buf = readFileSync19(target);
+        const buf = readFileSync18(target);
         const ext = target.slice(target.lastIndexOf(".") + 1).toLowerCase();
         const mime = {
           js: "application/javascript",
@@ -30041,7 +29550,7 @@ var init_devAdmin = __esm({
 });
 
 // src/i18n.ts
-import { readFileSync as readFileSync20, readdirSync as readdirSync15, existsSync as existsSync20 } from "node:fs";
+import { readFileSync as readFileSync19, readdirSync as readdirSync15, existsSync as existsSync20 } from "node:fs";
 import { join as join22, resolve as resolve16 } from "node:path";
 var I18n;
 var init_i18n = __esm({
@@ -30138,7 +29647,7 @@ var init_i18n = __esm({
         const filePath = join22(this._localeDir, `${locale}.json`);
         if (existsSync20(filePath)) {
           try {
-            const raw = readFileSync20(filePath, "utf-8");
+            const raw = readFileSync19(filePath, "utf-8");
             const data = JSON.parse(raw);
             this._translations.set(locale, _I18n._flatten(data));
             return;
@@ -30151,7 +29660,7 @@ var init_i18n = __esm({
           const yamlPath = join22(this._localeDir, `${locale}${ext}`);
           if (existsSync20(yamlPath)) {
             try {
-              const raw = readFileSync20(yamlPath, "utf-8");
+              const raw = readFileSync19(yamlPath, "utf-8");
               const data = _I18n._parseSimpleYaml(raw);
               this._translations.set(locale, _I18n._flatten(data));
               return;
@@ -30819,6 +30328,36 @@ var init_docsAutoDiscovery = __esm({
   }
 });
 
+// src/sessionHandlers/childError.ts
+function childFailureReason(err) {
+  const e = err ?? {};
+  const stderr = String(e.stderr ?? "").trim();
+  if (stderr !== "") {
+    return firstLine(stderr);
+  }
+  if (e.code === "ETIMEDOUT" || e.signal) {
+    return `timed out or was killed (${e.code ?? e.signal})`;
+  }
+  if (typeof e.status === "number" && e.status !== 0) {
+    return `child exited with code ${e.status} and no output`;
+  }
+  return firstLine(String(e.message ?? "unknown error"));
+}
+function firstLine(text) {
+  const line = text.split("\n", 1)[0] ?? "";
+  return line.length > MAX_FALLBACK ? `${line.slice(0, MAX_FALLBACK)}...` : line;
+}
+function childFailureError(label, err) {
+  return new Error(`${label} command failed: ${childFailureReason(err)}`);
+}
+var MAX_FALLBACK;
+var init_childError = __esm({
+  "src/sessionHandlers/childError.ts"() {
+    "use strict";
+    MAX_FALLBACK = 200;
+  }
+});
+
 // src/sessionHandlers/respClient.ts
 import { execFileSync as execFileSync4 } from "node:child_process";
 function respCommandSync(target, args, label = "Redis") {
@@ -30938,7 +30477,7 @@ function respCommandSync(target, args, label = "Redis") {
       stdio: ["pipe", "pipe", "pipe"]
     });
   } catch (err) {
-    throw new Error(`${label} command failed: ${err.message}`);
+    throw childFailureError(label, err);
   }
   if (result === "__NULL__") return "";
   if (result.startsWith("__ERR__")) {
@@ -30949,6 +30488,7 @@ function respCommandSync(target, args, label = "Redis") {
 var init_respClient = __esm({
   "src/sessionHandlers/respClient.ts"() {
     "use strict";
+    init_childError();
   }
 });
 
@@ -30967,6 +30507,7 @@ var moduleRequire, RedisNpmSessionHandler;
 var init_redisHandler = __esm({
   "src/sessionHandlers/redisHandler.ts"() {
     "use strict";
+    init_childError();
     init_respClient();
     moduleRequire = createRequire8(import.meta.url);
     RedisNpmSessionHandler = class {
@@ -31027,9 +30568,17 @@ var init_redisHandler = __esm({
       (async () => {
         try {
           const redis = require("redis");
+          // reconnectStrategy: false \u2014 this child runs ONE command and exits, so
+          // retrying inside it is pointless: the handler is called again on the
+          // next request anyway. With the driver's default strategy a refused
+          // connection never rejects, the child hangs until execFileSync's 5s
+          // timeout kills it, and the caller is told "timed out" when the truth
+          // is "connection refused". Off, connect() rejects in ~5ms with the real
+          // reason -- a better message AND no 5s stall per request when Redis is
+          // down.
           const clientOpts = useUrl
-            ? { url }
-            : { socket: { host, port }, password: password || undefined, database: db };
+            ? { url, socket: { reconnectStrategy: false } }
+            : { socket: { host, port, reconnectStrategy: false }, password: password || undefined, database: db };
           const client = redis.createClient(clientOpts);
           client.on("error", () => {});
           await client.connect();
@@ -31043,8 +30592,10 @@ var init_redisHandler = __esm({
           const out = (result === null || result === undefined) ? "__NULL__" : String(result);
           process.stdout.write(out, () => process.exit(0));
         } catch (err) {
-          process.stderr.write(String((err && err.message) || err));
-          process.exit(1);
+          // Exit from the write CALLBACK: stderr to a pipe is an async write and
+          // a bare process.exit() truncates it, which left the parent with an
+          // empty stderr and nothing but execFileSync's script-dump message.
+          process.stderr.write(String((err && err.message) || err), () => process.exit(1));
         }
       })();
     `;
@@ -31056,7 +30607,7 @@ var init_redisHandler = __esm({
             stdio: ["pipe", "pipe", "pipe"]
           });
         } catch (err) {
-          throw new Error(`Redis command failed: ${err.message}`);
+          throw childFailureError("Redis", err);
         }
         if (result === "__NULL__") return "";
         return result;
@@ -31188,8 +30739,10 @@ function mongoCommandSync(target, command, args, label = "MongoDB") {
           process.stdout.write(out, () => process.exit(0));
         } catch (err) {
           try { if (client) await client.close(); } catch (e) {}
-          process.stderr.write(String((err && err.message) || err));
-          process.exit(1);
+          // Exit from the write CALLBACK: stderr to a pipe is an async write and
+          // a bare process.exit() truncates it, which left the parent with an
+          // empty stderr and nothing but execFileSync's script-dump message.
+          process.stderr.write(String((err && err.message) || err), () => process.exit(1));
         }
       })();
     } else {
@@ -31330,12 +30883,13 @@ function mongoCommandSync(target, command, args, label = "MongoDB") {
       stdio: ["pipe", "pipe", "pipe"]
     });
   } catch (err) {
-    throw new Error(`${label} command failed: ${err.message}`);
+    throw childFailureError(label, err);
   }
 }
 var init_mongoClient = __esm({
   "src/sessionHandlers/mongoClient.ts"() {
     "use strict";
+    init_childError();
   }
 });
 
@@ -31488,7 +31042,7 @@ __export(session_exports, {
   sessionCookieName: () => sessionCookieName
 });
 import { randomBytes as randomBytes6 } from "node:crypto";
-import { existsSync as existsSync22, mkdirSync as mkdirSync17, readFileSync as readFileSync22, writeFileSync as writeFileSync15, unlinkSync as unlinkSync7, readdirSync as readdirSync16 } from "node:fs";
+import { existsSync as existsSync22, mkdirSync as mkdirSync17, readFileSync as readFileSync21, writeFileSync as writeFileSync15, unlinkSync as unlinkSync7, readdirSync as readdirSync16 } from "node:fs";
 import { join as join24 } from "node:path";
 function isSecureScheme(forwardedProto, socketEncrypted) {
   const forwarded = (forwardedProto ?? "").trim();
@@ -31541,7 +31095,7 @@ var init_session = __esm({
         const filePath = this.filePath(sessionId);
         try {
           if (!existsSync22(filePath)) return null;
-          const raw = readFileSync22(filePath, "utf-8");
+          const raw = readFileSync21(filePath, "utf-8");
           const wrapper = JSON.parse(raw);
           if (wrapper._expires && wrapper._expires > 0 && Date.now() / 1e3 > wrapper._expires) {
             try {
@@ -31577,7 +31131,7 @@ var init_session = __esm({
             if (!file.endsWith(".json")) continue;
             const fullPath = join24(this.storagePath, file);
             try {
-              const raw = readFileSync22(fullPath, "utf-8");
+              const raw = readFileSync21(fullPath, "utf-8");
               const wrapper = JSON.parse(raw);
               if (wrapper._expires && wrapper._expires > 0 && now > wrapper._expires) {
                 unlinkSync7(fullPath);
@@ -32094,7 +31648,7 @@ var init_events = __esm({
 // src/server.ts
 import { createServer as createServer2 } from "node:http";
 import { resolve as resolve18, dirname as dirname10, join as join25, relative as relative9 } from "node:path";
-import { existsSync as existsSync23, readdirSync as readdirSync17, readFileSync as readFileSync23, statSync as statSync16 } from "node:fs";
+import { existsSync as existsSync23, readdirSync as readdirSync17, readFileSync as readFileSync22, statSync as statSync16 } from "node:fs";
 import { isatty } from "node:tty";
 import { fileURLToPath as fileURLToPath4 } from "node:url";
 import { execFileSync as execFileSync7, exec } from "node:child_process";
@@ -32156,7 +31710,7 @@ async function autoMigrateOnStartup(migrationDir = "migrations", base = process.
 function readPackageVersion() {
   try {
     const pkgPath = resolve18(dirname10(fileURLToPath4(import.meta.url)), "..", "..", "..", "package.json");
-    const pkg = JSON.parse(readFileSync23(pkgPath, "utf-8"));
+    const pkg = JSON.parse(readFileSync22(pkgPath, "utf-8"));
     return pkg.version ?? "0.0.0";
   } catch {
     return "0.0.0";
@@ -32986,7 +32540,7 @@ ${reset2}
             res.raw.writeHead(200, void 0, { "Content-Type": "text/html; charset=utf-8" });
             res.raw.end(html);
           } else {
-            const html = readFileSync23(resolve18(templatesDir, tplFile), "utf-8");
+            const html = readFileSync22(resolve18(templatesDir, tplFile), "utf-8");
             res.raw.writeHead(200, void 0, { "Content-Type": "text/html; charset=utf-8" });
             res.raw.end(html);
           }
@@ -33377,7 +32931,7 @@ var init_constants = __esm({
 });
 
 // src/scss.ts
-import { readFileSync as readFileSync24, writeFileSync as writeFileSync16, existsSync as existsSync24, mkdirSync as mkdirSync18, readdirSync as readdirSync18 } from "node:fs";
+import { readFileSync as readFileSync23, writeFileSync as writeFileSync16, existsSync as existsSync24, mkdirSync as mkdirSync18, readdirSync as readdirSync18 } from "node:fs";
 import { join as join26, resolve as resolve19, dirname as dirname11 } from "node:path";
 function compileString(scss, importPaths, variables) {
   const imported = /* @__PURE__ */ new Set();
@@ -33408,7 +32962,7 @@ function resolveImports(content, paths, imported) {
     for (const candidate of candidates) {
       if (existsSync24(candidate) && !imported.has(candidate)) {
         imported.add(candidate);
-        const fileContent = readFileSync24(candidate, "utf-8");
+        const fileContent = readFileSync23(candidate, "utf-8");
         return resolveImports(fileContent, [dirname11(candidate), ...paths], imported);
       }
     }
@@ -33749,7 +33303,7 @@ var init_scss = __esm({
       /** Compile an SCSS file to CSS. */
       compileFile(filePath) {
         const absPath = resolve19(filePath);
-        const content = readFileSync24(absPath, "utf-8");
+        const content = readFileSync23(absPath, "utf-8");
         const paths = [dirname11(absPath), ...this._importPaths];
         return compileString(content, paths, { ...this._variables });
       }
@@ -33772,7 +33326,7 @@ var init_scss = __esm({
         const imported = /* @__PURE__ */ new Set();
         let merged = "";
         for (const file of files) {
-          const content = readFileSync24(file, "utf-8");
+          const content = readFileSync23(file, "utf-8");
           imported.add(file);
           merged += resolveImports(content, paths, imported) + "\n";
         }
@@ -33789,7 +33343,7 @@ var init_scss = __esm({
         if (!existsSync24(outDir)) mkdirSync18(outDir, { recursive: true });
         let existing = null;
         try {
-          existing = existsSync24(absOutput) ? readFileSync24(absOutput, "utf-8") : null;
+          existing = existsSync24(absOutput) ? readFileSync23(absOutput, "utf-8") : null;
         } catch {
           existing = null;
         }
@@ -33873,10 +33427,10 @@ var init_mqttMessage = __esm({
 });
 
 // src/mqtt.ts
-import net3 from "node:net";
-import tls2 from "node:tls";
+import net2 from "node:net";
+import tls from "node:tls";
 import { randomBytes as randomBytes7 } from "node:crypto";
-import { existsSync as existsSync25, readFileSync as readFileSync25 } from "node:fs";
+import { existsSync as existsSync25, readFileSync as readFileSync24 } from "node:fs";
 var MqttError, MqttTimeoutError, CONNECT, CONNACK, PUBLISH, PUBACK, SUBSCRIBE, SUBACK, PINGREQ, PINGRESP, DISCONNECT, PROTOCOL_LEVEL, DEFAULT_PORT, DEFAULT_TLS_PORT, DEFAULT_URL, DEFAULT_KEEPALIVE, SUBSCRIPTION_REFUSED, MAX_REMAINING_LENGTH, QOS2_REFUSED_MESSAGE, CONNACK_RETURN_CODES, Mqtt;
 var init_mqtt = __esm({
   "src/mqtt.ts"() {
@@ -34341,10 +33895,10 @@ var init_mqtt = __esm({
               servername: this.host,
               rejectUnauthorized: this.tlsVerify
             };
-            if (this.tlsVerify && this.caFile) opts.ca = readFileSync25(this.caFile);
-            sock = tls2.connect(opts, () => settle(() => resolve21(sock)));
+            if (this.tlsVerify && this.caFile) opts.ca = readFileSync24(this.caFile);
+            sock = tls.connect(opts, () => settle(() => resolve21(sock)));
           } else {
-            sock = net3.createConnection({ host: this.host, port: this.port }, () => settle(() => resolve21(sock)));
+            sock = net2.createConnection({ host: this.host, port: this.port }, () => settle(() => resolve21(sock)));
           }
           sock.once("error", (err) => {
             settle(() => {
@@ -34895,7 +34449,7 @@ import https from "node:https";
 import { URL as URL2 } from "node:url";
 import { randomBytes as randomBytes8 } from "node:crypto";
 import { promises as fsp, createWriteStream } from "node:fs";
-import { basename as basename6 } from "node:path";
+import { basename as basename5 } from "node:path";
 import { pipeline } from "node:stream/promises";
 function sameOrigin(urlA, urlB) {
   try {
@@ -35185,7 +34739,7 @@ var init_api = __esm({
               error: err instanceof Error ? err.message : String(err)
             };
           }
-          uploadName = filename || basename6(filePath);
+          uploadName = filename || basename5(filePath);
         } else {
           return { http_code: null, body: null, headers: {}, error: "upload requires filePath or fileBytes" };
         }
@@ -35541,6 +35095,777 @@ var init_api = __esm({
   }
 });
 
+// src/messenger.ts
+import net3 from "node:net";
+import tls2 from "node:tls";
+import { readFileSync as readFileSync25 } from "node:fs";
+import { basename as basename6 } from "node:path";
+import { randomUUID as randomUUID9 } from "node:crypto";
+function tlsRejectUnauthorized() {
+  return !isTruthy(process.env.TINA4_MAIL_TLS_INSECURE);
+}
+function readResponse(socket) {
+  return new Promise((resolve21, reject) => {
+    let buffer = "";
+    const onData = (chunk) => {
+      buffer += chunk.toString("utf-8");
+      const lines = buffer.split("\r\n");
+      for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        if (line.length < 3) continue;
+        const code = parseInt(line.substring(0, 3), 10);
+        if (line.length >= 4 && line[3] === " ") {
+          socket.removeListener("data", onData);
+          socket.removeListener("error", onError);
+          resolve21({ code, text: buffer.trim() });
+          return;
+        }
+      }
+    };
+    const onError = (err) => {
+      socket.removeListener("data", onData);
+      reject(err);
+    };
+    socket.on("data", onData);
+    socket.on("error", onError);
+  });
+}
+function sendCommand(socket, command) {
+  return new Promise((resolve21, reject) => {
+    socket.write(command + "\r\n", "utf-8", (err) => {
+      if (err) return reject(err);
+      readResponse(socket).then(resolve21, reject);
+    });
+  });
+}
+function buildMimeMessage(options) {
+  const boundary = `----=_Tina4_${Date.now()}_${Math.random().toString(36).substring(2)}`;
+  const altBoundary = `----=_Tina4Alt_${Date.now()}_${Math.random().toString(36).substring(2)}`;
+  const hasAttachments = options.attachments && options.attachments.length > 0;
+  const hasTextAlt = options.text !== void 0 && options.html;
+  const lines = [];
+  const fromHeader = options.fromName ? `"${options.fromName}" <${options.from}>` : options.from;
+  lines.push(`From: ${fromHeader}`);
+  lines.push(`To: ${options.to.join(", ")}`);
+  if (options.cc.length > 0) {
+    lines.push(`Cc: ${options.cc.join(", ")}`);
+  }
+  lines.push(`Subject: ${options.subject}`);
+  lines.push(`Date: ${(/* @__PURE__ */ new Date()).toUTCString()}`);
+  lines.push(`Message-ID: <${options.messageId}>`);
+  lines.push("MIME-Version: 1.0");
+  if (options.replyTo) {
+    lines.push(`Reply-To: ${options.replyTo}`);
+  }
+  if (options.headers) {
+    for (const [key, value] of Object.entries(options.headers)) {
+      lines.push(`${key}: ${value}`);
+    }
+  }
+  if (hasAttachments) {
+    lines.push(`Content-Type: multipart/mixed; boundary="${boundary}"`);
+    lines.push("");
+    lines.push(`--${boundary}`);
+    if (hasTextAlt) {
+      lines.push(`Content-Type: multipart/alternative; boundary="${altBoundary}"`);
+      lines.push("");
+      lines.push(`--${altBoundary}`);
+      lines.push("Content-Type: text/plain; charset=UTF-8");
+      lines.push("Content-Transfer-Encoding: 7bit");
+      lines.push("");
+      lines.push(options.text);
+      lines.push("");
+      lines.push(`--${altBoundary}`);
+      lines.push("Content-Type: text/html; charset=UTF-8");
+      lines.push("Content-Transfer-Encoding: 7bit");
+      lines.push("");
+      lines.push(options.body);
+      lines.push("");
+      lines.push(`--${altBoundary}--`);
+    } else {
+      const contentType = options.html ? "text/html" : "text/plain";
+      lines.push(`Content-Type: ${contentType}; charset=UTF-8`);
+      lines.push("Content-Transfer-Encoding: 7bit");
+      lines.push("");
+      lines.push(options.body);
+    }
+    for (const filePath of options.attachments) {
+      const fileName = basename6(filePath);
+      const fileData = readFileSync25(filePath);
+      const base64Data = fileData.toString("base64");
+      lines.push("");
+      lines.push(`--${boundary}`);
+      lines.push(`Content-Type: application/octet-stream; name="${fileName}"`);
+      lines.push("Content-Transfer-Encoding: base64");
+      lines.push(`Content-Disposition: attachment; filename="${fileName}"`);
+      lines.push("");
+      for (let i = 0; i < base64Data.length; i += 76) {
+        lines.push(base64Data.substring(i, i + 76));
+      }
+    }
+    lines.push("");
+    lines.push(`--${boundary}--`);
+  } else if (hasTextAlt) {
+    lines.push(`Content-Type: multipart/alternative; boundary="${altBoundary}"`);
+    lines.push("");
+    lines.push(`--${altBoundary}`);
+    lines.push("Content-Type: text/plain; charset=UTF-8");
+    lines.push("Content-Transfer-Encoding: 7bit");
+    lines.push("");
+    lines.push(options.text);
+    lines.push("");
+    lines.push(`--${altBoundary}`);
+    lines.push("Content-Type: text/html; charset=UTF-8");
+    lines.push("Content-Transfer-Encoding: 7bit");
+    lines.push("");
+    lines.push(options.body);
+    lines.push("");
+    lines.push(`--${altBoundary}--`);
+  } else {
+    const contentType = options.html ? "text/html" : "text/plain";
+    lines.push(`Content-Type: ${contentType}; charset=UTF-8`);
+    lines.push("");
+    lines.push(options.body);
+  }
+  return lines.join("\r\n");
+}
+function imapQuote(s) {
+  if (/^[a-zA-Z0-9_./-]+$/.test(s)) return s;
+  return '"' + s.replace(/\\/g, "\\\\").replace(/"/g, '\\"') + '"';
+}
+function imapReadLine(socket) {
+  return new Promise((resolve21, reject) => {
+    let buffer = "";
+    const onData = (chunk) => {
+      buffer += chunk.toString("utf-8");
+      const nlIndex = buffer.indexOf("\r\n");
+      if (nlIndex !== -1) {
+        socket.removeListener("data", onData);
+        socket.removeListener("error", onError);
+        resolve21(buffer);
+      }
+    };
+    const onError = (err) => {
+      socket.removeListener("data", onData);
+      reject(err);
+    };
+    socket.on("data", onData);
+    socket.on("error", onError);
+  });
+}
+function imapCommand(socket, command) {
+  return new Promise((resolve21, reject) => {
+    imapTagCounter++;
+    const tag = `T${imapTagCounter}`;
+    const fullCommand = `${tag} ${command}\r
+`;
+    let buffer = "";
+    const onData = (chunk) => {
+      buffer += chunk.toString("utf-8");
+      if (buffer.includes(`${tag} OK`)) {
+        socket.removeListener("data", onData);
+        socket.removeListener("error", onError);
+        resolve21(buffer);
+        return;
+      }
+      if (buffer.includes(`${tag} NO`) || buffer.includes(`${tag} BAD`)) {
+        socket.removeListener("data", onData);
+        socket.removeListener("error", onError);
+        reject(new MessengerConnectionError(`IMAP command failed: ${command.split(" ")[0]} \u2192 ${buffer.trim()}`));
+      }
+    };
+    const onError = (err) => {
+      socket.removeListener("data", onData);
+      reject(err);
+    };
+    socket.on("data", onData);
+    socket.on("error", onError);
+    socket.write(fullCommand, "utf-8");
+  });
+}
+function imapFail(method, err) {
+  const e = err instanceof Error ? err : new Error(String(err));
+  Log.error(`Messenger IMAP ${method}() failed: ${e.name}: ${e.message}`);
+  if (e instanceof MessengerConnectionError) return e;
+  return new MessengerConnectionError(`IMAP ${method} failed: ${e.message}`);
+}
+function parseSearchResponse(response) {
+  const match = response.match(/\* SEARCH (.+)/);
+  if (!match) return [];
+  return match[1].trim().split(/\s+/).filter((s) => /^\d+$/.test(s));
+}
+function parseHeaderResponse(uid, response) {
+  const headers = {};
+  const headerBlock = response.match(/\r\n([\s\S]*?)\r\n\)/);
+  if (headerBlock) {
+    const lines = headerBlock[1].split(/\r\n/);
+    let currentKey = "";
+    for (const line of lines) {
+      if (/^\s/.test(line) && currentKey) {
+        headers[currentKey] += " " + line.trim();
+      } else {
+        const colonIdx = line.indexOf(":");
+        if (colonIdx > 0) {
+          currentKey = line.substring(0, colonIdx).trim().toLowerCase();
+          headers[currentKey] = line.substring(colonIdx + 1).trim();
+        }
+      }
+    }
+  }
+  const seen = /\\Seen/i.test(response);
+  return {
+    uid,
+    subject: headers["subject"] ?? "",
+    from: headers["from"] ?? "",
+    to: headers["to"] ?? "",
+    date: headers["date"] ?? "",
+    snippet: "",
+    seen
+  };
+}
+function emptyFullMessage(uid) {
+  return { uid, subject: "", from: "", to: "", cc: "", date: "", bodyText: "", bodyHtml: "", headers: {} };
+}
+function parseFullMessage(uid, response) {
+  const bodyMatch = response.match(/\{(\d+)\}\r\n([\s\S]*)/);
+  const rawMessage = bodyMatch ? bodyMatch[2] : response;
+  const headerEnd = rawMessage.indexOf("\r\n\r\n");
+  const headerSection = headerEnd > 0 ? rawMessage.substring(0, headerEnd) : rawMessage;
+  const bodySection = headerEnd > 0 ? rawMessage.substring(headerEnd + 4) : "";
+  const headers = {};
+  const headerLines = headerSection.split(/\r\n/);
+  let currentKey = "";
+  for (const line of headerLines) {
+    if (/^\s/.test(line) && currentKey) {
+      headers[currentKey] += " " + line.trim();
+    } else {
+      const colonIdx = line.indexOf(":");
+      if (colonIdx > 0) {
+        currentKey = line.substring(0, colonIdx).trim().toLowerCase();
+        headers[currentKey] = line.substring(colonIdx + 1).trim();
+      }
+    }
+  }
+  const contentType = headers["content-type"] ?? "text/plain";
+  let bodyText = "";
+  let bodyHtml = "";
+  if (contentType.includes("multipart")) {
+    const boundaryMatch = contentType.match(/boundary="?([^";\s]+)"?/);
+    if (boundaryMatch) {
+      const boundary = boundaryMatch[1];
+      const parts = bodySection.split("--" + boundary);
+      for (const part of parts) {
+        if (part.trim() === "" || part.trim() === "--") continue;
+        const partHeaderEnd = part.indexOf("\r\n\r\n");
+        const partHeaders = partHeaderEnd > 0 ? part.substring(0, partHeaderEnd).toLowerCase() : "";
+        const partBody = partHeaderEnd > 0 ? part.substring(partHeaderEnd + 4).trim() : "";
+        if (partHeaders.includes("text/html")) {
+          bodyHtml = partBody;
+        } else if (partHeaders.includes("text/plain")) {
+          bodyText = partBody;
+        }
+      }
+    }
+  } else if (contentType.includes("text/html")) {
+    bodyHtml = bodySection;
+  } else {
+    bodyText = bodySection;
+  }
+  bodyText = bodyText.replace(/\)\r\n[A-Z]\d+ OK.*$/s, "").trim();
+  bodyHtml = bodyHtml.replace(/\)\r\n[A-Z]\d+ OK.*$/s, "").trim();
+  return {
+    uid,
+    subject: headers["subject"] ?? "",
+    from: headers["from"] ?? "",
+    to: headers["to"] ?? "",
+    cc: headers["cc"] ?? "",
+    date: headers["date"] ?? "",
+    bodyText,
+    bodyHtml,
+    headers
+  };
+}
+function createMessenger() {
+  return new Messenger();
+}
+var MessengerConnectionError, Messenger, imapTagCounter;
+var init_messenger = __esm({
+  "src/messenger.ts"() {
+    "use strict";
+    init_dotenv();
+    init_devMailbox();
+    init_logger();
+    MessengerConnectionError = class extends Error {
+      constructor(message) {
+        super(message);
+        this.name = "MessengerConnectionError";
+      }
+    };
+    Messenger = class {
+      host;
+      port;
+      username;
+      password;
+      fromAddress;
+      fromName;
+      encryption;
+      useTls;
+      /** Whether an SMTP host was actually configured (see the constructor). */
+      smtpConfigured = false;
+      /** The local mailbox, present only when this messenger captures. */
+      devMailbox = null;
+      imapHost;
+      imapPort;
+      imapUser;
+      imapPass;
+      imapEncryption;
+      constructor(options) {
+        this.smtpConfigured = Boolean(options?.host ?? process.env.TINA4_MAIL_HOST);
+        this.host = options?.host ?? process.env.TINA4_MAIL_HOST ?? "localhost";
+        this.port = options?.port ?? parseInt(process.env.TINA4_MAIL_PORT ?? "587", 10);
+        this.username = options?.username ?? process.env.TINA4_MAIL_USERNAME ?? "";
+        this.password = options?.password ?? process.env.TINA4_MAIL_PASSWORD ?? "";
+        this.fromAddress = options?.fromAddress ?? process.env.TINA4_MAIL_FROM ?? (this.username || "noreply@localhost");
+        this.fromName = options?.fromName ?? process.env.TINA4_MAIL_FROM_NAME ?? "";
+        const envEncryption = options?.encryption ?? process.env.TINA4_MAIL_ENCRYPTION;
+        if (envEncryption) {
+          this.encryption = envEncryption.toLowerCase();
+        } else if (options?.useTls !== void 0) {
+          this.encryption = options.useTls ? "tls" : "none";
+        } else {
+          this.encryption = "tls";
+        }
+        this.useTls = ["tls", "starttls"].includes(this.encryption);
+        this.imapHost = options?.imapHost ?? process.env.TINA4_MAIL_IMAP_HOST ?? "";
+        this.imapPort = options?.imapPort ?? parseInt(process.env.TINA4_MAIL_IMAP_PORT ?? "993", 10);
+        this.imapUser = options?.imapUser ?? process.env.TINA4_MAIL_IMAP_USERNAME ?? this.username;
+        this.imapPass = options?.imapPass ?? process.env.TINA4_MAIL_IMAP_PASSWORD ?? this.password;
+        this.imapEncryption = (options?.imapEncryption ?? process.env.TINA4_MAIL_IMAP_ENCRYPTION ?? "tls").toLowerCase();
+      }
+      /**
+       * Read-only IMAP encryption mode for inspection / tests.
+       * Returns one of "tls", "starttls", "none", "ssl".
+       */
+      getImapEncryption() {
+        return this.imapEncryption;
+      }
+      /**
+       * Send an email via SMTP.
+       */
+      /**
+       * Should send() capture locally instead of talking to SMTP?
+       *
+       * Availability decides, not verbosity. With no SMTP host configured sending is
+       * impossible, so simulate it into a folder rather than failing -- that is what
+       * makes a laptop with no mail server usable. TINA4_MAIL_CAPTURE forces capture
+       * even when a host IS configured.
+       *
+       * TINA4_DEBUG deliberately does NOT gate this, and neither does NODE_ENV. Debug
+       * must still be able to send, and the old `NODE_ENV !== "production"` clause
+       * silently swallowed every staging email.
+       */
+      shouldCapture() {
+        if (isTruthy(process.env.TINA4_MAIL_CAPTURE)) return true;
+        return !this.smtpConfigured;
+      }
+      /** The local mailbox, created on first capture and reused after. */
+      getDevMailbox() {
+        if (this.devMailbox === null) {
+          this.devMailbox = new DevMailbox();
+        }
+        return this.devMailbox;
+      }
+      async send(to, subject, body, html = false, text, cc, bcc, replyTo, attachments, headers) {
+        const options = { to, subject, body, html, text, cc, bcc, replyTo, attachments, headers };
+        const toList = Array.isArray(options.to) ? options.to : [options.to];
+        const ccList = Array.isArray(options.cc) ? options.cc : options.cc ? [options.cc] : [];
+        const bccList = Array.isArray(options.bcc) ? options.bcc : options.bcc ? [options.bcc] : [];
+        const allRecipients = [...toList, ...ccList, ...bccList];
+        if (this.shouldCapture()) {
+          return this.getDevMailbox().capture(
+            to,
+            subject,
+            body,
+            html,
+            text,
+            ccList,
+            bccList,
+            replyTo,
+            attachments,
+            this.fromAddress || void 0
+          );
+        }
+        const messageId = `${randomUUID9()}@${this.host}`;
+        if (allRecipients.length === 0) {
+          return { success: false, message: "No recipients specified" };
+        }
+        if (!this.fromAddress) {
+          return { success: false, message: "No from address configured" };
+        }
+        try {
+          let socket;
+          if (this.port === 465) {
+            socket = tls2.connect({ host: this.host, port: this.port, rejectUnauthorized: tlsRejectUnauthorized() });
+            await new Promise((resolve21, reject) => {
+              socket.once("secureConnect", resolve21);
+              socket.once("error", reject);
+            });
+          } else {
+            socket = net3.createConnection({ host: this.host, port: this.port });
+            await new Promise((resolve21, reject) => {
+              socket.once("connect", resolve21);
+              socket.once("error", reject);
+            });
+          }
+          const greeting = await readResponse(socket);
+          if (greeting.code !== 220) {
+            socket.destroy();
+            return { success: false, message: `SMTP greeting failed: ${greeting.text}` };
+          }
+          const ehlo = await sendCommand(socket, `EHLO ${this.host}`);
+          if (ehlo.code !== 250) {
+            socket.destroy();
+            return { success: false, message: `EHLO failed: ${ehlo.text}` };
+          }
+          if (this.useTls && this.port !== 465 && ehlo.text.includes("STARTTLS")) {
+            const starttls = await sendCommand(socket, "STARTTLS");
+            if (starttls.code !== 220) {
+              socket.destroy();
+              return { success: false, message: `STARTTLS failed: ${starttls.text}` };
+            }
+            const plainSocket = socket;
+            socket = tls2.connect(
+              { socket: plainSocket, host: this.host, rejectUnauthorized: tlsRejectUnauthorized() }
+            );
+            await new Promise((resolve21, reject) => {
+              socket.once("secureConnect", resolve21);
+              socket.once("error", reject);
+            });
+            const ehlo2 = await sendCommand(socket, `EHLO ${this.host}`);
+            if (ehlo2.code !== 250) {
+              socket.destroy();
+              return { success: false, message: `EHLO after STARTTLS failed: ${ehlo2.text}` };
+            }
+          }
+          if (this.username && this.password) {
+            const auth = await sendCommand(socket, "AUTH LOGIN");
+            if (auth.code !== 334) {
+              socket.destroy();
+              return { success: false, message: `AUTH LOGIN failed: ${auth.text}` };
+            }
+            const userResp = await sendCommand(socket, Buffer.from(this.username).toString("base64"));
+            if (userResp.code !== 334) {
+              socket.destroy();
+              return { success: false, message: `AUTH username failed: ${userResp.text}` };
+            }
+            const passResp = await sendCommand(socket, Buffer.from(this.password).toString("base64"));
+            if (passResp.code !== 235) {
+              socket.destroy();
+              return { success: false, message: `AUTH password failed: ${passResp.text}` };
+            }
+          }
+          const mailFrom = await sendCommand(socket, `MAIL FROM:<${this.fromAddress}>`);
+          if (mailFrom.code !== 250) {
+            socket.destroy();
+            return { success: false, message: `MAIL FROM failed: ${mailFrom.text}` };
+          }
+          for (const recipient of allRecipients) {
+            const rcpt = await sendCommand(socket, `RCPT TO:<${recipient}>`);
+            if (rcpt.code !== 250 && rcpt.code !== 251) {
+              socket.destroy();
+              return { success: false, message: `RCPT TO <${recipient}> failed: ${rcpt.text}` };
+            }
+          }
+          const dataCmd = await sendCommand(socket, "DATA");
+          if (dataCmd.code !== 354) {
+            socket.destroy();
+            return { success: false, message: `DATA failed: ${dataCmd.text}` };
+          }
+          const mimeMessage = buildMimeMessage({
+            from: this.fromAddress,
+            fromName: this.fromName,
+            to: toList,
+            cc: ccList,
+            subject: options.subject,
+            body: options.body,
+            html: options.html ?? false,
+            text: options.text,
+            replyTo: options.replyTo,
+            attachments: options.attachments,
+            headers: options.headers,
+            messageId
+          });
+          const endData = await sendCommand(socket, mimeMessage + "\r\n.");
+          if (endData.code !== 250) {
+            socket.destroy();
+            return { success: false, message: `Message delivery failed: ${endData.text}` };
+          }
+          await sendCommand(socket, "QUIT");
+          socket.destroy();
+          return { success: true, message: "Email sent successfully", id: messageId };
+        } catch (err) {
+          const errMsg = err instanceof Error ? err.message : String(err);
+          return { success: false, message: `SMTP error: ${errMsg}` };
+        }
+      }
+      /**
+       * Test the SMTP connection without sending an email.
+       */
+      async testConnection() {
+        try {
+          let socket;
+          if (this.port === 465) {
+            socket = tls2.connect({ host: this.host, port: this.port, rejectUnauthorized: tlsRejectUnauthorized() });
+            await new Promise((resolve21, reject) => {
+              socket.once("secureConnect", resolve21);
+              socket.once("error", reject);
+            });
+          } else {
+            socket = net3.createConnection({ host: this.host, port: this.port });
+            await new Promise((resolve21, reject) => {
+              socket.once("connect", resolve21);
+              socket.once("error", reject);
+            });
+          }
+          const greeting = await readResponse(socket);
+          if (greeting.code !== 220) {
+            socket.destroy();
+            return { success: false, message: `SMTP greeting failed: ${greeting.text}` };
+          }
+          const ehlo = await sendCommand(socket, `EHLO ${this.host}`);
+          if (ehlo.code !== 250) {
+            socket.destroy();
+            return { success: false, message: `EHLO failed: ${ehlo.text}` };
+          }
+          await sendCommand(socket, "QUIT");
+          socket.destroy();
+          return { success: true, message: `Connected to ${this.host}:${this.port}` };
+        } catch (err) {
+          const errMsg = err instanceof Error ? err.message : String(err);
+          return { success: false, message: `Connection failed: ${errMsg}` };
+        }
+      }
+      // ── IMAP (Read) ────────────────────────────────────────────
+      /**
+       * Connect to the IMAP server via raw TCP/TLS.
+       * Returns the socket and reads the greeting.
+       */
+      async imapConnect() {
+        if (!this.imapHost) {
+          throw new Error("IMAP host not configured (set imapHost or IMAP_HOST env)");
+        }
+        let socket;
+        const useTls = this.imapEncryption === "tls" || this.imapEncryption === "ssl" || this.imapEncryption === "" && this.imapPort === 993;
+        if (useTls) {
+          socket = tls2.connect({ host: this.imapHost, port: this.imapPort, rejectUnauthorized: tlsRejectUnauthorized() });
+          await new Promise((resolve21, reject) => {
+            socket.once("secureConnect", resolve21);
+            socket.once("error", reject);
+          });
+        } else {
+          socket = net3.createConnection({ host: this.imapHost, port: this.imapPort });
+          await new Promise((resolve21, reject) => {
+            socket.once("connect", resolve21);
+            socket.once("error", reject);
+          });
+        }
+        await imapReadLine(socket);
+        if (this.imapUser && this.imapPass) {
+          const loginResp = await imapCommand(socket, `LOGIN ${imapQuote(this.imapUser)} ${imapQuote(this.imapPass)}`);
+          if (!loginResp.includes("OK")) {
+            socket.destroy();
+            throw new Error(`IMAP login failed: ${loginResp}`);
+          }
+        }
+        return socket;
+      }
+      /**
+       * Disconnect from IMAP cleanly.
+       */
+      async imapDisconnect(socket) {
+        try {
+          await imapCommand(socket, "LOGOUT");
+        } catch {
+        }
+        socket.destroy();
+      }
+      /**
+       * Fetch latest messages from a folder.
+       * Returns list of message summaries.
+       */
+      async inbox(limit = 20, offset = 0, folder = "INBOX") {
+        let socket;
+        try {
+          socket = await this.imapConnect();
+        } catch (err) {
+          throw imapFail("inbox", err);
+        }
+        try {
+          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
+          const searchResp = await imapCommand(socket, "SEARCH ALL");
+          const uids = parseSearchResponse(searchResp);
+          if (uids.length === 0) return [];
+          uids.reverse();
+          const selected = uids.slice(offset, offset + limit);
+          if (selected.length === 0) return [];
+          const messages = [];
+          for (const uid of selected) {
+            const fetchResp = await imapCommand(socket, `FETCH ${uid} (FLAGS BODY.PEEK[HEADER.FIELDS (FROM TO SUBJECT DATE)])`);
+            messages.push(parseHeaderResponse(uid, fetchResp));
+          }
+          return messages;
+        } catch (err) {
+          throw imapFail("inbox", err);
+        } finally {
+          await this.imapDisconnect(socket);
+        }
+      }
+      /**
+       * Read a single message by sequence number or UID.
+       */
+      async read(uid, folder = "INBOX") {
+        let socket;
+        try {
+          socket = await this.imapConnect();
+        } catch (err) {
+          throw imapFail("read", err);
+        }
+        try {
+          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
+          const fetchResp = await imapCommand(socket, `FETCH ${uid} (FLAGS BODY[])`);
+          if (!/\{\d+\}/.test(fetchResp)) {
+            return emptyFullMessage(uid);
+          }
+          await imapCommand(socket, `STORE ${uid} +FLAGS (\\Seen)`);
+          return parseFullMessage(uid, fetchResp);
+        } catch (err) {
+          throw imapFail("read", err);
+        } finally {
+          await this.imapDisconnect(socket);
+        }
+      }
+      /**
+       * Search messages using IMAP search criteria.
+       */
+      async search(folder = "INBOX", subject, sender, since, before, unseenOnly = false, limit = 50) {
+        const criteria = ["ALL"];
+        if (subject) criteria.push(`SUBJECT "${subject}"`);
+        if (sender) criteria.push(`FROM "${sender}"`);
+        if (since) criteria.push(`SINCE ${since}`);
+        if (before) criteria.push(`BEFORE ${before}`);
+        if (unseenOnly) criteria.push("UNSEEN");
+        const query = criteria.join(" ");
+        let socket;
+        try {
+          socket = await this.imapConnect();
+        } catch (err) {
+          throw imapFail("search", err);
+        }
+        try {
+          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
+          const searchResp = await imapCommand(socket, `SEARCH ${query}`);
+          const uids = parseSearchResponse(searchResp);
+          if (uids.length === 0) return [];
+          uids.reverse();
+          const messages = [];
+          for (const uid of uids.slice(0, limit)) {
+            const fetchResp = await imapCommand(socket, `FETCH ${uid} (FLAGS BODY.PEEK[HEADER.FIELDS (FROM TO SUBJECT DATE)])`);
+            messages.push(parseHeaderResponse(uid, fetchResp));
+          }
+          return messages;
+        } catch (err) {
+          throw imapFail("search", err);
+        } finally {
+          await this.imapDisconnect(socket);
+        }
+      }
+      /**
+       * Delete a message by UID.
+       */
+      async deleteMessage(uid, folder = "INBOX") {
+        const socket = await this.imapConnect();
+        try {
+          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
+          await imapCommand(socket, `STORE ${uid} +FLAGS (\\Deleted)`);
+          await imapCommand(socket, "EXPUNGE");
+        } finally {
+          await this.imapDisconnect(socket);
+        }
+      }
+      /**
+       * Mark a message as read.
+       */
+      async markRead(uid, folder = "INBOX") {
+        const socket = await this.imapConnect();
+        try {
+          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
+          await imapCommand(socket, `STORE ${uid} +FLAGS (\\Seen)`);
+        } finally {
+          await this.imapDisconnect(socket);
+        }
+      }
+      /**
+       * Count unseen messages in a folder.
+       */
+      async unread(folder = "INBOX") {
+        let socket;
+        try {
+          socket = await this.imapConnect();
+        } catch (err) {
+          throw imapFail("unread", err);
+        }
+        try {
+          await imapCommand(socket, `SELECT ${imapQuote(folder)}`);
+          const searchResp = await imapCommand(socket, "SEARCH UNSEEN");
+          return parseSearchResponse(searchResp).length;
+        } catch (err) {
+          throw imapFail("unread", err);
+        } finally {
+          await this.imapDisconnect(socket);
+        }
+      }
+      /**
+       * List available IMAP folders/mailboxes.
+       */
+      async folders() {
+        let socket;
+        try {
+          socket = await this.imapConnect();
+        } catch (err) {
+          throw imapFail("folders", err);
+        }
+        try {
+          const resp = await imapCommand(socket, 'LIST "" "*"');
+          const result = [];
+          for (const line of resp.split("\r\n")) {
+            const m = line.match(/\* LIST \([^)]*\) "[^"]*" "?([^"\r\n]+)"?/i);
+            if (m) result.push(m[1]);
+          }
+          return result;
+        } catch (err) {
+          throw imapFail("folders", err);
+        } finally {
+          await this.imapDisconnect(socket);
+        }
+      }
+      /**
+       * Test IMAP connectivity without reading.
+       */
+      async testImapConnection() {
+        try {
+          const socket = await this.imapConnect();
+          await this.imapDisconnect(socket);
+          return { success: true, message: `Connected to ${this.imapHost}:${this.imapPort}` };
+        } catch (err) {
+          const errMsg = err instanceof Error ? err.message : String(err);
+          return { success: false, message: `IMAP connection failed: ${errMsg}` };
+        }
+      }
+    };
+    imapTagCounter = 0;
+  }
+});
+
 // src/wsdl.ts
 function escapeXml(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");