@alva-ai/toolkit 0.3.1 → 0.4.1

package/dist/cli.js

@@ -252,7 +252,8 @@ var ReleaseResource = class {
         version: params.version,
         cronjob_id: params.cronjob_id,
         view_json: params.view_json,
-        description: params.description
+        description: params.description,
+        changelog: params.changelog
       }
     });
   }
@@ -264,8 +265,7 @@ var ReleaseResource = class {
         display_name: params.display_name,
         description: params.description,
         feeds: params.feeds,
-        trading_symbols: params.trading_symbols,
-        changelog: params.changelog
+        trading_symbols: params.trading_symbols
       }
     });
   }
@@ -577,6 +577,127 @@ var ArraysJwtResource = class {
   }
 };
 
+// src/resources/notifications.ts
+var NotificationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * List the caller's notification history for one playbook
+   * `(username, name)`. Returns `NOT_FOUND` when the playbook is
+   * private or does not exist (the two cases are deliberately
+   * indistinguishable to prevent namespace enumeration).
+   */
+  async listPlaybook(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/notifications`;
+    return this.client._request("GET", path, {
+      query: buildQuery(params)
+    });
+  }
+  /**
+   * List the caller's notification history for one feed
+   * `(username, name)`. Authorization is alfs read on
+   * `/alva/home/<username>/feeds/<name>`.
+   */
+  async listFeed(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/notifications`;
+    return this.client._request("GET", path, {
+      query: buildQuery(params)
+    });
+  }
+};
+function buildQuery(params) {
+  const q = {};
+  if (params.channel) q.channel = params.channel;
+  if (params.status) q.status = params.status;
+  if (params.since_time !== void 0 && params.since_time > 0) {
+    q.since_time = String(params.since_time);
+  }
+  if (params.first !== void 0 && params.first > 0) {
+    q.first = String(params.first);
+  }
+  if (params.cursor) q.cursor = params.cursor;
+  return q;
+}
+
+// src/resources/pushSubscriptions.ts
+var PushSubscriptionsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /**
+   * Opt into personal push for one playbook `(username, name)`.
+   * Fires for any feed of that playbook. Idempotent. Auth: callers must
+   * be able to read the playbook (public/paid pass; private requires
+   * explicit alfs grant).
+   */
+  async subscribePlaybook(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "POST",
+      path
+    );
+  }
+  /**
+   * Soft-disable personal push for one playbook `(username, name)`.
+   * Does NOT remove any social follow. Idempotent.
+   */
+  async unsubscribePlaybook(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/playbook/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "DELETE",
+      path
+    );
+  }
+  /**
+   * Opt into personal push for one feed `(username, name)`. Fires for
+   * that specific feed regardless of which playbook(s) consume it; if
+   * the feed is shared across playbooks the subscriber receives one
+   * push per playbook context. Idempotent.
+   */
+  async subscribeFeed(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "POST",
+      path
+    );
+  }
+  /**
+   * Soft-disable personal push for one feed `(username, name)`.
+   * Idempotent.
+   */
+  async unsubscribeFeed(params) {
+    this.client._requireAuth();
+    const path = `/api/v1/feed/${encodeURIComponent(params.username)}/${encodeURIComponent(params.name)}/push-subscription`;
+    return this.client._request(
+      "DELETE",
+      path
+    );
+  }
+  /**
+   * List the caller's personal push subscriptions across all targets
+   * (playbook + feed). Defaults to currently-active rows only; pass
+   * `include_history=true` to also return previously-unsubscribed rows.
+   */
+  async list(params = {}) {
+    this.client._requireAuth();
+    const query = {};
+    if (params.include_history !== void 0) {
+      query.include_history = String(params.include_history);
+    }
+    return this.client._request("GET", "/api/v1/me/push-subscriptions", {
+      query
+    });
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api-llm.prd.alva.ai";
 var DEFAULT_ARRAYS_BASE_URL = "https://data-tools.prd.space.id";
@@ -598,6 +719,8 @@ var AlvaClient = class {
   _user;
   _trading;
   _arraysJwt;
+  _notifications;
+  _pushSubscriptions;
   constructor(config) {
     this.baseUrl = config.baseUrl ?? DEFAULT_BASE_URL;
     this.arraysBaseUrl = config.arraysBaseUrl ?? DEFAULT_ARRAYS_BASE_URL;
@@ -643,6 +766,12 @@ var AlvaClient = class {
   get arraysJwt() {
     return this._arraysJwt ??= new ArraysJwtResource(this);
   }
+  get notifications() {
+    return this._notifications ??= new NotificationsResource(this);
+  }
+  get pushSubscriptions() {
+    return this._pushSubscriptions ??= new PushSubscriptionsResource(this);
+  }
   _requireAuth() {
     if (!this.viewer_token && !this.apiKey) {
       throw new AlvaError(
@@ -1002,7 +1131,7 @@ async function runPostConfigureHooks(client, deps) {
 import * as fs from "fs";
 import * as os2 from "os";
 import * as fsPromises2 from "fs/promises";
-var CLI_VERSION = true ? "0.3.1" : "dev";
+var CLI_VERSION = true ? "0.4.1" : "dev";
 function isVersionOlderThan(a, b) {
   const parse = (v) => {
     if (!v) return null;
@@ -1034,6 +1163,7 @@ Commands:
   sdk         SDK documentation (doc, partitions, partition-summary)
   skills      Data-skill documentation from the Arrays backend (list, summary, endpoint)
   comments    Playbook comments (create, pin, unpin)
+  push-subscriptions  Personal push opt-in (subscribe-playbook, unsubscribe-playbook, subscribe-feed, unsubscribe-feed, list)
   remix       Save playbook remix lineage
   trading     Trading operations (accounts, portfolio, orders, subscriptions, equity-history, risk-rules, subscribe, unsubscribe, execute, update-risk-rules)
   auth        Authentication (login)
@@ -1312,12 +1442,12 @@ Feed flags:
   --cronjob-id <id>      ID of the backing cronjob (required)
   --view-json <json>     View configuration JSON
   --description <text>   Feed description
+  --changelog <text>     Per-major changelog summary
 
 Playbook-draft flags:
   --name <name>              URL-safe playbook name, unique per user (required)
   --display-name <name>      Human-readable title, max 40 chars (required)
   --feeds <json>             JSON array of {feed_id, feed_major?} (required)
-  --changelog <text>         Release changelog
   --description <text>       Playbook description
   --trading-symbols <json>   JSON array of tickers, e.g. '["BTC","ETH"]' (max 50)
 
@@ -1336,7 +1466,7 @@ Display name conventions:
 Examples:
   alva release feed --name btc-ema --version 1.0.0 --cronjob-id 42
   alva release feed --name nvda-insiders --version 1.0.0 --cronjob-id 43 --description "NVDA insider trading activity"
-  alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --changelog "Initial release" --trading-symbols '["BTC"]'
+  alva release playbook-draft --name btc-dashboard --display-name "BTC Trend Dashboard" --feeds '[{"feed_id":100}]' --trading-symbols '["BTC"]'
   alva release playbook --name btc-dashboard --version v1.0.0 --feeds '[{"feed_id":100}]' --changelog "Initial release"`,
   secrets: `Usage: alva secrets <subcommand> [options]
 
@@ -1441,6 +1571,32 @@ Examples:
   alva comments create --username alice --name btc-dashboard --content "Thanks!" --parent-id 5
   alva comments pin --comment-id 12
   alva comments unpin --comment-id 12`,
+  "push-subscriptions": `Usage: alva push-subscriptions <subcommand> [options]
+
+Personal opt-in for DM/web push notifications. Independent of social
+follow: subscribing does not start following, unsubscribing does not
+unfollow. Following a playbook elsewhere will compound-subscribe
+automatically.
+
+Subcommands:
+  subscribe-playbook     Opt into push for a playbook (any of its feeds)
+  unsubscribe-playbook   Opt out of push for a playbook (soft-disable)
+  subscribe-feed         Opt into push for a single feed
+  unsubscribe-feed       Opt out of push for a single feed (soft-disable)
+  list                   List the caller's push subscriptions
+
+Subscribe/unsubscribe flags (playbook + feed):
+  --username <user>      Owner's username (required)
+  --name <name>          URL-safe playbook or feed name (required)
+
+List flags:
+  --include-history      Also return rows previously unsubscribed (default: false)
+
+Examples:
+  alva push-subscriptions subscribe-playbook --username alice --name btc-dashboard
+  alva push-subscriptions subscribe-feed     --username alice --name btc-ema-cross
+  alva push-subscriptions unsubscribe-feed   --username alice --name btc-ema-cross
+  alva push-subscriptions list --include-history`,
   remix: `Usage: alva remix --child-username <u> --child-name <n> --parents <json>
 
 Record remix lineage when creating a playbook based on existing playbooks.
@@ -1877,7 +2033,8 @@ async function dispatch(client, args, meta) {
             version: requireFlag(flags, "version", "release feed"),
             cronjob_id: requireNumericFlag(flags, "cronjob-id", "release feed"),
             view_json: jsonParse(flags["view-json"]),
-            description: flags["description"]
+            description: flags["description"],
+            changelog: flags["changelog"]
           });
         case "playbook-draft":
           return client.release.playbookDraft({
@@ -1891,8 +2048,7 @@ async function dispatch(client, args, meta) {
             feeds: jsonParse(
               requireFlag(flags, "feeds", "release playbook-draft")
             ),
-            trading_symbols: flags["trading-symbols"] ? jsonParse(flags["trading-symbols"]) : void 0,
-            changelog: flags["changelog"]
+            trading_symbols: flags["trading-symbols"] ? jsonParse(flags["trading-symbols"]) : void 0
           });
         case "playbook":
           return client.release.playbook({
@@ -2014,6 +2170,76 @@ async function dispatch(client, args, meta) {
           );
       }
     }
+    case "push-subscriptions": {
+      if (!subcommand)
+        throw new CliUsageError(
+          "Missing subcommand for push-subscriptions",
+          "push-subscriptions"
+        );
+      switch (subcommand) {
+        case "subscribe-playbook":
+          return client.pushSubscriptions.subscribePlaybook({
+            username: requireFlag(
+              flags,
+              "username",
+              "push-subscriptions subscribe-playbook"
+            ),
+            name: requireFlag(
+              flags,
+              "name",
+              "push-subscriptions subscribe-playbook"
+            )
+          });
+        case "unsubscribe-playbook":
+          return client.pushSubscriptions.unsubscribePlaybook({
+            username: requireFlag(
+              flags,
+              "username",
+              "push-subscriptions unsubscribe-playbook"
+            ),
+            name: requireFlag(
+              flags,
+              "name",
+              "push-subscriptions unsubscribe-playbook"
+            )
+          });
+        case "subscribe-feed":
+          return client.pushSubscriptions.subscribeFeed({
+            username: requireFlag(
+              flags,
+              "username",
+              "push-subscriptions subscribe-feed"
+            ),
+            name: requireFlag(
+              flags,
+              "name",
+              "push-subscriptions subscribe-feed"
+            )
+          });
+        case "unsubscribe-feed":
+          return client.pushSubscriptions.unsubscribeFeed({
+            username: requireFlag(
+              flags,
+              "username",
+              "push-subscriptions unsubscribe-feed"
+            ),
+            name: requireFlag(
+              flags,
+              "name",
+              "push-subscriptions unsubscribe-feed"
+            )
+          });
+        case "list":
+          return client.pushSubscriptions.list({
+            include_history: flags["include-history"] !== void 0
+          });
+        default:
+          throw new CliUsageError(
+            `Unknown subcommand: push-subscriptions ${subcommand}`,
+            "push-subscriptions"
+          );
+      }
+    }
     case "remix":
       return client.remix.save({
         child: {