# JS SDK

### Titan Storage Web SDK

The Titan Storage Web SDK provides functionalities for file uploading, downloading, deleting, renaming, sharing, and creating folders.

The Web SDK consists of TitanStorage.

### How to Integrate with Different Frameworks

We might have a new name, but we’re still delivering the same rock-solid decentralized hot storage you know and love. TitanStorage is all about spicing up your storage game, with the same reliability and innovation that got us here.

TypeScript Environment In a TypeScript environment, you need to import both TitanStorage.js and TitanStorage.d.ts from the dist/esm directory. You can do this by including:

```
import TitanStorage from './dist/esm/TitanStorage.js';	
```

JavaScript Environment In a JavaScript environment, you should import TitanStorage.js from the dist/umd directory like this:

```
import TitanStorage from './dist/umd/TitanStorage.js';

const result = TitanStorage.initialize({
            token: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE3Mjg1NDk3MDUsImlkIjoidGl0YW4xamg0bnRmd3lsOXhxazllaGcycTdzNDR3OTlhZjkzOWpjZ3JkMmQiLCJvcmlnX2lhdCI6MTcyODQ2MzMwNSwicm9sZSI6MH0.qBw3BBHSC3piHmiwGawOMD14xkBZ9SnueeqAUfL5uX4',
            url: null,
            debug: false
        });
```

### **TitanStorage Object**

| Method                             | Description                                           |
| ---------------------------------- | ----------------------------------------------------- |
| TitanStorage.initialize            | Initialize the SDK                                    |
| TitanStorage.listRegions           | Retrieve the list of area IDs from the scheduler      |
| TitanStorage.createFolder          | Create directories, including root and subdirectories |
| TitanStorage.listDirectoryContents | Retrieve a list of all folders and files              |
| TitanStorage.renameFolder          | Rename a specific folder                              |
| TitanStorage.renameAsset           | Rename a specific file                                |
| TitanStorage.deleteFolder          | Delete a specific folder                              |
| TitanStorage.deleteAsset           | Delete a specific file                                |
| TitanStorage.getUserProfile        | Retrieve user-related information                     |
| TitanStorage.getltemDetails        | Get detailed information about files/folders          |
| TitanStorage.createSharedLink      | Share file/folder data                                |
| TitanStorage.uploadAsset           | Upload files/folders                                  |
| TitanStorage.downloadAsset         | Download files/folders                                |

### Error Codes

Below are the potential errors that the SDK may throw. Please refer to the table for handling suggestions.

| Error Code | Description                     | Possible Causes and Suggestions                                                 |
| ---------- | ------------------------------- | ------------------------------------------------------------------------------- |
| 1001       | SDK Initialization Exception    | Generally caused by an incorrect app key; check console logs for details.       |
| 1002       | SDK Initialization Failed       | Generally indicates an exception during SDK initialization; check console logs. |
| 1005       | File or Folder Name Error       | Generally due to incorrect parameters; check console logs.                      |
| 1006       | ID Parameter Error              | Generally due to incorrect parameters; check console logs.                      |
| 1007       | Share Failed                    | Generally due to unsupported sharing; check console logs.                       |
| 1008       | Data Format Error               | Generally indicates a data format error; check console logs.                    |
| 1009       | Incorrect Share Password        | Generally indicates a data format error; check console logs.                    |
| 10010      | Server Request Exception        | Generally due to request errors; contact technical support.                     |
| 10011      | Request Parameter Error         | Check console logs for details.                                                 |
| 10012      | Invalid Parameter               | Generally due to request errors; check console logs.                            |
| 10013      | Invalid Parameter               | Generally due to request errors; check console logs.                            |
| 10014      | Missing Request Parameter Field | Check console logs for details.                                                 |
| 10015      | Upload Failed                   | Check console logs for details.                                                 |
| 10016      | Incorrect Area ID               | Generally due to incorrect parameter type; check console logs.                  |
| 10017      | Incorrect Node D                | Generally indicates the parameter was not found; check console logs.            |
| 10018      | File Type Not Found             | Check console logs for details.                                                 |
| 10019      | Download Address Error          | Server returned an incorrect or unusable address; check console logs.           |
| 10020      | Download Exception              | Check console logs for details.                                                 |
| 10021      | Incorrect File ID Verification  | Check console logs for details.                                                 |
| 10022      | Download Type Not Found         | Check console logs for details.                                                 |
| 10023      | Download Type Not Found         | Check console logs for details.                                                 |
| 10024      | Report Exception                | Check console logs for details.                                                 |
| 10025      | ASSET Type Not Found            | Check console logs for details.                                                 |
| 10026      | Share Exception                 | Check console logs for details.                                                 |


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.titanapp.info/tws/titan-storage/developer-guides/sdk-documentation/js-sdk.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.