brinkcommerce-dev-mcp 0.1.0-beta.1

package/dist/clients/price-management-client.d.ts

@@ -0,0 +1,76 @@
+import { PutProductVariantPricesRequest, PatchProductVariantPricesRequest, ProductVariantPrices, AllProductVariantPrices, ProductVariantPrice, AddonPrice } from "../generated/price-management/src/index.js";
+import { BrinkApiClientConfig, ApiResult } from "./types.js";
+/**
+ * BrinkCommerce Price Management API Client
+ * Wraps the generated client with authentication and error handling
+ */
+export declare class BrinkPriceManagementClient {
+    private productVariantPricesApi;
+    private addonPricesApi;
+    private apiKey;
+    private region;
+    private customerName;
+    constructor(config?: BrinkApiClientConfig);
+    /**
+     * Update product variant prices (full replacement)
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param productVariantId - Unique identifier for the product variant
+     * @param request - Price data for all markets
+     * @returns Result with product variant prices or error
+     */
+    updateProductVariantPrices(storeGroupId: string, productVariantId: string, request: PutProductVariantPricesRequest): Promise<ApiResult<ProductVariantPrices>>;
+    /**
+     * Patch product variant prices (partial update)
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param productVariantId - Unique identifier for the product variant
+     * @param request - Partial price data
+     * @returns Result with product variant prices or error
+     */
+    patchProductVariantPrices(storeGroupId: string, productVariantId: string, request: PatchProductVariantPricesRequest): Promise<ApiResult<ProductVariantPrices>>;
+    /**
+     * Get all prices for a product variant across all store groups
+     *
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with all product variant prices or error
+     */
+    getAllProductVariantPrices(productVariantId: string): Promise<ApiResult<AllProductVariantPrices>>;
+    /**
+     * Get prices for a product variant in a specific store group
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with product variant prices or error
+     */
+    getProductVariantPrices(storeGroupId: string, productVariantId: string): Promise<ApiResult<ProductVariantPrices>>;
+    /**
+     * Get a single price for a product variant in a specific market
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param countryCode - ISO-3166-1 alpha-2 country code
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with product variant price or error
+     */
+    getProductVariantPrice(storeGroupId: string, countryCode: string, productVariantId: string): Promise<ApiResult<ProductVariantPrice>>;
+    /**
+     * Get the price for an addon in a specific market
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param countryCode - ISO-3166-1 alpha-2 country code
+     * @param addonId - Unique identifier for the addon
+     * @returns Result with addon price or error
+     */
+    getAddonPrice(storeGroupId: string, countryCode: string, addonId: string): Promise<ApiResult<AddonPrice>>;
+    /**
+     * Handle API errors and convert to standardized result
+     */
+    private handleError;
+}
+/**
+ * Factory function to create a BrinkCommerce Price Management client
+ *
+ * @param config - Optional configuration overrides
+ * @returns Configured API client instance
+ */
+export declare function createPriceManagementClient(config?: BrinkApiClientConfig): BrinkPriceManagementClient;

package/dist/clients/price-management-client.js

