glitch-javascript-sdk 3.9.8 → 3.10.0

package/dist/index.d.ts

@@ -11550,8 +11550,124 @@ declare class GameAdvertising {
 
 type HostingPlanKey = 'free' | 'launch' | 'growth' | 'scale' | 'studio';
 type HostingMode = 'static' | 'server';
-type HostingDatabaseEngine = 'postgresql' | 'mysql' | 'azure_sql' | 'cosmos_nosql';
-type HostingDatabasePlan = 'sandbox' | 'launch' | 'growth' | 'scale' | 'dedicated';
+type HostingDatabaseEngine = 'postgresql' | 'mysql' | 'azure_sql' | 'cosmos_nosql' | 'redis';
+type HostingDatabasePlan = 'sandbox' | 'launch' | 'growth' | 'scale' | 'dedicated' | 'cache_sandbox' | 'cache_launch' | 'cache_growth' | 'cache_scale';
+type HostingServiceRole = 'web' | 'api' | 'game' | 'realtime' | 'simulation' | 'worker' | 'scheduled';
+type HostingServiceVisibility = 'public' | 'internal' | 'none';
+type HostingCapacityModel = 'singleton' | 'replicated' | 'serverless';
+type HostingBillingProvider = 'direct' | 'microsoft_marketplace' | 'aws_marketplace';
+interface HostingDatabaseCredentials {
+    database_id: string;
+    name: string;
+    engine: HostingDatabaseEngine;
+    binding_name: string;
+    connection_string: string;
+    connection: {
+        driver?: string;
+        host?: string;
+        endpoint?: string;
+        port?: number;
+        database?: string;
+        username?: string;
+        password?: string;
+        key?: string;
+        tls: boolean;
+    };
+    revealed_at: string;
+    /** UI safety timer only; the database credential itself does not expire after this interval. */
+    hide_after_seconds: number;
+}
+interface HostingServiceDeployment {
+    id: string;
+    hosting_service_id: string;
+    hosting_release_id: string;
+    game_build_id?: string | null;
+    version: string;
+    status: 'queued' | 'deploying' | 'ready' | 'active' | 'inactive' | 'failed';
+    image?: string | null;
+    azure_fqdn?: string | null;
+    error_message?: string | null;
+    ready_at?: string | null;
+    promoted_at?: string | null;
+}
+interface HostingService {
+    id: string;
+    hosting_site_id: string;
+    name: string;
+    slug: string;
+    role: HostingServiceRole;
+    runtime: 'node' | 'python' | 'rust' | 'container';
+    visibility: HostingServiceVisibility;
+    status: 'draft' | 'deploying' | 'active' | 'disabled' | 'failed';
+    is_primary: boolean;
+    target_port?: number | null;
+    transport: 'http' | 'http2' | 'tcp';
+    health_check_path?: string | null;
+    capacity_model: HostingCapacityModel;
+    container_cpu: number;
+    container_memory_mb: number;
+    min_replicas: number;
+    max_replicas: number;
+    schedule_cron?: string | null;
+    depends_on: string[];
+    database_bindings: string[];
+    secret_names: string[];
+    active_deployment?: HostingServiceDeployment | null;
+    deployments?: HostingServiceDeployment[];
+}
+interface HostingServiceDefinition {
+    name?: string;
+    slug: string;
+    role?: HostingServiceRole;
+    runtime?: 'node' | 'python' | 'rust' | 'container';
+    visibility?: HostingServiceVisibility;
+    is_primary?: boolean;
+    target_port?: number;
+    transport?: 'http' | 'http2' | 'tcp';
+    health_check_path?: string;
+    capacity_model?: HostingCapacityModel;
+    container_cpu?: number;
+    container_memory_mb?: number;
+    min_replicas?: number;
+    max_replicas?: number;
+    schedule_cron?: string;
+    depends_on?: string[];
+    environment?: Record<string, string | number | boolean | null>;
+    database_bindings?: string[];
+    configuration?: Record<string, unknown>;
+    command?: string[];
+    arguments?: string[];
+    game_build_id?: string;
+}
+interface HostingServiceStackRequest {
+    preset?: 'single_server' | 'web_and_api' | 'authoritative_world' | 'biomes_style';
+    game_build_id?: string;
+    builds?: Record<string, string>;
+    services?: HostingServiceDefinition[];
+}
+interface ApplyHostingServiceStackRequest extends HostingServiceStackRequest {
+    version: string;
+    test?: {
+        service: string;
+        command: string[];
+    };
+    migration?: {
+        service: string;
+        command: string[];
+    };
+}
+interface HostingServiceEstimate {
+    billing_provider: HostingBillingProvider;
+    estimated_monthly_floor_cents: number;
+    estimated_monthly_floor_dollars: number;
+    services: Array<Record<string, unknown>>;
+    rates: {
+        vcpu_hour_cents: number;
+        memory_gib_hour_cents: number;
+        requests_million_cents: number;
+    };
+    note: string;
+}
 interface CreateHostingSiteRequest {
     name: string;
     slug: string;
@@ -11610,12 +11726,25 @@ declare class Hosting {
     static checkDomain<T>(hostname: string): AxiosPromise<Response<T>>;
     static purchaseDomain<T>(title_id: string, site_id: string, data: Record<string, any>): AxiosPromise<Response<T>>;
     static aiInstructions<T>(title_id: string, site_id: string, data?: Record<string, any>): AxiosPromise<Response<T>>;
+    static services<T = HostingService[]>(title_id: string, site_id: string): AxiosPromise<Response<T>>;
+    /** Calculate the always-on floor without creating resources or charges. */
+    static estimateServices<T = HostingServiceEstimate>(title_id: string, site_id: string, data: HostingServiceStackRequest): AxiosPromise<Response<T>>;
+    /** Queue an immutable multi-service release. Publishing remains a separate operation. */
+    static applyServices<T>(title_id: string, site_id: string, data: ApplyHostingServiceStackRequest): AxiosPromise<Response<T>>;
+    /** Store or rotate a secret. The API never returns the value. Interactive administrators only. */
+    static putServiceSecret<T>(title_id: string, site_id: string, service_id: string, name: string, value: string): AxiosPromise<Response<T>>;
+    static deleteServiceSecret<T>(title_id: string, site_id: string, service_id: string, name: string): AxiosPromise<Response<T>>;
     static resolve<T>(hostname: string, gatewayToken?: string): AxiosPromise<Response<T>>;
     static startPlaySession<T>(data: Record<string, any>): AxiosPromise<Response<T>>;
     static heartbeatPlaySession<T>(session_id: string, sessionToken: string): AxiosPromise<Response<T>>;
     static databases<T>(title_id: string, site_id: string, params?: Record<string, any>): AxiosPromise<Response<T>>;
     static createDatabase<T>(title_id: string, site_id: string, data: CreateHostingDatabaseRequest): AxiosPromise<Response<T>>;
     static database<T>(title_id: string, site_id: string, database_id: string): AxiosPromise<Response<T>>;
+    /**
+     * Reveal credentials to a signed-in business billing administrator after an
+     * exact database-name confirmation. Hosting and MCP tokens are rejected.
+     */
+    static databaseCredentials<T = HostingDatabaseCredentials>(title_id: string, site_id: string, database_id: string, confirmation: string): AxiosPromise<Response<T>>;
     static updateDatabase<T>(title_id: string, site_id: string, database_id: string, data: Record<string, any>): AxiosPromise<Response<T>>;
     static retryDatabase<T>(title_id: string, site_id: string, database_id: string): AxiosPromise<Response<T>>;
     static deleteDatabase<T>(title_id: string, site_id: string, database_id: string, confirmation: string): AxiosPromise<Response<T>>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "glitch-javascript-sdk",
-  "version": "3.9.8",
+  "version": "3.10.0",
   "description": "Javascript SDK for Glitch",
   "publishConfig": {
     "access": "public"

package/src/api/Hosting.ts

@@ -6,8 +6,11 @@ import Response from '../util/Response';
 
 export type HostingPlanKey = 'free' | 'launch' | 'growth' | 'scale' | 'studio';
 export type HostingMode = 'static' | 'server';
-export type HostingDatabaseEngine = 'postgresql' | 'mysql' | 'azure_sql' | 'cosmos_nosql';
-export type HostingDatabasePlan = 'sandbox' | 'launch' | 'growth' | 'scale' | 'dedicated';
+export type HostingDatabaseEngine = 'postgresql' | 'mysql' | 'azure_sql' | 'cosmos_nosql' | 'redis';
+export type HostingDatabasePlan = 'sandbox' | 'launch' | 'growth' | 'scale' | 'dedicated' | 'cache_sandbox' | 'cache_launch' | 'cache_growth' | 'cache_scale';
+export type HostingServiceRole = 'web' | 'api' | 'game' | 'realtime' | 'simulation' | 'worker' | 'scheduled';
+export type HostingServiceVisibility = 'public' | 'internal' | 'none';
+export type HostingCapacityModel = 'singleton' | 'replicated' | 'serverless';
 export type HostingDeliveryChannel = 'glitch_store' | 'glitch_hosted_subdomain' | 'glitch_hosted_custom_domain' | 'external';
 export type HostingBillingProvider = 'direct' | 'microsoft_marketplace' | 'aws_marketplace';
 
@@ -33,12 +36,13 @@ export interface HostingRelease {
   game_build_id?: string | null;
   version: string;
   status: 'uploading' | 'processing' | 'ready' | 'failed' | 'active' | 'inactive';
-  source_type: 'upload' | 'cli' | 'game_build';
+  source_type: 'upload' | 'cli' | 'game_build' | 'service_stack';
   entry_point: string;
   size_bytes: number;
   checksum?: string | null;
   error_message?: string | null;
   promoted_at?: string | null;
+  service_deployments?: HostingServiceDeployment[];
 }
 
 export interface HostingDomain {
@@ -62,7 +66,7 @@ export interface HostingDatabase {
   engine: HostingDatabaseEngine;
   plan: HostingDatabasePlan;
   status: 'awaiting_payment' | 'requested' | 'provisioning' | 'ready' | 'resizing' | 'restoring' | 'failed' | 'deleting' | 'deleted';
-  deployment_model: 'shared' | 'dedicated' | 'serverless';
+  deployment_model: 'shared' | 'dedicated' | 'serverless' | 'managed_cache';
   azure_region: string;
   included_storage_bytes: number;
   current_storage_bytes: number;
@@ -78,6 +82,28 @@ export interface HostingDatabase {
   last_error?: string | null;
 }
 
+export interface HostingDatabaseCredentials {
+  database_id: string;
+  name: string;
+  engine: HostingDatabaseEngine;
+  binding_name: string;
+  connection_string: string;
+  connection: {
+    driver?: string;
+    host?: string;
+    endpoint?: string;
+    port?: number;
+    database?: string;
+    username?: string;
+    password?: string;
+    key?: string;
+    tls: boolean;
+  };
+  revealed_at: string;
+  /** UI safety timer only; the database credential itself does not expire after this interval. */
+  hide_after_seconds: number;
+}
+
 export interface HostingSite {
   id: string;
   hosting_account_id: string;
@@ -95,6 +121,98 @@ export interface HostingSite {
   active_release?: HostingRelease | null;
   domains?: HostingDomain[];
   databases?: HostingDatabase[];
+  services?: HostingService[];
+}
+
+export interface HostingServiceDeployment {
+  id: string;
+  hosting_service_id: string;
+  hosting_release_id: string;
+  game_build_id?: string | null;
+  version: string;
+  status: 'queued' | 'deploying' | 'ready' | 'active' | 'inactive' | 'failed';
+  image?: string | null;
+  azure_fqdn?: string | null;
+  error_message?: string | null;
+  ready_at?: string | null;
+  promoted_at?: string | null;
+}
+
+export interface HostingService {
+  id: string;
+  hosting_site_id: string;
+  name: string;
+  slug: string;
+  role: HostingServiceRole;
+  runtime: 'node' | 'python' | 'rust' | 'container';
+  visibility: HostingServiceVisibility;
+  status: 'draft' | 'deploying' | 'active' | 'disabled' | 'failed';
+  is_primary: boolean;
+  target_port?: number | null;
+  transport: 'http' | 'http2' | 'tcp';
+  health_check_path?: string | null;
+  capacity_model: HostingCapacityModel;
+  container_cpu: number;
+  container_memory_mb: number;
+  min_replicas: number;
+  max_replicas: number;
+  schedule_cron?: string | null;
+  depends_on: string[];
+  database_bindings: string[];
+  secret_names: string[];
+  active_deployment?: HostingServiceDeployment | null;
+  deployments?: HostingServiceDeployment[];
+}
+
+export interface HostingServiceDefinition {
+  name?: string;
+  slug: string;
+  role?: HostingServiceRole;
+  runtime?: 'node' | 'python' | 'rust' | 'container';
+  visibility?: HostingServiceVisibility;
+  is_primary?: boolean;
+  target_port?: number;
+  transport?: 'http' | 'http2' | 'tcp';
+  health_check_path?: string;
+  capacity_model?: HostingCapacityModel;
+  container_cpu?: number;
+  container_memory_mb?: number;
+  min_replicas?: number;
+  max_replicas?: number;
+  schedule_cron?: string;
+  depends_on?: string[];
+  environment?: Record<string, string | number | boolean | null>;
+  database_bindings?: string[];
+  configuration?: Record<string, unknown>;
+  command?: string[];
+  arguments?: string[];
+  game_build_id?: string;
+}
+
+export interface HostingServiceStackRequest {
+  preset?: 'single_server' | 'web_and_api' | 'authoritative_world' | 'biomes_style';
+  game_build_id?: string;
+  builds?: Record<string, string>;
+  services?: HostingServiceDefinition[];
+}
+
+export interface ApplyHostingServiceStackRequest extends HostingServiceStackRequest {
+  version: string;
+  test?: { service: string; command: string[] };
+  migration?: { service: string; command: string[] };
+}
+
+export interface HostingServiceEstimate {
+  billing_provider: HostingBillingProvider;
+  estimated_monthly_floor_cents: number;
+  estimated_monthly_floor_dollars: number;
+  services: Array<Record<string, unknown>>;
+  rates: {
+    vcpu_hour_cents: number;
+    memory_gib_hour_cents: number;
+    requests_million_cents: number;
+  };
+  note: string;
 }
 
 export interface CreateHostingSiteRequest {
@@ -263,6 +381,29 @@ class Hosting {
     return Requests.processRoute(HostingRoute.routes.aiInstructions, data, { title_id, site_id });
   }
 
+  public static services<T = HostingService[]>(title_id: string, site_id: string): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.services, undefined, { title_id, site_id });
+  }
+
+  /** Calculate the always-on floor without creating resources or charges. */
+  public static estimateServices<T = HostingServiceEstimate>(title_id: string, site_id: string, data: HostingServiceStackRequest): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.estimateServices, data, { title_id, site_id });
+  }
+
+  /** Queue an immutable multi-service release. Publishing remains a separate operation. */
+  public static applyServices<T>(title_id: string, site_id: string, data: ApplyHostingServiceStackRequest): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.applyServices, data, { title_id, site_id });
+  }
+
+  /** Store or rotate a secret. The API never returns the value. Interactive administrators only. */
+  public static putServiceSecret<T>(title_id: string, site_id: string, service_id: string, name: string, value: string): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.putServiceSecret, { value }, { title_id, site_id, service_id, name });
+  }
+
+  public static deleteServiceSecret<T>(title_id: string, site_id: string, service_id: string, name: string): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.deleteServiceSecret, undefined, { title_id, site_id, service_id, name });
+  }
+
   public static resolve<T>(hostname: string, gatewayToken?: string): AxiosPromise<Response<T>> {
     if (!gatewayToken) {
       return Requests.processRoute(HostingRoute.routes.resolve, undefined, undefined, { hostname });
@@ -298,6 +439,14 @@ class Hosting {
     return Requests.processRoute(HostingRoute.routes.database, undefined, { title_id, site_id, database_id });
   }
 
+  /**
+   * Reveal credentials to a signed-in business billing administrator after an
+   * exact database-name confirmation. Hosting and MCP tokens are rejected.
+   */
+  public static databaseCredentials<T = HostingDatabaseCredentials>(title_id: string, site_id: string, database_id: string, confirmation: string): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.databaseCredentials, { confirmation }, { title_id, site_id, database_id });
+  }
+
   public static updateDatabase<T>(title_id: string, site_id: string, database_id: string, data: Record<string, any>): AxiosPromise<Response<T>> {
     return Requests.processRoute(HostingRoute.routes.updateDatabase, data, { title_id, site_id, database_id });
   }

