APG Converter API

1.0.1 · deprecated · verified Tue Apr 21

apg-conv-api is a JavaScript library that provided an API for converting integer arrays to encoded byte streams (Node.js Buffers) and vice versa. It also exposed low-level transformation functions for encoding and decoding, and was bundled for use in both Node.js and browser environments. The package is officially deprecated as of version 1.0.1, with its functionality superseded by `apg-js`. Developers are strongly advised to migrate to `apg-js` for ongoing support and new features. The package's release cadence was tied to its companion `apg-conv` library, but is now effectively halted due to its deprecated status. Its key differentiator was providing direct programmatic access to the `apg-conv` core conversion logic for various data types.

Common errors

```
TypeError: apgConv.converter.decode is not a function
```
cause Attempting to use `apgConv` without properly requiring or including it, or using an incorrect symbol name.

fix Ensure `const apgConv = require('apg-conv-api');` is at the top of your Node.js file, or that the script tag for `apg-conv-api.js` is included in your HTML before calling `apgConv` in a browser.
```
ERR_REQUIRE_ESM: require() of ES Module ... not supported
```
cause Trying to `require()` an ES Module or using `import` syntax with this CommonJS-only package.

fix This package is CommonJS-only. If you are in an ES Module environment, you must either use a dynamic `import()` or, preferably, migrate to the `apg-js` package which offers ES Module support.

Warnings

deprecated The `apg-conv-api` package is officially deprecated. Users should migrate to `apg-js` for all current and future development.
Fix: Replace `apg-conv-api` with `apg-js`. Refer to the `apg-js` documentation and `apg-js-examples` for updated usage patterns.
gotcha This package is designed for CommonJS (Node.js `require`) and global browser usage. It does not provide native ES Module (ESM) support.
Fix: For Node.js, continue using `require()`. For modern applications requiring ESM, migrate to `apg-js` which offers ESM compatibility.
breaking Future compatibility with newer Node.js versions or browser environments is not guaranteed due to the package's deprecated status and lack of maintenance.
Fix: Migrate to the actively maintained `apg-js` package to ensure ongoing compatibility and receive critical updates.

Install

npm install apg-conv-api npm
yarn add apg-conv-api yarn
pnpm add apg-conv-api pnpm

Imports

apgConv
wrong:
```
import apgConv from 'apg-conv-api';
```
correct:
```
const apgConv = require('apg-conv-api');
```
Primary import for Node.js CommonJS environments. This package does not support ESM imports.

apgConv.converter.decode

wrong:

import { converter } from 'apg-conv-api';

correct:

const { converter } = require('apg-conv-api');
const decoded = converter.decode("UTF8", chars);

Accessing specific utility functions from the `converter` object after requiring the main module.

apgConv (global in browser)

<!-- In HTML -->
<script src="./apg-conv-api.js"></script>
<script>
  const buf = apgConv.converter.decode("UTF8", chars);
</script>

In browser environments, including the script tag exposes `apgConv` as a global object.

Quickstart

Demonstrates how to use `apg-conv-api` to encode an array of integer code points into a Node.js Buffer and then decode it back using UTF8 encoding.

const apgConv = require('apg-conv-api');

// Example: Define some characters (e.g., Unicode code points)
const chars = [0x41, 0x42, 0x43, 0xE2, 0x82, 0xAC]; // 'ABC€' in UTF-8 code points

console.log('Original character array:', chars);

// Encode to a Buffer (UTF8)
const buffer = apgConv.converter.encode('UTF8', chars);
console.log('Encoded Buffer:', buffer);
console.log('Buffer as string:', buffer.toString('utf8'));

// Decode back to an array of integers (UTF8)
const decodedChars = apgConv.converter.decode('UTF8', buffer);
console.log('Decoded character array:', decodedChars);

view raw JSON →