@hoststack.dev/sdk 0.9.2 → 0.11.0

package/dist/index.d.cts

@@ -75,6 +75,41 @@ interface CreateServiceInput {
     /** True when this service is a dev environment (agentic dev-env image, or manually flagged). */
     isDevEnvironment?: boolean;
 }
+/** Companion managed services a standalone dev box can stand up alongside itself. */
+type DevEnvCompanion = 'postgres' | 'redis' | 'meilisearch';
+/** Where a standalone dev box's code comes from. */
+type DevEnvSource = {
+    kind: 'github_repo';
+    githubRepoId: number;
+    branch?: string;
+} | {
+    kind: 'url';
+    cloneUrl: string;
+    branch?: string;
+} | {
+    kind: 'blank';
+};
+/**
+ * Create a standalone dev environment — a cloud box (Claude Code / Codex /
+ * OpenCode on a persistent /workspace) created from a connected GitHub repo, an
+ * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+ * Meilisearch wired into its env. Lives in the team's hidden Development home.
+ */
+interface CreateDevEnvironmentInput {
+    name: string;
+    source: DevEnvSource;
+    /** Companion databases/search to attach (fresh + empty), like local `make db-up`. */
+    databases?: DevEnvCompanion[];
+    /** Compute size for the box. Defaults to `micro`. */
+    plan?: string;
+}
+/** A dev environment as listed for the Development section — a service plus the
+ * companion services attached to it. */
+interface DevEnvironment extends Service {
+    devUrl?: string | null;
+    /** Companion engines attached to the box (e.g. `['postgres','redis']`). */
+    databases?: string[];
+}
 /**
  * Fields that live on the `services` row — write via PATCH /services/:tid/:sid.
  * Nullable fields accept `null` to clear; `undefined` leaves the value unchanged.
@@ -520,6 +555,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
@@ -882,6 +930,49 @@ declare class ServicesResource {
     }>;
     /** Delete a service. */
     delete(teamId: IdInput, serviceId: IdInput): Promise<void>;
+    /**
+     * List the team's dev environments (the Development section), each annotated
+     * with the companion services attached to it (`databases`).
+     */
+    listDevEnvironments(teamId: IdInput): Promise<{
+        environments: DevEnvironment[];
+    }>;
+    /**
+     * Create a STANDALONE dev environment — a cloud box (Claude Code / Codex /
+     * OpenCode on a persistent /workspace) from a connected GitHub repo, an
+     * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+     * Meilisearch. Unlike `spinUpDevEnvironment`, there's no source service — the
+     * box lives in the team's hidden Development home. Returns the box, its dev
+     * URL, and the first deploy id. Tear it down with `tearDownDevEnvironment`.
+     */
+    createDevEnvironment(teamId: IdInput, data: CreateDevEnvironmentInput): Promise<{
+        service: Service;
+        devUrl: string;
+        deployId: number | null;
+    }>;
+    /**
+     * 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. */
@@ -1182,4 +1273,4 @@ interface PaginatedResponse<T> {
  */
 declare function buildPaginationQuery(params?: PaginationParams): string;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };
+export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateDevEnvironmentInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type DevEnvCompanion, type DevEnvSource, type DevEnvironment, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };

package/dist/index.d.ts

@@ -75,6 +75,41 @@ interface CreateServiceInput {
     /** True when this service is a dev environment (agentic dev-env image, or manually flagged). */
     isDevEnvironment?: boolean;
 }
