chore(release): v3.6.2 — kizMarked marking code support for product cards

Sprint 8 — WB API update 2026-04-09: mandatory marking code confirmation.

Adds `kizMarked?: boolean` to product card create/update/list/trash methods,
enabling sellers to confirm via API that products carry the mandatory Честный
ЗНАК (honest mark) marking code. Also adds missing `needKiz?: boolean` to
getCardsTrash response where it was absent (pre-existing gap).

Changes:
  - src/modules/products/index.ts: 7 kizMarked edits + 2 needKiz additions
    across createCardsUpload, createUploadAdd, createCardsUpdate (request),
    getCardsList, getTrashedCards (response — both method signature and
    client.post<T> duplicate inline types)
  - tests/unit/modules/products-crud-critical.test.ts: 5 regression tests
    (request-side for all 3 create/update methods + response-side for
    getCardsList and getTrashedCards)

Code review findings (3M+2L) all fixed in same commit:
  - M1: getCardsTrash client.post<T> was missing needKiz+kizMarked (indent mismatch)
  - M2: Added 2 extra request-side regression tests (createCardsUpdate, createUploadAdd)
  - M3: Cleaned build artifact
  - L1: Added JSDoc to getCardsList client.post copy
  - L2: Fixed test description naming (getCardsTrash → getTrashedCards)

Validation: type-check ✓, lint ✓, 2080 tests passed, DX integration test ✓
(fresh /tmp project, tsc --noEmit with kizMarked:true in createCardsUpload)

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: salacoste

package.json

