ya-disk2

---

Original Repo: https://github.com/RomiC/ya-disk Original Package: https://www.npmjs.com/package/ya-disk

Yandex Disk API library which provides some methods for working with Yandex.Disk service API. Each method present with each own independent function. Example:

import { info } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
info(API_TOKEN, ({total_space, used_space}) =>
  console.log(`
    Total space: ${Math.round(total_space / 1000000000)}GB
    Free space: ${Math.round((total_space - used_space) / 1000000000)}MB
  `);
);

Yes, it's callback-based lib. Because it was made to have at least dependencies as possible. If you want you can write you own wrapper based on, i.e. Bluebird library. Example:

import Promise from 'bluebird';
import { info } from 'ya-disk2';
 
const infoPromise = (token) => new Promise((resolve, reject) => info(token, resolve, reject));
 
export default infoPromise;

Installation

npm install --save ya-disk2

Authorization

Each method requires an OAuth token. You can receive one manually or use one of OAuth library, i.e. passport-yandex-token.

List of available methods

download

Downloading a file from the user drive.

link(token, path, [success], [error])

Getting the download link. See details. Example:

import { createWriteStream } from 'fs';
// Thi is lib is neccessary, beacause of Yandex Disk
// returns a 302 header when you try to download file
// using provided link
import { https } from 'follow-redirects';
import { parse } from 'url';
import { download } from '../lib/download';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
const file = 'disk:/Зима.jpg';
 
download.link(API_TOKEN, file, ({ method, href }) => {
  const output = createWriteStream('Зима.jpg');
  const req = https.get(href, (res) => {
    res.on('end', () => output.end());
    res.pipe(output);
  });
 
  req.on('error', console.error);
  req.end();
}, console.error);

info(token, [succes], [error])

Getting common info about user drive. See details. Example:

import { info } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
info(API_TOKEN, ({ total_space, used_space }) =>
  console.log(`
    Total space: ${Math.round(total_space / 1000000000)}GB
    Free space: ${Math.round((total_space - used_space) / 1000000)}MB
  `);
);
 

list(token, [options={}], [success], [error])

Getting a flat list of the user files on the drive. See details.

import { list } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
list(API_TOKEN, {}, ({ items }) => items.forEach(({ name, size}) => console.log('%s: %dB', name, size)));

meta

get(token, path, [options={}], [success], [error])

Getting meta-information about the resource (file or directory). See details. Example:

import { meta } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
meta.get(API_TOKEN, 'disk:/path/to/the/file.txt', {}, console.log);

add(token, path, properties, [success], [error])

Append meta information to the resource (file or directory). See details. Example:

import { meta } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
meta.add(API_TOKEN, 'disk:/path/to/the/file.txt', { my_field: 'my_value' });

operations

Getting operation status. See details. Example:

import operations from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
const operationId = 'MqeRNE6wJFJuKAo7nGAYatqjbUcYo3Hj';
 
opeartions(API_TOKEN, operationId, ({status}) => console.log(`Operation ${opeartionId} ${status}`));

recent(token, [options={}], [success], [error])

Getting a flat list of recently changed files. See details.

import { recent } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
recent(API_TOKEN, {media_type: 'image'}, ({ items }) =>
  items.forEach((f) =>
    console.log(`${f.name} (${f.size}B)`)));

upload

Tool for uploading a file to the user drive.

link(token, path, [overwrite = false], [success], [error])

Getting link for uploaded file. See details. Example:

import { createReadStream } from 'fs';
import { request } from 'https';
import { parse } from 'url';
 
import { upload } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
upload.link(API_TOKEN, 'disk:/path/to/the/file.txt', true, ({ href, method }) => {
  const fileStream = createReadStream('file.txt');
 
  const uploadStream = request(Object.assign(parse(href), { method }));
 
  fileStream.pipe(uploadStream);
 
  fileStream.on('end', () => uploadStream.end());
});

remoteFile(token, url, path, [success], [error])

Upload remote file to the disk by its url. See details. Example:

import upload from '../lib/upload';
 
const { API_TOKEN = '' } = process.env;
const url = 'https://tech.yandex.com/disk/doc/dg/yandex-disk-dg.pdf';
const path = 'disk:/Приложения/ya-disk2-api/yandex-disk-dg.pdf';
 
upload.remoteFile(API_TOKEN, url, path, ({ href }) => {
  process.stdout.write(`File upload started!
You can check the operation status by url below:
${href}
  \n`);
}, (err) => process.stderror.write(err.message));

File and Folder Actions

create(token, path, [success], [error])

Create folder. See details.

import { resources } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
resources.create(API_TOKEN, 'disk:/folderName', () => {
  // success
},() => {
  //error
});

remove(token, path, permanently, [success], [error])

Delete file or folder. See details.

import { resources } from 'ya-disk2';
 
const API_TOKEN = '1982jhk12h31iad7a(*&kjas';
 
resources.remove(API_TOKEN, 'disk:/fileOrFolderName', false, () => {
  // success
},() => {
  //error
});