+/** Companion managed services a standalone dev box can stand up alongside itself. */
+type DevEnvCompanion = 'postgres' | 'redis' | 'meilisearch';
+/** Where a standalone dev box's code comes from. */
+type DevEnvSource = {
+    kind: 'github_repo';
+    githubRepoId: number;
+    branch?: string;
+} | {
+    kind: 'url';
+    cloneUrl: string;
+    branch?: string;
+} | {
+    kind: 'blank';
+};
+/**
+ * Create a standalone dev environment — a cloud box (Claude Code / Codex /
+ * OpenCode on a persistent /workspace) created from a connected GitHub repo, an
+ * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+ * Meilisearch wired into its env. Lives in the team's hidden Development home.
+ */
+interface CreateDevEnvironmentInput {
+    name: string;
+    source: DevEnvSource;
+    /** Companion databases/search to attach (fresh + empty), like local `make db-up`. */
+    databases?: DevEnvCompanion[];
+    /** Compute size for the box. Defaults to `micro`. */
+    plan?: string;
+}
+/** A dev environment as listed for the Development section — a service plus the
+ * companion services attached to it. */
+interface DevEnvironment extends Service {
+    devUrl?: string | null;
+    /** Companion engines attached to the box (e.g. `['postgres','redis']`). */
+    databases?: string[];
+}
 /**
  * Fields that live on the `services` row — write via PATCH /services/:tid/:sid.
  * Nullable fields accept `null` to clear; `undefined` leaves the value unchanged.
@@ -520,6 +555,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
@@ -882,6 +930,49 @@ declare class ServicesResource {
     }>;
     /** Delete a service. */
     delete(teamId: IdInput, serviceId: IdInput): Promise<void>;
+    /**
+     * List the team's dev environments (the Development section), each annotated
+     * with the companion services attached to it (`databases`).
+     */
+    listDevEnvironments(teamId: IdInput): Promise<{
+        environments: DevEnvironment[];
+    }>;
+    /**
+     * Create a STANDALONE dev environment — a cloud box (Claude Code / Codex /
+     * OpenCode on a persistent /workspace) from a connected GitHub repo, an
+     * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+     * Meilisearch. Unlike `spinUpDevEnvironment`, there's no source service — the
+     * box lives in the team's hidden Development home. Returns the box, its dev
+     * URL, and the first deploy id. Tear it down with `tearDownDevEnvironment`.
+     */
+    createDevEnvironment(teamId: IdInput, data: CreateDevEnvironmentInput): Promise<{
+        service: Service;
+        devUrl: string;
+        deployId: number | null;
+    }>;
+    /**
+     * 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. */
@@ -1182,4 +1273,4 @@ interface PaginatedResponse<T> {
  */
 declare function buildPaginationQuery(params?: PaginationParams): string;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };
+export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateDevEnvironmentInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type CronExecutionStatus, type CronExecutionTrigger, type Database, type DatabaseCredentials, type DatabaseEngine, type DatabasePlan, type DatabaseStatus, type Deploy, type DeployListResponse, type DeployLogEntry, type DeployStatus, type DeployTrigger, type DevEnvCompanion, type DevEnvSource, type DevEnvironment, type Domain, type DomainStatus, type EnvVar, type EnvVarTarget, type Environment, ForbiddenError, HostStack, HostStackError, type HostStackOptions, type IdInput, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type NotificationChannel, type NotificationChannelEvent, type NotificationChannelType, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type RegionId, type Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceStatus, type ServiceType, type StreamLogsOptions, type Team, type TeamRole, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery };

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,52 @@ var ServicesResource = class {
     const sid = await this.client.resolveId(serviceId, { kind: "service", teamId: tid });
     return this.client.request("DELETE", `/api/services/${tid}/${sid}`);
   }
+  /**
+   * List the team's dev environments (the Development section), each annotated
+   * with the companion services attached to it (`databases`).
+   */
+  async listDevEnvironments(teamId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("GET", `/api/dev-environments/${tid}`);
+  }
+  /**
+   * Create a STANDALONE dev environment — a cloud box (Claude Code / Codex /
+   * OpenCode on a persistent /workspace) from a connected GitHub repo, an
+   * arbitrary clone URL, or blank, with optional companion Postgres / Redis /
+   * Meilisearch. Unlike `spinUpDevEnvironment`, there's no source service — the
+   * box lives in the team's hidden Development home. Returns the box, its dev
+   * URL, and the first deploy id. Tear it down with `tearDownDevEnvironment`.
+   */
+  async createDevEnvironment(teamId, data) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    return this.client.request("POST", `/api/dev-environments/${tid}`, data);
+  }
+  /**
+   * 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" });