1.2.58 • Published 3 days ago

files.com v1.2.58

Weekly downloads
124
License
MIT
Repository
github
Last release
3 days ago

Files.com JavaScript SDK

The Files.com JavaScript SDK provides convenient access to the Files.com API from applications written in JavaScript.

Installation

To install the package:

yarn add files.com

or

npm install files.com

Usage

Import and initialize

import Files from "files.com/lib/Files.js";

// set your subdomain or custom domain
Files.setBaseUrl("https://MY-SUBDOMAIN.files.com");

require() vs. import

The examples provided in the documentation here use the newer ES6 import syntax. To instead use the older CommonJS module syntax with require(), ensure that .default is included. For example:

const Files = require("files.com/lib/Files.js").default;
const User = require("files.com/lib/models/User.js").default;

// destructure to directly assign a named export
const { LogLevel } = require("files.com/lib/Logger.js").default;

Authentication

There are multiple ways to authenticate to the Files.com SDK for Javascript.

Global API Key

You can set an API key globally like this:

Files.setApiKey('my-api-key')

Per-Request API Key

Or, you can pass an API key per-request, in the options object at the end of every method like this:

import User from 'files.com/lib/models/User.js'
const user = new User(params, { apiKey: 'my-api-key' })

User Session

Or, you can open a user session by calling Session.create()

import Session from 'files.com/lib/models/Session.js'
const session = await Session.create({ username, password })

Then use it globally for all subsequent API calls like this:

Files.setSessionId(session.id)

Or, you can pass the session ID per-request, in the options array at the end of every method like this:

import User from 'files.com/lib/models/User.js'
const user = new User(params, { sessionId: session.id })

Setting Global Options

You can set the following global properties using static methods on the Files class:

Log Level

import { LogLevel } from 'files.com/lib/Logger.js'
Files.setLogLevel(LogLevel.INFO)

/*
Call Files.setLogLevel() with one of the following:
  LogLevel.NONE
  LogLevel.ERROR
  LogLevel.WARN
  LogLevel.INFO (default)
  LogLevel.DEBUG
*/

Debugging

Files.configureDebugging({
  // enable debug logging of API requests (default: false)
  debugRequest: false,

  // enable debug logging of API response headers (default: false)
  debugResponseHeaders: false,
})

Network

Files.configureNetwork({
  // max retries (default: 3)
  maxNetworkRetries: 3,

  // minimum delay in seconds before retrying (default: 0.5)
  minNetworkRetryDelay: 0.5,

  // max delay in seconds before retrying (default: 1.5)
  maxNetworkRetryDelay: 1.5,

  // network timeout in seconds (default: 30.0)
  networkTimeout: 30.0,

  // auto-fetch all pages when results span multiple pages (default: `true`)
  autoPaginate: true,
})

File Operations

List root folder

import Folder from 'files.com/lib/models/Folder.js'
const dirFiles = await Folder.listFor('/')

Uploading a file

import File from 'files.com/lib/models/File.js'
import { isBrowser } from 'files.com/lib/utils.js'

// uploading raw file data
await File.uploadData(destinationFileName, data)

// uploading a file on disk (not available in browser)
if (!isBrowser()) {
  await File.uploadFile(destinationFileName, sourceFilePath)
}

Downloading a file

Get a downloadable file object by path
import File from 'files.com/lib/models/File.js'

const foundFile = await File.find(remoteFilePath)
const downloadableFile = await foundFile.download()
Download a file (not available in browser)
import { isBrowser } from 'files.com/lib/utils.js'

if (!isBrowser()) {
  // download to a file on disk
  await downloadableFile.downloadToFile(localFilePath)

  // download to a writable stream
  await downloadableFile.downloadToStream(stream)

  // download in memory and return as a UTF-8 string
  const textContent = await downloadableFile.downloadToString()
}

Comparing Case insensitive files and paths

For related documentation see Case Sensitivity Documentation.

import { pathNormalizer } from 'files.com/lib/utils.js'

if (pathNormalizer.same('Fïłèńämê.Txt', 'filename.txt')) {
  // the paths are the same
}

Additional Object Documentation

Additional docs are available at https://developers.files.com

Getting Support

