@primitivedotdev/cli 0.26.3 → 0.26.4

package/dist/oclif/index.js

@@ -9597,6 +9597,32 @@ async function maybeWriteFunctionEndpointRedirect(inputs) {
 	return match;
 }
 //#endregion
+//#region src/oclif/idempotent-replay-banner.ts
+/**
+* If `data` carries `idempotent_replay: true`, write a multi-line
+* stderr banner explaining the replay condition and what the caller
+* can do to bypass it. Otherwise no-op.
+*/
+function writeIdempotentReplayBannerIfReplay(data, options) {
+	if (!isReplay(data)) return;
+	const probe = data;
+	const rowId = typeof probe.id === "string" ? probe.id : null;
+	const status = typeof probe.status === "string" ? probe.status : null;
+	const deliveryStatus = typeof probe.delivery_status === "string" ? probe.delivery_status : null;
+	const lines = ["note: idempotent replay. this exact send already happened earlier.", "      no new MX traffic was generated by this call. nothing new will arrive in any inbox."];
+	if (rowId) lines.push(`      cached row id: ${rowId}`);
+	if (status || deliveryStatus) {
+		const parts = [status ? `status=${status}` : null, deliveryStatus && deliveryStatus !== status ? `delivery_status=${deliveryStatus}` : null].filter((part) => part !== null);
+		if (parts.length > 0) lines.push(`      original ${parts.join(", ")}`);
+	}
+	lines.push("      to send a fresh copy: vary any field (subject, body, etc.) or", "      pass a unique Idempotency-Key on the underlying API call.");
+	options.write(`${lines.join("\n")}\n`);
+}
+function isReplay(data) {
+	if (data === null || typeof data !== "object") return false;
+	return data.idempotent_replay === true;
+}
+//#endregion
 //#region src/oclif/api-command.ts
 const API_ERROR_CODES = {
 	accessDenied: "access_denied",
@@ -10031,6 +10057,9 @@ function createOperationCommand(operation) {
 					const hint = EMPTY_RESULT_HINTS[operation.sdkName];
 					if (hint) process.stderr.write(`${hint}\n`);
 				}
+				writeIdempotentReplayBannerIfReplay(envelope?.data, { write: (chunk) => {
+					process.stderr.write(chunk);
+				} });
 				this.log(JSON.stringify(envelope?.data ?? null, null, 2));
 			});
 		}
@@ -12330,6 +12359,9 @@ var SendCommand = class SendCommand extends Command {
 				return;
 			}
 			const envelope = result.data;
+			writeIdempotentReplayBannerIfReplay(envelope?.data, { write: (chunk) => {
+				process.stderr.write(chunk);
+			} });
 			this.log(JSON.stringify(envelope?.data ?? null, null, 2));
 		});
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@primitivedotdev/cli",
-  "version": "0.26.3",
+  "version": "0.26.4",
   "description": "Official Primitive CLI: deploy Primitive Functions, send and inspect mail, manage endpoints, all from the terminal. Wraps the @primitivedotdev/sdk runtime client with one-shot commands.",
   "type": "module",
   "sideEffects": false,