@@ -1,6 +1,6 @@
 {
   "name": "daytona-wildberries-typescript-sdk",
-  "version": "3.6.1",
+  "version": "3.6.2",
   "description": "Full-featured TypeScript SDK providing type-safe access to all Wildberries marketplace API methods",
   "keywords": [
     "wildberries",

src/index.ts

@@ -625,7 +625,7 @@ export class WildberriesSDK {
 /**
  * SDK version
  */
-export const version = '3.6.1';
+export const version = '3.6.2';
 
 // Main SDK class
 export { WildberriesSDK as default };

src/modules/products/index.ts

@@ -646,6 +646,8 @@ export class ProductsModule {
       title?: string;
       description?: string;
       needKiz?: boolean;
+      /** Confirmed mandatory marking code (Честный ЗНАК) applied to product @since v3.6.2 */
+      kizMarked?: boolean;
       photos?: {
         big?: string;
         c246x328?: string;
@@ -705,6 +707,8 @@ export class ProductsModule {
         title?: string;
         description?: string;
         needKiz?: boolean;
+        /** Confirmed mandatory marking code (Честный ЗНАК) applied to product @since v3.6.2 */
+        kizMarked?: boolean;
         photos?: {
           big?: string;
           c246x328?: string;
@@ -809,6 +813,8 @@ export class ProductsModule {
       dimensions?: { length?: number; width?: number; height?: number; weightBrutto?: number };
       characteristics?: { id: number; value: unknown }[];
       sizes: { chrtID?: number; techSize?: string; wbSize?: string; skus?: string[] }[];
+      /** Confirmed mandatory marking code (Честный ЗНАК) applied to product. Default: false. @since v3.6.2 */
+      kizMarked?: boolean;
     }[]
   ): Promise<ResponseCardCreate> {
     return this.client.post<ResponseCardCreate>(
@@ -985,6 +991,10 @@ export class ProductsModule {
         isValid?: boolean;
       };
       characteristics?: { id?: number; name?: string; value?: unknown }[];
+      /** Whether a mandatory marking code (Честный ЗНАК) is required for this product */
+      needKiz?: boolean;
+      /** Confirmed mandatory marking code (Честный ЗНАК) applied to product @since v3.6.2 */
+      kizMarked?: boolean;
       createdAt?: string;
       trashedAt?: string;
     }[];
@@ -1014,6 +1024,8 @@ export class ProductsModule {
           isValid?: boolean;
         };
         characteristics?: { id?: number; name?: string; value?: unknown }[];
+        needKiz?: boolean;
+        kizMarked?: boolean;
         createdAt?: string;
         trashedAt?: string;
       }[];
@@ -1136,6 +1148,8 @@ export class ProductsModule {
         dimensions?: { length?: number; width?: number; height?: number; weightBrutto?: number };
         sizes?: { techSize?: string; wbSize?: string; price?: number; skus?: string[] }[];
         characteristics?: { id: number; value: unknown }[];
+        /** Confirmed mandatory marking code (Честный ЗНАК) applied to product. Default: false. @since v3.6.2 */
+        kizMarked?: boolean;
       }[];
     }[]
   ): Promise<ResponseCardCreate> {
@@ -1185,6 +1199,8 @@ export class ProductsModule {
       dimensions?: { length?: number; width?: number; height?: number; weightBrutto?: number };
       sizes?: { techSize?: string; wbSize?: string; price?: number; skus?: string[] }[];
       characteristics?: { id: number; value: unknown }[];
+      /** Confirmed mandatory marking code (Честный ЗНАК) applied to product. Default: false. @since v3.6.2 */
+      kizMarked?: boolean;
     }[];
   }): Promise<ResponseCardCreate> {
     return this.client.post<ResponseCardCreate>(

tests/unit/index.test.ts

@@ -8,7 +8,7 @@ describe('SDK Index', () => {
     expect(version).toMatch(/^\d+\.\d+\.\d+$/);
   });
 
-  it('should have version 3.6.1', () => {
-    expect(version).toBe('3.6.1');
+  it('should have version 3.6.2', () => {
+    expect(version).toBe('3.6.2');
   });
 });

tests/unit/modules/products-crud-critical.test.ts

@@ -1181,4 +1181,126 @@ describe('ProductsModule - Critical CRUD Operations', () => {
       ).rejects.toThrow(AuthenticationError);
     });
   });
+
+  // ============================================================================
+  // v3.6.2 Regression: kizMarked marking code field
+  // Source: WB API update 2026-04-09 — mandatory marking code confirmation
+  // Quinn's rule: every type change ships with a test that fails if the type is removed
+  // ============================================================================
+
+  describe('kizMarked marking code field (v3.6.2)', () => {
+    it('should accept kizMarked: true in createCardsUpload request', async () => {
+      mockClient.post.mockResolvedValue({ data: {}, error: false, errorText: '' });
+
+      await productsModule.createCardsUpload([
+        {
+          subjectID: 105,
+          variants: [
+            {
+              vendorCode: 'KIZ-001',
+              sizes: [{ techSize: '42', skus: ['1234567890123'] }],
+              characteristics: [{ id: 1, value: 'Test' }],
+              kizMarked: true,
+            },
+          ],
+        },
+      ]);
+
+      expect(mockClient.post).toHaveBeenCalledWith(
+        'https://content-api.wildberries.ru/content/v2/cards/upload',
+        expect.arrayContaining([
+          expect.objectContaining({
+            variants: expect.arrayContaining([expect.objectContaining({ kizMarked: true })]),
+          }),
+        ]),
+        expect.anything()
+      );
+    });
+
+    it('should accept kizMarked: true in createCardsUpdate request', async () => {
+      mockClient.post.mockResolvedValue({ data: {}, error: false, errorText: '' });
+
+      await productsModule.createCardsUpdate([
+        {
+          nmID: 12345,
+          vendorCode: 'KIZ-UPD',
+          sizes: [{ techSize: '42' }],
+          kizMarked: true,
+        },
+      ]);
+
+      expect(mockClient.post).toHaveBeenCalledWith(
+        'https://content-api.wildberries.ru/content/v2/cards/update',
+        expect.arrayContaining([expect.objectContaining({ kizMarked: true })]),
+        expect.anything()
+      );
+    });
+
+    it('should accept kizMarked: true in createUploadAdd request', async () => {
+      mockClient.post.mockResolvedValue({ data: {}, error: false, errorText: '' });
+
+      await productsModule.createUploadAdd({
+        imtID: 98765,
+        cardsToAdd: [
+          {
+            vendorCode: 'KIZ-ADD',
+            sizes: [{ techSize: '44', skus: ['9999999999999'] }],
+            characteristics: [{ id: 1, value: 'Test' }],
+            kizMarked: true,
+          },
+        ],
+      });
+
+      expect(mockClient.post).toHaveBeenCalledWith(
+        'https://content-api.wildberries.ru/content/v2/cards/upload/add',
+        expect.objectContaining({
+          cardsToAdd: expect.arrayContaining([expect.objectContaining({ kizMarked: true })]),
+        }),
+        expect.anything()
+      );
+    });
+
+    it('should expose kizMarked and needKiz on getCardsList response', async () => {
+      const mockResponse = {
+        cards: [
+          {
+            nmID: 12345,
+            vendorCode: 'KIZ-001',
+            needKiz: true,
+            kizMarked: true,
+          },
+        ],
+        cursor: { total: 1 },
+      };
+      mockClient.post.mockResolvedValue(mockResponse);
+
+      const result = await productsModule.getCardsList({
+        settings: { cursor: { limit: 10 } },
+      });
+
+      expect(result.cards?.[0].needKiz).toBe(true);
+      expect(result.cards?.[0].kizMarked).toBe(true);
+    });
+
+    it('should expose kizMarked and needKiz on getTrashedCards response', async () => {
+      const mockResponse = {
+        cards: [
+          {
+            nmID: 99999,
+            vendorCode: 'TRASHED-001',
+            needKiz: false,
+            kizMarked: true,
+            trashedAt: '2026-04-09T00:00:00Z',
+          },
+        ],
+        cursor: { total: 1 },
+      };
+      mockClient.post.mockResolvedValue(mockResponse);
+
+      const result = await productsModule.getTrashedCards({});
+
+      expect(result.cards?.[0].needKiz).toBe(false);
+      expect(result.cards?.[0].kizMarked).toBe(true);
+    });
+  });
 });