@gamecore-api/sdk 0.2.0 → 0.3.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, 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, 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 announcement bar settings (text, link, enabled) */
+        getAnnouncementBar: () => Promise<AnnouncementBar>;
     };
     auth: {
         /** Start Telegram auth flow → returns bot link for user to click */
@@ -49,17 +51,21 @@ export declare class GameCoreClient {
         unlinkProvider: (provider: string) => Promise<void>;
     };
     catalog: {
-        /** Get all games with product counts */
+        /** Get all games with product counts. Use include:"meta" for categories/deliveryTypes/platforms/regions. */
         getGames: (params?: {
             locale?: string;
             type?: string;
+            deliveryType?: string;
+            include?: string;
         }) => Promise<Game[]>;
         /** Get homepage ranked games */
         getHomepageGames: () => Promise<Game[]>;
         /** Get single game with categories */
         getGame: (slug: string, locale?: string) => Promise<GameDetail>;
-        /** Get products for a game */
-        getProducts: (gameSlug: string, categorySlug?: string) => Promise<Product[]>;
+        /** Get categories for a game with product counts and delivery metadata */
+        getCategories: (gameSlug: string) => Promise<Category[]>;
+        /** Get products for a game with optional filters */
+        getProducts: (gameSlug: string, filters?: ProductFilters) => Promise<Product[]>;
         /** Get products grouped by category */
         getProductsGrouped: (gameSlug: string) => Promise<{
             category: Category;

package/dist/index.js

@@ -75,7 +75,8 @@ class GameCoreClient {
   site = {
     getConfig: () => this.request("GET", "/site/config"),
     getRates: () => this.request("GET", "/rates"),
-    getLegal: (type, locale) => this.request("GET", `/legal/${type}${locale ? `?locale=${locale}` : ""}`)
+    getLegal: (type, locale) => this.request("GET", `/legal/${type}${locale ? `?locale=${locale}` : ""}`),
+    getAnnouncementBar: () => this.request("GET", "/site/announcement-bar")
   };
   auth = {
     initTelegram: () => this.request("POST", "/auth/telegram/init"),
@@ -110,6 +111,10 @@ class GameCoreClient {
         qs.set("locale", params.locale);
       if (params?.type)
         qs.set("type", params.type);
+      if (params?.deliveryType)
+        qs.set("deliveryType", params.deliveryType);
+      if (params?.include)
+        qs.set("include", params.include);
       const q = qs.toString();
       return this.request("GET", `/catalog/games${q ? `?${q}` : ""}`);
     },
@@ -118,9 +123,19 @@ class GameCoreClient {
       const qs = locale ? `?locale=${locale}` : "";
       return this.request("GET", `/catalog/games/${slug}${qs}`);
     },
-    getProducts: (gameSlug, categorySlug) => {
-      const qs = categorySlug ? `?category=${categorySlug}` : "";
-      return this.request("GET", `/catalog/games/${gameSlug}/products${qs}`);
+    getCategories: (gameSlug) => this.request("GET", `/catalog/games/${gameSlug}/categories`),
+    getProducts: (gameSlug, filters) => {
+      const qs = new URLSearchParams;
+      if (filters?.deliveryType)
+        qs.set("deliveryType", filters.deliveryType);
+      if (filters?.region)
+        qs.set("region", filters.region);
+      if (filters?.platform)
+        qs.set("platform", filters.platform);
+      if (filters?.categoryId)
+        qs.set("categoryId", String(filters.categoryId));
+      const q = qs.toString();
+      return this.request("GET", `/catalog/games/${gameSlug}/products${q ? `?${q}` : ""}`);
     },
     getProductsGrouped: (gameSlug) => this.request("GET", `/catalog/games/${gameSlug}/products/grouped`),
     search: (query, limit = 20) => this.request("GET", `/catalog/search?q=${encodeURIComponent(query)}&limit=${limit}`),

package/dist/types.d.ts

@@ -56,6 +56,10 @@ export interface Game {
     productCount: number;
     minPrice?: number | null;
     type?: string;
+    deliveryTypes?: string[];
+    categories?: Category[];
+    platforms?: string[];
+    regions?: string[];
 }
 export interface GameDetail {
     id: number;
@@ -71,6 +75,21 @@ export interface Category {
     slug: string;
     name: string;
     productCount: number;
+    deliveryTypes?: string[];
+    platforms?: string[];
+}
+export interface FulfillmentMeta {
+    needsPlayerId: boolean;
+    needsLogin: boolean;
+    needsEmail: boolean;
+    isGiftCode: boolean;
+    isAutoDelivery: boolean;
+    inputFields: Array<{
+        id: string;
+        label: string;
+        type: string;
+        required: boolean;
+    }>;
 }
 export interface Product {
     id: number;
@@ -84,9 +103,19 @@ export interface Product {
     gameIcon: string | null;
     categoryId: number;
     categoryName: string;
+    categorySlug?: string;
     productType: string;
+    deliveryType?: string;
+    fulfillment?: FulfillmentMeta;
     deliveryDataSchema: unknown[];
     region?: string;
+    platform?: string;
+}
+export interface ProductFilters {
+    deliveryType?: string;
+    region?: string;
+    platform?: string;
+    categoryId?: number;
 }
 export interface SearchResult {
     games: Game[];
@@ -313,6 +342,11 @@ export interface Announcement {
     imageUrl?: string | null;
     createdAt: string;
 }
+export interface AnnouncementBar {
+    enabled: boolean;
+    text: string;
+    link: string | null;
+}
 export interface OrderUpdateEvent {
     orderId: number;
     orderCode: string;

package/package.json

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