Skip to content

libpolycall Node.js Bindings

Latest

Choose a tag to compare

@obinexusmk2 obinexusmk2 released this 11 Mar 00:34
· 3 commits to main since this release
5d6ca15

libpolycall Node.js Bindings

Overview

libpolycall provides a data-oriented programming interface. This package publishes Node.js bindings and a small CLI for inspecting the installed API surface.

Installation

Install the published package with:

npm install @obinexusmk2/node-polycall

Library usage

CommonJS (require)

const { PolyCallClient } = require('@obinexusmk2/node-polycall');

const client = new PolyCallClient({ host: 'localhost', port: 8080 });
console.log(client.toString());

ESM (import)

import polycall from '@obinexusmk2/node-polycall';

const { PolyCallClient } = polycall;
const client = new PolyCallClient({ host: 'localhost', port: 8080 });
console.log(client.toString());

CLI usage

The package exposes a CLI command via the bin mapping:

  • Command: polycall

Show help:

polycall --help

Practical example (list exported symbols from the installed package):

polycall exports

Publishing checklist

  1. Verify the package contents before publishing:
    npm pack
  2. Publish the scoped package publicly:
    npm publish --access public
  3. Confirm the CLI command resolves and runs after install (global or local via npx):
    polycall --help
    # or
    npx @obinexusmk2/node-polycall --help

Development

Install dependencies:

npm install

Run the available test script:

npm test

License

This project is licensed under the MIT License. See LICENSE for details.

libpolycall Node.js Bindings

Overview

libpolycall is a comprehensive library designed to facilitate data-oriented programming interfaces. This repository provides Node.js bindings for libpolycall, enabling seamless integration with Node.js applications.

Features

  • Protocol Handling: Manage communication protocols with ease.
  • State Management: Implement state machines with robust state transitions.
  • Network Communication: Handle network endpoints and client connections.
  • Checksum Calculation: Ensure data integrity with checksum utilities.

Installation

To install the libpolycall Node.js bindings, run:

npm install @obinexus/node-polycall

Usage

CLI

A minimal, stable CLI surface is available through node-polycall:

node-polycall info
node-polycall --help
node-polycall --version
  • info (default command): prints a compact summary of exported APIs and protocol constant counts.
  • --help: prints usage.
  • --version: prints package version.

For full functionality, use the JavaScript API documented below.

Basic Example

const { PolyCallClient, MESSAGE_TYPES, PROTOCOL_FLAGS } = require('node-polycall');

async function main() {
    const client = new PolyCallClient({
        host: 'localhost',
        port: 8080
    });

    client.on('connected', () => {
        console.log('Connected to server');
    });

    client.on('authenticated', () => {
        console.log('Authenticated with server');
    });

    client.on('state:changed', ({ from, to }) => {
        console.log(`State changed from ${from} to ${to}`);
    });

    try {
        await client.connect();
        await client.authenticate({ username: 'test', password: 'test' });

        const states = await client.getAllStates();
        console.log('Current states:', states);

        await client.transitionTo('ready');

        const result = await client.executeCommand('status');
        console.log('Command result:', result);
    } catch (error) {
        console.error('Error:', error);
    }
}

main();

API Reference

PolyCallClient

  • connect(): Connect to the PolyCall server.
  • disconnect(): Disconnect from the PolyCall server.
  • sendRequest(path, method, data): Send a request to the server.
  • executeCommand(command, data): Execute a command on the server.
  • transitionTo(stateName): Transition to a specified state.
  • authenticate(credentials): Authenticate with the server.
  • isConnected(): Check if connected to the server.
  • isAuthenticated(): Check if authenticated with the server.
  • getCurrentState(): Get the current state.
  • getStateHistory(): Get the state history.
  • getState(stateName): Get a specific state.
  • getAllStates(): Get all states.
  • lockState(stateName): Lock a specific state.
  • unlockState(stateName): Unlock a specific state.

Development

Building from Source

To build the Node.js bindings from source, follow these steps:

  1. Clone the repository:

    git clone https://gitlab.com/obinexus/libpolycall.git
    cd libpolycall/bindings/node-polycall
  2. Install dependencies:

    npm install
  3. Build the project:

    npm run build

Running Tests

To run the tests, use:

npm test

Contributing

Contributions are welcome! Please read the CONTRIBUTING.md for guidelines on how to contribute to this project.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgements

Special thanks to the contributors and the open-source community for their support and contributions.