@gamecore-api/sdk 0.3.1 → 0.5.0

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { TelegramInitResponse, User, SiteConfig, ExchangeRates, LegalDocument, Game, GameDetail, Product, SearchResult, Category, CartItem, CheckoutRequest, CheckoutResponse, Order, UserBalance, LevelStatus, Transaction, Notification, Favorite, Review, ReviewStats, CouponResult, ReferralStats, ReferralLink, ReferralCommission, TopupMethod, TopupResponse, TopupStatus, GiftCard, Announcement, AnnouncementBar, ProductFilters, PaginatedResponse } from "./types";
+import type { TelegramInitResponse, User, SiteConfig, ExchangeRates, LegalDocument, Game, GameDetail, Product, SearchResult, Category, CartItem, CheckoutRequest, CheckoutResponse, Order, UserBalance, LevelStatus, Transaction, Notification, Favorite, Review, ReviewStats, CouponResult, ReferralStats, ReferralLink, ReferralCommission, TopupMethod, TopupResponse, TopupStatus, GiftCard, Announcement, AnnouncementBar, SiteStats, ProductFilters, PaginatedResponse } from "./types";
 export interface GameCoreOptions {
     /** Site API key (gc_live_xxx or gc_test_xxx) */
     apiKey: string;
@@ -20,6 +20,8 @@ export declare class GameCoreClient {
         getRates: () => Promise<ExchangeRates>;
         /** Get legal document by type (privacy, terms, etc.) */
         getLegal: (type: string, locale?: string) => Promise<LegalDocument>;
+        /** Get site statistics for trust signals (cached 5 min on server) */
+        getStats: () => Promise<SiteStats>;
         /** Get announcement bar settings (text, link, enabled) */
         getAnnouncementBar: () => Promise<AnnouncementBar>;
     };
@@ -51,12 +53,13 @@ export declare class GameCoreClient {
         unlinkProvider: (provider: string) => Promise<void>;
     };
     catalog: {
-        /** Get all games with product counts. Use include:"meta" for categories/deliveryTypes/platforms/regions. */
+        /** Get all games. Use inStockOnly:true for only games with products. include:"meta" for categories/deliveryTypes. */
         getGames: (params?: {
             locale?: string;
             type?: string;
             deliveryType?: string;
             include?: string;
+            inStockOnly?: boolean;
         }) => Promise<Game[]>;
         /** Get homepage ranked games */
         getHomepageGames: () => Promise<Game[]>;

package/dist/index.js

@@ -76,6 +76,7 @@ class GameCoreClient {
     getConfig: () => this.request("GET", "/site/config"),
     getRates: () => this.request("GET", "/rates"),
     getLegal: (type, locale) => this.request("GET", `/legal/${type}${locale ? `?locale=${locale}` : ""}`),
+    getStats: () => this.request("GET", "/site/stats"),
     getAnnouncementBar: () => this.request("GET", "/site/announcement-bar")
   };
   auth = {
@@ -115,6 +116,8 @@ class GameCoreClient {
         qs.set("deliveryType", params.deliveryType);
       if (params?.include)
         qs.set("include", params.include);
+      if (params?.inStockOnly)
+        qs.set("inStockOnly", "true");
       const q = qs.toString();
       return this.request("GET", `/catalog/games${q ? `?${q}` : ""}`);
     },

package/dist/types.d.ts

@@ -33,6 +33,10 @@ export interface SiteConfig {
     rateMode: "auto" | "manual";
     currentRate: number;
     supportedLocales?: string[];
+    maintenance?: {
+        enabled: boolean;
+        message: string | null;
+    };
 }
 export interface ExchangeRates {
     usdToRub: number;
@@ -54,6 +58,9 @@ export interface Game {
     icon: string | null;
     localIcon?: string | null;
     productCount: number;
+    inStock: boolean;
+    soldCount?: number;
+    tags?: string[];
     minPrice?: number | null;
     type?: string;
     deliveryTypes?: string[];
@@ -68,7 +75,43 @@ export interface GameDetail {
     icon: string | null;
     localIcon?: string | null;
     description: string | null;
+    inStock?: boolean;
+    productCount?: number;
     categories: Category[];
+    seo?: SeoContent | null;
+}
+/**
+ * Per-site SEO content for a game page.
+ * Stored in GameCore admin per site and returned with the game detail response.
+ * All fields are nullable — filled in by content managers via Claude Code workflow.
+ */
+export interface SeoContent {
+    title: string | null;
+    h1: string | null;
+    metaDescription: string | null;
+    metaKeywords: string | null;
+    ogTitle: string | null;
+    ogDescription: string | null;
+    ogImage: string | null;
+    canonicalUrl: string | null;
+    intro: string | null;
+    content: string | null;
+    /** Structured content blocks for H2/H3 sections */
+    contentSections: Array<{
+        heading: string;
+        level: number;
+        body: string;
+    }>;
+    faq: Array<{
+        question: string;
+        answer: string;
+    }>;
+    keywords: string[];
+    /** JSON-LD schema.org object (Product, FAQPage, BreadcrumbList) */
+    schemaJsonLd: Record<string, unknown> | null;
+    footerText: string | null;
+    /** Key cluster identifying the store's SEO theme (e.g. "рублями", "kz-tenge") */
+    cluster: string | null;
 }
 export interface Category {
     id: number;
@@ -94,6 +137,8 @@ export interface FulfillmentMeta {
 export interface Product {
     id: number;
     name: string;
+    description?: string | null;
+    estimatedDelivery?: string;
     icon: string | null;
     price: number | null;
     priceWithoutDiscount?: number;
@@ -342,6 +387,12 @@ export interface Announcement {
     imageUrl?: string | null;
     createdAt: string;
 }
+export interface SiteStats {
+    totalCustomers: number;
+    totalOrders: number;
+    totalGames: number;
+    avgDeliveryMinutes: number;
+}
 export interface AnnouncementBar {
     enabled: boolean;
     text: string;

package/package.json

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