@amazon-sp-api-release/dev-mcp 0.0.1

package/src/tools/migration-assistant-tools/migration-tools.ts

@@ -0,0 +1,143 @@
+import { getOrdersApiMigrationData } from "./orders-api-migration/migration-data.js";
+import { analyzeOrdersApiCode } from "./orders-api-migration/code-analyzer.js";
+import { generateRefactoredOrdersApiCode } from "./orders-api-migration/code-generator.js";
+import {
+  formatAnalysisReport,
+  formatMigrationReport,
+} from "./orders-api-migration/report-formatter.js";
+import { formatGeneralGuidance } from "./orders-api-migration/guidance-formatter.js";
+
+export interface MigrationAssistantArgs {
+  source_code?: string;
+  source_version: string;
+  target_version: string;
+  language?: string;
+  analysis_only?: boolean;
+}
+
+export interface ToolResponse {
+  content: Array<{
+    type: "text";
+    text: string;
+    meta?: Record<string, unknown>;
+  }>;
+  isError?: boolean;
+  [key: string]: unknown;
+}
+
+export class SPAPIMigrationAssistantTool {
+  async migrationAssistant(
+    args: MigrationAssistantArgs,
+  ): Promise<ToolResponse> {
+    const {
+      source_code,
+      source_version,
+      target_version,
+      analysis_only = false,
+    } = args;
+
+    // Validate supported migrations
+    const supportedMigrations: Record<
+      string,
+      { source: string; target: string }
+    > = {
+      "orders-v0->orders-2026-01-01": {
+        source: "orders-v0",
+        target: "orders-2026-01-01",
+      },
+    };
+
+    const isSupported = Object.values(supportedMigrations).some(
+      (m) => m.source === source_version && m.target === target_version,
+    );
+
+    if (!isSupported) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `❌ Unsupported migration path: ${source_version} → ${target_version}\n\nSupported migrations:\n${Object.values(
+              supportedMigrations,
+            )
+              .map((m) => `- ${m.source} → ${m.target}`)
+              .join("\n")}`,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    // Route to appropriate migration handler
+    if (
+      source_version === "orders-v0" &&
+      target_version === "orders-2026-01-01"
+    ) {
+      return this.handleOrdersApiMigration(
+        source_code,
+        target_version,
+        analysis_only,
+      );
+    }
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: `Migration handler not implemented for ${source_version} → ${target_version}`,
+        },
+      ],
+      isError: true,
+    };
+  }
+
+  private async handleOrdersApiMigration(
+    sourceCode: string | undefined,
+    targetVersion: string,
+    analysisOnly: boolean,
+  ): Promise<ToolResponse> {
+    // Get migration data
+    const migrationData = getOrdersApiMigrationData();
+
+    // If no source code provided, return general guidance
+    if (!sourceCode) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: formatGeneralGuidance(migrationData),
+          },
+        ],
+      };
+    }
+
+    // Analyze the source code
+    const analysis = analyzeOrdersApiCode(sourceCode, migrationData);
+
+    if (analysisOnly) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: formatAnalysisReport(analysis, migrationData),
+          },
+        ],
+      };
+    }
+
+    // Generate refactored code
+    const refactoredCode = generateRefactoredOrdersApiCode(
+      sourceCode,
+      analysis,
+      targetVersion,
+    );
+
+    return {
+      content: [
+        {
+          type: "text",
+          text: formatMigrationReport(analysis, refactoredCode, migrationData),
+        },
+      ],
+    };
+  }
+}

package/src/tools/migration-assistant-tools/orders-api-migration/code-analyzer.ts

