@blob-solutions/vcr-am-sdk 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -2,6 +2,22 @@
 
 All notable changes to `@blob-solutions/vcr-am-sdk`. The format is loosely based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and the project follows [Semantic Versioning](https://semver.org/).
 
+## [0.11.0] — 2026-05-13
+
+### Breaking
+
+- `CreateDepartmentInput` now requires `title: { value: LocalizedName; localizationStrategy }` (mirroring `CreateCashierInput.name` and `CreateOfferInput.title`). `value.hy` is required, `value.ru`/`value.en` are optional. The server-side endpoint previously persisted departments without a title, which crashed X/Z reports for any sale that referenced one — the 0.10.0 call shape (`{ taxRegime, externalId? }`) is no longer accepted. Update calls to:
+
+  ```ts
+  await client.createDepartment({
+    taxRegime: "vat",
+    title: {
+      value: { hy: "Մթերք", ru: "Продукты", en: "Groceries" },
+      localizationStrategy: "translation",
+    },
+  });
+  ```
+
 ## [0.10.0] — 2026-05-02
 
 ### Breaking

package/lib/index.d.cts

@@ -436,6 +436,16 @@ type CreateCashierInput = {
 type CreateDepartmentInput = {
     externalId?: string;
     taxRegime: TaxRegime;
+    /**
+     * Department title shown on reports and receipts. `value.hy` is required;
+     * `value.ru` and `value.en` are optional and auto-transliterated from
+     * `hy` at render time when missing. `localizationStrategy` follows the
+     * same shape used by `CreateCashierInput.name` and `CreateOfferInput.title`.
+     */
+    title: {
+        value: LocalizedName;
+        localizationStrategy: "translation" | "transliteration";
+    };
 };
 type CreateOfferInputProduct = {
     type: "product";

package/lib/index.d.ts

@@ -436,6 +436,16 @@ type CreateCashierInput = {
 type CreateDepartmentInput = {
     externalId?: string;
     taxRegime: TaxRegime;
+    /**
+     * Department title shown on reports and receipts. `value.hy` is required;
+     * `value.ru` and `value.en` are optional and auto-transliterated from
+     * `hy` at render time when missing. `localizationStrategy` follows the
+     * same shape used by `CreateCashierInput.name` and `CreateOfferInput.title`.
+     */
+    title: {
+        value: LocalizedName;
+        localizationStrategy: "translation" | "transliteration";
+    };
 };
 type CreateOfferInputProduct = {
     type: "product";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blob-solutions/vcr-am-sdk",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Official TypeScript/JavaScript SDK for the VCR.AM Virtual Cash Register API — fiscalize sales, refunds, and prepayments through Armenia's State Revenue Committee.",
   "keywords": [
     "vcr",