@greatwait/cli 0.1.0-alpha.7 → 0.1.0-alpha.8

package/dist/catalog.js

@@ -255,6 +255,77 @@ export const MEMBER_COMMANDS = [
     },
 ];
 export const COMMAND_CATALOG = [
+    {
+        group: "Planning",
+        words: "notifications show",
+        summary: "Show this project and environment's delivery notification settings.",
+        operations: ["projectnotifications.read"],
+        positionals: [
+            {
+                name: "<project>",
+                summary: "The project identifier in this credential's authority.",
+            },
+        ],
+        options: [API_URL],
+    },
+    {
+        group: "Planning",
+        words: "notifications update",
+        summary: "Change failure email and failed-event webhook preferences at the revision you read.",
+        confirms: true,
+        operations: ["projectnotifications.update"],
+        positionals: [
+            {
+                name: "<project>",
+                summary: "The project identifier in this credential's authority.",
+            },
+        ],
+        options: [
+            API_URL,
+            {
+                flag: "--settings",
+                value: "<json|@file|->",
+                summary: "JSON expectedRevision and email/statusWebhook settings; null statusWebhook disables it. No signing secret is accepted.",
+            },
+            IDEMPOTENCY,
+            CONFIRM,
+        ],
+    },
+    {
+        group: "Planning",
+        words: "notifications signing-key",
+        summary: "Mint or rotate a failed-event webhook signing secret, shown once.",
+        confirms: true,
+        operations: ["projectnotifications.rotateSigningKey"],
+        positionals: [
+            {
+                name: "<project>",
+                summary: "The project identifier in this credential's authority.",
+            },
+        ],
+        options: [
+            API_URL,
+            {
+                flag: "--expected-revision",
+                value: "<revision>",
+                summary: "The current revision from notifications show; a stale retry is refused.",
+            },
+            CONFIRM,
+        ],
+    },
+    {
+        group: "Planning",
+        words: "notifications deliveries",
+        summary: "List failed-event webhook deliveries and retries.",
+        operations: ["statusdeliveries.list"],
+        positionals: [
+            {
+                name: "<project>",
+                summary: "The project identifier in this credential's authority.",
+            },
+        ],
+        options: [API_URL, ...PAGE_OPTIONS],
+    },
     /* --- Session ---------------------------------------------------------- */
     {
         group: "Session",

package/dist/operate.js

@@ -1,5 +1,5 @@
 import { writeFile } from "node:fs/promises";
-import { autoPauseAfterFailuresSchema, httpRequestSchema, sanitizedDiagnosticText, diagnosticBodyText, responseBodySentence, requestCaptureSentence, attemptStatusGuidance, endpointHeaderChangesSchema, billingAutoTopUpApplyRequestSchema, billingAutoTopUpPreviewRequestSchema, billingAutoTopUpPreviewSchema, billingCeilingUpdateRequestSchema, billingFundingQuoteRequestSchema, billingFundingQuoteSchema, billingNotificationSettingsUpdateRequestSchema, billingRefundRequestCreateSchema, billingRefundResolutionRequestSchema, projectBillingQuoteSchema, projectBillingQuoteRequestSchema, } from "@greatwait/contracts";
+import { projectNotificationSettingsUpdateRequestSchema, statusSigningKeyRequestSchema, autoPauseAfterFailuresSchema, httpRequestSchema, sanitizedDiagnosticText, diagnosticBodyText, responseBodySentence, requestCaptureSentence, attemptStatusGuidance, endpointHeaderChangesSchema, billingAutoTopUpApplyRequestSchema, billingAutoTopUpPreviewRequestSchema, billingAutoTopUpPreviewSchema, billingCeilingUpdateRequestSchema, billingFundingQuoteRequestSchema, billingFundingQuoteSchema, billingNotificationSettingsUpdateRequestSchema, billingRefundRequestCreateSchema, billingRefundResolutionRequestSchema, projectBillingQuoteSchema, projectBillingQuoteRequestSchema, } from "@greatwait/contracts";
 import { parseDuration } from "./args.js";
 import { confirmChange } from "./confirm.js";
 import { redactSecret } from "./output.js";
@@ -1621,11 +1621,104 @@ const sinksDelivery = async (runtime, args) => {
         ].join("\n"),
     };
 };
