@hoststack.dev/sdk 0.1.1 → 0.2.0

package/dist/index.js

@@ -33,27 +33,32 @@ var CronResource = class {
   }
   /** List cron executions for a service. */
   async list(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?.limit) params.set("limit", String(options.limit));
     const qs = params.toString();
     return this.client.request(
       "GET",
-      `/api/services/${teamId}/${serviceId}/cron-executions${qs ? `?${qs}` : ""}`
+      `/api/services/${tid}/${sid}/cron-executions${qs ? `?${qs}` : ""}`
     );
   }
   /** Get a single cron execution by ID. */
   async get(teamId, serviceId, executionId) {
-    return this.client.request(
-      "GET",
-      `/api/services/${teamId}/${serviceId}/cron-executions/${executionId}`
-    );
+    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(executionId, {
+      kind: "cronExecution",
+      teamId: tid,
+      serviceId: sid
+    });
+    return this.client.request("GET", `/api/services/${tid}/${sid}/cron-executions/${eid}`);
   }
   /** Trigger an immediate cron execution. */
   async trigger(teamId, serviceId) {
-    return this.client.request(
-      "POST",
-      `/api/services/${teamId}/${serviceId}/cron-executions/trigger`
-    );
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("POST", `/api/services/${tid}/${sid}/cron-executions/trigger`);
   }
 };
 
@@ -64,39 +69,56 @@ var DatabasesResource = class {
   }
   /** List all databases for a project. */
   async list(teamId, projectId) {
-    return this.client.request("GET", `/api/databases/${teamId}?projectId=${projectId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
+    return this.client.request("GET", `/api/databases/${tid}?projectId=${pid}`);
   }
   /** Get a single database by ID. */
   async get(teamId, databaseId) {
-    return this.client.request("GET", `/api/databases/${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}`);
   }
   /** Create a new database. */
   async create(teamId, data) {
-    return this.client.request("POST", `/api/databases/${teamId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("POST", `/api/databases/${tid}`, data);
   }
   /** Update a database. */
   async update(teamId, databaseId, data) {
-    return this.client.request("PATCH", `/api/databases/${teamId}/${databaseId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const did = await this.client.resolveId(databaseId, { kind: "database", teamId: tid });
+    return this.client.request("PATCH", `/api/databases/${tid}/${did}`, data);
   }
   /** Delete a database. */
   async delete(teamId, databaseId) {
-    return this.client.request("DELETE", `/api/databases/${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("DELETE", `/api/databases/${tid}/${did}`);
   }
   /** Suspend a database. */
   async suspend(teamId, databaseId) {
-    return this.client.request("POST", `/api/databases/${teamId}/${databaseId}/suspend`);
+    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}/suspend`);
   }
   /** Resume a suspended database. */
   async resume(teamId, databaseId) {
-    return this.client.request("POST", `/api/databases/${teamId}/${databaseId}/resume`);
+    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}/resume`);
   }
   /** Get connection credentials. */
   async getCredentials(teamId, databaseId) {
-    return this.client.request("GET", `/api/databases/${teamId}/${databaseId}/credentials`);
+    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}/credentials`);
   }
   /** Reset the database password. */
   async resetPassword(teamId, databaseId) {
-    return this.client.request("POST", `/api/databases/${teamId}/${databaseId}/reset-password`);
+    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}/reset-password`);
   }
 };
 
