@hoststack.dev/sdk 0.7.0 → 0.8.1

package/dist/index.js

@@ -1,28 +1,49 @@
 // src/errors.ts
 var HostStackError = class extends Error {
   statusCode;
-  constructor(statusCode, message) {
+  /** Raw response body, if it parsed as JSON. Useful for surfacing field-level validation errors. */
+  body;
+  constructor(statusCode, message, body) {
     super(message);
     this.name = "HostStackError";
     this.statusCode = statusCode;
+    this.body = body;
   }
 };
 var AuthenticationError = class extends HostStackError {
-  constructor(message = "Authentication failed. Check your API key.") {
-    super(401, message);
+  constructor(message = "Authentication failed \u2014 check your API key.", body) {
+    super(401, message, body);
     this.name = "AuthenticationError";
   }
 };
+var ForbiddenError = class extends HostStackError {
+  constructor(message = "Permission denied \u2014 API key lacks the required scope.", body) {
+    super(403, message, body);
+    this.name = "ForbiddenError";
+  }
+};
 var NotFoundError = class extends HostStackError {
-  constructor(message = "Resource not found.") {
-    super(404, message);
+  constructor(message = "Resource not found.", body) {
+    super(404, message, body);
     this.name = "NotFoundError";
   }
 };
+var ConflictError = class extends HostStackError {
+  constructor(message = "Conflict \u2014 the resource state prevents this operation.", body) {
+    super(409, message, body);
+    this.name = "ConflictError";
+  }
+};
 var RateLimitError = class extends HostStackError {
-  constructor(message = "Rate limit exceeded. Try again later.") {
-    super(429, message);
+  /**
+   * Seconds to wait before retrying, parsed from the `Retry-After` response
+   * header. `undefined` if the server didn't send one.
+   */
+  retryAfter;
+  constructor(message = "Rate limit exceeded \u2014 back off and retry.", retryAfter, body) {
+    super(429, message, body);
     this.name = "RateLimitError";
+    this.retryAfter = retryAfter;
   }
 };
 
@@ -67,9 +88,15 @@ var DatabasesResource = class {
   constructor(client) {
     this.client = client;
   }
-  /** List all databases for a project. */
+  /**
+   * List databases for the team. Pass `projectId` to scope to one
+   * project; omit it to list every database the team owns.
+   */
   async list(teamId, projectId) {
     const tid = await this.client.resolveId(teamId, { kind: "team" });
+    if (projectId === void 0) {
+      return this.client.request("GET", `/api/databases/${tid}`);
+    }
     const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
     return this.client.request("GET", `/api/databases/${tid}?projectId=${pid}`);
   }
@@ -138,6 +165,34 @@ var DatabasesResource = class {
     const did = await this.client.resolveId(databaseId, { kind: "database", teamId: tid });
     return this.client.request("POST", `/api/databases/${tid}/${did}/query`, { sql });
   }
+  /**
+   * v89 Phase 4: trigger a single-node → HA migration (Patroni 3-node
+   * cluster). The customer-facing database briefly goes read-only during
+   * the pg_dump → bootstrap → pg_restore. The standalone container stays
+   * running (read-only) for 24 h as a rollback target before being
+   * decommissioned automatically.
+   *
+   * Requires (server-side): PATRONI_ENABLED env on the deployment +
+   * `teams.ha_beta=true` on this team. Throws 403 otherwise.
+   *
+   * Returns 202 — the upgrade is async; poll `get(...)` until
+   * `pgEngineType === 'patroni'` + `status === 'available'` to confirm.
+   */
+  async upgradeToHa(teamId, databaseId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const did = await this.client.resolveId(databaseId, { kind: "database", teamId: tid });
+    return this.client.request("POST", `/api/databases/${tid}/${did}/upgrade-to-ha`);
+  }
+  /**
+   * v89 Phase 5: cluster topology + failover history for a Patroni-managed
+   * Postgres database. Returns 400 for standalone databases — call
+   * `get(...)` first if you need to branch.
+   */
+  async getCluster(teamId, databaseId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const did = await this.client.resolveId(databaseId, { kind: "database", teamId: tid });
+    return this.client.request("GET", `/api/databases/${tid}/${did}/cluster`);
+  }
 };
 
 // src/resources/deploys.ts
@@ -344,22 +399,24 @@ var EnvVarsResource = class {
   async update(teamId, serviceId, envVarId, data) {
     const tid = await this.client.resolveId(teamId, { kind: "team" });
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
-    const eid = await this.client.resolveId(envVarId, {
-      kind: "envVar",
-      teamId: tid,
-      serviceId: sid
-    });
+    const eid = typeof envVarId === "number" ? envVarId : Number.parseInt(envVarId, 10);
+    if (Number.isNaN(eid)) {
+      throw new Error(
+        `Invalid envVarId "${envVarId}": expected a numeric id (env vars have no publicId \u2014 read it from list()).`
+      );
+    }
     return this.client.request("PATCH", `/api/services/${tid}/${sid}/env/${eid}`, data);
   }
   /** Delete an environment variable. */
   async delete(teamId, serviceId, envVarId) {
     const tid = await this.client.resolveId(teamId, { kind: "team" });
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
-    const eid = await this.client.resolveId(envVarId, {
-      kind: "envVar",
-      teamId: tid,
-      serviceId: sid
-    });
+    const eid = typeof envVarId === "number" ? envVarId : Number.parseInt(envVarId, 10);
+    if (Number.isNaN(eid)) {
+      throw new Error(
+        `Invalid envVarId "${envVarId}": expected a numeric id (env vars have no publicId \u2014 read it from list()).`
+      );
+    }
     return this.client.request("DELETE", `/api/services/${tid}/${sid}/env/${eid}`);
   }
   /** Bulk set environment variables (create or update). */
@@ -576,7 +633,13 @@ var ServicesResource = class {
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
     return this.client.request("POST", `/api/services/${tid}/${sid}/resume`);
   }
-  /** Get service metrics. */
+  /**
+   * Get the latest metrics snapshot for a service.
+   *
+   * Returns `metrics: null` before the first agent sample lands;
+   * `serverOverview: null` when the service is not currently placed
+   * (suspended, between deploys, etc).
+   */
   async getMetrics(teamId, serviceId) {
     const tid = await this.client.resolveId(teamId, { kind: "team" });
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
@@ -720,8 +783,7 @@ var PREFIX = {
   database: "db_",
   domain: "dom_",
   volume: "vol_",
-  envVar: "env_",
-  environment: "environment_",
+  environment: "env_",
   cronExecution: "cjob_"
 };
 var HostStack = class {
@@ -792,13 +854,20 @@ var HostStack = class {
       const message = data.error ?? `HTTP ${res.status}`;
       switch (res.status) {
         case 401:
-          throw new AuthenticationError(message);
+          throw new AuthenticationError(message, data);
+        case 403:
+          throw new ForbiddenError(message, data);
         case 404:
-          throw new NotFoundError(message);
-        case 429:
-          throw new RateLimitError(message);
+          throw new NotFoundError(message, data);
+        case 409:
+          throw new ConflictError(message, data);
+        case 429: {
+          const header = res.headers.get("Retry-After");
+          const retryAfter = header && /^\d+$/.test(header) ? Number(header) : void 0;
+          throw new RateLimitError(message, retryAfter, data);
+        }
         default:
-          throw new HostStackError(res.status, message);
+          throw new HostStackError(res.status, message, data);
       }
     }
     if (res.status === 204) {
@@ -874,13 +943,6 @@ var HostStack = class {
         );
         return r.domains ?? [];
       }
-      case "envVar": {
-        const r = await this.request(
-          "GET",
-          `/api/services/${scope.teamId}/${scope.serviceId}/env`
-        );
-        return r.envVars ?? [];
-      }
       case "volume": {
         const r = await this.request("GET", `/api/services/${scope.teamId}/${scope.serviceId}/volumes`);
         return r.volumes ?? [];
@@ -913,7 +975,6 @@ function cacheScope(scope) {
       return `${scope.kind}:${scope.teamId}`;
     case "deploy":
     case "volume":
-    case "envVar":
     case "cronExecution":
       return `${scope.kind}:${scope.teamId}:${scope.serviceId}`;
   }
@@ -940,6 +1001,6 @@ function wrapArray(items, params) {
   };
 }
 
-export { AuthenticationError, HostStack, HostStackError, NotFoundError, RateLimitError, buildPaginationQuery, wrapArray };
+export { AuthenticationError, ConflictError, ForbiddenError, HostStack, HostStackError, NotFoundError, RateLimitError, buildPaginationQuery, wrapArray };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map