aves-sdk 1.7.0 → 1.9.0

package/CHANGELOG.md

@@ -5,6 +5,41 @@ 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
+
+- Exportable shared object enums (`PaxQtyCriteria`, `AvesSearchType`, `PaymentType`, `InsertCriteria`, booking/master statuses, etc.) and matching `*Schema` picklists
+
+### Changed
+
+- **Breaking:** `searchPackages` / `searchTopServices` payload is flat (no `baseSearch` nest)
+- Defaults: `avesSearchType` (`PACKAGE` / `SERVICE` by method), `paxQty` ← `passengerList.length`, `paxQtyCriteria` ← `GREATER_OR_EQUAL`
+- `languageCode` optional when set on `AvesClient` options
+- Schemas use shared object enums instead of inline string unions
+
+---
+
 ## [1.7.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({
@@ -303,32 +304,29 @@ There is **no** Create Package API in AVES XML 1.8.0. Search, detail, and commit
 
 | Method | Purpose |
 | ------ | ------- |
-| `searchPackages` | Search programs (`avesSearchType`: `PACKAGE` / `PROGRAM`) |
-| `searchTopServices` | Search TOP services (`avesSearchType`: `SERVICE`) |
+| `searchPackages` | Search programs (defaults `avesSearchType: 'PACKAGE'`) |
+| `searchTopServices` | Search TOP services (defaults `avesSearchType: 'SERVICE'`) |
 | `getPackageDetail` | Package base info + service list |
 | `commitPackage` | Publish existing package (`packageCode` only) |
 
+`paxQty` defaults to `passengerList.length`; `paxQtyCriteria` defaults to `GREATER_OR_EQUAL`. `languageCode` can be omitted when set on `AvesClient` options.
+
 ```typescript
 const packages = await client.packages.searchPackages({
-  baseSearch: {
-    customerRecordCode: '138311',
-    languageCode: '01',
-    currencyCode: 'EUR',
-    startDate: '2014-12-27T00:00:00',
-    endDate: '2015-01-03T00:00:00',
-    passengerList: [
-      {
-        rph: '001',
-        roomRph: '001',
-        name: 'ADULTI 001',
-        categoryCode: 'AD',
-        sex: 'M',
-      },
-    ],
-  },
-  avesSearchType: 'PACKAGE',
-  paxQty: '1',
-  paxQtyCriteria: 'GREATER_OR_EQUAL',
+  customerRecordCode: '138311',
+  languageCode: '01',
+  currencyCode: 'EUR',
+  startDate: '2014-12-27T00:00:00',
+  endDate: '2015-01-03T00:00:00',
+  passengerList: [
+    {
+      rph: '001',
+      roomRph: '001',
+      name: 'ADULTI 001',
+      categoryCode: 'AD',
+      sex: 'M',
+    },
+  ],
   servOrPackCode: '2014MDE0000010',
 });
 
@@ -343,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]);
 ```
 
 ---
@@ -378,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)
@@ -426,28 +429,9 @@ Outbound path: validate → `createApiSchema` / `toWireBody` → `invokeOp` →
 import type {
   AvesClientOptions,
   AvesClientDeps,
-  SearchMasterRecord,
-  SearchMasterRecordRS,
-  MasterRecordDetail,
-  ManageMasterRecordRS,
-  BookingFileRQ,
-  BookingFileRS,
-  ModFileServicesRQ,
-  ModFileHeaderRQ,
-  CancelFileRQ,
-  SetFileStatusRQ,
-  SetFileServiceStatusRQ,
-  FilePaymentListRQ,
-  BookingStatusOnlyRS,
-  SearchBookingFileRQ,
-  SearchBookingFileRS,
   AvesSearchRQ,
-  SearchPackageRS,
-  SearchServicesRS,
-  PackageDetailRQ,
-  PackageDetailRS,
-  CommitPackageRQ,
-  CommitPackageRS,
+  BookingFileRQ,
+  SearchMasterRecord,
 } from 'aves-sdk';
 
 import {
@@ -457,7 +441,20 @@ import {
   BookingClient,
   PackageCatalogClient,
   AvesError,
+  // object enums
+  AvesSearchType,
+  BookingFileStatus,
+  InsertCriteria,
+  PassengerCategory,
+  PaxQtyCriteria,
+  PaymentType,
+  SearchMasterType,
 } from 'aves-sdk';
+
+PaxQtyCriteria.GREATER_OR_EQUAL
+AvesSearchType.PACKAGE
+PaymentType.B
+InsertCriteria.T
 ```
 
 ## License