@virtocommerce/mcp-onx 0.0.1-alpha.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Your Company
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,360 @@
+# Commerce Operations Foundation Adapter Template
+
+This template helps fulfillment vendors and retailers create custom adapters for the Commerce Operations Foundation MCP Server. Use this template to build an adapter that connects your fulfillment system to the COF ecosystem.
+
+## Table of Contents
+
+- [Quick Start](#quick-start)
+- [Template Structure](#template-structure)
+- [Implementation Guide](#implementation-guide)
+- [Configuration](#configuration)
+- [Testing Your Adapter](#testing-your-adapter)
+- [Using Your Adapter](#using-your-adapter)
+- [Publishing](#publishing)
+- [Troubleshooting](#troubleshooting)
+- [API Reference](#api-reference)
+- [Support](#support)
+
+## Quick Start
+
+### Step 1: Set Up Your Adapter Project
+
+```bash
+# Copy this template to create your adapter
+cp -r adapter-template/ my-fulfillment-adapter/
+cd my-fulfillment-adapter/
+
+# Install dependencies
+npm install
+
+# Rename the adapter in package.json
+# Update name to: @yourcompany/cof-adapter-yourfulfillment
+```
+
+### Step 2: Customize Package Information
+
+Edit `package.json` to reflect your adapter:
+
+```json
+{
+  "name": "@yourcompany/cof-adapter-yourfulfillment",
+  "version": "1.0.0",
+  "description": "YourFulfillment adapter for Commerce Operations Foundation",
+  "author": "Your Company",
+  "license": "MIT"
+}
+```
+
+### Step 3: Implement the Adapter Interface
+
+Open `src/adapter.ts` and implement your fulfillment system's logic. The template provides all required methods with TODO comments showing what needs implementation.
+
+## Template Structure
+
+```
+adapter-template/
+├── src/
+│   ├── adapter.ts          # Main adapter implementation (modify this)
+│   ├── index.ts            # Module exports (update exports)
+│   ├── types.ts            # Custom type definitions (add your types)
+│   └── utils/
+│       └── api-client.ts   # HTTP client wrapper (customize for your API)
+├── tests/
+│   └── adapter.test.ts     # Unit tests (write your tests)
+├── examples/
+│   ├── basic-usage.ts      # Basic usage examples
+│   └── test-server.ts      # Test with local MCP server
+├── docs/
+│   ├── API.md              # Document your API mappings
+│   └── CONFIGURATION.md    # Document configuration options
+├── package.json            # Update name, author, description
+├── tsconfig.json           # TypeScript configuration
+├── .env.example            # Example configuration
+└── README.md               # Replace with your documentation
+```
+
+## Implementation Guide
+
+### Required Methods Checklist
+
+Your adapter must implement these methods from the `IFulfillmentAdapter` interface:
+
+#### Lifecycle (3 methods)
+- [ ] `connect()` - Establish connection to your fulfillment system
+- [ ] `disconnect()` - Clean up resources
+- [ ] `healthCheck()` - Return system health status
+
+#### Action Operations (4 methods)
+- [ ] `createSalesOrder()` - Create new orders
+- [ ] `cancelOrder()` - Cancel existing orders
+- [ ] `updateOrder()` - Update order details
+- [ ] `fulfillOrder()` - Mark orders as fulfilled / shipped
+
+#### Query Operations (6 methods)
+- [ ] `getOrders()` - Retrieve order details
+- [ ] `getCustomers()` - Get customer details
+- [ ] `getProducts()` - Fetch product information
+- [ ] `getProductVariants()` - Retrieve product variants
+- [ ] `getInventory()` - Check inventory levels
+- [ ] `getFulfillments()` - Fetch fulfillment records
+
+### Implementation Steps
+
+1. **Update adapter.ts with your API logic:**
+```typescript
+// src/adapter.ts
+export class YourFulfillmentAdapter implements IFulfillmentAdapter {
+  async createSalesOrder(input: CreateSalesOrderInput): Promise<OrderResult> {
+    // TODO: Replace with your API call
+    const response = await this.apiClient.post('/orders', transform(input));
+
+    return response.success
+      ? this.success({ order: mapOrder(response.data) })
+      : this.failure('Failed to create order', response.error);
+  }
+}
+```
+
+2. **Configure your API client:**
+```typescript
+// src/utils/api-client.ts
+export class ApiClient {
+  constructor(config: YourConfig) {
+    // Set up authentication, base URL, etc.
+  }
+}
+```
+
+3. **Define your configuration types:**
+```typescript
+// src/types.ts
+export interface YourAdapterConfig {
+  apiUrl: string;
+  apiKey: string;
+  // Add your specific config options
+}
+
+```
+
+## Testing Your Adapter
+
+### Step 1: Test Locally
+
+```bash
+# Build your adapter
+npm run build
+
+# Run unit tests
+npm test
+
+# Test with the MCP server locally
+cd ../server
+npm install
+ADAPTER_TYPE=local ADAPTER_PATH=../my-fulfillment-adapter/dist/index.js npm start
+```
+
+### Step 2: Write Unit Tests
+
+```typescript
+// tests/adapter.test.ts
+import { YourFulfillmentAdapter } from '../src/adapter';
+
+describe('YourFulfillmentAdapter', () => {
+  let adapter: YourFulfillmentAdapter;
+  
+  beforeEach(() => {
+    adapter = new YourFulfillmentAdapter({
+      apiUrl: 'https://sandbox.yourapi.com',
+      apiKey: 'test-key'
+    });
+  });
+  
+  test('should connect successfully', async () => {
+    await expect(adapter.connect()).resolves.not.toThrow();
+  });
+  
+  test('should create sales order', async () => {
+    const result = await adapter.createSalesOrder({
+      // ... test data
+    });
+    expect(result.success).toBe(true);
+  });
+});
+```
+
+```typescript
+// examples/test-server.ts
+// Use this to test your adapter with a local MCP server
+import { YourFulfillmentAdapter } from '../src/adapter';
+
+const adapter = new YourFulfillmentAdapter({
+  apiUrl: process.env.API_URL || 'https://sandbox.yourapi.com',
+  apiKey: process.env.API_KEY || 'test-key'
+});
+
+async function test() {
+  await adapter.connect();
+  console.log('Connected!');
+  
+  const health = await adapter.healthCheck();
+  console.log('Health:', health);
+}
+
+test().catch(console.error);
+```
+
+## Using Your Adapter
+
+### Option 1: Local Development (During Development)
+
+```bash
+# In the server directory, configure to use your local adapter
+cd ../server
+cat > .env << EOF
+ADAPTER_TYPE=local
+ADAPTER_PATH=../my-fulfillment-adapter/dist/index.js
+ADAPTER_CONFIG={"apiUrl":"https://sandbox.yourapi.com","apiKey":"test-key"}
+EOF
+
+npm start
+```
+
+### Option 2: NPM Package (After Publishing)
+
+```bash
+# Install your published adapter
+npm install @yourcompany/cof-adapter-yourfulfillment
+
+# Configure the server to use it
+cat > .env << EOF
+ADAPTER_TYPE=npm
+ADAPTER_PACKAGE=@yourcompany/cof-adapter-yourfulfillment
+ADAPTER_CONFIG={"apiUrl":"https://api.yourfulfillment.com","apiKey":"production-key"}
+EOF
+
+npm start
+```
+
+## Configuration
+
+Your adapter should accept configuration through the `ADAPTER_CONFIG` environment variable. Define your configuration interface in `src/types.ts`:
+
+```typescript
+export interface YourAdapterConfig {
+  apiUrl: string;      // Required: Your API endpoint
+  apiKey: string;      // Required: Authentication key
+  workspace?: string;  // Optional: Tenant/workspace ID
+  timeout?: number;    // Optional: Request timeout (ms)
+  retryAttempts?: number; // Optional: Retry count
+}
+```
+
+## Publishing
+
+### For Public NPM Packages
+
+```bash
+# 1. Update version
+npm version patch  # or minor/major
+
+# 2. Build and test
+npm run build
+npm test
+
+# 3. Publish to NPM
+npm publish --access public
+```
+
+### For Private Use
+
+```bash
+# Option 1: Private NPM registry
+npm publish --registry https://your-registry.com
+
+# Option 2: Git repository
+git tag v1.0.0
+git push origin v1.0.0
+
+# Option 3: Local file reference in package.json
+"dependencies": {
+  "my-adapter": "file:../my-fulfillment-adapter"
+}
+
+## Troubleshooting
+
+### Adapter Not Loading
+
+```bash
+# Check the adapter can be imported
+node -e "import('../my-fulfillment-adapter/dist/index.js')"
+
+# Verify environment variables
+echo $ADAPTER_TYPE
+echo $ADAPTER_PATH
+```
+
+### Connection Issues
+
+- Verify API credentials are correct
+- Check network connectivity to your API
+- Test with curl: `curl -X GET https://your-api.com/health`
+- Enable debug logging in your adapter
+
+### Type Errors
+
+```bash
+# Ensure types are installed
+npm install --save-dev @types/node
+
+# Check TypeScript version
+npx tsc --version
+```
+
+## API Reference
+
+### Required Interfaces
+
+Your adapter must implement the `IFulfillmentAdapter` interface from the main server. Key types:
+
+```typescript
+interface OrderParams {
+  extOrderId: string;
+  customer: Customer;
+  items: LineItem[];
+  shippingAddress?: Address;
+  billingAddress?: Address;
+}
+
+interface OrderResult {
+  success: boolean;
+  orderId: string;
+  orderNumber?: string;
+  status?: string;
+}
+```
+
+See the full type definitions in the server's `src/types/` directory.
+
+## Support
+
+### Documentation
+- [Commerce Operations Foundation Docs](../docs/README.md)
+- [For Fulfillment Vendors Guide](../docs/getting-started/for-fulfillment-vendors.md)
+- [MCP Protocol Specification](https://modelcontextprotocol.io)
+
+### Getting Help
+- Create an issue in this repository
+- Check existing adapters in the `adapters/` directory for examples
+- Review the mock adapter implementation for reference
+
+## Next Steps
+
+1. **Copy this template** to start your adapter
+2. **Implement the interface** methods for your fulfillment system
+3. **Test locally** with the MCP server
+4. **Publish** to NPM or deploy privately
+5. **Document** your configuration options
+
+---
+
+*This template is part of the Commerce Operations Foundation (COF) project.*

package/dist/adapter.d.ts

@@ -0,0 +1,53 @@
+import type { IFulfillmentAdapter, AdapterConfig, AdapterCapabilities, HealthStatus, OrderResult, ReturnResult, FulfillmentToolResult, Order, Fulfillment, Return, InventoryItem, Product, ProductVariant, Customer, CreateSalesOrderInput, CreateReturnInput, CancelOrderInput, UpdateOrderInput, FulfillOrderInput, GetOrdersInput, GetInventoryInput, GetProductsInput, GetProductVariantsInput, GetCustomersInput, GetFulfillmentsInput, GetReturnsInput } from '@virtocommerce/cof-mcp';
+export declare class VirtoCommerceFulfillmentAdapter implements IFulfillmentAdapter {
+    private client;
+    private connected;
+    private options;
+    private orderService;
+    private customerService;
+    private fulfillmentService;
+    private productService;
+    private returnService;
+    constructor(config?: any);
+    initialize?(config: AdapterConfig): Promise<void>;
+    cleanup?(): Promise<void>;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    healthCheck(): Promise<HealthStatus>;
+    checkHealth?(): Promise<HealthStatus>;
+    getCapabilities?(): Promise<AdapterCapabilities>;
+    updateConfig?(config: AdapterConfig): Promise<void>;
+    createSalesOrder(input: CreateSalesOrderInput): Promise<OrderResult>;
+    cancelOrder(input: CancelOrderInput): Promise<OrderResult>;
+    updateOrder(input: UpdateOrderInput): Promise<OrderResult>;
+    getOrders(input: GetOrdersInput): Promise<FulfillmentToolResult<{
+        orders: Order[];
+    }>>;
+    fulfillOrder(input: FulfillOrderInput): Promise<FulfillmentToolResult<{
+        fulfillment: Fulfillment;
+    }>>;
+    getFulfillments(input: GetFulfillmentsInput): Promise<FulfillmentToolResult<{
+        fulfillments: Fulfillment[];
+    }>>;
+    getCustomers(input: GetCustomersInput): Promise<FulfillmentToolResult<{
+        customers: Customer[];
+    }>>;
+    getProducts(input: GetProductsInput): Promise<FulfillmentToolResult<{
+        products: Product[];
+    }>>;
+    getProductVariants(input: GetProductVariantsInput): Promise<FulfillmentToolResult<{
+        productVariants: ProductVariant[];
+    }>>;
+    getInventory(input: GetInventoryInput): Promise<FulfillmentToolResult<{
+        inventory: InventoryItem[];
+    }>>;
+    createReturn(input: CreateReturnInput): Promise<ReturnResult>;
+    getReturns(input: GetReturnsInput): Promise<FulfillmentToolResult<{
+        returns: Return[];
+    }>>;
+    private updateOptions;
+    private fetchCatalogId;
+    private getTenantId;
+    private now;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/adapter.js

@@ -0,0 +1,205 @@
+import { AdapterError } from '@virtocommerce/cof-mcp';
+import { ApiClient } from './utils/api-client.js';
+import { ErrorCode } from './types.js';
+import { getErrorMessage } from './utils/type-guards.js';
+import { OrderService, CustomerService, FulfillmentService, ProductService, ReturnService, } from './services/index.js';
+export class VirtoCommerceFulfillmentAdapter {
+    client;
+    connected = false;
+    options;
+    orderService;
+    customerService;
+    fulfillmentService;
+    productService;
+    returnService;
+    constructor(config = {}) {
+        const options = config.options || config;
+        this.options = {
+            apiUrl: options.apiUrl || 'https://api.yourfulfillment.com',
+            apiKey: options.apiKey || '',
+            workspace: options.workspace,
+            timeout: options.timeout || 30000,
+            retryAttempts: options.retryAttempts || 3,
+            debugMode: options.debugMode || false,
+        };
+        this.client = new ApiClient({
+            baseUrl: this.options.apiUrl,
+            apiKey: this.options.apiKey,
+            timeout: this.options.timeout,
+            retryAttempts: this.options.retryAttempts,
+            debugMode: this.options.debugMode,
+        });
+        const tenantId = this.getTenantId();
+        this.orderService = new OrderService(this.client, tenantId, this.options.workspace);
+        this.customerService = new CustomerService(this.client, tenantId);
+        this.fulfillmentService = new FulfillmentService(this.client, tenantId, this.options.workspace);
+        this.productService = new ProductService(this.client, tenantId);
+        this.returnService = new ReturnService(this.client, tenantId);
+        this.orderService.setProductService(this.productService);
+    }
+    async initialize(config) {
+        this.updateOptions(config.options ?? {});
+    }
+    async cleanup() {
+        this.connected = false;
+    }
+    async connect() {
+        try {
+            const response = await this.client.get('/health');
+            if (!response.success) {
+                throw new AdapterError('Failed to connect to VirtoCommerce', ErrorCode.CONNECTION_FAILED, response);
+            }
+            this.connected = true;
+            console.error('Successfully connected to VirtoCommerce');
+            if (this.options.workspace && !this.options.catalogId) {
+                await this.fetchCatalogId();
+            }
+        }
+        catch (error) {
+            this.connected = false;
+            throw new AdapterError(`Connection failed: ${getErrorMessage(error)}`, ErrorCode.CONNECTION_FAILED, error);
+        }
+    }
+    async disconnect() {
+        this.connected = false;
+        console.error('Disconnected from VirtoCommerce');
+    }
+    async healthCheck() {
+        try {
+            const response = await this.client.get('/health');
+            return {
+                status: response.success ? 'healthy' : 'unhealthy',
+                timestamp: this.now(),
+                checks: [
+                    {
+                        name: 'api_connection',
+                        status: response.success ? 'pass' : 'fail',
+                        message: response.success ? 'API is reachable' : 'API connection failed',
+                    },
+                    {
+                        name: 'authentication',
+                        status: this.connected ? 'pass' : 'fail',
+                        message: this.connected ? 'Authenticated' : 'Not authenticated',
+                    },
+                ],
+                version: '1.0.0',
+            };
+        }
+        catch (error) {
+            return {
+                status: 'unhealthy',
+                timestamp: this.now(),
+                checks: [
+                    {
+                        name: 'api_connection',
+                        status: 'fail',
+                        message: `Health check failed: ${getErrorMessage(error)}`,
+                    },
+                ],
+            };
+        }
+    }
+    async checkHealth() {
+        return this.healthCheck();
+    }
+    async getCapabilities() {
+        return {
+            supportsOrderCapture: true,
+            supportsShipping: true,
+            supportsCustomFields: true,
+            maxBatchSize: 50,
+        };
+    }
+    async updateConfig(config) {
+        this.updateOptions(config.options ?? {});
+    }
+    async createSalesOrder(input) {
+        return this.orderService.createSalesOrder(input);
+    }
+    async cancelOrder(input) {
+        return this.orderService.cancelOrder(input);
+    }
+    async updateOrder(input) {
+        return this.orderService.updateOrder(input);
+    }
+    async getOrders(input) {
+        return this.orderService.getOrders(input);
+    }
+    async fulfillOrder(input) {
+        return this.fulfillmentService.fulfillOrder(input);
+    }
+    async getFulfillments(input) {
+        return this.fulfillmentService.getFulfillments(input);
+    }
+    async getCustomers(input) {
+        return this.customerService.getCustomers(input);
+    }
+    async getProducts(input) {
+        return this.productService.getProducts(input);
+    }
+    async getProductVariants(input) {
+        return this.productService.getProductVariants(input);
+    }
+    async getInventory(input) {
+        return this.productService.getInventory(input);
+    }
+    async createReturn(input) {
+        return this.returnService.createReturn(input);
+    }
+    async getReturns(input) {
+        return this.returnService.getReturns(input);
+    }
+    updateOptions(options) {
+        if (!options) {
+            return;
+        }
+        this.options = {
+            ...this.options,
+            ...options,
+        };
+        if (options.apiKey) {
+            this.client.updateApiKey(options.apiKey);
+        }
+        if (typeof options.debugMode === 'boolean') {
+            this.client.setDebugMode(options.debugMode);
+        }
+        const tenantId = this.getTenantId();
+        this.orderService.setTenantId(tenantId);
+        this.customerService.setTenantId(tenantId);
+        this.fulfillmentService.setTenantId(tenantId);
+        this.productService.setTenantId(tenantId);
+        this.returnService.setTenantId(tenantId);
+        if (options.workspace) {
+            this.orderService.setWorkspace(options.workspace);
+            this.fulfillmentService.setWorkspace(options.workspace);
+        }
+        if (options.catalogId) {
+            this.orderService.setCatalogId(options.catalogId);
+            this.productService.setCatalogId(options.catalogId);
+        }
+    }
+    async fetchCatalogId() {
+        try {
+            const storeResponse = await this.client.get(`/api/stores/${this.options.workspace}`);
+            if (storeResponse.success && storeResponse.data?.catalog) {
+                this.options.catalogId = storeResponse.data.catalog;
+                this.orderService.setCatalogId(storeResponse.data.catalog);
+                this.productService.setCatalogId(storeResponse.data.catalog);
+                console.error(`Resolved catalogId "${storeResponse.data.catalog}" from store "${this.options.workspace}"`);
+            }
+            else {
+                console.error(`Warning: Could not resolve catalogId from store "${this.options.workspace}"`);
+            }
+        }
+        catch (error) {
+            console.error(`Warning: Failed to fetch store info for catalogId resolution: ${getErrorMessage(error)}`);
+        }
+    }
+    getTenantId() {
+        return this.options.workspace ?? 'default-workspace';
+    }
+    now() {
+        return new Date().toISOString();
+    }
+}
+//# sourceMappingURL=adapter.js.map

package/dist/adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../src/adapter.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { VirtoCommerceFulfillmentAdapter } from './adapter.js';
+export default VirtoCommerceFulfillmentAdapter;
+export { VirtoCommerceFulfillmentAdapter } from './adapter.js';
+export type { AdapterOptions } from './types.js';
+export { ErrorCode, STATUS_MAP } from './types.js';
+export * from './transformers/index.js';
+export * from './services/index.js';
+export * from './mappers/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,eAAe,+BAA+B,CAAC;AAG/C,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAG/D,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD,cAAc,yBAAyB,CAAC;AAGxC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+import { VirtoCommerceFulfillmentAdapter } from './adapter.js';
+export default VirtoCommerceFulfillmentAdapter;
+export { VirtoCommerceFulfillmentAdapter } from './adapter.js';
+export { ErrorCode, STATUS_MAP } from './types.js';
+export * from './transformers/index.js';
+export * from './services/index.js';
+export * from './mappers/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAC/D,eAAe,+BAA+B,CAAC;AAG/C,OAAO,EAAE,+BAA+B,EAAE,MAAM,cAAc,CAAC;AAI/D,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD,cAAc,yBAAyB,CAAC;AAGxC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,oBAAoB,CAAC"}