brinkcommerce-dev-mcp 0.1.0-beta.2 → 0.1.0

package/dist/product-tools.js

@@ -1,434 +0,0 @@
-import { createProductManagementClient } from "./api-client.js";
-import { logger } from "./logger.js";
-/**
- * Check if confirmation tokens are required
- */
-function isConfirmationRequired() {
-    const envValue = process.env.BRINK_REQUIRE_CONFIRMATION;
-    // Default to true (enabled) if not set or invalid value
-    return envValue !== "false" && envValue !== "0";
-}
-/**
- * Validate confirmation token for a create operation
- */
-function validateConfirmationToken(resourceId, providedToken) {
-    // If confirmation not required, skip validation
-    if (!isConfirmationRequired()) {
-        return { valid: true };
-    }
-    const expectedToken = `CREATE:${resourceId}`;
-    if (!providedToken) {
-        return {
-            valid: false,
-            error: `⚠️ CONFIRMATION REQUIRED\n\nThis will create/update resource: ${resourceId}\n\nTo confirm this operation, you must provide:\n  confirmToken: "${expectedToken}"\n\nThis ensures you understand which resource will be affected.\n\nTo disable this safety check, set BRINK_REQUIRE_CONFIRMATION=false (not recommended for production).`,
-        };
-    }
-    if (providedToken !== expectedToken) {
-        return {
-            valid: false,
-            error: `❌ INVALID CONFIRMATION TOKEN\n\nExpected: "${expectedToken}"\nReceived: "${providedToken}"\n\nThe token must match the resource ID exactly.\nFormat: CREATE:<resourceId>`,
-        };
-    }
-    return { valid: true };
-}
-/**
- * MCP Tool Definitions for Product Management
- */
-export const productTools = {
-    create_product_parent: {
-        name: "create_product_parent",
-        description: "Create or update a product parent in BrinkCommerce. A product parent is the top-level container for product variants.",
-        inputSchema: {
-            type: "object",
-            properties: {
-                productParentId: {
-                    type: "string",
-                    description: "Unique identifier for the product parent",
-                },
-                name: {
-                    type: "string",
-                    description: "Descriptive name of the product parent",
-                },
-                description: {
-                    type: "string",
-                    description: "Description of the product parent",
-                },
-                displayNames: {
-                    type: "object",
-                    description: 'Translations for product name (e.g., {"en": "Product", "sv": "Produkt"})',
-                    additionalProperties: {
-                        type: "string",
-                    },
-                },
-                displayDescriptions: {
-                    type: "object",
-                    description: 'Translations for product description (e.g., {"en": "Description", "sv": "Beskrivning"})',
-                    additionalProperties: {
-                        type: "string",
-                    },
-                },
-                isActive: {
-                    type: "boolean",
-                    description: "Whether the product parent is active",
-                    default: true,
-                },
-                imageUrl: {
-                    type: "string",
-                    description: "Product image URL (absolute URI)",
-                },
-                customAttributes: {
-                    type: "object",
-                    description: "Custom attributes available in Shopper Cart (max 20 char keys, 500 char values)",
-                    additionalProperties: {
-                        type: "string",
-                    },
-                    default: {},
-                },
-                confirmToken: {
-                    type: "string",
-                    description: "⚠️ CONFIRMATION TOKEN (required by default): Must be 'CREATE:<productParentId>' to confirm this operation. " +
-                        "Example: if productParentId is 'shoe-123', token must be 'CREATE:shoe-123'. " +
-                        "This safety measure prevents accidental bulk operations. " +
-                        "Can be disabled by setting BRINK_REQUIRE_CONFIRMATION=false (not recommended for production).",
-                },
-            },
-            required: ["productParentId", "name", "description", "displayNames", "displayDescriptions"],
-        },
-    },
-    create_product_variant: {
-        name: "create_product_variant",
-        description: "Create or update a product variant in BrinkCommerce. A product variant is the actual sellable product (e.g., size, color).",
-        inputSchema: {
-            type: "object",
-            properties: {
-                productVariantId: {
-                    type: "string",
-                    description: "Unique identifier for the product variant",
-                },
-                productParentId: {
-                    type: "string",
-                    description: "Product parent ID this variant belongs to",
-                },
-                name: {
-                    type: "string",
-                    description: "Variant name",
-                },
-                description: {
-                    type: "string",
-                    description: "Variant description",
-                },
-                displayNames: {
-                    type: "object",
-                    description: 'Translations for variant name (e.g., {"en": "Small Blue", "sv": "Liten Blå"})',
-                    additionalProperties: {
-                        type: "string",
-                    },
-                },
-                displayDescriptions: {
-                    type: "object",
-                    description: "Translations for variant description",
-                    additionalProperties: {
-                        type: "string",
-                    },
-                },
-                taxGroupId: {
-                    type: "string",
-                    description: "Tax group ID for the variant",
-                },
-                imageUrl: {
-                    type: "string",
-                    description: "Variant image URL (absolute URI)",
-                },
-                isActive: {
-                    type: "boolean",
-                    description: "Whether the variant is active",
-                    default: true,
-                },
-                tags: {
-                    type: "object",
-                    description: "Discount tags for the variant (e.g., {\"discount\": [\"summer-sale\", \"clearance\"]})",
-                    additionalProperties: {
-                        type: "array",
-                        items: {
-                            type: "string",
-                        },
-                    },
-                    default: {},
-                },
-                customAttributes: {
-                    type: "object",
-                    description: "Custom attributes available in Shopper Cart",
-                    additionalProperties: {
-                        type: "string",
-                    },
-                    default: {},
-                },
-                weight: {
-                    type: "integer",
-                    description: "Weight in grams",
-                },
-                dimensions: {
-                    type: "object",
-                    properties: {
-                        width: {
-                            type: "number",
-                            description: "Width in millimeters",
-                        },
-                        length: {
-                            type: "number",
-                            description: "Length in millimeters",
-                        },
-                        height: {
-                            type: "number",
-                            description: "Height in millimeters",
-                        },
-                    },
-                    required: ["width", "length", "height"],
-                    description: "Product dimensions in millimeters (all fields required if provided)",
-                },
-                shippingAttributes: {
-                    type: "array",
-                    description: "Shipping attributes for the variant",
-                    items: {
-                        type: "string",
-                    },
-                },
-                confirmToken: {
-                    type: "string",
-                    description: "⚠️ CONFIRMATION TOKEN (required by default): Must be 'CREATE:<productVariantId>' to confirm this operation. " +
-                        "Example: if productVariantId is 'variant-456', token must be 'CREATE:variant-456'. " +
-                        "This safety measure prevents accidental bulk operations. " +
-                        "Can be disabled by setting BRINK_REQUIRE_CONFIRMATION=false (not recommended for production).",
-                },
-            },
-            required: [
-                "productVariantId",
-                "productParentId",
-                "name",
-                "description",
-                "displayNames",
-                "displayDescriptions",
-                "taxGroupId",
-                "imageUrl",
-            ],
-        },
-    },
-};
-/**
- * Handle create_product_parent tool call
- */
-export async function handleCreateProductParent(params) {
-    try {
-        logger.info("Handling create_product_parent tool call", {
-            productParentId: params.productParentId,
-            confirmationRequired: isConfirmationRequired(),
-        });
-        // Validate required parameters
-        const requiredFields = ["productParentId", "name", "description", "displayNames", "displayDescriptions"];
-        for (const field of requiredFields) {
-            if (!params[field]) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error: Missing required field '${field}'`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        }
-        // At this point, required fields are guaranteed to exist
-        const productParentId = params.productParentId;
-        const name = params.name;
-        const description = params.description;
-        const displayNames = params.displayNames;
-        const displayDescriptions = params.displayDescriptions;
-        // Validate confirmation token (if required)
-        const tokenValidation = validateConfirmationToken(productParentId, params.confirmToken);
-        if (!tokenValidation.valid) {
-            logger.warn("Confirmation token validation failed", {
-                productParentId,
-                providedToken: params.confirmToken,
-            });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: tokenValidation.error ?? "Invalid confirmation token",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        // Create API client
-        const client = createProductManagementClient();
-        // Build request
-        const request = {
-            name,
-            description,
-            displayNames,
-            displayDescriptions,
-            isActive: params.isActive ?? true,
-            customAttributes: params.customAttributes ?? {},
-            ...(params.imageUrl && { imageUrl: params.imageUrl }),
-        };
-        // Call API
-        const result = await client.createProductParent(productParentId, request);
-        if (result.success) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `✓ Successfully created product parent: ${productParentId}\n\nProduct parent is now available in BrinkCommerce.`,
-                    },
-                ],
-            };
-        }
-        else {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `✗ Failed to create product parent: ${result.error?.message}\n\nStatus: ${result.error?.status}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    }
-    catch (error) {
-        logger.error("Error in handleCreateProductParent", { error });
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `✗ Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}
-/**
- * Handle create_product_variant tool call
- */
-export async function handleCreateProductVariant(params) {
-    try {
-        logger.info("Handling create_product_variant tool call", {
-            productVariantId: params.productVariantId,
-            productParentId: params.productParentId,
-            confirmationRequired: isConfirmationRequired(),
-        });
-        // Validate required parameters
-        const requiredFields = [
-            "productVariantId",
-            "productParentId",
-            "name",
-            "description",
-            "displayNames",
-            "displayDescriptions",
-            "taxGroupId",
-            "imageUrl",
-        ];
-        for (const field of requiredFields) {
-            if (!params[field]) {
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Error: Missing required field '${field}'`,
-                        },
-                    ],
-                    isError: true,
-                };
-            }
-        }
-        // At this point, required fields are guaranteed to exist
-        const productVariantId = params.productVariantId;
-        const productParentId = params.productParentId;
-        const name = params.name;
-        const description = params.description;
-        const displayNames = params.displayNames;
-        const displayDescriptions = params.displayDescriptions;
-        const taxGroupId = params.taxGroupId;
-        const imageUrl = params.imageUrl;
-        // Validate confirmation token (if required)
-        const tokenValidation = validateConfirmationToken(productVariantId, params.confirmToken);
-        if (!tokenValidation.valid) {
-            logger.warn("Confirmation token validation failed", {
-                productVariantId,
-                providedToken: params.confirmToken,
-            });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: tokenValidation.error ?? "Invalid confirmation token",
-                    },
-                ],
-                isError: true,
-            };
-        }
-        // Create API client
-        const client = createProductManagementClient();
-        // Convert arrays to Sets as required by the API
-        const tags = {};
-        if (params.tags) {
-            for (const [key, value] of Object.entries(params.tags)) {
-                tags[key] = new Set(value);
-            }
-        }
-        // Build request
-        const request = {
-            productParentId,
-            name,
-            description,
-            displayNames,
-            displayDescriptions,
-            taxGroupId,
-            imageUrl,
-            isActive: params.isActive ?? true,
-            tags,
-            customAttributes: params.customAttributes ?? {},
-            ...(params.weight && { weight: params.weight }),
-            ...(params.dimensions && { dimensions: params.dimensions }),
-            ...(params.shippingAttributes && { shippingAttributes: new Set(params.shippingAttributes) }),
-        };
-        // Call API
-        const result = await client.createProductVariant(productVariantId, request);
-        if (result.success) {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `✓ Successfully created product variant: ${productVariantId}\n\nVariant is now available under product parent: ${productParentId}`,
-                    },
-                ],
-            };
-        }
-        else {
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: `✗ Failed to create product variant: ${result.error?.message}\n\nStatus: ${result.error?.status}`,
-                    },
-                ],
-                isError: true,
-            };
-        }
-    }
-    catch (error) {
-        logger.error("Error in handleCreateProductVariant", { error });
-        return {
-            content: [
-                {
-                    type: "text",
-                    text: `✗ Unexpected error: ${error instanceof Error ? error.message : "Unknown error"}`,
-                },
-            ],
-            isError: true,
-        };
-    }
-}

