daytona-wildberries-typescript-sdk 3.13.1 → 3.15.0

package/README.md

@@ -41,6 +41,28 @@ Transform 11 OpenAPI specifications into a production-ready SDK with 14 modules,
 - **💰 Finance v1 Reports** - Sales Reports and Acquiring Reports with `parseMoneyAmount()` helper and field union types for autocomplete
 - **🔔 Deprecation Utilities** - `warnOnce()` and `resetDeprecationWarnings()` for clean migration workflows
 
+## What's New (v3.15.0) — May 2026
+
+⚠️ **FBS marking-code deadline: 2026-06-03** — WB starts validating Честный Знак marking codes server-side for B2C FBS orders. Invalid codes → HTTP 409 with new `metaDetails[]` diagnostic field on `PATCH /api/v3/supplies/{supplyId}/deliver` (method `sdk.ordersFBS.updateSuppliesDeliver()`). Codes must be passed in full with GS separators + crypto-tail.
+
+🆕 **New `MetaValidationFailError` class** — `import { MetaValidationFailError } from 'daytona-wildberries-typescript-sdk'`. Extends `WBAPIError`; exposes typed `metaDetails: MetaDetail[]` and `code: string`. Backward-compatible — existing `instanceof WBAPIError` catches still work.
+
+🛠 **New `parseMetaValidationFail()` helper** — narrows any caught error to `{ code, message, metaDetails } | null` without importing the class. Convenient for shared error boundaries.
+
+⚡ **10× rate-limit penalty warning**: every 409 response on `updateSuppliesDeliver` counts as 10 requests. The migration guide recommends pre-flight validation via `sdk.ordersFBS.getOrdersMetaBulk()` to avoid burning quota.
+
+See [CHANGELOG v3.15.0](#3150---2026-05-21) and the [migration guide](./docs/guides/fbs-marking-code-validation.md) for the full pattern catalog, decision matrix, and FAQ.
+
+## What's New (v3.14.0) — May 2026
+
+🚨 **Silent semantic break deadline: 2026-06-16** — WB changes the `withPhoto` filter: `withPhoto: 0` (or missing) will mean "ALL cards" instead of "no-photo only". The new value `withPhoto: 2` replaces the old `0` semantic. **No HTTP error, no signal — wrong data.** Migrate before the deadline.
+
+🆕 **New `WITH_PHOTO_FILTER` const** — `import { WITH_PHOTO_FILTER } from 'daytona-wildberries-typescript-sdk'`. Use `WITH_PHOTO_FILTER.NO_PHOTO` (= 2), `WITH_PHOTO_FILTER.WITH_PHOTO` (= 1), or `WITH_PHOTO_FILTER.ALL` (= -1) instead of magic numbers.
+
+🔔 **Runtime warn-once**: first call with `withPhoto: 0` emits a `console.warn` pointing to the migration guide and deadline. Use `resetDeprecationWarnings()` in tests.
+
+See [CHANGELOG v3.14.0](#3140---2026-05-15) and the [migration guide](./docs/guides/withphoto-semantic-migration.md) for the full migration matrix and code examples.
+
 ## What's New (v3.13.0) — May 2026
 
 🔧 **Critical fix: `sdk.communications.createSellerMessage()` now works** — the method previously sent an empty body on every call (broken since introduction). v3.13.0 requires a `data: SellerMessageRequest` parameter. Existing TypeScript call sites `createSellerMessage()` will fail to compile — this is intentional; the old signature never worked.
@@ -320,6 +342,28 @@ This is an unofficial SDK. It is not affiliated with, officially maintained by,
 - **💰 Финансовые Отчеты v1** - Отчеты о продажах и эквайринге с хелпером `parseMoneyAmount()` и union-типами полей для автодополнения
 - **🔔 Утилиты Для Устаревших Методов** - `warnOnce()` и `resetDeprecationWarnings()` для удобной миграции
 
+## Что нового (v3.15.0) — Май 2026
+
+⚠️ **Дедлайн проверки маркировки FBS: 2026-06-03** — WB начинает серверную проверку кодов Честного знака для B2C-заказов FBS. Некорректные коды → HTTP 409 с новым диагностическим полем `metaDetails[]` на `PATCH /api/v3/supplies/{supplyId}/deliver` (метод `sdk.ordersFBS.updateSuppliesDeliver()`). Коды передаются полностью — с GS-разделителями и криптохвостом.
+
+🆕 **Новый класс `MetaValidationFailError`** — `import { MetaValidationFailError } from 'daytona-wildberries-typescript-sdk'`. Наследуется от `WBAPIError`; типизированно открывает `metaDetails: MetaDetail[]` и `code: string`. Обратносовместимо — существующие `instanceof WBAPIError` продолжают работать.
+
+🛠 **Новый хелпер `parseMetaValidationFail()`** — приводит любую пойманную ошибку к `{ code, message, metaDetails } | null` без импорта класса. Удобно для общих error boundary.
+
+⚡ **Штраф rate-limit ×10**: каждый ответ 409 на `updateSuppliesDeliver` учитывается как 10 запросов. Гайд миграции рекомендует предварительную проверку через `sdk.ordersFBS.getOrdersMetaBulk()`, чтобы не выжигать квоту.
+
+Подробности — в [CHANGELOG v3.15.0](#3150---2026-05-21) и [руководстве по миграции](./docs/ru/guides/fbs-marking-code-validation.md) с полным каталогом паттернов, матрицей решений и FAQ.
+
+## Что нового (v3.14.0) — Май 2026
+
+🚨 **Скрытое изменение семантики, дедлайн 2026-06-16** — WB меняет фильтр `withPhoto`: значение `0` (или отсутствие параметра) будет означать «ВСЕ карточки» вместо «только без фото». Новое значение `withPhoto: 2` заменяет прежнюю семантику `0`. **HTTP 200, нет ошибки, нет сигнала — неправильные данные.** Мигрируйте до дедлайна.
+
+🆕 **Новая константа `WITH_PHOTO_FILTER`** — `import { WITH_PHOTO_FILTER } from 'daytona-wildberries-typescript-sdk'`. Используйте `WITH_PHOTO_FILTER.NO_PHOTO` (= 2), `WITH_PHOTO_FILTER.WITH_PHOTO` (= 1) или `WITH_PHOTO_FILTER.ALL` (= -1) вместо магических чисел.
+
+🔔 **Предупреждение при первом вызове**: первый вызов с `withPhoto: 0` выводит `console.warn` со ссылкой на руководство по миграции и дедлайном. Используйте `resetDeprecationWarnings()` в тестах.
+
+Подробности — в [CHANGELOG v3.14.0](#3140---2026-05-15) и [руководстве по миграции](./docs/ru/guides/withphoto-semantic-migration.md) с полной матрицей миграции и примерами кода.
+
 ## Что нового (v3.13.0) — Май 2026
 
 🔧 **Критическое исправление: `sdk.communications.createSellerMessage()` теперь работает** — метод ранее отправлял пустое тело при каждом вызове (сломан с момента появления). v3.13.0 требует параметр `data: SellerMessageRequest`. Существующие вызовы `createSellerMessage()` без аргументов перестанут компилироваться — это намеренно; старая сигнатура никогда не работала.