The Files.com team is happy to help with any SDK Integration challenges you may face.

Just email support@files.com and we'll get the process started.

files.comcloud storageapi
@babel/runtimecross-fetchreadable-streamsafe-buffer
@infinitebrahmanuniverse/nolb-files@everything-registry/sub-chunk-1666
1.2.52

5 days ago

1.2.53

5 days ago

1.2.51

5 days ago

1.2.56

3 days ago

1.2.57

3 days ago

1.2.54

5 days ago

1.2.55

4 days ago

1.2.58

3 days ago

1.2.49

6 days ago

1.2.48

6 days ago

1.2.50

6 days ago

1.2.46

8 days ago

1.2.47

7 days ago

1.2.45

10 days ago

1.2.44

10 days ago

1.2.42

12 days ago

1.2.43

12 days ago

1.2.41

13 days ago

1.2.40

17 days ago

1.2.39

17 days ago

1.2.38

18 days ago

1.2.37

18 days ago

1.2.34

19 days ago

1.2.35

19 days ago

1.2.36

19 days ago

1.2.32

20 days ago

1.2.33

20 days ago

1.2.27

23 days ago

1.2.28

23 days ago

1.2.29

22 days ago

1.2.30

21 days ago

1.2.31

21 days ago

1.2.26

27 days ago

1.2.25

1 month ago

1.2.24

1 month ago

1.2.23

1 month ago

1.2.22

1 month ago

1.2.21

1 month ago

1.2.20

2 months ago

1.2.19

2 months ago

1.2.18

2 months ago

1.2.17

2 months ago

1.2.16

3 months ago

1.2.15

3 months ago

1.2.12

3 months ago

1.2.13

3 months ago

1.2.14

3 months ago

1.2.10

3 months ago

1.2.11

3 months ago

1.2.9

3 months ago

1.2.8

3 months ago

1.2.7

3 months ago

1.2.6

3 months ago

1.2.5

4 months ago

1.2.4

4 months ago

1.2.3

4 months ago

1.2.2

4 months ago

1.2.1

4 months ago

1.2.0

4 months ago

1.1.19

4 months ago

1.1.18

4 months ago

1.1.17

4 months ago

1.1.16

5 months ago

1.1.15

5 months ago

1.1.14

5 months ago

1.1.12

5 months ago

1.1.11

5 months ago

1.1.13

5 months ago

1.1.10

5 months ago

1.1.9

5 months ago

1.1.8

5 months ago

1.1.7

5 months ago

1.1.6

5 months ago

1.1.5

5 months ago

1.1.4

5 months ago

1.1.3

5 months ago

1.1.2

5 months ago

1.1.1

5 months ago

1.0.426

6 months ago

1.0.425

6 months ago

1.0.428

6 months ago

1.0.427

6 months ago

1.0.422

6 months ago

1.0.424

6 months ago

1.0.423

6 months ago

1.0.440

6 months ago

1.0.442

6 months ago

1.0.441

6 months ago

1.0.448

6 months ago

1.0.447

6 months ago

1.0.449

6 months ago

1.0.444

6 months ago

1.0.443

6 months ago

1.0.446

6 months ago

1.0.445

6 months ago

1.0.431

6 months ago

1.0.430

6 months ago

1.0.437

6 months ago

1.0.436

6 months ago

1.0.439

6 months ago

1.0.438

6 months ago

1.0.433

6 months ago

1.0.432

6 months ago

1.0.435

6 months ago

1.0.434

6 months ago

1.0.429

6 months ago

1.0.462

5 months ago

1.0.461

5 months ago

1.0.464

5 months ago

1.0.463

5 months ago

1.0.460

5 months ago

1.0.469

5 months ago

1.0.466

5 months ago

1.0.465

5 months ago

1.0.467

5 months ago

1.0.451

6 months ago

1.0.450

6 months ago

1.0.453

6 months ago

1.0.452

6 months ago

1.0.459

5 months ago

1.0.458

6 months ago

1.0.455

6 months ago

1.0.454

6 months ago

1.0.457

6 months ago

1.0.456

6 months ago

1.0.473

5 months ago

1.0.472

5 months ago

1.0.474

5 months ago

1.0.471

5 months ago

