@dbx-tools/shared-email 0.9.129 → 0.9.132

package/README.md

@@ -1,11 +1,9 @@
 # @dbx-tools/shared-email
 
-Browser-safe email sending schemas and inferred types.
+Validate browser, route, and agent-tool payloads for `@dbx-tools/email` without
+importing Node-only code.
 
-Use these schemas in UIs, Mastra tools, routes, and tests that exchange email
-payloads with [`@dbx-tools/email`](../../node/email).
-
-## Validate A Drafted Message
+## Validate a drafted message
 
 ```ts
 import { email, type EmailMessage } from "@dbx-tools/shared-email";
@@ -19,39 +17,61 @@ const message: EmailMessage = email.emailMessageSchema.parse({
 ```
 
 The message schema covers recipients, subject, body content, and attachments.
-Attachments can carry inline content, a local path, a URL, encoding metadata, and
-content type hints.
+Attachments carry inline string content, an optional encoding, and an optional
+content type. The schema doesn't accept a local path or URL. Read external
+content in trusted server code, then pass the resulting string through
+`content`.
 
 The package also includes send-result and sender-option schemas for routes,
 approval UIs, and tests.
 
-## Validate Send Results
+## Validate send results
 
 ```ts
-const result = email.emailResultSchema.parse(await sendResponse.json());
+import { email } from "@dbx-tools/shared-email";
+
+export function parseEmailResult(value: unknown) {
+  return email.emailResultSchema.parse(value);
+}
+
+const result = parseEmailResult({
+  sent: true,
+  recipient: "alice@example.com",
+  from: "reports@example.com",
+  messageId: "smtp-message-id",
+});
 ```
 
 `emailResultSchema` is the shared shape for SMTP sends and outbox writes. Use it
 for approval UI state and test assertions.
 
-## Render Sender Choices
+## Load sender choices
 
 ```ts
+import { email } from "@dbx-tools/shared-email";
+
 const senders = email.emailSendersSchema.parse(
-  await fetch("/api/email/senders").then((r) => r.json()),
+  await fetch("/api/email/senders").then((response) => response.json()),
 );
 ```
 
 The sender schema describes the concrete `From` choices for the current user,
 the default sender, and whether the list is restricted by policy.
 
-## Modules
-
-- `email` - `emailAttachmentSchema`, `emailMessageSchema`,
-  `emailResultSchema`, `emailSendersSchema`, and flat inferred types:
-  `EmailAttachment`, `EmailMessage`, `EmailResult`, and `EmailSenders`.
-  The schemas intentionally avoid array `.min()` constraints so they can be reused
-  as model/tool JSON schemas for serving endpoints that reject `minItems`.
+## Understand schema and transport limits
+
+- `emailAttachmentSchema` accepts `filename`, inline `content`, `encoding`, and
+  `contentType`. It doesn't read files, fetch URLs, or validate whether an
+  encoding matches the content.
+- The schemas don't add array `minItems` constraints because some Model Serving
+  endpoints reject that JSON Schema keyword. The Node sending layer still
+  requires at least one recipient.
+- The Node sending layer limits a message to 20 attachments, 10 MiB per decoded
+  attachment, 20 MiB across attachments, and 200,000 body characters.
+- Outbox mode lists attachment filenames in the rendered preview but doesn't
+  write attachment payloads as separate files.
+- Sender policy, SMTP delivery, approval, and outbox persistence belong to
+  [@dbx-tools/email](../../node/email/README.md).
 
 Passwordless authentication contracts live in
-[`@dbx-tools/shared-auth`](../auth).
+[@dbx-tools/shared-auth](../auth/README.md).

package/index.ts

@@ -3,7 +3,7 @@
 // Hand edits are overwritten on the next watch; this file is read-only.
 
 export const PACKAGE_IDENTIFIER = "@dbx-tools/shared-email";
-export const PACKAGE_VERSION = "0.9.129";
+export const PACKAGE_VERSION = "0.9.132";
 export * as email from "./src/email.ts";
 export { emailAttachmentSchema, emailMessageSchema, emailResultSchema, emailSendersSchema } from "./src/email.ts";
 export type { EmailAttachment, EmailMessage, EmailResult, EmailSenders } from "./src/email.ts";

package/lib/index.d.ts

@@ -1,5 +1,5 @@
 export declare const PACKAGE_IDENTIFIER = "@dbx-tools/shared-email";
-export declare const PACKAGE_VERSION = "0.9.129";
+export declare const PACKAGE_VERSION = "0.9.132";
 export * as email from "./src/email.ts";
 export { emailAttachmentSchema, emailMessageSchema, emailResultSchema, emailSendersSchema } from "./src/email.ts";
 export type { EmailAttachment, EmailMessage, EmailResult, EmailSenders } from "./src/email.ts";

package/lib/index.js

@@ -2,7 +2,7 @@
 // Regenerated from the exporting modules in ./src.
 // Hand edits are overwritten on the next watch; this file is read-only.
 export const PACKAGE_IDENTIFIER = "@dbx-tools/shared-email";
