@agenzo/merchant-cli 0.8.7 → 0.8.9

package/dist/index.js

@@ -861,6 +861,22 @@ var PromptEngine = class {
   }
 };
 
+// src/member.ts
+var MEMBER_OPTION_DESCRIPTION = "End-user member id this order is attributed to (optional, max 128 chars). On write it is stored on the order; on list it filters to that member only (orders without a member_id are excluded).";
+var MEMBER_FLAG_SCHEMA = {
+  type: "string",
+  required: false,
+  source: "session",
+  description: MEMBER_OPTION_DESCRIPTION,
+  constraints: "1-128 characters; any character set. Omit to keep the order unattributed."
+};
+function memberIdOf(opts) {
+  const raw = opts.member;
+  if (typeof raw !== "string") return void 0;
+  const trimmed = raw.trim();
+  return trimmed.length > 0 ? trimmed : void 0;
+}
+
 // src/ride-elife/watch.ts
 var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
   "At destination",
@@ -1026,6 +1042,12 @@ var bookSchema = {
       required: "conditional",
       description: "Required when billing_mode=pay_per_call (a PAID payment order). Forbidden when billing_mode=monthly_settlement"
     },
+    "payment-method-id": {
+      type: "string",
+      required: false,
+      description: "Bound payment method id to charge (pay_per_call only). Opaque id from `token payment-methods list`; ignored for monthly_settlement"
+    },
+    member: MEMBER_FLAG_SCHEMA,
     "passenger-name": { type: "string", required: true, description: "Passenger full name" },
     "passenger-phone": { type: "string", required: true, description: "Passenger phone in E.164 format (e.g. +14155551234)" },
     "passenger-email": { type: "string", required: true, description: "Passenger email (required by eLife for booking)" },