@@ -0,0 +1,72 @@
+import { MigrationData } from "./migration-data.js";
+
+export interface CodeAnalysis {
+  deprecatedEndpoints: Array<{ endpoint: string; replacement: string }>;
+  breakingChanges: Array<{ change: string; explanation: string }>;
+  usedAttributes: Array<{ v0: string; v1: string; notes: string }>;
+  apiCalls: string[];
+}
+
+export function analyzeOrdersApiCode(
+  sourceCode: string,
+  migrationData: MigrationData,
+): CodeAnalysis {
+  const deprecatedEndpoints: Array<{
+    endpoint: string;
+    replacement: string;
+  }> = [];
+  const breakingChanges: Array<{ change: string; explanation: string }> = [];
+  const usedAttributes: Array<{ v0: string; v1: string; notes: string }> = [];
+  const apiCalls: string[] = [];
+
+  // Detect API method calls
+  const apiMethodPatterns = Object.keys(migrationData.apiMapping);
+  apiMethodPatterns.forEach((method) => {
+    const regex = new RegExp(`\\b${method}\\b`, "g");
+    if (regex.test(sourceCode)) {
+      apiCalls.push(method);
+      const mapping = migrationData.apiMapping[method];
+
+      if (mapping.status.includes("❌")) {
+        deprecatedEndpoints.push({
+          endpoint: method,
+          replacement: mapping.v1,
+        });
+        breakingChanges.push({
+          change: `${method} has no V1 counterpart`,
+          explanation: mapping.notes,
+        });
+      }
+    }
+  });
+
+  // Detect deprecated attributes
+  migrationData.deprecated.forEach((attr) => {
+    const regex = new RegExp(`\\b${attr.replace(/\./g, "\\.")}\\b`, "g");
+    if (regex.test(sourceCode)) {
+      breakingChanges.push({
+        change: `Deprecated attribute: ${attr}`,
+        explanation: "This attribute is removed in V1 and has no replacement",
+      });
+    }
+  });
+
+  // Detect attribute mappings
+  Object.entries(migrationData.mappingExamples).forEach(([v0, v1]) => {
+    const regex = new RegExp(`\\b${v0.replace(/\./g, "\\.")}\\b`, "g");
+    if (regex.test(sourceCode)) {
+      usedAttributes.push({
+        v0,
+        v1,
+        notes: `Mapped from ${v0} to ${v1}`,
+      });
+    }
+  });
+
+  return {
+    deprecatedEndpoints,
+    breakingChanges,
+    usedAttributes,
+    apiCalls,
+  };
+}

package/src/tools/migration-assistant-tools/orders-api-migration/code-generator.ts

@@ -0,0 +1,64 @@
+import { CodeAnalysis } from "./code-analyzer.js";
+
+export function generateRefactoredOrdersApiCode(
+  sourceCode: string,
+  analysis: CodeAnalysis,
+  targetVersion: string,
+): string {
+  let refactoredCode = sourceCode;
+
+  // Replace attribute mappings
+  analysis.usedAttributes.forEach((attr) => {
+    const v0Pattern = new RegExp(`\\b${attr.v0.replace(/\./g, "\\.")}\\b`, "g");
+    refactoredCode = refactoredCode.replace(v0Pattern, attr.v1);
+  });
+
+  // Replace API method calls
+  const apiReplacements: Record<string, string> = {
+    getOrders: "searchOrders",
+    getOrder: "getOrder",
+    getOrderBuyerInfo: "getOrder", // with includedData
+    getOrderAddress: "getOrder", // with includedData
+    getOrderItems: "getOrder", // items included by default
+    getOrderItemsBuyerInfo: "getOrder", // with includedData
+    cancelOrder: "cancelOrder",
+  };
+
+  Object.entries(apiReplacements).forEach(([v0Method, v1Method]) => {
+    const regex = new RegExp(`\\b${v0Method}\\b`, "g");
+    refactoredCode = refactoredCode.replace(regex, v1Method);
+  });
+
+  // Add comments for V0-only APIs
+  analysis.deprecatedEndpoints.forEach((endpoint) => {
+    if (endpoint.replacement.includes("No V1 counterpart")) {
+      const regex = new RegExp(`(\\b${endpoint.endpoint}\\b)`, "g");
+      refactoredCode = refactoredCode.replace(
+        regex,
+        `$1 /* ⚠️ Continue using V0 API - No V1 equivalent */`,
+      );
+    }
+  });
+
+  // Update endpoint URLs
+  refactoredCode = refactoredCode.replace(
+    /\/orders\/v0\//g,
+    "/orders/2026-01-01/",
+  );
+
+  // Add migration header comment
+  const header = `/**
+ * 🔄 Migrated from ${analysis.apiCalls.length > 0 ? "Orders API V0" : "V0"} to ${targetVersion}
+ * 
+ * Migration Summary:
+ * - ${analysis.usedAttributes.length} attributes updated
+ * - ${analysis.apiCalls.length} API methods analyzed
+ * - ${analysis.breakingChanges.length} breaking changes identified
+ * 
+ * ⚠️ Note: Some V0 APIs have no V1 counterpart and must continue using V0
+ */
+
+`;
+
+  return header + refactoredCode;
+}

