convert3x

A simple utility package to convert tab-delimited text files to JSON, JSON to tab-delimited files, and plain text files to Base64-encoded strings.

Installation

You can install this package using npm:

npm install convert3x

Usage

You can use this package to easily convert files from one format to another.

1. Convert Tab-Delimited File to JSON

To convert a tab-delimited text file to a JSON file:

import { convertTabToJson } from 'convert3x';

async function convertFile() {
  try {
    const result = await convertTabToJson('path/to/input.txt', 'output.json');
    console.log(result);  // Example: ✅ JSON saved to: output.json
  } catch (err) {
    console.error(err.message);  // Example: ❌ Failed to convert tab to JSON: [error message]
  }
}

convertFile();

Arguments:

• inputFile (string): Path to the input tab-delimited file.
• outputFile (string, optional): Name of the output JSON file. Defaults to output.json.

2. Convert JSON to Tab-Delimited File

To convert a JSON file to a tab-delimited text file:

import { convertJsonToTab } from 'convert3x';

async function convertFile() {
  try {
    const result = await convertJsonToTab('path/to/input.json', 'output.txt');
    console.log(result);  // Example: ✅ Tab-delimited file saved to: output.txt
  } catch (err) {
    console.error(err.message);  // Example: ❌ Failed to convert JSON to tab: [error message]
  }
}

convertFile();

Arguments:

• inputFile (string): Path to the input JSON file.
• outputFile (string, optional): Name of the output tab-delimited file. Defaults to output.txt.

3. Convert Text File to Base64-Encoded String

To convert a plain text file to a Base64-encoded string:

import { convertTxtToBase64 } from 'convert3x';

async function convertFile() {
  try {
    const result = await convertTxtToBase64('path/to/input.txt');
    console.log(result);  // Example: Base64 string output or success message
  } catch (err) {
    console.error(err.message);  // Example: ❌ Failed to convert text to Base64: [error message]
  }
}

convertFile();

Arguments:

• inputFile (string): Path to the input text file.
• outputFile (string, optional): Name of the output file where the Base64 string will be saved. If not provided, the Base64 string will be returned.

Error Handling

If any operation fails (e.g., due to file reading issues or incorrect format), the methods will throw an error with a descriptive message:

try {
  const result = await convertTabToJson('invalidFile.txt');
} catch (err) {
  console.error(err.message);  // ❌ Failed to convert tab to JSON: [error details]
}

License

MIT License. See the LICENSE file for details.