@madewithremy/admin 0.1.47 → 0.1.49

package/CHANGELOG.md

@@ -4,6 +4,23 @@ What changed in `@madewithremy/admin`, newest first, each version under its own
 
 Versions before 0.1.44 aren't recorded here.
 
+## 0.1.49
+
+### New
+
+- A sending domain's `returnPathStatus` (`admin.email.addDomain`, `admin.email.verifyDomain`, the domain lists): where its bounce domain stands, `pending`, `verified` or `failed`, or null where the deployment's email provider has none of its own. On the cloud every sending domain gets one, `bounces.<domain>`, and its `dnsInstructions.records` carry its MX and SPF TXT, both recommended. With them published, the domain's mail bounces to the domain itself, so SPF matches the From address for DMARC as DKIM already does. Without them it sends as before.
+- `remy-admin email domains verify` on a sending domain whose bounce domain is `failed` starts it over, once its records are published.
+
+### Changed behavior
+
+- A sending domain on the cloud no longer lists an SPF TXT for the domain itself. It never applied to the mail, whose envelope sender was the provider's own address; the bounce domain's TXT replaces it. Check: a script that looks for a `v=spf1` record named for the domain.
+
+## 0.1.48
+
+### New
+
+- `remy-admin feedback draft <message>` (`admin.feedback.draft`): opens Send Feedback in the user's editor with the message filled in, for them to review and send. Nothing is sent until they do; a sent report carries the conversation, the sandbox's logs and the editor's state. A deployment that takes no feedback refuses it with `feedback_not_configured`.
+
 ## 0.1.47
 
 ### New

package/dist/index.d.ts

@@ -1130,6 +1130,47 @@ declare namespace cron {
   export { type cron_CronListParams as CronListParams, list$a as list, run$1 as run };
 }
 
+/**
+ * Response shapes for the feedback command group — transcribed from the api.
+ *
+ * Sources (apps/api/src/):
+ *   roles/http/routes/Apps/develop/feedback.ts
+ */
+/** POST /_internal/v2/apps/:appId/feedback-draft */
+interface FeedbackDraftResult {
+    /** The draft went to the person's open editors on this app. */
+    status: 'sent_to_editor';
+}
+
+/**
+ * Feedback operations: a report about Remy itself, to the Remy team.
+ *
+ * Ops are pure: (ctx, params) → typed result, throwing AdminApiError /
+ * AdminTimeoutError. No printing, no process coupling — the CLI skin in
+ * commands/feedback.ts and the importable client both call these.
+ */
+
+/**
+ * Open Send Feedback in the person's editor with this message filled in.
+ *
+ * Nothing is sent from here. The person reviews the draft, edits it if they
+ * like, and sends it; the report then carries Remy's conversation, the
+ * sandbox's logs and the editor's state. Only the person's own editors on this
+ * app open it, and only ones open at the time.
+ *
+ * @throws AdminApiError `feedback_not_configured` (404) — this deployment
+ *   doesn't take feedback; `missing_message` (400); `message_too_long` (400) —
+ *   over 20,000 characters.
+ * @example
+ * await admin.feedback.draft('The preview stopped reloading after every save.');
+ */
+declare function draft(ctx: AdminContext, message: string): Promise<FeedbackDraftResult>;
+
+declare const feedback_draft: typeof draft;
+declare namespace feedback {
+  export { feedback_draft as draft };
+}
+
 /**
  * Response types for the data command group.
  *
@@ -5106,7 +5147,8 @@ interface OutboundDnsRecord {
 /**
  * DNS records to create at the customer's DNS host for outbound sending:
  * whatever the deployment's email provider issues (on SES, three DKIM CNAMEs,
- * all required, and an SPF TXT, recommended; merge it into an existing one).
+ * all required, then the bounce domain's MX and SPF TXT on
+ * `bounces.<domain>`, recommended).
  */
 interface OutboundDnsInstructions {
     records: OutboundDnsRecord[];
@@ -5116,6 +5158,12 @@ interface OutboundEmailDomainView extends EmailDomainBase {
     verifiedAt: string | null;
     sesVerificationStatus: string | null;
     uiStatus: OutboundEmailDomainUiStatus;
+    /**
+     * Where the domain's bounce domain stands (`pending` until its MX is found),
+     * null where the provider has none of its own. Never part of `uiStatus`:
+     * the domain sends without it, from the provider's own bounce address.
+     */
+    returnPathStatus: 'pending' | 'verified' | 'failed' | null;
     verificationErrors: unknown[] | null;
     createdAt: string;
     dnsInstructions: OutboundDnsInstructions;
@@ -8866,6 +8914,7 @@ declare function buildClient(ctx: AdminContext): {
     events: BoundOps<typeof appEvents>;
     crashes: BoundOps<typeof crashes>;
     cron: BoundOps<typeof cron>;
+    feedback: BoundOps<typeof feedback>;
     data: BoundOps<typeof data>;
     dataSources: BoundOps<typeof dataSources>;
     dataSourceJobs: BoundOps<typeof dataSourceJobs>;

package/dist/index.js

@@ -361,6 +361,20 @@ function run(ctx, route) {
   );
 }
 
+// src/ops/feedback.ts
+var feedback_exports = {};
+__export(feedback_exports, {
+  draft: () => draft
+});
+function draft(ctx, message) {
+  return call(
+    ctx,
+    "POST",
+    `/_internal/v2/apps/${ctx.appId}/feedback-draft`,
+    { message }
+  );
+}
+
 // src/ops/data.ts
 var data_exports = {};
 __export(data_exports, {
@@ -3181,6 +3195,7 @@ function buildClient(ctx) {
     events: bindOps(events_exports, ctx),
     crashes: bindOps(crashes_exports, ctx),
     cron: bindOps(cron_exports, ctx),
+    feedback: bindOps(feedback_exports, ctx),
     data: bindOps(data_exports, ctx),
     dataSources: bindOps(dataSources_exports, ctx),
     dataSourceJobs: bindOps(dataSourceJobs_exports, ctx),