@gamecore-api/sdk 0.13.0 → 0.15.0

package/README.md

@@ -1,17 +1,29 @@
-# @gamecore/sdk
+# @gamecore-api/sdk
 
 TypeScript SDK for GameCore API — zero external dependencies, browser-safe.
 
 ## Install
 
 ```bash
-npm install @gamecore/sdk
+npm install @gamecore-api/sdk
 ```
 
+## What's new in 0.14.0
+
+- **BREAKING** `giftCards.purchase()` signature changed: first arg is now `amountRub` (was `amountUsd`). GiftCard payload fields renamed — `amount_usd` → `amount_rub`, added `currency`, `remainingBalance`, `expiresAt`. `denomination` is now optional (legacy)
+- `cart.merge(items)` — guest → authed cart handoff; new response fields `quantity`, `addedAt`, `gameIcon`
+- `auth.linkEmail(email, password)` — add email identity to an existing Telegram/VK account
+- `profile.getConversations / getConversationMessages / submitCode / submitScreenshot` — in-profile support chat
+- `profile.getPushPublicKey / subscribePush / unsubscribePush` — web push subscriptions
+- `referrals.getPopularProducts(limit)` + `referrals.getPerformance({ from, to })` — affiliate analytics
+- `site.requestGame({ gameName, contact })` — public "request a game" lead capture
+- `site.getSitemapData()` — data source for `sitemap.xml`
+- `checkout.completeWithBalance` now returns `{ newBalance }`
+
 ## Quick Start
 
 ```typescript
-import { GameCoreClient } from "@gamecore/sdk";
+import { GameCoreClient } from "@gamecore-api/sdk";
 
 const gc = new GameCoreClient({
   apiKey: "gc_live_YOUR_KEY",
@@ -50,6 +62,23 @@ console.log("Logged in:", user.firstName);
 const { user } = await gc.auth.verifyVk(vkAccessToken);
 ```
 
+### Email + Password
+
+```typescript
+await gc.auth.register(email, password, firstName, ref);
+await gc.auth.login(email, password);
+await gc.auth.changePassword(currentPassword, newPassword);
+```
+
+### Link additional identity
+
+```typescript
+// Add email to an existing Telegram/VK account
+await gc.auth.linkEmail(email, password);
+// Or link a VK access token
+await gc.auth.linkVk(vkAccessToken);
+```
+
 ### Session
 
 ```typescript
@@ -88,10 +117,14 @@ const { suggestions } = await gc.catalog.searchSuggestions("rob");
 ```typescript
 // Cart
 const items = await gc.cart.get();
-await gc.cart.add({ productId: 10, gameId: "roblox", gameName: "Roblox", productName: "800 Robux", price: 799, deliveryData: { username: "player123" } });
+// items: [{ id, productId, quantity, addedAt, gameIcon, ... }]
+await gc.cart.add({ productId: 10, gameId: "roblox", gameName: "Roblox", productName: "800 Robux", price: 799, deliveryData: { username: "player123" }, quantity: 2 });
 await gc.cart.remove(itemId);
 await gc.cart.clear();
 
