@hoststack.dev/sdk 0.10.0 → 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.
@@ -895,6 +930,26 @@ 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
@@ -1218,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.
@@ -895,6 +930,26 @@ 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
@@ -1218,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

@@ -641,6 +641,26 @@ 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