@gamecore-api/sdk 0.16.0 → 0.17.1

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-import type { Announcement, AnnouncementBar, CartItem, CatalogSection, Category, CheckoutRequest, CheckoutResponse, CompleteWithBalanceResult, Conversation, ConversationDetail, CouponResult, ExchangeRates, Favorite, Game, GameDetail, GiftCard, LegalDocument, LevelStatus, Notification, Order, PagedGamesResponse, PaginatedResponse, PaymentInfo, PaymentMethod, Product, ProductFilters, ReferralCommission, ReferralLink, ReferralPerformance, ReferralStats, Review, ReviewCreateResult, ReviewStats, SearchResult, SiteConfig, SiteStats, SiteUIConfig, TelegramAuthResponse, TelegramBotLoginOptions, TelegramInitResponse, TelegramWidgetRenderOptions, TelegramWidgetUser, TopupMethod, TopupResponse, TopupStatus, Transaction, User, UserBalance, WebPushSubscriptionInput } from "./types";
+import type { Announcement, AnnouncementBar, CartItem, CatalogSection, Category, CategoryInfo, CheckoutRequest, CheckoutResponse, CompleteWithBalanceResult, Conversation, ConversationDetail, CouponResult, ExchangeRates, Favorite, Game, GameDetail, GiftCard, LegalDocument, LevelStatus, Notification, Order, PagedGamesResponse, PlatformInfo, PaginatedResponse, PaymentInfo, PaymentMethod, Product, ProductFilters, ReferralCommission, ReferralLink, ReferralPerformance, ReferralStats, Review, ReviewCreateResult, ReviewStats, SearchResult, SiteConfig, SiteStats, SiteUIConfig, TelegramAuthResponse, TelegramBotLoginOptions, TelegramInitResponse, TelegramWidgetRenderOptions, TelegramWidgetUser, TopupMethod, TopupResponse, TopupStatus, Transaction, User, UserBalance, WebPushSubscriptionInput } from "./types";
 export interface GameCoreOptions {
     /** Site API key (gc_live_xxx or gc_test_xxx) */
     apiKey: string;
@@ -279,13 +279,49 @@ export declare class GameCoreClient {
             page?: number;
             limit?: number;
             locale?: string;
+            /**
+             * Legacy coarse-grained filter: `"topup"` → mobile donate
+             * (keyhub + vendoria), `"cdkey"` → Steam keys (keyhub).
+             * Still accepted for backward-compat with early storefront
+             * builds.
+             *
+             * @deprecated Prefer `platform: "mobile_game"` instead of
+             *   `type: "topup"` and `platform: "steam"` instead of
+             *   `type: "cdkey"`. Canonical platforms give you facet
+             *   counts via `getPlatforms()` and survive supplier
+             *   reshuffles.
+             */
             type?: string;
             deliveryType?: string;
             include?: string;
             inStockOnly?: boolean;
             sort?: "popular" | "name" | "new" | "soldCount";
             q?: string;
+            /**
+             * Filter by canonical platform slug — "steam", "xbox", "psn",
+             * "mobile_game", etc. Use slugs from `getPlatforms()`.
+             */
+            platform?: string;
+            /**
+             * Filter by canonical category slug — "currency",
+             * "battle_pass", "bundle", etc. Use slugs from `getCategories()`.
+             */
+            category?: string;
         }) => Promise<PagedGamesResponse>;
+        /**
+         * List distribution platforms present in the site catalog with
+         * per-platform game counts (post site-overrides). Drives
+         * storefront filter chips. Introduced in task 118 Phase 3.
+         */
+        getPlatforms: () => Promise<PlatformInfo[]>;
+        /**
+         * List canonical category slugs present in the site catalog
+         * with per-slug game counts. Use the returned `slug` as the
+         * `category` argument to `getGames()`. Not to be confused with
+         * `getCategories(gameSlug)` which returns categories of a
+         * single game. Introduced in task 119 Phase 3.
+         */
+        getCatalogCategories: () => Promise<CategoryInfo[]>;
         /** Get homepage ranked games */
         getHomepageGames: () => Promise<Game[]>;
         /** Get single game with categories */

package/dist/index.js

@@ -239,9 +239,15 @@ class GameCoreClient {
         qs.set("sort", params.sort);
       if (params?.q)
         qs.set("q", params.q);
+      if (params?.platform)
+        qs.set("platform", params.platform);
+      if (params?.category)
+        qs.set("category", params.category);
       const q = qs.toString();
       return this.request("GET", `/catalog/games${q ? `?${q}` : ""}`);
     },
+    getPlatforms: () => this.request("GET", "/catalog/platforms"),
+    getCatalogCategories: () => this.request("GET", "/catalog/categories"),
     getHomepageGames: () => this.request("GET", "/catalog/homepage-games"),
     getGame: (slug, locale) => {
       const qs = locale ? `?locale=${locale}` : "";

package/dist/types.d.ts

@@ -197,6 +197,17 @@ export interface Game {
     type?: string;
     deliveryTypes?: string[];
     categories?: Category[];
+    /**
+     * Distribution platforms (`steam`, `mobile_game`, `xbox`, `playstation`,
+     * `nintendo`, `epic`). Same slugs that `?platform=` filter accepts and
+     * that `getPlatforms()` enumerates — single source of truth.
+     *
+     * Always present in list endpoints (`getGames`, `getHomepageGames`,
+     * `getGamesFull`, `getRecentGames`, `getRecommendations`, `search`)
+     * and `getGame` since gamecore-api 2026-04-30 — empty array if no
+     * platform metadata. Type stays optional for backward-compat with
+     * pre-0.17 backends. Treat as `string[]` in modern code.
+     */
     platforms?: string[];
     regions?: string[];
 }
@@ -297,6 +308,40 @@ export interface Category {
     productCount: number;
     deliveryTypes?: string[];
     platforms?: string[];
+    /**
+     * Canonical category slug (e.g. "currency", "battle_pass"). Present
+     * on responses from servers running task 119 Phase 2+. Stable across
+     * suppliers — Nexus "Алмазы" and Vendoria "Diamonds" both carry
+     * canonicalSlug="currency". Use this (not `name`) for storefront
+     * dedup and routing.
+     */
+    canonicalSlug?: string | null;
+}
+/**
+ * Distribution platform descriptor from GET /catalog/platforms.
+ * Use `slug` as the key for ?platform= filter and as a stable identifier
+ * across locales. `label` is storefront-ready display text.
+ * Introduced by task 118 Phase 3.
+ */
+export interface PlatformInfo {
+    slug: string;
+    label: string;
+    group: string;
+    gameCount: number;
+}
+/**
+ * Canonical category descriptor from GET /catalog/categories. Use
+ * `slug` as the key for ?category= filter. `labelRu`/`labelEn` are
+ * storefront-ready display text in each supported UI locale; pick
+ * whichever matches the current site locale. Introduced by task 119
+ * Phase 3.
+ */
+export interface CategoryInfo {
+    slug: string;
+    labelRu: string;
+    labelEn: string;
+    group: string;
+    gameCount: number;
 }
 export interface FulfillmentMeta {
     needsPlayerId: boolean;

package/package.json

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