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

package/dist/tools/migration-assistant-tools/orders-api-migration/code-generator.js

@@ -0,0 +1,45 @@
+export function generateRefactoredOrdersApiCode(sourceCode, analysis, targetVersion) {
+    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 = {
+        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/dist/tools/migration-assistant-tools/orders-api-migration/guidance-formatter.d.ts

@@ -0,0 +1,3 @@
+import { MigrationData } from "./migration-data.js";
+export declare function formatGeneralGuidance(migrationData: MigrationData): string;
+//# sourceMappingURL=guidance-formatter.d.ts.map

package/dist/tools/migration-assistant-tools/orders-api-migration/guidance-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-formatter.d.ts","sourceRoot":"","sources":["../../../../src/tools/migration-assistant-tools/orders-api-migration/guidance-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wBAAgB,qBAAqB,CAAC,aAAa,EAAE,aAAa,GAAG,MAAM,CAuJ1E"}

package/dist/tools/migration-assistant-tools/orders-api-migration/guidance-formatter.js

@@ -0,0 +1,134 @@
+export function formatGeneralGuidance(migrationData) {
+    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/dist/tools/migration-assistant-tools/orders-api-migration/migration-data.d.ts

@@ -0,0 +1,13 @@
+export interface MigrationData {
+    deprecated: string[];
+    notSupported: string[];
+    mappingExamples: Record<string, string>;
+    newFeatures: string[];
+    apiMapping: Record<string, {
+        v1: string;
+        status: string;
+        notes: string;
+    }>;
+}
+export declare function getOrdersApiMigrationData(): MigrationData;
+//# sourceMappingURL=migration-data.d.ts.map

package/dist/tools/migration-assistant-tools/orders-api-migration/migration-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-data.d.ts","sourceRoot":"","sources":["../../../../src/tools/migration-assistant-tools/orders-api-migration/migration-data.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAED,wBAAgB,yBAAyB,IAAI,aAAa,CAoNzD"}

package/dist/tools/migration-assistant-tools/orders-api-migration/migration-data.js

@@ -0,0 +1,181 @@
+export function getOrdersApiMigrationData() {
+    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",
+            },
+        },
+    };
+}

package/dist/tools/migration-assistant-tools/orders-api-migration/report-formatter.d.ts

@@ -0,0 +1,5 @@
+import { CodeAnalysis } from "./code-analyzer.js";
+import { MigrationData } from "./migration-data.js";
+export declare function formatAnalysisReport(analysis: CodeAnalysis, migrationData: MigrationData): string;
+export declare function formatMigrationReport(analysis: CodeAnalysis, refactoredCode: string, migrationData: MigrationData): string;
+//# sourceMappingURL=report-formatter.d.ts.map

package/dist/tools/migration-assistant-tools/orders-api-migration/report-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"report-formatter.d.ts","sourceRoot":"","sources":["../../../../src/tools/migration-assistant-tools/orders-api-migration/report-formatter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,YAAY,EACtB,aAAa,EAAE,aAAa,GAC3B,MAAM,CAoDR;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,YAAY,EACtB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,aAAa,GAC3B,MAAM,CAoBR"}

package/dist/tools/migration-assistant-tools/orders-api-migration/report-formatter.js

