@hoststack.dev/sdk 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -32,6 +32,12 @@ interface CreateServiceInput {
     name: string;
     type: string;
     projectId?: string;
+    /**
+     * v66 P5: bind the new service to a specific environment in the
+     * project. Omit to default to the project's Production env. Find or
+     * list envs with `client.environments.list(teamId, projectId)`.
+     */
+    environmentId?: number;
     gitUrl?: string;
     branch?: string;
     buildCommand?: string;
@@ -137,6 +143,11 @@ interface CreateDatabaseInput {
     name: string;
     engine: DatabaseEngine;
     projectId: number;
+    /**
+     * v66 P5: bind the new database to a specific environment in the
+     * project. Omit to default to the project's Production env.
+     */
+    environmentId?: number;
     version?: string;
     plan?: 'free' | 'starter' | 'standard' | 'pro';
     region?: string;
@@ -354,6 +365,15 @@ declare class DeploysResource {
     cancel(teamId: IdInput, serviceId: IdInput, deployId: IdInput): Promise<void>;
     /** Rollback to a previous deploy. */
     rollback(teamId: IdInput, serviceId: IdInput, deployId: IdInput): Promise<void>;
+    /**
+     * v66 P5: promote a built deploy to a sibling service in another
+     * environment. Reuses the source deploy's docker image (no rebuild).
+     * If no sibling service exists in the target env yet, the API auto-
+     * creates one by cloning the source service's config.
+     */
+    promote(teamId: IdInput, serviceId: IdInput, deployId: IdInput, targetEnvironmentId: number): Promise<{
+        deploy: Deploy;
+    }>;
     /**
      * Get build logs for a deploy.
      *
@@ -401,6 +421,76 @@ declare class DomainsResource {
     verify(teamId: IdInput, domainId: IdInput): Promise<void>;
 }
 
+interface Environment {
+    id: number;
+    publicId: string;
+    projectId: number;
+    name: string;
+    type: 'production' | 'staging' | 'development' | 'preview';
+    isDefault: boolean;
+    isProtected: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateEnvironmentInput {
+    name: string;
+    type: 'production' | 'staging' | 'development' | 'preview';
+    isProtected?: boolean;
+}
+interface UpdateEnvironmentInput {
+    name?: string;
+    isDefault?: boolean;
+    isProtected?: boolean;
+}
+/**
+ * v66 P5: programmatic env management. Each project has at least a
+ * Production env auto-created at project creation; you can add more
+ * via `create` and bind services/databases to them via the
+ * `environmentId` field on those resources' create inputs.
+ *
+ * @example
+ * ```ts
+ * const { environment: staging } = await client.environments.create(
+ *   teamId,
+ *   projectId,
+ *   { name: 'Staging', type: 'staging' }
+ * );
+ * await client.services.create(teamId, {
+ *   projectId,
+ *   environmentId: staging.id,
+ *   name: 'api',
+ *   type: 'web_service',
+ *   // ...
+ * });
+ * ```
+ */
+declare class EnvironmentsResource {
+    private client;
+    constructor(client: HostStack);
+    /** List all environments for a project. */
+    list(teamId: IdInput, projectId: IdInput): Promise<{
+        environments: Environment[];
+    }>;
+    /** Get a single environment by id. */
+    get(teamId: IdInput, projectId: IdInput, envId: IdInput): Promise<{
+        environment: Environment;
+    }>;
+    /** Create a new environment in the given project. */
+    create(teamId: IdInput, projectId: IdInput, data: CreateEnvironmentInput): Promise<{
+        environment: Environment;
+    }>;
+    /** Update environment metadata (name, default flag, protected flag). */
+    update(teamId: IdInput, projectId: IdInput, envId: IdInput, data: UpdateEnvironmentInput): Promise<{
+        environment: Environment;
+    }>;
+    /**
+     * Delete an environment. The API blocks delete when the env still
+     * has services or databases attached — destroy them first or move
+     * them to another env. Cannot delete the project's default env.
+     */
+    delete(teamId: IdInput, projectId: IdInput, envId: IdInput): Promise<void>;
+}
+
 declare class EnvVarsResource {
     private client;
     constructor(client: HostStack);
@@ -505,13 +595,31 @@ declare class ServicesResource {
     updateConfig(teamId: IdInput, serviceId: IdInput, data: UpdateServiceConfigInput): Promise<{
         config: ServiceConfig;
     }>;
-    /** Get runtime logs for a service. */
+    /**
+     * Get runtime logs for a service.
+     *
+     * `since`/`until` accept either an ISO-8601 timestamp or a short
+     * relative offset like `-5m`, `-1h`, `-2d`.
+     *
+     * `search` does case-insensitive substring filtering server-side
+     * (≤100 chars). `countOnly` returns just `{ count: N }` for cheap
+     * polling — useful when you want to know "how many error lines in the
+     * last 5 minutes" without paying the bytes.
+     */
     getRuntimeLogs(teamId: IdInput, serviceId: IdInput, options?: {
         lines?: number;
+        limit?: number;
         since?: string;
+        until?: string;
         stream?: 'stdout' | 'stderr';
+        level?: 'stdout' | 'stderr' | 'info' | 'warn' | 'error' | 'debug';
+        search?: string;
+        grep?: string;
+        countOnly?: boolean;
     }): Promise<{
         logs: LogEntry[] | string;
+    } | {
+        count: number;
     }>;
     /**
      * Stream runtime logs for a service by polling the logs endpoint.
@@ -609,6 +717,9 @@ type ResolveScope = {
     kind: 'envVar';
     teamId: number;
     serviceId: number;
+} | {
+    kind: 'environment';
+    teamId: number;
 } | {
     kind: 'cronExecution';
     teamId: number;
@@ -630,6 +741,8 @@ declare class HostStack {
     readonly domains: DomainsResource;
     /** Manage service environment variables. */
     readonly envVars: EnvVarsResource;
+    /** v66: manage environments (production/staging/development/preview) per project. */
+    readonly environments: EnvironmentsResource;
     /** Manage cron job executions. */
     readonly cron: CronResource;
     /** Manage persistent disks attached to services. */
@@ -697,4 +810,4 @@ declare function buildPaginationQuery(params?: PaginationParams): string;
  */
 declare function wrapArray<T>(items: T[], params?: PaginationParams): PaginatedResponse<T>;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, type CreateDatabaseInput, type CreateEnvVarInput, type CreateProjectInput, type CreateServiceInput, type CronExecution, type Database, type DatabaseCredentials, type Deploy, type Domain, type EnvVar, HostStack, HostStackError, type HostStackOptions, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type Service, type ServiceConfig, type ServiceMetrics, type StreamLogsOptions, type Team, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type User, buildPaginationQuery, wrapArray };
+export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CronExecution, type Database, type DatabaseCredentials, type Deploy, type Domain, type EnvVar, type Environment, HostStack, HostStackError, type HostStackOptions, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type Service, type ServiceConfig, type ServiceMetrics, type StreamLogsOptions, type Team, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type User, buildPaginationQuery, wrapArray };

package/dist/index.d.ts

@@ -32,6 +32,12 @@ interface CreateServiceInput {
     name: string;
     type: string;
     projectId?: string;
+    /**
+     * v66 P5: bind the new service to a specific environment in the
+     * project. Omit to default to the project's Production env. Find or
+     * list envs with `client.environments.list(teamId, projectId)`.
+     */
+    environmentId?: number;
     gitUrl?: string;
     branch?: string;
     buildCommand?: string;
@@ -137,6 +143,11 @@ interface CreateDatabaseInput {
     name: string;
     engine: DatabaseEngine;
     projectId: number;
+    /**
+     * v66 P5: bind the new database to a specific environment in the
+     * project. Omit to default to the project's Production env.
+     */
+    environmentId?: number;
     version?: string;
     plan?: 'free' | 'starter' | 'standard' | 'pro';
     region?: string;
@@ -354,6 +365,15 @@ declare class DeploysResource {
     cancel(teamId: IdInput, serviceId: IdInput, deployId: IdInput): Promise<void>;
     /** Rollback to a previous deploy. */
     rollback(teamId: IdInput, serviceId: IdInput, deployId: IdInput): Promise<void>;
+    /**
+     * v66 P5: promote a built deploy to a sibling service in another
+     * environment. Reuses the source deploy's docker image (no rebuild).
+     * If no sibling service exists in the target env yet, the API auto-
+     * creates one by cloning the source service's config.
+     */
+    promote(teamId: IdInput, serviceId: IdInput, deployId: IdInput, targetEnvironmentId: number): Promise<{
+        deploy: Deploy;
+    }>;
     /**
      * Get build logs for a deploy.
      *
@@ -401,6 +421,76 @@ declare class DomainsResource {
     verify(teamId: IdInput, domainId: IdInput): Promise<void>;
 }
 
+interface Environment {
+    id: number;
+    publicId: string;
+    projectId: number;
+    name: string;
+    type: 'production' | 'staging' | 'development' | 'preview';
+    isDefault: boolean;
+    isProtected: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+interface CreateEnvironmentInput {
+    name: string;
+    type: 'production' | 'staging' | 'development' | 'preview';
+    isProtected?: boolean;
+}
+interface UpdateEnvironmentInput {
+    name?: string;
+    isDefault?: boolean;
+    isProtected?: boolean;
+}
+/**
+ * v66 P5: programmatic env management. Each project has at least a
+ * Production env auto-created at project creation; you can add more
+ * via `create` and bind services/databases to them via the
+ * `environmentId` field on those resources' create inputs.
+ *
+ * @example
+ * ```ts
+ * const { environment: staging } = await client.environments.create(
+ *   teamId,
+ *   projectId,
+ *   { name: 'Staging', type: 'staging' }
+ * );
+ * await client.services.create(teamId, {
+ *   projectId,
+ *   environmentId: staging.id,
+ *   name: 'api',
+ *   type: 'web_service',
+ *   // ...
+ * });
+ * ```
+ */
+declare class EnvironmentsResource {
+    private client;
+    constructor(client: HostStack);
+    /** List all environments for a project. */
+    list(teamId: IdInput, projectId: IdInput): Promise<{
+        environments: Environment[];
+    }>;
+    /** Get a single environment by id. */
+    get(teamId: IdInput, projectId: IdInput, envId: IdInput): Promise<{
+        environment: Environment;
+    }>;
+    /** Create a new environment in the given project. */
+    create(teamId: IdInput, projectId: IdInput, data: CreateEnvironmentInput): Promise<{
+        environment: Environment;
+    }>;
+    /** Update environment metadata (name, default flag, protected flag). */
+    update(teamId: IdInput, projectId: IdInput, envId: IdInput, data: UpdateEnvironmentInput): Promise<{
+        environment: Environment;
+    }>;
+    /**
+     * Delete an environment. The API blocks delete when the env still
+     * has services or databases attached — destroy them first or move
+     * them to another env. Cannot delete the project's default env.
+     */
+    delete(teamId: IdInput, projectId: IdInput, envId: IdInput): Promise<void>;
+}
+
 declare class EnvVarsResource {
     private client;
     constructor(client: HostStack);
@@ -505,13 +595,31 @@ declare class ServicesResource {
     updateConfig(teamId: IdInput, serviceId: IdInput, data: UpdateServiceConfigInput): Promise<{
         config: ServiceConfig;
     }>;
-    /** Get runtime logs for a service. */
+    /**
+     * Get runtime logs for a service.
+     *
+     * `since`/`until` accept either an ISO-8601 timestamp or a short
+     * relative offset like `-5m`, `-1h`, `-2d`.
+     *
+     * `search` does case-insensitive substring filtering server-side
+     * (≤100 chars). `countOnly` returns just `{ count: N }` for cheap
+     * polling — useful when you want to know "how many error lines in the
+     * last 5 minutes" without paying the bytes.
+     */
     getRuntimeLogs(teamId: IdInput, serviceId: IdInput, options?: {
         lines?: number;
+        limit?: number;
         since?: string;
+        until?: string;
         stream?: 'stdout' | 'stderr';
+        level?: 'stdout' | 'stderr' | 'info' | 'warn' | 'error' | 'debug';
+        search?: string;
+        grep?: string;
+        countOnly?: boolean;
     }): Promise<{
         logs: LogEntry[] | string;
+    } | {
+        count: number;
     }>;
     /**
      * Stream runtime logs for a service by polling the logs endpoint.
@@ -609,6 +717,9 @@ type ResolveScope = {
     kind: 'envVar';
     teamId: number;
     serviceId: number;
+} | {
+    kind: 'environment';
+    teamId: number;
 } | {
     kind: 'cronExecution';
     teamId: number;
@@ -630,6 +741,8 @@ declare class HostStack {
     readonly domains: DomainsResource;
     /** Manage service environment variables. */
     readonly envVars: EnvVarsResource;
+    /** v66: manage environments (production/staging/development/preview) per project. */
+    readonly environments: EnvironmentsResource;
     /** Manage cron job executions. */
     readonly cron: CronResource;
     /** Manage persistent disks attached to services. */
@@ -697,4 +810,4 @@ declare function buildPaginationQuery(params?: PaginationParams): string;
  */
 declare function wrapArray<T>(items: T[], params?: PaginationParams): PaginatedResponse<T>;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, type CreateDatabaseInput, type CreateEnvVarInput, type CreateProjectInput, type CreateServiceInput, type CronExecution, type Database, type DatabaseCredentials, type Deploy, type Domain, type EnvVar, HostStack, HostStackError, type HostStackOptions, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type Service, type ServiceConfig, type ServiceMetrics, type StreamLogsOptions, type Team, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type User, buildPaginationQuery, wrapArray };
+export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CronExecution, type Database, type DatabaseCredentials, type Deploy, type Domain, type EnvVar, type Environment, HostStack, HostStackError, type HostStackOptions, type LogEntry$1 as LogEntry, type MeResponse, NotFoundError, type PaginatedResponse, type PaginationParams, type Project, RateLimitError, type Service, type ServiceConfig, type ServiceMetrics, type StreamLogsOptions, type Team, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type User, buildPaginationQuery, wrapArray };

package/dist/index.js

@@ -182,6 +182,26 @@ var DeploysResource = class {
     });
     return this.client.request("POST", `/api/services/${tid}/${sid}/deploys/${did}/rollback`);
   }
+  /**
+   * v66 P5: promote a built deploy to a sibling service in another
+   * environment. Reuses the source deploy's docker image (no rebuild).
+   * If no sibling service exists in the target env yet, the API auto-
+   * creates one by cloning the source service's config.
+   */
+  async promote(teamId, serviceId, deployId, targetEnvironmentId) {
+    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}/promote`,
+      { targetEnvironmentId }
+    );
+  }
   /**
    * Get build logs for a deploy.
    *
@@ -243,6 +263,50 @@ var DomainsResource = class {
   }
 };
 
+// src/resources/environments.ts
+var EnvironmentsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List all environments for a project. */
+  async list(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/environments/${tid}/${pid}`);
+  }
+  /** Get a single environment by id. */
+  async get(teamId, projectId, envId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
+    const eid = await this.client.resolveId(envId, { kind: "environment", teamId: tid });
+    return this.client.request("GET", `/api/environments/${tid}/${pid}/${eid}`);
+  }
+  /** Create a new environment in the given project. */
+  async create(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("POST", `/api/environments/${tid}/${pid}`, data);
+  }
+  /** Update environment metadata (name, default flag, protected flag). */
+  async update(teamId, projectId, envId, data) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
+    const eid = await this.client.resolveId(envId, { kind: "environment", teamId: tid });
+    return this.client.request("PATCH", `/api/environments/${tid}/${pid}/${eid}`, data);
+  }
+  /**
+   * Delete an environment. The API blocks delete when the env still
+   * has services or databases attached — destroy them first or move
+   * them to another env. Cannot delete the project's default env.
+   */
+  async delete(teamId, projectId, envId) {
+    const tid = await this.client.resolveId(teamId, { kind: "team" });
+    const pid = await this.client.resolveId(projectId, { kind: "project", teamId: tid });
+    const eid = await this.client.resolveId(envId, { kind: "environment", teamId: tid });
+    return this.client.request("DELETE", `/api/environments/${tid}/${pid}/${eid}`);
+  }
+};
+
 // src/resources/env-vars.ts
 var EnvVarsResource = class {
   constructor(client) {
@@ -333,7 +397,7 @@ async function* streamLogsViaPolling(fetch2, basePath, options = {}) {
   const buildPath = (lines, since) => {
     const params = new URLSearchParams();
     if (options.stream) params.set("stream", options.stream);
-    if (lines !== void 0) params.set("lines", String(lines));
+    if (lines !== void 0) params.set("limit", String(lines));
     if (since) params.set("since", since);
     const qs = params.toString();
     return `${basePath}${qs ? `?${qs}` : ""}`;
@@ -445,14 +509,30 @@ var ServicesResource = class {
     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. */
+  /**
+   * Get runtime logs for a service.
+   *
+   * `since`/`until` accept either an ISO-8601 timestamp or a short
+   * relative offset like `-5m`, `-1h`, `-2d`.
+   *
+   * `search` does case-insensitive substring filtering server-side
+   * (≤100 chars). `countOnly` returns just `{ count: N }` for cheap
+   * polling — useful when you want to know "how many error lines in the
+   * last 5 minutes" without paying the bytes.
+   */
   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));
+    const lim = options?.limit ?? options?.lines;
+    if (lim != null) params.set("limit", String(lim));
     if (options?.since) params.set("since", options.since);
+    if (options?.until) params.set("until", options.until);
     if (options?.stream) params.set("stream", options.stream);
+    if (options?.level) params.set("level", options.level);
+    const grep = options?.grep ?? options?.search;
+    if (grep) params.set("search", grep);
+    if (options?.countOnly) params.set("count_only", "1");
     const qs = params.toString();
     return this.client.request(
       "GET",
@@ -541,6 +621,7 @@ var PREFIX = {
   domain: "dom_",
   volume: "vol_",
   envVar: "env_",
+  environment: "environment_",
   cronExecution: "cjob_"
 };
 var HostStack = class {
@@ -560,6 +641,8 @@ var HostStack = class {
   domains;
   /** Manage service environment variables. */
   envVars;
+  /** v66: manage environments (production/staging/development/preview) per project. */
+  environments;
   /** Manage cron job executions. */
   cron;
   /** Manage persistent disks attached to services. */
@@ -576,6 +659,7 @@ var HostStack = class {
     this.databases = new DatabasesResource(this);
     this.domains = new DomainsResource(this);
     this.envVars = new EnvVarsResource(this);
+    this.environments = new EnvironmentsResource(this);
     this.cron = new CronResource(this);
     this.volumes = new VolumesResource(this);
   }
@@ -704,6 +788,15 @@ var HostStack = class {
         const r = await this.request("GET", `/api/services/${scope.teamId}/${scope.serviceId}/cron-executions`);
         return r.executions ?? [];
       }
+      case "environment": {
+        const projectsRes = await this.request("GET", `/api/projects/${scope.teamId}`);
+        const envs = [];
+        for (const p of projectsRes.projects ?? []) {
+          const r = await this.request("GET", `/api/environments/${scope.teamId}/${p.id}`);
+          envs.push(...r.environments ?? []);
+        }
+        return envs;
+      }
     }
   }
 };
@@ -715,6 +808,7 @@ function cacheScope(scope) {
     case "service":
     case "database":
     case "domain":
+    case "environment":
       return `${scope.kind}:${scope.teamId}`;
     case "deploy":
     case "volume":