@@ -0,0 +1,275 @@
+import { Configuration, ProductVariantPricesApi, AddonPricesApi, ResponseError, } from "../generated/price-management/src/index.js";
+import { getAccessToken } from "../auth.js";
+import { logger } from "../logger.js";
+import { handleApiError } from "./error-handler.js";
+/**
+ * BrinkCommerce Price Management API Client
+ * Wraps the generated client with authentication and error handling
+ */
+export class BrinkPriceManagementClient {
+    productVariantPricesApi;
+    addonPricesApi;
+    apiKey;
+    region;
+    customerName;
+    constructor(config) {
+        this.region = config?.region ?? process.env.BRINK_REGION ?? "eu-west-1";
+        this.customerName = config?.customerName ?? process.env.BRINK_CUSTOMER_NAME ?? "";
+        this.apiKey = config?.apiKey ?? process.env.BRINK_API_KEY ?? "";
+        if (!this.customerName) {
+            throw new Error("BRINK_CUSTOMER_NAME is required");
+        }
+        if (!this.apiKey) {
+            throw new Error("BRINK_API_KEY is required");
+        }
+        // Build base path for Management API
+        const basePath = `https://management.${this.region}.${this.customerName}.brinkcommerce.io/price`;
+        logger.info("Initializing BrinkCommerce Price Management client", {
+            basePath,
+            region: this.region,
+            customerName: this.customerName,
+        });
+        // Create configuration with authentication middleware
+        const configuration = new Configuration({
+            basePath,
+            middleware: [
+                {
+                    pre: async (context) => {
+                        // Get OAuth token with price management scope
+                        const token = await getAccessToken("price-management/price:write");
+                        // Add authentication headers
+                        const headers = context.init.headers ?? {};
+                        const updatedHeaders = {
+                            ...headers,
+                            Authorization: `Bearer ${token}`,
+                            "x-api-key": this.apiKey,
+                        };
+                        logger.debug("Adding authentication headers to request", {
+                            url: context.url,
+                            method: context.init.method,
+                        });
+                        // Return updated context with auth headers
+                        return {
+                            url: context.url,
+                            init: {
+                                ...context.init,
+                                headers: updatedHeaders,
+                            },
+                        };
+                    },
+                },
+            ],
+        });
+        // Initialize API clients
+        this.productVariantPricesApi = new ProductVariantPricesApi(configuration);
+        this.addonPricesApi = new AddonPricesApi(configuration);
+    }
+    /**
+     * Update product variant prices (full replacement)
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param productVariantId - Unique identifier for the product variant
+     * @param request - Price data for all markets
+     * @returns Result with product variant prices or error
+     */
+    async updateProductVariantPrices(storeGroupId, productVariantId, request) {
+        try {
+            logger.info("Updating product variant prices", { storeGroupId, productVariantId });
+            const response = await this.productVariantPricesApi.putProductVariantPrices({
+                storeGroupId,
+                productVariantId,
+                putProductVariantPricesRequest: request,
+            });
+            logger.info("Successfully updated product variant prices", {
+                storeGroupId,
+                productVariantId,
+            });
+            return {
+                success: true,
+                data: response,
+            };
+        }
+        catch (error) {
+            return await handleApiError(error, "Failed to update product variant prices");
+        }
+    }
+    /**
+     * Patch product variant prices (partial update)
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param productVariantId - Unique identifier for the product variant
+     * @param request - Partial price data
+     * @returns Result with product variant prices or error
+     */
+    async patchProductVariantPrices(storeGroupId, productVariantId, request) {
+        try {
+            logger.info("Patching product variant prices", { storeGroupId, productVariantId });
+            const response = await this.productVariantPricesApi.patchProductVariantPrices({
+                storeGroupId,
+                productVariantId,
+                patchProductVariantPricesRequest: request,
+            });
+            logger.info("Successfully patched product variant prices", {
+                storeGroupId,
+                productVariantId,
+            });
+            return {
+                success: true,
+                data: response,
+            };
+        }
+        catch (error) {
+            return await handleApiError(error, "Failed to patch product variant prices");
+        }
+    }
+    /**
+     * Get all prices for a product variant across all store groups
+     *
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with all product variant prices or error
+     */
+    async getAllProductVariantPrices(productVariantId) {
+        try {
+            logger.info("Getting all product variant prices", { productVariantId });
+            const response = await this.productVariantPricesApi.getAllProductVariantPrices({
+                productVariantId,
+            });
+            logger.info("Successfully retrieved all product variant prices", {
+                productVariantId,
+                storeGroupCount: response.storeGroups?.length ?? 0,
+            });
+            return {
+                success: true,
+                data: response,
+            };
+        }
+        catch (error) {
+            return await handleApiError(error, "Failed to get all product variant prices");
+        }
+    }
+    /**
+     * Get prices for a product variant in a specific store group
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with product variant prices or error
+     */
+    async getProductVariantPrices(storeGroupId, productVariantId) {
+        try {
+            logger.info("Getting product variant prices", { storeGroupId, productVariantId });
+            const response = await this.productVariantPricesApi.getProductVariantPrices({
+                storeGroupId,
+                productVariantId,
+            });
+            logger.info("Successfully retrieved product variant prices", {
+                storeGroupId,
+                productVariantId,
+            });
+            return {
+                success: true,
+                data: response,
+            };
+        }
+        catch (error) {
+            return await handleApiError(error, "Failed to get product variant prices");
+        }
+    }
+    /**
+     * Get a single price for a product variant in a specific market
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param countryCode - ISO-3166-1 alpha-2 country code
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with product variant price or error
+     */
+    async getProductVariantPrice(storeGroupId, countryCode, productVariantId) {
+        try {
+            logger.info("Getting product variant price", { storeGroupId, countryCode, productVariantId });
+            const response = await this.productVariantPricesApi.getProductVariantPrice({
+                storeGroupId,
+                countryCode,
+                productVariantId,
+            });
+            logger.info("Successfully retrieved product variant price", {
+                storeGroupId,
+                countryCode,
+                productVariantId,
+            });
+            return {
+                success: true,
+                data: response,
+            };
+        }
+        catch (error) {
+            return await handleApiError(error, "Failed to get product variant price");
+        }
+    }
+    /**
+     * Get the price for an addon in a specific market
+     *
+     * @param storeGroupId - Unique identifier for the store group
+     * @param countryCode - ISO-3166-1 alpha-2 country code
+     * @param addonId - Unique identifier for the addon
+     * @returns Result with addon price or error
+     */
+    async getAddonPrice(storeGroupId, countryCode, addonId) {
+        try {
+            logger.info("Getting addon price", { storeGroupId, countryCode, addonId });
+            const response = await this.addonPricesApi.getAddonPrice({
+                storeGroupId,
+                countryCode,
+                addonId,
+            });
+            logger.info("Successfully retrieved addon price", {
+                storeGroupId,
+                countryCode,
+                addonId,
+            });
+            return {
+                success: true,
+                data: response,
+            };
+        }
+        catch (error) {
+            return await handleApiError(error, "Failed to get addon price");
+        }
+    }
+    /**
+     * Handle API errors and convert to standardized result
+     */
+    handleError(error, defaultMessage) {
+        logger.error(defaultMessage, { error });
+        // Handle ResponseError from generated client
+        if (error instanceof ResponseError) {
+            const status = error.response.status;
+            const statusText = error.response.statusText;
+            return {
+                success: false,
+                error: {
+                    message: `${defaultMessage}: ${status} ${statusText}`,
+                    status,
+                    details: error.response,
+                },
+            };
+        }
+        // Handle generic errors
+        const message = error instanceof Error ? error.message : defaultMessage;
+        return {
+            success: false,
+            error: {
+                message,
+                status: 500,
+                details: error,
+            },
+        };
+    }
+}
+/**
+ * Factory function to create a BrinkCommerce Price Management client
+ *
+ * @param config - Optional configuration overrides
+ * @returns Configured API client instance
+ */
+export function createPriceManagementClient(config) {
+    return new BrinkPriceManagementClient(config);
+}