@@ -0,0 +1,64 @@
+export function formatAnalysisReport(analysis, migrationData) {
+    let report = `# 🔍 Migration Analysis Report\n\n`;
+    report += `## 📊 Summary\n\n`;
+    report += `- **API Calls Found:** ${analysis.apiCalls.length}\n`;
+    report += `- **Attributes to Update:** ${analysis.usedAttributes.length}\n`;
+    report += `- **Breaking Changes:** ${analysis.breakingChanges.length}\n`;
+    report += `- **Deprecated Endpoints:** ${analysis.deprecatedEndpoints.length}\n\n`;
+    if (analysis.deprecatedEndpoints.length > 0) {
+        report += `## ❌ Deprecated Endpoints\n\n`;
+        analysis.deprecatedEndpoints.forEach((endpoint) => {
+            report += `- **${endpoint.endpoint}** → ${endpoint.replacement}\n`;
+        });
+        report += `\n`;
+    }
+    if (analysis.breakingChanges.length > 0) {
+        report += `## ⚠️ Breaking Changes\n\n`;
+        analysis.breakingChanges.forEach((change, index) => {
+            report += `${index + 1}. **${change.change}**\n`;
+            report += `   ${change.explanation}\n\n`;
+        });
+    }
+    if (analysis.usedAttributes.length > 0) {
+        report += `## 🗺️ Attribute Mappings\n\n`;
+        analysis.usedAttributes.forEach((attr) => {
+            report += `- \`${attr.v0}\` → \`${attr.v1}\`\n`;
+        });
+        report += `\n`;
+    }
+    if (analysis.apiCalls.length > 0) {
+        report += `## 🔌 API Methods Detected\n\n`;
+        analysis.apiCalls.forEach((method) => {
+            const mapping = migrationData.apiMapping[method];
+            const status = mapping?.status || "Unknown";
+            report += `- **${method}** - ${status}\n`;
+        });
+        report += `\n`;
+    }
+    report += `## ✅ Migration Checklist\n\n`;
+    report += `- [ ] Review all deprecated endpoints and plan V0 fallback strategy\n`;
+    report += `- [ ] Update attribute references to new V1 structure\n`;
+    report += `- [ ] Add \`includedData\` parameter where needed (BUYER, RECIPIENT, etc.)\n`;
+    report += `- [ ] Update error handling for new response formats\n`;
+    report += `- [ ] Test with sandbox environment before production\n`;
+    report += `- [ ] Update TypeScript types/interfaces\n`;
+    report += `- [ ] Monitor for V0 API deprecation announcements\n\n`;
+    return report;
+}
+export function formatMigrationReport(analysis, refactoredCode, migrationData) {
+    let report = formatAnalysisReport(analysis, migrationData);
+    report += `\n---\n\n`;
+    report += `## 💻 Refactored Code\n\n`;
+    report += `\`\`\`javascript\n${refactoredCode}\n\`\`\`\n\n`;
+    report += `## 🧪 Testing Recommendations\n\n`;
+    report += `1. **Unit Tests:** Update test cases to match new V1 response structure\n`;
+    report += `2. **Integration Tests:** Test with SP-API sandbox environment\n`;
+    report += `3. **Error Handling:** Verify error responses match V1 format\n`;
+    report += `4. **Performance:** Monitor API response times and adjust \`includedData\` usage\n`;
+    report += `5. **Backward Compatibility:** Ensure V0 fallback works for unsupported operations\n\n`;
+    report += `## 📚 Additional Resources\n\n`;
+    report += `- [SP-API Orders V1 Documentation](https://developer-docs.amazon.com/sp-api/docs/orders-api-v1-reference)\n`;
+    report += `- [Migration Guide](https://developer-docs.amazon.com/sp-api/docs/orders-api-v0-to-v1-migration-guide)\n`;
+    report += `- Use \`getMigrationGuide\` tool for detailed attribute mappings\n\n`;
+    return report;
+}

package/dist/zod-schemas/migration-schemas.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Zod schemas for Migration Assistant tool
+ */
+import { z } from "zod";
+export declare const migrationAssistantSchema: z.ZodObject<{
+    source_code: z.ZodOptional<z.ZodString>;
+    source_version: z.ZodString;
+    target_version: z.ZodString;
+    language: z.ZodOptional<z.ZodString>;
+    analysis_only: z.ZodDefault<z.ZodBoolean>;
+}, "strip", z.ZodTypeAny, {
+    source_version: string;
+    target_version: string;
+    analysis_only: boolean;
+    source_code?: string | undefined;
+    language?: string | undefined;
+}, {
+    source_version: string;
+    target_version: string;
+    source_code?: string | undefined;
+    analysis_only?: boolean | undefined;
+    language?: string | undefined;
+}>;
+//# sourceMappingURL=migration-schemas.d.ts.map

package/dist/zod-schemas/migration-schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration-schemas.d.ts","sourceRoot":"","sources":["../../src/zod-schemas/migration-schemas.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;EAqBnC,CAAC"}

package/dist/zod-schemas/migration-schemas.js

@@ -0,0 +1,24 @@
+/**
+ * Zod schemas for Migration Assistant tool
+ */
+import { z } from "zod";
+export const migrationAssistantSchema = z.object({
+    source_code: z
+        .string()
+        .optional()
+        .describe("Your existing API integration code (optional - if not provided, returns general migration guidance)"),
+    source_version: z
+        .string()
+        .describe("Current API version (e.g., 'orders-v0')"),
+    target_version: z
+        .string()
+        .describe("Target API version (e.g., 'orders-2026-01-01')"),
+    language: z
+        .string()
+        .optional()
+        .describe("Programming language of the source code"),
+    analysis_only: z
+        .boolean()
+        .default(false)
+        .describe("Only analyze without generating code (default: false)"),
+});