@hoststack.dev/sdk 0.4.0 → 0.5.0

package/dist/index.js

@@ -196,11 +196,9 @@ var DeploysResource = class {
       teamId: tid,
       serviceId: sid
     });
-    return this.client.request(
-      "POST",
-      `/api/services/${tid}/${sid}/deploys/${did}/promote`,
-      { targetEnvironmentId }
-    );
+    return this.client.request("POST", `/api/services/${tid}/${sid}/deploys/${did}/promote`, {
+      targetEnvironmentId
+    });
   }
   /**
    * Get build logs for a deploy.
@@ -354,6 +352,65 @@ var EnvVarsResource = class {
   }
 };
 
+// src/resources/notifications.ts
+var NotificationsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List notification channels for the team. Webhook URLs are
+   * server-side masked in the response so this is safe to log.
+   */
+  async listChannels(teamId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("GET", `/api/notifications/${tid}/channels`);
+  }
+  /**
+   * Create a Slack/Discord/email notification channel.
+   *
+   * For type=email, `webhookUrl` is the recipient email address; for
+   * type=slack/discord it's the incoming webhook URL.
+   *
+   * `events` is the explicit subscription list — an empty array means
+   * "receive nothing". The platform pre-selects the critical-event
+   * set on the dashboard, but SDK callers must pass the list
+   * explicitly so behaviour is deterministic.
+   */
+  async createChannel(teamId, data) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("POST", `/api/notifications/${tid}/channels`, data);
+  }
+  /**
+   * Update a channel's name / active state / event subscriptions. The
+   * webhook URL and type are immutable — create a new channel if
+   * those need to change.
+   */
+  async updateChannel(teamId, channelId, data) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request(
+      "PATCH",
+      `/api/notifications/${tid}/channels/${channelId}`,
+      data
+    );
+  }
+  /** Delete a notification channel. */
+  async deleteChannel(teamId, channelId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("DELETE", `/api/notifications/${tid}/channels/${channelId}`);
+  }
+  /**
+   * Fire a test event to the channel so the user can confirm the
+   * webhook is wired correctly. Returns the dispatch outcome.
+   */
+  async testChannel(teamId, channelId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request(
+      "POST",
+      `/api/notifications/${tid}/channels/${channelId}/test`
+    );
+  }
+};
+
 // src/resources/projects.ts
 var ProjectsResource = class {
   constructor(client) {
@@ -451,10 +508,23 @@ var ServicesResource = class {
   constructor(client) {
     this.client = client;
   }
-  /** List all services for the active team. */
-  async list(teamId) {
+  /**
+   * List services for the active team.
+   *
+   * Optional filters narrow by project, environment, status, or type.
+   * The server treats unknown enum values as no match (returns empty)
+   * rather than 400-ing.
+   */
+  async list(teamId, filters) {
     const tid = await this.client.resolveId(teamId, { kind: "team" });
-    return this.client.request("GET", `/api/services/${tid}`);
+    const params = new URLSearchParams();
+    if (filters?.projectId !== void 0) params.set("projectId", String(filters.projectId));
+    if (filters?.environmentId !== void 0)
+      params.set("environmentId", String(filters.environmentId));
+    if (filters?.status) params.set("status", filters.status);
+    if (filters?.type) params.set("type", filters.type);
+    const qs = params.toString();
+    return this.client.request("GET", `/api/services/${tid}${qs ? `?${qs}` : ""}`);
   }
   /** Get a single service by ID. */
   async get(teamId, serviceId) {
@@ -497,6 +567,25 @@ var ServicesResource = class {
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
     return this.client.request("GET", `/api/services/${tid}/${sid}/metrics`);
   }
+  /**
+   * Get a metrics time series for a service.
+   *
+   * `from`/`to` accept ISO-8601 timestamps. Omit both for the trailing
+   * hour. Server picks the resolution: raw samples ≤7d, hourly pre-
+   * aggregates ≤30d, daily beyond that. Up to ~500 points returned.
+   */
+  async getMetricsHistory(teamId, serviceId, options) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    const params = new URLSearchParams();
+    if (options?.from) params.set("from", options.from);
+    if (options?.to) params.set("to", options.to);
+    const qs = params.toString();
+    return this.client.request(
+      "GET",
+      `/api/services/${tid}/${sid}/metrics/history${qs ? `?${qs}` : ""}`
+    );
+  }
   /** Get service configuration. */
   async getConfig(teamId, serviceId) {
     const tid = await this.client.resolveId(teamId, { kind: "team" });
@@ -555,11 +644,7 @@ var ServicesResource = class {
     const tid = await this.client.resolveId(teamId, { kind: "team" });
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
     const basePath = `/api/services/${tid}/${sid}/runtime-logs`;
-    yield* streamLogsViaPolling(
-      (path) => this.client.request("GET", path),
-      basePath,
-      options
-    );
+    yield* streamLogsViaPolling((path) => this.client.request("GET", path), basePath, options);
   }
 };
 
@@ -647,6 +732,12 @@ var HostStack = class {
   cron;
   /** Manage persistent disks attached to services. */
   volumes;
+  /**
+   * Manage notification channels — Slack/Discord webhooks + email
+   * recipients with per-channel event filters. Used for deploy
+   * failures, restart loops, ACME failures, git auth losses, etc.
+   */
+  notifications;
   constructor(options) {
     if (!options.apiKey) {
       throw new Error("apiKey is required");
@@ -662,6 +753,7 @@ var HostStack = class {
     this.environments = new EnvironmentsResource(this);
     this.cron = new CronResource(this);
     this.volumes = new VolumesResource(this);
+    this.notifications = new NotificationsResource(this);
   }
   /**
    * Make an authenticated request to the HostStack API.
@@ -753,17 +845,11 @@ var HostStack = class {
         return r.services ?? [];
       }
       case "deploy": {
-        const r = await this.request(
-          "GET",
-          `/api/services/${scope.teamId}/${scope.serviceId}/deploys?perPage=100`
-        );
+        const r = await this.request("GET", `/api/services/${scope.teamId}/${scope.serviceId}/deploys?perPage=100`);
         return r.data ?? [];
       }
       case "database": {
-        const r = await this.request(
-          "GET",
-          `/api/databases/${scope.teamId}`
-        );
+        const r = await this.request("GET", `/api/databases/${scope.teamId}`);
         return r.databases ?? [];
       }
       case "domain": {