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

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

@@ -0,0 +1,85 @@
+import { CodeAnalysis } from "./code-analyzer.js";
+import { MigrationData } from "./migration-data.js";
+
+export function formatAnalysisReport(
+  analysis: CodeAnalysis,
+  migrationData: MigrationData,
+): string {
+  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: CodeAnalysis,
+  refactoredCode: string,
+  migrationData: MigrationData,
+): string {
+  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/src/utils/logger.ts

@@ -0,0 +1,75 @@
+import { createWriteStream, existsSync, mkdirSync, WriteStream } from "fs";
+import { join } from "path";
+
+export interface LogEntry {
+  timestamp: string;
+  level: "INFO" | "ERROR" | "WARN" | "DEBUG";
+  message: string;
+  data: any;
+  pid: number;
+}
+
+export class Logger {
+  private logStream: WriteStream;
+  private logPath: string;
+
+  constructor(logFile: string = "dev-mcp.log") {
+    // Create logs directory under current working directory
+    const logsDir = join(process.cwd(), "logs");
+
+    // Ensure logs directory exists
+    if (!existsSync(logsDir)) {
+      mkdirSync(logsDir, { recursive: true });
+    }
+
+    // Create log file path
+    this.logPath = join(logsDir, logFile);
+
+    // Create write stream
+    this.logStream = createWriteStream(this.logPath, { flags: "a" });
+
+    // Log initialization
+    this.log("INFO", "Logger initialized", {
+      logPath: this.logPath,
+      cwd: process.cwd(),
+    });
+  }
+
+  private log(
+    level: LogEntry["level"],
+    message: string,
+    data: any = null,
+  ): void {
+    const timestamp = new Date().toISOString();
+    const logEntry: LogEntry = {
+      timestamp,
+      level,
+      message,
+      data,
+      pid: process.pid,
+    };
+
+    const logLine = JSON.stringify(logEntry);
+
+    // Write to log file
+    this.logStream.write(logLine + "\n");
+  }
+
+  info(message: string, data?: any): void {
+    this.log("INFO", message, data);
+  }
+
+  error(message: string, data?: any): void {
+    this.log("ERROR", message, data);
+  }
+
+  warn(message: string, data?: any): void {
+    this.log("WARN", message, data);
+  }
+
+  debug(message: string, data?: any): void {
+    this.log("DEBUG", message, data);
+  }
+}
+
+export const logger = new Logger();

package/src/zod-schemas/migration-schemas.ts

@@ -0,0 +1,28 @@
+/**
+ * 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)"),
+});

package/src/zod-schemas/orders-schemas.ts

@@ -0,0 +1,196 @@
+/**
+ * Zod schemas for Orders API tools
+ */
+
+import { z } from "zod";
+
+// Orders API V1 Schemas
+export const searchOrdersSchema = z.object({
+  createdAfter: z
+    .string()
+    .optional()
+    .describe(
+      "ISO 8601 date for orders created after this time (e.g., '2025-10-01T00:00:00Z')",
+    ),
+  createdBefore: z
+    .string()
+    .optional()
+    .describe("ISO 8601 date for orders created before this time"),
+  lastUpdatedAfter: z
+    .string()
+    .optional()
+    .describe("ISO 8601 date for orders last updated after this time"),
+  lastUpdatedBefore: z
+    .string()
+    .optional()
+    .describe("ISO 8601 date for orders last updated before this time"),
+  fulfillmentStatuses: z
+    .array(
+      z.enum([
+        "PENDING",
+        "UNSHIPPED",
+        "PARTIALLY_SHIPPED",
+        "SHIPPED",
+        "CANCELLED",
+        "UNFULFILLABLE",
+      ]),
+    )
+    .optional()
+    .describe("Filter by fulfillment status"),
+  marketplaceIds: z
+    .array(z.string())
+    .default(["ATVPDKIKX0DER"])
+    .describe("Marketplace IDs to search in (e.g., ['ATVPDKIKX0DER' for US])"),
+  fulfilledBy: z
+    .array(z.enum(["AMAZON", "MERCHANT"]))
+    .optional()
+    .describe("Filter by fulfillment channel"),
+  maxResultsPerPage: z
+    .number()
+    .min(1)
+    .max(100)
+    .default(50)
+    .describe("Number of results per page (1-100)"),
+  includedData: z
+    .array(
+      z.enum([
+        "BUYER",
+        "RECIPIENT",
+        "PROCEEDS",
+        "EXPENSE",
+        "PROMOTION",
+        "CANCELLATION",
+        "FULFILLMENT",
+        "PACKAGES",
+      ]),
+    )
+    .optional()
+    .describe("Data sets to include in response"),
+  paginationToken: z
+    .string()
+    .optional()
+    .describe("Token for pagination from previous response"),
+});
+
+export const getOrderSchema = z.object({
+  orderId: z.string().describe("Amazon order ID (e.g., '123-4567890-1234567')"),
+  includedData: z
+    .array(
+      z.enum([
+        "BUYER",
+        "RECIPIENT",
+        "PROCEEDS",
+        "EXPENSE",
+        "PROMOTION",
+        "CANCELLATION",
+        "FULFILLMENT",
+        "PACKAGES",
+      ]),
+    )
+    .optional()
+    .describe("Data sets to include in response"),
+});
+
+export const cancelOrderSchema = z.object({
+  orderId: z.string().describe("Amazon order ID to cancel"),
+  cancelReasonCode: z
+    .enum([
+      "NO_INVENTORY",
+      "BUYER_CANCELLED",
+      "SHIPPING_ADDRESS_UNDELIVERABLE",
+      "CUSTOMER_EXCHANGE",
+      "PRICING_ERROR",
+    ])
+    .describe("Reason for cancellation"),
+});
+
+// Orders API V0 Schemas
+export const updateShipmentStatusSchema = z.object({
+  orderId: z.string().describe("Amazon order ID"),
+  marketplaceId: z
+    .string()
+    .default("ATVPDKIKX0DER")
+    .describe("Marketplace ID (e.g., 'ATVPDKIKX0DER' for US)"),
+  shipmentStatus: z
+    .enum(["ReadyForPickup", "PickedUp", "RefusedPickup"])
+    .describe("New shipment status"),
+  orderItems: z
+    .array(
+      z.object({
+        orderItemId: z.string().optional().describe("Order item ID"),
+        quantity: z.number().optional().describe("Quantity"),
+      }),
+    )
+    .optional()
+    .describe("Optional order items to update"),
+});
+
+export const updateVerificationStatusSchema = z.object({
+  orderId: z.string().describe("Amazon order ID"),
+  marketplaceId: z
+    .string()
+    .default("ATVPDKIKX0DER")
+    .describe("Marketplace ID (e.g., 'ATVPDKIKX0DER' for US)"),
+  regulatedOrderVerificationStatus: z.object({
+    status: z
+      .enum(["Approved", "Rejected", "Expired", "Cancelled"])
+      .describe("Verification status"),
+    validUntil: z
+      .string()
+      .optional()
+      .describe("ISO 8601 date when status is valid until"),
+    rejectionReason: z
+      .object({
+        rejectionReasonId: z.string().describe("Rejection reason ID"),
+        rejectionReasonDescription: z
+          .string()
+          .describe("Rejection reason description"),
+      })
+      .optional()
+      .describe("Rejection reason (required if status is 'Rejected')"),
+  }),
+});
+
+export const confirmShipmentSchema = z.object({
+  orderId: z.string().describe("Amazon order ID"),
+  marketplaceId: z
+    .string()
+    .default("ATVPDKIKX0DER")
+    .describe("Marketplace ID (e.g., 'ATVPDKIKX0DER' for US)"),
+  packageDetail: z.object({
+    packageReferenceId: z.string().describe("Package reference ID"),
+    carrierCode: z
+      .string()
+      .describe("Carrier code (e.g., 'UPS', 'FEDEX', 'USPS')"),
+    shippingMethod: z.string().optional().describe("Shipping method"),
+    trackingNumber: z.string().optional().describe("Tracking number"),
+    shipDate: z
+      .string()
+      .describe("ISO 8601 ship date (e.g., '2025-10-01T00:00:00Z')"),
+    carrierName: z.string().optional().describe("Carrier name"),
+    shipFrom: z
+      .object({
+        name: z.string().describe("Sender name"),
+        addressLine1: z.string().describe("Address line 1"),
+        addressLine2: z.string().optional().describe("Address line 2"),
+        addressLine3: z.string().optional().describe("Address line 3"),
+        city: z.string().describe("City"),
+        county: z.string().optional().describe("County"),
+        district: z.string().optional().describe("District"),
+        stateOrRegion: z.string().describe("State or region"),
+        postalCode: z.string().describe("Postal code"),
+        countryCode: z.string().describe("Country code (e.g., 'US')"),
+        phone: z.string().describe("Phone number"),
+      })
+      .optional()
+      .describe("Ship from address"),
+  }),
+  codCollectionMethod: z
+    .enum(["DirectPayment"])
+    .optional()
+    .describe("Cash on delivery collection method"),
+});
+
+export const getOrderRegulatedInfoSchema = z.object({
+  orderId: z.string().describe("Amazon order ID"),
+});