@@ -1168,6 +1190,7 @@ var listOrdersSchema = {
   flags: {
     status: { type: "string", required: false, description: "Filter by ride status (case-sensitive server casing)" },
     "order-type": { type: "string", required: false, description: "Filter by order type (e.g. realtime / airport)" },
+    member: MEMBER_FLAG_SCHEMA,
     page: { type: "int", required: false, default: 1, description: "Page number", constraints: ">= 1" },
     "page-size": { type: "int", required: false, default: 20, description: "Items per page", constraints: ">= 1" }
   },
@@ -1177,6 +1200,7 @@ var listOrdersSchema = {
       description: "List of ride orders (slim list-item shape)",
       items: {
         order_id: { type: "string", description: "Internal order id" },
+        member_id: { type: "string|null", description: "End-user this order is attributed to; null when unattributed" },
         ride_id: { type: "string", description: "Ride id (same as ride_id from book)" },
         status: { type: "string", description: "Current ride status" },
         vehicle_class: { type: "string", description: "Vehicle class" },
@@ -1345,6 +1369,7 @@ var hotelCreateOrderSchema = {
     "contact-phone": { type: "string", required: true, description: "Booking contact phone number", constraints: "Digits; collect country code separately in --contact-country-code" },
     "contact-country-code": { type: "string", required: false, default: "86", description: "Phone country calling code without '+'" },
     "contact-email": { type: "string", required: false, description: "Booking contact email" },
+    member: MEMBER_FLAG_SCHEMA,
     "arrive-time": { type: "string", required: false, description: "Expected arrival time", constraints: "HH:mm, hotel local time" },
     "special-requests": { type: "string", required: false, description: "Free-text special requests (non-binding)" },
     tips: { type: "string", required: false, description: "FCG \u5BA2\u6237\u81EA\u6D4B\u70B95 \u63D0\u793A\u4FE1\u606F: the chosen quote rate's tips (tips[].tipsDetails[]) as a JSON array [{title,text}], captured at booking. Stored on the order for the order-detail page only; platform-local, not sent upstream", constraints: "JSON array of {title (string, optional), text (string, optional)}; else PARAM_INVALID" },
@@ -1622,6 +1647,7 @@ var hotelListOrdersSchema = {
   description: "List the developer's hotel orders with optional status filtering and pagination",
   flags: {
     status: { type: "string", required: false, description: "Filter by order status (e.g. PROCESSING / CONFIRMED / CANCELLED / COMPLETED). Omitted entirely when absent (all statuses)" },
+    member: MEMBER_FLAG_SCHEMA,
     page: { type: "int", required: false, default: 1, description: "Page number", constraints: ">= 1" },
     "page-size": { type: "int", required: false, default: 20, description: "Items per page", constraints: ">= 1 (platform caps at 100 server-side)" }
   },
@@ -1631,6 +1657,7 @@ var hotelListOrdersSchema = {
       description: "List of hotel orders (slim list-item shape).",
       items: {
         order_id: { type: "string", description: "Our order reference." },
+        member_id: { type: "string|null", description: "End-user this order is attributed to; null when unattributed" },
         fc_order_code: { type: "string", description: "Supplier order reference." },
         status: { type: "string", description: "Current order status (string)." },
         provider: { type: "string", description: "Service provider ('redaug')." },
@@ -1908,6 +1935,7 @@ var unifiedOrdersListSchema = {
   description: 'List orders across ALL providers (ride + hotel) in one call. Use this for generic "my orders" / "order history" requests. Prefer ride-elife/hotel-redaug list-orders when the user names a specific business.',
   flags: {
     "order-type": { type: "string", required: false, description: "Filter by provider: ride | hotel" },
+    member: MEMBER_FLAG_SCHEMA,
     status: { type: "string", required: false, description: "Filter by NORMALIZED status (NOT the domain-specific status): PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED" },
     page: { type: "int", required: false, default: 1, description: "Page number", constraints: ">= 1" },
     "page-size": { type: "int", required: false, default: 20, description: "Items per page", constraints: ">= 1" }
@@ -1918,6 +1946,7 @@ var unifiedOrdersListSchema = {
       description: "Slim cross-provider order-index items. For business-specific fields (vehicle_class, hotel_name, etc.), call `orders get --order-id <id>` or the domain-specific `get`.",
       items: {
         order_id: { type: "string", description: "Order id (rio_... for ride, hho_... for hotel). Pass to `orders get`." },
+        member_id: { type: "string|null", description: "End-user this order is attributed to; null when unattributed" },
         order_type: { type: "string", description: "'ride' or 'hotel'" },
         status: { type: "string", description: "Normalized status: PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED" },
         amount: { type: "float|null", description: "Order amount in DECIMAL currency units (NOT cents)" },
@@ -2055,6 +2084,7 @@ var flightCreateOrderSchema = flightSchema(
     "contact-phone": { type: "string", required: true, description: "Contact phone." },
     "contact-email": { type: "string", required: true, description: "Contact email." },
     passengers: { type: "json", required: true, description: 'JSON array of passengers. gender/id_type are STRINGS ("1"/"2"). child/infant require adult_passenger_name.' },
+    member: MEMBER_FLAG_SCHEMA,
     "idempotency-key": { type: "string", required: true, description: "Forwarded verbatim as the Idempotency-Key header." }
   },
   {
@@ -2122,10 +2152,11 @@ var flightListOrdersSchema = flightSchema(
   "List the developer's flight orders (local read, no upstream call).",
   {
     status: { type: "string", required: false, description: "Optional status filter." },
+    member: MEMBER_FLAG_SCHEMA,
     page: { type: "int", required: false, default: 1, description: "1-based page." },
     "page-size": { type: "int", required: false, default: 20, description: "Items per page (1-100)." }
   },
-  { orders: { type: "array", description: "Flight order summaries." }, total: { type: "int", description: "Total count." } },
+  { orders: { type: "array", description: "Flight order summaries; each item carries member_id (null when unattributed)." }, total: { type: "int", description: "Total count." } },
   { command: "agenzo-merchant-cli flight-flink list-orders", output_summary: "Paged flight orders." }
 );
 var flightChangeSearchSchema = flightSchema(
@@ -2416,7 +2447,10 @@ function formatBook(data) {
   return Formatter.keyValue(lines);
 }
 function registerBookCommand(parent, deps) {
-  const cmd = parent.command("book").description("Book a ride using a quote_id returned by quote").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--quote-id <id>", "Quote id from `ride-elife quote`").option("--vehicle-class <class>", "Chosen vehicle class").option("--price-amount <amount>", "Fare in decimal currency units (not cents)").option("--price-currency <currency>", "Currency code (default USD)").option("--payment-order-id <id>", "Paid payment order id (pay_per_call mode only)").option("--passenger-name <name>", "Passenger full name").option("--passenger-phone <phone>", "Passenger phone").option("--passenger-email <email>", "Passenger email").option("--luggage-count <n>", "Luggage count").option("--special-requests <text>", "Free-text special requests").option("--pickup-lat <lat>", "Pickup latitude").option("--pickup-lng <lng>", "Pickup longitude").option("--pickup-name <name>", "Pickup location name").option("--dropoff-lat <lat>", "Dropoff latitude").option("--dropoff-lng <lng>", "Dropoff longitude").option("--dropoff-name <name>", "Dropoff location name").option("--pickup-time <time>", 'Pickup time: epoch seconds, or "now"').option("--meet-and-greet", "Enable meet & greet service").option("--meet-and-greet-price <amount>", "Meet & greet surcharge").option("--welcome-sign <text>", "Welcome sign text").option("--child-seat-count <n>", "Number of child seats needed (0-5)").option("--infant-seat-count <n>", "Number of infant seats needed (0-5)").option("--toddler-seat-count <n>", "Number of toddler seats needed (0-5)").option("--arrival-flight-no <no>", "Arrival flight number").option("--arrival-airline <airline>", "Arrival airline").option("--departure-flight-no <no>", "Departure flight number").option("--departure-airline <airline>", "Departure airline").option(
+  const cmd = parent.command("book").description("Book a ride using a quote_id returned by quote").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--quote-id <id>", "Quote id from `ride-elife quote`").option("--vehicle-class <class>", "Chosen vehicle class").option("--price-amount <amount>", "Fare in decimal currency units (not cents)").option("--price-currency <currency>", "Currency code (default USD)").option("--payment-order-id <id>", "Paid payment order id (pay_per_call mode only)").option(
+    "--payment-method-id <id>",
+    "Bound payment method id to charge (pay_per_call mode only)"
+  ).option("--passenger-name <name>", "Passenger full name").option("--passenger-phone <phone>", "Passenger phone").option("--passenger-email <email>", "Passenger email").option("--luggage-count <n>", "Luggage count").option("--special-requests <text>", "Free-text special requests").option("--pickup-lat <lat>", "Pickup latitude").option("--pickup-lng <lng>", "Pickup longitude").option("--pickup-name <name>", "Pickup location name").option("--dropoff-lat <lat>", "Dropoff latitude").option("--dropoff-lng <lng>", "Dropoff longitude").option("--dropoff-name <name>", "Dropoff location name").option("--pickup-time <time>", 'Pickup time: epoch seconds, or "now"').option("--meet-and-greet", "Enable meet & greet service").option("--meet-and-greet-price <amount>", "Meet & greet surcharge").option("--welcome-sign <text>", "Welcome sign text").option("--child-seat-count <n>", "Number of child seats needed (0-5)").option("--infant-seat-count <n>", "Number of infant seats needed (0-5)").option("--toddler-seat-count <n>", "Number of toddler seats needed (0-5)").option("--arrival-flight-no <no>", "Arrival flight number").option("--arrival-airline <airline>", "Arrival airline").option("--departure-flight-no <no>", "Departure flight number").option("--departure-airline <airline>", "Departure airline").option("--member <id>", MEMBER_OPTION_DESCRIPTION).option(
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header"
   );
@@ -2439,6 +2473,9 @@ function registerBookCommand(parent, deps) {
       passenger_phone: phone(opts.passengerPhone, "passenger-phone")
     };
     if (opts.paymentOrderId) body.payment_order_id = opts.paymentOrderId;
+    if (opts.paymentMethodId) body.payment_method_id = opts.paymentMethodId;
+    const member = memberIdOf(opts);
+    if (member !== void 0) body.member_id = member;
     if (opts.passengerEmail) body.passenger_email = opts.passengerEmail;
     if (opts.luggageCount !== void 0) {
       body.luggage_count = num2(opts.luggageCount, "luggage-count");
@@ -2721,7 +2758,7 @@ function formatOrders(data) {
 ${Formatter.keyValue(summary)}`;
 }
 function registerListOrdersCommand(parent, deps) {
-  const cmd = parent.command("list-orders").description("List previously placed ride orders").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--page <page>", "Page number", DEFAULT_PAGE).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE).option("--status <status>", "Filter by order status").option("--order-type <type>", "Filter by order type");
+  const cmd = parent.command("list-orders").description("List previously placed ride orders").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--page <page>", "Page number", DEFAULT_PAGE).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE).option("--status <status>", "Filter by order status").option("--order-type <type>", "Filter by order type").option("--member <id>", MEMBER_OPTION_DESCRIPTION);
   attachSchemaHelp(cmd, listOrdersSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -2736,6 +2773,8 @@ function registerListOrdersCommand(parent, deps) {
     };
     if (opts.status !== void 0) params.status = opts.status;
     if (opts.orderType !== void 0) params.order_type = opts.orderType;
+    const member = memberIdOf(opts);
+    if (member !== void 0) params.member_id = member;
     const spinner = format === "json" ? null : createSpinner("Fetching orders...");
     const result = await deps.apiClient.get(
       "/ride/orders",
@@ -3114,7 +3153,7 @@ function formatOrders2(data) {
 ${Formatter.keyValue(summary)}`;
 }
 function registerOrdersListCommand(parent, deps) {
-  const cmd = parent.command("list").description("List orders across ALL providers (ride + hotel), with optional type/status filters").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-type <type>", "Filter by order type: ride | hotel").option("--status <status>", "Filter by normalized status: PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED").option("--page <page>", "Page number", DEFAULT_PAGE2).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE2);
+  const cmd = parent.command("list").description("List orders across ALL providers (ride + hotel), with optional type/status filters").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-type <type>", "Filter by order type: ride | hotel").option("--status <status>", "Filter by normalized status: PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED").option("--page <page>", "Page number", DEFAULT_PAGE2).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE2).option("--member <id>", MEMBER_OPTION_DESCRIPTION);
   attachSchemaHelp(cmd, unifiedOrdersListSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -3129,6 +3168,8 @@ function registerOrdersListCommand(parent, deps) {
     };
     if (opts.orderType !== void 0) params.order_type = opts.orderType;
     if (opts.status !== void 0) params.status = opts.status;
+    const member = memberIdOf(opts);
+    if (member !== void 0) params.member_id = member;
     const spinner = format === "json" ? null : createSpinner("Fetching orders...");
     const result = await deps.apiClient.get(
       "/orders",
@@ -3541,7 +3582,7 @@ function registerHotelCreateOrderCommand(parent, deps) {
   ).option(
     "--payment-token-id <id>",
     "UPI Agent Pay: payment token id from an already-completed UnionPay network-token capture. When set, the platform skips EVO preauth/capture and only locks the order + records this credential (funds already charged)."
-  ).option(
+  ).option("--member <id>", MEMBER_OPTION_DESCRIPTION).option(
     "--idempotency-key <key>",
     "Idempotency key forwarded verbatim as the Idempotency-Key header"
   );
@@ -3592,6 +3633,8 @@ function registerHotelCreateOrderCommand(parent, deps) {
     if (opts.bedType !== void 0) body.bed_type = opts.bedType;
     if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
     if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
+    const member = memberIdOf(opts);
+    if (member !== void 0) body.member_id = member;
     if (!isYes) {
       const chargeNote = opts.paymentTokenId !== void 0 ? "Payment has already been captured via UPI Agent Pay; this only locks the room." : "This locks the rate but does NOT charge anything yet.";
       const confirmed = await confirm3({
@@ -4286,7 +4329,7 @@ function formatOrders3(data) {
 ${Formatter.keyValue(summary)}`;
 }
 function registerHotelListOrdersCommand(parent, deps) {
-  const cmd = parent.command("list-orders").description("List the developer's hotel orders with optional status filtering and pagination").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--status <status>", "Filter by order status (omitted entirely when absent \u2192 all statuses)").option("--page <page>", "Page number", DEFAULT_PAGE3).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE3);
+  const cmd = parent.command("list-orders").description("List the developer's hotel orders with optional status filtering and pagination").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--status <status>", "Filter by order status (omitted entirely when absent \u2192 all statuses)").option("--page <page>", "Page number", DEFAULT_PAGE3).option("--page-size <size>", "Page size", DEFAULT_PAGE_SIZE3).option("--member <id>", MEMBER_OPTION_DESCRIPTION);
   attachSchemaHelp(cmd, hotelListOrdersSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -4300,6 +4343,8 @@ function registerHotelListOrdersCommand(parent, deps) {
       page_size: positiveInt4(opts.pageSize ?? DEFAULT_PAGE_SIZE3, "page-size")
     };
     if (opts.status !== void 0) params.status = opts.status;
+    const member = memberIdOf(opts);
+    if (member !== void 0) params.member_id = member;
     const spinner = format === "json" ? null : createSpinner("Fetching orders...");
     const result = await deps.apiClient.get(
       "/hotel/orders",
@@ -5115,7 +5160,7 @@ function registerVerifyCommand(parent, deps) {
 // src/flight-flink/create-order.ts
 import { confirm as confirm6 } from "@inquirer/prompts";
 function registerCreateOrderCommand(parent, deps) {
-  const cmd = parent.command("create-order").description("Create a flight order without charging (locks the fare, await payment)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Authoritative rate token from verify").option("--total-amount <amount>", "Verified total price in decimal units").option("--currency <currency>", "ISO 4217 currency code").option("--trip-type <n>", "1/2/3", "1").option("--contact-name <name>", "Booking contact name").option("--contact-region <code>", "Contact phone country code (no '+')").option("--contact-phone <phone>", "Booking contact phone").option("--contact-email <email>", "Booking contact email").option("--passengers <json>", "JSON array of passengers (gender/id_type are strings)").option("--payment-method-id <id>", "Optional bound-card id (pay_per_call only)").option("--payment-token-id <id>", "Optional UPI network-token id (unionpay charge path)").option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
+  const cmd = parent.command("create-order").description("Create a flight order without charging (locks the fare, await payment)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--product-token <token>", "Authoritative rate token from verify").option("--total-amount <amount>", "Verified total price in decimal units").option("--currency <currency>", "ISO 4217 currency code").option("--trip-type <n>", "1/2/3", "1").option("--contact-name <name>", "Booking contact name").option("--contact-region <code>", "Contact phone country code (no '+')").option("--contact-phone <phone>", "Booking contact phone").option("--contact-email <email>", "Booking contact email").option("--passengers <json>", "JSON array of passengers (gender/id_type are strings)").option("--payment-method-id <id>", "Optional bound-card id (pay_per_call only)").option("--payment-token-id <id>", "Optional UPI network-token id (unionpay charge path)").option("--member <id>", MEMBER_OPTION_DESCRIPTION).option("--idempotency-key <key>", "Forwarded verbatim as the Idempotency-Key header");
   attachSchemaHelp(cmd, flightCreateOrderSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -5138,6 +5183,8 @@ function registerCreateOrderCommand(parent, deps) {
     };
     if (opts.paymentMethodId !== void 0) body.payment_method_id = opts.paymentMethodId;
     if (opts.paymentTokenId !== void 0) body.payment_token_id = opts.paymentTokenId;
+    const member = memberIdOf(opts);
+    if (member !== void 0) body.member_id = member;
     if (!isYes) {
       const ok = await confirm6({
         message: `Create this flight order for ${totalAmount} ${currency}? This locks the fare but does NOT charge yet.`,
@@ -5318,7 +5365,7 @@ function registerCancelOrderCommand(parent, deps) {
 
 // src/flight-flink/list-orders.ts
 function registerListOrdersCommand2(parent, deps) {
-  const cmd = parent.command("list-orders").description("List the developer's flight orders (local read, no upstream call)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--status <status>", "Optional status filter").option("--page <n>", "Page (1-based)", "1").option("--page-size <n>", "Items per page (1-100)", "20");
+  const cmd = parent.command("list-orders").description("List the developer's flight orders (local read, no upstream call)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--status <status>", "Optional status filter").option("--page <n>", "Page (1-based)", "1").option("--page-size <n>", "Items per page (1-100)", "20").option("--member <id>", MEMBER_OPTION_DESCRIPTION);
   attachSchemaHelp(cmd, flightListOrdersSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -5326,6 +5373,8 @@ function registerListOrdersCommand2(parent, deps) {
     const apiKey = await resolveApiKey(opts.apiKey);
     const params = new URLSearchParams();
     if (opts.status !== void 0) params.set("status", opts.status);
+    const member = memberIdOf(opts);
+    if (member !== void 0) params.set("member_id", member);
     params.set("page", String(num8(opts.page, "page")));
     params.set("page_size", String(num8(opts.pageSize, "page-size")));
     const spinner = format === "json" ? null : createSpinner("Fetching flight orders...");