@hoststack.dev/sdk 0.8.2 → 0.9.1

package/dist/index.d.cts

@@ -1,35 +1,47 @@
+/**
+ * Region identifiers accepted by every endpoint that takes a `region`
+ * input. Mirrors `packages/shared/src/constants/regions.ts:30` — keep
+ * the two in sync when adding a region.
+ */
+type RegionId = 'eu-central-1' | 'eu-central-2' | 'eu-west-1' | 'us-east-1';
 interface Project {
     id: number;
     publicId: string;
     name: string;
     slug: string;
     description?: string | null;
-    region: string;
+    region: RegionId;
     createdAt: string;
     updatedAt: string;
 }
 interface CreateProjectInput {
     name: string;
     description?: string;
-    region?: string;
+    region?: RegionId;
 }
 interface UpdateProjectInput {
     name?: string;
     description?: string;
 }
+type ServiceType = 'web_service' | 'private_service' | 'worker' | 'cron_job' | 'static_site';
+/**
+ * v89: `sleeping` is the free-tier idle state — container is `docker pause`d
+ * but warm-resumes <100ms on the next request. Distinct from `suspended`
+ * (admin/user action; container fully stopped, requires a deploy to revive).
+ */
+type ServiceStatus = 'active' | 'deploying' | 'suspended' | 'failed' | 'not_deployed' | 'sleeping';
+type ServicePlan = 'pico' | 'nano' | 'micro' | 'starter' | 'standard' | 'pro_standard' | 'pro_large';
 interface Service {
     id: number;
     publicId: string;
     name: string;
-    type: string;
-    status: string;
+    type: ServiceType;
+    status: ServiceStatus;
     internalUrl?: string | null;
     projectId: number;
     createdAt: string;
     updatedAt: string;
 }
-type ServiceType = 'web_service' | 'private_service' | 'worker' | 'cron_job' | 'static_site';
-type ServicePlan = 'pico' | 'nano' | 'micro' | 'starter' | 'standard' | 'pro_standard' | 'pro_large';
 interface CreateServiceInput {
     name: string;
     type: ServiceType;
@@ -147,11 +159,17 @@ interface UpdateServiceConfigInput {
         action: 'drop' | 'downgrade';
     }> | null;
 }