1.0.470

5 months ago

1.1.0

5 months ago

1.0.420

7 months ago

1.0.421

7 months ago

1.0.419

7 months ago

1.0.418

7 months ago

1.0.415

8 months ago

1.0.414

8 months ago

1.0.417

7 months ago

1.0.416

7 months ago

1.0.411

8 months ago

1.0.410

8 months ago

1.0.413

8 months ago

1.0.412

8 months ago

1.0.409

8 months ago

1.0.408

8 months ago

1.0.407

9 months ago

1.0.321

9 months ago

1.0.320

9 months ago

1.0.327

9 months ago

1.0.326

9 months ago

1.0.329

9 months ago

1.0.328

9 months ago

1.0.323

9 months ago

1.0.322

9 months ago

1.0.325

9 months ago

1.0.324

9 months ago

1.0.319

9 months ago

1.0.310

9 months ago

1.0.316

9 months ago

1.0.315

9 months ago

1.0.318

9 months ago

1.0.317

9 months ago

1.0.312

9 months ago

1.0.311

9 months ago

1.0.314

9 months ago

1.0.313

9 months ago

1.0.404

9 months ago

1.0.403

9 months ago

1.0.406

9 months ago

1.0.405

9 months ago

1.0.400

9 months ago

1.0.402

9 months ago

1.0.401

9 months ago

1.0.385

9 months ago

1.0.384

9 months ago

1.0.387

9 months ago

1.0.386

9 months ago

1.0.381

9 months ago

1.0.380

9 months ago

1.0.383

9 months ago

1.0.382

9 months ago

1.0.389

9 months ago

1.0.388

9 months ago

1.0.374

9 months ago

1.0.373

9 months ago

1.0.376

9 months ago

1.0.375

9 months ago

1.0.370

9 months ago

1.0.372

9 months ago

1.0.371

9 months ago

1.0.378

9 months ago

1.0.377

9 months ago

1.0.379

9 months ago

1.0.396

9 months ago

1.0.395

9 months ago

1.0.398

9 months ago

1.0.397

9 months ago

1.0.392

9 months ago

1.0.391

9 months ago

1.0.394

9 months ago

1.0.393

9 months ago

1.0.399

9 months ago

1.0.390

9 months ago

1.0.341

9 months ago

1.0.340

9 months ago

1.0.343

9 months ago

1.0.342

9 months ago

1.0.349

9 months ago

1.0.348

9 months ago

1.0.345

9 months ago

1.0.344

9 months ago

1.0.347

9 months ago

1.0.346

9 months ago

1.0.330

9 months ago

1.0.332

9 months ago

1.0.331

9 months ago

1.0.338

9 months ago

1.0.337

9 months ago

1.0.339

9 months ago

1.0.334

9 months ago

1.0.333

9 months ago

1.0.336

9 months ago

1.0.335

9 months ago

1.0.363

9 months ago

1.0.362

9 months ago

1.0.365

9 months ago

1.0.364

9 months ago

1.0.361

9 months ago

1.0.360

9 months ago

1.0.367

9 months ago

1.0.366

9 months ago

1.0.369

9 months ago

1.0.368

9 months ago

1.0.352

9 months ago

1.0.351

9 months ago

1.0.354

9 months ago

1.0.353

9 months ago

1.0.350

9 months ago

1.0.359

9 months ago

1.0.356

9 months ago

1.0.355

9 months ago

1.0.358

9 months ago

1.0.357

9 months ago

1.0.305

10 months ago

1.0.304

10 months ago

1.0.307

10 months ago

1.0.306

10 months ago

1.0.301

10 months ago

1.0.300

10 months ago

1.0.303

10 months ago

1.0.302

10 months ago

1.0.309

9 months ago

1.0.308

9 months ago

1.0.297

10 months ago

1.0.296

10 months ago

1.0.299

10 months ago

1.0.298

10 months ago

1.0.293

10 months ago

1.0.292

10 months ago

1.0.295

10 months ago

1.0.294

10 months ago

1.0.291

10 months ago

1.0.290

10 months ago

1.0.286

11 months ago

1.0.288

10 months ago

1.0.287

10 months ago

1.0.289

10 months ago

