NPM

​

Features

• Upload files to a specified URL with optional folder support.
• Download files from a specified URL.
• Merge multiple files into a single file.

​

Installation

You can install the Taficloud library using npm:

npm install taficloud-js

If you want to install it as a development dependency:

npm install taficloud-js --save-dev

​

Usage

​

Importing the Library

After installing the library, you can import it into your JavaScript/TypeScript project.

import { Taficloud } from 'taficloud-js';

​

Initializing the Taficloud Class

You need to initialize the Taficloud class with your API key. The API key will be used in the Authorization header for authenticated requests.

const taficloud = new Taficloud('your-api-key');

​

Uploading a File

To upload a file, use the uploadFile method. This method takes a file (as a File or Blob object), a fileName, and a url. Optionally, you can specify a folder.

const file = new File([new Blob(['file content'])], 'example.txt');

taficloud.uploadFile(file, 'example.txt', 'optional-folder')
    .then(response => {
        console.log('File uploaded successfully:', response);
    })
    .catch(error => {
        console.error('Failed to upload file:', error);
    });

​

Downloading a File

To download a file from a URL, use the downloadFile method. This method will initiate a file download.

taficloud.downloadFile('example.txt')
    .then(file => {
        console.log('File downloaded successfully:', file);
    })
    .catch(error => {
        console.error('Failed to download file:', error);
    });

​

Merging Files

You can merge multiple files into a single file using the mergeFiles method. It takes an array of File or Blob objects and returns a merged file.

const files = [
    new File([new Blob(['file1 content'])], 'file1.txt'),
    new File([new Blob(['file2 content'])], 'file2.txt')
];

taficloud.mergeFiles(files, 'merged-file.txt')
    .then(mergedFile => {
        console.log('Files merged successfully:', mergedFile);
    })
    .catch(error => {
        console.error('Failed to merge files:', error);
    });

​

API Reference

​

Taficloud Class

​

constructor(apiKey: string)

Initializes the Taficloud class with the provided API key.

• apiKey: The API key used for authorization in requests.

​

uploadFile(file: File | Blob, fileName: string, folder?: string): Promise<any>

Uploads a file to the specified URL.

• file: The file to be uploaded (as a File or Blob object).
• fileName: The name of the file.
• folder (optional): The folder where the file should be uploaded.

Returns: A Promise that resolves with the server’s response or rejects with an error.

​

downloadFile(url: string): Promise<File>

Downloads a file from the specified URL.

• url: The url of the file to download.

Returns: A Promise that resolves with the downloaded file.

​

mergeFiles(files: (File | Blob)[], mergedFileName: string): Promise<File>

Merges multiple files into a single file.

• files: An array of files (File or Blob objects) to be merged.
• mergedFileName: The name of the merged file.

Returns: A Promise that resolves with the merged file.