@gojinko/cli 1.3.0 → 2.0.0

package/dist/commands/flight-calendar.js

@@ -1,14 +1,28 @@
-import { withClient, output } from './shared.js';
+import { withClient, output, resolveDeprecatedFlag } from './shared.js';
 export function registerFlightCalendarCommand(program) {
     program
         .command('flight-calendar')
         .description('Show cheapest prices across a date range for a route.')
-        .requiredOption('--from <origin>', 'origin airport code')
-        .requiredOption('--to <destination>', 'destination airport code')
+        // Canonical flat discovery flags — match jinko-api FlightDiscoveryRequest.
+        .option('--origins <codes...>', 'origin IATA airport/city codes. JSON: `origins[]`.')
+        .option('--destinations <codes...>', 'destination IATA airport/city codes. JSON: `destinations[]`.')
         .option('--month <month>', 'month to display (YYYY-MM), defaults to current month')
-        .option('--cabin <class>', 'cabin class', 'economy')
-        .option('--direct-only', 'only direct flights')
+        .option('--cabin-class <class>', 'cabin class: economy, premium_economy, business, first (default: economy). JSON: `cabin_class`.')
+        .option('--direct-only', 'only direct flights. JSON: `direct_only`.')
+        // Deprecated aliases — Phase 1 transition (JIN-665), remove in next major.
+        .option('--from <origin>', 'DEPRECATED: use --origins.')
+        .option('--to <destination>', 'DEPRECATED: use --destinations.')
+        .option('--cabin <class>', 'DEPRECATED: use --cabin-class.')
         .action(withClient(async (client, globals, opts) => {
+        // Resolve deprecated aliases onto canonical flags. --from/--to are
+        // singular; wrap them into the canonical arrays.
+        const origins = resolveDeprecatedFlag(opts.origins, opts.from ? [opts.from] : undefined, '--from', '--origins');
+        const destinations = resolveDeprecatedFlag(opts.destinations, opts.to ? [opts.to] : undefined, '--to', '--destinations');
+        const cabinClass = resolveDeprecatedFlag(opts.cabinClass, opts.cabin, '--cabin', '--cabin-class') ?? 'economy';
+        if (!origins?.length || !destinations?.length) {
+            console.error('Error: --origins and --destinations are required.');
+            process.exit(3);
+        }
         const month = opts.month ?? new Date().toISOString().slice(0, 7);
         const [year, mon] = month.split('-').map(Number);
         if (!year || !mon) {
@@ -18,28 +32,20 @@ export function registerFlightCalendarCommand(program) {
         const startDate = `${month}-01`;
         const lastDay = new Date(year, mon, 0).getDate();
         const endDate = `${month}-${String(lastDay).padStart(2, '0')}`;
-        const body = {
-            passengers: { adt: 1 },
-            filters: {
-                locations: {
-                    origins: [opts.from],
-                    destinations: [opts.to],
-                },
-                dates: {
-                    departure_date_ranges: [{ start: startDate, end: endDate }],
-                },
-                trip_type: 'oneway',
-                cabin_class: opts.cabin,
-                direct_only: opts.directOnly ?? false,
-            },
-            sort: 'lowest',
+        // Canonical FLAT discovery body — jinko-api POST /v1/flight_calendar.
+        const request = {
+            origins,
+            destinations,
+            departure_date_ranges: [{ start: startDate, end: endDate }],
+            trip_type: 'oneway',
+            cabin_class: cabinClass,
+            direct_only: opts.directOnly ?? false,
+            adults: 1,
+            sort_by: 'lowest',
         };
-        const response = await client.raw.POST('/api/v1/flights/search', {
-            body,
-        });
-        const data = response.data;
+        const data = await client.flightCalendar(request);
         if (globals.format === 'table') {
-            console.log(`\nFlight calendar: ${opts.from} → ${opts.to} (${month})`);
+            console.log(`\nFlight calendar: ${origins.join(',')} → ${destinations.join(',')} (${month})`);
             console.log(`Date range: ${startDate} to ${endDate}\n`);
         }
         output(data, { format: globals.format });

package/dist/commands/flight-calendar.js.map

@@ -1 +1 @@
-{"version":3,"file":"flight-calendar.js","sourceRoot":"","sources":["../../src/commands/flight-calendar.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,UAAU,6BAA6B,CAAC,OAAgB;IAC5D,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,uDAAuD,CAAC;SACpE,cAAc,CAAC,iBAAiB,EAAE,qBAAqB,CAAC;SACxD,cAAc,CAAC,oBAAoB,EAAE,0BAA0B,CAAC;SAChE,MAAM,CAAC,iBAAiB,EAAE,uDAAuD,CAAC;SAClF,MAAM,CAAC,iBAAiB,EAAE,aAAa,EAAE,SAAS,CAAC;SACnD,MAAM,CAAC,eAAe,EAAE,qBAAqB,CAAC;SAC9C,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACjD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,KAAK,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAE/D,MAAM,IAAI,GAA4B;YACpC,UAAU,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE;YACtB,OAAO,EAAE;gBACP,SAAS,EAAE;oBACT,OAAO,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC;oBACpB,YAAY,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;iBACxB;gBACD,KAAK,EAAE;oBACL,qBAAqB,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;iBAC5D;gBACD,SAAS,EAAE,QAAQ;gBACnB,WAAW,EAAE,IAAI,CAAC,KAAK;gBACvB,WAAW,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;aACtC;YACD,IAAI,EAAE,QAAQ;SACf,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE;YAC/D,IAAI;SACL,CAAC,CAAC;QAEH,MAAM,IAAI,GAAI,QAA+B,CAAC,IAAI,CAAC;QAEnD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,KAAK,KAAK,GAAG,CAAC,CAAC;YACvE,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,OAAO,OAAO,IAAI,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}
+{"version":3,"file":"flight-calendar.js","sourceRoot":"","sources":["../../src/commands/flight-calendar.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,UAAU,6BAA6B,CAAC,OAAgB;IAC5D,OAAO;SACJ,OAAO,CAAC,iBAAiB,CAAC;SAC1B,WAAW,CAAC,uDAAuD,CAAC;QACrE,2EAA2E;SAC1E,MAAM,CAAC,sBAAsB,EAAE,oDAAoD,CAAC;SACpF,MAAM,CAAC,2BAA2B,EAAE,8DAA8D,CAAC;SACnG,MAAM,CAAC,iBAAiB,EAAE,uDAAuD,CAAC;SAClF,MAAM,CAAC,uBAAuB,EAAE,iGAAiG,CAAC;SAClI,MAAM,CAAC,eAAe,EAAE,2CAA2C,CAAC;QACrE,2EAA2E;SAC1E,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,CAAC;SACvD,MAAM,CAAC,oBAAoB,EAAE,iCAAiC,CAAC;SAC/D,MAAM,CAAC,iBAAiB,EAAE,gCAAgC,CAAC;SAC3D,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACjD,mEAAmE;QACnE,iDAAiD;QACjD,MAAM,OAAO,GACX,qBAAqB,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;QAClG,MAAM,YAAY,GAChB,qBAAqB,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;QACtG,MAAM,UAAU,GACd,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,eAAe,CAAC,IAAI,SAAS,CAAC;QAE9F,IAAI,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;YAC9C,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;YACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjE,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;YAClB,OAAO,CAAC,KAAK,CAAC,2CAA2C,CAAC,CAAC;YAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,KAAK,KAAK,CAAC;QAChC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;QACjD,MAAM,OAAO,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;QAE/D,sEAAsE;QACtE,MAAM,OAAO,GAAsB;YACjC,OAAO;YACP,YAAY;YACZ,qBAAqB,EAAE,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC;YAC3D,SAAS,EAAE,QAAQ;YACnB,WAAW,EAAE,UAAU;YACvB,WAAW,EAAE,IAAI,CAAC,UAAU,IAAI,KAAK;YACrC,MAAM,EAAE,CAAC;YACT,OAAO,EAAE,QAAQ;SAClB,CAAC;QAEF,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;QAElD,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,EAAE,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,sBAAsB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC;YAC9F,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,OAAO,OAAO,IAAI,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/commands/flight-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"flight-search.d.ts","sourceRoot":"","sources":["../../src/commands/flight-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAkElE"}
+{"version":3,"file":"flight-search.d.ts","sourceRoot":"","sources":["../../src/commands/flight-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0ElE"}

package/dist/commands/flight-search.js

@@ -1,67 +1,71 @@
-import { withClient, output } from './shared.js';
+import { withClient, output, resolveDeprecatedFlag } from './shared.js';
 export function registerFlightSearchCommand(program) {
     program
         .command('flight-search')
         .description('Live flight search or price-check a specific offer.')
-        .option('--from <origin>', 'origin IATA code (e.g. PAR for city, CDG for airport)')
-        .option('--origin-type <type>', 'origin code type: city or airport (default: city)', 'city')
-        .option('--to <destination>', 'destination IATA code (e.g. NYC for city, JFK for airport)')
-        .option('--destination-type <type>', 'destination code type: city or airport (default: city)', 'city')
-        .option('--date <date>', 'departure date (YYYY-MM-DD)')
-        .option('--return <date>', 'return date for round-trip (YYYY-MM-DD)')
-        .option('--passengers <n>', 'number of passengers', '1')
-        .option('--cabin <class>', 'cabin class: economy, premium_economy, business, first', 'economy')
-        .option('--direct-only', 'only show direct flights')
-        .option('--max-price <amount>', 'maximum price filter')
-        .option('--include-carriers <codes...>', 'include only these IATA 2-letter carrier codes (e.g. AF KL)')
-        .option('--exclude-carriers <codes...>', 'exclude these IATA 2-letter carrier codes (e.g. FR U2)')
-        .option('--offer-token <token>', 'price-check a specific offer (live pricing)')
+        // Canonical flat flags — match jinko-api FlightSearchRequest leaf names.
+        .option('--origin <code>', 'origin IATA code (e.g. PAR for city, JFK for airport). JSON: `origin`.')
+        .option('--destination <code>', 'destination IATA code (e.g. NYC for city, LAX for airport). JSON: `destination`.')
+        .option('--departure-date <date>', 'departure date (YYYY-MM-DD). JSON: `departure_date`.')
+        .option('--return-date <date>', 'return date for round-trip (YYYY-MM-DD). JSON: `return_date`.')
+        .option('--cabin-class <class>', 'cabin class: economy, premium_economy, business, first (default: economy). JSON: `cabin_class`.')
+        .option('--adults <n>', 'number of adult passengers (default: 1). JSON: `adults`.')
+        .option('--direct-only', 'only show direct flights. JSON: `direct_only`.')
+        .option('--max-price <amount>', 'maximum price filter. JSON: `max_price`.')
+        .option('--include-carriers <codes...>', 'include only these IATA 2-letter carrier codes (e.g. AF KL). JSON: `include_carriers`.')
+        .option('--exclude-carriers <codes...>', 'exclude these IATA 2-letter carrier codes (e.g. FR U2). JSON: `exclude_carriers`.')
+        .option('--offer-token <token>', 'price-check a specific offer (live pricing). JSON: `offer_token`.')
+        // Deprecated aliases — Phase 1 transition (JIN-665), remove in next major.
+        .option('--from <origin>', 'DEPRECATED: use --origin.')
+        .option('--to <destination>', 'DEPRECATED: use --destination.')
+        .option('--date <date>', 'DEPRECATED: use --departure-date.')
+        .option('--return <date>', 'DEPRECATED: use --return-date.')
+        .option('--cabin <class>', 'DEPRECATED: use --cabin-class.')
+        .option('--passengers <n>', 'DEPRECATED: use --adults.')
+        // Deprecated no-ops — dropped from the public flat contract.
+        .option('--origin-type <type>', 'DEPRECATED: ignored by the public contract (no longer sent).')
+        .option('--destination-type <type>', 'DEPRECATED: ignored by the public contract (no longer sent).')
         .action(withClient(async (client, globals, opts) => {
+        // Resolve deprecated aliases onto canonical flags.
+        const origin = resolveDeprecatedFlag(opts.origin, opts.from, '--from', '--origin');
+        const destination = resolveDeprecatedFlag(opts.destination, opts.to, '--to', '--destination');
+        const departureDate = resolveDeprecatedFlag(opts.departureDate, opts.date, '--date', '--departure-date');
+        const returnDate = resolveDeprecatedFlag(opts.returnDate, opts.return, '--return', '--return-date');
+        const cabinClass = resolveDeprecatedFlag(opts.cabinClass, opts.cabin, '--cabin', '--cabin-class') ?? 'economy';
+        const adults = resolveDeprecatedFlag(opts.adults, opts.passengers, '--passengers', '--adults') ?? '1';
         const isOfferCheck = Boolean(opts.offerToken);
         if (isOfferCheck) {
-            // Price-check mode
-            const response = await client.raw.POST('/api/v1/flights/shop', {
-                body: {
-                    offer_token: opts.offerToken,
-                    passengers: {
-                        adults: Number(opts.passengers) || 1,
-                    },
-                },
+            // Price-check mode — canonical flat body, jinko-api POST /v1/flight_search.
+            const response = await client.flightSearch({
+                offer_token: opts.offerToken,
+                adults: Number(adults) || 1,
             });
-            output(response.data, { format: globals.format });
+            output(response, { format: globals.format });
         }
         else {
             // Search mode
-            if (!opts.from || !opts.to || !opts.date) {
-                console.error('Error: --from, --to, and --date are required for search mode.');
+            if (!origin || !destination || !departureDate) {
+                console.error('Error: --origin, --destination, and --departure-date are required for search mode.');
                 console.error('  Or provide --offer-token for price-check mode.');
                 process.exit(3);
             }
-            const body = {
-                origin: opts.from,
-                origin_type: opts.originType ?? 'city',
-                destination: opts.to,
-                destination_type: opts.destinationType ?? 'city',
-                departure_date: opts.date,
-                trip_type: opts.return ? 'roundtrip' : 'oneway',
-                cabin_class: opts.cabin,
+            // Canonical FLAT body — adults at top level (no `passengers` wrapper);
+            // the public surface drops origin_type/destination_type.
+            const request = {
+                origin,
+                destination,
+                departure_date: departureDate,
+                trip_type: returnDate ? 'roundtrip' : 'oneway',
+                cabin_class: cabinClass,
                 direct_only: opts.directOnly ?? false,
-                passengers: {
-                    adults: Number(opts.passengers) || 1,
-                },
+                adults: Number(adults) || 1,
+                ...(returnDate ? { return_date: returnDate } : {}),
+                ...(opts.maxPrice ? { max_price: Number(opts.maxPrice) } : {}),
+                ...(opts.includeCarriers ? { include_carriers: opts.includeCarriers } : {}),
+                ...(opts.excludeCarriers ? { exclude_carriers: opts.excludeCarriers } : {}),
             };
-            if (opts.return)
-                body['return_date'] = opts.return;
-            if (opts.maxPrice)
-                body['max_price'] = Number(opts.maxPrice);
-            if (opts.includeCarriers)
-                body['include_carriers'] = opts.includeCarriers;
-            if (opts.excludeCarriers)
-                body['exclude_carriers'] = opts.excludeCarriers;
-            const response = await client.raw.POST('/api/v1/flights/shop', {
-                body,
-            });
-            output(response.data, { format: globals.format });
+            const response = await client.flightSearch(request);
+            output(response, { format: globals.format });
         }
     }));
 }

package/dist/commands/flight-search.js.map

@@ -1 +1 @@
-{"version":3,"file":"flight-search.js","sourceRoot":"","sources":["../../src/commands/flight-search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"flight-search.js","sourceRoot":"","sources":["../../src/commands/flight-search.ts"],"names":[],"mappings":"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"}

package/dist/commands/get-booking.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-booking.d.ts","sourceRoot":"","sources":["../../src/commands/get-booking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAwBhE"}
+{"version":3,"file":"get-booking.d.ts","sourceRoot":"","sources":["../../src/commands/get-booking.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoBpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0BhE"}

package/dist/commands/get-booking.js

@@ -1,9 +1,16 @@
-import { withClient, output } from './shared.js';
+import { withClient, output, resolveDeprecatedFlag } from './shared.js';
 // Shared commander action used by both the canonical `get-booking` command
-// and its deprecated `lookup-booking` alias (JIN-663).
+// and its deprecated `lookup-booking` alias (JIN-663). The canonical flag is
+// `--booking-ref` (matches the jinko-api `booking_ref` leaf); `--ref` is kept
+// as a deprecated alias (JIN-665).
 const action = withClient(async (client, globals, opts) => {
+    const bookingRef = resolveDeprecatedFlag(opts.bookingRef, opts.ref, '--ref', '--booking-ref');
+    if (!bookingRef) {
+        console.error('Error: --booking-ref is required.');
+        process.exit(3);
+    }
     const response = await client.getBooking({
-        booking_ref: opts.ref,
+        booking_ref: bookingRef,
         last_name: opts.lastName,
     });
     output(response, { format: globals.format });
@@ -12,8 +19,9 @@ export function registerGetBookingCommand(program) {
     program
         .command('get-booking')
         .description('Retrieve a booking by Jinko reference + last name (guest access).')
-        .requiredOption('--ref <ref>', 'Jinko booking reference (e.g. JNK-A7B3X9)')
-        .requiredOption('--last-name <name>', 'Last name of the primary traveler')
+        .option('--booking-ref <ref>', 'Jinko booking reference (e.g. JNK-A7B3X9). JSON: `booking_ref`.')
+        .requiredOption('--last-name <name>', 'Last name of the primary traveler. JSON: `last_name`.')
+        .option('--ref <ref>', 'DEPRECATED: use --booking-ref.')
         .action(action);
     // Deprecated alias (JIN-663) — hidden from `--help`, emits a one-line
     // deprecation warning to stderr, then runs the same action. Remove once
@@ -21,8 +29,9 @@ export function registerGetBookingCommand(program) {
     program
         .command('lookup-booking', { hidden: true })
         .description('[DEPRECATED] Alias for `get-booking`. Use `get-booking` instead.')
-        .requiredOption('--ref <ref>', 'Jinko booking reference (e.g. JNK-A7B3X9)')
-        .requiredOption('--last-name <name>', 'Last name of the primary traveler')
+        .option('--booking-ref <ref>', 'Jinko booking reference (e.g. JNK-A7B3X9). JSON: `booking_ref`.')
+        .requiredOption('--last-name <name>', 'Last name of the primary traveler. JSON: `last_name`.')
+        .option('--ref <ref>', 'DEPRECATED: use --booking-ref.')
         .action(function deprecatedLookupBookingAction(...args) {
         // eslint-disable-next-line no-console
         console.error('[DEPRECATED] `jinko lookup-booking` is renamed to `jinko get-booking`. ' +

package/dist/commands/get-booking.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-booking.js","sourceRoot":"","sources":["../../src/commands/get-booking.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEjD,2EAA2E;AAC3E,uDAAuD;AACvD,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IACxD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;QACvC,WAAW,EAAE,IAAI,CAAC,GAAG;QACrB,SAAS,EAAE,IAAI,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,mEAAmE,CAAC;SAChF,cAAc,CAAC,aAAa,EAAE,2CAA2C,CAAC;SAC1E,cAAc,CAAC,oBAAoB,EAAE,mCAAmC,CAAC;SACzE,MAAM,CAAC,MAAM,CAAC,CAAC;IAElB,sEAAsE;IACtE,wEAAwE;IACxE,yDAAyD;IACzD,OAAO;SACJ,OAAO,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAC3C,WAAW,CAAC,kEAAkE,CAAC;SAC/E,cAAc,CAAC,aAAa,EAAE,2CAA2C,CAAC;SAC1E,cAAc,CAAC,oBAAoB,EAAE,mCAAmC,CAAC;SACzE,MAAM,CAAC,SAAS,6BAA6B,CAAgB,GAAG,IAAe;QAC9E,sCAAsC;QACtC,OAAO,CAAC,KAAK,CACX,yEAAyE;YACvE,mDAAmD,CACtD,CAAC;QACF,OAAQ,MAA6C,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"get-booking.js","sourceRoot":"","sources":["../../src/commands/get-booking.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAExE,2EAA2E;AAC3E,6EAA6E;AAC7E,8EAA8E;AAC9E,mCAAmC;AACnC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;IACxD,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;IAC9F,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;QACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC;QACvC,WAAW,EAAE,UAAU;QACvB,SAAS,EAAE,IAAI,CAAC,QAAQ;KACzB,CAAC,CAAC;IACH,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;AAC/C,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,yBAAyB,CAAC,OAAgB;IACxD,OAAO;SACJ,OAAO,CAAC,aAAa,CAAC;SACtB,WAAW,CAAC,mEAAmE,CAAC;SAChF,MAAM,CAAC,qBAAqB,EAAE,iEAAiE,CAAC;SAChG,cAAc,CAAC,oBAAoB,EAAE,uDAAuD,CAAC;SAC7F,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC;SACvD,MAAM,CAAC,MAAM,CAAC,CAAC;IAElB,sEAAsE;IACtE,wEAAwE;IACxE,yDAAyD;IACzD,OAAO;SACJ,OAAO,CAAC,gBAAgB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAC3C,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC,qBAAqB,EAAE,iEAAiE,CAAC;SAChG,cAAc,CAAC,oBAAoB,EAAE,uDAAuD,CAAC;SAC7F,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC;SACvD,MAAM,CAAC,SAAS,6BAA6B,CAAgB,GAAG,IAAe;QAC9E,sCAAsC;QACtC,OAAO,CAAC,KAAK,CACX,yEAAyE;YACvE,mDAAmD,CACtD,CAAC;QACF,OAAQ,MAA6C,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1E,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/commands/hotel-cancel.d.ts

@@ -3,14 +3,16 @@ import { Command } from 'commander';
  * `gojinko hotel-cancel` — hotel cancellation, idempotent.
  *
  * Dual-auth (JIN-281, mirrors flight_refund):
- *   - Guest:         --ref + --last-name (must be provided together)
+ *   - Guest:         --booking-ref + --last-name (must be provided together)
  *   - Authenticated: --provider-booking-id [+ --provider]
  *
  * The two modes are mutually exclusive at the BFF. Idempotent: the BFF
  * persists the cancellation result and re-serves the stored response on
  * subsequent calls (with `idempotent: true`). Safe to retry.
  *
- * Wraps BFF POST /api/v1/hotels/cancel-booking.
+ * Wraps jinko-api POST /v1/hotel_cancel. The canonical guest flag is
+ * `--booking-ref` (matches the `booking_ref` leaf); `--ref` is kept as a
+ * deprecated alias (JIN-665).
  */
 export declare function registerHotelCancelCommand(program: Command): void;
 //# sourceMappingURL=hotel-cancel.d.ts.map

package/dist/commands/hotel-cancel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotel-cancel.d.ts","sourceRoot":"","sources":["../../src/commands/hotel-cancel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA8CjE"}
+{"version":3,"file":"hotel-cancel.d.ts","sourceRoot":"","sources":["../../src/commands/hotel-cancel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAgDjE"}

package/dist/commands/hotel-cancel.js

@@ -1,43 +1,47 @@
-import { withClient, output } from './shared.js';
+import { withClient, output, resolveDeprecatedFlag } from './shared.js';
 /**
  * `gojinko hotel-cancel` — hotel cancellation, idempotent.
  *
  * Dual-auth (JIN-281, mirrors flight_refund):
- *   - Guest:         --ref + --last-name (must be provided together)
+ *   - Guest:         --booking-ref + --last-name (must be provided together)
  *   - Authenticated: --provider-booking-id [+ --provider]
  *
  * The two modes are mutually exclusive at the BFF. Idempotent: the BFF
  * persists the cancellation result and re-serves the stored response on
  * subsequent calls (with `idempotent: true`). Safe to retry.
  *
- * Wraps BFF POST /api/v1/hotels/cancel-booking.
+ * Wraps jinko-api POST /v1/hotel_cancel. The canonical guest flag is
+ * `--booking-ref` (matches the `booking_ref` leaf); `--ref` is kept as a
+ * deprecated alias (JIN-665).
  */
 export function registerHotelCancelCommand(program) {
     program
         .command('hotel-cancel')
-        .description('Cancel a hotel booking. Idempotent — safe to retry. Use either guest auth (--ref + --last-name) OR the authenticated shortcut (--provider-booking-id).')
-        .option('--ref <ref>', 'Jinko booking reference (e.g. JNK-A7B3X9). Guest path — pair with --last-name.')
-        .option('--last-name <name>', 'Last name of the lead guest. Guest path — pair with --ref.')
-        .option('--provider-booking-id <id>', 'Provider booking ID (authenticated shortcut). Mutually exclusive with --ref + --last-name.')
-        .option('--provider <code>', 'Provider code (e.g. "nuitee"). Optional, only meaningful with --provider-booking-id.')
+        .description('Cancel a hotel booking. Idempotent — safe to retry. Use either guest auth (--booking-ref + --last-name) OR the authenticated shortcut (--provider-booking-id).')
+        .option('--booking-ref <ref>', 'Jinko booking reference (e.g. JNK-A7B3X9). Guest path — pair with --last-name. JSON: `booking_ref`.')
+        .option('--last-name <name>', 'Last name of the lead guest. Guest path — pair with --booking-ref. JSON: `last_name`.')
+        .option('--provider-booking-id <id>', 'Provider booking ID (authenticated shortcut). Mutually exclusive with --booking-ref + --last-name. JSON: `provider_booking_id`.')
+        .option('--provider <code>', 'Provider code (e.g. "nuitee"). Optional, only meaningful with --provider-booking-id. JSON: `provider`.')
+        .option('--ref <ref>', 'DEPRECATED: use --booking-ref.')
         .action(withClient(async (client, globals, opts) => {
-        const hasGuest = Boolean(opts.ref) && Boolean(opts.lastName);
-        const guestPartial = (Boolean(opts.ref) && !opts.lastName) || (!opts.ref && Boolean(opts.lastName));
+        const bookingRef = resolveDeprecatedFlag(opts.bookingRef, opts.ref, '--ref', '--booking-ref');
+        const hasGuest = Boolean(bookingRef) && Boolean(opts.lastName);
+        const guestPartial = (Boolean(bookingRef) && !opts.lastName) || (!bookingRef && Boolean(opts.lastName));
         const hasProviderId = Boolean(opts.providerBookingId);
         if (guestPartial) {
-            console.error('Error: --ref and --last-name must be provided together.');
+            console.error('Error: --booking-ref and --last-name must be provided together.');
             process.exit(3);
         }
         if (hasGuest && hasProviderId) {
-            console.error('Error: --ref + --last-name and --provider-booking-id are mutually exclusive. Pass one mode.');
+            console.error('Error: --booking-ref + --last-name and --provider-booking-id are mutually exclusive. Pass one mode.');
             process.exit(3);
         }
         if (!hasGuest && !hasProviderId) {
-            console.error('Error: provide either --ref + --last-name (guest) or --provider-booking-id (authenticated).');
+            console.error('Error: provide either --booking-ref + --last-name (guest) or --provider-booking-id (authenticated).');
             process.exit(3);
         }
         const response = await client.hotelCancelBooking({
-            booking_ref: opts.ref,
+            booking_ref: bookingRef,
             last_name: opts.lastName,
             provider_booking_id: opts.providerBookingId,
             provider: opts.provider,

package/dist/commands/hotel-cancel.js.map

@@ -1 +1 @@
-{"version":3,"file":"hotel-cancel.js","sourceRoot":"","sources":["../../src/commands/hotel-cancel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAEjD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CACV,wJAAwJ,CACzJ;SACA,MAAM,CAAC,aAAa,EAAE,gFAAgF,CAAC;SACvG,MAAM,CAAC,oBAAoB,EAAE,4DAA4D,CAAC;SAC1F,MAAM,CACL,4BAA4B,EAC5B,4FAA4F,CAC7F;SACA,MAAM,CAAC,mBAAmB,EAAE,sFAAsF,CAAC;SACnH,MAAM,CACL,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7D,MAAM,YAAY,GAChB,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjF,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEtD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;YACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,QAAQ,IAAI,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CACX,6FAA6F,CAC9F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CACX,6FAA6F,CAC9F,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC;YAC/C,WAAW,EAAE,IAAI,CAAC,GAAG;YACrB,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;YAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}
+{"version":3,"file":"hotel-cancel.js","sourceRoot":"","sources":["../../src/commands/hotel-cancel.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAExE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,OAAO;SACJ,OAAO,CAAC,cAAc,CAAC;SACvB,WAAW,CACV,gKAAgK,CACjK;SACA,MAAM,CAAC,qBAAqB,EAAE,qGAAqG,CAAC;SACpI,MAAM,CAAC,oBAAoB,EAAE,uFAAuF,CAAC;SACrH,MAAM,CACL,4BAA4B,EAC5B,iIAAiI,CAClI;SACA,MAAM,CAAC,mBAAmB,EAAE,wGAAwG,CAAC;SACrI,MAAM,CAAC,aAAa,EAAE,gCAAgC,CAAC;SACvD,MAAM,CACL,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE;QACzC,MAAM,UAAU,GAAG,qBAAqB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC;QAC9F,MAAM,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/D,MAAM,YAAY,GAChB,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;QACrF,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAEtD,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;YACjF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,QAAQ,IAAI,aAAa,EAAE,CAAC;YAC9B,OAAO,CAAC,KAAK,CACX,qGAAqG,CACtG,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,QAAQ,IAAI,CAAC,aAAa,EAAE,CAAC;YAChC,OAAO,CAAC,KAAK,CACX,qGAAqG,CACtG,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC;YAC/C,WAAW,EAAE,UAAU;YACvB,SAAS,EAAE,IAAI,CAAC,QAAQ;YACxB,mBAAmB,EAAE,IAAI,CAAC,iBAAiB;YAC3C,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/C,CAAC,CAAC,CACH,CAAC;AACN,CAAC"}

package/dist/commands/hotel-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hotel-search.d.ts","sourceRoot":"","sources":["../../src/commands/hotel-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAoEpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6GjE"}
+{"version":3,"file":"hotel-search.d.ts","sourceRoot":"","sources":["../../src/commands/hotel-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwEpC,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAiIjE"}

package/dist/commands/hotel-search.js

@@ -1,5 +1,5 @@
 import chalk from 'chalk';
-import { withClient, output } from './shared.js';
+import { withClient, output, resolveDeprecatedFlag } from './shared.js';
 function isLowConfidenceError(body) {
     if (!body || typeof body !== 'object')
         return false;
@@ -33,43 +33,61 @@ function formatLowConfidenceError(body, format) {
         console.error(`  ${chalk.cyan('destination=')}${dest}`);
     }
     else {
-        console.error(chalk.dim('No suggested_retry — provide --city and --country to narrow the lookup, or try a different name.'));
+        console.error(chalk.dim('No suggested_retry — provide --city-name and --country-code to narrow the lookup, or try a different name.'));
     }
 }
 export function registerHotelSearchCommand(program) {
     program
         .command('hotel-search')
         .description('Search live hotel inventory and rates by destination, dates, and occupancy.')
-        .option('--query <text>', 'free-text destination (city, region, POI) — Mode B')
-        .option('--city <name>', 'city name (e.g. "Paris") — Mode B destination, or Mode A lookup scope when combined with --hotel-name')
-        .option('--country <code>', 'ISO 3166-1 alpha-2 country code (e.g. fr) — Mode B destination, or Mode A lookup scope when combined with --hotel-name')
-        .option('--lat <latitude>', 'latitude for geo-radius search — Mode B')
-        .option('--lng <longitude>', 'longitude for geo-radius search — Mode B')
-        .option('--radius <km>', 'search radius in km (default 5, max 50) — Mode B')
-        .option('--place-id <id>', 'Google Places ID or upstream place identifier — Mode B')
-        .option('--hotel-ids <ids...>', 're-shop specific hotel IDs — Mode A')
-        .option('--hotel-name <name>', 'look up a specific hotel by name — Mode A. Pair with --city and --country to narrow the lookup scope.')
-        .option('--checkin <date>', 'check-in date (YYYY-MM-DD)', undefined)
-        .option('--checkout <date>', 'check-out date (YYYY-MM-DD)', undefined)
-        .option('--adults <n>', 'number of adults (shorthand)', '2')
-        .option('--children <ages...>', 'children ages (shorthand, e.g. 5 7)')
-        .option('--rooms <n>', 'number of rooms (shorthand)')
-        .option('--currency <code>', 'ISO 4217 currency code (default USD)')
-        .option('--nationality <code>', 'guest nationality (ISO 3166-1 alpha-2)')
-        .option('--min-rating <n>', 'minimum guest review rating (0-10)')
-        .option('--stars <n>', 'minimum star rating (1-5)')
-        .option('--max-stars <n>', 'maximum star rating (1-5)')
-        .option('--min-reviews <n>', 'minimum number of reviews')
-        .option('--max-results <n>', 'maximum hotels to return (default 50)')
+        .option('--query <text>', 'free-text destination (city, region, POI) — Mode B. JSON: `query`.')
+        .option('--city-name <name>', 'city name (e.g. "Paris") — Mode B destination, or Mode A lookup scope when combined with --hotel-name. JSON: `city_name`.')
+        .option('--country-code <code>', 'ISO 3166-1 alpha-2 country code (e.g. fr) — Mode B destination, or Mode A lookup scope when combined with --hotel-name. JSON: `country_code`.')
+        .option('--latitude <latitude>', 'latitude for geo-radius search — Mode B. JSON: `latitude`.')
+        .option('--longitude <longitude>', 'longitude for geo-radius search — Mode B. JSON: `longitude`.')
+        .option('--radius-km <km>', 'search radius in km (default 5, max 50) — Mode B. JSON: `radius_km`.')
+        .option('--place-id <id>', 'Google Places ID or upstream place identifier — Mode B. JSON: `place_id`.')
+        .option('--hotel-ids <ids...>', 're-shop specific hotel IDs — Mode A. JSON: `hotel_ids`.')
+        .option('--hotel-name <name>', 'look up a specific hotel by name — Mode A. Pair with --city-name and --country-code to narrow the lookup scope.')
+        .option('--checkin <date>', 'check-in date (YYYY-MM-DD). JSON: `checkin`.', undefined)
+        .option('--checkout <date>', 'check-out date (YYYY-MM-DD). JSON: `checkout`.', undefined)
+        .option('--adults <n>', 'number of adults (shorthand). JSON: `adults`.', '2')
+        .option('--children <ages...>', 'children ages (shorthand, e.g. 5 7). JSON: `children`.')
+        .option('--rooms <n>', 'number of rooms (shorthand). JSON: `rooms`.')
+        .option('--currency <code>', 'ISO 4217 currency code (default USD). JSON: `currency`.')
+        .option('--guest-nationality <code>', 'guest nationality (ISO 3166-1 alpha-2). JSON: `guest_nationality`.')
+        .option('--min-rating <n>', 'minimum guest review rating (0-10). JSON: `min_rating`.')
+        .option('--star-rating <n>', 'minimum star rating (1-5). JSON: `min_star_rating`.')
+        .option('--max-star-rating <n>', 'maximum star rating (1-5). JSON: `max_star_rating`.')
+        .option('--min-reviews <n>', 'minimum number of reviews. JSON: `min_reviews`.')
+        .option('--max-results <n>', 'maximum hotels to return (default 50). JSON: `max_results`.')
+        // Deprecated aliases — Phase 1 transition (JIN-665), remove in next major.
+        .option('--city <name>', 'DEPRECATED: use --city-name.')
+        .option('--country <code>', 'DEPRECATED: use --country-code.')
+        .option('--lat <latitude>', 'DEPRECATED: use --latitude.')
+        .option('--lng <longitude>', 'DEPRECATED: use --longitude.')
+        .option('--radius <km>', 'DEPRECATED: use --radius-km.')
+        .option('--nationality <code>', 'DEPRECATED: use --guest-nationality.')
+        .option('--stars <n>', 'DEPRECATED: use --star-rating.')
+        .option('--max-stars <n>', 'DEPRECATED: use --max-star-rating.')
         .action(withClient(async (client, globals, opts) => {
+        // Resolve deprecated aliases onto canonical flags.
+        const cityName = resolveDeprecatedFlag(opts.cityName, opts.city, '--city', '--city-name');
+        const countryCode = resolveDeprecatedFlag(opts.countryCode, opts.country, '--country', '--country-code');
+        const latitude = resolveDeprecatedFlag(opts.latitude, opts.lat, '--lat', '--latitude');
+        const longitude = resolveDeprecatedFlag(opts.longitude, opts.lng, '--lng', '--longitude');
+        const radiusKm = resolveDeprecatedFlag(opts.radiusKm, opts.radius, '--radius', '--radius-km');
+        const guestNationality = resolveDeprecatedFlag(opts.guestNationality, opts.nationality, '--nationality', '--guest-nationality');
+        const starRating = resolveDeprecatedFlag(opts.starRating, opts.stars, '--stars', '--star-rating');
+        const maxStarRating = resolveDeprecatedFlag(opts.maxStarRating, opts.maxStars, '--max-stars', '--max-star-rating');
         if (!opts.checkin || !opts.checkout) {
             console.error('Error: --checkin and --checkout are required.');
             process.exit(3);
         }
-        const hasDestination = opts.query || opts.city || opts.lat || opts.placeId || opts.hotelIds || opts.hotelName;
+        const hasDestination = opts.query || cityName || latitude || opts.placeId || opts.hotelIds || opts.hotelName;
         if (!hasDestination) {
-            console.error('Error: provide a destination — Mode A: --hotel-name (optionally + --city/--country) or --hotel-ids; ' +
-                'Mode B: --query, --city, --lat+--lng, or --place-id.');
+            console.error('Error: provide a destination — Mode A: --hotel-name (optionally + --city-name/--country-code) or --hotel-ids; ' +
+                'Mode B: --query, --city-name, --latitude+--longitude, or --place-id.');
             process.exit(3);
         }
         // Mode A signal: --hotel-name or --hotel-ids. In Mode A the server
@@ -77,9 +95,9 @@ export function registerHotelSearchCommand(program) {
         // happen (server-side behavior is lenient-with-warnings for now per
         // JIN-639 Phase 4 plan; may become a 422 in a future version).
         const isModeA = Boolean(opts.hotelName || opts.hotelIds);
-        const hasFilters = Boolean(opts.minRating || opts.stars || opts.maxStars || opts.minReviews || opts.maxResults);
+        const hasFilters = Boolean(opts.minRating || starRating || maxStarRating || opts.minReviews || opts.maxResults);
         if (isModeA && hasFilters) {
-            console.warn('Warning: filters (--min-rating / --stars / --max-stars / --min-reviews / --max-results) ' +
+            console.warn('Warning: filters (--min-rating / --star-rating / --max-star-rating / --min-reviews / --max-results) ' +
                 'are ignored when --hotel-name or --hotel-ids is set (rate-lookup mode). ' +
                 'The server will return a warnings entry in the response.');
         }
@@ -91,16 +109,16 @@ export function registerHotelSearchCommand(program) {
         // Destination
         if (opts.query)
             body.query = opts.query;
-        if (opts.city)
-            body.city_name = opts.city;
-        if (opts.country)
-            body.country_code = opts.country;
-        if (opts.lat)
-            body.latitude = Number(opts.lat);
-        if (opts.lng)
-            body.longitude = Number(opts.lng);
-        if (opts.radius)
-            body.radius_km = Number(opts.radius);
+        if (cityName)
+            body.city_name = cityName;
+        if (countryCode)
+            body.country_code = countryCode;
+        if (latitude)
+            body.latitude = Number(latitude);
+        if (longitude)
+            body.longitude = Number(longitude);
+        if (radiusKm)
+            body.radius_km = Number(radiusKm);
         if (opts.placeId)
             body.place_id = opts.placeId;
         if (opts.hotelIds)
@@ -115,20 +133,21 @@ export function registerHotelSearchCommand(program) {
         // Context
         if (opts.currency)
             body.currency = opts.currency;
-        if (opts.nationality)
-            body.guest_nationality = opts.nationality;
-        // Filters (Mode B only — Mode A warned above)
+        if (guestNationality)
+            body.guest_nationality = guestNationality;
+        // Filters (Mode B only — Mode A warned above). `--star-rating` maps to
+        // the canonical `min_star_rating` leaf (minimum-stars semantics).
         if (opts.minRating)
             body.min_rating = Number(opts.minRating);
-        if (opts.stars)
-            body.min_star_rating = Number(opts.stars);
-        if (opts.maxStars)
-            body.max_star_rating = Number(opts.maxStars);
+        if (starRating)
+            body.min_star_rating = Number(starRating);
+        if (maxStarRating)
+            body.max_star_rating = Number(maxStarRating);
         if (opts.minReviews)
             body.min_reviews = Number(opts.minReviews);
         if (opts.maxResults)
             body.max_results = Number(opts.maxResults);
-        const response = await client.raw.POST('/api/v1/hotels/shop', {
+        const response = await client.raw.POST('/v1/hotel_search', {
             body,
         });
         // 422 HOTEL_NAME_LOW_CONFIDENCE is actionable, not fatal — pretty-print