package/dist/tools/confirmation.d.ts

@@ -1,52 +0,0 @@
-/**
- * Shared confirmation token utilities for BrinkCommerce MCP tools
- *
- * This module provides reusable confirmation token validation logic to prevent
- * accidental operations in production environments.
- */
-/**
- * Validation result interface
- */
-export interface ValidationResult {
-    valid: boolean;
-    error?: string;
-}
-/**
- * Check if confirmation tokens are required based on environment configuration
- *
- * @returns true if confirmation is required, false otherwise
- */
-export declare function isConfirmationRequired(): boolean;
-/**
- * Validate confirmation token for an operation
- *
- * @param operation - The operation type (e.g., "CREATE", "UPDATE", "DELETE")
- * @param resourceId - The unique identifier(s) of the resource being affected
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export declare function validateConfirmationToken(operation: string, resourceId: string, providedToken: string | undefined): ValidationResult;
-/**
- * Convenience wrapper for validating CREATE operation confirmation tokens
- *
- * @param resourceId - The unique identifier of the resource being created
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export declare function validateCreateConfirmation(resourceId: string, providedToken: string | undefined): ValidationResult;
-/**
- * Convenience wrapper for validating UPDATE operation confirmation tokens
- *
- * @param resourceId - The unique identifier of the resource being updated
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export declare function validateUpdateConfirmation(resourceId: string, providedToken: string | undefined): ValidationResult;
-/**
- * Convenience wrapper for validating DELETE operation confirmation tokens
- *
- * @param resourceId - The unique identifier of the resource being deleted
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export declare function validateDeleteConfirmation(resourceId: string, providedToken: string | undefined): ValidationResult;

package/dist/tools/confirmation.js

@@ -1,74 +0,0 @@
-/**
- * Shared confirmation token utilities for BrinkCommerce MCP tools
- *
- * This module provides reusable confirmation token validation logic to prevent
- * accidental operations in production environments.
- */
-/**
- * Check if confirmation tokens are required based on environment configuration
- *
- * @returns true if confirmation is required, false otherwise
- */
-export function isConfirmationRequired() {
-    const envValue = process.env.BRINK_REQUIRE_CONFIRMATION;
-    // Default to true (enabled) if not set or invalid value
-    return envValue !== "false" && envValue !== "0";
-}
-/**
- * Validate confirmation token for an operation
- *
- * @param operation - The operation type (e.g., "CREATE", "UPDATE", "DELETE")
- * @param resourceId - The unique identifier(s) of the resource being affected
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export function validateConfirmationToken(operation, resourceId, providedToken) {
-    // If confirmation not required, skip validation
-    if (!isConfirmationRequired()) {
-        return { valid: true };
-    }
-    const expectedToken = `${operation}:${resourceId}`;
-    if (!providedToken) {
-        return {
-            valid: false,
-            error: `⚠️ CONFIRMATION REQUIRED\n\nThis will ${operation.toLowerCase()} resource: ${resourceId}\n\nTo confirm this operation, you must provide:\n  confirmToken: "${expectedToken}"\n\nThis ensures you understand which resource will be affected.\n\nTo disable this safety check, set BRINK_REQUIRE_CONFIRMATION=false (not recommended for production).`,
-        };
-    }
-    if (providedToken !== expectedToken) {
-        return {
-            valid: false,
-            error: `❌ INVALID CONFIRMATION TOKEN\n\nExpected: "${expectedToken}"\nReceived: "${providedToken}"\n\nThe token must match the resource ID exactly.\nFormat: ${operation}:<resourceId>`,
-        };
-    }
-    return { valid: true };
-}
-/**
- * Convenience wrapper for validating CREATE operation confirmation tokens
- *
- * @param resourceId - The unique identifier of the resource being created
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export function validateCreateConfirmation(resourceId, providedToken) {
-    return validateConfirmationToken("CREATE", resourceId, providedToken);
-}
-/**
- * Convenience wrapper for validating UPDATE operation confirmation tokens
- *
- * @param resourceId - The unique identifier of the resource being updated
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export function validateUpdateConfirmation(resourceId, providedToken) {
-    return validateConfirmationToken("UPDATE", resourceId, providedToken);
-}
-/**
- * Convenience wrapper for validating DELETE operation confirmation tokens
- *
- * @param resourceId - The unique identifier of the resource being deleted
- * @param providedToken - The confirmation token provided by the user
- * @returns Validation result with success status and optional error message
- */
-export function validateDeleteConfirmation(resourceId, providedToken) {
-    return validateConfirmationToken("DELETE", resourceId, providedToken);
-}