@gamecore-api/sdk 0.24.0 → 0.25.0

package/dist/client.d.ts

@@ -1,4 +1,6 @@
 import type { Announcement, AnnouncementBar, CartItem, CashbackPreview, CatalogSection, Category, CategoryInfo, CheckoutRequest, CheckoutResponse, CheckoutStatus, CmsArticleListResponse, CmsArticleLocale, CmsArticleResponse, CmsArticleType, CompleteWithBalanceResult, Conversation, ConversationDetail, CouponResult, DailyBonusClaimResult, DailyBonusStatus, DeliveryHelpResponse, ExchangeRates, FaqListResponse, Favorite, Game, GameDetail, GameRequestList, GiftCard, LegalDocument, LevelStatus, Notification, Order, PagedGamesResponse, PlatformInfo, PaginatedResponse, PaymentInfo, PaymentMethod, Product, ProductFilters, ProfileSummary, PublicCoupon, Quest, QuestCompleteResult, ReferralCommission, ReferralLink, ReferralPerformance, ReferralStats, ReferralTransferResult, Review, ReviewCreateResult, ReviewPolicy, ReviewProof, ReviewStats, ScreenshotsResponse, SearchResult, SiteConfig, SiteStats, SiteUIConfig, SystemRequirementsResponse, TelegramAuthResponse, TelegramBotLoginOptions, TelegramInitResponse, TelegramWidgetRenderOptions, TelegramWidgetUser, TopupMethod, TopupResponse, TopupStatus, Transaction, User, UserBalance, WebPushSubscriptionInput } from "./types";
+/** Supported storefront locales — extend as new languages land. */
+export type SdkLocale = "ru" | "en";
 export interface GameCoreOptions {
     /** Site API key (gc_live_xxx or gc_test_xxx) */
     apiKey: string;
@@ -6,12 +8,29 @@ export interface GameCoreOptions {
     baseUrl: string;
     /** Called on 401 — use to redirect to login */
     onAuthError?: () => void;
+    /**
+     * Default locale for catalog/CMS responses. When set, every request
+     * sends an `Accept-Language` header so the API returns localized
+     * name/description fields without each call passing `locale=` itself.
+     * Per-call `locale` arguments still take precedence over the default.
+     * Omit to keep the legacy behaviour (server falls back to "ru").
+     */
+    locale?: SdkLocale;
 }
 export declare class GameCoreClient {
     private apiKey;
     private baseUrl;
     private onAuthError?;
+    private defaultLocale?;
     constructor(options: GameCoreOptions);
+    /**
+     * Switch the client's default locale at runtime — useful for a
+     * storefront language switcher that should not have to re-instantiate
+     * the client.
+     */
+    setLocale(locale: SdkLocale | undefined): void;
+    /** Current default locale (undefined when none set). */
+    getLocale(): SdkLocale | undefined;
     private request;
     site: {
         /** Get site configuration (modules, auth methods, payments, currency) */

package/dist/index.js

@@ -36,16 +36,27 @@ class GameCoreClient {
   apiKey;
   baseUrl;
   onAuthError;
+  defaultLocale;
   constructor(options) {
     this.apiKey = options.apiKey;
     this.baseUrl = options.baseUrl.replace(/\/$/, "");
     this.onAuthError = options.onAuthError;
+    this.defaultLocale = options.locale;
+  }
+  setLocale(locale) {
+    this.defaultLocale = locale;
+  }
+  getLocale() {
+    return this.defaultLocale;
   }
   async request(method, path, body, options) {
     const headers = {
       "X-Api-Key": this.apiKey,
       "Content-Type": "application/json"
     };
+    if (this.defaultLocale) {
+      headers["Accept-Language"] = this.defaultLocale;
+    }
     if (options?.idempotencyKey) {
       headers["X-Idempotency-Key"] = options.idempotencyKey;
     }

package/package.json

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