@samva/cli 0.22.2 → 0.23.0

package/AGENTS.md

@@ -72,6 +72,11 @@ a template written in a format the compiler rejects. Templates live in `template
 `emails/`; a template is a `.tsx` file that default-exports `defineTemplate`, and the compiler reads
 it without running it.
 
+`samva email send` and `samva scheduled-messages create` take `--from <address>` (a verified sender or
+any address on a verified domain) and `--from-name`; omitted, the send uses the default sender, else the
+only verified sender, and otherwise fails with `FromAddressRequiredError`. `--from-name` without
+`--from` exits `1`.
+
 `samva email send --attach <path>` (repeatable) attaches local files; the filename is the basename and
 the content type comes from the extension (`application/octet-stream` when unknown). The CLI reads
 and budget-checks every file before any request (at most 10 files, 25 MiB each and in total) and

package/dist/bin.mjs

@@ -14276,7 +14276,7 @@ var layer12 = /* @__PURE__ */ layer.pipe(/* @__PURE__ */ provideMerge(/* @__PURE
 // package.json
 var package_default = {
   name: "@samva/cli",
-  version: "0.22.2",
+  version: "0.23.0",
   description: "Samva CLI \u2014 email and platform operations from your terminal",
   keywords: [
     "cli",
@@ -14332,16 +14332,16 @@ var package_default = {
     "@types/node": "catalog:",
     "better-auth": "catalog:",
     effect: "catalog:effect",
-    samva: "workspace:0.23.1",
+    samva: "workspace:0.24.0",
     "tsc-rs": "catalog:",
     vite: "~8.3.0",
     vitest: "catalog:"
   },
   optionalDependencies: {
-    "@samva/cli-darwin-arm64": "workspace:0.22.2",
-    "@samva/cli-darwin-x64": "workspace:0.22.2",
-    "@samva/cli-linux-arm64": "workspace:0.22.2",
-    "@samva/cli-linux-x64": "workspace:0.22.2"
+    "@samva/cli-darwin-arm64": "workspace:0.23.0",
+    "@samva/cli-darwin-x64": "workspace:0.23.0",
+    "@samva/cli-linux-arm64": "workspace:0.23.0",
+    "@samva/cli-linux-x64": "workspace:0.23.0"
   },
   engines: {
     node: ">=18"
@@ -21306,6 +21306,12 @@ class SenderNotReadyError extends TaggedError3()("SenderNotReadyError", {
 }, { httpApiStatus: 503 }) {
 }
 
+class FromAddressRequiredError extends TaggedError3()("FromAddressRequiredError", {
+  message: String4,
+  verifiedDomains: ArraySchema(String4)
+}, { httpApiStatus: 422 }) {
+}
+
 class OnboardingReviewRequiredError extends TaggedError3()("OnboardingReviewRequiredError", {
   message: String4,
   code: Literals([
@@ -21430,6 +21436,7 @@ categorize(OnboardingReviewRequiredError, {
   retryable: false
 });
 categorize(ValidationError, { categories: ["validation"], retryable: false });
+categorize(FromAddressRequiredError, { categories: ["validation"], retryable: false });
 categorize(ResourceNotFoundError, {
   categories: ["notFound"],
   retryable: false
@@ -24273,6 +24280,11 @@ var EmailDomainId2 = /* @__PURE__ */ String4.check(isPattern2(/* @__PURE__ */ ne
   expected: "a string matching the RegExp ^dom_[0-9a-hjkmnp-tv-z]{16,24}$",
   identifier: "EmailDomainId"
 })).pipe(brand("EmailDomainId"));
+var FromAddressRequiredError2 = class extends TaggedError3()("FromAddressRequiredError", Struct({
+  message: String4,
+  verifiedDomains: ArraySchema(String4)
+})) {
+};
 var BrandAddressRequiredError = class extends TaggedError3()("BrandAddressRequiredError", Struct({
   message: String4,
   brand: Union2([String4, Null2])
@@ -25272,6 +25284,7 @@ var apiStatuses = {
   ValidationError: 422,
   AnalyticsQueryError: 400,
   BrandAddressRequiredError: 422,
+  FromAddressRequiredError: 422,
   CampaignFooterRequiredError: 422,
   UnauthorizedError: 401,
   ForbiddenError: 403,
@@ -25338,6 +25351,9 @@ var apiErrorGuidance = (error) => {
     case "SenderNotReadyError":
       next = typeof details.retryAfterSeconds === "number" ? `Wait ${details.retryAfterSeconds} seconds before retrying.` : "Wait for the sending identity to be ready before retrying.";
       break;
+    case "FromAddressRequiredError":
+      next = Array.isArray(details.verifiedDomains) && details.verifiedDomains.length > 0 ? `Pass --from with an address on ${details.verifiedDomains.join(", ")}, or add a sender there and run samva email senders set-default.` : "Verify a domain or a sender (samva email domains add, samva email senders add), then set a default sender.";
+      break;
     case "CursorExpiredError":
       next = "Read current state from the API, then retry without the cursor.";
       break;
@@ -25564,7 +25580,7 @@ var __exportAll = (all, no_symbols) => {
 };
 
 // ../sdk/dist/package.js
-var version = "0.23.1";
+var version = "0.24.0";
 
 // ../sdk/dist/client-attribution.js
 var SDK_VERSION = version;
@@ -28183,6 +28199,10 @@ var SamvaErrorMetadata = {
     categories: ["auth"],
     retryable: false
   },
+  FromAddressRequiredError: {
+    categories: ["validation"],
+    retryable: false
+  },
   GatewayTimeoutError: {
     categories: ["transient"],
     retryable: true
@@ -55090,6 +55110,7 @@ var CampaignsScheduleRun403 = /* @__PURE__ */ Union2([FlagDisabledError, Forbidd
 var CampaignsScheduleRun404 = ResourceNotFoundError2;
 var CampaignsScheduleRun409 = ConflictError2;
 var CampaignsScheduleRun422 = /* @__PURE__ */ Union2([
+  FromAddressRequiredError2,
   ValidationError2,
   BrandAddressRequiredError,
   CampaignFooterRequiredError
@@ -59993,7 +60014,7 @@ var MessagesSend403 = /* @__PURE__ */ Union2([
 ]);
 var MessagesSend404 = ResourceNotFoundError2;
 var MessagesSend409 = ConflictError2;
-var MessagesSend422 = ValidationError2;
+var MessagesSend422 = /* @__PURE__ */ Union2([ValidationError2, FromAddressRequiredError2]);
 var MessagesSend429 = RateLimitedError2;
 var MessagesSend500 = InternalError2;
 var MessagesSend502 = /* @__PURE__ */ Union2([BillingProviderError, ExternalServiceError2]);
@@ -60248,7 +60269,7 @@ var MessagesValidateEmail200 = ValidateEmailResponse;
 var MessagesValidateEmail401 = UnauthorizedError2;
 var MessagesValidateEmail403 = ForbiddenError2;
 var MessagesValidateEmail404 = ResourceNotFoundError2;
-var MessagesValidateEmail422 = ValidationError2;
+var MessagesValidateEmail422 = /* @__PURE__ */ Union2([ValidationError2, FromAddressRequiredError2]);
 var MessagesValidateEmail500 = InternalError2;
 var MessagesValidateEmail503 = SenderNotReadyError2;
 var MessagesValidateEmail504 = GatewayTimeoutError2;
@@ -61728,6 +61749,8 @@ var templateSlugFlag2 = String9("template-slug").pipe(withDescription2("Template
 var templateDataFlag2 = String9("template-data").pipe(withDescription2("JSON object of variables for the template"), optional4);
 var localeFlag = String9("locale").pipe(withDescription2("BCP 47 language tag (for example en-US) for dates, numbers and money in a template send; defaults to the template's locale"), optional4);
 var timeZoneFlag = String9("time-zone").pipe(withDescription2("IANA time zone (for example America/New_York) that a template send renders dates in; defaults to UTC"), optional4);
+var fromFlag2 = String9("from").pipe(withDescription2("Sender address: a verified sender or any address on a verified domain. Omitted, the send uses the default sender, else the only verified sender"), optional4);
+var fromNameFlag = String9("from-name").pipe(withDescription2("Sender display name; applies with --from"), optional4);
 var replyToMessageFlag = String9("reply-to-message-id").pipe(withDescription2("Message id this email replies to (threads the conversation)"), optional4);
 var replyToAddressFlag = String9("reply-to").pipe(withDescription2("Reply-To header email address"), optional4);
 var idempotencyKeyFlag2 = String9("idempotency-key").pipe(withDescription2("Key (1-255 characters) so identical retries return the original email"), optional4);
@@ -61765,6 +61788,8 @@ var send3 = make29("send", {
   templateData: templateDataFlag2,
   locale: localeFlag,
   timeZone: timeZoneFlag,
+  from: fromFlag2,
+  fromName: fromNameFlag,
   replyTo: replyToMessageFlag,
   replyToAddress: replyToAddressFlag,
   idempotencyKey: idempotencyKeyFlag2,
@@ -61788,6 +61813,10 @@ var send3 = make29("send", {
     command: `samva email send --to you@example.com --template-slug order-receipt --template-data '{"total":42}' --locale de-DE --time-zone Europe/Berlin`,
     description: "Render a template's dates and money for a locale and time zone"
   },
+  {
+    command: "samva email send --to you@example.com --subject Hi --text Hello --from hello@acme.test",
+    description: "Send from any address on a verified domain, or from a verified sender"
+  },
   {
     command: 'echo "Hello" | samva email send --to you@example.com --subject Hi --text -',
     description: "Pipe plain-text body from stdin"
@@ -61818,6 +61847,8 @@ var send3 = make29("send", {
   templateData,
   locale,
   timeZone,
+  from,
+  fromName,
   replyTo,
   replyToAddress,
   idempotencyKey,
@@ -61839,6 +61870,11 @@ var send3 = make29("send", {
     publicationId: getOrUndefined(publicationId),
     inputContractId: getOrUndefined(inputContractId)
   });
+  const fromValue = getOrUndefined(from);
+  const fromNameValue = getOrUndefined(fromName);
+  if (fromValue === undefined && fromNameValue !== undefined) {
+    return yield* new SamvaCliError({ message: "--from-name applies with --from." });
+  }
   const replyToValue = getOrUndefined(replyTo);
   const replyToAddressValue = getOrUndefined(replyToAddress);
   const idempotencyKeyValue = getOrUndefined(idempotencyKey);
@@ -61909,6 +61945,12 @@ var send3 = make29("send", {
     ...templateDataValue === undefined ? {} : { templateData: templateDataValue },
     ...localeValue === undefined ? {} : { locale: localeValue },
     ...timeZoneValue === undefined ? {} : { timeZone: timeZoneValue },
+    ...fromValue === undefined ? {} : {
+      from: {
+        email: fromValue,
+        ...fromNameValue === undefined ? {} : { name: fromNameValue }
+      }
+    },
     ...replyToValue === undefined ? {} : { inReplyToMessageId: replyToValue },
     ...replyToAddressValue === undefined ? {} : { replyTo: replyToAddressValue },
     ...trackOpensValue !== undefined || trackClicksValue !== undefined ? {
@@ -61959,6 +62001,7 @@ var send3 = make29("send", {
     yield* printFields([["Body source", source]]);
     yield* log("");
     yield* printFields([
+      ...request.from ? [["From", request.from.email]] : [],
       ["To", request.to.join(", ")],
       ...ccValue ? [["Cc", ccValue]] : [],
       ...bccValue ? [["Bcc", bccValue]] : [],
@@ -74106,7 +74149,7 @@ var ScheduledMessagesResume401 = UnauthorizedError2;
 var ScheduledMessagesResume403 = ForbiddenError2;
 var ScheduledMessagesResume404 = ResourceNotFoundError2;
 var ScheduledMessagesResume409 = ConflictError2;
-var ScheduledMessagesResume422 = ValidationError2;
+var ScheduledMessagesResume422 = /* @__PURE__ */ Union2([FromAddressRequiredError2, ValidationError2]);
 var ScheduledMessagesResume500 = InternalError2;
 var ScheduledMessagesResume502 = ExternalServiceError2;
 var ScheduledMessagesResume503 = SenderNotReadyError2;
@@ -74208,6 +74251,7 @@ var assembleScheduledEmailPayload = (input) => ({
     to: input.to.map((email) => ({ email })),
     cc: input.cc ? [{ email: input.cc }] : undefined,
     bcc: input.bcc ? [{ email: input.bcc }] : undefined,
+    ...input.from === undefined ? {} : { from: input.from },
     email: {
       subject: input.subject,
       html: input.html,
@@ -74235,6 +74279,8 @@ var parseTemplateData3 = (raw) => match(raw, {
 var toFlag2 = String9("to").pipe(withDescription2("Recipient email address (repeatable)"), atLeast2(1));
 var ccFlag2 = String9("cc").pipe(withDescription2("Cc recipient email address"), optional4);
 var bccFlag2 = String9("bcc").pipe(withDescription2("Bcc recipient email address"), optional4);
+var fromFlag3 = String9("from").pipe(withDescription2("Sender address: a verified sender or any address on a verified domain. Omitted, the send uses the default sender, else the only verified sender"), optional4);
+var fromNameFlag2 = String9("from-name").pipe(withDescription2("Sender display name; applies with --from"), optional4);
 var subjectFlag3 = String9("subject").pipe(withDescription2("Email subject line (required with inline --html; omit for templates)"), optional4);
 var htmlFlag3 = String9("html").pipe(withDescription2("HTML body"), optional4);
 var textFlag3 = String9("text").pipe(withDescription2("Plain-text body"), optional4);
@@ -74256,6 +74302,8 @@ var create14 = make29("create", {
   to: toFlag2,
   cc: ccFlag2,
   bcc: bccFlag2,
+  from: fromFlag3,
+  fromName: fromNameFlag2,
   subject: subjectFlag3,
   html: htmlFlag3,
   text: textFlag3,
@@ -74277,6 +74325,10 @@ var create14 = make29("create", {
     command: 'samva scheduled-messages create --to you@example.com --subject Hi --html "<p>Hello</p>" --text Hello --at 2026-08-01T09:00:00Z',
     description: "Schedule an inline HTML email with a text fallback"
   },
+  {
+    command: 'samva scheduled-messages create --to you@example.com --from hello@acme.test --subject Hi --html "<p>Hello</p>" --at 2026-08-01T09:00:00Z',
+    description: "Send from any address on a verified domain, or from a verified sender"
+  },
   {
     command: `samva scheduled-messages create --to you@example.com --template-slug welcome-email --template-data '{"name":"Ada"}' --at 2026-08-01T09:00:00Z --timezone America/New_York`,
     description: "Schedule a published template; timezone is descriptive metadata"
@@ -74289,6 +74341,8 @@ var create14 = make29("create", {
   to,
   cc,
   bcc,
+  from,
+  fromName,
   subject,
   html,
   text,
@@ -74316,6 +74370,11 @@ var create14 = make29("create", {
   });
   const templateSlugValue = getOrUndefined(templateSlug);
   const templateDataValue = yield* parseTemplateData3(templateData);
+  const fromValue = getOrUndefined(from);
+  const fromNameValue = getOrUndefined(fromName);
+  if (fromValue === undefined && fromNameValue !== undefined) {
+    return yield* new SamvaCliError({ message: "--from-name applies with --from." });
+  }
   if (templateIdValue && templateSlugValue) {
     return yield* new SamvaCliError({
       message: "Use either --template-id or --template-slug, not both."
@@ -74354,6 +74413,12 @@ var create14 = make29("create", {
     templateData: templateDataValue,
     cc: getOrUndefined(cc),
     bcc: getOrUndefined(bcc),
+    ...fromValue === undefined ? {} : {
+      from: {
+        email: fromValue,
+        ...fromNameValue === undefined ? {} : { name: fromNameValue }
+      }
+    },
     scheduledFor: new Date(at),
     timezone: getOrUndefined(timezone),
     idempotencyKey: getOrUndefined(idempotencyKey),
@@ -74574,6 +74639,7 @@ var SubscriptionsSubscribe404 = ResourceNotFoundError2;
 var SubscriptionsSubscribe409 = ConflictError2;
 var SubscriptionsSubscribe422 = /* @__PURE__ */ Union2([
   ValidationError2,
+  FromAddressRequiredError2,
   BrandAddressRequiredError,
   CampaignFooterRequiredError
 ]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@samva/cli",
-  "version": "0.22.2",
+  "version": "0.23.0",
   "description": "Samva CLI — email and platform operations from your terminal",
   "keywords": [
     "cli",
@@ -50,22 +50,22 @@
     "@effect/vitest": "4.0.4",
     "@samva/contracts": "0.0.0",
     "@samva/core": "0.0.0",
-    "@samva/mailbox": "0.5.5",
+    "@samva/mailbox": "0.5.6",
     "@samva/markup": "0.17.3",
     "@samva/vite": "0.17.3",
     "@types/node": "^26.6.2",
     "better-auth": "1.7.5",
     "effect": "4.0.4",
-    "samva": "0.23.1",
+    "samva": "0.24.0",
     "tsc-rs": "0.7.0",
     "vite": "~8.3.0",
     "vitest": "^5.0.3"
   },
   "optionalDependencies": {
-    "@samva/cli-darwin-arm64": "0.22.2",
-    "@samva/cli-darwin-x64": "0.22.2",
-    "@samva/cli-linux-arm64": "0.22.2",
-    "@samva/cli-linux-x64": "0.22.2"
+    "@samva/cli-darwin-arm64": "0.23.0",
+    "@samva/cli-darwin-x64": "0.23.0",
+    "@samva/cli-linux-arm64": "0.23.0",
+    "@samva/cli-linux-x64": "0.23.0"
   },
   "engines": {
     "node": ">=18"