@@ -107,43 +129,59 @@ var DeploysResource = class {
   }
   /** List deploys for a service. */
   async list(teamId, serviceId) {
-    return this.client.request("GET", `/api/services/${teamId}/${serviceId}/deploys`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("GET", `/api/services/${tid}/${sid}/deploys`);
   }
   /** Get a single deploy by ID. */
   async get(teamId, serviceId, deployId) {
-    return this.client.request(
-      "GET",
-      `/api/services/${teamId}/${serviceId}/deploys/${deployId}`
-    );
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    const did = await this.client.resolveId(deployId, {
+      kind: "deploy",
+      teamId: tid,
+      serviceId: sid
+    });
+    return this.client.request("GET", `/api/services/${tid}/${sid}/deploys/${did}`);
   }
   /** Trigger a new deploy. */
   async trigger(teamId, serviceId, data) {
-    return this.client.request(
-      "POST",
-      `/api/services/${teamId}/${serviceId}/deploys`,
-      data ?? {}
-    );
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("POST", `/api/services/${tid}/${sid}/deploys`, data ?? {});
   }
   /** Cancel an in-progress deploy. */
   async cancel(teamId, serviceId, deployId) {
-    return this.client.request(
-      "POST",
-      `/api/services/${teamId}/${serviceId}/deploys/${deployId}/cancel`
-    );
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    const did = await this.client.resolveId(deployId, {
+      kind: "deploy",
+      teamId: tid,
+      serviceId: sid
+    });
+    return this.client.request("POST", `/api/services/${tid}/${sid}/deploys/${did}/cancel`);
   }
   /** Rollback to a previous deploy. */
   async rollback(teamId, serviceId, deployId) {
-    return this.client.request(
-      "POST",
-      `/api/services/${teamId}/${serviceId}/deploys/${deployId}/rollback`
-    );
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    const did = await this.client.resolveId(deployId, {
+      kind: "deploy",
+      teamId: tid,
+      serviceId: sid
+    });
+    return this.client.request("POST", `/api/services/${tid}/${sid}/deploys/${did}/rollback`);
   }
   /** Get build logs for a deploy. */
   async getLogs(teamId, serviceId, deployId) {
-    return this.client.request(
-      "GET",
-      `/api/services/${teamId}/${serviceId}/deploys/${deployId}/logs`
-    );
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    const did = await this.client.resolveId(deployId, {
+      kind: "deploy",
+      teamId: tid,
+      serviceId: sid
+    });
+    return this.client.request("GET", `/api/services/${tid}/${sid}/deploys/${did}/logs`);
   }
 };
 