package/src/tools/migration-assistant-tools/orders-api-migration/guidance-formatter.ts

@@ -0,0 +1,154 @@
+import { MigrationData } from "./migration-data.js";
+
+export function formatGeneralGuidance(migrationData: MigrationData): string {
+  let guidance = `# 🔄 Orders API Migration Guide: V0 → V1 (2026-01-01)\n\n`;
+
+  guidance += `## 📋 Overview\n\n`;
+  guidance += `This guide helps you migrate from Orders API V0 to V1 (2026-01-01).\n\n`;
+
+  guidance += `**Key Changes:**\n`;
+  guidance += `- New nested data structure (buyer, recipient, fulfillment, etc.)\n`;
+  guidance += `- Enhanced data sets with \`includedData\` parameter\n`;
+  guidance += `- New programs array replaces boolean flags\n`;
+  guidance += `- Better financial breakdown with proceeds and expense tracking\n`;
+  guidance += `- Some V0 APIs have no V1 counterpart (continue using V0)\n\n`;
+
+  // API Availability
+  guidance += `## 🔌 API Method Mapping\n\n`;
+  guidance += `### ✅ Available in V1:\n\n`;
+  Object.entries(migrationData.apiMapping).forEach(([v0Method, mapping]) => {
+    if (mapping.status.includes("✅")) {
+      guidance += `- **${v0Method}** → ${mapping.v1}\n`;
+      guidance += `  ${mapping.notes}\n\n`;
+    }
+  });
+
+  guidance += `### ❌ NOT Available in V1 (Continue using V0):\n\n`;
+  Object.entries(migrationData.apiMapping).forEach(([v0Method, mapping]) => {
+    if (mapping.status.includes("❌")) {
+      guidance += `- **${v0Method}**\n`;
+      guidance += `  ${mapping.notes}\n\n`;
+    }
+  });
+
+  // Attribute Mappings
+  guidance += `## 🗺️ Key Attribute Mappings\n\n`;
+  guidance += `Common V0 attributes and their V1 equivalents:\n\n`;
+
+  const highlightedMappings = [
+    "AmazonOrderId",
+    "OrderStatus",
+    "IsPrime",
+    "IsBusinessOrder",
+    "OrderTotal",
+    "ShippingAddress",
+    "BuyerInfo.BuyerEmail",
+    "QuantityShipped",
+  ];
+
+  highlightedMappings.forEach((v0Attr) => {
+    const v1Attr = migrationData.mappingExamples[v0Attr];
+    if (v1Attr) {
+      guidance += `- \`${v0Attr}\` → \`${v1Attr}\`\n`;
+    }
+  });
+
+  guidance += `\n[View complete mapping list for all ${Object.keys(migrationData.mappingExamples).length} attributes]\n\n`;
+
+  // Breaking Changes
+  guidance += `## ⚠️ Breaking Changes\n\n`;
+  guidance += `### Deprecated Attributes (${migrationData.deprecated.length})\n\n`;
+  guidance += `These attributes are removed in V1 with no replacement:\n\n`;
+  migrationData.deprecated.slice(0, 5).forEach((attr) => {
+    guidance += `- ${attr}\n`;
+  });
+  if (migrationData.deprecated.length > 5) {
+    guidance += `- ... and ${migrationData.deprecated.length - 5} more\n`;
+  }
+  guidance += `\n`;
+
+  guidance += `### Not Supported Attributes (${migrationData.notSupported.length})\n\n`;
+  guidance += `These attributes are not available in current V1 release:\n\n`;
+  migrationData.notSupported.slice(0, 5).forEach((attr) => {
+    guidance += `- ${attr}\n`;
+  });
+  if (migrationData.notSupported.length > 5) {
+    guidance += `- ... and ${migrationData.notSupported.length - 5} more\n`;
+  }
+  guidance += `\n`;
+
+  // New Features
+  guidance += `## 🆕 New Features in V1\n\n`;
+  migrationData.newFeatures.forEach((feature) => {
+    guidance += `- ${feature}\n`;
+  });
+  guidance += `\n`;
+
+  // Code Examples
+  guidance += `## 💻 Code Examples\n\n`;
+  guidance += `### Checking Prime Orders\n\n`;
+  guidance += `**V0:**\n`;
+  guidance += `\`\`\`javascript\n`;
+  guidance += `if (order.IsPrime) {\n`;
+  guidance += `  // handle prime order\n`;
+  guidance += `}\n`;
+  guidance += `\`\`\`\n\n`;
+  guidance += `**V1:**\n`;
+  guidance += `\`\`\`javascript\n`;
+  guidance += `if (order.programs?.includes('PRIME')) {\n`;
+  guidance += `  // handle prime order\n`;
+  guidance += `}\n`;
+  guidance += `\`\`\`\n\n`;
+
+  guidance += `### Getting Order Status\n\n`;
+  guidance += `**V0:**\n`;
+  guidance += `\`\`\`javascript\n`;
+  guidance += `const status = order.OrderStatus;\n`;
+  guidance += `\`\`\`\n\n`;
+  guidance += `**V1:**\n`;
+  guidance += `\`\`\`javascript\n`;
+  guidance += `const status = order.fulfillment.fulfillmentStatus;\n`;
+  guidance += `\`\`\`\n\n`;
+
+  guidance += `### Search Orders (V1)\n\n`;
+  guidance += `\`\`\`javascript\n`;
+  guidance += `const response = await fetch(\n`;
+  guidance += `  'https://sellingpartnerapi-na.amazon.com/orders/2026-01-01/orders?' +\n`;
+  guidance += `  new URLSearchParams({\n`;
+  guidance += `    createdAfter: '2025-12-01T00:00:00Z',\n`;
+  guidance += `    marketplaceIds: 'ATVPDKIKX0DER',\n`;
+  guidance += `    includedData: 'BUYER,RECIPIENT,FULFILLMENT'\n`;
+  guidance += `  }),\n`;
+  guidance += `  {\n`;
+  guidance += `    headers: {\n`;
+  guidance += `      'x-amz-access-token': accessToken\n`;
+  guidance += `    }\n`;
+  guidance += `  }\n`;
+  guidance += `);\n`;
+  guidance += `\`\`\`\n\n`;
+
+  // Migration Checklist
+  guidance += `## ✅ Migration Checklist\n\n`;
+  guidance += `- [ ] Review API method availability (some require V0)\n`;
+  guidance += `- [ ] Update attribute references to new nested structure\n`;
+  guidance += `- [ ] Replace boolean flags with programs array checks\n`;
+  guidance += `- [ ] Add \`includedData\` parameter for additional data\n`;
+  guidance += `- [ ] Update endpoint URLs from \`/orders/v0/\` to \`/orders/2026-01-01/\`\n`;
+  guidance += `- [ ] Update error handling for new response formats\n`;
+  guidance += `- [ ] Test with sandbox environment\n`;
+  guidance += `- [ ] Update TypeScript types/interfaces\n`;
+  guidance += `- [ ] Plan V0 fallback for unsupported operations\n\n`;
+
+  // Resources
+  guidance += `## 📚 Resources\n\n`;
+  guidance += `- [SP-API Orders V1 Documentation](https://developer-docs.amazon.com/sp-api/docs/orders-api-v1-reference)\n`;
+  guidance += `- [Migration Guide](https://developer-docs.amazon.com/sp-api/docs/orders-api-v0-to-v1-migration-guide)\n`;
+  guidance += `- [SP-API Developer Guide](https://developer-docs.amazon.com/sp-api/)\n\n`;
+
+  guidance += `## 🔍 Need More Help?\n\n`;
+  guidance += `- **Code Analysis:** Provide your source code for detailed analysis and automated refactoring\n`;
+  guidance += `- **Specific Attributes:** Ask about specific V0 attributes for detailed mapping\n`;
+  guidance += `- **API Methods:** Ask about specific V0 API methods for migration guidance\n`;
+
+  return guidance;
+}