package/dist/clients/product-management-client.d.ts

@@ -0,0 +1,150 @@
+import { PutProductParentRequest, PutProductVariantRequest, PutAddonRequest, PatchProductParentRequest, PatchProductVariantRequest, PatchAddonRequest, PostProductParentArchiveRequest, ProductParent, ProductVariant, ProductVariants, Addon, ProductParentAddons, PostProductParentAddonRequest } from "../generated/product-management/src/index.js";
+import { BrinkApiClientConfig, ApiResult } from "./types.js";
+/**
+ * BrinkCommerce Product Management API Client
+ * Wraps the generated client with authentication and error handling
+ */
+export declare class BrinkProductManagementClient {
+    private productParentsApi;
+    private productVariantsApi;
+    private addonsApi;
+    private apiKey;
+    private region;
+    private customerName;
+    constructor(config?: BrinkApiClientConfig);
+    /**
+     * Create or update a product parent
+     *
+     * @param productParentId - Unique identifier for the product parent
+     * @param request - Product parent data
+     * @returns Result with product parent data or error
+     */
+    createProductParent(productParentId: string, request: PutProductParentRequest): Promise<ApiResult<ProductParent>>;
+    /**
+     * Create or update a product variant
+     *
+     * @param productVariantId - Unique identifier for the product variant
+     * @param request - Product variant data
+     * @returns Result with product variant data or error
+     */
+    createProductVariant(productVariantId: string, request: PutProductVariantRequest): Promise<ApiResult<ProductVariant>>;
+    /**
+     * Get a product parent by ID
+     *
+     * @param productParentId - Unique identifier for the product parent
+     * @returns Result with product parent data or error
+     */
+    getProductParent(productParentId: string): Promise<ApiResult<ProductParent>>;
+    /**
+     * Delete a product parent
+     *
+     * @param productParentId - Unique identifier for the product parent
+     * @returns Result with success status or error
+     */
+    deleteProductParent(productParentId: string): Promise<ApiResult<void>>;
+    /**
+     * Get a product variant by ID
+     *
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with product variant data or error
+     */
+    getProductVariant(productVariantId: string): Promise<ApiResult<ProductVariant>>;
+    /**
+     * Get all product variants for a product parent
+     *
+     * @param productParentId - Product parent ID to get variants for
+     * @returns Result with product variants data or error
+     */
+    getProductVariants(productParentId: string): Promise<ApiResult<ProductVariants>>;
+    /**
+     * Delete a product variant
+     *
+     * @param productVariantId - Unique identifier for the product variant
+     * @returns Result with success status or error
+     */
+    deleteProductVariant(productVariantId: string): Promise<ApiResult<void>>;
+    /**
+     * Get an addon by ID
+     *
+     * @param addonId - Unique identifier for the addon
+     * @returns Result with addon data or error
+     */
+    getAddon(addonId: string): Promise<ApiResult<Addon>>;
+    /**
+     * Create or update an addon
+     *
+     * @param addonId - Unique identifier for the addon
+     * @param request - Addon data
+     * @returns Result with addon data or error
+     */
+    createOrUpdateAddon(addonId: string, request: PutAddonRequest): Promise<ApiResult<Addon>>;
+    /**
+     * Delete an addon
+     *
+     * @param addonId - Unique identifier for the addon
+     * @returns Result with success status or error
+     */
+    deleteAddon(addonId: string): Promise<ApiResult<void>>;
+    /**
+     * Get all addons for a product parent
+     *
+     * @param productParentId - Product parent ID to get addons for
+     * @returns Result with product parent addons or error
+     */
+    getProductParentAddons(productParentId: string): Promise<ApiResult<ProductParentAddons>>;
+    /**
+     * Add an addon to a product parent
+     *
+     * @param productParentId - Product parent ID
+     * @param request - Addon association data
+     * @returns Result with product parent addon or error
+     */
+    addProductParentAddon(productParentId: string, request: PostProductParentAddonRequest): Promise<ApiResult<unknown>>;
+    /**
+     * Remove an addon from a product parent
+     *
+     * @param productParentId - Product parent ID
+     * @param addonId - Addon ID to remove
+     * @returns Result with success status or error
+     */
+    removeProductParentAddon(productParentId: string, addonId: string): Promise<ApiResult<void>>;
+    /**
+     * Patch (partial update) a product parent
+     *
+     * @param productParentId - Unique identifier for the product parent
+     * @param request - Partial product parent data to update
+     * @returns Result with updated product parent data or error
+     */
+    patchProductParent(productParentId: string, request: PatchProductParentRequest): Promise<ApiResult<ProductParent>>;
+    /**
+     * Archive a product parent
+     *
+     * @param productParentId - Unique identifier for the product parent
+     * @param request - Archive options (includeProductVariants)
+     * @returns Result with success status or error
+     */
+    archiveProductParent(productParentId: string, request: PostProductParentArchiveRequest): Promise<ApiResult<void>>;
+    /**
+     * Patch (partial update) a product variant
+     *
+     * @param productVariantId - Unique identifier for the product variant
+     * @param request - Partial product variant data to update
+     * @returns Result with updated product variant data or error
+     */
+    patchProductVariant(productVariantId: string, request: PatchProductVariantRequest): Promise<ApiResult<ProductVariant>>;
+    /**
+     * Patch (partial update) an addon
+     *
+     * @param addonId - Unique identifier for the addon
+     * @param request - Partial addon data to update
+     * @returns Result with updated addon data or error
+     */
+    patchAddon(addonId: string, request: PatchAddonRequest): Promise<ApiResult<Addon>>;
+}
+/**
+ * Factory function to create a BrinkCommerce Product Management client
+ *
+ * @param config - Optional configuration overrides
+ * @returns Configured API client instance
+ */
+export declare function createProductManagementClient(config?: BrinkApiClientConfig): BrinkProductManagementClient;