NetStorage 

A TypeScript API and CLI for the Akamai NetStorage REST interface.

Features

- Upload and download individual files or entire directories
- Bi-directional sync between local and remote
- Recursive remote directory tree traversal
- Fully typed API responses and inputs
- Built-in retries, rate limiting, and dry-run mode
- Tools for size aggregation and file validation
- Rich CLI with full feature parity
- Interactive REPL with tab-completion and remote navigation

Installation

``bash
npm i netstorage -g
`

Alternatively, you can run any command with npx netstorage without a global install.

Getting Started

$3

Before using any commands or launching the REPL, you must configure your NetStorage credentials:

`bash
npx netstorage config set --key-name my-key --key abc123 --host example-nsu.akamaihd.net --cp-code 123
`

$3

Then try any of the following:

`bash


Sync a local directory

npx netstorage sync ./media

Upload a directory to a remote path

npx netstorage upload ./media uploaded-media

Recursively remove a remote directory

npx netstorage rm -r old-uploads

Visualize remote directory with sizes and timestamps

npx netstorage tree -s -M release-history
`

$3

`bash
npx netstorage
`

Use the REPL to:

- Navigate remote directories (cd, ls, ll, pwd)
- Run any CLI command interactively (upload, download, stat, etc.)
- Autocomplete local and remote paths
- Maintain remote working directory context

Example commands:

`bash
nst:/media> ls
nst:/media> stat file.jpg
nst:/media> put ./photo.jpg
nst:/media> get remote-folder -v
`

$3

`ts
import { createConfig, uploadDirectory } from 'netstorage';

const config = createConfig({
key: process.env.NETSTORAGE_API_KEY!,
keyName: process.env.NETSTORAGE_API_KEYNAME!,
host: process.env.NETSTORAGE_HOST!,
cpCode: process.env.NETSTORAGE_CP_CODE!,
});

await uploadDirectory(config, {
localPath: './media',
remotePath: '/batch-media',
});
``

Documentation

- CLI Reference
- API Reference

Disclaimer

This project is an unofficial implementation of the Akamai NetStorage REST API. It is not affiliated with or endorsed by Akamai. Use at your own risk. The software is provided as-is under an unlicensed status, with no warranties or guarantees.