package/src/tools/migration-assistant-tools/orders-api-migration/migration-data.ts

@@ -0,0 +1,221 @@
+export interface MigrationData {
+  deprecated: string[];
+  notSupported: string[];
+  mappingExamples: Record<string, string>;
+  newFeatures: string[];
+  apiMapping: Record<string, { v1: string; status: string; notes: string }>;
+}
+
+export function getOrdersApiMigrationData(): MigrationData {
+  return {
+    deprecated: [
+      "OrderChannel",
+      "ShipServiceLevel",
+      "CbaDisplayableShippingLabel",
+      "IsGlobalExpressEnabled",
+      "PromiseResponseDueDate",
+      "IsEstimatedShipDateSet",
+      "IsSoldByAB",
+      "BuyerInfo.BuyerCounty",
+    ],
+    notSupported: [
+      "NumberOfItemsShipped",
+      "NumberOfItemsUnshipped",
+      "PaymentExecutionDetail",
+      "PaymentMethod",
+      "PaymentMethodDetails",
+      "IsIBA",
+      "HasRegulatedItems",
+      "DefaultShipFromLocationAddress",
+      "ElectronicInvoiceStatus",
+      "BuyerInvoicePreference",
+      "BuyerTaxInformation",
+      "FulfillmentInstruction",
+      "MarketplaceTaxInfo",
+      "SellerDisplayName",
+      "AutomatedShippingSettings",
+      "BuyerInfo.BuyerTaxInfo",
+      "ProductInfo",
+      "ProductInfo.NumberOfItems",
+      "TaxCollection",
+      "TaxCollection.Model",
+      "TaxCollection.ResponsibleParty",
+      "DeemedResellerCategory",
+      "StoreChainStoreId",
+      "SerialNumberRequired",
+      "AssociatedItems",
+      "AssociatedItem.OrderId",
+      "AssociatedItem.OrderItemId",
+      "AssociatedItem.AssociationType",
+      "PointsGrantedDetail.PointsNumber",
+      "PointsGrantedDetail.PointsMonetaryValue",
+      "ConditionId",
+      "ConditionSubtypeId",
+    ],
+    mappingExamples: {
+      AmazonOrderId: "Order.orderId",
+      SellerOrderId: "Order.orderAliases (with aliasType == SELLER_ORDER_ID)",
+      MarketplaceId: "Order.salesChannel.marketplaceId",
+      PurchaseDate: "Order.createdTime",
+      LastUpdateDate: "Order.lastUpdatedTime",
+      OrderType: "Order.programs (check for PREORDER)",
+      OrderStatus: "Order.fulfillment.fulfillmentStatus",
+      FulfillmentChannel: "Order.fulfillment.fulfilledBy",
+      SalesChannel: "Order.salesChannel.marketplaceName",
+      ShipmentServiceLevelCategory: "Order.fulfillment.fulfillmentServiceLevel",
+      OrderTotal: "Order.proceeds.grandTotal",
+      EasyShipShipmentStatus: "Order.packages.packageStatus.detailedStatus",
+      EarliestShipDate: "Order.fulfillment.shipByWindow.earliestDateTime",
+      LatestShipDate: "Order.fulfillment.shipByWindow.latestDateTime",
+      EarliestDeliveryDate:
+        "Order.fulfillment.deliverByWindow.earliestDateTime",
+      LatestDeliveryDate: "Order.fulfillment.deliverByWindow.latestDateTime",
+      IsBusinessOrder: "Order.programs (check for AMAZON_BUSINESS)",
+      IsPrime: "Order.programs (check for PRIME)",
+      IsPremiumOrder: "Order.programs (check for PRIMIUM)",
+      ReplacedOrderId:
+        "Order.associatedOrders (with associationType == REPLACEMENT_ORIGINAL_ID or EXCHANGE_ORIGINAL_ID)",
+      IsISPU: "Order.programs (check for IN_STORE_PICK_UP)",
+      IsAccessPointOrder:
+        "Order.recipient.deliveryAddress.addressType (check for PICKUP_POINT)",
+      ShippingAddress: "Order.recipient.deliveryAddress",
+      "BuyerInfo.BuyerEmail": "Order.buyer.buyerEmail",
+      "BuyerInfo.BuyerName": "Order.buyer.buyerName",
+      "BuyerInfo.PurchaseOrderNumber": "Order.buyer.buyerPurchaseOrderNumber",
+      BuyerCompanyName: "Order.buyer.buyerCompanyName",
+      DeliveryPreferences: "Order.recipient.deliveryPreference",
+      ASIN: "Order.orderItems.product.asin",
+      SellerSKU: "Order.orderItems.product.sellerSku",
+      OrderItemId: "Order.orderItems.orderItemId",
+      Title: "Order.orderItems.product.title",
+      QuantityOrdered: "Order.orderItems.quantityOrdered",
+      QuantityShipped: "Order.orderItems.fulfillment.quantityFulfilled",
+      PointsGranted: "Order.orderItems.expense.pointsCost.pointsGranted",
+      ItemPrice:
+        "Order.orderItems.proceeds.breakdowns.subtotal (with type == ITEM)",
+      ShippingPrice:
+        "Order.orderItems.proceeds.breakdowns.subtotal (with type == SHIPPING)",
+      ItemTax:
+        "Order.orderItems.proceeds.breakdowns.detailedBreakdowns.value (type == TAX && subtype == ITEM)",
+      ShippingTax:
+        "Order.orderItems.proceeds.breakdowns.detailedBreakdowns.value (type == TAX && subtype == SHIPPING)",
+      ShippingDiscount:
+        "Order.orderItems.proceeds.breakdowns.detailedBreakdowns.value (type == DISCOUNT && subtype == SHIPPING)",
+      PromotionDiscount:
+        "Order.orderItems.proceeds.breakdowns.subtotal (with type == DISCOUNT)",
+      PromotionDiscountTax:
+        "Order.orderItems.proceeds.breakdowns.detailedBreakdowns.value (type == TAX && subtype == DISCOUNT)",
+      CODFee:
+        "Order.orderItems.proceeds.breakdowns.subtotal (with type == COD_FEE)",
+      CODFeeDiscount:
+        "Order.orderItems.proceeds.breakdowns.detailedBreakdowns.value (type == DISCOUNT && subtype == COD_FEE)",
+      "ItemBuyerInfo.GiftWrapPrice":
+        "Order.orderItems.proceeds.breakdowns.subtotal (with type == GIFT_WRAP)",
+      "ItemBuyerInfo.GiftWrapTax":
+        "Order.orderItems.proceeds.breakdowns.detailedBreakdowns.value (type == TAX && subtype == GIFT_WRAP)",
+      PromotionIds: "Order.orderItems.promotion.breakdowns.promotionId",
+      IsGift: "Order.orderItems.fulfillment.packing.giftOption",
+      ConditionNote: "Order.orderItems.product.condition",
+      ScheduledDeliveryStartDate:
+        "Order.orderItems.fulfillment.shipping.scheduledDeliveryWindow",
+      ScheduledDeliveryEndDate:
+        "Order.orderItems.fulfillment.shipping.scheduledDeliveryWindow",
+      PriceDesignation: "Order.orderItems.product.price.priceDesignation",
+      IossNumber:
+        "Order.orderItems.fulfillment.shipping.internationalShipping.iossNumber",
+      IsTransparency: "Order.orderItems.programs (check for TRANSPARENCY)",
+      "ItemBuyerInfo.BuyerCustomizedInfo":
+        "Order.orderItems.product.customization",
+      "ItemBuyerInfo.BuyerCustomizedInfo.CustomizedURL":
+        "Order.orderItems.product.customization.customizedUrl",
+      "ItemBuyerInfo.GiftMessageText":
+        "Order.orderItems.fulfillment.packing.giftOption.giftMessage",
+      "ItemBuyerInfo.GiftWrapLevel":
+        "Order.orderItems.fulfillment.packing.giftOption.giftWrapLevel",
+      "BuyerRequestedCancel.IsBuyerRequestedCancel":
+        "Order.orderItems.cancellation.requester (check for BUYER)",
+      "BuyerRequestedCancel.BuyerCancelReason":
+        "Order.orderItems.cancellation.cancelReason",
+      SerialNumbers: "Order.orderItems.product.serialNumbers",
+      SubstitutionPreferences:
+        "Order.orderItems.fulfillment.picking.substitutionPreference",
+      Measurement: "Order.orderItems.measurement",
+      ShippingConstraints:
+        "Order.orderItems.fulfillment.shipping.shippingConstraints",
+      AmazonPrograms:
+        "Order.orderItems.programs or Order.programs (check for SUBSCRIBE_AND_SAVE, FBM_SHIP_PULS)",
+    },
+    newFeatures: [
+      "Order.programs with AMAZON_BAZAAR",
+      "Order.programs with AMAZON_HAUL",
+      "Order.programs with AMAZON_EASY_SHIP (non-Brazil) or DELIVERY_BY_AMAZON (Brazil only)",
+      "Order.orderItems.product.price.unitPrice",
+      "Order.orderItems.proceeds.proceedsTotal",
+      "Order.orderItems.fulfillment.shipping.shippingConstraints.cashOnDelivery",
+      "Order.packages for FBM orders (carrier, shippingService, trackingNumber, package status)",
+    ],
+    apiMapping: {
+      getOrders: {
+        v1: "search_orders (with filters)",
+        status: "✅ Available",
+        notes: "Use with filters like createdAfter, marketplaceIds, etc.",
+      },
+      getOrder: {
+        v1: "get_order (with includedData parameter)",
+        status: "✅ Available",
+        notes:
+          "Order items included by default, use includedData for additional data",
+      },
+      getOrderBuyerInfo: {
+        v1: "get_order (with includedData=['BUYER'])",
+        status: "✅ Available",
+        notes: "Include BUYER in includedData parameter",
+      },
+      getOrderAddress: {
+        v1: "get_order (with includedData=['RECIPIENT'])",
+        status: "✅ Available",
+        notes: "Include RECIPIENT in includedData parameter",
+      },
+      getOrderItems: {
+        v1: "get_order (order items included by default)",
+        status: "✅ Available",
+        notes: "Order items are always included, no need for separate call",
+      },
+      getOrderItemsBuyerInfo: {
+        v1: "get_order (with includedData=['BUYER'])",
+        status: "✅ Available",
+        notes: "Item buyer info included when BUYER is in includedData",
+      },
+      getOrderRegulatedInfo: {
+        v1: "No V1 counterpart",
+        status: "❌ Not Available",
+        notes:
+          "Continue using V0 API: GET /orders/v0/orders/{orderId}/regulatedInfo",
+      },
+      updateShipmentStatus: {
+        v1: "No V1 counterpart",
+        status: "❌ Not Available",
+        notes:
+          "Continue using V0 API: POST /orders/v0/orders/{orderId}/shipment",
+      },
+      updateVerificationStatus: {
+        v1: "No V1 counterpart",
+        status: "❌ Not Available",
+        notes:
+          "Continue using V0 API: PATCH /orders/v0/orders/{orderId}/verificationStatus",
+      },
+      confirmShipment: {
+        v1: "No V1 counterpart",
+        status: "❌ Not Available",
+        notes:
+          "Continue using V0 API: POST /orders/v0/orders/{orderId}/shipConfirmation",
+      },
+      cancelOrder: {
+        v1: "cancel_order",
+        status: "✅ Available",
+        notes:
+          "Available in V1 as PUT /orders/v1/orders/{orderId}/cancellation",
+      },
+    },
+  };
+}