-export const PACKAGE_VERSION = "0.9.129";
+export const PACKAGE_VERSION = "0.9.132";
 export * as email from "./src/email.js";
 export { emailAttachmentSchema, emailMessageSchema, emailResultSchema, emailSendersSchema } from "./src/email.js";
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyx5QkFBeUIsQ0FBQztBQUM1RCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsU0FBUyxDQUFDO0FBQ3pDLE9BQU8sS0FBSyxLQUFLLE1BQU0sZ0JBQWdCLENBQUM7QUFDeEMsT0FBTyxFQUFFLHFCQUFxQixFQUFFLGtCQUFrQixFQUFFLGlCQUFpQixFQUFFLGtCQUFrQixFQUFFLE1BQU0sZ0JBQWdCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBHRU5FUkFURUQgYnkgcHJvamVuIHdhdGNoIC0gRE8gTk9UIEVESVQuXG4vLyBSZWdlbmVyYXRlZCBmcm9tIHRoZSBleHBvcnRpbmcgbW9kdWxlcyBpbiAuL3NyYy5cbi8vIEhhbmQgZWRpdHMgYXJlIG92ZXJ3cml0dGVuIG9uIHRoZSBuZXh0IHdhdGNoOyB0aGlzIGZpbGUgaXMgcmVhZC1vbmx5LlxuXG5leHBvcnQgY29uc3QgUEFDS0FHRV9JREVOVElGSUVSID0gXCJAZGJ4LXRvb2xzL3NoYXJlZC1lbWFpbFwiO1xuZXhwb3J0IGNvbnN0IFBBQ0tBR0VfVkVSU0lPTiA9IFwiMC45LjEyOVwiO1xuZXhwb3J0ICogYXMgZW1haWwgZnJvbSBcIi4vc3JjL2VtYWlsLnRzXCI7XG5leHBvcnQgeyBlbWFpbEF0dGFjaG1lbnRTY2hlbWEsIGVtYWlsTWVzc2FnZVNjaGVtYSwgZW1haWxSZXN1bHRTY2hlbWEsIGVtYWlsU2VuZGVyc1NjaGVtYSB9IGZyb20gXCIuL3NyYy9lbWFpbC50c1wiO1xuZXhwb3J0IHR5cGUgeyBFbWFpbEF0dGFjaG1lbnQsIEVtYWlsTWVzc2FnZSwgRW1haWxSZXN1bHQsIEVtYWlsU2VuZGVycyB9IGZyb20gXCIuL3NyYy9lbWFpbC50c1wiO1xuIl19
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSwyQ0FBMkM7QUFDM0MsbURBQW1EO0FBQ25ELHdFQUF3RTtBQUV4RSxNQUFNLENBQUMsTUFBTSxrQkFBa0IsR0FBRyx5QkFBeUIsQ0FBQztBQUM1RCxNQUFNLENBQUMsTUFBTSxlQUFlLEdBQUcsU0FBUyxDQUFDO0FBQ3pDLE9BQU8sS0FBSyxLQUFLLE1BQU0sZ0JBQWdCLENBQUM7QUFDeEMsT0FBTyxFQUFFLHFCQUFxQixFQUFFLGtCQUFrQixFQUFFLGlCQUFpQixFQUFFLGtCQUFrQixFQUFFLE1BQU0sZ0JBQWdCLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvLyBHRU5FUkFURUQgYnkgcHJvamVuIHdhdGNoIC0gRE8gTk9UIEVESVQuXG4vLyBSZWdlbmVyYXRlZCBmcm9tIHRoZSBleHBvcnRpbmcgbW9kdWxlcyBpbiAuL3NyYy5cbi8vIEhhbmQgZWRpdHMgYXJlIG92ZXJ3cml0dGVuIG9uIHRoZSBuZXh0IHdhdGNoOyB0aGlzIGZpbGUgaXMgcmVhZC1vbmx5LlxuXG5leHBvcnQgY29uc3QgUEFDS0FHRV9JREVOVElGSUVSID0gXCJAZGJ4LXRvb2xzL3NoYXJlZC1lbWFpbFwiO1xuZXhwb3J0IGNvbnN0IFBBQ0tBR0VfVkVSU0lPTiA9IFwiMC45LjEzMlwiO1xuZXhwb3J0ICogYXMgZW1haWwgZnJvbSBcIi4vc3JjL2VtYWlsLnRzXCI7XG5leHBvcnQgeyBlbWFpbEF0dGFjaG1lbnRTY2hlbWEsIGVtYWlsTWVzc2FnZVNjaGVtYSwgZW1haWxSZXN1bHRTY2hlbWEsIGVtYWlsU2VuZGVyc1NjaGVtYSB9IGZyb20gXCIuL3NyYy9lbWFpbC50c1wiO1xuZXhwb3J0IHR5cGUgeyBFbWFpbEF0dGFjaG1lbnQsIEVtYWlsTWVzc2FnZSwgRW1haWxSZXN1bHQsIEVtYWlsU2VuZGVycyB9IGZyb20gXCIuL3NyYy9lbWFpbC50c1wiO1xuIl19

package/package.json

@@ -46,7 +46,7 @@
       "./package.json": "./package.json"
     }
   },
-  "version": "0.9.129",
+  "version": "0.9.132",
   "types": "./lib/index.d.ts",
   "dbxToolsConfig": {
     "tags": [