@theholocron/cli 5.0.0-alpha.196 → 5.0.0-alpha.197

package/dist/plugin/capabilities.d.mts

@@ -752,6 +752,10 @@ interface EnsureWebhookResult {
    * the application that created the webhook, and only on creation).
    */
   url?: string;
+  /** For a webhook that already existed, or was just made: the settings that were set (`"avatar"`). */
+  updated?: string[];
+  /** Set when the webhook is fine but setting its avatar failed; the webhook and its `url` are still good. */
+  avatarError?: string;
 }
 /**
  * Who may see a channel and post in it. Roles are named as in the layout's `roles`.
@@ -778,6 +782,7 @@ interface NotificationsChannelLayout {
   webhook?: boolean | {
     name?: string;
     secret?: string;
+    avatar?: string;
   };
 }
 /**
@@ -849,6 +854,12 @@ interface NotificationsOnboardingLayout {
 }
 /** A declared server layout, applied idempotently by `holocron notifications setup`. */
 interface NotificationsLayout {
+  /**
+   * The picture every webhook gets unless its own `webhook.avatar` says otherwise: a path to a PNG,
+   * JPEG or GIF (from where the CLI runs) or an `https://` URL. It is set only on a webhook that has
+   * no picture yet -- a provider cannot say whether the one it holds is the same image.
+   */
+  webhookAvatar?: string;
   /** What a new member sees on joining, applied after the channels exist. */
   welcome?: NotificationsWelcomeLayout;
   /** The questions a new member answers, applied after the channels and roles exist. */
@@ -912,6 +923,8 @@ interface ServerInspection {
     topic?: string;
     /** Names of the webhooks on the channel. Only filled in for channels the layout gives a webhook. */
     webhooks: string[];
+    /** Which of those webhooks have a picture of their own. */
+    webhookAvatars?: string[];
     /** Set when listing this channel's webhooks failed; `webhooks` is then empty and means nothing. */
     webhooksError?: string;
     /** Who can see and post; `"custom"` as for `categoryAccess`. */
@@ -959,6 +972,8 @@ interface Notifications extends ProviderIdentity {
     channel: string;
     name: string;
     category?: string;
+    /** An image as a `data:` URI, set when the webhook has none. */
+    avatar?: string;
   }): Promise<EnsureWebhookResult>;
   ensureRole?(input: {
     name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/cli",
-  "version": "5.0.0-alpha.196",
+  "version": "5.0.0-alpha.197",
   "description": "The Holocron CLI - a pluggable, capability-based orchestrator for spinning up and operating software projects.",
   "keywords": [
     "cli",
@@ -63,8 +63,8 @@
     "pino-pretty": "^13.1.3",
     "posthog-node": "^5.51.6",
     "yargs": "^18.1.0",
-    "@theholocron/astromech": "5.0.0-alpha.196",
-    "@theholocron/datapad": "5.0.0-alpha.196"
+    "@theholocron/astromech": "5.0.0-alpha.197",
+    "@theholocron/datapad": "5.0.0-alpha.197"
   },
   "devDependencies": {
     "@theholocron/eslint-config": "^8.8.2",