glitch-javascript-sdk 3.9.4 → 3.9.6

package/dist/esm/routes/HostingRoute.d.ts

@@ -1,5 +1,5 @@
 import Route from './interface';
-/** Route catalog for Azure-backed game website hosting. */
+/** Route catalog for game website hosting and its direct or Marketplace billing. */
 declare class HostingRoute {
     static routes: {
         [key: string]: Route;

package/dist/index.d.ts

@@ -4107,6 +4107,31 @@ type GameReviewRecommendation = 'recommended' | 'not_recommended' | 'neutral';
 type GameReviewSentiment = 'positive' | 'mixed' | 'negative';
 type GameReviewVoteType = 'helpful' | 'funny' | 'detailed' | 'not_helpful';
 type GameReviewReportReason = 'abuse' | 'spam' | 'off_topic' | 'manipulation' | 'hate' | 'personal_info' | 'other';
+type TitleTokenPurpose = 'install' | 'deploy' | 'hosting';
+type TitleTokenAbility = 'deployments:*' | 'deployments:create' | 'deployments:read' | 'deployments:activate' | 'hosting:*' | 'hosting:read' | 'hosting:deploy' | 'hosting:promote';
+interface CreateTitleTokenRequest {
+    expires_at?: string;
+    name?: string;
+    purpose?: TitleTokenPurpose;
+    abilities?: TitleTokenAbility[];
+}
+interface TitleToken {
+    id: string;
+    title_id: string;
+    name?: string | null;
+    purpose: TitleTokenPurpose;
+    token_prefix: string;
+    abilities: TitleTokenAbility[];
+    expires_at?: string | null;
+    revoked: boolean;
+    last_used_at?: string | null;
+    created_at?: string;
+}
+interface CreatedTitleToken {
+    /** Full secret value. Returned once and never retrievable again. */
+    full_token: string;
+    token: TitleToken;
+}
 interface GameReviewRatings {
     gameplay?: GameReviewSentiment;
     performance?: GameReviewSentiment;
@@ -4315,17 +4340,15 @@ declare class Titles {
    * Create a new API token for a title.
    * Returns { full_token: string, token: TitleToken }.
    */
-    static createTitleToken<T>(title_id: string, data?: {
-        expires_at?: string;
-    }): AxiosPromise<Response<T>>;
+    static createTitleToken<T = CreatedTitleToken>(title_id: string, data?: CreateTitleTokenRequest): AxiosPromise<Response<T>>;
     /**
      * List all tokens for a title.
      */
-    static listTitleTokens<T>(title_id: string): AxiosPromise<Response<T>>;
+    static listTitleTokens<T = TitleToken[]>(title_id: string): AxiosPromise<Response<T>>;
     /**
      * Revoke a specific token by ID.
      */
-    static revokeTitleToken<T>(title_id: string, token_id: string): AxiosPromise<Response<T>>;
+    static revokeTitleToken<T = TitleToken>(title_id: string, token_id: string): AxiosPromise<Response<T>>;
     /**
      * Search for Titles using Meilisearch or fallback based on the query and filters.
      *
@@ -11562,6 +11585,12 @@ declare class Hosting {
     static billingCheckout<T>(title_id: string, plan: HostingPlanKey): AxiosPromise<Response<T>>;
     /** Confirm a paid Stripe Checkout session before provisioning its Azure resource. */
     static confirmBillingCheckout<T>(title_id: string, checkout_session_id: string): AxiosPromise<Response<T>>;
+    /** Resolve the one-hour purchase token passed to Glitch by Microsoft Marketplace. */
+    static resolveMarketplacePurchase<T>(token: string): AxiosPromise<Response<T>>;
+    /** Link a resolved Microsoft Marketplace subscription to a billable Glitch business account. */
+    static activateMarketplaceSubscription<T>(subscription_id: string, community_id: string): AxiosPromise<Response<T>>;
+    /** Retrieve safe Microsoft Marketplace entitlement and lifecycle status. */
+    static marketplaceSubscription<T>(subscription_id: string): AxiosPromise<Response<T>>;
     static createSite<T>(title_id: string, data: CreateHostingSiteRequest): AxiosPromise<Response<T>>;
     static updateSite<T>(title_id: string, site_id: string, data: Partial<CreateHostingSiteRequest> & Record<string, any>): AxiosPromise<Response<T>>;
     static createUploadUrl<T>(title_id: string, site_id: string): AxiosPromise<Response<T>>;

package/package.json

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

package/src/api/Hosting.ts

@@ -9,6 +9,7 @@ export type HostingMode = 'static' | 'server';
 export type HostingDatabaseEngine = 'postgresql' | 'mysql' | 'azure_sql' | 'cosmos_nosql';
 export type HostingDatabasePlan = 'sandbox' | 'launch' | 'growth' | 'scale' | 'dedicated';
 export type HostingDeliveryChannel = 'glitch_store' | 'glitch_hosted_subdomain' | 'glitch_hosted_custom_domain' | 'external';
+export type HostingBillingProvider = 'direct' | 'microsoft_marketplace';
 
 export interface HostingAccount {
   id: string;
@@ -16,6 +17,8 @@ export interface HostingAccount {
   plan: HostingPlanKey;
   pending_plan?: HostingPlanKey | null;
   status: string;
+  billing_provider: HostingBillingProvider;
+  microsoft_marketplace_subscription_id?: string | null;
   included_bandwidth_bytes: number;
   used_bandwidth_bytes: number;
   remaining_bandwidth_bytes: number;
@@ -69,6 +72,7 @@ export interface HostingDatabase {
   port?: number | null;
   binding_name: string;
   billing_status: 'awaiting_payment' | 'active' | 'past_due' | 'unpaid' | 'cancelled' | 'expired' | 'failed';
+  billing_provider: HostingBillingProvider;
   billing_active: boolean;
   last_error?: string | null;
 }
@@ -116,6 +120,24 @@ export interface CreateHostingDatabaseRequest {
   high_availability_enabled?: boolean;
 }
 
+export interface HostingMarketplaceSubscription {
+  id: string;
+  marketplace_subscription_id: string;
+  subscription_name?: string | null;
+  offer_id: string;
+  plan_id: string;
+  plan_key: HostingPlanKey;
+  status: 'PendingFulfillmentStart' | 'Subscribed' | 'Suspended' | 'Unsubscribed';
+  quantity: number;
+  community_id?: string | null;
+  is_test: boolean;
+  is_free_trial: boolean;
+  auto_renew: boolean;
+  term_starts_at?: string | null;
+  term_ends_at?: string | null;
+  activated_at?: string | null;
+}
+
 /**
  * Typed SDK for game website hosting, Azure database add-ons, domains, usage,
  * deployment instructions, and hosted-play attribution.
@@ -143,6 +165,21 @@ class Hosting {
     return Requests.processRoute(HostingRoute.routes.confirmBillingCheckout, { checkout_session_id }, { title_id });
   }
 
+  /** Resolve the one-hour purchase token passed to Glitch by Microsoft Marketplace. */
+  public static resolveMarketplacePurchase<T>(token: string): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.resolveMarketplacePurchase, { token });
+  }
+
+  /** Link a resolved Microsoft Marketplace subscription to a billable Glitch business account. */
+  public static activateMarketplaceSubscription<T>(subscription_id: string, community_id: string): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.activateMarketplaceSubscription, { community_id }, { subscription_id });
+  }
+
+  /** Retrieve safe Microsoft Marketplace entitlement and lifecycle status. */
+  public static marketplaceSubscription<T>(subscription_id: string): AxiosPromise<Response<T>> {
+    return Requests.processRoute(HostingRoute.routes.marketplaceSubscription, undefined, { subscription_id });
+  }
+
   public static createSite<T>(title_id: string, data: CreateHostingSiteRequest): AxiosPromise<Response<T>> {
     return Requests.processRoute(HostingRoute.routes.createSite, data, { title_id });
   }

package/src/api/Titles.ts

@@ -8,6 +8,43 @@ export type GameReviewSentiment = 'positive' | 'mixed' | 'negative';
 export type GameReviewVoteType = 'helpful' | 'funny' | 'detailed' | 'not_helpful';
 export type GameReviewReportReason = 'abuse' | 'spam' | 'off_topic' | 'manipulation' | 'hate' | 'personal_info' | 'other';
 
+export type TitleTokenPurpose = 'install' | 'deploy' | 'hosting';
+export type TitleTokenAbility =
+    | 'deployments:*'
+    | 'deployments:create'
+    | 'deployments:read'
+    | 'deployments:activate'
+    | 'hosting:*'
+    | 'hosting:read'
+    | 'hosting:deploy'
+    | 'hosting:promote';
+
+export interface CreateTitleTokenRequest {
+    expires_at?: string;
+    name?: string;
+    purpose?: TitleTokenPurpose;
+    abilities?: TitleTokenAbility[];
+}
+
+export interface TitleToken {
+    id: string;
+    title_id: string;
+    name?: string | null;
+    purpose: TitleTokenPurpose;
+    token_prefix: string;
+    abilities: TitleTokenAbility[];
+    expires_at?: string | null;
+    revoked: boolean;
+    last_used_at?: string | null;
+    created_at?: string;
+}
+
+export interface CreatedTitleToken {
+    /** Full secret value. Returned once and never retrievable again. */
+    full_token: string;
+    token: TitleToken;
+}
+
 export interface GameReviewRatings {
     gameplay?: GameReviewSentiment;
     performance?: GameReviewSentiment;
@@ -305,9 +342,9 @@ class Titles {
    * Create a new API token for a title.
    * Returns { full_token: string, token: TitleToken }.
    */
-    public static createTitleToken<T>(
+    public static createTitleToken<T = CreatedTitleToken>(
         title_id: string,
-        data?: { expires_at?: string }
+        data?: CreateTitleTokenRequest
     ): AxiosPromise<Response<T>> {
         return Requests.processRoute(
             TitlesRoute.routes.createToken,
@@ -319,7 +356,7 @@ class Titles {
     /**
      * List all tokens for a title.
      */
-    public static listTitleTokens<T>(
+    public static listTitleTokens<T = TitleToken[]>(
         title_id: string
     ): AxiosPromise<Response<T>> {
         return Requests.processRoute(
@@ -332,7 +369,7 @@ class Titles {
     /**
      * Revoke a specific token by ID.
      */
-    public static revokeTitleToken<T>(
+    public static revokeTitleToken<T = TitleToken>(
         title_id: string,
         token_id: string
     ): AxiosPromise<Response<T>> {

package/src/routes/HostingRoute.ts

@@ -1,7 +1,7 @@
 import Route from './interface';
 import HTTP_METHODS from '../constants/HttpMethods';
 
-/** Route catalog for Azure-backed game website hosting. */
+/** Route catalog for game website hosting and its direct or Marketplace billing. */
 class HostingRoute {
   public static routes: { [key: string]: Route } = {
     catalog: { url: '/hosting/catalog', method: HTTP_METHODS.GET },
@@ -9,6 +9,9 @@ class HostingRoute {
     channelAnalytics: { url: '/titles/{title_id}/hosting/analytics/channels', method: HTTP_METHODS.GET },
     billingCheckout: { url: '/titles/{title_id}/hosting/billing/checkout', method: HTTP_METHODS.POST },
     confirmBillingCheckout: { url: '/titles/{title_id}/hosting/billing/confirm', method: HTTP_METHODS.POST },
+    resolveMarketplacePurchase: { url: '/hosting/marketplace/resolve', method: HTTP_METHODS.POST },
+    activateMarketplaceSubscription: { url: '/hosting/marketplace/subscriptions/{subscription_id}/activate', method: HTTP_METHODS.POST },
+    marketplaceSubscription: { url: '/hosting/marketplace/subscriptions/{subscription_id}', method: HTTP_METHODS.GET },
     createSite: { url: '/titles/{title_id}/hosting/sites', method: HTTP_METHODS.POST },
     updateSite: { url: '/titles/{title_id}/hosting/sites/{site_id}', method: HTTP_METHODS.PUT },
     uploadUrl: { url: '/titles/{title_id}/hosting/sites/{site_id}/upload-url', method: HTTP_METHODS.POST },