@hoststack.dev/sdk 0.9.1 → 0.10.0

package/dist/index.d.cts

@@ -72,6 +72,8 @@ interface CreateServiceInput {
     runtime?: string;
     autoDeploy?: boolean;
     multistage?: boolean;
+    /** True when this service is a dev environment (agentic dev-env image, or manually flagged). */
+    isDevEnvironment?: boolean;
 }
 /**
  * Fields that live on the `services` row — write via PATCH /services/:tid/:sid.
@@ -518,6 +520,19 @@ declare class DatabasesResource {
      * `pgEngineType === 'patroni'` + `status === 'available'` to confirm.
      */
     upgradeToHa(teamId: IdInput, databaseId: IdInput): Promise<void>;
+    /**
+     * In-place engine version upgrade (postgres/redis standalone). The agent
+     * dumps the live data, recreates the container at `version` under the same
+     * DNS name, and restores — so connection URLs stay valid. There's a brief
+     * interruption (seconds) while the new container comes up.
+     *
+     * `version` must be a supported, strictly-newer version for the engine
+     * (e.g. '18' for postgres, '8' for redis). Throws 400 otherwise.
+     *
+     * Returns 202 — the upgrade is async; poll `get(...)` until `version`
+     * matches the target and `status === 'available'` to confirm.
+     */
+    upgradeVersion(teamId: IdInput, databaseId: IdInput, version: string): Promise<void>;
     /**
      * v89 Phase 5: cluster topology + failover history for a Patroni-managed
      * Postgres database. Returns 400 for standalone databases — call
@@ -880,6 +895,29 @@ declare class ServicesResource {
     }>;
     /** Delete a service. */
     delete(teamId: IdInput, serviceId: IdInput): Promise<void>;
+    /**
+     * Spin up an agentic dev environment FROM this service: a dev box that runs
+     * a clone of the app (repo auto-cloned into /workspace, env-vars copied, and
+     * the linked database cloned so it never touches prod), with an unguessable
+     * public dev URL and seamless `git push`. Returns the dev box, its dev URL,
+     * and the first deploy id.
+     */
+    spinUpDevEnvironment(teamId: IdInput, serviceId: IdInput, options?: {
+        includeDatabaseClone?: boolean;
+        name?: string;
+    }): Promise<{
+        service: Service;
+        devUrl: string;
+        deployId: number | null;
+    }>;
+    /**
+     * Tear a dev environment down: removes the dev box and cascade-deletes its
+     * cloned database, /workspace volume, and the empty `development`
+     * environment. `serviceId` is the dev box itself.
+     */
+    tearDownDevEnvironment(teamId: IdInput, serviceId: IdInput): Promise<{
+        success: true;
+    }>;
     /** Suspend a service. */
     suspend(teamId: IdInput, serviceId: IdInput): Promise<void>;
     /** Resume a suspended service. */

package/dist/index.d.ts

@@ -72,6 +72,8 @@ interface CreateServiceInput {
     runtime?: string;
     autoDeploy?: boolean;
     multistage?: boolean;
+    /** True when this service is a dev environment (agentic dev-env image, or manually flagged). */
+    isDevEnvironment?: boolean;
 }
 /**
  * Fields that live on the `services` row — write via PATCH /services/:tid/:sid.
@@ -518,6 +520,19 @@ declare class DatabasesResource {
      * `pgEngineType === 'patroni'` + `status === 'available'` to confirm.
      */
     upgradeToHa(teamId: IdInput, databaseId: IdInput): Promise<void>;
