aves-sdk 3.1.0 → 4.0.1

package/dist/CHANGELOG.md

@@ -0,0 +1,409 @@
+# Changelog
+
+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).
+
+## [4.0.1] - 2026-08-06
+
+### Added
+
+- Copy `CHANGELOG.md` into `dist/` on build (`tsdown` `copy`) and include `dist/CHANGELOG.md` in published `files`.
+
+## [4.0.0] - 2026-08-06
+
+### Added
+
+- `OpBodyKey` object enum (`MasterRecordDetail`) for RQ payload nest keys; typed on `AVES_OPS` / envelope.
+- `AvesOp` object enum (+ `AvesOpSchema`) for `invokeOp` keys; domains use `AvesOp.create` instead of string literals.
+
+### Changed
+
+- **Breaking:** Domain method names no longer repeat the namespace / AVES verb soup. `AVES_OPS` keys follow the same short names (with `searchBookings` / `searchPackages` where `search` would collide).
+
+| Namespace | 3.x | 4.x |
+| --------- | --- | --- |
+| `master` | `upsertRecord` | `upsert` |
+| `booking` | `createBooking` | `create` |
+| `booking` | `modBookingServices` | `updateServices` |
+| `booking` | `modBookingHeader` | `updateHeader` |
+| `booking` | `cancelBooking` | `cancel` |
+| `booking` | `setBookingStatus` | `setStatus` |
+| `booking` | `setBookingServiceStatus` | `setServiceStatus` |
+| `booking` | `insertFilePaymentList` | `addPayments` |
+| `booking` | `searchBookingFiles` | `search` |
+| `packages` | `searchPackages` | `search` |
+| `packages` | `searchTopServices` | `searchServices` |
+| `packages` | `getPackageDetail` | `get` |
+| `packages` | `commitPackage` | `commit` |
+
+`master.search` is unchanged. Endpoint URLs and XML roots are unchanged.
+
+### Migration (1.x / 3.x → 4.x)
+
+Jump straight to 4.x for September apps: apply the 3.x facade + `master.search` flat-array notes, then rename methods per the table above (no compatibility aliases).
+
+```ts
+// 3.x
+await client.booking.createBooking(params);
+await client.packages.searchPackages(params);
+await client.master.upsertRecord(record);
+
+// 4.x
+await client.booking.create(params);
+await client.packages.search(params);
+await client.master.upsert(record);
+```
+
+## [3.1.1] - 2026-08-06
+
+### Added
+
+- Concise facade aliases for common I/O properties: `customerCode`, `bookingCode`, `services`, `passengers`, `packageCode`, `serviceCode`, `quantity`, `session`, and related fields.
+- Schema-owned dual keys via `facadeObject` / `coalesceAliases` (same pattern as `coalesceCustomerRecordCode`).
+- Simplified public type aliases including `BookingInput`, `Booking`, `MasterRecord`, `PackageInput`, and `Package`.
+- `AVES_OPS` registry + `invokeOp(op, params)` with external `OpParams` / `OpResult` typings.
+- Full facade alias property map in README (outbound `publicKeyAliases` + inbound scoped maps).
+- 2.x → 3.x migration notes for `master.search` (flat array success payload).
+
+### Changed
+
+- Facade names are accepted on Valibot input schemas and coalesced to AVES camelCase before wire encoding. Success payloads also expose concise compatibility aliases.
+- Internal transport split: `HttpClient`, `buildOpEnvelope`, `readAvesResponse`, `createRqHeader`; `toAvesError` lives in `error.ts`. Public `invokeOp` API unchanged.
+- Hot-path micro-opts: cached endpoint URLs, shared XML POST headers, frozen cached `RqHeader`, single `AVES_OPS` lookup per `invokeOp`.
+- Cap HTTP error body reads via `readTextCapped` (drain stream, keep ≤ `MAX_ERROR_BODY`).
+- WeakMap cache for `itemShape` / `encodeShapeFor` on static WireShape refs.
+- `toWireBody` single shape-driven walk (list wrap + pax normalize + wire keys).
+- Zero-copy `withPublicAliases` via hardened lazy Proxy (WeakMap identity, proto-pollution blocked).
+- ADR 0001 Phase 2a: `createResponseSchema` camelizes Valibot output **in place** (`pascalToCamelKeysInPlace`) — no second deep-copy. See [`docs/adr/0001-validate-during-camelize.md`](docs/adr/0001-validate-during-camelize.md).
+- Performance harness: `yarn test:bench` (Vitest bench) and `AVES_PERF=1 yarn test:perf` (relative hot-path asserts).
+
+## [3.0.0] - 2026-08-06
+
+### Changed
+
+- **Breaking:** `master.search` success payload is now `MasterRecordDetailResponse[]` — always a flat array (`[]`, one element, or many). No `rsStatus` wrapper on success (non-OK AVES status remains `result.error`). Replaces the prior `{ rsStatus, masterRecordList }` shape.
+
+### Migration (2.x → 3.x)
+
+Only `master.search` success shape changed. Other domain methods and error/`Result` contracts are unchanged from 2.x.
+
+| Change | Symptom on upgrade | Fix |
+| ------ | ------------------ | --- |
+| `master.search` success is a flat array | `result.data.masterRecordList` / `result.data.rsStatus` are `undefined`; types fail | Use `result.data` as `MasterRecordDetailResponse[]` (e.g. `const [record] = result.data` or `result.data.map(...)`) |
+| Looking for `rsStatus` on success | Always missing when `result.success` | Keep using `result.error` for non-OK AVES / HTTP failures (`error.kind`, `error.status`, `error.code`) |
+| Empty search | May have expected a missing list or wrapper | Success with no hits is `result.data === []` |
+
+**Before (2.x):**
+
+```ts
+const result = await client.master.search({
+  searchType: "CODE",
+  recordCode: "508558",
+});
+if (result.success) {
+  const records = result.data.masterRecordList ?? [];
+  console.log(result.data.rsStatus.status, records[0]?.recordCode);
+}
+```
+
+**After (3.x):**
+
+```ts
+const result = await client.master.search({
+  searchType: "CODE",
+  recordCode: "508558",
+});
+if (result.success) {
+  const [record] = result.data; // MasterRecordDetailResponse[]
+  console.log(record?.recordCode);
+} else {
+  console.error(result.error.kind, result.error.status, result.error.message);
+}
+```
+
+3.1.x on top of 3.0 is additive (facade aliases / internal transport). No further breaking migration from 3.0 → 3.1.1.
+
+## [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
+
+- **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 / Program catalog APIs: `searchPackages`, `searchTopServices`, `getPackageDetail`, `commitPackage`
+- `searchBookingFiles` (`FILE_CODE` | `PAX_NAME` | `PACKAGE_CODE` | `OTHER`)
+- Domain clients with DI: `AvesTransport`, `MasterRecordsClient`, `BookingClient`, `PackageCatalogClient`, `AvesClientDeps`
+- Per-request `WireShape` model (`src/utils/wire-shapes.ts`)
+- Flat method aliases auto-bound from domain prototypes (`client/flat-aliases.ts`)
+
+### Changed
+
+- `AvesClient` is a thin facade; prefer `client.booking.*` / `client.packages.*` / `client.master.*`
+- Single outbound wire path: `createApiSchema` / `toWireBody` / `invokeOp` (optional `bodyKey`)
+- XML helpers moved to `src/xml/`
+- Master search/upsert routed through `invokeOp`
+
+### Fixed
+
+- InsertFilePaymentList root `paymentUser` emitted as `@PaymentUser` (not a child element)
+
+### Removed
+
+- Global `ATTRIBUTE_FIELDS` registry
+- Versioned docs under `docs/` from git (`docs/` gitignored)
+
+---
+
+## [1.6.0] - 2026-07-29
+
+### Changed
+
+- **Breaking:** booking `*List` SDK inputs are flat `Detail[]`; SDK wraps to AVES List/Detail XML
+- Shared `PaymentTypeSchema` across booking ops
+- README refreshed for constructor, `Result` / `AvesError`, and flat list examples
+- Documented additional package managers in README
+
+---
+
+## [1.5.1] - 2026-07-29
+
+### Changed
+
+- Added `fast-xml-builder` dependency
+- Dependency / `tsdown` config maintenance
+
+---
+
+## [1.5.0] - 2026-07-29
+
+### Added
+
+- `insertFilePaymentList` (InsertFilePaymentList) for payment registration
+- Tighter `invokeOp` schema inference
+- Booking ops documentation updates
+
+---
+
+## [1.4.0] - 2026-07-29
+
+### Added
+
+- Booking ops: ModBookingFileServices, ModBookingFileHeader, CancelBookingFile, SetStatus / SetStatusService
+- Shared transforms and typed BOOKEDFILE responses
+- Unit coverage for booking ops
+
+### Changed
+
+- Dependency updates
+
+---
+
+## [1.3.4] - 2026-03-09
+
+### Added
+
+- Create-booking related input schemas: financial deadlines, payments, selected packages/services, notes, passengers
+
+### Fixed
+
+- Union formatting in `SelectedServiceListInputSchema`
+
+### Changed
+
+- Error handling via `isOk`
+- Schema / quote standardization across client and types
+
+---
+
+## [1.3.3] - 2026-02-26
+
+### Fixed
+
+- `package.json` packaging fix
+
+---
+
+## [1.3.2] - 2026-02-10
+
+### Added
+
+- `createBooking` (CreateBookingFile) with tests
+- Migrated bundler from `tsup` to `tsdown`
+
+### Changed
+
+- Package configuration updates
+
+---
+
+## [1.3.1] - 2026-02-01
+
+### Changed
+
+- Error-handling path formatting simplified
+- String-quote standardization
+
+---
+
+## [1.3.0] - 2026-02-01
+
+### Added
+
+- Biome linting
+- Undici-based mock improvements in tests
+- Additional master-record properties and attribute-schema refactor
+- Broader test coverage
+
+### Changed
+
+- Consolidated XML root element definitions and utilities
+
+---
+
+## [1.2.16] - 2026-01-27
+
+### Changed
+
+- Removed unnecessary `as any` casts
+
+---
+
+## [1.2.15] - 2026-01-27
+
+### Fixed
+
+- XML / validation follow-up fixes
+
+---
+
+## [1.2.14] - 2026-01-27
+
+### Changed
+
+- XML ↔ JSON conversion and validation schema improvements
+
+---
+
+## [1.2.13] - 2026-01-27
+
+### Added
+
+- Request timeout handling with clear timeout vs other errors
+- `isAbortError` utility
+
+### Changed
+
+- `AvesClientOptions` moved to `types.ts`
+- Request method uses Valibot `BaseSchema` more consistently
+- Upsert response schema and error detail improvements
+- `recordCode` length validation tests
+
+---
+
+## [1.2.12] - 2026-01-26
+
+### Added
+
+- Export `AvesClientOptions` for external usage
+- Mapped profiling record support
+
+### Changed
+
+- Restructured `AvesError` handling and client initialization
+- Optional `insertCriteria` on upsert flow
+
+### Fixed
+
+- Misc client fixes
+
+---
+
+## [1.2.11] - 2026-01-21
+
+### Fixed
+
+- Error code handling uses numeric values instead of strings
+
+---
+
+## [1.0.3] - 2025-10-04
+
+Early tagged releases (`v1.0.0` … `v1.0.3`) from the initial NestJS-oriented AVES SDK work. Detailed commit notes for those tags are limited in the current branch history.
+
+### Added
+
+- Initial AVES SDK implementation with XML/REST interfaces (2025-10-03)
+
+---
+
+## Links
+
+- [npm](https://www.npmjs.com/package/aves-sdk)
+- [GitHub](https://github.com/simoneguglielmi/aves-sdk)
+- Tags: [v1.0.0](https://github.com/simoneguglielmi/aves-sdk/releases/tag/v1.0.0) … [v1.0.3](https://github.com/simoneguglielmi/aves-sdk/releases/tag/v1.0.3)
+
+> Git tags after `v1.0.3` were not present when this file was generated; version sections follow `package.json` bumps and commit messages.

package/dist/index.d.mts

@@ -26,6 +26,12 @@ declare const RsStatusValueSchema: import("valibot").PicklistSchema<EnumValue<{
   readonly WARNING: "WARNING";
   readonly TIMEOUT: "TIMEOUT";
 }>[], undefined>;
+/** Nest key when an op wraps the API body under a Detail element (vs spread at RQ root). */
+declare const OpBodyKey: {
+  readonly MasterRecordDetail: "MasterRecordDetail";
+};
+type OpBodyKey = EnumValue<typeof OpBodyKey>;
+declare const OpBodyKeySchema: import("valibot").PicklistSchema<"MasterRecordDetail"[], undefined>;
 declare const SearchMasterType: {
   readonly CODE: "CODE";
   readonly NAME: "NAME";
@@ -11247,7 +11253,7 @@ declare const MasterRecordDetailResponseSchema: v.SchemaWithPipe<readonly [Omit<
 /**
  * Flat AvesSearchRQ body (camelCase) — shared by SearchAvesPackages / SearchTopServices.
  * BaseSearch fields live at the root; wire transform nests them under `BaseSearch`.
- * `searchPackages` / `searchTopServices` default `avesSearchType`; `paxQty` defaults to
+ * `packages.search` / `packages.searchServices` default `avesSearchType`; `paxQty` defaults to
  * `passengerList.length`; `paxQtyCriteria` defaults to `GREATER_OR_EQUAL`.
  * `languageCode` may come from `AvesClient` options when omitted.
  */
@@ -16497,7 +16503,7 @@ type DynamicFields = InferInput<typeof DynamicFieldsInputSchema>;
 /**
  * Master record detail for creating or updating customer, supplier, or general records.
  *
- * This is the primary input type for the `upsertRecord` method.
+ * This is the primary input type for the `upsert` method.
  *
  * @property recordCode - 6-character unique identifier (auto-generated if not provided)
  * @property insertCriteria - Duplicate handling strategy:
@@ -16632,7 +16638,7 @@ type SearchMasterRecordRS = MasterRecordDetailResponse[];
  * @property MasterRecordDetail - Record data to insert or update
  *
  * @internal This type is primarily for internal SDK use. Use {@link MasterRecordDetail}
- * as the input type for `client.master.upsertRecord()`.
+ * as the input type for `client.master.upsert()`.
  */
 type ManageMasterRecordRequest = InferInput<typeof ManageMasterRecordRequestSchema>;
 /**
@@ -16644,7 +16650,7 @@ type ManageMasterRecordRequest = InferInput<typeof ManageMasterRecordRequestSche
  *
  * @example
  * ```typescript
- * const result = await client.master.upsertRecord({
+ * const result = await client.master.upsert({
  *   languageCode: '02',
  *   name: 'New Customer',
  *   insertCriteria: 'N',
@@ -16877,11 +16883,49 @@ type OpConfig<TIn, TApiBody extends Record<string, unknown>, TOut extends {
   responseRoot: string;
   apiSchema: BaseSchema<TIn, TApiBody, BaseIssue<unknown>>;
   responseSchema: BaseSchema<unknown, TOut, BaseIssue<unknown>>;
-  bodyKey?: string;
+  bodyKey?: OpBodyKey;
 };
+/**
+ * Object enum of `invokeOp` / `AVES_OPS` keys.
+ * Prefer `AvesOp.create` over string literals in domain clients.
+ */
+declare const AvesOp: {
+  readonly search: "search";
+  readonly upsert: "upsert";
+  readonly create: "create";
+  readonly updateServices: "updateServices";
+  readonly updateHeader: "updateHeader";
+  readonly cancel: "cancel";
+  readonly setStatus: "setStatus";
+  readonly setServiceStatus: "setServiceStatus";
+  readonly addPayments: "addPayments";
+  readonly searchBookings: "searchBookings";
+  readonly searchPackages: "searchPackages";
+  readonly searchServices: "searchServices";
+  readonly get: "get";
+  readonly commit: "commit";
+};
+type AvesOp = EnumValue<typeof AvesOp>;
+declare const AvesOpSchema: import("valibot").PicklistSchema<EnumValue<{
+  readonly search: "search";
+  readonly upsert: "upsert";
+  readonly create: "create";
+  readonly updateServices: "updateServices";
+  readonly updateHeader: "updateHeader";
+  readonly cancel: "cancel";
+  readonly setStatus: "setStatus";
+  readonly setServiceStatus: "setServiceStatus";
+  readonly addPayments: "addPayments";
+  readonly searchBookings: "searchBookings";
+  readonly searchPackages: "searchPackages";
+  readonly searchServices: "searchServices";
+  readonly get: "get";
+  readonly commit: "commit";
+}>[], undefined>;
 /**
  * Static descriptor per AVES operation: endpoint, XML roots, schemas, optional body nest.
- * Domains call `invokeOp(op, params)` — everything else is looked up here.
+ * Domains call `invokeOp(AvesOp.*, params)` — keys match public method names where unique;
+ * collisions across namespaces use a short domain qualifier (`searchBookings`, `searchPackages`).
  */
 declare const AVES_OPS: {
   readonly search: OpConfig<{
@@ -17095,7 +17139,7 @@ declare const AVES_OPS: {
       warnings: string | undefined;
     };
   }>;
-  readonly upsertRecord: OpConfig<{
+  readonly upsert: OpConfig<{
     recordCode?: string | undefined;
     insertCriteria?: EnumValue<{
       readonly S: "S";
@@ -17605,7 +17649,7 @@ declare const AVES_OPS: {
     vatCode?: string | undefined;
     zipCode?: string | undefined;
   }>;
-  readonly createBooking: OpConfig<{
+  readonly create: OpConfig<{
     createDate?: string | undefined;
     bookingFileRefCode?: string | undefined;
     travelAgentCode?: string | undefined;
@@ -19639,7 +19683,7 @@ declare const AVES_OPS: {
     travelAgencyEmail?: string | undefined;
     travelAgencyName?: string | undefined;
   }>;
-  readonly modBookingServices: OpConfig<{
+  readonly updateServices: OpConfig<{
     customerRecordCode: string;
     bookingFileCode: string;
     currencyCode?: string | undefined;
@@ -20752,7 +20796,7 @@ declare const AVES_OPS: {
     travelAgencyEmail?: string | undefined;
     travelAgencyName?: string | undefined;
   }>;
-  readonly modBookingHeader: OpConfig<{
+  readonly updateHeader: OpConfig<{
     customerRecordCode: string;
     bookingFileCode: string;
     bookingFileStartDate: string;
@@ -21014,7 +21058,7 @@ declare const AVES_OPS: {
       warnings: string | undefined;
     };
   }>;
-  readonly cancelBooking: OpConfig<{
+  readonly cancel: OpConfig<{
     customerRecordCode: string;
     bookingFileCode: string;
   } & {
@@ -21036,7 +21080,7 @@ declare const AVES_OPS: {
       warnings: string | undefined;
     };
   }>;
-  readonly setBookingStatus: OpConfig<{
+  readonly setStatus: OpConfig<{
     customerRecordCode: string;
     bookingFileCode: string;
     fileStatus: {
@@ -21543,7 +21587,7 @@ declare const AVES_OPS: {
     travelAgencyEmail?: string | undefined;
     travelAgencyName?: string | undefined;
   }>;
-  readonly setBookingServiceStatus: OpConfig<{
+  readonly setServiceStatus: OpConfig<{
     customerRecordCode: string;
     bookingFileCode: string;
     bookingServiceRef: string;
@@ -21871,7 +21915,7 @@ declare const AVES_OPS: {
     travelAgencyEmail?: string | undefined;
     travelAgencyName?: string | undefined;
   }>;
-  readonly insertFilePaymentList: OpConfig<{
+  readonly addPayments: OpConfig<{
     bookingFileCode?: string | undefined;
     bookingFileRefCode?: string | undefined;
     paymentUser?: string | undefined;
@@ -21991,7 +22035,7 @@ declare const AVES_OPS: {
       warnings: string | undefined;
     };
   }>;
-  readonly searchBookingFiles: OpConfig<({
+  readonly searchBookings: OpConfig<({
     customerRecordCode: string;
     customerPromoterCode?: string | undefined;
     getSupplierInfo?: "false" | "true" | boolean | undefined;
@@ -22765,7 +22809,7 @@ declare const AVES_OPS: {
       warnings: string | undefined;
     };
   }>;
-  readonly searchTopServices: OpConfig<{
+  readonly searchServices: OpConfig<{
     customerRecordCode: string;
     languageCode?: string | undefined;
     currencyCode?: string | undefined;
@@ -23166,7 +23210,7 @@ declare const AVES_OPS: {
       toServiceType?: string | undefined;
     }[] | undefined;
   }>;
-  readonly getPackageDetail: OpConfig<{
+  readonly get: OpConfig<{
     customerRecordCode: string;
     languageCode?: string | undefined;
     currencyCode?: string | undefined;
@@ -23467,7 +23511,7 @@ declare const AVES_OPS: {
     startDate?: string | undefined;
     startValidation?: string | undefined;
   }>;
-  readonly commitPackage: OpConfig<{
+  readonly commit: OpConfig<{
     packageCode: string;
   }, {
     PackageCode: string;
@@ -23485,7 +23529,6 @@ declare const AVES_OPS: {
     };
   }>;
 };
-type AvesOp = keyof typeof AVES_OPS;
 /** Runtime input accepted by an op's API schema (facade + AVES dual keys). */
 type OpParams<K extends AvesOp> = InferInput<(typeof AVES_OPS)[K]["apiSchema"]>;
 /** Parsed success payload for an op (before facade aliases). */
@@ -23520,21 +23563,21 @@ declare class BookingClient {
   private readonly transport;
   constructor(transport: AvesTransport);
   /** Create a booking file (CreateBookingFile). */
-  createBooking(params: BookingFileRQ): Promise<Result<FacadeOutput<BookingFileRS>, AvesError>>;
+  create(params: BookingFileRQ): Promise<Result<FacadeOutput<BookingFileRS>, AvesError>>;
   /** Add/replace services, assign package, delete/nullify cost items. */
-  modBookingServices(params: ModFileServicesRQ): Promise<Result<FacadeOutput<BookingFileDetailRS>, AvesError>>;
+  updateServices(params: ModFileServicesRQ): Promise<Result<FacadeOutput<BookingFileDetailRS>, AvesError>>;
   /** Header only (pax, notes, billing) — no costs. */
-  modBookingHeader(params: ModFileHeaderRQ): Promise<Result<FacadeOutput<BookingStatusOnlyRS>, AvesError>>;
+  updateHeader(params: ModFileHeaderRQ): Promise<Result<FacadeOutput<BookingStatusOnlyRS>, AvesError>>;
   /** Delete a booking file (CancelBookingFile). */
-  cancelBooking(params: CancelFileRQ): Promise<Result<FacadeOutput<BookingStatusOnlyRS>, AvesError>>;
+  cancel(params: CancelFileRQ): Promise<Result<FacadeOutput<BookingStatusOnlyRS>, AvesError>>;
   /** Change booking file status (incl. CANCELED / NULLIFIED). */
-  setBookingStatus(params: SetFileStatusRQ): Promise<Result<FacadeOutput<BookingFileDetailRS>, AvesError>>;
+  setStatus(params: SetFileStatusRQ): Promise<Result<FacadeOutput<BookingFileDetailRS>, AvesError>>;
   /** Nullify a single booked service line. */
-  setBookingServiceStatus(params: SetFileServiceStatusRQ): Promise<Result<FacadeOutput<BookingFileDetailRS>, AvesError>>;
+  setServiceStatus(params: SetFileServiceStatusRQ): Promise<Result<FacadeOutput<BookingFileDetailRS>, AvesError>>;
   /** Register one or more payments on a booking file. */
-  insertFilePaymentList(params: FilePaymentListRQ): Promise<Result<FacadeOutput<BookingStatusOnlyRS>, AvesError>>;
+  addPayments(params: FilePaymentListRQ): Promise<Result<FacadeOutput<BookingStatusOnlyRS>, AvesError>>;
   /** Search booking files, incl. by PACKAGE_CODE. */
-  searchBookingFiles(params: SearchBookingFileRQ): Promise<Result<FacadeOutput<SearchBookingFileRS>, AvesError>>;
+  search(params: SearchBookingFileRQ): Promise<Result<FacadeOutput<SearchBookingFileRS>, AvesError>>;
 }
 //#endregion
 //#region src/client/master-records.d.ts
@@ -23544,7 +23587,7 @@ declare class MasterRecordsClient {
   /** Search master records. Success returns a flat array (empty when no matches). */
   search(params: SearchMasterRecord): Promise<Result<FacadeOutput<SearchMasterRecordRS>, AvesError>>;
   /** Insert or update a master record. */
-  upsertRecord(record: MasterRecordDetail): Promise<Result<FacadeOutput<ManageMasterRecordRS>, AvesError>>;
+  upsert(record: MasterRecordDetail): Promise<Result<FacadeOutput<ManageMasterRecordRS>, AvesError>>;
 }
 //#endregion
 //#region src/client/packages.d.ts
@@ -23553,13 +23596,13 @@ declare class PackageCatalogClient {
   private readonly transport;
   constructor(transport: AvesTransport);
   /** Search packages / programs. Defaults `avesSearchType` to `PACKAGE`. */
-  searchPackages(params: AvesSearchRQ): Promise<Result<FacadeOutput<SearchPackageRS>, AvesError>>;
+  search(params: AvesSearchRQ): Promise<Result<FacadeOutput<SearchPackageRS>, AvesError>>;
   /** Search TOP services. Defaults `avesSearchType` to `SERVICE`. */
-  searchTopServices(params: AvesSearchRQ): Promise<Result<FacadeOutput<SearchServicesRS>, AvesError>>;
+  searchServices(params: AvesSearchRQ): Promise<Result<FacadeOutput<SearchServicesRS>, AvesError>>;
   /** Package / program detail + service list. */
-  getPackageDetail(params: PackageDetailRQ): Promise<Result<FacadeOutput<PackageDetailRS>, AvesError>>;
+  get(params: PackageDetailRQ): Promise<Result<FacadeOutput<PackageDetailRS>, AvesError>>;
   /** Publish an existing package. Does not create packages. */
-  commitPackage(params: CommitPackageRQ): Promise<Result<FacadeOutput<CommitPackageRS>, AvesError>>;
+  commit(params: CommitPackageRQ): Promise<Result<FacadeOutput<CommitPackageRS>, AvesError>>;
 }
 //#endregion
 //#region src/client/types.d.ts
@@ -23580,4 +23623,4 @@ declare class AvesClient {
   constructor(options: AvesClientOptions, deps?: AvesClientDeps);
 }
 //#endregion
-export { type AccountPolicies, AvesClient, type AvesClientDeps, type AvesClientOptions, AvesError, type AvesOp, type AvesSearchRQ, AvesSearchType, AvesSearchTypeSchema, AvesServiceType, AvesServiceTypeSchema, AvesTransport, BookedServiceStatus, BookedServiceStatusSchema, type Booking, type BookingCancelInput, BookingClient, type BookingFileDetailRS, type BookingFileRQ, type BookingFileRS, BookingFileStatus, BookingFileStatusSchema, BookingFileStatusWire, BookingFileStatusWireSchema, type BookingHeaderInput, type BookingInput, type BookingSearchInput, type BookingSearchResult, type BookingStatusInput, type BookingStatusOnlyRS, type CancelFileRQ, CancelOperationType, CancelOperationTypeSchema, CarrierType, CarrierTypeSchema, type CatalogSearchInput, type CommitInput, type CommitPackageRQ, type CommitPackageRS, CostPriceType, CostPriceTypeSchema, CustomerPaymentType, CustomerPaymentTypeSchema, DestinationType, DestinationTypeSchema, DocumentType, DocumentTypeSchema, type DynamicFields, type FilePaymentListRQ, FilePaymentOperationType, FilePaymentOperationTypeSchema, type FinancialDetail, Gender, GenderSchema, GroupingPaxPolicy, GroupingPaxPolicySchema, type IdDocumentDetail, InsertCriteria, InsertCriteriaSchema, MakeDocumentTo, MakeDocumentToSchema, type ManageMasterRecordRS, type ManageMasterRecordRequest, MasterPaymentType, MasterPaymentTypeSchema, type MasterRecord, type MasterRecordDetail, type MasterRecordDetailResponse, type MasterRecordInput, MasterRecordsClient, type MasterSearchInput, type MasterSearchResult, type ModFileHeaderRQ, type ModFileServicesRQ, type OpParams, type OpResult, type OperationStatus, OptionedExpirePolicy, OptionedExpirePolicySchema, type Package, PackageCatalogClient, type PackageDetailRQ, type PackageDetailRS, type PackageInput, type PackageSearchResult, PassengerCategory, PassengerCategorySchema, PaxQtyCriteria, PaxQtyCriteriaSchema, type PaymentInput, PaymentType, PaymentTypeSchema, RecordStatus, RecordStatusSchema, RecordType, RecordTypeSchema, type RqHeader, type RsStatus, RsStatusValue, RsStatusValueSchema, type SearchBookingFileRQ, type SearchBookingFileRS, SearchBookingFileType, SearchBookingFileTypeSchema, type SearchMasterRecord, type SearchMasterRecordRS, SearchMasterType, SearchMasterTypeSchema, type SearchPackageRS, type SearchServicesRS, ServiceRefType, ServiceRefTypeSchema, type ServiceSearchResult, type ServiceStatusInput, type ServiceUpdateInput, type SetFileServiceStatusRQ, type SetFileStatusRQ, SetFileStatusValue, SetFileStatusValueSchema, ToServiceType, ToServiceTypeSchema, TypeDownloadFile, TypeDownloadFileSchema };
+export { type AccountPolicies, AvesClient, type AvesClientDeps, type AvesClientOptions, AvesError, AvesOp, AvesOpSchema, type AvesSearchRQ, AvesSearchType, AvesSearchTypeSchema, AvesServiceType, AvesServiceTypeSchema, AvesTransport, BookedServiceStatus, BookedServiceStatusSchema, type Booking, type BookingCancelInput, BookingClient, type BookingFileDetailRS, type BookingFileRQ, type BookingFileRS, BookingFileStatus, BookingFileStatusSchema, BookingFileStatusWire, BookingFileStatusWireSchema, type BookingHeaderInput, type BookingInput, type BookingSearchInput, type BookingSearchResult, type BookingStatusInput, type BookingStatusOnlyRS, type CancelFileRQ, CancelOperationType, CancelOperationTypeSchema, CarrierType, CarrierTypeSchema, type CatalogSearchInput, type CommitInput, type CommitPackageRQ, type CommitPackageRS, CostPriceType, CostPriceTypeSchema, CustomerPaymentType, CustomerPaymentTypeSchema, DestinationType, DestinationTypeSchema, DocumentType, DocumentTypeSchema, type DynamicFields, type FilePaymentListRQ, FilePaymentOperationType, FilePaymentOperationTypeSchema, type FinancialDetail, Gender, GenderSchema, GroupingPaxPolicy, GroupingPaxPolicySchema, type IdDocumentDetail, InsertCriteria, InsertCriteriaSchema, MakeDocumentTo, MakeDocumentToSchema, type ManageMasterRecordRS, type ManageMasterRecordRequest, MasterPaymentType, MasterPaymentTypeSchema, type MasterRecord, type MasterRecordDetail, type MasterRecordDetailResponse, type MasterRecordInput, MasterRecordsClient, type MasterSearchInput, type MasterSearchResult, type ModFileHeaderRQ, type ModFileServicesRQ, OpBodyKey, OpBodyKeySchema, type OpParams, type OpResult, type OperationStatus, OptionedExpirePolicy, OptionedExpirePolicySchema, type Package, PackageCatalogClient, type PackageDetailRQ, type PackageDetailRS, type PackageInput, type PackageSearchResult, PassengerCategory, PassengerCategorySchema, PaxQtyCriteria, PaxQtyCriteriaSchema, type PaymentInput, PaymentType, PaymentTypeSchema, RecordStatus, RecordStatusSchema, RecordType, RecordTypeSchema, type RqHeader, type RsStatus, RsStatusValue, RsStatusValueSchema, type SearchBookingFileRQ, type SearchBookingFileRS, SearchBookingFileType, SearchBookingFileTypeSchema, type SearchMasterRecord, type SearchMasterRecordRS, SearchMasterType, SearchMasterTypeSchema, type SearchPackageRS, type SearchServicesRS, ServiceRefType, ServiceRefTypeSchema, type ServiceSearchResult, type ServiceStatusInput, type ServiceUpdateInput, type SetFileServiceStatusRQ, type SetFileStatusRQ, SetFileStatusValue, SetFileStatusValueSchema, ToServiceType, ToServiceTypeSchema, TypeDownloadFile, TypeDownloadFileSchema };