@@ -154,23 +192,31 @@ var DomainsResource = class {
   }
   /** List all domains for the active team. */
   async list(teamId) {
-    return this.client.request("GET", `/api/domains/${teamId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("GET", `/api/domains/${tid}`);
   }
   /** Add a custom domain. */
   async add(teamId, data) {
-    return this.client.request("POST", `/api/domains/${teamId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("POST", `/api/domains/${tid}`, data);
   }
   /** Update a domain. */
   async update(teamId, domainId, data) {
-    return this.client.request("PATCH", `/api/domains/${teamId}/${domainId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const did = await this.client.resolveId(domainId, { kind: "domain", teamId: tid });
+    return this.client.request("PATCH", `/api/domains/${tid}/${did}`, data);
   }
   /** Remove a domain. */
   async remove(teamId, domainId) {
-    return this.client.request("DELETE", `/api/domains/${teamId}/${domainId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const did = await this.client.resolveId(domainId, { kind: "domain", teamId: tid });
+    return this.client.request("DELETE", `/api/domains/${tid}/${did}`);
   }
   /** Verify domain DNS configuration. */
   async verify(teamId, domainId) {
-    return this.client.request("POST", `/api/domains/${teamId}/${domainId}/verify`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const did = await this.client.resolveId(domainId, { kind: "domain", teamId: tid });
+    return this.client.request("POST", `/api/domains/${tid}/${did}/verify`);
   }
 };
 
@@ -181,30 +227,43 @@ var EnvVarsResource = class {
   }
   /** List all environment variables for a service. */
   async list(teamId, serviceId) {
-    return this.client.request("GET", `/api/services/${teamId}/${serviceId}/env`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("GET", `/api/services/${tid}/${sid}/env`);
   }
   /** Create a new environment variable. */
   async create(teamId, serviceId, data) {
-    return this.client.request("POST", `/api/services/${teamId}/${serviceId}/env`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("POST", `/api/services/${tid}/${sid}/env`, data);
   }
   /** Update an environment variable. */
   async update(teamId, serviceId, envVarId, data) {
-    return this.client.request(
-      "PATCH",
-      `/api/services/${teamId}/${serviceId}/env/${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
+    });
+    return this.client.request("PATCH", `/api/services/${tid}/${sid}/env/${eid}`, data);
   }
   /** Delete an environment variable. */
   async delete(teamId, serviceId, envVarId) {
-    return this.client.request(
-      "DELETE",
-      `/api/services/${teamId}/${serviceId}/env/${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
+    });
+    return this.client.request("DELETE", `/api/services/${tid}/${sid}/env/${eid}`);
   }
   /** Bulk set environment variables (create or update). */
   async bulkSet(teamId, serviceId, data) {
-    return this.client.request("PUT", `/api/services/${teamId}/${serviceId}/env/bulk`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("PUT", `/api/services/${tid}/${sid}/env/bulk`, data);
   }
 };
 
@@ -215,23 +274,31 @@ var ProjectsResource = class {
   }
   /** List all projects for the active team. */
   async list(teamId) {
-    return this.client.request("GET", `/api/projects/${teamId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("GET", `/api/projects/${tid}`);
   }
   /** Get a single project by ID. */
   async get(teamId, projectId) {
-    return this.client.request("GET", `/api/projects/${teamId}/${projectId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
+    return this.client.request("GET", `/api/projects/${tid}/${pid}`);
   }
   /** Create a new project. */
   async create(teamId, data) {
-    return this.client.request("POST", `/api/projects/${teamId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("POST", `/api/projects/${tid}`, data);
   }
   /** Update a project. */
   async update(teamId, projectId, data) {
-    return this.client.request("PATCH", `/api/projects/${teamId}/${projectId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
+    return this.client.request("PATCH", `/api/projects/${tid}/${pid}`, data);
   }
   /** Delete a project. */
   async delete(teamId, projectId) {
-    return this.client.request("DELETE", `/api/projects/${teamId}/${projectId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
+    return this.client.request("DELETE", `/api/projects/${tid}/${pid}`);
   }
 };
 
@@ -299,46 +366,66 @@ var ServicesResource = class {
   }
   /** List all services for the active team. */
   async list(teamId) {
-    return this.client.request("GET", `/api/services/${teamId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("GET", `/api/services/${tid}`);
   }
   /** Get a single service by ID. */
   async get(teamId, serviceId) {
-    return this.client.request("GET", `/api/services/${teamId}/${serviceId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("GET", `/api/services/${tid}/${sid}`);
   }
   /** Create a new service. */
   async create(teamId, data) {
-    return this.client.request("POST", `/api/services/${teamId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("POST", `/api/services/${tid}`, data);
   }
   /** Update a service. */
   async update(teamId, serviceId, data) {
-    return this.client.request("PATCH", `/api/services/${teamId}/${serviceId}`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("PATCH", `/api/services/${tid}/${sid}`, data);
   }
   /** Delete a service. */
   async delete(teamId, serviceId) {
-    return this.client.request("DELETE", `/api/services/${teamId}/${serviceId}`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("DELETE", `/api/services/${tid}/${sid}`);
   }
   /** Suspend a service. */
   async suspend(teamId, serviceId) {
-    return this.client.request("POST", `/api/services/${teamId}/${serviceId}/suspend`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("POST", `/api/services/${tid}/${sid}/suspend`);
   }
   /** Resume a suspended service. */
   async resume(teamId, serviceId) {
-    return this.client.request("POST", `/api/services/${teamId}/${serviceId}/resume`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("POST", `/api/services/${tid}/${sid}/resume`);
   }
   /** Get service metrics. */
   async getMetrics(teamId, serviceId) {
-    return this.client.request("GET", `/api/services/${teamId}/${serviceId}/metrics`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("GET", `/api/services/${tid}/${sid}/metrics`);
   }
   /** Get service configuration. */
   async getConfig(teamId, serviceId) {
-    return this.client.request("GET", `/api/services/${teamId}/${serviceId}/config`);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("GET", `/api/services/${tid}/${sid}/config`);
   }
   /** Update service configuration. */
   async updateConfig(teamId, serviceId, data) {
-    return this.client.request("PATCH", `/api/services/${teamId}/${serviceId}/config`, data);
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
+    return this.client.request("PATCH", `/api/services/${tid}/${sid}/config`, data);
   }
   /** Get runtime logs for a service. */
   async getRuntimeLogs(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?.lines) params.set("lines", String(options.lines));
     if (options?.since) params.set("since", options.since);
@@ -346,7 +433,7 @@ var ServicesResource = class {
     const qs = params.toString();
     return this.client.request(
       "GET",
-      `/api/services/${teamId}/${serviceId}/runtime-logs${qs ? `?${qs}` : ""}`
+      `/api/services/${tid}/${sid}/runtime-logs${qs ? `?${qs}` : ""}`
     );
   }
   /**
@@ -361,9 +448,11 @@ var ServicesResource = class {
    * }
    * ```
    */
-  streamLogs(teamId, serviceId, options) {
-    const basePath = `/api/services/${teamId}/${serviceId}/runtime-logs`;
-    return streamLogsViaPolling(
+  async *streamLogs(teamId, serviceId, options) {
+    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
@@ -372,9 +461,21 @@ var ServicesResource = class {
 };
 
 // src/client.ts
+var PREFIX = {
+  team: "team_",
+  project: "prj_",
+  service: "svc_",
+  deploy: "dpl_",
+  database: "db_",
+  domain: "dom_",
+  envVar: "env_",
+  cronExecution: "cjob_"
+};
 var HostStack = class {
   apiKey;
   baseUrl;
+  // publicId → numeric id, scoped by parent context. Lifetime: client instance.
+  idCache = /* @__PURE__ */ new Map();
   /** Manage projects. */
   projects;
   /** Manage services (web, worker, cron). */
@@ -439,7 +540,109 @@ var HostStack = class {
     }
     return res.json();
   }
+  /**
+   * Resolve a publicId-or-numeric id input to a numeric database id. Numeric
+   * inputs short-circuit; publicIds (svc_xyz, dpl_xyz, etc.) are looked up
+   * via the relevant list endpoint and cached on this client instance.
+   *
+   * The API addresses everything by numeric id internally; this resolver lets
+   * SDK/MCP consumers pass either form interchangeably without burning extra
+   * round-trips on subsequent calls.
+   */
+  async resolveId(input, scope) {
+    if (typeof input === "number") return input;
+    if (/^\d+$/.test(input)) return Number.parseInt(input, 10);
+    const expectedPrefix = PREFIX[scope.kind];
+    if (!input.startsWith(expectedPrefix)) {
+      throw new HostStackError(
+        400,
+        `Invalid ${scope.kind} id "${input}": expected ${expectedPrefix}xxx or numeric.`
+      );
+    }
+    const cacheKey = `${cacheScope(scope)}:${input}`;
+    const cached = this.idCache.get(cacheKey);
+    if (cached !== void 0) return cached;
+    const items = await this.fetchForResolution(scope);
+    const match = items.find((it) => it.publicId === input);
+    if (!match) {
+      throw new NotFoundError(`${scope.kind} ${input} not found`);
+    }
+    this.idCache.set(cacheKey, match.id);
+    return match.id;
+  }
+  async fetchForResolution(scope) {
+    switch (scope.kind) {
+      case "team": {
+        const r = await this.request(
+          "GET",
+          "/api/teams"
+        );
+        return r.teams ?? [];
+      }
+      case "project": {
+        const r = await this.request(
+          "GET",
+          `/api/projects/${scope.teamId}`
+        );
+        return r.projects ?? [];
+      }
+      case "service": {
+        const r = await this.request(
+          "GET",
+          `/api/services/${scope.teamId}`
+        );
+        return r.services ?? [];
+      }
+      case "deploy": {
+        const r = await this.request(
+          "GET",
+          `/api/services/${scope.teamId}/${scope.serviceId}/deploys`
+        );
+        return r.deploys ?? [];
+      }
+      case "database": {
+        const r = await this.request(
+          "GET",
+          `/api/databases/${scope.teamId}`
+        );
+        return r.databases ?? [];
+      }
+      case "domain": {
+        const r = await this.request(
+          "GET",
+          `/api/domains/${scope.teamId}`
+        );
+        return r.domains ?? [];
+      }
+      case "envVar": {
+        const r = await this.request(
+          "GET",
+          `/api/services/${scope.teamId}/${scope.serviceId}/env`
+        );
+        return r.envVars ?? [];
+      }
+      case "cronExecution": {
+        const r = await this.request("GET", `/api/services/${scope.teamId}/${scope.serviceId}/cron-executions`);
+        return r.executions ?? [];
+      }
+    }
+  }
 };
+function cacheScope(scope) {
+  switch (scope.kind) {
+    case "team":
+      return "team";
+    case "project":
+    case "service":
+    case "database":
+    case "domain":
+      return `${scope.kind}:${scope.teamId}`;
+    case "deploy":
+    case "envVar":
+    case "cronExecution":
+      return `${scope.kind}:${scope.teamId}:${scope.serviceId}`;
+  }
+}
 
 // src/pagination.ts
 function buildPaginationQuery(params) {