brinkcommerce-dev-mcp 0.1.0-beta.1

package/dist/tools/validation-middleware.js

@@ -0,0 +1,261 @@
+import { safeValidateArgs } from "../types/validation.js";
+import { logger } from "../logger.js";
+// API Docs types
+import { GetApiInfoArgsSchema, ListEndpointsArgsSchema, GetEndpointDetailsArgsSchema, ListSchemasArgsSchema, GetSchemaArgsSchema, SearchSchemasArgsSchema, } from "../types/api-docs-types.js";
+// Product types
+import { GetProductParentArgsSchema, CreateProductParentArgsSchema, DeleteProductParentArgsSchema, PatchProductParentArgsSchema, ArchiveProductParentArgsSchema, GetProductVariantArgsSchema, ListProductVariantsArgsSchema, CreateProductVariantArgsSchema, DeleteProductVariantArgsSchema, PatchProductVariantArgsSchema, GetAddonArgsSchema, CreateOrUpdateAddonArgsSchema, DeleteAddonArgsSchema, PatchAddonArgsSchema, ListProductParentAddonsArgsSchema, AddProductParentAddonArgsSchema, RemoveProductParentAddonArgsSchema, } from "../types/product-types.js";
+// Store types
+import { CreateOrUpdateStoreGroupArgsSchema, CreateOrUpdateStoreMarketArgsSchema, DeleteStoreGroupArgsSchema, DeleteStoreMarketArgsSchema, ListStoreGroupsArgsSchema, GetStoreGroupArgsSchema, ListStoreMarketsArgsSchema, PatchStoreGroupArgsSchema, PatchStoreMarketArgsSchema, } from "../types/store-types.js";
+// Inventory types
+import { UpdateProductVariantInventoryArgsSchema, DeleteProductVariantInventoryArgsSchema, ListInventoriesArgsSchema, GetInventoryArgsSchema, CreateOrUpdateInventoryArgsSchema, DeleteInventoryArgsSchema, GetProductVariantStockArgsSchema, UpdateProductVariantStockConfigArgsSchema, PatchProductVariantInventoryArgsSchema, GetStoreMarketInventoriesArgsSchema, UpdateStoreMarketInventoriesArgsSchema, } from "../types/inventory-types.js";
+// Price types
+import { UpdateProductVariantPricesArgsSchema, DeleteProductVariantPricesArgsSchema, GetProductVariantAllPricesArgsSchema, GetProductVariantPricesArgsSchema, GetProductVariantPriceArgsSchema, GetAddonPriceArgsSchema, PatchProductVariantPricesArgsSchema, } from "../types/price-types.js";
+// Order types
+import { GetOrderArgsSchema, GetOrderByReferenceArgsSchema, CancelOrderArgsSchema, RefundOrderArgsSchema, ImportOrderArgsSchema, GetImportedOrderArgsSchema, CreateDeliveryArgsSchema, GetDeliveryArgsSchema, UpdateDeliveryArgsSchema, DeleteDeliveryArgsSchema, StartDeliveryArgsSchema, RestartDeliveryArgsSchema, GetCancellationArgsSchema, DeleteCancellationArgsSchema, StartCancellationArgsSchema, RestartCancellationArgsSchema, GetRefundArgsSchema, UpdateRefundArgsSchema, DeleteRefundArgsSchema, StartRefundArgsSchema, RestartRefundArgsSchema, CreateReleaseArgsSchema, GetReleaseArgsSchema, DeleteReleaseArgsSchema, StartReleaseArgsSchema, RestartReleaseArgsSchema, GetOrdersByEmailArgsSchema, GetOrdersByMerchantRefArgsSchema, GetOrderHistoryArgsSchema, GetOrderReservationArgsSchema, DeleteOrderArgsSchema, ListOrderDeliveriesArgsSchema, ListOrderCancellationsArgsSchema, ListOrderRefundsArgsSchema, ListOrderReleasesArgsSchema, ListOrderCompensationsArgsSchema, ListOrderModificationsArgsSchema, CreateCompensationArgsSchema, GetCompensationArgsSchema, UpdateCompensationArgsSchema, DeleteCompensationArgsSchema, StartCompensationArgsSchema, RestartCompensationArgsSchema, CreateOrderLinesModificationArgsSchema, GetOrderLinesModificationArgsSchema, UpdateOrderLinesModificationArgsSchema, DeleteOrderLinesModificationArgsSchema, StartOrderLinesModificationArgsSchema, RestartOrderLinesModificationArgsSchema, CreateShippingFeesModificationArgsSchema, GetShippingFeesModificationArgsSchema, UpdateShippingFeesModificationArgsSchema, DeleteShippingFeesModificationArgsSchema, StartShippingFeesModificationArgsSchema, RestartShippingFeesModificationArgsSchema, CreateAddressesModificationArgsSchema, GetAddressesModificationArgsSchema, UpdateAddressesModificationArgsSchema, DeleteAddressesModificationArgsSchema, StartAddressesModificationArgsSchema, ListCustomStatesArgsSchema, GetCustomStateArgsSchema, CreateCustomStateArgsSchema, DeleteCustomStateArgsSchema, AddOrderCustomStateArgsSchema, RemoveOrderCustomStateArgsSchema, ListCustomReasonCodesArgsSchema, GetCustomReasonCodeArgsSchema, CreateCustomReasonCodeArgsSchema, DeleteCustomReasonCodeArgsSchema, CreateOrderCommentArgsSchema, UpdateOrderCommentArgsSchema, DeleteOrderCommentArgsSchema, } from "../types/order-types.js";
+// Discount types
+import { RunDiscountsArgsSchema, GetBundleGroupArgsSchema, CreateOrUpdateBundleGroupArgsSchema, DeleteBundleGroupArgsSchema, CreateDiscountCodeArgsSchema, } from "../types/discount-types.js";
+// Tax types
+import { GetTaxGroupArgsSchema, CreateOrUpdateTaxGroupArgsSchema, DeleteTaxGroupArgsSchema, GetTaxMarketsArgsSchema, CreateOrUpdateTaxMarketArgsSchema, DeleteTaxMarketArgsSchema, } from "../types/tax-types.js";
+/**
+ * Registry mapping tool names to their Zod validation schemas.
+ * This provides centralized validation for all MCP tools.
+ */
+const validatorRegistry = new Map([
+    // API Documentation tools
+    ["get_api_info", GetApiInfoArgsSchema],
+    ["list_endpoints", ListEndpointsArgsSchema],
+    ["get_endpoint_details", GetEndpointDetailsArgsSchema],
+    ["list_schemas", ListSchemasArgsSchema],
+    ["get_schema", GetSchemaArgsSchema],
+    ["search_schemas", SearchSchemasArgsSchema],
+    // Product Management tools
+    ["get_product_parent", GetProductParentArgsSchema],
+    ["create_product_parent", CreateProductParentArgsSchema],
+    ["delete_product_parent", DeleteProductParentArgsSchema],
+    ["patch_product_parent", PatchProductParentArgsSchema],
+    ["archive_product_parent", ArchiveProductParentArgsSchema],
+    ["get_product_variant", GetProductVariantArgsSchema],
+    ["list_product_variants", ListProductVariantsArgsSchema],
+    ["create_product_variant", CreateProductVariantArgsSchema],
+    ["delete_product_variant", DeleteProductVariantArgsSchema],
+    ["patch_product_variant", PatchProductVariantArgsSchema],
+    ["get_addon", GetAddonArgsSchema],
+    ["create_or_update_addon", CreateOrUpdateAddonArgsSchema],
+    ["delete_addon", DeleteAddonArgsSchema],
+    ["patch_addon", PatchAddonArgsSchema],
+    ["list_product_parent_addons", ListProductParentAddonsArgsSchema],
+    ["add_product_parent_addon", AddProductParentAddonArgsSchema],
+    ["remove_product_parent_addon", RemoveProductParentAddonArgsSchema],
+    // Store Management tools
+    ["create_or_update_store_group", CreateOrUpdateStoreGroupArgsSchema],
+    ["create_or_update_store_market", CreateOrUpdateStoreMarketArgsSchema],
+    ["delete_store_group", DeleteStoreGroupArgsSchema],
+    ["delete_store_market", DeleteStoreMarketArgsSchema],
+    ["list_store_groups", ListStoreGroupsArgsSchema],
+    ["get_store_group", GetStoreGroupArgsSchema],
+    ["list_store_markets", ListStoreMarketsArgsSchema],
+    ["patch_store_group", PatchStoreGroupArgsSchema],
+    ["patch_store_market", PatchStoreMarketArgsSchema],
+    // Inventory Management tools
+    ["update_product_variant_inventory", UpdateProductVariantInventoryArgsSchema],
+    ["delete_product_variant_inventory", DeleteProductVariantInventoryArgsSchema],
+    ["list_inventories", ListInventoriesArgsSchema],
+    ["get_inventory", GetInventoryArgsSchema],
+    ["create_or_update_inventory", CreateOrUpdateInventoryArgsSchema],
+    ["delete_inventory", DeleteInventoryArgsSchema],
+    ["get_product_variant_stock", GetProductVariantStockArgsSchema],
+    ["update_product_variant_stock_config", UpdateProductVariantStockConfigArgsSchema],
+    ["patch_product_variant_inventory", PatchProductVariantInventoryArgsSchema],
+    ["get_store_market_inventories", GetStoreMarketInventoriesArgsSchema],
+    ["update_store_market_inventories", UpdateStoreMarketInventoriesArgsSchema],
+    // Price Management tools
+    ["update_product_variant_prices", UpdateProductVariantPricesArgsSchema],
+    ["delete_product_variant_prices", DeleteProductVariantPricesArgsSchema],
+    ["get_product_variant_all_prices", GetProductVariantAllPricesArgsSchema],
+    ["get_product_variant_prices", GetProductVariantPricesArgsSchema],
+    ["get_product_variant_price", GetProductVariantPriceArgsSchema],
+    ["get_addon_price", GetAddonPriceArgsSchema],
+    ["patch_product_variant_prices", PatchProductVariantPricesArgsSchema],
+    // Order Management tools
+    ["get_order", GetOrderArgsSchema],
+    ["get_order_by_reference", GetOrderByReferenceArgsSchema],
+    ["cancel_order", CancelOrderArgsSchema],
+    ["refund_order", RefundOrderArgsSchema],
+    ["import_order", ImportOrderArgsSchema],
+    ["get_imported_order", GetImportedOrderArgsSchema],
+    ["create_delivery", CreateDeliveryArgsSchema],
+    ["get_delivery", GetDeliveryArgsSchema],
+    ["update_delivery", UpdateDeliveryArgsSchema],
+    ["delete_delivery", DeleteDeliveryArgsSchema],
+    ["start_delivery", StartDeliveryArgsSchema],
+    ["restart_delivery", RestartDeliveryArgsSchema],
+    ["get_cancellation", GetCancellationArgsSchema],
+    ["delete_cancellation", DeleteCancellationArgsSchema],
+    ["start_cancellation", StartCancellationArgsSchema],
+    ["restart_cancellation", RestartCancellationArgsSchema],
+    ["get_refund", GetRefundArgsSchema],
+    ["update_refund", UpdateRefundArgsSchema],
+    ["delete_refund", DeleteRefundArgsSchema],
+    ["start_refund", StartRefundArgsSchema],
+    ["restart_refund", RestartRefundArgsSchema],
+    ["create_release", CreateReleaseArgsSchema],
+    ["get_release", GetReleaseArgsSchema],
+    ["delete_release", DeleteReleaseArgsSchema],
+    ["start_release", StartReleaseArgsSchema],
+    ["restart_release", RestartReleaseArgsSchema],
+    ["get_orders_by_email", GetOrdersByEmailArgsSchema],
+    ["get_orders_by_merchant_ref", GetOrdersByMerchantRefArgsSchema],
+    ["get_order_history", GetOrderHistoryArgsSchema],
+    ["get_order_reservation", GetOrderReservationArgsSchema],
+    ["delete_order", DeleteOrderArgsSchema],
+    ["list_order_deliveries", ListOrderDeliveriesArgsSchema],
+    ["list_order_cancellations", ListOrderCancellationsArgsSchema],
+    ["list_order_refunds", ListOrderRefundsArgsSchema],
+    ["list_order_releases", ListOrderReleasesArgsSchema],
+    ["list_order_compensations", ListOrderCompensationsArgsSchema],
+    ["list_order_modifications", ListOrderModificationsArgsSchema],
+    ["create_compensation", CreateCompensationArgsSchema],
+    ["get_compensation", GetCompensationArgsSchema],
+    ["update_compensation", UpdateCompensationArgsSchema],
+    ["delete_compensation", DeleteCompensationArgsSchema],
+    ["start_compensation", StartCompensationArgsSchema],
+    ["restart_compensation", RestartCompensationArgsSchema],
+    ["create_order_lines_modification", CreateOrderLinesModificationArgsSchema],
+    ["get_order_lines_modification", GetOrderLinesModificationArgsSchema],
+    ["update_order_lines_modification", UpdateOrderLinesModificationArgsSchema],
+    ["delete_order_lines_modification", DeleteOrderLinesModificationArgsSchema],
+    ["start_order_lines_modification", StartOrderLinesModificationArgsSchema],
+    ["restart_order_lines_modification", RestartOrderLinesModificationArgsSchema],
+    ["create_shipping_fees_modification", CreateShippingFeesModificationArgsSchema],
+    ["get_shipping_fees_modification", GetShippingFeesModificationArgsSchema],
+    ["update_shipping_fees_modification", UpdateShippingFeesModificationArgsSchema],
+    ["delete_shipping_fees_modification", DeleteShippingFeesModificationArgsSchema],
+    ["start_shipping_fees_modification", StartShippingFeesModificationArgsSchema],
+    ["restart_shipping_fees_modification", RestartShippingFeesModificationArgsSchema],
+    ["create_addresses_modification", CreateAddressesModificationArgsSchema],
+    ["get_addresses_modification", GetAddressesModificationArgsSchema],
+    ["update_addresses_modification", UpdateAddressesModificationArgsSchema],
+    ["delete_addresses_modification", DeleteAddressesModificationArgsSchema],
+    ["start_addresses_modification", StartAddressesModificationArgsSchema],
+    ["list_custom_states", ListCustomStatesArgsSchema],
+    ["get_custom_state", GetCustomStateArgsSchema],
+    ["create_custom_state", CreateCustomStateArgsSchema],
+    ["delete_custom_state", DeleteCustomStateArgsSchema],
+    ["add_order_custom_state", AddOrderCustomStateArgsSchema],
+    ["remove_order_custom_state", RemoveOrderCustomStateArgsSchema],
+    ["list_custom_reason_codes", ListCustomReasonCodesArgsSchema],
+    ["get_custom_reason_code", GetCustomReasonCodeArgsSchema],
+    ["create_custom_reason_code", CreateCustomReasonCodeArgsSchema],
+    ["delete_custom_reason_code", DeleteCustomReasonCodeArgsSchema],
+    ["create_order_comment", CreateOrderCommentArgsSchema],
+    ["update_order_comment", UpdateOrderCommentArgsSchema],
+    ["delete_order_comment", DeleteOrderCommentArgsSchema],
+    // Discount Management tools
+    ["run_discounts", RunDiscountsArgsSchema],
+    ["get_bundle_group", GetBundleGroupArgsSchema],
+    ["create_or_update_bundle_group", CreateOrUpdateBundleGroupArgsSchema],
+    ["delete_bundle_group", DeleteBundleGroupArgsSchema],
+    ["create_discount_code", CreateDiscountCodeArgsSchema],
+    // Tax Management tools
+    ["get_tax_group", GetTaxGroupArgsSchema],
+    ["create_or_update_tax_group", CreateOrUpdateTaxGroupArgsSchema],
+    ["delete_tax_group", DeleteTaxGroupArgsSchema],
+    ["get_tax_markets", GetTaxMarketsArgsSchema],
+    ["create_or_update_tax_market", CreateOrUpdateTaxMarketArgsSchema],
+    ["delete_tax_market", DeleteTaxMarketArgsSchema],
+]);
+/**
+ * Formats validation errors into a user-friendly message
+ */
+function formatValidationError(error) {
+    const issues = error.issues
+        .map((issue) => {
+        const path = issue.path.length > 0 ? issue.path.join(".") : "root";
+        return `  - ${path}: ${issue.message}`;
+    })
+        .join("\n");
+    return `Validation Error: Invalid arguments provided\n\n${issues}\n\nPlease check the tool documentation for correct parameter formats.`;
+}
+/**
+ * Validation middleware that wraps handler calls with Zod validation.
+ *
+ * This function provides centralized validation for all MCP tool handlers:
+ * 1. Checks if a validator exists for the tool
+ * 2. Validates arguments against the Zod schema
+ * 3. Returns formatted error if validation fails
+ * 4. Calls handler with validated arguments if successful
+ *
+ * @param toolName - Name of the MCP tool being called
+ * @param args - Raw arguments from the MCP request
+ * @param handler - Handler function to call with validated arguments
+ * @returns Promise resolving to the handler's response or a validation error
+ */
+export async function validateAndCall(toolName, args, handler) {
+    const schema = validatorRegistry.get(toolName);
+    // No validator registered for this tool - pass through without validation
+    if (!schema) {
+        logger.debug(`No validator found for tool: ${toolName}`);
+        try {
+            const result = await handler(args);
+            return result;
+        }
+        catch (error) {
+            logger.error(`Handler error for ${toolName}`, { error });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error: ${error instanceof Error ? error.message : "Unknown error occurred"}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Validate arguments
+    const validationResult = safeValidateArgs(schema, args);
+    if (!validationResult.success) {
+        logger.warn(`Validation failed for tool: ${toolName}`, {
+            error: validationResult.error,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: formatValidationError(validationResult.error),
+                },
+            ],
+            isError: true,
+        };
+    }
+    // Call handler with validated arguments
+    try {
+        logger.debug(`Calling handler for ${toolName} with validated args`);
+        const result = await handler(validationResult.data);
+        return result;
+    }
+    catch (error) {
+        logger.error(`Handler error for ${toolName}`, { error });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : "Unknown error occurred"}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+}
+/**
+ * Gets the total number of registered validators
+ */
+export function getValidatorCount() {
+    return validatorRegistry.size;
+}
+/**
+ * Checks if a validator exists for a given tool name
+ */
+export function hasValidator(toolName) {
+    return validatorRegistry.has(toolName);
+}

package/dist/tools/validation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Shared validation utilities for BrinkCommerce MCP tools
+ *
+ * This module provides reusable validation functions for common data formats
+ * used across BrinkCommerce APIs (country codes, currency codes, etc.)
+ */
+/**
+ * Validation result interface
+ */
+export interface ValidationResult {
+    valid: boolean;
+    error?: string;
+}
+/**
+ * Validate ISO-3166-1 alpha-2 country code format
+ *
+ * @param code - The country code to validate
+ * @param fieldName - Optional field name for error messages (defaults to "countryCode")
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateCountryCode("SE") // { valid: true }
+ * validateCountryCode("USA") // { valid: false, error: "..." }
+ */
+export declare function validateCountryCode(code: string, fieldName?: string): ValidationResult;
+/**
+ * Validate ISO 4217 currency code format
+ *
+ * @param code - The currency code to validate
+ * @param fieldName - Optional field name for error messages (defaults to "currencyCode")
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateCurrencyCode("SEK") // { valid: true }
+ * validateCurrencyCode("USD") // { valid: true }
+ * validateCurrencyCode("US") // { valid: false, error: "..." }
+ */
+export declare function validateCurrencyCode(code: string, fieldName?: string): ValidationResult;
+/**
+ * Validate array size against maximum limit
+ *
+ * @param array - The array to validate
+ * @param maxSize - Maximum allowed size
+ * @param itemName - Descriptive name for the items (for error messages)
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateArraySize([1, 2, 3], 5, "prices") // { valid: true }
+ * validateArraySize([...201 items], 200, "prices") // { valid: false, error: "..." }
+ */
+export declare function validateArraySize<T>(array: T[], maxSize: number, itemName: string): ValidationResult;
+/**
+ * Validate array for duplicate values based on a key extractor function
+ *
+ * @param array - The array to validate
+ * @param keyExtractor - Function to extract the key to check for duplicates
+ * @param itemName - Descriptive name for the items (for error messages)
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateNoDuplicates(
+ *   [{countryCode: "SE"}, {countryCode: "NO"}],
+ *   item => item.countryCode,
+ *   "country codes"
+ * ) // { valid: true }
+ */
+export declare function validateNoDuplicates<T>(array: T[], keyExtractor: (item: T) => string, itemName: string): ValidationResult;

package/dist/tools/validation.js

@@ -0,0 +1,99 @@
+/**
+ * Shared validation utilities for BrinkCommerce MCP tools
+ *
+ * This module provides reusable validation functions for common data formats
+ * used across BrinkCommerce APIs (country codes, currency codes, etc.)
+ */
+/**
+ * Validate ISO-3166-1 alpha-2 country code format
+ *
+ * @param code - The country code to validate
+ * @param fieldName - Optional field name for error messages (defaults to "countryCode")
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateCountryCode("SE") // { valid: true }
+ * validateCountryCode("USA") // { valid: false, error: "..." }
+ */
+export function validateCountryCode(code, fieldName = "countryCode") {
+    const pattern = /^[A-Z]{2}$/;
+    if (!pattern.test(code)) {
+        return {
+            valid: false,
+            error: `Invalid ${fieldName}: "${code}". Must be a 2-letter uppercase ISO-3166-1 alpha-2 country code (e.g., "SE", "NO", "DK").`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate ISO 4217 currency code format
+ *
+ * @param code - The currency code to validate
+ * @param fieldName - Optional field name for error messages (defaults to "currencyCode")
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateCurrencyCode("SEK") // { valid: true }
+ * validateCurrencyCode("USD") // { valid: true }
+ * validateCurrencyCode("US") // { valid: false, error: "..." }
+ */
+export function validateCurrencyCode(code, fieldName = "currencyCode") {
+    const pattern = /^[A-Z]{3}$/;
+    if (!pattern.test(code)) {
+        return {
+            valid: false,
+            error: `Invalid ${fieldName}: "${code}". Must be a 3-letter uppercase ISO 4217 currency code (e.g., "SEK", "NOK", "EUR").`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate array size against maximum limit
+ *
+ * @param array - The array to validate
+ * @param maxSize - Maximum allowed size
+ * @param itemName - Descriptive name for the items (for error messages)
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateArraySize([1, 2, 3], 5, "prices") // { valid: true }
+ * validateArraySize([...201 items], 200, "prices") // { valid: false, error: "..." }
+ */
+export function validateArraySize(array, maxSize, itemName) {
+    if (array.length > maxSize) {
+        return {
+            valid: false,
+            error: `Too many ${itemName}: ${array.length}. Maximum allowed is ${maxSize} per request.`,
+        };
+    }
+    return { valid: true };
+}
+/**
+ * Validate array for duplicate values based on a key extractor function
+ *
+ * @param array - The array to validate
+ * @param keyExtractor - Function to extract the key to check for duplicates
+ * @param itemName - Descriptive name for the items (for error messages)
+ * @returns Validation result with success status and optional error message
+ *
+ * @example
+ * validateNoDuplicates(
+ *   [{countryCode: "SE"}, {countryCode: "NO"}],
+ *   item => item.countryCode,
+ *   "country codes"
+ * ) // { valid: true }
+ */
+export function validateNoDuplicates(array, keyExtractor, itemName) {
+    const keys = array.map(keyExtractor);
+    const uniqueKeys = new Set(keys);
+    if (keys.length !== uniqueKeys.size) {
+        // Find the duplicates for a helpful error message
+        const duplicates = keys.filter((key, index) => keys.indexOf(key) !== index);
+        const uniqueDuplicates = Array.from(new Set(duplicates));
+        return {
+            valid: false,
+            error: `Duplicate ${itemName} found: ${uniqueDuplicates.join(", ")}. Each ${itemName} must be unique.`,
+        };
+    }
+    return { valid: true };
+}

package/dist/types/api-docs-types.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+/**
+ * API Documentation Tool Arguments
+ *
+ * These schemas define and validate the arguments for API documentation tools.
+ * Each tool has a corresponding Zod schema that provides runtime validation
+ * and TypeScript type inference.
+ */
+export declare const ListApisArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type ListApisArgs = z.infer<typeof ListApisArgsSchema>;
+export declare const GetApiInfoArgsSchema: z.ZodObject<{
+    apiName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    apiName: string;
+}, {
+    apiName: string;
+}>;
+export type GetApiInfoArgs = z.infer<typeof GetApiInfoArgsSchema>;
+export declare const ListEndpointsArgsSchema: z.ZodObject<{
+    apiName: z.ZodString;
+    method: z.ZodOptional<z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH"]>>;
+    tag: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    apiName: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    tag?: string | undefined;
+}, {
+    apiName: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | undefined;
+    tag?: string | undefined;
+}>;
+export type ListEndpointsArgs = z.infer<typeof ListEndpointsArgsSchema>;
+export declare const GetEndpointDetailsArgsSchema: z.ZodObject<{
+    apiName: z.ZodString;
+    path: z.ZodString;
+    method: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH"]>;
+}, "strip", z.ZodTypeAny, {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    apiName: string;
+}, {
+    method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    path: string;
+    apiName: string;
+}>;
+export type GetEndpointDetailsArgs = z.infer<typeof GetEndpointDetailsArgsSchema>;
+export declare const ListSchemasArgsSchema: z.ZodObject<{
+    apiName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    apiName: string;
+}, {
+    apiName: string;
+}>;
+export type ListSchemasArgs = z.infer<typeof ListSchemasArgsSchema>;
+export declare const GetSchemaArgsSchema: z.ZodObject<{
+    apiName: z.ZodString;
+    schemaName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    apiName: string;
+    schemaName: string;
+}, {
+    apiName: string;
+    schemaName: string;
+}>;
+export type GetSchemaArgs = z.infer<typeof GetSchemaArgsSchema>;
+export declare const SearchSchemasArgsSchema: z.ZodObject<{
+    query: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+}, {
+    query: string;
+}>;
+export type SearchSchemasArgs = z.infer<typeof SearchSchemasArgsSchema>;
+export declare const GetDocsInfoArgsSchema: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+export type GetDocsInfoArgs = z.infer<typeof GetDocsInfoArgsSchema>;
+/**
+ * Union type of all API docs tool arguments
+ */
+export type ApiDocsArgs = ListApisArgs | GetApiInfoArgs | ListEndpointsArgs | GetEndpointDetailsArgs | ListSchemasArgs | GetSchemaArgs | SearchSchemasArgs | GetDocsInfoArgs;

package/dist/types/api-docs-types.js

@@ -0,0 +1,41 @@
+import { z } from "zod";
+/**
+ * API Documentation Tool Arguments
+ *
+ * These schemas define and validate the arguments for API documentation tools.
+ * Each tool has a corresponding Zod schema that provides runtime validation
+ * and TypeScript type inference.
+ */
+// list_apis - no arguments
+export const ListApisArgsSchema = z.object({});
+// get_api_info
+export const GetApiInfoArgsSchema = z.object({
+    apiName: z.string().describe("Name of the API specification (e.g., 'product-management', 'order-management')"),
+});
+// list_endpoints
+export const ListEndpointsArgsSchema = z.object({
+    apiName: z.string().describe("Name of the API specification"),
+    method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]).optional().describe("Filter by HTTP method"),
+    tag: z.string().optional().describe("Filter by OpenAPI tag/category"),
+});
+// get_endpoint_details
+export const GetEndpointDetailsArgsSchema = z.object({
+    apiName: z.string().describe("Name of the API specification"),
+    path: z.string().describe("API path (e.g., /products/{id}, /orders)"),
+    method: z.enum(["GET", "POST", "PUT", "DELETE", "PATCH"]).describe("HTTP method"),
+});
+// list_schemas
+export const ListSchemasArgsSchema = z.object({
+    apiName: z.string().describe("Name of the API specification"),
+});
+// get_schema
+export const GetSchemaArgsSchema = z.object({
+    apiName: z.string().describe("Name of the API specification"),
+    schemaName: z.string().describe("Name of the schema (e.g., Product, Order, Customer)"),
+});
+// search_schemas
+export const SearchSchemasArgsSchema = z.object({
+    query: z.string().describe("Search term to find in schema names, descriptions, or field names"),
+});
+// get_docs_info - no arguments
+export const GetDocsInfoArgsSchema = z.object({});

package/dist/types/discount-types.d.ts

@@ -0,0 +1,115 @@
+import { z } from "zod";
+export declare const RunDiscountsArgsSchema: z.ZodObject<{
+    storeGroupId: z.ZodString;
+    countryCode: z.ZodString;
+    currencyCode: z.ZodString;
+    items: z.ZodArray<z.ZodObject<{
+        productVariantId: z.ZodString;
+        quantity: z.ZodNumber;
+        unitPrice: z.ZodNumber;
+        tags: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>>;
+    }, "strip", z.ZodTypeAny, {
+        productVariantId: string;
+        quantity: number;
+        unitPrice: number;
+        tags?: Record<string, string[]> | undefined;
+    }, {
+        productVariantId: string;
+        quantity: number;
+        unitPrice: number;
+        tags?: Record<string, string[]> | undefined;
+    }>, "many">;
+    discountCartRules: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    discountCodeRules: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+    discountExternalRules: z.ZodOptional<z.ZodArray<z.ZodAny, "many">>;
+}, "strip", z.ZodTypeAny, {
+    storeGroupId: string;
+    countryCode: string;
+    currencyCode: string;
+    items: {
+        productVariantId: string;
+        quantity: number;
+        unitPrice: number;
+        tags?: Record<string, string[]> | undefined;
+    }[];
+    discountCodeRules?: any[] | undefined;
+    discountExternalRules?: any[] | undefined;
+    discountCartRules?: any[] | undefined;
+}, {
+    storeGroupId: string;
+    countryCode: string;
+    currencyCode: string;
+    items: {
+        productVariantId: string;
+        quantity: number;
+        unitPrice: number;
+        tags?: Record<string, string[]> | undefined;
+    }[];
+    discountCodeRules?: any[] | undefined;
+    discountExternalRules?: any[] | undefined;
+    discountCartRules?: any[] | undefined;
+}>;
+export type RunDiscountsArgs = z.infer<typeof RunDiscountsArgsSchema>;
+export declare const GetBundleGroupArgsSchema: z.ZodObject<{
+    bundleGroupId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    bundleGroupId: string;
+}, {
+    bundleGroupId: string;
+}>;
+export type GetBundleGroupArgs = z.infer<typeof GetBundleGroupArgsSchema>;
+export declare const CreateOrUpdateBundleGroupArgsSchema: z.ZodObject<{
+    bundleGroupId: z.ZodString;
+    name: z.ZodString;
+    storeMarkets: z.ZodRecord<z.ZodString, z.ZodArray<z.ZodString, "many">>;
+    bundles: z.ZodArray<z.ZodAny, "many">;
+    isActive: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    isActive: boolean;
+    storeMarkets: Record<string, string[]>;
+    bundleGroupId: string;
+    bundles: any[];
+}, {
+    name: string;
+    isActive: boolean;
+    storeMarkets: Record<string, string[]>;
+    bundleGroupId: string;
+    bundles: any[];
+}>;
+export type CreateOrUpdateBundleGroupArgs = z.infer<typeof CreateOrUpdateBundleGroupArgsSchema>;
+export declare const DeleteBundleGroupArgsSchema: z.ZodObject<{
+    bundleGroupId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    bundleGroupId: string;
+}, {
+    bundleGroupId: string;
+}>;
+export type DeleteBundleGroupArgs = z.infer<typeof DeleteBundleGroupArgsSchema>;
+export declare const CreateDiscountCodeArgsSchema: z.ZodObject<{
+    discountCodeRuleId: z.ZodString;
+    code: z.ZodString;
+    isUnlimited: z.ZodDefault<z.ZodBoolean>;
+    usageLimit: z.ZodOptional<z.ZodNumber>;
+    validFrom: z.ZodOptional<z.ZodString>;
+    validTo: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    isUnlimited: boolean;
+    discountCodeRuleId: string;
+    usageLimit?: number | undefined;
+    validFrom?: string | undefined;
+    validTo?: string | undefined;
+}, {
+    code: string;
+    discountCodeRuleId: string;
+    isUnlimited?: boolean | undefined;
+    usageLimit?: number | undefined;
+    validFrom?: string | undefined;
+    validTo?: string | undefined;
+}>;
+export type CreateDiscountCodeArgs = z.infer<typeof CreateDiscountCodeArgsSchema>;
+/**
+ * Union type of all discount management tool arguments
+ */
+export type DiscountArgs = RunDiscountsArgs | GetBundleGroupArgs | CreateOrUpdateBundleGroupArgs | DeleteBundleGroupArgs | CreateDiscountCodeArgs;