1.0.285

11 months ago

1.0.282

11 months ago

1.0.281

11 months ago

1.0.284

11 months ago

1.0.283

11 months ago

1.0.280

11 months ago

1.0.275

12 months ago

1.0.274

12 months ago

1.0.277

12 months ago

1.0.276

12 months ago

1.0.273

12 months ago

1.0.279

11 months ago

1.0.278

12 months ago

1.0.264

1 year ago

1.0.263

1 year ago

1.0.266

1 year ago

1.0.265

1 year ago

1.0.262

1 year ago

1.0.268

1 year ago

1.0.267

1 year ago

1.0.269

1 year ago

1.0.271

1 year ago

1.0.270

1 year ago

1.0.272

1 year ago

1.0.260

1 year ago

1.0.261

1 year ago

1.0.253

1 year ago

1.0.252

1 year ago

1.0.255

1 year ago

1.0.254

1 year ago

1.0.251

1 year ago

1.0.250

1 year ago

1.0.257

1 year ago

1.0.256

1 year ago

1.0.259

1 year ago

1.0.258

1 year ago

1.0.249

1 year ago

1.0.242

1 year ago

1.0.241

1 year ago

1.0.244

1 year ago

1.0.243

1 year ago

1.0.246

1 year ago

1.0.245

1 year ago

1.0.248

1 year ago

1.0.247

1 year ago

1.0.222

2 years ago

1.0.221

2 years ago

1.0.228

1 year ago

1.0.227

2 years ago

1.0.229

1 year ago

1.0.224

2 years ago

1.0.223

2 years ago

1.0.226

2 years ago

1.0.225

2 years ago

1.0.240

1 year ago

1.0.231

1 year ago

1.0.230

1 year ago

1.0.233

1 year ago

1.0.232

1 year ago

1.0.239

1 year ago

1.0.238

1 year ago

1.0.235

1 year ago

1.0.234

1 year ago

1.0.237

1 year ago

1.0.236

1 year ago

1.0.206

2 years ago

1.0.205

2 years ago

1.0.208

2 years ago

1.0.207

2 years ago

1.0.204

2 years ago

1.0.220

2 years ago

1.0.211

2 years ago

1.0.210

2 years ago

1.0.217

2 years ago

1.0.216

2 years ago

1.0.219

2 years ago

1.0.218

2 years ago

1.0.213

2 years ago

1.0.212

2 years ago

1.0.215

2 years ago

1.0.214

2 years ago

1.0.209

2 years ago

1.0.202

2 years ago

1.0.201

2 years ago

1.0.203

2 years ago

1.0.200

2 years ago

1.0.187

2 years ago

1.0.186

2 years ago

1.0.189

2 years ago

1.0.188

2 years ago

1.0.198

2 years ago

1.0.197

2 years ago

1.0.199

2 years ago

1.0.194

2 years ago

1.0.193

2 years ago

1.0.196

2 years ago

1.0.195

2 years ago

1.0.190

2 years ago

1.0.192

2 years ago

1.0.191

2 years ago

1.0.183

2 years ago

1.0.182

2 years ago

1.0.185

2 years ago

1.0.184

2 years ago

1.0.181

2 years ago

1.0.180

2 years ago

1.0.178

2 years ago

1.0.179

2 years ago

1.0.165

2 years ago

1.0.164

2 years ago

1.0.167

2 years ago

1.0.166

2 years ago

1.0.163

2 years ago

1.0.169

2 years ago

1.0.168

2 years ago

1.0.176

2 years ago

1.0.175

2 years ago

1.0.177

2 years ago

1.0.172

2 years ago

1.0.171

2 years ago

1.0.174

2 years ago

1.0.173

2 years ago

1.0.170

2 years ago

1.0.149

2 years ago

1.0.161

2 years ago

1.0.160

2 years ago

1.0.162

2 years ago

1.0.154

2 years ago

1.0.153

2 years ago

1.0.156

2 years ago

1.0.155

2 years ago

1.0.150

2 years ago

1.0.152

2 years ago

1.0.151

2 years ago

1.0.158

2 years ago

1.0.157

2 years ago

1.0.159

2 years ago

1.0.145

2 years ago

1.0.144

