@manycore/aholo-sdk-asset

@manycore/aholo-sdk-asset

Official TypeScript/Node.js SDK for Aholo — file upload client (single & multipart, resume support).

Requirements: Node.js ≥ 18

Installation

npm install @manycore/aholo-sdk-asset

Quick Start

import { createAssetClient } from '@manycore/aholo-sdk-asset';

const asset = createAssetClient({ region: 'com' }); // or 'cn'

Set AHOLO_API_KEY env var, or pass apiKey in the config.

Upload a file

const result = await asset.uploadFile('./video.mp4');
console.log(result.url); // public URL

Upload a Buffer

import { readFileSync } from 'node:fs';

const data = readFileSync('./image.jpg');
const result = await asset.uploadBuffer(data, { filename: 'image.jpg' });

Upload with progress

const result = await asset.uploadFile('./video.mp4', {
  onProgress: (uploaded, total) => {
    const pct = Math.round((uploaded / total) * 100);
    process.stdout.write(`\rUploading: ${pct}%`);
  },
});

UploadOptions

Option	Type	Description
filename	string	Override filename
onProgress	(uploaded: number, total: number) => void	Progress callback (bytes)
partTimeoutMs	number	Per-block timeout in ms (default: 120 000)
signal	AbortSignal	Cancellation signal

UploadResult

Field	Type	Description
url	string	Public URL of the uploaded file
md5	string	MD5 of the uploaded file

Full Documentation

See the TypeScript SDK README for complete API reference and examples.

License

MIT