+// Merge guest cart into authed session (on login)
+await gc.cart.merge(guestItems);
+
 // Checkout (auto-generates idempotency key)
 const checkout = await gc.checkout.create({
   items: [{ productId: 10, deliveryData: { username: "player123" } }],
@@ -144,6 +177,17 @@ const notifications = await gc.profile.getNotifications();
 const { count } = await gc.profile.getUnreadCount();
 await gc.profile.markRead(notificationId);
 await gc.profile.markAllRead();
+
+// Support conversations (in-profile chat)
+const conversations = await gc.profile.getConversations();
+const messages = await gc.profile.getConversationMessages(conversationId);
+await gc.profile.submitCode(conversationId, requestId, "ABC-123");
+await gc.profile.submitScreenshot(conversationId, requestId, file);
+
+// Web push subscriptions
+const { publicKey } = await gc.profile.getPushPublicKey();
+await gc.profile.subscribePush({ endpoint, keys: { p256dh, auth } });
+await gc.profile.unsubscribePush(endpoint);
 ```
 
 ## Favorites
@@ -185,8 +229,10 @@ await gc.coupons.remove();
 const active = await gc.coupons.getActive();
 
 // Gift cards
-const card = await gc.giftCards.purchase(5); // amountUsd
+const card = await gc.giftCards.purchase(500, "Happy birthday!"); // amountRub + optional message
 await gc.giftCards.redeem("GC-XXXX-XXXX-XXXX");
+const mine = await gc.giftCards.getMine();
+// { code, amount_rub, currency, remainingBalance, expiresAt, ... }
 ```
 
 ## Referrals
@@ -198,6 +244,15 @@ const link = await gc.referrals.createLink({ label: "YouTube", slug: "my-channel
 await gc.referrals.updateLink(link.id, { label: "Updated" });
 const linkStats = await gc.referrals.getLinkStats(link.id);
 const commissions = await gc.referrals.getCommissions();
+
+// Popular products referred by this user
+const popular = await gc.referrals.getPopularProducts(10);
+
+// Performance over a date range
+const perf = await gc.referrals.getPerformance({
+  from: "2026-04-01",
+  to: "2026-04-30",
+});
 ```
 
 ## Balance Top-up
@@ -236,7 +291,7 @@ const schema = await gc.seo.getSchema("product", 42);
 
 ```typescript
 // Import from server entrypoint (uses node:crypto)
-import { verifyWebhookSignature, parseWebhookPayload } from "@gamecore/sdk/server";
+import { verifyWebhookSignature, parseWebhookPayload } from "@gamecore-api/sdk/server";
 
 const isValid = verifyWebhookSignature(
   requestBody,
@@ -253,7 +308,7 @@ if (isValid) {
 ## Utilities
 
 ```typescript
-import { convertPrice, formatPrice, generateIdempotencyKey } from "@gamecore/sdk";
+import { convertPrice, formatPrice, generateIdempotencyKey } from "@gamecore-api/sdk";
 
 const rub = convertPrice(1.99, 92.5);       // 184.08
 const formatted = formatPrice(rub, "RUB");   // "184 ₽"
@@ -266,7 +321,7 @@ const key = generateIdempotencyKey();         // UUID v4
 
 ```typescript
 // app/catalog/page.tsx
-import { GameCoreClient } from "@gamecore/sdk";
+import { GameCoreClient } from "@gamecore-api/sdk";
 
 const gc = new GameCoreClient({
   apiKey: process.env.GAMECORE_API_KEY!,
@@ -297,7 +352,7 @@ export function CartWidget() {
 
 ```typescript
 // app/api/webhooks/gamecore/route.ts
-import { verifyWebhookSignature, parseWebhookPayload } from "@gamecore/sdk/server";
+import { verifyWebhookSignature, parseWebhookPayload } from "@gamecore-api/sdk/server";
 
 export async function POST(req: Request) {
   const body = await req.text();
@@ -317,16 +372,16 @@ export async function POST(req: Request) {
 
 | Namespace | Methods |
 |-----------|---------|
-| `gc.site` | getConfig, getRates, getLegal |
-| `gc.auth` | initTelegram, pollTelegramStatus, verifyVk, getMe, logout, getIdentities, linkVk, unlinkProvider |
-| `gc.catalog` | getGames, getHomepageGames, getGame, getProducts, getProductsGrouped, search, searchSuggestions, getProduct |
-| `gc.cart` | get, add, sync, remove, clear |
+| `gc.site` | getConfig, getRates, getLegal, getStats, getSocialProof, getThemeConfig, getTranslations, getUIConfig, getCookieConsent, getCatalogSections, getBanners, getAnnouncementBar, getSitemapData, requestGame |
+| `gc.auth` | initTelegram, pollTelegramStatus, verifyMiniApp, verifyTelegramWidget, getVkAuthUrl, vkCallback, verifyVk, register, login, changePassword, getMe, logout, getIdentities, linkVk, linkEmail, unlinkProvider, mergePreview, mergeConfirm |
+| `gc.catalog` | getGames, getHomepageGames, getGame, getRecommendations, getCategories, getProducts, getProductsGrouped, search, searchSuggestions, getProduct |
+| `gc.cart` | get, add, merge, sync, remove, clear |
 | `gc.checkout` | create, completeWithBalance, getPaymentMethods |
 | `gc.orders` | list, get, getByPayment, cancel |
-| `gc.profile` | getBalance, getLevelStatus, getTransactions, getOrders, getNotifications, getUnreadCount, markRead, markAllRead |
+| `gc.profile` | getBalance, getLevelStatus, getTransactions, getOrders, getNotifications, getUnreadCount, markRead, markAllRead, getConversations, getConversationMessages, submitCode, submitScreenshot, getPushPublicKey, subscribePush, unsubscribePush |
 | `gc.favorites` | list, add, remove |
 | `gc.coupons` | apply, remove, validate, getActive |
-| `gc.referrals` | getStats, getLinks, createLink, updateLink, deleteLink, getLinkStats, getCommissions |
+| `gc.referrals` | getStats, getLinks, createLink, updateLink, deleteLink, getLinkStats, getCommissions, getPopularProducts, getPerformance |
 | `gc.reviews` | listPublic, getStats, getRandom, getMine, getPending, create |
 | `gc.topup` | getPaymentMethods, create, getStatus |
 | `gc.giftCards` | purchase, redeem, check, getMine |
@@ -339,5 +394,5 @@ export async function POST(req: Request) {
 
 | Import | Environment | Includes |
 |--------|-------------|----------|
-| `@gamecore/sdk` | Browser + Node | Client, types, utilities |
-| `@gamecore/sdk/server` | Node only | Webhook verification (uses node:crypto) |
+| `@gamecore-api/sdk` | Browser + Node | Client, types, utilities |
+| `@gamecore-api/sdk/server` | Node only | Webhook verification (uses node:crypto) |

package/dist/types.d.ts

@@ -130,8 +130,28 @@ export interface GameDetail {
     /** Gallery of product screenshots (resized to 800x600). */
     images?: string[];
     description: string | null;
+    /**
+     * Short teaser (<= 200 chars) suitable for list cards and meta
+     * descriptions. Distinct from `description` which may be multi-paragraph.
+     */
+    shortDescription?: string | null;
     /** Editorial badges like "hit", "new", "popular", "sale". */
     tags?: string[];
+    /** Game developers (studio names). Empty when supplier doesn't send it. */
+    developers?: string[];
+    /** Game publishers. Empty when supplier doesn't send it. */
+    publishers?: string[];
+    /** Genre labels ("Strategy", "RPG", ...). Empty for mobile-donation games. */
+    genres?: string[];
+    /**
+     * Upstream release date as the supplier sends it — may be an ISO date
+     * "YYYY-MM-DD", a localized natural-language string ("6 июн. 2016 г."),
+     * or null when unknown. Storefronts should render verbatim; do not
+     * parse as a reliable Date.
+     */
+    releaseDate?: string | null;
+    /** Steam app id — null for non-Steam titles and mobile games. */
+    steamAppid?: number | null;
     /** Availability lifecycle. Shares the union from {@link Game}. */
     availabilityStatus?: "available" | "coming_soon" | "maintenance" | "discontinued";
     /** Human-readable message for non-available games. */

package/package.json

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