@gamecore-api/sdk 0.2.0 → 0.3.1

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;
@@ -73,6 +79,37 @@ export declare class GameCoreClient {
         }>;
         /** Get single product by ID */
         getProduct: (productId: number) => Promise<Product>;
+        /** Get bundle discount rules */
+        getBundleRules: () => Promise<{
+            id: number;
+            name: string;
+            scope: string;
+            minItems: number;
+            discountPercent: number;
+        }[]>;
+        /** Get active promo campaigns */
+        getPromos: () => Promise<{
+            id: number;
+            name: string;
+            type: string;
+            value: number;
+            scope: string;
+            bannerTitle?: string;
+            bannerDescription?: string;
+            bannerImageUrl?: string;
+            bannerColor?: string;
+            endsAt?: string;
+        }[]>;
+        /** Get all games with full metadata (categories, delivery types) */
+        getGamesFull: () => Promise<Game[]>;
+        /** Validate delivery data before checkout */
+        validateDelivery: (productId: number, deliveryData: Record<string, string>) => Promise<{
+            valid: boolean;
+            errors?: Array<{
+                field: string;
+                message: string;
+            }>;
+        }>;
     };
     cart: {
         /** Get cart items for authenticated user */
@@ -139,6 +176,10 @@ export declare class GameCoreClient {
         markRead: (id: number) => Promise<void>;
         /** Mark all notifications as read */
         markAllRead: () => Promise<void>;
+        /** Delete user account */
+        deleteAccount: () => Promise<void>;
+        /** Export user data (GDPR) */
+        exportData: () => Promise<Record<string, unknown>>;
     };
     favorites: {
         /** List user's favorite products */

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,14 +123,28 @@ 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}`),
     searchSuggestions: (query, limit = 5) => this.request("GET", `/catalog/search/suggestions?q=${encodeURIComponent(query)}&limit=${limit}`),
-    getProduct: (productId) => this.request("GET", `/catalog/products/${productId}`)
+    getProduct: (productId) => this.request("GET", `/catalog/products/${productId}`),
+    getBundleRules: () => this.request("GET", "/catalog/bundle-rules"),
+    getPromos: () => this.request("GET", "/catalog/promos"),
+    getGamesFull: () => this.request("GET", "/catalog/games/full"),
+    validateDelivery: (productId, deliveryData) => this.request("POST", "/catalog/validate-delivery", { productId, deliveryData })
   };
   cart = {
     get: () => this.request("GET", "/cart"),
@@ -163,7 +182,9 @@ class GameCoreClient {
     getNotifications: () => this.request("GET", "/profile/notifications"),
     getUnreadCount: () => this.request("GET", "/profile/notifications/unread-count"),
     markRead: (id) => this.request("POST", `/profile/notifications/${id}/read`),
-    markAllRead: () => this.request("POST", "/profile/notifications/read-all")
+    markAllRead: () => this.request("POST", "/profile/notifications/read-all"),
+    deleteAccount: () => this.request("POST", "/profile/delete-account"),
+    exportData: () => this.request("GET", "/profile/export")
   };
   favorites = {
     list: () => this.request("GET", "/favorites"),
@@ -180,7 +201,7 @@ class GameCoreClient {
     getStats: () => this.request("GET", "/referral/stats"),
     getLinks: () => this.request("GET", "/referral/links"),
     createLink: (data) => this.request("POST", "/referral/links", data),
-    updateLink: (id, data) => this.request("PATCH", `/referral/links/${id}`, data),
+    updateLink: (id, data) => this.request("PUT", `/referral/links/${id}`, data),
     deleteLink: (id) => this.request("DELETE", `/referral/links/${id}`),
     getLinkStats: (id) => this.request("GET", `/referral/links/${id}/stats`),
     getCommissions: () => this.request("GET", "/referral/commissions")
@@ -203,7 +224,7 @@ class GameCoreClient {
     },
     getRandom: (limit = 5) => this.request("GET", `/reviews/public/random?limit=${limit}`),
     getMine: () => this.request("GET", "/reviews/mine"),
-    getPending: () => this.request("GET", "/reviews/orders-without-reviews"),
+    getPending: () => this.request("GET", "/reviews/pending"),
     create: (orderId, rating, text) => this.request("POST", "/reviews", { orderId, rating, text })
   };
   topup = {
@@ -214,7 +235,7 @@ class GameCoreClient {
   giftCards = {
     purchase: (amountUsd) => this.request("POST", "/gift-cards/purchase", { amountUsd }),
     redeem: (code) => this.request("POST", "/gift-cards/redeem", { code }),
-    check: (code) => this.request("GET", `/gift-cards/check?code=${code}`),
+    check: (code) => this.request("GET", `/gift-cards/check/${code}`),
     getMine: () => this.request("GET", "/profile/gift-cards")
   };
   announcements = {

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.1",
 	"description": "TypeScript SDK for GameCore API — browser-safe, zero dependencies",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",