package/src/routes/HostingRoute.ts

@@ -26,12 +26,18 @@ class HostingRoute {
     checkDomain: { url: '/hosting/domains/check', method: HTTP_METHODS.POST },
     purchaseDomain: { url: '/titles/{title_id}/hosting/sites/{site_id}/domains/purchase', method: HTTP_METHODS.POST },
     aiInstructions: { url: '/titles/{title_id}/hosting/sites/{site_id}/ai-instructions', method: HTTP_METHODS.POST },
+    services: { url: '/titles/{title_id}/hosting/sites/{site_id}/services', method: HTTP_METHODS.GET },
+    estimateServices: { url: '/titles/{title_id}/hosting/sites/{site_id}/services/estimate', method: HTTP_METHODS.POST },
+    applyServices: { url: '/titles/{title_id}/hosting/sites/{site_id}/services/apply', method: HTTP_METHODS.POST },
+    putServiceSecret: { url: '/titles/{title_id}/hosting/sites/{site_id}/services/{service_id}/secrets/{name}', method: HTTP_METHODS.PUT },
+    deleteServiceSecret: { url: '/titles/{title_id}/hosting/sites/{site_id}/services/{service_id}/secrets/{name}', method: HTTP_METHODS.DELETE },
     resolve: { url: '/hosting/resolve', method: HTTP_METHODS.GET },
     startPlaySession: { url: '/hosting/play-sessions', method: HTTP_METHODS.POST },
     heartbeatPlaySession: { url: '/hosting/play-sessions/{session_id}/heartbeat', method: HTTP_METHODS.POST },
     databases: { url: '/titles/{title_id}/hosting/sites/{site_id}/databases', method: HTTP_METHODS.GET },
     createDatabase: { url: '/titles/{title_id}/hosting/sites/{site_id}/databases', method: HTTP_METHODS.POST },
     database: { url: '/titles/{title_id}/hosting/sites/{site_id}/databases/{database_id}', method: HTTP_METHODS.GET },
+    databaseCredentials: { url: '/titles/{title_id}/hosting/sites/{site_id}/databases/{database_id}/credentials', method: HTTP_METHODS.POST },
     updateDatabase: { url: '/titles/{title_id}/hosting/sites/{site_id}/databases/{database_id}', method: HTTP_METHODS.PUT },
     retryDatabase: { url: '/titles/{title_id}/hosting/sites/{site_id}/databases/{database_id}/retry', method: HTTP_METHODS.POST },
     deleteDatabase: { url: '/titles/{title_id}/hosting/sites/{site_id}/databases/{database_id}', method: HTTP_METHODS.DELETE },