+function notificationPreferenceResult(settings) {
+    const webhook = settings.statusWebhook;
+    return {
+        data: settings,
+        human: [
+            `Project    ${settings.project}`,
+            `Revision   ${String(settings.revision)}`,
+            `Email      ${settings.email.enabled ? "enabled" : "disabled"}; ${settings.email.scheduleKinds}`,
+            `Recipients ${settings.email.recipients.kind === "admins" ? "organization admins" : settings.email.recipients.memberIds.join(", ")}`,
+            `Webhook    ${webhook === undefined ? "disabled" : webhook.url}`,
+            ...(webhook === undefined
+                ? []
+                : [
+                    `Events     ${webhook.events.join(", ")}`,
+                    `Signing key ${webhook.signingKey?.id ?? "not provisioned"}`,
+                ]),
+        ].join("\n"),
+    };
+}
 /* -------------------------------------------------------------------------- */
 /* Dispatch                                                                   */
 /* -------------------------------------------------------------------------- */
 /** The operate-and-diagnose commands, keyed by the words that select them. */
 export const OPERATE_COMMANDS = {
+    "notifications show": async (runtime, args) => {
+        const [project] = positionals(args, ["<project>"], `${runtime.programName} notifications show <project>`);
+        const active = await session(runtime, args);
+        const settings = parseResponse("projectnotifications.read", await active.client.request("projectnotifications_read", project));
+        return notificationPreferenceResult(settings);
+    },
+    "notifications update": async (runtime, args) => {
+        const [project] = positionals(args, ["<project>"], `${runtime.programName} notifications update <project> --settings <json|@file|->`);
+        const parsed = projectNotificationSettingsUpdateRequestSchema.safeParse(await readJsonOption(runtime, "--settings", args.options["--settings"]));
+        if (!parsed.success)
+            throw new CliError("--settings must contain expectedRevision and valid email/statusWebhook preferences", "usage");
+        const confirmation = await confirmChange(runtime, args, {
+            action: `Update delivery notifications for ${project}.`,
+            effect: [
+                "Changes failure email recipients and/or failed-event webhook destination.",
+                "Failed-event hooks are included and free, including retries.",
+                "The signing secret is never returned by this settings change.",
+            ],
+        });
+        const active = await session(runtime, args);
+        const key = idempotencyKey(runtime, args);
+        runtime.stderr(`Retry key ${key}; retain it if the response is lost.\n`);
+        const settings = parseResponse("projectnotifications.update", await active.client.request("projectnotifications_update", project, parsed.data, { "Idempotency-Key": key }));
+        return {
+            ...notificationPreferenceResult(settings),
+            data: { settings, confirmation, idempotencyKey: key },
+        };
+    },
+    "notifications signing-key": async (runtime, args) => {
+        const [project] = positionals(args, ["<project>"], `${runtime.programName} notifications signing-key <project> --expected-revision <revision>`);
+        const request = statusSigningKeyRequestSchema.safeParse({
+            expectedRevision: expectedRevision(args),
+        });
+        if (!request.success)
+            throw new CliError("--expected-revision must be a positive whole number", "usage");
+        const confirmation = await confirmChange(runtime, args, {
+            action: `Mint or rotate the status signing key for ${project}.`,
+            effect: [
+                "The previous key is replaced; queued notifications using that old key are suppressed.",
+                "The secret is shown once in this response and cannot be read back. A lost response needs a fresh revision read and a new rotation.",
+            ],
+        });
+        const active = await session(runtime, args);
+        const result = parseResponse("projectnotifications.rotateSigningKey", await active.client.request("projectnotifications_rotateSigningKey", project, request.data));
+        return {
+            data: { ...result, confirmation },
+            human: [
+                `Signing key ${result.keyId}`,
+                `Secret      ${result.secret}`,
+                `Revision    ${String(result.settings.revision)}`,
+                "Save this secret now. It will not be returned again.",
+            ].join("\n"),
+        };
+    },
+    "notifications deliveries": async (runtime, args) => {
+        const [project] = positionals(args, ["<project>"], `${runtime.programName} notifications deliveries <project>`);
+        const active = await session(runtime, args);
+        return listing(runtime, args, {
+            columns: ["Event", "State", "Calls", "Delivery"],
+            command: `${runtime.programName} notifications deliveries ${project}`,
+            empty: "No status notifications have been queued.",
+            read: async (request) => {
+                const result = parseResponse("statusdeliveries.list", await active.client.request("statusdeliveries_list", project, request));
+                return {
+                    data: result.data,
+                    freshness: { kind: "authoritative" },
+                    ...(result.nextCursor === undefined
+                        ? {}
+                        : { nextCursor: result.nextCursor }),
+                };
+            },
+            row: (row) => [row.event, row.state, String(row.attempts), row.id],
+        });
+    },
     "limits show": limitsShow,
     "attempts read": attemptsRead,
     billing,

package/package.json

@@ -7,8 +7,8 @@
     "url": "https://github.com/flowxo/greatwait/issues"
   },
   "dependencies": {
-    "@greatwait/api-client": "0.1.0-alpha.7",
-    "@greatwait/contracts": "0.1.0-alpha.7"
+    "@greatwait/api-client": "0.1.0-alpha.8",
+    "@greatwait/contracts": "0.1.0-alpha.8"
   },
   "description": "The GreatWait command line: sign in, create a destination and a one-shot schedule, and wait for the callback, over the public API.",
   "engines": {
@@ -48,5 +48,5 @@
   },
   "sideEffects": false,
   "type": "module",
-  "version": "0.1.0-alpha.7"
+  "version": "0.1.0-alpha.8"
 }