+    /**
+     * In-place engine version upgrade (postgres/redis standalone). The agent
+     * dumps the live data, recreates the container at `version` under the same
+     * DNS name, and restores — so connection URLs stay valid. There's a brief
+     * interruption (seconds) while the new container comes up.
+     *
+     * `version` must be a supported, strictly-newer version for the engine
+     * (e.g. '18' for postgres, '8' for redis). Throws 400 otherwise.
+     *
+     * Returns 202 — the upgrade is async; poll `get(...)` until `version`
+     * matches the target and `status === 'available'` to confirm.
+     */
+    upgradeVersion(teamId: IdInput, databaseId: IdInput, version: string): Promise<void>;
     /**
      * v89 Phase 5: cluster topology + failover history for a Patroni-managed
      * Postgres database. Returns 400 for standalone databases — call
@@ -880,6 +895,29 @@ declare class ServicesResource {
     }>;
     /** Delete a service. */
     delete(teamId: IdInput, serviceId: IdInput): Promise<void>;
+    /**
+     * Spin up an agentic dev environment FROM this service: a dev box that runs
+     * a clone of the app (repo auto-cloned into /workspace, env-vars copied, and
+     * the linked database cloned so it never touches prod), with an unguessable
+     * public dev URL and seamless `git push`. Returns the dev box, its dev URL,
+     * and the first deploy id.
+     */
+    spinUpDevEnvironment(teamId: IdInput, serviceId: IdInput, options?: {
+        includeDatabaseClone?: boolean;
+        name?: string;
+    }): Promise<{
+        service: Service;
+        devUrl: string;
+        deployId: number | null;
+    }>;
+    /**
+     * Tear a dev environment down: removes the dev box and cascade-deletes its
+     * cloned database, /workspace volume, and the empty `development`
+     * environment. `serviceId` is the dev box itself.
+     */
+    tearDownDevEnvironment(teamId: IdInput, serviceId: IdInput): Promise<{
+        success: true;
+    }>;
     /** Suspend a service. */
     suspend(teamId: IdInput, serviceId: IdInput): Promise<void>;
     /** Resume a suspended service. */

package/dist/index.js

@@ -183,6 +183,25 @@ var DatabasesResource = class {
     const did = await this.client.resolveId(databaseId, { kind: "database", teamId: tid });
     return this.client.request("POST", `/api/databases/${tid}/${did}/upgrade-to-ha`);
   }
+  /**
+   * In-place engine version upgrade (postgres/redis standalone). The agent
+   * dumps the live data, recreates the container at `version` under the same
+   * DNS name, and restores — so connection URLs stay valid. There's a brief
+   * interruption (seconds) while the new container comes up.
+   *
+   * `version` must be a supported, strictly-newer version for the engine
+   * (e.g. '18' for postgres, '8' for redis). Throws 400 otherwise.
+   *
+   * Returns 202 — the upgrade is async; poll `get(...)` until `version`
+   * matches the target and `status === 'available'` to confirm.
+   */
+  async upgradeVersion(teamId, databaseId, version) {
+    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-version`, {
+      version
+    });
+  }
   /**
    * v89 Phase 5: cluster topology + failover history for a Patroni-managed
    * Postgres database. Returns 400 for standalone databases — call
@@ -622,6 +641,32 @@ var ServicesResource = class {
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
     return this.client.request("DELETE", `/api/services/${tid}/${sid}`);
   }
+  /**
+   * Spin up an agentic dev environment FROM this service: a dev box that runs
+   * a clone of the app (repo auto-cloned into /workspace, env-vars copied, and
+   * the linked database cloned so it never touches prod), with an unguessable
+   * public dev URL and seamless `git push`. Returns the dev box, its dev URL,
+   * and the first deploy id.
+   */
+  async spinUpDevEnvironment(teamId, serviceId, options) {
+    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}/dev-environment`,
+      options ?? {}
+    );
+  }
+  /**
+   * Tear a dev environment down: removes the dev box and cascade-deletes its
+   * cloned database, /workspace volume, and the empty `development`
+   * environment. `serviceId` is the dev box itself.
+   */
+  async tearDownDevEnvironment(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}/dev-environment`);
+  }
   /** Suspend a service. */
   async suspend(teamId, serviceId) {
     const tid = await this.client.resolveId(teamId, { kind: "team" });