aves-sdk 1.9.0 → 2.0.1

package/CHANGELOG.md

@@ -5,6 +5,36 @@ All notable changes to this project are documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [2.0.1] - 2026-08-05
+
+### Changed
+
+- Omit source maps from the published package; `files` now ships only
+  `dist/index.mjs` and `dist/index.d.mts`.
+
+## [2.0.0] - 2026-08-05
+
+### Changed
+
+- **Breaking:** flat operation aliases were removed; use namespaced domain clients only.
+- **Breaking:** enum-typed fields now reject arbitrary strings at compile time.
+- **Breaking:** `AvesError.status` retains AVES casing and `AvesError.code` is `number | undefined`.
+- **Breaking:** master-record responses reflect the actual API payload, including server-only fields; `dynamicFields` is an array.
+- Fixed AVES language codes (`01` Italian, `02` English), raw warning text preservation, and the `PaymentDetail` `@PaumentNote` wire spelling.
+
+### Migration
+
+| Change | Symptom on upgrade | Fix |
+| ------ | ------------------ | --- |
+| Flat aliases removed | Runtime `TypeError` | Insert the domain namespace: `client.search` → `client.master.search` |
+| Enum types narrowed | Compile errors for enum fields receiving `string` | Use exported enum objects or unions |
+| `AvesError.status` casing | `err.status === "error"` no longer matches | Compare with `RsStatusValue` (`"OK"`, `"ERROR"`, `"WARNING"`, `"TIMEOUT"`) |
+| `AvesError.code` | Absent codes are `undefined`, not `0` | Check for `undefined` |
+| `MasterRecordDetailResponse` corrected | Type gains server-only fields | Remove local re-declarations |
+| `dynamicFields` is an array | Single-object assignment fails | Wrap the field in an array |
+
+---
+
 ## [1.9.0] - 2026-08-03
 
 ### Changed

package/README.md

@@ -27,7 +27,7 @@ const client = new AvesClient({
   timeoutMs: 30_000, // optional
 });
 
-const result = await client.search({
+const result = await client.master.search({
   searchType: 'CODE',
   recordCode: '508558',
 });
@@ -41,20 +41,17 @@ if (result.success) {
 
 ## Client shape
 
-`AvesClient` is a facade over domain clients. **Prefer namespaces.** Flat methods are auto-bound from domain prototypes (no hand-maintained forwarders).
+`AvesClient` is a facade over domain clients. Operations are namespaced by domain.
 
 ```typescript
-// canonical
 await client.booking.createBooking(params);
 await client.packages.searchPackages(params);
 await client.master.search({ searchType: 'CODE', recordCode: '508558' });
-
-// flat compat (same implementations)
-await client.createBooking(params);
-await client.searchPackages(params);
-await client.search({ searchType: 'CODE', recordCode: '508558' });
 ```
 
+Migration from 1.x: insert the appropriate domain namespace (for example,
+`client.search` → `client.master.search`). See the [2.0.0 migration notes](./CHANGELOG.md).
+
 | Namespace | Methods |
 | --------- | ------- |
 | `master` | `search`, `upsertRecord` |
@@ -105,7 +102,7 @@ type Result<T, E> =
 
 ## Master records
 
-### `search(params)` / `client.master.search`
+### `client.master.search(params)`
 
 | `searchType` | Required fields |
 | ------------ | --------------- |
@@ -124,18 +121,18 @@ const byCode = await client.master.search({
   recordCode: '508558',
 });
 
-const byEmail = await client.search({
+const byEmail = await client.master.search({
   searchType: 'EMAIL',
   email: 'user@example.com',
 });
 ```
 
-### `upsertRecord(record)` / `client.master.upsertRecord`
+### `client.master.upsertRecord(record)`
 
 `insertCriteria`: `'S'` always insert · `'N'` skip if exists · `'T'` update all (default) · `'M'` secondary fields only.
 
 ```typescript
-const result = await client.upsertRecord({
+const result = await client.master.upsertRecord({
   name: 'Jane Smith',
   email: 'jane@example.com',
   languageCode: '02',
@@ -353,7 +350,7 @@ if (detail.success) console.log(detail.data.pCode, detail.data.serviceList?.[0])
 ```typescript
 import { AvesClient, AvesError } from 'aves-sdk';
 
-const result = await client.search({
+const result = await client.master.search({
   searchType: 'CODE',
   recordCode: '508558',
 });
@@ -413,18 +410,19 @@ Editing CreateBooking shapes does not affect SearchFile or AvesSearch.
 | `MasterRecordsClient` | search / upsert |
 | `BookingClient` | booking file ops + search practices |
 | `PackageCatalogClient` | package/program catalog |
-| `client/types.ts` | `AvesClientDeps` / `AvesClientFlat` |
-| `client/flat-aliases.ts` | bind flat compat methods from domain prototypes |
+| `client/types.ts` | `AvesClientDeps` |
 | `src/xml/` | XML root helpers + JSON ↔ XML |
 
-Flat aliases (`client.createBooking`, …) are attached in the constructor — add a domain method once and both surfaces work.
-
 Outbound path: validate → `createApiSchema` / `toWireBody` → `invokeOp` → XML POST.
 
 ---
 
 ## Types
 
+Operations are available only through `client.master`, `client.booking`, and
+`client.packages`; flat aliases were removed in 2.0.0. See the
+[migration notes](./CHANGELOG.md) when upgrading.
+
 ```typescript
 import type {
   AvesClientOptions,