@madewithremy/admin 0.1.0 → 0.1.1

package/dist/prod.js

@@ -36,11 +36,11 @@ function fatal(message) {
   throw new CliError(message);
 }
 var AdminApiError = class extends Error {
-  constructor(method, path5, status, body) {
-    super(`API ${method} ${path5} returned ${status}: ${JSON.stringify(body)}`);
+  constructor(method, path5, status2, body) {
+    super(`API ${method} ${path5} returned ${status2}: ${JSON.stringify(body)}`);
     this.method = method;
     this.path = path5;
-    this.status = status;
+    this.status = status2;
     this.body = body;
     this.name = "AdminApiError";
   }
@@ -4606,6 +4606,13 @@ function stats2(ctx, params = {}) {
     `/_internal/v2/apps/${ctx.appId}/outbound-email/summary${qs(params)}`
   );
 }
+function status(ctx) {
+  return call(
+    ctx,
+    "GET",
+    `/_internal/v2/apps/${ctx.appId}/outbound-email/status`
+  );
+}
 function batches(ctx, params = {}) {
   return call(
     ctx,
@@ -4702,6 +4709,9 @@ var emailSpecs = {
     usage: "Usage: remy-admin email stats [--start <ISO date>] [--end <ISO date>]",
     flags: { ...WINDOW }
   },
+  "email status": {
+    usage: "Usage: remy-admin email status"
+  },
   "email batches": {
     usage: "Usage: remy-admin email batches [--start <ISO date>] [--end <ISO date>] [--limit 50]",
     flags: { ...WINDOW, ...PAGINATION }
@@ -4793,6 +4803,9 @@ async function emailGet(ctx, a) {
 async function emailStats(ctx, a) {
   out(await stats2(ctx, { start: a.str("start"), end: a.str("end") }));
 }
+async function emailStatus(ctx) {
+  out(await status(ctx));
+}
 async function emailBatches(ctx, a) {
   out(
     await batches(ctx, {
@@ -4829,7 +4842,12 @@ async function emailUnsuppress(ctx, a) {
     const { reason, at } = result.platformSuppression;
     console.error(
       `
-Note: removed from this app's list, but ${a.req("email")} is still on the platform suppression list (${reason}${at ? ` since ${at}` : ""}). Mail to it will still be blocked \u2014 that list is account-wide and is not cleared.`
+Note: removed from this app's list, but ${a.req("email")} is still on the ACCOUNT-wide suppression list (${reason}${at ? ` since ${at}` : ""}). Mail to it will still be blocked \u2014 that list is shared by every app and is not cleared.`
+    );
+  } else if (result?.tenantEntryRemoved) {
+    console.error(
+      `
+Note: also cleared this app's provider-side bounce/complaint record for ${a.req("email")}. Mail will be attempted again \u2014 another hard bounce re-suppresses it automatically.`
     );
   }
 }
@@ -4868,6 +4886,7 @@ var emailHandlers = {
   "email list": emailList,
   "email get": emailGet,
   "email stats": emailStats,
+  "email status": emailStatus,
   "email batches": emailBatches,
   "email batch": emailBatch,
   "email suppressions": emailSuppressions,
@@ -4891,7 +4910,8 @@ Subcommands:
   list           List sent messages (includes mail that never reached the provider)
   get            Full detail for one message, including bounce diagnostics
   stats          Counts and rates over a window
-  batches        One row per blast, with per-status counts
+  status         Can this app send right now? Pause/throttle state + daily quota
+  batches        One row per blast, with per-status counts and delivery progress
   batch          Stats for a single blast
   suppressions   This app's unsubscribe list
   suppress       Add an address to the unsubscribe list
@@ -4903,15 +4923,26 @@ Subcommands:
 
 Notes:
   Statuses: suppressed, failed, sent, delivered, blocked, bounced, complained,
-  delayed, rejected. "blocked" means the platform-wide suppression list dropped
-  it \u2014 usually another tenant's hard bounce \u2014 not that this address is bad.
+  delayed, rejected. "blocked" means an SES suppression list dropped it before
+  delivery \u2014 usually this app's OWN list, after an earlier hard bounce or spam
+  report from that address ('unsuppress' clears it and says which list it was).
+
+  'status' is the first check when sends are failing or a send returns
+  409 sending_paused. sending.source 'ses' = Amazon paused the tenant (clears
+  when the finding clears; nothing lifts it directly); 'platform' = our
+  bounce/complaint enforcement \u2014 enforcement.origin 'platform' steps down on
+  its own as rates recover, 'operator' is a human hold and will not. A reduced
+  quota.limit with an expiresAt is an automatic throttle.
 
   --recipient is an exact match and is index-backed; use --search for partials
   (bounded, and not paginated).
 
   A marketing send delivers one message per recipient, so a campaign is many
   rows sharing a batch id. Pass batchId to sendEmail to group them under your own
-  campaign id.
+  campaign id. Large and marketing sends are QUEUED: accepted immediately,
+  delivered in chunks \u2014 a batch's status (accepted|sending|completed|partial|
+  failed), chunksDone/chunksTotal and pending report the progress. status null
+  is a normal send that delivered inline, not an error.
 
   An inbox row's id is its request-log id: open the full detail (parsed message,
   method run, errors) with 'requests get <id>'.
@@ -4934,6 +4965,8 @@ Custom domains \u2014 two independent directions:
   the records and 'verify' again).
 
 Examples:
+  remy-admin email status
+  remy-admin email list --status bounced,blocked --limit 50
   remy-admin email domains add mail.acme.com
   remy-admin email domains verify mail.acme.com
   remy-admin email inbound-domains check acme.com

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@madewithremy/admin",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Admin SDK + CLI for managing production Remy apps",
   "type": "module",
   "main": "./dist/index.js",