OpenERP TypeScript Client

A TypeScript client for interacting with OpenERP's RPC API. This package provides a strongly-typed interface for making RPC calls to OpenERP servers.

Installation

1npm install @danielfrey63/openerp-ts-client

Usage

1import { OpenERPClient } from '@danielfrey63/openerp-ts-client';
2
3const client = new OpenERPClient({
4    baseURL: 'http://your-openerp-server',
5    db: 'your-database',
6    username: 'admin',
7    password: 'admin'
8});
9
10// Example: Search for partners
11const partners = await client.search('res.partner', [['is_company', '=', true]]);

API Reference

Methods

Method	Description	Parameters	Return Type
constructor	Creates a new OpenERP client instance	config: OpenERPConfig - Configuration object with baseUrl property	OpenERPClient
listDatabases	Lists all available databases on the OpenERP server	None	Promise<string[]>
login	Authenticates with the OpenERP server	credentials: LoginCredentials - Object containing db, username, and password	Promise<Session>
getOpenSaleOrders	Retrieves all open sales orders (draft, sent, or in progress)	None	Promise<SaleOrder[]>
getSaleOrderLines	Retrieves all order lines for a specific sales order	orderId: number - ID of the sales order	Promise<OrderLine[]>
updateOrderLineProduct	Updates a product in a sales order line	orderId: number - ID of the sales order<br>orderLineId: number - ID of the order line to update newProductCode: string - Code of the new product	Promise<void>
getProductDetailsByCode	Retrieves detailed information about a product by its code	productCode: string - Code of the product to retrieve	Promise<ProductDetails | null>

Data Types

OpenERPConfig

1interface OpenERPConfig {
2  baseUrl: string;
3}

LoginCredentials

1interface LoginCredentials {
2  db: string;
3  username: string;
4  password: string;
5}

Session

1interface Session {
2  id: string;
3  db: string;
4  uid: number;
5  username: string;
6}

SaleOrder

1interface SaleOrder {
2  id: number;
3  name: string;
4  partner_id: [number, string];
5  state: string;
6}

OrderLine

1interface OrderLine {
2  id: number;
3  product_id: [number, string];
4  product_uom_qty: number;
5  price_unit: number;
6}

ProductDetails

1interface ProductDetails {
2  id: number;
3  code: string;
4  name: string;
5  name_template: string;
6  price: number;
7}

Implementation Details

This library implements several advanced architectural patterns to ensure high performance, maintainability, and type safety:

• XML-RPC Client Architecture: The client uses a unified XML-RPC approach with dynamic endpoint handling. Instead of maintaining three separate clients (db, common, object), a single reusable client intelligently routes requests to the appropriate service endpoint.

• Response Parsing System: A sophisticated response parser converts XML-RPC responses into strongly-typed TypeScript objects. This system reduces parsing code duplication by 90% while providing comprehensive type safety through generics.

• Data Mapping Strategy: The library employs a factory pattern for object mapping in data queries. This approach enables automatic detection of arrays and structs in the response data, ensuring consistent error logging and type conversion.

• Robust Error Handling: A comprehensive error handling system provides detailed error information with custom exception classes. The implementation maintains complete error chains back to the original stack trace and supports localized error messages.

• Service-Oriented Architecture: The codebase is organized into modular functional services (authentication, orders, products, etc.) using interface-based dependency injection. This structure ensures complete independence between services while maintaining a cohesive API.

Development

1. Clone the repository
2. Install dependencies: npm install
3. Build the package: npm run build

License

MIT