+/**
+ * `superseded` (v63 P4) means a newer push for the same (service, branch) arrived
+ * before this deploy could finish. Distinct from `cancelled` (operator-initiated).
+ */
+type DeployStatus = 'pending' | 'building' | 'build_failed' | 'deploying' | 'live' | 'failed' | 'cancelled' | 'deactivated' | 'superseded';
+type DeployTrigger = 'github_push' | 'gitlab_push' | 'bitbucket_push' | 'manual' | 'rollback' | 'api' | 'config_change';
 interface Deploy {
     id: number;
     publicId: string;
-    status: string;
-    trigger: string;
+    status: DeployStatus;
+    trigger: DeployTrigger;
     commitHash?: string | null;
     commitMessage?: string | null;
     createdAt: string;
@@ -196,6 +214,13 @@ interface TriggerDeployInput {
 }
 /** Managed database engines supported by HostStack. */
 type DatabaseEngine = 'postgres' | 'redis' | 'mysql' | 'mariadb' | 'mongodb';
+/**
+ * `migrating` (v89 Phase 4) is the transient state while the agent runs the
+ * single-node → HA migration (pg_dump → bootstrap → pg_restore). Reads stay
+ * read-only during this window.
+ */
+type DatabaseStatus = 'creating' | 'available' | 'suspended' | 'deleting' | 'error' | 'migrating';
+type DatabasePlan = 'free' | 'micro' | 'starter' | 'standard' | 'pro';
 interface Database {
     id: number;
     publicId: string;
@@ -203,10 +228,10 @@ interface Database {
     /** The engine name. The legacy `type` alias still ships in API responses
      * but is deprecated — read `engine` going forward. */
     engine: DatabaseEngine;
-    status: string;
+    status: DatabaseStatus;
     version?: string | null;
-    plan?: string | null;
-    region?: string | null;
+    plan?: DatabasePlan | null;
+    region?: RegionId | null;
     projectId: number;
     diskSizeGb?: number;
     memoryMb?: number;
@@ -227,12 +252,12 @@ interface CreateDatabaseInput {
      */
     environmentId?: number;
     version?: string;
-    plan?: 'free' | 'micro' | 'starter' | 'standard' | 'pro';
-    region?: string;
+    plan?: DatabasePlan;
+    region?: RegionId;
 }
 interface UpdateDatabaseInput {
     name?: string;
-    plan?: 'free' | 'micro' | 'starter' | 'standard' | 'pro';
+    plan?: DatabasePlan;
     /** Grow the database disk in GB. Cannot shrink. */
     diskSizeGb?: number;
 }
@@ -275,11 +300,12 @@ interface UpdateVolumeInput {
     mountPath?: string;
     sizeGb?: number;
 }
+type DomainStatus = 'pending' | 'active' | 'failed' | 'deleting';
 interface Domain {
     id: number;
     publicId: string;
     domain: string;
-    status: string;
+    status: DomainStatus;
     verified: boolean;
     serviceId?: number | null;
     createdAt: string;
@@ -330,12 +356,13 @@ interface User {
     email: string;
     avatarUrl?: string | null;
 }
+type TeamRole = 'owner' | 'admin' | 'member';
 interface Team {
     id: number;
     publicId: string;
     name: string;
     slug: string;
-    role: string;
+    role: TeamRole;
 }
 interface MeResponse {
     /** Null when authenticated with an API key (no associated user). */
@@ -345,7 +372,12 @@ interface MeResponse {
         id: number;
         permission: string;
     };
+    /** `'test'` when the API is wired to Stripe's test mode, `'live'` otherwise. */
     stripeMode?: string;
+    /** True when the caller is a superadmin acting on behalf of another team. Always false for API-key auth. */
+    isImpersonating?: boolean;
+    /** v88 P1b: server-side flag the dashboard renders as a "please add a card" prompt for free-tier teams 14+ days in. */
+    cardPromptVisible?: boolean;
 }
 /**
  * A single point in a service metrics time series. Same shape used for
@@ -376,14 +408,16 @@ interface ServiceMetricsSnapshot {
         containerCount: number;
     } | null;
 }
+type CronExecutionStatus = 'pending' | 'running' | 'succeeded' | 'failed';
+type CronExecutionTrigger = 'scheduled' | 'manual';
 interface CronExecution {
     id: number;
     publicId: string;
-    status: string;
+    status: CronExecutionStatus;
     startedAt?: string | null;
     finishedAt?: string | null;
     exitCode?: number | null;
-    triggeredBy?: string | null;
+    triggeredBy?: CronExecutionTrigger | null;
     createdAt: string;
 }
 interface ActivityLogEntry {
@@ -827,8 +861,8 @@ declare class ServicesResource {
     list(teamId: IdInput, filters?: {
         projectId?: number | string;
         environmentId?: number | string;
-        status?: 'active' | 'deploying' | 'suspended' | 'failed' | 'not_deployed';
-        type?: 'web_service' | 'private_service' | 'worker' | 'cron_job' | 'static_site';
+        status?: ServiceStatus;
+        type?: ServiceType;
     }): Promise<{
         services: Service[];
     }>;
@@ -928,6 +962,20 @@ declare class ServicesResource {
     streamLogs(teamId: IdInput, serviceId: IdInput, options?: StreamLogsOptions): AsyncGenerator<LogEntry>;
 }
 
+declare class TeamsResource {
+    private client;
+    constructor(client: HostStack);
+    /**
+     * List the teams the authenticated principal can access.
+     *
+     * Session auth: all teams the user belongs to.
+     * API-key auth: the single team the key is bound to.
+     */
+    list(): Promise<{
+        teams: Team[];
+    }>;
+}
+
 /**
  * Manage persistent disks attached to a service.
  *
@@ -1041,7 +1089,15 @@ declare class HostStack {
      * failures, restart loops, ACME failures, git auth losses, etc.
      */
     readonly notifications: NotificationsResource;
+    /** List the teams this API key (or session) can access. */
+    readonly teams: TeamsResource;
     constructor(options: HostStackOptions);
+    /**
+     * Identify the authenticated principal. For API-key auth, `user` is
+     * `null` and `team` is the team the key is bound to; `apiKey` carries
+     * the key's permission scope (read or full).
+     */
+    me(): Promise<MeResponse>;
     /**
      * Make an authenticated request to the HostStack API.
      * Used internally by resource classes. Can also be used for custom API calls.
@@ -1089,32 +1145,39 @@ declare class RateLimitError extends HostStackError {
 
 /**
  * Standard pagination parameters for list requests.
+ *
+ * Mirrors `packages/shared/src/schemas/pagination.ts` — the API uses
+ * `page` (1-based) + `perPage` (≤100) everywhere. Use these names
+ * directly in your code; the SDK serializes them as the matching
+ * query-string params.
  */
 interface PaginationParams {
-    /** Maximum number of items to return. */
-    limit?: number;
-    /** Number of items to skip. */
-    offset?: number;
+    /** 1-based page number. Default `1`. */
+    page?: number;
+    /** Items per page. Range 1–100, default `20`. */
+    perPage?: number;
+    /** Free-text search applied server-side. ≤200 chars. */
+    search?: string;
+    /** Column to sort by (route-dependent). */
+    sortBy?: string;
+    /** Sort direction. Default `'desc'`. */
+    sortOrder?: 'asc' | 'desc';
 }
 /**
- * A paginated response wrapper.
+ * A paginated response wrapper. Mirrors the shape every paginated API
+ * endpoint returns under `data` + `total` + `page` + `perPage` + `totalPages`.
  */
 interface PaginatedResponse<T> {
-    items: T[];
+    data: T[];
     total: number;
-    limit: number;
-    offset: number;
-    hasMore: boolean;
+    page: number;
+    perPage: number;
+    totalPages: number;
 }
 /**
  * Builds a query string from pagination params.
  * Returns an empty string if no params are set.
  */
 declare function buildPaginationQuery(params?: PaginationParams): string;
-/**
- * Wraps a plain array result into a PaginatedResponse.
- * Useful when the API returns a flat array without pagination metadata.
- */
-declare function wrapArray<T>(items: T[], params?: PaginationParams): PaginatedResponse<T>;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type Database, type DatabaseCredentials, type Deploy, type DeployListResponse, type DeployLogEntry, type Domain, type EnvVar, 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 Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceType, type StreamLogsOptions, type Team, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery, wrapArray };
+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 };

package/dist/index.d.ts

@@ -1,35 +1,47 @@
+/**
+ * Region identifiers accepted by every endpoint that takes a `region`
+ * input. Mirrors `packages/shared/src/constants/regions.ts:30` — keep
+ * the two in sync when adding a region.
+ */
+type RegionId = 'eu-central-1' | 'eu-central-2' | 'eu-west-1' | 'us-east-1';
 interface Project {
     id: number;
     publicId: string;
     name: string;
     slug: string;
     description?: string | null;
-    region: string;
+    region: RegionId;
     createdAt: string;
     updatedAt: string;
 }
 interface CreateProjectInput {
     name: string;
     description?: string;
-    region?: string;
+    region?: RegionId;
 }
 interface UpdateProjectInput {
     name?: string;
     description?: string;
 }
+type ServiceType = 'web_service' | 'private_service' | 'worker' | 'cron_job' | 'static_site';
+/**
+ * v89: `sleeping` is the free-tier idle state — container is `docker pause`d
+ * but warm-resumes <100ms on the next request. Distinct from `suspended`
+ * (admin/user action; container fully stopped, requires a deploy to revive).
+ */
+type ServiceStatus = 'active' | 'deploying' | 'suspended' | 'failed' | 'not_deployed' | 'sleeping';
+type ServicePlan = 'pico' | 'nano' | 'micro' | 'starter' | 'standard' | 'pro_standard' | 'pro_large';
 interface Service {
     id: number;
     publicId: string;
     name: string;
-    type: string;
-    status: string;
+    type: ServiceType;
+    status: ServiceStatus;
     internalUrl?: string | null;
     projectId: number;
     createdAt: string;
     updatedAt: string;
 }
-type ServiceType = 'web_service' | 'private_service' | 'worker' | 'cron_job' | 'static_site';
-type ServicePlan = 'pico' | 'nano' | 'micro' | 'starter' | 'standard' | 'pro_standard' | 'pro_large';
 interface CreateServiceInput {
     name: string;
     type: ServiceType;
@@ -147,11 +159,17 @@ interface UpdateServiceConfigInput {
         action: 'drop' | 'downgrade';
     }> | null;
 }
+/**
+ * `superseded` (v63 P4) means a newer push for the same (service, branch) arrived
+ * before this deploy could finish. Distinct from `cancelled` (operator-initiated).
+ */
+type DeployStatus = 'pending' | 'building' | 'build_failed' | 'deploying' | 'live' | 'failed' | 'cancelled' | 'deactivated' | 'superseded';
+type DeployTrigger = 'github_push' | 'gitlab_push' | 'bitbucket_push' | 'manual' | 'rollback' | 'api' | 'config_change';
 interface Deploy {
     id: number;
     publicId: string;
-    status: string;
-    trigger: string;
+    status: DeployStatus;
+    trigger: DeployTrigger;
     commitHash?: string | null;
     commitMessage?: string | null;
     createdAt: string;
@@ -196,6 +214,13 @@ interface TriggerDeployInput {
 }
 /** Managed database engines supported by HostStack. */
 type DatabaseEngine = 'postgres' | 'redis' | 'mysql' | 'mariadb' | 'mongodb';
+/**
+ * `migrating` (v89 Phase 4) is the transient state while the agent runs the
+ * single-node → HA migration (pg_dump → bootstrap → pg_restore). Reads stay
+ * read-only during this window.
+ */
+type DatabaseStatus = 'creating' | 'available' | 'suspended' | 'deleting' | 'error' | 'migrating';
+type DatabasePlan = 'free' | 'micro' | 'starter' | 'standard' | 'pro';
 interface Database {
     id: number;
     publicId: string;
@@ -203,10 +228,10 @@ interface Database {
     /** The engine name. The legacy `type` alias still ships in API responses
      * but is deprecated — read `engine` going forward. */
     engine: DatabaseEngine;
-    status: string;
+    status: DatabaseStatus;
     version?: string | null;
-    plan?: string | null;
-    region?: string | null;
+    plan?: DatabasePlan | null;
+    region?: RegionId | null;
     projectId: number;
     diskSizeGb?: number;
     memoryMb?: number;
@@ -227,12 +252,12 @@ interface CreateDatabaseInput {
      */
     environmentId?: number;
     version?: string;
-    plan?: 'free' | 'micro' | 'starter' | 'standard' | 'pro';
-    region?: string;
+    plan?: DatabasePlan;
+    region?: RegionId;
 }
 interface UpdateDatabaseInput {
     name?: string;
-    plan?: 'free' | 'micro' | 'starter' | 'standard' | 'pro';
+    plan?: DatabasePlan;
     /** Grow the database disk in GB. Cannot shrink. */
     diskSizeGb?: number;
 }
@@ -275,11 +300,12 @@ interface UpdateVolumeInput {
     mountPath?: string;
     sizeGb?: number;
 }
+type DomainStatus = 'pending' | 'active' | 'failed' | 'deleting';
 interface Domain {
     id: number;
     publicId: string;
     domain: string;
-    status: string;
+    status: DomainStatus;
     verified: boolean;
     serviceId?: number | null;
     createdAt: string;
@@ -330,12 +356,13 @@ interface User {
     email: string;
     avatarUrl?: string | null;
 }
+type TeamRole = 'owner' | 'admin' | 'member';
 interface Team {
     id: number;
     publicId: string;
     name: string;
     slug: string;
-    role: string;
+    role: TeamRole;
 }
 interface MeResponse {
     /** Null when authenticated with an API key (no associated user). */
@@ -345,7 +372,12 @@ interface MeResponse {
         id: number;
         permission: string;
     };
+    /** `'test'` when the API is wired to Stripe's test mode, `'live'` otherwise. */
     stripeMode?: string;
+    /** True when the caller is a superadmin acting on behalf of another team. Always false for API-key auth. */
+    isImpersonating?: boolean;
+    /** v88 P1b: server-side flag the dashboard renders as a "please add a card" prompt for free-tier teams 14+ days in. */
+    cardPromptVisible?: boolean;
 }
 /**
  * A single point in a service metrics time series. Same shape used for
@@ -376,14 +408,16 @@ interface ServiceMetricsSnapshot {
         containerCount: number;
     } | null;
 }
+type CronExecutionStatus = 'pending' | 'running' | 'succeeded' | 'failed';
+type CronExecutionTrigger = 'scheduled' | 'manual';
 interface CronExecution {
     id: number;
     publicId: string;
-    status: string;
+    status: CronExecutionStatus;
     startedAt?: string | null;
     finishedAt?: string | null;
     exitCode?: number | null;
-    triggeredBy?: string | null;
+    triggeredBy?: CronExecutionTrigger | null;
     createdAt: string;
 }
 interface ActivityLogEntry {
@@ -827,8 +861,8 @@ declare class ServicesResource {
     list(teamId: IdInput, filters?: {
         projectId?: number | string;
         environmentId?: number | string;
-        status?: 'active' | 'deploying' | 'suspended' | 'failed' | 'not_deployed';
-        type?: 'web_service' | 'private_service' | 'worker' | 'cron_job' | 'static_site';
+        status?: ServiceStatus;
+        type?: ServiceType;
     }): Promise<{
         services: Service[];
     }>;
@@ -928,6 +962,20 @@ declare class ServicesResource {
     streamLogs(teamId: IdInput, serviceId: IdInput, options?: StreamLogsOptions): AsyncGenerator<LogEntry>;
 }
 
+declare class TeamsResource {
+    private client;
+    constructor(client: HostStack);
+    /**
+     * List the teams the authenticated principal can access.
+     *
+     * Session auth: all teams the user belongs to.
+     * API-key auth: the single team the key is bound to.
+     */
+    list(): Promise<{
+        teams: Team[];
+    }>;
+}
+
 /**
  * Manage persistent disks attached to a service.
  *
@@ -1041,7 +1089,15 @@ declare class HostStack {
      * failures, restart loops, ACME failures, git auth losses, etc.
      */
     readonly notifications: NotificationsResource;
+    /** List the teams this API key (or session) can access. */
+    readonly teams: TeamsResource;
     constructor(options: HostStackOptions);
+    /**
+     * Identify the authenticated principal. For API-key auth, `user` is
+     * `null` and `team` is the team the key is bound to; `apiKey` carries
+     * the key's permission scope (read or full).
+     */
+    me(): Promise<MeResponse>;
     /**
      * Make an authenticated request to the HostStack API.
      * Used internally by resource classes. Can also be used for custom API calls.
@@ -1089,32 +1145,39 @@ declare class RateLimitError extends HostStackError {
 
 /**
  * Standard pagination parameters for list requests.
+ *
+ * Mirrors `packages/shared/src/schemas/pagination.ts` — the API uses
+ * `page` (1-based) + `perPage` (≤100) everywhere. Use these names
+ * directly in your code; the SDK serializes them as the matching
+ * query-string params.
  */
 interface PaginationParams {
-    /** Maximum number of items to return. */
-    limit?: number;
-    /** Number of items to skip. */
-    offset?: number;
+    /** 1-based page number. Default `1`. */
+    page?: number;
+    /** Items per page. Range 1–100, default `20`. */
+    perPage?: number;
+    /** Free-text search applied server-side. ≤200 chars. */
+    search?: string;
+    /** Column to sort by (route-dependent). */
+    sortBy?: string;
+    /** Sort direction. Default `'desc'`. */
+    sortOrder?: 'asc' | 'desc';
 }
 /**
- * A paginated response wrapper.
+ * A paginated response wrapper. Mirrors the shape every paginated API
+ * endpoint returns under `data` + `total` + `page` + `perPage` + `totalPages`.
  */
 interface PaginatedResponse<T> {
-    items: T[];
+    data: T[];
     total: number;
-    limit: number;
-    offset: number;
-    hasMore: boolean;
+    page: number;
+    perPage: number;
+    totalPages: number;
 }
 /**
  * Builds a query string from pagination params.
  * Returns an empty string if no params are set.
  */
 declare function buildPaginationQuery(params?: PaginationParams): string;
-/**
- * Wraps a plain array result into a PaginatedResponse.
- * Useful when the API returns a flat array without pagination metadata.
- */
-declare function wrapArray<T>(items: T[], params?: PaginationParams): PaginatedResponse<T>;
 
-export { type ActivityLogEntry, type AddDomainInput, AuthenticationError, type BulkSetEnvVarsInput, ConflictError, type CreateDatabaseInput, type CreateEnvVarInput, type CreateEnvironmentInput, type CreateProjectInput, type CreateServiceInput, type CreateVolumeInput, type CronExecution, type Database, type DatabaseCredentials, type Deploy, type DeployListResponse, type DeployLogEntry, type Domain, type EnvVar, 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 Service, type ServiceConfig, type ServiceMetricsPoint, type ServiceMetricsSnapshot, type ServicePlan, type ServiceType, type StreamLogsOptions, type Team, type TriggerDeployInput, type UpdateDatabaseInput, type UpdateDomainInput, type UpdateEnvVarInput, type UpdateEnvironmentInput, type UpdateProjectInput, type UpdateServiceConfigInput, type UpdateServiceInput, type UpdateVolumeInput, type User, type Volume, buildPaginationQuery, wrapArray };
+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 };

package/dist/index.js

@@ -565,12 +565,12 @@ function normalizeEntries(logs) {
   return logs;
 }
 function sleep(ms, signal) {
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve) => {
     const timer = setTimeout(resolve, ms);
     if (signal) {
       signal.addEventListener("abort", () => {
         clearTimeout(timer);
-        reject(new DOMException("Aborted", "AbortError"));
+        resolve();
       });
     }
   });
@@ -727,6 +727,22 @@ var ServicesResource = class {
   }
 };
 
+// src/resources/teams.ts
+var TeamsResource = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * List the teams the authenticated principal can access.
+   *
+   * Session auth: all teams the user belongs to.
+   * API-key auth: the single team the key is bound to.
+   */
+  async list() {
+    return this.client.request("GET", "/api/auth/teams");
+  }
+};
+
 // src/resources/volumes.ts
 var VolumesResource = class {
   constructor(client) {
@@ -816,6 +832,8 @@ var HostStack = class {
    * failures, restart loops, ACME failures, git auth losses, etc.
    */
   notifications;
+  /** List the teams this API key (or session) can access. */
+  teams;
   constructor(options) {
     if (!options.apiKey) {
       throw new Error("apiKey is required");
@@ -832,6 +850,15 @@ var HostStack = class {
     this.cron = new CronResource(this);
     this.volumes = new VolumesResource(this);
     this.notifications = new NotificationsResource(this);
+    this.teams = new TeamsResource(this);
+  }
+  /**
+   * Identify the authenticated principal. For API-key auth, `user` is
+   * `null` and `team` is the team the key is bound to; `apiKey` carries
+   * the key's permission scope (read or full).
+   */
+  async me() {
+    return this.request("GET", "/api/auth/me");
   }
   /**
    * Make an authenticated request to the HostStack API.
@@ -985,23 +1012,15 @@ function cacheScope(scope) {
 function buildPaginationQuery(params) {
   if (!params) return "";
   const qs = new URLSearchParams();
-  if (params.limit !== void 0) qs.set("limit", String(params.limit));
-  if (params.offset !== void 0) qs.set("offset", String(params.offset));
+  if (params.page !== void 0) qs.set("page", String(params.page));
+  if (params.perPage !== void 0) qs.set("perPage", String(params.perPage));
+  if (params.search !== void 0) qs.set("search", params.search);
+  if (params.sortBy !== void 0) qs.set("sortBy", params.sortBy);
+  if (params.sortOrder !== void 0) qs.set("sortOrder", params.sortOrder);
   const str = qs.toString();
   return str ? `?${str}` : "";
 }
-function wrapArray(items, params) {
-  const limit = params?.limit ?? items.length;
-  const offset = params?.offset ?? 0;
-  return {
-    items,
-    total: items.length,
-    limit,
-    offset,
-    hasMore: false
-  };
-}
 
-export { AuthenticationError, ConflictError, ForbiddenError, HostStack, HostStackError, NotFoundError, RateLimitError, buildPaginationQuery, wrapArray };
+export { AuthenticationError, ConflictError, ForbiddenError, HostStack, HostStackError, NotFoundError, RateLimitError, buildPaginationQuery };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map