aves-sdk 1.8.0 → 1.9.0

package/CHANGELOG.md

@@ -5,6 +5,26 @@ 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).
 
+## [1.9.0] - 2026-08-03
+
+### Changed
+
+- **Breaking:** `upsertRecord` spreads `masterRecordDetail` into `data` — `result.data.recordCode`
+- **Breaking:** booking create/mod/status spreads `bookingFileDetail` into `data` — `result.data.bookingFileCode`
+- **Breaking:** `getPackageDetail` spreads `packageDetail` into `data` — `result.data.pCode`
+- **Breaking:** response `*List` fields are flat Detail arrays (no inner `*Detail` wrapper) — e.g. `data.packageList?.[0]`, `data.masterRecordList`, `data.bookingFileList`, `data.bookedServiceList`
+- **Breaking:** nested booking/catalog lists unwrapped the same way (`passengerList`, `serviceList`, `paxPriceList`, …)
+- Input aliases: `customerRecordCode` ↔ `customerDetail`; `bookingFileStatus` / `fileStatus` as string or `{ value }`; `paxAssociated: string[]`; mod `selectedPackageList` ↔ `selectedPackageDetail`
+
+### Added
+
+- Response helpers: `listDetailApiSchema`, `flattenResponseDetail`, `createFlattenedResponseSchema`, `createListResponseSchema`
+- Request helpers: `createApiSchema`, `valueFieldSchema`, `coalesceCustomerRecordCode`, `coalesceListHead`, `coalesceWireAliases`
+- Shared primitives: `LanguageCodeSchema`, `StringishSchema`, `DateRangeSchema`, `StatusOnlyResponseSchema`, `createWireSchemaPair`
+- `yarn typecheck` script (`tsc --noEmit`)
+
+---
+
 ## [1.8.0] - 2026-08-03
 
 ### Added

package/README.md

@@ -143,7 +143,7 @@ const result = await client.upsertRecord({
 });
 
 if (result.success) {
-  console.log(result.data.masterRecordDetail?.recordCode);
+  console.log(result.data.recordCode);
 }
 ```
 
@@ -168,8 +168,8 @@ if (result.success) {
 
 ```typescript
 const created = await client.booking.createBooking({
-  customerDetail: { recordCode: '138311' },
-  bookingFileStatus: { value: 'QUOTATION' },
+  customerRecordCode: '138311', // or customerDetail: { recordCode: '138311' }
+  bookingFileStatus: 'QUOTATION', // or { value: 'QUOTATION', expiredDate? }
   startDate: '2015-01-22T00:00:00',
   endDate: '2015-01-25T00:00:00',
   selectedServiceList: [
@@ -182,7 +182,7 @@ const created = await client.booking.createBooking({
       endDate: '2015-01-25T00:00:00',
       qty: '1',
       pax: '2',
-      paxAssociated: [],
+      paxAssociated: [], // or string[] like ['001','002']
       avesSession: '1',
     },
   ],
@@ -198,7 +198,8 @@ const created = await client.booking.createBooking({
 });
 
 if (created.success) {
-  console.log(created.data.bookingFileDetail?.bookingFileCode);
+  console.log(created.data.bookingFileCode);
+  console.log(created.data.bookedServiceList?.[0]?.serviceStatus);
 }
 ```
 
@@ -273,7 +274,7 @@ await client.booking.modBookingHeader({
 await client.booking.setBookingStatus({
   customerRecordCode: '000170',
   bookingFileCode: '14/000081',
-  fileStatus: { value: 'CANCELED' },
+  fileStatus: 'CANCELED', // or { value: 'CANCELED' }
 });
 
 await client.booking.setBookingServiceStatus({
@@ -340,6 +341,9 @@ const detail = await client.packages.getPackageDetail({
 });
 
 await client.packages.commitPackage({ packageCode: '14/PACKAGE001' });
+
+if (packages.success) console.log(packages.data.packageList?.[0]?.pCode);
+if (detail.success) console.log(detail.data.pCode, detail.data.serviceList?.[0]);
 ```
 
 ---
@@ -375,9 +379,11 @@ You do not handle XML attribute prefixes yourself. Attr vs element is decided by
 One outbound path for all ops:
 
 1. Valibot validates camelCase input  
-2. `createApiSchema(schema, shape, wrap?)` → `toWireBody` (optional list wrap + empty `paxAssociated` normalize + `camelToPascalKeys`)  
+2. `createApiSchema(schema, shape, wrap?)` → `toWireBody` (optional list wrap + `paxAssociated` string[]/empty normalize + `camelToPascalKeys`)  
 3. `AvesTransport.invokeOp` adds `RqHeader`, optional `bodyKey` nest, POSTs XML  
 
+Inbound: `createResponseSchema` / `createFlattenedResponseSchema` / `createListResponseSchema` → camelCase + optional detail spread or typed list RS; `listDetailApiSchema` unwraps wire `*List`/`*Detail` to flat arrays; `coalesceWireAliases` normalizes dialect attrs. Input aliases: `valueFieldSchema`, `coalesceCustomerRecordCode`, `coalesceListHead`. Shared primitives: `LanguageCodeSchema`, `StringishSchema`, `DateRangeSchema`, `StatusOnlyResponseSchema`.
+
 Element-only roots use `elementOnlyWire` (`{}`). Master upsert nests under `bodyKey: "MasterRecordDetail"`; master search and booking spread fields at the RQ root.
 
 ### Request shapes (one family per op)