@gamecore-api/sdk 0.18.0 → 0.20.0

package/dist/client.d.ts

@@ -117,6 +117,25 @@ export declare class GameCoreClient {
         initTelegram: () => Promise<TelegramInitResponse>;
         /** Poll Telegram auth status until authenticated or expired */
         pollTelegramStatus: (token: string, intervalMs?: number) => Promise<User>;
+        /**
+         * Read the storefront's Telegram OpenID Connect config. Returns
+         * { enabled: false, clientId: null } when the tenant hasn't set
+         * up Web Login in BotFather (the SPA should fall back to the
+         * deep-link flow). When enabled, hand `clientId` to telegram-
+         * login.js to render the native consent card.
+         */
+        getTelegramOidcConfig: () => Promise<{
+            enabled: boolean;
+            clientId: string | null;
+        }>;
+        /**
+         * Submit the RS256 id_token returned by telegram-login.js for
+         * server-side JWKS verification. On success the backend sets an
+         * auth cookie and returns the authenticated user, exactly like
+         * the Mini App / Widget verifiers. Optional `ref` threads a
+         * referral code through user creation on first login.
+         */
+        telegramOidc: (idToken: string, ref?: string) => Promise<TelegramAuthResponse>;
         /**
          * Verify Telegram Mini App initData and issue a session cookie.
          * Call this when your storefront is opened inside Telegram via the

package/dist/index.js

@@ -108,6 +108,8 @@ class GameCoreClient {
         }
       }, intervalMs);
     }),
+    getTelegramOidcConfig: () => this.request("GET", "/auth/telegram/oidc/config"),
+    telegramOidc: (idToken, ref) => this.request("POST", "/auth/telegram/oidc/callback", { idToken, ref }, { rawResponse: true }),
     verifyMiniApp: (initData, ref) => this.request("POST", "/auth/telegram/miniapp", { initData, ref }, { rawResponse: true }),
     verifyTelegramWidget: (data, ref) => this.request("POST", "/auth/telegram/widget", { ...data, ref }, { rawResponse: true }),
     renderTelegramWidget: async (opts) => {

package/dist/types.d.ts

@@ -191,7 +191,16 @@ export interface Game {
     inStock: boolean;
     soldCount?: number;
     tags?: string[];
-    availabilityStatus?: "available" | "coming_soon" | "maintenance" | "discontinued";
+    /**
+     * Availability lifecycle. `out_of_stock` is **derived** by the
+     * backend when a game has 0 visible products under the requesting
+     * site's filters (gateway allow-list, per-site overrides, allowed
+     * regions). Editorial states (`coming_soon`, `maintenance`,
+     * `discontinued`) are admin overrides on canonical_games and
+     * always win. Storefronts should branch on this field to render
+     * the right banner / Schema.org `availability` value.
+     */
+    availabilityStatus?: "available" | "out_of_stock" | "coming_soon" | "maintenance" | "discontinued";
     availabilityMessage?: string | null;
     minPrice?: number | null;
     type?: string;
@@ -245,7 +254,16 @@ export interface GameDetail {
     /** Steam app id — null for non-Steam titles and mobile games. */
     steamAppid?: number | null;
     /** Availability lifecycle. Shares the union from {@link Game}. */
-    availabilityStatus?: "available" | "coming_soon" | "maintenance" | "discontinued";
+    /**
+     * Availability lifecycle. `out_of_stock` is **derived** by the
+     * backend when a game has 0 visible products under the requesting
+     * site's filters (gateway allow-list, per-site overrides, allowed
+     * regions). Editorial states (`coming_soon`, `maintenance`,
+     * `discontinued`) are admin overrides on canonical_games and
+     * always win. Storefronts should branch on this field to render
+     * the right banner / Schema.org `availability` value.
+     */
+    availabilityStatus?: "available" | "out_of_stock" | "coming_soon" | "maintenance" | "discontinued";
     /** Human-readable message for non-available games. */
     availabilityMessage?: string | null;
     inStock?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@gamecore-api/sdk",
-	"version": "0.18.0",
+	"version": "0.20.0",
 	"description": "TypeScript SDK for GameCore API — browser-safe, zero dependencies",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",