@agenzo/merchant-cli 0.8.16 → 0.8.17

package/dist/index.js

@@ -2162,63 +2162,72 @@ var unifiedOrdersListSchema = {
   cli: CLI_NAME,
   noun: ORDERS_NOUN,
   verb: "list",
-  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.',
+  description: "List orders across ALL providers (ride + hotel + flight) with common filters and offset/cursor pagination. Use domain-specific list-orders only for provider-specific fields.",
   flags: {
-    "order-type": { type: "string", required: false, description: "Filter by provider: ride | hotel" },
+    "order-type": { type: "string", required: false, description: "Legacy single order type: ride | hotel | flight" },
+    "order-types": { type: "string", required: false, description: "Comma-separated order types: ride,hotel,flight" },
     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" }
+    status: { type: "string", required: false, description: "Legacy single normalized status: PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED" },
+    statuses: { type: "string", required: false, description: "Comma-separated normalized statuses" },
+    "created-from": { type: "string", required: false, description: "ISO 8601 created-at lower bound (inclusive)" },
+    "created-to": { type: "string", required: false, description: "ISO 8601 created-at upper bound (exclusive)" },
+    cursor: { type: "string", required: false, description: "Opaque cursor returned by the previous page" },
+    page: { type: "int", required: false, default: 1, description: "Legacy 1-based page number", constraints: ">= 1" },
+    "page-size": { type: "int", required: false, default: 20, description: "Items per page", constraints: "1-100" }
   },
   response: {
     orders: {
       type: "array",
-      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`.",
+      description: "Slim cross-provider index items. Call `orders get` for business-specific detail.",
       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)" },
+        order_id: { type: "string", description: "Order id (rio_..., hho_..., or ffo_...). Pass to `orders get`." },
+        member_id: { type: "string|null", description: "Attributed end-user id; null when unattributed" },
+        order_type: { type: "string", description: "ride | hotel | flight" },
+        status: { type: "string", description: "Original provider-domain status for display" },
+        unified_status: { type: "string", description: "PENDING | CONFIRMED | COMPLETED | CANCELLED | FAILED" },
+        amount: { type: "float|null", description: "Order amount in decimal currency units" },
         currency: { type: "string|null", description: "ISO 4217 currency code" },
         created_at: { type: "string|null", description: "ISO 8601 datetime" },
         updated_at: { type: "string|null", description: "ISO 8601 datetime" }
       }
     },
     total: { type: "int", description: "Total matching orders across all providers" },
-    page: { type: "int", description: "Current page" },
-    page_size: { type: "int", description: "Items per page" }
+    page: { type: "int", description: "Legacy current page" },
+    page_size: { type: "int", description: "Items per page" },
+    next_cursor: { type: "string|null", description: "Opaque cursor for the next page; null at the end" },
+    has_more: { type: "bool", description: "Whether another page is available" },
+    applied_filters: { type: "object", description: "Normalized filters applied by the platform" }
   },
   example: {
-    command: "agenzo-merchant-cli orders list --page 1 --page-size 10",
-    output_summary: "Returns a paginated, cross-provider list of orders (both ride and hotel). If the user then asks about one order, use its order_id with `orders get`."
+    command: "agenzo-merchant-cli orders list --order-types flight,hotel --created-from 2026-07-01T00:00:00Z --page-size 20",
+    output_summary: "Returns ride, hotel, and flight orders with stable pagination metadata."
   },
   error_recovery: {
-    INVALID_REQUEST: "The --status value is not one of PENDING/CONFIRMED/COMPLETED/CANCELLED/FAILED. Fix and retry.",
+    INVALID_REQUEST: "Fix invalid type/status/date/cursor filters and retry.",
     INTERNAL_ERROR: "Transient backend error. Retry once after a short delay.",
-    PARAM_INVALID: "Ensure --page / --page-size are positive integers, then retry."
+    PARAM_INVALID: "Fix conflicting or invalid CLI options, then retry."
   }
 };
 var unifiedOrdersGetSchema = {
   cli: CLI_NAME,
   noun: ORDERS_NOUN,
   verb: "get",
-  description: "Get a single order detail by id, regardless of which provider (ride/hotel) it belongs to. The platform resolves order_id -> provider internally and returns that provider's own detail shape.",
+  description: "Get a ride, hotel, or flight order detail by id. The platform resolves order_id to the owning domain and returns that domain detail shape.",
   flags: {
-    "order-id": { type: "string", required: true, description: "Order id from `orders list` (rio_... for ride, hho_... for hotel)" }
+    "order-id": { type: "string", required: true, description: "Order id from `orders list` (rio_..., hho_..., or ffo_...)" }
   },
   response: {
     "(varies by order_type)": {
       type: "object",
-      description: "The response shape is delegated to the owning provider and therefore varies: a ride order returns the same shape as `ride-elife get`; a hotel order returns the same shape as `hotel-redaug get`. Treat the result as an opaque object and surface whatever fields it contains \u2014 do NOT assume a fixed schema."
+      description: "Delegated ride, hotel, or flight detail. Treat the result as an opaque domain object and surface the returned fields."
     }
   },
   example: {
-    command: "agenzo-merchant-cli orders get --order-id hho_01K...",
-    output_summary: "Returns the order's detail, delegated to its owning provider (ride or hotel)."
+    command: "agenzo-merchant-cli orders get --order-id ffo_01K...",
+    output_summary: "Returns the order's provider-domain detail."
   },
   error_recovery: {
-    ORDER_NOT_FOUND: "The order_id does not exist or does not belong to this developer/org. Verify the id from `orders list`. Do NOT retry blindly.",
+    ORDER_NOT_FOUND: "The order_id does not exist or does not belong to this developer/org. Verify the id from `orders list`.",
     INTERNAL_ERROR: "The order's provider detail lookup is temporarily unavailable. Retry once after a short delay."
   }
 };
@@ -3883,6 +3892,17 @@ function positiveInt2(value, flag) {
   }
   return String(n);
 }
+function assertCompatibleOptions(opts) {
+  if (opts.orderType !== void 0 && opts.orderTypes !== void 0) {
+    throw new CliError("PARAM_INVALID", "--order-type and --order-types cannot be used together.");
+  }
+  if (opts.status !== void 0 && opts.statuses !== void 0) {
+    throw new CliError("PARAM_INVALID", "--status and --statuses cannot be used together.");
+  }
+  if (opts.cursor !== void 0 && Number(opts.page ?? DEFAULT_PAGE2) !== 1) {
+    throw new CliError("PARAM_INVALID", "--cursor cannot be combined with --page greater than 1.");
+  }
+}
 function formatOrders2(data) {
   const orders = data.orders ?? [];
   if (orders.length === 0) {
@@ -3901,14 +3921,17 @@ function formatOrders2(data) {
     ["Page", String(data.page ?? "-")],
     ["Page size", String(data.page_size ?? "-")]
   ];
+  if (data.has_more !== void 0) summary.push(["Has more", String(data.has_more)]);
+  if (data.next_cursor) summary.push(["Next cursor", data.next_cursor]);
   return `${Formatter.table(headers, rows)}
 ${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).option("--member <id>", MEMBER_OPTION_DESCRIPTION);
+  const cmd = parent.command("list").description("List orders across ALL providers (ride + hotel + flight), with filters and pagination").option("--api-key <key>", "API Key for authentication (X-Api-Key)").option("--order-type <type>", "Legacy single order type filter: ride | hotel | flight").option("--order-types <types>", "Comma-separated order types: ride,hotel,flight").option("--status <status>", "Legacy single normalized status filter").option("--statuses <statuses>", "Comma-separated statuses: PENDING,CONFIRMED,COMPLETED,CANCELLED,FAILED").option("--created-from <datetime>", "Created at or after this ISO 8601 datetime (inclusive)").option("--created-to <datetime>", "Created before this ISO 8601 datetime (exclusive)").option("--cursor <cursor>", "Opaque cursor returned by the previous page").option("--page <page>", "Legacy 1-based 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();
+    assertCompatibleOptions(opts);
     const format = resolveFormat(opts.format);
     const apiKey = await PromptEngine.resolveInput(opts.apiKey, {
       message: "API Key:",
@@ -3919,7 +3942,12 @@ function registerOrdersListCommand(parent, deps) {
       page_size: positiveInt2(opts.pageSize ?? DEFAULT_PAGE_SIZE2, "page-size")
     };
     if (opts.orderType !== void 0) params.order_type = opts.orderType;
+    if (opts.orderTypes !== void 0) params.order_types = opts.orderTypes;
     if (opts.status !== void 0) params.status = opts.status;
+    if (opts.statuses !== void 0) params.statuses = opts.statuses;
+    if (opts.createdFrom !== void 0) params.created_from = opts.createdFrom;
+    if (opts.createdTo !== void 0) params.created_to = opts.createdTo;
+    if (opts.cursor !== void 0) params.cursor = opts.cursor;
     const member = memberIdOf(opts);
     if (member !== void 0) params.member_id = member;
     const spinner = format === "json" ? null : createSpinner("Fetching orders...");
@@ -3944,7 +3972,7 @@ function registerOrdersListCommand(parent, deps) {
 
 // src/orders/get.ts
 function registerOrdersGetCommand(parent, deps) {
-  const cmd = parent.command("get").description("Get a single order detail by id, regardless of provider (ride/hotel)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").requiredOption("--order-id <id>", "Order id (e.g. rio_... or hho_...)");
+  const cmd = parent.command("get").description("Get a single order detail by id, regardless of provider (ride/hotel/flight)").option("--api-key <key>", "API Key for authentication (X-Api-Key)").requiredOption("--order-id <id>", "Order id (e.g. rio_..., hho_..., or ffo_...)");
   attachSchemaHelp(cmd, unifiedOrdersGetSchema);
   cmd.action(async () => {
     const opts = cmd.optsWithGlobals();
@@ -6639,7 +6667,7 @@ Key notes:
   registerServicesListCommand(servicesCmd, { discoveryClient, program });
   registerServiceGetCommand(servicesCmd, { discoveryClient, program });
   const ordersCmd = program.command("orders").description(
-    'Unified cross-provider order index (spans ride + hotel). Use for generic "my orders" requests; use ride-elife/hotel-redaug commands once the business is known.'
+    "Unified cross-provider order index (ride + hotel + flight). Use for order history, common filters, and stable pagination."
   );
   registerOrdersListCommand(ordersCmd, deps);
   registerOrdersGetCommand(ordersCmd, deps);