glitch-javascript-sdk 3.9.8 → 3.10.0

package/dist/esm/api/Hosting.d.ts

@@ -2,8 +2,11 @@ import { AxiosPromise, AxiosProgressEvent } from 'axios';
 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';
 export interface HostingAccount {
@@ -27,12 +30,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 {
     id: string;
@@ -54,7 +58,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;
@@ -69,6 +73,27 @@ export interface HostingDatabase {
     billing_active: boolean;
     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;
@@ -86,6 +111,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 {
     name: string;
@@ -176,12 +293,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/dist/esm/index.js

@@ -21341,12 +21341,18 @@ HostingRoute.routes = {
     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 },
@@ -21438,6 +21444,24 @@ class Hosting {
     static aiInstructions(title_id, site_id, data = {}) {
         return Requests.processRoute(HostingRoute.routes.aiInstructions, data, { title_id, site_id });
     }
+    static services(title_id, site_id) {
+        return Requests.processRoute(HostingRoute.routes.services, undefined, { title_id, site_id });
+    }
+    /** Calculate the always-on floor without creating resources or charges. */
+    static estimateServices(title_id, site_id, data) {
+        return Requests.processRoute(HostingRoute.routes.estimateServices, data, { title_id, site_id });
+    }
+    /** Queue an immutable multi-service release. Publishing remains a separate operation. */
+    static applyServices(title_id, site_id, data) {
+        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. */
+    static putServiceSecret(title_id, site_id, service_id, name, value) {
+        return Requests.processRoute(HostingRoute.routes.putServiceSecret, { value }, { title_id, site_id, service_id, name });
+    }
+    static deleteServiceSecret(title_id, site_id, service_id, name) {
+        return Requests.processRoute(HostingRoute.routes.deleteServiceSecret, undefined, { title_id, site_id, service_id, name });
+    }
     static resolve(hostname, gatewayToken) {
         if (!gatewayToken) {
             return Requests.processRoute(HostingRoute.routes.resolve, undefined, undefined, { hostname });
@@ -21466,6 +21490,13 @@ class Hosting {
     static database(title_id, site_id, database_id) {
         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.
+     */
+    static databaseCredentials(title_id, site_id, database_id, confirmation) {
+        return Requests.processRoute(HostingRoute.routes.databaseCredentials, { confirmation }, { title_id, site_id, database_id });
+    }
     static updateDatabase(title_id, site_id, database_id, data) {
         return Requests.processRoute(HostingRoute.routes.updateDatabase, data, { title_id, site_id, database_id });
     }