2 years ago

1.0.147

2 years ago

1.0.146

2 years ago

1.0.148

2 years ago

1.0.143

3 years ago

1.0.142

3 years ago

1.0.141

3 years ago

1.0.140

3 years ago

1.0.139

3 years ago

1.0.138

3 years ago

1.0.136

3 years ago

1.0.137

3 years ago

1.0.135

3 years ago

1.0.134

3 years ago

1.0.132

3 years ago

1.0.133

3 years ago

1.0.131

3 years ago

1.0.130

3 years ago

1.0.129

3 years ago

1.0.128

3 years ago

1.0.127

3 years ago

1.0.126

3 years ago

1.0.125

3 years ago

1.0.123

3 years ago

1.0.124

3 years ago

1.0.121

3 years ago

1.0.122

3 years ago

1.0.120

3 years ago

1.0.119

3 years ago

1.0.118

3 years ago

1.0.117

3 years ago

1.0.116

3 years ago

1.0.114

3 years ago

1.0.115

3 years ago

1.0.113

3 years ago

1.0.112

3 years ago

1.0.109

3 years ago

1.0.110

3 years ago

1.0.111

3 years ago

1.0.107

3 years ago

1.0.108

3 years ago

1.0.106

3 years ago

1.0.105

3 years ago

1.0.104

3 years ago

1.0.101

3 years ago

1.0.103

3 years ago

1.0.102

3 years ago

1.0.100

3 years ago

1.0.91

3 years ago

1.0.95

3 years ago

1.0.94

3 years ago

1.0.93

3 years ago

1.0.92

3 years ago

1.0.99

3 years ago

1.0.98

3 years ago

1.0.97

3 years ago

1.0.96

3 years ago

1.0.90

3 years ago

1.0.89

3 years ago

1.0.88

3 years ago

1.0.87

3 years ago

1.0.86

3 years ago

1.0.85

3 years ago

1.0.84

3 years ago

1.0.83

3 years ago

1.0.82

3 years ago

1.0.81

3 years ago

1.0.79

3 years ago

1.0.80

3 years ago

1.0.78

3 years ago

1.0.77

3 years ago

1.0.76

3 years ago

1.0.75

3 years ago

1.0.73

3 years ago

1.0.74

3 years ago

1.0.72

3 years ago

1.0.71

3 years ago

1.0.70

3 years ago

1.0.69

3 years ago

1.0.68

3 years ago

1.0.67

3 years ago

1.0.66

3 years ago

1.0.65

3 years ago

1.0.64

3 years ago

1.0.63

3 years ago

1.0.62

3 years ago

1.0.61

3 years ago

1.0.60

3 years ago

1.0.59

3 years ago

1.0.58

3 years ago

1.0.57

3 years ago

1.0.56

4 years ago

1.0.55

4 years ago

1.0.54

4 years ago

1.0.53

4 years ago

1.0.52

4 years ago

1.0.51

4 years ago

1.0.50

4 years ago

1.0.49

4 years ago

1.0.48

4 years ago

1.0.47

4 years ago

1.0.46

4 years ago

1.0.44

4 years ago

1.0.45

4 years ago

1.0.43

4 years ago

1.0.42

4 years ago

1.0.41

4 years ago

1.0.40

4 years ago

1.0.39

4 years ago

1.0.38

4 years ago

1.0.37

4 years ago

1.0.36

4 years ago

1.0.35

4 years ago

1.0.33

4 years ago

1.0.32

4 years ago

1.0.34

4 years ago

1.0.31

4 years ago

1.0.29

4 years ago

1.0.28

4 years ago

1.0.27

4 years ago

1.0.26

4 years ago

1.0.25

4 years ago

1.0.24

4 years ago

1.0.23

4 years ago

1.0.19

4 years ago

1.0.22

4 years ago

1.0.21

4 years ago

1.0.20

4 years ago

1.0.18

4 years ago

1.0.17

4 years ago

1.0.16

4 years ago

1.0.15

4 years ago

1.0.14

4 years ago

1.0.13

4 years ago

1.0.12

4 years ago

1.0.11

4 years ago

1.0.10

4 years ago

1.0.9

4 years ago

1.0.0

4 years ago